@takazudo/zudo-doc 0.1.0

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

@@ -0,0 +1,40 @@
+import { jsx, jsxs } from "preact/jsx-runtime";
+function flattenTree(nodes) {
+  const result = [];
+  function collect(n) {
+    for (const node of n) {
+      if (node.hasPage) result.push(node);
+      collect(node.children);
+    }
+  }
+  collect(nodes);
+  return result;
+}
+function SitemapSection({ node, index }) {
+  const leaves = flattenTree(node.children);
+  return /* @__PURE__ */ jsxs("details", { class: "group border border-muted overflow-hidden", open: true, children: [
+    /* @__PURE__ */ jsxs("summary", { class: "flex items-center gap-x-hsp-md px-hsp-xl py-vsp-md text-title font-bold cursor-pointer select-none bg-surface list-none [&::-webkit-details-marker]:hidden", children: [
+      /* @__PURE__ */ jsx("span", { class: "inline-block text-caption text-muted transition-transform duration-200 group-open:rotate-90", children: "\u25B6" }),
+      node.href ? /* @__PURE__ */ jsx("a", { href: node.href, class: "hover:underline focus:underline", children: node.label }) : /* @__PURE__ */ jsx("span", { children: node.label })
+    ] }),
+    leaves.length > 0 && /* @__PURE__ */ jsx("div", { class: "px-hsp-xl py-vsp-md", children: /* @__PURE__ */ jsx("ul", { class: "space-y-vsp-2xs pl-[1.25rem] list-none", children: leaves.map((leaf, li) => /* @__PURE__ */ jsxs("li", { children: [
+      /* @__PURE__ */ jsx(
+        "a",
+        {
+          href: leaf.href,
+          class: "text-accent hover:underline focus:underline",
+          children: leaf.label
+        }
+      ),
+      leaf.description && /* @__PURE__ */ jsx("span", { class: "ml-hsp-sm text-small text-muted", children: leaf.description })
+    ] }, `leaf-${index}-${li}`)) }) })
+  ] }, `section-${index}`);
+}
+function DocsSitemap(props) {
+  const { tree } = props;
+  if (tree.length === 0) return null;
+  return /* @__PURE__ */ jsx("div", { class: "flex flex-col gap-y-vsp-lg", children: tree.map((node, i) => /* @__PURE__ */ jsx(SitemapSection, { node, index: i }, `sitemap-${i}`)) });
+}
+export {
+  DocsSitemap
+};

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

@@ -0,0 +1,10 @@
+export { CategoryNav, CategoryNavProps } from './category-nav.js';
+export { CategoryTreeNav, CategoryTreeNavProps } from './category-tree-nav.js';
+export { SiteTreeNavDemo, SiteTreeNavDemoProps } from './site-tree-nav-demo.js';
+export { TagNav, TagNavAllProps, TagNavPageProps, TagNavProps } from './tag-nav.js';
+export { DocsSitemap, DocsSitemapProps } from './docs-sitemap.js';
+export { NavCardGrid, NavCardGridProps } from './nav-card-grid.js';
+export { DocCardGrid, DocCardGridProps, DocCardItem } from './doc-card-grid.js';
+export { VersionsPageContent, VersionsPageContentProps } from './versions-page-content.js';
+export { NavNode, TagItem, TagLink, TagNavLabels, VersionPageEntry, VersionsPageLabels } from './types.js';
+import 'preact';

package/dist/nav-indexing/index.js

@@ -0,0 +1,18 @@
+import { CategoryNav } from "./category-nav.js";
+import { CategoryTreeNav } from "./category-tree-nav.js";
+import { SiteTreeNavDemo } from "./site-tree-nav-demo.js";
+import { TagNav } from "./tag-nav.js";
+import { DocsSitemap } from "./docs-sitemap.js";
+import { NavCardGrid } from "./nav-card-grid.js";
+import { DocCardGrid } from "./doc-card-grid.js";
+import { VersionsPageContent } from "./versions-page-content.js";
+export {
+  CategoryNav,
+  CategoryTreeNav,
+  DocCardGrid,
+  DocsSitemap,
+  NavCardGrid,
+  SiteTreeNavDemo,
+  TagNav,
+  VersionsPageContent
+};

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

