create-zudo-doc 0.1.0

package/dist/features/i18n.d.ts

@@ -0,0 +1,22 @@
+import type { FeatureModule } from "../compose.js";
+/**
+ * i18n feature — gates the locale-prefixed page set.
+ *
+ * Page templates are shipped under `templates/features/i18n/files/pages/`
+ * and copied by `composeFeatures → copyFeatureFiles` whenever `i18n` is in
+ * the selected feature set.
+ *
+ * No injections: header / language-switcher wiring was retired with the
+ * Astro cutover (#1736 / W7A) — `pages/lib/_header-with-defaults.tsx` now
+ * gates `LanguageSwitcher` on `Object.keys(settings.locales).length > 0`.
+ * The pages are locale-agnostic — they iterate `settings.locales` at build
+ * time, so no postProcess regex patching is required for non-default
+ * languages.
+ *
+ * Loud-failure check: per spec-lock Decision 8 (#1737), abort scaffolding
+ * if the feature template dir is missing or empty. Without this guard,
+ * `copyFeatureFiles` silently no-ops on a missing dir (l-lessons line 790)
+ * and the user receives a half-scaffolded project with `i18n` enabled in
+ * settings but no `[locale]/**` pages.
+ */
+export declare const i18nFeature: FeatureModule;

package/dist/features/i18n.js

@@ -0,0 +1,41 @@
+import fs from "fs-extra";
+import path from "path";
+import { fileURLToPath } from "url";
+/**
+ * i18n feature — gates the locale-prefixed page set.
+ *
+ * Page templates are shipped under `templates/features/i18n/files/pages/`
+ * and copied by `composeFeatures → copyFeatureFiles` whenever `i18n` is in
+ * the selected feature set.
+ *
+ * No injections: header / language-switcher wiring was retired with the
+ * Astro cutover (#1736 / W7A) — `pages/lib/_header-with-defaults.tsx` now
+ * gates `LanguageSwitcher` on `Object.keys(settings.locales).length > 0`.
+ * The pages are locale-agnostic — they iterate `settings.locales` at build
+ * time, so no postProcess regex patching is required for non-default
+ * languages.
+ *
+ * Loud-failure check: per spec-lock Decision 8 (#1737), abort scaffolding
+ * if the feature template dir is missing or empty. Without this guard,
+ * `copyFeatureFiles` silently no-ops on a missing dir (l-lessons line 790)
+ * and the user receives a half-scaffolded project with `i18n` enabled in
+ * settings but no `[locale]/**` pages.
+ */
+export const i18nFeature = (_choices) => {
+    const featuresRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", // up from features/ to src/
+    "..", // up from src/ to package root
+    "templates/features");
+    const pagesDir = path.join(featuresRoot, "i18n/files/pages");
+    // Check existence + directory-ness before readdir so a stray file at this
+    // path produces the same loud error rather than an opaque ENOTDIR.
+    const stat = fs.existsSync(pagesDir) ? fs.statSync(pagesDir) : null;
+    if (!stat || !stat.isDirectory() || fs.readdirSync(pagesDir).length === 0) {
+        throw new Error(`i18n feature template dir is missing or empty: ${pagesDir}\n` +
+            `Expected to find [locale]/index.tsx and [locale]/docs/[...slug].tsx.\n` +
+            `This is a generator bug — please file an issue.`);
+    }
+    return {
+        name: "i18n",
+        injections: [],
+    };
+};

package/dist/features/image-enlarge.d.ts

@@ -0,0 +1,11 @@
+import type { FeatureModule } from "../compose.js";
+/**
+ * Image-enlarge feature.
+ *
+ * W7A (#1736): post-cutover, the image-enlarge island is mounted by the
+ * pages/lib body-end wrapper (always present; runtime-gated via the
+ * always-loaded stub-or-real ImageEnlarge component). Image-enlarge CSS
+ * lives unconditionally in `templates/base/src/styles/global.css` — the
+ * selectors only activate when the runtime mounts the .zd-enlarge-btn.
+ */
+export declare const imageEnlargeFeature: FeatureModule;

