@takazudo/zudo-doc 4.4.10 → 4.4.12

package/CHANGELOG.md

@@ -4,6 +4,34 @@ All notable changes to `@takazudo/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.
 
+## [4.4.12] - 2026-07-30
+
+### Bug Fixes
+
+- Restore EN `/docs/reference/design-token-panel` rendering — the page shipped its whole body as a single `<pre data-zfb-content-fallback>` blob due to a byte-offset-sensitive upstream zfb bundler bug, worked around with an exact-equivalent rewording (c3d9c78)
+- Re-inject the mermaid enlarge button after a theme re-render (5b9a655)
+- Close the bare same-page fragment guard hole in the link checker (ab2fea6)
+
+### Other Changes
+
+- New `check:content-fallback` build gate: fail the build when any built page ships a content-fallback blob, wired into b4push and the build-site jobs of all three CI workflows (a0e4361, 945c392)
+- Record Takazudo/zudo-front-builder#2186 as the content-fallback guard's upstream tracking issue and retirement condition (6cee4ca)
+- Bump the zfb family to 0.1.0-next.98 and add routes-src exports (8143de0)
+
+## [4.4.11] - 2026-07-28
+
+A maintenance release: CI post-deploy gate reliability, the `packages/zudo-doc` dev loop, and documentation. The published package artifacts are unchanged — the build path still cleans exactly as before.
+
+### Bug Fixes
+
+- Keep `packages/zudo-doc` declarations alive during dev. `tsup --watch` ran with `clean: true` and `dts: false`, so a dev session wiped `dist/` and regenerated no `.d.ts` at all (285 → 0). `dev` now pairs `tsup --watch` with a `tsc --watch` declarations pass, and only non-watch builds clean (a705fca1f, #3126)
+- Widen the post-deploy smoke-gate retry window so slow asset propagation no longer turns a green deploy red, and split the CSS-shape action's HTML fetch from its link grep so a failure names the URL that died instead of surfacing a bare curl exit code (960ff3e3f, #3123)
+- Give the six post-deploy gate steps a failure branch naming the URL and curl's exit status. Under `set -euo pipefail` a persistent 404 aborted at the assignment, so the `::error::` annotation was unreachable — the exact diagnosability gap the gate was meant to close. Gate-carrying jobs raised to `timeout-minutes: 15` so a job timeout cannot pre-empt the annotation (5f2266eaf, #3124)
+
+### Other Changes
+
+- Document the `run-p` dev-session cascade as accepted behaviour. One watcher exiting non-zero tears down all of `pnpm dev`, because `run-p` aborts its siblings and the zudo-doc watchers are themselves a nested `run-p`. Records the trigger set (including that `tsup --watch` exits on a failed *first* build while `tsc --watch` does not), the `EMFILE` vs `ENOSPC` inotify limit distinction, and why `--continue-on-error` is the wrong remedy (b9d7d5a29, 23f0deac1, #3129)
+
 ## [4.4.10] - 2026-07-28
 
 ### Bug Fixes

package/README.md

@@ -68,6 +68,6 @@ The fix is to import the package's build-generated safelist into your Tailwind C
 
 ## Dev workflow (in this repo)
 
-This package is published to npm as `@takazudo/zudo-doc` (since `0.2.0`, `latest` tracks the current line). Inside this repo the host site consumes it as a workspace package through its compiled `dist/` — `pnpm dev` at the repo root runs `tsup --watch` so edits under `src/` rebuild automatically; for a one-off rebuild use `pnpm --filter @takazudo/zudo-doc build`.
+This package is published to npm as `@takazudo/zudo-doc` (since `0.2.0`, `latest` tracks the current line). Inside this repo the host site consumes it as a workspace package through its compiled `dist/` — `pnpm dev` at the repo root runs two watchers in parallel, `tsup --watch` for the JS and `tsc -p tsconfig.build.json --watch` for the `.d.ts`, so edits under `src/` rebuild both halves automatically; for a one-off rebuild use `pnpm --filter @takazudo/zudo-doc build`.
 
 zfb itself comes from npm (versions pinned in the root `package.json`). To develop against a local zfb checkout, use the temporary `pnpm.overrides` link escape hatch documented in the root `CLAUDE.md` — do not commit the override.

package/dist/mermaid-enlarge/index.js

@@ -9,6 +9,7 @@ import {
 } from "../island-types/index.js";
 const CONTENT_SCOPE_SELECTOR = "main .zd-content";
 const DIAGRAM_SVG_SELECTOR = ":scope > svg";
+const INJECTED_BTN_SELECTOR = ":scope > .zd-enlarge-btn";
 const BTN_INJECTED_ATTR = "data-mermaid-enlarge-ready";
 const ZOOM_STEP = 1.25;
 const MIN_SCALE = 1;
@@ -41,7 +42,7 @@ function MermaidEnlarge() {
   useEffect(() => {
     let mutationObserver = null;
     function injectButton(container) {
-      if (container.hasAttribute(BTN_INJECTED_ATTR)) return;
+      if (container.querySelector(INJECTED_BTN_SELECTOR) !== null) return;
       const rendered = container.hasAttribute("data-mermaid-rendered") || container.querySelector(DIAGRAM_SVG_SELECTOR) !== null;
       if (!rendered) return;
       container.setAttribute(BTN_INJECTED_ATTR, "");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zudo-doc",
-  "version": "4.4.10",
+  "version": "4.4.12",
   "type": "module",
   "description": "zudo-doc framework primitives layer that sits on top of zfb's engine — sidebar, theme, TOC, breadcrumb, layouts, head injection, View Transitions, SSR-skip wrappers (per ADR-003).",
   "license": "MIT",
@@ -233,6 +233,7 @@
     "./page-loading.css": "./dist/page-loading.css",
     "./features.css": "./dist/features.css",
     "./theme-packs/*": "./dist/theme-packs/*",
+    "./routes-src/*": "./routes-src/*",
     "./tsconfig.base.json": "./tsconfig.base.json",
     "./zfb-config-shim.d.ts": "./zfb-config-shim.d.ts",
     "./virtual-modules.d.ts": "./virtual-modules.d.ts",
@@ -597,10 +598,10 @@
   ],
   "peerDependencies": {
     "@takazudo/zdtp": "^0.4.9",
-    "@takazudo/zfb": "^0.1.0-next.96",
-    "@takazudo/zfb-md-wasm": "^0.1.0-next.96",
-    "@takazudo/zfb-runtime": "^0.1.0-next.96",
-    "@takazudo/zudo-doc-history-server": "^4.4.5",
+    "@takazudo/zfb": "^0.1.0-next.98",
+    "@takazudo/zfb-md-wasm": "^0.1.0-next.98",
+    "@takazudo/zfb-runtime": "^0.1.0-next.98",
+    "@takazudo/zudo-doc-history-server": "^4.4.11",
     "diff": "^8.0.0",
     "katex": "^0.16.0",
     "preact": "^10.29.1",
@@ -634,9 +635,9 @@
     "tsx": "^4.21.0"
   },
   "devDependencies": {
-    "@takazudo/zfb": "0.1.0-next.96",
-    "@takazudo/zfb-md-wasm": "0.1.0-next.96",
-    "@takazudo/zfb-runtime": "0.1.0-next.96",
+    "@takazudo/zfb": "0.1.0-next.98",
+    "@takazudo/zfb-md-wasm": "0.1.0-next.98",
+    "@takazudo/zfb-runtime": "0.1.0-next.98",
     "@types/fs-extra": "^11.0.4",
     "@types/minimist": "^1.2.5",
     "@types/node": "^25.3.5",
@@ -644,17 +645,22 @@
     "@types/string-similarity": "^4.0.2",
     "cross-env": "^7.0.3",
     "happy-dom": "^20.10.6",
+    "npm-run-all2": "^7.0.2",
     "preact": "^10.29.1",
     "preact-render-to-string": "^6.6.6",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0",
     "vitest": "^4.1.0",
     "zod": "^4.3.6",
-    "@takazudo/zudo-doc-history-server": "4.4.10"
+    "@takazudo/zudo-doc-history-server": "4.4.12"
   },
   "scripts": {
     "build": "tsup && tsc -p tsconfig.build.json",
-    "dev": "tsup --watch",
+    "predev": "node ../../scripts/ensure-workspace-build.mjs",
+    "// dev": "Do NOT add `--continue-on-error` here. It stops a fatal watcher exit from cascading, but the dead watcher then fails silently — a dead dev:dts leaves dist/*.d.ts frozen while the JS keeps updating, which typechecks cleanly against stale types instead of failing loudly like #3113's absent declarations did. See the #3129 section in CLAUDE.md.",
+    "dev": "run-p dev:js dev:dts",
+    "dev:js": "tsup --watch",
+    "dev:dts": "tsc -p tsconfig.build.json --watch --preserveWatchOutput",
     "test:plugin-resolution": "node scripts/check-plugin-resolution.mjs",
     "test": "vitest run --config vitest.config.ts",
     "test:slow": "vitest run --config vitest.slow.config.ts",