@takazudo/zudo-doc 0.1.0

package/dist/metainfo/doc-metainfo.js

@@ -0,0 +1,107 @@
+import { jsx, jsxs } from "preact/jsx-runtime";
+const DEFAULT_CREATED_LABEL = "Created";
+const DEFAULT_UPDATED_LABEL = "Updated";
+function ClockIcon() {
+  return /* @__PURE__ */ jsx(
+    "svg",
+    {
+      xmlns: "http://www.w3.org/2000/svg",
+      class: "h-icon-xs w-icon-xs",
+      fill: "none",
+      viewBox: "0 0 24 24",
+      stroke: "currentColor",
+      "stroke-width": "2",
+      "aria-hidden": "true",
+      children: /* @__PURE__ */ jsx(
+        "path",
+        {
+          "stroke-linecap": "round",
+          "stroke-linejoin": "round",
+          d: "M12 6v6l4 2m6-2a9 9 0 11-18 0 9 9 0 0118 0z"
+        }
+      )
+    }
+  );
+}
+function RefreshIcon() {
+  return /* @__PURE__ */ jsx(
+    "svg",
+    {
+      xmlns: "http://www.w3.org/2000/svg",
+      class: "h-icon-xs w-icon-xs",
+      fill: "none",
+      viewBox: "0 0 24 24",
+      stroke: "currentColor",
+      "stroke-width": "2",
+      "aria-hidden": "true",
+      children: /* @__PURE__ */ jsx(
+        "path",
+        {
+          "stroke-linecap": "round",
+          "stroke-linejoin": "round",
+          d: "M4 4v5h.582m15.356 2A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15"
+        }
+      )
+    }
+  );
+}
+function UserIcon() {
+  return /* @__PURE__ */ jsx(
+    "svg",
+    {
+      xmlns: "http://www.w3.org/2000/svg",
+      class: "h-icon-xs w-icon-xs",
+      fill: "none",
+      viewBox: "0 0 24 24",
+      stroke: "currentColor",
+      "stroke-width": "2",
+      "aria-hidden": "true",
+      children: /* @__PURE__ */ jsx(
+        "path",
+        {
+          "stroke-linecap": "round",
+          "stroke-linejoin": "round",
+          d: "M16 7a4 4 0 11-8 0 4 4 0 018 0zM12 14a7 7 0 00-7 7h14a7 7 0 00-7-7z"
+        }
+      )
+    }
+  );
+}
+function DocMetainfo(props) {
+  const {
+    createdAt,
+    updatedAt,
+    author,
+    createdLabel = DEFAULT_CREATED_LABEL,
+    updatedLabel = DEFAULT_UPDATED_LABEL
+  } = props;
+  const hasInfo = Boolean(createdAt) || Boolean(updatedAt) && updatedAt !== createdAt || Boolean(author);
+  if (!hasInfo) return null;
+  return /* @__PURE__ */ jsxs("div", { class: "flex flex-wrap items-center gap-x-hsp-md gap-y-vsp-2xs text-caption text-fg mb-vsp-md border-t border-fg pt-vsp-xs", children: [
+    createdAt && /* @__PURE__ */ jsxs("span", { class: "inline-flex items-center gap-hsp-2xs", children: [
+      /* @__PURE__ */ jsx(ClockIcon, {}),
+      /* @__PURE__ */ jsxs("span", { children: [
+        createdLabel,
+        " ",
+        createdAt
+      ] })
+    ] }),
+    updatedAt && updatedAt !== createdAt && /* @__PURE__ */ jsxs("span", { class: "inline-flex items-center gap-hsp-2xs", children: [
+      /* @__PURE__ */ jsx(RefreshIcon, {}),
+      /* @__PURE__ */ jsxs("span", { children: [
+        updatedLabel,
+        " ",
+        updatedAt
+      ] })
+    ] }),
+    author && /* @__PURE__ */ jsxs("span", { class: "inline-flex items-center gap-hsp-2xs", children: [
+      /* @__PURE__ */ jsx(UserIcon, {}),
+      /* @__PURE__ */ jsx("span", { children: author })
+    ] })
+  ] });
+}
+export {
+  DEFAULT_CREATED_LABEL,
+  DEFAULT_UPDATED_LABEL,
+  DocMetainfo
+};

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