package/dist/features/image-enlarge.js

@@ -0,0 +1,13 @@
+/**
+ * Image-enlarge feature.
+ *
+ * W7A (#1736): post-cutover, the image-enlarge island is mounted by the
+ * pages/lib body-end wrapper (always present; runtime-gated via the
+ * always-loaded stub-or-real ImageEnlarge component). Image-enlarge CSS
+ * lives unconditionally in `templates/base/src/styles/global.css` — the
+ * selectors only activate when the runtime mounts the .zd-enlarge-btn.
+ */
+export const imageEnlargeFeature = () => ({
+    name: "imageEnlarge",
+    injections: [],
+});

package/dist/features/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Feature modules for the scaffold composition engine.
+ *
+ * Each module is a FeatureModule function that returns a FeatureDefinition
+ * based on user choices. The definition includes:
+ * - injections: code to inject into shared files at anchor points
+ * - postProcess: optional hook for complex transformations
+ */
+import type { FeatureModule } from "../compose.js";
+/**
+ * All feature modules keyed by their feature name.
+ * The "footer" key is a pseudo-feature triggered by footerNavGroup or footerCopyright.
+ * Order matches FEATURES array in constants.ts for deterministic injection.
+ */
+export declare const featureModules: Record<string, FeatureModule>;

package/dist/features/index.js

@@ -0,0 +1,53 @@
+/**
+ * Feature modules for the scaffold composition engine.
+ *
+ * Each module is a FeatureModule function that returns a FeatureDefinition
+ * based on user choices. The definition includes:
+ * - injections: code to inject into shared files at anchor points
+ * - postProcess: optional hook for complex transformations
+ */
+import { searchFeature } from "./search.js";
+import { footerFeature } from "./footer.js";
+import { sidebarResizerFeature } from "./sidebar-resizer.js";
+import { sidebarToggleFeature } from "./sidebar-toggle.js";
+import { docHistoryFeature } from "./doc-history.js";
+import { llmsTxtFeature } from "./llms-txt.js";
+import { claudeResourcesFeature } from "./claude-resources.js";
+import { designTokenPanelFeature } from "./design-token-panel.js";
+import { i18nFeature } from "./i18n.js";
+import { versioningFeature } from "./versioning.js";
+import { tauriFeature } from "./tauri.js";
+import { tauriDevFeature } from "./tauri-dev.js";
+import { imageEnlargeFeature } from "./image-enlarge.js";
+import { tagGovernanceFeature } from "./tag-governance.js";
+import { footerTaglistFeature } from "./footer-taglist.js";
+import { bodyFootUtilFeature } from "./body-foot-util.js";
+import { docTagsFeature } from "./doc-tags.js";
+/**
+ * All feature modules keyed by their feature name.
+ * The "footer" key is a pseudo-feature triggered by footerNavGroup or footerCopyright.
+ * Order matches FEATURES array in constants.ts for deterministic injection.
+ */
+export const featureModules = {
+    i18n: i18nFeature,
+    search: searchFeature,
+    // sidebarFilter — built into sidebar-tree.tsx, stays in base
+    claudeResources: claudeResourcesFeature,
+    designTokenPanel: designTokenPanelFeature,
+    sidebarResizer: sidebarResizerFeature,
+    sidebarToggle: sidebarToggleFeature,
+    versioning: versioningFeature,
+    docHistory: docHistoryFeature,
+    bodyFootUtil: bodyFootUtilFeature,
+    llmsTxt: llmsTxtFeature,
+    tauri: tauriFeature,
+    tauriDev: tauriDevFeature,
+    imageEnlarge: imageEnlargeFeature,
+    // skillSymlinker — handled in scaffold.ts
+    // claudeSkills — handled in scaffold.ts (copies zudo-doc-* skills from monorepo)
+    tagGovernance: tagGovernanceFeature,
+    docTags: docTagsFeature,
+    footerTaglist: footerTaglistFeature,
+    footer: footerFeature, // pseudo-feature: triggered by footerNavGroup, footerCopyright, or footerTaglist
+    // changelog — handled in scaffold.ts
+};

