@mieweb/ui 0.10.0-dev.3 → 0.10.0-dev.31

package/dist/{chunk-2G75X6TS.cjs.map → chunk-AHHFFXJR.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/components/SourceTip/SourceTip.tsx"],"names":["React","useAnchoredPosition","useEscapeKey","jsxs","cn","createPortal","jsx"],"mappings":"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","file":"chunk-2G75X6TS.cjs","sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { createPortal } from 'react-dom';\nimport { cn } from '../../utils/cn';\nimport { useAnchoredPosition } from '../../hooks/useAnchoredPosition';\nimport { useEscapeKey } from '../../hooks/useEscapeKey';\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/** One line of provenance shown in the card. */\nexport interface TipSource {\n  /** One-line label — statute name or source title. Truncated on render. */\n  label: string;\n  /** Source URL. Omit for a provenance line that isn't linkable. */\n  url?: string;\n  /** Secondary label shown at the end (publisher / host / year). */\n  sub?: string;\n}\n\nexport interface SourceTipProps {\n  /** The claim this card explains — the card's heading. */\n  heading: string;\n  /** Free-text provenance, for facts no public URL can verify. */\n  note?: string;\n  /** Linked (or unlinked) one-line sources. */\n  sources?: TipSource[];\n  /** Eyebrow above the heading. Defaults to \"Source\". */\n  eyebrow?: string;\n  /** The visible trigger. */\n  children: React.ReactNode;\n  className?: string;\n  /**\n   * Underline the trigger with a dashed rule marking a hoverable claim.\n   * Leave off in table cells, which signal hoverability by their own\n   * treatment rather than by underlining every cell.\n   */\n  underline?: boolean;\n}\n\nconst HIDE_GRACE_MS = 180;\n\n// =============================================================================\n// SourceTip\n// =============================================================================\n\n/**\n * A hover card answering \"what backs this claim?\" — an eyebrow + heading,\n * optional free-text provenance, and a list of one-line source links.\n * Suits stat tiles, table cells, and inline facts where a numbered footnote\n * would be overkill.\n *\n * The trigger and card are phrasing content (`span`/`a` only), so it is\n * valid inside `<p>` prose and table cells. The card portals to `body` with\n * fixed positioning, flipping and clamping to stay in the viewport. On\n * touch, a tap pins the card; Escape or an outside tap closes it. A pinned\n * card behaves as a non-modal dialog — focus moves into it so its source\n * links are keyboard-reachable, and returns to the trigger on close.\n *\n * @example\n * ```tsx\n * <SourceTip\n *   heading=\"OSHA recordable rate\"\n *   sources={[{ label: 'BLS SOII 2023', url: 'https://www.bls.gov/iif/', sub: 'BLS' }]}\n *   underline\n * >\n *   2.4 per 100 FTE\n * </SourceTip>\n * ```\n */\nexport function SourceTip({\n  heading,\n  note,\n  sources,\n  eyebrow = 'Source',\n  children,\n  className,\n  underline = false,\n}: SourceTipProps) {\n  const [open, setOpen] = React.useState(false);\n  const [pinned, setPinned] = React.useState(false);\n  const timer = React.useRef<ReturnType<typeof setTimeout> | null>(null);\n  // True while close() restores focus to the trigger, so the trigger's\n  // focus-show doesn't immediately reopen a card the user just dismissed.\n  const suppressFocusShow = React.useRef(false);\n\n  const { anchorRef, floatingRef, style } = useAnchoredPosition<\n    HTMLSpanElement,\n    HTMLSpanElement\n  >({\n    open,\n    placement: 'top',\n    offset: 10,\n    viewportPadding: 8,\n    allowFlip: true,\n  });\n\n  const clearHideTimer = () => {\n    if (timer.current) {\n      clearTimeout(timer.current);\n      timer.current = null;\n    }\n  };\n\n  const show = React.useCallback(() => {\n    clearHideTimer();\n    setOpen(true);\n  }, []);\n\n  const scheduleHide = React.useCallback(() => {\n    if (pinned) return;\n    clearHideTimer();\n    timer.current = setTimeout(() => setOpen(false), HIDE_GRACE_MS);\n  }, [pinned]);\n\n  const close = React.useCallback(() => {\n    clearHideTimer();\n    setPinned(false);\n    setOpen(false);\n    // Return focus to the trigger if it was inside the card.\n    if (floatingRef.current?.contains(document.activeElement)) {\n      suppressFocusShow.current = true;\n      anchorRef.current?.focus();\n    }\n  }, [anchorRef, floatingRef]);\n\n  React.useEffect(() => () => clearHideTimer(), []);\n\n  // A pinned card is a non-modal dialog: move focus into it so its links\n  // are reachable by keyboard.\n  React.useEffect(() => {\n    if (pinned) floatingRef.current?.focus();\n  }, [pinned, floatingRef]);\n\n  useEscapeKey(close, open);\n\n  // Pinned cards close on an outside tap; hover cards close on their own.\n  React.useEffect(() => {\n    if (!open || !pinned) return;\n    const onPointer = (e: Event) => {\n      const t = e.target as Node;\n      if (anchorRef.current?.contains(t) || floatingRef.current?.contains(t))\n        return;\n      close();\n    };\n    document.addEventListener('mousedown', onPointer);\n    document.addEventListener('touchstart', onPointer);\n    return () => {\n      document.removeEventListener('mousedown', onPointer);\n      document.removeEventListener('touchstart', onPointer);\n    };\n  }, [open, pinned, close, anchorRef, floatingRef]);\n\n  // Touch has no hover: tap pins the card instead of falling through.\n  const onTriggerClick = () => {\n    const coarse =\n      typeof window !== 'undefined' &&\n      window.matchMedia('(hover: none)').matches;\n    if (!coarse) return;\n    togglePin();\n  };\n\n  const togglePin = () => {\n    if (pinned) close();\n    else {\n      setPinned(true);\n      show();\n    }\n  };\n\n  const onTriggerKeyDown = (e: React.KeyboardEvent<HTMLSpanElement>) => {\n    if (e.key === 'Enter' || e.key === ' ') {\n      e.preventDefault();\n      togglePin();\n    }\n  };\n\n  // Focus lives on the dialog container once pinned, so Enter/Space there\n  // (not on a link inside) must also unpin — the trigger no longer has focus.\n  const onDialogKeyDown = (e: React.KeyboardEvent<HTMLSpanElement>) => {\n    if (e.target !== e.currentTarget) return;\n    if (e.key === 'Enter' || e.key === ' ') {\n      e.preventDefault();\n      close();\n    }\n  };\n\n  const onTriggerFocus = () => {\n    if (suppressFocusShow.current) {\n      suppressFocusShow.current = false;\n      return;\n    }\n    show();\n  };\n\n  const onBlurCapture = (e: React.FocusEvent<HTMLSpanElement>) => {\n    const next = e.relatedTarget as Node | null;\n    if (\n      next &&\n      (anchorRef.current?.contains(next) || floatingRef.current?.contains(next))\n    )\n      return;\n    scheduleHide();\n  };\n\n  const hasSources = Boolean(sources && sources.length > 0);\n\n  return (\n    <span\n      ref={anchorRef}\n      className={cn(\n        'cursor-help',\n        underline &&\n          'decoration-primary-400/70 underline decoration-dashed underline-offset-4',\n        className\n      )}\n      onMouseEnter={show}\n      onMouseLeave={scheduleHide}\n      onFocus={onTriggerFocus}\n      onBlur={onBlurCapture}\n      onClick={onTriggerClick}\n      onKeyDown={onTriggerKeyDown}\n      tabIndex={0}\n      role=\"button\"\n      aria-haspopup=\"dialog\"\n      aria-expanded={open}\n      aria-label={`${heading} — show source`}\n    >\n      {children}\n      {open &&\n        createPortal(\n          /* eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions -- keyboard dismissal on a focused non-modal dialog container is the WAI-ARIA pattern; links inside keep their own semantics */\n          <span\n            ref={floatingRef}\n            role=\"dialog\"\n            aria-label={heading}\n            tabIndex={-1}\n            onMouseEnter={show}\n            onMouseLeave={scheduleHide}\n            onBlurCapture={onBlurCapture}\n            onKeyDown={onDialogKeyDown}\n            className=\"focus-visible:ring-ring z-50 block w-80 rounded-lg outline-none focus-visible:ring-2\"\n            style={style}\n          >\n            <span className=\"border-border bg-card block overflow-hidden rounded-lg border text-start font-normal tracking-normal normal-case shadow-xl ring-1 ring-black/5 dark:ring-white/10\">\n              <span className=\"from-primary-700 to-primary-600 block bg-gradient-to-br px-3.5 py-2.5\">\n                <span className=\"text-primary-100/90 block text-[10px] font-bold tracking-wide uppercase\">\n                  {eyebrow}\n                </span>\n                <span className=\"mt-0.5 block text-sm leading-snug font-semibold text-white\">\n                  {heading}\n                </span>\n              </span>\n\n              {(note || hasSources) && (\n                <span className=\"block px-3.5 py-2.5\">\n                  {note && (\n                    <span className=\"text-muted-foreground block text-[13px] leading-relaxed\">\n                      {note}\n                    </span>\n                  )}\n                  {hasSources && (\n                    <span\n                      className={cn(\n                        'block',\n                        note &&\n                          'border-border mt-2.5 border-t border-dashed pt-2.5'\n                      )}\n                    >\n                      <span className=\"text-muted-foreground block text-[10px] font-bold tracking-wide uppercase\">\n                        {sources!.length === 1\n                          ? 'Source'\n                          : `${sources!.length} sources`}\n                      </span>\n                      <span className=\"block max-h-52 overflow-y-auto\">\n                        {sources!.map((s, i) => (\n                          <span\n                            key={`${s.label}-${i}`}\n                            className=\"mt-1.5 flex items-center gap-2\"\n                          >\n                            <span\n                              aria-hidden=\"true\"\n                              className=\"bg-primary-400 h-1.5 w-1.5 shrink-0 rounded-full\"\n                            />\n                            {s.url ? (\n                              <a\n                                href={s.url}\n                                target=\"_blank\"\n                                rel=\"noopener noreferrer\"\n                                className=\"text-primary-600 hover:text-primary-500 dark:text-primary-400 dark:hover:text-primary-300 min-w-0 flex-1 truncate text-xs font-semibold\"\n                              >\n                                {s.label}\n                              </a>\n                            ) : (\n                              <span className=\"text-muted-foreground min-w-0 flex-1 truncate text-xs\">\n                                {s.label}\n                              </span>\n                            )}\n                            {s.sub && (\n                              <span className=\"text-muted-foreground/70 shrink-0 text-[11px]\">\n                                {s.sub}\n                              </span>\n                            )}\n                          </span>\n                        ))}\n                      </span>\n                    </span>\n                  )}\n                </span>\n              )}\n            </span>\n          </span>,\n          document.body\n        )}\n    </span>\n  );\n}\n"]}
+{"version":3,"sources":["../src/components/SourceTip/SourceTip.tsx"],"names":["React","useAnchoredPosition","useEscapeKey","jsxs","cn","createPortal","jsx"],"mappings":"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","file":"chunk-AHHFFXJR.cjs","sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { createPortal } from 'react-dom';\nimport { cn } from '../../utils/cn';\nimport { useAnchoredPosition } from '../../hooks/useAnchoredPosition';\nimport { useEscapeKey } from '../../hooks/useEscapeKey';\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/** One line of provenance shown in the card. */\nexport interface TipSource {\n  /** One-line label — statute name or source title. Truncated on render. */\n  label: string;\n  /** Source URL. Omit for a provenance line that isn't linkable. */\n  url?: string;\n  /** Secondary label shown at the end (publisher / host / year). */\n  sub?: string;\n}\n\nexport interface SourceTipProps {\n  /** The claim this card explains — the card's heading. */\n  heading: string;\n  /** Free-text provenance, for facts no public URL can verify. */\n  note?: string;\n  /** Linked (or unlinked) one-line sources. */\n  sources?: TipSource[];\n  /** Eyebrow above the heading. Defaults to \"Source\". */\n  eyebrow?: string;\n  /** The visible trigger. */\n  children: React.ReactNode;\n  className?: string;\n  /**\n   * Underline the trigger with a dashed rule marking a hoverable claim.\n   * Leave off in table cells, which signal hoverability by their own\n   * treatment rather than by underlining every cell.\n   */\n  underline?: boolean;\n}\n\nconst HIDE_GRACE_MS = 180;\n\n// =============================================================================\n// SourceTip\n// =============================================================================\n\n/**\n * A hover card answering \"what backs this claim?\" — an eyebrow + heading,\n * optional free-text provenance, and a list of one-line source links.\n * Suits stat tiles, table cells, and inline facts where a numbered footnote\n * would be overkill.\n *\n * The trigger and card are phrasing content (`span`/`a` only), so it is\n * valid inside `<p>` prose and table cells. The card portals to `body` with\n * fixed positioning, flipping and clamping to stay in the viewport. On\n * touch, a tap pins the card; Escape or an outside tap closes it. A pinned\n * card behaves as a non-modal dialog — focus moves into it so its source\n * links are keyboard-reachable, and returns to the trigger on close.\n *\n * @example\n * ```tsx\n * <SourceTip\n *   heading=\"OSHA recordable rate\"\n *   sources={[{ label: 'BLS SOII 2023', url: 'https://www.bls.gov/iif/', sub: 'BLS' }]}\n *   underline\n * >\n *   2.4 per 100 FTE\n * </SourceTip>\n * ```\n */\nexport function SourceTip({\n  heading,\n  note,\n  sources,\n  eyebrow = 'Source',\n  children,\n  className,\n  underline = false,\n}: SourceTipProps) {\n  const [open, setOpen] = React.useState(false);\n  const [pinned, setPinned] = React.useState(false);\n  const timer = React.useRef<ReturnType<typeof setTimeout> | null>(null);\n  // True while close() restores focus to the trigger, so the trigger's\n  // focus-show doesn't immediately reopen a card the user just dismissed.\n  const suppressFocusShow = React.useRef(false);\n\n  const { anchorRef, floatingRef, style } = useAnchoredPosition<\n    HTMLSpanElement,\n    HTMLSpanElement\n  >({\n    open,\n    placement: 'top',\n    offset: 10,\n    viewportPadding: 8,\n    allowFlip: true,\n  });\n\n  const clearHideTimer = () => {\n    if (timer.current) {\n      clearTimeout(timer.current);\n      timer.current = null;\n    }\n  };\n\n  const show = React.useCallback(() => {\n    clearHideTimer();\n    setOpen(true);\n  }, []);\n\n  const scheduleHide = React.useCallback(() => {\n    if (pinned) return;\n    clearHideTimer();\n    timer.current = setTimeout(() => setOpen(false), HIDE_GRACE_MS);\n  }, [pinned]);\n\n  const close = React.useCallback(() => {\n    clearHideTimer();\n    setPinned(false);\n    setOpen(false);\n    // Return focus to the trigger if it was inside the card.\n    if (floatingRef.current?.contains(document.activeElement)) {\n      suppressFocusShow.current = true;\n      anchorRef.current?.focus();\n    }\n  }, [anchorRef, floatingRef]);\n\n  React.useEffect(() => () => clearHideTimer(), []);\n\n  // A pinned card is a non-modal dialog: move focus into it so its links\n  // are reachable by keyboard.\n  React.useEffect(() => {\n    if (pinned) floatingRef.current?.focus();\n  }, [pinned, floatingRef]);\n\n  useEscapeKey(close, open);\n\n  // Pinned cards close on an outside tap; hover cards close on their own.\n  React.useEffect(() => {\n    if (!open || !pinned) return;\n    const onPointer = (e: Event) => {\n      const t = e.target as Node;\n      if (anchorRef.current?.contains(t) || floatingRef.current?.contains(t))\n        return;\n      close();\n    };\n    document.addEventListener('mousedown', onPointer);\n    document.addEventListener('touchstart', onPointer);\n    return () => {\n      document.removeEventListener('mousedown', onPointer);\n      document.removeEventListener('touchstart', onPointer);\n    };\n  }, [open, pinned, close, anchorRef, floatingRef]);\n\n  // Touch has no hover: tap pins the card instead of falling through.\n  const onTriggerClick = () => {\n    const coarse =\n      typeof window !== 'undefined' &&\n      window.matchMedia('(hover: none)').matches;\n    if (!coarse) return;\n    togglePin();\n  };\n\n  const togglePin = () => {\n    if (pinned) close();\n    else {\n      setPinned(true);\n      show();\n    }\n  };\n\n  const onTriggerKeyDown = (e: React.KeyboardEvent<HTMLSpanElement>) => {\n    if (e.key === 'Enter' || e.key === ' ') {\n      e.preventDefault();\n      togglePin();\n    }\n  };\n\n  // Focus lives on the dialog container once pinned, so Enter/Space there\n  // (not on a link inside) must also unpin — the trigger no longer has focus.\n  const onDialogKeyDown = (e: React.KeyboardEvent<HTMLSpanElement>) => {\n    if (e.target !== e.currentTarget) return;\n    if (e.key === 'Enter' || e.key === ' ') {\n      e.preventDefault();\n      close();\n    }\n  };\n\n  const onTriggerFocus = () => {\n    if (suppressFocusShow.current) {\n      suppressFocusShow.current = false;\n      return;\n    }\n    show();\n  };\n\n  const onBlurCapture = (e: React.FocusEvent<HTMLSpanElement>) => {\n    const next = e.relatedTarget as Node | null;\n    if (\n      next &&\n      (anchorRef.current?.contains(next) || floatingRef.current?.contains(next))\n    )\n      return;\n    scheduleHide();\n  };\n\n  const hasSources = Boolean(sources && sources.length > 0);\n\n  return (\n    <span\n      ref={anchorRef}\n      className={cn(\n        'cursor-help',\n        underline &&\n          'decoration-primary-400/70 underline decoration-dashed underline-offset-4',\n        className\n      )}\n      onMouseEnter={show}\n      onMouseLeave={scheduleHide}\n      onFocus={onTriggerFocus}\n      onBlur={onBlurCapture}\n      onClick={onTriggerClick}\n      onKeyDown={onTriggerKeyDown}\n      tabIndex={0}\n      role=\"button\"\n      aria-haspopup=\"dialog\"\n      aria-expanded={open}\n      aria-label={`${heading} — show source`}\n    >\n      {children}\n      {open &&\n        createPortal(\n          /* eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions -- keyboard dismissal on a focused non-modal dialog container is the WAI-ARIA pattern; links inside keep their own semantics */\n          <span\n            ref={floatingRef}\n            role=\"dialog\"\n            aria-label={heading}\n            tabIndex={-1}\n            onMouseEnter={show}\n            onMouseLeave={scheduleHide}\n            onBlurCapture={onBlurCapture}\n            onKeyDown={onDialogKeyDown}\n            className=\"focus-visible:ring-ring z-50 block w-80 rounded-lg outline-none focus-visible:ring-2\"\n            style={style}\n          >\n            <span className=\"border-border bg-card block overflow-hidden rounded-lg border text-start font-normal tracking-normal normal-case shadow-xl ring-1 ring-black/5 dark:ring-white/10\">\n              <span className=\"from-primary-700 to-primary-600 block bg-gradient-to-br px-3.5 py-2.5\">\n                <span className=\"text-primary-100/90 block text-[10px] font-bold tracking-wide uppercase\">\n                  {eyebrow}\n                </span>\n                <span className=\"mt-0.5 block text-sm leading-snug font-semibold text-white\">\n                  {heading}\n                </span>\n              </span>\n\n              {(note || hasSources) && (\n                <span className=\"block px-3.5 py-2.5\">\n                  {note && (\n                    <span className=\"text-muted-foreground block text-[13px] leading-relaxed\">\n                      {note}\n                    </span>\n                  )}\n                  {hasSources && (\n                    <span\n                      className={cn(\n                        'block',\n                        note &&\n                          'border-border mt-2.5 border-t border-dashed pt-2.5'\n                      )}\n                    >\n                      <span className=\"text-muted-foreground block text-[10px] font-bold tracking-wide uppercase\">\n                        {sources!.length === 1\n                          ? 'Source'\n                          : `${sources!.length} sources`}\n                      </span>\n                      <span className=\"block max-h-52 overflow-y-auto\">\n                        {sources!.map((s, i) => (\n                          <span\n                            key={`${s.label}-${i}`}\n                            className=\"mt-1.5 flex items-center gap-2\"\n                          >\n                            <span\n                              aria-hidden=\"true\"\n                              className=\"bg-primary-400 h-1.5 w-1.5 shrink-0 rounded-full\"\n                            />\n                            {s.url ? (\n                              <a\n                                href={s.url}\n                                target=\"_blank\"\n                                rel=\"noopener noreferrer\"\n                                className=\"text-primary-600 hover:text-primary-500 dark:text-primary-400 dark:hover:text-primary-300 min-w-0 flex-1 truncate text-xs font-semibold\"\n                              >\n                                {s.label}\n                              </a>\n                            ) : (\n                              <span className=\"text-muted-foreground min-w-0 flex-1 truncate text-xs\">\n                                {s.label}\n                              </span>\n                            )}\n                            {s.sub && (\n                              <span className=\"text-muted-foreground/70 shrink-0 text-[11px]\">\n                                {s.sub}\n                              </span>\n                            )}\n                          </span>\n                        ))}\n                      </span>\n                    </span>\n                  )}\n                </span>\n              )}\n            </span>\n          </span>,\n          document.body\n        )}\n    </span>\n  );\n}\n"]}

