@rc-component/picker 1.0.0

package/es/PickerInput/hooks/useRangeDisabledDate.js

@@ -0,0 +1,53 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import { isSame } from "../../utils/dateUtil";
+import { getFromDate } from "../../utils/miscUtil";
+
+/**
+ * RangePicker need additional logic to handle the `disabled` case. e.g.
+ * [disabled, enabled] should end date not before start date
+ */
+export default function useRangeDisabledDate(values, disabled, activeIndexList, generateConfig, locale, disabledDate) {
+  var activeIndex = activeIndexList[activeIndexList.length - 1];
+  var rangeDisabledDate = function rangeDisabledDate(date, info) {
+    var _values = _slicedToArray(values, 2),
+      start = _values[0],
+      end = _values[1];
+    var mergedInfo = _objectSpread(_objectSpread({}, info), {}, {
+      from: getFromDate(values, activeIndexList)
+    });
+
+    // ============================ Disabled ============================
+    // Should not select days before the start date
+    if (activeIndex === 1 && disabled[0] && start &&
+    // Same date isOK
+    !isSame(generateConfig, locale, start, date, mergedInfo.type) &&
+    // Before start date
+    generateConfig.isAfter(start, date)) {
+      return true;
+    }
+
+    // Should not select days after the end date
+    if (activeIndex === 0 && disabled[1] && end &&
+    // Same date isOK
+    !isSame(generateConfig, locale, end, date, mergedInfo.type) &&
+    // After end date
+    generateConfig.isAfter(date, end)) {
+      return true;
+    }
+
+    // ============================= Origin =============================
+    return disabledDate === null || disabledDate === void 0 ? void 0 : disabledDate(date, mergedInfo);
+  };
+  return rangeDisabledDate;
+}

package/es/PickerInput/hooks/useRangePickerValue.d.ts

@@ -0,0 +1,5 @@
+import type { GenerateConfig } from '../../generate';
+import type { InternalMode, Locale, PanelMode } from '../../interface';
+import type { RangePickerProps } from '../RangePicker';
+export declare function offsetPanelDate<DateType = any>(generateConfig: GenerateConfig<DateType>, picker: InternalMode, date: DateType, offset: number): DateType;
+export default function useRangePickerValue<DateType extends object, ValueType extends DateType[]>(generateConfig: GenerateConfig<DateType>, locale: Locale, calendarValue: ValueType, modes: PanelMode[], open: boolean, activeIndex: number, pickerMode: InternalMode, multiplePanel: boolean, defaultPickerValue?: ValueType, pickerValue?: ValueType, timeDefaultValue?: ValueType, onPickerValueChange?: RangePickerProps<DateType>['onPickerValueChange'], minDate?: DateType, maxDate?: DateType): [currentIndexPickerValue: DateType, setCurrentIndexPickerValue: (value: DateType) => void];

package/es/PickerInput/hooks/useRangePickerValue.js