package/dist/features/llms-txt.d.ts

@@ -0,0 +1,11 @@
+import type { FeatureModule } from "../compose.js";
+/**
+ * llms-txt feature.
+ *
+ * W7A (#1736): the inject() that previously added `<link rel="alternate">`
+ * tags to `<head>` is dropped per locked spec §6.3 — `_head-with-defaults.tsx`
+ * does not emit those tags today (neither does host). If a follow-up decides
+ * to emit them, add the gated `<link>` rendering inside `_head-with-defaults.tsx`
+ * — not in a feature inject. The plugin itself is wired by `zfb-config-gen.ts`.
+ */
+export declare const llmsTxtFeature: FeatureModule;

package/dist/features/llms-txt.js

@@ -0,0 +1,13 @@
+/**
+ * llms-txt feature.
+ *
+ * W7A (#1736): the inject() that previously added `<link rel="alternate">`
+ * tags to `<head>` is dropped per locked spec §6.3 — `_head-with-defaults.tsx`
+ * does not emit those tags today (neither does host). If a follow-up decides
+ * to emit them, add the gated `<link>` rendering inside `_head-with-defaults.tsx`
+ * — not in a feature inject. The plugin itself is wired by `zfb-config-gen.ts`.
+ */
+export const llmsTxtFeature = () => ({
+    name: "llmsTxt",
+    injections: [],
+});

package/dist/features/search.d.ts

@@ -0,0 +1,9 @@
+import type { FeatureModule } from "../compose.js";
+/**
+ * Search feature.
+ *
+ * W7A (#1736): post-cutover, `pages/lib/_header-with-defaults.tsx` includes
+ * the search widget unconditionally — no header injection is required.
+ * The search-index plugin is still wired by `zfb-config-gen.ts`.
+ */
+export declare const searchFeature: FeatureModule;

package/dist/features/search.js

@@ -0,0 +1,11 @@
+/**
+ * Search feature.
+ *
+ * W7A (#1736): post-cutover, `pages/lib/_header-with-defaults.tsx` includes
+ * the search widget unconditionally — no header injection is required.
+ * The search-index plugin is still wired by `zfb-config-gen.ts`.
+ */
+export const searchFeature = () => ({
+    name: "search",
+    injections: [],
+});

package/dist/features/sidebar-resizer.d.ts

@@ -0,0 +1,14 @@
+import type { FeatureModule } from "../compose.js";
+/**
+ * Sidebar-resizer feature.
+ *
+ * W7A (#1736): post-cutover, sidebar resizer pre-paint scripts and runtime
+ * initialization are runtime-gated on `settings.sidebarResizer` inside the
+ * pages/lib wrappers — no doc-layout injection is required.
+ *
+ * NOTE: spec-lock §6.5 flagged a pre-paint FOUC question for the
+ * `applySidebarWidth` IIFE that previously ran inline in the layout `<head>`.
+ * The post-cutover model relies on the pages/lib head wrapper emitting the
+ * inline script (when present); this feature module no longer injects it.
+ */
+export declare const sidebarResizerFeature: FeatureModule;

package/dist/features/sidebar-resizer.js

@@ -0,0 +1,16 @@
+/**
+ * Sidebar-resizer feature.
+ *
+ * W7A (#1736): post-cutover, sidebar resizer pre-paint scripts and runtime
+ * initialization are runtime-gated on `settings.sidebarResizer` inside the
+ * pages/lib wrappers — no doc-layout injection is required.
+ *
+ * NOTE: spec-lock §6.5 flagged a pre-paint FOUC question for the
+ * `applySidebarWidth` IIFE that previously ran inline in the layout `<head>`.
+ * The post-cutover model relies on the pages/lib head wrapper emitting the
+ * inline script (when present); this feature module no longer injects it.
+ */
+export const sidebarResizerFeature = () => ({
+    name: "sidebarResizer",
+    injections: [],
+});

package/dist/features/sidebar-toggle.d.ts

