@takazudo/zudo-doc 4.4.7 → 4.4.9

package/CHANGELOG.md

@@ -4,6 +4,27 @@ 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.9] - 2026-07-27
+
+### Bug Fixes
+
+- Fixed a build failure that made every `docHistory: false` project unbuildable with `Could not resolve "@takazudo/zudo-doc-history-server/exclude"`. The chrome graph's `doc-history-area` imported that subpath at module top level, and because the chrome graph is always bundled, esbuild had to resolve it on every build — even though `@takazudo/zudo-doc-history-server` is an *optional* peer that a doc-history-off project never installs. A regression introduced in 4.3.0 by the exclude-filtering work. The canonical matcher now lives inside `@takazudo/zudo-doc` and both consumers import it relatively; `doc-history-server` keeps its own copy and its published `./exclude` export (it is a standalone dependency-free Node server/CLI and cannot depend back on the framework package), with a source-identity parity test pinning the two copies together (5dc2a2bec)
+- Restored `@takazudo/zudo-doc-history-server` to the `docHistory` feature block in the generated scaffold's `package.json`. It had been promoted to an unconditional base dependency purely to work around the resolution bug above; with that root cause fixed, a doc-history-off scaffold no longer needs the package at all. The scaffold test now asserts docHistory-OFF ⇒ absent so the workaround cannot silently creep back (5d5d0ad1a)
+- Widened the release script's pin-rewrite regex to accept both pin spellings (bracket-assignment and object-literal-key). It previously matched only the colon form, so moving the pin into a conditional block would have failed the following release with `could not locate ... pin` (5d5d0ad1a)
+
+### Other Changes
+
+- Added an optional-peer reachability guard that walks the real injected doc routes and reports any optional peer reachable from the always-bundled graph. This bug class has now shipped three times and nothing else catches it — unit tests import from source, and this repo's own build installs every optional peer. The guard also resolves package self-imports back to source through the exports map rather than treating them as external, so the walk crosses the `@takazudo/zudo-doc/*` boundary instead of stopping at it (5dc2a2bec, cd6bd9516)
+- Made cold checkouts self-healing. A tree installed with `pnpm install --ignore-scripts` has no `dist/` for the workspace packages, so `zfb` could not even load `zfb.config.ts` (it imports `@takazudo/zudo-doc/config`, which resolves through `dist/config.js`) and `check` / `build` / `check:pages` / `test:packages` all failed before a single line was edited. A new `ensure:workspace-build` prerequisite now runs ahead of those commands and as a `b4push` preflight, building the two workspace packages in their mandatory order (c63615d90)
+- Made that build guard check every literal `./dist/**` target declared in each package's `exports` map instead of a single sentinel file. A `tsc` declaration pass killed partway leaves some `.d.ts` written and others missing — a state the sentinel pair accepted, so the next command failed on a missing subpath instead of self-healing. Deriving completeness from the manifest keeps the check correct as exports change and leaves no hand-maintained list to drift (833b9110e)
+
+## [4.4.8] - 2026-07-27
+
+### Bug Fixes
+
+- Corrected the color roles of the generated hero logo (`AutoLogo`, rendered when `logo: "auto"` — the default for every fresh scaffold), which were inverted relative to the intended design. In dark mode the tile rendered a foreground-filled interior with a dark center disc and a light glyph; it now renders a page-background interior with thin light frame lines, light corner rays, a light disc, and the glyph knocked out of that disc. Light mode is the exact inverse. Both roles are theme-driven tokens, so the fix applies to every color scheme and theme pack at once (31535b6f8)
+- Fixed the same inversion in the SVG produced by `zudo-doc eject logo`, which serializes the identical shape data through a luminance mask and so baked the wrong silhouette into the ejected asset. Note that the ejected variant's tile interior is transparent where the live component paints an opaque page background — an inherent limitation of the one-color CSS-mask path, and visually identical over a flat page background (31535b6f8)
+
 ## [4.4.7] - 2026-07-27
 
 ### Bug Fixes

