ep-craft 0.1.42 → 0.2.0

package/dist-ai/components/mention.json

@@ -0,0 +1,598 @@
+{
+  "entry": {
+    "category": "form",
+    "events": [
+      {
+        "description": "输入值变化时触发",
+        "name": "update:modelValue",
+        "params": "(value: string)"
+      },
+      {
+        "description": "整体删除提及内容时触发",
+        "name": "wholeRemove",
+        "params": "(pattern: string, prefix: string)"
+      },
+      {
+        "description": "输入时触发",
+        "name": "input",
+        "params": "(value: string)"
+      },
+      {
+        "description": "搜索提及内容时触发",
+        "name": "search",
+        "params": "(pattern: string, prefix: string)"
+      },
+      {
+        "description": "选中选项时触发",
+        "name": "select",
+        "params": "(option: MentionOption, prefix: string)"
+      },
+      {
+        "description": "聚焦时触发",
+        "name": "focus",
+        "params": "(evt: FocusEvent)"
+      },
+      {
+        "description": "失焦时触发",
+        "name": "blur",
+        "params": "(evt: FocusEvent)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpMention } from 'ep-craft'\n\nconst value = ref('')\nconst options = [\n  { value: 'zhangsan', label: '张三' },\n  { value: 'lisi', label: '李四' },\n]\n</script>\n\n<template>\n  <ep-mention v-model=\"value\" :options=\"options\" placeholder=\"输入 @ 提及成员\" />\n</template>",
+        "id": "mention-1",
+        "language": "vue",
+        "title": "提及输入"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "内部 ep-input 实例",
+        "name": "input",
+        "type": "InputInstance | undefined"
+      },
+      {
+        "description": "内部 Tooltip 实例",
+        "name": "tooltip",
+        "type": "TooltipInstance | undefined"
+      },
+      {
+        "description": "下拉面板是否可见",
+        "name": "dropdownVisible",
+        "type": "boolean"
+      }
+    ],
+    "hot": false,
+    "id": "component:mention",
+    "keywords": {
+      "en": [
+        "mention",
+        "autocomplete",
+        "at",
+        "form"
+      ],
+      "zh": [
+        "提及",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpMention",
+    "nonUseCases": [
+      "仅展示静态文本或只读数据时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "[]",
+        "description": "提及选项列表",
+        "hasDefault": true,
+        "name": "options",
+        "required": false,
+        "type": "MentionOption[]"
+      },
+      {
+        "alias": null,
+        "defaultText": "@",
+        "description": "触发提及的前缀字符，长度必须为 1",
+        "hasDefault": true,
+        "name": "prefix",
+        "required": false,
+        "type": "string | string[]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "分隔提及的字符，长度必须为 1",
+        "hasDefault": true,
+        "name": "split",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "内置过滤",
+        "description": "自定义过滤逻辑，传 false 时关闭过滤",
+        "hasDefault": true,
+        "name": "filterOption",
+        "required": false,
+        "type": "false | ((pattern, option) => boolean)"
+      },
+      {
+        "alias": null,
+        "defaultText": "bottom",
+        "description": "下拉面板位置",
+        "hasDefault": true,
+        "name": "placement",
+        "required": false,
+        "type": "'bottom' | 'top'"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "下拉面板是否显示箭头",
+        "hasDefault": false,
+        "name": "showArrow",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "下拉面板偏移量",
+        "hasDefault": true,
+        "name": "offset",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "退格删除时是否整体删除提及内容",
+        "hasDefault": false,
+        "name": "whole",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "退格删除时判断提及是否为整体的函数",
+        "hasDefault": false,
+        "name": "checkIsWhole",
+        "required": false,
+        "type": "(pattern: string, prefix: string) => boolean"
+      },
+      {
+        "alias": "v-model",
+        "defaultText": null,
+        "description": "输入值",
+        "hasDefault": true,
+        "name": "modelValue",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "下拉面板是否处于加载中",
+        "hasDefault": false,
+        "name": "loading",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "下拉面板自定义类名",
+        "hasDefault": false,
+        "name": "popperClass",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "下拉面板自定义样式",
+        "hasDefault": false,
+        "name": "popperStyle",
+        "required": false,
+        "type": "string | object | array"
+      },
+      {
+        "alias": null,
+        "defaultText": "{}",
+        "description": "popper.js 配置项",
+        "hasDefault": true,
+        "name": "popperOptions",
+        "required": false,
+        "type": "Partial<Options>"
+      },
+      {
+        "alias": null,
+        "defaultText": "{ value: 'value', label: 'label', disabled: 'disabled' }",
+        "description": "选项字段映射",
+        "hasDefault": true,
+        "name": "props",
+        "required": false,
+        "type": "{ value?: string; label?: string; disabled?: string }"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "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": 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": false,
+        "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": false,
+        "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": "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": false,
+        "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": false,
+        "name": "countGraphemes",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "floatLabel",
+        "required": false,
+        "type": "unknown"
+      }
+    ],
+    "related": [
+      "EpInput"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义选项内容，参数为 `{ item, index }`",
+        "name": "default"
+      },
+      {
+        "description": "下拉面板头部",
+        "name": "header"
+      },
+      {
+        "description": "下拉面板底部",
+        "name": "footer"
+      },
+      {
+        "description": "自定义加载中内容",
+        "name": "loading"
+      },
+      {
+        "description": "输入框前缀内容",
+        "name": "prefix"
+      },
+      {
+        "description": "输入框后缀内容",
+        "name": "suffix"
+      },
+      {
+        "description": "输入框前置内容",
+        "name": "prepend"
+      },
+      {
+        "description": "输入框后置内容",
+        "name": "append"
+      }
+    ],
+    "slug": "mention",
+    "summary": "提及，表单数据录入控件",
+    "tag": "ep-mention",
+    "useCases": [
+      "表单中收集或编辑提及数据",
+      "与 EpForm、EpFormItem 组合完成校验"
+    ],
+    "variants": [
+      {
+        "dimension": "state",
+        "values": [
+          "loading"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-border-color",
+        "--el-border-radius-base",
+        "--el-color-primary",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "矩形输入框",
+      "slotContent": [
+        "default：自定义选项内容，参数为 `{ item, index }`",
+        "header：下拉面板头部",
+        "footer：下拉面板底部"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}