rsuite 5.59.0 → 5.59.2

package/cjs/FormGroup/FormGroup.d.ts

@@ -1,4 +1,3 @@
-import React from 'react';
 import { WithAsProps, RsRefForwardingComponent } from '../@types/common';
 export interface FormGroupProps extends WithAsProps {
     /**
@@ -7,9 +6,24 @@ export interface FormGroupProps extends WithAsProps {
      */
     controlId?: string;
 }
-export declare const FormGroupContext: React.Context<{
-    controlId?: string | undefined;
-}>;
+export declare const useFormGroup: (controlId?: string) => {
+    /**
+     * The `id` of the `<Form.Control>` component.
+     */
+    controlId: string;
+    /**
+     * The `id` of the `<Form.HelpText>` component.
+     */
+    helpTextId: string;
+    /**
+     * The `id` of the `<Form.ControlLabel>` component.
+     */
+    labelId: string;
+    /**
+     * The `id` of the `<Form.ErrorMessage>` component.
+     */
+    errorMessageId: string;
+};
 /**
  * The `<Form.Group>` component is the easiest way to add some structure to forms.
  * @see https://rsuitejs.com/components/form/

package/cjs/FormGroup/FormGroup.js

@@ -4,19 +4,45 @@
 var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard");
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 exports.__esModule = true;
-exports.default = exports.FormGroupContext = void 0;
+exports.default = exports.useFormGroup = void 0;
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
 var _react = _interopRequireWildcard(require("react"));
 var _propTypes = _interopRequireDefault(require("prop-types"));
 var _utils = require("../utils");
 var FormGroupContext = /*#__PURE__*/_react.default.createContext({});
+var useFormGroup = function useFormGroup(controlId) {
+  var context = _react.default.useContext(FormGroupContext);
+  var fallbackId = (0, _utils.useUniqueId)('rs-');
+  var id = controlId || context.controlId || fallbackId;
+  var helpTextId = id + "-help-text";
+  var labelId = id + "-label";
+  var errorMessageId = id + "-error-message";
+  return {
+    /**
+     * The `id` of the `<Form.Control>` component.
+     */
+    controlId: id,
+    /**
+     * The `id` of the `<Form.HelpText>` component.
+     */
+    helpTextId: helpTextId,
+    /**
+     * The `id` of the `<Form.ControlLabel>` component.
+     */
+    labelId: labelId,
+    /**
+     * The `id` of the `<Form.ErrorMessage>` component.
+     */
+    errorMessageId: errorMessageId
+  };
+};
 
 /**
  * The `<Form.Group>` component is the easiest way to add some structure to forms.
  * @see https://rsuitejs.com/components/form/
  */
-exports.FormGroupContext = FormGroupContext;
+exports.useFormGroup = useFormGroup;
 var FormGroup = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
   var _props$as = props.as,
     Component = _props$as === void 0 ? 'div' : _props$as,

package/cjs/FormGroup/index.d.ts

@@ -1,3 +1,4 @@
 import FormGroup from './FormGroup';
 export type { FormGroupProps } from './FormGroup';
+export { useFormGroup } from './FormGroup';
 export default FormGroup;

package/cjs/FormGroup/index.js

@@ -1,9 +1,10 @@
 'use client';
 "use strict";
 
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard");
 exports.__esModule = true;
-exports.default = void 0;
-var _FormGroup = _interopRequireDefault(require("./FormGroup"));
+exports.default = exports.useFormGroup = void 0;
+var _FormGroup = _interopRequireWildcard(require("./FormGroup"));
+exports.useFormGroup = _FormGroup.useFormGroup;
 var _default = _FormGroup.default;
 exports.default = _default;

package/cjs/FormHelpText/FormHelpText.d.ts

@@ -1,5 +1,6 @@
+import React from 'react';
 import { WithAsProps, RsRefForwardingComponent } from '../@types/common';
