@takazudo/zudo-doc 5.28.2 → 6.0.0

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

@@ -1,4 +1,4 @@
-import { jsx, jsxs } from "preact/jsx-runtime";
+import { jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
 function NodeItem({ node, depth, maxDepth, index }) {
   const visibleChildren = node.children.filter(
     (c) => c.hasPage || c.children.length > 0

package/dist/nav-indexing/doc-card-grid.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";
 /** A single resolved doc card item. */
 export interface DocCardItem {
     /** Pre-resolved href (base-prefixed, locale-aware). */
@@ -19,7 +18,7 @@ export interface DocCardGridProps {
     class?: string;
 }
 /**
- * DocCardGrid — JSX port of `src/components/doc-card-grid`.
+ * DocCardGrid — server renderer for a flat list of documentation cards.
  *
  * Renders a flat list of `{ href, title, description? }` items as a two-column
  * card grid. Each card shows an arrow icon, the doc title, and an optional

package/dist/nav-indexing/doc-card-grid.js

@@ -1,9 +1,8 @@
-import { jsx, jsxs } from "preact/jsx-runtime";
+import { jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
 function ArrowIcon() {
   return /* @__PURE__ */ jsx(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       fill: "currentColor",
       viewBox: "0 0 103.395 107.049",
       "aria-hidden": "true",

package/dist/nav-indexing/docs-sitemap.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 { NavNode } from "./types.js";
 export interface DocsSitemapProps {
     /**
@@ -10,7 +9,7 @@ export interface DocsSitemapProps {
     tree: NavNode[];
 }
 /**
- * DocsSitemap — JSX port of `src/components/docs-sitemap`.
+ * DocsSitemap — server renderer for collapsible documentation sections.
  *
  * Renders the full documentation tree as a series of collapsible
  * `<details>` sections. Each top-level node becomes one section; its

package/dist/nav-indexing/docs-sitemap.js

@@ -1,4 +1,4 @@
-import { jsx, jsxs } from "preact/jsx-runtime";
+import { jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
 function flattenTree(nodes) {
   const result = [];
   function collect(n) {
@@ -13,7 +13,7 @@ function flattenTree(nodes) {
 function SitemapSection({ node, index }) {
   const leaves = flattenTree(node.children);
   return /* @__PURE__ */ jsxs("details", { class: "group border border-muted overflow-hidden", open: true, children: [
-    /* @__PURE__ */ jsxs("summary", { class: "flex items-center gap-x-hsp-md px-hsp-xl py-vsp-md text-title font-bold cursor-pointer select-none bg-surface list-none [&::-webkit-details-marker]:hidden", children: [
+    /* @__PURE__ */ jsxs("summary", { class: "flex items-center gap-x-hsp-md px-hsp-xl py-vsp-md text-title font-bold cursor-pointer select-none bg-surface list-none zd-hide-details-marker", children: [
       /* @__PURE__ */ jsx("span", { class: "inline-block text-caption text-muted transition-transform duration-200 group-open:rotate-90", children: "\u25B6" }),
       node.href ? /* @__PURE__ */ jsx("a", { href: node.href, class: "hover:text-accent hover:underline focus:underline focus-visible:text-accent", children: node.label }) : /* @__PURE__ */ jsx("span", { children: node.label })
     ] }),

package/dist/nav-indexing/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Public entry for the nav-indexing v2 primitives.
+ * Public entry for the server-rendered navigation components.
  *
  * Consumers import from `@takazudo/zudo-doc/nav-indexing`:
  *

package/dist/nav-indexing/nav-card-grid.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 { NavNode } from "./types.js";
 export interface NavCardGridProps {
     /**
@@ -13,7 +12,7 @@ export interface NavCardGridProps {
     class?: string;
 }
 /**
- * NavCardGrid — JSX port of `src/components/nav-card-grid`.
+ * NavCardGrid — server renderer for category card links.
  *
  * Renders direct children of a category as a two-column grid of card links.
  * Unlike `CategoryNav`, the arrow icon uses `text-muted` (accent on

package/dist/nav-indexing/nav-card-grid.js

@@ -1,9 +1,8 @@
-import { jsx, jsxs } from "preact/jsx-runtime";
+import { jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
 function ArrowIcon() {
   return /* @__PURE__ */ jsx(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       fill: "currentColor",
       viewBox: "0 0 103.395 107.049",
       "aria-hidden": "true",

package/dist/nav-indexing/note-tray-index-parts/card-list.d.ts

@@ -1,5 +1,4 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-import type { JSX } from "preact";
+import type { JSX } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import type { NoteTrayIndexProps } from "../note-tray-index.js";
 export declare function CardList(props: NoteTrayIndexProps): JSX.Element;

package/dist/nav-indexing/note-tray-index-parts/card-list.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 { formatMonthDayLabel, formatYear } from "../../format-date/index.js";
 import { CategoryLinkIcon } from "../../tree-nav-shared/index.js";
 import { TagNav } from "../tag-nav.js";
@@ -14,10 +14,10 @@ function CardBody({
   return /* @__PURE__ */ jsxs("div", { class: "min-w-0", children: [
     /* @__PURE__ */ jsxs("div", { class: "flex flex-wrap items-baseline gap-x-hsp-md gap-y-vsp-3xs", children: [
       /* @__PURE__ */ jsx("h2", { class: "text-title font-medium leading-tight", children: /* @__PURE__ */ jsxs("span", { class: titleClass, children: [
-        /* @__PURE__ */ jsx("span", { class: "flex h-[1lh] items-center", children: /* @__PURE__ */ jsx(CategoryLinkIcon, { className: "w-icon-sm" }) }),
+        /* @__PURE__ */ jsx("span", { class: "flex h-[1lh] items-center", children: /* @__PURE__ */ jsx(CategoryLinkIcon, { class: "w-icon-sm" }) }),
         item.label
       ] }) }),
-      props.showDate && /* @__PURE__ */ jsx("span", { class: hasStamp ? "sm:hidden" : void 0, children: /* @__PURE__ */ jsx(
+      props.showDate && /* @__PURE__ */ jsx("span", { ...hasStamp ? { class: "sm:hidden" } : {}, children: /* @__PURE__ */ jsx(
         DateLine,
         {
           item,
@@ -111,7 +111,7 @@ function CardList(props) {
             }
           )
         ] }),
-        /* @__PURE__ */ jsx("div", { class: "col-start-1 row-start-2 relative pointer-events-none [&_a]:pointer-events-auto ml-[calc(var(--spacing-hsp-xl)+1px)] mr-[calc(var(--spacing-hsp-xl)+1px)] sm:mr-0 mb-vsp-lg", children: /* @__PURE__ */ jsx(TagNav, { variant: "page", tagLinks: item.tagLinks, labels: props.tagLabels }) })
+        /* @__PURE__ */ jsx("div", { class: "col-start-1 row-start-2 relative pointer-events-none zd-card-links-interactive ml-[calc(var(--spacing-hsp-xl)_+_1px)] mr-[calc(var(--spacing-hsp-xl)_+_1px)] sm:mr-0 mb-vsp-lg", children: /* @__PURE__ */ jsx(TagNav, { variant: "page", tagLinks: item.tagLinks, labels: props.tagLabels }) })
       ] }) : item.href ? /* @__PURE__ */ jsxs(
         "a",
         {

package/dist/nav-indexing/note-tray-index-parts/date-line.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 { ResolvedDateFormats } from "../../settings.js";
 import type { NoteTrayIndexItem } from "../note-tray-index.js";
 import type { TagNavLabels } from "../types.js";
@@ -13,4 +12,4 @@ export declare function DateLine({ item, locale, updatedLabel, dateFormats, }: {
 export declare function ItemTags({ item, labels }: {
     item: NoteTrayIndexItem;
     labels?: TagNavLabels;
-}): JSX.Element | null;
+}): import("@takazudo/zfb").Description | null;

package/dist/nav-indexing/note-tray-index-parts/date-line.js

@@ -1,4 +1,4 @@
-import { jsx, jsxs } from "preact/jsx-runtime";
+import { jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import { formatDate } from "../../note-tray-model/index.js";
 import { TagNav } from "../tag-nav.js";
 function DateLine({

package/dist/nav-indexing/note-tray-index-parts/index-list.d.ts

@@ -1,5 +1,4 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-import type { JSX } from "preact";
+import type { JSX } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import type { NoteTrayIndexProps } from "../note-tray-index.js";
 export declare function IndexList(props: NoteTrayIndexProps): JSX.Element;

package/dist/nav-indexing/note-tray-index-parts/index-list.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 { rankWidth } from "../../note-tray-model/index.js";
 import { DateLine } from "./date-line.js";
 function IndexList(props) {
   const width = rankWidth(props.items);
-  return /* @__PURE__ */ jsx("ol", { class: "[&_li]:mb-0", children: props.items.map((item) => {
+  return /* @__PURE__ */ jsx("ol", { class: "zd-list-items-no-margin", children: props.items.map((item) => {
     const rowClass = item.href ? "relative -mt-px first:mt-0 border-y border-muted hover:z-local-1 hover:border-accent focus-within:z-local-1 focus-within:border-accent" : "relative -mt-px first:mt-0 border-y border-muted";
     const rankClass = item.href ? "tabular-nums text-heading leading-none text-muted group-hover:text-fg group-focus-visible:text-fg" : "tabular-nums text-heading leading-none text-muted";
     const labelClass = item.href ? "font-medium text-fg group-hover:text-accent group-hover:underline group-focus-visible:text-accent group-focus-visible:underline" : "font-medium text-fg";

package/dist/nav-indexing/note-tray-index-parts/timeline.d.ts

@@ -1,5 +1,4 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-import type { JSX } from "preact";
+import type { JSX } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import type { NoteTrayIndexProps } from "../note-tray-index.js";
 export declare function Timeline(props: NoteTrayIndexProps): JSX.Element;

package/dist/nav-indexing/note-tray-index-parts/timeline.js

@@ -1,4 +1,4 @@
-import { jsx, jsxs } from "preact/jsx-runtime";
+import { jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import {
   formatDate,
   formatYearMonthLabel,
@@ -10,7 +10,7 @@ function Timeline(props) {
   const groups = groupItems(props.items, "month", props.order ?? "asc");
   return /* @__PURE__ */ jsx("div", { class: "space-y-vsp-lg", children: groups.map((group) => /* @__PURE__ */ jsxs("section", { children: [
     /* @__PURE__ */ jsx("h2", { class: "mb-vsp-sm text-small font-medium text-fg", children: formatYearMonthLabel(group.key, props.locale, props.dateFormats?.yearMonth) }),
-    /* @__PURE__ */ jsx("ol", { class: "ml-hsp-md border-l border-muted [&_li]:mb-0", children: group.items.map((item) => /* @__PURE__ */ jsxs("li", { class: "relative grid gap-vsp-2xs pl-hsp-xl pb-vsp-lg last:pb-0", children: [
+    /* @__PURE__ */ jsx("ol", { class: "ml-hsp-md border-l border-muted zd-list-items-no-margin", children: group.items.map((item) => /* @__PURE__ */ jsxs("li", { class: "relative grid gap-vsp-2xs pl-hsp-xl pb-vsp-lg last:pb-0", children: [
       item.href ? /* @__PURE__ */ jsx(
         "a",
         {

package/dist/nav-indexing/note-tray-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 { TagLink, TagNavLabels } from "./types.js";
 import type { NoteTrayOrder } from "../note-tray-model/index.js";
 import type { ResolvedDateFormats } from "../settings.js";

package/dist/nav-indexing/note-tray-index.js

@@ -1,4 +1,4 @@
-import { jsx } from "preact/jsx-runtime";
+import { jsx } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import { CardList } from "./note-tray-index-parts/card-list.js";
 import { IndexList } from "./note-tray-index-parts/index-list.js";
 import { Timeline } from "./note-tray-index-parts/timeline.js";

package/dist/nav-indexing/site-tree-nav-demo.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 { NavNode } from "./types.js";
 export interface SiteTreeNavDemoProps {
     /**
@@ -21,7 +20,7 @@ export interface SiteTreeNavDemoProps {
     ariaLabel?: string;
 }
 /**
- * SiteTreeNavDemo — JSX port of `src/components/site-tree-nav-demo`.
+ * SiteTreeNavDemo — static server renderer for the site navigation tree.
  *
  * Renders the full site tree as a static collapsible section-by-section view.
  * Each top-level category becomes a `<details>` block; leaves within each

package/dist/nav-indexing/site-tree-nav-demo.js

@@ -1,4 +1,4 @@
-import { jsx, jsxs } from "preact/jsx-runtime";
+import { jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
 function flattenTree(nodes) {
   const result = [];
   function collect(n) {
@@ -27,7 +27,7 @@ function reorder(nodes, order) {
 function Section({ node }) {
   const leaves = flattenTree(node.children);
   return /* @__PURE__ */ jsxs("details", { class: "group border border-muted overflow-hidden", open: true, children: [
-    /* @__PURE__ */ jsxs("summary", { class: "flex items-center gap-x-hsp-md px-hsp-xl py-vsp-md text-title font-bold cursor-pointer select-none bg-surface list-none [&::-webkit-details-marker]:hidden", children: [
+    /* @__PURE__ */ jsxs("summary", { class: "flex items-center gap-x-hsp-md px-hsp-xl py-vsp-md text-title font-bold cursor-pointer select-none bg-surface list-none zd-hide-details-marker", children: [
       /* @__PURE__ */ jsx("span", { class: "inline-block text-caption text-muted transition-transform duration-200 group-open:rotate-90", children: "\u25B6" }),
       node.href ? /* @__PURE__ */ jsx("a", { href: node.href, class: "hover:text-accent hover:underline focus:underline focus-visible:text-accent", children: node.label }) : /* @__PURE__ */ jsx("span", { children: node.label })
     ] }),

package/dist/nav-indexing/tag-nav.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 { TagItem, TagLink, TagNavLabels } from "./types.js";
 export interface TagNavAllProps {
     variant: "all";

package/dist/nav-indexing/tag-nav.js

@@ -1,4 +1,4 @@
-import { jsx, jsxs } from "preact/jsx-runtime";
+import { jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
 function AllTagChip({
   tag,
   count,

package/dist/nav-indexing/types.d.ts

@@ -1,5 +1,5 @@
 /**
- * Shared types for the nav-indexing v2 primitives.
+ * Shared data types for the package-owned navigation components.
  *
  * All types are presentational: every value the components need to render
  * arrives via props. No host-project imports, no Astro collection queries.
@@ -39,7 +39,7 @@ export interface TagLink {
     href: string;
 }
 /**
- * i18n label bag for `TagNav`. Keeps v2 decoupled from the host's `t()`
+ * i18n label bag for `TagNav`. Keeps the package decoupled from the host's `t()`
  * function — the consumer resolves strings for the active locale and passes
  * them in.
  */

package/dist/nav-indexing/versions-page-content.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 { VersionPageEntry, VersionsPageLabels } from "./types.js";
 export interface VersionsPageContentProps {
     /** Pre-resolved href to the latest version's default docs page. */
@@ -11,7 +10,7 @@ export interface VersionsPageContentProps {
     labels: VersionsPageLabels;
 }
 /**
- * VersionsPageContent — JSX port of `src/components/versions-page-content`.
+ * VersionsPageContent — server renderer for the documentation versions page.
  *
  * Renders the full documentation versions page:
  *   - An `<h1>` heading (from `labels.pageTitle`).

package/dist/nav-indexing/versions-page-content.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 { ChevronRight } from "../icons/index.js";
 function VersionsPageContent(props) {
   const { latestHref, versions, labels } = props;
@@ -14,7 +14,7 @@ function VersionsPageContent(props) {
           class: "inline-flex items-center gap-hsp-xs text-small text-fg hover:text-accent hover:underline focus-visible:text-accent focus-visible:underline",
           children: [
             labels.latestLink,
-            /* @__PURE__ */ jsx(ChevronRight, { className: "h-[0.875rem] w-[0.875rem]" })
+            /* @__PURE__ */ jsx(ChevronRight, { class: "h-[0.875rem] w-[0.875rem]" })
           ]
         }
       )
@@ -24,21 +24,21 @@ function VersionsPageContent(props) {
       /* @__PURE__ */ jsx("p", { class: "text-small text-muted mb-vsp-md", children: labels.pastDescription }),
       /* @__PURE__ */ jsx("div", { class: "border border-muted rounded overflow-hidden", children: /* @__PURE__ */ jsxs("table", { class: "w-full text-small", children: [
         /* @__PURE__ */ jsx("thead", { children: /* @__PURE__ */ jsxs("tr", { class: "border-b border-muted bg-surface", children: [
-          /* @__PURE__ */ jsx("th", { class: "px-hsp-lg py-vsp-sm text-left font-medium text-muted", children: labels.versionCol }),
-          /* @__PURE__ */ jsx("th", { class: "px-hsp-lg py-vsp-sm text-left font-medium text-muted", children: labels.statusCol }),
-          /* @__PURE__ */ jsx("th", { class: "px-hsp-lg py-vsp-sm text-left font-medium text-muted", children: labels.docsCol })
+          /* @__PURE__ */ jsx("th", { class: "px-hsp-md py-vsp-xs text-left font-semibold text-muted", children: labels.versionCol }),
+          /* @__PURE__ */ jsx("th", { class: "px-hsp-md py-vsp-xs text-left font-semibold text-muted", children: labels.statusCol }),
+          /* @__PURE__ */ jsx("th", { class: "px-hsp-md py-vsp-xs text-left font-semibold text-muted", children: labels.docsCol })
         ] }) }),
         /* @__PURE__ */ jsx("tbody", { children: versions.map((v) => /* @__PURE__ */ jsxs(
           "tr",
           {
             class: "border-b border-muted last:border-b-0",
             children: [
-              /* @__PURE__ */ jsx("td", { class: "px-hsp-lg py-vsp-sm font-medium text-fg", children: v.label }),
-              /* @__PURE__ */ jsxs("td", { class: "px-hsp-lg py-vsp-sm", children: [
+              /* @__PURE__ */ jsx("td", { class: "px-hsp-md py-vsp-xs font-medium text-fg", children: v.label }),
+              /* @__PURE__ */ jsxs("td", { class: "px-hsp-md py-vsp-xs", children: [
                 v.banner === "unmaintained" && /* @__PURE__ */ jsx("span", { class: "inline-block rounded px-hsp-xs py-vsp-3xs text-caption bg-warning/10 text-warning", children: labels.unmaintained }),
                 v.banner === "unreleased" && /* @__PURE__ */ jsx("span", { class: "inline-block rounded px-hsp-xs py-vsp-3xs text-caption bg-info/10 text-info", children: labels.unreleased })
               ] }),
-              /* @__PURE__ */ jsx("td", { class: "px-hsp-lg py-vsp-sm", children: /* @__PURE__ */ jsx(
+              /* @__PURE__ */ jsx("td", { class: "px-hsp-md py-vsp-xs", children: /* @__PURE__ */ jsx(
                 "a",
                 {
                   href: v.docsHref,

package/dist/note-tray-index/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 NoteTrayIndexItem, type NoteTrayIndexStyle } from "../nav-indexing/index.js";
 import type { DateFormatSetting } from "../settings.js";
 export interface NoteTrayIndexNode extends NoteTrayIndexItem {

package/dist/note-tray-index/index.js

@@ -1,4 +1,4 @@
-import { jsx } from "preact/jsx-runtime";
+import { jsx } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import { remapVersionedHrefs } from "../nav-data-prep/index.js";
 import {
   NoteTrayIndex

package/dist/page-loading/page-loading-overlay.d.ts

@@ -1,5 +1,4 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
 /** Default `id` for the overlay element. Stable so test rigs can target it. */
 export declare const PAGE_LOADING_OVERLAY_ID = "page-loading-overlay";
 export interface PageLoadingOverlayProps {
@@ -28,4 +27,4 @@ export declare function buildPageLoadingOverlayBootstrap(overlayId: string): str
  * element-permitted-content and fails html-validate (same fix applied to the
  * version-switcher in zudolab/zudo-doc#1505; regression caught in W2A #1543).
  */
-export default function PageLoadingOverlay({ id, }?: PageLoadingOverlayProps): import("preact").JSX.Element;
+export default function PageLoadingOverlay({ id, }?: PageLoadingOverlayProps): import("@takazudo/zfb").Description;

package/dist/page-loading/page-loading-overlay.js

@@ -1,11 +1,11 @@
-import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+import { Fragment, jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import {
   AFTER_NAVIGATE_EVENT,
   BEFORE_NAVIGATE_EVENT
 } from "../transitions/page-events.js";
 const PAGE_LOADING_OVERLAY_ID = "page-loading-overlay";
 function buildPageLoadingOverlayBootstrap(overlayId) {
-  const id = JSON.stringify(overlayId);
+  const id = JSON.stringify(overlayId).replaceAll("<", "\\u003c");
   const before = JSON.stringify(BEFORE_NAVIGATE_EVENT);
   const after = JSON.stringify(AFTER_NAVIGATE_EVENT);
   return `(function(){
@@ -36,9 +36,7 @@ function PageLoadingOverlay({
     /* @__PURE__ */ jsx(
       "script",
       {
-        dangerouslySetInnerHTML: {
-          __html: buildPageLoadingOverlayBootstrap(id)
-        }
+        rawHtml: buildPageLoadingOverlayBootstrap(id)
       }
     )
   ] });

package/dist/plugins/agent-export.d.ts

@@ -0,0 +1,3 @@
+import type { ZfbPlugin } from "@takazudo/zfb/plugins";
+declare const plugin: ZfbPlugin;
+export default plugin;

package/dist/plugins/agent-export.js

@@ -0,0 +1,34 @@
+import { emitAgentCorpus, projectAgentCorpus } from "./internal/agent-export/index.js";
+import { getBasePrefix } from "./plugin-utils.js";
+const plugin = {
+  name: "agent-export",
+  async postBuild(ctx) {
+    emitAgentCorpus({ ...ctx.options, outDir: ctx.outDir, copyPublicWithBase: ctx.config.copyPublicWithBase });
+  },
+  devMiddleware(ctx) {
+    const options = ctx.options;
+    const route = `${getBasePrefix(options.base)}/agent/v1/`;
+    const handler = async (req) => {
+      if (!req.url.split("?")[0]?.startsWith(route)) return void 0;
+      if (req.method !== "GET" && req.method !== "HEAD") return { status: 405, headers: { allow: "GET, HEAD" }, body: "Method Not Allowed" };
+      const path = req.url.split("?")[0].slice(route.length);
+      const corpus = projectAgentCorpus(options);
+      let body;
+      let type = "application/json; charset=utf-8";
+      if (path === "manifest.json") body = JSON.stringify(corpus.manifest);
+      else if (path === "search-index.json") body = JSON.stringify(corpus.index);
+      else if (/^items\/p-[a-f0-9]{16}-[0-9]{6}\.json$/.test(path)) body = corpus.items.get(path.slice(6, -5));
+      else if (/^pages\/p-[a-f0-9]{16}\.md$/.test(path)) {
+        body = corpus.pages.get(path.slice(6, -3));
+        type = "text/markdown; charset=utf-8";
+      }
+      if (body === void 0) return { status: 404, headers: { "content-type": "text/plain" }, body: "Not Found" };
+      return { status: 200, headers: { "content-type": type }, body: req.method === "HEAD" ? "" : body };
+    };
+    ctx.register(route.slice(0, -1), handler);
+  }
+};
+var agent_export_default = plugin;
+export {
+  agent_export_default as default
+};

package/dist/plugins/internal/agent-export/chunk.d.ts

@@ -0,0 +1,5 @@
+import type { AgentItem } from "../../../agent-docs/types.js";
+type AgentChunkMetadata = Pick<AgentItem["metadata"], "locale" | "pageId"> & Partial<Pick<AgentItem["metadata"], "description" | "section" | "unsupportedDynamicContent">>;
+/** Exact, ordered slices. Boundaries prefer headings and paragraphs, then Unicode-safe cuts. */
+export declare function chunkAgentText(text: string, title: string, url: string, metadata?: AgentChunkMetadata): string[];
+export {};

package/dist/plugins/internal/agent-export/chunk.js

@@ -0,0 +1,90 @@
+import { AGENT_MAX_ITEM_TEXT_UNITS, AGENT_MAX_TOOL_RESPONSE_BYTES } from "../../../agent-docs/limits.js";
+const RESPONSE_FRAMING_RESERVE_BYTES = 4096;
+function isHighSurrogate(value) {
+  return value >= 55296 && value <= 56319;
+}
+function isLowSurrogate(value) {
+  return value >= 56320 && value <= 57343;
+}
+function firstCodePointUnits(text, start) {
+  return isHighSurrogate(text.charCodeAt(start)) && isLowSurrogate(text.charCodeAt(start + 1)) ? 2 : 1;
+}
+function safeCut(text, start, limit) {
+  let end = Math.min(start + limit, text.length);
+  if (end < text.length && end > start && isHighSurrogate(text.charCodeAt(end - 1)) && isLowSurrogate(text.charCodeAt(end))) {
+    end--;
+  }
+  return end;
+}
+function fitsResponseBudget(text, title, url, metadata) {
+  const item = {
+    // The real page IDs are 25 UTF-16 units at most; keep a larger fixed ID
+    // and the maximum part numbers while sizing before chunkCount is known.
+    id: "x".repeat(32),
+    title,
+    text,
+    url,
+    metadata: {
+      ...metadata,
+      fingerprint: "f".repeat(64),
+      part: 999999,
+      partCount: 999999
+    }
+  };
+  const serialized = JSON.stringify({
+    structuredContent: item,
+    content: [{ type: "text", text: JSON.stringify(item) }]
+  });
+  return Buffer.byteLength(serialized) <= AGENT_MAX_TOOL_RESPONSE_BYTES - RESPONSE_FRAMING_RESERVE_BYTES;
+}
+function failItemBudget() {
+  throw new Error(
+    "Agent item cannot fit within the MCP tool response byte limit, even with one Unicode code point."
+  );
+}
+function chunkAgentText(text, title, url, metadata = { locale: "x", pageId: "x".repeat(32) }) {
+  if (!text) {
+    if (!fitsResponseBudget("", title, url, metadata)) failItemBudget();
+    return [""];
+  }
+  const result = [];
+  let offset = 0;
+  while (offset < text.length) {
+    let end = safeCut(text, offset, AGENT_MAX_ITEM_TEXT_UNITS);
+    if (end < text.length) {
+      const slice = text.slice(offset, end);
+      const preferred = Math.max(slice.lastIndexOf("\n# "), slice.lastIndexOf("\n## "), slice.lastIndexOf("\n\n"));
+      if (preferred > Math.floor(slice.length / 3)) end = offset + preferred + 1;
+      const before = text.slice(offset, end);
+      const openings = [...before.matchAll(/^\s*(`{3,}|~{3,})/gm)];
+      if (openings.length % 2 === 1) {
+        const last = openings.at(-1);
+        const fenceStart = offset + last.index;
+        const close = text.indexOf(`
+${last[1]}`, end);
+        if (close >= 0 && close + 1 + last[1].length - offset <= AGENT_MAX_ITEM_TEXT_UNITS) {
+          end = close + 1 + last[1].length;
+        } else if (fenceStart > offset) end = fenceStart;
+      }
+    }
+    if (end <= offset) end = safeCut(text, offset, AGENT_MAX_ITEM_TEXT_UNITS);
+    let part = text.slice(offset, end);
+    while (!fitsResponseBudget(part, title, url, metadata)) {
+      const currentUnits = end - offset;
+      const minimumUnits = firstCodePointUnits(text, offset);
+      if (currentUnits <= minimumUnits) failItemBudget();
+      const nextUnits = Math.max(minimumUnits, Math.floor(currentUnits * 0.8));
+      let nextEnd = safeCut(text, offset, nextUnits);
+      if (nextEnd <= offset || nextEnd >= end) nextEnd = offset + minimumUnits;
+      if (nextEnd <= offset || nextEnd >= end) failItemBudget();
+      end = nextEnd;
+      part = text.slice(offset, end);
+    }
+    result.push(part);
+    offset = end;
+  }
+  return result;
+}
+export {
+  chunkAgentText
+};

package/dist/plugins/internal/agent-export/index.d.ts

@@ -0,0 +1,24 @@
+import type { AgentManifest, AgentSearchIndex } from "../../../agent-docs/types.js";
+export interface AgentExportOptions {
+    outDir?: string;
+    base: string;
+    siteUrl?: string;
+    siteName: string;
+    defaultLocale: string;
+    defaultLocaleDir: string;
+    locales?: Array<{
+        code: string;
+        dir: string;
+    }>;
+}
+export declare function projectAgentCorpus(options: AgentExportOptions): {
+    manifest: AgentManifest;
+    index: AgentSearchIndex;
+    pages: Map<string, string>;
+    items: Map<string, string>;
+};
+/** Replace only the owned agent/v1 subtree, including on exclude/delete rebuilds. */
+export declare function emitAgentCorpus(options: AgentExportOptions & {
+    outDir: string;
+    copyPublicWithBase?: boolean;
+}): string[];