create-zudo-doc 0.2.21 → 0.2.22

package/templates/base/pages/lib/_doc-history-area.tsx

@@ -1,35 +1,15 @@
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-// Locale-aware DocHistory area wrapper for the zfb doc pages.
+// Host thin-stub — see @takazudo/zudo-doc/doc-history-area (epic #2344, S7).
 //
-// Mirrors the Phase B-1 pattern used by _footer-with-defaults.tsx: this
-// wrapper lives in pages/lib/ with a leading underscore so the zfb router
-// skips it as a page module, while the two doc-page modules
-// (docs/[...slug].tsx and [locale]/docs/[...slug].tsx) import it directly.
-// It gates on settings.docHistory, resolves the correct locale prop
-// (omitted for the default locale, matching the doc-history fetch-path
-// branch in src/components/doc-history.tsx), and passes the assembled
-// island into BodyFootUtilArea — restoring the
-// `<section aria-label="Document utilities">` landmark and its Revision
-// History heading in the SSG output for all zfb doc routes.
-//
-// Wave 8 (Path A — super-epic #1333 / child epic #1355): the doc-history
-// island is now built right here using zfb's native `<Island ssrFallback>`
-// API with the real DocHistory component imported from
-// `@/components/doc-history`. Previously this file passed
-// DocHistoryIslandProps to BodyFootUtilArea, which fed an SSR-skip
-// wrapper that did not import the real component — the orphan-component
-// bug that left the marker un-bundled. The host-side import here is the
-// page → real-component chain zfb's island scanner walks.
-
-import type { VNode } from "preact";
-import { Island } from "@takazudo/zfb";
+// The DocHistory import is kept here so zfb's island scanner walks the chain:
+// page → stub → DocHistory. The factory receives the constructor via deps.
 import { settings } from "@/config/settings";
 import { defaultLocale, t } from "@/config/i18n";
-import { BodyFootUtilArea } from "@takazudo/zudo-doc/body-foot-util";
-import { buildGitHubSourceUrl } from "@/utils/github";
-import { DocHistory } from "@/components/doc-history";
 import { toHistorySlug } from "@/utils/slug";
+import { buildGitHubSourceUrl as _buildGitHubSourceUrl } from "@/utils/github";
+import { createDocHistoryArea } from "@takazudo/zudo-doc/doc-history-area";
+import { DocHistory } from "@takazudo/zudo-doc/doc-history";
 // SSR author + date metadata comes from `.zfb/doc-history-meta.json`, a
 // build-time manifest emitted by `scripts/zfb-prebuild.mjs` (step 2:
 // doc-history-meta) before `zfb build` runs. esbuild inlines the JSON
@@ -39,188 +19,16 @@ import { toHistorySlug } from "@/utils/slug";
 // because the zfb bundler builds pages from a shadow tree; relative paths
 // across the shadow boundary would resolve to the wrong location.
 import docHistoryMeta from "#doc-history-meta";
