@teamix-evo/ui 0.4.0 → 0.5.0

package/src/components/popconfirm/popconfirm.stories.tsx

@@ -1,75 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react-vite';
-import { RefreshCcw } from 'lucide-react';
-import { Popconfirm } from './popconfirm';
-import { Button } from '@/components/button/button';
-
-const meta: Meta<typeof Popconfirm> = {
-  title: '反馈 · Feedback/Popconfirm',
-  component: Popconfirm,
-  tags: ['autodocs'],
-  parameters: {
-    docs: {
-      description: {
-        component:
-          '轻量级确认弹层 — 小风险操作的二次确认（删除一行 / 忽略一条通知）。视觉比 AlertDialog 更轻、不阻塞页面；onConfirm 支持 Promise（等待时按钮自动 loading）。等价 antd `Popconfirm`。',
-      },
-    },
-  },
-};
-
-export default meta;
-type Story = StoryObj<typeof Popconfirm>;
-
-export const Playground: Story = {
-  parameters: { controls: { disable: true } },
-  render: () => (
-    <Popconfirm
-      title="确认取消订阅?"
-      description="你将停止收到每日摘要邮件"
-      onConfirm={() => new Promise<void>((r) => setTimeout(r, 400))}
-    >
-      <Button variant="outline">取消订阅</Button>
-    </Popconfirm>
-  ),
-};
-
-export const Destructive: Story = {
-  parameters: { controls: { disable: true } },
-  render: () => (
-    <Popconfirm
-      title="删除此评论?"
-      description="删除后无法恢复"
-      okType="destructive"
-      okText="删除"
-      onConfirm={() => new Promise<void>((r) => setTimeout(r, 600))}
-    >
-      <Button variant="ghost" size="sm">
-        删除
-      </Button>
-    </Popconfirm>
-  ),
-};
-
-export const CustomIcon: Story = {
-  parameters: { controls: { disable: true } },
-  render: () => (
-    <Popconfirm
-      title="重置所有筛选条件?"
-      icon={<RefreshCcw className="size-4 text-primary" />}
-      onConfirm={() => {
-        alert('已重置');
-      }}
-    >
-      <Button variant="ghost">重置筛选</Button>
-    </Popconfirm>
-  ),
-};
-
-export const Disabled: Story = {
-  parameters: { controls: { disable: true } },
-  render: () => (
-    <Popconfirm disabled title="不会弹出">
-      <Button variant="outline">禁用态(直接点击不弹出)</Button>
-    </Popconfirm>
-  ),
-};

package/src/components/popconfirm/popconfirm.tsx