@@ -0,0 +1,13 @@
+import type { FeatureModule } from "../compose.js";
+/**
+ * Sidebar-toggle feature.
+ *
+ * W7A (#1736): post-cutover, the sidebar-toggle is hosted by the pages/lib
+ * wrappers which runtime-gate on `settings.sidebarToggle`. The supporting
+ * CSS (toggle button positioning, sidebar transitions, `[data-sidebar-hidden]`
+ * styles) lives unconditionally in `templates/base/src/styles/global.css`
+ * — the selectors only match when the runtime attaches the
+ * `data-sidebar-hidden` attribute or mounts the toggle button, so the cost
+ * to scaffolds without the feature is one inert rule block.
+ */
+export declare const sidebarToggleFeature: FeatureModule;

package/dist/features/sidebar-toggle.js

@@ -0,0 +1,15 @@
+/**
+ * Sidebar-toggle feature.
+ *
+ * W7A (#1736): post-cutover, the sidebar-toggle is hosted by the pages/lib
+ * wrappers which runtime-gate on `settings.sidebarToggle`. The supporting
+ * CSS (toggle button positioning, sidebar transitions, `[data-sidebar-hidden]`
+ * styles) lives unconditionally in `templates/base/src/styles/global.css`
+ * — the selectors only match when the runtime attaches the
+ * `data-sidebar-hidden` attribute or mounts the toggle button, so the cost
+ * to scaffolds without the feature is one inert rule block.
+ */
+export const sidebarToggleFeature = () => ({
+    name: "sidebarToggle",
+    injections: [],
+});

package/dist/features/tag-governance.d.ts

@@ -0,0 +1,14 @@
+import type { FeatureModule } from "../compose.js";
+/**
+ * Tag governance feature.
+ *
+ * Ships the tag audit and suggest scripts. Settings (`tagVocabulary`,
+ * `tagGovernance`) are emitted by `settings-gen.ts`; devDeps and
+ * `tags:audit` / `tags:suggest` package scripts are added in
+ * `scaffold.ts#generatePackageJson`.
+ *
+ * `src/config/tag-vocabulary.ts` and `tag-vocabulary-types.ts` stay in the
+ * base template because `src/utils/tags.ts` and `settings-types.ts` import
+ * from them regardless of whether governance is on.
+ */
+export declare const tagGovernanceFeature: FeatureModule;

package/dist/features/tag-governance.js

@@ -0,0 +1,16 @@
+/**
+ * Tag governance feature.
+ *
+ * Ships the tag audit and suggest scripts. Settings (`tagVocabulary`,
+ * `tagGovernance`) are emitted by `settings-gen.ts`; devDeps and
+ * `tags:audit` / `tags:suggest` package scripts are added in
+ * `scaffold.ts#generatePackageJson`.
+ *
+ * `src/config/tag-vocabulary.ts` and `tag-vocabulary-types.ts` stay in the
+ * base template because `src/utils/tags.ts` and `settings-types.ts` import
+ * from them regardless of whether governance is on.
+ */
+export const tagGovernanceFeature = () => ({
+    name: "tagGovernance",
+    injections: [],
+});

package/dist/features/tauri-dev.d.ts

@@ -0,0 +1,2 @@
+import type { FeatureModule } from "../compose.js";
+export declare const tauriDevFeature: FeatureModule;

package/dist/features/tauri-dev.js

@@ -0,0 +1,25 @@
+import fs from "fs-extra";
+import path from "path";
+export const tauriDevFeature = (choices) => ({
+    name: "tauriDev",
+    injections: [],
+    postProcess: async (targetDir) => {
+        // Patch Cargo.toml package name — use "-dev" suffix to avoid collision with Mode 1 tauri
+        const cargoPath = path.join(targetDir, "src-tauri-dev/Cargo.toml");
+        if (await fs.pathExists(cargoPath)) {
+            let content = await fs.readFile(cargoPath, "utf-8");
+            const safeName = choices.projectName.replace(/[^a-zA-Z0-9_-]/g, "-");
+            content = content.replace(/name = "zudo-doc-dev"/, `name = "${safeName}-dev"`);
+            await fs.writeFile(cargoPath, content);
+        }
+        // Append src-tauri-dev entries to .gitignore
+        const gitignorePath = path.join(targetDir, ".gitignore");
+        if (await fs.pathExists(gitignorePath)) {
+            let content = await fs.readFile(gitignorePath, "utf-8");
+            if (!content.includes("src-tauri-dev/target")) {
+                content += "\n# Tauri dev wrapper build artifacts\nsrc-tauri-dev/target\nsrc-tauri-dev/gen\n";
+                await fs.writeFile(gitignorePath, content);
+            }
+        }
+    },
+});

