@takazudo/zudo-doc 5.25.0 → 5.26.0

package/CHANGELOG.md

@@ -8,6 +8,23 @@ The format is based on Keep a Changelog, and release notes are generated from th
 
 No unreleased changes.
 
+## [5.26.0] - 2026-09-20
+
+### Features
+
+- Added a `bundleZdtp` setting so hosts can keep the real `@takazudo/zdtp` loader while mounting their own panel with `designTokenPanel: false`. The setting defaults to `designTokenPanel`, preserving existing behavior; the invalid `designTokenPanel: true` plus `bundleZdtp: false` combination is rejected before it can ship a mounted panel backed by the throwing stub. (28bb8e8e4)
+
+### Bug Fixes
+
+- `gen:changelog` now rewrites relative `.md`/`.mdx` links to emitted entries as in-file anchors and unlinks other relative document links, keeping published package changelogs free of source-tree-only URLs. It also preserves parenthesized link titles, accounts for Setext headings when suffixing duplicate anchors, and retains case-sensitive filename matching. (267b27d12, 290fb0214)
+- Long site names no longer push the mobile header's right-side controls outside a narrow viewport at increased browser font sizes. The site-name link truncates with an ellipsis while its `title` preserves the full text, and the hamburger button no longer shrinks. Swissgrid and Riso also retain their flat truncation treatment with corrected marker baselines. (cc3a3b053, 104841612, 44fd94899)
+- Home-page hero headings now wrap long unbroken words instead of overflowing their container. (c7e058f68)
+
+### Other Changes
+
+- The `@takazudo/zfb`, `@takazudo/zfb-runtime`, and `@takazudo/zfb-md-wasm` peer dependency floors are now `^2.19.0`. zfb 2.19 adds an opt-in build-shadow diagnostic mode and a parser dependency patch verified equivalent across all 18 upstream baseline cases; it requires no zudo-doc config migration. (4c2048528)
+- Investigated a reported package-route resolution failure on zfb 2.18.0 across 11 consumer topologies, including the reporter's pnpm-workspace symlink shape, without reproducing it. No runtime code or workaround changed; the diagnostic findings remain documented for affected users. (0bd27b8e9)
+
 ## [5.25.0] - 2026-09-16
 
 ### Features
@@ -255,6 +272,9 @@ No unreleased changes.
 
 ### Other Changes
 
