rsuite 5.70.0 → 5.70.2

package/esm/Breadcrumb/Breadcrumb.d.ts

@@ -3,17 +3,27 @@ import BreadcrumbItem from './BreadcrumbItem';
 import { WithAsProps, RsRefForwardingComponent } from '../internals/types';
 import { BreadcrumbLocale } from '../locales';
 export interface BreadcrumbProps extends WithAsProps {
-    /** Shorthand for primary content of the React.ReactNode */
+    /**
+     * The separator between each breadcrumb item.
+     */
     separator?: React.ReactNode;
     /**
      * Set the maximum number of breadcrumbs to display.
      * When there are more than the maximum number,
      * only the first and last will be shown, with an ellipsis in between.
-     * */
+     */
     maxItems?: number;
-    /** Custom locale */
+    /**
+     * The locale of the component.
+     */
     locale?: BreadcrumbLocale;
-    /** A function to be called when you are in the collapsed view and click the ellipsis. */
+    /**
+     * The ellipsis element.
+     */
+    ellipsis?: React.ReactNode;
+    /**
+     * Callback function for clicking the ellipsis.
+     */
     onExpand?: (event: React.MouseEvent) => void;
 }
 export interface BreadcrumbComponent extends RsRefForwardingComponent<'ol', BreadcrumbProps> {

package/esm/Breadcrumb/Breadcrumb.js

@@ -1,13 +1,18 @@
 'use client';
 import _extends from "@babel/runtime/helpers/esm/extends";
-import _taggedTemplateLiteralLoose from "@babel/runtime/helpers/esm/taggedTemplateLiteralLoose";
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
-var _templateObject;
-var _excluded = ["as", "className", "classPrefix", "children", "maxItems", "separator", "locale", "onExpand"];
-import React, { useState, useCallback } from 'react';
+var _excluded = ["as", "className", "classPrefix", "children", "ellipsis", "maxItems", "separator", "locale", "onExpand"];
+import React, { useState, useMemo } from 'react';
 import PropTypes from 'prop-types';
-import { useClassNames, useCustom } from "../internals/hooks/index.js";
+import { useClassNames, useCustom, useEventCallback } from "../internals/hooks/index.js";
+import { ReactChildren, createComponent } from "../internals/utils/index.js";
 import BreadcrumbItem from "./BreadcrumbItem.js";
+var Separator = createComponent({
+  name: 'BreadcrumbSeparator',
+  componentAs: 'span',
+  'aria-hidden': true
+});
+
 /**
  * The Breadcrumb component is used to indicate the current page location and navigate.
  * @see https://rsuitejs.com/components/breadcrumb
@@ -19,6 +24,8 @@ var Breadcrumb = /*#__PURE__*/React.forwardRef(function (props, ref) {
     _props$classPrefix = props.classPrefix,
     classPrefix = _props$classPrefix === void 0 ? 'breadcrumb' : _props$classPrefix,
     children = props.children,
+    _props$ellipsis = props.ellipsis,
+    ellipsis = _props$ellipsis === void 0 ? '...' : _props$ellipsis,
     _props$maxItems = props.maxItems,
     maxItems = _props$maxItems === void 0 ? 5 : _props$maxItems,
     _props$separator = props.separator,
@@ -28,62 +35,53 @@ var Breadcrumb = /*#__PURE__*/React.forwardRef(function (props, ref) {
     rest = _objectWithoutPropertiesLoose(props, _excluded);
   var _useClassNames = useClassNames(classPrefix),
     merge = _useClassNames.merge,
-    prefix = _useClassNames.prefix,
     withClassPrefix = _useClassNames.withClassPrefix;
   var _useState = useState(true),
-    ellipsis = _useState[0],
-    setEllipsis = _useState[1];
+    showEllipsis = _useState[0],
+    setShowEllipsis = _useState[1];
   var _useCustom = useCustom('Breadcrumb', overrideLocale),
     locale = _useCustom.locale;
-  var renderSeparator = function renderSeparator(key) {
-    return /*#__PURE__*/React.createElement("span", {
-      key: "breadcrumb-separator-" + key,
-      "aria-hidden": true,
-      className: prefix(_templateObject || (_templateObject = _taggedTemplateLiteralLoose(["separator"])))
-    }, separator);
-  };
-  var handleClickEllipsis = useCallback(function (event) {
-    setEllipsis(false);
+  var handleClickEllipsis = useEventCallback(function (event) {
+    setShowEllipsis(false);
     onExpand === null || onExpand === void 0 ? void 0 : onExpand(event);
-  }, [onExpand]);
-  var items = [];
-  var count = React.Children.count(children);
-  if (count) {
-    React.Children.forEach(children, function (item, index) {
-      items.push(item);
-      if (index < count - 1) {
-        items.push(renderSeparator(index));
-      }
+  });
+  var content = useMemo(function () {
+    var count = ReactChildren.count(children);
+    var items = ReactChildren.mapCloneElement(children, function (item, index) {
+      var isLast = index === count - 1;
+      return _extends({}, item.props, {
+        separator: isLast ? null : /*#__PURE__*/React.createElement(Separator, null, separator)
+      });
     });
-  }
-  var renderCollapseItems = function renderCollapseItems() {
-    if (count > maxItems && count > 2 && ellipsis) {
-      return [].concat(items.slice(0, 2), [[/*#__PURE__*/React.createElement(BreadcrumbItem, {
+    if (count > maxItems && count > 2 && showEllipsis) {
+      return [].concat(items.slice(0, 1), [[/*#__PURE__*/React.createElement(BreadcrumbItem, {
         role: "button",
         key: "ellipsis",
         title: locale.expandText,
         "aria-label": locale.expandText,
+        separator: /*#__PURE__*/React.createElement(Separator, null, separator),
         onClick: handleClickEllipsis
       }, /*#__PURE__*/React.createElement("span", {
         "aria-hidden": true
-      }, "..."))]], items.slice(items.length - 2, items.length));
+      }, ellipsis))]], items.slice(items.length - 1, items.length));
     }
     return items;
-  };
+  }, [children, ellipsis, handleClickEllipsis, locale.expandText, maxItems, separator, showEllipsis]);
   var classes = merge(className, withClassPrefix());
   return /*#__PURE__*/React.createElement(Component, _extends({}, rest, {
     ref: ref,
     className: classes
-  }), renderCollapseItems());
+  }), /*#__PURE__*/React.createElement("ol", null, content));
 });
 Breadcrumb.Item = BreadcrumbItem;
 Breadcrumb.displayName = 'Breadcrumb';
 Breadcrumb.propTypes = {
-  separator: PropTypes.node,
   as: PropTypes.elementType,
   children: PropTypes.node,
   className: PropTypes.string,
   classPrefix: PropTypes.string,
+  ellipsis: PropTypes.node,
+  separator: PropTypes.node,
   maxItems: PropTypes.number,
   onExpand: PropTypes.func
 };

package/esm/Breadcrumb/BreadcrumbItem.d.ts

@@ -1,10 +1,30 @@
 import React from 'react';
 import { WithAsProps, RsRefForwardingComponent } from '../internals/types';
 export interface BreadcrumbItemProps extends WithAsProps<React.ElementType | string> {
+    /**
+     * The wrapper element of the BreadcrumbItem.
+     */
+    wrapperAs?: React.ElementType;
+    /**
+     * The active state of the BreadcrumbItem.
+     */
     active?: boolean;
+    /**
+     * The href attribute specifies the URL of the page the link goes to.
+     */
     href?: string;
+    /**
+     * The title attribute specifies extra information about an element.
+     */
     title?: string;
+    /**
+     * The target attribute specifies where to open the linked document.
+     */
     target?: string;
+    /**
+     * The separator between each breadcrumb item.
+     */
+    separator?: React.ReactNode;
 }
 /**
  * The `<Breadcrumb.Item>` component is used to specify each section of the Breadcrumb.

package/esm/Breadcrumb/BreadcrumbItem.js

@@ -1,7 +1,7 @@
 'use client';
 import _extends from "@babel/runtime/helpers/esm/extends";
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
-var _excluded = ["as", "href", "classPrefix", "title", "target", "className", "style", "active", "children"];
+var _excluded = ["wrapperAs", "href", "as", "classPrefix", "title", "target", "className", "style", "active", "children", "separator"];
 import React from 'react';
 import PropTypes from 'prop-types';
 import SafeAnchor from "../SafeAnchor/index.js";
@@ -11,9 +11,11 @@ import { useClassNames } from "../internals/hooks/index.js";
  * @see https://rsuitejs.com/components/breadcrumb
  */
 var BreadcrumbItem = /*#__PURE__*/React.forwardRef(function (props, ref) {
-  var _props$as = props.as,
-    Component = _props$as === void 0 ? props.href ? SafeAnchor : 'span' : _props$as,
+  var _props$wrapperAs = props.wrapperAs,
+    WrapperComponent = _props$wrapperAs === void 0 ? 'li' : _props$wrapperAs,
     href = props.href,
+    _props$as = props.as,
+    Component = _props$as === void 0 ? href ? SafeAnchor : 'span' : _props$as,
     _props$classPrefix = props.classPrefix,
     classPrefix = _props$classPrefix === void 0 ? 'breadcrumb-item' : _props$classPrefix,
     title = props.title,
@@ -22,6 +24,7 @@ var BreadcrumbItem = /*#__PURE__*/React.forwardRef(function (props, ref) {
     style = props.style,
     active = props.active,
     children = props.children,
+    separator = props.separator,
     rest = _objectWithoutPropertiesLoose(props, _excluded);
   var _useClassNames = useClassNames(classPrefix),
     merge = _useClassNames.merge,
@@ -29,22 +32,15 @@ var BreadcrumbItem = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var classes = merge(className, withClassPrefix({
     active: active
   }));
-  if (active) {
-    return /*#__PURE__*/React.createElement("span", _extends({
-      ref: ref
-    }, rest, {
-      style: style,
-      className: classes
-    }), children);
-  }
-  return /*#__PURE__*/React.createElement(Component, _extends({}, rest, {
+  return /*#__PURE__*/React.createElement(WrapperComponent, _extends({
+    style: style,
+    className: classes,
+    ref: ref
+  }, rest), active ? /*#__PURE__*/React.createElement("span", null, children) : /*#__PURE__*/React.createElement(Component, {
     href: href,
     title: title,
-    target: target,
-    ref: ref,
-    style: style,
-    className: classes
-  }), children);
+    target: target
+  }, children), separator);
 });
 BreadcrumbItem.displayName = 'BreadcrumbItem';
 BreadcrumbItem.propTypes = {

package/esm/Button/Button.js

@@ -4,7 +4,7 @@ import _taggedTemplateLiteralLoose from "@babel/runtime/helpers/esm/taggedTempla
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
 var _templateObject, _templateObject2, _templateObject3;
 var _excluded = ["as", "active", "appearance", "block", "className", "children", "classPrefix", "color", "disabled", "loading", "ripple", "size", "startIcon", "endIcon", "type"];
-import React, { useCallback, useContext } from 'react';
+import React, { useContext, useMemo } from 'react';
 import PropTypes from 'prop-types';
 import Ripple from "../internals/Ripple/index.js";
 import { oneOf } from "../internals/propTypes/index.js";
@@ -48,7 +48,7 @@ var Button = /*#__PURE__*/React.forwardRef(function (props, ref) {
     loading: loading,
     block: block
   }));
-  var renderButtonContent = useCallback(function () {
+  var buttonContent = useMemo(function () {
     var spin = /*#__PURE__*/React.createElement("span", {
       className: prefix(_templateObject || (_templateObject = _taggedTemplateLiteralLoose(["spin"])))
     });
@@ -66,7 +66,7 @@ var Button = /*#__PURE__*/React.forwardRef(function (props, ref) {
       "aria-disabled": disabled,
       disabled: disabled,
       className: classes
-    }), renderButtonContent());
+    }), buttonContent);
   }
   var Component = as || 'button';
   var type = typeProp || (Component === 'button' ? 'button' : undefined);
@@ -78,7 +78,7 @@ var Button = /*#__PURE__*/React.forwardRef(function (props, ref) {
     disabled: disabled,
     "aria-disabled": disabled,
     className: classes
-  }), renderButtonContent());
+  }), buttonContent);
 });
 Button.displayName = 'Button';
 Button.propTypes = {

package/esm/Calendar/TableRow.js

@@ -9,6 +9,7 @@ import { useClassNames } from "../internals/hooks/index.js";
 import { useCalendarContext } from "./CalendarContext.js";
 import TableCell from "./TableCell.js";
 var TableRow = /*#__PURE__*/React.forwardRef(function (props, ref) {
+  var _locale$dateLocale$op, _locale$dateLocale;
   var _props$as = props.as,
     Component = _props$as === void 0 ? 'div' : _props$as,
     className = props.className,
@@ -93,10 +94,13 @@ var TableRow = /*#__PURE__*/React.forwardRef(function (props, ref) {
     return days;
   };
   var classes = merge(className, prefix('row'));
+  var _ref3 = (_locale$dateLocale$op = locale === null || locale === void 0 ? void 0 : (_locale$dateLocale = locale.dateLocale) === null || _locale$dateLocale === void 0 ? void 0 : _locale$dateLocale.options) !== null && _locale$dateLocale$op !== void 0 ? _locale$dateLocale$op : {},
+    firstWeekContainsDate = _ref3.firstWeekContainsDate,
+    weekStartsOn = _ref3.weekStartsOn;
   var week = format(weekendDate, isoWeek ? 'I' : 'w', {
     locale: locale === null || locale === void 0 ? void 0 : locale.dateLocale,
-    firstWeekContainsDate: 4,
-    weekStartsOn: weekStart
+    firstWeekContainsDate: firstWeekContainsDate,
+    weekStartsOn: weekStart || weekStartsOn
   });
   return /*#__PURE__*/React.createElement(Component, _extends({}, rest, {
     ref: ref,

package/esm/CustomProvider/CustomProvider.d.ts

@@ -1,18 +1,67 @@
 import React from 'react';
-import type { Locale as DateFnsLocale } from 'date-fns';
 import { Locale } from '../locales';
 import { ToastContainerInstance } from '../toaster/ToastContainer';
+import type { Locale as DateFnsLocale } from 'date-fns';
+import type { DateFns } from '../internals/types';
 export interface FormatDateOptions {
+    /**
+     * The locale object that contains the language and formatting rules for the date.
+     */
     locale?: DateFnsLocale;
-    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
-    firstWeekContainsDate?: number;
+    /**
+     * Defines which day of the week should be considered the start of the week.
+     *
+     * The value should be an integer from 0 to 6, where:
+     * - `0` represents Sunday,
+     * - `1` represents Monday,
+     * - `2` represents Tuesday,
+     * - `3` represents Wednesday,
+     * - `4` represents Thursday,
+     * - `5` represents Friday,
+     * - `6` represents Saturday.
+     *
+     * This option is important for functions that operate on weeks, such as calculating
+     * the start or end of a week, determining which week a date falls in, or generating
+     * calendar views. The default value varies depending on the locale, with Monday (`1`)
+     * being the default in most regions following ISO 8601, while Sunday (`0`) is often
+     * the default in regions like the United States.
+     */
+    weekStartsOn?: DateFns.Day;
+    /**
+     * `firstWeekContainsDate` is used to determine which week is considered the first week of the year.
+     *
+     * This option specifies the minimum day of January that must be included in the first week.
+     *
+     * The value can be set to:
+     * - `1`: The first week of the year must include January 1st.
+     * - `4`: The first week of the year must include January 4th, which is the default according to ISO 8601.
+     *
+     * The choice between `1` and `4` typically depends on the regional or business conventions for week numbering.
+     *
+     * Please note that this option only accepts `1` (Sunday) or `4` (Thursday), aligning with common international standards.
+     *
+     * For more detailed information, please refer to https://en.wikipedia.org/wiki/Week#Week_numbering.
+     */
+    firstWeekContainsDate?: DateFns.FirstWeekContainsDate;
+    /**
+     * If true, allows usage of the week-numbering year tokens `YY` and `YYYY`.
+     * See: https://date-fns.org/docs/Unicode-Tokens
+     **/
     useAdditionalWeekYearTokens?: boolean;
+    /**
+     * If true, allows usage of the day of year tokens `D` and `DD`.
+     * See: https://date-fns.org/docs/Unicode-Tokens
+     */
     useAdditionalDayOfYearTokens?: boolean;
 }
 export interface CustomValue<T = Locale> {
-    /** Language configuration */
+    /**
+     * The locale object that contains the language and formatting rules for the date.
+     */
     locale: T;
-    /** Support right-to-left */
+    /**
+     * Right-to-left text direction.
+     */
     rtl: boolean;
     /**
      * Return the formatted date string in the given format. The result may vary by locale.
@@ -26,7 +75,7 @@ export interface CustomValue<T = Locale> {
      *    return format(date, formatStr, { locale: eo });
      *  }
      *
-     * */
+     */
     formatDate: (date: Date | number, format: string, options?: FormatDateOptions) => string;
     /**
      * Return the date parsed from string using the given format string.
@@ -40,13 +89,16 @@ export interface CustomValue<T = Locale> {
      *    return parse(date, formatStr, new Date(), { locale: eo });
      *  }
      *
-     * */
+     */
     parseDate: (dateString: string, formatString: string, referenceDate?: Date | number, options?: FormatDateOptions) => Date;
     /**
      * A Map of toast containers
      */
     toasters?: React.MutableRefObject<Map<string, ToastContainerInstance>>;
-    /** If true, the ripple effect is disabled. Affected components include: Button, Nav.Item, Pagination. */
+    /**
+     * If true, the ripple effect is disabled.
+     * Affected components include: Button, Nav.Item, Pagination.
+     */
     disableRipple?: boolean;
 }
 export interface CustomProviderProps<T = Locale> extends Partial<CustomValue<T>> {
@@ -68,7 +120,6 @@ declare const CustomContext: React.Context<CustomProviderProps<{
     } | undefined;
     Plaintext?: {
         unfilled: string;
-        /** Support right-to-left */
         notSelected: string;
         notUploaded: string;
     } | undefined;

package/esm/Form/Form.js

@@ -53,7 +53,7 @@ var Form = /*#__PURE__*/React.forwardRef(function (props, ref) {
     onError = props.onError,
     onChange = props.onChange,
     rest = _objectWithoutPropertiesLoose(props, _excluded);
-  var _useSchemaModel = useSchemaModel(formModel),
+  var _useSchemaModel = useSchemaModel(formModel, nestedField),
     getCombinedModel = _useSchemaModel.getCombinedModel,
     pushFieldRule = _useSchemaModel.pushFieldRule,
     removeFieldRule = _useSchemaModel.removeFieldRule;

package/esm/Form/hooks/useFormValidate.js

@@ -32,12 +32,29 @@ export default function useFormValidate(formError, props) {
     var formError = {};
     var errorCount = 0;
     var model = getCombinedModel();
-    Object.keys(model.getSchemaSpec()).forEach(function (key) {
-      var checkResult = model.checkForField(key, formValue || {}, checkOptions);
+    var checkField = function checkField(key, type, value, formErrorObj) {
+      var checkResult = type.check(value);
       if (checkResult.hasError === true) {
         errorCount += 1;
-        formError[key] = (checkResult === null || checkResult === void 0 ? void 0 : checkResult.errorMessage) || checkResult;
+        formErrorObj[key] = (checkResult === null || checkResult === void 0 ? void 0 : checkResult.errorMessage) || checkResult;
+      }
+
+      // Check nested object
+      if (type !== null && type !== void 0 && type.objectTypeSchemaSpec) {
+        Object.entries(type.objectTypeSchemaSpec).forEach(function (_ref) {
+          var nestedKey = _ref[0],
+            nestedType = _ref[1];
+          formErrorObj[key] = formErrorObj[key] || {
+            object: {}
+          };
+          checkField(nestedKey, nestedType, value === null || value === void 0 ? void 0 : value[nestedKey], formErrorObj[key].object);
+        });
       }
+    };
+    Object.entries(model.getSchemaSpec()).forEach(function (_ref2) {
+      var key = _ref2[0],
+        type = _ref2[1];
+      checkField(key, type, formValue[key], formError);
     });
     setFormError(formError);
     onCheck === null || onCheck === void 0 ? void 0 : onCheck(formError);

package/esm/Form/hooks/useSchemaModel.d.ts

@@ -1,7 +1,7 @@
 import type { MutableRefObject } from 'react';
 import type { CheckType, Schema } from 'schema-typed';
 export type FieldRuleType = MutableRefObject<CheckType<unknown, any> | undefined>;
-declare function useSchemaModel(formModel: Schema): {
+declare function useSchemaModel(formModel: Schema, nestedField: boolean): {
     getCombinedModel: () => Schema<any, string>;
     pushFieldRule: (name: string, fieldRule: FieldRuleType) => void;
     removeFieldRule: (name: string) => void;

package/esm/Form/hooks/useSchemaModel.js

@@ -1,7 +1,59 @@
 'use client';
-import { SchemaModel } from 'schema-typed';
+import { SchemaModel, ObjectType } from 'schema-typed';
 import { useRef, useCallback } from 'react';
-function useSchemaModel(formModel) {
+/**
+ * Convert a flat schema object to a nested schema object
+ *
+ * @example
+ *
+ * ```js
+ * const schema = {
+ *  'address.city': StringType().isRequired('City is required'),
+ *  'address.street': StringType().isRequired('Street is required')
+ * };
+ *
+ * const result = unflattenSchemaObject(schema);
+ *
+ * // result
+ * {
+ *    address: ObjectType().shape({
+ *      city: StringType().isRequired('City is required'),
+ *      street: StringType().isRequired('Street is required')
+ *    })
+ * }
+ * ```
+ */
+function unflattenSchemaObject(schema) {
+  var result = {};
+  var $type = Symbol('schema-type');
+  Object.keys(schema).forEach(function (key) {
+    if (key.includes('.')) {
+      var keys = key.split('.');
+      var lastKey = keys.pop() || '';
+      var current = result;
+      keys.forEach(function (subKey) {
+        var _ref;
+        current[subKey] = current[subKey] || (_ref = {}, _ref[$type] = 'object-type', _ref);
+        current = current[subKey];
+      });
+      current[lastKey] = schema[key];
+    } else {
+      result[key] = schema[key];
+    }
+  });
+  function convertToShape(obj) {
+    Object.keys(obj).forEach(function (key) {
+      var _obj$key;
+      if (((_obj$key = obj[key]) === null || _obj$key === void 0 ? void 0 : _obj$key[$type]) === 'object-type') {
+        delete obj[key][$type];
+        obj[key] = ObjectType().shape(convertToShape(obj[key]));
+      }
+    });
+    return obj;
+  }
+  return convertToShape(result);
+}
+function useSchemaModel(formModel, nestedField) {
   var subRulesRef = useRef([]);
   var pushFieldRule = useCallback(function (name, fieldRule) {
     subRulesRef.current.push({
@@ -24,15 +76,16 @@ function useSchemaModel(formModel) {
     if (realSubRules.length === 0) {
       return formModel;
     }
-    return SchemaModel.combine(formModel, SchemaModel(realSubRules.map(function (_ref) {
-      var _ref2;
-      var name = _ref.name,
-        fieldRule = _ref.fieldRule;
-      return _ref2 = {}, _ref2[name] = fieldRule.current, _ref2;
+    var subRuleObject = realSubRules.map(function (_ref2) {
+      var _ref3;
+      var name = _ref2.name,
+        fieldRule = _ref2.fieldRule;
+      return _ref3 = {}, _ref3[name] = fieldRule.current, _ref3;
     }).reduce(function (a, b) {
       return Object.assign(a, b);
-    }, {})));
-  }, [formModel]);
+    }, {});
+    return SchemaModel.combine(formModel, SchemaModel(nestedField ? unflattenSchemaObject(subRuleObject) : subRuleObject));
+  }, [formModel, nestedField]);
   return {
     getCombinedModel: getCombinedModel,
     pushFieldRule: pushFieldRule,

package/esm/FormControl/hooks/useField.js

@@ -6,6 +6,10 @@ import set from 'lodash/set';
 import { nameToPath } from "../utils.js";
 function getErrorMessage(error) {
   var _error$array;
+  if (typeof error === 'string') {
+    return error;
+  }
+
   /**
    * When using some components as the field, such as TagInput, and using `ArrayType().of` as the validation rule,
    * the error object won't contain the errorMessage directly. @see https://github.com/rsuite/rsuite/issues/3866

package/esm/internals/types/index.d.ts

@@ -200,3 +200,17 @@ export type CursorPosition = {
     clientTop: number;
     clientLeft: number;
 };
+export declare namespace DateFns {
+    /**
+     * FirstWeekContainsDate is used to determine which week is the first week of the year, based on what day the January, 1 is in that week.
+     * The day in that week can only be 1 (Monday) or 4 (Thursday).
+     * Please see https://en.wikipedia.org/wiki/Week#The_ISO_week_date_system for more information.
+     */
+    type FirstWeekContainsDate = 1 | 4;
+    /**
+     * The day of the week type alias.
+     * Unlike the date (the number of days since the beginning of the month), which begins with 1 and is dynamic (can go up to 28, 30, or 31), the day starts with 0 and static (always ends at 6).
+     * Look at it as an index in an array where Sunday is the first element and Saturday is the last.
+     */
+    type Day = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+}

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

@@ -29,6 +29,13 @@ export declare function map(children: React.ReactNode, func: any, context?: any)
  * @returns An array of the cloned and modified child elements.
  */
 export declare function mapCloneElement(children: React.ReactNode, func: any, context?: any): any[];
+/**
+ * Iterates over children that are in flat array form.
+ * @param children
+ * @param func
+ * @param context
+ */
+export declare function forEach(children: React.ReactNode, func: any, context?: any): void;
 /**
  * Returns the number of children.
  * @param children - The children to count.
@@ -63,6 +70,10 @@ export declare const ReactChildren: {
      * Maps over the children and applies the given function to each child.
      */
     map: typeof map;
+    /**
+     * Iterates over children that are in flat array form.
+     */
+    forEach: typeof forEach;
     /**
      * Finds the first child that satisfies the given condition.
      */

package/esm/internals/utils/ReactChildren.js

@@ -93,6 +93,23 @@ export function mapCloneElement(children, func, context) {
   }, context);
 }
 
+/**
+ * Iterates over children that are in flat array form.
+ * @param children
+ * @param func
+ * @param context
+ */
+export function forEach(children, func, context) {
+  var index = 0;
+  React.Children.forEach(flatChildren(children), function (child) {
+    if (! /*#__PURE__*/React.isValidElement(child)) {
+      return;
+    }
+    func.call(context, child, index);
+    index += 1;
+  });
+}
+
 /**
  * Returns the number of children.
  * @param children - The children to count.
@@ -148,6 +165,10 @@ export var ReactChildren = {
    * Maps over the children and applies the given function to each child.
    */
   map: map,
+  /**
+   * Iterates over children that are in flat array form.
+   */
+  forEach: forEach,
   /**
    * Finds the first child that satisfies the given condition.
    */

package/esm/locales/index.d.ts

@@ -1,4 +1,5 @@
 import defaultLocale from './default';
+import { Locale as DateFnsLocale } from 'date-fns';
 export { default as arEG } from './ar_EG';
 export { default as daDK } from './da_DK';
 export { default as deDE } from './de_DE';
@@ -29,7 +30,6 @@ type PickKeys<T> = {
 };
 export type Locale = PickKeys<typeof defaultLocale>;
 export type CommonLocale = typeof defaultLocale.common;
-export type CalendarLocale = PickKeys<typeof defaultLocale.Calendar>;
 export type PlaintextLocale = PickKeys<typeof defaultLocale.Plaintext>;
 export type PaginationLocale = PickKeys<typeof defaultLocale.Pagination>;
 export type TableLocale = CommonLocale;
@@ -41,3 +41,6 @@ export type UploaderLocale = PickKeys<typeof defaultLocale.Uploader> & CommonLoc
 export type CloseButtonLocale = PickKeys<typeof defaultLocale.CloseButton>;
 export type BreadcrumbLocale = PickKeys<typeof defaultLocale.Breadcrumb>;
 export type ToggleLocale = PickKeys<typeof defaultLocale.Toggle>;
+export interface CalendarLocale extends PickKeys<typeof defaultLocale.Calendar> {
+    dateLocale?: DateFnsLocale;
+}