Interface: InlineConfig

Defined in: src/config/types.ts:716

Options for tsdown.

Extends

• UserConfig

Properties

alias?

optional alias?: Record<string, string>;

Defined in: src/config/types.ts:195

Inherited from

UserConfig.alias

---

attw?

optional attw?: WithEnabled<AttwOptions>;

Defined in: src/config/types.ts:584

Run arethetypeswrong after bundling. Requires @arethetypeswrong/core to be installed.

Default

false

See

https://github.com/arethetypeswrong/arethetypeswrong.github.io

Inherited from

UserConfig.attw

---

banner?

optional banner?: ChunkAddon;

Defined in: src/config/types.ts:412

Inherited from

UserConfig.banner

---

bundle?

optional bundle?: boolean;

Defined in: src/config/types.ts:695

Deprecated

Use unbundle instead.

Default

true

Inherited from

UserConfig.bundle

---

checks?

optional checks?: ChecksOptions & object;

Defined in: src/config/types.ts:342

Controls which warnings are emitted during the build process. Each option can be set to true (emit warning) or false (suppress warning).

Type Declaration

legacyCjs?

optional legacyCjs?: boolean;

If the config includes the cjs format and one of its target >= node 20.19.0 / 22.12.0, warn the user about the deprecation of CommonJS.

Default

true

Inherited from

UserConfig.checks

---

cjsDefault?

optional cjsDefault?: boolean;

Defined in: src/config/types.ts:462

Converts a single default export from an explicit CJS entry module to module.exports. It does not apply to non-entry chunks emitted in unbundle mode.

Default

true

Inherited from

UserConfig.cjsDefault

---

clean?

optional clean?: boolean | string[];

Defined in: src/config/types.ts:406

Clean directories before build.

Default to output directory.

Default

true

Inherited from

UserConfig.clean

---

concurrency?

optional concurrency?: number;

Defined in: src/config/types.ts:736

Maximum number of Rolldown builds to run in parallel.

---

config?

optional config?: string | boolean;

Defined in: src/config/types.ts:720

Config file path

---

configLoader?

optional configLoader?: "tsx" | "auto" | "native" | "unrun";

Defined in: src/config/types.ts:726

Config loader to use. It can only be set via CLI or API.

Default

'auto'

---

copy?

optional copy?:
  | CopyOptions
  | CopyOptionsFn;

Defined in: src/config/types.ts:628

Copy files to another directory.

Example

;[
  'src/assets',
  'src/env.d.ts',
  'src/styles/**/*.css',
  { from: 'src/assets', to: 'dist/assets' },
  { from: 'src/styles/**/*.css', to: 'dist', flatten: true },
]

Inherited from

UserConfig.copy

---

css?

optional css?: CssOptions;

Defined in: src/config/types.ts:613

[experimental] CSS options. Requires @tsdown/css to be installed.

Inherited from

UserConfig.css

---

customLogger?

optional customLogger?: Logger;

Defined in: src/config/types.ts:515

Custom logger.

Inherited from

UserConfig.customLogger

---

cwd?

optional cwd?: string;

Defined in: src/config/types.ts:485

The working directory of the config file.

• Defaults to process.cwd | process.cwd() for root config.
• Defaults to the package directory for workspace config.

Default

process.cwd()

Inherited from

UserConfig.cwd

---

define?

optional define?: Record<string, string>;

Defined in: src/config/types.ts:270

Inherited from

UserConfig.define

---

deps?

optional deps?: DepsConfig;

Defined in: src/config/types.ts:193

Dependency handling options.

Inherited from

UserConfig.deps

---

devtools?

optional devtools?: WithEnabled<DevtoolsOptions>;

Defined in: src/config/types.ts:544

[experimental] Enable devtools.

DevTools is still under development, and this is for early testers only.

This may slow down the build process significantly.

Default

false

Inherited from

UserConfig.devtools

---

dts?

optional dts?: WithEnabled<DtsOptions>;

Defined in: src/config/types.ts:561

Enables generation of TypeScript declaration files (.d.ts).

By default, this option is auto-detected based on your project's package.json:

• If exe is enabled, declaration file generation is disabled by default.
• If the types field is present, or if the main exports contains a types entry, declaration file generation is enabled by default.
• Otherwise, declaration file generation is disabled by default.

Inherited from

UserConfig.dts

---

entry?

optional entry?: TsdownInputOption;

Defined in: src/config/types.ts:188

Defaults to 'src/index.ts' if it exists.

Supports glob patterns with negation to exclude files:

