@rolldown/browser 1.0.0-beta.9-commit.ca4e9dd → 1.0.0-rc.1

package/dist/config.d.mts

@@ -1,11 +1,9 @@
-import { ConfigExport, defineConfig$1 as defineConfig } from "./shared/define-config.d-Dm9iNdt9.mjs";
+import { r as defineConfig, t as ConfigExport } from "./shared/define-config-CDlEOpr1.mjs";
 
 //#region src/utils/load-config.d.ts
 declare function loadConfig(configPath: string): Promise<ConfigExport>;
-
 //#endregion
 //#region src/config.d.ts
 declare const VERSION: string;
-
 //#endregion
 export { VERSION, defineConfig, loadConfig };

package/dist/config.mjs

@@ -1,10 +1,12 @@
-import { defineConfig, version } from "./shared/src-Cu4_wKhx.mjs";
-import "./shared/dist-CAn6dxW6.mjs";
-import "./shared/parse-ast-index-vu376yZ1.mjs";
-import { init_load_config, loadConfig } from "./shared/load-config-vRugYmJ3.mjs";
+import "./shared/normalize-string-or-regex-DIwprzLy.mjs";
+import { w as version } from "./shared/bindingify-input-options-Bp2kpiI8.mjs";
+import "./shared/rolldown-build-DLuUhuNw.mjs";
+import "./shared/parse-ast-index-2ahkCVK6.mjs";
+import "./shared/rolldown-C0_W0QdY.mjs";
+import { t as defineConfig } from "./shared/define-config-Dlptvz3X.mjs";
+import { t as loadConfig } from "./shared/load-config-BBZgIUGN.mjs";
 
 //#region src/config.ts
-init_load_config();
 const VERSION = version;
 
 //#endregion

package/dist/constructors-B8gqcrFr.js

@@ -0,0 +1,61 @@
+import { a as makeBuiltinPluginCallable, n as BuiltinPlugin, t as normalizedStringOrRegex } from "./normalize-string-or-regex-CL-PJZI7.js";
+
+//#region src/builtin-plugin/constructors.ts
+function viteModulePreloadPolyfillPlugin(config) {
+	return new BuiltinPlugin("builtin:vite-module-preload-polyfill", config);
+}
+function viteDynamicImportVarsPlugin(config) {
+	if (config) {
+		config.include = normalizedStringOrRegex(config.include);
+		config.exclude = normalizedStringOrRegex(config.exclude);
+	}
+	return new BuiltinPlugin("builtin:vite-dynamic-import-vars", config);
+}
+function viteImportGlobPlugin(config) {
+	return new BuiltinPlugin("builtin:vite-import-glob", config);
+}
+function viteReporterPlugin(config) {
+	return new BuiltinPlugin("builtin:vite-reporter", config);
+}
+function viteWasmHelperPlugin(config) {
+	return new BuiltinPlugin("builtin:vite-wasm-helper", config);
+}
+function viteWasmFallbackPlugin() {
+	return makeBuiltinPluginCallable(new BuiltinPlugin("builtin:vite-wasm-fallback"));
+}
+function viteLoadFallbackPlugin() {
+	return new BuiltinPlugin("builtin:vite-load-fallback");
+}
+function viteJsonPlugin(config) {
+	return makeBuiltinPluginCallable(new BuiltinPlugin("builtin:vite-json", config));
+}
+function viteBuildImportAnalysisPlugin(config) {
+	return new BuiltinPlugin("builtin:vite-build-import-analysis", config);
+}
+function viteResolvePlugin(config) {
+	return makeBuiltinPluginCallable(new BuiltinPlugin("builtin:vite-resolve", {
+		...config,
+		yarnPnp: typeof process === "object" && !!process.versions?.pnp
+	}));
+}
+function isolatedDeclarationPlugin(config) {
+	return new BuiltinPlugin("builtin:isolated-declaration", config);
+}
+function viteWebWorkerPostPlugin() {
+	return new BuiltinPlugin("builtin:vite-web-worker-post");
+}
+function esmExternalRequirePlugin(config) {
+	const plugin = new BuiltinPlugin("builtin:esm-external-require", config);
+	plugin.enforce = "pre";
+	return plugin;
+}
+function viteReactRefreshWrapperPlugin(config) {
+	if (config) {
+		config.include = normalizedStringOrRegex(config.include);
+		config.exclude = normalizedStringOrRegex(config.exclude);
+	}
+	return makeBuiltinPluginCallable(new BuiltinPlugin("builtin:vite-react-refresh-wrapper", config));
+}
+
+//#endregion
+export { viteImportGlobPlugin as a, viteModulePreloadPolyfillPlugin as c, viteResolvePlugin as d, viteWasmFallbackPlugin as f, viteDynamicImportVarsPlugin as i, viteReactRefreshWrapperPlugin as l, viteWebWorkerPostPlugin as m, isolatedDeclarationPlugin as n, viteJsonPlugin as o, viteWasmHelperPlugin as p, viteBuildImportAnalysisPlugin as r, viteLoadFallbackPlugin as s, esmExternalRequirePlugin as t, viteReporterPlugin as u };