-
-// Set explicit `displayName` on the named-export DocHistory so zfb's
-// `captureComponentName` produces a stable marker even after the SSR
-// pipeline runs the component through a function-name-rewriting layer.
-// (DocHistory is `export function DocHistory(...)` — `name` is already
-// "DocHistory" but the explicit assignment is a guard for production
-// minification regressions, mirroring the BodyEndIslands helper.)
-(DocHistory as { displayName?: string }).displayName = "DocHistory";
-
-interface DocHistoryAreaProps {
-  /** Page slug, e.g. "getting-started/intro". */
-  slug: string;
-  /** Active locale string, e.g. "en", "ja". */
-  locale: string;
-  /**
-   * Raw zfb entry slug (relative path without extension), e.g.
-   * "getting-started/intro" or "getting-started/index". Appended with
-   * the source extension from the build-time manifest (".mdx" fallback)
-   * to form the file path passed to buildGitHubSourceUrl.
-   * Omit for auto-index pages (no underlying MDX file) — sourceUrl
-   * will be suppressed automatically.
-   */
-  entrySlug?: string;
-  /**
-   * Content directory for the active locale, e.g. "src/content/docs"
-   * or "src/content/docs-ja". Combined with entrySlug to build the
-   * view-source GitHub URL. Omit to suppress the view-source link.
-   */
-  contentDir?: string;
-  /**
-   * True when this locale page falls back to the base EN collection
-   * (i.e. the slug has no translation for the active locale). When true,
-   * the history data-path derivations use defaultLocale so the island
-   * fetches the correct bare-slug JSON and the SSR manifest lookup hits
-   * the bare key — both of which only exist for EN-origin files.
-   * Display labels (t() calls) still use the active locale so JA users
-   * see JA labels on fallback pages. Omit (or false) for translated pages
-   * and all other call sites (EN route, tag pages) — behavior unchanged.
-   */
-  isFallback?: boolean;
-}
-
-/**
- * Renders the `<BodyFootUtilArea>` shell with a doc-history island when
- * `settings.docHistory` is enabled.  Returns null otherwise so no empty
- * landmark appears on pages where history is disabled.
- *
- * The locale prop is forwarded to the real DocHistory component only for
- * non-default locales — the history JSON server stores default-locale
- * files without a locale path segment (matching the fetch-path branch in
- * doc-history.tsx).
- *
- * When entrySlug + contentDir are both provided and settings.bodyFootUtilArea
- * has viewSourceLink enabled, computes sourceUrl via buildGitHubSourceUrl and
- * resolves the i18n label for the active locale — keeping the v2 component
- * oblivious to project settings (host-side computation, B-8-2).
- *
- * The SSR fallback for the doc-history island is built from git metadata
- * (author name, created/updated dates) so that static HTML contains the
- * author marker before JS hydration, visible to screen readers and crawlers.
- */
-export function DocHistoryArea({
-  slug,
-  locale,
-  entrySlug,
-  contentDir,
-  isFallback,
-}: DocHistoryAreaProps): VNode | null {
-  if (!settings.docHistory) return null;
-
-  // Doc-history storage sentinel ("" -> "index"): a root index page has the
-  // canonical route slug "" (→ /docs/), but doc-history JSON and the meta
-  // manifest store/serve the root entry under "index" (an empty path segment
-  // is unroutable — the server regex and the prebuild key composition both
-  // reject ""). Apply the sentinel to the slug segment BEFORE locale
-  // composition so root pages resolve to e.g. /doc-history/index.json and the
-  // meta key "ja/index". See @/utils/slug `toHistorySlug` and the
-  // collectContentFiles walk in packages/doc-history-server. (#1891)
-  const historySlug = toHistorySlug(slug);
-
-  // On EN-fallback locale pages the history data exists only at the bare
-  // (non-locale-prefixed) path — the prebuild/server writes locale-prefixed
-  // keys/paths only for files physically present in the locale collection.
-  // Use defaultLocale for data lookups when isFallback is true; keep locale
-  // for all display label calls (t()) so JA users see JA labels.
-  const effectiveHistoryLocale = isFallback ? defaultLocale : locale;
-
-  // Look up the build-time manifest entry for this page. The composedSlug
-  // matches the key written by the prebuild step: bare slug for the default
-  // locale, "<localeKey>/<slug>" for non-default locales.
-  const composedSlug =
-    effectiveHistoryLocale === defaultLocale ? historySlug : `${effectiveHistoryLocale}/${historySlug}`;
-  type MetaEntry = {
-    author: string;
-    createdDate: string;
-    updatedDate: string;
-    /** Source file extension (".mdx" | ".md") — optional in older manifests. */
-    ext?: string;
-  };
-  const meta = (docHistoryMeta as Record<string, MetaEntry>)[composedSlug];
-
-  // Locale-aware labels for the SSR fallback.
-  const createdLabel = t("doc.created", locale);
-  const updatedLabel = t("doc.updated", locale);
-  const historyLabel = t("doc.history", locale);
-
-  // Real-component props — locale omitted for the default locale.
-  // Use effectiveHistoryLocale so fallback pages fetch the bare (non-ja/) path.
-  const docHistoryLocale = effectiveHistoryLocale === defaultLocale ? undefined : effectiveHistoryLocale;
-  const docHistoryBasePath = settings.base ?? "/";
-
-  // Build the SSR fallback with only the sr-only metadata block so the
-  // author marker and Created/Updated labels are present in SSG output
-  // before JS hydration, discoverable by screen readers and crawlers.
-  // The visible "History" trigger button is NOT included here — DocHistory
-  // renders its own trigger after hydration, and including one in the
-  // ssrFallback as well caused a duplicate button in the DOM because
-  // Preact's render() does not reliably remove static ssrFallback HTML
-  // before mounting the new component output (same wrapper-self-Island
-  // pattern fixed for Toc/Sidebar in commit 4014cdc).
-  const author = meta?.author;
-  const createdDate = meta?.createdDate;
-  const updatedDate = meta?.updatedDate;
-
-  // Explicit type annotation omitted: inferred JSX return is structurally
-  // compatible with zfb's VNode (the ssrFallback prop target). Preact's
-  // VNode<{}> generic form is not directly assignable to zfb's VNode at the
-  // type level even though the runtime shapes are identical.
-  const fallback = (
-    <div class="sr-only">
-      {author && <span>{author}</span>}
-      <span>
-        {createdLabel}
-        {createdDate ? `: ${createdDate}` : ""}
-      </span>
-      <span>
-        {updatedLabel}
-        {updatedDate ? `: ${updatedDate}` : ""}
-      </span>
-    </div>
-  );
-
-  // Compose the SSR-skip island with zfb's native `<Island ssrFallback>` API.
-  // The page → this file → real DocHistory import chain is what the scanner
-  // walks; the marker emitted is "DocHistory" via captureComponentName.
-  const docHistoryIsland = Island({
-    when: "idle",
-    ssrFallback: fallback,
-    children: (
-      <DocHistory
-        slug={historySlug}
-        locale={docHistoryLocale}
-        basePath={docHistoryBasePath}
-      />
-    ),
-  }) as unknown as VNode;
-
-  // Compute the view-source GitHub URL host-side so the v2 BodyFootUtilArea
-  // component stays oblivious to project settings. Gate on
-  // bodyFootUtilArea.viewSourceLink, and require both entrySlug and contentDir
-  // (auto-index pages pass neither). The real source extension comes from the
-  // build-time manifest (`ext`, written by pre-build.ts) — the content walkers
-  // accept both .mdx and .md, so hardcoding ".mdx" produced broken view-source
-  // URLs for .md pages. ".mdx" remains the fallback for entries without a
-  // manifest record (untracked files, SKIP_DOC_HISTORY=1, stale manifests).
-  const utilSettings = settings.bodyFootUtilArea;
-  const sourceExt = meta?.ext ?? ".mdx";
-  const sourceUrl =
-    utilSettings && utilSettings.viewSourceLink && entrySlug && contentDir
-      ? buildGitHubSourceUrl(contentDir, entrySlug + sourceExt)
-      : null;
-
-  // Resolve the i18n label host-side; pass the result so the v2 component
-  // stays framework-agnostic. Falls back to the EN default when locale has
-  // no translation (see DEFAULT_VIEW_SOURCE_LABEL in the v2 package).
-  const viewSourceLabel = t("doc.viewSource", locale);
-
-  return (
-    <BodyFootUtilArea
-      docHistoryIsland={docHistoryIsland}
-      sourceUrl={sourceUrl}
-      viewSourceLabel={viewSourceLabel}
-    />
-  );
-}
+import type { DocHistoryAreaProps } from "@takazudo/zudo-doc/doc-history-area";
+
+export type { DocHistoryAreaProps };
+
+export const DocHistoryArea = createDocHistoryArea({
+  settings,
+  defaultLocale,
+  docHistoryMeta: docHistoryMeta as Record<string, { author: string; createdDate: string; updatedDate: string; ext?: string }>,
+  t,
+  toHistorySlug,
+  buildGitHubSourceUrl: (contentDir: string, entryId: string) => _buildGitHubSourceUrl(contentDir, entryId),
+  DocHistory,
+});

