feat(lint): add ./lint export and use it for oxlint config generation (#710)

docs(cli): rewrite package.json exports management section in BUNDLING.md

Replaces the inaccurate three-layer pipeline description with a correct
two-category breakdown (manual vs automated). The previous version
incorrectly claimed sync-remote-deps.ts managed CLI package.json exports
and referenced ./rolldown/* entries that don't exist in this package.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

feat(lint): add `./lint` export and use it for oxlint config generation

- Add `./lint` subpath export to CLI package.json
- Create `src/lint.ts` to re-export `defineConfig` from the lint module
- Update Rust config generator to import from `vite-plus/lint` instead
  of `oxlint`

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Medium Risk**
> Changes package export surface and the CLI’s generated lint config import path, which could break lint config resolution if the new subpath export or build output is misconfigured. Snap-test harness changes also alter module resolution behavior in tests.
> 
> **Overview**
> Adds a new public subpath export `vite-plus/lint` that re-exports `oxlint`’s `defineConfig` (and related types), and updates the Rust CLI config generator to emit temp lint configs that import from `vite-plus/lint` instead of `oxlint`.
> 
> Updates snap-test infrastructure to create a real `node_modules` in the temp workspace and symlink the `vite-plus` package itself so `vite-plus/*` imports resolve during tests, and refreshes global CLI snapshots accordingly.
> 
> Rewrites `packages/cli/BUNDLING.md` to clarify `package.json` exports as *manual vs automated* (with `./test/*` handled by the sync step) and documents the new `./lint` export.
> 
> <sup>Written by [Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit f9329cf. This will update automatically on new commits. Configure [here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

Author: Brooooooklyn

packages/cli/BUNDLING.md

@@ -504,14 +504,44 @@ const CORE_PACKAGE_NAME = '@voidzero-dev/vite-plus-core';
 const TEST_PACKAGE_NAME = '@voidzero-dev/vite-plus-test';
 ```
 
-### Package.json Auto-Update
+### Package.json Exports Management
 
-The build script automatically updates `package.json`:
+The `exports` field in `package.json` has two categories: **manual** and **automated**.
 
-1. Removes old `./test/*` exports
-2. Adds new exports from test package
-3. Ensures `dist/test` is in the `files` array
+#### Manual exports
 
-Core package exports (`./client`, `./module-runner`, `./internal`, `./dist/client/*`, `./types/*`) are defined statically in `package.json` and not auto-generated, since they match upstream Vite's exports structure.
+All non-`./test*` exports are manually maintained in `package.json`. These fall into two groups:
 
-This keeps the CLI package exports in sync with both upstream Vite and the test package without manual maintenance.
+**CLI-native exports** — point to CLI's own compiled TypeScript (built by `buildCli()` via tsc):
+
+| Export           | Description                |
+| ---------------- | -------------------------- |
+| `.`              | Main entry (CLI utilities) |
+| `./bin`          | CLI binary entry point     |
+| `./binding`      | NAPI native binding        |
+| `./lint`         | Lint utilities             |
+| `./pack`         | Pack utilities             |
+| `./package.json` | Package metadata           |
+
+**Core shim exports** — point to shim files auto-generated by `syncCorePackageExports()` that re-export from `@voidzero-dev/vite-plus-core`. The shim files are regenerated on each build, but the `package.json` entries themselves are manual:
+
+| Export               | Description                                                             |
+| -------------------- | ----------------------------------------------------------------------- |
+| `./client`           | Triple-slash reference for ambient type declarations (CSS modules, etc) |
+| `./module-runner`    | Vite module runner for SSR/environments                                 |
+| `./internal`         | Internal Vite APIs                                                      |
+| `./dist/client/*`    | Client runtime files                                                    |
+| `./types/internal/*` | Blocked (`null`) to prevent access to internal types                    |
+| `./types/*`          | Type-only re-exports                                                    |
+
+**Note**: The core package's own exports (which the shims point to) are generated upstream by `packages/tools/src/sync-remote-deps.ts`. See [Core Package Bundling](../core/BUNDLING.md) for details.
+
+#### Automated exports (`./test/*`)
+
+All `./test*` exports are fully managed by `syncTestPackageExports()`. The build script:
+
+1. Reads `packages/test/package.json` exports
+2. Creates shim files in `dist/test/`
+3. Removes old `./test*` exports from `package.json`
+4. Merges in newly generated test exports
+5. Ensures `dist/test` is in the `files` array

packages/cli/binding/src/cli.rs

@@ -263,7 +263,7 @@ impl SubcommandResolver {
 
         let config_path = config_dir.join(temp_filename);
         let content = format!(
-            "import {{ defineConfig }} from 'oxlint';\nimport viteConfig from './{config_basename}';\nexport default defineConfig(viteConfig.{field_name} as any);\n"
+            "import {{ defineConfig }} from 'vite-plus/lint';\nimport viteConfig from './{config_basename}';\nexport default defineConfig(viteConfig.{field_name} as any);\n"
         );
         write(&config_path, content).await?;
 

packages/cli/package.json

@@ -55,6 +55,10 @@
       "import": "./binding/index.cjs",
       "require": "./binding/index.cjs"
     },
+    "./lint": {
+      "types": "./dist/lint.d.ts",
+      "import": "./dist/lint.js"
+    },
     "./package.json": "./package.json",
     "./pack": {
       "types": "./dist/pack.d.ts",

packages/cli/snap-tests-global/cli-helper-message/snap.txt

@@ -55,16 +55,16 @@ VITE+ - The Unified Toolchain for the Web
 vp v<semver>
 
 Local vite-plus:
-  vite-plus  Not found
+  vite-plus  v<semver>
 
 Tools:
-  vite             Not found
-  rolldown         Not found
-  vitest           Not found
-  oxfmt            Not found
-  oxlint           Not found
-  oxlint-tsgolint  Not found
-  tsdown           Not found
+  vite             v<semver>
+  rolldown         v<semver>
+  vitest           v<semver>
+  oxfmt            v<semver>
+  oxlint           v<semver>
+  oxlint-tsgolint  v<semver>
+  tsdown           v<semver>
 
 > vp install -h # show install help message
 VITE+ - The Unified Toolchain for the Web

packages/cli/snap-tests-global/command-version-no-side-effects/snap.txt

@@ -4,16 +4,16 @@ VITE+ - The Unified Toolchain for the Web
 vp v<semver>
 
 Local vite-plus:
-  vite-plus  Not found
+  vite-plus  v<semver>
 
 Tools:
-  vite             Not found
-  rolldown         Not found
-  vitest           Not found
-  oxfmt            Not found
-  oxlint           Not found
-  oxlint-tsgolint  Not found
-  tsdown           Not found
+  vite             v<semver>
+  rolldown         v<semver>
+  vitest           v<semver>
+  oxfmt            v<semver>
+  oxlint           v<semver>
+  oxlint-tsgolint  v<semver>
+  tsdown           v<semver>
 
 > test -f .node-version && echo 'FAIL: .node-version was created' || echo 'OK: no .node-version created'
 OK: no .node-version created

packages/cli/src/lint.ts

@@ -0,0 +1,13 @@
+export {
+  type AllowWarnDeny,
+  type DummyRule,
+  type DummyRuleMap,
+  type ExternalPluginEntry,
+  type ExternalPluginsConfig,
+  type OxlintConfig,
+  type OxlintEnv,
+  type OxlintGlobals,
+  type OxlintOverride,
+  type RuleCategories,
+  defineConfig,
+} from 'oxlint';

packages/tools/src/snap-test.ts

@@ -113,10 +113,24 @@ export async function snapTest() {
     }
   }
 
-  // Make dependencies available in the test cases
+  // Make dependencies available in the test cases.
+  // Create a real node_modules directory so we can add the CLI package itself
+  // alongside the symlinked dependencies (needed for `vite-plus/*` imports in
+  // generated config files like .vite-plus-lint.tmp.mts).
+  const tempNodeModules = path.join(tempTmpDir, 'node_modules');
+  fs.mkdirSync(tempNodeModules);
+  const cliNodeModules = path.resolve('node_modules');
+  for (const entry of fs.readdirSync(cliNodeModules)) {
+    fs.symlinkSync(
+      path.join(cliNodeModules, entry),
+      path.join(tempNodeModules, entry),
+      process.platform === 'win32' ? 'junction' : 'dir',
+    );
+  }
+  // Add the CLI package itself so `vite-plus/*` subpath imports resolve
   fs.symlinkSync(
-    path.resolve('node_modules'),
-    path.join(tempTmpDir, 'node_modules'),
+    path.resolve('.'),
+    path.join(tempNodeModules, 'vite-plus'),
     process.platform === 'win32' ? 'junction' : 'dir',
   );