ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/option.json

@@ -0,0 +1,122 @@
+{
+  "entry": {
+    "category": "form",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpOption, EpSelect } from 'ep-craft'\n\nconst value = ref('vue')\n</script>\n\n<template>\n  <ep-select v-model=\"value\" placeholder=\"请选择框架\">\n    <ep-option label=\"Vue\" value=\"vue\" />\n    <ep-option label=\"React\" value=\"react\" />\n  </ep-select>\n</template>",
+        "id": "option-1",
+        "language": "vue",
+        "title": "选择器选项"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:option",
+    "keywords": {
+      "en": [
+        "option",
+        "item",
+        "form"
+      ],
+      "zh": [
+        "选项",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpOption",
+    "nonUseCases": [
+      "仅展示静态文本或只读数据时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "选项的值",
+        "hasDefault": false,
+        "name": "value",
+        "required": true,
+        "type": "string | number | boolean | object"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "选项的标签",
+        "hasDefault": false,
+        "name": "label",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "created",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否禁用该选项",
+        "hasDefault": false,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      }
+    ],
+    "related": [
+      "EpSelect",
+      "EpSelectV2",
+      "EpOptionGroup"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [
+        "EpSelect + EpOption",
+        "EpSelectV2 + EpOption",
+        "EpOptionGroup + EpOption"
+      ],
+      "parents": [
+        "EpSelect",
+        "EpSelectV2",
+        "EpOptionGroup"
+      ],
+      "requiredChildren": []
+    },
+    "slots": [],
+    "slug": "option",
+    "summary": "选项，表单数据录入控件",
+    "tag": "ep-option",
+    "useCases": [
+      "表单中收集或编辑选项数据",
+      "与 EpForm、EpFormItem 组合完成校验"
+    ],
+    "variants": [
+      {
+        "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/option.md

@@ -0,0 +1,70 @@
+# EpOption
+
+`ep-option` · form（表单） · `component:option`
+
+## 摘要
+
+选项，表单数据录入控件
+
+## 适用场景
+
+- 适用：表单中收集或编辑选项数据
+- 适用：与 EpForm、EpFormItem 组合完成校验
+- 不适用：仅展示静态文本或只读数据时
+
+## 关键词
+
+- 中文：选项、表单
+- English: option, item, form
+
+## 变体
+
+- state: disabled（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- value (string | number | boolean | object，必填)：选项的值
+- label (string | number)：选项的标签
+- created (unknown)
+- disabled (boolean)：是否禁用该选项
+
+## 关系
+
+- 父级：EpSelect、EpSelectV2、EpOptionGroup
+- 常用组合：EpSelect + EpOption、EpSelectV2 + EpOption、EpOptionGroup + EpOption
+
+## 视觉提示
+
+- 形状：矩形输入框
+- 密度：中等
+- 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 { EpOption, EpSelect } from 'ep-craft'
+
+const value = ref('vue')
+</script>
+
+<template>
+  <ep-select v-model="value" placeholder="请选择框架">
+    <ep-option label="Vue" value="vue" />
+    <ep-option label="React" value="react" />
+  </ep-select>
+</template>
+```
+
+## 相关条目
+
+- EpSelect
+- EpSelectV2
+- EpOptionGroup
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/page-header.json

@@ -0,0 +1,131 @@
+{
+  "entry": {
+    "category": "navigation",
+    "events": [
+      {
+        "description": "点击返回按钮时触发",
+        "name": "back",
+        "params": "—"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpButton, EpPageHeader } from 'ep-craft'\n</script>\n\n<template>\n  <ep-page-header title=\"页面标题\" content=\"页面说明文字\">\n    <template #extra>\n      <ep-button type=\"primary\">新建</ep-button>\n    </template>\n  </ep-page-header>\n</template>",
+        "id": "page-header-1",
+        "language": "vue",
+        "title": "页头"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:page-header",
+    "keywords": {
+      "en": [
+        "page-header",
+        "page",
+        "header",
+        "title",
+        "navigation"
+      ],
+      "zh": [
+        "页头",
+        "导航"
+      ]
+    },
+    "kind": "component",
+    "name": "EpPageHeader",
+    "nonUseCases": [
+      "单步无层级的简单跳转时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "Back",
+        "description": "页头图标组件",
+        "hasDefault": true,
+        "name": "icon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "页头主标题",
+        "hasDefault": false,
+        "name": "title",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "页头内容",
+        "hasDefault": true,
+        "name": "content",
+        "required": false,
+        "type": "string"
+      }
+    ],
+    "related": [
+      "EpBreadcrumb"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义面包屑内容",
+        "name": "breadcrumb"
+      },
+      {
+        "description": "自定义图标",
+        "name": "icon"
+      },
+      {
+        "description": "自定义标题",
+        "name": "title"
+      },
+      {
+        "description": "自定义内容",
+        "name": "content"
+      },
+      {
+        "description": "自定义右侧操作区",
+        "name": "extra"
+      },
+      {
+        "description": "页头主体内容",
+        "name": "default"
+      }
+    ],
+    "slug": "page-header",
+    "summary": "页头，页面导航与定位",
+    "tag": "ep-page-header",
+    "useCases": [
+      "在页面或模块间使用页头导航",
+      "指示当前位置与层级"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-color-primary",
+        "--el-text-color-regular",
+        "--el-bg-color"
+      ],
+      "density": "中等",
+      "shape": "条状或列表",
+      "slotContent": [
+        "breadcrumb：自定义面包屑内容",
+        "icon：自定义图标",
+        "title：自定义标题"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/page-header.md

@@ -0,0 +1,70 @@
+# EpPageHeader
+
+`ep-page-header` · navigation（导航） · `component:page-header`
+
+## 摘要
+
+页头，页面导航与定位
+
+## 适用场景
+
+- 适用：在页面或模块间使用页头导航
+- 适用：指示当前位置与层级
+- 不适用：单步无层级的简单跳转时
+
+## 关键词
+
+- 中文：页头、导航
+- English: page-header, page, header, title, navigation
+
+## Props
+
+- icon (string | Component，默认 Back)：页头图标组件
+- title (string)：页头主标题
+- content (string，默认 '')：页头内容
+
+## Events
+
+- back(—)：点击返回按钮时触发
+
+## Slots
+
+- breadcrumb：自定义面包屑内容
+- icon：自定义图标
+- title：自定义标题
+- content：自定义内容
+- extra：自定义右侧操作区
+- default：页头主体内容
+
+## 视觉提示
+
+- 形状：条状或列表
+- 密度：中等
+- 插槽内容：breadcrumb：自定义面包屑内容；icon：自定义图标；title：自定义标题
+- CSS 变量：--el-color-primary、--el-text-color-regular、--el-bg-color
+
+## 示例
+
+### 页头
+
+```vue
+<script setup lang="ts">
+import { EpButton, EpPageHeader } from 'ep-craft'
+</script>
+
+<template>
+  <ep-page-header title="页面标题" content="页面说明文字">
+    <template #extra>
+      <ep-button type="primary">新建</ep-button>
+    </template>
+  </ep-page-header>
+</template>
+```
+
+## 相关条目
+
+- EpBreadcrumb
+
+---
+
+ep-craft 0.2.0