ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/progress.json

@@ -0,0 +1,219 @@
+{
+  "entry": {
+    "category": "feedback",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpProgress } from 'ep-craft'\n</script>\n\n<template>\n  <ep-progress :percentage=\"60\" />\n</template>",
+        "id": "progress-1",
+        "language": "vue",
+        "title": "进度条"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:progress",
+    "keywords": {
+      "en": [
+        "progress",
+        "bar",
+        "feedback"
+      ],
+      "zh": [
+        "进度条",
+        "反馈"
+      ]
+    },
+    "kind": "component",
+    "name": "EpProgress",
+    "nonUseCases": [
+      "无需用户感知状态变化时",
+      "需要完整业务弹窗流程时优先使用 Dialog"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "line",
+        "description": "进度条类型",
+        "hasDefault": true,
+        "name": "type",
+        "required": false,
+        "type": "'line' | 'circle' | 'dashboard'"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "百分比",
+        "hasDefault": true,
+        "name": "percentage",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "进度条当前状态",
+        "hasDefault": true,
+        "name": "status",
+        "required": false,
+        "type": "'success' | 'exception' | 'warning'"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否为动画进度条",
+        "hasDefault": false,
+        "name": "indeterminate",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "3",
+        "description": "控制动画进度条速度",
+        "hasDefault": true,
+        "name": "duration",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "6",
+        "description": "进度条的宽度",
+        "hasDefault": true,
+        "name": "strokeWidth",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "strokeLinecap",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "进度条显示文字内置在进度条内",
+        "hasDefault": false,
+        "name": "textInside",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "126",
+        "description": "环形进度条画布宽度",
+        "hasDefault": true,
+        "name": "width",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否显示进度条文字内容",
+        "hasDefault": true,
+        "name": "showText",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "进度条背景色",
+        "hasDefault": true,
+        "name": "color",
+        "required": false,
+        "type": "string | Function | Array"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "在进度条上增加条纹",
+        "hasDefault": false,
+        "name": "striped",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "让进度条上的条纹流动起来",
+        "hasDefault": false,
+        "name": "stripedFlow",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "指定进度条文字内容",
+        "hasDefault": true,
+        "name": "format",
+        "required": false,
+        "type": "(percentage: number) => string"
+      }
+    ],
+    "related": [
+      "EpLoading"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义内容",
+        "name": "default"
+      }
+    ],
+    "slug": "progress",
+    "summary": "进度条，状态与结果反馈",
+    "tag": "ep-progress",
+    "useCases": [
+      "展示进度条并向用户传达状态",
+      "在操作前后提供即时反馈"
+    ],
+    "variants": [
+      {
+        "dimension": "type",
+        "values": [
+          "line",
+          "circle",
+          "dashboard"
+        ],
+        "when": "通过 type 选择进度条类型"
+      },
+      {
+        "dimension": "state",
+        "values": [
+          "indeterminate"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-color-success",
+        "--el-color-warning",
+        "--el-color-danger",
+        "--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/progress.md

@@ -0,0 +1,74 @@
+# EpProgress
+
+`ep-progress` · feedback（反馈） · `component:progress`
+
+## 摘要
+
+进度条，状态与结果反馈
+
+## 适用场景
+
+- 适用：展示进度条并向用户传达状态
+- 适用：在操作前后提供即时反馈
+- 不适用：无需用户感知状态变化时
+- 不适用：需要完整业务弹窗流程时优先使用 Dialog
+
+## 关键词
+
+- 中文：进度条、反馈
+- English: progress, bar, feedback
+
+## 变体
+
+- type: line/circle/dashboard（通过 type 选择进度条类型）
+- state: indeterminate（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- type ('line' | 'circle' | 'dashboard'，默认 line)：进度条类型
+- percentage (number，默认 0)：百分比
+- status ('success' | 'exception' | 'warning'，默认 见文档)：进度条当前状态
+- indeterminate (boolean)：是否为动画进度条
+- duration (number，默认 3)：控制动画进度条速度
+- strokeWidth (number，默认 6)：进度条的宽度
+- strokeLinecap (unknown，默认 见文档)
+- textInside (boolean)：进度条显示文字内置在进度条内
+- width (number，默认 126)：环形进度条画布宽度
+- showText (boolean，默认 true)：是否显示进度条文字内容
+- color (string | Function | Array，默认 见文档)：进度条背景色
+- striped (boolean)：在进度条上增加条纹
+- stripedFlow (boolean)：让进度条上的条纹流动起来
+- format ((percentage: number) => string，默认 见文档)：指定进度条文字内容
+
+## Slots
+
+- default：自定义内容
+
+## 视觉提示
+
+- 形状：行内或块级提示
+- 密度：中等
+- 插槽内容：default：自定义内容
+- CSS 变量：--el-color-success、--el-color-warning、--el-color-danger、--el-font-size-base
+
+## 示例
+
+### 进度条
+
+```vue
+<script setup lang="ts">
+import { EpProgress } from 'ep-craft'
+</script>
+
+<template>
+  <ep-progress :percentage="60" />
+</template>
+```
+
+## 相关条目
+
+- EpLoading
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/radio-button.json

@@ -0,0 +1,142 @@
+{
+  "entry": {
+    "category": "form",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpRadioButton, EpRadioGroup } from 'ep-craft'\n\nconst value = ref('day')\n</script>\n\n<template>\n  <ep-radio-group v-model=\"value\">\n    <ep-radio-button value=\"day\">日</ep-radio-button>\n    <ep-radio-button value=\"week\">周</ep-radio-button>\n    <ep-radio-button value=\"month\">月</ep-radio-button>\n  </ep-radio-group>\n</template>",
+        "id": "radio-button-1",
+        "language": "vue",
+        "title": "单选按钮"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:radio-button",
+    "keywords": {
+      "en": [
+        "radio-button",
+        "radio",
+        "button",
+        "form"
+      ],
+      "zh": [
+        "单选按钮",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpRadioButton",
+    "nonUseCases": [
+      "仅展示静态文本或只读数据时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "modelValue",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "size",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否禁用",
+        "hasDefault": true,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "单选框的值（已废弃）",
+        "hasDefault": true,
+        "name": "label",
+        "required": false,
+        "type": "string | number | boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "单选框的值",
+        "hasDefault": true,
+        "name": "value",
+        "required": false,
+        "type": "string | number | boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 name 属性",
+        "hasDefault": true,
+        "name": "name",
+        "required": false,
+        "type": "string"
+      }
+    ],
+    "related": [
+      "EpRadioGroup"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [
+        "EpRadioGroup + EpRadioButton"
+      ],
+      "parents": [
+        "EpRadioGroup"
+      ],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义默认内容",
+        "name": "default"
+      }
+    ],
+    "slug": "radio-button",
+    "summary": "单选按钮，表单数据录入控件",
+    "tag": "ep-radio-button",
+    "useCases": [
+      "表单中收集或编辑单选按钮数据",
+      "与 EpForm、EpFormItem 组合完成校验"
+    ],
+    "variants": [
+      {
+        "dimension": "state",
+        "values": [
+          "disabled"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-border-color",
+        "--el-border-radius-base",
+        "--el-color-primary",
+        "--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/radio-button.md

@@ -0,0 +1,76 @@
+# EpRadioButton
+
+`ep-radio-button` · form（表单） · `component:radio-button`
+
+## 摘要
+
+单选按钮，表单数据录入控件
+
+## 适用场景
+
+- 适用：表单中收集或编辑单选按钮数据
+- 适用：与 EpForm、EpFormItem 组合完成校验
+- 不适用：仅展示静态文本或只读数据时
+
+## 关键词
+
+- 中文：单选按钮、表单
+- English: radio-button, radio, button, form
+
+## 变体
+
+- state: disabled（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- modelValue (unknown，默认 见文档)
+- size (unknown)
+- disabled (boolean，默认 false)：是否禁用
+- label (string | number | boolean，默认 见文档)：单选框的值（已废弃）
+- value (string | number | boolean，默认 见文档)：单选框的值
+- name (string，默认 见文档)：原生 name 属性
+
+## Slots
+
+- default：自定义默认内容
+
+## 关系
+
+- 父级：EpRadioGroup
+- 常用组合：EpRadioGroup + EpRadioButton
+
+## 视觉提示
+
+- 形状：矩形输入框
+- 密度：中等
+- 插槽内容：default：自定义默认内容
+- CSS 变量：--el-border-color、--el-border-radius-base、--el-color-primary、--el-font-size-base
+
+## 示例
+
+### 单选按钮
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { EpRadioButton, EpRadioGroup } from 'ep-craft'
+
+const value = ref('day')
+</script>
+
+<template>
+  <ep-radio-group v-model="value">
+    <ep-radio-button value="day">日</ep-radio-button>
+    <ep-radio-button value="week">周</ep-radio-button>
+    <ep-radio-button value="month">月</ep-radio-button>
+  </ep-radio-group>
+</template>
+```
+
+## 相关条目
+
+- EpRadioGroup
+
+---
+
+ep-craft 0.2.0