@takazudo/zudo-doc 5.18.1 → 5.19.0

package/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to `@takazudo/zudo-doc` are documented in this file.
 
 The format is based on Keep a Changelog, and release notes are generated from the changelog MDX pages.
 
+## [5.19.0] - 2026-09-07
+
+### Bug Fixes
+
+- The `gen-z-index` and `gen-component-tokens` bins report a descriptive error instead of a raw Node stack trace. A missing input file now names the path and says which file it is, while `EACCES` / `EISDIR` keep their own message rather than collapsing into a misleading "not found", and a top-level handler prints the message to stderr and exits 1 for any deliberate throw. A non-`Error` throw prints its string form rather than a bare `undefined`. (83a4c6f7a, 134248eba)
+
+## [5.18.2] - 2026-09-06
+
+### Bug Fixes
+
+- A site with `designTokenPanel: false` (including the default) now builds without the optional `@takazudo/zdtp` peer installed. `chrome/derive` statically imported the Design Token Panel bootstrap, which imported `@takazudo/zdtp/constants`, so esbuild resolved that edge while bundling — before any runtime check of the setting could make it unreachable. A consumer that honored the published `peerDependenciesMeta` `optional: true` and omitted zdtp failed with `Could not resolve "@takazudo/zdtp/constants"`, and neither marking the package external nor an `addAlias` registration could route around it. The values the bootstrap needed are now vendored in-package, with a conformance test asserting them against the real `@takazudo/zdtp/constants` so the copies cannot drift, and a build-level test that installs a consumer without zdtp and proves the panel-disabled graph no longer reaches it. The affected published range is **5.18.0–5.18.1**; 5.17.2 was the last good release. (29b52ac5b, f6e293352)
+- `gen-z-index` accepts single-quoted `name`, `kind`, and `purpose` values. It previously matched only double-quoted ones, so a single-quoted entry was skipped without comment and silently left out of the generated scale. (64f5a8be4)
+- `gen-z-index` now fails loudly on a `purpose` or `kind` value it cannot read, instead of continuing and emitting a scale that quietly omits the unreadable entry. (0175bb5f6)
+
 ## [5.18.1] - 2026-09-06
 
 ### Bug Fixes

package/bin/gen-component-tokens.mjs

@@ -45,6 +45,11 @@ const TOKENS_PATH = resolve(PKG_ROOT, "src/config/component-tokens.ts");
 const CONTENT_CSS_PATH = resolve(PKG_ROOT, "src/content.css");
 const FEATURES_CSS_PATH = resolve(PKG_ROOT, "src/features.css");
 
+// Repo-relative label for TOKENS_PATH, matching the SURFACES table's relPath
+// convention below — used only in the missing-file message so it never
+// embeds this machine's absolute path.
+const TOKENS_REL_PATH = "packages/zudo-doc/src/config/component-tokens.ts";
+
 // Default marker pair = the content-surface block. Kept under the original
 // names so buildBlock/replaceBlock default to the content block, preserving the
 // byte-identical content.css output (and the existing unit-test call sites).
@@ -259,10 +264,30 @@ export function replaceBlock(
   return css.slice(0, lineStart) + block + css.slice(lineEnd);
 }
 