@@ -1,134 +0,0 @@
-import * as React from 'react';
-import { AlertCircle } from 'lucide-react';
-
-import { cn } from '@/utils/cn';
-import { Button } from '@/components/button/button';
-import {
-  Popover,
-  PopoverContent,
-  PopoverTrigger,
-} from '@/components/popover/popover';
-
-export interface PopconfirmProps {
-  /** 触发节点(通常是 Button / a)。 */
-  children: React.ReactElement;
-  /** 主标题(antd `title` 并集)。 */
-  title: React.ReactNode;
-  /** 副描述(antd `description` 并集) — 解释操作后果。 */
-  description?: React.ReactNode;
-  /**
-   * 触发图标(antd `icon` 并集) — 默认警示图标。
-   */
-  icon?: React.ReactNode;
-  /** 确认按钮文本(antd `okText` 并集)。 @default "确定" */
-  okText?: string;
-  /** 取消按钮文本(antd `cancelText` 并集)。 @default "取消" */
-  cancelText?: string;
-  /**
-   * 确认按钮 variant(antd `okType` 并集) — 危险操作请用 `destructive`。
-   * @default "default"
-   */
-  okType?: 'default' | 'destructive';
-  /** 确认回调。 */
-  onConfirm?: () => void | Promise<void>;
-  /** 取消回调。 */
-  onCancel?: () => void;
-  /** 受控 open(antd `open` 并集) — 不传时本组件自管 open 状态。 */
-  open?: boolean;
-  /** open 变化回调。 */
-  onOpenChange?: (next: boolean) => void;
-  /** 禁用(子节点点击不弹出)。 */
-  disabled?: boolean;
-}
-
-/**
- * 轻量级确认弹层 — antd 独有补足。**等价 antd `Popconfirm`**。
- * 用于"小风险"操作的二次确认(删除某一行、忽略某条通知),
- * 视觉比 `AlertDialog` 更轻、不阻塞页面。
- *
- * **风险更高的操作请用 `AlertDialog`**(全屏阻塞模态)。
- */
-const Popconfirm: React.FC<PopconfirmProps> = ({
-  children,
-  title,
-  description,
-  icon,
-  okText = '确定',
-  cancelText = '取消',
-  okType = 'default',
-  onConfirm,
-  onCancel,
-  open,
-  onOpenChange,
-  disabled = false,
-}) => {
-  const [internalOpen, setInternalOpen] = React.useState(false);
-  const isControlled = open !== undefined;
-  const currentOpen = isControlled ? open! : internalOpen;
-  const [loading, setLoading] = React.useState(false);
-
-  const setOpen = (next: boolean) => {
-    if (!isControlled) setInternalOpen(next);
-    onOpenChange?.(next);
-  };
-
-  const handleConfirm = async () => {
-    try {
-      setLoading(true);
-      await onConfirm?.();
-      setOpen(false);
-    } finally {
-      setLoading(false);
-    }
-  };
-
-  const handleCancel = () => {
-    onCancel?.();
-    setOpen(false);
-  };
-
-  if (disabled) return children;
-
-  return (
-    <Popover open={currentOpen} onOpenChange={setOpen}>
-      <PopoverTrigger asChild>{children}</PopoverTrigger>
-      <PopoverContent className="w-72 p-3" align="start">
-        <div className="flex items-start gap-2">
-          <span className="mt-0.5 text-warning">
-            {icon ?? <AlertCircle className="size-4" />}
-          </span>
-          <div className="min-w-0 flex-1">
-            <div className="text-xs font-medium">{title}</div>
-            {description ? (
-              <div className={cn('mt-1 text-xs text-muted-foreground')}>
-                {description}
-              </div>
-            ) : null}
-          </div>
-        </div>
-        <div className="mt-3 flex justify-end gap-2">
-          <Button
-            type="button"
-            variant="outline"
-            size="sm"
-            onClick={handleCancel}
-          >
-            {cancelText}
-          </Button>
-          <Button
-            type="button"
-            variant={okType === 'destructive' ? 'destructive' : 'default'}
-            size="sm"
-            loading={loading}
-            onClick={handleConfirm}
-          >
-            {okText}
-          </Button>
-        </div>
-      </PopoverContent>
-    </Popover>
-  );
-};
-Popconfirm.displayName = 'Popconfirm';
-
-export { Popconfirm };

package/src/components/popover/popover.meta.md