-export interface FormHelpTextProps extends WithAsProps {
+export interface FormHelpTextProps extends WithAsProps, React.HTMLAttributes<HTMLSpanElement> {
     /** Whether to show through the Tooltip component */
     tooltip?: boolean;
 }

package/cjs/FormHelpText/FormHelpText.js

@@ -1,24 +1,25 @@
 '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;
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
-var _react = _interopRequireWildcard(require("react"));
+var _react = _interopRequireDefault(require("react"));
 var _propTypes = _interopRequireDefault(require("prop-types"));
 var _Tooltip = _interopRequireDefault(require("../Tooltip"));
 var _Whisper = _interopRequireDefault(require("../Whisper"));
 var _utils = require("../utils");
-var _FormGroup = require("../FormGroup/FormGroup");
+var _FormGroup = require("../FormGroup");
 var _HelpO = _interopRequireDefault(require("@rsuite/icons/legacy/HelpO"));
 /**
  * The `<Form.HelpText>` component is used to display help information in the form.
  * @see https://rsuitejs.com/components/form/
  */
 var FormHelpText = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
+  var _useFormGroup = (0, _FormGroup.useFormGroup)(),
+    helpTextId = _useFormGroup.helpTextId;
   var _props$as = props.as,
     Component = _props$as === void 0 ? 'span' : _props$as,
     _props$classPrefix = props.classPrefix,
@@ -26,9 +27,9 @@ var FormHelpText = /*#__PURE__*/_react.default.forwardRef(function (props, ref)
     className = props.className,
     tooltip = props.tooltip,
     children = props.children,
-    rest = (0, _objectWithoutPropertiesLoose2.default)(props, ["as", "classPrefix", "className", "tooltip", "children"]);
-  var _useContext = (0, _react.useContext)(_FormGroup.FormGroupContext),
-    controlId = _useContext.controlId;
+    _props$id = props.id,
+    id = _props$id === void 0 ? helpTextId : _props$id,
+    rest = (0, _objectWithoutPropertiesLoose2.default)(props, ["as", "classPrefix", "className", "tooltip", "children", "id"]);
   var _useClassNames = (0, _utils.useClassNames)(classPrefix),
     withClassPrefix = _useClassNames.withClassPrefix,
     merge = _useClassNames.merge;
@@ -39,13 +40,19 @@ var FormHelpText = /*#__PURE__*/_react.default.forwardRef(function (props, ref)
     return /*#__PURE__*/_react.default.createElement(_Whisper.default, {
       ref: ref,
       placement: "topEnd",
-      speaker: /*#__PURE__*/_react.default.createElement(_Tooltip.default, rest, children)
+      speaker: /*#__PURE__*/_react.default.createElement(_Tooltip.default, (0, _extends2.default)({
+        id: id
+      }, rest), children)
     }, /*#__PURE__*/_react.default.createElement(Component, {
+      role: "img",
+      "aria-label": "help",
       className: classes
-    }, /*#__PURE__*/_react.default.createElement(_HelpO.default, null)));
+    }, /*#__PURE__*/_react.default.createElement(_HelpO.default, {
+      "aria-hidden": true
+    })));
   }
   return /*#__PURE__*/_react.default.createElement(Component, (0, _extends2.default)({
-    id: controlId ? controlId + "-help-text" : null
+    id: id
   }, rest, {
     ref: ref,
     className: classes

package/cjs/Input/Input.js

@@ -9,7 +9,7 @@ var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends")
 var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
 var _react = _interopRequireWildcard(require("react"));
 var _propTypes = _interopRequireDefault(require("prop-types"));
-var _FormGroup = require("../FormGroup/FormGroup");
+var _FormGroup = require("../FormGroup");
 var _InputGroup = require("../InputGroup/InputGroup");
 var _Plaintext = _interopRequireDefault(require("../internals/Plaintext"));
 var _utils = require("../utils");
@@ -60,9 +60,8 @@ var Input = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
     plaintext: plaintext
   }));
   var inputGroupContext = (0, _react.useContext)(_InputGroup.InputGroupContext);
