{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "hover-card",
  "title": "Hover Card",
  "description": "A hover-triggered rich preview card with open/close delays, a hover bridge so moving into the card keeps it open, placement with collision flip, an optional arrow and keyboard support.",
  "dependencies": [
    "motion",
    "clsx",
    "tailwind-merge"
  ],
  "files": [
    {
      "path": "registry/new-york/hover-card/hover-card.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { motion, AnimatePresence } from \"motion/react\";\nimport { clsx, type ClassValue } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\nfunction cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs));\n}\n\nexport type HoverCardPlacement = \"top\" | \"bottom\" | \"left\" | \"right\";\nexport type HoverCardAlign = \"start\" | \"center\" | \"end\";\n\nexport interface HoverCardProps {\n  children: React.ReactNode;\n  content: React.ReactNode;\n  open?: boolean;\n  defaultOpen?: boolean;\n  onOpenChange?: (open: boolean) => void;\n  /** Delay before opening once the trigger is hovered, in ms. */\n  openDelay?: number;\n  /** Delay before closing once the pointer leaves the trigger and the card, in ms. */\n  closeDelay?: number;\n  placement?: HoverCardPlacement;\n  align?: HoverCardAlign;\n  offset?: number;\n  arrow?: boolean;\n  width?: number;\n  theme?: \"dark\" | \"light\";\n  disabled?: boolean;\n  className?: string;\n}\n\nconst PALETTES = {\n  dark: { bg: \"#0E0E0E\", border: \"rgba(255,255,255,0.1)\", text: \"#F5F4F1\", shadow: \"0 24px 60px rgba(0,0,0,0.55)\" },\n  light: { bg: \"#FFFFFF\", border: \"rgba(10,10,10,0.12)\", text: \"#0A0A0A\", shadow: \"0 20px 50px rgba(0,0,0,0.18), 0 4px 12px rgba(0,0,0,0.08)\" },\n};\n\nconst FOCUSABLE = 'a[href], button:not([disabled]), textarea:not([disabled]), input:not([disabled]), select:not([disabled]), [tabindex]:not([tabindex=\"-1\"])';\n\ninterface Position {\n  left: number;\n  top: number;\n  placement: HoverCardPlacement;\n}\n\nexport function HoverCard({\n  children,\n  content,\n  open,\n  defaultOpen = false,\n  onOpenChange,\n  openDelay = 300,\n  closeDelay = 150,\n  placement = \"bottom\",\n  align = \"center\",\n  offset = 10,\n  arrow = true,\n  width = 300,\n  theme = \"dark\",\n  disabled = false,\n  className,\n}: HoverCardProps) {\n  const p = PALETTES[theme];\n  const uid = React.useId();\n  const triggerRef = React.useRef<HTMLSpanElement>(null);\n  const cardRef = React.useRef<HTMLDivElement>(null);\n  const openTimer = React.useRef<ReturnType<typeof setTimeout> | null>(null);\n  const closeTimer = React.useRef<ReturnType<typeof setTimeout> | null>(null);\n  const [internal, setInternal] = React.useState(defaultOpen);\n  const [mounted, setMounted] = React.useState(false);\n  const [pos, setPos] = React.useState<Position | null>(null);\n  const isControlled = open !== undefined;\n  const isOpen = isControlled ? open : internal;\n\n  const setOpen = React.useCallback(\n    (next: boolean) => {\n      if (!isControlled) setInternal(next);\n      onOpenChange?.(next);\n    },\n    [isControlled, onOpenChange],\n  );\n\n  const clearTimers = () => {\n    if (openTimer.current) clearTimeout(openTimer.current);\n    if (closeTimer.current) clearTimeout(closeTimer.current);\n  };\n\n  const scheduleOpen = (delay: number) => {\n    if (disabled) return;\n    clearTimers();\n    openTimer.current = setTimeout(() => setOpen(true), delay);\n  };\n\n  const scheduleClose = () => {\n    clearTimers();\n    closeTimer.current = setTimeout(() => setOpen(false), closeDelay);\n  };\n\n  const measure = React.useCallback(() => {\n    const el = triggerRef.current;\n    if (!el) return;\n    const r = el.getBoundingClientRect();\n    let place = placement;\n    if (place === \"top\" && r.top < 200) place = \"bottom\";\n    else if (place === \"bottom\" && window.innerHeight - r.bottom < 200) place = \"top\";\n    else if (place === \"left\" && r.left < width + 40) place = \"right\";\n    else if (place === \"right\" && window.innerWidth - r.right < width + 40) place = \"left\";\n    const horizontal = place === \"top\" || place === \"bottom\";\n    const along = horizontal ? (align === \"start\" ? r.left : align === \"end\" ? r.right : r.left + r.width / 2) : align === \"start\" ? r.top : align === \"end\" ? r.bottom : r.top + r.height / 2;\n    const map: Record<HoverCardPlacement, Position> = {\n      top: { left: along, top: r.top - offset, placement: \"top\" },\n      bottom: { left: along, top: r.bottom + offset, placement: \"bottom\" },\n      left: { left: r.left - offset, top: along, placement: \"left\" },\n      right: { left: r.right + offset, top: along, placement: \"right\" },\n    };\n    setPos(map[place]);\n  }, [placement, align, offset, width]);\n\n  React.useEffect(() => {\n    if (!isOpen) return;\n    measure();\n    const id = setTimeout(() => setMounted(true), 0);\n    window.addEventListener(\"scroll\", measure, true);\n    window.addEventListener(\"resize\", measure);\n    return () => {\n      clearTimeout(id);\n      window.removeEventListener(\"scroll\", measure, true);\n      window.removeEventListener(\"resize\", measure);\n    };\n  }, [isOpen, measure]);\n\n  React.useEffect(() => {\n    if (!isOpen) return;\n    const onKey = (e: KeyboardEvent) => {\n      if (e.key === \"Escape\") {\n        clearTimers();\n        setOpen(false);\n        triggerRef.current?.querySelector<HTMLElement>(FOCUSABLE)?.focus({ preventScroll: true });\n      }\n    };\n    document.addEventListener(\"keydown\", onKey);\n    return () => document.removeEventListener(\"keydown\", onKey);\n  }, [isOpen, setOpen]);\n\n  React.useEffect(() => () => clearTimers(), []);\n\n  const onTriggerBlur = (e: React.FocusEvent) => {\n    const next = e.relatedTarget as Node | null;\n    if (next && (triggerRef.current?.contains(next) || cardRef.current?.contains(next))) return;\n    scheduleClose();\n  };\n\n  const place = pos?.placement ?? placement;\n  const horizontal = place === \"top\" || place === \"bottom\";\n  const tx = horizontal ? (align === \"start\" ? \"0%\" : align === \"end\" ? \"-100%\" : \"-50%\") : place === \"left\" ? \"-100%\" : \"0%\";\n  const ty = !horizontal ? (align === \"start\" ? \"0%\" : align === \"end\" ? \"-100%\" : \"-50%\") : place === \"top\" ? \"-100%\" : \"0%\";\n  const origin: Record<HoverCardPlacement, string> = { top: \"bottom center\", bottom: \"top center\", left: \"center right\", right: \"center left\" };\n  const arrowPos = horizontal ? (align === \"start\" ? { left: 18 } : align === \"end\" ? { right: 18 } : { left: \"50%\", marginLeft: -5 }) : align === \"start\" ? { top: 18 } : align === \"end\" ? { bottom: 18 } : { top: \"50%\", marginTop: -5 };\n  const arrowSide: Record<HoverCardPlacement, React.CSSProperties> = {\n    top: { bottom: -6, borderRight: `1px solid ${p.border}`, borderBottom: `1px solid ${p.border}` },\n    bottom: { top: -6, borderLeft: `1px solid ${p.border}`, borderTop: `1px solid ${p.border}` },\n    left: { right: -6, borderTop: `1px solid ${p.border}`, borderRight: `1px solid ${p.border}` },\n    right: { left: -6, borderBottom: `1px solid ${p.border}`, borderLeft: `1px solid ${p.border}` },\n  };\n\n  return (\n    <>\n      <span\n        ref={triggerRef}\n        tabIndex={0}\n        role=\"button\"\n        aria-haspopup=\"dialog\"\n        aria-expanded={isOpen}\n        aria-controls={isOpen ? `${uid}-card` : undefined}\n        className={cn(\"inline-flex cursor-default outline-none\", className)}\n        onMouseEnter={() => scheduleOpen(openDelay)}\n        onMouseLeave={scheduleClose}\n        onFocus={() => scheduleOpen(0)}\n        onBlur={onTriggerBlur}\n      >\n        {children}\n      </span>\n\n      {mounted &&\n        createPortal(\n          <AnimatePresence onExitComplete={() => setMounted(false)}>\n            {isOpen && pos && (\n              <motion.div\n                key=\"hover-card\"\n                id={`${uid}-card`}\n                ref={cardRef}\n                role=\"dialog\"\n                onMouseEnter={() => clearTimers()}\n                onMouseLeave={scheduleClose}\n                className=\"fixed z-[9999]\"\n                style={{ left: pos.left, top: pos.top, width, x: tx, y: ty, transformOrigin: origin[place] }}\n                initial={{ opacity: 0, scale: 0.94 }}\n                animate={{ opacity: 1, scale: 1 }}\n                exit={{ opacity: 0, scale: 0.96 }}\n                transition={{ type: \"spring\", stiffness: 420, damping: 32 }}\n              >\n                <div className=\"relative\" style={{ padding: 16, borderRadius: 16, background: p.bg, border: `1px solid ${p.border}`, boxShadow: p.shadow, color: p.text, fontFamily: \"Inter, sans-serif\" }}>\n                  {content}\n                  {arrow && <span aria-hidden=\"true\" className=\"absolute\" style={{ width: 10, height: 10, background: p.bg, transform: \"rotate(45deg)\", ...arrowPos, ...arrowSide[place] }} />}\n                </div>\n              </motion.div>\n            )}\n          </AnimatePresence>,\n          document.body,\n        )}\n    </>\n  );\n}\n",
      "type": "registry:component"
    }
  ],
  "type": "registry:component"
}