跳到正文

Interface: DtsOptions

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:156

Configuration accepted by dts.

Extends

  • GeneralOptions.TscOptions

Properties

build?

ts
optional build?: boolean;

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:111

Uses TypeScript build mode (tsc -b) and follows project references.

Default

ts
false

Inherited from

ts
TscOptions.build

cjsDefault?

ts
optional cjsDefault?: boolean;

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:91

Converts a single default export to export = for CommonJS consumers. This does not add support for CommonJS-style declaration input.

Default

ts
false

Inherited from

ts
GeneralOptions.cjsDefault

compilerOptions?

ts
optional compilerOptions?: CompilerOptions;

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:69

Compiler options merged over those loaded from tsconfig.json.

Inherited from

ts
GeneralOptions.compilerOptions

customLanguages?

ts
optional customLanguages?: CustomLanguage[];

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:181

Experimental

Registers non-standard source languages such as Vue or Astro.

If a language is supported via Volar, CustomLanguage.volarTypeScript and CustomLanguage.createVolarPlugins are both required. Volar languages require tsc; tsgo does not support custom languages.


cwd?

ts
optional cwd?: string;

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:44

Base directory for config discovery, glob matching, and relative paths.

Default

ts
process.cwd()

Inherited from

ts
GeneralOptions.cwd

dtsInput?

ts
optional dtsInput?: boolean;

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:50

Treats entry files as existing declarations instead of source files.

Default

ts
false

Inherited from

ts
GeneralOptions.dtsInput

eager?

ts
optional eager?: boolean;

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:141

Loads every file listed by tsconfig.json into the TypeScript program.

Useful when one config covers multiple packages or entry points.

Default

ts
false

Inherited from

ts
TscOptions.eager

emitDtsOnly?

ts
optional emitDtsOnly?: boolean;

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:56

Removes non-declaration chunks from the output.

Default

ts
false

Inherited from

ts
GeneralOptions.emitDtsOnly

emitJs?

ts
optional emitJs?: boolean;

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:153

Generates declarations for JavaScript files with JSDoc types.

Default

Enabled when allowJs or checkJs is set.

Inherited from

ts
TscOptions.emitJs

entry?

ts
optional entry?: string | string[];

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:38

Glob pattern(s) that select source files for declaration generation.

Patterns are relative to cwd and may be negated with !. Matching files are emitted even when they are not Rolldown entry points.

Example

ts
entry: ['src/*.ts', '!src/internal/**']

Inherited from

ts
GeneralOptions.entry

generator?

ts
optional generator?: "tsc" | "oxc" | "tsgo";

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:26

The generator used to produce declaration files.

  • 'tsc' supports the full TypeScript type system.
  • 'oxc' is faster but requires code compatible with isolatedDeclarations.
  • 'tsgo' uses the experimental TypeScript Go compiler.

When omitted, the plugin selects 'oxc' for isolatedDeclarations, 'tsgo' for TypeScript 7, and 'tsc' otherwise. Volar-based custom languages require 'tsc'.

Default

ts
Inferred from the TypeScript configuration and installed compiler.

Inherited from

ts
GeneralOptions.generator

incremental?

ts
optional incremental?: boolean;

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:118

Persists build-mode outputs, including .tsbuildinfo, to disk for reuse. When disabled, build outputs stay in memory.

Default

Enabled when the config sets incremental or tsBuildInfoFile.

Inherited from

ts
TscOptions.incremental

logger?

ts
optional logger?: Logger;

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:103

Logger used for plugin messages.

Default

ts
console

Inherited from

ts
GeneralOptions.logger

newContext?

ts
optional newContext?: boolean;

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:147

Uses an isolated TypeScript cache instead of the shared global context.

Default

ts
false

Inherited from

ts
TscOptions.newContext

oxc?

ts
optional oxc?: Omit<IsolatedDeclarationsOptions, "sourcemap">;

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:163

Options for the oxc generator.

The top-level sourcemap option controls declaration maps.


parallel?

ts
optional parallel?: boolean;

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:133

Runs tsc or vue-tsc in a separate process.

Default

ts
false

Inherited from

ts
TscOptions.parallel

resolver?

ts
optional resolver?: "tsc" | "oxc";

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:84

Resolver used for declaration imports, including packages in node_modules.

Use 'tsc' when a project depends on TypeScript-specific resolution behavior; otherwise 'oxc' is faster.

Default

ts
'oxc'

Inherited from

ts
GeneralOptions.resolver

sideEffects?

ts
optional sideEffects?: boolean;

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:97

Marks declaration modules as having side effects during tree-shaking.

Default

ts
false

Inherited from

ts
GeneralOptions.sideEffects

sourcemap?

ts
optional sourcemap?: boolean;

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:75

Emits declaration maps (.d.ts.map).

Default

The value of compilerOptions.declarationMap.

Inherited from

ts
GeneralOptions.sourcemap

tsconfig?

ts
optional tsconfig?: string | boolean;

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:63

A tsconfig.json path, resolved relative to cwd.

When omitted or true, the nearest config is discovered from cwd. Set to false to disable config loading.

Inherited from

ts
GeneralOptions.tsconfig

tsconfigRaw?

ts
optional tsconfigRaw?: Omit<TsConfigJson, "compilerOptions">;

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:65

Raw tsconfig.json values merged over the loaded config.

Inherited from

ts
GeneralOptions.tsconfigRaw

tsgo?

ts
optional tsgo?: TsgoOptions;

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:170

[Experimental] Options for the tsgo generator.

Used when generator is 'tsgo' or TypeScript 7 is detected.


vue?

ts
optional vue?: boolean;

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.28.0_@volar+typescript@2.4.28_typescript@6.0.3__rolldown@1.2.3_ty_8e5c8c396fcad311132dad5b7f2c9dab/node_modules/rolldown-plugin-dts/dist/index.d.mts:127

Registers the built-in Vue language integration using vue-tsc.

This is a shortcut for a preconfigured Options.customLanguages entry and requires the tsc generator.

Default

ts
false

Inherited from

ts
TscOptions.vue

Released under the MIT License.