Example

entry: {
  "hooks/*": ["./src/hooks/*.ts", "!./src/hooks/index.ts"],
}

Default

{
  index: 'src/index.ts'
}

Inherited from

UserConfig.entry

---

env?

optional env?: Record<string, any>;

Defined in: src/config/types.ts:258

Compile-time env variables, which can be accessed via import.meta.env or process.env.

Example

{
  "DEBUG": true,
  "NODE_ENV": "production"
}

Default

{
}

Inherited from

UserConfig.env

---

envFile?

optional envFile?: string;

Defined in: src/config/types.ts:264

Path to env file providing compile-time env variables.

Example

`.env`, `.env.production`, etc.

Inherited from

UserConfig.envFile

---

envPrefix?

optional envPrefix?: string | string[];

Defined in: src/config/types.ts:269

When loading env variables from envFile, only include variables with these prefixes.

Default

'TSDOWN_'

Inherited from

UserConfig.envPrefix

---

exe?

optional exe?: WithEnabled<ExeOptions>;

Defined in: src/config/types.ts:641

[experimental] Bundle as executable using Node.js SEA (Single Executable Applications).

This will bundle the output into a single executable file using Node.js SEA. Note that this is only supported on Node.js 25.7.0 and later, and is not supported in Bun or Deno.

Default

false

Inherited from

UserConfig.exe

---

exports?

optional exports?: WithEnabled<ExportsOptions>;

Defined in: src/config/types.ts:607

Generate package exports for package.json.

This will set the exports field in package.json to point to the generated files.

Default

false

Inherited from

UserConfig.exports

---

external?

optional external?: string | RegExp | (string | RegExp)[] | ExternalOptionFunction;

Defined in: src/config/types.ts:656

Deprecated

Use deps.neverBundle instead.

Inherited from

UserConfig.external

---

failOnWarn?

optional failOnWarn?: boolean | CIOption;

Defined in: src/config/types.ts:503

If true, fails the build on warnings.

Default

false

Inherited from

UserConfig.failOnWarn

---

filter?

optional filter?: RegExp | Arrayable<string>;

Defined in: src/config/types.ts:731

Filter configs by cwd or name.

---

fixedExtension?

optional fixedExtension?: boolean;

Defined in: src/config/types.ts:441

Use a fixed extension for output files. The extension will always be .cjs or .mjs. Otherwise, it will depend on the package type.

Defaults to true if platform is set to node, false otherwise.

Default

platform === 'node'

Inherited from

UserConfig.fixedExtension

---

footer?

optional footer?: ChunkAddon;

Defined in: src/config/types.ts:411

Inherited from

UserConfig.footer

---

format?

optional format?:
  | "es" | "cjs" | "iife" | "umd" | "commonjs" | "module" | "esm"
  | ("es" | "cjs" | "iife" | "umd" | "commonjs" | "module" | "esm")[]
| Partial<Record<"es" | "cjs" | "iife" | "umd" | "commonjs" | "module" | "esm", Partial<ResolvedConfig>>>;

Defined in: src/config/types.ts:378

Output format(s). Available formats are

• esm: ESM
• cjs: CommonJS
• iife: IIFE
• umd: UMD

Default

'esm'

Inherited from

UserConfig.format

---

fromVite?

optional fromVite?: boolean | "vitest";

Defined in: src/config/types.ts:524

Reuse config from Vite or Vitest (experimental)

Default

false

Inherited from

UserConfig.fromVite

---

globalName?

optional globalName?: string;

Defined in: src/config/types.ts:379

Inherited from

UserConfig.globalName

---

globImport?

optional globImport?: boolean;

Defined in: src/config/types.ts:597

import.meta.glob support.

See

https://vite.dev/guide/features.html#glob-import

Default

true

Inherited from

UserConfig.globImport

---

hash?

optional hash?: boolean;

Defined in: src/config/types.ts:453

If enabled, appends hash to chunk filenames.

Default

true

Inherited from

UserConfig.hash

---

hooks?

optional hooks?:
  | Partial<TsdownHooks>
  | ((hooks) => Awaitable<void>);

Defined in: src/config/types.ts:630

Inherited from

UserConfig.hooks

---

ignoreWatch?

optional ignoreWatch?: Arrayable<string | RegExp>;

Defined in: src/config/types.ts:533

Files or patterns to not watch while in watch mode.

Inherited from

UserConfig.ignoreWatch

---

injectStyle?

optional injectStyle?: boolean;

Defined in: src/config/types.ts:705

Deprecated

