@takazudo/zudo-doc 0.2.21 → 1.0.0

package/dist/doc-page-props/index.d.ts

@@ -0,0 +1,93 @@
+export type { HeadingItem } from "../extract-headings/index.js";
+import type { HeadingItem } from "../extract-headings/index.js";
+import type { BreadcrumbItem } from "../breadcrumb/types.js";
+/**
+ * Nav tree node shape as consumed by doc-route pages.
+ *
+ * Structurally identical to the host project's `NavNode` from
+ * `src/utils/docs.ts`. Defined here so the package types do not import
+ * the host `@/` alias. The host's `NavNode` is a structural subtype and
+ * assignable wherever `DocNavNode` is expected.
+ */
+export interface DocNavNode {
+    slug: string;
+    label: string;
+    description?: string;
+    position: number;
+    href?: string;
+    hasPage: boolean;
+    children: DocNavNode[];
+    sortOrder?: "asc" | "desc";
+    collapsed?: boolean;
+}
+/**
+ * Minimal docs frontmatter shape consumed by the doc-page types.
+ *
+ * A structural subset of the host's `DocsData` — only the fields that
+ * `DocPageEntry` and `DocPageBaseProps` actually read. The full `DocsData`
+ * (from `src/config/docs-schema.ts`) is a structural supertype and is
+ * assignable here.
+ */
+export interface DocPageFrontmatter {
+    title: string;
+    description?: string;
+    slug?: string;
+    draft?: boolean;
+    unlisted?: boolean;
+    standalone?: boolean;
+    category_no_page?: boolean;
+    pagination_prev?: string | null;
+    pagination_next?: string | null;
+    tags?: string[];
+    [key: string]: unknown;
+}
+/**
+ * A zfb content collection entry augmented with the `id`/`collection` fields
+ * the host's `@/utils/docs` helpers expect, plus the typed `data` and
+ * renderer surface.
+ *
+ * Structural counterpart of the host's `DocPageEntry` (from
+ * `pages/lib/doc-page-props.ts`). The host stub re-exports this type under
+ * the original name.
+ */
+export interface DocPageEntry {
+    /** zfb content engine slug (filename without `.md`/`.mdx`). */
+    slug: string;
+    /** Bridged from `slug` for host `@/utils/docs` compat. */
+    id: string;
+    /** Collection name, e.g. "docs", "docs-ja", "docs-v-1.0". */
+    collection: string;
+    /** Parsed frontmatter. Structural superset of `DocPageFrontmatter`. */
+    data: DocPageFrontmatter;
+    /** Raw MDX body (for heading extraction). */
+    body?: string;
+    /** zfb module specifier (for Content bridge). */
+    module_specifier: string;
+    /** zfb content renderer — callable Preact component. */
+    Content: unknown;
+}
+export interface AutoIndexNode extends DocNavNode {
+    children: DocNavNode[];
+}
+/** Shared fields present in every doc-page route. */
+interface DocPagePropsBase {
+    breadcrumbs: BreadcrumbItem[];
+    prev: DocNavNode | null;
+    next: DocNavNode | null;
+    /** Depth-2/3/4 headings extracted from the MDX body, for SSG TOC links. */
+    headings: HeadingItem[];
+}
+/** Branch: a real content entry. `autoIndex` is absent. */
+export interface DocPageEntryProps extends DocPagePropsBase {
+    kind: "entry";
+    entry: DocPageEntry;
+    autoIndex?: undefined;
+}
+/** Branch: an auto-generated category index. `entry` is absent. */
+export interface DocPageAutoIndexProps extends DocPagePropsBase {
+    kind: "autoIndex";
+    autoIndex: AutoIndexNode;
+    entry?: undefined;
+}
+/** Discriminated union for the `kind` prop. Narrow via `props.kind === "entry"`. */
+export type DocPageBaseProps = DocPageEntryProps | DocPageAutoIndexProps;

