create-zudo-doc 5.24.0 → 5.24.2

package/CHANGELOG.md

@@ -8,6 +8,18 @@ The format is based on Keep a Changelog, and release notes are generated from th
 
 No unreleased changes.
 
+## [5.24.2] - 2026-09-15
+
+### Bug Fixes
+
+- Generated projects list `diff` only when doc history is enabled (directly, or through `bodyFootUtil`), and no longer list `katex` by default. Projects that turn on `math: true` install `katex` themselves (`pnpm add katex`). (c778ca989)
+
+## [5.24.1] - 2026-09-15
+
+### Other Changes
+
+- Generated projects now pin `@takazudo/zfb`, `@takazudo/zfb-runtime`, and `@takazudo/zfb-md-wasm` to `2.17.0`. That release updates the YAML frontmatter parser and changes no API, so existing projects need no migration (a30a832b3)
+
 ## [5.24.0] - 2026-09-13
 
 - No package-specific changes.

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.24.0";
+export declare const ZUDO_DOC_PIN = "^5.24.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.24.0";
+export const ZUDO_DOC_PIN = "^5.24.2";
 /**
  * Files in `templates/base/**` that must not be copied by the unconditional
  * base mirror. Each entry is matched against the path relative to
@@ -772,9 +772,15 @@ function generatePackageJson(choices, localePlan) {
         // does — pin by semver, as here, and there is nothing to re-pin. No public
         // API, export, config default, or engine requirement moves, so a fresh
         // scaffold needs no migration.
-        "@takazudo/zfb": "2.16.0",
-        "@takazudo/zfb-runtime": "2.16.0",
-        "@takazudo/zfb-md-wasm": "2.16.0",
+        // 2.17.0: zfb and md-wasm bump the YAML frontmatter parser to
+        // noyalib-serde-yaml 0.0.43 (upstream reports every YAML corpus case parses
+        // byte-identically), which recompiles the four wasm artifacts at slightly
+        // moved sizes; zfb-runtime and zfb-adapter-cloudflare change only their
+        // README/description. No public API, export, config default, or engine
+        // requirement moves, so a fresh scaffold needs no migration.
+        "@takazudo/zfb": "2.17.0",
+        "@takazudo/zfb-runtime": "2.17.0",
+        "@takazudo/zfb-md-wasm": "2.17.0",
         // @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
@@ -815,25 +821,16 @@ function generatePackageJson(choices, localePlan) {
         // compiles. Same pin as host. Caught by W6B (#1735) consumer-build
         // verification.
         "preact-render-to-string": "^6.6.6",
-        // katex — server-side LaTeX renderer used by the always-on
-        // pages/lib/_math-block.tsx (called from pages/_mdx-components.ts
-        // for `$…$` and `$$…$$` math nodes). Caught by W6B (#1735)
-        // consumer-build verification — the import lives in the mirrored
-        // pages, not behind any feature gate. Same pin as host.
-        katex: "^0.16.38",
-        // diff — required at build time by EVERY generated project, not just
-        // docHistory ones. The always-copied host base template
-        // `pages/lib/_doc-history-area.tsx` statically imports the real
-        // `DocHistory` from `@takazudo/zudo-doc/doc-history` (to keep zfb's island
-        // scanner chain page→stub→DocHistory walkable), which pulls
-        // `@takazudo/zudo-doc/dist/doc-history/index.js`'s `await import("diff")`
-        // into the bundle. With packageOwnedRoutes default ON (1.0), a
-        // docHistory-off project still bundles that path, so without `diff` here
-        // `zfb build` fails at esbuild with "Could not resolve 'diff'" (#2342).
-        // `diff` is an *optional* peerDependency of @takazudo/zudo-doc, so a
-        // missing copy produces no `pnpm install` warning — which is why this gap
-        // shipped silently and only surfaced at build time.
-        diff: "^8.0.3",
+        // katex is intentionally ABSENT here. `math` is not a create-zudo-doc
+        // feature (it defaults to `false` in DEFAULT_SETTINGS) and
+        // @takazudo/zudo-doc now loads katex via a rejection-handled dynamic
+        // import that stays non-build-fatal when the package is absent (#4206 /
+        // #4209). A project that turns `math: true` on by hand must
+        // `pnpm add katex` itself — see the math-equations doc.
+        // diff is likewise intentionally ABSENT from this unconditional block —
+        // it is added below, gated on the docHistory feature, for the same
+        // #4206 / #4209 reason: the doc-history route's `import("diff")` is now
+        // rejection-handled instead of build-fatal when docHistory is off.
         // (@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
@@ -875,6 +872,17 @@ 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("docHistory")) {
+        // diff powers the History dropdown's Compare view
+        // (`@takazudo/zudo-doc/doc-history`'s `await import("diff")`). #4209 made
+        // that import rejection-handled, so a docHistory-OFF project no longer
+        // needs the dep at all — including bodyFootUtil-only projects, since
+        // scaffold() already normalizes bodyFootUtil into docHistory before this
+        // function runs (see the co-enable block near the top of scaffold()).
+        // assetViewer alone does not reach this import and must not carry it
+        // (#4206 / #4209; it was an unconditional base dep before this fix).
+        deps.diff = "^8.0.3";
+    }
     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")`
@@ -886,9 +894,9 @@ function generatePackageJson(choices, localePlan) {
     }
     if (choices.features.includes("docHistory") ||
         choices.features.includes("assetViewer")) {
-        // (`diff` remains an unconditional base dep — see the `deps` block above:
-        // packageOwnedRoutes always bundles the doc-history-area path, whose
-        // module-scope `diff` import is pulled in regardless of this flag. #2342.)
+        // (`diff` is gated separately, on docHistory alone — see the block just
+        // above this one. assetViewer does not reach the Compare view's
+        // `import("diff")`, so it must not add the dep on its own; #4206 / #4209.)
         //
         // @takazudo/zudo-doc-history-server is gated HERE because docHistory and
         // assetViewer are the only feature graphs that reach it. The doc-history
@@ -905,7 +913,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.24.0";
+        deps["@takazudo/zudo-doc-history-server"] = "^5.24.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.24.0",
+  "version": "5.24.2",
   "description": "Create a new zudo-doc documentation site",
   "license": "MIT",
   "author": "Takeshi Takatsudo",