package/dist/auto-logo/shapes.d.ts

@@ -9,23 +9,27 @@ export declare const INSET = 6;
 export declare const CX: number;
 export declare const CY: number;
 export declare const DISC_R = 34;
-/** Full-bleed plate rect. */
+/** Full-bleed plate rect, filled with the page background so the tile
+ *  interior reads as the page itself (opaque, not `fill: "none"`, so it also
+ *  covers a textured page background). */
 export declare const PLATE_SHAPE: ShapePrimitive;
-/** Thin inner frame stroke, knocked out against the page background. */
+/** Thin inner frame stroke, drawn in ink over the plate. */
 export declare const INNER_FRAME_SHAPE: ShapePrimitive;
-/** 4 diagonal corner rays, each stopping just short of the disc edge. */
+/** 4 diagonal corner rays in ink, each stopping just short of the disc edge. */
 export declare const RAY_SHAPES: ShapePrimitive[];
-/** Centered disc, knocked out against the page background. */
+/** Centered ink disc — the glyph below is knocked back out of it. */
 export declare const DISC_SHAPE: ShapePrimitive;
 /** Scale + translate that centers a glyph's 100×100 box onto the disc
  *  (slight overscan reads better). */
 export declare const GLYPH_SCALE: number;
 export declare const GLYPH_TRANSFORM = "translate(64.3, 16.799999999999997) scale(0.7140000000000001)";
 /** Line-art glyphs drawn in a 100×100 box centered at (50,50), as plain
- *  shape data. The original JSX wrapped each glyph (and some repeated
- *  groups) in a `<g>` that carried no attributes of its own — only React
- *  `key`s for list rendering — so flattening into a single primitive array
- *  per glyph loses no visual information. */
+ *  shape data. Every painted `fill`/`stroke` here is the knockout token, so
+ *  the glyph reads as a hole punched through the ink disc it sits on.
+ *  The original JSX wrapped each glyph (and some repeated groups) in a `<g>`
+ *  that carried no attributes of its own — only React `key`s for list
+ *  rendering — so flattening into a single primitive array per glyph loses
+ *  no visual information. */
 export declare const GLYPH_SHAPES: Record<string, ShapePrimitive[]>;
 export declare const GLYPH_NAMES: string[];
 /** Deterministic glyph name for a seed. */

package/dist/auto-logo/shapes.js

@@ -4,10 +4,11 @@ const INSET = 6;
 const CX = W / 2;
 const CY = H / 2;
 const DISC_R = 34;
+const INK = "currentColor";
 const KO = "var(--color-bg)";
 const PLATE_SHAPE = {
   el: "rect",
-  attrs: { x: 0, y: 0, width: W, height: H, fill: "currentColor" }
+  attrs: { x: 0, y: 0, width: W, height: H, fill: KO }
 };
 const INNER_FRAME_SHAPE = {
   el: "rect",
@@ -17,7 +18,7 @@ const INNER_FRAME_SHAPE = {
     width: W - INSET * 2,
     height: H - INSET * 2,
     fill: "none",
-    stroke: KO,
+    stroke: INK,
     "stroke-width": 1.6
   }
 };
@@ -33,12 +34,12 @@ const RAY_SHAPES = [
   const stop = (len - DISC_R - 7) / len;
   return {
     el: "line",
-    attrs: { x1: x, y1: y, x2: x + dx * stop, y2: y + dy * stop, stroke: KO, "stroke-width": 1.4 }
+    attrs: { x1: x, y1: y, x2: x + dx * stop, y2: y + dy * stop, stroke: INK, "stroke-width": 1.4 }
   };
 });
 const DISC_SHAPE = {
   el: "circle",
-  attrs: { cx: CX, cy: CY, r: DISC_R, fill: KO }
+  attrs: { cx: CX, cy: CY, r: DISC_R, fill: INK }
 };
 const GLYPH_SCALE = DISC_R * 2 / 100 * 1.05;
 const GLYPH_TRANSFORM = `translate(${CX - 50 * GLYPH_SCALE}, ${CY - 50 * GLYPH_SCALE}) scale(${GLYPH_SCALE})`;
