ep-craft 0.1.42 → 0.2.0

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

@@ -0,0 +1,123 @@
+{
+  "entry": {
+    "category": "basic",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpButton, EpButtonGroup } from 'ep-craft'\n</script>\n\n<template>\n  <ep-button-group>\n    <ep-button>上一页</ep-button>\n    <ep-button>下一页</ep-button>\n  </ep-button-group>\n</template>",
+        "id": "button-group-1",
+        "language": "vue",
+        "title": "按钮组"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:button-group",
+    "keywords": {
+      "en": [
+        "button-group",
+        "button",
+        "group",
+        "basic"
+      ],
+      "zh": [
+        "按钮组",
+        "基础"
+      ]
+    },
+    "kind": "component",
+    "name": "EpButtonGroup",
+    "nonUseCases": [
+      "需要完全自定义原生行为或视觉时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "用于控制该按钮组内按钮的大小",
+        "hasDefault": false,
+        "name": "size",
+        "required": false,
+        "type": "'large' | 'default' | 'small'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "用于控制该按钮组内按钮的类型",
+        "hasDefault": true,
+        "name": "type",
+        "required": false,
+        "type": "'primary' | 'success' | 'warning' | 'danger' | 'info'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "direction",
+        "required": false,
+        "type": "unknown"
+      }
+    ],
+    "related": [
+      "EpButton"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义按钮组内容",
+        "name": "default"
+      }
+    ],
+    "slug": "button-group",
+    "summary": "按钮组，基础交互与展示元素",
+    "tag": "ep-button-group",
+    "useCases": [
+      "页面中的按钮组展示与交互",
+      "为按钮组提供统一视觉与状态"
+    ],
+    "variants": [
+      {
+        "dimension": "type",
+        "values": [
+          "primary",
+          "success",
+          "warning",
+          "danger",
+          "info"
+        ],
+        "when": "通过 type 选择用于控制该按钮组内按钮的类型"
+      },
+      {
+        "dimension": "size",
+        "values": [
+          "large",
+          "default",
+          "small"
+        ],
+        "when": "按容器空间与信息密度选择尺寸"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-color-primary",
+        "--el-border-radius-base",
+        "--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/button-group.md

@@ -0,0 +1,65 @@
+# EpButtonGroup
+
+`ep-button-group` · basic（基础） · `component:button-group`
+
+## 摘要
+
+按钮组，基础交互与展示元素
+
+## 适用场景
+
+- 适用：页面中的按钮组展示与交互
+- 适用：为按钮组提供统一视觉与状态
+- 不适用：需要完全自定义原生行为或视觉时
+
+## 关键词
+
+- 中文：按钮组、基础
+- English: button-group, button, group, basic
+
+## 变体
+
+- type: primary/success/warning/danger/info（通过 type 选择用于控制该按钮组内按钮的类型）
+- size: large/default/small（按容器空间与信息密度选择尺寸）
+
+## Props
+
+- size ('large' | 'default' | 'small')：用于控制该按钮组内按钮的大小
+- type ('primary' | 'success' | 'warning' | 'danger' | 'info'，默认 见文档)：用于控制该按钮组内按钮的类型
+- direction (unknown，默认 见文档)
+
+## Slots
+
+- default：自定义按钮组内容
+
+## 视觉提示
+
+- 形状：圆角矩形
+- 密度：中等
+- 插槽内容：default：自定义按钮组内容
+- CSS 变量：--el-color-primary、--el-border-radius-base、--el-font-size-base
+
+## 示例
+
+### 按钮组
+
+```vue
+<script setup lang="ts">
+import { EpButton, EpButtonGroup } from 'ep-craft'
+</script>
+
+<template>
+  <ep-button-group>
+    <ep-button>上一页</ep-button>
+    <ep-button>下一页</ep-button>
+  </ep-button-group>
+</template>
+```
+
+## 相关条目
+
+- EpButton
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/button.json

@@ -0,0 +1,349 @@
+{
+  "entry": {
+    "category": "basic",
+    "events": [
+      {
+        "description": "点击按钮时触发",
+        "name": "click",
+        "params": "(event: MouseEvent)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpButton } from 'ep-craft'\n</script>\n\n<template>\n  <ep-button>默认</ep-button>\n  <ep-button type=\"primary\">主要</ep-button>\n  <ep-button type=\"danger\" plain>危险</ep-button>\n  <ep-button type=\"primary\" text>文字</ep-button>\n</template>",
+        "id": "button-1",
+        "language": "vue",
+        "title": "按钮类型"
+      },
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpButton } from 'ep-craft'\n</script>\n\n<template>\n  <ep-button type=\"primary\" loading>提交中</ep-button>\n  <ep-button disabled>不可用</ep-button>\n</template>",
+        "id": "button-2",
+        "language": "vue",
+        "title": "禁用与加载"
+      },
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpButton } from 'ep-craft'\nimport { Search } from 'ep-craft/icons'\n</script>\n\n<template>\n  <ep-button type=\"primary\" :icon=\"Search\">搜索</ep-button>\n</template>",
+        "id": "button-3",
+        "language": "vue",
+        "title": "带图标按钮"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "按钮 HTML 元素",
+        "name": "ref",
+        "type": "Ref<HTMLButtonElement>"
+      },
+      {
+        "description": "按钮尺寸",
+        "name": "size",
+        "type": "ComputedRef<'' | 'large' | 'default' | 'small' | 'mini'>"
+      },
+      {
+        "description": "按钮类型",
+        "name": "type",
+        "type": "ComputedRef<'' | 'default' | 'primary' | 'success' | 'warning' | 'danger' | 'info' | 'text'>"
+      },
+      {
+        "description": "按钮禁用状态",
+        "name": "disabled",
+        "type": "ComputedRef<boolean>"
+      },
+      {
+        "description": "是否在两个中文字符间插入空格",
+        "name": "shouldAddSpace",
+        "type": "ComputedRef<boolean>"
+      }
+    ],
+    "hot": true,
+    "id": "component:button",
+    "keywords": {
+      "en": [
+        "button",
+        "btn",
+        "action",
+        "basic"
+      ],
+      "zh": [
+        "按钮",
+        "操作",
+        "提交",
+        "取消",
+        "基础"
+      ]
+    },
+    "kind": "component",
+    "name": "EpButton",
+    "nonUseCases": [
+      "仅用于页面跳转时优先使用 Link"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "尺寸",
+        "hasDefault": false,
+        "name": "size",
+        "required": false,
+        "type": "'' | 'large' | 'default' | 'small' | 'mini'"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "按钮是否为禁用状态",
+        "hasDefault": true,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "类型",
+        "hasDefault": true,
+        "name": "type",
+        "required": false,
+        "type": "'' | 'default' | 'primary' | 'success' | 'warning' | 'danger' | 'info' | 'text'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "图标组件",
+        "hasDefault": false,
+        "name": "icon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": "button",
+        "description": "原生 type 属性",
+        "hasDefault": true,
+        "name": "nativeType",
+        "required": false,
+        "type": "'button' | 'submit' | 'reset'"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否为加载中状态",
+        "hasDefault": false,
+        "name": "loading",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "Loading",
+        "description": "自定义加载中状态图标组件",
+        "hasDefault": true,
+        "name": "loadingIcon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否为朴素按钮",
+        "hasDefault": true,
+        "name": "plain",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否为文字按钮",
+        "hasDefault": true,
+        "name": "text",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否为链接按钮",
+        "hasDefault": false,
+        "name": "link",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否显示文字按钮背景颜色",
+        "hasDefault": false,
+        "name": "bg",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "原生 autofocus 属性",
+        "hasDefault": false,
+        "name": "autofocus",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否为圆角按钮",
+        "hasDefault": true,
+        "name": "round",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否为圆形按钮",
+        "hasDefault": false,
+        "name": "circle",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否为虚线按钮",
+        "hasDefault": true,
+        "name": "dashed",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "自定义按钮颜色，自动计算 hover 和 active 颜色",
+        "hasDefault": false,
+        "name": "color",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "暗色模式",
+        "hasDefault": false,
+        "name": "dark",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "自动在两个中文字符之间插入空格",
+        "hasDefault": true,
+        "name": "autoInsertSpace",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "button",
+        "description": "自定义元素标签",
+        "hasDefault": true,
+        "name": "tag",
+        "required": false,
+        "type": "string | Component"
+      }
+    ],
+    "related": [
+      "EpButtonGroup",
+      "EpLink"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义默认内容",
+        "name": "default"
+      },
+      {
+        "description": "自定义加载中组件",
+        "name": "loading"
+      },
+      {
+        "description": "自定义图标组件",
+        "name": "icon"
+      }
+    ],
+    "slug": "button",
+    "summary": "通用操作按钮，支持类型、尺寸与状态",
+    "tag": "ep-button",
+    "useCases": [
+      "提交、取消、确认等操作触发",
+      "工具栏与表单操作区"
+    ],
+    "variants": [
+      {
+        "dimension": "type",
+        "values": [
+          "default",
+          "primary",
+          "success",
+          "warning",
+          "danger",
+          "info",
+          "text"
+        ],
+        "when": "通过 type 选择类型"
+      },
+      {
+        "dimension": "size",
+        "values": [
+          "large",
+          "default",
+          "small",
+          "mini"
+        ],
+        "when": "按容器空间与信息密度选择尺寸"
+      },
+      {
+        "dimension": "state",
+        "values": [
+          "disabled",
+          "loading"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      },
+      {
+        "dimension": "effect",
+        "values": [
+          "plain",
+          "text",
+          "link",
+          "dark",
+          "round",
+          "circle",
+          "dashed"
+        ],
+        "when": "通过视觉修饰属性调整外观效果"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-color-primary",
+        "--el-border-radius-base",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "圆角矩形",
+      "slotContent": [
+        "default：自定义默认内容",
+        "loading：自定义加载中组件",
+        "icon：自定义图标组件"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/button.md

@@ -0,0 +1,124 @@
+# EpButton
+
+`ep-button` · basic（基础） · `component:button`
+
+## 摘要
+
+通用操作按钮，支持类型、尺寸与状态
+
+## 适用场景
+
+- 适用：提交、取消、确认等操作触发
+- 适用：工具栏与表单操作区
+- 不适用：仅用于页面跳转时优先使用 Link
+
+## 关键词
+
+- 中文：按钮、操作、提交、取消、基础
+- English: button, btn, action, basic
+
+## 变体
+
+- type: default/primary/success/warning/danger/info/text（通过 type 选择类型）
+- size: large/default/small/mini（按容器空间与信息密度选择尺寸）
+- state: disabled/loading（通过布尔属性切换禁用、加载或选中状态）
+- effect: plain/text/link/dark/round/circle/dashed（通过视觉修饰属性调整外观效果）
+
+## Props
+
+- size ('' | 'large' | 'default' | 'small' | 'mini')：尺寸
+- disabled (boolean，默认 false)：按钮是否为禁用状态
+- type ('' | 'default' | 'primary' | 'success' | 'warning' | 'danger' | 'info' | 'text'，默认 '')：类型
+- icon (string | Component)：图标组件
+- nativeType ('button' | 'submit' | 'reset'，默认 button)：原生 type 属性
+- loading (boolean)：是否为加载中状态
+- loadingIcon (string | Component，默认 Loading)：自定义加载中状态图标组件
+- plain (boolean，默认 false)：是否为朴素按钮
+- text (boolean，默认 false)：是否为文字按钮
+- link (boolean)：是否为链接按钮
+- bg (boolean)：是否显示文字按钮背景颜色
+- autofocus (boolean)：原生 autofocus 属性
+- round (boolean，默认 false)：是否为圆角按钮
+- circle (boolean)：是否为圆形按钮
+- dashed (boolean，默认 false)：是否为虚线按钮
+- color (string)：自定义按钮颜色，自动计算 hover 和 active 颜色
+- dark (boolean)：暗色模式
+- autoInsertSpace (boolean，默认 见文档)：自动在两个中文字符之间插入空格
+- tag (string | Component，默认 button)：自定义元素标签
+
+## Events
+
+- click((event: MouseEvent))：点击按钮时触发
+
+## Slots
+
+- default：自定义默认内容
+- loading：自定义加载中组件
+- icon：自定义图标组件
+
+## Exposes
+
+- ref(Ref<HTMLButtonElement>)：按钮 HTML 元素
+- size(ComputedRef<'' | 'large' | 'default' | 'small' | 'mini'>)：按钮尺寸
+- type(ComputedRef<'' | 'default' | 'primary' | 'success' | 'warning' | 'danger' | 'info' | 'text'>)：按钮类型
+- disabled(ComputedRef<boolean>)：按钮禁用状态
+- shouldAddSpace(ComputedRef<boolean>)：是否在两个中文字符间插入空格
+
+## 视觉提示
+
+- 形状：圆角矩形
+- 密度：中等
+- 插槽内容：default：自定义默认内容；loading：自定义加载中组件；icon：自定义图标组件
+- CSS 变量：--el-color-primary、--el-border-radius-base、--el-font-size-base
+
+## 示例
+
+### 按钮类型
+
+```vue
+<script setup lang="ts">
+import { EpButton } from 'ep-craft'
+</script>
+
+<template>
+  <ep-button>默认</ep-button>
+  <ep-button type="primary">主要</ep-button>
+  <ep-button type="danger" plain>危险</ep-button>
+  <ep-button type="primary" text>文字</ep-button>
+</template>
+```
+
+### 禁用与加载
+
+```vue
+<script setup lang="ts">
+import { EpButton } from 'ep-craft'
+</script>
+
+<template>
+  <ep-button type="primary" loading>提交中</ep-button>
+  <ep-button disabled>不可用</ep-button>
+</template>
+```
+
+### 带图标按钮
+
+```vue
+<script setup lang="ts">
+import { EpButton } from 'ep-craft'
+import { Search } from 'ep-craft/icons'
+</script>
+
+<template>
+  <ep-button type="primary" :icon="Search">搜索</ep-button>
+</template>
+```
+
+## 相关条目
+
+- EpButtonGroup
+- EpLink
+
+---
+
+ep-craft 0.2.0