ep-craft 0.1.42 → 0.2.0

package/dist-ai/components/popconfirm.md

@@ -0,0 +1,89 @@
+# EpPopconfirm
+
+`ep-popconfirm` · layout（布局） · `component:popconfirm`
+
+## 摘要
+
+气泡确认框，页面结构与浮层交互
+
+## 适用场景
+
+- 适用：使用气泡确认框组织页面区域与间距
+- 适用：承载内容分组或浮层交互
+- 不适用：已有明确外层布局且无需此语义时
+
+## 关键词
+
+- 中文：气泡确认框、布局
+- English: popconfirm, confirm, layout
+
+## 变体
+
+- effect: dark/light（通过视觉修饰属性调整外观效果）
+
+## Props
+
+- title (string)：标题
+- confirmButtonText (string)：确认按钮文本
+- cancelButtonText (string)：取消按钮文本
+- confirmButtonType ('default' | 'primary' | 'success' | 'warning' | 'info' | 'danger' | 'text'，默认 primary)：确认按钮类型
+- cancelButtonType ('default' | 'primary' | 'success' | 'warning' | 'info' | 'danger' | 'text'，默认 text)：取消按钮类型
+- icon (string | Component，默认 QuestionFilled)：图标组件
+- iconColor (string，默认 #f90)：图标颜色
+- hideIcon (boolean)：是否隐藏图标
+- hideAfter (number，默认 200)：消失延迟，单位 ms
+- effect ('dark' | 'light'，默认 light)：提示框主题
+- teleported (boolean，默认 见文档)：是否 teleport 到 body
+- persistent (boolean)：未激活且该值为 false 时是否销毁
+- width (string | number，默认 150)：宽度，最小 150px
+- virtualTriggering (boolean)：是否启用虚拟触发
+- virtualRef (HTMLElement | Component)：虚拟触发时所依附的元素
+
+## Events
+
+- confirm((e: MouseEvent))：点击确认按钮时触发
+- cancel((e: MouseEvent))：点击取消按钮时触发
+
+## Slots
+
+- default：气泡确认框内容
+- reference：触发元素内容
+- actions：自定义操作区，参数为 `{ confirm, cancel }`
+
+## 视觉提示
+
+- 形状：区块容器
+- 密度：宽松
+- 插槽内容：default：气泡确认框内容；reference：触发元素内容；actions：自定义操作区，参数为 `{ confirm, cancel }`
+- CSS 变量：--el-bg-color、--el-border-color、--el-border-radius-base
+
+## 示例
+
+### 气泡确认
+
+```vue
+<script setup lang="ts">
+import { EpButton, EpPopconfirm } from 'ep-craft'
+
+const remove = () => {
+  // 执行删除逻辑
+}
+</script>
+
+<template>
+  <ep-popconfirm title="确认删除该记录？" @confirm="remove">
+    <template #reference>
+      <ep-button type="danger">删除</ep-button>
+    </template>
+  </ep-popconfirm>
+</template>
+```
+
+## 相关条目
+
+- EpTooltip
+- EpDialog
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/popover.json

@@ -0,0 +1,351 @@
+{
+  "entry": {
+    "category": "layout",
+    "events": [
+      {
+        "description": "Popover 可见性变化时触发",
+        "name": "update:visible",
+        "params": "(visible: boolean)"
+      },
+      {
+        "description": "显示动画播放前触发",
+        "name": "beforeEnter",
+        "params": "()"
+      },
+      {
+        "description": "隐藏动画播放前触发",
+        "name": "beforeLeave",
+        "params": "()"
+      },
+      {
+        "description": "显示动画播放完毕后触发",
+        "name": "afterEnter",
+        "params": "()"
+      },
+      {
+        "description": "隐藏动画播放完毕后触发",
+        "name": "afterLeave",
+        "params": "()"
+      },
+      {
+        "description": "显示时触发",
+        "name": "show",
+        "params": "()"
+      },
+      {
+        "description": "隐藏时触发",
+        "name": "hide",
+        "params": "()"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpButton, EpPopover } from 'ep-craft'\n</script>\n\n<template>\n  <ep-popover title=\"字段说明\" content=\"这里展示更详细的帮助信息\">\n    <template #reference>\n      <ep-button>悬停查看</ep-button>\n    </template>\n  </ep-popover>\n</template>",
+        "id": "popover-1",
+        "language": "vue",
+        "title": "弹出框"
+      }
+    ],
+    "exposes": [],
+    "hot": true,
+    "id": "component:popover",
+    "keywords": {
+      "en": [
+        "popover",
+        "popup",
+        "overlay",
+        "layout"
+      ],
+      "zh": [
+        "弹出框",
+        "气泡卡片",
+        "浮层",
+        "布局"
+      ]
+    },
+    "kind": "component",
+    "name": "EpPopover",
+    "nonUseCases": [
+      "已有明确外层布局且无需此语义时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "hover",
+        "description": "触发方式",
+        "hasDefault": true,
+        "name": "trigger",
+        "required": false,
+        "type": "'click' | 'focus' | 'hover' | 'contextmenu'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "triggerKeys",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "bottom",
+        "description": "出现位置",
+        "hasDefault": true,
+        "name": "placement",
+        "required": false,
+        "type": "Placement"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "Popover 是否可用",
+        "hasDefault": false,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": "v-model:visible",
+        "defaultText": null,
+        "description": "Popover 是否显示",
+        "hasDefault": true,
+        "name": "visible",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "'el-fade-in-linear'",
+        "description": "定义渐变动画",
+        "hasDefault": false,
+        "name": "transition",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "popperOptions",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "tabindex",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "显示的内容",
+        "hasDefault": true,
+        "name": "content",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "为 popper 自定义样式",
+        "hasDefault": true,
+        "name": "popperStyle",
+        "required": false,
+        "type": "string | object"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "为 popper 添加类名",
+        "hasDefault": false,
+        "name": "popperClass",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "enterable",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "light",
+        "description": "Tooltip 主题",
+        "hasDefault": true,
+        "name": "effect",
+        "required": false,
+        "type": "'dark' | 'light'"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否将 popover 的下拉列表插入至 body 元素",
+        "hasDefault": true,
+        "name": "teleported",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "appendTo",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "标题",
+        "hasDefault": false,
+        "name": "title",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "150",
+        "description": "宽度",
+        "hasDefault": true,
+        "name": "width",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "出现位置的偏移量",
+        "hasDefault": true,
+        "name": "offset",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "在触发后多久显示内容",
+        "hasDefault": true,
+        "name": "showAfter",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "200",
+        "description": "延迟关闭",
+        "hasDefault": true,
+        "name": "hideAfter",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "出现后自动隐藏延时",
+        "hasDefault": true,
+        "name": "autoClose",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否显示箭头",
+        "hasDefault": true,
+        "name": "showArrow",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "当 popover 组件长时间不触发且 persistent 为 false 时，popover 将被删除",
+        "hasDefault": true,
+        "name": "persistent",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "onUpdate:visible",
+        "required": false,
+        "type": "unknown"
+      }
+    ],
+    "related": [
+      "EpTooltip",
+      "EpDropdown"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "Popover 内嵌 HTML 文本",
+        "name": "default"
+      },
+      {
+        "description": "触发 Popover 显示的 HTML 元素",
+        "name": "reference"
+      }
+    ],
+    "slug": "popover",
+    "summary": "弹出框，承载可交互的浮层内容",
+    "tag": "ep-popover",
+    "useCases": [
+      "点击或悬停展开操作面板",
+      "展示富文本、表单或链接"
+    ],
+    "variants": [
+      {
+        "dimension": "state",
+        "values": [
+          "disabled"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      },
+      {
+        "dimension": "effect",
+        "values": [
+          "dark",
+          "light"
+        ],
+        "when": "通过视觉修饰属性调整外观效果"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-bg-color",
+        "--el-border-color",
+        "--el-border-radius-base"
+      ],
+      "density": "宽松",
+      "shape": "区块容器",
+      "slotContent": [
+        "default：Popover 内嵌 HTML 文本",
+        "reference：触发 Popover 显示的 HTML 元素"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/popover.md

@@ -0,0 +1,99 @@
+# EpPopover
+
+`ep-popover` · layout（布局） · `component:popover`
+
+## 摘要
+
+弹出框，承载可交互的浮层内容
+
+## 适用场景
+
+- 适用：点击或悬停展开操作面板
+- 适用：展示富文本、表单或链接
+- 不适用：已有明确外层布局且无需此语义时
+
+## 关键词
+
+- 中文：弹出框、气泡卡片、浮层、布局
+- English: popover, popup, overlay, layout
+
+## 变体
+
+- state: disabled（通过布尔属性切换禁用、加载或选中状态）
+- effect: dark/light（通过视觉修饰属性调整外观效果）
+
+## Props
+
+- trigger ('click' | 'focus' | 'hover' | 'contextmenu'，默认 hover)：触发方式
+- triggerKeys (unknown，默认 见文档)
+- placement (Placement，默认 bottom)：出现位置
+- disabled (boolean)：Popover 是否可用
+- visible（别名 v-model:visible） (boolean，默认 见文档)：Popover 是否显示
+- transition (string)：定义渐变动画
+- popperOptions (unknown，默认 见文档)
+- tabindex (unknown，默认 见文档)
+- content (string，默认 见文档)：显示的内容
+- popperStyle (string | object，默认 见文档)：为 popper 自定义样式
+- popperClass (string)：为 popper 添加类名
+- enterable (unknown，默认 见文档)
+- effect ('dark' | 'light'，默认 light)：Tooltip 主题
+- teleported (boolean，默认 true)：是否将 popover 的下拉列表插入至 body 元素
+- appendTo (unknown)
+- title (string)：标题
+- width (string | number，默认 150)：宽度
+- offset (number，默认 0)：出现位置的偏移量
+- showAfter (number，默认 0)：在触发后多久显示内容
+- hideAfter (number，默认 200)：延迟关闭
+- autoClose (number，默认 0)：出现后自动隐藏延时
+- showArrow (boolean，默认 true)：是否显示箭头
+- persistent (boolean，默认 true)：当 popover 组件长时间不触发且 persistent 为 false 时，popover 将被删除
+- onUpdate:visible (unknown)
+
+## Events
+
+- update:visible((visible: boolean))：Popover 可见性变化时触发
+- beforeEnter(())：显示动画播放前触发
+- beforeLeave(())：隐藏动画播放前触发
+- afterEnter(())：显示动画播放完毕后触发
+- afterLeave(())：隐藏动画播放完毕后触发
+- show(())：显示时触发
+- hide(())：隐藏时触发
+
+## Slots
+
+- default：Popover 内嵌 HTML 文本
+- reference：触发 Popover 显示的 HTML 元素
+
+## 视觉提示
+
+- 形状：区块容器
+- 密度：宽松
+- 插槽内容：default：Popover 内嵌 HTML 文本；reference：触发 Popover 显示的 HTML 元素
+- CSS 变量：--el-bg-color、--el-border-color、--el-border-radius-base
+
+## 示例
+
+### 弹出框
+
+```vue
+<script setup lang="ts">
+import { EpButton, EpPopover } from 'ep-craft'
+</script>
+
+<template>
+  <ep-popover title="字段说明" content="这里展示更详细的帮助信息">
+    <template #reference>
+      <ep-button>悬停查看</ep-button>
+    </template>
+  </ep-popover>
+</template>
+```
+
+## 相关条目
+
+- EpTooltip
+- EpDropdown
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/popper.json

@@ -0,0 +1,93 @@
+{
+  "entry": {
+    "category": "layout",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpPopper } from 'ep-craft'\n\nconst reference = ref<HTMLElement>()\n</script>\n\n<template>\n  <button ref=\"reference\" type=\"button\">参考元素</button>\n  <ep-popper :visible=\"true\" :reference-el=\"reference\" placement=\"bottom\">\n    <div style=\"padding: 8px\">基础弹出层内容</div>\n  </ep-popper>\n</template>",
+        "id": "popper-1",
+        "language": "vue",
+        "title": "基础弹出层"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:popper",
+    "keywords": {
+      "en": [
+        "popper",
+        "overlay",
+        "layout"
+      ],
+      "zh": [
+        "弹出层",
+        "布局"
+      ]
+    },
+    "kind": "component",
+    "name": "EpPopper",
+    "nonUseCases": [
+      "已有明确外层布局且无需此语义时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "tooltip",
+        "description": "弹出层容器的 ARIA role",
+        "hasDefault": true,
+        "name": "role",
+        "required": false,
+        "type": "'tooltip' | 'dialog' | 'grid' | 'listbox' | 'menu' | 'tree'"
+      }
+    ],
+    "related": [
+      "EpTooltip",
+      "EpPopover"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "弹出层内容",
+        "name": "default"
+      }
+    ],
+    "slug": "popper",
+    "summary": "弹出层，页面结构与浮层交互",
+    "tag": "ep-popper",
+    "useCases": [
+      "使用弹出层组织页面区域与间距",
+      "承载内容分组或浮层交互"
+    ],
+    "variants": [
+      {
+        "dimension": "effect",
+        "values": [
+          "dark",
+          "light"
+        ],
+        "when": "通过视觉修饰属性调整外观效果"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-bg-color",
+        "--el-border-color",
+        "--el-border-radius-base"
+      ],
+      "density": "宽松",
+      "shape": "区块容器",
+      "slotContent": [
+        "default：弹出层内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/popper.md

@@ -0,0 +1,66 @@
+# EpPopper
+
+`ep-popper` · layout（布局） · `component:popper`
+
+## 摘要
+
+弹出层，页面结构与浮层交互
+
+## 适用场景
+
+- 适用：使用弹出层组织页面区域与间距
+- 适用：承载内容分组或浮层交互
+- 不适用：已有明确外层布局且无需此语义时
+
+## 关键词
+
+- 中文：弹出层、布局
+- English: popper, overlay, layout
+
+## 变体
+
+- effect: dark/light（通过视觉修饰属性调整外观效果）
+
+## Props
+
+- role ('tooltip' | 'dialog' | 'grid' | 'listbox' | 'menu' | 'tree'，默认 tooltip)：弹出层容器的 ARIA role
+
+## Slots
+
+- default：弹出层内容
+
+## 视觉提示
+
+- 形状：区块容器
+- 密度：宽松
+- 插槽内容：default：弹出层内容
+- CSS 变量：--el-bg-color、--el-border-color、--el-border-radius-base
+
+## 示例
+
+### 基础弹出层
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { EpPopper } from 'ep-craft'
+
+const reference = ref<HTMLElement>()
+</script>
+
+<template>
+  <button ref="reference" type="button">参考元素</button>
+  <ep-popper :visible="true" :reference-el="reference" placement="bottom">
+    <div style="padding: 8px">基础弹出层内容</div>
+  </ep-popper>
+</template>
+```
+
+## 相关条目
+
+- EpTooltip
+- EpPopover
+
+---
+
+ep-craft 0.2.0