rolldown 1.0.0-beta.15 → 1.0.0-beta.17

package/dist/shared/{define-config-De_1kjGz.d.mts → define-config-Cm86JHb7.d.mts}

@@ -1,4 +1,4 @@
-import { BindingAssetPluginConfig, BindingBuildImportAnalysisPluginConfig, BindingBuiltinPluginName, BindingDynamicImportVarsPluginConfig, BindingHmrOutput, BindingHmrOutputPatch, BindingHookResolveIdExtraArgs, BindingImportGlobPluginConfig, BindingIsolatedDeclarationPluginConfig, BindingJsonPluginConfig, BindingManifestPluginConfig, BindingMfManifest, BindingMinifyOptions, BindingModuleFederationPluginOption, BindingModulePreloadPolyfillPluginConfig, BindingRemote, BindingRenderedChunk, BindingReporterPluginConfig, BindingTransformHookExtraArgs, BindingViteResolvePluginConfig, BindingWatcherEvent, Bundler, ParserOptions, PreRenderedChunk, TransformOptions } from "./binding-Dze8QVpf.mjs";
+import { BindingAssetPluginConfig, BindingBuildImportAnalysisPluginConfig, BindingBuiltinPluginName, BindingBundlerImpl, BindingDynamicImportVarsPluginConfig, BindingHmrOutputPatch, BindingHookResolveIdExtraArgs, BindingImportGlobPluginConfig, BindingIsolatedDeclarationPluginConfig, BindingJsonPluginConfig, BindingManifestPluginConfig, BindingMfManifest, BindingMinifyOptions, BindingModuleFederationPluginOption, BindingModulePreloadPolyfillPluginConfig, BindingRemote, BindingRenderedChunk, BindingReporterPluginConfig, BindingTransformHookExtraArgs, BindingViteResolvePluginConfig, BindingWatcherEvent, ParserOptions, PreRenderedChunk, TransformOptions } from "./binding-CWvDTpOw.mjs";
 import { TopLevelFilterExpression } from "@rolldown/pluginutils";
 import { Program } from "@oxc-project/types";
 
