create-zudo-doc 5.18.1 → 5.18.2

package/CHANGELOG.md

@@ -4,6 +4,17 @@ All notable changes to `create-zudo-doc` are documented in this file.
 
 The format is based on Keep a Changelog, and release notes are generated from the changelog MDX pages.
 
+## [5.18.2] - 2026-09-06
+
+### Bug Fixes
+
+- `@takazudo/zdtp` is added to a generated project only when the Design Token Panel is enabled. It had been an unconditional direct dependency of every scaffold — which is how generated projects avoided the `@takazudo/zudo-doc` bundling bug fixed in this same release — so every project without the panel installed and carried a package it never used. With that bug fixed upstream, the dependency is now gated on `designTokenPanel`. (a93ff2293)
+- Six feature flags now default on, matching the FEATURES catalog: `--sidebar-resizer`, `--sidebar-toggle`, `--toc-toggle`, `--doc-history`, `--llms-txt`, and `--asset-viewer`. A scaffold created without explicit flags now includes these features; pass the matching `--no-` flag to opt out. (6d0d3bfb9)
+
+### Other Changes
+
+- The CLI reference table was contradicted by the change above and has been corrected: the default column now matches the catalog, and the previously-missing `--[no-]asset-viewer` row was added in catalog position. The package README's feature list was corrected the same way. (c908f7f9a, f006d4ada)
+
 ## [5.18.1] - 2026-09-06
 
 ### Other Changes

package/README.md

