@vercube/core 0.0.42 → 0.0.45

package/dist/index.d.mts

@@ -21,7 +21,7 @@ declare class BasePlugin<T = unknown> {
   use(app: App, options?: T): void | Promise<void>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/rolldown@1.0.0-rc.2/node_modules/rolldown/dist/shared/logging-CE90D8JR.d.mts
+//#region ../../node_modules/.pnpm/rolldown@1.0.0-rc.9/node_modules/rolldown/dist/shared/logging-C6h4g8dA.d.mts
 //#region src/log/logging.d.ts
 /** @inline */
 type LogLevel = "info" | "debug" | "warn";
@@ -71,7 +71,7 @@ interface RolldownError extends RolldownLog {
 }
 type LogOrStringHandler = (level: LogLevelWithError, log: RolldownLogWithString) => void; //#endregion
 //#endregion
-//#region ../../node_modules/.pnpm/@oxc-project+types@0.111.0/node_modules/@oxc-project/types/types.d.ts
+//#region ../../node_modules/.pnpm/@oxc-project+types@0.115.0/node_modules/@oxc-project/types/types.d.ts
 // Auto-generated code, DO NOT EDIT DIRECTLY!
 // To edit this generated file you have to edit `tasks/ast_tools/src/generators/typescript.rs`.
 interface Program extends Span {
@@ -1370,7 +1370,7 @@ interface Span {
 type ModuleKind = "script" | "module" | "commonjs";
 type Node = Program | IdentifierName | IdentifierReference | BindingIdentifier | LabelIdentifier | ThisExpression | ArrayExpression | ObjectExpression | ObjectProperty | TemplateLiteral | TaggedTemplateExpression | TemplateElement | ComputedMemberExpression | StaticMemberExpression | PrivateFieldExpression | CallExpression | NewExpression | MetaProperty | SpreadElement | UpdateExpression | UnaryExpression | BinaryExpression | PrivateInExpression | LogicalExpression | ConditionalExpression | AssignmentExpression | ArrayAssignmentTarget | ObjectAssignmentTarget | AssignmentTargetRest | AssignmentTargetWithDefault | AssignmentTargetPropertyIdentifier | AssignmentTargetPropertyProperty | SequenceExpression | Super | AwaitExpression | ChainExpression | ParenthesizedExpression | Directive | Hashbang | BlockStatement | VariableDeclaration | VariableDeclarator | EmptyStatement | ExpressionStatement | IfStatement | DoWhileStatement | WhileStatement | ForStatement | ForInStatement | ForOfStatement | ContinueStatement | BreakStatement | ReturnStatement | WithStatement | SwitchStatement | SwitchCase | LabeledStatement | ThrowStatement | TryStatement | CatchClause | DebuggerStatement | AssignmentPattern | ObjectPattern | BindingProperty | ArrayPattern | BindingRestElement | Function$1 | FunctionBody | ArrowFunctionExpression | YieldExpression | Class | ClassBody | MethodDefinition | PropertyDefinition | PrivateIdentifier | StaticBlock | AccessorProperty | ImportExpression | ImportDeclaration | ImportSpecifier | ImportDefaultSpecifier | ImportNamespaceSpecifier | ImportAttribute | ExportNamedDeclaration | ExportDefaultDeclaration | ExportAllDeclaration | ExportSpecifier | V8IntrinsicExpression | BooleanLiteral | NullLiteral | NumericLiteral | StringLiteral | BigIntLiteral | RegExpLiteral | JSXElement | JSXOpeningElement | JSXClosingElement | JSXFragment | JSXOpeningFragment | JSXClosingFragment | JSXNamespacedName | JSXMemberExpression | JSXExpressionContainer | JSXEmptyExpression | JSXAttribute | JSXSpreadAttribute | JSXIdentifier | JSXSpreadChild | JSXText | TSThisParameter | TSEnumDeclaration | TSEnumBody | TSEnumMember | TSTypeAnnotation | TSLiteralType | TSConditionalType | TSUnionType | TSIntersectionType | TSParenthesizedType | TSTypeOperator | TSArrayType | TSIndexedAccessType | TSTupleType | TSNamedTupleMember | TSOptionalType | TSRestType | TSAnyKeyword | TSStringKeyword | TSBooleanKeyword | TSNumberKeyword | TSNeverKeyword | TSIntrinsicKeyword | TSUnknownKeyword | TSNullKeyword | TSUndefinedKeyword | TSVoidKeyword | TSSymbolKeyword | TSThisType | TSObjectKeyword | TSBigIntKeyword | TSTypeReference | TSQualifiedName | TSTypeParameterInstantiation | TSTypeParameter | TSTypeParameterDeclaration | TSTypeAliasDeclaration | TSClassImplements | TSInterfaceDeclaration | TSInterfaceBody | TSPropertySignature | TSIndexSignature | TSCallSignatureDeclaration | TSMethodSignature | TSConstructSignatureDeclaration | TSIndexSignatureName | TSInterfaceHeritage | TSTypePredicate | TSModuleDeclaration | TSGlobalDeclaration | TSModuleBlock | TSTypeLiteral | TSInferType | TSTypeQuery | TSImportType | TSImportTypeQualifiedName | TSFunctionType | TSConstructorType | TSMappedType | TSTemplateLiteralType | TSAsExpression | TSSatisfiesExpression | TSTypeAssertion | TSImportEqualsDeclaration | TSExternalModuleReference | TSNonNullExpression | Decorator | TSExportAssignment | TSNamespaceExportDeclaration | TSInstantiationExpression | JSDocNullableType | JSDocNonNullableType | JSDocUnknownType | ParamPattern;
 //#endregion
-//#region ../../node_modules/.pnpm/rolldown@1.0.0-rc.2/node_modules/rolldown/dist/shared/binding-Bo6UcGYl.d.mts
+//#region ../../node_modules/.pnpm/rolldown@1.0.0-rc.9/node_modules/rolldown/dist/shared/binding-BohGL_65.d.mts
 interface CodegenOptions {
   /**
    * Remove whitespace.
@@ -1465,7 +1465,7 @@ interface MangleOptions {
   /**
    * Pass `true` to mangle names declared in the top level scope.
    *
-   * @default false
+   * @default true for modules and commonjs, otherwise false
    */
   toplevel?: boolean;
   /**
@@ -1491,11 +1491,6 @@ interface MangleOptionsKeepNames {
    */
   class: boolean;
 }
-/**
- * Minify asynchronously.
- *
- * Note: This function can be slower than `minifySync` due to the overhead of spawning a thread.
- */
 interface MinifyOptions$1 {
   /** Use when minifying an ES module. */
   module?: boolean;
@@ -1701,7 +1696,7 @@ interface IsolatedDeclarationsOptions {
 /**
  * Configure how TSX and JSX are transformed.
  *
- * @see {@link https://babeljs.io/docs/babel-plugin-transform-react-jsx#options}
+ * @see {@link https://oxc.rs/docs/guide/usage/transformer/jsx}
  */
 interface JsxOptions {
   /**
@@ -1717,8 +1712,6 @@ interface JsxOptions {
    * Emit development-specific information, such as `__source` and `__self`.
    *
    * @default false
-   *
-   * @see {@link https://babeljs.io/docs/babel-plugin-transform-react-jsx-development}
    */
   development?: boolean;
   /**
@@ -1732,11 +1725,7 @@ interface JsxOptions {
    */
   throwIfNamespace?: boolean;
   /**
-   * Enables `@babel/plugin-transform-react-pure-annotations`.
-   *
-   * It will mark JSX elements and top-level React method calls as pure for tree shaking.
-   *
-   * @see {@link https://babeljs.io/docs/en/babel-plugin-transform-react-pure-annotations}
+   * Mark JSX elements and top-level React method calls as pure for tree shaking.
    *
    * @default true
    */
@@ -1812,7 +1801,7 @@ interface ReactRefreshOptions {
 /**
  * Configure how styled-components are transformed.
  *
- * @see {@link https://styled-components.com/docs/tooling#babel-plugin}
+ * @see {@link https://oxc.rs/docs/guide/usage/transformer/plugins#styled-components}
  */
 interface StyledComponentsOptions {
   /**
@@ -1887,20 +1876,6 @@ interface StyledComponentsOptions {
    */
   topLevelImportPaths?: Array<string>;
 }
-/**
- * Transpile a JavaScript or TypeScript into a target ECMAScript version, asynchronously.
- *
- * Note: This function can be slower than `transform` due to the overhead of spawning a thread.
- *
- * @param filename The name of the file being transformed. If this is a
- * relative path, consider setting the {@link TransformOptions#cwd} option.
- * @param sourceText the source code itself
- * @param options The options for the transformation. See {@link
- * TransformOptions} for more information.
- *
- * @returns a promise that resolves to an object containing the transformed code,
- * source maps, and any errors that occurred during parsing or transformation.
- */
 /**
  * Options for transforming a JavaScript or TypeScript file.
  *
@@ -1928,9 +1903,15 @@ interface TransformOptions$1 {
   sourcemap?: boolean;
   /** Set assumptions in order to produce smaller output. */
   assumptions?: CompilerAssumptions;
-  /** Configure how TypeScript is transformed. */
+  /**
+   * Configure how TypeScript is transformed.
+   * @see {@link https://oxc.rs/docs/guide/usage/transformer/typescript}
+   */
   typescript?: TypeScriptOptions;
-  /** Configure how TSX and JSX are transformed. */
+  /**
+   * Configure how TSX and JSX are transformed.
+   * @see {@link https://oxc.rs/docs/guide/usage/transformer/jsx}
+   */
   jsx?: 'preserve' | JsxOptions;
   /**
    * Sets the target environment for the generated JavaScript.
@@ -1944,18 +1925,27 @@ interface TransformOptions$1 {
    *
    * @default `esnext` (No transformation)
    *
-   * @see [esbuild#target](https://esbuild.github.io/api/#target)
+   * @see {@link https://oxc.rs/docs/guide/usage/transformer/lowering#target}
    */
   target?: string | Array<string>;
   /** Behaviour for runtime helpers. */
   helpers?: Helpers;
-  /** Define Plugin */
+  /**
+   * Define Plugin
+   * @see {@link https://oxc.rs/docs/guide/usage/transformer/global-variable-replacement#define}
+   */
   define?: Record<string, string>;
-  /** Inject Plugin */
+  /**
+   * Inject Plugin
+   * @see {@link https://oxc.rs/docs/guide/usage/transformer/global-variable-replacement#inject}
+   */
   inject?: Record<string, string | [string, string]>;
   /** Decorator plugin */
   decorator?: DecoratorOptions;
-  /** Third-party plugins to use. */
+  /**
+   * Third-party plugins to use.
+   * @see {@link https://oxc.rs/docs/guide/usage/transformer/plugins}
+   */
   plugins?: PluginsOptions;
 }
 interface TypeScriptOptions {
@@ -2047,9 +2037,12 @@ declare class BindingDecodedMap {
    */
   get mappings(): Array<Array<Array<number>>>;
 }
-declare class BindingMagicString {
+declare class BindingMagicString$1 {
   constructor(source: string, options?: BindingMagicStringOptions | undefined | null);
+  get original(): string;
   get filename(): string | null;
+  get offset(): number;
+  set offset(offset: number);
   replace(from: string, to: string): this;
   replaceAll(from: string, to: string): this;
   prepend(content: string): this;
@@ -2087,13 +2080,13 @@ declare class BindingMagicString {
    */
   insert(index: number, content: string): void;
   /** Returns a clone of the MagicString instance. */
-  clone(): BindingMagicString;
+  clone(): BindingMagicString$1;
   /** Returns the last character of the generated string, or an empty string if empty. */
   lastChar(): string;
   /** Returns the content after the last newline in the generated string. */
   lastLine(): string;
   /** Returns a clone with content outside the specified range removed. */
-  snip(start: number, end: number): BindingMagicString;
+  snip(start: number, end: number): BindingMagicString$1;
   /**
    * Resets the portion of the string from `start` to `end` to its original content.
    * This undoes any modifications made to that range.
@@ -2152,10 +2145,10 @@ declare class BindingSourceMap {
   toUrl(): string;
 }
 /**
- * Minimal wrapper around the core `Bundler` for watcher events.
- * This is returned from watcher event data to allow access to the bundler instance.
+ * Minimal wrapper around a `BundleHandle` for watcher events.
+ * This is returned from watcher event data to allow calling `result.close()`.
  */
-type BindingBuiltinPluginName = 'builtin:esm-external-require' | 'builtin:isolated-declaration' | 'builtin:replace' | 'builtin:vite-alias' | 'builtin:vite-build-import-analysis' | 'builtin:vite-dynamic-import-vars' | 'builtin:vite-import-glob' | 'builtin:vite-json' | 'builtin:vite-load-fallback' | 'builtin:vite-manifest' | 'builtin:vite-module-preload-polyfill' | 'builtin:vite-react-refresh-wrapper' | 'builtin:vite-reporter' | 'builtin:vite-resolve' | 'builtin:vite-transform' | 'builtin:vite-wasm-fallback' | 'builtin:vite-wasm-helper' | 'builtin:vite-web-worker-post';
+type BindingBuiltinPluginName = 'builtin:bundle-analyzer' | 'builtin:esm-external-require' | 'builtin:isolated-declaration' | 'builtin:replace' | 'builtin:vite-alias' | 'builtin:vite-build-import-analysis' | 'builtin:vite-dynamic-import-vars' | 'builtin:vite-import-glob' | 'builtin:vite-json' | 'builtin:vite-load-fallback' | 'builtin:vite-manifest' | 'builtin:vite-module-preload-polyfill' | 'builtin:vite-react-refresh-wrapper' | 'builtin:vite-reporter' | 'builtin:vite-resolve' | 'builtin:vite-transform' | 'builtin:vite-wasm-fallback' | 'builtin:vite-web-worker-post';
 interface BindingHookResolveIdExtraArgs {
   custom?: number;
   isEntry: boolean;
@@ -2172,6 +2165,7 @@ interface BindingHookResolveIdExtraArgs {
 }
 interface BindingMagicStringOptions {
   filename?: string;
+  offset?: number;
 }
 interface BindingModules {
   values: Array<BindingRenderedModule>;
@@ -2217,6 +2211,7 @@ interface ExternalMemoryStatus {
   freed: boolean;
   reason?: string;
 }
+/** Error emitted from native side, it only contains kind and message, no stack trace. */
 interface PreRenderedChunk {
   /** The name of this chunk, which is used in naming patterns. */
   name: string;
@@ -2231,11 +2226,12 @@ interface PreRenderedChunk {
   /** Exported variable names from this chunk. */
   exports: Array<string>;
 }
+/** @hidden This is only expected to be used by Vite */
 interface ViteImportGlobMeta {
   isSubImportsPattern?: boolean;
 } //#endregion
 //#endregion
-//#region ../../node_modules/.pnpm/@rolldown+pluginutils@1.0.0-rc.2/node_modules/@rolldown/pluginutils/dist/filter/composable-filters.d.ts
+//#region ../../node_modules/.pnpm/@rolldown+pluginutils@1.0.0-rc.9/node_modules/@rolldown/pluginutils/dist/filter/composable-filters.d.ts
 type StringOrRegExp$1 = string | RegExp;
 type PluginModuleType = 'js' | 'jsx' | 'ts' | 'tsx' | 'json' | 'text' | 'base64' | 'dataurl' | 'binary' | 'empty' | (string & {});
 type FilterExpression = And | Or | Not | Id | ImporterId | ModuleType$1 | Code | Query;
@@ -2297,7 +2293,7 @@ declare class Exclude$1 {
   constructor(expr: FilterExpression);
 }
 //#endregion
-//#region ../../node_modules/.pnpm/rolldown@1.0.0-rc.2/node_modules/rolldown/dist/shared/define-config-Bqat13pE.d.mts
+//#region ../../node_modules/.pnpm/rolldown@1.0.0-rc.9/node_modules/rolldown/dist/shared/define-config-cG45vHwf.d.mts
 //#region src/types/misc.d.ts
 /** @inline */
 type SourcemapPathTransformOption = (relativeSourcePath: string, sourcemapPath: string) => string;
@@ -2344,6 +2340,16 @@ interface ModuleInfo extends ModuleOptions {
   * Whether this module is a user- or plugin-defined entry point.
   */
   isEntry: boolean;
+  /**
+  * The detected format of the module, based on both its syntax and module definition
+  * metadata (such as `package.json` `type` and file extensions like `.mjs`/`.cjs`/`.mts`/`.cts`).
+  * - "esm" for ES modules (has `import`/`export` statements or is defined as ESM by module metadata)
+  * - "cjs" for CommonJS modules (uses `module.exports`, `exports`, top-level `return`, or is defined as CommonJS by module metadata)
+  * - "unknown" when the format could not be determined from either syntax or module definition metadata
+  *
+  * @experimental
+  */
+  inputFormat: "es" | "cjs" | "unknown";
 } //#endregion
 //#region src/utils/asset-source.d.ts
 /** @inline */
@@ -2594,6 +2600,20 @@ type CodeSplittingNameFunction = (moduleId: string, ctx: ChunkingContext) => str
 /** @inline */
 type CodeSplittingTestFunction = (id: string) => boolean | undefined | void;
 type MinifyOptions = Omit<MinifyOptions$1, "module" | "sourcemap">;
+interface CommentsOptions {
+  /**
+  * Comments that contain `@license`, `@preserve` or start with `//!` or `/*!`
+  */
+  legal?: boolean;
+  /**
+  * Comments that contain `@__PURE__`, `@__NO_SIDE_EFFECTS__` or `@vite-ignore`
+  */
+  annotation?: boolean;
+  /**
+  * JSDoc comments
+  */
+  jsdoc?: boolean;
+}
 /** @inline */
 interface ChunkingContext {
   getModuleInfo(moduleId: string): ModuleInfo | null;
@@ -2641,7 +2661,7 @@ interface OutputOptions {
   * - `'iife'` stands for [Immediately Invoked Function Expression](https://developer.mozilla.org/en-US/docs/Glossary/IIFE).
   * - `'umd'` stands for [Universal Module Definition](https://github.com/umdjs/umd).
   *
-  * @default 'esm'
+  * @default 'es'
   *
   *
   */
@@ -2722,7 +2742,7 @@ interface OutputOptions {
   */
   sourcemapPathTransform?: SourcemapPathTransformOption;
   /**
-  * A string to prepend to the bundle before `renderChunk` hook.
+  * A string to prepend to the bundle before {@linkcode Plugin.renderChunk | renderChunk} hook.
   *
   * See {@linkcode intro | output.intro}, {@linkcode postBanner | output.postBanner} as well.
   *
@@ -2730,7 +2750,7 @@ interface OutputOptions {
   */
   banner?: string | AddonFunction;
   /**
-  * A string to append to the bundle before `renderChunk` hook.
+  * A string to append to the bundle before {@linkcode Plugin.renderChunk | renderChunk} hook.
   *
   * See {@linkcode outro | output.outro}, {@linkcode postFooter | output.postFooter} as well.
   *
@@ -2738,7 +2758,7 @@ interface OutputOptions {
   */
   footer?: string | AddonFunction;
   /**
-  * A string to prepend to the bundle after `renderChunk` hook and minification.
+  * A string to prepend to the bundle after {@linkcode Plugin.renderChunk | renderChunk} hook and minification.
   *
   * See {@linkcode banner | output.banner}, {@linkcode intro | output.intro} as well.
   *
@@ -2746,7 +2766,7 @@ interface OutputOptions {
   */
   postBanner?: string | AddonFunction;
   /**
-  * A string to append to the bundle after `renderChunk` hook and minification.
+  * A string to append to the bundle after {@linkcode Plugin.renderChunk | renderChunk} hook and minification.
   *
   * See {@linkcode footer | output.footer}, {@linkcode outro | output.outro} as well.
   *
@@ -2754,7 +2774,7 @@ interface OutputOptions {
   */
   postFooter?: string | AddonFunction;
   /**
-  * A string to prepend inside any format-specific wrapper.
+  * A string to prepend inside any {@link OutputOptions.format | format}-specific wrapper.
   *
   * See {@linkcode banner | output.banner}, {@linkcode postBanner | output.postBanner} as well.
   *
@@ -2762,7 +2782,7 @@ interface OutputOptions {
   */
   intro?: string | AddonFunction;
   /**
-  * A string to append inside any format-specific wrapper.
+  * A string to append inside any {@link OutputOptions.format | format}-specific wrapper.
   *
   * See {@linkcode footer | output.footer}, {@linkcode postFooter | output.postFooter} as well.
   *
@@ -2770,7 +2790,7 @@ interface OutputOptions {
   */
   outro?: string | AddonFunction;
   /**
-  * Whether to extend the global variable defined by the {@linkcode OutputOptions.name | name} option in `umd` or `iife` formats.
+  * Whether to extend the global variable defined by the {@linkcode OutputOptions.name | name} option in `umd` or `iife` {@link OutputOptions.format | formats}.
   *
   * When `true`, the global variable will be defined as `global.name = global.name || {}`.
   * When `false`, the global defined by name will be overwritten like `global.name = {}`.
@@ -2779,12 +2799,12 @@ interface OutputOptions {
   */
   extend?: boolean;
   /**
-  * Whether to add a `__esModule: true` property when generating exports for non-ES formats.
+  * Whether to add a `__esModule: true` property when generating exports for non-ES {@link OutputOptions.format | formats}.
   *
   * This property signifies that the exported value is the namespace of an ES module and that the default export of this module corresponds to the `.default` property of the exported object.
   *
-  * - `true`: Always add the property when using named exports mode, which is similar to what other tools do.
-  * - `"if-default-prop"`: Only add the property when using named exports mode and there also is a default export. The subtle difference is that if there is no default export, consumers of the CommonJS version of your library will get all named exports as default export instead of an error or `undefined`.
+  * - `true`: Always add the property when using {@link OutputOptions.exports | named exports mode}, which is similar to what other tools do.
+  * - `"if-default-prop"`: Only add the property when using {@link OutputOptions.exports | named exports mode} and there also is a default export. The subtle difference is that if there is no default export, consumers of the CommonJS version of your library will get all named exports as default export instead of an error or `undefined`.
   * - `false`: Never add the property even if the default export would become a property `.default`.
   *
   * @default 'if-default-prop'
@@ -2839,18 +2859,6 @@ interface OutputOptions {
   */
   chunkFileNames?: string | ChunkFileNamesFunction;
   /**
-  * @default '[name].css'
-  * @experimental
-  * @hidden not ready for public usage yet
-  */
-  cssEntryFileNames?: string | ChunkFileNamesFunction;
-  /**
-  * @default '[name]-[hash].css'
-  * @experimental
-  * @hidden not ready for public usage yet
-  */
-  cssChunkFileNames?: string | ChunkFileNamesFunction;
-  /**
   * Whether to enable chunk name sanitization (removal of non-URL-safe characters like `\0`, `?` and `*`).
   *
   * Set `false` to disable the sanitization. You can also provide a custom sanitization function.
@@ -2864,15 +2872,15 @@ interface OutputOptions {
   * Rolldown uses Oxc Minifier under the hood. See Oxc's [minification documentation](https://oxc.rs/docs/guide/usage/minifier#features) for more details.
   *
   * - `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
+  * - `false`: Disable minification
+  * - `'dce-only'`: Only perform dead code elimination without code compression (default)
   * - `MinifyOptions`: Fine-grained control over minification settings
   *
-  * @default false
+  * @default 'dce-only'
   */
   minify?: boolean | "dce-only" | MinifyOptions;
   /**
-  * Specifies the global variable name that contains the exports of `umd` / `iife` bundles.
+  * Specifies the global variable name that contains the exports of `umd` / `iife` {@link OutputOptions.format | formats}.
   *
   * @example
   * ```js
@@ -2894,7 +2902,7 @@ interface OutputOptions {
   */
   name?: string;
   /**
-  * Specifies `id: variableName` pairs necessary for external imports in `umd` / `iife` bundles.
+  * Specifies `id: variableName` pairs necessary for {@link InputOptions.external | external} imports in `umd` / `iife` {@link OutputOptions.format | formats}.
   *
   * @example
   * ```js
@@ -2922,7 +2930,7 @@ interface OutputOptions {
   */
   globals?: Record<string, string> | GlobalsFunction;
   /**
-  * Maps external module IDs to paths.
+  * Maps {@link InputOptions.external | 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.
@@ -2959,7 +2967,7 @@ interface OutputOptions {
   */
   generatedCode?: Partial<GeneratedCodeOptions>;
   /**
-  * Whether to generate code to support live bindings for external imports.
+  * Whether to generate code to support live bindings for {@link InputOptions.external | external} imports.
   *
   * With the default value of `true`, Rolldown will generate code to support live bindings for external imports.
   *
@@ -3044,6 +3052,8 @@ interface OutputOptions {
   *
   * For deeper understanding, please refer to the in-depth [documentation](https://rolldown.rs/in-depth/manual-code-splitting).
   *
+  *
+  *
   * @example
   * **Basic vendor chunk**
   * ```js
@@ -3085,13 +3095,32 @@ interface OutputOptions {
     groups?: CodeSplittingGroup[];
   };
   /**
-  * Control comments in the output.
+  * Controls how legal comments are preserved in the output.
   *
-  * - `none`: no comments
-  * - `inline`: preserve comments that contain `@license`, `@preserve` or starts with `//!` `/*!`
+  * - `none`: no legal comments
+  * - `inline`: preserve legal comments that contain `@license`, `@preserve` or starts with `//!` `/*!`
+  *
+  * @deprecated Use `comments.legal` instead. When both `legalComments` and `comments.legal` are set, `comments.legal` takes priority.
   */
   legalComments?: "none" | "inline";
   /**
+  * Control which comments are preserved in the output.
+  *
+  * - `true`: Preserve legal, annotation, and JSDoc comments (default)
+  * - `false`: Strip all comments
+  * - Object: Granular control over comment categories
+  *
+  * Note: Regular line and block comments without these markers
+  * are always removed regardless of this option.
+  *
+  * When both `legalComments` and `comments.legal` are set, `comments.legal` takes priority.
+  *
+  *
+  *
+  * @default true
+  */
+  comments?: boolean | CommentsOptions;
+  /**
   * The list of plugins to use only for this output.
   *
   * @see {@linkcode InputOptions.plugins | plugins}
@@ -3119,13 +3148,13 @@ interface OutputOptions {
   */
   preserveModules?: boolean;
   /**
-  * Specifies the directory name for "virtual" files that might be emitted by plugins when using preserve modules mode.
+  * Specifies the directory name for "virtual" files that might be emitted by plugins when using {@link OutputOptions.preserveModules | preserve modules mode}.
   *
   * @default '_virtual'
   */
   virtualDirname?: string;
   /**
-  * A directory path to input modules that should be stripped away from {@linkcode dir | output.dir} when using preserve modules mode.
+  * A directory path to input modules that should be stripped away from {@linkcode dir | output.dir} when using {@link OutputOptions.preserveModules | preserve modules mode}.
   *
   *
   */
@@ -3179,6 +3208,18 @@ interface OutputOptions {
   * @default false
   */
   strictExecutionOrder?: boolean;
+  /**
+  * Whether to always output `"use strict"` directive in non-ES module outputs.
+  *
+  * - `true` - Always emit `"use strict"` at the top of the output (not applicable for ESM format since ESM is always strict).
+  * - `false` - Never emit `"use strict"` in the output.
+  * - `'auto'` - Respect the `"use strict"` directives from the source code.
+  *
+  * See [In-depth directive guide](https://rolldown.rs/in-depth/directives) for more details.
+  *
+  * @default 'auto'
+  */
+  strict?: boolean | "auto";
 }
 type CodeSplittingGroup = {
   /**
@@ -3313,6 +3354,36 @@ type CodeSplittingGroup = {
   * @default 0
   */
   minModuleSize?: number;
+  /**
+  * When `false` (default), all matching modules are merged into a single chunk.
+  * Every entry that uses any of these modules must load the entire chunk — even
+  * modules it doesn't need.
+  *
+  * When `true`, matching modules are grouped by which entries actually import them.
+  * Modules shared by the same set of entries go into the same chunk, while modules
+  * shared by a different set go into a separate chunk. This way, each entry only
+  * loads the code it actually uses.
+  *
+  * Example: entries A, B, C all match a `"vendor"` group.
+  * - `moduleX` is used by A, B, C
+  * - `moduleY` is used by A, B only
+  *
+  * With `entriesAware: false` → one `vendor.js` chunk with both modules; C loads `moduleY` unnecessarily.
+  * With `entriesAware: true`  → `vendor.js` (moduleX, loaded by all) + `vendor2.js` (moduleY, loaded by A and B only).
+  *
+  * @default false
+  */
+  entriesAware?: boolean;
+  /**
+  * Size threshold in bytes for merging small `entriesAware` subgroups into the
+  * closest neighboring subgroup.
+  *
+  * This option only works when {@linkcode CodeSplittingGroup.entriesAware | entriesAware}
+  * is `true`. Set to `0` to disable subgroup merging.
+  *
+  * @default 0
+  */
+  entriesAwareMergeThreshold?: number;
 };
 /**
 * Alias for {@linkcode CodeSplittingGroup}. Use this type for the `codeSplitting.groups` option.
@@ -3366,6 +3437,15 @@ type CodeSplittingOptions = {
 * @deprecated Please use {@linkcode CodeSplittingOptions} instead.
 */
 //#endregion
+//#region src/binding-magic-string.d.ts
+interface BindingMagicString extends BindingMagicString$1 {
+  readonly isRolldownMagicString: true;
+}
+type BindingMagicStringConstructor = Omit<typeof BindingMagicString$1, "prototype"> & {
+  new (...args: ConstructorParameters<typeof BindingMagicString$1>): BindingMagicString;
+  prototype: BindingMagicString;
+};
+declare const BindingMagicString: BindingMagicStringConstructor; //#endregion
 //#region src/log/log-handler.d.ts
 type LoggingFunction = (log: RolldownLog | string | (() => RolldownLog | string)) => void;
 type LoggingFunctionWithPosition = (log: RolldownLog | string | (() => RolldownLog | string), pos?: number | {
@@ -3503,6 +3583,16 @@ interface ChecksOptions {
   * @default true
   * */
   duplicateShebang?: boolean;
+  /**
+  * Whether to emit warnings when a tsconfig option or combination of options is not supported.
+  * @default true
+  * */
+  unsupportedTsconfigOption?: boolean;
+  /**
+  * Whether to emit warnings when a module is dynamically imported but also statically imported, making the dynamic import ineffective for code splitting.
+  * @default true
+  * */
+  ineffectiveDynamicImport?: boolean;
 } //#endregion
 //#region src/options/transform-options.d.ts
 interface TransformOptions extends Omit<TransformOptions$1, "sourceType" | "lang" | "cwd" | "sourcemap" | "define" | "inject" | "jsx"> {
@@ -3629,6 +3719,8 @@ interface NormalizedInputOptions {
   shimMissingExports: boolean;
   /** @see {@linkcode InputOptions.context | context} */
   context: string;
+  /** @see {@linkcode InputOptions.plugins | plugins} */
+  plugins: RolldownPlugin[];
 } //#endregion
 //#region src/options/normalized-output-options.d.ts
 type PathsFunction = (id: string) => string;
@@ -3659,10 +3751,6 @@ interface NormalizedOutputOptions {
   sourcemap: boolean | "inline" | "hidden";
   /** @see {@linkcode OutputOptions.sourcemapBaseUrl | sourcemapBaseUrl} */
   sourcemapBaseUrl: string | undefined;
-  /** @see {@linkcode OutputOptions.cssEntryFileNames | cssEntryFileNames} */
-  cssEntryFileNames: string | ChunkFileNamesFunction;
-  /** @see {@linkcode OutputOptions.cssChunkFileNames | cssChunkFileNames} */
-  cssChunkFileNames: string | ChunkFileNamesFunction;
   /** @see {@linkcode OutputOptions.codeSplitting | codeSplitting} */
   codeSplitting: boolean;
   /** @deprecated Use `codeSplitting` instead. */
@@ -3701,8 +3789,13 @@ interface NormalizedOutputOptions {
   sourcemapPathTransform: SourcemapPathTransformOption | undefined;
   /** @see {@linkcode OutputOptions.minify | minify} */
   minify: false | MinifyOptions | "dce-only";
-  /** @see {@linkcode OutputOptions.legalComments | legalComments} */
+  /**
+  * @deprecated Use `comments.legal` instead.
+  * @see {@linkcode OutputOptions.legalComments | legalComments}
+  */
   legalComments: "none" | "inline";
+  /** @see {@linkcode OutputOptions.comments | comments} */
+  comments: Required<CommentsOptions>;
   /** @see {@linkcode OutputOptions.polyfillRequire | polyfillRequire} */
   polyfillRequire: boolean;
   /** @see {@linkcode OutputOptions.plugins | plugins} */
@@ -4319,7 +4412,7 @@ type TreeshakingOptions = {
   *
   * See [related Oxc documentation](https://oxc.rs/docs/guide/usage/minifier/dead-code-elimination#ignoring-invalid-import-statement-side-effects) for more details.
   *
-  * @default true
+  * @default false
   */
   invalidImportSideEffects?: boolean;
   /**
@@ -4379,12 +4472,9 @@ interface ExistingRawSourceMap {
 }
 /** @inline @category Plugin APIs */
 type SourceMapInput = ExistingRawSourceMap | string | null; //#endregion
-//#region src/version.d.ts
+//#region src/utils/error.d.ts
 /**
-* The version of Rolldown.
-* @example `'1.0.0'`
-*
-* @category Plugin APIs
+* The error type that is thrown by Rolldown for the whole build.
 */
 //#endregion
 //#region src/builtin-plugin/utils.d.ts
@@ -4641,6 +4731,8 @@ interface FunctionPluginHooks {
   *
   * You can use {@linkcode PluginContext.getModuleInfo | this.getModuleInfo()} to find out the previous values of `meta`, `moduleSideEffects` inside this hook.
   *
+  *
+  *
   * @group Build Hooks
   */
   [DEFINED_HOOK_NAMES.transform]: (this: TransformPluginContext, code: string, id: string, meta: BindingTransformHookExtraArgs & {
@@ -4901,7 +4993,53 @@ type InputOption = string | string[] | Record<string, string>;
 type ExternalOptionFunction = (id: string, parentId: string | undefined, isResolved: boolean) => NullValue<boolean>;
 /** @inline */
 type ExternalOption = StringOrRegExp | StringOrRegExp[] | ExternalOptionFunction;
-type ModuleTypes = Record<string, "js" | "jsx" | "ts" | "tsx" | "json" | "text" | "base64" | "dataurl" | "binary" | "empty" | "css" | "asset">;
+type ModuleTypes = Record<string, "js" | "jsx" | "ts" | "tsx" | "json" | "text" | "base64" | "dataurl" | "binary" | "empty" | "css" | "asset" | "copy">;
+interface WatcherFileWatcherOptions {
+  /**
+  * Whether to use polling-based file watching instead of native OS events.
+  *
+  * Polling is useful for environments where native FS events are unreliable,
+  * such as network mounts, Docker volumes, or WSL2.
+  *
+  * @default false
+  */
+  usePolling?: boolean;
+  /**
+  * Interval between each poll in milliseconds.
+  *
+  * This option is only used when {@linkcode usePolling} is `true`.
+  *
+  * @default 100
+  */
+  pollInterval?: number;
+  /**
+  * Whether to compare file contents for poll-based watchers.
+  * When enabled, poll watchers will check file contents to determine if they actually changed.
+  *
+  * This option is only used when {@linkcode usePolling} is `true`.
+  *
+  * @default false
+  */
+  compareContentsForPolling?: boolean;
+  /**
+  * Whether to use debounced event delivery at the filesystem level.
+  * This coalesces rapid filesystem events before they reach the build coordinator.
+  * @default false
+  */
+  useDebounce?: boolean;
+  /**
+  * Debounce delay in milliseconds for fs-level debounced watchers.
+  * Only used when {@linkcode useDebounce} is `true`.
+  * @default 10
+  */
+  debounceDelay?: number;
+  /**
+  * Tick rate in milliseconds for the debouncer's internal polling.
+  * Only used when {@linkcode useDebounce} is `true`.
+  * When undefined, auto-selects 1/4 of debounceDelay.
+  */
+  debounceTickRate?: number;
+}
 interface WatcherOptions {
   /**
   * Whether to skip the {@linkcode RolldownBuild.write | bundle.write()} step when a rebuild is triggered.
@@ -4927,32 +5065,13 @@ interface WatcherOptions {
   */
   buildDelay?: number;
   /**
-  * An optional object of options that will be passed to the [notify](https://github.com/rolldown/notify) file watcher.
+  * File watcher options for configuring how file changes are detected.
   */
-  notify?: {
-    /**
-    * Interval between each re-scan attempt in milliseconds.
-    *
-    * This option is only used when polling backend is used.
-    *
-    * @default 30_000
-    */
-    pollInterval?: number;
-    /**
-    * Whether to compare file contents when checking for changes.
-    *
-    * This is especially important for pseudo filesystems like those on Linux
-    * under `/sys` and `/proc` which are not obligated to respect any other
-    * filesystem norms such as modification timestamps, file sizes, etc. By
-    * enabling this feature, performance will be significantly impacted as
-    * all files will need to be read and hashed at each interval.
-    *
-    * This option is only used when polling backend is used.
-    *
-    * @default false
-    */
-    compareContents?: boolean;
-  };
+  watcher?: WatcherFileWatcherOptions;
+  /**
+  * @deprecated Use {@linkcode watcher} instead.
+  */
+  notify?: WatcherFileWatcherOptions;
   /**
   * Filter to limit the file-watching to certain files.
   *
@@ -5054,7 +5173,7 @@ type OptimizationOptions = {
   * console.log(API_URL);
   * ```
   *
-  * @default false
+  * @default { mode: 'smart', pass: 1 }
   */
   inlineConst?: boolean | {
     mode?: "all" | "smart";
@@ -5583,6 +5702,14 @@ interface InputOptions {
   tsconfig?: boolean | string;
 } //#endregion
 //#region src/types/rolldown-options.d.ts
+interface RolldownOptions extends InputOptions {
+  output?: OutputOptions | OutputOptions[];
+} //#endregion
+//#region src/utils/define-config.d.ts
+/**
+* Type for `default export` of `rolldown.config.js` file.
+* @category Config
+*/
 //#endregion
 //#region src/Types/ConfigTypes.d.ts
 /**
@@ -5592,25 +5719,7 @@ declare namespace ConfigTypes {
   /**
    * Runtime configuration interface that can be modified during application execution.
    */
-  interface RuntimeConfig {
-    /**
-     * Session configuration options.
-     */
-    session?: {
-      /**
-       * The secret used to sign the session ID cookie.
-       */
-      secret?: string;
-      /**
-       * The name of the session ID cookie.
-       */
-      name?: string;
-      /**
-       * The duration of time for the session to be active.
-       */
-      duration?: number;
-    };
-  }
+  interface RuntimeConfig {}
   /**
    * Helper type to create a fully typed runtime configuration.
    * This allows users to define their own runtime configuration structure
@@ -5636,6 +5745,8 @@ declare namespace ConfigTypes {
     entry?: string | string[];
     /**
      * Defines to pass to the build.
+     * @deprecated Use `rolldownConfig.transform.define` instead.
+     * This field is still applied via the base config but will be removed in a future release.
      */
     define?: Record<string, string>;
     /**
@@ -5648,6 +5759,8 @@ declare namespace ConfigTypes {
     dts?: boolean;
     /**
      * Additional plugins to use in the bundler.
+     * @deprecated Use `rolldownConfig.plugins` instead.
+     * This field is still applied via the base config but will be removed in a future release.
      */
     plugins?: RolldownPluginOption[];
     /**
@@ -5667,6 +5780,12 @@ declare namespace ConfigTypes {
      * The bundler to use for the application build.
      */
     bundler?: 'rolldown';
+    /**
+     * Additional options passed directly to the rolldown bundler.
+     * These options are deep-merged with the base config using `defu`, meaning values provided here take precedence over the defaults.
+     * The `input`, `output`, and `onwarn` fields are managed internally and cannot be overridden here.
+     */
+    rolldownConfig?: Omit<RolldownOptions, 'input' | 'output' | 'onwarn'>;
   }
   /**
    * Server configuration options for the application.