Interface: OutputOptions

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:222

Properties

advancedChunks?

optional advancedChunks: object;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:389

Allows you to do manual chunking. For deeper understanding, please refer to the in-depth documentation.

groups?

optional groups: object[];

Groups to be used for advanced chunking.

includeDependenciesRecursively?

optional includeDependenciesRecursively: boolean;

• Type: boolean
• Default: true

By default, each group will also include captured modules' dependencies. This reduces the chance of generating circular chunks.

If you want to disable this behavior, it's recommended to both set

• preserveEntrySignatures: false | 'allow-extension'
• strictExecutionOrder: true

to avoid generating invalid chunks.

maxModuleSize?

optional maxModuleSize: number;

• Type: number

Global fallback of {group}.maxModuleSize, if it's not specified in the group.

maxSize?

optional maxSize: number;

• Type: number

Global fallback of {group}.maxSize, if it's not specified in the group.

minModuleSize?

optional minModuleSize: number;

• Type: number

Global fallback of {group}.minModuleSize, if it's not specified in the group.

minShareCount?

optional minShareCount: number;

• Type: number

Global fallback of {group}.minShareCount, if it's not specified in the group.

minSize?

optional minSize: number;

• Type: number

Global fallback of {group}.minSize, if it's not specified in the group.

---

assetFileNames?

optional assetFileNames: string | AssetFileNamesFunction;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:287

---

banner?

optional banner: string | AddonFunction;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:273

---

chunkFileNames?

optional chunkFileNames:
  | string
  | ChunkFileNamesFunction;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:289

---

cleanDir?

optional cleanDir: boolean;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:604

• Type: boolean
• Default: false

Clean output directory before emitting output.

---

cssChunkFileNames?

optional cssChunkFileNames:
  | string
  | ChunkFileNamesFunction;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:291

---

cssEntryFileNames?

optional cssEntryFileNames:
  | string
  | ChunkFileNamesFunction;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:290

---

dir?

optional dir: string;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:223

---

dynamicImportInCjs?

optional dynamicImportInCjs: boolean;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:340

---

entryFileNames?

optional entryFileNames:
  | string
  | ChunkFileNamesFunction;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:288

---

esModule?

optional esModule: boolean | "if-default-prop";

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:286

---

exports?

optional exports: "default" | "auto" | "named" | "none";

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:225

---

extend?

optional extend: boolean;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:285

---

externalLiveBindings?

optional externalLiveBindings: boolean;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:338

---

file?

optional file: string;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:224

---

footer?

optional footer: string | AddonFunction;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:274

---

format?

optional format: ModuleFormat;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:236

Expected format of generated code.

• 'es', 'esm' and 'module' are the same format, all stand for ES module.
• 'cjs' and 'commonjs' are the same format, all stand for CommonJS module.
• 'iife' stands for Immediately Invoked Function Expression.
• 'umd' stands for Universal Module Definition.

Default

'esm'

---

generatedCode?

optional generatedCode: Partial<GeneratedCodeOptions>;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:337

---

globals?

optional globals:
  | Record<string, string>
  | GlobalsFunction;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:305

---

hashCharacters?

optional hashCharacters: "base64" | "hex" | "base36";

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:226

---

hoistTransitiveImports?

optional hoistTransitiveImports: false;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:586

---

inlineDynamicImports?

optional inlineDynamicImports: boolean;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:339

---

intro?

optional intro: string | AddonFunction;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:283

---

keepNames?

optional keepNames: boolean;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:612

Keep function and class names after bundling.

When enabled, the bundler will preserve the original names of functions and classes in the output, which is useful for debugging and error stack traces.

Default

false

---

legalComments?

optional legalComments: "inline" | "none";

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:583

Control comments in the output.

• none: no comments
• inline: preserve comments that contain @license, @preserve or starts with //! /*!

---

manualChunks?

optional manualChunks: ManualChunksFunction;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:385

• Type: ((moduleId: string, meta: { getModuleInfo: (moduleId: string) => ModuleInfo | null }) => string | NullValue)
• Object form is not supported.

WARNING

• This option is deprecated. Please use advancedChunks instead.
• If manualChunks and advancedChunks are both specified, manualChunks option will be ignored.

