create-zudo-doc 0.2.20 → 0.2.22

package/templates/base/pages/lib/_doc-page-shell.tsx

@@ -1,263 +1,29 @@
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-// Shared render shell for all 4 doc-route page components.
-//
-// Extracted (#1917) from the near-verbatim render bodies of:
-//   pages/docs/[[...slug]].tsx
-//   pages/[locale]/docs/[[...slug]].tsx
-//   pages/v/[version]/docs/[[...slug]].tsx
-//   pages/v/[version]/[locale]/docs/[[...slug]].tsx
-//
-// This module is intentionally version- and i18n-AGNOSTIC: it imports no
-// VersionConfig and no versionedDocsUrl. Everything version/locale-specific
-// is threaded in as plain props or pre-built VNode slots, so the base EN
-// route (which ships in every scaffold, including barebones) can depend on
-// it without dragging in the versioning/i18n feature surface. The feature
-// route templates import this same module via the identical relative path,
-// keeping the create-zudo-doc template copies byte-identical to the host.
-
-import type { ComponentChildren, JSX, VNode } from "preact";
-import { Island } from "@takazudo/zfb";
+// Host thin-stub — see @takazudo/zudo-doc/doc-page-shell (epic #2344, S5).
 import { settings } from "@/config/settings";
-import type { NavNode } from "@/utils/docs";
-import { DocLayoutWithDefaults } from "@takazudo/zudo-doc/doclayout";
-import { Toc, MobileToc } from "@takazudo/zudo-doc/toc";
+import { createDocPageShell } from "@takazudo/zudo-doc/doc-page-shell";
+import { composeMetaTitle } from "./_compose-meta-title";
 import { getTocTitle } from "./_toc-title";
-import { Breadcrumb } from "@takazudo/zudo-doc/breadcrumb";
-import { NavCardGrid } from "@takazudo/zudo-doc/nav-indexing";
 import { HeadWithDefaults } from "./_head-with-defaults";
-import { composeMetaTitle } from "./_compose-meta-title";
 import { SidebarWithDefaults } from "./_sidebar-with-defaults";
 import { HeaderWithDefaults } from "./_header-with-defaults";
 import { FooterWithDefaults } from "./_footer-with-defaults";
 import { SidebarPrepaint } from "./_sidebar-prepaint";
 import { DocBodyEnd } from "./_doc-body-end";
 import { DocPager } from "./_doc-pager";
