@takazudo/zudo-doc 0.2.21 → 1.0.0

package/dist/mdx-components/index.js

@@ -0,0 +1,161 @@
+import { toChildArray } from "preact";
+import { htmlOverrides } from "../content/index.js";
+import { makeAdmonition } from "../content-admonition/index.js";
+import { CodeGroup } from "../code-group/index.js";
+import { Tabs } from "../code-syntax/index.js";
+import { TabItem } from "../tab-item/index.js";
+import { MathBlock } from "../math-block/index.js";
+function makeContentImg(base) {
+  const normalizedBase = base.replace(/\/+$/, "");
+  return function ContentImg(props) {
+    const src = props.src;
+    const rewrittenSrc = typeof src === "string" && src.startsWith("/") && !src.startsWith("//") && normalizedBase !== "" ? `${normalizedBase}${src}` : src;
+    const { title, ...restProps } = props;
+    const finalTitle = title === "no-enlarge" ? void 0 : title;
+    const mergedProps = { ...restProps, src: rewrittenSrc };
+    if (finalTitle !== void 0) {
+      mergedProps.title = finalTitle;
+    }
+    return { type: "img", props: mergedProps, key: null, constructor: void 0 };
+  };
+}
+const ENLARGE_SVG = {
+  type: "svg",
+  props: {
+    viewBox: "0 0 38.99 38.99",
+    fill: "currentColor",
+    focusable: "false",
+    "aria-hidden": "true",
+    children: [
+      {
+        type: "polygon",
+        props: {
+          points: "16.2 13.74 5.92 3.47 11.2 3.47 11.2 0 3.47 0 0 0 0 3.47 0 11.2 3.47 11.2 3.47 5.92 13.74 16.2 16.2 13.74"
+        },
+        key: null,
+        constructor: void 0
+      },
+      {
+        type: "polygon",
+        props: {
+          points: "25.24 16.2 35.52 5.92 35.52 11.2 38.99 11.2 38.99 3.47 38.99 0 35.52 0 27.79 0 27.79 3.47 33.07 3.47 22.79 13.74 25.24 16.2"
+        },
+        key: null,
+        constructor: void 0
+      },
+      {
+        type: "polygon",
+        props: {
+          points: "22.79 25.24 33.07 35.52 27.79 35.52 27.79 38.99 35.52 38.99 38.99 38.99 38.99 35.52 38.99 27.79 35.52 27.79 35.52 33.07 25.24 22.79 22.79 25.24"
+        },
+        key: null,
+        constructor: void 0
+      },
+      {
+        type: "polygon",
+        props: {
+          points: "13.74 22.79 3.47 33.07 3.47 27.79 0 27.79 0 35.52 0 38.99 3.47 38.99 11.2 38.99 11.2 35.52 5.92 35.52 16.2 25.24 13.74 22.79"
+        },
+        key: null,
+        constructor: void 0
+      }
+    ]
+  },
+  key: null,
+  constructor: void 0
+};
+function makeEnlargeableParagraph(imageEnlarge, ContentImg) {
+  return function EnlargeableParagraph(props) {
+    const { children } = props;
+    const kids = toChildArray(children).filter((child) => {
+      if (typeof child === "string" || typeof child === "number") {
+        return String(child).trim() !== "";
+      }
+      return true;
+    });
+    if (imageEnlarge && kids.length === 1) {
+      const kid = kids[0];
+      if (kid !== null && typeof kid === "object" && "type" in kid && "props" in kid) {
+        const vnode = kid;
+        if (vnode.type === ContentImg || vnode.type === "img") {
+          const imgProps = vnode.props ?? {};
+          if (imgProps.title !== "no-enlarge") {
+            const enlargeBtn = {
+              type: "button",
+              props: {
+                type: "button",
+                class: "zd-enlarge-btn",
+                hidden: true,
+                "aria-label": "Enlarge image",
+                children: ENLARGE_SVG
+              },
+              key: null,
+              constructor: void 0
+            };
+            return {
+              type: "figure",
+              props: {
+                class: "zd-enlargeable",
+                children: [vnode, enlargeBtn]
+              },
+              key: null,
+              constructor: void 0
+            };
+          }
+        }
+      }
+    }
+    return htmlOverrides.p(props);
+  };
+}
+function createMdxComponents(options) {
+  const { settings, locale, navData, extras } = options;
+  const ContentImg = makeContentImg(settings.base);
+  const EnlargeableParagraph = makeEnlargeableParagraph(
+    settings.imageEnlarge,
+    ContentImg
+  );
+  const CategoryNavBound = (props) => navData.CategoryNav({ ...props, lang: locale });
+  const CategoryTreeNavBound = (props) => navData.CategoryTreeNav({ ...props, lang: locale });
+  const SiteTreeNavBound = (props) => navData.SiteTreeNav({ ...props, lang: locale });
+  return {
+    ...htmlOverrides,
+    // img override: rewrites root-relative src to include settings.base.
+    img: ContentImg,
+    // p override: wraps block-level images in <figure class="zd-enlargeable">.
+    // Must come AFTER ...htmlOverrides to override ContentParagraph.
+    p: EnlargeableParagraph,
+    // Admonitions — real typed Preact components emitting the
+    // `.admonition` / `data-admonition` structure the design-system CSS
+    // targets. `:::note` directives emit <Note>; `<Note title="…">` JSX is
+    // also authored directly. github-alerts [!IMPORTANT]/[!CAUTION] map to
+    // Important/Caution — omitting those two 500s their SSR render.
+    Note: makeAdmonition("note"),
+    Tip: makeAdmonition("tip"),
+    Info: makeAdmonition("info"),
+    Warning: makeAdmonition("warning"),
+    Danger: makeAdmonition("danger"),
+    Important: makeAdmonition("important"),
+    Caution: makeAdmonition("caution"),
+    // codeTabs Option A: zfb emits <CodeGroup tabs={[...]}> for :::code-group.
+    CodeGroup,
+    Tabs,
+    TabItem,
+    // Math — KaTeX via server-side katex.renderToString(). math-equations.mdx
+    // writes <MathBlock latex="…" block /> directly (zfb's Rust emitter does
+    // not yet support $$…$$ — zudo-front-builder #93).
+    MathBlock,
+    // Locale-bound nav wrappers (host-supplied; locale injected above).
+    // SiteTreeNav is reused for the SiteTreeNavDemo tag.
+    CategoryNav: CategoryNavBound,
+    CategoryTreeNav: CategoryTreeNavBound,
+    SiteTreeNav: SiteTreeNavBound,
+    SiteTreeNavDemo: SiteTreeNavBound,
+    // Host extras win over any same-named default above (Details, HtmlPreview,
+    // Island, PresetGenerator, showcase stubs, etc.).
+    ...extras ?? {}
+  };
+}
+export {
+  createMdxComponents
+};

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

