rsuite 5.31.0 → 5.32.0

package/esm/Calendar/Calendar.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import Calendar from './CalendarContainer';
+import CalendarContainer from './CalendarContainer';
 import { CalendarLocale } from '../locales';
 import { RsRefForwardingComponent, WithAsProps } from '../@types/common';
 export interface CalendarProps extends WithAsProps {
@@ -24,5 +24,5 @@ export interface CalendarProps extends WithAsProps {
     /** Custom render calendar cells  */
     renderCell?: (date: Date) => React.ReactNode;
 }
-declare const CalendarPanel: RsRefForwardingComponent<typeof Calendar, CalendarProps>;
-export default CalendarPanel;
+declare const Calendar: RsRefForwardingComponent<typeof CalendarContainer, CalendarProps>;
+export default Calendar;

package/esm/Calendar/Calendar.js

@@ -3,14 +3,14 @@ import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWith
 import React, { useCallback } from 'react';
 import PropTypes from 'prop-types';
 import isSameMonth from 'date-fns/isSameMonth';
-import Calendar from './CalendarContainer';
+import CalendarContainer from './CalendarContainer';
 import Button from '../Button';
 import { FormattedDate } from '../CustomProvider';
 import { useClassNames, useCustom } from '../utils';
 import useCalendarDate from './useCalendarDate';
-var CalendarPanel = /*#__PURE__*/React.forwardRef(function (props, ref) {
+var Calendar = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var _props$as = props.as,
-      Component = _props$as === void 0 ? Calendar : _props$as,
+      Component = _props$as === void 0 ? CalendarContainer : _props$as,
       bordered = props.bordered,
       className = props.className,
       _props$classPrefix = props.classPrefix,
@@ -95,8 +95,8 @@ var CalendarPanel = /*#__PURE__*/React.forwardRef(function (props, ref) {
     onSelect: handleSelect
   }));
 });
