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

@moku-labs/web 1.8.0 → 1.8.2

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));
 		}
 	};
 }
@@ -3515,6 +3550,23 @@ const FINGERPRINT_NAMING = {
 	asset: "[name]-[hash].[ext]"
 };
 /**
+* Font url() references the CSS pass leaves EXTERNAL instead of bundling.
+* Bun's CSS bundler cannot emit url() assets as files — every resolvable
+* font reference is inlined as a base64 data URI, ballooning the stylesheet
+* (a site vendoring a font family ships every weight/subset render-blocking
+* on every page). Marking font extensions external passes the URL through
+* verbatim, so apps reference fonts root-relative (e.g. `/fonts/x.woff2`)
+* and serve the files statically via `publicDir`. CSS-only: a font import
+* left external in JS would be an unresolvable module at runtime.
+*/
+const CSS_EXTERNAL_FONT_GLOBS = [
+	"*.woff2",
+	"*.woff",
+	"*.ttf",
+	"*.otf",
+	"*.eot"
+];
+/**
 * The default bundler runner — adapts the built-in `Bun.build`.
 *
 * @param options - Entry/outdir/minify/splitting/target/naming settings forwarded to `Bun.build`.
@@ -3527,10 +3579,11 @@ const FINGERPRINT_NAMING = {
 * @param options.naming.entry - Naming template for entry-point outputs.
 * @param options.naming.chunk - Naming template for lazy split chunks.
 * @param options.naming.asset - Naming template for additional emitted assets.
+* @param options.external - Import/url() globs left unresolved in the output.
 * @returns The structural build result.
 * @example
 * ```ts
-* await defaultRunner({ entrypoints: ["a.css"], outdir: "dist", minify: true, splitting: true, target: "browser", naming: FINGERPRINT_NAMING });
+* await defaultRunner({ entrypoints: ["a.css"], outdir: "dist", minify: true, splitting: true, target: "browser", naming: FINGERPRINT_NAMING, external: [] });
 * ```
 */
 async function defaultRunner(options) {
@@ -3623,7 +3676,8 @@ async function runOne(ctx, runner, kind, entrypoints, outDir, outdir, minify) {
 		minify,
 		splitting: true,
 		target: "browser",
-		naming: FINGERPRINT_NAMING
+		naming: FINGERPRINT_NAMING,
+		external: kind === "css" ? [...CSS_EXTERNAL_FONT_GLOBS] : []
 	});
 	if (!result.success) throw new Error(`[web] build.bundle ${kind} build failed`);
 	const hashed = {};
@@ -10868,16 +10922,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 +11090,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));
 		}
 	};
 }
@@ -3502,6 +3537,23 @@ const FINGERPRINT_NAMING = {
 	asset: "[name]-[hash].[ext]"
 };
 /**
+* Font url() references the CSS pass leaves EXTERNAL instead of bundling.
+* Bun's CSS bundler cannot emit url() assets as files — every resolvable
+* font reference is inlined as a base64 data URI, ballooning the stylesheet
+* (a site vendoring a font family ships every weight/subset render-blocking
+* on every page). Marking font extensions external passes the URL through
+* verbatim, so apps reference fonts root-relative (e.g. `/fonts/x.woff2`)
+* and serve the files statically via `publicDir`. CSS-only: a font import
+* left external in JS would be an unresolvable module at runtime.
+*/
+const CSS_EXTERNAL_FONT_GLOBS = [
+	"*.woff2",
+	"*.woff",
+	"*.ttf",
+	"*.otf",
+	"*.eot"
+];
+/**
 * The default bundler runner — adapts the built-in `Bun.build`.
 *
 * @param options - Entry/outdir/minify/splitting/target/naming settings forwarded to `Bun.build`.
@@ -3514,10 +3566,11 @@ const FINGERPRINT_NAMING = {
 * @param options.naming.entry - Naming template for entry-point outputs.
 * @param options.naming.chunk - Naming template for lazy split chunks.
 * @param options.naming.asset - Naming template for additional emitted assets.
+* @param options.external - Import/url() globs left unresolved in the output.
 * @returns The structural build result.
 * @example
 * ```ts
-* await defaultRunner({ entrypoints: ["a.css"], outdir: "dist", minify: true, splitting: true, target: "browser", naming: FINGERPRINT_NAMING });
+* await defaultRunner({ entrypoints: ["a.css"], outdir: "dist", minify: true, splitting: true, target: "browser", naming: FINGERPRINT_NAMING, external: [] });
 * ```
 */
 async function defaultRunner(options) {
@@ -3610,7 +3663,8 @@ async function runOne(ctx, runner, kind, entrypoints, outDir, outdir, minify) {
 		minify,
 		splitting: true,
 		target: "browser",
-		naming: FINGERPRINT_NAMING
+		naming: FINGERPRINT_NAMING,
+		external: kind === "css" ? [...CSS_EXTERNAL_FONT_GLOBS] : []
 	});
 	if (!result.success) throw new Error(`[web] build.bundle ${kind} build failed`);
 	const hashed = {};
@@ -10855,16 +10909,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 +11077,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.2"
 }