@@ -1,154 +0,0 @@
----
-id: popover
-name: Popover
-type: component
-category: feedback
-since: 0.1.0
-package: '@teamix-evo/ui'
-displayName: 气泡卡片
----
-
-# Popover 气泡卡片
-
-可交互浮层 — Radix Popover + antd `arrow` 并集,使用 `showArrow` 控制尖角(与 Tooltip / HoverCard 命名统一)。
-**与 Tooltip 区别**:Popover 内可放任意交互元素(button / form / link),触发方式为 click(默认),不是 hover。
-
-## When to use
-
-- 行内编辑(点字段名跳出编辑面板)
-- 高级筛选 / 设置面板
-- 动作菜单(超过 3 项时考虑 DropdownMenu)
-- 信息卡片(用户头像 + 简介)
-
-## When NOT to use
-
-- 仅文字提示 → `Tooltip`
-- 必须用户响应(阻断式)→ `Dialog` / `AlertDialog`
-- 选择类下拉 → `Select` / `Combobox`
-
-## Props
-
-> 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成。下表是 `PopoverContent` 的 props;`Popover`(Root)透传 Radix 的 `open / defaultOpen / onOpenChange / modal`。
-
-<!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `showArrow` | `boolean` | `false` | – | 是否显示三角形箭头(antd `arrow` 并集)。 与 Tooltip / HoverCard 统一用 `showArrow`,语义更清晰。 |
-| `arrow` | `boolean` | – | – | 向后兼容别名:与 `showArrow` 二选一,同时传入时 `showArrow` 优先。 |
-| `container` | `HTMLElement \| null` | – | – | 弹层 Portal 挂载容器 — 透传给 Radix Popover Portal。 默认挂在 `document.body`;在内层滚动容器 / Dialog 内时常需指定为该容器节点。 等价 antd `popupContainer`。 |
-<!-- auto:props:end -->
-
-## 依赖
-
-> 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成,数据源是 [`manifest.json`](../../../manifest.json)。**手工编辑 marker 之间的内容会在下次生成时被覆盖**。
-
-<!-- auto:deps:begin -->
-### 同库依赖
-
-> `teamix-evo ui add popover` 时,以下 entry 会被自动连带安装(无需手动 add)。
-
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
-
-### npm 依赖
-
-> 业务侧需要先 `pnpm add` / `npm install` 这些包。CLI 在 `ui add` 完成后会列出此提示。
-
-```bash
-pnpm add @radix-ui/react-popover@^1.1.0
-```
-<!-- auto:deps:end -->
-
-> 子组件:`Popover`(Root)/ `PopoverTrigger`(触发器,通常 asChild)/ `PopoverContent`(浮层内容)/ `PopoverClose`(关闭按钮)/ `PopoverAnchor`(独立锚点)。
-
-## AI 生成纪律
-
-- **Trigger 用 `asChild`**:把已有按钮 wrap 进去而非另套层 `<button>`
-- **Content 必有焦点目标**:键盘可达性 — Popover 打开后第一个可聚焦元素自动获焦
-- **不嵌套 Popover**:嵌套会导致焦点陷阱混乱;改用 `Sheet` 或 `Dialog`
-- **`modal={true}` 仅用于阻断场景**:默认 modal=false,允许用户点外部关闭
-- **尖角名称用 `showArrow`**:与 Tooltip / HoverCard 保持一致;老字段 `arrow` 仅作为 deprecated 别名兼容,新代码不要再使用
-- **表单场景推荐 `showArrow`**:轻微联动视觉、用户能快速识别浮层来源;菜单类/设置面板可省略尖角以减少视觉噪点
-
-## Examples
-
-```tsx
-import {
-  Popover, PopoverTrigger, PopoverContent,
-} from '@/components/ui/popover';
-import { Button } from '@/components/ui/button';
-
-// 基础
-<Popover>
-  <PopoverTrigger asChild>
-    <Button variant="outline">打开</Button>
-  </PopoverTrigger>
-  <PopoverContent>
-    <h4 className="font-medium">标题</h4>
-    <p className="text-sm text-muted-foreground">描述文字...</p>
-  </PopoverContent>
-</Popover>
-
-// 带箭头
-<Popover>
-  <PopoverTrigger asChild>
-    <Button>更多</Button>
-  </PopoverTrigger>
-  <PopoverContent showArrow>
-    <p>简短说明</p>
-  </PopoverContent>
-</Popover>
-```
-
-## Balloon 形态 — 旧库 API → 新组合映射
-
-新库 **不提供独立的 `Balloon` 组件**。这是主动决策 — 旧库 cloud-design `Balloon` 是"hover 提示 + click 浮层 + closable + 多主题"一物多相,违背 P1 三层对齐。新库拆为:
-
-- **`Tooltip`**(hover) — 对应 cloud-design `Balloon.Tooltip` 和 `Balloon triggerType="hover"`,详见 [`tooltip.meta.md`](../tooltip/tooltip.meta.md)
-- **`Popover`**(click,本组件) — 对应 cloud-design `Balloon triggerType="click"`(默认)
-- **`HoverCard`**(纯展示的 hover 富内容) — 对应 `Balloon` 里放了富文本但不需交互的场景
-
-### Props 映射表(`Balloon` triggerType="click" 主路径)
-
-| 旧库 `Balloon` API                                 | 新库等价写法                                                                                                 | 备注                                                                                       |
-| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ |
-| `triggerType="click"`(默认)                        | `<Popover>`                                                                                                  | 默认即点击,无需额外配置                                                                    |
-| `triggerType="hover"`                              | `<Tooltip>` 或 `<HoverCard>`                                                                                 | hover 请拆到专门组件 — 语义不同                                                            |
-| `triggerType="focus"`                              | 暂不提供                                                                                                     | Radix Popover 默认不含 focus 触发;需要时业务侧 `onFocus={() => setOpen(true)}`             |
-| `trigger` (触发元素)                               | `<PopoverTrigger asChild>{element}</PopoverTrigger>`                                                         | asChild 透传,不多一层 wrapper                                                              |
-| `children` (浮层内容)                              | `<PopoverContent>{...}</PopoverContent>`                                                                     | 可放任意交互元素                                                                           |
-| `align`(12 方向 `tl/t/tr/lt/l/lb/rt/r/rb/bl/b/br`) | `side` + `align` 二维拆解 — 例: `tl` → `side="top" align="start"`,`t` → `side="top" align="center"`          | Radix 范式,遵循 W3C 方位语义                                                               |
-| `offset`                                           | `sideOffset` / `alignOffset`                                                                                 | 拆为两个轴,更精细                                                                          |
-| `type="normal"`(深色) / `type="primary"`(浅色)     | Popover 默认仅 light 一种 — 需深色请用 `Tooltip variant="default"` 或自带 `bg-primary` className             | 替代思路:Popover 是富内容容器,深色背景会严重限制子节点 contrast,业务需要时手动覆盖设计令牌 |
-| `closable=true`(右上角 X)                          | `<PopoverClose asChild><Button size="icon" variant="ghost" icon={<X />} aria-label="关闭" /></PopoverClose>` | 组合式 — 位置/样式/图标任意可控,见 `ClosableContent` story                                 |
-| `visible` / `defaultVisible`                       | `<Popover open={...}>` / `defaultOpen={...}`                                                                 | 受控/非受控两套                                                                            |
-| `onVisibleChange`                                  | `<Popover onOpenChange={...}>`                                                                               | —                                                                                          |
-| `onClose`                                          | `onOpenChange(open)` 里 · `if (!open) {...}`                                                                 | 统一为 `onOpenChange`,不拆 open/close 二事件                                               |
-| `safeNode`(点击该节点不关闭)                       | `onInteractOutside={(e) => { if (mySafeNode.contains(e.target as Node)) e.preventDefault(); }}`              | Radix 原生在 `onInteractOutside` callback 里自由判断,可控性更高                            |
-| `popupClassName`                                   | `<PopoverContent className="...">`                                                                           | 直接透传                                                                                   |
-| `popupStyle`                                       | `<PopoverContent style="...">`                                                                               | 直接透传                                                                                   |
-| `popupContainer`                                   | `<PopoverPrimitive.Portal container={...}>` (需手动包裹)                                                     | Radix 默认 portal 到 body                                                                  |
-| `cache`(隐藏时保留 DOM)                            | 不提供                                                                                                       | Radix Portal 是 mount/unmount 语义;需 cache 请业务侧自管 mount state                       |
-| `delay`(hover 延时)                                | 请用 `<Tooltip delayDuration={...}>`                                                                         | Popover 点击触发本就不需延时                                                               |
-| `animation` 自定义                                 | 已固化为 `animate-in/out fade+zoom+slide` 四向                                                               | 业务覆盖 → `<PopoverContent className="...">`                                              |
-| `followTrigger`                                    | 不提供                                                                                                       | Radix Portal 默认即 follow trigger,无需 prop                                               |
-
-### 不修复清单(主动不补)
-
-| 旧 API                                 | 决策原因                                                                              |
-| -------------------------------------- | ------------------------------------------------------------------------------------- |
-| 独立 `Balloon` 组件导出                | P1 三层对齐;`Tooltip`/`Popover`/`HoverCard` 三件拆解语义更明确                        |
-| `triggerType="focus"` 内置支持         | Radix Popover 不含 focus 触发;业务需要时手动 controlled `onFocus`,更可控              |
-| `cache`(隐藏时保留 DOM)                | mount/unmount 语义更准;cache 语义需业务侧明确控制                                     |
-| `safeNode` prop                        | `onInteractOutside` callback 表达力更强(可同时判断多个安全节点 + 条件逻辑)            |
-| 12 方向语言                            | 拆解为 `side` + `align` 二维 — W3C 语义,与 shadcn / Radix / antd `placement` 拆解一致 |
-| `cache` / `popupContainer` 为默认 prop | 低频场景,业务手动包 Portal container 更加明确                                         |
-
-### Balloon 专项 AI 生成纪律(在通用纪律之上叠加)
-
-- **实例化时先选语义不选品牌**:写业务代码时,口说 "加个 Balloon" → 先问 "hover 还是 click + 内部能交互吗" → 选出 Tooltip / HoverCard / Popover
-- **closable 走组合式**:不要为了"对齐 closable=true" 反向在 Popover 级加 prop — `<PopoverClose asChild>` 包 icon Button 即可(见 `ClosableContent` story)
-- **带 PopoverClose 的 X 按钮走 `variant="ghost" size="icon"`** + 主体内容 `pr-6` 避免多行文本被覆盖
-- **不要为 `safeNode` 需求抽 helper**:`onInteractOutside={(e) => isInsideRef(e.target, [refA, refB]) && e.preventDefault()}` 即足够
-- **深色背景需求请优先考虑切换到 Tooltip variant="default"** — 仅在 "深色且需交互" 的少数场景才走 Popover className 覆盖

