@takazudo/zudo-doc 5.28.2 → 6.0.0

package/dist/html-preview-wrapper/wrapper.d.ts

@@ -0,0 +1,20 @@
+/** @jsxRuntime automatic */
+import type { Child } from "@takazudo/zfb/zudo-react";
+import { type HtmlPreviewWrapperProps } from "./html-preview-wrapper.js";
+/**
+ * HTML preview wrapper component — the public MDX-registered binding
+ * (`HtmlPreview: HtmlPreviewWrapper`).
+ *
+ * Eager mode wraps the bare `HtmlPreviewWrapperInner` in
+ * `<Island when="visible">`, mirroring the legacy `client:visible` hydration
+ * timing while preserving the server-rendered controls and iframe. Visible mode
+ * uses zfb's skip-SSR fallback path: static output contains only an inert
+ * nonzero reservation, while the real serializable inner props remain on the
+ * island marker for native visible scheduling and client mount.
+ *
+ * The public export name and signature are unchanged from before the
+ * zudolab/zudo-doc#1925 fix, so existing consumers that register
+ * `HtmlPreview: HtmlPreviewWrapper` keep working (and now hydrate correctly)
+ * with no call-site change.
+ */
+export declare function HtmlPreviewWrapper(props: HtmlPreviewWrapperProps): Child;

package/dist/html-preview-wrapper/wrapper.js

@@ -0,0 +1,37 @@
+import { jsx } from "@takazudo/zfb/zudo-react/jsx-runtime";
+import { Island } from "@takazudo/zfb";
+import { HtmlPreviewWrapperInner } from "./html-preview-wrapper.js";
+function reservationHeight(height) {
+  return height != null && height > 0 ? height : 200;
+}
+function HtmlPreviewReservation({
+  height
+}) {
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      "aria-hidden": "true",
+      "data-zd-html-preview-reservation": true,
+      style: { height: `${reservationHeight(height)}px` }
+    }
+  );
+}
+function HtmlPreviewWrapper(props) {
+  const { loading = "eager", ...innerProps } = props;
+  if (loading === "visible") {
+    const rendered2 = Island({
+      when: "visible",
+      ssrFallback: /* @__PURE__ */ jsx(HtmlPreviewReservation, { height: innerProps.height }),
+      children: /* @__PURE__ */ jsx(HtmlPreviewWrapperInner, { ...innerProps })
+    });
+    return rendered2;
+  }
+  const rendered = Island({
+    when: "visible",
+    children: /* @__PURE__ */ jsx(HtmlPreviewWrapperInner, { ...innerProps })
+  });
+  return rendered;
+}
+export {
+  HtmlPreviewWrapper
+};

package/dist/hydration-pending.d.ts

@@ -1,5 +1,3 @@
-/**
- * Keep an interactive control pending until its first successful client mount.
- * Initializing from `enabled` preserves server/client-first-render parity.
- */
-export declare function useHydrationPending(enabled: boolean): boolean;
+import type { ReadonlySignal, Scope } from "@takazudo/zfb/zudo-react";
+/** Keep SSR and the first client render pending, then release on activation. */
+export declare function hydrationPending(scope: Scope, enabled: boolean): ReadonlySignal<boolean>;

package/dist/hydration-pending.js

