@takazudo/zudo-doc 0.2.20 → 0.2.22

package/dist/color-scheme-utils.js

@@ -0,0 +1,151 @@
+const SEMANTIC_DEFAULTS = {
+  surface: 0,
+  muted: 8,
+  accent: 5,
+  accentHover: 14,
+  codeBg: 10,
+  codeFg: 11,
+  success: 2,
+  danger: 1,
+  warning: 3,
+  info: 4,
+  mermaidNodeBg: 9,
+  mermaidText: 11,
+  mermaidLine: 8,
+  mermaidLabelBg: 10,
+  mermaidNoteBg: 0,
+  chatUserBg: 5,
+  chatUserText: 9,
+  chatAssistantBg: 9,
+  chatAssistantText: 11,
+  imageOverlayBg: 0,
+  imageOverlayFg: 11,
+  matchedKeywordBg: 3,
+  matchedKeywordFg: 15
+};
+const SEMANTIC_CSS_NAMES = {
+  surface: "--zd-surface",
+  muted: "--zd-muted",
+  accent: "--zd-accent",
+  accentHover: "--zd-accent-hover",
+  codeBg: "--zd-code-bg",
+  codeFg: "--zd-code-fg",
+  success: "--zd-success",
+  danger: "--zd-danger",
+  warning: "--zd-warning",
+  info: "--zd-info",
+  mermaidNodeBg: "--zd-mermaid-node-bg",
+  mermaidText: "--zd-mermaid-text",
+  mermaidLine: "--zd-mermaid-line",
+  mermaidLabelBg: "--zd-mermaid-label-bg",
+  mermaidNoteBg: "--zd-mermaid-note-bg",
+  chatUserBg: "--zd-chat-user-bg",
+  chatUserText: "--zd-chat-user-text",
+  chatAssistantBg: "--zd-chat-assistant-bg",
+  chatAssistantText: "--zd-chat-assistant-text",
+  imageOverlayBg: "--zd-image-overlay-bg",
+  imageOverlayFg: "--zd-image-overlay-fg",
+  matchedKeywordBg: "--zd-matched-keyword-bg",
+  matchedKeywordFg: "--zd-matched-keyword-fg"
+};
+function resolveColor(value, palette, fallback) {
+  if (value === void 0) return fallback;
+  if (typeof value === "number") return palette[value] ?? fallback;
+  return value;
+}
+function resolveSemanticColors(scheme) {
+  const p = scheme.palette;
+  return {
+    surface: resolveColor(scheme.semantic?.surface, p, p[0]),
+    muted: resolveColor(scheme.semantic?.muted, p, p[8]),
+    accent: resolveColor(scheme.semantic?.accent, p, p[5]),
+    accentHover: resolveColor(scheme.semantic?.accentHover, p, p[14]),
+    codeBg: resolveColor(scheme.semantic?.codeBg, p, p[10]),
+    codeFg: resolveColor(scheme.semantic?.codeFg, p, p[11]),
+    success: resolveColor(scheme.semantic?.success, p, p[2]),
+    danger: resolveColor(scheme.semantic?.danger, p, p[1]),
+    warning: resolveColor(scheme.semantic?.warning, p, p[3]),
+    info: resolveColor(scheme.semantic?.info, p, p[4]),
+    mermaidNodeBg: resolveColor(scheme.semantic?.mermaidNodeBg, p, p[9]),
+    mermaidText: resolveColor(scheme.semantic?.mermaidText, p, p[11]),
+    mermaidLine: resolveColor(scheme.semantic?.mermaidLine, p, p[8]),
+    mermaidLabelBg: resolveColor(scheme.semantic?.mermaidLabelBg, p, p[10]),
+    mermaidNoteBg: resolveColor(scheme.semantic?.mermaidNoteBg, p, p[0]),
+    chatUserBg: resolveColor(scheme.semantic?.chatUserBg, p, p[5]),
+    chatUserText: resolveColor(scheme.semantic?.chatUserText, p, p[9]),
+    chatAssistantBg: resolveColor(scheme.semantic?.chatAssistantBg, p, p[9]),
+    chatAssistantText: resolveColor(scheme.semantic?.chatAssistantText, p, p[11]),
+    imageOverlayBg: resolveColor(scheme.semantic?.imageOverlayBg, p, p[0]),
+    imageOverlayFg: resolveColor(scheme.semantic?.imageOverlayFg, p, p[11]),
+    matchedKeywordBg: resolveColor(scheme.semantic?.matchedKeywordBg, p, p[3]),
+    matchedKeywordFg: resolveColor(scheme.semantic?.matchedKeywordFg, p, p[15])
+  };
+}
+function schemeToCssPairs(scheme) {
+  const p = scheme.palette;
+  const sem = resolveSemanticColors(scheme);
+  return [
+    ["--zd-bg", resolveColor(scheme.background, p, p[0])],
+    ["--zd-fg", resolveColor(scheme.foreground, p, p[15])],
+    ["--zd-cursor", resolveColor(scheme.cursor, p, p[6])],
+    // intentionally inert/vestigial: exposed in the design-token panel but no CSS rule consumes it (no caret-color wiring); mirrors shikiTheme's status
+    ["--zd-sel-bg", resolveColor(scheme.selectionBg, p, resolveColor(scheme.background, p, p[0]))],
+    ["--zd-sel-fg", resolveColor(scheme.selectionFg, p, resolveColor(scheme.foreground, p, p[15]))],
+    ...p.map((color, i) => [`--zd-${i}`, color]),
+    ["--zd-surface", sem.surface],
+    ["--zd-muted", sem.muted],
+    ["--zd-accent", sem.accent],
+    ["--zd-accent-hover", sem.accentHover],
+    ["--zd-code-bg", sem.codeBg],
+    ["--zd-code-fg", sem.codeFg],
+    ["--zd-success", sem.success],
+    ["--zd-danger", sem.danger],
+    ["--zd-warning", sem.warning],
+    ["--zd-info", sem.info],
+    ["--zd-mermaid-node-bg", sem.mermaidNodeBg],
+    ["--zd-mermaid-text", sem.mermaidText],
+    ["--zd-mermaid-line", sem.mermaidLine],
+    ["--zd-mermaid-label-bg", sem.mermaidLabelBg],
+    ["--zd-mermaid-note-bg", sem.mermaidNoteBg],
+    ["--zd-chat-user-bg", sem.chatUserBg],
+    ["--zd-chat-user-text", sem.chatUserText],
+    ["--zd-chat-assistant-bg", sem.chatAssistantBg],
+    ["--zd-chat-assistant-text", sem.chatAssistantText],
+    ["--zd-image-overlay-bg", sem.imageOverlayBg],
+    ["--zd-image-overlay-fg", sem.imageOverlayFg],
+    ["--zd-matched-keyword-bg", sem.matchedKeywordBg],
+    ["--zd-matched-keyword-fg", sem.matchedKeywordFg]
+  ];
+}
+function generateCssCustomProperties(scheme) {
+  const pairs = schemeToCssPairs(scheme);
+  const lines = [":root {", ...pairs.map(([prop, value]) => `  ${prop}: ${value};`), "}"];
+  return lines.join("\n");
+}
+function generateLightDarkCssProperties(light, dark) {
+  const lightPairs = schemeToCssPairs(light);
+  const darkPairs = schemeToCssPairs(dark);
+  if (lightPairs.length !== darkPairs.length) {
+    throw new Error(`Light scheme has ${lightPairs.length} properties but dark scheme has ${darkPairs.length}`);
+  }
+  const lines = [":root {", "  color-scheme: light dark;"];
+  for (let i = 0; i < lightPairs.length; i++) {
+    const lightPair = lightPairs[i];
+    const darkPair = darkPairs[i];
+    if (!lightPair || !darkPair) continue;
+    const [prop, lightVal] = lightPair;
+    const darkVal = darkPair[1];
+    lines.push(`  ${prop}: light-dark(${lightVal}, ${darkVal});`);
+  }
+  lines.push("}");
+  return lines.join("\n");
+}
+export {
+  SEMANTIC_CSS_NAMES,
+  SEMANTIC_DEFAULTS,
+  generateCssCustomProperties,
+  generateLightDarkCssProperties,
+  resolveColor,
+  resolveSemanticColors,
+  schemeToCssPairs
+};

