npm - @takazudo/zudo-doc - Versions diffs - 0.1.0 → 0.2.0-next.2 - Mend

@takazudo/zudo-doc 0.1.0 → 0.2.0-next.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (38) hide show

package/dist/body-foot-util/body-foot-util-area.d.ts +1 -1
package/dist/body-foot-util/edit-link.d.ts +1 -1
package/dist/breadcrumb/breadcrumb.d.ts +2 -2
package/dist/code-syntax/code-block-enhancer.d.ts +1 -1
package/dist/code-syntax/mermaid-init.d.ts +1 -1
package/dist/code-syntax/tabs-init.d.ts +1 -1
package/dist/code-syntax/tabs.d.ts +1 -1
package/dist/details/details.d.ts +2 -2
package/dist/doclayout/anchors.d.ts +2 -2
package/dist/doclayout/doc-layout-with-defaults.d.ts +1 -1
package/dist/footer/types.d.ts +1 -1
package/dist/head/doc-head.d.ts +3 -3
package/dist/head/og-tags.d.ts +4 -4
package/dist/header/header.d.ts +1 -1
package/dist/header/nav-active.d.ts +1 -1
package/dist/html-preview-wrapper/html-preview-wrapper.d.ts +9 -12
package/dist/i18n-version/version-switcher.d.ts +1 -1
package/dist/integrations/llms-txt/load.js +1 -0
package/dist/integrations/search-index/content-files.js +1 -0
package/dist/integrations/search-index/types.d.ts +1 -1
package/dist/metainfo/doc-metainfo.d.ts +2 -2
package/dist/metainfo/doc-tags.d.ts +5 -5
package/dist/metainfo/frontmatter-preview.d.ts +1 -1
package/dist/nav-indexing/category-nav.d.ts +1 -1
package/dist/nav-indexing/category-tree-nav.d.ts +1 -1
package/dist/nav-indexing/doc-card-grid.d.ts +1 -1
package/dist/nav-indexing/docs-sitemap.d.ts +1 -1
package/dist/nav-indexing/nav-card-grid.d.ts +1 -1
package/dist/nav-indexing/site-tree-nav-demo.d.ts +1 -1
package/dist/nav-indexing/tag-nav.d.ts +1 -1
package/dist/nav-indexing/versions-page-content.d.ts +1 -1
package/dist/sidebar/sidebar.d.ts +1 -1
package/dist/sidebar/types.d.ts +1 -1
package/dist/sidebar-resizer/index.d.ts +1 -1
package/dist/sidebar-resizer/index.js +13 -5
package/dist/sidebar-resizer/sidebar-resizer-init.d.ts +21 -1
package/dist/sidebar-resizer/sidebar-resizer-init.js +25 -3
package/package.json +6 -6

package/dist/body-foot-util/body-foot-util-area.d.ts CHANGED Viewed