@@ -0,0 +1,11 @@
+export declare function MermaidEnlarge(): import("preact").JSX.Element;
+export declare namespace MermaidEnlarge {
+    var displayName: string;
+}
+/**
+ * Static SSR fallback for the {@link MermaidEnlarge} island.
+ *
+ * Renders an empty, closed `<dialog class="zd-mermaid-dialog ...">` so the
+ * dist HTML carries the dialog shell even before hydration.
+ */
+export declare function MermaidEnlargeSsrFallback(): import("preact").JSX.Element;

package/dist/mermaid-enlarge/index.js

@@ -0,0 +1,290 @@
+"use client";
+import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+import { useState, useEffect, useRef, useCallback } from "preact/compat";
+import { AFTER_NAVIGATE_EVENT } from "../transitions/index.js";
+import { useModalDialog } from "../use-modal-dialog/index.js";
+import {
+  MERMAID_ENLARGE_DIALOG_CLASS,
+  ENLARGE_DIALOG_STYLE
+} from "../island-types/index.js";
+const CONTENT_SCOPE_SELECTOR = "main .zd-content";
+const DIAGRAM_SVG_SELECTOR = ":scope > svg";
+const BTN_INJECTED_ATTR = "data-mermaid-enlarge-ready";
+const ZOOM_STEP = 1.25;
+const MIN_SCALE = 1;
+const MAX_SCALE = 4;
+const ARROW_PAN_STEP = 40;
+function PlusIcon() {
+  return /* @__PURE__ */ jsxs("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", "aria-hidden": "true", focusable: "false", children: [
+    /* @__PURE__ */ jsx("line", { x1: "12", y1: "5", x2: "12", y2: "19" }),
+    /* @__PURE__ */ jsx("line", { x1: "5", y1: "12", x2: "19", y2: "12" })
+  ] });
+}
+function MinusIcon() {
+  return /* @__PURE__ */ jsx("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", "aria-hidden": "true", focusable: "false", children: /* @__PURE__ */ jsx("line", { x1: "5", y1: "12", x2: "19", y2: "12" }) });
+}
+function PanIcon() {
+  return /* @__PURE__ */ jsxs("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "1.6", strokeLinejoin: "round", strokeLinecap: "round", "aria-hidden": "true", focusable: "false", children: [
+    /* @__PURE__ */ jsx("path", { d: "M9 11V5.5a1.5 1.5 0 0 1 3 0V11" }),
+    /* @__PURE__ */ jsx("path", { d: "M12 11V4.5a1.5 1.5 0 0 1 3 0V11" }),
+    /* @__PURE__ */ jsx("path", { d: "M15 11V6a1.5 1.5 0 0 1 3 0v6.5a6.5 6.5 0 0 1-6.5 6.5h-1a6 6 0 0 1-4.6-2.16l-2.2-2.86a1.5 1.5 0 0 1 2.3-1.92L9 13" }),
+    /* @__PURE__ */ jsx("path", { d: "M9 11V8a1.5 1.5 0 0 0-3 0v5" })
+  ] });
+}
+function MermaidEnlarge() {
+  const [open, setOpen] = useState(null);
+  const [scale, setScale] = useState(1);
+  const [translate, setTranslate] = useState({ x: 0, y: 0 });
+  const [panActive, setPanActive] = useState(false);
+  const innerRef = useRef(null);
+  const dragState = useRef({ dragging: false, startX: 0, startY: 0, originX: 0, originY: 0 });
+  useEffect(() => {
+    let mutationObserver = null;
+    function injectButton(container) {
+      if (container.hasAttribute(BTN_INJECTED_ATTR)) return;
+      const rendered = container.hasAttribute("data-mermaid-rendered") || container.querySelector(DIAGRAM_SVG_SELECTOR) !== null;
+      if (!rendered) return;
+      container.setAttribute(BTN_INJECTED_ATTR, "");
+      container.classList.add("zd-mermaid-enlargeable");
+      const btn = document.createElement("button");
+      btn.type = "button";
+      btn.className = "zd-enlarge-btn";
+      btn.setAttribute("aria-label", "Enlarge diagram");
+      btn.innerHTML = '<svg viewBox="0 0 38.99 38.99" fill="currentColor" focusable="false" aria-hidden="true"><polygon points="16.2 13.74 5.92 3.47 11.2 3.47 11.2 0 3.47 0 0 0 0 3.47 0 11.2 3.47 11.2 3.47 5.92 13.74 16.2 16.2 13.74" /><polygon points="25.24 16.2 35.52 5.92 35.52 11.2 38.99 11.2 38.99 3.47 38.99 0 35.52 0 27.79 0 27.79 3.47 33.07 3.47 22.79 13.74 25.24 16.2" /><polygon points="22.79 25.24 33.07 35.52 27.79 35.52 27.79 38.99 35.52 38.99 38.99 38.99 38.99 35.52 38.99 27.79 35.52 27.79 35.52 33.07 25.24 22.79 22.79 25.24" /><polygon points="13.74 22.79 3.47 33.07 3.47 27.79 0 27.79 0 35.52 0 38.99 3.47 38.99 11.2 38.99 11.2 35.52 5.92 35.52 16.2 25.24 13.74 22.79" /></svg>';
+      container.appendChild(btn);
+    }
+    function scan() {
+      const scope = document.querySelector(CONTENT_SCOPE_SELECTOR);
+      if (!scope) return;
+      scope.querySelectorAll(".mermaid").forEach((el) => injectButton(el));
+    }
+    function startObserving() {
+      const scope = document.querySelector(CONTENT_SCOPE_SELECTOR);
+      if (scope) {
+        mutationObserver = new MutationObserver(() => scan());
+        mutationObserver.observe(scope, {
+          childList: true,
+          subtree: true,
+          attributes: true,
+          attributeFilter: ["data-mermaid-rendered"]
+        });
+      }
+      scan();
+    }
+    function handleAfterNavigate() {
+      mutationObserver?.disconnect();
+      mutationObserver = null;
+      startObserving();
+    }
+    startObserving();
+    document.addEventListener(AFTER_NAVIGATE_EVENT, handleAfterNavigate);
+    return () => {
+      mutationObserver?.disconnect();
+      document.removeEventListener(AFTER_NAVIGATE_EVENT, handleAfterNavigate);
+    };
+  }, []);
+  useEffect(() => {
+    function handleDocumentClick(e) {
+      const target = e.target;
+      const container = target.closest(".zd-mermaid-enlargeable");
+      if (!container) return;
+      if (!target.closest(".zd-enlarge-btn")) return;
+      const svg = container.querySelector(DIAGRAM_SVG_SELECTOR);
+      if (!svg) return;
+      setScale(1);
+      setTranslate({ x: 0, y: 0 });
+      setPanActive(false);
+      setOpen({ container, svgHtml: svg.outerHTML });
+    }
+    document.addEventListener("click", handleDocumentClick);
+    return () => document.removeEventListener("click", handleDocumentClick);
+  }, []);
+  useEffect(() => {
+    if (!open) return;
+    const { container } = open;
+    const observer = new MutationObserver(() => {
+      const svg = container.querySelector(DIAGRAM_SVG_SELECTOR);
+      if (svg && svg.outerHTML !== open.svgHtml) {
+        setOpen({ container, svgHtml: svg.outerHTML });
+      }
+    });
+    observer.observe(container, { childList: true, subtree: true });
+    return () => observer.disconnect();
+  }, [open]);
+  const handleClose = useCallback(() => setOpen(null), []);
+  const { dialogRef, handleBackdropClick } = useModalDialog({
+    isOpen: open !== null,
+    onClose: handleClose,
+    navigateEvent: AFTER_NAVIGATE_EVENT,
+    backdropClickClose: true
+  });
+  const zoomIn = useCallback(() => {
+    setScale((s) => Math.min(MAX_SCALE, s * ZOOM_STEP));
+  }, []);
+  const zoomOut = useCallback(() => {
+    setScale((s) => {
+      const next = Math.max(MIN_SCALE, s / ZOOM_STEP);
+      if (next <= MIN_SCALE) {
+        setTranslate({ x: 0, y: 0 });
+        setPanActive(false);
+      }
+      return next;
+    });
+  }, []);
+  const togglePan = useCallback(() => {
+    setPanActive((p) => !p);
+  }, []);
+  const clampTranslate = useCallback(
+    (x, y, s) => {
+      const inner = innerRef.current;
+      if (!inner) return { x, y };
+      const rect = inner.getBoundingClientRect();
+      const baseW = rect.width / s;
+      const baseH = rect.height / s;
+      const maxX = Math.max(0, (baseW * s - baseW) / 2);
+      const maxY = Math.max(0, (baseH * s - baseH) / 2);
+      return {
+        x: Math.max(-maxX, Math.min(maxX, x)),
+        y: Math.max(-maxY, Math.min(maxY, y))
+      };
+    },
+    []
+  );
+  const onPointerDown = useCallback(
+    (e) => {
+      if (!panActive || scale <= MIN_SCALE) return;
+      const d = dragState.current;
+      d.dragging = true;
+      d.startX = e.clientX;
+      d.startY = e.clientY;
+      d.originX = translate.x;
+      d.originY = translate.y;
+      e.currentTarget.setPointerCapture?.(e.pointerId);
+    },
+    [panActive, scale, translate]
+  );
+  const onPointerMove = useCallback(
+    (e) => {
+      const d = dragState.current;
+      if (!d.dragging) return;
+      const nextX = d.originX + (e.clientX - d.startX);
+      const nextY = d.originY + (e.clientY - d.startY);
+      setTranslate(clampTranslate(nextX, nextY, scale));
+    },
+    [scale, clampTranslate]
+  );
+  const onPointerUp = useCallback((e) => {
+    const d = dragState.current;
+    if (!d.dragging) return;
+    d.dragging = false;
+    e.currentTarget.releasePointerCapture?.(e.pointerId);
+  }, []);
+  const onViewportKeyDown = useCallback(
+    (e) => {
+      if (scale <= MIN_SCALE) return;
+      let dx = 0;
+      let dy = 0;
+      if (e.key === "ArrowLeft") dx = ARROW_PAN_STEP;
+      else if (e.key === "ArrowRight") dx = -ARROW_PAN_STEP;
+      else if (e.key === "ArrowUp") dy = ARROW_PAN_STEP;
+      else if (e.key === "ArrowDown") dy = -ARROW_PAN_STEP;
+      else return;
+      e.preventDefault();
+      setTranslate((t) => clampTranslate(t.x + dx, t.y + dy, scale));
+    },
+    [scale, clampTranslate]
+  );
+  const zoomed = scale > MIN_SCALE;
+  const atMax = scale >= MAX_SCALE;
+  return /* @__PURE__ */ jsx(
+    "dialog",
+    {
+      ref: dialogRef,
+      onClick: handleBackdropClick,
+      "aria-label": "Enlarged diagram",
+      className: MERMAID_ENLARGE_DIALOG_CLASS,
+      style: ENLARGE_DIALOG_STYLE,
+      children: open && /* @__PURE__ */ jsxs(Fragment, { children: [
+        /* @__PURE__ */ jsx(
+          "div",
+          {
+            className: "zd-mermaid-viewport",
+            tabIndex: 0,
+            onPointerDown,
+            onPointerMove,
+            onPointerUp,
+            onPointerCancel: onPointerUp,
+            onKeyDown: onViewportKeyDown,
+            "data-pan-active": panActive && zoomed ? "" : void 0,
+            children: /* @__PURE__ */ jsx(
+              "div",
+              {
+                ref: innerRef,
+                className: "zd-mermaid-transform",
+                style: {
+                  transform: `translate(${translate.x}px, ${translate.y}px) scale(${scale})`,
+                  transformOrigin: "center"
+                },
+                dangerouslySetInnerHTML: { __html: open.svgHtml }
+              }
+            )
+          }
+        ),
+        /* @__PURE__ */ jsxs("div", { className: "zd-mermaid-toolbar", role: "toolbar", "aria-label": "Diagram zoom controls", children: [
+          /* @__PURE__ */ jsx(
+            "button",
+            {
+              type: "button",
+              className: "zd-mermaid-tool-btn",
+              "aria-label": "Zoom in",
+              onClick: zoomIn,
+              disabled: atMax,
+              children: /* @__PURE__ */ jsx(PlusIcon, {})
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            "button",
+            {
+              type: "button",
+              className: "zd-mermaid-tool-btn",
+              "aria-label": "Zoom out",
+              onClick: zoomOut,
+              disabled: !zoomed,
+              children: /* @__PURE__ */ jsx(MinusIcon, {})
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            "button",
+            {
+              type: "button",
+              className: "zd-mermaid-tool-btn",
+              "aria-label": "Toggle pan mode",
+              "aria-pressed": panActive,
+              onClick: togglePan,
+              disabled: !zoomed,
+              children: /* @__PURE__ */ jsx(PanIcon, {})
+            }
+          )
+        ] }),
+        /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            onClick: () => dialogRef.current?.close(),
+            className: "zd-enlarge-dialog-close",
+            "aria-label": "Close enlarged diagram",
+            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" }) })
+          }
+        )
+      ] })
+    }
+  );
+}
+MermaidEnlarge.displayName = "MermaidEnlarge";
+function MermaidEnlargeSsrFallback() {
+  return /* @__PURE__ */ jsx("dialog", { "aria-label": "Enlarged diagram", className: MERMAID_ENLARGE_DIALOG_CLASS, style: ENLARGE_DIALOG_STYLE });
+}
+export {
+  MermaidEnlarge,
+  MermaidEnlargeSsrFallback
+};

