ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/dialog.json

@@ -0,0 +1,403 @@
+{
+  "entry": {
+    "category": "layout",
+    "events": [
+      {
+        "description": "Dialog 打开的回调",
+        "name": "open",
+        "params": "()"
+      },
+      {
+        "description": "Dialog 打开动画结束时的回调",
+        "name": "opened",
+        "params": "()"
+      },
+      {
+        "description": "Dialog 关闭的回调",
+        "name": "close",
+        "params": "()"
+      },
+      {
+        "description": "Dialog 关闭动画结束时的回调",
+        "name": "closed",
+        "params": "()"
+      },
+      {
+        "description": "Dialog 显示状态变化时触发",
+        "name": "update:modelValue",
+        "params": "(value: boolean)"
+      },
+      {
+        "description": "输入焦点聚焦在 Dialog 内容时的回调",
+        "name": "openAutoFocus",
+        "params": "()"
+      },
+      {
+        "description": "输入焦点从 Dialog 内容失焦时的回调",
+        "name": "closeAutoFocus",
+        "params": "()"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpButton, EpDialog } from 'ep-craft'\n\nconst visible = ref(false)\n</script>\n\n<template>\n  <ep-button type=\"primary\" @click=\"visible = true\">打开对话框</ep-button>\n  <ep-dialog v-model=\"visible\" title=\"提示\" width=\"420px\">\n    <p>这里是一段对话框内容。</p>\n    <template #footer>\n      <ep-button @click=\"visible = false\">取消</ep-button>\n      <ep-button type=\"primary\" @click=\"visible = false\">确定</ep-button>\n    </template>\n  </ep-dialog>\n</template>",
+        "id": "dialog-1",
+        "language": "vue",
+        "title": "基础对话框"
+      }
+    ],
+    "exposes": [],
+    "hot": true,
+    "id": "component:dialog",
+    "keywords": {
+      "en": [
+        "dialog",
+        "modal",
+        "popup",
+        "layout"
+      ],
+      "zh": [
+        "对话框",
+        "弹窗",
+        "模态框",
+        "布局"
+      ]
+    },
+    "kind": "component",
+    "name": "EpDialog",
+    "nonUseCases": [
+      "轻量提示使用 Message 或 Alert"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "Dialog 自身是否插入至 body 元素上",
+        "hasDefault": false,
+        "name": "appendToBody",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "body",
+        "description": "Dialog 挂载到哪个 DOM 元素",
+        "hasDefault": true,
+        "name": "appendTo",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "关闭前的回调",
+        "hasDefault": false,
+        "name": "beforeClose",
+        "required": false,
+        "type": "(done: () => void) => void"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "关闭时销毁 Dialog 中的元素",
+        "hasDefault": false,
+        "name": "destroyOnClose",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否可以通过点击 modal 关闭 Dialog",
+        "hasDefault": true,
+        "name": "closeOnClickModal",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否可以通过按下 ESC 关闭 Dialog",
+        "hasDefault": true,
+        "name": "closeOnPressEscape",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否在 Dialog 出现时将 body 滚动锁定",
+        "hasDefault": true,
+        "name": "lockScroll",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否需要遮罩层",
+        "hasDefault": true,
+        "name": "modal",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "modalPenetrable",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "openDelay",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "closeDelay",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "15vh",
+        "description": "Dialog CSS 中的 margin-top 值",
+        "hasDefault": false,
+        "name": "top",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": "v-model",
+        "defaultText": null,
+        "description": "是否显示 Dialog",
+        "hasDefault": false,
+        "name": "modelValue",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "遮罩的自定义类名",
+        "hasDefault": false,
+        "name": "modalClass",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "50%",
+        "description": "Dialog 的宽度",
+        "hasDefault": false,
+        "name": "width",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "Dialog 的 z-index",
+        "hasDefault": false,
+        "name": "zIndex",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "trapFocus",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "2",
+        "description": "header 的 aria-level 属性",
+        "hasDefault": true,
+        "name": "headerAriaLevel",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "transition",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否让 Dialog 的 header 和 footer 部分居中排列",
+        "hasDefault": false,
+        "name": "center",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否水平垂直对齐对话框",
+        "hasDefault": true,
+        "name": "alignCenter",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "Close",
+        "description": "自定义关闭图标",
+        "hasDefault": false,
+        "name": "closeIcon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否可拖拽",
+        "hasDefault": true,
+        "name": "draggable",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "拖动范围可以超出可视区",
+        "hasDefault": true,
+        "name": "overflow",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否为全屏 Dialog",
+        "hasDefault": false,
+        "name": "fullscreen",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "headerClass",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "bodyClass",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "footerClass",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否显示关闭按钮",
+        "hasDefault": true,
+        "name": "showClose",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "Dialog 对话框的标题",
+        "hasDefault": true,
+        "name": "title",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "ariaLevel",
+        "required": false,
+        "type": "unknown"
+      }
+    ],
+    "related": [
+      "EpMessageBox",
+      "EpDrawer"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "Dialog 的内容",
+        "name": "default"
+      },
+      {
+        "description": "对话框标题的内容",
+        "name": "header"
+      },
+      {
+        "description": "Dialog 按钮操作区的内容",
+        "name": "footer"
+      }
+    ],
+    "slug": "dialog",
+    "summary": "模态对话框，承载重要信息与确认操作",
+    "tag": "ep-dialog",
+    "useCases": [
+      "需要用户确认的关键操作",
+      "承载独立表单或详情内容"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-bg-color",
+        "--el-border-color",
+        "--el-border-radius-base"
+      ],
+      "density": "宽松",
+      "shape": "居中浮层卡片",
+      "slotContent": [
+        "default：Dialog 的内容",
+        "header：对话框标题的内容",
+        "footer：Dialog 按钮操作区的内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/dialog.md

@@ -0,0 +1,108 @@
+# EpDialog
+
+`ep-dialog` · layout（布局） · `component:dialog`
+
+## 摘要
+
+模态对话框，承载重要信息与确认操作
+
+## 适用场景
+
+- 适用：需要用户确认的关键操作
+- 适用：承载独立表单或详情内容
+- 不适用：轻量提示使用 Message 或 Alert
+
+## 关键词
+
+- 中文：对话框、弹窗、模态框、布局
+- English: dialog, modal, popup, layout
+
+## Props
+
+- appendToBody (boolean)：Dialog 自身是否插入至 body 元素上
+- appendTo (string，默认 body)：Dialog 挂载到哪个 DOM 元素
+- beforeClose ((done: () => void) => void)：关闭前的回调
+- destroyOnClose (boolean)：关闭时销毁 Dialog 中的元素
+- closeOnClickModal (boolean，默认 true)：是否可以通过点击 modal 关闭 Dialog
+- closeOnPressEscape (boolean，默认 true)：是否可以通过按下 ESC 关闭 Dialog
+- lockScroll (boolean，默认 true)：是否在 Dialog 出现时将 body 滚动锁定
+- modal (boolean，默认 true)：是否需要遮罩层
+- modalPenetrable (unknown)
+- openDelay (unknown，默认 见文档)
+- closeDelay (unknown，默认 见文档)
+- top (string)：Dialog CSS 中的 margin-top 值
+- modelValue（别名 v-model） (boolean)：是否显示 Dialog
+- modalClass (string)：遮罩的自定义类名
+- width (string | number)：Dialog 的宽度
+- zIndex (number)：Dialog 的 z-index
+- trapFocus (unknown)
+- headerAriaLevel (string，默认 2)：header 的 aria-level 属性
+- transition (unknown，默认 见文档)
+- center (boolean)：是否让 Dialog 的 header 和 footer 部分居中排列
+- alignCenter (boolean，默认 false)：是否水平垂直对齐对话框
+- closeIcon (string | Component)：自定义关闭图标
+- draggable (boolean，默认 false)：是否可拖拽
+- overflow (boolean，默认 false)：拖动范围可以超出可视区
+- fullscreen (boolean)：是否为全屏 Dialog
+- headerClass (unknown)
+- bodyClass (unknown)
+- footerClass (unknown)
+- showClose (boolean，默认 true)：是否显示关闭按钮
+- title (string，默认 '')：Dialog 对话框的标题
+- ariaLevel (unknown，默认 见文档)
+
+## Events
+
+- open(())：Dialog 打开的回调
+- opened(())：Dialog 打开动画结束时的回调
+- close(())：Dialog 关闭的回调
+- closed(())：Dialog 关闭动画结束时的回调
+- update:modelValue((value: boolean))：Dialog 显示状态变化时触发
+- openAutoFocus(())：输入焦点聚焦在 Dialog 内容时的回调
+- closeAutoFocus(())：输入焦点从 Dialog 内容失焦时的回调
+
+## Slots
+
+- default：Dialog 的内容
+- header：对话框标题的内容
+- footer：Dialog 按钮操作区的内容
+
+## 视觉提示
+
+- 形状：居中浮层卡片
+- 密度：宽松
+- 插槽内容：default：Dialog 的内容；header：对话框标题的内容；footer：Dialog 按钮操作区的内容
+- CSS 变量：--el-bg-color、--el-border-color、--el-border-radius-base
+
+## 示例
+
+### 基础对话框
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { EpButton, EpDialog } from 'ep-craft'
+
+const visible = ref(false)
+</script>
+
+<template>
+  <ep-button type="primary" @click="visible = true">打开对话框</ep-button>
+  <ep-dialog v-model="visible" title="提示" width="420px">
+    <p>这里是一段对话框内容。</p>
+    <template #footer>
+      <ep-button @click="visible = false">取消</ep-button>
+      <ep-button type="primary" @click="visible = false">确定</ep-button>
+    </template>
+  </ep-dialog>
+</template>
+```
+
+## 相关条目
+
+- EpMessageBox
+- EpDrawer
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/divider.json

@@ -0,0 +1,102 @@
+{
+  "entry": {
+    "category": "basic",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpDivider } from 'ep-craft'\n</script>\n\n<template>\n  <div>上方内容</div>\n  <ep-divider>分组</ep-divider>\n  <div>下方内容</div>\n</template>",
+        "id": "divider-1",
+        "language": "vue",
+        "title": "分割线"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:divider",
+    "keywords": {
+      "en": [
+        "divider",
+        "separator",
+        "line",
+        "basic"
+      ],
+      "zh": [
+        "分割线",
+        "基础"
+      ]
+    },
+    "kind": "component",
+    "name": "EpDivider",
+    "nonUseCases": [
+      "需要完全自定义原生行为或视觉时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "horizontal",
+        "description": "设置分割线方向",
+        "hasDefault": true,
+        "name": "direction",
+        "required": false,
+        "type": "'horizontal' | 'vertical'"
+      },
+      {
+        "alias": null,
+        "defaultText": "center",
+        "description": "自定义分隔线内容的位置",
+        "hasDefault": true,
+        "name": "contentPosition",
+        "required": false,
+        "type": "'left' | 'right' | 'center'"
+      },
+      {
+        "alias": null,
+        "defaultText": "solid",
+        "description": "设置分隔符样式",
+        "hasDefault": true,
+        "name": "borderStyle",
+        "required": false,
+        "type": "'none' | 'solid' | 'hidden' | 'dashed' | ..."
+      }
+    ],
+    "related": [
+      "EpSpace"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "设置分割线文案的位置",
+        "name": "default"
+      }
+    ],
+    "slug": "divider",
+    "summary": "分割线，基础交互与展示元素",
+    "tag": "ep-divider",
+    "useCases": [
+      "页面中的分割线展示与交互",
+      "为分割线提供统一视觉与状态"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-color-primary",
+        "--el-border-radius-base",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "圆角矩形",
+      "slotContent": [
+        "default：设置分割线文案的位置"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/divider.md

@@ -0,0 +1,59 @@
+# EpDivider
+
+`ep-divider` · basic（基础） · `component:divider`
+
+## 摘要
+
+分割线，基础交互与展示元素
+
+## 适用场景
+
+- 适用：页面中的分割线展示与交互
+- 适用：为分割线提供统一视觉与状态
+- 不适用：需要完全自定义原生行为或视觉时
+
+## 关键词
+
+- 中文：分割线、基础
+- English: divider, separator, line, basic
+
+## Props
+
+- direction ('horizontal' | 'vertical'，默认 horizontal)：设置分割线方向
+- contentPosition ('left' | 'right' | 'center'，默认 center)：自定义分隔线内容的位置
+- borderStyle ('none' | 'solid' | 'hidden' | 'dashed' | ...，默认 solid)：设置分隔符样式
+
+## Slots
+
+- default：设置分割线文案的位置
+
+## 视觉提示
+
+- 形状：圆角矩形
+- 密度：中等
+- 插槽内容：default：设置分割线文案的位置
+- CSS 变量：--el-color-primary、--el-border-radius-base、--el-font-size-base
+
+## 示例
+
+### 分割线
+
+```vue
+<script setup lang="ts">
+import { EpDivider } from 'ep-craft'
+</script>
+
+<template>
+  <div>上方内容</div>
+  <ep-divider>分组</ep-divider>
+  <div>下方内容</div>
+</template>
+```
+
+## 相关条目
+
+- EpSpace
+
+---
+
+ep-craft 0.2.0