package/dist/doc-page-renderer/index.d.ts

@@ -0,0 +1,128 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+import type { JSX, VNode } from "preact";
+import type { DocPageBaseProps, DocNavNode, DocPageEntry } from "../doc-page-props/index.js";
+import type { VersionBannerLabels } from "../i18n-version/index.js";
+export type { DocPageBaseProps };
+/**
+ * Version config shape — structural subset of the host's `VersionConfig`.
+ * Defined here so the package does not import the host `@/` alias.
+ */
+export interface RenderDocPageVersionConfig {
+    /** Version slug, e.g. "1.0". */
+    slug: string;
+    /** Banner type drives the VersionBanner element (`false` = no banner). */
+    banner?: "unmaintained" | "unreleased" | false;
+}
+export interface RenderDocPageOptions {
+    /** Active locale — drives nav wrappers, labels, and URL building. */
+    locale: string;
+    /** Version config when rendering a versioned route; undefined = latest. */
+    version?: RenderDocPageVersionConfig;
+    /** True when this page falls back to the base EN collection (locale
+     *  routes). Drives the fallback notice + history-area hint. */
+    isFallback?: boolean;
+    /**
+     * Content directory for the doc-history view-source link (e.g. the active
+     * locale's dir, or the base docsDir for EN/fallback pages). Latest routes
+     * pass it; versioned routes omit it — doc history is hidden on versioned
+     * pages regardless (#1916 #5).
+     */
+    docHistoryContentDir?: string;
+}
+/** Dependencies injected by the host stub. */
+export interface DocPageRendererDeps {
+    /** Build a docs URL: `docsUrl(slug, lang?)` → base-prefixed path. */
+    docsUrl: (slug: string, lang?: string) => string;
+    /** Build a versioned docs URL: `versionedDocsUrl(slug, versionSlug, lang?)`. */
+    versionedDocsUrl: (slug: string, versionSlug: string, lang?: string) => string;
+    /** Build an absolute URL: `absoluteUrl(path)` → siteUrl-prefixed. */
+    absoluteUrl: (path: string) => string | undefined;
+    /** Determine the nav section (categoryMatch) for a slug. */
+    getNavSectionForSlug: (slug: string) => string | undefined;
+    /** Convert a content entry slug to a canonical route slug. */
+    toRouteSlug: (id: string) => string;
+    /**
+     * Build locale-aware MDX components bag.
+     * Host passes `createMdxComponents` (from `pages/_mdx-components.ts`).
+     */
+    createMdxComponents: (locale: string) => Record<string, unknown>;
+    /** Translate a UI string key for a locale. */
+    t: (key: string, locale: string) => string;
+    /**
+     * Build an inline version switcher VNode for the breadcrumb rightSlot.
+     * Host passes `buildInlineVersionSwitcher` from `pages/lib/_inline-version-switcher.tsx`.
+     */
+    buildInlineVersionSwitcher: (slug: string, locale: string, currentVersion?: string) => JSX.Element | undefined;
+    /**
+     * The `DocPageShell` component (host-side factory result from
+     * `@takazudo/zudo-doc/doc-page-shell`).
+     */
+    DocPageShell: (props: {
+        kind: "entry" | "autoIndex";
+        locale: string;
+        slug: string;
+        title: string;
+        description?: string;
+        canonical?: string;
+        breadcrumbs: Array<{
+            label: string;
+            href?: string;
+        }>;
+        prev: DocNavNode | null;
+        next: DocNavNode | null;
+        headings: Array<{
+            depth: number;
+            slug: string;
+            text: string;
+        }>;
+        navSection: string | undefined;
+        sidebarPersistKey: string | undefined;
+        hideSidebar?: boolean;
+        hideToc?: boolean;
+        currentPath: string;
+        currentVersion?: string;
+        versionSwitcher: JSX.Element | undefined;
+        versionBanner?: "unmaintained" | "unreleased";
+        versionBannerLatestUrl?: string;
+        versionBannerLabels?: VersionBannerLabels;
+        autoIndexLabel?: string;
+        autoIndexChildren?: DocNavNode[];
+        metainfoSlot?: VNode | null;
+        contentHeaderSlot?: VNode;
+        contentSlot?: VNode;
+        docHistorySlot?: VNode | null;
+    }) => JSX.Element;
+    /**
+     * The `DocContentHeader` component (host-side factory result).
+     */
+    DocContentHeader: (props: {
+        entry: DocPageEntry;
+        slug: string;
+        locale: string;
+        isFallback?: boolean;
+        version?: string;
+    }) => JSX.Element;
+    /**
+     * The `DocMetainfoArea` component (host-side factory result).
+     */
+    DocMetainfoArea: (props: {
+        slug: string;
+        locale: string;
+        isFallback?: boolean;
+    }) => JSX.Element | null;
+    /**
+     * The `DocHistoryArea` component (host-side factory result).
+     */
+    DocHistoryArea: (props: {
+        slug: string;
+        locale: string;
+        entrySlug?: string;
+        contentDir?: string;
+        isFallback?: boolean;
+    }) => VNode | null;
+}
+/**
+ * Create a `renderDocPage` function bound to the host's injected dependencies.
+ */
+export declare function createRenderDocPage(deps: DocPageRendererDeps): (props: DocPageBaseProps, opts: RenderDocPageOptions) => JSX.Element;