@@ -0,0 +1,192 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import { useMergedState } from '@rc-component/util';
+import useLayoutEffect from "@rc-component/util/es/hooks/useLayoutEffect";
+import * as React from 'react';
+import { fillTime, isSame } from "../../utils/dateUtil";
+export function offsetPanelDate(generateConfig, picker, date, offset) {
+  switch (picker) {
+    case 'date':
+    case 'week':
+      return generateConfig.addMonth(date, offset);
+    case 'month':
+    case 'quarter':
+      return generateConfig.addYear(date, offset);
+    case 'year':
+      return generateConfig.addYear(date, offset * 10);
+    case 'decade':
+      return generateConfig.addYear(date, offset * 100);
+    default:
+      return date;
+  }
+}
+var EMPTY_LIST = [];
+export default function useRangePickerValue(generateConfig, locale, calendarValue, modes, open, activeIndex, pickerMode, multiplePanel) {
+  var defaultPickerValue = arguments.length > 8 && arguments[8] !== undefined ? arguments[8] : EMPTY_LIST;
+  var pickerValue = arguments.length > 9 && arguments[9] !== undefined ? arguments[9] : EMPTY_LIST;
+  var timeDefaultValue = arguments.length > 10 && arguments[10] !== undefined ? arguments[10] : EMPTY_LIST;
+  var onPickerValueChange = arguments.length > 11 ? arguments[11] : undefined;
+  var minDate = arguments.length > 12 ? arguments[12] : undefined;
+  var maxDate = arguments.length > 13 ? arguments[13] : undefined;
+  var isTimePicker = pickerMode === 'time';
+
+  // ======================== Active ========================
+  // `activeIndex` must be valid to avoid getting empty `pickerValue`
+  var mergedActiveIndex = activeIndex || 0;
+
+  // ===================== Picker Value =====================
+  var getDefaultPickerValue = function getDefaultPickerValue(index) {
+    var now = generateConfig.getNow();
+    if (isTimePicker) {
+      now = fillTime(generateConfig, now);
+    }
+    return defaultPickerValue[index] || calendarValue[index] || now;
+  };
+
+  // Align `pickerValue` with `showTime.defaultValue`
+  var _pickerValue = _slicedToArray(pickerValue, 2),
+    startPickerValue = _pickerValue[0],
+    endPickerValue = _pickerValue[1];
+
+  // PickerValue state
+  var _useMergedState = useMergedState(function () {
+      return getDefaultPickerValue(0);
+    }, {
+      value: startPickerValue
+    }),
+    _useMergedState2 = _slicedToArray(_useMergedState, 2),
+    mergedStartPickerValue = _useMergedState2[0],
+    setStartPickerValue = _useMergedState2[1];
+  var _useMergedState3 = useMergedState(function () {
+      return getDefaultPickerValue(1);
+    }, {
+      value: endPickerValue
+    }),
+    _useMergedState4 = _slicedToArray(_useMergedState3, 2),
+    mergedEndPickerValue = _useMergedState4[0],
+    setEndPickerValue = _useMergedState4[1];
+
+  // Current PickerValue
+  var currentPickerValue = React.useMemo(function () {
+    var current = [mergedStartPickerValue, mergedEndPickerValue][mergedActiveIndex];
+
+    // Merge the `showTime.defaultValue` into `pickerValue`
+    return isTimePicker ? current : fillTime(generateConfig, current, timeDefaultValue[mergedActiveIndex]);
+  }, [isTimePicker, mergedStartPickerValue, mergedEndPickerValue, mergedActiveIndex, generateConfig, timeDefaultValue]);
+  var setCurrentPickerValue = function setCurrentPickerValue(nextPickerValue) {
+    var source = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'panel';
+    var updater = [setStartPickerValue, setEndPickerValue][mergedActiveIndex];
+    updater(nextPickerValue);
+    var clone = [mergedStartPickerValue, mergedEndPickerValue];
+    clone[mergedActiveIndex] = nextPickerValue;
+    if (onPickerValueChange && (!isSame(generateConfig, locale, mergedStartPickerValue, clone[0], pickerMode) || !isSame(generateConfig, locale, mergedEndPickerValue, clone[1], pickerMode))) {
+      onPickerValueChange(clone, {
+        source: source,
+        range: mergedActiveIndex === 1 ? 'end' : 'start',
+        mode: modes
+      });
+    }
+  };
+
+  // ======================== Effect ========================
+  /**
+   * EndDate pickerValue is little different. It should be:
+   * - If date picker (without time), endDate is not same year & month as startDate
+   *   - pickerValue minus one month
+   * - Else pass directly
+   */
+  var getEndDatePickerValue = function getEndDatePickerValue(startDate, endDate) {
+    if (multiplePanel) {
+      // Basic offset
+      var SAME_CHECKER = {
+        date: 'month',
+        week: 'month',
+        month: 'year',
+        quarter: 'year'
+      };
+      var mode = SAME_CHECKER[pickerMode];
+      if (mode && !isSame(generateConfig, locale, startDate, endDate, mode)) {
+        return offsetPanelDate(generateConfig, pickerMode, endDate, -1);
+      }
+
+      // Year offset
+      if (pickerMode === 'year' && startDate) {
+        var srcYear = Math.floor(generateConfig.getYear(startDate) / 10);
+        var tgtYear = Math.floor(generateConfig.getYear(endDate) / 10);
+        if (srcYear !== tgtYear) {
+          return offsetPanelDate(generateConfig, pickerMode, endDate, -1);
+        }
+      }
+    }
+    return endDate;
+  };
+
+  // >>> When switch field, reset the picker value as prev field picker value
+  var prevActiveIndexRef = React.useRef(null);
+  useLayoutEffect(function () {
+    if (open) {
+      if (!defaultPickerValue[mergedActiveIndex]) {
+        var nextPickerValue = isTimePicker ? null : generateConfig.getNow();
+
+        /**
+         * 1. If has prevActiveIndex, use it to avoid panel jump
+         * 2. If current field has value
+         *    - If `activeIndex` is 1 and `calendarValue[0]` is not same panel as `calendarValue[1]`,
+         *      offset `calendarValue[1]` and set it
+         *    - Else use `calendarValue[activeIndex]`
+         * 3. If current field has no value but another field has value, use another field value
+         * 4. Else use now (not any `calendarValue` can ref)
+         */
+
+        if (prevActiveIndexRef.current !== null && prevActiveIndexRef.current !== mergedActiveIndex) {
+          // If from another field, not jump picker value
+          nextPickerValue = [mergedStartPickerValue, mergedEndPickerValue][mergedActiveIndex ^ 1];
+        } else if (calendarValue[mergedActiveIndex]) {
+          // Current field has value
+          nextPickerValue = mergedActiveIndex === 0 ? calendarValue[0] : getEndDatePickerValue(calendarValue[0], calendarValue[1]);
+        } else if (calendarValue[mergedActiveIndex ^ 1]) {
+          // Current field has no value but another field has value
+          nextPickerValue = calendarValue[mergedActiveIndex ^ 1];
+        }
+
+        // Only sync when has value, this will sync in the `min-max` logic
+        if (nextPickerValue) {
+          // nextPickerValue < minDate
+          if (minDate && generateConfig.isAfter(minDate, nextPickerValue)) {
+            nextPickerValue = minDate;
+          }
+
+          // maxDate < nextPickerValue
+          var offsetPickerValue = multiplePanel ? offsetPanelDate(generateConfig, pickerMode, nextPickerValue, 1) : nextPickerValue;
+          if (maxDate && generateConfig.isAfter(offsetPickerValue, maxDate)) {
+            nextPickerValue = multiplePanel ? offsetPanelDate(generateConfig, pickerMode, maxDate, -1) : maxDate;
+          }
+          setCurrentPickerValue(nextPickerValue, 'reset');
+        }
+      }
+    }
+  }, [open, mergedActiveIndex, calendarValue[mergedActiveIndex]]);
+
+  // >>> Reset prevActiveIndex when panel closed
+  React.useEffect(function () {
+    if (open) {
+      prevActiveIndexRef.current = mergedActiveIndex;
+    } else {
+      prevActiveIndexRef.current = null;
+    }
+  }, [open, mergedActiveIndex]);
+
+  // >>> defaultPickerValue: Resync to `defaultPickerValue` for each panel focused
+  useLayoutEffect(function () {
+    if (open && defaultPickerValue) {
+      if (defaultPickerValue[mergedActiveIndex]) {
+        setCurrentPickerValue(defaultPickerValue[mergedActiveIndex], 'reset');
+      }
+    }
+  }, [open, mergedActiveIndex]);
+  return [currentPickerValue, setCurrentPickerValue];
+}

