@takazudo/zudo-doc 5.5.3 → 5.7.0

package/dist/theme/theme-pack-provider.js

@@ -11,6 +11,9 @@ import {
   THEME_PACK_STORAGE_KEY,
   buildPackCssUrl
 } from "../theme-pack-switcher/theme-pack-sync.js";
+const THEME_PACK_LOADING_ATTR = "data-zd-theme-pack-loading";
+const THEME_PACK_LOAD_WATCHDOG_MS = 2e3;
+const THEME_PACK_LATCH_CSS = `html[${THEME_PACK_LOADING_ATTR}] body{visibility:hidden}`;
 function themePackVersionMap(registry) {
   const map = {};
   for (const entry of registry) {
@@ -33,6 +36,8 @@ function buildThemePackBootstrap(configuredSlug, enabled, base) {
   const runtimeGlobal = JSON.stringify(THEME_PACK_RUNTIME_GLOBAL);
   const afterNav = JSON.stringify(AFTER_NAVIGATE_EVENT);
   const beforeSwap = JSON.stringify(BEFORE_SWAP_EVENT);
+  const loadingAttr = JSON.stringify(THEME_PACK_LOADING_ATTR);
+  const watchdog = JSON.stringify(THEME_PACK_LOAD_WATCHDOG_MS);
   return `(function(){
 var configured=${configured};
 var packs=${packs};
@@ -40,12 +45,31 @@ var base=${b};
 var KEY=${key};
 var ATTR=${attr};
 var LINK_ATTR=${linkAttr};
+var LOADING_ATTR=${loadingAttr};
+var WATCHDOG=${watchdog};
 var DEFAULT_SLUG=${defaultSlug};
 function resolveSlug(){var stored=null;try{stored=localStorage.getItem(KEY);}catch(e){}if(stored&&Object.prototype.hasOwnProperty.call(packs,stored))return stored;var live=document.documentElement.getAttribute(ATTR);if(live&&Object.prototype.hasOwnProperty.call(packs,live))return live;return configured;}
 function packHref(slug){return base+"theme-packs/"+slug+"/pack.css?v="+packs[slug];}
+function hasPackLink(href){var ls=document.querySelectorAll("link["+LINK_ATTR+"]");for(var i=0;i<ls.length;i++){if(ls[i].getAttribute("href")===href)return true;}return false;}
 var slug=resolveSlug();
-document.documentElement.setAttribute(ATTR,slug);
-if(slug!==DEFAULT_SLUG){document.write('<link rel="stylesheet" '+LINK_ATTR+' href="'+packHref(slug)+'">');}
+var root=document.documentElement;
+root.setAttribute(ATTR,slug);
+if(slug!==DEFAULT_SLUG){
+var href=packHref(slug);
+if(!hasPackLink(href)){
+var shouldLatch=document.readyState==="loading";
+if(shouldLatch){root.setAttribute(LOADING_ATTR,"");}
+var release=function(){root.removeAttribute(LOADING_ATTR);};
+var link=document.createElement("link");
+link.setAttribute("rel","stylesheet");
+link.setAttribute(LINK_ATTR,"");
+link.setAttribute("href",href);
+link.onload=release;
+link.onerror=release;
+document.head.appendChild(link);
+if(shouldLatch){setTimeout(release,WATCHDOG);}
+}
+}
 window[${runtimeGlobal}]={base:base,packs:packs,configured:configured};
 document.addEventListener(${beforeSwap},function(e){
 var s=resolveSlug();
@@ -81,11 +105,15 @@ function ThemePackProvider({
   const configuredVersion = enabled[configuredSlug];
   const noscriptHref = configuredSlug !== DEFAULT_THEME_PACK_SLUG && configuredVersion !== void 0 ? buildPackCssUrl(base, configuredSlug, configuredVersion) : null;
   return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx("style", { dangerouslySetInnerHTML: { __html: THEME_PACK_LATCH_CSS } }),
     /* @__PURE__ */ jsx("script", { dangerouslySetInnerHTML: { __html: bootstrap } }),
     noscriptHref !== null && /* @__PURE__ */ jsx("noscript", { children: /* @__PURE__ */ jsx("link", { rel: "stylesheet", href: noscriptHref }) })
   ] });
 }
 export {
+  THEME_PACK_LATCH_CSS,
+  THEME_PACK_LOADING_ATTR,
+  THEME_PACK_LOAD_WATCHDOG_MS,
   buildThemePackBootstrap,
   ThemePackProvider as default,
   resolveThemePackSsrSlug,

package/dist/transitions/index.d.ts

@@ -1 +1,2 @@
 export { BEFORE_NAVIGATE_EVENT, AFTER_NAVIGATE_EVENT, onBeforeNavigate, onAfterNavigate, } from "./page-events.js";
+export { ensureNestedIslandPropsRefresh } from "./nested-island-props-refresh.js";

package/dist/transitions/index.js

@@ -4,9 +4,11 @@ import {
   onBeforeNavigate,
   onAfterNavigate
 } from "./page-events.js";
+import { ensureNestedIslandPropsRefresh } from "./nested-island-props-refresh.js";
 export {
   AFTER_NAVIGATE_EVENT,
   BEFORE_NAVIGATE_EVENT,
+  ensureNestedIslandPropsRefresh,
   onAfterNavigate,
   onBeforeNavigate
 };

package/dist/transitions/nested-island-props-refresh.d.ts

@@ -0,0 +1,19 @@
+interface NestedIslandPropsRefreshOptions {
+    document: Document;
+}
+/**
+ * Install the before-swap props-refresh listener on a document.
+ *
+ * This low-level entrypoint owns an explicit cleanup for focused tests and
+ * non-singleton hosts. Browser modules use the durable, duplicate-safe
+ * `ensureNestedIslandPropsRefresh` wrapper below instead.
+ */
+export declare function installNestedIslandPropsRefresh({ document, }: NestedIslandPropsRefreshOptions): () => void;
+/**
+ * Install exactly one document-lifetime controller for a browser document.
+ * Repeated calls from component renders or duplicate boot paths are no-ops.
+ */
+export declare function ensureNestedIslandPropsRefresh(options?: NestedIslandPropsRefreshOptions): void;
+/** Test/HMR teardown for a controller installed through the singleton wrapper. */
+export declare function disposeNestedIslandPropsRefresh(document: Document): void;
+export {};

package/dist/transitions/nested-island-props-refresh.js

@@ -0,0 +1,104 @@
+import { BEFORE_SWAP_EVENT } from "./page-events.js";
+const PERSIST_ATTR = "data-zfb-transition-persist";
+const ISLAND_ATTR = "data-zfb-island";
+const PROPS_ATTR = "data-props";
+const ISLAND_REMOUNT_ATTR = "data-zfb-island-remount";
+const DOCUMENT_NODE = 9;
+const installedControllers = /* @__PURE__ */ new WeakMap();
+function installNestedIslandPropsRefresh({
+  document: document2
+}) {
+  const onBeforeSwap = (event) => {
+    const incoming = event.newDocument;
+    if (!isDocument(incoming) || incoming === document2) return;
+    refreshNestedIslandProps(document2, incoming);
+  };
+  document2.addEventListener(BEFORE_SWAP_EVENT, onBeforeSwap);
+  return () => document2.removeEventListener(BEFORE_SWAP_EVENT, onBeforeSwap);
+}
+function ensureNestedIslandPropsRefresh(options) {
+  const resolved = options ?? resolveBrowserOptions();
+  if (!resolved || installedControllers.has(resolved.document)) return;
+  installedControllers.set(
+    resolved.document,
+    installNestedIslandPropsRefresh(resolved)
+  );
+}
+function disposeNestedIslandPropsRefresh(document2) {
+  installedControllers.get(document2)?.();
+  installedControllers.delete(document2);
+}
+function refreshNestedIslandProps(liveDocument, incomingDocument) {
+  const liveRoots = collectRefreshableRoots(liveDocument);
+  if (liveRoots.size === 0) return;
+  const incomingRoots = collectRefreshableRoots(incomingDocument);
+  for (const [persistKey, liveRoot] of liveRoots) {
+    const incomingRoot = incomingRoots.get(persistKey);
+    if (!incomingRoot) continue;
+    const incomingIslands = collectUniqueOwnedIslands(incomingRoot);
+    if (incomingIslands.size === 0) continue;
+    for (const [name, liveIsland] of collectUniqueOwnedIslands(liveRoot)) {
+      const incomingIsland = incomingIslands.get(name);
+      if (!incomingIsland) continue;
+      applyProps(liveIsland, incomingIsland);
+    }
+  }
+}
+function collectRefreshableRoots(doc) {
+  const roots = indexUniquely(
+    doc.querySelectorAll(`[${PERSIST_ATTR}]`),
+    PERSIST_ATTR
+  );
+  for (const [persistKey, element] of roots) {
+    if (element.parentElement?.closest(`[${PERSIST_ATTR}]`)) {
+      roots.delete(persistKey);
+    }
+  }
+  return roots;
+}
+function collectUniqueOwnedIslands(root) {
+  const owned = Array.from(root.querySelectorAll(`[${ISLAND_ATTR}]`)).filter(
+    (island) => island.closest(`[${PERSIST_ATTR}]`) === root
+  );
+  return indexUniquely(owned, ISLAND_ATTR);
+}
+function indexUniquely(elements, attribute) {
+  const byValue = /* @__PURE__ */ new Map();
+  const duplicated = /* @__PURE__ */ new Set();
+  for (const element of elements) {
+    const value = element.getAttribute(attribute);
+    if (!value) continue;
+    if (byValue.has(value)) {
+      duplicated.add(value);
+      continue;
+    }
+    byValue.set(value, element);
+  }
+  for (const value of duplicated) byValue.delete(value);
+  return byValue;
+}
+function applyProps(liveIsland, incomingIsland) {
+  const incoming = incomingIsland.getAttribute(PROPS_ATTR);
+  const current = liveIsland.getAttribute(PROPS_ATTR);
+  if (incoming === current) return;
+  if (incoming === null) {
+    liveIsland.removeAttribute(PROPS_ATTR);
+  } else {
+    liveIsland.setAttribute(PROPS_ATTR, incoming);
+  }
+  liveIsland.setAttribute(ISLAND_REMOUNT_ATTR, "");
+}
+function isDocument(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const candidate = value;
+  return candidate.nodeType === DOCUMENT_NODE && typeof candidate.querySelectorAll === "function";
+}
+function resolveBrowserOptions() {
+  if (typeof document === "undefined") return void 0;
+  return { document };
+}
+export {
+  disposeNestedIslandPropsRefresh,
+  ensureNestedIslandPropsRefresh,
+  installNestedIslandPropsRefresh
+};

package/eject/header/header.tsx

@@ -310,12 +310,20 @@ export function Header(props: HeaderProps): JSX.Element {
       //   - Search: <site-search> custom element re-registers on
       //     AFTER_NAVIGATE_EVENT (_search-widget-script.ts:184, verified (a))
       //   - SidebarToggle (mobile): closes on AFTER_NAVIGATE_EVENT
-      //     (sidebar-toggle.tsx:72, verified (a); sidebar content is
-      //     re-serialised into Island data-props on every SSR render, so
-      //     same-locale swaps see stale SSR in the persist window but the
-      //     Island re-hydrates with correct nodes on mount)
+      //     (sidebar-toggle-island/index.tsx, verified (a)). Its section tree
+      //     rides the Island's serialised data-props, and re-hydration alone
+      //     does NOT correct it — the header is lifted verbatim, so the Island
+      //     re-mounts from the OLD props (zudolab/zudo-doc#3525). What corrects
+      //     it is `ensureNestedIslandPropsRefresh`
+      //     (transitions/nested-island-props-refresh.ts, registered from the
+      //     island module): on BEFORE_SWAP_EVENT it copies the incoming
+      //     document's data-props onto the live nested islands, and
+      //     mountNewIslands re-reads the attribute at mount time (#3530)
       //   - Header nav + aria-current: NAV_OVERFLOW_SCRIPT re-runs on
-      //     AFTER_NAVIGATE_EVENT (nav-overflow-script.ts:198, verified (a))
+      //     AFTER_NAVIGATE_EVENT (frozen by zudolab/zudo-doc#3534 — the
+      //     `addEventListener(${afterNavigateEventLiteral}, initNavOverflow)`
+      //     call at the tail of the template in
+      //     scripts/gen-nav-overflow-script.mjs, verified (a))
       //   - LanguageSwitcher: its target hrefs ARE per-page (the equivalent
       //     page in each other locale), so within a same-locale persist window
       //     they WOULD go stale — the locale is constant but the path is not.

package/eject/header/nav-active.ts

@@ -53,13 +53,28 @@ export function pathForMatch(
 /**
  * Segment-aware prefix test: nav path `/docs/guides` matches `/docs/guides`
  * and `/docs/guides/...` but NOT `/docs/guideship`.
+ *
+ * Exported (not just module-private) so `scripts/gen-nav-overflow-script.mjs`
+ * can embed it verbatim via `.toString()` alongside `computeActiveNavPath` —
+ * that function closes over this one, so a bare `computeActiveNavPath.toString()`
+ * embed would reference an undefined `pathMatchesNavPath` in the browser (see
+ * the caution note on `computeActiveNavPath` below). Kept self-contained (no
+ * outer references) for the same reason. The generator freezes both into the
+ * committed `nav-overflow-generated-script.ts` literal at package build time
+ * (zudolab/zudo-doc#3534) — this is no longer a live per-module-eval embed.
  */
-function pathMatchesNavPath(currentPath: string, navPath: string): boolean {
+export function pathMatchesNavPath(currentPath: string, navPath: string): boolean {
   if (currentPath === navPath) return true;
   const prefix = navPath.endsWith("/") ? navPath : `${navPath}/`;
   return currentPath.startsWith(prefix);
 }
 
+/**
+ * CAUTION (zudolab/zudo-doc#3398): this closes over `pathMatchesNavPath`
+ * above. `scripts/gen-nav-overflow-script.mjs` embeds both via `.toString()`
+ * (never this one alone) so the frozen browser script (`./nav-overflow-generated-script.ts`,
+ * zudolab/zudo-doc#3534) is self-contained.
+ */
 export function computeActiveNavPath(
   navItems: readonly NavItemLike[],
   pathForMatchValue: string,

package/eject/header/nav-class-tokens.ts

@@ -13,11 +13,15 @@
 //
 // Tokens are ARRAYS, not whole strings, because the two consumers need
 // different shapes: `header.tsx` joins them into `class={}` attributes, while
-// the script both spreads them into `classList.add/remove(...)` calls and
-// joins them into `className` assignments. Keeping them composable per-part
-// also lets the overflow-menu recipes (which intentionally differ from the
-// header-bar items in padding/weight/base) reuse the shared color tokens
-// instead of re-typing them.
+// `scripts/gen-nav-overflow-script.mjs` (zudolab/zudo-doc#3534 — the assembly
+// that used to live in `nav-overflow-script.ts` at module-eval time, now
+// frozen into the committed `nav-overflow-generated-script.ts` literal at
+// package build time) reads these arrays off this module's exports and both
+// spreads them into `classList.add/remove(...)` calls and joins them into
+// `className` assignments. Keeping them composable per-part also lets the
+// overflow-menu recipes (which intentionally differ from the header-bar
+// items in padding/weight/base) reuse the shared color tokens instead of
+// re-typing them.
 
 // ── Header-bar top-level item: active-state color toggle ─────────────────
 // setTopActive() (script) ↔ the top-level <a> in renderNavItem() (SSR).

package/eject/header/nav-overflow-generated-script.ts

@@ -0,0 +1,29 @@
+// GENERATED FILE — do not edit by hand.
+// Produced by scripts/gen-nav-overflow-script.mjs (zudolab/zudo-doc#3534,
+// epic #3533) from src/current-path/index.ts (CURRENT_PATH_SCRIPT_PRELUDE),
+// src/header/nav-active.ts (pathMatchesNavPath/computeActiveNavPath,
+// type-stripped), src/header/nav-class-tokens.ts (the twelve class-token
+// arrays), and src/transitions/page-events.ts (AFTER_NAVIGATE_EVENT).
+// Re-run `pnpm --filter @takazudo/zudo-doc gen:nav-overflow-script` (or any
+// build/dev entry point, which already runs it) to regenerate after editing
+// any of those source files.
+//
+// This file is committed to git (mirrors search-widget-script/generated-script.ts,
+// zudolab/zudo-doc#3421 / #3431) — a deliberate departure from this repo's
+// usual gitignored-generated-file convention (routes-src/, virtual-modules.d.ts).
+// Regenerate AND commit the result after editing any of the four source files.
+
+/** Returns the frozen desktop-nav overflow controller IIFE script. NOTE: the
+ * vitest drift guard imports buildNavOverflowScript from
+ * scripts/gen-nav-overflow-script.mjs (a fresh re-generation) — NEVER from
+ * this module: comparing NAV_OVERFLOW_SCRIPT below against this same file's
+ * function would be a vacuous self-comparison. */
+export function buildNavOverflowScript(): string {
+  return "(function () {\n  var cleanupNavOverflow = null;\n\n  function trimSlashes(p) {\n    while (p.length > 1 && p.charAt(p.length - 1) === \"/\") p = p.slice(0, -1);\n    return p || \"/\";\n  }\n\n  function navPathname(a) {\n    try { return trimSlashes(new URL(a.href, location.href).pathname); }\n    catch (e) { return \"\"; }\n  }\n\n  // Explicit current-route override, embedded from current-path/index.ts so\n  // this script cannot drift from the three other read sites\n  // (zudolab/zudo-doc#3398, #3408).\n  var CURRENT_PATH_DATASET_KEY=\"zdCurrentPath\";var readCurrentPath=function readCurrentPath(datasetKey, explicit) {\n  const override = typeof document === \"undefined\" ? void 0 : document.documentElement.dataset[datasetKey];\n  return explicit || override || (typeof window === \"undefined\" ? void 0 : window.location.pathname);\n};\n\n  // Shared matching core (zudolab/zudo-doc#3398): embedded verbatim from\n  // nav-active.ts so this script's longest-match walk cannot drift from the\n  // SSR header's own computeActiveNavPath call (header.tsx). computeActiveNavPath\n  // closes over pathMatchesNavPath, so both are embedded together.\n  var pathMatchesNavPath = function pathMatchesNavPath(currentPath, navPath) {\n  if (currentPath === navPath) return true;\n  const prefix = navPath.endsWith(\"/\") ? navPath : `${navPath}/`;\n  return currentPath.startsWith(prefix);\n};\n  var computeActiveNavPath = function computeActiveNavPath(navItems, pathForMatchValue) {\n  const allNavPaths = navItems.flatMap((item) => {\n    const paths = [item.path];\n    if (item.children) {\n      paths.push(...item.children.map((child) => child.path));\n    }\n    return paths;\n  });\n  return allNavPaths.filter((p) => pathMatchesNavPath(pathForMatchValue, p)).sort((a, b) => b.length - a.length)[0];\n};\n\n  // Recompute which header nav item is \"active\" from the CURRENT URL and\n  // repaint the highlight. SSR sets the active item on first paint, but the\n  // header is persisted across same-locale client-router swaps\n  // (data-zfb-transition-persist), so without this the highlight would stay\n  // frozen on the page where the header was first rendered. Mirrors the\n  // sidebar island's client-side approach (match the current path against\n  // each entry's href) and the SSR longest-match + dropdown-parent rules.\n  // URL-based: hrefs and the current path both carry the base + locale\n  // prefix, so they compare directly without stripping.\n  function applyActiveNav() {\n    var nav = document.querySelector(\"[data-header-nav]\");\n    if (!nav) return;\n    var topItems = Array.from(nav.querySelectorAll(\":scope > [data-nav-item]\"));\n    if (topItems.length === 0) return;\n\n    var cur = trimSlashes(readCurrentPath(CURRENT_PATH_DATASET_KEY));\n\n    // Build NavItemLike-shaped entries from the live DOM so the shared\n    // computeActiveNavPath can do the deepest-match walk — the same call\n    // shape the SSR header uses (matches computeActiveNavPath). A dropdown\n    // missing its own top-level anchor is skipped entirely (path \"\" would\n    // otherwise match every current path — pathMatchesNavPath treats \"\" as\n    // the root \"/\"), mirroring the parentLink guard used below for the same\n    // malformed-markup case.\n    var navItems = [];\n    topItems.forEach(function (it) {\n      var isDropdown = it.hasAttribute(\"data-nav-item-dropdown\");\n      var topA = isDropdown ? it.querySelector(\":scope > a\") : it;\n      if (!topA) return;\n      var children = [];\n      if (isDropdown) {\n        it.querySelectorAll(\":scope > div a\").forEach(function (c) {\n          children.push({ path: navPathname(c) });\n        });\n      }\n      navItems.push({ path: navPathname(topA), children: children });\n    });\n\n    var activePath = computeActiveNavPath(navItems, cur) || \"\";\n\n    function setTopActive(a, active) {\n      if (!a) return;\n      if (active) {\n        a.classList.add(\"bg-fg\", \"text-bg\");\n        a.classList.remove(\"text-muted\", \"hover:text-accent\", \"hover:underline\", \"focus:underline\", \"focus:text-accent\");\n        a.setAttribute(\"aria-current\", \"page\");\n      } else {\n        a.classList.remove(\"bg-fg\", \"text-bg\");\n        a.classList.add(\"text-muted\", \"hover:text-accent\", \"hover:underline\", \"focus:underline\", \"focus:text-accent\");\n        a.removeAttribute(\"aria-current\");\n      }\n    }\n\n    topItems.forEach(function (it) {\n      var isDropdown = it.hasAttribute(\"data-nav-item-dropdown\");\n      var topA = isDropdown ? it.querySelector(\":scope > a\") : it;\n      var topActive = false;\n\n      if (isDropdown) {\n        var parentMatch = !!topA && navPathname(topA) === activePath && activePath !== \"\";\n        var anyChild = false;\n        it.querySelectorAll(\":scope > div a\").forEach(function (c) {\n          var childActive = navPathname(c) === activePath && activePath !== \"\";\n          if (childActive) {\n            anyChild = true;\n            c.setAttribute(\"data-active\", \"\");\n            c.classList.add(\"font-bold\", \"text-accent\");\n            c.classList.remove(\"text-fg\", \"hover:text-accent\", \"focus-visible:text-accent\");\n          } else {\n            c.removeAttribute(\"data-active\");\n            c.classList.remove(\"font-bold\", \"text-accent\");\n            c.classList.add(\"text-fg\", \"hover:text-accent\", \"focus-visible:text-accent\");\n          }\n        });\n        topActive = parentMatch || anyChild;\n        var svg = topA ? topA.querySelector(\"svg\") : null;\n        if (svg) {\n          if (topActive) { svg.classList.add(\"text-bg\"); svg.classList.remove(\"text-muted\"); }\n          else { svg.classList.add(\"text-muted\"); svg.classList.remove(\"text-bg\"); }\n        }\n      } else {\n        topActive = activePath !== \"\" && navPathname(topA) === activePath;\n      }\n\n      setTopActive(topA, topActive);\n    });\n  }\n\n  function initNavOverflow() {\n    if (cleanupNavOverflow) cleanupNavOverflow();\n\n    // Repaint the active highlight for the current URL before measuring /\n    // cloning, so the overflow \"···\" menu mirrors the correct active state.\n    applyActiveNav();\n\n    var nav = document.querySelector(\"[data-header-nav]\");\n    var moreContainer = document.querySelector(\"[data-nav-more]\");\n    var moreMenu = document.querySelector(\"[data-nav-more-menu]\");\n    var moreToggle = document.querySelector(\"[data-nav-more-toggle]\");\n    if (!nav || !moreContainer || !moreMenu || !moreToggle) return;\n\n    var items = Array.from(nav.querySelectorAll(\":scope > [data-nav-item]\"));\n    if (items.length === 0) return;\n\n    var controller = new AbortController();\n\n    function update() {\n      items.forEach(function (el) { el.style.display = \"\"; });\n      moreContainer.style.display = \"\";\n      moreMenu.innerHTML = \"\";\n      moreMenu.classList.add(\"hidden\");\n      moreToggle.setAttribute(\"aria-expanded\", \"false\");\n\n      var itemWidths = items.map(function (el) { return el.offsetWidth; });\n      var moreWidth = moreContainer.offsetWidth;\n      var navGap = parseFloat(getComputedStyle(nav).columnGap) || 0;\n      var available = nav.clientWidth;\n\n      if (available <= 0) {\n        moreContainer.style.display = \"none\";\n        return;\n      }\n\n      var total = 0;\n      for (var i = 0; i < itemWidths.length; i++) {\n        total += itemWidths[i] + (i > 0 ? navGap : 0);\n      }\n\n      if (total <= available) {\n        moreContainer.style.display = \"none\";\n        return;\n      }\n\n      var used = 0;\n      var cutoffIndex = 0;\n\n      for (var i2 = 0; i2 < items.length; i2++) {\n        var w = itemWidths[i2] + (i2 > 0 ? navGap : 0);\n        if (used + w > available - moreWidth - navGap) break;\n        used += w;\n        cutoffIndex = i2 + 1;\n      }\n\n      for (var i3 = cutoffIndex; i3 < items.length; i3++) {\n        items[i3].style.display = \"none\";\n      }\n\n      for (var i4 = cutoffIndex; i4 < items.length; i4++) {\n        var el = items[i4];\n        var isDropdown = el.hasAttribute(\"data-nav-item-dropdown\");\n\n        if (isDropdown) {\n          var parentLink = el.querySelector(\":scope > a\");\n          var childLinks = el.querySelectorAll(\":scope > div a\");\n          if (parentLink) {\n            var li = document.createElement(\"li\");\n            var a = document.createElement(\"a\");\n            a.href = parentLink.href;\n            var parentText = parentLink.textContent ? parentLink.textContent.trim().replace(/\\s+/g, \" \") : \"\";\n            a.textContent = parentText;\n            a.className = \"block px-hsp-md py-vsp-2xs text-small font-bold hover:bg-accent/10 hover:underline focus-visible:underline focus-visible:text-accent text-fg hover:text-accent\";\n            if (parentLink.getAttribute(\"aria-current\") === \"page\") {\n              a.className += \" text-accent\";\n            }\n            li.appendChild(a);\n            moreMenu.appendChild(li);\n          }\n          childLinks.forEach(function (child) {\n            var li = document.createElement(\"li\");\n            var a = document.createElement(\"a\");\n            a.href = child.href;\n            a.textContent = child.textContent ? child.textContent.trim() : \"\";\n            var isChildActive = child.hasAttribute(\"data-active\");\n            a.className = isChildActive\n              ? \"block pl-hsp-xl pr-hsp-md py-vsp-2xs text-small font-bold text-accent hover:bg-accent/10 hover:underline focus-visible:underline\"\n              : \"block pl-hsp-xl pr-hsp-md py-vsp-2xs text-small text-fg hover:bg-accent/10 hover:text-accent hover:underline focus-visible:underline focus-visible:text-accent\";\n            li.appendChild(a);\n            moreMenu.appendChild(li);\n          });\n        } else {\n          var anchor = el;\n          var li2 = document.createElement(\"li\");\n          var a2 = document.createElement(\"a\");\n          a2.href = anchor.href;\n          a2.textContent = anchor.textContent ? anchor.textContent.trim() : \"\";\n          a2.className = \"block px-hsp-md py-vsp-2xs text-small hover:bg-accent/10 hover:underline focus-visible:underline focus-visible:text-accent text-fg hover:text-accent\";\n          if (anchor.getAttribute(\"aria-current\") === \"page\") {\n            a2.className += \" font-bold text-accent\";\n          }\n          li2.appendChild(a2);\n          moreMenu.appendChild(li2);\n        }\n      }\n    }\n\n    moreToggle.addEventListener(\"click\", function () {\n      var isOpen = !moreMenu.classList.contains(\"hidden\");\n      moreMenu.classList.toggle(\"hidden\", isOpen);\n      moreToggle.setAttribute(\"aria-expanded\", String(!isOpen));\n    }, { signal: controller.signal });\n\n    document.addEventListener(\"click\", function (e) {\n      if (!moreContainer.contains(e.target)) {\n        moreMenu.classList.add(\"hidden\");\n        moreToggle.setAttribute(\"aria-expanded\", \"false\");\n      }\n    }, { signal: controller.signal });\n\n    document.addEventListener(\"keydown\", function (e) {\n      if (e.key !== \"Escape\") return;\n      if (!moreMenu.classList.contains(\"hidden\")) {\n        moreMenu.classList.add(\"hidden\");\n        moreToggle.setAttribute(\"aria-expanded\", \"false\");\n        moreToggle.focus();\n        return;\n      }\n      var active = document.activeElement;\n      var dropdown = active && active.closest ? active.closest(\"[data-nav-item-dropdown]\") : null;\n      if (dropdown && active && active.blur) {\n        active.blur();\n      }\n    }, { signal: controller.signal });\n\n    var dropdowns = nav.querySelectorAll(\"[data-nav-item-dropdown]\");\n    dropdowns.forEach(function (dd) {\n      var trigger = dd.querySelector(\":scope > a\");\n      if (!trigger) return;\n      function setExpanded(v) {\n        trigger.setAttribute(\"aria-expanded\", String(v));\n      }\n      dd.addEventListener(\"mouseenter\", function () { setExpanded(true); }, { signal: controller.signal });\n      dd.addEventListener(\"mouseleave\", function () { setExpanded(false); }, { signal: controller.signal });\n      dd.addEventListener(\"focusin\", function () { setExpanded(true); }, { signal: controller.signal });\n      dd.addEventListener(\"focusout\", function (e) {\n        if (!dd.contains(e.relatedTarget)) {\n          setExpanded(false);\n        }\n      }, { signal: controller.signal });\n    });\n\n    var ro = new ResizeObserver(update);\n    ro.observe(nav);\n    controller.signal.addEventListener(\"abort\", function () { ro.disconnect(); });\n\n    document.fonts.ready.then(update);\n\n    update();\n\n    cleanupNavOverflow = function () { controller.abort(); };\n  }\n\n  initNavOverflow();\n  document.addEventListener(\"zfb:after-swap\", initNavOverflow);\n})();";
+}
+
+/** Client-side script string for the desktop header nav overflow controller.
+ * See the module header of this generator for the embedding contract; see
+ * current-path/index.ts / header/nav-active.ts / header/nav-class-tokens.ts /
+ * transitions/page-events.ts for the frozen sources. */
+export const NAV_OVERFLOW_SCRIPT: string = buildNavOverflowScript();