create-zudo-doc 3.1.0 → 3.3.0

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

@@ -1,32 +0,0 @@
-// 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.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/pages/lib/_search-widget.tsx

@@ -1,17 +0,0 @@
-/** @jsxRuntime automatic */
-/** @jsxImportSource preact */
-// Host thin-stub — see @takazudo/zudo-doc/search-widget (epic #2344, S5).
-// Injects the host's base path and re-exports the package SearchWidget.
-import type { JSX } from "preact";
-import {
-  SearchWidget as PackageSearchWidget,
-  type SearchWidgetProps as PackageSearchWidgetProps,
-} from "@takazudo/zudo-doc/search-widget";
-import { withBase } from "@/utils/base";
-
-export type SearchWidgetProps = Omit<PackageSearchWidgetProps, "base">;
-
-/** Locale-aware search widget — thin host stub that injects the base path. */
-export function SearchWidget(props: SearchWidgetProps): JSX.Element {
-  return <PackageSearchWidget {...props} base={withBase("/")} />;
-}

package/templates/base/pages/lib/doc-page-props.ts

@@ -1,30 +0,0 @@
-// Thin stub — types moved to the package (epic #2344, S6).
-// Re-exports the shared discriminated-union props types for all 4 doc-route
-// pages from @takazudo/zudo-doc/doc-page-props.
-//
-// S5 and downstream (S7) consumers import `DocPageBaseProps`, `DocPageEntry`,
-// `AutoIndexNode`, `DocPageEntryProps`, `DocPageAutoIndexProps` from this path
-// unchanged — all are re-exported below.
-
-export type {
-  DocNavNode,
-  DocPageEntry,
-  DocPageFrontmatter,
-  AutoIndexNode,
-  DocPageEntryProps,
-  DocPageAutoIndexProps,
-  DocPageBaseProps,
-  HeadingItem,
-} from "@takazudo/zudo-doc/doc-page-props";
-
-// Backward-compatible alias: downstream callers that import `NavNode` from
-// this path (e.g. _doc-route-entries.ts, route-enumerators.ts) continue to
-// resolve. `DocNavNode` is structurally identical to the host's `NavNode` from
-// src/utils/docs.ts (same required fields, same optional fields).
-export type { DocNavNode as NavNode } from "@takazudo/zudo-doc/doc-page-props";
-
-// Backward-compatible alias: `BreadcrumbItem` was previously imported from
-// @/utils/docs in some files. The package's `DocPageBaseProps` uses
-// `BreadcrumbItem` from @takazudo/zudo-doc/breadcrumb/types — re-export it
-// here so callers importing from this path still resolve.
-export type { BreadcrumbItem } from "@takazudo/zudo-doc/breadcrumb";

package/templates/base/pages/lib/locale-merge.ts

@@ -1,59 +0,0 @@
-// Thin stub — locale-merge moved to the package (epic #2344, S6).
-// Re-exports the pure merge functions from @takazudo/zudo-doc/locale-merge
-// and provides backward-compatible wrappers that inject the host singletons.
-//
-// `mergeLocaleDocs` is the main export: now the package function accepts an
-// optional `isDefaultLocaleOnlyPath` injection in its options object. The host
-// wrapper below injects the host's `isDefaultLocaleOnlyPath` automatically
-// so all existing call sites — which pass `applyDefaultLocaleOnlyFilter: true`
-// without explicitly passing the predicate — continue to work unchanged.
-//
-// `mergeCategoryMeta` is kept as a host-only helper (it wraps `loadCategoryMeta`
-// from @/utils/docs which is a host import). The package's `nav-source-docs`
-// factory now owns the merged-category-meta caching; this re-export is kept
-// for any remaining host call sites.
-
-export type {
-  MergeDocsEntry,
-  MergeLocaleDocsOptions,
-  MergeLocaleDocsResult,
-} from "@takazudo/zudo-doc/locale-merge";
-import { mergeLocaleDocs as _mergeLocaleDocs } from "@takazudo/zudo-doc/locale-merge";
-import type { MergeLocaleDocsOptions, MergeLocaleDocsResult, MergeDocsEntry } from "@takazudo/zudo-doc/locale-merge";
-import { isDefaultLocaleOnlyPath } from "@/utils/base";
-import { loadCategoryMeta } from "@/utils/docs";
-import type { CategoryMeta } from "@/utils/docs";
-
-/**
- * Merge locale docs with base-locale fallbacks.
- *
- * Thin host wrapper around the package's `mergeLocaleDocs` that injects
- * `isDefaultLocaleOnlyPath` from `@/utils/base` automatically. Existing call
- * sites that pass `applyDefaultLocaleOnlyFilter: true` continue to work
- * without change — the predicate is now injected rather than module-imported.
- */
-export function mergeLocaleDocs<T extends MergeDocsEntry = MergeDocsEntry>(
-  options: Omit<MergeLocaleDocsOptions<T>, "isDefaultLocaleOnlyPath">,
-): MergeLocaleDocsResult<T> {
-  return _mergeLocaleDocs({
-    ...options,
-    isDefaultLocaleOnlyPath,
-  });
-}
-
-/**
- * Merge category metadata for a locale: base metadata first, locale overrides
- * win on overlapping keys.
- *
- * This matches the category-meta merge order used in route enumerators,
- * nav helpers, and page paths() sections.
- */
-export function mergeCategoryMeta(
-  baseDir: string,
-  localeDir: string,
-): Map<string, CategoryMeta> {
-  return new Map<string, CategoryMeta>([
-    ...loadCategoryMeta(baseDir),
-    ...loadCategoryMeta(localeDir),
-  ]);
-}

