@takazudo/zudo-doc 5.24.2 → 5.26.0

package/dist/integrations/changelog/links.js

@@ -0,0 +1,280 @@
+import { basename } from "node:path";
+function formatChangelogEntryHeadingText(entry) {
+  return entry.date ? `[${entry.version}] - ${entry.date}` : `[${entry.version}]`;
+}
+const GITHUB_SLUG_ALLOWED_RE = /[\p{L}\p{N}_\- ]/u;
+function githubSlugify(text) {
+  let out = "";
+  for (const ch of text.toLowerCase()) {
+    if (GITHUB_SLUG_ALLOWED_RE.test(ch)) {
+      out += ch === " " ? "-" : ch;
+    }
+  }
+  return out;
+}
+class GithubSlugAllocator {
+  seen = /* @__PURE__ */ new Map();
+  allocate(text) {
+    const slug = githubSlugify(text);
+    const count = this.seen.get(slug) ?? 0;
+    this.seen.set(slug, count + 1);
+    return count === 0 ? slug : `${slug}-${count}`;
+  }
+}
+function stripInlineLinkSyntax(text) {
+  return text.replace(/!?\[([^\]]*)\]\([^)]*\)/g, "$1");
+}
+function isSetextParagraphLine(line) {
+  const text = line.trim();
+  return /^ {0,3}\S/.test(line) && !/^#{1,6}(?:[ \t]|$)/.test(text) && !/^(?:[-+*]|\d{1,9}[.)])(?:[ \t]|$)/.test(text) && !text.startsWith(">") && !text.includes("|") && !/^(?:(?:\*[ \t]*){3,}|(?:_[ \t]*){3,}|(?:-[ \t]*){3,})$/.test(text);
+}
+function extractHeadingTexts(content) {
+  const headings = [];
+  let fenceChar = null;
+  let fenceLen = 0;
+  let paragraphLineCount = 0;
+  let paragraphLine = "";
+  for (const line of content.split("\n")) {
+    const trimmed = line.trimStart();
+    const fenceMatch = /^([`~]{3,})/.exec(trimmed);
+    if (fenceMatch) {
+      paragraphLineCount = 0;
+      const fence = fenceMatch[1];
+      if (fence === void 0) continue;
+      if (fenceChar === null) {
+        fenceChar = fence[0] ?? null;
+        fenceLen = fence.length;
+      } else if (fence[0] === fenceChar && fence.length >= fenceLen) {
+        fenceChar = null;
+      }
+      continue;
+    }
+    if (fenceChar !== null) continue;
+    const headingMatch = /^(#{1,6})[ \t]+(.+)$/.exec(line.trim());
+    if (headingMatch) {
+      paragraphLineCount = 0;
+      const rawText = headingMatch[2];
+      if (rawText === void 0) continue;
+      const text = stripInlineLinkSyntax(rawText.trim().replace(/\s+#+\s*$/, ""));
+      headings.push(text);
+      continue;
+    }
+    if (/^ {0,3}(=+|-+)[ \t]*$/.test(line)) {
+      if (paragraphLineCount === 1) {
+        headings.push(stripInlineLinkSyntax(paragraphLine));
+      }
+      paragraphLineCount = 0;
+      continue;
+    }
+    if (isSetextParagraphLine(line)) {
+      paragraphLine = line.trim();
+      paragraphLineCount += 1;
+    } else {
+      paragraphLineCount = 0;
+    }
+  }
+  return headings;
+}
+function buildChangelogAnchorMap(title, entries) {
+  const allocator = new GithubSlugAllocator();
+  allocator.allocate(title);
+  const anchors = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    const anchor = allocator.allocate(formatChangelogEntryHeadingText(entry));
+    anchors.set(basename(entry.sourcePath), anchor);
+    for (const headingText of extractHeadingTexts(entry.content)) {
+      allocator.allocate(headingText);
+    }
+  }
+  return anchors;
+}
+const FENCE_PLACEHOLDER_PREFIX = "\0CHANGELOG_LINK_FENCE_";
+const INLINE_CODE_PLACEHOLDER_PREFIX = "\0CHANGELOG_LINK_CODE_";
+const PLACEHOLDER_SUFFIX = "\0";
+function protectCode(content) {
+  const stashed = [];
+  const stash = (prefix, value) => {
+    const token = `${prefix}${stashed.length}${PLACEHOLDER_SUFFIX}`;
+    stashed.push(value);
+    return token;
+  };
+  const outLines = [];
+  let fenceChar = null;
+  let fenceLen = 0;
+  let fenceBuf = [];
+  for (const line of content.split("\n")) {
+    const trimmed = line.trimStart();
+    const fenceMatch = /^([`~]{3,})/.exec(trimmed);
+    if (fenceChar === null) {
+      if (fenceMatch) {
+        const fence = fenceMatch[1];
+        if (fence !== void 0) {
+          fenceChar = fence[0] ?? null;
+          fenceLen = fence.length;
+          fenceBuf = [line];
+          continue;
+        }
+      }
+      outLines.push(line);
+    } else {
+      fenceBuf.push(line);
+      if (fenceMatch) {
+        const fence = fenceMatch[1];
+        if (fence !== void 0 && fence[0] === fenceChar && fence.length >= fenceLen) {
+          outLines.push(stash(FENCE_PLACEHOLDER_PREFIX, fenceBuf.join("\n")));
+          fenceChar = null;
+          fenceBuf = [];
+        }
+      }
+    }
+  }
+  if (fenceChar !== null) {
+    outLines.push(...fenceBuf);
+  }
+  let text = outLines.join("\n");
+  text = text.replace(
+    /(`+)((?:(?!\n[ \t]*\n)[\s\S])*?)\1(?!`)/g,
+    (whole) => stash(INLINE_CODE_PLACEHOLDER_PREFIX, whole)
+  );
+  return {
+    text,
+    restore: (s) => {
+      let result = s;
+      for (let i = 0; i < stashed.length; i += 1) {
+        const value = stashed[i];
+        if (value === void 0) continue;
+        const fenceToken = `${FENCE_PLACEHOLDER_PREFIX}${i}${PLACEHOLDER_SUFFIX}`;
+        const codeToken = `${INLINE_CODE_PLACEHOLDER_PREFIX}${i}${PLACEHOLDER_SUFFIX}`;
+        result = result.split(fenceToken).join(value).split(codeToken).join(value);
+      }
+      return result;
+    }
+  };
+}
+function findMatchingDelimiter(text, start, open, close) {
+  let depth = 1;
+  let j = start;
+  while (j < text.length) {
+    const ch = text[j];
+    if (ch === "\\") {
+      j += 2;
+      continue;
+    }
+    if (ch === open) depth += 1;
+    else if (ch === close) {
+      depth -= 1;
+      if (depth === 0) return j;
+    }
+    j += 1;
+  }
+  return -1;
+}
+function parseLinkInner(inner) {
+  const trimmed = inner.trim();
+  if (trimmed === "") return { dest: "" };
+  let dest;
+  let rest;
+  if (trimmed.startsWith("<")) {
+    const closeIdx = trimmed.indexOf(">");
+    if (closeIdx === -1) return null;
+    dest = trimmed.slice(1, closeIdx);
+    rest = trimmed.slice(closeIdx + 1).trim();
+  } else {
+    const spaceIdx = trimmed.search(/\s/);
+    if (spaceIdx === -1) {
+      dest = trimmed;
+      rest = "";
+    } else {
+      dest = trimmed.slice(0, spaceIdx);
+      rest = trimmed.slice(spaceIdx).trim();
+    }
+  }
+  let title;
+  if (rest !== "") {
+    const quotedTitle = /^(["'])[\s\S]*\1$/.test(rest);
+    const parenthesizedTitle = rest.startsWith("(") && findMatchingDelimiter(rest, 1, "(", ")") === rest.length - 1;
+    if (!quotedTitle && !parenthesizedTitle) return null;
+    title = rest;
+  }
+  return { dest, title };
+}
+function scanLinks(text) {
+  const matches = [];
+  let i = 0;
+  while (i < text.length) {
+    if (text[i] === "[") {
+      const isImage = i > 0 && text[i - 1] === "!";
+      const labelStart = i + 1;
+      const labelEnd = findMatchingDelimiter(text, labelStart, "[", "]");
+      if (labelEnd !== -1 && text[labelEnd + 1] === "(") {
+        const parenStart = labelEnd + 2;
+        const parenEnd = findMatchingDelimiter(text, parenStart, "(", ")");
+        if (parenEnd !== -1) {
+          const parsed = parseLinkInner(text.slice(parenStart, parenEnd));
+          if (parsed) {
+            matches.push({
+              start: isImage ? i - 1 : i,
+              end: parenEnd + 1,
+              label: text.slice(labelStart, labelEnd),
+              dest: parsed.dest,
+              title: parsed.title,
+              isImage
+            });
+            i = parenEnd + 1;
+            continue;
+          }
+        }
+      }
+    }
+    i += 1;
+  }
+  return matches;
+}
+const URL_SCHEME_RE = /^[a-z][a-z0-9+.-]*:/i;
+function parseRelativeDocLink(dest) {
+  const hashIdx = dest.indexOf("#");
+  const withoutFragment = hashIdx === -1 ? dest : dest.slice(0, hashIdx);
+  if (withoutFragment === "") return null;
+  if (!/\.(?:mdx|md)$/i.test(withoutFragment)) return null;
+  if (URL_SCHEME_RE.test(withoutFragment)) return null;
+  if (withoutFragment.startsWith("//")) return null;
+  if (withoutFragment.startsWith("/")) return null;
+  const normalized = withoutFragment.startsWith("./") ? withoutFragment.slice(2) : withoutFragment;
+  const sameDir = normalized.length > 0 && !normalized.includes("/");
+  return { sameDir, filename: normalized };
+}
+function rewriteChangelogEntryLinks(content, anchorByFilename) {
+  const { text: protectedText, restore } = protectCode(content);
+  const matches = scanLinks(protectedText);
+  let rewritten = "";
+  let cursor = 0;
+  for (const match of matches) {
+    rewritten += protectedText.slice(cursor, match.start);
+    if (match.isImage) {
+      rewritten += protectedText.slice(match.start, match.end);
+      cursor = match.end;
+      continue;
+    }
+    const parsed = parseRelativeDocLink(match.dest);
+    if (!parsed) {
+      rewritten += protectedText.slice(match.start, match.end);
+      cursor = match.end;
+      continue;
+    }
+    const anchor = parsed.sameDir ? anchorByFilename.get(parsed.filename) : void 0;
+    if (anchor === void 0) {
+      rewritten += match.label;
+    } else {
+      const titlePart = match.title !== void 0 ? ` ${match.title}` : "";
+      rewritten += `[${match.label}](#${anchor}${titlePart})`;
+    }
+    cursor = match.end;
+  }
+  rewritten += protectedText.slice(cursor);
+  return restore(rewritten);
+}
+export {
+  buildChangelogAnchorMap,
+  formatChangelogEntryHeadingText,
+  rewriteChangelogEntryLinks
+};

package/dist/mdx-components/index.js

@@ -124,7 +124,7 @@ function makeEnlargeableParagraph(imageEnlarge, ContentImg, assetOptions) {
                   {
                     type: "a",
                     props: {
-                      class: "text-accent hover:underline focus-visible:underline",
+                      class: "text-fg hover:text-accent focus-visible:text-accent hover:underline focus-visible:underline",
                       href: assetViewerHref({
                         base: assetOptions.base,
                         routePrefix: assetOptions.routePrefix,

package/dist/nav-indexing/category-nav.js

@@ -26,7 +26,7 @@ function CategoryNav(props) {
       href: child.href,
       class: "group block rounded border border-muted bg-surface px-hsp-lg py-vsp-md hover:border-accent",
       children: [
-        /* @__PURE__ */ jsxs("span", { class: "flex items-start gap-hsp-xs font-medium text-accent underline group-hover:underline", children: [
+        /* @__PURE__ */ jsxs("span", { class: "flex items-start gap-hsp-xs font-medium text-fg group-hover:text-accent group-hover:underline group-focus-visible:text-accent group-focus-visible:underline", children: [
           /* @__PURE__ */ jsx("span", { class: "flex h-[1lh] items-center", children: /* @__PURE__ */ jsx(ArrowIcon, {}) }),
           child.label
         ] }),

package/dist/nav-indexing/category-tree-nav.js

@@ -9,7 +9,7 @@ function NodeItem({ node, depth, maxDepth, index }) {
       "a",
       {
         href: node.href,
-        class: "inline-block py-vsp-3xs text-accent hover:underline",
+        class: "inline-block py-vsp-3xs text-fg hover:text-accent hover:underline focus-visible:text-accent focus-visible:underline",
         children: node.label
       }
     ) : /* @__PURE__ */ jsx("span", { class: "inline-block py-vsp-3xs text-fg font-medium", children: node.label }),

package/dist/nav-indexing/doc-card-grid.js

@@ -7,7 +7,7 @@ function ArrowIcon() {
       fill: "currentColor",
       viewBox: "0 0 103.395 107.049",
       "aria-hidden": "true",
-      class: "w-[16px] shrink-0 text-accent",
+      class: "w-[16px] shrink-0 text-muted group-hover:text-accent group-focus-visible:text-accent",
       children: /* @__PURE__ */ jsx("path", { d: "M5.746 5.74 0 11.49l20.987 20.96C34.126 45.572 41.963 53.45 41.948 53.523c-.012.062-9.456 9.544-20.986 21.07L0 95.55l5.714 5.715c3.142 3.143 5.748 5.715 5.79 5.715s2.63-2.563 5.75-5.696l17.939-18.001c21.867-21.94 29.443-29.599 29.443-29.768 0-.114-.665-.804-5.084-5.275C51.872 40.47 11.71.125 11.565.036 11.525.01 8.906 2.578 5.746 5.74m38.345-.066c-3.132 3.13-5.696 5.71-5.696 5.732-.001.022 2.16 2.185 4.8 4.807 2.641 2.623 8.382 8.338 12.758 12.702 15.38 15.337 23.763 23.641 24.314 24.086.19.153.346.336.346.405 0 .07-1.738 1.847-3.887 3.976a17515 17515 0 0 0-20.35 20.264 19555 19555 0 0 1-17.223 17.158c-.416.409-.757.77-.757.8 0 .083 11.415 11.485 11.457 11.445.235-.22 53.542-53.528 53.542-53.543C103.395 53.472 49.891.02 49.837 0c-.028-.01-2.613 2.543-5.746 5.674" })
     }
   );
@@ -27,7 +27,7 @@ function DocCardGrid(props) {
       children: [
         /* @__PURE__ */ jsxs("span", { class: "flex items-center gap-hsp-xs", children: [
           /* @__PURE__ */ jsx(ArrowIcon, {}),
-          /* @__PURE__ */ jsx("span", { class: "font-medium text-accent group-hover:underline", children: item.title })
+          /* @__PURE__ */ jsx("span", { class: "font-medium text-fg group-hover:text-accent group-hover:underline group-focus-visible:text-accent group-focus-visible:underline", children: item.title })
         ] }),
         item.description && /* @__PURE__ */ jsx("span", { class: "mt-vsp-2xs block text-small text-muted group-hover:text-accent group-focus-visible:text-accent", children: item.description })
       ]

package/dist/nav-indexing/docs-sitemap.js

@@ -15,14 +15,14 @@ function SitemapSection({ node, index }) {
   return /* @__PURE__ */ jsxs("details", { class: "group border border-muted overflow-hidden", open: true, children: [
     /* @__PURE__ */ jsxs("summary", { class: "flex items-center gap-x-hsp-md px-hsp-xl py-vsp-md text-title font-bold cursor-pointer select-none bg-surface list-none [&::-webkit-details-marker]:hidden", children: [
       /* @__PURE__ */ jsx("span", { class: "inline-block text-caption text-muted transition-transform duration-200 group-open:rotate-90", children: "\u25B6" }),
-      node.href ? /* @__PURE__ */ jsx("a", { href: node.href, class: "hover:underline focus:underline", children: node.label }) : /* @__PURE__ */ jsx("span", { children: node.label })
+      node.href ? /* @__PURE__ */ jsx("a", { href: node.href, class: "hover:text-accent hover:underline focus:underline focus-visible:text-accent", children: node.label }) : /* @__PURE__ */ jsx("span", { children: node.label })
     ] }),
     leaves.length > 0 && /* @__PURE__ */ jsx("div", { class: "px-hsp-xl py-vsp-md", children: /* @__PURE__ */ jsx("ul", { class: "space-y-vsp-2xs pl-[1.25rem] list-none", children: leaves.map((leaf, li) => /* @__PURE__ */ jsxs("li", { children: [
       /* @__PURE__ */ jsx(
         "a",
         {
           href: leaf.href,
-          class: "text-accent hover:underline focus:underline",
+          class: "text-fg hover:text-accent hover:underline focus-visible:text-accent focus-visible:underline",
           children: leaf.label
         }
       ),

package/dist/nav-indexing/nav-card-grid.d.ts

@@ -16,8 +16,9 @@ export interface NavCardGridProps {
  * NavCardGrid — JSX port of `src/components/nav-card-grid`.
  *
  * Renders direct children of a category as a two-column grid of card links.
- * Unlike `CategoryNav`, the arrow icon uses `text-accent` and sits inline with
- * the label via `items-center`. Description lines have a hover-underline effect.
+ * Unlike `CategoryNav`, the arrow icon uses `text-muted` (accent on
+ * hover/focus) and sits inline with the label via `items-center`. Description
+ * lines have a hover-underline effect.
  *
  * The caller must pre-resolve `href` for each node. Nodes with neither
  * `hasPage` nor children are excluded; nodes without an `href` are skipped.

package/dist/nav-indexing/nav-card-grid.js

@@ -7,7 +7,7 @@ function ArrowIcon() {
       fill: "currentColor",
       viewBox: "0 0 103.395 107.049",
       "aria-hidden": "true",
-      class: "w-[16px] shrink-0 text-accent",
+      class: "w-[16px] shrink-0 text-muted group-hover:text-accent group-focus-visible:text-accent",
       children: /* @__PURE__ */ jsx("path", { d: "M5.746 5.74 0 11.49l20.987 20.96C34.126 45.572 41.963 53.45 41.948 53.523c-.012.062-9.456 9.544-20.986 21.07L0 95.55l5.714 5.715c3.142 3.143 5.748 5.715 5.79 5.715s2.63-2.563 5.75-5.696l17.939-18.001c21.867-21.94 29.443-29.599 29.443-29.768 0-.114-.665-.804-5.084-5.275C51.872 40.47 11.71.125 11.565.036 11.525.01 8.906 2.578 5.746 5.74m38.345-.066c-3.132 3.13-5.696 5.71-5.696 5.732-.001.022 2.16 2.185 4.8 4.807 2.641 2.623 8.382 8.338 12.758 12.702 15.38 15.337 23.763 23.641 24.314 24.086.19.153.346.336.346.405 0 .07-1.738 1.847-3.887 3.976a17515 17515 0 0 0-20.35 20.264 19555 19555 0 0 1-17.223 17.158c-.416.409-.757.77-.757.8 0 .083 11.415 11.485 11.457 11.445.235-.22 53.542-53.528 53.542-53.543C103.395 53.472 49.891.02 49.837 0c-.028-.01-2.613 2.543-5.746 5.674" })
     }
   );
@@ -30,9 +30,9 @@ function NavCardGrid(props) {
       children: [
         /* @__PURE__ */ jsxs("span", { class: "flex items-center gap-hsp-sm", children: [
           /* @__PURE__ */ jsx(ArrowIcon, {}),
-          /* @__PURE__ */ jsx("span", { class: "font-medium text-accent group-hover:underline", children: child.label })
+          /* @__PURE__ */ jsx("span", { class: "font-medium text-fg group-hover:text-accent group-hover:underline group-focus-visible:text-accent group-focus-visible:underline", children: child.label })
         ] }),
-        child.description && /* @__PURE__ */ jsx("span", { class: "mt-vsp-2xs block text-small text-muted group-hover:text-accent group-hover:underline group-focus-visible:text-accent decoration-muted", children: child.description })
+        child.description && /* @__PURE__ */ jsx("span", { class: "mt-vsp-2xs block text-small text-muted group-hover:text-accent group-hover:underline group-focus-visible:text-accent", children: child.description })
       ]
     },
     `nav-card-${i}`

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

@@ -9,7 +9,7 @@ function CardBody({
   linked,
   hasStamp
 }) {
-  const titleClass = linked ? "flex items-start gap-hsp-xs text-accent underline group-hover:text-accent-hover group-focus-visible:text-accent-hover" : "flex items-start gap-hsp-xs text-accent underline";
+  const titleClass = linked ? "flex items-start gap-hsp-xs text-fg group-hover:text-accent group-hover:underline group-focus-visible:text-accent group-focus-visible:underline" : "flex items-start gap-hsp-xs text-fg";
   const descriptionClass = linked ? "mt-vsp-xs text-small text-muted group-hover:text-accent group-hover:underline group-focus-visible:text-accent group-focus-visible:underline" : "mt-vsp-xs text-small text-muted";
   return /* @__PURE__ */ jsxs("div", { class: "min-w-0", children: [
     /* @__PURE__ */ jsxs("div", { class: "flex flex-wrap items-baseline gap-x-hsp-md gap-y-vsp-3xs", children: [

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

@@ -6,7 +6,7 @@ function IndexList(props) {
   return /* @__PURE__ */ jsx("ol", { class: "[&_li]:mb-0", 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 ? "tabular-nums text-heading leading-none text-muted group-hover:text-fg group-focus-visible:text-fg" : "tabular-nums text-heading leading-none text-muted";
-    const labelClass = item.href ? "font-medium text-fg underline decoration-muted group-hover:text-accent group-hover:decoration-accent group-focus-visible:text-accent group-focus-visible:decoration-accent" : "font-medium text-fg";
+    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";
     const rowContent = /* @__PURE__ */ jsxs(Fragment, { children: [

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

@@ -14,7 +14,7 @@ function Timeline(props) {
       item.href ? /* @__PURE__ */ jsx(
         "a",
         {
-          class: "peer font-medium text-fg underline decoration-muted hover:text-accent hover:decoration-accent focus-visible:text-accent focus-visible:decoration-accent",
+          class: "peer font-medium text-fg hover:text-accent hover:underline focus-visible:text-accent focus-visible:underline",
           href: item.href,
           children: item.label
         }

package/dist/nav-indexing/site-tree-nav-demo.js

@@ -29,14 +29,14 @@ function Section({ node }) {
   return /* @__PURE__ */ jsxs("details", { class: "group border border-muted overflow-hidden", open: true, children: [
     /* @__PURE__ */ jsxs("summary", { class: "flex items-center gap-x-hsp-md px-hsp-xl py-vsp-md text-title font-bold cursor-pointer select-none bg-surface list-none [&::-webkit-details-marker]:hidden", children: [
       /* @__PURE__ */ jsx("span", { class: "inline-block text-caption text-muted transition-transform duration-200 group-open:rotate-90", children: "\u25B6" }),
-      node.href ? /* @__PURE__ */ jsx("a", { href: node.href, class: "hover:underline focus:underline", children: node.label }) : /* @__PURE__ */ jsx("span", { children: node.label })
+      node.href ? /* @__PURE__ */ jsx("a", { href: node.href, class: "hover:text-accent hover:underline focus:underline focus-visible:text-accent", children: node.label }) : /* @__PURE__ */ jsx("span", { children: node.label })
     ] }),
     leaves.length > 0 && /* @__PURE__ */ jsx("div", { class: "px-hsp-xl py-vsp-md", children: /* @__PURE__ */ jsx("ul", { class: "space-y-vsp-2xs pl-[1.25rem] list-none", children: leaves.map((leaf, i) => /* @__PURE__ */ jsxs("li", { children: [
       /* @__PURE__ */ jsx(
         "a",
         {
           href: leaf.href,
-          class: "text-accent hover:underline focus:underline",
+          class: "text-fg hover:text-accent hover:underline focus-visible:text-accent focus-visible:underline",
           children: leaf.label
         }
       ),

package/dist/nav-indexing/versions-page-content.js

@@ -11,7 +11,7 @@ function VersionsPageContent(props) {
         "a",
         {
           href: latestHref,
-          class: "inline-flex items-center gap-hsp-xs text-small text-accent underline hover:text-accent-hover",
+          class: "inline-flex items-center gap-hsp-xs text-small text-fg hover:text-accent hover:underline focus-visible:text-accent focus-visible:underline",
           children: [
             labels.latestLink,
             /* @__PURE__ */ jsx(ChevronRight, { className: "h-[0.875rem] w-[0.875rem]" })
@@ -42,7 +42,7 @@ function VersionsPageContent(props) {
                 "a",
                 {
                   href: v.docsHref,
-                  class: "text-accent underline hover:text-accent-hover",
+                  class: "text-fg hover:text-accent hover:underline focus-visible:text-accent focus-visible:underline",
                   children: labels.docsCol
                 }
               ) })

package/dist/plugins/routes.js

@@ -1,6 +1,6 @@
 import { prepareHomeIntros } from "../home-intro/prepare.js";
 import { createRequire } from "node:module";
-import { existsSync, statSync, readFileSync, cpSync, rmSync, mkdirSync } from "node:fs";
+import { existsSync, statSync, readFileSync } from "node:fs";
 import { dirname, basename, join } from "node:path";
 import { definePlugin } from "@takazudo/zfb/plugins";
 import { loadThemePackRegistry } from "../theme-packs-registry/load-registry.js";
@@ -326,16 +326,6 @@ const plugin = definePlugin({
       }
     }
     const require2 = createRequire(import.meta.url);
-    let stagedRoutesDir;
-    const ensureStaged = (routesSrcDir) => {
-      if (stagedRoutesDir) return stagedRoutesDir;
-      const dest = join(ctx.projectRoot, ".zudo-doc", "routes-src");
-      rmSync(dest, { recursive: true, force: true });
-      mkdirSync(dirname(dest), { recursive: true });
-      cpSync(routesSrcDir, dest, { recursive: true });
-      stagedRoutesDir = dest;
-      return dest;
-    };
     for (const route of derivedRoutes) {
       let resolvedEntrypoint;
       try {
@@ -348,8 +338,7 @@ const plugin = definePlugin({
         const routesSrcPath = join(routesSrcDir, tsxName);
         const srcPath = compiledPath.replace(/[\\/]dist[\\/]/, "/src/").replace(/\.js$/, ".tsx");
         if (existsSync(routesSrcPath)) {
-          const underNodeModules = /[\\/]node_modules[\\/]/.test(routesSrcPath);
-          resolvedEntrypoint = underNodeModules ? join(ensureStaged(routesSrcDir), tsxName) : routesSrcPath;
+          resolvedEntrypoint = routesSrcPath;
         } else if (existsSync(srcPath)) {
           resolvedEntrypoint = srcPath;
         } else {

package/dist/plugins/zdtp-loader.js

@@ -1,5 +1,5 @@
 const ZDTP_LOADER_SPECIFIER = "@takazudo/zudo-doc/zdtp-loader";
-const DISABLED_LOADER_SOURCE = 'throw new Error("@takazudo/zdtp is not bundled: designTokenPanel is disabled in this build.");\nexport {};\n';
+const DISABLED_LOADER_SOURCE = 'throw new Error("@takazudo/zdtp is not bundled: designTokenPanel is false and bundleZdtp is not set, so this build shadows @takazudo/zudo-doc/zdtp-loader. If you reached this through @takazudo/zudo-doc/design-token-panel-bootstrap to mount your own panel, set bundleZdtp: true and install @takazudo/zdtp.");\nexport {};\n';
 const plugin = {
   name: "zdtp-loader",
   setup(ctx) {

package/dist/preset.d.ts

@@ -124,8 +124,18 @@ export interface PresetSettings {
     docHistory?: boolean;
     /** Whether the doc history dropdown UI and related artifacts are enabled. */
     docHistoryUi?: boolean;
-    /** Falsy → the zdtp-loader plugin keeps `@takazudo/zdtp` out of the island build (#4201). */
+    /**
+     * Mount the package-owned design token panel and its header trigger. Does
+     * NOT decide bundling on its own — the zdtp-loader plugin follows
+     * `bundleZdtp ?? designTokenPanel` (#4201, #4261).
+     */
     designTokenPanel?: boolean;
+    /**
+     * Bundle `@takazudo/zdtp` into the island build. Omitted → follows
+     * `designTokenPanel`. Full contract: `ZudoDocConfig.bundleZdtp` in
+     * `config.ts`.
+     */
+    bundleZdtp?: boolean;
     docHistoryExclude?: string[];
     /** Generate package-owned viewer pages for files under the configured asset directory. */
     assetViewer?: boolean;

package/dist/preset.js

@@ -2,6 +2,8 @@ import { z } from "zod";
 import { assertNoCommaInVersionSlugs } from "./version-availability/index.js";
 import {
   assertNoEmptyStringFaviconOrLogo,
+  assertZdtpBundlingConsistent,
+  resolvesBundleZdtp,
   warnAmbiguousDropdownCategoryMatch
 } from "./config-assertions/index.js";
 function zudoDocPreset({
@@ -14,6 +16,7 @@ function zudoDocPreset({
 }) {
   assertNoCommaInVersionSlugs(settings.versions);
   assertNoEmptyStringFaviconOrLogo(settings);
+  assertZdtpBundlingConsistent(settings);
   warnAmbiguousDropdownCategoryMatch(settings.headerNav);
   const docsSchemaJson = z.toJSONSchema(buildDocsSchema());
   return {
@@ -304,11 +307,15 @@ function buildPlugins(settings, routeContext) {
         onBroken: settings.onBrokenMarkdownLinks
       }
     },
-    // Panel OFF → shadow the bootstrap's `@takazudo/zudo-doc/zdtp-loader` lazy
-    // import with a throwing virtual module so the island build emits no zdtp chunks
-    // (#4201). Preset-level rather than inside the routes plugin because the
-    // bootstrap is reachable from chrome even when packageOwnedRoutes is off.
-    ...settings.designTokenPanel ? [] : [{ name: "@takazudo/zudo-doc/plugins/zdtp-loader", options: {} }]
+    // zdtp not bundled → shadow the bootstrap's `@takazudo/zudo-doc/zdtp-loader`
+    // lazy import with a throwing virtual module so the island build emits no
+    // zdtp chunks (#4201). Bundling follows `bundleZdtp ?? designTokenPanel`:
+    // omit `bundleZdtp` and it tracks the panel exactly as before; set it to
+    // `true` with the panel off when the host mounts its own panel through
+    // `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: {} }]
   ];
 }
 export {