@@ -49,12 +50,12 @@ const GLYPH_SHAPES = {
       attrs: {
         d: "M50 30 C42 24, 30 23, 22 26 L22 68 C30 65, 42 66, 50 72 C58 66, 70 65, 78 68 L78 26 C70 23, 58 24, 50 30 Z",
         fill: "none",
-        stroke: "currentColor",
+        stroke: KO,
         "stroke-width": 6,
         "stroke-linejoin": "round"
       }
     },
-    { el: "line", attrs: { x1: 50, y1: 30, x2: 50, y2: 72, stroke: "currentColor", "stroke-width": 5 } },
+    { el: "line", attrs: { x1: 50, y1: 30, x2: 50, y2: 72, stroke: KO, "stroke-width": 5 } },
     ...[0, 1, 2].flatMap(
       (i) => [
         {
@@ -64,7 +65,7 @@ const GLYPH_SHAPES = {
             y1: 38 + i * 10,
             x2: 43,
             y2: 40 + i * 10,
-            stroke: "currentColor",
+            stroke: KO,
             "stroke-width": 4,
             "stroke-linecap": "round"
           }
@@ -76,7 +77,7 @@ const GLYPH_SHAPES = {
             y1: 40 + i * 10,
             x2: 71,
             y2: 38 + i * 10,
-            stroke: "currentColor",
+            stroke: KO,
             "stroke-width": 4,
             "stroke-linecap": "round"
           }
@@ -87,37 +88,37 @@ const GLYPH_SHAPES = {
   doc: [
     {
       el: "path",
-      attrs: { d: "M32 22 L60 22 L70 32 L70 78 L32 78 Z", fill: "none", stroke: "currentColor", "stroke-width": 6, "stroke-linejoin": "round" }
+      attrs: { d: "M32 22 L60 22 L70 32 L70 78 L32 78 Z", fill: "none", stroke: KO, "stroke-width": 6, "stroke-linejoin": "round" }
     },
     {
       el: "path",
-      attrs: { d: "M60 22 L60 32 L70 32", fill: "none", stroke: "currentColor", "stroke-width": 5, "stroke-linejoin": "round" }
+      attrs: { d: "M60 22 L60 32 L70 32", fill: "none", stroke: KO, "stroke-width": 5, "stroke-linejoin": "round" }
     },
     ...[0, 1, 2].map(
       (i) => ({
         el: "line",
-        attrs: { x1: 40, y1: 44 + i * 11, x2: 62, y2: 44 + i * 11, stroke: "currentColor", "stroke-width": 4, "stroke-linecap": "round" }
+        attrs: { x1: 40, y1: 44 + i * 11, x2: 62, y2: 44 + i * 11, stroke: KO, "stroke-width": 4, "stroke-linecap": "round" }
       })
     )
   ],
   bookmark: [
     {
       el: "path",
-      attrs: { d: "M34 22 L66 22 L66 78 L50 64 L34 78 Z", fill: "none", stroke: "currentColor", "stroke-width": 6, "stroke-linejoin": "round" }
+      attrs: { d: "M34 22 L66 22 L66 78 L50 64 L34 78 Z", fill: "none", stroke: KO, "stroke-width": 6, "stroke-linejoin": "round" }
     },
-    { el: "line", attrs: { x1: 42, y1: 36, x2: 58, y2: 36, stroke: "currentColor", "stroke-width": 4, "stroke-linecap": "round" } }
+    { el: "line", attrs: { x1: 42, y1: 36, x2: 58, y2: 36, stroke: KO, "stroke-width": 4, "stroke-linecap": "round" } }
   ],
   compass: [
-    { el: "circle", attrs: { cx: 50, cy: 50, r: 26, fill: "none", stroke: "currentColor", "stroke-width": 6 } },
-    { el: "path", attrs: { d: "M60 40 L54 56 L40 60 L46 44 Z", fill: "currentColor" } }
+    { el: "circle", attrs: { cx: 50, cy: 50, r: 26, fill: "none", stroke: KO, "stroke-width": 6 } },
+    { el: "path", attrs: { d: "M60 40 L54 56 L40 60 L46 44 Z", fill: KO } }
   ],
   terminal: [
-    { el: "rect", attrs: { x: 24, y: 30, width: 52, height: 40, rx: 5, fill: "none", stroke: "currentColor", "stroke-width": 6 } },
+    { el: "rect", attrs: { x: 24, y: 30, width: 52, height: 40, rx: 5, fill: "none", stroke: KO, "stroke-width": 6 } },
     {
       el: "path",
-      attrs: { d: "M33 42 L41 50 L33 58", fill: "none", stroke: "currentColor", "stroke-width": 5, "stroke-linecap": "round", "stroke-linejoin": "round" }
+      attrs: { d: "M33 42 L41 50 L33 58", fill: "none", stroke: KO, "stroke-width": 5, "stroke-linecap": "round", "stroke-linejoin": "round" }
     },
-    { el: "line", attrs: { x1: 47, y1: 58, x2: 60, y2: 58, stroke: "currentColor", "stroke-width": 5, "stroke-linecap": "round" } }
+    { el: "line", attrs: { x1: 47, y1: 58, x2: 60, y2: 58, stroke: KO, "stroke-width": 5, "stroke-linecap": "round" } }
   ],
   bulb: [
     {
@@ -125,30 +126,30 @@ const GLYPH_SHAPES = {
       attrs: {
         d: "M50 22 C37 22, 30 32, 30 41 C30 49, 35 53, 39 58 L39 64 L61 64 L61 58 C65 53, 70 49, 70 41 C70 32, 63 22, 50 22 Z",
         fill: "none",
-        stroke: "currentColor",
+        stroke: KO,
         "stroke-width": 6,
         "stroke-linejoin": "round"
       }
     },
-    { el: "line", attrs: { x1: 42, y1: 71, x2: 58, y2: 71, stroke: "currentColor", "stroke-width": 5, "stroke-linecap": "round" } },
-    { el: "line", attrs: { x1: 45, y1: 78, x2: 55, y2: 78, stroke: "currentColor", "stroke-width": 5, "stroke-linecap": "round" } }
+    { el: "line", attrs: { x1: 42, y1: 71, x2: 58, y2: 71, stroke: KO, "stroke-width": 5, "stroke-linecap": "round" } },
+    { el: "line", attrs: { x1: 45, y1: 78, x2: 55, y2: 78, stroke: KO, "stroke-width": 5, "stroke-linecap": "round" } }
   ],
   chat: [
     {
       el: "path",
-      attrs: { d: "M26 28 L74 28 L74 62 L48 62 L36 74 L36 62 L26 62 Z", fill: "none", stroke: "currentColor", "stroke-width": 6, "stroke-linejoin": "round" }
+      attrs: { d: "M26 28 L74 28 L74 62 L48 62 L36 74 L36 62 L26 62 Z", fill: "none", stroke: KO, "stroke-width": 6, "stroke-linejoin": "round" }
     },
-    ...[0, 1, 2].map((i) => ({ el: "circle", attrs: { cx: 38 + i * 12, cy: 45, r: 3, fill: "currentColor" } }))
+    ...[0, 1, 2].map((i) => ({ el: "circle", attrs: { cx: 38 + i * 12, cy: 45, r: 3, fill: KO } }))
   ],
   layers: [
-    { el: "path", attrs: { d: "M50 22 L78 36 L50 50 L22 36 Z", fill: "none", stroke: "currentColor", "stroke-width": 6, "stroke-linejoin": "round" } },
+    { el: "path", attrs: { d: "M50 22 L78 36 L50 50 L22 36 Z", fill: "none", stroke: KO, "stroke-width": 6, "stroke-linejoin": "round" } },
     {
       el: "path",
-      attrs: { d: "M25 47 L50 60 L75 47", fill: "none", stroke: "currentColor", "stroke-width": 6, "stroke-linecap": "round", "stroke-linejoin": "round" }
+      attrs: { d: "M25 47 L50 60 L75 47", fill: "none", stroke: KO, "stroke-width": 6, "stroke-linecap": "round", "stroke-linejoin": "round" }
     },
     {
       el: "path",
-      attrs: { d: "M25 58 L50 71 L75 58", fill: "none", stroke: "currentColor", "stroke-width": 6, "stroke-linecap": "round", "stroke-linejoin": "round" }
+      attrs: { d: "M25 58 L50 71 L75 58", fill: "none", stroke: KO, "stroke-width": 6, "stroke-linecap": "round", "stroke-linejoin": "round" }
     }
   ]
 };

package/dist/doc-history-area/index.js

@@ -1,6 +1,6 @@
 import { jsx, jsxs } from "preact/jsx-runtime";
 import { Island } from "@takazudo/zfb";
-import { compileExclude } from "@takazudo/zudo-doc-history-server/exclude";
+import { compileExclude } from "../doc-history-exclude/index.js";
 import { BodyFootUtilArea } from "../body-foot-util/index.js";
 import { toHistorySlug } from "../slug/index.js";
 import { buildGitHubSourceUrl as buildGitHubSourceUrlBase } from "../github-helpers/index.js";

package/dist/doc-history-exclude/index.d.ts

@@ -0,0 +1,2 @@
+/** Compile doc-history exclude globs into a reusable slug predicate. */
+export declare function compileExclude(patterns: string[]): (slug: string) => boolean;

package/dist/doc-history-exclude/index.js

@@ -0,0 +1,36 @@
+function compileExclude(patterns) {
+  const matchers = patterns.map((pattern) => {
+    let source = "";
+    for (let i = 0; i < pattern.length; i++) {
+      const char = pattern[i];
+      if (char === "/" && pattern.slice(i + 1) === "**") {
+        source += "(?:/.*)?";
+        break;
+      }
+      if (pattern.slice(i, i + 3) === "**/") {
+        source += "(?:[^/]+/)*";
+        i += 2;
+        continue;
+      }
+      if (pattern.slice(i, i + 2) === "**") {
+        source += ".*";
+        i++;
+        continue;
+      }
+      if (char === "*") {
+        source += "[^/]*";
+        continue;
+      }
+      if (char === "?") {
+        source += "[^/]";
+        continue;
+      }
+      source += char?.replace(/[\\^$.*+?()[\]{}|]/g, "\\$&");
+    }
+    return new RegExp(`^${source}$`);
+  });
+  return (slug) => matchers.some((matcher) => matcher.test(slug));
+}
+export {
+  compileExclude
+};

package/dist/plugins/internal/doc-history/pre-build.js

@@ -4,7 +4,7 @@ import {
   collectContentFiles,
   getAllFilesFirstLastMetaAsync
 } from "@takazudo/zudo-doc-history-server/git-history";
-import { compileExclude } from "@takazudo/zudo-doc-history-server/exclude";
+import { compileExclude } from "../../../doc-history-exclude/index.js";
 const META_OUT_RELATIVE_DIR = ".zfb";
 const META_OUT_FILENAME = "doc-history-meta.json";
 function deriveSourceExt(filePath) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zudo-doc",
-  "version": "4.4.7",
+  "version": "4.4.9",
   "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",
@@ -650,7 +650,7 @@
     "typescript": "^5.0.0",
     "vitest": "^4.1.0",
     "zod": "^4.3.6",
-    "@takazudo/zudo-doc-history-server": "4.4.7"
+    "@takazudo/zudo-doc-history-server": "4.4.9"
   },
   "scripts": {
     "build": "tsup && tsc -p tsconfig.build.json",