@@ -0,0 +1,31 @@
+import { JSX } from 'preact';
+import { NavNode } from './types.js';
+
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+
+interface NavCardGridProps {
+    /**
+     * Direct children of the target category node. The consumer should
+     * pre-resolve `href` for each node (e.g. via `docsUrl(slug, locale)`).
+     * Nodes without `href` are skipped.
+     */
+    children: NavNode[];
+    /** Optional extra CSS classes appended to the `<nav>` element. */
+    class?: string;
+}
+/**
+ * NavCardGrid — JSX port of `src/components/nav-card-grid.astro`.
+ *
+ * Renders direct children of a category as a two-column grid of card links.
+ * Unlike `CategoryNav`, the arrow icon uses `text-accent` and sits inline with
+ * the label via `items-center`. Description lines have a hover-underline effect.
+ *
+ * The caller must pre-resolve `href` for each node. Nodes with neither
+ * `hasPage` nor children are excluded; nodes without an `href` are skipped.
+ *
+ * Returns `null` when no renderable items remain.
+ */
+declare function NavCardGrid(props: NavCardGridProps): JSX.Element | null;
+
+export { NavCardGrid, type NavCardGridProps };

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

@@ -0,0 +1,43 @@
+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 NavCardGrid(props) {
+  const { children, class: className } = props;
+  const items = children.filter(
+    (c) => (c.hasPage || c.children.length > 0) && c.href
+  );
+  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": "Child pages", 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-center gap-hsp-sm", children: [
+          /* @__PURE__ */ jsx(ArrowIcon, {}),
+          /* @__PURE__ */ jsx("span", { class: "font-medium text-accent group-hover:underline", children: child.label })
+        ] }),
+        child.description && /* @__PURE__ */ jsx("span", { class: "mt-vsp-2xs block text-small text-muted group-hover:underline decoration-muted", children: child.description })
+      ]
+    },
+    `nav-card-${i}`
+  )) });
+}
+export {
+  NavCardGrid
+};

package/dist/nav-indexing/site-tree-nav-demo.d.ts

@@ -0,0 +1,39 @@
+import { JSX } from 'preact';
+import { NavNode } from './types.js';
+
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+
+interface SiteTreeNavDemoProps {
+    /**
+     * Pre-built top-level tree nodes. The host calls buildNavTree (or
+     * buildSidebarTree) + groupSatelliteNodes before rendering this component.
+     */
+    tree: NavNode[];
+    /**
+     * Category slugs to pin at the front of the list, in order.
+     * Unmatched slugs are appended after the ordered ones.
+     */
+    categoryOrder?: string[];
+    /**
+     * Category slugs to exclude from the rendered tree entirely.
+     */
+    categoryIgnore?: string[];
+    /** aria-label for the wrapping <nav>. Defaults to "Site index". */
+    ariaLabel?: string;
+}
+/**
+ * SiteTreeNavDemo — JSX port of `src/components/site-tree-nav-demo.astro`.
+ *
+ * Renders the full site tree as a static collapsible section-by-section view.
+ * Each top-level category becomes a `<details>` block; leaves within each
+ * section are listed as links.
+ *
+ * The host assembles the tree (e.g. via `buildSidebarTree` from
+ * `@takazudo/zudo-doc/sidebar-tree`) and passes it as `tree`.
+ *
+ * Returns `null` when the tree is empty after filtering.
+ */
+declare function SiteTreeNavDemo(props: SiteTreeNavDemoProps): JSX.Element | null;
+
+export { SiteTreeNavDemo, type SiteTreeNavDemoProps };

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

