ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/footer.json

@@ -0,0 +1,86 @@
+{
+  "entry": {
+    "category": "layout",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpContainer, EpFooter, EpMain } from 'ep-craft'\n</script>\n\n<template>\n  <ep-container style=\"height: 180px\">\n    <ep-main>主体内容</ep-main>\n    <ep-footer height=\"48px\">页脚</ep-footer>\n  </ep-container>\n</template>",
+        "id": "footer-1",
+        "language": "vue",
+        "title": "页脚"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:footer",
+    "keywords": {
+      "en": [
+        "footer",
+        "layout"
+      ],
+      "zh": [
+        "页脚",
+        "布局"
+      ]
+    },
+    "kind": "component",
+    "name": "EpFooter",
+    "nonUseCases": [
+      "已有明确外层布局且无需此语义时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "页脚高度，缺省时由 theme-chalk 的 CSS 变量兜底",
+        "hasDefault": true,
+        "name": "height",
+        "required": false,
+        "type": "string"
+      }
+    ],
+    "related": [
+      "EpContainer"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [
+        "EpContainer + EpFooter"
+      ],
+      "parents": [
+        "EpContainer"
+      ],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "页脚内容",
+        "name": "default"
+      }
+    ],
+    "slug": "footer",
+    "summary": "页脚，页面结构与浮层交互",
+    "tag": "ep-footer",
+    "useCases": [
+      "使用页脚组织页面区域与间距",
+      "承载内容分组或浮层交互"
+    ],
+    "variants": [],
+    "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/footer.md

@@ -0,0 +1,63 @@
+# EpFooter
+
+`ep-footer` · layout（布局） · `component:footer`
+
+## 摘要
+
+页脚，页面结构与浮层交互
+
+## 适用场景
+
+- 适用：使用页脚组织页面区域与间距
+- 适用：承载内容分组或浮层交互
+- 不适用：已有明确外层布局且无需此语义时
+
+## 关键词
+
+- 中文：页脚、布局
+- English: footer, layout
+
+## Props
+
+- height (string，默认 见文档)：页脚高度，缺省时由 theme-chalk 的 CSS 变量兜底
+
+## Slots
+
+- default：页脚内容
+
+## 关系
+
+- 父级：EpContainer
+- 常用组合：EpContainer + EpFooter
+
+## 视觉提示
+
+- 形状：区块容器
+- 密度：宽松
+- 插槽内容：default：页脚内容
+- CSS 变量：--el-bg-color、--el-border-color、--el-border-radius-base
+
+## 示例
+
+### 页脚
+
+```vue
+<script setup lang="ts">
+import { EpContainer, EpFooter, EpMain } from 'ep-craft'
+</script>
+
+<template>
+  <ep-container style="height: 180px">
+    <ep-main>主体内容</ep-main>
+    <ep-footer height="48px">页脚</ep-footer>
+  </ep-container>
+</template>
+```
+
+## 相关条目
+
+- EpContainer
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/form-item.json

