create-zudo-doc 3.2.0 → 3.3.0

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

package/templates/base/src/config/docs-schema.ts

@@ -1,95 +0,0 @@
-import { z } from "zod";
-import { settings } from "./settings";
-import { tagVocabulary } from "./tag-vocabulary";
-
-// ---------------------------------------------------------------------------
-// Tags schema builder — governance-aware.
-// ---------------------------------------------------------------------------
-
-/**
- * Build the `tags` schema based on governance mode. `"strict"` tightens to a
- * `z.enum` of every canonical id plus every alias (content still uses
- * aliases verbatim — resolution happens at the aggregation layer, after
- * parsing).
- */
-function buildTagsSchema() {
-  const vocabularyActive =
-    settings.tagVocabulary && settings.tagGovernance === "strict";
-  if (!vocabularyActive) return z.array(z.string()).optional();
-  const allowed = new Set<string>();
-  for (const entry of tagVocabulary) {
-    allowed.add(entry.id);
-    for (const alias of entry.aliases ?? []) allowed.add(alias);
-  }
-  const allowedList = [...allowed];
-  if (allowedList.length === 0) return z.array(z.string()).optional();
-  const [first, ...rest] = allowedList;
-  return z
-    .array(z.enum([first, ...rest] as [string, ...string[]]))
-    .optional();
-}
-
-// ---------------------------------------------------------------------------
-// Schema builder — single source of truth for the docs frontmatter shape.
-// ---------------------------------------------------------------------------
-
-/**
- * Build the docs frontmatter zod schema.
- *
- * Returns a single `z.object(...).passthrough()` that is reused for every
- * docs collection (default + per-locale + per-version + per-version-per-locale).
- * The `tags` field is governance-aware: `buildTagsSchema()` returns a plain
- * `z.array(z.string())` when governance is off, or a restricted `z.enum`
- * when `tagGovernance: "strict"` + `tagVocabulary` is configured.
- *
- * `.passthrough()` keeps custom frontmatter keys (e.g. `author`, `status`)
- * available downstream — the frontmatter-preview UI relies on this to
- * surface arbitrary keys without declaring each one here.
- */
-export function buildDocsSchema() {
-  return z
-    .object({
-      title: z.string(),
-      description: z.string().optional(),
-      category: z.string().optional(),
-      sidebar_position: z.number().optional(),
-      sidebar_label: z.string().optional(),
-      tags: buildTagsSchema(),
-      search_exclude: z.boolean().optional(),
-      pagination_next: z.string().nullable().optional(),
-      pagination_prev: z.string().nullable().optional(),
-      draft: z.boolean().optional(),
-      unlisted: z.boolean().optional(),
-      hide_sidebar: z.boolean().optional(),
-      hide_toc: z.boolean().optional(),
-      wide: z.boolean().optional(),
-      doc_history: z.boolean().optional(),
-      standalone: z.boolean().optional(),
-      slug: z.string().optional(),
-      generated: z.boolean().optional(),
-      // Category metadata expressed as a directory index.mdx's frontmatter — the
-      // frontmatter form of `_category_.json`. `category_no_page` makes the index
-      // a non-linked sidebar header excluded from routes/sitemap/search;
-      // `category_sort_order` sets the child sort direction. Frontmatter wins
-      // over the sidecar.
-      category_no_page: z.boolean().optional(),
-      category_sort_order: z.enum(["asc", "desc"]).optional(),
-    })
-    .passthrough();
-}
-
-// ---------------------------------------------------------------------------
-// Inferred type — single source of truth for the docs data shape.
-// ---------------------------------------------------------------------------
-
-/**
- * TypeScript type inferred from the docs frontmatter zod schema.
- *
- * Import this type instead of hand-writing the field list in `pages/_data.ts`
- * (`ZfbDocsData`) or `src/types/docs-entry.ts` (`DocsEntry.data`).
- *
- * The `[key: string]: unknown` index signature from `.passthrough()` is
- * naturally present via `z.infer` — custom frontmatter keys remain accessible
- * downstream (e.g. frontmatter-preview) without extra casting.
- */
-export type DocsData = z.infer<ReturnType<typeof buildDocsSchema>>;

package/templates/base/src/config/frontmatter-preview-defaults.ts

@@ -1,27 +0,0 @@
-/**
- * Schema-managed frontmatter keys that are handled by the framework and
- * should be hidden from the frontmatter preview by default.
- * These correspond to every field defined in the docsSchema in src/content.config.ts.
- */
-export const DEFAULT_FRONTMATTER_IGNORE_KEYS: string[] = [
-  "title",
-  "description",
-  "category",
-  "sidebar_position",
-  "sidebar_label",
-  "tags",
-  "search_exclude",
-  "pagination_next",
-  "pagination_prev",
-  "draft",
-  "unlisted",
-  "hide_sidebar",
-  "hide_toc",
-  "wide",
-  "doc_history",
-  "standalone",
-  "slug",
-  "generated",
-  "category_no_page",
-  "category_sort_order",
-];

package/templates/base/src/config/frontmatter-preview-renderers.tsx

@@ -1,46 +0,0 @@
-import type {
-  FrontmatterCellRenderer,
-  FrontmatterCellRendererProps,
-} from "@takazudo/zudo-doc/metainfo";
-
-/**
- * Props passed to every custom frontmatter renderer component.
- *
- * Lookup rule: `frontmatterRenderers[key]` is checked after the ignore-list
- * filter and after null/undefined skipping, so renderers only receive defined
- * values and are never invoked for ignored keys.
- *
- * Ignore-list precedence: if a key appears in `settings.frontmatterPreview.ignoreKeys`
- * (or the default ignore list), the row is suppressed entirely — even if a renderer
- * is registered for that key. To reveal a framework-managed key with a custom
- * renderer, first remove the key from the ignore list in settings.
- *
- * Fallback behavior: if no renderer is registered for a key, the built-in
- * `renderValue()` path is used (string/number/boolean as text, other types as
- * JSON in a `<code>` element).
- *
- * Null/undefined skipping: values of `null` or `undefined` are filtered out
- * before renderer lookup. Renderers can assume `value` is defined.
- */
-// Re-export the canonical props type from the package so project code has a
-// single import path. The locale field is typed as string (the package uses
-// string rather than the project-specific Locale union to avoid a circular
-// dependency); the runtime values are identical.
-export type { FrontmatterCellRendererProps as FrontmatterRendererProps };
-
-/**
- * Per-key custom renderer map for the frontmatter-preview component.
- *
- * Add entries here to override how specific frontmatter fields are displayed.
- * Keys must match frontmatter field names exactly (case-sensitive).
- *
- * Each renderer is a function `(props: FrontmatterCellRendererProps) => ComponentChildren`.
- * Return `null` or `undefined` to fall through to the built-in `renderValue()`
- * plain-text path.
- *
- * Example (add a renderer for a `status` field):
- * ```tsx
- * status: ({ value }) => <strong>{String(value)}</strong>,
- * ```
- */
-export const frontmatterRenderers: Record<string, FrontmatterCellRenderer> = {};