rsuite 5.61.0 → 5.62.0

package/cjs/internals/utils/ReactChildren.d.ts

@@ -0,0 +1,65 @@
+import React from 'react';
+/**
+ * Finds the first child that satisfies the given condition.
+ * @param children - The children to search.
+ * @param func - The condition function.
+ * @param context - The context to use for the condition function.
+ * @returns The first child that satisfies the condition, or undefined if no child is found.
+ */
+export declare function find(children: React.ReactNode, func: any, context?: any): React.ReactNode;
+/**
+ * Maps over the children and applies the given function to each child.
+ * @param children - The children to map over.
+ * @param func - The function to apply to each child.
+ * @param context - The context to use for the function.
+ * @returns An array of the results of applying the function to each child.
+ */
+export declare function map(children: React.ReactNode, func: any, context?: any): any[];
+/**
+ * Maps over the children and clones each child element with the provided props.
+ * @param children - The children to clone and map over.
+ * @param func - The function to apply to each child element.
+ * @param context - The context to use for the function.
+ * @returns An array of the cloned and modified child elements.
+ */
+export declare function mapCloneElement(children: React.ReactNode, func: any, context?: any): any[];
+/**
+ * Returns the number of children.
+ * @param children - The children to count.
+ * @returns The number of children.
+ */
+export declare function count(children: React.ReactNode): number;
+/**
+ * Checks if any child satisfies the given condition.
+ * @param children - The children to check.
+ * @param func - The condition function.
+ * @param context - The context to use for the condition function.
+ * @returns True if any child satisfies the condition, false otherwise.
+ */
+declare function some(children: React.ReactNode, func: any, context?: any): boolean;
+/**
+ * Utility functions for working with React children.
+ */
+export declare const ReactChildren: {
+    /**
+     * Maps over the children and clones each child element with the provided props.
+     */
+    mapCloneElement: typeof mapCloneElement;
+    /**
+     * Returns the number of children.
+     */
+    count: typeof count;
+    /**
+     * Checks if any child satisfies the given condition.
+     */
+    some: typeof some;
+    /**
+     * Maps over the children and applies the given function to each child.
+     */
+    map: typeof map;
+    /**
+     * Finds the first child that satisfies the given condition.
+     */
+    find: typeof find;
+};
+export default ReactChildren;

package/cjs/{utils → internals/utils}/ReactChildren.js

@@ -7,17 +7,34 @@ exports.find = find;
 exports.map = map;
 exports.mapCloneElement = mapCloneElement;
 exports.count = count;
-exports.default = void 0;
+exports.default = exports.ReactChildren = void 0;
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 var _react = _interopRequireDefault(require("react"));
+/**
+ * Returns the type of the given object.
+ * @param object - The object to check.
+ * @returns The type of the object.
+ */
 function typeOf(object) {
   if (typeof object === 'object' && object !== null) {
     return object.type || object.$$typeof;
   }
 }
+
+/**
+ * Checks if the given children is a React fragment.
+ * @param children - The children to check.
+ * @returns True if the children is a React fragment, false otherwise.
+ */
 function isFragment(children) {
   return _react.default.Children.count(children) === 1 && typeOf(children) === Symbol.for('react.fragment');
 }