+/**
+ * Reads a package-owned file, translating a missing file into a message that
+ * names both which file (`label`) and its repo-relative path (`relPath`) —
+ * these paths are absolute constants (see TOKENS_PATH/SURFACES above), so the
+ * relative label is what keeps the message free of a machine-specific path.
+ * Only ENOENT is translated: EACCES/EISDIR etc. are real, distinct failures
+ * (a permissions problem or "that's a directory") that a "not found" message
+ * would misreport, so they propagate unchanged with Node's own message.
+ */
+function readNamedFile(absPath, relPath, label) {
+  try {
+    return readFileSync(absPath, "utf8");
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      throw new Error(`${label} file not found at ${relPath}`);
+    }
+    throw error;
+  }
+}
+
 function main() {
   const check = process.argv.includes("--check");
 
-  const tokensSrc = readFileSync(TOKENS_PATH, "utf8");
+  const tokensSrc = readNamedFile(TOKENS_PATH, TOKENS_REL_PATH, "tokens");
   const tokens = parseTokens(tokensSrc);
   const routes = routeBySurface(tokens);
 
@@ -277,7 +302,7 @@ function main() {
       `${target.surface}: ${surfaceTokens.length} token(s), ${selectorCount} selector(s)`,
     );
 
-    const css = readFileSync(target.cssPath, "utf8");
+    const css = readNamedFile(target.cssPath, target.relPath, "css");
     const block = buildBlock(surfaceTokens, target.beginMarker, target.endMarker);
     const next = replaceBlock(
       css,
@@ -344,5 +369,21 @@ function isDirectInvocation() {
 }
 
 if (isDirectInvocation()) {
-  process.exit(main());
+  // Turns any Error thrown by main() (the readNamedFile guard, the parser's
+  // loud-failure throws, or replaceBlock's missing-markers throw) into a
+  // single readable stderr line instead of a raw Node stack trace. This also
+  // hides the stack for a genuine *programming* error, not just a user-input
+  // one — an accepted CLI tradeoff, not an accident: the process still exits
+  // 1 and nothing is swallowed, but a future reader debugging an internal
+  // crash needs to call the exported `main()` directly (or temporarily
+  // remove this try/catch) to see the stack. Exit codes are unchanged:
+  // main()'s own return value (0 or 1) still flows through process.exit on
+  // the success path; only an uncaught throw is newly turned into exit(1)
+  // with a message.
+  try {
+    process.exit(main());
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  }
 }

package/bin/gen-z-index.mjs

@@ -213,62 +213,333 @@ export function validateTiers(tiers, tokensPath = DEFAULT_TOKENS_PATH) {
   return tiers;
 }
 
+const WHITESPACE_RE = /\s/;
+const IDENT_START_RE = /[A-Za-z_$]/;
+const IDENT_PART_RE = /[A-Za-z0-9_$]/;
+
+/**
+ * Skips whitespace AND comments (line comments to end of line, block comments
+ * to their terminator) starting at `i`, returning the offset of the next code
+ * character. Shared by the tier scanner and the key/value walk. Comments are
+ * trivia here for a load-bearing reason: a commented-out `purpose: "..."`
+ * line must NOT count as a real property key, which is exactly why the scan
+ * below works at code level instead of regex-matching the raw object body
+ * (#4016).
+ */
+function skipTrivia(src, i) {
+  for (;;) {
+    while (i < src.length && WHITESPACE_RE.test(src[i])) i++;
+    if (src[i] === "/" && src[i + 1] === "/") {
+      const newline = src.indexOf("\n", i);
+      i = newline === -1 ? src.length : newline + 1;
+      continue;
+    }
+    if (src[i] === "/" && src[i + 1] === "*") {
+      const close = src.indexOf("*/", i + 2);
+      i = close === -1 ? src.length : close + 2;
+      continue;
+    }
+    return i;
+  }
+}
+
+/**
+ * Returns the offset one past the `'`/`"` string literal opening at `i`
+ * (consuming backslash escapes), or `src.length` when it is unterminated.
+ * Escapes are consumed HERE even though an escaped quote is later rejected as
+ * an unsupported purpose grammar: the scanner has to agree with JavaScript
+ * about where the string ends, or a `name: "a\"b"` would desync every object
+ * boundary after it before the rejection ever ran.
+ */
+function skipQuoted(src, i) {
+  const quote = src[i];
+  for (let j = i + 1; j < src.length; j++) {
+    if (src[j] === "\\") {
+      j++;
+      continue;
+    }
+    if (src[j] === quote) return j + 1;
+  }
+  return src.length;
+}
+
 /**
- * Scans the raw Z_INDEX_TIERS array body for `purpose:` fields and rejects
- * any whose quoted value contains a brace or a backslash (which also covers
- * escaped quotes) BEFORE the per-object splitter runs. The per-object
- * splitter below uses a non-greedy `{...}` match to isolate each tier object,
- * which only works when no field value contains a brace — a purpose string
- * with a stray `}` would silently truncate the object split and corrupt
- * parsing instead of failing loudly. Only a flat, plain double-quoted string
- * is supported; a newline between `purpose:` and the opening quote is fine
- * (the field-key regexes below all use `\s*`, which matches newlines).
+ * Returns the offset one past the template literal opening at `i`, walking
+ * `${...}` interpolations (which may nest braces, strings, and further
+ * templates). A template literal is never a SUPPORTED tier value — this
+ * exists only so a file containing one still yields correct object spans, and
+ * therefore reaches the loud per-tier rejection in `parseTiers` naming the
+ * offending tier, instead of desyncing the scan into a confusing error.
  */
-function assertSupportedPurposeGrammar(body, tokensPath) {
-  const purposeKeyRe = /purpose:\s*/g;
-  let m;
-  while ((m = purposeKeyRe.exec(body)) !== null) {
-    const afterKey = m.index + m[0].length;
-    if (body[afterKey] !== '"') {
-      // Not immediately followed by a quote — not a value this scan can
-      // confirm is a real field; let the per-object parser's generic
-      // "malformed tier object" error handle it if it really is one.
+function skipTemplate(src, i) {
+  let j = i + 1;
+  while (j < src.length) {
+    const ch = src[j];
+    if (ch === "\\") {
+      j += 2;
+      continue;
+    }
+    if (ch === "`") return j + 1;
+    if (ch === "$" && src[j + 1] === "{") {
+      let depth = 1;
+      j += 2;
+      while (j < src.length && depth > 0) {
+        const inner = src[j];
+        if (inner === '"' || inner === "'") {
+          j = skipQuoted(src, j);
+          continue;
+        }
+        if (inner === "`") {
+          j = skipTemplate(src, j);
+          continue;
+        }
+        if (inner === "{") depth++;
+        else if (inner === "}") depth--;
+        j++;
+      }
       continue;
     }
-    let i = afterKey + 1;
+    j++;
+  }
+  return src.length;
+}
+
+/**
+ * Lexes the raw Z_INDEX_TIERS array body at CODE level and returns
+ * `{ objects, keys }`:
+ *
+ *   - `objects` — one entry per top-level `{ ... }` tier literal, with its
+ *     `start`/`end` brace offsets and the property-key sites found inside it.
+ *   - `keys` — every property-key site in source order, flat. Sites belonging
+ *     to an object that never closed appear here but in no `objects` entry;
+ *     that is deliberate, so an unterminated purpose string is still reported
+ *     as such rather than as an empty tier list.
+ *
+ * A "site" is `{ key, valueStart }`, where `valueStart` is the first code
+ * character after the `:` — the offset every value read anchors at.
+ *
+ * Working at code level (strings, template literals, and comments skipped
+ * wholesale) is what makes the loud-failure invariant safe to add: a
+ * `purpose:` inside another field's string value, or on a commented-out line,
+ * is not a property key and produces neither a tier field nor an error. A
+ * substring or `/purpose\s*:/` test over the object body cannot tell those
+ * apart and would turn a silent drop into a spurious hard failure (#4016).
+ *
+ * Only depth-1 keys are collected: a tier literal is flat, and anything
+ * nested is not a tier field.
+ */
+function scanTierObjects(body) {
+  const objects = [];
+  const keys = [];
+  let current = null;
+  let depth = 0;
+  let i = 0;
+  while (i < body.length) {
+    const ch = body[i];
+    if (ch === "/" && (body[i + 1] === "/" || body[i + 1] === "*")) {
+      i = skipTrivia(body, i);
+      continue;
+    }
+    if (ch === '"' || ch === "'") {
+      i = skipQuoted(body, i);
+      continue;
+    }
+    if (ch === "`") {
+      i = skipTemplate(body, i);
+      continue;
+    }
+    if (ch === "{") {
+      depth++;
+      if (depth === 1) current = { start: i, end: -1, keys: [] };
+      i++;
+      continue;
+    }
+    if (ch === "}") {
+      if (depth === 1 && current !== null) {
+        current.end = i;
+        objects.push(current);
+        current = null;
+      }
+      if (depth > 0) depth--;
+      i++;
+      continue;
+    }
+    if (depth === 1 && IDENT_START_RE.test(ch)) {
+      let end = i + 1;
+      while (end < body.length && IDENT_PART_RE.test(body[end])) end++;
+      const afterIdent = skipTrivia(body, end);
+      if (body[afterIdent] === ":") {
+        const site = {
+          key: body.slice(i, end),
+          valueStart: skipTrivia(body, afterIdent + 1),
+        };
+        current.keys.push(site);
+        keys.push(site);
+      }
+      i = end;
+      continue;
+    }
+    i++;
+  }
+  return { objects, keys };
+}
+
+/**
+ * The LAST site for `key` in a tier object, or null. Last rather than first
+ * because a duplicated property key resolves to its final assignment in
+ * JavaScript, and the parser's job is to report what the file actually means.
+ */
+function lastKeySite(object, key) {
+  let found = null;
+  for (const site of object.keys) {
+    if (site.key === key) found = site;
+  }
+  return found;
+}
+
+/**
+ * Reads a flat, plain single- or double-quoted string starting at
+ * `valueStart`, returning its raw inner text — or `null` when the value is
+ * not a supported quoted literal at all (a template literal, a bare
+ * identifier, a concatenation, a ternary: anything this dependency-free
+ * parser cannot evaluate). Callers turn that `null` into a loud, tier-naming
+ * error rather than a missing field.
+ *
+ * The delimiter is pinned from the opening character BEFORE the value is
+ * scanned, and the scan closes on that same character, so the other quote is
+ * ordinary text inside the value: `purpose: "doesn't break"` (exactly what
+ * Prettier emits for a value containing an apostrophe) and
+ * `purpose: 'a "quoted" phrase'` both read whole. A single
+ * `(["'])([^"']*)\1` alternation would truncate both (#4005 / #4014).
+ */
+function readQuotedValue(body, valueStart) {
+  const quote = body[valueStart];
+  if (quote !== '"' && quote !== "'") return null;
+  const close = body.indexOf(quote, valueStart + 1);
+  if (close === -1) return null;
+  // The literal must BE the whole value. Anything other than the property
+  // separator after it — `"a" + b`, `cond ? "a" : "b"`, `"a" as const` —
+  // is an expression whose first operand would otherwise be read as the
+  // field, which is the same silent-data-loss shape as dropping it (#4016).
+  const afterLiteral = skipTrivia(body, close + 1);
+  if (
+    afterLiteral < body.length &&
+    body[afterLiteral] !== "," &&
+    body[afterLiteral] !== "}"
+  ) {
+    return null;
+  }
+  return body.slice(valueStart + 1, close);
+}
+
+/**
+ * Rejects any REAL `purpose:` property whose quoted value contains a brace or
+ * a backslash (which also covers escaped quotes). Backslashes are rejected
+ * because this parser never unescapes — a `\n` in the source would reach the
+ * generated table as those two literal characters. Braces were originally
+ * rejected because the old non-greedy `{...}` object splitter truncated on
+ * them; `scanTierObjects` has no such weakness, but the restriction is kept
+ * deliberately as a stable contract, so a tokens file that parsed before
+ * still parses and one that failed still fails. Only a flat, plain string is
+ * supported, single- or double-quoted; a newline between `purpose:` and the
+ * opening quote is fine (`skipTrivia` walks it).
+ *
+ * A value that does not open with a quote at ALL is deliberately not this
+ * function's business: that is the unparseable case, reported per tier — with
+ * the tier's name — by `parseTiers` below, which cannot be done from here
+ * because this pre-pass runs before any tier is identified.
+ */
+function assertSupportedPurposeGrammar(body, purposeSites, tokensPath) {
+  for (const site of purposeSites) {
+    const openingQuote = body[site.valueStart];
+    if (openingQuote !== '"' && openingQuote !== "'") continue;
     let closed = false;
-    for (; i < body.length; i++) {
+    for (let i = site.valueStart + 1; i < body.length; i++) {
       const ch = body[i];
       if (ch === "{" || ch === "}" || ch === "\\") {
         throw new Error(
           `Unsupported purpose string grammar in ${tokensPath}: purpose values may not ` +
-            `contain braces, backslashes, or escaped quotes — only flat, plain double-quoted ` +
-            `strings are supported (the object parser cannot safely handle anything else). ` +
-            `Offending text near: ${JSON.stringify(body.slice(afterKey, Math.min(afterKey + 40, body.length)))}`,
+            `contain braces, backslashes, or escaped quotes — only flat, plain single- or ` +
+            `double-quoted strings are supported (the object parser cannot safely handle ` +
+            `anything else). ` +
+            `Offending text near: ${JSON.stringify(body.slice(site.valueStart, Math.min(site.valueStart + 40, body.length)))}`,
         );
       }
-      if (ch === '"') {
+      if (ch === openingQuote) {
         closed = true;
         break;
       }
     }
     if (!closed) {
       throw new Error(
-        `Unterminated purpose string in ${tokensPath} (no closing double quote found).`,
+        `Unterminated purpose string in ${tokensPath} ` +
+          `(no closing ${openingQuote === '"' ? "double" : "single"} quote found).`,
       );
     }
-    purposeKeyRe.lastIndex = i + 1;
   }
 }
 
+/**
+ * The loud-failure error for a tier field whose key IS present but whose
+ * value this parser cannot read (#4016). Names the tier, because "which tier"
+ * is the only question the reader has.
+ */
+function unreadableFieldError(field, tierName, body, site, tokensPath) {
+  return new Error(
+    `Unreadable ${field} value for tier "${tierName}" in ${tokensPath}: a ${field} must be a ` +
+      `flat, plain single- or double-quoted string literal. A template literal, a bare ` +
+      `identifier, a concatenation, or any other expression cannot be read by this ` +
+      `dependency-free parser and must not be silently dropped. ` +
+      `Offending text near: ${JSON.stringify(body.slice(site.valueStart, Math.min(site.valueStart + 40, body.length)))}`,
+  );
+}
+
 /**
  * Parse the Z_INDEX_TIERS array out of z-index-tokens.ts WITHOUT importing it
  * (this bin is a dependency-free .mjs and cannot resolve TypeScript). Reads
  * each `{ name: "...", value: <n>, kind?: "global"|"local", purpose?: "..." }`
- * object literal. Throws on a malformed source, an unsupported purpose-string
- * grammar, or an unknown `kind` value so drift between the parser and the
- * file surfaces loudly. Delegates the structural invariants (non-empty,
- * name shape, duplicate names, per-kind value uniqueness) to `validateTiers`.
+ * object literal. `name`, `kind`, and `purpose` accept EITHER quote character
+ * — a project whose Prettier config sets `singleQuote: true` needs no
+ * per-file override — and the two styles may be mixed freely within a file or
+ * within one tier object, since each field's delimiter is resolved
+ * independently from its own opening character (see `readQuotedValue`).
+ * `value` is unquoted either way. Throws on a malformed source, an
+ * unsupported purpose-string grammar, or an unknown `kind` value so drift
+ * between the parser and the file surfaces loudly. Delegates the structural
+ * invariants (non-empty, name shape, duplicate names, per-kind value
+ * uniqueness) to `validateTiers`.
+ *
+ * ## What the loud-failure invariant covers, and what it does not (#4016)
+ *
+ * Field values are read anchored at the offsets a code-level scan
+ * (`scanTierObjects`) reports for the REAL property keys — never by regex
+ * search over the raw object text. Consequences, all deliberate:
+ *
+ *   - COVERED: a `name`/`kind`/`purpose` key that is present but whose value
+ *     is not exactly one plain quoted string — a template literal, a bare
+ *     identifier, a concatenation, a ternary — throws and names the tier,
+ *     instead of leaving the field undefined (or quietly keeping only the
+ *     leading operand) and rendering `-` with exit 0 (#4005).
+ *   - COVERED (no false positive): `purpose:` / `kind:` occurring inside
+ *     another field's string value, or on a commented-out line, is not a
+ *     property key. It yields neither a field nor an error.
+ *   - COVERED (no misparse): a value that itself spells another field name,
+ *     e.g. `purpose: 'see name: "y"'`, can no longer be mistaken for that
+ *     field, because extraction never searches the object text.
+ *   - NOT COVERED: values this parser could in principle read but the
+ *     grammar deliberately excludes — braces, backslashes, escaped quotes in
+ *     a purpose — still throw as an unsupported grammar, not as a tier field.
+ *   - NOT COVERED: `value:`. It is read as the integer literal at the start
+ *     of its value, so a constant reference reports the generic "malformed
+ *     tier object" error (without a tier name — a tier with no readable
+ *     name/value has none to report) while an arithmetic expression keeps its
+ *     leading integer. Left deliberately loose: the acceptance surface here
+ *     is the string fields, and a `value: 0 as const` hard-failing a
+ *     previously-valid file would cost more than it buys.
+ *   - NOT COVERED: any construct the scan's small lexer does not model —
+ *     quoted property keys (`"purpose": "..."`), computed keys, and spreads
+ *     are not recognized as keys at all and surface as a malformed object or
+ *     a missing field.
  *
  * `tokensPath` is used purely for error-message context — pass the same path
  * string (conventional default or an explicit --tokens value) that was used
@@ -288,29 +559,41 @@ export function parseTiers(src, tokensPath = DEFAULT_TOKENS_PATH) {
   }
   const body = arrayMatch[1];
 
-  assertSupportedPurposeGrammar(body, tokensPath);
+  const { objects, keys } = scanTierObjects(body);
+
+  // Runs across ALL purpose sites before any tier is built, so an
+  // unterminated purpose string — which swallows its object's closing brace
+  // and leaves that object out of `objects` entirely — is reported as the
+  // unterminated string it is.
+  assertSupportedPurposeGrammar(
+    body,
+    keys.filter((site) => site.key === "purpose"),
+    tokensPath,
+  );
 
   const tiers = [];
-  // Each tier is a `{ ... }` object literal; iterate top-level braces. Safe
-  // because assertSupportedPurposeGrammar above already ruled out braces
-  // inside any purpose string.
-  const objectRe = /\{([\s\S]*?)\}/g;
-  let m;
-  while ((m = objectRe.exec(body)) !== null) {
-    const obj = m[1];
-    const nameMatch = obj.match(/name:\s*"([^"]+)"/);
-    const valueMatch = obj.match(/value:\s*(-?\d+)/);
-    if (!nameMatch || !valueMatch) {
+  for (const object of objects) {
+    const nameSite = lastKeySite(object, "name");
+    const valueSite = lastKeySite(object, "value");
+    const name = nameSite === null ? null : readQuotedValue(body, nameSite.valueStart);
+    const valueDigits =
+      valueSite === null ? null : /^-?\d+/.exec(body.slice(valueSite.valueStart));
+    // `!name` rather than `=== null`: a tier name may not be empty either.
+    if (!name || valueDigits === null) {
       throw new Error(
-        `Malformed tier object in Z_INDEX_TIERS (missing name/value) in ${tokensPath}: ${obj.trim()}`,
+        `Malformed tier object in Z_INDEX_TIERS (missing name/value) in ${tokensPath}: ` +
+          `${body.slice(object.start + 1, object.end).trim()}`,
       );
     }
 
-    const tier = { name: nameMatch[1], value: Number(valueMatch[1]) };
+    const tier = { name, value: Number(valueDigits[0]) };
 
-    const kindMatch = obj.match(/kind:\s*"([^"]*)"/);
-    if (kindMatch) {
-      const kindValue = kindMatch[1];
+    const kindSite = lastKeySite(object, "kind");
+    if (kindSite !== null) {
+      const kindValue = readQuotedValue(body, kindSite.valueStart);
+      if (kindValue === null) {
+        throw unreadableFieldError("kind", tier.name, body, kindSite, tokensPath);
+      }
       if (kindValue !== "global" && kindValue !== "local") {
         throw new Error(
           `Invalid kind "${kindValue}" for tier "${tier.name}" in ${tokensPath} ` +
@@ -320,9 +603,13 @@ export function parseTiers(src, tokensPath = DEFAULT_TOKENS_PATH) {
       tier.kind = kindValue;
     }
 
-    const purposeMatch = obj.match(/purpose:\s*"([^"]*)"/);
-    if (purposeMatch) {
-      tier.purpose = purposeMatch[1];
+    const purposeSite = lastKeySite(object, "purpose");
+    if (purposeSite !== null) {
+      const purposeValue = readQuotedValue(body, purposeSite.valueStart);
+      if (purposeValue === null) {
+        throw unreadableFieldError("purpose", tier.name, body, purposeSite, tokensPath);
+      }
+      tier.purpose = purposeValue;
     }
 
     tiers.push(tier);
@@ -736,6 +1023,26 @@ export function buildMdTable(tiers, options = {}) {
   return lines.join("\n");
 }
 
+/**
+ * Reads a user-supplied file, translating a missing file into a message that
+ * names both which file (`label`) and where it looked (`asGivenPath` — the
+ * as-given path, never the resolved absolute one, matching the convention
+ * documented on `main()` below). Only ENOENT is translated: EACCES/EISDIR
+ * etc. are real, distinct failures (a permissions problem or "that's a
+ * directory") that a "not found" message would misreport, so they propagate
+ * unchanged with Node's own message.
+ */
+function readNamedFile(absPath, asGivenPath, label) {
+  try {
+    return readFileSync(absPath, "utf8");
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      throw new Error(`${label} file not found at ${asGivenPath}`);
+    }
+    throw error;
+  }
+}
+
 /**
  * CLI entrypoint. `argv` defaults to the real process argv (minus the node/
  * script prefix) so `isDirectInvocation()` below can call `main()` with no
@@ -765,8 +1072,8 @@ export function main(argv = process.argv.slice(2)) {
   const tokensAbsPath = resolve(root, tokensPath);
   const cssAbsPath = resolve(root, cssPath);
 
-  const tokensSrc = readFileSync(tokensAbsPath, "utf8");
-  const css = readFileSync(cssAbsPath, "utf8");
+  const tokensSrc = readNamedFile(tokensAbsPath, tokensPath, "tokens");
+  const css = readNamedFile(cssAbsPath, cssPath, "css");
 
   const tiers = parseTiers(tokensSrc, tokensPath);
   const block = buildBlock(tiers, { tokensPath, cssPath, themeWrapper });
@@ -777,7 +1084,7 @@ export function main(argv = process.argv.slice(2)) {
   let nextMd;
   if (mdTablePath !== undefined) {
     mdAbsPath = resolve(root, mdTablePath);
-    mdSrc = readFileSync(mdAbsPath, "utf8");
+    mdSrc = readNamedFile(mdAbsPath, mdTablePath, "md-table");
     const mdBlock = buildMdTable(tiers, { tokensPath });
     nextMd = replaceBlock(
       mdSrc,
@@ -854,5 +1161,20 @@ function isDirectInvocation() {
 }
 
 if (isDirectInvocation()) {
-  process.exit(main());
+  // Turns any Error thrown by main() (there are ~17 deliberate `throw new
+  // Error(...)` call sites above, plus the readNamedFile guard) into a single
+  // readable stderr line instead of a raw Node stack trace. This also hides
+  // the stack for a genuine *programming* error, not just a user-input one —
+  // an accepted CLI tradeoff, not an accident: the process still exits 1 and
+  // nothing is swallowed, but a future reader debugging an internal crash
+  // needs to call the exported `main()` directly (or temporarily remove this
+  // try/catch) to see the stack. Exit codes are unchanged: main()'s own
+  // return value (0 or 1) still flows through process.exit on the success
+  // path; only an uncaught throw is newly turned into exit(1) with a message.
+  try {
+    process.exit(main());
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  }
 }

package/dist/design-token-panel-bootstrap.d.ts

@@ -3,8 +3,12 @@
 /**
  * Design-token panel (zdtp) WIRING MECHANISM + PACKAGE-DEFAULT ISLAND (#2658,
  * epic Minimal Scaffold #2651). zdtp itself is LAZY-LOADED (#3282, epic
- * #3261): this module carries NO top-level value import of `@takazudo/zdtp` —
- * its side-effect-free `/constants` leaf is the only eager zdtp value import.
+ * #3261): this module carries NO top-level value import of `@takazudo/zdtp`
+ * whatsoever. It used to eagerly import the side-effect-free `/constants` leaf;
+ * since #4018 those constants come from the in-package mirror
+ * `./design-token-panel-constants.js`, because that one static edge made an
+ * OPTIONAL peer a hard build-time requirement for every chrome consumer
+ * (#4009 — see that module's header).
  * The root package is `import()`ed on the first dispatch on either resolved
  * toggle channel (the shared `toggle-design-token-panel`, or this instance's own —
  * see the public 0.5 {@link resolveToggleEventName}), or eagerly when the

package/dist/design-token-panel-bootstrap.js

@@ -5,7 +5,7 @@ import {
   EAGER_LOAD_GATE_KEY_SUFFIXES,
   EAGER_LOAD_GATE_STATE_FAMILY,
   resolveToggleEventName
-} from "@takazudo/zdtp/constants";
+} from "./design-token-panel-constants.js";
 import {
   BEFORE_NAVIGATE_EVENT,
   AFTER_NAVIGATE_EVENT

package/dist/design-token-panel-constants.d.ts

@@ -0,0 +1,75 @@
+/** Default storage-key prefix used by the single-panel configuration. */
+export declare const DEFAULT_STORAGE_PREFIX = "zudo-design-token-panel";
+/** Historical public window-event name for the default panel instance. */
+export declare const DEFAULT_TOGGLE_EVENT = "toggle-design-token-panel";
+/**
+ * Resolve the window-event name that toggles a panel instance.
+ *
+ * The default prefix keeps the historical event name, even when a host
+ * supplies a `toggleEvent`. Other prefixes honor an explicit event name and
+ * otherwise derive one from the prefix.
+ */
+export declare function resolveToggleEventName(cfg: {
+    storagePrefix?: string;
+    toggleEvent?: string;
+}): string;
+/**
+ * The five fixed eager-load signals, keyed by suffix relative to storagePrefix.
+ * Only acceptedValues activate a flag; presence alone is insufficient.
+ * requiredConfig means that property must be !== undefined in the panel config.
+ * This excludes preference keys and is NOT the whole gate: also inspect
+ * EAGER_LOAD_GATE_STATE_FAMILY, whose keys require a content check.
+ *
+ * `as const` is load-bearing, not cosmetic: `hasPersistedPanelState` indexes
+ * `config[gate.requiredConfig]`, which only typechecks while `requiredConfig`
+ * narrows to `null | "domTweaker"` instead of widening to `string | null`.
+ */
+export declare const EAGER_LOAD_GATE_KEY_SUFFIXES: {
+    readonly ":visible": {
+        readonly acceptedValues: readonly ["1"];
+        readonly requiredConfig: null;
+    };
+    readonly "-open": {
+        readonly acceptedValues: readonly ["1"];
+        readonly requiredConfig: null;
+    };
+    readonly ":autoload": {
+        readonly acceptedValues: readonly ["1", "auto"];
+        readonly requiredConfig: null;
+    };
+    readonly "-elpath-enabled": {
+        readonly acceptedValues: readonly ["1"];
+        readonly requiredConfig: null;
+    };
+    readonly "-domtweaker-enabled": {
+        readonly acceptedValues: readonly ["1"];
+        readonly requiredConfig: "domTweaker";
+    };
+};
+/**
+ * The sixth eager-load signal: exact readable state keys, with a content
+ * check. Missing keys and raw empty strings are blank;
+ * JSON null and empty objects/arrays do not activate. Non-empty collections and
+ * all other parsed primitives (even false, 0, or JSON "") activate. Malformed
+ * JSON fails open so the panel can migrate or reject the stored payload.
+ *
+ * matchesKey compares complete strings constructed from the literal prefix, so
+ * regex metacharacters are safe and sibling-instance keys are excluded.
+ */
+export declare const EAGER_LOAD_GATE_STATE_FAMILY: {
+    readonly keySuffixes: {
+        readonly v1: "-state";
+        readonly v2: "-state-v2";
+        readonly v3: "-state-v3";
+        readonly v4: "-state-v4";
+    };
+    readonly matchesKey: (storagePrefix: string, key: string) => boolean;
+    readonly valueRules: {
+        readonly blank: false;
+        readonly jsonNull: false;
+        readonly object: "non-empty";
+        readonly array: "non-empty";
+        readonly primitive: true;
+        readonly malformedJson: true;
+    };
+};

package/dist/design-token-panel-constants.js

@@ -0,0 +1,41 @@
+const DEFAULT_STORAGE_PREFIX = "zudo-design-token-panel";
+const DEFAULT_TOGGLE_EVENT = "toggle-design-token-panel";
+function resolveToggleEventName(cfg) {
+  return cfg.storagePrefix === void 0 || cfg.storagePrefix === DEFAULT_STORAGE_PREFIX ? DEFAULT_TOGGLE_EVENT : cfg.toggleEvent ?? `toggle-${cfg.storagePrefix}`;
+}
+const EAGER_LOAD_GATE_KEY_SUFFIXES = {
+  ":visible": { acceptedValues: ["1"], requiredConfig: null },
+  "-open": { acceptedValues: ["1"], requiredConfig: null },
+  ":autoload": { acceptedValues: ["1", "auto"], requiredConfig: null },
+  "-elpath-enabled": { acceptedValues: ["1"], requiredConfig: null },
+  "-domtweaker-enabled": { acceptedValues: ["1"], requiredConfig: "domTweaker" }
+};
+const READABLE_STATE_KEY_SUFFIXES = {
+  v1: "-state",
+  v2: "-state-v2",
+  v3: "-state-v3",
+  v4: "-state-v4"
+};
+const EAGER_LOAD_GATE_STATE_FAMILY = {
+  keySuffixes: READABLE_STATE_KEY_SUFFIXES,
+  matchesKey(storagePrefix, key) {
+    return Object.values(READABLE_STATE_KEY_SUFFIXES).some(
+      (suffix) => key === storagePrefix + suffix
+    );
+  },
+  valueRules: {
+    blank: false,
+    jsonNull: false,
+    object: "non-empty",
+    array: "non-empty",
+    primitive: true,
+    malformedJson: true
+  }
+};
+export {
+  DEFAULT_STORAGE_PREFIX,
+  DEFAULT_TOGGLE_EVENT,
+  EAGER_LOAD_GATE_KEY_SUFFIXES,
+  EAGER_LOAD_GATE_STATE_FAMILY,
+  resolveToggleEventName
+};

package/dist/safelist.css

@@ -1,2 +1,2 @@
 /* generated by gen-safelist.mjs — do not edit by hand */
-@source inline("-left-[calc(var(--spacing-icon-lg)/2)] -link -mb-px -ml-hsp-sm -mt-px -noscript -open -translate-x-full 2xl:w-[24px] [&::-webkit-details-marker]:hidden [&_a]:pointer-events-auto [&_a]:text-accent [&_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] [llms-txt] [zudo-doc] a a2 abbr about above absent absolute accent accent- accent:accent- access across activated active actual actually 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-top all allow allow-same-origin allow-scripts allowed alone already already-executed already-multiline already-picked also 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 auf 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 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 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 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 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-kbd-shortcut data-lang data-language-menu data-language-switcher data-language-toggle data-loading-index 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 decoration-muted 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 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 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:decoration-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-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:decoration-accent group-focus-visible:text-accent group-focus-visible:text-accent-hover group-focus-visible:text-fg group-focus-visible:underline group-focus-within:block group-hover:bg-fg group-hover:block group-hover:decoration-accent group-hover:text-accent group-hover:text-accent-hover 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 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:decoration-accent 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 identical idle idx if iframe ignoring image image-enlarge image-overlay-inset image/avif image/gif image/jpeg image/png image/webp image/x-icon img implementation import 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 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-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 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 or order original other others otherwise out outgoing outline-none 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 paren-balance-aware parent parse 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 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 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 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 rs 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 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 stable stack stale standalone start state state- state:state- statement 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 styled 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-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 tracked tracking-wide tracking-wider trade-off trailing 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 underlines understand unit-tested unknown unlike unlisted unmaintained unmatchable unobserve unreadable unrelated unreleased unresolvable unresolved unset unsupported unterminated until unusable unwrapped up up-to-date update updated uppercase use used useful user uses using usual utf-8 utf8 utilities utility v v2 val value value-reader values var variable variant 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 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-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-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 zfb zfb:after-swap zfb:before-preparation zfb:before-swap zip zod zoom 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]:pointer-events-auto [&_a]:text-accent [&_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] [llms-txt] [zudo-doc] a a2 abbr about above absent absolute accent accent- accent:accent- access across activated active actual actually 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-top all allow allow-same-origin allow-scripts allowed alone already already-executed already-multiline already-picked also 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 auf 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 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 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 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 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-kbd-shortcut data-lang data-language-menu data-language-switcher data-language-toggle data-loading-index 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 decoration-muted 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 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 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:decoration-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-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:decoration-accent group-focus-visible:text-accent group-focus-visible:text-accent-hover group-focus-visible:text-fg group-focus-visible:underline group-focus-within:block group-hover:bg-fg group-hover:block group-hover:decoration-accent group-hover:text-accent group-hover:text-accent-hover 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 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:decoration-accent 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 identical idle idx if iframe ignoring image image-enlarge image-overlay-inset image/avif image/gif image/jpeg image/png image/webp image/x-icon img implementation import 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 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-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 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 or order original other others otherwise out outgoing outline-none 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 paren-balance-aware parent parse 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 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 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 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 rs 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 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 stable stack stale standalone start state state- state:state- statement 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 styled 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 tracked tracking-wide tracking-wider trade-off trailing 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 underlines understand unit-tested unknown unlike unlisted unmaintained unmatchable unobserve unreadable unrelated unreleased unresolvable unresolved unset unsupported unterminated until unusable unwrapped up up-to-date update updated uppercase use used useful user uses using usual utf-8 utf8 utilities utility v v2 val value value-reader values var variable variant 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 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-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-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 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zudo-doc",
-  "version": "5.18.1",
+  "version": "5.19.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",
@@ -720,7 +720,7 @@
     "typescript": "^5.0.0",
     "vitest": "^4.1.0",
     "zod": "^4.3.6",
-    "@takazudo/zudo-doc-history-server": "5.18.1"
+    "@takazudo/zudo-doc-history-server": "5.19.0"
   },
   "scripts": {
     "gen:search-widget-script": "node scripts/gen-search-widget-script.mjs",