rolldown 1.0.0-beta.42 → 1.0.0-beta.44

package/dist/shared/{binding-CtbNz6TD.d.mts → binding-QBosa6N8.d.mts}

@@ -45,13 +45,30 @@ interface CompressOptions {
    */
   dropDebugger?: boolean;
   /**
-   * Drop unreferenced functions and variables.
+   * Pass `true` to drop unreferenced functions and variables.
    *
-   * Simple direct variable assignments do not count as references unless set to "keep_assign".
+   * Simple direct variable assignments do not count as references unless set to `keep_assign`.
+   * @default true
    */
-  unused?: true | false | 'keep_assign';
+  unused?: boolean | 'keep_assign';
   /** Keep function / class names. */
   keepNames?: CompressOptionsKeepNames;
+  /**
+   * Join consecutive var, let and const statements.
+   *
+   * @default true
+   */
+  joinVars?: boolean;
+  /**
+   * Join consecutive simple statements using the comma operator.
+   *
+   * `a; b` -> `a, b`
+   *
+   * @default true
+   */
+  sequences?: boolean;
+  /** Limit the maximum number of iterations for debugging purpose. */
+  maxIterations?: number;
 }
 interface CompressOptionsKeepNames {
   /**
@@ -1164,9 +1181,21 @@ declare class BindingBundlerImpl {
   get closed(): boolean;
   getWatchFiles(): Promise<Array<string>>;
 }
-declare class BindingClientHmrUpdate {
-  get clientId(): string;
-  get update(): BindingHmrUpdate;
+declare class BindingMagicString {
+  constructor(source: string);
+  replace(from: string, to: string): void;
+  replaceAll(from: string, to: string): void;
+  prepend(content: string): void;
+  append(content: string): void;
+  prependLeft(index: number, content: string): void;
+  prependRight(index: number, content: string): void;
+  appendLeft(index: number, content: string): void;
+  appendRight(index: number, content: string): void;
+  overwrite(start: number, end: number, content: string): void;
+  toString(): string;
+  hasChanged(): boolean;
+  length(): number;
+  isEmpty(): boolean;
 }
 declare class BindingOutputAsset {
   get fileName(): string;
@@ -1212,6 +1241,9 @@ declare class BindingRenderedModule {
   get code(): string | null;
   get renderedExports(): Array<string>;
 }
+declare class BindingUrlResolver {
+  call(url: string, importer?: string): Promise<[string, string | undefined]>;
+}
 declare class BindingWatcherChangeData {
   path: string;
   kind: string;
@@ -1224,15 +1256,15 @@ declare class BindingWatcherEvent {
   bundleErrorData(): BindingBundleErrorEventData;
 }
 interface BindingAssetPluginConfig {
-  isLib?: boolean;
-  isSsr?: boolean;
-  isWorker?: boolean;
-  urlBase?: string;
-  publicDir?: string;
-  decodedBase?: string;
-  isSkipAssets?: boolean;
-  assetsInclude?: Array<BindingStringOrRegex>;
-  assetInlineLimit?: number | ((file: string, content: Buffer) => boolean | undefined);
+  isLib: boolean;
+  isSsr: boolean;
+  isWorker: boolean;
+  urlBase: string;
+  publicDir: string;
+  decodedBase: string;
+  isSkipAssets: boolean;
+  assetsInclude: Array<BindingStringOrRegex>;
+  assetInlineLimit: number | ((file: string, content: Buffer) => boolean | undefined);
   renderBuiltUrl?: (filename: string, type: BindingRenderBuiltUrlConfig) => MaybePromise<VoidNullable<string | BindingRenderBuiltUrlRet>>;
 }
 interface BindingAssetSource {
@@ -1245,7 +1277,11 @@ interface BindingBuildImportAnalysisPluginConfig {
   renderBuiltUrl: boolean;
   isRelativeBase: boolean;
 }
-type BindingBuiltinPluginName = 'builtin:alias' | 'builtin:asset' | 'builtin:asset-import-meta-url' | 'builtin:build-import-analysis' | 'builtin:dynamic-import-vars' | 'builtin:import-glob' | 'builtin:isolated-declaration' | 'builtin:json' | 'builtin:load-fallback' | 'builtin:manifest' | 'builtin:module-preload-polyfill' | 'builtin:react-refresh-wrapper' | 'builtin:reporter' | 'builtin:replace' | 'builtin:esm-external-require' | 'builtin:transform' | 'builtin:vite-resolve' | 'builtin:wasm-fallback' | 'builtin:wasm-helper' | 'builtin:web-worker-post';
+type BindingBuiltinPluginName = 'builtin:alias' | 'builtin:asset' | 'builtin:asset-import-meta-url' | 'builtin:build-import-analysis' | 'builtin:dynamic-import-vars' | 'builtin:esm-external-require' | 'builtin:import-glob' | 'builtin:isolated-declaration' | 'builtin:json' | 'builtin:load-fallback' | 'builtin:manifest' | 'builtin:module-preload-polyfill' | 'builtin:react-refresh-wrapper' | 'builtin:reporter' | 'builtin:replace' | 'builtin:transform' | 'builtin:vite-css' | 'builtin:vite-css-post' | 'builtin:vite-html' | 'builtin:vite-resolve' | 'builtin:wasm-fallback' | 'builtin:wasm-helper' | 'builtin:web-worker-post';
+interface BindingClientHmrUpdate {
+  clientId: string;
+  update: BindingHmrUpdate;
+}
 interface BindingDynamicImportVarsPluginConfig {
   include?: Array<BindingStringOrRegex>;
   exclude?: Array<BindingStringOrRegex>;
@@ -1306,6 +1342,16 @@ interface BindingJsonPluginConfig {
   stringify?: BindingJsonPluginStringify;
 }
 type BindingJsonPluginStringify = boolean | string;
+interface BindingJsonSourcemap {
+  file?: string;
+  mappings?: string;
+  sourceRoot?: string;
+  sources?: Array<string | undefined | null>;
+  sourcesContent?: Array<string | undefined | null>;
+  names?: Array<string>;
+  debugId?: string;
+  x_google_ignoreList?: Array<number>;
+}
 interface BindingManifestPluginConfig {
   root: string;
   outPath: string;
@@ -1357,6 +1403,9 @@ interface BindingReporterPluginConfig {
   warnLargeChunks: boolean;
   reportCompressedSize: boolean;
 }
+interface BindingSourcemap {
+  inner: string | BindingJsonSourcemap;
+}
 interface BindingTransformHookExtraArgs {
   moduleType: string;
 }
@@ -1369,6 +1418,48 @@ interface BindingTransformPluginConfig {
   jsxInject?: string;
   transformOptions?: TransformOptions;
 }
+interface BindingViteCssPluginConfig {
+  isLib: boolean;
+  publicDir: string;
+  compileCSS: (url: string, importer: string, resolver: BindingUrlResolver) => Promise<{
+    code: string;
+    map?: BindingSourcemap;
+    modules?: Record<string, string>;
+    deps?: Set<string>;
+  }>;
+  resolveUrl: (url: string, importer?: string) => MaybePromise<string | undefined>;
+  assetInlineLimit: number | ((file: string, content: Buffer) => boolean | undefined);
+}
+interface BindingViteCssPostPluginConfig {
+  isLib: boolean;
+  isSsr: boolean;
+  isWorker: boolean;
+  isClient: boolean;
+  cssCodeSplit: boolean;
+  sourcemap: boolean;
+  assetsDir: string;
+  urlBase: string;
+  decodedBase: string;
+  libCssFilename?: string;
+  isLegacy?: () => boolean;
+  cssMinify?: (css: string) => Promise<string>;
+  renderBuiltUrl?: (filename: string, type: BindingRenderBuiltUrlConfig) => MaybePromise<VoidNullable<string | BindingRenderBuiltUrlRet>>;
+}
+interface BindingViteHtmlPluginConfig {
+  isLib: boolean;
+  isSsr: boolean;
+  urlBase: string;
+  publicDir: string;
+  decodedBase: string;
+  cssCodeSplit: boolean;
+  modulePreloadPolyfill: boolean;
+  assetInlineLimit: number | ((file: string, content: Buffer) => boolean | undefined);
+  renderBuiltUrl?: (filename: string, type: BindingRenderBuiltUrlConfig) => MaybePromise<VoidNullable<string | BindingRenderBuiltUrlRet>>;
+  resolveDependencies?: boolean | ((filename: string, dependencies: string[], context: {
+    hostId: string;
+    hostType: 'html' | 'js';
+  }) => Promise<string[]>);
+}
 interface BindingViteResolvePluginConfig {
   resolveOptions: BindingViteResolvePluginResolveOptions;
   environmentConsumer: string;
@@ -1417,4 +1508,4 @@ interface PreRenderedChunk {
   exports: Array<string>;
 }
 //#endregion
-export { BindingAssetPluginConfig, BindingBuildImportAnalysisPluginConfig, BindingBuiltinPluginName, BindingBundlerImpl, BindingClientHmrUpdate, BindingDynamicImportVarsPluginConfig, BindingEsmExternalRequirePluginConfig, BindingHookResolveIdExtraArgs, BindingImportGlobPluginConfig, BindingIsolatedDeclarationPluginConfig, BindingJsonPluginConfig, BindingManifestPluginConfig, BindingModulePreloadPolyfillPluginConfig, BindingReactRefreshWrapperPluginConfig, BindingRebuildStrategy, BindingRenderedChunk, BindingReplacePluginConfig, BindingReporterPluginConfig, BindingTransformHookExtraArgs, BindingTransformPluginConfig, BindingViteResolvePluginConfig, BindingWasmHelperPluginConfig, BindingWatcherEvent, IsolatedDeclarationsOptions, IsolatedDeclarationsResult, MinifyOptions, NapiResolveOptions, ParseResult, ParserOptions, PreRenderedChunk, ResolveResult, ResolverFactory, TransformOptions, TransformResult, isolatedDeclaration, moduleRunnerTransform, transform };
+export { IsolatedDeclarationsResult as A, TransformResult as B, BindingViteCssPluginConfig as C, BindingWasmHelperPluginConfig as D, BindingViteResolvePluginConfig as E, ParserOptions as F, moduleRunnerTransform as H, PreRenderedChunk as I, ResolveResult as L, MinifyOptions as M, NapiResolveOptions as N, BindingWatcherEvent as O, ParseResult as P, ResolverFactory as R, BindingUrlResolver as S, BindingViteHtmlPluginConfig as T, transform as U, isolatedDeclaration as V, BindingRenderedChunk as _, BindingClientHmrUpdate as a, BindingTransformHookExtraArgs as b, BindingHookResolveIdExtraArgs as c, BindingJsonPluginConfig as d, BindingMagicString as f, BindingRebuildStrategy as g, BindingReactRefreshWrapperPluginConfig as h, BindingBundlerImpl as i, JsxOptions as j, IsolatedDeclarationsOptions as k, BindingImportGlobPluginConfig as l, BindingModulePreloadPolyfillPluginConfig as m, BindingBuildImportAnalysisPluginConfig as n, BindingDynamicImportVarsPluginConfig as o, BindingManifestPluginConfig as p, BindingBuiltinPluginName as r, BindingEsmExternalRequirePluginConfig as s, BindingAssetPluginConfig as t, BindingIsolatedDeclarationPluginConfig as u, BindingReplacePluginConfig as v, BindingViteCssPostPluginConfig as w, BindingTransformPluginConfig as x, BindingReporterPluginConfig as y, TransformOptions as z };

package/dist/shared/{define-config-C9Rp3knL.d.mts → define-config-D9LwN_tW.d.mts}

@@ -1,4 +1,4 @@
-import { BindingBuiltinPluginName, BindingBundlerImpl, BindingHookResolveIdExtraArgs, BindingRenderedChunk, BindingTransformHookExtraArgs, BindingWatcherEvent, MinifyOptions as MinifyOptions$1, ParserOptions, PreRenderedChunk, TransformOptions } from "./binding-CtbNz6TD.mjs";
+import { F as ParserOptions, I as PreRenderedChunk, M as MinifyOptions$1, O as BindingWatcherEvent, _ as BindingRenderedChunk, b as BindingTransformHookExtraArgs, c as BindingHookResolveIdExtraArgs, f as BindingMagicString, i as BindingBundlerImpl, j as JsxOptions, r as BindingBuiltinPluginName, z as TransformOptions$1 } from "./binding-QBosa6N8.mjs";
 import { TopLevelFilterExpression } from "@rolldown/pluginutils";
 import { Program } from "@oxc-project/types";
 
@@ -159,6 +159,15 @@ interface GeneratedCodeOptions {
   * ```
   */
   preset?: GeneratedCodePreset;
+  /**
+  * Whether to add readable names to internal variables for profiling purposes.
+  *
+  * When enabled, generated code will use descriptive variable names that correspond
+  * to the original module names, making it easier to profile and debug the bundled code.
+  *
+  * @default true when minification is disabled, false when minification is enabled
+  */
+  profilerNames?: boolean;
 }
 type ModuleFormat = "es" | "cjs" | "esm" | "module" | "commonjs" | "iife" | "umd";
 type AddonFunction = (chunk: RenderedChunk) => string | Promise<string>;
