ep-craft 0.1.42 → 0.2.0

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

@@ -0,0 +1,219 @@
+{
+  "entry": {
+    "category": "form",
+    "events": [
+      {
+        "description": "绑定值变化时触发",
+        "name": "update:modelValue",
+        "params": "(value: string | number | boolean | undefined)"
+      },
+      {
+        "description": "绑定值变化时触发",
+        "name": "change",
+        "params": "(value: string | number | boolean)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpRadio, EpRadioGroup } from 'ep-craft'\n\nconst value = ref('primary')\n</script>\n\n<template>\n  <ep-radio-group v-model=\"value\">\n    <ep-radio value=\"primary\">主要</ep-radio>\n    <ep-radio value=\"success\">成功</ep-radio>\n  </ep-radio-group>\n</template>",
+        "id": "radio-group-1",
+        "language": "vue",
+        "title": "单选框组"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:radio-group",
+    "keywords": {
+      "en": [
+        "radio-group",
+        "radio",
+        "group",
+        "form"
+      ],
+      "zh": [
+        "单选框组",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpRadioGroup",
+    "nonUseCases": [
+      "仅展示静态文本或只读数据时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 id 属性",
+        "hasDefault": true,
+        "name": "id",
+        "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": true,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": "v-model",
+        "defaultText": null,
+        "description": "绑定值",
+        "hasDefault": true,
+        "name": "modelValue",
+        "required": false,
+        "type": "string | number | boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "#409EFF",
+        "description": "按钮形式的 Radio 激活时的填充色和边框色",
+        "hasDefault": true,
+        "name": "fill",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "#ffffff",
+        "description": "按钮形式的 Radio 激活时的文本颜色",
+        "hasDefault": true,
+        "name": "textColor",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 name 属性",
+        "hasDefault": true,
+        "name": "name",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否触发表单验证",
+        "hasDefault": true,
+        "name": "validateEvent",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "options",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "props",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "type",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "ariaLabel",
+        "required": false,
+        "type": "unknown"
+      }
+    ],
+    "related": [
+      "EpRadio",
+      "EpRadioButton"
+    ],
+    "relations": {
+      "children": [
+        "EpRadio",
+        "EpRadioButton"
+      ],
+      "combos": [
+        "EpRadioGroup + EpRadio",
+        "EpRadioGroup + EpRadioButton"
+      ],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义默认内容",
+        "name": "default"
+      }
+    ],
+    "slug": "radio-group",
+    "summary": "单选框组，表单数据录入控件",
+    "tag": "ep-radio-group",
+    "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": [
+        "default：自定义默认内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/radio-group.md

@@ -0,0 +1,88 @@
+# EpRadioGroup
+
+`ep-radio-group` · form（表单） · `component:radio-group`
+
+## 摘要
+
+单选框组，表单数据录入控件
+
+## 适用场景
+
+- 适用：表单中收集或编辑单选框组数据
+- 适用：与 EpForm、EpFormItem 组合完成校验
+- 不适用：仅展示静态文本或只读数据时
+
+## 关键词
+
+- 中文：单选框组、表单
+- English: radio-group, radio, group, form
+
+## 变体
+
+- size: large/default/small（按容器空间与信息密度选择尺寸）
+- state: disabled（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- id (string，默认 见文档)：原生 id 属性
+- size ('large' | 'default' | 'small')：单选框组尺寸
+- disabled (boolean，默认 false)：是否禁用
+- modelValue（别名 v-model） (string | number | boolean，默认 见文档)：绑定值
+- fill (string，默认 #409EFF)：按钮形式的 Radio 激活时的填充色和边框色
+- textColor (string，默认 #ffffff)：按钮形式的 Radio 激活时的文本颜色
+- name (string，默认 见文档)：原生 name 属性
+- validateEvent (boolean，默认 true)：是否触发表单验证
+- options (unknown)
+- props (unknown，默认 见文档)
+- type (unknown，默认 见文档)
+- ariaLabel (unknown)
+
+## Events
+
+- update:modelValue((value: string | number | boolean | undefined))：绑定值变化时触发
+- change((value: string | number | boolean))：绑定值变化时触发
+
+## Slots
+
+- default：自定义默认内容
+
+## 关系
+
+- 子级：EpRadio、EpRadioButton
+- 常用组合：EpRadioGroup + EpRadio、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 { EpRadio, EpRadioGroup } from 'ep-craft'
+
+const value = ref('primary')
+</script>
+
+<template>
+  <ep-radio-group v-model="value">
+    <ep-radio value="primary">主要</ep-radio>
+    <ep-radio value="success">成功</ep-radio>
+  </ep-radio-group>
+</template>
+```
+
+## 相关条目
+
+- EpRadio
+- EpRadioButton
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/radio.json

@@ -0,0 +1,177 @@
+{
+  "entry": {
+    "category": "form",
+    "events": [
+      {
+        "description": "绑定值变化时触发",
+        "name": "update:modelValue",
+        "params": "(value: string | number | boolean | undefined)"
+      },
+      {
+        "description": "绑定值变化时触发",
+        "name": "change",
+        "params": "(value: string | number | boolean)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpRadio, EpRadioGroup } from 'ep-craft'\n\nconst value = ref('a')\n</script>\n\n<template>\n  <ep-radio-group v-model=\"value\">\n    <ep-radio value=\"a\">选项 A</ep-radio>\n    <ep-radio value=\"b\">选项 B</ep-radio>\n  </ep-radio-group>\n</template>",
+        "id": "radio-1",
+        "language": "vue",
+        "title": "单选框"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:radio",
+    "keywords": {
+      "en": [
+        "radio",
+        "option",
+        "form"
+      ],
+      "zh": [
+        "单选框",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpRadio",
+    "nonUseCases": [
+      "仅展示静态文本或只读数据时"
+    ],
+    "props": [
+      {
+        "alias": "v-model",
+        "defaultText": null,
+        "description": "绑定值",
+        "hasDefault": true,
+        "name": "modelValue",
+        "required": false,
+        "type": "string | number | boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "Radio 的尺寸",
+        "hasDefault": false,
+        "name": "size",
+        "required": false,
+        "type": "'large' | 'default' | 'small'"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否禁用",
+        "hasDefault": true,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "单选框的值（已废弃，建议使用 value）",
+        "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"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否显示边框",
+        "hasDefault": false,
+        "name": "border",
+        "required": false,
+        "type": "boolean"
+      }
+    ],
+    "related": [
+      "EpRadioGroup"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [
+        "EpRadioGroup + EpRadio"
+      ],
+      "parents": [
+        "EpRadioGroup"
+      ],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义默认内容",
+        "name": "default"
+      }
+    ],
+    "slug": "radio",
+    "summary": "单选框，表单数据录入控件",
+    "tag": "ep-radio",
+    "useCases": [
+      "表单中收集或编辑单选框数据",
+      "与 EpForm、EpFormItem 组合完成校验"
+    ],
+    "variants": [
+      {
+        "dimension": "size",
+        "values": [
+          "large",
+          "default",
+          "small"
+        ],
+        "when": "按容器空间与信息密度选择尺寸"
+      },
+      {
+        "dimension": "state",
+        "values": [
+          "disabled"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      },
+      {
+        "dimension": "effect",
+        "values": [
+          "border"
+        ],
+        "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.md

@@ -0,0 +1,83 @@
+# EpRadio
+
+`ep-radio` · form（表单） · `component:radio`
+
+## 摘要
+
+单选框，表单数据录入控件
+
+## 适用场景
+
+- 适用：表单中收集或编辑单选框数据
+- 适用：与 EpForm、EpFormItem 组合完成校验
+- 不适用：仅展示静态文本或只读数据时
+
+## 关键词
+
+- 中文：单选框、表单
+- English: radio, option, form
+
+## 变体
+
+- size: large/default/small（按容器空间与信息密度选择尺寸）
+- state: disabled（通过布尔属性切换禁用、加载或选中状态）
+- effect: border（通过视觉修饰属性调整外观效果）
+
+## Props
+
+- modelValue（别名 v-model） (string | number | boolean，默认 见文档)：绑定值
+- size ('large' | 'default' | 'small')：Radio 的尺寸
+- disabled (boolean，默认 false)：是否禁用
+- label (string | number | boolean，默认 见文档)：单选框的值（已废弃，建议使用 value）
+- value (string | number | boolean，默认 见文档)：单选框的值
+- name (string，默认 见文档)：原生 name 属性
+- border (boolean)：是否显示边框
+
+## Events
+
+- update:modelValue((value: string | number | boolean | undefined))：绑定值变化时触发
+- change((value: string | number | boolean))：绑定值变化时触发
+
+## Slots
+
+- default：自定义默认内容
+
+## 关系
+
+- 父级：EpRadioGroup
+- 常用组合：EpRadioGroup + EpRadio
+
+## 视觉提示
+
+- 形状：矩形输入框
+- 密度：中等
+- 插槽内容：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 { EpRadio, EpRadioGroup } from 'ep-craft'
+
+const value = ref('a')
+</script>
+
+<template>
+  <ep-radio-group v-model="value">
+    <ep-radio value="a">选项 A</ep-radio>
+    <ep-radio value="b">选项 B</ep-radio>
+  </ep-radio-group>
+</template>
+```
+
+## 相关条目
+
+- EpRadioGroup
+
+---
+
+ep-craft 0.2.0