create-zudo-doc 1.0.2 → 1.2.0

package/dist/features/i18n.js

@@ -31,7 +31,7 @@ export const i18nFeature = (_choices) => {
     const stat = fs.existsSync(pagesDir) ? fs.statSync(pagesDir) : null;
     if (!stat || !stat.isDirectory() || fs.readdirSync(pagesDir).length === 0) {
         throw new Error(`i18n feature template dir is missing or empty: ${pagesDir}\n` +
-            `Expected to find [locale]/index.tsx and [locale]/docs/[...slug].tsx.\n` +
+            `Expected to find [locale]/index.tsx.\n` +
             `This is a generator bug — please file an issue.`);
     }
     return {

package/dist/features/versioning.d.ts

@@ -11,13 +11,21 @@ import type { FeatureModule } from "../compose.js";
  * W7C (#1738): the versioning feature ships pages under
  * `templates/features/versioning/files/pages/`:
  *
- *   docs/versions.tsx                       (always — versioning gate only)
- *   v/[version]/docs/[...slug].tsx          (always — versioning gate only)
- *   v/[version]/[locale]/docs/[...slug].tsx (i18n + versioning — see below)
- *   [locale]/docs/versions.tsx              (i18n + versioning)
+ *   lib/_versions-page.tsx                  (always — versions-listing renderer)
+ *
+ * The versioned DOC routes — `/docs/versions`, `/v/[version]/docs/[[...slug]]`,
+ * and `/v/[version]/[locale]/docs/[[...slug]]` — are now PACKAGE-INJECTED
+ * (packageOwnedRoutes); their host catch-all stubs were deleted from the
+ * template in #2390 (supersedes #2377) so generated projects render them via
+ * injection through `@takazudo/zudo-doc`'s `_chrome` chrome (which wires the
+ * MDX content components). The package route is the functional equivalent of
+ * the old stub (it enumerates `settings.versions` and renders via the shared
+ * `renderDocPage`).
  *
  * `copyFeatureFiles` (compose.ts) auto-copies everything under `files/`.
- * postProcess removes the i18n-gated subset when i18n is OFF so single-
- * locale projects don't ship orphan routes.
+ * postProcess is now a defensive no-op: the i18n-gated stubs it strips
+ * (`[locale]/docs/versions.tsx`, `v/[version]/[locale]/**`) no longer ship in
+ * the template, but the cleanup is kept so a re-added stub can never leak an
+ * orphan locale route into a single-locale project.
  */
 export declare const versioningFeature: FeatureModule;

package/dist/features/versioning.js

@@ -12,14 +12,22 @@ import path from "path";
  * W7C (#1738): the versioning feature ships pages under
  * `templates/features/versioning/files/pages/`:
  *
- *   docs/versions.tsx                       (always — versioning gate only)
- *   v/[version]/docs/[...slug].tsx          (always — versioning gate only)
- *   v/[version]/[locale]/docs/[...slug].tsx (i18n + versioning — see below)
- *   [locale]/docs/versions.tsx              (i18n + versioning)
+ *   lib/_versions-page.tsx                  (always — versions-listing renderer)
+ *
+ * The versioned DOC routes — `/docs/versions`, `/v/[version]/docs/[[...slug]]`,
+ * and `/v/[version]/[locale]/docs/[[...slug]]` — are now PACKAGE-INJECTED
+ * (packageOwnedRoutes); their host catch-all stubs were deleted from the
+ * template in #2390 (supersedes #2377) so generated projects render them via
+ * injection through `@takazudo/zudo-doc`'s `_chrome` chrome (which wires the
+ * MDX content components). The package route is the functional equivalent of
+ * the old stub (it enumerates `settings.versions` and renders via the shared
+ * `renderDocPage`).
  *
  * `copyFeatureFiles` (compose.ts) auto-copies everything under `files/`.
- * postProcess removes the i18n-gated subset when i18n is OFF so single-
- * locale projects don't ship orphan routes.
+ * postProcess is now a defensive no-op: the i18n-gated stubs it strips
+ * (`[locale]/docs/versions.tsx`, `v/[version]/[locale]/**`) no longer ship in
+ * the template, but the cleanup is kept so a re-added stub can never leak an
+ * orphan locale route into a single-locale project.
  */
 export const versioningFeature = (choices) => ({
     name: "versioning",

package/dist/scaffold.d.ts

@@ -11,5 +11,5 @@ export { getSecondaryLang };
  *
  * Bumped in lockstep by scripts/release-create-zudo-doc.sh.
  */
-export declare const ZUDO_DOC_PIN = "^1.0.2";
+export declare const ZUDO_DOC_PIN = "^1.2.0";
 export declare function scaffold(choices: UserChoices): Promise<void>;

package/dist/scaffold.js

@@ -18,7 +18,7 @@ export { getSecondaryLang };
  *
  * Bumped in lockstep by scripts/release-create-zudo-doc.sh.
  */
-export const ZUDO_DOC_PIN = "^1.0.2";
+export const ZUDO_DOC_PIN = "^1.2.0";
 /**
  * Files in `templates/base/**` that must never be copied into a generated
  * project. Each entry is matched against the path relative to `templates/base/`
@@ -470,16 +470,20 @@ function generatePackageJson(choices) {
         // multi-valued response headers (e.g. multiple Set-Cookie),
         // supplementary-plane CJK reading-time, plus CLI/server/runtime hardening
         // and render perf passes. No consumer-facing / CLI breaking change.
-        // next.65 (current pin): dev-render of package-injected routes (zfb#1227,
+        // next.65: dev-render of package-injected routes (zfb#1227,
         // landed next.63) + islands bundler now seeds the host tsconfig `paths`
         // (e.g. `@/*`) into its synthetic tsconfig (zfb#1238) — fixes silent island
         // hydration failure under route injection. Unblocks packageOwnedRoutes.
         // No consumer-facing / CLI breaking change.
-        "@takazudo/zfb": "0.1.0-next.65",
-        "@takazudo/zfb-runtime": "0.1.0-next.65",
+        // next.68: routine toolchain bump from next.67, adopted in
+        // lockstep with the root package.json pins. No consumer-facing / CLI change.
+        // next.69 (current pin): routine toolchain bump from next.68, adopted in
+        // lockstep with the root package.json pins. No consumer-facing / CLI change.
+        "@takazudo/zfb": "0.1.0-next.69",
+        "@takazudo/zfb-runtime": "0.1.0-next.69",
         // zfb-adapter-cloudflare — required for any route with `prerender = false`.
         // Pinned in lockstep with @takazudo/zfb.
-        "@takazudo/zfb-adapter-cloudflare": "0.1.0-next.65",
+        "@takazudo/zfb-adapter-cloudflare": "0.1.0-next.69",
         // @takazudo/zudo-doc — published from this monorepo via
         // .github/workflows/publish-zudo-doc.yml. The pin here is bumped in
         // lockstep by scripts/release-create-zudo-doc.sh whenever zudo-doc's
@@ -501,7 +505,7 @@ function generatePackageJson(choices) {
         // any page compiles. The Astro→zfb retarget (3f0042f7) added the
         // import without the runtime dep; W6B (#1735) consumer-build
         // verification was the first to actually exercise it.
-        zod: "^4.0.0",
+        zod: "^4.3.6", // floor matches @takazudo/zudo-doc's peer dep (package.json peerDependencies)
         // ^10.29.1 floor satisfies @takazudo/zdtp's preact peer range so the app
         // and zdtp resolve a single preact instance — a lower floor can split into
         // two copies and crash hook-using SSR islands with "undefined reading __H".
@@ -562,7 +566,7 @@ function generatePackageJson(choices) {
         // @takazudo/zudo-doc/integrations/doc-history which in turn imports
         // @takazudo/zudo-doc-history-server/git-history. Without this dep the
         // plugin host fails at init with ERR_MODULE_NOT_FOUND — W8A (#1739).
-        deps["@takazudo/zudo-doc-history-server"] = "^1.0.2";
+        deps["@takazudo/zudo-doc-history-server"] = "^1.2.0";
         // tsx is no longer needed here: the relocated package plugin imports the
         // runner directly (no `tsx -e` spawn) since the package ships compiled
         // dist/ — package-first migration #2321 (#2337).

package/dist/zfb-config-gen.js

@@ -28,6 +28,8 @@ export function generateZfbConfig(_choices) {
     lines.push(`import { zudoDocPreset } from "@takazudo/zudo-doc/preset";`);
     lines.push(`import { settings } from "./src/config/settings";`);
     lines.push(`import { buildDocsSchema } from "./src/config/docs-schema";`);
+    lines.push(`import { translations } from "./src/config/i18n";`);
+    lines.push(`import { colorSchemes } from "./src/config/color-schemes";`);
     lines.push(``);
     // --- Directive vocabulary ---
     // The seven canonical directives registered in pages/_mdx-components.ts.
@@ -54,7 +56,7 @@ export function generateZfbConfig(_choices) {
     lines.push(`  base: settings.base,`);
     lines.push(``);
     lines.push(`  // ── Preset-owned fields (content collections, plugins, markdown, …) ────────`);
-    lines.push(`  ...zudoDocPreset({ settings, buildDocsSchema, directiveVocabulary }),`);
+    lines.push(`  ...zudoDocPreset({ settings, buildDocsSchema, directiveVocabulary, translations, colorSchemes }),`);
     lines.push(`});`);
     return lines.join("\n") + "\n";
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-zudo-doc",
-  "version": "1.0.2",
+  "version": "1.2.0",
   "description": "Create a new zudo-doc documentation site",
   "license": "MIT",
   "author": "Takeshi Takatsudo",

package/templates/base/src/config/i18n.ts

@@ -55,7 +55,7 @@ export function detectLocaleFromPath(path: string): Locale {
 }
 
 /** UI string translations */
-const translations: Record<string, Record<string, string>> = {
+export const translations: Record<string, Record<string, string>> = {
   en: {
     "nav.gettingStarted": "Getting Started",
     "nav.learn": "Learn",

package/templates/base/pages/docs/[[...slug]].tsx

@@ -1,90 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Page module for the default-locale docs route.
-//
-// Default-locale (EN) catch-all docs route. paths() enumerates every page in
-// the "docs" collection plus auto-generated category index pages (for
-// categories without an index.mdx). Per-page props carry all pre-computed
-// data so the component is a pure renderer with no collection reads.
-//
-// paths() contract (zfb ADR-004 — synchronous):
-//   params: { slug: string[] }   — e.g. ["getting-started", "intro"]
-//   props:  { entry, autoIndex, breadcrumbs, prev, next }
-//
-// Route is the OPTIONAL catchall `[[...slug]]` so a bare root index.mdx can
-// build at `/docs/` (canonical root URL — #1891). The root entry emits
-// `params.slug = []` (zero segments) via `toSlugParams`; a required `[...slug]`
-// catchall rejects an empty array and would drop the whole route.
-//
-// The catchall slug is an array per zfb spec — the component joins it when
-// deriving the string form (e.g. for Content lookups, breadcrumbs, etc.).
-//
-// Locale: defaultLocale (EN). Non-default locales are handled by
-// pages/[locale]/docs/[[...slug]].tsx.
-//
-// Enumeration + per-entry derived data (breadcrumbs, prev/next, headings) are
-// built by the shared, memoized buildDocRouteEntries (#2010); rendering by the
-// shared renderDocPage. This file owns only the route's nav source and the
-// param/prop shapes.
-
-import { settings } from "@/config/settings";
-import { defaultLocale } from "@/config/i18n";
-import type { JSX } from "preact";
-import { resolveNavSource } from "../lib/_nav-source-docs";
-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" };
-
-// ---------------------------------------------------------------------------
-// Props contract
-// ---------------------------------------------------------------------------
-
-type DocPageProps = DocPageEntryProps | DocPageAutoIndexProps;
-
-// ---------------------------------------------------------------------------
-// paths() — synchronous route enumeration (ADR-004)
-// ---------------------------------------------------------------------------
-
-/**
- * Enumerate all doc routes for the default locale (EN).
- *
- * Synchronous per ADR-004: getCollection() resolves from the pre-loaded
- * ContentSnapshot. All nav-tree and breadcrumb computation is done in the
- * shared builder so the component is a pure renderer.
- */
-export function paths(): Array<{
-  params: { slug: string[] };
-  props: DocPageProps;
-}> {
-  const locale = defaultLocale;
-  // Identity-stable nav source (draft-filtered, unlisted retained). The same
-  // instances are returned across this route's many per-page paths()
-  // invocations, so both buildNavTree's identity fast-path and the
-  // buildDocRouteEntries memo key on them — see pages/lib/_nav-source-docs.ts
-  // (#1902).
-  const source = resolveNavSource(locale, undefined);
-
-  return buildDocRouteEntries({
-    source,
-    locale,
-    routeSig: `docs;${locale}`,
-  }).map((item) => ({
-    params: { slug: item.slugParams },
-    props: item.props,
-  }));
-}
-
-// ---------------------------------------------------------------------------
-// Page component
-// ---------------------------------------------------------------------------
-
-type PageArgs = DocPageProps & { params: { slug: string[] } };
-
-export default function DocsPage(props: PageArgs): JSX.Element {
-  return renderDocPage(props, {
-    locale: defaultLocale,
-    docHistoryContentDir: settings.docsDir,
-  });
-}

package/templates/features/i18n/files/pages/[locale]/docs/[[...slug]].tsx

@@ -1,134 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Page module for the locale-prefixed docs route.
-//
-// Non-default-locale catch-all docs route. paths() emits one route per
-// (locale, slug) combination — one locale from settings.locales per each
-// doc in that locale's merged collection (locale-first + base fallback).
-//
-// paths() contract (zfb ADR-004 — synchronous):
-//   params: { locale: string; slug: string[] }
-//   props:  { entry, autoIndex, contentDir, isFallback, breadcrumbs, prev, next }
-//
-// Route is the OPTIONAL catchall `[[...slug]]` so a locale root index.mdx can
-// build at `/{locale}/docs/` (canonical root URL — #1891). The root entry
-// emits `params.slug = []` via `toSlugParams`; a required `[...slug]` catchall
-// rejects an empty array and would drop the ENTIRE locale route (the EN-root
-// index leaks in via the locale-first EN fallback, so this fires even before a
-// locale-specific root index exists — probe-observed page-count collapse).
-//
-// i18n / locale routing:
-//   - Default locale (EN) is handled by pages/docs/[[...slug]].tsx
-//     (prefixDefaultLocale: false).
-//   - Non-default locales emit /{locale}/docs/{slug}.
-//   - Locale-first merge: locale docs take priority; base EN docs fill in
-//     pages not translated yet (shown with a fallback notice).
-//
-// 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 and the param/prop shapes.
-
-import { settings } from "@/config/settings";
-import { getLocaleConfig, type Locale } from "@/config/i18n";
-import type { JSX } from "preact";
-import { resolveNavSource } from "../../lib/_nav-source-docs";
-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" };
-
-// ---------------------------------------------------------------------------
-// Types
-// ---------------------------------------------------------------------------
-
-/** Route-specific extra fields — present on both branches of the union. */
-interface LocaleDocPageExtra {
-  /** Content directory for the active locale (or base EN for fallbacks). */
-  contentDir: string;
-  /** True when this page falls back to the base EN collection. */
-  isFallback: boolean;
-}
-
-type DocPageProps =
-  | (DocPageEntryProps & LocaleDocPageExtra)
-  | (DocPageAutoIndexProps & LocaleDocPageExtra);
-
-// ---------------------------------------------------------------------------
-// paths() — synchronous (ADR-004)
-// ---------------------------------------------------------------------------
-
-/**
- * Emit one route per (non-default locale, slug) combination.
- *
- * Merge strategy:
- *   1. Load locale docs (e.g. "docs-ja").
- *   2. Load base EN docs ("docs").
- *   3. Locale docs take priority; base EN fills in slugs not translated.
- *   4. Track fallback slugs for the fallback-notice banner.
- *   5. Build nav tree, compute breadcrumbs and prev/next for each entry.
- *
- * Fallback detection (`isFallback`) comes from the merge's localeSlugSet —
- * the component uses it to show the "not yet translated" notice (matching
- * the Astro original).
- */
-export function paths(): Array<{
-  params: { locale: string; slug: string[] };
-  props: DocPageProps;
-}> {
-  const result: Array<{
-    params: { locale: string; slug: string[] };
-    props: DocPageProps;
-  }> = [];
-
-  for (const locale of Object.keys(settings.locales) as string[]) {
-    const localeConfig = getLocaleConfig(locale);
-    const contentDir = localeConfig?.dir ?? settings.docsDir;
-
-    // Identity-stable, locale-first merge with EN fallback. The same `docs` /
-    // `navDocs` / `categoryMeta` instances are reused across this route's many
-    // per-page paths() invocations so both buildNavTree's identity fast-path
-    // and the buildDocRouteEntries memo key on them — see
-    // pages/lib/_nav-source-docs.ts (#1902).
-    const source = resolveNavSource(locale as Locale, undefined, {
-      applyDefaultLocaleOnlyFilter: true,
-      keepUnlisted: true,
-    });
-
-    for (const item of buildDocRouteEntries({
-      source,
-      locale: locale as Locale,
-      routeSig: `locale-docs;${locale}`,
-    })) {
-      // isFallback: page came from base docs, not the locale collection.
-      // Always false for autoIndex items (item.isFallback already is).
-      const extra: LocaleDocPageExtra = {
-        contentDir: item.isFallback ? settings.docsDir : contentDir,
-        isFallback: item.isFallback,
-      };
-      result.push({
-        params: { locale, slug: item.slugParams },
-        props:
-          item.props.kind === "entry"
-            ? { ...item.props, ...extra }
-            : { ...item.props, ...extra },
-      });
-    }
-  }
-
-  return result;
-}
-
-// ---------------------------------------------------------------------------
-// Page component
-// ---------------------------------------------------------------------------
-
-type PageArgs = DocPageProps & { params: { locale: string; slug: string[] } };
-
-export default function LocaleDocsPage(props: PageArgs): JSX.Element {
-  return renderDocPage(props, {
-    locale: props.params.locale as Locale,
-    isFallback: props.isFallback,
-    docHistoryContentDir: props.contentDir,
-  });
-}

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

@@ -1,151 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Page module for the versioned non-default-locale docs route.
-//
-// Optional-catchall [[...slug]] so slug=[] (empty) routes to /v/<ver>/<locale>/docs/
-// when a versioned locale root index.mdx exists — toSlugParams("") returns [].
-//
-// Versioned locale docs route. paths() cross-products settings.versions ×
-// configured per-version locales with a locale-first merge strategy:
-// locale-specific collection (`docs-v-${version.slug}-${locale}`) takes
-// priority; the base EN collection (`docs-v-${version.slug}`) fills in
-// pages not translated yet (shown with a fallback notice).
-//
-// If version.locales?.[locale] is not configured, only the base EN collection is used.
-//
-// paths() contract (zfb ADR-004 — synchronous):
-//   params: { version: string; locale: string; slug: string[] }
-//   props:  { entry, autoIndex, version, contentDir, isFallback, breadcrumbs, prev, next }
-//
-// 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 { type Locale } from "@/config/i18n";
-import { versionedDocsUrl } from "@/utils/base";
-import type { JSX } from "preact";
-import { resolveVersionedLocaleSource } from "../../../../lib/_nav-source-docs";
-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" };
-
-// ---------------------------------------------------------------------------
-// Types
-// ---------------------------------------------------------------------------
-
-/** Route-specific extra fields — present on both branches of the union. */
-interface VersionedLocaleDocPageExtra {
-  /** The version config for the active version. */
-  version: VersionConfig;
-  /** Content directory for this page (locale dir if translated, version docsDir if fallback). */
-  contentDir: string;
-  /** True when this page falls back to the base EN collection for this version. */
-  isFallback: boolean;
-}
-
-type DocPageProps =
-  | (DocPageEntryProps & VersionedLocaleDocPageExtra)
-  | (DocPageAutoIndexProps & VersionedLocaleDocPageExtra);
-
-// ---------------------------------------------------------------------------
-// paths() — synchronous (ADR-004)
-// ---------------------------------------------------------------------------
-
-/**
- * Emit one route per (version, locale, slug) combination for all non-default locales.
- *
- * Cross-products settings.versions × Object.keys(settings.locales) (which are
- * the non-default locales — default EN is handled by v/[version]/docs/[...slug].tsx).
- *
- * Merge strategy per (version, locale):
- *   1. Load locale docs (e.g. "docs-v-1.0-ja") if version.locales[locale] is set.
- *   2. Load base EN docs ("docs-v-1.0").
- *   3. Locale docs take priority; base EN fills in slugs not translated.
- *   4. Track fallback slugs for the fallback-notice banner.
- *   5. Build nav tree with the active locale, compute breadcrumbs and prev/next.
- *
- * Prev/next hrefs are pre-resolved to the versioned locale URL form.
- */
-export function paths(): Array<{
-  params: { version: string; locale: string; slug: string[] };
-  props: DocPageProps;
-}> {
-  if (!settings.versions) return [];
-
-  const result: Array<{
-    params: { version: string; locale: string; slug: string[] };
-    props: DocPageProps;
-  }> = [];
-
-  for (const version of settings.versions) {
-    for (const locale of Object.keys(settings.locales) as string[]) {
-      const localeDir = version.locales?.[locale]?.dir;
-
-      // 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 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 },
-      );
-
-      // 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 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: item.slugParams },
-          props:
-            item.props.kind === "entry"
-              ? { ...item.props, ...extra }
-              : { ...item.props, ...extra },
-        });
-      }
-    }
-  }
-
-  return result;
-}
-
-// ---------------------------------------------------------------------------
-// Page component
-// ---------------------------------------------------------------------------
-
-type PageArgs = DocPageProps & { params: { version: string; locale: string; slug: string[] } };
-
-export default function VersionedLocaleDocsPage(props: PageArgs): JSX.Element {
-  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

@@ -1,123 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Page module for the versioned EN docs route.
-//
-// Optional-catchall [[...slug]] so slug=[] (empty) routes to /v/<ver>/docs/
-// when a versioned root index.mdx exists — toSlugParams("") returns [].
-//
-// Versioned EN docs route. paths() enumerates one route per (version, slug)
-// combination using the `docs-v-${version.slug}` collection for each version
-// configured in settings.versions.
-//
-// paths() contract (zfb ADR-004 — synchronous):
-//   params: { version: string; slug: string[] }
-//   props:  { entry, autoIndex, version, breadcrumbs, prev, next }
-//
-// Each version renders with its own nav tree (from the version's docsDir
-// category metadata). Prev/next hrefs are pre-resolved to the versioned URL
-// form (e.g. /v/1.0/docs/…) so the component needs no URL computation.
-//
-// 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 { versionedDocsUrl } from "@/utils/base";
-import type { JSX } from "preact";
-import { resolveNavSource } from "../../../lib/_nav-source-docs";
-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" };
-
-// ---------------------------------------------------------------------------
-// Types
-// ---------------------------------------------------------------------------
-
-/** Route-specific extra fields — present on both branches of the union. */
-interface VersionedDocPageExtra {
-  /** The version config for the active version. */
-  version: VersionConfig;
-}
-
-type DocPageProps =
-  | (DocPageEntryProps & VersionedDocPageExtra)
-  | (DocPageAutoIndexProps & VersionedDocPageExtra);
-
-// ---------------------------------------------------------------------------
-// paths() — synchronous (ADR-004)
-// ---------------------------------------------------------------------------
-
-/**
- * Emit one route per (version, slug) combination.
- *
- * For each version in settings.versions, loads docs from
- * `docs-v-${version.slug}` and enumerates all pages plus
- * auto-generated category index pages.
- *
- * Prev/next hrefs are pre-resolved to the versioned form.
- */
-export function paths(): Array<{
-  params: { version: string; slug: string[] };
-  props: DocPageProps;
-}> {
-  if (!settings.versions) return [];
-
-  const result: Array<{
-    params: { version: string; slug: string[] };
-    props: DocPageProps;
-  }> = [];
-
-  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 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 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);
-
-    for (const item of buildDocRouteEntries({
-      source,
-      locale: "en",
-      routeSig: `v-docs;${version.slug}`,
-      urlFor,
-    })) {
-      result.push({
-        params: { version: version.slug, slug: item.slugParams },
-        props:
-          item.props.kind === "entry"
-            ? { ...item.props, version }
-            : { ...item.props, version },
-      });
-    }
-  }
-
-  return result;
-}
-
-// ---------------------------------------------------------------------------
-// Page component
-// ---------------------------------------------------------------------------
-
-type PageArgs = DocPageProps & { params: { version: string; slug: string[] } };
-
-export default function VersionedDocsPage(props: PageArgs): JSX.Element {
-  return renderDocPage(props, {
-    locale: "en",
-    version: props.version,
-  });
-}