rolldown 1.1.5 → 1.2.1

package/THIRD-PARTY-LICENSE

@@ -0,0 +1,33 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 [these people](https://github.com/rollup/rollup/graphs/contributors)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+---
+
+MIT License
+
+Copyright (c) 2020 Evan Wallace
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cli.mjs

@@ -1,9 +1,9 @@
-import { n as onExit, t as watch } from "./shared/watch-B1b0gmVh.mjs";
-import { S as version, x as description } from "./shared/bindingify-input-options-XPJLJOD0.mjs";
-import { t as arraify } from "./shared/misc-CoQm4NHO.mjs";
-import { a as getInputCliKeys, i as getCliSchemaInfo, l as styleText, o as getOutputCliKeys, r as logger, s as validateCliOptions } from "./shared/rolldown-build-CtPvmZgJ.mjs";
-import { t as rolldown } from "./shared/rolldown-ChpIlMRm.mjs";
-import { t as loadConfig } from "./shared/load-config-BL_FI6dc.mjs";
+import { n as onExit, t as watch } from "./shared/watch-Cwq-cFUy.mjs";
+import { C as version, S as description } from "./shared/bindingify-input-options-EnUlEF0T.mjs";
+import { t as arraify } from "./shared/misc-DOSKtd97.mjs";
+import { a as getOutputCliKeys, c as styleText, i as getInputCliKeys, n as logger, o as validateCliOptions, r as getCliSchemaInfo } from "./shared/create-bundler-option-4QtiLLuz.mjs";
+import { t as rolldown } from "./shared/rolldown-DP_p9pd3.mjs";
+import { t as loadConfig } from "./shared/load-config-DsMzOVzu.mjs";
 import path from "node:path";
 import g$1 from "node:process";
 import { performance } from "node:perf_hooks";
@@ -862,7 +862,7 @@ function getClearScreenFunction(options) {
 	};
 }
 //#endregion