@@ -0,0 +1,65 @@
+import { jsx, jsxs } from "preact/jsx-runtime";
+function flattenTree(nodes) {
+  const result = [];
+  function collect(n) {
+    for (const node of n) {
+      if (node.hasPage) result.push(node);
+      collect(node.children);
+    }
+  }
+  collect(nodes);
+  return result;
+}
+function reorder(nodes, order) {
+  if (!order.length) return nodes;
+  const remaining = [...nodes];
+  const result = [];
+  for (const slug of order) {
+    const idx = remaining.findIndex(
+      (n) => n.href?.includes(`/${slug}/`) || n.href?.includes(`/${slug}`)
+    );
+    if (idx !== -1) {
+      result.push(remaining.splice(idx, 1)[0]);
+    }
+  }
+  return [...result, ...remaining];
+}
+function Section({ node }) {
+  const leaves = flattenTree(node.children);
+  return /* @__PURE__ */ jsxs("details", { class: "group border border-muted overflow-hidden", open: true, children: [
+    /* @__PURE__ */ jsxs("summary", { class: "flex items-center gap-x-hsp-md px-hsp-xl py-vsp-md text-title font-bold cursor-pointer select-none bg-surface list-none [&::-webkit-details-marker]:hidden", children: [
+      /* @__PURE__ */ jsx("span", { class: "inline-block text-caption text-muted transition-transform duration-200 group-open:rotate-90", children: "\u25B6" }),
+      node.href ? /* @__PURE__ */ jsx("a", { href: node.href, class: "hover:underline focus:underline", children: node.label }) : /* @__PURE__ */ jsx("span", { children: node.label })
+    ] }),
+    leaves.length > 0 && /* @__PURE__ */ jsx("div", { class: "px-hsp-xl py-vsp-md", children: /* @__PURE__ */ jsx("ul", { class: "space-y-vsp-2xs pl-[1.25rem] list-none", children: leaves.map((leaf, i) => /* @__PURE__ */ jsxs("li", { children: [
+      /* @__PURE__ */ jsx(
+        "a",
+        {
+          href: leaf.href,
+          class: "text-accent hover:underline focus:underline",
+          children: leaf.label
+        }
+      ),
+      leaf.description && /* @__PURE__ */ jsx("span", { class: "ml-hsp-sm text-small text-muted", children: leaf.description })
+    ] }, `leaf-${i}`)) }) })
+  ] });
+}
+function SiteTreeNavDemo(props) {
+  const {
+    tree,
+    categoryOrder = [],
+    categoryIgnore = [],
+    ariaLabel = "Site index"
+  } = props;
+  const ignoreSet = new Set(categoryIgnore);
+  let visible = tree.filter((node) => {
+    const slug = node.href?.replace(/^\/(?:[\w-]+\/)?docs\//, "").replace(/\/$/, "") ?? node.label.toLowerCase().replace(/\s+/g, "-");
+    return !ignoreSet.has(slug);
+  });
+  visible = reorder(visible, categoryOrder);
+  if (visible.length === 0) return null;
+  return /* @__PURE__ */ jsx("nav", { "aria-label": ariaLabel, children: /* @__PURE__ */ jsx("div", { class: "flex flex-col gap-y-vsp-lg", children: visible.map((node, i) => /* @__PURE__ */ jsx(Section, { node }, `section-${i}`)) }) });
+}
+export {
+  SiteTreeNavDemo
+};

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

@@ -0,0 +1,38 @@
+import { JSX } from 'preact';
+import { TagItem, TagNavLabels, TagLink } from './types.js';
+
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+
+interface TagNavAllProps {
+    variant: "all";
+    /** Pre-sorted tag list with counts and pre-resolved hrefs. */
+    tags: TagItem[];
+    /** i18n strings for aria-labels. */
+    labels: TagNavLabels;
+}
+interface TagNavPageProps {
+    variant: "page";
+    /** Tags for the current page with pre-resolved hrefs. */
+    tagLinks: TagLink[];
+    /** i18n strings for aria-labels. */
+    labels: TagNavLabels;
+}
+type TagNavProps = TagNavAllProps | TagNavPageProps;
+/**
+ * TagNav — JSX port of `src/components/tag-nav.astro`.
+ *
+ * Two variants:
+ *
+ *   - `variant="all"` — full tag cloud with count badges, sorted alphabetically
+ *     by the caller. The host resolves `TagItem[]` (tag + count + href) before
+ *     passing them in.
+ *
+ *   - `variant="page"` — small per-page chip strip. The host maps the
+ *     frontmatter `tags: string[]` to `TagLink[]` (tag + href) before passing.
+ *
+ * Returns `null` when the relevant data is empty.
+ */
+declare function TagNav(props: TagNavProps): JSX.Element | null;
+
+export { TagNav, type TagNavAllProps, type TagNavPageProps, type TagNavProps };

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

@@ -0,0 +1,96 @@
+import { jsx, jsxs } from "preact/jsx-runtime";
+function AllTagChip({
+  tag,
+  count,
+  href,
+  labels
+}) {
+  return /* @__PURE__ */ jsx("li", { class: "inline-flex whitespace-nowrap", children: /* @__PURE__ */ jsxs(
+    "a",
+    {
+      href,
+      "aria-label": `${labels.taggedWith}: ${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% - 16px) 0, 100% 50%, calc(100% - 16px) 100%, 0 100%)"
+          }
+        ),
+        /* @__PURE__ */ jsxs(
+          "span",
+          {
+            class: "relative inline-flex items-center text-small text-fg bg-bg pl-hsp-sm pr-hsp-xl py-vsp-2xs group-hover:text-bg group-hover:bg-fg",
+            style: "clip-path: polygon(1px 1px, calc(100% - 17px) 1px, calc(100% - 1px) 50%, calc(100% - 17px) calc(100% - 1px), 1px calc(100% - 1px))",
+            children: [
+              /* @__PURE__ */ jsxs("span", { children: [
+                "#",
+                tag
+              ] }),
+              /* @__PURE__ */ jsxs("span", { class: "text-caption opacity-60", children: [
+                "\xA0(",
+                count,
+                ")"
+              ] })
+            ]
+          }
+        )
+      ]
+    }
+  ) });
+}
+function PageTagChip({
+  tag,
+  href,
+  labels
+}) {
+  return /* @__PURE__ */ jsxs(
+    "a",
+    {
+      href,
+      "aria-label": `${labels.taggedWith}: ${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
+            ]
+          }
+        )
+      ]
+    }
+  );
+}
+function TagNav(props) {
+  if (props.variant === "all") {
+    const { tags, labels: labels2 } = props;
+    if (tags.length === 0) return null;
+    return /* @__PURE__ */ jsx("ul", { class: "flex flex-wrap gap-x-hsp-xs gap-y-vsp-xs", children: tags.map((item) => /* @__PURE__ */ jsx(AllTagChip, { ...item, labels: labels2 }, `tag-${item.tag}`)) });
+  }
+  const { tagLinks, labels } = props;
+  if (tagLinks.length === 0) return null;
+  return /* @__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: [
+      labels.tags,
+      ":"
+    ] }),
+    tagLinks.map((tl) => /* @__PURE__ */ jsx(PageTagChip, { ...tl, labels }, `ptag-${tl.tag}`))
+  ] });
+}
+export {
+  TagNav
+};

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

@@ -0,0 +1,95 @@
+/**
+ * Shared types for the nav-indexing v2 primitives.
+ *
+ * All types are presentational: every value the components need to render
+ * arrives via props. No host-project imports, no Astro collection queries.
+ */
+/**
+ * Minimal tree node used by tree-based nav components (CategoryNav,
+ * CategoryTreeNav, NavCardGrid, DocsSitemap, SiteTreeNavDemo).
+ *
+ * Structurally compatible with the host project's `NavNode` from
+ * `src/utils/docs.ts` and with `SidebarNode` from `sidebar-tree/`, so
+ * callers can pass either through with minor adapter mapping if needed.
+ */
+interface NavNode {
+    label: string;
+    description?: string;
+    /** Pre-resolved href. Undefined for category-only nodes without an index page. */
+    href?: string;
+    /** True when an MDX page backs this node. */
+    hasPage: boolean;
+    children: NavNode[];
+}
+/**
+ * A single tag entry with pre-resolved href — for `TagNav` "all" variant.
+ */
+interface TagItem {
+    tag: string;
+    count: number;
+    /** Pre-resolved href including locale prefix and base path. */
+    href: string;
+}
+/**
+ * A tag with its pre-resolved href — for `TagNav` "page" variant.
+ */
+interface TagLink {
+    tag: string;
+    /** Pre-resolved href. */
+    href: string;
+}
+/**
+ * i18n label bag for `TagNav`. Keeps v2 decoupled from the host's `t()`
+ * function — the consumer resolves strings for the active locale and passes
+ * them in.
+ */
+interface TagNavLabels {
+    /** e.g. "Tags" / "タグ" — prefix label shown before the chips. */
+    tags: string;
+    /** e.g. "Pages tagged with" — used for aria-label on each chip link. */
+    taggedWith: string;
+}
+/**
+ * A single past version entry for `VersionsPageContent`.
+ *
+ * Extends `VersionEntry` from `@takazudo/zudo-doc/i18n-version/types`
+ * with the pre-resolved doc href and optional status banner.
+ */
+interface VersionPageEntry {
+    slug: string;
+    label: string;
+    /** Pre-resolved href to the version's default doc page. */
+    docsHref: string;
+    /** Optional status badge rendered in the Status column. */
+    banner?: "unmaintained" | "unreleased";
+}
+/**
+ * i18n label bag for `VersionsPageContent`. The consumer resolves all
+ * strings for the active locale and passes them in.
+ */
+interface VersionsPageLabels {
+    /** Page `<h1>` text, e.g. "Documentation Versions". */
+    pageTitle: string;
+    /** Latest version section heading, e.g. "Latest Version (Current)". */
+    latestTitle: string;
+    /** Description below the latest heading. */
+    latestDescription: string;
+    /** Link label for the latest docs link. */
+    latestLink: string;
+    /** Past versions section heading, e.g. "Past Versions". */
+    pastTitle: string;
+    /** Description below past versions heading. */
+    pastDescription: string;
+    /** "Unmaintained" badge label. */
+    unmaintained: string;
+    /** "Unreleased" badge label. */
+    unreleased: string;
+    /** Table column: version label heading. */
+    versionCol: string;
+    /** Table column: status heading. */
+    statusCol: string;
+    /** Table column: docs link heading (also used as the link text). */
+    docsCol: string;
+}
+
+export type { NavNode, TagItem, TagLink, TagNavLabels, VersionPageEntry, VersionsPageLabels };

package/dist/nav-indexing/versions-page-content.d.ts

@@ -0,0 +1,29 @@
+import { JSX } from 'preact';
+import { VersionPageEntry, VersionsPageLabels } from './types.js';
+
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+
+interface VersionsPageContentProps {
+    /** Pre-resolved href to the latest version's default docs page. */
+    latestHref: string;
+    /** Past version entries. Empty array hides the past-versions section. */
+    versions: VersionPageEntry[];
+    /** Localized label strings. */
+    labels: VersionsPageLabels;
+}
+/**
+ * VersionsPageContent — JSX port of `src/components/versions-page-content.astro`.
+ *
+ * Renders the full documentation versions page:
+ *   - An `<h1>` heading (from `labels.pageTitle`).
+ *   - A "Latest version" section with a link to the current docs.
+ *   - A "Past versions" table (only when `versions` is non-empty) showing
+ *     each version's label, status badge, and a docs link.
+ *
+ * All strings and hrefs are pre-resolved by the consumer so this component
+ * stays locale- and settings-agnostic.
+ */
+declare function VersionsPageContent(props: VersionsPageContentProps): JSX.Element;
+
+export { VersionsPageContent, type VersionsPageContentProps };

package/dist/nav-indexing/versions-page-content.js

@@ -0,0 +1,76 @@
+import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+function VersionsPageContent(props) {
+  const { latestHref, versions, labels } = props;
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx("h1", { class: "text-heading font-bold mb-vsp-lg", children: labels.pageTitle }),
+    /* @__PURE__ */ jsxs("section", { class: "mb-vsp-xl", children: [
+      /* @__PURE__ */ jsx("h2", { class: "text-title font-bold mb-vsp-xs", children: labels.latestTitle }),
+      /* @__PURE__ */ jsx("p", { class: "text-small text-muted mb-vsp-sm", children: labels.latestDescription }),
+      /* @__PURE__ */ jsxs(
+        "a",
+        {
+          href: latestHref,
+          class: "inline-flex items-center gap-hsp-xs text-small text-accent underline hover:text-accent-hover",
+          children: [
+            labels.latestLink,
+            /* @__PURE__ */ jsx(
+              "svg",
+              {
+                xmlns: "http://www.w3.org/2000/svg",
+                class: "h-[0.875rem] w-[0.875rem]",
+                fill: "none",
+                viewBox: "0 0 24 24",
+                stroke: "currentColor",
+                "stroke-width": "2",
+                children: /* @__PURE__ */ jsx(
+                  "path",
+                  {
+                    "stroke-linecap": "round",
+                    "stroke-linejoin": "round",
+                    d: "M9 5l7 7-7 7"
+                  }
+                )
+              }
+            )
+          ]
+        }
+      )
+    ] }),
+    versions.length > 0 && /* @__PURE__ */ jsxs("section", { children: [
+      /* @__PURE__ */ jsx("h2", { class: "text-title font-bold mb-vsp-xs", children: labels.pastTitle }),
+      /* @__PURE__ */ jsx("p", { class: "text-small text-muted mb-vsp-md", children: labels.pastDescription }),
+      /* @__PURE__ */ jsx("div", { class: "border border-muted rounded overflow-hidden", children: /* @__PURE__ */ jsxs("table", { class: "w-full text-small", children: [
+        /* @__PURE__ */ jsx("thead", { children: /* @__PURE__ */ jsxs("tr", { class: "border-b border-muted bg-surface", children: [
+          /* @__PURE__ */ jsx("th", { class: "px-hsp-lg py-vsp-sm text-left font-medium text-muted", children: labels.versionCol }),
+          /* @__PURE__ */ jsx("th", { class: "px-hsp-lg py-vsp-sm text-left font-medium text-muted", children: labels.statusCol }),
+          /* @__PURE__ */ jsx("th", { class: "px-hsp-lg py-vsp-sm text-left font-medium text-muted", children: labels.docsCol })
+        ] }) }),
+        /* @__PURE__ */ jsx("tbody", { children: versions.map((v) => /* @__PURE__ */ jsxs(
+          "tr",
+          {
+            class: "border-b border-muted last:border-b-0",
+            children: [
+              /* @__PURE__ */ jsx("td", { class: "px-hsp-lg py-vsp-sm font-medium text-fg", children: v.label }),
+              /* @__PURE__ */ jsxs("td", { class: "px-hsp-lg py-vsp-sm", children: [
+                v.banner === "unmaintained" && /* @__PURE__ */ jsx("span", { class: "inline-block rounded px-hsp-xs py-vsp-3xs text-caption bg-warning/10 text-warning", children: labels.unmaintained }),
+                v.banner === "unreleased" && /* @__PURE__ */ jsx("span", { class: "inline-block rounded px-hsp-xs py-vsp-3xs text-caption bg-info/10 text-info", children: labels.unreleased })
+              ] }),
+              /* @__PURE__ */ jsx("td", { class: "px-hsp-lg py-vsp-sm", children: /* @__PURE__ */ jsx(
+                "a",
+                {
+                  href: v.docsHref,
+                  class: "text-accent underline hover:text-accent-hover",
+                  children: labels.docsCol
+                }
+              ) })
+            ]
+          },
+          `version-${v.slug}`
+        )) })
+      ] }) })
+    ] })
+  ] });
+}
+export {
+  VersionsPageContent
+};

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

