ep-craft 0.1.42 → 0.2.0

package/dist-ai/components/badge.json

@@ -0,0 +1,186 @@
+{
+  "entry": {
+    "category": "basic",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpBadge, EpButton } from 'ep-craft'\n</script>\n\n<template>\n  <ep-badge :value=\"12\">\n    <ep-button>消息</ep-button>\n  </ep-badge>\n</template>",
+        "id": "badge-1",
+        "language": "vue",
+        "title": "数字标记"
+      },
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpBadge, EpButton } from 'ep-craft'\n</script>\n\n<template>\n  <ep-badge is-dot>\n    <ep-button>通知</ep-button>\n  </ep-badge>\n</template>",
+        "id": "badge-2",
+        "language": "vue",
+        "title": "红点标记"
+      }
+    ],
+    "exposes": [],
+    "hot": true,
+    "id": "component:badge",
+    "keywords": {
+      "en": [
+        "badge",
+        "dot",
+        "count",
+        "basic"
+      ],
+      "zh": [
+        "徽章",
+        "角标",
+        "未读",
+        "基础"
+      ]
+    },
+    "kind": "component",
+    "name": "EpBadge",
+    "nonUseCases": [
+      "需要完全自定义原生行为或视觉时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "显示值",
+        "hasDefault": true,
+        "name": "value",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": "99",
+        "description": "最大值，超过最大值会显示 {max}+",
+        "hasDefault": true,
+        "name": "max",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否显示小圆点",
+        "hasDefault": false,
+        "name": "isDot",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否隐藏 Badge",
+        "hasDefault": false,
+        "name": "hidden",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "danger",
+        "description": "Badge 类型",
+        "hasDefault": true,
+        "name": "type",
+        "required": false,
+        "type": "'primary' | 'success' | 'warning' | 'danger' | 'info'"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "值为零时是否显示 Badge",
+        "hasDefault": true,
+        "name": "showZero",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "背景色",
+        "hasDefault": false,
+        "name": "color",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "Badge 的自定义样式",
+        "hasDefault": true,
+        "name": "badgeStyle",
+        "required": false,
+        "type": "object"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "Badge 的偏移量",
+        "hasDefault": true,
+        "name": "offset",
+        "required": false,
+        "type": "[number, number]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "Badge 的自定义类名",
+        "hasDefault": false,
+        "name": "badgeClass",
+        "required": false,
+        "type": "string"
+      }
+    ],
+    "related": [
+      "EpAvatar",
+      "EpTag"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义默认内容",
+        "name": "default"
+      }
+    ],
+    "slug": "badge",
+    "summary": "徽章，在元素角标上显示数量或状态",
+    "tag": "ep-badge",
+    "useCases": [
+      "消息未读数量",
+      "状态点与角标标记"
+    ],
+    "variants": [
+      {
+        "dimension": "type",
+        "values": [
+          "primary",
+          "success",
+          "warning",
+          "danger",
+          "info"
+        ],
+        "when": "通过 type 选择Badge 类型"
+      }
+    ],
+    "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/badge.md

@@ -0,0 +1,85 @@
+# EpBadge
+
+`ep-badge` · basic（基础） · `component:badge`
+
+## 摘要
+
+徽章，在元素角标上显示数量或状态
+
+## 适用场景
+
+- 适用：消息未读数量
+- 适用：状态点与角标标记
+- 不适用：需要完全自定义原生行为或视觉时
+
+## 关键词
+
+- 中文：徽章、角标、未读、基础
+- English: badge, dot, count, basic
+
+## 变体
+
+- type: primary/success/warning/danger/info（通过 type 选择Badge 类型）
+
+## Props
+
+- value (string | number，默认 '')：显示值
+- max (number，默认 99)：最大值，超过最大值会显示 {max}+
+- isDot (boolean)：是否显示小圆点
+- hidden (boolean)：是否隐藏 Badge
+- type ('primary' | 'success' | 'warning' | 'danger' | 'info'，默认 danger)：Badge 类型
+- showZero (boolean，默认 true)：值为零时是否显示 Badge
+- color (string)：背景色
+- badgeStyle (object，默认 见文档)：Badge 的自定义样式
+- offset ([number, number]，默认 见文档)：Badge 的偏移量
+- badgeClass (string)：Badge 的自定义类名
+
+## Slots
+
+- default：自定义默认内容
+
+## 视觉提示
+
+- 形状：圆角矩形
+- 密度：中等
+- 插槽内容：default：自定义默认内容
+- CSS 变量：--el-color-primary、--el-border-radius-base、--el-font-size-base
+
+## 示例
+
+### 数字标记
+
+```vue
+<script setup lang="ts">
+import { EpBadge, EpButton } from 'ep-craft'
+</script>
+
+<template>
+  <ep-badge :value="12">
+    <ep-button>消息</ep-button>
+  </ep-badge>
+</template>
+```
+
+### 红点标记
+
+```vue
+<script setup lang="ts">
+import { EpBadge, EpButton } from 'ep-craft'
+</script>
+
+<template>
+  <ep-badge is-dot>
+    <ep-button>通知</ep-button>
+  </ep-badge>
+</template>
+```
+
+## 相关条目
+
+- EpAvatar
+- EpTag
+
+---
+
+ep-craft 0.2.0

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

