create-zudo-doc 3.2.0 → 4.0.0

package/dist/scaffold.js

@@ -1,24 +1,30 @@
 import fs from "fs-extra";
 import path from "path";
 import { fileURLToPath } from "url";
-import { generateSettingsFile } from "./settings-gen.js";
 import { generateZfbConfig } from "./zfb-config-gen.js";
 import { generateCLAUDEFile } from "./claude-md-gen.js";
 import { composeFeatures } from "./compose.js";
 import { featureModules } from "./features/index.js";
-import { capitalize, getSecondaryLang } from "./utils.js";
+import { capitalize, getSecondaryLang, pmRunCommand } from "./utils.js";
 export { getSecondaryLang };
 /**
- * Pinned `@takazudo/zudo-doc` version used in both `generatePackageJson()`
- * and the `.zudo-doc.json` seed written by `scaffold()`. Hoisted as a shared
- * constant so the dep pin and the provenance seed can never drift.
+ * Pinned `@takazudo/zudo-doc` version used by `generatePackageJson()`.
+ * Hoisted as a shared constant (kept even though it now has a single
+ * call site) because `scripts/check-pin-parity.mjs` resolves this exact
+ * declaration below via its constant-reference regex form (see that
+ * script's `readScaffoldPin()`) — keep the declaration line's shape
+ * parseable (const name, `=`, a quoted literal) and do NOT repeat that
+ * exact pattern anywhere earlier in this file (a comment containing the
+ * literal text would false-match the same regex, since it isn't anchored
+ * to a real `export const` statement).
  *
- * Strip the caret from this string to get the bare version for provenance:
- *   ZUDO_DOC_PIN.replace(/^\^/, "")   →  "1.0.0"
+ * `.zudo-doc.json` is NO LONGER seeded here (locked decision #2653 #6 —
+ * lazy-create on first `zudo-doc eject`; `packages/zudo-doc/src/eject/index.ts`
+ * already tolerates its absence and writes the file on first successful eject).
  *
  * Bumped in lockstep by scripts/release-create-zudo-doc.sh.
  */
