create-zudo-doc 0.2.0 → 0.2.2

package/dist/api.js

@@ -1,8 +1,11 @@
 import path from "path";
 import { scaffold } from "./scaffold.js";
-import { installDependencies } from "./utils.js";
+import { installDependencies, validateProjectName } from "./utils.js";
 export async function createZudoDoc(options) {
     const { install = false, ...rest } = options;
+    const nameError = validateProjectName(rest.projectName);
+    if (nameError)
+        throw new Error(`Invalid projectName: ${nameError}`);
     const choices = { ...rest, defaultLang: rest.defaultLang ?? "en" };
     await scaffold(choices);
     const targetDir = path.resolve(process.cwd(), choices.projectName);

package/dist/cli.js

@@ -1,6 +1,7 @@
 import minimist from "minimist";
 import pc from "picocolors";
 import { FEATURES, SINGLE_SCHEMES, SUPPORTED_LANGS } from "./constants.js";
+import { validateProjectName } from "./utils.js";
 export function parseArgs(argv = process.argv.slice(2)) {
     const raw = minimist(argv, {
         string: [
@@ -146,12 +147,9 @@ export function validateArgs(args) {
         return `--scheme is only valid with --color-scheme-mode single`;
     }
     if (args.name) {
-        if (/^[./]|\.\./.test(args.name)) {
-            return "Project name must not contain path traversal characters";
-        }
-        if (/[<>:"|?*\\]/.test(args.name)) {
-            return "Project name contains invalid characters";
-        }
+        const nameError = validateProjectName(args.name);
+        if (nameError)
+            return nameError;
     }
     return null;
 }

package/dist/compose.d.ts

@@ -78,9 +78,8 @@ export declare function validateDependencies(features: FeatureDefinition[], allS
  * - `pages/_mdx-components.ts` — image-enlarge.ts injects the
  *   EnlargeableParagraph p-override (ENLARGE_SVG, EnlargeableParagraph def,
  *   `p:` map entry) when imageEnlarge is enabled.
- *
- * The .tsx anchor form is still supported in `ANCHOR_LINE_RE` for forward
- * compatibility.
+ * - `pages/lib/_body-end-islands.tsx` — tauri.ts injects the FindInPageInit
+ *   island (import, displayName, Island mount) when tauri is enabled.
  */
 export declare const ANCHOR_FILES: string[];
 /**

package/dist/compose.js

@@ -164,11 +164,14 @@ export function validateDependencies(features, allSelectedNames) {
  * - `pages/_mdx-components.ts` — image-enlarge.ts injects the
  *   EnlargeableParagraph p-override (ENLARGE_SVG, EnlargeableParagraph def,
  *   `p:` map entry) when imageEnlarge is enabled.
- *
- * The .tsx anchor form is still supported in `ANCHOR_LINE_RE` for forward
- * compatibility.
+ * - `pages/lib/_body-end-islands.tsx` — tauri.ts injects the FindInPageInit
+ *   island (import, displayName, Island mount) when tauri is enabled.
  */
-export const ANCHOR_FILES = ["src/styles/global.css", "pages/_mdx-components.ts"];
+export const ANCHOR_FILES = [
+    "src/styles/global.css",
+    "pages/_mdx-components.ts",
+    "pages/lib/_body-end-islands.tsx",
+];
 /**
  * Main composition entry point. Orchestrates the full feature composition
  * pipeline for a generated project.

package/dist/features/tauri.d.ts

@@ -2,10 +2,15 @@ import type { FeatureModule } from "../compose.js";
 /**
  * Tauri feature.
  *
- * W7A (#1736): post-cutover, the FindInPage island is mounted by the
- * pages/lib body-end wrapper. The find-match highlight CSS is unconditional
- * in `templates/base/src/styles/global.css` (matches host). Only the
- * postProcess hooks (Cargo.toml / tauri.conf.json / .gitignore patches)
- * remain feature-scoped.
+ * #2052: the FindInPageInit island (Cmd/Ctrl+F find bar for the Tauri
+ * WebView, where the browser-native find UI is unavailable) is wired into
+ * `pages/lib/_body-end-islands.tsx` via the three injections below — import,
+ * displayName, and Island mount. zfb's island scanner only registers
+ * components reachable through static import chains (page → wrapper →
+ * component), so without this injection the feature-copied component files
+ * are orphaned dead code that never hydrates. The find-match highlight CSS
+ * is unconditional in `templates/base/src/styles/global.css` (matches host);
+ * the component runtime-gates itself (renders null unless
+ * `window.__TAURI_INTERNALS__` exists), so no settings field is needed.
  */
 export declare const tauriFeature: FeatureModule;

package/dist/features/tauri.js

@@ -3,15 +3,58 @@ import path from "path";
 /**
  * Tauri feature.
  *
- * W7A (#1736): post-cutover, the FindInPage island is mounted by the
- * pages/lib body-end wrapper. The find-match highlight CSS is unconditional
- * in `templates/base/src/styles/global.css` (matches host). Only the
- * postProcess hooks (Cargo.toml / tauri.conf.json / .gitignore patches)
- * remain feature-scoped.
+ * #2052: the FindInPageInit island (Cmd/Ctrl+F find bar for the Tauri
+ * WebView, where the browser-native find UI is unavailable) is wired into
+ * `pages/lib/_body-end-islands.tsx` via the three injections below — import,
+ * displayName, and Island mount. zfb's island scanner only registers
+ * components reachable through static import chains (page → wrapper →
+ * component), so without this injection the feature-copied component files
+ * are orphaned dead code that never hydrates. The find-match highlight CSS
+ * is unconditional in `templates/base/src/styles/global.css` (matches host);
+ * the component runtime-gates itself (renders null unless
+ * `window.__TAURI_INTERNALS__` exists), so no settings field is needed.
  */
 export const tauriFeature = (choices) => ({
     name: "tauri",
-    injections: [],
+    injections: [
+        // 1. Import the island entry. Inserted AFTER the
+        //    `// @slot:body-end-islands:imports` anchor.
+        {
+            file: "pages/lib/_body-end-islands.tsx",
+            anchor: "// @slot:body-end-islands:imports",
+            position: "after",
+            content: `import FindInPageInit from "@/components/find-in-page-init";`,
+        },
+        // 2. Stable island marker name (same belt-and-braces guard as the
+        //    sibling islands in the file). Inserted AFTER the
+        //    `// @slot:body-end-islands:display-names` anchor.
+        {
+            file: "pages/lib/_body-end-islands.tsx",
+            anchor: "// @slot:body-end-islands:display-names",
+            position: "after",
+            content: `(FindInPageInit as { displayName?: string }).displayName = "FindInPageInit";`,
+        },
+        // 3. Island mount. Inserted AFTER the
+        //    `{/* @slot:body-end-islands:extra-islands */}` anchor.
+        //    when="load" (not "idle"): the island's job is to intercept
+        //    Cmd/Ctrl+F via a keydown listener, so it must hydrate as soon as
+        //    the islands runtime mounts — same rationale as the
+        //    clientRouterBootstrap click intercept above it. Deferring to idle
+        //    would leave a post-load window where Cmd+F does nothing, which is
+        //    the very bug this injection fixes.
+        {
+            file: "pages/lib/_body-end-islands.tsx",
+            anchor: "{/* @slot:body-end-islands:extra-islands */}",
+            position: "after",
+            content: `      {/* Tauri-only find-in-page (Cmd/Ctrl+F) bar. Renders null outside
+          a Tauri WebView, so the island is inert in plain browser builds
+          of the same scaffold. */}
+      {Island({
+        when: "load",
+        children: <FindInPageInit />,
+      }) as unknown as VNode}`,
+        },
+    ],
     postProcess: async (targetDir) => {
         // Patch Cargo.toml package name
         const cargoPath = path.join(targetDir, "src-tauri/Cargo.toml");

package/dist/preset.js

@@ -1,5 +1,6 @@
 import fs from "fs";
 import { FEATURES, SINGLE_SCHEMES, SUPPORTED_LANGS } from "./constants.js";
+import { validateProjectName } from "./utils.js";
 const VALID_HEADER_RIGHT_COMPONENTS = new Set([
     "theme-toggle",
     "language-switcher",
@@ -34,6 +35,16 @@ export function validatePreset(json) {
         return "Preset must be a JSON object";
     }
     const p = json;
+    if (p.projectName !== undefined) {
+        // Untyped JSON — guard the type before the string validator, otherwise
+        // RegExp.test would coerce numbers/booleans and could accept them.
+        if (typeof p.projectName !== "string") {
+            return "Invalid projectName: must be a string";
+        }
+        const nameError = validateProjectName(p.projectName);
+        if (nameError)
+            return `Invalid projectName: ${nameError}`;
+    }
     if (p.features !== undefined && !Array.isArray(p.features)) {
         return `"features" must be an array in preset`;
     }

package/dist/prompts.js

@@ -1,5 +1,6 @@
 import * as p from "@clack/prompts";
 import { LIGHT_DARK_PAIRINGS, SINGLE_SCHEMES, FEATURES, SUPPORTED_LANGS } from "./constants.js";
+import { validateProjectName } from "./utils.js";
 export async function runPrompts(prefilled = {}) {
     // 1. Project name
     let projectName;
@@ -12,12 +13,7 @@ export async function runPrompts(prefilled = {}) {
             placeholder: "my-docs",
             defaultValue: "my-docs",
             validate(value) {
-                if (!value.trim())
-                    return "Project name is required";
-                if (/^[./]|\.\./.test(value))
-                    return "Project name must not contain path traversal characters";
-                if (/[<>:"|?*\\]/.test(value))
-                    return "Project name contains invalid characters";
+                return validateProjectName(value) ?? undefined;
             },
         });
         if (p.isCancel(result))

package/dist/scaffold.js

@@ -264,16 +264,21 @@ function generatePackageJson(choices) {
         // next.35 fixes resolve_links rewriting bare same-page `[text](#anchor)` /
         // `[text](?query)` links to `/<parent-dir>/#anchor` (zudolab/zudo-doc#1948,
         // upstream Takazudo/zudo-front-builder#875).
-        "@takazudo/zfb": "0.1.0-next.35",
-        "@takazudo/zfb-runtime": "0.1.0-next.35",
+        // next.38 adds client scripts (`.client.*` + `clientScript()`), the
+        // `when="media"` island strategy, exported VNode types, and stricter
+        // cross-file anchor validation. BREAKING upstream: the no-op
+        // `linkValidation.allowExternal` knob was removed — neither the host nor
+        // the generated config ever emitted it, so no migration is needed here.
+        "@takazudo/zfb": "0.1.0-next.38",
+        "@takazudo/zfb-runtime": "0.1.0-next.38",
         // zfb-adapter-cloudflare — required for any route with `prerender = false`.
         // Pinned in lockstep with @takazudo/zfb.
-        "@takazudo/zfb-adapter-cloudflare": "0.1.0-next.35",
+        "@takazudo/zfb-adapter-cloudflare": "0.1.0-next.38",
         // @takazudo/zudo-doc — published from this monorepo via
         // .github/workflows/publish-zudo-doc.yml. The pin here is bumped in
         // lockstep by scripts/release-create-zudo-doc.sh whenever zudo-doc's
         // version moves, so a fresh scaffold pulls the version we just published.
-        "@takazudo/zudo-doc": "^0.2.0",
+        "@takazudo/zudo-doc": "^0.2.2",
         // zod — used by the generated zfb.config.ts. zfb-config-gen emits
         // `import { z } from "zod"` for the content-collection schema +
         // `z.toJSONSchema(...)` conversion. Without this dep, the consumer
@@ -297,11 +302,9 @@ function generatePackageJson(choices) {
         "@shikijs/transformers": "^4.0.0",
         clsx: "^2.1.0",
         "gray-matter": "^4.0.0",
-        "github-slugger": "^2.0.0",
         mermaid: "^11.12.3",
         "remark-cjk-friendly": "^2.0.1",
         "remark-directive": "^3.0.0",
-        "unist-util-visit": "^5.1.0",
         // katex — server-side LaTeX renderer used by the always-on
         // pages/lib/_math-block.tsx (called from pages/_mdx-components.ts
         // for `$…$` and `$$…$$` math nodes). Caught by W6B (#1735)
@@ -313,8 +316,6 @@ function generatePackageJson(choices) {
         "@tailwindcss/vite": "^4.2.0",
         tailwindcss: "^4.2.0",
         typescript: "^5.9.0",
-        "@types/hast": "^3.0.4",
-        "@types/mdast": "^4.0.4",
         "@types/node": "^22.0.0",
         "@types/react": "^19.2.0", // needed for preact/compat type resolution
         "html-validate": "^10.0.0",
@@ -331,7 +332,7 @@ function generatePackageJson(choices) {
         // @takazudo/zudo-doc/integrations/doc-history which in turn imports
         // @takazudo/zudo-doc-history-server/git-history. Without this dep the
         // plugin host fails at init with ERR_MODULE_NOT_FOUND — W8A (#1739).
-        deps["@takazudo/zudo-doc-history-server"] = "^0.2.0";
+        deps["@takazudo/zudo-doc-history-server"] = "^0.2.2";
         // W7A (#1736): doc-history-plugin.mjs spawns `tsx -e <inline-script>` to
         // run the v2 runtime in a TS-aware Node subprocess; without tsx the
         // plugin's preBuild step exits with ENOENT before zfb finishes config
@@ -363,6 +364,11 @@ function generatePackageJson(choices) {
         build: "zfb build",
         preview: "zfb preview",
         check: "zfb check",
+        // NOTE: no `check:pages` here — the host repo's pages/ typecheck
+        // (tsconfig.pages.json, #2018) is host-only for now. The base template's
+        // no-op feature stubs (e.g. doc-history.tsx) are not type-clean against
+        // the pages/lib call sites, so emitting the script would fail on a fresh
+        // scaffold. Revisit once the template stubs carry typed props.
         "check:html": "html-validate \"dist/**/*.html\"",
     };
     if (choices.features.includes("tagGovernance")) {

package/dist/settings-gen.js

@@ -43,7 +43,7 @@ export function generateSettingsFile(choices) {
         lines.push(`    lightScheme: ${JSON.stringify(choices.lightScheme ?? "GitHub Light")},`);
         lines.push(`    darkScheme: ${JSON.stringify(choices.darkScheme ?? "GitHub Dark")},`);
         lines.push(`    respectPrefersColorScheme: ${choices.respectPrefersColorScheme ?? true},`);
-        lines.push(`  } satisfies ColorModeConfig,`);
+        lines.push(`  } satisfies ColorModeConfig as ColorModeConfig | false,`);
     }
     lines.push(`  siteName: ${JSON.stringify(capitalize(choices.projectName.replace(/-/g, " ")))},`);
     lines.push(`  siteDescription: "" as string,`);
@@ -60,15 +60,18 @@ export function generateSettingsFile(choices) {
     }
     lines.push(`  siteUrl: "" as string,`);
     lines.push(`  docsDir: "src/content/docs",`);
-    lines.push(`  defaultLocale: ${JSON.stringify(choices.defaultLang ?? "en")} as string,`);
+    lines.push(`  defaultLocale: ${JSON.stringify(choices.defaultLang ?? "en")} as const,`);
     if (choices.features.includes("i18n")) {
         const secondaryLang = getSecondaryLang(choices.defaultLang);
         const secondaryLabel = getLangLabel(secondaryLang);
         lines.push(`  locales: {`);
         lines.push(`    ${secondaryLang}: { label: ${JSON.stringify(secondaryLabel)}, dir: "src/content/docs-${secondaryLang}" },`);
-        lines.push(`  } as Record<string, LocaleConfig>,`);
+        lines.push(`  } satisfies Record<string, LocaleConfig>,`);
     }
     else {
+        // `as`, not `satisfies`: satisfies keeps the inferred type at literal {},
+        // so Object.entries(settings.locales) in the generated zfb.config.ts
+        // yields unknown values and `zfb check` fails with TS18046 (#2053).
         lines.push(`  locales: {} as Record<string, LocaleConfig>,`);
     }
     // mermaid is controlled by the markdown.features block in zfb.config.ts
@@ -159,7 +162,7 @@ export function generateSettingsFile(choices) {
     }
     lines.push(`  htmlPreview: undefined as HtmlPreviewConfig | undefined,`);
     if (choices.features.includes("versioning")) {
-        lines.push(`  versions: [] as VersionConfig[],`);
+        lines.push(`  versions: [] satisfies VersionConfig[] as VersionConfig[] | false,`);
     }
     else {
         lines.push(`  versions: false as VersionConfig[] | false,`);
@@ -219,7 +222,7 @@ export function generateSettingsFile(choices) {
     if (choices.features.includes("changelog")) {
         lines.push(`    { label: "Changelog", path: "/docs/changelog", categoryMatch: "changelog" },`);
     }
-    lines.push(`  ] as HeaderNavItem[],`);
+    lines.push(`  ] satisfies HeaderNavItem[] as HeaderNavItem[],`);
     lines.push(`  headerRightItems: [`);
     if (choices.headerRightItems !== undefined) {
         // User-supplied override (including empty array): emit each entry verbatim,
@@ -250,7 +253,7 @@ export function generateSettingsFile(choices) {
             lines.push(`    { type: "component", component: "language-switcher" },`);
         }
     }
-    lines.push(`  ] as HeaderRightItem[],`);
+    lines.push(`  ] satisfies HeaderRightItem[] as HeaderRightItem[],`);
     lines.push(`};`);
     return lines.join("\n") + "\n";
 }

package/dist/utils.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Validate a project name against the locked grammar.
+ *
+ * Returns `null` when valid; a human-readable error string when invalid.
+ * Apply on every input path: CLI arg, interactive prompt, preset, and
+ * programmatic API.
+ */
+export declare function validateProjectName(name: string): string | null;
 export declare function installDependencies(dir: string, pm: string): void;
 export declare function capitalize(str: string): string;
 /** Get a short uppercase label for a language code (e.g. "en" → "EN", "zh-cn" → "ZH-CN"). */

package/dist/utils.js

@@ -1,5 +1,30 @@
 import { execSync } from "child_process";
 import fs from "fs-extra";
+// Project-name grammar (locked by F4 — S4 #2013):
+// /^[a-z0-9][a-z0-9._-]*$/, max 214 chars, unscoped, used as both directory
+// name and package name. Mirrors npm's unscoped-name rules + max path safety.
+const PROJECT_NAME_RE = /^[a-z0-9][a-z0-9._-]*$/;
+const PROJECT_NAME_MAX = 214;
+/**
+ * Validate a project name against the locked grammar.
+ *
+ * Returns `null` when valid; a human-readable error string when invalid.
+ * Apply on every input path: CLI arg, interactive prompt, preset, and
+ * programmatic API.
+ */
+export function validateProjectName(name) {
+    if (!name || name.length === 0) {
+        return "Project name is required";
+    }
+    if (name.length > PROJECT_NAME_MAX) {
+        return `Project name must be ${PROJECT_NAME_MAX} characters or fewer`;
+    }
+    if (!PROJECT_NAME_RE.test(name)) {
+        return ("Project name must start with a lowercase letter or digit and contain " +
+            "only lowercase letters, digits, dots, underscores, and hyphens");
+    }
+    return null;
+}
 export function installDependencies(dir, pm) {
     const commands = {
         pnpm: "pnpm install",

package/dist/zfb-config-gen.js

@@ -19,62 +19,20 @@ export function generateZfbConfig(choices) {
     const hasDocHistory = choices.features.includes("docHistory");
     const hasLlmsTxt = choices.features.includes("llmsTxt");
     const hasClaudeResources = choices.features.includes("claudeResources");
-    const hasTagGovernance = choices.features.includes("tagGovernance");
     const lines = [];
     // --- Imports ---
     lines.push(`import { z } from "zod";`);
     lines.push(`import { defineConfig } from "zfb/config";`);
     lines.push(`import { settings } from "./src/config/settings";`);
-    if (hasTagGovernance) {
-        lines.push(`import { tagVocabulary } from "./src/config/tag-vocabulary";`);
-    }
+    lines.push(`import { buildDocsSchema } from "./src/config/docs-schema";`);
     lines.push(``);
-    // --- Tags schema builder (only when tagGovernance is selected) ---
-    if (hasTagGovernance) {
-        lines.push(`function buildTagsSchema() {`);
-        lines.push(`  const vocabularyActive = settings.tagVocabulary && settings.tagGovernance === "strict";`);
-        lines.push(`  if (!vocabularyActive) return z.array(z.string()).optional();`);
-        lines.push(`  const allowed = new Set<string>();`);
-        lines.push(`  for (const entry of tagVocabulary) {`);
-        lines.push(`    allowed.add(entry.id);`);
-        lines.push(`    for (const alias of entry.aliases ?? []) allowed.add(alias);`);
-        lines.push(`  }`);
-        lines.push(`  const allowedList = [...allowed];`);
-        lines.push(`  if (allowedList.length === 0) return z.array(z.string()).optional();`);
-        lines.push(`  const [first, ...rest] = allowedList;`);
-        lines.push(`  return z.array(z.enum([first, ...rest] as [string, ...string[]])).optional();`);
-        lines.push(`}`);
-        lines.push(``);
-    }
-    // --- Schema definition ---
-    lines.push(`const docsSchema = z`);
-    lines.push(`  .object({`);
-    lines.push(`    title: z.string(),`);
-    lines.push(`    description: z.string().optional(),`);
-    lines.push(`    category: z.string().optional(),`);
-    lines.push(`    sidebar_position: z.number().optional(),`);
-    lines.push(`    sidebar_label: z.string().optional(),`);
-    if (hasTagGovernance) {
-        lines.push(`    tags: buildTagsSchema(),`);
-    }
-    else {
-        lines.push(`    tags: z.array(z.string()).optional(),`);
-    }
-    lines.push(`    search_exclude: z.boolean().optional(),`);
-    lines.push(`    pagination_next: z.string().nullable().optional(),`);
-    lines.push(`    pagination_prev: z.string().nullable().optional(),`);
-    lines.push(`    draft: z.boolean().optional(),`);
-    lines.push(`    unlisted: z.boolean().optional(),`);
-    lines.push(`    hide_sidebar: z.boolean().optional(),`);
-    lines.push(`    hide_toc: z.boolean().optional(),`);
-    lines.push(`    doc_history: z.boolean().optional(),`);
-    lines.push(`    standalone: z.boolean().optional(),`);
-    lines.push(`    slug: z.string().optional(),`);
-    lines.push(`    generated: z.boolean().optional(),`);
-    lines.push(`    category_no_page: z.boolean().optional(),`);
-    lines.push(`    category_sort_order: z.enum(["asc", "desc"]).optional(),`);
-    lines.push(`  })`);
-    lines.push(`  .passthrough();`);
+    // --- Schema definition — delegated to the single source of truth ---
+    // buildDocsSchema() lives in src/config/docs-schema.ts and is shared by
+    // pages/_data.ts (ZfbDocsData alias) and src/types/docs-entry.ts (DocsData).
+    // tagGovernance projects: docs-schema.ts reads settings + tagVocabulary
+    // internally, so the generated zfb.config.ts needs no extra import or
+    // inline buildTagsSchema — the schema builder encapsulates all of that.
+    lines.push(`const docsSchema = buildDocsSchema();`);
     lines.push(``);
     lines.push(`const docsSchemaJson = z.toJSONSchema(docsSchema) as Record<string, unknown>;`);
     lines.push(``);
@@ -203,6 +161,9 @@ export function generateZfbConfig(choices) {
     // --- Export ---
     lines.push(`export default defineConfig({`);
     lines.push(`  framework: "preact",`);
+    lines.push(`  // Pin the dev/preview port — zfb defaults to 3000, but the generated`);
+    lines.push(`  // CLAUDE.md and the Tauri dev wrappers assume 4321.`);
+    lines.push(`  port: 4321,`);
     lines.push(`  tailwind: { enabled: true },`);
     lines.push(`  collections,`);
     lines.push(`  stripMdExt: true,`);

package/package.json

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

package/templates/base/pages/_data.ts

@@ -12,6 +12,7 @@
 
 import { getCollection } from "zfb/content";
 import type { CollectionEntry } from "zfb/content";
+import type { DocsData } from "@/config/docs-schema";
 import type { DocsEntry } from "@/types/docs-entry";
 import type { DocPageEntry } from "./lib/doc-page-props";
 import { toRouteSlug } from "@/utils/slug";
@@ -22,30 +23,16 @@ import { toRouteSlug } from "@/utils/slug";
 
 /**
  * Frontmatter shape shared by all docs collections (EN, locale, versioned).
- * Matches the zod schema in zfb.config.ts field-for-field.
- * `.passthrough()` equivalent: the index signature [key: string]: unknown
- * keeps custom frontmatter keys available (e.g. for frontmatter-preview).
+ *
+ * Re-exported alias for `DocsData` (the `z.infer`-derived type from
+ * `src/config/docs-schema.ts`) so call sites that import `ZfbDocsData` from
+ * `pages/_data` continue to work without changes.
+ *
+ * The `[key: string]: unknown` index signature comes from `.passthrough()` on
+ * the zod schema — custom frontmatter keys remain accessible downstream (e.g.
+ * for frontmatter-preview) without extra casting.
  */
-export type ZfbDocsData = {
-  title: string;
-  description?: string;
-  category?: string;
-  sidebar_position?: number;
-  sidebar_label?: string;
-  tags?: string[];
-  search_exclude?: boolean;
-  pagination_next?: string | null;
-  pagination_prev?: string | null;
-  draft?: boolean;
-  unlisted?: boolean;
-  hide_sidebar?: boolean;
-  hide_toc?: boolean;
-  doc_history?: boolean;
-  standalone?: boolean;
-  slug?: string;
-  generated?: boolean;
-  [key: string]: unknown;
-};
+export type ZfbDocsData = DocsData;
 
 /**
  * zfb collection entry augmented with the `id` and `collection` fields that