@@ -253,6 +262,37 @@ interface OutputOptions {
   minify?: boolean | "dce-only" | MinifyOptions;
   name?: string;
   globals?: Record<string, string> | GlobalsFunction;
+  /**
+  * 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
+  *
+  * @example
+  * ```js
+  * {
+  *   paths: {
+  *     'd3': 'https://cdn.jsdelivr.net/npm/d3@7'
+  *   }
+  * }
+  * ```
+  *
+  * @example
+  * ```js
+  * {
+  *   paths: (id) => {
+  *     if (id.startsWith('lodash')) {
+  *       return `https://cdn.jsdelivr.net/npm/${id}`
+  *     }
+  *     return id
+  *   }
+  * }
+  * ```
+  */
+  paths?: Record<string, string> | ((id: string) => string);
   generatedCode?: Partial<GeneratedCodeOptions>;
   externalLiveBindings?: boolean;
   inlineDynamicImports?: boolean;
@@ -314,7 +354,7 @@ interface OutputOptions {
     * 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`
+    * - `preserveEntrySignatures: false | 'allow-extension'`
     * - `strictExecutionOrder: true`
     *
     * to avoid generating invalid chunks.
@@ -510,11 +550,26 @@ interface OutputOptions {
   topLevelVar?: boolean;
   /**
   * - Type: `boolean`
-  * - Default: `false`
+  * - Default: `true` for format `es` or if `output.minify` is `true` or object, `false` otherwise
   *
   * Whether to minify internal exports.
   */
   minifyInternalExports?: boolean;
+  /**
+  * - Type: `boolean`
+  * - Default: `false`
+  *
+  * Clean output directory before emitting output.
+  */
+  cleanDir?: boolean;
+  /** 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
+  */
+  keepNames?: boolean;
 }
 //#endregion
 //#region src/api/build.d.ts
@@ -612,6 +667,7 @@ interface NormalizedInputOptions {
 }
 //#endregion
 //#region src/options/normalized-output-options.d.ts
+type PathsFunction = (id: string) => string;
 type InternalModuleFormat = "es" | "cjs" | "iife" | "umd";
 interface NormalizedOutputOptions {
   name: string | undefined;
@@ -635,6 +691,7 @@ interface NormalizedOutputOptions {
   esModule: boolean | "if-default-prop";
   extend: boolean;
   globals: Record<string, string> | GlobalsFunction;
+  paths: Record<string, string> | PathsFunction | undefined;
   hashCharacters: "base64" | "base36" | "hex";
   sourcemapDebugIds: boolean;
   sourcemapIgnoreList: boolean | SourcemapIgnoreListOption | StringOrRegExp | undefined;
@@ -952,7 +1009,9 @@ interface ResolveIdExtraOptions {
 }
 type ResolveIdResult = string | NullValue | false | PartialResolvedId;
 type LoadResult = NullValue | string | SourceDescription;
-type TransformResult = NullValue | string | Partial<SourceDescription>;
+type TransformResult = NullValue | string | Omit<SourceDescription, "code"> & {
+  code?: string | BindingMagicString;
+};
 type RenderedChunkMeta = {
   chunks: Record<string, RenderedChunk>;
 };
@@ -970,6 +1029,7 @@ interface FunctionPluginHooks {
   [DEFINED_HOOK_NAMES.load]: (this: PluginContext, id: string) => MaybePromise<LoadResult>;
   [DEFINED_HOOK_NAMES.transform]: (this: TransformPluginContext, code: string, id: string, meta: BindingTransformHookExtraArgs & {
     moduleType: ModuleType;
+    magicString?: BindingMagicString;
   }) => TransformResult;
   [DEFINED_HOOK_NAMES.moduleParsed]: (this: PluginContext, moduleInfo: ModuleInfo) => void;
   [DEFINED_HOOK_NAMES.buildEnd]: (this: PluginContext, err?: Error) => void;
@@ -1003,15 +1063,15 @@ type SequentialPluginHooks = DefinedHookNames["augmentChunkHash" | "generateBund
 type AddonHooks = DefinedHookNames["banner" | "footer" | "intro" | "outro"];
 type OutputPluginHooks = DefinedHookNames["augmentChunkHash" | "generateBundle" | "outputOptions" | "renderChunk" | "renderError" | "renderStart" | "writeBundle"];
 type ParallelPluginHooks = Exclude<keyof FunctionPluginHooks | AddonHooks, FirstPluginHooks | SequentialPluginHooks>;
-type HookFilterExtension<K extends keyof FunctionPluginHooks> = K extends "transform" ? {
+type HookFilterExtension<K$1 extends keyof FunctionPluginHooks> = K$1 extends "transform" ? {
   filter?: TUnionWithTopLevelFilterExpressionArray<HookFilter>;
-} : K extends "load" ? {
+} : K$1 extends "load" ? {
   filter?: TUnionWithTopLevelFilterExpressionArray<Pick<HookFilter, "id">>;
-} : K extends "resolveId" ? {
+} : K$1 extends "resolveId" ? {
   filter?: TUnionWithTopLevelFilterExpressionArray<{
     id?: GeneralHookFilter<RegExp>;
   }>;
-} : K extends "renderChunk" ? {
+} : K$1 extends "renderChunk" ? {
   filter?: TUnionWithTopLevelFilterExpressionArray<Pick<HookFilter, "code">>;
 } : {};
 type PluginHooks = { [K in keyof FunctionPluginHooks]: ObjectHook<K extends AsyncPluginHooks ? MakeAsync<FunctionPluginHooks[K]> : FunctionPluginHooks[K], HookFilterExtension<K> & (K extends ParallelPluginHooks ? {
@@ -1108,9 +1168,114 @@ interface ChecksOptions {
   preferBuiltinFeature?: boolean;
 }
 //#endregion
+//#region src/options/transform-options.d.ts
+interface TransformOptions extends Omit<TransformOptions$1, "sourceType" | "lang" | "cwd" | "sourcemap" | "define" | "inject" | "jsx"> {
+  /**
+  * Replace global variables or [property accessors](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Property_accessors) with the provided values.
+  *
+  * # Examples
+  *
+  * - Replace the global variable `IS_PROD` with `true`
+  *
+  * ```js rolldown.config.js
+  * export default defineConfig({ transform: { define: { IS_PROD: 'true' } } })
+  * ```
+  *
+  * Result:
+  *
+  * ```js
+  * // Input
+  * if (IS_PROD) {
+  *   console.log('Production mode')
+  * }
+  *
+  * // After bundling
+  * if (true) {
+  *   console.log('Production mode')
+  * }
+  * ```
+  *
+  * - Replace the property accessor `process.env.NODE_ENV` with `'production'`
+  *
+  * ```js rolldown.config.js
+  * export default defineConfig({ transform: { define: { 'process.env.NODE_ENV': "'production'" } } })
+  * ```
+  *
+  * Result:
+  *
+  * ```js
+  * // Input
+  * if (process.env.NODE_ENV === 'production') {
+  *  console.log('Production mode')
+  * }
+  *
+  * // After bundling
+  * if ('production' === 'production') {
+  * console.log('Production mode')
+  * }
+  *
+  * ```
+  */
+  define?: Record<string, string>;
+  /**
+  * Inject import statements on demand.
+  *
+  * The API is aligned with `@rollup/plugin-inject`.
+  *
+  * ## Supported patterns
+  * ```js
+  * {
+  *   // import { Promise } from 'es6-promise'
+  *   Promise: ['es6-promise', 'Promise'],
+  *
+  *   // import { Promise as P } from 'es6-promise'
+  *   P: ['es6-promise', 'Promise'],
+  *
+  *   // import $ from 'jquery'
+  *   $: 'jquery',
+  *
+  *   // import * as fs from 'node:fs'
+  *   fs: ['node:fs', '*'],
+  *
+  *   // Inject shims for property access pattern
+  *   'Object.assign': path.resolve( 'src/helpers/object-assign.js' ),
+  * }
+  * ```
+  */
+  inject?: Record<string, string | [string, string]>;
+  /**
+  * Remove labeled statements with these label names.
+  *
+  * Labeled statements are JavaScript statements prefixed with a label identifier.
+  * This option allows you to strip specific labeled statements from the output,
+  * which is useful for removing debug-only code in production builds.
+  *
+  * ## Example
+  *
+  * ```js rolldown.config.js
+  * export default defineConfig({ transform: { dropLabels: ['DEBUG', 'DEV'] } })
+  * ```
+  *
+  * Result:
+  *
+  * ```js
+  * // Input
+  * DEBUG: console.log('Debug info');
+  * DEV: {
+  *   console.log('Development mode');
+  * }
+  * console.log('Production code');
+  *
+  * // After bundling
+  * console.log('Production code');
+  * ```
+  */
+  dropLabels?: string[];
+  jsx?: false | "react" | "react-jsx" | "preserve" | JsxOptions;
+}
+//#endregion
 //#region src/options/input-options.d.ts
 type InputOption = string | string[] | Record<string, string>;
-type OxcTransformOption = Omit<TransformOptions, "sourceType" | "lang" | "cwd" | "sourcemap" | "define" | "inject">;
 type ExternalOption = StringOrRegExp | StringOrRegExp[] | ((id: string, parentId: string | undefined, isResolved: boolean) => NullValue<boolean>);
 type ModuleTypes = Record<string, "js" | "jsx" | "ts" | "tsx" | "json" | "text" | "base64" | "dataurl" | "binary" | "empty" | "css" | "asset">;
 interface WatcherOptions {
@@ -1178,13 +1343,6 @@ type OptimizationOptions = {
 };
 type AttachDebugOptions = "none" | "simple" | "full";
 type ChunkModulesOrder = "exec-order" | "module-id";
-interface RollupJsxOptions {
-  mode?: "classic" | "automatic" | "preserve";
-  factory?: string;
-  fragment?: string;
-  importSource?: string;
-  jsxImportSource?: string;
-}
 interface InputOptions {
   input?: InputOption;
   plugins?: RolldownPluginOption;
@@ -1238,6 +1396,17 @@ interface InputOptions {
   onwarn?: (warning: RollupLog, defaultHandler: (warning: RollupLogWithString | (() => RollupLogWithString)) => void) => void;
   moduleTypes?: ModuleTypes;
   experimental?: {
+    /**
+    * Lets modules be executed in the order they are declared.
+    *
+    * - Type: `boolean`
+    * - Default: `false`
+    *
+    * This is done by injecting runtime helpers to ensure that modules are executed in the order they are imported. External modules won't be affected.
+    *
+    * > [!WARNING]
+    * > Enabling this option may negatively increase bundle size. It is recommended to use this option only when absolutely necessary.
+    */
     strictExecutionOrder?: boolean;
     disableLiveBindings?: boolean;
     viteMode?: boolean;
@@ -1326,93 +1495,73 @@ interface InputOptions {
     */
     incrementalBuild?: boolean;
     transformHiresSourcemap?: boolean | "boundary";
+    /**
+    * Use native Rust implementation of MagicString for source map generation.
+    *
+    * - Type: `boolean`
+    * - Default: `false`
+    *
+    * [MagicString](https://github.com/rich-harris/magic-string) is a JavaScript library commonly used by bundlers
+    * for string manipulation and source map generation. When enabled, rolldown will use a native Rust
+    * implementation of MagicString instead of the JavaScript version, providing significantly better performance
+    * during source map generation and code transformation.
+    *
+    * ## Benefits
+    *
+    * - **Improved Performance**: The native Rust implementation is typically faster than the JavaScript version,
+    *   especially for large codebases with extensive source maps.
+    * - **Background Processing**: Source map generation is performed asynchronously in a background thread,
+    *   allowing the main bundling process to continue without blocking. This parallel processing can significantly
+    *   reduce overall build times when working with JavaScript transform hooks.
+    * - **Better Integration**: Seamless integration with rolldown's native Rust architecture.
+    *
+    * ## Example
+    *
+    * ```js
+    * export default {
+    *   experimental: {
+    *     nativeMagicString: true
+    *   },
+    *   output: {
+    *     sourcemap: true
+    *   }
+    * }
+    * ```
+    *
+    * > [!NOTE]
+    * > This is an experimental feature. While it aims to provide identical behavior to the JavaScript
+    * > implementation, there may be edge cases. Please report any discrepancies you encounter.
+    * > For a complete working example, see [examples/native-magic-string](https://github.com/rolldown/rolldown/tree/main/examples/native-magic-string)
+    */
+    nativeMagicString?: boolean;
   };
   /**
   * Replace global variables or [property accessors](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Property_accessors) with the provided values.
   *
-  * # Examples
-  *
-  * - Replace the global variable `IS_PROD` with `true`
-  *
-  * ```js rolldown.config.js
-  * export default defineConfig({ define: { IS_PROD: 'true' // or JSON.stringify(true) } })
-  * ```
-  *
-  * Result:
-  *
-  * ```js
-  * // Input
-  * if (IS_PROD) {
-  *   console.log('Production mode')
-  * }
-  *
-  * // After bundling
-  * if (true) {
-  *   console.log('Production mode')
-  * }
-  * ```
-  *
-  * - Replace the property accessor `process.env.NODE_ENV` with `'production'`
-  *
-  * ```js rolldown.config.js
-  * export default defineConfig({ define: { 'process.env.NODE_ENV': "'production'" } })
-  * ```
-  *
-  * Result:
+  * @deprecated Use `transform.define` instead. This top-level option will be removed in a future release.
   *
-  * ```js
-  * // Input
-  * if (process.env.NODE_ENV === 'production') {
-  *  console.log('Production mode')
-  * }
-  *
-  * // After bundling
-  * if ('production' === 'production') {
-  * console.log('Production mode')
-  * }
-  *
-  * ```
+  * See `transform.define` for detailed documentation and examples.
   */
   define?: Record<string, string>;
   /**
   * Inject import statements on demand.
   *
-  * ## Supported patterns
-  * ```js
-  * {
-  *   // import { Promise } from 'es6-promise'
-  *   Promise: ['es6-promise', 'Promise'],
-  *
-  *   // import { Promise as P } from 'es6-promise'
-  *   P: ['es6-promise', 'Promise'],
-  *
-  *   // import $ from 'jquery'
-  *   $: 'jquery',
+  * @deprecated Use `transform.inject` instead. This top-level option will be removed in a future release.
   *
-  *   // import * as fs from 'node:fs'
-  *   fs: ['node:fs', '*'],
-  *
-  *   // Inject shims for property access pattern
-  *   'Object.assign': path.resolve( 'src/helpers/object-assign.js' ),
-  * }
-  * ```
+  * See `transform.inject` for detailed documentation and examples.
   */
   inject?: Record<string, string | [string, string]>;
-  profilerNames?: boolean;
   /**
-  * @deprecated Use `transform.jsx` instead.
+  * Whether to add readable names to internal variables for profiling purposes.
   *
-  * This top-level `jsx` option will be removed in a future release.
-  * It is only kept for backward compatibility and will be mapped internally to `transform.jsx`.
+  * When enabled, generated code will use descriptive variable names that correspond
+  * to the original module names, making it easier to profile and debug the bundled code.
   *
-  * - `false` disables the JSX parser, resulting in a syntax error if JSX syntax is used.
-  * - `"preserve"` disables the JSX transformer, preserving the original JSX syntax in the output.
-  * - `"react"` enables the `classic` JSX transformer.
-  * - `"react-jsx"` enables the `automatic` JSX transformer.
+  * @default true when minification is disabled, false when minification is enabled
   *
-  * @default runtime = "automatic"
+  * @deprecated Use `output.generatedCode.profilerNames` instead. This top-level option will be removed in a future release.
   */
-  jsx?: false | "react" | "react-jsx" | "preserve" | RollupJsxOptions;
+  profilerNames?: boolean;
   /**
   * Configure how the code is transformed. This process happens after the `transform` hook.
   *
@@ -1430,9 +1579,23 @@ interface InputOptions {
   *
   * For latest decorators proposal, rolldown is able to bundle them but doesn't support transpiling them yet.
   */
-  transform?: OxcTransformOption;
+  transform?: TransformOptions;
   watch?: WatcherOptions | false;
+  /**
+  * Remove labeled statements with these label names.
+  *
+  * @deprecated Use `transform.dropLabels` instead. This top-level option will be removed in a future release.
+  *
+  * See `transform.dropLabels` for detailed documentation and examples.
+  */
   dropLabels?: string[];
+  /**
+  * Keep function and class names after bundling.
+  *
+  * @deprecated Use `output.keepNames` instead. This top-level option will be removed in a future release.
+  *
+  * See `output.keepNames` for detailed documentation.
+  */
   keepNames?: boolean;
   checks?: ChecksOptions;
   makeAbsoluteExternalsRelative?: MakeAbsoluteExternalsRelative;
@@ -1472,4 +1635,4 @@ declare function defineConfig(config: RolldownOptions[]): RolldownOptions[];
 declare function defineConfig(config: RolldownOptionsFunction): RolldownOptionsFunction;
 declare function defineConfig(config: ConfigExport): ConfigExport;
 //#endregion
-export { type AddonFunction, type AsyncPluginHooks, type BufferEncoding, type BuildOptions, BuiltinPlugin, type ChunkFileNamesFunction, type ChunkingContext, type ConfigExport, type CustomPluginOptions, type DefineParallelPluginResult, type EmittedAsset, type EmittedFile, type ExistingRawSourceMap, type ExternalOption, type FunctionPluginHooks, type GeneralHookFilter, type GeneratedCodeOptions, type GeneratedCodePreset, type GetModuleInfo, type GlobalsFunction, type HookFilter, type HookFilterExtension, type ImportKind, type InputOption, type InputOptions, type InternalModuleFormat, type LoadResult, type LogLevel, type LogLevelOption, type LogOrStringHandler, type LoggingFunction, MaybePromise, type MinifyOptions, type MinimalPluginContext, type ModuleFormat, type ModuleInfo, type ModuleOptions, type ModuleType, type ModuleTypeFilter, type ModuleTypes, type NormalizedInputOptions, type NormalizedOutputOptions, type ObjectHook, type OptimizationOptions, type OutputAsset, type OutputBundle, type OutputChunk, type OutputOptions, type ParallelPluginHooks, type PartialNull, type PartialResolvedId, type Plugin, type PluginContext, type PluginContextMeta, type PreRenderedAsset, type RenderedChunk, type RenderedModule, type ResolveIdExtraOptions, type ResolveIdResult, type ResolvedId, type RolldownBuild, type RolldownDirectoryEntry, type RolldownFileStats, type RolldownFsModule, type RolldownOptions, type RolldownOptionsFunction, type RolldownOutput, type RolldownPlugin, type RolldownPluginOption, type RolldownWatcher, type RolldownWatcherEvent, type RollupError, type RollupLog, type RollupLogWithString, type SourceDescription, type SourceMap, type SourceMapInput, type SourcemapIgnoreListOption, StringOrRegExp, type TransformPluginContext, type TransformResult, type TreeshakingOptions, VERSION, type WarningHandlerWithDefault, type WatchOptions, type WatcherOptions, build, defineConfig, defineParallelPlugin, rolldown, watch, withFilter };
+export { InternalModuleFormat as $, BuiltinPlugin as A, SourceMap as At, GetModuleInfo as B, ResolveIdResult as C, PartialNull as Ct, SourceDescription as D, RenderedChunk as Dt, RolldownPluginOption as E, OutputChunk as Et, OutputBundle as F, LogOrStringHandler as Ft, PluginContextMeta as G, DefineParallelPluginResult as H, TreeshakingOptions as I, RollupError as It, ModuleTypeFilter as J, GeneralHookFilter as K, TransformPluginContext as L, RollupLog as Lt, ExistingRawSourceMap as M, SourcemapIgnoreListOption as Mt, SourceMapInput as N, LogLevel as Nt, TransformResult as O, RenderedModule as Ot, RolldownOptionsFunction as P, LogLevelOption as Pt, RolldownFsModule as Q, EmittedAsset as R, RollupLogWithString as Rt, ResolveIdExtraOptions as S, MaybePromise as St, RolldownPlugin as T, OutputAsset as Tt, defineParallelPlugin as U, PluginContext as V, MinimalPluginContext as W, RolldownDirectoryEntry as X, BufferEncoding as Y, RolldownFileStats as Z, ModuleType as _, GlobalsFunction as _t, InputOption as a, RolldownWatcher as at, PartialResolvedId as b, OutputOptions as bt, OptimizationOptions as c, rolldown as ct, CustomPluginOptions as d, build as dt, NormalizedOutputOptions as et, FunctionPluginHooks as f, AddonFunction as ft, ModuleOptions as g, GeneratedCodePreset as gt, LoadResult as h, GeneratedCodeOptions as ht, ExternalOption as i, watch as it, VERSION as j, ModuleInfo as jt, withFilter as k, RolldownOutput as kt, WatcherOptions as l, RolldownBuild as lt, ImportKind as m, ChunkingContext as mt, ConfigExport as n, LoggingFunction as nt, InputOptions as o, RolldownWatcherEvent as ot, HookFilterExtension as p, ChunkFileNamesFunction as pt, HookFilter as q, RolldownOptions as r, WarningHandlerWithDefault as rt, ModuleTypes as s, WatchOptions as st, defineConfig as t, NormalizedInputOptions as tt, AsyncPluginHooks as u, BuildOptions as ut, ObjectHook as v, MinifyOptions as vt, ResolvedId as w, StringOrRegExp as wt, Plugin as x, PreRenderedAsset as xt, ParallelPluginHooks as y, ModuleFormat as yt, EmittedFile as z };