@@ -1,9 +1,11 @@
-import { useEffect, useState } from "preact/hooks";
-function useHydrationPending(enabled) {
-  const [pending, setPending] = useState(enabled);
-  useEffect(() => setPending(false), []);
+import { signal } from "@takazudo/zfb/zudo-react";
+function hydrationPending(scope, enabled) {
+  const pending = signal(enabled);
+  scope.onActivate(() => {
+    pending.value = false;
+  });
   return pending;
 }
 export {
-  useHydrationPending
+  hydrationPending
 };

package/dist/i18n-version/language-switcher.d.ts

@@ -1,35 +1,8 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-import type { VNode } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
 import type { LocaleLink } from "./types.js";
-/**
- * The minimal project config the client re-wire needs to reproduce
- * `getPathForLocale`'s output from the live pathname. Emitted as `data-*`
- * attributes on the switcher container so {@link LANGUAGE_SWITCHER_INIT_SCRIPT}
- * can read it without any serialized props.
- */
-export interface LanguageSwitcherConfig {
-    /** Normalized site base with no trailing slash (`""` for a root site). */
-    base: string;
-    /** The project's default locale (rendered without a locale prefix). */
-    defaultLocale: string;
-    /** Whether the project appends trailing slashes to page URLs. */
-    trailingSlash: boolean;
-}
-/**
- * Client-side re-computation of a locale-switched href from the *current*
- * pathname. This is a self-contained port of `getPathForLocale` (+ its
- * `stripBase` / version-prefix split / `withBase` / `applyTrailingSlash`
- * dependencies) from `url-helpers`. It MUST stay behaviourally identical to
- * that function — pinned by the drift-guard test in
- * `__tests__/language-switcher.test.tsx`, which asserts equality against the
- * real `buildLocaleLinks` output across a case table.
- *
- * It is deliberately self-contained (no references to module-scope helpers)
- * because {@link LANGUAGE_SWITCHER_INIT_SCRIPT} embeds it verbatim via
- * `.toString()`, so it must be valid as a standalone function in the browser.
- */
-export declare function switchLocaleHref(pathname: string, config: LanguageSwitcherConfig, currentLang: string, targetLang: string): string;
+import type { LanguageSwitcherConfig } from "./switcher-url-state.js";
+export { switchLocaleHref, type LanguageSwitcherConfig } from "./switcher-url-state.js";
 /**
  * Inline init script that keeps the switcher's per-page hrefs correct inside a
  * persisted header. Mounted once wherever a header is rendered (see
@@ -48,7 +21,7 @@ export declare function switchLocaleHref(pathname: string, config: LanguageSwitc
  * `nav-overflow-script.ts` / `sidebar-tree-island` / `version-switcher.tsx`
  * use (zudolab/zudo-doc#3398, consolidated by #3408).
  */
-export declare const LANGUAGE_SWITCHER_INIT_SCRIPT: string;
+export { LANGUAGE_SWITCHER_INIT_SCRIPT } from "./switcher-generated-scripts.js";
 export interface LanguageSwitcherProps {
     /**
      * Pre-built locale links, ordered as they should appear in the bar.
@@ -81,5 +54,5 @@ export interface LanguageSwitcherProps {
  * template's `localeLinks.length > 1 &&` guard so call-sites can mount
  * the component unconditionally).
  */
-export declare function LanguageSwitcher({ links, config, currentLocale, accessibleLabel, idSuffix, }: LanguageSwitcherProps): VNode | null;
+export declare function LanguageSwitcher({ links, config, currentLocale, accessibleLabel, idSuffix, }: LanguageSwitcherProps): Child;
 export type { LocaleLink };

package/dist/i18n-version/language-switcher.js

@@ -1,106 +1,6 @@
-import { jsx, jsxs } from "preact/jsx-runtime";
-import { AFTER_NAVIGATE_EVENT } from "../transitions/index.js";
-import { CURRENT_PATH_SCRIPT_PRELUDE } from "../current-path/index.js";
-function switchLocaleHref(pathname, config, currentLang, targetLang) {
-  const normalizedBase = config.base;
-  const defaultLocale = config.defaultLocale;
-  const trailingSlash = config.trailingSlash;
-  const stripBase = (path) => {
-    if (normalizedBase === "") return path;
-    if (path === normalizedBase) return "/";
-    return path.indexOf(normalizedBase + "/") === 0 ? path.slice(normalizedBase.length) : path;
-  };
-  const applyTrailingSlash = (url) => {
-    if (!trailingSlash) return url;
-    if (url.charAt(url.length - 1) === "/") return url;
-    const suffixIdx = url.search(/[?#]/);
-    const pathPart = suffixIdx >= 0 ? url.slice(0, suffixIdx) : url;
-    const suffix = suffixIdx >= 0 ? url.slice(suffixIdx) : "";
-    if (pathPart.charAt(pathPart.length - 1) === "/") return url;
-    const segments = pathPart.split("/");
-    const lastSegment = segments[segments.length - 1] || "";
-    if (/\.[a-zA-Z]\w*$/.test(lastSegment)) return url;
-    return pathPart + "/" + suffix;
-  };
-  const withBase = (path) => {
-    const raw = normalizedBase === "" ? path : normalizedBase + (path.charAt(0) === "/" ? path : "/" + path);
-    return applyTrailingSlash(raw);
-  };
-  const stripped = stripBase(pathname);
-  const versionMatch = stripped.match(/^(\/v\/[^/]+)(\/.*|$)/);
-  const versionPrefix = versionMatch ? versionMatch[1] || "" : "";
-  let relativePath = versionMatch ? versionMatch[2] || "/" : stripped;
-  if (currentLang !== defaultLocale) {
-    relativePath = relativePath.replace(
-      new RegExp("^/" + currentLang + "(?:/|$)"),
-      "/"
-    );
-  }
-  if (targetLang !== defaultLocale) {
-    relativePath = "/" + targetLang + relativePath;
-  }
-  return withBase(versionPrefix + relativePath);
-}
-const LANGUAGE_SWITCHER_INIT_SCRIPT = `(function(){
-var FLAG="__zdLanguageSwitcherInit";
-${CURRENT_PATH_SCRIPT_PRELUDE}
-var switchLocaleHref=${switchLocaleHref.toString()};
-function close(c,restoreFocus){
-var toggle=c.querySelector("[data-language-toggle]");
-var menu=c.querySelector("[data-language-menu]");
-if(!toggle||!menu)return;
-menu.classList.add("hidden");
-toggle.setAttribute("aria-expanded","false");
-if(restoreFocus)toggle.focus();
-}
-function refresh(){
-var containers=document.querySelectorAll("[data-language-switcher]");
-for(var i=0;i<containers.length;i++){
-var c=containers[i];
-close(c,false);
-var menu=c.querySelector("[data-language-menu]");
-if(menu){
-menu.classList.remove("group-hover:block","group-focus-within:block");
-}
-if(!c.hasAttribute("data-default-locale"))continue;
-var config={base:c.getAttribute("data-base")||"",defaultLocale:c.getAttribute("data-default-locale")||"",trailingSlash:c.getAttribute("data-trailing-slash")==="true"};
-var currentLang=c.getAttribute("data-current-locale")||config.defaultLocale;
-var anchors=c.querySelectorAll("a[lang]");
-for(var j=0;j<anchors.length;j++){
-var a=anchors[j];
-var target=a.getAttribute("lang");
-if(!target)continue;
-a.setAttribute("href",switchLocaleHref(readCurrentPath(CURRENT_PATH_DATASET_KEY),config,currentLang,target));
-}
-}
-}
-if(window[FLAG]){window[FLAG]();return;}
-window[FLAG]=refresh;
-document.addEventListener("click",function(e){
-var target=e.target;
-var toggle=target&&target.closest?target.closest("[data-language-toggle]"):null;
-if(toggle){
-var switcher=toggle.closest("[data-language-switcher]");
-if(switcher){
-var menu=switcher.querySelector("[data-language-menu]");
-var willOpen=toggle.getAttribute("aria-expanded")!=="true";
-document.querySelectorAll("[data-language-switcher]").forEach(function(c){if(c!==switcher)close(c,false);});
-if(menu){menu.classList.toggle("hidden",!willOpen);toggle.setAttribute("aria-expanded",String(willOpen));}
-}
-return;
-}
-document.querySelectorAll("[data-language-switcher]").forEach(function(c){if(!c.contains(target))close(c,false);});
-});
-document.addEventListener("keydown",function(e){
-if(e.key!=="Escape")return;
-document.querySelectorAll('[data-language-toggle][aria-expanded="true"]').forEach(function(toggle){
-var switcher=toggle.closest("[data-language-switcher]");
-if(switcher)close(switcher,true);
-});
-});
-refresh();
-document.addEventListener(${JSON.stringify(AFTER_NAVIGATE_EVENT)},refresh);
-})();`;
+import { jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
+import { switchLocaleHref } from "./switcher-url-state.js";
+import { LANGUAGE_SWITCHER_INIT_SCRIPT } from "./switcher-generated-scripts.js";
 function LanguageSwitcher({
   links,
   config,
@@ -130,7 +30,7 @@ function LanguageSwitcher({
           {
             type: "button",
             id: toggleId,
-            class: "flex max-w-[16rem] cursor-pointer items-center gap-hsp-2xs whitespace-nowrap rounded border border-muted px-hsp-sm py-vsp-3xs text-small text-muted transition-colors hover:border-accent hover:text-accent focus-visible:border-accent focus-visible:text-accent",
+            class: "flex max-w-[16rem] cursor-pointer items-center gap-hsp-2xs whitespace-nowrap rounded border border-muted px-hsp-sm py-vsp-3xs text-small text-muted transition-colors duration-0 hover:border-accent hover:text-accent focus-visible:border-accent focus-visible:text-accent",
             "aria-label": accessibleLabel,
             "aria-controls": menuId,
             "aria-expanded": "false",
@@ -146,7 +46,7 @@ function LanguageSwitcher({
           {
             id: menuId,
             "aria-labelledby": toggleId,
-            class: "absolute right-0 top-full z-dropdown mt-vsp-3xs hidden min-w-[8rem] max-w-[calc(100vw-var(--spacing-hsp-xl))] overflow-x-auto whitespace-nowrap rounded border border-muted bg-surface py-vsp-3xs shadow-lg group-hover:block group-focus-within:block",
+            class: "absolute right-0 top-full z-dropdown mt-vsp-3xs hidden min-w-[8rem] max-w-[calc(100vw_-_var(--spacing-hsp-xl))] overflow-x-auto whitespace-nowrap rounded border border-muted bg-surface py-vsp-3xs shadow-lg group-hover:block group-focus-within:block",
             "data-language-menu": true,
             children: links.map((link) => /* @__PURE__ */ jsx("li", { children: link.active ? /* @__PURE__ */ jsx(
               "span",
@@ -175,7 +75,6 @@ function ChevronDownIcon() {
   return /* @__PURE__ */ jsx(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: "h-icon-xs w-icon-xs shrink-0",
       fill: "none",
       viewBox: "0 0 24 24",

package/dist/i18n-version/switcher-generated-scripts.d.ts

@@ -0,0 +1,2 @@
+export declare const LANGUAGE_SWITCHER_INIT_SCRIPT = "(function(){\nvar FLAG=\"__zdLanguageSwitcherInit\";\nvar 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};\nvar switchLocaleHref=function switchLocaleHref(pathname, config, currentLang, targetLang) {\n  const normalizedBase = config.base;\n  const defaultLocale = config.defaultLocale;\n  const trailingSlash = config.trailingSlash;\n  const stripBase = (path) => {\n    if (normalizedBase === \"\") return path;\n    if (path === normalizedBase) return \"/\";\n    return path.indexOf(normalizedBase + \"/\") === 0 ? path.slice(normalizedBase.length) : path;\n  };\n  const applyTrailingSlash = (url) => {\n    if (!trailingSlash) return url;\n    if (url.charAt(url.length - 1) === \"/\") return url;\n    const suffixIdx = url.search(/[?#]/);\n    const pathPart = suffixIdx >= 0 ? url.slice(0, suffixIdx) : url;\n    const suffix = suffixIdx >= 0 ? url.slice(suffixIdx) : \"\";\n    if (pathPart.charAt(pathPart.length - 1) === \"/\") return url;\n    const segments = pathPart.split(\"/\");\n    const lastSegment = segments[segments.length - 1] || \"\";\n    if (/\\.[a-zA-Z]\\w*$/.test(lastSegment)) return url;\n    return pathPart + \"/\" + suffix;\n  };\n  const withBase = (path) => {\n    const raw = normalizedBase === \"\" ? path : normalizedBase + (path.charAt(0) === \"/\" ? path : \"/\" + path);\n    return applyTrailingSlash(raw);\n  };\n  const stripped = stripBase(pathname);\n  const versionMatch = stripped.match(/^(\\/v\\/[^/]+)(\\/.*|$)/);\n  const versionPrefix = versionMatch ? versionMatch[1] || \"\" : \"\";\n  let relativePath = versionMatch ? versionMatch[2] || \"/\" : stripped;\n  if (currentLang !== defaultLocale) {\n    relativePath = relativePath.replace(\n      new RegExp(\"^/\" + currentLang + \"(?:/|$)\"),\n      \"/\"\n    );\n  }\n  if (targetLang !== defaultLocale) {\n    relativePath = \"/\" + targetLang + relativePath;\n  }\n  return withBase(versionPrefix + relativePath);\n};\nfunction close(c,restoreFocus){\nvar toggle=c.querySelector(\"[data-language-toggle]\");\nvar menu=c.querySelector(\"[data-language-menu]\");\nif(!toggle||!menu)return;\nmenu.classList.add(\"hidden\");\ntoggle.setAttribute(\"aria-expanded\",\"false\");\nif(restoreFocus)toggle.focus();\n}\nfunction refresh(){\nvar containers=document.querySelectorAll(\"[data-language-switcher]\");\nfor(var i=0;i<containers.length;i++){\nvar c=containers[i];\nclose(c,false);\nvar menu=c.querySelector(\"[data-language-menu]\");\nif(menu){\nmenu.classList.remove(\"group-hover:block\",\"group-focus-within:block\");\n}\nif(!c.hasAttribute(\"data-default-locale\"))continue;\nvar config={base:c.getAttribute(\"data-base\")||\"\",defaultLocale:c.getAttribute(\"data-default-locale\")||\"\",trailingSlash:c.getAttribute(\"data-trailing-slash\")===\"true\"};\nvar currentLang=c.getAttribute(\"data-current-locale\")||config.defaultLocale;\nvar anchors=c.querySelectorAll(\"a[lang]\");\nfor(var j=0;j<anchors.length;j++){\nvar a=anchors[j];\nvar target=a.getAttribute(\"lang\");\nif(!target)continue;\na.setAttribute(\"href\",switchLocaleHref(readCurrentPath(CURRENT_PATH_DATASET_KEY),config,currentLang,target));\n}\n}\n}\nif(window[FLAG]){window[FLAG]();return;}\nwindow[FLAG]=refresh;\ndocument.addEventListener(\"click\",function(e){\nvar target=e.target;\nvar toggle=target&&target.closest?target.closest(\"[data-language-toggle]\"):null;\nif(toggle){\nvar switcher=toggle.closest(\"[data-language-switcher]\");\nif(switcher){\nvar menu=switcher.querySelector(\"[data-language-menu]\");\nvar willOpen=toggle.getAttribute(\"aria-expanded\")!==\"true\";\ndocument.querySelectorAll(\"[data-language-switcher]\").forEach(function(c){if(c!==switcher)close(c,false);});\nif(menu){menu.classList.toggle(\"hidden\",!willOpen);toggle.setAttribute(\"aria-expanded\",String(willOpen));}\n}\nreturn;\n}\ndocument.querySelectorAll(\"[data-language-switcher]\").forEach(function(c){if(!c.contains(target))close(c,false);});\n});\ndocument.addEventListener(\"keydown\",function(e){\nif(e.key!==\"Escape\")return;\ndocument.querySelectorAll('[data-language-toggle][aria-expanded=\"true\"]').forEach(function(toggle){\nvar switcher=toggle.closest(\"[data-language-switcher]\");\nif(switcher)close(switcher,true);\n});\n});\nrefresh();\ndocument.addEventListener(\"zfb:after-swap\",refresh);\n})();";
+export declare const VERSION_SWITCHER_REWIRE_SCRIPT = "(function(){\nvar FLAG=\"__zdVersionSwitcherRewire\";\nif(window[FLAG])return;\nwindow[FLAG]=true;\nvar ATTR=\"data-doc-unavailable-versions\";\nvar 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};\nvar computeVersionSwitcherState=function computeVersionSwitcherState(pathname, config, versionSlugs) {\n  const normalizedBase = config.base;\n  const defaultLocale = config.defaultLocale;\n  const currentLocale = config.currentLocale;\n  const trailingSlash = config.trailingSlash;\n  const stripBase = (path) => {\n    if (normalizedBase === \"\") return path;\n    if (path === normalizedBase) return \"/\";\n    return path.indexOf(normalizedBase + \"/\") === 0 ? path.slice(normalizedBase.length) : path;\n  };\n  const applyTrailingSlash = (url) => {\n    if (!trailingSlash) return url;\n    if (url.charAt(url.length - 1) === \"/\") return url;\n    const suffixIdx = url.search(/[?#]/);\n    const pathPart = suffixIdx >= 0 ? url.slice(0, suffixIdx) : url;\n    const suffix = suffixIdx >= 0 ? url.slice(suffixIdx) : \"\";\n    if (pathPart.charAt(pathPart.length - 1) === \"/\") return url;\n    const segments = pathPart.split(\"/\");\n    const lastSegment = segments[segments.length - 1] || \"\";\n    if (/\\.[a-zA-Z]\\w*$/.test(lastSegment)) return url;\n    return pathPart + \"/\" + suffix;\n  };\n  const withBase = (path) => {\n    const raw = normalizedBase === \"\" ? path : normalizedBase + (path.charAt(0) === \"/\" ? path : \"/\" + path);\n    return applyTrailingSlash(raw);\n  };\n  const versionsPageUrl = withBase(\n    currentLocale === defaultLocale ? \"/docs/versions\" : \"/\" + currentLocale + \"/docs/versions\"\n  );\n  const stripped = stripBase(pathname);\n  const versionMatch = stripped.match(/^\\/v\\/([^/]+)(\\/.*|$)/);\n  const rest = versionMatch ? versionMatch[2] || \"/\" : stripped;\n  let localeStripped = rest;\n  if (currentLocale !== defaultLocale) {\n    localeStripped = rest.replace(\n      new RegExp(\"^/\" + currentLocale + \"(?:/|$)\"),\n      \"/\"\n    );\n  }\n  const isVersionsIndex = localeStripped === \"/docs/versions\" || localeStripped === \"/docs/versions/\";\n  const isDocPage = /^\\/docs(\\/|$)/.test(localeStripped) && !isVersionsIndex;\n  const activeVersion = isDocPage && versionMatch ? versionMatch[1] || null : null;\n  const versionHrefs = {};\n  let latestHref;\n  if (isDocPage) {\n    latestHref = withBase(rest);\n    for (let i = 0; i < versionSlugs.length; i++) {\n      const slug = versionSlugs[i];\n      if (slug) versionHrefs[slug] = withBase(\"/v/\" + slug + rest);\n    }\n  } else {\n    latestHref = versionsPageUrl;\n    for (let i = 0; i < versionSlugs.length; i++) {\n      const slug = versionSlugs[i];\n      if (slug) versionHrefs[slug] = versionsPageUrl;\n    }\n  }\n  return { latestHref, versionHrefs, activeVersion };\n};\nfunction setActive(a,active){\na.classList.toggle(\"font-bold\",active);\na.classList.toggle(\"text-accent\",active);\na.classList.toggle(\"text-fg\",!active);\nif(active){a.setAttribute(\"aria-current\",\"page\");}else{a.removeAttribute(\"aria-current\");}\n}\nfunction setDisabled(a,disabled,unavailableLabel){\na.classList.toggle(\"hover:bg-accent/10\",!disabled);\na.classList.toggle(\"hover:underline\",!disabled);\na.classList.toggle(\"focus-visible:underline\",!disabled);\na.classList.toggle(\"text-muted/50\",disabled);\na.classList.toggle(\"cursor-not-allowed\",disabled);\na.classList.toggle(\"pointer-events-none\",disabled);\nif(disabled){\na.setAttribute(\"aria-disabled\",\"true\");\na.setAttribute(\"tabindex\",\"-1\");\na.setAttribute(\"title\",unavailableLabel);\na.classList.remove(\"font-bold\",\"text-accent\",\"text-fg\");\na.removeAttribute(\"aria-current\");\n}else{\na.removeAttribute(\"aria-disabled\");\na.removeAttribute(\"tabindex\");\na.removeAttribute(\"title\");\n}\n}\nfunction rewire(){\nvar articleEl=document.querySelector(\"[\"+ATTR+\"]\");\nvar hasAvailabilityData=articleEl!==null;\nvar unavailableSlugs=hasAvailabilityData?(articleEl.getAttribute(ATTR)||\"\").split(\",\").filter(Boolean):[];\nvar containers=document.querySelectorAll(\"[data-version-rewire]\");\nfor(var i=0;i<containers.length;i++){\nvar c=containers[i];\nvar config={base:c.getAttribute(\"data-base\")||\"\",defaultLocale:c.getAttribute(\"data-default-locale\")||\"\",trailingSlash:c.getAttribute(\"data-trailing-slash\")===\"true\",currentLocale:c.getAttribute(\"data-current-locale\")||\"\"};\nvar unavailableLabel=c.getAttribute(\"data-unavailable-label\")||\"\";\nvar versionAnchors=c.querySelectorAll(\"[data-version-slug]\");\nvar slugs=[];\nfor(var j=0;j<versionAnchors.length;j++){\nvar s=versionAnchors[j].getAttribute(\"data-version-slug\");\nif(s)slugs.push(s);\n}\nvar state=computeVersionSwitcherState(readCurrentPath(CURRENT_PATH_DATASET_KEY),config,slugs);\nvar latest=c.querySelector(\"[data-version-latest]\");\nif(latest){\nlatest.setAttribute(\"href\",state.latestHref);\nsetActive(latest,state.activeVersion===null);\n}\nfor(var k=0;k<versionAnchors.length;k++){\nvar a=versionAnchors[k];\nvar slug=a.getAttribute(\"data-version-slug\");\nif(!slug)continue;\nvar href=state.versionHrefs[slug];\nif(href!=null)a.setAttribute(\"href\",href);\nif(hasAvailabilityData){\nvar disabled=unavailableSlugs.indexOf(slug)!==-1;\nsetDisabled(a,disabled,unavailableLabel);\nif(!disabled)setActive(a,state.activeVersion===slug);\n}else{\nvar alreadyDisabled=a.getAttribute(\"aria-disabled\")===\"true\";\nif(!alreadyDisabled)setActive(a,state.activeVersion===slug);\n}\n}\nvar label=c.querySelector(\"[data-version-trigger-label]\");\nif(label){\nif(state.activeVersion===null){\nif(latest)label.textContent=latest.textContent;\n}else{\nvar activeLabel=null;\nfor(var m=0;m<versionAnchors.length;m++){\nif(versionAnchors[m].getAttribute(\"data-version-slug\")===state.activeVersion){activeLabel=versionAnchors[m].textContent;break;}\n}\nlabel.textContent=activeLabel!=null?activeLabel:state.activeVersion;\n}\n}\n}\n}\n// The initial call is deferred to DOMContentLoaded when the script (inline in\n// <header>, which parses before <article>) would otherwise run before the\n// article element exists. Running early would read a missing ATTR as \"no\n// unavailable slugs\" and clobber the SSR-correct disabled state with\n// everything-enabled \u2014 a first-paint variant of the bug this rewire exists\n// to fix (see the doc comment above; SSR already rendered the right state for\n// this page, so a brief deferral loses nothing).\nif(document.readyState===\"loading\"){document.addEventListener(\"DOMContentLoaded\",rewire);}else{rewire();}\ndocument.addEventListener(\"zfb:after-swap\",rewire);\n})();";

package/dist/i18n-version/switcher-generated-scripts.js

@@ -0,0 +1,107 @@
+const LANGUAGE_SWITCHER_INIT_SCRIPT = `(function(){
+var FLAG="__zdLanguageSwitcherInit";
+var CURRENT_PATH_DATASET_KEY="zdCurrentPath";var readCurrentPath=function readCurrentPath(datasetKey, explicit) {
+  const override = typeof document === "undefined" ? void 0 : document.documentElement.dataset[datasetKey];
+  return explicit || override || (typeof window === "undefined" ? void 0 : window.location.pathname);
+};
+var switchLocaleHref=function switchLocaleHref(pathname, config, currentLang, targetLang) {
+  const normalizedBase = config.base;
+  const defaultLocale = config.defaultLocale;
+  const trailingSlash = config.trailingSlash;
+  const stripBase = (path) => {
+    if (normalizedBase === "") return path;
+    if (path === normalizedBase) return "/";
+    return path.indexOf(normalizedBase + "/") === 0 ? path.slice(normalizedBase.length) : path;
+  };
+  const applyTrailingSlash = (url) => {
+    if (!trailingSlash) return url;
+    if (url.charAt(url.length - 1) === "/") return url;
+    const suffixIdx = url.search(/[?#]/);
+    const pathPart = suffixIdx >= 0 ? url.slice(0, suffixIdx) : url;
+    const suffix = suffixIdx >= 0 ? url.slice(suffixIdx) : "";
+    if (pathPart.charAt(pathPart.length - 1) === "/") return url;
+    const segments = pathPart.split("/");
+    const lastSegment = segments[segments.length - 1] || "";
+    if (/\\.[a-zA-Z]\\w*$/.test(lastSegment)) return url;
+    return pathPart + "/" + suffix;
+  };
+  const withBase = (path) => {
+    const raw = normalizedBase === "" ? path : normalizedBase + (path.charAt(0) === "/" ? path : "/" + path);
+    return applyTrailingSlash(raw);
+  };
+  const stripped = stripBase(pathname);
+  const versionMatch = stripped.match(/^(\\/v\\/[^/]+)(\\/.*|$)/);
+  const versionPrefix = versionMatch ? versionMatch[1] || "" : "";
+  let relativePath = versionMatch ? versionMatch[2] || "/" : stripped;
+  if (currentLang !== defaultLocale) {
+    relativePath = relativePath.replace(
+      new RegExp("^/" + currentLang + "(?:/|$)"),
+      "/"
+    );
+  }
+  if (targetLang !== defaultLocale) {
+    relativePath = "/" + targetLang + relativePath;
+  }
+  return withBase(versionPrefix + relativePath);
+};
+function close(c,restoreFocus){
+var toggle=c.querySelector("[data-language-toggle]");
+var menu=c.querySelector("[data-language-menu]");
+if(!toggle||!menu)return;
+menu.classList.add("hidden");
+toggle.setAttribute("aria-expanded","false");
+if(restoreFocus)toggle.focus();
+}
+function refresh(){
+var containers=document.querySelectorAll("[data-language-switcher]");
+for(var i=0;i<containers.length;i++){
+var c=containers[i];
+close(c,false);
+var menu=c.querySelector("[data-language-menu]");
+if(menu){
+menu.classList.remove("group-hover:block","group-focus-within:block");
+}
+if(!c.hasAttribute("data-default-locale"))continue;
+var config={base:c.getAttribute("data-base")||"",defaultLocale:c.getAttribute("data-default-locale")||"",trailingSlash:c.getAttribute("data-trailing-slash")==="true"};
+var currentLang=c.getAttribute("data-current-locale")||config.defaultLocale;
+var anchors=c.querySelectorAll("a[lang]");
+for(var j=0;j<anchors.length;j++){
+var a=anchors[j];
+var target=a.getAttribute("lang");
+if(!target)continue;
+a.setAttribute("href",switchLocaleHref(readCurrentPath(CURRENT_PATH_DATASET_KEY),config,currentLang,target));
+}
+}
+}
+if(window[FLAG]){window[FLAG]();return;}
+window[FLAG]=refresh;
+document.addEventListener("click",function(e){
+var target=e.target;
+var toggle=target&&target.closest?target.closest("[data-language-toggle]"):null;
+if(toggle){
+var switcher=toggle.closest("[data-language-switcher]");
+if(switcher){
+var menu=switcher.querySelector("[data-language-menu]");
+var willOpen=toggle.getAttribute("aria-expanded")!=="true";
+document.querySelectorAll("[data-language-switcher]").forEach(function(c){if(c!==switcher)close(c,false);});
+if(menu){menu.classList.toggle("hidden",!willOpen);toggle.setAttribute("aria-expanded",String(willOpen));}
+}
+return;
+}
+document.querySelectorAll("[data-language-switcher]").forEach(function(c){if(!c.contains(target))close(c,false);});
+});
+document.addEventListener("keydown",function(e){
+if(e.key!=="Escape")return;
+document.querySelectorAll('[data-language-toggle][aria-expanded="true"]').forEach(function(toggle){
+var switcher=toggle.closest("[data-language-switcher]");
+if(switcher)close(switcher,true);
+});
+});
+refresh();
+document.addEventListener("zfb:after-swap",refresh);
+})();`;
+const VERSION_SWITCHER_REWIRE_SCRIPT = '(function(){\nvar FLAG="__zdVersionSwitcherRewire";\nif(window[FLAG])return;\nwindow[FLAG]=true;\nvar ATTR="data-doc-unavailable-versions";\nvar 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};\nvar computeVersionSwitcherState=function computeVersionSwitcherState(pathname, config, versionSlugs) {\n  const normalizedBase = config.base;\n  const defaultLocale = config.defaultLocale;\n  const currentLocale = config.currentLocale;\n  const trailingSlash = config.trailingSlash;\n  const stripBase = (path) => {\n    if (normalizedBase === "") return path;\n    if (path === normalizedBase) return "/";\n    return path.indexOf(normalizedBase + "/") === 0 ? path.slice(normalizedBase.length) : path;\n  };\n  const applyTrailingSlash = (url) => {\n    if (!trailingSlash) return url;\n    if (url.charAt(url.length - 1) === "/") return url;\n    const suffixIdx = url.search(/[?#]/);\n    const pathPart = suffixIdx >= 0 ? url.slice(0, suffixIdx) : url;\n    const suffix = suffixIdx >= 0 ? url.slice(suffixIdx) : "";\n    if (pathPart.charAt(pathPart.length - 1) === "/") return url;\n    const segments = pathPart.split("/");\n    const lastSegment = segments[segments.length - 1] || "";\n    if (/\\.[a-zA-Z]\\w*$/.test(lastSegment)) return url;\n    return pathPart + "/" + suffix;\n  };\n  const withBase = (path) => {\n    const raw = normalizedBase === "" ? path : normalizedBase + (path.charAt(0) === "/" ? path : "/" + path);\n    return applyTrailingSlash(raw);\n  };\n  const versionsPageUrl = withBase(\n    currentLocale === defaultLocale ? "/docs/versions" : "/" + currentLocale + "/docs/versions"\n  );\n  const stripped = stripBase(pathname);\n  const versionMatch = stripped.match(/^\\/v\\/([^/]+)(\\/.*|$)/);\n  const rest = versionMatch ? versionMatch[2] || "/" : stripped;\n  let localeStripped = rest;\n  if (currentLocale !== defaultLocale) {\n    localeStripped = rest.replace(\n      new RegExp("^/" + currentLocale + "(?:/|$)"),\n      "/"\n    );\n  }\n  const isVersionsIndex = localeStripped === "/docs/versions" || localeStripped === "/docs/versions/";\n  const isDocPage = /^\\/docs(\\/|$)/.test(localeStripped) && !isVersionsIndex;\n  const activeVersion = isDocPage && versionMatch ? versionMatch[1] || null : null;\n  const versionHrefs = {};\n  let latestHref;\n  if (isDocPage) {\n    latestHref = withBase(rest);\n    for (let i = 0; i < versionSlugs.length; i++) {\n      const slug = versionSlugs[i];\n      if (slug) versionHrefs[slug] = withBase("/v/" + slug + rest);\n    }\n  } else {\n    latestHref = versionsPageUrl;\n    for (let i = 0; i < versionSlugs.length; i++) {\n      const slug = versionSlugs[i];\n      if (slug) versionHrefs[slug] = versionsPageUrl;\n    }\n  }\n  return { latestHref, versionHrefs, activeVersion };\n};\nfunction setActive(a,active){\na.classList.toggle("font-bold",active);\na.classList.toggle("text-accent",active);\na.classList.toggle("text-fg",!active);\nif(active){a.setAttribute("aria-current","page");}else{a.removeAttribute("aria-current");}\n}\nfunction setDisabled(a,disabled,unavailableLabel){\na.classList.toggle("hover:bg-accent/10",!disabled);\na.classList.toggle("hover:underline",!disabled);\na.classList.toggle("focus-visible:underline",!disabled);\na.classList.toggle("text-muted/50",disabled);\na.classList.toggle("cursor-not-allowed",disabled);\na.classList.toggle("pointer-events-none",disabled);\nif(disabled){\na.setAttribute("aria-disabled","true");\na.setAttribute("tabindex","-1");\na.setAttribute("title",unavailableLabel);\na.classList.remove("font-bold","text-accent","text-fg");\na.removeAttribute("aria-current");\n}else{\na.removeAttribute("aria-disabled");\na.removeAttribute("tabindex");\na.removeAttribute("title");\n}\n}\nfunction rewire(){\nvar articleEl=document.querySelector("["+ATTR+"]");\nvar hasAvailabilityData=articleEl!==null;\nvar unavailableSlugs=hasAvailabilityData?(articleEl.getAttribute(ATTR)||"").split(",").filter(Boolean):[];\nvar containers=document.querySelectorAll("[data-version-rewire]");\nfor(var i=0;i<containers.length;i++){\nvar c=containers[i];\nvar config={base:c.getAttribute("data-base")||"",defaultLocale:c.getAttribute("data-default-locale")||"",trailingSlash:c.getAttribute("data-trailing-slash")==="true",currentLocale:c.getAttribute("data-current-locale")||""};\nvar unavailableLabel=c.getAttribute("data-unavailable-label")||"";\nvar versionAnchors=c.querySelectorAll("[data-version-slug]");\nvar slugs=[];\nfor(var j=0;j<versionAnchors.length;j++){\nvar s=versionAnchors[j].getAttribute("data-version-slug");\nif(s)slugs.push(s);\n}\nvar state=computeVersionSwitcherState(readCurrentPath(CURRENT_PATH_DATASET_KEY),config,slugs);\nvar latest=c.querySelector("[data-version-latest]");\nif(latest){\nlatest.setAttribute("href",state.latestHref);\nsetActive(latest,state.activeVersion===null);\n}\nfor(var k=0;k<versionAnchors.length;k++){\nvar a=versionAnchors[k];\nvar slug=a.getAttribute("data-version-slug");\nif(!slug)continue;\nvar href=state.versionHrefs[slug];\nif(href!=null)a.setAttribute("href",href);\nif(hasAvailabilityData){\nvar disabled=unavailableSlugs.indexOf(slug)!==-1;\nsetDisabled(a,disabled,unavailableLabel);\nif(!disabled)setActive(a,state.activeVersion===slug);\n}else{\nvar alreadyDisabled=a.getAttribute("aria-disabled")==="true";\nif(!alreadyDisabled)setActive(a,state.activeVersion===slug);\n}\n}\nvar label=c.querySelector("[data-version-trigger-label]");\nif(label){\nif(state.activeVersion===null){\nif(latest)label.textContent=latest.textContent;\n}else{\nvar activeLabel=null;\nfor(var m=0;m<versionAnchors.length;m++){\nif(versionAnchors[m].getAttribute("data-version-slug")===state.activeVersion){activeLabel=versionAnchors[m].textContent;break;}\n}\nlabel.textContent=activeLabel!=null?activeLabel:state.activeVersion;\n}\n}\n}\n}\n// The initial call is deferred to DOMContentLoaded when the script (inline in\n// <header>, which parses before <article>) would otherwise run before the\n// article element exists. Running early would read a missing ATTR as "no\n// unavailable slugs" and clobber the SSR-correct disabled state with\n// everything-enabled \u2014 a first-paint variant of the bug this rewire exists\n// to fix (see the doc comment above; SSR already rendered the right state for\n// this page, so a brief deferral loses nothing).\nif(document.readyState==="loading"){document.addEventListener("DOMContentLoaded",rewire);}else{rewire();}\ndocument.addEventListener("zfb:after-swap",rewire);\n})();';
+export {
+  LANGUAGE_SWITCHER_INIT_SCRIPT,
+  VERSION_SWITCHER_REWIRE_SCRIPT
+};

package/dist/i18n-version/switcher-url-state.d.ts

@@ -0,0 +1,76 @@
+/**
+ * The minimal project config the client re-wire needs to reproduce
+ * `getPathForLocale`'s output from the live pathname. Emitted as `data-*`
+ * attributes on the switcher container so {@link LANGUAGE_SWITCHER_INIT_SCRIPT}
+ * can read it without any serialized props.
+ */
+export interface LanguageSwitcherConfig {
+    /** Normalized site base with no trailing slash (`""` for a root site). */
+    base: string;
+    /** The project's default locale (rendered without a locale prefix). */
+    defaultLocale: string;
+    /** Whether the project appends trailing slashes to page URLs. */
+    trailingSlash: boolean;
+}
+/**
+ * Client-side re-computation of a locale-switched href from the *current*
+ * pathname. This is a self-contained port of `getPathForLocale` (+ its
+ * `stripBase` / version-prefix split / `withBase` / `applyTrailingSlash`
+ * dependencies) from `url-helpers`. It MUST stay behaviourally identical to
+ * that function — pinned by the drift-guard test in
+ * `__tests__/language-switcher.test.tsx`, which asserts equality against the
+ * real `buildLocaleLinks` output across a case table.
+ *
+ * It is deliberately self-contained (no references to module-scope helpers)
+ * because {@link LANGUAGE_SWITCHER_INIT_SCRIPT} embeds it verbatim via
+ * package-build serialization, so it must be valid as a standalone function
+ * in the browser. Downstream builds consume a frozen script string.
+ */
+export declare function switchLocaleHref(pathname: string, config: LanguageSwitcherConfig, currentLang: string, targetLang: string): string;
+/**
+ * The minimal project config the client re-wire needs to reproduce the header
+ * factory's per-page menu URLs from the live pathname. Emitted as `data-*`
+ * attributes on the switcher container so {@link VERSION_SWITCHER_REWIRE_SCRIPT}
+ * can read it without any serialized props.
+ */
+export interface VersionSwitcherRewireConfig {
+    /** Normalized site base with no trailing slash (`""` for a root site). */
+    base: string;
+    /** The project's default locale (rendered without a locale prefix). */
+    defaultLocale: string;
+    /** Whether the project appends trailing slashes to page URLs. */
+    trailingSlash: boolean;
+    /**
+     * The active locale code — constant within a `header-${lang}` persist window,
+     * so it can be read once from the SSR container rather than re-derived.
+     */
+    currentLocale: string;
+}
+/** The re-computed per-page menu state {@link computeVersionSwitcherState} returns. */
+export interface VersionSwitcherState {
+    /** Href for the "Latest" entry, matching the SSR `latestUrl`. */
+    latestHref: string;
+    /** version slug → href for that version of the current page (SSR `versionUrls`). */
+    versionHrefs: Record<string, string>;
+    /** Active version slug, or `null` when the current page is on "latest". */
+    activeVersion: string | null;
+}
+/**
+ * Client-side re-computation of the version-switcher's per-page menu state from
+ * the *current* pathname. This is a self-contained port of the header factory's
+ * URL logic (`createHeaderWithDefaults`'s `latestUrl` / `versionUrls` block, in
+ * turn `docsUrl` / `versionedDocsUrl` / `withBase` from `url-helpers`). It MUST
+ * stay behaviourally identical to that SSR path — pinned by the drift-guard test
+ * in `__tests__/version-switcher.test.tsx`, which asserts equality against the
+ * real `makeUrlHelpers` output across a case table.
+ *
+ * It is deliberately self-contained (no references to module-scope helpers)
+ * because {@link VERSION_SWITCHER_REWIRE_SCRIPT} embeds it verbatim via
+ * package-build serialization, so it must be valid as a standalone function
+ * in the browser. Downstream builds consume a frozen script string.
+ *
+ * The `/docs/versions` listing is a standalone package route (`currentSlug`
+ * `undefined` on the SSR side), so — like the SSR factory — every menu href
+ * there collapses to `versionsPageUrl`; the exact-path check below mirrors that.
+ */
+export declare function computeVersionSwitcherState(pathname: string, config: VersionSwitcherRewireConfig, versionSlugs: string[]): VersionSwitcherState;

package/dist/i18n-version/switcher-url-state.js

@@ -0,0 +1,103 @@
+function switchLocaleHref(pathname, config, currentLang, targetLang) {
+  const normalizedBase = config.base;
+  const defaultLocale = config.defaultLocale;
+  const trailingSlash = config.trailingSlash;
+  const stripBase = (path) => {
+    if (normalizedBase === "") return path;
+    if (path === normalizedBase) return "/";
+    return path.indexOf(normalizedBase + "/") === 0 ? path.slice(normalizedBase.length) : path;
+  };
+  const applyTrailingSlash = (url) => {
+    if (!trailingSlash) return url;
+    if (url.charAt(url.length - 1) === "/") return url;
+    const suffixIdx = url.search(/[?#]/);
+    const pathPart = suffixIdx >= 0 ? url.slice(0, suffixIdx) : url;
+    const suffix = suffixIdx >= 0 ? url.slice(suffixIdx) : "";
+    if (pathPart.charAt(pathPart.length - 1) === "/") return url;
+    const segments = pathPart.split("/");
+    const lastSegment = segments[segments.length - 1] || "";
+    if (/\.[a-zA-Z]\w*$/.test(lastSegment)) return url;
+    return pathPart + "/" + suffix;
+  };
+  const withBase = (path) => {
+    const raw = normalizedBase === "" ? path : normalizedBase + (path.charAt(0) === "/" ? path : "/" + path);
+    return applyTrailingSlash(raw);
+  };
+  const stripped = stripBase(pathname);
+  const versionMatch = stripped.match(/^(\/v\/[^/]+)(\/.*|$)/);
+  const versionPrefix = versionMatch ? versionMatch[1] || "" : "";
+  let relativePath = versionMatch ? versionMatch[2] || "/" : stripped;
+  if (currentLang !== defaultLocale) {
+    relativePath = relativePath.replace(
+      new RegExp("^/" + currentLang + "(?:/|$)"),
+      "/"
+    );
+  }
+  if (targetLang !== defaultLocale) {
+    relativePath = "/" + targetLang + relativePath;
+  }
+  return withBase(versionPrefix + relativePath);
+}
+function computeVersionSwitcherState(pathname, config, versionSlugs) {
+  const normalizedBase = config.base;
+  const defaultLocale = config.defaultLocale;
+  const currentLocale = config.currentLocale;
+  const trailingSlash = config.trailingSlash;
+  const stripBase = (path) => {
+    if (normalizedBase === "") return path;
+    if (path === normalizedBase) return "/";
+    return path.indexOf(normalizedBase + "/") === 0 ? path.slice(normalizedBase.length) : path;
+  };
+  const applyTrailingSlash = (url) => {
+    if (!trailingSlash) return url;
+    if (url.charAt(url.length - 1) === "/") return url;
+    const suffixIdx = url.search(/[?#]/);
+    const pathPart = suffixIdx >= 0 ? url.slice(0, suffixIdx) : url;
+    const suffix = suffixIdx >= 0 ? url.slice(suffixIdx) : "";
+    if (pathPart.charAt(pathPart.length - 1) === "/") return url;
+    const segments = pathPart.split("/");
+    const lastSegment = segments[segments.length - 1] || "";
+    if (/\.[a-zA-Z]\w*$/.test(lastSegment)) return url;
+    return pathPart + "/" + suffix;
+  };
+  const withBase = (path) => {
+    const raw = normalizedBase === "" ? path : normalizedBase + (path.charAt(0) === "/" ? path : "/" + path);
+    return applyTrailingSlash(raw);
+  };
+  const versionsPageUrl = withBase(
+    currentLocale === defaultLocale ? "/docs/versions" : "/" + currentLocale + "/docs/versions"
+  );
+  const stripped = stripBase(pathname);
+  const versionMatch = stripped.match(/^\/v\/([^/]+)(\/.*|$)/);
+  const rest = versionMatch ? versionMatch[2] || "/" : stripped;
+  let localeStripped = rest;
+  if (currentLocale !== defaultLocale) {
+    localeStripped = rest.replace(
+      new RegExp("^/" + currentLocale + "(?:/|$)"),
+      "/"
+    );
+  }
+  const isVersionsIndex = localeStripped === "/docs/versions" || localeStripped === "/docs/versions/";
+  const isDocPage = /^\/docs(\/|$)/.test(localeStripped) && !isVersionsIndex;
+  const activeVersion = isDocPage && versionMatch ? versionMatch[1] || null : null;
+  const versionHrefs = {};
+  let latestHref;
+  if (isDocPage) {
+    latestHref = withBase(rest);
+    for (let i = 0; i < versionSlugs.length; i++) {
+      const slug = versionSlugs[i];
+      if (slug) versionHrefs[slug] = withBase("/v/" + slug + rest);
+    }
+  } else {
+    latestHref = versionsPageUrl;
+    for (let i = 0; i < versionSlugs.length; i++) {
+      const slug = versionSlugs[i];
+      if (slug) versionHrefs[slug] = versionsPageUrl;
+    }
+  }
+  return { latestHref, versionHrefs, activeVersion };
+}
+export {
+  computeVersionSwitcherState,
+  switchLocaleHref
+};

package/dist/i18n-version/version-banner.d.ts

@@ -1,6 +1,5 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-import type { VNode } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
 export interface VersionBannerLabels {
     /** Banner body text (e.g. "You are viewing documentation for an older version."). */
     message: string;
@@ -23,4 +22,4 @@ export interface VersionBannerProps {
  * The host typically resolves `labels` via `t("version.banner.*", lang)`
  * and `latestUrl` via the project's URL helpers.
  */
-export declare function VersionBanner(props: VersionBannerProps): VNode;
+export declare function VersionBanner(props: VersionBannerProps): Child;

package/dist/i18n-version/version-banner.js

@@ -1,4 +1,4 @@
-import { jsx, jsxs } from "preact/jsx-runtime";
+import { jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
 function VersionBanner(props) {
   const { type, latestUrl, labels } = props;
   return /* @__PURE__ */ jsxs(