@@ -0,0 +1,242 @@
+{
+  "entry": {
+    "category": "form",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { reactive } from 'vue'\nimport { EpForm, EpFormItem, EpInput } from 'ep-craft'\n\nconst form = reactive({ username: '' })\n</script>\n\n<template>\n  <ep-form :model=\"form\" label-width=\"80px\">\n    <ep-form-item label=\"用户名\" prop=\"username\" required>\n      <ep-input v-model=\"form.username\" placeholder=\"请输入用户名\" />\n    </ep-form-item>\n  </ep-form>\n</template>",
+        "id": "form-item-1",
+        "language": "vue",
+        "title": "表单项"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "表单项大小",
+        "name": "size",
+        "type": "ComponentSize"
+      },
+      {
+        "description": "校验消息",
+        "name": "validateMessage",
+        "type": "Ref<string>"
+      },
+      {
+        "description": "校验状态",
+        "name": "validateState",
+        "type": "Ref<'' | 'error' | 'validating' | 'success'>"
+      },
+      {
+        "description": "验证表单项",
+        "name": "validate",
+        "type": "(trigger: string, callback?: FormValidateCallback) => FormValidationResult"
+      },
+      {
+        "description": "清除该表单项的验证状态",
+        "name": "clearValidate",
+        "type": "() => void"
+      },
+      {
+        "description": "对该表单项进行重置",
+        "name": "resetField",
+        "type": "() => void"
+      }
+    ],
+    "hot": true,
+    "id": "component:form-item",
+    "keywords": {
+      "en": [
+        "form-item",
+        "form",
+        "item",
+        "field",
+        "validation"
+      ],
+      "zh": [
+        "表单项",
+        "字段",
+        "校验",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpFormItem",
+    "nonUseCases": [
+      "仅展示静态文本或只读数据时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "标签文本",
+        "hasDefault": false,
+        "name": "label",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "标签宽度",
+        "hasDefault": false,
+        "name": "labelWidth",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "labelPosition",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "对应表单域 model 的字段名",
+        "hasDefault": false,
+        "name": "prop",
+        "required": false,
+        "type": "string | string[]"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否为必填项",
+        "hasDefault": true,
+        "name": "required",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "表单验证规则",
+        "hasDefault": false,
+        "name": "rules",
+        "required": false,
+        "type": "FormItemRule | FormItemRule[]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "表单域验证错误时的提示信息",
+        "hasDefault": false,
+        "name": "error",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "formItem 校验的状态",
+        "hasDefault": false,
+        "name": "validateStatus",
+        "required": false,
+        "type": "'error' | 'validating' | 'success'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "和原生标签相同能力的 for 属性",
+        "hasDefault": false,
+        "name": "for",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否使用行内形式展示校验信息",
+        "hasDefault": true,
+        "name": "inlineMessage",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否显示校验错误信息",
+        "hasDefault": true,
+        "name": "showMessage",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "default",
+        "description": "控制组件在此表单项中的大小",
+        "hasDefault": false,
+        "name": "size",
+        "required": false,
+        "type": "'large' | 'default' | 'small'"
+      }
+    ],
+    "related": [
+      "EpForm"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [
+        "EpForm + EpFormItem"
+      ],
+      "parents": [
+        "EpForm"
+      ],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "表单项的内容",
+        "name": "default"
+      },
+      {
+        "description": "标签位置显示的内容",
+        "name": "label"
+      },
+      {
+        "description": "验证错误信息的显示内容",
+        "name": "error"
+      }
+    ],
+    "slug": "form-item",
+    "summary": "表单项，承载标签、校验与内容布局",
+    "tag": "ep-form-item",
+    "useCases": [
+      "为单个字段提供标签与校验提示",
+      "构建 Form 内的字段布局"
+    ],
+    "variants": [
+      {
+        "dimension": "size",
+        "values": [
+          "large",
+          "default",
+          "small"
+        ],
+        "when": "按容器空间与信息密度选择尺寸"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-border-color",
+        "--el-border-radius-base",
+        "--el-color-primary",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "矩形输入框",
+      "slotContent": [
+        "default：表单项的内容",
+        "label：标签位置显示的内容",
+        "error：验证错误信息的显示内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/form-item.md

@@ -0,0 +1,93 @@
+# EpFormItem
+
+`ep-form-item` · form（表单） · `component:form-item`
+
+## 摘要
+
+表单项，承载标签、校验与内容布局
+
+## 适用场景
+
+- 适用：为单个字段提供标签与校验提示
+- 适用：构建 Form 内的字段布局
+- 不适用：仅展示静态文本或只读数据时
+
+## 关键词
+
+- 中文：表单项、字段、校验、表单
+- English: form-item, form, item, field, validation
+
+## 变体
+
+- size: large/default/small（按容器空间与信息密度选择尺寸）
+
+## Props
+
+- label (string)：标签文本
+- labelWidth (string | number)：标签宽度
+- labelPosition (unknown，默认 见文档)
+- prop (string | string[])：对应表单域 model 的字段名
+- required (boolean，默认 false)：是否为必填项
+- rules (FormItemRule | FormItemRule[])：表单验证规则
+- error (string)：表单域验证错误时的提示信息
+- validateStatus ('error' | 'validating' | 'success')：formItem 校验的状态
+- for (string)：和原生标签相同能力的 for 属性
+- inlineMessage (boolean，默认 false)：是否使用行内形式展示校验信息
+- showMessage (boolean，默认 true)：是否显示校验错误信息
+- size ('large' | 'default' | 'small')：控制组件在此表单项中的大小
+
+## Slots
+
+- default：表单项的内容
+- label：标签位置显示的内容
+- error：验证错误信息的显示内容
+
+## Exposes
+
+- size(ComponentSize)：表单项大小
+- validateMessage(Ref<string>)：校验消息
+- validateState(Ref<'' | 'error' | 'validating' | 'success'>)：校验状态
+- validate((trigger: string, callback?: FormValidateCallback) => FormValidationResult)：验证表单项
+- clearValidate(() => void)：清除该表单项的验证状态
+- resetField(() => void)：对该表单项进行重置
+
+## 关系
+
+- 父级：EpForm
+- 常用组合：EpForm + EpFormItem
+
+## 视觉提示
+
+- 形状：矩形输入框
+- 密度：中等
+- 插槽内容：default：表单项的内容；label：标签位置显示的内容；error：验证错误信息的显示内容
+- CSS 变量：--el-border-color、--el-border-radius-base、--el-color-primary、--el-font-size-base
+
+## 示例
+
+### 表单项
+
+```vue
+<script setup lang="ts">
+import { reactive } from 'vue'
+import { EpForm, EpFormItem, EpInput } from 'ep-craft'
+
+const form = reactive({ username: '' })
+</script>
+
+<template>
+  <ep-form :model="form" label-width="80px">
+    <ep-form-item label="用户名" prop="username" required>
+      <ep-input v-model="form.username" placeholder="请输入用户名" />
+    </ep-form-item>
+  </ep-form>
+</template>
+```
+
+## 相关条目
+
+- EpForm
+
+---
+
+ep-craft 0.2.0