package/dist/experimental-index.browser.mjs

@@ -1,17 +1,185 @@
-import { BuiltinPlugin, assetPlugin, buildImportAnalysisPlugin, composeJsPlugins, createBundler, dynamicImportVarsPlugin, handleOutputErrors, importGlobPlugin, isolatedDeclarationPlugin, jsonPlugin, loadFallbackPlugin, manifestPlugin, moduleFederationPlugin, modulePreloadPolyfillPlugin, normalizedStringOrRegex, reporterPlugin, viteResolvePlugin, wasmFallbackPlugin, wasmHelperPlugin, webWorkerPostPlugin } from "./src-DQ33eKZS.js";
-import { ResolverFactory, isolatedDeclaration, moduleRunnerTransform, transform } from "./rolldown-binding.wasi-browser.js";
+import { n as BuiltinPlugin, t as normalizedStringOrRegex } from "./normalize-string-or-regex-CL-PJZI7.js";
+import { a as unwrapBindingResult, c as transformToRollupOutput, i as normalizeBindingResult, l as validateOption, n as createBundlerOptions, o as parse, s as parseSync, t as RolldownBuild, u as PluginDriver } from "./rolldown-build-C4tDS_XC.js";
+import { a as viteImportGlobPlugin, c as viteModulePreloadPolyfillPlugin, d as viteResolvePlugin, f as viteWasmFallbackPlugin, i as viteDynamicImportVarsPlugin, l as viteReactRefreshWrapperPlugin, m as viteWebWorkerPostPlugin, n as isolatedDeclarationPlugin, o as viteJsonPlugin, p as viteWasmHelperPlugin, r as viteBuildImportAnalysisPlugin, s as viteLoadFallbackPlugin, u as viteReporterPlugin } from "./constructors-B8gqcrFr.js";
+import * as binding from "./rolldown-binding.wasi-browser.js";
+import { BindingBundler, BindingDevEngine, BindingRebuildStrategy, BindingRebuildStrategy as BindingRebuildStrategy$1, ResolverFactory, createTokioRuntime, isolatedDeclaration, isolatedDeclarationSync, minify, minifySync, moduleRunnerTransform, shutdownAsyncRuntime, startAsyncRuntime, transform, transformSync } from "./rolldown-binding.wasi-browser.js";
 
