@takazudo/zudo-doc 5.6.0 → 5.7.0

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.
@@ -1,302 +1,4 @@
1
- import { AFTER_NAVIGATE_EVENT } from "../transitions/page-events.js";
2
- import { CURRENT_PATH_SCRIPT_PRELUDE } from "../current-path/index.js";
3
- import { computeActiveNavPath, pathMatchesNavPath } from "./nav-active.js";
4
- import {
5
- NAV_CHEVRON_ACTIVE,
6
- NAV_CHEVRON_INACTIVE,
7
- NAV_CHILD_ACTIVE,
8
- NAV_CHILD_INACTIVE,
9
- NAV_MENU_CHILD_ACTIVE,
10
- NAV_MENU_CHILD_INACTIVE,
11
- NAV_MENU_PARENT,
12
- NAV_MENU_PARENT_ACTIVE_SUFFIX,
13
- NAV_MENU_PLAIN,
14
- NAV_MENU_PLAIN_ACTIVE_SUFFIX,
15
- NAV_TOP_ACTIVE,
16
- NAV_TOP_INACTIVE
17
- } from "./nav-class-tokens.js";
18
- const clsArgs = (tokens) => tokens.map((token) => JSON.stringify(token)).join(", ");
19
- const clsLiteral = (tokens) => JSON.stringify(tokens.join(" "));
20
- const clsAppend = (tokens) => JSON.stringify(" " + tokens.join(" "));
21
- const NAV_OVERFLOW_SCRIPT = `(function () {
22
- var cleanupNavOverflow = null;
23
-
24
- function trimSlashes(p) {
25
- while (p.length > 1 && p.charAt(p.length - 1) === "/") p = p.slice(0, -1);
26
- return p || "/";
27
- }
28
-
29
- function navPathname(a) {
30
- try { return trimSlashes(new URL(a.href, location.href).pathname); }
31
- catch (e) { return ""; }
32
- }
33
-
34
- // Explicit current-route override, embedded from current-path/index.ts so
35
- // this script cannot drift from the three other read sites
36
- // (zudolab/zudo-doc#3398, #3408).
37
- ${CURRENT_PATH_SCRIPT_PRELUDE}
38
-
39
- // Shared matching core (zudolab/zudo-doc#3398): embedded verbatim from
40
- // nav-active.ts so this script's longest-match walk cannot drift from the
41
- // SSR header's own computeActiveNavPath call (header.tsx). computeActiveNavPath
42
- // closes over pathMatchesNavPath, so both are embedded together.
43
- var pathMatchesNavPath = ${pathMatchesNavPath.toString()};
44
- var computeActiveNavPath = ${computeActiveNavPath.toString()};
45
-
46
- // Recompute which header nav item is "active" from the CURRENT URL and
47
- // repaint the highlight. SSR sets the active item on first paint, but the
48
- // header is persisted across same-locale client-router swaps
49
- // (data-zfb-transition-persist), so without this the highlight would stay
50
- // frozen on the page where the header was first rendered. Mirrors the
51
- // sidebar island's client-side approach (match the current path against
52
- // each entry's href) and the SSR longest-match + dropdown-parent rules.
53
- // URL-based: hrefs and the current path both carry the base + locale
54
- // prefix, so they compare directly without stripping.
55
- function applyActiveNav() {
56
- var nav = document.querySelector("[data-header-nav]");
57
- if (!nav) return;
58
- var topItems = Array.from(nav.querySelectorAll(":scope > [data-nav-item]"));
59
- if (topItems.length === 0) return;
60
-
61
- var cur = trimSlashes(readCurrentPath(CURRENT_PATH_DATASET_KEY));
62
-
63
- // Build NavItemLike-shaped entries from the live DOM so the shared
64
- // computeActiveNavPath can do the deepest-match walk \u2014 the same call
65
- // shape the SSR header uses (matches computeActiveNavPath). A dropdown
66
- // missing its own top-level anchor is skipped entirely (path "" would
67
- // otherwise match every current path \u2014 pathMatchesNavPath treats "" as
68
- // the root "/"), mirroring the parentLink guard used below for the same
69
- // malformed-markup case.
70
- var navItems = [];
71
- topItems.forEach(function (it) {
72
- var isDropdown = it.hasAttribute("data-nav-item-dropdown");
73
- var topA = isDropdown ? it.querySelector(":scope > a") : it;
74
- if (!topA) return;
75
- var children = [];
76
- if (isDropdown) {
77
- it.querySelectorAll(":scope > div a").forEach(function (c) {
78
- children.push({ path: navPathname(c) });
79
- });
80
- }
81
- navItems.push({ path: navPathname(topA), children: children });
82
- });
83
-
84
- var activePath = computeActiveNavPath(navItems, cur) || "";
85
-
86
- function setTopActive(a, active) {
87
- if (!a) return;
88
- if (active) {
89
- a.classList.add(${clsArgs(NAV_TOP_ACTIVE)});
90
- a.classList.remove(${clsArgs(NAV_TOP_INACTIVE)});
91
- a.setAttribute("aria-current", "page");
92
- } else {
93
- a.classList.remove(${clsArgs(NAV_TOP_ACTIVE)});
94
- a.classList.add(${clsArgs(NAV_TOP_INACTIVE)});
95
- a.removeAttribute("aria-current");
96
- }
97
- }
98
-
99
- topItems.forEach(function (it) {
100
- var isDropdown = it.hasAttribute("data-nav-item-dropdown");
101
- var topA = isDropdown ? it.querySelector(":scope > a") : it;
102
- var topActive = false;
103
-
104
- if (isDropdown) {
105
- var parentMatch = !!topA && navPathname(topA) === activePath && activePath !== "";
106
- var anyChild = false;
107
- it.querySelectorAll(":scope > div a").forEach(function (c) {
108
- var childActive = navPathname(c) === activePath && activePath !== "";
109
- if (childActive) {
110
- anyChild = true;
111
- c.setAttribute("data-active", "");
112
- c.classList.add(${clsArgs(NAV_CHILD_ACTIVE)});
113
- c.classList.remove(${clsArgs(NAV_CHILD_INACTIVE)});
114
- } else {
115
- c.removeAttribute("data-active");
116
- c.classList.remove(${clsArgs(NAV_CHILD_ACTIVE)});
117
- c.classList.add(${clsArgs(NAV_CHILD_INACTIVE)});
118
- }
119
- });
120
- topActive = parentMatch || anyChild;
121
- var svg = topA ? topA.querySelector("svg") : null;
122
- if (svg) {
123
- if (topActive) { svg.classList.add(${clsArgs(NAV_CHEVRON_ACTIVE)}); svg.classList.remove(${clsArgs(NAV_CHEVRON_INACTIVE)}); }
124
- else { svg.classList.add(${clsArgs(NAV_CHEVRON_INACTIVE)}); svg.classList.remove(${clsArgs(NAV_CHEVRON_ACTIVE)}); }
125
- }
126
- } else {
127
- topActive = activePath !== "" && navPathname(topA) === activePath;
128
- }
129
-
130
- setTopActive(topA, topActive);
131
- });
132
- }
133
-
134
- function initNavOverflow() {
135
- if (cleanupNavOverflow) cleanupNavOverflow();
136
-
137
- // Repaint the active highlight for the current URL before measuring /
138
- // cloning, so the overflow "\xB7\xB7\xB7" menu mirrors the correct active state.
139
- applyActiveNav();
140
-
141
- var nav = document.querySelector("[data-header-nav]");
142
- var moreContainer = document.querySelector("[data-nav-more]");
143
- var moreMenu = document.querySelector("[data-nav-more-menu]");
144
- var moreToggle = document.querySelector("[data-nav-more-toggle]");
145
- if (!nav || !moreContainer || !moreMenu || !moreToggle) return;
146
-
147
- var items = Array.from(nav.querySelectorAll(":scope > [data-nav-item]"));
148
- if (items.length === 0) return;
149
-
150
- var controller = new AbortController();
151
-
152
- function update() {
153
- items.forEach(function (el) { el.style.display = ""; });
154
- moreContainer.style.display = "";
155
- moreMenu.innerHTML = "";
156
- moreMenu.classList.add("hidden");
157
- moreToggle.setAttribute("aria-expanded", "false");
158
-
159
- var itemWidths = items.map(function (el) { return el.offsetWidth; });
160
- var moreWidth = moreContainer.offsetWidth;
161
- var navGap = parseFloat(getComputedStyle(nav).columnGap) || 0;
162
- var available = nav.clientWidth;
163
-
164
- if (available <= 0) {
165
- moreContainer.style.display = "none";
166
- return;
167
- }
168
-
169
- var total = 0;
170
- for (var i = 0; i < itemWidths.length; i++) {
171
- total += itemWidths[i] + (i > 0 ? navGap : 0);
172
- }
173
-
174
- if (total <= available) {
175
- moreContainer.style.display = "none";
176
- return;
177
- }
178
-
179
- var used = 0;
180
- var cutoffIndex = 0;
181
-
182
- for (var i2 = 0; i2 < items.length; i2++) {
183
- var w = itemWidths[i2] + (i2 > 0 ? navGap : 0);
184
- if (used + w > available - moreWidth - navGap) break;
185
- used += w;
186
- cutoffIndex = i2 + 1;
187
- }
188
-
189
- for (var i3 = cutoffIndex; i3 < items.length; i3++) {
190
- items[i3].style.display = "none";
191
- }
192
-
193
- for (var i4 = cutoffIndex; i4 < items.length; i4++) {
194
- var el = items[i4];
195
- var isDropdown = el.hasAttribute("data-nav-item-dropdown");
196
-
197
- if (isDropdown) {
198
- var parentLink = el.querySelector(":scope > a");
199
- var childLinks = el.querySelectorAll(":scope > div a");
200
- if (parentLink) {
201
- var li = document.createElement("li");
202
- var a = document.createElement("a");
203
- a.href = parentLink.href;
204
- var parentText = parentLink.textContent ? parentLink.textContent.trim().replace(/\\s+/g, " ") : "";
205
- a.textContent = parentText;
206
- a.className = ${clsLiteral(NAV_MENU_PARENT)};
207
- if (parentLink.getAttribute("aria-current") === "page") {
208
- a.className += ${clsAppend(NAV_MENU_PARENT_ACTIVE_SUFFIX)};
209
- }
210
- li.appendChild(a);
211
- moreMenu.appendChild(li);
212
- }
213
- childLinks.forEach(function (child) {
214
- var li = document.createElement("li");
215
- var a = document.createElement("a");
216
- a.href = child.href;
217
- a.textContent = child.textContent ? child.textContent.trim() : "";
218
- var isChildActive = child.hasAttribute("data-active");
219
- a.className = isChildActive
220
- ? ${clsLiteral(NAV_MENU_CHILD_ACTIVE)}
221
- : ${clsLiteral(NAV_MENU_CHILD_INACTIVE)};
222
- li.appendChild(a);
223
- moreMenu.appendChild(li);
224
- });
225
- } else {
226
- var anchor = el;
227
- var li2 = document.createElement("li");
228
- var a2 = document.createElement("a");
229
- a2.href = anchor.href;
230
- a2.textContent = anchor.textContent ? anchor.textContent.trim() : "";
231
- a2.className = ${clsLiteral(NAV_MENU_PLAIN)};
232
- if (anchor.getAttribute("aria-current") === "page") {
233
- a2.className += ${clsAppend(NAV_MENU_PLAIN_ACTIVE_SUFFIX)};
234
- }
235
- li2.appendChild(a2);
236
- moreMenu.appendChild(li2);
237
- }
238
- }
239
- }
240
-
241
- moreToggle.addEventListener("click", function () {
242
- var isOpen = !moreMenu.classList.contains("hidden");
243
- moreMenu.classList.toggle("hidden", isOpen);
244
- moreToggle.setAttribute("aria-expanded", String(!isOpen));
245
- }, { signal: controller.signal });
246
-
247
- document.addEventListener("click", function (e) {
248
- if (!moreContainer.contains(e.target)) {
249
- moreMenu.classList.add("hidden");
250
- moreToggle.setAttribute("aria-expanded", "false");
251
- }
252
- }, { signal: controller.signal });
253
-
254
- document.addEventListener("keydown", function (e) {
255
- if (e.key !== "Escape") return;
256
- if (!moreMenu.classList.contains("hidden")) {
257
- moreMenu.classList.add("hidden");
258
- moreToggle.setAttribute("aria-expanded", "false");
259
- moreToggle.focus();
260
- return;
261
- }
262
- var active = document.activeElement;
263
- var dropdown = active && active.closest ? active.closest("[data-nav-item-dropdown]") : null;
264
- if (dropdown && active && active.blur) {
265
- active.blur();
266
- }
267
- }, { signal: controller.signal });
268
-
269
- var dropdowns = nav.querySelectorAll("[data-nav-item-dropdown]");
270
- dropdowns.forEach(function (dd) {
271
- var trigger = dd.querySelector(":scope > a");
272
- if (!trigger) return;
273
- function setExpanded(v) {
274
- trigger.setAttribute("aria-expanded", String(v));
275
- }
276
- dd.addEventListener("mouseenter", function () { setExpanded(true); }, { signal: controller.signal });
277
- dd.addEventListener("mouseleave", function () { setExpanded(false); }, { signal: controller.signal });
278
- dd.addEventListener("focusin", function () { setExpanded(true); }, { signal: controller.signal });
279
- dd.addEventListener("focusout", function (e) {
280
- if (!dd.contains(e.relatedTarget)) {
281
- setExpanded(false);
282
- }
283
- }, { signal: controller.signal });
284
- });
285
-
286
- var ro = new ResizeObserver(update);
287
- ro.observe(nav);
288
- controller.signal.addEventListener("abort", function () { ro.disconnect(); });
289
-
290
- document.fonts.ready.then(update);
291
-
292
- update();
293
-
294
- cleanupNavOverflow = function () { controller.abort(); };
295
- }
296
-
297
- initNavOverflow();
298
- document.addEventListener(${JSON.stringify(AFTER_NAVIGATE_EVENT)}, initNavOverflow);
299
- })();`;
1
+ import { NAV_OVERFLOW_SCRIPT } from "./nav-overflow-generated-script.js";
300
2
  export {
301
3
  NAV_OVERFLOW_SCRIPT
302
4
  };
