@takazudo/zudo-doc 5.28.2 → 6.0.1

package/dist/chrome-bindings.d.ts

@@ -1,4 +1,4 @@
-import type { ComponentChildren } from "preact";
+import type { Child, Component } from "@takazudo/zfb/zudo-react";
 import type { BreadcrumbItem } from "./breadcrumb/index.js";
 import type { DocPageNavNode } from "./doc-page-shell/index.js";
 import type { HeadingItem } from "./toc/index.js";
@@ -34,12 +34,14 @@ export interface BodyEndIslandsSlotProps {
     forceImageEnlarge?: boolean;
 }
 /**
- * Props the chrome passes to the `DocHistory` island slot — matches
+ * Props the chrome passes to the `DocHistory` server boundary slot — matches
  * `DocHistoryProps` (`doc-history/index.tsx`) / `DocHistoryComponent`
  * (`doc-history-area`), rendered as
  * `<DocHistory slug=… locale=… basePath=… displayLocale=… dateFormats=… />`.
  */
 export interface DocHistorySlotProps {
+    /** Server-only fallback consumed by the boundary, never serialized as client props. */
+    ssrFallback?: Child;
     slug: string;
     locale?: string;
     basePath?: string;
@@ -50,8 +52,11 @@ export interface DocHistorySlotProps {
 }
 /**
  * Props the chrome passes to the `DesignTokenPanelBootstrap` slot — NONE. It is
- * rendered as `<DesignTokenPanelBootstrap />` (zero props) inside
- * `createBodyEndIslands`. An empty object type (no index signature) so a
+ * a server boundary rendered with zero props behind the package settings gate.
+ * Return a Fragment containing an Island with a statically imported client
+ * target; do not pass the raw client component. The package owns the toggle
+ * shim but does not add an Island around this boundary.
+ * An empty object type (no index signature) so a
  * zero-prop or all-optional-prop component is accepted while a component that
  * REQUIRES any prop is drift.
  */
@@ -120,7 +125,7 @@ export interface TocSlotProps {
  */
 export interface BreadcrumbSlotProps {
     items: BreadcrumbItem[];
-    rightSlot?: ComponentChildren;
+    rightSlot?: Child;
 }
 /** Props supplied to the doc-route `DocPager` replacement. */
 export interface DocPagerSlotProps {
@@ -134,30 +139,30 @@ export interface DocPagerSlotProps {
  */
 export interface ChromeBindingsInput {
     /** Primary header replacement — see {@link HeaderSlotProps}. */
-    Header?: (props: HeaderSlotProps) => unknown;
+    Header?: Component<HeaderSlotProps>;
     /** Primary footer replacement — see {@link FooterSlotProps}. */
-    Footer?: (props: FooterSlotProps) => unknown;
+    Footer?: Component<FooterSlotProps>;
     /** Primary doc-sidebar replacement — see {@link SidebarSlotProps}. */
-    Sidebar?: (props: SidebarSlotProps) => unknown;
+    Sidebar?: Component<SidebarSlotProps>;
     /** Primary desktop TOC replacement — see {@link TocSlotProps}. */
-    Toc?: (props: TocSlotProps) => unknown;
+    Toc?: Component<TocSlotProps>;
     /** Primary breadcrumb replacement — see {@link BreadcrumbSlotProps}. */
-    Breadcrumb?: (props: BreadcrumbSlotProps) => unknown;
+    Breadcrumb?: Component<BreadcrumbSlotProps>;
     /** Primary previous/next pager replacement — see {@link DocPagerSlotProps}. */
-    DocPager?: (props: DocPagerSlotProps) => unknown;
+    DocPager?: Component<DocPagerSlotProps>;
     /** Header search widget — see {@link SearchWidgetSlotProps}. */
-    SearchWidget?: (props: SearchWidgetSlotProps) => unknown;
+    SearchWidget?: Component<SearchWidgetSlotProps>;
     /**
      * Named header-right renderers. Values are callable-only and receive the
      * exact `HeaderRightComponentProps` used by the header renderer.
      */
     headerRightComponents?: HeaderRightComponentRegistry;
     /** Body-end bootstrap islands — see {@link BodyEndIslandsSlotProps}. */
-    BodyEndIslands?: (props: BodyEndIslandsSlotProps) => unknown;
-    /** DocHistory island — see {@link DocHistorySlotProps}. */
-    DocHistory?: (props: DocHistorySlotProps) => unknown;
-    /** Design-token-panel bootstrap island — see {@link DesignTokenPanelBootstrapSlotProps}. */
-    DesignTokenPanelBootstrap?: (props: DesignTokenPanelBootstrapSlotProps) => unknown;
+    BodyEndIslands?: Component<BodyEndIslandsSlotProps>;
+    /** Fixed-target DocHistory server boundary — see {@link DocHistorySlotProps}. */
+    DocHistory?: Component<DocHistorySlotProps>;
+    /** Server boundary for the design-token-panel bootstrap — see {@link DesignTokenPanelBootstrapSlotProps}. */
+    DesignTokenPanelBootstrap?: Component<DesignTokenPanelBootstrapSlotProps>;
     /**
      * Per-page git-history meta manifest (data slot). Read as
      * `Record<string, DocHistoryMetaEntry>` inside `doc-metainfo-area` /
@@ -181,13 +186,16 @@ export interface ChromeBindingsInput {
      * (parameter contravariance). Unlike `mdxExtras`, this slot has a fixed call
      * site, so it carries the real contract rather than a loose `Record`.
      */
-    frontmatterRenderers?: Record<string, (props: FrontmatterRendererSlotProps) => unknown>;
+    frontmatterRenderers?: Record<string, Component<FrontmatterRendererSlotProps>>;
     /**
-     * MDX content-component overrides (renderer record). Same loose value type as
-     * `frontmatterRenderers`; the showcase's `MdxStub = (_props: unknown) => null`
-     * is accepted deliberately (`unknown` props are a safe supertype).
+     * MDX content-component overrides (heterogeneous component registry). There
+     * is no package call-side contract: each component's props are authored at
+     * its MDX call site, so any parameter shape is accepted — including required
+     * typed props such as `(props: { html: string }) => Child` (#4530) and the
+     * showcase's `MdxStub = (_props: unknown) => null`. `Component<never>` still
+     * requires every entry to be a component returning a `Child`.
      */
-    mdxExtras?: Record<string, unknown>;
+    mdxExtras?: Record<string, Component<never>>;
     /**
      * Frontmatter preview entry builder. `doc-content-header` calls it with the
      * page `data` (`Record<string, unknown>`) and spreads the result into

package/dist/code-group/index.d.ts

@@ -1,10 +1,9 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-import type { ComponentChildren } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
 type Props = {
     tabs?: string[];
-    children?: ComponentChildren;
+    children?: Child;
     [key: string]: unknown;
 };
-export declare function CodeGroup({ tabs, children, name }: Props): import("preact").JSX.Element;
+export declare function CodeGroup({ tabs, children, name }: Props): import("@takazudo/zfb").Description;
 export {};

package/dist/code-group/index.js

@@ -1,13 +1,9 @@
-import { Fragment, jsx } from "preact/jsx-runtime";
+import { Fragment, jsx } from "@takazudo/zfb/zudo-react/jsx-runtime";
+import { flattenChildren } from "@takazudo/zfb/zudo-react";
 import { Tabs } from "../code-syntax/index.js";
 import { TabItem } from "../tab-item/index.js";
-function toArray(children) {
-  if (!children) return [];
-  if (Array.isArray(children)) return children;
-  return [children];
-}
 function CodeGroup({ tabs = [], children, name }) {
-  const childArray = toArray(children);
+  const childArray = flattenChildren(children);
   const items = tabs.map((label, i) => {
     const child = childArray[i];
     return { label, child };

package/dist/code-syntax/code-block-enhancer.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";
 /**
  * Drop-in JSX replacement for the legacy `code-block-enhancer` component.
  *

package/dist/code-syntax/code-block-enhancer.js

@@ -1,9 +1,9 @@
-import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+import { Fragment, jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import { CODE_BLOCK_ENHANCER_SCRIPT } from "./code-block-enhancer-script.js";
 function CodeBlockEnhancer() {
   return /* @__PURE__ */ jsxs(Fragment, { children: [
     /* @__PURE__ */ jsx("div", { class: "code-block-sr-announce", "aria-live": "polite" }),
-    /* @__PURE__ */ jsx("script", { dangerouslySetInnerHTML: { __html: CODE_BLOCK_ENHANCER_SCRIPT } })
+    /* @__PURE__ */ jsx("script", { rawHtml: CODE_BLOCK_ENHANCER_SCRIPT })
   ] });
 }
 export {

package/dist/code-syntax/mermaid-init.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";
 /**
  * Props for `<MermaidInit/>`.
  *

package/dist/code-syntax/mermaid-init.js

@@ -1,4 +1,4 @@
-import { jsx } from "preact/jsx-runtime";
+import { jsx } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import {
   MERMAID_CDN_MODULE_URL,
   buildMermaidInitScript
@@ -6,7 +6,10 @@ import {
 const MERMAID_INIT_SCRIPT = buildMermaidInitScript(MERMAID_CDN_MODULE_URL);
 function MermaidInit(props = {}) {
   const script = props.script ?? (props.cdnUrl ? buildMermaidInitScript(props.cdnUrl) : MERMAID_INIT_SCRIPT);
-  return /* @__PURE__ */ jsx("script", { dangerouslySetInnerHTML: { __html: script } });
+  if (/<\/script\b/i.test(script)) {
+    throw new Error("MermaidInit script must not contain a closing script tag");
+  }
+  return /* @__PURE__ */ jsx("script", { rawHtml: script });
 }
 export {
   MermaidInit

package/dist/code-syntax/tabs-init-script.js

@@ -1,6 +1,6 @@
 import { AFTER_NAVIGATE_EVENT } from "../transitions/page-events.js";
 const TABS_INIT_SCRIPT = `(function () {
-  var BASE_BTN = "px-hsp-lg py-vsp-xs text-small font-medium border-b-[5px] -mb-px transition-colors";
+  var BASE_BTN = "px-hsp-lg py-vsp-xs text-small font-medium border-b-[5px] -mb-px transition-colors duration-0";
   var ACTIVE_BTN = BASE_BTN + " text-accent border-accent";
   var INACTIVE_BTN = BASE_BTN + " text-muted border-transparent hover:text-fg";
 

package/dist/code-syntax/tabs-init.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";
 /**
  * Drop-in JSX replacement for the legacy `tabs-init` component.
  *

package/dist/code-syntax/tabs-init.js

@@ -1,7 +1,7 @@
-import { jsx } from "preact/jsx-runtime";
+import { jsx } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import { TABS_INIT_SCRIPT } from "./tabs-init-script.js";
 function TabsInit() {
-  return /* @__PURE__ */ jsx("script", { dangerouslySetInnerHTML: { __html: TABS_INIT_SCRIPT } });
+  return /* @__PURE__ */ jsx("script", { rawHtml: TABS_INIT_SCRIPT });
 }
 export {
   TabsInit

package/dist/code-syntax/tabs.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";
 export interface TabsProps {
     /**
      * When set, clicking a tab in this group persists the chosen value to
@@ -9,15 +9,15 @@ export interface TabsProps {
      */
     groupId?: string;
     /** `<TabItem>` children (and any other content). */
-    children?: ComponentChildren;
+    children?: Child;
 }
 /**
  * Server-rendered tab container — JSX port of the legacy `tabs` component.
  *
- * Iterates `children` via `toChildArray` to discover `<TabItem>` elements
+ * Iterates `children` via `flattenChildren` to discover `<TabItem>` elements
  * and renders their labels as `<button>` elements in the tab nav bar.
- * All panels remain `hidden` on first paint; `<TabsInit>` (the companion
- * script component) activates the default/stored tab after hydration.
+ * The default panel is visible on first paint; `<TabsInit>` (the companion
+ * script component) activates a stored tab after hydration.
  *
  * Place `<TabsInit>` once in the layout — NOT inside each `<Tabs>`.
  *

package/dist/code-syntax/tabs.js

@@ -1,11 +1,11 @@
-import { jsx, jsxs } from "preact/jsx-runtime";
-import { cloneElement, toChildArray } from "preact";
+import { jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
+import { h, flattenChildren } from "@takazudo/zfb/zudo-react";
 import { TabItem } from "../tab-item/tab-item.js";
-const BASE_BTN_CLASS = "px-hsp-lg py-vsp-xs text-small font-medium border-b-[5px] -mb-px transition-colors";
+const BASE_BTN_CLASS = "px-hsp-lg py-vsp-xs text-small font-medium border-b-[5px] -mb-px transition-colors duration-0";
 const ACTIVE_BTN_CLASS = `${BASE_BTN_CLASS} text-accent border-accent`;
 const INACTIVE_BTN_CLASS = `${BASE_BTN_CLASS} text-muted border-transparent hover:text-fg`;
 function Tabs({ groupId, children }) {
-  const childArray = toChildArray(children);
+  const childArray = flattenChildren(children);
   const tabItemNodes = childArray.filter(
     (child) => typeof child === "object" && child !== null && child.type === TabItem
   );
@@ -23,18 +23,18 @@ function Tabs({ groupId, children }) {
       const props = node.props;
       const value = props.value ?? props.label;
       const isDefault = value === defaultValue;
-      return cloneElement(node, { default: isDefault });
+      return h(node.type, { ...node.props, default: isDefault, key: node.key });
     }
     return child;
   });
   return /* @__PURE__ */ jsxs(
     "div",
     {
-      class: "tabs-container my-vsp-md",
+      class: "my-vsp-md",
       "data-tabs": true,
       "data-group-id": groupId,
       children: [
-        /* @__PURE__ */ jsx("div", { class: "tabs-nav flex border-b border-muted", role: "tablist", children: tabItems.map((item) => {
+        /* @__PURE__ */ jsx("div", { class: "flex border-b border-muted", role: "tablist", "data-tabs-nav": true, children: tabItems.map((item) => {
           const value = item.props.value ?? item.props.label;
           const isActive = value === defaultValue;
           return /* @__PURE__ */ jsx(
@@ -50,7 +50,7 @@ function Tabs({ groupId, children }) {
             value
           );
         }) }),
-        /* @__PURE__ */ jsx("div", { class: "tabs-content", children: renderedChildren })
+        /* @__PURE__ */ jsx("div", { "data-tabs-content": true, children: renderedChildren })
       ]
     }
   );