-import type { BreadcrumbItem } from "@/utils/docs";
-import type { VersionBannerLabels } from "@takazudo/zudo-doc/i18n-version";
-import type { Locale } from "@/config/i18n";
-import type { extractHeadings } from "./_extract-headings";
-
-/** 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: BreadcrumbItem[];
-  /** Pre-resolved prev/next nav nodes (hrefs already remapped per route). */
-  prev: NavNode | null;
-  next: NavNode | null;
-  /** Depth-2/3/4 headings for the SSG TOC. */
-  headings: ReturnType<typeof extractHeadings>;
-
-  /** 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.
-   * Latest routes pass docsUrl(slug, locale); versioned routes pass
-   * versionedDocsUrl(slug, version, locale).
-   */
-  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 (route-built). */
-  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?: NavNode[];
-
-  /**
-   * Auto-index branch slot: the build-time date block (DocMetainfoArea), or
-   * null to omit it. Threaded in so the shell stays oblivious to which routes
-   * render 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. Hidden on versioned pages (#1916 #5).
-   */
-  docHistorySlot?: VNode | null;
-}
-
-/**
- * Render shell shared by all 4 doc-route page components. The caller computes
- * every route-specific value (URLs, version switcher, slots) and passes it in;
- * this component only assembles the DocLayoutWithDefaults call and the two
- * body branches (auto-index vs entry).
- */
-export function DocPageShell(props: DocPageShellProps): JSX.Element {
-  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;
-
-  // TOC overrides: mount the package Toc/MobileToc with the host-resolved
-  // locale-aware `tocTitle`. The gating mirrors the package's
-  // `shouldRenderDefaultToc` exactly (`!hideToc && headings.length > 0`) so an
-  // undefined override never silently falls back to the package default with a
-  // different title. Each is wrapped in `<Island when="load">` here (the call
-  // site), matching how the package wraps its own default. Hydrating these
-  // npm-dist "use client" components requires zfb >= 0.1.0-next.39, whose
-  // scanner registers node_modules islands (zfb#999/#1001) — the former
-  // scanner-visible local shims (#2057) are gone; re-adding them would
-  // recreate island marker-name collisions.
-  const tocTitle = getTocTitle(locale);
-  const shouldRenderToc = !hideToc && headings.length > 0;
-  const tocOverride = shouldRenderToc
-    ? (Island({
-        when: "load",
-        children: <Toc headings={headings} title={tocTitle} />,
-      }) as unknown as VNode)
-    : undefined;
-  const mobileTocOverride = shouldRenderToc
-    ? (Island({
-        when: "load",
-        children: <MobileToc headings={headings} title={tocTitle} />,
-      }) as unknown as VNode)
-    : undefined;
-
-  return (
-    <DocLayoutWithDefaults
-      title={composeMetaTitle(title)}
-      // Plain <meta name="description"> is emitted by DocLayout from this prop —
-      // gate it here alongside the og:description gate inside HeadWithDefaults (#2078)
-      description={settings.metaTags.description ? description : undefined}
-      head={<HeadWithDefaults title={title} description={description} canonical={canonical} />}
-      lang={locale}
-      noindex={settings.noindex}
-      hideSidebar={hideSidebar}
-      hideToc={hideToc}
-      headings={headings}
-      canonical={canonical}
-      sidebarPersistKey={sidebarPersistKey}
-      versionBanner={versionBanner ?? false}
-      versionBannerLatestUrl={versionBannerLatestUrl}
-      versionBannerLabels={versionBannerLabels}
-      headerOverride={
-        <HeaderWithDefaults
-          lang={locale as Locale}
-          currentSlug={props.slug}
-          navSection={navSection}
-          currentVersion={currentVersion}
-          currentPath={currentPath}
-        />
-      }
-      breadcrumbOverride={
-        breadcrumbs.length > 0 ? (
-          <Breadcrumb items={breadcrumbs} rightSlot={versionSwitcher} />
-        ) : undefined
-      }
-      sidebarOverride={
-        <SidebarWithDefaults
-          currentSlug={props.slug}
-          lang={locale as Locale}
-          navSection={navSection}
-          currentVersion={currentVersion}
-          currentPath={currentPath}
-        />
-      }
-      tocOverride={tocOverride}
-      mobileTocOverride={mobileTocOverride}
-      afterSidebar={<SidebarPrepaint />}
-      footerOverride={<FooterWithDefaults lang={locale} />}
-      bodyEndComponents={<DocBodyEnd />}
-      enableClientRouter={settings.dynamicPageTransition}
-    >
-      {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
-           (.zd-content > :where(* + *) { margin-top: var(--flow-space) }).
-           Wrapping in <div> would make h1/description p children-of-children
-           and the flow gap (~24px) would never apply — see #1460. */
-        <>
-          <h1 class="text-heading font-bold mb-vsp-xs">{autoIndexLabel}</h1>
-
-          {/* Build-time date block — chrome parity (#1461). Threaded in via
-              metainfoSlot so each route controls whether it renders. */}
-          {metainfoSlot}
-
-          {description && (
-            <p class="mb-vsp-lg text-title text-muted">{description}</p>
-          )}
-          <NavCardGrid children={autoIndexChildren ?? []} />
-        </>
-      ) : (
-        /* Regular doc page. Fragment (not <div>) for the same reason as
-           the auto-index branch above — see #1460. */
-        <>
-          {contentHeaderSlot}
-
-          {contentSlot}
-
-          {/* Prev / Next pagination — placed before the document utilities
-              section to match the Astro reference order: content → pager →
-              view-source / history. Fixes #1535. */}
-          <DocPager prev={prev} next={next} locale={locale} />
 
-          {/* Document utilities (revision history + view-source link).
-              Threaded in via docHistorySlot; null on versioned pages
-              until versioned history is supported (#1916 #5). */}
-          {docHistorySlot}
-        </>
-      )}
-    </DocLayoutWithDefaults>
-  );
-}
+export type { DocPageShellProps } from "@takazudo/zudo-doc/doc-page-shell";
+
+export const DocPageShell = createDocPageShell({
+  settings,
+  composeMetaTitle,
+  getTocTitle,
+  HeadWithDefaults,
+  SidebarWithDefaults,
+  HeaderWithDefaults,
+  FooterWithDefaults,
+  SidebarPrepaint,
+  DocBodyEnd,
+  DocPager,
+});

package/templates/base/pages/lib/_doc-pager.tsx