@@ -0,0 +1,97 @@
+{
+  "entry": {
+    "category": "navigation",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpBreadcrumb, EpBreadcrumbItem } from 'ep-craft'\n</script>\n\n<template>\n  <ep-breadcrumb separator=\"/\">\n    <ep-breadcrumb-item to=\"/\">首页</ep-breadcrumb-item>\n    <ep-breadcrumb-item to=\"/components\">组件</ep-breadcrumb-item>\n    <ep-breadcrumb-item>面包屑</ep-breadcrumb-item>\n  </ep-breadcrumb>\n</template>",
+        "id": "breadcrumb-item-1",
+        "language": "vue",
+        "title": "面包屑路径"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:breadcrumb-item",
+    "keywords": {
+      "en": [
+        "breadcrumb-item",
+        "breadcrumb",
+        "item",
+        "navigation"
+      ],
+      "zh": [
+        "面包屑项",
+        "导航"
+      ]
+    },
+    "kind": "component",
+    "name": "EpBreadcrumbItem",
+    "nonUseCases": [
+      "单步无层级的简单跳转时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "目标路由，同 vue-router 的 to",
+        "hasDefault": true,
+        "name": "to",
+        "required": false,
+        "type": "string | object"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "跳转时是否不留下历史记录",
+        "hasDefault": false,
+        "name": "replace",
+        "required": false,
+        "type": "boolean"
+      }
+    ],
+    "related": [
+      "EpBreadcrumb"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [
+        "EpBreadcrumb + EpBreadcrumbItem"
+      ],
+      "parents": [
+        "EpBreadcrumb"
+      ],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "面包屑项内容",
+        "name": "default"
+      }
+    ],
+    "slug": "breadcrumb-item",
+    "summary": "面包屑项，页面导航与定位",
+    "tag": "ep-breadcrumb-item",
+    "useCases": [
+      "在页面或模块间使用面包屑项导航",
+      "指示当前位置与层级"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-color-primary",
+        "--el-text-color-regular",
+        "--el-bg-color"
+      ],
+      "density": "中等",
+      "shape": "条状或列表",
+      "slotContent": [
+        "default：面包屑项内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

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

@@ -0,0 +1,65 @@
+# EpBreadcrumbItem
+
+`ep-breadcrumb-item` · navigation（导航） · `component:breadcrumb-item`
+
+## 摘要
+
+面包屑项，页面导航与定位
+
+## 适用场景
+
+- 适用：在页面或模块间使用面包屑项导航
+- 适用：指示当前位置与层级
+- 不适用：单步无层级的简单跳转时
+
+## 关键词
+
+- 中文：面包屑项、导航
+- English: breadcrumb-item, breadcrumb, item, navigation
+
+## Props
+
+- to (string | object，默认 '')：目标路由，同 vue-router 的 to
+- replace (boolean)：跳转时是否不留下历史记录
+
+## Slots
+
+- default：面包屑项内容
+
+## 关系
+
+- 父级：EpBreadcrumb
+- 常用组合：EpBreadcrumb + EpBreadcrumbItem
+
+## 视觉提示
+
+- 形状：条状或列表
+- 密度：中等
+- 插槽内容：default：面包屑项内容
+- CSS 变量：--el-color-primary、--el-text-color-regular、--el-bg-color
+
+## 示例
+
+### 面包屑路径
+
+```vue
+<script setup lang="ts">
+import { EpBreadcrumb, EpBreadcrumbItem } from 'ep-craft'
+</script>
+
+<template>
+  <ep-breadcrumb separator="/">
+    <ep-breadcrumb-item to="/">首页</ep-breadcrumb-item>
+    <ep-breadcrumb-item to="/components">组件</ep-breadcrumb-item>
+    <ep-breadcrumb-item>面包屑</ep-breadcrumb-item>
+  </ep-breadcrumb>
+</template>
+```
+
+## 相关条目
+
+- EpBreadcrumb
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/breadcrumb.json

@@ -0,0 +1,100 @@
+{
+  "entry": {
+    "category": "navigation",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpBreadcrumb, EpBreadcrumbItem } from 'ep-craft'\n</script>\n\n<template>\n  <ep-breadcrumb separator=\"/\">\n    <ep-breadcrumb-item to=\"/\">首页</ep-breadcrumb-item>\n    <ep-breadcrumb-item to=\"/components\">组件</ep-breadcrumb-item>\n    <ep-breadcrumb-item>面包屑</ep-breadcrumb-item>\n  </ep-breadcrumb>\n</template>",
+        "id": "breadcrumb-1",
+        "language": "vue",
+        "title": "面包屑路径"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:breadcrumb",
+    "keywords": {
+      "en": [
+        "breadcrumb",
+        "path",
+        "navigation"
+      ],
+      "zh": [
+        "面包屑",
+        "导航"
+      ]
+    },
+    "kind": "component",
+    "name": "EpBreadcrumb",
+    "nonUseCases": [
+      "单步无层级的简单跳转时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "/",
+        "description": "分隔符",
+        "hasDefault": true,
+        "name": "separator",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "分隔符图标组件",
+        "hasDefault": false,
+        "name": "separatorIcon",
+        "required": false,
+        "type": "string | Component"
+      }
+    ],
+    "related": [
+      "EpMenu",
+      "EpPageHeader",
+      "EpBreadcrumbItem"
+    ],
+    "relations": {
+      "children": [
+        "EpBreadcrumbItem"
+      ],
+      "combos": [
+        "EpBreadcrumb + EpBreadcrumbItem"
+      ],
+      "parents": [],
+      "requiredChildren": [
+        "EpBreadcrumbItem"
+      ]
+    },
+    "slots": [
+      {
+        "description": "面包屑内容，通常放置 ep-breadcrumb-item",
+        "name": "default"
+      }
+    ],
+    "slug": "breadcrumb",
+    "summary": "面包屑，页面导航与定位",
+    "tag": "ep-breadcrumb",
+    "useCases": [
+      "在页面或模块间使用面包屑导航",
+      "指示当前位置与层级"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-color-primary",
+        "--el-text-color-regular",
+        "--el-bg-color"
+      ],
+      "density": "中等",
+      "shape": "条状或列表",
+      "slotContent": [
+        "default：面包屑内容，通常放置 ep-breadcrumb-item"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/breadcrumb.md

@@ -0,0 +1,68 @@
+# EpBreadcrumb
+
+`ep-breadcrumb` · navigation（导航） · `component:breadcrumb`
+
+## 摘要
+
+面包屑，页面导航与定位
+
+## 适用场景
+
+- 适用：在页面或模块间使用面包屑导航
+- 适用：指示当前位置与层级
+- 不适用：单步无层级的简单跳转时
+
+## 关键词
+
+- 中文：面包屑、导航
+- English: breadcrumb, path, navigation
+
+## Props
+
+- separator (string，默认 /)：分隔符
+- separatorIcon (string | Component)：分隔符图标组件
+
+## Slots
+
+- default：面包屑内容，通常放置 ep-breadcrumb-item
+
+## 关系
+
+- 子级：EpBreadcrumbItem
+- 必需子组件：EpBreadcrumbItem
+- 常用组合：EpBreadcrumb + EpBreadcrumbItem
+
+## 视觉提示
+
+- 形状：条状或列表
+- 密度：中等
+- 插槽内容：default：面包屑内容，通常放置 ep-breadcrumb-item
+- CSS 变量：--el-color-primary、--el-text-color-regular、--el-bg-color
+
+## 示例
+
+### 面包屑路径
+
+```vue
+<script setup lang="ts">
+import { EpBreadcrumb, EpBreadcrumbItem } from 'ep-craft'
+</script>
+
+<template>
+  <ep-breadcrumb separator="/">
+    <ep-breadcrumb-item to="/">首页</ep-breadcrumb-item>
+    <ep-breadcrumb-item to="/components">组件</ep-breadcrumb-item>
+    <ep-breadcrumb-item>面包屑</ep-breadcrumb-item>
+  </ep-breadcrumb>
+</template>
+```
+
+## 相关条目
+
+- EpMenu
+- EpPageHeader
+- EpBreadcrumbItem
+
+---
+
+ep-craft 0.2.0