@takazudo/zudo-doc 9.0.0 → 9.1.0

package/CHANGELOG.md

@@ -8,6 +8,24 @@ The format is based on Keep a Changelog, and release notes are generated from th
 
 No unreleased changes.
 
+## [9.1.0] - 2026-10-28
+
+### Features
+
+- The sidebar's branch-focus control is now a four-corner focus frame (named "Focus sidebar on" plus the category) instead of "◎". Pointing at it or reaching it with the keyboard briefly highlights exactly the branch it would show, with a short tooltip and no layout, scope, filter or URL change; on touch, one tap focuses the branch. The frame of a branch already shown on its own is inactive (`aria-disabled`, out of the tab order). Restore uses a counter-clockwise reset arrow ("Restore current page's sidebar"). Japanese labels are included. (b918819b)
+
+### Bug Fixes
+
+- The page-loading scrim covers the full viewport again, including the header and sidebar, with the spinner centered in the viewport. Since #4580 its bootstrap clipped it to the content area at runtime. The header and an unchanged desktop sidebar still stay undimmed and still during the page animation, because they use their own transition snapshots and the scrim is excluded from the animation. (d453d849)
+- A `categoryMatch` now matches only the whole top-level slug segment. Before, `categoryMatch: "foo"` also claimed `foo2/...` pages in the sidebar filter, in the `"!"` fallback exclusion, and when choosing a page's header section. (28808511)
+- The vertical guide line under an expanded note-tray year or month group now runs from the center of the group's toggle, and each child's connector reaches its label. (6ac3b3c8)
+- HtmlPreview's source toggle and inactive viewport buttons use the foreground color on hover, so their hover text keeps AA contrast. (6c82bb0c)
+
+### Other Changes
+
+- The optional `@takazudo/zdtp` peer now also accepts 0.9 (`^0.5.2 || ^0.6.0 || ^0.7.0 || ^0.8.0 || ^0.9.0`). zdtp 0.9.0 renders the design token panel without Preact, so a site on zdtp 0.9 installs no Preact at all; the panel's API, storage keys and CSS are unchanged. It also fixes undo on a generic token tab leaving the edited value on `:root` until reload. (09442500)
+- Runtime dependency ranges are refreshed: `esbuild` `^0.28.2` (was `>=0.28.1`), `yaml` `^2.9.1`, `fs-extra` `^11.4.1`, `tsx` `^4.23.15` and `@inquirer/prompts` `^8.7.5`. (07381de5)
+
 ## [9.0.0] - 2026-10-27
 
 ### Breaking Changes

package/README.md

@@ -9,7 +9,7 @@ instead of editing the generated markdown directly.
 This package provides the missing-by-design framework concerns:
 
 - **Sidebar tree builder** (`./sidebar-tree`) — turns collection entries + `_category_.json` into breadcrumb/navigation nodes.
-- **Theme controls** (`./theme`) — color scheme provider + design-token panel bootstrap (the optional zdtp package owns its opaque Preact UI).
+- **Theme controls** (`./theme`) — color scheme provider + design-token panel bootstrap (the optional zdtp package owns its opaque panel UI).
 - **Theme toggle (bare)** (`./theme-toggle`) — the un-wrapped ThemeToggle component for call sites that compose their own `<Island>` (the `./theme` barrel exports an Island-wrapped variant of the same component).
 - **TOC** (`./toc`) — desktop and mobile TOC zudo-react islands fed by MDX `headings` export.
 - **Breadcrumb** (`./breadcrumb`) — JSX breadcrumb fed by the sidebar tree.
@@ -126,9 +126,10 @@ are feature-dependent. Package defaults for `agentExport`, `mcp`, and `llmsTxt`
 are all `false`. The create-zudo-doc initializer enables `llmsTxt` by default;
 agent export and MCP remain opt-in.
 
