create-zudo-doc 4.2.1 → 4.4.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/constants.js

@@ -32,11 +32,31 @@ export const THEME_PACKS = [
         label: "Default",
         hint: "Stock zudo-doc look — no extra stylesheet loaded",
     },
+    {
+        slug: "academia",
+        label: "Academia",
+        hint: "A LaTeX paper for the web — white page, Computer-Modern-black ink, hyperref navy links, numbered theorem admonitions, booktabs tables",
+    },
+    {
+        slug: "bauhaus",
+        label: "Bauhaus",
+        hint: "Primary triad as structure — gallery white, near-black ink, and red, yellow, blue doing structural work: circle, triangle, square markers, thick geometric rules",
+    },
     {
         slug: "beacon",
         label: "Beacon",
         hint: "WCAG-AAA high contrast — 7:1+ ink, 3px focus rings, always-underlined links",
     },
+    {
+        slug: "blueprint",
+        label: "Blueprint",
+        hint: "Cyanotype drafting sheet — pale-cyan linework on prussian grid paper, title-block caps, dashed rules, mono-caps labels",
+    },
+    {
+        slug: "botanica",
+        label: "Botanica",
+        hint: "A vintage botanical plate — herbarium cream, deep green ink, engraved double rules, Latin small-caps plate labels",
+    },
     {
         slug: "broadsheet",
         label: "Broadsheet",
@@ -52,6 +72,11 @@ export const THEME_PACKS = [
         label: "Drift",
         hint: "Floaty slate-blue comfort dark for long reading, relaxed Plex type",
     },
+    {
+        slug: "eink",
+        label: "E-Ink",
+        hint: "E-reader grayscale — warm paper, near-black ink, shadowless hairline chrome, zero radius",
+    },
     {
         slug: "fjord",
         label: "Fjord",
@@ -112,6 +137,21 @@ export const THEME_PACKS = [
         label: "Phosphor",
         hint: "Green CRT terminal — phosphor glow, scanlines, inverse-video nav",
     },
+    {
+        slug: "riso",
+        label: "Riso",
+        hint: "Risograph duotone print — warm paper, two inks (riso blue + fluorescent coral), misregistered offset shadows, soft linear paper grain",
+    },
+    {
+        slug: "sakura",
+        label: "Sakura",
+        hint: "Cherry-blossom pastels — blush-white paper, plum ink, and rose accents on petal-soft corners",
+    },
+    {
+        slug: "scandi",
+        label: "Scandi",
+        hint: "Hygge minimalism — oat linen, sage & clay, pill nav actives and 8px corners",
+    },
     {
         slug: "solar",
         label: "Solar",
@@ -127,6 +167,16 @@ export const THEME_PACKS = [
         label: "Swissgrid",
         hint: "International Typographic Style — grid discipline, one hot Swiss-red accent",
     },
+    {
+        slug: "tidepool",
+        label: "Tidepool",
+        hint: "Marine teal dark — deep-sea teal surfaces, seafoam text, bioluminescent aqua accents, kelp-green success, coral danger",
+    },
+    {
+        slug: "timberline",
+        label: "Timberline",
+        hint: "Forest cabin after dark — pine & umber planks, cream prose, and matte lantern-amber accents",
+    },
     {
         slug: "washi",
         label: "Washi",

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.1";
+export declare const ZUDO_DOC_PIN = "^4.4.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.1";
+export const ZUDO_DOC_PIN = "^4.4.0";
 /**
  * Files in `templates/base/**` that must not be copied by the unconditional
  * base mirror. Each entry is matched against the path relative to
@@ -550,12 +550,12 @@ function generatePackageJson(choices) {
         // 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.89",
-        "@takazudo/zfb-runtime": "0.1.0-next.89",
+        "@takazudo/zfb": "0.1.0-next.90",
+        "@takazudo/zfb-runtime": "0.1.0-next.90",
         // zfb-adapter-cloudflare — required for any route with `prerender = false`.
         // Pinned in lockstep with @takazudo/zfb.
-        "@takazudo/zfb-adapter-cloudflare": "0.1.0-next.89",
-        "@takazudo/zfb-md-wasm": "0.1.0-next.89",
+        "@takazudo/zfb-adapter-cloudflare": "0.1.0-next.90",
+        "@takazudo/zfb-md-wasm": "0.1.0-next.90",
         // @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
@@ -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.1";
+        deps["@takazudo/zudo-doc-history-server"] = "^4.4.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.1",
+  "version": "4.4.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.