@@ -170,7 +170,7 @@ interface OutputOptions {
   externalLiveBindings?: boolean;
   inlineDynamicImports?: boolean;
   /**
-  * Allows you to do advanced chunking. Use it to reduce the number of common chunks or split out a chunk that hardly changes to obtain better caching.
+  * Allows you to do manual chunking. For deeper understanding, please refer to the in-depth [documentation](https://rolldown.rs/guide/in-depth/advanced-chunks).
   */
   advancedChunks?: {
     /**
@@ -211,6 +211,24 @@ interface OutputOptions {
       * - Type: `string`
       *
       * Name of the group. It will be also used as the name of the chunk and replaced the `[name]` placeholder in the `chunkFileNames` option.
+      *
+      * For example,
+      *
+      * ```js
+      * import { defineConfig } from 'rolldown';
+      *
+      * export default defineConfig({
+      *   advancedChunks: {
+      *     groups: [
+      *       {
+      *         name: 'libs',
+      *         test: /node_modules/,
+      *       },
+      *     ],
+      *   },
+      * });
+      * ```
+      * will create a chunk named `libs-[hash].js` in the end.
       */
       name: string;
       /**
@@ -218,25 +236,50 @@ interface OutputOptions {
       *
       * Controls which modules are captured in this group.
       *
-      * If `test` is a string, the module whose id contains the string will be captured.
-      * If `test` is a regular expression, the module whose id matches the regular expression will be captured.
-      * If `test` is a function, modules for which `test(id)` returns `true` will be captured.
-      * if `test` is empty, any module will be considered as matched.
+      * - If `test` is a string, the module whose id contains the string will be captured.
+      * - If `test` is a regular expression, the module whose id matches the regular expression will be captured.
+      * - If `test` is a function, modules for which `test(id)` returns `true` will be captured.
+      * - If `test` is empty, any module will be considered as matched.
       */
       test?: StringOrRegExp | ((id: string) => boolean | undefined | void);
       /**
       * - Type: `number`
+      * - Default: `0`
       *
       * Priority of the group. Group with higher priority will be chosen first to match modules and create chunks. When converting the group to a chunk, modules of that group will be removed from other groups.
       *
       * If two groups have the same priority, the group whose index is smaller will be chosen.
+      *
+      * For example,
+      *
+      * ```js
+      * import { defineConfig } from 'rolldown';
+      *
+      * export default defineConfig({
+      *  advancedChunks: {
+      *   groups: [
+      *      {
+      *        name: 'react',
+      *        test: /node_modules\/react/,
+      *        priority: 1,
+      *      },
+      *      {
+      *        name: 'other-libs',
+      *        test: /node_modules/,
+      *        priority: 2,
+      *      },
+      *   ],
+      * });
+      * ```
+      *
+      * This is a clearly __incorrect__ example. Though `react` group is defined before `other-libs`, it has a lower priority, so the modules in `react` group will be captured in `other-libs` group.
       */
       priority?: number;
       /**
       * - Type: `number`
       * - Default: `0`
       *
-      * Minimum size of the desired chunk. If accumulated size of captured modules is smaller than this value, this group will be ignored.
+      * Minimum size of the desired chunk. If the accumulated size of the captured modules by this group is smaller than this value, it will be ignored. Modules in this group will fall back to the `automatic chunking` if they are not captured by any other group.
       */
       minSize?: number;
       /**
@@ -250,7 +293,7 @@ interface OutputOptions {
       * - Type: `number`
       * - Default: `Infinity`
       *
-      * If final size of this group is larger than this value, this group will be spit into multiple groups that each has size closed to this value.
+      * If the accumulated size of the captured modules by this group is larger than this value, this group will be split into multiple groups that each has size close to this value.
       */
       maxSize?: number;
       /**
@@ -309,8 +352,8 @@ declare class RolldownBuild {
   write(outputOptions?: OutputOptions): Promise<RolldownOutput>;
   close(): Promise<void>;
   [Symbol.asyncDispose](): Promise<void>;
-  generateHmrPatch(changedFiles: string[]): Promise<BindingHmrOutputPatch | undefined>;
-  hmrInvalidate(file: string, firstInvalidatedBy?: string): Promise<BindingHmrOutput | undefined>;
+  generateHmrPatch(changedFiles: string[]): Promise<BindingHmrOutputPatch>;
+  hmrInvalidate(file: string, firstInvalidatedBy?: string): Promise<BindingHmrOutputPatch>;
   // TODO(underfin)
   // The `watchFiles` method returns a promise, but Rollup does not.
   // Converting it to a synchronous API might cause a deadlock if the user calls `write` and `watchFiles` simultaneously.
@@ -330,7 +373,7 @@ interface WatchOptions extends InputOptions {
 type WatcherEvent = "close" | "event" | "restart" | "change";
 type ChangeEvent$1 = "create" | "update" | "delete";
 // TODO: find a way use `RolldownBuild` instead of `Bundler`.
-type RolldownWatchBuild = Bundler;
+type RolldownWatchBuild = BindingBundlerImpl;
 type RolldownWatcherEvent = {
   code: "START";
 } | {
@@ -878,6 +921,7 @@ type HmrOptions = boolean | {
   port?: number;
   implement?: string;
 };
+type AttachDebugOptions = "none" | "simple" | "full";
 interface RollupJsxOptions {
   mode?: "classic" | "automatic" | "preserve";
   factory?: string;
@@ -936,7 +980,7 @@ interface InputOptions {
     viteMode?: boolean;
     resolveNewUrlToAsset?: boolean;
     hmr?: HmrOptions;
-    attachDebugInfo?: boolean;
+    attachDebugInfo?: AttachDebugOptions;
   };
   /**
   * Replace global variables or [property accessors](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Property_accessors) with the provided values.
@@ -1019,6 +1063,23 @@ interface InputOptions {
   * @default runtime = "automatic"
   */
   jsx?: false | "react" | "react-jsx" | "preserve" | RollupJsxOptions;
+  /**
+  * Configure how the code is transformed. This process happens after the `transform` hook.
+  *
+  * To transpile [legacy decorators](https://github.com/tc39/proposal-decorators/tree/4ac0f4cd31bd0f2e8170cb4c5136e51671e46c8d), you could use
+  *
+  * ```js
+  * export default defineConfig({
+  *   transform: {
+  *     decorator: {
+  *       legacy: true,
+  *     },
+  *   },
+  * })
+  * ```
+  *
+  * For latest decorators proposal, rolldown is able to bundle them but doesn't support transpiling them yet.
+  */
   transform?: OxcTransformOption;
   watch?: WatcherOptions | false;
   dropLabels?: string[];

package/dist/shared/{define-config-BE-fkZNW.d.cts → define-config-POPyhxOq.d.cts}

@@ -1,4 +1,4 @@
-import { BindingAssetPluginConfig, BindingBuildImportAnalysisPluginConfig, BindingBuiltinPluginName, BindingDynamicImportVarsPluginConfig, BindingHmrOutput, BindingHmrOutputPatch, BindingHookResolveIdExtraArgs, BindingImportGlobPluginConfig, BindingIsolatedDeclarationPluginConfig, BindingJsonPluginConfig, BindingManifestPluginConfig, BindingMfManifest, BindingMinifyOptions, BindingModuleFederationPluginOption, BindingModulePreloadPolyfillPluginConfig, BindingRemote, BindingRenderedChunk, BindingReporterPluginConfig, BindingTransformHookExtraArgs, BindingViteResolvePluginConfig, BindingWatcherEvent, Bundler, ParserOptions, PreRenderedChunk, TransformOptions } from "./binding-CZdobbZA.cjs";
+import { BindingAssetPluginConfig, BindingBuildImportAnalysisPluginConfig, BindingBuiltinPluginName, BindingBundlerImpl, BindingDynamicImportVarsPluginConfig, BindingHmrOutputPatch, BindingHookResolveIdExtraArgs, BindingImportGlobPluginConfig, BindingIsolatedDeclarationPluginConfig, BindingJsonPluginConfig, BindingManifestPluginConfig, BindingMfManifest, BindingMinifyOptions, BindingModuleFederationPluginOption, BindingModulePreloadPolyfillPluginConfig, BindingRemote, BindingRenderedChunk, BindingReporterPluginConfig, BindingTransformHookExtraArgs, BindingViteResolvePluginConfig, BindingWatcherEvent, ParserOptions, PreRenderedChunk, TransformOptions } from "./binding-um3VI33z.cjs";
 import { Program } from "@oxc-project/types";
 import { TopLevelFilterExpression } from "@rolldown/pluginutils";
 
@@ -170,7 +170,7 @@ interface OutputOptions {
   externalLiveBindings?: boolean;
   inlineDynamicImports?: boolean;
   /**
-  * Allows you to do advanced chunking. Use it to reduce the number of common chunks or split out a chunk that hardly changes to obtain better caching.
+  * Allows you to do manual chunking. For deeper understanding, please refer to the in-depth [documentation](https://rolldown.rs/guide/in-depth/advanced-chunks).
   */
   advancedChunks?: {
     /**
@@ -211,6 +211,24 @@ interface OutputOptions {
       * - Type: `string`
       *
       * Name of the group. It will be also used as the name of the chunk and replaced the `[name]` placeholder in the `chunkFileNames` option.
+      *
+      * For example,
+      *
+      * ```js
+      * import { defineConfig } from 'rolldown';
+      *
+      * export default defineConfig({
+      *   advancedChunks: {
+      *     groups: [
+      *       {
+      *         name: 'libs',
+      *         test: /node_modules/,
+      *       },
+      *     ],
+      *   },
+      * });
+      * ```
+      * will create a chunk named `libs-[hash].js` in the end.
       */
       name: string;
       /**
@@ -218,25 +236,50 @@ interface OutputOptions {
       *
       * Controls which modules are captured in this group.
       *
-      * If `test` is a string, the module whose id contains the string will be captured.
-      * If `test` is a regular expression, the module whose id matches the regular expression will be captured.
-      * If `test` is a function, modules for which `test(id)` returns `true` will be captured.
-      * if `test` is empty, any module will be considered as matched.
+      * - If `test` is a string, the module whose id contains the string will be captured.
+      * - If `test` is a regular expression, the module whose id matches the regular expression will be captured.
+      * - If `test` is a function, modules for which `test(id)` returns `true` will be captured.
+      * - If `test` is empty, any module will be considered as matched.
       */
       test?: StringOrRegExp | ((id: string) => boolean | undefined | void);
       /**
       * - Type: `number`
+      * - Default: `0`
       *
       * Priority of the group. Group with higher priority will be chosen first to match modules and create chunks. When converting the group to a chunk, modules of that group will be removed from other groups.
       *
       * If two groups have the same priority, the group whose index is smaller will be chosen.
+      *
+      * For example,
+      *
+      * ```js
+      * import { defineConfig } from 'rolldown';
+      *
+      * export default defineConfig({
+      *  advancedChunks: {
+      *   groups: [
+      *      {
+      *        name: 'react',
+      *        test: /node_modules\/react/,
+      *        priority: 1,
+      *      },
+      *      {
+      *        name: 'other-libs',
+      *        test: /node_modules/,
+      *        priority: 2,
+      *      },
+      *   ],
+      * });
+      * ```
+      *
+      * This is a clearly __incorrect__ example. Though `react` group is defined before `other-libs`, it has a lower priority, so the modules in `react` group will be captured in `other-libs` group.
       */
       priority?: number;
       /**
       * - Type: `number`
       * - Default: `0`
       *
-      * Minimum size of the desired chunk. If accumulated size of captured modules is smaller than this value, this group will be ignored.
+      * Minimum size of the desired chunk. If the accumulated size of the captured modules by this group is smaller than this value, it will be ignored. Modules in this group will fall back to the `automatic chunking` if they are not captured by any other group.
       */
       minSize?: number;
       /**
@@ -250,7 +293,7 @@ interface OutputOptions {
       * - Type: `number`
       * - Default: `Infinity`
       *
-      * If final size of this group is larger than this value, this group will be spit into multiple groups that each has size closed to this value.
+      * If the accumulated size of the captured modules by this group is larger than this value, this group will be split into multiple groups that each has size close to this value.
       */
       maxSize?: number;
       /**
@@ -309,8 +352,8 @@ declare class RolldownBuild {
   write(outputOptions?: OutputOptions): Promise<RolldownOutput>;
   close(): Promise<void>;
   [Symbol.asyncDispose](): Promise<void>;
-  generateHmrPatch(changedFiles: string[]): Promise<BindingHmrOutputPatch | undefined>;
-  hmrInvalidate(file: string, firstInvalidatedBy?: string): Promise<BindingHmrOutput | undefined>;
+  generateHmrPatch(changedFiles: string[]): Promise<BindingHmrOutputPatch>;
+  hmrInvalidate(file: string, firstInvalidatedBy?: string): Promise<BindingHmrOutputPatch>;
   // TODO(underfin)
   // The `watchFiles` method returns a promise, but Rollup does not.
   // Converting it to a synchronous API might cause a deadlock if the user calls `write` and `watchFiles` simultaneously.
@@ -330,7 +373,7 @@ interface WatchOptions extends InputOptions {
 type WatcherEvent = "close" | "event" | "restart" | "change";
 type ChangeEvent$1 = "create" | "update" | "delete";
 // TODO: find a way use `RolldownBuild` instead of `Bundler`.
-type RolldownWatchBuild = Bundler;
+type RolldownWatchBuild = BindingBundlerImpl;
 type RolldownWatcherEvent = {
   code: "START";
 } | {
@@ -878,6 +921,7 @@ type HmrOptions = boolean | {
   port?: number;
   implement?: string;
 };
+type AttachDebugOptions = "none" | "simple" | "full";
 interface RollupJsxOptions {
   mode?: "classic" | "automatic" | "preserve";
   factory?: string;
@@ -936,7 +980,7 @@ interface InputOptions {
     viteMode?: boolean;
     resolveNewUrlToAsset?: boolean;
     hmr?: HmrOptions;
-    attachDebugInfo?: boolean;
+    attachDebugInfo?: AttachDebugOptions;
   };
   /**
   * Replace global variables or [property accessors](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Property_accessors) with the provided values.
@@ -1019,6 +1063,23 @@ interface InputOptions {
   * @default runtime = "automatic"
   */
   jsx?: false | "react" | "react-jsx" | "preserve" | RollupJsxOptions;
+  /**
+  * Configure how the code is transformed. This process happens after the `transform` hook.
+  *
+  * To transpile [legacy decorators](https://github.com/tc39/proposal-decorators/tree/4ac0f4cd31bd0f2e8170cb4c5136e51671e46c8d), you could use
+  *
+  * ```js
+  * export default defineConfig({
+  *   transform: {
+  *     decorator: {
+  *       legacy: true,
+  *     },
+  *   },
+  * })
+  * ```
+  *
+  * For latest decorators proposal, rolldown is able to bundle them but doesn't support transpiling them yet.
+  */
   transform?: OxcTransformOption;
   watch?: WatcherOptions | false;
   dropLabels?: string[];

package/dist/shared/{load-config-Bq6nGoUg.cjs → load-config-B4zzmrcW.cjs}

@@ -1,5 +1,5 @@
 const require_chunk = require('./chunk-DDkG_k5U.cjs');
-const require_src = require('./src-aJubL6dq.cjs');
+const require_src = require('./src-C98Q0NLX.cjs');
 const node_fs = require_chunk.__toESM(require("node:fs"));
 const node_path = require_chunk.__toESM(require("node:path"));
 const node_url = require_chunk.__toESM(require("node:url"));

package/dist/shared/{load-config-BOcke1T-.mjs → load-config-BlOqMlge.mjs}

@@ -1,5 +1,4 @@
-import { __esm } from "./chunk--iN_1bjD.mjs";
-import { init_rolldown, rolldown } from "./src-DBOqhEP1.mjs";
+import { rolldown } from "./src-CuIbdNSi.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
@@ -48,6 +47,18 @@ async function bundleTsConfig(configFile, isEsm) {
 	const fileName = result.output.find((chunk) => chunk.type === "chunk" && chunk.isEntry).fileName;
 	return path.join(outputDir, fileName);
 }
+const SUPPORTED_JS_CONFIG_FORMATS = [
+	".js",
+	".mjs",
+	".cjs"
+];
+const SUPPORTED_TS_CONFIG_FORMATS = [
+	".ts",
+	".mts",
+	".cts"
+];
+const SUPPORTED_CONFIG_FORMATS = [...SUPPORTED_JS_CONFIG_FORMATS, ...SUPPORTED_TS_CONFIG_FORMATS];
+const DEFAULT_CONFIG_BASE = "rolldown.config";
 async function findConfigFileNameInCwd() {
 	const filesInWorkingDirectory = new Set(await readdir(cwd()));
 	for (const extension of SUPPORTED_CONFIG_FORMATS) {
@@ -103,22 +114,6 @@ async function loadConfig(configPath) {
 		throw new Error("Error happened while loading config.", { cause: err });
 	}
 }
-var SUPPORTED_JS_CONFIG_FORMATS, SUPPORTED_TS_CONFIG_FORMATS, SUPPORTED_CONFIG_FORMATS, DEFAULT_CONFIG_BASE;
-var init_load_config = __esm({ "src/utils/load-config.ts"() {
-	init_rolldown();
-	SUPPORTED_JS_CONFIG_FORMATS = [
-		".js",
-		".mjs",
-		".cjs"
-	];
-	SUPPORTED_TS_CONFIG_FORMATS = [
-		".ts",
-		".mts",
-		".cts"
-	];
-	SUPPORTED_CONFIG_FORMATS = [...SUPPORTED_JS_CONFIG_FORMATS, ...SUPPORTED_TS_CONFIG_FORMATS];
-	DEFAULT_CONFIG_BASE = "rolldown.config";
-} });
 
 //#endregion
-export { init_load_config, loadConfig };
+export { loadConfig };

package/dist/shared/{misc-DGAe2XOW.mjs → misc-BN0nse6C.mjs}

@@ -1,5 +1,3 @@
-import { __esm } from "./chunk--iN_1bjD.mjs";
-
 //#region src/utils/misc.ts
 function arraify(value) {
 	return Array.isArray(value) ? value : [value];
@@ -22,7 +20,6 @@ function unsupported(info) {
 	throw new Error(`UNSUPPORTED: ${info}`);
 }
 function noop(..._args) {}
-var init_misc = __esm({ "src/utils/misc.ts"() {} });
 
 //#endregion
-export { arraify, init_misc, isNullish, isPromiseLike, noop, unimplemented, unreachable, unsupported };
+export { arraify, isNullish, isPromiseLike, noop, unimplemented, unreachable, unsupported };