ep-craft 0.1.41 → 0.2.0

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

@@ -0,0 +1,555 @@
+{
+  "entry": {
+    "category": "form",
+    "events": [
+      {
+        "description": "绑定值变化时触发",
+        "name": "update:modelValue",
+        "params": "(value: Date | number | string | Array | null)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpTimePicker } from 'ep-craft'\n\nconst time = ref('')\n</script>\n\n<template>\n  <ep-time-picker v-model=\"time\" type=\"time\" placeholder=\"选择时间\" />\n</template>",
+        "id": "time-picker-1",
+        "language": "vue",
+        "title": "时间选择"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "聚焦输入框",
+        "name": "focus",
+        "type": "() => void"
+      },
+      {
+        "description": "使输入框失焦",
+        "name": "blur",
+        "type": "() => void"
+      },
+      {
+        "description": "打开选择面板",
+        "name": "handleOpen",
+        "type": "() => void"
+      },
+      {
+        "description": "关闭选择面板",
+        "name": "handleClose",
+        "type": "() => void"
+      },
+      {
+        "description": "手动选取值",
+        "name": "onPick",
+        "type": "(date: Date | Date[]) => void"
+      }
+    ],
+    "hot": false,
+    "id": "component:time-picker",
+    "keywords": {
+      "en": [
+        "time-picker",
+        "time",
+        "picker",
+        "form"
+      ],
+      "zh": [
+        "时间选择器",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpTimePicker",
+    "nonUseCases": [
+      "仅展示静态文本或只读数据时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "输入框聚焦时是否自动弹出面板",
+        "hasDefault": true,
+        "name": "automaticDropdown",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 input id",
+        "hasDefault": false,
+        "name": "id",
+        "required": false,
+        "type": "string | string[]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 input name 属性",
+        "hasDefault": false,
+        "name": "name",
+        "required": false,
+        "type": "string | string[]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "下拉面板自定义类名",
+        "hasDefault": false,
+        "name": "popperClass",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "下拉面板自定义样式",
+        "hasDefault": true,
+        "name": "popperStyle",
+        "required": false,
+        "type": "string | object | array"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "输入框展示格式",
+        "hasDefault": false,
+        "name": "format",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "绑定值格式，缺省时为 Date 对象",
+        "hasDefault": false,
+        "name": "valueFormat",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "面板中日期展示格式",
+        "hasDefault": false,
+        "name": "dateFormat",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "面板中时间展示格式",
+        "hasDefault": false,
+        "name": "timeFormat",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "选择器类型",
+        "hasDefault": true,
+        "name": "type",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否显示清空按钮",
+        "hasDefault": true,
+        "name": "clearable",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "CircleClose",
+        "description": "自定义清空图标",
+        "hasDefault": true,
+        "name": "clearIcon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "输入框是否可编辑",
+        "hasDefault": true,
+        "name": "editable",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "未选择值时聚焦是否自动填入当前时间",
+        "hasDefault": true,
+        "name": "saveOnBlur",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "自定义前缀图标",
+        "hasDefault": true,
+        "name": "prefixIcon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "输入框尺寸",
+        "hasDefault": false,
+        "name": "size",
+        "required": false,
+        "type": "'large' | 'default' | 'small'"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否只读",
+        "hasDefault": false,
+        "name": "readonly",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "是否禁用",
+        "hasDefault": true,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "非范围模式的占位符",
+        "hasDefault": true,
+        "name": "placeholder",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "{}",
+        "description": "popper.js 配置项",
+        "hasDefault": true,
+        "name": "popperOptions",
+        "required": false,
+        "type": "Partial<Options>"
+      },
+      {
+        "alias": "v-model",
+        "defaultText": "''",
+        "description": "绑定值，范围为数组时长度应为 2",
+        "hasDefault": true,
+        "name": "modelValue",
+        "required": false,
+        "type": "Date | number | string | (Date | number | string)[] | null"
+      },
+      {
+        "alias": null,
+        "defaultText": "-",
+        "description": "范围分隔符",
+        "hasDefault": true,
+        "name": "rangeSeparator",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "范围模式下的起始占位符",
+        "hasDefault": false,
+        "name": "startPlaceholder",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "范围模式下的结束占位符",
+        "hasDefault": false,
+        "name": "endPlaceholder",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "面板的默认日期",
+        "hasDefault": false,
+        "name": "defaultValue",
+        "required": false,
+        "type": "Date | Date[]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "选择范围时使用的默认时间",
+        "hasDefault": false,
+        "name": "defaultTime",
+        "required": false,
+        "type": "Date | Date[]"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否选择时间范围",
+        "hasDefault": false,
+        "name": "isRange",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "禁用部分小时",
+        "hasDefault": false,
+        "name": "disabledHours",
+        "required": false,
+        "type": "(role: string, comparingDate?: Dayjs) => number[]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "禁用部分分钟",
+        "hasDefault": false,
+        "name": "disabledMinutes",
+        "required": false,
+        "type": "(hour: number, role: string, comparingDate?: Dayjs) => number[]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "禁用部分秒",
+        "hasDefault": false,
+        "name": "disabledSeconds",
+        "required": false,
+        "type": "(hour: number, minute: number, role: string, comparingDate?: Dayjs) => number[]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "判断日期是否禁用",
+        "hasDefault": false,
+        "name": "disabledDate",
+        "required": false,
+        "type": "(date: Date) => boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "自定义单元格类名",
+        "hasDefault": false,
+        "name": "cellClassName",
+        "required": false,
+        "type": "(date: Date) => string"
+      },
+      {
+        "alias": null,
+        "defaultText": "[]",
+        "description": "快捷选项数组",
+        "hasDefault": true,
+        "name": "shortcuts",
+        "required": false,
+        "type": "object[]"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否使用箭头按钮选择时间",
+        "hasDefault": false,
+        "name": "arrowControl",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "输入框 tabindex",
+        "hasDefault": true,
+        "name": "tabindex",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否触发表单校验",
+        "hasDefault": true,
+        "name": "validateEvent",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "范围选择时是否解除两个面板的联动",
+        "hasDefault": false,
+        "name": "unlinkPanels",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "范围选择时是否只显示一个面板",
+        "hasDefault": false,
+        "name": "singlePanel",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "bottom",
+        "description": "下拉面板位置",
+        "hasDefault": true,
+        "name": "placement",
+        "required": false,
+        "type": "Placement"
+      },
+      {
+        "alias": null,
+        "defaultText": "['bottom', 'top', 'right', 'left']",
+        "description": "下拉面板备选位置",
+        "hasDefault": true,
+        "name": "fallbackPlacements",
+        "required": false,
+        "type": "Placement[]"
+      },
+      {
+        "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"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 aria-label 属性",
+        "hasDefault": false,
+        "name": "ariaLabel",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否显示「此刻」按钮",
+        "hasDefault": true,
+        "name": "showNow",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否显示确定按钮",
+        "hasDefault": true,
+        "name": "showConfirm",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否显示面板底部",
+        "hasDefault": true,
+        "name": "showFooter",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否显示周数",
+        "hasDefault": false,
+        "name": "showWeekNumber",
+        "required": false,
+        "type": "boolean"
+      }
+    ],
+    "related": [
+      "EpDatePicker",
+      "EpTimeSelect"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义面板内容，参数包含 visible、parsedValue、format 等",
+        "name": "default"
+      },
+      {
+        "description": "自定义范围分隔符",
+        "name": "range-separator"
+      }
+    ],
+    "slug": "time-picker",
+    "summary": "时间选择器，表单数据录入控件",
+    "tag": "ep-time-picker",
+    "useCases": [
+      "表单中收集或编辑时间选择器数据",
+      "与 EpForm、EpFormItem 组合完成校验"
+    ],
+    "variants": [
+      {
+        "dimension": "size",
+        "values": [
+          "large",
+          "default",
+          "small"
+        ],
+        "when": "按容器空间与信息密度选择尺寸"
+      },
+      {
+        "dimension": "state",
+        "values": [
+          "disabled",
+          "readonly"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-border-color",
+        "--el-border-radius-base",
+        "--el-color-primary",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "矩形输入框",
+      "slotContent": [
+        "default：自定义面板内容，参数包含 visible、parsedValue、format 等",
+        "range-separator：自定义范围分隔符"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

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

@@ -0,0 +1,123 @@
+# EpTimePicker
+
+`ep-time-picker` · form（表单） · `component:time-picker`
+
+## 摘要
+
+时间选择器，表单数据录入控件
+
+## 适用场景
+
+- 适用：表单中收集或编辑时间选择器数据
+- 适用：与 EpForm、EpFormItem 组合完成校验
+- 不适用：仅展示静态文本或只读数据时
+
+## 关键词
+
+- 中文：时间选择器、表单
+- English: time-picker, time, picker, form
+
+## 变体
+
+- size: large/default/small（按容器空间与信息密度选择尺寸）
+- state: disabled/readonly（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- automaticDropdown (boolean，默认 true)：输入框聚焦时是否自动弹出面板
+- id (string | string[])：原生 input id
+- name (string | string[])：原生 input name 属性
+- popperClass (string)：下拉面板自定义类名
+- popperStyle (string | object | array，默认 见文档)：下拉面板自定义样式
+- format (string)：输入框展示格式
+- valueFormat (string)：绑定值格式，缺省时为 Date 对象
+- dateFormat (string)：面板中日期展示格式
+- timeFormat (string)：面板中时间展示格式
+- type (string，默认 '')：选择器类型
+- clearable (boolean，默认 true)：是否显示清空按钮
+- clearIcon (string | Component，默认 CircleClose)：自定义清空图标
+- editable (boolean，默认 true)：输入框是否可编辑
+- saveOnBlur (boolean，默认 true)：未选择值时聚焦是否自动填入当前时间
+- prefixIcon (string | Component，默认 '')：自定义前缀图标
+- size ('large' | 'default' | 'small')：输入框尺寸
+- readonly (boolean)：是否只读
+- disabled (boolean，默认 见文档)：是否禁用
+- placeholder (string，默认 '')：非范围模式的占位符
+- popperOptions (Partial<Options>，默认 {})：popper.js 配置项
+- modelValue（别名 v-model） (Date | number | string | (Date | number | string)[] | null，默认 '')：绑定值，范围为数组时长度应为 2
+- rangeSeparator (string，默认 -)：范围分隔符
+- startPlaceholder (string)：范围模式下的起始占位符
+- endPlaceholder (string)：范围模式下的结束占位符
+- defaultValue (Date | Date[])：面板的默认日期
+- defaultTime (Date | Date[])：选择范围时使用的默认时间
+- isRange (boolean)：是否选择时间范围
+- disabledHours ((role: string, comparingDate?: Dayjs) => number[])：禁用部分小时
+- disabledMinutes ((hour: number, role: string, comparingDate?: Dayjs) => number[])：禁用部分分钟
+- disabledSeconds ((hour: number, minute: number, role: string, comparingDate?: Dayjs) => number[])：禁用部分秒
+- disabledDate ((date: Date) => boolean)：判断日期是否禁用
+- cellClassName ((date: Date) => string)：自定义单元格类名
+- shortcuts (object[]，默认 [])：快捷选项数组
+- arrowControl (boolean)：是否使用箭头按钮选择时间
+- tabindex (string | number，默认 0)：输入框 tabindex
+- validateEvent (boolean，默认 true)：是否触发表单校验
+- unlinkPanels (boolean)：范围选择时是否解除两个面板的联动
+- singlePanel (boolean)：范围选择时是否只显示一个面板
+- placement (Placement，默认 bottom)：下拉面板位置
+- fallbackPlacements (Placement[]，默认 ['bottom', 'top', 'right', 'left'])：下拉面板备选位置
+- emptyValues (Arrayable<undefined | null | ''>)：空值数组，用于判断是否为空
+- valueOnClear ('auto' | string | number | boolean | Function | null，默认 见文档)：清空后的值
+- ariaLabel (string)：原生 aria-label 属性
+- showNow (boolean，默认 true)：是否显示「此刻」按钮
+- showConfirm (boolean，默认 true)：是否显示确定按钮
+- showFooter (boolean，默认 true)：是否显示面板底部
+- showWeekNumber (boolean)：是否显示周数
+
+## Events
+
+- update:modelValue((value: Date | number | string | Array | null))：绑定值变化时触发
+
+## Slots
+
+- default：自定义面板内容，参数包含 visible、parsedValue、format 等
+- range-separator：自定义范围分隔符
+
+## Exposes
+
+- focus(() => void)：聚焦输入框
+- blur(() => void)：使输入框失焦
+- handleOpen(() => void)：打开选择面板
+- handleClose(() => void)：关闭选择面板
+- onPick((date: Date | Date[]) => void)：手动选取值
+
+## 视觉提示
+
+- 形状：矩形输入框
+- 密度：中等
+- 插槽内容：default：自定义面板内容，参数包含 visible、parsedValue、format 等；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 { EpTimePicker } from 'ep-craft'
+
+const time = ref('')
+</script>
+
+<template>
+  <ep-time-picker v-model="time" type="time" placeholder="选择时间" />
+</template>
+```
+
+## 相关条目
+
+- EpDatePicker
+- EpTimeSelect
+
+---
+
+ep-craft 0.2.0