create-zudo-doc 0.2.22 → 1.0.0

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

@@ -1,63 +1,4 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// MathBlock — server-rendered KaTeX component for MDX math expressions.
-//
-// Registered in pages/_mdx-components.ts as `MathBlock` so the MDX corpus
-// can reference it as <MathBlock latex="…" block />.
-//
-// Used by the math-equations.mdx content files (both EN and JA) which write
-// `<MathBlock>` JSX directly instead of `$$…$$` fences. The explicit JSX
-// form is required because the zfb Rust MDX→JSX emitter does not understand
-// remark-math `$$…$$` syntax — LaTeX identifiers like `\infty` become invalid
-// JSX expressions `{\infty}` that esbuild rejects (zudo-front-builder #93).
-// Using `<MathBlock>` directly keeps the LaTeX inside a string attribute,
-// which esbuild accepts cleanly.
-//
-// Rendering: katex.renderToString() is called at SSR time — no client JS.
-// `throwOnError: false` keeps a broken formula visible as an error span
-// rather than crashing the page.
-
-import katex from "katex";
-import type { VNode } from "preact";
-
-interface MathBlockProps {
-  /** Raw LaTeX source string. */
-  latex: string;
-  /** When true, renders as a block (display) equation; otherwise inline. */
-  block?: boolean;
-}
-
-/**
- * Server-rendered KaTeX math component.
- *
- * Block mode wraps the output in `<div class="math math-display">`;
- * inline mode uses `<span class="math math-inline">`. The class names
- * match the standard rehype-katex output so existing CSS (e.g. the
- * KaTeX stylesheet) still applies.
- */
-export function MathBlock({ latex, block = false }: MathBlockProps): VNode {
-  const html = katex.renderToString(latex, {
-    displayMode: block,
-    // Never throw — malformed LaTeX renders a visible error span instead
-    // of crashing the entire page build.
-    throwOnError: false,
-  });
-
-  if (block) {
-    return (
-      <div
-        class="math math-display"
-        // eslint-disable-next-line react/no-danger
-        dangerouslySetInnerHTML={{ __html: html }}
-      />
-    );
-  }
-
-  return (
-    <span
-      class="math math-inline"
-      // eslint-disable-next-line react/no-danger
-      dangerouslySetInnerHTML={{ __html: html }}
-    />
-  );
-}
+// 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/src/components/content/code-group.tsx

@@ -1,76 +1,3 @@
-import { Tabs } from "@takazudo/zudo-doc/code-syntax";
-import { TabItem } from "@takazudo/zudo-doc/tab-item";
-
-/**
- * Adapter for zfb's `:::code-group` directive (codeTabs Option A).
- *
- * zfb emits:
- *   <CodeGroup tabs={["label1", "label2", ...]}>
- *     <pre data-lang="ts">{RAW code text}</pre>
- *     <pre data-lang="js">{RAW code text}</pre>
- *   </CodeGroup>
- *
- * The existing <Tabs>/<TabItem> UI uses a children-based API, so this
- * component zips the `tabs` label array with the `<pre data-lang>` children
- * by index, wrapping each in a <TabItem> with the matching label.
- *
- * Code inside each <pre> is raw text (NOT syntect-highlighted — the Rust
- * pipeline does not run highlight inside code-group fences). We render
- * the <pre> inside a <TabItem> with explicit styling via Tailwind tokens
- * so it looks like a code block visually.
- *
- * TabsInit (the companion init script) is present in the layout
- * (packages/zudo-doc/src/doclayout/doc-layout-with-defaults.tsx line 433)
- * — we rely on it being there; no duplicate needed here.
- */
-
-type Props = {
-  tabs?: string[];
-  children?: React.ReactNode;
-  [key: string]: unknown;
-};
-
-function toArray(children: React.ReactNode): React.ReactNode[] {
-  if (!children) return [];
-  if (Array.isArray(children)) return children;
-  return [children];
-}
-
-export function CodeGroup({ tabs = [], children, name }: Props) {
-  const childArray = toArray(children);
-
-  // Zip tabs labels with pre children by index. Extra children beyond the
-  // tabs array (shouldn't happen in normal zfb output) are ignored.
-  const items = tabs.map((label, i) => {
-    const child = childArray[i];
-    return { label, child };
-  });
-
-  if (items.length === 0) {
-    // Degenerate: no tabs — render children as-is.
-    return <>{children}</>;
-  }
-
-  // zfb forwards `:::code-group{name="x"}` as the `name` prop; Tabs persists
-  // the active tab per group via `groupId`.
-  const groupId = typeof name === "string" ? name : undefined;
-
-  return (
-    <Tabs groupId={groupId}>
-      {items.map(({ label, child }, i) => (
-        // value is suffixed with the index so two fences sharing a label
-        // (e.g. both titled "ts") get distinct stable tab identities; the
-        // label stays the visible text.
-        <TabItem
-          key={`${label}-${i}`}
-          label={label}
-          value={`${label}-${i}`}
-          default={i === 0 ? true : undefined}
-        >
-          {/* Raw-code <pre> from zfb: apply code-block visual treatment via tokens */}
-          <div class="code-group-panel">{child}</div>
-        </TabItem>
-      ))}
-    </Tabs>
-  );
-}
+// Re-export from the shared package — moved to @takazudo/zudo-doc/code-group
+// as part of the package-first migration (epic #2321, S4 #2327).
+export { CodeGroup } from "@takazudo/zudo-doc/code-group";