+- Enabled Asset Viewer routes now localize automatically for existing multi-locale consumers after a package bump, unless `/${assetViewerRoutePrefix}/` is explicitly present in `defaultLocaleOnlyPrefixes`. (#3820)
+- Migration: because the resource indexes are now locale-owned, a resource section only stays default-locale-only when `defaultLocaleOnlyPrefixes` lists its **overview** prefix — `/docs/claude/` or `/docs/codex/` — alongside the sub-section prefixes (`/docs/claude-md/`, `/docs/claude-skills/`, `/docs/claude-agents/`, `/docs/claude-commands/`, and the Codex equivalents). Listing only the sub-section prefixes does not make the section default-locale-only. With the overview prefix missing, the overview index is generated into every configured locale; if that locale directory already holds an authored `claude/index.mdx` without `generated: true` in its frontmatter, the build fails with `resource-docs: refusing to overwrite authored locale index`. Either add the overview prefix, or remove the authored index and move its title, description, and labels to `ZudoDocConfig.translations`. Remove the prefixes entirely for resource sections you want generated in every configured locale. The rule and both ways out are in the Internationalization guide, under Default-Locale-Only Prefixes. (#3820)
+- Migration: before building with 5.15.0, remove or rename any authored locale resource overview/category `index.mdx` at a generator target and move custom titles, descriptions, and labels to `ZudoDocConfig.translations`. The generator refuses to overwrite an existing file unless its frontmatter contains `generated: true`. (#3820)
 - Updated the zfb peer family to 2.14.2. (`5c5bfd2f`)
 
 ## [5.14.0] - 2026-08-31
@@ -276,8 +296,7 @@ No unreleased changes.
 
 ### Other Changes
 
-- Enabled Asset Viewer routes now localize automatically for existing multi-locale consumers after a package bump, unless `/${assetViewerRoutePrefix}/` is explicitly present in `defaultLocaleOnlyPrefixes`. Existing apps that already carry the legacy Claude/Codex resource prefixes remain default-locale-only after upgrading; remove the prefixes for resource sections you want generated in every configured locale. (#3820)
-- Migration: before building with 5.14.0, remove or rename any authored locale resource overview/category `index.mdx` at a generator target and move custom titles, descriptions, and labels to `ZudoDocConfig.translations`. The generator refuses to overwrite an existing file unless its frontmatter contains `generated: true`. (#3820)
+- Locale-owned Claude/Codex resource indexes and automatically localized Asset Viewer routes ship in [5.15.0](#5150---2026-09-01), not in this release. Before moving on to 5.15.0, add `/docs/claude/` and `/docs/codex/` to `defaultLocaleOnlyPrefixes` if those sections should stay default-locale-only — or remove any authored locale resource `index.mdx` and move its title, description, and labels to `ZudoDocConfig.translations`. The 5.15.0 entry has the full migration. (#3820)
 - Updated the zfb peer family to 2.14.0, `@takazudo/zdtp` to 0.4.14, and the doc-history-server peer floor to 5.13.1. (`dbe8553c7`, `038870c94`, `95a82f15f`)
 
 ## [5.13.1] - 2026-08-28

package/dist/compiled.css

@@ -363,9 +363,6 @@
 .isolate {
   isolation: isolate;
 }
-.z-50 {
-  z-index: 50;
-}
 .z-9999 {
   z-index: 9999;
 }
@@ -552,9 +549,6 @@
 .inline-flex {
   display: inline-flex;
 }
-.list-item {
-  display: list-item;
-}
 .table {
   display: table;
 }
@@ -808,6 +802,9 @@
 .flex-1 {
   flex: 1;
 }
+.shrink {
+  flex-shrink: 1;
+}
 .shrink-0 {
   flex-shrink: 0;
 }
@@ -858,9 +855,6 @@
 .grid-cols-\[auto_1fr\] {
   grid-template-columns: auto 1fr;
 }
-.grid-cols-\[repeat\(auto-fit\,minmax\(12rem\,1fr\)\)\] {
-  grid-template-columns: repeat(auto-fit,minmax(12rem,1fr));
-}
 .grid-rows-\[auto_auto\] {
   grid-template-rows: auto auto;
 }
@@ -1323,9 +1317,6 @@
 .pt-vsp-xs {
   padding-top: var(--spacing-vsp-xs);
 }
-.pr-\[4px\] {
-  padding-right: 4px;
-}
 .pr-hsp-lg {
   padding-right: var(--spacing-hsp-lg);
 }
@@ -1456,6 +1447,9 @@
 .break-words {
   overflow-wrap: break-word;
 }
+.wrap-anywhere {
+  overflow-wrap: anywhere;
+}
 .whitespace-nowrap {
   white-space: nowrap;
 }
@@ -1465,18 +1459,9 @@
 .text-accent {
   color: var(--color-accent);
 }
-.text-accent-hover {
-  color: var(--color-accent-hover);
-}
 .text-bg {
   color: var(--color-bg);
 }
-.text-bg\/70 {
-  color: var(--color-bg);
-  @supports (color: color-mix(in lab, red, red)) {
-    color: color-mix(in oklab, var(--color-bg) 70%, transparent);
-  }
-}
 .text-chat-assistant-text {
   color: var(--color-chat-assistant-text);
 }
@@ -1546,10 +1531,6 @@
 .opacity-60 {
   opacity: 60%;
 }
-.shadow-\[0_1px_3px_color-mix\(in_srgb\,transparent\)\] {
-  --tw-shadow: 0 1px 3px var(--tw-shadow-color, color-mix(in srgb,transparent));
-  box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
-}
 .shadow-\[0_1px_3px_color-mix\(in_srgb\,var\(--color-fg\)_8\%\,transparent\)\] {
   --tw-shadow: 0 1px 3px var(--tw-shadow-color, var(--color-fg));
   @supports (color: color-mix(in lab, red, red)) {
@@ -1557,10 +1538,6 @@
   }
   box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
 }
-.shadow-\[0_1px_3px_color-mix\(in_srgb\,…\)\] {
-  --tw-shadow: 0 1px 3px var(--tw-shadow-color, color-mix(in srgb,…));
-  box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
-}
 .shadow-lg {
   --tw-shadow: 0 10px 15px -3px var(--tw-shadow-color, rgb(0 0 0 / 0.1)), 0 4px 6px -4px var(--tw-shadow-color, rgb(0 0 0 / 0.1));
   box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
@@ -1580,10 +1557,6 @@
   outline-style: var(--tw-outline-style);
   outline-width: 1px;
 }
-.sepia {
-  --tw-sepia: sepia(100%);
-  filter: var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,);
-}
 .filter {
   filter: var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,);
 }
@@ -2345,7 +2318,6 @@
   --color-zd-chat-assistant-text: var(--zd-chat-assistant-text);
   --color-zd-matched-keyword-bg: var(--zd-matched-keyword-bg);
   --color-zd-matched-keyword-fg: var(--zd-matched-keyword-fg);
-  --z-index-content: 0;
   --z-index-local-1: 1;
   --z-index-local-2: 2;
   --z-index-sidebar: 10;

package/dist/config-assertions/index.d.ts

@@ -42,6 +42,32 @@ export interface EmptyStringFaviconOrLogoSubject {
  * object is not an empty string).
  */
 export declare function assertNoEmptyStringFaviconOrLogo(settings: EmptyStringFaviconOrLogoSubject): void;
+/** Structural subset of `Settings` the zdtp-bundling helpers read. */
+export interface ZdtpBundlingSubject {
+    designTokenPanel?: boolean;
+    bundleZdtp?: boolean;
+}
+/**
+ * Resolve whether `@takazudo/zdtp` is bundled into the island build.
+ *
+ * `bundleZdtp` is optional and carries NO `DEFAULT_SETTINGS` key — its default
+ * is derived here, at the read site, from `designTokenPanel`. So a project
+ * that never heard of `bundleZdtp` keeps exactly today's behaviour (#4201):
+ * panel off → zdtp shadowed, panel on → zdtp bundled. Setting `bundleZdtp`
+ * explicitly decouples the two, which is the whole point (#4261): a host that
+ * mounts its own panel through `@takazudo/zudo-doc/design-token-panel-bootstrap`
+ * needs the real loader while the package panel stays off.
+ */
+export declare function resolvesBundleZdtp(settings: ZdtpBundlingSubject): boolean;
+/**
+ * Reject `designTokenPanel: true` together with `bundleZdtp: false`.
+ *
+ * That pair mounts the package-owned panel while shadowing
+ * `@takazudo/zudo-doc/zdtp-loader` with a throwing stub, so the panel's
+ * `loadZdtp()` is guaranteed to reject at runtime — a green build that breaks
+ * in the browser. Fail loudly at config resolution instead (#4261).
+ */
+export declare function assertZdtpBundlingConsistent(settings: ZdtpBundlingSubject): void;
 /**
  * Warn about `categoryMatch` values that cannot express the intended
  * dropdown grouping.

package/dist/config-assertions/index.js

@@ -19,6 +19,16 @@ function assertNoEmptyStringFaviconOrLogo(settings) {
     }
   }
 }
+function resolvesBundleZdtp(settings) {
+  return settings.bundleZdtp ?? settings.designTokenPanel === true;
+}
+function assertZdtpBundlingConsistent(settings) {
+  if (settings.designTokenPanel === true && settings.bundleZdtp === false) {
+    throw new TypeError(
+      "Invalid combination: designTokenPanel: true with bundleZdtp: false. The package-owned design token panel needs @takazudo/zdtp in the build, but bundleZdtp: false shadows @takazudo/zudo-doc/zdtp-loader with a throwing stub, so the panel would fail to load at runtime. Drop bundleZdtp (it follows designTokenPanel by default), or set designTokenPanel: false if you only meant to keep zdtp out of the build."
+    );
+  }
+}
 function warnAmbiguousDropdownCategoryMatch(headerNav, logger = console) {
   if (!headerNav) return;
   for (const item of headerNav) {
@@ -60,5 +70,7 @@ function warnAmbiguousDropdownCategoryMatch(headerNav, logger = console) {
 }
 export {
   assertNoEmptyStringFaviconOrLogo,
+  assertZdtpBundlingConsistent,
+  resolvesBundleZdtp,
   warnAmbiguousDropdownCategoryMatch
 };

package/dist/config.d.ts

@@ -340,6 +340,24 @@ export interface ZudoDocConfig {
      * @default false
      */
     designTokenPanel?: boolean;
+    /**
+     * Bundle `@takazudo/zdtp` into the island build. Controls ONLY whether
+     * `@takazudo/zudo-doc/zdtp-loader` resolves to the real zdtp re-export or to
+     * a throwing stub — it never mounts the package panel or its header trigger
+     * (that stays `designTokenPanel`'s job).
+     *
+     * Set it to `true` when the host mounts its OWN panel through
+     * `@takazudo/zudo-doc/design-token-panel-bootstrap` while leaving
+     * `designTokenPanel` off (#4261); otherwise the bootstrap's `loadZdtp()`
+     * hits the stub and rejects at runtime. The host must then have
+     * `@takazudo/zdtp` installed — it is an optional peer, and the build fails
+     * resolving `zdtp-loader` if it is missing.
+     *
+     * `designTokenPanel: true` with `bundleZdtp: false` is rejected at config
+     * resolution: a mounted package panel with a stubbed loader can only throw.
+     * @default undefined (follows designTokenPanel)
+     */
+    bundleZdtp?: boolean;
     /**
      * Minimum heading depth included in the TOC (2–4).
      * @default 2

package/dist/config.js

@@ -4,7 +4,10 @@ import { defaultDirectiveVocabulary } from "./directive-vocabulary-defaults/inde
 import { defaultTranslations } from "./i18n-defaults/index.js";
 import { defaultColorSchemes } from "./color-schemes-defaults/index.js";
 import { assertNoCommaInVersionSlugs } from "./version-availability/index.js";
-import { assertNoEmptyStringFaviconOrLogo } from "./config-assertions/index.js";
+import {
+  assertNoEmptyStringFaviconOrLogo,
+  assertZdtpBundlingConsistent
+} from "./config-assertions/index.js";
 import { validateAssetViewerSettings } from "./asset-path/index.js";
 function mergeDefaultTranslations(overrides) {
   if (overrides === void 0) return defaultTranslations;
@@ -148,6 +151,7 @@ function zudoDoc(user = {}) {
   );
   assertNoCommaInVersionSlugs(settings.versions);
   assertNoEmptyStringFaviconOrLogo(settings);
+  assertZdtpBundlingConsistent(settings);
   const fragment = zudoDocPreset({
     settings,
     buildDocsSchema: userBuildDocsSchema ?? (() => defaultBuildDocsSchema({

package/dist/header/header.js

@@ -65,7 +65,8 @@ function Header(props) {
           "a",
           {
             href: urlHelpers.withBase(isNonDefaultLocale ? `/${lang}/` : "/"),
-            class: "whitespace-nowrap text-title font-bold text-fg hover:underline focus:underline shrink-0",
+            class: "min-w-0 truncate text-title font-bold text-fg hover:underline focus:underline",
+            title: siteName,
             "data-header-logo": true,
             children: siteName
           }

package/dist/home-page/index.js

@@ -168,7 +168,7 @@ function createHomePageView(ctx) {
               }
             ) : null,
             /* @__PURE__ */ jsxs("div", { class: "zd-home-copy min-w-0 lg:flex-1", children: [
-              /* @__PURE__ */ jsx("h1", { class: "text-heading font-bold mb-vsp-2xs break-words", children: settings.siteName }),
+              /* @__PURE__ */ jsx("h1", { class: "text-heading font-bold mb-vsp-2xs wrap-anywhere", children: settings.siteName }),
               /* @__PURE__ */ jsx("p", { class: "text-muted text-small mb-vsp-sm", children: rawDescription }),
               /* @__PURE__ */ jsx("div", { class: "zd-home-links flex flex-wrap items-center justify-center lg:justify-start gap-hsp-md text-small", children: rowItems.map((item, index) => /* @__PURE__ */ jsxs(Fragment2, { children: [
                 index > 0 && /* @__PURE__ */ jsx("span", { class: "text-muted", children: "/" }),

package/dist/integrations/changelog/generate.js

@@ -1,3 +1,8 @@
+import {
+  buildChangelogAnchorMap,
+  formatChangelogEntryHeadingText,
+  rewriteChangelogEntryLinks
+} from "./links.js";
 function generateChangelogMarkdown(entries, options = {}) {
   const title = options.title ?? "Changelog";
   const lines = [`# ${title}`, ""];
@@ -8,12 +13,13 @@ function generateChangelogMarkdown(entries, options = {}) {
   }
   lines.push("");
   lines.push("The format is based on Keep a Changelog, and release notes are generated from the changelog MDX pages.");
+  const anchorsByFilename = buildChangelogAnchorMap(title, entries);
   for (const entry of entries) {
     lines.push("");
-    lines.push(entry.date ? `## [${entry.version}] - ${entry.date}` : `## [${entry.version}]`);
+    lines.push(`## ${formatChangelogEntryHeadingText(entry)}`);
     if (entry.content) {
       lines.push("");
-      lines.push(entry.content);
+      lines.push(rewriteChangelogEntryLinks(entry.content, anchorsByFilename));
     }
   }
   lines.push("");

package/dist/integrations/changelog/links.d.ts

@@ -0,0 +1,25 @@
+import type { ChangelogEntry } from "./types.js";
+/**
+ * Heading text shared by the emitted `## [version] - date` line and the
+ * anchor map, so the two cannot drift out of step with each other.
+ */
+export declare function formatChangelogEntryHeadingText(entry: Pick<ChangelogEntry, "version" | "date">): string;
+/**
+ * Build the anchor map (exact source filename -> in-file anchor) for a full
+ * generated changelog document. Anchors must reflect the WHOLE document's
+ * heading order, not just the version headings: the `# <title>` line and any
+ * ATX or setext headings inside entry bodies consume slugs too, and an earlier
+ * entry's body heading can shift a later entry's anchor via GitHub's `-1`,
+ * `-2`, … de-duplication.
+ */
+export declare function buildChangelogAnchorMap(title: string, entries: readonly ChangelogEntry[]): ReadonlyMap<string, string>;
+/**
+ * Rewrite one entry's already-sanitized markdown content: same-directory
+ * `.md`/`.mdx` links to another emitted entry become an in-file anchor link
+ * (`#<anchor>`, original `#fragment` dropped, title preserved); any other
+ * relative `.md`/`.mdx` link is unlinked to its label text. Everything else
+ * (absolute URLs, protocol-relative, root-absolute, pure fragments, images,
+ * other extensions, reference-style links, and anything inside fenced or
+ * inline code) passes through byte-unchanged.
+ */
+export declare function rewriteChangelogEntryLinks(content: string, anchorByFilename: ReadonlyMap<string, string>): string;

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/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 {

package/dist/safelist.css

@@ -1,2 +1,2 @@
 /* generated by gen-safelist.mjs — do not edit by hand */
-@source inline("-domtweaker-enabled -elpath-enabled -left-[calc(var(--spacing-icon-lg)/2)] -link -mb-px -ml-hsp-sm -mt-px -noscript -open -state -state-v2 -state-v3 -state-v4 -translate-x-full 2xl:w-[24px] [&::-webkit-details-marker]:hidden [&_a:focus-visible]:text-accent [&_a:hover]:text-accent [&_a]:pointer-events-auto [&_a]:underline [&_li]:mb-0 [&_nav]:mb-0 [asset-viewer] [data-admonition] [data-kbd-shortcut] [data-switcher-launcher] [doc-history-meta] [doc-history] [doc-layout] [img-src-check] [llms-txt] [zudo-doc] a a2 abbr about above absent absolute accent accent- accent:accent- access across activated active actual actually add added admonition admonition- admonition-body admonition-title admonition/callout after after-breadcrumb after-content after-navigate after-sidebar after-title against agent agents ai-chat ai-chat-md ai-chat-trigger alert align align-top all allow allow-same-origin allow-scripts allowed alone already already-executed already-multiline already-picked also alt always an anchor and and/or animate-pulse animate-spin announce ansehen antialiased any anywhere anzeigen app appear application/json application/octet-stream application/pdf application/sql application/toml application/x-httpd-php application/xml application/yaml applied applies apply applying approach approval are area arg argument aria-atomic aria-busy aria-controls aria-current aria-disabled aria-expanded aria-haspopup aria-hidden aria-label aria-labelledby aria-live aria-orientation aria-pressed aria-selected aria-valuemax aria-valuemin aria-valuenow arm arms around arrows article as asc ascii aside aspect-[1200/630] aspect-square asset asset- asset-components assets assets/client assistant async at at-rule attach attribute attributes audio auf author authored auto auto-logo-mask autogenerated availability available avc1 avif avis avoid await away b back backdrop:bg-bg/30 backdrop:bg-bg/80 backdrop:bg-overlay/60 backdrop:z-modal-backdrop background background-color backslashes backtick backticks baked band banner bar bare base base- base64 base:base- based bash batch be bearbeiten because becomes been before below best best-effort between bg bg-[#fff] bg-accent bg-bg bg-chat-assistant-bg bg-chat-user-bg bg-code-bg bg-fg bg-info/10 bg-info/5 bg-muted bg-overlay/30 bg-surface bg-surface/50 bg-transparent bg-warning/10 bg-warning/5 bi big bigint bin binaries bind binding blank blanks block blockquote blocks blur bodies body body-end-components body-end-scripts bold boolean bootstrap border border-accent border-b border-b-2 border-b-[5px] border-bg/30 border-collapse border-danger border-dashed border-fg border-image border-info/30 border-l border-l-0 border-l-[3px] border-left-width border-muted border-none border-r border-r-0 border-radius border-solid border-t border-t-[2px] border-t-[3px] border-transparent border-warning/30 border-width border-y both bottom-hsp-lg bottom-vsp-xl boundaries box box-border br brackets brand breadcrumb:end breadcrumb:start break-words brief broken brown browser browser-tab browsers browses btn budget bug build builder built built-in bundler but button buttons by bypassed byte-identical bytes c cache cached calendar-valid call callable called caller calls can cancellation candidate cannot canonical canvas caption captured captures card card-grid cards carry case-insensitive cases cat-nav- catalog catch categories category caught caution center center/contain ch chains change changed changelog changelogs changes characters check checkbox checked checker child children choose chrome chrome-font ci circle cite cjs class class-less class-mode claude claude-agents claude-commands claude-md claude-resources claude-skills cleaned cleanly clear clearing click client client-router client-side clip clobber clobbering close closed closes closing closure code code-block-sr-announce code-group code-group-panel codex codex-agents codex-agents-md codex-config codex-hooks codex-resources codex-rules codex-skills col col-resize col-span-full col-start-1 colgroup collapse collapses collapsible collision color color-scheme color-scheme-changed color-scheme-provider color-tweak colorization colors column comma command commands commas comment commercial commercial-font-denylist commit compare complete component component:github-link component:language-switcher component:search component:theme-toggle component:version-switcher composes composition compute computed concrete conf config configuration configurations configure configured conflicting conflicts confuse connect const construction consumer consumes contain container containers containing contains content content-admonition content-layer content-link content-type content-wrapper:end content-wrapper:start contents context contract control controller controls converts cookie-blocking copied copy copy-url copyright core corners correct correctly corrupt could count covered covers cpp crashes created cross-component crumb- cs csharp css css-presence csv ctx cur current current-path/index.ts current-route currently cursor cursor-not-allowed cursor-pointer custom cycle d danger dark dash data data-active data-admonition data-asset-details-hidden data-auto-logo data-base data-close-search data-current-locale data-default-locale data-doc-date data-doc-description data-doc-metainfo data-doc-pager data-doc-unavailable-versions data-find-active data-find-match data-footer data-group-id data-header data-header-logo data-header-nav data-header-right data-home-rule data-home-secondary-nav data-kbd-shortcut data-lang data-language-menu data-language-switcher data-language-toggle data-loading-index data-mermaid data-mermaid-enlarge-ready data-mermaid-rendered data-mermaid-src data-nav-active data-nav-category data-nav-item data-nav-item-dropdown data-nav-more data-nav-more-menu data-nav-more-toggle data-no-results data-note-tray-group data-note-tray-row data-open-search data-pan-active data-processed data-props data-result-count-template data-search-count data-search-count-narrow data-search-dialog data-search-input data-search-placeholder data-search-results data-search-unavailable data-sidebar-hidden data-sidebar-resizer data-site-nav data-switcher-card data-switcher-launcher data-tab-btn data-tab-default data-tab-label data-tab-value data-tabs data-taglist-group data-testid data-theme data-theme-pack data-theme-pack-switcher data-theme/style data-toc-hidden data-trailing-slash data-unavailable-label data-variant data-version-banner data-version-latest data-version-menu data-version-rewire data-version-slug data-version-switcher data-version-toggle data-version-trigger-label data-zd-asset-action data-zd-asset-actions data-zd-asset-details data-zd-asset-details-chevron data-zd-asset-details-list data-zd-asset-details-toggle data-zd-asset-index-action data-zd-asset-index-empty data-zd-asset-index-page data-zd-asset-page data-zd-asset-tree data-zd-copy-url data-zd-html-preview-reservation data-zd-label-collapse data-zd-label-expand data-zd-mobile-sidebar data-zd-mobile-toc data-zd-nav-section data-zd-nosidebar data-zd-pending data-zd-props-preserve data-zd-sidebar-open-key data-zd-theme-pack-css data-zd-theme-pack-css-loading data-zd-theme-pack-loading data-zd-toc data-zd-wide data-zfb-island data-zfb-island-remount data-zfb-reload data-zfb-transition-persist date dated dd decimal decision declaration declare declared declares decoration deepest deepest-match default default-transition-duration defaults deferral deferred del delegated delete deliberately delimiter dependency depends depth der desc description design design-token design-token-panel design-token-trigger desktop desktop-sidebar desktop-sidebar-toggle desktop-sidebar-toggle-island desktop-toc-toggle destroys destructive detach detached details determine deterministic dev dfn diagram diagrams dialog did die dieser diff diff-line-added diff-line-content diff-line-empty diff-line-num diff-line-removed diff-row differ different dir directives directly directories directory disabled disabled:cursor-default disabled:opacity-50 disabled:pointer-events-none disc display display:none dist distance distinct div dl do doc doc-card- doc-content-band doc-history doc-history-generate doc-history-panel doc-history-trigger doc-page doc-pager doc-prose doc-title docblock docs docs- docs-v- document document-level documentation documented documents does dog dot double-registration download draft drag drawer drift drifts drop dropdown dropdown-parent dropdowns dt duplicate duration duration-150 duration-200 during dynamically e e2e each eager earlier early ease-in-out edge editing einer either eject ejectable ejectables ejected el element elements els else em embedded emit emitting empty empty/undefined en enable enabled end enhanced enhancement enlarged entire entities entries entry entrypoint env equal error escape escaped escapes even event eventually every everything-enabled exactly example exceeds excerpt excludes exclusively exist existing exists exit expand expected explicit export extends extra f factories failed fall fallback fallbacks falling falls false family fast favicon feature fg field fields fieldset figcaption figure file files fill fills finally find find-match find-match-active fire fires first first-paint first:mt-0 fit fix fixed fixed-width fixtures flag flash flat flex flex-1 flex-col flex-wrap flip flipping flips flow flush-left focus focus-visible:bg-accent/10 focus-visible:border-accent focus-visible:outline-2 focus-visible:outline-accent focus-visible:outline-offset-2 focus-visible:text-accent focus-visible:underline focus-within:border-accent focus-within:z-local-1 focus:border-accent focus:outline-none focus:text-accent focus:underline folder folders follows font font-bold font-face-parity font-family font-file-missing font-medium font-mono font-sans font-scale font-semibold font-size font-weight font-weight-bold font-weight-medium font-weight-normal font-weight-semibold font/woff2 fonts footer footer- for form format former found four-link fox fragment frame free freeze fresh from frontmatter frontmatter-preview frozen frozen-script fs-extra ftyp full fully function further g gains gap-[0.3em] gap-[clamp(1.5rem,3vw,4rem)] gap-hsp-2xs gap-hsp-lg gap-hsp-md gap-hsp-sm gap-hsp-xl gap-hsp-xs gap-vsp-2xs gap-vsp-3xs gap-vsp-lg gap-vsp-md gap-vsp-xs gap-x-hsp-2xs gap-x-hsp-lg gap-x-hsp-md gap-x-hsp-sm gap-x-hsp-xl gap-x-hsp-xs gap-y-vsp-2xs gap-y-vsp-3xs gap-y-vsp-lg gap-y-vsp-md gap-y-vsp-xs gaps gate geladen2026 generate generated generation genuine geometry get getting-started gif git github github-dark github-link give go got grab gradient granular graph grid grid-cols-1 grid-cols-2 grid-cols-[auto_1fr] grid-rows-[auto_auto] 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 grouped grouping guard guards gz h h-[0.5rem] h-[0.625rem] h-[0.875rem] h-[1.125rem] h-[1.25rem] h-[1.575rem] h-[10rem] h-[14px] h-[1em] h-[1lh] h-[2.5rem] h-[2rem] h-[3.5rem] h-[3rem] h-[70vh] h-[90vh] h-[calc(100%-3rem)] h-[calc(100vh-3.5rem)] h-dvh h-full h-icon-lg h-icon-md h-icon-sm h-icon-xs h1 h1s h2 h22013h4 h2s h3 h4 h5 h6 half hand-copied hand-editable handle handled handler handlers happens hard-loaded hardcoded has hash-link have head head-links head-scripts header header- header-call:end header-call:start header-right heading heading-h2 heading-h3 heading-h4 heading-rule headings height here hero hex hi-root hidden hide hierarchical highlight highlighting history home hook hooks hooks-json horizontal host hover:bg-[color-mix(in_srgb,var(--color-surface)_80%,var(--color-fg)_20%)] hover:bg-accent-hover hover:bg-accent/10 hover:bg-danger/10 hover:bg-surface hover:border-accent hover:border-accent-hover hover:border-fg hover:text-accent hover:text-accent-hover hover:text-fg hover:underline hover:z-local-1 hpp hr href hrefs hsp hsp-2xl hsp-2xs hsp-lg hsp-md hsp-sm hsp-xl hsp-xs html i i18n/theme. i2 i3 i4 ico icon icon-lg icon-md icon-sm icon-xs id identical idle idx if iframe ignore ignoring image image-enlarge image-overlay-inset image/avif image/gif image/jpeg image/png image/webp image/x-icon img img-src-check implementation import import/export important important-allowlist imports in inactive includes including incomplete independently index index2026 indirectly info inherit inherited ini initial initialised injected inline inline-block inline-flex inner input input-clear ins inserted-after-color-mode inserted-after-color-scheme inserted-after-site-name inserted-first insertion inset-0 inside inside-only inspect install installation installed instance instanceof instead instructions intended intent intentionally intercept interface internal interpolation into introductions invalid invalidated inverse inversion invocation invoke is is-checker island island-root iso2 iso3 iso4 iso5 iso6 isom ispe issues it italic item item- items items-baseline items-center items-end items-start iteration its itself ja java javascript jpeg jpg js json jsx jumps just justification justify-between justify-center justify-end justify-start katex kbd keep keeping keeps kept key keyboard keyboard-shortcut keydown keys keystroke keyword keywords khroma known-token-names kopieren kotlin kt label landing lands language-menu language-switcher language-toggle larger last:border-b-0 last:pb-0 later latest launch layout lazy leading leading-none leading-normal leading-relaxed leading-snug leading-tight leaf leaf- leak leaves leaving left left-0 left:calc legend legitimate length lets letter-spacing lg lg:block lg:border lg:border-fg lg:border-solid lg:flex lg:flex-1 lg:flex-col lg:flex-row lg:gap-hsp-xl lg:grid-cols-3 lg:grid-cols-[repeat(auto-fit,minmax(12rem,1fr))] lg:h-[90vh] lg:hidden lg:justify-start lg:m-auto lg:max-h-[90vh] lg:max-w-[52.5rem] lg:ml-[var(--zd-sidebar-w)] lg:pr-hsp-sm lg:pt-vsp-2xl lg:px-hsp-2xl lg:py-vsp-2xl lg:text-left lg:w-[90vw] lg:w-[clamp(16rem,25%,22rem)] li li2 library license lifecycle light light/dark like likely line line-height line/statement lines linger link link- links list list-disc list-none listener lists literal literally literals live lives llms llms-txt load loaded loader loading local local-1 local-2 local-3 locale locales log logo long longer longest-match look loses lostpointercapture lower luminance m m-0 m-auto m10 m14 m16 m21 m6 machinery main major make malformed malformed-markup malicious managed manifest manual manually maps mark markdown marks match matches matching math math-display math-inline max max-h-[85vh] max-h-[90vh] max-h-full max-h-none max-w-[16rem] max-w-[64rem] max-w-[85%] max-w-[85vw] max-w-[90vw] max-w-[calc(100vw-2rem)] max-w-[calc(100vw-var(--spacing-hsp-xl))] max-w-[clamp(50rem,75vw,90rem)] max-w-full max-w-none max-w-sm max-width maximum may mb-0 mb-vsp-2xs mb-vsp-lg mb-vsp-md mb-vsp-sm mb-vsp-xl mb-vsp-xs md mdx means measured measurement measures measuring mechanism menu mermaid message messages meta meta-knob meta-schema metadata migration min-h-0 min-h-[20rem] min-h-[44px] min-h-[60vh] min-h-[calc(100vh-3.5rem)] min-h-screen min-w-0 min-w-[10rem] min-w-[3rem] min-w-[44px] min-w-[8rem] minifier minor mirror mirroring mirrors missing mit mjs ml-[calc(var(--spacing-hsp-xl)+1px)] ml-auto ml-hsp-2xl ml-hsp-lg ml-hsp-md ml-hsp-sm ml-hsp-xl mobile mod modal modal-backdrop mode model modify module moment monospace month more most mount mounted mouseenter mouseleave mov move mp4 mp41 mp42 mr-[calc(var(--spacing-hsp-xl)+1px)] mr-hsp-sm ms mt-0 mt-vsp-2xl mt-vsp-2xs mt-vsp-3xs mt-vsp-lg mt-vsp-md mt-vsp-sm mt-vsp-xl mt-vsp-xs multi-changelog multiple must mutates mutation mutations muted mvhd mx-auto my-vsp-lg my-vsp-md n name named names native natural nav nav-active nav-card- nav/doc navigating navigation navigations near needed needs neither nested neutral never new newly-swapped next nicht no no-color-scheme no-data-theme-selector no-enlarge no-op no-repeat no-underline noch node node:buffer node:fs node:fs/promises node:module node:path node:url node:util nodes nofollow noindex non-draggable non-empty non-index non-light-dark non-literal non-null non-persisted nonblank none noopener noreferrer normal noscript not notable note note-tray notes now null number numeric object object-contain observe observer occurred of off offered offsets ofl-required og:description og:image og:image:alt og:image:height og:image:width og:title og:type og:url oklch ol old older omit omitting on once one only onto opacity-60 open open/close option optional or order original other others otherwise out outgoing outline-none output outside over overflow overflow-auto overflow-hidden overflow-x-auto overflow-y-auto overflow-y:auto overlaps override overrides overscroll-contain overwrite own owned p p-0 p-hsp-2xs p-hsp-lg p-hsp-md p-hsp-sm p-hsp-xl pack pack-scoped package package-default package-injected package-owned packages packs padding page page-loading page-loading-overlay page-loading-spinner page-navigate-end page-title page-wide pages pages/. paint paint-and-read palette pan panel panels paragraph paren-balance-aware parent parse parse/render parse5 parsed parser parses part pass passed passes patch path paths pattern payload payload-budget pb-[50vh] pb-vsp-2xs pb-vsp-lg pb-vsp-md pb-vsp-xl pb-vsp-xs pdf peer peer-focus-visible:border-accent peer-focus-visible:text-accent peer-hover:border-accent peer-hover:text-accent pending per per-block per-link per-package per-release percent permanently persisted persistence php pi pick picked picks picocolors pins pipelines pl-[1.25rem] pl-hsp-lg pl-hsp-md pl-hsp-sm pl-hsp-xl place place-items-center placeholder placeholder:text-muted plain plural plus png png16 png32 pnpm point pointer pointer-events-none pointercancel pointerdown pointermove pointerup policy polite polygon polyline popover populates port position position:fixed poster pr-hsp-lg pr-hsp-md pr-hsp-sm pr-hsp-xl pr-hsp-xs pre pre-lowercased preact preact/compat preact/hooks preact/jsx-runtime preconnect preference prefix preload pres present preserving preview preview-swatch-color previews2026 previously primary print prior private produce produced produces producing production profiles project project-owned project-root-relative properties property props prose protocol-relative provided proxy pt-[0.15rem] pt-[2px] pt-vsp-3xs pt-vsp-md pt-vsp-sm pt-vsp-xl pt-vsp-xs ptag- public purely puts px px-hsp-2xl px-hsp-2xs px-hsp-lg px-hsp-md px-hsp-sm px-hsp-xl px-hsp-xs py py-0 py-[2px] py-[4px] py-[calc(var(--spacing-vsp-xs)+0.15rem)] py-hsp-2xs py-hsp-3xs py-hsp-sm py-hsp-xs py-vsp-2xs py-vsp-3xs py-vsp-lg py-vsp-md py-vsp-sm py-vsp-xl py-vsp-xs python q qt query question quick r radius radius-full radius-lg rail ramp range rar rather raw rb re-encode/decode re-exports re-init re-initialized re-querying re-render re-renders re-run re-running re-runs re-selects re-syncs reach reached reaches read reader reader-facing reading readings reads/rewrites real real-value received receives recorded recovers rect redefine redistribution ref- reference referenced references refetch refresh refreshes refusing regardless regenerate regenerates regex registry reinit reinits rejected rel relative release released releases reload relying rem remapped remembered remove remove/rename removed removing rename render rendered renderer renderers renders reorder repaint repair repeated repeating replace replaced replacement replaces repopulate report repository republished requested require required requires reserved resize resize-x resolve resolved resolves responded response restore restores restyle result result-click results results-area retry return returns rev-parse reveal revision revisions rewire rewrite rewrites right right- right-0 right-hsp-lg ring-2 ring-accent risking ro robots role roles root rotate-180 rotate-90 round round-trip rounded rounded-[0.75rem] rounded-bl-[0.25rem] rounded-bl-[1rem] rounded-bl-lg rounded-br-[0.25rem] rounded-br-[1rem] rounded-full rounded-lg rounded-md rounded-t-[1rem] rounds route routed router routes routes-src routes/sitemap.xml row row-span-2 row-start-1 row-start-2 rows rp rs rt ruby rule rules run running runs runtime rust s safe safely safer same same-locale samp sans sans-serif scale scanned scanning scheme scoped scoping score scored script script- script-eval script-evaluation script-injection scripts scroll scrollbar scrolled scrollend scrolling scss seam search search-index section section- see seed segment segments sehen select select-none selection-bg selection-fg selector self self-contained self-hosted self-start self-stretch semantic semibold semver sentinel separator serialised serialize server server-rendered session set sets setting settles setup sh shadow shadow-[0_1px_3px_color-mix(in_srgb,var(--color-fg)_8%,transparent)] shadow-lg shadow-md shadowed shape share shared sharing shell ship shipped ships short shortcut should show shown shrink-0 sidebar sidebar- sidebar-toggle-island sidebar-tree-island sidebar-w sidecar signal silently similarity simple since single single-line single-object-literal singular site site-search site-tree-nav-island sitemap- sites size size-icon-lg skill skills skip skipped skipping skips slash slot slug slug-dir-parity slugs sm:block sm:border sm:border-muted sm:col-start-2 sm:flex sm:flex-row sm:gap-x-hsp-xl sm:grid sm:grid-cols-2 sm:grid-cols-[minmax(0,1fr)_auto] sm:grid-cols-subgrid sm:h-auto sm:hidden sm:items-center sm:justify-between sm:max-h-[80vh] sm:max-w-[52rem] sm:mr-0 sm:mx-auto sm:my-[10vh] sm:rounded-lg sm:row-span-2 sm:row-start-1 small smol-toml smooth snapping snapshot snapshots so soft soft-nav solid some somehow sort source sources space-y-vsp-2xs space-y-vsp-lg space-y-vsp-sm spacing spacing-0 spacing-px span spans spec specifiers specify spelling splitter spread spurious sql square sr-only src srcset stable stack stale standalone start state state- state:state- statement statements status stay staying sticky still stock stop stops stored straddles stray strict string strings strip stripe strips stroke-linecap stroke-linejoin stroke-width strong stronger stub-rendered style style-attribute styles stylesheet sub subagents subsequent substitute substitution subtracting success successful summary sup supply supported surface surfaces survives svg swap swapped swaps swift switcher switching symlink synchronous synchronously syntactically syntax t tab tab-item tab-panel tabindex table tablist tabpanel tabs tabs-container tabs-content tabs-nav tabular-nums tag tag- tag-item- tagged tags tags:audit take tar tbody td temp-element template temporary temporary-element terminal terms test-results tested text text-accent text-bg text-body text-caption text-center text-chat-assistant-text text-chat-user-text text-code-fg text-danger text-decoration text-display text-fg text-fg/60 text-heading text-info text-left text-micro text-muted text-muted/50 text-right text-scale-2xl text-scale-2xs text-scale-lg text-scale-md text-scale-sm text-scale-xl text-scale-xs text-small text-title text-warning text/css text/csv text/html text/javascript text/jsx text/markdown text/mdx text/plain text/tab-separated-values text/tsx text/typescript text/x-c text/x-csharp text/x-go text/x-java-source text/x-kotlin text/x-python text/x-ruby text/x-rust text/x-scss text/x-shellscript text/x-swift textarea tfoot tgz th than that the thead their them theme theme-color theme-pack theme-pack-changed theme-packs theme-packs/index.json theme-toggle theme/token then there these they this those though three threw through throw throws tighten time timeline tip title tkhd to toast toc toggle toggle- toggle-ai-chat toggle-design-token-panel toggles toggling token tokens tolerates toml too toolbar tooltip top top-0 top-[3.5rem] top-full top-hsp-2xs top-level total touches tr track tracked tracking-wide tracking-wider trade-off trailing transclude transferred transition transition-[background,color,border-color] transition-[left,color] transition-[right,color] transition-colors transition-transform translate-x-0 translated translations transparent tray treats tree tree-child- tree-item- tree-top- trigger trigger:ai-chat trigger:design-token-panel triggers true truncate truncated try ts tsv tsx turn twitter:card twitter:creator twitter:description twitter:image twitter:site twitter:title two txt type typeface typeof typescript typography u ul umschalten unable unavailable unbalanced unchanged und undefined under underline underlined underlines understand unit-tested unknown unlike unlisted unmaintained unmatchable unobserve unreadable unrelated unreleased unresolvable unresolved unsafe unset unsupported unterminated until unusable unwrapped up up-to-date update updated upper uppercase url use used useful user uses using usual utf-8 utf8 utilities utility v v2 val value value-reader values var variable variant variants verbatim version version- version-menu version-switcher versions vertical via video video/mp4 video/quicktime video/webm viewer viewing viewport viewports virtual:zudo-doc-asset-bodies virtual:zudo-doc-chrome-bindings virtual:zudo-doc-design-token-panel-config virtual:zudo-doc-route-context visibility visible vocabulary void von vsp vsp-2xl vsp-2xs vsp-3xs vsp-lg vsp-md vsp-sm vsp-xl vsp-xs w w-1/2 w-[0.5rem] w-[0.625rem] w-[0.875rem] w-[1.125rem] w-[1.575rem] w-[1.5rem] w-[1.75rem] w-[12rem] w-[14px] w-[16px] w-[16rem] w-[18px] w-[1em] w-[2.5rem] w-[280px] w-[2rem] w-[320px] w-[360px] w-[6.5rem] w-[90vw] w-[calc(100vw-2rem)] w-[var(--zd-sidebar-w)] w-dvw w-full w-icon-lg w-icon-md w-icon-sm w-icon-xs walk walks want warn warning was watching way wbr wbr- we webm webp website weight went were what when where whereas whether which while whitespace-nowrap whitespace-pre whole whose wide wide-gamut wider-than-scrollbar width will window wins wird wired with without word wordmark working works worktrees would wrap wrapped wrapper wrappers wrapping wraps writing written wrong wrote wurde x xl:flex xl:hidden xlink:href xml y-scrollbar yaml year yet yielded yields yml you your z-dropdown z-local-1 z-modal z-modal-backdrop z-popover z-sidebar z-toolbar zd-asset-code zd-asset-details-rail zd-asset-details-toggle zd-asset-filebar zd-asset-media-grid zd-asset-media-rail zd-asset-page zd-asset-pdf zd-asset-stage zd-compact-prose zd-content zd-desktop-sidebar-toggle zd-desktop-toc-toggle zd-doc-content-band zd-enlarge-btn zd-enlarge-dialog zd-enlarge-dialog-close zd-enlargeable zd-home-copy zd-home-heading zd-home-hero zd-home-inner zd-home-intro zd-home-links zd-home-rule zd-home-sitemap zd-home-tags zd-html-preview-code zd-mermaid-dialog zd-mermaid-enlargeable zd-mermaid-tool-btn zd-mermaid-toolbar zd-mermaid-transform zd-mermaid-viewport zd-sidebar-content-wrapper zd-sidebar-open zd-theme-pack-dialog-title zd-toc-col zdtp zdtp-loader zfb zfb:after-swap zfb:before-preparation zfb:before-swap zip zod zoom zudo-design-token-panel zudo-design-tokens/v3 zudo-doc zudo-doc-asset-details-visible zudo-doc-code-wrap zudo-doc-design-token-panel-modal zudo-doc-design-tokens zudo-doc-sidebar-visible zudo-doc-sidebar-width zudo-doc-theme zudo-doc-theme-pack zudo-doc-toc-visible zudo-doc-tweak zum");
+@source inline("-domtweaker-enabled -elpath-enabled -left-[calc(var(--spacing-icon-lg)/2)] -link -mb-px -ml-hsp-sm -mt-px -noscript -open -state -state-v2 -state-v3 -state-v4 -translate-x-full 2xl:w-[24px] [&::-webkit-details-marker]:hidden [&_a:focus-visible]:text-accent [&_a:hover]:text-accent [&_a]:pointer-events-auto [&_a]:underline [&_li]:mb-0 [&_nav]:mb-0 [asset-viewer] [data-admonition] [data-kbd-shortcut] [data-switcher-launcher] [doc-history-meta] [doc-history] [doc-layout] [img-src-check] [llms-txt] [zudo-doc] a a2 abbr about above absent absolute accent accent- accent:accent- access across activated active actual actually add added admonition admonition- admonition-body admonition-title admonition/callout after after-breadcrumb after-content after-navigate after-sidebar after-title against agent agents ai-chat ai-chat-md ai-chat-trigger alert align align-top all allow allow-same-origin allow-scripts allowed alone already already-executed already-multiline already-picked also alt always an anchor and and/or animate-pulse animate-spin announce ansehen antialiased any anywhere anzeigen app appear application/json application/octet-stream application/pdf application/sql application/toml application/x-httpd-php application/xml application/yaml applied applies apply applying approach approval are area arg argument aria-atomic aria-busy aria-controls aria-current aria-disabled aria-expanded aria-haspopup aria-hidden aria-label aria-labelledby aria-live aria-orientation aria-pressed aria-selected aria-valuemax aria-valuemin aria-valuenow arm arms around arrows article as asc ascii aside aspect-[1200/630] aspect-square asset asset- asset-components assets assets/client assistant async at at-rule attach attribute attributes audio auf author authored auto auto-logo-mask autogenerated availability available avc1 avif avis avoid await away b back backdrop:bg-bg/30 backdrop:bg-bg/80 backdrop:bg-overlay/60 backdrop:z-modal-backdrop background background-color backslashes backtick backticks baked band banner bar bare base base- base64 base:base- based bash batch be bearbeiten because becomes been before below best best-effort between bg bg-[#fff] bg-accent bg-bg bg-chat-assistant-bg bg-chat-user-bg bg-code-bg bg-fg bg-info/10 bg-info/5 bg-muted bg-overlay/30 bg-surface bg-surface/50 bg-transparent bg-warning/10 bg-warning/5 bi big bigint bin binaries bind binding blank blanks block blockquote blocks blur bodies body body-end-components body-end-scripts bold boolean bootstrap border border-accent border-b border-b-2 border-b-[5px] border-bg/30 border-collapse border-danger border-dashed border-fg border-image border-info/30 border-l border-l-0 border-l-[3px] border-left-width border-muted border-none border-r border-r-0 border-radius border-solid border-t border-t-[2px] border-t-[3px] border-transparent border-warning/30 border-width border-y both bottom-hsp-lg bottom-vsp-xl boundaries box box-border br brackets brand breadcrumb:end breadcrumb:start break-words brief broken brown browser browser-tab browsers browses btn budget bug build builder built built-in bundler but button buttons by bypassed byte-identical bytes c cache cached calendar-valid call callable called caller calls can cancellation candidate cannot canonical canvas caption captured captures card card-grid cards carry case-insensitive cases cat-nav- catalog catch categories category caught caution center center/contain ch chains change changed changelog changelogs changes characters check checkbox checked checker child children choose chrome chrome-font ci circle cite cjs class class-less class-mode claude claude-agents claude-commands claude-md claude-resources claude-skills cleaned cleanly clear clearing click client client-router client-side clip clobber clobbering close closed closes closing closure code code-block-sr-announce code-group code-group-panel codex codex-agents codex-agents-md codex-config codex-hooks codex-resources codex-rules codex-skills col col-resize col-span-full col-start-1 colgroup collapse collapses collapsible collision color color-scheme color-scheme-changed color-scheme-provider color-tweak colorization colors column comma command commands commas comment commercial commercial-font-denylist commit compare complete component component:github-link component:language-switcher component:search component:theme-toggle component:version-switcher composes composition compute computed concrete conf config configuration configurations configure configured conflicting conflicts confuse connect const construction consumer consumes contain container containers containing contains content content-admonition content-layer content-link content-type content-wrapper:end content-wrapper:start contents context contract control controller controls converts cookie-blocking copied copy copy-url copyright core corners correct correctly corrupt could count covered covers cpp crashes created cross-component crumb- cs csharp css css-presence csv ctx cur current current-path/index.ts current-route currently cursor cursor-not-allowed cursor-pointer custom cycle d danger dark dash data data-active data-admonition data-asset-details-hidden data-auto-logo data-base data-close-search data-current-locale data-default-locale data-doc-date data-doc-description data-doc-metainfo data-doc-pager data-doc-unavailable-versions data-find-active data-find-match data-footer data-group-id data-header data-header-logo data-header-nav data-header-right data-home-rule data-home-secondary-nav data-kbd-shortcut data-lang data-language-menu data-language-switcher data-language-toggle data-loading-index data-mermaid data-mermaid-enlarge-ready data-mermaid-rendered data-mermaid-src data-nav-active data-nav-category data-nav-item data-nav-item-dropdown data-nav-more data-nav-more-menu data-nav-more-toggle data-no-results data-note-tray-group data-note-tray-row data-open-search data-pan-active data-processed data-props data-result-count-template data-search-count data-search-count-narrow data-search-dialog data-search-input data-search-placeholder data-search-results data-search-unavailable data-sidebar-hidden data-sidebar-resizer data-site-nav data-switcher-card data-switcher-launcher data-tab-btn data-tab-default data-tab-label data-tab-value data-tabs data-taglist-group data-testid data-theme data-theme-pack data-theme-pack-switcher data-theme/style data-toc-hidden data-trailing-slash data-unavailable-label data-variant data-version-banner data-version-latest data-version-menu data-version-rewire data-version-slug data-version-switcher data-version-toggle data-version-trigger-label data-zd-asset-action data-zd-asset-actions data-zd-asset-details data-zd-asset-details-chevron data-zd-asset-details-list data-zd-asset-details-toggle data-zd-asset-index-action data-zd-asset-index-empty data-zd-asset-index-page data-zd-asset-page data-zd-asset-tree data-zd-copy-url data-zd-html-preview-reservation data-zd-label-collapse data-zd-label-expand data-zd-mobile-sidebar data-zd-mobile-toc data-zd-nav-section data-zd-nosidebar data-zd-pending data-zd-props-preserve data-zd-sidebar-open-key data-zd-theme-pack-css data-zd-theme-pack-css-loading data-zd-theme-pack-loading data-zd-toc data-zd-wide data-zfb-island data-zfb-island-remount data-zfb-reload data-zfb-transition-persist date dated dd decimal decision declaration declare declared declares decoration deepest deepest-match default default-transition-duration defaults deferral deferred del delegated delete deliberately delimiter dependency depends depth der desc description design design-token design-token-panel design-token-trigger desktop desktop-sidebar desktop-sidebar-toggle desktop-sidebar-toggle-island desktop-toc-toggle destroys destructive detach detached details determine deterministic dev dfn diagram diagrams dialog did die dieser diff diff-line-added diff-line-content diff-line-empty diff-line-num diff-line-removed diff-row differ different dir directives directly directories directory disabled disabled:cursor-default disabled:opacity-50 disabled:pointer-events-none disc display display:none dist distance distinct div dl do doc doc-card- doc-content-band doc-history doc-history-generate doc-history-panel doc-history-trigger doc-page doc-pager doc-prose doc-title docblock docs docs- docs-v- document document-level documentation documented documents does dog dot double-registration download draft drag drawer drift drifts drop dropdown dropdown-parent dropdowns dt duplicate duration duration-150 duration-200 during dynamically e e2e each eager earlier early ease-in-out edge editing einer either eject ejectable ejectables ejected el element elements els else em embedded emit emitting empty empty/undefined en enable enabled end enhanced enhancement enlarged entire entities entries entry entrypoint env equal error escape escaped escapes even event eventually every everything-enabled exactly example exceeds excerpt excludes exclusively exist existing exists exit expand expected explicit export extends extra f factories fail failed fall fallback fallbacks falling falls false family fast favicon feature fg field fields fieldset figcaption figure file files fill fills finally find find-match find-match-active fire fires first first-paint first:mt-0 fit fix fixed fixed-width fixtures flag flash flat flex flex-1 flex-col flex-wrap flip flipping flips flow flush-left focus focus-visible:bg-accent/10 focus-visible:border-accent focus-visible:outline-2 focus-visible:outline-accent focus-visible:outline-offset-2 focus-visible:text-accent focus-visible:underline focus-within:border-accent focus-within:z-local-1 focus:border-accent focus:outline-none focus:text-accent focus:underline folder folders follows font font-bold font-face-parity font-family font-file-missing font-medium font-mono font-sans font-scale font-semibold font-size font-weight font-weight-bold font-weight-medium font-weight-normal font-weight-semibold font/woff2 fonts footer footer- for form format former found four-link fox fragment frame free freeze fresh from frontmatter frontmatter-preview frozen frozen-script fs-extra ftyp full fully function further g gains gap-[0.3em] gap-[clamp(1.5rem,3vw,4rem)] gap-hsp-2xs gap-hsp-lg gap-hsp-md gap-hsp-sm gap-hsp-xl gap-hsp-xs gap-vsp-2xs gap-vsp-3xs gap-vsp-lg gap-vsp-md gap-vsp-xs gap-x-hsp-2xs gap-x-hsp-lg gap-x-hsp-md gap-x-hsp-sm gap-x-hsp-xl gap-x-hsp-xs gap-y-vsp-2xs gap-y-vsp-3xs gap-y-vsp-lg gap-y-vsp-md gap-y-vsp-xs gaps gate geladen2026 generate generated generation genuine geometry get getting-started gif git github github-dark github-link give go got grab gradient granular graph grid grid-cols-1 grid-cols-2 grid-cols-[auto_1fr] grid-rows-[auto_auto] 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 grouped grouping guard guards gz h h-[0.5rem] h-[0.625rem] h-[0.875rem] h-[1.125rem] h-[1.25rem] h-[1.575rem] h-[10rem] h-[14px] h-[1em] h-[1lh] h-[2.5rem] h-[2rem] h-[3.5rem] h-[3rem] h-[70vh] h-[90vh] h-[calc(100%-3rem)] h-[calc(100vh-3.5rem)] h-dvh h-full h-icon-lg h-icon-md h-icon-sm h-icon-xs h1 h1s h2 h22013h4 h2s h3 h4 h5 h6 half hand-copied hand-editable handle handled handler handlers happens hard-loaded hardcoded has hash-link have head head-links head-scripts header header- header-call:end header-call:start header-right heading heading-h2 heading-h3 heading-h4 heading-rule headings height here hero hex hi-root hidden hide hierarchical highlight highlighting history home hook hooks hooks-json horizontal host hover:bg-[color-mix(in_srgb,var(--color-surface)_80%,var(--color-fg)_20%)] hover:bg-accent-hover hover:bg-accent/10 hover:bg-danger/10 hover:bg-surface hover:border-accent hover:border-accent-hover hover:border-fg hover:text-accent hover:text-accent-hover hover:text-fg hover:underline hover:z-local-1 hpp hr href hrefs hsp hsp-2xl hsp-2xs hsp-lg hsp-md hsp-sm hsp-xl hsp-xs html i i18n/theme. i2 i3 i4 ico icon icon-lg icon-md icon-sm icon-xs id identical idle idx if iframe ignore ignoring image image-enlarge image-overlay-inset image/avif image/gif image/jpeg image/png image/webp image/x-icon img img-src-check implementation import import/export important important-allowlist imports in inactive includes including incomplete independently index index2026 indirectly info inherit inherited ini initial initialised injected inline inline-block inline-flex inner input input-clear ins inserted-after-color-mode inserted-after-color-scheme inserted-after-site-name inserted-first insertion inset-0 inside inside-only inspect install installation installed instance instanceof instead instructions intended intent intentionally intercept interface internal interpolation into introductions invalid invalidated inverse inversion invocation invoke is is-checker island island-root iso2 iso3 iso4 iso5 iso6 isom ispe issues it italic item item- items items-baseline items-center items-end items-start iteration its itself ja java javascript jpeg jpg js json jsx jumps just justification justify-between justify-center justify-end justify-start katex kbd keep keeping keeps kept key keyboard keyboard-shortcut keydown keys keystroke keyword keywords khroma known-token-names kopieren kotlin kt label landing lands language-menu language-switcher language-toggle larger last:border-b-0 last:pb-0 later latest launch layout lazy leading leading-none leading-normal leading-relaxed leading-snug leading-tight leaf leaf- leak leaves leaving left left-0 left:calc legend legitimate length lets letter-spacing lg lg:block lg:border lg:border-fg lg:border-solid lg:flex lg:flex-1 lg:flex-col lg:flex-row lg:gap-hsp-xl lg:grid-cols-3 lg:grid-cols-[repeat(auto-fit,minmax(12rem,1fr))] lg:h-[90vh] lg:hidden lg:justify-start lg:m-auto lg:max-h-[90vh] lg:max-w-[52.5rem] lg:ml-[var(--zd-sidebar-w)] lg:pr-hsp-sm lg:pt-vsp-2xl lg:px-hsp-2xl lg:py-vsp-2xl lg:text-left lg:w-[90vw] lg:w-[clamp(16rem,25%,22rem)] li li2 library license lifecycle light light/dark like likely line line-height line/statement lines linger link link- links list list-disc list-none listener lists literal literally literals live lives llms llms-txt load loaded loader loading local local-1 local-2 local-3 locale locales log logo long longer longest-match look loses lostpointercapture lower luminance m m-0 m-auto m10 m14 m16 m21 m6 machinery main major make malformed malformed-markup malicious managed manifest manual manually maps mark markdown marks match matches matching math math-display math-inline max max-h-[85vh] max-h-[90vh] max-h-full max-h-none max-w-[16rem] max-w-[64rem] max-w-[85%] max-w-[85vw] max-w-[90vw] max-w-[calc(100vw-2rem)] max-w-[calc(100vw-var(--spacing-hsp-xl))] max-w-[clamp(50rem,75vw,90rem)] max-w-full max-w-none max-w-sm max-width maximum may mb-0 mb-vsp-2xs mb-vsp-lg mb-vsp-md mb-vsp-sm mb-vsp-xl mb-vsp-xs md mdx means meant measured measurement measures measuring mechanism menu mermaid message messages meta meta-knob meta-schema metadata migration min-h-0 min-h-[20rem] min-h-[44px] min-h-[60vh] min-h-[calc(100vh-3.5rem)] min-h-screen min-w-0 min-w-[10rem] min-w-[3rem] min-w-[44px] min-w-[8rem] minifier minor mirror mirroring mirrors missing mit mjs ml-[calc(var(--spacing-hsp-xl)+1px)] ml-auto ml-hsp-2xl ml-hsp-lg ml-hsp-md ml-hsp-sm ml-hsp-xl mobile mod modal modal-backdrop mode model modify module moment monospace month more most mount mounted mouseenter mouseleave mov move mp4 mp41 mp42 mr-[calc(var(--spacing-hsp-xl)+1px)] mr-hsp-sm ms mt-0 mt-vsp-2xl mt-vsp-2xs mt-vsp-3xs mt-vsp-lg mt-vsp-md mt-vsp-sm mt-vsp-xl mt-vsp-xs multi-changelog multiple must mutates mutation mutations muted mvhd mx-auto my-vsp-lg my-vsp-md n name named names native natural nav nav-active nav-card- nav/doc navigating navigation navigations near needed needs neither nested neutral never new newly-swapped next nicht no no-color-scheme no-data-theme-selector no-enlarge no-op no-repeat no-underline noch node node:buffer node:fs node:fs/promises node:module node:path node:url node:util nodes nofollow noindex non-draggable non-empty non-index non-light-dark non-literal non-null non-persisted nonblank none noopener noreferrer normal noscript not notable note note-tray notes now null number numeric object object-contain observe observer occurred of off offered offsets ofl-required og:description og:image og:image:alt og:image:height og:image:width og:title og:type og:url oklch ol old older omit omitting on once one only onto opacity-60 open open/close option optional or order original other others otherwise out outgoing outline-none output outside over overflow overflow-auto overflow-hidden overflow-x-auto overflow-y-auto overflow-y:auto overlaps override overrides overscroll-contain overwrite own owned p p-0 p-hsp-2xs p-hsp-lg p-hsp-md p-hsp-sm p-hsp-xl pack pack-scoped package package-default package-injected package-owned packages packs padding page page-loading page-loading-overlay page-loading-spinner page-navigate-end page-title page-wide pages pages/. paint paint-and-read palette pan panel panels paragraph paren-balance-aware parent parse parse/render parse5 parsed parser parses part pass passed passes patch path paths pattern payload payload-budget pb-[50vh] pb-vsp-2xs pb-vsp-lg pb-vsp-md pb-vsp-xl pb-vsp-xs pdf peer peer-focus-visible:border-accent peer-focus-visible:text-accent peer-hover:border-accent peer-hover:text-accent pending per per-block per-link per-package per-release percent permanently persisted persistence php pi pick picked picks picocolors pins pipelines pl-[1.25rem] pl-hsp-lg pl-hsp-md pl-hsp-sm pl-hsp-xl place place-items-center placeholder placeholder:text-muted plain plural plus png png16 png32 pnpm point pointer pointer-events-none pointercancel pointerdown pointermove pointerup policy polite polygon polyline popover populates port position position:fixed poster pr-hsp-lg pr-hsp-md pr-hsp-sm pr-hsp-xl pr-hsp-xs pre pre-lowercased preact preact/compat preact/hooks preact/jsx-runtime preconnect preference prefix preload pres present preserving preview preview-swatch-color previews2026 previously primary print prior private produce produced produces producing production profiles project project-owned project-root-relative properties property props prose protocol-relative provided proxy pt-[0.15rem] pt-[2px] pt-vsp-3xs pt-vsp-md pt-vsp-sm pt-vsp-xl pt-vsp-xs ptag- public purely puts px px-hsp-2xl px-hsp-2xs px-hsp-lg px-hsp-md px-hsp-sm px-hsp-xl px-hsp-xs py py-0 py-[2px] py-[4px] py-[calc(var(--spacing-vsp-xs)+0.15rem)] py-hsp-2xs py-hsp-3xs py-hsp-sm py-hsp-xs py-vsp-2xs py-vsp-3xs py-vsp-lg py-vsp-md py-vsp-sm py-vsp-xl py-vsp-xs python q qt query question quick r radius radius-full radius-lg rail ramp range rar rather raw rb re-encode/decode re-exports re-init re-initialized re-querying re-render re-renders re-run re-running re-runs re-selects re-syncs reach reached reaches read reader reader-facing reading readings reads/rewrites real real-value received receives recorded recovers rect redefine redistribution ref- reference referenced references refetch refresh refreshes refusing regardless regenerate regenerates regex registry reinit reinits rejected rel relative release released releases reload relying rem remapped remembered remove remove/rename removed removing rename render rendered renderer renderers renders reorder repaint repair repeated repeating replace replaced replacement replaces repopulate report repository republished requested require required requires reserved resize resize-x resolve resolved resolves responded response restore restores restyle result result-click results results-area retry return returns rev-parse reveal revision revisions rewire rewrite rewrites right right- right-0 right-hsp-lg ring-2 ring-accent risking ro robots role roles root rotate-180 rotate-90 round round-trip rounded rounded-[0.75rem] rounded-bl-[0.25rem] rounded-bl-[1rem] rounded-bl-lg rounded-br-[0.25rem] rounded-br-[1rem] rounded-full rounded-lg rounded-md rounded-t-[1rem] rounds route routed router routes routes-src routes/sitemap.xml row row-span-2 row-start-1 row-start-2 rows rp rs rt ruby rule rules run running runs runtime rust s safe safely safer same same-locale samp sans sans-serif scale scanned scanning scheme scoped scoping score scored script script- script-eval script-evaluation script-injection scripts scroll scrollbar scrolled scrollend scrolling scss seam search search-index section section- see seed segment segments sehen select select-none selection-bg selection-fg selector self self-contained self-hosted self-start self-stretch semantic semibold semver sentinel separator serialised serialize server server-rendered session set sets setting settles setup sh shadow shadow-[0_1px_3px_color-mix(in_srgb,var(--color-fg)_8%,transparent)] shadow-lg shadow-md shadowed shadows shape share shared sharing shell ship shipped ships short shortcut should show shown shrink-0 sidebar sidebar- sidebar-toggle-island sidebar-tree-island sidebar-w sidecar signal silently similarity simple since single single-line single-object-literal singular site site-search site-tree-nav-island sitemap- sites size size-icon-lg skill skills skip skipped skipping skips slash slot slug slug-dir-parity slugs sm:block sm:border sm:border-muted sm:col-start-2 sm:flex sm:flex-row sm:gap-x-hsp-xl sm:grid sm:grid-cols-2 sm:grid-cols-[minmax(0,1fr)_auto] sm:grid-cols-subgrid sm:h-auto sm:hidden sm:items-center sm:justify-between sm:max-h-[80vh] sm:max-w-[52rem] sm:mr-0 sm:mx-auto sm:my-[10vh] sm:rounded-lg sm:row-span-2 sm:row-start-1 small smol-toml smooth snapping snapshot snapshots so soft soft-nav solid some somehow sort source sources space-y-vsp-2xs space-y-vsp-lg space-y-vsp-sm spacing spacing-0 spacing-px span spans spec specifiers specify spelling splitter spread spurious sql square sr-only src srcset stable stack stale standalone start state state- state:state- statement statements status stay staying sticky still stock stop stops stored straddles stray strict string strings strip stripe strips stroke-linecap stroke-linejoin stroke-width strong stronger stub-rendered style style-attribute styles stylesheet sub subagents subsequent substitute substitution subtracting success successful summary sup supply supported surface surfaces survives svg swap swapped swaps swift switcher switching symlink synchronous synchronously syntactically syntax t tab tab-item tab-panel tabindex table tablist tabpanel tabs tabs-container tabs-content tabs-nav tabular-nums tag tag- tag-item- tagged tags tags:audit take tar tbody td temp-element template temporary temporary-element terminal terms test-results tested text text-accent text-bg text-body text-caption text-center text-chat-assistant-text text-chat-user-text text-code-fg text-danger text-decoration text-display text-fg text-fg/60 text-heading text-info text-left text-micro text-muted text-muted/50 text-right text-scale-2xl text-scale-2xs text-scale-lg text-scale-md text-scale-sm text-scale-xl text-scale-xs text-small text-title text-warning text/css text/csv text/html text/javascript text/jsx text/markdown text/mdx text/plain text/tab-separated-values text/tsx text/typescript text/x-c text/x-csharp text/x-go text/x-java-source text/x-kotlin text/x-python text/x-ruby text/x-rust text/x-scss text/x-shellscript text/x-swift textarea tfoot tgz th than that the thead their them theme theme-color theme-pack theme-pack-changed theme-packs theme-packs/index.json theme-toggle theme/token then there these they this those though three threw through throw throwing throws tighten time timeline tip title tkhd to toast toc toggle toggle- toggle-ai-chat toggle-design-token-panel toggles toggling token tokens tolerates toml too toolbar tooltip top top-0 top-[3.5rem] top-full top-hsp-2xs top-level total touches tr track tracked tracking-wide tracking-wider trade-off trailing transclude transferred transition transition-[background,color,border-color] transition-[left,color] transition-[right,color] transition-colors transition-transform translate-x-0 translated translations transparent tray treats tree tree-child- tree-item- tree-top- trigger trigger:ai-chat trigger:design-token-panel triggers true truncate truncated try ts tsv tsx turn twitter:card twitter:creator twitter:description twitter:image twitter:site twitter:title two txt type typeface typeof typescript typography u ul umschalten unable unavailable unbalanced unchanged und undefined under underline underlined underlines understand unit-tested unknown unlike unlisted unmaintained unmatchable unobserve unreadable unrelated unreleased unresolvable unresolved unsafe unset unsupported unterminated until unusable unwrapped up up-to-date update updated upper uppercase url use used useful user uses using usual utf-8 utf8 utilities utility v v2 val value value-reader values var variable variant variants verbatim version version- version-menu version-switcher versions vertical via video video/mp4 video/quicktime video/webm viewer viewing viewport viewports virtual:zudo-doc-asset-bodies virtual:zudo-doc-chrome-bindings virtual:zudo-doc-design-token-panel-config virtual:zudo-doc-route-context visibility visible vocabulary void von vsp vsp-2xl vsp-2xs vsp-3xs vsp-lg vsp-md vsp-sm vsp-xl vsp-xs w w-1/2 w-[0.5rem] w-[0.625rem] w-[0.875rem] w-[1.125rem] w-[1.575rem] w-[1.5rem] w-[1.75rem] w-[12rem] w-[14px] w-[16px] w-[16rem] w-[18px] w-[1em] w-[2.5rem] w-[280px] w-[2rem] w-[320px] w-[360px] w-[6.5rem] w-[90vw] w-[calc(100vw-2rem)] w-[var(--zd-sidebar-w)] w-dvw w-full w-icon-lg w-icon-md w-icon-sm w-icon-xs walk walks want warn warning was watching way wbr wbr- we webm webp website weight went were what when where whereas whether which while whitespace-nowrap whitespace-pre whole whose wide wide-gamut wider-than-scrollbar width will window wins wird wired with without word wordmark working works worktrees would wrap wrap-anywhere wrapped wrapper wrappers wrapping wraps writing written wrong wrote wurde x xl:flex xl:hidden xlink:href xml y-scrollbar yaml year yet yielded yields yml you your z-dropdown z-local-1 z-modal z-modal-backdrop z-popover z-sidebar z-toolbar zd-asset-code zd-asset-details-rail zd-asset-details-toggle zd-asset-filebar zd-asset-media-grid zd-asset-media-rail zd-asset-page zd-asset-pdf zd-asset-stage zd-compact-prose zd-content zd-desktop-sidebar-toggle zd-desktop-toc-toggle zd-doc-content-band zd-enlarge-btn zd-enlarge-dialog zd-enlarge-dialog-close zd-enlargeable zd-home-copy zd-home-heading zd-home-hero zd-home-inner zd-home-intro zd-home-links zd-home-rule zd-home-sitemap zd-home-tags zd-html-preview-code zd-mermaid-dialog zd-mermaid-enlargeable zd-mermaid-tool-btn zd-mermaid-toolbar zd-mermaid-transform zd-mermaid-viewport zd-sidebar-content-wrapper zd-sidebar-open zd-theme-pack-dialog-title zd-toc-col zdtp zdtp-loader zfb zfb:after-swap zfb:before-preparation zfb:before-swap zip zod zoom zudo-design-token-panel zudo-design-tokens/v3 zudo-doc zudo-doc-asset-details-visible zudo-doc-code-wrap zudo-doc-design-token-panel-modal zudo-doc-design-tokens zudo-doc-sidebar-visible zudo-doc-sidebar-width zudo-doc-theme zudo-doc-theme-pack zudo-doc-toc-visible zudo-doc-tweak zum");

package/dist/settings.d.ts

@@ -407,6 +407,13 @@ export interface Settings {
     aiChatAllowedOrigins: string[];
     aiChatGlobalDailyLimit: number | false;
     designTokenPanel: boolean;
+    /**
+     * Bundle `@takazudo/zdtp` into the island build, independently of whether
+     * the package panel mounts. Optional with no `DEFAULT_SETTINGS` key — it is
+     * resolved at the read site as `bundleZdtp ?? designTokenPanel`. Full
+     * contract: `ZudoDocConfig.bundleZdtp` in `config.ts`.
+     */
+    bundleZdtp?: boolean;
     tocMinDepth: number;
     tocMaxDepth: number;
     sidebarResizer: boolean;

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

@@ -39,7 +39,7 @@ function SidebarToggle({
       {
         type: "button",
         onClick: () => setOpen(!open),
-        className: "lg:hidden px-hsp-sm py-vsp-xs -ml-hsp-sm mr-hsp-sm text-muted hover:text-fg",
+        className: "lg:hidden shrink-0 px-hsp-sm py-vsp-xs -ml-hsp-sm mr-hsp-sm text-muted hover:text-fg",
         "aria-label": open ? "Close sidebar" : "Open sidebar",
         "aria-expanded": open,
         children: [

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

@@ -235,20 +235,22 @@ html[data-theme-pack="riso"] header[data-header] {
   border-bottom: 3px solid var(--zd-accent);
 }
 html[data-theme-pack="riso"] [data-header-logo] {
-  display: inline-flex;
-  align-items: center;
-  gap: 0.55rem;
   font-family: var(--font-display);
   font-weight: 400;
   letter-spacing: 0.01em;
 }
 html[data-theme-pack="riso"] [data-header-logo]::before {
   content: "";
+  display: inline-block;
   width: 0.7em;
   height: 0.7em;
-  flex-shrink: 0;
   background: var(--zd-accent);
   box-shadow: 0.16em 0.16em 0 0 light-dark(#ff5b41, #ff7a5f);
+  margin-right: 0.55rem;
+  /* -0.03em: measured against the marker's pre-#4306 flex-centered
+     position — pixel-identical at 1280px and at 390px/24px. The display
+     font's baseline differs from swissgrid's, so the offsets differ. */
+  vertical-align: -0.03em;
 }
 html[data-theme-pack="riso"] [data-nav-item]:hover {
   text-decoration-line: underline;

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

@@ -204,18 +204,21 @@ html[data-theme-pack="swissgrid"] header[data-header] {
   border-bottom: 3px solid var(--zd-fg);
 }
 html[data-theme-pack="swissgrid"] [data-header-logo] {
-  display: inline-flex;
-  align-items: center;
-  gap: 0.55rem;
   font-weight: 900;
   letter-spacing: -0.03em;
 }
 html[data-theme-pack="swissgrid"] [data-header-logo]::before {
   content: "";
+  display: inline-block;
   width: 0.72em;
   height: 0.72em;
-  flex-shrink: 0;
   background: #ff0000;
+  margin-right: 0.55rem;
+  /* `baseline` is also the initial value — stated explicitly because it was
+     the measured outcome: it reproduces the marker's pre-#4306 flex-centered
+     position to within half a pixel at 1280px and at 390px/24px. Do not read
+     it as a tuned offset (riso needs one; this pack does not). */
+  vertical-align: baseline;
 }
 html[data-theme-pack="swissgrid"] [data-nav-item] {
   text-transform: uppercase;

package/eject/header/header.tsx

@@ -352,7 +352,17 @@ export function Header(props: HeaderProps): JSX.Element {
 
       <a
         href={urlHelpers.withBase(isNonDefaultLocale ? `/${lang}/` : "/")}
-        class="whitespace-nowrap text-title font-bold text-fg hover:underline focus:underline shrink-0"
+        // The site name is the row's only item that can actually give ground:
+        // the right cluster is pinned against shrinking, the mobile-toggle
+        // slot cannot go below its button's min-content width, and the nav's
+        // zero flex basis zeroes its scaled shrink factor. So a width deficit
+        // is absorbed here as an ellipsis instead of pushing the right
+        // controls past the viewport edge (zudolab/zudo-doc#4287).
+        // Do not name Tailwind utilities in prose here — the content scanner
+        // reads them as class candidates; use the `safelist-ok:` marker if a
+        // future note must (see scripts/check-package-safelist.mjs).
+        class="min-w-0 truncate text-title font-bold text-fg hover:underline focus:underline"
+        title={siteName}
         data-header-logo
       >
         {siteName}

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

@@ -108,7 +108,7 @@ export function SidebarToggle({
       <button
         type="button"
         onClick={() => setOpen(!open)}
-        className="lg:hidden px-hsp-sm py-vsp-xs -ml-hsp-sm mr-hsp-sm text-muted hover:text-fg"
+        className="lg:hidden shrink-0 px-hsp-sm py-vsp-xs -ml-hsp-sm mr-hsp-sm text-muted hover:text-fg"
         aria-label={open ? "Close sidebar" : "Open sidebar"}
         aria-expanded={open}
       >

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zudo-doc",
-  "version": "5.25.0",
+  "version": "5.26.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",
@@ -717,9 +717,9 @@
   ],
   "peerDependencies": {
     "@takazudo/zdtp": "^0.5.2 || ^0.6.0 || ^0.7.0 || ^0.8.0",
-    "@takazudo/zfb": "^2.18.0",
-    "@takazudo/zfb-md-wasm": "^2.18.0",
-    "@takazudo/zfb-runtime": "^2.18.0",
+    "@takazudo/zfb": "^2.19.0",
+    "@takazudo/zfb-md-wasm": "^2.19.0",
+    "@takazudo/zfb-runtime": "^2.19.0",
     "@takazudo/zudo-doc-history-server": "^5.17.2",
     "diff": "^8.0.0",
     "katex": "^0.16.0",
@@ -757,9 +757,9 @@
   },
   "devDependencies": {
     "@takazudo/mdx-formatter": "1.3.0-next.4",
-    "@takazudo/zfb": "2.18.0",
-    "@takazudo/zfb-md-wasm": "2.18.0",
-    "@takazudo/zfb-runtime": "2.18.0",
+    "@takazudo/zfb": "2.19.0",
+    "@takazudo/zfb-md-wasm": "2.19.0",
+    "@takazudo/zfb-runtime": "2.19.0",
     "@types/fs-extra": "^11.0.4",
     "@types/minimist": "^1.2.5",
     "@types/node": "^25.3.5",
@@ -771,7 +771,7 @@
     "typescript": "^5.0.0",
     "vitest": "^4.1.0",
     "zod": "^4.3.6",
-    "@takazudo/zudo-doc-history-server": "5.25.0"
+    "@takazudo/zudo-doc-history-server": "5.26.0"
   },
   "scripts": {
     "gen:search-widget-script": "node scripts/gen-search-widget-script.mjs",