-//#region \0@oxc-project+runtime@0.139.0/helpers/esm/usingCtx.js
+//#region \0@oxc-project+runtime@0.142.0/helpers/esm/usingCtx.js
 function _usingCtx() {
 	var r = "function" == typeof SuppressedError ? SuppressedError : function(r, e) {
 		var n = Error();
@@ -947,7 +947,8 @@ async function bundleWithCliOptions(cliOptions) {
 		const { output: outputs } = await _usingCtx$1.a(await rolldown(cliOptions.input)).generate(cliOptions.output);
 		if (outputs.length === 0) {
 			logger.error("No output generated");
-			process.exit(1);
+			process.exitCode = 1;
+			return;
 		}
 		for (const file of outputs) {
 			if (outputs.length > 1) logger.log(`\n${styleText(["cyan", "bold"], `|→ ${file.fileName}:`)}\n`);
@@ -1000,8 +1001,6 @@ async function watchInner(config, cliOptions) {
 			case "ERROR":
 				await event.result.close();
 				logger.error(event.error);
-				break;
-			default: break;
 		}
 	});
 	logger.log(`Waiting for changes...`);

package/dist/config.d.mts

@@ -1,27 +1,26 @@
-import { L as VERSION, r as defineConfig, t as ConfigExport } from "./shared/define-config-BhJ90aEv.mjs";
-
+import { R as VERSION, r as defineConfig, t as ConfigExport } from "./shared/define-config-DSMNXceb.mjs";
 //#region src/utils/load-config.d.ts
 type ConfigLoader = "bundle" | "native";
 interface LoadConfigOptions {
   /**
-  * How to load the config file.
-  * - `'bundle'` (default): bundle the config with Rolldown, then import it.
-  * - `'native'`: import the config directly, delegating TypeScript/loader
-  *   handling to the runtime. Faster, but requires runtime support.
-  *
-  * @default 'bundle'
-  */
+   * How to load the config file.
+   * - `'bundle'` (default): bundle the config with Rolldown, then import it.
+   * - `'native'`: import the config directly, delegating TypeScript/loader
+   *   handling to the runtime. Faster, but requires runtime support.
+   *
+   * @default 'bundle'
+   */
   configLoader?: ConfigLoader;
 }
 /**
-* Load config from a file in a way that Rolldown does.
-*
-* @param configPath The path to the config file. If empty, it will look for `rolldown.config` with supported extensions in the current working directory.
-* @param options Loading options. `configLoader` selects `'bundle'` (default) or `'native'`.
-* @returns The loaded config export
-*
-* @category Config
-*/
+ * Load config from a file in a way that Rolldown does.
+ *
+ * @param configPath The path to the config file. If empty, it will look for `rolldown.config` with supported extensions in the current working directory.
+ * @param options Loading options. `configLoader` selects `'bundle'` (default) or `'native'`.
+ * @returns The loaded config export
+ *
+ * @category Config
+ */
 declare function loadConfig(configPath: string, options?: LoadConfigOptions): Promise<ConfigExport>;
 //#endregion
 export { VERSION, defineConfig, loadConfig };

package/dist/config.mjs

@@ -1,4 +1,4 @@
-import { b as VERSION } from "./shared/bindingify-input-options-XPJLJOD0.mjs";
+import { x as VERSION } from "./shared/bindingify-input-options-EnUlEF0T.mjs";
 import { t as defineConfig } from "./shared/define-config-Demdg3_4.mjs";
-import { t as loadConfig } from "./shared/load-config-BL_FI6dc.mjs";
+import { t as loadConfig } from "./shared/load-config-DsMzOVzu.mjs";
 export { VERSION, defineConfig, loadConfig };

package/dist/experimental-default-runtime.mjs

@@ -0,0 +1,116 @@
+// @ts-check
+
+/** @import { DevRuntime } from './runtime-extra-dev-common.js' */
+
+/** @type {typeof DevRuntime} */
+// @ts-expect-error -- there's no way to declare a variable by JSDoc
+var BaseDevRuntime = DevRuntime;
+
+class ModuleHotContext {
+  /**
+   * @type {{ deps: [string], fn: (moduleExports: Record<string, any>[]) => void }[]}
+   */
+  acceptCallbacks = [];
+  /**
+   * @param {string} moduleId
+   * @param {InstanceType<BaseDevRuntime>} devRuntime
+   */
+  constructor(moduleId, devRuntime) {
+    this.moduleId = moduleId;
+    this.devRuntime = devRuntime;
+  }
+
+  /**
+   * @overload
+   * @param {(mod: Record<string, any>) => void} cb
+   * @returns {void}
+   */
+  /**
+   * @param {...any} args
+   * @returns {void}
+   */
+  accept(...args) {
+    if (args.length === 1) {
+      const [cb] = /** @type {[(mod: Record<string, any>) => void]} */ (args);
+      const acceptingPath = this.moduleId;
+      this.acceptCallbacks.push({
+        deps: [acceptingPath],
+        fn: cb,
+      });
+    } else if (args.length === 0) {}
+    else {
+      throw new Error('Invalid arguments for `import.meta.hot.accept`');
+    }
+  }
+
+  invalidate() {
+    socket.send(JSON.stringify({
+      type: 'hmr:invalidate',
+      moduleId: this.moduleId,
+    }));
+  }
+}
+
+class DefaultDevRuntime extends BaseDevRuntime {
+  /**
+   * @type {Map<string, ModuleHotContext>}
+   */
+  moduleHotContexts = new Map();
+  /**
+   * @override
+   * @param {string} moduleId
+   */
+  createModuleHotContext(moduleId) {
+    const hotContext = new ModuleHotContext(moduleId, this);
+    this.moduleHotContexts.set(moduleId, hotContext);
+    return hotContext;
+  }
+}
+
+/** @param {string} url */
+function loadScript(url) {
+  var script = document.createElement('script');
+  script.src = url;
+  script.type = 'module';
+  script.onerror = function() {
+    console.error('Failed to load script: ' + url);
+  };
+  document.body.appendChild(script);
+}
+
+console.debug('HMR runtime loaded', '$ADDR');
+// Generate client ID immediately at runtime initialization
+// This ensures the client ID is available before any lazy imports
+const clientId = crypto.randomUUID();
+const addr = new URL('ws://$ADDR');
+addr.searchParams.set('clientId', clientId);
+
+const socket = new WebSocket(addr);
+
+(/** @type {any} */ (globalThis)).__rolldown_runtime__ ??=
+  new DefaultDevRuntime(clientId);
+
+/** @param {MessageEvent} event */
+socket.onmessage = function(event) {
+  const data = JSON.parse(event.data);
+  console.debug('Received message:', data);
+  if (data.type === 'connected') {
+    // Server acknowledged the connection
+    console.debug('[hmr]: Connection established with server');
+  } else if (data.type === 'hmr:update') {
+    if (typeof process === 'object') {
+      import(data.path);
+      console.debug(`[hmr]: Importing HMR patch: ${data.path}`);
+    } else {
+      console.debug(`[hmr]: Loading HMR patch: ${data.path}`);
+      loadScript(data.url);
+    }
+  } else if (data.type === 'hmr:reload') {
+    console.log('[hmr]: Full reload required, reloading page');
+    if (typeof location !== 'undefined') {
+      location.reload();
+    } else {
+      console.log('[hmr]: location is undefined, cannot reload page');
+    }
+  }
+};

package/dist/experimental-index.d.mts

@@ -1,8 +1,7 @@
-import { B as ResolveResult, C as BindingViteManifestPluginConfig, G as isolatedDeclaration, I as NapiResolveOptions, K as isolatedDeclarationSync, M as IsolatedDeclarationsResult, O as BindingViteTransformPluginConfig, V as ResolverFactory, _ as BindingTsconfigRawOptions, f as BindingRebuildStrategy, g as BindingTsconfigCompilerOptions, i as BindingClientHmrUpdate, j as IsolatedDeclarationsOptions, n as BindingBundleAnalyzerPluginConfig, q as moduleRunnerTransform, r as BindingBundleState } from "./shared/binding-D26QphWG.mjs";
-import { Bt as OutputOptions, F as BuiltinPlugin, Q as defineParallelPlugin, Wt as StringOrRegExp, Yt as RolldownOutput, Zt as freeExternalMemory, l as InputOptions, lt as NormalizedOutputOptions } from "./shared/define-config-BhJ90aEv.mjs";
-import { a as MinifyOptions$1, c as minifySync$1, d as parse$1, f as parseSync$1, i as transformSync$1, l as ParseResult$1, m as resolveTsconfig, n as TransformResult$1, o as MinifyResult$1, p as TsconfigCache$1, r as transform$1, s as minify$1, t as TransformOptions$1, u as ParserOptions$1 } from "./shared/transform-BPrUvqEZ.mjs";
-import { a as viteDynamicImportVarsPlugin, c as viteLoadFallbackPlugin, d as viteReporterPlugin, f as viteResolvePlugin, i as viteBuildImportAnalysisPlugin, l as viteModulePreloadPolyfillPlugin, n as isolatedDeclarationPlugin, o as viteImportGlobPlugin, p as viteWebWorkerPostPlugin, r as oxcRuntimePlugin, s as viteJsonPlugin, u as viteReactRefreshWrapperPlugin } from "./shared/constructors-BbWPse2X.mjs";
-
+import { H as ResolverFactory, J as moduleRunnerTransform, K as isolatedDeclaration, L as NapiResolveOptions, M as IsolatedDeclarationsOptions, N as IsolatedDeclarationsResult, V as ResolveResult, _ as BindingTsconfigCompilerOptions, i as BindingClientHmrUpdate, k as BindingViteTransformPluginConfig, n as BindingBundleAnalyzerPluginConfig, p as BindingRebuildStrategy, q as isolatedDeclarationSync, r as BindingBundleState, u as BindingLazyChunkOutput, v as BindingTsconfigRawOptions, w as BindingViteManifestPluginConfig } from "./shared/binding-CVtkJvyl.mjs";
+import { $ as defineParallelPlugin, Gt as StringOrRegExp, I as BuiltinPlugin, Qt as freeExternalMemory, Vt as OutputOptions, Xt as RolldownOutput, l as InputOptions, ut as NormalizedOutputOptions } from "./shared/define-config-DSMNXceb.mjs";
+import { a as MinifyOptions$1, c as minifySync$1, d as parse$1, f as parseSync$1, i as transformSync$1, l as ParseResult$1, m as resolveTsconfig, n as TransformResult$1, o as MinifyResult$1, p as TsconfigCache$1, r as transform$1, s as minify$1, t as TransformOptions$1, u as ParserOptions$1 } from "./shared/transform-WmU_cI8e.mjs";
+import { a as viteDynamicImportVarsPlugin, c as viteLoadFallbackPlugin, d as viteReporterPlugin, f as viteResolvePlugin, i as viteBuildImportAnalysisPlugin, l as viteModulePreloadPolyfillPlugin, n as isolatedDeclarationPlugin, o as viteImportGlobPlugin, p as viteWebWorkerPostPlugin, r as oxcRuntimePlugin, s as viteJsonPlugin, u as viteReactRefreshWrapperPlugin } from "./shared/constructors-ALilxAii.mjs";
 //#region src/api/dev/dev-options.d.ts
 type DevOnHmrUpdates = (result: Error | {
   updates: BindingClientHmrUpdate[];
@@ -12,80 +11,87 @@ type DevOnOutput = (result: Error | RolldownOutput) => void | Promise<void>;
 type DevOnAdditionalAssets = (output: RolldownOutput) => void | Promise<void>;
 interface DevWatchOptions {
   /**
-  * If `true`, files are not written to disk.
-  * @default false
-  */
+   * If `false`, no file system watcher is started, so file changes are never
+   * picked up and no rebuild or HMR update is triggered on their own.
+   * @default true
+   */
+  enabled?: boolean;
+  /**
+   * If `true`, files are not written to disk.
+   * @default false
+   */
   skipWrite?: boolean;
   /**
-  * If `true`, use polling instead of native file system events for watching.
-  * @default false
-  */
+   * If `true`, use polling instead of native file system events for watching.
+   * @default false
+   */
   usePolling?: boolean;
   /**
-  * Poll interval in milliseconds (only used when usePolling is true).
-  * @default 100
-  */
+   * Poll interval in milliseconds (only used when usePolling is true).
+   * @default 100
+   */
   pollInterval?: number;
   /**
-  * If `true`, use debounced watcher. If `false`, use non-debounced watcher for immediate responses.
-  * @default true
-  */
+   * If `true`, use debounced watcher. If `false`, use non-debounced watcher for immediate responses.
+   * @default true
+   */
   useDebounce?: boolean;
   /**
-  * Debounce duration in milliseconds (only used when useDebounce is true).
-  * @default 10
-  */
+   * Debounce duration in milliseconds (only used when useDebounce is true).
+   * @default 10
+   */
   debounceDuration?: number;
   /**
-  * Whether to compare file contents for poll-based watchers (only used when usePolling is true).
-  * When enabled, poll watchers will check file contents to determine if they actually changed.
-  * @default false
-  */
+   * Whether to compare file contents for poll-based watchers (only used when usePolling is true).
+   * When enabled, poll watchers will check file contents to determine if they actually changed.
+   * @default false
+   */
   compareContentsForPolling?: boolean;
   /**
-  * Tick rate in milliseconds for debounced watchers (only used when useDebounce is true).
-  * Controls how frequently the debouncer checks for events to process.
-  * When not specified, the debouncer will auto-select an appropriate tick rate (1/4 of the debounce duration).
-  * @default undefined (auto-select)
-  */
+   * Tick rate in milliseconds for debounced watchers (only used when useDebounce is true).
+   * Controls how frequently the debouncer checks for events to process.
+   * When not specified, the debouncer will auto-select an appropriate tick rate (1/4 of the debounce duration).
+   * @default undefined (auto-select)
+   */
   debounceTickRate?: number;
   /**
-  * Filter to limit which discovered files are registered with the file watcher.
-  *
-  * Strings are treated as glob patterns.
-  *
-  * @default []
-  */
+   * Filter to limit which discovered files are registered with the file watcher.
+   *
+   * Strings are treated as glob patterns.
+   *
+   * @default []
+   */
   include?: StringOrRegExp | StringOrRegExp[];
   /**
-  * Filter to prevent discovered files from being registered with the file watcher.
-  *
-  * Strings are treated as glob patterns.
-  *
-  * @default []
-  */
+   * Filter to prevent discovered files from being registered with the file watcher.
+   *
+   * Strings are treated as glob patterns.
+   *
+   * @default []
+   */
   exclude?: StringOrRegExp | StringOrRegExp[];
 }
 interface DevOptions {
   onHmrUpdates?: DevOnHmrUpdates;
   onOutput?: DevOnOutput;
   /**
-  * Called with assets emitted while generating an HMR patch or compiling a
-  * lazy entry (e.g. an image newly imported by the changed/lazy module).
-  *
-  * These never go through {@link onOutput}, so a consumer that serves built
-  * files (e.g. Vite's bundled dev server) must register this to receive them
-  * and write them to its in-memory file store before the client requests them.
-  */
+   * Called with assets emitted while generating an HMR patch or compiling a
+   * lazy entry (e.g. an image newly imported by the changed/lazy module).
+   *
+   * These never go through {@link onOutput}, so a consumer that serves built
+   * files (e.g. Vite's bundled dev server) must register this to receive them
+   * and write them to its in-memory file store before the client requests them.
+   */
   onAdditionalAssets?: DevOnAdditionalAssets;
   /**
-  * Strategy for triggering rebuilds after HMR updates.
-  * - `'always'`: Always trigger a rebuild after HMR updates
-  * - `'auto'`: Trigger rebuild only if HMR updates contain full reload updates
-  * - `'never'`: Never trigger rebuild after HMR updates (default)
-  * @default 'auto'
-  */
-  rebuildStrategy?: "always" | "auto" | "never";
+   * Strategy for triggering rebuilds after HMR updates.
+   * - `'always'`: Always trigger a rebuild after HMR updates
+   * - `'never'`: Never trigger rebuild after HMR updates. The server no longer
+   *   decides full reloads, so there is no `'auto'` upgrade anymore; pull fresh
+   *   bundle output explicitly (e.g. `ensureLatestBuildOutput`) when needed.
+   * @default 'never'
+   */
+  rebuildStrategy?: "always" | "never";
   watch?: DevWatchOptions;
 }
 //#endregion
@@ -99,22 +105,31 @@ declare class DevEngine {
   getBundleState(): Promise<BindingBundleState>;
   ensureLatestBuildOutput(): Promise<void>;
   triggerFullBuild(): void;
-  invalidate(file: string, firstInvalidatedBy?: string): Promise<BindingClientHmrUpdate[]>;
-  registerModules(clientId: string, modules: string[]): Promise<void>;
+  /**
+   * Client-connect signal (the clientId hello): creates the per-client session
+   * with an empty ship map. Reconnects arrive as fresh clientIds.
+   */
+  registerClient(clientId: string): Promise<void>;
+  /**
+   * Delivery notification from the serving middleware: the response for
+   * `filename` completed, so record its modules as shipped to that client.
+   */
+  notifyPayloadDelivered(filename: string): Promise<void>;
   removeClient(clientId: string): Promise<void>;
   close(): Promise<void>;
   /**
-  * Compile a lazy entry module and return HMR-style patch code.
-  *
-  * This is called when a dynamically imported module is first requested at runtime.
-  * The module was previously stubbed with a proxy, and now we need to compile the
-  * actual module and its dependencies.
-  *
-  * @param moduleId - The absolute file path of the module to compile
-  * @param clientId - The client ID requesting this compilation
-  * @returns The compiled JavaScript code as a string (HMR patch format)
-  */
-  compileEntry(moduleId: string, clientId: string): Promise<string>;
+   * Compile a lazy entry module and return HMR-style patch code.
+   *
+   * This is called when a dynamically imported module is first requested at runtime.
+   * The module was previously stubbed with a proxy, and now we need to compile the
+   * actual module and its dependencies.
+   *
+   * @param moduleId - The absolute file path of the module to compile
+   * @param clientId - The client ID requesting this compilation
+   * @returns The compiled chunk: its code plus the filename whose delivery the
+   * serving middleware reports via {@link notifyPayloadDelivered}
+   */
+  compileEntry(moduleId: string, clientId: string): Promise<BindingLazyChunkOutput>;
 }
 //#endregion
 //#region src/api/dev/index.d.ts
@@ -122,20 +137,20 @@ declare const dev: typeof DevEngine.create;
 //#endregion
 //#region src/api/experimental.d.ts
 /**
-* This is an experimental API. Its behavior may change in the future.
-*
-* - Calling this API will only execute the `scan/build` stage of rolldown.
-* - `scan` will clean up all resources automatically, but if you want to ensure timely cleanup, you need to wait for the returned promise to resolve.
-*
-* @example To ensure cleanup of resources, use the returned promise to wait for the scan to complete.
-* ```ts
-* import { scan } from 'rolldown/api/experimental';
-*
-* const cleanupPromise = await scan(...);
-* await cleanupPromise;
-* // Now all resources have been cleaned up.
-* ```
-*/
+ * This is an experimental API. Its behavior may change in the future.
+ *
+ * - Calling this API will only execute the `scan/build` stage of rolldown.
+ * - `scan` will clean up all resources automatically, but if you want to ensure timely cleanup, you need to wait for the returned promise to resolve.
+ *
+ * @example To ensure cleanup of resources, use the returned promise to wait for the scan to complete.
+ * ```ts
+ * import { scan } from 'rolldown/api/experimental';
+ *
+ * const cleanupPromise = await scan(...);
+ * await cleanupPromise;
+ * // Now all resources have been cleaned up.
+ * ```
+ */
 declare const scan: (rawInputOptions: InputOptions, rawOutputOptions?: {}) => Promise<Promise<void>>;
 //#endregion
 //#region src/builtin-plugin/alias-plugin.d.ts
@@ -149,53 +164,53 @@ declare function viteAliasPlugin(config: ViteAliasPluginConfig): BuiltinPlugin;
 //#endregion
 //#region src/builtin-plugin/bundle-analyzer-plugin.d.ts
 /**
-* A plugin that analyzes bundle composition and generates detailed reports.
-*
-* The plugin outputs a file containing detailed information about:
-* - All chunks and their relationships
-* - Modules bundled in each chunk
-* - Import dependencies between chunks
-* - Reachable modules from each entry point
-*
-* @example
-* ```js
-* import { bundleAnalyzerPlugin } from 'rolldown/experimental';
-*
-* export default {
-*   plugins: [
-*     bundleAnalyzerPlugin()
-*   ]
-* }
-* ```
-*
-* @example
-* **Custom filename**
-* ```js
-* import { bundleAnalyzerPlugin } from 'rolldown/experimental';
-*
-* export default {
-*   plugins: [
-*     bundleAnalyzerPlugin({
-*       fileName: 'bundle-analysis.json'
-*     })
-*   ]
-* }
-* ```
-*
-* @example
-* **LLM-friendly markdown output**
-* ```js
-* import { bundleAnalyzerPlugin } from 'rolldown/experimental';
-*
-* export default {
-*   plugins: [
-*     bundleAnalyzerPlugin({
-*       format: 'md'
-*     })
-*   ]
-* }
-* ```
-*/
+ * A plugin that analyzes bundle composition and generates detailed reports.
+ *
+ * The plugin outputs a file containing detailed information about:
+ * - All chunks and their relationships
+ * - Modules bundled in each chunk
+ * - Import dependencies between chunks
+ * - Reachable modules from each entry point
+ *
+ * @example
+ * ```js
+ * import { bundleAnalyzerPlugin } from 'rolldown/experimental';
+ *
+ * export default {
+ *   plugins: [
+ *     bundleAnalyzerPlugin()
+ *   ]
+ * }
+ * ```
+ *
+ * @example
+ * **Custom filename**
+ * ```js
+ * import { bundleAnalyzerPlugin } from 'rolldown/experimental';
+ *
+ * export default {
+ *   plugins: [
+ *     bundleAnalyzerPlugin({
+ *       fileName: 'bundle-analysis.json'
+ *     })
+ *   ]
+ * }
+ * ```
+ *
+ * @example
+ * **LLM-friendly markdown output**
+ * ```js
+ * import { bundleAnalyzerPlugin } from 'rolldown/experimental';
+ *
+ * export default {
+ *   plugins: [
+ *     bundleAnalyzerPlugin({
+ *       format: 'md'
+ *     })
+ *   ]
+ * }
+ * ```
+ */
 declare function bundleAnalyzerPlugin(config?: BindingBundleAnalyzerPluginConfig): BuiltinPlugin;
 //#endregion
 //#region src/builtin-plugin/transform-plugin.d.ts
@@ -216,32 +231,32 @@ declare function viteManifestPlugin(config: ViteManifestPluginConfig): BuiltinPl
 //#endregion
 //#region src/experimental-index.d.ts
 /**
-* In-memory file system for browser builds.
-*
-* This is a re-export of the {@link https://github.com/streamich/memfs | memfs} package used by the WASI runtime.
-* It allows you to read and write files to a virtual filesystem when using rolldown in browser environments.
-*
-* - `fs`: A Node.js-compatible filesystem API (`IFs` from memfs)
-* - `volume`: The underlying `Volume` instance that stores the filesystem state
-*
-* Returns `undefined` in Node.js builds (only available in browser builds via `@rolldown/browser`).
-*
-* @example
-* ```typescript
-* import { memfs } from 'rolldown/experimental';
-*
-* // Write files to virtual filesystem before bundling
-* memfs?.volume.fromJSON({
-*   '/src/index.js': 'export const foo = 42;',
-*   '/package.json': '{"name": "my-app"}'
-* });
-*
-* // Read files from the virtual filesystem
-* const content = memfs?.fs.readFileSync('/src/index.js', 'utf8');
-* ```
-*
-* @see {@link https://github.com/streamich/memfs} for more information on the memfs API.
-*/
+ * In-memory file system for browser builds.
+ *
+ * This is a re-export of the {@link https://github.com/streamich/memfs | memfs} package used by the WASI runtime.
+ * It allows you to read and write files to a virtual filesystem when using rolldown in browser environments.
+ *
+ * - `fs`: A Node.js-compatible filesystem API (`IFs` from memfs)
+ * - `volume`: The underlying `Volume` instance that stores the filesystem state
+ *
+ * Returns `undefined` in Node.js builds (only available in browser builds via `@rolldown/browser`).
+ *
+ * @example
+ * ```typescript
+ * import { memfs } from 'rolldown/experimental';
+ *
+ * // Write files to virtual filesystem before bundling
+ * memfs?.volume.fromJSON({
+ *   '/src/index.js': 'export const foo = 42;',
+ *   '/package.json': '{"name": "my-app"}'
+ * });
+ *
+ * // Read files from the virtual filesystem
+ * const content = memfs?.fs.readFileSync('/src/index.js', 'utf8');
+ * ```
+ *
+ * @see {@link https://github.com/streamich/memfs} for more information on the memfs API.
+ */
 declare const memfs: {
   fs: any;
   volume: any;