package/es/PickerInput/hooks/useRangeValue.d.ts

@@ -0,0 +1,28 @@
+import type { GenerateConfig } from '../../generate';
+import type { BaseInfo, FormatType, Locale, ReplaceListType } from '../../interface';
+import type { RangePickerProps } from '../RangePicker';
+import type { ReplacedPickerProps } from '../SinglePicker';
+type TriggerCalendarChange<ValueType extends object[]> = (calendarValues: ValueType) => void;
+/**
+ * Control the internal `value` align with prop `value` and provide a temp `calendarValue` for ui.
+ * `calendarValue` will be reset when blur & focus & open.
+ */
+export declare function useInnerValue<ValueType extends DateType[], DateType extends object = any>(generateConfig: GenerateConfig<DateType>, locale: Locale, formatList: FormatType[], 
+/** Used for RangePicker. `true` means [DateType, DateType] or will be DateType[] */
+rangeValue: boolean, 
+/**
+ * Trigger order when trigger calendar value change.
+ * This should only used in SinglePicker with `multiple` mode.
+ * So when `rangeValue` is `true`, order will be ignored.
+ */
+order: boolean, defaultValue?: ValueType, value?: ValueType, onCalendarChange?: (dates: ValueType, dateStrings: ReplaceListType<Required<ValueType>, string>, info: BaseInfo) => void, onOk?: (dates: ValueType) => void): readonly [ValueType, (updater: ValueType | ((origin: ValueType) => ValueType), ignoreDestroy?: boolean) => void, (useControlledValueFirst?: boolean) => ValueType, TriggerCalendarChange<ValueType>, () => void];
+export default function useRangeValue<ValueType extends DateType[], DateType extends object = any>(info: Pick<RangePickerProps<DateType>, 'generateConfig' | 'locale' | 'allowEmpty' | 'order' | 'picker'> & ReplacedPickerProps<DateType>, mergedValue: ValueType, setInnerValue: (nextValue: ValueType) => void, getCalendarValue: () => ValueType, triggerCalendarChange: TriggerCalendarChange<ValueType>, disabled: ReplaceListType<Required<ValueType>, boolean>, formatList: FormatType[], focused: boolean, open: boolean, isInvalidateDate: (date: DateType, info?: {
+    from?: DateType;
+    activeIndex: number;
+}) => boolean): [
+    /** Trigger `onChange` by check `disabledDate` */
+    flushSubmit: (index: number, needTriggerChange: boolean) => void,
+    /** Trigger `onChange` directly without check `disabledDate` */
+    triggerSubmitChange: (value: ValueType) => boolean
+];
+export {};

