@takazudo/zudo-doc 5.28.2 → 6.0.0

package/dist/asset-index-page/body.js

@@ -1,4 +1,4 @@
-import { jsx, jsxs } from "preact/jsx-runtime";
+import { jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import { formatAssetBytes } from "../asset-components/index.js";
 import { assetViewerHref } from "../asset-path/index.js";
 import { facetLabel, kindLabel } from "../asset-page/shared.js";
@@ -49,9 +49,9 @@ function AssetTree({ node, base, routePrefix, locale, fileCountLabel, fileCountS
   return /* @__PURE__ */ jsxs("ul", { "data-zd-asset-tree": root ? true : void 0, children: [
     node.dirs.map((dir) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsxs("details", { open: true, children: [
       /* @__PURE__ */ jsxs("summary", { class: "flex cursor-pointer items-center gap-hsp-xs rounded px-hsp-sm py-vsp-3xs text-small hover:bg-accent/10 focus-visible:bg-accent/10", children: [
-        /* @__PURE__ */ jsx(ChevronRight, { className: "h-icon-xs w-icon-xs shrink-0 text-muted transition-transform" }),
-        /* @__PURE__ */ jsx(Folder, { className: "h-icon-sm w-icon-sm shrink-0 text-muted" }),
-        /* @__PURE__ */ jsx(FolderOpen, { className: "h-icon-sm w-icon-sm shrink-0 text-muted" }),
+        /* @__PURE__ */ jsx(ChevronRight, { class: "h-icon-xs w-icon-xs shrink-0 text-muted transition-transform" }),
+        /* @__PURE__ */ jsx(Folder, { class: "h-icon-sm w-icon-sm shrink-0 text-muted" }),
+        /* @__PURE__ */ jsx(FolderOpen, { class: "h-icon-sm w-icon-sm shrink-0 text-muted" }),
         /* @__PURE__ */ jsxs("span", { class: "min-w-0 truncate font-mono text-fg", children: [
           dir.name,
           "/"
@@ -69,7 +69,7 @@ function AssetTree({ node, base, routePrefix, locale, fileCountLabel, fileCountS
       const facet = facetLabel(asset, asset.lines !== void 0 ? linesLabel.replace("{count}", String(asset.lines)) : void 0);
       const meta = [kindLabel(asset), facet, formatAssetBytes(asset.bytes)].filter(Boolean).join(" \xB7 ");
       return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsxs("a", { href: assetViewerHref({ base, routePrefix, path: asset.path, locale }), title: asset.name, class: "flex min-w-0 items-center gap-hsp-xs rounded px-hsp-sm py-vsp-3xs text-small text-fg hover:bg-accent/10 hover:text-accent hover:underline focus-visible:bg-accent/10 focus-visible:text-accent focus-visible:underline", children: [
-        /* @__PURE__ */ jsx(Icon, { className: "h-icon-sm w-icon-sm shrink-0 text-muted" }),
+        /* @__PURE__ */ jsx(Icon, { class: "h-icon-sm w-icon-sm shrink-0 text-muted" }),
         /* @__PURE__ */ jsx("span", { class: "min-w-0 truncate font-mono", children: basename(asset.path) }),
         /* @__PURE__ */ jsx("span", { class: "ml-auto hidden whitespace-nowrap pl-hsp-lg text-caption text-muted sm:block", children: meta })
       ] }) });
@@ -105,7 +105,7 @@ function AssetIndexPageBody({ entries, labels, base, routePrefix, dir, locale })
       ] })
     ] }),
     entries.length > 0 ? /* @__PURE__ */ jsx(AssetTree, { root: true, node: tree, base, routePrefix, locale, fileCountLabel: labels.fileCount, fileCountSingleLabel: labels.fileCountSingle, linesLabel: labels.lines }) : /* @__PURE__ */ jsx("p", { class: "text-small text-muted", "data-zd-asset-index-empty": true, children: labels.indexEmpty }),
-    /* @__PURE__ */ jsx("script", { dangerouslySetInnerHTML: { __html: ASSET_INDEX_PAGE_SCRIPT } })
+    /* @__PURE__ */ jsx("script", { rawHtml: ASSET_INDEX_PAGE_SCRIPT })
   ] });
 }
 export {

package/dist/asset-index-page/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 { AssetIndexEntry } from "../route-context-payload/types.js";
 import type { Settings } from "../settings.js";

package/dist/asset-index-page/index.js

@@ -1,4 +1,4 @@
-import { jsx } from "preact/jsx-runtime";
+import { jsx } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import { assertChromeContext } from "../chrome/assert-chrome-context.js";
 import { deriveBodyEndIslands, deriveComposeMetaTitle } from "../chrome/derive.js";
 import { derivePrimaryChromeSlots } from "../chrome/primary-slots.js";

package/dist/asset-page/body.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 { DateFormatPattern } from "../format-date/index.js";
 import type { AssetRecord } from "../plugins/internal/asset-viewer/types.js";
 /**
@@ -58,13 +57,10 @@ export declare function resolveAssetPageLabels(t: (key: string, locale?: string)
  * D3). Render this ahead of the rest of the page `head` — see
  * `createAssetPageView`'s `head` prop on `DocLayoutWithDefaults`.
  *
- * A function, not a shared constant VNode: Preact's diffing mutates
- * bookkeeping fields onto the vnode objects it renders, so one instance
- * reused across many independent SSR passes (e.g. every asset page in a
- * `zfb build` run, all sharing this module) is a latent hazard. Each call
- * returns a fresh vnode.
+ * A function so each page composition receives its own child description;
+ * the executable payload itself is the static literal from `script.ts`.
  */
-export declare function renderAssetDetailsPrepaintScript(): VNode;
+export declare function renderAssetDetailsPrepaintScript(): Child;
 export interface AssetPageBodyProps {
     /** The asset record being rendered. */
     entry: AssetRecord;
@@ -95,4 +91,4 @@ export interface AssetPageBodyProps {
  * placed inline as `DocLayoutWithDefaults`'s children before the #4221
  * split. Plain props only, no `ChromeContext`.
  */
-export declare function AssetPageBody({ entry: asset, locale, rawUrl, labels, fullPattern, backLink, viewSourceUrl, showViewSource, }: AssetPageBodyProps): VNode;
+export declare function AssetPageBody({ entry: asset, locale, rawUrl, labels, fullPattern, backLink, viewSourceUrl, showViewSource, }: AssetPageBodyProps): Child;

package/dist/asset-page/body.js

@@ -1,4 +1,4 @@
-import { jsx, jsxs } from "preact/jsx-runtime";
+import { jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import { BodyFootUtilArea } from "../body-foot-util/index.js";
 import {
   AssetActions,
@@ -42,7 +42,7 @@ function resolveAssetPageLabels(t, locale) {
   };
 }
 function renderAssetDetailsPrepaintScript() {
-  return /* @__PURE__ */ jsx("script", { dangerouslySetInnerHTML: { __html: ASSET_DETAILS_PREPAINT_SCRIPT } });
+  return /* @__PURE__ */ jsx("script", { rawHtml: ASSET_DETAILS_PREPAINT_SCRIPT });
 }
 function AssetPageBody({
   entry: asset,
@@ -97,7 +97,7 @@ function AssetPageBody({
     body,
     /* @__PURE__ */ jsx(AssetActions, { rawUrl, downloadLabel: labels.download, openRawLabel: labels.openRaw, copyLabel: labels.copy, wrapLabel: labels.wrap, bottom: true }),
     showViewSource && /* @__PURE__ */ jsx(BodyFootUtilArea, { sourceUrl: viewSourceUrl, viewSourceLabel: labels.viewSource, docHistoryIsland: null }),
-    /* @__PURE__ */ jsx("script", { dangerouslySetInnerHTML: { __html: ASSET_PAGE_SCRIPT } })
+    /* @__PURE__ */ jsx("script", { rawHtml: ASSET_PAGE_SCRIPT })
   ] });
 }
 export {

package/dist/asset-page/components.d.ts

@@ -1,12 +1,11 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-import type { ComponentChildren, VNode } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
 import type { DateFormatPattern } from "../format-date/index.js";
 import type { AssetRecord } from "../plugins/internal/asset-viewer/types.js";
 export declare function AssetEyebrow({ asset, badge }: {
     asset: AssetRecord;
     badge: string;
-}): VNode;
+}): Child;
 export declare function AssetHeader({ asset, locale, badge, updatedLabel, linesLabel, fullPattern }: {
     asset: AssetRecord;
     locale: string;
@@ -14,7 +13,7 @@ export declare function AssetHeader({ asset, locale, badge, updatedLabel, linesL
     updatedLabel: string;
     linesLabel?: string;
     fullPattern?: DateFormatPattern;
-}): VNode;
+}): Child;
 export declare function AssetActions({ rawUrl, downloadLabel, openRawLabel, copyLabel, wrapLabel, code, bottom }: {
     rawUrl: string;
     downloadLabel: string;
@@ -23,14 +22,14 @@ export declare function AssetActions({ rawUrl, downloadLabel, openRawLabel, copy
     wrapLabel: string;
     code?: boolean;
     bottom?: boolean;
-}): VNode;
+}): Child;
 export declare function AssetCodeBody({ asset, copyLabel, wrapLabel, truncatedLabel, linesLabel }: {
     asset: AssetRecord;
     copyLabel: string;
     wrapLabel: string;
     truncatedLabel: string;
     linesLabel?: string;
-}): VNode;
+}): Child;
 export interface AssetImageStageLabels {
     fit: string;
     actualSize: string;
@@ -42,27 +41,27 @@ export declare function AssetImageStage({ asset, rawUrl, labels }: {
     asset: AssetRecord;
     rawUrl: string;
     labels: AssetImageStageLabels;
-}): VNode;
+}): Child;
 export declare function AssetVideoStage({ asset, rawUrl }: {
     asset: AssetRecord;
     rawUrl: string;
-}): VNode;
+}): Child;
 export declare function AssetPdfStage({ asset, rawUrl, children }: {
     asset: AssetRecord;
     rawUrl: string;
-    children: ComponentChildren;
-}): VNode;
+    children: Child;
+}): Child;
 export declare function AssetDownloadPanel({ asset, rawUrl, noPreview, downloadLabel, copyLabel }: {
     asset: AssetRecord;
     rawUrl: string;
     noPreview: string;
     downloadLabel: string;
     copyLabel: string;
-}): VNode;
+}): Child;
 export declare function AssetLinkedFrom({ asset, label }: {
     asset: AssetRecord;
     label: string;
-}): VNode | null;
+}): Child | null;
 export interface AssetDetailsLabels {
     heading: string;
     type: string;
@@ -74,7 +73,7 @@ export interface AssetDetailsLabels {
 export declare function AssetDetails({ asset, labels }: {
     asset: AssetRecord;
     labels: AssetDetailsLabels;
-}): VNode;
+}): Child;
 export interface AssetDetailsToggleLabels {
     collapse: string;
     expand: string;
@@ -87,8 +86,8 @@ export interface AssetDetailsToggleLabels {
  * `body.tsx#AssetPageBody` can compose it from a different module.
  */
 export declare function AssetBodyLayout({ stage, details, linked, toggleLabels }: {
-    stage: ComponentChildren;
-    details: ComponentChildren;
-    linked: ComponentChildren;
+    stage: Child;
+    details: Child;
+    linked: Child;
     toggleLabels: AssetDetailsToggleLabels;
-}): VNode;
+}): Child;

