@takazudo/zudo-doc 5.28.2 → 6.0.0

package/dist/head/doc-head.js

@@ -1,4 +1,5 @@
-import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+import { Fragment, jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
+import { h } from "@takazudo/zfb/zudo-react";
 import { OgTags } from "./og-tags.js";
 import { TwitterCard } from "./twitter-card.js";
 function DocHead(props) {
@@ -52,37 +53,28 @@ function DocHead(props) {
         image: twitterImage
       }
     ),
-    stylesheets?.map((s) => /* @__PURE__ */ jsx(
-      "link",
-      {
-        rel: "stylesheet",
-        href: s.href,
-        ...s.integrity !== void 0 ? { integrity: s.integrity } : {},
-        ...s.crossorigin !== void 0 ? { crossorigin: s.crossorigin } : {}
-      },
-      `stylesheet:${s.href}`
-    )),
-    alternateLinks?.map((l) => /* @__PURE__ */ jsx(
-      "link",
-      {
-        rel: l.rel,
-        ...l.type !== void 0 ? { type: l.type } : {},
-        href: l.href,
-        ...l.title !== void 0 ? { title: l.title } : {}
-      },
-      `${l.rel}:${l.type ?? ""}:${l.href}`
-    )),
-    preload?.map((p) => /* @__PURE__ */ jsx(
-      "link",
-      {
-        rel: "preload",
-        as: p.as,
-        href: p.href,
-        ...p.type !== void 0 ? { type: p.type } : {},
-        ...p.crossorigin !== void 0 ? { crossorigin: p.crossorigin } : {}
-      },
-      `preload:${p.as}:${p.href}`
-    ))
+    stylesheets?.map((s) => h("link", {
+      key: `stylesheet:${s.href}`,
+      rel: "stylesheet",
+      href: s.href,
+      ...s.integrity !== void 0 ? { integrity: s.integrity } : {},
+      ...s.crossorigin !== void 0 ? { crossorigin: s.crossorigin } : {}
+    })),
+    alternateLinks?.map((l) => h("link", {
+      key: `${l.rel}:${l.type ?? ""}:${l.href}`,
+      rel: l.rel,
+      ...l.type !== void 0 ? { type: l.type } : {},
+      href: l.href,
+      ...l.title !== void 0 ? { title: l.title } : {}
+    })),
+    preload?.map((p) => h("link", {
+      key: `preload:${p.as}:${p.href}`,
+      rel: "preload",
+      as: p.as,
+      href: p.href,
+      ...p.type !== void 0 ? { type: p.type } : {},
+      ...p.crossorigin !== void 0 ? { crossorigin: p.crossorigin } : {}
+    }))
   ] });
 }
 export {

package/dist/head/og-tags.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";
 /**
  * Open Graph meta tags. Emits og:title (always — defaults to `title`) plus

package/dist/head/og-tags.js

@@ -1,14 +1,15 @@
-import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+import { Fragment, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
+import { h } from "@takazudo/zfb/zudo-react";
 function OgTags(props) {
   const ogTitle = props.ogTitle ?? props.title;
   const ogDescription = props.ogDescription ?? props.description;
   return /* @__PURE__ */ jsxs(Fragment, { children: [
-    /* @__PURE__ */ jsx("meta", { property: "og:title", content: ogTitle }),
-    ogDescription !== void 0 && /* @__PURE__ */ jsx("meta", { property: "og:description", content: ogDescription }),
-    props.ogType !== void 0 && /* @__PURE__ */ jsx("meta", { property: "og:type", content: props.ogType }),
-    props.ogUrl !== void 0 && /* @__PURE__ */ jsx("meta", { property: "og:url", content: props.ogUrl }),
-    props.ogImage !== void 0 && /* @__PURE__ */ jsx("meta", { property: "og:image", content: props.ogImage }),
-    props.ogSiteName !== void 0 && /* @__PURE__ */ jsx("meta", { property: "og:site_name", content: props.ogSiteName })
+    h("meta", { property: "og:title", content: ogTitle }),
+    ogDescription !== void 0 && h("meta", { property: "og:description", content: ogDescription }),
+    props.ogType !== void 0 && h("meta", { property: "og:type", content: props.ogType }),
+    props.ogUrl !== void 0 && h("meta", { property: "og:url", content: props.ogUrl }),
+    props.ogImage !== void 0 && h("meta", { property: "og:image", content: props.ogImage }),
+    props.ogSiteName !== void 0 && h("meta", { property: "og:site_name", content: props.ogSiteName })
   ] });
 }
 export {

package/dist/head/twitter-card.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";
 /**
  * Twitter card meta tags. The host renders this only when a card type is

package/dist/head/twitter-card.js

@@ -1,4 +1,4 @@
-import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+import { Fragment, jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
 function TwitterCard(props) {
   return /* @__PURE__ */ jsxs(Fragment, { children: [
     /* @__PURE__ */ jsx("meta", { name: "twitter:card", content: props.card }),

package/dist/head-with-defaults/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 { HeadProps } from "../head/types.js";
 import type { ColorSchemeProviderColorMode } from "../theme/color-scheme-provider.js";
 import type { ChromeContext } from "../factory-context/index.js";
@@ -15,6 +14,8 @@ export interface HeadWithDefaultsProps {
      * `<link rel="canonical" href="...">`.
      */
     canonical?: string;
+    /** Page-specific alternate links, such as an exported Markdown version. */
+    alternateLinks?: HeadProps["alternateLinks"];
 }
 /** Settings subset read by {@link createHeadWithDefaults}. Retained for the
  *  `HeadProps`/`ColorSchemeProviderColorMode` type references it documents. */
@@ -29,6 +30,10 @@ export interface HeadWithDefaultsSettings {
         twitterCreator?: string;
     };
     siteName: string;
+    /** Emit agent-discovery links only when the opt-in static export is enabled. */
+    agentExport?: boolean;
+    /** Existing llms.txt output setting; retained independently from agent export. */
+    llmsTxt?: boolean;
     colorMode?: ColorSchemeProviderColorMode | null | false;
     sidebarResizer?: boolean;
     /** Configured theme-pack slug (ADR `docs/adr/theme-packs.md`, #2822). */

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

@@ -1,4 +1,5 @@
-import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+import { Fragment, jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
+import { h } from "@takazudo/zfb/zudo-react";
 import { OgTags, TwitterCard } from "../head/index.js";
 import { SIDEBAR_RESIZER_RESTORE_SCRIPT } from "../sidebar-resizer/index.js";
 import ColorSchemeProvider from "../theme/color-scheme-provider.js";
@@ -9,6 +10,13 @@ import { DEFAULT_THEME_PACK_SLUG } from "../theme-pack-switcher/theme-pack-sync.
 import { renderAutoLogoIconSvg } from "../auto-logo/icon.js";
 import { deriveComposeMetaTitle, deriveColorSchemeGenerators } from "../chrome/derive.js";
 import { assertChromeContext } from "../chrome/assert-chrome-context.js";
+function mediaSwapHandler(media) {
+  const handler = `this.media='${media ?? "all"}'`;
+  if (!/^this\.media='[a-z\d\s(),:.%+\-/*<>=]*'$/i.test(handler)) {
+    throw new TypeError("Async stylesheet media cannot form a safe onload handler");
+  }
+  return handler;
+}
 const FAVICON_AUTO = "auto";
 const DEFAULT_FAVICON = {
   svg: "/favicon.svg",
@@ -97,7 +105,8 @@ function createHeadWithDefaults(ctx) {
   function HeadWithDefaults({
     title,
     description,
-    canonical
+    canonical,
+    alternateLinks
   }) {
     const { metaTags } = settings;
     const ogImageUrl = metaTags.ogImage != null && metaTags.ogImage !== false ? absoluteUrl(withBase(metaTags.ogImage)) : void 0;
@@ -117,9 +126,9 @@ function createHeadWithDefaults(ctx) {
       ),
       metaTags.keywords !== false && metaTags.keywords && metaTags.keywords.length > 0 && /* @__PURE__ */ jsx("meta", { name: "keywords", content: metaTags.keywords }),
       ogImageUrl !== void 0 && /* @__PURE__ */ jsxs(Fragment, { children: [
-        /* @__PURE__ */ jsx("meta", { property: "og:image:width", content: "1200" }),
-        /* @__PURE__ */ jsx("meta", { property: "og:image:height", content: "630" }),
-        /* @__PURE__ */ jsx("meta", { property: "og:image:alt", content: composeMetaTitle(title) })
+        h("meta", { property: "og:image:width", content: "1200" }),
+        h("meta", { property: "og:image:height", content: "630" }),
+        h("meta", { property: "og:image:alt", content: composeMetaTitle(title) })
       ] }),
       metaTags.twitterCard !== false && metaTags.twitterCard !== void 0 && /* @__PURE__ */ jsx(
         TwitterCard,
@@ -139,9 +148,20 @@ function createHeadWithDefaults(ctx) {
           base: themePackBase
         }
       ),
-      settings.sidebarResizer && /* @__PURE__ */ jsx("script", { dangerouslySetInnerHTML: { __html: SIDEBAR_RESIZER_RESTORE_SCRIPT } }),
+      settings.sidebarResizer && /* @__PURE__ */ jsx("script", { rawHtml: SIDEBAR_RESIZER_RESTORE_SCRIPT }),
       faviconLinks.map((attrs, i) => /* @__PURE__ */ jsx("link", { ...attrs }, i)),
       canonical !== void 0 && /* @__PURE__ */ jsx("link", { rel: "canonical", href: canonical }),
+      alternateLinks?.map((alternate, i) => /* @__PURE__ */ jsx(
+        "link",
+        {
+          rel: alternate.rel,
+          href: alternate.href,
+          ...alternate.type ? { type: alternate.type } : {},
+          ...alternate.title ? { title: alternate.title } : {}
+        },
+        `page-alternate:${i}`
+      )),
+      settings.agentExport && settings.llmsTxt && /* @__PURE__ */ jsx("link", { rel: "alternate", href: withBase("/llms.txt"), type: "text/plain" }),
       ctx.settings.head && /* @__PURE__ */ jsxs(Fragment, { children: [
         ctx.settings.head.preconnect?.map((p, i) => /* @__PURE__ */ jsx(
           "link",
@@ -152,28 +172,23 @@ function createHeadWithDefaults(ctx) {
           },
           i
         )),
-        ctx.settings.head.preload?.map((p, i) => /* @__PURE__ */ jsx(
-          "link",
-          {
+        ctx.settings.head.preload?.map(
+          (p, i) => h("link", {
+            key: i,
             rel: "preload",
             as: p.as,
             href: p.href,
             ...p.type ? { type: p.type } : {},
             ...p.crossorigin ? { crossorigin: p.crossorigin } : {}
-          },
-          i
-        )),
+          })
+        ),
         ctx.settings.head.stylesheets?.map(
           (s, i) => s.async ? (
             // Non-render-blocking async stylesheet:
             //   <link rel="stylesheet" href media="print" onload="this.media='all'">
             //   <noscript><link rel="stylesheet" href></noscript>
             //
-            // SSR note: preact-render-to-string emits string-valued on* props as
-            // literal HTML attributes (only function-valued event handlers are
-            // stripped). We use `as any` to bypass Preact's JSX types, which
-            // expect a function for onload. The new unit test pins the exact
-            // emitted string to guard this contract.
+            // Preserve the bounded media swap before native JSX rendering.
             /* @__PURE__ */ jsxs(Fragment, { children: [
               /* @__PURE__ */ jsx(
                 "link",
@@ -182,19 +197,19 @@ function createHeadWithDefaults(ctx) {
                   href: s.href,
                   ...s.crossorigin ? { crossorigin: s.crossorigin } : {},
                   media: "print",
-                  ...{ onload: `this.media='${s.media ?? "all"}'` }
+                  onload: mediaSwapHandler(s.media)
                 },
                 `${i}-link`
               ),
-              /* @__PURE__ */ jsx(
-                "noscript",
+              /* @__PURE__ */ jsx("noscript", { children: /* @__PURE__ */ jsx(
+                "link",
                 {
-                  dangerouslySetInnerHTML: {
-                    __html: `<link rel="stylesheet" href="${s.href.replace(/"/g, "&quot;")}"${s.media ? ` media="${s.media}"` : ""}${s.crossorigin ? ` crossorigin="${s.crossorigin}"` : ""}>`
-                  }
-                },
-                `${i}-noscript`
-              )
+                  rel: "stylesheet",
+                  href: s.href,
+                  ...s.media ? { media: s.media } : {},
+                  ...s.crossorigin ? { crossorigin: s.crossorigin } : {}
+                }
+              ) }, `${i}-noscript`)
             ] })
           ) : /* @__PURE__ */ jsx(
             "link",
@@ -217,15 +232,14 @@ function createHeadWithDefaults(ctx) {
           },
           i
         )),
-        ctx.settings.head.meta?.map((m, i) => /* @__PURE__ */ jsx(
-          "meta",
-          {
+        ctx.settings.head.meta?.map(
+          (m, i) => h("meta", {
+            key: i,
             ...m.name ? { name: m.name } : {},
             ...m.property ? { property: m.property } : {},
             content: m.content
-          },
-          i
-        ))
+          })
+        )
       ] })
     ] });
   }

package/dist/header/header.d.ts

@@ -1,6 +1,6 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-import type { ComponentChildren, JSX } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
+import type { JSX } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import type { HeaderNavItem, HeaderRightComponentRegistry, HeaderRightItem, Locale } from "./types.js";
 /**
  * Boundary helpers the host injects into `<Header>`. These are the URL
@@ -48,7 +48,7 @@ export interface HeaderProps {
      * replaces the legacy `<slot name="sidebar" />`. Consumers pass the
      * sidebar tree they want to surface in the mobile sheet.
      */
-    sidebarSlot?: ComponentChildren;
+    sidebarSlot?: Child;
     /**
      * Replacement for the `<SidebarToggle client:media="...">` element in
      * the legacy template. Consumers wrap their preferred Preact /
@@ -57,19 +57,19 @@ export interface HeaderProps {
      * that slot — the layout is still valid (e.g. doc pages with
      * `hide_sidebar`).
      */
-    sidebarToggle?: ComponentChildren;
+    sidebarToggle?: Child;
     /**
      * Replacement for `<ThemeToggle client:load />`. Rendered only when
      * `colorModeEnabled` is `true` AND a `theme-toggle` entry survives
      * `filterHeaderRightItems` — matching the original template.
      */
-    themeToggle?: ComponentChildren;
+    themeToggle?: Child;
     /** Replacement for the `<LanguageSwitcher />` Astro child. */
-    languageSwitcher?: ComponentChildren;
+    languageSwitcher?: Child;
     /** Replacement for the `<VersionSwitcher />` Astro child. */
-    versionSwitcher?: ComponentChildren;
+    versionSwitcher?: Child;
     /** Replacement for the `<Search />` Astro child. */
-    search?: ComponentChildren;
+    search?: Child;
     /**
      * Emits `data-zfb-transition-persist={persistKey}` on the
      * `<header>` element so zfb's client-router preserves DOM-node identity

package/dist/header/header.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 {
   computeActiveNavPath,
   isNavItemActive,
@@ -163,7 +163,7 @@ function Header(props) {
             children: rightGroups
           }
         ),
-        /* @__PURE__ */ jsx("script", { dangerouslySetInnerHTML: { __html: NAV_OVERFLOW_SCRIPT } }),
+        /* @__PURE__ */ jsx("script", { rawHtml: NAV_OVERFLOW_SCRIPT }),
         hasLocales ? (
           // Keeps the persisted header's language-switcher hrefs pointing at the
           // current page's equivalent in each other locale across same-locale SPA
@@ -172,7 +172,7 @@ function Header(props) {
           /* @__PURE__ */ jsx(
             "script",
             {
-              dangerouslySetInnerHTML: { __html: LANGUAGE_SWITCHER_INIT_SCRIPT }
+              rawHtml: LANGUAGE_SWITCHER_INIT_SCRIPT
             }
           )
         ) : null,
@@ -184,7 +184,7 @@ function Header(props) {
           /* @__PURE__ */ jsx(
             "script",
             {
-              dangerouslySetInnerHTML: { __html: VERSION_SWITCHER_REWIRE_SCRIPT }
+              rawHtml: VERSION_SWITCHER_REWIRE_SCRIPT
             }
           )
         ) : null
@@ -219,7 +219,7 @@ function renderNavItem(item, activeNavPath, activeCategory, lang, currentVersion
               "aria-haspopup": "true",
               "aria-expanded": "false",
               class: [
-                "flex items-center gap-x-hsp-xs px-hsp-md py-vsp-2xs text-small font-medium transition-colors",
+                "flex items-center gap-x-hsp-xs px-hsp-md py-vsp-2xs text-small font-medium transition-colors duration-0",
                 isActive ? NAV_TOP_ACTIVE.join(" ") : NAV_TOP_INACTIVE.join(" ")
               ].join(" "),
               children: [
@@ -279,7 +279,7 @@ function renderNavItem(item, activeNavPath, activeCategory, lang, currentVersion
       "data-nav-category": item.categoryMatch,
       "data-nav-item": true,
       class: [
-        "px-hsp-md py-vsp-2xs text-small font-medium transition-colors shrink-0",
+        "px-hsp-md py-vsp-2xs text-small font-medium transition-colors duration-0 shrink-0",
         isActive ? NAV_TOP_ACTIVE.join(" ") : NAV_TOP_INACTIVE.join(" ")
       ].join(" "),
       children: label
@@ -314,7 +314,7 @@ function TriggerButton({
     {
       id,
       type: "button",
-      class: "flex h-[40px] w-[40px] shrink-0 items-center justify-center text-muted transition-colors hover:text-fg focus-visible:outline-2 focus-visible:outline-accent focus-visible:outline-offset-2",
+      class: "flex h-[40px] w-[40px] shrink-0 items-center justify-center text-muted transition-colors duration-0 hover:text-fg focus-visible:outline-2 focus-visible:outline-accent focus-visible:outline-offset-2",
       "aria-label": ariaLabel,
       ...inlineOnclick,
       children
@@ -347,7 +347,6 @@ const BASE_RIGHT_ITEM_DISPATCH = {
       children: /* @__PURE__ */ jsxs(
         "svg",
         {
-          xmlns: "http://www.w3.org/2000/svg",
           width: "20",
           height: "20",
           viewBox: "0 0 24 24",
@@ -378,7 +377,6 @@ const BASE_RIGHT_ITEM_DISPATCH = {
       children: /* @__PURE__ */ jsxs(
         "svg",
         {
-          xmlns: "http://www.w3.org/2000/svg",
           width: "20",
           height: "20",
           viewBox: "0 0 24 24",
@@ -401,7 +399,7 @@ const BASE_RIGHT_ITEM_DISPATCH = {
         href: ctx.githubRepoUrl,
         target: "_blank",
         rel: "noopener noreferrer",
-        class: "flex h-[40px] w-[40px] shrink-0 items-center justify-center text-muted transition-colors hover:text-fg focus-visible:outline-2 focus-visible:outline-accent focus-visible:outline-offset-2",
+        class: "flex h-[40px] w-[40px] shrink-0 items-center justify-center text-muted transition-colors duration-0 hover:text-fg focus-visible:outline-2 focus-visible:outline-accent focus-visible:outline-offset-2",
         "aria-label": ctx.githubLabel,
         title: ctx.githubLabel,
         children: [
@@ -447,7 +445,7 @@ const BASE_RIGHT_ITEM_DISPATCH = {
     return /* @__PURE__ */ jsx(
       "span",
       {
-        dangerouslySetInnerHTML: { __html: item.html }
+        rawHtml: item.html
       },
       `right-${index}`
     );

package/dist/header/types.d.ts

@@ -1,7 +1,7 @@
-import type { ComponentChildren } from "preact";
+import type { Child, Component } from "@takazudo/zfb/zudo-react";
 /**
  * Locale code as seen by the header. Widened from the host's literal
- * union (`"en" | "ja" | …`) to plain `string` at the v2 boundary so the
+ * union (`"en" | "ja" | …`) to plain `string` at the package boundary so the
  * package can render for any project's locale set without a generic
  * parameter (super-epic #1724, sub-issue #1729).
  */
@@ -47,15 +47,15 @@ export interface HeaderRightComponentProps {
     lang: Locale | undefined;
     githubRepoUrl: string | null;
     githubLabel: string;
-    themeToggle: ComponentChildren;
-    languageSwitcher: ComponentChildren;
-    versionSwitcher: ComponentChildren;
-    search: ComponentChildren;
+    themeToggle: Child;
+    languageSwitcher: Child;
+    versionSwitcher: Child;
+    search: Child;
     colorModeEnabled: boolean;
     hasLocales: boolean;
 }
 /** A callable-only host registry keyed by serialized component name. */
-export type HeaderRightComponentRegistry = Record<string, (props: HeaderRightComponentProps) => ComponentChildren>;
+export type HeaderRightComponentRegistry = Record<string, Component<HeaderRightComponentProps>>;
 export interface HeaderRightTriggerItem {
     type: "trigger";
     trigger: HeaderRightTriggerName;

package/dist/header-with-defaults/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";
 import type { SidebarNavNode } from "../sidebar/types.js";

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

@@ -1,4 +1,4 @@
-import { jsx } from "preact/jsx-runtime";
+import { jsx } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import { Island } from "@takazudo/zfb";
 import { Header, filterHeaderRightItems } from "../header/index.js";
 import {
@@ -29,7 +29,7 @@ function createHeaderWithDefaults(ctx) {
   const docsUrl = ctx.docsUrl;
   const navHref = ctx.navHref;
   const versionedDocsUrl = ctx.versionedDocsUrl;
-  const { buildRootMenuItems, buildLocaleLinksForNav, buildSidebarNodes, getThemeDefaultMode } = deriveNavDataPrep(ctx);
+  const { buildRootMenuItems, buildLocaleLinksForNav, buildSidebarNodes, buildSidebarContext, getThemeDefaultMode } = deriveNavDataPrep(ctx);
   const buildGitHubRepoUrl = () => buildGitHubRepoUrlBase(ctx.settings.githubUrl);
   const SearchWidget = deriveSearchWidgetSlot(ctx);
   const getUnavailableVersions = deriveGetUnavailableVersions(ctx);
@@ -50,7 +50,8 @@ function createHeaderWithDefaults(ctx) {
     const themeDefaultMode = getThemeDefaultMode();
     const themeRespectSystem = (ctx.settings.colorMode && ctx.settings.colorMode.respectPrefersColorScheme) ?? true;
     const buildDefaultSidebarNodes = () => buildSidebarNodes(lang, navSection, currentVersion);
-    const sidebarNodes = sidebarNodesProp === void 0 ? buildDefaultSidebarNodes() : typeof sidebarNodesProp === "function" ? sidebarNodesProp({
+    const defaultSidebar = sidebarNodesProp === void 0 ? buildSidebarContext(lang, navSection, currentVersion) : void 0;
+    const sidebarNodes = sidebarNodesProp === void 0 ? defaultSidebar.nodes : typeof sidebarNodesProp === "function" ? sidebarNodesProp({
       lang,
       navSection,
       currentVersion,
@@ -62,12 +63,13 @@ function createHeaderWithDefaults(ctx) {
         SidebarToggle,
         {
           nodes: sidebarNodes,
-          currentSlug,
+          ...defaultSidebar?.navigation ? { navigation: defaultSidebar.navigation } : {},
+          ...currentSlug !== void 0 ? { currentSlug } : {},
           rootMenuItems,
-          backToMenuLabel,
+          ...backToMenuLabel !== void 0 ? { backToMenuLabel } : {},
           locale: lang,
-          localeLinks,
-          themeDefaultMode,
+          ...localeLinks !== void 0 ? { localeLinks } : {},
+          ...themeDefaultMode !== void 0 ? { themeDefaultMode } : {},
           themeLabels: themeToggleLabels(t, lang),
           themeRespectSystem,
           dateFormats: dateFormatsFor(lang)
@@ -76,7 +78,15 @@ function createHeaderWithDefaults(ctx) {
     });
     const themeToggle = Island({
       when: "load",
-      children: /* @__PURE__ */ jsx(ThemeToggle, { defaultMode: themeDefaultMode, labels: themeToggleLabels(t, lang), respectPrefersColorScheme: themeRespectSystem, pendingUntilHydrated: true })
+      children: /* @__PURE__ */ jsx(
+        ThemeToggle,
+        {
+          ...themeDefaultMode !== void 0 ? { defaultMode: themeDefaultMode } : {},
+          labels: themeToggleLabels(t, lang),
+          respectPrefersColorScheme: themeRespectSystem,
+          pendingUntilHydrated: true
+        }
+      )
     });
     const searchWidget = /* @__PURE__ */ jsx(
       SearchWidget,

package/dist/home-intro/index.d.ts

@@ -1,6 +1,3 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-import { h } from "preact";
 import type { PreparedHomeIntro } from "./types.js";
 export type { IntroNode, PreparedHomeIntro, PreparedHomeIntros } from "./types.js";
 export { resolveHomeIntro } from "./resolve.js";
@@ -13,7 +10,7 @@ export { resolveHomeIntro } from "./resolve.js";
  * double up against them.
  */
 export declare const HOME_SECTION_HEADING_CLASS = "zd-home-heading text-title font-bold leading-tight";
-/** Synchronous SSR view of output produced by home-intro/prepare. No raw HTML sink. */
+/** Synchronous SSR view of output produced by home-intro/prepare. Ruby uses the native zudo-react vocabulary. */
 export declare function CompactProse({ intro }: {
     intro: PreparedHomeIntro | null | undefined;
-}): h.JSX.Element | null;
+}): import("@takazudo/zfb").Description | null;

package/dist/home-intro/index.js

@@ -1,20 +1,22 @@
-import { jsx } from "preact/jsx-runtime";
-import { h } from "preact";
+import { jsx } from "@takazudo/zfb/zudo-react/jsx-runtime";
+import { h } from "@takazudo/zfb/zudo-react";
 import { defaultComponents } from "../content/index.js";
 import { makeAdmonition } from "../content-admonition/index.js";
 import { resolveHomeIntro } from "./resolve.js";
 const HOME_SECTION_HEADING_CLASS = "zd-home-heading text-title font-bold leading-tight";
 const { h2: _h2, h3: _h3, h4: _h4, ...typography } = defaultComponents;
 const components = { ...typography };
-components.h2 = ({ class: klass, className, children, ...rest }) => h(
+components.h2 = ({ class: klass, children, ...rest }) => h(
   "h2",
-  { ...rest, class: [HOME_SECTION_HEADING_CLASS, klass, className].filter(Boolean).join(" ") },
+  { ...rest, class: [HOME_SECTION_HEADING_CLASS, klass].filter(Boolean).join(" ") },
   children
 );
 for (const variant of ["note", "tip", "info", "warning", "danger", "caution", "important"]) components[variant] = makeAdmonition(variant);
+const voidTags = /* @__PURE__ */ new Set(["br", "hr", "img", "input"]);
 function renderNode(node) {
   if (typeof node === "string") return node;
-  return h(components[node.tag] ?? node.tag, node.attrs, node.children.map(renderNode));
+  const type = components[node.tag] ?? node.tag;
+  return voidTags.has(node.tag) ? h(type, node.attrs) : h(type, node.attrs, ...node.children.map(renderNode));
 }
 function CompactProse({ intro }) {
   if (!intro?.nodes.length) return null;

package/dist/home-intro/prepare.js

@@ -37,7 +37,7 @@ function inspect(node, settings, locale, source = "") {
   if ("children" in node && Array.isArray(node.children)) for (const child of node.children) inspect(child, settings, locale, source);
 }
 const allowedTags = new Set("p h1 h2 h3 h4 h5 h6 a img em strong del ul ol li blockquote pre code span br hr table thead tbody tr th td input div ruby rb rt rp note tip info warning danger caution important".split(" "));
-const plainAttrs = /* @__PURE__ */ new Set(["title", "alt", "class", "id", "start", "align", "width", "height", "data-mermaid", "data-lang"]);
+const plainAttrs = /* @__PURE__ */ new Set(["title", "alt", "class", "id", "start", "width", "height", "data-mermaid", "data-lang"]);
 function prepareNode(node, settings, locale) {
   if (node.nodeName === "#text") return node.value;
   if (!("tagName" in node)) return null;
@@ -47,8 +47,9 @@ function prepareNode(node, settings, locale) {
   for (const { name, value } of node.attrs) {
     if (name === "href" && node.tagName === "a") attrs.href = resolveIntroUrl(value, settings, locale);
     else if (name === "src" && node.tagName === "img") attrs.src = resolveIntroUrl(value, settings, locale, true);
-    else if (name === "style" && ["th", "td"].includes(node.tagName) && ["text-align: left", "text-align: center", "text-align: right"].includes(value)) attrs.style = value;
-    else if (plainAttrs.has(name)) attrs[name === "class" ? "className" : name] = value;
+    else if (name === "style" && ["th", "td"].includes(node.tagName) && /^text-align: (left|center|right);?$/u.test(value)) attrs.style = value;
+    else if (name === "align" && ["th", "td"].includes(node.tagName) && ["left", "center", "right"].includes(value)) attrs.style = `text-align: ${value}`;
+    else if (plainAttrs.has(name)) attrs[name] = value;
     else if (node.tagName === "input" && name === "type" && value === "checkbox") attrs.type = value;
     else if (node.tagName === "input" && (name === "checked" || name === "disabled")) attrs[name] = true;
     else throw new Error(`home.introMarkdown: unsupported rendered attribute ${name}`);

package/dist/home-page/index.d.ts

@@ -1,6 +1,6 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-import type { ComponentChildren, JSX } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
+import type { JSX } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import type { TagItem } from "../nav-indexing/types.js";
 import type { DocNavNode } from "../doc-page-props/index.js";
 import type { ChromeContext } from "../factory-context/index.js";
@@ -25,7 +25,7 @@ export interface HomePageViewProps {
      * from it (a renderer). Resolved as `extras ?? hostBindings.homeExtras?.({
      * locale })`.
      */
-    extras?: ComponentChildren;
+    extras?: Child;
     /**
      * Overrides the default first hero link, which is otherwise
      * `settings.headerNav[0]` + `t("nav.overview", locale)`. `path` is