ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/dropdown.json

@@ -0,0 +1,374 @@
+{
+  "entry": {
+    "category": "navigation",
+    "events": [
+      {
+        "description": "下拉菜单显示/隐藏时触发",
+        "name": "visibleChange",
+        "params": "(visible: boolean)"
+      },
+      {
+        "description": "点击主按钮时触发，仅在 split-button 为 true 时生效",
+        "name": "click",
+        "params": "(event: MouseEvent)"
+      },
+      {
+        "description": "点击菜单项时触发，参数为菜单项的 command",
+        "name": "command",
+        "params": "(...args: any[])"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpButton, EpDropdown, EpDropdownItem, EpDropdownMenu } from 'ep-craft'\n</script>\n\n<template>\n  <ep-dropdown>\n    <ep-button>更多操作</ep-button>\n    <template #dropdown>\n      <ep-dropdown-menu>\n        <ep-dropdown-item>编辑</ep-dropdown-item>\n        <ep-dropdown-item divided>删除</ep-dropdown-item>\n      </ep-dropdown-menu>\n    </template>\n  </ep-dropdown>\n</template>",
+        "id": "dropdown-1",
+        "language": "vue",
+        "title": "下拉菜单"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:dropdown",
+    "keywords": {
+      "en": [
+        "dropdown",
+        "menu",
+        "navigation"
+      ],
+      "zh": [
+        "下拉菜单",
+        "导航"
+      ]
+    },
+    "kind": "component",
+    "name": "EpDropdown",
+    "nonUseCases": [
+      "单步无层级的简单跳转时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "hover",
+        "description": "触发方式",
+        "hasDefault": true,
+        "name": "trigger",
+        "required": false,
+        "type": "'hover' | 'click' | 'contextmenu' | Array"
+      },
+      {
+        "alias": null,
+        "defaultText": "['Enter', 'NumpadEnter', 'Space', 'ArrowDown']",
+        "description": "触发下拉的按键",
+        "hasDefault": true,
+        "name": "triggerKeys",
+        "required": false,
+        "type": "string[]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "是否启用虚拟触发",
+        "hasDefault": false,
+        "name": "virtualTriggering",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "虚拟触发时下拉框所依附的元素",
+        "hasDefault": false,
+        "name": "virtualRef",
+        "required": false,
+        "type": "HTMLElement | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": "light",
+        "description": "提示框主题",
+        "hasDefault": true,
+        "name": "effect",
+        "required": false,
+        "type": "'dark' | 'light'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "菜单按钮类型，仅在 split-button 为 true 时生效",
+        "hasDefault": false,
+        "name": "type",
+        "required": false,
+        "type": "'default' | 'primary' | 'success' | 'warning' | 'info' | 'danger' | 'text'"
+      },
+      {
+        "alias": null,
+        "defaultText": "bottom",
+        "description": "弹出菜单位置",
+        "hasDefault": true,
+        "name": "placement",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "{}",
+        "description": "popper.js 配置项",
+        "hasDefault": true,
+        "name": "popperOptions",
+        "required": false,
+        "type": "Partial<Options>"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "下拉框 id",
+        "hasDefault": false,
+        "name": "id",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "菜单尺寸，同时作用于拆分按钮",
+        "hasDefault": true,
+        "name": "size",
+        "required": false,
+        "type": "'large' | 'default' | 'small'"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否显示按钮组",
+        "hasDefault": false,
+        "name": "splitButton",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "点击菜单项后是否隐藏菜单",
+        "hasDefault": true,
+        "name": "hideOnClick",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "键盘导航是否循环",
+        "hasDefault": true,
+        "name": "loop",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否显示箭头",
+        "hasDefault": true,
+        "name": "showArrow",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "150",
+        "description": "显示前延迟，仅在 hover 触发时生效",
+        "hasDefault": true,
+        "name": "showTimeout",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "150",
+        "description": "隐藏前延迟，仅在 hover 触发时生效",
+        "hasDefault": true,
+        "name": "hideTimeout",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "下拉框 tabindex",
+        "hasDefault": true,
+        "name": "tabindex",
+        "required": false,
+        "type": "number | string"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "菜单最大高度",
+        "hasDefault": true,
+        "name": "maxHeight",
+        "required": false,
+        "type": "number | string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "下拉框自定义类名",
+        "hasDefault": false,
+        "name": "popperClass",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "下拉框自定义样式",
+        "hasDefault": true,
+        "name": "popperStyle",
+        "required": false,
+        "type": "string | object | array"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否禁用",
+        "hasDefault": false,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "menu",
+        "description": "下拉菜单的 ARIA role",
+        "hasDefault": true,
+        "name": "role",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "拆分按钮的属性",
+        "hasDefault": false,
+        "name": "buttonProps",
+        "required": false,
+        "type": "Partial<ButtonProps>"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "是否将下拉菜单 teleport 到 body",
+        "hasDefault": true,
+        "name": "teleported",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "下拉菜单内容挂载的容器",
+        "hasDefault": false,
+        "name": "appendTo",
+        "required": false,
+        "type": "string | HTMLElement"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "下拉框未激活且该值为 false 时是否销毁",
+        "hasDefault": true,
+        "name": "persistent",
+        "required": false,
+        "type": "boolean"
+      }
+    ],
+    "related": [
+      "EpDropdownMenu",
+      "EpDropdownItem"
+    ],
+    "relations": {
+      "children": [
+        "EpDropdownMenu",
+        "EpDropdownItem"
+      ],
+      "combos": [
+        "EpDropdown + EpDropdownMenu",
+        "EpDropdown + EpDropdownItem"
+      ],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "触发元素内容",
+        "name": "default"
+      },
+      {
+        "description": "下拉菜单内容，通常放置 ep-dropdown-menu",
+        "name": "dropdown"
+      }
+    ],
+    "slug": "dropdown",
+    "summary": "下拉菜单，页面导航与定位",
+    "tag": "ep-dropdown",
+    "useCases": [
+      "在页面或模块间使用下拉菜单导航",
+      "指示当前位置与层级"
+    ],
+    "variants": [
+      {
+        "dimension": "type",
+        "values": [
+          "default",
+          "primary",
+          "success",
+          "warning",
+          "info",
+          "danger",
+          "text"
+        ],
+        "when": "通过 type 选择菜单按钮类型，仅在 split-button 为 true 时生效"
+      },
+      {
+        "dimension": "size",
+        "values": [
+          "large",
+          "default",
+          "small"
+        ],
+        "when": "按容器空间与信息密度选择尺寸"
+      },
+      {
+        "dimension": "state",
+        "values": [
+          "disabled"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      },
+      {
+        "dimension": "effect",
+        "values": [
+          "dark",
+          "light"
+        ],
+        "when": "通过视觉修饰属性调整外观效果"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-color-primary",
+        "--el-text-color-regular",
+        "--el-bg-color"
+      ],
+      "density": "中等",
+      "shape": "条状或列表",
+      "slotContent": [
+        "default：触发元素内容",
+        "dropdown：下拉菜单内容，通常放置 ep-dropdown-menu"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/dropdown.md

@@ -0,0 +1,108 @@
+# EpDropdown
+
+`ep-dropdown` · navigation（导航） · `component:dropdown`
+
+## 摘要
+
+下拉菜单，页面导航与定位
+
+## 适用场景
+
+- 适用：在页面或模块间使用下拉菜单导航
+- 适用：指示当前位置与层级
+- 不适用：单步无层级的简单跳转时
+
+## 关键词
+
+- 中文：下拉菜单、导航
+- English: dropdown, menu, navigation
+
+## 变体
+
+- type: default/primary/success/warning/info/danger/text（通过 type 选择菜单按钮类型，仅在 split-button 为 true 时生效）
+- size: large/default/small（按容器空间与信息密度选择尺寸）
+- state: disabled（通过布尔属性切换禁用、加载或选中状态）
+- effect: dark/light（通过视觉修饰属性调整外观效果）
+
+## Props
+
+- trigger ('hover' | 'click' | 'contextmenu' | Array，默认 hover)：触发方式
+- triggerKeys (string[]，默认 ['Enter', 'NumpadEnter', 'Space', 'ArrowDown'])：触发下拉的按键
+- virtualTriggering (boolean)：是否启用虚拟触发
+- virtualRef (HTMLElement | Component)：虚拟触发时下拉框所依附的元素
+- effect ('dark' | 'light'，默认 light)：提示框主题
+- type ('default' | 'primary' | 'success' | 'warning' | 'info' | 'danger' | 'text')：菜单按钮类型，仅在 split-button 为 true 时生效
+- placement (string，默认 bottom)：弹出菜单位置
+- popperOptions (Partial<Options>，默认 {})：popper.js 配置项
+- id (string)：下拉框 id
+- size ('large' | 'default' | 'small'，默认 '')：菜单尺寸，同时作用于拆分按钮
+- splitButton (boolean)：是否显示按钮组
+- hideOnClick (boolean，默认 true)：点击菜单项后是否隐藏菜单
+- loop (boolean，默认 true)：键盘导航是否循环
+- showArrow (boolean，默认 true)：是否显示箭头
+- showTimeout (number，默认 150)：显示前延迟，仅在 hover 触发时生效
+- hideTimeout (number，默认 150)：隐藏前延迟，仅在 hover 触发时生效
+- tabindex (number | string，默认 0)：下拉框 tabindex
+- maxHeight (number | string，默认 '')：菜单最大高度
+- popperClass (string)：下拉框自定义类名
+- popperStyle (string | object | array，默认 见文档)：下拉框自定义样式
+- disabled (boolean)：是否禁用
+- role (string，默认 menu)：下拉菜单的 ARIA role
+- buttonProps (Partial<ButtonProps>)：拆分按钮的属性
+- teleported (boolean，默认 见文档)：是否将下拉菜单 teleport 到 body
+- appendTo (string | HTMLElement)：下拉菜单内容挂载的容器
+- persistent (boolean，默认 true)：下拉框未激活且该值为 false 时是否销毁
+
+## Events
+
+- visibleChange((visible: boolean))：下拉菜单显示/隐藏时触发
+- click((event: MouseEvent))：点击主按钮时触发，仅在 split-button 为 true 时生效
+- command((...args: any[]))：点击菜单项时触发，参数为菜单项的 command
+
+## Slots
+
+- default：触发元素内容
+- dropdown：下拉菜单内容，通常放置 ep-dropdown-menu
+
+## 关系
+
+- 子级：EpDropdownMenu、EpDropdownItem
+- 常用组合：EpDropdown + EpDropdownMenu、EpDropdown + EpDropdownItem
+
+## 视觉提示
+
+- 形状：条状或列表
+- 密度：中等
+- 插槽内容：default：触发元素内容；dropdown：下拉菜单内容，通常放置 ep-dropdown-menu
+- CSS 变量：--el-color-primary、--el-text-color-regular、--el-bg-color
+
+## 示例
+
+### 下拉菜单
+
+```vue
+<script setup lang="ts">
+import { EpButton, EpDropdown, EpDropdownItem, EpDropdownMenu } from 'ep-craft'
+</script>
+
+<template>
+  <ep-dropdown>
+    <ep-button>更多操作</ep-button>
+    <template #dropdown>
+      <ep-dropdown-menu>
+        <ep-dropdown-item>编辑</ep-dropdown-item>
+        <ep-dropdown-item divided>删除</ep-dropdown-item>
+      </ep-dropdown-menu>
+    </template>
+  </ep-dropdown>
+</template>
+```
+
+## 相关条目
+
+- EpDropdownMenu
+- EpDropdownItem
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/empty.json

@@ -0,0 +1,116 @@
+{
+  "entry": {
+    "category": "feedback",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpEmpty } from 'ep-craft'\n</script>\n\n<template>\n  <ep-empty description=\"暂无数据\" />\n</template>",
+        "id": "empty-1",
+        "language": "vue",
+        "title": "空状态"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:empty",
+    "keywords": {
+      "en": [
+        "empty",
+        "no-data",
+        "blank",
+        "feedback"
+      ],
+      "zh": [
+        "空状态",
+        "反馈"
+      ]
+    },
+    "kind": "component",
+    "name": "EpEmpty",
+    "nonUseCases": [
+      "无需用户感知状态变化时",
+      "需要完整业务弹窗流程时优先使用 Dialog"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "图片地址",
+        "hasDefault": true,
+        "name": "image",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "图片大小（宽度）",
+        "hasDefault": false,
+        "name": "imageSize",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "描述",
+        "hasDefault": true,
+        "name": "description",
+        "required": false,
+        "type": "string"
+      }
+    ],
+    "related": [
+      "EpTable",
+      "EpResult",
+      "EpSkeleton"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义底部内容",
+        "name": "default"
+      },
+      {
+        "description": "自定义图片",
+        "name": "image"
+      },
+      {
+        "description": "自定义描述文字",
+        "name": "description"
+      }
+    ],
+    "slug": "empty",
+    "summary": "空状态，状态与结果反馈",
+    "tag": "ep-empty",
+    "useCases": [
+      "展示空状态并向用户传达状态",
+      "在操作前后提供即时反馈"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-color-success",
+        "--el-color-warning",
+        "--el-color-danger",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "行内或块级提示",
+      "slotContent": [
+        "default：自定义底部内容",
+        "image：自定义图片",
+        "description：自定义描述文字"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/empty.md

@@ -0,0 +1,62 @@
+# EpEmpty
+
+`ep-empty` · feedback（反馈） · `component:empty`
+
+## 摘要
+
+空状态，状态与结果反馈
+
+## 适用场景
+
+- 适用：展示空状态并向用户传达状态
+- 适用：在操作前后提供即时反馈
+- 不适用：无需用户感知状态变化时
+- 不适用：需要完整业务弹窗流程时优先使用 Dialog
+
+## 关键词
+
+- 中文：空状态、反馈
+- English: empty, no-data, blank, feedback
+
+## Props
+
+- image (string，默认 见文档)：图片地址
+- imageSize (number)：图片大小（宽度）
+- description (string，默认 见文档)：描述
+
+## Slots
+
+- default：自定义底部内容
+- image：自定义图片
+- description：自定义描述文字
+
+## 视觉提示
+
+- 形状：行内或块级提示
+- 密度：中等
+- 插槽内容：default：自定义底部内容；image：自定义图片；description：自定义描述文字
+- CSS 变量：--el-color-success、--el-color-warning、--el-color-danger、--el-font-size-base
+
+## 示例
+
+### 空状态
+
+```vue
+<script setup lang="ts">
+import { EpEmpty } from 'ep-craft'
+</script>
+
+<template>
+  <ep-empty description="暂无数据" />
+</template>
+```
+
+## 相关条目
+
+- EpTable
+- EpResult
+- EpSkeleton
+
+---
+
+ep-craft 0.2.0