package/dist/asset-page/components.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 { formatDate } from "../format-date/index.js";
 import { formatAssetBytes } from "../asset-components/index.js";
 import { ChevronLeft, ChevronRight } from "../icons/index.js";
@@ -30,7 +30,7 @@ function AssetHeader({ asset, locale, badge, updatedLabel, linesLabel, fullPatte
 }
 function AssetActions({ rawUrl, downloadLabel, openRawLabel, copyLabel, wrapLabel, code = false, bottom = false }) {
   return /* @__PURE__ */ jsxs("div", { class: `${bottom ? "mt-vsp-lg border-t border-muted pt-vsp-md" : "mb-vsp-md"} flex flex-wrap gap-hsp-sm`, "data-zd-asset-actions": true, children: [
-    /* @__PURE__ */ jsx("a", { download: true, href: rawUrl, class: `${actionClass(true)} hover:underline focus-visible:underline`, children: downloadLabel }),
+    /* @__PURE__ */ jsx("a", { download: "", href: rawUrl, class: `${actionClass(true)} hover:underline focus-visible:underline`, children: downloadLabel }),
     /* @__PURE__ */ jsx("a", { href: rawUrl, "data-zfb-reload": true, target: "_blank", rel: "noopener", class: `${actionClass()} hover:underline focus-visible:underline`, children: openRawLabel }),
     code && /* @__PURE__ */ jsx("button", { type: "button", disabled: true, "data-zd-asset-action": "copy", class: actionClass(), children: copyLabel }),
     code && /* @__PURE__ */ jsx("button", { type: "button", disabled: true, "data-zd-asset-action": "wrap", class: actionClass(), children: wrapLabel })
@@ -54,7 +54,7 @@ function AssetCodeBody({ asset, copyLabel, wrapLabel, truncatedLabel, linesLabel
         /* @__PURE__ */ jsx("button", { type: "button", disabled: true, "data-zd-asset-action": "wrap", class: "text-fg hover:text-accent focus-visible:text-accent", children: wrapLabel })
       ] })
     ] }),
-    /* @__PURE__ */ jsx("pre", { class: "hi-root zd-asset-code", "data-lang": asset.language ?? "text", dangerouslySetInnerHTML: { __html: highlightedCode } }),
+    /* @__PURE__ */ jsx("pre", { class: "hi-root zd-asset-code", "data-lang": asset.language ?? "text", rawHtml: highlightedCode }),
     asset.truncated && /* @__PURE__ */ jsx("p", { class: "mt-vsp-xs text-caption text-muted", children: truncatedLabel })
   ] });
 }
