rsuite 5.61.0 → 5.62.1

package/esm/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/esm/internals/utils/ReactChildren.js

@@ -0,0 +1,156 @@
+'use client';
+import _extends from "@babel/runtime/helpers/esm/extends";
+import React from '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.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.Children.toArray(React.Children.map(children, function (child) {
+    if (isFragment(child)) {
+      var _child$props;
+      return React.Children.toArray(((_child$props = child.props) === null || _child$props === void 0 ? void 0 : _child$props.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.
+ */
+export function find(children, func, context) {
+  var index = 0;
+  var result;
+  React.Children.forEach(flatChildren(children), function (child) {
+    if (result) {
+      return;
+    }
+    index += 1;
+    if (func.call(context, child, index)) {
+      result = child;
+    }
+  });
+  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.
+ */
+export function map(children, func, context) {
+  var index = 0;
+  return React.Children.map(flatChildren(children), function (child) {
+    if (! /*#__PURE__*/React.isValidElement(child)) {
+      return child;
+    }
+    var handle = func.call(context, child, index);
+    index += 1;
+    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.
+ */
+export function mapCloneElement(children, func, context) {
+  return map(children, function (child, index) {
+    return /*#__PURE__*/React.cloneElement(child, _extends({
+      key: index
+    }, func(child, index)));
+  }, context);
+}
+
+/**
+ * Returns the number of children.
+ * @param children - The children to count.
+ * @returns The number of children.
+ */
+export function count(children) {
+  return React.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;
+  React.Children.forEach(flatChildren(children), function (child) {
+    if (result) {
+      return;
+    }
+    if (! /*#__PURE__*/React.isValidElement(child)) {
+      return;
+    }
+
+    /* eslint-disable */
+    if (func.call(context, child, index += 1)) {
+      result = true;
+    }
+  });
+  return result;
+}
+
+/**
+ * Utility functions for working with React children.
+ */
+export 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
+};
+export default ReactChildren;

package/esm/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/esm/{utils → internals/utils}/attachParent.js

@@ -1,4 +1,7 @@
 'use client';
+/**
+ * Attaches a parent object to the given data object.
+ */
 export function attachParent(data, parent) {
   // mark "parent" unenumable
   Object.defineProperty(data, 'parent', {
@@ -8,4 +11,5 @@ export function attachParent(data, parent) {
     configurable: true
   });
   return data;
-}
+}
+export default attachParent;

package/esm/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/esm/internals/utils/composeFunctions.js

@@ -0,0 +1,26 @@
+'use client';
+/**
+ * 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 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);
+  };
+}
+export default composeFunctions;

package/{cjs → esm/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/esm/{utils → internals/utils}/createChainedFunction.js

@@ -13,7 +13,7 @@
  * @returns {function|undefined}
  */
 
-function createChainedFunction() {
+export function createChainedFunction() {
   for (var _len = arguments.length, funcs = new Array(_len), _key = 0; _key < _len; _key++) {
     funcs[_key] = arguments[_key];
   }

package/esm/internals/utils/createComponent.d.ts

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

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

@@ -1,18 +1,20 @@
 'use client';
 import _extends from "@babel/runtime/helpers/esm/extends";
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+var _excluded = ["name", "componentAs", "componentClassPrefix"],
+  _excluded2 = ["as", "classPrefix", "className", "role"];
 import React from 'react';
 import kebabCase from 'lodash/kebabCase';
 import PropTypes from 'prop-types';
-import { useClassNames } from '../utils';
+import { useClassNames } from "../hooks/index.js";
 /**
  * Create a component with `classPrefix` and `as` attributes.
  */
-function createComponent(_ref) {
+export function createComponent(_ref) {
   var name = _ref.name,
     componentAs = _ref.componentAs,
     componentClassPrefix = _ref.componentClassPrefix,
-    defaultProps = _objectWithoutPropertiesLoose(_ref, ["name", "componentAs", "componentClassPrefix"]);
+    defaultProps = _objectWithoutPropertiesLoose(_ref, _excluded);
   var Component = /*#__PURE__*/React.forwardRef(function (props, ref) {
     var _props$as = props.as,
       Component = _props$as === void 0 ? componentAs || 'div' : _props$as,
@@ -20,7 +22,7 @@ function createComponent(_ref) {
       classPrefix = _props$classPrefix === void 0 ? componentClassPrefix || kebabCase(name) : _props$classPrefix,
       className = props.className,
       role = props.role,
-      rest = _objectWithoutPropertiesLoose(props, ["as", "classPrefix", "className", "role"]);
+      rest = _objectWithoutPropertiesLoose(props, _excluded2);
     var _useClassNames = useClassNames(classPrefix),
       withClassPrefix = _useClassNames.withClassPrefix,
       merge = _useClassNames.merge;

package/esm/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/esm/internals/utils/date/copyTime.js

@@ -0,0 +1,27 @@
+'use client';
+import getHours from 'date-fns/getHours';
+import getMinutes from 'date-fns/getMinutes';
+import getSeconds from 'date-fns/getSeconds';
+import set from 'date-fns/set';
+import isValid from '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.
+ */
+export function copyTime(_ref) {
+  var from = _ref.from,
+    to = _ref.to;
+  if (!isValid(from) || !isValid(to)) {
+    return to;
+  }
+  return set(to, {
+    hours: getHours(from),
+    minutes: getMinutes(from),
+    seconds: getSeconds(from)
+  });
+}
+export default copyTime;

package/esm/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/esm/internals/utils/date/disableTime.js

@@ -0,0 +1,41 @@
+'use client';
+import pick from 'lodash/pick';
+import getHours from 'date-fns/getHours';
+import getMinutes from 'date-fns/getMinutes';
+import getSeconds from 'date-fns/getSeconds';
+import { TimeProp } from "./types.js";
+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.
+ */
+export function disableTime(props, date) {
+  if (!date) {
+    return false;
+  }
+  var disabledTimeProps = [TimeProp.DisabledHours, TimeProp.DisabledMinutes, TimeProp.DisabledSeconds, TimeProp.ShouldDisableHour, TimeProp.ShouldDisableMinute, TimeProp.ShouldDisableSecond];
+  var calendarProps = pick(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(getHours(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(getMinutes(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(getSeconds(date), date);
+    }
+    return false;
+  });
+}
+export default disableTime;

package/esm/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/esm/internals/utils/date/formatCheck.js

@@ -0,0 +1,40 @@
+'use client';
+/**
+ * Check if the time should be rendered based on the format.
+ *
+ * @param format - The format string.
+ * @returns Whether the time should be rendered.
+ */
+export 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export var shouldOnlyRenderTime = function shouldOnlyRenderTime(format) {
+  return /([Hhms])/.test(format) && !/([YyMDd])/.test(format);
+};

package/esm/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/esm/internals/utils/date/getReversedTimeMeridian.js

@@ -0,0 +1,17 @@
+'use client';
+import setHours from 'date-fns/setHours';
+import getHours from '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.
+ */
+export var getReversedTimeMeridian = function getReversedTimeMeridian(date) {
+  var clonedDate = new Date(date.valueOf());
+  var hours = getHours(clonedDate);
+  var nextHours = hours >= 12 ? hours - 12 : hours + 12;
+  return setHours(clonedDate, nextHours);
+};
+export default getReversedTimeMeridian;

package/esm/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/esm/internals/utils/date/getWeekKeys.js

@@ -0,0 +1,12 @@
+'use client';
+/**
+ * Retrieves an array of week keys starting from the specified weekday.
+ */
+export 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));
+}
+export default getWeekKeys;

package/esm/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/esm/internals/utils/date/getWeekStartDates.js

@@ -0,0 +1,27 @@
+'use client';
+import addDays from 'date-fns/addDays';
+import startOfWeek from '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
+ */
+export 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 = startOfWeek(firstDayOfMonth, {
+    weekStartsOn: weekStartsOn,
+    locale: locale
+  });
+  var days = [firstDay];
+  for (var i = 1; i < 6; i++) {
+    days.push(addDays(firstDay, i * 7));
+  }
+  return days;
+}
+export default getWeekStartDates;