feat(exports): support object option for customExports (#769)

Joery-M · autofix-ci[bot] · sxzz · web-flow · commit 7fb7286cb6a3 · 2026-02-12T07:28:13.000Z
Co-authored-by: autofix-ci[bot] &lt;114827586+autofix-ci[bot]@users.noreply.github.com&gt;
Co-authored-by: Kevin Deng &lt;sxzz@sxzz.moe&gt;
diff --git a/docs/options/package-exports.md b/docs/options/package-exports.md
@@ -80,7 +80,17 @@ The CSS filename defaults to `style.css` and can be customized via `css.fileName
 
 ## Customizing Exports
 
-If you need more control over the generated exports, you can provide a custom function via `exports.customExports`:
+If you need more control over the generated exports, you can provide an object or a custom function via `exports.customExports`:
+
+```ts
+export default defineConfig({
+  exports: {
+    customExports: {
+      './foo': './foo.js',
+    },
+  },
+})
+```
 
 ```ts
 export default defineConfig({
diff --git a/docs/zh-CN/options/package-exports.md b/docs/zh-CN/options/package-exports.md
@@ -80,7 +80,17 @@ CSS 文件名默认为 `style.css`，可通过 `css.fileName` 自定义。
 
 ## 自定义导出
 
-如果您需要对生成的导出字段进行更细致的控制，可以通过 `exports.customExports` 提供自定义函数：
+如果您需要对生成的导出字段进行更细致的控制，可以通过 `exports.customExports` 提供一个对象或自定义函数：
+
+```ts
+export default defineConfig({
+  exports: {
+    customExports: {
+      './foo': './foo.js',
+    },
+  },
+})
+```
 
 ```ts
 export default defineConfig({
diff --git a/dts.snapshot.json b/dts.snapshot.json
@@ -70,7 +70,6 @@
     "resolveUserConfig": "declare function resolveUserConfig(_: UserConfig, _: InlineConfig): Promise<ResolvedConfig[]>"
   },
   "plugins.d.mts": {
-    "DepPlugin": "declare function DepPlugin(_: ResolvedConfig): Plugin",
     "NodeProtocolPlugin": "declare function NodeProtocolPlugin(_: 'strip' | true): Plugin",
     "ShebangPlugin": "declare function ShebangPlugin(_: Logger, _: string, _: string, _: boolean): Plugin",
     "WatchPlugin": "declare function WatchPlugin(_: string[], _: TsdownBundle): Plugin",
@@ -99,9 +98,10 @@
     "CopyOptions": "type CopyOptions = Arrayable<string | CopyEntry>",
     "CopyOptionsFn": "type CopyOptionsFn = (_: ResolvedConfig) => Awaitable<CopyOptions>",
     "CssOptions": "interface CssOptions {\n splitting?: boolean\n fileName?: string\n}",
+    "DepPlugin": "declare function DepPlugin(_: ResolvedConfig): Plugin",
     "DepsConfig": "interface DepsConfig {\n neverBundle?: ExternalOption\n alwaysBundle?: Arrayable<string | RegExp> | NoExternalFn\n onlyAllowBundle?: Arrayable<string | RegExp> | false\n skipNodeModulesBundle?: boolean\n}",
     "DevtoolsOptions": "interface DevtoolsOptions extends NonNullable<InputOptions['devtools']> {\n ui?: boolean | Partial<StartOptions>\n clean?: boolean\n}",
-    "ExportsOptions": "interface ExportsOptions {\n devExports?: boolean | string\n packageJson?: boolean\n all?: boolean\n exclude?: (RegExp | string)[]\n legacy?: boolean\n customExports?: (_: Record<string, any>, _: { pkg: PackageJson; chunks: ChunksByFormat; isPublish: boolean }) => Awaitable<Record<string, any>>\n}",
+    "ExportsOptions": "interface ExportsOptions {\n devExports?: boolean | string\n packageJson?: boolean\n all?: boolean\n exclude?: (RegExp | string)[]\n legacy?: boolean\n customExports?: Record<string, any> | ((_: Record<string, any>, _: { pkg: PackageJson; chunks: ChunksByFormat; isPublish: boolean }) => Awaitable<Record<string, any>>)\n}",
     "Format": "type Format = ModuleFormat",
     "globalLogger": "Logger",
     "InlineConfig": "interface InlineConfig extends UserConfig {\n config?: boolean | string\n configLoader?: 'auto' | 'native' | 'unrun'\n filter?: RegExp | Arrayable<string>\n}",
diff --git a/src/features/pkg/exports.test.ts b/src/features/pkg/exports.test.ts
@@ -280,6 +280,38 @@ describe('generateExports', () => {
     `)
   })
 
