@takazudo/zudo-doc 7.0.0 → 7.1.0

package/CHANGELOG.md

@@ -8,6 +8,16 @@ The format is based on Keep a Changelog, and release notes are generated from th
 
 No unreleased changes.
 
+## [7.1.0] - 2026-10-23
+
+### Bug Fixes
+
+- Inline code inside table cells no longer breaks mid-word. The narrow-width `overflow-wrap: anywhere` from 7.0.0 collapsed the min-content width of table columns, so short identifiers such as `slug` were split instead of the table wrapper scrolling. Code in `th` / `td` goes back to `overflow-wrap: break-word`. (9d36a247, a30cdd85)
+
+### Other Changes
+
+- Requires the published zfb 4.7.0 family: the `@takazudo/zfb`, `zfb-runtime` and `zfb-md-wasm` peer floors move from `^4.5.2` to `^4.7.0`. This picks up the 4.5.3 MDX compile fixes: multiline expressions such as HtmlPreview template-literal props keep their authored whitespace, and a template string that contains a decimal comparison no longer fails to compile with `Unexpected numeric literal`. It also picks up the 4.5.4 islands fix: edits outside the browser graph, such as a page title or a Markdown body, no longer change the shipped islands JavaScript. 4.6.0 adds the RUSTSEC-2026-0381 and RUSTSEC-2026-0382 fixes in the CLI's HTTPS client, stages only the pnpm store packages a page can actually reach into the build shadow, and fixes two Windows path bugs in the SSR shadow and plugin virtual modules. 4.7.0 makes Rolldown the page/SSR and island bundler in place of esbuild, so shipped island asset hashes change on the first build after upgrading (set `ZFB_BUNDLER=esbuild` to go back); it also applies a project's tsconfig JSX options to TSX shipped inside packages (zfb#4407), and fixes Windows island builds that import a `?url` resource such as `@takazudo/zfb-md-wasm/highlight` (zfb#4413). Under Rolldown the optional `katex` and `diff` peers stay optional: a new `optional-peers` plugin shadows a peer that is not installed, or whose `math` / `docHistory` feature is off, so the project still builds and an enabled feature shows its usual "install the peer" message (workaround for zfb#4429). Upgrade the zfb family (and `zfb-adapter-cloudflare` when used) together. (f118e4e0, 2b222e31, 957c252d, 81fcc982, 39f1e8a8, 2e6676db)
+
 ## [7.0.0] - 2026-10-15
 
 ### Breaking Changes

package/README.md

@@ -109,7 +109,7 @@ If your project renders **semi-trusted or user-submitted** HTML in a preview, ov
 
 **6.0.0** is the coordinated major release of `@takazudo/zudo-doc`,
 `@takazudo/zudo-doc-history-server` and `create-zudo-doc`. The current workspace
-targets the published **zfb 4.5.2** family (peer floor **^4.5.2**).
+targets the published **zfb 4.7.0** family (peer floor **^4.7.0**).
 [Upstream #4097](https://github.com/Takazudo/zudo-front-builder/issues/4097) is
 resolved; its strict published 4.3.1 consumer control passed 3/3 with no skips or
 retries in the [source-bound verification](../../docs/findings/zfb-4.3.1/verification.md).

package/dist/compiled.css

@@ -751,6 +751,10 @@ body {
   overflow-wrap: break-word;
 }
 
+.zd-content :where(th code, td code) {
+  overflow-wrap: break-word;
+}
+
 .zd-content :where(th) {
   font-weight: var(--font-weight-semibold);
   text-align: left;

package/dist/content.css

@@ -236,6 +236,12 @@
   overflow-wrap: break-word;
 }
 
+/* `anywhere` collapses min-content width, so table layout would shrink columns
+ * and split identifiers mid-word instead of scrolling the wrapper (#4594). */
+.zd-content :where(th code, td code) {
+  overflow-wrap: break-word;
+}
+
 .zd-content :where(th) {
   font-weight: var(--font-weight-semibold);
   text-align: left;

package/dist/plugins/optional-peers.d.ts

@@ -0,0 +1,3 @@
+import type { ZfbPlugin } from "@takazudo/zfb/plugins";
+declare const plugin: ZfbPlugin;
+export default plugin;

package/dist/plugins/optional-peers.js

@@ -0,0 +1,34 @@
+import { createRequire } from "node:module";
+function shadowSource(specifier) {
+  const message = `Optional peer "${specifier}" is shadowed: it is not installed or the zudo-doc feature that uses it is off.`;
+  return `throw new Error(${JSON.stringify(message)});
+export {};
+`;
+}
+function stringList(value) {
+  return Array.isArray(value) ? value.filter((v) => typeof v === "string") : [];
+}
+function isResolvable(specifier) {
+  try {
+    createRequire(import.meta.url).resolve(specifier);
+    return true;
+  } catch {
+    return false;
+  }
+}
+const plugin = {
+  name: "optional-peers",
+  setup(ctx) {
+    const shadow = [
+      ...stringList(ctx.options["shadow"]),
+      ...stringList(ctx.options["shadowIfMissing"]).filter((s) => !isResolvable(s))
+    ];
+    for (const specifier of shadow) {
+      ctx.addVirtualModule(specifier, () => shadowSource(specifier));
+    }
+  }
+};
+var optional_peers_default = plugin;
+export {
+  optional_peers_default as default
+};

package/dist/preset.d.ts

@@ -115,6 +115,8 @@ export interface PresetSettings {
     trailingSlash: boolean;
     minifyHtml?: boolean;
     mermaid: boolean;
+    /** KaTeX math rendering; when off, the optional `katex` peer is shadowed. */
+    math?: boolean;
     /** Enable transclusion of other Markdown/MDX files. */
     transclude?: boolean;
     onBrokenMarkdownLinks: "warn" | "error" | "ignore";

package/dist/preset.js

@@ -130,6 +130,16 @@ function buildMarkdownFeatures(settings, directiveVocabulary) {
     headingIds: { strategy: "hierarchical" }
   };
 }
+function optionalPeerShadows(settings) {
+  const peers = [
+    ["katex", Boolean(settings.math)],
+    ["diff", Boolean(settings.docHistory)]
+  ];
+  return {
+    shadow: peers.filter(([, on]) => !on).map(([name]) => name),
+    shadowIfMissing: peers.filter(([, on]) => on).map(([name]) => name)
+  };
+}
 function buildPlugins(settings, routeContext) {
   const localeArray = Object.entries(settings.locales).map(([code, locale]) => ({
     code,
@@ -337,7 +347,10 @@ function buildPlugins(settings, routeContext) {
     // `design-token-panel-bootstrap` (#4261). Preset-level rather than inside
     // the routes plugin because the bootstrap is reachable from chrome even
     // when packageOwnedRoutes is off.
-    ...resolvesBundleZdtp(settings) ? [] : [{ name: "@takazudo/zudo-doc/plugins/zdtp-loader", options: {} }]
+    ...resolvesBundleZdtp(settings) ? [] : [{ name: "@takazudo/zudo-doc/plugins/zdtp-loader", options: {} }],
+    // Absent or disabled katex/diff → throwing shadows, so they cannot fail a
+    // Rolldown build (Takazudo/zudo-front-builder#4429).
+    { name: "@takazudo/zudo-doc/plugins/optional-peers", options: optionalPeerShadows(settings) }
   ];
 }
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zudo-doc",
-  "version": "7.0.0",
+  "version": "7.1.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",
@@ -206,6 +206,10 @@
       "types": "./dist/plugins/zdtp-loader.d.ts",
       "default": "./dist/plugins/zdtp-loader.js"
     },
+    "./plugins/optional-peers": {
+      "types": "./dist/plugins/optional-peers.d.ts",
+      "default": "./dist/plugins/optional-peers.js"
+    },
     "./content-admonition": {
       "types": "./dist/content-admonition/index.d.ts",
       "default": "./dist/content-admonition/index.js"
@@ -736,9 +740,9 @@
   "peerDependencies": {
     "@modelcontextprotocol/sdk": "1.32.1",
     "@takazudo/zdtp": "^0.5.2 || ^0.6.0 || ^0.7.0 || ^0.8.0",
-    "@takazudo/zfb": "^4.5.2",
-    "@takazudo/zfb-md-wasm": "^4.5.2",
-    "@takazudo/zfb-runtime": "^4.5.2",
+    "@takazudo/zfb": "^4.7.0",
+    "@takazudo/zfb-md-wasm": "^4.7.0",
+    "@takazudo/zfb-runtime": "^4.7.0",
     "@takazudo/zudo-doc-history-server": "^7.0.0",
     "diff": "^8.0.0",
     "katex": "^0.18.2 || ^0.19.0",
@@ -779,9 +783,9 @@
   "devDependencies": {
     "@modelcontextprotocol/sdk": "1.32.1",
     "@takazudo/mdx-formatter": "1.3.0",
-    "@takazudo/zfb": "4.5.2",
-    "@takazudo/zfb-md-wasm": "4.5.2",
-    "@takazudo/zfb-runtime": "4.5.2",
+    "@takazudo/zfb": "4.7.0",
+    "@takazudo/zfb-md-wasm": "4.7.0",
+    "@takazudo/zfb-runtime": "4.7.0",
     "@types/fs-extra": "^11.0.4",
     "@types/minimist": "^1.2.5",
     "@types/node": "^25.3.5",
@@ -791,7 +795,7 @@
     "typescript": "^5.0.0",
     "vitest": "^4.1.0",
     "zod": "^4.3.6",
-    "@takazudo/zudo-doc-history-server": "7.0.0"
+    "@takazudo/zudo-doc-history-server": "7.1.0"
   },
   "scripts": {
     "gen:search-widget-script": "node scripts/gen-search-widget-script.mjs",