@moku-labs/web 1.14.0 → 1.15.1

package/dist/index.d.cts

@@ -231,6 +231,28 @@ type Api$6 = {
   t(locale: string, key: string): string;
 };
 //#endregion
+//#region src/plugins/i18n/index.d.ts
+/**
+ * Internationalization plugin — locale registry plus a flat translation helper
+ * with default-locale fallback. Pure config-as-data (no state or events);
+ * consumed read-only by content, router, head, and build.
+ *
+ * @example Register locales and translations
+ * ```ts
+ * const app = createApp({
+ *   pluginConfigs: {
+ *     i18n: {
+ *       locales: ["en", "uk"],
+ *       defaultLocale: "en",
+ *       localeNames: { en: "English", uk: "Українська" },
+ *       translations: { uk: { "nav.home": "Головна" } }
+ *     }
+ *   }
+ * });
+ * ```
+ */
+declare const i18nPlugin: import("@moku-labs/core").PluginInstance<"i18n", Config$6, Record<string, never>, Api$6, {}> & Record<never, never>;
+//#endregion
 //#region src/plugins/router/iso-match.d.ts
 /**
  * A compiled, engine-agnostic path matcher: the same `.exec({ pathname })` shape the
@@ -1252,7 +1274,7 @@ type PhaseContext = {
   readonly global: Readonly<{
     stage: Stage;
   }>; /** Resolve a depended-upon plugin instance to its public API. */
-  require: PhaseRequire; /** Whether a plugin is registered (by name) — used to detect the OPTIONAL `data` plugin. */
+  require: PhaseRequire; /** Whether a plugin is registered (by name) — used to detect OPTIONAL plugins (`data`, `content`, `i18n`, `head`). */
   has: (name: string) => boolean; /** Emit a build event (notification-only). */
   emit: PhaseEmit; /** Structured logger (core `log` API). */
   readonly log: PhaseLog;
