@teamix-evo/ui 0.4.0 → 0.5.0

package/src/components/toggle-group/toggle-group.meta.md

@@ -1,91 +0,0 @@
----
-id: toggle-group
-name: ToggleGroup
-type: component
-category: deprecated
-since: 0.1.0
-package: '@teamix-evo/ui'
-displayName: 切换按钮组
----
-
-# ToggleGroup 切换按钮组
-
-切换按钮组 — Radix ToggleGroup,**单选(`type="single"`)+ 多选(`type="multiple"`)**。复用 Toggle 的 cva variants(default / outline)与 size。
-
-## When to use
-
-- 工具栏(Bold / Italic / Underline)— `type="multiple"`
-- 视图切换(Grid / List / Card)— `type="single"`
-- 段落对齐(Left / Center / Right / Justify)— `type="single"`
-
-## When NOT to use
-
-- 表单选择 → `RadioGroup`(单选)/ `Checkbox`(多选)
-- 选项数 > 5 → `Select` / `Combobox`
-- 单个二元开关 → `Switch` / `Toggle`
-
-## Props
-
-> 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成。
-
-<!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `variant` | `'default' \| 'outline'` | `"default"` | – | 视觉风格,与同源的 [`Toggle`](../toggle/toggle.tsx) 保持一致。 |
-| `size` | `'sm' \| 'md' \| 'default' \| 'lg'` | `"default"` | – | 尺寸,与同源的 [`Toggle`](../toggle/toggle.tsx) 保持一致。 |
-| `className` | `string` | – | – | 容器 className,会与默认布局类合并。 |
-<!-- auto:props:end -->
-
-## 依赖
-
-> 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成,数据源是 [`manifest.json`](../../../manifest.json)。**手工编辑 marker 之间的内容会在下次生成时被覆盖**。
-
-<!-- auto:deps:begin -->
-### 同库依赖
-
-> `teamix-evo ui add toggle-group` 时,以下 entry 会被自动连带安装(无需手动 add)。
-
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
-| `toggle` | component | 二元状态按钮 — Radix Toggle 包装,工具栏图标级开关 |
-
-### npm 依赖
-
-> 业务侧需要先 `pnpm add` / `npm install` 这些包。CLI 在 `ui add` 完成后会列出此提示。
-
-```bash
-pnpm add @radix-ui/react-toggle-group@^1.1.0 class-variance-authority@^0.7.0
-```
-<!-- auto:deps:end -->
-
-> 透传 Radix ToggleGroup.Root 所有 props(`type` / `value` / `defaultValue` / `onValueChange` / `disabled` / `loop` / `orientation` 等)。
-> `ToggleGroupItem` 接受 `value` 等 Radix 标准 props。
-
-## AI 生成纪律
-
-- **`type` 必传**:`type="single"` 与 `type="multiple"` value 类型不同(string vs string[])
-- **每项 value 唯一**:不要用 index
-- **`size` / `variant` 在 Group 上设置**:Item 自动继承,不要逐项设置
-- **图标按钮配 `aria-label`**
-
-## Examples
-
-```tsx
-import { ToggleGroup, ToggleGroupItem } from '@/components/ui/toggle-group';
-import { AlignLeft, AlignCenter, AlignRight } from 'lucide-react';
-
-// 单选(对齐方式)
-<ToggleGroup type="single" defaultValue="left">
-  <ToggleGroupItem value="left" aria-label="左对齐"><AlignLeft /></ToggleGroupItem>
-  <ToggleGroupItem value="center" aria-label="居中"><AlignCenter /></ToggleGroupItem>
-  <ToggleGroupItem value="right" aria-label="右对齐"><AlignRight /></ToggleGroupItem>
-</ToggleGroup>
-
-// 多选(文本格式)
-<ToggleGroup type="multiple" variant="outline">
-  <ToggleGroupItem value="bold">B</ToggleGroupItem>
-  <ToggleGroupItem value="italic">I</ToggleGroupItem>
-  <ToggleGroupItem value="underline">U</ToggleGroupItem>
-</ToggleGroup>
-```

