@takazudo/zudo-doc 5.28.2 → 6.0.0

package/eject/toc/use-active-heading.ts

@@ -1,4 +1,5 @@
-import { useCallback, useEffect, useRef, useState } from "preact/hooks";
+import { signal } from "@takazudo/zfb/zudo-react";
+import type { Scope, Signal } from "@takazudo/zfb/zudo-react";
 import type { HeadingItem } from "./types.js";
 
 /**
@@ -12,7 +13,7 @@ const DEBOUNCE_MS = 200;
 
 /**
  * Pure helper that picks the active heading id given the heading slug
- * order and a slug→element map. Extracted from the hook so it is unit-
+ * order and a slug→element map. Extracted from the setup helper so it is unit-
  * testable without DOM event plumbing.
  *
  * Algorithm: find the first heading whose top is at or below the
@@ -67,12 +68,12 @@ export function getActiveHeadingId(
 }
 
 export interface UseActiveHeadingResult {
-  activeId: string | null;
+  activeId: Signal<string | null>;
   activate: (id: string) => void;
 }
 
 /**
- * Scroll-spy hook. Tracks which heading slug should be highlighted
+ * Scroll-spy setup helper. Tracks which heading slug should be highlighted
  * based on the current scroll position. Provides an `activate(id)`
  * imperatively-callable helper used by click handlers — sets the
  * active id immediately and suppresses the scroll-driven update until
@@ -80,50 +81,44 @@ export interface UseActiveHeadingResult {
  * for older Safari).
  */
 export function useActiveHeading(
+  scope: Scope,
   headings: readonly HeadingItem[],
 ): UseActiveHeadingResult {
-  const [activeId, setActiveId] = useState<string | null>(null);
-  const headingIdsRef = useRef<readonly string[]>([]);
-  const elementMapRef = useRef<Map<string, HTMLElement>>(new Map());
-  const suppressedRef = useRef(false);
-
-  const activate = useCallback((id: string) => {
-    setActiveId(id);
-    suppressedRef.current = true;
-    // Safety timeout: unsuppress if no scroll event fires (target already in view)
-    setTimeout(() => {
-      suppressedRef.current = false;
-    }, 2000);
-  }, []);
-
-  useEffect(() => {
-    const ids = headings.map((h) => h.slug);
-    headingIdsRef.current = ids;
+  const activeId = signal<string | null>(null);
+  const headingIds = headings.map((heading) => heading.slug);
+  let activateInScope: (id: string) => void = () => {};
+  const activate = (id: string) => activateInScope(id);
+
+  scope.onActivate(() => {
+    let suppressed = false;
+    let timerId: ReturnType<typeof setTimeout> | null = null;
+    let fallbackTimerId: ReturnType<typeof setTimeout> | null = null;
+    let suppressionTimerId: ReturnType<typeof setTimeout> | null = null;
+
+    activateInScope = (id: string) => {
+      activeId.value = id;
+      suppressed = true;
+      if (suppressionTimerId !== null) clearTimeout(suppressionTimerId);
+      // Safety timeout: unsuppress if no scroll event fires (target already in view).
+      suppressionTimerId = setTimeout(() => {
+        suppressionTimerId = null;
+        suppressed = false;
+      }, 2000);
+    };
 
     const map = new Map<string, HTMLElement>();
-    for (const id of ids) {
+    for (const id of headingIds) {
       const el = document.getElementById(id);
       if (el) map.set(id, el);
     }
-    elementMapRef.current = map;
-
-    let timerId: ReturnType<typeof setTimeout> | null = null;
 
     function update() {
       timerId = null;
-      setActiveId(
-        getActiveHeadingId(
-          headingIdsRef.current,
-          elementMapRef.current,
-          window.innerHeight,
-        ),
-      );
+      activeId.value = getActiveHeadingId(headingIds, map, window.innerHeight);
     }
 
-    let fallbackTimerId: ReturnType<typeof setTimeout> | null = null;
-
     function onScroll() {
-      if (suppressedRef.current) {
+      if (suppressed) {
         // Fallback for browsers without scrollend (Safari < 18)
         if (fallbackTimerId !== null) clearTimeout(fallbackTimerId);
         fallbackTimerId = setTimeout(onScrollEnd, 1500);
@@ -134,7 +129,11 @@ export function useActiveHeading(
     }
 
     function onScrollEnd() {
-      suppressedRef.current = false;
+      suppressed = false;
+      if (suppressionTimerId !== null) {
+        clearTimeout(suppressionTimerId);
+        suppressionTimerId = null;
+      }
       if (fallbackTimerId !== null) {
         clearTimeout(fallbackTimerId);
         fallbackTimerId = null;
@@ -143,20 +142,26 @@ export function useActiveHeading(
       update();
     }
 
+    // Browser position may reflect a restored scroll position or current hash.
+    // Read it only after hydration so the initial server/client tree agrees.
     update();
-
     window.addEventListener("scroll", onScroll, { passive: true });
     window.addEventListener("resize", onScroll, { passive: true });
     window.addEventListener("scrollend", onScrollEnd, { passive: true });
 
     return () => {
+      activateInScope = () => {};
       window.removeEventListener("scroll", onScroll);
       window.removeEventListener("resize", onScroll);
       window.removeEventListener("scrollend", onScrollEnd);
       if (timerId !== null) clearTimeout(timerId);
+      timerId = null;
       if (fallbackTimerId !== null) clearTimeout(fallbackTimerId);
+      fallbackTimerId = null;
+      if (suppressionTimerId !== null) clearTimeout(suppressionTimerId);
+      suppressionTimerId = null;
     };
-  }, [headings]);
+  });
 
   return { activeId, activate };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zudo-doc",
-  "version": "5.28.2",
+  "version": "6.0.0",
   "type": "module",
   "description": "zudo-doc framework primitives layer that sits on top of zfb's engine — sidebar, theme, TOC, breadcrumb, layouts, head injection, View Transitions, SSR-skip wrappers (per ADR-003).",
   "license": "MIT",
@@ -167,6 +167,10 @@
       "types": "./dist/plugins/llms-txt.d.ts",
       "default": "./dist/plugins/llms-txt.js"
     },
+    "./plugins/agent-export": {
+      "types": "./dist/plugins/agent-export.d.ts",
+      "default": "./dist/plugins/agent-export.js"
+    },
     "./plugins/changelog": {
       "types": "./dist/plugins/changelog.d.ts",
       "default": "./dist/plugins/changelog.js"
@@ -268,12 +272,11 @@
       "default": "./dist/home-intro/prepare.js"
     },
     "./theme.css": "./dist/theme.css",
-    "./theme-no-reset.css": "./dist/theme-no-reset.css",
-    "./safelist.css": "./dist/safelist.css",
     "./content.css": "./dist/content.css",
     "./page-loading.css": "./dist/page-loading.css",
     "./features.css": "./dist/features.css",
     "./compiled.css": "./dist/compiled.css",
+    "./wind.json": "./dist/wind.json",
     "./theme-packs/*": "./dist/theme-packs/*",
     "./routes-src/*": "./routes-src/*",
     "./tsconfig.base.json": "./tsconfig.base.json",
@@ -352,12 +355,12 @@
       "default": "./dist/site-tree-nav-island/index.js"
     },
     "./image-enlarge": {
-      "types": "./dist/image-enlarge/index.d.ts",
-      "default": "./dist/image-enlarge/index.js"
+      "types": "./dist/image-enlarge/public.d.ts",
+      "default": "./dist/image-enlarge/public.js"
     },
     "./mermaid-enlarge": {
-      "types": "./dist/mermaid-enlarge/index.d.ts",
-      "default": "./dist/mermaid-enlarge/index.js"
+      "types": "./dist/mermaid-enlarge/public.d.ts",
+      "default": "./dist/mermaid-enlarge/public.js"
     },
     "./ai-chat-modal": {
       "types": "./dist/ai-chat-modal/index.d.ts",
@@ -511,6 +514,10 @@
       "types": "./dist/site-tree-nav/index.d.ts",
       "default": "./dist/site-tree-nav/index.js"
     },
+    "./routes/design-token-panel-bootstrap": {
+      "types": "./dist/routes/_design-token-panel-bootstrap.d.ts",
+      "default": "./dist/routes/_design-token-panel-bootstrap.js"
+    },
     "./routes/index": {
       "types": "./dist/routes/index.d.ts",
       "default": "./dist/routes/index.js"
@@ -555,6 +562,14 @@
       "types": "./dist/routes/api-ai-chat.d.ts",
       "default": "./dist/routes/api-ai-chat.js"
     },
+    "./routes/mcp": {
+      "types": "./dist/routes/mcp.d.ts",
+      "default": "./dist/routes/mcp.js"
+    },
+    "./mcp": {
+      "types": "./dist/mcp/index.d.ts",
+      "default": "./dist/mcp/index.js"
+    },
     "./routes/locale-index": {
       "types": "./dist/routes/locale-index.d.ts",
       "default": "./dist/routes/locale-index.js"
@@ -716,17 +731,20 @@
     "CHANGELOG.md"
   ],
   "peerDependencies": {
+    "@modelcontextprotocol/sdk": "1.32.1",
     "@takazudo/zdtp": "^0.5.2 || ^0.6.0 || ^0.7.0 || ^0.8.0",
-    "@takazudo/zfb": "^2.22.1",
-    "@takazudo/zfb-md-wasm": "^2.22.1",
-    "@takazudo/zfb-runtime": "^2.22.1",
-    "@takazudo/zudo-doc-history-server": "^5.17.2",
+    "@takazudo/zfb": "^4.3.1",
+    "@takazudo/zfb-md-wasm": "^4.3.1",
+    "@takazudo/zfb-runtime": "^4.3.1",
+    "@takazudo/zudo-doc-history-server": "^6.0.0",
     "diff": "^8.0.0",
     "katex": "^0.16.0",
-    "preact": "^10.29.1",
     "zod": "^4.3.6"
   },
   "peerDependenciesMeta": {
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    },
     "@takazudo/zudo-doc-history-server": {
       "optional": true
     },
@@ -756,34 +774,34 @@
     "yaml": "^2.9.0"
   },
   "devDependencies": {
+    "@modelcontextprotocol/sdk": "1.32.1",
     "@takazudo/mdx-formatter": "1.3.0",
-    "@takazudo/zfb": "2.22.1",
-    "@takazudo/zfb-md-wasm": "2.22.1",
-    "@takazudo/zfb-runtime": "2.22.1",
+    "@takazudo/zfb": "4.3.1",
+    "@takazudo/zfb-md-wasm": "4.3.1",
+    "@takazudo/zfb-runtime": "4.3.1",
     "@types/fs-extra": "^11.0.4",
     "@types/minimist": "^1.2.5",
     "@types/node": "^25.3.5",
     "@types/pluralize": "^0.0.33",
     "happy-dom": "^20.10.6",
-    "preact": "^10.29.1",
-    "preact-render-to-string": "^6.6.6",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0",
     "vitest": "^4.1.0",
     "zod": "^4.3.6",
-    "@takazudo/zudo-doc-history-server": "5.28.2"
+    "@takazudo/zudo-doc-history-server": "6.0.0"
   },
   "scripts": {
     "gen:search-widget-script": "node scripts/gen-search-widget-script.mjs",
     "gen:nav-overflow-script": "node scripts/gen-nav-overflow-script.mjs",
-    "build": "node scripts/gen-search-widget-script.mjs && node scripts/gen-nav-overflow-script.mjs && tsup && tsc -p tsconfig.build.json",
-    "predev": "node ../../scripts/ensure-workspace-build.mjs && node scripts/gen-search-widget-script.mjs && node scripts/gen-nav-overflow-script.mjs",
+    "gen:switcher-scripts": "node scripts/gen-switcher-scripts.mjs",
+    "build": "node scripts/gen-search-widget-script.mjs && node scripts/gen-nav-overflow-script.mjs && node scripts/gen-switcher-scripts.mjs && tsup && tsc -p tsconfig.build.json",
+    "predev": "node ../../scripts/ensure-workspace-build.mjs && node scripts/gen-search-widget-script.mjs && node scripts/gen-nav-overflow-script.mjs && node scripts/gen-switcher-scripts.mjs",
     "// dev": "Do NOT add `--continue-on-error` here. It stops a fatal watcher exit from cascading, but the dead watcher then fails silently — a dead dev:dts leaves dist/*.d.ts frozen while the JS keeps updating, which typechecks cleanly against stale types instead of failing loudly like #3113's absent declarations did. See the #3129 section in CLAUDE.md.",
     "dev": "node bin/run-parallel.mjs dev:js dev:dts",
     "dev:js": "tsup --watch",
     "dev:dts": "tsc -p tsconfig.build.json --watch --preserveWatchOutput",
-    "// check:prepack-contract": "check:search-widget-drift and check:nav-overflow-drift run here (not just b4push/CI) because `prepare` regenerates BOTH frozen literals unconditionally — without a prepack gate, packing from a tree where a source changed but a literal was never re-committed would silently publish new script bytes and break every consumer's pinned CSP hash (#3534/#3535 for nav-overflow; #3540 extended the same gate to search-widget, the exact failure class the freezes exist to prevent).",
-    "check:prepack-contract": "pnpm --dir ../.. check:search-widget-drift && pnpm --dir ../.. check:nav-overflow-drift && pnpm --dir ../.. gen:changelog && node scripts/check-theme-css.mjs && node scripts/check-safelist.mjs && node scripts/check-content-css.mjs && node scripts/check-page-loading-css.mjs && node scripts/check-features-css.mjs && node scripts/check-compiled-css.mjs && node scripts/check-theme-packs.mjs && node scripts/check-catalog.mjs && node scripts/check-site-schema.mjs && node scripts/check-theme-packs-registry.mjs && node scripts/check-plugins.mjs && node scripts/check-plugin-resolution.mjs && node scripts/check-eject-sources.mjs && node scripts/check-routes-src.mjs && node scripts/check-shim-artifacts.mjs && node scripts/check-virtual-modules.mjs && node bin/gen-component-tokens.mjs --check && node scripts/check-route-context-payload.mjs && node scripts/check-asset-viewer-exports.mjs",
+    "// check:prepack-contract": "Switcher, search-widget and nav-overflow drift checks run here (not just b4push/CI) because `prepare` regenerates frozen literals unconditionally — without a prepack gate, packing from a tree where a source changed but a literal was never re-committed would silently publish new script bytes and break every consumer's pinned CSP hash (#3534/#3535 for nav-overflow; #3540 extended the same gate to search-widget, the exact failure class the freezes exist to prevent).",
+    "check:prepack-contract": "bash ../../scripts/check-switcher-scripts-drift.sh && pnpm --dir ../.. check:search-widget-drift && pnpm --dir ../.. check:nav-overflow-drift && pnpm --dir ../.. gen:changelog && node scripts/check-theme-css.mjs && node scripts/check-wind-manifest.mjs && node scripts/check-content-css.mjs && node scripts/check-page-loading-css.mjs && node scripts/check-features-css.mjs && node scripts/check-compiled-css.mjs && node scripts/check-theme-packs.mjs && node scripts/check-catalog.mjs && node scripts/check-site-schema.mjs && node scripts/check-theme-packs-registry.mjs && node scripts/check-plugins.mjs && node scripts/check-plugin-resolution.mjs && node scripts/check-eject-sources.mjs && node scripts/check-routes-src.mjs && node scripts/check-shim-artifacts.mjs && node scripts/check-virtual-modules.mjs && node bin/gen-component-tokens.mjs --check && node scripts/check-route-context-payload.mjs && node scripts/check-asset-viewer-exports.mjs",
     "test:plugin-resolution": "node scripts/check-plugin-resolution.mjs",
     "test": "vitest run --config vitest.config.ts",
     "test:slow": "vitest run --config vitest.slow.config.ts",

package/routes-src/404.tsx

@@ -1,9 +1,8 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
 // Package route entrypoint: /404 — package-owned equivalent of pages/404.tsx
 // (A1 #2361). Static route; emitted as dist/404.html.
 
-import type { JSX } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
 import { DocLayoutWithDefaults } from "@takazudo/zudo-doc/doclayout";
 import { resolveThemePackSsrSlug } from "@takazudo/zudo-doc/theme";
 import { settings, defaultLocale, withBase, themePackRegistry } from "./_context.js";
@@ -17,7 +16,7 @@ import {
 
 export const frontmatter = { title: "404" };
 
-export default function NotFoundPage(): JSX.Element {
+export default function NotFoundPage(): Child {
   const locale = defaultLocale;
   const title = "Page Not Found";
 

package/routes-src/_chrome.tsx

@@ -1,3 +1,4 @@
+import { Island } from "@takazudo/zfb";
 // routes/_chrome — thin chrome shim for the package-owned route entrypoints
 // (epic Package-First Finale #2356, A1 #2361).
 //
@@ -12,7 +13,7 @@
 
 import { routeCtx } from "./_context.js";
 import { createChrome } from "@takazudo/zudo-doc/chrome";
-import { DocHistory } from "@takazudo/zudo-doc/doc-history";
+import { DocHistoryBoundary as DocHistory } from "@takazudo/zudo-doc/doc-history-area";
 import type { DocNavNode } from "@takazudo/zudo-doc/site-schema";
 // Imported via the BARE published subpath rather than a relative
 // `../chrome-bindings.js`. This file is copied into consumer projects by the
@@ -74,9 +75,13 @@ import { ConfiguredDesignTokenPanelBootstrap } from "./_design-token-panel-boots
 // It is spread BEFORE `...chromeBindings` (unlike `DocHistory`, which is spread
 // after): a host's own `DesignTokenPanelBootstrap` slot value must still win,
 // exactly as it did when the derive-level default was the only package wiring.
+function ConfiguredDesignTokenPanelBoundary() {
+  return <><Island when="load"><ConfiguredDesignTokenPanelBootstrap /></Island></>;
+}
+
 const chrome = createChrome(routeCtx, {
   ...defineChromeBindings({
-    DesignTokenPanelBootstrap: ConfiguredDesignTokenPanelBootstrap,
+    DesignTokenPanelBootstrap: ConfiguredDesignTokenPanelBoundary,
   }),
   ...chromeBindings,
   ...defineChromeBindings({ DocHistory }),

package/routes-src/_design-token-panel-bootstrap.tsx

@@ -1,63 +1 @@
-"use client";
-
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-
-// routes/_design-token-panel-bootstrap — the ROUTES-ONLY configured
-// design-token-panel island (#3396, epic #3394).
-//
-// WHY THIS FILE EXISTS: `virtual:zudo-doc-design-token-panel-config` is
-// registered by the routes plugin, so any module that imports it statically
-// drags the plugin along as a hard requirement. Until #3396 that importer was
-// `../design-token-panel-bootstrap.tsx`, which `chrome/derive.tsx` imports —
-// meaning `@takazudo/zudo-doc/chrome` could not be bundled outside a zfb build
-// (or by a `packageOwnedRoutes: false` host) without aliasing the specifier.
-// Moving the import HERE confines it to the routes graph, which zfb always
-// bundles with the plugin active.
-//
-// WHY A COMPONENT AND NOT A SETTER: the route/SSR module graph and the
-// hydrated island bundle are SEPARATE graphs. A `setPanelConfigBuilder(...)`
-// called while `_chrome.tsx` evaluates would configure only the server-side
-// copy of the bootstrap module; the client bundle re-evaluates that module
-// independently and would keep the package default. Passing the builder as an
-// argument from a component that lives INSIDE the island bundle is the only
-// shape that survives the boundary.
-//
-// ISLAND-SCANNER CONTRACT (#2480 lesson): `_chrome.tsx` imports this module
-// STATICALLY and threads the component into `hostBindings`, so the scanner
-// walks route → _chrome → here. The exported binding identifier and the
-// `displayName` must stay IDENTICAL — zfb registers islands by the
-// scanner-visible export name, and a marker whose name has no registry entry
-// silently never hydrates. The name must also stay DISTINCT from
-// `DesignTokenPanelBootstrap`: `chrome/derive.tsx` still statically imports
-// that package default (it is the slot default for bare `createChrome`
-// callers), so both components are in the scanned graph and a shared name
-// would trip zfb's "island marker name collision" warning and drop one of them.
-
-import type { JSX } from "preact";
-import { runDesignTokenPanelBootstrapOnce } from "@takazudo/zudo-doc/design-token-panel-bootstrap";
-// Host-callables channel, third virtual module (#2658, mirrors #2501's
-// chromeBindingsModule): absent `settings.designTokenPanelConfigModule` →
-// re-exports the package default (`@takazudo/zudo-doc/design-token-panel-config`);
-// present → re-exports the host's module. Registered unconditionally by the
-// routes plugin (`../plugins/routes.ts`) whenever `packageOwnedRoutes` is on.
-// Not present on disk; the package ships ambient typings for it
-// (`./_virtual.d.ts`).
-import { buildDesignTokenPanelConfig } from "virtual:zudo-doc-design-token-panel-config";
-
-/**
- * The design-token-panel island injected routes mount instead of the package
- * default: identical behavior, except the mode-scoped `PanelConfig` builder is
- * the one the routes plugin resolved — the host's
- * `settings.designTokenPanelConfigModule` when set, the package default
- * otherwise.
- *
- * Renders `null` on both SSR and client (the panel self-mounts as a side
- * effect of `bootstrapDesignTokenPanel`), matching the package default's
- * non-`ssrFallback` `Island({ when: "load" })` shape.
- */
-export function ConfiguredDesignTokenPanelBootstrap(): JSX.Element | null {
-  runDesignTokenPanelBootstrapOnce(buildDesignTokenPanelConfig, "configured");
-  return null;
-}
-ConfiguredDesignTokenPanelBootstrap.displayName = "ConfiguredDesignTokenPanelBootstrap";
+export { ConfiguredDesignTokenPanelBootstrap } from "@takazudo/zudo-doc/routes/design-token-panel-bootstrap";

package/routes-src/docs-slug.tsx

@@ -1,5 +1,4 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
 // Package route entrypoint: /docs/[[...slug]] — package-owned equivalent of
 // pages/docs/[[...slug]].tsx (epic Package-First Finale #2356, A1 #2361).
 //
@@ -11,7 +10,7 @@
 // is on; even then dropped if the user keeps a `pages/docs/[[...slug]].tsx`
 // stub (Decision 6).
 
-import type { JSX } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
 import type { DocPageEntryProps, DocPageAutoIndexProps } from "@takazudo/zudo-doc/doc-page-props";
 import { settings, defaultLocale, resolveNavSource, buildDocRouteEntries } from "./_context.js";
 import { renderDocPage } from "./_chrome.js";
@@ -35,7 +34,7 @@ export function paths(): Array<{ params: { slug: string[] }; props: DocPageProps
 
 type PageArgs = DocPageProps & { params: { slug: string[] } };
 
-export default function DocsPage(props: PageArgs): JSX.Element {
+export default function DocsPage(props: PageArgs): Child {
   return renderDocPage(props, {
     locale: defaultLocale,
     docHistoryContentDir: settings.docsDir,

package/routes-src/docs-tags-index.tsx

@@ -1,14 +1,13 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
 // Package route entrypoint: /docs/tags — package-owned equivalent of
 // pages/docs/tags/index.tsx (A1 #2361). Default-locale "All Tags" index.
 
-import type { JSX } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
 import { defaultLocale } from "./_context.js";
 import { TagsIndexPageView } from "./_chrome.js";
 
 export const frontmatter = { title: "All Tags" };
 
-export default function DocsTagsIndexPage(): JSX.Element {
+export default function DocsTagsIndexPage(): Child {
   return <TagsIndexPageView locale={defaultLocale} />;
 }

package/routes-src/docs-tags-tag.tsx

@@ -1,10 +1,9 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
 // Package route entrypoint: /docs/tags/[tag] — package-owned equivalent of
 // pages/docs/tags/[tag].tsx (A1 #2361). One route per unique tag in the
 // default-locale collection.
 
-import type { JSX } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
 import type { TagInfo } from "@takazudo/zudo-doc/tag-pages";
 import { defaultLocale } from "./_context.js";
 import { collectTagMapForLocale, TagDetailPageView } from "./_chrome.js";
@@ -24,6 +23,6 @@ interface PageProps {
   tagInfo: TagInfo;
 }
 
-export default function DocTagPage({ params, tagInfo }: PageProps): JSX.Element {
+export default function DocTagPage({ params, tagInfo }: PageProps): Child {
   return <TagDetailPageView locale={defaultLocale} tag={params.tag} tagInfo={tagInfo} />;
 }

package/routes-src/docs-versions.tsx

@@ -1,15 +1,14 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
 // Package route entrypoint: /docs/versions — package-owned equivalent of
 // pages/docs/versions.tsx (A1 #2361). Default-locale versions index; rendered
 // by the package `VersionsPageView` (`_chrome`).
 
-import type { JSX } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
 import { defaultLocale } from "./_context.js";
 import { VersionsPageView } from "./_chrome.js";
 
 export const frontmatter = { title: "Versions" };
 
-export default function VersionsPage(): JSX.Element {
+export default function VersionsPage(): Child {
   return <VersionsPageView locale={defaultLocale} />;
 }

package/routes-src/files-path.tsx

@@ -1,7 +1,5 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-
-import type { JSX } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
 import recordsValue from "virtual:zudo-doc-asset-bodies";
 import type { AssetRecords } from "@takazudo/zudo-doc/plugins";
 import type { AssetIndexEntry } from "@takazudo/zudo-doc/route-context-payload";
@@ -28,7 +26,7 @@ export function paths(): Array<{
     : assetPaths;
 }
 
-export default function FilesPathPage(props: FilesPathProps): JSX.Element {
+export default function FilesPathPage(props: FilesPathProps): Child {
   if (props.kind === "index") return <AssetIndexPageView entries={props.entries} />;
   const { entry } = props;
   const records = recordsValue as AssetRecords;

package/routes-src/index.tsx

@@ -1,5 +1,4 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
 // Package route entrypoint: / — package-owned equivalent of pages/index.tsx
 // (A1 #2361). Default-locale (EN) site index: site-map grid + optional tag
 // count, rendered through the package chrome (`_chrome`). Static route — no
@@ -10,14 +9,14 @@
 // `prepareHomeData` factory (#2519) for the data-prep sequence, then handing
 // the result to the shared home body factory.
 
-import type { JSX } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
 import { defaultLocale, routeCtx, settings } from "./_context.js";
 import { prepareHomeData } from "@takazudo/zudo-doc/home-page";
 import { HomePageView } from "./_chrome.js";
 
 export const frontmatter = { title: "Home" };
 
-export default function IndexPage(): JSX.Element {
+export default function IndexPage(): Child {
   const locale = defaultLocale;
 
   const { tree, categoryOrder, tagCount, tags } = prepareHomeData(routeCtx, locale);

package/routes-src/locale-docs-slug.tsx

@@ -1,5 +1,4 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
 // Package route entrypoint: /[locale]/docs/[[...slug]] — package-owned
 // equivalent of pages/[locale]/docs/[[...slug]].tsx (A1 #2361).
 //
@@ -7,7 +6,7 @@
 // injected ONCE; `paths()` enumerates one route per (non-default locale, slug)
 // with the locale-first + base-EN-fallback merge — reconstructed via `_context`.
 
-import type { JSX } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
 import type { DocPageEntryProps, DocPageAutoIndexProps } from "@takazudo/zudo-doc/doc-page-props";
 import { settings, getLocaleConfig, resolveNavSource, buildDocRouteEntries } from "./_context.js";
 import { renderDocPage } from "./_chrome.js";
@@ -60,7 +59,7 @@ export function paths(): Array<{
 
 type PageArgs = DocPageProps & { params: { locale: string; slug: string[] } };
 
-export default function LocaleDocsPage(props: PageArgs): JSX.Element {
+export default function LocaleDocsPage(props: PageArgs): Child {
   return renderDocPage(props, {
     locale: props.params.locale,
     isFallback: props.isFallback,

package/routes-src/locale-docs-tags-index.tsx

@@ -1,10 +1,9 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
 // Package route entrypoint: /[locale]/docs/tags — package-owned equivalent of
 // pages/[locale]/docs/tags/index.tsx (A1 #2361). One route per non-default
 // locale; the tag map is computed at render time (locale-first + base merge).
 
-import type { JSX } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
 import { settings } from "./_context.js";
 import { TagsIndexPageView } from "./_chrome.js";
 
@@ -18,6 +17,6 @@ interface PageProps {
   params: { locale: string };
 }
 
-export default function LocaleTagsIndexPage({ params }: PageProps): JSX.Element {
+export default function LocaleTagsIndexPage({ params }: PageProps): Child {
   return <TagsIndexPageView locale={params.locale} />;
 }

package/routes-src/locale-docs-tags-tag.tsx

@@ -1,10 +1,9 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
 // Package route entrypoint: /[locale]/docs/tags/[tag] — package-owned
 // equivalent of pages/[locale]/docs/tags/[tag].tsx (A1 #2361). One route per
 // (non-default locale, tag) pair.
 
-import type { JSX } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
 import type { TagInfo } from "@takazudo/zudo-doc/tag-pages";
 import { settings } from "./_context.js";
 import { collectTagMapForLocale, TagDetailPageView } from "./_chrome.js";
@@ -34,6 +33,6 @@ interface PageProps {
   tagInfo: TagInfo;
 }
 
-export default function LocaleDocTagPage({ params, tagInfo }: PageProps): JSX.Element {
+export default function LocaleDocTagPage({ params, tagInfo }: PageProps): Child {
   return <TagDetailPageView locale={params.locale} tag={params.tag} tagInfo={tagInfo} />;
 }

package/routes-src/locale-docs-versions.tsx

@@ -1,10 +1,9 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
 // Package route entrypoint: /[locale]/docs/versions — package-owned equivalent
 // of pages/[locale]/docs/versions.tsx (A1 #2361). One route per non-default
 // locale; rendered by the shared package `VersionsPageView`.
 
-import type { JSX } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
 import { settings } from "./_context.js";
 import { VersionsPageView } from "./_chrome.js";
 
@@ -18,6 +17,6 @@ interface PageProps {
   params: { locale: string };
 }
 
-export default function LocaleVersionsPage({ params }: PageProps): JSX.Element {
+export default function LocaleVersionsPage({ params }: PageProps): Child {
   return <VersionsPageView locale={params.locale} />;
 }

package/routes-src/locale-files-path.tsx

@@ -1,7 +1,5 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-
-import type { JSX } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
 import recordsValue from "virtual:zudo-doc-asset-bodies";
 import type { AssetRecords } from "@takazudo/zudo-doc/plugins";
 import type { AssetIndexEntry } from "@takazudo/zudo-doc/route-context-payload";
@@ -56,7 +54,7 @@ type PageArgs = LocaleFilesPathProps & {
   params: { locale: string; path: string[] };
 };
 
-export default function LocaleFilesPathPage(props: PageArgs): JSX.Element {
+export default function LocaleFilesPathPage(props: PageArgs): Child {
   if (props.kind === "index") {
     return <AssetIndexPageView entries={props.entries} locale={props.params.locale} />;
   }