@takazudo/zudo-doc 5.7.0 → 5.8.0

package/CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to `@takazudo/zudo-doc` are documented in this file.
 
 The format is based on Keep a Changelog, and release notes are generated from the changelog MDX pages.
 
+## [5.8.0] - 2026-08-20
+
+### Features
+
+- Added strict anchor validation to the showcase and generated-project link checkers, including source-first validation for scaffolded sites. (`b50bd9aac`, `59127e7fe`)
+- Added a published-version guard that prevents release scaffolds from pinning first-party packages that are not yet available from npm. (`4bdc37132`, `8c234c08e`)
+- Shipped a complete nav-overflow regeneration path with ejected headers, preserving stable CSP bytes while allowing local nav behavior and class-token customization. (`1b3d501c3`, `721ff37d3`)
+
+### Bug Fixes
+
+- Made nested island props preservation explicit with `data-zd-props-preserve`, preventing opted-out islands from receiving props updates or remount flags during client navigation. (`e75cff084`)
+
+### Other Changes
+
+- Strengthened `docTags` regression coverage so an unselected feature cannot emit either a `true` or `false` config field. (`37dec787c`)
+- Updated `@takazudo/zdtp` to 0.4.12 across the package, showcase, and generated scaffold.
+
 ## [5.7.0] - 2026-08-20
 
 ### Features

package/README.md

@@ -67,6 +67,23 @@ pnpm add @takazudo/zfb-md-wasm
 
 Projects scaffolded by `create-zudo-doc` already include it. If you never render `<HtmlPreview>` / `<HighlightedCode>`, you can omit it.
 
+## Ejected header customization
+
+`zudo-doc eject header` copies a complete frozen-script regeneration path into
+`src/components/zudo-doc/header`. After changing the ejected `nav-active.ts` or
+`nav-class-tokens.ts`, regenerate the local client controller and commit the
+result:
+
+```sh
+node ./src/components/zudo-doc/header/gen-nav-overflow-script.mjs
+```
+
+The command uses the two local customization inputs plus the installed
+package's current-path and page-event inputs. Its `esbuild` transformer is
+provided by `@takazudo/zudo-doc`; no additional project dependency is needed.
+The resulting `nav-overflow-generated-script.ts` stays frozen for stable CSP
+hashes across consumer bundlers.
+
 ## ⚠️ HTML preview iframe sandbox — trust assumption
 
 `<HtmlPreview>` / `<HtmlPreviewWrapper>` render their preview inside an `<iframe srcdoc>` whose `sandbox` attribute **defaults** to:

package/dist/eject/index.js

