create-zudo-doc 0.2.0 → 0.2.2

package/templates/features/versioning/files/pages/lib/_versions-page.tsx

@@ -0,0 +1,79 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+// Shared renderer for the documentation-versions pages (#2010).
+//
+// Collapses the per-locale page pair:
+//   pages/docs/versions.tsx + pages/[locale]/docs/versions.tsx
+// into one locale-parameterized renderer. The page files stay thin shells
+// that own only their paths() param shapes; URL prefixes and the
+// default-vs-locale href shapes live here.
+
+import { settings } from "@/config/settings";
+import { defaultLocale, t, type Locale } from "@/config/i18n";
+import { withBase } from "@/utils/base";
+import { DocLayoutWithDefaults } from "@takazudo/zudo-doc/doclayout";
+import { VersionsPageContent } from "@takazudo/zudo-doc/nav-indexing";
+import type { VersionPageEntry, VersionsPageLabels } from "@takazudo/zudo-doc/nav-indexing";
+import type { JSX } from "preact";
+import { FooterWithDefaults } from "./_footer-with-defaults";
+import { HeaderWithDefaults } from "./_header-with-defaults";
+import { HeadWithDefaults } from "./_head-with-defaults";
+import { composeMetaTitle } from "./_compose-meta-title";
+import { BodyEndIslands } from "./_body-end-islands";
+
+/** Versions index page for one locale. Lists the latest version and any past
+ *  versions configured in settings.versions. */
+export function VersionsPageView({ locale }: { locale: string }): JSX.Element {
+  const isDefault = locale === defaultLocale;
+  const prefix = isDefault ? "" : `/${locale}`;
+  const pageTitle = t("version.page.title", locale);
+
+  const labels: VersionsPageLabels = {
+    pageTitle,
+    latestTitle: t("version.page.latest.title", locale),
+    latestDescription: t("version.page.latest.description", locale),
+    latestLink: t("version.page.latest.link", locale),
+    pastTitle: t("version.page.past.title", locale),
+    pastDescription: t("version.page.past.description", locale),
+    unmaintained: t("version.page.unmaintained", locale),
+    unreleased: t("version.page.unreleased", locale),
+    versionCol: t("version.switcher.label", locale),
+    statusCol: t("version.page.status", locale),
+    docsCol: t("version.page.docs", locale),
+  };
+
+  // Latest docs href — points to the default docs entry point
+  const latestHref = withBase(`${prefix}/docs/getting-started`);
+
+  // Past version entries from settings
+  const versions: VersionPageEntry[] = settings.versions
+    ? settings.versions.map((v) => ({
+        slug: v.slug,
+        label: v.label ?? v.slug,
+        // Version prefix comes BEFORE the locale — the only routed shape is
+        // pages/v/[version]/{locale}/docs/...; /{locale}/v/... has no route.
+        docsHref: withBase(`/v/${v.slug}${prefix}/docs/getting-started/`),
+        banner: v.banner as "unmaintained" | "unreleased" | undefined,
+      }))
+    : [];
+
+  return (
+    <DocLayoutWithDefaults
+      title={composeMetaTitle(pageTitle)}
+      head={<HeadWithDefaults title={pageTitle} />}
+      lang={locale}
+      noindex={settings.noindex}
+      hideSidebar={true}
+      hideToc={true}
+      headerOverride={<HeaderWithDefaults lang={locale as Locale} currentPath={withBase(`${prefix}/docs/versions`)} />}
+      footerOverride={<FooterWithDefaults lang={locale} />}
+      bodyEndComponents={<BodyEndIslands basePath={settings.base ?? "/"} />}
+    >
+      <VersionsPageContent
+        latestHref={latestHref}
+        versions={versions}
+        labels={labels}
+      />
+    </DocLayoutWithDefaults>
+  );
+}

package/templates/features/versioning/files/pages/v/[version]/[locale]/docs/[[...slug]].tsx

