ep-craft 0.1.42 → 0.2.0

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

@@ -0,0 +1,211 @@
+{
+  "entry": {
+    "category": "navigation",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpMenu, EpMenuItem, EpSubMenu } from 'ep-craft'\n</script>\n\n<template>\n  <ep-menu default-openeds=\"['more']\">\n    <ep-sub-menu index=\"more\">\n      <template #title>更多</template>\n      <ep-menu-item index=\"about\">关于</ep-menu-item>\n      <ep-menu-item index=\"help\">帮助</ep-menu-item>\n    </ep-sub-menu>\n  </ep-menu>\n</template>",
+        "id": "sub-menu-1",
+        "language": "vue",
+        "title": "子菜单"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "子菜单是否展开",
+        "name": "opened",
+        "type": "ComputedRef<boolean>"
+      }
+    ],
+    "hot": false,
+    "id": "component:sub-menu",
+    "keywords": {
+      "en": [
+        "sub-menu",
+        "sub",
+        "menu",
+        "submenu",
+        "navigation"
+      ],
+      "zh": [
+        "子菜单",
+        "导航"
+      ]
+    },
+    "kind": "component",
+    "name": "EpSubMenu",
+    "nonUseCases": [
+      "单步无层级的简单跳转时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "唯一标识（必填）",
+        "hasDefault": false,
+        "name": "index",
+        "required": true,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "显示前的延迟，单位 ms",
+        "hasDefault": false,
+        "name": "showTimeout",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "隐藏前的延迟，单位 ms",
+        "hasDefault": false,
+        "name": "hideTimeout",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "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": "false",
+        "description": "是否禁用",
+        "hasDefault": false,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "弹出菜单是否挂载到 body",
+        "hasDefault": true,
+        "name": "teleported",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "弹出层的偏移量，覆盖 Menu 的同名配置",
+        "hasDefault": false,
+        "name": "popperOffset",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "展开状态且子菜单收起时的图标",
+        "hasDefault": false,
+        "name": "expandCloseIcon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "展开状态且子菜单打开时的图标",
+        "hasDefault": false,
+        "name": "expandOpenIcon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "折叠状态且子菜单收起时的图标",
+        "hasDefault": false,
+        "name": "collapseCloseIcon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "折叠状态且子菜单打开时的图标",
+        "hasDefault": false,
+        "name": "collapseOpenIcon",
+        "required": false,
+        "type": "string | Component"
+      }
+    ],
+    "related": [
+      "EpMenu",
+      "EpMenuItem"
+    ],
+    "relations": {
+      "children": [
+        "EpMenuItem"
+      ],
+      "combos": [
+        "EpMenu + EpSubMenu",
+        "EpSubMenu + EpMenuItem"
+      ],
+      "parents": [
+        "EpMenu"
+      ],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "子菜单内容",
+        "name": "default"
+      },
+      {
+        "description": "子菜单标题",
+        "name": "title"
+      }
+    ],
+    "slug": "sub-menu",
+    "summary": "子菜单，页面导航与定位",
+    "tag": "ep-sub-menu",
+    "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/sub-menu.md

