Interface GeneralOptions

Determines how the default export is emitted.

If set to true, and you are only exporting a single item using export default ..., the output will use export = ... instead of the standard ES module syntax. This is useful for compatibility with CommonJS. This only controls the output format and does not enable support for CommonJS-style .d.ts input.

Override the compilerOptions specified in tsconfig.json.

The directory in which the plugin will search for the tsconfig.json file.

Set to true if your entry files are .d.ts files instead of .ts files.

When enabled, the plugin will skip generating a .d.ts file for the entry point.

If true, the plugin will emit only .d.ts files and remove all other output chunks.

This is especially useful when generating .d.ts files for the CommonJS format as part of a separate build step.

Glob pattern(s) to filter which entry files get .d.ts generation.

When specified, only entry files matching these patterns will emit .d.ts chunks. When not specified, all entries get .d.ts generation.

Supports negation patterns (e.g., ['**', '!src/icons/**']) for exclusion. Patterns are matched against file paths relative to cwd.

The generator used to produce .d.ts files.

• 'tsc': The TypeScript 5.x/6.x compiler. Supports all TypeScript features.
• 'oxc': Oxc's isolated declaration generator. Much faster than tsc, but only supports code that satisfies isolatedDeclarations.
• 'tsgo': [Experimental] The TypeScript Go compiler (tsgo). May not support all TypeScript features yet.

When unset, the generator is inferred:

• 'oxc' if oxc options are provided or isolatedDeclarations is enabled in compilerOptions.
• 'tsgo' if TypeScript 7.0 (or @typescript/native-preview) is installed, or tsgo options are provided.
• 'tsc' otherwise, and always when vue is enabled.

Specifies a resolver to resolve type definitions, especially for node_modules.

• 'oxc': Uses Oxc's module resolution, which is faster and more efficient.
• 'tsc': Uses TypeScript's native module resolution, which may be more compatible with complex setups, but slower.

Indicates whether the generated .d.ts files have side effects.

• If set to true, Rolldown will treat the .d.ts files as having side effects during tree-shaking.
• If set to false, Rolldown may consider the .d.ts files as side-effect-free, potentially removing them if they are not imported.

If true, the plugin will generate declaration maps (.d.ts.map) for .d.ts files.

The path to the tsconfig.json file.

If set to false, the plugin will ignore any tsconfig.json file. You can still specify compilerOptions directly in the options.

Pass a raw tsconfig.json object directly to the plugin.