@rolldown/browser 1.0.0-beta.9-commit.0ec9e7d → 1.0.0-rc.10

package/dist/experimental-index.d.mts

@@ -1,96 +1,256 @@
-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 { Tt as NormalizedOutputOptions, c as InputOptions, ln as freeExternalMemory, mt as defineParallelPlugin, sn as RolldownOutput, tn as OutputOptions } from "./shared/define-config-i6TWE2hm.mjs";
+import { t as BuiltinPlugin } from "./shared/utils-6wxe_LMG.mjs";
+import { a as transform$1, c as MinifyResult$2, d as ParseResult$3, f as ParserOptions$3, g as resolveTsconfig, h as TsconfigCache$2, i as TsconfigRawOptions$1, l as minify$1, m as parseSync$1, n as TransformResult$1, o as transformSync$1, p as parse$1, r as TsconfigCompilerOptions$1, s as MinifyOptions$2, t as TransformOptions$2, u as minifySync$1 } from "./shared/transform-DEgNAQOQ.mjs";
+import { a as viteDynamicImportVarsPlugin, c as viteLoadFallbackPlugin, d as viteReporterPlugin, f as viteResolvePlugin, i as viteBuildImportAnalysisPlugin, l as viteModulePreloadPolyfillPlugin, m as viteWebWorkerPostPlugin, n as isolatedDeclarationPlugin, o as viteImportGlobPlugin, p as viteWasmFallbackPlugin, r as oxcRuntimePlugin, s as viteJsonPlugin, u as viteReactRefreshWrapperPlugin } from "./shared/constructors-BVnf_fH1.mjs";
+import { BindingBundleAnalyzerPluginConfig, BindingViteManifestPluginConfig, BindingViteTransformPluginConfig } from "../binding.cjs";
+import { BindingBundleState, BindingClientHmrUpdate as BindingClientHmrUpdate$1 } from "../../binding.cjs";
+import { BindingClientHmrUpdate, BindingRebuildStrategy, IsolatedDeclarationsOptions, IsolatedDeclarationsResult, NapiResolveOptions as ResolveOptions, ResolveResult, ResolverFactory, isolatedDeclaration, isolatedDeclarationSync, moduleRunnerTransform } 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 stage of rolldown.
-*/
-/**
-* This is an experimental API. It's 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.
 *
-* Calling this API will only execute the scan stage of rolldown.
+* @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 experimental_scan: (input: InputOptions) => Promise<void>;
-
-//#endregion
-//#region src/utils/compose-js-plugins.d.ts
-declare function composeJsPlugins(plugins: RolldownPlugin[]): RolldownPlugin[];
-
+declare const scan: (rawInputOptions: InputOptions, rawOutputOptions?: {}) => Promise<Promise<void>>;
 //#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 aliasPlugin(config: AliasPluginConfig): BuiltinPlugin;
-
+declare function viteAliasPlugin(config: ViteAliasPluginConfig): BuiltinPlugin;
 //#endregion
-//#region src/builtin-plugin/replace-plugin.d.ts
+//#region src/builtin-plugin/bundle-analyzer-plugin.d.ts
 /**
-* Replaces targeted strings in files while bundling.
+* 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
-* // 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,
-* })
+* import { bundleAnalyzerPlugin } from 'rolldown/experimental';
+*
+* export default {
+*   plugins: [
+*     bundleAnalyzerPlugin()
+*   ]
+* }
 * ```
-*/
-/**
-* Replaces targeted strings in files while bundling.
 *
 * @example
-* // Basic usage
+* **Custom filename**
 * ```js
-* replacePlugin({
-*   'process.env.NODE_ENV': JSON.stringify('production'),
-*    __buildDate__: () => JSON.stringify(new Date()),
-*    __buildVersion: 15
-* })
+* import { bundleAnalyzerPlugin } from 'rolldown/experimental';
+*
+* export default {
+*   plugins: [
+*     bundleAnalyzerPlugin({
+*       fileName: 'bundle-analysis.json'
+*     })
+*   ]
+* }
 * ```
+*
 * @example
-* // With options
+* **LLM-friendly markdown output**
 * ```js
-* replacePlugin({
-*   'process.env.NODE_ENV': JSON.stringify('production'),
-*   __buildDate__: () => JSON.stringify(new Date()),
-*   __buildVersion: 15
-* }, {
-*   preventAssignment: false,
-* })
+* import { bundleAnalyzerPlugin } from 'rolldown/experimental';
+*
+* export default {
+*   plugins: [
+*     bundleAnalyzerPlugin({
+*       format: 'md'
+*     })
+*   ]
+* }
 * ```
 */