@@ -0,0 +1,66 @@
+import { VNode } from 'preact';
+
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+
+/**
+ * A single resolved tag with its navigation href. The legacy
+ * `doc-tags.astro` called `resolvePageTags(tags)` and used `TagNav`
+ * which computed `tagHref()` internally. v2 delegates both to the
+ * caller so the component has no upward dependency on project routing
+ * utilities.
+ */
+interface ResolvedTag {
+    /** Raw tag string (e.g. `"typescript"`). */
+    tag: string;
+    /** Pre-computed href for the tag page. */
+    href: string;
+}
+/**
+ * Controls vertical spacing: matches the `placement` prop on the
+ * legacy `doc-tags.astro` component.
+ *
+ * - `"after-title"` — tight top margin, bottom margin to separate from
+ *   the body (`mt-0 mb-vsp-md`).
+ * - `"before-footer"` — extra top space, no bottom margin
+ *   (`mt-vsp-xl mb-0`).
+ */
+type TagPlacement = "after-title" | "before-footer";
+interface DocTagsProps {
+    /**
+     * Resolved tags with pre-computed hrefs. Pass an empty array (or
+     * omit) to suppress rendering — mirrors the legacy
+     * `resolvedTags.length > 0` guard.
+     */
+    tags?: ResolvedTag[];
+    /**
+     * Placement context — controls the outer container spacing class.
+     */
+    placement: TagPlacement;
+    /**
+     * Label shown before the tag list (e.g. `"Tags:"`). Pass the
+     * i18n-resolved `t("doc.tags", locale)` string from upstream.
+     * Defaults to `"Tags"`.
+     */
+    tagsLabel?: string;
+    /**
+     * Used in each tag's `aria-label` (`"Tagged with: <tag>"`). Defaults
+     * to `"Tagged with"`.
+     */
+    taggedWithLabel?: string;
+}
+declare const DEFAULT_TAGS_LABEL = "Tags";
+declare const DEFAULT_TAGGED_WITH_LABEL = "Tagged with";
+/**
+ * Page-level tag chips — JSX port of `src/components/doc-tags.astro`
+ * (page-variant rendering from `src/components/tag-nav.astro`).
+ *
+ * Returns `null` when the `tags` array is empty, matching the original
+ * `resolvedTags.length > 0` guard.
+ *
+ * The pointed-chip shape is reproduced verbatim from the page-variant
+ * branch of `tag-nav.astro` 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 };

package/dist/metainfo/doc-tags.js

@@ -0,0 +1,53 @@
+import { jsx, jsxs } from "preact/jsx-runtime";
+const DEFAULT_TAGS_LABEL = "Tags";
+const DEFAULT_TAGGED_WITH_LABEL = "Tagged with";
+function DocTags(props) {
+  const {
+    tags = [],
+    placement,
+    tagsLabel = DEFAULT_TAGS_LABEL,
+    taggedWithLabel = DEFAULT_TAGGED_WITH_LABEL
+  } = props;
+  if (tags.length === 0) return null;
+  const spacingClass = placement === "after-title" ? "mt-0 mb-vsp-md" : "mt-vsp-xl mb-0";
+  return /* @__PURE__ */ jsx("div", { class: spacingClass, children: /* @__PURE__ */ jsxs("div", { class: "flex flex-wrap items-center gap-x-hsp-xs gap-y-vsp-xs", children: [
+    /* @__PURE__ */ jsxs("span", { class: "text-caption text-muted", children: [
+      tagsLabel,
+      ":"
+    ] }),
+    tags.map(({ tag, href }) => /* @__PURE__ */ jsxs(
+      "a",
+      {
+        href,
+        "aria-label": `${taggedWithLabel}: ${tag}`,
+        class: "group relative inline-flex no-underline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent",
+        children: [
+          /* @__PURE__ */ jsx(
+            "span",
+            {
+              class: "absolute inset-0 bg-muted group-hover:bg-fg",
+              style: "clip-path: polygon(0 0, calc(100% - 12px) 0, 100% 50%, calc(100% - 12px) 100%, 0 100%)"
+            }
+          ),
+          /* @__PURE__ */ jsxs(
+            "span",
+            {
+              class: "relative inline-flex items-center text-caption text-fg bg-bg pl-hsp-sm pr-hsp-lg py-vsp-2xs group-hover:text-bg group-hover:bg-fg",
+              style: "clip-path: polygon(1px 1px, calc(100% - 13px) 1px, calc(100% - 1px) 50%, calc(100% - 13px) calc(100% - 1px), 1px calc(100% - 1px))",
+              children: [
+                "#",
+                tag
+              ]
+            }
+          )
+        ]
+      },
+      tag
+    ))
+  ] }) });
+}
+export {
+  DEFAULT_TAGGED_WITH_LABEL,
+  DEFAULT_TAGS_LABEL,
+  DocTags
+};

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

