create-zudo-doc 4.2.0 → 4.3.0

package/dist/claude-md-gen.js

@@ -21,7 +21,7 @@ export function generateCLAUDEFile(choices) {
     lines.push(`- **MDX** — content format, authored under \`src/content/\``);
     lines.push(`- **Tailwind CSS v4** — via \`@tailwindcss/vite\``);
     lines.push(`- **Preact** — for interactive islands only (with compat mode for React API)`);
-    lines.push(`- **Shiki** — package-owned code highlighting with the configured light/dark theme pair`);
+    lines.push("- **zfb semantic highlighting** — native build-time fenced-code rendering plus lazy `@takazudo/zfb-md-wasm` for HtmlPreview; both emit `hi-*` classes resolved through `--zd-syntax-*` design tokens");
     lines.push(`- **@takazudo/zudo-doc** — the package that owns everything: layout, chrome, islands, default \`@theme\` design tokens, and (via \`packageOwnedRoutes\`, on by default) the doc routes themselves`);
     lines.push(``);
     // Commands
@@ -31,6 +31,7 @@ export function generateCLAUDEFile(choices) {
     if (choices.features.includes("docHistory")) {
         lines.push(`- \`${pmRunCommand(pm, "dev")}\` — runs the zfb dev server (port 4321) and the doc-history API server (port 4322) concurrently via \`run-p\` (\`${pmRunCommand(pm, "dev:zfb")}\` / \`${pmRunCommand(pm, "dev:history")}\` individually)`);
         lines.push(`- \`${pmRunCommand(pm, "dev:network")}\` — same, but zfb binds \`--host 0.0.0.0\` for LAN access (\`${pmRunCommand(pm, "dev:zfb:network")}\` individually); the doc-history server stays loopback-only and LAN clients reach it through zfb's \`/doc-history/*\` dev proxy`);
+        lines.push(`- **Trusted networks only:** this also serves your git doc-history — including UNPUBLISHED local commits — to anyone on the LAN via the \`/doc-history/*\` proxy`);
         lines.push(`- \`run-p\` swallows trailing args, so other zfb flags don't forward through \`${pmRunCommand(pm, "dev")}\` — pass them directly instead: \`${pm} run dev:zfb -- <flags>\``);
     }
     else {

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.3.0";
 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.3.0";
 /**
  * Files in `templates/base/**` that must not be copied by the unconditional
  * base mirror. Each entry is matched against the path relative to
@@ -590,9 +590,6 @@ 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",
         mermaid: "^11.12.3",
         "remark-cjk-friendly": "^2.0.1",
@@ -660,7 +657,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.3.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).

package/dist/zfb-config-gen.js

@@ -60,6 +60,7 @@ export const DEFAULT_MIRROR = {
     findInPage: false,
     dynamicPageTransition: false,
     docHistory: false,
+    docHistoryExclude: [],
     bodyFootUtilArea: false,
     versions: false,
     claudeResources: false,

package/package.json

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

package/templates/base/scripts/setup-doc-skill.sh

@@ -81,6 +81,8 @@ REPO_ROOT="$(git -C "$ROOT_DIR" worktree list | head -1 | awk '{print $1}')"
 # worktree root, above) reconstructs the equivalent path there even when
 # running from inside a different worktree.
 PROJECT_PREFIX="$(git -C "$ROOT_DIR" rev-parse --show-prefix)"
+MAIN_PROJECT_DIR="$REPO_ROOT/${PROJECT_PREFIX}"
+MAIN_PROJECT_DIR="${MAIN_PROJECT_DIR%/}"
 REPO_DOCS_DIR="$REPO_ROOT/${PROJECT_PREFIX}src/content/docs"
 REPO_DOCS_JA_DIR="$REPO_ROOT/${PROJECT_PREFIX}src/content/docs-ja"
 
@@ -142,7 +144,7 @@ fi
 # even when the project is nested inside a larger git repo (running `pnpm
 # build` from the outer repo root would otherwise invoke the wrong
 # package.json, #2918).
-VERIFY_STEP="Run \`pnpm build\` from \`$ROOT_DIR\` to confirm the site builds correctly."
+VERIFY_STEP="Run \`pnpm build\` from \`$MAIN_PROJECT_DIR\` to confirm the site builds correctly."
 
 resolve_targets() {
   case "$TARGET_MODE" in
@@ -204,7 +206,7 @@ argument-hint: "[-u|--update] [topic keyword, e.g., 'configuration', 'sidebar',
 # $PROJECT_NAME Documentation Reference
 
 Look up documentation from the $PROJECT_NAME project for $assistant_label.
-Documentation base path: \`src/content/docs\` (relative to the project root: \`$ROOT_DIR\`)
+Documentation base path: \`src/content/docs\` (relative to the project root: \`$MAIN_PROJECT_DIR\`)
 
 ## Mode Detection
 
@@ -234,7 +236,7 @@ The user has new information and wants to add or update documentation in this re
    the topic. Read them to understand what is already covered.
 3. **Decide create vs update**: If an existing article covers the topic, update
    it. Otherwise, create a new \`.mdx\` file in the appropriate subdirectory.
-4. **Write the content**: Follow the doc-authoring rules in this project's CLAUDE.md (\`$ROOT_DIR/CLAUDE.md\`):
+4. **Write the content**: Follow the doc-authoring rules in this project's CLAUDE.md (\`$MAIN_PROJECT_DIR/CLAUDE.md\`):
    - Required frontmatter: \`title\` (string). Always set \`sidebar_position\`.
      Optional: \`description\`, \`sidebar_label\`, \`tags\`, etc.
    - Do NOT use \`# h1\` in content — the frontmatter \`title\` renders as h1.

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: