rsuite 5.70.3 → 5.72.0

package/cjs/Calendar/TimeDropdown/utils/formatWithLeadingZero.js

@@ -0,0 +1,8 @@
+'use client';
+"use strict";
+
+exports.__esModule = true;
+exports.formatWithLeadingZero = void 0;
+var formatWithLeadingZero = exports.formatWithLeadingZero = function formatWithLeadingZero(number) {
+  return String(number).padStart(2, '0');
+};

package/cjs/Calendar/TimeDropdown/utils/getClockTime.d.ts

@@ -0,0 +1,11 @@
+export interface ClockTime {
+    hours?: number | null;
+    minutes?: number | null;
+    seconds?: number | null;
+    meridiem?: 'AM' | 'PM' | null;
+}
+export declare function getClockTime(props: {
+    date?: Date;
+    format?: string;
+    showMeridiem: boolean;
+}): ClockTime;

package/cjs/Calendar/TimeDropdown/utils/getClockTime.js

@@ -0,0 +1,43 @@
+'use client';
+"use strict";
+
+exports.__esModule = true;
+exports.getClockTime = getClockTime;
+var _date = require("../../../internals/utils/date");
+/**
+ * Convert the 24-hour clock to the 12-hour clock
+ * @param hours
+ */
+function getMeridiemHours(hours) {
+  return hours >= 12 ? hours - 12 : hours;
+}
+function getClockTime(props) {
+  var format = props.format,
+    date = props.date,
+    showMeridiem = props.showMeridiem;
+  var clockTime = {
+    hours: null,
+    minutes: null,
+    seconds: null,
+    meridiem: null
+  };
+  if (!format) {
+    return clockTime;
+  }
+
+  // If date is provided, extract hours and meridiem
+  if (/(H|h)/.test(format) && date) {
+    var hours = (0, _date.getHours)(date);
+    clockTime.hours = showMeridiem ? getMeridiemHours(hours) : hours;
+    clockTime.meridiem = hours >= 12 ? 'PM' : 'AM';
+  }
+  // Extract minutes if 'm' is present in format and date is provided
+  if (/m/.test(format) && date) {
+    clockTime.minutes = (0, _date.getMinutes)(date);
+  }
+  // // Extract seconds if 's' is present in format and date is provided
+  if (/s/.test(format) && date) {
+    clockTime.seconds = (0, _date.getSeconds)(date);
+  }
+  return clockTime;
+}

package/cjs/Calendar/TimeDropdown/utils/getTimeLimits.d.ts

@@ -0,0 +1,11 @@
+interface TimeRange {
+    start: number;
+    end: number;
+}
+interface TimeLimits {
+    hours: TimeRange;
+    minutes: TimeRange;
+    seconds: TimeRange;
+}
+export declare function getTimeLimits(isMeridiem: boolean): TimeLimits;
+export {};

package/cjs/Calendar/TimeDropdown/utils/getTimeLimits.js

@@ -0,0 +1,24 @@
+'use client';
+"use strict";
+
+exports.__esModule = true;
+exports.getTimeLimits = getTimeLimits;
+function getTimeLimits(isMeridiem) {
+  var HOURS_24H = {
+    start: 0,
+    end: 23
+  };
+  var HOURS_12H = {
+    start: 0,
+    end: 11
+  };
+  var MINUTES_SECONDS = {
+    start: 0,
+    end: 59
+  };
+  return {
+    hours: isMeridiem ? HOURS_12H : HOURS_24H,
+    minutes: MINUTES_SECONDS,
+    seconds: MINUTES_SECONDS
+  };
+}

package/cjs/Calendar/TimeDropdown/utils/index.d.ts

@@ -0,0 +1,4 @@
+export { getTimeLimits } from './getTimeLimits';
+export { formatWithLeadingZero } from './formatWithLeadingZero';
+export { scrollToTime } from './scrollToTime';
+export * from './getClockTime';

package/cjs/Calendar/TimeDropdown/utils/index.js