package/dist/doc-page-renderer/index.js

@@ -0,0 +1,103 @@
+import { jsx } from "preact/jsx-runtime";
+function createRenderDocPage(deps) {
+  const {
+    docsUrl,
+    versionedDocsUrl,
+    absoluteUrl,
+    getNavSectionForSlug,
+    toRouteSlug,
+    createMdxComponents,
+    t,
+    buildInlineVersionSwitcher,
+    DocPageShell,
+    DocContentHeader,
+    DocMetainfoArea,
+    DocHistoryArea
+  } = deps;
+  function renderDocPage(props, opts) {
+    const { breadcrumbs, prev, next, headings } = props;
+    const { locale, version, isFallback } = opts;
+    const slug = props.kind === "autoIndex" ? props.autoIndex.slug : props.entry.data.slug ?? toRouteSlug(props.entry.slug);
+    const title = props.kind === "autoIndex" ? props.autoIndex.label : props.entry.data.title;
+    const description = props.kind === "autoIndex" ? props.autoIndex.description : props.entry.data.description;
+    const components = createMdxComponents(locale);
+    const autoIndexChildren = props.kind === "autoIndex" ? version ? props.autoIndex.children.filter((c) => c.hasPage || c.children.length > 0) : props.autoIndex.children.filter((c) => c.hasPage || c.children.length > 0).map((c) => ({
+      ...c,
+      href: c.href ?? docsUrl(c.slug, locale)
+    })) : [];
+    const versionBannerType = version?.banner ? version.banner : void 0;
+    const versionBannerLatestUrl = versionBannerType ? docsUrl(slug, locale) : void 0;
+    const versionBannerLabels = versionBannerType ? {
+      message: versionBannerType === "unmaintained" ? t("version.banner.unmaintained", locale) : t("version.banner.unreleased", locale),
+      latestLink: t("version.banner.latestLink", locale)
+    } : void 0;
+    const currentPath = version ? versionedDocsUrl(slug, version.slug, locale) : docsUrl(slug, locale);
+    const canonical = absoluteUrl(currentPath);
+    const navSection = getNavSectionForSlug(slug);
+    const hideSidebar = props.kind === "entry" ? props.entry.data.hide_sidebar : void 0;
+    const sidebarPersistKey = hideSidebar ? void 0 : `sidebar-${locale}-${navSection ?? "default"}`;
+    const ContentComponent = props.kind === "entry" ? props.entry.Content : null;
+    return /* @__PURE__ */ jsx(
+      DocPageShell,
+      {
+        kind: props.kind,
+        locale,
+        slug,
+        title,
+        description,
+        canonical,
+        breadcrumbs,
+        prev,
+        next,
+        headings,
+        navSection,
+        sidebarPersistKey,
+        hideSidebar,
+        hideToc: props.kind === "entry" ? props.entry.data.hide_toc : void 0,
+        currentPath,
+        currentVersion: version?.slug,
+        versionSwitcher: buildInlineVersionSwitcher(slug, locale, version?.slug),
+        versionBanner: versionBannerType,
+        versionBannerLatestUrl,
+        versionBannerLabels,
+        autoIndexLabel: props.kind === "autoIndex" ? props.autoIndex.label : void 0,
+        autoIndexChildren,
+        metainfoSlot: (
+          // Versioned gate mirrors DocContentHeader: the doc-history-meta
+          // manifest is built from latest dirs only, so a bare versioned slug
+          // would surface the LATEST page's Created/Updated/Author.
+          !version && props.kind === "autoIndex" ? /* @__PURE__ */ jsx(DocMetainfoArea, { slug, locale, isFallback }) : null
+        ),
+        contentHeaderSlot: props.kind === "entry" ? /* @__PURE__ */ jsx(
+          DocContentHeader,
+          {
+            entry: props.entry,
+            slug,
+            locale,
+            isFallback,
+            version: version?.slug
+          }
+        ) : void 0,
+        contentSlot: ContentComponent ? /* @__PURE__ */ jsx(ContentComponent, { components }) : void 0,
+        docHistorySlot: (
+          // #1916 #5: doc-history hidden on versioned pages until versioned
+          // history is supported.
+          !version && opts.docHistoryContentDir !== void 0 && props.kind === "entry" && !props.entry.data.unlisted ? /* @__PURE__ */ jsx(
+            DocHistoryArea,
+            {
+              slug,
+              locale,
+              entrySlug: props.entry.slug,
+              contentDir: opts.docHistoryContentDir,
+              isFallback
+            }
+          ) : null
+        )
+      }
+    );
+  }
+  return renderDocPage;
+}
+export {
+  createRenderDocPage
+};