@@ -1585,7 +1607,8 @@ type Api$3 = {
 /**
  * Build plugin — the static-site-generation orchestrator. Renders every route to
  * `outDir`, and optionally emits feeds, a sitemap, optimized images, and OG
- * images. Depends on site, i18n, content, router, and head; emits `build:phase`.
+ * images. Hard-depends only on site, router, and head; `content` and `i18n` are
+ * OPTIONAL (a content-less or single-locale site builds without them). Emits `build:phase`.
  *
  * @example Configure the production build
  * ```ts
@@ -1833,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
@@ -2246,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()`.
  *
@@ -2307,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.
@@ -2835,7 +2890,8 @@ type Api = {
  * (locale fallback, draft filtering, sort, caching, events) lives here; source I/O +
  * the Markdown pipeline live in a {@link ContentProvider} you compose (like `env`
  * providers). The shell imports zero node code, so `contentPlugin` is browser-safe.
- * Depends on i18n; emits `content:ready` and `content:invalidated`.
+ * i18n is OPTIONAL (single default-locale fallback when absent); emits `content:ready`
+ * and `content:invalidated`.
  *
  * @example Compose the node filesystem provider with a content dir + Shiki theme
  * ```ts
@@ -3127,7 +3183,7 @@ declare function buildArticleHead(articleMeta: ArticleMeta, canonicalUrl: string
  * Head plugin — composes per-route `<head>` metadata (title template, Open Graph,
  * Twitter cards, canonical, hreflang). Use the re-exported SEO primitives
  * ({@link meta}, {@link og}, {@link twitter}, …) inside a route's `.head()`.
- * Depends on site, i18n, and router.
+ * Depends on site and router; i18n is OPTIONAL (single default-locale fallback when absent).
  *
  * @example Set global head defaults
  * ```ts
@@ -3153,28 +3209,6 @@ declare const headPlugin: import("@moku-labs/core").PluginInstance<"head", Confi
   buildArticleHead: typeof buildArticleHead;
 };
 //#endregion
-//#region src/plugins/i18n/index.d.ts
-/**
- * Internationalization plugin — locale registry plus a flat translation helper
- * with default-locale fallback. Pure config-as-data (no state or events);
- * consumed read-only by content, router, head, and build.
- *
- * @example Register locales and translations
- * ```ts
- * const app = createApp({
- *   pluginConfigs: {
- *     i18n: {
- *       locales: ["en", "uk"],
- *       defaultLocale: "en",
- *       localeNames: { en: "English", uk: "Українська" },
- *       translations: { uk: { "nav.home": "Головна" } }
- *     }
- *   }
- * });
- * ```
- */
-declare const i18nPlugin: import("@moku-labs/core").PluginInstance<"i18n", Config$6, Record<string, never>, Api$6, {}> & Record<never, never>;
-//#endregion
 //#region src/plugins/router/builders/route-builder.d.ts
 /**
  * Create a fluent route builder from a URL pattern string. Captures the pattern
@@ -3238,8 +3272,8 @@ declare function createUrls<T extends RouteMap>(routes: T, defaultLocale?: strin
 /**
  * Router plugin — typed, named route definitions with locale-aware URL generation
  * and matching. Author routes with {@link route}, then register them the normal config
- * way via `pluginConfigs.router.routes` (compiled at init). Depends on site (base URL)
- * and i18n (locales).
+ * way via `pluginConfigs.router.routes` (compiled at init). Depends on site (base URL);
+ * i18n (locales) is OPTIONAL — falls back to a single default locale ("en") when absent.
  *
  * @example Register routes via config, then start/build
  * ```ts

package/dist/index.d.mts

@@ -229,6 +229,28 @@ type Api$6 = {
   t(locale: string, key: string): string;
 };
 //#endregion
+//#region src/plugins/i18n/index.d.ts
+/**
+ * Internationalization plugin — locale registry plus a flat translation helper
+ * with default-locale fallback. Pure config-as-data (no state or events);
+ * consumed read-only by content, router, head, and build.
+ *
+ * @example Register locales and translations
+ * ```ts
+ * const app = createApp({
+ *   pluginConfigs: {
+ *     i18n: {
+ *       locales: ["en", "uk"],
+ *       defaultLocale: "en",
+ *       localeNames: { en: "English", uk: "Українська" },
+ *       translations: { uk: { "nav.home": "Головна" } }
+ *     }
+ *   }
+ * });
+ * ```
+ */
+declare const i18nPlugin: import("@moku-labs/core").PluginInstance<"i18n", Config$6, Record<string, never>, Api$6, {}> & Record<never, never>;
+//#endregion
 //#region src/plugins/router/iso-match.d.ts
 /**
  * A compiled, engine-agnostic path matcher: the same `.exec({ pathname })` shape the
@@ -1250,7 +1272,7 @@ type PhaseContext = {
   readonly global: Readonly<{
     stage: Stage;
   }>; /** Resolve a depended-upon plugin instance to its public API. */
-  require: PhaseRequire; /** Whether a plugin is registered (by name) — used to detect the OPTIONAL `data` plugin. */
+  require: PhaseRequire; /** Whether a plugin is registered (by name) — used to detect OPTIONAL plugins (`data`, `content`, `i18n`, `head`). */
   has: (name: string) => boolean; /** Emit a build event (notification-only). */
   emit: PhaseEmit; /** Structured logger (core `log` API). */
   readonly log: PhaseLog;
@@ -1583,7 +1605,8 @@ type Api$3 = {
 /**
  * Build plugin — the static-site-generation orchestrator. Renders every route to
  * `outDir`, and optionally emits feeds, a sitemap, optimized images, and OG
- * images. Depends on site, i18n, content, router, and head; emits `build:phase`.
+ * images. Hard-depends only on site, router, and head; `content` and `i18n` are
+ * OPTIONAL (a content-less or single-locale site builds without them). Emits `build:phase`.
  *
  * @example Configure the production build
  * ```ts
@@ -1831,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
@@ -2244,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()`.
  *
@@ -2305,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.
@@ -2833,7 +2888,8 @@ type Api = {
  * (locale fallback, draft filtering, sort, caching, events) lives here; source I/O +
  * the Markdown pipeline live in a {@link ContentProvider} you compose (like `env`
  * providers). The shell imports zero node code, so `contentPlugin` is browser-safe.
- * Depends on i18n; emits `content:ready` and `content:invalidated`.
+ * i18n is OPTIONAL (single default-locale fallback when absent); emits `content:ready`
+ * and `content:invalidated`.
  *
  * @example Compose the node filesystem provider with a content dir + Shiki theme
  * ```ts
@@ -3125,7 +3181,7 @@ declare function buildArticleHead(articleMeta: ArticleMeta, canonicalUrl: string
  * Head plugin — composes per-route `<head>` metadata (title template, Open Graph,
  * Twitter cards, canonical, hreflang). Use the re-exported SEO primitives
  * ({@link meta}, {@link og}, {@link twitter}, …) inside a route's `.head()`.
- * Depends on site, i18n, and router.
+ * Depends on site and router; i18n is OPTIONAL (single default-locale fallback when absent).
  *
  * @example Set global head defaults
  * ```ts
@@ -3151,28 +3207,6 @@ declare const headPlugin: import("@moku-labs/core").PluginInstance<"head", Confi
   buildArticleHead: typeof buildArticleHead;
 };
 //#endregion
-//#region src/plugins/i18n/index.d.ts
-/**
- * Internationalization plugin — locale registry plus a flat translation helper
- * with default-locale fallback. Pure config-as-data (no state or events);
- * consumed read-only by content, router, head, and build.
- *
- * @example Register locales and translations
- * ```ts
- * const app = createApp({
- *   pluginConfigs: {
- *     i18n: {
- *       locales: ["en", "uk"],
- *       defaultLocale: "en",
- *       localeNames: { en: "English", uk: "Українська" },
- *       translations: { uk: { "nav.home": "Головна" } }
- *     }
- *   }
- * });
- * ```
- */
-declare const i18nPlugin: import("@moku-labs/core").PluginInstance<"i18n", Config$6, Record<string, never>, Api$6, {}> & Record<never, never>;
-//#endregion
 //#region src/plugins/router/builders/route-builder.d.ts
 /**
  * Create a fluent route builder from a URL pattern string. Captures the pattern
@@ -3236,8 +3270,8 @@ declare function createUrls<T extends RouteMap>(routes: T, defaultLocale?: strin
 /**
  * Router plugin — typed, named route definitions with locale-aware URL generation
  * and matching. Author routes with {@link route}, then register them the normal config
- * way via `pluginConfigs.router.routes` (compiled at init). Depends on site (base URL)
- * and i18n (locales).
+ * way via `pluginConfigs.router.routes` (compiled at init). Depends on site (base URL);
+ * i18n (locales) is OPTIONAL — falls back to a single default locale ("en") when absent.
  *
  * @example Register routes via config, then start/build
  * ```ts