naive-ui 2.23.2 → 2.24.3

package/es/date-picker/src/DatePicker.js

@@ -1,18 +1,17 @@
-import { h, defineComponent, ref, Transition, computed, provide, watch, withDirectives, toRef, watchEffect, nextTick } from 'vue';
+import { h, defineComponent, ref, Transition, computed, provide, watch, withDirectives, toRef, watchEffect } from 'vue';
 import { VBinder, VTarget, VFollower } from 'vueuc';
 import { clickoutside } from 'vdirs';
-import { format, getTime, isValid, getYear, getMonth } from 'date-fns';
+import { format, getTime, isValid } from 'date-fns';
 import { useIsMounted, useMergedState } from 'vooks';
 import { happensIn } from 'seemly';
 import { NInput } from '../../input';
 import { NBaseIcon } from '../../_internal';
 import { useFormItem, useTheme, useConfig, useLocale } from '../../_mixins';
 import { DateIcon, ToIcon } from '../../_internal/icons';
-import { warn, call, useAdjustedTo, createKey } from '../../_utils';
+import { warn, call, useAdjustedTo, createKey, warnOnce } from '../../_utils';
 import { datePickerLight } from '../styles';
 import { strictParse } from './utils';
 import { uniCalendarValidation, dualCalendarValidation } from './validation-utils';
-import { MONTH_ITEM_HEIGHT, START_YEAR } from './config';
 import { datePickerInjectionKey } from './interface';
 import DatetimePanel from './panel/datetime';
 import DatetimerangePanel from './panel/datetimerange';