package/dist/doc-page-shell/index.d.ts

@@ -0,0 +1,136 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+import type { ComponentChildren, JSX, VNode } from "preact";
+import type { VersionBannerLabels } from "../i18n-version/index.js";
+/** A heading item for the TOC. */
+export interface DocPageHeading {
+    depth: number;
+    slug: string;
+    text: string;
+}
+/** A breadcrumb item. */
+export interface DocPageBreadcrumbItem {
+    label: string;
+    href?: string;
+}
+/** A nav node for prev/next/autoIndex. */
+export interface DocPageNavNode {
+    slug: string;
+    label: string;
+    href?: string;
+    hasPage: boolean;
+    children: DocPageNavNode[];
+}
+/** Slots and parameters that vary between the 4 doc routes. */
+export interface DocPageShellProps {
+    /** Discriminates the body: a real entry vs an auto-generated category index. */
+    kind: "entry" | "autoIndex";
+    /** Active locale string, e.g. "en", "ja". */
+    locale: string;
+    /** Canonical route slug for this page (no version/locale prefix). */
+    slug: string;
+    /** Page title (entry title or auto-index label). */
+    title: string;
+    /** Page description (may be undefined). */
+    description?: string;
+    /** Absolute canonical URL, or undefined when siteUrl is unset. */
+    canonical?: string;
+    /** Pre-resolved breadcrumb trail (hrefs already remapped per route). */
+    breadcrumbs: DocPageBreadcrumbItem[];
+    /** Pre-resolved prev/next nav nodes (hrefs already remapped per route). */
+    prev: DocPageNavNode | null;
+    next: DocPageNavNode | null;
+    /** Depth-2/3/4 headings for the SSG TOC. */
+    headings: DocPageHeading[];
+    /** Sidebar/header nav-section key for this slug. */
+    navSection: string | undefined;
+    /** Per-page sidebar persist key (undefined when the sidebar is hidden). */
+    sidebarPersistKey: string | undefined;
+    /** Whether to hide the sidebar entirely (entry frontmatter). */
+    hideSidebar?: boolean;
+    /** Whether to hide the TOC (entry frontmatter). */
+    hideToc?: boolean;
+    /** Path of THIS page used by Header/Sidebar to mark the active item. */
+    currentPath: string;
+    /** Version slug for Header/Sidebar active-state, or undefined on latest routes. */
+    currentVersion?: string;
+    /** Inline version switcher VNode for the breadcrumb right-slot. */
+    versionSwitcher: ComponentChildren;
+    /** Version banner type ("unmaintained" | "unreleased") or undefined on latest. */
+    versionBanner?: "unmaintained" | "unreleased";
+    /** URL of the latest equivalent page for the version banner link. */
+    versionBannerLatestUrl?: string;
+    /** Localized version-banner labels. */
+    versionBannerLabels?: VersionBannerLabels;
+    /** Auto-index branch: label heading text. */
+    autoIndexLabel?: string;
+    /** Auto-index branch: pre-filtered + href-remapped child cards. */
+    autoIndexChildren?: DocPageNavNode[];
+    /**
+     * Auto-index branch slot: the build-time date block (DocMetainfoArea), or
+     * null to omit it.
+     */
+    metainfoSlot?: VNode | null;
+    /**
+     * Entry branch slot: the content header (h1 + meta + tags + description +
+     * frontmatter preview), built per route (carries isFallback).
+     */
+    contentHeaderSlot?: VNode;
+    /** Entry branch slot: the rendered MDX `<Content />`. */
+    contentSlot?: VNode;
+    /**
+     * Entry branch slot: the document-utilities area (DocHistoryArea), or null
+     * to omit it.
+     */
+    docHistorySlot?: VNode | null;
+}
+/** Settings subset read by {@link createDocPageShell}. */
+export interface DocPageShellSettings {
+    metaTags: {
+        description?: boolean | null;
+    };
+    noindex?: boolean;
+    dynamicPageTransition?: boolean;
+}
+/** Dependencies injected by the host stub. */
+export interface DocPageShellDeps {
+    settings: DocPageShellSettings;
+    composeMetaTitle: (title: string) => string;
+    getTocTitle: (locale: string) => string;
+    HeadWithDefaults: (props: {
+        title: string;
+        description?: string;
+        canonical?: string;
+    }) => JSX.Element;
+    SidebarWithDefaults: (props: {
+        currentSlug?: string;
+        lang?: string;
+        navSection?: string;
+        currentVersion?: string;
+        currentPath?: string;
+    }) => JSX.Element;
+    HeaderWithDefaults: (props: {
+        lang?: string;
+        currentSlug?: string;
+        navSection?: string;
+        currentVersion?: string;
+        currentPath?: string;
+    }) => JSX.Element;
+    FooterWithDefaults: (props: {
+        lang?: string;
+    }) => JSX.Element;
+    SidebarPrepaint: (props: {
+        hideSidebar?: boolean;
+    }) => JSX.Element | undefined;
+    DocBodyEnd: (props: Record<string, never>) => JSX.Element;
+    DocPager: (props: {
+        prev: DocPageNavNode | null;
+        next: DocPageNavNode | null;
+        locale: string;
+    }) => JSX.Element;
+}
+/**
+ * Create a `DocPageShell` component bound to the host's settings and
+ * component dependencies.
+ */
+export declare function createDocPageShell(deps: DocPageShellDeps): (props: DocPageShellProps) => JSX.Element;

