x-next 1.13.0 → 1.15.0

package/AI_USAGE/components/date-picker-api.md

@@ -0,0 +1,1114 @@
+<!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
+# DatePicker 完整公开 API
+
+适用版本：x-next@1.15.0；来源指纹：`47ea153587c8d0b3bf318977b10bde9f8dd4acff90c5818541ba6513252ad362`。
+
+从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
+
+## DatePicker API
+
+公开声明：`dist/components/date-picker/index.d.ts`。 类型中的 undefined 表示可省略；原始 prop 默认值不等于继承配置或服务默认值。
+
+### Props
+
+| 名称 | 用途 | 公开类型 | 必填 | 声明默认值 |
+| --- | --- | --- | --- | --- |
+| type | 选择器类型 | undefined &#124; "date" &#124; "month" &#124; "year" &#124; "quarter" &#124; "week" &#124; "date-range" &#124; "month-range" &#124; "year-range" &#124; "quarter-range" &#124; "week-range" | 否 | "date" |
+| modelValue | 绑定值 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 未声明 |
+| defaultValue | 默认值 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 未声明 |
+| pickerValue | 面板显示日期 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 未声明 |
+| defaultPickerValue | 默认面板显示日期 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 未声明 |
+| placeholder | 占位文案 | undefined &#124; string &#124; string[] | 否 | 未声明 |
+| disabled | 是否禁用 | undefined &#124; false &#124; true &#124; boolean[] | 否 | false |
+| readonly | 是否只读 | undefined &#124; false &#124; true | 否 | false |
+| disabledInput | 禁止输入框键盘输入但允许面板选择 | undefined &#124; false &#124; true | 否 | false |
+| inputReadOnly | 输入框只读，常用于移动端避免软键盘 | undefined &#124; false &#124; true | 否 | false |
+| error | 是否错误态 | undefined &#124; false &#124; true | 否 | false |
+| allowClear | 是否允许清除 | undefined &#124; false &#124; true | 否 | true |
+| format | 展示和解析格式 | undefined &#124; string | 否 | 未声明 |
+| valueFormat | 值格式 | undefined &#124; string | 否 | 未声明 |
+| size | 输入框尺寸 | undefined &#124; "mini" &#124; "small" &#124; "medium" &#124; "large" | 否 | 未声明 |
+| dayStartOfWeek | 每周起始日 | undefined &#124; 0 &#124; 1 &#124; 2 &#124; 4 &#124; 3 &#124; 5 &#124; 6 | 否 | 0 |
+| disabledDate | 禁用日期 | undefined &#124; (current: Date, type?: DatePickerRange, context?: DatePickerDisabledDateContext) => boolean | 否 | 未声明 |
+| hideNotInViewDates | 隐藏非当前月份日期 | undefined &#124; false &#124; true | 否 | false |
+| popupVisible | 控制弹层显示 | undefined &#124; false &#124; true | 否 | undefined |
+| defaultPopupVisible | 默认弹层显示 | undefined &#124; false &#124; true | 否 | false |
+| position | 弹出位置 | undefined &#124; "top" &#124; "bottom" &#124; "tl" &#124; "tr" &#124; "bl" &#124; "br" | 否 | "bl" |
+| popupContainer | 弹层挂载容器 | undefined &#124; string &#124; HTMLElement | 否 | 未声明 |
+| triggerProps | 透传 Trigger 配置 | undefined &#124; { [x: string]: any; } | 否 | 未声明 |
+| unmountOnClose | 关闭后销毁面板 | undefined &#124; false &#124; true | 否 | false |
+| shortcuts | 快捷项 | undefined &#124; DatePickerShortcut[] | 否 | [] |
+| showToday | 是否显示今天 / 本月 / 今年按钮 | undefined &#124; false &#124; true | 否 | true |
+| showConfirmBtn | 是否显示确认按钮 | undefined &#124; false &#124; true | 否 | false |
+| showTime | 是否开启日期时间选择，仅 date / date-range 生效 | undefined &#124; false &#124; true | 否 | false |
+| timePickerProps | 时间列配置，支持 format、step、use12Hours、disabledHours、disabledMinutes、disabledSeconds、hideDisabledOptions、defaultValue | undefined &#124; { [x: string]: any; } | 否 | 未声明 |
+| disabledTime | 禁用时间，需要配合 showTime 使用 | undefined &#124; (current?: Date, type?: DatePickerRange) => Record<string, any> &#124; undefined | 否 | 未声明 |
+| showLunar | 是否展示中国农历辅助信息，支持控制农历日期、农历节日、节气和公历节日 | undefined &#124; false &#124; true &#124; { showLunarDate?: boolean; showLunarFestival?: boolean; showSolarTerm?: boolean; showSolarFestival?: boolean; fallbackText?: string; } | 否 | false |
+
+### Events
+
+| 事件 | 用途 | 监听器签名（即事件参数） |
+| --- | --- | --- |
+| update:modelValue | 值更新 | undefined &#124; (_value: DatePickerModelValue) => any |
+| update:popupVisible | 受控弹层更新 | undefined &#124; (_visible: boolean) => any |
+| update:pickerValue | 面板值更新 | undefined &#124; (_value: DatePickerModelValue) => any |
+| change | 确认值变化 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| select | 面板选择但未必提交 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| calendar-change | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown, _info: { range: DatePickerRange; }) => any |
+| clear | 点击清除 | undefined &#124; (_ev: MouseEvent) => any |
+| ok | 点击确定 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| popup-visible-change | 见场景用法与类型 | undefined &#124; (_visible: boolean) => any |
+| picker-value-change | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| select-shortcut | 见场景用法与类型 | undefined &#124; (_shortcut: DatePickerShortcut) => any |
+| focus | 输入框聚焦 | undefined &#124; (_ev: FocusEvent) => any |
+| blur | 输入框失焦 | undefined &#124; (_ev: FocusEvent) => any |
+
+### Slots
+
+| 名称 | 用途 | 公开类型 |
+| --- | --- | --- |
+| prefix | 输入框前缀 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| suffix-icon | 输入框后缀图标 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| separator | 范围输入分隔符 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| cell | 自定义日期单元格 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| extra | 面板快捷区额外内容 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+
+### 实例方法
+
+没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+
+### 关联类型定义
+
+以下摘自本组件族声明，供查阅嵌套配置；运行时和值类型均以根入口可导出项为准。
+
+```typescript-reference
+type DatePickerValue = string | number | Date;
+
+type DatePickerModelValue = DatePickerValue | (DatePickerValue | undefined)[] | undefined;
+
+type DatePickerMode = 'date' | 'month' | 'year' | 'quarter' | 'week';
+
+type DatePickerType = DatePickerMode | 'date-range' | 'month-range' | 'year-range' | 'quarter-range' | 'week-range';
+
+type DatePickerPosition = 'top' | 'tl' | 'tr' | 'bottom' | 'bl' | 'br';
+
+type DatePickerSize = 'mini' | 'small' | 'medium' | 'large';
+
+type DatePickerValueFormat = 'timestamp' | 'Date' | string;
+
+type DatePickerRange = 'start' | 'end';
+
+interface DatePickerTimePickerProps {
+    format?: string;
+    use12Hours?: boolean;
+    step?: {
+        hour?: number;
+        minute?: number;
+        second?: number;
+    };
+    disabledHours?: () => number[];
+    disabledMinutes?: (selectedHour?: number) => number[];
+    disabledSeconds?: (selectedHour?: number, selectedMinute?: number) => number[];
+    hideDisabledOptions?: boolean;
+    defaultValue?: DatePickerValue | (DatePickerValue | undefined)[];
+}
+
+interface DatePickerDisabledTimeProps {
+    disabledHours?: () => number[];
+    disabledMinutes?: (selectedHour?: number) => number[];
+    disabledSeconds?: (selectedHour?: number, selectedMinute?: number) => number[];
+}
+
+type DatePickerDisabledTime = (current?: Date, type?: DatePickerRange) => DatePickerDisabledTimeProps | undefined;
+
+interface DatePickerDisabledDateContext {
+    value: DatePickerModelValue;
+    selecting?: DatePickerRange;
+}
+
+type DatePickerDisabledDate = (current: Date, type?: DatePickerRange, context?: DatePickerDisabledDateContext) => boolean;
+
+type DatePickerCellSlot = (current: Date) => unknown;
+
+interface DatePickerShortcut {
+    label: string | number;
+    value: DatePickerValue | (DatePickerValue | undefined)[] | (() => DatePickerValue | (DatePickerValue | undefined)[]);
+    format?: string;
+}
+
+interface DatePickerCell {
+    value: Dayjs;
+    label: string;
+    title: string;
+    inView: boolean;
+    outView: boolean;
+    isWeekLabel?: boolean;
+    weekStart?: boolean;
+    weekEnd?: boolean;
+    weekSelected?: boolean;
+    weekLabel?: string;
+    selected: boolean;
+    rangeStart: boolean;
+    rangeEnd: boolean;
+    inRange: boolean;
+    previewRangeStart: boolean;
+    previewRangeEnd: boolean;
+    inPreviewRange: boolean;
+    today: boolean;
+    disabled: boolean;
+    lunar?: LunarInfo;
+}
+
+interface DatePickerProps {
+    type?: DatePickerType;
+    modelValue?: DatePickerModelValue;
+    defaultValue?: DatePickerModelValue;
+    pickerValue?: DatePickerModelValue;
+    defaultPickerValue?: DatePickerModelValue;
+    placeholder?: string | string[];
+    disabled?: boolean | boolean[];
+    readonly?: boolean;
+    disabledInput?: boolean;
+    inputReadOnly?: boolean;
+    error?: boolean;
+    allowClear?: boolean;
+    format?: string;
+    valueFormat?: DatePickerValueFormat;
+    size?: DatePickerSize;
+    dayStartOfWeek?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    disabledDate?: DatePickerDisabledDate;
+    hideNotInViewDates?: boolean;
+    popupVisible?: boolean;
+    defaultPopupVisible?: boolean;
+    position?: DatePickerPosition;
+    popupContainer?: string | HTMLElement;
+    triggerProps?: Partial<TriggerProps>;
+    unmountOnClose?: boolean;
+    shortcuts?: DatePickerShortcut[];
+    showToday?: boolean;
+    showConfirmBtn?: boolean;
+    showTime?: boolean;
+    timePickerProps?: DatePickerTimePickerProps;
+    disabledTime?: DatePickerDisabledTime;
+    showLunar?: DatePickerLunar;
+}
+```
+
+
+## MonthPicker API
+
+公开声明：`dist/components/date-picker/index.d.ts`。 类型中的 undefined 表示可省略；原始 prop 默认值不等于继承配置或服务默认值。
+
+### Props
+
+| 名称 | 用途 | 公开类型 | 必填 | 声明默认值 |
+| --- | --- | --- | --- | --- |
+| disabled | 见场景用法与类型 | undefined &#124; false &#124; true &#124; boolean[] | 否 | 透传内层组件；默认值见对应组件 |
+| modelValue | 见场景用法与类型 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 透传内层组件；默认值见对应组件 |
+| position | 见场景用法与类型 | undefined &#124; "top" &#124; "bottom" &#124; "tl" &#124; "tr" &#124; "bl" &#124; "br" | 否 | 透传内层组件；默认值见对应组件 |
+| error | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| size | 见场景用法与类型 | undefined &#124; "mini" &#124; "small" &#124; "medium" &#124; "large" | 否 | 透传内层组件；默认值见对应组件 |
+| popupVisible | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| defaultPopupVisible | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| popupContainer | 见场景用法与类型 | undefined &#124; string &#124; HTMLElement | 否 | 透传内层组件；默认值见对应组件 |
+| defaultValue | 见场景用法与类型 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 透传内层组件；默认值见对应组件 |
+| pickerValue | 见场景用法与类型 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 透传内层组件；默认值见对应组件 |
+| defaultPickerValue | 见场景用法与类型 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 透传内层组件；默认值见对应组件 |
+| placeholder | 见场景用法与类型 | undefined &#124; string &#124; string[] | 否 | 透传内层组件；默认值见对应组件 |
+| readonly | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| disabledInput | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| inputReadOnly | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| allowClear | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| format | 见场景用法与类型 | undefined &#124; string | 否 | 透传内层组件；默认值见对应组件 |
+| valueFormat | 见场景用法与类型 | undefined &#124; string | 否 | 透传内层组件；默认值见对应组件 |
+| dayStartOfWeek | 见场景用法与类型 | undefined &#124; 0 &#124; 1 &#124; 2 &#124; 4 &#124; 3 &#124; 5 &#124; 6 | 否 | 透传内层组件；默认值见对应组件 |
+| disabledDate | 见场景用法与类型 | undefined &#124; (current: Date, type?: DatePickerRange, context?: DatePickerDisabledDateContext) => boolean | 否 | 透传内层组件；默认值见对应组件 |
+| hideNotInViewDates | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| triggerProps | 见场景用法与类型 | undefined &#124; { [x: string]: any; } | 否 | 透传内层组件；默认值见对应组件 |
+| unmountOnClose | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| shortcuts | 见场景用法与类型 | undefined &#124; DatePickerShortcut[] | 否 | 透传内层组件；默认值见对应组件 |
+| showToday | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| showConfirmBtn | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| showTime | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| timePickerProps | 见场景用法与类型 | undefined &#124; { [x: string]: any; } | 否 | 透传内层组件；默认值见对应组件 |
+| disabledTime | 见场景用法与类型 | undefined &#124; (current?: Date, type?: DatePickerRange) => Record<string, any> &#124; undefined | 否 | 透传内层组件；默认值见对应组件 |
+| showLunar | 见场景用法与类型 | undefined &#124; false &#124; true &#124; { showLunarDate?: boolean; showLunarFestival?: boolean; showSolarTerm?: boolean; showSolarFestival?: boolean; fallbackText?: string; } | 否 | 透传内层组件；默认值见对应组件 |
+
+### Events
+
+| 事件 | 用途 | 监听器签名（即事件参数） |
+| --- | --- | --- |
+| update:modelValue | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue) => any |
+| ok | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| select | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| update:popupVisible | 见场景用法与类型 | undefined &#124; (_visible: boolean) => any |
+| focus | 见场景用法与类型 | undefined &#124; (_ev: FocusEvent) => any |
+| clear | 见场景用法与类型 | undefined &#124; (_ev: MouseEvent) => any |
+| blur | 见场景用法与类型 | undefined &#124; (_ev: FocusEvent) => any |
+| change | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| popup-visible-change | 见场景用法与类型 | undefined &#124; (_visible: boolean) => any |
+| update:pickerValue | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue) => any |
+| calendar-change | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown, _info: { range: DatePickerRange; }) => any |
+| picker-value-change | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| select-shortcut | 见场景用法与类型 | undefined &#124; (_shortcut: DatePickerShortcut) => any |
+
+### Slots
+
+公开类型未逐项声明插槽；本页场景说明列出实际使用的插槽，不将任意插槽视为已支持。
+
+### 实例方法
+
+没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+
+### 关联类型定义
+
+以下摘自本组件族声明，供查阅嵌套配置；运行时和值类型均以根入口可导出项为准。
+
+```typescript-reference
+type DatePickerValue = string | number | Date;
+
+type DatePickerModelValue = DatePickerValue | (DatePickerValue | undefined)[] | undefined;
+
+type DatePickerMode = 'date' | 'month' | 'year' | 'quarter' | 'week';
+
+type DatePickerType = DatePickerMode | 'date-range' | 'month-range' | 'year-range' | 'quarter-range' | 'week-range';
+
+type DatePickerPosition = 'top' | 'tl' | 'tr' | 'bottom' | 'bl' | 'br';
+
+type DatePickerSize = 'mini' | 'small' | 'medium' | 'large';
+
+type DatePickerValueFormat = 'timestamp' | 'Date' | string;
+
+type DatePickerRange = 'start' | 'end';
+
+interface DatePickerTimePickerProps {
+    format?: string;
+    use12Hours?: boolean;
+    step?: {
+        hour?: number;
+        minute?: number;
+        second?: number;
+    };
+    disabledHours?: () => number[];
+    disabledMinutes?: (selectedHour?: number) => number[];
+    disabledSeconds?: (selectedHour?: number, selectedMinute?: number) => number[];
+    hideDisabledOptions?: boolean;
+    defaultValue?: DatePickerValue | (DatePickerValue | undefined)[];
+}
+
+interface DatePickerDisabledTimeProps {
+    disabledHours?: () => number[];
+    disabledMinutes?: (selectedHour?: number) => number[];
+    disabledSeconds?: (selectedHour?: number, selectedMinute?: number) => number[];
+}
+
+type DatePickerDisabledTime = (current?: Date, type?: DatePickerRange) => DatePickerDisabledTimeProps | undefined;
+
+interface DatePickerDisabledDateContext {
+    value: DatePickerModelValue;
+    selecting?: DatePickerRange;
+}
+
+type DatePickerDisabledDate = (current: Date, type?: DatePickerRange, context?: DatePickerDisabledDateContext) => boolean;
+
+type DatePickerCellSlot = (current: Date) => unknown;
+
+interface DatePickerShortcut {
+    label: string | number;
+    value: DatePickerValue | (DatePickerValue | undefined)[] | (() => DatePickerValue | (DatePickerValue | undefined)[]);
+    format?: string;
+}
+
+interface DatePickerCell {
+    value: Dayjs;
+    label: string;
+    title: string;
+    inView: boolean;
+    outView: boolean;
+    isWeekLabel?: boolean;
+    weekStart?: boolean;
+    weekEnd?: boolean;
+    weekSelected?: boolean;
+    weekLabel?: string;
+    selected: boolean;
+    rangeStart: boolean;
+    rangeEnd: boolean;
+    inRange: boolean;
+    previewRangeStart: boolean;
+    previewRangeEnd: boolean;
+    inPreviewRange: boolean;
+    today: boolean;
+    disabled: boolean;
+    lunar?: LunarInfo;
+}
+
+interface DatePickerProps {
+    type?: DatePickerType;
+    modelValue?: DatePickerModelValue;
+    defaultValue?: DatePickerModelValue;
+    pickerValue?: DatePickerModelValue;
+    defaultPickerValue?: DatePickerModelValue;
+    placeholder?: string | string[];
+    disabled?: boolean | boolean[];
+    readonly?: boolean;
+    disabledInput?: boolean;
+    inputReadOnly?: boolean;
+    error?: boolean;
+    allowClear?: boolean;
+    format?: string;
+    valueFormat?: DatePickerValueFormat;
+    size?: DatePickerSize;
+    dayStartOfWeek?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    disabledDate?: DatePickerDisabledDate;
+    hideNotInViewDates?: boolean;
+    popupVisible?: boolean;
+    defaultPopupVisible?: boolean;
+    position?: DatePickerPosition;
+    popupContainer?: string | HTMLElement;
+    triggerProps?: Partial<TriggerProps>;
+    unmountOnClose?: boolean;
+    shortcuts?: DatePickerShortcut[];
+    showToday?: boolean;
+    showConfirmBtn?: boolean;
+    showTime?: boolean;
+    timePickerProps?: DatePickerTimePickerProps;
+    disabledTime?: DatePickerDisabledTime;
+    showLunar?: DatePickerLunar;
+}
+```
+
+
+## QuarterPicker API
+
+公开声明：`dist/components/date-picker/index.d.ts`。 类型中的 undefined 表示可省略；原始 prop 默认值不等于继承配置或服务默认值。
+
+### Props
+
+| 名称 | 用途 | 公开类型 | 必填 | 声明默认值 |
+| --- | --- | --- | --- | --- |
+| disabled | 见场景用法与类型 | undefined &#124; false &#124; true &#124; boolean[] | 否 | 透传内层组件；默认值见对应组件 |
+| modelValue | 见场景用法与类型 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 透传内层组件；默认值见对应组件 |
+| position | 见场景用法与类型 | undefined &#124; "top" &#124; "bottom" &#124; "tl" &#124; "tr" &#124; "bl" &#124; "br" | 否 | 透传内层组件；默认值见对应组件 |
+| error | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| size | 见场景用法与类型 | undefined &#124; "mini" &#124; "small" &#124; "medium" &#124; "large" | 否 | 透传内层组件；默认值见对应组件 |
+| popupVisible | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| defaultPopupVisible | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| popupContainer | 见场景用法与类型 | undefined &#124; string &#124; HTMLElement | 否 | 透传内层组件；默认值见对应组件 |
+| defaultValue | 见场景用法与类型 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 透传内层组件；默认值见对应组件 |
+| pickerValue | 见场景用法与类型 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 透传内层组件；默认值见对应组件 |
+| defaultPickerValue | 见场景用法与类型 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 透传内层组件；默认值见对应组件 |
+| placeholder | 见场景用法与类型 | undefined &#124; string &#124; string[] | 否 | 透传内层组件；默认值见对应组件 |
+| readonly | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| disabledInput | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| inputReadOnly | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| allowClear | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| format | 见场景用法与类型 | undefined &#124; string | 否 | 透传内层组件；默认值见对应组件 |
+| valueFormat | 见场景用法与类型 | undefined &#124; string | 否 | 透传内层组件；默认值见对应组件 |
+| dayStartOfWeek | 见场景用法与类型 | undefined &#124; 0 &#124; 1 &#124; 2 &#124; 4 &#124; 3 &#124; 5 &#124; 6 | 否 | 透传内层组件；默认值见对应组件 |
+| disabledDate | 见场景用法与类型 | undefined &#124; (current: Date, type?: DatePickerRange, context?: DatePickerDisabledDateContext) => boolean | 否 | 透传内层组件；默认值见对应组件 |
+| hideNotInViewDates | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| triggerProps | 见场景用法与类型 | undefined &#124; { [x: string]: any; } | 否 | 透传内层组件；默认值见对应组件 |
+| unmountOnClose | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| shortcuts | 见场景用法与类型 | undefined &#124; DatePickerShortcut[] | 否 | 透传内层组件；默认值见对应组件 |
+| showToday | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| showConfirmBtn | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| showTime | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| timePickerProps | 见场景用法与类型 | undefined &#124; { [x: string]: any; } | 否 | 透传内层组件；默认值见对应组件 |
+| disabledTime | 见场景用法与类型 | undefined &#124; (current?: Date, type?: DatePickerRange) => Record<string, any> &#124; undefined | 否 | 透传内层组件；默认值见对应组件 |
+| showLunar | 见场景用法与类型 | undefined &#124; false &#124; true &#124; { showLunarDate?: boolean; showLunarFestival?: boolean; showSolarTerm?: boolean; showSolarFestival?: boolean; fallbackText?: string; } | 否 | 透传内层组件；默认值见对应组件 |
+
+### Events
+
+| 事件 | 用途 | 监听器签名（即事件参数） |
+| --- | --- | --- |
+| update:modelValue | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue) => any |
+| ok | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| select | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| update:popupVisible | 见场景用法与类型 | undefined &#124; (_visible: boolean) => any |
+| focus | 见场景用法与类型 | undefined &#124; (_ev: FocusEvent) => any |
+| clear | 见场景用法与类型 | undefined &#124; (_ev: MouseEvent) => any |
+| blur | 见场景用法与类型 | undefined &#124; (_ev: FocusEvent) => any |
+| change | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| popup-visible-change | 见场景用法与类型 | undefined &#124; (_visible: boolean) => any |
+| update:pickerValue | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue) => any |
+| calendar-change | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown, _info: { range: DatePickerRange; }) => any |
+| picker-value-change | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| select-shortcut | 见场景用法与类型 | undefined &#124; (_shortcut: DatePickerShortcut) => any |
+
+### Slots
+
+公开类型未逐项声明插槽；本页场景说明列出实际使用的插槽，不将任意插槽视为已支持。
+
+### 实例方法
+
+没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+
+### 关联类型定义
+
+以下摘自本组件族声明，供查阅嵌套配置；运行时和值类型均以根入口可导出项为准。
+
+```typescript-reference
+type DatePickerValue = string | number | Date;
+
+type DatePickerModelValue = DatePickerValue | (DatePickerValue | undefined)[] | undefined;
+
+type DatePickerMode = 'date' | 'month' | 'year' | 'quarter' | 'week';
+
+type DatePickerType = DatePickerMode | 'date-range' | 'month-range' | 'year-range' | 'quarter-range' | 'week-range';
+
+type DatePickerPosition = 'top' | 'tl' | 'tr' | 'bottom' | 'bl' | 'br';
+
+type DatePickerSize = 'mini' | 'small' | 'medium' | 'large';
+
+type DatePickerValueFormat = 'timestamp' | 'Date' | string;
+
+type DatePickerRange = 'start' | 'end';
+
+interface DatePickerTimePickerProps {
+    format?: string;
+    use12Hours?: boolean;
+    step?: {
+        hour?: number;
+        minute?: number;
+        second?: number;
+    };
+    disabledHours?: () => number[];
+    disabledMinutes?: (selectedHour?: number) => number[];
+    disabledSeconds?: (selectedHour?: number, selectedMinute?: number) => number[];
+    hideDisabledOptions?: boolean;
+    defaultValue?: DatePickerValue | (DatePickerValue | undefined)[];
+}
+
+interface DatePickerDisabledTimeProps {
+    disabledHours?: () => number[];
+    disabledMinutes?: (selectedHour?: number) => number[];
+    disabledSeconds?: (selectedHour?: number, selectedMinute?: number) => number[];
+}
+
+type DatePickerDisabledTime = (current?: Date, type?: DatePickerRange) => DatePickerDisabledTimeProps | undefined;
+
+interface DatePickerDisabledDateContext {
+    value: DatePickerModelValue;
+    selecting?: DatePickerRange;
+}
+
+type DatePickerDisabledDate = (current: Date, type?: DatePickerRange, context?: DatePickerDisabledDateContext) => boolean;
+
+type DatePickerCellSlot = (current: Date) => unknown;
+
+interface DatePickerShortcut {
+    label: string | number;
+    value: DatePickerValue | (DatePickerValue | undefined)[] | (() => DatePickerValue | (DatePickerValue | undefined)[]);
+    format?: string;
+}
+
+interface DatePickerCell {
+    value: Dayjs;
+    label: string;
+    title: string;
+    inView: boolean;
+    outView: boolean;
+    isWeekLabel?: boolean;
+    weekStart?: boolean;
+    weekEnd?: boolean;
+    weekSelected?: boolean;
+    weekLabel?: string;
+    selected: boolean;
+    rangeStart: boolean;
+    rangeEnd: boolean;
+    inRange: boolean;
+    previewRangeStart: boolean;
+    previewRangeEnd: boolean;
+    inPreviewRange: boolean;
+    today: boolean;
+    disabled: boolean;
+    lunar?: LunarInfo;
+}
+
+interface DatePickerProps {
+    type?: DatePickerType;
+    modelValue?: DatePickerModelValue;
+    defaultValue?: DatePickerModelValue;
+    pickerValue?: DatePickerModelValue;
+    defaultPickerValue?: DatePickerModelValue;
+    placeholder?: string | string[];
+    disabled?: boolean | boolean[];
+    readonly?: boolean;
+    disabledInput?: boolean;
+    inputReadOnly?: boolean;
+    error?: boolean;
+    allowClear?: boolean;
+    format?: string;
+    valueFormat?: DatePickerValueFormat;
+    size?: DatePickerSize;
+    dayStartOfWeek?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    disabledDate?: DatePickerDisabledDate;
+    hideNotInViewDates?: boolean;
+    popupVisible?: boolean;
+    defaultPopupVisible?: boolean;
+    position?: DatePickerPosition;
+    popupContainer?: string | HTMLElement;
+    triggerProps?: Partial<TriggerProps>;
+    unmountOnClose?: boolean;
+    shortcuts?: DatePickerShortcut[];
+    showToday?: boolean;
+    showConfirmBtn?: boolean;
+    showTime?: boolean;
+    timePickerProps?: DatePickerTimePickerProps;
+    disabledTime?: DatePickerDisabledTime;
+    showLunar?: DatePickerLunar;
+}
+```
+
+
+## RangePicker API
+
+公开声明：`dist/components/date-picker/index.d.ts`。 类型中的 undefined 表示可省略；原始 prop 默认值不等于继承配置或服务默认值。
+
+### Props
+
+| 名称 | 用途 | 公开类型 | 必填 | 声明默认值 |
+| --- | --- | --- | --- | --- |
+| mode | 见场景用法与类型 | undefined &#124; string | 否 | "date" |
+| disabled | 见场景用法与类型 | undefined &#124; false &#124; true &#124; boolean[] | 否 | 透传内层组件；默认值见对应组件 |
+| modelValue | 见场景用法与类型 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 透传内层组件；默认值见对应组件 |
+| position | 见场景用法与类型 | undefined &#124; "top" &#124; "bottom" &#124; "tl" &#124; "tr" &#124; "bl" &#124; "br" | 否 | 透传内层组件；默认值见对应组件 |
+| error | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| size | 见场景用法与类型 | undefined &#124; "mini" &#124; "small" &#124; "medium" &#124; "large" | 否 | 透传内层组件；默认值见对应组件 |
+| popupVisible | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| defaultPopupVisible | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| popupContainer | 见场景用法与类型 | undefined &#124; string &#124; HTMLElement | 否 | 透传内层组件；默认值见对应组件 |
+| defaultValue | 见场景用法与类型 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 透传内层组件；默认值见对应组件 |
+| pickerValue | 见场景用法与类型 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 透传内层组件；默认值见对应组件 |
+| defaultPickerValue | 见场景用法与类型 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 透传内层组件；默认值见对应组件 |
+| placeholder | 见场景用法与类型 | undefined &#124; string &#124; string[] | 否 | 透传内层组件；默认值见对应组件 |
+| readonly | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| disabledInput | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| inputReadOnly | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| allowClear | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| format | 见场景用法与类型 | undefined &#124; string | 否 | 透传内层组件；默认值见对应组件 |
+| valueFormat | 见场景用法与类型 | undefined &#124; string | 否 | 透传内层组件；默认值见对应组件 |
+| dayStartOfWeek | 见场景用法与类型 | undefined &#124; 0 &#124; 1 &#124; 2 &#124; 4 &#124; 3 &#124; 5 &#124; 6 | 否 | 透传内层组件；默认值见对应组件 |
+| disabledDate | 见场景用法与类型 | undefined &#124; (current: Date, type?: DatePickerRange, context?: DatePickerDisabledDateContext) => boolean | 否 | 透传内层组件；默认值见对应组件 |
+| hideNotInViewDates | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| triggerProps | 见场景用法与类型 | undefined &#124; { [x: string]: any; } | 否 | 透传内层组件；默认值见对应组件 |
+| unmountOnClose | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| shortcuts | 见场景用法与类型 | undefined &#124; DatePickerShortcut[] | 否 | 透传内层组件；默认值见对应组件 |
+| showToday | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| showConfirmBtn | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| showTime | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| timePickerProps | 见场景用法与类型 | undefined &#124; { [x: string]: any; } | 否 | 透传内层组件；默认值见对应组件 |
+| disabledTime | 见场景用法与类型 | undefined &#124; (current?: Date, type?: DatePickerRange) => Record<string, any> &#124; undefined | 否 | 透传内层组件；默认值见对应组件 |
+| showLunar | 见场景用法与类型 | undefined &#124; false &#124; true &#124; { showLunarDate?: boolean; showLunarFestival?: boolean; showSolarTerm?: boolean; showSolarFestival?: boolean; fallbackText?: string; } | 否 | 透传内层组件；默认值见对应组件 |
+
+### Events
+
+| 事件 | 用途 | 监听器签名（即事件参数） |
+| --- | --- | --- |
+| update:modelValue | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue) => any |
+| ok | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| select | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| update:popupVisible | 见场景用法与类型 | undefined &#124; (_visible: boolean) => any |
+| focus | 见场景用法与类型 | undefined &#124; (_ev: FocusEvent) => any |
+| clear | 见场景用法与类型 | undefined &#124; (_ev: MouseEvent) => any |
+| blur | 见场景用法与类型 | undefined &#124; (_ev: FocusEvent) => any |
+| change | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| popup-visible-change | 见场景用法与类型 | undefined &#124; (_visible: boolean) => any |
+| update:pickerValue | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue) => any |
+| calendar-change | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown, _info: { range: DatePickerRange; }) => any |
+| picker-value-change | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| select-shortcut | 见场景用法与类型 | undefined &#124; (_shortcut: DatePickerShortcut) => any |
+
+### Slots
+
+公开类型未逐项声明插槽；本页场景说明列出实际使用的插槽，不将任意插槽视为已支持。
+
+### 实例方法
+
+没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+
+### 关联类型定义
+
+以下摘自本组件族声明，供查阅嵌套配置；运行时和值类型均以根入口可导出项为准。
+
+```typescript-reference
+type DatePickerValue = string | number | Date;
+
+type DatePickerModelValue = DatePickerValue | (DatePickerValue | undefined)[] | undefined;
+
+type DatePickerMode = 'date' | 'month' | 'year' | 'quarter' | 'week';
+
+type DatePickerType = DatePickerMode | 'date-range' | 'month-range' | 'year-range' | 'quarter-range' | 'week-range';
+
+type DatePickerPosition = 'top' | 'tl' | 'tr' | 'bottom' | 'bl' | 'br';
+
+type DatePickerSize = 'mini' | 'small' | 'medium' | 'large';
+
+type DatePickerValueFormat = 'timestamp' | 'Date' | string;
+
+type DatePickerRange = 'start' | 'end';
+
+interface DatePickerTimePickerProps {
+    format?: string;
+    use12Hours?: boolean;
+    step?: {
+        hour?: number;
+        minute?: number;
+        second?: number;
+    };
+    disabledHours?: () => number[];
+    disabledMinutes?: (selectedHour?: number) => number[];
+    disabledSeconds?: (selectedHour?: number, selectedMinute?: number) => number[];
+    hideDisabledOptions?: boolean;
+    defaultValue?: DatePickerValue | (DatePickerValue | undefined)[];
+}
+
+interface DatePickerDisabledTimeProps {
+    disabledHours?: () => number[];
+    disabledMinutes?: (selectedHour?: number) => number[];
+    disabledSeconds?: (selectedHour?: number, selectedMinute?: number) => number[];
+}
+
+type DatePickerDisabledTime = (current?: Date, type?: DatePickerRange) => DatePickerDisabledTimeProps | undefined;
+
+interface DatePickerDisabledDateContext {
+    value: DatePickerModelValue;
+    selecting?: DatePickerRange;
+}
+
+type DatePickerDisabledDate = (current: Date, type?: DatePickerRange, context?: DatePickerDisabledDateContext) => boolean;
+
+type DatePickerCellSlot = (current: Date) => unknown;
+
+interface DatePickerShortcut {
+    label: string | number;
+    value: DatePickerValue | (DatePickerValue | undefined)[] | (() => DatePickerValue | (DatePickerValue | undefined)[]);
+    format?: string;
+}
+
+interface DatePickerCell {
+    value: Dayjs;
+    label: string;
+    title: string;
+    inView: boolean;
+    outView: boolean;
+    isWeekLabel?: boolean;
+    weekStart?: boolean;
+    weekEnd?: boolean;
+    weekSelected?: boolean;
+    weekLabel?: string;
+    selected: boolean;
+    rangeStart: boolean;
+    rangeEnd: boolean;
+    inRange: boolean;
+    previewRangeStart: boolean;
+    previewRangeEnd: boolean;
+    inPreviewRange: boolean;
+    today: boolean;
+    disabled: boolean;
+    lunar?: LunarInfo;
+}
+
+interface DatePickerProps {
+    type?: DatePickerType;
+    modelValue?: DatePickerModelValue;
+    defaultValue?: DatePickerModelValue;
+    pickerValue?: DatePickerModelValue;
+    defaultPickerValue?: DatePickerModelValue;
+    placeholder?: string | string[];
+    disabled?: boolean | boolean[];
+    readonly?: boolean;
+    disabledInput?: boolean;
+    inputReadOnly?: boolean;
+    error?: boolean;
+    allowClear?: boolean;
+    format?: string;
+    valueFormat?: DatePickerValueFormat;
+    size?: DatePickerSize;
+    dayStartOfWeek?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    disabledDate?: DatePickerDisabledDate;
+    hideNotInViewDates?: boolean;
+    popupVisible?: boolean;
+    defaultPopupVisible?: boolean;
+    position?: DatePickerPosition;
+    popupContainer?: string | HTMLElement;
+    triggerProps?: Partial<TriggerProps>;
+    unmountOnClose?: boolean;
+    shortcuts?: DatePickerShortcut[];
+    showToday?: boolean;
+    showConfirmBtn?: boolean;
+    showTime?: boolean;
+    timePickerProps?: DatePickerTimePickerProps;
+    disabledTime?: DatePickerDisabledTime;
+    showLunar?: DatePickerLunar;
+}
+```
+
+
+## WeekPicker API
+
+公开声明：`dist/components/date-picker/index.d.ts`。 类型中的 undefined 表示可省略；原始 prop 默认值不等于继承配置或服务默认值。
+
+### Props
+
+| 名称 | 用途 | 公开类型 | 必填 | 声明默认值 |
+| --- | --- | --- | --- | --- |
+| disabled | 见场景用法与类型 | undefined &#124; false &#124; true &#124; boolean[] | 否 | 透传内层组件；默认值见对应组件 |
+| modelValue | 见场景用法与类型 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 透传内层组件；默认值见对应组件 |
+| position | 见场景用法与类型 | undefined &#124; "top" &#124; "bottom" &#124; "tl" &#124; "tr" &#124; "bl" &#124; "br" | 否 | 透传内层组件；默认值见对应组件 |
+| error | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| size | 见场景用法与类型 | undefined &#124; "mini" &#124; "small" &#124; "medium" &#124; "large" | 否 | 透传内层组件；默认值见对应组件 |
+| popupVisible | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| defaultPopupVisible | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| popupContainer | 见场景用法与类型 | undefined &#124; string &#124; HTMLElement | 否 | 透传内层组件；默认值见对应组件 |
+| defaultValue | 见场景用法与类型 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 透传内层组件；默认值见对应组件 |
+| pickerValue | 见场景用法与类型 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 透传内层组件；默认值见对应组件 |
+| defaultPickerValue | 见场景用法与类型 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 透传内层组件；默认值见对应组件 |
+| placeholder | 见场景用法与类型 | undefined &#124; string &#124; string[] | 否 | 透传内层组件；默认值见对应组件 |
+| readonly | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| disabledInput | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| inputReadOnly | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| allowClear | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| format | 见场景用法与类型 | undefined &#124; string | 否 | 透传内层组件；默认值见对应组件 |
+| valueFormat | 见场景用法与类型 | undefined &#124; string | 否 | 透传内层组件；默认值见对应组件 |
+| dayStartOfWeek | 见场景用法与类型 | undefined &#124; 0 &#124; 1 &#124; 2 &#124; 4 &#124; 3 &#124; 5 &#124; 6 | 否 | 透传内层组件；默认值见对应组件 |
+| disabledDate | 见场景用法与类型 | undefined &#124; (current: Date, type?: DatePickerRange, context?: DatePickerDisabledDateContext) => boolean | 否 | 透传内层组件；默认值见对应组件 |
+| hideNotInViewDates | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| triggerProps | 见场景用法与类型 | undefined &#124; { [x: string]: any; } | 否 | 透传内层组件；默认值见对应组件 |
+| unmountOnClose | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| shortcuts | 见场景用法与类型 | undefined &#124; DatePickerShortcut[] | 否 | 透传内层组件；默认值见对应组件 |
+| showToday | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| showConfirmBtn | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| showTime | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| timePickerProps | 见场景用法与类型 | undefined &#124; { [x: string]: any; } | 否 | 透传内层组件；默认值见对应组件 |
+| disabledTime | 见场景用法与类型 | undefined &#124; (current?: Date, type?: DatePickerRange) => Record<string, any> &#124; undefined | 否 | 透传内层组件；默认值见对应组件 |
+| showLunar | 见场景用法与类型 | undefined &#124; false &#124; true &#124; { showLunarDate?: boolean; showLunarFestival?: boolean; showSolarTerm?: boolean; showSolarFestival?: boolean; fallbackText?: string; } | 否 | 透传内层组件；默认值见对应组件 |
+
+### Events
+
+| 事件 | 用途 | 监听器签名（即事件参数） |
+| --- | --- | --- |
+| update:modelValue | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue) => any |
+| ok | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| select | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| update:popupVisible | 见场景用法与类型 | undefined &#124; (_visible: boolean) => any |
+| focus | 见场景用法与类型 | undefined &#124; (_ev: FocusEvent) => any |
+| clear | 见场景用法与类型 | undefined &#124; (_ev: MouseEvent) => any |
+| blur | 见场景用法与类型 | undefined &#124; (_ev: FocusEvent) => any |
+| change | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| popup-visible-change | 见场景用法与类型 | undefined &#124; (_visible: boolean) => any |
+| update:pickerValue | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue) => any |
+| calendar-change | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown, _info: { range: DatePickerRange; }) => any |
+| picker-value-change | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| select-shortcut | 见场景用法与类型 | undefined &#124; (_shortcut: DatePickerShortcut) => any |
+
+### Slots
+
+公开类型未逐项声明插槽；本页场景说明列出实际使用的插槽，不将任意插槽视为已支持。
+
+### 实例方法
+
+没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+
+### 关联类型定义
+
+以下摘自本组件族声明，供查阅嵌套配置；运行时和值类型均以根入口可导出项为准。
+
+```typescript-reference
+type DatePickerValue = string | number | Date;
+
+type DatePickerModelValue = DatePickerValue | (DatePickerValue | undefined)[] | undefined;
+
+type DatePickerMode = 'date' | 'month' | 'year' | 'quarter' | 'week';
+
+type DatePickerType = DatePickerMode | 'date-range' | 'month-range' | 'year-range' | 'quarter-range' | 'week-range';
+
+type DatePickerPosition = 'top' | 'tl' | 'tr' | 'bottom' | 'bl' | 'br';
+
+type DatePickerSize = 'mini' | 'small' | 'medium' | 'large';
+
+type DatePickerValueFormat = 'timestamp' | 'Date' | string;
+
+type DatePickerRange = 'start' | 'end';
+
+interface DatePickerTimePickerProps {
+    format?: string;
+    use12Hours?: boolean;
+    step?: {
+        hour?: number;
+        minute?: number;
+        second?: number;
+    };
+    disabledHours?: () => number[];
+    disabledMinutes?: (selectedHour?: number) => number[];
+    disabledSeconds?: (selectedHour?: number, selectedMinute?: number) => number[];
+    hideDisabledOptions?: boolean;
+    defaultValue?: DatePickerValue | (DatePickerValue | undefined)[];
+}
+
+interface DatePickerDisabledTimeProps {
+    disabledHours?: () => number[];
+    disabledMinutes?: (selectedHour?: number) => number[];
+    disabledSeconds?: (selectedHour?: number, selectedMinute?: number) => number[];
+}
+
+type DatePickerDisabledTime = (current?: Date, type?: DatePickerRange) => DatePickerDisabledTimeProps | undefined;
+
+interface DatePickerDisabledDateContext {
+    value: DatePickerModelValue;
+    selecting?: DatePickerRange;
+}
+
+type DatePickerDisabledDate = (current: Date, type?: DatePickerRange, context?: DatePickerDisabledDateContext) => boolean;
+
+type DatePickerCellSlot = (current: Date) => unknown;
+
+interface DatePickerShortcut {
+    label: string | number;
+    value: DatePickerValue | (DatePickerValue | undefined)[] | (() => DatePickerValue | (DatePickerValue | undefined)[]);
+    format?: string;
+}
+
+interface DatePickerCell {
+    value: Dayjs;
+    label: string;
+    title: string;
+    inView: boolean;
+    outView: boolean;
+    isWeekLabel?: boolean;
+    weekStart?: boolean;
+    weekEnd?: boolean;
+    weekSelected?: boolean;
+    weekLabel?: string;
+    selected: boolean;
+    rangeStart: boolean;
+    rangeEnd: boolean;
+    inRange: boolean;
+    previewRangeStart: boolean;
+    previewRangeEnd: boolean;
+    inPreviewRange: boolean;
+    today: boolean;
+    disabled: boolean;
+    lunar?: LunarInfo;
+}
+
+interface DatePickerProps {
+    type?: DatePickerType;
+    modelValue?: DatePickerModelValue;
+    defaultValue?: DatePickerModelValue;
+    pickerValue?: DatePickerModelValue;
+    defaultPickerValue?: DatePickerModelValue;
+    placeholder?: string | string[];
+    disabled?: boolean | boolean[];
+    readonly?: boolean;
+    disabledInput?: boolean;
+    inputReadOnly?: boolean;
+    error?: boolean;
+    allowClear?: boolean;
+    format?: string;
+    valueFormat?: DatePickerValueFormat;
+    size?: DatePickerSize;
+    dayStartOfWeek?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    disabledDate?: DatePickerDisabledDate;
+    hideNotInViewDates?: boolean;
+    popupVisible?: boolean;
+    defaultPopupVisible?: boolean;
+    position?: DatePickerPosition;
+    popupContainer?: string | HTMLElement;
+    triggerProps?: Partial<TriggerProps>;
+    unmountOnClose?: boolean;
+    shortcuts?: DatePickerShortcut[];
+    showToday?: boolean;
+    showConfirmBtn?: boolean;
+    showTime?: boolean;
+    timePickerProps?: DatePickerTimePickerProps;
+    disabledTime?: DatePickerDisabledTime;
+    showLunar?: DatePickerLunar;
+}
+```
+
+
+## YearPicker API
+
+公开声明：`dist/components/date-picker/index.d.ts`。 类型中的 undefined 表示可省略；原始 prop 默认值不等于继承配置或服务默认值。
+
+### Props
+
+| 名称 | 用途 | 公开类型 | 必填 | 声明默认值 |
+| --- | --- | --- | --- | --- |
+| disabled | 见场景用法与类型 | undefined &#124; false &#124; true &#124; boolean[] | 否 | 透传内层组件；默认值见对应组件 |
+| modelValue | 见场景用法与类型 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 透传内层组件；默认值见对应组件 |
+| position | 见场景用法与类型 | undefined &#124; "top" &#124; "bottom" &#124; "tl" &#124; "tr" &#124; "bl" &#124; "br" | 否 | 透传内层组件；默认值见对应组件 |
+| error | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| size | 见场景用法与类型 | undefined &#124; "mini" &#124; "small" &#124; "medium" &#124; "large" | 否 | 透传内层组件；默认值见对应组件 |
+| popupVisible | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| defaultPopupVisible | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| popupContainer | 见场景用法与类型 | undefined &#124; string &#124; HTMLElement | 否 | 透传内层组件；默认值见对应组件 |
+| defaultValue | 见场景用法与类型 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 透传内层组件；默认值见对应组件 |
+| pickerValue | 见场景用法与类型 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 透传内层组件；默认值见对应组件 |
+| defaultPickerValue | 见场景用法与类型 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 透传内层组件；默认值见对应组件 |
+| placeholder | 见场景用法与类型 | undefined &#124; string &#124; string[] | 否 | 透传内层组件；默认值见对应组件 |
+| readonly | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| disabledInput | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| inputReadOnly | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| allowClear | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| format | 见场景用法与类型 | undefined &#124; string | 否 | 透传内层组件；默认值见对应组件 |
+| valueFormat | 见场景用法与类型 | undefined &#124; string | 否 | 透传内层组件；默认值见对应组件 |
+| dayStartOfWeek | 见场景用法与类型 | undefined &#124; 0 &#124; 1 &#124; 2 &#124; 4 &#124; 3 &#124; 5 &#124; 6 | 否 | 透传内层组件；默认值见对应组件 |
+| disabledDate | 见场景用法与类型 | undefined &#124; (current: Date, type?: DatePickerRange, context?: DatePickerDisabledDateContext) => boolean | 否 | 透传内层组件；默认值见对应组件 |
+| hideNotInViewDates | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| triggerProps | 见场景用法与类型 | undefined &#124; { [x: string]: any; } | 否 | 透传内层组件；默认值见对应组件 |
+| unmountOnClose | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| shortcuts | 见场景用法与类型 | undefined &#124; DatePickerShortcut[] | 否 | 透传内层组件；默认值见对应组件 |
+| showToday | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| showConfirmBtn | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| showTime | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
+| timePickerProps | 见场景用法与类型 | undefined &#124; { [x: string]: any; } | 否 | 透传内层组件；默认值见对应组件 |
+| disabledTime | 见场景用法与类型 | undefined &#124; (current?: Date, type?: DatePickerRange) => Record<string, any> &#124; undefined | 否 | 透传内层组件；默认值见对应组件 |
+| showLunar | 见场景用法与类型 | undefined &#124; false &#124; true &#124; { showLunarDate?: boolean; showLunarFestival?: boolean; showSolarTerm?: boolean; showSolarFestival?: boolean; fallbackText?: string; } | 否 | 透传内层组件；默认值见对应组件 |
+
+### Events
+
+| 事件 | 用途 | 监听器签名（即事件参数） |
+| --- | --- | --- |
+| update:modelValue | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue) => any |
+| ok | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| select | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| update:popupVisible | 见场景用法与类型 | undefined &#124; (_visible: boolean) => any |
+| focus | 见场景用法与类型 | undefined &#124; (_ev: FocusEvent) => any |
+| clear | 见场景用法与类型 | undefined &#124; (_ev: MouseEvent) => any |
+| blur | 见场景用法与类型 | undefined &#124; (_ev: FocusEvent) => any |
+| change | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| popup-visible-change | 见场景用法与类型 | undefined &#124; (_visible: boolean) => any |
+| update:pickerValue | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue) => any |
+| calendar-change | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown, _info: { range: DatePickerRange; }) => any |
+| picker-value-change | 见场景用法与类型 | undefined &#124; (_value: DatePickerModelValue, _date: unknown, _dateString: unknown) => any |
+| select-shortcut | 见场景用法与类型 | undefined &#124; (_shortcut: DatePickerShortcut) => any |
+
+### Slots
+
+公开类型未逐项声明插槽；本页场景说明列出实际使用的插槽，不将任意插槽视为已支持。
+
+### 实例方法
+
+没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+
+### 关联类型定义
+
+以下摘自本组件族声明，供查阅嵌套配置；运行时和值类型均以根入口可导出项为准。
+
+```typescript-reference
+type DatePickerValue = string | number | Date;
+
+type DatePickerModelValue = DatePickerValue | (DatePickerValue | undefined)[] | undefined;
+
+type DatePickerMode = 'date' | 'month' | 'year' | 'quarter' | 'week';
+
+type DatePickerType = DatePickerMode | 'date-range' | 'month-range' | 'year-range' | 'quarter-range' | 'week-range';
+
+type DatePickerPosition = 'top' | 'tl' | 'tr' | 'bottom' | 'bl' | 'br';
+
+type DatePickerSize = 'mini' | 'small' | 'medium' | 'large';
+
+type DatePickerValueFormat = 'timestamp' | 'Date' | string;
+
+type DatePickerRange = 'start' | 'end';
+
+interface DatePickerTimePickerProps {
+    format?: string;
+    use12Hours?: boolean;
+    step?: {
+        hour?: number;
+        minute?: number;
+        second?: number;
+    };
+    disabledHours?: () => number[];
+    disabledMinutes?: (selectedHour?: number) => number[];
+    disabledSeconds?: (selectedHour?: number, selectedMinute?: number) => number[];
+    hideDisabledOptions?: boolean;
+    defaultValue?: DatePickerValue | (DatePickerValue | undefined)[];
+}
+
+interface DatePickerDisabledTimeProps {
+    disabledHours?: () => number[];
+    disabledMinutes?: (selectedHour?: number) => number[];
+    disabledSeconds?: (selectedHour?: number, selectedMinute?: number) => number[];
+}
+
+type DatePickerDisabledTime = (current?: Date, type?: DatePickerRange) => DatePickerDisabledTimeProps | undefined;
+
+interface DatePickerDisabledDateContext {
+    value: DatePickerModelValue;
+    selecting?: DatePickerRange;
+}
+
+type DatePickerDisabledDate = (current: Date, type?: DatePickerRange, context?: DatePickerDisabledDateContext) => boolean;
+
+type DatePickerCellSlot = (current: Date) => unknown;
+
+interface DatePickerShortcut {
+    label: string | number;
+    value: DatePickerValue | (DatePickerValue | undefined)[] | (() => DatePickerValue | (DatePickerValue | undefined)[]);
+    format?: string;
+}
+
+interface DatePickerCell {
+    value: Dayjs;
+    label: string;
+    title: string;
+    inView: boolean;
+    outView: boolean;
+    isWeekLabel?: boolean;
+    weekStart?: boolean;
+    weekEnd?: boolean;
+    weekSelected?: boolean;
+    weekLabel?: string;
+    selected: boolean;
+    rangeStart: boolean;
+    rangeEnd: boolean;
+    inRange: boolean;
+    previewRangeStart: boolean;
+    previewRangeEnd: boolean;
+    inPreviewRange: boolean;
+    today: boolean;
+    disabled: boolean;
+    lunar?: LunarInfo;
+}
+
+interface DatePickerProps {
+    type?: DatePickerType;
+    modelValue?: DatePickerModelValue;
+    defaultValue?: DatePickerModelValue;
+    pickerValue?: DatePickerModelValue;
+    defaultPickerValue?: DatePickerModelValue;
+    placeholder?: string | string[];
+    disabled?: boolean | boolean[];
+    readonly?: boolean;
+    disabledInput?: boolean;
+    inputReadOnly?: boolean;
+    error?: boolean;
+    allowClear?: boolean;
+    format?: string;
+    valueFormat?: DatePickerValueFormat;
+    size?: DatePickerSize;
+    dayStartOfWeek?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    disabledDate?: DatePickerDisabledDate;
+    hideNotInViewDates?: boolean;
+    popupVisible?: boolean;
+    defaultPopupVisible?: boolean;
+    position?: DatePickerPosition;
+    popupContainer?: string | HTMLElement;
+    triggerProps?: Partial<TriggerProps>;
+    unmountOnClose?: boolean;
+    shortcuts?: DatePickerShortcut[];
+    showToday?: boolean;
+    showConfirmBtn?: boolean;
+    showTime?: boolean;
+    timePickerProps?: DatePickerTimePickerProps;
+    disabledTime?: DatePickerDisabledTime;
+    showLunar?: DatePickerLunar;
+}
+```
+
+
+返回 [DatePicker 用法](./date-picker.md)。