@takazudo/zudo-doc 8.1.0 → 8.1.1

package/CHANGELOG.md

@@ -8,6 +8,30 @@ The format is based on Keep a Changelog, and release notes are generated from th
 
 No unreleased changes.
 
+## [8.1.1] - 2026-10-26
+
+### Bug Fixes
+
+- Search-index bodies, llms.txt descriptions and agent-export fallback descriptions now read as plain prose.
+  - Inline code keeps its text and only the backticks are dropped. Before, `` `pnpm approve-builds` `` was deleted, leaving fragments like "by default ()".
+  - Whole-line directive fences are removed and their label or title text is kept. This covers `:::warning[Title]`, `:::note Title`, `:::name{attrs}`, nested `::::` and bare closing `:::`. (9d0bffb5, 64cae6a6)
+- Sites that don't use math and don't install the optional `katex` peer no longer get a Rolldown `UNRESOLVED_IMPORT 'katex'` warning on every build.
+  - math-block now loads KaTeX through the package-owned `@takazudo/zudo-doc/katex-loader` subpath. With `math` off, the preset replaces that subpath with a stub.
+  - Bare `katex` imports in your own code are untouched.
+  - `` now requires `math: true`, as already documented. With `math` off it reports the missing-katex error even when `katex` happens to be installed. (82c24ea5, 64cae6a6)
+- Sites with `docHistory` off that don't install the optional `diff` peer no longer get an `UNRESOLVED_IMPORT 'diff'` warning.
+  - The doc-history Compare view loads `diff` through the package-owned `@takazudo/zudo-doc/diff-loader` subpath. With `docHistory` off, the preset replaces that subpath with a stub.
+  - The dates-only mode (`docHistoryUi: false`) keeps the real loader. (6e6434ca)
+- Some row descendants now follow their own row's hover and focus-visible accent, while keeping their resting colors and the inverted current-item style. This covers:
+  - numbered index ranks
+  - linked note-tray dates (index, compact and wide card stamps)
+  - sidebar tray and site-tree note-tray ranks and dates
+  - asset-tree folder and file icons, names and metadata (4c271316, 0efa5cbf)
+
+### Other Changes
+
+- Requires zfb 5.1.3: the `@takazudo/zfb`, `zfb-runtime` and `zfb-md-wasm` peer floors move from `^5.1.2` to `^5.1.3`. zfb 5.1.3 rebuilds the native engine and WASM binaries; the JavaScript API is unchanged. Update the zfb family (and `zfb-adapter-cloudflare` when used) to 5.1.3 together with this release. (62648582)
+
 ## [8.1.0] - 2026-10-25
 
 ### Features

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 5.1.2** family (peer floor **^5.1.2**).
+targets the published **zfb 5.1.3** family (peer floor **^5.1.3**).
 [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).
@@ -126,7 +126,7 @@ are feature-dependent. Package defaults for `agentExport`, `mcp`, and `llmsTxt`
 are all `false`. The create-zudo-doc initializer enables `llmsTxt` by default;
 agent export and MCP remain opt-in.
 
-For the panel, the installed **zdtp 0.8.6** manifest carries **Preact ^10.29.1** as
+For the panel, the installed **zdtp 0.8.7** manifest carries **Preact ^10.29.1** as
 its own dependency (it was a peer through 0.8.5) and exports `./styles.css` (also `./styles`) to `dist/zdtp.css`. Its internal
 Tailwind browser dependency and Preact subtree are isolated from host JSX.
 Install `@takazudo/zdtp` and import `@takazudo/zdtp/styles.css` when enabling it.

package/dist/asset-index-page/body.js

