@takazudo/zudo-doc 0.2.11 → 0.2.13

package/dist/doclayout/doc-layout.js

@@ -43,7 +43,9 @@ function DocLayout(props) {
       /* @__PURE__ */ jsx("title", { children: title }),
       description !== void 0 && /* @__PURE__ */ jsx("meta", { name: "description", content: description }),
       noindex && /* @__PURE__ */ jsx("meta", { name: "robots", content: "noindex, nofollow" }),
-      ClientRouter(),
+      ClientRouter({
+        preserveHtmlAttrs: ["data-sidebar-hidden", "data-theme"]
+      }),
       head
     ] }),
     /* @__PURE__ */ jsxs("body", { class: "min-h-screen antialiased", children: [

package/dist/header/header.d.ts

@@ -36,6 +36,15 @@ interface HeaderProps {
     currentPath?: string;
     /** Optional active version slug. Forwarded into `navHref` for nav links. */
     currentVersion?: string;
+    /**
+     * The page's resolved "big category" (the host's nav section — see
+     * `getNavSectionForSlug`). When supplied, the header highlights the
+     * nav item whose `categoryMatch` (or a child's) equals this value,
+     * which is the authoritative "page is under this category" signal.
+     * Falls back to URL-path matching when omitted (home, 404, tag, and
+     * version pages carry no section).
+     */
+    activeCategory?: string;
     /**
      * Children projected into the mobile `<SidebarToggle>` island —
      * replaces the legacy `<slot name="sidebar" />`. Consumers pass the

package/dist/header/header.js

@@ -2,6 +2,7 @@ import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
 import {
   computeActiveNavPath,
   isNavItemActive,
+  isNavItemActiveByCategory,
   pathForMatch
 } from "./nav-active.js";
 import { NAV_OVERFLOW_SCRIPT } from "./nav-overflow-script.js";
@@ -11,6 +12,7 @@ function Header(props) {
     lang,
     currentPath = "",
     currentVersion,
+    activeCategory,
     sidebarSlot,
     sidebarToggle,
     themeToggle,
@@ -63,6 +65,7 @@ function Header(props) {
               headerNav.map((item) => renderNavItem(
                 item,
                 activeNavPath,
+                activeCategory,
                 lang,
                 currentVersion,
                 urlHelpers,
@@ -123,8 +126,8 @@ function SidebarSlotFallback({
   if (children === void 0 || children === null) return null;
   return /* @__PURE__ */ jsx("span", { hidden: true, children });
 }
-function renderNavItem(item, activeNavPath, lang, currentVersion, urlHelpers, i18n) {
-  const isActive = isNavItemActive(item, activeNavPath);
+function renderNavItem(item, activeNavPath, activeCategory, lang, currentVersion, urlHelpers, i18n) {
+  const isActive = isNavItemActiveByCategory(item, activeCategory) || isNavItemActive(item, activeNavPath);
   const href = urlHelpers.navHref(item.path, lang, currentVersion);
   const label = item.labelKey ? i18n.t(item.labelKey, lang) : item.label;
   if (item.children && item.children.length > 0) {
@@ -176,7 +179,7 @@ function renderNavItem(item, activeNavPath, lang, currentVersion, urlHelpers, i1
           /* @__PURE__ */ jsx("div", { class: "absolute left-0 top-full z-dropdown hidden group-hover:block group-focus-within:block pt-vsp-3xs", children: /* @__PURE__ */ jsx("div", { class: "min-w-[10rem] border border-muted rounded bg-surface shadow-lg py-vsp-3xs", children: item.children.map((child) => {
             const childHref = urlHelpers.navHref(child.path, lang, currentVersion);
             const childLabel = child.labelKey ? i18n.t(child.labelKey, lang) : child.label;
-            const childActive = activeNavPath === child.path;
+            const childActive = isNavItemActiveByCategory(child, activeCategory) || activeNavPath === child.path;
             return /* @__PURE__ */ jsx(
               "a",
               {

package/dist/header/nav-active.d.ts

@@ -1,8 +1,16 @@
 /** Minimal shape the active-path resolver needs from a header nav item. */
 interface NavItemLike {
     path: string;
+    /**
+     * The "big category" this nav entry claims (mirrors the host's
+     * `getNavSectionForSlug` / sidebar `categoryMatch`). When the host knows
+     * which category the current page belongs to, category matching is
+     * preferred over URL-path heuristics — see `isNavItemActiveByCategory`.
+     */
+    categoryMatch?: string;
     children?: {
         path: string;
+        categoryMatch?: string;
     }[];
 }
 /**
@@ -24,5 +32,23 @@ declare function computeActiveNavPath(navItems: readonly NavItemLike[], pathForM
  * `isNavItemActive` helper in the legacy template.
  */
 declare function isNavItemActive(item: NavItemLike, activeNavPath: string | undefined): boolean;
+/**
+ * Category-based active-state predicate. A nav entry is active when its
+ * own `categoryMatch` equals the page's resolved big category
+ * (`activeCategory`), or when any of its children claim that category.
+ *
+ * This is the authoritative "is the page under this big category?" check
+ * — it mirrors how the sidebar scopes its tree (`getNavSectionForSlug`),
+ * so the header highlight stays correct even when a category's page URLs
+ * do not share a prefix with the nav item's `path` (the case the older
+ * path-only heuristic missed). Callers prefer this over `isNavItemActive`
+ * and fall back to path matching when `activeCategory` is absent (e.g.
+ * home, 404, tag, and version pages, which carry no nav section).
+ *
+ * Works for both top-level items and child items: a child has no
+ * `children` of its own, so the call collapses to a single
+ * `categoryMatch` comparison.
+ */
+declare function isNavItemActiveByCategory(item: NavItemLike, activeCategory: string | undefined): boolean;
 
-export { type NavItemLike, computeActiveNavPath, isNavItemActive, pathForMatch };
+export { type NavItemLike, computeActiveNavPath, isNavItemActive, isNavItemActiveByCategory, pathForMatch };

package/dist/header/nav-active.js

@@ -22,8 +22,17 @@ function isNavItemActive(item, activeNavPath) {
   if (item.children?.some((child) => activeNavPath === child.path)) return true;
   return false;
 }
+function isNavItemActiveByCategory(item, activeCategory) {
+  if (activeCategory == null) return false;
+  if (item.categoryMatch === activeCategory) return true;
+  if (item.children?.some((child) => child.categoryMatch === activeCategory)) {
+    return true;
+  }
+  return false;
+}
 export {
   computeActiveNavPath,
   isNavItemActive,
+  isNavItemActiveByCategory,
   pathForMatch
 };

package/dist/header/nav-overflow-script.js

@@ -2,9 +2,112 @@ import { AFTER_NAVIGATE_EVENT } from "../transitions/page-events.js";
 const NAV_OVERFLOW_SCRIPT = `(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 ""; }
+  }
+
+  function isUnderPath(cur, p) {
+    if (!p) return false;
+    if (cur === p) return true;
+    return p !== "/" && cur.indexOf(p + "/") === 0;
+  }
+
+  // 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 location.pathname against
+  // each entry's href) and the SSR longest-match + dropdown-parent rules.
+  // URL-based: hrefs and location.pathname 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(location.pathname);
+
+    // Deepest (longest) nav path the current URL lives under, across both
+    // top-level and dropdown-child paths \u2014 matches computeActiveNavPath.
+    var activePath = "";
+    topItems.forEach(function (it) {
+      var isDropdown = it.hasAttribute("data-nav-item-dropdown");
+      var topA = isDropdown ? it.querySelector(":scope > a") : it;
+      if (topA) {
+        var tp = navPathname(topA);
+        if (isUnderPath(cur, tp) && tp.length > activePath.length) activePath = tp;
+      }
+      if (isDropdown) {
+        it.querySelectorAll(":scope > div a").forEach(function (c) {
+          var cp = navPathname(c);
+          if (isUnderPath(cur, cp) && cp.length > activePath.length) activePath = cp;
+        });
+      }
+    });
+
+    function setTopActive(a, active) {
+      if (!a) return;
+      if (active) {
+        a.classList.add("bg-fg", "text-bg");
+        a.classList.remove("text-muted", "hover:underline", "focus:underline");
+        a.setAttribute("aria-current", "page");
+      } else {
+        a.classList.remove("bg-fg", "text-bg");
+        a.classList.add("text-muted", "hover:underline", "focus:underline");
+        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("font-bold", "text-accent");
+            c.classList.remove("text-fg");
+          } else {
+            c.removeAttribute("data-active");
+            c.classList.remove("font-bold", "text-accent");
+            c.classList.add("text-fg");
+          }
+        });
+        topActive = parentMatch || anyChild;
+        var svg = topA ? topA.querySelector("svg") : null;
+        if (svg) {
+          if (topActive) { svg.classList.add("text-bg"); svg.classList.remove("text-muted"); }
+          else { svg.classList.add("text-muted"); svg.classList.remove("text-bg"); }
+        }
+      } 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 "\xB7\xB7\xB7" 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]");

package/dist/safelist.css

@@ -1,2 +1,2 @@
 /* generated by gen-safelist.mjs — do not edit by hand */
-@source inline("-mb-px [&::-webkit-details-marker]:hidden [&_a]:text-accent [&_a]:underline [&_nav]:mb-0 [doc-history-meta] [doc-layout] a a2 abbr above absent absolute active actual after after-breadcrumb after-content after-sidebar after-title against agent agents ai-chat ai-chat-trigger align-top all allow-same-origin allow-scripts alone already already-executed an anchor anchored and announce antialiased any application/json applies apply-css-vars are area arg aria-controls aria-current aria-disabled aria-expanded aria-haspopup aria-hidden aria-label aria-live aria-orientation aria-pressed aria-selected aria-valuemax aria-valuemin aria-valuenow arrows article as asc aside assets assigning assistant async at attach attribute attributes available await away b back backdrop:bg-bg/80 background backtick backticks baked banner bare based be because before below between bg bg-[#fff] bg-accent bg-bg bg-code-bg bg-fg bg-info/10 bg-muted bg-surface bg-transparent bg-warning/10 bg-warning/5 bi bigint bin blank blanks blob block blockquote blocks blur body body-end-components body-end-scripts boolean bootstrap border border-accent border-b border-b-2 border-b-[5px] border-collapse border-fg border-l border-l-[3px] border-muted border-none border-r border-t border-t-[2px] border-t-[3px] border-transparent border-warning/30 both br breadcrumb:end breadcrumb:start break-words browser browsers btn bundler but button buttons by cached caller can cancellation cannot canonical caption cases cat-nav- catch category catppuccin-latte caught change changes checkbox child ci circle cite class class-less claude claude-agents claude-commands claude-md claude-skills cleaned clear clear-css-vars clearing click client clip close code code-block-sr-announce col col-resize colgroup collision color color-scheme color-scheme-changed color-scheme-provider color-tweak colorization colors command commands commit component component:github-link component:language-switcher component:search component:theme-toggle component:version-switcher computed concrete configuration configure configured consumer consumes container containers containing content content-type content-wrapper:end content-wrapper:start contents controller converts copy correct correctly corrupt covered covers crashes crumb- cs css cursor cursor-not-allowed cursor-pointer custom dark data-active data-group-id data-header data-header-logo data-header-nav data-header-right data-mermaid-rendered data-mermaid-src data-nav-item data-nav-item-dropdown data-nav-more data-nav-more-menu data-nav-more-toggle data-processed data-sidebar-resizer data-tab-btn data-tab-default data-tab-label data-tab-value data-tabs data-taglist-group data-testid data-theme data-theme/style data-variant data-version-banner data-version-menu data-version-switcher data-version-toggle data-zfb-transition-persist dd decimal declare decoration-muted default defaults del desc description design design-token-panel design-token-trigger desktop desktop-sidebar destructive detached details deterministic dfn diagram diagrams dialog dieser directories directory disc display:none dist div dl doc doc-card- doc-history doc-history-generate does drag draggable drop dropdown dropdowns dt duration-150 duration-200 during dynamically e2e each earlier edge el element elements els else em emit emitting empty empty/undefined en entities entries entry error escape even eventually every exactly exit expected failed fall fallback falls false fast feed fg fieldset figcaption figure file fill fills finally fire fires first fixed fixtures flex flex-1 flex-col flex-wrap flip flipping flips focus focus-visible:outline-2 focus-visible:outline-accent focus-visible:outline-offset-2 focus-visible:underline focus:underline font font-bold font-medium font-mono font-semibold footer for form free fresh from frontmatter frontmatter-preview full function further g gap-[clamp(1.5rem,3vw,4rem)] gap-hsp-2xs gap-hsp-sm gap-hsp-xs gap-vsp-lg 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 generate generation genuine geometry get github github-link go got graph gray-matter grid grid-cols-1 group group-focus-visible:underline group-focus-within:block group-hover:bg-fg group-hover:block group-hover:text-bg group-hover:underline group-open:rotate-90 guard h-[0.5rem] h-[0.875rem] h-[1.575rem] h-[1lh] h-[3.5rem] h-[calc(100vh-3.5rem)] h-icon-sm h-icon-xs h1 h2 h3 h4 h5 h6 hand handle handled handlers has hash-link have head head-links head-scripts header header-call:end header-call:start height here hex hidden highlighter history hit 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:border-accent hover:border-accent-hover hover:border-fg hover:text-accent hover:text-accent-hover hover:text-fg hover:underline hr html i i2 i3 i4 identical if iframe img import imports in index inherit initial initialised inline inline-block inline-flex input ins inset-0 inside instanceof instructions intent into inverse invoke is it italic item- items items-center items-start itself javascript justify-between justify-center justify-end kbd keep keeps kept keydown khroma label landing language-switcher last:border-b-0 later launch leading-relaxed leading-snug leading-tight leaf- leaves leaving left left-0 left:calc legend legitimate lg lg:block lg:flex lg:grid-cols-[repeat(auto-fit,minmax(12rem,1fr))] lg:ml-[var(--zd-sidebar-w)] lg:pt-vsp-2xl lg:px-hsp-2xl lg:py-vsp-2xl li li2 light like likely line link link- list-disc list-none listener literal lives llms llms-txt load local look lostpointercapture luminance m m-0 main make maps mark marks matching max-h-[80vh] max-w-[46rem] max-w-[80rem] max-w-[clamp(50rem,75vw,90rem)] max-w-full max-w-none may mb-0 mb-vsp-2xs mb-vsp-lg mb-vsp-md mb-vsp-sm mb-vsp-xl mb-vsp-xs measures menu merged mermaid message meta metadata min-h-[calc(100vh-3.5rem)] min-h-screen min-w-0 min-w-[10rem] min-w-[8rem] mirror missing ml-auto ml-hsp-2xl ml-hsp-lg ml-hsp-sm ml-hsp-xl mod mode mounted mouseenter mouseleave mt-0 mt-vsp-2xs mt-vsp-3xs mt-vsp-lg mt-vsp-sm mt-vsp-xl must mutates mutation mutations mx-auto my-vsp-lg my-vsp-md name named native nav nav-card- navigating navigation navigations near needs new next no no-underline node node:fs node:module node:path nodes nofollow noindex non-empty non-string none noopener noreferrer normal not not-object note now null number object observe observer occurred of og:description og:image og:title og:type og:url ol old older on once one only opacity-60 option or other others out overflow overflow-auto overflow-hidden overflow-x-auto overflow-y-auto overflow-y:auto own p p-0 p-hsp-lg p-hsp-md p-hsp-sm p-hsp-xl packages padding page page-loading-overlay page-loading-spinner page-navigate-end pages paint panel panels parent parse parsed pass path pb-vsp-xl per permanently pi pick picked picks pins pipelines pl-[1.25rem] pl-hsp-lg pl-hsp-sm pl-hsp-xl place plus pointer-events-none pointercancel pointerdown pointermove pointerup polite polyline populates port position position:fixed pr-hsp-lg pr-hsp-md pr-hsp-xl pre preact preact/hooks preact/jsx-runtime preload pres produced produces production propagating properties property proxy pt-vsp-3xs pt-vsp-md pt-vsp-sm pt-vsp-xl pt-vsp-xs ptag- public purely px px-hsp-lg px-hsp-md px-hsp-sm px-hsp-xl px-hsp-xs py-0 py-hsp-2xs py-hsp-sm py-hsp-xs py-vsp-2xs py-vsp-3xs py-vsp-md py-vsp-sm py-vsp-xl py-vsp-xs q r raw re-encode/decode re-render re-renders re-run re-selects reach reached reaches read reading ready real real-value references refreshes regenerate regenerates reinit reinits relative remains remove render rendered renders reorder repeated replaced replaces repopulate requires reserved resize resize-x resolve resolved resolves return returns right- right-0 ro robots role root rotate-180 rotate-90 round round-trip rounded rounded-full rounded-lg router running runs runtime s safer samp schema-mismatch schema-missing script script-eval script-evaluation scripts scroll scrollbar scrolled scrollend search section section- see sel-bg sel-fg select select-none self-start separator server server-rendered set sets shadow-[0_1px_3px_color-mix(in_srgb,var(--color-fg)_8%,transparent)] shadow-lg shared shiki ships should show shown shrink-0 sidebar signal single sitemap- size skill skills skips slash slug sm:flex-row sm:grid-cols-2 sm:items-center sm:justify-between small snapshot snapshots so soft soft-nav solid some source space-y-vsp-2xs spacing span spans spec specifiers sr-only src stale stay sticky still stored stray string strip stroke-linecap stroke-linejoin stroke-width strong style style-attribute styles stylesheet sub subagents subsequent success summary sup support survives svg synchronous synchronously syntactically syntect tab tab-panel tabindex table tablist tabpanel tabs tabs-container tabs-content tabs-nav tag- tag-item- tbody td temp temp-element template temporary temporary-element test-results text text-accent text-bg text-body text-caption text-center text-code-fg text-fg text-heading text-info text-left text-micro text-muted text-muted/50 text-small text-title text-warning textarea tfoot th that the thead their them theme theme-color theme-toggle theme/token then there these they this through time title to toggle toggle-ai-chat toggle-design-token-panel toggles token tokens tolerates too top-0 top-[3.5rem] top-full total touches tr tracked tracking-wider trade-off transition transition-[background,color,border-color] transition-colors transition-transform treats tree-child- tree-item- tree-top- trick trigger trigger:ai-chat trigger:design-token-panel triggers true try twitter:card twitter:creator twitter:description twitter:image twitter:site twitter:title two u ul unavailable unchanged undefined under underline understand unknown unmaintained unobserve unreadable unrelated unreleased unreliable unset unsupported up uppercase use used uses utf-8 utf8 utilities v val value value-reader values var variable version- version-menu version-switcher vertical via video viewport visible vitesse-dark w w-[0.5rem] w-[0.875rem] w-[1.575rem] w-[16px] w-[280px] w-[var(--zd-sidebar-w)] w-full w-icon-sm w-icon-xs was watching wbr wbr- we what when where whereas whether which while whitespace-nowrap whitespace-pre whole will with without word working worktrees would wrap wrapper wrappers written wrote xl:flex xl:hidden y-scrollbar yet z-dropdown z-sidebar z-toolbar zd-content zd-doc-content-band zd-html-preview-code zd-sidebar-content-wrapper zfb zfb:after-swap zfb:before-preparation zudo-doc-design-tokens/v1 zudo-doc-sidebar-width zudo-doc-theme zudo-doc-theme-bridge");
+@source inline("-mb-px [&::-webkit-details-marker]:hidden [&_a]:text-accent [&_a]:underline [&_nav]:mb-0 [doc-history-meta] [doc-layout] a a2 abbr above absent absolute across active actual after after-breadcrumb after-content after-sidebar after-title against agent agents ai-chat ai-chat-trigger align-top all allow-same-origin allow-scripts alone already already-executed an anchor anchored and announce antialiased any application/json applies apply-css-vars approach are area arg aria-controls aria-current aria-disabled aria-expanded aria-haspopup aria-hidden aria-label aria-live aria-orientation aria-pressed aria-selected aria-valuemax aria-valuemin aria-valuenow arrows article as asc aside assets assigning assistant async at attach attribute attributes available await away b back backdrop:bg-bg/80 background backtick backticks baked banner bare base based be because before below between bg bg-[#fff] bg-accent bg-bg bg-code-bg bg-fg bg-info/10 bg-muted bg-surface bg-transparent bg-warning/10 bg-warning/5 bi bigint bin blank blanks blob block blockquote blocks blur body body-end-components body-end-scripts boolean bootstrap border border-accent border-b border-b-2 border-b-[5px] border-collapse border-fg border-l border-l-[3px] border-muted border-none border-r border-t border-t-[2px] border-t-[3px] border-transparent border-warning/30 both br breadcrumb:end breadcrumb:start break-words browser browsers btn bundler but button buttons by cached caller can cancellation cannot canonical caption carry cases cat-nav- catch category catppuccin-latte caught change changes checkbox child ci circle cite class class-less claude claude-agents claude-commands claude-md claude-skills cleaned clear clear-css-vars clearing click client client-router client-side clip close code code-block-sr-announce col col-resize colgroup collision color color-scheme color-scheme-changed color-scheme-provider color-tweak colorization colors command commands commit compare component component:github-link component:language-switcher component:search component:theme-toggle component:version-switcher computed concrete configuration configure configured consumer consumes container containers containing content content-type content-wrapper:end content-wrapper:start contents controller converts copy correct correctly corrupt covered covers cp crashes crumb- cs css cur current cursor cursor-not-allowed cursor-pointer custom dark data-active data-group-id data-header data-header-logo data-header-nav data-header-right data-mermaid-rendered data-mermaid-src data-nav-item data-nav-item-dropdown data-nav-more data-nav-more-menu data-nav-more-toggle data-processed data-sidebar-hidden data-sidebar-resizer data-tab-btn data-tab-default data-tab-label data-tab-value data-tabs data-taglist-group data-testid data-theme data-theme/style data-variant data-version-banner data-version-menu data-version-switcher data-version-toggle data-zfb-transition-persist dd decimal declare decoration-muted default defaults del desc description design design-token-panel design-token-trigger desktop desktop-sidebar destructive detached details deterministic dfn diagram diagrams dialog dieser directly directories directory disc display:none dist div dl doc doc-card- doc-history doc-history-generate does drag draggable drop dropdown dropdown-child dropdown-parent dropdowns dt duration-150 duration-200 during dynamically e2e each earlier edge el element elements els else em emit emitting empty empty/undefined en entities entries entry error escape even eventually every exactly exit expected failed fall fallback falls false fast feed fg fieldset figcaption figure file fill fills finally fire fires first fixed fixtures flex flex-1 flex-col flex-wrap flip flipping flips focus focus-visible:outline-2 focus-visible:outline-accent focus-visible:outline-offset-2 focus-visible:underline focus:underline font font-bold font-medium font-mono font-semibold footer for form free fresh from frontmatter frontmatter-preview frozen full function further g gap-[clamp(1.5rem,3vw,4rem)] gap-hsp-2xs gap-hsp-sm gap-hsp-xs gap-vsp-lg 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 generate generation genuine geometry get github github-link go got graph gray-matter grid grid-cols-1 group group-focus-visible:underline group-focus-within:block group-hover:bg-fg group-hover:block group-hover:text-bg group-hover:underline group-open:rotate-90 guard h-[0.5rem] h-[0.875rem] h-[1.575rem] h-[1lh] h-[3.5rem] h-[calc(100vh-3.5rem)] h-icon-sm h-icon-xs h1 h2 h3 h4 h5 h6 hand handle handled handlers has hash-link have head head-links head-scripts header header-call:end header-call:start height here hex hidden highlight highlighter history hit 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:border-accent hover:border-accent-hover hover:border-fg hover:text-accent hover:text-accent-hover hover:text-fg hover:underline hr hrefs html i i2 i3 i4 identical if iframe img import imports in index inherit initial initialised inline inline-block inline-flex input ins inset-0 inside instanceof instructions intent into inverse invoke is it italic item item- items items-center items-start itself javascript justify-between justify-center justify-end kbd keep keeps kept keydown khroma label landing language-switcher last:border-b-0 later launch leading-relaxed leading-snug leading-tight leaf- leaves leaving left left-0 left:calc legend legitimate lg lg:block lg:flex lg:grid-cols-[repeat(auto-fit,minmax(12rem,1fr))] lg:ml-[var(--zd-sidebar-w)] lg:pt-vsp-2xl lg:px-hsp-2xl lg:py-vsp-2xl li li2 light like likely line link link- list-disc list-none listener literal lives llms llms-txt load local locale longest-match look lostpointercapture luminance m m-0 main make maps mark marks matches matching max-h-[80vh] max-w-[46rem] max-w-[80rem] max-w-[clamp(50rem,75vw,90rem)] max-w-full max-w-none may mb-0 mb-vsp-2xs mb-vsp-lg mb-vsp-md mb-vsp-sm mb-vsp-xl mb-vsp-xs measures measuring menu merged mermaid message meta metadata min-h-[calc(100vh-3.5rem)] min-h-screen min-w-0 min-w-[10rem] min-w-[8rem] mirror mirrors missing ml-auto ml-hsp-2xl ml-hsp-lg ml-hsp-sm ml-hsp-xl mod mode mounted mouseenter mouseleave mt-0 mt-vsp-2xs mt-vsp-3xs mt-vsp-lg mt-vsp-sm mt-vsp-xl must mutates mutation mutations mx-auto my-vsp-lg my-vsp-md name named native nav nav-card- navigating navigation navigations near needs new next no no-underline node node:fs node:module node:path nodes nofollow noindex non-empty non-string none noopener noreferrer normal not not-object note now null number object observe observer occurred of og:description og:image og:title og:type og:url ol old older on once one only opacity-60 option or other others out overflow overflow-auto overflow-hidden overflow-x-auto overflow-y-auto overflow-y:auto own p p-0 p-hsp-lg p-hsp-md p-hsp-sm p-hsp-xl packages padding page page-loading-overlay page-loading-spinner page-navigate-end pages paint panel panels parent parse parsed pass path paths pb-vsp-xl per permanently persisted pi pick picked picks pins pipelines pl-[1.25rem] pl-hsp-lg pl-hsp-sm pl-hsp-xl place plus pointer-events-none pointercancel pointerdown pointermove pointerup polite polyline populates port position position:fixed pr-hsp-lg pr-hsp-md pr-hsp-xl pre preact preact/hooks preact/jsx-runtime preload pres produced produces production propagating properties property proxy pt-vsp-3xs pt-vsp-md pt-vsp-sm pt-vsp-xl pt-vsp-xs ptag- public purely px px-hsp-lg px-hsp-md px-hsp-sm px-hsp-xl px-hsp-xs py-0 py-hsp-2xs py-hsp-sm py-hsp-xs py-vsp-2xs py-vsp-3xs py-vsp-md py-vsp-sm py-vsp-xl py-vsp-xs q r raw re-encode/decode re-render re-renders re-run re-selects reach reached reaches read reading ready real real-value references refreshes regenerate regenerates reinit reinits relative remains remove render rendered renders reorder repaint repeated replaced replaces repopulate requires reserved resize resize-x resolve resolved resolves return returns right- right-0 ro robots role root rotate-180 rotate-90 round round-trip rounded rounded-full rounded-lg router running runs runtime s safer same-locale samp schema-mismatch schema-missing script script-eval script-evaluation scripts scroll scrollbar scrolled scrollend search section section- see sel-bg sel-fg select select-none self-start separator server server-rendered set sets shadow-[0_1px_3px_color-mix(in_srgb,var(--color-fg)_8%,transparent)] shadow-lg shared shiki ships should show shown shrink-0 sidebar signal single sitemap- size skill skills skips slash slug sm:flex-row sm:grid-cols-2 sm:items-center sm:justify-between small snapshot snapshots so soft soft-nav solid some source space-y-vsp-2xs spacing span spans spec specifiers sr-only src stale stay sticky still stored stray string strip stroke-linecap stroke-linejoin stroke-width strong style style-attribute styles stylesheet sub subagents subsequent success summary sup support survives svg swaps synchronous synchronously syntactically syntect tab tab-panel tabindex table tablist tabpanel tabs tabs-container tabs-content tabs-nav tag- tag-item- tbody td temp temp-element template temporary temporary-element test-results text text-accent text-bg text-body text-caption text-center text-code-fg text-fg text-heading text-info text-left text-micro text-muted text-muted/50 text-small text-title text-warning textarea tfoot th that the thead their them theme theme-color theme-toggle theme/token then there these they this through time title to toggle toggle-ai-chat toggle-design-token-panel toggles token tokens tolerates too top-0 top-[3.5rem] top-full top-level total touches tp tr tracked tracking-wider trade-off transition transition-[background,color,border-color] transition-colors transition-transform treats tree-child- tree-item- tree-top- trick trigger trigger:ai-chat trigger:design-token-panel triggers true try twitter:card twitter:creator twitter:description twitter:image twitter:site twitter:title two u ul unavailable unchanged undefined under underline understand unknown unmaintained unobserve unreadable unrelated unreleased unreliable unset unsupported up uppercase use used uses utf-8 utf8 utilities v val value value-reader values var variable version- version-menu version-switcher vertical via video viewport visible vitesse-dark w w-[0.5rem] w-[0.875rem] w-[1.575rem] w-[16px] w-[280px] w-[var(--zd-sidebar-w)] w-full w-icon-sm w-icon-xs was watching wbr wbr- we what when where whereas whether which while whitespace-nowrap whitespace-pre whole will with without word working worktrees would wrap wrapper wrappers written wrote xl:flex xl:hidden y-scrollbar yet z-dropdown z-sidebar z-toolbar zd-content zd-doc-content-band zd-html-preview-code zd-sidebar-content-wrapper zfb zfb:after-swap zfb:before-preparation zudo-doc-design-tokens/v1 zudo-doc-sidebar-width zudo-doc-theme zudo-doc-theme-bridge");

package/dist/toc/cx.d.ts

@@ -2,11 +2,10 @@
  * Tiny `clsx`-style class name joiner. Accepts strings, falsy values,
  * and arrays/objects of the same — only truthy strings survive.
  *
- * The host project depends on `clsx`, but framework primitives keep
- * their dependency surface minimal so that a downstream consumer of
- * `@takazudo/zudo-doc/toc` does not need an extra runtime dep just
- * for class name composition. The behavior here is the subset the TOC
- * primitives use; see clsx for the full feature set.
+ * Framework primitives keep their dependency surface minimal so that a
+ * downstream consumer of `@takazudo/zudo-doc/toc` does not need an extra
+ * runtime dep just for class name composition. The behavior here is the
+ * subset the TOC primitives use; see `clsx` for the full feature set.
  */
 type ClassValue = string | number | bigint | boolean | null | undefined | ClassValue[] | {
     [key: string]: unknown;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zudo-doc",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "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",
@@ -165,11 +165,11 @@
   ],
   "peerDependencies": {
     "preact": "^10.29.1",
-    "@takazudo/zfb": "^0.1.0-next.51",
-    "@takazudo/zfb-runtime": "^0.1.0-next.51",
+    "@takazudo/zfb": "^0.1.0-next.53",
+    "@takazudo/zfb-runtime": "^0.1.0-next.53",
     "@takazudo/zdtp": "^0.2.3",
     "shiki": "^4.0.2",
-    "@takazudo/zudo-doc-history-server": "^0.2.11"
+    "@takazudo/zudo-doc-history-server": "^0.2.13"
   },
   "peerDependenciesMeta": {
     "@takazudo/zudo-doc-history-server": {
@@ -194,8 +194,8 @@
     "tsup": "^8.0.0",
     "typescript": "^5.0.0",
     "vitest": "^4.1.0",
-    "@takazudo/zfb": "0.1.0-next.51",
-    "@takazudo/zfb-runtime": "0.1.0-next.51"
+    "@takazudo/zfb": "0.1.0-next.53",
+    "@takazudo/zfb-runtime": "0.1.0-next.53"
   },
   "scripts": {
     "build": "cross-env NODE_OPTIONS=--max-old-space-size=4096 tsup",