create-zudo-doc 5.26.4 → 5.27.0

package/CHANGELOG.md

@@ -8,6 +8,24 @@ The format is based on Keep a Changelog, and release notes are generated from th
 
 No unreleased changes.
 
+## [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).
+- Generated projects now pin `@takazudo/zudo-doc` and its history server to `^5.26.5`.
+
 ## [5.26.4] - 2026-09-22
 
 ### Other 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.26.4";
+export declare const ZUDO_DOC_PIN = "^5.27.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.4";
+export const ZUDO_DOC_PIN = "^5.27.0";
 /**
  * Files in `templates/base/**` that must not be copied by the unconditional
  * base mirror. Each entry is matched against the path relative to
@@ -448,6 +448,7 @@ export async function scaffold(choices) {
         "dist",
         ".zfb",
         ".zfb-build/",
+        ".zudo-doc/",
         "",
         "# macOS",
         ".DS_Store",
@@ -801,9 +802,14 @@ 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.
+        "@takazudo/zfb": "2.20.2",
+        "@takazudo/zfb-runtime": "2.20.2",
+        "@takazudo/zfb-md-wasm": "2.20.2",
         // @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
@@ -936,7 +942,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.4";
+        deps["@takazudo/zudo-doc-history-server"] = "^5.27.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.4",
+  "version": "5.27.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) {