package/dist/doc-page-shell/index.js

@@ -0,0 +1,127 @@
+import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+import { Island } from "@takazudo/zfb";
+import { DocLayoutWithDefaults } from "../doclayout/index.js";
+import { Toc, MobileToc } from "../toc/index.js";
+import { Breadcrumb } from "../breadcrumb/index.js";
+import { NavCardGrid } from "../nav-indexing/index.js";
+function createDocPageShell(deps) {
+  const {
+    settings,
+    composeMetaTitle,
+    getTocTitle,
+    HeadWithDefaults,
+    SidebarWithDefaults,
+    HeaderWithDefaults,
+    FooterWithDefaults,
+    SidebarPrepaint,
+    DocBodyEnd,
+    DocPager
+  } = deps;
+  function DocPageShell(props) {
+    const {
+      kind,
+      locale,
+      title,
+      description,
+      canonical,
+      breadcrumbs,
+      prev,
+      next,
+      headings,
+      navSection,
+      sidebarPersistKey,
+      hideSidebar,
+      hideToc,
+      currentPath,
+      currentVersion,
+      versionSwitcher,
+      versionBanner,
+      versionBannerLatestUrl,
+      versionBannerLabels,
+      autoIndexLabel,
+      autoIndexChildren,
+      metainfoSlot,
+      contentHeaderSlot,
+      contentSlot,
+      docHistorySlot
+    } = props;
+    const tocTitle = getTocTitle(locale);
+    const shouldRenderToc = !hideToc && headings.length > 0;
+    const tocOverride = shouldRenderToc ? Island({
+      when: "load",
+      children: /* @__PURE__ */ jsx(Toc, { headings, title: tocTitle })
+    }) : void 0;
+    const mobileTocOverride = shouldRenderToc ? Island({
+      when: "load",
+      children: /* @__PURE__ */ jsx(MobileToc, { headings, title: tocTitle })
+    }) : void 0;
+    return /* @__PURE__ */ jsx(
+      DocLayoutWithDefaults,
+      {
+        title: composeMetaTitle(title),
+        description: settings.metaTags.description ? description : void 0,
+        head: /* @__PURE__ */ jsx(HeadWithDefaults, { title, description, canonical }),
+        lang: locale,
+        noindex: settings.noindex,
+        hideSidebar,
+        hideToc,
+        headings,
+        canonical,
+        sidebarPersistKey,
+        versionBanner: versionBanner ?? false,
+        versionBannerLatestUrl,
+        versionBannerLabels,
+        headerOverride: /* @__PURE__ */ jsx(
+          HeaderWithDefaults,
+          {
+            lang: locale,
+            currentSlug: props.slug,
+            navSection,
+            currentVersion,
+            currentPath
+          }
+        ),
+        breadcrumbOverride: breadcrumbs.length > 0 ? /* @__PURE__ */ jsx(Breadcrumb, { items: breadcrumbs, rightSlot: versionSwitcher }) : void 0,
+        sidebarOverride: /* @__PURE__ */ jsx(
+          SidebarWithDefaults,
+          {
+            currentSlug: props.slug,
+            lang: locale,
+            navSection,
+            currentVersion,
+            currentPath
+          }
+        ),
+        tocOverride,
+        mobileTocOverride,
+        afterSidebar: /* @__PURE__ */ jsx(SidebarPrepaint, { hideSidebar }),
+        footerOverride: /* @__PURE__ */ jsx(FooterWithDefaults, { lang: locale }),
+        bodyEndComponents: /* @__PURE__ */ jsx(DocBodyEnd, {}),
+        enableClientRouter: settings.dynamicPageTransition,
+        children: kind === "autoIndex" ? (
+          /* Auto-index page: category without an index.mdx.
+             Fragment (not <div>) so children become direct children of
+             <article class="zd-content">, picking up the flow-space rule. */
+          /* @__PURE__ */ jsxs(Fragment, { children: [
+            /* @__PURE__ */ jsx("h1", { class: "text-heading font-bold mb-vsp-xs", children: autoIndexLabel }),
+            metainfoSlot,
+            description && /* @__PURE__ */ jsx("p", { class: "mb-vsp-lg text-title text-muted", children: description }),
+            /* @__PURE__ */ jsx(NavCardGrid, { children: autoIndexChildren ?? [] })
+          ] })
+        ) : (
+          /* Regular doc page. Fragment (not <div>) for the same reason. */
+          /* @__PURE__ */ jsxs(Fragment, { children: [
+            contentHeaderSlot,
+            contentSlot,
+            /* @__PURE__ */ jsx(DocPager, { prev, next, locale }),
+            docHistorySlot
+          ] })
+        )
+      }
+    );
+  }
+  return DocPageShell;
+}
+export {
+  createDocPageShell
+};