package/dist/compose-meta-title/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Create a `composeMetaTitle` helper bound to the given site name.
+ *
+ * Mirrors the shape of `makeUrlHelpers` (S1a) — the host stub calls this
+ * once with its concrete `settings.siteName` and re-exports the result.
+ */
+export declare function createComposeMetaTitle(siteName: string): (title: string) => string;

package/dist/compose-meta-title/index.js

@@ -0,0 +1,10 @@
+function createComposeMetaTitle(siteName) {
+  return function composeMetaTitle(title) {
+    if (!siteName) return title;
+    if (title === siteName) return siteName;
+    return `${title} | ${siteName}`;
+  };
+}
+export {
+  createComposeMetaTitle
+};

package/dist/content/component-map.d.ts

@@ -1,16 +1,14 @@
-import { HeadingH2 } from './heading-h2.js';
-import { HeadingH3 } from './heading-h3.js';
-import { HeadingH4 } from './heading-h4.js';
-import { ContentParagraph } from './content-paragraph.js';
-import { ContentLink } from './content-link.js';
-import { ContentStrong } from './content-strong.js';
-import { ContentBlockquote } from './content-blockquote.js';
-import { ContentUl } from './content-ul.js';
-import { ContentOl } from './content-ol.js';
-import { ContentTable } from './content-table.js';
-import { ContentCode } from './content-code.js';
-import 'preact';
-
+import { HeadingH2 } from "./heading-h2.js";
+import { HeadingH3 } from "./heading-h3.js";
+import { HeadingH4 } from "./heading-h4.js";
+import { ContentParagraph } from "./content-paragraph.js";
+import { ContentLink } from "./content-link.js";
+import { ContentStrong } from "./content-strong.js";
+import { ContentBlockquote } from "./content-blockquote.js";
+import { ContentUl } from "./content-ul.js";
+import { ContentOl } from "./content-ol.js";
+import { ContentTable } from "./content-table.js";
+import { ContentCode } from "./content-code.js";
 /**
  * MDX component overrides map for the HTML elements used in doc content.
  *
@@ -18,7 +16,7 @@ import 'preact';
  * into a larger components object that also includes admonition overrides,
  * custom shortcodes, etc.) at the Astro page layer.
  */