@@ -19,30 +19,21 @@
 //
 // Prev/next hrefs are pre-resolved to the versioned locale URL form
 // (e.g. /v/1.0/ja/docs/…) so the component needs no URL computation.
+//
+// Enumeration + per-entry derived data are built by the shared, memoized
+// buildDocRouteEntries (#2010); rendering by the shared renderDocPage. This
+// file owns only the route's nav source, its versioned-locale URL closure,
+// and the param/prop shapes.
 
 import { settings } from "@/config/settings";
 import type { VersionConfig } from "@/config/settings";
-import { t } from "@/config/i18n";
-import { docsUrl, versionedDocsUrl, absoluteUrl } from "@/utils/base";
-import {
-  buildNavTree,
-  buildBreadcrumbs,
-  collectAutoIndexNodes,
-  type NavNode,
-} from "@/utils/docs";
-import { getNavSectionForSlug, getNavSubtree } from "@/utils/nav-scope";
-import { toRouteSlug, toSlugParams } from "@/utils/slug";
-// Locale-aware MDX components factory — see `pages/_mdx-components.ts`.
-import { createMdxComponents } from "../../../../_mdx-components";
+import { type Locale } from "@/config/i18n";
+import { versionedDocsUrl } from "@/utils/base";
 import type { JSX } from "preact";
 import { resolveVersionedLocaleSource } from "../../../../lib/_nav-source-docs";
-import { extractHeadings } from "../../../../lib/_extract-headings";
-import type { DocPageEntry, AutoIndexNode, DocPageEntryProps, DocPageAutoIndexProps } from "../../../../lib/doc-page-props";
-import { DocMetainfoArea } from "../../../../lib/_doc-metainfo-area";
-import { buildInlineVersionSwitcher } from "../../../../lib/_inline-version-switcher";
-import { DocContentHeader } from "../../../../lib/_doc-content-header";
-import { DocPageShell } from "../../../../lib/_doc-page-shell";
-import { resolveDocPrevNext, flattenSubtree, rewriteNavHref, remapNavChildHrefs } from "../../../../lib/_doc-route-paths";
+import type { DocPageEntryProps, DocPageAutoIndexProps } from "../../../../lib/doc-page-props";
+import { buildDocRouteEntries } from "../../../../lib/_doc-route-entries";
+import { renderDocPage } from "../../../../lib/_doc-page-renderer";
 
 export const frontmatter = { title: "Docs" };
 
@@ -50,8 +41,6 @@ export const frontmatter = { title: "Docs" };
 // Types
 // ---------------------------------------------------------------------------
 
