@takazudo/zudo-doc 6.1.0 → 6.2.0

package/CHANGELOG.md

@@ -8,6 +8,31 @@ The format is based on Keep a Changelog, and release notes are generated from th
 
 No unreleased changes.
 
+## [6.2.0] - 2026-10-14
+
+### Features
+
+- Adds optional `SidebarDefinition.scopeRoot?: "configured" | "editorial"` (default `"editorial"`, unchanged behavior). `"configured"` caps Broaden, branch focus, Restore, and route reconciliation at the authored forest: empty `items` stop at the category-filtered tree, one `autogenerated` directory stops at that directory, and an explicit list stops at that list. `initialPath` remains the starting view and the Restore baseline. At the cap the scope toolbar is omitted. An unsupported value fails the build. An omitted entry or an array stays editorial. (418b2f29c)
+
+### Bug Fixes
+
+- The shared `tsconfig.base.json` no longer sets `baseUrl`, which TypeScript 7 rejects with TS5102 in every project that extends it. Projects that relied on the inherited `baseUrl` for bare `paths` targets should write them as explicitly relative paths (for example `"@/*": ["./src/*"]`), which TypeScript 5.9 and 7 both resolve against the declaring tsconfig. (4d5e801ed)
+- `buildSidebarForSection` now applies `initialPath` and `initialPathMode` to an object sidebar definition with empty `items`, matching `buildSidebarNavigation`. Previously the empty-items case returned the plain category-filtered tree and ignored those options. (31fe01015)
+- Updates the lazy browser Mermaid URL from 11.15.0 to the exact 11.17.2 release, including the advisory fixes introduced in 11.16.1. Local npm audit does not cover the separately delivered CDN graph. (76d637663)
+- The desktop sidebar and the mobile drawer each keep their scroll offset across client navigation, a full document load, reload, and Back/Forward, including after Broaden. Restoration runs after the destination tree can hold the offset, so a replaced sidebar or a temporary empty tree does not snap back to the top. A saved zero is restored. A missing snapshot is not written as zero. A closed drawer keeps its saved offset in history until it opens again. Article scroll, focus, filtering, and disclosure are left unchanged. (418b2f29c, 2b38ccf0a)
+- The Appearance menu is a compact list of three rows (Light, Dark, System). The visible heading and the bottom helper are removed. The System row shows the device's current Light/Dark mode inline, and that status stays truthful while a manual Light or Dark preference is selected. The full localized helper remains the System option's accessible description. The popup is sized from its natural height at its final width, so its border no longer creates a spurious inner scrollbar. It opens above the trigger near the bottom edge and repositions when its content size changes. Opening, arrow keys, and focus return no longer scroll the page, and Tab / Shift+Tab leave the menu instead of cycling its rows. (37e3b8b42, 7aba63e28)
+
+### Other Changes
+
+- Requires zfb 4.5.0: the `@takazudo/zfb`, `zfb-runtime` and `zfb-md-wasm` peer floors move from `^4.3.3` to `^4.5.0`. zfb 4.4.0 updates its YAML frontmatter parser and fixes fragment Back/Forward navigation. zfb 4.5.0 also restores a previously rendered same-path query entry on Back/Forward, fixes sibling radio-group state on form reset, and adds opt-in CSS compiler and `ErrorBoundary` APIs. Upgrade the zfb family (and `zfb-adapter-cloudflare` when used) to 4.5.0 together with this release. (48a224468, 4f9d0c26f)
+- Updates the Codex resource TOML parser to smol-toml `^1.9.1`, preserving configuration dates and agent metadata while including its bounded key-scanning fix. (05e3fb5e7)
+
+## [6.1.1] - 2026-10-12
+
+### Other Changes
+
+- Requires zfb 4.3.3: the `@takazudo/zfb`, `zfb-runtime` and `zfb-md-wasm` peer floors move from `^4.3.2` to `^4.3.3`. zfb 4.3.3 moves its YAML frontmatter parser past [RUSTSEC-2026-0333](https://rustsec.org/advisories/RUSTSEC-2026-0333); frontmatter accepted by 4.3.2 is still accepted. Upgrade the zfb family (and `zfb-adapter-cloudflare` when used) to 4.3.3 together with this release. (bbc70837e)
+
 ## [6.1.0] - 2026-10-12
 
 ### Features

package/README.md

@@ -108,8 +108,8 @@ If your project renders **semi-trusted or user-submitted** HTML in a preview, ov
 ## 6.0 migration and peers
 
 **6.0.0** is the coordinated major release of `@takazudo/zudo-doc`,
-`@takazudo/zudo-doc-history-server` and `create-zudo-doc`. It targets the
-published **zfb 4.3.2** family (peer floor **^4.3.2**).
+`@takazudo/zudo-doc-history-server` and `create-zudo-doc`. The current workspace
+targets the published **zfb 4.5.0** family (peer floor **^4.5.0**).
 [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/code-syntax/mermaid-init-script.d.ts

@@ -3,7 +3,7 @@
  * resolves npm package specifiers to publishable ESM modules.
  *
  * Pinned to a specific minor.patch (not the bare `@11` major) so the
- * runtime version is byte-stable across deploys; floating on the major
+ * top-level package version is stable across deploys; floating on the major
  * would silently pull in upstream theme-API or behaviour changes. Bump
  * policy: there is no `mermaid` package.json dependency to keep in sync
  * with — this constant is the sole source of truth for the mermaid
@@ -15,7 +15,7 @@
  * tests can override the URL — e.g. self-hosted mirrors, version-
  * locked deployments — without re-templating the whole script.
  */
-export declare const MERMAID_CDN_MODULE_URL = "https://esm.sh/mermaid@11.15.0";
+export declare const MERMAID_CDN_MODULE_URL = "https://esm.sh/mermaid@11.17.2";
 /**
  * Build the inline init script with a caller-supplied module URL.
  *

package/dist/code-syntax/mermaid-init-script.js

@@ -1,5 +1,5 @@
 import { AFTER_NAVIGATE_EVENT } from "../transitions/page-events.js";
-const MERMAID_CDN_MODULE_URL = "https://esm.sh/mermaid@11.15.0";
+const MERMAID_CDN_MODULE_URL = "https://esm.sh/mermaid@11.17.2";
 function buildMermaidInitScript(cdnUrl) {
   const safeUrlLiteral = JSON.stringify(cdnUrl).replace(
     /<\/(script)/gi,

package/dist/compiled.css

@@ -2375,6 +2375,9 @@ site-search [data-search-results] > :is([data-search-placeholder], p) {
 .w-\[1\.125rem\] {
   width: 1.125rem;
 }
+.w-\[1\.25rem\] {
+  width: 1.25rem;
+}
 .w-\[1\.575rem\] {
   width: 1.575rem;
 }
@@ -3428,6 +3431,11 @@ site-search [data-search-results] > :is([data-search-placeholder], p) {
     background-color: color-mix(in oklab, var(--zw-color-accent) 10%, transparent);
   }
 }
+@media (hover: hover) {
+  .hover\:bg-accent\/5:hover {
+    background-color: color-mix(in oklab, var(--zw-color-accent) 5%, transparent);
+  }
+}
 @media (hover: hover) {
   .hover\:bg-bg\/10:hover {
     background-color: color-mix(in oklab, var(--zw-color-bg) 10%, transparent);

package/dist/sidebar-toggle-island/index.js

@@ -3,6 +3,7 @@ import { Fragment, jsx, jsxs } from "@takazudo/zfb/zudo-react/jsx-runtime";
 import { computed, getScope, signal } from "@takazudo/zfb/zudo-react";
 import { AFTER_NAVIGATE_EVENT, ensureNestedIslandPropsRefresh } from "../transitions/index.js";
 import { SidebarTree } from "../sidebar-tree-island/index.js";
+import { notifySidebarScrollReady } from "../sidebar-tree-island/sidebar-scroll-preserve.js";
 ensureNestedIslandPropsRefresh();
 const cx = (...classes) => classes.filter(Boolean).join(" ");
 const HIDDEN_ICON_STYLE = "display:none";
@@ -29,6 +30,10 @@ function SidebarToggle({
     document.body.style.overflow = isOpen ? "hidden" : "";
     if (isOpen) closeIconRef.current?.style.removeProperty("display");
     else closeIconRef.current?.style.setProperty("display", "none");
+    if (isOpen) {
+      const scroller = document.querySelector("aside[data-zd-mobile-sidebar] .flex-1.overflow-y-auto");
+      if (scroller) notifySidebarScrollReady(scroller);
+    }
     if (isOpen) menuIconRef.current?.style.setProperty("display", "none");
     else menuIconRef.current?.style.removeProperty("display");
     return () => {

package/dist/sidebar-tree-island/index.js

@@ -25,7 +25,7 @@ import {
   CURRENT_PATH_DATASET_KEY,
   readCurrentPath
 } from "../current-path/index.js";
-import { ensureSidebarScrollPreserve } from "./sidebar-scroll-preserve.js";
+import { ensureSidebarScrollPreserve, notifySidebarScrollReady } from "./sidebar-scroll-preserve.js";
 import {
   formatYearLabel,
   formatYearMonthLabel,
@@ -237,6 +237,13 @@ function SidebarTree({
   const filteredNodes = computed(
     () => query.value ? filterTree(selectedNodes.value, query.value) : selectedNodes.value
   );
+  scope.effect(() => {
+    void selected.value;
+    void selectedNodes.value;
+    void query.value;
+    const nav = navRef.current;
+    if (nav) notifySidebarScrollReady(nav);
+  });
   const locale = localeProp ?? localeLinks?.find((link) => link.active)?.code ?? "en";
   const footer = /* @__PURE__ */ jsx(
     SidebarFooter,
@@ -258,97 +265,106 @@ function SidebarTree({
           when: computed(
             () => activeSlug.value === void 0 && !!rootMenuItems
           ),
-          fallback: () => /* @__PURE__ */ jsxs("nav", { ref: navRef, tabindex: -1, children: [
-            rootMenuItems ? /* @__PURE__ */ jsxs(
-              "button",
-              {
-                type: "button",
-                "on:click": () => {
-                  showingRootMenu.value = true;
-                },
-                class: "lg:hidden flex w-full items-center gap-hsp-xs px-hsp-sm py-vsp-xs text-left text-small text-muted hover:text-fg border-b border-muted",
-                children: [
-                  /* @__PURE__ */ jsx(ChevronLeft, { class: "h-icon-sm w-icon-sm shrink-0" }),
-                  backToMenuLabel ?? "Back to main menu"
-                ]
-              }
-            ) : null,
-            /* @__PURE__ */ jsx("div", { class: "px-hsp-sm py-vsp-xs border-b border-muted", "data-sidebar-filter-region": true, children: /* @__PURE__ */ jsxs("div", { class: "flex items-center gap-hsp-xs bg-surface rounded px-hsp-sm py-vsp-2xs", children: [
-              /* @__PURE__ */ jsx(Search, { class: "h-[14px] w-[14px] text-muted shrink-0" }),
-              /* @__PURE__ */ jsx(
-                "input",
-                {
-                  ref: filterRef,
-                  type: "text",
-                  "aria-label": "Filter navigation",
-                  placeholder: filterPlaceholder,
-                  modelValue: query,
-                  "on:input": (event) => {
-                    query.value = event.target.value;
-                    save();
-                  },
-                  class: "bg-transparent text-small outline-none w-full text-fg placeholder:text-muted focus-visible:outline-2 focus-visible:outline-accent",
-                  style: "outline-offset:-4px"
-                }
-              )
-            ] }) }),
-            navigation ? /* @__PURE__ */ jsx(Show, { when: computed(() => broader.value !== null), children: () => /* @__PURE__ */ jsx("div", { class: "border-b border-muted px-hsp-md py-vsp-2xs text-small", "data-sidebar-scope-toolbar": true, children: /* @__PURE__ */ jsxs("div", { class: "flex items-center justify-between gap-hsp-xs", "data-sidebar-scope-actions": true, children: [
-              /* @__PURE__ */ jsxs(
-                "button",
-                {
-                  type: "button",
-                  "data-sidebar-broaden": true,
-                  disabled: computed(() => broader.value === null),
-                  "on:click": () => {
-                    if (broader.value !== null) changeScope(broader.value);
-                  },
-                  style: "min-height:40px",
-                  class: "flex items-center gap-hsp-sm px-hsp-xs font-medium rounded text-fg hover:bg-surface focus-visible:bg-surface focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent disabled:text-muted disabled:opacity-50",
-                  children: [
-                    /* @__PURE__ */ jsx("span", { "aria-hidden": "true", children: "\u2191" }),
-                    labels.broaden
-                  ]
-                }
-              ),
-              /* @__PURE__ */ jsx(Show, { when: canRestore, children: () => /* @__PURE__ */ jsx(
-                "button",
-                {
-                  type: "button",
-                  "data-sidebar-restore": true,
-                  "on:click": () => changeScope(null),
-                  title: labels.restore,
-                  "aria-label": labels.restore,
-                  style: "width:40px;height:40px",
-                  class: "grid place-items-center shrink-0 rounded text-muted hover:text-fg focus-visible:text-fg focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent",
-                  children: /* @__PURE__ */ jsxs("svg", { width: "15", height: "15", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", "stroke-width": "2", "aria-hidden": "true", children: [
-                    /* @__PURE__ */ jsx("circle", { cx: "12", cy: "12", r: "10" }),
-                    /* @__PURE__ */ jsx("circle", { cx: "12", cy: "12", r: "6" }),
-                    /* @__PURE__ */ jsx("circle", { cx: "12", cy: "12", r: "2" })
-                  ] })
-                }
-              ) })
-            ] }) }) }) : null,
-            /* @__PURE__ */ jsx("div", { "data-sidebar-tree-root": true, children: /* @__PURE__ */ jsx(
-              Show,
-              {
-                when: computed(() => selectedNodes.value.length === 1 && selectedNodes.value[0]?.shape === "note-tray"),
-                fallback: () => /* @__PURE__ */ jsx(NodeList, { nodes: filteredNodes, currentSlug: activeSlug, depth: 0, forceOpen: computed(() => !!query.value), scopeControls }),
-                children: () => /* @__PURE__ */ jsx(Show, { when: computed(() => !!filteredNodes.value[0]), children: () => /* @__PURE__ */ jsx(
-                  TrayList,
+          fallback: () => /* @__PURE__ */ jsxs(
+            "nav",
+            {
+              ref: navRef,
+              tabindex: -1,
+              "data-sidebar-context": navigation?.id,
+              "data-sidebar-scope": computed(() => selected.value ?? ""),
+              children: [
+                rootMenuItems ? /* @__PURE__ */ jsxs(
+                  "button",
                   {
-                    tray: computed(() => filteredNodes.value[0]),
-                    itemCount: getNoteTrayItems(selectedNodes.value[0]).length,
-                    currentSlug: activeSlug,
-                    forceOpen: computed(() => !!query.value),
-                    locale,
-                    dateFormats,
-                    scopeControls
+                    type: "button",
+                    "on:click": () => {
+                      showingRootMenu.value = true;
+                    },
+                    class: "lg:hidden flex w-full items-center gap-hsp-xs px-hsp-sm py-vsp-xs text-left text-small text-muted hover:text-fg border-b border-muted",
+                    children: [
+                      /* @__PURE__ */ jsx(ChevronLeft, { class: "h-icon-sm w-icon-sm shrink-0" }),
+                      backToMenuLabel ?? "Back to main menu"
+                    ]
                   }
-                ) })
-              }
-            ) }),
-            footer
-          ] }),
+                ) : null,
+                /* @__PURE__ */ jsx("div", { class: "px-hsp-sm py-vsp-xs border-b border-muted", "data-sidebar-filter-region": true, children: /* @__PURE__ */ jsxs("div", { class: "flex items-center gap-hsp-xs bg-surface rounded px-hsp-sm py-vsp-2xs", children: [
+                  /* @__PURE__ */ jsx(Search, { class: "h-[14px] w-[14px] text-muted shrink-0" }),
+                  /* @__PURE__ */ jsx(
+                    "input",
+                    {
+                      ref: filterRef,
+                      type: "text",
+                      "aria-label": "Filter navigation",
+                      placeholder: filterPlaceholder,
+                      modelValue: query,
+                      "on:input": (event) => {
+                        query.value = event.target.value;
+                        save();
+                      },
+                      class: "bg-transparent text-small outline-none w-full text-fg placeholder:text-muted focus-visible:outline-2 focus-visible:outline-accent",
+                      style: "outline-offset:-4px"
+                    }
+                  )
+                ] }) }),
+                navigation ? /* @__PURE__ */ jsx(Show, { when: computed(() => broader.value !== null), children: () => /* @__PURE__ */ jsx("div", { class: "border-b border-muted px-hsp-md py-vsp-2xs text-small", "data-sidebar-scope-toolbar": true, children: /* @__PURE__ */ jsxs("div", { class: "flex items-center justify-between gap-hsp-xs", "data-sidebar-scope-actions": true, children: [
+                  /* @__PURE__ */ jsxs(
+                    "button",
+                    {
+                      type: "button",
+                      "data-sidebar-broaden": true,
+                      disabled: computed(() => broader.value === null),
+                      "on:click": () => {
+                        if (broader.value !== null) changeScope(broader.value);
+                      },
+                      style: "min-height:40px",
+                      class: "flex items-center gap-hsp-sm px-hsp-xs font-medium rounded text-fg hover:bg-surface focus-visible:bg-surface focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent disabled:text-muted disabled:opacity-50",
+                      children: [
+                        /* @__PURE__ */ jsx("span", { "aria-hidden": "true", children: "\u2191" }),
+                        labels.broaden
+                      ]
+                    }
+                  ),
+                  /* @__PURE__ */ jsx(Show, { when: canRestore, children: () => /* @__PURE__ */ jsx(
+                    "button",
+                    {
+                      type: "button",
+                      "data-sidebar-restore": true,
+                      "on:click": () => changeScope(null),
+                      title: labels.restore,
+                      "aria-label": labels.restore,
+                      style: "width:40px;height:40px",
+                      class: "grid place-items-center shrink-0 rounded text-muted hover:text-fg focus-visible:text-fg focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent",
+                      children: /* @__PURE__ */ jsxs("svg", { width: "15", height: "15", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", "stroke-width": "2", "aria-hidden": "true", children: [
+                        /* @__PURE__ */ jsx("circle", { cx: "12", cy: "12", r: "10" }),
+                        /* @__PURE__ */ jsx("circle", { cx: "12", cy: "12", r: "6" }),
+                        /* @__PURE__ */ jsx("circle", { cx: "12", cy: "12", r: "2" })
+                      ] })
+                    }
+                  ) })
+                ] }) }) }) : null,
+                /* @__PURE__ */ jsx("div", { "data-sidebar-tree-root": true, children: /* @__PURE__ */ jsx(
+                  Show,
+                  {
+                    when: computed(() => selectedNodes.value.length === 1 && selectedNodes.value[0]?.shape === "note-tray"),
+                    fallback: () => /* @__PURE__ */ jsx(NodeList, { nodes: filteredNodes, currentSlug: activeSlug, depth: 0, forceOpen: computed(() => !!query.value), scopeControls }),
+                    children: () => /* @__PURE__ */ jsx(Show, { when: computed(() => !!filteredNodes.value[0]), children: () => /* @__PURE__ */ jsx(
+                      TrayList,
+                      {
+                        tray: computed(() => filteredNodes.value[0]),
+                        itemCount: getNoteTrayItems(selectedNodes.value[0]).length,
+                        currentSlug: activeSlug,
+                        forceOpen: computed(() => !!query.value),
+                        locale,
+                        dateFormats,
+                        scopeControls
+                      }
+                    ) })
+                  }
+                ) }),
+                footer
+              ]
+            }
+          ),
           children: () => /* @__PURE__ */ jsxs("nav", { children: [
             menu,
             footer

package/dist/sidebar-tree-island/sidebar-scroll-preserve.d.ts

@@ -2,20 +2,22 @@ interface SidebarScrollPreserveOptions {
     document: Document;
     requestAnimationFrame: (callback: FrameRequestCallback) => number;
     cancelAnimationFrame: (handle: number) => void;
+    ResizeObserver?: typeof ResizeObserver;
 }
 /**
  * Install the scroll-preservation state machine on a document.
  *
- * This low-level entrypoint owns an explicit cleanup for focused tests and
- * non-singleton hosts. The sidebar's browser module uses the durable,
- * duplicate-safe `ensureSidebarScrollPreserve` wrapper below instead.
- */
-export declare function installSidebarScrollPreserve({ document, requestAnimationFrame, cancelAnimationFrame, }: SidebarScrollPreserveOptions): () => void;
-/**
- * Install exactly one module-lifetime controller for a browser document.
- * Repeated calls from component renders or duplicate boot paths are no-ops.
+ * The desktop aside is replaced when sidebar island props change: preparation
+ * drops `data-zfb-transition-persist`, so element identity is not enough for
+ * the same logical tree. A saved offset is applied only after the destination
+ * can hold it. Chromium clamps a write that happens while `scrollHeight` is
+ * still too small, and that clamped 0 would stick.
  */
+export declare function installSidebarScrollPreserve({ document, requestAnimationFrame, cancelAnimationFrame, ResizeObserver: ResizeObserverImpl, }: SidebarScrollPreserveOptions): () => void;
+/** Install exactly one module-lifetime controller for a browser document. */
 export declare function ensureSidebarScrollPreserve(options?: SidebarScrollPreserveOptions): void;
+/** The sidebar island calls this after the destination tree has committed. */
+export declare function notifySidebarScrollReady(root: Element): void;
 /** Test/HMR teardown for a controller installed through the singleton wrapper. */
 export declare function disposeSidebarScrollPreserve(document: Document): void;
 export {};