-export const ZUDO_DOC_PIN = "^3.2.0";
+export const ZUDO_DOC_PIN = "^4.0.0";
 /**
  * Files in `templates/base/**` that must not be copied by the unconditional
  * base mirror. Each entry is matched against the path relative to
@@ -107,7 +113,7 @@ sidebar_position: 2
 
 ## Requirements
 
-- Node.js 18 or later
+- Node.js 22 or later
 - pnpm (recommended), npm, yarn, or bun
 
 ## Create a New Project
@@ -135,7 +141,7 @@ sidebar_position: 2
 
 ## 動作要件
 
-- Node.js 18 以降
+- Node.js 22 以降
 - pnpm（推奨）、npm、yarn、または bun
 
 ## 新しいプロジェクトを作成する
@@ -283,21 +289,17 @@ export async function scaffold(choices) {
             await fs.outputFile(path.join(targetDir, `src/content/docs-${secondaryLang}/changelog/index.mdx`), secondaryChangelogContent);
         }
     }
-    // 3. Generate programmatic files
-    const settingsContent = generateSettingsFile(choices);
-    await fs.outputFile(path.join(targetDir, "src/config/settings.ts"), settingsContent);
+    // 3. Generate the one config file. There is no more src/config/settings.ts —
+    // every user choice rides straight into zudoDoc({...}) in zfb.config.ts
+    // (locked decision #2653 #2 — diff-from-defaults single config).
     const zfbConfigContent = generateZfbConfig(choices);
     await fs.outputFile(path.join(targetDir, "zfb.config.ts"), zfbConfigContent);
     const pkg = generatePackageJson(choices);
     await fs.outputFile(path.join(targetDir, "package.json"), JSON.stringify(pkg, null, 2) + "\n");
-    // Seed .zudo-doc.json — provenance marker for `zudo-doc eject <component>`.
-    // packageVersion is the bare version string (caret stripped from ZUDO_DOC_PIN)
-    // so it records the concrete version the scaffold targets; the eject CLI
-    // records the actually-installed version on first eject.
-    await fs.outputFile(path.join(targetDir, ".zudo-doc.json"), JSON.stringify({
-        packageVersion: ZUDO_DOC_PIN.replace(/^\^/, ""),
-        ejected: {},
-    }, null, 2) + "\n");
+    // .zudo-doc.json is intentionally NOT seeded (locked decision #2653 #6 —
+    // lazy-create on first `zudo-doc eject`). `packages/zudo-doc/src/eject/index.ts`
+    // already tolerates its absence (defaults to `{ packageVersion: "unknown",
+    // ejected: {} }`) and writes the file itself on first successful eject.
     const gitignoreLines = [
         "# Build output",
         "node_modules",
@@ -363,8 +365,10 @@ export async function scaffold(choices) {
 }
 function generatePackageJson(choices) {
     // Intentionally absent from scaffolded deps:
-    //   @takazudo/zudo-doc-md-plugins — private fixture/parity-test asset; not published,
-    //   not for app import. Zero references in generator templates/source.
+    //   @takazudo/zudo-doc-md-plugins — the legacy JS remark/rehype pipeline it
+    //   would have named was retired outright (packages/md-plugins/ deleted,
+    //   #2683); its parity coverage lives in e2e/smoke-markdown-features.spec.ts.
+    //   Zero references in generator templates/source.
     const deps = {
         // zfb engine — distributed as published npm packages (the prebuilt binary
         // ships via an optionalDependency of @takazudo/zfb-<platform>); pinned to
@@ -411,9 +415,9 @@ function generatePackageJson(choices) {
         // disabled, reproducible CSS-Modules scoped names (project-relative paths),
         // dev-mode git-restore detection, Tailwind temp-file cleanup, and a
         // near-miss `"use client"` directive scanner.
-        // next.33 added the opt-in hierarchical heading-ID strategy
+        // next.33 added hierarchical heading IDs
         // (Takazudo/zudo-front-builder#871): `markdown.features.headingIds.strategy`.
-        // The generated config + TOC builder use it via settings.headingIdStrategy.
+        // zudo-doc now uses that strategy unconditionally in its package preset.
         // 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).
@@ -443,23 +447,24 @@ function generatePackageJson(choices) {
         // extraWatchPaths rebuilds, and TS-config-loader path canonicalization
         // (Takazudo/zudo-front-builder#1036–#1043). next.45: docs-only. next.46:
         // opt-in dev boot-lazy mode (#1057) + client-router timer lifecycle fixes —
-        // dev-server-only. next.47: dual light/dark syntect themes (themeLight/
+        // dev-server-only. Historical dual light/dark theme support (themeLight/
         // themeDark on CodeHighlightConfig, --shiki-light/--shiki-dark, #1067) plus
         // stricter build-start validation that rejects unknown theme names. next.48:
         // re-export @takazudo/zfb/config from the zfb-shim.d.ts type shim — type-only
         // fix, additive. next.49: client-router WebKit bfcache fix —
         // re-sync the history index + originalLocation on a bfcache restore so
         // browser Back after an SPA navigation returns to the previous page instead
-        // of skipping an entry — runtime-only bug fix, additive. next.50 (current
-        // pin): client-router fix to commit the SPA history entry BEFORE the View
+        // of skipping an entry — runtime-only bug fix, additive. next.50:
+        // client-router fix to commit the SPA history entry BEFORE the View
         // Transition, so on WebKit/iOS a single browser Back after an SPA navigation
         // creates a distinct history entry instead of falling off the site —
-        // runtime-only bug fix, additive. next.51 (current pin): additive public-API
+        // runtime-only bug fix, additive. next.51: additive public-API
         // surface — VNode/VNodeArray/VNodeObject are now exported from
         // "@takazudo/zfb" (#972) — plus removal of the no-op linkValidation.allowExternal
-        // knob (#925); both are non-breaking for a fresh scaffold. A fresh scaffold
-        // sets codeHighlight.themeLight/themeDark for dual-theme syntect output. No
-        // consumer-facing / CLI breaking change. next.52: adds the
+        // knob (#925); both are non-breaking for a fresh scaffold. Highlight config
+        // is package-preset-owned: fresh scaffolds delegate to zudoDoc(), whose
+        // preset selects class mode without emitting theme names project-side.
+        // next.52 adds the
         // `ClientRouter({ preserveHtmlAttrs })` option (zfb#1104) — consumers can
         // declare runtime `<html>` attribute names to preserve across SPA swaps so
         // e.g. `data-sidebar-hidden` / `data-theme` survive (zudolab/zudo-doc#2200).
@@ -497,14 +502,22 @@ function generatePackageJson(choices) {
         // next.76: routine toolchain bump from next.75, adopted in
         // lockstep with the root package.json pins. No consumer-facing / CLI change.
         // next.77: router persistence/history fixes and runtime island remount
-        // support, adopted in lockstep with the root package.json pins. No
-        // scaffold API change. next.78 (current pin): production HTML minification
-        // support via minifyHtml, adopted as a zudo-doc default through settings.
-        "@takazudo/zfb": "0.1.0-next.78",
-        "@takazudo/zfb-runtime": "0.1.0-next.78",
+        // support. next.78 added production HTML minification. next.81 added the
+        // package-root semantic highlight API plus island resource delivery
+        // (zfb#1633/#1643). next.83 completes bundle.exclude dependency staging
+        // for package-owned overlay routes (zfb#1645/#1649); next.84 canonicalizes
+        // linked package-route identity so SSR shares one framework singleton
+        // (zfb#1650/#1651). next.85 also remaps absolute project imports from
+        // virtual host modules into the staged project graph, preserving that
+        // singleton across host-callable wiring (zfb#1652/#1653). The zfb family
+        // must stay in lockstep because the WASM browser entry depends on its
+        // resource-aware island pipeline.
+        "@takazudo/zfb": "0.1.0-next.87",
+        "@takazudo/zfb-runtime": "0.1.0-next.87",
         // zfb-adapter-cloudflare — required for any route with `prerender = false`.
         // Pinned in lockstep with @takazudo/zfb.
-        "@takazudo/zfb-adapter-cloudflare": "0.1.0-next.78",
+        "@takazudo/zfb-adapter-cloudflare": "0.1.0-next.87",
+        "@takazudo/zfb-md-wasm": "0.1.0-next.87",
         // @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
@@ -539,6 +552,7 @@ function generatePackageJson(choices) {
         // compiles. Same pin as host. Caught by W6B (#1735) consumer-build
         // verification.
         "preact-render-to-string": "^6.6.6",
+        // Retained until #2742 atomically moves HTML Preview to zfb-md-wasm.
         shiki: "^4.0.2",
         "@shikijs/transformers": "^4.0.0",
         "gray-matter": "^4.0.0",
@@ -564,6 +578,26 @@ function generatePackageJson(choices) {
         // missing copy produces no `pnpm install` warning — which is why this gap
         // shipped silently and only surfaced at build time.
         diff: "^8.0.3",
+        // @takazudo/zdtp — SAME "unconditional at build time despite being an
+        // optional peer" class as `diff` above, discovered empirically while
+        // verifying this generator's own barebone (designTokenPanel: OFF) output
+        // (epic zudolab/zudo-doc#2651, #2660 self-review — a genuine package-level
+        // coupling, not a generator bug; flagged loudly on #2660's completion
+        // comment for a package-side follow-up). Since the #2658 gate-2 fix,
+        // `chrome/derive.tsx`'s `deriveBodyEndIslands` statically imports the REAL
+        // `DesignTokenPanelBootstrap` as the default for EVERY `createChrome`
+        // consumer (so the island auto-mounts with zero host wiring when the
+        // setting is on) — and that component imports `@takazudo/zdtp` at module
+        // scope. So every page that goes through `createChrome` — which is every
+        // page in this project — pulls the zdtp import into the esbuild bundle
+        // graph, `designTokenPanel` setting or not; only RENDERING is gated on
+        // the setting, not the import. Without this dep, `zfb build` fails with
+        // "Could not resolve '@takazudo/zdtp'" even on a fully barebone project.
+        // `preact ^10.29.1` (see the floor comment above) is required for the
+        // same reason. This is the ACCEPTED, permanent contract per #2668 — see
+        // the "@takazudo/zdtp dep implication" note in
+        // packages/zudo-doc/docs/adr/route-injection-seam.md.
+        "@takazudo/zdtp": "0.4.9",
     };
     const devDeps = {
         "@tailwindcss/vite": "^4.2.0",
@@ -571,7 +605,8 @@ function generatePackageJson(choices) {
         typescript: "^5.9.0",
         "@types/node": "^22.0.0",
         "@types/react": "^19.2.0", // needed for preact/compat type resolution
-        "html-validate": "^10.0.0",
+        // html-validate dropped — check:html is no longer a default script
+        // (see the scripts block below; `.htmlvalidate.json` no longer ships).
     };
     if (choices.features.includes("search")) {
         deps["minisearch"] = "^7.2.0";
@@ -583,11 +618,11 @@ function generatePackageJson(choices) {
         // required regardless of this feature flag.)
         // @takazudo/zudo-doc has @takazudo/zudo-doc-history-server as an optional
         // peer dep. When docHistory is selected the zfb plugin
-        // (@takazudo/zudo-doc/plugins/doc-history) eagerly imports
-        // @takazudo/zudo-doc/integrations/doc-history which in turn imports
+        // (@takazudo/zudo-doc/plugins/doc-history) eagerly imports its internal
+        // doc-history helpers, which in turn import
         // @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"] = "^3.2.0";
+        deps["@takazudo/zudo-doc-history-server"] = "^4.0.0";
         // tsx is no longer needed here: the relocated package plugin imports the
         // runner directly (no `tsx -e` spawn) since the package ships compiled
         // dist/ — package-first migration #2321 (#2337).
@@ -595,46 +630,27 @@ function generatePackageJson(choices) {
     // claudeResources: tsx is no longer needed. The relocated package plugin
     // (@takazudo/zudo-doc/plugins/claude-resources) imports the runner directly
     // since the package ships compiled dist/ — package-first migration #2321 (#2337).
-    if (choices.features.includes("designTokenPanel")) {
-        // @takazudo/zdtp requires preact >= 10.29.1 — see the preact floor comment
-        // above (~line 382) for why the floor is set there and the coupling this creates.
-        deps["@takazudo/zdtp"] = "0.4.5";
-    }
-    if (choices.features.includes("tagGovernance")) {
-        // gray-matter is already in `deps` unconditionally (base template uses it),
-        // so we only add the tooling deps specific to tags:audit / tags:suggest.
-        devDeps["string-similarity"] = "^4.0.4";
-        devDeps["@types/string-similarity"] = "^4.0.2";
-        devDeps["pluralize"] = "^8.0.0";
-        devDeps["@types/pluralize"] = "^0.0.33";
-        devDeps["picocolors"] = "^1.1.1";
-        devDeps["@inquirer/prompts"] = "^8.4.2";
-        devDeps["tsx"] = "^4.21.0";
-    }
+    // check:html and gen:z-index/check:z-index are DROPPED from the default
+    // scaffold (locked decision, epic #2651 #2660 work item 6):
+    //   - `.htmlvalidate.json` no longer ships — html-validate becomes an
+    //     opt-in extend step (documented in #2664).
+    //   - z-index tokens ship unconditionally from `@takazudo/zudo-doc/theme.css`
+    //     (13 default tiers, epic #2655) — a project only needs its own
+    //     `src/config/z-index-tokens.ts` + codegen scripts when it overrides a
+    //     tier, which is an eject-time decision, not a scaffold-time one.
     const scripts = {
         dev: "zfb dev",
         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\"",
-        // Z-index token codegen (#2148): regenerate the GENERATED:Z_INDEX @theme
-        // block in src/styles/global.css from src/config/z-index-tokens.ts, and a
-        // drift check for pre-push/CI. Both ship in base — the z-index token system
-        // is part of every scaffold. Bin provided by @takazudo/zudo-doc (S9b #2334).
-        "gen:z-index": "gen-z-index",
-        "check:z-index": "gen-z-index --check",
     };
     if (choices.features.includes("tagGovernance")) {
-        // tags-audit bin is provided by @takazudo/zudo-doc (S9b #2334);
-        // tsx is still required as a devDep because the bin's runner imports
-        // the project's TypeScript config files at runtime via tsx.
-        scripts["tags:audit"] = "tags-audit";
-        scripts["tags:suggest"] = "tsx scripts/tags-suggest.ts";
+        // Both package-owned bins load the same explicit project config. `--`
+        // supplied by pnpm/npm is preserved by the runners for forwarded options.
+        scripts["tags:audit"] =
+            "tags-audit --config src/config/tag-vocabulary.ts";
+        scripts["tags:suggest"] =
+            "tags-suggest --config src/config/tag-vocabulary.ts";
     }
     if (choices.features.includes("skillSymlinker")) {
         scripts["setup:doc-skill"] = "bash scripts/setup-doc-skill.sh";
@@ -647,17 +663,17 @@ function generatePackageJson(choices) {
         scripts["setup:doc-skill:both"] =
             "bash scripts/setup-doc-skill.sh --target both";
     }
-    const runCmd = choices.packageManager === "npm" || choices.packageManager === "bun" ? `${choices.packageManager} run` : choices.packageManager;
+    const pm = choices.packageManager;
     // claudeSkills ships the zudo-doc-version-bump skill, whose release workflow
     // calls `<pm> b4push`. Emit a minimal stub so the skill does not hit a
     // "script not found" error on freshly scaffolded projects. Consumers are
     // free to expand this into a richer pre-push pipeline later.
     if (choices.features.includes("claudeSkills")) {
-        scripts["b4push"] = `${runCmd} check && ${runCmd} build`;
+        scripts["b4push"] = `${pmRunCommand(pm, "check")} && ${pmRunCommand(pm, "build")}`;
     }
     if (choices.features.includes("tauri")) {
         scripts["dev:tauri"] = "cargo tauri dev";
-        scripts["build:tauri"] = `${runCmd} build && cargo tauri build`;
+        scripts["build:tauri"] = `${pmRunCommand(pm, "build")} && cargo tauri build`;
     }
     if (choices.features.includes("tauriDev")) {
         scripts["dev:tauri-dev"] = "cd src-tauri-dev && cargo tauri dev";
@@ -668,6 +684,9 @@ function generatePackageJson(choices) {
         version: "0.0.1",
         private: true,
         type: "module",
+        // @takazudo/zfb + @takazudo/zfb-runtime declare engines.node ">=22.0.0";
+        // emit the floor so `<pm> install` warns early on an unsupported Node.
+        engines: { node: ">=22" },
         scripts,
         dependencies: deps,
         devDependencies: devDeps,

package/dist/utils.d.ts

@@ -37,6 +37,16 @@ export declare function initGitRepo(dir: string): GitInitResult;
 export declare function capitalize(str: string): string;
 /** Get a short uppercase label for a language code (e.g. "en" → "EN", "zh-cn" → "ZH-CN"). */
 export declare function getLangLabel(langCode: string): string;
