ep-craft 0.1.42 → 0.2.0

package/dist-ai/components/menu.json

@@ -0,0 +1,314 @@
+{
+  "entry": {
+    "category": "navigation",
+    "events": [
+      {
+        "description": "收起子菜单时触发",
+        "name": "close",
+        "params": "(index: string, indexPath: string[])"
+      },
+      {
+        "description": "展开子菜单时触发",
+        "name": "open",
+        "params": "(index: string, indexPath: string[])"
+      },
+      {
+        "description": "选中菜单项时触发",
+        "name": "select",
+        "params": "(index: string, indexPath: string[], item: MenuItemClicked, routerResult?: Promise<unknown>)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpMenu, EpMenuItem, EpSubMenu } from 'ep-craft'\n</script>\n\n<template>\n  <ep-menu default-active=\"home\" mode=\"horizontal\">\n    <ep-menu-item index=\"home\">首页</ep-menu-item>\n    <ep-sub-menu index=\"components\">\n      <template #title>组件</template>\n      <ep-menu-item index=\"button\">按钮</ep-menu-item>\n      <ep-menu-item index=\"table\">表格</ep-menu-item>\n    </ep-sub-menu>\n  </ep-menu>\n</template>",
+        "id": "menu-1",
+        "language": "vue",
+        "title": "导航菜单"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "展开指定子菜单",
+        "name": "open",
+        "type": "(index: string) => void"
+      },
+      {
+        "description": "收起指定子菜单",
+        "name": "close",
+        "type": "(index: string) => void"
+      },
+      {
+        "description": "更新激活菜单项",
+        "name": "updateActiveIndex",
+        "type": "(index: string) => void"
+      },
+      {
+        "description": "处理尺寸变化",
+        "name": "handleResize",
+        "type": "() => void"
+      }
+    ],
+    "hot": true,
+    "id": "component:menu",
+    "keywords": {
+      "en": [
+        "menu",
+        "nav",
+        "navigation"
+      ],
+      "zh": [
+        "菜单",
+        "导航",
+        "侧边栏"
+      ]
+    },
+    "kind": "component",
+    "name": "EpMenu",
+    "nonUseCases": [
+      "单步无层级的简单跳转时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "vertical",
+        "description": "菜单展示模式",
+        "hasDefault": true,
+        "name": "mode",
+        "required": false,
+        "type": "'horizontal' | 'vertical'"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "页面加载时默认激活的菜单项 index",
+        "hasDefault": true,
+        "name": "defaultActive",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "[]",
+        "description": "默认展开的子菜单 index 数组",
+        "hasDefault": true,
+        "name": "defaultOpeneds",
+        "required": false,
+        "type": "string[]"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否只保持一个子菜单展开",
+        "hasDefault": false,
+        "name": "uniqueOpened",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否启用 vue-router 模式",
+        "hasDefault": false,
+        "name": "router",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "hover",
+        "description": "子菜单触发方式，仅在水平模式下生效",
+        "hasDefault": true,
+        "name": "menuTrigger",
+        "required": false,
+        "type": "'hover' | 'click'"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否水平折叠菜单，仅在垂直模式下生效",
+        "hasDefault": false,
+        "name": "collapse",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "菜单背景色（十六进制）",
+        "hasDefault": false,
+        "name": "backgroundColor",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "菜单文字颜色（十六进制）",
+        "hasDefault": false,
+        "name": "textColor",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "激活菜单项的文字颜色（十六进制）",
+        "hasDefault": false,
+        "name": "activeTextColor",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "点击菜单外部时是否收起菜单",
+        "hasDefault": false,
+        "name": "closeOnClickOutside",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否启用折叠过渡动画",
+        "hasDefault": true,
+        "name": "collapseTransition",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "水平模式下是否启用省略，仅在水平模式下生效",
+        "hasDefault": true,
+        "name": "ellipsis",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "6",
+        "description": "弹出层的偏移量，对所有子菜单生效",
+        "hasDefault": true,
+        "name": "popperOffset",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "More",
+        "description": "自定义省略图标，仅在水平模式且 ellipsis 为 true 时生效",
+        "hasDefault": true,
+        "name": "ellipsisIcon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": "dark",
+        "description": "菜单折叠时的 Tooltip 主题",
+        "hasDefault": true,
+        "name": "popperEffect",
+        "required": false,
+        "type": "'dark' | 'light'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "所有弹出菜单的自定义类名",
+        "hasDefault": false,
+        "name": "popperClass",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "所有弹出菜单的自定义样式",
+        "hasDefault": false,
+        "name": "popperStyle",
+        "required": false,
+        "type": "string | CSSProperties"
+      },
+      {
+        "alias": null,
+        "defaultText": "300",
+        "description": "所有菜单显示前的延迟，单位 ms",
+        "hasDefault": true,
+        "name": "showTimeout",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "300",
+        "description": "所有菜单隐藏前的延迟，单位 ms",
+        "hasDefault": true,
+        "name": "hideTimeout",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "菜单未激活且该值为 false 时，下拉菜单将被销毁",
+        "hasDefault": true,
+        "name": "persistent",
+        "required": false,
+        "type": "boolean"
+      }
+    ],
+    "related": [
+      "EpMenuItem",
+      "EpSubMenu",
+      "EpTabs",
+      "EpMenuItemGroup"
+    ],
+    "relations": {
+      "children": [
+        "EpMenuItem",
+        "EpMenuItemGroup",
+        "EpSubMenu"
+      ],
+      "combos": [
+        "EpMenu + EpMenuItem",
+        "EpMenu + EpMenuItemGroup",
+        "EpMenu + EpSubMenu"
+      ],
+      "parents": [],
+      "requiredChildren": [
+        "EpMenuItem"
+      ]
+    },
+    "slots": [
+      {
+        "description": "菜单内容，通常放置 ep-menu-item / ep-sub-menu",
+        "name": "default"
+      }
+    ],
+    "slug": "menu",
+    "summary": "导航菜单，支持水平与垂直层级结构",
+    "tag": "ep-menu",
+    "useCases": [
+      "应用主导航与侧边导航",
+      "多层级模块入口组织"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-color-primary",
+        "--el-text-color-regular",
+        "--el-bg-color"
+      ],
+      "density": "中等",
+      "shape": "条状或列表",
+      "slotContent": [
+        "default：菜单内容，通常放置 ep-menu-item / ep-sub-menu"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/menu.md

@@ -0,0 +1,104 @@
+# EpMenu
+
+`ep-menu` · navigation（导航） · `component:menu`
+
+## 摘要
+
+导航菜单，支持水平与垂直层级结构
+
+## 适用场景
+
+- 适用：应用主导航与侧边导航
+- 适用：多层级模块入口组织
+- 不适用：单步无层级的简单跳转时
+
+## 关键词
+
+- 中文：菜单、导航、侧边栏
+- English: menu, nav, navigation
+
+## Props
+
+- mode ('horizontal' | 'vertical'，默认 vertical)：菜单展示模式
+- defaultActive (string，默认 '')：页面加载时默认激活的菜单项 index
+- defaultOpeneds (string[]，默认 [])：默认展开的子菜单 index 数组
+- uniqueOpened (boolean)：是否只保持一个子菜单展开
+- router (boolean)：是否启用 vue-router 模式
+- menuTrigger ('hover' | 'click'，默认 hover)：子菜单触发方式，仅在水平模式下生效
+- collapse (boolean)：是否水平折叠菜单，仅在垂直模式下生效
+- backgroundColor (string)：菜单背景色（十六进制）
+- textColor (string)：菜单文字颜色（十六进制）
+- activeTextColor (string)：激活菜单项的文字颜色（十六进制）
+- closeOnClickOutside (boolean)：点击菜单外部时是否收起菜单
+- collapseTransition (boolean，默认 true)：是否启用折叠过渡动画
+- ellipsis (boolean，默认 true)：水平模式下是否启用省略，仅在水平模式下生效
+- popperOffset (number，默认 6)：弹出层的偏移量，对所有子菜单生效
+- ellipsisIcon (string | Component，默认 More)：自定义省略图标，仅在水平模式且 ellipsis 为 true 时生效
+- popperEffect ('dark' | 'light'，默认 dark)：菜单折叠时的 Tooltip 主题
+- popperClass (string)：所有弹出菜单的自定义类名
+- popperStyle (string | CSSProperties)：所有弹出菜单的自定义样式
+- showTimeout (number，默认 300)：所有菜单显示前的延迟，单位 ms
+- hideTimeout (number，默认 300)：所有菜单隐藏前的延迟，单位 ms
+- persistent (boolean，默认 true)：菜单未激活且该值为 false 时，下拉菜单将被销毁
+
+## Events
+
+- close((index: string, indexPath: string[]))：收起子菜单时触发
+- open((index: string, indexPath: string[]))：展开子菜单时触发
+- select((index: string, indexPath: string[], item: MenuItemClicked, routerResult?: Promise<unknown>))：选中菜单项时触发
+
+## Slots
+
+- default：菜单内容，通常放置 ep-menu-item / ep-sub-menu
+
+## Exposes
+
+- open((index: string) => void)：展开指定子菜单
+- close((index: string) => void)：收起指定子菜单
+- updateActiveIndex((index: string) => void)：更新激活菜单项
+- handleResize(() => void)：处理尺寸变化
+
+## 关系
+
+- 子级：EpMenuItem、EpMenuItemGroup、EpSubMenu
+- 必需子组件：EpMenuItem
+- 常用组合：EpMenu + EpMenuItem、EpMenu + EpMenuItemGroup、EpMenu + EpSubMenu
+
+## 视觉提示
+
+- 形状：条状或列表
+- 密度：中等
+- 插槽内容：default：菜单内容，通常放置 ep-menu-item / ep-sub-menu
+- CSS 变量：--el-color-primary、--el-text-color-regular、--el-bg-color
+
+## 示例
+
+### 导航菜单
+
+```vue
+<script setup lang="ts">
+import { EpMenu, EpMenuItem, EpSubMenu } from 'ep-craft'
+</script>
+
+<template>
+  <ep-menu default-active="home" mode="horizontal">
+    <ep-menu-item index="home">首页</ep-menu-item>
+    <ep-sub-menu index="components">
+      <template #title>组件</template>
+      <ep-menu-item index="button">按钮</ep-menu-item>
+      <ep-menu-item index="table">表格</ep-menu-item>
+    </ep-sub-menu>
+  </ep-menu>
+</template>
+```
+
+## 相关条目
+
+- EpMenuItem
+- EpSubMenu
+- EpTabs
+- EpMenuItemGroup
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/option-group.json

@@ -0,0 +1,113 @@
+{
+  "entry": {
+    "category": "form",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpOption, EpOptionGroup, EpSelect } from 'ep-craft'\n\nconst value = ref('')\n</script>\n\n<template>\n  <ep-select v-model=\"value\" placeholder=\"请选择城市\">\n    <ep-option-group label=\"华东\">\n      <ep-option label=\"杭州\" value=\"hangzhou\" />\n      <ep-option label=\"上海\" value=\"shanghai\" />\n    </ep-option-group>\n    <ep-option-group label=\"华南\">\n      <ep-option label=\"广州\" value=\"guangzhou\" />\n    </ep-option-group>\n  </ep-select>\n</template>",
+        "id": "option-group-1",
+        "language": "vue",
+        "title": "选项分组"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:option-group",
+    "keywords": {
+      "en": [
+        "option-group",
+        "option",
+        "group",
+        "form"
+      ],
+      "zh": [
+        "选项组",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpOptionGroup",
+    "nonUseCases": [
+      "仅展示静态文本或只读数据时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "分组的组名",
+        "hasDefault": false,
+        "name": "label",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否将该分组下所有选项置为禁用",
+        "hasDefault": false,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      }
+    ],
+    "related": [
+      "EpSelect",
+      "EpSelectV2",
+      "EpOption"
+    ],
+    "relations": {
+      "children": [
+        "EpOption"
+      ],
+      "combos": [
+        "EpSelect + EpOptionGroup",
+        "EpSelectV2 + EpOptionGroup",
+        "EpOptionGroup + EpOption"
+      ],
+      "parents": [
+        "EpSelect",
+        "EpSelectV2"
+      ],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义默认内容",
+        "name": "default"
+      }
+    ],
+    "slug": "option-group",
+    "summary": "选项组，表单数据录入控件",
+    "tag": "ep-option-group",
+    "useCases": [
+      "表单中收集或编辑选项组数据",
+      "与 EpForm、EpFormItem 组合完成校验"
+    ],
+    "variants": [
+      {
+        "dimension": "state",
+        "values": [
+          "disabled"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-border-color",
+        "--el-border-radius-base",
+        "--el-color-primary",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "矩形输入框",
+      "slotContent": [
+        "default：自定义默认内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/option-group.md

@@ -0,0 +1,79 @@
+# EpOptionGroup
+
+`ep-option-group` · form（表单） · `component:option-group`
+
+## 摘要
+
+选项组，表单数据录入控件
+
+## 适用场景
+
+- 适用：表单中收集或编辑选项组数据
+- 适用：与 EpForm、EpFormItem 组合完成校验
+- 不适用：仅展示静态文本或只读数据时
+
+## 关键词
+
+- 中文：选项组、表单
+- English: option-group, option, group, form
+
+## 变体
+
+- state: disabled（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- label (string)：分组的组名
+- disabled (boolean)：是否将该分组下所有选项置为禁用
+
+## Slots
+
+- default：自定义默认内容
+
+## 关系
+
+- 父级：EpSelect、EpSelectV2
+- 子级：EpOption
+- 常用组合：EpSelect + EpOptionGroup、EpSelectV2 + EpOptionGroup、EpOptionGroup + EpOption
+
+## 视觉提示
+
+- 形状：矩形输入框
+- 密度：中等
+- 插槽内容：default：自定义默认内容
+- CSS 变量：--el-border-color、--el-border-radius-base、--el-color-primary、--el-font-size-base
+
+## 示例
+
+### 选项分组
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { EpOption, EpOptionGroup, EpSelect } from 'ep-craft'
+
+const value = ref('')
+</script>
+
+<template>
+  <ep-select v-model="value" placeholder="请选择城市">
+    <ep-option-group label="华东">
+      <ep-option label="杭州" value="hangzhou" />
+      <ep-option label="上海" value="shanghai" />
+    </ep-option-group>
+    <ep-option-group label="华南">
+      <ep-option label="广州" value="guangzhou" />
+    </ep-option-group>
+  </ep-select>
+</template>
+```
+
+## 相关条目
+
+- EpSelect
+- EpSelectV2
+- EpOption
+
+---
+
+ep-craft 0.2.0