+  test('customExports via object', async ({ expect }) => {
+    const results = await generateExports(
+      { es: [genChunk('index.js')] },
+      {
+        exports: {
+          devExports: 'dev',
+          customExports: {
+            './TEST': './TEST',
+          },
+        },
+      },
+    )
+    // key order matters
+    expect(JSON.stringify(results, undefined, 2)).toMatchInlineSnapshot(`
+      "{
+        "exports": {
+          ".": {
+            "dev": "./SRC/index.js",
+            "default": "./index.js"
+          },
+          "./package.json": "./package.json",
+          "./TEST": "./TEST"
+        },
+        "publishExports": {
+          ".": "./index.js",
+          "./package.json": "./package.json",
+          "./TEST": "./TEST"
+        }
+      }"
+    `)
+  })
+
   test('exclude via regex', async ({ expect }) => {
     const results = generateExports(
       { es: [genChunk('index.js'), genChunk('foo.js'), genChunk('bar.js')] },
diff --git a/src/features/pkg/exports.ts b/src/features/pkg/exports.ts
@@ -57,14 +57,38 @@ export interface ExportsOptions {
    */
   legacy?: boolean
 
-  customExports?: (
-    exports: Record<string, any>,
-    context: {
-      pkg: PackageJson
-      chunks: ChunksByFormat
-      isPublish: boolean
-    },
-  ) => Awaitable<Record<string, any>>
+  /**
+   * Specifies custom exports to add to the package exports in addition to the ones generated by tsdown.
+   * Use this to add additional exports in the exported package, such as workers or assets.
+   *
+   * @example
+   * customExports(exports) {
+   *   exports['./worker.js'] = './dist/worker.js';
+   *   return exports;
+   * }
+   *
+   * @example
+   * ```jsonc
+   * {
+   *   "customExports": {
+   *     "./worker.js": {
+   *       "types": "./dist/worker.d.ts",
+   *       "default": "./dist/worker.js"
+   *     }
+   *   }
+   * }
+   * ```
+   */
+  customExports?:
+    | Record<string, any>
+    | ((
+        exports: Record<string, any>,
+        context: {
+          pkg: PackageJson
+          chunks: ChunksByFormat
+          isPublish: boolean
+        },
+      ) => Awaitable<Record<string, any>>)
 }
 
 export async function writeExports(
@@ -228,7 +252,9 @@ export async function generateExports(
   )
   exportMeta(exports, all, packageJson)
   exportCss(exports, chunks, css, pkgRoot)
-  if (customExports) {
+  if (typeof customExports === 'object') {
+    exports = { ...exports, ...customExports }
+  } else if (typeof customExports === 'function') {
     exports = await customExports(exports, {
       pkg,
       chunks,
@@ -246,7 +272,9 @@ export async function generateExports(
     )
     exportMeta(publishExports, all, packageJson)
     exportCss(publishExports, chunks, css, pkgRoot)
-    if (customExports) {
+    if (typeof customExports === 'object') {
+      publishExports = { ...publishExports, ...customExports }
+    } else if (typeof customExports === 'function') {
       publishExports = await customExports(publishExports, {
         pkg,
         chunks,
diff --git a/tsdown.config.ts b/tsdown.config.ts
@@ -38,9 +38,8 @@ export default defineConfig([
       profile: 'esm-only',
     },
     exports: {
-      customExports(exports) {
-        exports['./client'] = './client.d.ts'
-        return exports
+      customExports: {
+        './client': './client.d.ts',
       },
     },
     plugins: [