@@ -0,0 +1,95 @@
+import { ComponentChildren, VNode } from 'preact';
+
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+
+/**
+ * Props passed to a per-key custom renderer component.
+ *
+ * The caller is responsible for filtering entries and skipping ignored keys
+ * before invoking `FrontmatterPreview`. Renderers are therefore guaranteed
+ * to receive only non-null, non-ignored values.
+ */
+interface FrontmatterCellRendererProps {
+    /** The frontmatter value (null/undefined values are never passed). */
+    value: NonNullable<unknown>;
+    /** The frontmatter key name. */
+    entryKey: string;
+    /** Full frontmatter of the current page — for cross-field dependencies. */
+    data: Record<string, unknown>;
+    /** Active locale string — forwarded from the page context. */
+    locale?: string;
+}
+/**
+ * A custom renderer for a single frontmatter value cell.
+ *
+ * Return `null` or `undefined` to fall through to the built-in
+ * `renderValue()` plain-text path.
+ */
+type FrontmatterCellRenderer = (props: FrontmatterCellRendererProps) => ComponentChildren;
+interface FrontmatterPreviewProps {
+    /**
+     * Pre-filtered `[key, value]` pairs to display. The legacy component
+     * owned the filtering logic (ignore-keys, null/undefined removal,
+     * `settings.frontmatterPreview` gating, `frontmatterRenderers`
+     * dispatch). v2 delegates all of that to the caller and accepts only
+     * the final entries to render.
+     *
+     * Pass an empty array (or omit) to suppress rendering.
+     */
+    entries?: Array<[string, unknown]>;
+    /**
+     * Section heading above the table. Defaults to `"Frontmatter"`.
+     * Pass the i18n-resolved `t("frontmatter.preview.title", locale)`
+     * string from upstream.
+     */
+    title?: string;
+    /**
+     * Column header for the key column. Defaults to `"Key"`.
+     */
+    keyColLabel?: string;
+    /**
+     * Column header for the value column. Defaults to `"Value"`.
+     */
+    valueColLabel?: string;
+    /**
+     * Optional per-key custom renderer map. When a renderer is registered for
+     * a key, its return value replaces the built-in plain-text cell. A
+     * renderer that returns `null` or `undefined` falls through to the
+     * built-in path.
+     *
+     * Keyed by frontmatter field name (case-sensitive). The caller is
+     * responsible for ensuring the map does not contain entries for
+     * ignored keys (ignored keys are never in `entries`, so their
+     * renderers are never called anyway).
+     */
+    renderers?: Record<string, FrontmatterCellRenderer>;
+    /**
+     * Full frontmatter data of the current page. Forwarded to each renderer
+     * via `FrontmatterCellRendererProps.data` so renderers can read
+     * cross-field context. Defaults to `{}`.
+     */
+    data?: Record<string, unknown>;
+    /**
+     * Active locale string. Forwarded to each renderer via
+     * `FrontmatterCellRendererProps.locale`.
+     */
+    locale?: string;
+}
+declare const DEFAULT_FRONTMATTER_PREVIEW_TITLE = "Frontmatter";
+declare const DEFAULT_KEY_COL_LABEL = "Key";
+declare const DEFAULT_VALUE_COL_LABEL = "Value";
+/**
+ * Frontmatter data table — JSX port of
+ * `src/components/frontmatter-preview.astro`.
+ *
+ * Returns `null` when `entries` is empty, mirroring the original
+ * `entries.length > 0` guard.
+ *
+ * When `renderers` is provided, each entry's value cell is first offered to
+ * 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 };

package/dist/metainfo/frontmatter-preview.js

@@ -0,0 +1,55 @@
+import { jsx, jsxs } from "preact/jsx-runtime";
+const DEFAULT_FRONTMATTER_PREVIEW_TITLE = "Frontmatter";
+const DEFAULT_KEY_COL_LABEL = "Key";
+const DEFAULT_VALUE_COL_LABEL = "Value";
+function renderValue(v) {
+  if (typeof v === "string") return { text: v };
+  if (typeof v === "number") return { text: String(v) };
+  if (typeof v === "boolean") return { text: v ? "true" : "false" };
+  if (Array.isArray(v) && v.every((item) => typeof item === "string")) {
+    return { text: v.join(", ") };
+  }
+  return { code: JSON.stringify(v) };
+}
+function FrontmatterPreview(props) {
+  const {
+    entries = [],
+    title = DEFAULT_FRONTMATTER_PREVIEW_TITLE,
+    keyColLabel = DEFAULT_KEY_COL_LABEL,
+    valueColLabel = DEFAULT_VALUE_COL_LABEL,
+    renderers,
+    data = {},
+    locale
+  } = props;
+  if (entries.length === 0) return null;
+  return /* @__PURE__ */ jsxs("div", { "data-testid": "frontmatter-preview", class: "my-vsp-lg", children: [
+    /* @__PURE__ */ jsx("p", { class: "text-caption text-muted mb-vsp-2xs", children: title }),
+    /* @__PURE__ */ jsx("div", { class: "overflow-x-auto", children: /* @__PURE__ */ jsxs("table", { class: "w-full border-collapse text-caption", children: [
+      /* @__PURE__ */ jsx("thead", { children: /* @__PURE__ */ jsxs("tr", { children: [
+        /* @__PURE__ */ jsx("th", { class: "text-left font-semibold px-hsp-md py-vsp-2xs border-b-2 border-muted text-fg", children: keyColLabel }),
+        /* @__PURE__ */ jsx("th", { class: "text-left font-semibold px-hsp-md py-vsp-2xs border-b-2 border-muted text-fg", children: valueColLabel })
+      ] }) }),
+      /* @__PURE__ */ jsx("tbody", { children: entries.map(([key, value]) => {
+        const rendererFn = renderers?.[key];
+        const customCell = rendererFn != null && value != null ? rendererFn({
+          value,
+          entryKey: key,
+          data,
+          locale
+        }) : void 0;
+        const useCustom = customCell !== null && customCell !== void 0;
+        const rendered = useCustom ? null : renderValue(value);
+        return /* @__PURE__ */ jsxs("tr", { class: "border-b border-muted", children: [
+          /* @__PURE__ */ jsx("td", { class: "px-hsp-md py-vsp-2xs text-muted font-mono align-top", children: key }),
+          /* @__PURE__ */ jsx("td", { class: "px-hsp-md py-vsp-2xs text-fg break-words align-top", children: useCustom ? customCell : rendered.code !== void 0 ? /* @__PURE__ */ jsx("code", { class: "bg-code-bg text-code-fg px-hsp-xs py-0 rounded text-micro font-mono", children: rendered.code }) : rendered.text })
+        ] }, key);
+      }) })
+    ] }) })
+  ] });
+}
+export {
+  DEFAULT_FRONTMATTER_PREVIEW_TITLE,
+  DEFAULT_KEY_COL_LABEL,
+  DEFAULT_VALUE_COL_LABEL,
+  FrontmatterPreview
+};

