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

@moku-labs/web 1.8.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/browser.d.mts CHANGED Viewed

@@ -1157,6 +1157,19 @@ type Api$1 = {
     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$6 {
   export { COMPONENT_HOOK_NAMES, ComponentContext, ComponentDef, ComponentHooks, ComponentInstance, ExtractApi, PageData, ResolvedSpaConfig, SpaApi, SpaConfig, SpaContext, SpaDataReader, SpaEmitFunction, SpaEvents, SpaKernel, SpaKernelDeps, SpaRequire, SpaState };

package/dist/browser.mjs CHANGED Viewed

@@ -2579,6 +2579,26 @@ function composeHead(input) {
 	}), ...head.elements ?? []]);
 }
 /**
+* Resolve the FINAL document title for a route's head config — the same value
+* {@link composeHead} emits in its `<title>` element. A route-supplied `title`-keyed
+* element wins the keyed last-wins de-dupe over the templated base title (how a route
+* pins a bare title past `titleTemplate`), so it must win here too; otherwise the
+* template is applied to `head.title ?? site.name()`. Reused by `spa` for the client
+* DATA-path `document.title` sync, so client-side navigation matches the SSG output.
+*
+* @param head - The route's head config (may be `undefined` for head-less routes).
+* @param defaults - The normalized head defaults (provides `titleTemplate`).
+* @param site - The site slice (title fallback).
+* @returns The final document title string.
+* @example composeTitle({ title: "Page 2" }, defaults, site) // "Page 2 — Site"
+*/
+function composeTitle(head, defaults, site) {
+	const config = head ?? {};
+	const pinned = config.elements?.findLast((element) => element.key === "title");
+	if (pinned?.children !== void 0) return pinned.children;
+	return applyTemplate(config.title ?? site.name(), defaults.titleTemplate);
+}
+/**
 * Compose the SITE-LEVEL Open Graph / Twitter block for a bare-path redirect or landing
 * page that has no per-route head of its own. Returns `[]` UNLESS a `defaultOgImage` is
 * configured — so apps that opt out keep a bare redirect (no behavior change). The site
@@ -2748,6 +2768,21 @@ function createApi$1(ctx) {
 				url: site.canonical(input.url),
 				...ogLocale === void 0 ? {} : { ogLocale }
 			}));
+		},
+		/**
+		* Resolve the FINAL document title for a route's head config — the same value `render`
+		* emits in its `<title>` element. Pulled by `spa` on the client DATA path so a
+		* client-side navigation's `document.title` matches the SSG output.
+		*
+		* @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) {
+			return composeTitle(head, readDefaults(ctx.state), ctx.require(sitePlugin));
 		}
 	};
 }
@@ -4020,16 +4055,19 @@ function currentLocationUrl() {
 /**
 * Apply the matched route's `head` config to the live document (minimal client
 * head-sync for the DATA path: title only — the full meta sync runs on the
-* HTML-over-fetch path from the fetched `<head>`).
+* HTML-over-fetch path from the fetched `<head>`). The title is resolved through
+* `head.composeTitle` — the SAME composition `render` uses (`titleTemplate` applied;
+* a route-pinned `title` element wins) — so a client-side navigation's
+* `document.title` matches the SSG output instead of the raw route title.
 *
+* @param head - The head plugin API (resolves the final templated title).
 * @param route - The matched route definition.
 * @param routeContext - The render context (params/data/locale).
 * @example
-* syncDataHead(hit.route, { params, data, locale });
+* syncDataHead(deps.head, hit.route, { params, data, locale });
 */
