ep-craft 0.1.41 → 0.2.0

package/dist-ai/services/message.json

@@ -0,0 +1,137 @@
+{
+  "entry": {
+    "callForm": "EpMessage(options) 或 EpMessage.success(message, options)",
+    "category": "feedback",
+    "constraints": [
+      "需要应用上下文时先执行 app.use(EpMessage)，否则调用缺少全局上下文",
+      "短反馈使用 Message；需要标题与较长描述时使用 EpNotification",
+      "duration 为 0 时消息常驻，必须提供关闭方式避免遮挡页面"
+    ],
+    "directiveId": null,
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpButton, EpMessage } from 'ep-craft'\n\nconst notify = () => {\n  EpMessage.success('保存成功')\n}\n</script>\n\n<template>\n  <ep-button type=\"primary\" @click=\"notify\">保存</ep-button>\n</template>",
+        "id": "message-1",
+        "language": "vue",
+        "title": "快捷消息"
+      },
+      {
+        "code": "import { EpMessage } from 'ep-craft'\n\nconst handler = EpMessage({\n  message: '正在同步数据',\n  type: 'info',\n  duration: 0,\n  showClose: true,\n})\n\nconst finish = () => {\n  handler.close()\n  EpMessage.closeAll()\n}",
+        "id": "message-2",
+        "language": "ts",
+        "title": "带选项与关闭"
+      }
+    ],
+    "id": "service:message",
+    "keywords": {
+      "en": [
+        "message",
+        "toast",
+        "notice",
+        "feedback"
+      ],
+      "zh": [
+        "消息",
+        "提示",
+        "轻提示",
+        "反馈",
+        "toast"
+      ]
+    },
+    "kind": "service",
+    "methods": [
+      {
+        "description": "按类型创建消息的快捷方法",
+        "name": "success / warning / error / info / primary",
+        "signature": "(message: string | VNode, options?: MessageOptions) => MessageHandler"
+      },
+      {
+        "description": "关闭全部消息，可只关闭指定类型",
+        "name": "closeAll",
+        "signature": "(type?: MessageType) => void"
+      },
+      {
+        "description": "关闭指定位置的全部消息",
+        "name": "closeAllByPlacement",
+        "signature": "(placement: MessagePlacement) => void"
+      },
+      {
+        "description": "返回值 MessageHandler 上的关闭方法",
+        "name": "close",
+        "signature": "(handler.close()) => void"
+      }
+    ],
+    "name": "EpMessage",
+    "options": [
+      {
+        "defaultText": "''",
+        "description": "提示正文；使用 HTML 时需开启 dangerouslyUseHTMLString",
+        "name": "message",
+        "required": true,
+        "type": "string | VNode | (() => VNode)"
+      },
+      {
+        "defaultText": "'info'",
+        "description": "提示类型，决定图标与配色",
+        "name": "type",
+        "required": false,
+        "type": "'primary' | 'success' | 'info' | 'warning' | 'error'"
+      },
+      {
+        "defaultText": "3000",
+        "description": "自动关闭毫秒数；为 0 时不自动关闭",
+        "name": "duration",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "defaultText": "false",
+        "description": "是否显示关闭按钮",
+        "name": "showClose",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "defaultText": "false",
+        "description": "是否使用朴素样式",
+        "name": "plain",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "defaultText": "'top'",
+        "description": "消息出现的屏幕位置",
+        "name": "placement",
+        "required": false,
+        "type": "'top' | 'top-left' | 'top-right' | 'bottom' | 'bottom-left' | 'bottom-right'"
+      },
+      {
+        "defaultText": "16",
+        "description": "距离视口顶部的偏移量",
+        "name": "offset",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "defaultText": "false",
+        "description": "合并内容与类型相同的消息并累加计数",
+        "name": "grouping",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "defaultText": null,
+        "description": "关闭后的回调",
+        "name": "onClose",
+        "required": false,
+        "type": "() => void"
+      }
+    ],
+    "slug": "message",
+    "summary": "全局轻量消息提示，展示短暂操作反馈"
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/services/message.md

