rsuite 5.69.0 → 5.70.1

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/CascadeTree/CascadeTree.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", "data", "defaultValue", "className", "classPrefix", "childrenKey", "valueKey", "labelKey", "value", "disabledItemValues", "columnWidth", "columnHeight", "searchable", "renderTreeNode", "renderColumn", "onSelect", "onSearch", "onChange", "getChildren"];
+var _excluded = ["as", "data", "defaultValue", "className", "classPrefix", "childrenKey", "valueKey", "labelKey", "locale", "value", "disabledItemValues", "columnWidth", "columnHeight", "searchable", "renderTreeNode", "renderColumn", "onSelect", "onSearch", "onChange", "getChildren"];
 import React, { useCallback, useMemo } from 'react';
 import { getParentMap } from "../internals/Tree/utils/index.js";
 import { flattenTree } from "../Tree/utils/index.js";
@@ -29,6 +29,7 @@ var CascadeTree = /*#__PURE__*/React.forwardRef(function (props, ref) {
     valueKey = _props$valueKey === void 0 ? 'value' : _props$valueKey,
     _props$labelKey = props.labelKey,
     labelKey = _props$labelKey === void 0 ? 'label' : _props$labelKey,
+    locale = props.locale,
     valueProp = props.value,
     _props$disabledItemVa = props.disabledItemValues,
     disabledItemValues = _props$disabledItemVa === void 0 ? [] : _props$disabledItemVa,
@@ -145,6 +146,7 @@ var CascadeTree = /*#__PURE__*/React.forwardRef(function (props, ref) {
     searchKeyword: searchKeyword,
     valueKey: valueKey,
     labelKey: labelKey,
+    locale: locale,
     parentMap: parentMap,
     disabledItemValues: disabledItemValues,
     onSelect: handleSearchRowSelect,

package/esm/CascadeTree/SearchView.d.ts

@@ -8,6 +8,7 @@ interface SearchViewProps<T> extends WithAsProps {
     data: ItemDataType<T>[];
     focusItemValue?: T | null;
     disabledItemValues: any[];
+    locale?: Record<string, string>;
     renderSearchItem?: (label: React.ReactNode, items: ItemDataType<T>[]) => React.ReactNode;
     onSelect: (item: ItemDataType<T>, items: ItemDataType<T>[], event: React.MouseEvent) => void;
     onSearch: (value: string, event: React.ChangeEvent<HTMLInputElement>) => void;

package/esm/CascadeTree/SearchView.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", "classPrefix", "className", "searchKeyword", "labelKey", "valueKey", "parentMap", "data", "focusItemValue", "disabledItemValues", "inputRef", "renderSearchItem", "onSearch", "onSelect"];
+var _excluded = ["as", "classPrefix", "className", "searchKeyword", "labelKey", "locale", "valueKey", "parentMap", "data", "focusItemValue", "disabledItemValues", "inputRef", "renderSearchItem", "onSearch", "onSelect"];
 import React from 'react';
 import { useClassNames, useCustom } from "../internals/hooks/index.js";
 import { getPathTowardsItem } from "../internals/Tree/utils/index.js";
@@ -15,6 +15,7 @@ function SearchView(props) {
     className = props.className,
     searchKeyword = props.searchKeyword,
     labelKey = props.labelKey,
+    overrideLocale = props.locale,
     valueKey = props.valueKey,
     parentMap = props.parentMap,
     data = props.data,
@@ -31,7 +32,7 @@ function SearchView(props) {
     withClassPrefix = _useClassNames.withClassPrefix,
     rootPrefix = _useClassNames.rootPrefix;
   var classes = merge(className, withClassPrefix());
-  var _useCustom = useCustom('Picker'),
+  var _useCustom = useCustom('Picker', overrideLocale),
     locale = _useCustom.locale;
   var renderSearchRow = function renderSearchRow(item, key) {
     var items = getPathTowardsItem(item, function (item) {

package/esm/CascadeTree/types.d.ts

@@ -10,7 +10,7 @@ export interface CascadeColumn<T> {
     parentItem?: ItemDataType<T>;
     layer?: number;
 }
-export interface CascadeTreeProps<T, V = T> extends WithAsProps, DataProps<ItemDataType<T>> {
+export interface CascadeTreeProps<T, V = T, L = any> extends WithAsProps, DataProps<ItemDataType<T>> {
     /**
      * Initial value
      */
@@ -35,6 +35,10 @@ export interface CascadeTreeProps<T, V = T> extends WithAsProps, DataProps<ItemD
      * Whether dispaly search input box
      */
     searchable?: boolean;
+    /**
+     * A collection of localized strings.
+     */
+    locale?: Partial<L>;
     /**
      * Custom render columns
      */

package/esm/Cascader/Cascader.d.ts

@@ -3,7 +3,7 @@ import type { CascadeTreeProps } from '../CascadeTree/types';
 import { PickerLocale } from '../locales';
 import { PickerHandle, PickerToggleProps } from '../internals/Picker';
 import { ItemDataType, DataItemValue, FormControlPickerProps } from '../internals/types';
-export interface CascaderProps<T = DataItemValue> extends FormControlPickerProps<T, PickerLocale, ItemDataType<T>>, CascadeTreeProps<T>, Pick<PickerToggleProps, 'label' | 'caretAs' | 'loading'> {
+export interface CascaderProps<T = DataItemValue> extends FormControlPickerProps<T, PickerLocale, ItemDataType<T>>, CascadeTreeProps<T, T, PickerLocale>, Pick<PickerToggleProps, 'label' | 'caretAs' | 'loading'> {
     /**
      * The panel is displayed directly when the component is initialized
      * @deprecated Use CascadeTree instead

package/esm/Cascader/Cascader.js

@@ -329,6 +329,7 @@ var Cascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
       searchKeyword: searchKeyword,
       valueKey: valueKey,
       labelKey: labelKey,
+      locale: locale,
       parentMap: parentMap,
       disabledItemValues: disabledItemValues,
       focusItemValue: focusItemValue,

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/MultiCascadeTree/MultiCascadeTree.d.ts

@@ -5,5 +5,5 @@ import type { MultiCascadeTreeProps } from './types';
  * The `MultiCascadeTree` component is used to select multiple values from cascading options.
  * @see https://rsuitejs.com/components/multi-cascade-tree/
  */
-declare const MultiCascadeTree: React.ForwardRefExoticComponent<MultiCascadeTreeProps<DataItemValue, DataItemValue[]> & React.RefAttributes<unknown>>;
+declare const MultiCascadeTree: React.ForwardRefExoticComponent<MultiCascadeTreeProps<DataItemValue, DataItemValue[], any> & React.RefAttributes<unknown>>;
 export default MultiCascadeTree;

package/esm/MultiCascadeTree/MultiCascadeTree.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", "data", "defaultValue", "className", "classPrefix", "value", "valueKey", "labelKey", "childrenKey", "disabledItemValues", "cascade", "columnWidth", "columnHeight", "searchable", "uncheckableItemValues", "getChildren", "renderColumn", "renderTreeNode", "onSelect", "onCheck", "onChange", "onSearch"];
+var _excluded = ["as", "data", "defaultValue", "className", "classPrefix", "value", "valueKey", "labelKey", "locale", "childrenKey", "disabledItemValues", "cascade", "columnWidth", "columnHeight", "searchable", "uncheckableItemValues", "getChildren", "renderColumn", "renderTreeNode", "onSelect", "onCheck", "onChange", "onSearch"];
 import React from 'react';
 import TreeView from "./TreeView.js";
 import { useCascadeValue, useSelect, useSearch } from "./hooks/index.js";
@@ -27,6 +27,7 @@ var MultiCascadeTree = /*#__PURE__*/React.forwardRef(function (props, ref) {
     valueKey = _props$valueKey === void 0 ? 'value' : _props$valueKey,
     _props$labelKey = props.labelKey,
     labelKey = _props$labelKey === void 0 ? 'label' : _props$labelKey,
+    locale = props.locale,
     _props$childrenKey = props.childrenKey,
     childrenKey = _props$childrenKey === void 0 ? 'children' : _props$childrenKey,
     _props$disabledItemVa = props.disabledItemValues,
@@ -94,11 +95,13 @@ var MultiCascadeTree = /*#__PURE__*/React.forwardRef(function (props, ref) {
     ref: ref,
     className: classes
   }, rest), searchable && /*#__PURE__*/React.createElement(SearchView, {
+    cascade: cascade,
     data: items,
     value: value,
     searchKeyword: searchKeyword,
     valueKey: valueKey,
     labelKey: labelKey,
+    locale: locale,
     childrenKey: childrenKey,
     disabledItemValues: disabledItemValues,
     onCheck: handleCheck,

package/esm/MultiCascadeTree/SearchView.d.ts

@@ -9,6 +9,7 @@ interface SearchViewProps<T> extends WithAsProps {
     data: ItemDataType<T>[];
     disabledItemValues: any[];
     cascade?: boolean;
+    locale?: Record<string, string>;
     onSearch: (value: string, event: React.ChangeEvent<HTMLInputElement>) => void;
     onCheck: (item: ItemDataType<T>, event: React.SyntheticEvent, checked: boolean) => void;
     inputRef?: React.RefObject<HTMLInputElement>;

package/esm/MultiCascadeTree/SearchView.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", "classPrefix", "className", "searchKeyword", "childrenKey", "labelKey", "valueKey", "value", "data", "disabledItemValues", "inputRef", "cascade", "onSearch", "onCheck"];
+var _excluded = ["as", "classPrefix", "className", "searchKeyword", "childrenKey", "labelKey", "valueKey", "value", "data", "disabledItemValues", "inputRef", "cascade", "locale", "onSearch", "onCheck"];
 import React from 'react';
 import { useClassNames, useCustom } from "../internals/hooks/index.js";
 import SearchBox from "../internals/SearchBox/index.js";
@@ -23,6 +23,7 @@ function SearchView(props) {
     disabledItemValues = props.disabledItemValues,
     inputRef = props.inputRef,
     cascade = props.cascade,
+    overrideLocale = props.locale,
     onSearch = props.onSearch,
     onCheck = props.onCheck,
     rest = _objectWithoutPropertiesLoose(props, _excluded);
@@ -32,7 +33,7 @@ function SearchView(props) {
     withClassPrefix = _useClassNames.withClassPrefix,
     rootPrefix = _useClassNames.rootPrefix;
   var classes = merge(className, withClassPrefix());
-  var _useCustom = useCustom('Picker'),
+  var _useCustom = useCustom('Picker', overrideLocale),
     locale = _useCustom.locale;
   var renderSearchRow = function renderSearchRow(item, key) {
     var _extends2;

package/esm/MultiCascadeTree/types.d.ts

@@ -6,7 +6,7 @@ export interface ItemKeys {
     labelKey: string;
     childrenKey: string;
 }
-export interface MultiCascadeTreeProps<T, V = T[]> extends WithAsProps, CascadeTreeProps<T, V> {
+export interface MultiCascadeTreeProps<T, V = T[], L = any> extends WithAsProps, CascadeTreeProps<T, V> {
     /**
      * When set to true, selecting a child node will update the state of the parent node.
      */
@@ -19,6 +19,10 @@ export interface MultiCascadeTreeProps<T, V = T[]> extends WithAsProps, CascadeT
      * Set the option value for the check box not to be rendered
      */
     uncheckableItemValues?: T[];
+    /**
+     * A collection of localized strings.
+     */
+    locale?: Partial<L>;
     /**
      * Called after the checkbox state changes.
      */

package/esm/MultiCascader/MultiCascader.d.ts

@@ -3,7 +3,7 @@ import { PickerLocale } from '../locales';
 import { PickerComponent, PickerToggleProps } from '../internals/Picker';
 import { FormControlPickerProps, ItemDataType, DataItemValue } from '../internals/types';
 import type { MultiCascadeTreeProps } from '../MultiCascadeTree';
-export interface MultiCascaderProps<T extends DataItemValue> extends FormControlPickerProps<T[], PickerLocale, ItemDataType<T>, T>, MultiCascadeTreeProps<T, T[]>, Pick<PickerToggleProps, 'loading'> {
+export interface MultiCascaderProps<T extends DataItemValue> extends FormControlPickerProps<T[], PickerLocale, ItemDataType<T>, T>, MultiCascadeTreeProps<T, T[], PickerLocale>, Pick<PickerToggleProps, 'loading'> {
     /**
      * A picker that can be counted
      */

package/esm/MultiCascader/MultiCascader.js

@@ -267,6 +267,8 @@ var MultiCascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
       target: trigger,
       onKeyDown: onPickerKeyDown
     }, searchable && /*#__PURE__*/React.createElement(SearchView, {
+      locale: locale,
+      cascade: cascade,
       data: items,
       value: value,
       searchKeyword: searchKeyword,
@@ -274,6 +276,7 @@ var MultiCascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
       labelKey: labelKey,
       childrenKey: childrenKey,
       disabledItemValues: disabledItemValues,
+      inputRef: searchInput,
       onCheck: handleCheck,
       onSearch: handleSearch
     }), !searchKeyword && /*#__PURE__*/React.createElement(TreeView, {

package/esm/TreePicker/TreePicker.js

@@ -216,6 +216,7 @@ var TreePicker = /*#__PURE__*/React.forwardRef(function (props, ref) {
     searchable: searchable,
     searchKeyword: searchKeyword,
     searchBy: searchBy,
+    searchInputRef: searchInput,
     loadingNodeValues: loadingNodeValues,
     flattenedNodes: flattenedNodes,
     listProps: listProps,