ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/input.json

@@ -0,0 +1,545 @@
+{
+  "entry": {
+    "category": "form",
+    "events": [
+      {
+        "description": "输入值变化时触发",
+        "name": "update:modelValue",
+        "params": "(value: string)"
+      },
+      {
+        "description": "在 Input 值改变时触发",
+        "name": "input",
+        "params": "(value: string | number)"
+      },
+      {
+        "description": "仅当 modelValue 改变时触发",
+        "name": "change",
+        "params": "(value: string | number)"
+      },
+      {
+        "description": "在 Input 获得焦点时触发",
+        "name": "focus",
+        "params": "(event: FocusEvent)"
+      },
+      {
+        "description": "在 Input 失去焦点时触发",
+        "name": "blur",
+        "params": "(event: FocusEvent)"
+      },
+      {
+        "description": "在点击由 clearable 属性生成的清空按钮时触发",
+        "name": "clear",
+        "params": "()"
+      },
+      {
+        "description": "鼠标离开 Input 时触发",
+        "name": "mouseleave",
+        "params": "(event: MouseEvent)"
+      },
+      {
+        "description": "鼠标进入 Input 时触发",
+        "name": "mouseenter",
+        "params": "(event: MouseEvent)"
+      },
+      {
+        "description": "在 Input 上按下按键时触发",
+        "name": "keydown",
+        "params": "(event: KeyboardEvent | Event)"
+      },
+      {
+        "description": "输入法组合输入开始时触发",
+        "name": "compositionstart",
+        "params": "(event: CompositionEvent)"
+      },
+      {
+        "description": "输入法组合输入更新时触发",
+        "name": "compositionupdate",
+        "params": "(event: CompositionEvent)"
+      },
+      {
+        "description": "输入法组合输入结束时触发",
+        "name": "compositionend",
+        "params": "(event: CompositionEvent)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpInput } from 'ep-craft'\n\nconst value = ref('')\n</script>\n\n<template>\n  <ep-input v-model=\"value\" placeholder=\"请输入内容\" />\n</template>",
+        "id": "input-1",
+        "language": "vue",
+        "title": "基础输入框"
+      },
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpInput } from 'ep-craft'\n\nconst keyword = ref('')\nconst password = ref('')\n</script>\n\n<template>\n  <ep-input v-model=\"keyword\" clearable placeholder=\"可清空\" />\n  <ep-input v-model=\"password\" type=\"password\" show-password placeholder=\"密码\" />\n</template>",
+        "id": "input-2",
+        "language": "vue",
+        "title": "可清空与密码框"
+      },
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpIcon, EpInput } from 'ep-craft'\nimport { Search } from 'ep-craft/icons'\n\nconst query = ref('')\n</script>\n\n<template>\n  <ep-input v-model=\"query\" placeholder=\"搜索\">\n    <template #prefix>\n      <ep-icon><Search /></ep-icon>\n    </template>\n  </ep-input>\n</template>",
+        "id": "input-3",
+        "language": "vue",
+        "title": "前缀图标"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "使 input 失去焦点",
+        "name": "blur",
+        "type": "() => void"
+      },
+      {
+        "description": "清除 input 值",
+        "name": "clear",
+        "type": "() => void"
+      },
+      {
+        "description": "使 input 获取焦点",
+        "name": "focus",
+        "type": "() => void"
+      },
+      {
+        "description": "Input HTML 元素",
+        "name": "input",
+        "type": "Ref<HTMLInputElement>"
+      },
+      {
+        "description": "HTML 元素 input 或 textarea",
+        "name": "ref",
+        "type": "Ref<HTMLInputElement | HTMLTextAreaElement>"
+      },
+      {
+        "description": "改变 textarea 大小",
+        "name": "resizeTextarea",
+        "type": "() => void"
+      },
+      {
+        "description": "选中 input 中的文字",
+        "name": "select",
+        "type": "() => void"
+      },
+      {
+        "description": "HTML textarea 元素",
+        "name": "textarea",
+        "type": "Ref<HTMLTextAreaElement>"
+      },
+      {
+        "description": "textarea 的样式",
+        "name": "textareaStyle",
+        "type": "Ref<StyleValue>"
+      }
+    ],
+    "hot": true,
+    "id": "component:input",
+    "keywords": {
+      "en": [
+        "input",
+        "textbox",
+        "field",
+        "form"
+      ],
+      "zh": [
+        "输入框",
+        "文本输入",
+        "搜索",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpInput",
+    "nonUseCases": [
+      "只能从固定选项中选择时使用 Select"
+    ],
+    "props": [
+      {
+        "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": "'large' | 'default' | 'small'"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否禁用",
+        "hasDefault": true,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": "v-model",
+        "defaultText": null,
+        "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": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "最小输入长度",
+        "hasDefault": false,
+        "name": "minlength",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": "text",
+        "description": "类型",
+        "hasDefault": true,
+        "name": "type",
+        "required": false,
+        "type": "'text' | 'textarea' | 其他原生 input 类型"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "控制是否能被用户缩放",
+        "hasDefault": false,
+        "name": "resize",
+        "required": false,
+        "type": "'none' | 'both' | 'horizontal' | 'vertical'"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "textarea 自适应内容高度",
+        "hasDefault": false,
+        "name": "autosize",
+        "required": false,
+        "type": "boolean | { minRows: number, maxRows: number }"
+      },
+      {
+        "alias": null,
+        "defaultText": "off",
+        "description": "原生 autocomplete 属性",
+        "hasDefault": true,
+        "name": "autocomplete",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "指定输入值的格式",
+        "hasDefault": false,
+        "name": "formatter",
+        "required": false,
+        "type": "(value: string | number) => string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "指定从格式化器输入中提取的值",
+        "hasDefault": false,
+        "name": "parser",
+        "required": false,
+        "type": "(value: string) => string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "输入框占位文本",
+        "hasDefault": false,
+        "name": "placeholder",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 form 属性",
+        "hasDefault": false,
+        "name": "form",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "原生 readonly 属性",
+        "hasDefault": false,
+        "name": "readonly",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否显示清除按钮",
+        "hasDefault": false,
+        "name": "clearable",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "clearIcon",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否显示切换密码图标",
+        "hasDefault": false,
+        "name": "showPassword",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否显示统计字数",
+        "hasDefault": false,
+        "name": "showWordLimit",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "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": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "自定义前缀图标",
+        "hasDefault": false,
+        "name": "prefixIcon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "containerRole",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "输入框的 tabindex",
+        "hasDefault": true,
+        "name": "tabindex",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "输入时是否触发表单的校验",
+        "hasDefault": true,
+        "name": "validateEvent",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "{}",
+        "description": "input 元素或 textarea 元素的 style",
+        "hasDefault": true,
+        "name": "inputStyle",
+        "required": false,
+        "type": "string | object"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "原生 autofocus 属性",
+        "hasDefault": false,
+        "name": "autofocus",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "2",
+        "description": "textarea 的行数",
+        "hasDefault": true,
+        "name": "rows",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "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": "原生 name 属性",
+        "hasDefault": false,
+        "name": "name",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "countGraphemes",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否启用浮动标签（Material 风格），聚焦或有值时占位文本上浮",
+        "hasDefault": false,
+        "name": "floatLabel",
+        "required": false,
+        "type": "boolean"
+      }
+    ],
+    "related": [
+      "EpFormItem",
+      "EpInputNumber",
+      "EpAutocomplete"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "输入框头部内容",
+        "name": "prefix"
+      },
+      {
+        "description": "输入框尾部内容",
+        "name": "suffix"
+      },
+      {
+        "description": "输入框前置内容",
+        "name": "prepend"
+      },
+      {
+        "description": "输入框后置内容",
+        "name": "append"
+      }
+    ],
+    "slug": "input",
+    "summary": "文本输入框，支持前后缀、清空与校验",
+    "tag": "ep-input",
+    "useCases": [
+      "收集用户名、搜索词等文本",
+      "表单字段输入与校验"
+    ],
+    "variants": [
+      {
+        "dimension": "type",
+        "values": [
+          "text",
+          "textarea"
+        ],
+        "when": "通过 type 选择类型"
+      },
+      {
+        "dimension": "size",
+        "values": [
+          "large",
+          "default",
+          "small"
+        ],
+        "when": "按容器空间与信息密度选择尺寸"
+      },
+      {
+        "dimension": "state",
+        "values": [
+          "disabled",
+          "readonly"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-border-color",
+        "--el-border-radius-base",
+        "--el-color-primary",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "矩形输入框",
+      "slotContent": [
+        "prefix：输入框头部内容",
+        "suffix：输入框尾部内容",
+        "prepend：输入框前置内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/input.md

@@ -0,0 +1,166 @@
+# EpInput
+
+`ep-input` · form（表单） · `component:input`
+
+## 摘要
+
+文本输入框，支持前后缀、清空与校验
+
+## 适用场景
+
+- 适用：收集用户名、搜索词等文本
+- 适用：表单字段输入与校验
+- 不适用：只能从固定选项中选择时使用 Select
+
+## 关键词
+
+- 中文：输入框、文本输入、搜索、表单
+- English: input, textbox, field, form
+
+## 变体
+
+- type: text/textarea（通过 type 选择类型）
+- size: large/default/small（按容器空间与信息密度选择尺寸）
+- state: disabled/readonly（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- id (unknown)
+- size ('large' | 'default' | 'small')：输入框尺寸
+- disabled (boolean，默认 false)：是否禁用
+- modelValue（别名 v-model） (string | number，默认 见文档)：绑定值
+- modelModifiers (unknown，默认 见文档)
+- maxlength (string | number)：最大输入长度
+- minlength (string | number)：最小输入长度
+- type ('text' | 'textarea' | 其他原生 input 类型，默认 text)：类型
+- resize ('none' | 'both' | 'horizontal' | 'vertical')：控制是否能被用户缩放
+- autosize (boolean | { minRows: number, maxRows: number })：textarea 自适应内容高度
+- autocomplete (string，默认 off)：原生 autocomplete 属性
+- formatter ((value: string | number) => string)：指定输入值的格式
+- parser ((value: string) => string)：指定从格式化器输入中提取的值
+- placeholder (string)：输入框占位文本
+- form (string)：原生 form 属性
+- readonly (boolean)：原生 readonly 属性
+- clearable (boolean)：是否显示清除按钮
+- clearIcon (unknown，默认 见文档)
+- showPassword (boolean)：是否显示切换密码图标
+- showWordLimit (boolean)：是否显示统计字数
+- wordLimitPosition (unknown，默认 见文档)
+- suffixIcon (string | Component)：自定义后缀图标
+- prefixIcon (string | Component)：自定义前缀图标
+- containerRole (unknown)
+- tabindex (string | number，默认 见文档)：输入框的 tabindex
+- validateEvent (boolean，默认 true)：输入时是否触发表单的校验
+- inputStyle (string | object，默认 {})：input 元素或 textarea 元素的 style
+- autofocus (boolean)：原生 autofocus 属性
+- rows (number，默认 2)：textarea 的行数
+- ariaLabel (unknown)
+- inputmode (unknown)
+- name (string)：原生 name 属性
+- countGraphemes (unknown)
+- floatLabel (boolean)：是否启用浮动标签（Material 风格），聚焦或有值时占位文本上浮
+
+## Events
+
+- update:modelValue((value: string))：输入值变化时触发
+- input((value: string | number))：在 Input 值改变时触发
+- change((value: string | number))：仅当 modelValue 改变时触发
+- focus((event: FocusEvent))：在 Input 获得焦点时触发
+- blur((event: FocusEvent))：在 Input 失去焦点时触发
+- clear(())：在点击由 clearable 属性生成的清空按钮时触发
+- mouseleave((event: MouseEvent))：鼠标离开 Input 时触发
+- mouseenter((event: MouseEvent))：鼠标进入 Input 时触发
+- keydown((event: KeyboardEvent | Event))：在 Input 上按下按键时触发
+- compositionstart((event: CompositionEvent))：输入法组合输入开始时触发
+- compositionupdate((event: CompositionEvent))：输入法组合输入更新时触发
+- compositionend((event: CompositionEvent))：输入法组合输入结束时触发
+
+## Slots
+
+- prefix：输入框头部内容
+- suffix：输入框尾部内容
+- prepend：输入框前置内容
+- append：输入框后置内容
+
+## Exposes
+
+- blur(() => void)：使 input 失去焦点
+- clear(() => void)：清除 input 值
+- focus(() => void)：使 input 获取焦点
+- input(Ref<HTMLInputElement>)：Input HTML 元素
+- ref(Ref<HTMLInputElement | HTMLTextAreaElement>)：HTML 元素 input 或 textarea
+- resizeTextarea(() => void)：改变 textarea 大小
+- select(() => void)：选中 input 中的文字
+- textarea(Ref<HTMLTextAreaElement>)：HTML textarea 元素
+- textareaStyle(Ref<StyleValue>)：textarea 的样式
+
+## 视觉提示
+
+- 形状：矩形输入框
+- 密度：中等
+- 插槽内容：prefix：输入框头部内容；suffix：输入框尾部内容；prepend：输入框前置内容
+- CSS 变量：--el-border-color、--el-border-radius-base、--el-color-primary、--el-font-size-base
+
+## 示例
+
+### 基础输入框
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { EpInput } from 'ep-craft'
+
+const value = ref('')
+</script>
+
+<template>
+  <ep-input v-model="value" placeholder="请输入内容" />
+</template>
+```
+
+### 可清空与密码框
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { EpInput } from 'ep-craft'
+
+const keyword = ref('')
+const password = ref('')
+</script>
+
+<template>
+  <ep-input v-model="keyword" clearable placeholder="可清空" />
+  <ep-input v-model="password" type="password" show-password placeholder="密码" />
+</template>
+```
+
+### 前缀图标
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { EpIcon, EpInput } from 'ep-craft'
+import { Search } from 'ep-craft/icons'
+
+const query = ref('')
+</script>
+
+<template>
+  <ep-input v-model="query" placeholder="搜索">
+    <template #prefix>
+      <ep-icon><Search /></ep-icon>
+    </template>
+  </ep-input>
+</template>
+```
+
+## 相关条目
+
+- EpFormItem
+- EpInputNumber
+- EpAutocomplete
+
+---
+
+ep-craft 0.2.0