/**
 * @factory/ui — Popover (Radix `@radix-ui/react-popover` wrapper).
 * Focus is trapped while open by Radix; Escape/Tab-out close (Radix behavior).
 */
import * as React from "react";
import * as RadixPopover from "@radix-ui/react-popover";
import { clsx } from "clsx";

export const Popover = RadixPopover.Root;
export const PopoverTrigger = RadixPopover.Trigger;
export const PopoverAnchor = RadixPopover.Anchor;
export const PopoverClose = RadixPopover.Close;
export const PopoverContent = React.forwardRef<
  React.ElementRef<typeof RadixPopover.Content>,
  React.ComponentPropsWithoutRef<typeof RadixPopover.Content>
>(({ className, align = "start", sideOffset = 4, ...props }, ref) => (
  <RadixPopover.Portal>
    <RadixPopover.Content
      ref={ref}
      align={align}
      sideOffset={sideOffset}
      className={clsx(
        "z-50 w-72 rounded-md border border-border bg-popover p-4",
        "text-popover-foreground shadow-md focus:outline-none",
        className,
      )}
      {...props}
    />
  </RadixPopover.Portal>
));
PopoverContent.displayName = "PopoverContent";

export const PopoverHeader = ({ className, ...props }: React.HTMLAttributes<HTMLDivElement>) => (
  <div className={clsx("mb-2 text-sm font-semibold text-foreground", className)} {...props} />
);

export const PopoverDescription = ({
  className,
  ...props
}: React.HTMLAttributes<HTMLDivElement>) => (
  <div className={clsx("text-sm text-muted-foreground", className)} {...props} />
);