+
+/**
+ * Flattens the given children into an array.
+ * @param children - The children to flatten.
+ * @returns The flattened array of children.
+ */
 function flatChildren(children) {
   return _react.default.Children.toArray(_react.default.Children.map(children, function (child) {
     if (isFragment(child)) {
@@ -27,6 +44,14 @@ function flatChildren(children) {
     return child;
   }));
 }
+
+/**
+ * Finds the first child that satisfies the given condition.
+ * @param children - The children to search.
+ * @param func - The condition function.
+ * @param context - The context to use for the condition function.
+ * @returns The first child that satisfies the condition, or undefined if no child is found.
+ */
 function find(children, func, context) {
   var index = 0;
   var result;
@@ -41,6 +66,14 @@ function find(children, func, context) {
   });
   return result;
 }
+
+/**
+ * Maps over the children and applies the given function to each child.
+ * @param children - The children to map over.
+ * @param func - The function to apply to each child.
+ * @param context - The context to use for the function.
+ * @returns An array of the results of applying the function to each child.
+ */
 function map(children, func, context) {
   var index = 0;
   return _react.default.Children.map(flatChildren(children), function (child) {
@@ -52,6 +85,14 @@ function map(children, func, context) {
     return handle;
   });
 }
+
+/**
+ * Maps over the children and clones each child element with the provided props.
+ * @param children - The children to clone and map over.
+ * @param func - The function to apply to each child element.
+ * @param context - The context to use for the function.
+ * @returns An array of the cloned and modified child elements.
+ */
 function mapCloneElement(children, func, context) {
   return map(children, function (child, index) {
     return /*#__PURE__*/_react.default.cloneElement(child, (0, _extends2.default)({
@@ -59,9 +100,23 @@ function mapCloneElement(children, func, context) {
     }, func(child, index)));
   }, context);
 }
+
+/**
+ * Returns the number of children.
+ * @param children - The children to count.
+ * @returns The number of children.
+ */
 function count(children) {
   return _react.default.Children.count(flatChildren(children));
 }
+
+/**
+ * Checks if any child satisfies the given condition.
+ * @param children - The children to check.
+ * @param func - The condition function.
+ * @param context - The context to use for the condition function.
+ * @returns True if any child satisfies the condition, false otherwise.
+ */
 function some(children, func, context) {
   var index = 0;
   var result = false;
@@ -80,11 +135,32 @@ function some(children, func, context) {
   });
   return result;
 }
-var _default = {
+
+/**
+ * Utility functions for working with React children.
+ */
+var ReactChildren = {
+  /**
+   * Maps over the children and clones each child element with the provided props.
+   */
   mapCloneElement: mapCloneElement,
+  /**
+   * Returns the number of children.
+   */
   count: count,
+  /**
+   * Checks if any child satisfies the given condition.
+   */
   some: some,
+  /**
+   * Maps over the children and applies the given function to each child.
+   */
   map: map,
+  /**
+   * Finds the first child that satisfies the given condition.
+   */
   find: find
 };
+exports.ReactChildren = ReactChildren;
+var _default = ReactChildren;
 exports.default = _default;

package/cjs/internals/utils/attachParent.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Attaches a parent object to the given data object.
+ */
+export declare function attachParent<T>(data: T, parent: T): T;
+export default attachParent;

package/cjs/{utils → internals/utils}/attachParent.js

@@ -3,6 +3,10 @@
 
 exports.__esModule = true;
 exports.attachParent = attachParent;
+exports.default = void 0;
+/**
+ * Attaches a parent object to the given data object.
+ */
 function attachParent(data, parent) {
   // mark "parent" unenumable
   Object.defineProperty(data, 'parent', {
@@ -12,4 +16,6 @@ function attachParent(data, parent) {
     configurable: true
   });
   return data;
-}
+}
+var _default = attachParent;
+exports.default = _default;

package/cjs/internals/utils/composeFunctions.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Composes multiple functions into a single function.
+ *
+ * @example
+ * ```
+ * const a = () => console.log('a');
+ * const b = () => console.log('b');
+ * const c = () => console.log('c');
+ *
+ * const d = composeFunctions(a, b, c);
+ *
+ * d(); // a b c
+ * ```
+ */
+export declare function composeFunctions(...fns: any[]): (first: any) => any;
+export default composeFunctions;

package/cjs/internals/utils/composeFunctions.js

@@ -0,0 +1,32 @@
+'use client';
+"use strict";
+
+exports.__esModule = true;
+exports.composeFunctions = composeFunctions;
+exports.default = void 0;
+/**
+ * Composes multiple functions into a single function.
+ *
+ * @example
+ * ```
+ * const a = () => console.log('a');
+ * const b = () => console.log('b');
+ * const c = () => console.log('c');
+ *
+ * const d = composeFunctions(a, b, c);
+ *
+ * d(); // a b c
+ * ```
+ */
+function composeFunctions() {
+  for (var _len = arguments.length, fns = new Array(_len), _key = 0; _key < _len; _key++) {
+    fns[_key] = arguments[_key];
+  }
+  return function (first) {
+    return fns.reduce(function (previousValue, fn) {
+      return fn(previousValue);
+    }, first);
+  };
+}
+var _default = composeFunctions;
+exports.default = _default;

package/{esm → cjs/internals}/utils/createChainedFunction.d.ts

@@ -11,5 +11,5 @@
  * @param {function} functions to chain
  * @returns {function|undefined}
  */
-declare function createChainedFunction<T = any>(...funcs: (T | null)[]): T;
+export declare function createChainedFunction<T = any>(...funcs: (T | null)[]): T;
 export default createChainedFunction;

package/cjs/{utils → internals/utils}/createChainedFunction.js

@@ -2,6 +2,7 @@
 "use strict";
 
 exports.__esModule = true;
+exports.createChainedFunction = createChainedFunction;
 exports.default = void 0;
 /**
  *

package/{esm → cjs/internals}/utils/createComponent.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { WithAsProps, RsRefForwardingComponent } from '../@types/common';
+import { WithAsProps, RsRefForwardingComponent } from '@/internals/types';
 export declare type ComponentProps = WithAsProps & React.HTMLAttributes<HTMLDivElement>;
 interface Props<TElement extends React.ElementType> extends React.HTMLAttributes<HTMLDivElement> {
     name: string;
@@ -9,5 +9,5 @@ interface Props<TElement extends React.ElementType> extends React.HTMLAttributes
 /**
  * Create a component with `classPrefix` and `as` attributes.
  */
-declare function createComponent<TElement extends React.ElementType = 'div'>({ name, componentAs, componentClassPrefix, ...defaultProps }: Props<TElement>): RsRefForwardingComponent<TElement, ComponentProps>;
+export declare function createComponent<TElement extends React.ElementType = 'div'>({ name, componentAs, componentClassPrefix, ...defaultProps }: Props<TElement>): RsRefForwardingComponent<TElement, ComponentProps>;
 export default createComponent;

package/cjs/{utils → internals/utils}/createComponent.js

@@ -3,13 +3,14 @@
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 exports.__esModule = true;
+exports.createComponent = createComponent;
 exports.default = void 0;
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
 var _react = _interopRequireDefault(require("react"));
 var _kebabCase = _interopRequireDefault(require("lodash/kebabCase"));
 var _propTypes = _interopRequireDefault(require("prop-types"));
-var _utils = require("../utils");
+var _hooks = require("../hooks");
 /**
  * Create a component with `classPrefix` and `as` attributes.
  */
@@ -26,7 +27,7 @@ function createComponent(_ref) {
       className = props.className,
       role = props.role,
       rest = (0, _objectWithoutPropertiesLoose2.default)(props, ["as", "classPrefix", "className", "role"]);
-    var _useClassNames = (0, _utils.useClassNames)(classPrefix),
+    var _useClassNames = (0, _hooks.useClassNames)(classPrefix),
       withClassPrefix = _useClassNames.withClassPrefix,
       merge = _useClassNames.merge;
     var classes = merge(className, withClassPrefix());

package/cjs/internals/utils/date/copyTime.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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;
+    to: Date;
+}): Date;
+export default copyTime;

package/cjs/internals/utils/date/copyTime.js

@@ -0,0 +1,33 @@
+'use client';
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+exports.__esModule = true;
+exports.copyTime = copyTime;
+exports.default = void 0;
+var _getHours = _interopRequireDefault(require("date-fns/getHours"));
+var _getMinutes = _interopRequireDefault(require("date-fns/getMinutes"));
+var _getSeconds = _interopRequireDefault(require("date-fns/getSeconds"));
+var _set = _interopRequireDefault(require("date-fns/set"));
+var _isValid = _interopRequireDefault(require("date-fns/isValid"));
+/**
+ * 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.
+ */
+function copyTime(_ref) {
+  var from = _ref.from,
+    to = _ref.to;
+  if (!(0, _isValid.default)(from) || !(0, _isValid.default)(to)) {
+    return to;
+  }
+  return (0, _set.default)(to, {
+    hours: (0, _getHours.default)(from),
+    minutes: (0, _getMinutes.default)(from),
+    seconds: (0, _getSeconds.default)(from)
+  });
+}
+var _default = copyTime;
+exports.default = _default;

package/cjs/internals/utils/date/disableTime.d.ts

@@ -0,0 +1,18 @@
+import { TimeProp } from './types';
+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 - The calendar props.
+ * @param date - The date to check.
+ * @returns Whether the time is disabled.
+ */
+export declare function disableTime(props: CalendarProps, date: Date): boolean;
+export default disableTime;

package/cjs/internals/utils/date/disableTime.js

@@ -0,0 +1,48 @@
+'use client';
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+exports.__esModule = true;
+exports.disableTime = disableTime;
+exports.default = void 0;
+var _pick = _interopRequireDefault(require("lodash/pick"));
+var _getHours = _interopRequireDefault(require("date-fns/getHours"));
+var _getMinutes = _interopRequireDefault(require("date-fns/getMinutes"));
+var _getSeconds = _interopRequireDefault(require("date-fns/getSeconds"));
+var _types = require("./types");
+var HOURS_PATTERN = /(Hours?)/;
+var MINUTES_PATTERN = /(Minutes?)/;
+var SECONDS_PATTERN = /(Seconds?)/;
+
+/**
+ * Verify that the time is valid.
+ *
+ * @param props - The calendar props.
+ * @param date - The date to check.
+ * @returns Whether the time is disabled.
+ */
+function disableTime(props, date) {
+  if (!date) {
+    return false;
+  }
+  var disabledTimeProps = [_types.TimeProp.DisabledHours, _types.TimeProp.DisabledMinutes, _types.TimeProp.DisabledSeconds, _types.TimeProp.ShouldDisableHour, _types.TimeProp.ShouldDisableMinute, _types.TimeProp.ShouldDisableSecond];
+  var calendarProps = (0, _pick.default)(props, disabledTimeProps);
+  var mapProps = new Map(Object.entries(calendarProps));
+  return Array.from(mapProps.keys()).some(function (key) {
+    if (HOURS_PATTERN.test(key)) {
+      var _mapProps$get;
+      return (_mapProps$get = mapProps.get(key)) === null || _mapProps$get === void 0 ? void 0 : _mapProps$get((0, _getHours.default)(date), date);
+    }
+    if (MINUTES_PATTERN.test(key)) {
+      var _mapProps$get2;
+      return (_mapProps$get2 = mapProps.get(key)) === null || _mapProps$get2 === void 0 ? void 0 : _mapProps$get2((0, _getMinutes.default)(date), date);
+    }
+    if (SECONDS_PATTERN.test(key)) {
+      var _mapProps$get3;
+      return (_mapProps$get3 = mapProps.get(key)) === null || _mapProps$get3 === void 0 ? void 0 : _mapProps$get3((0, _getSeconds.default)(date), date);
+    }
+    return false;
+  });
+}
+var _default = disableTime;
+exports.default = _default;

package/cjs/internals/utils/date/formatCheck.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 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 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;

package/cjs/internals/utils/date/formatCheck.js

@@ -0,0 +1,48 @@
+'use client';
+"use strict";
+
+exports.__esModule = true;
+exports.shouldOnlyRenderTime = exports.shouldRenderDate = exports.shouldRenderMonth = exports.shouldRenderTime = void 0;
+/**
+ * Check if the time should be rendered based on the format.
+ *
+ * @param format - The format string.
+ * @returns Whether the time should be rendered.
+ */
+var shouldRenderTime = function shouldRenderTime(format) {
+  return /([Hhms])/.test(format);
+};
+
+/**
+ * Check if the month should be rendered based on the format.
+ *
+ * @param format - The format string.
+ * @returns Whether the month should be rendered.
+ */
+exports.shouldRenderTime = shouldRenderTime;
+var shouldRenderMonth = function shouldRenderMonth(format) {
+  return /[Yy]/.test(format) && /[ML]/.test(format);
+};
+
+/**
+ * Check if the date should be rendered based on the format.
+ *
+ * @param format - The format string.
+ * @returns Whether the date should be rendered.
+ */
+exports.shouldRenderMonth = shouldRenderMonth;
+var shouldRenderDate = function shouldRenderDate(format) {
+  return /[Yy]/.test(format) && /[ML]/.test(format) && /[Dd]/.test(format);
+};
+
+/**
+ * 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.
+ */
+exports.shouldRenderDate = shouldRenderDate;
+var shouldOnlyRenderTime = function shouldOnlyRenderTime(format) {
+  return /([Hhms])/.test(format) && !/([YyMDd])/.test(format);
+};
+exports.shouldOnlyRenderTime = shouldOnlyRenderTime;

package/cjs/internals/utils/date/getReversedTimeMeridian.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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;
+export default getReversedTimeMeridian;

package/cjs/internals/utils/date/getReversedTimeMeridian.js

@@ -0,0 +1,23 @@
+'use client';
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+exports.__esModule = true;
+exports.default = exports.getReversedTimeMeridian = void 0;
+var _setHours = _interopRequireDefault(require("date-fns/setHours"));
+var _getHours = _interopRequireDefault(require("date-fns/getHours"));
+/**
+ * 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.
+ */
+var getReversedTimeMeridian = function getReversedTimeMeridian(date) {
+  var clonedDate = new Date(date.valueOf());
+  var hours = (0, _getHours.default)(clonedDate);
+  var nextHours = hours >= 12 ? hours - 12 : hours + 12;
+  return (0, _setHours.default)(clonedDate, nextHours);
+};
+exports.getReversedTimeMeridian = getReversedTimeMeridian;
+var _default = getReversedTimeMeridian;
+exports.default = _default;

package/cjs/internals/utils/date/getWeekKeys.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Retrieves an array of week keys starting from the specified weekday.
+ */
+export declare function getWeekKeys(weekStart?: 0 | 1 | 2 | 3 | 4 | 5 | 6): string[];
+export default getWeekKeys;

package/cjs/internals/utils/date/getWeekKeys.js

@@ -0,0 +1,18 @@
+'use client';
+"use strict";
+
+exports.__esModule = true;
+exports.getWeekKeys = getWeekKeys;
+exports.default = void 0;
+/**
+ * Retrieves an array of week keys starting from the specified weekday.
+ */
+function getWeekKeys(weekStart) {
+  var weekKeys = ['sunday', 'monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday'];
+  if (typeof weekStart === 'undefined') {
+    return weekKeys;
+  }
+  return weekKeys.slice(weekStart).concat(weekKeys.slice(0, weekStart));
+}
+var _default = getWeekKeys;
+exports.default = _default;

package/cjs/internals/utils/date/getWeekStartDates.d.ts

@@ -0,0 +1,14 @@
+import type { Locale } from 'date-fns';
+/**
+ * Get the first days of weeks in a month。
+ * @param firstDayOfMonth The first day of the month
+ * @param options.weekStart the index of the first day of the week (0 - Sunday)
+ * @param options.isoWeek Whether to use ISO week
+ * @returns A list of first days of weeks in a month
+ */
+export declare function getWeekStartDates(firstDayOfMonth: Date, options: {
+    weekStart?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    isoWeek?: boolean;
+    locale?: Locale;
+}): Date[];
+export default getWeekStartDates;

package/cjs/internals/utils/date/getWeekStartDates.js

@@ -0,0 +1,34 @@
+'use client';
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+exports.__esModule = true;
+exports.getWeekStartDates = getWeekStartDates;
+exports.default = void 0;
+var _addDays = _interopRequireDefault(require("date-fns/addDays"));
+var _startOfWeek = _interopRequireDefault(require("date-fns/startOfWeek"));
+/**
+ * Get the first days of weeks in a month。
+ * @param firstDayOfMonth The first day of the month
+ * @param options.weekStart the index of the first day of the week (0 - Sunday)
+ * @param options.isoWeek Whether to use ISO week
+ * @returns A list of first days of weeks in a month
+ */
+function getWeekStartDates(firstDayOfMonth, options) {
+  var _options$weekStart = options.weekStart,
+    weekStart = _options$weekStart === void 0 ? 0 : _options$weekStart,
+    isoWeek = options.isoWeek,
+    locale = options.locale;
+  var weekStartsOn = isoWeek ? 1 : weekStart;
+  var firstDay = (0, _startOfWeek.default)(firstDayOfMonth, {
+    weekStartsOn: weekStartsOn,
+    locale: locale
+  });
+  var days = [firstDay];
+  for (var i = 1; i < 6; i++) {
+    days.push((0, _addDays.default)(firstDay, i * 7));
+  }
+  return days;
+}
+var _default = getWeekStartDates;
+exports.default = _default;