package/templates/base/pages/lib/_doc-metainfo-area.tsx

@@ -1,31 +1,10 @@
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-// Locale-aware DocMetainfo area wrapper for the zfb doc pages.
-//
-// Renders the visible date block (created / updated dates + author)
-// between the article <h1> and the description paragraph (doc-metainfo
-// placement — between <h1> and description).
-//
-// Data source: `.zfb/doc-history-meta.json`, a build-time manifest
-// emitted by `scripts/zfb-prebuild.mjs` before `zfb build` runs.
-// esbuild inlines the JSON statically so no Node.js `fs` code reaches
-// the client bundle — the same approach used by `_doc-history-area.tsx`
-// (b11-2 pattern).
-//
-// Date formatting uses Intl.DateTimeFormat (browser-safe). We do NOT
-// import the old `formatDate` from `src/utils/git-info.ts` — that module
-// carried top-level Node.js imports (`execFileSync`, `existsSync`) that
-// would be dragged into the client bundle (the B-11 lesson). That file
-// was removed in S1 cleanup (#1928); the mirror below is the canonical copy.
-//
-// Labels are resolved from the project's i18n table so non-default
-// locales (e.g. /ja/) get translated "作成" / "更新" strings.
-
-import type { VNode } from "preact";
+// Host thin-stub — see @takazudo/zudo-doc/doc-metainfo-area (epic #2344, S7).
 import { settings } from "@/config/settings";
 import { defaultLocale, t } from "@/config/i18n";
