@takazudo/zudo-doc 5.27.0 → 5.28.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -8,6 +8,31 @@ The format is based on Keep a Changelog, and release notes are generated from th
8
8
 
9
9
  No unreleased changes.
10
10
 
11
+ ## [5.28.1] - 2026-09-27
12
+
13
+ ### Bug Fixes
14
+
15
+ - `Settings.searchMaxBodyLength` is optional again, so hosts using `satisfies Settings` can upgrade without adding the field. Omission still uses the 3000-character default. (e180761a0)
16
+
17
+ ### Other Changes
18
+
19
+ - Update the supported zfb family to 2.22.0, which adds workerd-compatible md-wasm parse and highlight entries while retaining browser exports. (8083a1329)
20
+
21
+ ## [5.28.0] - 2026-09-27
22
+
23
+ ### Features
24
+
25
+ - Search now indexes up to 3000 characters per page instead of 300, making longer pages searchable beyond their opening paragraphs. Set `searchMaxBodyLength` to a positive integer to adjust the limit; result snippets retain their existing display length. (332a6184b)
26
+
27
+ ### Bug Fixes
28
+
29
+ - Heading extraction for the table of contents and link checks ignores heading-like text inside multiline JSX expressions, comments, quoted attributes, and template-literal props, while preserving headings in JSX children. Multiline inline-code spans no longer confuse JSX detection. (b85fe3469, 99ad4252b)
30
+ - Escape closes the mobile drawer's Appearance menu and returns focus to its trigger; a second Escape closes the drawer and focuses the hamburger button. (66359d27c)
31
+
32
+ ### Other Changes
33
+
34
+ - Raise the zfb, zfb-runtime, and zfb-md-wasm peer floors to `^2.21.1`, bringing single-Preact-runtime SSR fixes, collection include-filter handling, faster startup, and workspace-package staging and reload fixes. No configuration migration is required. (6686f2da6, e82e57551)
35
+
11
36
  ## [5.27.0] - 2026-09-24
12
37
 
13
38
  ### Features
@@ -28,7 +53,7 @@ No unreleased changes.
28
53
 
29
54
  ### Bug Fixes
30
55
 
31
- - Fixed package-owned route injection in nested pnpm workspace consumers. Published route sources are staged under the project root so the build shadow can resolve the generated 404, robots, and docs routes (848264b9c).
56
+ - Fixed package-owned route injection in nested pnpm workspace consumers. Published route sources are staged under the project root so the build shadow can resolve the generated 404, robots, and docs routes (848264b9c). Projects scaffolded on 5.26.4 or earlier should add `.zudo-doc/` to their `.gitignore`: the build now writes the staged route sources to `.zudo-doc/routes-src/`, and without the ignore entry `git status` will show it as an untracked directory. New scaffolds already ignore it; see the `create-zudo-doc` changelog.
32
57
 
33
58
  ## [5.26.4] - 2026-09-22
34
59
 