@@ -0,0 +1,72 @@
+# EpMessage
+
+`EpMessage(options) 或 EpMessage.success(message, options)` · feedback（反馈） · `service:message`
+
+## 摘要
+
+全局轻量消息提示，展示短暂操作反馈
+
+## 关键词
+
+- 中文：消息、提示、轻提示、反馈、toast
+- English: message, toast, notice, feedback
+
+## 调用方式
+
+- 调用形式：EpMessage(options) 或 EpMessage.success(message, options)
+- 选项 message（string | VNode | (() => VNode)，必填，默认 ''）：提示正文；使用 HTML 时需开启 dangerouslyUseHTMLString
+- 选项 type（'primary' | 'success' | 'info' | 'warning' | 'error'，默认 'info'）：提示类型，决定图标与配色
+- 选项 duration（number，默认 3000）：自动关闭毫秒数；为 0 时不自动关闭
+- 选项 showClose（boolean，默认 false）：是否显示关闭按钮
+- 选项 plain（boolean，默认 false）：是否使用朴素样式
+- 选项 placement（'top' | 'top-left' | 'top-right' | 'bottom' | 'bottom-left' | 'bottom-right'，默认 'top'）：消息出现的屏幕位置
+- 选项 offset（number，默认 16）：距离视口顶部的偏移量
+- 选项 grouping（boolean，默认 false）：合并内容与类型相同的消息并累加计数
+- 选项 onClose（() => void）：关闭后的回调
+- 方法 success / warning / error / info / primary(message: string | VNode, options?: MessageOptions) => MessageHandler：按类型创建消息的快捷方法
+- 方法 closeAll(type?: MessageType) => void：关闭全部消息，可只关闭指定类型
+- 方法 closeAllByPlacement(placement: MessagePlacement) => void：关闭指定位置的全部消息
+- 方法 close(handler.close()) => void：返回值 MessageHandler 上的关闭方法
+- 约束：需要应用上下文时先执行 app.use(EpMessage)，否则调用缺少全局上下文
+- 约束：短反馈使用 Message；需要标题与较长描述时使用 EpNotification
+- 约束：duration 为 0 时消息常驻，必须提供关闭方式避免遮挡页面
+
+## 示例
+
+### 快捷消息
+
+```vue
+<script setup lang="ts">
+import { EpButton, EpMessage } from 'ep-craft'
+
+const notify = () => {
+  EpMessage.success('保存成功')
+}
+</script>
+
+<template>
+  <ep-button type="primary" @click="notify">保存</ep-button>
+</template>
+```
+
+### 带选项与关闭
+
+```ts
+import { EpMessage } from 'ep-craft'
+
+const handler = EpMessage({
+  message: '正在同步数据',
+  type: 'info',
+  duration: 0,
+  showClose: true,
+})
+
+const finish = () => {
+  handler.close()
+  EpMessage.closeAll()
+}
+```
+
+---
+
+ep-craft 0.2.0

package/dist-ai/services/notification.json