@@ -1,79 +1,9 @@
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-// Shared prev/next pager <nav> for doc pages.
-//
-// Extracted from the four doc-route render bodies (pages/docs/[...slug].tsx,
-// pages/[locale]/docs/[...slug].tsx, pages/v/[version]/docs/[...slug].tsx,
-// pages/v/[version]/[locale]/docs/[...slug].tsx) where the block was
-// duplicated verbatim.
-//
-// Uses ChevronLeft / ChevronRight from the shared icon module
-// (@takazudo/zudo-doc/icons) rather than hand-written SVG paths, absorbing
-// the last inline chevron occurrences in the route files (see #1880 item 4).
-
-import type { JSX } from "preact";
+// Host thin-stub — see @takazudo/zudo-doc/doc-pager (epic #2344, S7).
 import { t } from "@/config/i18n";
-import { ChevronLeft, ChevronRight } from "@takazudo/zudo-doc/icons";
-
-// NavNode is a superset; we only need the fields the pager uses.
-interface PagerNode {
-  href?: string;
-  label: string;
-}
+import { createDocPager } from "@takazudo/zudo-doc/doc-pager";
 
-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;
-}
+export type { DocPagerProps } from "@takazudo/zudo-doc/doc-pager";
 
-/**
- * Prev/next pagination nav shared by all four doc-route page components.
- *
- * Renders a two-column grid: prev card on the left, next card on the right.
- * When a node is absent its slot is filled with an empty `<div>` to maintain
- * the two-column layout. Placement: immediately after MDX content, before
- * `DocHistoryArea` (Astro reference order — content → pager → utilities,
- * per #1535).
- */
-export function DocPager({ prev, next, locale }: DocPagerProps): JSX.Element {
-  return (
-    <nav class="mt-vsp-2xl grid grid-cols-2 gap-hsp-xl">
-      {prev ? (
-        <a
-          href={prev.href}
-          class="group border border-muted rounded-lg p-hsp-lg hover:border-accent"
-        >
-          <div class="flex items-center gap-hsp-xs text-caption text-muted mb-vsp-2xs">
-            <ChevronLeft className="h-[1.125rem] w-[1.125rem]" />
-            <span class="no-underline">{t("nav.previous", locale)}</span>
-          </div>
-          <p class="text-small font-semibold underline group-hover:text-accent">
-            {prev.label}
-          </p>
-        </a>
-      ) : (
-        <div />
-      )}
-      {next ? (
-        <a
-          href={next.href}
-          class="group border border-muted rounded-lg p-hsp-lg hover:border-accent text-right"
-        >
-          <div class="flex items-center justify-end gap-hsp-xs text-caption text-muted mb-vsp-2xs">
-            <span class="no-underline">{t("nav.next", locale)}</span>
-            <ChevronRight className="h-[1.125rem] w-[1.125rem]" />
-          </div>
-          <p class="text-small font-semibold underline group-hover:text-accent">
-            {next.label}
-          </p>
-        </a>
-      ) : (
-        <div />
-      )}
-    </nav>
-  );
-}
+export const DocPager = createDocPager({ t });

package/templates/base/pages/lib/_doc-route-entries.ts

@@ -1,188 +1,54 @@
-// Shared, memoized route-entry builder for the 4 doc catch-all routes.
-//
-// Extracted (#2010) from the ~85%-duplicated paths() bodies of:
-//   pages/docs/[[...slug]].tsx
-//   pages/[locale]/docs/[[...slug]].tsx
-//   pages/v/[version]/docs/[[...slug]].tsx
-//   pages/v/[version]/[locale]/docs/[[...slug]].tsx
-//
-// Each route resolves its own identity-stable nav source (resolveNavSource /
-// resolveVersionedLocaleSource) and URL closure, then delegates the per-entry
-// derived-data work here. The result is memoized with the #1902 WeakMap
-// pattern (memoizeDerived keyed on the identity-stable `source.docs` array +
-// a per-route signature), so the expensive per-entry work — extractHeadings,
-// buildBreadcrumbs, prev/next resolution — runs ONCE per entry per build,
-// not once per entry per page (zfb re-invokes paths() once per built page).
-//
-// Versioned-vs-latest behavior is keyed on the presence of `urlFor` (#1916):
-//   - `urlFor` set (versioned routes): breadcrumbs resolve against the NAV
-//     tree (unlisted excluded) with crumbs remapped to the versioned URL
-//     space; prev/next hrefs are rewritten through the closure; auto-index
-//     child-card hrefs are ALWAYS remapped to the versioned URL.
-//   - `urlFor` unset (latest routes): breadcrumbs resolve against the FULL
-//     tree (unlisted included, for accurate crumbs); prev/next and child
-//     hrefs keep the latest `docsUrl` already baked into the nav nodes.
-// These two behaviors travel together by construction: only versioned routes
-// own a versioned URL closure (see _doc-route-paths.ts for the #1916
-// rationale on why latest routes must never receive one).
-
+// Thin stub — doc-route-entries moved to the package (epic #2344, S6).
+// Calls `createDocRouteEntries(ctx)` from @takazudo/zudo-doc/doc-route-entries
+// with the host utilities injected, then re-exports the resulting builder
+// function so all existing call sites continue to work unchanged.
+
+import { createDocRouteEntries } from "@takazudo/zudo-doc/doc-route-entries";
+import type {
+  DocPageEntry,
+  DocNavNode,
+  BreadcrumbItem,
+} from "@takazudo/zudo-doc/doc-route-entries";
+export type { DocRouteEntry, BuildDocRouteEntriesArgs } from "@takazudo/zudo-doc/doc-route-entries";
 import {
   buildNavTree,
   buildBreadcrumbs,
   collectAutoIndexNodes,
   type NavNode,
+  type CategoryMeta,
 } from "@/utils/docs";
 import { getNavSectionForSlug, getNavSubtree } from "@/utils/nav-scope";
 import { toRouteSlug, toSlugParams } from "@/utils/slug";
