@takazudo/zudo-doc 7.1.0 → 8.1.0

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

@@ -9,6 +9,7 @@ import {
 import {
   INDENT,
   connectorLeft,
+  connectorLabelStart,
   ConnectorLines,
   CategoryLinkIcon
 } from "../tree-nav-shared/index.js";
@@ -24,9 +25,11 @@ import {
 import { formatMonthDay } from "../format-date/index.js";
 import { initialCategoryOpenState, toggleCategoryOpenState } from "./state.js";
 const SITE_BASE_PAD = "clamp(0.5rem, 0.8vw, 1rem)";
+const CONNECTOR_WIDTH_SCALE = 2;
+const CONNECTOR_LABEL_GAP = "var(--spacing-hsp-xs)";
 function padLeft(depth) {
   if (depth === 0) return SITE_BASE_PAD;
-  return `calc(${depth} * ${INDENT} + 1.25rem + 5px)`;
+  return `max(calc(${depth} * ${INDENT} + 1.25rem + 5px), ${connectorLabelStart(depth, CONNECTOR_WIDTH_SCALE, CONNECTOR_LABEL_GAP)})`;
 }
 function reorderTree(tree, order) {
   const map = new Map(tree.map((node) => [node.slug, node]));
@@ -91,7 +94,7 @@ function SiteTreeNav({
                     node,
                     depth: 0,
                     isLast,
-                    initiallyCollapsed: initiallyCollapsed.has(node.value.slug),
+                    initiallyCollapsedCategorySlugs: initiallyCollapsed,
                     locale,
                     dateFormats,
                     updatedLabel
@@ -108,7 +111,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 +121,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 +130,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);
   };
@@ -157,7 +161,7 @@ function CategoryNode({
         {
           depth,
           isLast: true,
-          widthScale: 2,
+          widthScale: CONNECTOR_WIDTH_SCALE,
           topPad: "calc(0.15rem + var(--spacing-vsp-xs))"
         }
       ) }),
@@ -166,7 +170,7 @@ function CategoryNode({
         {
           depth,
           isLast: false,
-          widthScale: 2,
+          widthScale: CONNECTOR_WIDTH_SCALE,
           topPad: "calc(0.15rem + var(--spacing-vsp-xs))"
         }
       ) }),
@@ -234,7 +238,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,
           {
@@ -369,7 +373,7 @@ function LeafNode({
       {
         depth,
         isLast: true,
-        widthScale: 2,
+        widthScale: CONNECTOR_WIDTH_SCALE,
         topPad
       }
     ) }),
@@ -378,7 +382,7 @@ function LeafNode({
       {
         depth,
         isLast: false,
-        widthScale: 2,
+        widthScale: CONNECTOR_WIDTH_SCALE,
         topPad
       }
     ) }),

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/dist/transitions/persisted-focus-settle-bootstrap.d.ts

@@ -0,0 +1,2 @@
+/** Settles a retained persisted focus before the router applies its scroll policy. */
+export declare function buildPersistedFocusSettleBootstrap(): string;

package/dist/transitions/persisted-focus-settle-bootstrap.js

@@ -0,0 +1,22 @@
+import { BEFORE_SWAP_EVENT } from "./page-events.js";
+function buildPersistedFocusSettleBootstrap() {
+  return `(function(){
+if(document.__zdPersistedFocusSettle)return;
+document.__zdPersistedFocusSettle=true;
+document.addEventListener(${JSON.stringify(BEFORE_SWAP_EVENT)},function(ev){
+if(typeof ev.swap!=="function")return;
+var originalSwap=ev.swap;
+var wrapped=function(){
+var active=document.activeElement;
+var retained=!!active&&typeof active.closest==="function"&&!!active.closest("[data-zfb-transition-persist]");
+var result=originalSwap.apply(this,arguments);
+if(retained&&active.isConnected&&document.activeElement===active)void document.documentElement.offsetHeight;
+return result;
+};
+try{ev.swap=wrapped;}catch(e){}
+});
+})();`;
+}
+export {
+  buildPersistedFocusSettleBootstrap
+};

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

@@ -4,6 +4,8 @@ export declare const CONNECTOR_OFFSET = "clamp(0.2rem, 0.3vw, 0.5rem)";
 export declare const CONNECTOR_WIDTH = "clamp(0.4rem, 0.6vw, 1rem)";
 export declare const BASE_PAD = "clamp(0.4rem, 0.8vw, 1.3rem)";
 export declare function connectorLeft(depth: number): string;
+/** Left edge a label needs so it starts `gap` after the horizontal connector's endpoint. */
+export declare function connectorLabelStart(depth: number, widthScale: number, gap: string): string;
 export declare function CategoryLinkIcon({ class: className }: {
     class?: string;
 }): import("@takazudo/zfb").Description;

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

