@takazudo/zudo-doc 7.1.0 → 8.0.0

package/CHANGELOG.md

@@ -8,6 +8,28 @@ The format is based on Keep a Changelog, and release notes are generated from th
 
 No unreleased changes.
 
+## [8.0.0] - 2026-10-24
+
+### Breaking Changes
+
+- Remove the `@takazudo/zudo-doc/plugins/optional-peers` export. Remove any explicit registration of that workaround plugin; ZFB now handles rejection-handled optional imports directly.
+- Require ZFB 5.0.1 or later in the 5.x line. Upgrade the ZFB engine, runtime, and Markdown WASM packages together. When using document history, upgrade `@takazudo/zudo-doc-history-server` to 8.x as well. Node.js 24 remains the minimum.
+
+### Features
+
+- Add `siteTreeNavInitiallyCollapsed` to start exact nested category slugs collapsed in home-page and MDX site trees while preserving links and toggles. (fb4a6e3cf)
+
+### Bug Fixes
+
+- Adopt ZFB 5.0.1 to fix lazy island chunks requesting an unpublished `islands.js` asset.
+- Restore prose spacing inside tab panels. (5c2f52b92)
+- Clarify adjacent heading spacing and heading hierarchy across theme packs. (2969bd803)
+
+### Other Changes
+
+- Accept Node.js 24 or later without an upper version cap. Node 24 LTS remains the CI-verified line. (d5336a24b)
+- Update the MCP SDK to 1.32.2.
+
 ## [7.1.0] - 2026-10-23
 
 ### Bug Fixes

package/README.md

@@ -109,7 +109,7 @@ If your project renders **semi-trusted or user-submitted** HTML in a preview, ov
 
 **6.0.0** is the coordinated major release of `@takazudo/zudo-doc`,
 `@takazudo/zudo-doc-history-server` and `create-zudo-doc`. The current workspace
