create-zudo-doc 5.26.5 → 5.28.0

package/CHANGELOG.md

@@ -8,11 +8,28 @@ The format is based on Keep a Changelog, and release notes are generated from th
 
 No unreleased changes.
 
+## [5.28.0] - 2026-09-27
+
+### Other Changes
+
+- Generated projects pin zfb, zfb-runtime, and zfb-md-wasm to `2.21.1`, including SSR, collection filtering, startup, and workspace reload fixes. Projects with the design token panel enabled now pin zdtp to `0.8.5`, recovering orphaned or empty SPA panel roots and preserving open intent during initial mounting. No configuration migration is required. (6686f2da6, e82e57551, fafdcf7fc)
+
+## [5.27.0] - 2026-09-24
+
+### Bug Fixes
+
+- Generated projects now check links to headings with escaped punctuation or code spans correctly (59d47f68a).
+- New projects use the zfb 2.20.2 toolchain, which fixes injected-route dependency staging in workspace packages (e22acafdf).
+
+### Other Changes
+
+- Generated projects now pin `@takazudo/zudo-doc` and `@takazudo/zudo-doc-history-server` to `^5.27.0`.
+
 ## [5.26.5] - 2026-09-23
 
 ### Bug Fixes
 
-- New projects ignore the `.zudo-doc/` route-source staging directory generated by package-owned routes (848264b9c).
+- New projects ignore the `.zudo-doc/` route-source staging directory generated by package-owned routes (848264b9c). Existing projects scaffolded on 5.26.4 or earlier need to add this entry by hand after bumping — see the `@takazudo/zudo-doc` changelog for that release.
 - Generated projects now pin `@takazudo/zudo-doc` and its history server to `^5.26.5`.
 
 ## [5.26.4] - 2026-09-22

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.26.5";
+export declare const ZUDO_DOC_PIN = "^5.28.0";
 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.26.5";
+export const ZUDO_DOC_PIN = "^5.28.0";
 /**
  * Files in `templates/base/**` that must not be copied by the unconditional
  * base mirror. Each entry is matched against the path relative to
@@ -802,9 +802,25 @@ function generatePackageJson(choices, localePlan) {
         // limited to each package's own version field plus the five platform-binary
         // `optionalDependencies` pins. No public API, export, config default, or
         // engine requirement moves, so a fresh scaffold needs no config migration.
-        "@takazudo/zfb": "2.20.1",
-        "@takazudo/zfb-runtime": "2.20.1",
-        "@takazudo/zfb-md-wasm": "2.20.1",
+        // 2.20.2: zfb fixes injected-route dependency staging for npm/pnpm workspace
+        // packages and preserves explicit symlink resolution. The companion
+        // package changelogs report no package-specific changes; md-wasm's tarball
+        // also changes its four published WASM artifacts. No scaffold config
+        // migration is required.
+        // 2.21.0: includes 2.20.3's single-Preact-runtime SSR fix and scopes
+        // bundler collection seeds to each collection's `include` filter, plus a
+        // node_modules import-scan memoization perf improvement. The companion
+        // packages have no package-specific changes; md-wasm rebuilt its WASM
+        // artifacts. No scaffold config migration is required.
+        // 2.21.1: bug fixes only — `zfb dev` / `zfb build` start faster (the
+        // embedded Tailwind hash is stamped at build time), workspace-package
+        // staging keeps manifest-declared dirs, and `zfb dev` watches SSR module
+        // deps outside the watch roots. The companion packages have no
+        // package-specific changes; md-wasm rebuilt its WASM artifacts. No
+        // scaffold config migration is required.
+        "@takazudo/zfb": "2.21.1",
+        "@takazudo/zfb-runtime": "2.21.1",
+        "@takazudo/zfb-md-wasm": "2.21.1",
         // @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
@@ -914,7 +930,7 @@ function generatePackageJson(choices, localePlan) {
         // `@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.8.2";
+        deps["@takazudo/zdtp"] = "0.8.5";
     }
     if (choices.features.includes("docHistory") ||
         choices.features.includes("assetViewer")) {
@@ -937,7 +953,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.26.5";
+        deps["@takazudo/zudo-doc-history-server"] = "^5.28.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/package.json

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

package/templates/base/scripts/check-links.js

@@ -11,7 +11,7 @@
 import { access, readFile, readdir, stat } from "node:fs/promises";
 import { dirname, extname, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { extractHeadings, slugify } from "@takazudo/zudo-doc/extract-headings";
+import { extractAllHeadingIds } from "@takazudo/zudo-doc/extract-headings";
 
 const CLI_USAGE = `Usage: pnpm check:links -- [options]
 
@@ -602,45 +602,9 @@ export function extractMdxFragmentLinks(content) {
   return links;
 }
 
-function headingText(raw) {
-  return raw
-    .replace(/\[([^\]]*)\]\([^)]*\)/g, "$1")
-    .replace(/`([^`]+)`/g, "$1")
-    .replace(/\*\*([^*]+)\*\*/g, "$1")
-    .replace(/(?<![\w])__([^_]+)__(?![\w])/g, "$1")
-    .replace(/\*([^*]+)\*/g, "$1")
-    .replace(/(?<![\w])_([^_]+)_(?![\w])/g, "$1")
-    .trim();
-}
-
+/** Include h5/h6 targets and use the same text extraction as rendered TOC IDs. */
 function allHierarchicalHeadingIds(body) {
-  const ids = new Set(extractHeadings(body).map((heading) => heading.slug));
-  const seen = new Map();
-  const stack = [];
-  let codeFenceOpener = null;
-  for (const line of body.split("\n")) {
-    const fence = /^([`~]{3,})/.exec(line.trimStart())?.[1];
-    if (fence !== undefined) {
-      if (codeFenceOpener === null) codeFenceOpener = fence;
-      else if (fence[0] === codeFenceOpener[0] && fence.length >= codeFenceOpener.length) codeFenceOpener = null;
-      continue;
-    }
-    if (codeFenceOpener !== null) continue;
-    const match = /^(#{2,6})[ \t]+(.+)$/.exec(line.trim());
-    if (match === null) continue;
-    const depth = match[1].length;
-    const base = slugify(headingText(match[2]));
-    if (base === "") continue;
-    while ((stack.at(-1)?.depth ?? -1) >= depth) stack.pop();
-    const parent = stack.at(-1);
-    const candidate = parent === undefined ? base : `${parent.id}-${base}`;
-    const count = seen.get(candidate) ?? 0;
-    seen.set(candidate, count + 1);
-    const id = count === 0 ? candidate : `${candidate}-${count}`;
-    stack.push({ depth, id });
-    ids.add(id);
-  }
-  return ids;
+  return new Set(extractAllHeadingIds(body));
 }
 
 function extractStaticMdxIds(body) {