@@ -113,18 +113,19 @@ Each feature has a `--[no-]<flag>` form. Passing `--feature` enables it; `--no-f
 | `--[no-]search` | Full-text search | on |
 | `--[no-]sidebar-filter` | Real-time sidebar filter | on |
 | `--[no-]image-enlarge` | Click-to-enlarge for oversized images | on |
-| `--[no-]asset-viewer` | Viewer pages for files under `public/assets/` | off |
+| `--[no-]asset-viewer` | Viewer pages for files under `public/assets/` | on |
 | `--[no-]tag-governance` | Vocabulary-aware tag audit + suggest scripts | off |
 | `--[no-]claude-resources` | Auto-generate Claude Code docs from `.claude/` | off |
 | `--[no-]codex-resources` | Auto-generate Codex docs from `.codex/` + `AGENTS.md` | off |
 | `--[no-]claude-skills` | Ship zudo-doc Claude Code skills (design-system, translate, version-bump) | off |
 | `--[no-]design-token-panel` | Interactive panel for tweaking spacing, font, color tokens | off |
-| `--[no-]sidebar-resizer` | Draggable sidebar width handle | off |
-| `--[no-]sidebar-toggle` | Show/hide desktop sidebar button | off |
+| `--[no-]sidebar-resizer` | Draggable sidebar width handle | on |
+| `--[no-]sidebar-toggle` | Show/hide desktop sidebar button | on |
+| `--[no-]toc-toggle` | Show/hide the desktop table of contents (edge chevron, xl screens) | on |
 | `--[no-]versioning` | Multi-version documentation support | off |
-| `--[no-]doc-history` | Show per-page document edit history | off |
+| `--[no-]doc-history` | Show per-page document edit history | on |
 | `--[no-]body-foot-util` | Right-aligned strip below each doc (history trigger + GitHub source link) | off |
-| `--[no-]llms-txt` | Generate `llms.txt` for LLM consumption | off |
+| `--[no-]llms-txt` | Generate `llms.txt` for LLM consumption | on |
 | `--[no-]skill-symlinker` | Symlink documentation skills into `.claude/` | off |
 | `--[no-]tauri` | Tauri desktop app — Mode 1 offline reader | off |
 | `--[no-]tauri-dev` | Tauri dev wrapper — Mode 2 configurable dev wrapper | off |

package/dist/constants.js

@@ -251,21 +251,21 @@ export const FEATURES = [
         value: "sidebarResizer",
         label: "Sidebar resizer",
         hint: "Draggable sidebar width",
-        default: false,
+        default: true,
         cliFlag: "sidebar-resizer",
     },
     {
         value: "sidebarToggle",
         label: "Sidebar toggle",
         hint: "Show/hide desktop sidebar",
-        default: false,
+        default: true,
         cliFlag: "sidebar-toggle",
     },
     {
         value: "tocToggle",
         label: "TOC toggle",
         hint: "Show/hide the desktop table of contents",
-        default: false,
+        default: true,
         cliFlag: "toc-toggle",
     },
     {
@@ -279,7 +279,7 @@ export const FEATURES = [
         value: "docHistory",
         label: "Document history",
         hint: "Show document edit history",
-        default: false,
+        default: true,
         cliFlag: "doc-history",
     },
     {
@@ -293,7 +293,7 @@ export const FEATURES = [
         value: "llmsTxt",
         label: "llms.txt",
         hint: "Generate llms.txt for LLM consumption",
-        default: false,
+        default: true,
         cliFlag: "llms-txt",
     },
     {
@@ -335,7 +335,7 @@ export const FEATURES = [
         value: "assetViewer",
         label: "Asset viewer",
         hint: "Viewer pages for files under public/assets",
-        default: false,
+        default: true,
         cliFlag: "asset-viewer",
     },
     {

package/dist/scaffold.d.ts

@@ -31,5 +31,5 @@ export declare function deriveDocSkillName(projectName: string): string;
  *
  * Bumped in lockstep by scripts/release-create-zudo-doc.sh.
  */
-export declare const ZUDO_DOC_PIN = "^5.18.1";
+export declare const ZUDO_DOC_PIN = "^5.18.2";
 export declare function scaffold(choices: UserChoices): Promise<void>;

package/dist/scaffold.js

@@ -47,7 +47,7 @@ export function deriveDocSkillName(projectName) {
  *
  * Bumped in lockstep by scripts/release-create-zudo-doc.sh.
  */
-export const ZUDO_DOC_PIN = "^5.18.1";
+export const ZUDO_DOC_PIN = "^5.18.2";
 /**
  * Files in `templates/base/**` that must not be copied by the unconditional
  * base mirror. Each entry is matched against the path relative to
@@ -821,26 +821,20 @@ function generatePackageJson(choices, localePlan) {
         // missing copy produces no `pnpm install` warning — which is why this gap
         // shipped silently and only surfaced at build time.
         diff: "^8.0.3",
-        // @takazudo/zdtp — SAME "unconditional at build time despite being an
-        // optional peer" class as `diff` above, discovered empirically while
-        // verifying this generator's own barebone (designTokenPanel: OFF) output
-        // (epic zudolab/zudo-doc#2651, #2660 self-review — a genuine package-level
-        // coupling, not a generator bug; flagged loudly on #2660's completion
-        // comment for a package-side follow-up). Since the #2658 gate-2 fix,
-        // `chrome/derive.tsx`'s `deriveBodyEndIslands` statically imports the REAL
-        // `DesignTokenPanelBootstrap` as the default for EVERY `createChrome`
-        // consumer (so the island auto-mounts with zero host wiring when the
-        // setting is on) — and that component imports `@takazudo/zdtp` at module
-        // scope. So every page that goes through `createChrome` — which is every
-        // page in this project — pulls the zdtp import into the esbuild bundle
-        // graph, `designTokenPanel` setting or not; only RENDERING is gated on
-        // the setting, not the import. Without this dep, `zfb build` fails with
-        // "Could not resolve '@takazudo/zdtp'" even on a fully barebone project.
-        // `preact ^10.29.1` (see the floor comment above) is required for the
-        // same reason. This is the ACCEPTED, permanent contract per #2668 — see
-        // the "@takazudo/zdtp dep implication" note in
-        // packages/zudo-doc/docs/adr/route-injection-seam.md.
-        "@takazudo/zdtp": "0.5.1",
+        // (@takazudo/zdtp is NOT here — it is gated on the designTokenPanel
+        // feature, see the block below. It WAS unconditional from #2660 through
+        // #4018: `chrome/derive.tsx`'s `deriveBodyEndIslands` statically imports
+        // the REAL `DesignTokenPanelBootstrap` for EVERY `createChrome` consumer
+        // (zero host wiring when the setting is on), and that component used to
+        // import `@takazudo/zdtp/constants` at module scope — so a barebone
+        // designTokenPanel:OFF project still died with "Could not resolve
+        // '@takazudo/zdtp/constants'". #4018 vendored those constants into
+        // @takazudo/zudo-doc, leaving only a rejection-handled
+        // `import("@takazudo/zdtp")` that esbuild tolerates when the package is
+        // absent, so the dep is now genuinely conditional (#4009).
+        // `preact` stays unconditional (the app needs it regardless); its
+        // ^10.29.1 floor is still chosen so a designTokenPanel-ON project shares
+        // one preact instance with zdtp — see the floor comment above.)
         // (@takazudo/zudo-doc-history-server is NOT here — it is gated on the
         // docHistory or assetViewer features, see the block below. It was briefly unconditional
         // (#3080) to work around doc-history-area importing its `/exclude` subpath
@@ -868,6 +862,15 @@ function generatePackageJson(choices, localePlan) {
     // search ships as @takazudo/zudo-doc's own self-contained generated
     // search-widget script (custom word-match scorer) — no third-party search
     // engine dependency is needed here. Do not re-add minisearch/pagefind.
+    if (choices.features.includes("designTokenPanel")) {
+        // Only the design-token-panel feature graph reaches @takazudo/zdtp: the
+        // panel payload loads through a rejection-handled `import("@takazudo/zdtp")`
+        // at first toggle, and this feature's global.css injection is what pulls in
+        // `@takazudo/zdtp/styles.css` (see features/design-token-panel.ts). Both are
+        // no-ops with the feature off, so an OFF project must not carry the dep
+        // (#4009 / #4018 — it was unconditional until then, see the `deps` block).
+        deps["@takazudo/zdtp"] = "0.5.1";
+    }
     if (choices.features.includes("docHistory") ||
         choices.features.includes("assetViewer")) {
         // (`diff` remains an unconditional base dep — see the `deps` block above:
@@ -889,7 +892,7 @@ function generatePackageJson(choices, localePlan) {
         // `/exclude` at module scope from the always-bundled chrome graph; #3110
         // moved compileExclude into @takazudo/zudo-doc, so projects with both
         // docHistory and assetViewer off no longer need the package at all.
-        deps["@takazudo/zudo-doc-history-server"] = "^5.18.1";
+        deps["@takazudo/zudo-doc-history-server"] = "^5.18.2";
         // 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": "5.18.1",
+  "version": "5.18.2",
   "description": "Create a new zudo-doc documentation site",
   "license": "MIT",
   "author": "Takeshi Takatsudo",