package/src/components/toggle-group/toggle-group.stories.tsx

@@ -1,83 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react-vite';
-import {
-  AlignLeft,
-  AlignCenter,
-  AlignRight,
-  AlignJustify,
-  Bold,
-  Italic,
-  Underline,
-} from 'lucide-react';
-import { ToggleGroup, ToggleGroupItem } from './toggle-group';
-
-const meta: Meta<typeof ToggleGroup> = {
-  title: '废弃 · Deprecated/ToggleGroup',
-  component: ToggleGroup,
-  tags: ['autodocs'],
-  parameters: {
-    docs: {
-      description: {
-        component:
-          '⚠️ **已废弃** — 仅 Storybook 留档,不通过 manifest 对外发布。\n\n切换按钮组 — 一组二状态按钮的集合，可选单选 (`type="single"`) 或多选 (`type="multiple"`)，常用于对齐方式 / 字体样式等工具栏场景。Radix ToggleGroup 实现，shadcn 专有（antd 以 `Radio.Group` + `Radio.Button` 表达单选、以菜单多选表达多选）；`variant` / `size` 与 `Toggle` 保持一致。',
-      },
-    },
-  },
-  argTypes: {
-    variant: { control: 'inline-radio', options: ['default', 'outline'] },
-    size: { control: 'inline-radio', options: ['sm', 'default', 'lg'] },
-    disabled: { control: 'boolean' },
-  },
-  args: { variant: 'default', size: 'default' },
-};
-
-export default meta;
-type Story = StoryObj<typeof ToggleGroup>;
-
-export const SingleAlign: Story = {
-  args: { type: 'single', defaultValue: 'left' },
-  render: (args) => (
-    <ToggleGroup {...args}>
-      <ToggleGroupItem value="left" aria-label="左对齐">
-        <AlignLeft />
-      </ToggleGroupItem>
-      <ToggleGroupItem value="center" aria-label="居中">
-        <AlignCenter />
-      </ToggleGroupItem>
-      <ToggleGroupItem value="right" aria-label="右对齐">
-        <AlignRight />
-      </ToggleGroupItem>
-      <ToggleGroupItem value="justify" aria-label="两端对齐">
-        <AlignJustify />
-      </ToggleGroupItem>
-    </ToggleGroup>
-  ),
-};
-
-export const MultipleFormat: Story = {
-  args: { type: 'multiple', variant: 'outline' },
-  parameters: { controls: { disable: true } },
-  render: (args) => (
-    <ToggleGroup {...args}>
-      <ToggleGroupItem value="bold" aria-label="加粗">
-        <Bold />
-      </ToggleGroupItem>
-      <ToggleGroupItem value="italic" aria-label="斜体">
-        <Italic />
-      </ToggleGroupItem>
-      <ToggleGroupItem value="underline" aria-label="下划线">
-        <Underline />
-      </ToggleGroupItem>
-    </ToggleGroup>
-  ),
-};
-
-export const TextItems: Story = {
-  parameters: { controls: { disable: true } },
-  render: () => (
-    <ToggleGroup type="single" defaultValue="grid" variant="outline">
-      <ToggleGroupItem value="grid">网格</ToggleGroupItem>
-      <ToggleGroupItem value="list">列表</ToggleGroupItem>
-      <ToggleGroupItem value="card">卡片</ToggleGroupItem>
-    </ToggleGroup>
-  ),
-};

package/src/components/toggle-group/toggle-group.tsx