@@ -84,7 +84,7 @@ function AssetVideoStage({ asset, rawUrl }) {
 }
 function AssetPdfStage({ asset, rawUrl, children }) {
   return /* @__PURE__ */ jsxs("section", { children: [
-    /* @__PURE__ */ jsx("iframe", { title: asset.name, src: `${rawUrl}#view=FitH`, class: "zd-asset-pdf h-[70vh] w-full rounded border border-muted" }),
+    /* @__PURE__ */ jsx("iframe", { title: asset.name, src: `${rawUrl}#view=FitH`, "data-zd-asset-pdf": true, class: "h-[70vh] w-full rounded border border-muted" }),
     /* @__PURE__ */ jsx("div", { class: "mt-vsp-sm", children })
   ] });
 }
@@ -99,7 +99,7 @@ function AssetDownloadPanel({ asset, rawUrl, noPreview, downloadLabel, copyLabel
     ] }),
     /* @__PURE__ */ jsx("p", { class: "mb-vsp-md text-small text-muted", children: noPreview }),
     /* @__PURE__ */ jsxs("div", { class: "flex flex-wrap justify-center gap-hsp-sm", children: [
-      /* @__PURE__ */ jsx("a", { download: true, href: rawUrl, class: `${actionClass(true)} hover:underline focus-visible:underline`, children: downloadLabel }),
+      /* @__PURE__ */ jsx("a", { download: "", href: rawUrl, class: `${actionClass(true)} hover:underline focus-visible:underline`, children: downloadLabel }),
       /* @__PURE__ */ jsx("button", { type: "button", "data-zd-asset-action": "copy-url", "data-zd-copy-url": rawUrl, class: actionClass(), children: copyLabel })
     ] })
   ] });