package/dist/doc-pager/index.d.ts

@@ -0,0 +1,25 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+import type { JSX } from "preact";
+interface PagerNode {
+    href?: string;
+    label: string;
+}
+export interface DocPagerProps {
+    /** Previous page node (null = no previous page → renders placeholder). */
+    prev: PagerNode | null;
+    /** Next page node (null = no next page → renders placeholder). */
+    next: PagerNode | null;
+    /** Active locale for translated "Previous" / "Next" labels. */
+    locale: string;
+}
+/** Dependencies injected by the host stub. */
+export interface DocPagerDeps {
+    /** Translate a UI string key for a locale. */
+    t: (key: string, locale: string) => string;
+}
+/**
+ * Create a `DocPager` component bound to the host's injected `t` translator.
+ */
+export declare function createDocPager(deps: DocPagerDeps): (props: DocPagerProps) => JSX.Element;
+export {};

package/dist/doc-pager/index.js

@@ -0,0 +1,41 @@
+import { jsx, jsxs } from "preact/jsx-runtime";
+import { ChevronLeft, ChevronRight } from "../icons/index.js";
+function createDocPager(deps) {
+  const { t } = deps;
+  function DocPager({ prev, next, locale }) {
+    return /* @__PURE__ */ jsxs("nav", { class: "mt-vsp-2xl grid grid-cols-2 gap-hsp-xl", children: [
+      prev ? /* @__PURE__ */ jsxs(
+        "a",
+        {
+          href: prev.href,
+          class: "group border border-muted rounded-lg p-hsp-lg hover:border-accent",
+          children: [
+            /* @__PURE__ */ jsxs("div", { class: "flex items-center gap-hsp-xs text-caption text-muted mb-vsp-2xs", children: [
+              /* @__PURE__ */ jsx(ChevronLeft, { className: "h-[1.125rem] w-[1.125rem]" }),
+              /* @__PURE__ */ jsx("span", { class: "no-underline", children: t("nav.previous", locale) })
+            ] }),
+            /* @__PURE__ */ jsx("p", { class: "text-small font-semibold underline group-hover:text-accent", children: prev.label })
+          ]
+        }
+      ) : /* @__PURE__ */ jsx("div", {}),
+      next ? /* @__PURE__ */ jsxs(
+        "a",
+        {
+          href: next.href,
+          class: "group border border-muted rounded-lg p-hsp-lg hover:border-accent text-right",
+          children: [
+            /* @__PURE__ */ jsxs("div", { class: "flex items-center justify-end gap-hsp-xs text-caption text-muted mb-vsp-2xs", children: [
+              /* @__PURE__ */ jsx("span", { class: "no-underline", children: t("nav.next", locale) }),
+              /* @__PURE__ */ jsx(ChevronRight, { className: "h-[1.125rem] w-[1.125rem]" })
+            ] }),
+            /* @__PURE__ */ jsx("p", { class: "text-small font-semibold underline group-hover:text-accent", children: next.label })
+          ]
+        }
+      ) : /* @__PURE__ */ jsx("div", {})
+    ] });
+  }
+  return DocPager;
+}
+export {
+  createDocPager
+};