-For the panel, the installed **zdtp 0.8.7** manifest carries **Preact ^10.29.1** as
-its own dependency (it was a peer through 0.8.5) and exports `./styles.css` (also `./styles`) to `dist/zdtp.css`. Its internal
-Tailwind browser dependency and Preact subtree are isolated from host JSX.
+For the panel, the installed **zdtp 0.9.0** renders with its own bundled zudo-react
+runtime and has **no Preact dependency** (0.8.6–0.8.7 carried Preact as a dependency; it
+was a peer through 0.8.5). It exports `./styles.css` (also `./styles`) to `dist/zdtp.css`. Its internal
+Tailwind browser dependency is isolated from host JSX.
 Install `@takazudo/zdtp` and import `@takazudo/zdtp/styles.css` when enabling it.
 
 ## Styling — Wind and public CSS

package/dist/compiled.css

@@ -2102,6 +2102,97 @@ site-search [data-search-results] > :is([data-search-placeholder], p) {
 .zd-theme-pack-active-ring {
   box-shadow: 0 0 0 2px var(--color-accent);
 }
+
+[data-sidebar-preview] {
+  background-color: color-mix(in oklch, var(--color-accent) 3%, transparent);
+  box-shadow: inset 2px 0 0 var(--color-accent);
+}
+
+[data-sidebar-preview] > [data-sidebar-row]:not([data-sidebar-current]) {
+  background-color: color-mix(in oklch, var(--color-accent) 7%, transparent);
+}
+
+[data-sidebar-preview] > [data-sidebar-row]:not([data-sidebar-current]) [data-sidebar-focus] {
+  color: var(--color-accent);
+  background-color: color-mix(in oklch, var(--color-accent) 7%, transparent);
+}
+
+[data-sidebar-preview] > [data-sidebar-children] [data-tree-connector] {
+  border-color: var(--color-accent);
+}
+
+[data-sidebar-arrived] > [data-sidebar-row]:not([data-sidebar-current]) {
+  animation: .7s ease-out zd-sidebar-arrival;
+}
+
+@keyframes zd-sidebar-arrival {
+  0%, 22% {
+    background-color: color-mix(in oklch, var(--color-accent) 12%, transparent);
+    box-shadow: inset 2px 0 0 var(--color-accent);
+  }
+
+  100% {
+    background-color: #0000;
+    box-shadow: inset 0 0 #0000;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  [data-sidebar-arrived] > [data-sidebar-row]:not([data-sidebar-current]) {
+    animation: none;
+  }
+}
+
+@media (pointer: coarse) {
+  [data-sidebar-row] [data-sidebar-focus] {
+    width: 2.5rem;
+    height: 2.75rem;
+  }
+}
+
+[data-sidebar-tooltip] {
+  position: fixed;
+  z-index: var(--z-index-tooltip);
+  max-width: min(18rem, 100vw - 1rem);
+  padding: var(--spacing-vsp-2xs) var(--spacing-hsp-sm);
+  border-radius: var(--radius-DEFAULT);
+  background-color: var(--color-fg);
+  color: var(--color-bg);
+  font-size: var(--text-caption);
+  line-height: 1.4;
+  overflow-wrap: anywhere;
+  box-shadow: 0 4px 12px color-mix(in oklch, var(--color-fg) 20%, transparent);
+}
+
+[data-sidebar-tooltip][hidden] {
+  display: none;
+}
+
+[data-sidebar-tooltip] > strong {
+  display: block;
+  font-weight: 600;
+}
+
+[data-sidebar-tooltip] > span {
+  display: block;
+  font-size: var(--text-micro);
+  opacity: .8;
+}
+
+@media (forced-colors: active) {
+  [data-sidebar-preview] > [data-sidebar-row] {
+    outline: 2px solid highlight;
+    outline-offset: -2px;
+  }
+
+  [data-sidebar-preview] > [data-sidebar-children] [data-tree-connector] {
+    border-color: highlight;
+  }
+
+  [data-sidebar-tooltip] {
+    border: 1px solid canvastext;
+  }
+}
 .block {
   display: block;
 }
@@ -2265,6 +2356,9 @@ site-search [data-search-results] > :is([data-search-placeholder], p) {
 .h-\[0\.875rem\] {
   height: 0.875rem;
 }
+.h-\[1\.0625rem\] {
+  height: 1.0625rem;
+}
 .h-\[1\.125rem\] {
   height: 1.125rem;
 }
@@ -2274,6 +2368,9 @@ site-search [data-search-results] > :is([data-search-placeholder], p) {
 .h-\[1\.575rem\] {
   height: 1.575rem;
 }
+.h-\[1\.875rem\] {
+  height: 1.875rem;
+}
 .h-\[10rem\] {
   height: 10rem;
 }
@@ -2418,6 +2515,9 @@ site-search [data-search-results] > :is([data-search-placeholder], p) {
 .w-\[0\.875rem\] {
   width: 0.875rem;
 }
+.w-\[1\.0625rem\] {
+  width: 1.0625rem;
+}
 .w-\[1\.125rem\] {
   width: 1.125rem;
 }
@@ -2433,6 +2533,9 @@ site-search [data-search-results] > :is([data-search-placeholder], p) {
 .w-\[1\.75rem\] {
   width: 1.75rem;
 }
+.w-\[1\.875rem\] {
+  width: 1.875rem;
+}
 .w-\[12rem\] {
   width: 12rem;
 }
@@ -3290,6 +3393,9 @@ site-search [data-search-results] > :is([data-search-placeholder], p) {
 .shadow-lg {
   box-shadow: var(--zw-shadow-lg);
 }
+.opacity-50 {
+  opacity: 0.5;
+}
 .opacity-60 {
   opacity: 0.6;
 }
@@ -3346,6 +3452,9 @@ site-search [data-search-results] > :is([data-search-placeholder], p) {
 .rotate-90 {
   rotate: 90deg;
 }
+.cursor-default {
+  cursor: default;
+}
 .cursor-not-allowed {
   cursor: not-allowed;
 }
@@ -3542,9 +3651,6 @@ site-search [data-search-results] > :is([data-search-placeholder], p) {
 .focus-visible\:text-accent:focus-visible {
   color: var(--zw-color-accent);
 }
-.focus-visible\:text-fg:focus-visible {
-  color: var(--zw-color-fg);
-}
 .focus-visible\:bg-accent\/10:focus-visible {
   background-color: color-mix(in oklab, var(--zw-color-accent) 10%, transparent);
 }

package/dist/design-token-panel-bootstrap-island.d.ts

@@ -1,4 +1,4 @@
-/** Package-default island; zdtp owns the opaque Preact UI it mounts. */
+/** Package-default island; zdtp owns the opaque panel UI it mounts. */
 export declare function DesignTokenPanelBootstrap(): null;
 export declare namespace DesignTokenPanelBootstrap {
     var displayName: string;

package/dist/features.css

@@ -1350,3 +1350,113 @@ site-search [data-search-results] > :is([data-search-placeholder], p) {
 .zd-theme-pack-active-ring {
   box-shadow: 0 0 0 2px var(--color-accent);
 }
+
+/* ========================================
+ * Sidebar branch focus preview (frame + branch preview)
+ *
+ * Hovering (mouse/pen) or keyboard-focusing a category's focus frame marks
+ * exactly that branch wrapper `[data-sidebar-preview]` (one per sidebar
+ * instance — see sidebar-tree-island/branch-preview.ts). Every treatment is
+ * paint-only: background, inset box-shadow and border-color. Nothing here may
+ * change box geometry, or the preview would shift rows.
+ *
+ * The wash and leading rule live on the wrapper's own background layer, so the
+ * current-page row's `bg-fg` fill paints over them and stays readable.
+ * ======================================== */
+[data-sidebar-preview] {
+  background-color: color-mix(in oklch, var(--color-accent) 3%, transparent);
+  box-shadow: inset 2px 0 0 var(--color-accent);
+}
+
+[data-sidebar-preview] > [data-sidebar-row]:not([data-sidebar-current]) {
+  background-color: color-mix(in oklch, var(--color-accent) 7%, transparent);
+}
+
+[data-sidebar-preview] > [data-sidebar-row]:not([data-sidebar-current]) [data-sidebar-focus] {
+  color: var(--color-accent);
+  background-color: color-mix(in oklch, var(--color-accent) 7%, transparent);
+}
+
+/* Only connectors inside the previewed subtree — never the row's own elbow to
+ * its parent, which belongs to the ancestor. */
+[data-sidebar-preview] > [data-sidebar-children] [data-tree-connector] {
+  border-color: var(--color-accent);
+}
+
+/* Scope arrival: a brief wash on the newly focused root row. */
+[data-sidebar-arrived] > [data-sidebar-row]:not([data-sidebar-current]) {
+  animation: zd-sidebar-arrival 700ms ease-out;
+}
+
+@keyframes zd-sidebar-arrival {
+  0%,
+  22% {
+    background-color: color-mix(in oklch, var(--color-accent) 12%, transparent);
+    box-shadow: inset 2px 0 0 var(--color-accent);
+  }
+  100% {
+    background-color: transparent;
+    box-shadow: inset 0 0 0 transparent;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  [data-sidebar-arrived] > [data-sidebar-row]:not([data-sidebar-current]) {
+    animation: none;
+  }
+}
+
+/* Touch target: a one-tap focus frame at a comfortable size. */
+@media (pointer: coarse) {
+  /* Out-specifies the frame's w-/h- utilities, which are emitted after this file. */
+  [data-sidebar-row] [data-sidebar-focus] {
+    width: 2.5rem;
+    height: 2.75rem;
+  }
+}
+
+/* Transient tooltip for the focus frame and Restore. Appended to <body> so the
+ * sidebar's scroll viewport and the drawer's transform cannot clip it. */
+[data-sidebar-tooltip] {
+  position: fixed;
+  z-index: var(--z-index-tooltip);
+  max-width: min(18rem, calc(100vw - 1rem));
+  padding: var(--spacing-vsp-2xs) var(--spacing-hsp-sm);
+  border-radius: var(--radius-DEFAULT);
+  background-color: var(--color-fg);
+  color: var(--color-bg);
+  font-size: var(--text-caption);
+  line-height: 1.4;
+  overflow-wrap: anywhere;
+  box-shadow: 0 4px 12px color-mix(in oklch, var(--color-fg) 20%, transparent);
+}
+
+[data-sidebar-tooltip][hidden] {
+  display: none;
+}
+
+[data-sidebar-tooltip] > strong {
+  display: block;
+  font-weight: 600;
+}
+
+[data-sidebar-tooltip] > span {
+  display: block;
+  font-size: var(--text-micro);
+  opacity: 0.8;
+}
+
+@media (forced-colors: active) {
+  [data-sidebar-preview] > [data-sidebar-row] {
+    outline: 2px solid Highlight;
+    outline-offset: -2px;
+  }
+
+  [data-sidebar-preview] > [data-sidebar-children] [data-tree-connector] {
+    border-color: Highlight;
+  }
+
+  [data-sidebar-tooltip] {
+    border: 1px solid CanvasText;
+  }
+}

package/dist/html-preview-wrapper/preview-base.js

@@ -103,7 +103,7 @@ function PreviewBase({
             "button",
             {
               type: "button",
-              class: computed(() => `min-h-[44px] min-w-[44px] px-hsp-sm py-hsp-2xs text-caption border rounded-full cursor-pointer transition-[background,color,border-color] duration-150 leading-snug ${i === activeViewport.value ? "bg-accent text-bg border-accent hover:bg-accent-hover hover:border-accent-hover" : "bg-transparent text-muted border-muted hover:bg-[color-mix(in_srgb,var(--color-surface)_80%,var(--color-fg)_20%)]"}`),
+              class: computed(() => `min-h-[44px] min-w-[44px] px-hsp-sm py-hsp-2xs text-caption border rounded-full cursor-pointer transition-[background,color,border-color] duration-150 leading-snug ${i === activeViewport.value ? "bg-accent text-bg border-accent hover:bg-accent-hover hover:border-accent-hover" : "bg-transparent text-muted border-muted hover:text-fg hover:bg-[color-mix(in_srgb,var(--color-surface)_80%,var(--color-fg)_20%)]"}`),
               "aria-pressed": computed(() => i === activeViewport.value),
               "on:click": () => {
                 activeViewport.value = i;
@@ -137,7 +137,7 @@ function PreviewBase({
         "button",
         {
           type: "button",
-          class: "flex min-h-[44px] min-w-[44px] items-center w-full px-hsp-md py-hsp-sm text-caption font-medium text-muted bg-surface border-none cursor-pointer gap-hsp-xs hover:bg-[color-mix(in_srgb,var(--color-surface)_80%,var(--color-fg)_20%)]",
+          class: "flex min-h-[44px] min-w-[44px] items-center w-full px-hsp-md py-hsp-sm text-caption font-medium text-muted bg-surface border-none cursor-pointer gap-hsp-xs hover:text-fg hover:bg-[color-mix(in_srgb,var(--color-surface)_80%,var(--color-fg)_20%)]",
           "on:click": () => {
             codeOpen.value = !codeOpen.value;
           },

package/dist/icons/index.d.ts

@@ -20,3 +20,5 @@ export declare function FileImage({ class: className }: IconProps): Child;
 export declare function FileVideo({ class: className }: IconProps): Child;
 export declare function FilePdf({ class: className }: IconProps): Child;
 export declare function FileArchive({ class: className }: IconProps): Child;
+export declare function FocusFrame({ class: className }: IconProps): Child;
+export declare function RestoreArrow({ class: className }: IconProps): Child;

package/dist/icons/index.js

@@ -334,6 +334,40 @@ function FileArchive({ class: className }) {
     }
   );
 }
+function FocusFrame({ class: className }) {
+  return /* @__PURE__ */ jsx(
+    "svg",
+    {
+      class: className || void 0,
+      viewBox: "0 0 24 24",
+      fill: "none",
+      stroke: "currentColor",
+      "stroke-width": "1.65",
+      "stroke-linecap": "round",
+      "stroke-linejoin": "round",
+      "aria-hidden": "true",
+      focusable: "false",
+      children: /* @__PURE__ */ jsx("path", { d: "M8 3H5a2 2 0 0 0-2 2v3m13-5h3a2 2 0 0 1 2 2v3M3 16v3a2 2 0 0 0 2 2h3m8 0h3a2 2 0 0 0 2-2v-3" })
+    }
+  );
+}
+function RestoreArrow({ class: className }) {
+  return /* @__PURE__ */ jsx(
+    "svg",
+    {
+      class: className || void 0,
+      viewBox: "0 0 24 24",
+      fill: "none",
+      stroke: "currentColor",
+      "stroke-width": "1.65",
+      "stroke-linecap": "round",
+      "stroke-linejoin": "round",
+      "aria-hidden": "true",
+      focusable: "false",
+      children: /* @__PURE__ */ jsx("path", { d: "M3 10a9 9 0 1 1 2.6 8.4M3 4v6h6" })
+    }
+  );
+}
 export {
   ArrowLeft,
   ChevronLeft,
@@ -346,9 +380,11 @@ export {
   FilePdf,
   FileText,
   FileVideo,
+  FocusFrame,
   Folder,
   FolderOpen,
   GitHub,
   History,
+  RestoreArrow,
   Search
 };

package/dist/nav-scope/index.d.ts

@@ -28,7 +28,7 @@ export declare function getNavSectionForSlug(slug: string, headerNav: NavScopeHe
 /**
  * Filter top-level NavNodes by a headerNav categoryMatch value.
  * - `"!"` means everything NOT claimed by explicit matchers
- * - `"claude"` means nodes whose slug starts with `"claude"`
+ * - `"claude"` means nodes whose slug is `"claude"` or under `"claude/"`
  * - `undefined` means all nodes
  *
  * Parameterized version of the host's `getNavSubtree()` — receives the

package/dist/nav-scope/index.js

@@ -13,26 +13,25 @@ function getCategoryOrder(headerNav) {
 function getNavSectionForSlug(slug, headerNav) {
   const topCategory = slug.split("/")[0] ?? "";
   const all = getCategoryOrder(headerNav);
-  const explicitMatches = all.filter(
-    (cm) => cm !== "!" && topCategory.startsWith(cm)
-  );
-  if (explicitMatches.length > 0) {
-    return explicitMatches.sort((a, b) => b.length - a.length)[0];
-  }
+  const explicitMatch = all.find((cm) => cm !== "!" && topCategory === cm);
+  if (explicitMatch !== void 0) return explicitMatch;
   const defaultItem = headerNav.find(
     (item) => item.categoryMatch === "!"
   );
   return defaultItem?.categoryMatch;
 }
+function matchesCategory(slug, match) {
+  return slug === match || slug.startsWith(match + "/");
+}
 function getNavSubtree(tree, categoryMatch, headerNav) {
   if (!categoryMatch) return tree;
   if (categoryMatch === "!") {
     const explicitPrefixes = getCategoryOrder(headerNav).filter((cm) => cm !== "!");
     return tree.filter(
-      (node) => !explicitPrefixes.some((prefix) => node.slug.startsWith(prefix))
+      (node) => !explicitPrefixes.some((prefix) => matchesCategory(node.slug, prefix))
     );
   }
-  return tree.filter((node) => node.slug.startsWith(categoryMatch));
+  return tree.filter((node) => matchesCategory(node.slug, categoryMatch));
 }
 export {
   getCategoryOrder,

package/dist/page-loading/page-loading-overlay.d.ts

@@ -15,7 +15,11 @@ export interface PageLoadingOverlayProps {
  */
 export declare function buildPageLoadingOverlayBootstrap(overlayId: string): string;
 /**
- * Content loading overlay shown while a dynamic navigation is pending.
+ * Full-viewport loading overlay shown while a dynamic navigation is pending.
+ *
+ * Geometry belongs to `page-loading.css` (`position: fixed; inset: 0`); the
+ * bootstrap only toggles visibility. Header and sidebar stay stationary through
+ * their own named View Transition snapshots, not by clipping the scrim.
  *
  * Mount this once per layout (typically inside `DocLayoutWithDefaults`'s
  * `bodyEnd` slot, alongside the existing body-end providers). It is

package/dist/page-loading/page-loading-overlay.js

@@ -11,7 +11,7 @@ function buildPageLoadingOverlayBootstrap(overlayId) {
   const after = JSON.stringify(AFTER_NAVIGATE_EVENT);
   return `(function(){
 var id=${id};
-function show(){var el=document.getElementById(id);if(!el)return;var content=document.querySelector(".zd-sidebar-content-wrapper");var header=document.querySelector("body > header");el.style.left=Math.max(0,content?content.getBoundingClientRect().left:0)+"px";el.style.top=Math.max(0,header?header.getBoundingClientRect().bottom:0)+"px";el.setAttribute("data-visible","");el.setAttribute("aria-hidden","false");}
+function show(){var el=document.getElementById(id);if(!el)return;el.setAttribute("data-visible","");el.setAttribute("aria-hidden","false");}
 function hide(){var el=document.getElementById(id);if(!el)return;el.removeAttribute("data-visible");el.setAttribute("aria-hidden","true");}
 function setPending(ev){document.querySelectorAll("[data-zd-nav-pending]").forEach(function(el){el.removeAttribute("data-zd-nav-pending");});var src=ev&&ev.sourceElement;if(src&&src instanceof Element)src.setAttribute("data-zd-nav-pending","");}
 function clearPending(){document.querySelectorAll("[data-zd-nav-pending]").forEach(function(el){el.removeAttribute("data-zd-nav-pending");});}

package/dist/page-loading.css

@@ -33,7 +33,8 @@
   position: fixed;
   view-transition-name: zfb-loading;
   inset: 0;
-  /* Pending-content overlay — the bootstrap excludes the layout's chrome.
+  /* Full-viewport pending scrim, header and sidebar included. Stationary
+     chrome comes from its own named snapshots, not from clipping this box.
      --z-index-modal fallback (100) ensures the overlay stacks on top even for
      bare consumers that have not defined the token. */
   z-index: var(--z-index-modal, 100);

package/dist/plugins/zdtp-loader.d.ts

@@ -1,4 +1,5 @@
 import type { ZfbPlugin } from "@takazudo/zfb/plugins";
 export declare const ZDTP_LOADER_SPECIFIER = "@takazudo/zudo-doc/zdtp-loader";
+export declare const ZDTP_DISABLED_MESSAGE_PREFIX = "@takazudo/zdtp is not bundled";
 declare const plugin: ZfbPlugin;
 export default plugin;

package/dist/plugins/zdtp-loader.js

@@ -1,5 +1,8 @@
 const ZDTP_LOADER_SPECIFIER = "@takazudo/zudo-doc/zdtp-loader";
-const DISABLED_LOADER_SOURCE = 'throw new Error("@takazudo/zdtp is not bundled: designTokenPanel is false and bundleZdtp is not set, so this build shadows @takazudo/zudo-doc/zdtp-loader. If you reached this through @takazudo/zudo-doc/design-token-panel-bootstrap to mount your own panel, set bundleZdtp: true and install @takazudo/zdtp.");\nexport {};\n';
+const ZDTP_DISABLED_MESSAGE_PREFIX = "@takazudo/zdtp is not bundled";
+const DISABLED_LOADER_SOURCE = `throw new Error("${ZDTP_DISABLED_MESSAGE_PREFIX}: designTokenPanel is false and bundleZdtp is not set, so this build shadows @takazudo/zudo-doc/zdtp-loader. If you reached this through @takazudo/zudo-doc/design-token-panel-bootstrap to mount your own panel, set bundleZdtp: true and install @takazudo/zdtp.");
+export {};
+`;
 const plugin = {
   name: "zdtp-loader",
   setup(ctx) {
@@ -8,6 +11,7 @@ const plugin = {
 };
 var zdtp_loader_default = plugin;
 export {
+  ZDTP_DISABLED_MESSAGE_PREFIX,
   ZDTP_LOADER_SPECIFIER,
   zdtp_loader_default as default
 };

package/dist/sidebar-tree-island/branch-preview.d.ts

@@ -0,0 +1,19 @@
+import { type ReadonlySignal, type Ref } from "@takazudo/zfb/zudo-react";
+/** Trigger attribute: the tooltip's title text. */
+export declare const TIP_ATTR = "data-sidebar-tip";
+/** Trigger attribute: optional secondary tooltip line. */
+export declare const TIP_DETAIL_ATTR = "data-sidebar-tip-detail";
+export interface BranchPreview {
+    /** Occurrence previewed in this sidebar instance, or null. Never persisted or broadcast. */
+    active: ReadonlySignal<string | null>;
+    clear: () => void;
+}
+/**
+ * Transient branch preview + tooltip for one sidebar island instance.
+ * Call `activate()` from the island's `onActivate`; it returns the cleanup.
+ * The desktop tree and the mobile drawer are separate instances, so each
+ * visible sidebar owns at most one preview and one tooltip.
+ */
+export declare function createBranchPreview(navRef: Ref<HTMLElement>): BranchPreview & {
+    activate: () => () => void;
+};