@moku-labs/worker 0.8.0 → 0.8.1

package/dist/{cli-By06KF-9.mjs → cli-DNW8_355.mjs}

@@ -1701,7 +1701,8 @@ const buildSite = async (ctx, webBuild) => {
 * @file deploy plugin — debounced filesystem watcher for dev.
 *
 * Watches the top-level directories implied by the config globs (recursive) and fires a debounced
-* change callback with the last changed path. Uses node:fs.watch — no extra dependency.
+* change callback with the SET of paths changed in the window (so a burst of edits coalesces into
+* one rebuild that knows every changed file). Uses node:fs.watch — no extra dependency.
 * Node-only; never imported by the runtime Worker bundle.
 */
 /**
@@ -1724,27 +1725,29 @@ const watchDirectories = (globs) => {
 	return [...directories];
 };
 /**
-* Watch the directories implied by `globs` and fire `onChange` (debounced by `debounceMs`) with
-* the last changed path. Missing directories are skipped silently.
+* Watch the directories implied by `globs` and fire `onChange` (debounced by `debounceMs`) with the
+* distinct set of paths changed within the window. Missing directories are skipped silently.
 *
 * @param globs - Watch globs.
 * @param debounceMs - Coalesce rapid changes into one callback within this window.
-* @param onChange - Called with the last changed path after the debounce settles.
+* @param onChange - Called with the changed paths (snapshot of the window) after the debounce settles.
 * @returns A handle whose close() stops all watchers and cancels any pending callback.
 * @example
 * ```ts
-* const handle = watchPaths(["src/**\/*.ts"], 120, p => rebuild(p));
+* const handle = watchPaths(["src/**\/*.ts"], 120, paths => rebuild(paths));
 * handle.close();
 * ```
 */
 const watchPaths = (globs, debounceMs, onChange) => {
 	let timer;
-	let lastPath = "";
+	const changed = /* @__PURE__ */ new Set();
 	const fire = (changedPath) => {
-		lastPath = changedPath;
+		changed.add(changedPath);
 		if (timer !== void 0) clearTimeout(timer);
 		timer = setTimeout(() => {
-			onChange(lastPath);
+			const batch = [...changed];
+			changed.clear();
+			onChange(batch);
 		}, debounceMs);
 	};
 	const watchers = [];
@@ -1874,27 +1877,50 @@ const realDevDeps = () => ({
 */
 const d1MigrationBindings = (ctx) => ctx.has("d1") ? ctx.require(d1Plugin).deployManifest().filter((manifest) => manifest.migrations !== void 0).map((manifest) => manifest.binding) : [];
 /**
-* Rebuild the site once and announce the result. A failed build keeps the session alive (it just
-* emits dev:error and serves the last good build).
+* One-line description of a changed-path batch for the `dev:phase rebuild` detail: the single path,
+* or the first path plus a `(+N more)` tail. Empty batches (defensive) read as "site".
+*
+* @param paths - The changed paths the watcher coalesced for this rebuild.
+* @returns The detail string for the rebuild phase event.
+* @example
+* ```ts
+* describeChanges(["src/a.ts", "src/b.css"]); // "src/a.ts (+1 more)"
+* ```
+*/
+const describeChanges = (paths) => {
+	const [first, ...rest] = paths;
+	if (first === void 0) return "site";
+	return rest.length === 0 ? first : `${first} (+${String(rest.length)} more)`;
+};
+/**
+* Rebuild the site once for a changed-path batch and announce the result. The FAST path is the
+* incremental `onChange(changedPaths)` hook (e.g. `web.cli.update`) when wired; otherwise it falls
+* back to a full `webBuild()` rebuild (via deps.build) — the prior behavior. A failed rebuild keeps
+* the session alive (it just emits dev:error and serves the last good build). Both paths share one
+* `dev:phase rebuild` → `dev:rebuilt`/`dev:error` envelope so the branded dev TUI is identical.
 *
 * @param ctx - The deploy plugin context.
 * @param deps - The injected dev deps.
-* @param changedPath - The path that triggered the rebuild.
-* @param webBuild - Optional call-time web build hook threaded into the rebuild.
+* @param changedPaths - The paths that triggered the rebuild (the watcher's debounced set).
+* @param hooks - The consumer rebuild hooks.
+* @param hooks.webBuild - Full rebuild (used when `onChange` is absent — the prior behavior).
+* @param hooks.onChange - Incremental rebuild for the changed set (the fast path when wired).
 * @returns Resolves once the rebuild attempt completes.
 * @example
 * ```ts
-* await rebuild(ctx, deps, "src/app.tsx", () => web.cli.build());
+* await rebuild(ctx, deps, ["src/app.tsx"], { onChange: c => web.cli.update(c) });
 * ```
 */
-const rebuild = async (ctx, deps, changedPath, webBuild) => {
+const rebuild = async (ctx, deps, changedPaths, hooks) => {
 	ctx.emit("dev:phase", {
 		phase: "rebuild",
-		detail: changedPath
+		detail: describeChanges(changedPaths)
 	});
 	const started = deps.now();
 	try {
-		const { files } = await deps.build(ctx, webBuild);
+		let files;
+		if (hooks.onChange) files = fileCountOf(await hooks.onChange(changedPaths));
+		else files = (await deps.build(ctx, hooks.webBuild)).files;
 		ctx.emit("dev:rebuilt", {
 			files,
 			ms: deps.now() - started
@@ -1910,17 +1936,20 @@ const rebuild = async (ctx, deps, changedPath, webBuild) => {
 * @param ctx - The deploy plugin context (config + emit + require/has).
 * @param opts - Optional options.
 * @param opts.port - Local dev port (default 8787).
-* @param opts.webBuild - Web build hook (re)run on cold build + each change (e.g. `() => web.cli.build()`).
+* @param opts.webBuild - Cold-build hook (also the per-change rebuild when `onChange` is omitted).
+* @param opts.onChange - Incremental per-change rebuild hook (e.g. `c => web.cli.update(c)`); when
+*   set, each debounced change rebuilds only the changed paths instead of a full `webBuild()`.
 * @param deps - Injected side effects (real ones from realDevDeps in production).
 * @returns Resolves when the session ends (SIGINT).
 * @example
 * ```ts
-* await runDev(ctx, { port: 8787, webBuild: () => web.cli.build() }, realDevDeps());
+* await runDev(ctx, { port: 8787, webBuild: () => web.cli.build(), onChange: c => web.cli.update(c) }, realDevDeps());
 * ```
 */
 const runDev = async (ctx, opts, deps) => {
 	const port = opts?.port ?? 8787;
 	const webBuild = opts?.webBuild;
+	const onChange = opts?.onChange;
 	ctx.emit("dev:phase", {
 		phase: "build",
 		detail: "site"
@@ -1952,7 +1981,10 @@ const runDev = async (ctx, opts, deps) => {
 		ctx.config.configFile,
 		"--live-reload"
 	]);
-	const watcher = deps.watch(ctx.config.watch, ctx.config.debounceMs, (changedPath) => rebuild(ctx, deps, changedPath, webBuild));
+	const watcher = deps.watch(ctx.config.watch, ctx.config.debounceMs, (changedPaths) => rebuild(ctx, deps, changedPaths, {
+		webBuild,
+		onChange
+	}));
 	await Promise.race([deps.untilSignal(), child.whenExited]);
 	ctx.emit("dev:phase", { phase: "stopping" });
 	watcher.close();
@@ -3225,11 +3257,13 @@ const createDeployApi = (ctx) => ({
 	* @param opts - Optional options.
 	* @param opts.port - Local dev port (default 8787).
 	* @param opts.stage - Stage for the generated config's resource names (defaults to the app stage).
-	* @param opts.webBuild - Rebuild the web site on change (e.g. `() => webApp.cli.build()`).
+	* @param opts.webBuild - Cold-build the web site (e.g. `() => webApp.cli.build()`); also the
+	*   per-change rebuild when `onChange` is omitted.
+	* @param opts.onChange - Incremental per-change rebuild (e.g. `changes => webApp.cli.update(changes)`).
 	* @returns Resolves when the dev session ends.
 	* @example
 	* ```ts
-	* await api.dev({ port: 8787, webBuild: () => web.cli.build() });
+	* await api.dev({ port: 8787, webBuild: () => web.cli.build(), onChange: c => web.cli.update(c) });
 	* ```
 	*/
 	async dev(opts) {
@@ -3482,11 +3516,14 @@ const createCliApi = (ctx) => ({
 	* @param opts - Optional local dev options.
 	* @param opts.port - Local dev port to bind. Defaults to 8787 when omitted.
 	* @param opts.stage - Stage for the generated wrangler config; falls back to `--stage` then the app stage.
-	* @param opts.webBuild - Rebuild the web site on change (e.g. `() => webApp.cli.build()`).
+	* @param opts.webBuild - Cold-build the web site (e.g. `() => webApp.cli.build()`); also the
+	*   per-change rebuild when `onChange` is omitted.
+	* @param opts.onChange - Incremental per-change rebuild (e.g. `changes => webApp.cli.update(changes)`),
+	*   so each change rebuilds only the changed paths instead of a full `webBuild()`.
 	* @returns Resolves when the dev session ends.
 	* @example
 	* ```ts
-	* await api.dev({ port: 7878, webBuild: () => web.cli.build() });
+	* await api.dev({ port: 7878, webBuild: () => web.cli.build(), onChange: c => web.cli.update(c) });
 	* ```
 	*/
 	async dev(opts) {
@@ -3500,7 +3537,8 @@ const createCliApi = (ctx) => ({
 			await ctx.require(deployPlugin).dev({
 				...opts?.port === void 0 ? {} : { port: opts.port },
 				...stage === void 0 ? {} : { stage },
-				...opts?.webBuild ? { webBuild: opts.webBuild } : {}
+				...opts?.webBuild ? { webBuild: opts.webBuild } : {},
+				...opts?.onChange ? { onChange: opts.onChange } : {}
 			});
 			ui.check(true, "dev session stopped cleanly");
 		} catch (error) {

package/dist/{cli-DkoPBbJC.cjs → cli-l-AOWzhR.cjs}

@@ -1724,7 +1724,8 @@ const buildSite = async (ctx, webBuild) => {
 * @file deploy plugin — debounced filesystem watcher for dev.
 *
 * Watches the top-level directories implied by the config globs (recursive) and fires a debounced
-* change callback with the last changed path. Uses node:fs.watch — no extra dependency.
+* change callback with the SET of paths changed in the window (so a burst of edits coalesces into
+* one rebuild that knows every changed file). Uses node:fs.watch — no extra dependency.
 * Node-only; never imported by the runtime Worker bundle.
 */
 /**
@@ -1747,27 +1748,29 @@ const watchDirectories = (globs) => {
 	return [...directories];
 };
 /**
-* Watch the directories implied by `globs` and fire `onChange` (debounced by `debounceMs`) with
-* the last changed path. Missing directories are skipped silently.
+* Watch the directories implied by `globs` and fire `onChange` (debounced by `debounceMs`) with the
+* distinct set of paths changed within the window. Missing directories are skipped silently.
 *
 * @param globs - Watch globs.
 * @param debounceMs - Coalesce rapid changes into one callback within this window.
-* @param onChange - Called with the last changed path after the debounce settles.
+* @param onChange - Called with the changed paths (snapshot of the window) after the debounce settles.
 * @returns A handle whose close() stops all watchers and cancels any pending callback.
 * @example
 * ```ts
-* const handle = watchPaths(["src/**\/*.ts"], 120, p => rebuild(p));
+* const handle = watchPaths(["src/**\/*.ts"], 120, paths => rebuild(paths));
 * handle.close();
 * ```
 */
 const watchPaths = (globs, debounceMs, onChange) => {
 	let timer;
-	let lastPath = "";
+	const changed = /* @__PURE__ */ new Set();
 	const fire = (changedPath) => {
-		lastPath = changedPath;
+		changed.add(changedPath);
 		if (timer !== void 0) clearTimeout(timer);
 		timer = setTimeout(() => {
-			onChange(lastPath);
+			const batch = [...changed];
+			changed.clear();
+			onChange(batch);
 		}, debounceMs);
 	};
 	const watchers = [];
@@ -1897,27 +1900,50 @@ const realDevDeps = () => ({
 */
 const d1MigrationBindings = (ctx) => ctx.has("d1") ? ctx.require(d1Plugin).deployManifest().filter((manifest) => manifest.migrations !== void 0).map((manifest) => manifest.binding) : [];
 /**
-* Rebuild the site once and announce the result. A failed build keeps the session alive (it just
-* emits dev:error and serves the last good build).
+* One-line description of a changed-path batch for the `dev:phase rebuild` detail: the single path,
+* or the first path plus a `(+N more)` tail. Empty batches (defensive) read as "site".
+*
+* @param paths - The changed paths the watcher coalesced for this rebuild.
+* @returns The detail string for the rebuild phase event.
+* @example
+* ```ts
+* describeChanges(["src/a.ts", "src/b.css"]); // "src/a.ts (+1 more)"
+* ```
+*/
+const describeChanges = (paths) => {
+	const [first, ...rest] = paths;
+	if (first === void 0) return "site";
+	return rest.length === 0 ? first : `${first} (+${String(rest.length)} more)`;
+};
+/**
+* Rebuild the site once for a changed-path batch and announce the result. The FAST path is the
+* incremental `onChange(changedPaths)` hook (e.g. `web.cli.update`) when wired; otherwise it falls
+* back to a full `webBuild()` rebuild (via deps.build) — the prior behavior. A failed rebuild keeps
+* the session alive (it just emits dev:error and serves the last good build). Both paths share one
+* `dev:phase rebuild` → `dev:rebuilt`/`dev:error` envelope so the branded dev TUI is identical.
 *
 * @param ctx - The deploy plugin context.
 * @param deps - The injected dev deps.
-* @param changedPath - The path that triggered the rebuild.
-* @param webBuild - Optional call-time web build hook threaded into the rebuild.
+* @param changedPaths - The paths that triggered the rebuild (the watcher's debounced set).
+* @param hooks - The consumer rebuild hooks.
+* @param hooks.webBuild - Full rebuild (used when `onChange` is absent — the prior behavior).
+* @param hooks.onChange - Incremental rebuild for the changed set (the fast path when wired).
 * @returns Resolves once the rebuild attempt completes.
 * @example
 * ```ts
-* await rebuild(ctx, deps, "src/app.tsx", () => web.cli.build());
+* await rebuild(ctx, deps, ["src/app.tsx"], { onChange: c => web.cli.update(c) });
 * ```
 */
-const rebuild = async (ctx, deps, changedPath, webBuild) => {
+const rebuild = async (ctx, deps, changedPaths, hooks) => {
 	ctx.emit("dev:phase", {
 		phase: "rebuild",
-		detail: changedPath
+		detail: describeChanges(changedPaths)
 	});
 	const started = deps.now();
 	try {
-		const { files } = await deps.build(ctx, webBuild);
+		let files;
+		if (hooks.onChange) files = fileCountOf(await hooks.onChange(changedPaths));
+		else files = (await deps.build(ctx, hooks.webBuild)).files;
 		ctx.emit("dev:rebuilt", {
 			files,
 			ms: deps.now() - started
@@ -1933,17 +1959,20 @@ const rebuild = async (ctx, deps, changedPath, webBuild) => {
 * @param ctx - The deploy plugin context (config + emit + require/has).
 * @param opts - Optional options.
 * @param opts.port - Local dev port (default 8787).
-* @param opts.webBuild - Web build hook (re)run on cold build + each change (e.g. `() => web.cli.build()`).
+* @param opts.webBuild - Cold-build hook (also the per-change rebuild when `onChange` is omitted).
+* @param opts.onChange - Incremental per-change rebuild hook (e.g. `c => web.cli.update(c)`); when
+*   set, each debounced change rebuilds only the changed paths instead of a full `webBuild()`.
 * @param deps - Injected side effects (real ones from realDevDeps in production).
 * @returns Resolves when the session ends (SIGINT).
 * @example
 * ```ts
-* await runDev(ctx, { port: 8787, webBuild: () => web.cli.build() }, realDevDeps());
+* await runDev(ctx, { port: 8787, webBuild: () => web.cli.build(), onChange: c => web.cli.update(c) }, realDevDeps());
 * ```
 */
 const runDev = async (ctx, opts, deps) => {
 	const port = opts?.port ?? 8787;
 	const webBuild = opts?.webBuild;
+	const onChange = opts?.onChange;
 	ctx.emit("dev:phase", {
 		phase: "build",
 		detail: "site"
@@ -1975,7 +2004,10 @@ const runDev = async (ctx, opts, deps) => {
 		ctx.config.configFile,
 		"--live-reload"
 	]);
-	const watcher = deps.watch(ctx.config.watch, ctx.config.debounceMs, (changedPath) => rebuild(ctx, deps, changedPath, webBuild));
+	const watcher = deps.watch(ctx.config.watch, ctx.config.debounceMs, (changedPaths) => rebuild(ctx, deps, changedPaths, {
+		webBuild,
+		onChange
+	}));
 	await Promise.race([deps.untilSignal(), child.whenExited]);
 	ctx.emit("dev:phase", { phase: "stopping" });
 	watcher.close();
@@ -3248,11 +3280,13 @@ const createDeployApi = (ctx) => ({
 	* @param opts - Optional options.
 	* @param opts.port - Local dev port (default 8787).
 	* @param opts.stage - Stage for the generated config's resource names (defaults to the app stage).
-	* @param opts.webBuild - Rebuild the web site on change (e.g. `() => webApp.cli.build()`).
+	* @param opts.webBuild - Cold-build the web site (e.g. `() => webApp.cli.build()`); also the
+	*   per-change rebuild when `onChange` is omitted.
+	* @param opts.onChange - Incremental per-change rebuild (e.g. `changes => webApp.cli.update(changes)`).
 	* @returns Resolves when the dev session ends.
 	* @example
 	* ```ts
-	* await api.dev({ port: 8787, webBuild: () => web.cli.build() });
+	* await api.dev({ port: 8787, webBuild: () => web.cli.build(), onChange: c => web.cli.update(c) });
 	* ```
 	*/
 	async dev(opts) {
@@ -3505,11 +3539,14 @@ const createCliApi = (ctx) => ({
 	* @param opts - Optional local dev options.
 	* @param opts.port - Local dev port to bind. Defaults to 8787 when omitted.
 	* @param opts.stage - Stage for the generated wrangler config; falls back to `--stage` then the app stage.
-	* @param opts.webBuild - Rebuild the web site on change (e.g. `() => webApp.cli.build()`).
+	* @param opts.webBuild - Cold-build the web site (e.g. `() => webApp.cli.build()`); also the
+	*   per-change rebuild when `onChange` is omitted.
+	* @param opts.onChange - Incremental per-change rebuild (e.g. `changes => webApp.cli.update(changes)`),
+	*   so each change rebuilds only the changed paths instead of a full `webBuild()`.
 	* @returns Resolves when the dev session ends.
 	* @example
 	* ```ts
-	* await api.dev({ port: 7878, webBuild: () => web.cli.build() });
+	* await api.dev({ port: 7878, webBuild: () => web.cli.build(), onChange: c => web.cli.update(c) });
 	* ```
 	*/
 	async dev(opts) {
@@ -3523,7 +3560,8 @@ const createCliApi = (ctx) => ({
 			await ctx.require(deployPlugin).dev({
 				...opts?.port === void 0 ? {} : { port: opts.port },
 				...stage === void 0 ? {} : { stage },
-				...opts?.webBuild ? { webBuild: opts.webBuild } : {}
+				...opts?.webBuild ? { webBuild: opts.webBuild } : {},
+				...opts?.onChange ? { onChange: opts.onChange } : {}
 			});
 			ui.check(true, "dev session stopped cleanly");
 		} catch (error) {

package/dist/cli.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_cli = require("./cli-DkoPBbJC.cjs");
+const require_cli = require("./cli-l-AOWzhR.cjs");
 exports.cliPlugin = require_cli.cliPlugin;
 exports.deployPlugin = require_cli.deployPlugin;

package/dist/cli.d.cts

@@ -1,2 +1,2 @@
-import { i as ResourceManifest, n as cliPlugin, r as ExternalManifest, t as deployPlugin } from "./index-BuY9o1u0.cjs";
+import { i as ResourceManifest, n as cliPlugin, r as ExternalManifest, t as deployPlugin } from "./index-BDkgen4r.cjs";
 export { type ExternalManifest, type ResourceManifest, cliPlugin, deployPlugin };

package/dist/cli.d.mts

@@ -1,2 +1,2 @@
-import { i as ResourceManifest, n as cliPlugin, r as ExternalManifest, t as deployPlugin } from "./index-BuY9o1u0.mjs";
+import { i as ResourceManifest, n as cliPlugin, r as ExternalManifest, t as deployPlugin } from "./index-BDkgen4r.mjs";
 export { type ExternalManifest, type ResourceManifest, cliPlugin, deployPlugin };

package/dist/cli.mjs

@@ -1,2 +1,2 @@
-import { n as deployPlugin, t as cliPlugin } from "./cli-By06KF-9.mjs";
+import { n as deployPlugin, t as cliPlugin } from "./cli-DNW8_355.mjs";
 export { cliPlugin, deployPlugin };

package/dist/{index-BuY9o1u0.d.cts → index-BDkgen4r.d.cts}

@@ -102,6 +102,23 @@ type WorkerPluginCtx<Config, State, Events extends Record<string, unknown> = Rec
  * ```
  */
 type WebBuild = () => Promise<unknown>;
+/**
+ * A per-change INCREMENTAL rebuild hook wired in from the consumer's dev script — e.g.
+ * `(changes) => webApp.cli.update(changes)`. The fast counterpart to {@link WebBuild}: `dev`
+ * calls {@link WebBuild} ONCE for the cold build, then (when this hook is wired) calls `onChange`
+ * with the set of paths changed in the debounce window so the web build can rebuild only what
+ * changed instead of doing a full `webBuild()` every keystroke. Omit it and `dev` keeps doing a
+ * full `webBuild()` per change (the prior behavior). Like {@link WebBuild} it may resolve ANYTHING
+ * (the web build's own summary); the value is read opportunistically for a `files` count.
+ *
+ * @param changes - The paths changed since the last rebuild (the watcher's debounced set).
+ * @returns Resolves when the incremental rebuild completes.
+ * @example
+ * ```ts
+ * await server.cli.dev({ webBuild: () => web.cli.build(), onChange: changes => web.cli.update(changes) });
+ * ```
+ */
+type OnChange = (changes: readonly string[]) => Promise<unknown>;
 /** deploy plugin configuration. Flat; complete defaults so omission never yields undefined. */
 type Config$1 = {
   /**
@@ -268,22 +285,26 @@ type Api = {
    * when omitted. A failure renders a branded `✗` line and sets a non-zero exit code rather than
    * throwing a raw stack trace.
    *
-   * @param opts - Optional port, stage, and web build hook.
+   * @param opts - Optional port, stage, cold-build hook, and incremental change hook.
    * @param opts.port - Local dev port to bind. Defaults to 8787 when omitted.
    * @param opts.stage - Stage for the generated wrangler config's resource names. Falls back to the
    *   `--stage` CLI flag, then the app's configured stage. Pass it explicitly from a script for a
    *   self-documenting `dev({ stage })` instead of relying on the hidden flag.
-   * @param opts.webBuild - Rebuild the web site on change (e.g. `() => webApp.cli.build()`).
+   * @param opts.webBuild - Cold-build the web site (e.g. `() => webApp.cli.build()`); also the
+   *   per-change rebuild when `onChange` is omitted.
+   * @param opts.onChange - Incremental per-change rebuild (e.g. `changes => webApp.cli.update(changes)`),
+   *   so each change rebuilds only the changed paths instead of a full `webBuild()` every keystroke.
    * @returns Resolves when the dev session ends.
    * @example
    * ```ts
-   * await app.cli.dev({ stage: "dev", port: 7878, webBuild: () => web.cli.build() });
+   * await app.cli.dev({ stage: "dev", port: 7878, webBuild: () => web.cli.build(), onChange: c => web.cli.update(c) });
    * ```
    */
   dev(opts?: {
     port?: number;
     stage?: string;
     webBuild?: WebBuild;
+    onChange?: OnChange;
   }): Promise<void>;
   /**
    * One-command Cloudflare deploy (delegates to deploy.run). Guided/interactive by default; pass
@@ -415,6 +436,7 @@ declare const deployPlugin: import("@moku-labs/core").PluginInstance<"deploy", C
     port?: number;
     stage?: string;
     webBuild?: WebBuild;
+    onChange?: OnChange;
   }): Promise<void>;
   seed(sqlFile: string, opts?: {
     stage?: string;

package/dist/{index-BuY9o1u0.d.mts → index-BDkgen4r.d.mts}

@@ -102,6 +102,23 @@ type WorkerPluginCtx<Config, State, Events extends Record<string, unknown> = Rec
  * ```
  */
 type WebBuild = () => Promise<unknown>;
+/**
+ * A per-change INCREMENTAL rebuild hook wired in from the consumer's dev script — e.g.
+ * `(changes) => webApp.cli.update(changes)`. The fast counterpart to {@link WebBuild}: `dev`
+ * calls {@link WebBuild} ONCE for the cold build, then (when this hook is wired) calls `onChange`
+ * with the set of paths changed in the debounce window so the web build can rebuild only what
+ * changed instead of doing a full `webBuild()` every keystroke. Omit it and `dev` keeps doing a
+ * full `webBuild()` per change (the prior behavior). Like {@link WebBuild} it may resolve ANYTHING
+ * (the web build's own summary); the value is read opportunistically for a `files` count.
+ *
+ * @param changes - The paths changed since the last rebuild (the watcher's debounced set).
+ * @returns Resolves when the incremental rebuild completes.
+ * @example
+ * ```ts
+ * await server.cli.dev({ webBuild: () => web.cli.build(), onChange: changes => web.cli.update(changes) });
+ * ```
+ */
+type OnChange = (changes: readonly string[]) => Promise<unknown>;
 /** deploy plugin configuration. Flat; complete defaults so omission never yields undefined. */
 type Config$1 = {
   /**
@@ -268,22 +285,26 @@ type Api = {
    * when omitted. A failure renders a branded `✗` line and sets a non-zero exit code rather than
    * throwing a raw stack trace.
    *
-   * @param opts - Optional port, stage, and web build hook.
+   * @param opts - Optional port, stage, cold-build hook, and incremental change hook.
    * @param opts.port - Local dev port to bind. Defaults to 8787 when omitted.
    * @param opts.stage - Stage for the generated wrangler config's resource names. Falls back to the
    *   `--stage` CLI flag, then the app's configured stage. Pass it explicitly from a script for a
    *   self-documenting `dev({ stage })` instead of relying on the hidden flag.
-   * @param opts.webBuild - Rebuild the web site on change (e.g. `() => webApp.cli.build()`).
+   * @param opts.webBuild - Cold-build the web site (e.g. `() => webApp.cli.build()`); also the
+   *   per-change rebuild when `onChange` is omitted.
+   * @param opts.onChange - Incremental per-change rebuild (e.g. `changes => webApp.cli.update(changes)`),
+   *   so each change rebuilds only the changed paths instead of a full `webBuild()` every keystroke.
    * @returns Resolves when the dev session ends.
    * @example
    * ```ts
-   * await app.cli.dev({ stage: "dev", port: 7878, webBuild: () => web.cli.build() });
+   * await app.cli.dev({ stage: "dev", port: 7878, webBuild: () => web.cli.build(), onChange: c => web.cli.update(c) });
    * ```
    */
   dev(opts?: {
     port?: number;
     stage?: string;
     webBuild?: WebBuild;
+    onChange?: OnChange;
   }): Promise<void>;
   /**
    * One-command Cloudflare deploy (delegates to deploy.run). Guided/interactive by default; pass
@@ -415,6 +436,7 @@ declare const deployPlugin: import("@moku-labs/core").PluginInstance<"deploy", C
     port?: number;
     stage?: string;
     webBuild?: WebBuild;
+    onChange?: OnChange;
   }): Promise<void>;
   seed(sqlFile: string, opts?: {
     stage?: string;

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_cli = require("./cli-DkoPBbJC.cjs");
+const require_cli = require("./cli-l-AOWzhR.cjs");
 let _moku_labs_common = require("@moku-labs/common");
 //#region src/env-provider.ts
 /**

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { a as WorkerConfig, c as WorkerPluginCtx, i as ResourceManifest, n as cliPlugin, o as WorkerEnv, r as ExternalManifest, s as WorkerEvents, t as deployPlugin } from "./index-BuY9o1u0.cjs";
+import { a as WorkerConfig, c as WorkerPluginCtx, i as ResourceManifest, n as cliPlugin, o as WorkerEnv, r as ExternalManifest, s as WorkerEvents, t as deployPlugin } from "./index-BDkgen4r.cjs";
 import { envPlugin, logPlugin } from "@moku-labs/common";
 import { PluginCtx, PluginCtx as PluginCtx$1, PluginInstance } from "@moku-labs/core";
 

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { a as WorkerConfig, c as WorkerPluginCtx, i as ResourceManifest, n as cliPlugin, o as WorkerEnv, r as ExternalManifest, s as WorkerEvents, t as deployPlugin } from "./index-BuY9o1u0.mjs";
+import { a as WorkerConfig, c as WorkerPluginCtx, i as ResourceManifest, n as cliPlugin, o as WorkerEnv, r as ExternalManifest, s as WorkerEvents, t as deployPlugin } from "./index-BDkgen4r.mjs";
 import { envPlugin, logPlugin } from "@moku-labs/common";
 import { PluginCtx, PluginCtx as PluginCtx$1, PluginInstance } from "@moku-labs/core";
 

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { a as kvPlugin, c as d1Plugin, d as createCore, f as createPlugin$1, i as queuesPlugin, l as bindingsPlugin, n as deployPlugin, o as durableObjectsPlugin, p as stagePlugin, r as storagePlugin, s as defineDurableObject, t as cliPlugin, u as coreConfig } from "./cli-By06KF-9.mjs";
+import { a as kvPlugin, c as d1Plugin, d as createCore, f as createPlugin$1, i as queuesPlugin, l as bindingsPlugin, n as deployPlugin, o as durableObjectsPlugin, p as stagePlugin, r as storagePlugin, s as defineDurableObject, t as cliPlugin, u as coreConfig } from "./cli-DNW8_355.mjs";
 import { envPlugin, logPlugin } from "@moku-labs/common";
 //#region src/env-provider.ts
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moku-labs/worker",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Cloudflare Worker framework for Moku — Durable Objects, Queues, R2, D1, and KV plugins that compose with Moku Web.",
   "repository": {
     "type": "git",