package/dist/metainfo/index.d.ts

@@ -0,0 +1,4 @@
+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';

package/dist/metainfo/index.js

@@ -0,0 +1,28 @@
+import {
+  DocMetainfo,
+  DEFAULT_CREATED_LABEL,
+  DEFAULT_UPDATED_LABEL
+} from "./doc-metainfo.js";
+import {
+  DocTags,
+  DEFAULT_TAGS_LABEL,
+  DEFAULT_TAGGED_WITH_LABEL
+} from "./doc-tags.js";
+import {
+  FrontmatterPreview,
+  DEFAULT_FRONTMATTER_PREVIEW_TITLE,
+  DEFAULT_KEY_COL_LABEL,
+  DEFAULT_VALUE_COL_LABEL
+} from "./frontmatter-preview.js";
+export {
+  DEFAULT_CREATED_LABEL,
+  DEFAULT_FRONTMATTER_PREVIEW_TITLE,
+  DEFAULT_KEY_COL_LABEL,
+  DEFAULT_TAGGED_WITH_LABEL,
+  DEFAULT_TAGS_LABEL,
+  DEFAULT_UPDATED_LABEL,
+  DEFAULT_VALUE_COL_LABEL,
+  DocMetainfo,
+  DocTags,
+  FrontmatterPreview
+};

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