-declare function replacePlugin(values?: BindingReplacePluginConfig["values"], options?: Omit<BindingReplacePluginConfig, "values">): BuiltinPlugin;
-
+declare function bundleAnalyzerPlugin(config?: BindingBundleAnalyzerPluginConfig): 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
+type TransformPluginConfig = Omit<BindingViteTransformPluginConfig, "include" | "exclude" | "jsxRefreshInclude" | "jsxRefreshExclude" | "yarnPnp"> & {
+  include?: TransformPattern;
+  exclude?: TransformPattern;
+  jsxRefreshInclude?: TransformPattern;
+  jsxRefreshExclude?: TransformPattern;
 };
-declare function transformPlugin(config?: TransformPluginConfig): BuiltinPlugin;
-
+declare function viteTransformPlugin(config: TransformPluginConfig): BuiltinPlugin;
+//#endregion
+//#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
+/**
+* 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;
+} | undefined;
+/** @deprecated Use from `rolldown/utils` instead. */
+declare const parse: typeof parse$1;
+/** @deprecated Use from `rolldown/utils` instead. */
+declare const parseSync: typeof parseSync$1;
+/** @deprecated Use from `rolldown/utils` instead. */
+type ParseResult = ParseResult$3;
+/** @deprecated Use from `rolldown/utils` instead. */
+type ParserOptions = ParserOptions$3;
+/** @deprecated Use from `rolldown/utils` instead. */
+declare const minify: typeof minify$1;
+/** @deprecated Use from `rolldown/utils` instead. */
+declare const minifySync: typeof minifySync$1;
+/** @deprecated Use from `rolldown/utils` instead. */
+type MinifyOptions = MinifyOptions$2;
+/** @deprecated Use from `rolldown/utils` instead. */
+type MinifyResult = MinifyResult$2;
+/** @deprecated Use from `rolldown/utils` instead. */
+declare const transform: typeof transform$1;
+/** @deprecated Use from `rolldown/utils` instead. */
+declare const transformSync: typeof transformSync$1;
+/** @deprecated Use from `rolldown/utils` instead. */
+type TransformOptions = TransformOptions$2;
+/** @deprecated Use from `rolldown/utils` instead. */
+type TransformResult = TransformResult$1;
+/** @deprecated Use from `rolldown/utils` instead. */
+declare const TsconfigCache: typeof TsconfigCache$2;
+/** @deprecated Use from `rolldown/utils` instead. */
+type TsconfigRawOptions = TsconfigRawOptions$1;
+/** @deprecated Use from `rolldown/utils` instead. */
+type TsconfigCompilerOptions = TsconfigCompilerOptions$1;
 //#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, MinifyOptions, MinifyResult, ParseResult, ParserOptions, type ResolveOptions, type ResolveResult, ResolverFactory, TransformOptions, TransformResult, TsconfigCache, TsconfigCompilerOptions, TsconfigRawOptions, bundleAnalyzerPlugin, defineParallelPlugin, dev, viteDynamicImportVarsPlugin as dynamicImportVarsPlugin, viteDynamicImportVarsPlugin, freeExternalMemory, viteImportGlobPlugin as importGlobPlugin, viteImportGlobPlugin, isolatedDeclaration, isolatedDeclarationPlugin, isolatedDeclarationSync, memfs, minify, minifySync, moduleRunnerTransform, oxcRuntimePlugin, parse, parseSync, resolveTsconfig, scan, transform, transformSync, viteAliasPlugin, viteBuildImportAnalysisPlugin, viteJsonPlugin, viteLoadFallbackPlugin, viteManifestPlugin, viteModulePreloadPolyfillPlugin, viteReactRefreshWrapperPlugin, viteReporterPlugin, viteResolvePlugin, viteTransformPlugin, viteWasmFallbackPlugin, viteWebWorkerPostPlugin };