@@ -122,7 +122,7 @@ function AssetDetails({ asset, labels }) {
   return /* @__PURE__ */ jsxs("section", { children: [
     /* @__PURE__ */ jsx("h2", { class: "mb-vsp-xs text-title font-bold", children: labels.heading }),
     /* @__PURE__ */ jsx("dl", { "data-zd-asset-details-list": true, class: "grid grid-cols-[auto_1fr] gap-x-hsp-md gap-y-vsp-2xs text-caption", children: rows.map(([term, value]) => /* @__PURE__ */ jsxs(Fragment, { children: [
-      /* @__PURE__ */ jsx("dt", { class: "font-medium text-muted", children: term }),
+      /* @__PURE__ */ jsx("dt", { class: "font-semibold text-muted", children: term }),
       /* @__PURE__ */ jsx("dd", { class: "min-w-0 break-words text-fg", children: value })
     ] })) })
   ] });
@@ -140,10 +140,11 @@ function AssetDetailsToggle({ labels }) {
       "aria-controls": ASSET_DETAILS_RAIL_ID,
       "aria-expanded": "true",
       "aria-label": labels.collapse,
-      class: "zd-asset-details-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-r-0 rounded-l-DEFAULT text-muted cursor-pointer transition-colors duration-200 ease-in-out hover:text-fg disabled:cursor-default disabled:opacity-50",
+      class: "zd-asset-details-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-r-0 text-muted cursor-pointer transition-colors duration-200 hover:text-fg disabled:cursor-default disabled:opacity-50",
+      style: "border-top-left-radius:var(--radius-DEFAULT);border-bottom-left-radius:var(--radius-DEFAULT)",
       children: [
-        /* @__PURE__ */ jsx("span", { "data-zd-asset-details-chevron": "collapse", children: /* @__PURE__ */ jsx(ChevronRight, { className: "h-icon-sm w-icon-sm" }) }),
-        /* @__PURE__ */ jsx("span", { "data-zd-asset-details-chevron": "expand", children: /* @__PURE__ */ jsx(ChevronLeft, { className: "h-icon-sm w-icon-sm" }) })
+        /* @__PURE__ */ jsx("span", { "data-zd-asset-details-chevron": "collapse", children: /* @__PURE__ */ jsx(ChevronRight, { class: "h-icon-sm w-icon-sm" }) }),
+        /* @__PURE__ */ jsx("span", { "data-zd-asset-details-chevron": "expand", children: /* @__PURE__ */ jsx(ChevronLeft, { class: "h-icon-sm w-icon-sm" }) })
       ]
     }
   );

