@takazudo/zudo-doc 5.28.2 → 6.0.1

package/dist/design-token-panel-bootstrap.js

@@ -1,290 +1,5 @@
-"use client";
-import {
-  DEFAULT_STORAGE_PREFIX,
-  DEFAULT_TOGGLE_EVENT,
-  EAGER_LOAD_GATE_KEY_SUFFIXES,
-  EAGER_LOAD_GATE_STATE_FAMILY,
-  resolveToggleEventName
-} from "./design-token-panel-constants.js";
-import {
-  BEFORE_NAVIGATE_EVENT,
-  AFTER_NAVIGATE_EVENT
-} from "./transitions/page-events.js";
-import {
-  DEFAULT_THEME_PACK_SLUG,
-  THEME_PACK_CHANGED_EVENT,
-  readThemePackFromDom
-} from "./theme-pack-switcher/theme-pack-sync.js";
-import { buildDesignTokenPanelConfig } from "./design-token-panel-config/index.js";
-const COLOR_SCHEME_CHANGED_EVENT = "color-scheme-changed";
-function openStateKey(instancePrefix) {
-  return `${instancePrefix}-open`;
-}
-function readOpenState(instancePrefix) {
-  try {
-    return localStorage.getItem(openStateKey(instancePrefix)) === "1";
-  } catch {
-    return false;
-  }
-}
-function isEmptyEnvelope(raw) {
-  if (raw === null || raw === "") return true;
-  let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch {
-    return false;
-  }
-  if (parsed === null) return true;
-  if (Array.isArray(parsed)) return parsed.length === 0;
-  if (typeof parsed === "object") return Object.keys(parsed).length === 0;
-  return false;
-}
-function hasPersistedPanelState(config) {
-  const instancePrefix = config.storagePrefix ?? DEFAULT_STORAGE_PREFIX;
-  try {
-    for (const [suffix, gate] of Object.entries(EAGER_LOAD_GATE_KEY_SUFFIXES)) {
-      if (gate.requiredConfig !== null && config[gate.requiredConfig] === void 0) {
-        continue;
-      }
-      const value = localStorage.getItem(`${instancePrefix}${suffix}`);
-      if (suffix === ":autoload" && value !== "1") continue;
-      if (gate.acceptedValues.some((accepted) => accepted === value)) return true;
-    }
-    for (let i = 0; i < localStorage.length; i++) {
-      const key = localStorage.key(i);
-      if (key === null || !EAGER_LOAD_GATE_STATE_FAMILY.matchesKey(instancePrefix, key)) {
-        continue;
-      }
-      if (!isEmptyEnvelope(localStorage.getItem(key))) return true;
-    }
-  } catch {
-  }
-  return false;
-}
-function readMode() {
-  return document.documentElement.getAttribute("data-theme") === "dark" ? "dark" : "light";
-}
-function withPackScopedStoragePrefix(config, activePack) {
-  if (activePack === DEFAULT_THEME_PACK_SLUG) return config;
-  return { ...config, storagePrefix: `${config.storagePrefix}--${activePack}` };
-}
-function collectDeclaredTokenNames(config) {
-  const names = [];
-  for (const tab of config.tabs ?? []) {
-    for (const tier of tab.tiers ?? []) {
-      for (const item of tier.items ?? []) {
-        names.push(item.cssVar);
-      }
-    }
-    const baseRoles = tab.colorExtras?.baseRoles;
-    if (baseRoles) {
-      for (const cssVar of Object.values(baseRoles)) {
-        if (typeof cssVar === "string" && cssVar.length > 0) {
-          names.push(cssVar);
-        }
-      }
-    }
-  }
-  return names;
-}
-function clearAppliedTokenOverrides(config) {
-  const names = collectDeclaredTokenNames(config);
-  if (config.applySink) {
-    try {
-      config.applySink.clear(names);
-    } catch (err) {
-      console.warn(
-        "[zudo-doc] applySink.clear threw during theme-pack switch; outgoing overrides may linger.",
-        err
-      );
-    }
-    return;
-  }
-  const style = document.documentElement.style;
-  for (const name of names) {
-    style.removeProperty(name);
-  }
-}
-function bootstrapDesignTokenPanel(buildConfig) {
-  if (typeof window === "undefined" || typeof document === "undefined") {
-    return;
-  }
-  let zdtpImport = null;
-  let activationInFlight = false;
-  let configurePhase = "pending";
-  let pendingToggles = 0;
-  function loadZdtp() {
-    if (zdtpImport === null) {
-      zdtpImport = import("@takazudo/zudo-doc/zdtp-loader").catch((err) => {
-        zdtpImport = null;
-        throw err;
-      });
-    }
-    return zdtpImport;
-  }
-  function configureAndWire(zdtp) {
-    const {
-      configurePanel,
-      reapplyPersistedOverrides,
-      setLifecycleAdapter,
-      showDesignTokenPanel
-    } = zdtp;
-    let currentConfig = withPackScopedStoragePrefix(
-      buildConfig(readMode()),
-      readThemePackFromDom()
-    );
-    let handle = configurePanel(currentConfig);
-    let pendingMode = readMode();
-    let timer = null;
-    window.addEventListener(COLOR_SCHEME_CHANGED_EVENT, () => {
-      pendingMode = readMode();
-      if (timer !== null) return;
-      timer = setTimeout(() => {
-        timer = null;
-        const mode = pendingMode;
-        const wasOpen = readOpenState(handle.instanceId);
-        handle.destroy();
-        currentConfig = withPackScopedStoragePrefix(
-          buildConfig(mode),
-          readThemePackFromDom()
-        );
-        handle = configurePanel(currentConfig);
-        if (wasOpen) showDesignTokenPanel();
-      }, 0);
-    });
-    let pendingPack = readThemePackFromDom();
-    let packTimer = null;
-    window.addEventListener(THEME_PACK_CHANGED_EVENT, () => {
-      pendingPack = readThemePackFromDom();
-      if (packTimer !== null) return;
-      packTimer = setTimeout(() => {
-        packTimer = null;
-        const pack = pendingPack;
-        const wasOpen = readOpenState(handle.instanceId);
-        const outgoingConfig = currentConfig;
-        handle.destroy();
-        clearAppliedTokenOverrides(outgoingConfig);
-        currentConfig = withPackScopedStoragePrefix(buildConfig(readMode()), pack);
-        handle = configurePanel(currentConfig);
-        reapplyPersistedOverrides();
-        if (wasOpen) showDesignTokenPanel();
-      }, 0);
-    });
-    reapplyPersistedOverrides();
-    const adapter = {
-      onBeforeSwap(cb) {
-        const handler = () => cb();
-        document.addEventListener(BEFORE_NAVIGATE_EVENT, handler);
-        return () => document.removeEventListener(BEFORE_NAVIGATE_EVENT, handler);
-      },
-      onPageLoad(cb) {
-        const handler = () => cb();
-        document.addEventListener(AFTER_NAVIGATE_EVENT, handler);
-        return () => document.removeEventListener(AFTER_NAVIGATE_EVENT, handler);
-      }
-    };
-    setLifecycleAdapter(adapter);
-  }
-  async function activate() {
-    if (activationInFlight || configurePhase !== "pending") return;
-    activationInFlight = true;
-    let zdtp;
-    try {
-      zdtp = await loadZdtp();
-    } catch (err) {
-      activationInFlight = false;
-      pendingToggles = 0;
-      console.error(
-        "[zudo-doc] design-token-panel: loading @takazudo/zdtp failed; the next toggle retries.",
-        err
-      );
-      return;
-    }
-    try {
-      configureAndWire(zdtp);
-      configurePhase = "configured";
-    } catch (err) {
-      configurePhase = "failed";
-      console.error(
-        "[zudo-doc] design-token-panel: configure failed; the panel is disabled until the next full page load.",
-        err
-      );
-      return;
-    } finally {
-      activationInFlight = false;
-    }
-    if (pendingToggles % 2 === 1) zdtp.showDesignTokenPanel();
-    pendingToggles = 0;
-  }
-  function readActiveConfig() {
-    return withPackScopedStoragePrefix(
-      buildConfig(readMode()),
-      readThemePackFromDom()
-    );
-  }
-  const onInterimToggle = () => {
-    if (configurePhase !== "pending") return;
-    pendingToggles += 1;
-    void activate();
-  };
-  const boundToggleChannels = /* @__PURE__ */ new Set();
-  let instanceToggleChannel = null;
-  function bindToggleChannel(name) {
-    if (boundToggleChannels.has(name)) return;
-    boundToggleChannels.add(name);
-    window.addEventListener(name, onInterimToggle);
-  }
-  function refreshInstanceToggleChannel(config) {
-    const resolved = resolveToggleEventName(config);
-    if (resolved === instanceToggleChannel) return;
-    if (instanceToggleChannel !== null && instanceToggleChannel !== DEFAULT_TOGGLE_EVENT) {
-      window.removeEventListener(instanceToggleChannel, onInterimToggle);
-      boundToggleChannels.delete(instanceToggleChannel);
-    }
-    instanceToggleChannel = resolved;
-    bindToggleChannel(resolved);
-  }
-  const bootConfig = readActiveConfig();
-  bindToggleChannel(DEFAULT_TOGGLE_EVENT);
-  refreshInstanceToggleChannel(bootConfig);
-  window.__zdtpReadyClicks?.();
-  if (hasPersistedPanelState(bootConfig)) void activate();
-  window.addEventListener(THEME_PACK_CHANGED_EVENT, () => {
-    if (configurePhase !== "pending") return;
-    const activeConfig = readActiveConfig();
-    refreshInstanceToggleChannel(activeConfig);
-    if (hasPersistedPanelState(activeConfig)) void activate();
-  });
-  window.addEventListener(COLOR_SCHEME_CHANGED_EVENT, () => {
-    if (configurePhase !== "pending") return;
-    refreshInstanceToggleChannel(readActiveConfig());
-  });
-}
-let bootstrapWinner = null;
-let warnedLostRace = false;
-function warnLostBootstrapRace(winnerOrigin, loserOrigin) {
-  if (typeof window === "undefined" || warnedLostRace) return;
-  warnedLostRace = true;
-  const detail = loserOrigin === "configured" && winnerOrigin === "default" ? "The package-default island configured the panel earlier in this browser session, so `designTokenPanelConfigModule` did not apply on this page. This happens when the session first hard-loaded a page rendered by a self-contained `pages/` stub, which reaches the package default instead of the package-injected route. Thread your builder through `chromeBindings.DesignTokenPanelBootstrap` to make it apply on every page regardless of entry point." : `The ${winnerOrigin} island configured the panel first; this ${loserOrigin} island's builder was ignored. zdtp is configured once per session \u2014 mount exactly one design-token-panel bootstrap, e.g. via \`chromeBindings.DesignTokenPanelBootstrap\`.`;
-  console.warn(`[zudo-doc] design-token panel already configured. ${detail}`);
-}
-function runDesignTokenPanelBootstrapOnce(build, origin = "default") {
-  if (bootstrapWinner) {
-    if (bootstrapWinner.build !== build) warnLostBootstrapRace(bootstrapWinner.origin, origin);
-    return;
-  }
-  bootstrapWinner = { origin, build };
-  bootstrapDesignTokenPanel(build);
-}
-function DesignTokenPanelBootstrap() {
-  runDesignTokenPanelBootstrapOnce(buildDesignTokenPanelConfig, "default");
-  return null;
-}
-DesignTokenPanelBootstrap.displayName = "DesignTokenPanelBootstrap";
+export * from "./design-token-panel-bootstrap-controller.js";
+import { DesignTokenPanelBootstrap } from "./design-token-panel-bootstrap-island.js";
 export {
-  DesignTokenPanelBootstrap,
-  bootstrapDesignTokenPanel,
-  runDesignTokenPanelBootstrapOnce,
-  withPackScopedStoragePrefix
+  DesignTokenPanelBootstrap
 };

