@takazudo/zudo-doc 5.7.0 → 5.9.0

package/eject/header/header.tsx

@@ -319,6 +319,8 @@ export function Header(props: HeaderProps): JSX.Element {
       //     island module): on BEFORE_SWAP_EVENT it copies the incoming
       //     document's data-props onto the live nested islands, and
       //     mountNewIslands re-reads the attribute at mount time (#3530)
+      //     Host islands can opt out with data-zd-props-preserve on the live
+      //     island or an ancestor inside this persisted root (#3555).
       //   - Header nav + aria-current: NAV_OVERFLOW_SCRIPT re-runs on
       //     AFTER_NAVIGATE_EVENT (frozen by zudolab/zudo-doc#3534 — the
       //     `addEventListener(${afterNavigateEventLiteral}, initNavOverflow)`

package/eject/header/nav-overflow-script.ts

@@ -46,12 +46,15 @@
 // `src/header/__tests__/nav-overflow-script.test.ts` proves the committed
 // literal still matches a fresh regeneration.
 //
-// EJECTED COPIES (`zudo-doc eject header`): the generator is NOT shipped, so
-// in an ejected tree the re-exported literal is permanently frozen — editing
-// the ejected `./nav-class-tokens.ts` or `./nav-active.ts` changes the SSR
-// markup (header.tsx imports them live) but NOT this client script, breaking
-// the SSR ↔ runtime class lockstep those files exist to guarantee. To change
-// the client script in an ejected copy, edit the literal in
-// `./nav-overflow-generated-script.ts` directly (it is plain JS in a string)
-// and keep it in step with your token edits by hand.
+// EJECTED COPIES (`zudo-doc eject header`): the payload ships
+// `./gen-nav-overflow-script.mjs`. After editing the local `./nav-active.ts`
+// or `./nav-class-tokens.ts`, run:
+//
+//   node ./src/components/zudo-doc/header/gen-nav-overflow-script.mjs
+//
+// The generator reads those two local customization inputs and the installed
+// package's current-path/page-event inputs, then rewrites the local
+// `./nav-overflow-generated-script.ts`. Commit that generated file with the
+// edits. Do not edit its string literal by hand: regeneration preserves the
+// frozen, consumer-bundler-independent bytes required for stable CSP hashes.
 export { NAV_OVERFLOW_SCRIPT } from "./nav-overflow-generated-script.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zudo-doc",
-  "version": "5.7.0",
+  "version": "5.9.0",
   "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",
@@ -179,6 +179,10 @@
       "types": "./dist/plugins/claude-resources.d.ts",
       "default": "./dist/plugins/claude-resources.js"
     },
+    "./plugins/codex-resources": {
+      "types": "./dist/plugins/codex-resources.d.ts",
+      "default": "./dist/plugins/codex-resources.js"
+    },
     "./plugins/routes": {
       "types": "./dist/plugins/routes.d.ts",
       "default": "./dist/plugins/routes.js"
@@ -617,7 +621,7 @@
     "CHANGELOG.md"
   ],
   "peerDependencies": {
-    "@takazudo/zdtp": "^0.4.11",
+    "@takazudo/zdtp": "^0.4.12",
     "@takazudo/zfb": "^2.7.1",
     "@takazudo/zfb-md-wasm": "^2.7.1",
     "@takazudo/zfb-runtime": "^2.7.1",
@@ -646,11 +650,13 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^8.4.2",
+    "esbuild": ">=0.28.1",
     "fs-extra": "^11.3.0",
     "gray-matter": "^4.0.3",
     "minimist": "^1.2.8",
     "picocolors": "^1.1.1",
     "pluralize": "^8.0.0",
+    "smol-toml": "^1.8.0",
     "string-similarity": "^4.0.4",
     "tsx": "^4.21.0"
   },
@@ -663,7 +669,6 @@
     "@types/node": "^25.3.5",
     "@types/pluralize": "^0.0.33",
     "@types/string-similarity": "^4.0.2",
-    "esbuild": ">=0.28.1",
     "happy-dom": "^20.10.6",
     "npm-run-all2": "^7.0.2",
     "preact": "^10.29.1",
@@ -672,7 +677,7 @@
     "typescript": "^5.0.0",
     "vitest": "^4.1.0",
     "zod": "^4.3.6",
-    "@takazudo/zudo-doc-history-server": "5.7.0"
+    "@takazudo/zudo-doc-history-server": "5.9.0"
   },
   "scripts": {
     "gen:search-widget-script": "node scripts/gen-search-widget-script.mjs",