@@ -2,8 +2,40 @@ import { readFileSync, readdirSync } from "node:fs";
2
2
  import { join, relative } from "node:path";
3
3
  import matter from "gray-matter";
4
4
  import { toRouteSlug } from "../slug/index.js";
5
+ const NAMED_CHARACTER_REFERENCES = {
6
+ lt: "<",
7
+ gt: ">",
8
+ quot: '"',
9
+ apos: "'",
10
+ nbsp: "\xA0"
11
+ };
12
+ function decodeCharacterReferences(value) {
13
+ return value.replace(
14
+ /&#(?:([0-9]+)|[xX]([0-9a-fA-F]+));/g,
15
+ (reference, decimal, hexadecimal) => {
16
+ const digits = decimal ?? hexadecimal;
17
+ if (!digits) return reference;
18
+ const codePoint = Number.parseInt(digits, decimal ? 10 : 16);
19
+ if (codePoint > 1114111 || codePoint >= 55296 && codePoint <= 57343) {
20
+ return reference;
21
+ }
22
+ try {
23
+ return String.fromCodePoint(codePoint);
24
+ } catch {
25
+ return reference;
26
+ }
27
+ }
28
+ ).replace(
29
+ /&(lt|gt|quot|apos|nbsp);/g,
30
+ (reference, name) => NAMED_CHARACTER_REFERENCES[name] ?? reference
31
+ ).replace(/&amp;/g, "&");
32
+ }
5
33
  function stripMarkdown(md) {
6
- return md.replace(/```[\s\S]*?```/g, "").replace(/`[^`]+`/g, "").replace(/\{\/\*[\s\S]*?\*\/\}/g, "").replace(/<[^>]+>/g, "").replace(/^#{1,6}\s+/gm, "").replace(/\*{1,3}([^*]+)\*{1,3}/g, "$1").replace(/_{1,3}([^_]+)_{1,3}/g, "$1").replace(/!\[[^\]]*\]\([^)]+\)/g, "").replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/^>\s+/gm, "").replace(/^[-*_]{3,}\s*$/gm, "").replace(/^[\s]*[-*+]\s+/gm, "").replace(/^[\s]*\d+\.\s+/gm, "").replace(/^import\s+.*$/gm, "").replace(/^export\s+.*$/gm, "").replace(/\n{3,}/g, "\n\n").trim();
34
+ const withoutCodeCommentsAndTags = md.replace(/```[\s\S]*?```/g, "").replace(/`[^`]+`/g, "").replace(/\{\/\*[\s\S]*?\*\/\}/g, "").replace(/<[^>]+>/g, "");
35
+ return decodeCharacterReferences(withoutCodeCommentsAndTags).replace(/^#{1,6}\s+/gm, "").replace(/\*{1,3}([^*]+)\*{1,3}/g, "$1").replace(
36
+ /(^|[^\p{L}\p{N}])(_{1,3})(?=\S)([^_\n]*?\S)\2(?=$|[^\p{L}\p{N}])/gmu,
37
+ "$1$3"
38
+ ).replace(/!\[[^\]]*\]\([^)]+\)/g, "").replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/^>\s+/gm, "").replace(/^[-*_]{3,}\s*$/gm, "").replace(/^[\s]*[-*+]\s+/gm, "").replace(/^[\s]*\d+\.\s+/gm, "").replace(/^import\s+.*$/gm, "").replace(/^export\s+.*$/gm, "").replace(/\n{3,}/g, "\n\n").trim();
7
39
  }
