ep-craft 0.1.42 → 0.2.0

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

@@ -0,0 +1,729 @@
+{
+  "entry": {
+    "category": "form",
+    "events": [
+      {
+        "description": "绑定值变化时触发",
+        "name": "update:modelValue",
+        "params": "(value: any)"
+      },
+      {
+        "description": "选中值发生变化时触发",
+        "name": "change",
+        "params": "(value: any)"
+      },
+      {
+        "description": "下拉列表滚动到边界时触发（用于远程加载更多）",
+        "name": "endReached",
+        "params": "(direction: 'top' | 'bottom' | 'left' | 'right')"
+      },
+      {
+        "description": "多选模式下移除 tag 时触发",
+        "name": "removeTag",
+        "params": "(tagValue: any)"
+      },
+      {
+        "description": "下拉框出现/隐藏时触发",
+        "name": "visibleChange",
+        "params": "(visible: boolean)"
+      },
+      {
+        "description": "当 input 获得焦点时触发",
+        "name": "focus",
+        "params": "(event: FocusEvent)"
+      },
+      {
+        "description": "当 input 失去焦点时触发",
+        "name": "blur",
+        "params": "(event: FocusEvent)"
+      },
+      {
+        "description": "可清空的单选模式下用户点击清空按钮时触发",
+        "name": "clear",
+        "params": "()"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpSelectV2 } from 'ep-craft'\n\nconst value = ref('')\nconst options = [\n  { label: '选项一', value: 'one' },\n  { label: '选项二', value: 'two' },\n]\n</script>\n\n<template>\n  <ep-select-v2 v-model=\"value\" :options=\"options\" placeholder=\"请选择\" />\n</template>",
+        "id": "select-v2-1",
+        "language": "vue",
+        "title": "基础选择"
+      },
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpSelectV2 } from 'ep-craft'\n\nconst value = ref('')\nconst options = Array.from({ length: 100 }, (_, index) => ({\n  label: `选项 ${index + 1}`,\n  value: index + 1,\n}))\n</script>\n\n<template>\n  <ep-select-v2 v-model=\"value\" :options=\"options\" filterable placeholder=\"搜索选项\" />\n</template>",
+        "id": "select-v2-2",
+        "language": "vue",
+        "title": "可搜索"
+      },
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpSelectV2 } from 'ep-craft'\n\nconst value = ref([])\nconst options = [\n  { label: '选项一', value: 'one' },\n  { label: '选项二', value: 'two' },\n  { label: '选项三', value: 'three' },\n]\n</script>\n\n<template>\n  <ep-select-v2 v-model=\"value\" :options=\"options\" multiple collapse-tags />\n</template>",
+        "id": "select-v2-3",
+        "language": "vue",
+        "title": "多选"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "使选择器的输入框获取焦点",
+        "name": "focus",
+        "type": "() => void"
+      },
+      {
+        "description": "使选择器的输入框失去焦点，并隐藏下拉框",
+        "name": "blur",
+        "type": "() => void"
+      }
+    ],
+    "hot": true,
+    "id": "component:select-v2",
+    "keywords": {
+      "en": [
+        "select-v2",
+        "select",
+        "v2",
+        "virtual-select",
+        "dropdown",
+        "form"
+      ],
+      "zh": [
+        "虚拟化选择器",
+        "下拉",
+        "海量选项",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpSelectV2",
+    "nonUseCases": [
+      "选项较少时使用 Select 更轻量"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否允许用户创建新条目（须配合 filterable）",
+        "hasDefault": false,
+        "name": "allowCreate",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "none",
+        "description": "原生 autocomplete 属性",
+        "hasDefault": true,
+        "name": "autocomplete",
+        "required": false,
+        "type": "'none' | 'both' | 'list' | 'inline'"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "对于不可搜索的选择器，获取焦点后是否自动弹出下拉面板",
+        "hasDefault": false,
+        "name": "automaticDropdown",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否可以清空选项",
+        "hasDefault": false,
+        "name": "clearable",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "CircleClose",
+        "description": "自定义清空图标",
+        "hasDefault": true,
+        "name": "clearIcon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": "light",
+        "description": "tooltip 主题",
+        "hasDefault": true,
+        "name": "effect",
+        "required": false,
+        "type": "'dark' | 'light'"
+      },
+      {
+        "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": "{}",
+        "description": "折叠标签 tooltip 的配置对象",
+        "hasDefault": true,
+        "name": "tagTooltip",
+        "required": false,
+        "type": "TagTooltipProps"
+      },
+      {
+        "alias": null,
+        "defaultText": "1",
+        "description": "多选折叠时最多显示的标签数量（须配合 collapse-tags）",
+        "hasDefault": true,
+        "name": "maxCollapseTags",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "按下回车是否选择第一个匹配项",
+        "hasDefault": false,
+        "name": "defaultFirstOption",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否禁用",
+        "hasDefault": true,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "可变高度选项的估算项高",
+        "hasDefault": true,
+        "name": "estimatedOptionHeight",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否可搜索",
+        "hasDefault": false,
+        "name": "filterable",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "自定义筛选方法（须配合 filterable）",
+        "hasDefault": false,
+        "name": "filterMethod",
+        "required": false,
+        "type": "(query: string) => void"
+      },
+      {
+        "alias": null,
+        "defaultText": "274",
+        "description": "下拉面板高度（按每项约 34px 计算）",
+        "hasDefault": true,
+        "name": "height",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "34",
+        "description": "选项列表单项高度",
+        "hasDefault": true,
+        "name": "itemHeight",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 id 属性",
+        "hasDefault": false,
+        "name": "id",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否正在从远程获取数据",
+        "hasDefault": false,
+        "name": "loading",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "加载中",
+        "description": "远程加载时显示的文字",
+        "hasDefault": false,
+        "name": "loadingText",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": "v-model",
+        "defaultText": null,
+        "description": "绑定值",
+        "hasDefault": true,
+        "name": "modelValue",
+        "required": false,
+        "type": "string | number | boolean | object | any[]"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否多选",
+        "hasDefault": false,
+        "name": "multiple",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "多选时可被选择的最大数目（0 为不限制）",
+        "hasDefault": true,
+        "name": "multipleLimit",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 name 属性",
+        "hasDefault": false,
+        "name": "name",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "无数据",
+        "description": "无选项时显示的文字（也可用 empty 插槽）",
+        "hasDefault": false,
+        "name": "noDataText",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "无匹配数据",
+        "description": "筛选无匹配时显示的文字（也可用 empty 插槽）",
+        "hasDefault": false,
+        "name": "noMatchText",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "远程搜索方法",
+        "hasDefault": false,
+        "name": "remoteMethod",
+        "required": false,
+        "type": "(query: string) => void"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "多选且可搜索时选中后是否保留关键字",
+        "hasDefault": true,
+        "name": "reserveKeyword",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "选项数据数组，字段名（value / label / disabled / options）可通过 props 自定义",
+        "hasDefault": false,
+        "name": "options",
+        "required": true,
+        "type": "Array"
+      },
+      {
+        "alias": null,
+        "defaultText": "请选择",
+        "description": "占位符",
+        "hasDefault": false,
+        "name": "placeholder",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否将下拉列表插入至 body 元素",
+        "hasDefault": true,
+        "name": "teleported",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "下拉菜单关闭后是否销毁",
+        "hasDefault": true,
+        "name": "persistent",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "下拉框的类名",
+        "hasDefault": false,
+        "name": "popperClass",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "下拉框的自定义样式",
+        "hasDefault": true,
+        "name": "popperStyle",
+        "required": false,
+        "type": "string | object"
+      },
+      {
+        "alias": null,
+        "defaultText": "{}",
+        "description": "popper.js 参数",
+        "hasDefault": true,
+        "name": "popperOptions",
+        "required": false,
+        "type": "object"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否为远程搜索",
+        "hasDefault": false,
+        "name": "remote",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "300",
+        "description": "远程搜索去抖延迟（毫秒）",
+        "hasDefault": true,
+        "name": "debounce",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "default",
+        "description": "输入框尺寸",
+        "hasDefault": false,
+        "name": "size",
+        "required": false,
+        "type": "'large' | 'default' | 'small'"
+      },
+      {
+        "alias": null,
+        "defaultText": "{ value: 'value', label: 'label', disabled: 'disabled', options: 'options' }",
+        "description": "配置选项字段映射（value / label / disabled / options 的键名）",
+        "hasDefault": true,
+        "name": "props",
+        "required": false,
+        "type": "object & { value: string; label: string; disabled: string; options: string }"
+      },
+      {
+        "alias": null,
+        "defaultText": "value",
+        "description": "作为 value 唯一标识的键名",
+        "hasDefault": true,
+        "name": "valueKey",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否始终显示下拉滚动条",
+        "hasDefault": false,
+        "name": "scrollbarAlwaysOn",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否触发表单验证",
+        "hasDefault": true,
+        "name": "validateEvent",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "12",
+        "description": "下拉框出现的偏移量",
+        "hasDefault": true,
+        "name": "offset",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "远程搜索时是否显示后缀图标",
+        "hasDefault": false,
+        "name": "remoteShowSuffix",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否显示下拉箭头",
+        "hasDefault": true,
+        "name": "showArrow",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "bottom-start",
+        "description": "下拉框出现的位置",
+        "hasDefault": true,
+        "name": "placement",
+        "required": false,
+        "type": "Placement"
+      },
+      {
+        "alias": null,
+        "defaultText": "['bottom-start', 'top-start', 'right', 'left']",
+        "description": "下拉框可能出现的备用位置列表",
+        "hasDefault": true,
+        "name": "fallbackPlacements",
+        "required": false,
+        "type": "Placement[]"
+      },
+      {
+        "alias": null,
+        "defaultText": "info",
+        "description": "标签类型",
+        "hasDefault": true,
+        "name": "tagType",
+        "required": false,
+        "type": "'success' | 'info' | 'warning' | 'danger'"
+      },
+      {
+        "alias": null,
+        "defaultText": "light",
+        "description": "标签主题",
+        "hasDefault": true,
+        "name": "tagEffect",
+        "required": false,
+        "type": "'dark' | 'light' | 'plain'"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "输入框的 tabindex",
+        "hasDefault": true,
+        "name": "tabindex",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": "body",
+        "description": "下拉列表挂载到哪个元素",
+        "hasDefault": false,
+        "name": "appendTo",
+        "required": false,
+        "type": "string | HTMLElement"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "下拉框宽度是否与输入框一致",
+        "hasDefault": true,
+        "name": "fitInputWidth",
+        "required": false,
+        "type": "boolean | number"
+      },
+      {
+        "alias": null,
+        "defaultText": "ArrowDown",
+        "description": "自定义后缀图标",
+        "hasDefault": true,
+        "name": "suffixIcon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否启用浮动标签（Material 风格），聚焦、展开虚拟化下拉或有值时占位文本上浮；多选折叠为计数标签时仍保持上浮",
+        "hasDefault": true,
+        "name": "floatLabel",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "['', undefined, null]",
+        "description": "视为空值的值列表",
+        "hasDefault": false,
+        "name": "emptyValues",
+        "required": false,
+        "type": "any[]"
+      },
+      {
+        "alias": null,
+        "defaultText": "undefined",
+        "description": "清空时写入的值",
+        "hasDefault": true,
+        "name": "valueOnClear",
+        "required": false,
+        "type": "string | number | boolean | (() => string | number | boolean)"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 aria-label 属性",
+        "hasDefault": false,
+        "name": "ariaLabel",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 aria-labelledby 属性；显式传入时优先于浮动标签自动关联的文本",
+        "hasDefault": false,
+        "name": "ariaLabelledby",
+        "required": false,
+        "type": "string"
+      }
+    ],
+    "related": [
+      "EpOption",
+      "EpOptionGroup"
+    ],
+    "relations": {
+      "children": [
+        "EpOption",
+        "EpOptionGroup"
+      ],
+      "combos": [
+        "EpSelectV2 + EpOption",
+        "EpSelectV2 + EpOptionGroup"
+      ],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "下拉列表内容（选项列表，作用域含 item / index 等）",
+        "name": "default"
+      },
+      {
+        "description": "Select 组件头部内容",
+        "name": "prefix"
+      },
+      {
+        "description": "无选项时的列表",
+        "name": "empty"
+      },
+      {
+        "description": "自定义选中项标签",
+        "name": "label"
+      },
+      {
+        "description": "多选模式下自定义 tag 内容",
+        "name": "tag"
+      },
+      {
+        "description": "下拉列表顶部的内容",
+        "name": "header"
+      },
+      {
+        "description": "下拉列表底部的内容",
+        "name": "footer"
+      },
+      {
+        "description": "自定义加载中内容",
+        "name": "loading"
+      }
+    ],
+    "slug": "select-v2",
+    "summary": "虚拟化选择器，适合海量选项渲染",
+    "tag": "ep-select-v2",
+    "useCases": [
+      "数千条以上选项的下拉选择",
+      "需要保持流畅滚动的筛选器"
+    ],
+    "variants": [
+      {
+        "dimension": "size",
+        "values": [
+          "large",
+          "default",
+          "small"
+        ],
+        "when": "按容器空间与信息密度选择尺寸"
+      },
+      {
+        "dimension": "state",
+        "values": [
+          "disabled",
+          "loading"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      },
+      {
+        "dimension": "effect",
+        "values": [
+          "dark",
+          "light"
+        ],
+        "when": "通过视觉修饰属性调整外观效果"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-border-color",
+        "--el-border-radius-base",
+        "--el-color-primary",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "矩形输入框",
+      "slotContent": [
+        "default：下拉列表内容（选项列表，作用域含 item / index 等）",
+        "prefix：Select 组件头部内容",
+        "empty：无选项时的列表"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}