---
url: /reference/api/Interface.DtsOptions.md
---
# Interface: DtsOptions

Defined in: node\_modules/.pnpm/rolldown-plugin-dts@0.28.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:162

Configuration accepted by dts.

## Extends

* `GeneralOptions`.`TscOptions`

## Properties

### build?

```ts
optional build?: boolean;
```

Defined in: node\_modules/.pnpm/rolldown-plugin-dts@0.28.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:117

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.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:97

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.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:75

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.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:187

**`Experimental`**

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

If a language is supported via [Volar](https://volarjs.dev),
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.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:50

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.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:56

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.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:147

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.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:62

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.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:159

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.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:44

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

Patterns are relative to [cwd](#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.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:32

The generator used to produce declaration files.

* `'tsc'` supports the full TypeScript type system.
* `'oxc'` is faster but requires code compatible with
  [`isolatedDeclarations`](https://www.typescriptlang.org/tsconfig/#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.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:124

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.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:109

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.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:153

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.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:169

Options for the `oxc` generator.

The top-level [sourcemap](#sourcemap) option controls
declaration maps.

***

### parallel?

```ts
optional parallel?: boolean;
```

Defined in: node\_modules/.pnpm/rolldown-plugin-dts@0.28.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:139

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.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:90

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.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:103

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.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:81

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.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:69

A `tsconfig.json` path, resolved relative to [cwd](#cwd).

When omitted or `true`, the nearest config is discovered from [cwd](#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.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:71

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.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:176

**\[Experimental]** Options for the `tsgo` generator.

Used when [generator](#generator) is `'tsgo'` or
TypeScript 7 is detected.

***

### vue?

```ts
optional vue?: boolean | VueLanguageOptions;
```

Defined in: node\_modules/.pnpm/rolldown-plugin-dts@0.28.5\_@volar+typescript@2.4.28\_typescript@6.0.3\_\_rolldown@1.2.8\_ty\_8d3aa6dad8d682b6974ee1f279b540c8/node\_modules/rolldown-plugin-dts/dist/index.d.mts:133

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

This is a shortcut for a preconfigured [Options.customLanguages](#customlanguages)
entry and requires the `tsc` generator.

#### Default

```ts
false
```

#### Inherited from

```ts
TscOptions.vue
```