rsuite 5.33.0 → 5.34.0

package/CHANGELOG.md

@@ -1,3 +1,23 @@
+# [5.34.0](https://github.com/rsuite/rsuite/compare/v5.33.1...v5.34.0) (2023-05-19)
+
+### Bug Fixes
+
+- **DatePicker:** added stack styles to datepicker styles ([#3195](https://github.com/rsuite/rsuite/issues/3195)) ([b3ed580](https://github.com/rsuite/rsuite/commit/b3ed580867db2e5205e71475c593e7d17ff04b49))
+- **SelectPicker:** prevent error when listProps.itemSize is a number ([#3193](https://github.com/rsuite/rsuite/issues/3193)) ([151df47](https://github.com/rsuite/rsuite/commit/151df474b15ab4651d4ee5777b66018e58837816))
+
+### Features
+
+- **Timeline:** add isItemActive prop ([#3198](https://github.com/rsuite/rsuite/issues/3198)) ([377930f](https://github.com/rsuite/rsuite/commit/377930f3498c59834a424417c136499866aacec2))
+
+## [5.33.1](https://github.com/rsuite/rsuite/compare/v5.33.0...v5.33.1) (2023-05-12)
+
+### Bug Fixes
+
+- **Carousel:** fix index not being reset when children change ([#3185](https://github.com/rsuite/rsuite/issues/3185)) ([3afb746](https://github.com/rsuite/rsuite/commit/3afb7460f5d12b34eb0e7944fa9f5a461b663028))
+- **CheckPicker:** avoid mutating data when groupBy is specified ([#3173](https://github.com/rsuite/rsuite/issues/3173)) ([1a9805a](https://github.com/rsuite/rsuite/commit/1a9805a00cffcb8e527fbeb1df3a346da9a707f0))
+- **DatePicker:** fix defaultValue not changing month on calendar ([#3183](https://github.com/rsuite/rsuite/issues/3183)) ([b0a2b5f](https://github.com/rsuite/rsuite/commit/b0a2b5f5cfe6ea94c1c13f8e9451c5d60f7f5b80))
+- **pickers:** fix keyboard events still responding when readOnly ([#3184](https://github.com/rsuite/rsuite/issues/3184)) ([56e7563](https://github.com/rsuite/rsuite/commit/56e7563b2035be767f5ed8429cd8c3622708abe8))
+
 # [5.33.0](https://github.com/rsuite/rsuite/compare/v5.32.0...v5.33.0) (2023-04-28)
 
 ### Features

package/DatePicker/styles/index.less

@@ -2,6 +2,7 @@
 @import '../../styles/mixins/listbox';
 @import '../../Button/styles/mixin';
 @import '../../Picker/styles/mixin';
+@import '../../Stack/styles/index';
 @import 'mixin';
 
 // DatePicker Picker

package/Timeline/styles/index.less

@@ -42,7 +42,7 @@
     }
   }
 
-  &-item-last &-item-dot::before {
+  &-item-active &-item-dot::before {
     background-color: var(--rs-timeline-indicator-active-bg);
   }
 

package/cjs/Carousel/Carousel.js

@@ -59,13 +59,23 @@ var Carousel = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
 
   var _useControlled = (0, _utils.useControlled)(activeIndexProp, defaultActiveIndex),
       activeIndex = _useControlled[0],
-      setActiveIndex = _useControlled[1];
+      setActiveIndex = _useControlled[1],
+      isControlled = _useControlled[2];
 
   var _useState = (0, _react.useState)(0),
       lastIndex = _useState[0],
       setLastIndex = _useState[1];
 
-  var rootRef = (0, _react.useRef)(null); // Set a timer for automatic playback.
+  var rootRef = (0, _react.useRef)(null);
+  (0, _utils.useUpdateEffect)(function () {
+    // When the index is controlled, the index is not updated when the number of children changes.
+    if (isControlled) {
+      return;
+    } // Reset the index when the number of children changes.
+
+
+    setActiveIndex(0);
+  }, [children, isControlled]); // Set a timer for automatic playback.
   // `autoplay` needs to be cast to boolean type to avoid undefined parameters.
 
   var _useTimeout = (0, _utils.useTimeout)(function () {

package/cjs/CheckPicker/CheckPicker.js

@@ -35,6 +35,8 @@ var _treeUtils = require("../utils/treeUtils");
 
 var _utils = require("../utils");
 
+var _getDataGroupBy = require("../utils/getDataGroupBy");
+
 var _Picker = require("../Picker");
 
 var _templateObject;
@@ -323,7 +325,7 @@ var CheckPicker = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
 
 
     if (groupBy) {
-      items = (0, _utils.getDataGroupBy)(items, groupBy, sort);
+      items = (0, _getDataGroupBy.getDataGroupBy)(items, groupBy, sort);
     } else if (typeof sort === 'function') {
       items = items.sort(sort(false));
     }
@@ -342,8 +344,10 @@ var CheckPicker = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
       dropdownMenuItemAs: _Picker.DropdownMenuCheckItem,
       activeItemValues: value,
       focusItemValue: focusItemValue,
-      data: [].concat(filteredStickyItems, items),
+      data: [].concat(filteredStickyItems, items) // `group` is redundant so long as `groupBy` exists
+      ,
       group: !(0, _isUndefined.default)(groupBy),
+      groupBy: groupBy,
       onSelect: handleItemSelect,
       onGroupTitleClick: onGroupTitleClick,
       virtualized: virtualized

package/cjs/DatePicker/DatePicker.js

@@ -117,7 +117,7 @@ var DatePicker = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
       value = _useControlled[0],
       setValue = _useControlled[1];
 
-  var _useCalendarDate = (0, _useCalendarDate2.default)(valueProp, calendarDefaultDate),
+  var _useCalendarDate = (0, _useCalendarDate2.default)(value, calendarDefaultDate),
       calendarDate = _useCalendarDate.calendarDate,
       setCalendarDate = _useCalendarDate.setCalendarDate,
       resetCalendarDate = _useCalendarDate.resetCalendarDate;

package/cjs/InputPicker/InputPicker.js

@@ -43,6 +43,8 @@ var _Plaintext = _interopRequireDefault(require("../Plaintext"));
 
 var _utils = require("../utils");
 
+var _getDataGroupBy = require("../utils/getDataGroupBy");
+
 var _Picker = require("../Picker");
 
 var _Tag = _interopRequireDefault(require("../Tag"));
@@ -629,7 +631,7 @@ var InputPicker = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
 
 
     if (groupBy) {
-      items = (0, _utils.getDataGroupBy)(items, groupBy, sort);
+      items = (0, _getDataGroupBy.getDataGroupBy)(items, groupBy, sort);
     } else if (typeof sort === 'function') {
       items = items.sort(sort(false));
     }
@@ -653,8 +655,11 @@ var InputPicker = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
       activeItemValues: multi ? value : [value],
       focusItemValue: focusItemValue,
       maxHeight: menuMaxHeight,
-      data: items,
+      data: items // FIXME-Doma
+      // `group` is redundant so long as `groupBy` exists
+      ,
       group: !(0, _isUndefined.default)(groupBy),
+      groupBy: groupBy,
       onSelect: multi ? handleCheckTag : handleSelectItem // fixme don't use any
       ,
       renderMenuGroup: renderMenuGroup,

package/cjs/MultiCascader/MultiCascader.js

@@ -249,6 +249,7 @@ var MultiCascader = /*#__PURE__*/_react.default.forwardRef(function (props, ref)
     (_triggerRef$current = triggerRef.current) === null || _triggerRef$current === void 0 ? void 0 : (_triggerRef$current$u = _triggerRef$current.updatePosition) === null || _triggerRef$current$u === void 0 ? void 0 : _triggerRef$current$u.call(_triggerRef$current);
   }, [onSelect, getChildren, childrenKey, inline, addFlattenData, addColumn, removeColumnByIndex]);
   var handleCheck = (0, _react.useCallback)(function (node, event, checked) {
+    console.log('handleCheck');
     var nodeValue = node[valueKey];
     var nextValue = [];
 

package/cjs/Picker/DropdownMenu.d.ts

@@ -6,6 +6,7 @@ export interface DropdownMenuProps<Multiple = false> extends StandardProps, Omit
     classPrefix: string;
     data?: ItemDataType[];
     group?: boolean;
+    groupBy?: string;
     disabledItemValues?: any[];
     activeItemValues?: any[];
     focusItemValue?: any;

package/cjs/Picker/DropdownMenu.js

@@ -11,6 +11,8 @@ var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends")
 
 var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
 
+var _get2 = _interopRequireDefault(require("lodash/get"));
+
 var _react = _interopRequireWildcard(require("react"));
 
 var _propTypes = _interopRequireDefault(require("prop-types"));
@@ -47,6 +49,7 @@ var DropdownMenu = /*#__PURE__*/_react.default.forwardRef(function (props, ref)
   var _props$data = props.data,
       data = _props$data === void 0 ? [] : _props$data,
       group = props.group,
+      groupBy = props.groupBy,
       _props$maxHeight = props.maxHeight,
       maxHeight = _props$maxHeight === void 0 ? 320 : _props$maxHeight,
       _props$activeItemValu = props.activeItemValues,
@@ -75,7 +78,7 @@ var DropdownMenu = /*#__PURE__*/_react.default.forwardRef(function (props, ref)
       renderMenuItem = props.renderMenuItem,
       onGroupTitleClick = props.onGroupTitleClick,
       onSelect = props.onSelect,
-      rest = (0, _objectWithoutPropertiesLoose2.default)(props, ["data", "group", "maxHeight", "activeItemValues", "disabledItemValues", "classPrefix", "valueKey", "labelKey", "virtualized", "listProps", "listRef", "className", "style", "focusItemValue", "dropdownMenuItemClassPrefix", "dropdownMenuItemAs", "rowHeight", "rowGroupHeight", "renderMenuGroup", "renderMenuItem", "onGroupTitleClick", "onSelect"]);
+      rest = (0, _objectWithoutPropertiesLoose2.default)(props, ["data", "group", "groupBy", "maxHeight", "activeItemValues", "disabledItemValues", "classPrefix", "valueKey", "labelKey", "virtualized", "listProps", "listRef", "className", "style", "focusItemValue", "dropdownMenuItemClassPrefix", "dropdownMenuItemAs", "rowHeight", "rowGroupHeight", "renderMenuGroup", "renderMenuItem", "onGroupTitleClick", "onSelect"]);
 
   var _useClassNames = (0, _utils.useClassNames)(classPrefix),
       withClassPrefix = _useClassNames.withClassPrefix,
@@ -205,11 +208,21 @@ var DropdownMenu = /*#__PURE__*/_react.default.forwardRef(function (props, ref)
   };
 
   var filteredItems = group ? data.filter(function (item) {
-    return !(foldedGroupKeys !== null && foldedGroupKeys !== void 0 && foldedGroupKeys.some(function (key) {
-      var _item$parent;
-
-      return key === ((_item$parent = item.parent) === null || _item$parent === void 0 ? void 0 : _item$parent[_getDataGroupBy.KEY_GROUP_TITLE]);
-    }));
+    var _item$parent;
+
+    // Display group title items
+    if (item[_getDataGroupBy.KEY_GROUP]) return true; // Display items under the unfolded group
+    // FIXME-Doma
+    // `groupBy` is bound to be string when `group` is true
+    // because `group` is actually redundant as a prop
+    // It could simply be derived from `groupBy` value
+
+    var groupValue = (0, _get2.default)(item, groupBy, '') || ( // FIXME-Doma
+    // Usage of `item.parent` is strongly discouraged
+    // It's only here for legacy support
+    // Remove once `item.parent` is completely removed across related components
+    (_item$parent = item.parent) === null || _item$parent === void 0 ? void 0 : _item$parent[_getDataGroupBy.KEY_GROUP_TITLE]);
+    return !foldedGroupKeys.includes(groupValue);
   }) : data;
   var rowCount = filteredItems.length;
   (0, _utils.useMount)(function () {

package/cjs/Picker/utils.d.ts

@@ -73,6 +73,8 @@ export interface ToggleKeyDownEventProps {
     overlayRef?: React.RefObject<any>;
     searchInputRef?: React.RefObject<any>;
     active?: boolean;
+    readOnly?: boolean;
+    disabled?: boolean;
     onExit?: (event: any) => void;
     onKeyDown?: (event: any) => void;
     onOpen?: () => void;

package/cjs/Picker/utils.js

@@ -433,6 +433,8 @@ var useToggleKeyDownEvent = function useToggleKeyDownEvent(props) {
       overlayRef = props.overlayRef,
       searchInputRef = props.searchInputRef,
       active = props.active,
+      readOnly = props.readOnly,
+      disabled = props.disabled,
       onExit = props.onExit,
       onOpen = props.onOpen,
       onClose = props.onClose,
@@ -461,6 +463,11 @@ var useToggleKeyDownEvent = function useToggleKeyDownEvent(props) {
     handleOpen();
   }, [active, handleOpen, handleClose]);
   var onToggle = (0, _react.useCallback)(function (event) {
+    // Keyboard events should not be processed when readOnly and disabled are set.
+    if (readOnly || disabled) {
+      return;
+    }
+
     if (event.target === (targetRef === null || targetRef === void 0 ? void 0 : targetRef.current)) {
       // enter
       if (toggle && event.key === _utils.KEY_VALUES.ENTER) {
@@ -510,7 +517,7 @@ var useToggleKeyDownEvent = function useToggleKeyDownEvent(props) {
 
 
     onKeyDown === null || onKeyDown === void 0 ? void 0 : onKeyDown(event);
-  }, [handleClose, handleToggleDropdown, overlayRef, onExit, onKeyDown, onMenuKeyDown, onMenuPressBackspace, onMenuPressEnter, toggle, targetRef, searchInputRef]);
+  }, [readOnly, disabled, targetRef, overlayRef, onKeyDown, toggle, handleToggleDropdown, onExit, onMenuKeyDown, searchInputRef, onMenuPressEnter, onMenuPressBackspace, handleClose]);
   return onToggle;
 };
 

package/cjs/SelectPicker/SelectPicker.js

@@ -29,6 +29,8 @@ var _omit = _interopRequireDefault(require("lodash/omit"));
 
 var _utils = require("../utils");
 
+var _getDataGroupBy = require("../utils/getDataGroupBy");
+
 var _Picker = require("../Picker");
 
 var _templateObject;
@@ -258,7 +260,7 @@ var SelectPicker = /*#__PURE__*/_react.default.forwardRef(function (props, ref)
     var items = filteredData; // Create a tree structure data when set `groupBy`
 
     if (groupBy) {
-      items = (0, _utils.getDataGroupBy)(items, groupBy, sort);
+      items = (0, _getDataGroupBy.getDataGroupBy)(items, groupBy, sort);
     } else if (typeof sort === 'function') {
       items = items.sort(sort(false));
     }
@@ -278,8 +280,11 @@ var SelectPicker = /*#__PURE__*/_react.default.forwardRef(function (props, ref)
       dropdownMenuItemAs: _Picker.DropdownMenuItem,
       activeItemValues: [value],
       focusItemValue: focusItemValue,
-      data: items,
+      data: items // FIXME-Doma
+      // `group` is redundant so long as `groupBy` exists
+      ,
       group: !(0, _isUndefined.default)(groupBy),
+      groupBy: groupBy,
       onSelect: handleItemSelect,
       onGroupTitleClick: onGroupTitleClick,
       virtualized: virtualized

package/cjs/Timeline/Timeline.d.ts

@@ -8,9 +8,18 @@ export interface TimelineProps extends WithAsProps {
     align?: 'left' | 'right' | 'alternate';
     /** Timeline endless **/
     endless?: boolean;
+    /**
+     * Whether an item is active (with highlighted dot).
+     *
+     * @default
+     * The last item is marked active.
+     */
+    isItemActive?: (index: number, totalItemsCount: number) => boolean;
 }
 interface TimelineComponent extends RsRefForwardingComponent<'div', TimelineProps> {
     Item: typeof TimelineItem;
+    ACTIVE_FIRST: (index: number, totalItemsCount: number) => boolean;
+    ACTIVE_LAST: (index: number, totalItemsCount: number) => boolean;
 }
 declare const Timeline: TimelineComponent;
 export default Timeline;

package/cjs/Timeline/Timeline.js

@@ -29,7 +29,9 @@ var Timeline = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
       _props$align = props.align,
       align = _props$align === void 0 ? 'left' : _props$align,
       endless = props.endless,
-      rest = (0, _objectWithoutPropertiesLoose2.default)(props, ["children", "as", "classPrefix", "className", "align", "endless"]);
+      _props$isItemActive = props.isItemActive,
+      isItemActive = _props$isItemActive === void 0 ? Timeline.ACTIVE_LAST : _props$isItemActive,
+      rest = (0, _objectWithoutPropertiesLoose2.default)(props, ["children", "as", "classPrefix", "className", "align", "endless", "isItemActive"]);
 
   var _useClassNames = (0, _utils.useClassNames)(classPrefix),
       merge = _useClassNames.merge,
@@ -52,11 +54,20 @@ var Timeline = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
   }), _utils.ReactChildren.mapCloneElement(children, function (_child, index) {
     return {
       last: index + 1 === count,
+      INTERNAL_active: isItemActive(index, count),
       align: align
     };
   }));
 });
 
+Timeline.ACTIVE_FIRST = function (index) {
+  return index === 0;
+};
+
+Timeline.ACTIVE_LAST = function (index, totalItemsCount) {
+  return index === totalItemsCount - 1;
+};
+
 Timeline.Item = _TimelineItem.default;
 Timeline.displayName = 'Timeline';
 Timeline.propTypes = {

package/cjs/Timeline/TimelineItem.d.ts

@@ -1,7 +1,18 @@
 import React from 'react';
 import { WithAsProps, RsRefForwardingComponent } from '../@types/common';
 export interface TimelineItemProps extends WithAsProps {
-    /** Whether the last item */
+    /**
+     * Whether the last item
+     *
+     * @internal
+     * This props is supposed to be used only by Timeline component internally
+     * User should never rely on this prop
+     *
+     * @deprecated
+     * This prop was used to indicate whether an item is the last item so that it gets highlighted.
+     * Now we can specify whether an item should be highlighted individually.
+     * Use {@link INTERNAL_active} instead
+     */
     last?: boolean;
     /** Customizing the Timeline item */
     dot?: React.ReactNode;
@@ -11,6 +22,12 @@ export interface TimelineItemProps extends WithAsProps {
     as?: React.ElementType;
     /** Customized time of timeline  **/
     time?: React.ReactNode;
+    /**
+     * @internal
+     * This props is supposed to be used only by Timeline component internally
+     * User should never rely on this prop
+     */
+    INTERNAL_active?: boolean;
 }
 declare const TimelineItem: RsRefForwardingComponent<'div', TimelineItemProps>;
 export default TimelineItem;

package/cjs/Timeline/TimelineItem.js

@@ -21,11 +21,12 @@ var TimelineItem = /*#__PURE__*/_react.default.forwardRef(function (props, ref)
       children = props.children,
       _props$classPrefix = props.classPrefix,
       classPrefix = _props$classPrefix === void 0 ? 'timeline-item' : _props$classPrefix,
-      last = props.last,
+      DEPRECATED_last = props.last,
       className = props.className,
       dot = props.dot,
       time = props.time,
-      rest = (0, _objectWithoutPropertiesLoose2.default)(props, ["as", "children", "classPrefix", "last", "className", "dot", "time"]);
+      INTERNAL_active = props.INTERNAL_active,
+      rest = (0, _objectWithoutPropertiesLoose2.default)(props, ["as", "children", "classPrefix", "last", "className", "dot", "time", "INTERNAL_active"]);
 
   var _useClassNames = (0, _utils.useClassNames)(classPrefix),
       merge = _useClassNames.merge,
@@ -33,7 +34,8 @@ var TimelineItem = /*#__PURE__*/_react.default.forwardRef(function (props, ref)
       prefix = _useClassNames.prefix;
 
   var classes = merge(className, withClassPrefix({
-    last: last
+    last: DEPRECATED_last,
+    active: INTERNAL_active
   }));
   return /*#__PURE__*/_react.default.createElement(Component, (0, _extends2.default)({}, rest, {
     ref: ref,

package/cjs/Windowing/List.js

@@ -21,7 +21,8 @@ var List = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
   var rowHeight = props.rowHeight,
       _props$as = props.as,
       Component = _props$as === void 0 ? _reactWindow.VariableSizeList : _props$as,
-      rest = (0, _objectWithoutPropertiesLoose2.default)(props, ["rowHeight", "as"]);
+      itemSizeProp = props.itemSize,
+      rest = (0, _objectWithoutPropertiesLoose2.default)(props, ["rowHeight", "as", "itemSize"]);
   var listRef = (0, _react.useRef)(null);
 
   var _useCustom = (0, _utils.useCustom)(),
@@ -56,7 +57,15 @@ var List = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
       index: index
     }) : rowHeight || 0;
   }, [rowHeight]);
-  var compatibleProps = (0, _extends2.default)({}, rest);
+  var itemSize = (0, _react.useMemo)(function () {
+    if (typeof itemSizeProp === 'function') return itemSizeProp;
+    return function () {
+      return itemSizeProp;
+    };
+  }, [itemSizeProp]);
+  var compatibleProps = (0, _extends2.default)({
+    itemSize: itemSize
+  }, rest);
 
   if (rowHeight) {
     compatibleProps.itemSize = Component === _reactWindow.VariableSizeList ? setRowHeight : rowHeight;

package/cjs/utils/getDataGroupBy.d.ts

@@ -1,3 +1,6 @@
 export declare const KEY_GROUP: string | symbol;
 export declare const KEY_GROUP_TITLE = "groupTitle";
-export default function getDataGroupBy(data: any[] | undefined, key: string, sort?: any): any[];
+export declare function getDataGroupBy<T>(data: readonly T[], key: string, sort?: (isGroup: boolean) => <T>(a: T, b: T) => number): (T | {
+    groupTitle: string;
+    children: T[];
+})[];

package/cjs/utils/getDataGroupBy.js

@@ -3,10 +3,10 @@
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 
 exports.__esModule = true;
-exports.default = getDataGroupBy;
+exports.getDataGroupBy = getDataGroupBy;
 exports.KEY_GROUP_TITLE = exports.KEY_GROUP = void 0;
 
-var _get2 = _interopRequireDefault(require("lodash/get"));
+var _groupBy2 = _interopRequireDefault(require("lodash/groupBy"));
 
 var _treeUtils = require("../utils/treeUtils");
 
@@ -17,26 +17,9 @@ var KEY_GROUP_TITLE = 'groupTitle';
 exports.KEY_GROUP_TITLE = KEY_GROUP_TITLE;
 
 function getDataGroupBy(data, key, sort) {
-  if (data === void 0) {
-    data = [];
-  }
-
-  var tempData = {};
+  var groupMap = (0, _groupBy2.default)(data, key);
   var isSort = typeof sort === 'function';
-  data.forEach(function (item) {
-    // this will allow getting data using dot notation
-    // i.e groupBy="country.name" as country will be a nested object
-    // to the item and the name will be nested key to the country object
-    // can be used with values in arrays, i.e groupBy="addresses.0.country.name"
-    var groupByValue = (0, _get2.default)(item, key, '');
-
-    if (!tempData[groupByValue]) {
-      tempData[groupByValue] = [];
-    }
-
-    tempData[groupByValue].push(item);
-  });
-  var nextData = Object.entries(tempData).map(function (_ref) {
+  var groups = Object.entries(groupMap).map(function (_ref) {
     var _ref2;
 
     var groupTitle = _ref[0],
@@ -47,8 +30,13 @@ function getDataGroupBy(data, key, sort) {
   });
 
   if (isSort) {
-    nextData = nextData.sort(sort(true));
-  }
+    groups.sort(sort(true));
+  } // Use DFS traverse
+  // Because I want the result to be [group, child, child, group, child, child]
+  // rather than [group, group, child, child, child, child]
+
 
-  return (0, _treeUtils.UNSAFE_flattenTree)(nextData);
+  return (0, _treeUtils.flattenTree)(groups, function (group) {
+    return group.children;
+  }, _treeUtils.WalkTreeStrategy.DFS);
 }

package/cjs/utils/index.d.ts

@@ -12,7 +12,6 @@ export { default as ReactChildren } from './ReactChildren';
 export { default as tplTransform } from './tplTransform';
 export { default as ajaxUpload } from './ajaxUpload';
 export { default as previewFile } from './previewFile';
-export { default as getDataGroupBy } from './getDataGroupBy';
 export { default as clone } from './clone';
 export { default as placementPolyfill } from './placementPolyfill';
 export { default as getDOMNode } from './getDOMNode';

package/cjs/utils/index.js

@@ -14,7 +14,6 @@ var _exportNames = {
   tplTransform: true,
   ajaxUpload: true,
   previewFile: true,
-  getDataGroupBy: true,
   clone: true,
   placementPolyfill: true,
   getDOMNode: true,
@@ -49,7 +48,7 @@ var _exportNames = {
   DateUtils: true,
   TypeChecker: true
 };
-exports.TypeChecker = exports.DateUtils = exports.globalKey = exports.getClassNamePrefix = exports.defaultClassPrefix = exports.useMount = exports.useIsMounted = exports.useUpdateEffect = exports.useWillUnmount = exports.useUpdatedRef = exports.useEventCallback = exports.stringToObject = exports.getSafeRegExpString = exports.useRootClose = exports.useControlled = exports.useTimeout = exports.createComponent = exports.usePortal = exports.useCustom = exports.useElementResize = exports.useEventListener = exports.useClassNames = exports.render = exports.appendTooltip = exports.scrollTopAnimation = exports.reactToString = exports.composeFunctions = exports.shallowEqualArray = exports.shallowEqual = exports.mergeRefs = exports.getDOMNode = exports.placementPolyfill = exports.clone = exports.getDataGroupBy = exports.previewFile = exports.ajaxUpload = exports.tplTransform = exports.ReactChildren = exports.isOneOf = exports.createChainedFunction = exports.prefix = exports.guid = void 0;
+exports.TypeChecker = exports.DateUtils = exports.globalKey = exports.getClassNamePrefix = exports.defaultClassPrefix = exports.useMount = exports.useIsMounted = exports.useUpdateEffect = exports.useWillUnmount = exports.useUpdatedRef = exports.useEventCallback = exports.stringToObject = exports.getSafeRegExpString = exports.useRootClose = exports.useControlled = exports.useTimeout = exports.createComponent = exports.usePortal = exports.useCustom = exports.useElementResize = exports.useEventListener = exports.useClassNames = exports.render = exports.appendTooltip = exports.scrollTopAnimation = exports.reactToString = exports.composeFunctions = exports.shallowEqualArray = exports.shallowEqual = exports.mergeRefs = exports.getDOMNode = exports.placementPolyfill = exports.clone = exports.previewFile = exports.ajaxUpload = exports.tplTransform = exports.ReactChildren = exports.isOneOf = exports.createChainedFunction = exports.prefix = exports.guid = void 0;
 
 var _BrowserDetection = require("./BrowserDetection");
 
@@ -130,10 +129,6 @@ var _previewFile = _interopRequireDefault(require("./previewFile"));
 
 exports.previewFile = _previewFile.default;
 
-var _getDataGroupBy = _interopRequireDefault(require("./getDataGroupBy"));
-
-exports.getDataGroupBy = _getDataGroupBy.default;
-
 var _clone = _interopRequireDefault(require("./clone"));
 
 exports.clone = _clone.default;

package/cjs/utils/treeUtils.d.ts

@@ -21,7 +21,13 @@ export declare function shouldShowNodeByParentExpanded<T>(expandItemValues?: T[]
  *             Use {@link flattenTree} instead.
  */
 export declare function UNSAFE_flattenTree<TItem>(tree: TItem[], childrenKey?: string, executor?: (node: any, index: number) => any): TItem[];
-export declare function flattenTree<T>(rootNodes: readonly T[], getChildren: (node: T) => readonly T[] | undefined): T[];
+export declare enum WalkTreeStrategy {
+    DFS = 0,
+    BFS = 1
+}
+export declare function flattenTree<T>(rootNodes: readonly T[], getChildren: (node: T) => readonly T[] | undefined, walkStrategy?: WalkTreeStrategy): T[];
+export declare function walkTreeBfs<T>(rootNodes: readonly T[], getChildren: (node: T) => readonly T[] | undefined, callback: (node: T) => void): void;
+export declare function walkTreeDfs<T>(rootNodes: readonly T[], getChildren: (node: T) => readonly T[] | undefined, callback: (node: T) => void): void;
 /**
  * get all ancestor nodes of given node
  * @param {*} node
@@ -293,6 +299,6 @@ export declare function getParentMap<T extends Record<string, unknown>>(items: r
  */
 export declare function getKeyParentMap<T extends Record<string, unknown>, K = React.Key>(items: readonly T[], getKey: (item: T) => K, getChildren: (item: T) => readonly T[] | undefined): Map<K, T>;
 /**
- * Returns an array indicating the hirearchy path from root towards `target` item
+ * Returns an array indicating the hierarchy path from root towards `target` item
  */
 export declare function getPathTowardsItem<T>(target: T | undefined, getParent: (item: T) => T | undefined): T[];