ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/check-tag.json

@@ -0,0 +1,133 @@
+{
+  "entry": {
+    "category": "layout",
+    "events": [
+      {
+        "description": "选中状态变化时触发",
+        "name": "update:checked",
+        "params": "(value: boolean)"
+      },
+      {
+        "description": "选中状态变化时触发",
+        "name": "change",
+        "params": "(value: boolean)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpCheckTag } from 'ep-craft'\n\nconst checked = ref(true)\n</script>\n\n<template>\n  <ep-check-tag v-model:checked=\"checked\" type=\"primary\">\n    已选中：{{ checked }}\n  </ep-check-tag>\n</template>",
+        "id": "check-tag-1",
+        "language": "vue",
+        "title": "可选标签"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:check-tag",
+    "keywords": {
+      "en": [
+        "check-tag",
+        "check",
+        "tag",
+        "layout"
+      ],
+      "zh": [
+        "可选标签",
+        "布局"
+      ]
+    },
+    "kind": "component",
+    "name": "EpCheckTag",
+    "nonUseCases": [
+      "已有明确外层布局且无需此语义时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否被选中",
+        "hasDefault": false,
+        "name": "checked",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否禁用",
+        "hasDefault": false,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "primary",
+        "description": "标签类型",
+        "hasDefault": true,
+        "name": "type",
+        "required": false,
+        "type": "'primary' | 'success' | 'info' | 'warning' | 'danger'"
+      }
+    ],
+    "related": [
+      "EpTag"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "标签内容",
+        "name": "default"
+      }
+    ],
+    "slug": "check-tag",
+    "summary": "可选标签，页面结构与浮层交互",
+    "tag": "ep-check-tag",
+    "useCases": [
+      "使用可选标签组织页面区域与间距",
+      "承载内容分组或浮层交互"
+    ],
+    "variants": [
+      {
+        "dimension": "type",
+        "values": [
+          "primary",
+          "success",
+          "info",
+          "warning",
+          "danger"
+        ],
+        "when": "通过 type 选择标签类型"
+      },
+      {
+        "dimension": "state",
+        "values": [
+          "disabled",
+          "checked"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-bg-color",
+        "--el-border-color",
+        "--el-border-radius-base"
+      ],
+      "density": "宽松",
+      "shape": "区块容器",
+      "slotContent": [
+        "default：标签内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/check-tag.md

@@ -0,0 +1,72 @@
+# EpCheckTag
+
+`ep-check-tag` · layout（布局） · `component:check-tag`
+
+## 摘要
+
+可选标签，页面结构与浮层交互
+
+## 适用场景
+
+- 适用：使用可选标签组织页面区域与间距
+- 适用：承载内容分组或浮层交互
+- 不适用：已有明确外层布局且无需此语义时
+
+## 关键词
+
+- 中文：可选标签、布局
+- English: check-tag, check, tag, layout
+
+## 变体
+
+- type: primary/success/info/warning/danger（通过 type 选择标签类型）
+- state: disabled/checked（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- checked (boolean)：是否被选中
+- disabled (boolean)：是否禁用
+- type ('primary' | 'success' | 'info' | 'warning' | 'danger'，默认 primary)：标签类型
+
+## Events
+
+- update:checked((value: boolean))：选中状态变化时触发
+- change((value: boolean))：选中状态变化时触发
+
+## Slots
+
+- default：标签内容
+
+## 视觉提示
+
+- 形状：区块容器
+- 密度：宽松
+- 插槽内容：default：标签内容
+- CSS 变量：--el-bg-color、--el-border-color、--el-border-radius-base
+
+## 示例
+
+### 可选标签
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { EpCheckTag } from 'ep-craft'
+
+const checked = ref(true)
+</script>
+
+<template>
+  <ep-check-tag v-model:checked="checked" type="primary">
+    已选中：{{ checked }}
+  </ep-check-tag>
+</template>
+```
+
+## 相关条目
+
+- EpTag
+
+---
+
+ep-craft 0.2.0

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

@@ -0,0 +1,279 @@
+{
+  "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 { EpCheckboxButton, EpCheckboxGroup } from 'ep-craft'\n\nconst value = ref(['read'])\n</script>\n\n<template>\n  <ep-checkbox-group v-model=\"value\">\n    <ep-checkbox-button value=\"read\">读取</ep-checkbox-button>\n    <ep-checkbox-button value=\"write\">写入</ep-checkbox-button>\n  </ep-checkbox-group>\n</template>",
+        "id": "checkbox-button-1",
+        "language": "vue",
+        "title": "按钮样式复选框"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:checkbox-button",
+    "keywords": {
+      "en": [
+        "checkbox-button",
+        "checkbox",
+        "button",
+        "form"
+      ],
+      "zh": [
+        "多选按钮",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpCheckboxButton",
+    "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": "按钮尺寸；未设置时继承分组尺寸",
+        "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 + EpCheckboxButton"
+      ],
+      "parents": [
+        "EpCheckboxGroup"
+      ],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义默认内容；缺省时回落到 label 文本",
+        "name": "default"
+      }
+    ],
+    "slug": "checkbox-button",
+    "summary": "多选按钮，表单数据录入控件",
+    "tag": "ep-checkbox-button",
+    "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：自定义默认内容；缺省时回落到 label 文本"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

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

@@ -0,0 +1,94 @@
+# EpCheckboxButton
+
+`ep-checkbox-button` · form（表单） · `component:checkbox-button`
+
+## 摘要
+
+多选按钮，表单数据录入控件
+
+## 适用场景
+
+- 适用：表单中收集或编辑多选按钮数据
+- 适用：与 EpForm、EpFormItem 组合完成校验
+- 不适用：仅展示静态文本或只读数据时
+
+## 关键词
+
+- 中文：多选按钮、表单
+- English: checkbox-button, checkbox, button, 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')：按钮尺寸；未设置时继承分组尺寸
+- 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：自定义默认内容；缺省时回落到 label 文本
+
+## 关系
+
+- 父级：EpCheckboxGroup
+- 常用组合：EpCheckboxGroup + EpCheckboxButton
+
+## 视觉提示
+
+- 形状：矩形输入框
+- 密度：中等
+- 插槽内容：default：自定义默认内容；缺省时回落到 label 文本
+- 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 { EpCheckboxButton, EpCheckboxGroup } from 'ep-craft'
+
+const value = ref(['read'])
+</script>
+
+<template>
+  <ep-checkbox-group v-model="value">
+    <ep-checkbox-button value="read">读取</ep-checkbox-button>
+    <ep-checkbox-button value="write">写入</ep-checkbox-button>
+  </ep-checkbox-group>
+</template>
+```
+
+## 相关条目
+
+- EpCheckboxGroup
+
+---
+
+ep-craft 0.2.0