@rtkelly-labs/design-system 0.0.0-bootstrap.0 → 0.16.0-dev.0.37dedac

package/dist/components/slides/SlideDeck.js

@@ -0,0 +1,228 @@
+"use client";
+
+// src/components/slides/SlideDeck.tsx
+import React, { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { ChevronLeft, ChevronRight, FileText, Maximize2, Minimize2, Play, Pause } from "lucide-react";
+import { useHotkeys } from "@tanstack/react-hotkeys";
+import { Button } from "../Button.js";
+import { Tooltip } from "../Tooltip.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+function speakerNotesOf(node) {
+  if (!React.isValidElement(node)) return void 0;
+  const notes = node.props.speakerNotes;
+  return notes?.trim() ? notes : void 0;
+}
+var SLIDE_DECK_HOTKEYS = [
+  { hotkey: "ArrowRight", label: "Next", description: "Advance one slide, wrapping at the end", action: "next" },
+  { hotkey: "Space", label: "Next", description: "Advance one slide, as \u2192 does", action: "next" },
+  { hotkey: "ArrowLeft", label: "Previous", description: "Go back one slide, wrapping at the start", action: "previous" },
+  { hotkey: "F", label: "Fullscreen", description: "Toggle fullscreen on the deck frame", action: "fullscreen", preventsDefault: false },
+  { hotkey: "N", label: "Notes", description: "Toggle the presenter panel \u2014 bound only when a slide carries notes", action: "notes", requires: "notes" }
+];
+var SlideDeck = ({
+  children,
+  aspectRatio = "16:9",
+  autoPlayInterval = 0,
+  slide,
+  onSlideChange,
+  chrome = true
+}) => {
+  const [uncontrolledSlide, setUncontrolledSlide] = useState(0);
+  const [isFullscreen, setIsFullscreen] = useState(false);
+  const [isPlaying, setIsPlaying] = useState(false);
+  const [showNotes, setShowNotes] = useState(false);
+  const containerRef = useRef(null);
+  const totalSlides = React.Children.count(children);
+  const isControlled = slide !== void 0;
+  const currentSlide = isControlled ? slide : uncontrolledSlide;
+  const slideList = React.Children.toArray(children);
+  const deckHasNotes = slideList.some((child) => speakerNotesOf(child) !== void 0);
+  const currentNotes = speakerNotesOf(slideList[currentSlide]);
+  const goTo = useCallback(
+    (next) => {
+      if (totalSlides === 0) return;
+      const wrapped = (next % totalSlides + totalSlides) % totalSlides;
+      if (!isControlled) setUncontrolledSlide(wrapped);
+      onSlideChange?.(wrapped);
+    },
+    [isControlled, onSlideChange, totalSlides]
+  );
+  const nextSlide = useCallback(
+    () => goTo(currentSlide + 1),
+    [goTo, currentSlide]
+  );
+  const prevSlide = useCallback(
+    () => goTo(currentSlide - 1),
+    [goTo, currentSlide]
+  );
+  const toggleFullscreen = useCallback(() => {
+    if (!containerRef.current) return;
+    if (!document.fullscreenElement) {
+      containerRef.current.requestFullscreen().catch((err) => console.error(err));
+      setIsFullscreen(true);
+    } else {
+      document.exitFullscreen().catch((err) => console.error(err));
+      setIsFullscreen(false);
+    }
+  }, []);
+  const deckActions = useMemo(
+    () => ({
+      next: nextSlide,
+      previous: prevSlide,
+      fullscreen: toggleFullscreen,
+      notes: () => setShowNotes((visible) => !visible)
+    }),
+    [nextSlide, prevSlide, toggleFullscreen]
+  );
+  useHotkeys(
+    SLIDE_DECK_HOTKEYS.map((binding) => ({
+      hotkey: binding.hotkey,
+      callback: () => deckActions[binding.action](),
+      options: {
+        enabled: chrome && (binding.requires !== "notes" || deckHasNotes),
+        preventDefault: binding.preventsDefault !== false,
+        stopPropagation: false,
+        conflictBehavior: "allow",
+        meta: { name: binding.label, description: binding.description }
+      }
+    }))
+  );
+  useEffect(() => {
+    if (!isPlaying || autoPlayInterval <= 0) return;
+    const timer = setInterval(() => {
+      nextSlide();
+    }, autoPlayInterval);
+    return () => clearInterval(timer);
+  }, [isPlaying, autoPlayInterval, nextSlide]);
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      "data-slot": "slide-deck",
+      ref: containerRef,
+      style: {
+        width: "100%",
+        maxWidth: isFullscreen ? "100vw" : "1000px",
+        margin: "0 auto",
+        border: "3px solid var(--ds-border-strong)",
+        boxShadow: isFullscreen ? "none" : "8px 8px 0px 0px var(--ds-shadow-color)",
+        backgroundColor: "var(--ds-surface-base)",
+        display: "flex",
+        flexDirection: "column"
+      },
+      children: [
+        /* @__PURE__ */ jsx(
+          "div",
+          {
+            style: {
+              width: "100%",
+              aspectRatio: isFullscreen ? "auto" : aspectRatio === "16:9" ? "16 / 9" : "4 / 3",
+              flex: isFullscreen ? 1 : "none",
+              overflow: "hidden",
+              position: "relative"
+            },
+            children: slideList[currentSlide]
+          }
+        ),
+        chrome && /* @__PURE__ */ jsxs(
+          "div",
+          {
+            style: {
+              padding: "1rem 1.5rem",
+              borderTop: "2px solid var(--ds-border-strong)",
+              backgroundColor: "var(--ds-surface-base)",
+              display: "flex",
+              justifyContent: "space-between",
+              alignItems: "center",
+              fontFamily: "var(--ds-font-mono)"
+            },
+            children: [
+              /* @__PURE__ */ jsxs("div", { style: { color: "var(--ds-accent-secondary)", fontWeight: 700, fontSize: "0.9rem" }, children: [
+                "SLIDE ",
+                String(currentSlide + 1).padStart(2, "0"),
+                " / ",
+                String(totalSlides).padStart(2, "0")
+              ] }),
+              /* @__PURE__ */ jsxs("div", { style: { display: "flex", gap: "0.75rem", alignItems: "center" }, children: [
+                /* @__PURE__ */ jsxs(Button, { onClick: prevSlide, style: { padding: "0.4rem 0.8rem" }, children: [
+                  /* @__PURE__ */ jsx(ChevronLeft, { size: 16 }),
+                  " PREV"
+                ] }),
+                autoPlayInterval > 0 && /* @__PURE__ */ jsx(Tooltip, { content: isPlaying ? "Pause autoplay" : "Start autoplay", children: /* @__PURE__ */ jsx(
+                  Button,
+                  {
+                    onClick: () => setIsPlaying(!isPlaying),
+                    "aria-pressed": isPlaying,
+                    "aria-label": isPlaying ? "Pause autoplay" : "Start autoplay",
+                    style: { padding: "0.4rem 0.8rem" },
+                    children: isPlaying ? /* @__PURE__ */ jsx(Pause, { size: 16, "aria-hidden": "true" }) : /* @__PURE__ */ jsx(Play, { size: 16, "aria-hidden": "true" })
+                  }
+                ) }),
+                /* @__PURE__ */ jsxs(Button, { onClick: nextSlide, style: { padding: "0.4rem 0.8rem" }, children: [
+                  "NEXT ",
+                  /* @__PURE__ */ jsx(ChevronRight, { size: 16 })
+                ] }),
+                deckHasNotes && /* @__PURE__ */ jsx(Tooltip, { content: showNotes ? "Hide notes (N)" : "Speaker notes (N)", children: /* @__PURE__ */ jsx(
+                  Button,
+                  {
+                    onClick: () => setShowNotes((visible) => !visible),
+                    "aria-pressed": showNotes,
+                    "aria-label": showNotes ? "Hide speaker notes" : "Show speaker notes",
+                    style: { padding: "0.4rem 0.8rem" },
+                    children: /* @__PURE__ */ jsx(FileText, { size: 16, "aria-hidden": "true" })
+                  }
+                ) }),
+                /* @__PURE__ */ jsx(Tooltip, { content: isFullscreen ? "Exit fullscreen (F)" : "Fullscreen (F)", children: /* @__PURE__ */ jsx(
+                  Button,
+                  {
+                    onClick: toggleFullscreen,
+                    "aria-pressed": isFullscreen,
+                    "aria-label": isFullscreen ? "Exit fullscreen" : "Enter fullscreen",
+                    style: { padding: "0.4rem 0.8rem" },
+                    children: isFullscreen ? /* @__PURE__ */ jsx(Minimize2, { size: 16, "aria-hidden": "true" }) : /* @__PURE__ */ jsx(Maximize2, { size: 16, "aria-hidden": "true" })
+                  }
+                ) })
+              ] })
+            ]
+          }
+        ),
+        showNotes && /* @__PURE__ */ jsxs(
+          "div",
+          {
+            style: {
+              padding: "1rem 1.5rem",
+              borderTop: "2px solid var(--ds-border-strong)",
+              backgroundColor: "var(--ds-surface-raised)",
+              fontFamily: "var(--ds-font-mono)",
+              fontSize: "0.85rem",
+              lineHeight: 1.6,
+              color: "var(--ds-text-primary)",
+              whiteSpace: "pre-wrap"
+            },
+            children: [
+              /* @__PURE__ */ jsx(
+                "div",
+                {
+                  style: {
+                    fontWeight: 700,
+                    textTransform: "uppercase",
+                    fontSize: "0.7rem",
+                    letterSpacing: "0.08em",
+                    color: "var(--ds-accent-secondary)",
+                    marginBottom: "0.5rem"
+                  },
+                  children: "[ Speaker notes ]"
+                }
+              ),
+              currentNotes ?? "No notes on this slide."
+            ]
+          }
+        )
+      ]
+    }
+  );
+};
+export {
+  SLIDE_DECK_HOTKEYS,
+  SlideDeck
+};
+//# sourceMappingURL=SlideDeck.js.map

