@takazudo/zudo-doc 5.28.2 → 6.0.0

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

@@ -1,6 +1,5 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-import type { VNode } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
 import type { VersionEntry, VersionSwitcherLabels } from "./types.js";
 export interface VersionSwitcherProps {
     /**
@@ -52,52 +51,8 @@ export interface VersionSwitcherProps {
      */
     rewireConfig?: VersionSwitcherRewireConfig;
 }
-/**
- * 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
- * `.toString()`, so it must be valid as a standalone function in the browser.
- *
- * 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;
+import type { VersionSwitcherRewireConfig } from "./switcher-url-state.js";
+export { computeVersionSwitcherState, type VersionSwitcherRewireConfig, type VersionSwitcherState } from "./switcher-url-state.js";
 /**
  * Canonical CSS rule that backs the responsive visibility of the
  * version-switcher's host wrapper. **The component itself does NOT
@@ -139,7 +94,7 @@ export declare const VERSION_SWITCHER_VISIBILITY_STYLE = "@media (min-width:64re
  * `VERSION_SWITCHER_INIT_SCRIPT` — mount it once at body-end on any
  * page that includes a `<VersionSwitcher>`.
  */
-export declare function VersionSwitcher(props: VersionSwitcherProps): VNode;
+export declare function VersionSwitcher(props: VersionSwitcherProps): Child;
 /**
  * Self-contained init script for the version-switcher's interactive
  * behavior. Mount once per page (e.g. inside the layout's body-end
@@ -215,5 +170,5 @@ export declare const VERSION_SWITCHER_INIT_SCRIPT: string;
  * `nav-overflow-script.ts` / `sidebar-tree-island` / `language-switcher.tsx`
  * use (zudolab/zudo-doc#3398, consolidated by #3408).
  */
-export declare const VERSION_SWITCHER_REWIRE_SCRIPT: string;
+export { VERSION_SWITCHER_REWIRE_SCRIPT } from "./switcher-generated-scripts.js";
 export type { VersionEntry, VersionSwitcherLabels };

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

@@ -1,66 +1,6 @@
-import { jsx, jsxs } from "preact/jsx-runtime";
+import { jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import { AFTER_NAVIGATE_EVENT } from "../transitions/page-events.js";
-import { CURRENT_PATH_SCRIPT_PRELUDE } from "../current-path/index.js";
-import { UNAVAILABLE_VERSIONS_ATTR } from "../version-availability/index.js";
-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 };
-}
+import { computeVersionSwitcherState } from "./switcher-url-state.js";
 function cls(...parts) {
   return parts.filter(Boolean).join(" ");
 }