package/dist/{chunk-VILW53UZ.js → chunk-BIQ7GSO2.js}

@@ -1,4 +1,4 @@
-import { Modal, ModalHeader, ModalTitle, ModalClose, ModalBody, ModalFooter } from './chunk-5JJ2DAE4.js';
+import { Modal, ModalHeader, ModalTitle, ModalClose, ModalBody, ModalFooter } from './chunk-ENMXHZNE.js';
 import { cn } from './chunk-TQONQSJO.js';
 import * as React from 'react';
 import { Keyboard } from 'lucide-react';
@@ -101,5 +101,5 @@ function KeyboardShortcutsOverlay({
 }
 
 export { Kbd, KeyboardShortcutsOverlay };
-//# sourceMappingURL=chunk-VILW53UZ.js.map
-//# sourceMappingURL=chunk-VILW53UZ.js.map
+//# sourceMappingURL=chunk-BIQ7GSO2.js.map
+//# sourceMappingURL=chunk-BIQ7GSO2.js.map

package/dist/{chunk-VILW53UZ.js.map → chunk-BIQ7GSO2.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/components/KeyboardShortcutsOverlay/KeyboardShortcutsOverlay.tsx"],"names":["Kbd","Fragment"],"mappings":"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","file":"chunk-VILW53UZ.js","sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { Keyboard } from 'lucide-react';\nimport { cn } from '../../utils/cn';\nimport {\n  Modal,\n  ModalHeader,\n  ModalTitle,\n  ModalClose,\n  ModalBody,\n  ModalFooter,\n} from '../Modal';\n\n// =============================================================================\n// Kbd\n// =============================================================================\n\nexport type KbdProps = React.HTMLAttributes<HTMLElement>;\n\n/** A keyboard-key chip: `<Kbd>⌘K</Kbd>`. */\nexport const Kbd = React.forwardRef<HTMLElement, KbdProps>(function Kbd(\n  { className, ...props },\n  ref\n) {\n  return (\n    <kbd\n      ref={ref}\n      className={cn(\n        'border-border bg-muted text-foreground rounded border px-1.5 py-0.5 font-mono text-[11px]',\n        className\n      )}\n      {...props}\n    />\n  );\n});\n\n// =============================================================================\n// KeyboardShortcutsOverlay\n// =============================================================================\n\nexport interface ShortcutDef {\n  /** Key or alternatives — `\"j\"`, `[\"j\", \"↓\"]`, `\"⌘K\"`. */\n  keys: string | string[];\n  description: string;\n}\n\nexport interface ShortcutGroup {\n  title: string;\n  shortcuts: ShortcutDef[];\n}\n\nexport interface KeyboardShortcutsOverlayProps {\n  open: boolean;\n  onClose: () => void;\n  /** Flat list of shortcuts, or use `groups` for sectioned help. */\n  shortcuts?: ShortcutDef[];\n  /** Sectioned shortcuts with group headings. */\n  groups?: ShortcutGroup[];\n  title?: string;\n  /** Footer hint. Pass `null` to hide it. */\n  hint?: React.ReactNode | null;\n  /** Joins key alternatives (default \"or\"), overridable for i18n. */\n  alternativesLabel?: string;\n}\n\nfunction Keys({\n  keys,\n  alternativesLabel,\n}: {\n  keys: string | string[];\n  alternativesLabel: string;\n}) {\n  const list = Array.isArray(keys) ? keys : keys.split(' / ');\n  return (\n    <span className=\"flex shrink-0 items-center gap-1\">\n      {list.map((k, i) => (\n        <React.Fragment key={`${k}-${i}`}>\n          <Kbd>{k}</Kbd>\n          {i < list.length - 1 && (\n            <span className=\"text-muted-foreground mx-0.5 text-xs\">\n              {alternativesLabel}\n            </span>\n          )}\n        </React.Fragment>\n      ))}\n    </span>\n  );\n}\n\nfunction ShortcutList({\n  shortcuts,\n  alternativesLabel,\n}: {\n  shortcuts: ShortcutDef[];\n  alternativesLabel: string;\n}) {\n  return (\n    <ul className=\"flex list-none flex-col gap-2 p-0\">\n      {shortcuts.map((s) => (\n        <li\n          key={`${s.description}-${String(s.keys)}`}\n          className=\"text-foreground flex items-center justify-between gap-4 text-sm\"\n        >\n          <span className=\"min-w-0\">{s.description}</span>\n          <Keys keys={s.keys} alternativesLabel={alternativesLabel} />\n        </li>\n      ))}\n    </ul>\n  );\n}\n\n/**\n * The `?` keyboard-shortcuts help dialog: a list of shortcut rows\n * (optionally grouped) with `Kbd` chips for each key. Pairs with the\n * `useKeyboardShortcut` hook, which handles the binding — this component\n * only renders the help.\n *\n * @example\n * ```tsx\n * const [open, setOpen] = useState(false);\n * useKeyboardShortcut('?', () => setOpen((v) => !v), {\n *   modifiers: { shift: true },\n * });\n *\n * <KeyboardShortcutsOverlay\n *   open={open}\n *   onClose={() => setOpen(false)}\n *   shortcuts={[\n *     { keys: ['j', '↓'], description: 'Next record' },\n *     { keys: '⌘K', description: 'Command palette' },\n *   ]}\n * />\n * ```\n */\nexport function KeyboardShortcutsOverlay({\n  open,\n  onClose,\n  shortcuts,\n  groups,\n  title = 'Keyboard shortcuts',\n  hint,\n  alternativesLabel = 'or',\n}: KeyboardShortcutsOverlayProps) {\n  const defaultHint = (\n    <>\n      Press <Kbd>?</Kbd> anytime to toggle this help\n    </>\n  );\n  const footer = hint === null ? null : (hint ?? defaultHint);\n\n  return (\n    <Modal\n      open={open}\n      onOpenChange={(o) => {\n        if (!o) onClose();\n      }}\n      size=\"sm\"\n      aria-label={title}\n    >\n      <ModalHeader>\n        <ModalTitle className=\"flex items-center gap-2 text-sm\">\n          <Keyboard aria-hidden=\"true\" className=\"text-primary-500 h-4 w-4\" />\n          {title}\n        </ModalTitle>\n        <ModalClose />\n      </ModalHeader>\n      <ModalBody className=\"flex flex-col gap-4\">\n        {shortcuts && (\n          <ShortcutList\n            shortcuts={shortcuts}\n            alternativesLabel={alternativesLabel}\n          />\n        )}\n        {groups?.map((group) => (\n          <div key={group.title} className=\"flex flex-col gap-2\">\n            <h3 className=\"text-muted-foreground text-xs font-semibold tracking-wide uppercase\">\n              {group.title}\n            </h3>\n            <ShortcutList\n              shortcuts={group.shortcuts}\n              alternativesLabel={alternativesLabel}\n            />\n          </div>\n        ))}\n      </ModalBody>\n      {footer && (\n        <ModalFooter className=\"text-muted-foreground justify-center text-[11px]\">\n          <span>{footer}</span>\n        </ModalFooter>\n      )}\n    </Modal>\n  );\n}\n"]}
+{"version":3,"sources":["../src/components/KeyboardShortcutsOverlay/KeyboardShortcutsOverlay.tsx"],"names":["Kbd","Fragment"],"mappings":"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","file":"chunk-BIQ7GSO2.js","sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { Keyboard } from 'lucide-react';\nimport { cn } from '../../utils/cn';\nimport {\n  Modal,\n  ModalHeader,\n  ModalTitle,\n  ModalClose,\n  ModalBody,\n  ModalFooter,\n} from '../Modal';\n\n// =============================================================================\n// Kbd\n// =============================================================================\n\nexport type KbdProps = React.HTMLAttributes<HTMLElement>;\n\n/** A keyboard-key chip: `<Kbd>⌘K</Kbd>`. */\nexport const Kbd = React.forwardRef<HTMLElement, KbdProps>(function Kbd(\n  { className, ...props },\n  ref\n) {\n  return (\n    <kbd\n      ref={ref}\n      className={cn(\n        'border-border bg-muted text-foreground rounded border px-1.5 py-0.5 font-mono text-[11px]',\n        className\n      )}\n      {...props}\n    />\n  );\n});\n\n// =============================================================================\n// KeyboardShortcutsOverlay\n// =============================================================================\n\nexport interface ShortcutDef {\n  /** Key or alternatives — `\"j\"`, `[\"j\", \"↓\"]`, `\"⌘K\"`. */\n  keys: string | string[];\n  description: string;\n}\n\nexport interface ShortcutGroup {\n  title: string;\n  shortcuts: ShortcutDef[];\n}\n\nexport interface KeyboardShortcutsOverlayProps {\n  open: boolean;\n  onClose: () => void;\n  /** Flat list of shortcuts, or use `groups` for sectioned help. */\n  shortcuts?: ShortcutDef[];\n  /** Sectioned shortcuts with group headings. */\n  groups?: ShortcutGroup[];\n  title?: string;\n  /** Footer hint. Pass `null` to hide it. */\n  hint?: React.ReactNode | null;\n  /** Joins key alternatives (default \"or\"), overridable for i18n. */\n  alternativesLabel?: string;\n}\n\nfunction Keys({\n  keys,\n  alternativesLabel,\n}: {\n  keys: string | string[];\n  alternativesLabel: string;\n}) {\n  const list = Array.isArray(keys) ? keys : keys.split(' / ');\n  return (\n    <span className=\"flex shrink-0 items-center gap-1\">\n      {list.map((k, i) => (\n        <React.Fragment key={`${k}-${i}`}>\n          <Kbd>{k}</Kbd>\n          {i < list.length - 1 && (\n            <span className=\"text-muted-foreground mx-0.5 text-xs\">\n              {alternativesLabel}\n            </span>\n          )}\n        </React.Fragment>\n      ))}\n    </span>\n  );\n}\n\nfunction ShortcutList({\n  shortcuts,\n  alternativesLabel,\n}: {\n  shortcuts: ShortcutDef[];\n  alternativesLabel: string;\n}) {\n  return (\n    <ul className=\"flex list-none flex-col gap-2 p-0\">\n      {shortcuts.map((s) => (\n        <li\n          key={`${s.description}-${String(s.keys)}`}\n          className=\"text-foreground flex items-center justify-between gap-4 text-sm\"\n        >\n          <span className=\"min-w-0\">{s.description}</span>\n          <Keys keys={s.keys} alternativesLabel={alternativesLabel} />\n        </li>\n      ))}\n    </ul>\n  );\n}\n\n/**\n * The `?` keyboard-shortcuts help dialog: a list of shortcut rows\n * (optionally grouped) with `Kbd` chips for each key. Pairs with the\n * `useKeyboardShortcut` hook, which handles the binding — this component\n * only renders the help.\n *\n * @example\n * ```tsx\n * const [open, setOpen] = useState(false);\n * useKeyboardShortcut('?', () => setOpen((v) => !v), {\n *   modifiers: { shift: true },\n * });\n *\n * <KeyboardShortcutsOverlay\n *   open={open}\n *   onClose={() => setOpen(false)}\n *   shortcuts={[\n *     { keys: ['j', '↓'], description: 'Next record' },\n *     { keys: '⌘K', description: 'Command palette' },\n *   ]}\n * />\n * ```\n */\nexport function KeyboardShortcutsOverlay({\n  open,\n  onClose,\n  shortcuts,\n  groups,\n  title = 'Keyboard shortcuts',\n  hint,\n  alternativesLabel = 'or',\n}: KeyboardShortcutsOverlayProps) {\n  const defaultHint = (\n    <>\n      Press <Kbd>?</Kbd> anytime to toggle this help\n    </>\n  );\n  const footer = hint === null ? null : (hint ?? defaultHint);\n\n  return (\n    <Modal\n      open={open}\n      onOpenChange={(o) => {\n        if (!o) onClose();\n      }}\n      size=\"sm\"\n      aria-label={title}\n    >\n      <ModalHeader>\n        <ModalTitle className=\"flex items-center gap-2 text-sm\">\n          <Keyboard aria-hidden=\"true\" className=\"text-primary-500 h-4 w-4\" />\n          {title}\n        </ModalTitle>\n        <ModalClose />\n      </ModalHeader>\n      <ModalBody className=\"flex flex-col gap-4\">\n        {shortcuts && (\n          <ShortcutList\n            shortcuts={shortcuts}\n            alternativesLabel={alternativesLabel}\n          />\n        )}\n        {groups?.map((group) => (\n          <div key={group.title} className=\"flex flex-col gap-2\">\n            <h3 className=\"text-muted-foreground text-xs font-semibold tracking-wide uppercase\">\n              {group.title}\n            </h3>\n            <ShortcutList\n              shortcuts={group.shortcuts}\n              alternativesLabel={alternativesLabel}\n            />\n          </div>\n        ))}\n      </ModalBody>\n      {footer && (\n        <ModalFooter className=\"text-muted-foreground justify-center text-[11px]\">\n          <span>{footer}</span>\n        </ModalFooter>\n      )}\n    </Modal>\n  );\n}\n"]}

package/dist/chunk-BM35CACB.js

@@ -0,0 +1,148 @@
+import * as React from 'react';
+
+// src/hooks/useStickToBottom.ts
+function pinToBottom(el) {
+  el.scrollTop = el.scrollHeight;
+}
+function useStickToBottom({
+  threshold = 100,
+  disabled = false
+} = {}) {
+  const containerRef = React.useRef(null);
+  const contentRef = React.useRef(null);
+  const [isAtBottom, setIsAtBottom] = React.useState(true);
+  const pinnedRef = React.useRef(true);
+  const readingRef = React.useRef(false);
+  const anchorTargetRef = React.useRef(null);
+  const anchorDistanceRef = React.useRef(Infinity);
+  const [containerEl, setContainerEl] = React.useState(
+    null
+  );
+  const [contentEl, setContentEl] = React.useState(null);
+  React.useEffect(() => {
+    if (containerRef.current !== containerEl)
+      setContainerEl(containerRef.current);
+    if (contentRef.current !== contentEl) setContentEl(contentRef.current);
+  });
+  React.useEffect(() => {
+    if (disabled) return;
+    const el = containerEl;
+    if (!el) return;
+    const handleScroll = () => {
+      const anchorTarget = anchorTargetRef.current;
+      if (anchorTarget != null) {
+        const distance = Math.abs(el.scrollTop - anchorTarget);
+        if (distance < 2) {
+          anchorTargetRef.current = null;
+        } else if (distance > anchorDistanceRef.current + 1) {
+          anchorTargetRef.current = null;
+        } else {
+          anchorDistanceRef.current = distance;
+          return;
+        }
+      }
+      const atBottom = el.scrollHeight - el.scrollTop - el.clientHeight <= threshold;
+      if (!atBottom) readingRef.current = false;
+      pinnedRef.current = atBottom && !readingRef.current;
+      setIsAtBottom(atBottom);
+    };
+    if (pinnedRef.current) pinToBottom(el);
+    handleScroll();
+    el.addEventListener("scroll", handleScroll, { passive: true });
+    return () => el.removeEventListener("scroll", handleScroll);
+  }, [containerEl, threshold, disabled]);
+  React.useEffect(() => {
+    if (disabled) return;
+    const el = containerEl;
+    if (!el || typeof globalThis.ResizeObserver === "undefined") return;
+    const observer = new globalThis.ResizeObserver(() => {
+      if (pinnedRef.current) {
+        pinToBottom(el);
+        return;
+      }
+      if (anchorTargetRef.current != null) return;
+      const atBottom = el.scrollHeight - el.scrollTop - el.clientHeight <= threshold;
+      if (!atBottom) readingRef.current = false;
+      setIsAtBottom(atBottom);
+    });
+    observer.observe(el);
+    if (contentEl) observer.observe(contentEl);
+    return () => observer.disconnect();
+  }, [containerEl, contentEl, threshold, disabled]);
+  const scrollToBottom = React.useCallback(
+    (behavior = "auto") => {
+      const el = containerRef.current;
+      if (!el) return;
+      readingRef.current = false;
+      anchorTargetRef.current = null;
+      pinnedRef.current = true;
+      setIsAtBottom(true);
+      if (typeof el.scrollTo === "function") {
+        el.scrollTo({ top: el.scrollHeight, behavior });
+      } else {
+        pinToBottom(el);
+      }
+    },
+    []
+  );
+  const anchorToTurnStart = React.useCallback(
+    (target, behavior = "auto") => {
+      const el = containerRef.current;
+      if (!el) return;
+      readingRef.current = true;
+      pinnedRef.current = false;
+      const top = Math.min(
+        target.getBoundingClientRect().top - el.getBoundingClientRect().top + el.scrollTop,
+        el.scrollHeight - el.clientHeight
+      );
+      if (Math.abs(el.scrollTop - top) < 2) return;
+      anchorTargetRef.current = top;
+      anchorDistanceRef.current = Infinity;
+      if (typeof el.scrollTo === "function") {
+        el.scrollTo({ top, behavior });
+      } else {
+        el.scrollTop = top;
+      }
+    },
+    []
+  );
+  const followIfPinned = React.useCallback(
+    (behavior = "auto") => {
+      if (!pinnedRef.current) return false;
+      scrollToBottom(behavior);
+      return true;
+    },
+    [scrollToBottom]
+  );
+  const stopFollowing = React.useCallback(() => {
+    readingRef.current = true;
+    pinnedRef.current = false;
+  }, []);
+  return {
+    containerRef,
+    contentRef,
+    isAtBottom,
+    scrollToBottom,
+    anchorToTurnStart,
+    followIfPinned,
+    stopFollowing
+  };
+}
+function useStreamEndedBelowFold(newest, isAtBottom, onEnded, onEndedAtBottom) {
+  const streamingIdRef = React.useRef(null);
+  React.useEffect(() => {
+    if (newest?.status === "streaming") {
+      streamingIdRef.current = newest.id;
+      return;
+    }
+    if (streamingIdRef.current && newest?.id === streamingIdRef.current) {
+      streamingIdRef.current = null;
+      if (!isAtBottom) onEnded();
+      else onEndedAtBottom?.();
+    }
+  }, [newest, isAtBottom, onEnded, onEndedAtBottom]);
+}
+
+export { useStickToBottom, useStreamEndedBelowFold };
+//# sourceMappingURL=chunk-BM35CACB.js.map
+//# sourceMappingURL=chunk-BM35CACB.js.map

package/dist/chunk-BM35CACB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useStickToBottom.ts"],"names":[],"mappings":"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","file":"chunk-BM35CACB.js","sourcesContent":["import * as React from 'react';\n\n/**\n * Options for {@link useStickToBottom}.\n */\nexport interface UseStickToBottomOptions {\n  /**\n   * Distance from the bottom (px) within which the user still counts as \"at\n   * the bottom\" — small offsets from rounding or momentum scrolling shouldn't\n   * break pinning.\n   */\n  threshold?: number;\n  /**\n   * Disable all behavior (listeners and observers detach). Useful when the\n   * scroll container anchors somewhere other than the bottom (e.g. a\n   * newest-first feed).\n   */\n  disabled?: boolean;\n}\n\nexport interface UseStickToBottomReturn {\n  /** Attach to the scrollable container. */\n  containerRef: React.RefObject<HTMLDivElement | null>;\n  /**\n   * Attach to the element wrapping the container's content. Its growth (e.g.\n   * a streaming message) re-pins the scroll while the user is at the bottom.\n   */\n  contentRef: React.RefObject<HTMLDivElement | null>;\n  /** Whether the user is currently at (or within `threshold` of) the bottom. */\n  isAtBottom: boolean;\n  /** Scroll to the bottom and resume pinning. */\n  scrollToBottom: (behavior?: ScrollBehavior) => void;\n  /**\n   * Scroll so `target`'s top aligns with the viewport top and enter “reading”\n   * mode: content growing past the fold no longer auto-follows, so the reader\n   * consumes the response at their own pace (the ChatGPT/Claude send UX).\n   * Following resumes when they explicitly return to the bottom — a\n   * jump-to-bottom click (`scrollToBottom`) or scrolling there by hand.\n   */\n  anchorToTurnStart: (target: HTMLElement, behavior?: ScrollBehavior) => void;\n  /**\n   * Scroll to the bottom only while actually following (at the bottom and not\n   * in reading mode). Returns whether it scrolled — hosts use this to decide\n   * between following an appended message and raising a “new messages” hint.\n   */\n  followIfPinned: (behavior?: ScrollBehavior) => boolean;\n  /**\n   * Hold the current position: enter reading mode without scrolling, so an\n   * incoming stream fills below the fold instead of pushing the view up.\n   * Call right after a streaming message appends (optionally after revealing\n   * its first line with `followIfPinned`). Following resumes exactly as after\n   * `anchorToTurnStart`: an explicit `scrollToBottom` or the reader returning\n   * to the bottom by hand.\n   */\n  stopFollowing: () => void;\n}\n\nfunction pinToBottom(el: HTMLElement) {\n  el.scrollTop = el.scrollHeight;\n}\n\n/**\n * Keeps a scroll container pinned to its bottom edge while the user is there,\n * and — crucially — leaves the scroll position alone once they scroll up.\n *\n * Designed for chat threads with streaming responses:\n * - While the user is at the bottom, content growth (new tokens, new\n *   messages) and container resizes (on-screen keyboard, growing composer)\n *   keep the newest content in view via a `ResizeObserver` on both the\n *   content and the container.\n * - Once the user scrolls up, nothing moves until they return to the bottom\n *   themselves or the host calls `scrollToBottom` (e.g. a jump-to-bottom\n *   button, or an outgoing message from the local user).\n *\n * The hook only pins; *when* to force a scroll (own message sent, thread\n * switched) stays a host decision through `scrollToBottom`,\n * `anchorToTurnStart` (ChatGPT-style: scroll a fresh turn to the viewport top\n * and pause following while the reader digests the reply), and\n * `followIfPinned` (follow an append only while actually at the bottom).\n *\n * @example\n * ```tsx\n * const { containerRef, contentRef, isAtBottom, scrollToBottom } =\n *   useStickToBottom();\n * return (\n *   <div className=\"relative min-h-0 flex-1\">\n *     <div ref={containerRef} className=\"h-full overflow-y-auto\">\n *       <div ref={contentRef}>{rows}</div>\n *     </div>\n *     {!isAtBottom && <JumpToBottom onClick={() => scrollToBottom('smooth')} />}\n *   </div>\n * );\n * ```\n */\nexport function useStickToBottom({\n  threshold = 100,\n  disabled = false,\n}: UseStickToBottomOptions = {}): UseStickToBottomReturn {\n  const containerRef = React.useRef<HTMLDivElement>(null);\n  const contentRef = React.useRef<HTMLDivElement>(null);\n  const [isAtBottom, setIsAtBottom] = React.useState(true);\n  // Mirror of `isAtBottom` readable synchronously from observer callbacks\n  // without re-subscribing them on every scroll.\n  const pinnedRef = React.useRef(true);\n  // “Reading” mode (entered via `anchorToTurnStart`): the viewport sits at the\n  // reserved space below a fresh turn — geometrically the bottom — but growth\n  // must NOT follow. Cleared once the position genuinely leaves the bottom\n  // (content outgrew the reserve or the user scrolled up), after which the\n  // normal pin-at-bottom rules apply again.\n  const readingRef = React.useRef(false);\n  // In-flight anchor animation: a smooth `anchorToTurnStart` fires scroll\n  // events that are neither the user's nor at the bottom — they must not end\n  // reading mode or re-pin. Cleared on arrival at the target, or when the\n  // distance to it grows (the user grabbed the scroll mid-animation).\n  const anchorTargetRef = React.useRef<number | null>(null);\n  const anchorDistanceRef = React.useRef(Infinity);\n\n  // Hosts can re-attach the refs to new DOM nodes without remounting (e.g.\n  // SuperChat swapping its plain thread for the virtualized one when the\n  // conversation grows). Mirror the current nodes into state so the listener\n  // and observer effects below re-bind whenever the target changes.\n  const [containerEl, setContainerEl] = React.useState<HTMLDivElement | null>(\n    null\n  );\n  const [contentEl, setContentEl] = React.useState<HTMLDivElement | null>(null);\n  // Intentionally dep-less: ref mutations don't trigger renders, so this must\n  // check after every render. The inequality guards make it settle immediately.\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  React.useEffect(() => {\n    if (containerRef.current !== containerEl)\n      setContainerEl(containerRef.current);\n    if (contentRef.current !== contentEl) setContentEl(contentRef.current);\n  });\n\n  // Track the user's position: at (or near) the bottom means \"pinned\".\n  React.useEffect(() => {\n    if (disabled) return;\n    const el = containerEl;\n    if (!el) return;\n\n    const handleScroll = () => {\n      const anchorTarget = anchorTargetRef.current;\n      if (anchorTarget != null) {\n        const distance = Math.abs(el.scrollTop - anchorTarget);\n        if (distance < 2) {\n          anchorTargetRef.current = null; // arrived — handle normally\n        } else if (distance > anchorDistanceRef.current + 1) {\n          anchorTargetRef.current = null; // user took over mid-animation\n        } else {\n          anchorDistanceRef.current = distance;\n          return; // the animation's own events don't change pinning\n        }\n      }\n      const atBottom =\n        el.scrollHeight - el.scrollTop - el.clientHeight <= threshold;\n      if (!atBottom) readingRef.current = false;\n      pinnedRef.current = atBottom && !readingRef.current;\n      setIsAtBottom(atBottom);\n    };\n\n    // A freshly attached node starts at `scrollTop` 0 — re-assert carried-over\n    // pinning (e.g. across SuperChat's plain ⇄ virtualized swap) instead of\n    // letting the initial read demote a pinned reader to \"scrolled up\".\n    if (pinnedRef.current) pinToBottom(el);\n    handleScroll(); // initial position\n    el.addEventListener('scroll', handleScroll, { passive: true });\n    return () => el.removeEventListener('scroll', handleScroll);\n  }, [containerEl, threshold, disabled]);\n\n  // While pinned, follow growth of the content (streaming tokens, appended\n  // rows) and shrinking of the container (on-screen keyboard, composer\n  // growing) so the newest content stays in view. While unpinned this\n  // observer never touches the scroll position.\n  React.useEffect(() => {\n    if (disabled) return;\n    const el = containerEl;\n    if (!el || typeof globalThis.ResizeObserver === 'undefined') return;\n\n    const observer = new globalThis.ResizeObserver(() => {\n      if (pinnedRef.current) {\n        pinToBottom(el);\n        return;\n      }\n      // Mid-anchor-animation the position is transient — judge nothing yet.\n      if (anchorTargetRef.current != null) return;\n      // Not following: growth can still silently carry the position away from\n      // the bottom (no scroll event fires), so recompute the state here — it\n      // drives the jump-to-bottom affordance and ends reading mode once the\n      // response outgrows its reserved space.\n      const atBottom =\n        el.scrollHeight - el.scrollTop - el.clientHeight <= threshold;\n      if (!atBottom) readingRef.current = false;\n      setIsAtBottom(atBottom);\n    });\n    observer.observe(el);\n    if (contentEl) observer.observe(contentEl);\n    return () => observer.disconnect();\n  }, [containerEl, contentEl, threshold, disabled]);\n\n  const scrollToBottom = React.useCallback(\n    (behavior: ScrollBehavior = 'auto') => {\n      const el = containerRef.current;\n      if (!el) return;\n      // Pin immediately so a concurrent stream keeps following while a\n      // smooth scroll animates down.\n      readingRef.current = false;\n      anchorTargetRef.current = null;\n      pinnedRef.current = true;\n      setIsAtBottom(true);\n      if (typeof el.scrollTo === 'function') {\n        el.scrollTo({ top: el.scrollHeight, behavior });\n      } else {\n        pinToBottom(el); // jsdom fallback\n      }\n    },\n    []\n  );\n\n  const anchorToTurnStart = React.useCallback(\n    (target: HTMLElement, behavior: ScrollBehavior = 'auto') => {\n      const el = containerRef.current;\n      if (!el) return;\n      readingRef.current = true;\n      pinnedRef.current = false;\n      // Clamp to the reachable range so the “arrived” check always resolves.\n      const top = Math.min(\n        target.getBoundingClientRect().top -\n          el.getBoundingClientRect().top +\n          el.scrollTop,\n        el.scrollHeight - el.clientHeight\n      );\n      // Already there: `scrollTo` emits no scroll event, so tracking an\n      // in-flight animation would swallow observer updates forever.\n      if (Math.abs(el.scrollTop - top) < 2) return;\n      anchorTargetRef.current = top;\n      anchorDistanceRef.current = Infinity;\n      if (typeof el.scrollTo === 'function') {\n        el.scrollTo({ top, behavior });\n      } else {\n        el.scrollTop = top; // jsdom fallback\n      }\n    },\n    []\n  );\n\n  const followIfPinned = React.useCallback(\n    (behavior: ScrollBehavior = 'auto') => {\n      if (!pinnedRef.current) return false;\n      scrollToBottom(behavior);\n      return true;\n    },\n    [scrollToBottom]\n  );\n\n  const stopFollowing = React.useCallback(() => {\n    readingRef.current = true;\n    pinnedRef.current = false;\n  }, []);\n\n  return {\n    containerRef,\n    contentRef,\n    isAtBottom,\n    scrollToBottom,\n    anchorToTurnStart,\n    followIfPinned,\n    stopFollowing,\n  };\n}\n\n/**\n * Companion to {@link useStickToBottom}: fires `onEnded` when the newest\n * message finishes streaming while the reader is away from the bottom — the\n * end of the reply landed below the fold, so the jump-to-bottom button should\n * upgrade to its “new messages” hint. When the whole reply fit above the fold\n * (the reader is still at the bottom), `onEndedAtBottom` fires instead so the\n * host can exit the stream's hold and resume following (`scrollToBottom`).\n */\nexport function useStreamEndedBelowFold(\n  newest: { id: string; status?: string } | undefined,\n  isAtBottom: boolean,\n  onEnded: () => void,\n  onEndedAtBottom?: () => void\n) {\n  const streamingIdRef = React.useRef<string | null>(null);\n  React.useEffect(() => {\n    if (newest?.status === 'streaming') {\n      streamingIdRef.current = newest.id;\n      return;\n    }\n    if (streamingIdRef.current && newest?.id === streamingIdRef.current) {\n      streamingIdRef.current = null;\n      if (!isAtBottom) onEnded();\n      else onEndedAtBottom?.();\n    }\n  }, [newest, isAtBottom, onEnded, onEndedAtBottom]);\n}\n"]}