ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/image.md

@@ -0,0 +1,96 @@
+# EpImage
+
+`ep-image` · data（数据展示） · `component:image`
+
+## 摘要
+
+图片，结构化数据展示
+
+## 适用场景
+
+- 适用：展示图片类结构化数据
+- 适用：需要浏览、比较或定位数据时
+- 不适用：数据量极小且无需结构化展示时
+
+## 关键词
+
+- 中文：图片、数据
+- English: image, picture, data
+
+## 变体
+
+- state: loading（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- hideOnClickModal (boolean)：点击遮罩层是否关闭预览
+- src (string，默认 '')：图片地址，同原生 img 的 src
+- fit ('' | 'contain' | 'cover' | 'fill' | 'none' | 'scale-down'，默认 '')：图片填充方式，同 object-fit
+- loading ('eager' | 'lazy')：浏览器加载方式，同原生 img 的 loading
+- lazy (boolean)：是否懒加载
+- scrollContainer (string | HTMLElement)：懒加载时监听滚动的容器
+- previewSrcList (string[]，默认 [])：开启预览时的大图列表
+- previewTeleported (boolean)：是否将预览层挂载到 body
+- zIndex (number)：预览层 z-index
+- initialIndex (number，默认 0)：初始预览图片索引
+- infinite (boolean，默认 true)：预览是否循环
+- closeOnPressEscape (boolean，默认 true)：按 ESC 是否关闭预览
+- zoomRate (number，默认 1.2)：缩放事件的缩放倍率
+- scale (number，默认 1)：初始缩放比例
+- minScale (number，默认 0.2)：最小缩放比例
+- maxScale (number，默认 7)：最大缩放比例
+- showProgress (boolean)：是否显示预览进度
+- crossorigin ('anonymous' | 'use-credentials' | '')：原生 crossorigin 属性
+
+## Events
+
+- load((event: Event))：图片加载成功时触发
+- error((event: Event))：图片加载失败时触发
+- switch((index: number))：预览切换图片时触发
+- close(—)：关闭预览时触发
+- show(—)：打开预览时触发
+
+## Slots
+
+- placeholder：图片加载完成前的占位内容
+- error：图片加载失败时的内容
+- viewer：自定义预览层内容
+- progress：自定义预览进度内容
+- toolbar：自定义预览工具栏
+- viewer-error：预览图片加载失败时的内容
+
+## Exposes
+
+- showPreview(() => void)：手动打开预览
+
+## 视觉提示
+
+- 形状：块级数据区域
+- 密度：紧凑
+- 插槽内容：placeholder：图片加载完成前的占位内容；error：图片加载失败时的内容；viewer：自定义预览层内容
+- CSS 变量：--el-border-color-lighter、--el-bg-color、--el-text-color-regular、--el-font-size-base
+
+## 示例
+
+### 图片与预览
+
+```vue
+<script setup lang="ts">
+import { EpImage } from 'ep-craft'
+
+const src =
+  "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='400' height='200'%3E%3Crect fill='%23409eff' width='400' height='200'/%3E%3Ctext x='50%25' y='50%25' fill='white' font-size='20' text-anchor='middle'%3E示例图片%3C/text%3E%3C/svg%3E"
+</script>
+
+<template>
+  <ep-image :src="src" :preview-src-list="[src]" fit="cover" style="width: 400px" />
+</template>
+```
+
+## 相关条目
+
+- EpImageViewer
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/input-number.json

