create-zudo-doc 1.3.0 → 2.0.0

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.3.0";
+export declare const ZUDO_DOC_PIN = "^2.0.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.3.0";
+export const ZUDO_DOC_PIN = "^2.0.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/`
@@ -570,7 +570,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.3.0";
+        deps["@takazudo/zudo-doc-history-server"] = "^2.0.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/package.json

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

package/templates/base/pages/index.tsx

@@ -28,10 +28,12 @@ import type { JSX } from "preact";
 import type { VNode } from "preact";
 import { Island } from "@takazudo/zfb";
 import { SiteTreeNav } from "@takazudo/zudo-doc/site-tree-nav-island";
-import { FooterWithDefaults } from "./lib/_footer-with-defaults";
-import { HeaderWithDefaults } from "./lib/_header-with-defaults";
-import { HeadWithDefaults } from "./lib/_head-with-defaults";
-import { composeMetaTitle } from "./lib/_compose-meta-title";
+import {
+  FooterWithDefaults,
+  HeaderWithDefaults,
+  HeadWithDefaults,
+  composeMetaTitle,
+} from "./lib/_chrome";
 import { BodyEndIslands } from "./lib/_body-end-islands";
 
 export const frontmatter = { title: "Home" };

package/templates/base/pages/lib/_chrome.ts