package/src/components/popover/popover.stories.tsx

@@ -1,158 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react-vite';
-import { X } from 'lucide-react';
-import {
-  Popover,
-  PopoverTrigger,
-  PopoverContent,
-  PopoverClose,
-} from './popover';
-import { Button } from '@/components/button/button';
-import { Input } from '@/components/input/input';
-import { Label } from '@/components/label/label';
-
-const meta: Meta<typeof PopoverContent> = {
-  title: '反馈 · Feedback/Popover',
-  component: PopoverContent,
-  tags: ['autodocs'],
-  parameters: {
-    docs: {
-      description: {
-        component:
-          '气泡卡片 —— 由 trigger 触发,在 portal 中展示富内容(表单、菜单、说明等)。基于 Radix Popover 实现 + antd `Popover` 并集能力:`side` / `align` 控制方位、`showArrow` 渲染尖角、`modal` 控制是否阻断外部交互。相比 Tooltip 仅承载纯文本提示,Popover 可承载任意交互内容。视觉走 OpenTrek semantic tokens,所有样式来自 `@teamix-evo/tokens`,无 mock。',
-      },
-    },
-  },
-  argTypes: {
-    side: {
-      control: 'inline-radio',
-      options: ['top', 'right', 'bottom', 'left'],
-    },
-    align: {
-      control: 'inline-radio',
-      options: ['start', 'center', 'end'],
-    },
-    showArrow: { control: 'boolean' },
-  },
-  args: { side: 'bottom', align: 'center', showArrow: false },
-};
-
-export default meta;
-type Story = StoryObj<typeof PopoverContent>;
-
-export const Playground: Story = {
-  render: (args) => (
-    <Popover>
-      <PopoverTrigger asChild>
-        <Button variant="outline">打开 Popover</Button>
-      </PopoverTrigger>
-      <PopoverContent {...args}>
-        <h4 className="mb-1 font-medium">尺寸调整</h4>
-        <p className="text-sm text-muted-foreground">
-          设置组件宽高,关闭后自动应用。
-        </p>
-      </PopoverContent>
-    </Popover>
-  ),
-};
-
-export const WithArrow: Story = {
-  name: 'showArrow · 有尖角',
-  parameters: { controls: { disable: true } },
-  render: () => (
-    <Popover defaultOpen>
-      <PopoverTrigger asChild>
-        <Button variant="outline">带箭头</Button>
-      </PopoverTrigger>
-      <PopoverContent showArrow>
-        <h4 className="mb-1 font-medium">导出 CSV</h4>
-        <p className="text-sm text-muted-foreground">
-          仅导出当前筛选范围内的数据。
-        </p>
-      </PopoverContent>
-    </Popover>
-  ),
-};
-
-export const WithoutArrow: Story = {
-  name: 'showArrow={false} · 无尖角',
-  parameters: { controls: { disable: true } },
-  render: () => (
-    <Popover defaultOpen>
-      <PopoverTrigger asChild>
-        <Button variant="outline">无箭头</Button>
-      </PopoverTrigger>
-      <PopoverContent>
-        <h4 className="mb-1 font-medium">默认形态</h4>
-        <p className="text-sm text-muted-foreground">
-          浮层与 trigger 之间留白,不带尖角。
-        </p>
-      </PopoverContent>
-    </Popover>
-  ),
-};
-
-export const InteractiveForm: Story = {
-  parameters: { controls: { disable: true } },
-  render: () => (
-    <Popover>
-      <PopoverTrigger asChild>
-        <Button>边距设置</Button>
-      </PopoverTrigger>
-      <PopoverContent className="w-80" showArrow>
-        <div className="grid gap-3">
-          <h4 className="font-medium">边距</h4>
-          <div className="grid grid-cols-3 items-center gap-3">
-            <Label htmlFor="m-top">上</Label>
-            <Input id="m-top" defaultValue="16" className="col-span-2 h-8" />
-          </div>
-          <div className="grid grid-cols-3 items-center gap-3">
-            <Label htmlFor="m-right">右</Label>
-            <Input id="m-right" defaultValue="16" className="col-span-2 h-8" />
-          </div>
-          <div className="grid grid-cols-3 items-center gap-3">
-            <Label htmlFor="m-bottom">下</Label>
-            <Input id="m-bottom" defaultValue="16" className="col-span-2 h-8" />
-          </div>
-          <div className="grid grid-cols-3 items-center gap-3">
-            <Label htmlFor="m-left">左</Label>
-            <Input id="m-left" defaultValue="16" className="col-span-2 h-8" />
-          </div>
-        </div>
-      </PopoverContent>
-    </Popover>
-  ),
-};
-
-/**
- * Closable 形态 — 对齐 cloud-design `Balloon closable=true`。旧库用
- * `closable` prop 声明式控制右上角 X 按钮,新库用 `<PopoverClose asChild>`
- * 包裹 icon Button 的组合式 — 位置/样式/图标任意可控,且与整体设计体系的
- * Button 变体(`size="icon"` `variant="ghost"`)保持一致。
- */
-export const ClosableContent: Story = {
-  parameters: { controls: { disable: true } },
-  render: () => (
-    <Popover defaultOpen>
-      <PopoverTrigger asChild>
-        <Button variant="outline">可关闭浮层</Button>
-      </PopoverTrigger>
-      <PopoverContent className="relative w-80" showArrow>
-        <PopoverClose asChild>
-          <Button
-            size="icon"
-            variant="ghost"
-            icon={<X />}
-            aria-label="关闭浮层"
-            className="absolute right-1 top-1"
-          />
-        </PopoverClose>
-        <div className="pr-6">
-          <h4 className="mb-1 font-medium">付费提示</h4>
-          <p className="text-sm text-muted-foreground">
-            升级到专业版可解锁高级限流策略。点击右上角 × 随时关闭。
-          </p>
-        </div>
-      </PopoverContent>
-    </Popover>
-  ),
-};