package/dist/desktop-sidebar-toggle-island/index.d.ts

@@ -1,7 +1,2 @@
-export declare const SIDEBAR_STORAGE_KEY = "zudo-doc-sidebar-visible";
-export declare function readState(): boolean;
-export declare function setDataAttribute(isVisible: boolean): void;
-export declare function DesktopSidebarToggle(): import("preact").JSX.Element;
-export declare namespace DesktopSidebarToggle {
-    var displayName: string;
-}
+export { DesktopSidebarToggle } from "./island.js";
+export { SIDEBAR_STORAGE_KEY, readState, setDataAttribute } from "./storage.js";

package/dist/desktop-sidebar-toggle-island/index.js

@@ -1,61 +1,5 @@
-"use client";
-import { jsx } from "preact/jsx-runtime";
-import { useState, useEffect, useRef } from "preact/hooks";
-import { ChevronRight, ChevronLeft } from "../icons/index.js";
-import { AFTER_NAVIGATE_EVENT } from "../transitions/index.js";
-const SIDEBAR_STORAGE_KEY = "zudo-doc-sidebar-visible";
-function readState() {
-  if (typeof window === "undefined") return true;
-  try {
-    return localStorage.getItem(SIDEBAR_STORAGE_KEY) !== "false";
-  } catch {
-    return true;
-  }
-}
-function setDataAttribute(isVisible) {
-  if (isVisible) {
-    document.documentElement.removeAttribute("data-sidebar-hidden");
-  } else {
-    document.documentElement.setAttribute("data-sidebar-hidden", "");
-  }
-}
-function DesktopSidebarToggle() {
-  const [visible, setVisible] = useState(true);
-  const hydrated = useRef(false);
-  useEffect(() => {
-    if (!hydrated.current) return;
-    setDataAttribute(visible);
-    try {
-      localStorage.setItem(SIDEBAR_STORAGE_KEY, String(visible));
-    } catch {
-    }
-  }, [visible]);
-  useEffect(() => {
-    hydrated.current = true;
-    const actual = readState();
-    if (actual !== visible) {
-      setVisible(actual);
-    }
-  }, []);
-  useEffect(() => {
-    const handler = () => setDataAttribute(readState());
-    document.addEventListener(AFTER_NAVIGATE_EVENT, handler);
-    return () => document.removeEventListener(AFTER_NAVIGATE_EVENT, handler);
-  }, []);
-  return /* @__PURE__ */ jsx(
-    "button",
-    {
-      type: "button",
-      onClick: () => setVisible((v) => !v),
-      className: "zd-desktop-sidebar-toggle hidden lg:flex fixed bottom-vsp-xl z-sidebar items-center justify-center w-[1.5rem] h-[3rem] bg-surface border border-muted border-l-0 rounded-r-DEFAULT text-muted cursor-pointer transition-[left,color] duration-200 ease-in-out hover:text-fg",
-      "aria-label": visible ? "Hide sidebar" : "Show sidebar",
-      "aria-pressed": visible,
-      "data-zfb-transition-persist": "desktop-sidebar-toggle",
-      children: visible ? /* @__PURE__ */ jsx(ChevronLeft, { className: "h-icon-sm w-icon-sm" }) : /* @__PURE__ */ jsx(ChevronRight, { className: "h-icon-sm w-icon-sm" })
-    }
-  );
-}
-DesktopSidebarToggle.displayName = "DesktopSidebarToggle";
+import { DesktopSidebarToggle } from "./island.js";
+import { SIDEBAR_STORAGE_KEY, readState, setDataAttribute } from "./storage.js";
 export {
   DesktopSidebarToggle,
   SIDEBAR_STORAGE_KEY,

package/dist/desktop-sidebar-toggle-island/island.d.ts

@@ -0,0 +1,4 @@
+export declare function DesktopSidebarToggle(): import("@takazudo/zfb").Description;
+export declare namespace DesktopSidebarToggle {
+    var displayName: string;
+}

package/dist/desktop-sidebar-toggle-island/island.js

@@ -0,0 +1,43 @@
+"use client";
+import { jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
+import { computed, getScope, Show, signal } from "@takazudo/zfb/zudo-react";
+import { ChevronLeft, ChevronRight } from "../icons/index.js";
+import { AFTER_NAVIGATE_EVENT } from "../transitions/index.js";
+import { readState, setDataAttribute, writeState } from "./storage.js";
+function DesktopSidebarToggle() {
+  const visible = signal(true);
+  const scope = getScope();
+  scope.onActivate(() => {
+    const initialVisibility = readState();
+    visible.value = initialVisibility;
+    setDataAttribute(initialVisibility);
+    const restoreDocumentAttribute = () => setDataAttribute(readState());
+    document.addEventListener(AFTER_NAVIGATE_EVENT, restoreDocumentAttribute);
+    return () => document.removeEventListener(AFTER_NAVIGATE_EVENT, restoreDocumentAttribute);
+  });
+  const toggle = () => {
+    const next = !visible.value;
+    visible.value = next;
+    writeState(next);
+    setDataAttribute(next);
+  };
+  return /* @__PURE__ */ jsxs(
+    "button",
+    {
+      type: "button",
+      "on:click": toggle,
+      class: "zd-desktop-sidebar-toggle hidden lg:flex fixed bottom-vsp-xl z-sidebar items-center justify-center w-[1.5rem] h-[3rem] bg-surface border border-muted border-l-0 text-muted cursor-pointer transition-[left,color] duration-200 hover:text-fg",
+      style: "border-radius:0 var(--radius-DEFAULT) var(--radius-DEFAULT) 0",
+      "aria-label": computed(() => visible.value ? "Hide sidebar" : "Show sidebar"),
+      "aria-pressed": visible,
+      children: [
+        /* @__PURE__ */ jsx(Show, { when: computed(() => visible.value), children: () => /* @__PURE__ */ jsx(ChevronLeft, { class: "h-icon-sm w-icon-sm" }) }),
+        /* @__PURE__ */ jsx(Show, { when: computed(() => !visible.value), children: () => /* @__PURE__ */ jsx(ChevronRight, { class: "h-icon-sm w-icon-sm" }) })
+      ]
+    }
+  );
+}
+DesktopSidebarToggle.displayName = "DesktopSidebarToggle";
+export {
+  DesktopSidebarToggle
+};

package/dist/desktop-sidebar-toggle-island/storage.d.ts

@@ -0,0 +1,4 @@
+export declare const SIDEBAR_STORAGE_KEY = "zudo-doc-sidebar-visible";
+export declare function readState(): boolean;
+export declare function writeState(isVisible: boolean): void;
+export declare function setDataAttribute(isVisible: boolean): void;

package/dist/desktop-sidebar-toggle-island/storage.js

@@ -0,0 +1,29 @@
+const SIDEBAR_STORAGE_KEY = "zudo-doc-sidebar-visible";
+function readState() {
+  if (typeof window === "undefined") return true;
+  try {
+    return localStorage.getItem(SIDEBAR_STORAGE_KEY) !== "false";
+  } catch {
+    return true;
+  }
+}
+function writeState(isVisible) {
+  try {
+    localStorage.setItem(SIDEBAR_STORAGE_KEY, String(isVisible));
+  } catch {
+  }
+}
+function setDataAttribute(isVisible) {
+  if (typeof document === "undefined") return;
+  if (isVisible) {
+    document.documentElement.removeAttribute("data-sidebar-hidden");
+  } else {
+    document.documentElement.setAttribute("data-sidebar-hidden", "");
+  }
+}
+export {
+  SIDEBAR_STORAGE_KEY,
+  readState,
+  setDataAttribute,
+  writeState
+};

package/dist/desktop-toc-toggle-island/index.d.ts

@@ -1,7 +1,2 @@
-export declare const TOC_STORAGE_KEY = "zudo-doc-toc-visible";
-export declare function readTocState(): boolean;
-export declare function setTocDataAttribute(isVisible: boolean): void;
-export declare function DesktopTocToggle(): import("preact").JSX.Element;
-export declare namespace DesktopTocToggle {
-    var displayName: string;
-}
+export { DesktopTocToggle } from "./island.js";
+export { TOC_STORAGE_KEY, readTocState, setTocDataAttribute } from "./storage.js";

package/dist/desktop-toc-toggle-island/index.js

@@ -1,61 +1,5 @@
-"use client";
-import { jsx } from "preact/jsx-runtime";
-import { useState, useEffect, useRef } from "preact/hooks";
-import { ChevronRight, ChevronLeft } from "../icons/index.js";
-import { AFTER_NAVIGATE_EVENT } from "../transitions/index.js";
-const TOC_STORAGE_KEY = "zudo-doc-toc-visible";
-function readTocState() {
-  if (typeof window === "undefined") return true;
-  try {
-    return localStorage.getItem(TOC_STORAGE_KEY) !== "false";
-  } catch {
-    return true;
-  }
-}
-function setTocDataAttribute(isVisible) {
-  if (isVisible) {
-    document.documentElement.removeAttribute("data-toc-hidden");
-  } else {
-    document.documentElement.setAttribute("data-toc-hidden", "");
-  }
-}
-function DesktopTocToggle() {
-  const [visible, setVisible] = useState(true);
-  const hydrated = useRef(false);
-  useEffect(() => {
-    if (!hydrated.current) return;
-    setTocDataAttribute(visible);
-    try {
-      localStorage.setItem(TOC_STORAGE_KEY, String(visible));
-    } catch {
-    }
-  }, [visible]);
-  useEffect(() => {
-    hydrated.current = true;
-    const actual = readTocState();
-    if (actual !== visible) {
-      setVisible(actual);
-    }
-  }, []);
-  useEffect(() => {
-    const handler = () => setTocDataAttribute(readTocState());
-    document.addEventListener(AFTER_NAVIGATE_EVENT, handler);
-    return () => document.removeEventListener(AFTER_NAVIGATE_EVENT, handler);
-  }, []);
-  return /* @__PURE__ */ jsx(
-    "button",
-    {
-      type: "button",
-      onClick: () => setVisible((v) => !v),
-      className: "zd-desktop-toc-toggle hidden xl:flex fixed bottom-vsp-xl z-sidebar items-center justify-center w-[1.5rem] h-[3rem] bg-surface border border-muted border-r-0 rounded-l-DEFAULT text-muted cursor-pointer transition-[right,color] duration-200 ease-in-out hover:text-fg",
-      "aria-label": visible ? "Hide table of contents" : "Show table of contents",
-      "aria-pressed": visible,
-      "data-zfb-transition-persist": "desktop-toc-toggle",
-      children: visible ? /* @__PURE__ */ jsx(ChevronRight, { className: "h-icon-sm w-icon-sm" }) : /* @__PURE__ */ jsx(ChevronLeft, { className: "h-icon-sm w-icon-sm" })
-    }
-  );
-}
-DesktopTocToggle.displayName = "DesktopTocToggle";
+import { DesktopTocToggle } from "./island.js";
+import { TOC_STORAGE_KEY, readTocState, setTocDataAttribute } from "./storage.js";
 export {
   DesktopTocToggle,
   TOC_STORAGE_KEY,

package/dist/desktop-toc-toggle-island/island.d.ts

@@ -0,0 +1,4 @@
+export declare function DesktopTocToggle(): import("@takazudo/zfb").Description;
+export declare namespace DesktopTocToggle {
+    var displayName: string;
+}

package/dist/desktop-toc-toggle-island/island.js

@@ -0,0 +1,43 @@
+"use client";
+import { jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
+import { computed, getScope, Show, signal } from "@takazudo/zfb/zudo-react";
+import { ChevronLeft, ChevronRight } from "../icons/index.js";
+import { AFTER_NAVIGATE_EVENT } from "../transitions/index.js";
+import { readTocState, setTocDataAttribute, writeTocState } from "./storage.js";
+function DesktopTocToggle() {
+  const visible = signal(true);
+  const scope = getScope();
+  scope.onActivate(() => {
+    const initialVisibility = readTocState();
+    visible.value = initialVisibility;
+    setTocDataAttribute(initialVisibility);
+    const restoreDocumentAttribute = () => setTocDataAttribute(readTocState());
+    document.addEventListener(AFTER_NAVIGATE_EVENT, restoreDocumentAttribute);
+    return () => document.removeEventListener(AFTER_NAVIGATE_EVENT, restoreDocumentAttribute);
+  });
+  const toggle = () => {
+    const next = !visible.value;
+    visible.value = next;
+    writeTocState(next);
+    setTocDataAttribute(next);
+  };
+  return /* @__PURE__ */ jsxs(
+    "button",
+    {
+      type: "button",
+      "on:click": toggle,
+      class: "zd-desktop-toc-toggle hidden xl:flex fixed bottom-vsp-xl z-sidebar items-center justify-center w-[1.5rem] h-[3rem] bg-surface border border-muted border-r-0 text-muted cursor-pointer transition-[right,color] duration-200 hover:text-fg",
+      style: "border-radius:var(--radius-DEFAULT) 0 0 var(--radius-DEFAULT)",
+      "aria-label": computed(() => visible.value ? "Hide table of contents" : "Show table of contents"),
+      "aria-pressed": visible,
+      children: [
+        /* @__PURE__ */ jsx(Show, { when: computed(() => visible.value), children: () => /* @__PURE__ */ jsx(ChevronRight, { class: "h-icon-sm w-icon-sm" }) }),
+        /* @__PURE__ */ jsx(Show, { when: computed(() => !visible.value), children: () => /* @__PURE__ */ jsx(ChevronLeft, { class: "h-icon-sm w-icon-sm" }) })
+      ]
+    }
+  );
+}
+DesktopTocToggle.displayName = "DesktopTocToggle";
+export {
+  DesktopTocToggle
+};

package/dist/desktop-toc-toggle-island/storage.d.ts

@@ -0,0 +1,4 @@
+export declare const TOC_STORAGE_KEY = "zudo-doc-toc-visible";
+export declare function readTocState(): boolean;
+export declare function writeTocState(isVisible: boolean): void;
+export declare function setTocDataAttribute(isVisible: boolean): void;

package/dist/desktop-toc-toggle-island/storage.js

@@ -0,0 +1,29 @@
+const TOC_STORAGE_KEY = "zudo-doc-toc-visible";
+function readTocState() {
+  if (typeof window === "undefined") return true;
+  try {
+    return localStorage.getItem(TOC_STORAGE_KEY) !== "false";
+  } catch {
+    return true;
+  }
+}
+function writeTocState(isVisible) {
+  try {
+    localStorage.setItem(TOC_STORAGE_KEY, String(isVisible));
+  } catch {
+  }
+}
+function setTocDataAttribute(isVisible) {
+  if (typeof document === "undefined") return;
+  if (isVisible) {
+    document.documentElement.removeAttribute("data-toc-hidden");
+  } else {
+    document.documentElement.setAttribute("data-toc-hidden", "");
+  }
+}
+export {
+  TOC_STORAGE_KEY,
+  readTocState,
+  setTocDataAttribute,
+  writeTocState
+};

package/dist/details/details.d.ts

@@ -1,6 +1,5 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-import type { ComponentChildren, VNode } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
 export interface DetailsProps {
     /**
      * Summary / toggle label shown in the `<summary>` element.
@@ -9,7 +8,7 @@ export interface DetailsProps {
      */
     title?: string;
     /** Slot content rendered inside the collapsed body. */
-    children?: ComponentChildren;
+    children?: Child;
 }
 /**
  * Collapsible `<details>` / `<summary>` block — JSX port of
@@ -19,4 +18,4 @@ export interface DetailsProps {
  * The legacy component used Astro's `<slot />`; v2 accepts standard
  * Preact `children`.
  */
-export declare function Details({ title, children }: DetailsProps): VNode;
+export declare function Details({ title, children }: DetailsProps): Child;

package/dist/details/details.js

@@ -1,4 +1,4 @@
-import { jsx, jsxs } from "preact/jsx-runtime";
+import { jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
 function Details({ title = "Details", children }) {
   return /* @__PURE__ */ jsxs("details", { class: "my-vsp-md border border-muted rounded-lg overflow-hidden", children: [
     /* @__PURE__ */ jsx("summary", { class: "cursor-pointer px-hsp-lg py-vsp-sm bg-surface font-medium text-fg select-none hover:text-accent", children: title }),

package/dist/doc-body-end/index.d.ts

@@ -1,6 +1,5 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-import type { JSX } from "preact";
+import type { JSX } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import type { ChromeContext } from "../factory-context/index.js";
 import type { Settings } from "../settings.js";
 /** Settings subset read by the DocBodyEnd factory. */

package/dist/doc-body-end/index.js

@@ -1,4 +1,4 @@
-import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+import { Fragment, jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import { SidebarResizerInit } from "../sidebar-resizer/index.js";
 import { deriveBodyEndIslands } from "../chrome/derive.js";
 import { assertChromeContext } from "../chrome/assert-chrome-context.js";

package/dist/doc-body-end-islands/design-token-panel-island.d.ts

@@ -1,9 +1,9 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-import type { JSX } from "preact";
+import type { JSX } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import type { FactoryComponent } from "../factory-context/index.js";
 export interface DesignTokenPanelIslandDeps {
     designTokenPanel: boolean;
+    /** Server boundary with a fixed client target, not a raw client component. */
     DesignTokenPanelBootstrap?: FactoryComponent;
 }
 /**