ep-craft 0.1.42 → 0.2.0

package/dist-ai/components/autocomplete.json

@@ -0,0 +1,613 @@
+{
+  "entry": {
+    "category": "form",
+    "events": [
+      {
+        "description": "绑定值变化时触发",
+        "name": "update:modelValue",
+        "params": "(value: string | number)"
+      },
+      {
+        "description": "输入时触发",
+        "name": "input",
+        "params": "(value: string | number)"
+      },
+      {
+        "description": "值变化时触发",
+        "name": "change",
+        "params": "(value: string | number)"
+      },
+      {
+        "description": "聚焦时触发",
+        "name": "focus",
+        "params": "(evt: FocusEvent)"
+      },
+      {
+        "description": "失焦时触发",
+        "name": "blur",
+        "params": "(evt: FocusEvent)"
+      },
+      {
+        "description": "清空时触发",
+        "name": "clear",
+        "params": "—"
+      },
+      {
+        "description": "选中建议项时触发",
+        "name": "select",
+        "params": "(item: Record<string, any>)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpAutocomplete } from 'ep-craft'\n\nconst value = ref('')\nconst options = ['Vue', 'React', 'Svelte', 'Solid']\n\nconst fetchSuggestions = (query: string) =>\n  options.filter((item) => item.toLowerCase().includes(query.toLowerCase())).map((item) => ({ value: item }))\n</script>\n\n<template>\n  <ep-autocomplete\n    v-model=\"value\"\n    :fetch-suggestions=\"fetchSuggestions\"\n    placeholder=\"输入前端框架\"\n  />\n</template>",
+        "id": "autocomplete-1",
+        "language": "vue",
+        "title": "输入建议"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "当前高亮建议项的索引",
+        "name": "highlightedIndex",
+        "type": "Ref<number>"
+      },
+      {
+        "description": "自动补全是否激活",
+        "name": "activated",
+        "type": "Ref<boolean>"
+      },
+      {
+        "description": "远程搜索加载状态",
+        "name": "loading",
+        "type": "Ref<boolean>"
+      },
+      {
+        "description": "内部 ep-input 实例",
+        "name": "inputRef",
+        "type": "Ref<InputInstance | undefined>"
+      }
+    ],
+    "hot": false,
+    "id": "component:autocomplete",
+    "keywords": {
+      "en": [
+        "autocomplete",
+        "suggest",
+        "form"
+      ],
+      "zh": [
+        "自动补全输入框",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpAutocomplete",
+    "nonUseCases": [
+      "仅展示静态文本或只读数据时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "id",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "size",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "disabled",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": "v-model",
+        "defaultText": "''",
+        "description": "绑定值",
+        "hasDefault": true,
+        "name": "modelValue",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "modelModifiers",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "maxlength",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "minlength",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "type",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "resize",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "autosize",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "autocomplete",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "formatter",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "parser",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "placeholder",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "form",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "readonly",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "clearable",
+        "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": "showPassword",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "showWordLimit",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "wordLimitPosition",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "suffixIcon",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "prefixIcon",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "containerRole",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "tabindex",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "validateEvent",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "inputStyle",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "countGraphemes",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "autofocus",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "rows",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "ariaLabel",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "inputmode",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "name",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "floatLabel",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "value",
+        "description": "建议项中用于展示的键名",
+        "hasDefault": true,
+        "name": "valueKey",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "300",
+        "description": "输入防抖延迟，单位 ms",
+        "hasDefault": true,
+        "name": "debounce",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "bottom-start",
+        "description": "弹出菜单位置",
+        "hasDefault": true,
+        "name": "placement",
+        "required": false,
+        "type": "'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "获取建议项的方法，可用 callback 回传数据，也可直接返回数据",
+        "hasDefault": true,
+        "name": "fetchSuggestions",
+        "required": false,
+        "type": "(queryString, cb) => Awaitable<Data[] | void> | Data[]"
+      },
+      {
+        "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": null,
+        "description": "popper.js 配置项",
+        "hasDefault": true,
+        "name": "popperOptions",
+        "required": false,
+        "type": "Partial<Options>"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否显示箭头",
+        "hasDefault": true,
+        "name": "showArrow",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "聚焦时是否显示建议",
+        "hasDefault": true,
+        "name": "triggerOnFocus",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "无匹配项时回车是否触发 select 事件",
+        "hasDefault": false,
+        "name": "selectWhenUnmatched",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "远程搜索时是否隐藏加载图标",
+        "hasDefault": false,
+        "name": "hideLoading",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "是否将下拉菜单 teleport 到 body",
+        "hasDefault": true,
+        "name": "teleported",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "下拉菜单挂载的容器",
+        "hasDefault": false,
+        "name": "appendTo",
+        "required": false,
+        "type": "string | HTMLElement"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "远程搜索时是否默认高亮第一项",
+        "hasDefault": false,
+        "name": "highlightFirstItem",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "下拉菜单宽度是否与输入框一致",
+        "hasDefault": false,
+        "name": "fitInputWidth",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "键盘导航是否从末尾循环到开头",
+        "hasDefault": true,
+        "name": "loopNavigation",
+        "required": false,
+        "type": "boolean"
+      }
+    ],
+    "related": [
+      "EpInput",
+      "EpSelect"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义建议项内容，参数为 `{ item }`",
+        "name": "default"
+      },
+      {
+        "description": "输入框前缀内容",
+        "name": "prefix"
+      },
+      {
+        "description": "输入框后缀内容",
+        "name": "suffix"
+      },
+      {
+        "description": "输入框前置内容",
+        "name": "prepend"
+      },
+      {
+        "description": "输入框后置内容",
+        "name": "append"
+      },
+      {
+        "description": "自定义加载中内容",
+        "name": "loading"
+      },
+      {
+        "description": "下拉菜单头部",
+        "name": "header"
+      },
+      {
+        "description": "下拉菜单底部",
+        "name": "footer"
+      }
+    ],
+    "slug": "autocomplete",
+    "summary": "自动补全输入框，表单数据录入控件",
+    "tag": "ep-autocomplete",
+    "useCases": [
+      "表单中收集或编辑自动补全输入框数据",
+      "与 EpForm、EpFormItem 组合完成校验"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-border-color",
+        "--el-border-radius-base",
+        "--el-color-primary",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "矩形输入框",
+      "slotContent": [
+        "default：自定义建议项内容，参数为 `{ item }`",
+        "prefix：输入框前缀内容",
+        "suffix：输入框后缀内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}