package/dist/metainfo/doc-metainfo.d.ts

@@ -1,9 +1,7 @@
-import { VNode } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
-interface DocMetainfoProps {
+import type { VNode } from "preact";
+export interface DocMetainfoProps {
     /**
      * Pre-formatted creation date string (e.g. `"Jan 1, 2024"`).
      * The legacy `doc-metainfo` called `formatDate(gitInfo.createdAt,
@@ -31,8 +29,8 @@ interface DocMetainfoProps {
      */
     updatedLabel?: string;
 }
-declare const DEFAULT_CREATED_LABEL = "Created";
-declare const DEFAULT_UPDATED_LABEL = "Updated";
+export declare const DEFAULT_CREATED_LABEL = "Created";
+export declare const DEFAULT_UPDATED_LABEL = "Updated";
 /**
  * Document meta-information strip (created date, updated date, author)
  * — JSX port of `src/components/doc-metainfo`.
@@ -45,6 +43,4 @@ declare const DEFAULT_UPDATED_LABEL = "Updated";
  * Returns `null` when no displayable field is provided, mirroring the
  * original `hasInfo && (...)` guard.
  */
-declare function DocMetainfo(props: DocMetainfoProps): VNode | null;
-
-export { DEFAULT_CREATED_LABEL, DEFAULT_UPDATED_LABEL, DocMetainfo, type DocMetainfoProps };
+export declare function DocMetainfo(props: DocMetainfoProps): VNode | null;

package/dist/metainfo/doc-tags.d.ts

@@ -1,8 +1,6 @@
-import { VNode } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { VNode } from "preact";
 /**
  * A single resolved tag with its navigation href. The legacy
  * `doc-tags` called `resolvePageTags(tags)` and used `TagNav`
@@ -10,7 +8,7 @@ import { VNode } from 'preact';
  * caller so the component has no upward dependency on project routing
  * utilities.
  */
-interface ResolvedTag {
+export interface ResolvedTag {
     /** Raw tag string (e.g. `"typescript"`). */
     tag: string;
     /** Pre-computed href for the tag page. */
@@ -25,8 +23,8 @@ interface ResolvedTag {
  * - `"before-footer"` — extra top space, no bottom margin
  *   (`mt-vsp-xl mb-0`).
  */
-type TagPlacement = "after-title" | "before-footer";
-interface DocTagsProps {
+export type TagPlacement = "after-title" | "before-footer";
+export interface DocTagsProps {
     /**
      * Resolved tags with pre-computed hrefs. Pass an empty array (or
      * omit) to suppress rendering — mirrors the legacy
@@ -49,8 +47,8 @@ interface DocTagsProps {
      */
     taggedWithLabel?: string;
 }
-declare const DEFAULT_TAGS_LABEL = "Tags";
-declare const DEFAULT_TAGGED_WITH_LABEL = "Tagged with";
+export declare const DEFAULT_TAGS_LABEL = "Tags";
+export declare const DEFAULT_TAGGED_WITH_LABEL = "Tagged with";
 /**
  * Page-level tag chips — JSX port of `src/components/doc-tags`
  * (page-variant rendering from `src/components/tag-nav`).
@@ -61,6 +59,4 @@ declare const DEFAULT_TAGGED_WITH_LABEL = "Tagged with";
  * The pointed-chip shape is reproduced verbatim from the page-variant
  * branch of `tag-nav` using the same `clip-path` values.
  */
-declare function DocTags(props: DocTagsProps): VNode | null;
-
-export { DEFAULT_TAGGED_WITH_LABEL, DEFAULT_TAGS_LABEL, DocTags, type DocTagsProps, type ResolvedTag, type TagPlacement };
+export declare function DocTags(props: DocTagsProps): VNode | null;

package/dist/metainfo/frontmatter-preview.d.ts

@@ -1,8 +1,6 @@
-import { ComponentChildren, VNode } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { ComponentChildren, VNode } from "preact";
 /**
  * Props passed to a per-key custom renderer component.
  *
@@ -10,7 +8,7 @@ import { ComponentChildren, VNode } from 'preact';
  * before invoking `FrontmatterPreview`. Renderers are therefore guaranteed
  * to receive only non-null, non-ignored values.
  */
-interface FrontmatterCellRendererProps {
+export interface FrontmatterCellRendererProps {
     /** The frontmatter value (null/undefined values are never passed). */
     value: NonNullable<unknown>;
     /** The frontmatter key name. */
@@ -26,8 +24,8 @@ interface FrontmatterCellRendererProps {
  * Return `null` or `undefined` to fall through to the built-in
  * `renderValue()` plain-text path.
  */
-type FrontmatterCellRenderer = (props: FrontmatterCellRendererProps) => ComponentChildren;
-interface FrontmatterPreviewProps {
+export type FrontmatterCellRenderer = (props: FrontmatterCellRendererProps) => ComponentChildren;
+export interface FrontmatterPreviewProps {
     /**
      * Pre-filtered `[key, value]` pairs to display. The legacy component
      * owned the filtering logic (ignore-keys, null/undefined removal,
@@ -76,9 +74,9 @@ interface FrontmatterPreviewProps {
      */
     locale?: string;
 }
-declare const DEFAULT_FRONTMATTER_PREVIEW_TITLE = "Frontmatter";
-declare const DEFAULT_KEY_COL_LABEL = "Key";
-declare const DEFAULT_VALUE_COL_LABEL = "Value";
+export declare const DEFAULT_FRONTMATTER_PREVIEW_TITLE = "Frontmatter";
+export declare const DEFAULT_KEY_COL_LABEL = "Key";
+export declare const DEFAULT_VALUE_COL_LABEL = "Value";
 /**
  * Frontmatter data table — JSX port of
  * `src/components/frontmatter-preview`.
@@ -90,6 +88,4 @@ declare const DEFAULT_VALUE_COL_LABEL = "Value";
  * the matching renderer. A renderer that returns `null` or `undefined` falls
  * through to the built-in `renderValue()` plain-text path.
  */
-declare function FrontmatterPreview(props: FrontmatterPreviewProps): VNode | null;
-
-export { DEFAULT_FRONTMATTER_PREVIEW_TITLE, DEFAULT_KEY_COL_LABEL, DEFAULT_VALUE_COL_LABEL, type FrontmatterCellRenderer, type FrontmatterCellRendererProps, FrontmatterPreview, type FrontmatterPreviewProps };
+export declare function FrontmatterPreview(props: FrontmatterPreviewProps): VNode | null;

package/dist/metainfo/index.d.ts

@@ -1,4 +1,6 @@
-export { DEFAULT_CREATED_LABEL, DEFAULT_UPDATED_LABEL, DocMetainfo, DocMetainfoProps } from './doc-metainfo.js';
-export { DEFAULT_TAGGED_WITH_LABEL, DEFAULT_TAGS_LABEL, DocTags, DocTagsProps, ResolvedTag, TagPlacement } from './doc-tags.js';
-export { DEFAULT_FRONTMATTER_PREVIEW_TITLE, DEFAULT_KEY_COL_LABEL, DEFAULT_VALUE_COL_LABEL, FrontmatterCellRenderer, FrontmatterCellRendererProps, FrontmatterPreview, FrontmatterPreviewProps } from './frontmatter-preview.js';
-import 'preact';
+export { DocMetainfo, DEFAULT_CREATED_LABEL, DEFAULT_UPDATED_LABEL, } from "./doc-metainfo.js";
+export type { DocMetainfoProps } from "./doc-metainfo.js";
+export { DocTags, DEFAULT_TAGS_LABEL, DEFAULT_TAGGED_WITH_LABEL, } from "./doc-tags.js";
+export type { DocTagsProps, ResolvedTag, TagPlacement } from "./doc-tags.js";
+export { FrontmatterPreview, DEFAULT_FRONTMATTER_PREVIEW_TITLE, DEFAULT_KEY_COL_LABEL, DEFAULT_VALUE_COL_LABEL, } from "./frontmatter-preview.js";
+export type { FrontmatterPreviewProps, FrontmatterCellRenderer, FrontmatterCellRendererProps, } from "./frontmatter-preview.js";

package/dist/nav-data-prep/index.d.ts

@@ -0,0 +1,72 @@
+import type { LocaleLink } from "../url-helpers/index.js";
+export type { LocaleLink };
+/** Minimal nav node shape required by nav-data-prep functions. */
+export interface NavDataPrepNode {
+    slug: string;
+    href?: string;
+    label: string;
+    children: NavDataPrepNode[];
+}
+/** Minimal headerNav item shape the nav-data-prep functions need. */
+export interface NavDataPrepHeaderNavItem {
+    label: string;
+    labelKey?: string;
+    path: string;
+    children?: Array<{
+        label: string;
+        labelKey?: string;
+        path: string;
+    }>;
+}
+/** Color mode config shape (subset of settings.colorMode). */
+export interface NavDataPrepColorMode {
+    defaultMode?: string;
+}
+/** Root-menu item emitted by {@link buildRootMenuItems}. */
+export interface RootMenuItem {
+    label: string;
+    href: string;
+    children?: Array<{
+        label: string;
+        href: string;
+    }>;
+}
+/**
+ * Walk the nav tree and rewrite each node's `href` to its versioned form.
+ *
+ * `buildNavTree` always emits hrefs via `docsUrl()`; when the active route
+ * lives under `/v/{version}/...` we need the same nodes pointing at the
+ * versioned URL so internal nav clicks stay inside the version. Skips
+ * nodes without an href (link-only or category placeholders).
+ *
+ * Parameterized version of `remapVersionedHrefs` from `_nav-data-prep.ts` —
+ * receives `versionedDocsUrl` as an argument instead of importing from `@/utils/base`.
+ *
+ * Generic so callers can pass their concrete node type and get back the same
+ * type without an unsafe cast.
+ */
+export declare function remapVersionedHrefs<T extends NavDataPrepNode>(nodes: T[], version: string, nodeLang: string, versionedDocsUrl: (slug: string, version: string, lang: string) => string): T[];
+/**
+ * Root-menu items derived from headerNav (mobile "back to menu" list).
+ *
+ * Parameterized version of `buildRootMenuItems` from `_nav-data-prep.ts` —
+ * receives the headerNav, `t()`, and `navHref` as arguments instead of
+ * importing from `@/config/settings`, `@/config/i18n`, `@/utils/base`.
+ */
+export declare function buildRootMenuItems(lang: string, currentVersion: string | undefined, headerNav: NavDataPrepHeaderNavItem[], t: (key: string, lang: string) => string, navHref: (path: string, lang: string | undefined, version: string | undefined) => string): RootMenuItem[];
+/**
+ * Locale-switcher links for the mobile sidebar footer and language switcher.
+ * Returns `undefined` when only one locale is configured (single-locale guard).
+ *
+ * Parameterized version of `buildLocaleLinksForNav` from `_nav-data-prep.ts`.
+ */
+export declare function buildLocaleLinksForNav(currentPath: string, lang: string, localeCount: number, buildLocaleLinks: (path: string, lang: string) => LocaleLink[]): LocaleLink[] | undefined;
+/**
+ * Extract the configured default color mode from the colorMode setting.
+ * Returns `undefined` when color mode is not configured (single-scheme projects).
+ * Only the string values `"light"` and `"dark"` are returned — any other
+ * `defaultMode` value is treated as absent.
+ *
+ * Parameterized version of `getThemeDefaultMode` from `_nav-data-prep.ts`.
+ */
+export declare function getThemeDefaultMode(colorMode: NavDataPrepColorMode | null | undefined | false): "light" | "dark" | undefined;