-function syncDataHead(route, routeContext) {
-	const title = route._handlers.head?.(routeContext)?.title;
-	if (title !== void 0 && title !== "") document.title = title;
+function syncDataHead(head, route, routeContext) {
+	document.title = head.composeTitle(route._handlers.head?.(routeContext));
 }
 /**
 * Builds the single shared SPA kernel — a pure factory over state/config/emit.
@@ -4185,7 +4223,7 @@ function createSpaKernel(state, config, emit, deps) {
 		handleStart(pathname);
 		const { renderVNode } = await import("./render-BNe0s7fr.mjs");
 		if (signal?.aborted) return;
-		syncDataHead(route, routeContext);
+		syncDataHead(deps.head, route, routeContext);
 		unmountPageSpecific(state, emit);
 		/**
 		* Render the VNode into the region and re-mount its islands in one paint — the

package/dist/index.cjs CHANGED Viewed

@@ -3169,6 +3169,26 @@ function composeHead(input) {
 	}), ...head.elements ?? []]);
 }
 /**
+* Resolve the FINAL document title for a route's head config — the same value
+* {@link composeHead} emits in its `<title>` element. A route-supplied `title`-keyed
+* element wins the keyed last-wins de-dupe over the templated base title (how a route
+* pins a bare title past `titleTemplate`), so it must win here too; otherwise the
+* template is applied to `head.title ?? site.name()`. Reused by `spa` for the client
+* DATA-path `document.title` sync, so client-side navigation matches the SSG output.
+*
+* @param head - The route's head config (may be `undefined` for head-less routes).
+* @param defaults - The normalized head defaults (provides `titleTemplate`).
+* @param site - The site slice (title fallback).
+* @returns The final document title string.
+* @example composeTitle({ title: "Page 2" }, defaults, site) // "Page 2 — Site"
+*/
+function composeTitle(head, defaults, site) {
+	const config = head ?? {};
+	const pinned = config.elements?.findLast((element) => element.key === "title");
+	if (pinned?.children !== void 0) return pinned.children;
+	return applyTemplate(config.title ?? site.name(), defaults.titleTemplate);
+}
+/**
 * Compose the SITE-LEVEL Open Graph / Twitter block for a bare-path redirect or landing
 * page that has no per-route head of its own. Returns `[]` UNLESS a `defaultOgImage` is
 * configured — so apps that opt out keep a bare redirect (no behavior change). The site
@@ -3338,6 +3358,21 @@ function createApi$4(ctx) {
 				url: site.canonical(input.url),
 				...ogLocale === void 0 ? {} : { ogLocale }
 			}));
+		},
+		/**
+		* Resolve the FINAL document title for a route's head config — the same value `render`
+		* emits in its `<title>` element. Pulled by `spa` on the client DATA path so a
+		* client-side navigation's `document.title` matches the SSG output.
+		*
+		* @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) {
+			return composeTitle(head, readDefaults(ctx.state), ctx.require(sitePlugin));
 		}
 	};
 }
@@ -10868,16 +10903,19 @@ function currentLocationUrl() {
 /**
 * Apply the matched route's `head` config to the live document (minimal client
 * head-sync for the DATA path: title only — the full meta sync runs on the
-* HTML-over-fetch path from the fetched `<head>`).
+* HTML-over-fetch path from the fetched `<head>`). The title is resolved through
+* `head.composeTitle` — the SAME composition `render` uses (`titleTemplate` applied;
+* a route-pinned `title` element wins) — so a client-side navigation's
+* `document.title` matches the SSG output instead of the raw route title.
 *
+* @param head - The head plugin API (resolves the final templated title).
 * @param route - The matched route definition.
 * @param routeContext - The render context (params/data/locale).
 * @example
-* syncDataHead(hit.route, { params, data, locale });
+* syncDataHead(deps.head, hit.route, { params, data, locale });
 */
-function syncDataHead(route, routeContext) {
-	const title = route._handlers.head?.(routeContext)?.title;
-	if (title !== void 0 && title !== "") document.title = title;
+function syncDataHead(head, route, routeContext) {
+	document.title = head.composeTitle(route._handlers.head?.(routeContext));
 }
 /**
 * Builds the single shared SPA kernel — a pure factory over state/config/emit.
@@ -11033,7 +11071,7 @@ function createSpaKernel(state, config, emit, deps) {
 		handleStart(pathname);
 		const { renderVNode } = await Promise.resolve().then(() => require("./render-DLZEOe4M.cjs"));
 		if (signal?.aborted) return;
-		syncDataHead(route, routeContext);
+		syncDataHead(deps.head, route, routeContext);
 		unmountPageSpecific(state, emit);
 		/**
 		* Render the VNode into the region and re-mount its islands in one paint — the

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 };

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 };

package/dist/index.mjs CHANGED Viewed

@@ -3156,6 +3156,26 @@ function composeHead(input) {
 	}), ...head.elements ?? []]);
 }
 /**
+* Resolve the FINAL document title for a route's head config — the same value
+* {@link composeHead} emits in its `<title>` element. A route-supplied `title`-keyed
+* element wins the keyed last-wins de-dupe over the templated base title (how a route
+* pins a bare title past `titleTemplate`), so it must win here too; otherwise the
+* template is applied to `head.title ?? site.name()`. Reused by `spa` for the client
+* DATA-path `document.title` sync, so client-side navigation matches the SSG output.
+*
+* @param head - The route's head config (may be `undefined` for head-less routes).
+* @param defaults - The normalized head defaults (provides `titleTemplate`).
+* @param site - The site slice (title fallback).
+* @returns The final document title string.
+* @example composeTitle({ title: "Page 2" }, defaults, site) // "Page 2 — Site"
+*/
+function composeTitle(head, defaults, site) {
+	const config = head ?? {};
+	const pinned = config.elements?.findLast((element) => element.key === "title");
+	if (pinned?.children !== void 0) return pinned.children;
+	return applyTemplate(config.title ?? site.name(), defaults.titleTemplate);
+}
+/**
 * Compose the SITE-LEVEL Open Graph / Twitter block for a bare-path redirect or landing
 * page that has no per-route head of its own. Returns `[]` UNLESS a `defaultOgImage` is
 * configured — so apps that opt out keep a bare redirect (no behavior change). The site
@@ -3325,6 +3345,21 @@ function createApi$4(ctx) {
 				url: site.canonical(input.url),
 				...ogLocale === void 0 ? {} : { ogLocale }
 			}));
+		},
+		/**
+		* Resolve the FINAL document title for a route's head config — the same value `render`
+		* emits in its `<title>` element. Pulled by `spa` on the client DATA path so a
+		* client-side navigation's `document.title` matches the SSG output.
+		*
+		* @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) {
+			return composeTitle(head, readDefaults(ctx.state), ctx.require(sitePlugin));
 		}
 	};
 }
@@ -10855,16 +10890,19 @@ function currentLocationUrl() {
 /**
 * Apply the matched route's `head` config to the live document (minimal client
 * head-sync for the DATA path: title only — the full meta sync runs on the
-* HTML-over-fetch path from the fetched `<head>`).
+* HTML-over-fetch path from the fetched `<head>`). The title is resolved through
+* `head.composeTitle` — the SAME composition `render` uses (`titleTemplate` applied;
+* a route-pinned `title` element wins) — so a client-side navigation's
+* `document.title` matches the SSG output instead of the raw route title.
 *
+* @param head - The head plugin API (resolves the final templated title).
 * @param route - The matched route definition.
 * @param routeContext - The render context (params/data/locale).
 * @example
-* syncDataHead(hit.route, { params, data, locale });
+* syncDataHead(deps.head, hit.route, { params, data, locale });
 */
-function syncDataHead(route, routeContext) {
-	const title = route._handlers.head?.(routeContext)?.title;
-	if (title !== void 0 && title !== "") document.title = title;
+function syncDataHead(head, route, routeContext) {
+	document.title = head.composeTitle(route._handlers.head?.(routeContext));
 }
 /**
 * Builds the single shared SPA kernel — a pure factory over state/config/emit.
@@ -11020,7 +11058,7 @@ function createSpaKernel(state, config, emit, deps) {
 		handleStart(pathname);
 		const { renderVNode } = await import("./render-BNe0s7fr.mjs");
 		if (signal?.aborted) return;
-		syncDataHead(route, routeContext);
+		syncDataHead(deps.head, route, routeContext);
 		unmountPageSpecific(state, emit);
 		/**
 		* Render the VNode into the region and re-mount its islands in one paint — the

package/package.json CHANGED Viewed

@@ -118,5 +118,5 @@
     "test:build-e2e": "bun test src/plugins/build/__tests__/e2e/",
     "test:coverage": "vitest run --project unit --project integration --coverage"
   },
-  "version": "1.8.0"
+  "version": "1.8.1"
 }