create-zudo-doc 4.2.0 → 4.2.1

package/dist/scaffold.d.ts

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

package/dist/scaffold.js

@@ -24,7 +24,7 @@ export { getSecondaryLang };
  *
  * Bumped in lockstep by scripts/release-create-zudo-doc.sh.
  */
-export const ZUDO_DOC_PIN = "^4.2.0";
+export const ZUDO_DOC_PIN = "^4.2.1";
 /**
  * Files in `templates/base/**` that must not be copied by the unconditional
  * base mirror. Each entry is matched against the path relative to
@@ -660,7 +660,7 @@ function generatePackageJson(choices) {
         // 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"] = "^4.2.0";
+        deps["@takazudo/zudo-doc-history-server"] = "^4.2.1";
         // 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).

package/package.json

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

package/templates/features/claudeSkills/files/.claude/skills/zudo-doc-design-system/SKILL.md

@@ -53,6 +53,10 @@ Read ONLY the section relevant to your task. Apply its rules strictly.
 - **NEVER** use hardcoded hex values in components
 - Both bundled schemes (`Default Light`, `Default Dark`) share the same ramps; only their per-mode wiring (`map`) differs. This project doesn't own a copy of the ramp/map definitions — they're package-owned, shipped compiled under `node_modules/@takazudo/zudo-doc/dist/color-schemes-defaults/`. Only override the `@theme` tokens you actually need to change, in `src/styles/global.css`
 
+### Palette index convention
+
+Within Tier 1, the `base` and `accent` ramps are addressed by a plain numeric index — `0` is always the lightest stop, climbing toward the darkest (`base` runs `0`-`4`, `accent` runs `0`-`2`). The `state` ramp breaks this pattern on purpose: its four roles (`danger`, `success`, `warning`, `info`) are addressed by name, never by index, since a numeric position is meaningless for a role that isn't part of a light-to-dark progression. When a new ramp is ever introduced, keep this split — a tonal progression gets an index, a set of standalone semantic roles gets names.
+
 ### Search & highlight tokens (role-split)
 
 Highlight roles are deliberately split across dedicated semantic tokens — do **not** share one token across unrelated highlight UIs.

package/templates/features/claudeSkills/files/.claude/skills/zudo-doc-version-bump/SKILL.md

@@ -118,7 +118,13 @@ Unlike a per-version file, a scaffolded changelog is a single `index.mdx` page.
 release as a section **above** the existing ones (newest first), using only the categories that
 have entries.
 
-### English changelog (`src/content/docs/changelog/index.mdx`)
+### Default-language changelog (`src/content/docs/changelog/index.mdx`)
+
+This is the project's PRIMARY changelog page. It was seeded in whichever language the project's
+`defaultLang` setting is, so use whichever heading set below already matches the page — don't
+assume English.
+
+**If the page uses English headings:**
 
 ```mdx
 ## {NEW_VERSION}
@@ -143,9 +149,7 @@ have entries.
 On the very first bump, the page still has the scaffold's starter `## Unreleased` section —
 replace that heading with `## {NEW_VERSION}` rather than adding a second heading.
 
-### Japanese changelog (`src/content/docs-ja/changelog/index.mdx`)
-
-Only applies when i18n is enabled (the `docs-ja` directory exists). If it doesn't, skip this file.
+**If the page uses Japanese headings:**
 
 ```mdx
 ## {NEW_VERSION}
@@ -167,7 +171,21 @@ Only applies when i18n is enabled (the `docs-ja` directory exists). If it doesn'
 - Description (commit-hash)
 ```
 
-On the first bump, replace the starter `## 未リリース` heading the same way.
+On the very first bump, the page still has the scaffold's starter `## 未リリース` section —
+replace that heading with `## {NEW_VERSION}` the same way.
+
+### Other-locale changelog
+
+Only applies when i18n is enabled — i.e. a second content directory exists alongside the primary
+one. Which locale that is depends on the project's `defaultLang`: for an English-default project
+this is the Japanese changelog at `src/content/docs-ja/changelog/index.mdx`; for a
+Japanese-default project this is the English changelog under the `docs-en` directory instead. If
+the other-locale changelog page doesn't exist, skip this file.
+
+Use the OTHER heading set from above (the one you didn't use for the default-language page —
+English primary means Japanese secondary, and vice versa), following the same "add a new
+`## {NEW_VERSION}` section above the existing ones" rule, and replace that page's own starter
+heading on the very first bump.
 
 Rules: