ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/upload.json

@@ -0,0 +1,382 @@
+{
+  "entry": {
+    "category": "form",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpButton, EpUpload } from 'ep-craft'\n</script>\n\n<template>\n  <ep-upload action=\"/api/upload\">\n    <ep-button type=\"primary\">点击上传</ep-button>\n  </ep-upload>\n</template>",
+        "id": "upload-1",
+        "language": "vue",
+        "title": "点击上传"
+      },
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpUpload } from 'ep-craft'\n</script>\n\n<template>\n  <ep-upload action=\"/api/upload\" drag>\n    <p>将文件拖到此处，或点击选择</p>\n  </ep-upload>\n</template>",
+        "id": "upload-2",
+        "language": "vue",
+        "title": "拖拽上传"
+      },
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpButton, EpUpload } from 'ep-craft'\n</script>\n\n<template>\n  <ep-upload action=\"/api/upload\" multiple :limit=\"3\">\n    <ep-button type=\"primary\">最多上传 3 个文件</ep-button>\n    <template #tip>\n      <div>仅支持单个文件不超过 10MB</div>\n    </template>\n  </ep-upload>\n</template>",
+        "id": "upload-3",
+        "language": "vue",
+        "title": "限制数量"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "取消上传请求",
+        "name": "abort",
+        "type": "(file: UploadFile) => void"
+      },
+      {
+        "description": "手动上传文件列表",
+        "name": "submit",
+        "type": "() => void"
+      },
+      {
+        "description": "清空已上传的文件列表",
+        "name": "clearFiles",
+        "type": "(status?: UploadStatus[]) => void"
+      },
+      {
+        "description": "手动选择文件",
+        "name": "handleStart",
+        "type": "(rawFile: UploadRawFile) => void"
+      },
+      {
+        "description": "手动移除文件",
+        "name": "handleRemove",
+        "type": "(file: UploadFile | UploadRawFile, rawFile?: UploadRawFile) => void"
+      }
+    ],
+    "hot": true,
+    "id": "component:upload",
+    "keywords": {
+      "en": [
+        "upload",
+        "file",
+        "attachment",
+        "form"
+      ],
+      "zh": [
+        "上传",
+        "文件",
+        "附件",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpUpload",
+    "nonUseCases": [
+      "仅展示静态文本或只读数据时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "上传文件之前的钩子",
+        "hasDefault": true,
+        "name": "beforeUpload",
+        "required": false,
+        "type": "(rawFile: UploadRawFile) => Awaitable<boolean | void | File | Blob | null | undefined>"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "删除文件之前的钩子",
+        "hasDefault": false,
+        "name": "beforeRemove",
+        "required": false,
+        "type": "(uploadFile: UploadFile, uploadFiles: UploadFiles) => Awaitable<boolean>"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "文件列表移除文件时的钩子",
+        "hasDefault": true,
+        "name": "onRemove",
+        "required": false,
+        "type": "(uploadFile: UploadFile, uploadFiles: UploadFiles) => void"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "文件状态改变时的钩子",
+        "hasDefault": true,
+        "name": "onChange",
+        "required": false,
+        "type": "(uploadFile: UploadFile, uploadFiles: UploadFiles) => void"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "点击文件列表中已上传的文件时的钩子",
+        "hasDefault": true,
+        "name": "onPreview",
+        "required": false,
+        "type": "(uploadFile: UploadFile) => void"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "文件上传成功时的钩子",
+        "hasDefault": true,
+        "name": "onSuccess",
+        "required": false,
+        "type": "(response: any, uploadFile: UploadFile, uploadFiles: UploadFiles) => void"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "文件上传时的钩子",
+        "hasDefault": true,
+        "name": "onProgress",
+        "required": false,
+        "type": "(event: UploadProgressEvent, uploadFile: UploadFile, uploadFiles: UploadFiles) => void"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "文件上传失败时的钩子",
+        "hasDefault": true,
+        "name": "onError",
+        "required": false,
+        "type": "(error: Error, uploadFile: UploadFile, uploadFiles: UploadFiles) => void"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "当超出限制时执行的钩子函数",
+        "hasDefault": true,
+        "name": "onExceed",
+        "required": false,
+        "type": "(files: File[], uploadFiles: UploadUserFile[]) => void"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "crossorigin",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "'#'",
+        "description": "请求 URL",
+        "hasDefault": true,
+        "name": "action",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "设置上传的请求头部",
+        "hasDefault": false,
+        "name": "headers",
+        "required": false,
+        "type": "Record<string, any>"
+      },
+      {
+        "alias": null,
+        "defaultText": "post",
+        "description": "设置上传请求方法",
+        "hasDefault": true,
+        "name": "method",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "{}",
+        "description": "上传时附带的额外参数",
+        "hasDefault": true,
+        "name": "data",
+        "required": false,
+        "type": "Record<string, any> | (rawFile: UploadRawFile) => Record<string, any> | Promise<Record<string, any>>"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否支持多选文件",
+        "hasDefault": false,
+        "name": "multiple",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "file",
+        "description": "上传的文件字段名",
+        "hasDefault": true,
+        "name": "name",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否启用拖拽上传",
+        "hasDefault": false,
+        "name": "drag",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否携带 cookie",
+        "hasDefault": false,
+        "name": "withCredentials",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否显示已上传文件列表",
+        "hasDefault": true,
+        "name": "showFileList",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "接受上传的文件类型",
+        "hasDefault": true,
+        "name": "accept",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": "v-model:file-list",
+        "defaultText": "[]",
+        "description": "默认上传文件",
+        "hasDefault": true,
+        "name": "fileList",
+        "required": false,
+        "type": "UploadUserFile[]"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否自动上传文件",
+        "hasDefault": true,
+        "name": "autoUpload",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "text",
+        "description": "文件列表的类型",
+        "hasDefault": true,
+        "name": "listType",
+        "required": false,
+        "type": "'text' | 'picture' | 'picture-card'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "覆盖默认的 Xhr 行为",
+        "hasDefault": true,
+        "name": "httpRequest",
+        "required": false,
+        "type": "(options: UploadRequestOptions) => XMLHttpRequest | Promise<unknown>"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否禁用上传",
+        "hasDefault": true,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "允许上传文件的最大数量",
+        "hasDefault": false,
+        "name": "limit",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "directory",
+        "required": false,
+        "type": "unknown"
+      }
+    ],
+    "related": [
+      "EpButton",
+      "EpProgress"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义默认内容",
+        "name": "default"
+      },
+      {
+        "description": "触发文件选择框的内容",
+        "name": "trigger"
+      },
+      {
+        "description": "提示说明文字",
+        "name": "tip"
+      },
+      {
+        "description": "缩略图模板的内容",
+        "name": "file"
+      }
+    ],
+    "slug": "upload",
+    "summary": "文件上传，选择、拖拽并展示进度",
+    "tag": "ep-upload",
+    "useCases": [
+      "附件与图片上传",
+      "批量文件提交与进度反馈"
+    ],
+    "variants": [
+      {
+        "dimension": "state",
+        "values": [
+          "disabled"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-border-color",
+        "--el-border-radius-base",
+        "--el-color-primary",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "矩形输入框",
+      "slotContent": [
+        "default：自定义默认内容",
+        "trigger：触发文件选择框的内容",
+        "tip：提示说明文字"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/upload.md

@@ -0,0 +1,130 @@
+# EpUpload
+
+`ep-upload` · form（表单） · `component:upload`
+
+## 摘要
+
+文件上传，选择、拖拽并展示进度
+
+## 适用场景
+
+- 适用：附件与图片上传
+- 适用：批量文件提交与进度反馈
+- 不适用：仅展示静态文本或只读数据时
+
+## 关键词
+
+- 中文：上传、文件、附件、表单
+- English: upload, file, attachment, form
+
+## 变体
+
+- state: disabled（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- beforeUpload ((rawFile: UploadRawFile) => Awaitable<boolean | void | File | Blob | null | undefined>，默认 见文档)：上传文件之前的钩子
+- beforeRemove ((uploadFile: UploadFile, uploadFiles: UploadFiles) => Awaitable<boolean>)：删除文件之前的钩子
+- onRemove ((uploadFile: UploadFile, uploadFiles: UploadFiles) => void，默认 见文档)：文件列表移除文件时的钩子
+- onChange ((uploadFile: UploadFile, uploadFiles: UploadFiles) => void，默认 见文档)：文件状态改变时的钩子
+- onPreview ((uploadFile: UploadFile) => void，默认 见文档)：点击文件列表中已上传的文件时的钩子
+- onSuccess ((response: any, uploadFile: UploadFile, uploadFiles: UploadFiles) => void，默认 见文档)：文件上传成功时的钩子
+- onProgress ((event: UploadProgressEvent, uploadFile: UploadFile, uploadFiles: UploadFiles) => void，默认 见文档)：文件上传时的钩子
+- onError ((error: Error, uploadFile: UploadFile, uploadFiles: UploadFiles) => void，默认 见文档)：文件上传失败时的钩子
+- onExceed ((files: File[], uploadFiles: UploadUserFile[]) => void，默认 见文档)：当超出限制时执行的钩子函数
+- crossorigin (unknown)
+- action (string，默认 '#')：请求 URL
+- headers (Record<string, any>)：设置上传的请求头部
+- method (string，默认 post)：设置上传请求方法
+- data (Record<string, any> | (rawFile: UploadRawFile) => Record<string, any> | Promise<Record<string, any>>，默认 {})：上传时附带的额外参数
+- multiple (boolean)：是否支持多选文件
+- name (string，默认 file)：上传的文件字段名
+- drag (boolean)：是否启用拖拽上传
+- withCredentials (boolean)：是否携带 cookie
+- showFileList (boolean，默认 true)：是否显示已上传文件列表
+- accept (string，默认 见文档)：接受上传的文件类型
+- fileList（别名 v-model:file-list） (UploadUserFile[]，默认 [])：默认上传文件
+- autoUpload (boolean，默认 true)：是否自动上传文件
+- listType ('text' | 'picture' | 'picture-card'，默认 text)：文件列表的类型
+- httpRequest ((options: UploadRequestOptions) => XMLHttpRequest | Promise<unknown>，默认 见文档)：覆盖默认的 Xhr 行为
+- disabled (boolean，默认 false)：是否禁用上传
+- limit (number)：允许上传文件的最大数量
+- directory (unknown)
+
+## Slots
+
+- default：自定义默认内容
+- trigger：触发文件选择框的内容
+- tip：提示说明文字
+- file：缩略图模板的内容
+
+## Exposes
+
+- abort((file: UploadFile) => void)：取消上传请求
+- submit(() => void)：手动上传文件列表
+- clearFiles((status?: UploadStatus[]) => void)：清空已上传的文件列表
+- handleStart((rawFile: UploadRawFile) => void)：手动选择文件
+- handleRemove((file: UploadFile | UploadRawFile, rawFile?: UploadRawFile) => void)：手动移除文件
+
+## 视觉提示
+
+- 形状：矩形输入框
+- 密度：中等
+- 插槽内容：default：自定义默认内容；trigger：触发文件选择框的内容；tip：提示说明文字
+- CSS 变量：--el-border-color、--el-border-radius-base、--el-color-primary、--el-font-size-base
+
+## 示例
+
+### 点击上传
+
+```vue
+<script setup lang="ts">
+import { EpButton, EpUpload } from 'ep-craft'
+</script>
+
+<template>
+  <ep-upload action="/api/upload">
+    <ep-button type="primary">点击上传</ep-button>
+  </ep-upload>
+</template>
+```
+
+### 拖拽上传
+
+```vue
+<script setup lang="ts">
+import { EpUpload } from 'ep-craft'
+</script>
+
+<template>
+  <ep-upload action="/api/upload" drag>
+    <p>将文件拖到此处，或点击选择</p>
+  </ep-upload>
+</template>
+```
+
+### 限制数量
+
+```vue
+<script setup lang="ts">
+import { EpButton, EpUpload } from 'ep-craft'
+</script>
+
+<template>
+  <ep-upload action="/api/upload" multiple :limit="3">
+    <ep-button type="primary">最多上传 3 个文件</ep-button>
+    <template #tip>
+      <div>仅支持单个文件不超过 10MB</div>
+    </template>
+  </ep-upload>
+</template>
+```
+
+## 相关条目
+
+- EpButton
+- EpProgress
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/watermark.json

@@ -0,0 +1,157 @@
+{
+  "entry": {
+    "category": "feedback",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpWatermark } from 'ep-craft'\n</script>\n\n<template>\n  <ep-watermark content=\"ep-craft\">\n    <div style=\"height: 200px\">需要保护的内容区域</div>\n  </ep-watermark>\n</template>",
+        "id": "watermark-1",
+        "language": "vue",
+        "title": "文字水印"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:watermark",
+    "keywords": {
+      "en": [
+        "watermark",
+        "background",
+        "feedback"
+      ],
+      "zh": [
+        "水印",
+        "反馈"
+      ]
+    },
+    "kind": "component",
+    "name": "EpWatermark",
+    "nonUseCases": [
+      "无需用户感知状态变化时",
+      "需要完整业务弹窗流程时优先使用 Dialog"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "9",
+        "description": "水印元素的 z-index",
+        "hasDefault": true,
+        "name": "zIndex",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "-22",
+        "description": "水印绘制时旋转角度",
+        "hasDefault": true,
+        "name": "rotate",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "120",
+        "description": "水印的宽度",
+        "hasDefault": false,
+        "name": "width",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "64",
+        "description": "水印的高度",
+        "hasDefault": false,
+        "name": "height",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "图片源",
+        "hasDefault": false,
+        "name": "image",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "水印文字内容",
+        "hasDefault": true,
+        "name": "content",
+        "required": false,
+        "type": "string | string[]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "文字样式",
+        "hasDefault": false,
+        "name": "font",
+        "required": false,
+        "type": "{ color, fontSize, fontWeight, fontFamily, fontStyle, textAlign }"
+      },
+      {
+        "alias": null,
+        "defaultText": "[100, 100]",
+        "description": "水印之间的间距",
+        "hasDefault": true,
+        "name": "gap",
+        "required": false,
+        "type": "[number, number]"
+      },
+      {
+        "alias": null,
+        "defaultText": "[gap[0]/2, gap[1]/2]",
+        "description": "水印距离容器左上角的偏移量",
+        "hasDefault": false,
+        "name": "offset",
+        "required": false,
+        "type": "[number, number]"
+      }
+    ],
+    "related": [
+      "EpContainer"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "添加水印的容器",
+        "name": "default"
+      }
+    ],
+    "slug": "watermark",
+    "summary": "水印，状态与结果反馈",
+    "tag": "ep-watermark",
+    "useCases": [
+      "展示水印并向用户传达状态",
+      "在操作前后提供即时反馈"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-color-success",
+        "--el-color-warning",
+        "--el-color-danger",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "行内或块级提示",
+      "slotContent": [
+        "default：添加水印的容器"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}