@@ -0,0 +1,136 @@
+{
+  "entry": {
+    "callForm": "EpNotification(options) 或 EpNotification.success(options)",
+    "category": "feedback",
+    "constraints": [
+      "onClose 在组件 props 中为必填，但调用时可由服务内部提供，业务侧无需手动传入",
+      "通知保留在屏幕角落，不阻断页面操作；确认类交互使用 MessageBox",
+      "需要应用上下文时先执行 app.use(EpNotification)"
+    ],
+    "directiveId": null,
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpButton, EpNotification } from 'ep-craft'\n\nconst notify = () => {\n  EpNotification({\n    title: '部署完成',\n    message: '生产环境已更新到最新版本',\n    type: 'success',\n    duration: 4500,\n  })\n}\n</script>\n\n<template>\n  <ep-button @click=\"notify\">发送通知</ep-button>\n</template>",
+        "id": "notification-1",
+        "language": "vue",
+        "title": "基础通知"
+      },
+      {
+        "code": "import { EpNotification } from 'ep-craft'\n\nEpNotification.warning({\n  title: '磁盘空间不足',\n  message: '请清理日志后重试',\n  position: 'bottom-right',\n})\n\nEpNotification.closeAll()",
+        "id": "notification-2",
+        "language": "ts",
+        "title": "关闭全部通知"
+      }
+    ],
+    "id": "service:notification",
+    "keywords": {
+      "en": [
+        "notification",
+        "notice",
+        "alert",
+        "message"
+      ],
+      "zh": [
+        "通知",
+        "提醒",
+        "消息",
+        "角落通知"
+      ]
+    },
+    "kind": "service",
+    "methods": [
+      {
+        "description": "按类型创建通知的快捷方法",
+        "name": "success / warning / error / info / primary",
+        "signature": "(options?: NotificationOptionsTyped) => NotificationHandle"
+      },
+      {
+        "description": "关闭全部通知",
+        "name": "closeAll",
+        "signature": "() => void"
+      },
+      {
+        "description": "重新计算指定位置通知的堆叠偏移",
+        "name": "updateOffsets",
+        "signature": "(position?: NotificationPosition) => void"
+      },
+      {
+        "description": "返回值 NotificationHandle 上的关闭方法",
+        "name": "close",
+        "signature": "(handle.close()) => void"
+      }
+    ],
+    "name": "EpNotification",
+    "options": [
+      {
+        "defaultText": "''",
+        "description": "通知标题",
+        "name": "title",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "defaultText": "''",
+        "description": "通知正文",
+        "name": "message",
+        "required": true,
+        "type": "string | VNode | (() => VNode)"
+      },
+      {
+        "defaultText": "'info'",
+        "description": "通知类型，决定图标与配色",
+        "name": "type",
+        "required": false,
+        "type": "'primary' | 'success' | 'info' | 'warning' | 'error'"
+      },
+      {
+        "defaultText": "'top-right'",
+        "description": "通知出现的屏幕角落",
+        "name": "position",
+        "required": false,
+        "type": "'top-right' | 'top-left' | 'bottom-right' | 'bottom-left'"
+      },
+      {
+        "defaultText": "4500",
+        "description": "自动关闭毫秒数；为 0 时不自动关闭",
+        "name": "duration",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "defaultText": "0",
+        "description": "同一位置通知的顶部偏移",
+        "name": "offset",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "defaultText": "true",
+        "description": "是否显示关闭按钮",
+        "name": "showClose",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "defaultText": null,
+        "description": "点击通知时的回调",
+        "name": "onClick",
+        "required": false,
+        "type": "() => void"
+      },
+      {
+        "defaultText": null,
+        "description": "关闭后的回调",
+        "name": "onClose",
+        "required": false,
+        "type": "(vm: VNode) => void"
+      }
+    ],
+    "slug": "notification",
+    "summary": "角落通知提醒，展示带标题的较完整消息"
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/services/notification.md

