ep-craft 0.1.42 → 0.2.0

package/dist-ai/components/statistic.json

@@ -0,0 +1,167 @@
+{
+  "entry": {
+    "category": "feedback",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpStatistic } from 'ep-craft'\n</script>\n\n<template>\n  <ep-statistic title=\"本月活跃用户\" :value=\"128600\" />\n</template>",
+        "id": "statistic-1",
+        "language": "vue",
+        "title": "统计数据"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:statistic",
+    "keywords": {
+      "en": [
+        "statistic",
+        "number",
+        "feedback"
+      ],
+      "zh": [
+        "统计数值",
+        "反馈"
+      ]
+    },
+    "kind": "component",
+    "name": "EpStatistic",
+    "nonUseCases": [
+      "无需用户感知状态变化时",
+      "需要完整业务弹窗流程时优先使用 Dialog"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": ".",
+        "description": "小数点符号",
+        "hasDefault": true,
+        "name": "decimalSeparator",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": ",",
+        "description": "千分位分隔符",
+        "hasDefault": true,
+        "name": "groupSeparator",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "数值精度（小数位数）",
+        "hasDefault": true,
+        "name": "precision",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "自定义数值展示函数",
+        "hasDefault": false,
+        "name": "formatter",
+        "required": false,
+        "type": "(...args: any[]) => string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "数值内容",
+        "hasDefault": true,
+        "name": "value",
+        "required": false,
+        "type": "number | Dayjs"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "数值前缀",
+        "hasDefault": false,
+        "name": "prefix",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "数值后缀",
+        "hasDefault": false,
+        "name": "suffix",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "数值标题",
+        "hasDefault": false,
+        "name": "title",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "数值样式",
+        "hasDefault": true,
+        "name": "valueStyle",
+        "required": false,
+        "type": "StyleValue"
+      }
+    ],
+    "related": [
+      "EpCountdown"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义标题",
+        "name": "title"
+      },
+      {
+        "description": "自定义前缀",
+        "name": "prefix"
+      },
+      {
+        "description": "自定义后缀",
+        "name": "suffix"
+      }
+    ],
+    "slug": "statistic",
+    "summary": "统计数值，状态与结果反馈",
+    "tag": "ep-statistic",
+    "useCases": [
+      "展示统计数值并向用户传达状态",
+      "在操作前后提供即时反馈"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-color-success",
+        "--el-color-warning",
+        "--el-color-danger",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "行内或块级提示",
+      "slotContent": [
+        "title：自定义标题",
+        "prefix：自定义前缀",
+        "suffix：自定义后缀"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/statistic.md

@@ -0,0 +1,66 @@
+# EpStatistic
+
+`ep-statistic` · feedback（反馈） · `component:statistic`
+
+## 摘要
+
+统计数值，状态与结果反馈
+
+## 适用场景
+
+- 适用：展示统计数值并向用户传达状态
+- 适用：在操作前后提供即时反馈
+- 不适用：无需用户感知状态变化时
+- 不适用：需要完整业务弹窗流程时优先使用 Dialog
+
+## 关键词
+
+- 中文：统计数值、反馈
+- English: statistic, number, feedback
+
+## Props
+
+- decimalSeparator (string，默认 .)：小数点符号
+- groupSeparator (string，默认 ,)：千分位分隔符
+- precision (number，默认 0)：数值精度（小数位数）
+- formatter ((...args: any[]) => string | number)：自定义数值展示函数
+- value (number | Dayjs，默认 0)：数值内容
+- prefix (string)：数值前缀
+- suffix (string)：数值后缀
+- title (string)：数值标题
+- valueStyle (StyleValue，默认 见文档)：数值样式
+
+## Slots
+
+- title：自定义标题
+- prefix：自定义前缀
+- suffix：自定义后缀
+
+## 视觉提示
+
+- 形状：行内或块级提示
+- 密度：中等
+- 插槽内容：title：自定义标题；prefix：自定义前缀；suffix：自定义后缀
+- CSS 变量：--el-color-success、--el-color-warning、--el-color-danger、--el-font-size-base
+
+## 示例
+
+### 统计数据
+
+```vue
+<script setup lang="ts">
+import { EpStatistic } from 'ep-craft'
+</script>
+
+<template>
+  <ep-statistic title="本月活跃用户" :value="128600" />
+</template>
+```
+
+## 相关条目
+
+- EpCountdown
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/step.json

@@ -0,0 +1,124 @@
+{
+  "entry": {
+    "category": "navigation",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpStep, EpSteps } from 'ep-craft'\n</script>\n\n<template>\n  <ep-steps :active=\"1\">\n    <ep-step title=\"填写信息\" description=\"输入基础资料\" />\n    <ep-step title=\"确认信息\" description=\"核对并提交\" />\n    <ep-step title=\"完成\" description=\"等待审核\" />\n  </ep-steps>\n</template>",
+        "id": "step-1",
+        "language": "vue",
+        "title": "步骤"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:step",
+    "keywords": {
+      "en": [
+        "step",
+        "wizard",
+        "navigation"
+      ],
+      "zh": [
+        "步骤",
+        "导航"
+      ]
+    },
+    "kind": "component",
+    "name": "EpStep",
+    "nonUseCases": [
+      "单步无层级的简单跳转时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "步骤标题",
+        "hasDefault": true,
+        "name": "title",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "步骤自定义图标，也可通过 icon 插槽传入",
+        "hasDefault": true,
+        "name": "icon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "步骤描述",
+        "hasDefault": true,
+        "name": "description",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "当前状态，未配置时由 Steps 自动设置",
+        "hasDefault": true,
+        "name": "status",
+        "required": false,
+        "type": "'' | 'wait' | 'process' | 'finish' | 'error' | 'success'"
+      }
+    ],
+    "related": [
+      "EpSteps"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [
+        "EpSteps + EpStep"
+      ],
+      "parents": [
+        "EpSteps"
+      ],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义步骤图标",
+        "name": "icon"
+      },
+      {
+        "description": "自定义步骤标题",
+        "name": "title"
+      },
+      {
+        "description": "自定义步骤描述",
+        "name": "description"
+      }
+    ],
+    "slug": "step",
+    "summary": "步骤，页面导航与定位",
+    "tag": "ep-step",
+    "useCases": [
+      "在页面或模块间使用步骤导航",
+      "指示当前位置与层级"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-color-primary",
+        "--el-text-color-regular",
+        "--el-bg-color"
+      ],
+      "density": "中等",
+      "shape": "条状或列表",
+      "slotContent": [
+        "icon：自定义步骤图标",
+        "title：自定义步骤标题",
+        "description：自定义步骤描述"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/step.md

@@ -0,0 +1,69 @@
+# EpStep
+
+`ep-step` · navigation（导航） · `component:step`
+
+## 摘要
+
+步骤，页面导航与定位
+
+## 适用场景
+
+- 适用：在页面或模块间使用步骤导航
+- 适用：指示当前位置与层级
+- 不适用：单步无层级的简单跳转时
+
+## 关键词
+
+- 中文：步骤、导航
+- English: step, wizard, navigation
+
+## Props
+
+- title (string，默认 '')：步骤标题
+- icon (string | Component，默认 见文档)：步骤自定义图标，也可通过 icon 插槽传入
+- description (string，默认 '')：步骤描述
+- status ('' | 'wait' | 'process' | 'finish' | 'error' | 'success'，默认 '')：当前状态，未配置时由 Steps 自动设置
+
+## Slots
+
+- icon：自定义步骤图标
+- title：自定义步骤标题
+- description：自定义步骤描述
+
+## 关系
+
+- 父级：EpSteps
+- 常用组合：EpSteps + EpStep
+
+## 视觉提示
+
+- 形状：条状或列表
+- 密度：中等
+- 插槽内容：icon：自定义步骤图标；title：自定义步骤标题；description：自定义步骤描述
+- CSS 变量：--el-color-primary、--el-text-color-regular、--el-bg-color
+
+## 示例
+
+### 步骤
+
+```vue
+<script setup lang="ts">
+import { EpStep, EpSteps } from 'ep-craft'
+</script>
+
+<template>
+  <ep-steps :active="1">
+    <ep-step title="填写信息" description="输入基础资料" />
+    <ep-step title="确认信息" description="核对并提交" />
+    <ep-step title="完成" description="等待审核" />
+  </ep-steps>
+</template>
+```
+
+## 相关条目
+
+- EpSteps
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/steps.json

@@ -0,0 +1,157 @@
+{
+  "entry": {
+    "category": "navigation",
+    "events": [
+      {
+        "description": "当前步骤变化时触发",
+        "name": "change",
+        "params": "(newVal: number, oldVal: number)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpStep, EpSteps } from 'ep-craft'\n</script>\n\n<template>\n  <ep-steps :active=\"1\">\n    <ep-step title=\"填写信息\" description=\"输入基础资料\" />\n    <ep-step title=\"确认信息\" description=\"核对并提交\" />\n    <ep-step title=\"完成\" description=\"等待审核\" />\n  </ep-steps>\n</template>",
+        "id": "steps-1",
+        "language": "vue",
+        "title": "步骤条"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:steps",
+    "keywords": {
+      "en": [
+        "steps",
+        "wizard",
+        "navigation"
+      ],
+      "zh": [
+        "步骤条",
+        "导航"
+      ]
+    },
+    "kind": "component",
+    "name": "EpSteps",
+    "nonUseCases": [
+      "单步无层级的简单跳转时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "每个步骤的间距，支持百分比；缺省时自适应",
+        "hasDefault": true,
+        "name": "space",
+        "required": false,
+        "type": "number | string"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "当前激活的步骤",
+        "hasDefault": true,
+        "name": "active",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "horizontal",
+        "description": "展示方向",
+        "hasDefault": true,
+        "name": "direction",
+        "required": false,
+        "type": "'horizontal' | 'vertical'"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "标题与描述是否居中",
+        "hasDefault": false,
+        "name": "alignCenter",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否应用简洁风格",
+        "hasDefault": false,
+        "name": "simple",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "finish",
+        "description": "结束步骤的状态",
+        "hasDefault": true,
+        "name": "finishStatus",
+        "required": false,
+        "type": "'wait' | 'process' | 'finish' | 'error' | 'success'"
+      },
+      {
+        "alias": null,
+        "defaultText": "process",
+        "description": "当前步骤的状态",
+        "hasDefault": true,
+        "name": "processStatus",
+        "required": false,
+        "type": "'wait' | 'process' | 'finish' | 'error' | 'success'"
+      }
+    ],
+    "related": [
+      "EpStep"
+    ],
+    "relations": {
+      "children": [
+        "EpStep"
+      ],
+      "combos": [
+        "EpSteps + EpStep"
+      ],
+      "parents": [],
+      "requiredChildren": [
+        "EpStep"
+      ]
+    },
+    "slots": [
+      {
+        "description": "步骤内容，通常放置 ep-step",
+        "name": "default"
+      }
+    ],
+    "slug": "steps",
+    "summary": "步骤条，页面导航与定位",
+    "tag": "ep-steps",
+    "useCases": [
+      "在页面或模块间使用步骤条导航",
+      "指示当前位置与层级"
+    ],
+    "variants": [
+      {
+        "dimension": "state",
+        "values": [
+          "active"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-color-primary",
+        "--el-text-color-regular",
+        "--el-bg-color"
+      ],
+      "density": "中等",
+      "shape": "条状或列表",
+      "slotContent": [
+        "default：步骤内容，通常放置 ep-step"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/steps.md

@@ -0,0 +1,79 @@
+# EpSteps
+
+`ep-steps` · navigation（导航） · `component:steps`
+
+## 摘要
+
+步骤条，页面导航与定位
+
+## 适用场景
+
+- 适用：在页面或模块间使用步骤条导航
+- 适用：指示当前位置与层级
+- 不适用：单步无层级的简单跳转时
+
+## 关键词
+
+- 中文：步骤条、导航
+- English: steps, wizard, navigation
+
+## 变体
+
+- state: active（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- space (number | string，默认 '')：每个步骤的间距，支持百分比；缺省时自适应
+- active (number，默认 0)：当前激活的步骤
+- direction ('horizontal' | 'vertical'，默认 horizontal)：展示方向
+- alignCenter (boolean)：标题与描述是否居中
+- simple (boolean)：是否应用简洁风格
+- finishStatus ('wait' | 'process' | 'finish' | 'error' | 'success'，默认 finish)：结束步骤的状态
+- processStatus ('wait' | 'process' | 'finish' | 'error' | 'success'，默认 process)：当前步骤的状态
+
+## Events
+
+- change((newVal: number, oldVal: number))：当前步骤变化时触发
+
+## Slots
+
+- default：步骤内容，通常放置 ep-step
+
+## 关系
+
+- 子级：EpStep
+- 必需子组件：EpStep
+- 常用组合：EpSteps + EpStep
+
+## 视觉提示
+
+- 形状：条状或列表
+- 密度：中等
+- 插槽内容：default：步骤内容，通常放置 ep-step
+- CSS 变量：--el-color-primary、--el-text-color-regular、--el-bg-color
+
+## 示例
+
+### 步骤条
+
+```vue
+<script setup lang="ts">
+import { EpStep, EpSteps } from 'ep-craft'
+</script>
+
+<template>
+  <ep-steps :active="1">
+    <ep-step title="填写信息" description="输入基础资料" />
+    <ep-step title="确认信息" description="核对并提交" />
+    <ep-step title="完成" description="等待审核" />
+  </ep-steps>
+</template>
+```
+
+## 相关条目
+
+- EpStep
+
+---
+
+ep-craft 0.2.0