package/dist/features/tauri.d.ts

@@ -0,0 +1,11 @@
+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.
+ */
+export declare const tauriFeature: FeatureModule;

package/dist/features/tauri.js

@@ -0,0 +1,52 @@
+import fs from "fs-extra";
+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.
+ */
+export const tauriFeature = (choices) => ({
+    name: "tauri",
+    injections: [],
+    postProcess: async (targetDir) => {
+        // Patch Cargo.toml package name
+        const cargoPath = path.join(targetDir, "src-tauri/Cargo.toml");
+        if (await fs.pathExists(cargoPath)) {
+            let content = await fs.readFile(cargoPath, "utf-8");
+            const safeName = choices.projectName.replace(/[^a-zA-Z0-9_-]/g, "-");
+            content = content.replace(/name = "zudo-doc"/, `name = "${safeName}"`);
+            await fs.writeFile(cargoPath, content);
+        }
+        // Patch tauri.conf.json productName, identifier, and beforeDevCommand
+        const confPath = path.join(targetDir, "src-tauri/tauri.conf.json");
+        if (await fs.pathExists(confPath)) {
+            let content = await fs.readFile(confPath, "utf-8");
+            const productName = choices.projectName
+                .split(/[-_]/)
+                .map((s) => s.charAt(0).toUpperCase() + s.slice(1))
+                .join("");
+            const identifier = `com.example.${choices.projectName.replace(/[^a-zA-Z0-9-]/g, "-")}`;
+            content = content.replace(/"productName": "ZudoDoc"/, `"productName": "${productName}"`);
+            content = content.replace(/"identifier": "com.zudolab.zudo-doc"/, `"identifier": "${identifier}"`);
+            // Patch beforeDevCommand for the chosen package manager
+            const devCmd = choices.packageManager === "npm" || choices.packageManager === "bun"
+                ? `${choices.packageManager} run dev`
+                : `${choices.packageManager} dev`;
+            content = content.replace(/"beforeDevCommand": "pnpm dev"/, `"beforeDevCommand": "${devCmd}"`);
+            await fs.writeFile(confPath, content);
+        }
+        // Append src-tauri entries to .gitignore
+        const gitignorePath = path.join(targetDir, ".gitignore");
+        if (await fs.pathExists(gitignorePath)) {
+            let content = await fs.readFile(gitignorePath, "utf-8");
+            if (!content.includes("src-tauri/target")) {
+                content += "\n# Tauri build artifacts\nsrc-tauri/target\nsrc-tauri/gen\n";
+                await fs.writeFile(gitignorePath, content);
+            }
+        }
+    },
+});

package/dist/features/versioning.d.ts

@@ -0,0 +1,27 @@
+import type { FeatureModule } from "../compose.js";
+/**
+ * Versioning feature.
+ *
+ * W7A (#1736): post-cutover, the pages/lib wrappers gate `VersionSwitcher`
+ * and `VersionBanner` on `settings.versions`. Doc-layout flow is handled by
+ * route enumerators + `_inline-version-switcher.tsx`. The .astro inject
+ * calls that used to wire this in have been retired (they targeted dead
+ * `src/layouts/doc-layout.astro` + `src/components/header.astro` anchors).
+ *
+ * W7C (#1738): the versioning feature ships pages under
+ * `templates/features/versioning/files/pages/`:
+ *
+ *   docs/versions.tsx                       (always — versioning gate only)
+ *   v/[version]/docs/[...slug].tsx          (always — versioning gate only)
+ *   v/[version]/ja/docs/[...slug].tsx       (i18n + versioning — see below)
+ *   [locale]/docs/versions.tsx              (i18n + versioning)
+ *
+ * `copyFeatureFiles` (compose.ts) auto-copies everything under `files/`.
+ * postProcess removes the i18n-gated subset when i18n is OFF so single-
+ * locale projects don't ship orphan routes.
+ *
+ * Note: `v/[version]/ja/docs/[...slug].tsx` hardcodes `ja` per W2 spec-lock
+ * Decision 9 / §6.4 — matches main verbatim. Future generalization to
+ * `[locale]` is deferred (maintainer-question follow-up).
+ */
+export declare const versioningFeature: FeatureModule;