@@ -23,37 +22,33 @@ import style from './styles/index.cssr';
 const datePickerProps = Object.assign(Object.assign({}, useTheme.props), { to: useAdjustedTo.propTo, bordered: {
         type: Boolean,
         default: undefined
-    }, clearable: Boolean, updateValueOnClose: Boolean, defaultValue: {
-        type: [Number, Array],
-        default: null
-    }, defaultTime: [Number, String, Array], disabled: {
+    }, clearable: Boolean, updateValueOnClose: Boolean, defaultValue: [Number, Array], defaultFormattedValue: [String, Array], defaultTime: [Number, String, Array], disabled: {
         type: Boolean,
         default: undefined
     }, placement: {
         type: String,
         default: 'bottom-start'
-    }, value: [Number, Array], size: String, type: {
+    }, value: [Number, Array], formattedValue: [String, Array], size: String, type: {
         type: String,
         default: 'date'
-    }, separator: String, placeholder: String, startPlaceholder: String, endPlaceholder: String, format: String, dateFormat: String, timeFormat: String, actions: Array, shortcuts: Object, isDateDisabled: Function, isTimeDisabled: Function, show: {
+    }, valueFormat: String, separator: String, placeholder: String, startPlaceholder: String, endPlaceholder: String, format: String, dateFormat: String, timeFormat: String, actions: Array, shortcuts: Object, isDateDisabled: Function, isTimeDisabled: Function, show: {
         type: Boolean,
         default: undefined
-    }, ranges: Object, firstDayOfWeek: Number, inputReadonly: Boolean, closeOnSelect: Boolean, 'onUpdate:show': [Function, Array], onUpdateShow: [Function, Array], 'onUpdate:value': [Function, Array], onUpdateValue: [Function, Array], onFocus: [Function, Array], onBlur: [Function, Array], 
+    }, ranges: Object, firstDayOfWeek: Number, inputReadonly: Boolean, closeOnSelect: Boolean, 'onUpdate:show': [Function, Array], onUpdateShow: [Function, Array], 'onUpdate:formattedValue': [Function, Array], onUpdateFormattedValue: [Function, Array], 'onUpdate:value': [Function, Array], onUpdateValue: [Function, Array], onFocus: [Function, Array], onBlur: [Function, Array], 
     // deprecated
-    onChange: {
-        type: [Function, Array],
-        validator: () => {
-            if (process.env.NODE_ENV !== 'production') {
-                warn('data-picker', '`on-change` is deprecated, please use `on-update:value` instead.');
-            }
-            return true;
-        },
-        default: undefined
-    } });
+    onChange: [Function, Array] });
 export default defineComponent({
     name: 'DatePicker',
     props: datePickerProps,
     setup(props, { slots }) {
+        var _a;
+        if (process.env.NODE_ENV !== 'production') {
+            watchEffect(() => {
+                if (props.onChange !== undefined) {
+                    warnOnce('data-picker', '`on-change` is deprecated, please use `on-update:value` instead.');
+                }
+            });
+        }
         const { localeRef, dateLocaleRef } = useLocale('DatePicker');
         const formItem = useFormItem(props);
         const { mergedSizeRef, mergedDisabledRef } = formItem;
@@ -64,8 +59,58 @@ export default defineComponent({
         const uncontrolledShowRef = ref(false);
         const controlledShowRef = toRef(props, 'show');
         const mergedShowRef = useMergedState(controlledShowRef, uncontrolledShowRef);
-        const uncontrolledValueRef = ref(props.defaultValue);
-        const controlledValueRef = computed(() => props.value);
+        const dateFnsOptionsRef = computed(() => {
+            return {
+                locale: dateLocaleRef.value.locale
+            };
+        });
+        const mergedFormatRef = computed(() => {
+            const { format } = props;
+            if (format)
+                return format;
+            switch (props.type) {
+                case 'date':
+                case 'daterange':
+                    return localeRef.value.dateFormat;
+                case 'datetime':
+                case 'datetimerange':
+                    return localeRef.value.dateTimeFormat;
+                case 'year':
+                    return localeRef.value.yearTypeFormat;
+                case 'month':
+                    return localeRef.value.monthTypeFormat;
+                case 'quarter':
+                    return localeRef.value.quarterFormat;
+            }
+        });
+        const mergedValueFormatRef = computed(() => {
+            var _a;
+            return (_a = props.valueFormat) !== null && _a !== void 0 ? _a : mergedFormatRef.value;
+        });
+        function getTimestampValue(value) {
+            if (value === null)
+                return null;
+            const { value: mergedValueFormat } = mergedValueFormatRef;
+            const { value: dateFnsOptions } = dateFnsOptionsRef;
+            if (Array.isArray(value)) {
+                return [
+                    strictParse(value[0], mergedValueFormat, new Date(), dateFnsOptions).getTime(),
+                    strictParse(value[1], mergedValueFormat, new Date(), dateFnsOptions).getTime()
+                ];
+            }
+            return strictParse(value, mergedValueFormat, new Date(), dateFnsOptions).getTime();
+        }
+        const { defaultFormattedValue, defaultValue } = props;
+        const uncontrolledValueRef = ref((_a = (defaultFormattedValue !== undefined
+            ? getTimestampValue(defaultFormattedValue)
+            : defaultValue)) !== null && _a !== void 0 ? _a : null);
+        const controlledValueRef = computed(() => {
+            const { formattedValue } = props;
+            if (formattedValue !== undefined) {
+                return getTimestampValue(formattedValue);
+            }
+            return props.value;
+        });
         const mergedValueRef = useMergedState(controlledValueRef, uncontrolledValueRef);
         // We don't change value unless blur or confirm is called
         const pendingValueRef = ref(null);
@@ -76,11 +121,6 @@ export default defineComponent({
         const rangeStartInputValueRef = ref('');
         const rangeEndInputValueRef = ref('');
         const themeRef = useTheme('DatePicker', 'DatePicker', style, datePickerLight, props, mergedClsPrefixRef);
-        const dateFnsOptionsRef = computed(() => {
-            return {
-                locale: dateLocaleRef.value.locale
-            };
-        });
         const timePickerSizeRef = computed(() => {
             var _a, _b;
             return (((_b = (_a = NConfigProvider === null || NConfigProvider === void 0 ? void 0 : NConfigProvider.mergedComponentPropsRef.value) === null || _a === void 0 ? void 0 : _a.DatePicker) === null || _b === void 0 ? void 0 : _b.timePickerSize) || 'small');
@@ -139,25 +179,6 @@ export default defineComponent({
                 return props.endPlaceholder;
             }
         });
-        const mergedFormatRef = computed(() => {
-            const { format } = props;
-            if (format)
-                return format;
-            switch (props.type) {
-                case 'date':
-                case 'daterange':
-                    return localeRef.value.dateFormat;
-                case 'datetime':
-                case 'datetimerange':
-                    return localeRef.value.dateTimeFormat;
-                case 'year':
-                    return localeRef.value.yearTypeFormat;
-                case 'month':
-                    return localeRef.value.monthTypeFormat;
-                case 'quarter':
-                    return localeRef.value.quarterFormat;
-            }
-        });
         const mergedActionsRef = computed(() => {
             const { actions, type } = props;
             if (actions !== undefined)
@@ -190,19 +211,47 @@ export default defineComponent({
                 }
             }
         });
+        function getFormattedValue(value) {
+            if (value === null)
+                return null;
+            if (Array.isArray(value)) {
+                const { value: mergedValueFormat } = mergedValueFormatRef;
+                const { value: dateFnsOptions } = dateFnsOptionsRef;
+                return [
+                    format(value[0], mergedValueFormat, dateFnsOptions),
+                    format(value[1], mergedValueFormat, dateFnsOptionsRef.value)
+                ];
+            }
+            else {
+                return format(value, mergedValueFormatRef.value, dateFnsOptionsRef.value);
+            }
+        }
         function doUpdatePendingValue(value) {
             pendingValueRef.value = value;
         }
+        function doUpdateFormattedValue(value, timestampValue) {
+            const { 'onUpdate:formattedValue': _onUpdateFormattedValue, onUpdateFormattedValue } = props;
+            if (_onUpdateFormattedValue) {
+                call(_onUpdateFormattedValue, value, timestampValue);
+            }
+            if (onUpdateFormattedValue) {
+                call(onUpdateFormattedValue, value, timestampValue);
+            }
+        }
         function doUpdateValue(value) {
             const { 'onUpdate:value': _onUpdateValue, onUpdateValue, onChange } = props;
             const { nTriggerFormChange, nTriggerFormInput } = formItem;
-            if (onUpdateValue)
-                call(onUpdateValue, value);
-            if (_onUpdateValue)
-                call(_onUpdateValue, value);
+            const formattedValue = getFormattedValue(value);
+            if (onUpdateValue) {
+                call(onUpdateValue, value, formattedValue);
+            }
+            if (_onUpdateValue) {
+                call(_onUpdateValue, value, formattedValue);
+            }
             if (onChange)
-                call(onChange, value);
+                call(onChange, value, formattedValue);
             uncontrolledValueRef.value = value;
+            doUpdateFormattedValue(formattedValue, value);
             nTriggerFormChange();
             nTriggerFormInput();
         }
@@ -266,28 +315,6 @@ export default defineComponent({
                 disableUpdateOnClose
             });
         }
-        function scrollPickerColumns(value) {
-            if (!panelInstRef.value)
-                return;
-            const { monthScrollRef, yearScrollRef } = panelInstRef.value;
-            const { value: mergedValue } = mergedValueRef;
-            if (monthScrollRef) {
-                const monthIndex = value === undefined
-                    ? mergedValue === null
-                        ? getMonth(Date.now())
-                        : getMonth(mergedValue)
-                    : getMonth(value);
-                monthScrollRef.scrollTo({ top: monthIndex * MONTH_ITEM_HEIGHT });
-            }
-            if (yearScrollRef) {
-                const yearIndex = (value === undefined
-                    ? mergedValue === null
-                        ? getYear(Date.now())
-                        : getYear(mergedValue)
-                    : getYear(value)) - START_YEAR;
-                yearScrollRef.scrollTo({ top: yearIndex * MONTH_ITEM_HEIGHT });
-            }
-        }
         // --- Panel update value
         function handlePanelUpdateValue(value, doUpdate) {
             if (doUpdate) {
@@ -412,10 +439,6 @@ export default defineComponent({
             if (mergedDisabledRef.value || mergedShowRef.value)
                 return;
             doUpdateShow(true);
-            const { type } = props;
-            if (type === 'month' || type === 'year' || type === 'quarter') {
-                void nextTick(scrollPickerColumns);
-            }
         }
         function closeCalendar({ returnFocus, disableUpdateOnClose }) {
             var _a;
@@ -450,35 +473,22 @@ export default defineComponent({
         // use pending value to do validation
         const uniVaidation = uniCalendarValidation(props, pendingValueRef);
         const dualValidation = dualCalendarValidation(props, pendingValueRef);
-        provide(datePickerInjectionKey, Object.assign(Object.assign(Object.assign({ scrollPickerColumns,
-            mergedClsPrefixRef, mergedThemeRef: themeRef, timePickerSizeRef,
+        provide(datePickerInjectionKey, Object.assign(Object.assign(Object.assign({ mergedClsPrefixRef, mergedThemeRef: themeRef, timePickerSizeRef,
             localeRef,
             dateLocaleRef, firstDayOfWeekRef: toRef(props, 'firstDayOfWeek'), isDateDisabledRef: toRef(props, 'isDateDisabled'), rangesRef: toRef(props, 'ranges'), closeOnSelectRef: toRef(props, 'closeOnSelect'), updateValueOnCloseRef: toRef(props, 'updateValueOnClose') }, uniVaidation), dualValidation), { datePickerSlots: slots }));
-        return {
-            mergedClsPrefix: mergedClsPrefixRef,
-            mergedBordered: mergedBorderedRef,
-            namespace: namespaceRef,
-            uncontrolledValue: uncontrolledValueRef,
-            pendingValue: pendingValueRef,
-            panelInstRef,
+        const exposedMethods = {
+            focus: () => {
+                var _a;
+                (_a = inputInstRef.value) === null || _a === void 0 ? void 0 : _a.focus();
+            },
+            blur: () => {
+                var _a;
+                (_a = inputInstRef.value) === null || _a === void 0 ? void 0 : _a.blur();
+            }
+        };
+        return Object.assign(Object.assign({}, exposedMethods), { mergedClsPrefix: mergedClsPrefixRef, mergedBordered: mergedBorderedRef, namespace: namespaceRef, uncontrolledValue: uncontrolledValueRef, pendingValue: pendingValueRef, panelInstRef,
             triggerElRef,
-            inputInstRef,
-            isMounted: useIsMounted(),
-            displayTime: singleInputValueRef,
-            displayStartTime: rangeStartInputValueRef,
-            displayEndTime: rangeEndInputValueRef,
-            mergedShow: mergedShowRef,
-            adjustedTo: useAdjustedTo(props),
-            isRange: isRangeRef,
-            localizedStartPlaceholder: localizedStartPlaceholderRef,
-            localizedEndPlaceholder: localizedEndPlaceholderRef,
-            mergedSize: mergedSizeRef,
-            mergedDisabled: mergedDisabledRef,
-            localizedPlacehoder: localizedPlacehoderRef,
-            isValueInvalid: uniVaidation.isValueInvalidRef,
-            isStartValueInvalid: dualValidation.isStartValueInvalidRef,
-            isEndValueInvalid: dualValidation.isEndValueInvalidRef,
-            handleClickOutside,
+            inputInstRef, isMounted: useIsMounted(), displayTime: singleInputValueRef, displayStartTime: rangeStartInputValueRef, displayEndTime: rangeEndInputValueRef, mergedShow: mergedShowRef, adjustedTo: useAdjustedTo(props), isRange: isRangeRef, localizedStartPlaceholder: localizedStartPlaceholderRef, localizedEndPlaceholder: localizedEndPlaceholderRef, mergedSize: mergedSizeRef, mergedDisabled: mergedDisabledRef, localizedPlacehoder: localizedPlacehoderRef, isValueInvalid: uniVaidation.isValueInvalidRef, isStartValueInvalid: dualValidation.isStartValueInvalidRef, isEndValueInvalid: dualValidation.isEndValueInvalidRef, handleClickOutside,
             handleKeyDown,
             handleClear,
             handleTriggerClick,
@@ -491,18 +501,14 @@ export default defineComponent({
             handleRangeUpdateValue,
             handleSingleUpdateValue,
             handlePanelUpdateValue,
-            handlePanelConfirm,
-            mergedTheme: themeRef,
-            actions: mergedActionsRef,
-            triggerCssVars: computed(() => {
+            handlePanelConfirm, mergedTheme: themeRef, actions: mergedActionsRef, triggerCssVars: computed(() => {
                 const { common: { cubicBezierEaseInOut }, self: { iconColor, iconColorDisabled } } = themeRef.value;
                 return {
                     '--n-bezier': cubicBezierEaseInOut,
                     '--n-icon-color': iconColor,
                     '--n-icon-color-disabled': iconColorDisabled
                 };
-            }),
-            cssVars: computed(() => {
+            }), cssVars: computed(() => {
                 const { type } = props;
                 const { common: { cubicBezierEaseInOut }, self: { calendarTitleFontSize, calendarDaysFontSize, itemFontSize, itemTextColor, itemColorDisabled, itemColorIncluded, itemColorHover, itemColorActive, itemBorderRadius, itemTextColorDisabled, itemTextColorActive, panelColor, panelTextColor, arrowColor, calendarTitleTextColor, panelActionDividerColor, panelHeaderDividerColor, calendarDaysDividerColor, panelBoxShadow, panelBorderRadius, calendarTitleFontWeight, panelExtraFooterPadding, panelActionPadding, itemSize, itemCellWidth, itemCellHeight, scrollItemWidth, scrollItemHeight, calendarTitlePadding, calendarTitleHeight, calendarDaysHeight, calendarDaysTextColor, arrowSize, panelHeaderPadding, calendarDividerColor, calendarTitleGridTempateColumns, iconColor, iconColorDisabled, scrollItemBorderRadius, [createKey('calendarLeftPadding', type)]: calendarLeftPadding, [createKey('calendarRightPadding', type)]: calendarRightPadding } } = themeRef.value;
                 return {
@@ -556,8 +562,7 @@ export default defineComponent({
                     '--n-icon-color': iconColor,
                     '--n-icon-color-disabled': iconColorDisabled
                 };
-            })
-        };
+            }) });
     },
     render() {
         const { clearable } = this;

package/es/date-picker/src/interface.d.ts

@@ -1,4 +1,4 @@
-import { InjectionKey, Ref, Slots } from 'vue';
+import { Ref, Slots } from 'vue';
 import { VirtualListInst } from 'vueuc';
 import { NLocale, NDateLocale } from '../../locales';
 import type { ScrollbarInst } from '../../_internal';
@@ -8,9 +8,24 @@ import { DatePickerTheme } from '../styles/light';
 import { uniCalendarValidation, dualCalendarValidation } from './validation-utils';
 export declare type Value = number | [number, number];
 export declare type DefaultTime = string | [string | undefined, string | undefined];
+export declare type FormattedValue = string | [string, string];
 export declare type Shortcuts = Record<string, number | (() => number)> | Record<string, [number, number] | (() => [number, number])>;
-export declare type OnUpdateValue = (value: number & (number | null) & [number, number] & ([number, number] | null)) => void;
-export declare type OnUpdateValueImpl = (value: Value | null) => void;
+export declare type OnUpdateValue = (value: number & (number | null) & [
+    number,
+    number
+] & ([number, number] | null), formattedValue: string & (string | null) & [
+    string,
+    string
+] & ([string, string] | null)) => void;
+export declare type OnUpdateFormattedValue = (value: string & (string | null) & [
+    string,
+    string
+] & ([string, string] | null), timestampValue: number & (number | null) & [
+    number,
+    number
+] & ([number, number] | null)) => void;
+export declare type OnUpdateFormattedValueImpl = (value: string | [string, string] | null, timestampValue: number | [number, number] | null) => void;
+export declare type OnUpdateValueImpl = (value: Value | null, formattedValue: string | [string, string] | null) => void;
 export declare type OnPanelUpdateValue = (value: number & (number | null) & [
     number,
     number
@@ -35,9 +50,8 @@ export declare type DatePickerInjection = {
     updateValueOnCloseRef: Ref<boolean>;
     firstDayOfWeekRef: Ref<FirstDayOfWeek | undefined>;
     datePickerSlots: Slots;
-    scrollPickerColumns: (value?: number) => void;
 } & ReturnType<typeof uniCalendarValidation> & ReturnType<typeof dualCalendarValidation>;
-export declare const datePickerInjectionKey: InjectionKey<DatePickerInjection>;
+export declare const datePickerInjectionKey: import("vue").InjectionKey<DatePickerInjection>;
 export declare type IsDateDisabled = IsSingleDateDisabled | IsRangeDateDisabled;
 export declare type IsSingleDateDisabled = (date: number) => boolean;
 export declare type IsRangeDateDisabled = (date: number, position: 'start' | 'end', value: [number, number] | null) => boolean;
@@ -49,3 +63,7 @@ export interface TimeValidator {
 export declare type IsTimeDisabled = IsSingleTimeDisabled | IsRangeTimeDisabled;
 export declare type IsSingleTimeDisabled = (date: number) => TimeValidator;
 export declare type IsRangeTimeDisabled = (date: number, position: 'start' | 'end', value: [number, number]) => TimeValidator;
+export interface DatePickerInst {
+    focus: () => void;
+    blur: () => void;
+}

package/es/date-picker/src/interface.js

@@ -1 +1,2 @@
-export const datePickerInjectionKey = Symbol('datePicker');
+import { createInjectionKey } from '../../_utils';
+export const datePickerInjectionKey = createInjectionKey('n-date-picker');

package/es/date-picker/src/panel/date.d.ts

@@ -7,6 +7,12 @@ declare const _default: import("vue").DefineComponent<{
     readonly dateFormat: StringConstructor;
     readonly timeFormat: {
         readonly type: StringConstructor;
+        /**
+         * Date Panel
+         * Update picker value on:
+         * 1. item click
+         * 2. clear click
+         */
         readonly value: "HH:mm:ss";
     };
     readonly value: {
@@ -37,11 +43,14 @@ declare const _default: import("vue").DefineComponent<{
         [name: string]: import("vue").Slot | undefined;
     }>;
     monthScrollRef: import("vue").Ref<{
-        scrollTo: import("../../../_internal/scrollbar/src/ScrollBar").ScrollTo;
-        sync: () => void;
         containerRef: HTMLElement | null;
         contentRef: HTMLElement | null;
         containerScrollTop: number;
+        syncUnifiedContainer: () => void;
+        scrollTo: import("../../../_internal/scrollbar/src/ScrollBar").ScrollTo;
+        sync: () => void;
+        handleMouseEnterWrapper: () => void;
+        handleMouseLeaveWrapper: () => void;
     } | null>;
     yearScrollRef: import("vue").Ref<{
         listElRef: HTMLElement;
@@ -49,12 +58,19 @@ declare const _default: import("vue").DefineComponent<{
         scrollTo: import("vueuc/lib/virtual-list/src/VirtualList").ScrollTo;
     } | null>;
     scrollbarInstRef: import("vue").Ref<{
-        scrollTo: import("../../../_internal/scrollbar/src/ScrollBar").ScrollTo;
-        sync: () => void;
         containerRef: HTMLElement | null;
         contentRef: HTMLElement | null;
         containerScrollTop: number;
+        syncUnifiedContainer: () => void;
+        scrollTo: import("../../../_internal/scrollbar/src/ScrollBar").ScrollTo;
+        sync: () => void;
+        handleMouseEnterWrapper: () => void;
+        handleMouseLeaveWrapper: () => void;
     } | null>;
+    handleQuickMonthClick: (dateItem: import("../utils").MonthItem | import("../utils").YearItem | import("../utils").QuarterItem, updatePanelValue: (value: number) => void) => void;
+    scrollPickerColumns: (value?: number | undefined) => void;
+    calendarValue: import("vue").Ref<number>;
+    onUpdateCalendarValue: (value: number) => void;
     mergedTheme: import("vue").Ref<{
         common: {
             baseColor: string;
@@ -199,7 +215,12 @@ declare const _default: import("vue").DefineComponent<{
             arrowSize: string;
             panelHeaderPadding: string;
             calendarDaysHeight: string;
-            calendarTitleGridTempateColumns: string;
+            calendarTitleGridTempateColumns: string; /**
+             * Date Panel
+             * Update picker value on:
+             * 1. item click
+             * 2. clear click
+             */
             calendarLeftPaddingDate: string;
             calendarLeftPaddingDatetime: string;
             calendarLeftPaddingDaterange: string;
@@ -476,7 +497,12 @@ declare const _default: import("vue").DefineComponent<{
                 iconMarginLarge: string;
                 iconSizeTiny: string;
                 iconSizeSmall: string;
-                iconSizeMedium: string;
+                iconSizeMedium: string; /**
+                 * Date Panel
+                 * Update picker value on:
+                 * 1. item click
+                 * 2. clear click
+                 */
                 iconSizeLarge: string;
                 rippleDuration: string;
             }, any>;
@@ -701,7 +727,12 @@ declare const _default: import("vue").DefineComponent<{
                     iconMarginLarge: string;
                     iconSizeTiny: string;
                     iconSizeSmall: string;
-                    iconSizeMedium: string;
+                    iconSizeMedium: string; /**
+                     * Date Panel
+                     * Update picker value on:
+                     * 1. item click
+                     * 2. clear click
+                     */
                     iconSizeLarge: string;
                     rippleDuration: string;
                 }, any>;
@@ -988,7 +1019,12 @@ declare const _default: import("vue").DefineComponent<{
                         iconMarginLarge: string;
                         iconSizeTiny: string;
                         iconSizeSmall: string;
-                        iconSizeMedium: string;
+                        iconSizeMedium: string; /**
+                         * Date Panel
+                         * Update picker value on:
+                         * 1. item click
+                         * 2. clear click
+                         */
                         iconSizeLarge: string;
                         rippleDuration: string;
                     }, any>> | undefined;
@@ -1107,6 +1143,8 @@ declare const _default: import("vue").DefineComponent<{
     restorePendingValue: () => void;
     getShortcutValue: (shortcut: number | [number, number] | (() => number) | (() => [number, number])) => number | [number, number];
     handleShortcutMouseleave: () => void;
+    showMonthYearPanel: import("vue").Ref<boolean>;
+    handleOpenQuickSelectMonthPanel: () => void;
     isValueInvalid: import("vue").ComputedRef<boolean>;
     isDateDisabled: import("vue").Ref<import("../interface").IsDateDisabled | undefined>;
     isDateInvalid: import("vue").ComputedRef<boolean>;
@@ -1131,32 +1169,37 @@ declare const _default: import("vue").DefineComponent<{
     handleConfirmClick: () => void;
     handleSingleShortcutMouseenter: (shortcut: number | [number, number] | (() => number) | (() => [number, number])) => void;
     handleSingleShortcutClick: (shortcut: number | [number, number] | (() => number) | (() => [number, number])) => void;
-}, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, Record<string, any>, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<{
-    readonly actions?: unknown;
-    readonly active?: unknown;
-    readonly dateFormat?: unknown;
-    readonly timeFormat?: unknown;
-    readonly value?: unknown;
-    readonly shortcuts?: unknown;
-    readonly defaultTime?: unknown;
-    readonly onConfirm?: unknown;
-    readonly onClose?: unknown;
-    readonly onTabOut?: unknown;
-    readonly onUpdateValue?: unknown;
-} & {
-    value: import("../interface").Value | null;
-    active: boolean;
-    onUpdateValue: import("../interface").OnPanelUpdateValue;
-    actions: string[];
-} & {
-    dateFormat?: string | undefined;
-    onTabOut?: Function | undefined;
-    onClose?: import("../interface").OnClose | undefined;
-    onConfirm?: Function | undefined;
-    defaultTime?: import("../interface").DefaultTime | undefined;
-    timeFormat?: string | undefined;
-    shortcuts?: import("../interface").Shortcuts | undefined;
-}>, {
+}, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, Record<string, any>, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
+    readonly actions: {
+        readonly type: import("vue").PropType<string[]>;
+        readonly default: () => string[];
+    };
+    readonly active: BooleanConstructor;
+    readonly dateFormat: StringConstructor;
+    readonly timeFormat: {
+        readonly type: StringConstructor;
+        /**
+         * Date Panel
+         * Update picker value on:
+         * 1. item click
+         * 2. clear click
+         */
+        readonly value: "HH:mm:ss";
+    };
+    readonly value: {
+        readonly type: import("vue").PropType<import("../interface").Value | null>;
+        readonly default: null;
+    };
+    readonly shortcuts: import("vue").PropType<import("../interface").Shortcuts>;
+    readonly defaultTime: import("vue").PropType<import("../interface").DefaultTime>;
+    readonly onConfirm: FunctionConstructor;
+    readonly onClose: import("vue").PropType<import("../interface").OnClose>;
+    readonly onTabOut: FunctionConstructor;
+    readonly onUpdateValue: {
+        readonly type: import("vue").PropType<import("../interface").OnPanelUpdateValue>;
+        readonly required: true;
+    };
+}>>, {
     value: import("../interface").Value | null;
     active: boolean;
     actions: string[];

package/es/date-picker/src/panel/date.js

@@ -1,9 +1,10 @@
-import { h, defineComponent, renderSlot, watchEffect } from 'vue';
-import { NButton, NxButton } from '../../../button';
+import { h, defineComponent, watchEffect } from 'vue';
 import { BackwardIcon, FastBackwardIcon, ForwardIcon, FastForwardIcon } from '../../../_internal/icons';
+import { NButton, NxButton } from '../../../button';
 import { NBaseFocusDetector } from '../../../_internal';
-import { useCalendar, useCalendarProps } from './use-calendar';
 import { warnOnce } from '../../../_utils';
+import { useCalendar, useCalendarProps } from './use-calendar';
+import PanelHeader from './panelHeader';
 /**
  * Date Panel
  * Update picker value on:
@@ -34,9 +35,7 @@ export default defineComponent({
                         h(FastBackwardIcon, null)),
                     h("div", { class: `${mergedClsPrefix}-date-panel-month__prev`, onClick: this.prevMonth },
                         h(BackwardIcon, null)),
-                    h("div", { class: `${mergedClsPrefix}-date-panel-month__month-year` }, this.locale.monthBeforeYear
-                        ? `${this.calendarMonth} ${this.calendarYear}`
-                        : `${this.calendarYear} ${this.calendarMonth}`),
+                    h(PanelHeader, { monthBeforeYear: this.locale.monthBeforeYear, value: this.calendarValue, onUpdateValue: this.onUpdateCalendarValue, mergedClsPrefix: mergedClsPrefix, calendarMonth: this.calendarMonth, calendarYear: this.calendarYear }),
                     h("div", { class: `${mergedClsPrefix}-date-panel-month__next`, onClick: this.nextMonth },
                         h(ForwardIcon, null)),
                     h("div", { class: `${mergedClsPrefix}-date-panel-month__fast-next`, onClick: this.nextYear },
@@ -53,7 +52,7 @@ export default defineComponent({
                     ], onClick: () => this.handleDateClick(dateItem) },
                     dateItem.dateObject.date,
                     dateItem.isCurrentDate ? (h("div", { class: `${mergedClsPrefix}-date-panel-date__sup` })) : null))))),
-            this.datePickerSlots.footer ? (h("div", { class: `${mergedClsPrefix}-date-panel-footer` }, renderSlot(this.datePickerSlots, 'footer'))) : null,
+            this.datePickerSlots.footer ? (h("div", { class: `${mergedClsPrefix}-date-panel-footer` }, this.datePickerSlots.footer())) : null,
             ((_a = this.actions) === null || _a === void 0 ? void 0 : _a.length) || shortcuts ? (h("div", { class: `${mergedClsPrefix}-date-panel-actions` },
                 h("div", { class: `${mergedClsPrefix}-date-panel-actions__prefix` }, shortcuts &&
                     Object.keys(shortcuts).map((key) => {