@@ -6,6 +6,12 @@ const BASE_PAD = "clamp(0.4rem, 0.8vw, 1.3rem)";
 function connectorLeft(depth) {
   return `calc(${depth} * ${INDENT} + ${CONNECTOR_OFFSET})`;
 }
+function connectorWidth(widthScale) {
+  return widthScale === 1 ? CONNECTOR_WIDTH : `calc(${CONNECTOR_WIDTH} * ${widthScale})`;
+}
+function connectorLabelStart(depth, widthScale, gap) {
+  return `calc(${connectorLeft(depth)} + ${connectorWidth(widthScale)} + ${gap})`;
+}
 const CATEGORY_LINK_PATH = "M5.746 5.74 0 11.49l20.987 20.96C34.126 45.572 41.963 53.45 41.948 53.523c-.012.062-9.456 9.544-20.986 21.07L0 95.55l5.714 5.715c3.142 3.143 5.748 5.715 5.79 5.715s2.63-2.563 5.75-5.696l17.939-18.001c21.867-21.94 29.443-29.599 29.443-29.768 0-.114-.665-.804-5.084-5.275C51.872 40.47 11.71.125 11.565.036 11.525.01 8.906 2.578 5.746 5.74m38.345-.066c-3.132 3.13-5.696 5.71-5.696 5.732-.001.022 2.16 2.185 4.8 4.807 2.641 2.623 8.382 8.338 12.758 12.702 15.38 15.337 23.763 23.641 24.314 24.086.19.153.346.336.346.405 0 .07-1.738 1.847-3.887 3.976a17515 17515 0 0 0-20.35 20.264 19555 19555 0 0 1-17.223 17.158c-.416.409-.757.77-.757.8 0 .083 11.415 11.485 11.457 11.445.235-.22 53.542-53.528 53.542-53.543C103.395 53.472 49.891.02 49.837 0c-.028-.01-2.613 2.543-5.746 5.674";
 function CategoryLinkIcon({ class: className }) {
   return /* @__PURE__ */ jsx(
@@ -27,7 +33,7 @@ function ConnectorLines({
 }) {
   if (depth === 0) return null;
   const left = connectorLeft(depth);
-  const width = widthScale === 1 ? CONNECTOR_WIDTH : `calc(${CONNECTOR_WIDTH} * ${widthScale})`;
+  const width = connectorWidth(widthScale);
   const firstLineMid = `calc(${topPad} + 0.5lh)`;
   return /* @__PURE__ */ jsxs(Fragment, { children: [
     /* @__PURE__ */ jsx(
@@ -61,5 +67,6 @@ export {
   CategoryLinkIcon,
   ConnectorLines,
   INDENT,
+  connectorLabelStart,
   connectorLeft
 };

package/eject/header/header.tsx

@@ -60,6 +60,7 @@ import type {
   Locale,
 } from "./types.js";
 import { GitHub as GitHubIcon } from "../icons/index.js";
+import type { HeaderBrandConfig } from "../settings.js";
 
 /**
  * Boundary helpers the host injects into `<Header>`. These are the URL
@@ -168,6 +169,15 @@ export interface HeaderProps {
   /** Site-name string shown in the logo anchor (host `settings.siteName`). */
   siteName: string;
 
+  /**
+   * Optional brand icon rendered before `siteName` inside the logo anchor
+   * (host `settings.headerBrand`). Omitted or `false` renders the anchor
+   * exactly as before. The icon is a decorative `currentColor` CSS mask; an
+   * `icon` starting with `/` goes through `urlHelpers.withBase()`, anything
+   * else is used verbatim.
+   */
+  headerBrand?: false | HeaderBrandConfig;
+
   /** Header-nav items in render order (host `settings.headerNav`). */
   headerNav: HeaderNavItem[];
 
@@ -265,6 +275,7 @@ export function Header(props: HeaderProps): JSX.Element {
     search,
     persistKey,
     siteName,
+    headerBrand,
     headerNav,
     headerRightItems,
     headerRightComponents,
@@ -289,6 +300,16 @@ export function Header(props: HeaderProps): JSX.Element {
   const matchPath = pathForMatch(pathWithoutVersion, lang, i18n.defaultLocale);
 
   const activeNavPath = computeActiveNavPath(headerNav, matchPath);
+  // Direct `<Header>` consumers and raw route payloads bypass the config-time
+  // `assertValidHeaderBrand`, so a malformed value degrades to "no icon".
+  const brandIcon = headerBrand && typeof headerBrand.icon === "string" && headerBrand.icon !== ""
+    ? headerBrand.icon
+    : null;
+  const brandIconUrl = brandIcon === null
+    ? null
+    : brandIcon.startsWith("/") && !brandIcon.startsWith("//")
+      ? urlHelpers.withBase(brandIcon)
+      : brandIcon;
   const rightItemDispatch = createRightItemDispatch(headerRightComponents);
   const rightItems = headerRightItems
     .map((item, i) => ({
@@ -397,7 +418,17 @@ export function Header(props: HeaderProps): JSX.Element {
         class="min-w-0 truncate text-title font-bold text-fg hover:underline focus:underline"
         title={siteName}
         data-header-logo
+        data-header-brand={brandIconUrl !== null ? true : undefined}
       >
+        {brandIconUrl !== null && (
+          // Painted by features.css as a currentColor mask so it follows the
+          // site-name ink; decorative, the anchor's name stays the site name.
+          <span
+            aria-hidden="true"
+            data-header-brand-icon
+            style={{ "--zd-header-brand-icon": cssUrl(brandIconUrl) }}
+          />
+        )}
         {siteName}
       </a>
 
@@ -908,3 +939,12 @@ function renderRightItem(
 
   return null;
 }
+
+/**
+ * Serialize a URL as a quoted CSS `url()` token so paths with whitespace,
+ * parentheses or quotes survive inside the custom property. Kept local to
+ * this module because the header is ejectable (see `eject/index.ts`).
+ */
+function cssUrl(url: string): string {
+  return `url("${url.replace(/[\\"]/g, "\\$&").replace(/[\n\r\f]/g, "\\a ")}")`;
+}

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

@@ -12,6 +12,7 @@ import type { ResolvedDateFormats } from "../settings.js";
 import {
   INDENT,
   connectorLeft,
+  connectorLabelStart,
   ConnectorLines,
   CategoryLinkIcon,
 } from "../tree-nav-shared/index.js";
@@ -30,9 +31,15 @@ import { initialCategoryOpenState, toggleCategoryOpenState } from "./state.js";
 // site-tree-nav uses wider padding than the narrow sidebar
 const SITE_BASE_PAD = "clamp(0.5rem, 0.8vw, 1rem)";
 
+// The homepage draws its connectors at twice the sidebar width, so on wide
+// viewports the branch endpoint passes the fixed label indent. The label starts
+// at whichever is further right: that indent, or the endpoint plus a gap.
+const CONNECTOR_WIDTH_SCALE = 2;
+const CONNECTOR_LABEL_GAP = "var(--spacing-hsp-xs)";
+
 function padLeft(depth: number): string {
   if (depth === 0) return SITE_BASE_PAD;
-  return `calc(${depth} * ${INDENT} + 1.25rem + 5px)`;
+  return `max(calc(${depth} * ${INDENT} + 1.25rem + 5px), ${connectorLabelStart(depth, CONNECTOR_WIDTH_SCALE, CONNECTOR_LABEL_GAP)})`;
 }
 
 function reorderTree(tree: SidebarNavNode[], order: string[]): SidebarNavNode[] {
@@ -57,7 +64,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 +136,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 +157,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 +175,7 @@ function NodeList({
             )}
           >
             {() => (
-              <CategoryNode node={node} depth={depth} isLast={isLast} />
+              <CategoryNode node={node} depth={depth} isLast={isLast} initiallyCollapsedCategorySlugs={initiallyCollapsedCategorySlugs} />
             )}
           </Show>
         );
@@ -179,7 +188,7 @@ function CategoryNode({
   node,
   depth,
   isLast,
-  initiallyCollapsed = false,
+  initiallyCollapsedCategorySlugs,
   locale = "en",
   dateFormats,
   updatedLabel = "Updated",
@@ -187,12 +196,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);
   };
@@ -221,7 +230,7 @@ function CategoryNode({
             <ConnectorLines
               depth={depth}
               isLast={true}
-              widthScale={2}
+              widthScale={CONNECTOR_WIDTH_SCALE}
               topPad="calc(0.15rem + var(--spacing-vsp-xs))"
             />
           )}
@@ -231,7 +240,7 @@ function CategoryNode({
             <ConnectorLines
               depth={depth}
               isLast={false}
-              widthScale={2}
+              widthScale={CONNECTOR_WIDTH_SCALE}
               topPad="calc(0.15rem + var(--spacing-vsp-xs))"
             />
           )}
@@ -294,7 +303,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} />
               )}
             >
               {() => (
@@ -493,7 +502,7 @@ function LeafNode({
                 <ConnectorLines
                   depth={depth}
                   isLast={true}
-                  widthScale={2}
+                  widthScale={CONNECTOR_WIDTH_SCALE}
                   topPad={topPad}
                 />
               )}
@@ -503,7 +512,7 @@ function LeafNode({
                 <ConnectorLines
                   depth={depth}
                   isLast={false}
-                  widthScale={2}
+                  widthScale={CONNECTOR_WIDTH_SCALE}
                   topPad={topPad}
                 />
               )}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zudo-doc",
-  "version": "7.1.0",
+  "version": "8.1.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.1.2",
+    "@takazudo/zfb-md-wasm": "^5.1.2",
+    "@takazudo/zfb-runtime": "^5.1.2",
+    "@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.1.2",
+    "@takazudo/zfb-md-wasm": "5.1.2",
+    "@takazudo/zfb-runtime": "5.1.2",
     "@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.1.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;