package/dist/features/versioning.js

@@ -0,0 +1,43 @@
+import fs from "fs-extra";
+import path from "path";
+/**
+ * Versioning feature.
+ *
+ * W7A (#1736): post-cutover, the pages/lib wrappers gate `VersionSwitcher`
+ * and `VersionBanner` on `settings.versions`. Doc-layout flow is handled by
+ * route enumerators + `_inline-version-switcher.tsx`. The .astro inject
+ * calls that used to wire this in have been retired (they targeted dead
+ * `src/layouts/doc-layout.astro` + `src/components/header.astro` anchors).
+ *
+ * W7C (#1738): the versioning feature ships pages under
+ * `templates/features/versioning/files/pages/`:
+ *
+ *   docs/versions.tsx                       (always — versioning gate only)
+ *   v/[version]/docs/[...slug].tsx          (always — versioning gate only)
+ *   v/[version]/ja/docs/[...slug].tsx       (i18n + versioning — see below)
+ *   [locale]/docs/versions.tsx              (i18n + versioning)
+ *
+ * `copyFeatureFiles` (compose.ts) auto-copies everything under `files/`.
+ * postProcess removes the i18n-gated subset when i18n is OFF so single-
+ * locale projects don't ship orphan routes.
+ *
+ * Note: `v/[version]/ja/docs/[...slug].tsx` hardcodes `ja` per W2 spec-lock
+ * Decision 9 / §6.4 — matches main verbatim. Future generalization to
+ * `[locale]` is deferred (maintainer-question follow-up).
+ */
+export const versioningFeature = (choices) => ({
+    name: "versioning",
+    postProcess: async (targetDir) => {
+        if (!choices.features.includes("i18n")) {
+            const localeVersions = path.join(targetDir, "pages", "[locale]", "docs", "versions.tsx");
+            if (await fs.pathExists(localeVersions)) {
+                await fs.remove(localeVersions);
+            }
+            const jaVersionedDocs = path.join(targetDir, "pages", "v", "[version]", "ja");
+            if (await fs.pathExists(jaVersionedDocs)) {
+                await fs.remove(jaVersionedDocs);
+            }
+        }
+    },
+    injections: [],
+});

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,150 @@
+import path from "path";
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+import { parseArgs, printHelp, validateArgs } from "./cli.js";
+import { FEATURES } from "./constants.js";
+import { loadPreset } from "./preset.js";
+import { runPrompts } from "./prompts.js";
+import { scaffold } from "./scaffold.js";
+import { installDependencies } from "./utils.js";
+async function main() {
+    const args = parseArgs();
+    // Handle --help
+    if (args.help) {
+        printHelp();
+        process.exit(0);
+    }
+    // Validate args
+    const error = validateArgs(args);
+    if (error) {
+        console.error(pc.red(`Error: ${error}`));
+        process.exit(1);
+    }
+    console.log();
+    p.intro(pc.bgCyan(pc.black(" create-zudo-doc ")));
+    // Build PartialChoices: preset first, then CLI args override
+    const prefilled = {};
+    // Load preset if provided (base layer — CLI flags override below)
+    if (args.preset) {
+        try {
+            const presetChoices = loadPreset(args.preset);
+            Object.assign(prefilled, presetChoices);
+        }
+        catch (err) {
+            p.log.error(`Failed to load preset: ${err instanceof Error ? err.message : String(err)}`);
+            process.exit(1);
+        }
+    }
+    // CLI args override preset values
+    if (args.name)
+        prefilled.projectName = args.name;
+    if (args.lang)
+        prefilled.defaultLang = args.lang;
+    if (args.colorSchemeMode)
+        prefilled.colorSchemeMode = args.colorSchemeMode;
+    if (args.scheme) {
+        prefilled.colorSchemeMode = prefilled.colorSchemeMode ?? "single";
+        prefilled.singleScheme = args.scheme;
+    }
+    if (args.lightScheme)
+        prefilled.lightScheme = args.lightScheme;
+    if (args.darkScheme)
+        prefilled.darkScheme = args.darkScheme;
+    if (args.defaultMode !== undefined)
+        prefilled.defaultMode = args.defaultMode;
+    if (args.respectSystemPreference !== undefined) {
+        prefilled.respectPrefersColorScheme = args.respectSystemPreference;
+    }
+    if (args.pm)
+        prefilled.packageManager = args.pm;
+    if (args.githubUrl !== undefined)
+        prefilled.githubUrl = args.githubUrl;
+    // Build feature overrides from explicit flags — driven by FEATURES constant
+    const featureFlags = {};
+    for (const f of FEATURES) {
+        const val = args[f.value];
+        if (val !== undefined)
+            featureFlags[f.value] = val;
+    }
+    if (Object.keys(featureFlags).length > 0) {
+        prefilled.features = { ...prefilled.features, ...featureFlags };
+    }
+    // With --yes or --preset: fill all unspecified options with defaults
+    if (args.yes || args.preset) {
+        prefilled.projectName ??= "my-docs";
+        prefilled.defaultLang ??= "en";
+        prefilled.colorSchemeMode ??= "light-dark";
+        if (prefilled.colorSchemeMode === "light-dark") {
+            prefilled.lightScheme ??= "Default Light";
+            prefilled.darkScheme ??= "Default Dark";
+            prefilled.defaultMode ??= "dark";
+            prefilled.respectPrefersColorScheme ??= true;
+        }
+        else {
+            prefilled.singleScheme ??= "Dracula";
+        }
+        prefilled.packageManager ??= "pnpm";
+        prefilled.githubUrl ??= "";
+        // For features: set defaults for any not explicitly specified
+        const featureDefaults = {};
+        for (const f of FEATURES) {
+            featureDefaults[f.value] = f.default;
+        }
+        prefilled.features = { ...featureDefaults, ...prefilled.features };
+    }
+    const choices = await runPrompts(prefilled);
+    const targetDir = path.resolve(process.cwd(), choices.projectName);
+    const s = p.spinner();
+    s.start("Scaffolding project...");
+    try {
+        await scaffold(choices);
+        s.stop("Project scaffolded!");
+    }
+    catch (err) {
+        s.stop("Scaffolding failed!");
+        p.log.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+    // Install dependencies
+    let shouldInstall;
+    if (args.install !== undefined) {
+        shouldInstall = args.install;
+    }
+    else if (args.yes || args.preset) {
+        // In non-interactive mode, default to installing dependencies
+        shouldInstall = true;
+    }
+    else {
+        const result = await p.confirm({
+            message: "Install dependencies?",
+            initialValue: true,
+        });
+        if (p.isCancel(result)) {
+            p.outro(`Done! cd ${choices.projectName} and install dependencies manually.`);
+            return;
+        }
+        shouldInstall = result;
+    }
+    if (shouldInstall) {
+        const s2 = p.spinner();
+        s2.start(`Installing dependencies with ${choices.packageManager}...`);
+        try {
+            installDependencies(targetDir, choices.packageManager);
+            s2.stop("Dependencies installed!");
+        }
+        catch {
+            s2.stop("Installation failed. Run install manually.");
+        }
+    }
+    p.outro(`${pc.green("Done!")} Your project is ready at ${pc.cyan(choices.projectName)}`);
+    console.log();
+    console.log(`  ${pc.bold("Next steps:")}`);
+    console.log(`  cd ${choices.projectName}`);
+    const runCmd = choices.packageManager === "npm" ? "npm run" : choices.packageManager;
+    console.log(`  ${runCmd} dev`);
+    console.log();
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});