-declare const htmlOverrides: {
+export declare const htmlOverrides: {
     h2: typeof HeadingH2;
     h3: typeof HeadingH3;
     h4: typeof HeadingH4;
@@ -34,7 +32,7 @@ declare const htmlOverrides: {
 /**
  * Alias for `htmlOverrides`. Prefer this name in new consumer code.
  */
-declare const defaultComponents: {
+export declare const defaultComponents: {
     h2: typeof HeadingH2;
     h3: typeof HeadingH3;
     h4: typeof HeadingH4;
@@ -47,5 +45,3 @@ declare const defaultComponents: {
     table: typeof ContentTable;
     code: typeof ContentCode;
 };
-
-export { defaultComponents, htmlOverrides };

package/dist/content/content-blockquote.d.ts

@@ -1,9 +1,6 @@
-import { JSX } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { JSX } from "preact";
 type Props = JSX.IntrinsicElements["blockquote"];
-declare function ContentBlockquote({ children, className, ...rest }: Props): JSX.Element;
-
-export { ContentBlockquote };
+export declare function ContentBlockquote({ children, className, ...rest }: Props): JSX.Element;
+export {};

package/dist/content/content-code.d.ts

@@ -1,8 +1,6 @@
-import { JSX } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { JSX } from "preact";
 type Props = JSX.IntrinsicElements["code"];
 /**
  * Override for inline `<code>` in MDX. Wraps text-only inline code with
@@ -19,6 +17,5 @@ type Props = JSX.IntrinsicElements["code"];
  * `extractText` unwraps that so the heuristic works regardless of MDX's
  * internal wrapping.
  */
-declare function ContentCode({ children, className, ...rest }: Props): JSX.Element;
-
-export { ContentCode };
+export declare function ContentCode({ children, className, ...rest }: Props): JSX.Element;
+export {};

package/dist/content/content-code.js

@@ -1,5 +1,5 @@
 import { jsx } from "preact/jsx-runtime";
-import { SmartBreak as SmartBreakImpl } from "../toc/smart-break.js";
+import { SmartBreak as SmartBreakImpl } from "../smart-break/index.js";
 const SmartBreak = SmartBreakImpl;
 function ContentCode({ children, className, ...rest }) {
   const isShikiBlock = typeof className === "string" && /(^|\s)language-/.test(className);

package/dist/content/content-link.d.ts

@@ -1,9 +1,6 @@
-import { JSX } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { JSX } from "preact";
 type Props = JSX.IntrinsicElements["a"];
-declare function ContentLink({ href, className, children, ...rest }: Props): JSX.Element;
-
-export { ContentLink };
+export declare function ContentLink({ href, className, children, ...rest }: Props): JSX.Element;
+export {};

package/dist/content/content-link.js

@@ -1,5 +1,5 @@
 import { jsx } from "preact/jsx-runtime";
-import { SmartBreak as SmartBreakBase } from "../toc/smart-break.js";
+import { SmartBreak as SmartBreakBase } from "../smart-break/index.js";
 const SmartBreak = SmartBreakBase;
 function ContentLink({ href, className, children, ...rest }) {
   const classes = typeof className === "string" ? className.split(" ") : [];

package/dist/content/content-ol.d.ts

@@ -1,9 +1,6 @@
-import { JSX } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { JSX } from "preact";
 type Props = JSX.IntrinsicElements["ol"];
-declare function ContentOl({ children, className, ...rest }: Props): JSX.Element;
-
-export { ContentOl };
+export declare function ContentOl({ children, className, ...rest }: Props): JSX.Element;
+export {};

package/dist/content/content-paragraph.d.ts

@@ -1,9 +1,6 @@
-import { JSX } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { JSX } from "preact";
 type Props = JSX.IntrinsicElements["p"];
-declare function ContentParagraph({ children, ...rest }: Props): JSX.Element;
-
-export { ContentParagraph };
+export declare function ContentParagraph({ children, ...rest }: Props): JSX.Element;
+export {};

package/dist/content/content-strong.d.ts

@@ -1,9 +1,6 @@
-import { JSX } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { JSX } from "preact";
 type Props = JSX.IntrinsicElements["strong"];
-declare function ContentStrong({ children, className, ...rest }: Props): JSX.Element;
-
-export { ContentStrong };
+export declare function ContentStrong({ children, className, ...rest }: Props): JSX.Element;
+export {};

package/dist/content/content-table.d.ts

@@ -1,9 +1,6 @@
-import { JSX } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { JSX } from "preact";
 type Props = JSX.IntrinsicElements["table"];
-declare function ContentTable({ children, className, ...rest }: Props): JSX.Element;
-
-export { ContentTable };
+export declare function ContentTable({ children, className, ...rest }: Props): JSX.Element;
+export {};

package/dist/content/content-ul.d.ts

@@ -1,9 +1,6 @@
-import { JSX } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { JSX } from "preact";
 type Props = JSX.IntrinsicElements["ul"];
-declare function ContentUl({ children, className, ...rest }: Props): JSX.Element;
-
-export { ContentUl };
+export declare function ContentUl({ children, className, ...rest }: Props): JSX.Element;
+export {};

package/dist/content/heading-h2.d.ts

@@ -1,9 +1,6 @@
-import { JSX } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { JSX } from "preact";
 type Props = JSX.IntrinsicElements["h2"];
-declare function HeadingH2({ id, children, className, ...rest }: Props): JSX.Element;
-
-export { HeadingH2 };
+export declare function HeadingH2({ id, children, className, ...rest }: Props): JSX.Element;
+export {};

package/dist/content/heading-h3.d.ts

@@ -1,9 +1,6 @@
-import { JSX } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { JSX } from "preact";
 type Props = JSX.IntrinsicElements["h3"];
-declare function HeadingH3({ id, children, className, ...rest }: Props): JSX.Element;
-
-export { HeadingH3 };
+export declare function HeadingH3({ id, children, className, ...rest }: Props): JSX.Element;
+export {};

package/dist/content/heading-h4.d.ts

@@ -1,9 +1,6 @@
-import { JSX } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { JSX } from "preact";
 type Props = JSX.IntrinsicElements["h4"];
-declare function HeadingH4({ id, children, className, ...rest }: Props): JSX.Element;
-
-export { HeadingH4 };
+export declare function HeadingH4({ id, children, className, ...rest }: Props): JSX.Element;
+export {};

package/dist/content/index.d.ts

@@ -1,13 +1,29 @@
-export { HeadingH2 } from './heading-h2.js';
-export { HeadingH3 } from './heading-h3.js';
-export { HeadingH4 } from './heading-h4.js';
-export { ContentParagraph } from './content-paragraph.js';
-export { ContentLink } from './content-link.js';
-export { ContentStrong } from './content-strong.js';
-export { ContentBlockquote } from './content-blockquote.js';
-export { ContentUl } from './content-ul.js';
-export { ContentOl } from './content-ol.js';
-export { ContentTable } from './content-table.js';
-export { ContentCode } from './content-code.js';
-export { defaultComponents, htmlOverrides } from './component-map.js';
-import 'preact';
+/**
+ * Public entry for `@takazudo/zudo-doc/content`.
+ *
+ * Exports the 11 MDX typography override components and the pre-assembled
+ * component map. Consumers compose the map at the Astro page layer:
+ *
+ *   import { defaultComponents } from "@takazudo/zudo-doc/content";
+ *
+ *   const components = {
+ *     ...defaultComponents,
+ *     Note,
+ *     Tip,
+ *     // ... admonitions, shortcodes, etc.
+ *   };
+ *
+ *   <Content components={components} />
+ */
+export { HeadingH2 } from "./heading-h2.js";
+export { HeadingH3 } from "./heading-h3.js";
+export { HeadingH4 } from "./heading-h4.js";
+export { ContentParagraph } from "./content-paragraph.js";
+export { ContentLink } from "./content-link.js";
+export { ContentStrong } from "./content-strong.js";
+export { ContentBlockquote } from "./content-blockquote.js";
+export { ContentUl } from "./content-ul.js";
+export { ContentOl } from "./content-ol.js";
+export { ContentTable } from "./content-table.js";
+export { ContentCode } from "./content-code.js";
+export { htmlOverrides, defaultComponents } from "./component-map.js";

package/dist/content-admonition/index.d.ts

@@ -0,0 +1,15 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+import type { ComponentChildren, VNode } from "preact";
+export type AdmonitionVariant = "note" | "tip" | "info" | "warning" | "danger" | "caution" | "important";
+export interface AdmonitionProps {
+    /** Custom title; falls back to the capitalized variant name (e.g. "Note"). */
+    title?: string;
+    children?: ComponentChildren;
+}
+/**
+ * Build the admonition component for a single variant. The title row is always
+ * rendered — defaulting to the capitalized variant name when the author gives
+ * no `title` — matching the Astro reference where every callout shows a title.
+ */
+export declare function makeAdmonition(variant: AdmonitionVariant): ({ title, children }: AdmonitionProps) => VNode;

package/dist/content-admonition/index.js

@@ -0,0 +1,14 @@
+import { jsx, jsxs } from "preact/jsx-runtime";
+function makeAdmonition(variant) {
+  const defaultTitle = variant.charAt(0).toUpperCase() + variant.slice(1);
+  return function Admonition({ title, children }) {
+    const heading = title && title.length > 0 ? title : defaultTitle;
+    return /* @__PURE__ */ jsxs("div", { "data-admonition": variant, class: `admonition admonition-${variant}`, children: [
+      /* @__PURE__ */ jsx("p", { class: "admonition-title", children: heading }),
+      /* @__PURE__ */ jsx("div", { class: "admonition-body", children })
+    ] });
+  };
+}
+export {
+  makeAdmonition
+};

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

@@ -0,0 +1,38 @@
+/**
+ * Design-token panel (zdtp) WIRING MECHANISM.
+ *
+ * A side-effect module that calls `configurePanel(panelConfig)` and wires
+ * zdtp's lifecycle hooks to zfb's navigation events via
+ * `setLifecycleAdapter()`. Projects import this with their own
+ * `designTokenPanelConfig` object — the DATA stays project-side.
+ *
+ * Usage (project-side `src/lib/design-token-panel-bootstrap.ts`):
+ *
+ *   import { bootstrapDesignTokenPanel } from "@takazudo/zudo-doc/design-token-panel-bootstrap";
+ *   import { designTokenPanelConfig } from "@/config/design-token-panel-config";
+ *   bootstrapDesignTokenPanel(designTokenPanelConfig);
+ *
+ * Moved from the host's `src/lib/design-token-panel-bootstrap.ts` as part of
+ * the package-first migration (S9a zudolab/zudo-doc#2333). The PanelConfig
+ * DATA stays project-side.
+ *
+ * CSS is pulled via `@import "@takazudo/zdtp/styles.css"` in the project's
+ * `src/styles/global.css` so the panel chrome lands in the main page CSS
+ * bundle (not a deferred chunk). Vite library mode strips the source CSS
+ * import from the emitted JS, so the explicit CSS-side import is the
+ * required pull point. See @takazudo/zdtp PORTABLE-CONTRACT.md §7.
+ */
+import { type PanelConfig } from "@takazudo/zdtp";
+/**
+ * Bootstrap zdtp for a project. Calls `configurePanel(panelConfig)`,
+ * drains any pre-hydration click queue, and wires the zdtp lifecycle
+ * adapter to zfb's navigation events so persisted token overrides are
+ * re-applied on every soft navigation.
+ *
+ * Call this once, as a side-effect import from the project's island
+ * wrapper (`src/components/design-token-panel-bootstrap.tsx`).
+ *
+ * @param panelConfig - The project's `PanelConfig` object (data stays
+ *   project-side in `src/config/design-token-panel-config.ts`).
+ */
+export declare function bootstrapDesignTokenPanel(panelConfig: PanelConfig): void;

package/dist/design-token-panel-bootstrap.js

@@ -0,0 +1,29 @@
+import { configurePanel, setLifecycleAdapter } from "@takazudo/zdtp";
+import {
+  BEFORE_NAVIGATE_EVENT,
+  AFTER_NAVIGATE_EVENT
+} from "./transitions/page-events.js";
+function bootstrapDesignTokenPanel(panelConfig) {
+  configurePanel(panelConfig);
+  if (typeof window !== "undefined") {
+    window.__zdtpReadyClicks?.();
+  }
+  if (typeof document !== "undefined") {
+    const adapter = {
+      onBeforeSwap(cb) {
+        const handler = () => cb();
+        document.addEventListener(BEFORE_NAVIGATE_EVENT, handler);
+        return () => document.removeEventListener(BEFORE_NAVIGATE_EVENT, handler);
+      },
+      onPageLoad(cb) {
+        const handler = () => cb();
+        document.addEventListener(AFTER_NAVIGATE_EVENT, handler);
+        return () => document.removeEventListener(AFTER_NAVIGATE_EVENT, handler);
+      }
+    };
+    setLifecycleAdapter(adapter);
+  }
+}
+export {
+  bootstrapDesignTokenPanel
+};

package/dist/desktop-sidebar-toggle-island/index.d.ts

@@ -0,0 +1,5 @@
+export declare const SIDEBAR_STORAGE_KEY = "zudo-doc-sidebar-visible";
+export declare function DesktopSidebarToggle(): import("preact").JSX.Element;
+export declare namespace DesktopSidebarToggle {
+    var displayName: string;
+}

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

@@ -0,0 +1,62 @@
+"use client";
+import { jsx } from "preact/jsx-runtime";
+import { useState, useEffect, useRef } from "preact/hooks";
+import { ChevronRight, ChevronLeft } from "../icons/index.js";
+import { AFTER_NAVIGATE_EVENT } from "../transitions/index.js";
+const SIDEBAR_STORAGE_KEY = "zudo-doc-sidebar-visible";
+function readState() {
+  if (typeof window === "undefined") return true;
+  try {
+    return localStorage.getItem(SIDEBAR_STORAGE_KEY) !== "false";
+  } catch {
+    return true;
+  }
+}
+function setDataAttribute(isVisible) {
+  if (isVisible) {
+    document.documentElement.removeAttribute("data-sidebar-hidden");
+  } else {
+    document.documentElement.setAttribute("data-sidebar-hidden", "");
+  }
+}
+function DesktopSidebarToggle() {
+  const [visible, setVisible] = useState(true);
+  const hydrated = useRef(false);
+  useEffect(() => {
+    if (!hydrated.current) return;
+    setDataAttribute(visible);
+    try {
+      localStorage.setItem(SIDEBAR_STORAGE_KEY, String(visible));
+    } catch {
+    }
+  }, [visible]);
+  useEffect(() => {
+    hydrated.current = true;
+    const actual = readState();
+    if (actual !== visible) {
+      setVisible(actual);
+    }
+  }, []);
+  useEffect(() => {
+    const handler = () => setDataAttribute(readState());
+    document.addEventListener(AFTER_NAVIGATE_EVENT, handler);
+    return () => document.removeEventListener(AFTER_NAVIGATE_EVENT, handler);
+  }, []);
+  return /* @__PURE__ */ jsx(
+    "button",
+    {
+      type: "button",
+      onClick: () => setVisible((v) => !v),
+      className: "zd-desktop-sidebar-toggle hidden lg:flex fixed bottom-vsp-xl z-sidebar items-center justify-center w-[1.5rem] h-[3rem] bg-surface border border-muted border-l-0 rounded-r-DEFAULT text-muted cursor-pointer transition-[left,color] duration-200 ease-in-out hover:text-fg",
+      "aria-label": visible ? "Hide sidebar" : "Show sidebar",
+      "aria-pressed": visible,
+      "data-zfb-transition-persist": "desktop-sidebar-toggle",
+      children: visible ? /* @__PURE__ */ jsx(ChevronLeft, { className: "h-icon-sm w-icon-sm" }) : /* @__PURE__ */ jsx(ChevronRight, { className: "h-icon-sm w-icon-sm" })
+    }
+  );
+}
+DesktopSidebarToggle.displayName = "DesktopSidebarToggle";
+export {
+  DesktopSidebarToggle,
+  SIDEBAR_STORAGE_KEY
+};

package/dist/details/details.d.ts

@@ -1,9 +1,7 @@
-import { ComponentChildren, VNode } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
-interface DetailsProps {
+import type { ComponentChildren, VNode } from "preact";
+export interface DetailsProps {
     /**
      * Summary / toggle label shown in the `<summary>` element.
      * Defaults to `"Details"` — the same fallback used by the legacy
@@ -21,6 +19,4 @@ interface DetailsProps {
  * The legacy component used Astro's `<slot />`; v2 accepts standard
  * Preact `children`.
  */
-declare function Details({ title, children }: DetailsProps): VNode;
-
-export { Details, type DetailsProps };
+export declare function Details({ title, children }: DetailsProps): VNode;

package/dist/details/index.d.ts

@@ -1,2 +1,2 @@
-export { Details, DetailsProps } from './details.js';
-import 'preact';
+export { Details } from "./details.js";
+export type { DetailsProps } from "./details.js";