ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/time-select.json

@@ -0,0 +1,321 @@
+{
+  "entry": {
+    "category": "form",
+    "events": [
+      {
+        "description": "选中值变化时触发",
+        "name": "change",
+        "params": "(value: string | null)"
+      },
+      {
+        "description": "失焦时触发",
+        "name": "blur",
+        "params": "(evt: FocusEvent)"
+      },
+      {
+        "description": "聚焦时触发",
+        "name": "focus",
+        "params": "(evt: FocusEvent)"
+      },
+      {
+        "description": "清空时触发",
+        "name": "clear",
+        "params": "—"
+      },
+      {
+        "description": "绑定值变化时触发",
+        "name": "update:modelValue",
+        "params": "(value: string | null)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpTimeSelect } from 'ep-craft'\n\nconst value = ref('09:00')\n</script>\n\n<template>\n  <ep-time-select v-model=\"value\" start=\"08:00\" end=\"18:00\" step=\"01:00\" />\n</template>",
+        "id": "time-select-1",
+        "language": "vue",
+        "title": "时间选择"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "使输入框聚焦",
+        "name": "focus",
+        "type": "() => void"
+      },
+      {
+        "description": "使输入框失焦",
+        "name": "blur",
+        "type": "() => void"
+      }
+    ],
+    "hot": false,
+    "id": "component:time-select",
+    "keywords": {
+      "en": [
+        "time-select",
+        "time",
+        "select",
+        "form"
+      ],
+      "zh": [
+        "时间选择",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpTimeSelect",
+    "nonUseCases": [
+      "仅展示静态文本或只读数据时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "HH:mm",
+        "description": "时间格式",
+        "hasDefault": true,
+        "name": "format",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": "v-model",
+        "defaultText": null,
+        "description": "绑定值",
+        "hasDefault": false,
+        "name": "modelValue",
+        "required": false,
+        "type": "string | null"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "是否禁用",
+        "hasDefault": true,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "输入框是否可编辑",
+        "hasDefault": true,
+        "name": "editable",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "light",
+        "description": "下拉框主题",
+        "hasDefault": true,
+        "name": "effect",
+        "required": false,
+        "type": "'dark' | 'light'"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否显示清空按钮",
+        "hasDefault": true,
+        "name": "clearable",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "输入框尺寸",
+        "hasDefault": false,
+        "name": "size",
+        "required": false,
+        "type": "'large' | 'default' | 'small'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "占位符",
+        "hasDefault": false,
+        "name": "placeholder",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "09:00",
+        "description": "选项起始时间",
+        "hasDefault": true,
+        "name": "start",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "18:00",
+        "description": "选项结束时间",
+        "hasDefault": true,
+        "name": "end",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "00:30",
+        "description": "选项时间间隔",
+        "hasDefault": true,
+        "name": "step",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "最早可选时间，早于此时间的选项将被禁用",
+        "hasDefault": false,
+        "name": "minTime",
+        "required": false,
+        "type": "string | null"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "最晚可选时间，晚于此时间的选项将被禁用",
+        "hasDefault": false,
+        "name": "maxTime",
+        "required": false,
+        "type": "string | null"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "选项是否包含结束时间",
+        "hasDefault": false,
+        "name": "includeEndTime",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 input name 属性",
+        "hasDefault": false,
+        "name": "name",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "Clock",
+        "description": "自定义前缀图标",
+        "hasDefault": true,
+        "name": "prefixIcon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": "CircleClose",
+        "description": "自定义清空图标",
+        "hasDefault": true,
+        "name": "clearIcon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "下拉框自定义类名",
+        "hasDefault": true,
+        "name": "popperClass",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "下拉框自定义样式",
+        "hasDefault": true,
+        "name": "popperStyle",
+        "required": false,
+        "type": "string | CSSProperties"
+      },
+      {
+        "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": [
+      "EpTimePicker",
+      "EpSelect"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [],
+    "slug": "time-select",
+    "summary": "时间选择，表单数据录入控件",
+    "tag": "ep-time-select",
+    "useCases": [
+      "表单中收集或编辑时间选择数据",
+      "与 EpForm、EpFormItem 组合完成校验"
+    ],
+    "variants": [
+      {
+        "dimension": "size",
+        "values": [
+          "large",
+          "default",
+          "small"
+        ],
+        "when": "按容器空间与信息密度选择尺寸"
+      },
+      {
+        "dimension": "state",
+        "values": [
+          "disabled"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      },
+      {
+        "dimension": "effect",
+        "values": [
+          "dark",
+          "light"
+        ],
+        "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/time-select.md

@@ -0,0 +1,93 @@
+# EpTimeSelect
+
+`ep-time-select` · form（表单） · `component:time-select`
+
+## 摘要
+
+时间选择，表单数据录入控件
+
+## 适用场景
+
+- 适用：表单中收集或编辑时间选择数据
+- 适用：与 EpForm、EpFormItem 组合完成校验
+- 不适用：仅展示静态文本或只读数据时
+
+## 关键词
+
+- 中文：时间选择、表单
+- English: time-select, time, select, form
+
+## 变体
+
+- size: large/default/small（按容器空间与信息密度选择尺寸）
+- state: disabled（通过布尔属性切换禁用、加载或选中状态）
+- effect: dark/light（通过视觉修饰属性调整外观效果）
+
+## Props
+
+- format (string，默认 HH:mm)：时间格式
+- modelValue（别名 v-model） (string | null)：绑定值
+- disabled (boolean，默认 见文档)：是否禁用
+- editable (boolean，默认 true)：输入框是否可编辑
+- effect ('dark' | 'light'，默认 light)：下拉框主题
+- clearable (boolean，默认 true)：是否显示清空按钮
+- size ('large' | 'default' | 'small')：输入框尺寸
+- placeholder (string)：占位符
+- start (string，默认 09:00)：选项起始时间
+- end (string，默认 18:00)：选项结束时间
+- step (string，默认 00:30)：选项时间间隔
+- minTime (string | null)：最早可选时间，早于此时间的选项将被禁用
+- maxTime (string | null)：最晚可选时间，晚于此时间的选项将被禁用
+- includeEndTime (boolean)：选项是否包含结束时间
+- name (string)：原生 input name 属性
+- prefixIcon (string | Component，默认 Clock)：自定义前缀图标
+- clearIcon (string | Component，默认 CircleClose)：自定义清空图标
+- popperClass (string，默认 '')：下拉框自定义类名
+- popperStyle (string | CSSProperties，默认 见文档)：下拉框自定义样式
+- emptyValues (Arrayable<undefined | null | ''>)：空值数组，用于判断是否为空
+- valueOnClear ('auto' | string | number | boolean | Function | null，默认 见文档)：清空后的值
+
+## Events
+
+- change((value: string | null))：选中值变化时触发
+- blur((evt: FocusEvent))：失焦时触发
+- focus((evt: FocusEvent))：聚焦时触发
+- clear(—)：清空时触发
+- update:modelValue((value: string | null))：绑定值变化时触发
+
+## Exposes
+
+- focus(() => void)：使输入框聚焦
+- blur(() => void)：使输入框失焦
+
+## 视觉提示
+
+- 形状：矩形输入框
+- 密度：中等
+- 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 { EpTimeSelect } from 'ep-craft'
+
+const value = ref('09:00')
+</script>
+
+<template>
+  <ep-time-select v-model="value" start="08:00" end="18:00" step="01:00" />
+</template>
+```
+
+## 相关条目
+
+- EpTimePicker
+- EpSelect
+
+---
+
+ep-craft 0.2.0

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

@@ -0,0 +1,186 @@
+{
+  "entry": {
+    "category": "data",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpTimeline, EpTimelineItem } from 'ep-craft'\n</script>\n\n<template>\n  <ep-timeline>\n    <ep-timeline-item timestamp=\"2026-01-01\">创建项目</ep-timeline-item>\n    <ep-timeline-item timestamp=\"2026-01-02\">提交审核</ep-timeline-item>\n    <ep-timeline-item timestamp=\"2026-01-03\" type=\"success\">审核通过</ep-timeline-item>\n  </ep-timeline>\n</template>",
+        "id": "timeline-item-1",
+        "language": "vue",
+        "title": "时间线项"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:timeline-item",
+    "keywords": {
+      "en": [
+        "timeline-item",
+        "timeline",
+        "item",
+        "data"
+      ],
+      "zh": [
+        "时间线项",
+        "数据"
+      ]
+    },
+    "kind": "component",
+    "name": "EpTimelineItem",
+    "nonUseCases": [
+      "数据量极小且无需结构化展示时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "时间戳内容",
+        "hasDefault": true,
+        "name": "timestamp",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否隐藏时间戳",
+        "hasDefault": false,
+        "name": "hideTimestamp",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否垂直居中",
+        "hasDefault": false,
+        "name": "center",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "bottom",
+        "description": "时间戳位置",
+        "hasDefault": true,
+        "name": "placement",
+        "required": false,
+        "type": "'top' | 'bottom'"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "节点类型",
+        "hasDefault": true,
+        "name": "type",
+        "required": false,
+        "type": "'primary' | 'success' | 'warning' | 'danger' | 'info' | ''"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "节点背景色",
+        "hasDefault": true,
+        "name": "color",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "normal",
+        "description": "节点尺寸",
+        "hasDefault": true,
+        "name": "size",
+        "required": false,
+        "type": "'normal' | 'large'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "节点图标组件",
+        "hasDefault": false,
+        "name": "icon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "图标是否为空心",
+        "hasDefault": false,
+        "name": "hollow",
+        "required": false,
+        "type": "boolean"
+      }
+    ],
+    "related": [
+      "EpTimeline"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [
+        "EpTimeline + EpTimelineItem"
+      ],
+      "parents": [
+        "EpTimeline"
+      ],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "节点内容",
+        "name": "default"
+      },
+      {
+        "description": "自定义节点图标",
+        "name": "dot"
+      }
+    ],
+    "slug": "timeline-item",
+    "summary": "时间线项，结构化数据展示",
+    "tag": "ep-timeline-item",
+    "useCases": [
+      "展示时间线项类结构化数据",
+      "需要浏览、比较或定位数据时"
+    ],
+    "variants": [
+      {
+        "dimension": "type",
+        "values": [
+          "primary",
+          "success",
+          "warning",
+          "danger",
+          "info"
+        ],
+        "when": "通过 type 选择节点类型"
+      },
+      {
+        "dimension": "size",
+        "values": [
+          "normal",
+          "large"
+        ],
+        "when": "按容器空间与信息密度选择尺寸"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-border-color-lighter",
+        "--el-bg-color",
+        "--el-text-color-regular",
+        "--el-font-size-base"
+      ],
+      "density": "紧凑",
+      "shape": "块级数据区域",
+      "slotContent": [
+        "default：节点内容",
+        "dot：自定义节点图标"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

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

@@ -0,0 +1,78 @@
+# EpTimelineItem
+
+`ep-timeline-item` · data（数据展示） · `component:timeline-item`
+
+## 摘要
+
+时间线项，结构化数据展示
+
+## 适用场景
+
+- 适用：展示时间线项类结构化数据
+- 适用：需要浏览、比较或定位数据时
+- 不适用：数据量极小且无需结构化展示时
+
+## 关键词
+
+- 中文：时间线项、数据
+- English: timeline-item, timeline, item, data
+
+## 变体
+
+- type: primary/success/warning/danger/info（通过 type 选择节点类型）
+- size: normal/large（按容器空间与信息密度选择尺寸）
+
+## Props
+
+- timestamp (string，默认 '')：时间戳内容
+- hideTimestamp (boolean)：是否隐藏时间戳
+- center (boolean)：是否垂直居中
+- placement ('top' | 'bottom'，默认 bottom)：时间戳位置
+- type ('primary' | 'success' | 'warning' | 'danger' | 'info' | ''，默认 '')：节点类型
+- color (string，默认 '')：节点背景色
+- size ('normal' | 'large'，默认 normal)：节点尺寸
+- icon (string | Component)：节点图标组件
+- hollow (boolean)：图标是否为空心
+
+## Slots
+
+- default：节点内容
+- dot：自定义节点图标
+
+## 关系
+
+- 父级：EpTimeline
+- 常用组合：EpTimeline + EpTimelineItem
+
+## 视觉提示
+
+- 形状：块级数据区域
+- 密度：紧凑
+- 插槽内容：default：节点内容；dot：自定义节点图标
+- CSS 变量：--el-border-color-lighter、--el-bg-color、--el-text-color-regular、--el-font-size-base
+
+## 示例
+
+### 时间线项
+
+```vue
+<script setup lang="ts">
+import { EpTimeline, EpTimelineItem } from 'ep-craft'
+</script>
+
+<template>
+  <ep-timeline>
+    <ep-timeline-item timestamp="2026-01-01">创建项目</ep-timeline-item>
+    <ep-timeline-item timestamp="2026-01-02">提交审核</ep-timeline-item>
+    <ep-timeline-item timestamp="2026-01-03" type="success">审核通过</ep-timeline-item>
+  </ep-timeline>
+</template>
+```
+
+## 相关条目
+
+- EpTimeline
+
+---
+
+ep-craft 0.2.0