-// DocPageEntry, AutoIndexNode imported from pages/lib/doc-page-props.ts
-
 /** Route-specific extra fields — present on both branches of the union. */
 interface VersionedLocaleDocPageExtra {
   /** The version config for the active version. */
@@ -102,87 +91,43 @@ export function paths(): Array<{
 
       // Identity-stable, locale-first merge over the version's EN base. Reused
       // across the route's per-page paths() invocations so buildNavTree's
-      // identity fast-path applies — see pages/lib/_nav-source-docs.ts (#1902).
-      const { docs: allDocs, navDocs, categoryMeta, localeSlugSet } =
-        resolveVersionedLocaleSource(version.slug, version.docsDir, locale, localeDir, {
-          applyDefaultLocaleOnlyFilter: true,
-          keepUnlisted: true,
-        });
-      // isFallback: page came from base docs, not the locale collection.
-      // toRouteSlug keeps Set keys and lookup keys in lockstep — a versioned
-      // root index has entry.slug="index" (storage form) but route slug="" so
-      // d.id would diverge from the lookup key after the #1891 toRouteSlug flip.
-      const fallbackSlugs = new Set(
-        allDocs
-          .filter((d) => !localeSlugSet.has(d.data.slug ?? toRouteSlug(d.slug)))
-          .map((d) => d.data.slug ?? toRouteSlug(d.slug)),
+      // identity fast-path and the buildDocRouteEntries memo apply — see
+      // pages/lib/_nav-source-docs.ts (#1902).
+      const source = resolveVersionedLocaleSource(
+        version.slug,
+        version.docsDir,
+        locale as Locale,
+        localeDir,
+        { applyDefaultLocaleOnlyFilter: true, keepUnlisted: true },
       );
 
-      const tree = buildNavTree(navDocs, locale, categoryMeta);
-
       // URL closure for THIS (version, locale) — every versioned-locale href
       // (prev/next, breadcrumb crumbs, auto-index cards) is produced by this
       // single function bound to the version slug + locale, resolved against
-      // this route's own `tree` (#1916).
-      const urlFor = (s: string): string => versionedDocsUrl(s, version.slug, locale);
-
-      // Regular doc pages
-      for (const entry of allDocs) {
-        // A `category_no_page` index.mdx is metadata-only — kept in the nav
-        // tree for breadcrumbs but emits no route (zfb retains every .mdx as a
-        // collection entry, so the skip must be explicit).
-        if (entry.data.category_no_page === true) continue;
-        const slug = entry.data.slug ?? toRouteSlug(entry.slug);
-        const isFallback = fallbackSlugs.has(slug);
-        const entryContentDir = isFallback ? version.docsDir : (localeDir ?? version.docsDir);
-
-        const navSection = getNavSectionForSlug(slug);
-        const subtree = getNavSubtree(tree, navSection);
-
-        const { prev: prevNode, next: nextNode } = resolveDocPrevNext(
-          tree,
-          flattenSubtree(subtree),
-          slug,
-          entry.data,
-        );
-
-        result.push({
-          params: { version: version.slug, locale, slug: toSlugParams(slug) },
-          props: {
-            kind: "entry",
-            entry,
-            version,
-            contentDir: entryContentDir,
-            isFallback,
-            // #1916 #1: breadcrumb crumbs remapped to the versioned locale URL.
-            breadcrumbs: buildBreadcrumbs(tree, 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)) {
+      // this route's own tree (#1916).
+      const urlFor = (s: string): string => versionedDocsUrl(s, version.slug, locale as Locale);
+
+      for (const item of buildDocRouteEntries({
+        source,
+        locale: locale as Locale,
+        routeSig: `v-locale-docs;${version.slug};${locale}`,
+        urlFor,
+      })) {
+        // isFallback: page came from the version's base EN docs, not the
+        // locale collection. Always false for autoIndex items.
+        const extra: VersionedLocaleDocPageExtra = {
+          version,
+          contentDir: item.isFallback
+            ? version.docsDir
+            : (localeDir ?? version.docsDir),
+          isFallback: item.isFallback,
+        };
         result.push({
-          params: { version: version.slug, locale, slug: toSlugParams(node.slug) },
-          props: {
-            kind: "autoIndex",
-            autoIndex: {
-              ...node,
-              // #1916 #2: child-card hrefs ALWAYS resolve to the versioned URL.
-              children: remapNavChildHrefs(node.children, urlFor) as NavNode[],
-            } as AutoIndexNode,
-            version,
-            contentDir: localeDir ?? version.docsDir,
-            isFallback: false,
-            // #1916 #1: breadcrumb crumbs remapped to the versioned locale URL.
-            breadcrumbs: buildBreadcrumbs(tree, node.slug, locale, urlFor),
-            prev: null,
-            next: null,
-            headings: [],
-          },
+          params: { version: version.slug, locale, slug: item.slugParams },
+          props:
+            item.props.kind === "entry"
+              ? { ...item.props, ...extra }
+              : { ...item.props, ...extra },
         });
       }
     }
@@ -198,99 +143,9 @@ export function paths(): Array<{
 type PageArgs = DocPageProps & { params: { version: string; locale: string; slug: string[] } };
 
 export default function VersionedLocaleDocsPage(props: PageArgs): JSX.Element {
-  const { breadcrumbs, prev, next, headings, version, isFallback } = props;
-  const locale = props.params.locale;
-
-  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;
-
-  // Locale-aware components bag — creates nav wrappers bound to the active
-  // locale so CategoryNav/CategoryTreeNav/SiteTreeNav query the right collection.
-  const components = createMdxComponents(locale);
-
-  // #1916 #2: child cards already carry versioned hrefs from paths(); just
-  // filter to renderable nodes here.
-  const autoIndexChildren = props.kind === "autoIndex"
-    ? props.autoIndex.children.filter((c: NavNode) => c.hasPage || c.children.length > 0)
-    : [];
-
-  // Version banner: drives the `<VersionBanner>` element inside
-  // DocLayoutWithDefaults when `version.banner` is "unmaintained" or
-  // "unreleased". The banner links out to the latest version of the
-  // current page (slug-preserving — strips the /v/{version}/ prefix,
-  // keeps the /{locale}/ locale prefix).
-  const versionBannerType = version.banner ? version.banner : undefined;
-  const versionBannerLatestUrl = versionBannerType
-    ? docsUrl(slug, locale)
-    : undefined;
-  const versionBannerLabels = versionBannerType
-    ? {
-        message:
-          versionBannerType === "unmaintained"
-            ? t("version.banner.unmaintained", locale)
-            : t("version.banner.unreleased", locale),
-        latestLink: t("version.banner.latestLink", locale),
-      }
-    : undefined;
-
-  // Canonical URL — versioned locale pages use the versioned locale URL as canonical.
-  const currentPath = versionedDocsUrl(slug, version.slug, locale);
-  const canonical = absoluteUrl(currentPath);
-
-  // Persist key: locale + nav-section so the sidebar DOM node is reused
-  // across same-locale + same-section navigations only. No sanitizer needed —
-  // both lang (BCP-47 locale string) and navSection (filesystem-derived
-  // kebab-case slug) come from controlled, trusted sources.
-  const navSection = getNavSectionForSlug(slug);
-  const hideSidebar = props.kind === "entry" ? props.entry.data.hide_sidebar : undefined;
-  const sidebarPersistKey = hideSidebar
-    ? undefined
-    : `sidebar-${locale}-${navSection ?? "default"}`;
-
-  return (
-    <DocPageShell
-      kind={props.kind}
-      locale={locale}
-      slug={slug}
-      title={title}
-      description={description}
-      canonical={canonical}
-      breadcrumbs={breadcrumbs}
-      prev={prev}
-      next={next}
-      headings={headings}
-      navSection={navSection}
-      sidebarPersistKey={sidebarPersistKey}
-      hideSidebar={hideSidebar}
-      hideToc={props.kind === "entry" ? props.entry.data.hide_toc : undefined}
-      currentPath={currentPath}
-      currentVersion={version.slug}
-      versionSwitcher={buildInlineVersionSwitcher(slug, locale, version.slug)}
-      versionBanner={versionBannerType}
-      versionBannerLatestUrl={versionBannerLatestUrl}
-      versionBannerLabels={versionBannerLabels}
-      autoIndexLabel={props.kind === "autoIndex" ? props.autoIndex.label : undefined}
-      autoIndexChildren={autoIndexChildren}
-      // #1916 #6: add DocMetainfoArea for chrome parity with the other 3
-      // doc routes (its absence here was accidental drift, not intentional).
-      metainfoSlot={
-        props.kind === "autoIndex" ? <DocMetainfoArea slug={slug} locale={locale} /> : null
-      }
-      contentHeaderSlot={
-        props.kind === "entry" ? (
-          <DocContentHeader entry={props.entry} slug={slug} locale={locale} isFallback={isFallback} />
-        ) : undefined
-      }
-      contentSlot={
-        props.kind === "entry" ? <props.entry.Content components={components} /> : undefined
-      }
-      // #1916 #5: doc-history hidden on versioned pages until versioned
-      // history is supported.
-      docHistorySlot={null}
-    />
-  );
+  return renderDocPage(props, {
+    locale: props.params.locale as Locale,
+    version: props.version,
+    isFallback: props.isFallback,
+  });
 }

package/templates/features/versioning/files/pages/v/[version]/docs/[[...slug]].tsx

@@ -19,30 +19,20 @@
 //
 // Version banner: if version.banner is set ("unmaintained" | "unreleased"),
 // the DocLayoutWithDefaults version-banner prop drives the banner display.
+//
+// Enumeration + per-entry derived data are built by the shared, memoized
+// buildDocRouteEntries (#2010); rendering by the shared renderDocPage. This
+// file owns only the route's nav source, its versioned URL closure, and the
+// param/prop shapes.
 
 import { settings } from "@/config/settings";
 import type { VersionConfig } from "@/config/settings";
-import { t } from "@/config/i18n";
-import { docsUrl, versionedDocsUrl, absoluteUrl } from "@/utils/base";
-import {
-  buildNavTree,
-  buildBreadcrumbs,
-  collectAutoIndexNodes,
-  type NavNode,
-} from "@/utils/docs";
-import { getNavSectionForSlug, getNavSubtree } from "@/utils/nav-scope";
-import { toRouteSlug, toSlugParams } from "@/utils/slug";
-// Locale-aware MDX components factory — see `pages/_mdx-components.ts`.
-import { createMdxComponents } from "../../../_mdx-components";
+import { versionedDocsUrl } from "@/utils/base";
 import type { JSX } from "preact";
 import { resolveNavSource } from "../../../lib/_nav-source-docs";
-import { extractHeadings } from "../../../lib/_extract-headings";
-import type { DocPageEntry, AutoIndexNode, DocPageEntryProps, DocPageAutoIndexProps } from "../../../lib/doc-page-props";
-import { DocMetainfoArea } from "../../../lib/_doc-metainfo-area";
-import { buildInlineVersionSwitcher } from "../../../lib/_inline-version-switcher";
-import { DocContentHeader } from "../../../lib/_doc-content-header";
-import { DocPageShell } from "../../../lib/_doc-page-shell";
-import { resolveDocPrevNext, flattenSubtree, rewriteNavHref, remapNavChildHrefs } from "../../../lib/_doc-route-paths";
+import type { DocPageEntryProps, DocPageAutoIndexProps } from "../../../lib/doc-page-props";
+import { buildDocRouteEntries } from "../../../lib/_doc-route-entries";
+import { renderDocPage } from "../../../lib/_doc-page-renderer";
 
 export const frontmatter = { title: "Docs" };
 
@@ -50,8 +40,6 @@ export const frontmatter = { title: "Docs" };
 // Types
 // ---------------------------------------------------------------------------
 
-// DocPageEntry, AutoIndexNode imported from pages/lib/doc-page-props.ts
-
 /** Route-specific extra fields — present on both branches of the union. */
 interface VersionedDocPageExtra {
   /** The version config for the active version. */
@@ -89,73 +77,31 @@ export function paths(): Array<{
   for (const version of settings.versions) {
     // Identity-stable nav source for this version (EN base, draft-filtered,
     // unlisted retained). Reused across the route's per-page paths()
-    // invocations so buildNavTree's identity fast-path applies — see
-    // pages/lib/_nav-source-docs.ts (#1902).
-    const { docs: allDocs, navDocs, categoryMeta } = resolveNavSource("en", version.slug);
-    // Versioned docs always use EN locale for nav tree
-    const tree = buildNavTree(navDocs, "en", categoryMeta);
+    // invocations so buildNavTree's identity fast-path and the
+    // buildDocRouteEntries memo apply — see pages/lib/_nav-source-docs.ts
+    // (#1902). Versioned docs always use EN locale for the nav tree.
+    const source = resolveNavSource("en", version.slug);
 
     // URL closure for THIS version — every versioned href (prev/next,
     // breadcrumb crumbs, auto-index cards) is produced by this single
     // function bound to the version slug. Because it is built per-version
-    // inside this loop, a latest-page pagination override (resolved against
-    // `tree` below) is rewritten through the VERSIONED closure for this route
-    // only — it can never bleed into the latest route, which has no such
-    // closure (#1916).
+    // inside this loop, a latest-page pagination override is rewritten
+    // through the VERSIONED closure for this route only — it can never bleed
+    // into the latest route, which has no such closure (#1916).
     const urlFor = (s: string): string => versionedDocsUrl(s, version.slug);
 
-    // Regular doc pages
-    for (const entry of allDocs) {
-      // A `category_no_page` index.mdx is metadata-only — kept in the nav tree
-      // for breadcrumbs but emits no route (zfb retains every .mdx as a
-      // collection entry, so the skip must be explicit).
-      if (entry.data.category_no_page === true) continue;
-      const slug = entry.data.slug ?? toRouteSlug(entry.slug);
-      const navSection = getNavSectionForSlug(slug);
-      const subtree = getNavSubtree(tree, navSection);
-
-      // Prev/next + pagination overrides against THIS version's own `tree`,
-      // then hrefs rewritten to the versioned URL form via urlFor.
-      const { prev: prevNode, next: nextNode } = resolveDocPrevNext(
-        tree,
-        flattenSubtree(subtree),
-        slug,
-        entry.data,
-      );
-
-      result.push({
-        params: { version: version.slug, slug: toSlugParams(slug) },
-        props: {
-          kind: "entry",
-          entry,
-          version,
-          // #1916 #1: breadcrumb crumbs remapped to the versioned URL space.
-          breadcrumbs: buildBreadcrumbs(tree, slug, "en", 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)) {
+    for (const item of buildDocRouteEntries({
+      source,
+      locale: "en",
+      routeSig: `v-docs;${version.slug}`,
+      urlFor,
+    })) {
       result.push({
-        params: { version: version.slug, slug: toSlugParams(node.slug) },
-        props: {
-          kind: "autoIndex",
-          autoIndex: {
-            ...node,
-            // #1916 #2: child-card hrefs ALWAYS resolve to the versioned URL.
-            children: remapNavChildHrefs(node.children, urlFor) as NavNode[],
-          } as AutoIndexNode,
-          version,
-          // #1916 #1: breadcrumb crumbs remapped to the versioned URL space.
-          breadcrumbs: buildBreadcrumbs(tree, node.slug, "en", urlFor),
-          prev: null,
-          next: null,
-          headings: [],
-        },
+        params: { version: version.slug, slug: item.slugParams },
+        props:
+          item.props.kind === "entry"
+            ? { ...item.props, version }
+            : { ...item.props, version },
       });
     }
   }
@@ -170,96 +116,8 @@ export function paths(): Array<{
 type PageArgs = DocPageProps & { params: { version: string; slug: string[] } };
 
 export default function VersionedDocsPage(props: PageArgs): JSX.Element {
-  const { breadcrumbs, prev, next, headings, version } = props;
-  const locale = "en";
-
-  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;
-
-  // Locale-aware components bag — creates nav wrappers bound to the active
-  // locale so CategoryNav/CategoryTreeNav/SiteTreeNav query the right collection.
-  const components = createMdxComponents(locale);
-
-  // #1916 #2: child cards already carry versioned hrefs from paths(); just
-  // filter to renderable nodes here.
-  const autoIndexChildren = props.kind === "autoIndex"
-    ? props.autoIndex.children.filter((c: NavNode) => c.hasPage || c.children.length > 0)
-    : [];
-
-  // Version banner: drives the `<VersionBanner>` element inside
-  // DocLayoutWithDefaults when `version.banner` is "unmaintained" or
-  // "unreleased". The banner links out to the latest version of the
-  // current page (slug-preserving — strips the /v/{version}/ prefix).
-  const versionBannerType = version.banner ? version.banner : undefined;
-  const versionBannerLatestUrl = versionBannerType
-    ? docsUrl(slug, locale)
-    : undefined;
-  const versionBannerLabels = versionBannerType
-    ? {
-        message:
-          versionBannerType === "unmaintained"
-            ? t("version.banner.unmaintained", locale)
-            : t("version.banner.unreleased", locale),
-        latestLink: t("version.banner.latestLink", locale),
-      }
-    : undefined;
-
-  // Canonical URL — versioned pages use the versioned URL as canonical.
-  const currentPath = versionedDocsUrl(slug, version.slug, locale);
-  const canonical = absoluteUrl(currentPath);
-
-  // Persist key: locale + nav-section so the sidebar DOM node is reused
-  // across same-locale + same-section navigations only. No sanitizer needed —
-  // both lang (BCP-47 locale string) and navSection (filesystem-derived
-  // kebab-case slug) come from controlled, trusted sources.
-  const navSection = getNavSectionForSlug(slug);
-  const hideSidebar = props.kind === "entry" ? props.entry.data.hide_sidebar : undefined;
-  const sidebarPersistKey = hideSidebar
-    ? undefined
-    : `sidebar-${locale}-${navSection ?? "default"}`;
-
-  return (
-    <DocPageShell
-      kind={props.kind}
-      locale={locale}
-      slug={slug}
-      title={title}
-      description={description}
-      canonical={canonical}
-      breadcrumbs={breadcrumbs}
-      prev={prev}
-      next={next}
-      headings={headings}
-      navSection={navSection}
-      sidebarPersistKey={sidebarPersistKey}
-      hideSidebar={hideSidebar}
-      hideToc={props.kind === "entry" ? props.entry.data.hide_toc : undefined}
-      currentPath={currentPath}
-      currentVersion={version.slug}
-      versionSwitcher={buildInlineVersionSwitcher(slug, locale, version.slug)}
-      versionBanner={versionBannerType}
-      versionBannerLatestUrl={versionBannerLatestUrl}
-      versionBannerLabels={versionBannerLabels}
-      autoIndexLabel={props.kind === "autoIndex" ? props.autoIndex.label : undefined}
-      autoIndexChildren={autoIndexChildren}
-      metainfoSlot={
-        props.kind === "autoIndex" ? <DocMetainfoArea slug={slug} locale={locale} /> : null
-      }
-      contentHeaderSlot={
-        props.kind === "entry" ? (
-          <DocContentHeader entry={props.entry} slug={slug} locale={locale} />
-        ) : undefined
-      }
-      contentSlot={
-        props.kind === "entry" ? <props.entry.Content components={components} /> : undefined
-      }
-      // #1916 #5: doc-history hidden on versioned pages until versioned
-      // history is supported.
-      docHistorySlot={null}
-    />
-  );
+  return renderDocPage(props, {
+    locale: "en",
+    version: props.version,
+  });
 }

package/templates/base/src/components/content/heading-h3.tsx

@@ -1,20 +0,0 @@
-import type { CSSProperties } from 'react';
-
-type Props = React.ComponentPropsWithoutRef<'h3'>;
-
-export function HeadingH3({ id, children, className, ...rest }: Props) {
-  return (
-    <h3
-      id={id}
-      className={`text-body font-bold leading-snug pt-vsp-xs border-t-[2px] border-transparent${className ? ` ${className}` : ''}`}
-      style={
-        {
-          borderImage: 'linear-gradient(to right, var(--color-muted), transparent) 1',
-        } as CSSProperties
-      }
-      {...rest}
-    >
-      {children}
-    </h3>
-  );
-}