@@ -340,6 +340,15 @@ ${status} from @takazudo/zudo-doc@${installedVersion}
 `
     )
   );
+  if (component === "header") {
+    console.log(
+      pc.bold("Header frozen-script regeneration:") + `
+  After editing ${localDir}/nav-active.ts or nav-class-tokens.ts, run:
+  node ./${localDir}/gen-nav-overflow-script.mjs
+  Commit ${localDir}/nav-overflow-generated-script.ts with your edits.
+`
+    );
+  }
 }
 export {
   EJECTABLE,

package/dist/safelist.css

@@ -1,2 +1,2 @@
 /* generated by gen-safelist.mjs — do not edit by hand */
-@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");
+@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-props-preserve 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 frozen-script 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");

package/dist/transitions/nested-island-props-refresh.js

@@ -2,6 +2,7 @@ import { BEFORE_SWAP_EVENT } from "./page-events.js";
 const PERSIST_ATTR = "data-zfb-transition-persist";
 const ISLAND_ATTR = "data-zfb-island";
 const PROPS_ATTR = "data-props";
+const PROPS_PRESERVE_ATTR = "data-zd-props-preserve";
 const ISLAND_REMOUNT_ATTR = "data-zfb-island-remount";
 const DOCUMENT_NODE = 9;
 const installedControllers = /* @__PURE__ */ new WeakMap();
@@ -37,7 +38,7 @@ function refreshNestedIslandProps(liveDocument, incomingDocument) {
     if (!incomingRoot) continue;
     const incomingIslands = collectUniqueOwnedIslands(incomingRoot);
     if (incomingIslands.size === 0) continue;
-    for (const [name, liveIsland] of collectUniqueOwnedIslands(liveRoot)) {
+    for (const [name, liveIsland] of collectUniqueOwnedIslands(liveRoot, true)) {
       const incomingIsland = incomingIslands.get(name);
       if (!incomingIsland) continue;
       applyProps(liveIsland, incomingIsland);
@@ -56,9 +57,14 @@ function collectRefreshableRoots(doc) {
   }
   return roots;
 }
-function collectUniqueOwnedIslands(root) {
+function collectUniqueOwnedIslands(root, excludePreserved = false) {
   const owned = Array.from(root.querySelectorAll(`[${ISLAND_ATTR}]`)).filter(
-    (island) => island.closest(`[${PERSIST_ATTR}]`) === root
+    (island) => {
+      if (island.closest(`[${PERSIST_ATTR}]`) !== root) return false;
+      if (!excludePreserved) return true;
+      const preserveBoundary = island.closest(`[${PROPS_PRESERVE_ATTR}]`);
+      return preserveBoundary === null || !root.contains(preserveBoundary);
+    }
   );
   return indexUniquely(owned, ISLAND_ATTR);
 }

package/eject/header/gen-nav-overflow-script.mjs

@@ -0,0 +1,771 @@
+#!/usr/bin/env node
+// scripts/gen-nav-overflow-script.mjs
+//
+// Generates the git-committed `src/header/nav-overflow-generated-script.ts`
+// build artifact (zudolab/zudo-doc#3534, epic #3533).
+//
+// WHY this exists (the load-bearing reason — recoverable only from the
+// issue): the previous `src/header/nav-overflow-script.ts` built
+// NAV_OVERFLOW_SCRIPT as a template literal evaluated at MODULE-EVALUATION
+// TIME, embedding `pathMatchesNavPath`/`computeActiveNavPath` via
+// `Function.prototype.toString()` on the LIVE imported bindings, plus a third
+// live `CURRENT_PATH_SCRIPT_PRELUDE` interpolation added in 5.6.0
+// (zudolab/zudo-doc#3502). Because the string was recomputed by executing
+// code whose emit shape depends on the CONSUMER's own bundler, two
+// renderings of the same logical script hashed differently (measured: zfb
+// SSR 12392 bytes vs a consumer Vite build 12216 bytes) — so a consumer
+// publishing a CSP inline-script hash could never reconcile it against this
+// package's own build.
+//
+// This script freezes the whole embedding ONCE, at zudo-doc's own package
+// build time, into a plain string literal — so nothing downstream ever
+// reflects on a live function again, and the emitted bytes become
+// consumer-bundler-independent.
+//
+// HOW (package build): reads `src/current-path/index.ts`,
+// `src/header/nav-active.ts`, `src/header/nav-class-tokens.ts`, and
+// `src/transitions/page-events.ts`
+// SOURCE, strips TypeScript types deterministically via esbuild's
+// `transformSync()` (same rationale as gen-search-widget-script.mjs — see
+// that file's header comment for the full `ts.transpileModule()` vs esbuild
+// history, zudolab/zudo-doc#3422 / #3430 — identical here: esbuild is only a
+// package dependency (it is also used by the shipped ejected-header generator),
+// and the effective floor tracks the root `pnpm.overrides` range), executes
+// each transpiled CommonJS module in an isolated sandbox (empty
+// `module`/`exports`; all four source files are import-free), then reads
+// the REAL runtime values off each sandbox's `exports`:
+//   - `exports.CURRENT_PATH_SCRIPT_PRELUDE` — read as a VALUE, never
+//     reconstructed (it is itself a pre-built string, not a function).
+//   - `exports.pathMatchesNavPath.toString()` /
+//     `exports.computeActiveNavPath.toString()` — the exact same
+//     Function.prototype.toString() mechanism the old code used, just run
+//     once here instead of on every module evaluation downstream.
+//     `computeActiveNavPath` closes over `pathMatchesNavPath`, so both are
+//     extracted together (nav-active.ts:70-73 documents the closure).
+//   - `exports.NAV_TOP_ACTIVE` / … — the twelve class-token arrays from
+//     nav-class-tokens.ts, read as real array values. The three splice
+//     formatters (`clsArgs`/`clsLiteral`/`clsAppend`) that used to live in
+//     nav-overflow-script.ts move into this generator (below) since they now
+//     run once at generation time instead of at every module evaluation.
+//   - `exports.AFTER_NAVIGATE_EVENT` — the real event-name string, never
+//     hardcoded here.
+//
+// **Duplicates the gen-search-widget-script.mjs scaffolding on purpose — does
+// NOT extract a shared lib.** Factoring the two generators together would
+// require touching the search-widget generator, whose output is CSP-hash-pinned
+// in two places (its own drift-guard test and any downstream consumer's
+// published hash); that byte-preserving-refactor risk isn't worth coupling to
+// this change. A shared lib is a possible follow-up, not this one
+// (zudolab/zudo-doc#3533 epic body).
+//
+// Composes the full IIFE script string (the template logic moved out of
+// nav-overflow-script.ts) and writes it, write-if-changed, to
+// `src/header/nav-overflow-generated-script.ts` with a GENERATED banner.
+//
+// Like `search-widget-script/generated-script.ts`, this generated file IS
+// tracked in git — a deliberate departure from the gitignored-build-artifact
+// convention used by `routes-src/` / `virtual-modules.d.ts`. Its whole value
+// is a frozen, reviewable snapshot that a plain `git diff` can catch drifting
+// from its four source files. It stays internal like the source files it
+// reads — NOT added to the package `exports` map or `files[]`.
+//
+// EJECTED HEADER MODE (zudolab/zudo-doc#3541): copy-eject-sources.mjs ships
+// this same generator beside the ejected header files. In that location it
+// reads project-owned nav-active.ts / nav-class-tokens.ts locally, while the
+// current-path and page-event inputs come from the installed package's dist/
+// modules. It resolves esbuild from that package's dependency graph, so a
+// consumer runs the understandable, self-contained command printed by eject:
+// `node ./src/components/zudo-doc/header/gen-nav-overflow-script.mjs`.
+//
+// `buildNavOverflowScript()` is exported so both this script's CLI entry
+// point AND the vitest drift-guard test
+// (`src/header/__tests__/nav-overflow-script.test.ts`) can call it: the test
+// re-runs the REAL extraction (fresh transpile of the current source files)
+// and asserts it byte-matches the frozen `NAV_OVERFLOW_SCRIPT` shipped in
+// `nav-overflow-generated-script.ts` — catching the case where one of the
+// four source files changed but the generated file was never regenerated.
+//
+// Runs BEFORE tsup (build / prepare / predev — see package.json) so the
+// first compile always has `nav-overflow-generated-script.ts` on disk to
+// import from `nav-overflow-script.ts`, AND is hooked into the tsup `--watch`
+// `onSuccess` chain (tsup.config.ts) BEFORE `copy-eject-sources.mjs` (running
+// it after would copy the previous literal into `eject/` on the first watch
+// cycle); write-if-changed keeps that loop-free (an unchanged regeneration
+// does not re-trigger tsup's watcher).
+//
+// The `pnpm check:nav-overflow-drift` guard (b4push step + pr-checks CI step,
+// mirroring `check:search-widget-drift`) landed as sub-issue
+// zudolab/zudo-doc#3535 — see scripts/check-nav-overflow-script-drift.sh.
+
+import { readFileSync, writeFileSync, existsSync, realpathSync } from "node:fs";
+import { createRequire } from "node:module";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+/** Find the installed package from an ejected header without assuming npm's
+ * node_modules layout. The symlinked package root is enough: createRequire()
+ * below resolves esbuild from the package's own dependency graph under npm,
+ * pnpm, and yarn installs. */
+function findInstalledPackageRoot(startDirs) {
+  for (const startDir of startDirs) {
+    let dir = resolve(startDir);
+    while (true) {
+      const candidate = resolve(dir, "node_modules/@takazudo/zudo-doc");
+      if (existsSync(resolve(candidate, "package.json"))) return realpathSync(candidate);
+      const parent = dirname(dir);
+      if (parent === dir) break;
+      dir = parent;
+    }
+  }
+  throw new Error(
+    "[gen-nav-overflow-script] could not find node_modules/@takazudo/zudo-doc. " +
+      "Run this command from an installed zudo-doc project after `pnpm install`.",
+  );
+}
+
+/** Resolve the generator's four inputs and output in package-build or ejected mode. */
+export function resolveGenerationContext() {
+  const packageRootCandidate = resolve(__dirname, "..");
+  const packageHeaderDir = resolve(packageRootCandidate, "src/header");
+  const isPackageGenerator = existsSync(resolve(packageHeaderDir, "nav-active.ts"));
+
+  if (isPackageGenerator) {
+    return {
+      kind: "package",
+      packageRoot: packageRootCandidate,
+      currentPathSource: resolve(packageRootCandidate, "src/current-path/index.ts"),
+      navActiveSource: resolve(packageHeaderDir, "nav-active.ts"),
+      navClassTokensSource: resolve(packageHeaderDir, "nav-class-tokens.ts"),
+      pageEventsSource: resolve(packageRootCandidate, "src/transitions/page-events.ts"),
+      outputPath: resolve(packageHeaderDir, "nav-overflow-generated-script.ts"),
+    };
+  }
+
+  // In an ejected payload this script sits beside the two project-owned
+  // customization inputs. The current-path prelude and page-event vocabulary
+  // intentionally stay package-owned and come from the installed compiled
+  // modules, so an ejected project does not fork framework lifecycle inputs.
+  if (
+    !existsSync(resolve(__dirname, "nav-active.ts")) ||
+    !existsSync(resolve(__dirname, "nav-class-tokens.ts"))
+  ) {
+    throw new Error(
+      "[gen-nav-overflow-script] expected nav-active.ts and nav-class-tokens.ts " +
+        `beside the ejected generator at ${__dirname}`,
+    );
+  }
+  const packageRoot = findInstalledPackageRoot([process.cwd(), __dirname]);
+  return {
+    kind: "ejected",
+    packageRoot,
+    currentPathSource: resolve(packageRoot, "dist/current-path/index.js"),
+    navActiveSource: resolve(__dirname, "nav-active.ts"),
+    navClassTokensSource: resolve(__dirname, "nav-class-tokens.ts"),
+    pageEventsSource: resolve(packageRoot, "dist/transitions/page-events.js"),
+    outputPath: resolve(__dirname, "nav-overflow-generated-script.ts"),
+  };
+}
+
+function loadTransformSync(packageRoot) {
+  try {
+    const requireFromPackage = createRequire(resolve(packageRoot, "package.json"));
+    return requireFromPackage("esbuild").transformSync;
+  } catch (err) {
+    throw new Error(
+      "[gen-nav-overflow-script] could not load the esbuild dependency shipped by " +
+        `@takazudo/zudo-doc: ${err.message}`,
+    );
+  }
+}
+
+// Explicit, stable esbuild options — identical rationale to
+// gen-search-widget-script.mjs's TRANSFORM_OPTIONS (see that file): `format:
+// "cjs"` so each source's `export`s become a CommonJS `module.exports` object
+// we can read off the sandboxed `module` param, `target: "es2020"` so
+// `var`-style function bodies pass through unchanged (no downlevel helpers),
+// `platform: "neutral"` so esbuild injects no Node/browser global shims (all
+// four source files are import-free — nothing to shim). Every minify knob is
+// explicitly false: the acceptance criterion is a human-readable, byte-stable
+// emit across runs, never a minified one.
+const TRANSFORM_OPTIONS = {
+  loader: "ts",
+  format: "cjs",
+  target: "es2020",
+  platform: "neutral",
+  sourcemap: false,
+  minify: false,
+  minifyWhitespace: false,
+  minifyIdentifiers: false,
+  minifySyntax: false,
+};
+
+/** A source string carrying no CommonJS/ESM module scaffolding that could
+ *  survive the transpile into the embedded browser script. Matches only the
+ *  syntactic shapes (`require(...)`, `import(...)`, `module.exports`,
+ *  `exports.x`), NOT the bare words — the extracted function text includes
+ *  body comments, and a comment merely mentioning "import"/"export" must not
+ *  fail the build. */
+function assertNoModuleScaffolding(label, text) {
+  if (/\brequire\s*\(|\bimport\s*\(|\bmodule\.exports\b|\bexports\s*\./.test(text)) {
+    throw new Error(
+      `[gen-nav-overflow-script] ${label} leaked module scaffolding into the embedded script:\n${text}`,
+    );
+  }
+}
+
+/** Transpile a TS source file to CommonJS JS, type-stripped, via esbuild's `transformSync`. */
+function transpile(sourcePath, transformSync) {
+  const source = readFileSync(sourcePath, "utf8");
+  let result;
+  try {
+    result = transformSync(source, {
+      ...TRANSFORM_OPTIONS,
+      loader: sourcePath.endsWith(".ts") ? "ts" : "js",
+    });
+  } catch (err) {
+    const messages = (err.errors ?? []).map((e) => e.text).join("; ") || err.message;
+    throw new Error(
+      `[gen-nav-overflow-script] failed to transpile ${sourcePath}: ${messages}`,
+    );
+  }
+  // Warnings are fatal on purpose: this file's output is embedded verbatim
+  // into a shipped browser script, so anything esbuild flags must be resolved
+  // in the source rather than silently carried through.
+  if (result.warnings.length > 0) {
+    const messages = result.warnings.map((w) => w.text).join("; ");
+    throw new Error(
+      `[gen-nav-overflow-script] esbuild reported warning(s) while transpiling ${sourcePath} (treated as fatal): ${messages}`,
+    );
+  }
+  return result.code;
+}
+
+/** Execute transpiled CommonJS source in an isolated sandbox and return its exports. */
+function executeCommonJs(code, label) {
+  const moduleObj = { exports: {} };
+  const fn = new Function("module", "exports", code);
+  try {
+    fn(moduleObj, moduleObj.exports);
+  } catch (err) {
+    throw new Error(
+      `[gen-nav-overflow-script] failed to execute transpiled ${label}: ${err.message}`,
+    );
+  }
+  return moduleObj.exports;
+}
+
+/** Extract the real CURRENT_PATH_SCRIPT_PRELUDE value from current-path/index.ts. */
+function extractCurrentPathPrelude(context, transformSync) {
+  const outputText = transpile(context.currentPathSource, transformSync);
+  const exportsObj = executeCommonJs(outputText, "current-path/index.ts");
+  const value = exportsObj.CURRENT_PATH_SCRIPT_PRELUDE;
+  if (typeof value !== "string" || !value) {
+    throw new Error(
+      "[gen-nav-overflow-script] CURRENT_PATH_SCRIPT_PRELUDE missing or not a string in current-path/index.ts",
+    );
+  }
+  assertNoModuleScaffolding("CURRENT_PATH_SCRIPT_PRELUDE", value);
+  return value;
+}
+
+/** Extract the real, unit-tested pathMatchesNavPath/computeActiveNavPath source text from nav-active.ts. */
+function extractNavActiveFunctions(context, transformSync) {
+  const outputText = transpile(context.navActiveSource, transformSync);
+  const exportsObj = executeCommonJs(outputText, "nav-active.ts");
+  const { pathMatchesNavPath, computeActiveNavPath } = exportsObj;
+  if (typeof pathMatchesNavPath !== "function" || typeof computeActiveNavPath !== "function") {
+    throw new Error(
+      "[gen-nav-overflow-script] nav-active.ts did not export pathMatchesNavPath/computeActiveNavPath functions",
+    );
+  }
+  const pathMatchesNavPathSrc = pathMatchesNavPath.toString();
+  const computeActiveNavPathSrc = computeActiveNavPath.toString();
+  assertNoModuleScaffolding("pathMatchesNavPath", pathMatchesNavPathSrc);
+  assertNoModuleScaffolding("computeActiveNavPath", computeActiveNavPathSrc);
+  return { pathMatchesNavPathSrc, computeActiveNavPathSrc };
+}
+
+// The twelve class-token arrays nav-overflow-script.ts used to import
+// directly from nav-class-tokens.ts (see that module's header comment for
+// the SSR ↔ runtime lockstep rationale, zudolab/zudo-doc#3023).
+const NAV_CLASS_TOKEN_NAMES = [
+  "NAV_TOP_ACTIVE",
+  "NAV_TOP_INACTIVE",
+  "NAV_CHEVRON_ACTIVE",
+  "NAV_CHEVRON_INACTIVE",
+  "NAV_CHILD_ACTIVE",
+  "NAV_CHILD_INACTIVE",
+  "NAV_MENU_PARENT",
+  "NAV_MENU_PARENT_ACTIVE_SUFFIX",
+  "NAV_MENU_PLAIN",
+  "NAV_MENU_PLAIN_ACTIVE_SUFFIX",
+  "NAV_MENU_CHILD_ACTIVE",
+  "NAV_MENU_CHILD_INACTIVE",
+];
+
+/** Extract the twelve real class-token arrays from nav-class-tokens.ts. */
+function extractNavClassTokens(context, transformSync) {
+  const outputText = transpile(context.navClassTokensSource, transformSync);
+  const exportsObj = executeCommonJs(outputText, "nav-class-tokens.ts");
+  const tokens = {};
+  for (const name of NAV_CLASS_TOKEN_NAMES) {
+    const value = exportsObj[name];
+    if (!Array.isArray(value) || !value.every((token) => typeof token === "string")) {
+      throw new Error(
+        `[gen-nav-overflow-script] nav-class-tokens.ts did not export ${name} as a string array`,
+      );
+    }
+    tokens[name] = value;
+  }
+  // Exhaustiveness: a token array exported by nav-class-tokens.ts (and thus
+  // available to header.tsx's SSR markup) but missing from
+  // NAV_CLASS_TOKEN_NAMES would be silently absent from the frozen script —
+  // the exact SSR ↔ runtime class drift the tokens module exists to prevent,
+  // and one no drift guard can see (the generated bytes legitimately don't
+  // change). Fail loudly instead.
+  const unconsumed = Object.keys(exportsObj).filter(
+    (name) => name.startsWith("NAV_") && !NAV_CLASS_TOKEN_NAMES.includes(name),
+  );
+  if (unconsumed.length > 0) {
+    throw new Error(
+      `[gen-nav-overflow-script] nav-class-tokens.ts exports token array(s) not embedded in the script: ${unconsumed.join(", ")}. Add them to NAV_CLASS_TOKEN_NAMES and splice them into the template in buildNavOverflowScript().`,
+    );
+  }
+  return tokens;
+}
+
+/** Extract the real AFTER_NAVIGATE_EVENT value from transitions/page-events.ts — never hardcoded. */
+function extractAfterNavigateEvent(context, transformSync) {
+  const outputText = transpile(context.pageEventsSource, transformSync);
+  const exportsObj = executeCommonJs(outputText, "page-events.ts");
+  const value = exportsObj.AFTER_NAVIGATE_EVENT;
+  if (typeof value !== "string" || !value) {
+    throw new Error(
+      "[gen-nav-overflow-script] AFTER_NAVIGATE_EVENT missing or not a string in transitions/page-events.ts",
+    );
+  }
+  return value;
+}
+
+// The class lists spliced into the script below are the SSR ↔ runtime
+// lockstep: they must match the strings header.tsx renders (nav-class-tokens.ts
+// header comment, zudolab/zudo-doc#3023). Moved here from nav-overflow-script.ts
+// (zudolab/zudo-doc#3534) — they now run once at generation time rather than on
+// every module evaluation.
+
+// -> `"bg-fg", "text-bg"` — argument list for a classList.add/remove(...) call.
+const clsArgs = (tokens) => tokens.map((token) => JSON.stringify(token)).join(", ");
+
+// -> `"bg-fg text-bg"` — a single class-string literal for `className = ...`.
+const clsLiteral = (tokens) => JSON.stringify(tokens.join(" "));
+
+// -> `" font-bold text-accent"` — leading-space append for `className += ...`.
+const clsAppend = (tokens) => JSON.stringify(" " + tokens.join(" "));
+
+/**
+ * Composes the full desktop-nav overflow controller IIFE script,
+ * string-for-string identical in structure to the old template-literal build
+ * in nav-overflow-script.ts, but with the four previously-live interpolations
+ * replaced by frozen values extracted above.
+ */
+export function buildNavOverflowScript(context = resolveGenerationContext()) {
+  const transformSync = loadTransformSync(context.packageRoot);
+  const currentPathPrelude = extractCurrentPathPrelude(context, transformSync);
+  const { pathMatchesNavPathSrc, computeActiveNavPathSrc } = extractNavActiveFunctions(
+    context,
+    transformSync,
+  );
+  const {
+    NAV_TOP_ACTIVE,
+    NAV_TOP_INACTIVE,
+    NAV_CHEVRON_ACTIVE,
+    NAV_CHEVRON_INACTIVE,
+    NAV_CHILD_ACTIVE,
+    NAV_CHILD_INACTIVE,
+    NAV_MENU_PARENT,
+    NAV_MENU_PARENT_ACTIVE_SUFFIX,
+    NAV_MENU_PLAIN,
+    NAV_MENU_PLAIN_ACTIVE_SUFFIX,
+    NAV_MENU_CHILD_ACTIVE,
+    NAV_MENU_CHILD_INACTIVE,
+  } = extractNavClassTokens(context, transformSync);
+  const afterNavigateEventLiteral = JSON.stringify(
+    extractAfterNavigateEvent(context, transformSync),
+  );
+
+  return /* javascript */ `(function () {
+  var cleanupNavOverflow = null;
+
+  function trimSlashes(p) {
+    while (p.length > 1 && p.charAt(p.length - 1) === "/") p = p.slice(0, -1);
+    return p || "/";
+  }
+
+  function navPathname(a) {
+    try { return trimSlashes(new URL(a.href, location.href).pathname); }
+    catch (e) { return ""; }
+  }
+
+  // Explicit current-route override, embedded from current-path/index.ts so
+  // this script cannot drift from the three other read sites
+  // (zudolab/zudo-doc#3398, #3408).
+  ${currentPathPrelude}
+
+  // Shared matching core (zudolab/zudo-doc#3398): embedded verbatim from
+  // nav-active.ts so this script's longest-match walk cannot drift from the
+  // SSR header's own computeActiveNavPath call (header.tsx). computeActiveNavPath
+  // closes over pathMatchesNavPath, so both are embedded together.
+  var pathMatchesNavPath = ${pathMatchesNavPathSrc};
+  var computeActiveNavPath = ${computeActiveNavPathSrc};
+
+  // Recompute which header nav item is "active" from the CURRENT URL and
+  // repaint the highlight. SSR sets the active item on first paint, but the
+  // header is persisted across same-locale client-router swaps
+  // (data-zfb-transition-persist), so without this the highlight would stay
+  // frozen on the page where the header was first rendered. Mirrors the
+  // sidebar island's client-side approach (match the current path against
+  // each entry's href) and the SSR longest-match + dropdown-parent rules.
+  // URL-based: hrefs and the current path both carry the base + locale
+  // prefix, so they compare directly without stripping.
+  function applyActiveNav() {
+    var nav = document.querySelector("[data-header-nav]");
+    if (!nav) return;
+    var topItems = Array.from(nav.querySelectorAll(":scope > [data-nav-item]"));
+    if (topItems.length === 0) return;
+
+    var cur = trimSlashes(readCurrentPath(CURRENT_PATH_DATASET_KEY));
+
+    // Build NavItemLike-shaped entries from the live DOM so the shared
+    // computeActiveNavPath can do the deepest-match walk — the same call
+    // shape the SSR header uses (matches computeActiveNavPath). A dropdown
+    // missing its own top-level anchor is skipped entirely (path "" would
+    // otherwise match every current path — pathMatchesNavPath treats "" as
+    // the root "/"), mirroring the parentLink guard used below for the same
+    // malformed-markup case.
+    var navItems = [];
+    topItems.forEach(function (it) {
+      var isDropdown = it.hasAttribute("data-nav-item-dropdown");
+      var topA = isDropdown ? it.querySelector(":scope > a") : it;
+      if (!topA) return;
+      var children = [];
+      if (isDropdown) {
+        it.querySelectorAll(":scope > div a").forEach(function (c) {
+          children.push({ path: navPathname(c) });
+        });
+      }
+      navItems.push({ path: navPathname(topA), children: children });
+    });
+
+    var activePath = computeActiveNavPath(navItems, cur) || "";
+
+    function setTopActive(a, active) {
+      if (!a) return;
+      if (active) {
+        a.classList.add(${clsArgs(NAV_TOP_ACTIVE)});
+        a.classList.remove(${clsArgs(NAV_TOP_INACTIVE)});
+        a.setAttribute("aria-current", "page");
+      } else {
+        a.classList.remove(${clsArgs(NAV_TOP_ACTIVE)});
+        a.classList.add(${clsArgs(NAV_TOP_INACTIVE)});
+        a.removeAttribute("aria-current");
+      }
+    }
+
+    topItems.forEach(function (it) {
+      var isDropdown = it.hasAttribute("data-nav-item-dropdown");
+      var topA = isDropdown ? it.querySelector(":scope > a") : it;
+      var topActive = false;
+
+      if (isDropdown) {
+        var parentMatch = !!topA && navPathname(topA) === activePath && activePath !== "";
+        var anyChild = false;
+        it.querySelectorAll(":scope > div a").forEach(function (c) {
+          var childActive = navPathname(c) === activePath && activePath !== "";
+          if (childActive) {
+            anyChild = true;
+            c.setAttribute("data-active", "");
+            c.classList.add(${clsArgs(NAV_CHILD_ACTIVE)});
+            c.classList.remove(${clsArgs(NAV_CHILD_INACTIVE)});
+          } else {
+            c.removeAttribute("data-active");
+            c.classList.remove(${clsArgs(NAV_CHILD_ACTIVE)});
+            c.classList.add(${clsArgs(NAV_CHILD_INACTIVE)});
+          }
+        });
+        topActive = parentMatch || anyChild;
+        var svg = topA ? topA.querySelector("svg") : null;
+        if (svg) {
+          if (topActive) { svg.classList.add(${clsArgs(NAV_CHEVRON_ACTIVE)}); svg.classList.remove(${clsArgs(NAV_CHEVRON_INACTIVE)}); }
+          else { svg.classList.add(${clsArgs(NAV_CHEVRON_INACTIVE)}); svg.classList.remove(${clsArgs(NAV_CHEVRON_ACTIVE)}); }
+        }
+      } else {
+        topActive = activePath !== "" && navPathname(topA) === activePath;
+      }
+
+      setTopActive(topA, topActive);
+    });
+  }
+
+  function initNavOverflow() {
+    if (cleanupNavOverflow) cleanupNavOverflow();
+
+    // Repaint the active highlight for the current URL before measuring /
+    // cloning, so the overflow "···" menu mirrors the correct active state.
+    applyActiveNav();
+
+    var nav = document.querySelector("[data-header-nav]");
+    var moreContainer = document.querySelector("[data-nav-more]");
+    var moreMenu = document.querySelector("[data-nav-more-menu]");
+    var moreToggle = document.querySelector("[data-nav-more-toggle]");
+    if (!nav || !moreContainer || !moreMenu || !moreToggle) return;
+
+    var items = Array.from(nav.querySelectorAll(":scope > [data-nav-item]"));
+    if (items.length === 0) return;
+
+    var controller = new AbortController();
+
+    function update() {
+      items.forEach(function (el) { el.style.display = ""; });
+      moreContainer.style.display = "";
+      moreMenu.innerHTML = "";
+      moreMenu.classList.add("hidden");
+      moreToggle.setAttribute("aria-expanded", "false");
+
+      var itemWidths = items.map(function (el) { return el.offsetWidth; });
+      var moreWidth = moreContainer.offsetWidth;
+      var navGap = parseFloat(getComputedStyle(nav).columnGap) || 0;
+      var available = nav.clientWidth;
+
+      if (available <= 0) {
+        moreContainer.style.display = "none";
+        return;
+      }
+
+      var total = 0;
+      for (var i = 0; i < itemWidths.length; i++) {
+        total += itemWidths[i] + (i > 0 ? navGap : 0);
+      }
+
+      if (total <= available) {
+        moreContainer.style.display = "none";
+        return;
+      }
+
+      var used = 0;
+      var cutoffIndex = 0;
+
+      for (var i2 = 0; i2 < items.length; i2++) {
+        var w = itemWidths[i2] + (i2 > 0 ? navGap : 0);
+        if (used + w > available - moreWidth - navGap) break;
+        used += w;
+        cutoffIndex = i2 + 1;
+      }
+
+      for (var i3 = cutoffIndex; i3 < items.length; i3++) {
+        items[i3].style.display = "none";
+      }
+
+      for (var i4 = cutoffIndex; i4 < items.length; i4++) {
+        var el = items[i4];
+        var isDropdown = el.hasAttribute("data-nav-item-dropdown");
+
+        if (isDropdown) {
+          var parentLink = el.querySelector(":scope > a");
+          var childLinks = el.querySelectorAll(":scope > div a");
+          if (parentLink) {
+            var li = document.createElement("li");
+            var a = document.createElement("a");
+            a.href = parentLink.href;
+            var parentText = parentLink.textContent ? parentLink.textContent.trim().replace(/\\s+/g, " ") : "";
+            a.textContent = parentText;
+            a.className = ${clsLiteral(NAV_MENU_PARENT)};
+            if (parentLink.getAttribute("aria-current") === "page") {
+              a.className += ${clsAppend(NAV_MENU_PARENT_ACTIVE_SUFFIX)};
+            }
+            li.appendChild(a);
+            moreMenu.appendChild(li);
+          }
+          childLinks.forEach(function (child) {
+            var li = document.createElement("li");
+            var a = document.createElement("a");
+            a.href = child.href;
+            a.textContent = child.textContent ? child.textContent.trim() : "";
+            var isChildActive = child.hasAttribute("data-active");
+            a.className = isChildActive
+              ? ${clsLiteral(NAV_MENU_CHILD_ACTIVE)}
+              : ${clsLiteral(NAV_MENU_CHILD_INACTIVE)};
+            li.appendChild(a);
+            moreMenu.appendChild(li);
+          });
+        } else {
+          var anchor = el;
+          var li2 = document.createElement("li");
+          var a2 = document.createElement("a");
+          a2.href = anchor.href;
+          a2.textContent = anchor.textContent ? anchor.textContent.trim() : "";
+          a2.className = ${clsLiteral(NAV_MENU_PLAIN)};
+          if (anchor.getAttribute("aria-current") === "page") {
+            a2.className += ${clsAppend(NAV_MENU_PLAIN_ACTIVE_SUFFIX)};
+          }
+          li2.appendChild(a2);
+          moreMenu.appendChild(li2);
+        }
+      }
+    }
+
+    moreToggle.addEventListener("click", function () {
+      var isOpen = !moreMenu.classList.contains("hidden");
+      moreMenu.classList.toggle("hidden", isOpen);
+      moreToggle.setAttribute("aria-expanded", String(!isOpen));
+    }, { signal: controller.signal });
+
+    document.addEventListener("click", function (e) {
+      if (!moreContainer.contains(e.target)) {
+        moreMenu.classList.add("hidden");
+        moreToggle.setAttribute("aria-expanded", "false");
+      }
+    }, { signal: controller.signal });
+
+    document.addEventListener("keydown", function (e) {
+      if (e.key !== "Escape") return;
+      if (!moreMenu.classList.contains("hidden")) {
+        moreMenu.classList.add("hidden");
+        moreToggle.setAttribute("aria-expanded", "false");
+        moreToggle.focus();
+        return;
+      }
+      var active = document.activeElement;
+      var dropdown = active && active.closest ? active.closest("[data-nav-item-dropdown]") : null;
+      if (dropdown && active && active.blur) {
+        active.blur();
+      }
+    }, { signal: controller.signal });
+
+    var dropdowns = nav.querySelectorAll("[data-nav-item-dropdown]");
+    dropdowns.forEach(function (dd) {
+      var trigger = dd.querySelector(":scope > a");
+      if (!trigger) return;
+      function setExpanded(v) {
+        trigger.setAttribute("aria-expanded", String(v));
+      }
+      dd.addEventListener("mouseenter", function () { setExpanded(true); }, { signal: controller.signal });
+      dd.addEventListener("mouseleave", function () { setExpanded(false); }, { signal: controller.signal });
+      dd.addEventListener("focusin", function () { setExpanded(true); }, { signal: controller.signal });
+      dd.addEventListener("focusout", function (e) {
+        if (!dd.contains(e.relatedTarget)) {
+          setExpanded(false);
+        }
+      }, { signal: controller.signal });
+    });
+
+    var ro = new ResizeObserver(update);
+    ro.observe(nav);
+    controller.signal.addEventListener("abort", function () { ro.disconnect(); });
+
+    document.fonts.ready.then(update);
+
+    update();
+
+    cleanupNavOverflow = function () { controller.abort(); };
+  }
+
+  initNavOverflow();
+  document.addEventListener(${afterNavigateEventLiteral}, initNavOverflow);
+})();`;
+}
+
+// ── CLI entry: write-if-changed ─────────────────────────────────────────────
+// Realpath both sides: Node resolves the ESM entry's `import.meta.url` to its
+// REAL path (default --preserve-symlinks=false) while `process.argv[1]` keeps
+// whatever spelling the invoker typed, so under a symlinked checkout a plain
+// `resolve()` comparison silently mismatches and the CLI becomes an exit-0
+// no-op — leaving nav-overflow-generated-script.ts missing (hard tsup failure
+// later) or, worse, stale.
+const isMainModule = (() => {
+  if (!process.argv[1]) return false;
+  try {
+    // Realpath BOTH sides: under `--preserve-symlinks-main` (sometimes set
+    // via NODE_OPTIONS in pnpm/monorepo setups) `import.meta.url` keeps the
+    // symlinked spelling, so a one-sided realpath re-creates the silent
+    // exit-0 no-op this block exists to prevent.
+    return (
+      realpathSync(resolve(process.argv[1])) === realpathSync(fileURLToPath(import.meta.url))
+    );
+  } catch {
+    return false;
+  }
+})();
+
+function buildGeneratedModule(script, context) {
+  const banner = context.kind === "package"
+    ? `// GENERATED FILE — do not edit by hand.
+// Produced by scripts/gen-nav-overflow-script.mjs (zudolab/zudo-doc#3534,
+// epic #3533) from src/current-path/index.ts (CURRENT_PATH_SCRIPT_PRELUDE),
+// src/header/nav-active.ts (pathMatchesNavPath/computeActiveNavPath,
+// type-stripped), src/header/nav-class-tokens.ts (the twelve class-token
+// arrays), and src/transitions/page-events.ts (AFTER_NAVIGATE_EVENT).
+// Re-run \`pnpm --filter @takazudo/zudo-doc gen:nav-overflow-script\` (or any
+// build/dev entry point, which already runs it) to regenerate after editing
+// any of those source files.
+//
+// This file is committed to git (mirrors search-widget-script/generated-script.ts,
+// zudolab/zudo-doc#3421 / #3431) — a deliberate departure from this repo's
+// usual gitignored-generated-file convention (routes-src/, virtual-modules.d.ts).
+// Regenerate AND commit the result after editing any of the four source files.
+`
+    : `// GENERATED FILE — do not edit by hand.
+// Produced by the ejected header's gen-nav-overflow-script.mjs from the local
+// nav-active.ts and nav-class-tokens.ts customization inputs plus the installed
+// @takazudo/zudo-doc current-path and page-event inputs.
+// Re-run \`node ./src/components/zudo-doc/header/gen-nav-overflow-script.mjs\`
+// after editing either local input, then commit this file with your customization.
+// The script value remains frozen so its CSP bytes do not depend on the
+// consumer bundler.
+`;
+
+  return `${banner}
+/** Returns the frozen desktop-nav overflow controller IIFE script. NOTE: the
+ * vitest drift guard imports buildNavOverflowScript from
+ * scripts/gen-nav-overflow-script.mjs (a fresh re-generation) — NEVER from
+ * this module: comparing NAV_OVERFLOW_SCRIPT below against this same file's
+ * function would be a vacuous self-comparison. */
+export function buildNavOverflowScript(): string {
+  return ${JSON.stringify(script)};
+}
+
+/** Client-side script string for the desktop header nav overflow controller.
+ * See the module header of this generator for the embedding contract; see
+ * current-path/index.ts / header/nav-active.ts / header/nav-class-tokens.ts /
+ * transitions/page-events.ts for the frozen sources. */
+export const NAV_OVERFLOW_SCRIPT: string = buildNavOverflowScript();
+`;
+}
+
+/** Regenerate the committed package literal or the local ejected literal. */
+export function generateNavOverflowScript(context = resolveGenerationContext()) {
+  const script = buildNavOverflowScript(context);
+  const output = buildGeneratedModule(script, context);
+
+  const existing = existsSync(context.outputPath)
+    ? readFileSync(context.outputPath, "utf8")
+    : null;
+
+  if (existing === output) {
+    process.stdout.write(
+      `[gen-nav-overflow-script] ${context.outputPath} unchanged, skip write\n`,
+    );
+  } else {
+    writeFileSync(context.outputPath, output, "utf8");
+    process.stdout.write(
+      `[gen-nav-overflow-script] ${context.outputPath} written\n`,
+    );
+  }
+
+  return { output, outputPath: context.outputPath, changed: existing !== output };
+}
+
+if (isMainModule) {
+  generateNavOverflowScript();
+}

package/eject/header/header.tsx

@@ -319,6 +319,8 @@ export function Header(props: HeaderProps): JSX.Element {
       //     island module): on BEFORE_SWAP_EVENT it copies the incoming
       //     document's data-props onto the live nested islands, and
       //     mountNewIslands re-reads the attribute at mount time (#3530)
+      //     Host islands can opt out with data-zd-props-preserve on the live
+      //     island or an ancestor inside this persisted root (#3555).
       //   - Header nav + aria-current: NAV_OVERFLOW_SCRIPT re-runs on
       //     AFTER_NAVIGATE_EVENT (frozen by zudolab/zudo-doc#3534 — the
       //     `addEventListener(${afterNavigateEventLiteral}, initNavOverflow)`

package/eject/header/nav-overflow-script.ts

@@ -46,12 +46,15 @@
 // `src/header/__tests__/nav-overflow-script.test.ts` proves the committed
 // literal still matches a fresh regeneration.
 //
-// EJECTED COPIES (`zudo-doc eject header`): the generator is NOT shipped, so
-// in an ejected tree the re-exported literal is permanently frozen — editing
-// the ejected `./nav-class-tokens.ts` or `./nav-active.ts` changes the SSR
-// markup (header.tsx imports them live) but NOT this client script, breaking
-// the SSR ↔ runtime class lockstep those files exist to guarantee. To change
-// the client script in an ejected copy, edit the literal in
-// `./nav-overflow-generated-script.ts` directly (it is plain JS in a string)
-// and keep it in step with your token edits by hand.
+// EJECTED COPIES (`zudo-doc eject header`): the payload ships
+// `./gen-nav-overflow-script.mjs`. After editing the local `./nav-active.ts`
+// or `./nav-class-tokens.ts`, run:
+//
+//   node ./src/components/zudo-doc/header/gen-nav-overflow-script.mjs
+//
+// The generator reads those two local customization inputs and the installed
+// package's current-path/page-event inputs, then rewrites the local
+// `./nav-overflow-generated-script.ts`. Commit that generated file with the
+// edits. Do not edit its string literal by hand: regeneration preserves the
+// frozen, consumer-bundler-independent bytes required for stable CSP hashes.
 export { NAV_OVERFLOW_SCRIPT } from "./nav-overflow-generated-script.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zudo-doc",
-  "version": "5.7.0",
+  "version": "5.8.0",
   "type": "module",
   "description": "zudo-doc framework primitives layer that sits on top of zfb's engine — sidebar, theme, TOC, breadcrumb, layouts, head injection, View Transitions, SSR-skip wrappers (per ADR-003).",
   "license": "MIT",
@@ -617,7 +617,7 @@
     "CHANGELOG.md"
   ],
   "peerDependencies": {
-    "@takazudo/zdtp": "^0.4.11",
+    "@takazudo/zdtp": "^0.4.12",
     "@takazudo/zfb": "^2.7.1",
     "@takazudo/zfb-md-wasm": "^2.7.1",
     "@takazudo/zfb-runtime": "^2.7.1",
@@ -646,6 +646,7 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^8.4.2",
+    "esbuild": ">=0.28.1",
     "fs-extra": "^11.3.0",
     "gray-matter": "^4.0.3",
     "minimist": "^1.2.8",
@@ -663,7 +664,6 @@
     "@types/node": "^25.3.5",
     "@types/pluralize": "^0.0.33",
     "@types/string-similarity": "^4.0.2",
-    "esbuild": ">=0.28.1",
     "happy-dom": "^20.10.6",
     "npm-run-all2": "^7.0.2",
     "preact": "^10.29.1",
@@ -672,7 +672,7 @@
     "typescript": "^5.0.0",
     "vitest": "^4.1.0",
     "zod": "^4.3.6",
-    "@takazudo/zudo-doc-history-server": "5.7.0"
+    "@takazudo/zudo-doc-history-server": "5.8.0"
   },
   "scripts": {
     "gen:search-widget-script": "node scripts/gen-search-widget-script.mjs",