@@ -43,7 +43,7 @@ interface BodyFootUtilAreaProps {
 /**
  * Footer utility area shown below an article body — composes the
  * "View source on GitHub" link and the host-supplied doc-history
- * island. JSX port of `src/components/body-foot-util-area.astro`.
+ * island. JSX port of the legacy `body-foot-util-area` component.
  *
  * Returns `null` when neither slot has anything to render, mirroring
  * the `hasContent && (...)` guard in the original template so the

package/dist/body-foot-util/edit-link.d.ts CHANGED Viewed

@@ -33,7 +33,7 @@ interface EditLinkProps {
     label?: string;
 }
 /**
- * "Edit this page" link — JSX port of `src/components/edit-link.astro`.
+ * "Edit this page" link — JSX port of the legacy `edit-link` component.
  *
  * The legacy component owned three concerns: URL computation, i18n
  * lookup, and presentation. v2 keeps only presentation; URL and label

package/dist/breadcrumb/breadcrumb.d.ts CHANGED Viewed

@@ -42,14 +42,14 @@ interface BreadcrumbProps {
     rightSlot?: ComponentChildren;
 }
 /**
- * Breadcrumb trail — JSX port of src/components/breadcrumb.astro.
+ * Breadcrumb trail component.
  *
  * Two usage shapes:
  *   1. Pass pre-built `items` (existing call-sites that already
  *      compute crumbs upstream).
  *   2. Pass `tree` + `currentId` and the component derives the trail.
  *
- * Returns null when no items resolve, matching the Astro template's
+ * Returns null when no items resolve, matching the documented
  * `items.length > 0 &&` guard.
  */
 declare function Breadcrumb(props: BreadcrumbProps): VNode | null;

package/dist/code-syntax/code-block-enhancer.d.ts CHANGED Viewed

@@ -4,7 +4,7 @@ import { JSX } from 'preact';
 /** @jsxImportSource preact */
 /**
- * Drop-in JSX replacement for `src/components/code-block-enhancer.astro`.
+ * Drop-in JSX replacement for the legacy `code-block-enhancer` component.
  *
  * Include **once** in the layout. Renders the screen-reader announce region
  * and emits the code-block enhancer init script via `dangerouslySetInnerHTML`.

package/dist/code-syntax/mermaid-init.d.ts CHANGED Viewed

@@ -31,7 +31,7 @@ interface MermaidInitProps {
     script?: string;
 }
 /**
- * Drop-in JSX replacement for `src/components/mermaid-init.astro`.
+ * Drop-in JSX replacement for the legacy `mermaid-init` component.
  *
  * Include **once** in the layout. Emits the mermaid init script via
  * `dangerouslySetInnerHTML`. The script lazily imports mermaid only when

package/dist/code-syntax/tabs-init.d.ts CHANGED Viewed

@@ -4,7 +4,7 @@ import { JSX } from 'preact';
 /** @jsxImportSource preact */
 /**
- * Drop-in JSX replacement for `src/components/tabs-init.astro`.
+ * Drop-in JSX replacement for the legacy `tabs-init` component.
  *
  * Include **once** in the layout (e.g. in the `<body>` foot). Emits the
  * tabs interactivity script via `dangerouslySetInnerHTML`.

package/dist/code-syntax/tabs.d.ts CHANGED Viewed

@@ -14,7 +14,7 @@ interface TabsProps {
     children?: ComponentChildren;
 }
 /**
- * Server-rendered tab container — JSX port of `src/components/tabs.astro`.
+ * Server-rendered tab container — JSX port of the legacy `tabs` component.
  *
  * Iterates `children` via `toChildArray` to discover `<TabItem>` elements
  * and renders their labels as `<button>` elements in the tab nav bar.

package/dist/details/details.d.ts CHANGED Viewed

@@ -7,7 +7,7 @@ interface DetailsProps {
     /**
      * Summary / toggle label shown in the `<summary>` element.
      * Defaults to `"Details"` — the same fallback used by the legacy
-     * `src/components/details.astro`.
+     * `src/components/details`.
      */
     title?: string;
     /** Slot content rendered inside the collapsed body. */
@@ -15,7 +15,7 @@ interface DetailsProps {
 }
 /**
  * Collapsible `<details>` / `<summary>` block — JSX port of
- * `src/components/details.astro`.
+ * `src/components/details`.
  *
  * Keeps layout and token classes identical to the original template.
  * The legacy component used Astro's `<slot />`; v2 accepts standard

package/dist/doclayout/anchors.d.ts CHANGED Viewed

@@ -22,7 +22,7 @@ interface DocLayoutAnchor {
 }
 /**
  * The 16 doc-layout anchors, in the order they appear in a scaffolded
- * `doc-layout.astro`. Order is informational (useful for the drift
+ * doc-layout file. Order is informational (useful for the drift
  * checker's diagnostic output); identity is what matters.
  */
 declare const DOC_LAYOUT_ANCHORS: readonly DocLayoutAnchor[];
@@ -43,7 +43,7 @@ declare function anchorComment(anchor: DocLayoutAnchor): string;
 /**
  * Convenience: every anchor's comment string, in declaration order. The
  * drift checker can iterate this and assert each substring appears in the
- * scaffolded `doc-layout.astro`.
+ * scaffolded doc-layout file.
  */
 declare function allAnchorComments(): readonly string[];
 /**

package/dist/doclayout/doc-layout-with-defaults.d.ts CHANGED Viewed

@@ -74,7 +74,7 @@ interface DocLayoutWithDefaultsProps extends Omit<DocLayoutProps, "header" | "si
  *
  * The body of this component contains every body-region injection
  * anchor as a JSX comment expression, so a literal-substring drift
- * check between this file and the scaffolded `doc-layout.astro` will
+ * check between this file and the scaffolded doc-layout file will
  * find each anchor in both places. JSX comment expressions are
  * compile-time-only and do not affect runtime output.
  */

package/dist/footer/types.d.ts CHANGED Viewed

@@ -1,7 +1,7 @@
 /**
  * Public types for the framework-agnostic footer shell.
  *
- * The original Astro `footer.astro` mixed three concerns:
+ * The original footer template mixed three concerns:
  *   1. Reading `settings.footer` and applying locale overrides.
  *   2. Loading the docs collection + tag vocabulary to build the
  *      optional taglist columns.

package/dist/head/doc-head.d.ts CHANGED Viewed

@@ -8,9 +8,9 @@ import { HeadProps } from './types.js';
  * panel, etc.) are owned by other topic folders and composed by the host
  * layout alongside this primitive.
  *
- * Output order is fixed and matches the existing src/layouts/doc-layout.astro
- * emission so head HTML stays byte-identical (modulo asset hashes) to the
- * pre-migration build for any fixture page:
+ * Output order is fixed and matches the legacy doc-layout emission so head
+ * HTML stays byte-identical (modulo asset hashes) to the pre-migration
+ * build for any fixture page:
  *
  *   1. <meta charset>
  *   2. <meta name="viewport">

package/dist/head/og-tags.d.ts CHANGED Viewed

@@ -5,10 +5,10 @@ import { HeadProps } from './types.js';
  * Open Graph meta tags. Emits og:title (always — defaults to `title`) plus
  * any other og:* fields the caller has supplied.
  *
- * Output order matches the order in src/layouts/doc-layout.astro for byte
- * parity: og:title → og:description → og:type → og:url → og:image →
- * og:site_name. New og:* tags should be appended at the end of the list,
- * never reordered, to keep snapshot diffs minimal.
+ * Output order matches the legacy doc-layout emission for byte parity:
+ * og:title → og:description → og:type → og:url → og:image → og:site_name.
+ * New og:* tags should be appended at the end of the list, never reordered,
+ * to keep snapshot diffs minimal.
  */
 declare function OgTags(props: {
     title: string;

package/dist/header/header.d.ts CHANGED Viewed

@@ -139,7 +139,7 @@ interface HeaderProps {
     i18n: HeaderI18n;
 }
 /**
- * Site-header shell — JSX port of `src/components/header.astro`.
+ * Site-header shell — JSX port of `src/components/header`.
  *
  * Responsibilities (matching the legacy template byte-for-byte):
  *   1. Render the sticky `<header>` with the site logo and the desktop

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

@@ -8,7 +8,7 @@ interface NavItemLike {
 /**
  * Strip the locale prefix from `pathWithoutBase` when the page is being
  * served under a non-default locale. Mirrors the inline regex inside
- * `header.astro` so the JSX port matches the legacy template's
+ * `header` so the JSX port matches the legacy template's
  * active-link behaviour.
  *
  * Examples:

package/dist/html-preview-wrapper/html-preview-wrapper.d.ts CHANGED Viewed

@@ -23,9 +23,9 @@ interface HtmlPreviewWrapperProps {
      * `head`, `css`, and `js` are prepended to the per-usage values so
      * that global styles/scripts apply to every preview.
      *
-     * The legacy `html-preview-wrapper.astro` read this directly from
-     * `settings`; v2 accepts it as a prop so the component has no
-     * upward dependency on the project settings module.
+     * The legacy html-preview-wrapper read this directly from `settings`;
+     * v2 accepts it as a prop so the component has no upward dependency
+     * on the project settings module.
      */
     globalConfig?: HtmlPreviewGlobalConfig | null;
     /** HTML body content to display in the iframe. */
@@ -44,16 +44,13 @@ interface HtmlPreviewWrapperProps {
     defaultOpen?: boolean;
 }
 /**
- * HTML preview wrapper — JSX port of
- * `src/components/html-preview-wrapper.astro`.
+ * HTML preview wrapper component.
  *
- * The legacy Astro wrapper merged `settings.htmlPreview` (global config)
- * with per-usage props and forwarded everything to `<HtmlPreview
- * client:visible />`. v2 collapses the merge into the inner shell and
- * wraps it in `<Island when="visible">` here, mirroring the legacy
- * `client:visible` hydration timing — the iframe is heavy and not on
- * the critical path, so we defer hydration until the preview enters
- * the viewport.
+ * Merges `settings.htmlPreview` (global config) with per-usage props and
+ * forwards everything to `<HtmlPreview>`. Wraps it in
+ * `<Island when="visible">`, mirroring the legacy `client:visible`
+ * hydration timing — the iframe is heavy and not on the critical path,
+ * so we defer hydration until the preview enters the viewport.
  */
 declare function HtmlPreviewWrapper(props: HtmlPreviewWrapperProps): VNode;

package/dist/i18n-version/version-switcher.d.ts CHANGED Viewed

@@ -104,7 +104,7 @@ declare function VersionSwitcher(props: VersionSwitcherProps): VNode;
  * full vocabulary rationale.
  *
  * Lifted from the `<script>` block of the original
- * version-switcher.astro; behaviour is unchanged modulo the lifecycle
+ * version-switcher; behaviour is unchanged modulo the lifecycle
  * vocabulary swap.
  */
 declare const VERSION_SWITCHER_INIT_SCRIPT: string;

package/dist/integrations/llms-txt/load.js CHANGED Viewed

@@ -14,6 +14,7 @@ function collectMdFiles(dir) {
     for (const entry of entries) {
       const fullPath = join(currentDir, entry.name);
       if (entry.isDirectory()) {
+        if (entry.name.startsWith("_")) continue;
         walk(fullPath, baseDir);
       } else if (/\.mdx?$/.test(entry.name) && !entry.name.startsWith("_")) {
         const rel = relative(baseDir, fullPath).replace(/\.mdx?$/, "").replace(/\/index$/, "");

package/dist/integrations/search-index/content-files.js CHANGED Viewed

@@ -16,6 +16,7 @@ function collectMdFiles(dir) {
     for (const entry of entries) {
       const fullPath = join(currentDir, entry.name);
       if (entry.isDirectory()) {
+        if (entry.name.startsWith("_")) continue;
         walk(fullPath, baseDir);
       } else if (/\.mdx?$/.test(entry.name) && !entry.name.startsWith("_")) {
         const rel = relative(baseDir, fullPath).replace(/\.mdx?$/, "").replace(/\/index$/, "");

package/dist/integrations/search-index/types.d.ts CHANGED Viewed

@@ -1,7 +1,7 @@
 /**
  * One page in the search index. The shape mirrors today's Astro
  * integration output verbatim — keep it byte-identical so downstream
- * consumers (search.astro client island and packages/search-worker via
+ * consumers (the search client island and packages/search-worker via
  * MiniSearch) keep working unchanged after the zfb cutover.
  */
 interface SearchIndexEntry {

package/dist/metainfo/doc-metainfo.d.ts CHANGED Viewed

@@ -6,7 +6,7 @@ import { VNode } from 'preact';
 interface DocMetainfoProps {
     /**
      * Pre-formatted creation date string (e.g. `"Jan 1, 2024"`).
-     * The legacy `doc-metainfo.astro` called `formatDate(gitInfo.createdAt,
+     * The legacy `doc-metainfo` called `formatDate(gitInfo.createdAt,
      * locale)` inline; v2 delegates that computation to the caller.
      * Omit (or pass `null`) to suppress the "created" row.
      */
@@ -35,7 +35,7 @@ declare const DEFAULT_CREATED_LABEL = "Created";
 declare const DEFAULT_UPDATED_LABEL = "Updated";
 /**
  * Document meta-information strip (created date, updated date, author)
- * — JSX port of `src/components/doc-metainfo.astro`.
+ * — JSX port of `src/components/doc-metainfo`.
  *
  * The legacy component owned three responsibilities: reading
  * `settings.docMetainfo`, calling `getGitInfo(filePath)`, and

package/dist/metainfo/doc-tags.d.ts CHANGED Viewed

@@ -5,7 +5,7 @@ import { VNode } from 'preact';
 /**
  * A single resolved tag with its navigation href. The legacy
- * `doc-tags.astro` called `resolvePageTags(tags)` and used `TagNav`
+ * `doc-tags` called `resolvePageTags(tags)` and used `TagNav`
  * which computed `tagHref()` internally. v2 delegates both to the
  * caller so the component has no upward dependency on project routing
  * utilities.
@@ -18,7 +18,7 @@ interface ResolvedTag {
 }
 /**
  * Controls vertical spacing: matches the `placement` prop on the
- * legacy `doc-tags.astro` component.
+ * legacy `doc-tags` component.
  *
  * - `"after-title"` — tight top margin, bottom margin to separate from
  *   the body (`mt-0 mb-vsp-md`).
@@ -52,14 +52,14 @@ interface DocTagsProps {
 declare const DEFAULT_TAGS_LABEL = "Tags";
 declare const DEFAULT_TAGGED_WITH_LABEL = "Tagged with";
 /**
- * Page-level tag chips — JSX port of `src/components/doc-tags.astro`
- * (page-variant rendering from `src/components/tag-nav.astro`).
+ * Page-level tag chips — JSX port of `src/components/doc-tags`
+ * (page-variant rendering from `src/components/tag-nav`).
  *
  * Returns `null` when the `tags` array is empty, matching the original
  * `resolvedTags.length > 0` guard.
  *
  * The pointed-chip shape is reproduced verbatim from the page-variant
- * branch of `tag-nav.astro` using the same `clip-path` values.
+ * branch of `tag-nav` using the same `clip-path` values.
  */
 declare function DocTags(props: DocTagsProps): VNode | null;

package/dist/metainfo/frontmatter-preview.d.ts CHANGED Viewed

@@ -81,7 +81,7 @@ declare const DEFAULT_KEY_COL_LABEL = "Key";
 declare const DEFAULT_VALUE_COL_LABEL = "Value";
 /**
  * Frontmatter data table — JSX port of
- * `src/components/frontmatter-preview.astro`.
+ * `src/components/frontmatter-preview`.
  *
  * Returns `null` when `entries` is empty, mirroring the original
  * `entries.length > 0` guard.

package/dist/nav-indexing/category-nav.d.ts CHANGED Viewed

@@ -15,7 +15,7 @@ interface CategoryNavProps {
     class?: string;
 }
 /**
- * CategoryNav — JSX port of `src/components/category-nav.astro`.
+ * CategoryNav — JSX port of `src/components/category-nav`.
  *
  * Renders direct children of a category as a two-column grid of card links.
  * Each card shows the node's label (with an arrow icon) and an optional

package/dist/nav-indexing/category-tree-nav.d.ts CHANGED Viewed

@@ -14,7 +14,7 @@ interface CategoryTreeNavProps {
     maxDepth?: number;
 }
 /**
- * CategoryTreeNav — JSX port of `src/components/category-tree-nav.astro`.
+ * CategoryTreeNav — JSX port of `src/components/category-tree-nav`.
  *
  * Renders the children of a category as a recursive disc-bulleted list. Links
  * are rendered for nodes that have a page; plain text for structural nodes.

package/dist/nav-indexing/doc-card-grid.d.ts CHANGED Viewed

@@ -21,7 +21,7 @@ interface DocCardGridProps {
     class?: string;
 }
 /**
- * DocCardGrid — JSX port of `src/components/doc-card-grid.astro`.
+ * DocCardGrid — JSX port of `src/components/doc-card-grid`.
  *
  * Renders a flat list of `{ href, title, description? }` items as a two-column
  * card grid. Each card shows an arrow icon, the doc title, and an optional

package/dist/nav-indexing/docs-sitemap.d.ts CHANGED Viewed

@@ -12,7 +12,7 @@ interface DocsSitemapProps {
     tree: NavNode[];
 }
 /**
- * DocsSitemap — JSX port of `src/components/docs-sitemap.astro`.
+ * DocsSitemap — JSX port of `src/components/docs-sitemap`.
  *
  * Renders the full documentation tree as a series of collapsible
  * `<details>` sections. Each top-level node becomes one section; its

package/dist/nav-indexing/nav-card-grid.d.ts CHANGED Viewed

@@ -15,7 +15,7 @@ interface NavCardGridProps {
     class?: string;
 }
 /**
- * NavCardGrid — JSX port of `src/components/nav-card-grid.astro`.
+ * NavCardGrid — JSX port of `src/components/nav-card-grid`.
  *
  * Renders direct children of a category as a two-column grid of card links.
  * Unlike `CategoryNav`, the arrow icon uses `text-accent` and sits inline with

package/dist/nav-indexing/site-tree-nav-demo.d.ts CHANGED Viewed

@@ -23,7 +23,7 @@ interface SiteTreeNavDemoProps {
     ariaLabel?: string;
 }
 /**
- * SiteTreeNavDemo — JSX port of `src/components/site-tree-nav-demo.astro`.
+ * SiteTreeNavDemo — JSX port of `src/components/site-tree-nav-demo`.
  *
  * Renders the full site tree as a static collapsible section-by-section view.
  * Each top-level category becomes a `<details>` block; leaves within each

package/dist/nav-indexing/tag-nav.d.ts CHANGED Viewed

@@ -20,7 +20,7 @@ interface TagNavPageProps {
 }
 type TagNavProps = TagNavAllProps | TagNavPageProps;
 /**
- * TagNav — JSX port of `src/components/tag-nav.astro`.
+ * TagNav — JSX port of `src/components/tag-nav`.
  *
  * Two variants:
  *

package/dist/nav-indexing/versions-page-content.d.ts CHANGED Viewed

@@ -13,7 +13,7 @@ interface VersionsPageContentProps {
     labels: VersionsPageLabels;
 }
 /**
- * VersionsPageContent — JSX port of `src/components/versions-page-content.astro`.
+ * VersionsPageContent — JSX port of `src/components/versions-page-content`.
  *
  * Renders the full documentation versions page:
  *   - An `<h1>` heading (from `labels.pageTitle`).

package/dist/sidebar/sidebar.d.ts CHANGED Viewed

@@ -15,7 +15,7 @@ interface SidebarProps extends SidebarTreeIslandProps {
     /**
      * Pre-rendered tree content — falls back to this when
      * `treeComponent` is omitted. Useful for tests and for layouts that
-     * compose the tree separately (e.g. inside an Astro `.astro` wrapper
+     * compose the tree separately (e.g. inside a host wrapper
      * that needs `client:load` on the actual island element).
      */
     children?: ComponentChildren;

package/dist/sidebar/types.d.ts CHANGED Viewed

@@ -1,7 +1,7 @@
 /**
  * Public types for the framework-agnostic sidebar shell.
  *
- * The original Astro `sidebar.astro` mixed three concerns:
+ * The original `sidebar` mixed three concerns:
  *   1. Building `rootMenuItems` from `settings.headerNav` (with i18n
  *      label resolution and version-aware hrefs).
  *   2. Building the doc tree via `loadLocaleDocs` +

package/dist/sidebar-resizer/index.d.ts CHANGED Viewed

@@ -1,4 +1,4 @@
-export { SIDEBAR_RESIZER_INIT_SCRIPT, SidebarResizerInit } from './sidebar-resizer-init.js';
+export { SIDEBAR_RESIZER_INIT_SCRIPT, SIDEBAR_RESIZER_RESTORE_SCRIPT, SidebarResizerInit, SidebarResizerRestore } from './sidebar-resizer-init.js';
 import 'preact';
 /**

package/dist/sidebar-resizer/index.js CHANGED Viewed

@@ -12,6 +12,7 @@ function initSidebarResizer() {
   if (typeof document === "undefined") return;
   const sidebar = document.getElementById(SIDEBAR_ID);
   if (!sidebar || sidebar.querySelector(`[${HANDLE_MARKER}]`)) return;
+  if (getComputedStyle(sidebar).position !== "fixed") return;
   function readCurrentWidth() {
     const raw = getComputedStyle(document.documentElement).getPropertyValue(
       CSS_PROP
@@ -29,11 +30,11 @@ function initSidebarResizer() {
   handle.setAttribute("aria-valuemax", String(MAX_W));
   handle.setAttribute("aria-valuenow", String(Math.round(cachedWidth)));
   Object.assign(handle.style, {
-    position: "absolute",
-    top: "0",
-    right: "0",
+    position: "fixed",
+    top: "3.5rem",
+    bottom: "0",
+    left: "calc(var(--zd-sidebar-w) - 20px)",
     width: "20px",
-    height: "100%",
     cursor: "col-resize",
     zIndex: "10",
     transition: "background 0.15s"
@@ -157,9 +158,16 @@ function initSidebarResizer() {
   });
   sidebar.appendChild(handle);
 }
-import { SidebarResizerInit, SIDEBAR_RESIZER_INIT_SCRIPT } from "./sidebar-resizer-init.js";
+import {
+  SidebarResizerInit,
+  SIDEBAR_RESIZER_INIT_SCRIPT,
+  SidebarResizerRestore,
+  SIDEBAR_RESIZER_RESTORE_SCRIPT
+} from "./sidebar-resizer-init.js";
 export {
   SIDEBAR_RESIZER_INIT_SCRIPT,
+  SIDEBAR_RESIZER_RESTORE_SCRIPT,
   SidebarResizerInit,
+  SidebarResizerRestore,
   initSidebarResizer
 };

package/dist/sidebar-resizer/sidebar-resizer-init.d.ts CHANGED Viewed

@@ -17,4 +17,24 @@ declare const SIDEBAR_RESIZER_INIT_SCRIPT: string;
  */
 declare function SidebarResizerInit(): JSX.Element;
-export { SIDEBAR_RESIZER_INIT_SCRIPT, SidebarResizerInit, SidebarResizerInit as default };
+declare const SIDEBAR_RESIZER_RESTORE_SCRIPT = "(function(){try{var w=localStorage.getItem(\"zudo-doc-sidebar-width\");if(!w)return;var n=parseFloat(w);if(!isFinite(n))return;if(n<192)n=192;else if(n>448)n=448;document.documentElement.style.setProperty(\"--zd-sidebar-w\",n+\"px\");}catch(e){}})();";
+/**
+ * Drop-in JSX `<head>` script that restores the persisted sidebar width
+ * before first paint.
+ *
+ * Include once in the page `<head>` (gated on `settings.sidebarResizer`)
+ * — placement in `<head>` is what makes this run before the body is
+ * parsed, eliminating the resize-flash on reload. Body-end placement is
+ * too late: the browser will have already painted at the CSS default.
+ *
+ * The script is a tiny synchronous IIFE that:
+ *   - reads `localStorage["zudo-doc-sidebar-width"]`,
+ *   - validates it as a finite number clamped to [MIN_W, MAX_W],
+ *   - sets `--zd-sidebar-w` on `document.documentElement.style`.
+ *
+ * It silently no-ops in privacy / disabled-storage modes (try/catch),
+ * matches the resilience of the runtime `applyWidth` writer.
+ */
+declare function SidebarResizerRestore(): JSX.Element;
+export { SIDEBAR_RESIZER_INIT_SCRIPT, SIDEBAR_RESIZER_RESTORE_SCRIPT, SidebarResizerInit, SidebarResizerRestore, SidebarResizerInit as default };

package/dist/sidebar-resizer/sidebar-resizer-init.js CHANGED Viewed

@@ -14,6 +14,11 @@ const SIDEBAR_RESIZER_INIT_SCRIPT = `(function(){
     if(typeof document==="undefined")return;
     var sidebar=document.getElementById(SIDEBAR_ID);
     if(!sidebar||sidebar.querySelector("["+HANDLE_MARKER+"]"))return;
+    // Only attach to the real fixed desktop panel. On hide_sidebar pages the
+    // aside renders sr-only (position:absolute) purely for the ARIA landmark; a
+    // position:fixed handle would escape sr-only's clip and show a stray strip
+    // (below lg the panel is display:none but still fixed \u2014 handle appended, not rendered). zudolab/zudo-doc#1821
+    if(getComputedStyle(sidebar).position!=="fixed")return;
     function readCurrentWidth(){
       var raw=getComputedStyle(document.documentElement).getPropertyValue(CSS_PROP);
@@ -30,9 +35,15 @@ const SIDEBAR_RESIZER_INIT_SCRIPT = `(function(){
     handle.setAttribute("aria-valuemin",String(MIN_W));
     handle.setAttribute("aria-valuemax",String(MAX_W));
     handle.setAttribute("aria-valuenow",String(Math.round(cachedWidth)));
-    // 20px hit area > native y-scrollbar (~12-17px) so a draggable strip stays
-    // visible to the LEFT of the scrollbar when sidebar overflows. zudolab/zudo-doc#1660
-    Object.assign(handle.style,{position:"absolute",top:"0",right:"0",width:"20px",height:"100%",cursor:"col-resize",zIndex:"10",transition:"background 0.15s"});
+    // position:fixed (not absolute) pins the handle to the viewport so it spans
+    // the sidebar's full height even while #desktop-sidebar scrolls. As an
+    // absolute child of the overflow-y:auto sidebar it scrolled away with the
+    // content and height:100% only covered the visible padding box. zudolab/zudo-doc#1821
+    // top:3.5rem + left:calc mirror the layout's #desktop-sidebar geometry
+    // (top-[3.5rem], left:0, width:var(--zd-sidebar-w)). 20px hit area > native
+    // y-scrollbar (~12-17px) keeps a draggable strip left of the scrollbar when
+    // the sidebar overflows. zudolab/zudo-doc#1660
+    Object.assign(handle.style,{position:"fixed",top:"3.5rem",bottom:"0",left:"calc(var(--zd-sidebar-w) - 20px)",width:"20px",cursor:"col-resize",zIndex:"10",transition:"background 0.15s"});
     var dragging=false,focused=false;
@@ -112,8 +123,19 @@ function SidebarResizerInit() {
   return /* @__PURE__ */ jsx("script", { dangerouslySetInnerHTML: { __html: SIDEBAR_RESIZER_INIT_SCRIPT } });
 }
 var sidebar_resizer_init_default = SidebarResizerInit;
+const SIDEBAR_RESIZER_RESTORE_SCRIPT = `(function(){try{var w=localStorage.getItem("zudo-doc-sidebar-width");if(!w)return;var n=parseFloat(w);if(!isFinite(n))return;if(n<192)n=192;else if(n>448)n=448;document.documentElement.style.setProperty("--zd-sidebar-w",n+"px");}catch(e){}})();`;
+function SidebarResizerRestore() {
+  return /* @__PURE__ */ jsx(
+    "script",
+    {
+      dangerouslySetInnerHTML: { __html: SIDEBAR_RESIZER_RESTORE_SCRIPT }
+    }
+  );
+}
 export {
   SIDEBAR_RESIZER_INIT_SCRIPT,
+  SIDEBAR_RESIZER_RESTORE_SCRIPT,
   SidebarResizerInit,
+  SidebarResizerRestore,
   sidebar_resizer_init_default as default
 };

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zudo-doc",
-  "version": "0.1.0",
+  "version": "0.2.0-next.2",
   "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",
@@ -154,9 +154,9 @@
   ],
   "peerDependencies": {
     "preact": "^10.29.1",
-    "@takazudo/zfb": "^0.1.0-next.6",
-    "@takazudo/zfb-runtime": "^0.1.0-next.6",
-    "@takazudo/zudo-doc-history-server": "^0.1.0"
+    "@takazudo/zfb": "^0.1.0-next.25",
+    "@takazudo/zfb-runtime": "^0.1.0-next.25",
+    "@takazudo/zudo-doc-history-server": "^0.2.0-next.2"
   },
   "peerDependenciesMeta": {
     "@takazudo/zudo-doc-history-server": {
@@ -174,8 +174,8 @@
     "tsup": "^8.0.0",
     "typescript": "^5.0.0",
     "vitest": "^3.0.0",
-    "@takazudo/zfb": "0.1.0-next.6",
-    "@takazudo/zfb-runtime": "0.1.0-next.6"
+    "@takazudo/zfb": "0.1.0-next.25",
+    "@takazudo/zfb-runtime": "0.1.0-next.25"
   },
   "scripts": {
     "build": "cross-env NODE_OPTIONS=--max-old-space-size=4096 tsup",