ep-craft 0.1.41 → 0.2.0

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

@@ -0,0 +1,236 @@
+{
+  "entry": {
+    "category": "form",
+    "events": [
+      {
+        "description": "绑定值变化时触发",
+        "name": "update:modelValue",
+        "params": "(value: (string | number)[])"
+      },
+      {
+        "description": "当绑定值变化时触发",
+        "name": "change",
+        "params": "(value: (string | number)[])"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpCheckbox, EpCheckboxGroup } from 'ep-craft'\n\nconst value = ref(['vue'])\n</script>\n\n<template>\n  <ep-checkbox-group v-model=\"value\">\n    <ep-checkbox value=\"vue\">Vue</ep-checkbox>\n    <ep-checkbox value=\"react\">React</ep-checkbox>\n  </ep-checkbox-group>\n</template>",
+        "id": "checkbox-group-1",
+        "language": "vue",
+        "title": "复选框组"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:checkbox-group",
+    "keywords": {
+      "en": [
+        "checkbox-group",
+        "checkbox",
+        "group",
+        "form"
+      ],
+      "zh": [
+        "多选框组",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpCheckboxGroup",
+    "nonUseCases": [
+      "仅展示静态文本或只读数据时"
+    ],
+    "props": [
+      {
+        "alias": "v-model",
+        "defaultText": "[]",
+        "description": "绑定值",
+        "hasDefault": true,
+        "name": "modelValue",
+        "required": false,
+        "type": "(string | number)[]"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否禁用",
+        "hasDefault": true,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "可被勾选的 checkbox 的最小数量",
+        "hasDefault": false,
+        "name": "min",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "可被勾选的 checkbox 的最大数量",
+        "hasDefault": false,
+        "name": "max",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "多选框组尺寸",
+        "hasDefault": false,
+        "name": "size",
+        "required": false,
+        "type": "'large' | 'default' | 'small'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "按钮形态选中时的背景色",
+        "hasDefault": false,
+        "name": "fill",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "按钮形态选中时的文字颜色",
+        "hasDefault": false,
+        "name": "textColor",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "div",
+        "description": "复选框组元素标签",
+        "hasDefault": true,
+        "name": "tag",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否触发表单验证",
+        "hasDefault": true,
+        "name": "validateEvent",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "选项数据，键名可由 props 自定义",
+        "hasDefault": false,
+        "name": "options",
+        "required": false,
+        "type": "CheckboxOption[]"
+      },
+      {
+        "alias": null,
+        "defaultText": "{ value: 'value', label: 'label', disabled: 'disabled' }",
+        "description": "选项的键名映射配置",
+        "hasDefault": true,
+        "name": "props",
+        "required": false,
+        "type": "{ value?: string; label?: string; disabled?: string }"
+      },
+      {
+        "alias": null,
+        "defaultText": "checkbox",
+        "description": "渲染形态",
+        "hasDefault": true,
+        "name": "type",
+        "required": false,
+        "type": "'checkbox' | 'button'"
+      },
+      {
+        "alias": null,
+        "defaultText": "checkbox-group",
+        "description": "为屏幕阅读器准备的标签",
+        "hasDefault": false,
+        "name": "ariaLabel",
+        "required": false,
+        "type": "string"
+      }
+    ],
+    "related": [
+      "EpCheckbox",
+      "EpCheckboxButton"
+    ],
+    "relations": {
+      "children": [
+        "EpCheckbox",
+        "EpCheckboxButton"
+      ],
+      "combos": [
+        "EpCheckboxGroup + EpCheckbox",
+        "EpCheckboxGroup + EpCheckboxButton"
+      ],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义默认内容；不提供时按 options 渲染",
+        "name": "default"
+      }
+    ],
+    "slug": "checkbox-group",
+    "summary": "多选框组，表单数据录入控件",
+    "tag": "ep-checkbox-group",
+    "useCases": [
+      "表单中收集或编辑多选框组数据",
+      "与 EpForm、EpFormItem 组合完成校验"
+    ],
+    "variants": [
+      {
+        "dimension": "type",
+        "values": [
+          "checkbox",
+          "button"
+        ],
+        "when": "通过 type 选择渲染形态"
+      },
+      {
+        "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：自定义默认内容；不提供时按 options 渲染"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

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

@@ -0,0 +1,90 @@
+# EpCheckboxGroup
+
+`ep-checkbox-group` · form（表单） · `component:checkbox-group`
+
+## 摘要
+
+多选框组，表单数据录入控件
+
+## 适用场景
+
+- 适用：表单中收集或编辑多选框组数据
+- 适用：与 EpForm、EpFormItem 组合完成校验
+- 不适用：仅展示静态文本或只读数据时
+
+## 关键词
+
+- 中文：多选框组、表单
+- English: checkbox-group, checkbox, group, form
+
+## 变体
+
+- type: checkbox/button（通过 type 选择渲染形态）
+- size: large/default/small（按容器空间与信息密度选择尺寸）
+- state: disabled（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- modelValue（别名 v-model） ((string | number)[]，默认 [])：绑定值
+- disabled (boolean，默认 false)：是否禁用
+- min (number)：可被勾选的 checkbox 的最小数量
+- max (number)：可被勾选的 checkbox 的最大数量
+- size ('large' | 'default' | 'small')：多选框组尺寸
+- fill (string)：按钮形态选中时的背景色
+- textColor (string)：按钮形态选中时的文字颜色
+- tag (string，默认 div)：复选框组元素标签
+- validateEvent (boolean，默认 true)：是否触发表单验证
+- options (CheckboxOption[])：选项数据，键名可由 props 自定义
+- props ({ value?: string; label?: string; disabled?: string }，默认 { value: 'value', label: 'label', disabled: 'disabled' })：选项的键名映射配置
+- type ('checkbox' | 'button'，默认 checkbox)：渲染形态
+- ariaLabel (string)：为屏幕阅读器准备的标签
+
+## Events
+
+- update:modelValue((value: (string | number)[]))：绑定值变化时触发
+- change((value: (string | number)[]))：当绑定值变化时触发
+
+## Slots
+
+- default：自定义默认内容；不提供时按 options 渲染
+
+## 关系
+
+- 子级：EpCheckbox、EpCheckboxButton
+- 常用组合：EpCheckboxGroup + EpCheckbox、EpCheckboxGroup + EpCheckboxButton
+
+## 视觉提示
+
+- 形状：矩形输入框
+- 密度：中等
+- 插槽内容：default：自定义默认内容；不提供时按 options 渲染
+- 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 { EpCheckbox, EpCheckboxGroup } from 'ep-craft'
+
+const value = ref(['vue'])
+</script>
+
+<template>
+  <ep-checkbox-group v-model="value">
+    <ep-checkbox value="vue">Vue</ep-checkbox>
+    <ep-checkbox value="react">React</ep-checkbox>
+  </ep-checkbox-group>
+</template>
+```
+
+## 相关条目
+
+- EpCheckbox
+- EpCheckboxButton
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/checkbox.json

@@ -0,0 +1,278 @@
+{
+  "entry": {
+    "category": "form",
+    "events": [
+      {
+        "description": "绑定值变化时触发",
+        "name": "update:modelValue",
+        "params": "(value: string | number | boolean)"
+      },
+      {
+        "description": "当绑定值变化时触发",
+        "name": "change",
+        "params": "(value: string | number | boolean)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpCheckbox } from 'ep-craft'\n\nconst checked = ref(false)\n</script>\n\n<template>\n  <ep-checkbox v-model=\"checked\">同意用户协议</ep-checkbox>\n</template>",
+        "id": "checkbox-1",
+        "language": "vue",
+        "title": "单个复选框"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:checkbox",
+    "keywords": {
+      "en": [
+        "checkbox",
+        "check",
+        "form"
+      ],
+      "zh": [
+        "多选框",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpCheckbox",
+    "nonUseCases": [
+      "仅展示静态文本或只读数据时"
+    ],
+    "props": [
+      {
+        "alias": "v-model",
+        "defaultText": null,
+        "description": "绑定值",
+        "hasDefault": true,
+        "name": "modelValue",
+        "required": false,
+        "type": "string | number | boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "选中状态的值（已废弃，建议使用 value）",
+        "hasDefault": true,
+        "name": "label",
+        "required": false,
+        "type": "string | number | boolean | object"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "选中状态的值",
+        "hasDefault": true,
+        "name": "value",
+        "required": false,
+        "type": "string | number | boolean | object"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "设置不确定状态",
+        "hasDefault": false,
+        "name": "indeterminate",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否禁用",
+        "hasDefault": true,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "当前是否勾选",
+        "hasDefault": false,
+        "name": "checked",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 name 属性",
+        "hasDefault": true,
+        "name": "name",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "选中时的值",
+        "hasDefault": true,
+        "name": "trueValue",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "没有选中时的值",
+        "hasDefault": true,
+        "name": "falseValue",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "选中时的值（已废弃，建议使用 true-value）",
+        "hasDefault": true,
+        "name": "trueLabel",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "没有选中时的值（已废弃，建议使用 false-value）",
+        "hasDefault": true,
+        "name": "falseLabel",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 id 属性",
+        "hasDefault": true,
+        "name": "id",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否显示边框",
+        "hasDefault": false,
+        "name": "border",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "Checkbox 的尺寸",
+        "hasDefault": false,
+        "name": "size",
+        "required": false,
+        "type": "'large' | 'default' | 'small'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 tabindex 属性",
+        "hasDefault": false,
+        "name": "tabindex",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否触发表单验证",
+        "hasDefault": true,
+        "name": "validateEvent",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "为屏幕阅读器准备的标签",
+        "hasDefault": false,
+        "name": "ariaLabel",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "不确定状态下关联元素的 id",
+        "hasDefault": false,
+        "name": "ariaControls",
+        "required": false,
+        "type": "string"
+      }
+    ],
+    "related": [
+      "EpCheckboxGroup"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [
+        "EpCheckboxGroup + EpCheckbox"
+      ],
+      "parents": [
+        "EpCheckboxGroup"
+      ],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义默认内容",
+        "name": "default"
+      }
+    ],
+    "slug": "checkbox",
+    "summary": "多选框，表单数据录入控件",
+    "tag": "ep-checkbox",
+    "useCases": [
+      "表单中收集或编辑多选框数据",
+      "与 EpForm、EpFormItem 组合完成校验"
+    ],
+    "variants": [
+      {
+        "dimension": "size",
+        "values": [
+          "large",
+          "default",
+          "small"
+        ],
+        "when": "按容器空间与信息密度选择尺寸"
+      },
+      {
+        "dimension": "state",
+        "values": [
+          "disabled",
+          "checked",
+          "indeterminate"
+        ],
+        "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/checkbox.md

@@ -0,0 +1,91 @@
+# EpCheckbox
+
+`ep-checkbox` · form（表单） · `component:checkbox`
+
+## 摘要
+
+多选框，表单数据录入控件
+
+## 适用场景
+
+- 适用：表单中收集或编辑多选框数据
+- 适用：与 EpForm、EpFormItem 组合完成校验
+- 不适用：仅展示静态文本或只读数据时
+
+## 关键词
+
+- 中文：多选框、表单
+- English: checkbox, check, form
+
+## 变体
+
+- size: large/default/small（按容器空间与信息密度选择尺寸）
+- state: disabled/checked/indeterminate（通过布尔属性切换禁用、加载或选中状态）
+- effect: border（通过视觉修饰属性调整外观效果）
+
+## Props
+
+- modelValue（别名 v-model） (string | number | boolean，默认 见文档)：绑定值
+- label (string | number | boolean | object，默认 见文档)：选中状态的值（已废弃，建议使用 value）
+- value (string | number | boolean | object，默认 见文档)：选中状态的值
+- indeterminate (boolean)：设置不确定状态
+- disabled (boolean，默认 false)：是否禁用
+- checked (boolean)：当前是否勾选
+- name (string，默认 见文档)：原生 name 属性
+- trueValue (string | number，默认 见文档)：选中时的值
+- falseValue (string | number，默认 见文档)：没有选中时的值
+- trueLabel (string | number，默认 见文档)：选中时的值（已废弃，建议使用 true-value）
+- falseLabel (string | number，默认 见文档)：没有选中时的值（已废弃，建议使用 false-value）
+- id (string，默认 见文档)：原生 id 属性
+- border (boolean)：是否显示边框
+- size ('large' | 'default' | 'small')：Checkbox 的尺寸
+- tabindex (string | number)：原生 tabindex 属性
+- validateEvent (boolean，默认 true)：是否触发表单验证
+- ariaLabel (string)：为屏幕阅读器准备的标签
+- ariaControls (string)：不确定状态下关联元素的 id
+
+## Events
+
+- update:modelValue((value: string | number | boolean))：绑定值变化时触发
+- change((value: string | number | boolean))：当绑定值变化时触发
+
+## Slots
+
+- default：自定义默认内容
+
+## 关系
+
+- 父级：EpCheckboxGroup
+- 常用组合：EpCheckboxGroup + EpCheckbox
+
+## 视觉提示
+
+- 形状：矩形输入框
+- 密度：中等
+- 插槽内容：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 { EpCheckbox } from 'ep-craft'
+
+const checked = ref(false)
+</script>
+
+<template>
+  <ep-checkbox v-model="checked">同意用户协议</ep-checkbox>
+</template>
+```
+
+## 相关条目
+
+- EpCheckboxGroup
+
+---
+
+ep-craft 0.2.0