@@ -0,0 +1,88 @@
+# EpSubMenu
+
+`ep-sub-menu` · navigation（导航） · `component:sub-menu`
+
+## 摘要
+
+子菜单，页面导航与定位
+
+## 适用场景
+
+- 适用：在页面或模块间使用子菜单导航
+- 适用：指示当前位置与层级
+- 不适用：单步无层级的简单跳转时
+
+## 关键词
+
+- 中文：子菜单、导航
+- English: sub-menu, sub, menu, submenu, navigation
+
+## 变体
+
+- state: disabled（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- index (string，必填)：唯一标识（必填）
+- showTimeout (number)：显示前的延迟，单位 ms
+- hideTimeout (number)：隐藏前的延迟，单位 ms
+- popperClass (string)：弹出菜单的自定义类名
+- popperStyle (string | CSSProperties)：弹出菜单的自定义样式
+- disabled (boolean)：是否禁用
+- teleported (boolean，默认 见文档)：弹出菜单是否挂载到 body
+- popperOffset (number)：弹出层的偏移量，覆盖 Menu 的同名配置
+- expandCloseIcon (string | Component)：展开状态且子菜单收起时的图标
+- expandOpenIcon (string | Component)：展开状态且子菜单打开时的图标
+- collapseCloseIcon (string | Component)：折叠状态且子菜单收起时的图标
+- collapseOpenIcon (string | Component)：折叠状态且子菜单打开时的图标
+
+## Slots
+
+- default：子菜单内容
+- title：子菜单标题
+
+## Exposes
+
+- opened(ComputedRef<boolean>)：子菜单是否展开
+
+## 关系
+
+- 父级：EpMenu
+- 子级：EpMenuItem
+- 常用组合：EpMenu + EpSubMenu、EpSubMenu + EpMenuItem
+
+## 视觉提示
+
+- 形状：条状或列表
+- 密度：中等
+- 插槽内容：default：子菜单内容；title：子菜单标题
+- 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-openeds="['more']">
+    <ep-sub-menu index="more">
+      <template #title>更多</template>
+      <ep-menu-item index="about">关于</ep-menu-item>
+      <ep-menu-item index="help">帮助</ep-menu-item>
+    </ep-sub-menu>
+  </ep-menu>
+</template>
+```
+
+## 相关条目
+
+- EpMenu
+- EpMenuItem
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/switch.json

@@ -0,0 +1,292 @@
+{
+  "entry": {
+    "category": "form",
+    "events": [
+      {
+        "description": "绑定值变化时触发",
+        "name": "update:modelValue",
+        "params": "(value: boolean | string | number)"
+      },
+      {
+        "description": "switch 状态发生变化时的回调",
+        "name": "change",
+        "params": "(value: boolean | string | number)"
+      },
+      {
+        "description": "绑定值变化时触发（兼容事件名，建议使用 update:model-value）",
+        "name": "input",
+        "params": "(value: boolean | string | number)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpSwitch } from 'ep-craft'\n\nconst value = ref(true)\n</script>\n\n<template>\n  <ep-switch v-model=\"value\" active-text=\"开\" inactive-text=\"关\" />\n</template>",
+        "id": "switch-1",
+        "language": "vue",
+        "title": "开关"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "使 Switch 获取焦点",
+        "name": "focus",
+        "type": "() => void"
+      }
+    ],
+    "hot": false,
+    "id": "component:switch",
+    "keywords": {
+      "en": [
+        "switch",
+        "toggle",
+        "form"
+      ],
+      "zh": [
+        "开关",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpSwitch",
+    "nonUseCases": [
+      "仅展示静态文本或只读数据时"
+    ],
+    "props": [
+      {
+        "alias": "v-model",
+        "defaultText": null,
+        "description": "绑定值",
+        "hasDefault": true,
+        "name": "modelValue",
+        "required": false,
+        "type": "boolean | string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否禁用",
+        "hasDefault": true,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否显示加载中",
+        "hasDefault": false,
+        "name": "loading",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "default",
+        "description": "switch 的大小",
+        "hasDefault": false,
+        "name": "size",
+        "required": false,
+        "type": "'large' | 'default' | 'small'"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "switch 的宽度",
+        "hasDefault": true,
+        "name": "width",
+        "required": false,
+        "type": "number | string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "无论图标或文本是否显示在点内",
+        "hasDefault": false,
+        "name": "inlinePrompt",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "inactiveActionIcon",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "activeActionIcon",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "switch 状态为 on 时所显示图标",
+        "hasDefault": false,
+        "name": "activeIcon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "switch 状态为 off 时所显示图标",
+        "hasDefault": false,
+        "name": "inactiveIcon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "switch 打开时的文字描述",
+        "hasDefault": true,
+        "name": "activeText",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "switch 关闭时的文字描述",
+        "hasDefault": true,
+        "name": "inactiveText",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "switch 状态为 on 时的值",
+        "hasDefault": true,
+        "name": "activeValue",
+        "required": false,
+        "type": "boolean | string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "switch 状态为 off 时的值",
+        "hasDefault": true,
+        "name": "inactiveValue",
+        "required": false,
+        "type": "boolean | string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "原生 name 属性",
+        "hasDefault": true,
+        "name": "name",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "改变 switch 状态时是否触发表单验证",
+        "hasDefault": true,
+        "name": "validateEvent",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "switch 状态改变前的钩子",
+        "hasDefault": false,
+        "name": "beforeChange",
+        "required": false,
+        "type": "() => Promise<boolean> | boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "id",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "tabindex",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "ariaLabel",
+        "required": false,
+        "type": "unknown"
+      }
+    ],
+    "related": [
+      "EpCheckbox"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [],
+    "slug": "switch",
+    "summary": "开关，表单数据录入控件",
+    "tag": "ep-switch",
+    "useCases": [
+      "表单中收集或编辑开关数据",
+      "与 EpForm、EpFormItem 组合完成校验"
+    ],
+    "variants": [
+      {
+        "dimension": "size",
+        "values": [
+          "large",
+          "default",
+          "small"
+        ],
+        "when": "按容器空间与信息密度选择尺寸"
+      },
+      {
+        "dimension": "state",
+        "values": [
+          "disabled",
+          "loading"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-border-color",
+        "--el-border-radius-base",
+        "--el-color-primary",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "矩形输入框",
+      "slotContent": [
+        "active：自定义内容",
+        "active-action：自定义内容",
+        "inactive：自定义内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/switch.md

@@ -0,0 +1,88 @@
+# EpSwitch
+
+`ep-switch` · form（表单） · `component:switch`
+
+## 摘要
+
+开关，表单数据录入控件
+
+## 适用场景
+
+- 适用：表单中收集或编辑开关数据
+- 适用：与 EpForm、EpFormItem 组合完成校验
+- 不适用：仅展示静态文本或只读数据时
+
+## 关键词
+
+- 中文：开关、表单
+- English: switch, toggle, form
+
+## 变体
+
+- size: large/default/small（按容器空间与信息密度选择尺寸）
+- state: disabled/loading（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- modelValue（别名 v-model） (boolean | string | number，默认 见文档)：绑定值
+- disabled (boolean，默认 false)：是否禁用
+- loading (boolean)：是否显示加载中
+- size ('large' | 'default' | 'small')：switch 的大小
+- width (number | string，默认 '')：switch 的宽度
+- inlinePrompt (boolean)：无论图标或文本是否显示在点内
+- inactiveActionIcon (unknown)
+- activeActionIcon (unknown)
+- activeIcon (string | Component)：switch 状态为 on 时所显示图标
+- inactiveIcon (string | Component)：switch 状态为 off 时所显示图标
+- activeText (string，默认 '')：switch 打开时的文字描述
+- inactiveText (string，默认 '')：switch 关闭时的文字描述
+- activeValue (boolean | string | number，默认 true)：switch 状态为 on 时的值
+- inactiveValue (boolean | string | number，默认 false)：switch 状态为 off 时的值
+- name (string，默认 '')：原生 name 属性
+- validateEvent (boolean，默认 true)：改变 switch 状态时是否触发表单验证
+- beforeChange (() => Promise<boolean> | boolean)：switch 状态改变前的钩子
+- id (unknown)
+- tabindex (unknown)
+- ariaLabel (unknown)
+
+## Events
+
+- update:modelValue((value: boolean | string | number))：绑定值变化时触发
+- change((value: boolean | string | number))：switch 状态发生变化时的回调
+- input((value: boolean | string | number))：绑定值变化时触发（兼容事件名，建议使用 update:model-value）
+
+## Exposes
+
+- focus(() => void)：使 Switch 获取焦点
+
+## 视觉提示
+
+- 形状：矩形输入框
+- 密度：中等
+- 插槽内容：active：自定义内容；active-action：自定义内容；inactive：自定义内容
+- 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 { EpSwitch } from 'ep-craft'
+
+const value = ref(true)
+</script>
+
+<template>
+  <ep-switch v-model="value" active-text="开" inactive-text="关" />
+</template>
+```
+
+## 相关条目
+
+- EpCheckbox
+
+---
+
+ep-craft 0.2.0