package/templates/base/scripts/run-b4push.sh

@@ -1,102 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-# b4push — local quality gate run before pushing.
-#
-# Step order (cheap → expensive):
-#   1. Type checking (zfb check)
-#   2. Build (zfb build)
-#   3. HTML validation (html-validate dist/**/*.html)
-#   4. Manual interactive smoke (operator-driven)
-#
-# Env overrides for non-interactive use:
-#   B4PUSH_SKIP_HTML_VALIDATE=1  — skip HTML validation (step 3)
-#   B4PUSH_SKIP_MANUAL_SMOKE=1   — skip the manual interactive smoke
-
-START_TIME=$(date +%s)
-FAILURES=()
-TOTAL_STEPS=4
-CURRENT_STEP=0
-
-step() {
-  CURRENT_STEP=$((CURRENT_STEP + 1))
-  echo ""
-  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-  echo "▶ Step $CURRENT_STEP/$TOTAL_STEPS: $1"
-  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-}
-
-pass() { echo "✅ $1"; }
-fail() { echo "❌ $1"; FAILURES+=("$1"); }
-skip() { echo "⏭  $1 (skipped)"; }
-
-ROOT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
-
-# ── Step 1: Type checking ─────────────────────────────
-step "Type checking (zfb check)"
-if (cd "$ROOT_DIR" && pnpm check); then
-  pass "Type checking passed"
-else
-  fail "Type checking"
-fi
-
-# ── Step 2: Build ─────────────────────────────────────
-step "Build (zfb build)"
-if (cd "$ROOT_DIR" && pnpm build); then
-  pass "Build passed"
-else
-  fail "Build"
-fi
-
-# ── Step 3: HTML validation ───────────────────────────
-step "HTML validation (html-validate)"
-if [[ "${B4PUSH_SKIP_HTML_VALIDATE:-}" == "1" ]]; then
-  skip "HTML validation (B4PUSH_SKIP_HTML_VALIDATE=1)"
-else
-  if (cd "$ROOT_DIR" && pnpm check:html); then
-    pass "HTML validation passed"
-  else
-    fail "HTML validation"
-  fi
-fi
-
-# ── Step 4: Manual interactive smoke ─────────────────
-step "Manual interactive smoke"
-if [[ "${B4PUSH_SKIP_MANUAL_SMOKE:-}" == "1" ]]; then
-  skip "Manual smoke (B4PUSH_SKIP_MANUAL_SMOKE=1)"
-else
-  cat <<'MANUAL'
-Run `pnpm preview` in another terminal and exercise:
-  • theme toggle (light/dark)
-  • mobile menu (narrow viewport)
-  • search dropdown (header search)
-  • code-block syntax highlighting
-
-Press [Enter] when all flows look healthy, or Ctrl-C to abort.
-MANUAL
-  if read -r _; then
-    pass "Manual smoke acknowledged"
-  else
-    fail "Manual smoke (aborted)"
-  fi
-fi
-
-# ── Summary ──────────────────────────────────────────
-END_TIME=$(date +%s)
-DURATION=$((END_TIME - START_TIME))
-
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "  SUMMARY (${DURATION}s)"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-
-if [ ${#FAILURES[@]} -eq 0 ]; then
-  echo "✅ All $TOTAL_STEPS checks passed (or skipped). Safe to push."
-  exit 0
-else
-  echo "❌ ${#FAILURES[@]} check(s) failed:"
-  for f in "${FAILURES[@]}"; do
-    echo "   - $f"
-  done
-  exit 1
-fi

package/templates/base/src/components/ai-chat-modal.tsx

@@ -1,18 +0,0 @@
-// W6A stub — no-op default + AiChatModal named exports.
-//
-// The AiChatModal island now ships from the package
-// (`@takazudo/zudo-doc/ai-chat-modal`); the unconditional
-// `pages/lib/_body-end-islands.tsx` imports it directly from there. This
-// stub exists only so any project-local code that references the
-// `@/components/ai-chat-modal` path still resolves — it renders nothing.
-// Replace this file to wire a project-specific modal.
-import type { JSX } from "preact";
-
-function AiChatModal(): JSX.Element | null {
-  return null;
-}
-AiChatModal.displayName = "AiChatModal";
-
-export default AiChatModal;
-
-export { AiChatModal };

package/templates/base/src/components/content/code-group.tsx

@@ -1,3 +0,0 @@
-// 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,4 +0,0 @@
-// 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/components/desktop-sidebar-toggle.tsx

@@ -1,15 +0,0 @@
-// W6A stub — no-op default export.
-//
-// When the sidebarToggle feature is enabled, the feature template
-// overwrites this file with the real desktop sidebar-toggle island.
-// Generated projects without the feature ship the no-op so the
-// unconditional `pages/lib/_body-end-islands` (or sidebar wrapper)
-// import resolves at typecheck time.
-import type { JSX } from "preact";
-
-function DesktopSidebarToggle(): JSX.Element | null {
-  return null;
-}
-DesktopSidebarToggle.displayName = "DesktopSidebarToggle";
-
-export default DesktopSidebarToggle;

package/templates/base/src/components/doc-history.tsx

@@ -1,21 +0,0 @@
-// W6A stub — no-op default + DocHistory named exports.
-//
-// The real DocHistory island now ships from the package
-// (`@takazudo/zudo-doc/doc-history`); the unconditional
-// `pages/lib/_doc-history-area.tsx` imports it directly from there. When
-// the docHistory feature is enabled the feature template overwrites this
-// file with a re-export shim pointing at the package island. Generated
-// projects without the feature ship this no-op so any project-local code
-// that references the `@/components/doc-history` path still resolves. The
-// host module exposes `DocHistory` as a named export, so the stub mirrors
-// both the default and named shapes to keep the import surface stable.
-import type { JSX } from "preact";
-
-function DocHistoryComponent(): JSX.Element | null {
-  return null;
-}
-DocHistoryComponent.displayName = "DocHistory";
-
-export default DocHistoryComponent;
-
-export const DocHistory = DocHistoryComponent;

package/templates/base/src/components/image-enlarge.tsx

@@ -1,24 +0,0 @@
-// W6A stub — no-op default + ImageEnlarge / ImageEnlargeSsrFallback exports.
-//
-// The real ImageEnlarge island and its SSR fallback now ship from the
-// package (`@takazudo/zudo-doc/image-enlarge`); the unconditional
-// `pages/lib/_body-end-islands.tsx` imports them directly from there. When
-// the imageEnlarge feature is enabled the feature template overwrites this
-// file with a re-export shim pointing at the package island. Generated
-// projects without the feature ship this no-op so any project-local code
-// that references the `@/components/image-enlarge` path still resolves (the
-// body-end renderer references both the default and the SSR fallback).
-import type { JSX } from "preact";
-
-function ImageEnlarge(): JSX.Element | null {
-  return null;
-}
-ImageEnlarge.displayName = "ImageEnlarge";
-
-export default ImageEnlarge;
-
-export { ImageEnlarge };
-
-export function ImageEnlargeSsrFallback(): JSX.Element | null {
-  return null;
-}

package/templates/base/src/components/preset-generator.tsx

@@ -1,14 +0,0 @@
-// W6A stub — no-op default export.
-//
-// The host (zudo-doc showcase) ships an interactive preset-generator
-// island used by its onboarding pages. Generated downstream projects
-// ship the no-op so unconditional page imports (`pages/lib/_preset-generator`)
-// resolve. Wire a real implementation by replacing this file.
-import type { JSX } from "preact";
-
-function PresetGenerator(): JSX.Element | null {
-  return null;
-}
-PresetGenerator.displayName = "PresetGenerator";
-
-export default PresetGenerator;

package/templates/base/src/components/sidebar-toggle.tsx

@@ -1,6 +0,0 @@
-// Thin re-export shim. SidebarToggle moved into the package
-// (`@takazudo/zudo-doc/sidebar-toggle-island`) as part of the package-first
-// migration (#2344, S2). Host code using `@/components/sidebar-toggle`
-// still resolves correctly; the implementation lives in the package.
-export { SidebarToggle } from "@takazudo/zudo-doc/sidebar-toggle-island";
-export type { SidebarToggleProps } from "@takazudo/zudo-doc/sidebar-toggle-island";

package/templates/base/src/components/sidebar-tree.tsx

@@ -1,6 +0,0 @@
-// Thin re-export shim. SidebarTree moved into the package
-// (`@takazudo/zudo-doc/sidebar-tree-island`) as part of the package-first
-// migration (#2344, S2). Host code using `@/components/sidebar-tree`
-// still resolves correctly; the implementation lives in the package.
-export { SidebarTree } from "@takazudo/zudo-doc/sidebar-tree-island";
-export type { SidebarTreeProps } from "@takazudo/zudo-doc/sidebar-tree-island";

package/templates/base/src/config/color-scheme-utils.ts

@@ -1,69 +0,0 @@
-/**
- * Project-side color-scheme helpers.
- *
- * The MECHANISM (ramp→CSS injection logic) now lives in the package:
- * `@takazudo/zudo-doc/color-scheme-utils`. This file re-exports those
- * mechanism symbols and adds project-specific thin wrappers that read from
- * this project's `colorSchemes` map and `settings`. The DATA (ramp values,
- * scheme names) stays in `./color-schemes` and `./settings`.
- *
- * S9a package-first migration — zudolab/zudo-doc#2333.
- * Ramp-native rewrite — zudolab/zudo-doc#2585/#2586.
- */
-
-export {
-  type OKLCH,
-  type StateRole,
-  type SemanticKey,
-  type RampRef,
-  type Ramps,
-  type ModeMap,
-  type ColorScheme,
-  type CssEmitScope,
-  STATE_ROLES,
-  SEMANTIC_KEYS,
-  SEMANTIC_RAMP_DEFAULTS,
-  SEMANTIC_CSS_NAMES,
-  resolveRampRef,
-  resolveSemanticColors,
-  schemeToCssPairs,
-  generateCssCustomProperties as generateCssCustomPropertiesFromScheme,
-  generateLightDarkCssProperties as generateLightDarkCssPropertiesFromSchemes,
-} from "@takazudo/zudo-doc/color-scheme-utils";
-import {
-  generateCssCustomProperties as _generateCssCustomProperties,
-  generateLightDarkCssProperties as _generateLightDarkCssProperties,
-} from "@takazudo/zudo-doc/color-scheme-utils";
-
-import { colorSchemes } from "./color-schemes";
-import { settings } from "./settings";
-
-export const lightDarkPairings = [
-  { light: "Default Light", dark: "Default Dark", label: "Default" },
-];
-
-export function getActiveScheme() {
-  const scheme = colorSchemes[settings.colorScheme];
-  if (!scheme) {
-    throw new Error(`Unknown color scheme: "${settings.colorScheme}". Available: ${Object.keys(colorSchemes).join(", ")}`);
-  }
-  return scheme;
-}
-
-/** Generate `:root { --zd-* }` CSS for the project's active single scheme. */
-export function generateCssCustomProperties(): string {
-  return _generateCssCustomProperties(getActiveScheme());
-}
-
-/** Generate `:root { --zd-*: light-dark(…) }` CSS for the project's configured light/dark pair. */
-export function generateLightDarkCssProperties(): string {
-  if (!settings.colorMode) {
-    throw new Error("colorMode is not configured");
-  }
-  const { lightScheme, darkScheme } = settings.colorMode;
-  const light = colorSchemes[lightScheme];
-  const dark = colorSchemes[darkScheme];
-  if (!light) throw new Error(`Unknown light scheme: "${lightScheme}"`);
-  if (!dark) throw new Error(`Unknown dark scheme: "${darkScheme}"`);
-  return _generateLightDarkCssProperties(light, dark);
-}

package/templates/base/src/config/color-schemes.ts

@@ -1,165 +0,0 @@
-/**
- * Ramp-native color schemes (Color Ramp Restructure — zudolab/zudo-doc#2584;
- * minimize pass #2601 / #2602).
- *
- * A `ColorScheme` is `{ ramps, map }` (the MECHANISM types live in the package
- * and are re-exported by `./color-scheme-utils`):
- *   - `ramps` — the shared Tier-1 source of truth: a warm-neutral `base` ramp
- *     (5 stops, index 0 = lightest), an `accent` ramp (3 stops), and 4 `state`
- *     colors. Light and dark modes SHARE these values.
- *   - `map` — the per-mode Tier-2 wiring: which ramp stop (or literal OKLCH)
- *     each UI role points at.
- *
- * The palette was minimized from base=12 / accent=7 to **base=5 / accent=3**
- * (#2602): the ramp-native engine is length-agnostic, so this is a DATA change.
- * Semantic roles are aggressively merged onto shared stops to keep the number of
- * distinct tones small — most notably `surface`, `codeBg`(light) and
- * `chatAssistantBg` collapse onto `bg`, so header Version boxes and doc cards
- * render as page-bg + border only (no gray fill). 5 stops leave no subtle
- * near-white, so light-mode elevated fills are border-only by design.
- *
- * `ColorScheme` is re-exported here so the many sites that still
- * `import { ColorScheme } from "./color-schemes"` (contrast tooling,
- * zfb.config.ts, …) keep resolving until their own waves port them.
- */
-
-import type { ColorScheme, Ramps, ModeMap } from "./color-scheme-utils";
-
-export type { ColorScheme } from "./color-scheme-utils";
-
-/**
- * Shared Tier-1 ramps — identical across Default Light and Default Dark.
- * Minimized to 5 base / 3 accent (#2602). The warm-neutral spine keeps hue 65;
- * the accent stops are the three tuned orange stops carried over from the 7-stop
- * ramp (old accent2/3/6, re-indexed). Index 0 = lightest.
- */
-const ramps: Ramps = {
-  base: [
-    "oklch(.965 .004 65)", // 0 — lightest (light bg / dark fg)
-    "oklch(.705 .008 65)", // 1 — dark muted / light selection & mermaid fill
-    "oklch(.480 .008 65)", // 2 — light muted / dark selection & mermaid note
-    "oklch(.300 .006 65)", // 3 — dark codeBg / mermaid fill
-    "oklch(.185 .005 65)", // 4 — darkest (dark bg / light fg)
-  ],
-  accent: [
-    "oklch(.755 .130 64)", // 0 — dark hover (was accent2)
-    "oklch(.700 .158 62)", // 1 — dark accent (was accent3)
-    "oklch(.470 .120 56)", // 2 — light accent (was accent6)
-  ],
-  state: {
-    danger: "oklch(.640 .170 25)",
-    success: "oklch(.680 .145 145)",
-    warning: "oklch(.760 .135 82)",
-    info: "oklch(.680 .130 245)",
-  },
-};
-
-/**
- * Default Dark — the authored reference scheme (epic #2584; minimized #2602).
- * bg = darkest base stop, fg = lightest. Roles merged onto shared stops:
- * `surface`, `chatAssistantBg`, `imageOverlayBg` all = `bg` (b4) so elevated
- * panels are bg + border only. Per-mode AA-tuned literals: `danger`,
- * `matchedKeyword*` (carried from #2593). Full WCAG matrix passes at
- * threshold+0.1.
- */
-const darkMap: ModeMap = {
-  bg: { base: 4 },
-  fg: { base: 0 },
-  selectionBg: { base: 2 },
-  selectionFg: { base: 0 },
-  semantic: {
-    // Merged onto bg (b4) — elevated panels read as page-bg + border, no gray fill.
-    surface: { base: 4 },
-    muted: { base: 1 },
-    accent: { accent: 1 },
-    accentHover: { accent: 0 },
-    codeBg: { base: 3 },
-    codeFg: { base: 0 },
-    success: { state: "success" },
-    // Per-mode AA-tuned literal — shared state.danger oklch(.640 .170 25) is too
-    // dark for the danger-admonition title on its 12%-tint dark bg. L .640→.655
-    // (H/C fixed) — admonition-danger at threshold+0.1; carried from #2593.
-    danger: "oklch(.655 .170 25)",
-    warning: { state: "warning" },
-    info: { state: "info" },
-    mermaidNodeBg: { base: 3 },
-    mermaidText: { base: 0 },
-    mermaidLine: { base: 1 },
-    mermaidLabelBg: { base: 3 },
-    mermaidNoteBg: { base: 2 },
-    chatUserBg: { accent: 1 },
-    chatUserText: { base: 4 },
-    // Merged onto bg (b4) — the chat assistant bubble reads as page-bg + border.
-    chatAssistantBg: { base: 4 },
-    chatAssistantText: { base: 0 },
-    imageOverlayBg: { base: 4 },
-    imageOverlayFg: { base: 0 },
-    // Search-result <mark> highlight: an amber (accent-hue) fill with dark text —
-    // the classic highlighter look, identical in both modes. Kept as literals so
-    // the amber fill is scheme-stable; matchedKeywordFg dark so text clears AA on
-    // the amber bg — matched-keyword at threshold+0.1; carried from #2593.
-    matchedKeywordBg: "oklch(.700 .158 62)",
-    matchedKeywordFg: "oklch(.300 .003 65)",
-  },
-};
-
-/**
- * Default Light — the authored light-mode scheme (epic #2584; minimized #2602).
- * Shares `ramps` with Default Dark; the `map` inverts (light bg = lightest base
- * stop, dark fg = darkest). Roles merged onto shared stops: `surface`, `codeBg`,
- * `chatAssistantBg` all = `bg` (b0) so elevated panels are bg + border only
- * (the intended flat, few-tone look — 5 stops leave no subtle near-white fill).
- * The accent/state colors — authored for a dark bg — need darker per-mode
- * literals to clear AA on a near-white bg. Full WCAG matrix passes at
- * threshold+0.1; ramps untouched so Default Dark is unaffected.
- */
-const lightMap: ModeMap = {
-  bg: { base: 0 },
-  fg: { base: 4 },
-  selectionBg: { base: 1 },
-  selectionFg: { base: 4 },
-  semantic: {
-    // Merged onto bg (b0) — elevated panels read as page-bg + border, no gray fill.
-    surface: { base: 0 },
-    muted: { base: 2 },
-    accent: { accent: 2 },
-    // Light: per-mode literal — the accent ramp has no stop darker than accent2,
-    // so the link-hover state darkens further (hover-darkens-on-light
-    // convention). L .400, C fitted to the sRGB gamut edge at that L; carried
-    // from #2595. accent-hover-vs-bg clears threshold+0.1.
-    accentHover: "oklch(.400 .096 56)",
-    // Merged onto bg (b0) — inline/code-block fill reads as page-bg + border.
-    codeBg: { base: 0 },
-    codeFg: { base: 4 },
-    // Light: per-mode literals — the shared state colors are authored for a dark
-    // bg and are too light on the 12%-tint admonition backgrounds over a light
-    // page bg. Each darkened (H fixed; C at gamut max, clipped where noted) to
-    // clear its admonition pair at threshold+0.1; carried from #2595.
-    success: "oklch(.470 .140 145)",
-    danger: "oklch(.505 .170 25)",
-    warning: "oklch(.490 .100 82)", // C .135→.100 (gamut-clips at this L)
-    info: "oklch(.485 .122 245)",
-    mermaidNodeBg: { base: 1 },
-    mermaidText: { base: 4 },
-    mermaidLine: { base: 2 },
-    mermaidLabelBg: { base: 1 },
-    mermaidNoteBg: { base: 1 },
-    chatUserBg: { accent: 1 },
-    // Dark text on the amber user bubble (matches Default Dark).
-    chatUserText: { base: 4 },
-    // Merged onto bg (b0) — the chat assistant bubble reads as page-bg + border.
-    chatAssistantBg: { base: 0 },
-    chatAssistantText: { base: 4 },
-    imageOverlayBg: { base: 4 },
-    imageOverlayFg: { base: 0 },
-    // Search-result <mark>: amber highlighter fill with dark text — same look as
-    // Default Dark (an amber-on-white highlight reads identically in both modes).
-    matchedKeywordBg: "oklch(.700 .158 62)",
-    matchedKeywordFg: "oklch(.300 .003 65)",
-  },
-};
-
-export const colorSchemes: Record<string, ColorScheme> = {
-  "Default Light": { ramps, map: lightMap },
-  "Default Dark": { ramps, map: darkMap },
-};