ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/config-provider.json

@@ -0,0 +1,222 @@
+{
+  "entry": {
+    "category": "basic",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpButton, EpConfigProvider } from 'ep-craft'\n</script>\n\n<template>\n  <ep-config-provider size=\"small\">\n    <ep-button type=\"primary\">继承小尺寸配置</ep-button>\n  </ep-config-provider>\n</template>",
+        "id": "config-provider-1",
+        "language": "vue",
+        "title": "全局尺寸配置"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:config-provider",
+    "keywords": {
+      "en": [
+        "config-provider",
+        "config",
+        "provider",
+        "theme",
+        "basic"
+      ],
+      "zh": [
+        "全局配置",
+        "基础"
+      ]
+    },
+    "kind": "component",
+    "name": "EpConfigProvider",
+    "nonUseCases": [
+      "需要完全自定义原生行为或视觉时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否启用无障碍（a11y）相关特性",
+        "hasDefault": true,
+        "name": "a11y",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "语言包对象，影响其下组件的文案渲染",
+        "hasDefault": false,
+        "name": "locale",
+        "required": false,
+        "type": "Language"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "全局组件尺寸",
+        "hasDefault": false,
+        "name": "size",
+        "required": false,
+        "type": "'large' | 'default' | 'small'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "按钮全局配置",
+        "hasDefault": false,
+        "name": "button",
+        "required": false,
+        "type": "ButtonConfigContext"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "卡片全局配置",
+        "hasDefault": false,
+        "name": "card",
+        "required": false,
+        "type": "Record<string, unknown>"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "对话框全局配置",
+        "hasDefault": false,
+        "name": "dialog",
+        "required": false,
+        "type": "Record<string, unknown>"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "链接全局配置",
+        "hasDefault": false,
+        "name": "link",
+        "required": false,
+        "type": "Record<string, unknown>"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "实验性特性开关",
+        "hasDefault": false,
+        "name": "experimentalFeatures",
+        "required": false,
+        "type": "ExperimentalFeatures"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否处理键盘导航",
+        "hasDefault": true,
+        "name": "keyboardNavigation",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "消息全局配置",
+        "hasDefault": false,
+        "name": "message",
+        "required": false,
+        "type": "MessageConfigContext"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "全局初始 zIndex",
+        "hasDefault": false,
+        "name": "zIndex",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "el",
+        "description": "全局组件类名前缀。theme-chalk 固定为 `el-*`，该值始终归一化为 `el`，传其他值会在开发环境告警且不生效",
+        "hasDefault": true,
+        "name": "namespace",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "表格全局配置",
+        "hasDefault": false,
+        "name": "table",
+        "required": false,
+        "type": "Record<string, unknown>"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "空值数组，用于判断是否为空",
+        "hasDefault": false,
+        "name": "emptyValues",
+        "required": false,
+        "type": "Arrayable<undefined | null | ''>"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "清空后的值",
+        "hasDefault": true,
+        "name": "valueOnClear",
+        "required": false,
+        "type": "'auto' | string | number | boolean | Function | null"
+      }
+    ],
+    "related": [
+      "EpButton",
+      "EpForm"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "子内容，参数为 `{ config }`",
+        "name": "default"
+      }
+    ],
+    "slug": "config-provider",
+    "summary": "全局配置，基础交互与展示元素",
+    "tag": "ep-config-provider",
+    "useCases": [
+      "页面中的全局配置展示与交互",
+      "为全局配置提供统一视觉与状态"
+    ],
+    "variants": [
+      {
+        "dimension": "size",
+        "values": [
+          "large",
+          "default",
+          "small"
+        ],
+        "when": "按容器空间与信息密度选择尺寸"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-color-primary",
+        "--el-border-radius-base",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "圆角矩形",
+      "slotContent": [
+        "default：子内容，参数为 `{ config }`"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/config-provider.md

@@ -0,0 +1,76 @@
+# EpConfigProvider
+
+`ep-config-provider` · basic（基础） · `component:config-provider`
+
+## 摘要
+
+全局配置，基础交互与展示元素
+
+## 适用场景
+
+- 适用：页面中的全局配置展示与交互
+- 适用：为全局配置提供统一视觉与状态
+- 不适用：需要完全自定义原生行为或视觉时
+
+## 关键词
+
+- 中文：全局配置、基础
+- English: config-provider, config, provider, theme, basic
+
+## 变体
+
+- size: large/default/small（按容器空间与信息密度选择尺寸）
+
+## Props
+
+- a11y (boolean，默认 true)：是否启用无障碍（a11y）相关特性
+- locale (Language)：语言包对象，影响其下组件的文案渲染
+- size ('large' | 'default' | 'small')：全局组件尺寸
+- button (ButtonConfigContext)：按钮全局配置
+- card (Record<string, unknown>)：卡片全局配置
+- dialog (Record<string, unknown>)：对话框全局配置
+- link (Record<string, unknown>)：链接全局配置
+- experimentalFeatures (ExperimentalFeatures)：实验性特性开关
+- keyboardNavigation (boolean，默认 true)：是否处理键盘导航
+- message (MessageConfigContext)：消息全局配置
+- zIndex (number)：全局初始 zIndex
+- namespace (string，默认 el)：全局组件类名前缀。theme-chalk 固定为 `el-*`，该值始终归一化为 `el`，传其他值会在开发环境告警且不生效
+- table (Record<string, unknown>)：表格全局配置
+- emptyValues (Arrayable<undefined | null | ''>)：空值数组，用于判断是否为空
+- valueOnClear ('auto' | string | number | boolean | Function | null，默认 见文档)：清空后的值
+
+## Slots
+
+- default：子内容，参数为 `{ config }`
+
+## 视觉提示
+
+- 形状：圆角矩形
+- 密度：中等
+- 插槽内容：default：子内容，参数为 `{ config }`
+- CSS 变量：--el-color-primary、--el-border-radius-base、--el-font-size-base
+
+## 示例
+
+### 全局尺寸配置
+
+```vue
+<script setup lang="ts">
+import { EpButton, EpConfigProvider } from 'ep-craft'
+</script>
+
+<template>
+  <ep-config-provider size="small">
+    <ep-button type="primary">继承小尺寸配置</ep-button>
+  </ep-config-provider>
+</template>
+```
+
+## 相关条目
+
+- EpButton
+- EpForm
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/container.json

@@ -0,0 +1,95 @@
+{
+  "entry": {
+    "category": "layout",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpAside, EpContainer, EpFooter, EpHeader, EpMain } from 'ep-craft'\n</script>\n\n<template>\n  <ep-container style=\"height: 240px\">\n    <ep-header>页头</ep-header>\n    <ep-container>\n      <ep-aside width=\"160px\">侧边栏</ep-aside>\n      <ep-main>主体内容</ep-main>\n    </ep-container>\n    <ep-footer>页脚</ep-footer>\n  </ep-container>\n</template>",
+        "id": "container-1",
+        "language": "vue",
+        "title": "页面布局容器"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:container",
+    "keywords": {
+      "en": [
+        "container",
+        "layout"
+      ],
+      "zh": [
+        "布局容器",
+        "布局"
+      ]
+    },
+    "kind": "component",
+    "name": "EpContainer",
+    "nonUseCases": [
+      "已有明确外层布局且无需此语义时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "布局方向。缺省时按子节点判定：含 Header / Footer 时为垂直，否则为水平",
+        "hasDefault": false,
+        "name": "direction",
+        "required": false,
+        "type": "'horizontal' | 'vertical'"
+      }
+    ],
+    "related": [
+      "EpHeader",
+      "EpAside",
+      "EpMain",
+      "EpFooter"
+    ],
+    "relations": {
+      "children": [
+        "EpHeader",
+        "EpAside",
+        "EpMain",
+        "EpFooter"
+      ],
+      "combos": [
+        "EpContainer + EpHeader",
+        "EpContainer + EpAside",
+        "EpContainer + EpMain",
+        "EpContainer + EpFooter"
+      ],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "容器内容，通常放置 Header / Aside / Main / Footer",
+        "name": "default"
+      }
+    ],
+    "slug": "container",
+    "summary": "布局容器，页面结构与浮层交互",
+    "tag": "ep-container",
+    "useCases": [
+      "使用布局容器组织页面区域与间距",
+      "承载内容分组或浮层交互"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-bg-color",
+        "--el-border-color",
+        "--el-border-radius-base"
+      ],
+      "density": "宽松",
+      "shape": "区块容器",
+      "slotContent": [
+        "default：容器内容，通常放置 Header / Aside / Main / Footer"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/container.md

@@ -0,0 +1,70 @@
+# EpContainer
+
+`ep-container` · layout（布局） · `component:container`
+
+## 摘要
+
+布局容器，页面结构与浮层交互
+
+## 适用场景
+
+- 适用：使用布局容器组织页面区域与间距
+- 适用：承载内容分组或浮层交互
+- 不适用：已有明确外层布局且无需此语义时
+
+## 关键词
+
+- 中文：布局容器、布局
+- English: container, layout
+
+## Props
+
+- direction ('horizontal' | 'vertical')：布局方向。缺省时按子节点判定：含 Header / Footer 时为垂直，否则为水平
+
+## Slots
+
+- default：容器内容，通常放置 Header / Aside / Main / Footer
+
+## 关系
+
+- 子级：EpHeader、EpAside、EpMain、EpFooter
+- 常用组合：EpContainer + EpHeader、EpContainer + EpAside、EpContainer + EpMain、EpContainer + EpFooter
+
+## 视觉提示
+
+- 形状：区块容器
+- 密度：宽松
+- 插槽内容：default：容器内容，通常放置 Header / Aside / Main / Footer
+- CSS 变量：--el-bg-color、--el-border-color、--el-border-radius-base
+
+## 示例
+
+### 页面布局容器
+
+```vue
+<script setup lang="ts">
+import { EpAside, EpContainer, EpFooter, EpHeader, EpMain } from 'ep-craft'
+</script>
+
+<template>
+  <ep-container style="height: 240px">
+    <ep-header>页头</ep-header>
+    <ep-container>
+      <ep-aside width="160px">侧边栏</ep-aside>
+      <ep-main>主体内容</ep-main>
+    </ep-container>
+    <ep-footer>页脚</ep-footer>
+  </ep-container>
+</template>
+```
+
+## 相关条目
+
+- EpHeader
+- EpAside
+- EpMain
+- EpFooter
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/countdown.json

@@ -0,0 +1,155 @@
+{
+  "entry": {
+    "category": "basic",
+    "events": [
+      {
+        "description": "倒计时结束时触发",
+        "name": "finish",
+        "params": "—"
+      },
+      {
+        "description": "剩余时间变化时触发",
+        "name": "change",
+        "params": "(value: number)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpCountdown } from 'ep-craft'\n\nconst value = Date.now() + 1000 * 60 * 60\n</script>\n\n<template>\n  <ep-countdown :value=\"value\" format=\"HH:mm:ss\" />\n</template>",
+        "id": "countdown-1",
+        "language": "vue",
+        "title": "倒计时"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "当前格式化后的剩余时间",
+        "name": "displayValue",
+        "type": "ComputedRef<string>"
+      }
+    ],
+    "hot": false,
+    "id": "component:countdown",
+    "keywords": {
+      "en": [
+        "countdown",
+        "timer",
+        "basic"
+      ],
+      "zh": [
+        "倒计时",
+        "基础"
+      ]
+    },
+    "kind": "component",
+    "name": "EpCountdown",
+    "nonUseCases": [
+      "需要完全自定义原生行为或视觉时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "HH:mm:ss",
+        "description": "倒计时显示格式",
+        "hasDefault": true,
+        "name": "format",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "倒计时前缀",
+        "hasDefault": false,
+        "name": "prefix",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "倒计时后缀",
+        "hasDefault": false,
+        "name": "suffix",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "倒计时标题",
+        "hasDefault": false,
+        "name": "title",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "目标时间，时间戳或 Dayjs 对象",
+        "hasDefault": true,
+        "name": "value",
+        "required": false,
+        "type": "number | Dayjs"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "数值样式",
+        "hasDefault": true,
+        "name": "valueStyle",
+        "required": false,
+        "type": "StyleValue"
+      }
+    ],
+    "related": [
+      "EpStatistic"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义标题",
+        "name": "title"
+      },
+      {
+        "description": "自定义前缀",
+        "name": "prefix"
+      },
+      {
+        "description": "自定义后缀",
+        "name": "suffix"
+      }
+    ],
+    "slug": "countdown",
+    "summary": "倒计时，基础交互与展示元素",
+    "tag": "ep-countdown",
+    "useCases": [
+      "页面中的倒计时展示与交互",
+      "为倒计时提供统一视觉与状态"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-color-primary",
+        "--el-border-radius-base",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "圆角矩形",
+      "slotContent": [
+        "title：自定义标题",
+        "prefix：自定义前缀",
+        "suffix：自定义后缀"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/countdown.md

@@ -0,0 +1,73 @@
+# EpCountdown
+
+`ep-countdown` · basic（基础） · `component:countdown`
+
+## 摘要
+
+倒计时，基础交互与展示元素
+
+## 适用场景
+
+- 适用：页面中的倒计时展示与交互
+- 适用：为倒计时提供统一视觉与状态
+- 不适用：需要完全自定义原生行为或视觉时
+
+## 关键词
+
+- 中文：倒计时、基础
+- English: countdown, timer, basic
+
+## Props
+
+- format (string，默认 HH:mm:ss)：倒计时显示格式
+- prefix (string)：倒计时前缀
+- suffix (string)：倒计时后缀
+- title (string)：倒计时标题
+- value (number | Dayjs，默认 0)：目标时间，时间戳或 Dayjs 对象
+- valueStyle (StyleValue，默认 见文档)：数值样式
+
+## Events
+
+- finish(—)：倒计时结束时触发
+- change((value: number))：剩余时间变化时触发
+
+## Slots
+
+- title：自定义标题
+- prefix：自定义前缀
+- suffix：自定义后缀
+
+## Exposes
+
+- displayValue(ComputedRef<string>)：当前格式化后的剩余时间
+
+## 视觉提示
+
+- 形状：圆角矩形
+- 密度：中等
+- 插槽内容：title：自定义标题；prefix：自定义前缀；suffix：自定义后缀
+- CSS 变量：--el-color-primary、--el-border-radius-base、--el-font-size-base
+
+## 示例
+
+### 倒计时
+
+```vue
+<script setup lang="ts">
+import { EpCountdown } from 'ep-craft'
+
+const value = Date.now() + 1000 * 60 * 60
+</script>
+
+<template>
+  <ep-countdown :value="value" format="HH:mm:ss" />
+</template>
+```
+
+## 相关条目
+
+- EpStatistic
+
+---
+
+ep-craft 0.2.0