@@ -69,7 +9,6 @@ function ChevronDownIcon() {
   return /* @__PURE__ */ jsx(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: "h-[0.875rem] w-[0.875rem]",
       fill: "none",
       viewBox: "0 0 24 24",
@@ -110,12 +49,12 @@ function VersionSwitcher(props) {
     "data-current-locale": rewireConfig.currentLocale,
     "data-unavailable-label": labels.unavailable
   } : {};
-  return /* @__PURE__ */ jsxs("div", { class: "version-switcher relative", "data-version-switcher": true, ...rewireAttrs, children: [
+  return /* @__PURE__ */ jsxs("div", { class: "relative", "data-version-switcher": true, ...rewireAttrs, children: [
     /* @__PURE__ */ jsxs(
       "button",
       {
         type: "button",
-        class: "flex items-center gap-hsp-2xs border border-muted rounded px-hsp-sm py-vsp-3xs text-small text-muted hover:border-accent hover:text-accent transition-colors cursor-pointer whitespace-nowrap",
+        class: "flex items-center gap-hsp-2xs border border-muted rounded px-hsp-sm py-vsp-3xs text-small text-muted hover:border-accent hover:text-accent transition-colors duration-0 cursor-pointer whitespace-nowrap",
         "aria-expanded": "false",
         "aria-controls": menuId,
         "data-version-toggle": true,
@@ -231,98 +170,7 @@ toggle.focus();
 initVersionSwitcher();
 document.addEventListener(${JSON.stringify(AFTER_NAVIGATE_EVENT)},initVersionSwitcher);
 })();`;
-const VERSION_SWITCHER_REWIRE_SCRIPT = `(function(){
-var FLAG="__zdVersionSwitcherRewire";
-if(window[FLAG])return;
-window[FLAG]=true;
-var ATTR=${JSON.stringify(UNAVAILABLE_VERSIONS_ATTR)};
-${CURRENT_PATH_SCRIPT_PRELUDE}
-var computeVersionSwitcherState=${computeVersionSwitcherState.toString()};
-function setActive(a,active){
-a.classList.toggle("font-bold",active);
-a.classList.toggle("text-accent",active);
-a.classList.toggle("text-fg",!active);
-if(active){a.setAttribute("aria-current","page");}else{a.removeAttribute("aria-current");}
-}
-function setDisabled(a,disabled,unavailableLabel){
-a.classList.toggle("hover:bg-accent/10",!disabled);
-a.classList.toggle("hover:underline",!disabled);
-a.classList.toggle("focus-visible:underline",!disabled);
-a.classList.toggle("text-muted/50",disabled);
-a.classList.toggle("cursor-not-allowed",disabled);
-a.classList.toggle("pointer-events-none",disabled);
-if(disabled){
-a.setAttribute("aria-disabled","true");
-a.setAttribute("tabindex","-1");
-a.setAttribute("title",unavailableLabel);
-a.classList.remove("font-bold","text-accent","text-fg");
-a.removeAttribute("aria-current");
-}else{
-a.removeAttribute("aria-disabled");
-a.removeAttribute("tabindex");
-a.removeAttribute("title");
-}
-}
-function rewire(){
-var articleEl=document.querySelector("["+ATTR+"]");
-var hasAvailabilityData=articleEl!==null;
-var unavailableSlugs=hasAvailabilityData?(articleEl.getAttribute(ATTR)||"").split(",").filter(Boolean):[];
-var containers=document.querySelectorAll("[data-version-rewire]");
-for(var i=0;i<containers.length;i++){
-var c=containers[i];
-var 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")||""};
-var unavailableLabel=c.getAttribute("data-unavailable-label")||"";
-var versionAnchors=c.querySelectorAll("[data-version-slug]");
-var slugs=[];
-for(var j=0;j<versionAnchors.length;j++){
-var s=versionAnchors[j].getAttribute("data-version-slug");
-if(s)slugs.push(s);
-}
-var state=computeVersionSwitcherState(readCurrentPath(CURRENT_PATH_DATASET_KEY),config,slugs);
-var latest=c.querySelector("[data-version-latest]");
-if(latest){
-latest.setAttribute("href",state.latestHref);
-setActive(latest,state.activeVersion===null);
-}
-for(var k=0;k<versionAnchors.length;k++){
-var a=versionAnchors[k];
-var slug=a.getAttribute("data-version-slug");
-if(!slug)continue;
-var href=state.versionHrefs[slug];
-if(href!=null)a.setAttribute("href",href);
-if(hasAvailabilityData){
-var disabled=unavailableSlugs.indexOf(slug)!==-1;
-setDisabled(a,disabled,unavailableLabel);
-if(!disabled)setActive(a,state.activeVersion===slug);
-}else{
-var alreadyDisabled=a.getAttribute("aria-disabled")==="true";
-if(!alreadyDisabled)setActive(a,state.activeVersion===slug);
-}
-}
-var label=c.querySelector("[data-version-trigger-label]");
-if(label){
-if(state.activeVersion===null){
-if(latest)label.textContent=latest.textContent;
-}else{
-var activeLabel=null;
-for(var m=0;m<versionAnchors.length;m++){
-if(versionAnchors[m].getAttribute("data-version-slug")===state.activeVersion){activeLabel=versionAnchors[m].textContent;break;}
-}
-label.textContent=activeLabel!=null?activeLabel:state.activeVersion;
-}
-}
-}
-}
-// The initial call is deferred to DOMContentLoaded when the script (inline in
-// <header>, which parses before <article>) would otherwise run before the
-// article element exists. Running early would read a missing ATTR as "no
-// unavailable slugs" and clobber the SSR-correct disabled state with
-// everything-enabled \u2014 a first-paint variant of the bug this rewire exists
-// to fix (see the doc comment above; SSR already rendered the right state for
-// this page, so a brief deferral loses nothing).
-if(document.readyState==="loading"){document.addEventListener("DOMContentLoaded",rewire);}else{rewire();}
-document.addEventListener(${JSON.stringify(AFTER_NAVIGATE_EVENT)},rewire);
-})();`;
+import { VERSION_SWITCHER_REWIRE_SCRIPT } from "./switcher-generated-scripts.js";
 export {
   VERSION_SWITCHER_INIT_SCRIPT,
   VERSION_SWITCHER_REWIRE_SCRIPT,

package/dist/icons/index.d.ts

@@ -1,23 +1,22 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-import type { VNode } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
 export interface IconProps {
     /** CSS class string forwarded to the root `<svg>` element. */
-    className?: string;
+    class?: string;
 }
-export declare function ChevronRight({ className }: IconProps): VNode;
-export declare function ChevronLeft({ className }: IconProps): VNode;
-export declare function Search({ className }: IconProps): VNode;
-export declare function History({ className }: IconProps): VNode;
-export declare function Close({ className }: IconProps): VNode;
-export declare function ArrowLeft({ className }: IconProps): VNode;
-export declare function GitHub({ className }: IconProps): VNode;
-export declare function Folder({ className }: IconProps): VNode;
-export declare function FolderOpen({ className }: IconProps): VNode;
-export declare function FileGeneric({ className }: IconProps): VNode;
-export declare function FileCode({ className }: IconProps): VNode;
-export declare function FileText({ className }: IconProps): VNode;
-export declare function FileImage({ className }: IconProps): VNode;
-export declare function FileVideo({ className }: IconProps): VNode;
-export declare function FilePdf({ className }: IconProps): VNode;
-export declare function FileArchive({ className }: IconProps): VNode;
+export declare function ChevronRight({ class: className }: IconProps): Child;
+export declare function ChevronLeft({ class: className }: IconProps): Child;
+export declare function Search({ class: className }: IconProps): Child;
+export declare function History({ class: className }: IconProps): Child;
+export declare function Close({ class: className }: IconProps): Child;
+export declare function ArrowLeft({ class: className }: IconProps): Child;
+export declare function GitHub({ class: className }: IconProps): Child;
+export declare function Folder({ class: className }: IconProps): Child;
+export declare function FolderOpen({ class: className }: IconProps): Child;
+export declare function FileGeneric({ class: className }: IconProps): Child;
+export declare function FileCode({ class: className }: IconProps): Child;
+export declare function FileText({ class: className }: IconProps): Child;
+export declare function FileImage({ class: className }: IconProps): Child;
+export declare function FileVideo({ class: className }: IconProps): Child;
+export declare function FilePdf({ class: className }: IconProps): Child;
+export declare function FileArchive({ class: className }: IconProps): Child;

package/dist/icons/index.js

@@ -1,9 +1,8 @@
-import { jsx, jsxs } from "preact/jsx-runtime";
-function ChevronRight({ className }) {
+import { jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
+function ChevronRight({ class: className }) {
   return /* @__PURE__ */ jsx(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",
@@ -14,11 +13,10 @@ function ChevronRight({ className }) {
     }
   );
 }
-function ChevronLeft({ className }) {
+function ChevronLeft({ class: className }) {
   return /* @__PURE__ */ jsx(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",
@@ -29,11 +27,10 @@ function ChevronLeft({ className }) {
     }
   );
 }
-function Search({ className }) {
+function Search({ class: className }) {
   return /* @__PURE__ */ jsx(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",
@@ -44,11 +41,10 @@ function Search({ className }) {
     }
   );
 }
-function History({ className }) {
+function History({ class: className }) {
   return /* @__PURE__ */ jsxs(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       viewBox: "0 0 24 24",
       fill: "none",
@@ -64,11 +60,10 @@ function History({ className }) {
     }
   );
 }
-function Close({ className }) {
+function Close({ class: className }) {
   return /* @__PURE__ */ jsx(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       viewBox: "0 0 24 24",
       fill: "none",
@@ -81,11 +76,10 @@ function Close({ className }) {
     }
   );
 }
-function ArrowLeft({ className }) {
+function ArrowLeft({ class: className }) {
   return /* @__PURE__ */ jsx(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       viewBox: "0 0 24 24",
       fill: "none",
@@ -98,11 +92,10 @@ function ArrowLeft({ className }) {
     }
   );
 }
-function GitHub({ className }) {
+function GitHub({ class: className }) {
   return /* @__PURE__ */ jsx(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       width: "20",
       height: "20",
       viewBox: "0 0 24 24",
@@ -113,11 +106,10 @@ function GitHub({ className }) {
     }
   );
 }
-function Folder({ className }) {
+function Folder({ class: className }) {
   return /* @__PURE__ */ jsx(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",
@@ -135,11 +127,10 @@ function Folder({ className }) {
     }
   );
 }
-function FolderOpen({ className }) {
+function FolderOpen({ class: className }) {
   return /* @__PURE__ */ jsxs(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",
@@ -167,11 +158,10 @@ function FolderOpen({ className }) {
     }
   );
 }
-function FileGeneric({ className }) {
+function FileGeneric({ class: className }) {
   return /* @__PURE__ */ jsxs(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",
@@ -192,11 +182,10 @@ function FileGeneric({ className }) {
     }
   );
 }
-function FileCode({ className }) {
+function FileCode({ class: className }) {
   return /* @__PURE__ */ jsxs(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",
@@ -219,11 +208,10 @@ function FileCode({ className }) {
     }
   );
 }
-function FileText({ className }) {
+function FileText({ class: className }) {
   return /* @__PURE__ */ jsxs(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",
@@ -246,11 +234,10 @@ function FileText({ className }) {
     }
   );
 }
-function FileImage({ className }) {
+function FileImage({ class: className }) {
   return /* @__PURE__ */ jsxs(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",
@@ -265,11 +252,10 @@ function FileImage({ className }) {
     }
   );
 }
-function FileVideo({ className }) {
+function FileVideo({ class: className }) {
   return /* @__PURE__ */ jsxs(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",
@@ -283,11 +269,10 @@ function FileVideo({ className }) {
     }
   );
 }
-function FilePdf({ className }) {
+function FilePdf({ class: className }) {
   return /* @__PURE__ */ jsxs(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",
@@ -324,11 +309,10 @@ function FilePdf({ className }) {
     }
   );
 }
-function FileArchive({ className }) {
+function FileArchive({ class: className }) {
   return /* @__PURE__ */ jsxs(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",

package/dist/image-enlarge/index.d.ts

@@ -1,13 +1,4 @@
-export declare function ImageEnlarge(): import("preact").JSX.Element;
+export declare function ImageEnlarge(): import("@takazudo/zfb").Description;
 export declare namespace ImageEnlarge {
     var displayName: string;
 }
-/**
- * Static SSR fallback for the {@link ImageEnlarge} island.
- *
- * Renders an empty, closed `<dialog class="zd-enlarge-dialog ...">` so the
- * dist HTML carries the dialog shell even before hydration. Sources its
- * class and inline style from the shared constants in island-types so the
- * SSR fallback cannot drift from the hydrated dialog above.
- */
-export declare function ImageEnlargeSsrFallback(): import("preact").JSX.Element;