You could use this option for migration purpose. Under the hood,

{
  manualChunks: (moduleId, meta) => {
    if (moduleId.includes('node_modules')) {
      return 'vendor'
    }
    return null
  }
}

will be transformed to

{
  advancedChunks: {
    groups: [
      {
        name(moduleId) {
          if (moduleId.includes('node_modules')) {
            return 'vendor';
          }
          return null;
        },
      },
    ],
  }
}

Deprecated

Please use advancedChunks instead.

---

minify?

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

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:303

Control code minification.

• true: Enable full minification including code compression and dead code elimination
• false: Disable minification (default)
• 'dce-only': Only perform dead code elimination without code compression
• MinifyOptions: Fine-grained control over minification settings

Default

false

---

minifyInternalExports?

optional minifyInternalExports: boolean;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:597

• Type: boolean
• Default: true for format es or if output.minify is true or object, false otherwise

Whether to minify internal exports.

---

name?

optional name: string;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:304

---

outro?

optional outro: string | AddonFunction;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:284

---

paths?

optional paths: Record<string, string> | PathsFunction$1;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:336

Maps external module IDs to paths.

Allows customizing the path used when importing external dependencies. This is particularly useful for loading dependencies from CDNs or custom locations.

• Object form: Maps module IDs to their replacement paths
• Function form: Takes a module ID and returns its replacement path

Examples

{
  paths: {
    'd3': 'https://cdn.jsdelivr.net/npm/d3@7'
  }
}

{
  paths: (id) => {
    if (id.startsWith('lodash')) {
      return `https://cdn.jsdelivr.net/npm/${id}`
    }
    return id
  }
}

---

plugins?

optional plugins: RolldownOutputPluginOption;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:584

---

polyfillRequire?

optional polyfillRequire: boolean;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:585

---

postBanner?

optional postBanner: string | AddonFunction;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:278

Similar to banner option, but will run after the renderChunk hook and builtin minification.

---

postFooter?

optional postFooter: string | AddonFunction;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:282

Similar to footer option, but will run after the renderChunk hook and builtin minification.

---

preserveModules?

optional preserveModules: boolean;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:587

---

preserveModulesRoot?

optional preserveModulesRoot: string;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:589

---

sanitizeFileName?

optional sanitizeFileName: boolean | SanitizeFileNameFunction;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:292

---

sourcemap?

optional sourcemap: boolean | "hidden" | "inline";

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:237

---

sourcemapBaseUrl?

optional sourcemapBaseUrl: string;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:238

---

sourcemapDebugIds?

optional sourcemapDebugIds: boolean;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:239

---

sourcemapIgnoreList?

optional sourcemapIgnoreList:
  | boolean
  | StringOrRegExp
  | SourcemapIgnoreListOption;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:271

Control which source files are included in the sourcemap ignore list. Files in the ignore list are excluded from debugger stepping and error stack traces.

• false: Include all source files in the ignore list
• true: Include no source files in the ignore list
• string: Files containing this string in their path will be included in the ignore list
• RegExp: Files matching this regular expression will be included in the ignore list
• function: Custom function (source: string, sourcemapPath: string) => boolean to determine if a source should be ignored

Performance

Using static values (boolean, string, or RegExp) is significantly more performant than functions. Calling JavaScript functions from Rust has extremely high overhead, so prefer static patterns when possible.

Examples

// ✅ Preferred: Use RegExp for better performance
sourcemapIgnoreList: /node_modules/

// ✅ Preferred: Use string pattern for better performance
sourcemapIgnoreList: 'vendor'

// ! Use sparingly: Function calls have high overhead
sourcemapIgnoreList: (source, sourcemapPath) => {
  return source.includes('node_modules') || source.includes('.min.')
}

default: /node_modules/

---

sourcemapPathTransform?

optional sourcemapPathTransform: SourcemapPathTransformOption;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:272

---

topLevelVar?

optional topLevelVar: boolean;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:590

---

virtualDirname?

optional virtualDirname: string;

Defined in: node_modules/.pnpm/rolldown@1.0.0-beta.58/node_modules/rolldown/dist/shared/define-config-twT5HTur.d.mts:588