@@ -0,0 +1,2 @@
+export { PAGE_LOADING_OVERLAY_ID, default as PageLoadingOverlay, PageLoadingOverlayProps, buildPageLoadingOverlayBootstrap } from './page-loading-overlay.js';
+import 'preact';

package/dist/page-loading/index.js

@@ -0,0 +1,10 @@
+import {
+  default as default2,
+  PAGE_LOADING_OVERLAY_ID,
+  buildPageLoadingOverlayBootstrap
+} from "./page-loading-overlay.js";
+export {
+  PAGE_LOADING_OVERLAY_ID,
+  default2 as PageLoadingOverlay,
+  buildPageLoadingOverlayBootstrap
+};

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

@@ -0,0 +1,35 @@
+import * as preact from 'preact';
+
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+/** Default `id` for the overlay element. Stable so test rigs can target it. */
+declare const PAGE_LOADING_OVERLAY_ID = "page-loading-overlay";
+interface PageLoadingOverlayProps {
+    /**
+     * Override the DOM `id` used by both the overlay element and the
+     * bootstrap script. Useful when multiple overlays could co-exist on
+     * the page (e.g. tests). Defaults to `PAGE_LOADING_OVERLAY_ID`.
+     */
+    id?: string;
+}
+/**
+ * Build the inline bootstrap script body. Exported so test rigs can
+ * inspect / snapshot it without rendering the component.
+ */
+declare function buildPageLoadingOverlayBootstrap(overlayId: string): string;
+/**
+ * Full-page loading overlay shown during view-transition navigations.
+ *
+ * Mount this once per layout (typically inside `DocLayoutWithDefaults`'s
+ * `bodyEnd` slot, alongside the existing body-end providers). It is
+ * server-rendered and self-wires its visibility — no hydration needed.
+ *
+ * CSS lives in the host project's `src/styles/global.css` (`.page-loading-overlay`,
+ * `.page-loading-spinner`, `[data-zd-nav-pending]` rules) rather than in an
+ * inline `<style>` block here — a `<style>` inside `<body>` violates HTML5
+ * element-permitted-content and fails html-validate (same fix applied to the
+ * version-switcher in zudolab/zudo-doc#1505; regression caught in W2A #1543).
+ */
+declare function PageLoadingOverlay({ id, }?: PageLoadingOverlayProps): preact.JSX.Element;
+
+export { PAGE_LOADING_OVERLAY_ID, type PageLoadingOverlayProps, buildPageLoadingOverlayBootstrap, PageLoadingOverlay as default };