package/dist/asset-page/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 { AssetRecord } from "../plugins/internal/asset-viewer/types.js";
 import type { Settings } from "../settings.js";

package/dist/asset-page/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 { deriveBodyEndIslands, deriveDateFormats } from "../chrome/derive.js";
 import { deriveComposeMetaTitle } from "../chrome/derive.js";
 import { derivePrimaryChromeSlots } from "../chrome/primary-slots.js";

package/dist/auto-logo/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 { pickGlyphName } from "./shapes.js";
 export { pickGlyphName };
 export { renderAutoLogoStandaloneSvg } from "./standalone.js";

package/dist/auto-logo/index.js

@@ -1,5 +1,5 @@
-import { jsx, jsxs } from "preact/jsx-runtime";
-import { h } from "preact";
+import { jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
+import { h } from "@takazudo/zfb/zudo-react";
 import {
   W,
   H,

package/dist/body-foot-util/body-foot-util-area.d.ts

@@ -1,6 +1,5 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-import type { VNode } from "preact";
+import type { Child, Description } from "@takazudo/zfb/zudo-react";
 /**
  * Default label used when the consumer doesn't pass one. The legacy
  * Astro template translated `doc.viewSource` via the project's i18n
@@ -36,7 +35,7 @@ export interface BodyFootUtilAreaProps {
      *
      * Pass `null` / `undefined` to suppress the history trigger entirely.
      */
-    docHistoryIsland?: VNode | null;
+    docHistoryIsland?: Description | null;
 }
 /**
  * Footer utility area shown below an article body — composes the
@@ -48,4 +47,4 @@ export interface BodyFootUtilAreaProps {
  * surrounding `<section>` (with its top border + spacing) doesn't
  * appear as an empty band.
  */
-export declare function BodyFootUtilArea(props: BodyFootUtilAreaProps): VNode | null;
+export declare function BodyFootUtilArea(props: BodyFootUtilAreaProps): Child;

package/dist/body-foot-util/body-foot-util-area.js

@@ -1,4 +1,4 @@
-import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+import { Fragment, jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
 const DEFAULT_VIEW_SOURCE_LABEL = "View source on GitHub";
 function BodyFootUtilArea(props) {
   const {
@@ -26,7 +26,6 @@ function BodyFootUtilArea(props) {
               /* @__PURE__ */ jsxs(
                 "svg",
                 {
-                  xmlns: "http://www.w3.org/2000/svg",
                   class: "h-[0.875rem] w-[0.875rem]",
                   fill: "none",
                   viewBox: "0 0 24 24",

package/dist/body-foot-util/edit-link.d.ts

@@ -1,6 +1,5 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-import type { VNode } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
 /**
  * Default label used when the consumer doesn't pass one. The legacy
  * Astro template translated `doc.editPage` via the project's i18n
@@ -38,4 +37,4 @@ export interface EditLinkProps {
  * are pre-resolved by the caller. This matches the breadcrumb subpath
  * pattern of "no settings/i18n imports inside the v2 package".
  */
-export declare function EditLink(props: EditLinkProps): VNode | null;
+export declare function EditLink(props: EditLinkProps): Child;

package/dist/body-foot-util/edit-link.js

@@ -1,4 +1,4 @@
-import { jsx, jsxs } from "preact/jsx-runtime";
+import { jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
 const DEFAULT_EDIT_LINK_LABEL = "Edit this page";
 function EditLink(props) {
   const { editUrl, label = DEFAULT_EDIT_LINK_LABEL } = props;
@@ -14,7 +14,6 @@ function EditLink(props) {
         /* @__PURE__ */ jsx(
           "svg",
           {
-            xmlns: "http://www.w3.org/2000/svg",
             class: "h-[0.875rem] w-[0.875rem]",
             fill: "none",
             viewBox: "0 0 24 24",

package/dist/breadcrumb/breadcrumb.d.ts

@@ -1,6 +1,5 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-import type { ComponentChildren, VNode } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
 import type { BreadcrumbItem, BreadcrumbNode } from "./types.js";
 /**
  * Convert a sidebar tree + the current page's id into the ordered list
@@ -30,14 +29,15 @@ export interface BreadcrumbProps {
      * breadcrumb + version-switcher row:
      *
      *   class="mb-vsp-sm flex flex-col items-start gap-vsp-xs
-     *          sm:flex-row sm:items-center sm:justify-between [&_nav]:mb-0"
+     *          sm:flex-row sm:items-center sm:justify-between zd-breadcrumb-nav-no-margin"
      *
-     * The `[&_nav]:mb-0` rule strips the nav's own `mb-vsp-md` so the
+     * The `zd-breadcrumb-nav-no-margin` rule strips the nav's own
+     * `mb-vsp-md` so the
      * wrapper margin controls spacing instead. Use this to place the
      * VersionSwitcher pill inline at the right of the breadcrumb row,
      * matching the reference site's layout on category index pages.
      */
-    rightSlot?: ComponentChildren;
+    rightSlot?: Child;
 }
 /**
  * Breadcrumb trail component.
@@ -50,4 +50,4 @@ export interface BreadcrumbProps {
  * Returns null when no items resolve, matching the documented
  * `items.length > 0 &&` guard.
  */
-export declare function Breadcrumb(props: BreadcrumbProps): VNode | null;
+export declare function Breadcrumb(props: BreadcrumbProps): Child;

package/dist/breadcrumb/breadcrumb.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 { findPath } from "./find-path.js";
 import { ChevronRight } from "../icons/index.js";
 function buildBreadcrumbItems(tree, currentId, homeHref) {
@@ -43,13 +43,12 @@ function isPathLike(text) {
   return false;
 }
 function ChevronIcon() {
-  return /* @__PURE__ */ jsx(ChevronRight, { className: "h-icon-xs w-icon-xs text-muted shrink-0" });
+  return /* @__PURE__ */ jsx(ChevronRight, { class: "h-icon-xs w-icon-xs text-muted shrink-0" });
 }
 function HomeIcon() {
   return /* @__PURE__ */ jsx(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: "h-[1.575rem] w-[1.575rem] shrink-0",
       fill: "none",
       viewBox: "0 0 24 24",
@@ -92,7 +91,7 @@ function Breadcrumb(props) {
     }
   );
   if (props.rightSlot === void 0) return nav;
-  return /* @__PURE__ */ jsxs("div", { class: "mb-vsp-sm flex flex-col items-start gap-vsp-xs sm:flex-row sm:items-center sm:justify-between [&_nav]:mb-0", children: [
+  return /* @__PURE__ */ jsxs("div", { class: "mb-vsp-sm flex flex-col items-start gap-vsp-xs sm:flex-row sm:items-center sm:justify-between zd-breadcrumb-nav-no-margin", children: [
     nav,
     props.rightSlot
   ] });

package/dist/category-nav/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";
 /** Minimal nav node shape required by the category-nav factory. */
 export interface CategoryNavNode {
     /**

package/dist/category-nav/index.js

@@ -1,5 +1,5 @@
-import { jsx } from "preact/jsx-runtime";
-import { CategoryNav as CategoryNavV2 } from "../nav-indexing/index.js";
+import { jsx } from "@takazudo/zfb/zudo-react/jsx-runtime";
+import { CategoryNav as CategoryNavView } from "../nav-indexing/index.js";
 import { remapVersionedHrefs } from "../nav-data-prep/index.js";
 function createCategoryNavWrapper(deps) {
   const { defaultLocale, resolveNavSource, buildNavTree, findNode, firstRoutedHref, versionedDocsUrl } = deps;
@@ -34,10 +34,10 @@ function createCategoryNavWrapper(deps) {
         if (!href) return null;
         return {
           label: node.label,
-          description: node.description,
           href,
           hasPage: true,
-          children: []
+          children: [],
+          ...node.description !== void 0 ? { description: node.description } : {}
         };
       }).filter((n) => n !== null);
     } else if (category !== void 0) {
@@ -47,7 +47,13 @@ function createCategoryNavWrapper(deps) {
       return null;
     }
     if (children.length === 0) return null;
-    return /* @__PURE__ */ jsx(CategoryNavV2, { children, class: className });
+    return /* @__PURE__ */ jsx(
+      CategoryNavView,
+      {
+        children,
+        ...className !== void 0 ? { class: className } : {}
+      }
+    );
   }
   return CategoryNavWrapper;
 }

package/dist/category-tree-nav/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";
 /** Minimal nav node shape required by the category-tree-nav factory. */
 export interface CategoryTreeNavNode {
     /**

package/dist/category-tree-nav/index.js

@@ -1,5 +1,5 @@
-import { jsx } from "preact/jsx-runtime";
-import { CategoryTreeNav as CategoryTreeNavV2 } from "../nav-indexing/index.js";
+import { jsx } from "@takazudo/zfb/zudo-react/jsx-runtime";
+import { CategoryTreeNav as CategoryTreeNavView } from "../nav-indexing/index.js";
 import { remapVersionedHrefs } from "../nav-data-prep/index.js";
 function createCategoryTreeNavWrapper(deps) {
   const { defaultLocale, resolveNavSource, buildNavTree, groupSatelliteNodes, findNode, versionedDocsUrl } = deps;
@@ -27,7 +27,7 @@ function createCategoryTreeNavWrapper(deps) {
     const categoryNode = findNode(tree, category);
     const children = categoryNode?.children.filter((c) => c.hasPage || c.children.length > 0) ?? [];
     if (children.length === 0) return null;
-    return /* @__PURE__ */ jsx(CategoryTreeNavV2, { children });
+    return /* @__PURE__ */ jsx(CategoryTreeNavView, { children });
   }
   return CategoryTreeNavWrapper;
 }

package/dist/chrome/derive.d.ts

@@ -1,9 +1,10 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-import type { JSX, VNode } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
+import type { JSX } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import type { ChromeContext, FactoryComponent } from "../factory-context/index.js";
 import type { ResolvedDateFormats, Settings } from "../settings.js";
 import { type ColorScheme } from "../color-scheme-utils.js";
+export { normalizeIslandData } from "./island-data.js";
 /** Package-default color scheme used when `colorSchemes` is `null` or a key is
  *  missing. Exported so `createChrome` keeps the identical fallback. Base roles
  *  follow the epic's Default Dark defaults on the minimized 5-base ramp
@@ -18,7 +19,7 @@ declare function DocHistoryStub(_props: {
     basePath?: string;
     displayLocale?: string;
     dateFormats?: ResolvedDateFormats;
-}): VNode;
+}): Child;
 /**
  * Derive the single settings -> resolved-roles seam for the `dateFormat`
  * setting (#4075).
@@ -53,7 +54,20 @@ export declare function deriveColorSchemeGenerators(ctx: ChromeContext): {
 export declare function deriveNavDataPrep(ctx: ChromeContext): {
     buildRootMenuItems: (lang: string, currentVersion: string | undefined) => import("../nav-data-prep/index.js").RootMenuItem[];
     buildLocaleLinksForNav: (currentPath: string, lang: string, localeCount: number) => import("../url-helpers/index.js").LocaleLink[] | undefined;
-    buildSidebarNodes: (lang: string, navSection: string | undefined, currentVersion: string | undefined, emptyWhenUnsectioned?: boolean) => import("../sidebar-utils/index.js").SidebarNavNode[];
+    buildSidebarNodes: (lang: string, navSection: string | undefined, currentVersion: string | undefined, emptyWhenUnsectioned?: boolean | undefined) => import("../sidebar/types.js").SidebarNavNode[];
+    buildSidebarContext: (lang: string, navSection: string | undefined, currentVersion: string | undefined, emptyWhenUnsectioned?: boolean) => {
+        nodes: import("../sidebar/types.js").SidebarNavNode[];
+        navigation: {
+            id: string;
+            roots: import("../sidebar/types.js").SidebarNavNode[];
+            initialExpansion?: Record<string, "collapsed" | "expanded">;
+            parents: Record<string, string | null>;
+            localParentId?: string;
+        };
+    } | {
+        nodes: never[];
+        navigation: undefined;
+    };
     getThemeDefaultMode: () => "light" | "dark" | undefined;
 };
 /** Derive the header SearchWidget: `ctx.hostBindings.SearchWidget` when the host
@@ -105,29 +119,6 @@ export declare function deriveSearchWidgetSlot(ctx: ChromeContext): (props: {
  * and no click queue — a dead button. The two gates must stay in lockstep.
  */
 export declare function skipsPackageDefaultDesignTokenPanel(settings: Settings): boolean;
-/**
- * Derive the body-end islands. The package owns the settings-gated
- * DesignTokenPanelBootstrap + ThemePackSwitcher mounts even when a host
- * supplies a BodyEndIslands override; the override is composed with those
- * package islands rather than replacing them. Without an override,
- * `createBodyEndIslands` already contains the same package islands, so the
- * two paths are deliberately exclusive.
- *
- * The components default to the statically imported package islands
- * (#2658 gate-2 fix; #2821), preserving route → chrome → derive → component
- * scanner reachability for bare `createChrome(routeCtx)` callers. A host may
- * still replace the DTP component through
- * `hostBindings.DesignTokenPanelBootstrap`, but the package remains the sole
- * owner of the mounts and settings gates.
- *
- * Since #3396 the injected package routes use that same slot: `routes/_chrome.tsx`
- * supplies `ConfiguredDesignTokenPanelBootstrap`, which is identical to the
- * default except that its builder comes from
- * `virtual:zudo-doc-design-token-panel-config` (i.e. a host's
- * `designTokenPanelConfigModule`). The default below is what every non-routes
- * `createChrome` caller keeps getting — EXCEPT under the one condition
- * {@link skipsPackageDefaultDesignTokenPanel} describes.
- */
 export declare function deriveBodyEndIslands(ctx: ChromeContext): (props: import("../doc-body-end-islands/index.js").BodyEndIslandsProps) => JSX.Element;
 /** Derive the DocHistory island: `ctx.hostBindings.DocHistory` when supplied,
  *  else the package no-op stub. */