@takazudo/zudo-doc 5.28.2 → 6.0.0

package/dist/extract-headings/index.js

@@ -1,3 +1,4 @@
+import { parseFragment } from "parse5";
 const SLUGIFY_STRIPPED = new Set(
   "!\"#$%&'()*+,./:;<=>?@[\\]^`{|}~".split("")
 );
@@ -84,7 +85,33 @@ function stripInlineMarkdown(raw) {
     masked += raw[i];
     i++;
   }
-  return masked.replace(/\[([^\]]*)\]\([^)]*\)/g, "$1").replace(/\*\*([^*]+)\*\*/g, "$1").replace(/(?<![A-Za-z0-9])__([^_]+)__(?![A-Za-z0-9])/g, "$1").replace(/\*([^*]+)\*/g, "$1").replace(/(?<![A-Za-z0-9])_([^_]+)_(?![A-Za-z0-9])/g, "$1").replace(/\uE000(\d+)\uE001/g, (_match, index) => protectedText[Number(index)] ?? "").trim();
+  return masked.replace(/\[([^\]]*)\]\([^)]*\)/g, "$1").replace(/\*\*([^*]+)\*\*/g, "$1").replace(/(?<![A-Za-z0-9])__([^_]+)__(?![A-Za-z0-9])/g, "$1").replace(/\*([^*]+)\*/g, "$1").replace(/(?<![A-Za-z0-9])_([^_]+)_(?![A-Za-z0-9])/g, "$1").replace(/&#(?:[0-9]{1,7}|[xX][0-9a-fA-F]{1,6});|&[A-Za-z][A-Za-z0-9]{1,31};/g, decodeCharacterReference).replace(/\uE000(\d+)\uE001/g, (_match, index) => protectedText[Number(index)] ?? "").trim();
+}
+function decodeCharacterReference(reference) {
+  if (reference.startsWith("&#")) {
+    const hex = reference[2]?.toLowerCase() === "x";
+    const value = Number.parseInt(reference.slice(hex ? 3 : 2, -1), hex ? 16 : 10);
+    if (value === 0 || value > 1114111 || value >= 55296 && value <= 57343 || value < 32 && ![9, 10, 13].includes(value) || value >= 127 && value <= 159) {
+      return "\uFFFD";
+    }
+    return String.fromCodePoint(value);
+  }
+  let invalid = false;
+  const fragment = parseFragment(reference, { onParseError: () => {
+    invalid = true;
+  } });
+  if (invalid) return reference;
+  return fragment.childNodes.map((node) => node.nodeName === "#text" && "value" in node ? node.value : "").join("");
+}
+function openingFence(line) {
+  const match = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(line);
+  if (!match || match[1]?.startsWith("`") && match[2]?.includes("`")) return null;
+  return match[1] ?? null;
+}
+function closesFence(line, opener) {
+  const match = /^ {0,3}(`{3,}|~{3,})[ \t\r]*$/.exec(line);
+  const run = match?.[1];
+  return run !== void 0 && run[0] === opener[0] && run.length >= opener.length;
 }
 function resolveDepthWindow(rawMin, rawMax) {
   const min = Math.trunc(Number(rawMin));
@@ -111,7 +138,7 @@ function collectHeadings(body, lo, hi) {
   const candidate = classifyLines(lines);
   for (const [index, line] of lines.entries()) {
     if (candidate[index] !== true) continue;
-    const match = /^(#{2,6})[ \t]+(.+)$/.exec(line.trim());
+    const match = /^ {0,3}(#{2,6})[ \t]+(.+)$/.exec(line);
     if (!match) continue;
     const hashes = match[1];
     const rawText = match[2];
@@ -133,7 +160,7 @@ function findCodeSpanEnd(lines, from, runLength) {
   for (let lineIndex = from; lineIndex < lines.length; lineIndex++) {
     const line = lines[lineIndex] ?? "";
     const trimmed = line.trimStart();
-    if (trimmed.trim() === "" || ATX_HEADING.test(trimmed) || /^(?:`{3,}|~{3,})/.test(trimmed)) {
+    if (trimmed.trim() === "" || ATX_HEADING.test(trimmed) || openingFence(line) !== null) {
       return null;
     }
     for (const match of line.matchAll(/`+/g)) {
@@ -176,18 +203,22 @@ function scanLines(lines, ignoredOpeners) {
     } else if (exprDepth > 0 || tag !== null) {
       candidate.push(false);
     } else {
-      const fence = /^([`~]{3,})/.exec(trimmed)?.[1];
-      if (fence !== void 0) {
-        if (codeFenceOpener === null) {
-          codeFenceOpener = fence;
-        } else if (fence[0] === codeFenceOpener[0] && fence.length >= codeFenceOpener.length) {
-          codeFenceOpener = null;
-        }
+      if (codeFenceOpener !== null) {
+        if (closesFence(line, codeFenceOpener)) codeFenceOpener = null;
+        candidate.push(false);
+        continue;
+      }
+      const fence = openingFence(line);
+      if (fence !== null) {
+        codeFenceOpener = fence;
+        candidate.push(false);
+        continue;
+      }
+      if (/^(?: {4}| *\t)/.test(line)) {
         candidate.push(false);
         continue;
       }
-      candidate.push(codeFenceOpener === null);
-      if (codeFenceOpener !== null) continue;
+      candidate.push(true);
     }
     for (let i = start; i < line.length; i++) {
       const ch = line[i] ?? "";

package/dist/factory-context/index.d.ts

@@ -1,3 +1,4 @@
+import type { Child, Component } from "@takazudo/zfb/zudo-react";
 import type { LocaleConfig, Settings } from "../settings.js";
 import type { AssetManifest, ColorScheme, ThemePackRegistry } from "../route-context-payload/types.js";
 import type { UrlHelpers } from "../url-helpers/index.js";
@@ -43,9 +44,10 @@ export interface FactoryI18n {
  * reason and a CLAUDE.md entry. All slots are optional so a factory takes only
  * the ones it needs.
  *
- * Components are typed as the structural `FactoryComponent` (a function
- * returning Preact-renderable output) rather than a concrete signature, so the
- * type stays node-free and Preact-version-agnostic at the boundary.
+ * Components are typed as the structural `FactoryComponent` (a
+ * `Component<Record<string, unknown>>`) rather than a concrete signature, so
+ * the type stays node-free at the boundary while using zfb's component and
+ * child contract.
  */
 export interface FactoryComponents {
     /** Locale-aware category nav wrapper (reads the project's content collection). */
@@ -63,8 +65,8 @@ export interface FactoryComponents {
     /** PresetGenerator SSR shell (showcase-only; downstream projects stub it). */
     PresetGenerator?: FactoryComponent;
 }
-/** Any Preact-renderable component — a function returning a VNode/children. */
-export type FactoryComponent = (props: Record<string, unknown>) => unknown;
+/** A component receiving the broad props shape used by chrome factories. */
+export type FactoryComponent = Component<Record<string, unknown>>;
 /**
  * Opaque per-locale nav-source handle. The host owns the actual content-loader
  * implementation (it reads project content collections, which cannot live in the
@@ -230,20 +232,21 @@ export interface ChromeHostBindings {
     /** Body-end islands (bootstrap islands). Default: the package-island subset
      *  derived from `settings` (no host-only client-router / token-panel boots). */
     BodyEndIslands?: FactoryComponent;
-    /** DocHistory island. Default: a no-op stub rendering an empty fragment. */
+    /** DocHistory server boundary. Default: a no-op stub rendering an empty fragment.
+     * Use DocHistoryBoundary from the doc-history-area entrypoint for the package
+     * client. Custom boundaries consume ssrFallback server-side and wrap their
+     * statically imported client target in a Fragment-wrapped Island. */
     DocHistory?: FactoryComponent;
     /**
-     * Design-token panel bootstrap island (#2658). Default: the PACKAGE-DEFAULT
-     * `DesignTokenPanelBootstrap` from
-     * `@takazudo/zudo-doc/design-token-panel-bootstrap`, statically imported by
-     * `chrome/derive.tsx` (`deriveBodyEndIslands`) so EVERY `createChrome`
-     * consumer — the injected `routes/_chrome.tsx` path and the locked-manifest
-     * self-contained doc stub alike — gets the settings-gated panel island with
-     * no explicit wiring (#2659 gate-2 fix; scanner reachability holds through
-     * the static route → chrome → derive → bootstrap chain, the #2480
-     * contract). Supply this slot only to REPLACE the island with a host's own
-     * bootstrap component. Mounting is still gated on
-     * `settings.designTokenPanel` inside `createBodyEndIslands` either way.
+     * Zero-prop server boundary for the design-token-panel bootstrap. Return a
+     * Fragment containing Island({ when: "load", children: <HostBootstrap /> })
+     * with a statically imported client target; a raw client component is not
+     * a boundary. The package default owns the same fixed-target shape.
+     * The package controls settings.designTokenPanel and the toggle shim; it
+     * renders this boundary unchanged and never wraps a dynamic Island target.
+     * An explicit host boundary wins over configured-route and package defaults,
+     * including when designTokenPanelConfigModule suppresses the package default.
+     * With designTokenPanel disabled neither this boundary nor the shim mounts.
      */
     DesignTokenPanelBootstrap?: FactoryComponent;
     /** MDX content-component overrides (Details / HtmlPreview / Island /
@@ -264,7 +267,7 @@ export interface ChromeHostBindings {
         locale: string;
         isFallback?: boolean;
         version?: string;
-    }) => unknown;
+    }) => Child;
     /**
      * Extra content rendered in the home hero. A RENDERER (not a component).
      * Default: absent → renders nothing. The `/` home route is never injected
@@ -274,7 +277,7 @@ export interface ChromeHostBindings {
      */
     homeExtras?: (args: {
         locale: string;
-    }) => unknown;
+    }) => Child;
 }
 /**
  * The unified chrome context — the superset that fully wires the page chrome:

package/dist/features.css

@@ -3,15 +3,17 @@
  *
  * Shipped to consumers as `@takazudo/zudo-doc/features.css` (copied to
  * `dist/features.css` by scripts/copy-features-css.mjs on build). Provides
- * feature CSS that is NOT coupled to a specific Preact island — it is shared
+ * feature CSS that is NOT coupled to a specific island — it is shared
  * across all projects that use @takazudo/zudo-doc regardless of which islands
  * are active. See zudolab/zudo-doc#2331.
  *
  * ── Consumer contract ──────────────────────────────────────────────────────
- * The consumer's @theme MUST define the custom properties consumed below:
+ * The custom properties consumed below are plain `:root` variables supplied by
+ * the zudoDoc() token defaults (`@takazudo/zudo-doc/theme.css`); override them
+ * in a `:root` rule after the imports. No consumer `@theme` is involved:
  *   --color-{bg,fg,muted,accent,surface,code-bg,code-fg,success,warning,
  *            matched-keyword-bg,matched-keyword-fg}
- *   --spacing-{hsp-sm,hsp-2xs,hsp-lg,hsp-md,hsp-xl,vsp-xs,vsp-2xs,vsp-md,vsp-lg,
+ *   --spacing-{hsp-sm,hsp-2xs,hsp-lg,hsp-md,hsp-xl,vsp-xs,vsp-2xs,vsp-sm,vsp-md,vsp-lg,
  *              icon-sm}
  *   --z-index-{local-1,local-2}
  *   --z-index-toolbar
@@ -27,8 +29,7 @@
  *   --zd-transition-slow
  *   --zd-transition-slower
  *   --default-transition-duration
- * All of these are defined by the project's @theme block (which is a
- * pre-condition before @importing this file).
+ * Import `theme.css` before this file so the defaults are defined.
  * ─────────────────────────────────────────────────────────────────────────── */
 
 /* ========================================
@@ -1001,11 +1002,11 @@ dialog.zd-mermaid-dialog::backdrop {
  *
  * The `body { font-family }` rule below is the CHROME FONT SEAM (#2887): it is
  * why a theme pack's `--font-sans` reaches the header/sidebar/TOC/footer at all.
- * Those surfaces set no font-family of their own, and preflight's `html, :host`
+ * Those surfaces set no font-family of their own, and the reset's `html, :host`
  * rule compiles to a hardcoded literal stack here (no `--default-font-family` is
  * ever defined), so without this rule the token could only ever reach `.zd-content`
- * prose. It works because this block is UNLAYERED and preflight is imported into
- * `layer(zd-preflight)` — see component-tokens.ts for the full rationale.
+ * prose. It works because this block is UNLAYERED and the reset lives in
+ * `@layer zw-reset` — see component-tokens.ts for the full rationale.
  * ========================================================================== */
 
 /* BEGIN --zdc-* chrome component tokens (generated by gen-component-tokens; do not edit by hand) */
@@ -1284,3 +1285,64 @@ html[data-asset-details-hidden]
 [data-zd-asset-tree] details[open] > summary > svg:nth-child(2) {
   display: none;
 }
+
+/* zfb 3 wind does not compile these relation selectors or effect families.
+ * Keep the component-owned rules unlayered, alongside Tailwind v4 utilities. */
+.zd-footer-copyright-links a {
+  text-decoration-line: underline;
+}
+.zd-footer-copyright-links a:hover,
+.zd-footer-copyright-links a:focus-visible {
+  color: var(--color-accent);
+}
+
+.zd-hide-details-marker::-webkit-details-marker {
+  display: none;
+}
+
+.zd-list-items-no-margin li,
+.zd-breadcrumb-nav-no-margin nav {
+  margin-bottom: 0;
+}
+
+.zd-card-links-interactive a {
+  pointer-events: auto;
+}
+
+.zd-wrap-anywhere {
+  overflow-wrap: anywhere;
+}
+
+/* Search rows own their padding; idle and status content need the same inset. */
+site-search [data-search-results] > :is([data-search-placeholder], p) {
+  padding-top: var(--spacing-vsp-sm);
+}
+
+.zd-search-excerpt-decoration {
+  text-decoration-color: var(--color-muted);
+}
+
+.zd-preview-shadow {
+  /* Preserve Tailwind's four transparent shadow layers in computed styles. */
+  box-shadow:
+    0 0 #0000,
+    0 0 #0000,
+    0 0 #0000,
+    0 0 #0000,
+    0 1px 3px var(--color-fg);
+}
+
+@supports (color: color-mix(in lab, red, red)) {
+  .zd-preview-shadow {
+    box-shadow:
+      0 0 #0000,
+      0 0 #0000,
+      0 0 #0000,
+      0 0 #0000,
+      0 1px 3px color-mix(in srgb, var(--color-fg) 8%, transparent);
+  }
+}
+
+.zd-theme-pack-active-ring {
+  box-shadow: 0 0 0 2px var(--color-accent);
+}

package/dist/find-in-page/find-bar.d.ts

@@ -1,9 +1,11 @@
+/** @jsxRuntime automatic */
+import { type ReadonlySignal } from "@takazudo/zfb/zudo-react";
 import type { FindInPage } from "./find-in-page.js";
 interface FindBarProps {
-    visible: boolean;
+    visible: ReadonlySignal<boolean>;
     onClose: () => void;
     findInPage: FindInPage;
     containerSelector: string;
 }
-export declare function FindBar({ visible, onClose, findInPage, containerSelector }: FindBarProps): import("preact").JSX.Element | null;
+export declare function FindBar({ visible, onClose, findInPage, containerSelector }: FindBarProps): import("@takazudo/zfb").Description;
 export {};

package/dist/find-in-page/find-bar.js

@@ -1,84 +1,74 @@
-"use client";
-import { jsx, jsxs } from "preact/jsx-runtime";
-import { useState, useRef, useEffect, useCallback } from "preact/hooks";
+import { jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
+import {
+  computed,
+  getScope,
+  Show,
+  signal
+} from "@takazudo/zfb/zudo-react";
 function toMatchInfo(result) {
   return result.matches > 0 ? result : null;
 }
 function FindBar({ visible, onClose, findInPage, containerSelector }) {
-  const [query, setQuery] = useState("");
-  const [matchInfo, setMatchInfo] = useState(null);
-  const inputRef = useRef(null);
-  const findInPageRef = useRef(findInPage);
-  useEffect(() => {
-    findInPageRef.current = findInPage;
-  }, [findInPage]);
-  useEffect(() => {
-    if (visible) {
-      inputRef.current?.focus();
-      inputRef.current?.select();
+  const query = signal("");
+  const matchInfo = signal(null);
+  const inputRef = { current: null };
+  const scope = getScope();
+  scope.effect(() => {
+    if (!visible.value) {
+      query.value = "";
+      matchInfo.value = null;
+      findInPage.stop();
+      return;
     }
-  }, [visible]);
-  useEffect(() => {
-    if (!visible) {
-      setQuery("");
-      setMatchInfo(null);
-      findInPageRef.current.stop();
+    const text = query.value;
+    const container = document.querySelector(containerSelector);
+    if (!text || !(container instanceof HTMLElement)) {
+      matchInfo.value = null;
+      findInPage.stop();
+      return;
     }
-  }, [visible]);
-  const handleFind = useCallback(
-    (text) => {
-      const container = document.querySelector(containerSelector);
-      if (!text || !(container instanceof HTMLElement)) {
-        setMatchInfo(null);
-        findInPage.stop();
-        return;
-      }
-      const result = findInPage.find(container, text);
-      setMatchInfo(toMatchInfo(result));
-    },
-    [findInPage, containerSelector]
-  );
-  const handleKeyDown = useCallback(
-    // Plain DOM `KeyboardEvent` — matches the ai-chat-modal onKeyDown
-    // precedent (`../ai-chat-modal/index.tsx`); Preact's JSX
-    // `onKeyDown` prop accepts it directly, no React-namespace type needed.
-    (e) => {
-      if (e.key === "Escape") {
-        onClose();
-      } else if (e.key === "Enter") {
-        const result = e.shiftKey ? findInPage.prev() : findInPage.next();
-        setMatchInfo(toMatchInfo(result));
-      }
-    },
-    [onClose, findInPage]
-  );
-  if (!visible) return null;
-  return /* @__PURE__ */ jsxs("div", { className: "fixed top-[3.5rem] right-0 z-dropdown flex items-center gap-hsp-sm py-hsp-xs px-hsp-md bg-surface border-b border-l border-muted rounded-bl-lg shadow-md", children: [
+    matchInfo.value = toMatchInfo(findInPage.find(container, text));
+  });
+  scope.effect(() => {
+    if (!visible.value) return;
+    inputRef.current?.focus();
+    inputRef.current?.select();
+  });
+  scope.onCleanup(() => findInPage.stop());
+  const handleKeyDown = (event) => {
+    const keyboard = event;
+    if (keyboard.isComposing || event.defaultPrevented) return;
+    if (keyboard.key === "Escape") {
+      onClose();
+    } else if (keyboard.key === "Enter") {
+      const result = keyboard.shiftKey ? findInPage.prev() : findInPage.next();
+      matchInfo.value = toMatchInfo(result);
+    }
+  };
+  return /* @__PURE__ */ jsx(Show, { when: computed(() => visible.value), children: () => /* @__PURE__ */ jsxs("div", { class: "fixed top-[3.5rem] right-0 z-dropdown flex items-center gap-hsp-sm py-hsp-xs px-hsp-md bg-surface border-b border-l border-muted rounded-bl-lg", children: [
     /* @__PURE__ */ jsx(
       "input",
       {
         ref: inputRef,
-        className: "w-[12rem] py-[4px] px-hsp-sm rounded text-small bg-bg border border-muted text-fg outline-none focus:border-accent",
+        class: "w-[12rem] py-[4px] px-hsp-sm rounded text-small bg-bg border border-muted text-fg outline-none focus:border-accent",
         type: "text",
-        value: query,
+        modelValue: query,
         placeholder: "Find in page...",
         "aria-label": "Find in page",
-        onChange: (e) => {
-          setQuery(e.currentTarget.value);
-          handleFind(e.currentTarget.value);
-        },
-        onKeyDown: handleKeyDown
+        "on:keydown": handleKeyDown
       }
     ),
-    /* @__PURE__ */ jsx("span", { className: "text-caption whitespace-nowrap min-w-[3rem] text-center text-fg/60", children: matchInfo ? `${matchInfo.activeMatchOrdinal}/${matchInfo.matches}` : "" }),
+    /* @__PURE__ */ jsx("span", { class: "text-caption whitespace-nowrap min-w-[3rem] text-center text-fg/60", children: computed(() => {
+      const result = matchInfo.value;
+      return result ? `${result.activeMatchOrdinal}/${result.matches}` : "";
+    }) }),
     /* @__PURE__ */ jsx(
       "button",
       {
         type: "button",
-        className: "py-hsp-2xs px-hsp-sm rounded text-caption bg-bg border border-muted text-fg hover:bg-surface",
-        onClick: () => {
-          const result = findInPage.prev();
-          setMatchInfo(toMatchInfo(result));
+        class: "py-hsp-2xs px-hsp-sm rounded text-caption bg-bg border border-muted text-fg hover:bg-surface",
+        "on:click": () => {
+          matchInfo.value = toMatchInfo(findInPage.prev());
         },
         title: "Previous (Shift+Enter)",
         children: "Prev"
@@ -88,10 +78,9 @@ function FindBar({ visible, onClose, findInPage, containerSelector }) {
       "button",
       {
         type: "button",
-        className: "py-hsp-2xs px-hsp-sm rounded text-caption bg-bg border border-muted text-fg hover:bg-surface",
-        onClick: () => {
-          const result = findInPage.next();
-          setMatchInfo(toMatchInfo(result));
+        class: "py-hsp-2xs px-hsp-sm rounded text-caption bg-bg border border-muted text-fg hover:bg-surface",
+        "on:click": () => {
+          matchInfo.value = toMatchInfo(findInPage.next());
         },
         title: "Next (Enter)",
         children: "Next"
@@ -101,13 +90,13 @@ function FindBar({ visible, onClose, findInPage, containerSelector }) {
       "button",
       {
         type: "button",
-        className: "py-hsp-2xs px-hsp-sm rounded text-caption bg-bg border border-muted text-fg hover:bg-surface",
-        onClick: onClose,
+        class: "py-hsp-2xs px-hsp-sm rounded text-caption bg-bg border border-muted text-fg hover:bg-surface",
+        "on:click": onClose,
         title: "Close (Esc)",
         children: "Close"
       }
     )
-  ] });
+  ] }) });
 }
 export {
   FindBar

package/dist/find-in-page/index.d.ts

@@ -1,11 +1,5 @@
-import type { JSX } from "preact";
-/**
- * `displayName` pinned explicitly (matching
- * `AiChatModal`/`ImageEnlarge`/`MermaidEnlarge`/`DesignTokenPanelBootstrap`)
- * so zfb's `captureComponentName` emits a stable
- * `data-zfb-island="FindInPageInit"` marker independent of minification.
- */
-export declare function FindInPageInit(): JSX.Element | null;
+import type { JSX } from "@takazudo/zfb/zudo-react/jsx-runtime";
+export declare function FindInPageInit(): JSX.Element;
 export declare namespace FindInPageInit {
     var displayName: string;
 }

package/dist/find-in-page/index.js

@@ -1,47 +1,50 @@
 "use client";
-import { jsx } from "preact/jsx-runtime";
-import { useState, useEffect, useRef } from "preact/compat";
+import { jsx } from "@takazudo/zfb/zudo-react/jsx-runtime";
+import { computed, getScope, Show, signal } from "@takazudo/zfb/zudo-react";
 import { FindBar } from "./find-bar.js";
 import { createFindInPage } from "./find-in-page.js";
 const CONTENT_SELECTOR = "article.zd-content";
+const BEFORE_PREPARATION_EVENT = "zfb:before-preparation";
 function FindInPageInit() {
-  const [isTauri, setIsTauri] = useState(false);
-  const [visible, setVisible] = useState(false);
-  const findInPageRef = useRef(createFindInPage());
-  useEffect(() => {
-    if (typeof window !== "undefined" && "__TAURI_INTERNALS__" in window) {
-      setIsTauri(true);
+  const isTauri = signal(false);
+  const visible = signal(false);
+  const findInPage = createFindInPage();
+  const scope = getScope();
+  scope.onActivate(() => {
+    if (typeof window === "undefined" || !("__TAURI_INTERNALS__" in window)) {
+      return;
     }
-  }, []);
-  useEffect(() => {
-    if (!isTauri) return;
-    const handler = (e) => {
-      if ((e.metaKey || e.ctrlKey) && e.key === "f") {
-        e.preventDefault();
-        setVisible((prev) => !prev);
+    isTauri.value = true;
+    const handleKeyDown = (event) => {
+      const keyboard = event;
+      if (keyboard.isComposing || event.defaultPrevented || !(keyboard.metaKey || keyboard.ctrlKey) || keyboard.key !== "f") {
+        return;
       }
+      event.preventDefault();
+      visible.value = !visible.value;
     };
-    document.addEventListener("keydown", handler);
-    return () => document.removeEventListener("keydown", handler);
-  }, [isTauri]);
-  useEffect(() => {
-    const handler = () => {
-      findInPageRef.current.stop();
-      setVisible(false);
+    const handleBeforePreparation = () => {
+      findInPage.stop();
+      visible.value = false;
     };
-    document.addEventListener("zfb:before-preparation", handler);
-    return () => document.removeEventListener("zfb:before-preparation", handler);
-  }, []);
-  if (!isTauri) return null;
-  return /* @__PURE__ */ jsx(
+    document.addEventListener("keydown", handleKeyDown);
+    document.addEventListener(BEFORE_PREPARATION_EVENT, handleBeforePreparation);
+    return () => {
+      document.removeEventListener("keydown", handleKeyDown);
+      document.removeEventListener(BEFORE_PREPARATION_EVENT, handleBeforePreparation);
+    };
+  });
+  return /* @__PURE__ */ jsx(Show, { when: computed(() => isTauri.value), children: () => /* @__PURE__ */ jsx(
     FindBar,
     {
       visible,
-      onClose: () => setVisible(false),
-      findInPage: findInPageRef.current,
+      onClose: () => {
+        visible.value = false;
+      },
+      findInPage,
       containerSelector: CONTENT_SELECTOR
     }
-  );
+  ) });
 }
 FindInPageInit.displayName = "FindInPageInit";
 export {

package/dist/footer/footer.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 { FooterLinkColumn, FooterTagColumn } from "./types.js";
 export interface FooterProps {
     /**
@@ -15,7 +14,7 @@ export interface FooterProps {
      */
     tagColumns?: FooterTagColumn[];
     /**
-     * Copyright HTML. Rendered via `dangerouslySetInnerHTML` so embedded
+     * Copyright HTML. Rendered via `rawHtml` so embedded
      * anchors work. The caller is responsible for the contents.
      */
     copyright?: string;
@@ -35,4 +34,4 @@ export interface FooterProps {
  * configured. The inner content (link grid, copyright) is only emitted
  * when the respective slots carry data.
  */
-export declare function Footer(props: FooterProps): VNode;
+export declare function Footer(props: FooterProps): Child;

package/dist/footer/footer.js

@@ -1,4 +1,4 @@
-import { jsx, jsxs } from "preact/jsx-runtime";
+import { jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
 function Footer(props) {
   const linkColumns = props.linkColumns ?? [];
   const tagColumns = props.tagColumns ?? [];
@@ -6,7 +6,7 @@ function Footer(props) {
   const persistKey = props.persistKey;
   const hasColumns = linkColumns.length > 0 || tagColumns.length > 0;
   const hasCopyright = copyright.length > 0;
-  const copyrightClass = hasColumns ? "text-center text-caption text-muted [&_a]:underline [&_a:hover]:text-accent [&_a:focus-visible]:text-accent mt-vsp-lg border-t border-muted pt-vsp-md" : "text-center text-caption text-muted [&_a]:underline [&_a:hover]:text-accent [&_a:focus-visible]:text-accent";
+  const copyrightClass = hasColumns ? "text-center text-caption text-muted zd-footer-copyright-links mt-vsp-lg border-t border-muted pt-vsp-md" : "text-center text-caption text-muted zd-footer-copyright-links";
   return /* @__PURE__ */ jsx(
     "footer",
     {
@@ -68,7 +68,7 @@ function Footer(props) {
           "div",
           {
             class: copyrightClass,
-            dangerouslySetInnerHTML: { __html: copyright }
+            rawHtml: copyright
           }
         )
       ] })

package/dist/footer-with-defaults/index.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 { ChromeContext } from "../factory-context/index.js";
 import type { Settings } from "../settings.js";
 /** Tag info returned by the host's `collectTags` (what the factory sees). */
@@ -59,4 +58,4 @@ export interface FooterWithDefaultsSettings {
  */
 export declare function createFooterWithDefaults<S extends Settings = Settings>(ctx: ChromeContext<S>): (props: {
     lang?: string;
-}) => VNode;
+}) => Child;

package/dist/footer-with-defaults/index.js

@@ -1,4 +1,4 @@
-import { jsx } from "preact/jsx-runtime";
+import { jsx } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import { Footer } from "../footer/index.js";
 import { assertChromeContext } from "../chrome/assert-chrome-context.js";
 function createFooterWithDefaults(ctx) {

package/dist/frontmatter-preview-defaults/index.js

@@ -4,6 +4,7 @@ const defaultFrontmatterPreviewIgnoreKeys = [
   "category",
   "sidebar_position",
   "sidebar_label",
+  "sidebar_initial_expansion",
   "tags",
   "search_exclude",
   "pagination_next",

package/dist/head/doc-head.d.ts

@@ -1,4 +1,4 @@
-import type { JSX } from "preact";
+import type { JSX } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import type { HeadProps } from "./types.js";
 /**
  * Framework head tag emission. Renders only the meta-tag layer of <head>;