@@ -0,0 +1,28 @@
+import { JSX } from 'preact';
+import { NavNode } from './types.js';
+
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+
+interface CategoryNavProps {
+    /**
+     * Direct children of the target category node. The consumer pre-filters to
+     * the desired category and passes the immediate children. Only nodes with
+     * `hasPage === true` will be rendered.
+     */
+    children: NavNode[];
+    /** Optional extra CSS classes appended to the `<nav>` element. */
+    class?: string;
+}
+/**
+ * CategoryNav — JSX port of `src/components/category-nav.astro`.
+ *
+ * Renders direct children of a category as a two-column grid of card links.
+ * Each card shows the node's label (with an arrow icon) and an optional
+ * description line.
+ *
+ * Returns `null` when no `hasPage` children are found.
+ */
+declare function CategoryNav(props: CategoryNavProps): JSX.Element | null;
+
+export { CategoryNav, type CategoryNavProps };

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

@@ -0,0 +1,41 @@
+import { jsx, jsxs } from "preact/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",
+      class: "w-[16px] shrink-0",
+      children: /* @__PURE__ */ jsx("path", { d: "M5.746 5.74 0 11.49l20.987 20.96C34.126 45.572 41.963 53.45 41.948 53.523c-.012.062-9.456 9.544-20.986 21.07L0 95.55l5.714 5.715c3.142 3.143 5.748 5.715 5.79 5.715s2.63-2.563 5.75-5.696l17.939-18.001c21.867-21.94 29.443-29.599 29.443-29.768 0-.114-.665-.804-5.084-5.275C51.872 40.47 11.71.125 11.565.036 11.525.01 8.906 2.578 5.746 5.74m38.345-.066c-3.132 3.13-5.696 5.71-5.696 5.732-.001.022 2.16 2.185 4.8 4.807 2.641 2.623 8.382 8.338 12.758 12.702 15.38 15.337 23.763 23.641 24.314 24.086.19.153.346.336.346.405 0 .07-1.738 1.847-3.887 3.976a17515 17515 0 0 0-20.35 20.264 19555 19555 0 0 1-17.223 17.158c-.416.409-.757.77-.757.8 0 .083 11.415 11.485 11.457 11.445.235-.22 53.542-53.528 53.542-53.543C103.395 53.472 49.891.02 49.837 0c-.028-.01-2.613 2.543-5.746 5.674" })
+    }
+  );
+}
+function CategoryNav(props) {
+  const { children, class: className } = props;
+  const items = children.filter((c) => c.hasPage);
+  if (items.length === 0) return null;
+  const navClass = [
+    "mt-vsp-lg mb-vsp-md grid grid-cols-1 gap-x-hsp-lg gap-y-vsp-md sm:grid-cols-2",
+    className
+  ].filter(Boolean).join(" ");
+  return /* @__PURE__ */ jsx("nav", { class: navClass, children: items.map((child, i) => /* @__PURE__ */ jsxs(
+    "a",
+    {
+      href: child.href,
+      class: "group block rounded border border-muted bg-surface px-hsp-lg py-vsp-md hover:border-accent",
+      children: [
+        /* @__PURE__ */ jsxs("span", { class: "flex items-start gap-hsp-xs font-medium text-accent underline group-hover:underline", children: [
+          /* @__PURE__ */ jsx("span", { class: "flex h-[1lh] items-center", children: /* @__PURE__ */ jsx(ArrowIcon, {}) }),
+          child.label
+        ] }),
+        child.description && /* @__PURE__ */ jsx("span", { class: "mt-vsp-2xs block text-small text-muted group-hover:underline group-focus-visible:underline", children: child.description })
+      ]
+    },
+    `cat-nav-${i}`
+  )) });
+}
+export {
+  CategoryNav
+};

