ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/drawer.json

@@ -0,0 +1,468 @@
+{
+  "entry": {
+    "category": "layout",
+    "events": [
+      {
+        "description": "Drawer 打开的回调",
+        "name": "open",
+        "params": "()"
+      },
+      {
+        "description": "Drawer 打开动画结束时的回调",
+        "name": "opened",
+        "params": "()"
+      },
+      {
+        "description": "Drawer 关闭的回调",
+        "name": "close",
+        "params": "()"
+      },
+      {
+        "description": "Drawer 关闭动画结束时的回调",
+        "name": "closed",
+        "params": "()"
+      },
+      {
+        "description": "Drawer 显示状态变化时触发",
+        "name": "update:modelValue",
+        "params": "(value: boolean)"
+      },
+      {
+        "description": "输入焦点聚焦在 Drawer 内容时的回调",
+        "name": "openAutoFocus",
+        "params": "()"
+      },
+      {
+        "description": "输入焦点从 Drawer 内容失焦时的回调",
+        "name": "closeAutoFocus",
+        "params": "()"
+      },
+      {
+        "description": "开始拖拽调整 Drawer 大小时触发",
+        "name": "resizeStart",
+        "params": "(event: MouseEvent, size: number)"
+      },
+      {
+        "description": "拖拽调整 Drawer 大小过程中触发",
+        "name": "resize",
+        "params": "(event: MouseEvent, size: number)"
+      },
+      {
+        "description": "结束拖拽调整 Drawer 大小时触发",
+        "name": "resizeEnd",
+        "params": "(event: MouseEvent, size: number)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpButton, EpDrawer } 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-drawer v-model=\"visible\" title=\"编辑信息\" size=\"360px\">\n    <p>在抽屉中承载表单或详情。</p>\n  </ep-drawer>\n</template>",
+        "id": "drawer-1",
+        "language": "vue",
+        "title": "基础抽屉"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "关闭 Drawer",
+        "name": "handleClose",
+        "type": "() => void"
+      }
+    ],
+    "hot": true,
+    "id": "component:drawer",
+    "keywords": {
+      "en": [
+        "drawer",
+        "side-panel",
+        "sheet",
+        "layout"
+      ],
+      "zh": [
+        "抽屉",
+        "侧边栏",
+        "浮层",
+        "布局"
+      ]
+    },
+    "kind": "component",
+    "name": "EpDrawer",
+    "nonUseCases": [
+      "已有明确外层布局且无需此语义时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "rtl",
+        "description": "Drawer 打开的方向",
+        "hasDefault": true,
+        "name": "direction",
+        "required": false,
+        "type": "'rtl' | 'ltr' | 'ttb' | 'btt'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "resizable",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "'30%'",
+        "description": "Drawer 窗体的大小",
+        "hasDefault": true,
+        "name": "size",
+        "required": false,
+        "type": "number | string"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否显示 header 栏",
+        "hasDefault": true,
+        "name": "withHeader",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "modalFade",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "2",
+        "description": "header 的 aria-level 属性",
+        "hasDefault": true,
+        "name": "headerAriaLevel",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "Drawer 自身是否插入至 body 元素上",
+        "hasDefault": false,
+        "name": "appendToBody",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "appendTo",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "关闭前的回调",
+        "hasDefault": false,
+        "name": "beforeClose",
+        "required": false,
+        "type": "(done: () => void) => void"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "控制是否在关闭 Drawer 之后将子元素全部销毁",
+        "hasDefault": false,
+        "name": "destroyOnClose",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否可以通过点击 modal 关闭 Drawer",
+        "hasDefault": true,
+        "name": "closeOnClickModal",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否可以通过按下 ESC 关闭 Drawer",
+        "hasDefault": true,
+        "name": "closeOnPressEscape",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否在 Drawer 出现时将 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": "0",
+        "description": "Drawer 打开的延时时间",
+        "hasDefault": true,
+        "name": "openDelay",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "Drawer 关闭的延时时间",
+        "hasDefault": true,
+        "name": "closeDelay",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "top",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": "v-model",
+        "defaultText": "false",
+        "description": "是否显示 Drawer",
+        "hasDefault": false,
+        "name": "modelValue",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "遮罩层的自定义类名",
+        "hasDefault": false,
+        "name": "modalClass",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "width",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "设置 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": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "transition",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "center",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "alignCenter",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "closeIcon",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "draggable",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "overflow",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "fullscreen",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "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": "Drawer 的标题",
+        "hasDefault": true,
+        "name": "title",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "ariaLevel",
+        "required": false,
+        "type": "unknown"
+      }
+    ],
+    "related": [
+      "EpDialog"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "Drawer 的内容",
+        "name": "default"
+      },
+      {
+        "description": "Drawer 标题的内容",
+        "name": "header"
+      },
+      {
+        "description": "Drawer 页脚部分",
+        "name": "footer"
+      }
+    ],
+    "slug": "drawer",
+    "summary": "侧边抽屉，承载表单或详情等辅助内容",
+    "tag": "ep-drawer",
+    "useCases": [
+      "从侧边展开筛选、表单或详情",
+      "不打断主页面上下文的编辑"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-bg-color",
+        "--el-border-color",
+        "--el-border-radius-base"
+      ],
+      "density": "宽松",
+      "shape": "侧边浮层",
+      "slotContent": [
+        "default：Drawer 的内容",
+        "header：Drawer 标题的内容",
+        "footer：Drawer 页脚部分"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/drawer.md

@@ -0,0 +1,115 @@
+# EpDrawer
+
+`ep-drawer` · layout（布局） · `component:drawer`
+
+## 摘要
+
+侧边抽屉，承载表单或详情等辅助内容
+
+## 适用场景
+
+- 适用：从侧边展开筛选、表单或详情
+- 适用：不打断主页面上下文的编辑
+- 不适用：已有明确外层布局且无需此语义时
+
+## 关键词
+
+- 中文：抽屉、侧边栏、浮层、布局
+- English: drawer, side-panel, sheet, layout
+
+## Props
+
+- direction ('rtl' | 'ltr' | 'ttb' | 'btt'，默认 rtl)：Drawer 打开的方向
+- resizable (unknown)
+- size (number | string，默认 '30%')：Drawer 窗体的大小
+- withHeader (boolean，默认 true)：是否显示 header 栏
+- modalFade (unknown，默认 见文档)
+- headerAriaLevel (string，默认 2)：header 的 aria-level 属性
+- appendToBody (boolean)：Drawer 自身是否插入至 body 元素上
+- appendTo (unknown，默认 见文档)
+- beforeClose ((done: () => void) => void)：关闭前的回调
+- destroyOnClose (boolean)：控制是否在关闭 Drawer 之后将子元素全部销毁
+- closeOnClickModal (boolean，默认 true)：是否可以通过点击 modal 关闭 Drawer
+- closeOnPressEscape (boolean，默认 true)：是否可以通过按下 ESC 关闭 Drawer
+- lockScroll (boolean，默认 true)：是否在 Drawer 出现时将 body 滚动锁定
+- modal (boolean，默认 true)：是否需要遮罩层
+- modalPenetrable (unknown)
+- openDelay (number，默认 0)：Drawer 打开的延时时间
+- closeDelay (number，默认 0)：Drawer 关闭的延时时间
+- top (unknown)
+- modelValue（别名 v-model） (boolean)：是否显示 Drawer
+- modalClass (string)：遮罩层的自定义类名
+- width (unknown)
+- zIndex (number)：设置 z-index
+- trapFocus (unknown)
+- transition (unknown，默认 见文档)
+- center (unknown)
+- alignCenter (unknown，默认 见文档)
+- closeIcon (unknown)
+- draggable (unknown，默认 见文档)
+- overflow (unknown，默认 见文档)
+- fullscreen (unknown)
+- headerClass (unknown)
+- bodyClass (unknown)
+- footerClass (unknown)
+- showClose (boolean，默认 true)：是否显示关闭按钮
+- title (string，默认 '')：Drawer 的标题
+- ariaLevel (unknown，默认 见文档)
+
+## Events
+
+- open(())：Drawer 打开的回调
+- opened(())：Drawer 打开动画结束时的回调
+- close(())：Drawer 关闭的回调
+- closed(())：Drawer 关闭动画结束时的回调
+- update:modelValue((value: boolean))：Drawer 显示状态变化时触发
+- openAutoFocus(())：输入焦点聚焦在 Drawer 内容时的回调
+- closeAutoFocus(())：输入焦点从 Drawer 内容失焦时的回调
+- resizeStart((event: MouseEvent, size: number))：开始拖拽调整 Drawer 大小时触发
+- resize((event: MouseEvent, size: number))：拖拽调整 Drawer 大小过程中触发
+- resizeEnd((event: MouseEvent, size: number))：结束拖拽调整 Drawer 大小时触发
+
+## Slots
+
+- default：Drawer 的内容
+- header：Drawer 标题的内容
+- footer：Drawer 页脚部分
+
+## Exposes
+
+- handleClose(() => void)：关闭 Drawer
+
+## 视觉提示
+
+- 形状：侧边浮层
+- 密度：宽松
+- 插槽内容：default：Drawer 的内容；header：Drawer 标题的内容；footer：Drawer 页脚部分
+- CSS 变量：--el-bg-color、--el-border-color、--el-border-radius-base
+
+## 示例
+
+### 基础抽屉
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { EpButton, EpDrawer } from 'ep-craft'
+
+const visible = ref(false)
+</script>
+
+<template>
+  <ep-button type="primary" @click="visible = true">打开抽屉</ep-button>
+  <ep-drawer v-model="visible" title="编辑信息" size="360px">
+    <p>在抽屉中承载表单或详情。</p>
+  </ep-drawer>
+</template>
+```
+
+## 相关条目
+
+- EpDialog
+
+---
+
+ep-craft 0.2.0