rsuite 5.18.1-beta.4 → 5.19.0

package/esm/Overlay/OverlayTrigger.d.ts

@@ -63,11 +63,11 @@ export interface OverlayTriggerProps extends StandardProps, AnimationEventProps
     /** Whether speaker to follow the cursor */
     followCursor?: boolean;
 }
-export interface OverlayTriggerHandle {
+export interface OverlayTriggerInstance {
     root: HTMLElement | undefined;
     updatePosition: () => void;
     open: (delay?: number) => void;
     close: (delay?: number) => void;
 }
-declare const OverlayTrigger: React.ForwardRefExoticComponent<OverlayTriggerProps & React.RefAttributes<OverlayTriggerHandle>>;
+declare const OverlayTrigger: React.ForwardRefExoticComponent<OverlayTriggerProps & React.RefAttributes<OverlayTriggerInstance>>;
 export default OverlayTrigger;

package/esm/Picker/DropdownMenu.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
 import PropTypes from 'prop-types';
-import { ListProps, ListHandle } from '../Windowing';
+import { ListProps } from './VirtualizedList';
 import { StandardProps, ItemDataType } from '../@types/common';
 export interface DropdownMenuProps<Multiple = false> extends StandardProps, Omit<React.HTMLAttributes<HTMLDivElement>, 'onSelect'> {
     classPrefix: string;
@@ -20,7 +20,6 @@ export interface DropdownMenuProps<Multiple = false> extends StandardProps, Omit
     rowGroupHeight?: number;
     virtualized?: boolean;
     listProps?: Partial<ListProps>;
-    listRef?: React.Ref<ListHandle>;
     /** Custom selected option */
     renderMenuItem?: (itemLabel: React.ReactNode, item: any) => React.ReactNode;
     renderMenuGroup?: (title: React.ReactNode, item: any) => React.ReactNode;

package/esm/Picker/DropdownMenu.js

@@ -13,9 +13,9 @@ import getPosition from 'dom-lib/getPosition';
 import scrollTop from 'dom-lib/scrollTop';
 import getHeight from 'dom-lib/getHeight';
 import classNames from 'classnames';
-import { List, AutoSizer, VariableSizeList } from '../Windowing';
+import { List, AutoSizer } from './VirtualizedList';
 import shallowEqual from '../utils/shallowEqual';
-import { mergeRefs, useClassNames, useMount } from '../utils';
+import { mergeRefs, useClassNames } from '../utils';
 import DropdownMenuGroup from './DropdownMenuGroup';
 import { KEY_GROUP, KEY_GROUP_TITLE } from '../utils/getDataGroupBy';
 var DropdownMenu = /*#__PURE__*/React.forwardRef(function (props, ref) {
@@ -36,7 +36,6 @@ var DropdownMenu = /*#__PURE__*/React.forwardRef(function (props, ref) {
       labelKey = _props$labelKey === void 0 ? 'label' : _props$labelKey,
       virtualized = props.virtualized,
       listProps = props.listProps,
-      virtualizedListRef = props.listRef,
       className = props.className,
       style = props.style,
       focusItemValue = props.focusItemValue,
@@ -50,7 +49,7 @@ var DropdownMenu = /*#__PURE__*/React.forwardRef(function (props, ref) {
       renderMenuItem = props.renderMenuItem,
       onGroupTitleClick = props.onGroupTitleClick,
       onSelect = props.onSelect,
-      rest = _objectWithoutPropertiesLoose(props, ["data", "group", "maxHeight", "activeItemValues", "disabledItemValues", "classPrefix", "valueKey", "labelKey", "virtualized", "listProps", "listRef", "className", "style", "focusItemValue", "dropdownMenuItemClassPrefix", "dropdownMenuItemAs", "rowHeight", "rowGroupHeight", "renderMenuGroup", "renderMenuItem", "onGroupTitleClick", "onSelect"]);
+      rest = _objectWithoutPropertiesLoose(props, ["data", "group", "maxHeight", "activeItemValues", "disabledItemValues", "classPrefix", "valueKey", "labelKey", "virtualized", "listProps", "className", "style", "focusItemValue", "dropdownMenuItemClassPrefix", "dropdownMenuItemAs", "rowHeight", "rowGroupHeight", "renderMenuGroup", "renderMenuItem", "onGroupTitleClick", "onSelect"]);
 
   var _useClassNames = useClassNames(classPrefix),
       withClassPrefix = _useClassNames.withClassPrefix,
@@ -60,8 +59,12 @@ var DropdownMenu = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var classes = merge(className, withClassPrefix('items', {
     grouped: group
   }));
+
+  var styles = _extends({}, style, {
+    maxHeight: maxHeight
+  });
+
   var menuBodyContainerRef = useRef(null);
-  var listRef = useRef(null);
 
   var _useState = useState([]),
       foldedGroupKeys = _useState[0],
@@ -83,7 +86,8 @@ var DropdownMenu = /*#__PURE__*/React.forwardRef(function (props, ref) {
     onSelect === null || onSelect === void 0 ? void 0 : onSelect(value, item, event, checked);
   }, [onSelect]);
 
-  var getRowHeight = function getRowHeight(list, index) {
+  var getRowHeight = function getRowHeight(list, _ref) {
+    var index = _ref.index;
     var item = list[index];
 
     if (group && item[KEY_GROUP] && index !== 0) {
@@ -121,13 +125,10 @@ var DropdownMenu = /*#__PURE__*/React.forwardRef(function (props, ref) {
     }
   }, [focusItemValue, menuBodyContainerRef, prefix]);
 
-  var renderItem = function renderItem(_ref) {
-    var _ref$index = _ref.index,
-        index = _ref$index === void 0 ? 0 : _ref$index,
-        style = _ref.style,
-        data = _ref.data,
-        itemData = _ref.item;
-    var item = itemData || data[index];
+  var renderItem = function renderItem(list, _ref2) {
+    var index = _ref2.index,
+        style = _ref2.style;
+    var item = list[index];
     var value = item[valueKey];
     var label = item[labelKey];
 
@@ -186,45 +187,40 @@ var DropdownMenu = /*#__PURE__*/React.forwardRef(function (props, ref) {
       return key === ((_item$parent = item.parent) === null || _item$parent === void 0 ? void 0 : _item$parent[KEY_GROUP_TITLE]);
     }));
   }) : data;
-  var rowCount = filteredItems.length;
-  useMount(function () {
-    var _listRef$current, _listRef$current$scro;
+  var rowCount = filteredItems.length; // Check whether the height of the data exceeds the height of the container.
 
-    var itemIndex = findIndex(filteredItems, function (item) {
-      return item[valueKey] === (activeItemValues === null || activeItemValues === void 0 ? void 0 : activeItemValues[0]);
-    });
-    (_listRef$current = listRef.current) === null || _listRef$current === void 0 ? void 0 : (_listRef$current$scro = _listRef$current.scrollToItem) === null || _listRef$current$scro === void 0 ? void 0 : _listRef$current$scro.call(_listRef$current, itemIndex);
-  });
+  var useVirtualized = virtualized && rowCount * rowHeight > maxHeight;
   return /*#__PURE__*/React.createElement("div", _extends({
-    role: "listbox"
+    role: !useVirtualized ? 'listbox' : undefined
   }, rest, {
     className: classes,
     ref: mergeRefs(menuBodyContainerRef, ref),
-    style: _extends({}, style, {
-      maxHeight: maxHeight
-    })
-  }), virtualized ? /*#__PURE__*/React.createElement(AutoSizer, {
+    style: styles
+  }), useVirtualized ? /*#__PURE__*/React.createElement(AutoSizer, {
     defaultHeight: maxHeight,
     style: {
       width: 'auto',
       height: 'auto'
     }
-  }, function (_ref2) {
-    var height = _ref2.height,
-        width = _ref2.width;
+  }, function (_ref3) {
+    var height = _ref3.height,
+        width = _ref3.width;
     return /*#__PURE__*/React.createElement(List, _extends({
-      as: VariableSizeList,
-      ref: mergeRefs(listRef, virtualizedListRef),
+      role: "listbox",
+      containerRole: '',
+      "aria-readonly": undefined,
       width: width,
       height: height || maxHeight,
-      itemCount: rowCount,
-      itemData: filteredItems,
-      itemSize: getRowHeight.bind(_this, filteredItems)
-    }, listProps), renderItem);
-  }) : filteredItems.map(function (item, index) {
-    return renderItem({
-      index: index,
-      item: item
+      scrollToIndex: findIndex(data, function (item) {
+        return item[valueKey] === (activeItemValues === null || activeItemValues === void 0 ? void 0 : activeItemValues[0]);
+      }),
+      rowCount: rowCount,
+      rowHeight: getRowHeight.bind(_this, filteredItems),
+      rowRenderer: renderItem.bind(null, filteredItems)
+    }, listProps));
+  }) : filteredItems.map(function (_item, index) {
+    return renderItem(filteredItems, {
+      index: index
     });
   }));
 });

package/esm/Picker/PickerOverlay.d.ts

@@ -1,11 +1,11 @@
 import React from 'react';
 import { WithAsProps, RsRefForwardingComponent } from '../@types/common';
-import { OverlayTriggerHandle } from '../Picker';
+import { OverlayTriggerInstance } from '../Picker';
 export interface PickerOverlayProps extends WithAsProps {
     placement?: string;
     autoWidth?: boolean;
     children?: React.ReactNode;
-    target?: React.RefObject<OverlayTriggerHandle>;
+    target?: React.RefObject<OverlayTriggerInstance>;
     onKeyDown?: (event: React.KeyboardEvent) => void;
 }
 declare const PickerOverlay: RsRefForwardingComponent<'div', PickerOverlayProps>;

package/esm/Picker/PickerToggle.js

@@ -200,7 +200,7 @@ var PickerToggle = /*#__PURE__*/React.forwardRef(function (props, ref) {
     "aria-placeholder": typeof children === 'string' ? children : undefined
   }, label && /*#__PURE__*/React.createElement("span", {
     className: prefix('label')
-  }, label, ": "), children) : null, showCleanButton && /*#__PURE__*/React.createElement(CloseButton, {
+  }, label), children) : null, showCleanButton && /*#__PURE__*/React.createElement(CloseButton, {
     className: prefix(_templateObject || (_templateObject = _taggedTemplateLiteralLoose(["clean"]))),
     tabIndex: -1,
     locale: {

package/esm/Picker/PickerToggleTrigger.d.ts

@@ -1,8 +1,8 @@
 import React from 'react';
-import { OverlayTriggerHandle, OverlayTriggerProps, OverlayTriggerType } from '../Overlay/OverlayTrigger';
+import { OverlayTriggerInstance, OverlayTriggerProps, OverlayTriggerType } from '../Overlay/OverlayTrigger';
 import { PositionChildProps } from '../Overlay/Position';
 import { TypeAttributes, AnimationEventProps } from '../@types/common';
-export type { OverlayTriggerHandle, PositionChildProps };
+export type { OverlayTriggerInstance, PositionChildProps };
 export interface PickerToggleTriggerProps extends Omit<AnimationEventProps, 'onEntering' | 'onExiting'>, Pick<OverlayTriggerProps, 'speaker'> {
     placement?: TypeAttributes.Placement;
     pickerProps: any;

package/esm/Picker/VirtualizedList.d.ts

@@ -0,0 +1,37 @@
+import React from 'react';
+import { ListProps, ListRowProps } from 'react-virtualized/dist/commonjs/List';
+import { AutoSizerProps } from 'react-virtualized/dist/commonjs/AutoSizer';
+import type { Alignment } from 'react-virtualized';
+export interface ListInstance {
+    /**
+     * Forcefully re-render the inner Grid component.
+     */
+    forceUpdateGrid(): void;
+    /**
+     * Gets offset for a given row and alignment.
+     */
+    getOffsetForRow(params: {
+        alignment?: Alignment;
+        index?: number;
+    }): number;
+    /**
+     * Pre-measure all rows in a List.
+     */
+    measureAllRows(): void;
+    /**
+     * Recompute row heights and offsets after the specified index (defaults to 0).
+     */
+    recomputeRowHeights(index?: number): void;
+    /**
+     * Scroll to the specified offset. Useful for animating position changes.
+     */
+    scrollToPosition(scrollTop?: number): void;
+    /**
+     * Ensure row is visible. This method can be used to safely scroll back to a cell
+     * that a user has scrolled away from even if it was previously scrolled to.
+     */
+    scrollToRow(index?: number): void;
+}
+export type { ListProps, AutoSizerProps, ListRowProps };
+export declare const List: React.ComponentType<ListProps>;
+export declare const AutoSizer: React.ComponentType<AutoSizerProps>;

package/esm/Picker/VirtualizedList.js

@@ -0,0 +1,4 @@
+import VirtualizedList from 'react-virtualized/dist/commonjs/List';
+import VirtualizedAutoSizer from 'react-virtualized/dist/commonjs/AutoSizer';
+export var List = VirtualizedList;
+export var AutoSizer = VirtualizedAutoSizer;

package/esm/Picker/index.d.ts

@@ -1,6 +1,6 @@
-import { pickTriggerPropKeys, omitTriggerPropKeys, OverlayTriggerHandle, PositionChildProps } from './PickerToggleTrigger';
+import { pickTriggerPropKeys, omitTriggerPropKeys, OverlayTriggerInstance, PositionChildProps } from './PickerToggleTrigger';
 import { PickerToggleProps } from './PickerToggle';
-import { PickerHandle, PickerComponent } from './types';
+import { PickerInstance, PickerComponent } from './types';
 export { default as DropdownMenu } from './DropdownMenu';
 export { default as DropdownMenuCheckItem } from './DropdownMenuCheckItem';
 export { default as DropdownMenuGroup } from './DropdownMenuGroup';
@@ -11,6 +11,6 @@ export { default as PickerToggleTrigger } from './PickerToggleTrigger';
 export { default as SearchBar } from './SearchBar';
 export { default as SelectedElement } from './SelectedElement';
 export { pickTriggerPropKeys, omitTriggerPropKeys };
-export type { OverlayTriggerHandle, PositionChildProps, PickerHandle, PickerComponent, PickerToggleProps };
+export type { OverlayTriggerInstance, PositionChildProps, PickerInstance, PickerComponent, PickerToggleProps };
 export * from './utils';
 export * from './propTypes';

package/esm/Picker/types.d.ts

@@ -1,15 +1,13 @@
 /// <reference types="react" />
 import { RsRefForwardingComponent } from '../@types/common';
-import type { ListHandle } from '../Windowing';
-export interface PickerHandle {
-    root: HTMLElement | null;
-    list?: ListHandle;
-    overlay?: HTMLElement | null;
-    target?: HTMLElement | null;
+export interface PickerInstance {
+    root?: Element;
+    overlay?: Element;
+    target?: HTMLElement;
     updatePosition?: () => void;
     open?: () => void;
     close?: () => void;
 }
 export declare type PickerComponent<P> = RsRefForwardingComponent<'div', P & {
-    ref?: React.Ref<PickerHandle>;
+    ref?: React.Ref<PickerInstance>;
 }>;

package/esm/Picker/utils.d.ts

@@ -1,14 +1,14 @@
 import React from 'react';
-import { OverlayTriggerHandle } from './PickerToggleTrigger';
+import { OverlayTriggerInstance } from './PickerToggleTrigger';
 import { TypeAttributes, ItemDataType } from '../@types/common';
-import type { ListHandle } from '../Windowing';
-export interface NodeKeys {
+import { ListInstance } from './VirtualizedList';
+interface NodeKeys {
     valueKey: string;
     childrenKey: string;
 }
 export declare function createConcatChildrenFunction<T = any>(node: any, nodeValue?: any, nodeKeys?: NodeKeys): (data: T[], children: T[]) => T[];
 export declare function shouldDisplay(label: React.ReactNode, searchKeyword: string): boolean;
-export interface PickerClassNameProps {
+interface PickerClassNameProps {
     name?: string;
     classPrefix: string;
     className?: string;
@@ -27,7 +27,7 @@ export interface PickerClassNameProps {
  * The className of the assembled Toggle is on the Picker.
  */
 export declare function usePickerClassName(props: PickerClassNameProps): [string, string[]];
-export interface EventsProps {
+interface EventsProps {
     down?: React.KeyboardEventHandler;
     up?: React.KeyboardEventHandler;
     enter?: React.KeyboardEventHandler;
@@ -42,7 +42,7 @@ export interface EventsProps {
  * @param events Event callback functions
  */
 export declare function onMenuKeyDown(event: React.KeyboardEvent, events: EventsProps): void;
-export interface FocusItemValueProps {
+interface FocusItemValueProps {
     target: HTMLElement | null | (() => HTMLElement | null);
     data?: any[];
     valueKey?: string;
@@ -65,7 +65,7 @@ export declare const useFocusItemValue: <T>(defaultFocusItemValue: T | null | un
     setKeys: React.Dispatch<React.SetStateAction<any[]>>;
     onKeyDown: (event: any) => void;
 };
-export interface ToggleKeyDownEventProps {
+interface ToggleKeyDownEventProps {
     toggle?: boolean;
     triggerRef: React.RefObject<any>;
     targetRef: React.RefObject<any>;
@@ -86,7 +86,7 @@ export interface ToggleKeyDownEventProps {
  * @param props
  */
 export declare const useToggleKeyDownEvent: (props: ToggleKeyDownEventProps) => (event: React.KeyboardEvent) => void;
-export interface SearchProps {
+interface SearchProps {
     labelKey: string;
     data: ItemDataType[];
     searchBy?: (keyword: any, label: any, item: any) => boolean;
@@ -104,15 +104,16 @@ export declare function useSearch(props: SearchProps): {
     checkShouldDisplay: (item: ItemDataType, keyword?: string) => boolean;
     handleSearch: (searchKeyword: string, event: React.SyntheticEvent) => void;
 };
-export interface PickerDependentParameters {
-    triggerRef?: React.RefObject<OverlayTriggerHandle>;
+interface PickerDependentParameters {
+    triggerRef?: React.RefObject<OverlayTriggerInstance>;
     rootRef?: React.RefObject<HTMLElement>;
     overlayRef?: React.RefObject<HTMLElement>;
     targetRef?: React.RefObject<HTMLElement>;
-    listRef?: React.RefObject<ListHandle>;
+    listRef?: React.RefObject<ListInstance>;
     inline?: boolean;
 }
 /**
  * A hook of the exposed method of Picker
  */
 export declare function usePublicMethods(ref: any, parmas: PickerDependentParameters): void;
+export {};

package/esm/Picker/utils.js

@@ -522,10 +522,6 @@ export function usePublicMethods(ref, parmas) {
       get overlay() {
         var _overlayRef$current;
 
-        if (!(overlayRef !== null && overlayRef !== void 0 && overlayRef.current)) {
-          throw new Error('The overlay is not found. Please confirm whether the picker is open.');
-        }
-
         return (_overlayRef$current = overlayRef === null || overlayRef === void 0 ? void 0 : overlayRef.current) !== null && _overlayRef$current !== void 0 ? _overlayRef$current : null;
       },
 

package/esm/SelectPicker/SelectPicker.d.ts

@@ -1,7 +1,7 @@
 import React, { Ref } from 'react';
 import { PickerLocale } from '../locales';
-import { PickerHandle, PickerToggleProps } from '../Picker';
-import { ListProps } from '../Windowing';
+import { PickerInstance, PickerToggleProps } from '../Picker';
+import { ListProps } from '../Picker/VirtualizedList';
 import { FormControlPickerProps, ItemDataType } from '../@types/common';
 export interface SelectProps<T> {
     /** Set group condition key in data */
@@ -11,7 +11,8 @@ export interface SelectProps<T> {
     /** Whether using virtualized list */
     virtualized?: boolean;
     /**
-     * Virtualized List Props
+     * List-related properties in `react-virtualized`
+     * https://github.com/bvaughn/react-virtualized/blob/master/docs/List.md#prop-types
      */
     listProps?: Partial<ListProps>;
     /** Custom search rules. */
@@ -49,7 +50,7 @@ export interface SelectPickerProps<T> extends Omit<FormControlPickerProps<T, Pic
 }
 export interface SelectPickerComponent {
     <T>(props: SelectPickerProps<T> & {
-        ref?: Ref<PickerHandle>;
+        ref?: Ref<PickerInstance>;
     }): JSX.Element | null;
     displayName?: string;
     propTypes?: React.WeakValidationMap<SelectPickerProps<any>>;

package/esm/SelectPicker/SelectPicker.js

@@ -74,7 +74,6 @@ var SelectPicker = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var targetRef = useRef(null);
   var overlayRef = useRef(null);
   var searchInputRef = useRef(null);
-  var listRef = useRef(null);
 
   var _useCustom = useCustom('Picker', overrideLocale),
       locale = _useCustom.locale;
@@ -194,8 +193,7 @@ var SelectPicker = /*#__PURE__*/React.forwardRef(function (props, ref) {
   usePublicMethods(ref, {
     triggerRef: triggerRef,
     overlayRef: overlayRef,
-    targetRef: targetRef,
-    listRef: listRef
+    targetRef: targetRef
   }); // Find active `MenuItem` by `value`
 
   var activeItem = data.find(function (item) {
@@ -248,7 +246,6 @@ var SelectPicker = /*#__PURE__*/React.forwardRef(function (props, ref) {
     var menu = items.length ? /*#__PURE__*/React.createElement(DropdownMenu, {
       id: id ? id + "-listbox" : undefined,
       listProps: listProps,
-      listRef: listRef,
       disabledItemValues: disabledItemValues,
       valueKey: valueKey,
       labelKey: labelKey,

package/esm/Sidenav/SidenavItem.js

@@ -52,8 +52,12 @@ var SidenavItem = /*#__PURE__*/React.forwardRef(function (props, ref) {
       prefix = _useClassNames.prefix;
 
   var selected = activeProp !== null && activeProp !== void 0 ? activeProp : !isNil(eventKey) && shallowEqual(activeKey, eventKey);
+  var whisperRef = React.useRef(null);
   var handleClick = useCallback(function (event) {
+    var _whisperRef$current;
+
     if (disabled) return;
+    (_whisperRef$current = whisperRef.current) === null || _whisperRef$current === void 0 ? void 0 : _whisperRef$current.close();
     onSelect === null || onSelect === void 0 ? void 0 : onSelect(eventKey, event);
     onSelectFromNav === null || onSelectFromNav === void 0 ? void 0 : onSelectFromNav(eventKey, event);
     onClick === null || onClick === void 0 ? void 0 : onClick(event);
@@ -63,7 +67,8 @@ var SidenavItem = /*#__PURE__*/React.forwardRef(function (props, ref) {
     return /*#__PURE__*/React.createElement(Whisper, {
       trigger: "hover",
       speaker: /*#__PURE__*/React.createElement(Tooltip, null, tooltip),
-      placement: "right"
+      placement: "right",
+      ref: whisperRef
     }, function (triggerProps, triggerRef) {
       return /*#__PURE__*/React.createElement(MenuItem, {
         selected: selected,

package/esm/Stack/Stack.d.ts

@@ -1,5 +1,6 @@
 import React from 'react';
-import { WithAsProps } from '../@types/common';
+import { RsRefForwardingComponent, WithAsProps } from '../@types/common';
+import StackItem from './StackItem';
 export interface StackProps extends WithAsProps {
     /**
      * The direction of the children in the stack.
@@ -22,5 +23,8 @@ export interface StackProps extends WithAsProps {
      */
     wrap?: boolean;
 }
-declare const Stack: React.ForwardRefExoticComponent<StackProps & React.RefAttributes<HTMLDivElement>>;
+export interface StackComponent extends RsRefForwardingComponent<'div', StackProps> {
+    Item: typeof StackItem;
+}
+declare const Stack: StackComponent;
 export default Stack;

package/esm/Stack/Stack.js

@@ -3,6 +3,7 @@ import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWith
 import React from 'react';
 import PropTypes from 'prop-types';
 import { useClassNames, useCustom, isSupportFlexGap } from '../utils';
+import StackItem from './StackItem';
 var Stack = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var _itemStyles;
 
@@ -32,7 +33,6 @@ var Stack = /*#__PURE__*/React.forwardRef(function (props, ref) {
 
   var classes = merge(className, withClassPrefix());
   var isSupportGridGap = isSupportFlexGap();
-  var count = React.Children.count(children);
   var gridGap = Array.isArray(spacing) ? spacing : [spacing, 0];
   var itemStyles = (_itemStyles = {}, _itemStyles[rtl ? 'marginLeft' : 'marginRight'] = gridGap[0], _itemStyles.marginBottom = gridGap[1], _itemStyles);
 
@@ -43,19 +43,30 @@ var Stack = /*#__PURE__*/React.forwardRef(function (props, ref) {
     flexWrap: wrap ? 'wrap' : undefined,
     gap: isSupportGridGap ? spacing : undefined
   }, style);
+  /*
+   * toArray remove undefined, null and boolean
+   */
 
+
+  var filterChildren = React.Children.toArray(children);
+  var count = filterChildren.length;
   return /*#__PURE__*/React.createElement(Component, _extends({}, rest, {
     ref: ref,
     className: classes,
     style: styles
-  }), React.Children.map(children, function (child, index) {
-    var childNode = /*#__PURE__*/React.createElement("div", {
+  }), React.Children.map(filterChildren, function (child, index) {
+    var childNode = child.type !== StackItem ? /*#__PURE__*/React.createElement(StackItem, {
+      key: index,
       className: prefix('item'),
       style: !isSupportGridGap ? itemStyles : undefined
-    }, child);
+    }, child) : /*#__PURE__*/React.cloneElement(child, {
+      className: merge(prefix('item'), child.props.className),
+      style: !isSupportGridGap ? _extends({}, itemStyles, child.props.style) : child.props.style
+    });
     return [childNode, index < count - 1 ? divider : null];
   }));
 });
+Stack.Item = StackItem;
 Stack.displayName = 'Stack';
 Stack.propTypes = {
   className: PropTypes.string,

package/esm/Stack/StackItem.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+import PropTypes from 'prop-types';
+import { WithAsProps } from '../@types/common';
+export interface StackItemProps extends WithAsProps {
+    alignSelf?: 'flex-start' | 'flex-end' | 'center' | 'baseline' | 'stretch';
+    flex?: React.CSSProperties['flex'];
+    grow?: React.CSSProperties['flexGrow'];
+    shrink?: React.CSSProperties['flexShrink'];
+    basis?: React.CSSProperties['flexBasis'];
+    order?: React.CSSProperties['order'];
+}
+declare function StackItem(props: StackItemProps): JSX.Element;
+declare namespace StackItem {
+    var displayName: string;
+    var propTypes: {
+        className: PropTypes.Requireable<string>;
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        alignSelf: PropTypes.Requireable<string>;
+        flex: PropTypes.Requireable<string | number>;
+        grow: PropTypes.Requireable<number>;
+        shrink: PropTypes.Requireable<number>;
+        order: PropTypes.Requireable<number>;
+        basis: PropTypes.Requireable<string>;
+    };
+}
+export default StackItem;