{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "r-hover-card",
  "type": "registry:ui",
  "registryDependencies": [],
  "dependencies": [
    "@radix-ui/react-hover-card",
    "@radix-ui/react-slot",
    "motion"
  ],
  "devDependencies": [],
  "files": [
    {
      "path": "r-hover-card.tsx",
      "content": "\"use client\";\n\nimport * as HoverCardPrimitive from \"@radix-ui/react-hover-card\";\nimport { Slot } from \"@radix-ui/react-slot\";\nimport { AnimatePresence, motion } from \"motion/react\";\nimport * as React from \"react\";\n\nimport { cn } from \"@/lib/utils\";\n\n// ---------------------------------------------------------------------------\n// Design tokens\n// ---------------------------------------------------------------------------\n\nconst controlCornerClassName =\n  \"rounded-lg supports-[corner-shape:squircle]:corner-squircle supports-[corner-shape:squircle]:rounded-[11px]\";\n\nconst surfaceCornerClassName =\n  \"rounded-lg supports-[corner-shape:squircle]:corner-squircle supports-[corner-shape:squircle]:rounded-[12px]\";\n\nconst hoverCardThemeClassName =\n  \"[--hc-surface:#ffffff] [--hc-foreground:#111111] [--hc-border:#e3e7ec] [--hc-ring:rgba(17,17,17,0.16)] dark:[--hc-surface:#111111] dark:[--hc-foreground:#f6f3ec] dark:[--hc-border:#2b2a25] dark:[--hc-ring:rgba(246,243,236,0.18)]\";\n\nconst hoverCardPanelClassName = cn(\n  surfaceCornerClassName,\n  \"relative z-50 w-72 transform-gpu border border-[color:var(--hc-border)] bg-[color:var(--hc-surface)] p-4 text-[color:var(--hc-foreground)] shadow-none outline-none\"\n);\n\nconst hoverCardTriggerClassName = cn(\n  controlCornerClassName,\n  \"inline-flex min-h-9 cursor-pointer items-center px-1.5 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[color:color-mix(in_oklch,var(--hc-ring),transparent_40%)] focus-visible:ring-offset-2 focus-visible:ring-offset-[color:var(--hc-surface)]\"\n);\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\ntype Side = \"top\" | \"right\" | \"bottom\" | \"left\";\ntype Align = \"start\" | \"center\" | \"end\";\ntype CollisionPadding = React.ComponentPropsWithoutRef<\n  typeof HoverCardPrimitive.Content\n>[\"collisionPadding\"];\n\ntype HoverCardContextValue = {\n  open: boolean;\n  contentId: string;\n  triggerId: string;\n  setContentNode: (node: HTMLDivElement | null) => void;\n  setTriggerNode: (node: HTMLElement | null) => void;\n  handleFocusEnd: (event: React.FocusEvent<HTMLElement>) => void;\n  handleFocusStart: () => void;\n  handleHoverEnd: (event: React.PointerEvent<HTMLElement>) => void;\n  handleHoverStart: (event: React.PointerEvent<HTMLElement>) => void;\n};\n\n// ---------------------------------------------------------------------------\n// Context\n// ---------------------------------------------------------------------------\n\nconst HoverCardContext = React.createContext<HoverCardContextValue | null>(\n  null\n);\n\n// ---------------------------------------------------------------------------\n// Motion config\n// ---------------------------------------------------------------------------\n\nconst FLUID_EASE = [0.16, 1, 0.3, 1] as const;\nconst HOVER_CARD_EXIT_EASE = [0.4, 0, 0.6, 1] as const;\n\nconst HOVER_CARD_SPRING = {\n  type: \"spring\" as const,\n  stiffness: 260,\n  damping: 18,\n  mass: 0.65,\n};\n\nfunction getSideMotionOffset(side: Side): { x: number; y: number } {\n  switch (side) {\n    case \"top\":\n      return { x: 0, y: 6 };\n    case \"right\":\n      return { x: -6, y: 0 };\n    case \"left\":\n      return { x: 6, y: 0 };\n    default:\n      return { x: 0, y: -6 };\n  }\n}\n\n// We pre-compute variants keyed by side at render time so Framer Motion can\n// interpolate all values cleanly (no CSS-variable strings mixed with numbers).\nfunction getHoverCardVariants(side: Side) {\n  const offset = getSideMotionOffset(side);\n\n  return {\n    open: {\n      opacity: 1,\n      scale: 1,\n      x: 0,\n      y: 0,\n      filter: \"blur(0px)\",\n      transition: {\n        opacity: { duration: 0.32, ease: FLUID_EASE },\n        scale: HOVER_CARD_SPRING,\n        x: HOVER_CARD_SPRING,\n        y: HOVER_CARD_SPRING,\n        filter: { duration: 0.28, ease: [0, 0, 0.2, 1] as const },\n      },\n    },\n    closed: {\n      opacity: 0,\n      scale: 0.95,\n      x: offset.x,\n      y: offset.y,\n      filter: \"blur(8px)\",\n      transition: {\n        opacity: { duration: 0.18, ease: HOVER_CARD_EXIT_EASE },\n        scale: { duration: 0.18, ease: HOVER_CARD_EXIT_EASE },\n        x: { duration: 0.18, ease: HOVER_CARD_EXIT_EASE },\n        y: { duration: 0.18, ease: HOVER_CARD_EXIT_EASE },\n        filter: { duration: 0.18, ease: HOVER_CARD_EXIT_EASE },\n      },\n    },\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Hover bridge — positioned via group-data-[side=...] on the inner motion.div.\n// ---------------------------------------------------------------------------\n\n// ---------------------------------------------------------------------------\n// Ref utilities\n// ---------------------------------------------------------------------------\n\nconst assignRef = <T,>(ref: React.ForwardedRef<T>, value: T | null) => {\n  if (typeof ref === \"function\") {\n    ref(value);\n    return;\n  }\n\n  if (ref) {\n    ref.current = value;\n  }\n};\n\n// ---------------------------------------------------------------------------\n// useHoverCard hook\n// ---------------------------------------------------------------------------\n\nconst useHoverCard = () => {\n  const context = React.useContext(HoverCardContext);\n\n  if (!context) {\n    throw new Error(\"HoverCard components must be used inside <HoverCard>\");\n  }\n\n  return context;\n};\n\n// ---------------------------------------------------------------------------\n// HoverCard — root\n// ---------------------------------------------------------------------------\n\ntype HoverCardProps = {\n  className?: string;\n  openDelay?: number;\n  closeDelay?: number;\n  children?: React.ReactNode;\n  /** Controlled open state. */\n  open?: boolean;\n  onOpenChange?: (open: boolean) => void;\n  /** Uncontrolled initial open state. */\n  defaultOpen?: boolean;\n};\n\nconst HoverCard = ({\n  className,\n  openDelay = 80,\n  closeDelay = 120,\n  children,\n  open: openProp,\n  onOpenChange,\n  defaultOpen = false,\n}: HoverCardProps) => {\n  const [internalOpen, setInternalOpen] = React.useState(defaultOpen);\n  const isControlled = openProp !== undefined;\n  const open = isControlled ? openProp : internalOpen;\n\n  const setOpen = React.useCallback(\n    (nextOpen: boolean) => {\n      if (!isControlled) {\n        setInternalOpen(nextOpen);\n      }\n      onOpenChange?.(nextOpen);\n    },\n    [isControlled, onOpenChange]\n  );\n\n  const timeoutRef = React.useRef<number | null>(null);\n  const triggerRef = React.useRef<HTMLElement | null>(null);\n  const contentRef = React.useRef<HTMLDivElement | null>(null);\n  const isHoveringRef = React.useRef(false);\n  const reactId = React.useId();\n\n  const clearTimer = React.useCallback(() => {\n    if (timeoutRef.current !== null) {\n      window.clearTimeout(timeoutRef.current);\n      timeoutRef.current = null;\n    }\n  }, []);\n\n  // Clear any pending timer when the component unmounts.\n  React.useEffect(() => clearTimer, [clearTimer]);\n\n  const containsInteractiveNode = React.useCallback((node: Node | null) => {\n    return Boolean(\n      node &&\n        (triggerRef.current?.contains(node) ||\n          contentRef.current?.contains(node))\n    );\n  }, []);\n\n  const hasFocusWithin = React.useCallback(() => {\n    const activeElement = document.activeElement;\n    return (\n      activeElement instanceof Node && containsInteractiveNode(activeElement)\n    );\n  }, [containsInteractiveNode]);\n\n  const scheduleOpen = React.useCallback(() => {\n    clearTimer();\n    timeoutRef.current = window.setTimeout(() => setOpen(true), openDelay);\n  }, [clearTimer, openDelay, setOpen]);\n\n  const scheduleClose = React.useCallback(() => {\n    clearTimer();\n    timeoutRef.current = window.setTimeout(() => setOpen(false), closeDelay);\n  }, [clearTimer, closeDelay, setOpen]);\n\n  const handleHoverStart = React.useCallback(\n    (event: React.PointerEvent<HTMLElement>) => {\n      if (event.pointerType === \"touch\") return;\n      isHoveringRef.current = true;\n\n      if (open) {\n        // Already open — cancel any scheduled close.\n        clearTimer();\n        return;\n      }\n\n      scheduleOpen();\n    },\n    [clearTimer, open, scheduleOpen]\n  );\n\n  const handleHoverEnd = React.useCallback(\n    (event: React.PointerEvent<HTMLElement>) => {\n      if (event.pointerType === \"touch\") return;\n\n      const nextTarget = event.relatedTarget;\n\n      // Cursor moved into the other interactive zone (trigger ↔ content).\n      if (nextTarget instanceof Node && containsInteractiveNode(nextTarget)) {\n        return;\n      }\n\n      isHoveringRef.current = false;\n\n      // Keep open if focus is still inside.\n      if (hasFocusWithin()) return;\n\n      scheduleClose();\n    },\n    [containsInteractiveNode, hasFocusWithin, scheduleClose]\n  );\n\n  const handleFocusStart = React.useCallback(() => {\n    clearTimer();\n    setOpen(true);\n  }, [clearTimer, setOpen]);\n\n  const handleFocusEnd = React.useCallback(\n    (event: React.FocusEvent<HTMLElement>) => {\n      const nextTarget = event.relatedTarget;\n\n      // Focus moved to another interactive zone — keep open.\n      if (nextTarget instanceof Node && containsInteractiveNode(nextTarget)) {\n        return;\n      }\n\n      // Cursor is still hovering — keep open (e.g. user clicked static text).\n      if (isHoveringRef.current) return;\n\n      clearTimer();\n      setOpen(false);\n    },\n    [clearTimer, containsInteractiveNode, setOpen]\n  );\n\n  return (\n    <HoverCardContext.Provider\n      value={{\n        open,\n        contentId: `${reactId}-content`,\n        triggerId: `${reactId}-trigger`,\n        setContentNode: (node) => {\n          contentRef.current = node;\n        },\n        setTriggerNode: (node) => {\n          triggerRef.current = node;\n        },\n        handleFocusEnd,\n        handleFocusStart,\n        handleHoverEnd,\n        handleHoverStart,\n      }}\n    >\n      {/*\n        Radix HoverCard.Root is used solely to handle the Radix portal and\n        positioning. We bypass its own open/close timing by wiring open/onOpenChange\n        from our own state and calling clearTimer before forwarding the event.\n      */}\n      <HoverCardPrimitive.Root\n        onOpenChange={(nextOpen) => {\n          clearTimer();\n          setOpen(nextOpen);\n        }}\n        open={open}\n      >\n        <span\n          className={cn(\n            hoverCardThemeClassName,\n            \"inline-flex w-fit\",\n            className\n          )}\n        >\n          {children}\n        </span>\n      </HoverCardPrimitive.Root>\n    </HoverCardContext.Provider>\n  );\n};\n\n// ---------------------------------------------------------------------------\n// HoverCardTrigger\n// ---------------------------------------------------------------------------\n\ntype HoverCardTriggerProps = React.ComponentPropsWithoutRef<\"button\"> & {\n  asChild?: boolean;\n};\n\nconst HoverCardTrigger = React.forwardRef<\n  HTMLButtonElement,\n  HoverCardTriggerProps\n>(\n  (\n    {\n      asChild,\n      className,\n      onBlur,\n      onFocus,\n      onPointerEnter,\n      onPointerLeave,\n      type,\n      ...props\n    },\n    ref\n  ) => {\n    const {\n      open,\n      contentId,\n      triggerId,\n      setTriggerNode,\n      handleFocusEnd,\n      handleFocusStart,\n      handleHoverEnd,\n      handleHoverStart,\n    } = useHoverCard();\n\n    const Comp = asChild ? Slot : \"button\";\n\n    return (\n      <HoverCardPrimitive.Trigger asChild>\n        <Comp\n          aria-controls={contentId}\n          aria-expanded={open}\n          aria-haspopup=\"dialog\"\n          className={cn(\n            asChild\n              ? \"inline-flex cursor-pointer items-center focus-visible:outline-none\"\n              : hoverCardTriggerClassName,\n            className\n          )}\n          data-state={open ? \"open\" : \"closed\"}\n          id={triggerId}\n          onBlur={(event) => {\n            onBlur?.(event);\n            if (event.defaultPrevented) return;\n            handleFocusEnd(event);\n          }}\n          onFocus={(event) => {\n            onFocus?.(event);\n            if (event.defaultPrevented) return;\n            handleFocusStart();\n          }}\n          onPointerEnter={(event) => {\n            onPointerEnter?.(event);\n            if (event.defaultPrevented) return;\n            handleHoverStart(event);\n          }}\n          onPointerLeave={(event) => {\n            onPointerLeave?.(event);\n            if (event.defaultPrevented) return;\n            handleHoverEnd(event);\n          }}\n          ref={(node: HTMLButtonElement | null) => {\n            setTriggerNode(node);\n            assignRef(ref, node);\n          }}\n          type={asChild ? undefined : (type ?? \"button\")}\n          {...props}\n        />\n      </HoverCardPrimitive.Trigger>\n    );\n  }\n);\nHoverCardTrigger.displayName = \"HoverCardTrigger\";\n\n// ---------------------------------------------------------------------------\n// HoverCardContent types\n// ---------------------------------------------------------------------------\n\ntype HoverCardContentProps = Omit<\n  React.ComponentPropsWithoutRef<typeof motion.div>,\n  \"initial\" | \"animate\" | \"exit\" | \"transition\" | \"variants\"\n> & {\n  align?: Align;\n  alignOffset?: number;\n  avoidCollisions?: boolean;\n  collisionPadding?: CollisionPadding;\n  side?: Side;\n  sideOffset?: number;\n};\n\n// ---------------------------------------------------------------------------\n// HoverCardContentBody — rendered panel, mounted only while open or animating.\n//\n// ARCHITECTURE NOTE:\n// Radix sets `data-side` on its Content element when collision-detection flips\n// the placement. We pass `asChild` so the outer <div> receives that attribute.\n// The `group` class on the same element lets child `group-data-[side=...]`\n// selectors control the bridge position correctly on all sides.\n// ---------------------------------------------------------------------------\n\nconst HoverCardContentBody = React.forwardRef<\n  HTMLDivElement,\n  HoverCardContentProps\n>(\n  (\n    {\n      className,\n      children,\n      style,\n      onBlur,\n      onFocus,\n      onPointerEnter,\n      onPointerLeave,\n      align = \"center\",\n      alignOffset = 0,\n      avoidCollisions = true,\n      collisionPadding = 12,\n      side = \"bottom\",\n      sideOffset = 12,\n      ...props\n    },\n    ref\n  ) => {\n    const {\n      contentId,\n      triggerId,\n      setContentNode,\n      handleFocusEnd,\n      handleFocusStart,\n      handleHoverEnd,\n      handleHoverStart,\n    } = useHoverCard();\n\n    // Variants are computed from the prop `side`. Radix may flip the actual\n    // placement, but the initial closed state still needs numeric offsets so\n    // Framer Motion can interpolate cleanly. The bridge CSS is handled via the\n    // group-data-[side=...] selectors which read Radix's data-side attribute.\n    const variants = getHoverCardVariants(side);\n\n    return (\n      <HoverCardPrimitive.Content\n        align={align}\n        alignOffset={alignOffset}\n        asChild\n        avoidCollisions={avoidCollisions}\n        collisionPadding={collisionPadding}\n        side={side}\n        sideOffset={sideOffset}\n      >\n        {/*\n          Radix renders its positioning wrapper here and sets data-side on it.\n          The `group` class exposes that attribute to group-data-[side=...]\n          utility classes on the inner panel.\n        */}\n        <div\n          className=\"group outline-none\"\n          style={\n            {\n              \"--hover-card-bridge-size\": `${sideOffset}px`,\n              ...style,\n            } as React.CSSProperties\n          }\n        >\n          <motion.div\n            {...props}\n            animate=\"open\"\n            aria-labelledby={triggerId}\n            className={cn(\n              hoverCardThemeClassName,\n              hoverCardPanelClassName,\n              // Bridge pseudo-element positions itself relative to whatever side\n              // Radix resolved at runtime via group-data-[side=...] selectors.\n              \"before:pointer-events-auto before:absolute before:bg-transparent before:content-['']\",\n              \"group-data-[side=top]:before:right-0 group-data-[side=top]:before:bottom-[calc(var(--hover-card-bridge-size)*-1)] group-data-[side=top]:before:left-0 group-data-[side=top]:before:h-[var(--hover-card-bridge-size)]\",\n              \"group-data-[side=bottom]:before:top-[calc(var(--hover-card-bridge-size)*-1)] group-data-[side=bottom]:before:right-0 group-data-[side=bottom]:before:left-0 group-data-[side=bottom]:before:h-[var(--hover-card-bridge-size)]\",\n              \"group-data-[side=left]:before:top-0 group-data-[side=left]:before:right-[calc(var(--hover-card-bridge-size)*-1)] group-data-[side=left]:before:bottom-0 group-data-[side=left]:before:w-[var(--hover-card-bridge-size)]\",\n              \"group-data-[side=right]:before:top-0 group-data-[side=right]:before:bottom-0 group-data-[side=right]:before:left-[calc(var(--hover-card-bridge-size)*-1)] group-data-[side=right]:before:w-[var(--hover-card-bridge-size)]\",\n              \"transform-gpu\",\n              className\n            )}\n            exit=\"closed\"\n            id={contentId}\n            initial=\"closed\"\n            onBlur={(event) => {\n              onBlur?.(event);\n              if (event.defaultPrevented) return;\n              handleFocusEnd(event);\n            }}\n            onFocus={(event) => {\n              onFocus?.(event);\n              if (event.defaultPrevented) return;\n              handleFocusStart();\n            }}\n            onPointerEnter={(event) => {\n              onPointerEnter?.(event);\n              if (event.defaultPrevented) return;\n              handleHoverStart(event);\n            }}\n            onPointerLeave={(event) => {\n              onPointerLeave?.(event);\n              if (event.defaultPrevented) return;\n              handleHoverEnd(event);\n            }}\n            ref={(node: HTMLDivElement | null) => {\n              setContentNode(node);\n              assignRef(ref, node);\n            }}\n            role=\"dialog\"\n            style={{\n              transformOrigin:\n                \"var(--radix-hover-card-content-transform-origin)\",\n            }}\n            variants={variants}\n          >\n            {children}\n          </motion.div>\n        </div>\n      </HoverCardPrimitive.Content>\n    );\n  }\n);\nHoverCardContentBody.displayName = \"HoverCardContentBody\";\n\n// ---------------------------------------------------------------------------\n// HoverCardContent — AnimatePresence wrapper keeps the panel in the DOM until\n// the exit animation finishes, then cleanly unmounts.\n// ---------------------------------------------------------------------------\n\nconst HoverCardContent = React.forwardRef<\n  HTMLDivElement,\n  HoverCardContentProps\n>((props, ref) => {\n  const { open } = useHoverCard();\n\n  return (\n    <AnimatePresence>\n      {open ? (\n        <HoverCardPrimitive.Portal forceMount>\n          <HoverCardContentBody ref={ref} {...props} />\n        </HoverCardPrimitive.Portal>\n      ) : null}\n    </AnimatePresence>\n  );\n});\nHoverCardContent.displayName = \"HoverCardContent\";\n\nexport { HoverCard, HoverCardTrigger, HoverCardContent };\n",
      "type": "registry:ui"
    }
  ],
  "title": "Hover Card (Radix UI)",
  "description": "Hover card with the same Iconiq API layered over the dedicated Radix Hover Card primitive, preserving delayed hover reveal, instant focus open, collision-aware placement, and spring-driven content motion."
}