+/**
+ * Build the command that runs a package.json script under `pm`.
+ *
+ * npm and bun BOTH require the `run` verb — `bun build` invokes Bun's bundler,
+ * NOT the package.json `build` script (a real footgun), so bun must emit
+ * `bun run build`. pnpm and yarn accept the bare script name (`pnpm build`).
+ * The single source of truth for this rule across claude-md-gen.ts,
+ * scaffold.ts, and features/tauri.ts.
+ */
+export declare function pmRunCommand(pm: "pnpm" | "npm" | "yarn" | "bun", script: string): string;
 /** Determine the secondary language code when i18n is enabled. */
 export declare function getSecondaryLang(defaultLang: string): string;
 /** Apply a list of regex replacements to a file (if it exists). */

package/dist/utils.js

@@ -114,6 +114,20 @@ export function capitalize(str) {
 export function getLangLabel(langCode) {
     return langCode.toUpperCase();
 }
+/**
+ * Build the command that runs a package.json script under `pm`.
+ *
+ * npm and bun BOTH require the `run` verb — `bun build` invokes Bun's bundler,
+ * NOT the package.json `build` script (a real footgun), so bun must emit
+ * `bun run build`. pnpm and yarn accept the bare script name (`pnpm build`).
+ * The single source of truth for this rule across claude-md-gen.ts,
+ * scaffold.ts, and features/tauri.ts.
+ */
+export function pmRunCommand(pm, script) {
+    return pm === "npm" || pm === "bun"
+        ? `${pm} run ${script}`
+        : `${pm} ${script}`;
+}
 /** Determine the secondary language code when i18n is enabled. */
 export function getSecondaryLang(defaultLang) {
     return defaultLang === "en" ? "ja" : "en";

package/dist/zfb-config-gen.d.ts

@@ -1,25 +1,37 @@
 import type { UserChoices } from "./prompts.js";
 /**
- * Programmatically generate zfb.config.ts from user choices.
+ * Programmatically generate the ONE `zfb.config.ts` a scaffolded project
+ * ships (epic zudolab/zudo-doc#2651, minimal-scaffold Wave 6 #2660).
  *
- * S5b (#2329): collapsed to the thin preset-based shape that mirrors the
- * showcase `zfb.config.ts` after S5a. All collection wiring, plugin
- * descriptors, markdown features, codeHighlight, resolveMarkdownLinks,
- * trailingSlash, and minifyHtml are now owned by `zudoDocPreset()` in
- * `@takazudo/zudo-doc/preset`. The generated config spreads the preset
- * result into `defineConfig` and keeps only the project-owned shell fields
- * (`framework`, `port`, `tailwind`, `base`).
+ * Replaces the former `settings-gen.ts` + `zfb-config-gen.ts` pair: there is
+ * no more `src/config/settings.ts` — every user choice becomes a field
+ * passed straight into `zudoDoc({ ... })` (`@takazudo/zudo-doc/config`),
+ * which merges it over the package's own documented defaults and returns a
+ * complete `ZfbConfig`.
  *
- * Replaces the former astro-config-gen.ts + content-config-gen.ts pair.
- * In the zfb world, content-collection schemas live inside zfb.config.ts
- * itself — there is no separate content.config.ts.
- *
- * `_choices` is intentionally unused: post-S5b the emitted config is a
- * CONSTANT. All feature variation is driven by `settings.*` (read at
- * zfb-load time inside `zudoDocPreset()`), so the generated file is byte
- * identical for every feature combination. The parameter is retained only
- * for call-site compatibility (`scaffold.ts` passes `choices`). Do NOT add
- * feature-gated branches here — wire new feature behaviour into
- * `packages/zudo-doc/src/preset.ts` and the project's `settings.ts` instead.
+ * DIFF-FROM-DEFAULTS (locked, #2653 Decision 2): only fields whose resolved
+ * value differs from the matching `ZudoDocConfig` `@default` are emitted —
+ * `siteName` is the one field always emitted. `DEFAULT_MIRROR` below is a
+ * hand-kept copy of `packages/zudo-doc/src/config.ts`'s `DEFAULT_SETTINGS`
+ * for exactly the fields this generator ever sets. It has to be a local
+ * mirror (not an import) because `create-zudo-doc` does not depend on
+ * `@takazudo/zudo-doc` at generator-build time — the package is only ever a
+ * runtime dependency of the SCAFFOLDED project, never of the generator
+ * itself. Keep this mirror in sync by hand whenever `DEFAULT_SETTINGS`
+ * changes for one of the fields listed here.
+ */
+export declare const DEFAULT_MIRROR: Record<string, unknown>;
+/**
+ * Deterministic emission order for the keys of a `desired` config object:
+ * the keys present in `FIELD_ORDER` first (cosmetic reference order), then any
+ * leftover keys NOT in `FIELD_ORDER` appended in ALPHABETICAL order. The
+ * leftover branch exists so a key `buildDesiredConfig()` produces but nobody
+ * added to `FIELD_ORDER` is still emitted (deterministically) rather than
+ * silently dropped — matching what the `FIELD_ORDER` comment promises.
+ */
+export declare function orderDesiredKeys(desiredKeys: readonly string[]): string[];
+/**
+ * Generate the full `zfb.config.ts` source: `defineConfig(zudoDoc({ ... }))`
+ * with only the diff-from-defaults fields.
  */
-export declare function generateZfbConfig(_choices: UserChoices): string;
+export declare function generateZfbConfig(choices: UserChoices): string;