ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/mention.md

@@ -0,0 +1,136 @@
+# EpMention
+
+`ep-mention` · form（表单） · `component:mention`
+
+## 摘要
+
+提及，表单数据录入控件
+
+## 适用场景
+
+- 适用：表单中收集或编辑提及数据
+- 适用：与 EpForm、EpFormItem 组合完成校验
+- 不适用：仅展示静态文本或只读数据时
+
+## 关键词
+
+- 中文：提及、表单
+- English: mention, autocomplete, at, form
+
+## 变体
+
+- state: loading（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- options (MentionOption[]，默认 [])：提及选项列表
+- prefix (string | string[]，默认 @)：触发提及的前缀字符，长度必须为 1
+- split (string，默认 见文档)：分隔提及的字符，长度必须为 1
+- filterOption (false | ((pattern, option) => boolean)，默认 内置过滤)：自定义过滤逻辑，传 false 时关闭过滤
+- placement ('bottom' | 'top'，默认 bottom)：下拉面板位置
+- showArrow (boolean)：下拉面板是否显示箭头
+- offset (number，默认 0)：下拉面板偏移量
+- whole (boolean)：退格删除时是否整体删除提及内容
+- checkIsWhole ((pattern: string, prefix: string) => boolean)：退格删除时判断提及是否为整体的函数
+- modelValue（别名 v-model） (string，默认 见文档)：输入值
+- loading (boolean)：下拉面板是否处于加载中
+- popperClass (string)：下拉面板自定义类名
+- popperStyle (string | object | array)：下拉面板自定义样式
+- popperOptions (Partial<Options>，默认 {})：popper.js 配置项
+- props ({ value?: string; label?: string; disabled?: string }，默认 { value: 'value', label: 'label', disabled: 'disabled' })：选项字段映射
+- id (unknown)
+- size (unknown)
+- disabled (unknown，默认 见文档)
+- modelModifiers (unknown，默认 见文档)
+- maxlength (unknown)
+- minlength (unknown)
+- type (unknown，默认 见文档)
+- resize (unknown)
+- autosize (unknown)
+- autocomplete (unknown，默认 见文档)
+- formatter (unknown)
+- parser (unknown)
+- placeholder (unknown)
+- form (unknown)
+- readonly (unknown)
+- clearable (unknown)
+- clearIcon (unknown，默认 见文档)
+- showPassword (unknown)
+- showWordLimit (unknown)
+- wordLimitPosition (unknown，默认 见文档)
+- suffixIcon (unknown)
+- prefixIcon (unknown)
+- containerRole (unknown)
+- tabindex (unknown，默认 见文档)
+- validateEvent (unknown，默认 见文档)
+- inputStyle (unknown，默认 见文档)
+- autofocus (unknown)
+- rows (unknown，默认 见文档)
+- ariaLabel (unknown)
+- inputmode (unknown)
+- name (unknown)
+- countGraphemes (unknown)
+- floatLabel (unknown)
+
+## Events
+
+- update:modelValue((value: string))：输入值变化时触发
+- wholeRemove((pattern: string, prefix: string))：整体删除提及内容时触发
+- input((value: string))：输入时触发
+- search((pattern: string, prefix: string))：搜索提及内容时触发
+- select((option: MentionOption, prefix: string))：选中选项时触发
+- focus((evt: FocusEvent))：聚焦时触发
+- blur((evt: FocusEvent))：失焦时触发
+
+## Slots
+
+- default：自定义选项内容，参数为 `{ item, index }`
+- header：下拉面板头部
+- footer：下拉面板底部
+- loading：自定义加载中内容
+- prefix：输入框前缀内容
+- suffix：输入框后缀内容
+- prepend：输入框前置内容
+- append：输入框后置内容
+
+## Exposes
+
+- input(InputInstance | undefined)：内部 ep-input 实例
+- tooltip(TooltipInstance | undefined)：内部 Tooltip 实例
+- dropdownVisible(boolean)：下拉面板是否可见
+
+## 视觉提示
+
+- 形状：矩形输入框
+- 密度：中等
+- 插槽内容：default：自定义选项内容，参数为 `{ item, index }`；header：下拉面板头部；footer：下拉面板底部
+- 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 { EpMention } from 'ep-craft'
+
+const value = ref('')
+const options = [
+  { value: 'zhangsan', label: '张三' },
+  { value: 'lisi', label: '李四' },
+]
+</script>
+
+<template>
+  <ep-mention v-model="value" :options="options" placeholder="输入 @ 提及成员" />
+</template>
+```
+
+## 相关条目
+
+- EpInput
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/menu-item-group.json

@@ -0,0 +1,101 @@
+{
+  "entry": {
+    "category": "navigation",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpMenu, EpMenuItem, EpMenuItemGroup } from 'ep-craft'\n</script>\n\n<template>\n  <ep-menu default-active=\"profile\">\n    <ep-menu-item-group title=\"账号\">\n      <ep-menu-item index=\"profile\">个人资料</ep-menu-item>\n      <ep-menu-item index=\"security\">安全设置</ep-menu-item>\n    </ep-menu-item-group>\n  </ep-menu>\n</template>",
+        "id": "menu-item-group-1",
+        "language": "vue",
+        "title": "菜单分组"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:menu-item-group",
+    "keywords": {
+      "en": [
+        "menu-item-group",
+        "menu",
+        "item",
+        "group",
+        "navigation"
+      ],
+      "zh": [
+        "菜单分组",
+        "导航"
+      ]
+    },
+    "kind": "component",
+    "name": "EpMenuItemGroup",
+    "nonUseCases": [
+      "单步无层级的简单跳转时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "分组标题",
+        "hasDefault": false,
+        "name": "title",
+        "required": false,
+        "type": "string"
+      }
+    ],
+    "related": [
+      "EpMenu",
+      "EpSubMenu",
+      "EpMenuItem"
+    ],
+    "relations": {
+      "children": [
+        "EpMenuItem"
+      ],
+      "combos": [
+        "EpMenu + EpMenuItemGroup",
+        "EpSubMenu + EpMenuItemGroup",
+        "EpMenuItemGroup + EpMenuItem"
+      ],
+      "parents": [
+        "EpMenu",
+        "EpSubMenu"
+      ],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "分组内容",
+        "name": "default"
+      },
+      {
+        "description": "自定义分组标题",
+        "name": "title"
+      }
+    ],
+    "slug": "menu-item-group",
+    "summary": "菜单分组，页面导航与定位",
+    "tag": "ep-menu-item-group",
+    "useCases": [
+      "在页面或模块间使用菜单分组导航",
+      "指示当前位置与层级"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-color-primary",
+        "--el-text-color-regular",
+        "--el-bg-color"
+      ],
+      "density": "中等",
+      "shape": "条状或列表",
+      "slotContent": [
+        "default：分组内容",
+        "title：自定义分组标题"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/menu-item-group.md

@@ -0,0 +1,69 @@
+# EpMenuItemGroup
+
+`ep-menu-item-group` · navigation（导航） · `component:menu-item-group`
+
+## 摘要
+
+菜单分组，页面导航与定位
+
+## 适用场景
+
+- 适用：在页面或模块间使用菜单分组导航
+- 适用：指示当前位置与层级
+- 不适用：单步无层级的简单跳转时
+
+## 关键词
+
+- 中文：菜单分组、导航
+- English: menu-item-group, menu, item, group, navigation
+
+## Props
+
+- title (string)：分组标题
+
+## Slots
+
+- default：分组内容
+- title：自定义分组标题
+
+## 关系
+
+- 父级：EpMenu、EpSubMenu
+- 子级：EpMenuItem
+- 常用组合：EpMenu + EpMenuItemGroup、EpSubMenu + EpMenuItemGroup、EpMenuItemGroup + EpMenuItem
+
+## 视觉提示
+
+- 形状：条状或列表
+- 密度：中等
+- 插槽内容：default：分组内容；title：自定义分组标题
+- CSS 变量：--el-color-primary、--el-text-color-regular、--el-bg-color
+
+## 示例
+
+### 菜单分组
+
+```vue
+<script setup lang="ts">
+import { EpMenu, EpMenuItem, EpMenuItemGroup } from 'ep-craft'
+</script>
+
+<template>
+  <ep-menu default-active="profile">
+    <ep-menu-item-group title="账号">
+      <ep-menu-item index="profile">个人资料</ep-menu-item>
+      <ep-menu-item index="security">安全设置</ep-menu-item>
+    </ep-menu-item-group>
+  </ep-menu>
+</template>
+```
+
+## 相关条目
+
+- EpMenu
+- EpSubMenu
+- EpMenuItem
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/menu-item.json

@@ -0,0 +1,131 @@
+{
+  "entry": {
+    "category": "navigation",
+    "events": [
+      {
+        "description": "点击菜单项时触发",
+        "name": "click",
+        "params": "(item: { index: string; indexPath: string[] })"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpMenu, EpMenuItem } from 'ep-craft'\n</script>\n\n<template>\n  <ep-menu default-active=\"1\">\n    <ep-menu-item index=\"1\">选项一</ep-menu-item>\n    <ep-menu-item index=\"2\" disabled>选项二（禁用）</ep-menu-item>\n  </ep-menu>\n</template>",
+        "id": "menu-item-1",
+        "language": "vue",
+        "title": "菜单项"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:menu-item",
+    "keywords": {
+      "en": [
+        "menu-item",
+        "menu",
+        "item",
+        "navigation"
+      ],
+      "zh": [
+        "菜单项",
+        "导航"
+      ]
+    },
+    "kind": "component",
+    "name": "EpMenuItem",
+    "nonUseCases": [
+      "单步无层级的简单跳转时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "唯一标识（必填）",
+        "hasDefault": false,
+        "name": "index",
+        "required": true,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "Vue Router 路由对象",
+        "hasDefault": false,
+        "name": "route",
+        "required": false,
+        "type": "string | object"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否禁用",
+        "hasDefault": false,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      }
+    ],
+    "related": [
+      "EpMenu",
+      "EpSubMenu",
+      "EpMenuItemGroup"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [
+        "EpMenu + EpMenuItem",
+        "EpSubMenu + EpMenuItem",
+        "EpMenuItemGroup + EpMenuItem"
+      ],
+      "parents": [
+        "EpMenu",
+        "EpSubMenu",
+        "EpMenuItemGroup"
+      ],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "菜单项内容",
+        "name": "default"
+      },
+      {
+        "description": "自定义菜单项标题",
+        "name": "title"
+      }
+    ],
+    "slug": "menu-item",
+    "summary": "菜单项，页面导航与定位",
+    "tag": "ep-menu-item",
+    "useCases": [
+      "在页面或模块间使用菜单项导航",
+      "指示当前位置与层级"
+    ],
+    "variants": [
+      {
+        "dimension": "state",
+        "values": [
+          "disabled"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-color-primary",
+        "--el-text-color-regular",
+        "--el-bg-color"
+      ],
+      "density": "中等",
+      "shape": "条状或列表",
+      "slotContent": [
+        "default：菜单项内容",
+        "title：自定义菜单项标题"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/menu-item.md

@@ -0,0 +1,76 @@
+# EpMenuItem
+
+`ep-menu-item` · navigation（导航） · `component:menu-item`
+
+## 摘要
+
+菜单项，页面导航与定位
+
+## 适用场景
+
+- 适用：在页面或模块间使用菜单项导航
+- 适用：指示当前位置与层级
+- 不适用：单步无层级的简单跳转时
+
+## 关键词
+
+- 中文：菜单项、导航
+- English: menu-item, menu, item, navigation
+
+## 变体
+
+- state: disabled（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- index (string，必填)：唯一标识（必填）
+- route (string | object)：Vue Router 路由对象
+- disabled (boolean)：是否禁用
+
+## Events
+
+- click((item: { index: string; indexPath: string[] }))：点击菜单项时触发
+
+## Slots
+
+- default：菜单项内容
+- title：自定义菜单项标题
+
+## 关系
+
+- 父级：EpMenu、EpSubMenu、EpMenuItemGroup
+- 常用组合：EpMenu + EpMenuItem、EpSubMenu + EpMenuItem、EpMenuItemGroup + EpMenuItem
+
+## 视觉提示
+
+- 形状：条状或列表
+- 密度：中等
+- 插槽内容：default：菜单项内容；title：自定义菜单项标题
+- CSS 变量：--el-color-primary、--el-text-color-regular、--el-bg-color
+
+## 示例
+
+### 菜单项
+
+```vue
+<script setup lang="ts">
+import { EpMenu, EpMenuItem } from 'ep-craft'
+</script>
+
+<template>
+  <ep-menu default-active="1">
+    <ep-menu-item index="1">选项一</ep-menu-item>
+    <ep-menu-item index="2" disabled>选项二（禁用）</ep-menu-item>
+  </ep-menu>
+</template>
+```
+
+## 相关条目
+
+- EpMenu
+- EpSubMenu
+- EpMenuItemGroup
+
+---
+
+ep-craft 0.2.0