@@ -0,0 +1,73 @@
+# EpNotification
+
+`EpNotification(options) 或 EpNotification.success(options)` · feedback（反馈） · `service:notification`
+
+## 摘要
+
+角落通知提醒，展示带标题的较完整消息
+
+## 关键词
+
+- 中文：通知、提醒、消息、角落通知
+- English: notification, notice, alert, message
+
+## 调用方式
+
+- 调用形式：EpNotification(options) 或 EpNotification.success(options)
+- 选项 title（string，默认 ''）：通知标题
+- 选项 message（string | VNode | (() => VNode)，必填，默认 ''）：通知正文
+- 选项 type（'primary' | 'success' | 'info' | 'warning' | 'error'，默认 'info'）：通知类型，决定图标与配色
+- 选项 position（'top-right' | 'top-left' | 'bottom-right' | 'bottom-left'，默认 'top-right'）：通知出现的屏幕角落
+- 选项 duration（number，默认 4500）：自动关闭毫秒数；为 0 时不自动关闭
+- 选项 offset（number，默认 0）：同一位置通知的顶部偏移
+- 选项 showClose（boolean，默认 true）：是否显示关闭按钮
+- 选项 onClick（() => void）：点击通知时的回调
+- 选项 onClose（(vm: VNode) => void）：关闭后的回调
+- 方法 success / warning / error / info / primary(options?: NotificationOptionsTyped) => NotificationHandle：按类型创建通知的快捷方法
+- 方法 closeAll() => void：关闭全部通知
+- 方法 updateOffsets(position?: NotificationPosition) => void：重新计算指定位置通知的堆叠偏移
+- 方法 close(handle.close()) => void：返回值 NotificationHandle 上的关闭方法
+- 约束：onClose 在组件 props 中为必填，但调用时可由服务内部提供，业务侧无需手动传入
+- 约束：通知保留在屏幕角落，不阻断页面操作；确认类交互使用 MessageBox
+- 约束：需要应用上下文时先执行 app.use(EpNotification)
+
+## 示例
+
+### 基础通知
+
+```vue
+<script setup lang="ts">
+import { EpButton, EpNotification } from 'ep-craft'
+
+const notify = () => {
+  EpNotification({
+    title: '部署完成',
+    message: '生产环境已更新到最新版本',
+    type: 'success',
+    duration: 4500,
+  })
+}
+</script>
+
+<template>
+  <ep-button @click="notify">发送通知</ep-button>
+</template>
+```
+
+### 关闭全部通知
+
+```ts
+import { EpNotification } from 'ep-craft'
+
+EpNotification.warning({
+  title: '磁盘空间不足',
+  message: '请清理日志后重试',
+  position: 'bottom-right',
+})
+
+EpNotification.closeAll()
+```
+
+---
+
+ep-craft 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ep-craft",
-  "version": "0.1.41",
+  "version": "0.2.0",
   "description": "A self-contained Vue 3 component library with ep- prefix",
   "type": "module",
   "packageManager": "pnpm@10.34.4",
@@ -45,10 +45,13 @@
       "types": "./dist/icons.d.ts",
       "import": "./dist/icons.js"
     },
+    "./ai/*": "./dist-ai/*",
+    "./package.json": "./package.json",
     "./theme-chalk/*": "./theme-chalk/*"
   },
   "files": [
     "dist",
+    "dist-ai",
     "theme-chalk",
     "LICENSE",
     "THIRD_PARTY_NOTICES.md"
@@ -58,11 +61,18 @@
     "**/*.scss"
   ],
   "scripts": {
-    "build": "vite build && vue-tsc --declaration --emitDeclarationOnly --outDir dist && tsx scripts/rewrite-declarations.ts && tsx scripts/check-element-plus.ts",
+    "build": "vite build && vue-tsc --declaration --emitDeclarationOnly --outDir dist && tsx scripts/rewrite-declarations.ts && tsx scripts/check-element-plus.ts && tsx scripts/gen-ai.ts",
     "typecheck": "vue-tsc -p tsconfig.typecheck.json",
     "check:dist": "tsx scripts/check-element-plus.ts",
     "gen": "tsx scripts/gen-components.ts",
     "gen:check": "tsx scripts/gen-components.ts --check",
+    "gen:ai": "tsx scripts/gen-ai.ts",
+    "gen:ai:check": "tsx scripts/gen-ai.ts --check",
+    "gen:ai:eval": "tsx scripts/eval-ai.ts",
+    "ai:mcp:build": "pnpm --filter ep-craft-mcp build",
+    "ai:mcp:start": "node scripts/start-mcp.mjs",
+    "ai:mcp:test": "pnpm --filter ep-craft-mcp test",
+    "ai:mcp:bench": "pnpm --filter ep-craft-mcp bench",
     "gen:docs": "tsx scripts/gen-docs.ts",
     "verify:autocomplete": "node scripts/verify-autocomplete.mjs",
     "verify:backtop": "node scripts/verify-backtop.mjs",