ep-craft 0.1.42 → 0.2.0

package/dist-ai/components/rate.json

@@ -0,0 +1,286 @@
+{
+  "entry": {
+    "category": "form",
+    "events": [
+      {
+        "description": "分值改变时触发",
+        "name": "change",
+        "params": "(value: number)"
+      },
+      {
+        "description": "绑定值变化时触发",
+        "name": "update:modelValue",
+        "params": "(value: number)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpRate } from 'ep-craft'\n\nconst value = ref(3)\n</script>\n\n<template>\n  <ep-rate v-model=\"value\" allow-half />\n</template>",
+        "id": "rate-1",
+        "language": "vue",
+        "title": "评分"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:rate",
+    "keywords": {
+      "en": [
+        "rate",
+        "star",
+        "rating",
+        "form"
+      ],
+      "zh": [
+        "评分",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpRate",
+    "nonUseCases": [
+      "仅展示静态文本或只读数据时"
+    ],
+    "props": [
+      {
+        "alias": "v-model",
+        "defaultText": "0",
+        "description": "绑定值",
+        "hasDefault": true,
+        "name": "modelValue",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 id 属性",
+        "hasDefault": true,
+        "name": "id",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "2",
+        "description": "低分和中等分数的界限值",
+        "hasDefault": true,
+        "name": "lowThreshold",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "4",
+        "description": "高分和中等分数的界限值",
+        "hasDefault": true,
+        "name": "highThreshold",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "5",
+        "description": "最大分值",
+        "hasDefault": true,
+        "name": "max",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "['#F7BA2A', '#F7BA2A', '#F7BA2A']",
+        "description": "icon 的颜色",
+        "hasDefault": true,
+        "name": "colors",
+        "required": false,
+        "type": "string[] | Record<number, string>"
+      },
+      {
+        "alias": null,
+        "defaultText": "#C6D1DE",
+        "description": "未选中 icon 的颜色",
+        "hasDefault": true,
+        "name": "voidColor",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "#EFF2F7",
+        "description": "只读时未选中 icon 的颜色",
+        "hasDefault": true,
+        "name": "disabledVoidColor",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "[StarFilled, StarFilled, StarFilled]",
+        "description": "图标组件",
+        "hasDefault": true,
+        "name": "icons",
+        "required": false,
+        "type": "string[] | Component[] | Record<number, string | Component>"
+      },
+      {
+        "alias": null,
+        "defaultText": "Star",
+        "description": "未被选中的图标组件",
+        "hasDefault": true,
+        "name": "voidIcon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": "StarFilled",
+        "description": "只读状态下未选中的图标组件",
+        "hasDefault": true,
+        "name": "disabledVoidIcon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否为只读",
+        "hasDefault": true,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否允许半选",
+        "hasDefault": false,
+        "name": "allowHalf",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否显示辅助文字",
+        "hasDefault": false,
+        "name": "showText",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否显示当前分数",
+        "hasDefault": false,
+        "name": "showScore",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "#1F2D3D",
+        "description": "辅助文字的颜色",
+        "hasDefault": true,
+        "name": "textColor",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "['极差', '失望', '一般', '满意', '惊喜']",
+        "description": "辅助文字数组",
+        "hasDefault": true,
+        "name": "texts",
+        "required": false,
+        "type": "string[]"
+      },
+      {
+        "alias": null,
+        "defaultText": "'{value}'",
+        "description": "分数显示模板",
+        "hasDefault": true,
+        "name": "scoreTemplate",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "default",
+        "description": "尺寸",
+        "hasDefault": false,
+        "name": "size",
+        "required": false,
+        "type": "'large' | 'default' | 'small'"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否可以通过点击重置值",
+        "hasDefault": false,
+        "name": "clearable",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "ariaLabel",
+        "required": false,
+        "type": "unknown"
+      }
+    ],
+    "related": [
+      "EpSlider"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [],
+    "slug": "rate",
+    "summary": "评分，表单数据录入控件",
+    "tag": "ep-rate",
+    "useCases": [
+      "表单中收集或编辑评分数据",
+      "与 EpForm、EpFormItem 组合完成校验"
+    ],
+    "variants": [
+      {
+        "dimension": "size",
+        "values": [
+          "large",
+          "default",
+          "small"
+        ],
+        "when": "按容器空间与信息密度选择尺寸"
+      },
+      {
+        "dimension": "state",
+        "values": [
+          "disabled"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-border-color",
+        "--el-border-radius-base",
+        "--el-color-primary",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "矩形输入框",
+      "slotContent": []
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/rate.md

@@ -0,0 +1,83 @@
+# EpRate
+
+`ep-rate` · form（表单） · `component:rate`
+
+## 摘要
+
+评分，表单数据录入控件
+
+## 适用场景
+
+- 适用：表单中收集或编辑评分数据
+- 适用：与 EpForm、EpFormItem 组合完成校验
+- 不适用：仅展示静态文本或只读数据时
+
+## 关键词
+
+- 中文：评分、表单
+- English: rate, star, rating, form
+
+## 变体
+
+- size: large/default/small（按容器空间与信息密度选择尺寸）
+- state: disabled（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- modelValue（别名 v-model） (number，默认 0)：绑定值
+- id (string，默认 见文档)：原生 id 属性
+- lowThreshold (number，默认 2)：低分和中等分数的界限值
+- highThreshold (number，默认 4)：高分和中等分数的界限值
+- max (number，默认 5)：最大分值
+- colors (string[] | Record<number, string>，默认 ['#F7BA2A', '#F7BA2A', '#F7BA2A'])：icon 的颜色
+- voidColor (string，默认 #C6D1DE)：未选中 icon 的颜色
+- disabledVoidColor (string，默认 #EFF2F7)：只读时未选中 icon 的颜色
+- icons (string[] | Component[] | Record<number, string | Component>，默认 [StarFilled, StarFilled, StarFilled])：图标组件
+- voidIcon (string | Component，默认 Star)：未被选中的图标组件
+- disabledVoidIcon (string | Component，默认 StarFilled)：只读状态下未选中的图标组件
+- disabled (boolean，默认 false)：是否为只读
+- allowHalf (boolean)：是否允许半选
+- showText (boolean)：是否显示辅助文字
+- showScore (boolean)：是否显示当前分数
+- textColor (string，默认 #1F2D3D)：辅助文字的颜色
+- texts (string[]，默认 ['极差', '失望', '一般', '满意', '惊喜'])：辅助文字数组
+- scoreTemplate (string，默认 '{value}')：分数显示模板
+- size ('large' | 'default' | 'small')：尺寸
+- clearable (boolean)：是否可以通过点击重置值
+- ariaLabel (unknown)
+
+## Events
+
+- change((value: number))：分值改变时触发
+- update:modelValue((value: number))：绑定值变化时触发
+
+## 视觉提示
+
+- 形状：矩形输入框
+- 密度：中等
+- 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 { EpRate } from 'ep-craft'
+
+const value = ref(3)
+</script>
+
+<template>
+  <ep-rate v-model="value" allow-half />
+</template>
+```
+
+## 相关条目
+
+- EpSlider
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/result.json

@@ -0,0 +1,118 @@
+{
+  "entry": {
+    "category": "feedback",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpButton, EpResult } from 'ep-craft'\n</script>\n\n<template>\n  <ep-result icon=\"success\" title=\"操作成功\" sub-title=\"订单已提交，请等待审核\">\n    <template #extra>\n      <ep-button type=\"primary\">返回列表</ep-button>\n    </template>\n  </ep-result>\n</template>",
+        "id": "result-1",
+        "language": "vue",
+        "title": "操作结果"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:result",
+    "keywords": {
+      "en": [
+        "result",
+        "status",
+        "feedback"
+      ],
+      "zh": [
+        "结果",
+        "反馈"
+      ]
+    },
+    "kind": "component",
+    "name": "EpResult",
+    "nonUseCases": [
+      "无需用户感知状态变化时",
+      "需要完整业务弹窗流程时优先使用 Dialog"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "标题文本",
+        "hasDefault": true,
+        "name": "title",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "副标题文本",
+        "hasDefault": true,
+        "name": "subTitle",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "info",
+        "description": "图标类型",
+        "hasDefault": true,
+        "name": "icon",
+        "required": false,
+        "type": "'primary' | 'success' | 'warning' | 'info' | 'error'"
+      }
+    ],
+    "related": [
+      "EpEmpty",
+      "EpAlert"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义图标",
+        "name": "icon"
+      },
+      {
+        "description": "自定义标题",
+        "name": "title"
+      },
+      {
+        "description": "自定义副标题",
+        "name": "sub-title"
+      },
+      {
+        "description": "自定义操作区",
+        "name": "extra"
+      }
+    ],
+    "slug": "result",
+    "summary": "结果，状态与结果反馈",
+    "tag": "ep-result",
+    "useCases": [
+      "展示结果并向用户传达状态",
+      "在操作前后提供即时反馈"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-color-success",
+        "--el-color-warning",
+        "--el-color-danger",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "行内或块级提示",
+      "slotContent": [
+        "icon：自定义图标",
+        "title：自定义标题",
+        "sub-title：自定义副标题"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/result.md

@@ -0,0 +1,66 @@
+# EpResult
+
+`ep-result` · feedback（反馈） · `component:result`
+
+## 摘要
+
+结果，状态与结果反馈
+
+## 适用场景
+
+- 适用：展示结果并向用户传达状态
+- 适用：在操作前后提供即时反馈
+- 不适用：无需用户感知状态变化时
+- 不适用：需要完整业务弹窗流程时优先使用 Dialog
+
+## 关键词
+
+- 中文：结果、反馈
+- English: result, status, feedback
+
+## Props
+
+- title (string，默认 '')：标题文本
+- subTitle (string，默认 '')：副标题文本
+- icon ('primary' | 'success' | 'warning' | 'info' | 'error'，默认 info)：图标类型
+
+## Slots
+
+- icon：自定义图标
+- title：自定义标题
+- sub-title：自定义副标题
+- extra：自定义操作区
+
+## 视觉提示
+
+- 形状：行内或块级提示
+- 密度：中等
+- 插槽内容：icon：自定义图标；title：自定义标题；sub-title：自定义副标题
+- CSS 变量：--el-color-success、--el-color-warning、--el-color-danger、--el-font-size-base
+
+## 示例
+
+### 操作结果
+
+```vue
+<script setup lang="ts">
+import { EpButton, EpResult } from 'ep-craft'
+</script>
+
+<template>
+  <ep-result icon="success" title="操作成功" sub-title="订单已提交，请等待审核">
+    <template #extra>
+      <ep-button type="primary">返回列表</ep-button>
+    </template>
+  </ep-result>
+</template>
+```
+
+## 相关条目
+
+- EpEmpty
+- EpAlert
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/row.json

@@ -0,0 +1,115 @@
+{
+  "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=\"8\"><div class=\"grid-cell\">span 8</div></ep-col>\n    <ep-col :span=\"8\"><div class=\"grid-cell\">span 8</div></ep-col>\n    <ep-col :span=\"8\"><div class=\"grid-cell\">span 8</div></ep-col>\n  </ep-row>\n</template>",
+        "id": "row-1",
+        "language": "vue",
+        "title": "栅格行"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:row",
+    "keywords": {
+      "en": [
+        "row",
+        "grid",
+        "layout"
+      ],
+      "zh": [
+        "行",
+        "布局"
+      ]
+    },
+    "kind": "component",
+    "name": "EpRow",
+    "nonUseCases": [
+      "已有明确外层布局且无需此语义时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "div",
+        "description": "自定义元素标签",
+        "hasDefault": true,
+        "name": "tag",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "栅格间隔，单位 px",
+        "hasDefault": true,
+        "name": "gutter",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "start",
+        "description": "水平排列方式",
+        "hasDefault": true,
+        "name": "justify",
+        "required": false,
+        "type": "'start' | 'center' | 'end' | 'space-around' | 'space-between' | 'space-evenly'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "垂直排列方式",
+        "hasDefault": false,
+        "name": "align",
+        "required": false,
+        "type": "'top' | 'middle' | 'bottom'"
+      }
+    ],
+    "related": [
+      "EpCol",
+      "EpContainer"
+    ],
+    "relations": {
+      "children": [
+        "EpCol"
+      ],
+      "combos": [
+        "EpRow + EpCol"
+      ],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "栅格内容，通常放置 ep-col",
+        "name": "default"
+      }
+    ],
+    "slug": "row",
+    "summary": "行，页面结构与浮层交互",
+    "tag": "ep-row",
+    "useCases": [
+      "使用行组织页面区域与间距",
+      "承载内容分组或浮层交互"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-bg-color",
+        "--el-border-color",
+        "--el-border-radius-base"
+      ],
+      "density": "宽松",
+      "shape": "区块容器",
+      "slotContent": [
+        "default：栅格内容，通常放置 ep-col"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}