@@ -1,78 +0,0 @@
-import * as React from 'react';
-import * as ToggleGroupPrimitive from '@radix-ui/react-toggle-group';
-import { type VariantProps } from 'class-variance-authority';
-
-import { cn } from '@/utils/cn';
-import { toggleVariants } from '@/components/toggle/toggle';
-
-const ToggleGroupContext = React.createContext<
-  VariantProps<typeof toggleVariants>
->({ size: 'md', variant: 'default' });
-
-/**
- * ToggleGroup 自身的可定制属性。底层 type=`single`|`multiple` 与对应的
- * `value` / `onValueChange` 等由 Radix 的 union props 透传。
- */
-export interface ToggleGroupProps {
-  /**
-   * 视觉风格,与同源的 [`Toggle`](../toggle/toggle.tsx) 保持一致。
-   * @default "default"
-   */
-  variant?: 'default' | 'outline';
-  /**
-   * 尺寸,与同源的 [`Toggle`](../toggle/toggle.tsx) 保持一致。
-   * @default "default"
-   */
-  size?: 'sm' | 'md' | 'default' | 'lg';
-  /**
-   * 容器 className,会与默认布局类合并。
-   */
-  className?: string;
-}
-
-function ToggleGroup({
-  className,
-  variant,
-  size,
-  children,
-  ...props
-}: ToggleGroupProps &
-  React.ComponentPropsWithoutRef<typeof ToggleGroupPrimitive.Root>) {
-  return (
-    <ToggleGroupPrimitive.Root
-      className={cn('flex items-center justify-center gap-1', className)}
-      {...props}
-    >
-      <ToggleGroupContext.Provider value={{ variant, size }}>
-        {children}
-      </ToggleGroupContext.Provider>
-    </ToggleGroupPrimitive.Root>
-  );
-}
-ToggleGroup.displayName = ToggleGroupPrimitive.Root.displayName;
-
-const ToggleGroupItem = React.forwardRef<
-  React.ElementRef<typeof ToggleGroupPrimitive.Item>,
-  React.ComponentPropsWithoutRef<typeof ToggleGroupPrimitive.Item> &
-    VariantProps<typeof toggleVariants>
->(({ className, children, variant, size, ...props }, ref) => {
-  const ctx = React.useContext(ToggleGroupContext);
-  return (
-    <ToggleGroupPrimitive.Item
-      ref={ref}
-      className={cn(
-        toggleVariants({
-          variant: ctx.variant ?? variant,
-          size: ctx.size ?? size,
-        }),
-        className,
-      )}
-      {...props}
-    >
-      {children}
-    </ToggleGroupPrimitive.Item>
-  );
-});
-ToggleGroupItem.displayName = ToggleGroupPrimitive.Item.displayName;
-
-export { ToggleGroup, ToggleGroupItem };

package/src/components/tooltip/tooltip.meta.md

