@takazudo/zudo-doc 5.28.2 → 6.0.1

package/dist/icons/index.js

@@ -1,9 +1,8 @@
-import { jsx, jsxs } from "preact/jsx-runtime";
-function ChevronRight({ className }) {
+import { jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
+function ChevronRight({ class: className }) {
   return /* @__PURE__ */ jsx(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",
@@ -14,11 +13,10 @@ function ChevronRight({ className }) {
     }
   );
 }
-function ChevronLeft({ className }) {
+function ChevronLeft({ class: className }) {
   return /* @__PURE__ */ jsx(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",
@@ -29,11 +27,10 @@ function ChevronLeft({ className }) {
     }
   );
 }
-function Search({ className }) {
+function Search({ class: className }) {
   return /* @__PURE__ */ jsx(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",
@@ -44,11 +41,10 @@ function Search({ className }) {
     }
   );
 }
-function History({ className }) {
+function History({ class: className }) {
   return /* @__PURE__ */ jsxs(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       viewBox: "0 0 24 24",
       fill: "none",
@@ -64,11 +60,10 @@ function History({ className }) {
     }
   );
 }
-function Close({ className }) {
+function Close({ class: className }) {
   return /* @__PURE__ */ jsx(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       viewBox: "0 0 24 24",
       fill: "none",
@@ -81,11 +76,10 @@ function Close({ className }) {
     }
   );
 }
-function ArrowLeft({ className }) {
+function ArrowLeft({ class: className }) {
   return /* @__PURE__ */ jsx(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       viewBox: "0 0 24 24",
       fill: "none",
@@ -98,11 +92,10 @@ function ArrowLeft({ className }) {
     }
   );
 }
-function GitHub({ className }) {
+function GitHub({ class: className }) {
   return /* @__PURE__ */ jsx(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       width: "20",
       height: "20",
       viewBox: "0 0 24 24",
@@ -113,11 +106,10 @@ function GitHub({ className }) {
     }
   );
 }
-function Folder({ className }) {
+function Folder({ class: className }) {
   return /* @__PURE__ */ jsx(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",
@@ -135,11 +127,10 @@ function Folder({ className }) {
     }
   );
 }
-function FolderOpen({ className }) {
+function FolderOpen({ class: className }) {
   return /* @__PURE__ */ jsxs(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",
@@ -167,11 +158,10 @@ function FolderOpen({ className }) {
     }
   );
 }
-function FileGeneric({ className }) {
+function FileGeneric({ class: className }) {
   return /* @__PURE__ */ jsxs(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",
@@ -192,11 +182,10 @@ function FileGeneric({ className }) {
     }
   );
 }
-function FileCode({ className }) {
+function FileCode({ class: className }) {
   return /* @__PURE__ */ jsxs(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",
@@ -219,11 +208,10 @@ function FileCode({ className }) {
     }
   );
 }
-function FileText({ className }) {
+function FileText({ class: className }) {
   return /* @__PURE__ */ jsxs(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",
@@ -246,11 +234,10 @@ function FileText({ className }) {
     }
   );
 }
-function FileImage({ className }) {
+function FileImage({ class: className }) {
   return /* @__PURE__ */ jsxs(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",
@@ -265,11 +252,10 @@ function FileImage({ className }) {
     }
   );
 }
-function FileVideo({ className }) {
+function FileVideo({ class: className }) {
   return /* @__PURE__ */ jsxs(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",
@@ -283,11 +269,10 @@ function FileVideo({ className }) {
     }
   );
 }
-function FilePdf({ className }) {
+function FilePdf({ class: className }) {
   return /* @__PURE__ */ jsxs(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",
@@ -324,11 +309,10 @@ function FilePdf({ className }) {
     }
   );
 }
-function FileArchive({ className }) {
+function FileArchive({ class: className }) {
   return /* @__PURE__ */ jsxs(
     "svg",
     {
-      xmlns: "http://www.w3.org/2000/svg",
       class: className || void 0,
       fill: "none",
       viewBox: "0 0 24 24",

package/dist/image-enlarge/index.d.ts

@@ -1,13 +1,4 @@
-export declare function ImageEnlarge(): import("preact").JSX.Element;
+export declare function ImageEnlarge(): import("@takazudo/zfb").Description;
 export declare namespace ImageEnlarge {
     var displayName: string;
 }
-/**
- * Static SSR fallback for the {@link ImageEnlarge} island.
- *
- * Renders an empty, closed `<dialog class="zd-enlarge-dialog ...">` so the
- * dist HTML carries the dialog shell even before hydration. Sources its
- * class and inline style from the shared constants in island-types so the
- * SSR fallback cannot drift from the hydrated dialog above.
- */
-export declare function ImageEnlargeSsrFallback(): import("preact").JSX.Element;

package/dist/image-enlarge/index.js

@@ -1,17 +1,28 @@
 "use client";
-import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
-import { useState, useEffect } from "preact/compat";
+import { Fragment, jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
+import { computed, getScope, Show, signal } from "@takazudo/zfb/zudo-react";
 import { AFTER_NAVIGATE_EVENT } from "../transitions/index.js";
-import { useModalDialog } from "../use-modal-dialog/index.js";
+import { modalDialog } from "../use-modal-dialog/index.js";
 import {
   IMAGE_ENLARGE_DIALOG_CLASS,
   ENLARGE_DIALOG_STYLE
 } from "../island-types/index.js";
 function ImageEnlarge() {
-  const [imgData, setImgData] = useState(null);
-  useEffect(() => {
+  const scope = getScope();
+  const imgData = signal(null);
+  const isOpen = computed(() => imgData.value !== null);
+  const imageSrc = computed(() => {
+    const current = imgData.value;
+    return current ? current.currentSrc || current.src : "";
+  });
+  const imageSrcset = computed(() => imgData.value?.srcset ?? "");
+  const imageHasSrcset = computed(() => Boolean(imgData.value?.srcset));
+  const imageAlt = computed(() => imgData.value?.alt ?? "");
+  scope.onActivate(() => {
+    let active = true;
     const observedImages = /* @__PURE__ */ new Set();
     const sharedResizeObserver = new ResizeObserver((entries) => {
+      if (!active) return;
       for (const entry of entries) {
         evaluateEligibility(entry.target);
       }
@@ -46,35 +57,41 @@ function ImageEnlarge() {
       }
     }
     function scanContent() {
-      const scope = document.querySelector("main .zd-content");
-      if (!scope) return;
-      scope.querySelectorAll(".zd-enlargeable img").forEach(observeImage);
+      const content = document.querySelector("main .zd-content");
+      if (!content) return;
+      content.querySelectorAll(".zd-enlargeable img").forEach(observeImage);
     }
     function startObserving() {
-      const scope = document.querySelector("main .zd-content");
-      if (scope) {
+      const content = document.querySelector("main .zd-content");
+      if (content) {
         mutationObserver = new MutationObserver((mutations) => {
+          if (!active) return;
           for (const mutation of mutations) {
             for (const node of mutation.addedNodes) {
               if (!(node instanceof Element)) continue;
               if (node.matches(".zd-enlargeable")) {
                 node.querySelectorAll("img").forEach(observeImage);
               }
+              if (node instanceof HTMLImageElement && node.closest(".zd-enlargeable")) {
+                observeImage(node);
+              }
               node.querySelectorAll(".zd-enlargeable img").forEach(observeImage);
             }
           }
         });
-        mutationObserver.observe(scope, { childList: true, subtree: true });
+        mutationObserver.observe(content, { childList: true, subtree: true });
       }
       scanContent();
     }
     function handleWindowResize() {
       clearTimeout(resizeTimer);
       resizeTimer = window.setTimeout(() => {
+        if (!active) return;
         observedImages.forEach((img) => evaluateEligibility(img));
       }, 150);
     }
-    function handleAfterSwap() {
+    function handleAfterNavigate() {
+      if (!active) return;
       sharedResizeObserver.disconnect();
       observedImages.clear();
       mutationObserver?.disconnect();
@@ -85,22 +102,25 @@ function ImageEnlarge() {
     }
     startObserving();
     window.addEventListener("resize", handleWindowResize);
-    document.addEventListener(AFTER_NAVIGATE_EVENT, handleAfterSwap);
+    document.addEventListener(AFTER_NAVIGATE_EVENT, handleAfterNavigate);
     return () => {
+      active = false;
       sharedResizeObserver.disconnect();
       observedImages.clear();
       mutationObserver?.disconnect();
       loadAbortController.abort();
       window.removeEventListener("resize", handleWindowResize);
-      document.removeEventListener(AFTER_NAVIGATE_EVENT, handleAfterSwap);
+      document.removeEventListener(AFTER_NAVIGATE_EVENT, handleAfterNavigate);
       clearTimeout(resizeTimer);
     };
-  }, []);
-  useEffect(() => {
-    function handleDocumentClick(e) {
-      const sel = window.getSelection();
-      if (sel && !sel.isCollapsed) return;
-      const target = e.target;
+  });
+  scope.onActivate(() => {
+    let active = true;
+    function handleDocumentClick(event) {
+      if (!active || !(event.target instanceof Element)) return;
+      const target = event.target;
+      const selection = window.getSelection();
+      if (selection && !selection.isCollapsed) return;
       const container = target.closest(".zd-enlargeable");
       if (!container) return;
       if (!target.closest(".zd-enlarge-btn") && !target.closest("img")) return;
@@ -108,7 +128,7 @@ function ImageEnlarge() {
       if (!btn || btn.hasAttribute("hidden")) return;
       const img = container.querySelector("img");
       if (!img) return;
-      setImgData({
+      imgData.value = {
         src: img.src,
         currentSrc: img.currentSrc,
         srcset: img.srcset || void 0,
@@ -116,14 +136,19 @@ function ImageEnlarge() {
         alt: img.alt,
         naturalWidth: img.naturalWidth,
         naturalHeight: img.naturalHeight
-      });
+      };
     }
     document.addEventListener("click", handleDocumentClick);
-    return () => document.removeEventListener("click", handleDocumentClick);
-  }, []);
-  const handleClose = () => setImgData(null);
-  const { dialogRef, handleBackdropClick } = useModalDialog({
-    isOpen: imgData !== null,
+    return () => {
+      active = false;
+      document.removeEventListener("click", handleDocumentClick);
+    };
+  });
+  const handleClose = () => {
+    imgData.value = null;
+  };
+  const { dialogRef, handleBackdropClick } = modalDialog(scope, {
+    isOpen,
     onClose: handleClose,
     navigateEvent: AFTER_NAVIGATE_EVENT,
     backdropClickClose: true
@@ -132,45 +157,45 @@ function ImageEnlarge() {
     "dialog",
     {
       ref: dialogRef,
-      onClick: handleBackdropClick,
-      className: IMAGE_ENLARGE_DIALOG_CLASS,
+      "on:click": handleBackdropClick,
+      class: IMAGE_ENLARGE_DIALOG_CLASS,
       style: ENLARGE_DIALOG_STYLE,
-      children: imgData && /* @__PURE__ */ jsxs(Fragment, { children: [
-        /* @__PURE__ */ jsx("div", { className: "relative", children: /* @__PURE__ */ jsx(
-          "img",
-          {
-            src: imgData.currentSrc || imgData.src,
-            srcSet: imgData.srcset,
-            sizes: imgData.srcset ? "85vw" : void 0,
-            alt: imgData.alt,
-            className: "block max-h-[85vh] max-w-[85vw] object-contain"
-          }
-        ) }),
+      children: /* @__PURE__ */ jsx(Show, { when: isOpen, children: () => /* @__PURE__ */ jsxs(Fragment, { children: [
+        /* @__PURE__ */ jsxs("div", { class: "relative", children: [
+          /* @__PURE__ */ jsx(Show, { when: imageHasSrcset, children: () => /* @__PURE__ */ jsx(
+            "img",
+            {
+              src: imageSrc,
+              srcset: imageSrcset,
+              sizes: "85vw",
+              alt: imageAlt,
+              class: "block max-h-[85vh] max-w-[85vw] object-contain"
+            }
+          ) }),
+          /* @__PURE__ */ jsx(Show, { when: computed(() => !imageHasSrcset.value), children: () => /* @__PURE__ */ jsx(
+            "img",
+            {
+              src: imageSrc,
+              alt: imageAlt,
+              class: "block max-h-[85vh] max-w-[85vw] object-contain"
+            }
+          ) })
+        ] }),
         /* @__PURE__ */ jsx(
           "button",
           {
             type: "button",
-            onClick: () => dialogRef.current?.close(),
-            className: "zd-enlarge-dialog-close",
+            "on:click": () => dialogRef.current?.close(),
+            class: "zd-enlarge-dialog-close",
             "aria-label": "Close enlarged image",
-            children: /* @__PURE__ */ jsx("svg", { viewBox: "0 0 161.03 161.03", fill: "currentColor", "aria-hidden": "true", focusable: "false", children: /* @__PURE__ */ jsx("polygon", { points: "161.03 10.27 150.76 0 80.51 70.24 10.27 0 0 10.27 70.24 80.51 0 150.76 10.27 161.03 80.51 90.78 150.76 161.03 161.03 150.76 90.78 80.51 161.03 10.27" }) })
+            children: /* @__PURE__ */ jsx("svg", { viewBox: "0 0 161.03 161.03", fill: "currentColor", "aria-hidden": "true", children: /* @__PURE__ */ jsx("polygon", { points: "161.03 10.27 150.76 0 80.51 70.24 10.27 0 0 10.27 70.24 80.51 0 150.76 10.27 161.03 80.51 90.78 150.76 161.03 161.03 150.76 90.78 80.51 161.03 10.27" }) })
           }
         )
-      ] })
+      ] }) })
     }
   );
 }
 ImageEnlarge.displayName = "ImageEnlarge";
-function ImageEnlargeSsrFallback() {
-  return /* @__PURE__ */ jsx(
-    "dialog",
-    {
-      className: IMAGE_ENLARGE_DIALOG_CLASS,
-      style: ENLARGE_DIALOG_STYLE
-    }
-  );
-}
 export {
-  ImageEnlarge,
-  ImageEnlargeSsrFallback
+  ImageEnlarge
 };

package/dist/image-enlarge/public.d.ts

@@ -0,0 +1,2 @@
+export { ImageEnlarge } from "./index.js";
+export { ImageEnlargeSsrFallback } from "./ssr-fallback.js";

package/dist/image-enlarge/public.js

@@ -0,0 +1,6 @@
+import { ImageEnlarge } from "./index.js";
+import { ImageEnlargeSsrFallback } from "./ssr-fallback.js";
+export {
+  ImageEnlarge,
+  ImageEnlargeSsrFallback
+};

package/dist/image-enlarge/ssr-fallback.d.ts

@@ -0,0 +1,2 @@
+/** Closed dialog shell rendered before island activation. */
+export declare function ImageEnlargeSsrFallback(): import("@takazudo/zfb").Description;

package/dist/image-enlarge/ssr-fallback.js

@@ -0,0 +1,8 @@
+import { jsx } from "@takazudo/zfb/zudo-react/jsx-runtime";
+import { IMAGE_ENLARGE_DIALOG_CLASS, ENLARGE_DIALOG_STYLE } from "../island-types/index.js";
+function ImageEnlargeSsrFallback() {
+  return /* @__PURE__ */ jsx("dialog", { class: IMAGE_ENLARGE_DIALOG_CLASS, style: ENLARGE_DIALOG_STYLE });
+}
+export {
+  ImageEnlargeSsrFallback
+};

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 /**
  * @takazudo/zudo-doc — framework primitives that sit on top of zfb's engine.
  *
- * **Use the subpath exports for actual imports.** This root barrel deliberately
- * stays empty so consumers don't drag in the entire framework when they only
- * need one piece. Each topic area publishes its own subpath (declared in
+ * **Use the subpath exports for runtime imports.** This root barrel exposes
+ * shared public types only, so consumers do not drag in runtime code when they
+ * need type contracts. Each topic area publishes its own subpath (declared in
  * `package.json#exports`):
  *
  *   import { buildSidebarTree, type SidebarNode } from "@takazudo/zudo-doc/sidebar-tree";
@@ -23,4 +23,11 @@
  *
  * See packages/zudo-doc/README.md for the topic map.
  */
-export {};
+export type { ChromeContext, ChromeHostBindings, FactoryComponent, FactoryComponents, FactoryContext, FactoryI18n, NavSource, RouteContext, RouteContextPayload, RouteHrefBuilder, TagInfo, } from "./factory-context/index.js";
+export type { BodyEndIslandsSlotProps, BreadcrumbSlotProps, ChromeBindingsInput, DesignTokenPanelBootstrapSlotProps, DocHistorySlotProps, DocPagerSlotProps, FooterSlotProps, FooterTagEntry, FrontmatterRendererSlotProps, HeaderSlotProps, SearchWidgetSlotProps, SidebarSlotProps, TocSlotProps, } from "./chrome-bindings.js";
+export type { HeaderNavChildItem, HeaderNavItem, HeaderRightBuiltinComponentName, HeaderRightComponentItem, HeaderRightComponentName, HeaderRightComponentProps, HeaderRightComponentRegistry, HeaderRightHtmlItem, HeaderRightItem, HeaderRightLinkItem, HeaderRightTriggerItem, HeaderRightTriggerName, Locale, } from "./header/types.js";
+export type { HeaderRightItemFlags } from "./header/right-items.js";
+export type { FrontmatterCellRenderer, FrontmatterCellRendererProps, } from "./metainfo/frontmatter-preview.js";
+export type { ThemePackDialogComponent, ThemePackDialogProps, } from "./theme-pack-switcher/index.js";
+export type { ModalDialogOptions, ModalDialogResult } from "./use-modal-dialog/index.js";
+export type { ChatMessage, DocHistoryData, DocHistoryEntry, EnlargeDialogProps, } from "./island-types/index.js";

package/dist/inline-version-switcher/index.d.ts

@@ -1,6 +1,5 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-import type { JSX } from "preact";
+import type { JSX } from "@takazudo/zfb/zudo-react/jsx-runtime";
 /** Minimal version config entry needed by the inline version switcher. */
 export interface InlineVersionSwitcherVersionEntry {
     slug: string;

package/dist/inline-version-switcher/index.js

@@ -1,4 +1,4 @@
-import { jsx } from "preact/jsx-runtime";
+import { jsx } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import {
   VersionSwitcher
 } from "../i18n-version/index.js";

package/dist/island-types/index.d.ts

@@ -28,7 +28,7 @@ export interface DocHistoryData {
 /** Shared inline style centering an enlarge `<dialog>` transform-free. */
 export declare const ENLARGE_DIALOG_STYLE: {
     readonly position: "fixed";
-    readonly inset: "0";
+    readonly inset: 0;
     readonly margin: "auto";
 };
 /** Class string for the image-enlarge `<dialog>` (hydrated + SSR fallback). */
@@ -38,7 +38,7 @@ export declare const MERMAID_ENLARGE_DIALOG_CLASS = "zd-mermaid-dialog z-modal m
 /** Shared shape an enlarge `<dialog>` is rendered with. */
 export interface EnlargeDialogProps {
     /** Tailwind class string for the `<dialog>`. */
-    className: string;
+    class: string;
     /** Inline style centering the dialog transform-free. */
     style: typeof ENLARGE_DIALOG_STYLE;
 }

package/dist/island-types/index.js

@@ -1,8 +1,4 @@
-const ENLARGE_DIALOG_STYLE = {
-  position: "fixed",
-  inset: "0",
-  margin: "auto"
-};
+const ENLARGE_DIALOG_STYLE = { position: "fixed", inset: 0, margin: "auto" };
 const IMAGE_ENLARGE_DIALOG_CLASS = "zd-enlarge-dialog z-modal mx-auto max-h-[90vh] max-w-[90vw] overflow-hidden border border-muted bg-surface p-0 backdrop:z-modal-backdrop";
 const MERMAID_ENLARGE_DIALOG_CLASS = "zd-mermaid-dialog z-modal mx-auto h-[90vh] max-h-[90vh] w-[90vw] max-w-[90vw] overflow-hidden border border-muted bg-surface p-0 backdrop:z-modal-backdrop";
 export {

package/dist/math-block/index.d.ts

@@ -1,6 +1,5 @@
 /** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-import type { VNode } from "preact";
+import type { Child } from "@takazudo/zfb/zudo-react";
 export interface MathBlockProps {
     /** Raw LaTeX source string. */
     latex: string;
@@ -10,9 +9,7 @@ export interface MathBlockProps {
 /**
  * Server-rendered KaTeX math component.
  *
- * Block mode wraps the output in `<div class="math math-display">`;
- * inline mode uses `<span class="math math-inline">`. The class names
- * match the standard rehype-katex output so existing CSS (e.g. the
- * KaTeX stylesheet) still applies.
+ * Block mode wraps the output in `<div data-math="display">`; inline mode
+ * uses `<span data-math="inline">`. KaTeX owns the styled inner classes.
  */
-export declare function MathBlock({ latex, block }: MathBlockProps): VNode;
+export declare function MathBlock({ latex, block }: MathBlockProps): Child;

package/dist/math-block/index.js

@@ -1,4 +1,4 @@
-import { jsx } from "preact/jsx-runtime";
+import { jsx } from "@takazudo/zfb/zudo-react/jsx-runtime";
 function pickKatex(m) {
   let cur = m;
   for (let i = 0; i < 3 && cur && typeof cur === "object"; i++) {
@@ -21,16 +21,16 @@ function MathBlock({ latex, block = false }) {
     return /* @__PURE__ */ jsx(
       "div",
       {
-        class: "math math-display",
-        dangerouslySetInnerHTML: { __html: html }
+        "data-math": "display",
+        rawHtml: html
       }
     );
   }
   return /* @__PURE__ */ jsx(
     "span",
     {
-      class: "math math-inline",
-      dangerouslySetInnerHTML: { __html: html }
+      "data-math": "inline",
+      rawHtml: html
     }
   );
 }

package/dist/mcp/handler.d.ts

@@ -0,0 +1,8 @@
+import { type ReadAsset } from "./loader.js";
+export interface McpHandlerOptions {
+    read: ReadAsset;
+    base: string;
+    siteUrl?: string;
+}
+/** A deployment-scoped loader is safe to reuse; every operation re-reads the current manifest. */
+export declare function createMcpHandler(options: McpHandlerOptions): (request: Request) => Promise<Response>;