ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/col.json

@@ -0,0 +1,168 @@
+{
+  "entry": {
+    "category": "layout",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpCol, EpRow } from 'ep-craft'\n</script>\n\n<template>\n  <ep-row :gutter=\"16\">\n    <ep-col :span=\"12\"><div class=\"grid-cell\">12 / 24</div></ep-col>\n    <ep-col :span=\"12\"><div class=\"grid-cell\">12 / 24</div></ep-col>\n  </ep-row>\n</template>",
+        "id": "col-1",
+        "language": "vue",
+        "title": "栅格列"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:col",
+    "keywords": {
+      "en": [
+        "col",
+        "grid",
+        "layout"
+      ],
+      "zh": [
+        "列",
+        "布局"
+      ]
+    },
+    "kind": "component",
+    "name": "EpCol",
+    "nonUseCases": [
+      "已有明确外层布局且无需此语义时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "div",
+        "description": "自定义元素标签",
+        "hasDefault": true,
+        "name": "tag",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "24",
+        "description": "栅格占据的列数",
+        "hasDefault": true,
+        "name": "span",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "栅格左侧的间隔格数",
+        "hasDefault": true,
+        "name": "offset",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "栅格向左移动格数",
+        "hasDefault": true,
+        "name": "pull",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "栅格向右移动格数",
+        "hasDefault": true,
+        "name": "push",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "{}",
+        "description": "`<768px` 响应式格数或栅格属性对象",
+        "hasDefault": true,
+        "name": "xs",
+        "required": false,
+        "type": "number | object"
+      },
+      {
+        "alias": null,
+        "defaultText": "{}",
+        "description": "`≥768px` 响应式格数或栅格属性对象",
+        "hasDefault": true,
+        "name": "sm",
+        "required": false,
+        "type": "number | object"
+      },
+      {
+        "alias": null,
+        "defaultText": "{}",
+        "description": "`≥992px` 响应式格数或栅格属性对象",
+        "hasDefault": true,
+        "name": "md",
+        "required": false,
+        "type": "number | object"
+      },
+      {
+        "alias": null,
+        "defaultText": "{}",
+        "description": "`≥1200px` 响应式格数或栅格属性对象",
+        "hasDefault": true,
+        "name": "lg",
+        "required": false,
+        "type": "number | object"
+      },
+      {
+        "alias": null,
+        "defaultText": "{}",
+        "description": "`≥1920px` 响应式格数或栅格属性对象",
+        "hasDefault": true,
+        "name": "xl",
+        "required": false,
+        "type": "number | object"
+      }
+    ],
+    "related": [
+      "EpRow"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [
+        "EpRow + EpCol"
+      ],
+      "parents": [
+        "EpRow"
+      ],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "列内容",
+        "name": "default"
+      }
+    ],
+    "slug": "col",
+    "summary": "列，页面结构与浮层交互",
+    "tag": "ep-col",
+    "useCases": [
+      "使用列组织页面区域与间距",
+      "承载内容分组或浮层交互"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-bg-color",
+        "--el-border-color",
+        "--el-border-radius-base"
+      ],
+      "density": "宽松",
+      "shape": "区块容器",
+      "slotContent": [
+        "default：列内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/col.md

@@ -0,0 +1,72 @@
+# EpCol
+
+`ep-col` · layout（布局） · `component:col`
+
+## 摘要
+
+列，页面结构与浮层交互
+
+## 适用场景
+
+- 适用：使用列组织页面区域与间距
+- 适用：承载内容分组或浮层交互
+- 不适用：已有明确外层布局且无需此语义时
+
+## 关键词
+
+- 中文：列、布局
+- English: col, grid, layout
+
+## Props
+
+- tag (string，默认 div)：自定义元素标签
+- span (number，默认 24)：栅格占据的列数
+- offset (number，默认 0)：栅格左侧的间隔格数
+- pull (number，默认 0)：栅格向左移动格数
+- push (number，默认 0)：栅格向右移动格数
+- xs (number | object，默认 {})：`<768px` 响应式格数或栅格属性对象
+- sm (number | object，默认 {})：`≥768px` 响应式格数或栅格属性对象
+- md (number | object，默认 {})：`≥992px` 响应式格数或栅格属性对象
+- lg (number | object，默认 {})：`≥1200px` 响应式格数或栅格属性对象
+- xl (number | object，默认 {})：`≥1920px` 响应式格数或栅格属性对象
+
+## Slots
+
+- default：列内容
+
+## 关系
+
+- 父级：EpRow
+- 常用组合：EpRow + EpCol
+
+## 视觉提示
+
+- 形状：区块容器
+- 密度：宽松
+- 插槽内容：default：列内容
+- CSS 变量：--el-bg-color、--el-border-color、--el-border-radius-base
+
+## 示例
+
+### 栅格列
+
+```vue
+<script setup lang="ts">
+import { EpCol, EpRow } from 'ep-craft'
+</script>
+
+<template>
+  <ep-row :gutter="16">
+    <ep-col :span="12"><div class="grid-cell">12 / 24</div></ep-col>
+    <ep-col :span="12"><div class="grid-cell">12 / 24</div></ep-col>
+  </ep-row>
+</template>
+```
+
+## 相关条目
+
+- EpRow
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/collapse-item.json

@@ -0,0 +1,133 @@
+{
+  "entry": {
+    "category": "basic",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpCollapse, EpCollapseItem } from 'ep-craft'\n\nconst activeNames = ref(['item-1'])\n</script>\n\n<template>\n  <ep-collapse v-model=\"activeNames\">\n    <ep-collapse-item title=\"可展开项\" name=\"item-1\">展开后显示的内容</ep-collapse-item>\n    <ep-collapse-item title=\"禁用项\" name=\"item-2\" disabled>不可展开</ep-collapse-item>\n  </ep-collapse>\n</template>",
+        "id": "collapse-item-1",
+        "language": "vue",
+        "title": "折叠面板项"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:collapse-item",
+    "keywords": {
+      "en": [
+        "collapse-item",
+        "collapse",
+        "item",
+        "basic"
+      ],
+      "zh": [
+        "折叠面板项",
+        "基础"
+      ]
+    },
+    "kind": "component",
+    "name": "EpCollapseItem",
+    "nonUseCases": [
+      "需要完全自定义原生行为或视觉时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "面板标题",
+        "hasDefault": true,
+        "name": "title",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "面板唯一标识",
+        "hasDefault": false,
+        "name": "name",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": "ArrowRight",
+        "description": "面板图标",
+        "hasDefault": true,
+        "name": "icon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否禁用",
+        "hasDefault": false,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      }
+    ],
+    "related": [
+      "EpCollapse"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [
+        "EpCollapse + EpCollapseItem"
+      ],
+      "parents": [
+        "EpCollapse"
+      ],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "面板内容",
+        "name": "default"
+      },
+      {
+        "description": "自定义面板标题",
+        "name": "title"
+      },
+      {
+        "description": "自定义面板图标",
+        "name": "icon"
+      }
+    ],
+    "slug": "collapse-item",
+    "summary": "折叠面板项，基础交互与展示元素",
+    "tag": "ep-collapse-item",
+    "useCases": [
+      "页面中的折叠面板项展示与交互",
+      "为折叠面板项提供统一视觉与状态"
+    ],
+    "variants": [
+      {
+        "dimension": "state",
+        "values": [
+          "disabled"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-color-primary",
+        "--el-border-radius-base",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "圆角矩形",
+      "slotContent": [
+        "default：面板内容",
+        "title：自定义面板标题",
+        "icon：自定义面板图标"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/collapse-item.md

@@ -0,0 +1,75 @@
+# EpCollapseItem
+
+`ep-collapse-item` · basic（基础） · `component:collapse-item`
+
+## 摘要
+
+折叠面板项，基础交互与展示元素
+
+## 适用场景
+
+- 适用：页面中的折叠面板项展示与交互
+- 适用：为折叠面板项提供统一视觉与状态
+- 不适用：需要完全自定义原生行为或视觉时
+
+## 关键词
+
+- 中文：折叠面板项、基础
+- English: collapse-item, collapse, item, basic
+
+## 变体
+
+- state: disabled（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- title (string，默认 '')：面板标题
+- name (string | number)：面板唯一标识
+- icon (string | Component，默认 ArrowRight)：面板图标
+- disabled (boolean)：是否禁用
+
+## Slots
+
+- default：面板内容
+- title：自定义面板标题
+- icon：自定义面板图标
+
+## 关系
+
+- 父级：EpCollapse
+- 常用组合：EpCollapse + EpCollapseItem
+
+## 视觉提示
+
+- 形状：圆角矩形
+- 密度：中等
+- 插槽内容：default：面板内容；title：自定义面板标题；icon：自定义面板图标
+- CSS 变量：--el-color-primary、--el-border-radius-base、--el-font-size-base
+
+## 示例
+
+### 折叠面板项
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { EpCollapse, EpCollapseItem } from 'ep-craft'
+
+const activeNames = ref(['item-1'])
+</script>
+
+<template>
+  <ep-collapse v-model="activeNames">
+    <ep-collapse-item title="可展开项" name="item-1">展开后显示的内容</ep-collapse-item>
+    <ep-collapse-item title="禁用项" name="item-2" disabled>不可展开</ep-collapse-item>
+  </ep-collapse>
+</template>
+```
+
+## 相关条目
+
+- EpCollapse
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/collapse-transition.json

@@ -0,0 +1,75 @@
+{
+  "entry": {
+    "category": "basic",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpButton, EpCollapseTransition } from 'ep-craft'\n\nconst visible = ref(true)\n</script>\n\n<template>\n  <ep-button @click=\"visible = !visible\">切换内容</ep-button>\n  <ep-collapse-transition>\n    <div v-show=\"visible\" style=\"padding: 12px; border: 1px solid var(--el-border-color)\">\n      带折叠过渡的内容\n    </div>\n  </ep-collapse-transition>\n</template>",
+        "id": "collapse-transition-1",
+        "language": "vue",
+        "title": "折叠过渡"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:collapse-transition",
+    "keywords": {
+      "en": [
+        "collapse-transition",
+        "collapse",
+        "transition",
+        "animation",
+        "basic"
+      ],
+      "zh": [
+        "折叠过渡",
+        "基础"
+      ]
+    },
+    "kind": "component",
+    "name": "EpCollapseTransition",
+    "nonUseCases": [
+      "需要完全自定义原生行为或视觉时"
+    ],
+    "props": [],
+    "related": [
+      "EpCollapse"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "需要折叠过渡的内容",
+        "name": "default"
+      }
+    ],
+    "slug": "collapse-transition",
+    "summary": "折叠过渡，基础交互与展示元素",
+    "tag": "ep-collapse-transition",
+    "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/collapse-transition.md

@@ -0,0 +1,59 @@
+# EpCollapseTransition
+
+`ep-collapse-transition` · basic（基础） · `component:collapse-transition`
+
+## 摘要
+
+折叠过渡，基础交互与展示元素
+
+## 适用场景
+
+- 适用：页面中的折叠过渡展示与交互
+- 适用：为折叠过渡提供统一视觉与状态
+- 不适用：需要完全自定义原生行为或视觉时
+
+## 关键词
+
+- 中文：折叠过渡、基础
+- English: collapse-transition, collapse, transition, animation, basic
+
+## Slots
+
+- default：需要折叠过渡的内容
+
+## 视觉提示
+
+- 形状：圆角矩形
+- 密度：中等
+- 插槽内容：default：需要折叠过渡的内容
+- CSS 变量：--el-color-primary、--el-border-radius-base、--el-font-size-base
+
+## 示例
+
+### 折叠过渡
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { EpButton, EpCollapseTransition } from 'ep-craft'
+
+const visible = ref(true)
+</script>
+
+<template>
+  <ep-button @click="visible = !visible">切换内容</ep-button>
+  <ep-collapse-transition>
+    <div v-show="visible" style="padding: 12px; border: 1px solid var(--el-border-color)">
+      带折叠过渡的内容
+    </div>
+  </ep-collapse-transition>
+</template>
+```
+
+## 相关条目
+
+- EpCollapse
+
+---
+
+ep-craft 0.2.0