-  var formGroupContext = (0, _react.useContext)(_FormGroup.FormGroupContext);
-
-  // Make the Input component display in plain text,
+  var _useFormGroup = (0, _FormGroup.useFormGroup)(),
+    controlId = _useFormGroup.controlId; // Make the Input component display in plain text,
   // and display default characters when there is no value.
   if (plaintext) {
     return /*#__PURE__*/_react.default.createElement(_Plaintext.default, {
@@ -83,7 +82,7 @@ var Input = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
     ref: (0, _utils.mergeRefs)(ref, inputRef),
     className: classes,
     type: type,
-    id: id || (formGroupContext === null || formGroupContext === void 0 ? void 0 : formGroupContext.controlId),
+    id: id || controlId,
     value: value,
     defaultValue: defaultValue,
     disabled: disabled,

package/cjs/Placeholder/PlaceholderGraph.d.ts

@@ -1,8 +1,20 @@
 import { WithAsProps, RsRefForwardingComponent } from '../@types/common';
 export interface PlaceholderGraphProps extends WithAsProps {
+    /**
+     * The height of the graph.
+     *
+     * @default 200
+     */
     height?: number;
+    /**
+     * The width of the graph.
+     *
+     * @default 100%
+     */
     width?: number;
-    /** Placeholder status */
+    /**
+     * Placeholder status, display the loading state.
+     */
     active?: boolean;
 }
 /**

package/cjs/Placeholder/PlaceholderGrid.d.ts

@@ -1,10 +1,36 @@
 import { WithAsProps, RsRefForwardingComponent } from '../@types/common';
 export interface PlaceholderGridProps extends WithAsProps {
+    /**
+     * The number of rows.
+     *
+     * @default 5
+     */
     rows?: number;
+    /**
+     * The height of the row.
+     *
+     * @default 10
+     */
     rowHeight?: number;
+    /**
+     * @deprecated Use `rowSpacing` instead.
+     */
     rowMargin?: number;
+    /**
+     * The spacing between rows.
+     *
+     * @default 20
+     * @version 5.59.1
+     */
+    rowSpacing?: number;
+    /**
+     * The number of columns.
+     * @default 5
+     */
     columns?: number;
-    /** Placeholder status */
+    /**
+     * Placeholder status, display the loading state.
+     */
     active?: boolean;
 }
 /**

package/cjs/Placeholder/PlaceholderGrid.js

@@ -5,11 +5,13 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 exports.__esModule = true;
 exports.default = void 0;
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var _taggedTemplateLiteralLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/taggedTemplateLiteralLoose"));
 var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
 var _react = _interopRequireDefault(require("react"));
 var _propTypes = _interopRequireDefault(require("prop-types"));
 var _classnames = _interopRequireDefault(require("classnames"));
 var _utils = require("../utils");
+var _templateObject;
 /**
  * The `Placeholder.Grid` component is used to display the loading state of the block.
  * @see https://rsuitejs.com/components/placeholder
@@ -28,8 +30,10 @@ var PlaceholderGrid = /*#__PURE__*/_react.default.forwardRef(function (props, re
     rowHeight = _props$rowHeight === void 0 ? 10 : _props$rowHeight,
     _props$rowMargin = props.rowMargin,
     rowMargin = _props$rowMargin === void 0 ? 20 : _props$rowMargin,
+    _props$rowSpacing = props.rowSpacing,
+    rowSpacing = _props$rowSpacing === void 0 ? rowMargin : _props$rowSpacing,
     active = props.active,
-    rest = (0, _objectWithoutPropertiesLoose2.default)(props, ["as", "className", "classPrefix", "rows", "columns", "rowHeight", "rowMargin", "active"]);
+    rest = (0, _objectWithoutPropertiesLoose2.default)(props, ["as", "className", "classPrefix", "rows", "columns", "rowHeight", "rowMargin", "rowSpacing", "active"]);
   var _useClassNames = (0, _utils.useClassNames)(classPrefix),
     merge = _useClassNames.merge,
     prefix = _useClassNames.prefix,
@@ -38,23 +42,16 @@ var PlaceholderGrid = /*#__PURE__*/_react.default.forwardRef(function (props, re
     active: active
   }));
   var colItems = [];
-  var firstRowItemWidth = Math.random() * 30 + 30;
-  var itemWidth = firstRowItemWidth / 2;
   for (var i = 0; i < columns; i++) {
     var rowItems = [];
     for (var j = 0; j < rows; j++) {
-      var widthPercent = Math.random() * 50 + 10; // when first column
-      if (i > 0) {
-        // when other columns
-        widthPercent = j > 0 ? itemWidth : firstRowItemWidth;
-      }
-      rowItems.push( /*#__PURE__*/_react.default.createElement("p", {
+      rowItems.push( /*#__PURE__*/_react.default.createElement("div", {
         key: j,
         style: {
-          width: widthPercent + "%",
           height: rowHeight,
-          marginTop: j > 0 ? rowMargin : undefined
-        }
+          marginTop: j > 0 ? rowSpacing : undefined
+        },
+        className: prefix(_templateObject || (_templateObject = (0, _taggedTemplateLiteralLoose2.default)(["row"])))
       }));
     }
     colItems.push( /*#__PURE__*/_react.default.createElement("div", {
@@ -74,7 +71,7 @@ PlaceholderGrid.propTypes = {
   rows: _propTypes.default.number,
   columns: _propTypes.default.number,
   rowHeight: _propTypes.default.number,
-  rowMargin: _propTypes.default.number,
+  rowSpacing: _propTypes.default.number,
   active: _propTypes.default.bool
 };
 var _default = PlaceholderGrid;

package/cjs/Placeholder/PlaceholderParagraph.d.ts

@@ -1,10 +1,33 @@
 import { WithAsProps, RsRefForwardingComponent } from '../@types/common';
 export interface PlaceholderParagraphProps extends WithAsProps {
+    /**
+     * The number of rows.
+     * @default 2
+     */
     rows?: number;
+    /**
+     * The height of the row.
+     * @default 10
+     */
     rowHeight?: number;
+    /**
+     * @deprecated Use `rowSpacing` instead.
+     */
     rowMargin?: number;
+    /**
+     * The spacing between rows.
+     * @default 20
+     * @version 5.59.1
+     */
+    rowSpacing?: number;
+    /**
+     * The shape of the graph.
+     * @default false
+     */
     graph?: boolean | 'circle' | 'square' | 'image';
-    /** Placeholder status */
+    /**
+     * Placeholder status, display the loading state.
+     */
     active?: boolean;
 }
 /**

package/cjs/Placeholder/PlaceholderParagraph.js

@@ -1,16 +1,18 @@
 'use client';
 "use strict";
 
-var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard");
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard");
 exports.__esModule = true;
 exports.default = void 0;
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var _taggedTemplateLiteralLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/taggedTemplateLiteralLoose"));
 var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
 var _react = _interopRequireWildcard(require("react"));
 var _propTypes = _interopRequireDefault(require("prop-types"));
 var _utils = require("../utils");
 var _propTypes2 = require("../internals/propTypes");
+var _templateObject;
 /**
  * The `Placeholder.Paragraph` component is used to display the loading state of the block.
  * @see https://rsuitejs.com/components/placeholder
@@ -25,11 +27,13 @@ var PlaceholderParagraph = /*#__PURE__*/_react.default.forwardRef(function (prop
     rowHeight = _props$rowHeight === void 0 ? 10 : _props$rowHeight,
     _props$rowMargin = props.rowMargin,
     rowMargin = _props$rowMargin === void 0 ? 20 : _props$rowMargin,
+    _props$rowSpacing = props.rowSpacing,
+    rowSpacing = _props$rowSpacing === void 0 ? rowMargin : _props$rowSpacing,
     graph = props.graph,
     active = props.active,
     _props$classPrefix = props.classPrefix,
     classPrefix = _props$classPrefix === void 0 ? 'placeholder' : _props$classPrefix,
-    rest = (0, _objectWithoutPropertiesLoose2.default)(props, ["as", "className", "rows", "rowHeight", "rowMargin", "graph", "active", "classPrefix"]);
+    rest = (0, _objectWithoutPropertiesLoose2.default)(props, ["as", "className", "rows", "rowHeight", "rowMargin", "rowSpacing", "graph", "active", "classPrefix"]);
   var _useClassNames = (0, _utils.useClassNames)(classPrefix),
     merge = _useClassNames.merge,
     prefix = _useClassNames.prefix,
@@ -39,17 +43,17 @@ var PlaceholderParagraph = /*#__PURE__*/_react.default.forwardRef(function (prop
     var rowArr = [];
     for (var i = 0; i < rows; i++) {
       var styles = {
-        width: Math.random() * 75 + 25 + "%",
         height: rowHeight,
-        marginTop: i > 0 ? rowMargin : Number(rowMargin) / 2
+        marginTop: i > 0 ? rowSpacing : Number(rowSpacing) / 2
       };
-      rowArr.push( /*#__PURE__*/_react.default.createElement("p", {
+      rowArr.push( /*#__PURE__*/_react.default.createElement("div", {
         key: i,
-        style: styles
+        style: styles,
+        className: prefix(_templateObject || (_templateObject = (0, _taggedTemplateLiteralLoose2.default)(["row"])))
       }));
     }
     return rowArr;
-  }, [rowHeight, rowMargin, rows]);
+  }, [prefix, rowHeight, rowSpacing, rows]);
   var classes = merge(className, withClassPrefix('paragraph', {
     active: active
   }));
@@ -62,7 +66,7 @@ var PlaceholderParagraph = /*#__PURE__*/_react.default.forwardRef(function (prop
   }, /*#__PURE__*/_react.default.createElement("span", {
     className: prefix('paragraph-graph-inner')
   })), /*#__PURE__*/_react.default.createElement("div", {
-    className: prefix('paragraph-rows')
+    className: prefix('paragraph-group')
   }, rowElements));
 });
 PlaceholderParagraph.displayName = 'PlaceholderParagraph';
@@ -71,7 +75,7 @@ PlaceholderParagraph.propTypes = {
   classPrefix: _propTypes.default.string,
   rows: _propTypes.default.number,
   rowHeight: _propTypes.default.number,
-  rowMargin: _propTypes.default.number,
+  rowSpacing: _propTypes.default.number,
   graph: _propTypes.default.oneOfType([_propTypes.default.bool, (0, _propTypes2.oneOf)(['circle', 'square', 'image'])]),
   active: _propTypes.default.bool
 };

package/cjs/utils/dateUtils.d.ts

@@ -43,28 +43,84 @@ export { default as set } from 'date-fns/set';
 export { default as differenceInCalendarMonths } from 'date-fns/differenceInCalendarMonths';
 export { default as isLastDayOfMonth } from 'date-fns/isLastDayOfMonth';
 export { default as lastDayOfMonth } from 'date-fns/lastDayOfMonth';
-export declare type CalendarOnlyPropsType = 'disabledHours' | 'disabledMinutes' | 'disabledSeconds' | 'hideHours' | 'hideMinutes' | 'hideSeconds';
-export declare const calendarOnlyProps: CalendarOnlyPropsType[];
+declare enum TimeProp {
+    DisabledHours = "disabledHours",
+    DisabledMinutes = "disabledMinutes",
+    DisabledSeconds = "disabledSeconds",
+    ShouldDisableHour = "shouldDisableHour",
+    ShouldDisableMinute = "shouldDisableMinute",
+    ShouldDisableSecond = "shouldDisableSecond",
+    HideHours = "hideHours",
+    HideMinutes = "hideMinutes",
+    HideSeconds = "hideSeconds"
+}
+export declare type CalendarOnlyPropsType = TimeProp;
+export declare const calendarOnlyProps: readonly [TimeProp.DisabledHours, TimeProp.DisabledMinutes, TimeProp.DisabledSeconds, TimeProp.HideHours, TimeProp.HideMinutes, TimeProp.HideSeconds];
+interface CalendarProps {
+    [TimeProp.DisabledHours]?: (hours: number, date: Date) => boolean;
+    [TimeProp.DisabledMinutes]?: (minutes: number, date: Date) => boolean;
+    [TimeProp.DisabledSeconds]?: (seconds: number, date: Date) => boolean;
+    [TimeProp.HideHours]?: (hours: number, date: Date) => boolean;
+    [TimeProp.HideMinutes]?: (minutes: number, date: Date) => boolean;
+    [TimeProp.HideSeconds]?: (seconds: number, date: Date) => boolean;
+}
 /**
  * Verify that the time is valid.
  *
- * @param props
- * @param date
+ * @param props - The calendar props.
+ * @param date - The date to check.
+ * @returns Whether the time is disabled.
+ */
+export declare function disableTime(props: CalendarProps, date: Date): boolean;
+/**
+ * Omit the calendar-only props from an object.
+ *
+ * @param props - The object to omit props from.
+ * @returns The object with calendar-only props omitted.
+ */
+export declare const omitHideDisabledProps: <T extends Record<string, any>>(props: T) => Partial<Omit<T, TimeProp>>;
+/**
+ * Check if the time should be rendered based on the format.
+ *
+ * @param format - The format string.
+ * @returns Whether the time should be rendered.
  */
-export declare function disabledTime(props: any, date: Date): boolean;
-export declare const omitHideDisabledProps: <T extends Record<string, any>>(props: T) => Partial<Omit<T, CalendarOnlyPropsType>>;
 export declare const shouldRenderTime: (format: string) => boolean;
+/**
+ * Check if the month should be rendered based on the format.
+ *
+ * @param format - The format string.
+ * @returns Whether the month should be rendered.
+ */
 export declare const shouldRenderMonth: (format: string) => boolean;
+/**
+ * Check if the date should be rendered based on the format.
+ *
+ * @param format - The format string.
+ * @returns Whether the date should be rendered.
+ */
 export declare const shouldRenderDate: (format: string) => boolean;
+/**
+ * Check if only the time should be rendered based on the format.
+ *
+ * @param format - The format string.
+ * @returns Whether only the time should be rendered.
+ */
 export declare const shouldOnlyRenderTime: (format: string) => boolean;
 /**
- * Get all weeks of this month
- * @params monthDate
- * @return date[]
+ * Get all weeks of a month.
+ *
+ * @param monthDate - The date of the month.
+ * @param isoWeek - Whether to use ISO week numbering.
+ * @returns An array of weeks in the month.
  */
 export declare function getMonthView(monthDate: Date, isoWeek: boolean): Date[];
 /**
- * Copy the time of one date to another
+ * Copy the time from one date to another.
+ *
+ * @param from - The source date.
+ * @param to - The target date.
+ * @returns The target date with the time copied from the source date.
  */
 export declare function copyTime({ from, to }: {
     from: Date;
@@ -72,9 +128,15 @@ export declare function copyTime({ from, to }: {
 }): Date;
 /**
  * Swap two dates without swapping the time.
+ *
+ * @param dateRange - The date range to reverse.
+ * @returns The reversed date range.
  */
 export declare function reverseDateRangeOmitTime(dateRange: [Date, Date]): [Date, Date];
 /**
  * Get the time with AM and PM reversed.
+ *
+ * @param date - The date to reverse the time meridian.
+ * @returns The date with the time meridian reversed.
  */
 export declare const getReversedTimeMeridian: (date: Date) => Date;