@moku-labs/web 1.15.0 → 1.15.1

package/dist/index.cjs

@@ -8024,6 +8024,34 @@ function createApi$1(ctx) {
 			return result;
 		},
 		/**
+		* Incremental dev rebuild from a set of changed paths — the fast counterpart to
+		* `build()` for an external dev driver (e.g. the worker's `dev({ onChange })`). Skips
+		* the destructive clean, scopes the rebuild to `changes`, and applies the same dev
+		* overrides `serve()` uses (minify off; OG/sitemap/feeds off unless re-enabled). Renders
+		* no header and skips the not-found assertion — the driver owns the dev TUI and the cold
+		* build already asserted. Live per-phase progress still streams via the build hooks (as
+		* the cold `build()` does today).
+		*
+		* @param changes - The paths changed since the last build (incremental rebuild hint).
+		* @param options - Optional per-session dev-output opt-ins (default all off).
+		* @returns The rebuild summary (`outDir`, `pageCount`, `durationMs`).
+		* @throws {Error} When the underlying incremental build fails.
+		* @example
+		* await api.update(["src/islands/board.ts"]);
+		*/
+		update(changes, options = {}) {
+			const overrides = devBuildOverrides({
+				og: options.og ?? false,
+				sitemap: options.sitemap ?? false,
+				feeds: options.feeds ?? false
+			});
+			return ctx.require(buildPlugin).run({
+				skipClean: true,
+				overrides,
+				changed: changes
+			});
+		},
+		/**
 		* Dev loop: build once, serve `dist/` in-process (live-reload injected), watch
 		* `watchDirs`, debounced + incremental rebuild + reload. For a fast rebuild the dev
 		* build disables minification + expensive, NON-navigational outputs (feeds / sitemap /

package/dist/index.d.cts

@@ -1856,7 +1856,7 @@ type Api$2 = {
   createProject(): Promise<CreateProjectResult>;
 };
 declare namespace types_d_exports$1 {
-  export { Api$1 as Api, BuildOptions, BuildSummary, CliErrorCode, CliRenderer, Command, Config$1 as Config, DeployOptions, DeployOutcome, FileResponseFunction, PreviewOptions, ReloadInfo, ServeOptions, ServeStaticFunction, ServeStaticOptions, ServerHandle, ServerInfo, State$1 as State, WatchHandle };
+  export { Api$1 as Api, BuildOptions, BuildSummary, CliErrorCode, CliRenderer, Command, Config$1 as Config, DeployOptions, DeployOutcome, FileResponseFunction, PreviewOptions, ReloadInfo, ServeOptions, ServeStaticFunction, ServeStaticOptions, ServerHandle, ServerInfo, State$1 as State, UpdateOptions, WatchHandle };
 }
 /**
  * A cli error `code` from the config-validation and runtime taxonomy. Mirrors the
@@ -2269,6 +2269,20 @@ type DeployOutcome = {
 type BuildOptions = {
   /** Assert `outDir/notFoundFile` exists after the build. Defaults to `true`. */assertNotFound?: boolean;
 };
+/**
+ * Options for `cli.update()` — the per-session dev-output opt-ins, mirroring the
+ * relevant subset of {@link ServeOptions}. Each defaults to `false`: an incremental
+ * rebuild skips expensive, preview-irrelevant outputs (OG images / sitemap / feeds)
+ * for speed, and a flag re-enables that one output for the rebuild.
+ *
+ * @example
+ * await app.cli.update(["src/styles.css"], { feeds: true });
+ */
+type UpdateOptions = {
+  /** Re-enable OG-image generation for this rebuild. Defaults to `false`. */og?: boolean; /** Re-enable `sitemap.xml` + `robots.txt` for this rebuild. Defaults to `false`. */
+  sitemap?: boolean; /** Re-enable RSS/Atom/JSON feeds for this rebuild. Defaults to `false`. */
+  feeds?: boolean;
+};
 /**
  * Options for `cli.serve()`.
  *
@@ -2330,6 +2344,24 @@ type Api$1 = {
    * const summary = await app.cli.build();
    */
   build(options?: BuildOptions): Promise<BuildSummary>;
+  /**
+   * Incremental dev rebuild from a set of changed paths — the fast counterpart to
+   * {@link build} for a long-lived EXTERNAL dev loop (e.g. an `@moku-labs/worker` dev
+   * session driving the composed web client via `dev({ onChange })`). Reuses the build
+   * plugin's incremental engine: skips the destructive clean, scopes the rebuild to
+   * `changes` (re-reads only changed Markdown, reuses cached page renders whose data is
+   * unchanged), and applies the dev overrides (minify off; OG/sitemap/feeds off unless
+   * re-enabled per {@link UpdateOptions}). An unclassifiable path forces a full rebuild.
+   * Unlike {@link build} it renders no command header and skips the not-found assertion
+   * (it's a per-change dev rebuild, not a release build).
+   *
+   * @param changes - The paths changed since the last build (the incremental hint).
+   * @param options - Optional per-session dev-output opt-ins.
+   * @returns The rebuild summary (`outDir`, `pageCount`, `durationMs`).
+   * @example
+   * await app.cli.update(["src/islands/board.ts"]);
+   */
+  update(changes: readonly string[], options?: UpdateOptions): Promise<BuildSummary>;
   /**
    * Dev loop: build once, serve `dist/` in-process (live-reload injected), watch
    * `watchDirs`, debounced rebuild + reload. Resolves when SIGINT/SIGTERM tears down.

package/dist/index.d.mts

@@ -1854,7 +1854,7 @@ type Api$2 = {
   createProject(): Promise<CreateProjectResult>;
 };
 declare namespace types_d_exports$1 {
-  export { Api$1 as Api, BuildOptions, BuildSummary, CliErrorCode, CliRenderer, Command, Config$1 as Config, DeployOptions, DeployOutcome, FileResponseFunction, PreviewOptions, ReloadInfo, ServeOptions, ServeStaticFunction, ServeStaticOptions, ServerHandle, ServerInfo, State$1 as State, WatchHandle };
+  export { Api$1 as Api, BuildOptions, BuildSummary, CliErrorCode, CliRenderer, Command, Config$1 as Config, DeployOptions, DeployOutcome, FileResponseFunction, PreviewOptions, ReloadInfo, ServeOptions, ServeStaticFunction, ServeStaticOptions, ServerHandle, ServerInfo, State$1 as State, UpdateOptions, WatchHandle };
 }
 /**
  * A cli error `code` from the config-validation and runtime taxonomy. Mirrors the
@@ -2267,6 +2267,20 @@ type DeployOutcome = {
 type BuildOptions = {
   /** Assert `outDir/notFoundFile` exists after the build. Defaults to `true`. */assertNotFound?: boolean;
 };