@@ -1,149 +0,0 @@
----
-id: tooltip
-name: Tooltip
-type: component
-category: data-display
-since: 0.1.0
-package: '@teamix-evo/ui'
-displayName: 文字提示
----
-
-# Tooltip 文字提示
-
-文字提示气泡 — Radix Tooltip + antd `arrow / placement(side)` 并集 + cloud-design Balloon 双形态(`variant: default | light`)。
-**两种用法**:`<Tooltip title="...">{trigger}</Tooltip>` 一行包装,或拆分原子组件(`TooltipRoot/Trigger/Content`)精细控制。
-
-> **必须用 `<TooltipProvider>` 包裹**(通常在应用根),或在单 Tooltip 上传 `withProvider`。
-
-## 视觉变体
-
-| variant   | 背景                          | 适用场景                                          |
-| --------- | ----------------------------- | ------------------------------------------------- |
-| `default` | 深色 + 浅色文字               | 图标按钮、列截断、工具栏 — 信息密度高、对比强     |
-| `light`   | 浅色 + 深色文字 + 边框 + 阴影 | 富文本提示、字段说明、与 Popover 调性接近的轻提示 |
-
-对应 cloud-design Balloon `type="primary"`(白色)/ `type="normal"`(深色)。
-
-## When to use
-
-- 图标按钮的文字解释(无障碍 + 视觉提示)
-- 表单字段的辅助说明(替代占空间的描述文字)
-- 数据列的列宽不足导致截断时的完整内容
-
-## When NOT to use
-
-- 包含交互的内容 → 用 `Popover` 或 `HoverCard`
-- 长文本(超过 1 行)→ 用 `HoverCard` 或对话框
-- 移动端首要功能 → 触屏不易触发 hover,改用按钮 + 弹窗
-
-## Props
-
-> 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成。
-
-<!-- auto:props:begin -->
-| 名称 | 类型 | 默认值 | 必填 | 说明 |
-| --- | --- | --- | --- | --- |
-| `children` | `React.ReactElement` | – | ✓ | 触发器(单个 ReactElement,asChild 透传)。 |
-| `title` | `React.ReactNode` | – | ✓ | 提示内容。 |
-| `side` | `'top' \| 'right' \| 'bottom' \| 'left'` | `"top"` | – | 弹出方向。 |
-| `variant` | `'default' \| 'light'` | `"default"` | – | 视觉变体: - `default`:深色背景 + 浅色文字(信息密度高、对比强,适合图标按钮 / 列截断提示) - `light`:浅色背景 + 深色文字 + 边框 + 阴影(视觉更轻,贴近富内容卡片调性, 对齐 cloud-design Balloon `type="primary"`) |
-| `arrow` | `boolean` | `true` | – | 是否显示三角形箭头。 |
-| `delayDuration` | `number` | – | – | 显示延迟(ms),默认沿用 Provider 的 delayDuration。 |
-| `withProvider` | `boolean` | – | – | 强制传给 Provider 的 delayDuration(便于不挂 Provider 的场景)。 |
-<!-- auto:props:end -->
-
-## 依赖
-
-> 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成,数据源是 [`manifest.json`](../../../manifest.json)。**手工编辑 marker 之间的内容会在下次生成时被覆盖**。
-
-<!-- auto:deps:begin -->
-### 同库依赖
-
-> `teamix-evo ui add tooltip` 时,以下 entry 会被自动连带安装(无需手动 add)。
-
-| Entry | 类型 | 描述 |
-| --- | --- | --- |
-| `cn` | util | Tailwind className 合并工具(clsx + tailwind-merge) |
-
-### npm 依赖
-
-> 业务侧需要先 `pnpm add` / `npm install` 这些包。CLI 在 `ui add` 完成后会列出此提示。
-
-```bash
-pnpm add @radix-ui/react-tooltip@^1.1.0 class-variance-authority@^0.7.0
-```
-<!-- auto:deps:end -->
-
-> 子组件 `TooltipProvider / TooltipRoot / TooltipTrigger / TooltipContent` 用于精细控制,见 [`tooltip.tsx`](./tooltip.tsx)。
-
-## AI 生成纪律
-
-- **必有 Provider**:不挂 Provider 直接用 Tooltip 会报错或不工作。**应用根**统一挂 `<TooltipProvider delayDuration={300}>`
-- **`title` 用文本不放交互**:Tooltip 内放 button / link 在键盘焦点流转上是反模式
-- **`title` ≤ 1 行**:超过 1 行换 `HoverCard`
-- **图标按钮必配 Tooltip + aria-label**:不能只靠 Tooltip 而省略 aria-label,屏幕阅读器不一定触发
-- **`side` 选 `top` 通常最稳**:避免被屏幕边缘截断;Radix 自带翻转回避能力,但标注首选语义
-- **变体选择**:默认深色(`default`)即可;只有需要承载图标 + 文字的轻提示、且周围已有大量深色元素时才选 `light`,避免与 `Popover` 视觉混淆
-- **不要为 `light` 自行覆写 `bg-white`/`text-black`**:语义色走 `bg-popover`/`text-popover-foreground`,主题切换时才能跟随
-
-## Examples
-
-```tsx
-import { Tooltip, TooltipProvider } from '@/components/ui/tooltip';
-import { Button } from '@/components/ui/button';
-import { Settings } from 'lucide-react';
-
-// 应用根挂 Provider
-<TooltipProvider delayDuration={300}>
-  <App />
-</TooltipProvider>
-
-// 简洁用法
-<Tooltip title="设置">
-  <Button size="icon" variant="ghost" aria-label="设置">
-    <Settings />
-  </Button>
-</Tooltip>
-
-// 自定义方向 + 无箭头
-<Tooltip title="向右弹出" side="right" arrow={false}>
-  <Button variant="outline">悬浮我</Button>
-</Tooltip>
-
-// 浅色变体(light)
-<Tooltip title="浅色提示" variant="light">
-  <Button variant="outline">浅色</Button>
-</Tooltip>
-```
-
-## Balloon.Tooltip 形态 — 旧库 API → 新库映射
-
-旧库 cloud-design `Balloon.Tooltip`(以及 `Balloon triggerType="hover"`)在新库统一拆到 `Tooltip`。完整的 Balloon 拆解决策与 Props 总表见 [`popover.meta.md` "Balloon 形态” 章节](../popover/popover.meta.md);本表只列 Tooltip 主路径。
-
-### Props 映射表
-
-| 旧库 `Balloon.Tooltip` / `Balloon hover` API | 新库等价写法                                     | 备注                                                                                          |
-| -------------------------------------------- | ------------------------------------------------ | --------------------------------------------------------------------------------------------- |
-| `trigger`                                    | `<Tooltip>{element}</Tooltip>`(asChild 自动处理) | 与 Popover 统一 trigger 协议                                                                  |
-| `children`(文本内容)                         | `title` prop                                     | 重命名为 `title`,与 antd `Tooltip` 一致                                                       |
-| `align`(12 方向)                             | `side`(4 方向,Radix 范式)                        | Tooltip 只提供 4 方向,需要 12 方位请用 `<TooltipContent side={...} align={...}>` 拆分原子组件 |
-| `type="normal"`(深色)                        | `variant="default"`(默认)                        | bg-primary + text-primary-foreground                                                          |
-| `type="primary"`(浅色)                       | `variant="light"`                                | 边框 + bg-popover + shadow                                                                    |
-| `delay`(hover 延时)                          | `delayDuration`                                  | 默认走 `TooltipProvider` 上的值                                                               |
-| `arrow=true`(默认)                           | `arrow={true}`(默认)                             | 一致                                                                                          |
-| `popupClassName` / `popupStyle`              | `<TooltipContent className/style>`(拆原子用法)   | `<Tooltip>` 包装器未透传,需拆到 TooltipContent                                                |
-
-### 不修复清单
-
-| 旧 API                                | 决策原因                                                                |
-| ------------------------------------- | ----------------------------------------------------------------------- |
-| `triggerType="click"` 在 Tooltip 混用 | hover/click 语义不同 — click 走 [`Popover`](../popover/popover.meta.md) |
-| 12 方向 prop 级支持                   | shorthand `side` 足够覆盖 90% 场景;边缘对齐拆原子组件 + `align`         |
-| `safeNode`                            | Tooltip 不需要 — hover 离开即隐藏,无 click outside 语义                 |
-| `closable`                            | Tooltip 不需要 — 鼠标离开即隐藏;需手动关闭请用 Popover                  |
-
-### Tooltip 专项 AI 生成纪律(在通用纪律之上叠加)
-
-- **不要用 Tooltip 装交互元素** — 需要点击/表单/链接 → 走 `Popover`(中量交互)/`HoverCard`(纯展示富内容)
-- **外层必挑 `<TooltipProvider delayDuration={300}>`** — 高频 demo 在应用根一次安装,不要每个 Tooltip 独立 `withProvider`(除非是独立 story / 孤零页面)
-- **`light` 变体只用于能够与 Popover 区分的轻提示** — 不要不分场景一套 light

package/src/components/tooltip/tooltip.stories.tsx

@@ -1,108 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react-vite';
-import { Settings, Info } from 'lucide-react';
-import { Tooltip, TooltipProvider } from './tooltip';
-import { Button } from '@/components/button/button';
-
-const meta: Meta<typeof Tooltip> = {
-  title: '数据展示 · Data Display/Tooltip',
-  component: Tooltip,
-  tags: ['autodocs'],
-  parameters: {
-    docs: {
-      description: {
-        component:
-          '文字提示 —— 鼠标悬停或键盘聚焦元素时弹出的简短文字解释。基于 Radix Tooltip 实现 + antd `Tooltip` 并集能力:`title` 文本、`side` 四向、`arrow` 尖角、`delayDuration` 延迟、`withProvider` 内联 Provider,新增 `variant`(default 深底 / light 白底)对齐 cloud-design Balloon 双形态。视觉走 OpenTrek semantic tokens,所有样式来自 `@teamix-evo/tokens`,无 mock。',
-      },
-    },
-  },
-  argTypes: {
-    side: {
-      control: 'inline-radio',
-      options: ['top', 'right', 'bottom', 'left'],
-    },
-    variant: {
-      control: 'inline-radio',
-      options: ['default', 'light'],
-    },
-    arrow: { control: 'boolean' },
-    title: { control: 'text' },
-  },
-  args: { side: 'top', variant: 'default', arrow: true, title: '设置' },
-  decorators: [
-    (Story) => (
-      <TooltipProvider delayDuration={200}>
-        <div className="flex h-32 items-center justify-center">
-          <Story />
-        </div>
-      </TooltipProvider>
-    ),
-  ],
-};
-
-export default meta;
-type Story = StoryObj<typeof Tooltip>;
-
-export const Playground: Story = {
-  render: (args) => (
-    <Tooltip {...args}>
-      <Button size="icon" variant="ghost" aria-label="设置">
-        <Settings />
-      </Button>
-    </Tooltip>
-  ),
-};
-
-export const Sides: Story = {
-  parameters: { controls: { disable: true } },
-  render: () => (
-    <div className="flex items-center gap-3">
-      {(['top', 'right', 'bottom', 'left'] as const).map((s) => (
-        <Tooltip key={s} title={s} side={s}>
-          <Button variant="outline">{s}</Button>
-        </Tooltip>
-      ))}
-    </div>
-  ),
-};
-
-export const Variants: Story = {
-  name: 'Variants · default vs light',
-  parameters: { controls: { disable: true } },
-  render: () => (
-    <div className="flex items-center gap-6">
-      <Tooltip title="深色 tooltip(default)" variant="default">
-        <Button variant="outline">深色</Button>
-      </Tooltip>
-      <Tooltip title="浅色 tooltip(light) · 带边框与阴影" variant="light">
-        <Button variant="outline">浅色</Button>
-      </Tooltip>
-    </div>
-  ),
-};
-
-export const LightVariant: Story = {
-  name: 'Light variant 富文本',
-  parameters: { controls: { disable: true } },
-  render: () => (
-    <Tooltip
-      variant="light"
-      side="right"
-      title={
-        <span className="inline-flex items-center gap-1.5">
-          <Info className="size-3.5" /> 配额按账号每分钟计算
-        </span>
-      }
-    >
-      <Button variant="outline">规则说明</Button>
-    </Tooltip>
-  ),
-};
-
-export const NoArrow: Story = {
-  parameters: { controls: { disable: true } },
-  render: () => (
-    <Tooltip title="无箭头" arrow={false}>
-      <Button variant="outline">悬浮</Button>
-    </Tooltip>
-  ),
-};

package/src/components/tooltip/tooltip.tsx

@@ -1,153 +0,0 @@
-import * as React from 'react';
-import * as TooltipPrimitive from '@radix-ui/react-tooltip';
-import { cva, type VariantProps } from 'class-variance-authority';
-
-import { cn } from '@/utils/cn';
-
-const TooltipProvider = TooltipPrimitive.Provider;
-const TooltipRoot = TooltipPrimitive.Root;
-const TooltipTrigger = React.forwardRef<
-  React.ElementRef<typeof TooltipPrimitive.Trigger>,
-  React.ComponentPropsWithoutRef<typeof TooltipPrimitive.Trigger>
->(({ className, ...props }, ref) => (
-  <TooltipPrimitive.Trigger
-    ref={ref}
-    className={cn('cursor-pointer', className)}
-    {...props}
-  />
-));
-TooltipTrigger.displayName = TooltipPrimitive.Trigger.displayName;
-
-const tooltipContentVariants = cva(
-  'z-50 overflow-hidden rounded-md px-3 py-1.5 text-xs 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',
-  {
-    variants: {
-      variant: {
-        default: 'bg-primary text-primary-foreground shadow-md',
-        light:
-          'border border-border bg-popover text-popover-foreground shadow-md',
-      },
-    },
-    defaultVariants: {
-      variant: 'default',
-    },
-  },
-);
-
-/** 箭头填充色与变体一一对应。 */
-const arrowFillByVariant: Record<
-  NonNullable<VariantProps<typeof tooltipContentVariants>['variant']>,
-  string
-> = {
-  default: 'fill-primary',
-  light: 'fill-popover',
-};
-
-export interface TooltipContentProps
-  extends React.ComponentPropsWithoutRef<typeof TooltipPrimitive.Content>,
-    VariantProps<typeof tooltipContentVariants> {
-  /**
-   * 是否显示三角形箭头(antd `arrow` 并集)。
-   * @default true
-   */
-  arrow?: boolean;
-}
-
-const TooltipContent = React.forwardRef<
-  React.ElementRef<typeof TooltipPrimitive.Content>,
-  TooltipContentProps
->(
-  (
-    {
-      className,
-      sideOffset = 4,
-      arrow = true,
-      variant = 'default',
-      children,
-      ...props
-    },
-    ref,
-  ) => (
-    <TooltipPrimitive.Portal>
-      <TooltipPrimitive.Content
-        ref={ref}
-        sideOffset={sideOffset}
-        className={cn(tooltipContentVariants({ variant }), className)}
-        {...props}
-      >
-        {children}
-        {arrow ? (
-          <TooltipPrimitive.Arrow
-            className={arrowFillByVariant[variant ?? 'default']}
-            width={8}
-            height={4}
-          />
-        ) : null}
-      </TooltipPrimitive.Content>
-    </TooltipPrimitive.Portal>
-  ),
-);
-TooltipContent.displayName = TooltipPrimitive.Content.displayName;
-
-// ─── Convenience wrapper(antd-style 一行调用)──────────────────────────────
-
-export interface TooltipProps
-  extends Omit<
-    React.ComponentPropsWithoutRef<typeof TooltipPrimitive.Root>,
-    'children'
-  > {
-  /** 触发器(单个 ReactElement,asChild 透传)。 */
-  children: React.ReactElement;
-  /** 提示内容。 */
-  title: React.ReactNode;
-  /** 弹出方向。 @default "top" */
-  side?: 'top' | 'right' | 'bottom' | 'left';
-  /**
-   * 视觉变体:
-   * - `default`:深色背景 + 浅色文字(信息密度高、对比强,适合图标按钮 / 列截断提示)
-   * - `light`:浅色背景 + 深色文字 + 边框 + 阴影(视觉更轻,贴近富内容卡片调性,
-   *   对齐 cloud-design Balloon `type="primary"`)
-   * @default "default"
-   */
-  variant?: 'default' | 'light';
-  /** 是否显示三角形箭头。 @default true */
-  arrow?: boolean;
-  /** 显示延迟(ms),默认沿用 Provider 的 delayDuration。 */
-  delayDuration?: number;
-  /** 强制传给 Provider 的 delayDuration(便于不挂 Provider 的场景)。 */
-  withProvider?: boolean;
-}
-
-const Tooltip: React.FC<TooltipProps> = ({
-  children,
-  title,
-  side = 'top',
-  variant = 'default',
-  arrow = true,
-  delayDuration,
-  withProvider = false,
-  ...rootProps
-}) => {
-  const inner = (
-    <TooltipRoot delayDuration={delayDuration} {...rootProps}>
-      <TooltipTrigger asChild>{children}</TooltipTrigger>
-      <TooltipContent side={side} variant={variant} arrow={arrow}>
-        {title}
-      </TooltipContent>
-    </TooltipRoot>
-  );
-  return withProvider ? (
-    <TooltipProvider delayDuration={delayDuration}>{inner}</TooltipProvider>
-  ) : (
-    inner
-  );
-};
-
-export {
-  Tooltip,
-  TooltipProvider,
-  TooltipRoot,
-  TooltipTrigger,
-  TooltipContent,
-  tooltipContentVariants,
-};