-import { DocMetainfo } from "@takazudo/zudo-doc/metainfo";
 import { toHistorySlug } from "@/utils/slug";
+import { createDocMetainfoArea } from "@takazudo/zudo-doc/doc-metainfo-area";
 // SSR author + date metadata comes from `.zfb/doc-history-meta.json`, a
 // build-time manifest emitted by `scripts/zfb-prebuild.mjs` (step 2:
 // doc-history-meta) before `zfb build` runs. esbuild inlines the JSON
@@ -36,94 +15,12 @@ import { toHistorySlug } from "@/utils/slug";
 // across the shadow boundary would resolve to the wrong location.
 import docHistoryMeta from "#doc-history-meta";
 
-// BCP-47 locale tag mapping used by Intl.DateTimeFormat.
-// Originally mirrored from `src/utils/git-info.ts` (removed in S1 #1928).
-// The formatDate function below is the stable copy; kept in sync manually.
-const LOCALE_TO_BCP47: Record<string, string> = {
-  en: "en-US",
-  ja: "ja-JP",
-  de: "de-DE",
-};
-
-/** Format an ISO date string for display, respecting the active locale. */
-function formatDate(isoDate: string, locale: string): string {
-  const d = new Date(isoDate);
-  if (isNaN(d.getTime())) return isoDate;
-  return d.toLocaleDateString(LOCALE_TO_BCP47[locale] ?? "en-US", {
-    year: "numeric",
-    month: "short",
-    day: "numeric",
-  });
-}
-
-interface DocMetainfoAreaProps {
-  /** Page slug, e.g. "getting-started/intro". */
-  slug: string;
-  /** Active locale string, e.g. "en", "ja". */
-  locale: string;
-  /**
-   * True when this locale page falls back to the base EN collection
-   * (i.e. the slug has no translation for the active locale). When true,
-   * the manifest lookup uses defaultLocale so the visible block resolves
-   * the bare-slug key — the only key that exists for EN-origin files —
-   * matching the dropdown's `effectiveHistoryLocale` derivation in
-   * _doc-history-area.tsx. Display formatting (dates + labels) still uses
-   * the active locale so JA users see JA formatting on fallback pages.
-   */
-  isFallback?: boolean;
-}
-
-/**
- * Renders the visible date block (Created / Updated / Author) when
- * `settings.docMetainfo` is enabled and the build-time manifest has an
- * entry for the active page.
- *
- * Returns null when `docMetainfo` is disabled, the page is untracked
- * (no manifest entry), or the manifest was generated in a shallow clone
- * (`SKIP_DOC_HISTORY=1` → empty JSON).
- *
- * The component is intentionally server-render-only: it emits static
- * HTML from build-time data and has no client JS footprint. It sits
- * between `<h1>` and the description `<p>` (doc-metainfo placement).
- */
-export function DocMetainfoArea({ slug, locale, isFallback }: DocMetainfoAreaProps): VNode | null {
-  if (!settings.docMetainfo) return null;
-
-  // Doc-history storage sentinel ("" -> "index"): a root index page has the
-  // canonical route slug "" (→ /docs/), but the prebuild keys the root entry
-  // under "index" (collectContentFiles keeps the bare root; an empty path
-  // segment is unroutable). Apply the sentinel BEFORE locale composition so
-  // the visible Created/Updated/Author block resolves for a root page — see
-  // @/utils/slug `toHistorySlug` and _doc-history-area.tsx. (#1891)
-  const historySlug = toHistorySlug(slug);
-
-  // On EN-fallback locale pages the manifest only has the bare
-  // (non-locale-prefixed) key — the prebuild writes locale-prefixed keys
-  // only for files physically present in the locale collection. Use
-  // defaultLocale for the data lookup when isFallback is true, mirroring
-  // `effectiveHistoryLocale` in _doc-history-area.tsx so the visible block
-  // and the dropdown agree. Display formatting keeps the active locale.
-  const effectiveHistoryLocale = isFallback ? defaultLocale : locale;
-
-  // Key format: bare slug for default locale, "<locale>/<slug>" for others.
-  // Matches the prebuild step's composedSlug logic (pre-build.ts).
-  const composedSlug =
-    effectiveHistoryLocale === defaultLocale
-      ? historySlug
-      : `${effectiveHistoryLocale}/${historySlug}`;
-
-  type MetaEntry = { author: string; createdDate: string; updatedDate: string };
-  const meta = (docHistoryMeta as Record<string, MetaEntry>)[composedSlug];
-
-  if (!meta) return null;
+export type { DocMetainfoAreaProps } from "@takazudo/zudo-doc/doc-metainfo-area";
 
-  return (
-    <DocMetainfo
-      createdAt={meta.createdDate ? formatDate(meta.createdDate, locale) : null}
-      updatedAt={meta.updatedDate ? formatDate(meta.updatedDate, locale) : null}
-      author={meta.author || null}
-      createdLabel={t("doc.created", locale)}
-      updatedLabel={t("doc.updated", locale)}
-    />
-  );
-}
+export const DocMetainfoArea = createDocMetainfoArea({
+  settings,
+  defaultLocale,
+  docHistoryMeta: docHistoryMeta as Record<string, { author: string; createdDate: string; updatedDate: string }>,
+  t,
+  toHistorySlug,
+});

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

