ep-craft 0.1.41 → 0.2.0

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

@@ -0,0 +1,574 @@
+{
+  "entry": {
+    "category": "form",
+    "events": [
+      {
+        "description": "选定的日期变化时触发",
+        "name": "update:modelValue",
+        "params": "(value: Date | string | number | Date[])"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpDatePicker } from 'ep-craft'\n\nconst date = ref('')\n</script>\n\n<template>\n  <ep-date-picker v-model=\"date\" type=\"date\" placeholder=\"选择日期\" />\n</template>",
+        "id": "date-picker-1",
+        "language": "vue",
+        "title": "选择日期"
+      },
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpDatePicker } from 'ep-craft'\n\nconst range = ref(['', ''])\n</script>\n\n<template>\n  <ep-date-picker\n    v-model=\"range\"\n    type=\"daterange\"\n    start-placeholder=\"开始日期\"\n    end-placeholder=\"结束日期\"\n  />\n</template>",
+        "id": "date-picker-2",
+        "language": "vue",
+        "title": "日期范围"
+      },
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpDatePicker } from 'ep-craft'\n\nconst month = ref('')\n</script>\n\n<template>\n  <ep-date-picker v-model=\"month\" type=\"month\" placeholder=\"选择月份\" />\n</template>",
+        "id": "date-picker-3",
+        "language": "vue",
+        "title": "选择月份"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "使组件获取焦点",
+        "name": "focus",
+        "type": "() => void"
+      },
+      {
+        "description": "打开日期选择器弹窗",
+        "name": "handleOpen",
+        "type": "() => void"
+      },
+      {
+        "description": "关闭日期选择器弹窗",
+        "name": "handleClose",
+        "type": "() => void"
+      }
+    ],
+    "hot": true,
+    "id": "component:date-picker",
+    "keywords": {
+      "en": [
+        "date-picker",
+        "date",
+        "picker",
+        "calendar",
+        "form"
+      ],
+      "zh": [
+        "日期选择器",
+        "日期选择",
+        "时间选择",
+        "日历",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpDatePicker",
+    "nonUseCases": [
+      "仅展示静态文本或只读数据时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "automaticDropdown",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 id 属性",
+        "hasDefault": false,
+        "name": "id",
+        "required": false,
+        "type": "string | [string, string]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 name 属性",
+        "hasDefault": false,
+        "name": "name",
+        "required": false,
+        "type": "string | [string, string]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "DatePicker 下拉框的类名",
+        "hasDefault": false,
+        "name": "popperClass",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "popperStyle",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "显示在输入框中的格式",
+        "hasDefault": false,
+        "name": "format",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "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": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "timeFormat",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "date",
+        "description": "显示类型",
+        "hasDefault": true,
+        "name": "type",
+        "required": false,
+        "type": "'year' | 'years' | 'month' | 'months' | 'date' | 'dates' | 'datetime' | 'week' | 'datetimerange' | 'daterange' | 'monthrange' | 'yearrange'"
+      },
+      {
+        "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": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "saveOnBlur",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "Calendar",
+        "description": "自定义头部图标",
+        "hasDefault": true,
+        "name": "prefixIcon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": "default",
+        "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": "false",
+        "description": "禁用",
+        "hasDefault": true,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "非范围选择时的占位内容；范围形态下作为开启 float-label 后整体浮标的文案（未传时回退 start-placeholder）",
+        "hasDefault": true,
+        "name": "placeholder",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "popperOptions",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": "v-model",
+        "defaultText": null,
+        "description": "绑定值",
+        "hasDefault": true,
+        "name": "modelValue",
+        "required": false,
+        "type": "Date | string | number | Date[]"
+      },
+      {
+        "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, Date]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "范围选择时选中日期所使用的当日内具体时刻",
+        "hasDefault": false,
+        "name": "defaultTime",
+        "required": false,
+        "type": "Date | [Date, Date]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "isRange",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "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": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "arrowControl",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "tabindex",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "validateEvent",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "在范围选择器里取消两个日期面板之间的联动",
+        "hasDefault": false,
+        "name": "unlinkPanels",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "singlePanel",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "placement",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "fallbackPlacements",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "emptyValues",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "valueOnClear",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "ariaLabel",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "showNow",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "showConfirm",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "showFooter",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "showWeekNumber",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否启用浮动标签（Material 风格），聚焦/展开面板或有值时占位文本上浮；范围形态在两端点均选后保持上浮",
+        "hasDefault": true,
+        "name": "floatLabel",
+        "required": false,
+        "type": "boolean"
+      }
+    ],
+    "related": [
+      "EpDatePickerPanel",
+      "EpTimePicker"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [],
+    "slug": "date-picker",
+    "summary": "日期选择器，输入或选择日期时间",
+    "tag": "ep-date-picker",
+    "useCases": [
+      "表单日期与时间字段",
+      "日期范围筛选"
+    ],
+    "variants": [
+      {
+        "dimension": "type",
+        "values": [
+          "year",
+          "years",
+          "month",
+          "months",
+          "date",
+          "dates",
+          "datetime",
+          "week"
+        ],
+        "when": "通过 type 选择显示类型"
+      },
+      {
+        "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": [
+        "range-separator：自定义内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}