-CalendarPanel.displayName = 'CalendarPanel';
-CalendarPanel.propTypes = {
+Calendar.displayName = 'Calendar';
+Calendar.propTypes = {
   value: PropTypes.instanceOf(Date),
   defaultValue: PropTypes.instanceOf(Date),
   isoWeek: PropTypes.bool,
@@ -109,4 +109,4 @@ CalendarPanel.propTypes = {
   onSelect: PropTypes.func,
   renderCell: PropTypes.func
 };
-export default CalendarPanel;
+export default Calendar;

package/esm/Calendar/CalendarContainer.d.ts

@@ -30,12 +30,12 @@ export interface CalendarProps extends WithAsProps, Omit<HTMLAttributes<HTMLDivE
     hideSeconds?: (second: number, date: Date) => boolean;
     /** The value that mouse hover on in range selection */
     hoverRangeValue?: [Date, Date];
-    /** Is it in the same month as today */
-    inSameMonth?: (date: Date) => boolean;
     /** ISO 8601 standard, each calendar week begins on Monday and Sunday on the seventh day */
     isoWeek?: boolean;
     /** Limit showing how many years in the future */
     limitEndYear?: number;
+    /** Limit showing how many years in the past */
+    limitStartYear?: number;
     /** Custom locale */
     locale: CalendarLocale;
     /** Callback after the date has changed */

package/esm/Calendar/CalendarContainer.js

@@ -7,8 +7,8 @@ import MonthDropdown from './MonthDropdown';
 import TimeDropdown from './TimeDropdown';
 import CalendarBody from './CalendarBody';
 import CalendarHeader from './CalendarHeader';
-import { useClassNames, composeFunctions } from '../utils';
-import { disabledTime, addMonths, shouldRenderDate, shouldRenderTime, shouldRenderMonth, setDate, isSameMonth, calendarOnlyProps, omitHideDisabledProps } from '../utils/dateUtils';
+import { useClassNames } from '../utils';
+import { disabledTime, addMonths, shouldRenderDate, shouldRenderTime, shouldRenderMonth, isSameMonth, calendarOnlyProps, omitHideDisabledProps } from '../utils/dateUtils';
 import { CalendarProvider } from './CalendarContext';
 import useCalendarState, { CalendarState } from './useCalendarState';
 import AngleUpIcon from '@rsuite/icons/legacy/AngleUp';
@@ -25,10 +25,10 @@ var CalendarContainer = /*#__PURE__*/React.forwardRef(function (props, ref) {
       disabledForward = props.disabledForward,
       format = props.format,
       hoverRangeValue = props.hoverRangeValue,
-      inSameMonth = props.inSameMonth,
       _props$isoWeek = props.isoWeek,
       isoWeek = _props$isoWeek === void 0 ? false : _props$isoWeek,
       limitEndYear = props.limitEndYear,
+      limitStartYear = props.limitStartYear,
       locale = props.locale,
       onChangeMonth = props.onChangeMonth,
       onChangeTime = props.onChangeTime,
@@ -46,7 +46,7 @@ var CalendarContainer = /*#__PURE__*/React.forwardRef(function (props, ref) {
       showMeridian = props.showMeridian,
       showWeekNumbers = props.showWeekNumbers,
       inline = props.inline,
-      rest = _objectWithoutPropertiesLoose(props, ["as", "className", "classPrefix", "dateRange", "disabledBackward", "defaultState", "disabledDate", "disabledForward", "format", "hoverRangeValue", "inSameMonth", "isoWeek", "limitEndYear", "locale", "onChangeMonth", "onChangeTime", "onMouseMove", "onMoveBackward", "onMoveForward", "onSelect", "onToggleMeridian", "onToggleMonthDropdown", "onToggleTimeDropdown", "calendarDate", "renderCell", "renderTitle", "renderToolbar", "showMeridian", "showWeekNumbers", "inline"]);
+      rest = _objectWithoutPropertiesLoose(props, ["as", "className", "classPrefix", "dateRange", "disabledBackward", "defaultState", "disabledDate", "disabledForward", "format", "hoverRangeValue", "isoWeek", "limitEndYear", "limitStartYear", "locale", "onChangeMonth", "onChangeTime", "onMouseMove", "onMoveBackward", "onMoveForward", "onSelect", "onToggleMeridian", "onToggleMonthDropdown", "onToggleTimeDropdown", "calendarDate", "renderCell", "renderTitle", "renderToolbar", "showMeridian", "showWeekNumbers", "inline"]);
 
   var _useClassNames = useClassNames(classPrefix),
       withClassPrefix = _useClassNames.withClassPrefix,
@@ -106,12 +106,8 @@ var CalendarContainer = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var showTime = calendarState === CalendarState.TIME || onlyShowTime;
   var showMonth = calendarState === CalendarState.MONTH || onlyShowMonth;
   var inSameThisMonthDate = useCallback(function (date) {
-    return composeFunctions(function (d) {
-      return setDate(d, 1);
-    }, function (d) {
-      return isSameMonth(d, date);
-    })(date);
-  }, []);
+    return isSameMonth(calendarDate, date);
+  }, [calendarDate]);
   var calendarClasses = merge(className, withClassPrefix({
     'time-view': showTime,
     'month-view': showMonth,
@@ -129,7 +125,7 @@ var CalendarContainer = /*#__PURE__*/React.forwardRef(function (props, ref) {
       disabledDate: isDisabledDate,
       format: format,
       hoverRangeValue: hoverRangeValue,
-      inSameMonth: inSameMonth !== null && inSameMonth !== void 0 ? inSameMonth : inSameThisMonthDate,
+      inSameMonth: inSameThisMonthDate,
       isoWeek: isoWeek,
       locale: locale,
       onChangeMonth: handleChangeMonth,
@@ -140,7 +136,7 @@ var CalendarContainer = /*#__PURE__*/React.forwardRef(function (props, ref) {
       showWeekNumbers: showWeekNumbers,
       inline: inline
     };
-  }, [calendarDate, dateRange, format, handleChangeMonth, hoverRangeValue, inSameMonth, inSameThisMonthDate, inline, isDisabledDate, isoWeek, locale, onChangeTime, onMouseMove, onSelect, renderCell, showWeekNumbers]);
+  }, [calendarDate, dateRange, format, handleChangeMonth, hoverRangeValue, inSameThisMonthDate, inline, isDisabledDate, isoWeek, locale, onChangeTime, onMouseMove, onSelect, renderCell, showWeekNumbers]);
   return /*#__PURE__*/React.createElement(CalendarProvider, {
     value: contextValue
   }, /*#__PURE__*/React.createElement(Component, _extends({}, omitHideDisabledProps(rest), {
@@ -164,6 +160,7 @@ var CalendarContainer = /*#__PURE__*/React.forwardRef(function (props, ref) {
   }), renderDate && /*#__PURE__*/React.createElement(CalendarBody, null), renderMonth && /*#__PURE__*/React.createElement(MonthDropdown, {
     show: showMonth,
     limitEndYear: limitEndYear,
+    limitStartYear: limitStartYear,
     disabledMonth: isDisabledDate
   }), renderTime && /*#__PURE__*/React.createElement(TimeDropdown, _extends({}, timeDropdownProps, {
     show: showTime,
@@ -186,9 +183,9 @@ CalendarContainer.propTypes = {
   hideHours: PropTypes.func,
   hideMinutes: PropTypes.func,
   hideSeconds: PropTypes.func,
-  inSameMonth: PropTypes.func,
   isoWeek: PropTypes.bool,
   limitEndYear: PropTypes.number,
+  limitStartYear: PropTypes.number,
   locale: PropTypes.object,
   onChangeMonth: PropTypes.func,
   onChangeTime: PropTypes.func,

package/esm/Calendar/MonthDropdown.js

@@ -45,7 +45,7 @@ var MonthDropdown = /*#__PURE__*/React.forwardRef(function (props, ref) {
       withClassPrefix = _useClassNames.withClassPrefix;
 
   var thisYear = DateUtils.getYear(new Date());
-  var startYear = limitStartYear ? thisYear - limitStartYear : 1900;
+  var startYear = limitStartYear ? thisYear - limitStartYear + 1 : 1900;
   var rowCount = useMemo(function () {
     var endYear = thisYear + limitEndYear;
     return endYear - startYear;

package/esm/Cascader/Cascader.d.ts

@@ -15,7 +15,7 @@ export interface CascaderProps<T = ValueType> extends FormControlPickerProps<T |
     /** When true, make the parent node selectable */
     parentSelectable?: boolean;
     /** Custom render menu */
-    renderMenu?: (items: ItemDataType[], menu: React.ReactNode, parentNode?: any, layer?: number) => React.ReactNode;
+    renderMenu?: (items: readonly ItemDataType[], menu: React.ReactNode, parentNode?: any, layer?: number) => React.ReactNode;
     /** Custom render menu items */
     renderMenuItem?: (itemLabel: React.ReactNode, item: ItemDataType) => React.ReactNode;
     /** Custom render search items */
@@ -29,7 +29,7 @@ export interface CascaderProps<T = ValueType> extends FormControlPickerProps<T |
     /** Called when searching */
     onSearch?: (searchKeyword: string, event: React.SyntheticEvent) => void;
     /** Asynchronously load the children of the tree node. */
-    getChildren?: (node: ItemDataType) => ItemDataType[] | Promise<ItemDataType[]>;
+    getChildren?: (node: ItemDataType<T>) => ItemDataType<T>[] | Promise<ItemDataType<T>[]>;
 }
 export interface CascaderComponent {
     <T>(props: CascaderProps<T> & {

package/esm/Cascader/Cascader.js

@@ -1,6 +1,7 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
-import React, { useRef, useState, useCallback, useEffect } from 'react';
+import React, { useRef, useState, useCallback, useMemo } from 'react';
+import { useSet } from 'react-use-set';
 import PropTypes from 'prop-types';
 import omit from 'lodash/omit';
 import pick from 'lodash/pick';
@@ -8,10 +9,11 @@ import isNil from 'lodash/isNil';
 import isFunction from 'lodash/isFunction';
 import shallowEqual from '../utils/shallowEqual';
 import DropdownMenu from './DropdownMenu';
-import { findNodeOfTree, flattenTree, getNodeParents } from '../utils/treeUtils';
-import { usePaths } from './utils';
-import { getSafeRegExpString, createChainedFunction, mergeRefs, useControlled, useCustom, useClassNames } from '../utils';
+import { findNodeOfTree, flattenTree } from '../utils/treeUtils';
+import { getParentMap, getPathTowardsItem, usePaths } from './utils';
+import { getSafeRegExpString, createChainedFunction, mergeRefs, useControlled, useCustom, useClassNames, useIsMounted } from '../utils';
 import { PickerToggle, PickerOverlay, SearchBar, PickerToggleTrigger, usePickerClassName, usePublicMethods, useToggleKeyDownEvent, useFocusItemValue, pickTriggerPropKeys, omitTriggerPropKeys, listPickerPropTypes } from '../Picker';
+import { useMap } from '../utils/useMap';
 var emptyArray = [];
 var Cascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var _props$as = props.as,
@@ -71,10 +73,6 @@ var Cascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
       active = _useState[0],
       setActive = _useState[1];
 
-  var _useState2 = useState(flattenTree(data, childrenKey)),
-      flattenData = _useState2[0],
-      setFlattenData = _useState2[1];
-
   var triggerRef = useRef(null);
   var overlayRef = useRef(null);
   var targetRef = useRef(null);
@@ -84,25 +82,47 @@ var Cascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
       value = _ref[0],
       setValue = _ref[1];
 
+  var isMounted = useIsMounted();
+  var loadingItemsSet = useSet();
+  var asyncChildrenMap = useMap();
+  var parentMap = useMemo(function () {
+    return getParentMap(data, function (item) {
+      var _asyncChildrenMap$get;
+
+      return (_asyncChildrenMap$get = asyncChildrenMap.get(item)) !== null && _asyncChildrenMap$get !== void 0 ? _asyncChildrenMap$get : item[childrenKey];
+    });
+  }, [asyncChildrenMap, childrenKey, data]);
+  var flattenedData = useMemo(function () {
+    return flattenTree(data, function (item) {
+      var _asyncChildrenMap$get2;
+
+      return (_asyncChildrenMap$get2 = asyncChildrenMap.get(item)) !== null && _asyncChildrenMap$get2 !== void 0 ? _asyncChildrenMap$get2 : item[childrenKey];
+    });
+  }, [asyncChildrenMap, childrenKey, data]); // The item that focus is on
+
+  var _useState2 = useState(),
+      activeItem = _useState2[0],
+      setActiveItem = _useState2[1];
+
   var _usePaths = usePaths({
     data: data,
-    valueKey: valueKey,
-    childrenKey: childrenKey,
-    value: value
+    activeItem: activeItem,
+    selectedItem: flattenedData.find(function (item) {
+      return item[valueKey] === value;
+    }),
+    getParent: function getParent(item) {
+      return parentMap.get(item);
+    },
+    getChildren: function getChildren(item) {
+      var _asyncChildrenMap$get3;
+
+      return (_asyncChildrenMap$get3 = asyncChildrenMap.get(item)) !== null && _asyncChildrenMap$get3 !== void 0 ? _asyncChildrenMap$get3 : item[childrenKey];
+    }
   }),
-      selectedPaths = _usePaths.selectedPaths,
-      valueToPaths = _usePaths.valueToPaths,
-      columnData = _usePaths.columnData,
-      addColumn = _usePaths.addColumn,
-      removeColumnByIndex = _usePaths.removeColumnByIndex,
-      setValueToPaths = _usePaths.setValueToPaths,
-      setColumnData = _usePaths.setColumnData,
-      setSelectedPaths = _usePaths.setSelectedPaths,
-      enforceUpdate = _usePaths.enforceUpdate;
-
-  useEffect(function () {
-    setFlattenData(flattenTree(data, childrenKey));
-  }, [data, childrenKey]);
+      columnsToDisplay = _usePaths.columnsToDisplay,
+      pathTowardsActiveItem = _usePaths.pathTowardsActiveItem,
+      pathTowardsSelectedItem = _usePaths.pathTowardsSelectedItem;
+
   usePublicMethods(ref, {
     triggerRef: triggerRef,
     overlayRef: overlayRef,
@@ -118,7 +138,7 @@ var Cascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
    */
 
 
-  var hasValue = valueToPaths.length > 0 || !isNil(value) && isFunction(renderValue);
+  var hasValue = pathTowardsSelectedItem.length > 0 || !isNil(value) && isFunction(renderValue);
 
   var _useClassNames = useClassNames(classPrefix),
       prefix = _useClassNames.prefix,
@@ -133,15 +153,17 @@ var Cascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
       return true;
     }
 
-    if (item.parent && someKeyword(item.parent)) {
+    var parent = parentMap.get(item);
+
+    if (parent && someKeyword(parent)) {
       return true;
     }
 
     return false;
-  }, [labelKey, searchKeyword]);
+  }, [labelKey, parentMap, searchKeyword]);
   var getSearchResult = useCallback(function (keyword) {
     var items = [];
-    var result = flattenData.filter(function (item) {
+    var result = flattenedData.filter(function (item) {
       if (!parentSelectable && item[childrenKey]) {
         return false;
       }
@@ -158,19 +180,24 @@ var Cascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
     }
 
     return items;
-  }, [childrenKey, flattenData, someKeyword, parentSelectable]); // Used to hover the focuse item  when trigger `onKeydown`
+  }, [childrenKey, flattenedData, someKeyword, parentSelectable]); // Used to hover the focuse item  when trigger `onKeydown`
 
   var _useFocusItemValue = useFocusItemValue(value, {
     rtl: rtl,
-    data: flattenData,
+    data: flattenedData,
     valueKey: valueKey,
-    defaultLayer: valueToPaths !== null && valueToPaths !== void 0 && valueToPaths.length ? valueToPaths.length - 1 : 0,
+    defaultLayer: pathTowardsSelectedItem !== null && pathTowardsSelectedItem !== void 0 && pathTowardsSelectedItem.length ? pathTowardsSelectedItem.length - 1 : 0,
     target: function target() {
       return overlayRef.current;
     },
+    getParent: function getParent(item) {
+      return parentMap.get(item);
+    },
     callback: useCallback(function (value) {
-      enforceUpdate(value, true);
-    }, [enforceUpdate])
+      setActiveItem(flattenedData.find(function (item) {
+        return item[valueKey] === value;
+      }));
+    }, [flattenedData, setActiveItem, valueKey])
   }),
       focusItemValue = _useFocusItemValue.focusItemValue,
       setFocusItemValue = _useFocusItemValue.setFocusItemValue,
@@ -216,12 +243,9 @@ var Cascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
       return;
     }
 
-    setColumnData([data]);
     setValue(null);
-    setSelectedPaths([]);
-    setValueToPaths([]);
     onChange === null || onChange === void 0 ? void 0 : onChange(null, event);
-  }, [data, disabled, onChange, setSelectedPaths, setColumnData, setValueToPaths, setValue]);
+  }, [disabled, onChange, setValue]);
   var handleMenuPressEnter = useCallback(function (event) {
     var focusItem = findNodeOfTree(data, function (item) {
       return item[valueKey] === focusItemValue;
@@ -230,10 +254,9 @@ var Cascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
 
     if (isLeafNode) {
       setValue(focusItemValue);
-      setValueToPaths(selectedPaths);
 
-      if (selectedPaths.length) {
-        setLayer(selectedPaths.length - 1);
+      if (pathTowardsActiveItem.length) {
+        setLayer(pathTowardsActiveItem.length - 1);
       }
 
       if (!shallowEqual(value, focusItemValue)) {
@@ -242,7 +265,7 @@ var Cascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
 
       handleClose();
     }
-  }, [childrenKey, data, focusItemValue, handleClose, onChange, selectedPaths, setLayer, setValue, setValueToPaths, value, valueKey]);
+  }, [childrenKey, data, focusItemValue, handleClose, onChange, pathTowardsActiveItem, setLayer, setValue, value, valueKey]);
   var onPickerKeyDown = useToggleKeyDownEvent(_extends({
     toggle: !focusItemValue || !active,
     triggerRef: triggerRef,
@@ -256,44 +279,32 @@ var Cascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
   }, rest));
 
   var handleSelect = function handleSelect(node, cascadePaths, isLeafNode, event) {
-    var _node$childrenKey, _node$childrenKey2, _triggerRef$current2;
+    var _node$childrenKey, _triggerRef$current2;
 
     onSelect === null || onSelect === void 0 ? void 0 : onSelect(node, cascadePaths, event);
-    setSelectedPaths(cascadePaths);
-    var nextValue = node[valueKey];
-    var columnIndex = cascadePaths.length; // Lazy load node's children
+    setActiveItem(node);
+    var nextValue = node[valueKey]; // Lazy load node's children
 
-    if (typeof getChildren === 'function' && ((_node$childrenKey = node[childrenKey]) === null || _node$childrenKey === void 0 ? void 0 : _node$childrenKey.length) === 0) {
-      node.loading = true;
+    if (typeof getChildren === 'function' && ((_node$childrenKey = node[childrenKey]) === null || _node$childrenKey === void 0 ? void 0 : _node$childrenKey.length) === 0 && !asyncChildrenMap.has(node)) {
+      loadingItemsSet.add(node);
       var children = getChildren(node);
 
       if (children instanceof Promise) {
         children.then(function (data) {
-          node.loading = false;
-          node[childrenKey] = data;
-
-          if (targetRef.current || inline) {
-            addColumn(data, columnIndex);
+          if (isMounted()) {
+            loadingItemsSet.delete(node);
+            asyncChildrenMap.set(node, data);
           }
         });
       } else {
-        node.loading = false;
-        node[childrenKey] = children;
-        addColumn(children, columnIndex);
+        loadingItemsSet.delete(node);
+        asyncChildrenMap.set(node, children);
       }
-    } else if ((_node$childrenKey2 = node[childrenKey]) !== null && _node$childrenKey2 !== void 0 && _node$childrenKey2.length) {
-      addColumn(node[childrenKey], columnIndex);
-    } else {
-      // Removes subsequent columns of the current column when the clicked node is a leaf node.
-      removeColumnByIndex(columnIndex);
     }
 
     if (isLeafNode) {
       // Determines whether the option is a leaf node, and if so, closes the picker.
-      handleClose(); // Update the selected path to the value path.
-      // That is, the selected path will be displayed on the button after clicking the child node.
-
-      setValueToPaths(cascadePaths);
+      handleClose();
       setValue(nextValue);
 
       if (!shallowEqual(value, nextValue)) {
@@ -308,7 +319,6 @@ var Cascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
     if (parentSelectable && !shallowEqual(value, nextValue)) {
       setValue(nextValue);
       onChange === null || onChange === void 0 ? void 0 : onChange(nextValue, event);
-      setValueToPaths(cascadePaths);
     } // Update menu position
 
 
@@ -324,16 +334,15 @@ var Cascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
     handleClose();
     setSearchKeyword('');
     setValue(nextValue);
-    setValueToPaths(nodes);
-    enforceUpdate(nextValue);
     onSelect === null || onSelect === void 0 ? void 0 : onSelect(node, nodes, event);
     onChange === null || onChange === void 0 ? void 0 : onChange(nextValue, event);
   };
 
   var renderSearchRow = function renderSearchRow(item, key) {
     var regx = new RegExp(getSafeRegExpString(searchKeyword), 'ig');
-    var nodes = getNodeParents(item);
-    nodes.push(item);
+    var nodes = getPathTowardsItem(item, function (item) {
+      return parentMap.get(item);
+    });
     var formattedNodes = nodes.map(function (node) {
       var _extends2;
 
@@ -426,12 +435,13 @@ var Cascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
       menuWidth: menuWidth,
       menuHeight: menuHeight,
       disabledItemValues: disabledItemValues,
+      loadingItemsSet: loadingItemsSet,
       valueKey: valueKey,
       labelKey: labelKey,
       childrenKey: childrenKey,
       classPrefix: 'picker-cascader-menu',
-      cascadeData: columnData,
-      cascadePaths: selectedPaths,
+      cascadeData: columnsToDisplay,
+      cascadePaths: pathTowardsActiveItem,
       activeItemValue: value // FIXME make onSelect generic
       ,
       onSelect: handleSelect,
@@ -442,15 +452,15 @@ var Cascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
 
   var selectedElement = placeholder;
 
-  if (valueToPaths.length > 0) {
+  if (pathTowardsSelectedItem.length > 0) {
     selectedElement = [];
-    valueToPaths.forEach(function (item, index) {
+    pathTowardsSelectedItem.forEach(function (item, index) {
       var key = item[valueKey] || item[labelKey];
       selectedElement.push( /*#__PURE__*/React.createElement("span", {
         key: key
       }, item[labelKey]));
 
-      if (index < valueToPaths.length - 1) {
+      if (index < pathTowardsSelectedItem.length - 1) {
         selectedElement.push( /*#__PURE__*/React.createElement("span", {
           className: "separator",
           key: key + "-separator"
@@ -460,7 +470,7 @@ var Cascader = /*#__PURE__*/React.forwardRef(function (props, ref) {
   }
 
   if (!isNil(value) && isFunction(renderValue)) {
-    selectedElement = renderValue(value, valueToPaths, selectedElement); // If renderValue returns null or undefined, hasValue is false.
+    selectedElement = renderValue(value, pathTowardsSelectedItem, selectedElement); // If renderValue returns null or undefined, hasValue is false.
 
     if (isNil(selectedElement)) {
       hasValue = false;

package/esm/Cascader/DropdownMenu.d.ts

@@ -2,19 +2,23 @@ import React from 'react';
 import PropTypes from 'prop-types';
 import { ItemDataType, WithAsProps, RsRefForwardingComponent } from '../@types/common';
 import { ValueType } from './Cascader';
+declare type SetLike<T = unknown> = {
+    has(value: T): boolean;
+};
 export interface DropdownMenuProps extends Omit<WithAsProps, 'classPrefix'> {
     classPrefix: string;
     disabledItemValues: ValueType[];
     activeItemValue?: ValueType | null;
     childrenKey: string;
-    cascadeData: ItemDataType[][];
+    cascadeData: (readonly ItemDataType[])[];
+    loadingItemsSet?: SetLike<ItemDataType>;
     cascadePaths: ItemDataType[];
     valueKey: string;
     labelKey: string;
     menuWidth?: number;
     menuHeight?: number | string;
     renderMenuItem?: (itemLabel: React.ReactNode, item: ItemDataType) => React.ReactNode;
-    renderMenu?: (items: ItemDataType[], menu: React.ReactNode, parentNode?: ItemDataType, layer?: number) => React.ReactNode;
+    renderMenu?: (items: readonly ItemDataType[], menu: React.ReactNode, parentNode?: ItemDataType, layer?: number) => React.ReactNode;
     onSelect?: (node: ItemDataType, cascadePaths: ItemDataType[], isLeafNode: boolean, event: React.MouseEvent) => void;
 }
 declare const DropdownMenu: RsRefForwardingComponent<'div', DropdownMenuProps>;

package/esm/Cascader/DropdownMenu.js

@@ -32,12 +32,13 @@ var DropdownMenu = /*#__PURE__*/React.forwardRef(function (props, ref) {
       cascadeData = _props$cascadeData === void 0 ? emptyArray : _props$cascadeData,
       _props$cascadePaths = props.cascadePaths,
       cascadePaths = _props$cascadePaths === void 0 ? emptyArray : _props$cascadePaths,
+      loadingItemsSet = props.loadingItemsSet,
       _props$labelKey = props.labelKey,
       labelKey = _props$labelKey === void 0 ? 'label' : _props$labelKey,
       renderMenu = props.renderMenu,
       renderMenuItem = props.renderMenuItem,
       onSelect = props.onSelect,
-      rest = _objectWithoutPropertiesLoose(props, ["as", "activeItemValue", "classPrefix", "className", "childrenKey", "disabledItemValues", "menuWidth", "menuHeight", "valueKey", "cascadeData", "cascadePaths", "labelKey", "renderMenu", "renderMenuItem", "onSelect"]);
+      rest = _objectWithoutPropertiesLoose(props, ["as", "activeItemValue", "classPrefix", "className", "childrenKey", "disabledItemValues", "menuWidth", "menuHeight", "valueKey", "cascadeData", "cascadePaths", "loadingItemsSet", "labelKey", "renderMenu", "renderMenuItem", "onSelect"]);
 
   var _useClassNames = useClassNames(classPrefix),
       merge = _useClassNames.merge,
@@ -91,15 +92,18 @@ var DropdownMenu = /*#__PURE__*/React.forwardRef(function (props, ref) {
   };
 
   var renderCascadeNode = function renderCascadeNode(node, index, layer, focus) {
+    var _loadingItemsSet$has;
+
     var children = node[childrenKey];
     var value = node[valueKey];
     var label = node[labelKey];
     var disabled = disabledItemValues.some(function (disabledValue) {
       return shallowEqual(disabledValue, value);
-    }); // Use `value` in keys when If `value` is string or number
+    });
+    var loading = (_loadingItemsSet$has = loadingItemsSet === null || loadingItemsSet === void 0 ? void 0 : loadingItemsSet.has(node)) !== null && _loadingItemsSet$has !== void 0 ? _loadingItemsSet$has : false; // Use `value` in keys when If `value` is string or number
 
     var onlyKey = typeof value === 'number' || typeof value === 'string' ? value : index;
-    var Icon = node.loading ? SpinnerIcon : rtl ? AngleLeftIcon : AngleRightIcon;
+    var Icon = loading ? SpinnerIcon : rtl ? AngleLeftIcon : AngleRightIcon;
     return /*#__PURE__*/React.createElement(DropdownMenuItem, {
       classPrefix: "picker-cascader-menu-item",
       as: 'li',
@@ -116,7 +120,7 @@ var DropdownMenu = /*#__PURE__*/React.forwardRef(function (props, ref) {
       }
     }, renderMenuItem ? renderMenuItem(label, node) : label, children ? /*#__PURE__*/React.createElement(Icon, {
       className: prefix('caret'),
-      spin: node.loading
+      spin: loading
     }) : null);
   };
 

package/esm/Cascader/utils.d.ts

@@ -1,23 +1,58 @@
-/// <reference types="react" />
-export declare function getColumnsAndPaths<T extends Record<string, unknown>>(data: T[], value: any, options: any): {
-    columns: T[][];
-    paths: T[];
+declare type GetColumnsAndPathsOptions<T> = {
+    getParent: (item: T) => T | undefined;
+    getChildren: (item: T) => readonly T[] | undefined;
+};
+/**
+ * Calculate columns to be displayed:
+ *
+ * - Every ancestor level of activeItem should be displayed
+ * - The level that activeItem is at should be displayed
+ * - If activeItem is a parent node, its child level should be displayed
+ *
+ * @param items
+ * @param value
+ * @param options
+ * @returns
+ */
+export declare function getColumnsAndPaths<T extends Record<string, unknown>>(items: readonly T[], pathTarget: T | undefined, options: GetColumnsAndPathsOptions<T>): {
+    columns: (readonly T[])[];
+    path: T[];
 };
 declare type UsePathsParams<T> = {
     data: T[];
-    valueKey: string;
-    childrenKey: string;
-    value: unknown;
+    /**
+     * The item where the focus is on
+     */
+    activeItem: T | undefined;
+    /**
+     * The item selected by Cascader's value
+     */
+    selectedItem: T | undefined;
+    getParent: (item: T) => T | undefined;
+    getChildren: (item: T) => readonly T[] | undefined;
 };
-export declare function usePaths<T extends Record<string, unknown>>(params: UsePathsParams<T>): {
-    enforceUpdate: (nextValue: any, isAttachChildren?: boolean) => void;
-    columnData: T[][];
-    valueToPaths: T[];
-    selectedPaths: T[];
-    setValueToPaths: import("react").Dispatch<import("react").SetStateAction<T[]>>;
-    setColumnData: import("react").Dispatch<import("react").SetStateAction<T[][]>>;
-    setSelectedPaths: import("react").Dispatch<import("react").SetStateAction<T[]>>;
-    addColumn: (column: T[], index: number) => void;
-    removeColumnByIndex: (index: number) => void;
+/**
+ * Caculate following 3 things
+ *
+ * - The columns of items to be displayed
+ * - The path towards the current focused item
+ * - The path towards the current selected item (referred to by Cascader's value)
+ *
+ * @param params
+ * @returns
+ */
+export declare function usePaths<T extends Record<string, unknown>>({ data, activeItem, selectedItem, getParent, getChildren }: UsePathsParams<T>): {
+    columnsToDisplay: (readonly T[])[];
+    pathTowardsSelectedItem: T[];
+    pathTowardsActiveItem: T[];
 };
+/**
+ * Returns a WeakMap that maps each item in `items` to its parent
+ * indicated by `getChildren` function
+ */
+export declare function getParentMap<T extends Record<string, unknown>>(items: readonly T[], getChildren: (item: T) => readonly T[] | undefined): WeakMap<T, T>;
+/**
+ * Returns an array indicating the hirearchy path from root towards `target` item
+ */
+export declare function getPathTowardsItem<T>(target: T | undefined, getParent: (item: T) => T | undefined): T[];
 export {};