-targets the published **zfb 4.7.0** family (peer floor **^4.7.0**).
+targets the published **zfb 5.0.1** family (peer floor **^5.0.1**).
 [Upstream #4097](https://github.com/Takazudo/zudo-front-builder/issues/4097) is
 resolved; its strict published 4.3.1 consumer control passed 3/3 with no skips or
 retries in the [source-bound verification](../../docs/findings/zfb-4.3.1/verification.md).

package/dist/chrome/derive.js

@@ -322,6 +322,7 @@ function deriveMdxComponents(ctx) {
     getCategoryOrder: ctx.getCategoryOrder,
     versionedDocsUrl: ctx.versionedDocsUrl,
     categoryIgnore: ctx.settings.siteTreeNavIgnore,
+    initiallyCollapsedCategorySlugs: ctx.settings.siteTreeNavInitiallyCollapsed,
     dateFormat: ctx.settings.dateFormat
   });
   const NoteTrayIndexWrapper = createNoteTrayIndexWrapper({

package/dist/compiled.css

@@ -630,11 +630,15 @@ body {
 }
 
 @layer zd-flow {
-  .zd-content > :where(* + *) {
+  .zd-content > :where(* + *), .zd-content :where(.tab-panel) > :where(* + *) {
     margin-top: var(--flow-space, var(--spacing-vsp-md));
   }
 }
 
+.zd-content :where(.tab-panel) {
+  --flow-space: var(--spacing-vsp-md);
+}
+
 .zd-content :where(h2) {
   --flow-space: var(--spacing-vsp-2xl);
 }
@@ -658,11 +662,15 @@ body {
   --flow-space: var(--spacing-vsp-xs);
 }
 
+.zd-content :where(h2) + :where(h3) {
+  --flow-space: var(--spacing-vsp-md);
+}
+
 .zd-content :where(h2, h3, h4, h5, h6) + :where(:not(h2, h3, h4, h5, h6)) {
   --flow-space: var(--spacing-vsp-xs);
 }
 
-.zd-content > :first-child {
+.zd-content > :first-child, .zd-content :where(.tab-panel) > :first-child {
   margin-top: 0;
 }
 

package/dist/config.d.ts

@@ -158,6 +158,15 @@ export interface ZudoDocConfig {
      * @default []
      */
     siteTreeNavIgnore?: string[];
+    /**
+     * Exact full `node.slug` values of categories that start collapsed at any
+     * depth in package-owned home pages and `<SiteTreeNav />` / `<SiteTreeNavDemo />`
+     * MDX tags. Use slugs such as `"zudo-wind/utilities"`, without `/docs`, a
+     * locale prefix, or leading/trailing slashes. Visitors can toggle them normally.
+     * Does not affect sidebar expansion.
+     * @default []
+     */
+    siteTreeNavInitiallyCollapsed?: string[];
     /**
      * Top-level category slugs moved OUT of the package-owned home-page category
      * grid on `/` and locale homes and rendered instead as one row of small

package/dist/content.css

@@ -74,11 +74,17 @@
  * layer-independent, so the per-heading flow gaps are unaffected.
  * See zudolab/zudo-doc#2082 / #2109. */
 @layer zd-flow {
-  .zd-content > :where(* + *) {
+  .zd-content > :where(* + *),
+  .zd-content :where(.tab-panel) > :where(* + *) {
     margin-top: var(--flow-space, var(--spacing-vsp-md));
   }
 }
 
+/* Tabs can inherit a heading-following gap; start a new prose flow inside. */
+.zd-content :where(.tab-panel) {
+  --flow-space: var(--spacing-vsp-md);
+}
+
 /* ── Headings ── */
 
 /* Heading flow-space (structural — consumed by flow spacing system) */
@@ -107,13 +113,18 @@
   --flow-space: var(--spacing-vsp-xs);
 }
 
+.zd-content :where(h2) + :where(h3) {
+  --flow-space: var(--spacing-vsp-md);
+}
+
 /* Content immediately after a heading: tight gap (replaces heading margin-bottom) */
 .zd-content :where(h2, h3, h4, h5, h6) + :where(:not(h2, h3, h4, h5, h6)) {
   --flow-space: var(--spacing-vsp-xs);
 }
 
 /* First child never needs top margin */
-.zd-content > :first-child {
+.zd-content > :first-child,
+.zd-content :where(.tab-panel) > :first-child {
   margin-top: 0;
 }
 

package/dist/home-page/index.d.ts

@@ -43,7 +43,7 @@ export interface HomePageViewProps {
     tree: DocNavNode[];
     /** Ordered category prefixes, passed through to `SiteTreeNav`. */
     categoryOrder: string[];
-    /** Root-category slugs that should start collapsed in `SiteTreeNav`. */
+    /** Exact full category slugs at any depth that should start collapsed in `SiteTreeNav`. Overrides `settings.siteTreeNavInitiallyCollapsed`, including when `[]`. */
     initiallyCollapsedCategorySlugs?: string[];
     /** Unique tag count for the current locale — gates the "Tags" section
      *  together with `settings.docTags`. Part of the documented public

package/dist/home-page/index.js

@@ -87,6 +87,7 @@ function createHomePageView(ctx) {
     wide
   }) {
     const prefix = locale === defaultLocale ? "" : `/${locale}`;
+    const effectiveInitiallyCollapsedCategorySlugs = initiallyCollapsedCategorySlugs ?? settings.siteTreeNavInitiallyCollapsed;
     const rawDescription = settings.locales[locale]?.description ?? settings.siteDescription;
     const description = rawDescription?.trim() ? rawDescription : void 0;
     const ctaNav = settings.headerNav[0] ?? null;
@@ -193,7 +194,7 @@ function createHomePageView(ctx) {
                   tree,
                   categoryOrder,
                   categoryIgnore: [...categoryIgnore, ...movedNodes.map((n) => n.slug)],
-                  ...initiallyCollapsedCategorySlugs !== void 0 ? { initiallyCollapsedCategorySlugs } : {},
+                  ...effectiveInitiallyCollapsedCategorySlugs !== void 0 ? { initiallyCollapsedCategorySlugs: effectiveInitiallyCollapsedCategorySlugs } : {},
                   locale,
                   updatedLabel: t("doc.updated", locale),
                   dateFormats: dateFormatsFor(locale)

package/dist/preset.js

@@ -130,16 +130,6 @@ function buildMarkdownFeatures(settings, directiveVocabulary) {
     headingIds: { strategy: "hierarchical" }
   };
 }
-function optionalPeerShadows(settings) {
-  const peers = [
-    ["katex", Boolean(settings.math)],
-    ["diff", Boolean(settings.docHistory)]
-  ];
-  return {
-    shadow: peers.filter(([, on]) => !on).map(([name]) => name),
-    shadowIfMissing: peers.filter(([, on]) => on).map(([name]) => name)
-  };
-}
 function buildPlugins(settings, routeContext) {
   const localeArray = Object.entries(settings.locales).map(([code, locale]) => ({
     code,
@@ -347,10 +337,7 @@ function buildPlugins(settings, routeContext) {
     // `design-token-panel-bootstrap` (#4261). Preset-level rather than inside
     // the routes plugin because the bootstrap is reachable from chrome even
     // when packageOwnedRoutes is off.
-    ...resolvesBundleZdtp(settings) ? [] : [{ name: "@takazudo/zudo-doc/plugins/zdtp-loader", options: {} }],
-    // Absent or disabled katex/diff → throwing shadows, so they cannot fail a
-    // Rolldown build (Takazudo/zudo-front-builder#4429).
-    { name: "@takazudo/zudo-doc/plugins/optional-peers", options: optionalPeerShadows(settings) }
+    ...resolvesBundleZdtp(settings) ? [] : [{ name: "@takazudo/zudo-doc/plugins/zdtp-loader", options: {} }]
   ];
 }
 export {

package/dist/settings-defaults.js

@@ -14,6 +14,7 @@ const DEFAULT_SETTINGS = {
   trailingSlash: false,
   home: { wide: false, introMarkdown: "", sitemapHeading: "" },
   siteTreeNavIgnore: [],
+  siteTreeNavInitiallyCollapsed: [],
   siteTreeNavSecondary: [],
   minifyHtml: true,
   docsDir: "src/content/docs",

package/dist/settings.d.ts

@@ -347,6 +347,8 @@ export interface Settings {
     home?: HomeConfig;
     /** Top-level category slugs hidden from the package home-page grid and the `<SiteTreeNav />` MDX tag. Nothing hidden when omitted. */
     siteTreeNavIgnore?: string[];
+    /** Exact full category slugs to start collapsed at any depth in home and MDX SiteTreeNav. Defaults to `[]`. */
+    siteTreeNavInitiallyCollapsed?: string[];
     /** Top-level category slugs moved from the package home-page grid into the secondary link row under it. Nothing moved when omitted. */
     siteTreeNavSecondary?: string[];
     /** Minify production HTML output from `zfb build`. Defaults to `true` when omitted. */

package/dist/site-tree-nav/index.d.ts

@@ -82,6 +82,8 @@ export interface SiteTreeNavDeps {
      * package chrome passes `settings.siteTreeNavIgnore`.
      */
     categoryIgnore?: string[];
+    /** Exact full category slugs to start collapsed at any depth. Optional for existing factory callers. */
+    initiallyCollapsedCategorySlugs?: string[];
     /**
      * The raw `dateFormat` setting (`ctx.settings.dateFormat`). Resolved to
      * per-role patterns for the render locale and forwarded to the island as

package/dist/site-tree-nav/index.js

@@ -13,6 +13,7 @@ function createSiteTreeNavWrapper(deps) {
     getCategoryOrder,
     versionedDocsUrl,
     categoryIgnore,
+    initiallyCollapsedCategorySlugs,
     dateFormat
   } = deps;
   function SiteTreeNavWrapper({
@@ -43,6 +44,7 @@ function createSiteTreeNavWrapper(deps) {
       tree,
       categoryOrder,
       ...categoryIgnore !== void 0 ? { categoryIgnore } : {},
+      ...initiallyCollapsedCategorySlugs !== void 0 ? { initiallyCollapsedCategorySlugs } : {},
       ...ariaLabel !== void 0 ? { ariaLabel } : {},
       locale,
       dateFormats: resolveDateFormats(dateFormat, locale)

package/dist/site-tree-nav/normalize-island-props.d.ts

@@ -4,6 +4,7 @@ export interface SiteTreeNavIslandProps {
     tree: SidebarNavNode[];
     categoryOrder: string[];
     categoryIgnore?: string[];
+    initiallyCollapsedCategorySlugs?: string[];
     ariaLabel?: string;
     locale: string;
     dateFormats: ResolvedDateFormats;

package/dist/site-tree-nav/normalize-island-props.js

@@ -12,6 +12,12 @@ function normalizeSiteTreeNavProps(input) {
       "categoryIgnore"
     );
   }
+  if (input.initiallyCollapsedCategorySlugs !== void 0) {
+    normalized.initiallyCollapsedCategorySlugs = normalizeStringArray(
+      input.initiallyCollapsedCategorySlugs,
+      "initiallyCollapsedCategorySlugs"
+    );
+  }
   if (input.ariaLabel !== void 0) {
     normalized.ariaLabel = requireString(input.ariaLabel, "ariaLabel");
   }

package/dist/site-tree-nav-island/index.d.ts

@@ -5,7 +5,7 @@ export interface SiteTreeNavProps {
     ariaLabel?: string;
     categoryOrder?: string[];
     categoryIgnore?: string[];
-    /** Root-category slugs that should start collapsed. */
+    /** Exact full category slugs at any depth that should start collapsed. */
     initiallyCollapsedCategorySlugs?: string[];
     /** Locale used by dated note-tray rows. */
     locale?: string;

package/dist/site-tree-nav-island/index.js

@@ -91,7 +91,7 @@ function SiteTreeNav({
                     node,
                     depth: 0,
                     isLast,
-                    initiallyCollapsed: initiallyCollapsed.has(node.value.slug),
+                    initiallyCollapsedCategorySlugs: initiallyCollapsed,
                     locale,
                     dateFormats,
                     updatedLabel
@@ -108,7 +108,8 @@ function SiteTreeNav({
 SiteTreeNav.displayName = "SiteTreeNav";
 function NodeList({
   nodes,
-  depth
+  depth,
+  initiallyCollapsedCategorySlugs
 }) {
   return /* @__PURE__ */ jsx(For, { each: nodes, by: (node) => node.slug, children: (node, index) => {
     const isLast = computed(() => index.value === nodes.value.length - 1);
@@ -117,7 +118,7 @@ function NodeList({
       {
         when: computed(() => node.value.children.length > 0),
         fallback: () => /* @__PURE__ */ jsx(LeafNode, { node, depth, isLast }),
-        children: () => /* @__PURE__ */ jsx(CategoryNode, { node, depth, isLast })
+        children: () => /* @__PURE__ */ jsx(CategoryNode, { node, depth, isLast, initiallyCollapsedCategorySlugs })
       }
     );
   } });
@@ -126,12 +127,12 @@ function CategoryNode({
   node,
   depth,
   isLast,
-  initiallyCollapsed = false,
+  initiallyCollapsedCategorySlugs,
   locale = "en",
   dateFormats,
   updatedLabel = "Updated"
 }) {
-  const open = signal(initialCategoryOpenState(initiallyCollapsed));
+  const open = signal(initialCategoryOpenState(initiallyCollapsedCategorySlugs.has(node.value.slug)));
   const toggle = () => {
     open.value = toggleCategoryOpenState(open.value);
   };
@@ -234,7 +235,7 @@ function CategoryNode({
         when: computed(
           () => node.value.shape === "note-tray" && depth === 0
         ),
-        fallback: () => /* @__PURE__ */ jsx(NodeList, { nodes: children, depth: depth + 1 }),
+        fallback: () => /* @__PURE__ */ jsx(NodeList, { nodes: children, depth: depth + 1, initiallyCollapsedCategorySlugs }),
         children: () => /* @__PURE__ */ jsx(
           NoteTrayNodeList,
           {

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

@@ -314,6 +314,9 @@ html[data-theme-pack="drift"] a[data-nav-active] {
 html[data-theme-pack="drift"] .zd-content h1 {
   text-shadow: 0 0 34px color-mix(in oklch, var(--zd-accent) 32%, transparent);
 }
+html[data-theme-pack="drift"] .zd-content h2:where(:not(.zd-home-heading)):where(:not(.zd-compact-prose *)) {
+  font-size: 1.6rem;
+}
 html[data-theme-pack="drift"] .zd-content h2 {
   border-top-width: 1px;
   border-image: linear-gradient(
@@ -323,6 +326,9 @@ html[data-theme-pack="drift"] .zd-content h2 {
     )
     1 !important;
 }
+html[data-theme-pack="drift"] .zd-content h3:where(:not(.zd-compact-prose *)) {
+  border-top-width: 1px;
+}
 
 /* links: airy underline that brightens on approach */
 html[data-theme-pack="drift"] .zd-content a {

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

@@ -107,11 +107,17 @@ html[data-theme-pack="foundry"] .zd-content h1 {
   padding-bottom: 0.55rem;
   border-bottom: 1px solid color-mix(in srgb, var(--zd-muted) 42%, transparent);
 }
+html[data-theme-pack="foundry"] .zd-content h2:where(:not(.zd-home-heading)):where(:not(.zd-compact-prose *)) {
+  font-size: 1.6rem;
+}
 html[data-theme-pack="foundry"] .zd-content h2 {
   border-image: none !important;
   border-top-width: 1px;
   border-top-color: color-mix(in srgb, var(--zd-muted) 42%, transparent);
 }
+html[data-theme-pack="foundry"] .zd-content h3:where(:not(.zd-compact-prose *)) {
+  border-top-width: 1px;
+}
 
 /* inline code: neutral wash that holds up in both modes */
 html[data-theme-pack="foundry"] .zd-content code:not(pre code) {

package/dist/theme-packs/futura-editorial/pack.css

@@ -216,11 +216,17 @@ html[data-theme-pack="futura-editorial"] .zd-content > p[data-doc-description] {
    fade (signature move #2). The h2 rule needs !important to defeat the
    SSR-inlined `style="border-image:linear-gradient(...)"` (Decision
    6.6's sole allowlisted carve-out). */
+html[data-theme-pack="futura-editorial"] .zd-content h2:where(:not(.zd-home-heading)):where(:not(.zd-compact-prose *)) {
+  font-size: 1.6rem;
+}
 html[data-theme-pack="futura-editorial"] .zd-content h2 {
   border-image: none !important;
   border-top-width: 1px;
   border-top-color: var(--zd-fg);
 }
+html[data-theme-pack="futura-editorial"] .zd-content h3:where(:not(.zd-compact-prose *)) {
+  border-top-width: 1px;
+}
 html[data-theme-pack="futura-editorial"] .zd-content h3 {
   font-family: var(--font-display);
   letter-spacing: 0.01em;

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

@@ -264,6 +264,9 @@ html[data-theme-pack="hollow"] .zd-content h1 {
 /* h2: the SSR-inlined gradient bar is re-pointed at a fading pink
    rule (Decision 6.6's sole allowlisted !important carve-out —
    border-image only) */
+html[data-theme-pack="hollow"] .zd-content h2:where(:not(.zd-home-heading)):where(:not(.zd-compact-prose *)) {
+  font-size: 1.5rem;
+}
 html[data-theme-pack="hollow"] .zd-content h2 {
   border-image: linear-gradient(
       to right,

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

@@ -281,6 +281,9 @@ html[data-theme-pack="ledger"] .zd-content h2 {
   font-style: italic;
   font-size: 1.6rem;
 }
+html[data-theme-pack="ledger"] .zd-content h3:where(:not(.zd-compact-prose *)) {
+  border-top-width: 1px;
+}
 html[data-theme-pack="ledger"] .zd-content h3 {
   font-style: italic;
   font-size: 1.3rem;

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

@@ -229,6 +229,9 @@ html[data-theme-pack="matcha"] .zd-content h2 {
 }
 
 /* h3: quiet, slightly tracked (weight 600 rides --zdc-doc-h3-weight) */
+html[data-theme-pack="matcha"] .zd-content h3:where(:not(.zd-compact-prose *)) {
+  border-top-width: 1px;
+}
 html[data-theme-pack="matcha"] .zd-content h3 {
   letter-spacing: 0.01em;
 }

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

@@ -422,6 +422,9 @@ html[data-theme-pack="observatory"] .zd-content > p[data-doc-description] {
    allowlisted carve-out) + a zeroed border-top; the node-to-line rule
    is then painted as a top-anchored background gradient, with the two
    glowing star nodes as pseudo-element dots. */
+html[data-theme-pack="observatory"] .zd-content h2:where(:not(.zd-home-heading)):where(:not(.zd-compact-prose *)) {
+  font-size: 1.75rem;
+}
 html[data-theme-pack="observatory"] .zd-content h2 {
   border-image: none !important;
   border-top-width: 0;

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

@@ -284,6 +284,9 @@ html[data-theme-pack="sakura"] a[data-nav-active] {
    into drifting transparency. Re-points the SSR-inlined
    `style="border-image:linear-gradient(...)"` gradient — the
    border-image !important carve-out (Decision 6.6). */
+html[data-theme-pack="sakura"] .zd-content h2:where(:not(.zd-home-heading)):where(:not(.zd-compact-prose *)) {
+  font-size: 1.6rem;
+}
 html[data-theme-pack="sakura"] .zd-content h2 {
   border-top-width: 2px;
   border-image: linear-gradient(

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

@@ -225,6 +225,9 @@ html[data-theme-pack="scandi"] .zd-content h2 {
   border-top-width: 1px;
   border-top-color: color-mix(in srgb, var(--zd-accent) 38%, transparent);
 }
+html[data-theme-pack="scandi"] .zd-content h3:where(:not(.zd-compact-prose *)) {
+  border-top-width: 1px;
+}
 
 /* links: sage ink with a soft sage underline that firms on hover */
 html[data-theme-pack="scandi"] .zd-content a {

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

@@ -215,6 +215,9 @@ html[data-theme-pack="solar"] main nav[aria-label="Breadcrumb"] li > span {
    bar is defeated with border-image none !important (Decision 6.6's
    sole allowlisted carve-out) + a zeroed border-top; the fade is then
    painted as a 2px top-anchored background gradient. */
+html[data-theme-pack="solar"] .zd-content h2:where(:not(.zd-home-heading)):where(:not(.zd-compact-prose *)) {
+  font-size: 1.5rem;
+}
 html[data-theme-pack="solar"] .zd-content h2 {
   border-image: none !important;
   border-top-width: 0;

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

@@ -219,6 +219,9 @@ html[data-theme-pack="tidepool"] a[data-nav-active] {
 html[data-theme-pack="tidepool"] .zd-content h1 {
   color: color-mix(in srgb, var(--zd-accent) 12%, var(--zd-fg));
 }
+html[data-theme-pack="tidepool"] .zd-content h2:where(:not(.zd-home-heading)):where(:not(.zd-compact-prose *)) {
+  font-size: 1.5rem;
+}
 html[data-theme-pack="tidepool"] .zd-content h2 {
   border-image: none !important;
   border-top-width: 0;

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

@@ -314,6 +314,9 @@ html[data-theme-pack="washi"] .zd-content > p[data-doc-description] {
    SSR-inlined `style="border-image:linear-gradient(...)"` — the
    border-image !important carve-out (Decision 6.6), here re-pointing
    the gradient rather than clearing it. */
+html[data-theme-pack="washi"] .zd-content h2:where(:not(.zd-home-heading)):where(:not(.zd-compact-prose *)) {
+  font-size: 1.6rem;
+}
 html[data-theme-pack="washi"] .zd-content h2 {
   border-top-width: 2px;
   border-image: linear-gradient(

package/eject/site-tree-nav-island/index.tsx

@@ -57,7 +57,7 @@ export interface SiteTreeNavProps {
   ariaLabel?: string;
   categoryOrder?: string[];
   categoryIgnore?: string[];
-  /** Root-category slugs that should start collapsed. */
+  /** Exact full category slugs at any depth that should start collapsed. */
   initiallyCollapsedCategorySlugs?: string[];
   /** Locale used by dated note-tray rows. */
   locale?: string;
@@ -129,7 +129,7 @@ export function SiteTreeNav({
                         node={node}
                         depth={0}
                         isLast={isLast}
-                        initiallyCollapsed={initiallyCollapsed.has(node.value.slug)}
+                        initiallyCollapsedCategorySlugs={initiallyCollapsed}
                         locale={locale}
                         dateFormats={dateFormats}
                         updatedLabel={updatedLabel}
@@ -150,9 +150,11 @@ SiteTreeNav.displayName = "SiteTreeNav";
 function NodeList({
   nodes,
   depth,
+  initiallyCollapsedCategorySlugs,
 }: {
   nodes: ReadonlySignal<readonly SidebarNavNode[]>;
   depth: number;
+  initiallyCollapsedCategorySlugs: ReadonlySet<string>;
 }) {
   return (
     <For each={nodes} by={(node) => node.slug}>
@@ -166,7 +168,7 @@ function NodeList({
             )}
           >
             {() => (
-              <CategoryNode node={node} depth={depth} isLast={isLast} />
+              <CategoryNode node={node} depth={depth} isLast={isLast} initiallyCollapsedCategorySlugs={initiallyCollapsedCategorySlugs} />
             )}
           </Show>
         );
@@ -179,7 +181,7 @@ function CategoryNode({
   node,
   depth,
   isLast,
-  initiallyCollapsed = false,
+  initiallyCollapsedCategorySlugs,
   locale = "en",
   dateFormats,
   updatedLabel = "Updated",
@@ -187,12 +189,12 @@ function CategoryNode({
   node: ReadonlySignal<SidebarNavNode>;
   depth: number;
   isLast: ReadonlySignal<boolean>;
-  initiallyCollapsed?: boolean;
+  initiallyCollapsedCategorySlugs: ReadonlySet<string>;
   locale?: string;
   dateFormats?: ResolvedDateFormats;
   updatedLabel?: string;
 }) {
-  const open = signal(initialCategoryOpenState(initiallyCollapsed));
+  const open = signal(initialCategoryOpenState(initiallyCollapsedCategorySlugs.has(node.value.slug)));
   const toggle = () => {
     open.value = toggleCategoryOpenState(open.value);
   };
@@ -294,7 +296,7 @@ function CategoryNode({
                 () => node.value.shape === "note-tray" && depth === 0,
               )}
               fallback={() => (
-                <NodeList nodes={children} depth={depth + 1} />
+                <NodeList nodes={children} depth={depth + 1} initiallyCollapsedCategorySlugs={initiallyCollapsedCategorySlugs} />
               )}
             >
               {() => (

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zudo-doc",
-  "version": "7.1.0",
+  "version": "8.0.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",
@@ -15,7 +15,7 @@
     "url": "https://github.com/zudolab/zudo-doc/issues"
   },
   "engines": {
-    "node": ">=24 <25"
+    "node": ">=24"
   },
   "keywords": [
     "zudo-doc",
@@ -206,10 +206,6 @@
       "types": "./dist/plugins/zdtp-loader.d.ts",
       "default": "./dist/plugins/zdtp-loader.js"
     },
-    "./plugins/optional-peers": {
-      "types": "./dist/plugins/optional-peers.d.ts",
-      "default": "./dist/plugins/optional-peers.js"
-    },
     "./content-admonition": {
       "types": "./dist/content-admonition/index.d.ts",
       "default": "./dist/content-admonition/index.js"
@@ -738,12 +734,12 @@
     "CHANGELOG.md"
   ],
   "peerDependencies": {
-    "@modelcontextprotocol/sdk": "1.32.1",
+    "@modelcontextprotocol/sdk": "1.32.2",
     "@takazudo/zdtp": "^0.5.2 || ^0.6.0 || ^0.7.0 || ^0.8.0",
-    "@takazudo/zfb": "^4.7.0",
-    "@takazudo/zfb-md-wasm": "^4.7.0",
-    "@takazudo/zfb-runtime": "^4.7.0",
-    "@takazudo/zudo-doc-history-server": "^7.0.0",
+    "@takazudo/zfb": "^5.0.1",
+    "@takazudo/zfb-md-wasm": "^5.0.1",
+    "@takazudo/zfb-runtime": "^5.0.1",
+    "@takazudo/zudo-doc-history-server": "^8.0.0",
     "diff": "^8.0.0",
     "katex": "^0.18.2 || ^0.19.0",
     "zod": "^4.3.6"
@@ -781,11 +777,11 @@
     "yaml": "^2.9.0"
   },
   "devDependencies": {
-    "@modelcontextprotocol/sdk": "1.32.1",
+    "@modelcontextprotocol/sdk": "1.32.2",
     "@takazudo/mdx-formatter": "1.3.0",
-    "@takazudo/zfb": "4.7.0",
-    "@takazudo/zfb-md-wasm": "4.7.0",
-    "@takazudo/zfb-runtime": "4.7.0",
+    "@takazudo/zfb": "5.0.1",
+    "@takazudo/zfb-md-wasm": "5.0.1",
+    "@takazudo/zfb-runtime": "5.0.1",
     "@types/fs-extra": "^11.0.4",
     "@types/minimist": "^1.2.5",
     "@types/node": "^25.3.5",
@@ -795,7 +791,7 @@
     "typescript": "^5.0.0",
     "vitest": "^4.1.0",
     "zod": "^4.3.6",
-    "@takazudo/zudo-doc-history-server": "7.1.0"
+    "@takazudo/zudo-doc-history-server": "8.0.0"
   },
   "scripts": {
     "gen:search-widget-script": "node scripts/gen-search-widget-script.mjs",

package/dist/plugins/optional-peers.d.ts

@@ -1,3 +0,0 @@
-import type { ZfbPlugin } from "@takazudo/zfb/plugins";
-declare const plugin: ZfbPlugin;
-export default plugin;

package/dist/plugins/optional-peers.js

@@ -1,34 +0,0 @@
-import { createRequire } from "node:module";
-function shadowSource(specifier) {
-  const message = `Optional peer "${specifier}" is shadowed: it is not installed or the zudo-doc feature that uses it is off.`;
-  return `throw new Error(${JSON.stringify(message)});
-export {};
-`;
-}
-function stringList(value) {
-  return Array.isArray(value) ? value.filter((v) => typeof v === "string") : [];
-}
-function isResolvable(specifier) {
-  try {
-    createRequire(import.meta.url).resolve(specifier);
-    return true;
-  } catch {
-    return false;
-  }
-}
-const plugin = {
-  name: "optional-peers",
-  setup(ctx) {
-    const shadow = [
-      ...stringList(ctx.options["shadow"]),
-      ...stringList(ctx.options["shadowIfMissing"]).filter((s) => !isResolvable(s))
-    ];
-    for (const specifier of shadow) {
-      ctx.addVirtualModule(specifier, () => shadowSource(specifier));
-    }
-  }
-};
-var optional_peers_default = plugin;
-export {
-  optional_peers_default as default
-};