package/src/components/popover/popover.tsx

@@ -1,104 +0,0 @@
-import * as React from 'react';
-import * as PopoverPrimitive from '@radix-ui/react-popover';
-
-import { cn } from '@/utils/cn';
-
-const Popover = PopoverPrimitive.Root;
-const PopoverTrigger = React.forwardRef<
-  React.ElementRef<typeof PopoverPrimitive.Trigger>,
-  React.ComponentPropsWithoutRef<typeof PopoverPrimitive.Trigger>
->(({ className, ...props }, ref) => (
-  <PopoverPrimitive.Trigger
-    ref={ref}
-    className={cn('cursor-pointer', className)}
-    {...props}
-  />
-));
-PopoverTrigger.displayName = PopoverPrimitive.Trigger.displayName;
-const PopoverAnchor = PopoverPrimitive.Anchor;
-const PopoverClose = PopoverPrimitive.Close;
-
-export interface PopoverContentProps
-  extends React.ComponentPropsWithoutRef<typeof PopoverPrimitive.Content> {
-  /**
-   * 是否显示三角形箭头(antd `arrow` 并集)。
-   * 与 Tooltip / HoverCard 统一用 `showArrow`,语义更清晰。
-   * @default false
-   */
-  showArrow?: boolean;
-  /**
-   * 向后兼容别名:与 `showArrow` 二选一,同时传入时 `showArrow` 优先。
-   * @deprecated 请改用 `showArrow`,后续版本会移除。
-   */
-  arrow?: boolean;
-  /**
-   * 弹层 Portal 挂载容器 — 透传给 Radix Popover Portal。
-   * 默认挂在 `document.body`;在内层滚动容器 / Dialog 内时常需指定为该容器节点。
-   * 等价 antd `popupContainer`。
-   */
-  container?: HTMLElement | null;
-}
-
-/**
- * `onCloseAutoFocus` 默认 `preventDefault` — 阻止 Radix 关闭时把焦点程序化
- * restore 回 trigger。
- *
- * 原因:Chromium/Safari 把"程序化 restore 的 focus"判定为非鼠标焦点 → 触发
- * `:focus-visible` → trigger(多数是 Button)在关闭后残留蓝色 ring,与用户
- * "鼠标点完已经失焦了"的视觉预期冲突。与 DropdownMenu / ContextMenu 走同一
- * 默认策略,对齐 antd `Popover` / cloud-design `Balloon` 的鼠标体感。
- *
- * 取舍:键盘 Esc 关闭后焦点也不会 restore 回 trigger,而是落到 body。业务侧
- * 需要保留 restore 行为时,显式传 `onCloseAutoFocus` 即可完全覆盖默认。
- */
-const PopoverContent = React.forwardRef<
-  React.ElementRef<typeof PopoverPrimitive.Content>,
-  PopoverContentProps
->(
-  (
-    {
-      className,
-      align = 'center',
-      sideOffset = 4,
-      showArrow,
-      arrow,
-      onCloseAutoFocus,
-      container,
-      children,
-      ...props
-    },
-    ref,
-  ) => {
-    // showArrow 优先;arrow 作为 deprecated 别名兜底,保持向后兼容
-    const renderArrow = showArrow ?? arrow ?? false;
-    return (
-      <PopoverPrimitive.Portal container={container}>
-        <PopoverPrimitive.Content
-          ref={ref}
-          align={align}
-          sideOffset={sideOffset}
-          onCloseAutoFocus={
-            onCloseAutoFocus ?? ((event) => event.preventDefault())
-          }
-          className={cn(
-            'z-50 w-72 rounded-md border border-border bg-popover p-4 text-popover-foreground shadow-md outline-none animate-in fade-in-0 zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-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}
-        >
-          {children}
-          {renderArrow ? (
-            <PopoverPrimitive.Arrow
-              className="fill-popover"
-              width={10}
-              height={5}
-            />
-          ) : null}
-        </PopoverPrimitive.Content>
-      </PopoverPrimitive.Portal>
-    );
-  },
-);
-PopoverContent.displayName = PopoverPrimitive.Content.displayName;
-
-export { Popover, PopoverTrigger, PopoverContent, PopoverAnchor, PopoverClose };