@@ -68,6 +68,19 @@ export declare function resolvesBundleZdtp(settings: ZdtpBundlingSubject): boole
68
68
  * in the browser. Fail loudly at config resolution instead (#4261).
69
69
  */
70
70
  export declare function assertZdtpBundlingConsistent(settings: ZdtpBundlingSubject): void;
71
+ /**
72
+ * Reject a `searchMaxBodyLength` that is not a positive integer.
73
+ *
74
+ * `undefined` no-ops (the field is optional at this layer — the search-index
75
+ * collector applies its own `MAX_BODY_LENGTH` default). Shared between
76
+ * `zudoDoc()` (`../config.ts`) and `zudoDocPreset()` (same rationale as the
77
+ * other guards above) AND the search-index collector itself
78
+ * (`../plugins/internal/search-index/collect.ts`), which is also reachable
79
+ * directly (tests, or a consumer calling `collectSearchEntries()` outside
80
+ * `zudoDoc()`) — clamping silently there would hide a config typo behind a
81
+ * quietly-wrong index instead of failing loudly (zudolab/zudo-doc#4407).
82
+ */
83
+ export declare function assertValidSearchMaxBodyLength(searchMaxBodyLength: number | undefined): void;
71
84
  /**
72
85
  * Warn about `categoryMatch` values that cannot express the intended
73
86
  * dropdown grouping.
@@ -29,6 +29,14 @@ function assertZdtpBundlingConsistent(settings) {
29
29
  );
30
30
  }
31
31
  }
32
+ function assertValidSearchMaxBodyLength(searchMaxBodyLength) {
33
+ if (searchMaxBodyLength === void 0) return;
34
+ if (!Number.isInteger(searchMaxBodyLength) || searchMaxBodyLength <= 0) {
35
+ throw new TypeError(
36
+ `Invalid searchMaxBodyLength ${JSON.stringify(searchMaxBodyLength)}: must be a positive integer (e.g. 3000).`
37
+ );
38
+ }
39
+ }
32
40
  function warnAmbiguousDropdownCategoryMatch(headerNav, logger = console) {
33
41
  if (!headerNav) return;
34
42
  for (const item of headerNav) {
@@ -70,6 +78,7 @@ function warnAmbiguousDropdownCategoryMatch(headerNav, logger = console) {
70
78
  }
71
79
  export {
72
80
  assertNoEmptyStringFaviconOrLogo,
81
+ assertValidSearchMaxBodyLength,
73
82
  assertZdtpBundlingConsistent,
74
83
  resolvesBundleZdtp,
75
84
  warnAmbiguousDropdownCategoryMatch
package/dist/config.d.ts CHANGED
@@ -368,6 +368,20 @@ export interface ZudoDocConfig {
368
368
  * @default 4
369
369
  */
370
370
  tocMaxDepth?: number;
371
+ /**
372
+ * How many characters of each page's plain-text body are indexed for
373
+ * search *matching* (`search-index.json`'s per-entry `body` field). This is
374
+ * a match-depth cap, not a display cap — the search widget already renders
375
+ * only a short match-centred window (`truncate(text, query, 200)`), so
376
+ * raising this value makes long pages searchable past their opening
377
+ * paragraphs without changing what a result snippet shows. Also caps how
378
+ * many bytes are read from a public text asset for its search excerpt (the
379
+ * asset-viewer indexing path in `plugins/internal/search-index/collect.ts`).
380
+ * Must be a positive integer — a non-integer or ≤ 0 value throws at config
381
+ * resolution.
382
+ * @default 3000
383
+ */
384
+ searchMaxBodyLength?: number;
371
385
  /**
372
386
  * Enable the draggable sidebar resizer.
373
387
  * @default false
package/dist/config.js CHANGED
@@ -6,7 +6,8 @@ import { defaultColorSchemes } from "./color-schemes-defaults/index.js";
6
6
  import { assertNoCommaInVersionSlugs } from "./version-availability/index.js";
7
7
  import {
8
8
  assertNoEmptyStringFaviconOrLogo,
9
- assertZdtpBundlingConsistent
9
+ assertZdtpBundlingConsistent,
10
+ assertValidSearchMaxBodyLength
10
11
  } from "./config-assertions/index.js";
11
12
  import { validateAssetViewerSettings } from "./asset-path/index.js";
12
13
  function mergeDefaultTranslations(overrides) {
@@ -91,6 +92,7 @@ const DEFAULT_SETTINGS = {
91
92
  designTokenPanel: false,
92
93
  tocMinDepth: 2,
93
94
  tocMaxDepth: 4,
95
+ searchMaxBodyLength: 3e3,
94
96
  sidebarResizer: false,
95
97
  sidebarToggle: false,
96
98
  tocToggle: false,
@@ -152,6 +154,7 @@ function zudoDoc(user = {}) {
152
154
  assertNoCommaInVersionSlugs(settings.versions);
153
155
  assertNoEmptyStringFaviconOrLogo(settings);
154
156
  assertZdtpBundlingConsistent(settings);
157
+ assertValidSearchMaxBodyLength(settings.searchMaxBodyLength);
155
158
  const fragment = zudoDocPreset({
156
159
  settings,
157
160
  buildDocsSchema: userBuildDocsSchema ?? (() => defaultBuildDocsSchema({
@@ -107,21 +107,10 @@ function extractAllHeadingIds(body) {
107
107
  function collectHeadings(body, lo, hi) {
108
108
  const allocator = new SlugAllocator();
109
109
  const headings = [];
110
- let codeFenceOpener = null;
111
- for (const line of body.split("\n")) {
112
- const trimmed = line.trimStart();
113
- const fenceMatch = /^([`~]{3,})/.exec(trimmed);
114
- if (fenceMatch) {
115
- const fence = fenceMatch[1];
116
- if (fence === void 0) continue;
117
- if (codeFenceOpener === null) {
118
- codeFenceOpener = fence;
119
- } else if (fence[0] === codeFenceOpener[0] && fence.length >= codeFenceOpener.length) {
120
- codeFenceOpener = null;
121
- }
122
- continue;
123
- }
124
- if (codeFenceOpener !== null) continue;
110
+ const lines = body.split("\n");
111
+ const candidate = classifyLines(lines);
112
+ for (const [index, line] of lines.entries()) {
113
+ if (candidate[index] !== true) continue;
125
114
  const match = /^(#{2,6})[ \t]+(.+)$/.exec(line.trim());
126
115
  if (!match) continue;
127
116
  const hashes = match[1];
@@ -136,6 +125,127 @@ function collectHeadings(body, lo, hi) {
136
125
  }
137
126
  return headings;
138
127
  }
128
+ const JSX_TAG_CHAR = /[\p{ID_Continue}$\-.:=/>"'{\s]/u;
129
+ const JSX_TAG_START = /[\p{ID_Start}$_/>]/u;
130
+ const ASCII_PUNCTUATION = /[!-/:-@[-`{-~]/;
131
+ const ATX_HEADING = /^#{1,6}(?:[ \t]|$)/;
132
+ function findCodeSpanEnd(lines, from, runLength) {
133
+ for (let lineIndex = from; lineIndex < lines.length; lineIndex++) {
134
+ const line = lines[lineIndex] ?? "";
135
+ const trimmed = line.trimStart();
136
+ if (trimmed.trim() === "" || ATX_HEADING.test(trimmed) || /^(?:`{3,}|~{3,})/.test(trimmed)) {
137
+ return null;
138
+ }
139
+ for (const match of line.matchAll(/`+/g)) {
140
+ if (match[0].length === runLength) {
141
+ return { line: lineIndex, col: match.index + runLength };
142
+ }
143
+ }
144
+ }
145
+ return null;
146
+ }
147
+ function classifyLines(lines) {
148
+ const ignoredOpeners = /* @__PURE__ */ new Set();
149
+ for (; ; ) {
150
+ const result = scanLines(lines, ignoredOpeners);
151
+ if (result.unclosedOpener === null) return result.candidate;
152
+ ignoredOpeners.add(result.unclosedOpener);
153
+ }
154
+ }
155
+ function scanLines(lines, ignoredOpeners) {
156
+ const candidate = [];
157
+ let codeFenceOpener = null;
158
+ let exprDepth = 0;
159
+ let tag = null;
160
+ let opener = null;
161
+ let codeSpanEnd = null;
162
+ for (const [lineIndex, line] of lines.entries()) {
163
+ let start = 0;
164
+ if (codeSpanEnd !== null) {
165
+ candidate.push(false);
166
+ if (lineIndex < codeSpanEnd.line) continue;
167
+ start = codeSpanEnd.col;
168
+ codeSpanEnd = null;
169
+ }
170
+ const trimmed = line.trimStart();
171
+ if (start === 0 && tag !== null && tag.quote === null && exprDepth === 0) {
172
+ const first = trimmed[0];
173
+ if (first !== void 0 && !JSX_TAG_CHAR.test(first)) tag = null;
174
+ }
175
+ if (start > 0) {
176
+ } else if (exprDepth > 0 || tag !== null) {
177
+ candidate.push(false);
178
+ } else {
179
+ const fence = /^([`~]{3,})/.exec(trimmed)?.[1];
180
+ if (fence !== void 0) {
181
+ if (codeFenceOpener === null) {
182
+ codeFenceOpener = fence;
183
+ } else if (fence[0] === codeFenceOpener[0] && fence.length >= codeFenceOpener.length) {
184
+ codeFenceOpener = null;
185
+ }
186
+ candidate.push(false);
187
+ continue;
188
+ }
189
+ candidate.push(codeFenceOpener === null);
190
+ if (codeFenceOpener !== null) continue;
191
+ }
192
+ for (let i = start; i < line.length; i++) {
193
+ const ch = line[i] ?? "";
194
+ if (exprDepth > 0) {
195
+ if (ch === "{") exprDepth++;
196
+ else if (ch === "}") exprDepth--;
197
+ continue;
198
+ }
199
+ if (tag !== null) {
200
+ if (tag.quote !== null) {
201
+ if (ch === tag.quote) tag.quote = null;
202
+ } else if (ch === '"' || ch === "'") {
203
+ tag.quote = ch;
204
+ } else if (ch === "{") {
205
+ exprDepth = 1;
206
+ } else if (ch === ">") {
207
+ tag = null;
208
+ } else if (!JSX_TAG_CHAR.test(ch)) {
209
+ tag = null;
210
+ i--;
211
+ }
212
+ continue;
213
+ }
214
+ if (ch === "\\" && ASCII_PUNCTUATION.test(line[i + 1] ?? "")) {
215
+ i++;
216
+ continue;
217
+ }
218
+ if (ch === "`") {
219
+ const run = /^`+/.exec(line.slice(i))?.[0] ?? "`";
220
+ const closer = /`+/g;
221
+ closer.lastIndex = i + run.length;
222
+ let match;
223
+ while ((match = closer.exec(line)) !== null && match[0].length !== run.length) {
224
+ }
225
+ if (match === null && !ATX_HEADING.test(trimmed)) {
226
+ codeSpanEnd = findCodeSpanEnd(lines, lineIndex + 1, run.length);
227
+ if (codeSpanEnd !== null) break;
228
+ }
229
+ i = (match === null ? i : match.index) + run.length - 1;
230
+ continue;
231
+ }
232
+ const position = `${lineIndex}:${i}`;
233
+ if (ignoredOpeners.has(position)) continue;
234
+ if (ch === "{") {
235
+ exprDepth = 1;
236
+ opener = position;
237
+ } else if (ch === "<" && JSX_TAG_START.test(line[i + 1] ?? "")) {
238
+ tag = { quote: null };
239
+ opener = position;
240
+ }
241
+ }
242
+ if (exprDepth === 0 && tag === null) opener = null;
243
+ }
244
+ return {
245
+ candidate,
246
+ unclosedOpener: exprDepth > 0 || tag !== null ? opener : null
247
+ };
248
+ }
139
249
  export {
140
250
  extractAllHeadingIds,
141
251
  extractHeadings,
@@ -8,14 +8,15 @@ import {
8
8
  stripMarkdown
9
9
  } from "../../../md-utils/index.js";
10
10
  import { collectAssetPageDescriptors } from "../asset-viewer/asset-pages.js";
11
+ import { assertValidSearchMaxBodyLength } from "../../../config-assertions/index.js";
11
12
  import {
12
13
  MAX_BODY_LENGTH
13
14
  } from "./types.js";
14
- function truncateBody(text) {
15
- return text.length > MAX_BODY_LENGTH ? text.substring(0, MAX_BODY_LENGTH) : text;
15
+ function truncateBody(text, maxBodyLength) {
16
+ return text.length > maxBodyLength ? text.substring(0, maxBodyLength) : text;
16
17
  }
17
- function readAssetExcerpt(filePath) {
18
- const sample = Buffer.allocUnsafe(MAX_BODY_LENGTH * 4);
18
+ function readAssetExcerpt(filePath, maxBodyLength) {
19
+ const sample = Buffer.allocUnsafe(maxBodyLength * 4);
19
20
  const fd = openSync(filePath, "r");
20
21
  try {
21
22
  let offset = 0;
@@ -30,12 +31,12 @@ function readAssetExcerpt(filePath) {
30
31
  if (bytesRead === 0) break;
31
32
  offset += bytesRead;
32
33
  }
33
- return truncateBody(sample.subarray(0, offset).toString("utf8"));
34
+ return truncateBody(sample.subarray(0, offset).toString("utf8"), maxBodyLength);
34
35
  } finally {
35
36
  closeSync(fd);
36
37
  }
37
38
  }
38
- function buildEntries(contentDir, locale, base) {
39
+ function buildEntries(contentDir, locale, base, maxBodyLength) {
39
40
  const absDir = resolve(contentDir);
40
41
  const files = collectMdFiles(absDir);
41
42
  const entries = [];
@@ -49,14 +50,14 @@ function buildEntries(contentDir, locale, base) {
49
50
  entries.push({
50
51
  id,
51
52
  title: data.title ?? slug,
52
- body: truncateBody(stripMarkdown(content)),
53
+ body: truncateBody(stripMarkdown(content), maxBodyLength),
53
54
  url: slugToUrl(slug, locale, base),
54
55
  description: data.description ?? ""
55
56
  });
56
57
  }
57
58
  return entries;
58
59
  }
59
- function buildAssetEntries(config) {
60
+ function buildAssetEntries(config, maxBodyLength) {
60
61
  const { assetScan, projectRoot } = config;
61
62
  if (assetScan === void 0 || projectRoot === void 0) return [];
62
63
  const descriptors = collectAssetPageDescriptors({
@@ -67,7 +68,7 @@ function buildAssetEntries(config) {
67
68
  const assetRoot = resolve(projectRoot, "public", assetScan.assetViewerDir);
68
69
  return descriptors.map((descriptor) => {
69
70
  const localePrefix = descriptor.locale === void 0 ? "" : `${descriptor.locale}/`;
70
- const body = descriptor.isText ? readAssetExcerpt(resolve(assetRoot, descriptor.path)) : "";
71
+ const body = descriptor.isText ? readAssetExcerpt(resolve(assetRoot, descriptor.path), maxBodyLength) : "";
71
72
  return {
72
73
  id: `asset:${localePrefix}${assetScan.assetViewerRoutePrefix}/${descriptor.path}`,
73
74
  title: basename(descriptor.path),
@@ -78,15 +79,17 @@ function buildAssetEntries(config) {
78
79
  });
79
80
  }
80
81
  function collectSearchEntries(config) {
82
+ assertValidSearchMaxBodyLength(config.maxBodyLength);
83
+ const maxBodyLength = config.maxBodyLength ?? MAX_BODY_LENGTH;
81
84
  const base = config.base ?? "";
82
85
  const entries = [];
83
- entries.push(...buildEntries(config.docsDir, null, base));
86
+ entries.push(...buildEntries(config.docsDir, null, base, maxBodyLength));
84
87
  if (config.locales) {
85
88
  for (const [code, locale] of Object.entries(config.locales)) {
86
- entries.push(...buildEntries(locale.dir, code, base));
89
+ entries.push(...buildEntries(locale.dir, code, base, maxBodyLength));
87
90
  }
88
91
  }
89
- entries.push(...buildAssetEntries(config));
92
+ entries.push(...buildAssetEntries(config, maxBodyLength));
90
93
  return entries;
91
94
  }
92
95
  export {
@@ -10,7 +10,13 @@ export interface SearchIndexEntry {
10
10
  id: string;
11
11
  /** Frontmatter title, falling back to the slug when missing. */
12
12
  title: string;
13
- /** Plain-text body excerpt, capped at MAX_BODY_LENGTH characters. */
13
+ /**
14
+ * Plain-text body, capped at MAX_BODY_LENGTH characters (configurable via
15
+ * `searchMaxBodyLength`). This is a match-depth cap — how much of the page
16
+ * is available for the widget's `indexOf` search to match against — not a
17
+ * display cap; the widget already renders only a short match-centred
18
+ * excerpt of whichever field it shows.
19
+ */
14
20
  body: string;
15
21
  /** Site-relative URL (respecting `base`). */
16
22
  url: string;
@@ -34,8 +40,24 @@ export interface SearchIndexConfig {
34
40
  projectRoot?: string;
35
41
  /** Shared asset-viewer projection; consumed by the asset indexing wave. */
36
42
  assetScan?: AssetScanProjection;
43
+ /**
44
+ * Match-depth cap for indexed body text, in characters (`searchMaxBodyLength`
45
+ * in `ZudoDocConfig`). Applies to both doc bodies and text-asset excerpts.
46
+ * Falls back to {@link MAX_BODY_LENGTH} when omitted (e.g. a direct
47
+ * `collectSearchEntries()` call outside `zudoDoc()`). Must be a positive
48
+ * integer — validated by `assertValidSearchMaxBodyLength` in `collect.ts`.
49
+ */
50
+ maxBodyLength?: number;
37
51
  }
38
- /** Maximum body text stored per entry (display excerpt cap). */
39
- export declare const MAX_BODY_LENGTH = 300;
52
+ /**
53
+ * Default match-depth cap for indexed body text (characters) — how much of a
54
+ * page or text asset is available for the search widget's `indexOf` matching,
55
+ * NOT a display-excerpt cap (the widget already renders only a short
56
+ * match-centred window regardless of this value). Overridable per-site via
57
+ * `searchMaxBodyLength` (zudolab/zudo-doc#4407); the exported name stays
58
+ * `MAX_BODY_LENGTH` for backward compatibility even though it is now a
59
+ * default rather than a fixed constant.
60
+ */
61
+ export declare const MAX_BODY_LENGTH = 3000;
40
62
  /** Public route the dev middleware and build emitter agree on. */
41
63
  export declare const SEARCH_INDEX_ROUTE = "/search-index.json";
@@ -1,4 +1,4 @@
1
- const MAX_BODY_LENGTH = 300;
1
+ const MAX_BODY_LENGTH = 3e3;
2
2
  const SEARCH_INDEX_ROUTE = "/search-index.json";
3
3
  export {
4
4
  MAX_BODY_LENGTH,
package/dist/preset.d.ts CHANGED
@@ -202,6 +202,14 @@ export interface PresetSettings {
202
202
  themePacks?: string[];
203
203
  /** Header navigation, used for non-throwing dropdown category diagnostics. */
204
204
  headerNav?: PresetHeaderNavItem[];
205
+ /**
206
+ * Match-depth cap (characters) for the search index's per-page/asset body
207
+ * text. Threaded into the `@takazudo/zudo-doc/plugins/search-index`
208
+ * descriptor's `maxBodyLength` option and validated by
209
+ * `assertValidSearchMaxBodyLength` (`config-assertions/index.ts`). Full
210
+ * contract: `ZudoDocConfig.searchMaxBodyLength` in `config.ts`.
211
+ */
212
+ searchMaxBodyLength?: number;
205
213
  }
206
214
  /**
207
215
  * The directives recipe map (`markdown.features.directives`): directive name →
package/dist/preset.js CHANGED
@@ -3,6 +3,7 @@ import { assertNoCommaInVersionSlugs } from "./version-availability/index.js";
3
3
  import {
4
4
  assertNoEmptyStringFaviconOrLogo,
5
5
  assertZdtpBundlingConsistent,
6
+ assertValidSearchMaxBodyLength,
6
7
  resolvesBundleZdtp,
7
8
  warnAmbiguousDropdownCategoryMatch
8
9
  } from "./config-assertions/index.js";
@@ -17,6 +18,7 @@ function zudoDocPreset({
17
18
  assertNoCommaInVersionSlugs(settings.versions);
18
19
  assertNoEmptyStringFaviconOrLogo(settings);
19
20
  assertZdtpBundlingConsistent(settings);
21
+ assertValidSearchMaxBodyLength(settings.searchMaxBodyLength);
20
22
  warnAmbiguousDropdownCategoryMatch(settings.headerNav);
21
23
  const docsSchemaJson = z.toJSONSchema(buildDocsSchema());
22
24
  return {
@@ -255,7 +257,8 @@ function buildPlugins(settings, routeContext) {
255
257
  docsDir: settings.docsDir,
256
258
  locales: localeRecord,
257
259
  base: settings.base,
258
- assetScan
260
+ assetScan,
261
+ maxBodyLength: settings.searchMaxBodyLength
259
262
  }
260
263
  },
261
264
  // Theme packs (ADR docs/adr/theme-packs.md, Decision 2, #2820) — a
package/dist/safelist.css CHANGED
@@ -1,2 +1,2 @@
1
1
  /* generated by gen-safelist.mjs — do not edit by hand */
2
- @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-checked 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-accent/10 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-icon-group 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-menu 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 device 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-[40px] 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 menuitemradio 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 miter 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 p-hsp-xs 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 system 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-preference-changed 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-[40px] 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 z-tooltip zd-appearance- 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");
2
+ @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-checked 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-accent/10 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-icon-group 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-menu 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 device 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-[40px] 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 integer 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 menuitemradio 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 miter 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 p-hsp-xs 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 positive 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 system 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-preference-changed 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-[40px] 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 z-tooltip zd-appearance- 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");
@@ -416,6 +416,8 @@ export interface Settings {
416
416
  bundleZdtp?: boolean;
417
417
  tocMinDepth: number;
418
418
  tocMaxDepth: number;
419
+ /** Defaults to 3000 when omitted. */
420
+ searchMaxBodyLength?: number;
419
421
  sidebarResizer: boolean;
420
422
  sidebarToggle: boolean;
421
423
  tocToggle: boolean;
@@ -41,6 +41,7 @@ function SidebarToggle({
41
41
  if (!open) return;
42
42
  function handleKeyDown(event) {
43
43
  if (event.isComposing) return;
44
+ if (event.defaultPrevented) return;
44
45
  if (event.key === "Escape") {
45
46
  setOpen(false);
46
47
  hamburgerRef.current?.focus();
@@ -144,6 +144,7 @@ function ThemeToggle({
144
144
  const onMenuKeyDown = (event) => {
145
145
  if (event.key === "Escape") {
146
146
  event.preventDefault();
147
+ event.stopPropagation();
147
148
  close(true);
148
149
  } else if (event.key === "Tab") {
149
150
  window.setTimeout(() => close(), 0);
@@ -196,6 +197,7 @@ function ThemeToggle({
196
197
  setOpen(true);
197
198
  } else if (event.key === "Escape" && open) {
198
199
  event.preventDefault();
200
+ event.stopPropagation();
199
201
  close(true);
200
202
  }
201
203
  },
@@ -136,6 +136,13 @@ export function SidebarToggle({
136
136
  // yank focus to the hamburger. Same guard the sibling document-level
137
137
  // shortcut in `sidebar-tree-island/index.tsx` already uses.
138
138
  if (event.isComposing) return;
139
+ // A nested popover (the Appearance menu, or its trigger button) that
140
+ // owns this Escape already called preventDefault() + stopPropagation()
141
+ // to consume it for itself — see theme-toggle/index.tsx. Respecting
142
+ // defaultPrevented here establishes layered Escape ownership: the first
143
+ // Escape closes only the nested layer, and only a second, unconsumed
144
+ // Escape reaches the drawer (zudolab/zudo-doc#4393).
145
+ if (event.defaultPrevented) return;
139
146
  if (event.key === "Escape") {
140
147
  setOpen(false);
141
148
  hamburgerRef.current?.focus();
@@ -177,6 +177,12 @@ export function ThemeToggle({
177
177
  const onMenuKeyDown = (event: KeyboardEvent) => {
178
178
  if (event.key === "Escape") {
179
179
  event.preventDefault();
180
+ // The menu is portaled to document.body (see createPortal below), so this
181
+ // keydown bubbles all the way to `document` — where the mobile drawer's own
182
+ // Escape-to-close listener lives (sidebar-toggle-island/index.tsx). Without
183
+ // stopPropagation, closing just the menu would also close the drawer
184
+ // (zudolab/zudo-doc#4393).
185
+ event.stopPropagation();
180
186
  close(true);
181
187
  } else if (event.key === "Tab") {
182
188
  // Let the browser move focus before unmounting the focused menu item.
@@ -212,7 +218,14 @@ export function ThemeToggle({
212
218
  if (pending) { if (event.key === "Enter" || event.key === " ") event.preventDefault(); return; }
213
219
  if (event.key === "ArrowDown" || event.key === "ArrowUp") {
214
220
  event.preventDefault(); setPlacement(null); ensureMenuId(); setActiveIndex(event.key === "ArrowDown" ? 0 : 2); setOpen(true);
215
- } else if (event.key === "Escape" && open) { event.preventDefault(); close(true); }
221
+ } else if (event.key === "Escape" && open) {
222
+ // Same layered-ownership fix as onMenuKeyDown above: the trigger sits
223
+ // inside the mobile drawer (unlike the portaled menu), so its keydown
224
+ // bubbles straight to the drawer's document-level Escape listener.
225
+ event.preventDefault();
226
+ event.stopPropagation();
227
+ close(true);
228
+ }
216
229
  }}
217
230
  className="inline-flex h-[40px] w-[40px] shrink-0 items-center justify-center text-muted hover:text-fg focus-visible:outline-2 focus-visible:outline-accent focus-visible:outline-offset-2"
218
231
  ><PreferenceIcon preference={preference} /></button>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@takazudo/zudo-doc",
3
- "version": "5.27.0",
3
+ "version": "5.28.1",
4
4
  "type": "module",
5
5
  "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).",
6
6
  "license": "MIT",
@@ -717,9 +717,9 @@
717
717
  ],
718
718
  "peerDependencies": {
719
719
  "@takazudo/zdtp": "^0.5.2 || ^0.6.0 || ^0.7.0 || ^0.8.0",
720
- "@takazudo/zfb": "^2.20.2",
721
- "@takazudo/zfb-md-wasm": "^2.20.2",
722
- "@takazudo/zfb-runtime": "^2.20.2",
720
+ "@takazudo/zfb": "^2.22.0",
721
+ "@takazudo/zfb-md-wasm": "^2.22.0",
722
+ "@takazudo/zfb-runtime": "^2.22.0",
723
723
  "@takazudo/zudo-doc-history-server": "^5.17.2",
724
724
  "diff": "^8.0.0",
725
725
  "katex": "^0.16.0",
@@ -756,10 +756,10 @@
756
756
  "yaml": "^2.9.0"
757
757
  },
758
758
  "devDependencies": {
759
- "@takazudo/mdx-formatter": "1.3.0-next.4",
760
- "@takazudo/zfb": "2.20.2",
761
- "@takazudo/zfb-md-wasm": "2.20.2",
762
- "@takazudo/zfb-runtime": "2.20.2",
759
+ "@takazudo/mdx-formatter": "1.3.0",
760
+ "@takazudo/zfb": "2.22.0",
761
+ "@takazudo/zfb-md-wasm": "2.22.0",
762
+ "@takazudo/zfb-runtime": "2.22.0",
763
763
  "@types/fs-extra": "^11.0.4",
764
764
  "@types/minimist": "^1.2.5",
765
765
  "@types/node": "^25.3.5",
@@ -771,7 +771,7 @@
771
771
  "typescript": "^5.0.0",
772
772
  "vitest": "^4.1.0",
773
773
  "zod": "^4.3.6",
774
- "@takazudo/zudo-doc-history-server": "5.27.0"
774
+ "@takazudo/zudo-doc-history-server": "5.28.1"
775
775
  },
776
776
  "scripts": {
777
777
  "gen:search-widget-script": "node scripts/gen-search-widget-script.mjs",