8
40
  function collectMdFiles(dir) {
9
41
  const results = [];
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 -link -mb-px -ml-hsp-sm -noscript -open -state -translate-x-full 2xl:w-[24px] [&::-webkit-details-marker]:hidden [&_a]:text-accent [&_a]:underline [&_nav]:mb-0 [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-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/xml applied applies apply applying approach 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 arrows article as asc aside aspect-[1200/630] aspect-square asset- assets assistant async at at-rule attach attribute attributes auf authored auto auto-logo-mask autogenerated availability available 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 banner bare base base- base64 base:base- based 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 bigint bin binaries bind binding blank blanks block blockquote blocks blur 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 cache cached call callable called caller calls can cancellation candidate cannot canonical canvas caption captured captures card card-grid carry cases cat-nav- catch category caught caution center center/contain ch chains change changed changelog changelogs changes check child children choose chrome chrome-font ci circle cite class class-less class-mode claude claude-agents claude-commands claude-md 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 col col-resize colgroup 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 component component:github-link component:language-switcher component:search component:theme-toggle component:version-switcher composes composition compute computed concrete config configuration configurations configure configured 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 core corners correct correctly corrupt could count covered covers crashes created cross-component crumb- cs css css-presence ctx cur current current-path/index.ts current-route currently cursor cursor-not-allowed cursor-pointer custom cycle danger dark data data-active data-admonition data-auto-logo data-base data-close-search data-current-locale data-default-locale 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-language-switcher data-loading-index data-mermaid-enlarge-ready data-mermaid-rendered data-mermaid-src data-nav-active data-nav-item data-nav-item-dropdown data-nav-more data-nav-more-menu data-nav-more-toggle data-no-results data-open-search data-pan-active data-processed 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-mobile-sidebar data-zd-mobile-toc data-zd-nosidebar data-zd-theme-pack-css data-zd-theme-pack-css-loading data-zd-theme-pack-loading data-zd-toc data-zd-wide data-zfb-transition-persist dd decimal declaration declare declares decoration decoration-muted 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 develop 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 different dir directly directories directory disabled 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 does dog double-registration draft drag drawer drift drifts drop dropdown dropdown-parent dropdowns dt duplicate duration-150 duration-200 during dynamically e e2e each 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 entirely entities entries entry entrypoint equal error escape escaped even eventually every everything-enabled exactly exceeds excerpt excludes exclusively existing exists exit 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 fill fills finally find find-match find-match-active fire fires first first-paint fix fixed fixed-width fixtures flag flash flat flex flex-1 flex-col flex-wrap flip flipping flips flow flush-left focus 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:border-accent focus:outline-none focus:text-accent focus:underline 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 frame free freeze fresh from frontmatter frontmatter-preview frozen fs-extra 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-lg gap-y-vsp-md gap-y-vsp-xs gaps gate geladen2026 generate generated generation genuine geometry get getting-started github github-dark github-link give go got grab gradient granular graph gray-matter grid grid-cols-1 grid-cols-2 group group-focus-visible:text-accent 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:underline group-open:rotate-90 guard 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-[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 hidden hide hierarchical highlight history home 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 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 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 inbox includes including incomplete independently index index2026 indirectly info inherit inherited 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 install installation installed instance instanceof instead instructions intended intent intercept internal interpolation into invalid invalidated inverse inversion invoke is island island-root issues it italic item item- items items-baseline items-center items-end items-start iteration its itself javascript js jsx jumps just 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 label landing lands language-switcher last:border-b-0 later latest launch layout lazy leading-normal leading-relaxed leading-snug leading-tight 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: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 light light/dark like likely line line-height line/statement linger link link- links list list-disc list-none listener lists literal literally literals live lives llms llms-txt load loaded loading local local-1 local-2 local-3 locale locales log logo longer longest-match look loses lostpointercapture lower luminance m m-0 m-auto m21 m6 machinery main major make malformed malformed-markup malicious manually maps mark markdown marks match matching math math-display math-inline max max-h-[85vh] max-h-[90vh] max-h-full max-h-none max-w-[64rem] max-w-[85%] max-w-[85vw] max-w-[90vw] max-w-[calc(100vw-2rem)] max-w-[clamp(50rem,75vw,90rem)] max-w-full max-w-none max-w-sm max-width 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-[60vh] min-h-[calc(100vh-3.5rem)] min-h-screen min-w-0 min-w-[10rem] min-w-[3rem] min-w-[8rem] minifier minor mirror mirroring mirrors missing mit ml-auto ml-hsp-2xl ml-hsp-lg ml-hsp-sm ml-hsp-xl mobile mod modal modal-backdrop mode modify module moment monospace more most mount mounted mouseenter mouseleave move 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 must mutates mutation mutations muted 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 nodes nofollow noindex non-draggable non-empty non-light-dark non-literal non-persisted none noopener noreferrer normal noscript not notable note 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 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 override overrides overscroll-contain overwrite own owned p p-0 p-hsp-2xs p-hsp-lg p-hsp-md p-hsp-sm 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-md pb-vsp-xl pb-vsp-xs pending per per-block per-link permanently persisted persistence pi pick picked picks picocolors pins pipelines pl-[1.25rem] pl-hsp-lg pl-hsp-sm pl-hsp-xl place placeholder placeholder:text-muted plain plural plus png16 png32 pnpm point pointer pointer-events-none pointercancel pointerdown pointermove pointerup polite polygon polyline popover populates port position position:fixed pr-[4px] pr-hsp-lg pr-hsp-md pr-hsp-sm pr-hsp-xl 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 private produce produced produces producing production 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-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 q query question quick r radius radius-full radius-lg rail ramp range rather raw re-encode/decode re-exports 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 refreshes regardless regenerate regenerates regex registry reinit reinits rejected rel relative release released reload relying rem remapped remembered remove removed render rendered renderer renderers renders reorder repaint repair repeated repeating replace replaced replacement replaces repopulate report repository required requires reserved resize resize-x resolve resolved resolves responded response restore restores restyle result result-click results results-area retry return returns 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 router routes routes-src rule run running runs runtime 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 seam search search-index section section- see seed sehen select select-none selection-bg selection-fg selector self self-contained self-hosted self-start semantic semibold semver sentinel separator serialised serialize server server-rendered session set sets setting settles setup 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 signal silently similarity simple since single single-line single-object-literal singular site site-search site-tree-nav-island sitemap- sites size skill skills skipped skipping skips slash slot slug slug-dir-parity slugs sm:border sm:border-muted sm:flex-row sm:grid-cols-2 sm:h-auto sm:items-center sm:justify-between sm:max-h-[80vh] sm:max-w-[52rem] sm:mx-auto sm:my-[10vh] sm:rounded-lg small smooth snapping snapshot snapshots so soft soft-nav solid some somehow source sources space-y-vsp-2xs spacing spacing-0 spacing-px span spans spec specifiers specify spelling splitter spread spurious 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 switcher switching synchronous synchronously syntactically syntax t tab tab-item tab-panel tabindex table tablist tabpanel tabs tabs-container tabs-content tabs-nav tag tag- tag-item- tagged tags tags:audit take 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/plain textarea tfoot 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 tip title to toast toc toggle toggle- toggle-ai-chat toggle-design-token-panel toggles toggling token tokens tolerates too toolbar tooltip top top-0 top-[3.5rem] top-full top-level total touches tr tracked tracking-wide tracking-wider trade-off trailing transition transition-[background,color,border-color] transition-[left,color] transition-[right,color] transition-colors transition-transform translate-x-0 translated translations transparent treats tree tree-child- tree-item- tree-top- trigger trigger:ai-chat trigger:design-token-panel triggers true truncate truncated try ts tsx turn twitter:card twitter:creator twitter:description twitter:image twitter:site twitter:title two type typeface typography u ul umschalten unavailable unbalanced unchanged und undefined under underline underlines understand unit-tested unknown unlike unlisted unmaintained unobserve unreadable unrelated unreleased unresolvable unresolved unset unterminated until unusable unwrapped up up-to-date update uppercase use used useful user uses 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 viewing viewport viewports virtual:zudo-doc-chrome-bindings virtual:zudo-doc-design-token-panel-config virtual:zudo-doc-route-context visibility visible vocabulary 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-[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 website weight went were what when where whereas whether which while whitespace-nowrap whitespace-pre whole wide wide-gamut wider-than-scrollbar width will wins wird wired with without word wordmark working works worktrees would wrap wrapped wrapper wrappers wrapping wraps written wrong wrote wurde x xl:flex xl:hidden y-scrollbar yet yields you your z-dropdown z-local-1 z-modal z-modal-backdrop z-popover z-sidebar z-toolbar 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 zod zoom zudo-design-token-panel zudo-design-tokens/v3 zudo-doc 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 -link -mb-px -ml-hsp-sm -noscript -open -state -translate-x-full 2xl:w-[24px] [&::-webkit-details-marker]:hidden [&_a]:text-accent [&_a]:underline [&_nav]:mb-0 [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-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/xml applied applies apply applying approach 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 arrows article as asc aside aspect-[1200/630] aspect-square asset- assets assistant async at at-rule attach attribute attributes auf authored auto auto-logo-mask autogenerated availability available 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 banner bare base base- base64 base:base- based 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 bigint bin binaries bind binding blank blanks block blockquote blocks blur 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 cache cached call callable called caller calls can cancellation candidate cannot canonical canvas caption captured captures card card-grid carry cases cat-nav- catch category caught caution center center/contain ch chains change changed changelog changelogs changes check child children choose chrome chrome-font ci circle cite class class-less class-mode claude claude-agents claude-commands claude-md 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 col col-resize colgroup 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 component component:github-link component:language-switcher component:search component:theme-toggle component:version-switcher composes composition compute computed concrete config configuration configurations configure configured 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 core corners correct correctly corrupt could count covered covers crashes created cross-component crumb- cs css css-presence ctx cur current current-path/index.ts current-route currently cursor cursor-not-allowed cursor-pointer custom cycle danger dark data data-active data-admonition data-auto-logo data-base data-close-search data-current-locale data-default-locale 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-language-switcher data-loading-index data-mermaid-enlarge-ready data-mermaid-rendered data-mermaid-src data-nav-active data-nav-item data-nav-item-dropdown data-nav-more data-nav-more-menu data-nav-more-toggle data-no-results 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-mobile-sidebar data-zd-mobile-toc data-zd-nosidebar 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-transition-persist dd decimal declaration declare declares decoration decoration-muted 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 develop 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 different dir directly directories directory disabled 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 does dog double-registration draft drag drawer drift drifts drop dropdown dropdown-parent dropdowns dt duplicate duration-150 duration-200 during dynamically e e2e each 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 entirely entities entries entry entrypoint equal error escape escaped even eventually every everything-enabled exactly exceeds excerpt excludes exclusively existing exists exit 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 fill fills finally find find-match find-match-active fire fires first first-paint fix fixed fixed-width fixtures flag flash flat flex flex-1 flex-col flex-wrap flip flipping flips flow flush-left focus 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:border-accent focus:outline-none focus:text-accent focus:underline 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 frame free freeze fresh from frontmatter frontmatter-preview frozen fs-extra 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-lg gap-y-vsp-md gap-y-vsp-xs gaps gate geladen2026 generate generated generation genuine geometry get getting-started github github-dark github-link give go got grab gradient granular graph gray-matter grid grid-cols-1 grid-cols-2 group group-focus-visible:text-accent 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:underline group-open:rotate-90 guard 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-[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 hidden hide hierarchical highlight history home 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 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 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 inbox includes including incomplete independently index index2026 indirectly info inherit inherited 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 install installation installed instance instanceof instead instructions intended intent intercept internal interpolation into invalid invalidated inverse inversion invoke is island island-root issues it italic item item- items items-baseline items-center items-end items-start iteration its itself javascript js jsx jumps just 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 label landing lands language-switcher last:border-b-0 later latest launch layout lazy leading-normal leading-relaxed leading-snug leading-tight 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: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 light light/dark like likely line line-height line/statement linger link link- links list list-disc list-none listener lists literal literally literals live lives llms llms-txt load loaded loading local local-1 local-2 local-3 locale locales log logo longer longest-match look loses lostpointercapture lower luminance m m-0 m-auto m21 m6 machinery main major make malformed malformed-markup malicious manually maps mark markdown marks match matching math math-display math-inline max max-h-[85vh] max-h-[90vh] max-h-full max-h-none max-w-[64rem] max-w-[85%] max-w-[85vw] max-w-[90vw] max-w-[calc(100vw-2rem)] max-w-[clamp(50rem,75vw,90rem)] max-w-full max-w-none max-w-sm max-width 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-[60vh] min-h-[calc(100vh-3.5rem)] min-h-screen min-w-0 min-w-[10rem] min-w-[3rem] min-w-[8rem] minifier minor mirror mirroring mirrors missing mit ml-auto ml-hsp-2xl ml-hsp-lg ml-hsp-sm ml-hsp-xl mobile mod modal modal-backdrop mode modify module moment monospace more most mount mounted mouseenter mouseleave move 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 must mutates mutation mutations muted 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 nodes nofollow noindex non-draggable non-empty non-light-dark non-literal non-persisted none noopener noreferrer normal noscript not notable note 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 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 override overrides overscroll-contain overwrite own owned p p-0 p-hsp-2xs p-hsp-lg p-hsp-md p-hsp-sm 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-md pb-vsp-xl pb-vsp-xs pending per per-block per-link permanently persisted persistence pi pick picked picks picocolors pins pipelines pl-[1.25rem] pl-hsp-lg pl-hsp-sm pl-hsp-xl place placeholder placeholder:text-muted plain plural plus png16 png32 pnpm point pointer pointer-events-none pointercancel pointerdown pointermove pointerup polite polygon polyline popover populates port position position:fixed pr-[4px] pr-hsp-lg pr-hsp-md pr-hsp-sm pr-hsp-xl 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 private produce produced produces producing production 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-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 q query question quick r radius radius-full radius-lg rail ramp range rather raw re-encode/decode re-exports 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 refreshes regardless regenerate regenerates regex registry reinit reinits rejected rel relative release released reload relying rem remapped remembered remove removed render rendered renderer renderers renders reorder repaint repair repeated repeating replace replaced replacement replaces repopulate report repository required requires reserved resize resize-x resolve resolved resolves responded response restore restores restyle result result-click results results-area retry return returns 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 router routes routes-src rule run running runs runtime 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 seam search search-index section section- see seed sehen select select-none selection-bg selection-fg selector self self-contained self-hosted self-start semantic semibold semver sentinel separator serialised serialize server server-rendered session set sets setting settles setup 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 signal silently similarity simple since single single-line single-object-literal singular site site-search site-tree-nav-island sitemap- sites size skill skills skipped skipping skips slash slot slug slug-dir-parity slugs sm:border sm:border-muted sm:flex-row sm:grid-cols-2 sm:h-auto sm:items-center sm:justify-between sm:max-h-[80vh] sm:max-w-[52rem] sm:mx-auto sm:my-[10vh] sm:rounded-lg small smooth snapping snapshot snapshots so soft soft-nav solid some somehow source sources space-y-vsp-2xs spacing spacing-0 spacing-px span spans spec specifiers specify spelling splitter spread spurious 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 switcher switching synchronous synchronously syntactically syntax t tab tab-item tab-panel tabindex table tablist tabpanel tabs tabs-container tabs-content tabs-nav tag tag- tag-item- tagged tags tags:audit take 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/plain textarea tfoot 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 tip title to toast toc toggle toggle- toggle-ai-chat toggle-design-token-panel toggles toggling token tokens tolerates too toolbar tooltip top top-0 top-[3.5rem] top-full top-level total touches tr tracked tracking-wide tracking-wider trade-off trailing transition transition-[background,color,border-color] transition-[left,color] transition-[right,color] transition-colors transition-transform translate-x-0 translated translations transparent treats tree tree-child- tree-item- tree-top- trigger trigger:ai-chat trigger:design-token-panel triggers true truncate truncated try ts tsx turn twitter:card twitter:creator twitter:description twitter:image twitter:site twitter:title two type typeface typeof typography u ul umschalten unavailable unbalanced unchanged und undefined under underline underlines understand unit-tested unknown unlike unlisted unmaintained unobserve unreadable unrelated unreleased unresolvable unresolved unset unterminated until unusable unwrapped up up-to-date update uppercase use used useful user uses 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 viewing viewport viewports 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-[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 website weight went were what when where whereas whether which while whitespace-nowrap whitespace-pre whole 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 written wrong wrote wurde x xl:flex xl:hidden y-scrollbar yet yields you your z-dropdown z-local-1 z-modal z-modal-backdrop z-popover z-sidebar z-toolbar 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 zod zoom zudo-design-token-panel zudo-design-tokens/v3 zudo-doc 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");
@@ -1,8 +1,9 @@
1
1
  "use client";
2
2
  import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
3
3
  import { useState, useEffect } from "preact/hooks";
4
- import { AFTER_NAVIGATE_EVENT } from "../transitions/index.js";
4
+ import { AFTER_NAVIGATE_EVENT, ensureNestedIslandPropsRefresh } from "../transitions/index.js";
5
5
  import { SidebarTree } from "../sidebar-tree-island/index.js";
6
+ ensureNestedIslandPropsRefresh();
6
7
  const cx = (...classes) => classes.filter(Boolean).join(" ");
7
8
  function SidebarToggle({
8
9
  nodes,
@@ -1 +1,2 @@
1
1
  export { BEFORE_NAVIGATE_EVENT, AFTER_NAVIGATE_EVENT, onBeforeNavigate, onAfterNavigate, } from "./page-events.js";
2
+ export { ensureNestedIslandPropsRefresh } from "./nested-island-props-refresh.js";
@@ -4,9 +4,11 @@ import {
4
4
  onBeforeNavigate,
5
5
  onAfterNavigate
6
6
  } from "./page-events.js";
7
+ import { ensureNestedIslandPropsRefresh } from "./nested-island-props-refresh.js";
7
8
  export {
8
9
  AFTER_NAVIGATE_EVENT,
9
10
  BEFORE_NAVIGATE_EVENT,
11
+ ensureNestedIslandPropsRefresh,
10
12
  onAfterNavigate,
11
13
  onBeforeNavigate
12
14
  };
@@ -0,0 +1,19 @@
1
+ interface NestedIslandPropsRefreshOptions {
2
+ document: Document;
3
+ }
4
+ /**
5
+ * Install the before-swap props-refresh listener on a document.
6
+ *
7
+ * This low-level entrypoint owns an explicit cleanup for focused tests and
8
+ * non-singleton hosts. Browser modules use the durable, duplicate-safe
9
+ * `ensureNestedIslandPropsRefresh` wrapper below instead.
10
+ */
11
+ export declare function installNestedIslandPropsRefresh({ document, }: NestedIslandPropsRefreshOptions): () => void;
12
+ /**
13
+ * Install exactly one document-lifetime controller for a browser document.
14
+ * Repeated calls from component renders or duplicate boot paths are no-ops.
15
+ */
16
+ export declare function ensureNestedIslandPropsRefresh(options?: NestedIslandPropsRefreshOptions): void;
17
+ /** Test/HMR teardown for a controller installed through the singleton wrapper. */
18
+ export declare function disposeNestedIslandPropsRefresh(document: Document): void;
19
+ export {};
@@ -0,0 +1,104 @@
1
+ import { BEFORE_SWAP_EVENT } from "./page-events.js";
2
+ const PERSIST_ATTR = "data-zfb-transition-persist";
3
+ const ISLAND_ATTR = "data-zfb-island";
4
+ const PROPS_ATTR = "data-props";
5
+ const ISLAND_REMOUNT_ATTR = "data-zfb-island-remount";
6
+ const DOCUMENT_NODE = 9;
7
+ const installedControllers = /* @__PURE__ */ new WeakMap();
8
+ function installNestedIslandPropsRefresh({
9
+ document: document2
10
+ }) {
11
+ const onBeforeSwap = (event) => {
12
+ const incoming = event.newDocument;
13
+ if (!isDocument(incoming) || incoming === document2) return;
14
+ refreshNestedIslandProps(document2, incoming);
15
+ };
16
+ document2.addEventListener(BEFORE_SWAP_EVENT, onBeforeSwap);
17
+ return () => document2.removeEventListener(BEFORE_SWAP_EVENT, onBeforeSwap);
18
+ }
19
+ function ensureNestedIslandPropsRefresh(options) {
20
+ const resolved = options ?? resolveBrowserOptions();
21
+ if (!resolved || installedControllers.has(resolved.document)) return;
22
+ installedControllers.set(
23
+ resolved.document,
24
+ installNestedIslandPropsRefresh(resolved)
25
+ );
26
+ }
27
+ function disposeNestedIslandPropsRefresh(document2) {
28
+ installedControllers.get(document2)?.();
29
+ installedControllers.delete(document2);
30
+ }
31
+ function refreshNestedIslandProps(liveDocument, incomingDocument) {
32
+ const liveRoots = collectRefreshableRoots(liveDocument);
33
+ if (liveRoots.size === 0) return;
34
+ const incomingRoots = collectRefreshableRoots(incomingDocument);
35
+ for (const [persistKey, liveRoot] of liveRoots) {
36
+ const incomingRoot = incomingRoots.get(persistKey);
37
+ if (!incomingRoot) continue;
38
+ const incomingIslands = collectUniqueOwnedIslands(incomingRoot);
39
+ if (incomingIslands.size === 0) continue;
40
+ for (const [name, liveIsland] of collectUniqueOwnedIslands(liveRoot)) {
41
+ const incomingIsland = incomingIslands.get(name);
42
+ if (!incomingIsland) continue;
43
+ applyProps(liveIsland, incomingIsland);
44
+ }
45
+ }
46
+ }
47
+ function collectRefreshableRoots(doc) {
48
+ const roots = indexUniquely(
49
+ doc.querySelectorAll(`[${PERSIST_ATTR}]`),
50
+ PERSIST_ATTR
51
+ );
52
+ for (const [persistKey, element] of roots) {
53
+ if (element.parentElement?.closest(`[${PERSIST_ATTR}]`)) {
54
+ roots.delete(persistKey);
55
+ }
56
+ }
57
+ return roots;
58
+ }
59
+ function collectUniqueOwnedIslands(root) {
60
+ const owned = Array.from(root.querySelectorAll(`[${ISLAND_ATTR}]`)).filter(
61
+ (island) => island.closest(`[${PERSIST_ATTR}]`) === root
62
+ );
63
+ return indexUniquely(owned, ISLAND_ATTR);
64
+ }
65
+ function indexUniquely(elements, attribute) {
66
+ const byValue = /* @__PURE__ */ new Map();
67
+ const duplicated = /* @__PURE__ */ new Set();
68
+ for (const element of elements) {
69
+ const value = element.getAttribute(attribute);
70
+ if (!value) continue;
71
+ if (byValue.has(value)) {
72
+ duplicated.add(value);
73
+ continue;
74
+ }
75
+ byValue.set(value, element);
76
+ }
77
+ for (const value of duplicated) byValue.delete(value);
78
+ return byValue;
79
+ }
80
+ function applyProps(liveIsland, incomingIsland) {
81
+ const incoming = incomingIsland.getAttribute(PROPS_ATTR);
82
+ const current = liveIsland.getAttribute(PROPS_ATTR);
83
+ if (incoming === current) return;
84
+ if (incoming === null) {
85
+ liveIsland.removeAttribute(PROPS_ATTR);
86
+ } else {
87
+ liveIsland.setAttribute(PROPS_ATTR, incoming);
88
+ }
89
+ liveIsland.setAttribute(ISLAND_REMOUNT_ATTR, "");
90
+ }
91
+ function isDocument(value) {
92
+ if (typeof value !== "object" || value === null) return false;
93
+ const candidate = value;
94
+ return candidate.nodeType === DOCUMENT_NODE && typeof candidate.querySelectorAll === "function";
95
+ }
96
+ function resolveBrowserOptions() {
97
+ if (typeof document === "undefined") return void 0;
98
+ return { document };
99
+ }
100
+ export {
101
+ disposeNestedIslandPropsRefresh,
102
+ ensureNestedIslandPropsRefresh,
103
+ installNestedIslandPropsRefresh
104
+ };
@@ -310,12 +310,20 @@ export function Header(props: HeaderProps): JSX.Element {
310
310
  // - Search: <site-search> custom element re-registers on
311
311
  // AFTER_NAVIGATE_EVENT (_search-widget-script.ts:184, verified (a))
312
312
  // - SidebarToggle (mobile): closes on AFTER_NAVIGATE_EVENT
313
- // (sidebar-toggle.tsx:72, verified (a); sidebar content is
314
- // re-serialised into Island data-props on every SSR render, so
315
- // same-locale swaps see stale SSR in the persist window but the
316
- // Island re-hydrates with correct nodes on mount)
313
+ // (sidebar-toggle-island/index.tsx, verified (a)). Its section tree
314
+ // rides the Island's serialised data-props, and re-hydration alone
315
+ // does NOT correct it — the header is lifted verbatim, so the Island
316
+ // re-mounts from the OLD props (zudolab/zudo-doc#3525). What corrects
317
+ // it is `ensureNestedIslandPropsRefresh`
318
+ // (transitions/nested-island-props-refresh.ts, registered from the
319
+ // island module): on BEFORE_SWAP_EVENT it copies the incoming
320
+ // document's data-props onto the live nested islands, and
321
+ // mountNewIslands re-reads the attribute at mount time (#3530)
317
322
  // - Header nav + aria-current: NAV_OVERFLOW_SCRIPT re-runs on
318
- // AFTER_NAVIGATE_EVENT (nav-overflow-script.ts:198, verified (a))
323
+ // AFTER_NAVIGATE_EVENT (frozen by zudolab/zudo-doc#3534 — the
324
+ // `addEventListener(${afterNavigateEventLiteral}, initNavOverflow)`
325
+ // call at the tail of the template in
326
+ // scripts/gen-nav-overflow-script.mjs, verified (a))
319
327
  // - LanguageSwitcher: its target hrefs ARE per-page (the equivalent
320
328
  // page in each other locale), so within a same-locale persist window
321
329
  // they WOULD go stale — the locale is constant but the path is not.