+//#region src/api/dev/dev-engine.ts
+var DevEngine = class DevEngine {
+	#inner;
+	#cachedBuildFinishPromise = null;
+	static async create(inputOptions, outputOptions = {}, devOptions = {}) {
+		inputOptions = await PluginDriver.callOptionsHook(inputOptions);
+		const options = await createBundlerOptions(inputOptions, outputOptions, false);
+		const userOnHmrUpdates = devOptions.onHmrUpdates;
+		const bindingOnHmrUpdates = userOnHmrUpdates ? function(rawResult) {
+			const result = normalizeBindingResult(rawResult);
+			if (result instanceof Error) {
+				userOnHmrUpdates(result);
+				return;
+			}
+			const [updates, changedFiles] = result;
+			userOnHmrUpdates({
+				updates,
+				changedFiles
+			});
+		} : void 0;
+		const userOnOutput = devOptions.onOutput;
+		const bindingDevOptions = {
+			onHmrUpdates: bindingOnHmrUpdates,
+			onOutput: userOnOutput ? function(rawResult) {
+				const result = normalizeBindingResult(rawResult);
+				if (result instanceof Error) {
+					userOnOutput(result);
+					return;
+				}
+				userOnOutput(transformToRollupOutput(result));
+			} : void 0,
+			rebuildStrategy: devOptions.rebuildStrategy ? devOptions.rebuildStrategy === "always" ? BindingRebuildStrategy$1.Always : devOptions.rebuildStrategy === "auto" ? BindingRebuildStrategy$1.Auto : BindingRebuildStrategy$1.Never : void 0,
+			watch: devOptions.watch && {
+				skipWrite: devOptions.watch.skipWrite,
+				usePolling: devOptions.watch.usePolling,
+				pollInterval: devOptions.watch.pollInterval,
+				useDebounce: devOptions.watch.useDebounce,
+				debounceDuration: devOptions.watch.debounceDuration,
+				compareContentsForPolling: devOptions.watch.compareContentsForPolling,
+				debounceTickRate: devOptions.watch.debounceTickRate
+			}
+		};
+		return new DevEngine(new BindingDevEngine(options.bundlerOptions, bindingDevOptions));
+	}
+	constructor(inner) {
+		this.#inner = inner;
+	}
+	async run() {
+		await this.#inner.run();
+	}
+	async ensureCurrentBuildFinish() {
+		if (this.#cachedBuildFinishPromise) return this.#cachedBuildFinishPromise;
+		const promise = this.#inner.ensureCurrentBuildFinish().then(() => {
+			this.#cachedBuildFinishPromise = null;
+		});
+		this.#cachedBuildFinishPromise = promise;
+		return promise;
+	}
+	async getBundleState() {
+		return this.#inner.getBundleState();
+	}
+	async ensureLatestBuildOutput() {
+		await this.#inner.ensureLatestBuildOutput();
+	}
+	async invalidate(file, firstInvalidatedBy) {
+		return this.#inner.invalidate(file, firstInvalidatedBy);
+	}
+	async registerModules(clientId, modules) {
+		await this.#inner.registerModules(clientId, modules);
+	}
+	async removeClient(clientId) {
+		await this.#inner.removeClient(clientId);
+	}
+	async close() {
+		await this.#inner.close();
+	}
+	/**
+	* 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)
+	*/
+	async compileEntry(moduleId, clientId) {
+		return this.#inner.compileEntry(moduleId, clientId);
+	}
+};
+
+//#endregion
+//#region src/api/dev/index.ts
+const dev = (...args) => DevEngine.create(...args);
+
+//#endregion
+//#region src/types/external-memory-handle.ts
+const symbolForExternalMemoryHandle = "__rolldown_external_memory_handle__";
+/**
+* Frees the external memory held by the given handle.
+*
+* This is useful when you want to manually release memory held by Rust objects
+* (like `OutputChunk` or `OutputAsset`) before they are garbage collected.
+*
+* @param handle - The object with external memory to free
+* @param keepDataAlive - If true, evaluates all lazy fields before freeing memory (default: false).
+*   This will take time to copy data from Rust to JavaScript, but prevents errors
+*   when accessing properties after the memory is freed.
+* @returns Status object with `freed` boolean and optional `reason` string.
+*   - `{ freed: true }` if memory was successfully freed
+*   - `{ freed: false, reason: "..." }` if memory couldn't be freed (e.g., already freed or other references exist)
+*
+* @example
+* ```typescript
+* import { freeExternalMemory } from 'rolldown/experimental';
+*
+* const output = await bundle.generate();
+* const chunk = output.output[0];
+*
+* // Use the chunk...
+*
+* // Manually free the memory (fast, but accessing properties after will throw)
+* const status = freeExternalMemory(chunk); // { freed: true }
+* const statusAgain = freeExternalMemory(chunk); // { freed: false, reason: "Memory has already been freed" }
+*
+* // Keep data alive before freeing (slower, but data remains accessible)
+* freeExternalMemory(chunk, true); // Evaluates all lazy fields first
+* console.log(chunk.code); // OK - data was copied to JavaScript before freeing
+*
+* // Without keepDataAlive, accessing chunk properties after freeing will throw an error
+* ```
+*/
+function freeExternalMemory(handle, keepDataAlive = false) {
+	return handle[symbolForExternalMemoryHandle](keepDataAlive);
+}
+
+//#endregion
 //#region src/api/experimental.ts
 /**
-* This is an experimental API. It's behavior may change in the future.
+* This is an experimental API. Its behavior may change in the future.
 *
-* Calling this API will only execute the scan stage of rolldown.
+* - 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.
+* ```
 */
