create-zudo-doc 1.3.0 → 2.0.1

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 });

package/templates/base/pages/lib/_doc-content-header.tsx

@@ -1,17 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Host thin-stub — see @takazudo/zudo-doc/doc-content-header (epic #2344, S7).
-import { t } from "@/config/i18n";
-import { frontmatterRenderers } from "@/config/frontmatter-preview-renderers";
-import { createDocContentHeader } from "@takazudo/zudo-doc/doc-content-header";
-import { buildFrontmatterPreviewEntries } from "./_frontmatter-preview-data";
-import { DocMetainfoArea } from "./_doc-metainfo-area";
-import { DocTagsArea } from "./_doc-tags-area";
-
-export const DocContentHeader = createDocContentHeader({
-  t,
-  buildFrontmatterPreviewEntries,
-  frontmatterRenderers,
-  DocMetainfoArea,
-  DocTagsArea,
-});

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

@@ -1,34 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Host thin-stub — see @takazudo/zudo-doc/doc-history-area (epic #2344, S7).
-//
-// 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 { 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
-// statically so no Node-only `fs` code reaches the client bundle.
-// The `#doc-history-meta` alias is defined in tsconfig.json and resolves
-// to the absolute path of `.zfb/doc-history-meta.json` — this is needed
-// 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";
-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,26 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource 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 { 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
-// statically so no Node-only `fs` code reaches the client bundle.
-// The `#doc-history-meta` alias is defined in tsconfig.json and resolves
-// to the absolute path of `.zfb/doc-history-meta.json` — this is needed
-// 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";
-
-export type { DocMetainfoAreaProps } from "@takazudo/zudo-doc/doc-metainfo-area";
-
-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,31 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// 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 { getNavSectionForSlug } from "@/utils/nav-scope";
-import { toRouteSlug } from "@/utils/slug";
-import { createMdxComponents } from "../_mdx-components";
-import { createRenderDocPage } from "@takazudo/zudo-doc/doc-page-renderer";
-import { buildInlineVersionSwitcher } from "./_inline-version-switcher";
-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 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,
-});

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

@@ -1,29 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Host thin-stub — see @takazudo/zudo-doc/doc-page-shell (epic #2344, S5).
-import { settings } from "@/config/settings";
-import { createDocPageShell } from "@takazudo/zudo-doc/doc-page-shell";
-import { composeMetaTitle } from "./_compose-meta-title";
-import { getTocTitle } from "./_toc-title";
-import { HeadWithDefaults } from "./_head-with-defaults";
-import { SidebarWithDefaults } from "./_sidebar-with-defaults";
-import { HeaderWithDefaults } from "./_header-with-defaults";
-import { FooterWithDefaults } from "./_footer-with-defaults";
-import { SidebarPrepaint } from "./_sidebar-prepaint";
-import { DocBodyEnd } from "./_doc-body-end";
-import { DocPager } from "./_doc-pager";
-
-export type { DocPageShellProps } from "@takazudo/zudo-doc/doc-page-shell";
-
-export const DocPageShell = createDocPageShell({
-  settings,
-  composeMetaTitle,
-  getTocTitle,
-  HeadWithDefaults,
-  SidebarWithDefaults,
-  HeaderWithDefaults,
-  FooterWithDefaults,
-  SidebarPrepaint,
-  DocBodyEnd,
-  DocPager,
-});

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

@@ -1,9 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Host thin-stub — see @takazudo/zudo-doc/doc-pager (epic #2344, S7).
-import { t } from "@/config/i18n";
-import { createDocPager } from "@takazudo/zudo-doc/doc-pager";
-
-export type { DocPagerProps } from "@takazudo/zudo-doc/doc-pager";
-
-export const DocPager = createDocPager({ t });

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

@@ -1,16 +0,0 @@
-// Thin stub — doc-route-paths moved to the package (epic #2344, S6).
-// Re-exports the pure prop-builder helpers from @takazudo/zudo-doc/doc-route-paths.
-
-export type {
-  DocNavNode,
-  PaginationOverrides,
-} from "@takazudo/zudo-doc/doc-route-paths";
-
-export {
-  flattenTree,
-  findNode,
-  flattenSubtree,
-  resolveDocPrevNext,
-  rewriteNavHref,
-  remapNavChildHrefs,
-} from "@takazudo/zudo-doc/doc-route-paths";

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

@@ -1,30 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Host thin-stub — see @takazudo/zudo-doc/doc-tags-area (epic #2344, S7).
-import { settings } from "@/config/settings";
-import { defaultLocale, t } from "@/config/i18n";
-import { withBase } from "@/utils/base";
-import { tagVocabulary } from "@/config/tag-vocabulary";
-import { createDocTagsArea } from "@takazudo/zudo-doc/doc-tags-area";
-
-// Inlined from the original _doc-tags-area.tsx `tagHref` helper.
-// Builds the base-prefixed tag detail page href for the given locale.
-// The tag segment is URL-encoded at the href site only.
-function tagHref(tag: string, locale: string): string {
-  const encoded = encodeURIComponent(tag);
-  const path =
-    locale === defaultLocale
-      ? `/docs/tags/${encoded}`
-      : `/${locale}/docs/tags/${encoded}`;
-  return withBase(path);
-}
-
-export type { DocTagsAreaProps } from "@takazudo/zudo-doc/doc-tags-area";
-
-export const DocTagsArea = createDocTagsArea({
-  settings,
-  defaultLocale,
-  tagVocabularyEntries: tagVocabulary,
-  tagHref,
-  t,
-});

package/templates/base/pages/lib/_footer-with-defaults.tsx

@@ -1,58 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Host thin-stub — see @takazudo/zudo-doc/footer-with-defaults (epic #2344, S5).
-// Wires host singletons into the package factory and passes the tag loading
-// function as a dependency so the factory never imports @/ aliases.
-import { settings } from "@/config/settings";
-import { isExternal, resolveHref, withBase } from "@/utils/base";
-import { defaultLocale } from "@/config/i18n";
-import { tagVocabulary } from "@/config/tag-vocabulary";
-import { collectTags } from "@/utils/tags";
-import { toRouteSlug } from "@/utils/slug";
-import { mergeLocaleDocs } from "./locale-merge";
-import { stableDocs, memoizeDerived } from "./_nav-source-cache";
-import type { DocsEntry } from "@/types/docs-entry";
-import { createFooterWithDefaults } from "@takazudo/zudo-doc/footer-with-defaults";
-
-// ---------------------------------------------------------------------------
-// Tag loading (host-side, reads collections via stableDocs / memoizeDerived)
-// ---------------------------------------------------------------------------
-
-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));
-  });
-}
-
-// ---------------------------------------------------------------------------
-// Thin-stub export
-// ---------------------------------------------------------------------------
-
-export const FooterWithDefaults = createFooterWithDefaults({
-  settings,
-  defaultLocale,
-  tagVocabulary,
-  isExternal,
-  resolveHref,
-  withBase,
-  loadTagsForLocale,
-});