+/**
+ * Options for `cli.update()` — the per-session dev-output opt-ins, mirroring the
+ * relevant subset of {@link ServeOptions}. Each defaults to `false`: an incremental
+ * rebuild skips expensive, preview-irrelevant outputs (OG images / sitemap / feeds)
+ * for speed, and a flag re-enables that one output for the rebuild.
+ *
+ * @example
+ * await app.cli.update(["src/styles.css"], { feeds: true });
+ */
+type UpdateOptions = {
+  /** Re-enable OG-image generation for this rebuild. Defaults to `false`. */og?: boolean; /** Re-enable `sitemap.xml` + `robots.txt` for this rebuild. Defaults to `false`. */
+  sitemap?: boolean; /** Re-enable RSS/Atom/JSON feeds for this rebuild. Defaults to `false`. */
+  feeds?: boolean;
+};
 /**
  * Options for `cli.serve()`.
  *
@@ -2328,6 +2342,24 @@ type Api$1 = {
    * const summary = await app.cli.build();
    */
   build(options?: BuildOptions): Promise<BuildSummary>;
+  /**
+   * Incremental dev rebuild from a set of changed paths — the fast counterpart to
+   * {@link build} for a long-lived EXTERNAL dev loop (e.g. an `@moku-labs/worker` dev
+   * session driving the composed web client via `dev({ onChange })`). Reuses the build
+   * plugin's incremental engine: skips the destructive clean, scopes the rebuild to
+   * `changes` (re-reads only changed Markdown, reuses cached page renders whose data is
+   * unchanged), and applies the dev overrides (minify off; OG/sitemap/feeds off unless
+   * re-enabled per {@link UpdateOptions}). An unclassifiable path forces a full rebuild.
+   * Unlike {@link build} it renders no command header and skips the not-found assertion
+   * (it's a per-change dev rebuild, not a release build).
+   *
+   * @param changes - The paths changed since the last build (the incremental hint).
+   * @param options - Optional per-session dev-output opt-ins.
+   * @returns The rebuild summary (`outDir`, `pageCount`, `durationMs`).
+   * @example
+   * await app.cli.update(["src/islands/board.ts"]);
+   */
+  update(changes: readonly string[], options?: UpdateOptions): Promise<BuildSummary>;
   /**
    * Dev loop: build once, serve `dist/` in-process (live-reload injected), watch
    * `watchDirs`, debounced rebuild + reload. Resolves when SIGINT/SIGTERM tears down.

package/dist/index.mjs

@@ -8011,6 +8011,34 @@ function createApi$1(ctx) {
 			return result;
 		},
 		/**
+		* Incremental dev rebuild from a set of changed paths — the fast counterpart to
+		* `build()` for an external dev driver (e.g. the worker's `dev({ onChange })`). Skips
+		* the destructive clean, scopes the rebuild to `changes`, and applies the same dev
+		* overrides `serve()` uses (minify off; OG/sitemap/feeds off unless re-enabled). Renders
+		* no header and skips the not-found assertion — the driver owns the dev TUI and the cold
+		* build already asserted. Live per-phase progress still streams via the build hooks (as
+		* the cold `build()` does today).
+		*
+		* @param changes - The paths changed since the last build (incremental rebuild hint).
+		* @param options - Optional per-session dev-output opt-ins (default all off).
+		* @returns The rebuild summary (`outDir`, `pageCount`, `durationMs`).
+		* @throws {Error} When the underlying incremental build fails.
+		* @example
+		* await api.update(["src/islands/board.ts"]);
+		*/
+		update(changes, options = {}) {
+			const overrides = devBuildOverrides({
+				og: options.og ?? false,
+				sitemap: options.sitemap ?? false,
+				feeds: options.feeds ?? false
+			});
+			return ctx.require(buildPlugin).run({
+				skipClean: true,
+				overrides,
+				changed: changes
+			});
+		},
+		/**
 		* Dev loop: build once, serve `dist/` in-process (live-reload injected), watch
 		* `watchDirs`, debounced + incremental rebuild + reload. For a fast rebuild the dev
 		* build disables minification + expensive, NON-navigational outputs (feeds / sitemap /

package/package.json

@@ -126,5 +126,5 @@
     "test:build-e2e": "bun test src/plugins/build/__tests__/e2e/",
     "test:coverage": "vitest run --project unit --project integration --coverage"
   },
-  "version": "1.15.0"
+  "version": "1.15.1"
 }