package/es/PickerInput/hooks/useRangeValue.js

@@ -0,0 +1,297 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+import { useEvent, useMergedState } from '@rc-component/util';
+import * as React from 'react';
+import useSyncState from "../../hooks/useSyncState";
+import { formatValue, isSame, isSameTimestamp } from "../../utils/dateUtil";
+import { fillIndex } from "../../utils/miscUtil";
+import useLockEffect from "./useLockEffect";
+var EMPTY_VALUE = [];
+
+// Submit Logic:
+// * ✅ Value:
+//    * merged value using controlled value, if not, use stateValue
+//    * When merged value change, [1] resync calendar value and submit value
+// * ✅ Calender Value:
+//    * 💻 When user typing is validate, change the calendar value
+//    * 🌅 When user click on the panel, change the calendar value
+// * Submit Value:
+//    * 💻 When user blur the input, flush calendar value to submit value
+//    * 🌅 When user click on the panel is no needConfirm, flush calendar value to submit value
+//    * 🌅 When user click on the panel is needConfirm and click OK, flush calendar value to submit value
+// * Blur logic & close logic:
+//    * ✅ For value, always try flush submit
+//    * ✅ If `needConfirm`, reset as [1]
+//    * Else (`!needConfirm`)
+//      * If has another index field, active another index
+// * ✅ Flush submit:
+//    * If all the start & end field is confirmed or all blur or panel closed
+//    * Update `needSubmit` mark to true
+//    * trigger onChange by `needSubmit` and update stateValue
+
+function useUtil(generateConfig, locale, formatList) {
+  var getDateTexts = function getDateTexts(dates) {
+    return dates.map(function (date) {
+      return formatValue(date, {
+        generateConfig: generateConfig,
+        locale: locale,
+        format: formatList[0]
+      });
+    });
+  };
+  var isSameDates = function isSameDates(source, target) {
+    var maxLen = Math.max(source.length, target.length);
+    var diffIndex = -1;
+    for (var i = 0; i < maxLen; i += 1) {
+      var prev = source[i] || null;
+      var next = target[i] || null;
+      if (prev !== next && !isSameTimestamp(generateConfig, prev, next)) {
+        diffIndex = i;
+        break;
+      }
+    }
+    return [diffIndex < 0, diffIndex !== 0];
+  };
+  return [getDateTexts, isSameDates];
+}
+function orderDates(dates, generateConfig) {
+  return _toConsumableArray(dates).sort(function (a, b) {
+    return generateConfig.isAfter(a, b) ? 1 : -1;
+  });
+}
+
+/**
+ * Used for internal value management.
+ * It should always use `mergedValue` in render logic
+ */
+function useCalendarValue(mergedValue) {
+  var _useSyncState = useSyncState(mergedValue),
+    _useSyncState2 = _slicedToArray(_useSyncState, 2),
+    calendarValue = _useSyncState2[0],
+    setCalendarValue = _useSyncState2[1];
+
+  /** Sync calendarValue & submitValue back with value */
+  var syncWithValue = useEvent(function () {
+    setCalendarValue(mergedValue);
+  });
+  React.useEffect(function () {
+    syncWithValue();
+  }, [mergedValue]);
+  return [calendarValue, setCalendarValue];
+}
+
+/**
+ * Control the internal `value` align with prop `value` and provide a temp `calendarValue` for ui.
+ * `calendarValue` will be reset when blur & focus & open.
+ */
+export function useInnerValue(generateConfig, locale, formatList, /** Used for RangePicker. `true` means [DateType, DateType] or will be DateType[] */
+rangeValue,
+/**
+ * Trigger order when trigger calendar value change.
+ * This should only used in SinglePicker with `multiple` mode.
+ * So when `rangeValue` is `true`, order will be ignored.
+ */
+order, defaultValue, value, onCalendarChange, onOk) {
+  // This is the root value which will sync with controlled or uncontrolled value
+  var _useMergedState = useMergedState(defaultValue, {
+      value: value
+    }),
+    _useMergedState2 = _slicedToArray(_useMergedState, 2),
+    innerValue = _useMergedState2[0],
+    setInnerValue = _useMergedState2[1];
+  var mergedValue = innerValue || EMPTY_VALUE;
+
+  // ========================= Inner Values =========================
+  var _useCalendarValue = useCalendarValue(mergedValue),
+    _useCalendarValue2 = _slicedToArray(_useCalendarValue, 2),
+    calendarValue = _useCalendarValue2[0],
+    setCalendarValue = _useCalendarValue2[1];
+
+  // ============================ Change ============================
+  var _useUtil = useUtil(generateConfig, locale, formatList),
+    _useUtil2 = _slicedToArray(_useUtil, 2),
+    getDateTexts = _useUtil2[0],
+    isSameDates = _useUtil2[1];
+  var triggerCalendarChange = useEvent(function (nextCalendarValues) {
+    var clone = _toConsumableArray(nextCalendarValues);
+    if (rangeValue) {
+      for (var i = 0; i < 2; i += 1) {
+        clone[i] = clone[i] || null;
+      }
+    } else if (order) {
+      clone = orderDates(clone.filter(function (date) {
+        return date;
+      }), generateConfig);
+    }
+
+    // Update merged value
+    var _isSameDates = isSameDates(calendarValue(), clone),
+      _isSameDates2 = _slicedToArray(_isSameDates, 2),
+      isSameMergedDates = _isSameDates2[0],
+      isSameStart = _isSameDates2[1];
+    if (!isSameMergedDates) {
+      setCalendarValue(clone);
+
+      // Trigger calendar change event
+      if (onCalendarChange) {
+        var cellTexts = getDateTexts(clone);
+        onCalendarChange(clone, cellTexts, {
+          range: isSameStart ? 'end' : 'start'
+        });
+      }
+    }
+  });
+  var triggerOk = function triggerOk() {
+    if (onOk) {
+      onOk(calendarValue());
+    }
+  };
+  return [mergedValue, setInnerValue, calendarValue, triggerCalendarChange, triggerOk];
+}
+export default function useRangeValue(info, mergedValue, setInnerValue, getCalendarValue, triggerCalendarChange, disabled, formatList, focused, open, isInvalidateDate) {
+  var generateConfig = info.generateConfig,
+    locale = info.locale,
+    picker = info.picker,
+    onChange = info.onChange,
+    allowEmpty = info.allowEmpty,
+    order = info.order;
+  var orderOnChange = disabled.some(function (d) {
+    return d;
+  }) ? false : order;
+
+  // ============================= Util =============================
+  var _useUtil3 = useUtil(generateConfig, locale, formatList),
+    _useUtil4 = _slicedToArray(_useUtil3, 2),
+    getDateTexts = _useUtil4[0],
+    isSameDates = _useUtil4[1];
+
+  // ============================ Values ============================
+  // Used for trigger `onChange` event.
+  // Record current value which is wait for submit.
+  var _useSyncState3 = useSyncState(mergedValue),
+    _useSyncState4 = _slicedToArray(_useSyncState3, 2),
+    submitValue = _useSyncState4[0],
+    setSubmitValue = _useSyncState4[1];
+
+  /** Sync calendarValue & submitValue back with value */
+  var syncWithValue = useEvent(function () {
+    setSubmitValue(mergedValue);
+  });
+  React.useEffect(function () {
+    syncWithValue();
+  }, [mergedValue]);
+
+  // ============================ Submit ============================
+  var triggerSubmit = useEvent(function (nextValue) {
+    var isNullValue = nextValue === null;
+    var clone = _toConsumableArray(nextValue || submitValue());
+
+    // Fill null value
+    if (isNullValue) {
+      var maxLen = Math.max(disabled.length, clone.length);
+      for (var i = 0; i < maxLen; i += 1) {
+        if (!disabled[i]) {
+          clone[i] = null;
+        }
+      }
+    }
+
+    // Only when exist value to sort
+    if (orderOnChange && clone[0] && clone[1]) {
+      clone = orderDates(clone, generateConfig);
+    }
+
+    // Sync `calendarValue`
+    triggerCalendarChange(clone);
+
+    // ========= Validate check =========
+    var _clone = clone,
+      _clone2 = _slicedToArray(_clone, 2),
+      start = _clone2[0],
+      end = _clone2[1];
+
+    // >>> Empty
+    var startEmpty = !start;
+    var endEmpty = !end;
+    var validateEmptyDateRange = allowEmpty ?
+    // Validate empty start
+    (!startEmpty || allowEmpty[0]) && (
+    // Validate empty end
+    !endEmpty || allowEmpty[1]) : true;
+
+    // >>> Order
+    var validateOrder = !order || startEmpty || endEmpty || isSame(generateConfig, locale, start, end, picker) || generateConfig.isAfter(end, start);
+
+    // >>> Invalid
+    var validateDates =
+    // Validate start
+    (disabled[0] || !start || !isInvalidateDate(start, {
+      activeIndex: 0
+    })) && (
+    // Validate end
+    disabled[1] || !end || !isInvalidateDate(end, {
+      from: start,
+      activeIndex: 1
+    }));
+    // >>> Result
+    var allPassed =
+    // Null value is from clear button
+    isNullValue ||
+    // Normal check
+    validateEmptyDateRange && validateOrder && validateDates;
+    if (allPassed) {
+      // Sync value with submit value
+      setInnerValue(clone);
+      var _isSameDates3 = isSameDates(clone, mergedValue),
+        _isSameDates4 = _slicedToArray(_isSameDates3, 1),
+        isSameMergedDates = _isSameDates4[0];
+
+      // Trigger `onChange` if needed
+      if (onChange && !isSameMergedDates) {
+        onChange(
+        // Return null directly if all date are empty
+        isNullValue && clone.every(function (val) {
+          return !val;
+        }) ? null : clone, getDateTexts(clone));
+      }
+    }
+    return allPassed;
+  });
+
+  // ========================= Flush Submit =========================
+  var flushSubmit = useEvent(function (index, needTriggerChange) {
+    var nextSubmitValue = fillIndex(submitValue(), index, getCalendarValue()[index]);
+    setSubmitValue(nextSubmitValue);
+    if (needTriggerChange) {
+      triggerSubmit();
+    }
+  });
+
+  // ============================ Effect ============================
+  // All finished action trigger after 2 frames
+  var interactiveFinished = !focused && !open;
+  useLockEffect(!interactiveFinished, function () {
+    if (interactiveFinished) {
+      // Always try to trigger submit first
+      triggerSubmit();
+
+      // Trigger calendar change since this is a effect reset
+      // https://github.com/ant-design/ant-design/issues/22351
+      triggerCalendarChange(mergedValue);
+
+      // Sync with value anyway
+      syncWithValue();
+    }
+  }, 2);
+
+  // ============================ Return ============================
+  return [flushSubmit, triggerSubmit];
+}