+import type { DocsEntry } from "@/types/docs-entry";
 import type { Locale } from "@/config/i18n";
 import { extractHeadings } from "./_extract-headings";
-import type { AutoIndexNode, DocPageBaseProps } from "./doc-page-props";
-import { memoizeDerived } from "./_nav-source-cache";
-import type { NavSourceDocs } from "./_nav-source-docs";
-import {
-  resolveDocPrevNext,
-  flattenSubtree,
-  rewriteNavHref,
-  remapNavChildHrefs,
-} from "./_doc-route-paths";
-
-// ---------------------------------------------------------------------------
-// Types
-// ---------------------------------------------------------------------------
-
-/** One enumerated doc route: a content entry or an auto-generated category
- *  index, with all per-page derived data pre-computed. */
-export interface DocRouteEntry {
-  /** Canonical route slug ("" for the docs root index — #1891). */
-  slug: string;
-  /** Optional-catchall params array — `toSlugParams(slug)` ([] for the root). */
-  slugParams: string[];
-  /**
-   * True when the entry came from the base collection rather than the locale
-   * collection (`!localeSlugSet.has(slug)`). Only meaningful on routes whose
-   * nav source performs a locale merge — routes without one (default-locale /
-   * versioned-EN, where `localeSlugSet` is empty) must ignore this field.
-   * Always false for autoIndex items.
-   */
-  isFallback: boolean;
-  /** Shared page props (kind/entry/autoIndex/breadcrumbs/prev/next/headings). */
-  props: DocPageBaseProps;
-}
-
-export interface BuildDocRouteEntriesArgs {
-  /** Identity-stable nav source for this route's (locale, version) context —
-   *  from resolveNavSource / resolveVersionedLocaleSource. The memo is keyed
-   *  on `source.docs` identity, so the source MUST come from those resolvers
-   *  (a fresh array defeats the memo — harmless, but recomputes per call). */
-  source: NavSourceDocs;
-  /** Active locale for nav-tree labels and breadcrumbs. */
-  locale: Locale;
-  /**
-   * Unique memo signature for this route context. Each route file passes its
-   * own prefix plus the loop variables (version slug / locale), e.g.
-   * "docs;en", "locale-docs;ja", "v-docs;1.0", "v-locale-docs;1.0;ja" —
-   * call sites that share a docs array identity must never collide on a key.
-   */
-  routeSig: string;
-  /** Versioned URL closure bound to the route's version (+ locale). Presence
-   *  switches the versioned behaviors documented in the module header. */
-  urlFor?: (slug: string) => string;
-}
-
-// ---------------------------------------------------------------------------
-// buildDocRouteEntries
-// ---------------------------------------------------------------------------
-
-/**
- * Enumerate all doc routes (content entries + auto-index pages) for one
- * (locale, version) context, with per-entry derived data pre-computed.
- *
- * Memoized per build on the identity-stable `source.docs` array (#1902), so
- * repeated paths() invocations across the route's many pages return the SAME
- * array instance without redoing the per-entry work. In the no-snapshot
- * fallback path (unit tests / direct Node runs) `source.docs` is a fresh
- * array per call, so the memo misses and this computes fresh — matching the
- * deliberate no-memo policy in _nav-source-cache.ts.
- */
-export function buildDocRouteEntries(
-  args: BuildDocRouteEntriesArgs,
-): DocRouteEntry[] {
-  const { source, locale, routeSig, urlFor } = args;
-
-  return memoizeDerived([source.docs], `docRouteEntries;${routeSig}`, () => {
-    const { docs, navDocs, categoryMeta, localeSlugSet } = source;
-
-    // Nav docs: exclude unlisted (for sidebar/prev-next) but keep for breadcrumbs
-    const tree = buildNavTree(navDocs, locale, categoryMeta);
-    // Breadcrumb tree: latest routes use the full tree (including unlisted)
-    // for accurate crumbs; versioned routes resolve crumbs against the nav
-    // tree itself (#1916 #1).
-    const breadcrumbTree = urlFor ? tree : buildNavTree(docs, locale, categoryMeta);
-
-    const result: DocRouteEntry[] = [];
-
-    // Regular doc pages
-    for (const entry of docs) {
-      // A `category_no_page` index.mdx carries category metadata only — keep
-      // it in the nav tree (built above, used for breadcrumbs) but emit NO
-      // route for it. zfb's walker retains every .mdx as a collection entry,
-      // so without this explicit skip the metadata file would silently add a
-      // route.
-      if (entry.data.category_no_page === true) continue;
-      // Canonical route slug via the one shared rule (@/utils/slug) — yields
-      // "" for a root index (URL /docs/ — #1891).
-      const slug = entry.data.slug ?? toRouteSlug(entry.slug);
-      const navSection = getNavSectionForSlug(slug);
-      const subtree = getNavSubtree(tree, navSection);
-
-      // Prev/next + frontmatter pagination overrides resolved against THIS
-      // route's own `tree`; versioned routes then rewrite the hrefs through
-      // their urlFor closure (latest routes pass it through unchanged).
-      const { prev: prevNode, next: nextNode } = resolveDocPrevNext(
-        tree,
-        flattenSubtree(subtree),
-        slug,
-        entry.data,
-      );
-
-      result.push({
-        slug,
-        slugParams: toSlugParams(slug),
-        isFallback: !localeSlugSet.has(slug),
-        props: {
-          kind: "entry",
-          entry,
-          breadcrumbs: buildBreadcrumbs(breadcrumbTree, slug, locale, urlFor),
-          prev: rewriteNavHref(prevNode, urlFor),
-          next: rewriteNavHref(nextNode, urlFor),
-          headings: extractHeadings(entry.body ?? ""),
-        },
-      });
-    }
-
-    // Auto-generated index pages for categories without index.mdx
-    for (const node of collectAutoIndexNodes(tree)) {
-      result.push({
-        slug: node.slug,
-        slugParams: toSlugParams(node.slug),
-        isFallback: false,
-        props: {
-          kind: "autoIndex",
-          autoIndex: urlFor
-            ? // #1916 #2: child-card hrefs ALWAYS resolve to the versioned URL.
-              ({
-                ...node,
-                children: remapNavChildHrefs(node.children, urlFor) as NavNode[],
-              } as AutoIndexNode)
-            : (node as AutoIndexNode),
-          breadcrumbs: buildBreadcrumbs(breadcrumbTree, node.slug, locale, urlFor),
-          prev: null,
-          next: null,
-          headings: [],
-        },
-      });
-    }
 
-    return result;
-  });
-}
+export const { buildDocRouteEntries } = createDocRouteEntries({
+  // The factory describes its injected nav builders with the package's own
+  // structural counterparts (DocPageEntry / DocNavNode / Map<string, unknown>)
+  // and a plain `locale: string`. The host's buildNavTree / buildBreadcrumbs
+  // are typed against the concrete project types (DocsEntry / NavNode / the
+  // Locale union / Map<string, CategoryMeta>). They are runtime-identical, so
+  // the stub adapts them with thin wrappers that cast at the injection boundary
+  // where the host owns the type knowledge.
+  buildNavTree: (docs: DocPageEntry[], locale: string, categoryMeta: Map<string, unknown>) =>
+    buildNavTree(
+      docs as unknown as DocsEntry[],
+      locale as Locale,
+      categoryMeta as Map<string, CategoryMeta>,
+    ) as DocNavNode[],
+  buildBreadcrumbs: (
+    tree: DocNavNode[],
+    slug: string,
+    locale: string,
+    urlFor?: (slug: string) => string,
+  ): BreadcrumbItem[] =>
+    buildBreadcrumbs(tree as NavNode[], slug, locale as Locale, urlFor),
+  collectAutoIndexNodes: (tree: DocNavNode[]) =>
+    collectAutoIndexNodes(tree as NavNode[]) as DocNavNode[],
+  getNavSectionForSlug,
+  getNavSubtree,
+  toRouteSlug,
+  toSlugParams,
+  extractHeadings,
+});