rsuite 5.61.0 → 5.62.1

package/cjs/DOMHelper/index.js

@@ -1,7 +1,6 @@
 'use client';
 "use strict";
 
-var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard");
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 exports.__esModule = true;
 var _exportNames = {};
@@ -15,6 +14,8 @@ Object.keys(helpers).forEach(function (key) {
   exports[key] = helpers[key];
 });
 var _isElement = _interopRequireDefault(require("./isElement"));
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 /**
  * a wrapper of dom-lib with some custom methods.
  * @see https://rsuitejs.com/components/dom-helper/
@@ -22,5 +23,4 @@ var _isElement = _interopRequireDefault(require("./isElement"));
 var DOMHelper = (0, _extends2.default)({}, helpers, {
   isElement: _isElement.default
 });
-var _default = DOMHelper;
-exports.default = _default;
+var _default = exports.default = DOMHelper;

package/cjs/DOMHelper/isElement.js

@@ -6,5 +6,4 @@ exports.default = void 0;
 var isElement = function isElement(value) {
   return (value === null || value === void 0 ? void 0 : value.nodeType) === 1 && typeof (value === null || value === void 0 ? void 0 : value.nodeName) === 'string';
 };
-var _default = isElement;
-exports.default = _default;
+var _default = exports.default = isElement;

package/cjs/DateInput/DateField.js

@@ -3,14 +3,14 @@
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 exports.__esModule = true;
-exports.useDateField = exports.DateField = exports.patternMap = void 0;
+exports.useDateField = exports.patternMap = exports.DateField = void 0;
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 var _inheritsLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/inheritsLoose"));
 var _wrapNativeSuper2 = _interopRequireDefault(require("@babel/runtime/helpers/wrapNativeSuper"));
 var _react = require("react");
 var _isValid = _interopRequireDefault(require("date-fns/isValid"));
 var _utils = require("./utils");
-var patternMap = {
+var patternMap = exports.patternMap = {
   y: 'year',
   M: 'month',
   d: 'day',
@@ -20,9 +20,7 @@ var patternMap = {
   s: 'second',
   a: 'meridian'
 };
-exports.patternMap = patternMap;
-var DateField = /*#__PURE__*/function (_Object) {
-  (0, _inheritsLoose2.default)(DateField, _Object);
+var DateField = exports.DateField = /*#__PURE__*/function (_Object) {
   function DateField(format, value) {
     var _this;
     _this = _Object.call(this) || this;
@@ -52,12 +50,12 @@ var DateField = /*#__PURE__*/function (_Object) {
     }
     return _this;
   }
+  (0, _inheritsLoose2.default)(DateField, _Object);
   return DateField;
 }( /*#__PURE__*/(0, _wrapNativeSuper2.default)(Object));
 /**
  * Pad a number with zeros to the left.
  */
-exports.DateField = DateField;
 function padNumber(number, length) {
   var numberString = String(number);
   if (numberString.length >= length) {
@@ -69,7 +67,7 @@ function padNumber(number, length) {
   }
   return numberString;
 }
-var useDateField = function useDateField(format, localize, date) {
+var useDateField = exports.useDateField = function useDateField(format, localize, date) {
   var _useReducer = (0, _react.useReducer)(function (state, action) {
       switch (action.type) {
         case 'setYear':
@@ -203,5 +201,4 @@ var useDateField = function useDateField(format, localize, date) {
     toDateString: toDateString,
     isEmptyValue: isEmptyValue
   };
-};
-exports.useDateField = useDateField;
+};

package/cjs/DateInput/DateInput.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
 import { InputProps } from '../Input';
-import { FormControlBaseProps } from '../@types/common';
+import { FormControlBaseProps } from '../internals/types';
 export interface DateInputProps extends Omit<InputProps, 'value' | 'onChange' | 'defaultValue'>, FormControlBaseProps<Date | null> {
     /**
      * Format of the date when rendered in the input. Format of the string is based on Unicode Technical Standard.

package/cjs/DateInput/DateInput.js

@@ -1,7 +1,6 @@
 'use client';
 "use strict";
 
-var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard");
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 exports.__esModule = true;
 exports.default = void 0;
@@ -10,13 +9,17 @@ var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runt
 var _react = _interopRequireWildcard(require("react"));
 var _propTypes = _interopRequireDefault(require("prop-types"));
 var _Input = _interopRequireDefault(require("../Input"));
-var _utils = require("../utils");
+var _hooks = require("../internals/hooks");
+var _utils = require("../internals/utils");
 var _utils2 = require("./utils");
 var _useDateInputState2 = _interopRequireDefault(require("./hooks/useDateInputState"));
 var _useKeyboardInputEvent = _interopRequireDefault(require("./hooks/useKeyboardInputEvent"));
 var _useIsFocused2 = _interopRequireDefault(require("./hooks/useIsFocused"));
 var _useFieldCursor2 = _interopRequireDefault(require("./hooks/useFieldCursor"));
 var _useSelectedState2 = _interopRequireDefault(require("./hooks/useSelectedState"));
+var _excluded = ["format", "value", "defaultValue", "placeholder", "onChange", "onKeyDown", "onBlur", "onFocus"];
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 /**
  * The DateInput component lets users select a date with the keyboard.
  * @version 5.58.0
@@ -32,15 +35,15 @@ var DateInput = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
     onKeyDown = props.onKeyDown,
     onBlur = props.onBlur,
     onFocus = props.onFocus,
-    rest = (0, _objectWithoutPropertiesLoose2.default)(props, ["format", "value", "defaultValue", "placeholder", "onChange", "onKeyDown", "onBlur", "onFocus"]);
+    rest = (0, _objectWithoutPropertiesLoose2.default)(props, _excluded);
   var inputRef = (0, _react.useRef)();
   var _useSelectedState = (0, _useSelectedState2.default)(),
     selectedState = _useSelectedState.selectedState,
     setSelectedState = _useSelectedState.setSelectedState;
-  var _useCustom = (0, _utils.useCustom)('Calendar'),
+  var _useCustom = (0, _hooks.useCustom)('Calendar'),
     locale = _useCustom.locale;
   var dateLocale = locale.dateLocale;
-  var _useControlled = (0, _utils.useControlled)(valueProp, defaultValue),
+  var _useControlled = (0, _hooks.useControlled)(valueProp, defaultValue),
     value = _useControlled[0],
     setValue = _useControlled[1],
     isControlled = _useControlled[2];
@@ -69,12 +72,12 @@ var DateInput = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
       dateString: dateString
     };
   }, [dateField, dateString, formatStr, dateLocale]);
-  var handleChange = (0, _utils.useEventCallback)(function (value, event) {
+  var handleChange = (0, _hooks.useEventCallback)(function (value, event) {
     onChange === null || onChange === void 0 ? void 0 : onChange(value, event);
     setValue(value);
   });
   var setSelectionRange = (0, _utils2.useInputSelection)(inputRef);
-  var onSegmentChange = (0, _utils.useEventCallback)(function (event, nextDirection) {
+  var onSegmentChange = (0, _hooks.useEventCallback)(function (event, nextDirection) {
     var input = event.target;
     var key = event.key;
     var direction = nextDirection || (key === 'ArrowRight' ? 'right' : 'left');
@@ -86,7 +89,7 @@ var DateInput = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
     setSelectionRange(state.selectionStart, state.selectionEnd);
     reset();
   });
-  var onSegmentValueChange = (0, _utils.useEventCallback)(function (event) {
+  var onSegmentValueChange = (0, _hooks.useEventCallback)(function (event) {
     var input = event.target;
     var key = event.key;
     var offset = key === 'ArrowUp' ? 1 : -1;
@@ -100,7 +103,7 @@ var DateInput = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
     });
     setSelectionRange(state.selectionStart, state.selectionEnd);
   });
-  var onSegmentValueChangeWithNumericKeys = (0, _utils.useEventCallback)(function (event) {
+  var onSegmentValueChangeWithNumericKeys = (0, _hooks.useEventCallback)(function (event) {
     var input = event.target;
     var key = event.key;
     var pattern = selectedState.selectedPattern;
@@ -136,7 +139,7 @@ var DateInput = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
       onSegmentChange(event, 'right');
     }
   });
-  var onSegmentValueRemove = (0, _utils.useEventCallback)(function (event) {
+  var onSegmentValueRemove = (0, _hooks.useEventCallback)(function (event) {
     var input = event.target;
     if (selectedState.selectedPattern) {
       var nextState = (0, _utils2.getInputSelectedState)((0, _extends2.default)({}, keyPressOptions, {
@@ -151,7 +154,7 @@ var DateInput = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
       reset();
     }
   });
-  var handleClick = (0, _utils.useEventCallback)(function (event) {
+  var handleClick = (0, _hooks.useEventCallback)(function (event) {
     var input = event.target;
     var state = (0, _utils2.getInputSelectedState)((0, _extends2.default)({}, keyPressOptions, {
       input: input
@@ -201,5 +204,4 @@ DateInput.propTypes = {
   onBlur: _propTypes.default.func,
   onFocus: _propTypes.default.func
 };
-var _default = DateInput;
-exports.default = _default;
+var _default = exports.default = DateInput;

package/cjs/DateInput/hooks/useDateInputState.d.ts

@@ -1,4 +1,4 @@
-import { format } from '../../utils/dateUtils';
+import { format } from '../../internals/utils/date';
 import type { Locale } from 'date-fns';
 interface DateInputState {
     formatStr: string;

package/cjs/DateInput/hooks/useDateInputState.js

@@ -3,11 +3,11 @@
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 exports.__esModule = true;
-exports.useDateInputState = useDateInputState;
 exports.default = void 0;
+exports.useDateInputState = useDateInputState;
 var _react = require("react");
 var _startCase = _interopRequireDefault(require("lodash/startCase"));
-var _dateUtils = require("../../utils/dateUtils");
+var _date = require("../../internals/utils/date");
 var _DateField = require("../DateField");
 function useDateInputState(_ref) {
   var formatStr = _ref.formatStr,
@@ -33,34 +33,34 @@ function useDateInputState(_ref) {
     switch (pattern) {
       case 'y':
         actionName = 'setYear';
-        value = (0, _dateUtils.addYears)(new Date(year, 0), offset).getFullYear();
+        value = (0, _date.addYears)(new Date(year, 0), offset).getFullYear();
         break;
       case 'M':
         actionName = 'setMonth';
-        value = (0, _dateUtils.addMonths)(new Date(year, month), offset).getMonth() + 1;
+        value = (0, _date.addMonths)(new Date(year, month), offset).getMonth() + 1;
         break;
       case 'd':
         actionName = 'setDay';
         var prevDate = new Date(year, month, day);
-        value = (0, _dateUtils.addDays)(prevDate, offset).getDate();
+        value = (0, _date.addDays)(prevDate, offset).getDate();
         if (offset > 0) {
-          value = (0, _dateUtils.isLastDayOfMonth)(prevDate) ? 1 : value;
+          value = (0, _date.isLastDayOfMonth)(prevDate) ? 1 : value;
         } else {
-          value = prevDate.getDate() === 1 ? (0, _dateUtils.lastDayOfMonth)(prevDate).getDate() : value;
+          value = prevDate.getDate() === 1 ? (0, _date.lastDayOfMonth)(prevDate).getDate() : value;
         }
         break;
       case 'H':
       case 'h':
         actionName = 'setHour';
-        value = (0, _dateUtils.addHours)(new Date(year, month, day, hour), offset).getHours();
+        value = (0, _date.addHours)(new Date(year, month, day, hour), offset).getHours();
         break;
       case 'm':
         actionName = 'setMinute';
-        value = (0, _dateUtils.addMinutes)(new Date(year, month, day, hour, minute), offset).getMinutes();
+        value = (0, _date.addMinutes)(new Date(year, month, day, hour, minute), offset).getMinutes();
         break;
       case 's':
         actionName = 'setSecond';
-        value = (0, _dateUtils.addSeconds)(new Date(year, month, day, hour, minute, second), offset).getSeconds();
+        value = (0, _date.addSeconds)(new Date(year, month, day, hour, minute, second), offset).getSeconds();
         break;
       case 'a':
         actionName = 'setHour';
@@ -93,8 +93,8 @@ function useDateInputState(_ref) {
     };
   };
   var toControlledDateString = function toControlledDateString() {
-    if (date && (0, _dateUtils.isValid)(date)) {
-      return (0, _dateUtils.format)(date, formatStr, {
+    if (date && (0, _date.isValid)(date)) {
+      return (0, _date.format)(date, formatStr, {
         locale: locale
       });
     }
@@ -103,7 +103,7 @@ function useDateInputState(_ref) {
   };
   (0, _react.useEffect)(function () {
     if (isControlledDate) {
-      if (date && (0, _dateUtils.isValid)(date)) {
+      if (date && (0, _date.isValid)(date)) {
         dispatch({
           type: 'setNewDate',
           value: date
@@ -125,5 +125,4 @@ function useDateInputState(_ref) {
     isEmptyValue: isEmptyValue
   };
 }
-var _default = useDateInputState;
-exports.default = _default;
+var _default = exports.default = useDateInputState;

package/cjs/DateInput/hooks/useFieldCursor.js

@@ -1,13 +1,12 @@
 'use client';
 "use strict";
 
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 exports.__esModule = true;
-exports.useFieldCursor = useFieldCursor;
 exports.default = void 0;
+exports.useFieldCursor = useFieldCursor;
 var _react = require("react");
 var _utils = require("../utils");
-var _useUpdateEffect = _interopRequireDefault(require("../../utils/useUpdateEffect"));
+var _hooks = require("../../internals/hooks");
 function useFieldCursor(format, value) {
   var typeCount = (0, _react.useRef)(0);
   var increment = function increment() {
@@ -41,7 +40,7 @@ function useFieldCursor(format, value) {
         return false;
     }
   }, [format]);
-  (0, _useUpdateEffect.default)(function () {
+  (0, _hooks.useUpdateEffect)(function () {
     if (!value) {
       reset();
     }
@@ -52,5 +51,4 @@ function useFieldCursor(format, value) {
     isMoveCursor: isMoveCursor
   };
 }
-var _default = useFieldCursor;
-exports.default = _default;
+var _default = exports.default = useFieldCursor;

package/cjs/DateInput/hooks/useIsFocused.js

@@ -2,8 +2,8 @@
 "use strict";
 
 exports.__esModule = true;
-exports.useIsFocused = useIsFocused;
 exports.default = void 0;
+exports.useIsFocused = useIsFocused;
 var _react = require("react");
 function useIsFocused(_ref) {
   var onFocusProp = _ref.onFocus,
@@ -24,5 +24,4 @@ function useIsFocused(_ref) {
     onBlur: onBlur
   }];
 }
-var _default = useIsFocused;
-exports.default = _default;
+var _default = exports.default = useIsFocused;

package/cjs/DateInput/hooks/useKeyboardInputEvent.js

@@ -2,8 +2,8 @@
 "use strict";
 
 exports.__esModule = true;
-exports.useKeyboardInputEvent = useKeyboardInputEvent;
 exports.default = void 0;
+exports.useKeyboardInputEvent = useKeyboardInputEvent;
 function useKeyboardInputEvent(_ref) {
   var onSegmentChange = _ref.onSegmentChange,
     onSegmentValueChange = _ref.onSegmentValueChange,
@@ -40,5 +40,4 @@ function useKeyboardInputEvent(_ref) {
     onKeyDown === null || onKeyDown === void 0 ? void 0 : onKeyDown(event);
   };
 }
-var _default = useKeyboardInputEvent;
-exports.default = _default;
+var _default = exports.default = useKeyboardInputEvent;

package/cjs/DateInput/hooks/useSelectedState.js

@@ -2,8 +2,8 @@
 "use strict";
 
 exports.__esModule = true;
-exports.useSelectedState = useSelectedState;
 exports.default = void 0;
+exports.useSelectedState = useSelectedState;
 var _react = require("react");
 var defaultSelectedState = {
   selectedPattern: 'y',
@@ -19,5 +19,4 @@ function useSelectedState() {
     setSelectedState: setSelectedState
   };
 }
-var _default = useSelectedState;
-exports.default = _default;
+var _default = exports.default = useSelectedState;

package/cjs/DateInput/index.js

@@ -10,7 +10,7 @@ var _exportNames = {
   useSelectedState: true,
   useFieldCursor: true
 };
-exports.default = exports.useFieldCursor = exports.useSelectedState = exports.useIsFocused = exports.useKeyboardInputEvent = exports.useDateInputState = void 0;
+exports.useSelectedState = exports.useKeyboardInputEvent = exports.useIsFocused = exports.useFieldCursor = exports.useDateInputState = exports.default = void 0;
 var _DateInput = _interopRequireDefault(require("./DateInput"));
 var _useDateInputState = require("./hooks/useDateInputState");
 exports.useDateInputState = _useDateInputState.useDateInputState;
@@ -29,5 +29,4 @@ Object.keys(_utils).forEach(function (key) {
   if (key in exports && exports[key] === _utils[key]) return;
   exports[key] = _utils[key];
 });
-var _default = _DateInput.default;
-exports.default = _default;
+var _default = exports.default = _DateInput.default;

package/cjs/DateInput/utils.js

@@ -3,17 +3,17 @@
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 exports.__esModule = true;
+exports.getDatePattern = getDatePattern;
+exports.getInputSelectedState = getInputSelectedState;
 exports.getPatternGroups = getPatternGroups;
 exports.getSelectIndexGap = getSelectIndexGap;
-exports.getDatePattern = getDatePattern;
 exports.isCursorAfterMonth = isCursorAfterMonth;
-exports.getInputSelectedState = getInputSelectedState;
-exports.validateDateTime = validateDateTime;
 exports.modifyDate = modifyDate;
 exports.useInputSelection = useInputSelection;
+exports.validateDateTime = validateDateTime;
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
-var _dateUtils = require("../utils/dateUtils");
-var _utils = require("../utils");
+var _date = require("../internals/utils/date");
+var _utils = require("../internals/utils");
 function getPatternGroups(format, pattern) {
   var _format$match;
   return ((_format$match = format.match(new RegExp("(" + pattern + ")+"))) === null || _format$match === void 0 ? void 0 : _format$match[0]) || '';
@@ -207,23 +207,22 @@ function validateDateTime(type, value) {
       return false;
     // Invalid type
   }
-
   return true;
 }
 function modifyDate(date, type, value) {
   switch (type) {
     case 'year':
-      return (0, _dateUtils.setYear)(date, value);
+      return (0, _date.setYear)(date, value);
     case 'month':
-      return (0, _dateUtils.setMonth)(date, value - 1);
+      return (0, _date.setMonth)(date, value - 1);
     case 'day':
-      return (0, _dateUtils.setDate)(date, value);
+      return (0, _date.setDate)(date, value);
     case 'hour':
-      return (0, _dateUtils.setHours)(date, value);
+      return (0, _date.setHours)(date, value);
     case 'minute':
-      return (0, _dateUtils.setMinutes)(date, value);
+      return (0, _date.setMinutes)(date, value);
     case 'second':
-      return (0, _dateUtils.setSeconds)(date, value);
+      return (0, _date.setSeconds)(date, value);
   }
   return date;
 }

package/cjs/DatePicker/DatePicker.d.ts

@@ -1,18 +1,28 @@
 import React from 'react';
 import { RangeType } from './Toolbar';
 import { DatePickerLocale } from '../locales';
-import type { FormControlBaseProps, PickerBaseProps, RsRefForwardingComponent } from '../@types/common';
+import type { FormControlBaseProps, PickerBaseProps, RsRefForwardingComponent } from '../internals/types';
 import type { DeprecatedProps } from './types';
 export interface DatePickerProps extends PickerBaseProps<DatePickerLocale>, FormControlBaseProps<Date | null>, DeprecatedProps {
-    /** Custom caret component */
+    /**
+     * Custom caret component
+     */
     caretAs?: React.ElementType | null;
-    /** Calendar panel default presentation date and time */
+    /**
+     * Calendar panel default presentation date and time
+     */
     calendarDefaultDate?: Date;
-    /** Whether disabled the component */
+    /**
+     * Whether disabled the component
+     */
     disabled?: boolean;
-    /** Rendered as an input, the date can be entered via the keyboard */
+    /**
+     * Rendered as an input, the date can be entered via the keyboard
+     */
     editable?: boolean;
-    /** Format date */
+    /**
+     * Format date string
+     */
     format?: string;
     /**
      * ISO 8601 standard, each calendar week begins on Monday and Sunday on the seventh day
@@ -20,25 +30,52 @@ export interface DatePickerProps extends PickerBaseProps<DatePickerLocale>, Form
      * @see https://en.wikipedia.org/wiki/ISO_week_date
      */
     isoWeek?: boolean;
-    /** A label displayed at the beginning of toggle button */
+    /**
+     * The index of the first day of the week (0 - Sunday)
+     * If `isoWeek` is `true`, the value of `weekStart` is ignored.
+     *
+     * @default 0
+     */
+    weekStart?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    /**
+     * A label displayed at the beginning of toggle button
+     */
     label?: React.ReactNode;
-    /** Set the upper limit of the available year relative to the current selection date */
+    /**
+     * Set the upper limit of the available year relative to the current selection date
+     */
     limitEndYear?: number;
-    /** Set the lower limit of the available year relative to the current selection date */
+    /**
+     * Set the lower limit of the available year relative to the current selection date
+     */
     limitStartYear?: number;
-    /** Whether to display a loading state indicator */
+    /**
+     * Whether to display a loading state indicator
+     */
     loading?: boolean;
-    /** one tap to select */
+    /**
+     * One-click selection date
+     */
     oneTap?: boolean;
-    /** Whether plaintext the component */
+    /**
+     * Whether plaintext the component
+     */
     plaintext?: boolean;
-    /** Whether read only the component */
+    /**
+     * Whether read only the component
+     */
     readOnly?: boolean;
-    /** Predefined date Ranges */
+    /**
+     * Predefined date Ranges
+     */
     ranges?: RangeType<Date>[];
-    /** Whether to show week numbers */
+    /**
+     * Whether to show week numbers
+     */
     showWeekNumbers?: boolean;
-    /** Meridian format */
+    /**
+     * Meridian format for 12-hour time
+     */
     showMeridian?: boolean;
     /**
      * Whether a date on the calendar view should be disabled
@@ -47,40 +84,62 @@ export interface DatePickerProps extends PickerBaseProps<DatePickerLocale>, Form
      */
     shouldDisableDate?: (date: Date) => boolean;
     /**
-     * Disabled hours
+     * Disabled hours on the time view
      */
     shouldDisableHour?: (hour: number, date: Date) => boolean;
     /**
-     * Disabled minutes
+     * Disabled minutes on the time view
      */
     shouldDisableMinute?: (minute: number, date: Date) => boolean;
     /**
-     * Disabled seconds
+     * Disabled seconds on the time view
      */
     shouldDisableSecond?: (second: number, date: Date) => boolean;
-    /** Hidden hours */
+    /**
+     * Hidden hours on the time view
+     */
     hideHours?: (hour: number, date: Date) => boolean;
-    /** Hidden minutes */
+    /**
+     * Hidden minutes on the time view
+     */
     hideMinutes?: (minute: number, date: Date) => boolean;
-    /** Hidden seconds */
+    /**
+     * Hidden seconds on the time view
+     */
     hideSeconds?: (second: number, date: Date) => boolean;
-    /** Called when the calendar panel date changes */
+    /**
+     * Called when the calendar panel date changes
+     */
     onChangeCalendarDate?: (date: Date, event?: React.SyntheticEvent) => void;
-    /** Called when opening the month view */
+    /**
+     * Called when opening the month view
+     */
     onToggleMonthDropdown?: (toggle: boolean) => void;
-    /** Called when opening the time view */
+    /**
+     * Called when opening the time view
+     */
     onToggleTimeDropdown?: (toggle: boolean) => void;
-    /** Called when the option is selected */
+    /**
+     * Called when the option is selected
+     */
     onSelect?: (date: Date, event?: React.SyntheticEvent) => void;
     /** Called after the prev month */
     onPrevMonth?: (date: Date) => void;
-    /** Called after the next month */
+    /**
+     * Called after the next month
+     */
     onNextMonth?: (date: Date) => void;
-    /** Called after clicking the OK button */
+    /**
+     * Called after clicking the OK button
+     */
     onOk?: (date: Date, event: React.SyntheticEvent) => void;
-    /** Called after clicking the shortcut button */
+    /**
+     * Called after clicking the shortcut button
+     */
     onShortcutClick?: (range: RangeType<Date>, event: React.MouseEvent) => void;
-    /** Called when clean */
+    /**
+     * Called when clean
+     */
     onClean?: (event: React.MouseEvent) => void;
     /**
      * Custom rendering of the selected date.