ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/carousel.json

@@ -0,0 +1,245 @@
+{
+  "entry": {
+    "category": "data",
+    "events": [
+      {
+        "description": "激活幻灯片切换时触发",
+        "name": "change",
+        "params": "(current: number, prev: number)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpCarousel, EpCarouselItem } from 'ep-craft'\n\nconst colors = ['#409eff', '#67c23a', '#e6a23c', '#f56c6c']\n</script>\n\n<template>\n  <ep-carousel height=\"200px\">\n    <ep-carousel-item v-for=\"(color, index) in colors\" :key=\"color\">\n      <div :style=\"{ background: color, height: '200px' }\">第 {{ index + 1 }} 页</div>\n    </ep-carousel-item>\n  </ep-carousel>\n</template>",
+        "id": "carousel-1",
+        "language": "vue",
+        "title": "基础走马灯"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "当前激活幻灯片索引",
+        "name": "activeIndex",
+        "type": "ComputedRef<number>"
+      },
+      {
+        "description": "手动切换幻灯片",
+        "name": "setActiveItem",
+        "type": "(index: number | string) => void"
+      },
+      {
+        "description": "切换至上一张",
+        "name": "prev",
+        "type": "() => void"
+      },
+      {
+        "description": "切换至下一张",
+        "name": "next",
+        "type": "() => void"
+      }
+    ],
+    "hot": false,
+    "id": "component:carousel",
+    "keywords": {
+      "en": [
+        "carousel",
+        "slider",
+        "banner",
+        "data"
+      ],
+      "zh": [
+        "走马灯",
+        "数据"
+      ]
+    },
+    "kind": "component",
+    "name": "EpCarousel",
+    "nonUseCases": [
+      "数据量极小且无需结构化展示时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "初始激活的幻灯片索引，从 0 开始",
+        "hasDefault": true,
+        "name": "initialIndex",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "轮播高度",
+        "hasDefault": true,
+        "name": "height",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "hover",
+        "description": "指示器触发方式",
+        "hasDefault": true,
+        "name": "trigger",
+        "required": false,
+        "type": "'hover' | 'click'"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否自动轮播",
+        "hasDefault": true,
+        "name": "autoplay",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "3000",
+        "description": "自动轮播间隔，单位 ms",
+        "hasDefault": true,
+        "name": "interval",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "指示器位置",
+        "hasDefault": true,
+        "name": "indicatorPosition",
+        "required": false,
+        "type": "'' | 'none' | 'outside'"
+      },
+      {
+        "alias": null,
+        "defaultText": "hover",
+        "description": "箭头显示时机",
+        "hasDefault": true,
+        "name": "arrow",
+        "required": false,
+        "type": "'always' | 'hover' | 'never'"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "轮播类型",
+        "hasDefault": true,
+        "name": "type",
+        "required": false,
+        "type": "'' | 'card'"
+      },
+      {
+        "alias": null,
+        "defaultText": "0.83",
+        "description": "card 类型下非激活卡片的缩放比例",
+        "hasDefault": true,
+        "name": "cardScale",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否循环展示",
+        "hasDefault": true,
+        "name": "loop",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "horizontal",
+        "description": "展示方向",
+        "hasDefault": true,
+        "name": "direction",
+        "required": false,
+        "type": "'horizontal' | 'vertical'"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "悬停时是否暂停自动轮播",
+        "hasDefault": true,
+        "name": "pauseOnHover",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否启用动态模糊",
+        "hasDefault": false,
+        "name": "motionBlur",
+        "required": false,
+        "type": "boolean"
+      }
+    ],
+    "related": [
+      "EpCarouselItem",
+      "EpImage"
+    ],
+    "relations": {
+      "children": [
+        "EpCarouselItem"
+      ],
+      "combos": [
+        "EpCarousel + EpCarouselItem"
+      ],
+      "parents": [],
+      "requiredChildren": [
+        "EpCarouselItem"
+      ]
+    },
+    "slots": [
+      {
+        "description": "轮播内容，通常放置 ep-carousel-item",
+        "name": "default"
+      },
+      {
+        "description": "自定义左侧箭头",
+        "name": "carousel-arrow-left"
+      },
+      {
+        "description": "自定义右侧箭头",
+        "name": "carousel-arrow-right"
+      }
+    ],
+    "slug": "carousel",
+    "summary": "走马灯，结构化数据展示",
+    "tag": "ep-carousel",
+    "useCases": [
+      "展示走马灯类结构化数据",
+      "需要浏览、比较或定位数据时"
+    ],
+    "variants": [
+      {
+        "dimension": "type",
+        "values": [
+          "card"
+        ],
+        "when": "通过 type 选择轮播类型"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-border-color-lighter",
+        "--el-bg-color",
+        "--el-text-color-regular",
+        "--el-font-size-base"
+      ],
+      "density": "紧凑",
+      "shape": "块级数据区域",
+      "slotContent": [
+        "default：轮播内容，通常放置 ep-carousel-item",
+        "carousel-arrow-left：自定义左侧箭头",
+        "carousel-arrow-right：自定义右侧箭头"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/carousel.md

@@ -0,0 +1,97 @@
+# EpCarousel
+
+`ep-carousel` · data（数据展示） · `component:carousel`
+
+## 摘要
+
+走马灯，结构化数据展示
+
+## 适用场景
+
+- 适用：展示走马灯类结构化数据
+- 适用：需要浏览、比较或定位数据时
+- 不适用：数据量极小且无需结构化展示时
+
+## 关键词
+
+- 中文：走马灯、数据
+- English: carousel, slider, banner, data
+
+## 变体
+
+- type: card（通过 type 选择轮播类型）
+
+## Props
+
+- initialIndex (number，默认 0)：初始激活的幻灯片索引，从 0 开始
+- height (string，默认 '')：轮播高度
+- trigger ('hover' | 'click'，默认 hover)：指示器触发方式
+- autoplay (boolean，默认 true)：是否自动轮播
+- interval (number，默认 3000)：自动轮播间隔，单位 ms
+- indicatorPosition ('' | 'none' | 'outside'，默认 '')：指示器位置
+- arrow ('always' | 'hover' | 'never'，默认 hover)：箭头显示时机
+- type ('' | 'card'，默认 '')：轮播类型
+- cardScale (number，默认 0.83)：card 类型下非激活卡片的缩放比例
+- loop (boolean，默认 true)：是否循环展示
+- direction ('horizontal' | 'vertical'，默认 horizontal)：展示方向
+- pauseOnHover (boolean，默认 true)：悬停时是否暂停自动轮播
+- motionBlur (boolean)：是否启用动态模糊
+
+## Events
+
+- change((current: number, prev: number))：激活幻灯片切换时触发
+
+## Slots
+
+- default：轮播内容，通常放置 ep-carousel-item
+- carousel-arrow-left：自定义左侧箭头
+- carousel-arrow-right：自定义右侧箭头
+
+## Exposes
+
+- activeIndex(ComputedRef<number>)：当前激活幻灯片索引
+- setActiveItem((index: number | string) => void)：手动切换幻灯片
+- prev(() => void)：切换至上一张
+- next(() => void)：切换至下一张
+
+## 关系
+
+- 子级：EpCarouselItem
+- 必需子组件：EpCarouselItem
+- 常用组合：EpCarousel + EpCarouselItem
+
+## 视觉提示
+
+- 形状：块级数据区域
+- 密度：紧凑
+- 插槽内容：default：轮播内容，通常放置 ep-carousel-item；carousel-arrow-left：自定义左侧箭头；carousel-arrow-right：自定义右侧箭头
+- CSS 变量：--el-border-color-lighter、--el-bg-color、--el-text-color-regular、--el-font-size-base
+
+## 示例
+
+### 基础走马灯
+
+```vue
+<script setup lang="ts">
+import { EpCarousel, EpCarouselItem } from 'ep-craft'
+
+const colors = ['#409eff', '#67c23a', '#e6a23c', '#f56c6c']
+</script>
+
+<template>
+  <ep-carousel height="200px">
+    <ep-carousel-item v-for="(color, index) in colors" :key="color">
+      <div :style="{ background: color, height: '200px' }">第 {{ index + 1 }} 页</div>
+    </ep-carousel-item>
+  </ep-carousel>
+</template>
+```
+
+## 相关条目
+
+- EpCarouselItem
+- EpImage
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/cascader-panel.json

@@ -0,0 +1,242 @@
+{
+  "entry": {
+    "category": "form",
+    "events": [
+      {
+        "description": "绑定值变化时触发",
+        "name": "update:modelValue",
+        "params": "(value: CascaderValue | null)"
+      },
+      {
+        "description": "选中值变化时触发",
+        "name": "change",
+        "params": "(value: CascaderValue | null)"
+      },
+      {
+        "description": "单选模式下选中叶子节点时触发",
+        "name": "close",
+        "params": "—"
+      },
+      {
+        "description": "展开节点变化时触发",
+        "name": "expandChange",
+        "params": "(value: CascaderNodePathValue)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpCascaderPanel } from 'ep-craft'\n\nconst value = ref([])\nconst options = [\n  {\n    value: 'docs',\n    label: '文档',\n    children: [{ value: 'guide', label: '指南' }],\n  },\n  {\n    value: 'components',\n    label: '组件',\n    children: [{ value: 'button', label: '按钮' }],\n  },\n]\n</script>\n\n<template>\n  <ep-cascader-panel v-model=\"value\" :options=\"options\" />\n</template>",
+        "id": "cascader-panel-1",
+        "language": "vue",
+        "title": "级联面板"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "获取当前选中的节点",
+        "name": "getCheckedNodes",
+        "type": "(leafOnly?: boolean) => CascaderNode[]"
+      },
+      {
+        "description": "清空已勾选节点",
+        "name": "clearCheckedNodes",
+        "type": "() => void"
+      },
+      {
+        "description": "当前勾选节点",
+        "name": "checkedNodes",
+        "type": "CascaderNode[]"
+      },
+      {
+        "description": "菜单元素引用列表",
+        "name": "menuList",
+        "type": "Ref<HTMLElement[] | undefined>"
+      },
+      {
+        "description": "菜单节点列表",
+        "name": "menus",
+        "type": "Ref<CascaderNode[] | undefined>"
+      },
+      {
+        "description": "处理键盘事件",
+        "name": "handleKeyDown",
+        "type": "(e: KeyboardEvent) => void"
+      },
+      {
+        "description": "处理勾选变化",
+        "name": "handleCheckChange",
+        "type": "(node: CascaderNode, checked: boolean, emitClose?: boolean) => void"
+      },
+      {
+        "description": "获取扁平化节点",
+        "name": "getFlattedNodes",
+        "type": "(leafOnly: boolean) => CascaderNode[]"
+      },
+      {
+        "description": "计算勾选值",
+        "name": "calculateCheckedValue",
+        "type": "() => void"
+      },
+      {
+        "description": "滚动到展开中的节点",
+        "name": "scrollToExpandingNode",
+        "type": "(level?: number) => void"
+      },
+      {
+        "description": "加载懒加载根节点",
+        "name": "loadLazyRootNodes",
+        "type": "() => void"
+      }
+    ],
+    "hot": false,
+    "id": "component:cascader-panel",
+    "keywords": {
+      "en": [
+        "cascader-panel",
+        "cascader",
+        "panel",
+        "form"
+      ],
+      "zh": [
+        "级联面板",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpCascaderPanel",
+    "nonUseCases": [
+      "仅展示静态文本或只读数据时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否显示边框",
+        "hasDefault": true,
+        "name": "border",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "自定义节点标签的渲染函数",
+        "hasDefault": false,
+        "name": "renderLabel",
+        "required": false,
+        "type": "RenderLabel"
+      },
+      {
+        "alias": "v-model",
+        "defaultText": null,
+        "description": "绑定值",
+        "hasDefault": false,
+        "name": "modelValue",
+        "required": false,
+        "type": "CascaderValue | null"
+      },
+      {
+        "alias": null,
+        "defaultText": "[]",
+        "description": "选项数据",
+        "hasDefault": true,
+        "name": "options",
+        "required": false,
+        "type": "CascaderOption[]"
+      },
+      {
+        "alias": null,
+        "defaultText": "{}",
+        "description": "配置选项，见 Cascader 的 props 说明",
+        "hasDefault": true,
+        "name": "props",
+        "required": false,
+        "type": "CascaderProps"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否启用虚拟滚动",
+        "hasDefault": false,
+        "name": "virtualScroll",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "34",
+        "description": "虚拟滚动下的节点高度",
+        "hasDefault": true,
+        "name": "itemSize",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "204",
+        "description": "虚拟滚动下的菜单高度",
+        "hasDefault": true,
+        "name": "height",
+        "required": false,
+        "type": "number"
+      }
+    ],
+    "related": [
+      "EpCascader"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [
+        "EpCascader + EpCascaderPanel"
+      ],
+      "parents": [
+        "EpCascader"
+      ],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义节点标签内容，参数为 `{ node, data }`",
+        "name": "default"
+      },
+      {
+        "description": "无数据时的内容",
+        "name": "empty"
+      }
+    ],
+    "slug": "cascader-panel",
+    "summary": "级联面板，表单数据录入控件",
+    "tag": "ep-cascader-panel",
+    "useCases": [
+      "表单中收集或编辑级联面板数据",
+      "与 EpForm、EpFormItem 组合完成校验"
+    ],
+    "variants": [
+      {
+        "dimension": "effect",
+        "values": [
+          "border"
+        ],
+        "when": "通过视觉修饰属性调整外观效果"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-border-color",
+        "--el-border-radius-base",
+        "--el-color-primary",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "矩形输入框",
+      "slotContent": [
+        "default：自定义节点标签内容，参数为 `{ node, data }`",
+        "empty：无数据时的内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/cascader-panel.md

@@ -0,0 +1,108 @@
+# EpCascaderPanel
+
+`ep-cascader-panel` · form（表单） · `component:cascader-panel`
+
+## 摘要
+
+级联面板，表单数据录入控件
+
+## 适用场景
+
+- 适用：表单中收集或编辑级联面板数据
+- 适用：与 EpForm、EpFormItem 组合完成校验
+- 不适用：仅展示静态文本或只读数据时
+
+## 关键词
+
+- 中文：级联面板、表单
+- English: cascader-panel, cascader, panel, form
+
+## 变体
+
+- effect: border（通过视觉修饰属性调整外观效果）
+
+## Props
+
+- border (boolean，默认 true)：是否显示边框
+- renderLabel (RenderLabel)：自定义节点标签的渲染函数
+- modelValue（别名 v-model） (CascaderValue | null)：绑定值
+- options (CascaderOption[]，默认 [])：选项数据
+- props (CascaderProps，默认 {})：配置选项，见 Cascader 的 props 说明
+- virtualScroll (boolean)：是否启用虚拟滚动
+- itemSize (number，默认 34)：虚拟滚动下的节点高度
+- height (number，默认 204)：虚拟滚动下的菜单高度
+
+## Events
+
+- update:modelValue((value: CascaderValue | null))：绑定值变化时触发
+- change((value: CascaderValue | null))：选中值变化时触发
+- close(—)：单选模式下选中叶子节点时触发
+- expandChange((value: CascaderNodePathValue))：展开节点变化时触发
+
+## Slots
+
+- default：自定义节点标签内容，参数为 `{ node, data }`
+- empty：无数据时的内容
+
+## Exposes
+
+- getCheckedNodes((leafOnly?: boolean) => CascaderNode[])：获取当前选中的节点
+- clearCheckedNodes(() => void)：清空已勾选节点
+- checkedNodes(CascaderNode[])：当前勾选节点
+- menuList(Ref<HTMLElement[] | undefined>)：菜单元素引用列表
+- menus(Ref<CascaderNode[] | undefined>)：菜单节点列表
+- handleKeyDown((e: KeyboardEvent) => void)：处理键盘事件
+- handleCheckChange((node: CascaderNode, checked: boolean, emitClose?: boolean) => void)：处理勾选变化
+- getFlattedNodes((leafOnly: boolean) => CascaderNode[])：获取扁平化节点
+- calculateCheckedValue(() => void)：计算勾选值
+- scrollToExpandingNode((level?: number) => void)：滚动到展开中的节点
+- loadLazyRootNodes(() => void)：加载懒加载根节点
+
+## 关系
+
+- 父级：EpCascader
+- 常用组合：EpCascader + EpCascaderPanel
+
+## 视觉提示
+
+- 形状：矩形输入框
+- 密度：中等
+- 插槽内容：default：自定义节点标签内容，参数为 `{ node, data }`；empty：无数据时的内容
+- 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 { EpCascaderPanel } from 'ep-craft'
+
+const value = ref([])
+const options = [
+  {
+    value: 'docs',
+    label: '文档',
+    children: [{ value: 'guide', label: '指南' }],
+  },
+  {
+    value: 'components',
+    label: '组件',
+    children: [{ value: 'button', label: '按钮' }],
+  },
+]
+</script>
+
+<template>
+  <ep-cascader-panel v-model="value" :options="options" />
+</template>
+```
+
+## 相关条目
+
+- EpCascader
+
+---
+
+ep-craft 0.2.0