ep-craft 0.1.42 → 0.2.0

package/dist-ai/components/calendar.json

@@ -0,0 +1,148 @@
+{
+  "entry": {
+    "category": "data",
+    "events": [
+      {
+        "description": "选中的日期变化时触发",
+        "name": "update:modelValue",
+        "params": "(value: Date)"
+      },
+      {
+        "description": "选中的日期变化时触发",
+        "name": "input",
+        "params": "(value: Date)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpCalendar } from 'ep-craft'\n\nconst date = ref(new Date())\n</script>\n\n<template>\n  <ep-calendar v-model=\"date\" style=\"height: 500px\" />\n</template>",
+        "id": "calendar-1",
+        "language": "vue",
+        "title": "日历"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "当前选中的日期",
+        "name": "selectedDay",
+        "type": "ComputedRef<Dayjs>"
+      },
+      {
+        "description": "选择指定日期",
+        "name": "pickDay",
+        "type": "(day: Dayjs) => void"
+      },
+      {
+        "description": "按类型切换日期",
+        "name": "selectDate",
+        "type": "(type: 'prev-month' | 'next-month' | 'prev-year' | 'next-year' | 'today') => void"
+      },
+      {
+        "description": "根据起止时间计算有效日期范围",
+        "name": "calculateValidatedDateRange",
+        "type": "(...args: any[]) => unknown"
+      }
+    ],
+    "hot": false,
+    "id": "component:calendar",
+    "keywords": {
+      "en": [
+        "calendar",
+        "date",
+        "data"
+      ],
+      "zh": [
+        "日历",
+        "数据"
+      ]
+    },
+    "kind": "component",
+    "name": "EpCalendar",
+    "nonUseCases": [
+      "数据量极小且无需结构化展示时"
+    ],
+    "props": [
+      {
+        "alias": "v-model",
+        "defaultText": null,
+        "description": "绑定值，选中的日期",
+        "hasDefault": false,
+        "name": "modelValue",
+        "required": false,
+        "type": "Date"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "时间范围，起止时间须为周起止日，跨度不能超过两个月",
+        "hasDefault": false,
+        "name": "range",
+        "required": false,
+        "type": "[Date, Date]"
+      },
+      {
+        "alias": null,
+        "defaultText": "button",
+        "description": "头部控制器类型",
+        "hasDefault": true,
+        "name": "controllerType",
+        "required": false,
+        "type": "'button' | 'select'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "`controller-type` 为 select 时的年月格式化函数",
+        "hasDefault": false,
+        "name": "formatter",
+        "required": false,
+        "type": "(value: number, type: 'year' | 'month') => string | number"
+      }
+    ],
+    "related": [
+      "EpDatePicker"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义头部内容，参数为 `{ date: string }`",
+        "name": "header"
+      },
+      {
+        "description": "自定义日期单元格内容",
+        "name": "date-cell"
+      }
+    ],
+    "slug": "calendar",
+    "summary": "日历，结构化数据展示",
+    "tag": "ep-calendar",
+    "useCases": [
+      "展示日历类结构化数据",
+      "需要浏览、比较或定位数据时"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-border-color-lighter",
+        "--el-bg-color",
+        "--el-text-color-regular",
+        "--el-font-size-base"
+      ],
+      "density": "紧凑",
+      "shape": "块级数据区域",
+      "slotContent": [
+        "header：自定义头部内容，参数为 `{ date: string }`",
+        "date-cell：自定义日期单元格内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/calendar.md

@@ -0,0 +1,74 @@
+# EpCalendar
+
+`ep-calendar` · data（数据展示） · `component:calendar`
+
+## 摘要
+
+日历，结构化数据展示
+
+## 适用场景
+
+- 适用：展示日历类结构化数据
+- 适用：需要浏览、比较或定位数据时
+- 不适用：数据量极小且无需结构化展示时
+
+## 关键词
+
+- 中文：日历、数据
+- English: calendar, date, data
+
+## Props
+
+- modelValue（别名 v-model） (Date)：绑定值，选中的日期
+- range ([Date, Date])：时间范围，起止时间须为周起止日，跨度不能超过两个月
+- controllerType ('button' | 'select'，默认 button)：头部控制器类型
+- formatter ((value: number, type: 'year' | 'month') => string | number)：`controller-type` 为 select 时的年月格式化函数
+
+## Events
+
+- update:modelValue((value: Date))：选中的日期变化时触发
+- input((value: Date))：选中的日期变化时触发
+
+## Slots
+
+- header：自定义头部内容，参数为 `{ date: string }`
+- date-cell：自定义日期单元格内容
+
+## Exposes
+
+- selectedDay(ComputedRef<Dayjs>)：当前选中的日期
+- pickDay((day: Dayjs) => void)：选择指定日期
+- selectDate((type: 'prev-month' | 'next-month' | 'prev-year' | 'next-year' | 'today') => void)：按类型切换日期
+- calculateValidatedDateRange((...args: any[]) => unknown)：根据起止时间计算有效日期范围
+
+## 视觉提示
+
+- 形状：块级数据区域
+- 密度：紧凑
+- 插槽内容：header：自定义头部内容，参数为 `{ date: string }`；date-cell：自定义日期单元格内容
+- CSS 变量：--el-border-color-lighter、--el-bg-color、--el-text-color-regular、--el-font-size-base
+
+## 示例
+
+### 日历
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { EpCalendar } from 'ep-craft'
+
+const date = ref(new Date())
+</script>
+
+<template>
+  <ep-calendar v-model="date" style="height: 500px" />
+</template>
+```
+
+## 相关条目
+
+- EpDatePicker
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/card.json

@@ -0,0 +1,168 @@
+{
+  "entry": {
+    "category": "basic",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpCard } from 'ep-craft'\n</script>\n\n<template>\n  <ep-card header=\"项目概览\">\n    这里是卡片内容。\n  </ep-card>\n</template>",
+        "id": "card-1",
+        "language": "vue",
+        "title": "基础卡片"
+      },
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpCard } from 'ep-craft'\n</script>\n\n<template>\n  <ep-card shadow=\"always\">\n    <template #header>审批记录</template>\n    共 3 条记录\n    <template #footer>最后更新于今天</template>\n  </ep-card>\n</template>",
+        "id": "card-2",
+        "language": "vue",
+        "title": "页头与页脚"
+      }
+    ],
+    "exposes": [],
+    "hot": true,
+    "id": "component:card",
+    "keywords": {
+      "en": [
+        "card",
+        "panel",
+        "tile",
+        "basic"
+      ],
+      "zh": [
+        "卡片",
+        "面板",
+        "容器",
+        "基础"
+      ]
+    },
+    "kind": "component",
+    "name": "EpCard",
+    "nonUseCases": [
+      "需要完全自定义原生行为或视觉时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "卡片标题",
+        "hasDefault": true,
+        "name": "header",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "卡片页脚",
+        "hasDefault": true,
+        "name": "footer",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "body 的 CSS 样式",
+        "hasDefault": true,
+        "name": "bodyStyle",
+        "required": false,
+        "type": "CSSProperties"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "headerClass",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "body 的自定义类名",
+        "hasDefault": false,
+        "name": "bodyClass",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "footerClass",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "always",
+        "description": "卡片阴影显示时机",
+        "hasDefault": true,
+        "name": "shadow",
+        "required": false,
+        "type": "'always' | 'hover' | 'never'"
+      }
+    ],
+    "related": [
+      "EpContainer",
+      "EpRow",
+      "EpCol"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义默认内容",
+        "name": "default"
+      },
+      {
+        "description": "卡片标题内容",
+        "name": "header"
+      },
+      {
+        "description": "卡片页脚内容",
+        "name": "footer"
+      }
+    ],
+    "slug": "card",
+    "summary": "内容卡片，承载分组信息与操作区域",
+    "tag": "ep-card",
+    "useCases": [
+      "页面模块分组与信息聚合",
+      "列表项或仪表盘指标容器"
+    ],
+    "variants": [
+      {
+        "dimension": "effect",
+        "values": [
+          "always",
+          "hover",
+          "never"
+        ],
+        "when": "通过视觉修饰属性调整外观效果"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-color-primary",
+        "--el-border-radius-base",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "圆角矩形",
+      "slotContent": [
+        "default：自定义默认内容",
+        "header：卡片标题内容",
+        "footer：卡片页脚内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/card.md

@@ -0,0 +1,87 @@
+# EpCard
+
+`ep-card` · basic（基础） · `component:card`
+
+## 摘要
+
+内容卡片，承载分组信息与操作区域
+
+## 适用场景
+
+- 适用：页面模块分组与信息聚合
+- 适用：列表项或仪表盘指标容器
+- 不适用：需要完全自定义原生行为或视觉时
+
+## 关键词
+
+- 中文：卡片、面板、容器、基础
+- English: card, panel, tile, basic
+
+## 变体
+
+- effect: always/hover/never（通过视觉修饰属性调整外观效果）
+
+## Props
+
+- header (string，默认 见文档)：卡片标题
+- footer (string，默认 见文档)：卡片页脚
+- bodyStyle (CSSProperties，默认 见文档)：body 的 CSS 样式
+- headerClass (unknown)
+- bodyClass (string)：body 的自定义类名
+- footerClass (unknown)
+- shadow ('always' | 'hover' | 'never'，默认 always)：卡片阴影显示时机
+
+## Slots
+
+- default：自定义默认内容
+- header：卡片标题内容
+- footer：卡片页脚内容
+
+## 视觉提示
+
+- 形状：圆角矩形
+- 密度：中等
+- 插槽内容：default：自定义默认内容；header：卡片标题内容；footer：卡片页脚内容
+- CSS 变量：--el-color-primary、--el-border-radius-base、--el-font-size-base
+
+## 示例
+
+### 基础卡片
+
+```vue
+<script setup lang="ts">
+import { EpCard } from 'ep-craft'
+</script>
+
+<template>
+  <ep-card header="项目概览">
+    这里是卡片内容。
+  </ep-card>
+</template>
+```
+
+### 页头与页脚
+
+```vue
+<script setup lang="ts">
+import { EpCard } from 'ep-craft'
+</script>
+
+<template>
+  <ep-card shadow="always">
+    <template #header>审批记录</template>
+    共 3 条记录
+    <template #footer>最后更新于今天</template>
+  </ep-card>
+</template>
+```
+
+## 相关条目
+
+- EpContainer
+- EpRow
+- EpCol
+
+---
+
+ep-craft 0.2.0

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

@@ -0,0 +1,99 @@
+{
+  "entry": {
+    "category": "data",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpCarousel, EpCarouselItem } from 'ep-craft'\n</script>\n\n<template>\n  <ep-carousel height=\"200px\">\n    <ep-carousel-item name=\"first\">\n      <div style=\"height: 200px; background: #409eff\">第一页</div>\n    </ep-carousel-item>\n    <ep-carousel-item name=\"second\">\n      <div style=\"height: 200px; background: #67c23a\">第二页</div>\n    </ep-carousel-item>\n  </ep-carousel>\n</template>",
+        "id": "carousel-item-1",
+        "language": "vue",
+        "title": "走马灯项"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:carousel-item",
+    "keywords": {
+      "en": [
+        "carousel-item",
+        "carousel",
+        "item",
+        "slide",
+        "data"
+      ],
+      "zh": [
+        "走马灯项",
+        "数据"
+      ]
+    },
+    "kind": "component",
+    "name": "EpCarouselItem",
+    "nonUseCases": [
+      "数据量极小且无需结构化展示时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "幻灯片名称，可用于 setActiveItem",
+        "hasDefault": true,
+        "name": "name",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "对应指示器的文本内容",
+        "hasDefault": true,
+        "name": "label",
+        "required": false,
+        "type": "string | number"
+      }
+    ],
+    "related": [
+      "EpCarousel"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [
+        "EpCarousel + EpCarouselItem"
+      ],
+      "parents": [
+        "EpCarousel"
+      ],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "幻灯片内容",
+        "name": "default"
+      }
+    ],
+    "slug": "carousel-item",
+    "summary": "走马灯项，结构化数据展示",
+    "tag": "ep-carousel-item",
+    "useCases": [
+      "展示走马灯项类结构化数据",
+      "需要浏览、比较或定位数据时"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-border-color-lighter",
+        "--el-bg-color",
+        "--el-text-color-regular",
+        "--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/carousel-item.md

@@ -0,0 +1,68 @@
+# EpCarouselItem
+
+`ep-carousel-item` · data（数据展示） · `component:carousel-item`
+
+## 摘要
+
+走马灯项，结构化数据展示
+
+## 适用场景
+
+- 适用：展示走马灯项类结构化数据
+- 适用：需要浏览、比较或定位数据时
+- 不适用：数据量极小且无需结构化展示时
+
+## 关键词
+
+- 中文：走马灯项、数据
+- English: carousel-item, carousel, item, slide, data
+
+## Props
+
+- name (string，默认 '')：幻灯片名称，可用于 setActiveItem
+- label (string | number，默认 '')：对应指示器的文本内容
+
+## Slots
+
+- default：幻灯片内容
+
+## 关系
+
+- 父级：EpCarousel
+- 常用组合：EpCarousel + EpCarouselItem
+
+## 视觉提示
+
+- 形状：块级数据区域
+- 密度：紧凑
+- 插槽内容：default：幻灯片内容
+- CSS 变量：--el-border-color-lighter、--el-bg-color、--el-text-color-regular、--el-font-size-base
+
+## 示例
+
+### 走马灯项
+
+```vue
+<script setup lang="ts">
+import { EpCarousel, EpCarouselItem } from 'ep-craft'
+</script>
+
+<template>
+  <ep-carousel height="200px">
+    <ep-carousel-item name="first">
+      <div style="height: 200px; background: #409eff">第一页</div>
+    </ep-carousel-item>
+    <ep-carousel-item name="second">
+      <div style="height: 200px; background: #67c23a">第二页</div>
+    </ep-carousel-item>
+  </ep-carousel>
+</template>
+```
+
+## 相关条目
+
+- EpCarousel
+
+---
+
+ep-craft 0.2.0