@@ -1,192 +1,31 @@
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-// Shared page renderer for the 4 doc catch-all routes.
-//
-// Extracted (#2010) from the near-identical default components 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's default export stays a thin adapter that reads its params /
-// route-specific props (locale, version, contentDir, isFallback) and
-// delegates here. Route-specific behavior is parameterized:
-//   - `version` present → versioned chrome: versioned canonical URL, version
-//     banner, version-aware switcher, auto-index child hrefs kept as the
-//     pre-remapped versioned hrefs from paths() (#1916 #2), and doc history
-//     hidden until versioned history is supported (#1916 #5).
-//   - `version` absent → latest chrome: docsUrl canonical, child hrefs fall
-//     back to the nav node's own docsUrl, doc history rendered for listed
-//     entries via `docHistoryContentDir`.
-
-import { settings } from "@/config/settings";
-import type { VersionConfig } from "@/config/settings";
-import { t, type Locale } from "@/config/i18n";
+// Host thin-stub — see @takazudo/zudo-doc/doc-page-renderer (epic #2344, S7).
+import { t } from "@/config/i18n";
 import { docsUrl, versionedDocsUrl, absoluteUrl } from "@/utils/base";
-import type { NavNode } from "@/utils/docs";
 import { getNavSectionForSlug } from "@/utils/nav-scope";
 import { toRouteSlug } from "@/utils/slug";