-const experimental_scan = async (input) => {
-	const { bundler, stopWorkers } = await createBundler(input, {});
-	const output = await bundler.scan();
-	handleOutputErrors(output);
-	await stopWorkers?.();
+const scan = async (rawInputOptions, rawOutputOptions = {}) => {
+	validateOption("input", rawInputOptions);
+	validateOption("output", rawOutputOptions);
+	const ret = await createBundlerOptions(await PluginDriver.callOptionsHook(rawInputOptions), rawOutputOptions, false);
+	const bundler = new BindingBundler();
+	if (RolldownBuild.asyncRuntimeShutdown) startAsyncRuntime();
+	async function cleanup() {
+		await bundler.close();
+		await ret.stopWorkers?.();
+		shutdownAsyncRuntime();
+		RolldownBuild.asyncRuntimeShutdown = true;
+	}
+	let cleanupPromise = Promise.resolve();
+	try {
+		unwrapBindingResult(await bundler.scan(ret.bundlerOptions));
+	} catch (err) {
+		await cleanup();
+		throw err;
+	} finally {
+		cleanupPromise = cleanup();
+	}
+	return cleanupPromise;
 };
 
 //#endregion
@@ -22,55 +190,62 @@ function defineParallelPlugin(pluginPath) {
 
 //#endregion
 //#region src/builtin-plugin/alias-plugin.ts
-function aliasPlugin(config) {
-	return new BuiltinPlugin("builtin:alias", config);
-}
-
-//#endregion
-//#region src/builtin-plugin/replace-plugin.ts
-/**
-* Replaces targeted strings in files while bundling.
-*
-* @example
-* // Basic usage
-* ```js
-* replacePlugin({
-*   'process.env.NODE_ENV': JSON.stringify('production'),
-*    __buildDate__: () => JSON.stringify(new Date()),
-*    __buildVersion: 15
-* })
-* ```
-* @example
-* // With options
-* ```js
-* replacePlugin({
-*   'process.env.NODE_ENV': JSON.stringify('production'),
-*   __buildDate__: () => JSON.stringify(new Date()),
-*   __buildVersion: 15
-* }, {
-*   preventAssignment: false,
-* })
-* ```
-*/
-function replacePlugin(values = {}, options = {}) {
-	return new BuiltinPlugin("builtin:replace", {
-		...options,
-		values
-	});
+function viteAliasPlugin(config) {
+	return new BuiltinPlugin("builtin:vite-alias", config);
 }
 
 //#endregion
 //#region src/builtin-plugin/transform-plugin.ts
-function transformPlugin(config) {
-	if (config) config = {
+function viteTransformPlugin(config) {
+	return new BuiltinPlugin("builtin:vite-transform", {
 		...config,
 		include: normalizedStringOrRegex(config.include),
 		exclude: normalizedStringOrRegex(config.exclude),
 		jsxRefreshInclude: normalizedStringOrRegex(config.jsxRefreshInclude),
-		jsxRefreshExclude: normalizedStringOrRegex(config.jsxRefreshExclude)
-	};
-	return new BuiltinPlugin("builtin:transform", config);
+		jsxRefreshExclude: normalizedStringOrRegex(config.jsxRefreshExclude),
+		yarnPnp: typeof process === "object" && !!process.versions?.pnp
+	});
+}
+
+//#endregion
+//#region src/builtin-plugin/vite-manifest-plugin.ts
+function viteManifestPlugin(config) {
+	return new BuiltinPlugin("builtin:vite-manifest", config);
 }
 
 //#endregion
-export { ResolverFactory, aliasPlugin, assetPlugin, buildImportAnalysisPlugin, composeJsPlugins as composePlugins, defineParallelPlugin, dynamicImportVarsPlugin, importGlobPlugin, isolatedDeclaration, isolatedDeclarationPlugin, jsonPlugin, loadFallbackPlugin, manifestPlugin, moduleFederationPlugin, modulePreloadPolyfillPlugin, moduleRunnerTransform, replacePlugin, reporterPlugin, experimental_scan as scan, transform, transformPlugin, viteResolvePlugin, wasmFallbackPlugin, wasmHelperPlugin, webWorkerPostPlugin };
+//#region src/experimental-index.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.
+*/
+const memfs = {
+	fs: binding.__fs,
+	volume: binding.__volume
+};
+
+//#endregion
+export { BindingRebuildStrategy, DevEngine, ResolverFactory, createTokioRuntime, defineParallelPlugin, dev, viteDynamicImportVarsPlugin as dynamicImportVarsPlugin, viteDynamicImportVarsPlugin, freeExternalMemory, viteImportGlobPlugin as importGlobPlugin, viteImportGlobPlugin, isolatedDeclaration, isolatedDeclarationPlugin, isolatedDeclarationSync, memfs, minify, minifySync, moduleRunnerTransform, parse, parseSync, scan, transform, transformSync, viteAliasPlugin, viteBuildImportAnalysisPlugin, viteJsonPlugin, viteLoadFallbackPlugin, viteManifestPlugin, viteModulePreloadPolyfillPlugin, viteReactRefreshWrapperPlugin, viteReporterPlugin, viteResolvePlugin, viteTransformPlugin, viteWasmFallbackPlugin, viteWasmHelperPlugin, viteWebWorkerPostPlugin };

package/dist/experimental-index.d.mts

@@ -1,96 +1,184 @@
-import { BuiltinPlugin$1 as BuiltinPlugin, InputOptions, RolldownPlugin, assetPlugin$1 as assetPlugin, buildImportAnalysisPlugin$1 as buildImportAnalysisPlugin, defineParallelPlugin, dynamicImportVarsPlugin$1 as dynamicImportVarsPlugin, importGlobPlugin$1 as importGlobPlugin, isolatedDeclarationPlugin$1 as isolatedDeclarationPlugin, jsonPlugin$1 as jsonPlugin, loadFallbackPlugin$1 as loadFallbackPlugin, manifestPlugin$1 as manifestPlugin, moduleFederationPlugin$1 as moduleFederationPlugin, modulePreloadPolyfillPlugin$1 as modulePreloadPolyfillPlugin, reporterPlugin$1 as reporterPlugin, viteResolvePlugin$1 as viteResolvePlugin, wasmFallbackPlugin$1 as wasmFallbackPlugin, wasmHelperPlugin$1 as wasmHelperPlugin, webWorkerPostPlugin$1 as webWorkerPostPlugin } from "./shared/define-config.d-Dm9iNdt9.mjs";
-import { BindingReplacePluginConfig, BindingTransformPluginConfig, IsolatedDeclarationsOptions, IsolatedDeclarationsResult, NapiResolveOptions as ResolveOptions, ResolveResult, ResolverFactory, TransformOptions, TransformResult, isolatedDeclaration, moduleRunnerTransform, transform } from "./rolldown-binding.wasi.cjs";
+import { Ct as NormalizedOutputOptions, Zt as OutputOptions, an as freeExternalMemory, c as InputOptions, ft as defineParallelPlugin, rn as RolldownOutput } from "./shared/define-config-CDlEOpr1.mjs";
+import { t as BuiltinPlugin } from "./shared/utils-CqMTwlsR.mjs";
+import { a as viteImportGlobPlugin, c as viteModulePreloadPolyfillPlugin, d as viteResolvePlugin, f as viteWasmFallbackPlugin, i as viteDynamicImportVarsPlugin, l as viteReactRefreshWrapperPlugin, m as viteWebWorkerPostPlugin, n as isolatedDeclarationPlugin, o as viteJsonPlugin, p as viteWasmHelperPlugin, r as viteBuildImportAnalysisPlugin, s as viteLoadFallbackPlugin, u as viteReporterPlugin } from "./shared/constructors-5bt5oBhE.mjs";
+import { BindingViteManifestPluginConfig, BindingViteTransformPluginConfig, ParseResult as ParseResult$1, ParserOptions as ParserOptions$1 } from "../binding.cjs";
+import { BindingBundleState, BindingClientHmrUpdate as BindingClientHmrUpdate$1 } from "../../binding.cjs";
+import { BindingClientHmrUpdate, BindingRebuildStrategy, IsolatedDeclarationsOptions, IsolatedDeclarationsResult, MinifyOptions, MinifyResult, NapiResolveOptions as ResolveOptions, ParseResult, ParserOptions, ResolveResult, ResolverFactory, TransformOptions, TransformResult, createTokioRuntime, isolatedDeclaration, isolatedDeclarationSync, minify, minifySync, moduleRunnerTransform, transform, transformSync } from "./binding.cjs";
 
+//#region src/api/dev/dev-options.d.ts
+type DevOnHmrUpdates = (result: Error | {
+  updates: BindingClientHmrUpdate$1[];
+  changedFiles: string[];
+}) => void | Promise<void>;
+type DevOnOutput = (result: Error | RolldownOutput) => void | Promise<void>;
+interface DevWatchOptions {
+  /**
+  	* 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
+  	*/
+  usePolling?: boolean;
+  /**
+  	* 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
+  	*/
+  useDebounce?: boolean;
+  /**
+  	* 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
+  	*/
+  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)
+  	*/
+  debounceTickRate?: number;
+}
+interface DevOptions {
+  onHmrUpdates?: DevOnHmrUpdates;
+  onOutput?: DevOnOutput;
+  /**
+  	* 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";
+  watch?: DevWatchOptions;
+}
+//#endregion
+//#region src/api/dev/dev-engine.d.ts
+declare class DevEngine {
+  #private;
+  static create(inputOptions: InputOptions, outputOptions?: OutputOptions, devOptions?: DevOptions): Promise<DevEngine>;
+  private constructor();
+  run(): Promise<void>;
+  ensureCurrentBuildFinish(): Promise<void>;
+  getBundleState(): Promise<BindingBundleState>;
+  ensureLatestBuildOutput(): Promise<void>;
+  invalidate(file: string, firstInvalidatedBy?: string): Promise<BindingClientHmrUpdate$1[]>;
+  registerModules(clientId: string, modules: 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>;
+}
+//#endregion
+//#region src/api/dev/index.d.ts
+declare const dev: typeof DevEngine.create;
+//#endregion
 //#region src/api/experimental.d.ts
 /**
-* This is an experimental API. It's behavior may change in the future.
+* 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';
 *
-* Calling this API will only execute the scan stage of rolldown.
+* 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/utils/parse.d.ts
 /**
-* This is an experimental API. It's behavior may change in the future.
+* Parse asynchronously.
 *
-* Calling this API will only execute the scan stage of rolldown.
+* Note: This function can be slower than `parseSync` due to the overhead of spawning a thread.
 */
-declare const experimental_scan: (input: InputOptions) => Promise<void>;
-
-//#endregion
-//#region src/utils/compose-js-plugins.d.ts
-declare function composeJsPlugins(plugins: RolldownPlugin[]): RolldownPlugin[];
-
+declare function parse(filename: string, sourceText: string, options?: ParserOptions$1 | null): Promise<ParseResult$1>;
+/** Parse synchronously. */
+declare function parseSync(filename: string, sourceText: string, options?: ParserOptions$1 | null): ParseResult$1;
 //#endregion
 //#region src/builtin-plugin/alias-plugin.d.ts
-type AliasPluginAlias = {
-	find: string | RegExp
-	replacement: string
+type ViteAliasPluginConfig = {
+  entries: {
+    find: string | RegExp;
+    replacement: string;
+  }[];
 };
-type AliasPluginConfig = {
-	entries: AliasPluginAlias[]
+declare function viteAliasPlugin(config: ViteAliasPluginConfig): BuiltinPlugin;
+//#endregion
+//#region src/builtin-plugin/transform-plugin.d.ts
+type TransformPattern = string | RegExp | readonly (RegExp | string)[];
+type TransformPluginConfig = Omit<BindingViteTransformPluginConfig, "include" | "exclude" | "jsxRefreshInclude" | "jsxRefreshExclude" | "yarnPnp"> & {
+  include?: TransformPattern;
+  exclude?: TransformPattern;
+  jsxRefreshInclude?: TransformPattern;
+  jsxRefreshExclude?: TransformPattern;
 };
-declare function aliasPlugin(config: AliasPluginConfig): BuiltinPlugin;
-
+declare function viteTransformPlugin(config: TransformPluginConfig): BuiltinPlugin;
 //#endregion
-//#region src/builtin-plugin/replace-plugin.d.ts
+//#region src/builtin-plugin/vite-manifest-plugin.d.ts
+type ViteManifestPluginConfig = Omit<BindingViteManifestPluginConfig, "isLegacy"> & {
+  isOutputOptionsForLegacyChunks?: (outputOptions: NormalizedOutputOptions) => boolean;
+};
+declare function viteManifestPlugin(config: ViteManifestPluginConfig): BuiltinPlugin;
+//#endregion
+//#region src/experimental-index.d.ts
 /**
-* Replaces targeted strings in files while bundling.
+* In-memory file system for browser builds.
 *
-* @example
-* // Basic usage
-* ```js
-* replacePlugin({
-*   'process.env.NODE_ENV': JSON.stringify('production'),
-*    __buildDate__: () => JSON.stringify(new Date()),
-*    __buildVersion: 15
-* })
-* ```
-* @example
-* // With options
-* ```js
-* replacePlugin({
-*   'process.env.NODE_ENV': JSON.stringify('production'),
-*   __buildDate__: () => JSON.stringify(new Date()),
-*   __buildVersion: 15
-* }, {
-*   preventAssignment: false,
-* })
-* ```
-*/
-/**
-* Replaces targeted strings in files while bundling.
+* 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
-* // Basic usage
-* ```js
-* replacePlugin({
-*   'process.env.NODE_ENV': JSON.stringify('production'),
-*    __buildDate__: () => JSON.stringify(new Date()),
-*    __buildVersion: 15
-* })
-* ```
-* @example
-* // With options
-* ```js
-* replacePlugin({
-*   'process.env.NODE_ENV': JSON.stringify('production'),
-*   __buildDate__: () => JSON.stringify(new Date()),
-*   __buildVersion: 15
-* }, {
-*   preventAssignment: false,
-* })
+* ```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 function replacePlugin(values?: BindingReplacePluginConfig["values"], options?: Omit<BindingReplacePluginConfig, "values">): BuiltinPlugin;
-
-//#endregion
-//#region src/builtin-plugin/transform-plugin.d.ts
-type TransformPattern = string | RegExp | readonly (RegExp | string)[];
-type TransformPluginConfig = Omit<BindingTransformPluginConfig, "include" | "exclude" | "jsxRefreshInclude" | "jsxRefreshExclude"> & {
-	include?: TransformPattern
-	exclude?: TransformPattern
-	jsxRefreshInclude?: TransformPattern
-	jsxRefreshExclude?: TransformPattern
-};
-declare function transformPlugin(config?: TransformPluginConfig): BuiltinPlugin;
-
+declare const memfs: {
+  fs: any;
+  volume: any;
+} | undefined;
 //#endregion
-export { IsolatedDeclarationsOptions, IsolatedDeclarationsResult, ResolveOptions, ResolveResult, ResolverFactory, TransformOptions, TransformResult, aliasPlugin, assetPlugin, buildImportAnalysisPlugin, composeJsPlugins as composePlugins, defineParallelPlugin, dynamicImportVarsPlugin, importGlobPlugin, isolatedDeclaration, isolatedDeclarationPlugin, jsonPlugin, loadFallbackPlugin, manifestPlugin, moduleFederationPlugin, modulePreloadPolyfillPlugin, moduleRunnerTransform, replacePlugin, reporterPlugin, experimental_scan as scan, transform, transformPlugin, viteResolvePlugin, wasmFallbackPlugin, wasmHelperPlugin, webWorkerPostPlugin };
+export { type BindingClientHmrUpdate, BindingRebuildStrategy, DevEngine, type DevOptions, type DevWatchOptions, type IsolatedDeclarationsOptions, type IsolatedDeclarationsResult, type MinifyOptions, type MinifyResult, type ParseResult, type ParserOptions, type ResolveOptions, type ResolveResult, ResolverFactory, type TransformOptions, type TransformResult, createTokioRuntime, defineParallelPlugin, dev, viteDynamicImportVarsPlugin as dynamicImportVarsPlugin, viteDynamicImportVarsPlugin, freeExternalMemory, viteImportGlobPlugin as importGlobPlugin, viteImportGlobPlugin, isolatedDeclaration, isolatedDeclarationPlugin, isolatedDeclarationSync, memfs, minify, minifySync, moduleRunnerTransform, parse, parseSync, scan, transform, transformSync, viteAliasPlugin, viteBuildImportAnalysisPlugin, viteJsonPlugin, viteLoadFallbackPlugin, viteManifestPlugin, viteModulePreloadPolyfillPlugin, viteReactRefreshWrapperPlugin, viteReporterPlugin, viteResolvePlugin, viteTransformPlugin, viteWasmFallbackPlugin, viteWasmHelperPlugin, viteWebWorkerPostPlugin };