package/dist/nav-indexing/category-tree-nav.d.ts

@@ -0,0 +1,27 @@
+import { JSX } from 'preact';
+import { NavNode } from './types.js';
+
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+
+interface CategoryTreeNavProps {
+    /**
+     * Direct children of the target category node. Nodes are filtered to
+     * those with `hasPage` or with child nodes before rendering.
+     */
+    children: NavNode[];
+    /** Maximum depth to recurse. Defaults to unlimited (full tree). */
+    maxDepth?: number;
+}
+/**
+ * CategoryTreeNav — JSX port of `src/components/category-tree-nav.astro`.
+ *
+ * Renders the children of a category as a recursive disc-bulleted list. Links
+ * are rendered for nodes that have a page; plain text for structural nodes.
+ * Descriptions are appended after a colon when present.
+ *
+ * Returns `null` when no renderable children exist.
+ */
+declare function CategoryTreeNav(props: CategoryTreeNavProps): JSX.Element | null;
+
+export { CategoryTreeNav, type CategoryTreeNavProps };

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

@@ -0,0 +1,49 @@
+import { jsx, jsxs } from "preact/jsx-runtime";
+function NodeItem({ node, depth, maxDepth, index }) {
+  const visibleChildren = node.children.filter(
+    (c) => c.hasPage || c.children.length > 0
+  );
+  const hasChildren = visibleChildren.length > 0 && depth < maxDepth;
+  return /* @__PURE__ */ jsxs("li", { class: "m-0 p-0", children: [
+    node.href ? /* @__PURE__ */ jsx(
+      "a",
+      {
+        href: node.href,
+        class: "inline-block py-vsp-3xs text-accent hover:underline",
+        children: node.label
+      }
+    ) : /* @__PURE__ */ jsx("span", { class: "inline-block py-vsp-3xs text-fg font-medium", children: node.label }),
+    node.description && /* @__PURE__ */ jsxs("span", { class: "ml-hsp-sm text-small text-muted", children: [
+      ": ",
+      node.description
+    ] }),
+    hasChildren && /* @__PURE__ */ jsx("ul", { class: "list-disc m-0 p-0 pl-hsp-xl", children: visibleChildren.map((child, ci) => /* @__PURE__ */ jsx(
+      NodeItem,
+      {
+        node: child,
+        depth: depth + 1,
+        maxDepth,
+        index: ci
+      },
+      `tree-child-${depth + 1}-${ci}`
+    )) })
+  ] }, `tree-item-${depth}-${index}`);
+}
+function CategoryTreeNav(props) {
+  const { children, maxDepth = Infinity } = props;
+  const items = children.filter((c) => c.hasPage || c.children.length > 0);
+  if (items.length === 0) return null;
+  return /* @__PURE__ */ jsx("nav", { "aria-label": "Category navigation", class: "mt-vsp-lg mb-vsp-md", children: /* @__PURE__ */ jsx("ul", { class: "list-disc m-0 p-0 pl-hsp-xl", children: items.map((child, i) => /* @__PURE__ */ jsx(
+    NodeItem,
+    {
+      node: child,
+      depth: 0,
+      maxDepth,
+      index: i
+    },
+    `tree-top-${i}`
+  )) }) });
+}
+export {
+  CategoryTreeNav
+};

package/dist/nav-indexing/doc-card-grid.d.ts

@@ -0,0 +1,38 @@
+import { JSX } from 'preact';
+
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+
+/** A single resolved doc card item. */
+interface DocCardItem {
+    /** Pre-resolved href (base-prefixed, locale-aware). */
+    href: string;
+    /** Display title for the card. */
+    title: string;
+    /** Optional description shown below the title. */
+    description?: string;
+}
+interface DocCardGridProps {
+    /** Flat list of fully resolved card items. */
+    items: DocCardItem[];
+    /** Accessible label for the `<nav>` element. Defaults to "Child pages". */
+    ariaLabel?: string;
+    /** Optional extra CSS classes appended to the `<nav>` element. */
+    class?: string;
+}
+/**
+ * DocCardGrid — JSX port of `src/components/doc-card-grid.astro`.
+ *
+ * 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
+ * description.
+ *
+ * This is the simplest of the card-grid family: it takes fully resolved items
+ * rather than NavNode tree nodes, making it easy to use for hand-crafted link
+ * lists or computed result sets.
+ *
+ * Returns `null` when `items` is empty.
+ */
+declare function DocCardGrid(props: DocCardGridProps): JSX.Element | null;
+
+export { DocCardGrid, type DocCardGridProps, type DocCardItem };

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

