npm - @moku-labs/web - Versions diffs - 1.7.0 → 1.8.1 - Mend

@moku-labs/web 1.7.0 → 1.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/index.d.cts CHANGED Viewed

@@ -1157,6 +1157,19 @@ type Api$4 = {
     url: string;
     locale?: string;
   }): string;
+  /**
+   * Resolve the FINAL document title for a route's head config — the same value `render`
+   * emits in its `<title>` element (`titleTemplate` applied; a route-pinned `title`-keyed
+   * element wins). Used by `spa` to sync `document.title` on client DATA-path navigation.
+   *
+   * @param head - The route's head config (may be `undefined` for head-less routes).
+   * @returns The final document title string.
+   * @example
+   * ```ts
+   * api.composeTitle({ title: "Page 2" }); // "Page 2 — Site"
+   * ```
+   */
+  composeTitle(head: HeadConfig | undefined): string;
 };
 declare namespace types_d_exports$9 {
   export { COMPONENT_HOOK_NAMES, ComponentContext, ComponentDef, ComponentHooks, ComponentInstance, ExtractApi$1 as ExtractApi, PageData, ResolvedSpaConfig, SpaApi, SpaConfig, SpaContext, SpaDataReader, SpaEmitFunction, SpaEvents, SpaKernel, SpaKernelDeps, SpaRequire, SpaState };
@@ -1667,8 +1680,13 @@ type Config$3 = {
    * - `true` — the built-in default page.
    * - `{ body }` — literal HTML body content, wrapped in a minimal document shell.
    * - `{ path }` — path to a complete HTML page file (resolved from the project
-   *   root), written out VERBATIM so the app owns the whole document (its own
-   *   `<head>`, asset links, and body).
+   *   root) so the app owns the whole document (its own `<head>`, asset links,
+   *   and body).
+   *
+   * In every variant the `<!--moku:assets-->` / `<!--moku:assets:css-->` /
+   * `<!--moku:assets:js-->` placeholders are substituted with the fingerprinted
+   * bundle tags (bundle filenames embed a content hash, so a 404 page cannot
+   * hardcode them); a page without placeholders is written byte-for-byte.
    *
    * `path` takes precedence over `body` when both are set. Default `false`.
    */
@@ -1685,10 +1703,31 @@ type Config$3 = {
    * `<!--moku:lang-->` (page locale for `<html lang>`),
    * `<!--moku:head-->` (composed `<head>` inner HTML),
    * `<!--moku:assets-->` (injected `<link>`/`<script>` tags),
+   * `<!--moku:assets:css-->` / `<!--moku:assets:js-->` (one asset kind each, for
+   * shells that link stylesheets in `<head>` but script tags elsewhere),
    * `<!--moku:body-->` (SSR body HTML).
    * When unset, the built-in shell is used (it emits charset + viewport by default).
    */
   template?: string;
+  /**
+   * Emit `outDir/_headers` (Cloudflare Pages header rules) for CDN/browser cache
+   * protection. Generated rules: every fingerprinted bundle output gets a
+   * per-file `Cache-Control: <assets>` rule (default immutable, 1 year — its URL
+   * embeds a content hash, so the bytes behind it can never change), and every
+   * other URL — pages, content images, feeds, data sidecars: stable URLs whose
+   * bytes MAY change between deploys — gets the catch-all
+   * `Cache-Control: <pages>` rule (default always-revalidate: unchanged files
+   * still answer `304 Not Modified` from their ETag, changed files are picked up
+   * immediately). The app's own `<publicDir>/_headers` content is appended AFTER
+   * the generated rules so the app can override them (detach a generated header
+   * first with `! Cache-Control` — Cloudflare comma-joins duplicate headers).
+   * `false` disables the phase; an object overrides one or both values.
+   * Default `true`.
+   */
+  cacheHeaders?: boolean | {
+    assets?: string;
+    pages?: string;
+  };
 };
 /**
  * A typed asset-manifest entry for one bundled asset kind (CSS or JS): a map of the
@@ -1755,7 +1794,7 @@ interface State$3 {
  * const phase: PhaseName = "bundle";
  * ```
  */
-type PhaseName = "bundle" | "content" | "images" | "pages" | "content-images" | "feeds" | "sitemap" | "og-images" | "public" | "not-found" | "locale-redirects" | "root-index";
+type PhaseName = "bundle" | "content" | "images" | "pages" | "content-images" | "feeds" | "sitemap" | "og-images" | "public" | "not-found" | "locale-redirects" | "cache-headers" | "root-index";
 /**
  * Result of a completed build run.
  *
@@ -1784,7 +1823,7 @@ interface BuildResult {
  * const dev: BuildRunOverrides = { minify: false, feeds: false, sitemap: false };
  * ```
  */
-type BuildRunOverrides = Readonly<Partial<Pick<Config$3, "minify" | "feeds" | "sitemap" | "ogImage" | "images" | "localeRedirects" | "notFound">>>;
+type BuildRunOverrides = Readonly<Partial<Pick<Config$3, "minify" | "feeds" | "sitemap" | "ogImage" | "images" | "localeRedirects" | "notFound" | "cacheHeaders">>>;
 /**
  * Options for a single {@link Api.run} call. All fields are optional; an absent/empty
  * options object runs the full production build (clean + every configured phase). The

package/dist/index.d.mts CHANGED Viewed

@@ -1157,6 +1157,19 @@ type Api$4 = {
     url: string;
     locale?: string;
   }): string;
+  /**
+   * Resolve the FINAL document title for a route's head config — the same value `render`
+   * emits in its `<title>` element (`titleTemplate` applied; a route-pinned `title`-keyed
+   * element wins). Used by `spa` to sync `document.title` on client DATA-path navigation.
+   *
+   * @param head - The route's head config (may be `undefined` for head-less routes).
+   * @returns The final document title string.
+   * @example
+   * ```ts
+   * api.composeTitle({ title: "Page 2" }); // "Page 2 — Site"
+   * ```
+   */
+  composeTitle(head: HeadConfig | undefined): string;
 };
 declare namespace types_d_exports$9 {
   export { COMPONENT_HOOK_NAMES, ComponentContext, ComponentDef, ComponentHooks, ComponentInstance, ExtractApi$1 as ExtractApi, PageData, ResolvedSpaConfig, SpaApi, SpaConfig, SpaContext, SpaDataReader, SpaEmitFunction, SpaEvents, SpaKernel, SpaKernelDeps, SpaRequire, SpaState };
@@ -1667,8 +1680,13 @@ type Config$3 = {
    * - `true` — the built-in default page.
    * - `{ body }` — literal HTML body content, wrapped in a minimal document shell.
    * - `{ path }` — path to a complete HTML page file (resolved from the project
-   *   root), written out VERBATIM so the app owns the whole document (its own
-   *   `<head>`, asset links, and body).
+   *   root) so the app owns the whole document (its own `<head>`, asset links,
+   *   and body).
+   *
+   * In every variant the `<!--moku:assets-->` / `<!--moku:assets:css-->` /
+   * `<!--moku:assets:js-->` placeholders are substituted with the fingerprinted
+   * bundle tags (bundle filenames embed a content hash, so a 404 page cannot
+   * hardcode them); a page without placeholders is written byte-for-byte.
    *
    * `path` takes precedence over `body` when both are set. Default `false`.
    */
@@ -1685,10 +1703,31 @@ type Config$3 = {
    * `<!--moku:lang-->` (page locale for `<html lang>`),
    * `<!--moku:head-->` (composed `<head>` inner HTML),
    * `<!--moku:assets-->` (injected `<link>`/`<script>` tags),
+   * `<!--moku:assets:css-->` / `<!--moku:assets:js-->` (one asset kind each, for
+   * shells that link stylesheets in `<head>` but script tags elsewhere),
    * `<!--moku:body-->` (SSR body HTML).
    * When unset, the built-in shell is used (it emits charset + viewport by default).
    */
   template?: string;
+  /**
+   * Emit `outDir/_headers` (Cloudflare Pages header rules) for CDN/browser cache
+   * protection. Generated rules: every fingerprinted bundle output gets a
+   * per-file `Cache-Control: <assets>` rule (default immutable, 1 year — its URL
+   * embeds a content hash, so the bytes behind it can never change), and every
+   * other URL — pages, content images, feeds, data sidecars: stable URLs whose
+   * bytes MAY change between deploys — gets the catch-all
+   * `Cache-Control: <pages>` rule (default always-revalidate: unchanged files
+   * still answer `304 Not Modified` from their ETag, changed files are picked up
+   * immediately). The app's own `<publicDir>/_headers` content is appended AFTER
+   * the generated rules so the app can override them (detach a generated header
+   * first with `! Cache-Control` — Cloudflare comma-joins duplicate headers).
+   * `false` disables the phase; an object overrides one or both values.
+   * Default `true`.
+   */
+  cacheHeaders?: boolean | {
+    assets?: string;
+    pages?: string;
+  };
 };
 /**
  * A typed asset-manifest entry for one bundled asset kind (CSS or JS): a map of the
@@ -1755,7 +1794,7 @@ interface State$3 {
  * const phase: PhaseName = "bundle";
  * ```
  */
-type PhaseName = "bundle" | "content" | "images" | "pages" | "content-images" | "feeds" | "sitemap" | "og-images" | "public" | "not-found" | "locale-redirects" | "root-index";
+type PhaseName = "bundle" | "content" | "images" | "pages" | "content-images" | "feeds" | "sitemap" | "og-images" | "public" | "not-found" | "locale-redirects" | "cache-headers" | "root-index";
 /**
  * Result of a completed build run.
  *
@@ -1784,7 +1823,7 @@ interface BuildResult {
  * const dev: BuildRunOverrides = { minify: false, feeds: false, sitemap: false };
  * ```
  */
-type BuildRunOverrides = Readonly<Partial<Pick<Config$3, "minify" | "feeds" | "sitemap" | "ogImage" | "images" | "localeRedirects" | "notFound">>>;
+type BuildRunOverrides = Readonly<Partial<Pick<Config$3, "minify" | "feeds" | "sitemap" | "ogImage" | "images" | "localeRedirects" | "notFound" | "cacheHeaders">>>;
 /**
  * Options for a single {@link Api.run} call. All fields are optional; an absent/empty
  * options object runs the full production build (clean + every configured phase). The