ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/tree-select.md

@@ -0,0 +1,181 @@
+# EpTreeSelect
+
+`ep-tree-select` · data（数据展示） · `component:tree-select`
+
+## 摘要
+
+树形选择，结构化数据展示
+
+## 适用场景
+
+- 适用：展示树形选择类结构化数据
+- 适用：需要浏览、比较或定位数据时
+- 不适用：数据量极小且无需结构化展示时
+
+## 关键词
+
+- 中文：树形选择、数据
+- English: tree-select, tree, select, data
+
+## 变体
+
+- size: large/default/small（按容器空间与信息密度选择尺寸）
+- state: disabled（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- name (unknown)
+- id (unknown)
+- modelValue（别名 v-model） (TreeKey | TreeKey[]，默认 见文档)：绑定值，多选时为数组
+- autocomplete (unknown，默认 见文档)
+- automaticDropdown (unknown)
+- size ('large' | 'default' | 'small')：尺寸
+- effect (unknown，默认 见文档)
+- disabled (boolean，默认 见文档)：是否禁用
+- clearable (boolean)：是否可清空
+- filterable (boolean)：是否可搜索
+- allowCreate (unknown)
+- loading (unknown)
+- popperClass (string，默认 见文档)：下拉框自定义类名
+- popperStyle (unknown)
+- popperOptions (unknown，默认 见文档)
+- remote (unknown)
+- debounce (unknown，默认 见文档)
+- loadingText (unknown)
+- noMatchText (unknown)
+- noDataText (unknown)
+- remoteMethod (unknown)
+- filterMethod (unknown)
+- multiple (boolean)：是否多选
+- multipleLimit (unknown，默认 见文档)
+- placeholder (string)：占位符
+- defaultFirstOption (unknown)
+- reserveKeyword (unknown，默认 见文档)
+- valueKey (string，默认 value)：选项对象中作为 value 的键名
+- collapseTags (boolean)：多选时是否折叠标签
+- collapseTagsTooltip (boolean)：折叠标签悬停时是否展示全部标签
+- tagTooltip (unknown，默认 见文档)
+- maxCollapseTags (unknown，默认 见文档)
+- teleported (boolean，默认 见文档)：是否将下拉框 teleport 到 body
+- persistent (unknown，默认 见文档)
+- clearIcon (unknown，默认 见文档)
+- fitInputWidth (unknown)
+- suffixIcon (unknown，默认 见文档)
+- tagType (unknown，默认 见文档)
+- tagEffect (unknown，默认 见文档)
+- validateEvent (boolean，默认 true)：是否触发表单校验
+- remoteShowSuffix (unknown)
+- showArrow (unknown，默认 见文档)
+- offset (unknown，默认 见文档)
+- placement (unknown，默认 见文档)
+- fallbackPlacements (unknown，默认 见文档)
+- tabindex (unknown，默认 见文档)
+- appendTo (unknown)
+- options (unknown)
+- props ({ children?: string; label?: string; disabled?: string }，默认 { children: 'children', label: 'label', disabled: 'disabled' })：树节点字段映射
+- floatLabel (unknown，默认 见文档)
+- emptyValues (unknown)
+- valueOnClear (unknown，默认 见文档)
+- ariaLabel (unknown)
+- ariaLabelledby (unknown)
+- data (TreeData，默认 [])：树数据
+- emptyText (unknown)
+- renderAfterExpand (boolean，默认 true)：是否在第一次展开时才渲染子节点
+- nodeKey (string)：树节点唯一标识的属性名
+- checkStrictly (boolean)：勾选时是否不关联父子节点
+- defaultExpandAll (boolean)：是否默认展开所有节点
+- expandOnClickNode (boolean，默认 true)：点击节点时是否展开/收起
+- checkOnClickNode (boolean)：点击节点时是否勾选/取消勾选
+- checkOnClickLeaf (boolean，默认 true)：点击叶子节点时是否勾选
+- checkDescendants (boolean)：勾选时是否影响后代节点
+- autoExpandParent (boolean，默认 true)：是否自动展开父节点
+- defaultCheckedKeys (TreeKey[])：默认勾选的节点 key 数组
+- defaultExpandedKeys (TreeKey[])：默认展开的节点 key 数组
+- currentNodeKey (unknown)
+- renderContent (unknown)
+- showCheckbox (boolean)：是否显示复选框
+- draggable (unknown)
+- allowDrag (unknown)
+- allowDrop (unknown)
+- lazy (boolean)：是否懒加载子节点，需配合 load 使用
+- highlightCurrent (boolean)：是否高亮当前选中节点
+- load ((node, resolve, reject) => void)：加载子节点的方法
+- filterNodeMethod ((value, data, node) => boolean)：过滤树节点的函数
+- accordion (unknown)
+- indent (unknown，默认 见文档)
+- icon (unknown)
+- cacheData (TreeData，默认 [])：懒加载节点缓存数据，结构与 data 相同
+
+## Events
+
+- update:modelValue((value: TreeKey | TreeKey[]))：绑定值变化时触发
+- change((value: TreeKey | TreeKey[]))：选中值变化时触发
+- visibleChange((visible: boolean))：下拉框显示/隐藏时触发
+- removeTag((value: TreeKey))：移除标签时触发
+- clear(—)：清空时触发
+- check((data, checkedInfo: CheckedInfo))：勾选节点时触发
+- nodeClick((data, node, nodeInstance, evt: MouseEvent))：点击节点时触发
+
+## Slots
+
+- default：自定义树节点内容，参数为 `{ node, data, store }`
+- empty：无数据时的内容
+- prefix：输入框前缀内容
+
+## Exposes
+
+- focus(() => void)：使输入框聚焦
+- blur(() => void)：使输入框失焦
+- selectedLabel(ComputedRef<string>)：当前选中项的展示文本
+- filter((value: any) => void)：过滤树节点
+- getCheckedNodes((leafOnly?: boolean) => Node[])：获取勾选节点
+- setCheckedNodes((nodes: Node[]) => void)：设置勾选节点
+- getCheckedKeys((leafOnly?: boolean) => TreeKey[])：获取勾选节点的 key
+- setCheckedKeys((keys: TreeKey[]) => void)：设置勾选节点的 key
+- getCurrentKey(() => TreeKey | undefined)：获取当前节点的 key
+- getCurrentNode(() => Node | undefined)：获取当前节点
+- setCurrentKey((key: TreeKey) => void)：设置当前节点的 key
+- setCurrentNode((node: Node) => void)：设置当前节点
+- getNode((data: TreeKey | TreeNodeData) => Node)：根据 key 或 data 获取节点
+- treeRef(TreeInstance | undefined)：内部 ep-tree 实例
+- selectRef(SelectInstance | undefined)：内部 ep-select 实例
+
+## 视觉提示
+
+- 形状：块级数据区域
+- 密度：紧凑
+- 插槽内容：default：自定义树节点内容，参数为 `{ node, data, store }`；empty：无数据时的内容；prefix：输入框前缀内容
+- CSS 变量：--el-border-color-lighter、--el-bg-color、--el-text-color-regular、--el-font-size-base
+
+## 示例
+
+### 树形选择
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { EpTreeSelect } from 'ep-craft'
+
+const value = ref('child-1')
+const data = [
+  {
+    value: 'root',
+    label: '根节点',
+    children: [{ value: 'child-1', label: '子节点一' }],
+  },
+]
+</script>
+
+<template>
+  <ep-tree-select v-model="value" :data="data" placeholder="请选择节点" />
+</template>
+```
+
+## 相关条目
+
+- EpSelect
+- EpTree
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/tree-v2.json

@@ -0,0 +1,395 @@
+{
+  "entry": {
+    "category": "data",
+    "events": [
+      {
+        "description": "点击节点时触发",
+        "name": "nodeClick",
+        "params": "(data: TreeNodeData, node: TreeNode, e: MouseEvent)"
+      },
+      {
+        "description": "拖拽放置后触发",
+        "name": "nodeDrop",
+        "params": "(data: TreeNodeData, node: TreeNode, e: DragEvent)"
+      },
+      {
+        "description": "节点展开时触发",
+        "name": "nodeExpand",
+        "params": "(data: TreeNodeData, node: TreeNode)"
+      },
+      {
+        "description": "节点收起时触发",
+        "name": "nodeCollapse",
+        "params": "(data: TreeNodeData, node: TreeNode)"
+      },
+      {
+        "description": "当前节点变化时触发",
+        "name": "currentChange",
+        "params": "(data: TreeNodeData, node: TreeNode)"
+      },
+      {
+        "description": "勾选节点时触发",
+        "name": "check",
+        "params": "(data: TreeNodeData, checkedInfo: CheckedInfo)"
+      },
+      {
+        "description": "节点勾选状态变化时触发",
+        "name": "checkChange",
+        "params": "(data: TreeNodeData, checked: boolean)"
+      },
+      {
+        "description": "右键节点时触发",
+        "name": "nodeContextmenu",
+        "params": "(evt: Event, data: TreeNodeData, node: TreeNode)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpTreeV2 } from 'ep-craft'\n\nconst data = Array.from({ length: 50 }, (_, index) => ({\n  id: index,\n  label: `节点 ${index + 1}`,\n}))\n</script>\n\n<template>\n  <ep-tree-v2 :data=\"data\" :height=\"240\" />\n</template>",
+        "id": "tree-v2-1",
+        "language": "vue",
+        "title": "虚拟化树"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "过滤节点",
+        "name": "filter",
+        "type": "(value: any) => void"
+      },
+      {
+        "description": "获取勾选节点",
+        "name": "getCheckedNodes",
+        "type": "(leafOnly?: boolean) => TreeNode[]"
+      },
+      {
+        "description": "获取勾选节点的 key",
+        "name": "getCheckedKeys",
+        "type": "(leafOnly?: boolean) => TreeKey[]"
+      },
+      {
+        "description": "设置节点勾选状态",
+        "name": "setChecked",
+        "type": "(key: TreeKey, checked: boolean, deep: boolean) => void"
+      },
+      {
+        "description": "设置勾选节点的 key",
+        "name": "setCheckedKeys",
+        "type": "(keys: TreeKey[]) => void"
+      },
+      {
+        "description": "获取半选节点",
+        "name": "getHalfCheckedNodes",
+        "type": "() => TreeNode[]"
+      },
+      {
+        "description": "获取半选节点的 key",
+        "name": "getHalfCheckedKeys",
+        "type": "() => TreeKey[]"
+      },
+      {
+        "description": "获取当前节点的 key",
+        "name": "getCurrentKey",
+        "type": "() => TreeKey | undefined"
+      },
+      {
+        "description": "获取当前节点",
+        "name": "getCurrentNode",
+        "type": "() => TreeNode | undefined"
+      },
+      {
+        "description": "设置当前节点的 key",
+        "name": "setCurrentKey",
+        "type": "(key: TreeKey) => void"
+      },
+      {
+        "description": "根据 key 获取节点",
+        "name": "getNode",
+        "type": "(key: TreeKey) => TreeNode | undefined"
+      },
+      {
+        "description": "设置树数据",
+        "name": "setData",
+        "type": "(data: TreeData) => void"
+      },
+      {
+        "description": "展开节点",
+        "name": "expandNode",
+        "type": "(node: TreeNode) => void"
+      },
+      {
+        "description": "收起节点",
+        "name": "collapseNode",
+        "type": "(node: TreeNode) => void"
+      },
+      {
+        "description": "设置展开节点的 key",
+        "name": "setExpandedKeys",
+        "type": "(keys: TreeKey[]) => void"
+      },
+      {
+        "description": "切换节点复选框状态",
+        "name": "toggleCheckbox",
+        "type": "(node: TreeNode, checked: boolean) => void"
+      },
+      {
+        "description": "滚动到指定节点",
+        "name": "scrollToNode",
+        "type": "(node: TreeNode, strategy?: string) => void"
+      },
+      {
+        "description": "滚动到指定位置",
+        "name": "scrollTo",
+        "type": "(offset: number) => void"
+      }
+    ],
+    "hot": false,
+    "id": "component:tree-v2",
+    "keywords": {
+      "en": [
+        "tree-v2",
+        "tree",
+        "v2",
+        "virtual",
+        "data"
+      ],
+      "zh": [
+        "虚拟化树形控件",
+        "数据"
+      ]
+    },
+    "kind": "component",
+    "name": "EpTreeV2",
+    "nonUseCases": [
+      "数据量极小且无需结构化展示时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "[]",
+        "description": "展示数据",
+        "hasDefault": true,
+        "name": "data",
+        "required": false,
+        "type": "TreeData"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "内容为空时的文本",
+        "hasDefault": false,
+        "name": "emptyText",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "200",
+        "description": "树的高度，单位 px",
+        "hasDefault": true,
+        "name": "height",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "{ children: 'children', label: 'label', disabled: 'disabled', value: 'id' }",
+        "description": "配置选项",
+        "hasDefault": true,
+        "name": "props",
+        "required": false,
+        "type": "{ children?: string; label?: string; disabled?: string; value?: string }"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否高亮当前选中节点",
+        "hasDefault": false,
+        "name": "highlightCurrent",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否显示复选框",
+        "hasDefault": false,
+        "name": "showCheckbox",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "[]",
+        "description": "默认勾选的节点 key 数组",
+        "hasDefault": true,
+        "name": "defaultCheckedKeys",
+        "required": false,
+        "type": "TreeKey[]"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "勾选时是否不关联父子节点",
+        "hasDefault": false,
+        "name": "checkStrictly",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "[]",
+        "description": "默认展开的节点 key 数组",
+        "hasDefault": true,
+        "name": "defaultExpandedKeys",
+        "required": false,
+        "type": "TreeKey[]"
+      },
+      {
+        "alias": null,
+        "defaultText": "16",
+        "description": "相邻级节点的缩进，单位 px",
+        "hasDefault": true,
+        "name": "indent",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "26",
+        "description": "节点高度，单位 px",
+        "hasDefault": true,
+        "name": "itemSize",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "自定义节点图标",
+        "hasDefault": false,
+        "name": "icon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "点击节点时是否展开/收起",
+        "hasDefault": true,
+        "name": "expandOnClickNode",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "点击节点时是否勾选/取消勾选",
+        "hasDefault": false,
+        "name": "checkOnClickNode",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "点击叶子节点时是否勾选",
+        "hasDefault": true,
+        "name": "checkOnClickLeaf",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "当前选中节点的 key",
+        "hasDefault": false,
+        "name": "currentNodeKey",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否每次只展开一个同级节点",
+        "hasDefault": false,
+        "name": "accordion",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "过滤节点的函数",
+        "hasDefault": false,
+        "name": "filterMethod",
+        "required": false,
+        "type": "FilterMethod"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "性能模式，可提升滚动流畅度但会增加内存占用",
+        "hasDefault": true,
+        "name": "perfMode",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否始终显示滚动条",
+        "hasDefault": false,
+        "name": "scrollbarAlwaysOn",
+        "required": false,
+        "type": "boolean"
+      }
+    ],
+    "related": [
+      "EpTree",
+      "EpTreeSelect"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义节点内容，参数为 `{ node, data }`",
+        "name": "default"
+      },
+      {
+        "description": "内容为空时的内容",
+        "name": "empty"
+      }
+    ],
+    "slug": "tree-v2",
+    "summary": "虚拟化树形控件，结构化数据展示",
+    "tag": "ep-tree-v2",
+    "useCases": [
+      "展示虚拟化树形控件类结构化数据",
+      "需要浏览、比较或定位数据时"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-border-color-lighter",
+        "--el-bg-color",
+        "--el-text-color-regular",
+        "--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/tree-v2.md

@@ -0,0 +1,113 @@
+# EpTreeV2
+
+`ep-tree-v2` · data（数据展示） · `component:tree-v2`
+
+## 摘要
+
+虚拟化树形控件，结构化数据展示
+
+## 适用场景
+
+- 适用：展示虚拟化树形控件类结构化数据
+- 适用：需要浏览、比较或定位数据时
+- 不适用：数据量极小且无需结构化展示时
+
+## 关键词
+
+- 中文：虚拟化树形控件、数据
+- English: tree-v2, tree, v2, virtual, data
+
+## Props
+
+- data (TreeData，默认 [])：展示数据
+- emptyText (string)：内容为空时的文本
+- height (number，默认 200)：树的高度，单位 px
+- props ({ children?: string; label?: string; disabled?: string; value?: string }，默认 { children: 'children', label: 'label', disabled: 'disabled', value: 'id' })：配置选项
+- highlightCurrent (boolean)：是否高亮当前选中节点
+- showCheckbox (boolean)：是否显示复选框
+- defaultCheckedKeys (TreeKey[]，默认 [])：默认勾选的节点 key 数组
+- checkStrictly (boolean)：勾选时是否不关联父子节点
+- defaultExpandedKeys (TreeKey[]，默认 [])：默认展开的节点 key 数组
+- indent (number，默认 16)：相邻级节点的缩进，单位 px
+- itemSize (number，默认 26)：节点高度，单位 px
+- icon (string | Component)：自定义节点图标
+- expandOnClickNode (boolean，默认 true)：点击节点时是否展开/收起
+- checkOnClickNode (boolean)：点击节点时是否勾选/取消勾选
+- checkOnClickLeaf (boolean，默认 true)：点击叶子节点时是否勾选
+- currentNodeKey (string | number)：当前选中节点的 key
+- accordion (boolean)：是否每次只展开一个同级节点
+- filterMethod (FilterMethod)：过滤节点的函数
+- perfMode (boolean，默认 true)：性能模式，可提升滚动流畅度但会增加内存占用
+- scrollbarAlwaysOn (boolean)：是否始终显示滚动条
+
+## Events
+
+- nodeClick((data: TreeNodeData, node: TreeNode, e: MouseEvent))：点击节点时触发
+- nodeDrop((data: TreeNodeData, node: TreeNode, e: DragEvent))：拖拽放置后触发
+- nodeExpand((data: TreeNodeData, node: TreeNode))：节点展开时触发
+- nodeCollapse((data: TreeNodeData, node: TreeNode))：节点收起时触发
+- currentChange((data: TreeNodeData, node: TreeNode))：当前节点变化时触发
+- check((data: TreeNodeData, checkedInfo: CheckedInfo))：勾选节点时触发
+- checkChange((data: TreeNodeData, checked: boolean))：节点勾选状态变化时触发
+- nodeContextmenu((evt: Event, data: TreeNodeData, node: TreeNode))：右键节点时触发
+
+## Slots
+
+- default：自定义节点内容，参数为 `{ node, data }`
+- empty：内容为空时的内容
+
+## Exposes
+
+- filter((value: any) => void)：过滤节点
+- getCheckedNodes((leafOnly?: boolean) => TreeNode[])：获取勾选节点
+- getCheckedKeys((leafOnly?: boolean) => TreeKey[])：获取勾选节点的 key
+- setChecked((key: TreeKey, checked: boolean, deep: boolean) => void)：设置节点勾选状态
+- setCheckedKeys((keys: TreeKey[]) => void)：设置勾选节点的 key
+- getHalfCheckedNodes(() => TreeNode[])：获取半选节点
+- getHalfCheckedKeys(() => TreeKey[])：获取半选节点的 key
+- getCurrentKey(() => TreeKey | undefined)：获取当前节点的 key
+- getCurrentNode(() => TreeNode | undefined)：获取当前节点
+- setCurrentKey((key: TreeKey) => void)：设置当前节点的 key
+- getNode((key: TreeKey) => TreeNode | undefined)：根据 key 获取节点
+- setData((data: TreeData) => void)：设置树数据
+- expandNode((node: TreeNode) => void)：展开节点
+- collapseNode((node: TreeNode) => void)：收起节点
+- setExpandedKeys((keys: TreeKey[]) => void)：设置展开节点的 key
+- toggleCheckbox((node: TreeNode, checked: boolean) => void)：切换节点复选框状态
+- scrollToNode((node: TreeNode, strategy?: string) => void)：滚动到指定节点
+- scrollTo((offset: number) => void)：滚动到指定位置
+
+## 视觉提示
+
+- 形状：块级数据区域
+- 密度：紧凑
+- 插槽内容：default：自定义节点内容，参数为 `{ node, data }`；empty：内容为空时的内容
+- CSS 变量：--el-border-color-lighter、--el-bg-color、--el-text-color-regular、--el-font-size-base
+
+## 示例
+
+### 虚拟化树
+
+```vue
+<script setup lang="ts">
+import { EpTreeV2 } from 'ep-craft'
+
+const data = Array.from({ length: 50 }, (_, index) => ({
+  id: index,
+  label: `节点 ${index + 1}`,
+}))
+</script>
+
+<template>
+  <ep-tree-v2 :data="data" :height="240" />
+</template>
+```
+
+## 相关条目
+
+- EpTree
+- EpTreeSelect
+
+---
+
+ep-craft 0.2.0