@@ -0,0 +1,40 @@
+import { jsx, jsxs } from "preact/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",
+      class: "w-[16px] shrink-0 text-accent",
+      children: /* @__PURE__ */ jsx("path", { d: "M5.746 5.74 0 11.49l20.987 20.96C34.126 45.572 41.963 53.45 41.948 53.523c-.012.062-9.456 9.544-20.986 21.07L0 95.55l5.714 5.715c3.142 3.143 5.748 5.715 5.79 5.715s2.63-2.563 5.75-5.696l17.939-18.001c21.867-21.94 29.443-29.599 29.443-29.768 0-.114-.665-.804-5.084-5.275C51.872 40.47 11.71.125 11.565.036 11.525.01 8.906 2.578 5.746 5.74m38.345-.066c-3.132 3.13-5.696 5.71-5.696 5.732-.001.022 2.16 2.185 4.8 4.807 2.641 2.623 8.382 8.338 12.758 12.702 15.38 15.337 23.763 23.641 24.314 24.086.19.153.346.336.346.405 0 .07-1.738 1.847-3.887 3.976a17515 17515 0 0 0-20.35 20.264 19555 19555 0 0 1-17.223 17.158c-.416.409-.757.77-.757.8 0 .083 11.415 11.485 11.457 11.445.235-.22 53.542-53.528 53.542-53.543C103.395 53.472 49.891.02 49.837 0c-.028-.01-2.613 2.543-5.746 5.674" })
+    }
+  );
+}
+function DocCardGrid(props) {
+  const { items, ariaLabel = "Child pages", class: className } = props;
+  if (items.length === 0) return null;
+  const navClass = [
+    "grid grid-cols-1 gap-x-hsp-lg gap-y-vsp-md sm:grid-cols-2",
+    className
+  ].filter(Boolean).join(" ");
+  return /* @__PURE__ */ jsx("nav", { "aria-label": ariaLabel, class: navClass, children: items.map((item, i) => /* @__PURE__ */ jsxs(
+    "a",
+    {
+      href: item.href,
+      class: "group block rounded border border-muted bg-surface px-hsp-lg py-vsp-md hover:border-accent",
+      children: [
+        /* @__PURE__ */ jsxs("span", { class: "flex items-center gap-hsp-xs", children: [
+          /* @__PURE__ */ jsx(ArrowIcon, {}),
+          /* @__PURE__ */ jsx("span", { class: "font-medium text-accent group-hover:underline", children: item.title })
+        ] }),
+        item.description && /* @__PURE__ */ jsx("span", { class: "mt-vsp-2xs block text-small text-muted", children: item.description })
+      ]
+    },
+    `doc-card-${i}`
+  )) });
+}
+export {
+  DocCardGrid
+};

package/dist/nav-indexing/docs-sitemap.d.ts

@@ -0,0 +1,25 @@
+import { JSX } from 'preact';
+import { NavNode } from './types.js';
+
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+
+interface DocsSitemapProps {
+    /**
+     * Pre-built navigation tree. Each top-level entry maps to one collapsible
+     * section in the sitemap.
+     */
+    tree: NavNode[];
+}
+/**
+ * DocsSitemap — JSX port of `src/components/docs-sitemap.astro`.
+ *
+ * Renders the full documentation tree as a series of collapsible
+ * `<details>` sections. Each top-level node becomes one section; its
+ * descendants with `hasPage === true` are listed flat within that section.
+ *
+ * Returns `null` when `tree` is empty.
+ */
+declare function DocsSitemap(props: DocsSitemapProps): JSX.Element | null;
+
+export { DocsSitemap, type DocsSitemapProps };