ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/date-picker-panel.json

@@ -0,0 +1,346 @@
+{
+  "entry": {
+    "category": "form",
+    "events": [
+      {
+        "description": "选中日期时触发",
+        "name": "update:modelValue",
+        "params": "(value: Date | string | number | Date[])"
+      },
+      {
+        "description": "日历中所选日期变化时触发",
+        "name": "calendarChange",
+        "params": "(val: [Date, null | Date])"
+      },
+      {
+        "description": "面板视图改变时触发",
+        "name": "panelChange",
+        "params": "(date: Date | [Date, Date], mode: \"month\" | \"year\", view?: string)"
+      },
+      {
+        "description": "面板可见性变化时触发",
+        "name": "visibleChange",
+        "params": "(visibility: boolean)"
+      },
+      {
+        "description": "点击清空时触发",
+        "name": "clear",
+        "params": "()"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpDatePickerPanel } from 'ep-craft'\n\nconst date = ref('')\n</script>\n\n<template>\n  <ep-date-picker-panel v-model=\"date\" type=\"date\" />\n</template>",
+        "id": "date-picker-panel-1",
+        "language": "vue",
+        "title": "日期选择面板"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:date-picker-panel",
+    "keywords": {
+      "en": [
+        "date-picker-panel",
+        "date",
+        "picker",
+        "panel",
+        "calendar",
+        "form"
+      ],
+      "zh": [
+        "日期选择面板",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpDatePickerPanel",
+    "nonUseCases": [
+      "仅展示静态文本或只读数据时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "绑定值的格式",
+        "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": null,
+        "description": "是否禁用",
+        "hasDefault": true,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": "v-model",
+        "defaultText": "''",
+        "description": "绑定值；范围形态下为长度为 2 的数组",
+        "hasDefault": true,
+        "name": "modelValue",
+        "required": false,
+        "type": "Date | string | number | Date[]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "可选，面板默认显示的日期",
+        "hasDefault": false,
+        "name": "defaultValue",
+        "required": false,
+        "type": "Date | [Date, Date]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "选中日期时所使用的当日内具体时刻",
+        "hasDefault": false,
+        "name": "defaultTime",
+        "required": false,
+        "type": "Date | [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": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "disabledMinutes",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "disabledSeconds",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "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": "{ text: string, value: Date | Function }[]"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否使用箭头进行时间选择",
+        "hasDefault": false,
+        "name": "arrowControl",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "范围选择时取消两个面板之间的联动",
+        "hasDefault": false,
+        "name": "unlinkPanels",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否显示「此刻」按钮",
+        "hasDefault": true,
+        "name": "showNow",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否显示确认按钮",
+        "hasDefault": false,
+        "name": "showConfirm",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否显示底部栏",
+        "hasDefault": false,
+        "name": "showFooter",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否显示周数",
+        "hasDefault": false,
+        "name": "showWeekNumber",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "date",
+        "description": "面板类型",
+        "hasDefault": true,
+        "name": "type",
+        "required": false,
+        "type": "'year' | 'month' | 'date' | 'dates' | 'week' | 'datetime' | 'datetimerange' | 'daterange' | 'monthrange' | 'yearrange'"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "范围选择时是否可清空",
+        "hasDefault": true,
+        "name": "clearable",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否带有边框",
+        "hasDefault": true,
+        "name": "border",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否可编辑",
+        "hasDefault": true,
+        "name": "editable",
+        "required": false,
+        "type": "boolean"
+      }
+    ],
+    "related": [
+      "EpDatePicker"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [],
+    "slug": "date-picker-panel",
+    "summary": "日期选择面板，表单数据录入控件",
+    "tag": "ep-date-picker-panel",
+    "useCases": [
+      "表单中收集或编辑日期选择面板数据",
+      "与 EpForm、EpFormItem 组合完成校验"
+    ],
+    "variants": [
+      {
+        "dimension": "type",
+        "values": [
+          "year",
+          "month",
+          "date",
+          "dates",
+          "week",
+          "datetime",
+          "datetimerange",
+          "daterange"
+        ],
+        "when": "通过 type 选择面板类型"
+      },
+      {
+        "dimension": "state",
+        "values": [
+          "disabled"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      },
+      {
+        "dimension": "effect",
+        "values": [
+          "border"
+        ],
+        "when": "通过视觉修饰属性调整外观效果"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-border-color",
+        "--el-border-radius-base",
+        "--el-color-primary",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "矩形输入框",
+      "slotContent": [
+        "default：默认内容",
+        "next-month：自定义内容",
+        "next-year：自定义内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

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

@@ -0,0 +1,91 @@
+# EpDatePickerPanel
+
+`ep-date-picker-panel` · form（表单） · `component:date-picker-panel`
+
+## 摘要
+
+日期选择面板，表单数据录入控件
+
+## 适用场景
+
+- 适用：表单中收集或编辑日期选择面板数据
+- 适用：与 EpForm、EpFormItem 组合完成校验
+- 不适用：仅展示静态文本或只读数据时
+
+## 关键词
+
+- 中文：日期选择面板、表单
+- English: date-picker-panel, date, picker, panel, calendar, form
+
+## 变体
+
+- type: year/month/date/dates/week/datetime/datetimerange/daterange（通过 type 选择面板类型）
+- state: disabled（通过布尔属性切换禁用、加载或选中状态）
+- effect: border（通过视觉修饰属性调整外观效果）
+
+## Props
+
+- valueFormat (string)：绑定值的格式
+- dateFormat (string)：面板中日期部分的格式
+- timeFormat (string)：面板中时间部分的格式
+- disabled (boolean，默认 见文档)：是否禁用
+- modelValue（别名 v-model） (Date | string | number | Date[]，默认 '')：绑定值；范围形态下为长度为 2 的数组
+- defaultValue (Date | [Date, Date])：可选，面板默认显示的日期
+- defaultTime (Date | [Date, Date])：选中日期时所使用的当日内具体时刻
+- isRange (boolean)：是否为范围选择
+- disabledHours (unknown)
+- disabledMinutes (unknown)
+- disabledSeconds (unknown)
+- disabledDate ((date: Date) => boolean)：判断某个日期是否被禁用的函数
+- cellClassName ((date: Date) => string)：设置单元格自定义类名
+- shortcuts ({ text: string, value: Date | Function }[]，默认 [])：设置快捷选项
+- arrowControl (boolean)：是否使用箭头进行时间选择
+- unlinkPanels (boolean)：范围选择时取消两个面板之间的联动
+- showNow (boolean，默认 true)：是否显示「此刻」按钮
+- showConfirm (boolean)：是否显示确认按钮
+- showFooter (boolean)：是否显示底部栏
+- showWeekNumber (boolean)：是否显示周数
+- type ('year' | 'month' | 'date' | 'dates' | 'week' | 'datetime' | 'datetimerange' | 'daterange' | 'monthrange' | 'yearrange'，默认 date)：面板类型
+- clearable (boolean，默认 true)：范围选择时是否可清空
+- border (boolean，默认 true)：是否带有边框
+- editable (boolean，默认 true)：是否可编辑
+
+## Events
+
+- update:modelValue((value: Date | string | number | Date[]))：选中日期时触发
+- calendarChange((val: [Date, null | Date]))：日历中所选日期变化时触发
+- panelChange((date: Date | [Date, Date], mode: "month" | "year", view?: string))：面板视图改变时触发
+- visibleChange((visibility: boolean))：面板可见性变化时触发
+- clear(())：点击清空时触发
+
+## 视觉提示
+
+- 形状：矩形输入框
+- 密度：中等
+- 插槽内容：default：默认内容；next-month：自定义内容；next-year：自定义内容
+- 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 { EpDatePickerPanel } from 'ep-craft'
+
+const date = ref('')
+</script>
+
+<template>
+  <ep-date-picker-panel v-model="date" type="date" />
+</template>
+```
+
+## 相关条目
+
+- EpDatePicker
+
+---
+
+ep-craft 0.2.0