{"$schema":"https://ui.shadcn.com/schema/registry-item.json","name":"popover","type":"registry:ui","title":"Popover","description":"Anchored popover on the native Popover API: top-layer, light dismiss and Escape for free, smart flipping, an arrow and a spring scale-in from the trigger.","dependencies":[],"registryDependencies":["utils"],"files":[{"path":"registry/ui/popover.tsx","type":"registry:ui","content":"\"use client\";\n\nimport {\n  createContext,\n  useContext,\n  useEffect,\n  useId,\n  useRef,\n  useState,\n  type ButtonHTMLAttributes,\n  type HTMLAttributes,\n  type ReactNode,\n  type RefObject,\n} from \"react\";\nimport { cn } from \"@/lib/utils\";\n\n// The content is a native `popover=\"auto\"`: top layer (never clipped by overflow),\n// light dismiss on outside click, Escape to close, and the trigger is a real\n// invoker (popovertarget). CSS handles enter/exit with @starting-style.\nconst css = `\n.ui-popover{position:fixed;inset:auto;margin:0;overflow:visible;opacity:0;scale:.94;translate:var(--from,0 0);transition:opacity .15s ease-in,scale .15s ease-in,translate .15s ease-in,display .15s allow-discrete,overlay .15s allow-discrete}\n.ui-popover:popover-open{opacity:1;scale:1;translate:0 0;transition-duration:.26s;transition-timing-function:cubic-bezier(.2,.9,.3,1.12)}\n@starting-style{.ui-popover:popover-open{opacity:0;scale:.94;translate:var(--from,0 0)}}\n.ui-popover[data-side=bottom]{--from:0 -8px;transform-origin:var(--arrow) top}\n.ui-popover[data-side=top]{--from:0 8px;transform-origin:var(--arrow) bottom}\n.ui-popover[data-side=left]{--from:8px 0;transform-origin:right var(--arrow)}\n.ui-popover[data-side=right]{--from:-8px 0;transform-origin:left var(--arrow)}\n.ui-popover-arrow{position:absolute;width:10px;height:10px;rotate:45deg;background:inherit;border:inherit}\n.ui-popover[data-side=bottom]>.ui-popover-arrow{top:-6px;left:calc(var(--arrow) - 5px);border-right:0;border-bottom:0}\n.ui-popover[data-side=top]>.ui-popover-arrow{bottom:-6px;left:calc(var(--arrow) - 5px);border-left:0;border-top:0}\n.ui-popover[data-side=right]>.ui-popover-arrow{left:-6px;top:calc(var(--arrow) - 5px);border-right:0;border-top:0}\n.ui-popover[data-side=left]>.ui-popover-arrow{right:-6px;top:calc(var(--arrow) - 5px);border-left:0;border-bottom:0}\n@media (prefers-reduced-motion:reduce){.ui-popover{transition-duration:0s!important}}\n`;\n\ntype Side = \"top\" | \"right\" | \"bottom\" | \"left\";\ntype Align = \"start\" | \"center\" | \"end\";\nconst OPPOSITE = { top: \"bottom\", bottom: \"top\", left: \"right\", right: \"left\" } as const;\nconst FOCUSABLE =\n  'a[href],button:not(:disabled),input:not(:disabled),select:not(:disabled),textarea:not(:disabled),[tabindex]:not([tabindex=\"-1\"])';\n\n/** Position a fixed element beside an anchor: flip if the preferred side lacks room, then shift into the viewport. */\nfunction place(anchor: DOMRect, el: HTMLElement, preferred: Side, align: Align, offset: number, pad = 8) {\n  const w = el.offsetWidth;\n  const h = el.offsetHeight;\n  const vw = document.documentElement.clientWidth;\n  const vh = document.documentElement.clientHeight;\n  const room = { top: anchor.top, bottom: vh - anchor.bottom, left: anchor.left, right: vw - anchor.right };\n  let side: Side = preferred;\n  const vertical0 = side === \"top\" || side === \"bottom\";\n  if (room[side] < (vertical0 ? h : w) + offset + pad && room[OPPOSITE[side]] > room[side]) side = OPPOSITE[side];\n  const vertical = side === \"top\" || side === \"bottom\";\n  const along = (start: number, size: number, len: number) =>\n    align === \"start\" ? start : align === \"end\" ? start + size - len : start + size / 2 - len / 2;\n  let x = vertical ? along(anchor.left, anchor.width, w) : side === \"right\" ? anchor.right + offset : anchor.left - offset - w;\n  let y = vertical ? (side === \"bottom\" ? anchor.bottom + offset : anchor.top - offset - h) : along(anchor.top, anchor.height, h);\n  x = Math.min(Math.max(pad, x), vw - w - pad);\n  y = Math.min(Math.max(pad, y), vh - h - pad);\n  const arrow = vertical ? anchor.left + anchor.width / 2 - x : anchor.top + anchor.height / 2 - y;\n  el.style.left = `${x}px`;\n  el.style.top = `${y}px`;\n  el.dataset.side = side;\n  el.style.setProperty(\"--arrow\", `${Math.min(Math.max(14, arrow), (vertical ? w : h) - 14)}px`);\n}\n\ntype Ctx = {\n  open: boolean;\n  setOpen: (open: boolean) => void;\n  triggerRef: RefObject<HTMLButtonElement | null>;\n  contentId: string;\n};\nconst PopoverContext = createContext<Ctx | null>(null);\n\nfunction usePopover() {\n  const ctx = useContext(PopoverContext);\n  if (!ctx) throw new Error(\"Popover parts must be rendered inside <Popover>.\");\n  return ctx;\n}\n\nexport interface PopoverProps {\n  open?: boolean;\n  defaultOpen?: boolean;\n  onOpenChange?: (open: boolean) => void;\n  children?: ReactNode;\n}\n\nexport function Popover({ open: openProp, defaultOpen = false, onOpenChange, children }: PopoverProps) {\n  const [inner, setInner] = useState(defaultOpen);\n  const open = openProp ?? inner;\n  const triggerRef = useRef<HTMLButtonElement>(null);\n  const id = useId();\n  const setOpen = (next: boolean) => {\n    if (next === open) return;\n    if (openProp === undefined) setInner(next);\n    onOpenChange?.(next);\n  };\n  return <PopoverContext value={{ open, setOpen, triggerRef, contentId: `${id}-popover` }}>{children}</PopoverContext>;\n}\n\nexport function PopoverTrigger({ className, ...props }: ButtonHTMLAttributes<HTMLButtonElement>) {\n  const { open, triggerRef, contentId } = usePopover();\n  return (\n    <button\n      type=\"button\"\n      ref={triggerRef}\n      popoverTarget={contentId}\n      aria-haspopup=\"dialog\"\n      aria-expanded={open}\n      aria-controls={contentId}\n      {...props}\n      className={cn(\n        \"inline-flex h-10 items-center justify-center gap-2 rounded-lg border border-border bg-card px-4 text-sm font-medium text-foreground shadow-sm outline-none transition-[background-color,scale] hover:bg-muted focus-visible:ring-2 focus-visible:ring-ring/60 active:scale-[0.97] aria-expanded:bg-muted [&_svg]:size-4\",\n        className,\n      )}\n    />\n  );\n}\n\nexport interface PopoverContentProps extends HTMLAttributes<HTMLDivElement> {\n  /** Preferred side; flips automatically when there is no room. */\n  side?: Side;\n  align?: Align;\n  /** Gap between trigger and content in px. */\n  sideOffset?: number;\n  /** Show a pointer arrow toward the trigger. */\n  arrow?: boolean;\n}\n\nexport function PopoverContent({\n  side = \"bottom\",\n  align = \"center\",\n  sideOffset = 10,\n  arrow = true,\n  className,\n  children,\n  ...props\n}: PopoverContentProps) {\n  const { open, setOpen, triggerRef, contentId } = usePopover();\n  const ref = useRef<HTMLDivElement>(null);\n  const opts = useRef({ side, align, sideOffset, setOpen });\n  const mounted = useRef(false);\n  const wasOpen = useRef(false);\n\n  useEffect(() => {\n    opts.current = { side, align, sideOffset, setOpen };\n  });\n\n  // Native toggles (invoker click, light dismiss, Escape) -> React state.\n  useEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    const position = () => {\n      const t = triggerRef.current;\n      if (t) place(t.getBoundingClientRect(), el, opts.current.side, opts.current.align, opts.current.sideOffset);\n    };\n    const before = (e: Event) => {\n      if ((e as ToggleEvent).newState === \"open\") requestAnimationFrame(position); // runs before the first painted frame\n    };\n    const toggle = (e: Event) => opts.current.setOpen((e as ToggleEvent).newState === \"open\");\n    el.addEventListener(\"beforetoggle\", before);\n    el.addEventListener(\"toggle\", toggle);\n    return () => {\n      el.removeEventListener(\"beforetoggle\", before);\n      el.removeEventListener(\"toggle\", toggle);\n    };\n  }, [triggerRef]);\n\n  // React state -> native popover, positioning and focus.\n  useEffect(() => {\n    const el = ref.current;\n    const firstRun = !mounted.current;\n    const opening = open && !wasOpen.current;\n    const closing = !open && wasOpen.current;\n    mounted.current = true;\n    wasOpen.current = open;\n    if (!el) return;\n    const shown = el.matches(\":popover-open\");\n    if (!open) {\n      if (shown) el.hidePopover();\n      if (closing && (el.contains(document.activeElement) || document.activeElement === document.body))\n        triggerRef.current?.focus({ preventScroll: true });\n      return;\n    }\n    if (!shown) el.showPopover();\n    const position = () => {\n      const t = triggerRef.current;\n      if (t) place(t.getBoundingClientRect(), el, side, align, sideOffset);\n    };\n    position();\n    if (opening && !firstRun)\n      (el.querySelector<HTMLElement>(\"[autofocus]\") ?? el.querySelector<HTMLElement>(FOCUSABLE) ?? el).focus({ preventScroll: true });\n    window.addEventListener(\"scroll\", position, { capture: true, passive: true });\n    window.addEventListener(\"resize\", position);\n    return () => {\n      window.removeEventListener(\"scroll\", position, { capture: true });\n      window.removeEventListener(\"resize\", position);\n    };\n  }, [open, triggerRef, side, align, sideOffset]);\n\n  return (\n    <div\n      {...props}\n      ref={ref}\n      id={contentId}\n      popover=\"auto\"\n      role=\"dialog\"\n      tabIndex={-1}\n      data-side={side}\n      className={cn(\n        \"ui-popover z-50 w-72 rounded-xl border border-border bg-popover p-4 text-sm text-popover-foreground shadow-xl shadow-black/20 outline-none\",\n        className,\n      )}\n    >\n      <style href=\"ui-popover\" precedence=\"default\">\n        {css}\n      </style>\n      {arrow && <span aria-hidden className=\"ui-popover-arrow\" />}\n      {children}\n    </div>\n  );\n}\n\nexport function PopoverClose({ onClick, ...props }: ButtonHTMLAttributes<HTMLButtonElement>) {\n  const { setOpen } = usePopover();\n  return (\n    <button\n      type=\"button\"\n      {...props}\n      onClick={(e) => {\n        onClick?.(e);\n        if (!e.defaultPrevented) setOpen(false);\n      }}\n    />\n  );\n}\n"}]}