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

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.29.0-beta.2\_@volar+typescript@2.4.28_typescript@6.0.3\_\_@vue+langu_c05ee0deaa818ec34770b8c8607670cc/node_modules/rolldown-plugin-dts/dist/index.d.mts:35

## Properties

### cjsDefault?

```ts
cjsDefault?: boolean;
```

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.29.0-beta.2\_@volar+typescript@2.4.28_typescript@6.0.3\_\_@vue+langu_c05ee0deaa818ec34770b8c8607670cc/node_modules/rolldown-plugin-dts/dist/index.d.mts:126

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

#### Default

```ts
false
```

***

### compilerOptions?

```ts
compilerOptions?: CompilerOptions;
```

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.29.0-beta.2\_@volar+typescript@2.4.28_typescript@6.0.3\_\_@vue+langu_c05ee0deaa818ec34770b8c8607670cc/node_modules/rolldown-plugin-dts/dist/index.d.mts:102

Compiler options merged over those loaded from `tsconfig.json`.
In the plugin's current `tsgo` implementation, these affect plugin behavior
but do not override the program's compiler options. Set those options in
the config file instead.

***

### customLanguages?

```ts
customLanguages?: CustomLanguage[];
```

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.29.0-beta.2\_@volar+typescript@2.4.28_typescript@6.0.3\_\_@vue+langu_c05ee0deaa818ec34770b8c8607670cc/node_modules/rolldown-plugin-dts/dist/index.d.mts:169

**`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`. Non-Volar languages can use `tsgo` together
with TsgoOptions.vfs \`tsgo.vfs\`.

***

### cwd?

```ts
cwd?: string;
```

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.29.0-beta.2\_@volar+typescript@2.4.28_typescript@6.0.3\_\_@vue+langu_c05ee0deaa818ec34770b8c8607670cc/node_modules/rolldown-plugin-dts/dist/index.d.mts:69

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

#### Default

```ts
process.cwd()
```

***

### dtsInput?

```ts
dtsInput?: boolean;
```

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.29.0-beta.2\_@volar+typescript@2.4.28_typescript@6.0.3\_\_@vue+langu_c05ee0deaa818ec34770b8c8607670cc/node_modules/rolldown-plugin-dts/dist/index.d.mts:75

Treats entry files as existing declarations instead of source files.

#### Default

```ts
false
```

***

### emitDtsOnly?

```ts
emitDtsOnly?: boolean;
```

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.29.0-beta.2\_@volar+typescript@2.4.28_typescript@6.0.3\_\_@vue+langu_c05ee0deaa818ec34770b8c8607670cc/node_modules/rolldown-plugin-dts/dist/index.d.mts:81

Removes non-declaration chunks from the output.

#### Default

```ts
false
```

***

### emitJs?

```ts
emitJs?: boolean;
```

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.29.0-beta.2\_@volar+typescript@2.4.28_typescript@6.0.3\_\_@vue+langu_c05ee0deaa818ec34770b8c8607670cc/node_modules/rolldown-plugin-dts/dist/index.d.mts:144

Generates declarations for JavaScript files with JSDoc types.

#### Default

Enabled when `allowJs` or `checkJs` is set.

***

### entry?

```ts
entry?: string | string[];
```

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.29.0-beta.2\_@volar+typescript@2.4.28_typescript@6.0.3\_\_@vue+langu_c05ee0deaa818ec34770b8c8607670cc/node_modules/rolldown-plugin-dts/dist/index.d.mts:63

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/**']
```

***

### generator?

```ts
generator?: "tsc" | "oxc" | "tsgo" | Generator;
```

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.29.0-beta.2\_@volar+typescript@2.4.28_typescript@6.0.3\_\_@vue+langu_c05ee0deaa818ec34770b8c8607670cc/node_modules/rolldown-plugin-dts/dist/index.d.mts:51

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 API.
* A custom Generator implementation can be provided directly.

When omitted, the plugin selects `'oxc'` for `isolatedDeclarations`,
`'tsgo'` when TypeScript exposes the declaration emit API, and `'tsc'`
otherwise. Volar-based custom languages require `'tsc'`.

#### Default

```ts
Inferred from the TypeScript configuration and installed compiler.
```

***

### logger?

```ts
logger?: Logger;
```

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.29.0-beta.2\_@volar+typescript@2.4.28_typescript@6.0.3\_\_@vue+langu_c05ee0deaa818ec34770b8c8607670cc/node_modules/rolldown-plugin-dts/dist/index.d.mts:138

Logger used for plugin messages.

#### Default

```ts
console
```

***

### oxc?

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

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.29.0-beta.2\_@volar+typescript@2.4.28_typescript@6.0.3\_\_@vue+langu_c05ee0deaa818ec34770b8c8607670cc/node_modules/rolldown-plugin-dts/dist/index.d.mts:153

Options for the `oxc` generator.

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

***

### resolver?

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

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.29.0-beta.2\_@volar+typescript@2.4.28_typescript@6.0.3\_\_@vue+langu_c05ee0deaa818ec34770b8c8607670cc/node_modules/rolldown-plugin-dts/dist/index.d.mts:119

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'
```

***

### sideEffects?

```ts
sideEffects?: boolean;
```

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.29.0-beta.2\_@volar+typescript@2.4.28_typescript@6.0.3\_\_@vue+langu_c05ee0deaa818ec34770b8c8607670cc/node_modules/rolldown-plugin-dts/dist/index.d.mts:132

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

#### Default

```ts
false
```

***

### sourcemap?

```ts
sourcemap?: boolean;
```

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.29.0-beta.2\_@volar+typescript@2.4.28_typescript@6.0.3\_\_@vue+langu_c05ee0deaa818ec34770b8c8607670cc/node_modules/rolldown-plugin-dts/dist/index.d.mts:110

Emits declaration maps (`.d.ts.map`).
With `tsgo`, source mappings also require `compilerOptions.declarationMap`
to be enabled in the on-disk config; `sourcemap: true` alone is insufficient.

#### Default

The value of `compilerOptions.declarationMap`.

***

### tsc?

```ts
tsc?: TscOptions;
```

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.29.0-beta.2\_@volar+typescript@2.4.28_typescript@6.0.3\_\_@vue+langu_c05ee0deaa818ec34770b8c8607670cc/node_modules/rolldown-plugin-dts/dist/index.d.mts:146

Options for the built-in `tsc` generator.

***

### tsconfig?

```ts
tsconfig?: string | boolean;
```

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.29.0-beta.2\_@volar+typescript@2.4.28_typescript@6.0.3\_\_@vue+langu_c05ee0deaa818ec34770b8c8607670cc/node_modules/rolldown-plugin-dts/dist/index.d.mts:89

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. The `tsgo` generator requires a
config file.

***

### tsconfigRaw?

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

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.29.0-beta.2\_@volar+typescript@2.4.28_typescript@6.0.3\_\_@vue+langu_c05ee0deaa818ec34770b8c8607670cc/node_modules/rolldown-plugin-dts/dist/index.d.mts:95

Raw `tsconfig.json` values merged over the loaded config.
The plugin's current `tsgo` implementation does not apply these overrides
to the TypeScript program.

***

### tsgo?

```ts
tsgo?: TsgoOptions;
```

Defined in: node_modules/.pnpm/rolldown-plugin-dts@0.29.0-beta.2\_@volar+typescript@2.4.28_typescript@6.0.3\_\_@vue+langu_c05ee0deaa818ec34770b8c8607670cc/node_modules/rolldown-plugin-dts/dist/index.d.mts:157

**\[Experimental]** Options for the TypeScript Go generator.