ep-craft 0.1.42 → 0.2.0

package/dist-ai/services/infinite-scroll.json

@@ -0,0 +1,80 @@
+{
+  "entry": {
+    "callForm": "v-infinite-scroll=\"load\"（同时可通过 EpInfiniteScroll 安装）",
+    "category": "interaction",
+    "constraints": [
+      "回调在内容不足以填满容器时也会立即触发，需用 disabled 或加载中状态防止重复请求",
+      "只监听向下的滚动；向上滚动不会触发加载",
+      "需要可滚动的父容器或目标元素自身具有滚动区域"
+    ],
+    "directiveId": "directive:infinite-scroll",
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "import { createApp } from 'vue'\nimport { EpInfiniteScroll } from 'ep-craft'\nimport App from './App.vue'\n\ncreateApp(App).use(EpInfiniteScroll).mount('#app')",
+        "id": "infinite-scroll-1",
+        "language": "ts",
+        "title": "注册无限滚动"
+      },
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { vInfiniteScroll } from 'ep-craft'\n\nconst items = ref(Array.from({ length: 20 }, (_, index) => `条目 ${index + 1}`))\nconst loading = ref(false)\n\nconst load = () => {\n  if (loading.value) return\n  loading.value = true\n  setTimeout(() => {\n    const start = items.value.length\n    items.value.push(...Array.from({ length: 10 }, (_, index) => `条目 ${start + index + 1}`))\n    loading.value = false\n  }, 300)\n}\n</script>\n\n<template>\n  <div\n    v-infinite-scroll=\"load\"\n    infinite-scroll-distance=\"20\"\n    style=\"height: 240px; overflow: auto\"\n  >\n    <p v-for=\"item in items\" :key=\"item\">{{ item }}</p>\n  </div>\n</template>",
+        "id": "infinite-scroll-2",
+        "language": "vue",
+        "title": "加载更多列表"
+      }
+    ],
+    "id": "service:infinite-scroll",
+    "keywords": {
+      "en": [
+        "infinite-scroll",
+        "load-more",
+        "scroll",
+        "pagination"
+      ],
+      "zh": [
+        "无限滚动",
+        "加载更多",
+        "触底",
+        "滚动"
+      ]
+    },
+    "kind": "service",
+    "methods": [],
+    "name": "EpInfiniteScroll",
+    "options": [
+      {
+        "defaultText": "200",
+        "description": "滚动后触发的节流毫秒数，通过 infinite-scroll-delay 设置",
+        "name": "delay",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "defaultText": "0",
+        "description": "距底部多少像素触发，通过 infinite-scroll-distance 设置",
+        "name": "distance",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "defaultText": "false",
+        "description": "是否禁用加载，通过 infinite-scroll-disabled 设置",
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "defaultText": "true",
+        "description": "挂载时是否立即检查内容是否不足以填满容器",
+        "name": "immediate",
+        "required": false,
+        "type": "boolean"
+      }
+    ],
+    "slug": "infinite-scroll",
+    "summary": "无限滚动指令，滚动接近底部时触发加载回调"
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/services/infinite-scroll.md

@@ -0,0 +1,71 @@
+# EpInfiniteScroll
+
+`v-infinite-scroll="load"（同时可通过 EpInfiniteScroll 安装）` · interaction（交互） · `service:infinite-scroll`
+
+## 摘要
+
+无限滚动指令，滚动接近底部时触发加载回调
+
+## 关键词
+
+- 中文：无限滚动、加载更多、触底、滚动
+- English: infinite-scroll, load-more, scroll, pagination
+
+## 调用方式
+
+- 调用形式：v-infinite-scroll="load"（同时可通过 EpInfiniteScroll 安装）
+- 选项 delay（number，默认 200）：滚动后触发的节流毫秒数，通过 infinite-scroll-delay 设置
+- 选项 distance（number，默认 0）：距底部多少像素触发，通过 infinite-scroll-distance 设置
+- 选项 disabled（boolean，默认 false）：是否禁用加载，通过 infinite-scroll-disabled 设置
+- 选项 immediate（boolean，默认 true）：挂载时是否立即检查内容是否不足以填满容器
+- 约束：回调在内容不足以填满容器时也会立即触发，需用 disabled 或加载中状态防止重复请求
+- 约束：只监听向下的滚动；向上滚动不会触发加载
+- 约束：需要可滚动的父容器或目标元素自身具有滚动区域
+
+## 示例
+
+### 注册无限滚动
+
+```ts
+import { createApp } from 'vue'
+import { EpInfiniteScroll } from 'ep-craft'
+import App from './App.vue'
+
+createApp(App).use(EpInfiniteScroll).mount('#app')
+```
+
+### 加载更多列表
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { vInfiniteScroll } from 'ep-craft'
+
+const items = ref(Array.from({ length: 20 }, (_, index) => `条目 ${index + 1}`))
+const loading = ref(false)
+
+const load = () => {
+  if (loading.value) return
+  loading.value = true
+  setTimeout(() => {
+    const start = items.value.length
+    items.value.push(...Array.from({ length: 10 }, (_, index) => `条目 ${start + index + 1}`))
+    loading.value = false
+  }, 300)
+}
+</script>
+
+<template>
+  <div
+    v-infinite-scroll="load"
+    infinite-scroll-distance="20"
+    style="height: 240px; overflow: auto"
+  >
+    <p v-for="item in items" :key="item">{{ item }}</p>
+  </div>
+</template>
+```
+
+---
+
+ep-craft 0.2.0

package/dist-ai/services/loading.json

@@ -0,0 +1,108 @@
+{
+  "entry": {
+    "callForm": "EpLoading.service(options) 或 v-loading=\"loading\"",
+    "category": "feedback",
+    "constraints": [
+      "EpLoading.service 返回实例，请求结束后必须调用实例的 close()",
+      "v-loading 适用于模板内的局部加载，service 适用于页面级或无法访问模板的异步流程",
+      "同一目标重复创建实例会叠加遮罩，应复用实例或先关闭旧实例"
+    ],
+    "directiveId": "directive:loading",
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpButton, EpLoading } from 'ep-craft'\nimport type { LoadingInstance } from 'ep-craft'\n\nlet instance: LoadingInstance | null = null\n\nconst start = async () => {\n  instance = EpLoading.service({ target: document.body, text: '加载中' })\n  await new Promise((resolve) => setTimeout(resolve, 1000))\n  instance?.close()\n  instance = null\n}\n</script>\n\n<template>\n  <ep-button type=\"primary\" :loading=\"instance !== null\" @click=\"start\">\n    加载数据\n  </ep-button>\n</template>",
+        "id": "loading-1",
+        "language": "vue",
+        "title": "服务方式加载"
+      }
+    ],
+    "id": "service:loading",
+    "keywords": {
+      "en": [
+        "loading",
+        "spinner",
+        "mask",
+        "service"
+      ],
+      "zh": [
+        "加载",
+        "等待",
+        "遮罩",
+        "loading"
+      ]
+    },
+    "kind": "service",
+    "methods": [
+      {
+        "description": "关闭本次通过 service 创建的加载实例",
+        "name": "close",
+        "signature": "() => void"
+      }
+    ],
+    "name": "EpLoading",
+    "options": [
+      {
+        "defaultText": "document.body",
+        "description": "需要覆盖的目标元素或选择器",
+        "name": "target",
+        "required": false,
+        "type": "HTMLElement | string"
+      },
+      {
+        "defaultText": "false",
+        "description": "是否覆盖整个 body，等价于 fullscreen 用法",
+        "name": "body",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "defaultText": "false",
+        "description": "是否全屏显示加载遮罩",
+        "name": "fullscreen",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "defaultText": "false",
+        "description": "是否锁定页面滚动",
+        "name": "lock",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "defaultText": "''",
+        "description": "加载图标下方的文字",
+        "name": "text",
+        "required": false,
+        "type": "string | VNode | VNode[]"
+      },
+      {
+        "defaultText": "false",
+        "description": "自定义加载图标类名",
+        "name": "spinner",
+        "required": false,
+        "type": "boolean | string"
+      },
+      {
+        "defaultText": null,
+        "description": "遮罩背景色",
+        "name": "background",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "defaultText": "''",
+        "description": "加载遮罩的自定义类名",
+        "name": "customClass",
+        "required": false,
+        "type": "string"
+      }
+    ],
+    "slug": "loading",
+    "summary": "加载服务，在目标区域或全屏展示等待遮罩"
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/services/loading.md

@@ -0,0 +1,58 @@
+# EpLoading
+
+`EpLoading.service(options) 或 v-loading="loading"` · feedback（反馈） · `service:loading`
+
+## 摘要
+
+加载服务，在目标区域或全屏展示等待遮罩
+
+## 关键词
+
+- 中文：加载、等待、遮罩、loading
+- English: loading, spinner, mask, service
+
+## 调用方式
+
+- 调用形式：EpLoading.service(options) 或 v-loading="loading"
+- 选项 target（HTMLElement | string，默认 document.body）：需要覆盖的目标元素或选择器
+- 选项 body（boolean，默认 false）：是否覆盖整个 body，等价于 fullscreen 用法
+- 选项 fullscreen（boolean，默认 false）：是否全屏显示加载遮罩
+- 选项 lock（boolean，默认 false）：是否锁定页面滚动
+- 选项 text（string | VNode | VNode[]，默认 ''）：加载图标下方的文字
+- 选项 spinner（boolean | string，默认 false）：自定义加载图标类名
+- 选项 background（string）：遮罩背景色
+- 选项 customClass（string，默认 ''）：加载遮罩的自定义类名
+- 方法 close() => void：关闭本次通过 service 创建的加载实例
+- 约束：EpLoading.service 返回实例，请求结束后必须调用实例的 close()
+- 约束：v-loading 适用于模板内的局部加载，service 适用于页面级或无法访问模板的异步流程
+- 约束：同一目标重复创建实例会叠加遮罩，应复用实例或先关闭旧实例
+
+## 示例
+
+### 服务方式加载
+
+```vue
+<script setup lang="ts">
+import { EpButton, EpLoading } from 'ep-craft'
+import type { LoadingInstance } from 'ep-craft'
+
+let instance: LoadingInstance | null = null
+
+const start = async () => {
+  instance = EpLoading.service({ target: document.body, text: '加载中' })
+  await new Promise((resolve) => setTimeout(resolve, 1000))
+  instance?.close()
+  instance = null
+}
+</script>
+
+<template>
+  <ep-button type="primary" :loading="instance !== null" @click="start">
+    加载数据
+  </ep-button>
+</template>
+```
+
+---
+
+ep-craft 0.2.0

package/dist-ai/services/message-box.json

@@ -0,0 +1,159 @@
+{
+  "entry": {
+    "callForm": "EpMessageBox.confirm(message, title, options) → Promise",
+    "category": "feedback",
+    "constraints": [
+      "confirm 与 prompt 在用户取消时 Promise 会 reject，调用方必须捕获或处理取消分支",
+      "消息框是模态交互，不应在循环或高频事件中重复弹出",
+      "需要自定义复杂表单时使用 EpDialog 组件而不是 prompt"
+    ],
+    "directiveId": null,
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpButton, EpMessageBox } from 'ep-craft'\n\nconst remove = async () => {\n  try {\n    await EpMessageBox.confirm('删除后无法恢复，是否继续？', '删除确认', {\n      type: 'warning',\n      confirmButtonText: '删除',\n      cancelButtonText: '取消',\n    })\n    EpMessageBox.close()\n  } catch {\n    // 用户取消\n  }\n}\n</script>\n\n<template>\n  <ep-button type=\"danger\" @click=\"remove\">删除</ep-button>\n</template>",
+        "id": "message-box-1",
+        "language": "vue",
+        "title": "确认操作"
+      },
+      {
+        "code": "import { EpMessageBox } from 'ep-craft'\n\nconst { value } = await EpMessageBox.prompt('请输入项目名称', '新建项目', {\n  inputPlaceholder: '例如：营销活动页',\n  confirmButtonText: '创建',\n})\nconsole.log(value)",
+        "id": "message-box-2",
+        "language": "ts",
+        "title": "输入提示"
+      }
+    ],
+    "id": "service:message-box",
+    "keywords": {
+      "en": [
+        "message-box",
+        "confirm",
+        "alert",
+        "prompt",
+        "modal"
+      ],
+      "zh": [
+        "消息框",
+        "确认框",
+        "警告",
+        "输入框",
+        "弹窗"
+      ]
+    },
+    "kind": "service",
+    "methods": [
+      {
+        "description": "只有确认按钮的警告框",
+        "name": "alert",
+        "signature": "(message: string | VNode, title?: string, options?: MessageBoxOptions) => Promise<MessageBoxData>"
+      },
+      {
+        "description": "带确认与取消按钮的确认框；取消时 Promise reject",
+        "name": "confirm",
+        "signature": "(message: string | VNode, title?: string, options?: MessageBoxOptions) => Promise<MessageBoxData>"
+      },
+      {
+        "description": "带输入框的提示框",
+        "name": "prompt",
+        "signature": "(message: string | VNode, title?: string, options?: MessageBoxOptions) => Promise<MessageBoxData>"
+      },
+      {
+        "description": "关闭当前全部消息框实例",
+        "name": "close",
+        "signature": "() => void"
+      }
+    ],
+    "name": "EpMessageBox",
+    "options": [
+      {
+        "defaultText": "''",
+        "description": "消息框标题",
+        "name": "title",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "defaultText": "''",
+        "description": "消息框正文",
+        "name": "message",
+        "required": true,
+        "type": "string | VNode | ((params) => VNode)"
+      },
+      {
+        "defaultText": "''",
+        "description": "标题前的状态图标类型",
+        "name": "type",
+        "required": false,
+        "type": "'success' | 'info' | 'warning' | 'error'"
+      },
+      {
+        "defaultText": "'确定'",
+        "description": "确认按钮文案",
+        "name": "confirmButtonText",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "defaultText": "'取消'",
+        "description": "取消按钮文案",
+        "name": "cancelButtonText",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "defaultText": "false",
+        "description": "是否显示取消按钮",
+        "name": "showCancelButton",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "defaultText": "false",
+        "description": "是否显示输入框，prompt 默认开启",
+        "name": "showInput",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "defaultText": "''",
+        "description": "输入框占位文本",
+        "name": "inputPlaceholder",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "defaultText": "true",
+        "description": "点击遮罩是否关闭",
+        "name": "closeOnClickModal",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "defaultText": "true",
+        "description": "按 Esc 是否关闭",
+        "name": "closeOnPressEscape",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "defaultText": "false",
+        "description": "内容是否居中",
+        "name": "center",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "defaultText": "false",
+        "description": "是否允许拖拽消息框",
+        "name": "draggable",
+        "required": false,
+        "type": "boolean"
+      }
+    ],
+    "slug": "message-box",
+    "summary": "模态消息框，用于确认、警告与输入"
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/services/message-box.md

@@ -0,0 +1,78 @@
+# EpMessageBox
+
+`EpMessageBox.confirm(message, title, options) → Promise` · feedback（反馈） · `service:message-box`
+
+## 摘要
+
+模态消息框，用于确认、警告与输入
+
+## 关键词
+
+- 中文：消息框、确认框、警告、输入框、弹窗
+- English: message-box, confirm, alert, prompt, modal
+
+## 调用方式
+
+- 调用形式：EpMessageBox.confirm(message, title, options) → Promise
+- 选项 title（string，默认 ''）：消息框标题
+- 选项 message（string | VNode | ((params) => VNode)，必填，默认 ''）：消息框正文
+- 选项 type（'success' | 'info' | 'warning' | 'error'，默认 ''）：标题前的状态图标类型
+- 选项 confirmButtonText（string，默认 '确定'）：确认按钮文案
+- 选项 cancelButtonText（string，默认 '取消'）：取消按钮文案
+- 选项 showCancelButton（boolean，默认 false）：是否显示取消按钮
+- 选项 showInput（boolean，默认 false）：是否显示输入框，prompt 默认开启
+- 选项 inputPlaceholder（string，默认 ''）：输入框占位文本
+- 选项 closeOnClickModal（boolean，默认 true）：点击遮罩是否关闭
+- 选项 closeOnPressEscape（boolean，默认 true）：按 Esc 是否关闭
+- 选项 center（boolean，默认 false）：内容是否居中
+- 选项 draggable（boolean，默认 false）：是否允许拖拽消息框
+- 方法 alert(message: string | VNode, title?: string, options?: MessageBoxOptions) => Promise<MessageBoxData>：只有确认按钮的警告框
+- 方法 confirm(message: string | VNode, title?: string, options?: MessageBoxOptions) => Promise<MessageBoxData>：带确认与取消按钮的确认框；取消时 Promise reject
+- 方法 prompt(message: string | VNode, title?: string, options?: MessageBoxOptions) => Promise<MessageBoxData>：带输入框的提示框
+- 方法 close() => void：关闭当前全部消息框实例
+- 约束：confirm 与 prompt 在用户取消时 Promise 会 reject，调用方必须捕获或处理取消分支
+- 约束：消息框是模态交互，不应在循环或高频事件中重复弹出
+- 约束：需要自定义复杂表单时使用 EpDialog 组件而不是 prompt
+
+## 示例
+
+### 确认操作
+
+```vue
+<script setup lang="ts">
+import { EpButton, EpMessageBox } from 'ep-craft'
+
+const remove = async () => {
+  try {
+    await EpMessageBox.confirm('删除后无法恢复，是否继续？', '删除确认', {
+      type: 'warning',
+      confirmButtonText: '删除',
+      cancelButtonText: '取消',
+    })
+    EpMessageBox.close()
+  } catch {
+    // 用户取消
+  }
+}
+</script>
+
+<template>
+  <ep-button type="danger" @click="remove">删除</ep-button>
+</template>
+```
+
+### 输入提示
+
+```ts
+import { EpMessageBox } from 'ep-craft'
+
+const { value } = await EpMessageBox.prompt('请输入项目名称', '新建项目', {
+  inputPlaceholder: '例如：营销活动页',
+  confirmButtonText: '创建',
+})
+console.log(value)
+```
+
+---
+
+ep-craft 0.2.0