'use client';

/**
 * 🔴 层级约定(2026-08-03,踩坑后定):**浮层 z ≥ 70,模态 z ≥ 80**。
 *
 * 助手窗是 `fixed z-[60]`(pet fab 61、数据流粒子 62)。shadcn 默认给浮层 `z-50` ——
 * 于是**任何在助手窗里打开的浮层都渲染在它底下**:
 *   · Select/Popover 类:点了有反应(DOM 里 listbox 确实打开),但一个选项都看不见;
 *   · Dialog/AlertDialog 类更糟:Radix 会给 body 设 `pointer-events:none`,
 *     弹窗看不见、整页却已经被锁住 —— 用户看到的就是**卡死**。
 * ⚠️ 这类错**不报任何错**,只能实测发现。⛔ 别把 z 调回 50。
 */
import * as React from 'react';
import * as HoverCardPrimitive from '@radix-ui/react-hover-card';

import { cn } from '@/lib/utils';

/**
 * 悬停信息卡 — HoverCard + HoverCardTrigger/HoverCardContent 组合。
 * @category overlay
 */
const HoverCard = HoverCardPrimitive.Root;

const HoverCardTrigger = HoverCardPrimitive.Trigger;

const HoverCardContent = React.forwardRef<
  React.ElementRef<typeof HoverCardPrimitive.Content>,
  React.ComponentPropsWithoutRef<typeof HoverCardPrimitive.Content>
>(({ className, align = 'center', sideOffset = 4, ...props }, ref) => (
  // ⭐ Portal:渲染到 body,逃出祖先 overflow:hidden 裁切(优先级/画像 hover 浮层被侧栏切掉的根因)
  <HoverCardPrimitive.Portal>
    <HoverCardPrimitive.Content
      ref={ref}
      align={align}
      sideOffset={sideOffset}
      collisionPadding={8}
      className={cn(
        'z-[70] w-64 rounded-md border bg-popover p-4 text-popover-foreground shadow-md outline-none',
        'data-[state=open]:animate-in data-[state=closed]:animate-out',
        'data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0',
        'data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95',
        'data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2',
        'data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2',
        className,
      )}
      {...props}
    />
  </HoverCardPrimitive.Portal>
));
HoverCardContent.displayName = HoverCardPrimitive.Content.displayName;

export { HoverCard, HoverCardTrigger, HoverCardContent };