Use CssOptions.inject | css.inject instead.

Inherited from

UserConfig.injectStyle

---

inlineOnly?

optional inlineOnly?: false | Arrayable<string | RegExp>;

Defined in: src/config/types.ts:664

Deprecated

Use deps.onlyBundle instead.

Inherited from

UserConfig.inlineOnly

---

inputOptions?

optional inputOptions?:
  | InputOptions
  | ((options, format, context) => Awaitable<void | InputOptions | null>);

Defined in: src/config/types.ts:358

Use with caution; ensure you understand the implications.

Inherited from

UserConfig.inputOptions

---

loader?

optional loader?: ModuleTypes;

Defined in: src/config/types.ts:293

Sets how input files are processed. For example, use 'js' to treat files as JavaScript or 'base64' for images. Lets you import or require files like images or fonts.

Example

{ ".jpg": "asset", ".png": "base64" }

Inherited from

UserConfig.loader

---

logLevel?

optional logLevel?: LogLevel;

Defined in: src/config/types.ts:498

Log level.

Default

'info'

Inherited from

UserConfig.logLevel

---

minify?

optional minify?: boolean | "dce-only" | MinifyOptions;

Defined in: src/config/types.ts:410

Default

false

Inherited from

UserConfig.minify

---

name?

optional name?: string;

Defined in: src/config/types.ts:492

The name to show in CLI output. This is useful for monorepos or workspaces. When using workspace mode, this option defaults to the package name from package.json. In non-workspace mode, this option must be set explicitly for the name to show in the CLI output.

Inherited from

UserConfig.name

---

nodeProtocol?

optional nodeProtocol?: boolean | "strip";

Defined in: src/config/types.ts:337

Control whether built-in Node.js module imports use the node: protocol.

• true: Add the node: prefix to built-in module imports.
• 'strip': Remove the node: prefix from built-in module imports.
• false: Do not transform built-in module imports.

Default

false

Examples

`nodeProtocol: true` — add the `node:` prefix

// Input
import 'fs'

// Output
import 'node:fs'

`nodeProtocol: 'strip'` — remove the `node:` prefix

// Input
import 'node:fs'

// Output
import 'fs'

`nodeProtocol: false` — do not transform imports

// Input
import 'node:fs'

// Output
import 'node:fs'

Inherited from

UserConfig.nodeProtocol

---

noExternal?

optional noExternal?:
  | Arrayable<string | RegExp>
  | NoExternalFn;

Defined in: src/config/types.ts:660

Deprecated

Use deps.alwaysBundle instead.

Inherited from

UserConfig.noExternal

---

onSuccess?

optional onSuccess?: string | ((config, signal) => void | Promise<void>);

Defined in: src/config/types.ts:549

You can specify command to be executed after a successful build, specially useful for Watch mode

Inherited from

UserConfig.onSuccess

---

outDir?

optional outDir?: string;

Defined in: src/config/types.ts:383

Default

'dist'

Inherited from

UserConfig.outDir

---

outExtension?

optional outExtension?: OutExtensionFactory;

Defined in: src/config/types.ts:700

Deprecated

Use outExtensions instead.

Inherited from

UserConfig.outExtension

---

outExtensions?

optional outExtensions?: OutExtensionFactory;

Defined in: src/config/types.ts:447

Custom extensions for output files. fixedExtension will be overridden by this option.

Inherited from

UserConfig.outExtensions

---

outputOptions?

optional outputOptions?:
  | OutputOptions
  | ((options, format, context) => Awaitable<void | OutputOptions | null>);

Defined in: src/config/types.ts:467

Use with caution; ensure you understand the implications.

Inherited from

UserConfig.outputOptions

---

platform?

optional platform?: "node" | "neutral" | "browser";

Defined in: src/config/types.ts:213

Specifies the target runtime platform for the build.

• node: Node.js and compatible runtimes (e.g., Deno, Bun). For CJS format, this is always set to node and cannot be changed.
• neutral: A platform-agnostic target with no specific runtime assumptions.
• browser: Web browsers.

Default

'node'

See

https://tsdown.dev/options/platform

Inherited from

UserConfig.platform

---

plugins?

optional plugins?: TsdownPluginOption;

Defined in: src/config/types.ts:353

Inherited from

UserConfig.plugins

---

publicDir?

optional publicDir?:
  | CopyOptions
  | CopyOptionsFn;

Defined in: src/config/types.ts:711

Alias

copy

Deprecated

Alias for copy, will be removed in the future.

Inherited from

UserConfig.publicDir

---