@@ -0,0 +1,23 @@
+'use client';
+"use strict";
+
+exports.__esModule = true;
+var _exportNames = {
+  getTimeLimits: true,
+  formatWithLeadingZero: true,
+  scrollToTime: true
+};
+exports.scrollToTime = exports.getTimeLimits = exports.formatWithLeadingZero = void 0;
+var _getTimeLimits = require("./getTimeLimits");
+exports.getTimeLimits = _getTimeLimits.getTimeLimits;
+var _formatWithLeadingZero = require("./formatWithLeadingZero");
+exports.formatWithLeadingZero = _formatWithLeadingZero.formatWithLeadingZero;
+var _scrollToTime = require("./scrollToTime");
+exports.scrollToTime = _scrollToTime.scrollToTime;
+var _getClockTime = require("./getClockTime");
+Object.keys(_getClockTime).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _getClockTime[key]) return;
+  exports[key] = _getClockTime[key];
+});

package/cjs/Calendar/TimeDropdown/utils/scrollToTime.d.ts

@@ -0,0 +1,2 @@
+import type { ClockTime } from './getClockTime';
+export declare function scrollToTime(time: ClockTime, row: HTMLDivElement | null): void;

package/cjs/Calendar/TimeDropdown/utils/scrollToTime.js

@@ -0,0 +1,28 @@
+'use client';
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+exports.__esModule = true;
+exports.scrollToTime = scrollToTime;
+var _getPosition = _interopRequireDefault(require("dom-lib/getPosition"));
+var _scrollTop = _interopRequireDefault(require("dom-lib/scrollTop"));
+function scrollToTime(time, row) {
+  if (!row) return;
+  var scrollToPosition = function scrollToPosition(container, value, type) {
+    var node = container.querySelector("[data-key=\"" + type + "-" + value + "\"]");
+    if (node) {
+      var position = (0, _getPosition.default)(node, container);
+      if (position) {
+        (0, _scrollTop.default)(container, position.top);
+      }
+    }
+  };
+  Object.entries(time).forEach(function (_ref) {
+    var type = _ref[0],
+      value = _ref[1];
+    var container = row.querySelector("[data-type=\"" + type + "\"]");
+    if (container) {
+      scrollToPosition(container, value, type);
+    }
+  });
+}

package/cjs/Calendar/hooks/index.d.ts

@@ -0,0 +1,3 @@
+export * from './useCalendarState';
+export * from './useCalendarDate';
+export { useCalendar } from './useCalendar';

package/cjs/Calendar/hooks/index.js

@@ -0,0 +1,24 @@
+'use client';
+"use strict";
+
+exports.__esModule = true;
+var _exportNames = {
+  useCalendar: true
+};
+exports.useCalendar = void 0;
+var _useCalendarState = require("./useCalendarState");
+Object.keys(_useCalendarState).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _useCalendarState[key]) return;
+  exports[key] = _useCalendarState[key];
+});
+var _useCalendarDate = require("./useCalendarDate");
+Object.keys(_useCalendarDate).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _useCalendarDate[key]) return;
+  exports[key] = _useCalendarDate[key];
+});
+var _useCalendar = require("./useCalendar");
+exports.useCalendar = _useCalendar.useCalendar;

package/cjs/Calendar/hooks/useCalendar.d.ts

@@ -0,0 +1,2 @@
+import { CalendarContextValue } from '../CalendarProvider';
+export declare const useCalendar: () => CalendarContextValue;

package/cjs/Calendar/hooks/useCalendar.js

@@ -0,0 +1,10 @@
+'use client';
+"use strict";
+
+exports.__esModule = true;
+exports.useCalendar = void 0;
+var _react = require("react");
+var _CalendarProvider = require("../CalendarProvider");
+var useCalendar = exports.useCalendar = function useCalendar() {
+  return (0, _react.useContext)(_CalendarProvider.CalendarContext);
+};

package/cjs/Calendar/{useCalendarDate.d.ts → hooks/useCalendarDate.d.ts}