package/templates/base/pages/lib/_head-with-defaults.tsx

@@ -1,22 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Host thin-stub — see @takazudo/zudo-doc/head-with-defaults (epic #2344, S5).
-import { settings } from "@/config/settings";
-import { withBase, absoluteUrl } from "@/utils/base";
-import {
-  generateCssCustomProperties,
-  generateLightDarkCssProperties,
-} from "@/config/color-scheme-utils";
-import { composeMetaTitle } from "./_compose-meta-title";
-import { createHeadWithDefaults } from "@takazudo/zudo-doc/head-with-defaults";
-
-export type { HeadWithDefaultsProps } from "@takazudo/zudo-doc/head-with-defaults";
-
-export const HeadWithDefaults = createHeadWithDefaults({
-  settings,
-  composeMetaTitle,
-  withBase,
-  absoluteUrl,
-  generateCssCustomProperties,
-  generateLightDarkCssProperties,
-});

package/templates/base/pages/lib/_header-with-defaults.tsx

@@ -1,45 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Host thin-stub — see @takazudo/zudo-doc/header-with-defaults (epic #2344, S5).
-import { settings } from "@/config/settings";
-import { defaultLocale, locales, t, type Locale } from "@/config/i18n";
-import { buildGitHubRepoUrl } from "@/utils/github";
-import {
-  docsUrl,
-  navHref,
-  stripBase,
-  versionedDocsUrl,
-  withBase,
-} from "@/utils/base";
-import { createHeaderWithDefaults } from "@takazudo/zudo-doc/header-with-defaults";
-import { SearchWidget } from "./_search-widget";
-import {
-  buildRootMenuItems,
-  buildLocaleLinksForNav,
-  buildSidebarNodes,
-  getThemeDefaultMode,
-} from "./_nav-data-prep";
-
-export type { HeaderWithDefaultsProps } from "@takazudo/zudo-doc/header-with-defaults";
-
-export const HeaderWithDefaults = createHeaderWithDefaults({
-  settings,
-  defaultLocale,
-  locales,
-  t: (key, lang) => t(key as Parameters<typeof t>[0], lang as Locale),
-  withBase,
-  stripBase,
-  docsUrl: (slug, lang) => docsUrl(slug, lang as Locale),
-  navHref: (path, lang, version) => navHref(path, lang as Locale | undefined, version),
-  versionedDocsUrl: (slug, versionSlug, lang) =>
-    versionedDocsUrl(slug, versionSlug, lang as Locale),
-  buildLocaleLinksForNav: (currentPath, lang, localeCount) =>
-    buildLocaleLinksForNav(currentPath, lang as Locale, localeCount),
-  buildRootMenuItems: (lang, currentVersion) =>
-    buildRootMenuItems(lang as Locale, currentVersion),
-  buildSidebarNodes: (lang, navSection, currentVersion) =>
-    buildSidebarNodes(lang as Locale, navSection, currentVersion),
-  getThemeDefaultMode,
-  buildGitHubRepoUrl,
-  SearchWidget,
-});

package/templates/base/pages/lib/_inline-version-switcher.tsx

@@ -1,23 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Thin stub — inline-version-switcher moved to the package (epic #2344, S8).
-// Calls `createInlineVersionSwitcher(deps)` from
-// @takazudo/zudo-doc/inline-version-switcher with host singletons injected,
-// then re-exports the resulting builder so all existing call sites continue
-// to work unchanged.
-
-import { createInlineVersionSwitcher } from "@takazudo/zudo-doc/inline-version-switcher";
-import { settings } from "@/config/settings";
-import { defaultLocale, t } from "@/config/i18n";
-import { docsUrl, versionedDocsUrl, withBase } from "@/utils/base";
-
-export { type InlineVersionSwitcherVersionEntry } from "@takazudo/zudo-doc/inline-version-switcher";
-
-export const buildInlineVersionSwitcher = createInlineVersionSwitcher({
-  settings,
-  defaultLocale,
-  t,
-  docsUrl,
-  versionedDocsUrl,
-  withBase,
-});

package/templates/base/pages/lib/_math-block.tsx

@@ -1,4 +0,0 @@
-// Re-export from the shared package — moved to @takazudo/zudo-doc/math-block
-// as part of the package-first migration (epic #2321, S4 #2327).
-export type { MathBlockProps } from "@takazudo/zudo-doc/math-block";
-export { MathBlock } from "@takazudo/zudo-doc/math-block";

package/templates/base/pages/lib/_nav-data-prep.ts

@@ -1,118 +0,0 @@
-// Host thin-stub for nav data-prep utilities (epic #2344, S5).
-// Imports core logic from @takazudo/zudo-doc and wires host singletons.
-//
-// Package exports the pure parameterized functions; this stub binds
-// them to the host's `settings`, `i18n`, and `base` singletons so
-// existing call sites (_header-with-defaults.tsx, _sidebar-with-defaults.tsx)
-// are unchanged.
-
-import { settings } from "@/config/settings";
-import { t, type Locale } from "@/config/i18n";
-import {
-  buildLocaleLinks,
-  navHref,
-  versionedDocsUrl,
-} from "@/utils/base";
-import { type NavNode } from "@/utils/docs";
-import { buildSidebarForSection } from "@/utils/sidebar";
-import { loadNavSourceDocs } from "./_nav-source-docs";
-import {
-  remapVersionedHrefs as _remapVersionedHrefs,
-  buildRootMenuItems as _buildRootMenuItems,
-  buildLocaleLinksForNav as _buildLocaleLinksForNav,
-  getThemeDefaultMode as _getThemeDefaultMode,
-} from "@takazudo/zudo-doc/nav-data-prep";
-
-// ---------------------------------------------------------------------------
-// remapVersionedHrefs
-// ---------------------------------------------------------------------------
-
-/**
- * Walk the nav tree and rewrite each node's `href` to its versioned form.
- */
-export function remapVersionedHrefs(
-  nodes: NavNode[],
-  version: string,
-  nodeLang: Locale,
-): NavNode[] {
-  return _remapVersionedHrefs(
-    nodes,
-    version,
-    nodeLang,
-    (slug, v, lang) => versionedDocsUrl(slug, v, lang as Locale),
-  );
-}
-
-// ---------------------------------------------------------------------------
-// buildRootMenuItems
-// ---------------------------------------------------------------------------
-
-/**
- * Root-menu items derived from settings.headerNav (mobile "back to menu" list).
- */
-export function buildRootMenuItems(
-  lang: Locale,
-  currentVersion?: string,
-) {
-  return _buildRootMenuItems(
-    lang,
-    currentVersion,
-    settings.headerNav,
-    (key, l) => t(key as Parameters<typeof t>[0], l as Locale),
-    (path, l, v) => navHref(path, l as Locale | undefined, v),
-  );
-}
-
-// ---------------------------------------------------------------------------
-// buildLocaleLinksForNav
-// ---------------------------------------------------------------------------
-
-/**
- * Locale-switcher links for the mobile sidebar footer and language switcher.
- * Returns `undefined` when only one locale is configured (single-locale guard).
- */
-export function buildLocaleLinksForNav(
-  currentPath: string,
-  lang: Locale,
-  localeCount: number,
-) {
-  return _buildLocaleLinksForNav(
-    currentPath,
-    lang,
-    localeCount,
-    (path, l) => buildLocaleLinks(path, l as Locale),
-  );
-}
-
-// ---------------------------------------------------------------------------
-// buildSidebarNodes
-// ---------------------------------------------------------------------------
-
-/**
- * Build the resolved sidebar node list for a given section + version.
- */
-export function buildSidebarNodes(
-  lang: Locale,
-  navSection: string | undefined,
-  currentVersion?: string,
-  emptyWhenUnsectioned = true,
-): NavNode[] {
-  if (navSection === undefined && emptyWhenUnsectioned) return [];
-  const { navDocs, categoryMeta } = loadNavSourceDocs(lang, currentVersion);
-  const rawNodes = buildSidebarForSection(navDocs, lang, navSection, categoryMeta);
-  return currentVersion
-    ? remapVersionedHrefs(rawNodes, currentVersion, lang)
-    : rawNodes;
-}
-
-// ---------------------------------------------------------------------------
-// themeDefaultMode
-// ---------------------------------------------------------------------------
-
-/**
- * Extract the configured default color mode from settings.
- * Returns `undefined` when color mode is not configured (single-scheme projects).
- */
-export function getThemeDefaultMode() {
-  return _getThemeDefaultMode(settings.colorMode);
-}

package/templates/base/pages/lib/_search-widget-script.ts

@@ -1,2 +0,0 @@
-// Host thin-stub — see @takazudo/zudo-doc/search-widget-script (epic #2344, S5).
-export { SEARCH_WIDGET_SCRIPT } from "@takazudo/zudo-doc/search-widget-script";

package/templates/base/pages/lib/_sidebar-prepaint.tsx

@@ -1,11 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Host thin-stub — see @takazudo/zudo-doc/sidebar-prepaint (epic #2344, S5).
-import { settings } from "@/config/settings";
-import { createSidebarPrepaint } from "@takazudo/zudo-doc/sidebar-prepaint";
-
-export type { SidebarPrepaintProps } from "@takazudo/zudo-doc/sidebar-prepaint";
-
-export const SidebarPrepaint = createSidebarPrepaint({
-  sidebarToggle: Boolean(settings.sidebarToggle),
-});

package/templates/base/pages/lib/_sidebar-with-defaults.tsx

@@ -1,26 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Host thin-stub — see @takazudo/zudo-doc/sidebar-with-defaults (epic #2344, S5).
-import { defaultLocale, locales, t, type Locale } from "@/config/i18n";
-import { createSidebarWithDefaults } from "@takazudo/zudo-doc/sidebar-with-defaults";
-import {
-  buildRootMenuItems,
-  buildLocaleLinksForNav,
-  buildSidebarNodes,
-  getThemeDefaultMode,
-} from "./_nav-data-prep";
-
-export type { SidebarWithDefaultsProps } from "@takazudo/zudo-doc/sidebar-with-defaults";
-
-export const SidebarWithDefaults = createSidebarWithDefaults({
-  defaultLocale,
-  localeCount: locales.length,
-  buildRootMenuItems: (lang, currentVersion) =>
-    buildRootMenuItems(lang as Locale, currentVersion),
-  buildLocaleLinksForNav: (currentPath, lang, localeCount) =>
-    buildLocaleLinksForNav(currentPath, lang as Locale, localeCount),
-  buildSidebarNodes: (lang, navSection, currentVersion, emptyWhenUnsectioned) =>
-    buildSidebarNodes(lang as Locale, navSection, currentVersion, emptyWhenUnsectioned),
-  getThemeDefaultMode,
-  t: (key, lang) => t(key as Parameters<typeof t>[0], lang as Locale),
-});

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

@@ -1,37 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Thin stub — site-tree-nav moved to the package (epic #2344, S8).
-// Calls `createSiteTreeNavWrapper(deps)` from @takazudo/zudo-doc/site-tree-nav
-// with host singletons injected, then re-exports the resulting component so
-// all existing call sites continue to work unchanged.
-//
-// IMPORTANT: Island({when:"idle"}) is PRESERVED in the package factory —
-// the island mounts after the page is idle for performance (refs #1453).
-
-import { createSiteTreeNavWrapper } from "@takazudo/zudo-doc/site-tree-nav";
-import type { SidebarNavNode } from "@takazudo/zudo-doc/sidebar/types";
-import { buildNavTree, groupSatelliteNodes } from "@/utils/docs";
-import { defaultLocale } from "@/config/i18n";
-import { getCategoryOrder } from "@/utils/nav-scope";
-import { resolveNavSource } from "./_nav-source-docs";
-
-export type { SiteTreeNavWrapperProps } from "@takazudo/zudo-doc/site-tree-nav";
-
-export const SiteTreeNavWrapper = createSiteTreeNavWrapper({
-  defaultLocale,
-  resolveNavSource: resolveNavSource as (
-    lang: string,
-    currentVersion: string | undefined,
-    options?: { applyDefaultLocaleOnlyFilter?: boolean; keepUnlisted?: boolean },
-  ) => import("@takazudo/zudo-doc/site-tree-nav").SiteTreeNavSource,
-  buildNavTree: buildNavTree as (
-    docs: unknown[],
-    locale: string,
-    categoryMeta: Map<string, unknown>,
-  ) => SidebarNavNode[],
-  groupSatelliteNodes: groupSatelliteNodes as (
-    tree: SidebarNavNode[],
-    prefixes: string[],
-  ) => SidebarNavNode[],
-  getCategoryOrder,
-});

package/templates/base/pages/lib/_toc-title.ts

@@ -1,3 +0,0 @@
-// TOC section-label resolver for the Toc/MobileToc overrides mounted by
-// `_doc-page-shell.tsx`, re-exported from the @takazudo/zudo-doc package.
-export { getTocTitle } from "@takazudo/zudo-doc/toc";

package/templates/base/pages/lib/route-enumerators.ts

@@ -1,58 +0,0 @@
-// Thin stub — route-enumerators moved to the package (epic #2344, S6).
-// Calls `createRouteEnumerators(ctx)` from @takazudo/zudo-doc/route-enumerators
-// with the host singletons injected, then re-exports the resulting enumeration
-// functions so all existing call sites continue to work unchanged.
-
-import { createRouteEnumerators } from "@takazudo/zudo-doc/route-enumerators";
-import type {
-  DocsEntryForTags,
-  TagInfoForEnum,
-  DocPageEntry,
-  DocNavNode,
-} from "@takazudo/zudo-doc/route-enumerators";
-import { settings } from "@/config/settings";
-import { defaultLocale, type Locale } from "@/config/i18n";
-import { docsUrl, versionedDocsUrl, withBase, isDefaultLocaleOnlyPath } from "@/utils/base";
-import { buildNavTree, collectAutoIndexNodes, type CategoryMeta } from "@/utils/docs";
-import { collectTags } from "@/utils/tags";
-import { toRouteSlug } from "@/utils/slug";
-import type { DocsEntry } from "@/types/docs-entry";
-import { loadDocs } from "../_data";
-import { resolveNavSource, resolveVersionedLocaleSource } from "./_nav-source-docs";
-import { mergeLocaleDocs } from "./locale-merge";
-
-export const {
-  enumerateDocsRoutes,
-  enumerateTagsRoutes,
-  enumerateVersionedRoutes,
-  enumerateAllRoutes,
-} = createRouteEnumerators({
-  defaultLocale,
-  getLocaleKeys: () => Object.keys(settings.locales),
-  getVersions: () => settings.versions,
-  getDocTags: () => settings.docTags,
-  docsUrl,
-  versionedDocsUrl,
-  withBase,
-  loadDocs,
-  isDefaultLocaleOnlyPath,
-  // The factory describes collectTags / buildNavTree with the package's minimal
-  // structural slots (DocsEntryForTags / DocPageEntry / Map<string, unknown> /
-  // TagInfoForEnum). The host helpers are typed against the concrete project
-  // types (DocsEntry / NavNode / the Locale union / TagInfo) but are runtime-
-  // identical, so the stub adapts them with thin casting wrappers at the
-  // injection boundary where the host owns the type knowledge.
-  collectTags: (docs: DocsEntryForTags[], slugFn): Map<string, TagInfoForEnum> =>
-    collectTags(docs as unknown as DocsEntry[], slugFn),
-  toRouteSlug,
-  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[],
-  collectAutoIndexNodes,
-  resolveNavSource,
-  resolveVersionedLocaleSource,
-  mergeLocaleDocs,
-});