iter: d07 新增可交互气泡卡片 popover

.ua/index.json

@@ -1,6 +1,6 @@
 {
   "$schema": "ui-arch-registry-index/0.1",
-  "generatedAt": "2026-10-23T08:50:48.366Z",
+  "generatedAt": "2026-10-23T08:51:47.072Z",
   "repoRoot": ".",
   "packages": [
     {
@@ -130,7 +130,7 @@
     {
       "name": "@ui-arch/ui",
       "type": "skin-dom",
-      "description": "DOM 皮肤组件库：button / textField / textarea / checkbox / switch / select / menu / radioGroup / accordion / breadcrumb / card / badge / alert / toast / tooltip / skeleton / spinner / progress / tabs / pagination / modal / form / formItem / dataTable，构建在 @ui-arch/frame 与 @ui-arch/table-core 之上，样式只消费 --ua-* 令牌。",
+      "description": "DOM 皮肤组件库：button / textField / textarea / checkbox / switch / select / menu / radioGroup / accordion / breadcrumb / card / badge / alert / toast / tooltip / popover / skeleton / spinner / progress / tabs / pagination / modal / form / formItem / dataTable，构建在 @ui-arch/frame 与 @ui-arch/table-core 之上，样式只消费 --ua-* 令牌。",
       "tags": [
         "components",
         "dom",
@@ -157,6 +157,7 @@
           "alert(props)：提示条，variant = info | success | warning | danger",
           "toast.info/success/warning/error(message, duration?)：消息提示工厂，右上角堆叠，默认 3s 自动消失，出入场微动画；showToast(props) 为完整入参版本",
           "tooltip(props, trigger)：悬浮提示，包裹触发器，hover / focus 延迟 150ms 出场，移出 / 失焦 / Esc 收起",
+          "popover(props, trigger)：可交互气泡卡片，包裹触发器，默认点击开合 + 点外部 / Esc 收起，content 可放按钮等交互元素",
           "skeleton(props)：骨架屏占位，variant = text | rect | circle，text 支持 rows 多行，扫光微动画",
           "pagination(props)：独立分页器，page 信号双向绑定，页码过多折叠省略号，首末页禁用翻页，键盘可达",
           "spinner(props)：加载指示器，size 控制直径",
@@ -197,7 +198,8 @@
           "FormItemProps",
           "FormItemHandle",
           "FormProps",
-          "DataTableProps"
+          "DataTableProps",
+          "PopoverProps"
         ]
       },
       "usage": "const checked = signal(false); checkbox({ label: '同意', checked }); const open = signal(false); modal({ title: '确认', open }, '内容')",
@@ -207,7 +209,7 @@
         "语义色 variant 四档：default|info / success / warning / danger，一律来自令牌，禁止硬编码颜色"
       ],
       "docs": {
-        "intro": "23 个 DOM 组件，统一用法：组件是普通函数，传入 props 返回 DOM 节点；需要状态时先创建 signal 再双向绑定。引入 CSS：import '@ui-arch/ui/ui.css'（内部已消费 tokens）。",
+        "intro": "24 个 DOM 组件，统一用法：组件是普通函数，传入 props 返回 DOM 节点；需要状态时先创建 signal 再双向绑定。引入 CSS：import '@ui-arch/ui/ui.css'（内部已消费 tokens）。",
         "steps": [
           "安装依赖：pnpm add @ui-arch/ui @ui-arch/frame（workspace 内自动链接）",
           "引入样式：在应用入口 import '@ui-arch/ui/ui.css'，暗色主题在根元素设 data-theme='dark'",
@@ -757,6 +759,62 @@
               "只做展示：不要在气泡里放可点击元素，需要交互请用 modal 或自绘弹层"
             ]
           },
+          {
+            "id": "popover",
+            "title": "气泡卡片 Popover",
+            "demo": "sec-popover",
+            "props": [
+              {
+                "n": "content",
+                "t": "unknown",
+                "r": 1,
+                "d": "弹层内容：字符串 / DOM 节点 / 响应式函数，可放按钮等交互元素"
+              },
+              {
+                "n": "title",
+                "t": "string",
+                "d": "弹层标题；缺省不渲染标题行"
+              },
+              {
+                "n": "placement",
+                "t": "'top' | 'bottom'",
+                "d": "弹层方位；缺省 bottom（触发器下方）",
+                "df": "bottom"
+              },
+              {
+                "n": "trigger",
+                "t": "'click' | 'hover'",
+                "d": "触发方式；缺省 click",
+                "df": "click"
+              },
+              {
+                "n": "delay",
+                "t": "number",
+                "d": "hover 模式出场延迟毫秒；缺省 150",
+                "df": "150"
+              },
+              {
+                "n": "onOpenChange",
+                "t": "(open: boolean) => void",
+                "k": 1,
+                "d": "开合回调"
+              },
+              {
+                "n": "triggerEl（第二个参数）",
+                "t": "HTMLElement",
+                "r": 1,
+                "d": "第二个参数：被包裹的触发器元素"
+              }
+            ],
+            "example": "popover({ title: '筛选条件', content: h('div', null, '任意可交互内容') }, button({ label: '筛选' }))",
+            "steps": [
+              "创建触发器元素，再用 popover(props, trigger) 包一层：返回带弹层的包裹元素",
+              "点击触发器开合；点弹层外部或按 Esc 收起（Esc 后焦点回触发器）",
+              "content 里可以放 button / checkbox 等交互元素（tooltip 只能纯文本），点击弹层内部不会误关",
+              "hover 场景传 trigger: 'hover' + delay 控制多快出场；placement: 'top' 让弹层往上翻",
+              "需要感知开合做副作用（如懒加载数据）时用 onOpenChange"
+            ]
+          },
           {
             "id": "spinner",
             "title": "加载指示器 Spinner",