ep-craft 0.1.41 → 0.2.0

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

@@ -0,0 +1,945 @@
+{
+  "entry": {
+    "category": "data",
+    "events": [
+      {
+        "description": "绑定值变化时触发",
+        "name": "update:modelValue",
+        "params": "(value: TreeKey | TreeKey[])"
+      },
+      {
+        "description": "选中值变化时触发",
+        "name": "change",
+        "params": "(value: TreeKey | TreeKey[])"
+      },
+      {
+        "description": "下拉框显示/隐藏时触发",
+        "name": "visibleChange",
+        "params": "(visible: boolean)"
+      },
+      {
+        "description": "移除标签时触发",
+        "name": "removeTag",
+        "params": "(value: TreeKey)"
+      },
+      {
+        "description": "清空时触发",
+        "name": "clear",
+        "params": "—"
+      },
+      {
+        "description": "勾选节点时触发",
+        "name": "check",
+        "params": "(data, checkedInfo: CheckedInfo)"
+      },
+      {
+        "description": "点击节点时触发",
+        "name": "nodeClick",
+        "params": "(data, node, nodeInstance, evt: MouseEvent)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpTreeSelect } from 'ep-craft'\n\nconst value = ref('child-1')\nconst data = [\n  {\n    value: 'root',\n    label: '根节点',\n    children: [{ value: 'child-1', label: '子节点一' }],\n  },\n]\n</script>\n\n<template>\n  <ep-tree-select v-model=\"value\" :data=\"data\" placeholder=\"请选择节点\" />\n</template>",
+        "id": "tree-select-1",
+        "language": "vue",
+        "title": "树形选择"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "使输入框聚焦",
+        "name": "focus",
+        "type": "() => void"
+      },
+      {
+        "description": "使输入框失焦",
+        "name": "blur",
+        "type": "() => void"
+      },
+      {
+        "description": "当前选中项的展示文本",
+        "name": "selectedLabel",
+        "type": "ComputedRef<string>"
+      },
+      {
+        "description": "过滤树节点",
+        "name": "filter",
+        "type": "(value: any) => void"
+      },
+      {
+        "description": "获取勾选节点",
+        "name": "getCheckedNodes",
+        "type": "(leafOnly?: boolean) => Node[]"
+      },
+      {
+        "description": "设置勾选节点",
+        "name": "setCheckedNodes",
+        "type": "(nodes: Node[]) => void"
+      },
+      {
+        "description": "获取勾选节点的 key",
+        "name": "getCheckedKeys",
+        "type": "(leafOnly?: boolean) => TreeKey[]"
+      },
+      {
+        "description": "设置勾选节点的 key",
+        "name": "setCheckedKeys",
+        "type": "(keys: TreeKey[]) => void"
+      },
+      {
+        "description": "获取当前节点的 key",
+        "name": "getCurrentKey",
+        "type": "() => TreeKey | undefined"
+      },
+      {
+        "description": "获取当前节点",
+        "name": "getCurrentNode",
+        "type": "() => Node | undefined"
+      },
+      {
+        "description": "设置当前节点的 key",
+        "name": "setCurrentKey",
+        "type": "(key: TreeKey) => void"
+      },
+      {
+        "description": "设置当前节点",
+        "name": "setCurrentNode",
+        "type": "(node: Node) => void"
+      },
+      {
+        "description": "根据 key 或 data 获取节点",
+        "name": "getNode",
+        "type": "(data: TreeKey | TreeNodeData) => Node"
+      },
+      {
+        "description": "内部 ep-tree 实例",
+        "name": "treeRef",
+        "type": "TreeInstance | undefined"
+      },
+      {
+        "description": "内部 ep-select 实例",
+        "name": "selectRef",
+        "type": "SelectInstance | undefined"
+      }
+    ],
+    "hot": false,
+    "id": "component:tree-select",
+    "keywords": {
+      "en": [
+        "tree-select",
+        "tree",
+        "select",
+        "data"
+      ],
+      "zh": [
+        "树形选择",
+        "数据"
+      ]
+    },
+    "kind": "component",
+    "name": "EpTreeSelect",
+    "nonUseCases": [
+      "数据量极小且无需结构化展示时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "name",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "id",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": "v-model",
+        "defaultText": null,
+        "description": "绑定值，多选时为数组",
+        "hasDefault": true,
+        "name": "modelValue",
+        "required": false,
+        "type": "TreeKey | TreeKey[]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "autocomplete",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "automaticDropdown",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "尺寸",
+        "hasDefault": false,
+        "name": "size",
+        "required": false,
+        "type": "'large' | 'default' | 'small'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "effect",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "是否禁用",
+        "hasDefault": true,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否可清空",
+        "hasDefault": false,
+        "name": "clearable",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否可搜索",
+        "hasDefault": false,
+        "name": "filterable",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "allowCreate",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "loading",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "下拉框自定义类名",
+        "hasDefault": true,
+        "name": "popperClass",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "popperStyle",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "popperOptions",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "remote",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "debounce",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "loadingText",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "noMatchText",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "noDataText",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "remoteMethod",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "filterMethod",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否多选",
+        "hasDefault": false,
+        "name": "multiple",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "multipleLimit",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "占位符",
+        "hasDefault": false,
+        "name": "placeholder",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "defaultFirstOption",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "reserveKeyword",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "value",
+        "description": "选项对象中作为 value 的键名",
+        "hasDefault": true,
+        "name": "valueKey",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "多选时是否折叠标签",
+        "hasDefault": false,
+        "name": "collapseTags",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "折叠标签悬停时是否展示全部标签",
+        "hasDefault": false,
+        "name": "collapseTagsTooltip",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "tagTooltip",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "maxCollapseTags",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "是否将下拉框 teleport 到 body",
+        "hasDefault": true,
+        "name": "teleported",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "persistent",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "clearIcon",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "fitInputWidth",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "suffixIcon",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "tagType",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "tagEffect",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否触发表单校验",
+        "hasDefault": true,
+        "name": "validateEvent",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "remoteShowSuffix",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "showArrow",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "offset",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "placement",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "fallbackPlacements",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "tabindex",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "appendTo",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "options",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "{ children: 'children', label: 'label', disabled: 'disabled' }",
+        "description": "树节点字段映射",
+        "hasDefault": true,
+        "name": "props",
+        "required": false,
+        "type": "{ children?: string; label?: string; disabled?: string }"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "floatLabel",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "emptyValues",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "valueOnClear",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "ariaLabel",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "ariaLabelledby",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "[]",
+        "description": "树数据",
+        "hasDefault": true,
+        "name": "data",
+        "required": false,
+        "type": "TreeData"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "emptyText",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否在第一次展开时才渲染子节点",
+        "hasDefault": true,
+        "name": "renderAfterExpand",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "树节点唯一标识的属性名",
+        "hasDefault": false,
+        "name": "nodeKey",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "勾选时是否不关联父子节点",
+        "hasDefault": false,
+        "name": "checkStrictly",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否默认展开所有节点",
+        "hasDefault": false,
+        "name": "defaultExpandAll",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "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": "false",
+        "description": "勾选时是否影响后代节点",
+        "hasDefault": false,
+        "name": "checkDescendants",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否自动展开父节点",
+        "hasDefault": true,
+        "name": "autoExpandParent",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "默认勾选的节点 key 数组",
+        "hasDefault": false,
+        "name": "defaultCheckedKeys",
+        "required": false,
+        "type": "TreeKey[]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "默认展开的节点 key 数组",
+        "hasDefault": false,
+        "name": "defaultExpandedKeys",
+        "required": false,
+        "type": "TreeKey[]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "currentNodeKey",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "renderContent",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否显示复选框",
+        "hasDefault": false,
+        "name": "showCheckbox",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "draggable",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "allowDrag",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "allowDrop",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否懒加载子节点，需配合 load 使用",
+        "hasDefault": false,
+        "name": "lazy",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否高亮当前选中节点",
+        "hasDefault": false,
+        "name": "highlightCurrent",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "加载子节点的方法",
+        "hasDefault": false,
+        "name": "load",
+        "required": false,
+        "type": "(node, resolve, reject) => void"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "过滤树节点的函数",
+        "hasDefault": false,
+        "name": "filterNodeMethod",
+        "required": false,
+        "type": "(value, data, node) => boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "accordion",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "indent",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "icon",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "[]",
+        "description": "懒加载节点缓存数据，结构与 data 相同",
+        "hasDefault": true,
+        "name": "cacheData",
+        "required": false,
+        "type": "TreeData"
+      }
+    ],
+    "related": [
+      "EpSelect",
+      "EpTree"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义树节点内容，参数为 `{ node, data, store }`",
+        "name": "default"
+      },
+      {
+        "description": "无数据时的内容",
+        "name": "empty"
+      },
+      {
+        "description": "输入框前缀内容",
+        "name": "prefix"
+      }
+    ],
+    "slug": "tree-select",
+    "summary": "树形选择，结构化数据展示",
+    "tag": "ep-tree-select",
+    "useCases": [
+      "展示树形选择类结构化数据",
+      "需要浏览、比较或定位数据时"
+    ],
+    "variants": [
+      {
+        "dimension": "size",
+        "values": [
+          "large",
+          "default",
+          "small"
+        ],
+        "when": "按容器空间与信息密度选择尺寸"
+      },
+      {
+        "dimension": "state",
+        "values": [
+          "disabled"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-border-color-lighter",
+        "--el-bg-color",
+        "--el-text-color-regular",
+        "--el-font-size-base"
+      ],
+      "density": "紧凑",
+      "shape": "块级数据区域",
+      "slotContent": [
+        "default：自定义树节点内容，参数为 `{ node, data, store }`",
+        "empty：无数据时的内容",
+        "prefix：输入框前缀内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}