publint?

optional publint?: WithEnabled<PublintOptions>;

Defined in: src/config/types.ts:575

Run publint after bundling. Requires publint to be installed.

Default

false

Inherited from

UserConfig.publint

---

removeNodeProtocol?

optional removeNodeProtocol?: boolean;

Defined in: src/config/types.ts:689

Remove the node: prefix from built-in Node.js module imports. When enabled, rewrites import sources like node:fs to fs.

Default

false

Deprecated

Use nodeProtocol: 'strip' instead.

Example

`removeNodeProtocol: true` — remove the `node:` prefix

// Input
import 'node:fs'

// Output
import 'fs'

Inherited from

UserConfig.removeNodeProtocol

---

report?

optional report?: WithEnabled<ReportOptions>;

Defined in: src/config/types.ts:590

Enable size reporting after bundling.

Default

true

Inherited from

UserConfig.report

---

root?

optional root?: string;

Defined in: src/config/types.ts:429

Specifies the root directory of input files, similar to TypeScript's rootDir. This determines the output directory structure.

By default, the root is computed as the common base directory of all entry files.

See

https://www.typescriptlang.org/tsconfig/#rootDir

Inherited from

UserConfig.root

---

shims?

optional shims?: boolean;

Defined in: src/config/types.ts:275

Default

false

Inherited from

UserConfig.shims

---

skipNodeModulesBundle?

optional skipNodeModulesBundle?: boolean;

Defined in: src/config/types.ts:669

Deprecated

Use deps.neverBundle: true instead.

Default

false

Inherited from

UserConfig.skipNodeModulesBundle

---

sourcemap?

optional sourcemap?: Sourcemap;

Defined in: src/config/types.ts:399

Whether to generate source map files.

Note that this option will always be true if you have `declarationMap` option enabled in your tsconfig.json.

Default

false

Inherited from

UserConfig.sourcemap

---

suppressWarnings?

optional suppressWarnings?: Arrayable<string | RegExp> | ((msg) => boolean);

Defined in: src/config/types.ts:511

Suppress warnings whose message matches the given pattern(s).

Accepts a string (substring match), a RegExp, an array of either, or a predicate function. Matched warnings are dropped before failOnWarn is applied, so they won't fail the build.

Inherited from

UserConfig.suppressWarnings

---

target?

optional target?: string | false | string[];

Defined in: src/config/types.ts:244

Specifies the compilation target environment(s).

Determines the JavaScript version or runtime(s) for which the code should be compiled. If not set, defaults to the value of engines.node in your project's package.json. If no engines.node field exists, no syntax transformations are applied.

Accepts a single target (e.g., 'es2020', 'node18', 'baseline-widely-available'), an array of targets, or false to disable all transformations.

See

https://tsdown.dev/options/target#supported-targets for a list of valid targets and more details.

Examples

// Target a single environment
{ "target": "node18" }

// Target multiple environments
{ "target": ["node18", "es2020"] }

// Disable all syntax transformations
{ "target": false }

Inherited from

UserConfig.target

---

treeshake?

optional treeshake?: boolean | TreeshakingOptions;

Defined in: src/config/types.ts:282

Configure tree shaking options.

See

https://rolldown.rs/reference/InputOptions.treeshake for more details.

Default

true

Inherited from

UserConfig.treeshake

---

tsconfig?

optional tsconfig?: string | boolean;

Defined in: src/config/types.ts:200

Default

true

Inherited from

UserConfig.tsconfig

---

unbundle?

optional unbundle?: boolean;

Defined in: src/config/types.ts:419

Determines whether unbundle is enabled. When set to true, the output files will mirror the input file structure.

Default

false

Inherited from

UserConfig.unbundle

---

unused?

optional unused?: WithEnabled<UnusedOptions>;

Defined in: src/config/types.ts:568

Enable unused dependencies check with unplugin-unused Requires unplugin-unused to be installed.

Default

false

Inherited from

UserConfig.unused

---

watch?

optional watch?: boolean | Arrayable<string>;

Defined in: src/config/types.ts:529

Default

false

Inherited from

UserConfig.watch

---

workspace?

optional workspace?: true | Arrayable<string> | Workspace;

Defined in: src/config/types.ts:647

[experimental] Enable workspace mode. This allows you to build multiple packages in a monorepo.

Inherited from

UserConfig.workspace

---

write?

optional write?: boolean;

Defined in: src/config/types.ts:389

Whether to write the files to disk. This option is incompatible with watch mode.

Default

true

Inherited from

UserConfig.write