package/templates/base/src/components/content/content-admonition.tsx

@@ -1,56 +1,4 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Real Preact bindings for the admonition MDX tags (Note/Tip/Info/Warning/
-// Danger/Caution/Important). Replaces the former literal-VNode
-// `makeAdmonitionStub` in pages/_mdx-components.ts with a proper typed
-// component — restoring the first-class admonition components the Astro-era
-// theme shipped (zudolab/zudo-doc#1456), now on the zfb pipeline.
-//
-// These tags arrive from two zfb features: the `directives` map emits them from
-// `:::note` directives, and `githubAlerts` emits Important/Caution from
-// `[!IMPORTANT]`/`[!CAUTION]` blockquotes. The JSX form `<Note title="…">` is
-// also authored directly in MDX. All three paths render through here.
-//
-// Markup contract — KEEP STABLE. The structure below
-//   <div data-admonition="<variant>" class="admonition admonition-<variant>">
-//     <p class="admonition-title">…</p>
-//     <div class="admonition-body">…</div>
-//   </div>
-// is the hook both the design-system CSS (`.admonition-<variant>` rules in
-// src/styles/global.css) and the e2e smoke spec (e2e/smoke-admonitions.spec.ts)
-// target. The per-variant color + icon live in CSS keyed off `data-admonition`,
-// so this component stays presentation-agnostic.
-import type { ComponentChildren, VNode } from "preact";
-
-export type AdmonitionVariant =
-  | "note"
-  | "tip"
-  | "info"
-  | "warning"
-  | "danger"
-  | "caution"
-  | "important";
-
-export interface AdmonitionProps {
-  /** Custom title; falls back to the capitalized variant name (e.g. "Note"). */
-  title?: string;
-  children?: ComponentChildren;
-}
-
-/**
- * Build the admonition component for a single variant. The title row is always
- * rendered — defaulting to the capitalized variant name when the author gives
- * no `title` — matching the Astro reference where every callout shows a title.
- */
-export function makeAdmonition(variant: AdmonitionVariant) {
-  const defaultTitle = variant.charAt(0).toUpperCase() + variant.slice(1);
-  return function Admonition({ title, children }: AdmonitionProps): VNode {
-    const heading = title && title.length > 0 ? title : defaultTitle;
-    return (
-      <div data-admonition={variant} class={`admonition admonition-${variant}`}>
-        <p class="admonition-title">{heading}</p>
-        <div class="admonition-body">{children}</div>
-      </div>
-    );
-  };
-}
+// Re-export from the shared package — moved to @takazudo/zudo-doc/content-admonition
+// as part of the package-first migration (epic #2321, S4 #2327).
+export type { AdmonitionVariant, AdmonitionProps } from "@takazudo/zudo-doc/content-admonition";
+export { makeAdmonition } from "@takazudo/zudo-doc/content-admonition";

package/templates/base/src/config/settings-types.ts

@@ -1,181 +1,43 @@
-export interface HeaderNavChildItem {
-  label: string;
-  labelKey?: string;
-  path: string;
-  categoryMatch?: string;
-}
-
-export interface HeaderNavItem extends HeaderNavChildItem {
-  children?: HeaderNavChildItem[];
-}
-
-export type HeaderRightComponentName =
-  | "theme-toggle"
-  | "language-switcher"
-  | "version-switcher"
-  | "github-link"
-  | "search";
+// Re-export most types from the shared package — moved to @takazudo/zudo-doc/settings
+// as part of the package-first migration (epic #2321, S4 #2327).
+// HeaderRightTriggerName and HeaderRightTriggerItem are defined locally rather than
+// re-exported from the package because the designTokenPanel feature injects its
+// extra trigger-name variant into HeaderRightTriggerName via the @slot anchor; the
+// package unconditionally includes both trigger names but the base template
+// ships only "ai-chat", and the feature overlay adds the panel trigger variant
+// via the compose engine.  HeaderRightTriggerItem references the local
+// HeaderRightTriggerName, so it stays local too.
+export type {
+  TagGovernanceMode,
+  TagVocabularyEntry,
+  HeaderNavChildItem,
+  HeaderNavItem,
+  HeaderRightComponentName,
+  HeaderRightComponentItem,
+  HeaderRightLinkItem,
+  HeaderRightHtmlItem,
+  HeaderRightItem,
+  BodyFootUtilAreaConfig,
+  ColorModeConfig,
+  LocaleConfig,
+  FooterLinkItem,
+  FooterLinkColumn,
+  FooterTaglistLocaleConfig,
+  FooterTaglistConfig,
+  FooterConfig,
+  HtmlPreviewConfig,
+  FrontmatterPreviewConfig,
+  TagPlacement,
+  VersionConfig,
+  MetaTagsConfig,
+  Settings,
+} from "@takazudo/zudo-doc/settings";
 
 // @slot:settings-types:trigger-names:start
 export type HeaderRightTriggerName = "ai-chat";
 // @slot:settings-types:trigger-names:end
 
-export interface HeaderRightComponentItem {
-  type: "component";
-  component: HeaderRightComponentName;
-}
-
 export interface HeaderRightTriggerItem {
   type: "trigger";
   trigger: HeaderRightTriggerName;
 }
-
-export interface HeaderRightLinkItem {
-  type: "link";
-  href: string;
-  label?: string;
-  ariaLabel?: string;
-  icon?: "github";
-}
-
-export interface HeaderRightHtmlItem {
-  type: "html";
-  html: string;
-}
-
-export type HeaderRightItem =
-  | HeaderRightComponentItem
-  | HeaderRightTriggerItem
-  | HeaderRightLinkItem
-  | HeaderRightHtmlItem;
-
-export interface BodyFootUtilAreaConfig {
-  docHistory?: boolean;
-  viewSourceLink?: boolean;
-}
-
-export interface ColorModeConfig {
-  defaultMode: "light" | "dark";
-  lightScheme: string;
-  darkScheme: string;
-  respectPrefersColorScheme: boolean;
-}
-
-export interface LocaleConfig {
-  label: string;
-  dir: string;
-}
-
-export interface FooterLinkItem {
-  label: string;
-  href: string;
-  locales?: Record<string, { label: string }>;
-}
-
-export interface FooterLinkColumn {
-  title: string;
-  items: FooterLinkItem[];
-  locales?: Record<string, { title: string }>;
-}
-
-/**
- * Per-locale overrides for the footer taglist labels.
- *
- * `title`        — overrides `taglist.title` on this locale.
- * `groupTitles`  — per-group title overrides keyed by vocabulary `group`.
- */
-export interface FooterTaglistLocaleConfig {
-  title?: string;
-  groupTitles?: Record<string, string>;
-}
-
-/**
- * Opt-in footer tag index.
- *
- * Renders one or more columns of tag links inside the existing footer grid.
- * Off by default: when `enabled: false` (or the field is omitted entirely),
- * the footer renders unchanged.
- *
- * - `groupBy: "group"` — one column per vocabulary `group`, in the order the
- *   groups first appear in `tag-vocabulary.ts`. Each column's title comes from
- *   `groupTitles[group]`, falling back to a capitalised version of the group
- *   name.
- * - `groupBy: "flat"` — a single column titled `title` listing every tag
- *   alphabetically. This is also the fallback used when the vocabulary is
- *   inactive (`tagVocabulary: false` or `tagGovernance: "off"`).
- */
-export interface FooterTaglistConfig {
-  enabled: boolean;
-  /** Column title used in flat mode (and as fallback for ungrouped tags). */
-  title?: string;
-  /** Default `"group"` when the vocabulary is active, otherwise forced to `"flat"`. */
-  groupBy?: "group" | "flat";
-  /** English (default-locale) group titles, e.g. `{ type: "By type" }`. */
-  groupTitles?: Record<string, string>;
-  /** Locale-specific overrides for `title` and `groupTitles`. */
-  locales?: Record<string, FooterTaglistLocaleConfig>;
-}
-
-export interface FooterConfig {
-  links: FooterLinkColumn[];
-  /** Copyright text displayed at the bottom of the footer. HTML is supported. */
-  copyright?: string;
-  /** Opt-in footer tag index. Off by default. */
-  taglist?: FooterTaglistConfig;
-}
-
-export interface HtmlPreviewConfig {
-  /** Raw HTML injected into <head> (links, meta, fonts) */
-  head?: string;
-  /** CSS injected as <style> after preflight */
-  css?: string;
-  /** JS injected as <script> before </body> */
-  js?: string;
-}
-
-export interface FrontmatterPreviewConfig {
-  /**
-   * Completely replaces the default ignore list.
-   * When set, `extraIgnoreKeys` is ignored.
-   */
-  ignoreKeys?: string[];
-  /**
-   * Additional keys to ignore on top of the defaults.
-   * Has no effect when `ignoreKeys` is also set.
-   */
-  extraIgnoreKeys?: string[];
-}
-
-export type TagPlacement = "after-title" | "before-pager";
-
-export type { TagGovernanceMode, TagVocabularyEntry } from "./tag-vocabulary-types";
-
-export interface VersionConfig {
-  /** Version identifier, used in URL path (e.g., "1.0", "v1") */
-  slug: string;
-  /** Display label (e.g., "1.0.0", "Version 1") */
-  label: string;
-  /** Content directory for this version's English docs */
-  docsDir: string;
-  /** Per-locale content directories for this version */
-  locales?: Record<string, { dir: string }>;
-  /** Banner text shown on versioned pages (e.g., "unmaintained", "unreleased") */
-  banner?: "unmaintained" | "unreleased" | false;
-}
-
-export interface MetaTagsConfig {
-  /** Emit <meta name="description">. Default true. */
-  description: boolean;
-  /** Emit <meta name="keywords"> with a comma-separated string. false = omit. Default false. */
-  keywords: string | false;
-  /** og:image (and twitter:image) path. false = omit. Default false. Showcase: '/img/ogp.png'. */
-  ogImage: string | false;
-  /** Emit og:site_name. Default true (preserves current og:site_name). */
-  ogSiteName: boolean;
-  /** TwitterCard type. false = omit entire twitter:card block. Default false. Showcase: 'summary_large_image'. */
-  twitterCard: "summary" | "summary_large_image" | false;
-  /** twitter:site handle (e.g. '@yourbrand'). Optional. */
-  twitterSite?: string;
-  /** twitter:creator handle. Optional. */
-  twitterCreator?: string;
-}

package/templates/base/src/styles/global.css

@@ -89,6 +89,27 @@
  * ======================================== */
 
 @theme {
+  /* ========================================
+   * Project tight-token color reset
+   *
+   * Wipes all Tailwind default color tokens (`--color-*`) so only
+   * project-defined palette and semantic tokens remain. This enforces the
+   * tight-token policy: "NEVER use Tailwind default colors" (per Color Rules
+   * in src/CLAUDE.md). Project color tokens (defined below) are added back
+   * after this reset.
+   *
+   * The upstream split-import fix (zfb#159 / 9e37551, shipped in f68a9ba)
+   * eliminated the original leak cause (zfb no longer prepends the full
+   * @import "tailwindcss" bundle). The reset is retained as an explicit
+   * design guardrail — it prevents accidental default palette bleed from any
+   * future upstream change and keeps the project's color surface intentional.
+   *
+   * NOT reset: `--spacing` (the base spacing scale, default 0.25rem).
+   * Tailwind spacing utilities compute as calc(var(--spacing) * N); wiping
+   * `--spacing` collapses them to zero (observed in Wave 4 Sub-7 #1403).
+   * ======================================== */
+  --color-*: initial;
+
   /* ========================================
    * Colors — Three-tier token system
    * ======================================== */
@@ -130,13 +151,19 @@
   --color-info: var(--zd-info);
   /* Overlay is intentionally theme-independent (always dark, not scheme-driven) */
   --color-overlay: #000;
+  /* The page-loading overlay scrim token is feature-gated: the dynamicPageTransition
+     feature injects it into @slot:global-css:theme-tokens when enabled, so it is
+     intentionally absent from this base @theme block (the host showcase global.css
+     carries it inline only because the host is fully featured). Do not re-add it here. */
   --color-image-overlay-bg: var(--zd-image-overlay-bg);
   --color-image-overlay-fg: var(--zd-image-overlay-fg);
-  --color-mermaid-node-bg: var(--zd-mermaid-node-bg);
-  --color-mermaid-text: var(--zd-mermaid-text);
-  --color-mermaid-line: var(--zd-mermaid-line);
-  --color-mermaid-label-bg: var(--zd-mermaid-label-bg);
-  --color-mermaid-note-bg: var(--zd-mermaid-note-bg);
+  /* --color-mermaid-* aliases removed: mermaid-init-script.ts reads --zd-mermaid-* directly;
+     these @theme registrations were unused (no Tailwind utility references). --zd-mermaid-*
+     injection in color-scheme-utils.ts is preserved and remains the live source. */
+  --color-chat-user-bg: var(--zd-chat-user-bg);
+  --color-chat-user-text: var(--zd-chat-user-text);
+  --color-chat-assistant-bg: var(--zd-chat-assistant-bg);
+  --color-chat-assistant-text: var(--zd-chat-assistant-text);
   --color-matched-keyword-bg: var(--zd-matched-keyword-bg);
   --color-matched-keyword-fg: var(--zd-matched-keyword-fg);
   /* @slot:global-css:theme-tokens */
@@ -196,7 +223,7 @@
   --text-caption:    var(--text-scale-xs);   /* labels, timestamps */
   --text-small:      var(--text-scale-sm);   /* secondary text, nav items */
   --text-body:       var(--text-scale-md);   /* paragraphs, default */
-  --text-title: var(--text-scale-lg);   /* card titles, section labels */
+  --text-title:      var(--text-scale-lg);   /* card titles, section labels */
   --text-heading:    var(--text-scale-xl);   /* page headings */
   --text-display:    var(--text-scale-2xl);  /* hero text */
 
@@ -263,7 +290,7 @@
   /* GENERATED:Z_INDEX_END */
 
 :root {
-  /* Default responsive range; sidebar-resizer.ts allows 192–448px for explicit resizing */
+  /* Default responsive range; sidebar-resizer.ts allows 192–448px for explicit resizing. */
   --zd-sidebar-w: clamp(14rem, 20vw, 22rem);
 
   /* ── Tier 1: Abstract font-size scale (raw values — NOT for direct component use) ── */
@@ -276,7 +303,7 @@
   --text-scale-xl:  3rem;       /* 48px */
   --text-scale-2xl: 3.75rem;    /* 60px */
 
-  --default-transition-duration: 150ms; /* consumed by hash-link opacity fade */
+  --default-transition-duration: 150ms; /* consumed by image-enlarge and hash-link opacity fade */
   --zd-transition-slow: 200ms;          /* sidebar transform/visibility and content-band max-width */
   --zd-transition-slower: 300ms;        /* view-transition fade-in (contentFadeIn animation) */
   --zd-header-h: 80px;                  /* sticky header height; consumed by scroll-margin-top on [id] anchors */

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

@@ -30,7 +30,7 @@ import { DocLayoutWithDefaults } from "@takazudo/zudo-doc/doclayout";
 import type { JSX } from "preact";
 import type { VNode } from "preact";
 import { Island } from "@takazudo/zfb";
-import SiteTreeNav from "@/components/site-tree-nav";
+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";

package/templates/base/pages/404.tsx

@@ -1,61 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Page module for the 404 route.
-//
-// The 404 page is a static route with no dynamic params. zfb emits it as
-// dist/404.html so the host platform (Cloudflare Pages, Netlify, etc.) can
-// serve it for unmatched requests. No paths() export needed.
-//
-// The original Astro page rendered the full html/head/body inline without
-// DocLayout because the 404 page intentionally has no sidebar/TOC/header.
-// This port wraps via DocLayoutWithDefaults with hideSidebar/hideToc plus
-// a noindex meta so search engines do not index it.
-
-import { defaultLocale } from "@/config/i18n";
-import { settings } from "@/config/settings";
-import { withBase } from "@/utils/base";
-import { DocLayoutWithDefaults } from "@takazudo/zudo-doc/doclayout";
-import type { JSX } from "preact";
-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 { BodyEndIslands } from "./lib/_body-end-islands";
-
-export const frontmatter = { title: "404" };
-
-export default function NotFoundPage(): JSX.Element {
-  const locale = defaultLocale;
-  const title = "Page Not Found";
-
-  return (
-    <DocLayoutWithDefaults
-      title={composeMetaTitle(title)}
-      head={<HeadWithDefaults title={title} />}
-      lang={locale}
-      noindex={true}
-      hideSidebar={true}
-      hideToc={true}
-      // Empty fragment suppresses DocLayoutWithDefaults' empty-data default
-      // Sidebar island — its marker never hydrates for published-package
-      // consumers (zfb#999) and zfb >= next.38 warns about it; the sidebar is
-      // hidden on this page anyway (zudolab/zudo-doc#2057).
-      sidebarOverride={<></>}
-      headerOverride={<HeaderWithDefaults lang={locale} />}
-      footerOverride={<FooterWithDefaults lang={locale} />}
-      bodyEndComponents={<BodyEndIslands basePath={settings.base ?? "/"} />}
-      enableClientRouter={settings.dynamicPageTransition}
-    >
-      <div class="min-h-[60vh] flex flex-col items-center justify-center px-hsp-2xl py-vsp-xl">
-        <h1 class="text-display font-bold mb-vsp-md">404</h1>
-        <p class="text-title text-muted mb-vsp-xl">Page not found.</p>
-        <a
-          href={withBase("/")}
-          class="bg-accent px-hsp-lg py-vsp-xs font-medium text-bg hover:bg-accent-hover"
-        >
-          Back to Home
-        </a>
-      </div>
-    </DocLayoutWithDefaults>
-  );
-}

package/templates/base/pages/robots.txt.tsx

@@ -1,5 +0,0 @@
-import { renderRobots } from "@takazudo/zudo-doc/robots";
-import { settings } from "@/config/settings";
-
-export const contentType = "text/plain";
-export default () => renderRobots(settings);

package/templates/base/pages/sitemap.xml.tsx

@@ -1,59 +0,0 @@
-// Port of `src/integrations/sitemap.ts` onto zfb's pages-style filename
-// convention.
-//
-// Filename → output extension mapping (zfb convention): the
-// second-to-last `.`-separated segment of the stem becomes the output
-// extension, so `sitemap.xml.tsx` builds `dist/sitemap.xml`. The
-// explicit `contentType` export pins the dev-server `Content-Type`
-// header to `application/xml` regardless of the filename hint.
-//
-// URL enumeration is delegated to `pages/lib/route-enumerators.ts` so
-// the sitemap cannot drift from the actual routes the page modules build.
-// Previously the sitemap walked raw collection slugs directly and missed:
-//   (a) tag pages           (b) JA fallback URLs
-//   (c) versioned JA routes (d) wrong URL pattern for versioned-locale pages
-//   (e) emitted /index/ suffix on category pages (closes #690)
-
-import { settings } from "@/config/settings";
-import { enumerateAllRoutes } from "./lib/route-enumerators";
-
-export const frontmatter = { title: "Sitemap" };
-export const contentType = "application/xml";
-
-function escapeXml(str: string): string {
-  return str
-    .replace(/&/g, "&")
-    .replace(/</g, "&lt;")
-    .replace(/>/g, "&gt;")
-    .replace(/"/g, "&quot;")
-    .replace(/'/g, "&apos;");
-}
-
-export default function Sitemap(): string {
-  // When sitemap is disabled, return an empty urlset so the route still
-  // resolves (returns XML, not 404) but contains no URLs.
-  if (!settings.sitemap) {
-    return `<?xml version="1.0" encoding="UTF-8"?>
-<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
-</urlset>`;
-  }
-
-  const routeMap = enumerateAllRoutes();
-  const siteUrlBase = (settings.siteUrl ?? "").replace(/\/$/, "");
-
-  const urlEntries = [...routeMap.entries()]
-    .sort(([a], [b]) => a.localeCompare(b))
-    .map(
-      ([url, lastmod]) => `  <url>
-    <loc>${escapeXml(siteUrlBase + url)}</loc>
-    <lastmod>${lastmod}</lastmod>
-  </url>`,
-    )
-    .join("\n");
-
-  return `<?xml version="1.0" encoding="UTF-8"?>
-<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
-${urlEntries}
-</urlset>
-`;
-}