@@ -48,15 +48,15 @@ function iconFor(asset) {
 function AssetTree({ node, base, routePrefix, locale, fileCountLabel, fileCountSingleLabel, linesLabel, root = false }) {
   return /* @__PURE__ */ jsxs("ul", { "data-zd-asset-tree": root ? true : void 0, children: [
     node.dirs.map((dir) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsxs("details", { open: true, children: [
-      /* @__PURE__ */ jsxs("summary", { class: "flex cursor-pointer items-center gap-hsp-xs rounded px-hsp-sm py-vsp-3xs text-small hover:bg-accent/10 focus-visible:bg-accent/10", children: [
-        /* @__PURE__ */ jsx(ChevronRight, { class: "h-icon-xs w-icon-xs shrink-0 text-muted transition-transform" }),
-        /* @__PURE__ */ jsx(Folder, { class: "h-icon-sm w-icon-sm shrink-0 text-muted" }),
-        /* @__PURE__ */ jsx(FolderOpen, { class: "h-icon-sm w-icon-sm shrink-0 text-muted" }),
-        /* @__PURE__ */ jsxs("span", { class: "min-w-0 truncate font-mono text-fg", children: [
+      /* @__PURE__ */ jsxs("summary", { class: "group flex cursor-pointer items-center gap-hsp-xs rounded px-hsp-sm py-vsp-3xs text-small hover:bg-accent/10 focus-visible:bg-accent/10", children: [
+        /* @__PURE__ */ jsx(ChevronRight, { class: "h-icon-xs w-icon-xs shrink-0 text-muted transition-transform group-hover:text-accent group-focus-visible:text-accent" }),
+        /* @__PURE__ */ jsx(Folder, { class: "h-icon-sm w-icon-sm shrink-0 text-muted group-hover:text-accent group-focus-visible:text-accent" }),
+        /* @__PURE__ */ jsx(FolderOpen, { class: "h-icon-sm w-icon-sm shrink-0 text-muted group-hover:text-accent group-focus-visible:text-accent" }),
+        /* @__PURE__ */ jsxs("span", { class: "min-w-0 truncate font-mono text-fg group-hover:text-accent group-focus-visible:text-accent", children: [
           dir.name,
           "/"
         ] }),
-        /* @__PURE__ */ jsxs("span", { class: "ml-auto hidden whitespace-nowrap pl-hsp-lg text-caption text-muted sm:block", children: [
+        /* @__PURE__ */ jsxs("span", { class: "ml-auto hidden whitespace-nowrap pl-hsp-lg text-caption text-muted sm:block group-hover:text-accent group-focus-visible:text-accent", children: [
           countLabel(dir.fileCount, fileCountLabel, fileCountSingleLabel),
           " \xB7 ",
           formatAssetBytes(dir.bytes)
@@ -68,10 +68,10 @@ function AssetTree({ node, base, routePrefix, locale, fileCountLabel, fileCountS
       const Icon = iconFor(asset);
       const facet = facetLabel(asset, asset.lines !== void 0 ? linesLabel.replace("{count}", String(asset.lines)) : void 0);
       const meta = [kindLabel(asset), facet, formatAssetBytes(asset.bytes)].filter(Boolean).join(" \xB7 ");
-      return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsxs("a", { href: assetViewerHref({ base, routePrefix, path: asset.path, locale }), title: asset.name, class: "flex min-w-0 items-center gap-hsp-xs rounded px-hsp-sm py-vsp-3xs text-small text-fg hover:bg-accent/10 hover:text-accent hover:underline focus-visible:bg-accent/10 focus-visible:text-accent focus-visible:underline", children: [
-        /* @__PURE__ */ jsx(Icon, { class: "h-icon-sm w-icon-sm shrink-0 text-muted" }),
+      return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsxs("a", { href: assetViewerHref({ base, routePrefix, path: asset.path, locale }), title: asset.name, class: "group flex min-w-0 items-center gap-hsp-xs rounded px-hsp-sm py-vsp-3xs text-small text-fg hover:bg-accent/10 hover:text-accent hover:underline focus-visible:bg-accent/10 focus-visible:text-accent focus-visible:underline", children: [
+        /* @__PURE__ */ jsx(Icon, { class: "h-icon-sm w-icon-sm shrink-0 text-muted group-hover:text-accent group-focus-visible:text-accent" }),
         /* @__PURE__ */ jsx("span", { class: "min-w-0 truncate font-mono", children: basename(asset.path) }),
-        /* @__PURE__ */ jsx("span", { class: "ml-auto hidden whitespace-nowrap pl-hsp-lg text-caption text-muted sm:block", children: meta })
+        /* @__PURE__ */ jsx("span", { class: "ml-auto hidden whitespace-nowrap pl-hsp-lg text-caption text-muted sm:block group-hover:text-accent group-focus-visible:text-accent", children: meta })
       ] }) });
     })
   ] });

package/dist/compiled.css

@@ -3608,11 +3608,6 @@ site-search [data-search-results] > :is([data-search-placeholder], p) {
     color: var(--zw-color-bg);
   }
 }
-@media (hover: hover) {
-  :where(.group:hover) .group-hover\:text-fg {
-    color: var(--zw-color-fg);
-  }
-}
 @media (hover: hover) {
   :where(.group:hover) .group-hover\:bg-fg {
     background-color: var(--zw-color-fg);
@@ -3624,9 +3619,6 @@ site-search [data-search-results] > :is([data-search-placeholder], p) {
 :where(.group:focus-visible) .group-focus-visible\:text-accent {
   color: var(--zw-color-accent);
 }
-:where(.group:focus-visible) .group-focus-visible\:text-fg {
-  color: var(--zw-color-fg);
-}
 @media (hover: hover) {
   :where(.peer:hover) ~ .peer-hover\:text-accent {
     color: var(--zw-color-accent);

package/dist/diff-loader.d.ts

@@ -0,0 +1,3 @@
+export type DiffLines = typeof import("diff").diffLines;
+/** diff's `diffLines`, or `null` when the optional peer is not installed. */
+export declare const diffLines: DiffLines | null;

package/dist/diff-loader.js

@@ -0,0 +1,13 @@
+function pickDiffLines(m) {
+  let cur = m;
+  for (let i = 0; i < 3 && cur && typeof cur === "object"; i++) {
+    const fn = cur.diffLines;
+    if (typeof fn === "function") return fn;
+    cur = cur.default;
+  }
+  return null;
+}
+const diffLines = await import("diff").then(pickDiffLines, () => null);
+export {
+  diffLines
+};

package/dist/doc-history/index.js

@@ -95,12 +95,13 @@ async function getCachedDiff(olderHash, newerHash, olderContent, newerContent, i
     diffCache.set(key, hit);
     return hit;
   }
-  const { diffLines } = await import("diff").then(
-    (m) => m,
-    () => {
-      throw new Error('Compare requires the optional peer "diff": install it to use docHistory');
-    }
+  const diffLines = await import("@takazudo/zudo-doc/diff-loader").then(
+    (m) => m.diffLines,
+    () => null
   );
+  if (!diffLines) {
+    throw new Error('Compare requires the optional peer "diff": install it to use docHistory');
+  }
   if (!isCurrent()) throw new Error("Comparison cancelled");
   const changes = diffLines(olderContent, newerContent);
   diffCache.set(key, changes);

package/dist/katex-loader.d.ts

@@ -0,0 +1,3 @@
+export type KatexLike = typeof import("katex").default;
+/** katex's API, or `null` when the optional peer is not installed. */
+export declare const katex: KatexLike | null;

package/dist/katex-loader.js

@@ -0,0 +1,12 @@
+function pickKatex(m) {
+  let cur = m;
+  for (let i = 0; i < 3 && cur && typeof cur === "object"; i++) {
+    if (typeof cur.renderToString === "function") return cur;
+    cur = cur.default;
+  }
+  return null;
+}
+const katex = await import("katex").then(pickKatex, () => null);
+export {
+  katex
+};

package/dist/math-block/index.js

@@ -1,13 +1,8 @@
 import { jsx } from "@takazudo/zfb/zudo-react/jsx-runtime";
-function pickKatex(m) {
-  let cur = m;
-  for (let i = 0; i < 3 && cur && typeof cur === "object"; i++) {
-    if (typeof cur.renderToString === "function") return cur;
-    cur = cur.default;
-  }
-  return null;
-}
-const katex = await import("katex").then(pickKatex, () => null);
+const katex = await import("@takazudo/zudo-doc/katex-loader").then(
+  (m) => m.katex,
+  () => null
+);
 const MISSING_KATEX_MESSAGE = 'MathBlock requires the optional peer "katex": install it and set math: true';
 function MathBlock({ latex, block = false }) {
   if (!katex) throw new Error(MISSING_KATEX_MESSAGE);

package/dist/md-utils/index.d.ts

@@ -34,8 +34,14 @@ export interface MdDocFrontmatter {
  * search excerpts and llms-txt descriptions stay byte-equal across the
  * cutover, with one deliberate divergence: it also strips JSX/MDX block
  * comments (the `{/*`-delimited MDX comment form), which the legacy
- * pipeline leaked into descriptions (zudo-doc#2175). Do not add other new
- * rules without also updating the byte-equality fixtures (topic-plugin-audit).
+ * pipeline leaked into descriptions (zudo-doc#2175), and a second one
+ * (zudo-doc#4647): inline code keeps its text (only the backticks are
+ * dropped, contents protected from the later rules) instead of being deleted,
+ * and remark-directive container fence lines (`:::name[label]{attrs}`,
+ * `:::name Title`, bare `:::` closers) are removed while the label/title
+ * text is kept. Do not add
+ * other new rules without also updating the byte-equality fixtures
+ * (topic-plugin-audit).
  */
 export declare function stripMarkdown(md: string): string;
 /**

package/dist/md-utils/index.js

@@ -31,11 +31,18 @@ function decodeCharacterReferences(value) {
   ).replace(/&/g, "&");
 }
 function stripMarkdown(md) {
-  const withoutCodeCommentsAndTags = md.replace(/```[\s\S]*?```/g, "").replace(/`[^`]+`/g, "").replace(/\{\/\*[\s\S]*?\*\/\}/g, "").replace(/<[^>]+>/g, "");
-  return decodeCharacterReferences(withoutCodeCommentsAndTags).replace(/^#{1,6}\s+/gm, "").replace(/\*{1,3}([^*]+)\*{1,3}/g, "$1").replace(
+  const inlineCode = [];
+  const withoutCodeCommentsAndTags = md.replace(/```[\s\S]*?```/g, "").replace(/`([^`]+)`/g, (_m, code) => {
+    inlineCode.push(code);
+    return `\uE000${inlineCode.length - 1}\uE001`;
+  }).replace(/\{\/\*[\s\S]*?\*\/\}/g, "").replace(/<[^>]+>/g, "");
+  return decodeCharacterReferences(withoutCodeCommentsAndTags).replace(
+    /^[ \t]*:{3,}(?:[A-Za-z][\w-]*(?:\[([^\]\n]*)\])?(?:\{[^}\n]*\})?(?:[ \t]+(\S[^\n]*?))?)?[ \t]*$/gm,
+    (_m, label, title) => label ?? title ?? ""
+  ).replace(/^#{1,6}\s+/gm, "").replace(/\*{1,3}([^*]+)\*{1,3}/g, "$1").replace(
     /(^|[^\p{L}\p{N}])(_{1,3})(?=\S)([^_\n]*?\S)\2(?=$|[^\p{L}\p{N}])/gmu,
     "$1$3"
-  ).replace(/!\[[^\]]*\]\([^)]+\)/g, "").replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/^>\s+/gm, "").replace(/^[-*_]{3,}\s*$/gm, "").replace(/^[\s]*[-*+]\s+/gm, "").replace(/^[\s]*\d+\.\s+/gm, "").replace(/^import\s+.*$/gm, "").replace(/^export\s+.*$/gm, "").replace(/\n{3,}/g, "\n\n").trim();
+  ).replace(/!\[[^\]]*\]\([^)]+\)/g, "").replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/^>\s+/gm, "").replace(/^[-*_]{3,}\s*$/gm, "").replace(/^[\s]*[-*+]\s+/gm, "").replace(/^[\s]*\d+\.\s+/gm, "").replace(/^import\s+.*$/gm, "").replace(/^export\s+.*$/gm, "").replace(/\n{3,}/g, "\n\n").replace(/\uE000(\d+)\uE001/g, (_m, i) => inlineCode[Number(i)] ?? "").trim();
 }
 function collectMdFiles(dir) {
   const results = [];

package/dist/nav-indexing/note-tray-index-parts/card-list.js

@@ -23,7 +23,8 @@ function CardBody({
           item,
           locale: props.locale,
           updatedLabel: props.updatedLabel,
-          dateFormats: props.dateFormats
+          dateFormats: props.dateFormats,
+          linked
         }
       ) })
     ] }),
@@ -36,24 +37,23 @@ function DateStamp({
   locale,
   updatedLabel,
   positioned,
+  linked,
   dateFormats
 }) {
-  return /* @__PURE__ */ jsxs(
-    "time",
-    {
-      datetime: date,
-      class: positioned ? "hidden sm:flex sm:col-start-2 sm:row-start-1 sm:row-span-2 w-[6.5rem] flex-col items-end self-stretch border-l border-muted pl-hsp-xl text-muted tabular-nums" : "hidden sm:flex w-[6.5rem] flex-col items-end self-stretch border-l border-muted pl-hsp-xl text-muted tabular-nums",
-      children: [
-        /* @__PURE__ */ jsx("span", { class: "block text-title leading-tight font-medium", children: formatMonthDayLabel(date, locale, dateFormats?.monthDay) }),
-        /* @__PURE__ */ jsx("span", { class: "block text-caption", children: formatYear(date, locale, dateFormats?.year) }),
-        updated && /* @__PURE__ */ jsxs("span", { class: "mt-vsp-3xs block text-micro", children: [
-          updatedLabel,
-          " ",
-          formatMonthDayLabel(updated, locale, dateFormats?.monthDay)
-        ] })
-      ]
-    }
-  );
+  const stampClass = [
+    "hidden sm:flex w-[6.5rem] flex-col items-end self-stretch border-l border-muted pl-hsp-xl text-muted tabular-nums",
+    positioned && "sm:col-start-2 sm:row-start-1 sm:row-span-2",
+    linked && "group-hover:text-accent group-focus-visible:text-accent"
+  ].filter(Boolean).join(" ");
+  return /* @__PURE__ */ jsxs("time", { datetime: date, class: stampClass, children: [
+    /* @__PURE__ */ jsx("span", { class: "block text-title leading-tight font-medium", children: formatMonthDayLabel(date, locale, dateFormats?.monthDay) }),
+    /* @__PURE__ */ jsx("span", { class: "block text-caption", children: formatYear(date, locale, dateFormats?.year) }),
+    updated && /* @__PURE__ */ jsxs("span", { class: "mt-vsp-3xs block text-micro", children: [
+      updatedLabel,
+      " ",
+      formatMonthDayLabel(updated, locale, dateFormats?.monthDay)
+    ] })
+  ] });
 }
 function CardList(props) {
   return /* @__PURE__ */ jsx("div", { class: "grid grid-cols-1 gap-vsp-md", children: props.items.map((item) => /* @__PURE__ */ jsx(
@@ -84,7 +84,8 @@ function CardList(props) {
                   locale: props.locale,
                   updatedLabel: props.updatedLabel,
                   dateFormats: props.dateFormats,
-                  positioned: true
+                  positioned: true,
+                  linked: true
                 }
               )
             ]
@@ -107,7 +108,8 @@ function CardList(props) {
               locale: props.locale,
               updatedLabel: props.updatedLabel,
               dateFormats: props.dateFormats,
-              positioned: true
+              positioned: true,
+              linked: false
             }
           )
         ] }),
@@ -135,7 +137,8 @@ function CardList(props) {
                 locale: props.locale,
                 updatedLabel: props.updatedLabel,
                 dateFormats: props.dateFormats,
-                positioned: false
+                positioned: false,
+                linked: true
               }
             )
           ]
@@ -158,7 +161,8 @@ function CardList(props) {
             locale: props.locale,
             updatedLabel: props.updatedLabel,
             dateFormats: props.dateFormats,
-            positioned: false
+            positioned: false,
+            linked: false
           }
         )
       ] })

package/dist/nav-indexing/note-tray-index-parts/date-line.d.ts

@@ -3,11 +3,13 @@ import type { JSX } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import type { ResolvedDateFormats } from "../../settings.js";
 import type { NoteTrayIndexItem } from "../note-tray-index.js";
 import type { TagNavLabels } from "../types.js";
-export declare function DateLine({ item, locale, updatedLabel, dateFormats, }: {
+export declare function DateLine({ item, locale, updatedLabel, dateFormats, linked, }: {
     item: NoteTrayIndexItem;
     locale: string;
     updatedLabel: string;
     dateFormats?: ResolvedDateFormats;
+    /** Inside a `group` link: follow that link's hover/focus-visible accent. */
+    linked?: boolean;
 }): JSX.Element | null;
 export declare function ItemTags({ item, labels }: {
     item: NoteTrayIndexItem;

package/dist/nav-indexing/note-tray-index-parts/date-line.js

@@ -5,18 +5,25 @@ function DateLine({
   item,
   locale,
   updatedLabel,
-  dateFormats
+  dateFormats,
+  linked = false
 }) {
   if (!item.date && !item.updated) return null;
-  return /* @__PURE__ */ jsxs("span", { class: "tabular-nums text-caption text-muted", children: [
-    item.date && /* @__PURE__ */ jsx("time", { datetime: item.date, children: formatDate(item.date, locale, dateFormats?.full) }),
-    item.date && item.updated && /* @__PURE__ */ jsx("span", { "aria-hidden": "true", children: " \xB7 " }),
-    item.updated && /* @__PURE__ */ jsxs("span", { children: [
-      updatedLabel,
-      " ",
-      /* @__PURE__ */ jsx("time", { datetime: item.updated, children: formatDate(item.updated, locale, dateFormats?.full) })
-    ] })
-  ] });
+  return /* @__PURE__ */ jsxs(
+    "span",
+    {
+      class: linked ? "tabular-nums text-caption text-muted group-hover:text-accent group-focus-visible:text-accent" : "tabular-nums text-caption text-muted",
+      children: [
+        item.date && /* @__PURE__ */ jsx("time", { datetime: item.date, children: formatDate(item.date, locale, dateFormats?.full) }),
+        item.date && item.updated && /* @__PURE__ */ jsx("span", { "aria-hidden": "true", children: " \xB7 " }),
+        item.updated && /* @__PURE__ */ jsxs("span", { children: [
+          updatedLabel,
+          " ",
+          /* @__PURE__ */ jsx("time", { datetime: item.updated, children: formatDate(item.updated, locale, dateFormats?.full) })
+        ] })
+      ]
+    }
+  );
 }
 function ItemTags({ item, labels }) {
   if (!labels || !item.tagLinks?.length) return null;

package/dist/nav-indexing/note-tray-index-parts/index-list.js

@@ -5,7 +5,7 @@ function IndexList(props) {
   const width = rankWidth(props.items);
   return /* @__PURE__ */ jsx("ol", { class: "zd-list-items-no-margin", children: props.items.map((item) => {
     const rowClass = item.href ? "relative -mt-px first:mt-0 border-y border-muted hover:z-local-1 hover:border-accent focus-within:z-local-1 focus-within:border-accent" : "relative -mt-px first:mt-0 border-y border-muted";
-    const rankClass = item.href ? "whitespace-nowrap tabular-nums text-heading leading-none text-muted group-hover:text-fg group-focus-visible:text-fg" : "whitespace-nowrap tabular-nums text-heading leading-none text-muted";
+    const rankClass = item.href ? "whitespace-nowrap tabular-nums text-heading leading-none text-muted group-hover:text-accent group-focus-visible:text-accent" : "whitespace-nowrap tabular-nums text-heading leading-none text-muted";
     const labelClass = item.href ? "font-medium text-fg group-hover:text-accent group-hover:underline group-focus-visible:text-accent group-focus-visible:underline" : "font-medium text-fg";
     const detailClass = item.href ? "mt-vsp-2xs block text-small text-muted group-hover:text-accent group-hover:underline group-focus-visible:text-accent group-focus-visible:underline" : "mt-vsp-2xs block text-small text-muted";
     const dateClass = item.href ? "mt-vsp-2xs block text-caption text-muted group-hover:text-accent group-hover:underline group-focus-visible:text-accent group-focus-visible:underline" : "mt-vsp-2xs block text-caption text-muted";
@@ -20,7 +20,8 @@ function IndexList(props) {
             item,
             locale: props.locale,
             updatedLabel: props.updatedLabel,
-            dateFormats: props.dateFormats
+            dateFormats: props.dateFormats,
+            linked: Boolean(item.href)
           }
         ) })
       ] })

package/dist/plugins/diff-loader.d.ts

@@ -0,0 +1,4 @@
+import type { ZfbPlugin } from "@takazudo/zfb/plugins";
+export declare const DIFF_LOADER_SPECIFIER = "@takazudo/zudo-doc/diff-loader";
+declare const plugin: ZfbPlugin;
+export default plugin;

package/dist/plugins/diff-loader.js

@@ -0,0 +1,13 @@
+const DIFF_LOADER_SPECIFIER = "@takazudo/zudo-doc/diff-loader";
+const DISABLED_LOADER_SOURCE = 'throw new Error("diff is not bundled: docHistory is off, so this build shadows @takazudo/zudo-doc/diff-loader. To use the doc history Compare view, set docHistory: true and install diff.");\nexport {};\n';
+const plugin = {
+  name: "diff-loader",
+  setup(ctx) {
+    ctx.addVirtualModule(DIFF_LOADER_SPECIFIER, () => DISABLED_LOADER_SOURCE);
+  }
+};
+var diff_loader_default = plugin;
+export {
+  DIFF_LOADER_SPECIFIER,
+  diff_loader_default as default
+};

package/dist/plugins/katex-loader.d.ts

@@ -0,0 +1,4 @@
+import type { ZfbPlugin } from "@takazudo/zfb/plugins";
+export declare const KATEX_LOADER_SPECIFIER = "@takazudo/zudo-doc/katex-loader";
+declare const plugin: ZfbPlugin;
+export default plugin;

package/dist/plugins/katex-loader.js

@@ -0,0 +1,13 @@
+const KATEX_LOADER_SPECIFIER = "@takazudo/zudo-doc/katex-loader";
+const DISABLED_LOADER_SOURCE = 'throw new Error("katex is not bundled: math is off, so this build shadows @takazudo/zudo-doc/katex-loader. To render <MathBlock>, set math: true and install katex.");\nexport {};\n';
+const plugin = {
+  name: "katex-loader",
+  setup(ctx) {
+    ctx.addVirtualModule(KATEX_LOADER_SPECIFIER, () => DISABLED_LOADER_SOURCE);
+  }
+};
+var katex_loader_default = plugin;
+export {
+  KATEX_LOADER_SPECIFIER,
+  katex_loader_default as default
+};

package/dist/preset.d.ts

@@ -118,7 +118,7 @@ export interface PresetSettings {
     trailingSlash: boolean;
     minifyHtml?: boolean;
     mermaid: boolean;
-    /** KaTeX math rendering; when off, the optional `katex` peer is shadowed. */
+    /** KaTeX math rendering; when off, `@takazudo/zudo-doc/katex-loader` is shadowed (bare `katex` is not). */
     math?: boolean;
     /** Enable transclusion of other Markdown/MDX files. */
     transclude?: boolean;
@@ -131,6 +131,7 @@ export interface PresetSettings {
     changelogs?: PresetChangelogConfig[] | false;
     /** Metadata fields shown in the doc metadata area. */
     docMetainfoFields?: Array<"created" | "updated" | "author">;
+    /** Per-page git history; when off, `@takazudo/zudo-doc/diff-loader` is shadowed (bare `diff` is not). */
     docHistory?: boolean;
     /** Whether the doc history dropdown UI and related artifacts are enabled. */
     docHistoryUi?: boolean;

package/dist/preset.js

@@ -339,7 +339,18 @@ 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: {} }],
+    // math off → shadow math-block's `@takazudo/zudo-doc/katex-loader` with a
+    // throwing virtual module so a site without the optional katex peer gets no
+    // Rolldown UNRESOLVED_IMPORT warning (#4651). The bare `katex` is untouched.
+    ...settings.math ? [] : [{ name: "@takazudo/zudo-doc/plugins/katex-loader", options: {} }],
+    // docHistory off → shadow doc-history's `@takazudo/zudo-doc/diff-loader`
+    // the same way (#4652). Gated on `docHistory`, NOT `docHistoryUi`: the
+    // dates-only mode (`docHistory: true, docHistoryUi: false`) keeps the doc
+    // history feature on, so the shadow stays out of every configuration where
+    // the Compare view is still part of the enabled feature. Bare `diff` is
+    // untouched.
+    ...settings.docHistory ? [] : [{ name: "@takazudo/zudo-doc/plugins/diff-loader", options: {} }]
   ];
 }
 export {

package/dist/sidebar-tree-island/index.js

@@ -508,9 +508,7 @@ function TrayItem({
           rankDigits !== void 0 ? /* @__PURE__ */ jsx(
             "span",
             {
-              class: computed(
-                () => `shrink-0 tabular-nums${active.value ? "" : " text-muted"}`
-              ),
+              class: "shrink-0 tabular-nums",
               children: computed(
                 () => item.value.rank === void 0 ? "" : String(item.value.rank).padStart(rankDigits, "0")
               )
@@ -526,9 +524,7 @@ function TrayItem({
           /* @__PURE__ */ jsx(Show, { when: computed(() => showDate && !!shortDate.value), children: () => /* @__PURE__ */ jsx(
             "span",
             {
-              class: computed(
-                () => `shrink-0 tabular-nums${active.value ? "" : " text-muted"}`
-              ),
+              class: "shrink-0 tabular-nums",
               children: shortDate
             }
           ) })

package/dist/site-tree-nav-island/index.js

@@ -328,7 +328,7 @@ function NoteTrayRow({
     {
       href: computed(() => href.value ?? ""),
       "data-note-tray-row": true,
-      class: "flex items-start gap-hsp-sm py-vsp-2xs text-small text-fg hover:text-accent hover:underline focus:underline focus-visible:text-accent",
+      class: "group flex items-start gap-hsp-sm py-vsp-2xs text-small text-fg hover:text-accent hover:underline focus:underline focus-visible:text-accent",
       children: [
         /* @__PURE__ */ jsx(
           Show,
@@ -337,7 +337,7 @@ function NoteTrayRow({
             fallback: () => /* @__PURE__ */ jsx(
               "span",
               {
-                class: "shrink-0 font-mono tabular-nums text-caption text-muted",
+                class: "shrink-0 font-mono tabular-nums text-caption text-muted group-hover:text-accent group-focus-visible:text-accent",
                 style: computed(() => ({ width: `${width.value}ch` })),
                 children: rankLabel
               }
@@ -346,7 +346,7 @@ function NoteTrayRow({
               "time",
               {
                 datetime: computed(() => item.value.date ?? ""),
-                class: "shrink-0 font-mono tabular-nums text-caption text-muted",
+                class: "shrink-0 font-mono tabular-nums text-caption text-muted group-hover:text-accent group-focus-visible:text-accent",
                 children: computed(() => dateLabel.value ?? "")
               }
             )

package/dist/theme-packs/brutalist/pack.css

@@ -387,8 +387,8 @@ html[data-theme-pack="brutalist"] .zd-content blockquote a {
   font-weight: 500;
 }
 /* Card-style prose links (e.g. the note-tray IndexList rank/label/
-   description spans) put their own color on group-hover: utility
-   classes (group-hover:text-fg / group-hover:text-accent), which beats
+   description/date spans) put their own color on group-hover: utility
+   classes (group-hover:text-accent), which beats
    the anchor's inherited `color` — so the anchor-level color below
    never reached that text. Measured 2.63:1 (rgb(245 245 245) on
    rgb(255 106 31), dark) / 4.06:1 (rgb(0 0 0) on rgb(194 65 12), light)

package/dist/wind.json

@@ -136,14 +136,12 @@
     "grid-rows-subgrid",
     "group",
     "group-focus-visible:text-accent",
-    "group-focus-visible:text-fg",
     "group-focus-visible:underline",
     "group-focus-within:block",
     "group-hover:bg-fg",
     "group-hover:block",
     "group-hover:text-accent",
     "group-hover:text-bg",
-    "group-hover:text-fg",
     "group-hover:underline",
     "group-open:rotate-90",
     "h-[0.5rem]",

package/eject/doc-history/index.tsx

@@ -180,16 +180,20 @@ async function getCachedDiff(
     return hit;
   }
   // Lazy-load diff — only needed after History → Compare. This keeps the
-  // module out of the eager islands bundle. `diff` is an optional peer: the
-  // literal `import("diff").then(onFulfilled, onRejected)` shape is what lets
-  // esbuild leave it unresolved when absent instead of failing the build
-  // (#4209). The rejection surfaces through DiffViewer's `.catch()` → diffError.
-  const { diffLines } = await import("diff").then(
-    (m) => m,
-    () => {
-      throw new Error('Compare requires the optional peer "diff": install it to use docHistory');
-    },
+  // module out of the eager islands bundle. `diff` is an optional peer reached
+  // ONLY through the package-owned `@takazudo/zudo-doc/diff-loader` (#4652):
+  // with `docHistory` off the preset's `diff-loader` plugin shadows that
+  // specifier with a throwing virtual module, so the bundler never tries to
+  // resolve an absent `diff` (no UNRESOLVED_IMPORT); with `docHistory: true`
+  // and diff missing the loader resolves `diffLines` to `null` (#4209). The
+  // thrown error surfaces through DiffViewer's `.catch()` → diffError.
+  const diffLines = await import("@takazudo/zudo-doc/diff-loader").then(
+    (m) => m.diffLines,
+    () => null,
   );
+  if (!diffLines) {
+    throw new Error('Compare requires the optional peer "diff": install it to use docHistory');
+  }
   // The module import cannot be aborted; a replaced comparison must not do
   // work or populate the cache after its owning scope has been disposed.
   if (!isCurrent()) throw new Error("Comparison cancelled");

package/eject/sidebar-tree-island/index.tsx

@@ -587,10 +587,7 @@ function TrayItem({
             >
               {rankDigits !== undefined ? (
                 <span
-                  class={computed(
-                    () =>
-                      `shrink-0 tabular-nums${active.value ? "" : " text-muted"}`,
-                  )}
+                  class="shrink-0 tabular-nums"
                 >
                   {computed(() =>
                     item.value.rank === undefined
@@ -606,10 +603,7 @@ function TrayItem({
               <Show when={computed(() => showDate && !!shortDate.value)}>
                 {() => (
                   <span
-                    class={computed(
-                      () =>
-                        `shrink-0 tabular-nums${active.value ? "" : " text-muted"}`,
-                    )}
+                    class="shrink-0 tabular-nums"
                   >
                     {shortDate}
                   </span>

package/eject/site-tree-nav-island/index.tsx

@@ -443,13 +443,13 @@ function NoteTrayRow({
         <a
           href={computed(() => href.value ?? "")}
           data-note-tray-row
-          class="flex items-start gap-hsp-sm py-vsp-2xs text-small text-fg hover:text-accent hover:underline focus:underline focus-visible:text-accent"
+          class="group flex items-start gap-hsp-sm py-vsp-2xs text-small text-fg hover:text-accent hover:underline focus:underline focus-visible:text-accent"
         >
           <Show
             when={computed(() => Boolean(dateLabel.value))}
             fallback={() => (
               <span
-                class="shrink-0 font-mono tabular-nums text-caption text-muted"
+                class="shrink-0 font-mono tabular-nums text-caption text-muted group-hover:text-accent group-focus-visible:text-accent"
                 style={computed(() => ({ width: `${width.value}ch` }))}
               >
                 {rankLabel}
@@ -459,7 +459,7 @@ function NoteTrayRow({
             {() => (
               <time
                 datetime={computed(() => item.value.date ?? "")}
-                class="shrink-0 font-mono tabular-nums text-caption text-muted"
+                class="shrink-0 font-mono tabular-nums text-caption text-muted group-hover:text-accent group-focus-visible:text-accent"
               >
                 {computed(() => dateLabel.value ?? "")}
               </time>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zudo-doc",
-  "version": "8.1.0",
+  "version": "8.1.1",
   "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,14 @@
       "types": "./dist/plugins/zdtp-loader.d.ts",
       "default": "./dist/plugins/zdtp-loader.js"
     },
+    "./plugins/katex-loader": {
+      "types": "./dist/plugins/katex-loader.d.ts",
+      "default": "./dist/plugins/katex-loader.js"
+    },
+    "./plugins/diff-loader": {
+      "types": "./dist/plugins/diff-loader.d.ts",
+      "default": "./dist/plugins/diff-loader.js"
+    },
     "./content-admonition": {
       "types": "./dist/content-admonition/index.d.ts",
       "default": "./dist/content-admonition/index.js"
@@ -712,6 +720,14 @@
     "./zdtp-loader": {
       "types": "./dist/zdtp-loader.d.ts",
       "default": "./dist/zdtp-loader.js"
+    },
+    "./katex-loader": {
+      "types": "./dist/katex-loader.d.ts",
+      "default": "./dist/katex-loader.js"
+    },
+    "./diff-loader": {
+      "types": "./dist/diff-loader.d.ts",
+      "default": "./dist/diff-loader.js"
     }
   },
   "bin": {
@@ -736,9 +752,9 @@
   "peerDependencies": {
     "@modelcontextprotocol/sdk": "1.32.2",
     "@takazudo/zdtp": "^0.5.2 || ^0.6.0 || ^0.7.0 || ^0.8.0",
-    "@takazudo/zfb": "^5.1.2",
-    "@takazudo/zfb-md-wasm": "^5.1.2",
-    "@takazudo/zfb-runtime": "^5.1.2",
+    "@takazudo/zfb": "^5.1.3",
+    "@takazudo/zfb-md-wasm": "^5.1.3",
+    "@takazudo/zfb-runtime": "^5.1.3",
     "@takazudo/zudo-doc-history-server": "^8.0.0",
     "diff": "^8.0.0",
     "katex": "^0.18.2 || ^0.19.0",
@@ -779,9 +795,9 @@
   "devDependencies": {
     "@modelcontextprotocol/sdk": "1.32.2",
     "@takazudo/mdx-formatter": "1.3.0",
-    "@takazudo/zfb": "5.1.2",
-    "@takazudo/zfb-md-wasm": "5.1.2",
-    "@takazudo/zfb-runtime": "5.1.2",
+    "@takazudo/zfb": "5.1.3",
+    "@takazudo/zfb-md-wasm": "5.1.3",
+    "@takazudo/zfb-runtime": "5.1.3",
     "@types/fs-extra": "^11.0.4",
     "@types/minimist": "^1.2.5",
     "@types/node": "^25.3.5",
@@ -791,7 +807,7 @@
     "typescript": "^5.0.0",
     "vitest": "^4.1.0",
     "zod": "^4.3.6",
-    "@takazudo/zudo-doc-history-server": "8.1.0"
+    "@takazudo/zudo-doc-history-server": "8.1.1"
   },
   "scripts": {
     "gen:search-widget-script": "node scripts/gen-search-widget-script.mjs",