ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/date-picker.md

@@ -0,0 +1,153 @@
+# EpDatePicker
+
+`ep-date-picker` · form（表单） · `component:date-picker`
+
+## 摘要
+
+日期选择器，输入或选择日期时间
+
+## 适用场景
+
+- 适用：表单日期与时间字段
+- 适用：日期范围筛选
+- 不适用：仅展示静态文本或只读数据时
+
+## 关键词
+
+- 中文：日期选择器、日期选择、时间选择、日历、表单
+- English: date-picker, date, picker, calendar, form
+
+## 变体
+
+- type: year/years/month/months/date/dates/datetime/week（通过 type 选择显示类型）
+- size: large/default/small（按容器空间与信息密度选择尺寸）
+- state: disabled/readonly（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- automaticDropdown (unknown，默认 见文档)
+- id (string | [string, string])：原生 id 属性
+- name (string | [string, string])：原生 name 属性
+- popperClass (string)：DatePicker 下拉框的类名
+- popperStyle (unknown，默认 见文档)
+- format (string)：显示在输入框中的格式
+- valueFormat (string)：可选，绑定值的格式
+- dateFormat (unknown)
+- timeFormat (unknown)
+- type ('year' | 'years' | 'month' | 'months' | 'date' | 'dates' | 'datetime' | 'week' | 'datetimerange' | 'daterange' | 'monthrange' | 'yearrange'，默认 date)：显示类型
+- clearable (boolean，默认 true)：是否显示清除按钮
+- clearIcon (string | Component，默认 CircleClose)：自定义清空图标
+- editable (boolean，默认 true)：文本框可输入
+- saveOnBlur (unknown，默认 见文档)
+- prefixIcon (string | Component，默认 Calendar)：自定义头部图标
+- size ('large' | 'default' | 'small')：输入框尺寸
+- readonly (boolean)：只读
+- disabled (boolean，默认 false)：禁用
+- placeholder (string，默认 见文档)：非范围选择时的占位内容；范围形态下作为开启 float-label 后整体浮标的文案（未传时回退 start-placeholder）
+- popperOptions (unknown，默认 见文档)
+- modelValue（别名 v-model） (Date | string | number | Date[]，默认 见文档)：绑定值
+- rangeSeparator (string，默认 '-')：选择范围时的分隔符
+- startPlaceholder (string)：范围选择时开始日期的占位内容
+- endPlaceholder (string)：范围选择时结束日期的占位内容
+- defaultValue (Date | [Date, Date])：可选，选择器打开时默认显示的时间
+- defaultTime (Date | [Date, Date])：范围选择时选中日期所使用的当日内具体时刻
+- isRange (unknown)
+- disabledHours (unknown)
+- disabledMinutes (unknown)
+- disabledSeconds (unknown)
+- disabledDate ((date: Date) => boolean)：一个用来判断该日期是否被禁用的函数
+- cellClassName ((date: Date) => string)：设置自定义类名
+- shortcuts ({ text: string, value: Date | Function }[]，默认 [])：设置快捷选项
+- arrowControl (unknown)
+- tabindex (unknown，默认 见文档)
+- validateEvent (unknown，默认 见文档)
+- unlinkPanels (boolean)：在范围选择器里取消两个日期面板之间的联动
+- singlePanel (unknown)
+- placement (unknown，默认 见文档)
+- fallbackPlacements (unknown，默认 见文档)
+- emptyValues (unknown)
+- valueOnClear (unknown，默认 见文档)
+- ariaLabel (unknown)
+- showNow (unknown，默认 见文档)
+- showConfirm (unknown，默认 见文档)
+- showFooter (unknown，默认 见文档)
+- showWeekNumber (unknown)
+- floatLabel (boolean，默认 false)：是否启用浮动标签（Material 风格），聚焦/展开面板或有值时占位文本上浮；范围形态在两端点均选后保持上浮
+
+## Events
+
+- update:modelValue((value: Date | string | number | Date[]))：选定的日期变化时触发
+
+## Exposes
+
+- focus(() => void)：使组件获取焦点
+- handleOpen(() => void)：打开日期选择器弹窗
+- handleClose(() => void)：关闭日期选择器弹窗
+
+## 视觉提示
+
+- 形状：矩形输入框
+- 密度：中等
+- 插槽内容：range-separator：自定义内容
+- 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 { EpDatePicker } from 'ep-craft'
+
+const date = ref('')
+</script>
+
+<template>
+  <ep-date-picker v-model="date" type="date" placeholder="选择日期" />
+</template>
+```
+
+### 日期范围
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { EpDatePicker } from 'ep-craft'
+
+const range = ref(['', ''])
+</script>
+
+<template>
+  <ep-date-picker
+    v-model="range"
+    type="daterange"
+    start-placeholder="开始日期"
+    end-placeholder="结束日期"
+  />
+</template>
+```
+
+### 选择月份
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { EpDatePicker } from 'ep-craft'
+
+const month = ref('')
+</script>
+
+<template>
+  <ep-date-picker v-model="month" type="month" placeholder="选择月份" />
+</template>
+```
+
+## 相关条目
+
+- EpDatePickerPanel
+- EpTimePicker
+
+---
+
+ep-craft 0.2.0

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

@@ -0,0 +1,175 @@
+{
+  "entry": {
+    "category": "data",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpDescriptions, EpDescriptionsItem } from 'ep-craft'\n</script>\n\n<template>\n  <ep-descriptions :column=\"1\">\n    <ep-descriptions-item label=\"状态\">运行中</ep-descriptions-item>\n    <ep-descriptions-item label=\"创建时间\">2026-01-01</ep-descriptions-item>\n  </ep-descriptions>\n</template>",
+        "id": "descriptions-item-1",
+        "language": "vue",
+        "title": "描述列表项"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:descriptions-item",
+    "keywords": {
+      "en": [
+        "descriptions-item",
+        "descriptions",
+        "item",
+        "data"
+      ],
+      "zh": [
+        "描述列表项",
+        "数据"
+      ]
+    },
+    "kind": "component",
+    "name": "EpDescriptionsItem",
+    "nonUseCases": [
+      "数据量极小且无需结构化展示时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "标签文本",
+        "hasDefault": true,
+        "name": "label",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "1",
+        "description": "跨列数",
+        "hasDefault": true,
+        "name": "span",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "1",
+        "description": "跨行数",
+        "hasDefault": true,
+        "name": "rowspan",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "列宽，同一列以最大值生效",
+        "hasDefault": true,
+        "name": "width",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "列最小宽度，按比例分配",
+        "hasDefault": true,
+        "name": "minWidth",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "标签列宽度，优先级高于 Descriptions 的 label-width",
+        "hasDefault": false,
+        "name": "labelWidth",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": "left",
+        "description": "内容对齐方式",
+        "hasDefault": true,
+        "name": "align",
+        "required": false,
+        "type": "'left' | 'center' | 'right'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "标签对齐方式，缺省时沿用 align",
+        "hasDefault": false,
+        "name": "labelAlign",
+        "required": false,
+        "type": "'left' | 'center' | 'right'"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "内容自定义类名",
+        "hasDefault": true,
+        "name": "className",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "标签自定义类名",
+        "hasDefault": true,
+        "name": "labelClassName",
+        "required": false,
+        "type": "string"
+      }
+    ],
+    "related": [
+      "EpDescriptions"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [
+        "EpDescriptions + EpDescriptionsItem"
+      ],
+      "parents": [
+        "EpDescriptions"
+      ],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "描述内容",
+        "name": "default"
+      },
+      {
+        "description": "自定义标签内容",
+        "name": "label"
+      }
+    ],
+    "slug": "descriptions-item",
+    "summary": "描述列表项，结构化数据展示",
+    "tag": "ep-descriptions-item",
+    "useCases": [
+      "展示描述列表项类结构化数据",
+      "需要浏览、比较或定位数据时"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-border-color-lighter",
+        "--el-bg-color",
+        "--el-text-color-regular",
+        "--el-font-size-base"
+      ],
+      "density": "紧凑",
+      "shape": "块级数据区域",
+      "slotContent": [
+        "default：描述内容",
+        "label：自定义标签内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

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

@@ -0,0 +1,73 @@
+# EpDescriptionsItem
+
+`ep-descriptions-item` · data（数据展示） · `component:descriptions-item`
+
+## 摘要
+
+描述列表项，结构化数据展示
+
+## 适用场景
+
+- 适用：展示描述列表项类结构化数据
+- 适用：需要浏览、比较或定位数据时
+- 不适用：数据量极小且无需结构化展示时
+
+## 关键词
+
+- 中文：描述列表项、数据
+- English: descriptions-item, descriptions, item, data
+
+## Props
+
+- label (string，默认 '')：标签文本
+- span (number，默认 1)：跨列数
+- rowspan (number，默认 1)：跨行数
+- width (string | number，默认 '')：列宽，同一列以最大值生效
+- minWidth (string | number，默认 '')：列最小宽度，按比例分配
+- labelWidth (string | number)：标签列宽度，优先级高于 Descriptions 的 label-width
+- align ('left' | 'center' | 'right'，默认 left)：内容对齐方式
+- labelAlign ('left' | 'center' | 'right')：标签对齐方式，缺省时沿用 align
+- className (string，默认 '')：内容自定义类名
+- labelClassName (string，默认 '')：标签自定义类名
+
+## Slots
+
+- default：描述内容
+- label：自定义标签内容
+
+## 关系
+
+- 父级：EpDescriptions
+- 常用组合：EpDescriptions + EpDescriptionsItem
+
+## 视觉提示
+
+- 形状：块级数据区域
+- 密度：紧凑
+- 插槽内容：default：描述内容；label：自定义标签内容
+- CSS 变量：--el-border-color-lighter、--el-bg-color、--el-text-color-regular、--el-font-size-base
+
+## 示例
+
+### 描述列表项
+
+```vue
+<script setup lang="ts">
+import { EpDescriptions, EpDescriptionsItem } from 'ep-craft'
+</script>
+
+<template>
+  <ep-descriptions :column="1">
+    <ep-descriptions-item label="状态">运行中</ep-descriptions-item>
+    <ep-descriptions-item label="创建时间">2026-01-01</ep-descriptions-item>
+  </ep-descriptions>
+</template>
+```
+
+## 相关条目
+
+- EpDescriptions
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/descriptions.json

@@ -0,0 +1,171 @@
+{
+  "entry": {
+    "category": "data",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpDescriptions, EpDescriptionsItem } from 'ep-craft'\n</script>\n\n<template>\n  <ep-descriptions title=\"用户信息\" :column=\"2\" border>\n    <ep-descriptions-item label=\"姓名\">张三</ep-descriptions-item>\n    <ep-descriptions-item label=\"手机\">13800000000</ep-descriptions-item>\n    <ep-descriptions-item label=\"地址\" :span=\"2\">杭州市西湖区</ep-descriptions-item>\n  </ep-descriptions>\n</template>",
+        "id": "descriptions-1",
+        "language": "vue",
+        "title": "描述列表"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:descriptions",
+    "keywords": {
+      "en": [
+        "descriptions",
+        "details",
+        "data"
+      ],
+      "zh": [
+        "描述列表",
+        "数据"
+      ]
+    },
+    "kind": "component",
+    "name": "EpDescriptions",
+    "nonUseCases": [
+      "数据量极小且无需结构化展示时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否带有边框",
+        "hasDefault": false,
+        "name": "border",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "3",
+        "description": "一行展示的描述项数量",
+        "hasDefault": true,
+        "name": "column",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "horizontal",
+        "description": "排列方向",
+        "hasDefault": true,
+        "name": "direction",
+        "required": false,
+        "type": "'horizontal' | 'vertical'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "尺寸",
+        "hasDefault": false,
+        "name": "size",
+        "required": false,
+        "type": "'' | 'large' | 'default' | 'small'"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "标题文本，显示在左上角",
+        "hasDefault": true,
+        "name": "title",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "操作区文本，显示在右上角",
+        "hasDefault": true,
+        "name": "extra",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "标签列宽度",
+        "hasDefault": false,
+        "name": "labelWidth",
+        "required": false,
+        "type": "string | number"
+      }
+    ],
+    "related": [
+      "EpDescriptionsItem"
+    ],
+    "relations": {
+      "children": [
+        "EpDescriptionsItem"
+      ],
+      "combos": [
+        "EpDescriptions + EpDescriptionsItem"
+      ],
+      "parents": [],
+      "requiredChildren": [
+        "EpDescriptionsItem"
+      ]
+    },
+    "slots": [
+      {
+        "description": "描述项内容，通常放置 ep-descriptions-item",
+        "name": "default"
+      },
+      {
+        "description": "自定义标题",
+        "name": "title"
+      },
+      {
+        "description": "自定义操作区",
+        "name": "extra"
+      }
+    ],
+    "slug": "descriptions",
+    "summary": "描述列表，结构化数据展示",
+    "tag": "ep-descriptions",
+    "useCases": [
+      "展示描述列表类结构化数据",
+      "需要浏览、比较或定位数据时"
+    ],
+    "variants": [
+      {
+        "dimension": "size",
+        "values": [
+          "large",
+          "default",
+          "small"
+        ],
+        "when": "按容器空间与信息密度选择尺寸"
+      },
+      {
+        "dimension": "effect",
+        "values": [
+          "border"
+        ],
+        "when": "通过视觉修饰属性调整外观效果"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-border-color-lighter",
+        "--el-bg-color",
+        "--el-text-color-regular",
+        "--el-font-size-base"
+      ],
+      "density": "紧凑",
+      "shape": "块级数据区域",
+      "slotContent": [
+        "default：描述项内容，通常放置 ep-descriptions-item",
+        "title：自定义标题",
+        "extra：自定义操作区"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/descriptions.md

@@ -0,0 +1,78 @@
+# EpDescriptions
+
+`ep-descriptions` · data（数据展示） · `component:descriptions`
+
+## 摘要
+
+描述列表，结构化数据展示
+
+## 适用场景
+
+- 适用：展示描述列表类结构化数据
+- 适用：需要浏览、比较或定位数据时
+- 不适用：数据量极小且无需结构化展示时
+
+## 关键词
+
+- 中文：描述列表、数据
+- English: descriptions, details, data
+
+## 变体
+
+- size: large/default/small（按容器空间与信息密度选择尺寸）
+- effect: border（通过视觉修饰属性调整外观效果）
+
+## Props
+
+- border (boolean)：是否带有边框
+- column (number，默认 3)：一行展示的描述项数量
+- direction ('horizontal' | 'vertical'，默认 horizontal)：排列方向
+- size ('' | 'large' | 'default' | 'small')：尺寸
+- title (string，默认 '')：标题文本，显示在左上角
+- extra (string，默认 '')：操作区文本，显示在右上角
+- labelWidth (string | number)：标签列宽度
+
+## Slots
+
+- default：描述项内容，通常放置 ep-descriptions-item
+- title：自定义标题
+- extra：自定义操作区
+
+## 关系
+
+- 子级：EpDescriptionsItem
+- 必需子组件：EpDescriptionsItem
+- 常用组合：EpDescriptions + EpDescriptionsItem
+
+## 视觉提示
+
+- 形状：块级数据区域
+- 密度：紧凑
+- 插槽内容：default：描述项内容，通常放置 ep-descriptions-item；title：自定义标题；extra：自定义操作区
+- CSS 变量：--el-border-color-lighter、--el-bg-color、--el-text-color-regular、--el-font-size-base
+
+## 示例
+
+### 描述列表
+
+```vue
+<script setup lang="ts">
+import { EpDescriptions, EpDescriptionsItem } from 'ep-craft'
+</script>
+
+<template>
+  <ep-descriptions title="用户信息" :column="2" border>
+    <ep-descriptions-item label="姓名">张三</ep-descriptions-item>
+    <ep-descriptions-item label="手机">13800000000</ep-descriptions-item>
+    <ep-descriptions-item label="地址" :span="2">杭州市西湖区</ep-descriptions-item>
+  </ep-descriptions>
+</template>
+```
+
+## 相关条目
+
+- EpDescriptionsItem
+
+---
+
+ep-craft 0.2.0