Interface: ExportsOptions

Defined in: src/features/pkg/exports.ts:16

Properties

all?

optional all?: boolean;

Defined in: src/features/pkg/exports.ts:58

Generate exports for all files.

Example

{
  "exports": {
    "./*": "./*"
  }
}

Default

false

---

bin?

optional bin?: string | boolean | Record<string, string>;

Defined in: src/features/pkg/exports.ts:192

Generate the bin field in package.json for CLI executables.

Controls how command names are mapped to built entry files:

• true: Auto-detect a single CLI entry from entry chunks that contain a shebang (for example, #!/usr/bin/env node). The command name is derived from the package name without its scope. Throws if multiple shebang entries are found. Warns and skips generation if none are found.
• string: Use the given source file path (relative to cwd) as the CLI entry. The command name is derived from the package name without its scope. Warns if the source file does not contain a shebang.
• Record<string, string>: Explicitly map command names to source file paths (relative to cwd). Warns for each source file that does not contain a shebang.

When ExportsOptions.devExports is enabled, the bin field in package.json points to source files during local development, while publishConfig.bin points to built output paths for publishing.

Examples

Auto-detect a CLI entry from a shebang

{
  bin: true
}

Single CLI command with an explicit source entry

{
  bin: './src/cli.ts'
}

Multiple named CLI commands

{
  bin: {
    tool: './src/cli.ts',
    serve: './src/cli-extra.ts',
  },
}

See

npm documentation for the `bin` field

---

customExports?

optional customExports?:
  | Record<string, any>
  | ((exports, context) => Awaitable<Record<string, any>>);

Defined in: src/features/pkg/exports.ts:107

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.

Examples

customExports(exports) {
  exports['./worker.js'] = './dist/worker.js';
  return exports;
}

{
  "customExports": {
    "./worker.js": {
      "types": "./dist/worker.d.ts",
      "default": "./dist/worker.js",
    },
  },
}

---

devExports?

optional devExports?: string | boolean;

Defined in: src/features/pkg/exports.ts:22

Generate exports that link to source code during development.

• string: add as a custom condition.
• true: all conditions point to source files, and add dist exports to publishConfig.

---

exclude?

optional exclude?: (string | RegExp)[];

Defined in: src/features/pkg/exports.ts:71

Specifies file patterns (as glob patterns or regular expressions) to exclude from package exports. Use this to prevent certain files from being included in the exported package, such as test files, binaries, or internal utilities.

Note: Do not include file extensions, and paths should be relative to the dist directory.

Example

exclude: ['cli', '**/*.test', /internal/]

---

extensions?

optional extensions?: boolean;

Defined in: src/features/pkg/exports.ts:138

Add file extensions to subpath export keys.

When enabled, all subpath exports (except the root ".") will include a .js extension in the key (e.g., "./utils.js" instead of "./utils").

This follows the Node.js recommendation for subpath exports:

See

https://nodejs.org/api/packages.html#extensions-in-subpaths

Default

false

---

inlinedDependencies?

optional inlinedDependencies?: boolean;

Defined in: src/features/pkg/exports.ts:125

Generate inlinedDependencies field in package.json. Lists dependencies that are physically inlined into the bundle with their exact versions.

Default

true

See

https://github.com/e18e/ecosystem-issues/issues/237

---

legacy?

optional legacy?: boolean;

Defined in: src/features/pkg/exports.ts:81

Generate legacy fields (main and module) for older Node.js and bundlers that do not support package exports field.

Defaults to false, if only ESM builds are included, true otherwise.

See

https://github.com/publint/publint/issues/24

---

packageJson?

optional packageJson?: boolean;

Defined in: src/features/pkg/exports.ts:42

Generate exports for package.json file.

Example

{
  "exports": {
    ".": {
      "types": "./dist/index.d.mts",
      "import": "./dist/index.mjs"
    },
    "./package.json": "./package.json"
  }
}

Default

true