@@ -0,0 +1,166 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+// Host chrome adapter — THE single host adapter for the page-chrome surface
+// (epic Collapse Wiring Shells #2420; HOSTCOLLAPSE #2427 collapsed the former
+// per-component `pages/lib/_*` chrome shells into this one module).
+//
+// It builds the host's REAL bindings ONCE and threads them through the public
+// `createChrome(routeContext, hostBindings)` builder, then re-exports the wired
+// page-chrome barrel (renderDocPage, HeaderWithDefaults, FooterWithDefaults,
+// HeadWithDefaults, composeMetaTitle, …). Every doc route + homepage chrome
+// import resolves here.
+//
+//   - the reconstructed route context comes from the retained, vitest-safe
+//     `./_route-context` seam (settings + i18n + URL/nav/slug helpers +
+//     nav-source resolvers + route enumerators), fed the host content bridge
+//     (`stableDocs`) so the content read + nav enumeration stay byte-identical;
+//   - the genuinely host-bound slots (`hostBindings`): the real SearchWidget,
+//     git-history manifest, sidebars config, frontmatter renderers/builder,
+//     footer tag loader + vocabulary, body-end islands, DocHistory island, and
+//     the showcase MDX content overrides (`mdxExtras`).
+//
+// Island-scanner contract (load-bearing): this module MUST keep the STATIC
+// imports of DocHistory (`@takazudo/zudo-doc/doc-history`), BodyEndIslands
+// (`./_body-end-islands`) and PresetGeneratorFallback (`./_preset-generator`).
+// After the collapse the only page→island import chain is
+// `pages/docs/*.tsx → _chrome.ts → {DocHistory, BodyEndIslands, PresetGenerator}`;
+// if any of these became a type-only or dynamic import the zfb island scanner
+// would stop walking it and the marker/bundle would silently drop.
+
+import type { ComponentChildren } from "preact";
+import type { ChromeHostBindings } from "@takazudo/zudo-doc/factory-context";
+
+import { createChrome } from "@takazudo/zudo-doc/chrome";
+
+import { settings } from "@/config/settings";
+import { defaultLocale } from "@/config/i18n";
+import { tagVocabulary } from "@/config/tag-vocabulary";
+import sidebars from "@/config/sidebars";
+import { frontmatterRenderers } from "@/config/frontmatter-preview-renderers";
+import { collectTags } from "@/utils/tags";
+import { toRouteSlug } from "@/utils/slug";
+import type { DocsEntry } from "@/types/docs-entry";
+
+import { routeContext } from "./_route-context";
+import { stableDocs, memoizeDerived } from "./_nav-source-cache";
+import { mergeLocaleDocs } from "./locale-merge";
+import { SearchWidget } from "./_search-widget";
+import { BodyEndIslands as BodyEndIslandsSeam } from "./_body-end-islands";
+import { buildFrontmatterPreviewEntries } from "./_frontmatter-preview-data";
+import { DetailsWrapper } from "./_details";
+import { PresetGeneratorFallback } from "./_preset-generator";
+import { DocHistory } from "@takazudo/zudo-doc/doc-history";
+import { HtmlPreviewWrapper, type HtmlPreviewWrapperProps } from "@takazudo/zudo-doc/html-preview-wrapper";
+// SSR author + date metadata — `#doc-history-meta` is the build-time manifest
+// alias (esbuild-inlined, no fs). Static import is load-bearing for the island
+// scanner chain noted above.
+import docHistoryMeta from "#doc-history-meta";
+
+// ---------------------------------------------------------------------------
+// Footer tag loader (host-side; moved verbatim from the former
+// _chrome-context.ts / _footer-with-defaults.tsx). Reads collections via
+// stableDocs / memoizeDerived and aggregates tags per locale. Threaded as
+// hostBindings.loadTagsForLocale.
+// ---------------------------------------------------------------------------
+
+function loadTagsForLocale(lang: string) {
+  if (lang === defaultLocale) {
+    const baseDocs = stableDocs("docs");
+    return memoizeDerived([baseDocs], "footerTaglist;default", () => {
+      const docs: DocsEntry[] = baseDocs.filter(
+        (d) => !d.data.draft && !d.data.unlisted && !d.data.category_no_page,
+      );
+      const tagMap = collectTags(docs, (id, data) => data.slug ?? toRouteSlug(id));
+      return [...tagMap.values()].sort((a, b) => a.tag.localeCompare(b.tag, lang));
+    });
+  }
+  const baseDocs = stableDocs("docs");
+  const localeDocs = stableDocs(`docs-${lang}`);
+  return memoizeDerived([baseDocs, localeDocs], `footerTaglist;${lang}`, () => {
+    const result = mergeLocaleDocs({
+      baseDocs: baseDocs.filter((d) => !d.data.draft),
+      localeDocs: localeDocs.filter((d) => !d.data.draft),
+      applyDefaultLocaleOnlyFilter: true,
+    });
+    const docs: DocsEntry[] = result.docs.filter((d) => !d.data.category_no_page);
+    const tagMap = collectTags(docs, (id, data) => data.slug ?? toRouteSlug(id));
+    return [...tagMap.values()].sort((a, b) => a.tag.localeCompare(b.tag, lang));
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Showcase MDX content overrides (host-bound; identical to the former
+// pages/_mdx-components.ts `extras` block — kept in lockstep). Threaded via
+// hostBindings.mdxExtras; the package factory merges them over its defaults.
+// ---------------------------------------------------------------------------
+
+/** MDX-tag stub: renders nothing (Preact null-vnode path). */
+const MdxStub = (_props: unknown) => null;
+
+/** SSR pass-through for `<Island when=…>` — renders children, ignores `when`. */
+function IslandWrapper(props: {
+  when?: "load" | "idle" | "visible" | "media";
+  children?: ComponentChildren;
+}): ComponentChildren {
+  return props.children ?? null;
+}
+
+const HtmlPreviewWithGlobalConfig = (props: HtmlPreviewWrapperProps) =>
+  HtmlPreviewWrapper({ globalConfig: settings.htmlPreview ?? null, ...props });
+
+const mdxExtras = {
+  HtmlPreview: HtmlPreviewWithGlobalConfig,
+  Details: DetailsWrapper,
+  SmartBreak: MdxStub,
+  Island: IslandWrapper,
+  PresetGenerator: PresetGeneratorFallback,
+  Avatar: MdxStub,
+  Button: MdxStub,
+  Card: MdxStub,
+  MyComponent: MdxStub,
+  PageLayout: MdxStub,
+} as unknown as Record<string, (props: Record<string, unknown>) => unknown>;
+
+// ---------------------------------------------------------------------------
+// The host's real bindings (the 10 ChromeHostBindings slots).
+// ---------------------------------------------------------------------------
+
+const hostBindings: ChromeHostBindings = {
+  SearchWidget: SearchWidget as ChromeHostBindings["SearchWidget"],
+  docHistoryMeta: docHistoryMeta as Record<string, unknown>,
+  sidebarsConfig: sidebars as unknown as Record<string, unknown>,
+  frontmatterRenderers: frontmatterRenderers as unknown as ChromeHostBindings["frontmatterRenderers"],
+  buildFrontmatterPreviewEntries:
+    buildFrontmatterPreviewEntries as unknown as ChromeHostBindings["buildFrontmatterPreviewEntries"],
+  loadTagsForLocale: loadTagsForLocale as unknown as ChromeHostBindings["loadTagsForLocale"],
+  tagVocabulary,
+  BodyEndIslands: BodyEndIslandsSeam as unknown as ChromeHostBindings["BodyEndIslands"],
+  DocHistory: DocHistory as unknown as ChromeHostBindings["DocHistory"],
+  mdxExtras: mdxExtras as ChromeHostBindings["mdxExtras"],
+};
+
+// ---------------------------------------------------------------------------
+// Build the wired page-chrome surface ONCE from the route context + real host
+// bindings, and re-export the barrel. Every omitted slot falls back to the
+// package stub (byte-identical to the injected package-routes path); each REAL
+// slot above overrides it.
+// ---------------------------------------------------------------------------
+
+const chrome = createChrome(routeContext, hostBindings);
+
+export type { RenderDocPageOptions } from "@takazudo/zudo-doc/doc-page-renderer";
+
+export const {
+  composeMetaTitle,
+  HeadWithDefaults,
+  HeaderWithDefaults,
+  FooterWithDefaults,
+  SidebarWithDefaults,
+  renderDocPage,
+  VersionsPageView,
+  collectTagMapForLocale,
+  TagDetailPageView,
+  TagsIndexPageView,
+  SiteTreeNavWrapper,
+  BodyEndIslands,
+} = chrome;

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

@@ -1,54 +1,10 @@
-// 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.
+// Thin shim — the memoized doc-route-entry builder rides on the unified
+// ChromeContext now (epic Collapse Wiring Shells #2420, FACTORIES #2424).
+// `createRouteContext` (in _chrome-context.ts) assembles `buildDocRouteEntries`
+// as part of the route context; this module just re-exports it so the doc-route
+// page files keep importing it from here 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 { routeContext } from "./_route-context";
 
-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,
-});
+export const { buildDocRouteEntries } = routeContext;

package/templates/base/pages/lib/_nav-source-docs.ts

@@ -1,37 +1,17 @@
-// Thin stub — nav-source-docs moved to the package (epic #2344, S6).
-// Calls `createNavSourceDocs(ctx)` from @takazudo/zudo-doc/nav-source-docs
-// with the host singletons injected, then re-exports the resulting resolver
-// functions so all existing call sites continue to work unchanged.
+// Thin shim — nav-source resolvers ride on the unified ChromeContext now
+// (epic Collapse Wiring Shells #2420, FACTORIES #2424). The reconstructed
+// `createRouteContext` (in _chrome-context.ts) builds the identity-stable
+// nav-source API as part of the route context; this module just re-exports the
+// bindings so the existing call sites (route files, nav wrappers, _nav-data-prep,
+// route-enumerators) keep importing them from here unchanged.
 
-import { createNavSourceDocs } from "@takazudo/zudo-doc/nav-source-docs";
 export type { NavSourceDocs, NavSourceOptions } from "@takazudo/zudo-doc/nav-source-docs";
-import { defaultLocale, getLocaleConfig } from "@/config/i18n";
-import { settings } from "@/config/settings";
-import { loadCategoryMeta, isNavVisible } from "@/utils/docs";
-import { isDefaultLocaleOnlyPath } from "@/utils/base";
-import { stableDocs } from "./_nav-source-cache";
+import { routeContext } from "./_route-context";
 
-const {
+export const {
   resolveNavSource,
   resolveVersionedLocaleSource,
   loadNavSourceDocs,
   stableMergeCategoryMeta,
   stableNavDocs,
-} = createNavSourceDocs({
-  defaultLocale,
-  docsDir: settings.docsDir,
-  getVersions: () => settings.versions,
-  getLocaleConfig,
-  loadCategoryMeta,
-  isNavVisible,
-  isDefaultLocaleOnlyPath,
-  stableDocs,
-});
-
-export {
-  resolveNavSource,
-  resolveVersionedLocaleSource,
-  loadNavSourceDocs,
-  stableMergeCategoryMeta,
-  stableNavDocs,
-};
+} = routeContext;

package/templates/base/pages/lib/_route-context.ts

@@ -0,0 +1,32 @@
+// Host route context — the reconstructed RouteContext (settings + i18n + URL
+// helpers + nav/slug helpers + identity-stable nav-source resolvers + doc-route
+// + route enumerators), built ONCE via the public `createRouteContext`
+// (epic Collapse Wiring Shells #2420, FACTORIES #2424).
+//
+// Kept SEPARATE from `_chrome-context.ts` so the data shells (`_nav-source-docs`
+// / `_doc-route-entries` / `route-enumerators`) — and the unit tests that import
+// them — depend ONLY on this lightweight module, NOT on the chrome host bindings
+// (which pull the build-time `#doc-history-meta` alias + island components that
+// don't resolve under vitest).
+//
+// The host content bridge (`stableDocs`) is injected so the docs read + nav
+// enumeration match the project's existing `pages/*` paths() exactly (host
+// `bridgeDocsEntries` over the `zfb/content` snapshot), not the package default.
+
+import { createRouteContext } from "@takazudo/zudo-doc/route-context";
+import type { ColorScheme } from "@takazudo/zudo-doc/color-scheme-utils";
+import { settings } from "@/config/settings";
+import { translations } from "@/config/i18n";
+import { tagVocabulary } from "@/config/tag-vocabulary";
+import { colorSchemes } from "@/config/color-schemes";
+import { stableDocs } from "./_nav-source-cache";
+
+export const routeContext = createRouteContext(
+  {
+    settings,
+    translations,
+    tagVocabulary,
+    colorSchemes: colorSchemes as unknown as Record<string, ColorScheme>,
+  },
+  { stableDocs },
+);

package/templates/base/src/config/tag-vocabulary-types.ts

@@ -1,39 +1,4 @@
-/**
- * Tag governance enforcement level.
- *
- * - `"off"`   — no vocabulary-aware enforcement. The `tags` schema stays a
- *               free-form `string[]`. Identical to pre-vocabulary behaviour.
- * - `"warn"`  — `tags` schema stays free-form so builds pass, but the tag
- *               audit script (see Sub 2) reports unknown tags as warnings and
- *               exits non-zero under `--ci`.
- * - `"strict"` — `tags` schema is tightened to `z.enum([...allowedIds])`, so
- *                unknown tags fail `pnpm check` / `pnpm build`.
- *
- * Orthogonal to `tagVocabulary` (the on/off switch for consulting the
- * vocabulary file at runtime). See `settings-types.ts` for details.
- */
-export type TagGovernanceMode = "off" | "warn" | "strict";
-
-/**
- * A single entry in the tag vocabulary.
- *
- * - `id`         — canonical tag id. What content files should ideally use.
- * - `label`      — optional human-readable label (falls back to `id`).
- * - `description`— optional short description for tooling / tag index pages.
- * - `group`      — optional grouping key used by the grouped tag footer
- *                  (e.g. `"type"`, `"level"`, `"topic"`).
- * - `aliases`    — alternate strings that content files may use. Alias
- *                  resolution rewrites these to `id` before aggregation.
- * - `deprecated` — `true` marks the tag as deprecated with no redirect: the
- *                  canonical id is dropped from aggregation. Pass
- *                  `{ redirect: "<other-id>" }` to rewrite this tag to another
- *                  canonical id when it appears in content.
- */
-export interface TagVocabularyEntry {
-  id: string;
-  label?: string;
-  description?: string;
-  group?: string;
-  aliases?: readonly string[];
-  deprecated?: boolean | { redirect?: string };
-}
+// Re-export from the shared package — canonical definitions live in
+// @takazudo/zudo-doc/settings (epic #2321). Consumers that import from
+// this local path continue to work unchanged.
+export type { TagGovernanceMode, TagVocabularyEntry } from "@takazudo/zudo-doc/settings";

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

@@ -32,10 +32,12 @@ import type { VNode } from "preact";
 import { Island } from "@takazudo/zfb";
 import { SiteTreeNav } from "@takazudo/zudo-doc/site-tree-nav-island";
 import { resolveNavSource } from "../lib/_nav-source-docs";
-import { FooterWithDefaults } from "../lib/_footer-with-defaults";
-import { HeaderWithDefaults } from "../lib/_header-with-defaults";
-import { HeadWithDefaults } from "../lib/_head-with-defaults";
-import { composeMetaTitle } from "../lib/_compose-meta-title";
+import {
+  FooterWithDefaults,
+  HeaderWithDefaults,
+  HeadWithDefaults,
+  composeMetaTitle,
+} from "../lib/_chrome";
 import { BodyEndIslands } from "../lib/_body-end-islands";
 
 export const frontmatter = { title: "Home" };

package/templates/base/pages/_mdx-components.ts

@@ -1,106 +0,0 @@
-// Project MDX-components assembly — thin wrapper over the package factory.
-//
-// The bulk of the components bag (htmlOverrides, admonitions, CodeGroup,
-// Tabs/TabItem, MathBlock, the img base-rewrite, the enlargeable-`p` override)
-// now ships from `@takazudo/zudo-doc/mdx-components` (package-first migration,
-// epic #2321, S8 #2332). This file keeps ONLY what is genuinely project-bound:
-//
-//   - the 4 locale-bound nav wrappers (CategoryNav / CategoryTreeNav /
-//     SiteTreeNav / SiteTreeNavDemo) — they depend on the project's content
-//     collections + nav-tree utilities, so they cannot live in the package.
-//     They are passed into the factory as `navData`; the factory injects the
-//     active `locale` so `/ja` resolves the JA collection (the load-bearing
-//     locale thread — a static global mdx-components slot would render the EN
-//     tree on every `/ja` page, which is why this stays a per-call factory).
-//   - project `extras` spread last: HtmlPreview (with the host's global
-//     config), Details, the Island SSR pass-through, the PresetGenerator SSR
-//     shell, and the pure-showcase stubs (Avatar/Button/Card/MyComponent/
-//     PageLayout) that appear only as illustrative MDX prose.
-
-import type { ComponentChildren } from "preact";
-import { createMdxComponents as createMdxComponentsBase } from "@takazudo/zudo-doc/mdx-components";
-import { HtmlPreviewWrapper, type HtmlPreviewWrapperProps } from "@takazudo/zudo-doc/html-preview-wrapper";
-import { defaultLocale, type Locale } from "@/config/i18n";
-import { settings } from "@/config/settings";
-import { CategoryNavWrapper } from "./lib/_category-nav";
-import { CategoryTreeNavWrapper } from "./lib/_category-tree-nav";
-import { SiteTreeNavWrapper } from "./lib/_site-tree-nav";
-import { DetailsWrapper } from "./lib/_details";
-import { PresetGeneratorFallback } from "./lib/_preset-generator";
-
-const HtmlPreviewWithGlobalConfig = (props: HtmlPreviewWrapperProps) =>
-  HtmlPreviewWrapper({ globalConfig: settings.htmlPreview ?? null, ...props });
-
-/**
- * MDX-tag stub: renders nothing. Returning `null` keeps the rendered tree
- * intact (Preact's null-vnode path) without leaking placeholder markup into
- * the SSR output.
- */
-const MdxStub = (_props: unknown) => null;
-
-/**
- * SSR-pass-through wrapper for `<Island when="load|idle|visible">`.
- *
- * In the zfb build the zfb `<Island>` component is unavailable here, so the
- * MDX corpus tag resolves to this binding instead. Rendering the children
- * directly ensures server-renderable content nested inside `<Island>`
- * (headings, paragraphs, etc.) appears in the SSR HTML. The `when` prop is
- * ignored at render time — it is only meaningful to the zfb hydration runtime
- * on the client, which reads `data-when` on the inner SSR-skip placeholder.
- */
-function IslandWrapper(props: {
-  when?: "load" | "idle" | "visible" | "media";
-  children?: ComponentChildren;
-}): ComponentChildren {
-  return props.children ?? null;
-}
-
-/**
- * Build a locale-aware MDX components map for the given locale.
- *
- * Delegates the package-resident components to the `@takazudo/zudo-doc`
- * factory and supplies the project-bound pieces:
- *   - `navData`: the 4 locale-aware nav wrappers (the factory injects `lang`).
- *   - `extras`: HtmlPreview (host-configured), Details, Island pass-through,
- *     PresetGenerator SSR shell, and the showcase stubs.
- *
- * Page modules should call createMdxComponents(locale) — not the static
- * mdxComponents export — so each render gets the locale-correct map.
- */
-export function createMdxComponents(lang: Locale | string = defaultLocale) {
-  return createMdxComponentsBase({
-    settings,
-    locale: lang,
-    navData: {
-      CategoryNav: CategoryNavWrapper as unknown as (props: Record<string, unknown>) => unknown,
-      CategoryTreeNav: CategoryTreeNavWrapper as unknown as (props: Record<string, unknown>) => unknown,
-      SiteTreeNav: SiteTreeNavWrapper as unknown as (props: Record<string, unknown>) => unknown,
-    },
-    extras: {
-      HtmlPreview: HtmlPreviewWithGlobalConfig,
-      Details: DetailsWrapper,
-      // SmartBreak: corpus tag with no visual rendering — render nothing.
-      SmartBreak: MdxStub,
-      // Island: pass children through so server-renderable content nested
-      // inside <Island> appears in SSR HTML. See IslandWrapper comment above.
-      Island: IslandWrapper,
-      // PresetGenerator: SSR fallback shell that renders the 8 section headings;
-      // the interactive form hydrates client-side via the SSR-skip placeholder
-      // inside PresetGeneratorFallback (see pages/lib/_preset-generator.tsx).
-      PresetGenerator: PresetGeneratorFallback,
-      // Pure showcase placeholders — appear only inside MDX prose as
-      // illustrative examples, never implemented as real components.
-      Avatar: MdxStub,
-      Button: MdxStub,
-      Card: MdxStub,
-      MyComponent: MdxStub,
-      PageLayout: MdxStub,
-    },
-  });
-}
-
-/**
- * Static default-locale components map for backward compatibility.
- * New page modules should call createMdxComponents(locale) instead.
- */
-export const mdxComponents = createMdxComponents(defaultLocale);

package/templates/base/pages/lib/_category-nav.tsx

@@ -1,34 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Thin stub — category-nav moved to the package (epic #2344, S8).
-// Calls `createCategoryNavWrapper(deps)` from @takazudo/zudo-doc/category-nav
-// with host singletons injected, then re-exports the resulting component so
-// all existing call sites continue to work unchanged.
-
-import { createCategoryNavWrapper } from "@takazudo/zudo-doc/category-nav";
-import { buildNavTree, findNode, firstRoutedHref } from "@/utils/docs";
-import { defaultLocale } from "@/config/i18n";
-import { resolveNavSource } from "./_nav-source-docs";
-
-export type { CategoryNavWrapperProps } from "@takazudo/zudo-doc/category-nav";
-
-export const CategoryNavWrapper = createCategoryNavWrapper({
-  defaultLocale,
-  resolveNavSource: resolveNavSource as (
-    lang: string,
-    currentVersion: string | undefined,
-    options?: { applyDefaultLocaleOnlyFilter?: boolean; keepUnlisted?: boolean },
-  ) => import("@takazudo/zudo-doc/category-nav").CategoryNavSource,
-  buildNavTree: buildNavTree as (
-    docs: unknown[],
-    locale: string,
-    categoryMeta: Map<string, unknown>,
-  ) => import("@takazudo/zudo-doc/category-nav").CategoryNavNode[],
-  findNode: findNode as (
-    tree: import("@takazudo/zudo-doc/category-nav").CategoryNavNode[],
-    slug: string,
-  ) => import("@takazudo/zudo-doc/category-nav").CategoryNavNode | undefined,
-  firstRoutedHref: firstRoutedHref as (
-    node: import("@takazudo/zudo-doc/category-nav").CategoryNavNode,
-  ) => string | undefined,
-});

package/templates/base/pages/lib/_category-tree-nav.tsx

@@ -1,45 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Thin stub — category-tree-nav moved to the package (epic #2344, S8).
-// Calls `createCategoryTreeNavWrapper(deps)` from
-// @takazudo/zudo-doc/category-tree-nav with host singletons injected,
-// then re-exports the resulting component so all existing call sites continue
-// to work unchanged.
-
-import { createCategoryTreeNavWrapper } from "@takazudo/zudo-doc/category-tree-nav";
-import type {
-  CategoryTreeNavNode,
-  CategoryTreeNavSource,
-} from "@takazudo/zudo-doc/category-tree-nav";
-import { buildNavTree, groupSatelliteNodes, findNode, type NavNode } from "@/utils/docs";
-import { defaultLocale, type Locale } from "@/config/i18n";
-import type { DocsEntry } from "@/types/docs-entry";
-import type { CategoryMeta } from "@/utils/docs";
-import { resolveNavSource } from "./_nav-source-docs";
-
-export type { CategoryTreeNavWrapperProps } from "@takazudo/zudo-doc/category-tree-nav";
-
-// The factory describes its injected nav helpers with the minimal
-// CategoryTreeNavNode view (no `slug` / `position`), while the host helpers are
-// typed against the full NavNode. At runtime the nodes are real NavNodes; the
-// wrappers re-view them as the minimal type at the injection boundary (cast via
-// `unknown` because NavNode is a structural supertype of CategoryTreeNavNode,
-// so a direct cast is rejected as non-overlapping).
-export const CategoryTreeNavWrapper = createCategoryTreeNavWrapper({
-  defaultLocale,
-  resolveNavSource: resolveNavSource as (
-    lang: string,
-    currentVersion: string | undefined,
-    options?: { applyDefaultLocaleOnlyFilter?: boolean; keepUnlisted?: boolean },
-  ) => CategoryTreeNavSource,
-  buildNavTree: (docs: unknown[], locale: string, categoryMeta: Map<string, unknown>) =>
-    buildNavTree(
-      docs as DocsEntry[],
-      locale as Locale,
-      categoryMeta as Map<string, CategoryMeta>,
-    ) as unknown as CategoryTreeNavNode[],
-  groupSatelliteNodes: (tree: CategoryTreeNavNode[], prefixes: string[]) =>
-    groupSatelliteNodes(tree as unknown as NavNode[], prefixes) as unknown as CategoryTreeNavNode[],
-  findNode: (tree: CategoryTreeNavNode[], slug: string) =>
-    findNode(tree as unknown as NavNode[], slug) as unknown as CategoryTreeNavNode | undefined,
-});

package/templates/base/pages/lib/_compose-meta-title.ts

@@ -1,25 +0,0 @@
-/**
- * Compose the canonical "<title> | <siteName>" page-title shape used by
- * both <title> (emitted by DocLayout) and og:title (emitted by
- * HeadWithDefaults).
- *
- * Why this exists: the legacy Astro layout synthesised this suffix
- * inline. The zfb DocLayout shell intentionally renders only what the
- * host passes as `title`, so the host has to compose the suffix itself.
- * Centralising the composition in one helper keeps every host call
- * site in sync and matches the SEO/UX-recognised shape the original
- * site shipped (also asserted by smoke-seo.spec.ts).
- *
- * Edge cases:
- * - When `title` is identical to `settings.siteName` (e.g. the home
- *   page already passes `settings.siteName` as the title), do NOT
- *   duplicate — return just the bare site name. Mirrors the legacy
- *   Astro behaviour.
- * - When `siteName` is missing/empty (defensive — settings.ts always
- *   has it in practice), fall back to the bare title.
- *
- */
-import { createComposeMetaTitle } from "@takazudo/zudo-doc/compose-meta-title";
-import { settings } from "@/config/settings";
-
-export const composeMetaTitle = createComposeMetaTitle(settings.siteName);

package/templates/base/pages/lib/_doc-body-end.tsx

@@ -1,8 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Host thin-stub — see @takazudo/zudo-doc/doc-body-end (epic #2344, S7).
-import { settings } from "@/config/settings";
-import { createDocBodyEnd } from "@takazudo/zudo-doc/doc-body-end";
-import { BodyEndIslands } from "./_body-end-islands";
-
-export const DocBodyEnd = createDocBodyEnd({ settings, BodyEndIslands });