feat(cli): expose tsdown types and entry (#358)

<!-- CURSOR_SUMMARY -->
> [!NOTE]
> Expose `lib` API and tsdown types via new exports; update build to bundle tsdown entries with generated d.ts and refine import rewriting/external handling.
> 
> - **CLI**:
>   - Add `exports.{ "./lib": { import: "./dist/lib.js", types: "./dist/lib.d.ts" } }` in `packages/cli/package.json`.
>   - Extend `UserConfig` to accept `lib` options and add `src/lib.ts` re-exporting core `lib` APIs.
> - **Core**:
>   - `RewriteImportsPlugin`: switch to `resolveId` with `{ order: 'pre', handler }`.
>   - Build system (`build.ts`):
>     - Adjust externals filtering (include `yaml` and `vite/` patterns) and place `RewriteImportsPlugin` before transforms.
>     - Bundle tsdown with multiple inputs (`run`, `index`) and generate type declarations via `rolldown-plugin-dts` for `index-types`.
>   - `package.json`: add `exports["./lib"]` pointing to `dist/tsdown/index.mjs` with `types`.
> - **Dependencies**:
>   - Add `rolldown-plugin-dts`, `hookable`, and `pkg-types`; lockfile updates accordingly.
> 
> <sup>Written by [Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit 20c2492. This will update automatically on new commits. Configure [here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

Author: Brooooooklyn

packages/cli/package.json

@@ -66,6 +66,10 @@
       "types": "./binding/index.d.ts"
     },
     "./package.json": "./package.json",
+    "./lib": {
+      "import": "./dist/lib.js",
+      "types": "./dist/lib.d.ts"
+    },
     "./test": {
       "import": {
         "types": "./dist/test/index.d.ts",

packages/cli/src/index.ts

@@ -1,3 +1,4 @@
+import type { defineConfig as defineLibConfig } from '@voidzero-dev/vite-plus-core/lib';
 import { defineConfig } from '@voidzero-dev/vite-plus-test/config';
 
 import type { OxfmtConfig } from './oxfmt-config';
@@ -11,6 +12,8 @@ declare module '@voidzero-dev/vite-plus-core' {
     lint?: OxlintConfig;
 
     fmt?: OxfmtConfig;
+
+    lib?: Parameters<typeof defineLibConfig>[0];
   }
 }
 

packages/cli/src/lib.ts

@@ -0,0 +1,2 @@
+export { defineConfig, build, buildSingle, globalLogger } from '@voidzero-dev/vite-plus-core/lib';
+export type * from '@voidzero-dev/vite-plus-core/lib';

packages/core/build-support/rewrite-imports.ts

@@ -4,18 +4,21 @@ import pkgJson from '../package.json' with { type: 'json' };
 
 export const RewriteImportsPlugin: Plugin = {
   name: 'rewrite-imports-for-vite-plus',
-  resolveId(id: string) {
-    if (id.startsWith('vite/')) {
-      return { id: id.replace(/^vite\//, `${pkgJson.name}/`), external: true };
-    }
-    if (id === 'rolldown') {
-      return { id: `${pkgJson.name}/rolldown`, external: true };
-    }
-    if (id.startsWith('rolldown/')) {
-      return {
-        id: id.replace(/^rolldown\//, `${pkgJson.name}/rolldown/`),
-        external: true,
-      };
-    }
+  resolveId: {
+    order: 'pre',
+    handler(id: string) {
+      if (id.startsWith('vite/')) {
+        return { id: id.replace(/^vite\//, `${pkgJson.name}/`), external: true };
+      }
+      if (id === 'rolldown') {
+        return { id: `${pkgJson.name}/rolldown`, external: true };
+      }
+      if (id.startsWith('rolldown/')) {
+        return {
+          id: id.replace(/^rolldown\//, `${pkgJson.name}/rolldown/`),
+          external: true,
+        };
+      }
+    },
   },
 };

packages/core/build.ts

@@ -3,6 +3,7 @@ import { join, parse, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 import { build, type BuildOptions } from 'rolldown';
+import { dts } from 'rolldown-plugin-dts';
 import { glob } from 'tinyglobby';
 
 import { RewriteImportsPlugin } from './build-support/rewrite-imports';
@@ -46,7 +47,8 @@ async function buildVite() {
               external === 'tinyglobby' ||
               external === 'fdir' ||
               external === 'rolldown')) ||
-          (external instanceof RegExp && external.test('rolldown/'))
+          external === 'yaml' ||
+          (external instanceof RegExp && (external.test('rolldown/') || external.test('vite/')))
         );
       });
     }
@@ -71,6 +73,8 @@ async function buildVite() {
 
     if (Array.isArray(config.plugins)) {
       config.plugins = [
+        // Add RewriteImportsPlugin to handle vite/rolldown import rewrites
+        RewriteImportsPlugin,
         {
           name: 'rewrite-static-paths',
           transform(_, id, meta) {
@@ -112,8 +116,6 @@ async function buildVite() {
             }
           },
         },
-        // Add RewriteImportsPlugin to handle vite/rolldown import rewrites
-        RewriteImportsPlugin,
         ...config.plugins.filter((plugin) => {
           return !(
             typeof plugin === 'object' &&
@@ -243,7 +245,10 @@ async function bundleTsdown() {
 
   // Re-build tsdown cli
   await build({
-    input: join(tsdownSourceDir, 'dist/run.mjs'),
+    input: {
+      run: join(tsdownSourceDir, 'dist/run.mjs'),
+      index: join(tsdownSourceDir, 'dist/index.mjs'),
+    },
     output: {
       format: 'esm',
       cleanDir: true,
@@ -253,6 +258,23 @@ async function bundleTsdown() {
     external: (id: string) => tsdownExternal.some((e) => id.startsWith(e)),
     plugins: [RewriteImportsPlugin],
   });
+
+  await build({
+    input: {
+      'index-types': join(tsdownSourceDir, 'dist/index.d.mts'),
+    },
+    output: {
+      format: 'esm',
+      dir: join(projectDir, 'dist/tsdown'),
+    },
+    plugins: [
+      RewriteImportsPlugin,
+      dts({
+        oxc: true,
+        dtsInput: true,
+      }),
+    ],
+  });
 }
 
 // Actually do nothing now, we will polish it in the future when `vitepress` is ready

packages/core/package.json

@@ -48,6 +48,10 @@
       "default": "./dist/pluginutils/index.js",
       "types": "./dist/pluginutils/index.d.ts"
     },
+    "./lib": {
+      "default": "./dist/tsdown/index.mjs",
+      "types": "./dist/tsdown/index-types.d.ts"
+    },
     "./types/*": {
       "types": "./dist/vite/types/*"
     },
@@ -160,9 +164,12 @@
     "@oxc-node/cli": "catalog:",
     "@oxc-node/core": "catalog:",
     "es-module-lexer": "^1.7.0",
+    "hookable": "^6.0.1",
     "magic-string": "^0.30.21",
+    "pkg-types": "^2.3.0",
     "picocolors": "^1.1.1",
     "rolldown": "workspace:*",
+    "rolldown-plugin-dts": "catalog:",
     "vite": "workspace:*",
     "rollup": "^4.18.0",
     "rollup-plugin-license": "^3.6.0",