package/es/PickerInput/hooks/useShowNow.d.ts

@@ -0,0 +1,2 @@
+import type { InternalMode, PanelMode } from '../../interface';
+export default function useShowNow(picker: InternalMode, mode: PanelMode, showNow?: boolean, showToday?: boolean, rangePicker?: boolean): boolean;

package/es/PickerInput/hooks/useShowNow.js

@@ -0,0 +1,14 @@
+export default function useShowNow(picker, mode, showNow, showToday, rangePicker) {
+  if (mode !== 'date' && mode !== 'time') {
+    return false;
+  }
+  if (showNow !== undefined) {
+    return showNow;
+  }
+
+  // Compatible with old version `showToday`
+  if (showToday !== undefined) {
+    return showToday;
+  }
+  return !rangePicker && (picker === 'date' || picker === 'time');
+}

package/es/PickerPanel/DatePanel/index.d.ts

@@ -0,0 +1,10 @@
+import * as React from 'react';
+import type { PanelMode, SharedPanelProps } from '../../interface';
+export interface DatePanelProps<DateType extends object> extends SharedPanelProps<DateType> {
+    panelName?: PanelMode;
+    rowClassName?: (date: DateType) => string;
+    /** Used for `WeekPanel` */
+    mode?: PanelMode;
+    cellSelection?: boolean;
+}
+export default function DatePanel<DateType extends object = any>(props: DatePanelProps<DateType>): React.JSX.Element;