{"$schema":"https://ui.shadcn.com/schema/registry-item.json","name":"popover","type":"registry:component","title":"Popover","description":"Gooey popover whose panel oozes out of the trigger through an SVG goo filter — a liquid neck that stretches and pinches — with crisp content fading in on top. Click or hover trigger, controlled or uncontrolled.","author":"Saurabh <saurabh10102@gmail.com>","dependencies":["clsx","motion","tailwind-merge"],"registryDependencies":[],"files":[{"path":"components/motion/popover.tsx","type":"registry:component","target":"@components/motion/popover.tsx","content":"\"use client\";\n// beui.dev/components/motion/popover\n\nimport {\n  animate,\n  useMotionValue,\n  useMotionValueEvent,\n  useReducedMotion,\n  type MotionValue,\n} from \"motion/react\";\nimport {\n  cloneElement,\n  createContext,\n  isValidElement,\n  type ReactElement,\n  type ReactNode,\n  type Ref,\n  useCallback,\n  useContext,\n  useEffect,\n  useId,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport { cn } from \"@/lib/utils\";\n\ntype Side = \"top\" | \"bottom\";\ntype Align = \"start\" | \"center\" | \"end\";\ntype TriggerMode = \"click\" | \"hover\";\n\nconst GOO_SPRING = { type: \"spring\", visualDuration: 0.32, bounce: 0.28 } as const;\nconst HOVER_CLOSE_DELAY = 120;\n\nconst lerp = (a: number, b: number, t: number) => a + (b - a) * t;\n\ninterface Rect {\n  x: number;\n  y: number;\n  w: number;\n  h: number;\n  r: number;\n}\ninterface Geo {\n  layerW: number;\n  layerH: number;\n  left: number;\n  top: number;\n  trigger: Rect;\n  panel: Rect;\n}\n\n// Trigger rect and panel rect in a shared local coordinate box.\nfunction buildGeo(\n  tW: number,\n  tH: number,\n  cW: number,\n  cH: number,\n  side: Side,\n  align: Align,\n  gap: number,\n  panelRadius: number,\n): Geo {\n  const py = side === \"bottom\" ? tH + gap : -(gap + cH);\n  const px = align === \"start\" ? 0 : align === \"end\" ? tW - cW : (tW - cW) / 2;\n\n  const left = Math.min(0, px);\n  const top = Math.min(0, py);\n  const layerW = Math.max(tW, px + cW) - left;\n  const layerH = Math.max(tH, py + cH) - top;\n\n  const triggerRadius = Math.min(tH / 2, panelRadius);\n\n  return {\n    layerW,\n    layerH,\n    left,\n    top,\n    trigger: { x: -left, y: -top, w: tW, h: tH, r: triggerRadius },\n    panel: { x: px - left, y: py - top, w: cW, h: cH, r: panelRadius },\n  };\n}\n\nfunction insetFor(rect: Rect, layerW: number, layerH: number): string {\n  const top = rect.y;\n  const right = layerW - (rect.x + rect.w);\n  const bottom = layerH - (rect.y + rect.h);\n  const left = rect.x;\n  return `inset(${top}px ${right}px ${bottom}px ${left}px round ${rect.r}px)`;\n}\n\nfunction insetForProgress(geo: Geo, p: number): string {\n  const t = geo.trigger;\n  const pn = geo.panel;\n  const rect: Rect = {\n    x: lerp(t.x, pn.x, p),\n    y: lerp(t.y, pn.y, p),\n    w: lerp(t.w, pn.w, p),\n    h: lerp(t.h, pn.h, p),\n    r: lerp(t.r, pn.r, p),\n  };\n  return insetFor(rect, geo.layerW, geo.layerH);\n}\n\ninterface PopoverContextValue {\n  open: boolean;\n  setOpen: (open: boolean) => void;\n  toggle: () => void;\n  openHover: () => void;\n  scheduleClose: () => void;\n  triggerMode: TriggerMode;\n  side: Side;\n  align: Align;\n  gap: number;\n  panelRadius: number;\n  gooStrength: number;\n  reduce: boolean;\n  gooId: string;\n  contentId: string;\n  progress: MotionValue<number>;\n  triggerRef: React.MutableRefObject<HTMLElement | null>;\n}\n\nconst PopoverContext = createContext<PopoverContextValue | null>(null);\n\nfunction usePopoverContext(component: string) {\n  const ctx = useContext(PopoverContext);\n  if (!ctx) throw new Error(`${component} must be used within <Popover>`);\n  return ctx;\n}\n\nexport interface PopoverProps {\n  children: ReactNode;\n  /** Controlled open state. */\n  open?: boolean;\n  /** Uncontrolled initial open state. */\n  defaultOpen?: boolean;\n  onOpenChange?: (open: boolean) => void;\n  /** How the popover is summoned. Default \"click\". */\n  trigger?: TriggerMode;\n  /** Which side of the trigger the panel oozes out of. Default \"bottom\". */\n  side?: Side;\n  /** Alignment along the trigger's edge. Default \"center\". */\n  align?: Align;\n  /** Gap between trigger and panel, in px — the length of the gooey neck. Default 14. */\n  sideOffset?: number;\n  /** Corner radius of the open panel, in px. Default 16. */\n  panelRadius?: number;\n  /** Blur radius feeding the goo filter — higher melts more. Default 8. */\n  gooStrength?: number;\n  className?: string;\n}\n\nexport function Popover({\n  children,\n  open: controlledOpen,\n  defaultOpen = false,\n  onOpenChange,\n  trigger = \"click\",\n  side = \"bottom\",\n  align = \"center\",\n  sideOffset = 14,\n  panelRadius = 16,\n  gooStrength = 8,\n  className,\n}: PopoverProps) {\n  const reduce = useReducedMotion() ?? false;\n  const gooId = useId().replace(/:/g, \"\");\n  const contentId = useId();\n  const rootRef = useRef<HTMLDivElement>(null);\n  const triggerRef = useRef<HTMLElement | null>(null);\n  const closeTimer = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const progress = useMotionValue(defaultOpen ? 1 : 0);\n\n  const [internalOpen, setInternalOpen] = useState(defaultOpen);\n  const controlled = controlledOpen !== undefined;\n  const open = controlled ? controlledOpen : internalOpen;\n\n  const setOpen = useCallback(\n    (next: boolean) => {\n      if (!controlled) setInternalOpen(next);\n      onOpenChange?.(next);\n    },\n    [controlled, onOpenChange],\n  );\n\n  const cancelClose = useCallback(() => {\n    if (closeTimer.current) {\n      clearTimeout(closeTimer.current);\n      closeTimer.current = null;\n    }\n  }, []);\n\n  const openHover = useCallback(() => {\n    cancelClose();\n    setOpen(true);\n  }, [cancelClose, setOpen]);\n\n  const scheduleClose = useCallback(() => {\n    cancelClose();\n    closeTimer.current = setTimeout(() => setOpen(false), HOVER_CLOSE_DELAY);\n  }, [cancelClose, setOpen]);\n\n  const toggle = useCallback(() => setOpen(!open), [setOpen, open]);\n\n  useEffect(() => () => cancelClose(), [cancelClose]);\n\n  useEffect(() => {\n    const animation = animate(\n      progress,\n      open ? 1 : 0,\n      reduce ? { duration: 0 } : GOO_SPRING,\n    );\n    return () => animation.stop();\n  }, [open, progress, reduce]);\n\n  useEffect(() => {\n    if (!open) return;\n    const onKey = (e: KeyboardEvent) => e.key === \"Escape\" && setOpen(false);\n    // Trigger and panel share rootRef, so moving between them isn't \"outside\".\n    const onPointer = (e: PointerEvent) => {\n      if (rootRef.current && !rootRef.current.contains(e.target as Node))\n        setOpen(false);\n    };\n    window.addEventListener(\"keydown\", onKey);\n    if (trigger === \"click\") window.addEventListener(\"pointerdown\", onPointer);\n    return () => {\n      window.removeEventListener(\"keydown\", onKey);\n      window.removeEventListener(\"pointerdown\", onPointer);\n    };\n  }, [open, setOpen, trigger]);\n\n  const ctx = useMemo<PopoverContextValue>(\n    () => ({\n      open,\n      setOpen,\n      toggle,\n      openHover,\n      scheduleClose,\n      triggerMode: trigger,\n      side,\n      align,\n      gap: sideOffset,\n      panelRadius,\n      gooStrength,\n      reduce,\n      gooId,\n      contentId,\n      progress,\n      triggerRef,\n    }),\n    [\n      open,\n      setOpen,\n      toggle,\n      openHover,\n      scheduleClose,\n      trigger,\n      side,\n      align,\n      sideOffset,\n      panelRadius,\n      gooStrength,\n      reduce,\n      gooId,\n      contentId,\n      progress,\n    ],\n  );\n\n  const hoverHandlers =\n    trigger === \"hover\"\n      ? { onMouseEnter: openHover, onMouseLeave: scheduleClose }\n      : {};\n\n  return (\n    <PopoverContext.Provider value={ctx}>\n      <div\n        ref={rootRef}\n        className={cn(\"relative inline-flex isolate\", className)}\n        {...hoverHandlers}\n      >\n        {children}\n      </div>\n    </PopoverContext.Provider>\n  );\n}\n\nfunction mergeRefs<T>(...refs: Array<Ref<T> | undefined>) {\n  return (node: T | null) => {\n    for (const ref of refs) {\n      if (typeof ref === \"function\") ref(node);\n      else if (ref && typeof ref === \"object\")\n        (ref as React.MutableRefObject<T | null>).current = node;\n    }\n  };\n}\n\nexport interface PopoverTriggerProps {\n  /** A single focusable element (e.g. a Button) that opens the popover. */\n  children: ReactElement;\n}\n\nexport function PopoverTrigger({ children }: PopoverTriggerProps) {\n  const ctx = usePopoverContext(\"PopoverTrigger\");\n\n  if (!isValidElement(children)) return children;\n\n  const child = children as ReactElement<Record<string, unknown>>;\n  const childProps = child.props;\n  const childRef = (childProps as { ref?: Ref<HTMLElement> }).ref;\n\n  const compose =\n    (name: string, handler: () => void) =>\n    (event: { defaultPrevented?: boolean }) => {\n      (childProps[name] as ((e: unknown) => void) | undefined)?.(event);\n      if (!event.defaultPrevented) handler();\n    };\n\n  const handlers: Record<string, unknown> =\n    ctx.triggerMode === \"hover\"\n      ? {\n          onFocus: compose(\"onFocus\", ctx.openHover),\n          onBlur: compose(\"onBlur\", ctx.scheduleClose),\n        }\n      : { onClick: compose(\"onClick\", ctx.toggle) };\n\n  return cloneElement(child, {\n    ...handlers,\n    ref: mergeRefs(childRef, (node: HTMLElement | null) => {\n      ctx.triggerRef.current = node;\n    }),\n    // Above the goo layer (z-[-1]) so the neck reads behind it.\n    className: cn(\"relative z-0\", childProps.className as string | undefined),\n    \"aria-haspopup\": \"dialog\",\n    \"aria-expanded\": ctx.open,\n    \"aria-controls\": ctx.open ? ctx.contentId : undefined,\n    \"data-state\": ctx.open ? \"open\" : \"closed\",\n  });\n}\n\nconst ALIGN_ORIGIN: Record<Align, string> = {\n  start: \"left\",\n  center: \"center\",\n  end: \"right\",\n};\n\nexport interface PopoverContentProps {\n  children: ReactNode;\n  className?: string;\n}\n\nexport function PopoverContent({ children, className }: PopoverContentProps) {\n  const ctx = usePopoverContext(\"PopoverContent\");\n  const {\n    side,\n    align,\n    gap,\n    panelRadius,\n    gooStrength,\n    reduce,\n    gooId,\n    contentId,\n    progress,\n    triggerRef,\n    open,\n    triggerMode,\n    openHover,\n    scheduleClose,\n  } = ctx;\n\n  const measureRef = useRef<HTMLDivElement>(null);\n  const blobRef = useRef<HTMLDivElement>(null);\n  const clipRef = useRef<HTMLDivElement>(null);\n  const geoRef = useRef<Geo | null>(null);\n\n  const [sizes, setSizes] = useState({ tW: 0, tH: 0, cW: 0, cH: 0 });\n\n  useLayoutEffect(() => {\n    const triggerNode = triggerRef.current;\n    const contentNode = measureRef.current;\n    if (!contentNode) return;\n\n    const measure = () => {\n      const tW = triggerNode?.offsetWidth ?? 0;\n      const tH = triggerNode?.offsetHeight ?? 0;\n      const cW = contentNode.offsetWidth;\n      const cH = contentNode.offsetHeight;\n      setSizes((prev) =>\n        prev.tW === tW && prev.tH === tH && prev.cW === cW && prev.cH === cH\n          ? prev\n          : { tW, tH, cW, cH },\n      );\n    };\n    measure();\n\n    const observer = new ResizeObserver(measure);\n    observer.observe(contentNode);\n    if (triggerNode) observer.observe(triggerNode);\n    return () => observer.disconnect();\n  }, [triggerRef]);\n\n  const geo = useMemo(\n    () => buildGeo(sizes.tW, sizes.tH, sizes.cW, sizes.cH, side, align, gap, panelRadius),\n    [sizes, side, align, gap, panelRadius],\n  );\n  geoRef.current = geo;\n\n  // Morph the same clip on the goo body and the content, so the whole popover\n  // oozes as one and the text reveals with it.\n  const render = useCallback((g: Geo | null, p: number) => {\n    if (!g || g.layerW === 0) return;\n    const clip = insetForProgress(g, p);\n    if (blobRef.current) blobRef.current.style.clipPath = clip;\n    if (clipRef.current) clipRef.current.style.clipPath = clip;\n  }, []);\n\n  useLayoutEffect(() => {\n    render(geo, progress.get());\n  }, [geo, progress, render]);\n\n  useMotionValueEvent(progress, \"change\", (p) => render(geoRef.current, p));\n\n  const hoverHandlers =\n    triggerMode === \"hover\"\n      ? { onMouseEnter: openHover, onMouseLeave: scheduleClose }\n      : {};\n\n  return (\n    <>\n      {/* Goo filter: blur, sharpen the alpha back into solid shapes, then lay\n          the crisp original on top so blobs merge with liquid edges. */}\n      <svg aria-hidden width=\"0\" height=\"0\" className=\"pointer-events-none absolute\">\n        <title>Popover goo filter</title>\n        <defs>\n          <filter id={gooId} x=\"-50%\" y=\"-50%\" width=\"200%\" height=\"200%\">\n            <feGaussianBlur in=\"SourceGraphic\" stdDeviation={gooStrength} result=\"blur\" />\n            <feColorMatrix\n              in=\"blur\"\n              mode=\"matrix\"\n              values=\"1 0 0 0 0  0 1 0 0 0  0 0 1 0 0  0 0 0 22 -10\"\n              result=\"goo\"\n            />\n            <feComposite in=\"SourceGraphic\" in2=\"goo\" operator=\"atop\" />\n          </filter>\n        </defs>\n      </svg>\n\n      {/* Goo body: static trigger pill + morphing blob, behind the trigger. */}\n      <div\n        aria-hidden\n        className=\"pointer-events-none absolute z-[-1]\"\n        style={{\n          left: geo.left,\n          top: geo.top,\n          width: geo.layerW,\n          height: geo.layerH,\n          filter: reduce ? undefined : `url(#${gooId})`,\n        }}\n      >\n        <div\n          className=\"absolute bg-popover\"\n          style={{\n            left: geo.trigger.x,\n            top: geo.trigger.y,\n            width: geo.trigger.w,\n            height: geo.trigger.h,\n            borderRadius: geo.trigger.r,\n          }}\n        />\n        <div\n          ref={blobRef}\n          className=\"absolute inset-0 bg-popover\"\n          style={{ clipPath: insetForProgress(geo, progress.get()) }}\n        />\n      </div>\n\n      {/* Content, clipped by the same morph. pointer-events-none so it never\n          shadows the trigger; the open panel re-enables its own. */}\n      <div\n        className=\"pointer-events-none absolute z-10\"\n        style={{ left: geo.left, top: geo.top, width: geo.layerW, height: geo.layerH }}\n      >\n        <div\n          ref={clipRef}\n          inert={!open}\n          className=\"absolute inset-0\"\n          style={{\n            clipPath: insetForProgress(geo, progress.get()),\n            pointerEvents: open ? \"auto\" : \"none\",\n          }}\n        >\n          <div\n            ref={measureRef}\n            id={contentId}\n            role=\"dialog\"\n            {...hoverHandlers}\n            style={{\n              position: \"absolute\",\n              left: geo.panel.x,\n              top: geo.panel.y,\n              transformOrigin: `${ALIGN_ORIGIN[align]} ${side === \"bottom\" ? \"top\" : \"bottom\"}`,\n            }}\n            className={cn(\n              \"w-max max-w-[min(92vw,20rem)] p-4 text-popover-foreground outline-none\",\n              className,\n            )}\n          >\n            {children}\n          </div>\n        </div>\n      </div>\n    </>\n  );\n}\n"},{"path":"lib/utils.ts","type":"registry:lib","target":"@lib/utils.ts","content":"import { clsx, type ClassValue } from \"clsx\"\nimport { twMerge } from \"tailwind-merge\"\n\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs))\n}\n"}]}