@@ -0,0 +1,370 @@
+{
+  "entry": {
+    "category": "form",
+    "events": [
+      {
+        "description": "绑定值被改变时触发",
+        "name": "change",
+        "params": "(currentValue: number | undefined, oldValue: number | undefined)"
+      },
+      {
+        "description": "在组件 Input 失去焦点时触发",
+        "name": "blur",
+        "params": "(event: FocusEvent)"
+      },
+      {
+        "description": "在组件 Input 获得焦点时触发",
+        "name": "focus",
+        "params": "(event: FocusEvent)"
+      },
+      {
+        "description": "在输入框输入时触发",
+        "name": "input",
+        "params": "(value: number | null | undefined)"
+      },
+      {
+        "description": "绑定值变化时触发",
+        "name": "update:modelValue",
+        "params": "(value: number | undefined)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpInputNumber } from 'ep-craft'\n\nconst value = ref(1)\n</script>\n\n<template>\n  <ep-input-number v-model=\"value\" />\n</template>",
+        "id": "input-number-1",
+        "language": "vue",
+        "title": "数字输入"
+      },
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpInputNumber } from 'ep-craft'\n\nconst value = ref(50)\n</script>\n\n<template>\n  <ep-input-number v-model=\"value\" :min=\"0\" :max=\"100\" />\n</template>",
+        "id": "input-number-2",
+        "language": "vue",
+        "title": "范围限制"
+      },
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpInputNumber } from 'ep-craft'\n\nconst value = ref(2)\n</script>\n\n<template>\n  <ep-input-number v-model=\"value\" :step=\"2\" step-strictly />\n</template>",
+        "id": "input-number-3",
+        "language": "vue",
+        "title": "固定步长"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "使 input 组件获取焦点",
+        "name": "focus",
+        "type": "() => void"
+      },
+      {
+        "description": "使 input 组件失去焦点",
+        "name": "blur",
+        "type": "() => void"
+      }
+    ],
+    "hot": true,
+    "id": "component:input-number",
+    "keywords": {
+      "en": [
+        "input-number",
+        "input",
+        "number",
+        "stepper",
+        "form"
+      ],
+      "zh": [
+        "数字输入框",
+        "数字输入",
+        "步进器",
+        "数量",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpInputNumber",
+    "nonUseCases": [
+      "仅展示静态文本或只读数据时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "id",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "1",
+        "description": "计数器步长",
+        "hasDefault": true,
+        "name": "step",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否只能输入 step 的倍数",
+        "hasDefault": true,
+        "name": "stepStrictly",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "Infinity",
+        "description": "设置计数器允许的最大值",
+        "hasDefault": true,
+        "name": "max",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "-Infinity",
+        "description": "设置计数器允许的最小值",
+        "hasDefault": true,
+        "name": "min",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": "v-model",
+        "defaultText": null,
+        "description": "绑定值",
+        "hasDefault": false,
+        "name": "modelValue",
+        "required": false,
+        "type": "number | undefined"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "原生 readonly 属性",
+        "hasDefault": true,
+        "name": "readonly",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否禁用",
+        "hasDefault": true,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "default",
+        "description": "计数器尺寸",
+        "hasDefault": false,
+        "name": "size",
+        "required": false,
+        "type": "'large' | 'default' | 'small'"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否使用控制按钮",
+        "hasDefault": true,
+        "name": "controls",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "控制按钮位置",
+        "hasDefault": true,
+        "name": "controlsPosition",
+        "required": false,
+        "type": "'right' | ''"
+      },
+      {
+        "alias": null,
+        "defaultText": "null",
+        "description": "当输入框被清空时显示的值",
+        "hasDefault": true,
+        "name": "valueOnClear",
+        "required": false,
+        "type": "number | null | min | max"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 name 属性",
+        "hasDefault": false,
+        "name": "name",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "输入框占位文本",
+        "hasDefault": false,
+        "name": "placeholder",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "数值精度",
+        "hasDefault": false,
+        "name": "precision",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否触发表单验证",
+        "hasDefault": true,
+        "name": "validateEvent",
+        "required": false,
+        "type": "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"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 inputmode 属性，用于虚拟键盘",
+        "hasDefault": true,
+        "name": "inputmode",
+        "required": false,
+        "type": "'search' | 'none' | 'text' | 'email' | 'tel' | 'url' | 'numeric' | 'decimal'"
+      },
+      {
+        "alias": null,
+        "defaultText": "center",
+        "description": "输入文本对齐方式",
+        "hasDefault": true,
+        "name": "align",
+        "required": false,
+        "type": "'left' | 'right' | 'center'"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否禁用科学计数法输入（如 e、E）",
+        "hasDefault": false,
+        "name": "disabledScientific",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "指定输入框展示值的格式",
+        "hasDefault": false,
+        "name": "formatter",
+        "required": false,
+        "type": "(value: string) => string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "指定从格式化输入中提取值的方式",
+        "hasDefault": false,
+        "name": "parser",
+        "required": false,
+        "type": "(value: string) => string"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "原生 tabindex 属性",
+        "hasDefault": true,
+        "name": "tabindex",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否启用 Material 风格浮动标签",
+        "hasDefault": false,
+        "name": "floatLabel",
+        "required": false,
+        "type": "boolean"
+      }
+    ],
+    "related": [
+      "EpInput",
+      "EpSlider"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [],
+    "slug": "input-number",
+    "summary": "数字输入框，限制范围与步进调节",
+    "tag": "ep-input-number",
+    "useCases": [
+      "数量、金额等数字录入",
+      "需要范围与步长约束的表单"
+    ],
+    "variants": [
+      {
+        "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": [
+        "decrease-icon：自定义内容",
+        "increase-icon：自定义内容",
+        "prefix：自定义内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/input-number.md

@@ -0,0 +1,127 @@
+# EpInputNumber
+
+`ep-input-number` · form（表单） · `component:input-number`
+
+## 摘要
+
+数字输入框，限制范围与步进调节
+
+## 适用场景
+
+- 适用：数量、金额等数字录入
+- 适用：需要范围与步长约束的表单
+- 不适用：仅展示静态文本或只读数据时
+
+## 关键词
+
+- 中文：数字输入框、数字输入、步进器、数量、表单
+- English: input-number, input, number, stepper, form
+
+## 变体
+
+- size: large/default/small（按容器空间与信息密度选择尺寸）
+- state: disabled/readonly（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- id (unknown，默认 见文档)
+- step (number，默认 1)：计数器步长
+- stepStrictly (boolean，默认 false)：是否只能输入 step 的倍数
+- max (number，默认 Infinity)：设置计数器允许的最大值
+- min (number，默认 -Infinity)：设置计数器允许的最小值
+- modelValue（别名 v-model） (number | undefined)：绑定值
+- readonly (boolean，默认 false)：原生 readonly 属性
+- disabled (boolean，默认 false)：是否禁用
+- size ('large' | 'default' | 'small')：计数器尺寸
+- controls (boolean，默认 true)：是否使用控制按钮
+- controlsPosition ('right' | ''，默认 '')：控制按钮位置
+- valueOnClear (number | null | min | max，默认 null)：当输入框被清空时显示的值
+- name (string)：原生 name 属性
+- placeholder (string)：输入框占位文本
+- precision (number)：数值精度
+- validateEvent (boolean，默认 true)：是否触发表单验证
+- ariaLabel (string)：原生 aria-label 属性
+- ariaLabelledby (string)：原生 aria-labelledby 属性；显式传入时优先于浮动标签自动关联的文本
+- inputmode ('search' | 'none' | 'text' | 'email' | 'tel' | 'url' | 'numeric' | 'decimal'，默认 见文档)：原生 inputmode 属性，用于虚拟键盘
+- align ('left' | 'right' | 'center'，默认 center)：输入文本对齐方式
+- disabledScientific (boolean)：是否禁用科学计数法输入（如 e、E）
+- formatter ((value: string) => string)：指定输入框展示值的格式
+- parser ((value: string) => string)：指定从格式化输入中提取值的方式
+- tabindex (string | number，默认 0)：原生 tabindex 属性
+- floatLabel (boolean)：是否启用 Material 风格浮动标签
+
+## Events
+
+- change((currentValue: number | undefined, oldValue: number | undefined))：绑定值被改变时触发
+- blur((event: FocusEvent))：在组件 Input 失去焦点时触发
+- focus((event: FocusEvent))：在组件 Input 获得焦点时触发
+- input((value: number | null | undefined))：在输入框输入时触发
+- update:modelValue((value: number | undefined))：绑定值变化时触发
+
+## Exposes
+
+- focus(() => void)：使 input 组件获取焦点
+- blur(() => void)：使 input 组件失去焦点
+
+## 视觉提示
+
+- 形状：矩形输入框
+- 密度：中等
+- 插槽内容：decrease-icon：自定义内容；increase-icon：自定义内容；prefix：自定义内容
+- 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 { EpInputNumber } from 'ep-craft'
+
+const value = ref(1)
+</script>
+
+<template>
+  <ep-input-number v-model="value" />
+</template>
+```
+
+### 范围限制
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { EpInputNumber } from 'ep-craft'
+
+const value = ref(50)
+</script>
+
+<template>
+  <ep-input-number v-model="value" :min="0" :max="100" />
+</template>
+```
+
+### 固定步长
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { EpInputNumber } from 'ep-craft'
+
+const value = ref(2)
+</script>
+
+<template>
+  <ep-input-number v-model="value" :step="2" step-strictly />
+</template>
+```
+
+## 相关条目
+
+- EpInput
+- EpSlider
+
+---
+
+ep-craft 0.2.0