rolldown 1.1.5 → 1.2.0

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 { n as onExit, t as watch } from "./shared/watch-WnrlHRS0.mjs";
+import { S as version, x as description } from "./shared/bindingify-input-options-_ppP73I9.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 { a as getInputCliKeys, i as getCliSchemaInfo, l as styleText, o as getOutputCliKeys, r as logger, s as validateCliOptions } from "./shared/rolldown-build-CdF8HAHX.mjs";
+import { t as rolldown } from "./shared/rolldown-951h_1lf.mjs";
+import { t as loadConfig } from "./shared/load-config-C6UyiS41.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.140.0/helpers/esm/usingCtx.js
 function _usingCtx() {
 	var r = "function" == typeof SuppressedError ? SuppressedError : function(r, e) {
 		var n = Error();

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 { L as VERSION, r as defineConfig, t as ConfigExport } from "./shared/define-config-B-IDOhDz.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 { b as VERSION } from "./shared/bindingify-input-options-_ppP73I9.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-C6UyiS41.mjs";
 export { VERSION, defineConfig, loadConfig };

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-Dbbi0RbO.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-B-IDOhDz.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-Cs2bUDRH.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-CSWbNgBZ.mjs";
 //#region src/api/dev/dev-options.d.ts
 type DevOnHmrUpdates = (result: Error | {
   updates: BindingClientHmrUpdate[];
@@ -12,80 +11,81 @@ 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 `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 +99,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 +131,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 +158,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 +225,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;

package/dist/experimental-index.mjs

@@ -1,11 +1,11 @@
-import { n as __toESM, t as require_binding } from "./shared/binding-TuFFIE_J.mjs";
-import { n as BuiltinPlugin, t as normalizedStringOrRegex } from "./shared/normalize-string-or-regex-dnh67V_w.mjs";
-import { o as transformToRollupOutput } from "./shared/bindingify-input-options-XPJLJOD0.mjs";
-import { c as validateOption, n as createBundlerOptions, t as RolldownBuild, u as PluginDriver } from "./shared/rolldown-build-CtPvmZgJ.mjs";
-import { i as unwrapBindingResult, r as normalizeBindingResult } from "./shared/error-BHRSI0R7.mjs";
-import { n as parseSync$1, t as parse$1 } from "./shared/parse-D4dtlfWy.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-D_3i7dpX.mjs";
-import { a as minify$1, i as transformSync$1, n as resolveTsconfig, o as minifySync$1, r as transform$1, t as TsconfigCache$1 } from "./shared/resolve-tsconfig-DxqIJB3x.mjs";
+import { n as __toESM, t as require_binding } from "./shared/binding-Dby9rwGk.mjs";
+import { n as BuiltinPlugin, t as normalizedStringOrRegex } from "./shared/normalize-string-or-regex-SiXbePVH.mjs";
+import { o as transformToRollupOutput } from "./shared/bindingify-input-options-_ppP73I9.mjs";
+import { c as validateOption, n as createBundlerOptions, t as RolldownBuild, u as PluginDriver } from "./shared/rolldown-build-CdF8HAHX.mjs";
+import { i as unwrapBindingResult, r as normalizeBindingResult } from "./shared/error-DFGNOCle.mjs";
+import { n as parseSync$1, t as parse$1 } from "./shared/parse-BFj5G_7i.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-CuGa75s-.mjs";
+import { a as minify$1, i as transformSync$1, n as resolveTsconfig, o as minifySync$1, r as transform$1, t as TsconfigCache$1 } from "./shared/resolve-tsconfig-2TXRF_zr.mjs";
 import { pathToFileURL } from "node:url";
 //#region src/api/dev/dev-engine.ts
 var import_binding = /* @__PURE__ */ __toESM(require_binding(), 1);
@@ -44,7 +44,7 @@ var DevEngine = class DevEngine {
 			onAdditionalAssets: userOnAdditionalAssets ? function(output) {
 				userOnAdditionalAssets(transformToRollupOutput(output));
 			} : void 0,
-			rebuildStrategy: devOptions.rebuildStrategy ? devOptions.rebuildStrategy === "always" ? import_binding.BindingRebuildStrategy.Always : devOptions.rebuildStrategy === "auto" ? import_binding.BindingRebuildStrategy.Auto : import_binding.BindingRebuildStrategy.Never : void 0,
+			rebuildStrategy: devOptions.rebuildStrategy ? devOptions.rebuildStrategy === "always" ? import_binding.BindingRebuildStrategy.Always : import_binding.BindingRebuildStrategy.Never : void 0,
 			watch: devOptions.watch && {
 				skipWrite: devOptions.watch.skipWrite,
 				usePolling: devOptions.watch.usePolling,
@@ -83,11 +83,19 @@ var DevEngine = class DevEngine {
 	triggerFullBuild() {
 		this.#inner.triggerFullBuild();
 	}
-	async invalidate(file, firstInvalidatedBy) {
-		return unwrapBindingResult(await this.#inner.invalidate(file, firstInvalidatedBy));
+	/**
+	* Client-connect signal (the clientId hello): creates the per-client session
+	* with an empty ship map. Reconnects arrive as fresh clientIds.
+	*/
+	async registerClient(clientId) {
+		await this.#inner.registerClient(clientId);
 	}
-	async registerModules(clientId, modules) {
-		await this.#inner.registerModules(clientId, modules);
+	/**
+	* Delivery notification from the serving middleware: the response for
+	* `filename` completed, so record its modules as shipped to that client.
+	*/
+	async notifyPayloadDelivered(filename) {
+		await this.#inner.notifyPayloadDelivered(filename);
 	}
 	async removeClient(clientId) {
 		await this.#inner.removeClient(clientId);
@@ -104,7 +112,8 @@ var DevEngine = class DevEngine {
 	*
 	* @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)
+	* @returns The compiled chunk: its code plus the filename whose delivery the
+	* serving middleware reports via {@link notifyPayloadDelivered}
 	*/
 	async compileEntry(moduleId, clientId) {
 		return this.#inner.compileEntry(moduleId, clientId);