-import type { JSX } from "preact";
-// Shared MDX-tag → Preact-component bag. Includes htmlOverrides
-// (native typography), HtmlPreviewWrapper (Island), and stub bindings
-// for every other custom tag the MDX corpus references — see
-// `pages/_mdx-components.ts` for the full list and rationale.
 import { createMdxComponents } from "../_mdx-components";
-import type { DocPageBaseProps } from "./doc-page-props";
-import { DocHistoryArea } from "./_doc-history-area";
-import { DocMetainfoArea } from "./_doc-metainfo-area";
+import { createRenderDocPage } from "@takazudo/zudo-doc/doc-page-renderer";
 import { buildInlineVersionSwitcher } from "./_inline-version-switcher";
-import { DocContentHeader } from "./_doc-content-header";
 import { DocPageShell } from "./_doc-page-shell";
+import { DocContentHeader } from "./_doc-content-header";
+import { DocMetainfoArea } from "./_doc-metainfo-area";
+import { DocHistoryArea } from "./_doc-history-area";
 
-export interface RenderDocPageOptions {
-  /** Active locale — drives nav wrappers, labels, and URL building. */
-  locale: Locale;
-  /** Version config when rendering a versioned route; undefined = latest. */
-  version?: VersionConfig;
-  /** 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;
-}
-
-export function renderDocPage(
-  props: DocPageBaseProps,
-  opts: RenderDocPageOptions,
-): JSX.Element {
-  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;
-
-  // Locale-aware components bag — creates nav wrappers bound to the active
-  // locale so CategoryNav/CategoryTreeNav/SiteTreeNav query the right collection.
-  const components = createMdxComponents(locale);
-
-  // Resolve child hrefs for auto-index pages. Versioned routes: child cards
-  // already carry versioned hrefs from paths() (#1916 #2) — just filter to
-  // renderable nodes. Latest routes: keep the nav node's own docsUrl href
-  // (fallback for a noPage parent without an href).
-  const autoIndexChildren = props.kind === "autoIndex"
-    ? version
-      ? props.autoIndex.children.filter((c: NavNode) => c.hasPage || c.children.length > 0)
-      : props.autoIndex.children
-          .filter((c: NavNode) => c.hasPage || c.children.length > 0)
-          .map((c: NavNode) => ({
-            ...c,
-            href: c.href ?? docsUrl(c.slug, locale),
-          }))
-    : [];
-
-  // 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 — base-prefixed page path, absolutized against siteUrl.
-  // Versioned pages use the versioned URL as canonical.
-  const currentPath = version
-    ? versionedDocsUrl(slug, version.slug, locale)
-    : docsUrl(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={
-        // 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" ? (
-          <DocMetainfoArea slug={slug} locale={locale} isFallback={isFallback} />
-        ) : null
-      }
-      contentHeaderSlot={
-        props.kind === "entry" ? (
-          <DocContentHeader
-            entry={props.entry}
-            slug={slug}
-            locale={locale}
-            isFallback={isFallback}
-            version={version?.slug}
-          />
-        ) : undefined
-      }
-      contentSlot={
-        props.kind === "entry" ? <props.entry.Content components={components} /> : undefined
-      }
-      docHistorySlot={
-        // #1916 #5: doc-history hidden on versioned pages until versioned
-        // history is supported.
-        !version &&
-        opts.docHistoryContentDir !== undefined &&
-        props.kind === "entry" &&
-        !props.entry.data.unlisted ? (
-          <DocHistoryArea
-            slug={slug}
-            locale={locale}
-            entrySlug={props.entry.slug}
-            contentDir={opts.docHistoryContentDir}
-            isFallback={isFallback}
-          />
-        ) : null
-      }
-    />
-  );
-}
+export type { RenderDocPageOptions } from "@takazudo/zudo-doc/doc-page-renderer";
+
+export const renderDocPage = createRenderDocPage({
+  docsUrl,
+  versionedDocsUrl,
+  absoluteUrl,
+  getNavSectionForSlug,
+  toRouteSlug,
+  createMdxComponents,
+  t,
+  buildInlineVersionSwitcher,
+  DocPageShell,
+  DocContentHeader,
+  DocMetainfoArea,
+  DocHistoryArea,
+});