package/dist/components/slides/SlideDeck.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/components/slides/SlideDeck.tsx"],"sourcesContent":["'use client';\n\nimport React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport { ChevronLeft, ChevronRight, FileText, Maximize2, Minimize2, Play, Pause } from 'lucide-react';\nimport { useHotkeys, type RegisterableHotkey } from '@tanstack/react-hotkeys';\nimport { Button } from '../Button';\nimport { Tooltip } from '../Tooltip';\nimport type { SlideProps } from './Slide';\n\n/**\n * The notes on one slide, if it has any.\n *\n * Reading a child's props is not a thing to do lightly, but it is the right\n * shape here: notes belong *with* the slide that needs them, and the presenter\n * surface belongs to the deck. The alternative — a `notes` array on the deck,\n * indexed by position — puts the two halves of one fact in different files and\n * silently misaligns the moment a slide is inserted.\n */\nfunction speakerNotesOf(node: React.ReactNode): string | undefined {\n  if (!React.isValidElement(node)) return undefined;\n  const notes = (node.props as Partial<SlideProps>).speakerNotes;\n  return notes?.trim() ? notes : undefined;\n}\n\n/**\n * One key on the deck's keyboard surface, as registered and as documented.\n * This array is the only place a deck key is written: `SlideDeck` registers\n * it with `@tanstack/react-hotkeys`, the presenter sees it in the controls,\n * and the docs cheatsheet renders it — three consumers of one list, so none\n * of them can drift from the other two.\n */\nexport interface SlideDeckHotkey {\n  /** The binding in @tanstack/react-hotkeys notation — `ArrowRight`, `f`. */\n  hotkey: RegisterableHotkey;\n  /** What the key does, in the deck's own words. */\n  label: string;\n  /** The one line the cheatsheet shows beside the key. */\n  description: string;\n  action: 'next' | 'previous' | 'fullscreen' | 'notes';\n  /**\n   * Whether the browser's own behaviour (caret, scroll, space-scroll) is\n   * swallowed when the binding fires. `false` for fullscreen, whose `F` is\n   * not a scrolling key and whose default action belongs to nobody.\n   */\n  preventsDefault?: boolean;\n  /** A binding only exists when the deck has the feature it drives. */\n  requires?: 'notes';\n}\n\nexport const SLIDE_DECK_HOTKEYS: readonly SlideDeckHotkey[] = [\n  { hotkey: 'ArrowRight', label: 'Next', description: 'Advance one slide, wrapping at the end', action: 'next' },\n  { hotkey: 'Space', label: 'Next', description: 'Advance one slide, as → does', action: 'next' },\n  { hotkey: 'ArrowLeft', label: 'Previous', description: 'Go back one slide, wrapping at the start', action: 'previous' },\n  { hotkey: 'F', label: 'Fullscreen', description: 'Toggle fullscreen on the deck frame', action: 'fullscreen', preventsDefault: false },\n  { hotkey: 'N', label: 'Notes', description: 'Toggle the presenter panel — bound only when a slide carries notes', action: 'notes', requires: 'notes' },\n];\n\nexport interface SlideDeckProps {\n  children: React.ReactElement[];\n  aspectRatio?: '16:9' | '4:3';\n  /**\n   * Milliseconds between automatic advances. `0` — the default — disables\n   * autoplay and hides the play control entirely, so a deck that does not want\n   * it gains no chrome. Non-zero offers the control; it is right for a kiosk\n   * and wrong for a talk, where the presenter owns the pacing.\n   */\n  autoPlayInterval?: number;\n  /**\n   * The slide to show. Pass it to drive the deck from outside — a router, a\n   * story, a frame renderer — and the deck stops owning the index. Omit it and\n   * the deck keeps its own, which is the existing behaviour.\n   *\n   * The deck holding the index is why it could not previously be screenshotted\n   * at a chosen slide, deep-linked, or driven by anything but a person.\n   */\n  slide?: number;\n  /** Fires with the slide the deck wants to move to, controlled or not. */\n  onSlideChange?: (slide: number) => void;\n  /**\n   * The presenter affordances — control bar, arrow keys, fullscreen. On by\n   * default. Turn them off for a surface that already owns its own navigation,\n   * or that has no person in front of it at all.\n   */\n  chrome?: boolean;\n}\n\n/**\n * The presentation shell around a set of `Slide`s: framing, paging, fullscreen\n * and optional autoplay.\n *\n * It owns the aspect ratio so slides do not have to, wraps at both ends (next\n * from the last slide returns to the first), and exposes fullscreen through the\n * Fullscreen API on its own container rather than the document — so a deck\n * embedded in a page goes fullscreen without taking the page with it.\n *\n * **Presenter notes.** Any child carrying `speakerNotes` makes a notes control\n * appear, and `N` toggles a panel below the frame showing the current slide's.\n * Both the control and the panel are absent unless some slide has notes, and\n * the panel starts closed — so notes never reach a projector unasked, and a\n * deck without them renders exactly as it did before the feature existed.\n *\n * Keyboard: the bindings in `SLIDE_DECK_HOTKEYS` — `←`/`→` or space to page,\n * `F` for fullscreen, `N` for notes when any slide carries them.\n *\n * Slides are indexed by position, so the children must be a stable array. A\n * conditional slide that disappears shifts every index after it.\n *\n * ```tsx\n * <SlideDeck aspectRatio=\"16:9\">\n *   <Slide title=\"Overview\">…</Slide>\n *   <Slide title=\"Deployments\">…</Slide>\n * </SlideDeck>\n * ```\n */\nexport const SlideDeck: React.FC<SlideDeckProps> = ({\n  children,\n  aspectRatio = '16:9',\n  autoPlayInterval = 0,\n  slide,\n  onSlideChange,\n  chrome = true,\n}) => {\n  // Only consulted when uncontrolled. `slide` winning outright is what keeps a\n  // controlled deck from ever disagreeing with its caller.\n  const [uncontrolledSlide, setUncontrolledSlide] = useState(0);\n  const [isFullscreen, setIsFullscreen] = useState(false);\n  const [isPlaying, setIsPlaying] = useState(false);\n  const [showNotes, setShowNotes] = useState(false);\n  const containerRef = useRef<HTMLDivElement>(null);\n\n  const totalSlides = React.Children.count(children);\n  const isControlled = slide !== undefined;\n  const currentSlide = isControlled ? slide : uncontrolledSlide;\n  const slideList = React.Children.toArray(children);\n\n  /**\n   * Notes are opt-in twice over: off until asked for, and invisible as a\n   * feature unless some slide actually carries them. A deck without notes\n   * therefore renders exactly as it did before presenter notes existed.\n   */\n  const deckHasNotes = slideList.some((child) => speakerNotesOf(child) !== undefined);\n  const currentNotes = speakerNotesOf(slideList[currentSlide]);\n\n  const goTo = useCallback(\n    (next: number) => {\n      // Guarded rather than left to the modulo: an empty deck used to send\n      // `prevSlide` to -1, which indexed nothing and rendered blank.\n      if (totalSlides === 0) return;\n      const wrapped = ((next % totalSlides) + totalSlides) % totalSlides;\n      if (!isControlled) setUncontrolledSlide(wrapped);\n      onSlideChange?.(wrapped);\n    },\n    [isControlled, onSlideChange, totalSlides],\n  );\n\n  const nextSlide = useCallback(\n    () => goTo(currentSlide + 1),\n    [goTo, currentSlide],\n  );\n  const prevSlide = useCallback(\n    () => goTo(currentSlide - 1),\n    [goTo, currentSlide],\n  );\n\n  const toggleFullscreen = useCallback(() => {\n    if (!containerRef.current) return;\n    if (!document.fullscreenElement) {\n      containerRef.current.requestFullscreen().catch((err) => console.error(err));\n      setIsFullscreen(true);\n    } else {\n      document.exitFullscreen().catch((err) => console.error(err));\n      setIsFullscreen(false);\n    }\n  }, []);\n\n  const deckActions = useMemo(\n    () => ({\n      next: nextSlide,\n      previous: prevSlide,\n      fullscreen: toggleFullscreen,\n      notes: () => setShowNotes((visible) => !visible),\n    }),\n    [nextSlide, prevSlide, toggleFullscreen],\n  );\n\n  // `SLIDE_DECK_HOTKEYS` replaces a hand-rolled `window` keydown switch:\n  // registration is declarative, `enabled` stands in for the old\n  // `if (!chrome) return` and the notes gate (a disabled binding does not\n  // fire and does not preventDefault, but stays visible in devtools), and\n  // single-key bindings default to `ignoreInputs` — the old handler stole\n  // arrows and space from any focused text field, which this no longer does.\n  // `stopPropagation: false` and the per-binding `preventsDefault` keep the\n  // wired behaviour identical; `conflictBehavior: 'allow'` reproduces what\n  // two `window` listeners did for two mounted decks — both respond, neither\n  // warns. One tightening is real: the old switch read `e.key`, so Shift+F\n  // and Shift+N fired; the bindings are plain F and N, which is what a\n  // presenter means.\n  useHotkeys(\n    SLIDE_DECK_HOTKEYS.map((binding) => ({\n      hotkey: binding.hotkey,\n      callback: () => deckActions[binding.action](),\n      options: {\n        enabled: chrome && (binding.requires !== 'notes' || deckHasNotes),\n        preventDefault: binding.preventsDefault !== false,\n        stopPropagation: false,\n        conflictBehavior: 'allow',\n        meta: { name: binding.label, description: binding.description },\n      },\n    })),\n  );\n\n  useEffect(() => {\n    if (!isPlaying || autoPlayInterval <= 0) return;\n    const timer = setInterval(() => {\n      nextSlide();\n    }, autoPlayInterval);\n    return () => clearInterval(timer);\n  }, [isPlaying, autoPlayInterval, nextSlide]);\n\n  return (\n    <div data-slot=\"slide-deck\"\n      ref={containerRef}\n      style={{\n        width: '100%',\n        maxWidth: isFullscreen ? '100vw' : '1000px',\n        margin: '0 auto',\n        border: '3px solid var(--ds-border-strong)',\n        boxShadow: isFullscreen ? 'none' : '8px 8px 0px 0px var(--ds-shadow-color)',\n        backgroundColor: 'var(--ds-surface-base)',\n        display: 'flex',\n        flexDirection: 'column',\n      }}\n    >\n      {/* Slide viewport */}\n      <div\n        style={{\n          width: '100%',\n          aspectRatio: isFullscreen ? 'auto' : (aspectRatio === '16:9' ? '16 / 9' : '4 / 3'),\n          flex: isFullscreen ? 1 : 'none',\n          overflow: 'hidden',\n          position: 'relative',\n        }}\n      >\n        {slideList[currentSlide]}\n      </div>\n\n      {/* Control bar — the presenter affordances, off when `chrome` is false. */}\n      {chrome && (\n        <div\n        style={{\n          padding: '1rem 1.5rem',\n          borderTop: '2px solid var(--ds-border-strong)',\n          backgroundColor: 'var(--ds-surface-base)',\n          display: 'flex',\n          justifyContent: 'space-between',\n          alignItems: 'center',\n          fontFamily: 'var(--ds-font-mono)',\n        }}\n      >\n        {/* Slide Counter */}\n        <div style={{ color: 'var(--ds-accent-secondary)', fontWeight: 700, fontSize: '0.9rem' }}>\n          SLIDE {String(currentSlide + 1).padStart(2, '0')} / {String(totalSlides).padStart(2, '0')}\n        </div>\n\n        {/* Action Controls */}\n        <div style={{ display: 'flex', gap: '0.75rem', alignItems: 'center' }}>\n          <Button onClick={prevSlide} style={{ padding: '0.4rem 0.8rem' }}>\n            <ChevronLeft size={16} /> PREV\n          </Button>\n\n          {autoPlayInterval > 0 && (\n            <Tooltip content={isPlaying ? 'Pause autoplay' : 'Start autoplay'}>\n              <Button\n                onClick={() => setIsPlaying(!isPlaying)}\n                aria-pressed={isPlaying}\n                aria-label={isPlaying ? 'Pause autoplay' : 'Start autoplay'}\n                style={{ padding: '0.4rem 0.8rem' }}\n              >\n                {isPlaying ? <Pause size={16} aria-hidden=\"true\" /> : <Play size={16} aria-hidden=\"true\" />}\n              </Button>\n            </Tooltip>\n          )}\n\n          <Button onClick={nextSlide} style={{ padding: '0.4rem 0.8rem' }}>\n            NEXT <ChevronRight size={16} />\n          </Button>\n\n          {/*\n            * The icon-only controls carry a `Tooltip` rather than `title=\"\"`\n            * (#166): the hint now reaches a keyboard user on focus, and says\n            * the shortcut. The `aria-label` stays the accessible name — a\n            * tooltip is visual, and restates it for sighted users.\n            */}\n          {deckHasNotes && (\n            <Tooltip content={showNotes ? 'Hide notes (N)' : 'Speaker notes (N)'}>\n              <Button\n                onClick={() => setShowNotes((visible) => !visible)}\n                aria-pressed={showNotes}\n                aria-label={showNotes ? 'Hide speaker notes' : 'Show speaker notes'}\n                style={{ padding: '0.4rem 0.8rem' }}\n              >\n                <FileText size={16} aria-hidden=\"true\" />\n              </Button>\n            </Tooltip>\n          )}\n\n          <Tooltip content={isFullscreen ? 'Exit fullscreen (F)' : 'Fullscreen (F)'}>\n            <Button\n              onClick={toggleFullscreen}\n              aria-pressed={isFullscreen}\n              aria-label={isFullscreen ? 'Exit fullscreen' : 'Enter fullscreen'}\n              style={{ padding: '0.4rem 0.8rem' }}\n            >\n              {isFullscreen ? <Minimize2 size={16} aria-hidden=\"true\" /> : <Maximize2 size={16} aria-hidden=\"true\" />}\n            </Button>\n          </Tooltip>\n        </div>\n      </div>\n      )}\n\n      {/*\n        Presenter notes. Below the control bar rather than over the slide, so\n        that a deck mirrored to a projector shows the audience the slide and\n        nothing else — the notes are outside the frame the viewport clips.\n      */}\n      {showNotes && (\n        <div\n          style={{\n            padding: '1rem 1.5rem',\n            borderTop: '2px solid var(--ds-border-strong)',\n            backgroundColor: 'var(--ds-surface-raised)',\n            fontFamily: 'var(--ds-font-mono)',\n            fontSize: '0.85rem',\n            lineHeight: 1.6,\n            color: 'var(--ds-text-primary)',\n            whiteSpace: 'pre-wrap',\n          }}\n        >\n          <div\n            style={{\n              fontWeight: 700,\n              textTransform: 'uppercase',\n              fontSize: '0.7rem',\n              letterSpacing: '0.08em',\n              color: 'var(--ds-accent-secondary)',\n              marginBottom: '0.5rem',\n            }}\n          >\n            [ Speaker notes ]\n          </div>\n          {currentNotes ?? 'No notes on this slide.'}\n        </div>\n      )}\n    </div>\n  );\n};\n"],"mappings":"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","names":[]}

package/dist/components/themeInitScript.js

@@ -0,0 +1,16 @@
+// src/components/themeInitScript.ts
+import { DEFAULT_LEVEL, SYSTEM_LEVEL, THEME_LEVELS } from "../theme/levels.js";
+var THEME_STORAGE_KEY = "ds-theme-level";
+var THEME_ATTRIBUTE = "data-theme";
+function getThemeInitScript(options = {}) {
+  const { defaultLevel = DEFAULT_LEVEL, followSystem = true } = options;
+  const levels = JSON.stringify(THEME_LEVELS);
+  const system = JSON.stringify(SYSTEM_LEVEL);
+  return `(function(){try{var l=${levels},s=${system},k=${JSON.stringify(THEME_STORAGE_KEY)};var v=null;try{v=localStorage.getItem(k)}catch(e){}if(l.indexOf(v)===-1){v=${followSystem ? `(window.matchMedia&&window.matchMedia("(prefers-color-scheme: dark)").matches)?s.dark:s.light` : JSON.stringify(defaultLevel)}}document.documentElement.setAttribute(${JSON.stringify(THEME_ATTRIBUTE)},v)}catch(e){}})();`;
+}
+export {
+  THEME_ATTRIBUTE,
+  THEME_STORAGE_KEY,
+  getThemeInitScript
+};
+//# sourceMappingURL=themeInitScript.js.map

package/dist/components/themeInitScript.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/themeInitScript.ts"],"sourcesContent":["/**\n * The pre-paint theme script and the two names it shares with `ThemeProvider`.\n *\n * A module of its own rather than a part of `ThemeProvider.tsx` because that\n * file is a client module (`'use client'`), and a server component importing a\n * value from a client module receives a client reference it cannot call. The\n * canonical caller of `getThemeInitScript` is a root layout, which in the Next\n * App Router is a server component — so this has to stay server-safe.\n */\nimport { DEFAULT_LEVEL, SYSTEM_LEVEL, THEME_LEVELS } from '../theme/levels';\nimport type { ThemeLevel } from '../theme/levels';\n\n/** Where the chosen level is persisted. Shared with {@link getThemeInitScript}. */\nexport const THEME_STORAGE_KEY = 'ds-theme-level';\n\n/** The attribute the CSS keys off. Shared with {@link getThemeInitScript}. */\nexport const THEME_ATTRIBUTE = 'data-theme';\n\n/**\n * The script to run before first paint, so the page never flashes the default\n * level and then corrects itself.\n *\n * Drop the returned string into an inline `<script>` in the document head,\n * ahead of the stylesheet. React cannot do this job: anything it renders runs\n * after hydration, which is already too late — and reading `localStorage` in a\n * `useState` initialiser (what this component used to do) makes the server and\n * client render different markup, which is a hydration mismatch.\n *\n * ```tsx\n * <script dangerouslySetInnerHTML={{ __html: getThemeInitScript() }} />\n * ```\n */\nexport function getThemeInitScript(\n  options: { defaultLevel?: ThemeLevel; followSystem?: boolean } = {},\n): string {\n  const { defaultLevel = DEFAULT_LEVEL, followSystem = true } = options;\n  // Serialised rather than interpolated loosely, so the level list and the\n  // system mapping in this script cannot drift from levels.ts.\n  const levels = JSON.stringify(THEME_LEVELS);\n  const system = JSON.stringify(SYSTEM_LEVEL);\n  return `(function(){try{var l=${levels},s=${system},k=${JSON.stringify(THEME_STORAGE_KEY)};var v=null;try{v=localStorage.getItem(k)}catch(e){}if(l.indexOf(v)===-1){v=${\n    followSystem\n      ? `(window.matchMedia&&window.matchMedia(\"(prefers-color-scheme: dark)\").matches)?s.dark:s.light`\n      : JSON.stringify(defaultLevel)\n  }}document.documentElement.setAttribute(${JSON.stringify(THEME_ATTRIBUTE)},v)}catch(e){}})();`;\n}\n"],"mappings":";AASA,SAAS,eAAe,cAAc,oBAAoB;AAInD,IAAM,oBAAoB;AAG1B,IAAM,kBAAkB;AAgBxB,SAAS,mBACd,UAAiE,CAAC,GAC1D;AACR,QAAM,EAAE,eAAe,eAAe,eAAe,KAAK,IAAI;AAG9D,QAAM,SAAS,KAAK,UAAU,YAAY;AAC1C,QAAM,SAAS,KAAK,UAAU,YAAY;AAC1C,SAAO,yBAAyB,MAAM,MAAM,MAAM,MAAM,KAAK,UAAU,iBAAiB,CAAC,+EACvF,eACI,kGACA,KAAK,UAAU,YAAY,CACjC,0CAA0C,KAAK,UAAU,eAAe,CAAC;AAC3E;","names":[]}

package/dist/components/themeScope.js

@@ -0,0 +1,9 @@
+"use client";
+
+// src/components/themeScope.ts
+import { createContext } from "react";
+var ScopedLevelContext = createContext(void 0);
+export {
+  ScopedLevelContext
+};
+//# sourceMappingURL=themeScope.js.map

package/dist/components/themeScope.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/themeScope.ts"],"sourcesContent":["'use client';\n\nimport { createContext } from 'react';\nimport type { ThemeLevel } from '../theme/levels';\n\n// The nearest provider's Level when that provider is scoped, `undefined` when\n// it is unscoped or absent. Kept out of `ThemeProvider.tsx` because the package\n// re-exports that module wholesale, and this is internal.\nexport const ScopedLevelContext = createContext<ThemeLevel | undefined>(undefined);\n"],"mappings":";;;AAEA,SAAS,qBAAqB;AAMvB,IAAM,qBAAqB,cAAsC,MAAS;","names":[]}

package/dist/components/toastLifetime.js

@@ -0,0 +1,21 @@
+// src/components/toastLifetime.ts
+var DEFAULT_TIMEOUT = 6e3;
+var MS_PER_WORD = 300;
+var NOTICE_MS = 2e3;
+function words(text) {
+  return typeof text === "string" ? text.split(/\s+/).filter(Boolean).length : 0;
+}
+function resolveLifetime(options, providerTimeout) {
+  if (options.timeout !== void 0) return options.timeout;
+  if (options.action) return 0;
+  if (providerTimeout === 0) return 0;
+  const reading = NOTICE_MS + (words(options.title) + words(options.description)) * MS_PER_WORD;
+  return Math.max(providerTimeout, reading);
+}
+export {
+  DEFAULT_TIMEOUT,
+  MS_PER_WORD,
+  NOTICE_MS,
+  resolveLifetime
+};
+//# sourceMappingURL=toastLifetime.js.map

package/dist/components/toastLifetime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/toastLifetime.ts"],"sourcesContent":["/**\n * How long a toast stays up — policy, kept out of `Toast.tsx` so it can be\n * tested directly without being exported from the package. `src/index.ts`\n * re-exports named members of `Toast.tsx` only, and nothing re-exports this.\n */\n\n/** The fields of a toast the lifetime depends on. */\ninterface LifetimeInput {\n  title: string;\n  description?: unknown;\n  action?: unknown;\n  timeout?: number;\n}\n\n/**\n * Six seconds. Base UI's default is five; the extra second is for the reader\n * #243 names — a screen reader still announcing when the timer fires.\n */\nexport const DEFAULT_TIMEOUT = 6000;\n\n/**\n * Reading time, as a floor under the lifetime.\n *\n * 200 words a minute is a conservative reading speed (300ms a word), and the\n * two seconds on top are for noticing the toast at all before reading starts.\n * Only text can be counted: a `description` that is a React node contributes\n * nothing, and the caller who built one can pass `timeout` themselves.\n */\nexport const MS_PER_WORD = 300;\nexport const NOTICE_MS = 2000;\n\nfunction words(text: unknown): number {\n  return typeof text === 'string' ? text.split(/\\s+/).filter(Boolean).length : 0;\n}\n\n/**\n * The lifetime in milliseconds, `0` meaning \"until dismissed\".\n *\n * 1. An explicit `timeout` always wins — including `0`.\n * 2. A toast with an action persists. A control that can vanish on a timer is\n *    one a keyboard or screen-reader user may never reach; pausing on hover\n *    protects only the pointer.\n * 3. A provider `timeout` of `0` means every toast persists.\n * 4. Otherwise the provider's timeout, raised to the reading time of the text.\n */\nexport function resolveLifetime(options: LifetimeInput, providerTimeout: number): number {\n  if (options.timeout !== undefined) return options.timeout;\n  if (options.action) return 0;\n  if (providerTimeout === 0) return 0;\n  const reading = NOTICE_MS + (words(options.title) + words(options.description)) * MS_PER_WORD;\n  return Math.max(providerTimeout, reading);\n}\n"],"mappings":";AAkBO,IAAM,kBAAkB;AAUxB,IAAM,cAAc;AACpB,IAAM,YAAY;AAEzB,SAAS,MAAM,MAAuB;AACpC,SAAO,OAAO,SAAS,WAAW,KAAK,MAAM,KAAK,EAAE,OAAO,OAAO,EAAE,SAAS;AAC/E;AAYO,SAAS,gBAAgB,SAAwB,iBAAiC;AACvF,MAAI,QAAQ,YAAY,OAAW,QAAO,QAAQ;AAClD,MAAI,QAAQ,OAAQ,QAAO;AAC3B,MAAI,oBAAoB,EAAG,QAAO;AAClC,QAAM,UAAU,aAAa,MAAM,QAAQ,KAAK,IAAI,MAAM,QAAQ,WAAW,KAAK;AAClF,SAAO,KAAK,IAAI,iBAAiB,OAAO;AAC1C;","names":[]}

package/dist/fonts/DSSymbols-OFL.txt

@@ -0,0 +1,98 @@
+DSSymbols-Regular.woff2 is a subset of JetBrains Mono Regular 2.304
+(https://github.com/JetBrains/JetBrainsMono, release v2.304), cut to the symbol
+blocks named by its unicode-range in src/styles.css with fontTools pyftsubset.
+No Reserved Font Name is declared. It is served under the family name "DS Symbols".
+
+Copyright 2020 The JetBrains Mono Project Authors (https://github.com/JetBrains/JetBrainsMono)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/hooks/useActiveHeading.js

@@ -0,0 +1,59 @@
+"use client";
+
+// src/hooks/useActiveHeading.ts
+import { useEffect, useState } from "react";
+function useActiveHeading(ids, { offset, enabled = true } = {}) {
+  const [active, setActive] = useState(null);
+  const key = ids.join("|");
+  useEffect(() => {
+    if (!enabled || typeof window === "undefined") return;
+    const headingIds = key ? key.split("|") : [];
+    if (headingIds.length === 0) {
+      setActive(null);
+      return;
+    }
+    let frame = 0;
+    const resolveOffset = () => {
+      if (typeof offset === "number") return offset;
+      const raw = getComputedStyle(document.documentElement).getPropertyValue(
+        "--docs-header-height"
+      );
+      const parsed = Number.parseFloat(raw);
+      return Number.isFinite(parsed) ? parsed : 0;
+    };
+    const measure = () => {
+      frame = 0;
+      const line = resolveOffset() + 24;
+      const scrolledToBottom = window.innerHeight + window.scrollY >= document.body.scrollHeight - 2;
+      if (scrolledToBottom) {
+        setActive(headingIds[headingIds.length - 1] ?? null);
+        return;
+      }
+      let current = null;
+      for (const id of headingIds) {
+        const el = document.getElementById(id);
+        if (!el) continue;
+        if (el.getBoundingClientRect().top <= line) current = id;
+        else break;
+      }
+      setActive(current);
+    };
+    const onScroll = () => {
+      if (frame) return;
+      frame = window.requestAnimationFrame(measure);
+    };
+    measure();
+    window.addEventListener("scroll", onScroll, { passive: true });
+    window.addEventListener("resize", onScroll);
+    return () => {
+      if (frame) window.cancelAnimationFrame(frame);
+      window.removeEventListener("scroll", onScroll);
+      window.removeEventListener("resize", onScroll);
+    };
+  }, [key, offset, enabled]);
+  return active;
+}
+export {
+  useActiveHeading
+};
+//# sourceMappingURL=useActiveHeading.js.map

package/dist/hooks/useActiveHeading.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useActiveHeading.ts"],"sourcesContent":["'use client';\n\nimport { useEffect, useState } from 'react';\n\nexport interface UseActiveHeadingOptions {\n  /**\n   * Distance from the top of the viewport, in px, that counts as the \"reading\n   * line\". A heading is active once it scrolls above this line. Defaults to\n   * reading the `--docs-header-height` custom property so scroll-spy stays in\n   * sync with the sticky header without callers passing the number around.\n   */\n  offset?: number;\n  /** Disable the listener entirely (e.g. when no TOC is rendered). */\n  enabled?: boolean;\n}\n\n/**\n * Scroll-spy over a list of heading ids. Returns the id of the heading the\n * reader is currently inside — the last one whose top edge has passed the\n * reading line — or `null` above the first heading.\n *\n * Uses measured rects on a rAF-throttled scroll listener rather than an\n * IntersectionObserver. \"Last heading above a line\" is awkward to express as an\n * observer `rootMargin` (a heading scrolled far past the top stops intersecting\n * and would stop reporting), and doc pages have few enough headings that\n * measuring them is cheap.\n */\nexport function useActiveHeading(\n  ids: readonly string[],\n  { offset, enabled = true }: UseActiveHeadingOptions = {},\n): string | null {\n  const [active, setActive] = useState<string | null>(null);\n\n  // Depend on the joined key rather than the array identity: callers almost\n  // always build `ids` inline from a TOC, so a fresh array arrives every render\n  // and an identity dep would rebind the listener continuously.\n  const key = ids.join('|');\n\n  useEffect(() => {\n    if (!enabled || typeof window === 'undefined') return;\n\n    const headingIds = key ? key.split('|') : [];\n    if (headingIds.length === 0) {\n      setActive(null);\n      return;\n    }\n\n    let frame = 0;\n\n    const resolveOffset = (): number => {\n      if (typeof offset === 'number') return offset;\n      const raw = getComputedStyle(document.documentElement).getPropertyValue(\n        '--docs-header-height',\n      );\n      const parsed = Number.parseFloat(raw);\n      return Number.isFinite(parsed) ? parsed : 0;\n    };\n\n    const measure = () => {\n      frame = 0;\n      // A little breathing room below the header so a heading counts as \"read\"\n      // just before it tucks underneath it.\n      const line = resolveOffset() + 24;\n\n      // Bottom of the page: the final sections may be too short to ever cross\n      // the line, so pin to the last heading instead of leaving it unreachable.\n      const scrolledToBottom =\n        window.innerHeight + window.scrollY >= document.body.scrollHeight - 2;\n      if (scrolledToBottom) {\n        setActive(headingIds[headingIds.length - 1] ?? null);\n        return;\n      }\n\n      let current: string | null = null;\n      for (const id of headingIds) {\n        const el = document.getElementById(id);\n        if (!el) continue;\n        if (el.getBoundingClientRect().top <= line) current = id;\n        else break;\n      }\n\n      setActive(current);\n    };\n\n    const onScroll = () => {\n      if (frame) return;\n      frame = window.requestAnimationFrame(measure);\n    };\n\n    measure();\n    window.addEventListener('scroll', onScroll, { passive: true });\n    window.addEventListener('resize', onScroll);\n\n    return () => {\n      if (frame) window.cancelAnimationFrame(frame);\n      window.removeEventListener('scroll', onScroll);\n      window.removeEventListener('resize', onScroll);\n    };\n  }, [key, offset, enabled]);\n\n  return active;\n}\n"],"mappings":";;;AAEA,SAAS,WAAW,gBAAgB;AAyB7B,SAAS,iBACd,KACA,EAAE,QAAQ,UAAU,KAAK,IAA6B,CAAC,GACxC;AACf,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAwB,IAAI;AAKxD,QAAM,MAAM,IAAI,KAAK,GAAG;AAExB,YAAU,MAAM;AACd,QAAI,CAAC,WAAW,OAAO,WAAW,YAAa;AAE/C,UAAM,aAAa,MAAM,IAAI,MAAM,GAAG,IAAI,CAAC;AAC3C,QAAI,WAAW,WAAW,GAAG;AAC3B,gBAAU,IAAI;AACd;AAAA,IACF;AAEA,QAAI,QAAQ;AAEZ,UAAM,gBAAgB,MAAc;AAClC,UAAI,OAAO,WAAW,SAAU,QAAO;AACvC,YAAM,MAAM,iBAAiB,SAAS,eAAe,EAAE;AAAA,QACrD;AAAA,MACF;AACA,YAAM,SAAS,OAAO,WAAW,GAAG;AACpC,aAAO,OAAO,SAAS,MAAM,IAAI,SAAS;AAAA,IAC5C;AAEA,UAAM,UAAU,MAAM;AACpB,cAAQ;AAGR,YAAM,OAAO,cAAc,IAAI;AAI/B,YAAM,mBACJ,OAAO,cAAc,OAAO,WAAW,SAAS,KAAK,eAAe;AACtE,UAAI,kBAAkB;AACpB,kBAAU,WAAW,WAAW,SAAS,CAAC,KAAK,IAAI;AACnD;AAAA,MACF;AAEA,UAAI,UAAyB;AAC7B,iBAAW,MAAM,YAAY;AAC3B,cAAM,KAAK,SAAS,eAAe,EAAE;AACrC,YAAI,CAAC,GAAI;AACT,YAAI,GAAG,sBAAsB,EAAE,OAAO,KAAM,WAAU;AAAA,YACjD;AAAA,MACP;AAEA,gBAAU,OAAO;AAAA,IACnB;AAEA,UAAM,WAAW,MAAM;AACrB,UAAI,MAAO;AACX,cAAQ,OAAO,sBAAsB,OAAO;AAAA,IAC9C;AAEA,YAAQ;AACR,WAAO,iBAAiB,UAAU,UAAU,EAAE,SAAS,KAAK,CAAC;AAC7D,WAAO,iBAAiB,UAAU,QAAQ;AAE1C,WAAO,MAAM;AACX,UAAI,MAAO,QAAO,qBAAqB,KAAK;AAC5C,aAAO,oBAAoB,UAAU,QAAQ;AAC7C,aAAO,oBAAoB,UAAU,QAAQ;AAAA,IAC/C;AAAA,EACF,GAAG,CAAC,KAAK,QAAQ,OAAO,CAAC;AAEzB,SAAO;AACT;","names":[]}

package/dist/hooks/useCopyToClipboard.js

@@ -0,0 +1,58 @@
+"use client";
+
+// src/hooks/useCopyToClipboard.ts
+import { useCallback, useEffect, useRef, useState } from "react";
+function useCopyToClipboard(resetAfter = 2e3) {
+  const [copied, setCopied] = useState(false);
+  const [failed, setFailed] = useState(false);
+  const timer = useRef(void 0);
+  useEffect(() => {
+    return () => {
+      if (timer.current) clearTimeout(timer.current);
+    };
+  }, []);
+  const copy = useCallback(
+    async (value) => {
+      const ok = await writeToClipboard(value);
+      setCopied(ok);
+      setFailed(!ok);
+      if (timer.current) clearTimeout(timer.current);
+      timer.current = setTimeout(() => {
+        setCopied(false);
+        setFailed(false);
+      }, resetAfter);
+      return ok;
+    },
+    [resetAfter]
+  );
+  return { copied, failed, copy };
+}
+async function writeToClipboard(value) {
+  if (typeof navigator !== "undefined" && navigator.clipboard?.writeText) {
+    try {
+      await navigator.clipboard.writeText(value);
+      return true;
+    } catch {
+    }
+  }
+  if (typeof document === "undefined") return false;
+  try {
+    const el = document.createElement("textarea");
+    el.value = value;
+    el.setAttribute("readonly", "");
+    el.style.position = "fixed";
+    el.style.top = "-9999px";
+    el.style.opacity = "0";
+    document.body.appendChild(el);
+    el.select();
+    const ok = document.execCommand("copy");
+    document.body.removeChild(el);
+    return ok;
+  } catch {
+    return false;
+  }
+}
+export {
+  useCopyToClipboard
+};
+//# sourceMappingURL=useCopyToClipboard.js.map

package/dist/hooks/useCopyToClipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useCopyToClipboard.ts"],"sourcesContent":["'use client';\n\nimport { useCallback, useEffect, useRef, useState } from 'react';\n\nexport interface UseCopyToClipboardResult {\n  /** True for `resetAfter` ms following a successful copy. */\n  copied: boolean;\n  /** True if the last attempt threw — permissions, insecure context, no API. */\n  failed: boolean;\n  copy: (value: string) => Promise<boolean>;\n}\n\n/**\n * Clipboard write with transient \"copied\" feedback.\n *\n * Falls back to a hidden `<textarea>` + `document.execCommand('copy')` when the\n * async Clipboard API is unavailable. That matters more than it looks: the API\n * requires a secure context, so a docs site opened over plain `http://` on a\n * LAN address — exactly how you'd preview a static build — has no\n * `navigator.clipboard` at all, and the copy-link affordance would silently do\n * nothing.\n */\nexport function useCopyToClipboard(resetAfter = 2000): UseCopyToClipboardResult {\n  const [copied, setCopied] = useState(false);\n  const [failed, setFailed] = useState(false);\n  const timer = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);\n\n  useEffect(() => {\n    return () => {\n      if (timer.current) clearTimeout(timer.current);\n    };\n  }, []);\n\n  const copy = useCallback(\n    async (value: string): Promise<boolean> => {\n      const ok = await writeToClipboard(value);\n\n      setCopied(ok);\n      setFailed(!ok);\n\n      if (timer.current) clearTimeout(timer.current);\n      timer.current = setTimeout(() => {\n        setCopied(false);\n        setFailed(false);\n      }, resetAfter);\n\n      return ok;\n    },\n    [resetAfter],\n  );\n\n  return { copied, failed, copy };\n}\n\nasync function writeToClipboard(value: string): Promise<boolean> {\n  if (typeof navigator !== 'undefined' && navigator.clipboard?.writeText) {\n    try {\n      await navigator.clipboard.writeText(value);\n      return true;\n    } catch {\n      // Fall through to the execCommand path.\n    }\n  }\n\n  if (typeof document === 'undefined') return false;\n\n  try {\n    const el = document.createElement('textarea');\n    el.value = value;\n    el.setAttribute('readonly', '');\n    el.style.position = 'fixed';\n    el.style.top = '-9999px';\n    el.style.opacity = '0';\n    document.body.appendChild(el);\n    el.select();\n    const ok = document.execCommand('copy');\n    document.body.removeChild(el);\n    return ok;\n  } catch {\n    return false;\n  }\n}\n"],"mappings":";;;AAEA,SAAS,aAAa,WAAW,QAAQ,gBAAgB;AAoBlD,SAAS,mBAAmB,aAAa,KAAgC;AAC9E,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAS,KAAK;AAC1C,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAS,KAAK;AAC1C,QAAM,QAAQ,OAAkD,MAAS;AAEzE,YAAU,MAAM;AACd,WAAO,MAAM;AACX,UAAI,MAAM,QAAS,cAAa,MAAM,OAAO;AAAA,IAC/C;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,QAAM,OAAO;AAAA,IACX,OAAO,UAAoC;AACzC,YAAM,KAAK,MAAM,iBAAiB,KAAK;AAEvC,gBAAU,EAAE;AACZ,gBAAU,CAAC,EAAE;AAEb,UAAI,MAAM,QAAS,cAAa,MAAM,OAAO;AAC7C,YAAM,UAAU,WAAW,MAAM;AAC/B,kBAAU,KAAK;AACf,kBAAU,KAAK;AAAA,MACjB,GAAG,UAAU;AAEb,aAAO;AAAA,IACT;AAAA,IACA,CAAC,UAAU;AAAA,EACb;AAEA,SAAO,EAAE,QAAQ,QAAQ,KAAK;AAChC;AAEA,eAAe,iBAAiB,OAAiC;AAC/D,MAAI,OAAO,cAAc,eAAe,UAAU,WAAW,WAAW;AACtE,QAAI;AACF,YAAM,UAAU,UAAU,UAAU,KAAK;AACzC,aAAO;AAAA,IACT,QAAQ;AAAA,IAER;AAAA,EACF;AAEA,MAAI,OAAO,aAAa,YAAa,QAAO;AAE5C,MAAI;AACF,UAAM,KAAK,SAAS,cAAc,UAAU;AAC5C,OAAG,QAAQ;AACX,OAAG,aAAa,YAAY,EAAE;AAC9B,OAAG,MAAM,WAAW;AACpB,OAAG,MAAM,MAAM;AACf,OAAG,MAAM,UAAU;AACnB,aAAS,KAAK,YAAY,EAAE;AAC5B,OAAG,OAAO;AACV,UAAM,KAAK,SAAS,YAAY,MAAM;AACtC,aAAS,KAAK,YAAY,EAAE;AAC5B,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}