naive-ui 2.23.2 → 2.24.0

package/es/data-table/src/DataTable.js

@@ -1,18 +1,18 @@
-import { h, computed, defineComponent, ref, provide, toRef, Transition } from 'vue';
+import { h, computed, defineComponent, ref, provide, toRef, Transition, watchEffect } from 'vue';
 import { createId } from 'seemly';
 import { useConfig, useLocale, useTheme } from '../../_mixins';
 import { NBaseLoading } from '../../_internal';
 import { NPagination } from '../../pagination';
-import { warn, createKey } from '../../_utils';
+import { createKey, warnOnce } from '../../_utils';
 import { dataTableLight } from '../styles';
 import MainTable from './MainTable';
 import { useCheck } from './use-check';
 import { useTableData } from './use-table-data';
 import { useScroll } from './use-scroll';
 import { dataTableInjectionKey } from './interface';
-import style from './styles/index.cssr';
 import { useGroupHeader } from './use-group-header';
 import { useExpand } from './use-expand';
+import style from './styles/index.cssr';
 export const dataTableProps = Object.assign(Object.assign({}, useTheme.props), { pagination: {
         type: [Object, Boolean],
         default: false
@@ -56,57 +56,31 @@ export const dataTableProps = Object.assign(Object.assign({}, useTheme.props), {
         default: 16
     }, flexHeight: Boolean, 'onUpdate:page': [Function, Array], onUpdatePage: [Function, Array], 'onUpdate:pageSize': [Function, Array], onUpdatePageSize: [Function, Array], 'onUpdate:sorter': [Function, Array], onUpdateSorter: [Function, Array], 'onUpdate:filters': [Function, Array], onUpdateFilters: [Function, Array], 'onUpdate:checkedRowKeys': [Function, Array], onUpdateCheckedRowKeys: [Function, Array], 'onUpdate:expandedRowKeys': [Function, Array], onUpdateExpandedRowKeys: [Function, Array], 
     // deprecated
-    onPageChange: {
-        type: [Function, Array],
-        validator: () => {
-            if (process.env.NODE_ENV !== 'production') {
-                warn('data-table', '`on-page-change` is deprecated, please use `on-update:page` instead.');
-            }
-            return true;
-        },
-        default: undefined
-    }, onPageSizeChange: {
-        type: [Function, Array],
-        validator: () => {
-            if (process.env.NODE_ENV !== 'production') {
-                warn('data-table', '`on-page-size-change` is deprecated, please use `on-update:page-size` instead.');
-            }
-            return true;
-        },
-        default: undefined
-    }, onSorterChange: {
-        type: [Function, Array],
-        validator: () => {
-            if (process.env.NODE_ENV !== 'production') {
-                warn('data-table', '`on-sorter-change` is deprecated, please use `on-update:sorter` instead.');
-            }
-            return true;
-        },
-        default: undefined
-    }, onFiltersChange: {
-        type: [Function, Array],
-        validator: () => {
-            if (process.env.NODE_ENV !== 'production') {
-                warn('data-table', '`on-filters-change` is deprecated, please use `on-update:filters` instead.');
-            }
-            return true;
-        },
-        default: undefined
-    }, onCheckedRowKeysChange: {
-        type: [Function, Array],
-        validator: () => {
-            if (process.env.NODE_ENV !== 'production') {
-                warn('data-table', '`on-checked-row-keys-change` is deprecated, please use `on-update:checked-row-keys` instead.');
-            }
-            return true;
-        },
-        default: undefined
-    } });
+    onPageChange: [Function, Array], onPageSizeChange: [Function, Array], onSorterChange: [Function, Array], onFiltersChange: [Function, Array], onCheckedRowKeysChange: [Function, Array] });
 export default defineComponent({
     name: 'DataTable',
     alias: ['AdvancedTable'],
     props: dataTableProps,
     setup(props, { slots }) {
+        if (process.env.NODE_ENV !== 'production') {
+            watchEffect(() => {
+                if (props.onPageChange !== undefined) {
+                    warnOnce('data-table', '`on-page-change` is deprecated, please use `on-update:page` instead.');
+                }
+                if (props.onPageSizeChange !== undefined) {
+                    warnOnce('data-table', '`on-page-size-change` is deprecated, please use `on-update:page-size` instead.');
+                }
+                if (props.onSorterChange !== undefined) {
+                    warnOnce('data-table', '`on-sorter-change` is deprecated, please use `on-update:sorter` instead.');
+                }
+                if (props.onFiltersChange !== undefined) {
+                    warnOnce('data-table', '`on-filters-change` is deprecated, please use `on-update:filters` instead.');
+                }
+                if (props.onCheckedRowKeysChange !== undefined) {
+                    warnOnce('data-table', '`on-checked-row-keys-change` is deprecated, please use `on-update:checked-row-keys` instead.');
+                }
+            });
+        }
         const { mergedBorderedRef, mergedClsPrefixRef } = useConfig(props);
         const mergedBottomBorderedRef = computed(() => {
             const { bottomBordered } = props;

package/es/data-table/src/interface.d.ts

@@ -33,7 +33,7 @@ export declare type SortOrder = 'ascend' | 'descend' | false;
 export declare type Ellipsis = boolean | EllipsisProps;
 export interface CommonColumnInfo {
     fixed?: 'left' | 'right';
-    width?: number;
+    width?: number | string;
     className?: string;
     align?: 'left' | 'center' | 'right';
     ellipsis?: Ellipsis;

package/es/data-table/src/styles/index.cssr.js

@@ -225,7 +225,10 @@ c('&::after', {
  border-top-left-radius: var(--n-border-radius);
  border-top-right-radius: var(--n-border-radius);
  line-height: var(--n-line-height);
- `), cM('loading', [cB('data-table-wrapper', 'opacity: var(--n-opacity-loading);')]), cM('single-column', [cB('data-table-td', {
+ `), cM('loading', [cB('data-table-wrapper', `
+ opacity: var(--n-opacity-loading);
+ pointer-events: none;
+ `)]), cM('single-column', [cB('data-table-td', {
   borderBottom: '0 solid var(--n-merged-border-color)'
 }, [c('&::after, &::before', {
   bottom: '0 !important'

package/es/data-table/src/utils.js

@@ -1,4 +1,4 @@
-import { pxfy } from 'seemly';
+import { depx, pxfy } from 'seemly';
 export const selectionColWidth = 40;
 export const expandColWidth = 40;
 export function getColWidth(col) {
@@ -8,6 +8,9 @@ export function getColWidth(col) {
         return expandColWidth;
     if ('children' in col)
         return undefined;
+    if (typeof col.width === 'string') {
+        return depx(col.width);
+    }
     return col.width;
 }
 export function getColKey(col) {

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

@@ -2,7 +2,7 @@ import { PropType, ExtractPropTypes, Ref } from 'vue';
 import { FollowerPlacement } from 'vueuc';
 import type { MaybeArray, ExtractPublicPropTypes } from '../../_utils';
 import { DatePickerType } from './config';
-import type { OnUpdateValue, Value, IsDateDisabled, IsTimeDisabled, Shortcuts, FirstDayOfWeek, DefaultTime } from './interface';
+import type { OnUpdateValue, Value, IsDateDisabled, IsTimeDisabled, Shortcuts, FirstDayOfWeek, DefaultTime, FormattedValue, OnUpdateFormattedValue } from './interface';
 declare const datePickerProps: {
     readonly to: {
         type: PropType<string | boolean | HTMLElement>;
@@ -14,10 +14,8 @@ declare const datePickerProps: {
     };
     readonly clearable: BooleanConstructor;
     readonly updateValueOnClose: BooleanConstructor;
-    readonly defaultValue: {
-        readonly type: PropType<Value | null>;
-        readonly default: null;
-    };
+    readonly defaultValue: PropType<Value | null>;
+    readonly defaultFormattedValue: PropType<FormattedValue | null>;
     readonly defaultTime: PropType<DefaultTime>;
     readonly disabled: {
         readonly type: PropType<boolean | undefined>;
@@ -28,11 +26,13 @@ declare const datePickerProps: {
         readonly default: "bottom-start";
     };
     readonly value: PropType<Value | null>;
+    readonly formattedValue: PropType<FormattedValue | null>;
     readonly size: PropType<"small" | "medium" | "large">;
     readonly type: {
         readonly type: PropType<DatePickerType>;
         readonly default: "date";
     };
+    readonly valueFormat: StringConstructor;
     readonly separator: StringConstructor;
     readonly placeholder: StringConstructor;
     readonly startPlaceholder: StringConstructor;
@@ -54,15 +54,13 @@ declare const datePickerProps: {
     readonly closeOnSelect: BooleanConstructor;
     readonly 'onUpdate:show': PropType<MaybeArray<(show: boolean) => void>>;
     readonly onUpdateShow: PropType<MaybeArray<(show: boolean) => void>>;
+    readonly 'onUpdate:formattedValue': PropType<MaybeArray<OnUpdateFormattedValue>>;
+    readonly onUpdateFormattedValue: PropType<MaybeArray<OnUpdateFormattedValue>>;
     readonly 'onUpdate:value': PropType<MaybeArray<OnUpdateValue>>;
     readonly onUpdateValue: PropType<MaybeArray<OnUpdateValue>>;
     readonly onFocus: PropType<(e: FocusEvent) => void>;
     readonly onBlur: PropType<(e: FocusEvent) => void>;
-    readonly onChange: {
-        readonly type: PropType<MaybeArray<OnUpdateValue>>;
-        readonly validator: () => boolean;
-        readonly default: undefined;
-    };
+    readonly onChange: PropType<MaybeArray<OnUpdateValue>>;
     readonly theme: PropType<import("../../_mixins").Theme<"DatePicker", {
         itemFontSize: string;
         calendarDaysFontSize: string;
@@ -1910,10 +1908,8 @@ declare const _default: import("vue").DefineComponent<{
     };
     readonly clearable: BooleanConstructor;
     readonly updateValueOnClose: BooleanConstructor;
-    readonly defaultValue: {
-        readonly type: PropType<Value | null>;
-        readonly default: null;
-    };
+    readonly defaultValue: PropType<Value | null>;
+    readonly defaultFormattedValue: PropType<FormattedValue | null>;
     readonly defaultTime: PropType<DefaultTime>;
     readonly disabled: {
         readonly type: PropType<boolean | undefined>;
@@ -1924,11 +1920,13 @@ declare const _default: import("vue").DefineComponent<{
         readonly default: "bottom-start";
     };
     readonly value: PropType<Value | null>;
+    readonly formattedValue: PropType<FormattedValue | null>;
     readonly size: PropType<"small" | "medium" | "large">;
     readonly type: {
         readonly type: PropType<DatePickerType>;
         readonly default: "date";
     };
+    readonly valueFormat: StringConstructor;
     readonly separator: StringConstructor;
     readonly placeholder: StringConstructor;
     readonly startPlaceholder: StringConstructor;
@@ -1950,15 +1948,13 @@ declare const _default: import("vue").DefineComponent<{
     readonly closeOnSelect: BooleanConstructor;
     readonly 'onUpdate:show': PropType<MaybeArray<(show: boolean) => void>>;
     readonly onUpdateShow: PropType<MaybeArray<(show: boolean) => void>>;
+    readonly 'onUpdate:formattedValue': PropType<MaybeArray<OnUpdateFormattedValue>>;
+    readonly onUpdateFormattedValue: PropType<MaybeArray<OnUpdateFormattedValue>>;
     readonly 'onUpdate:value': PropType<MaybeArray<OnUpdateValue>>;
     readonly onUpdateValue: PropType<MaybeArray<OnUpdateValue>>;
     readonly onFocus: PropType<(e: FocusEvent) => void>;
     readonly onBlur: PropType<(e: FocusEvent) => void>;
-    readonly onChange: {
-        readonly type: PropType<MaybeArray<OnUpdateValue>>;
-        readonly validator: () => boolean;
-        readonly default: undefined;
-    };
+    readonly onChange: PropType<MaybeArray<OnUpdateValue>>;
     readonly theme: PropType<import("../../_mixins").Theme<"DatePicker", {
         itemFontSize: string;
         calendarDaysFontSize: string;
@@ -4916,12 +4912,15 @@ declare const _default: import("vue").DefineComponent<{
     readonly clearable?: unknown;
     readonly updateValueOnClose?: unknown;
     readonly defaultValue?: unknown;
+    readonly defaultFormattedValue?: unknown;
     readonly defaultTime?: unknown;
     readonly disabled?: unknown;
     readonly placement?: unknown;
     readonly value?: unknown;
+    readonly formattedValue?: unknown;
     readonly size?: unknown;
     readonly type?: unknown;
+    readonly valueFormat?: unknown;
     readonly separator?: unknown;
     readonly placeholder?: unknown;
     readonly startPlaceholder?: unknown;
@@ -4940,6 +4939,8 @@ declare const _default: import("vue").DefineComponent<{
     readonly closeOnSelect?: unknown;
     readonly 'onUpdate:show'?: unknown;
     readonly onUpdateShow?: unknown;
+    readonly 'onUpdate:formattedValue'?: unknown;
+    readonly onUpdateFormattedValue?: unknown;
     readonly 'onUpdate:value'?: unknown;
     readonly onUpdateValue?: unknown;
     readonly onFocus?: unknown;
@@ -4952,7 +4953,6 @@ declare const _default: import("vue").DefineComponent<{
     type: DatePickerType;
     placement: FollowerPlacement;
     clearable: boolean;
-    defaultValue: Value | null;
     updateValueOnClose: boolean;
     inputReadonly: boolean;
     closeOnSelect: boolean;
@@ -6806,27 +6806,31 @@ declare const _default: import("vue").DefineComponent<{
     bordered?: boolean | undefined;
     "onUpdate:show"?: MaybeArray<(show: boolean) => void> | undefined;
     onUpdateShow?: MaybeArray<(show: boolean) => void> | undefined;
+    defaultValue?: Value | null | undefined;
     "onUpdate:value"?: MaybeArray<OnUpdateValue> | undefined;
     onUpdateValue?: MaybeArray<OnUpdateValue> | undefined;
     isDateDisabled?: IsDateDisabled | undefined;
     actions?: ("clear" | "confirm" | "now")[] | undefined;
+    defaultFormattedValue?: FormattedValue | null | undefined;
     defaultTime?: DefaultTime | undefined;
+    formattedValue?: FormattedValue | null | undefined;
+    valueFormat?: string | undefined;
     startPlaceholder?: string | undefined;
     endPlaceholder?: string | undefined;
     timeFormat?: string | undefined;
     shortcuts?: Shortcuts | undefined;
     isTimeDisabled?: IsTimeDisabled | undefined;
     ranges?: Record<string, [number, number]> | undefined;
+    "onUpdate:formattedValue"?: MaybeArray<OnUpdateFormattedValue> | undefined;
+    onUpdateFormattedValue?: MaybeArray<OnUpdateFormattedValue> | undefined;
 }>, {
     type: DatePickerType;
     show: boolean | undefined;
     disabled: boolean | undefined;
-    onChange: MaybeArray<OnUpdateValue>;
     to: string | boolean | HTMLElement;
     placement: FollowerPlacement;
     bordered: boolean | undefined;
     clearable: boolean;
-    defaultValue: Value | null;
     updateValueOnClose: boolean;
     inputReadonly: boolean;
     closeOnSelect: boolean;

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

@@ -8,7 +8,7 @@ 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';
@@ -23,37 +23,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 +60,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 +122,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 +180,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 +212,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();
         }

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

@@ -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

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

@@ -44,7 +44,7 @@ function useCalendar(props, type) {
     const yearArrayRef = computed(() => {
         return yearArray(calendarValueRef.value, props.value, nowRef.value);
     });
-    const querterArrayRef = computed(() => {
+    const quarterArrayRef = computed(() => {
         return quarterArray(calendarValueRef.value, props.value, nowRef.value);
     });
     const weekdaysRef = computed(() => {
@@ -246,7 +246,7 @@ function useCalendar(props, type) {
         panelCommon.clearPendingValue();
         handleConfirmClick();
     }
-    return Object.assign(Object.assign(Object.assign({ dateArray: dateArrayRef, monthArray: monthArrayRef, yearArray: yearArrayRef, quarterArray: querterArrayRef, calendarYear: calendarYearRef, calendarMonth: calendarMonthRef, weekdays: weekdaysRef, mergedIsDateDisabled,
+    return Object.assign(Object.assign(Object.assign({ dateArray: dateArrayRef, monthArray: monthArrayRef, yearArray: yearArrayRef, quarterArray: quarterArrayRef, calendarYear: calendarYearRef, calendarMonth: calendarMonthRef, weekdays: weekdaysRef, mergedIsDateDisabled,
         nextYear,
         prevYear,
         nextMonth,