create-zudo-doc 2.5.1 → 3.1.0

package/README.md

@@ -31,7 +31,7 @@ pnpm create zudo-doc my-docs --yes
 # Fully specified, non-interactive
 pnpm create zudo-doc my-docs \
   --lang ja \
-  --scheme Dracula \
+  --scheme "Default Dark" \
   --no-i18n \
   --search \
   --pm pnpm \
@@ -109,11 +109,11 @@ pnpm create zudo-doc my-docs \
   --install \
   --yes
 
-# Light/dark color scheme with Catppuccin pairings
+# Light/dark color scheme with the Default pairing
 pnpm create zudo-doc my-docs \
   --color-scheme-mode light-dark \
-  --light-scheme "Catppuccin Latte" \
-  --dark-scheme "Catppuccin Mocha" \
+  --light-scheme "Default Light" \
+  --dark-scheme "Default Dark" \
   --default-mode dark \
   --yes
 
@@ -130,7 +130,7 @@ await createZudoDoc({
   projectName: "my-docs",
   defaultLang: "en",
   colorSchemeMode: "single",
-  singleScheme: "Dracula",
+  singleScheme: "Default Dark",
   features: ["search", "sidebarFilter", "tagGovernance"],
   packageManager: "pnpm",
   install: true,

package/dist/api.js

@@ -1,4 +1,5 @@
 import path from "path";
+import { SINGLE_SCHEMES } from "./constants.js";
 import { scaffold } from "./scaffold.js";
 import { initGitRepo, installDependencies, validateProjectName } from "./utils.js";
 export async function createZudoDoc(options) {
@@ -6,6 +7,21 @@ export async function createZudoDoc(options) {
     const nameError = validateProjectName(rest.projectName);
     if (nameError)
         throw new Error(`Invalid projectName: ${nameError}`);
+    // Validate scheme names like the CLI (cli.ts) and preset (preset.ts) paths do.
+    // Only `Default Light`/`Default Dark` exist post-catalog-drop (#2619); an
+    // unvalidated name here would be written verbatim into settings.ts and throw
+    // "Unknown color scheme" at the generated site's build — the exact failure
+    // this epic set out to eliminate. This is the last scaffolding entry point
+    // that lacked the guard.
+    for (const [label, value] of [
+        ["color scheme", rest.singleScheme],
+        ["light scheme", rest.lightScheme],
+        ["dark scheme", rest.darkScheme],
+    ]) {
+        if (value && !SINGLE_SCHEMES.includes(value)) {
+            throw new Error(`Unknown ${label} "${value}"`);
+        }
+    }
     const choices = { ...rest, defaultLang: rest.defaultLang ?? "en" };
     await scaffold(choices);
     const targetDir = path.resolve(process.cwd(), choices.projectName);

package/dist/cli.js

@@ -110,12 +110,7 @@ ${pc.bold("Examples:")}
   create-zudo-doc my-docs --yes
 
   ${pc.dim("# Fully specified")}
-  create-zudo-doc my-docs --lang ja --scheme Dracula --no-i18n --pm pnpm --install
-
-  ${pc.dim("# Light/dark mode with custom schemes")}
-  create-zudo-doc my-docs --color-scheme-mode light-dark \\
-    --light-scheme "GitHub Light" --dark-scheme "GitHub Dark" \\
-    --default-mode dark --yes
+  create-zudo-doc my-docs --lang ja --scheme "Default Dark" --no-i18n --pm pnpm --install
 `);
 }
 export function validateArgs(args) {

package/dist/constants.js

@@ -1,73 +1,12 @@
 export const LIGHT_DARK_PAIRINGS = [
     { light: "Default Light", dark: "Default Dark", label: "Default" },
-    { light: "GitHub Light", dark: "GitHub Dark", label: "GitHub" },
-    { light: "Catppuccin Latte", dark: "Catppuccin Mocha", label: "Catppuccin" },
-    { light: "Solarized Light", dark: "Solarized Dark", label: "Solarized" },
-    { light: "Rose Pine Dawn", dark: "Rose Pine", label: "Rosé Pine" },
-    { light: "Atom One Light", dark: "Atom One Dark", label: "Atom One" },
-    { light: "Everforest Light", dark: "Everforest Dark", label: "Everforest" },
-    { light: "Gruvbox Light", dark: "Gruvbox Dark", label: "Gruvbox" },
-    { light: "Ayu Light", dark: "Ayu Dark", label: "Ayu" },
-];
-// All available single schemes (dark ones most popular first)
-export const SINGLE_SCHEMES = [
-    "Default Dark",
-    "Dracula",
-    "Catppuccin Mocha",
-    "GitHub Dark",
-    "Nord",
-    "TokyoNight",
-    "Gruvbox Dark",
-    "Atom One Dark",
-    "Rose Pine",
-    "Solarized Dark",
-    "Material Ocean",
-    "Monokai Pro",
-    "Everforest Dark",
-    "Kanagawa Wave",
-    "Night Owl",
-    "Ayu Dark",
-    "VS Code Dark+",
-    "Doom One",
-    "Challenger Deep",
-    "Catppuccin Frappe",
-    "Catppuccin Macchiato",
-    "Gruvbox Dark Hard",
-    "Rose Pine Moon",
-    "GitHub Dark Dimmed",
-    "Ayu Mirage",
-    "Material Darker",
-    "Material Dark",
-    "Monokai Remastered",
-    "Monokai Vivid",
-    "Monokai Soda",
-    "Solarized Dark Higher Contrast",
-    "Gruvbox Material Dark",
-    "Kanagawa Dragon",
-    // Light schemes
-    "Default Light",
-    "GitHub Light",
-    "Catppuccin Latte",
-    "Solarized Light",
-    "Rose Pine Dawn",
-    "Atom One Light",
-    "Everforest Light",
-    "Gruvbox Light",
-    "Ayu Light",
 ];
+// All available single schemes (dark-first ordering — asserted by the host
+// sync test).
+export const SINGLE_SCHEMES = ["Default Dark", "Default Light"];
 // Light-only subset of SINGLE_SCHEMES. Used by the preset generator to populate
 // the "Light scheme" dropdown (dark schemes are derived as SINGLE_SCHEMES minus these).
-export const LIGHT_SCHEMES = [
-    "Default Light",
-    "GitHub Light",
-    "Catppuccin Latte",
-    "Solarized Light",
-    "Rose Pine Dawn",
-    "Atom One Light",
-    "Everforest Light",
-    "Gruvbox Light",
-    "Ayu Light",
-];
+export const LIGHT_SCHEMES = ["Default Light"];
 export const SUPPORTED_LANGS = [
     { value: "en", label: "English" },
     { value: "ja", label: "Japanese" },
@@ -167,7 +106,7 @@ export const FEATURES = [
     {
         value: "skillSymlinker",
         label: "Skill symlinker",
-        hint: "Symlink documentation skills",
+        hint: "Symlink documentation skills into Claude Code or Codex",
         default: false,
         cliFlag: "skill-symlinker",
     },

package/dist/index.js

@@ -89,7 +89,7 @@ async function main() {
             prefilled.respectPrefersColorScheme ??= true;
         }
         else {
-            prefilled.singleScheme ??= "Dracula";
+            prefilled.singleScheme ??= "Default Dark";
         }
         prefilled.packageManager ??= "pnpm";
         prefilled.githubUrl ??= "";

package/dist/prompts.js

@@ -1,5 +1,5 @@
 import * as p from "@clack/prompts";
-import { LIGHT_DARK_PAIRINGS, SINGLE_SCHEMES, FEATURES, SUPPORTED_LANGS } from "./constants.js";
+import { SINGLE_SCHEMES, FEATURES, SUPPORTED_LANGS } from "./constants.js";
 import { validateProjectName } from "./utils.js";
 export async function runPrompts(prefilled = {}) {
     // 1. Project name
@@ -88,48 +88,9 @@ export async function runPrompts(prefilled = {}) {
             darkScheme = prefilled.darkScheme;
         }
         else {
-            const pairingChoice = await p.select({
-                message: "Choose a light/dark pairing:",
-                options: [
-                    ...LIGHT_DARK_PAIRINGS.map((pair) => ({
-                        value: pair.label,
-                        label: `${pair.light} + ${pair.dark}`,
-                        hint: pair.label,
-                    })),
-                    {
-                        value: "custom",
-                        label: "Pick individually",
-                        hint: "Choose light and dark schemes separately",
-                    },
-                ],
-            });
-            if (p.isCancel(pairingChoice))
-                process.exit(0);
-            if (pairingChoice === "custom") {
-                const lightSchemes = SINGLE_SCHEMES.filter((s) => ["Light", "Latte", "Dawn"].some((k) => s.includes(k)));
-                const darkSchemes = SINGLE_SCHEMES.filter((s) => !["Light", "Latte", "Dawn"].some((k) => s.includes(k)));
-                const light = await p.select({
-                    message: "Choose light scheme:",
-                    options: lightSchemes.map((s) => ({ value: s, label: s })),
-                });
-                if (p.isCancel(light))
-                    process.exit(0);
-                lightScheme = light;
-                const dark = await p.select({
-                    message: "Choose dark scheme:",
-                    options: darkSchemes.map((s) => ({ value: s, label: s })),
-                });
-                if (p.isCancel(dark))
-                    process.exit(0);
-                darkScheme = dark;
-            }
-            else {
-                const pairing = LIGHT_DARK_PAIRINGS.find((pair) => pair.label === pairingChoice);
-                if (pairing) {
-                    lightScheme = pairing.light;
-                    darkScheme = pairing.dark;
-                }
-            }
+            // Only the Default pairing exists — auto-assign, no prompt.
+            lightScheme = "Default Light";
+            darkScheme = "Default Dark";
         }
         // Default mode
         if (prefilled.defaultMode === undefined) {

package/dist/scaffold.d.ts

@@ -11,5 +11,5 @@ export { getSecondaryLang };
  *
  * Bumped in lockstep by scripts/release-create-zudo-doc.sh.
  */
-export declare const ZUDO_DOC_PIN = "^2.5.1";
+export declare const ZUDO_DOC_PIN = "^3.1.0";
 export declare function scaffold(choices: UserChoices): Promise<void>;

package/dist/scaffold.js

@@ -18,7 +18,7 @@ export { getSecondaryLang };
  *
  * Bumped in lockstep by scripts/release-create-zudo-doc.sh.
  */
-export const ZUDO_DOC_PIN = "^2.5.1";
+export const ZUDO_DOC_PIN = "^3.1.0";
 /**
  * Files in `templates/base/**` that must never be copied into a generated
  * project. Each entry is matched against the path relative to `templates/base/`
@@ -333,12 +333,14 @@ export async function scaffold(choices) {
     // skill a user later installs under a matching name. The skill name is
     // deterministic (always `<projectName>-wisdom`, matching DEFAULT_SKILL_NAME
     // in scripts/setup-doc-skill.sh and the package name), so these entries match
-    // the directory the script creates. The docs-ja symlink only exists for i18n
-    // projects (the script creates it conditionally), so gate that line on i18n.
+    // the directory the script creates. The setup script can target either
+    // .claude or .codex, so ignore both possible generated directories. The
+    // docs-ja symlink only exists for i18n projects (the script creates it
+    // conditionally), so gate those lines on i18n.
     if (choices.features.includes("skillSymlinker")) {
-        gitignoreLines.push("# Generated doc-lookup skill", `.claude/skills/${choices.projectName}-wisdom/SKILL.md`, `.claude/skills/${choices.projectName}-wisdom/docs`);
+        gitignoreLines.push("# Generated doc-lookup skill", `.claude/skills/${choices.projectName}-wisdom/SKILL.md`, `.claude/skills/${choices.projectName}-wisdom/docs`, `.codex/skills/${choices.projectName}-wisdom/SKILL.md`, `.codex/skills/${choices.projectName}-wisdom/docs`);
         if (choices.features.includes("i18n")) {
-            gitignoreLines.push(`.claude/skills/${choices.projectName}-wisdom/docs-ja`);
+            gitignoreLines.push(`.claude/skills/${choices.projectName}-wisdom/docs-ja`, `.codex/skills/${choices.projectName}-wisdom/docs-ja`);
         }
         gitignoreLines.push("");
     }
@@ -493,13 +495,16 @@ function generatePackageJson(choices) {
         // class-candidate scanning through symlinked project trees
         // (zudolab/zudo-doc#2511), adopted in lockstep with the root package.json
         // pins. No consumer-facing / CLI change.
-        // next.76 (current pin): routine toolchain bump from next.75, adopted in
+        // next.76: routine toolchain bump from next.75, adopted in
         // lockstep with the root package.json pins. No consumer-facing / CLI change.
-        "@takazudo/zfb": "0.1.0-next.76",
-        "@takazudo/zfb-runtime": "0.1.0-next.76",
+        // next.77 (current pin): router persistence/history fixes and runtime
+        // island remount support, adopted in lockstep with the root package.json
+        // pins. No scaffold API change.
+        "@takazudo/zfb": "0.1.0-next.77",
+        "@takazudo/zfb-runtime": "0.1.0-next.77",
         // zfb-adapter-cloudflare — required for any route with `prerender = false`.
         // Pinned in lockstep with @takazudo/zfb.
-        "@takazudo/zfb-adapter-cloudflare": "0.1.0-next.76",
+        "@takazudo/zfb-adapter-cloudflare": "0.1.0-next.77",
         // @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
@@ -582,7 +587,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"] = "^2.5.1";
+        deps["@takazudo/zudo-doc-history-server"] = "^3.1.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).
@@ -593,7 +598,7 @@ function generatePackageJson(choices) {
     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.2";
+        deps["@takazudo/zdtp"] = "0.4.5";
     }
     if (choices.features.includes("tagGovernance")) {
         // gray-matter is already in `deps` unconditionally (base template uses it),
@@ -635,6 +640,12 @@ function generatePackageJson(choices) {
         scripts["setup:doc-skill"] = "bash scripts/setup-doc-skill.sh";
         scripts["setup:doc-skill-silent"] =
             "bash scripts/setup-doc-skill.sh --silent";
+        scripts["setup:doc-skill:claude"] =
+            "bash scripts/setup-doc-skill.sh --target claude";
+        scripts["setup:doc-skill:codex"] =
+            "bash scripts/setup-doc-skill.sh --target codex";
+        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;
     // claudeSkills ships the zudo-doc-version-bump skill, whose release workflow

package/dist/settings-gen.js

@@ -35,15 +35,15 @@ export function generateSettingsFile(choices) {
     lines.push(``);
     lines.push(`export const settings = {`);
     if (choices.colorSchemeMode === "single") {
-        lines.push(`  colorScheme: ${JSON.stringify(choices.singleScheme ?? "Dracula")},`);
+        lines.push(`  colorScheme: ${JSON.stringify(choices.singleScheme ?? "Default Dark")},`);
         lines.push(`  colorMode: false as ColorModeConfig | false,`);
     }
     else {
-        lines.push(`  colorScheme: ${JSON.stringify(choices.darkScheme ?? "GitHub Dark")},`);
+        lines.push(`  colorScheme: ${JSON.stringify(choices.darkScheme ?? "Default Dark")},`);
         lines.push(`  colorMode: {`);
         lines.push(`    defaultMode: ${JSON.stringify(choices.defaultMode ?? "dark")},`);
-        lines.push(`    lightScheme: ${JSON.stringify(choices.lightScheme ?? "GitHub Light")},`);
-        lines.push(`    darkScheme: ${JSON.stringify(choices.darkScheme ?? "GitHub Dark")},`);
+        lines.push(`    lightScheme: ${JSON.stringify(choices.lightScheme ?? "Default Light")},`);
+        lines.push(`    darkScheme: ${JSON.stringify(choices.darkScheme ?? "Default Dark")},`);
         lines.push(`    respectPrefersColorScheme: ${choices.respectPrefersColorScheme ?? true},`);
         lines.push(`  } satisfies ColorModeConfig as ColorModeConfig | false,`);
     }
@@ -130,6 +130,7 @@ export function generateSettingsFile(choices) {
     else {
         lines.push(`  llmsTxt: false,`);
     }
+    lines.push(`  changelogs: false,`);
     lines.push(`  math: false,`);
     lines.push(`  cjkFriendly: ${choices.cjkFriendly ?? false} as boolean,`);
     lines.push(`  onBrokenMarkdownLinks: "warn" as "warn" | "error" | "ignore",`);

package/package.json

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

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

@@ -1,21 +1,30 @@
 /**
  * Project-side color-scheme helpers.
  *
- * The MECHANISM (palette→CSS injection logic) now lives in the package:
+ * 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 (palette values,
+ * 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 ColorRef,
+  type OKLCH,
+  type StateRole,
+  type SemanticKey,
+  type RampRef,
+  type Ramps,
+  type ModeMap,
   type ColorScheme,
-  SEMANTIC_DEFAULTS,
+  type CssEmitScope,
+  STATE_ROLES,
+  SEMANTIC_KEYS,
+  SEMANTIC_RAMP_DEFAULTS,
   SEMANTIC_CSS_NAMES,
-  resolveColor,
+  resolveRampRef,
   resolveSemanticColors,
   schemeToCssPairs,
   generateCssCustomProperties as generateCssCustomPropertiesFromScheme,