@@ -1,6 +1,5 @@
-declare const useCalendarDate: (value: Date | null | undefined, defaultDate: Date | undefined) => {
+export declare const useCalendarDate: (value: Date | null | undefined, defaultDate: Date | undefined) => {
     calendarDate: Date;
     setCalendarDate: (date: React.SetStateAction<Date> | undefined) => void;
     resetCalendarDate: (nextValue?: any) => void;
 };
-export default useCalendarDate;

package/cjs/Calendar/{useCalendarDate.js → hooks/useCalendarDate.js}

@@ -2,13 +2,14 @@
 "use strict";
 
 exports.__esModule = true;
-exports.default = void 0;
+exports.useCalendarDate = void 0;
 var _react = require("react");
-var _hooks = require("../internals/hooks");
-var useCalendarDate = function useCalendarDate(value, defaultDate) {
+var _hooks = require("../../internals/hooks");
+var _date = require("../../internals/utils/date");
+var useCalendarDate = exports.useCalendarDate = function useCalendarDate(value, defaultDate) {
   var _ref;
   var valueRef = (0, _react.useRef)(value);
-  var _useState = (0, _react.useState)((_ref = value !== null && value !== void 0 ? value : defaultDate) !== null && _ref !== void 0 ? _ref : new Date()),
+  var _useState = (0, _react.useState)((_ref = value !== null && value !== void 0 ? value : defaultDate) !== null && _ref !== void 0 ? _ref : (0, _date.startOfToday)()),
     calendarDate = _useState[0],
     setValue = _useState[1];
   var setCalendarDate = (0, _react.useCallback)(function (date) {
@@ -21,13 +22,13 @@ var useCalendarDate = function useCalendarDate(value, defaultDate) {
     if (nextValue === void 0) {
       nextValue = value;
     }
-    setValue((_ref2 = (_nextValue = nextValue) !== null && _nextValue !== void 0 ? _nextValue : defaultDate) !== null && _ref2 !== void 0 ? _ref2 : new Date());
+    setValue((_ref2 = (_nextValue = nextValue) !== null && _nextValue !== void 0 ? _nextValue : defaultDate) !== null && _ref2 !== void 0 ? _ref2 : (0, _date.startOfToday)());
   }, [defaultDate, value]);
   (0, _hooks.useUpdateEffect)(function () {
     var _valueRef$current;
     if ((value === null || value === void 0 ? void 0 : value.valueOf()) !== ((_valueRef$current = valueRef.current) === null || _valueRef$current === void 0 ? void 0 : _valueRef$current.valueOf())) {
       var _ref3;
-      setCalendarDate((_ref3 = value !== null && value !== void 0 ? value : defaultDate) !== null && _ref3 !== void 0 ? _ref3 : new Date());
+      setCalendarDate((_ref3 = value !== null && value !== void 0 ? value : defaultDate) !== null && _ref3 !== void 0 ? _ref3 : (0, _date.startOfToday)());
       valueRef.current = value;
     }
   }, [value, defaultDate]);
@@ -36,5 +37,4 @@ var useCalendarDate = function useCalendarDate(value, defaultDate) {
     setCalendarDate: setCalendarDate,
     resetCalendarDate: resetCalendarDate
   };
-};
-var _default = exports.default = useCalendarDate;
+};

package/cjs/Calendar/hooks/useCalendarState.d.ts

@@ -0,0 +1,22 @@
+export declare enum CalendarState {
+    'TIME' = "TIME",
+    'MONTH' = "MONTH"
+}
+export interface CalendarStateProps {
+    defaultState?: CalendarState;
+    calendarDate: Date;
+    onMoveForward?: (date: Date) => void;
+    onMoveBackward?: (date: Date) => void;
+    onToggleTimeDropdown?: (toggle: boolean) => void;
+    onToggleMonthDropdown?: (toggle: boolean) => void;
+}
+export declare const useCalendarState: (props: CalendarStateProps) => {
+    calendarState: CalendarState | undefined;
+    handlers: {
+        onMoveForward: (...args: any[]) => any;
+        onMoveBackward: (...args: any[]) => any;
+        onToggleTimeDropdown: (...args: any[]) => any;
+        onToggleMonthDropdown: (...args: any[]) => any;
+    };
+    reset: () => void;
+};

package/cjs/Calendar/hooks/useCalendarState.js

@@ -0,0 +1,60 @@
+'use client';
+"use strict";
+
+exports.__esModule = true;
+exports.useCalendarState = exports.CalendarState = void 0;
+var _react = require("react");
+var _date = require("../../internals/utils/date");
+var _hooks = require("../../internals/hooks");
+var CalendarState = exports.CalendarState = /*#__PURE__*/function (CalendarState) {
+  CalendarState["TIME"] = "TIME";
+  CalendarState["MONTH"] = "MONTH";
+  return CalendarState;
+}({});
+var useCalendarState = exports.useCalendarState = function useCalendarState(props) {
+  var _useState = (0, _react.useState)(props.defaultState),
+    calendarState = _useState[0],
+    setCalendarState = _useState[1];
+  var reset = (0, _react.useCallback)(function () {
+    setCalendarState(undefined);
+  }, []);
+  var onMoveForward = (0, _hooks.useEventCallback)(function () {
+    var _props$onMoveForward;
+    (_props$onMoveForward = props.onMoveForward) === null || _props$onMoveForward === void 0 ? void 0 : _props$onMoveForward.call(props, (0, _date.addMonths)(props.calendarDate, 1));
+  });
+  var onMoveBackward = (0, _hooks.useEventCallback)(function () {
+    var _props$onMoveBackward;
+    (_props$onMoveBackward = props.onMoveBackward) === null || _props$onMoveBackward === void 0 ? void 0 : _props$onMoveBackward.call(props, (0, _date.addMonths)(props.calendarDate, -1));
+  });
+  var onToggleTimeDropdown = (0, _hooks.useEventCallback)(function () {
+    var _props$onToggleTimeDr;
+    if (calendarState === CalendarState.TIME) {
+      reset();
+    } else {
+      setCalendarState(CalendarState.TIME);
+    }
+    (_props$onToggleTimeDr = props.onToggleTimeDropdown) === null || _props$onToggleTimeDr === void 0 ? void 0 : _props$onToggleTimeDr.call(props, calendarState !== CalendarState.TIME);
+  });
+  var onToggleMonthDropdown = (0, _hooks.useEventCallback)(function () {
+    var _props$onToggleMonthD;
+    if (calendarState === CalendarState.MONTH) {
+      reset();
+    } else {
+      setCalendarState(CalendarState.MONTH);
+    }
+    (_props$onToggleMonthD = props.onToggleMonthDropdown) === null || _props$onToggleMonthD === void 0 ? void 0 : _props$onToggleMonthD.call(props, calendarState !== CalendarState.MONTH);
+  });
+  var handlers = (0, _react.useMemo)(function () {
+    return {
+      onMoveForward: onMoveForward,
+      onMoveBackward: onMoveBackward,
+      onToggleTimeDropdown: onToggleTimeDropdown,
+      onToggleMonthDropdown: onToggleMonthDropdown
+    };
+  }, [onMoveBackward, onMoveForward, onToggleMonthDropdown, onToggleTimeDropdown]);
+  return {
+    calendarState: calendarState,
+    handlers: handlers,
+    reset: reset
+  };
+};

package/cjs/Calendar/index.d.ts

@@ -1,8 +1,6 @@
 import Calendar from './Calendar';
 import CalendarContainer from './CalendarContainer';
-import { CalendarState } from './useCalendarState';
-import CalendarContext, { CalendarContextValue } from './CalendarContext';
-export { CalendarContainer, CalendarContext, CalendarState };
-export type { CalendarContextValue };
+import { CalendarState } from './hooks';
+export { CalendarContainer, CalendarState };
 export type { CalendarProps } from './Calendar';
 export default Calendar;

package/cjs/Calendar/index.js

@@ -7,8 +7,6 @@ exports.default = void 0;
 var _Calendar = _interopRequireDefault(require("./Calendar"));
 var _CalendarContainer = _interopRequireDefault(require("./CalendarContainer"));
 exports.CalendarContainer = _CalendarContainer.default;
-var _useCalendarState = require("./useCalendarState");
-exports.CalendarState = _useCalendarState.CalendarState;
-var _CalendarContext = _interopRequireDefault(require("./CalendarContext"));
-exports.CalendarContext = _CalendarContext.default;
+var _hooks = require("./hooks");
+exports.CalendarState = _hooks.CalendarState;
 var _default = exports.default = _Calendar.default;

package/cjs/Calendar/types.d.ts

@@ -0,0 +1,19 @@
+/// <reference types="react" />
+import type { FixedSizeListProps } from '../internals/Windowing';
+/**
+ * Props for the MonthDropdown component.
+ */
+export interface MonthDropdownProps extends Partial<FixedSizeListProps> {
+    /**
+     * The HTML element or React component to render as the root element of the MonthDropdown.
+     */
+    as?: React.ElementType;
+    /**
+     * The HTML element or React component to render as each item in the MonthDropdown.
+     */
+    itemAs?: React.ElementType;
+    /**
+     * The CSS class name to apply to each item in the MonthDropdown.
+     */
+    itemClassName?: string;
+}

package/cjs/Calendar/types.js

@@ -0,0 +1,4 @@
+'use client';
+"use strict";
+
+exports.__esModule = true;

package/cjs/Calendar/{utils.js → utils/getAriaLabel.js}

@@ -3,7 +3,7 @@
 
 exports.__esModule = true;
 exports.getAriaLabel = getAriaLabel;
-var _date = require("../internals/utils/date");
+var _date = require("../../internals/utils/date");
 /**
  * Get aria-label for the date.
  * @param date - The date.

package/cjs/Calendar/utils/index.d.ts

@@ -0,0 +1 @@
+export { getAriaLabel } from './getAriaLabel';

package/cjs/Calendar/utils/index.js

@@ -0,0 +1,7 @@
+'use client';
+"use strict";
+
+exports.__esModule = true;
+exports.getAriaLabel = void 0;
+var _getAriaLabel = require("./getAriaLabel");
+exports.getAriaLabel = _getAriaLabel.getAriaLabel;

package/cjs/CustomProvider/CustomProvider.d.ts

@@ -112,6 +112,7 @@ export interface CustomProviderProps<T = Locale> extends Partial<CustomValue<T>>
     toastContainer?: HTMLElement | (() => HTMLElement | null) | null;
 }
 declare const CustomContext: React.Context<CustomProviderProps<{
+    code?: string | undefined;
     common?: {
         loading: string;
         emptyMessage: string;
@@ -144,11 +145,16 @@ declare const CustomContext: React.Context<CustomProviderProps<{
         ok: string;
         today: string;
         yesterday: string;
+        now: string;
         hours: string;
         minutes: string;
         seconds: string;
-        formattedMonthPattern: string;
+        formattedMonthPattern: string; /**
+         * The locale object that contains the language and formatting rules for the date.
+         */
         formattedDayPattern: string;
+        shortDateFormat: string;
+        shortTimeFormat: string;
         dateLocale: any;
     } | undefined;
     DatePicker?: {
@@ -162,11 +168,16 @@ declare const CustomContext: React.Context<CustomProviderProps<{
         ok: string;
         today: string;
         yesterday: string;
+        now: string;
         hours: string;
         minutes: string;
         seconds: string;
-        formattedMonthPattern: string;
+        formattedMonthPattern: string; /**
+         * The locale object that contains the language and formatting rules for the date.
+         */
         formattedDayPattern: string;
+        shortDateFormat: string;
+        shortTimeFormat: string;
         dateLocale: any;
     } | undefined;
     DateRangePicker?: {
@@ -181,11 +192,16 @@ declare const CustomContext: React.Context<CustomProviderProps<{
         ok: string;
         today: string;
         yesterday: string;
+        now: string;
         hours: string;
         minutes: string;
         seconds: string;
-        formattedMonthPattern: string;
+        formattedMonthPattern: string; /**
+         * The locale object that contains the language and formatting rules for the date.
+         */
         formattedDayPattern: string;
+        shortDateFormat: string;
+        shortTimeFormat: string;
         dateLocale: any;
     } | undefined;
     Picker?: {

package/cjs/DateInput/DateField.js

@@ -18,7 +18,7 @@ var patternMap = exports.patternMap = {
   h: 'hour',
   m: 'minute',
   s: 'second',
-  a: 'meridian'
+  a: 'meridiem'
 };
 var DateField = exports.DateField = /*#__PURE__*/function (_Object) {
   function DateField(format, value) {
@@ -187,7 +187,7 @@ var useDateField = exports.useDateField = function useDateField(format, localize
       // Invalid Date. If the type is day and the value is 0, it is considered an invalid date.
       return new Date('');
     }
-    if (type === 'meridian' && typeof hour === 'number') {
+    if (type === 'meridiem' && typeof hour === 'number') {
       var newHour = hour > 12 ? hour - 12 : hour + 12;
       type = 'hour';
       value = newHour;

package/cjs/DateInput/DateInput.js

@@ -27,8 +27,11 @@ function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e;
  * @see https://rsuitejs.com/components/date-input/
  */
 var DateInput = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
+  var _useCustom = (0, _hooks.useCustom)('Calendar'),
+    locale = _useCustom.locale,
+    parseDate = _useCustom.parseDate;
   var _props$format = props.format,
-    formatStr = _props$format === void 0 ? 'yyyy-MM-dd' : _props$format,
+    formatStr = _props$format === void 0 ? locale.shortDateFormat : _props$format,
     valueProp = props.value,
     defaultValue = props.defaultValue,
     placeholder = props.placeholder,
@@ -42,9 +45,6 @@ var DateInput = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
   var _useSelectedState = (0, _useSelectedState2.default)(),
     selectedState = _useSelectedState.selectedState,
     setSelectedState = _useSelectedState.setSelectedState;
-  var _useCustom = (0, _hooks.useCustom)('Calendar'),
-    locale = _useCustom.locale,
-    parseDate = _useCustom.parseDate;
   var dateLocale = locale.dateLocale;
   var _useControlled = (0, _hooks.useControlled)(valueProp, defaultValue),
     value = _useControlled[0],
@@ -77,11 +77,17 @@ var DateInput = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
       dateString: dateString
     };
   }, [dateField, dateString, formatStr, dateLocale]);
+  var setSelectionRange = (0, _utils2.useInputSelection)(inputRef);
   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 handleClear = (0, _hooks.useEventCallback)(function (event) {
+    handleChange(null, event);
+    setNewDate(null);
+    setSelectionRange(0, 0);
+    reset();
+  });
   var onSegmentChange = (0, _hooks.useEventCallback)(function (event, nextDirection) {
     var input = event.target;
     var key = event.key;
@@ -149,7 +155,12 @@ var DateInput = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
   });
   var onSegmentValueRemove = (0, _hooks.useEventCallback)(function (event) {
     var input = event.target;
-    if (selectedState.selectedPattern) {
+    var value = input.value;
+
+    // If the text is all selected, clear the value
+    if (input.selectionStart === 0 && value && input.selectionEnd === value.length) {
+      handleClear(event);
+    } else if (selectedState.selectedPattern) {
       var nextState = (0, _utils2.getInputSelectedState)((0, _extends2.default)({}, keyPressOptions, {
         input: input,
         valueOffset: null

package/cjs/DateInput/hooks/useDateInputState.js

@@ -70,7 +70,7 @@ function useDateInputState(_ref) {
         value = hour >= 12 ? hour - 12 : hour + 12;
         break;
     }
-    if (actionName && value) {
+    if (actionName && typeof value === 'number') {
       dispatch({
         type: actionName,
         value: value

package/cjs/DatePicker/DatePicker.d.ts

@@ -3,7 +3,7 @@ import { RangeType } from './Toolbar';
 import type { FormControlBaseProps, PickerBaseProps, RsRefForwardingComponent } from '../internals/types';
 import type { DatePickerLocale } from '../locales';
 import type { DeprecatedProps } from './types';
-import type { MonthDropdownProps } from '../Calendar/CalendarContext';
+import type { MonthDropdownProps } from '../Calendar/types';
 export interface DatePickerProps extends PickerBaseProps<DatePickerLocale>, FormControlBaseProps<Date | null>, DeprecatedProps {
     /**
      * Custom caret component
@@ -75,9 +75,13 @@ export interface DatePickerProps extends PickerBaseProps<DatePickerLocale>, Form
      */
     showWeekNumbers?: boolean;
     /**
-     * Meridian format for 12-hour time
+     * @deprecated Use `showMeridiem` instead
      */
     showMeridian?: boolean;
+    /**
+     * Meridiem format for 12-hour time
+     */
+    showMeridiem?: boolean;
     /**
      * The props for the Month Dropdown component.
      */
@@ -101,15 +105,15 @@ export interface DatePickerProps extends PickerBaseProps<DatePickerLocale>, Form
      */
     shouldDisableSecond?: (second: number, date: Date) => boolean;
     /**
-     * Hidden hours on the time view
+     * Hide specific hour options
      */
     hideHours?: (hour: number, date: Date) => boolean;
     /**
-     * Hidden minutes on the time view
+     * Hide specific minute options
      */
     hideMinutes?: (minute: number, date: Date) => boolean;
     /**
-     * Hidden seconds on the time view
+     * Hide specific second options
      */
     hideSeconds?: (second: number, date: Date) => boolean;
     /**