rsuite 5.12.0 → 5.14.0

package/esm/Nav/NavDropdown.d.ts

@@ -0,0 +1,71 @@
+import React from 'react';
+import { TypeAttributes, WithAsProps, RsRefForwardingComponent } from '../@types/common';
+import Button from '../Button';
+import NavDropdownItem from './NavDropdownItem';
+import NavDropdownMenu from './NavDropdownMenu';
+import { NavDropdownToggleProps } from './NavDropdownToggle';
+export declare type NavDropdownTrigger = 'click' | 'hover' | 'contextMenu';
+export interface NavDropdownProps<T = any> extends WithAsProps, Omit<React.HTMLAttributes<HTMLElement>, 'onSelect' | 'title'> {
+    /** Define the title as a submenu */
+    title?: React.ReactNode;
+    /** Set the icon */
+    icon?: NavDropdownToggleProps['icon'];
+    /** Triggering events */
+    trigger?: NavDropdownTrigger | readonly NavDropdownTrigger[];
+    /** The placement of Menu */
+    placement?: TypeAttributes.Placement8;
+    /** Whether or not component is disabled */
+    disabled?: boolean;
+    /** The style of the menu */
+    menuStyle?: React.CSSProperties;
+    /** A css class to apply to the Toggle DOM node */
+    toggleClassName?: string;
+    /** The value of the current option */
+    eventKey?: T;
+    /** You can use a custom element type for this toggle component */
+    toggleAs?: React.ElementType;
+    /** No caret variation */
+    noCaret?: NavDropdownToggleProps['noCaret'];
+    /**
+     * Open the menu and control it
+     * @deprecated
+     */
+    open?: boolean;
+    /**
+     * @deprecated
+     */
+    renderTitle?: (children: React.ReactNode) => React.ReactNode;
+    /** Custom Toggle */
+    renderToggle?: (props: WithAsProps, ref: React.Ref<any>) => any;
+    /** The callback function that the menu closes */
+    onClose?: () => void;
+    /** Menu Pop-up callback function */
+    onOpen?: () => void;
+    /** Callback function for menu state switching */
+    onToggle?: (open: boolean, eventKey?: T | undefined, event?: React.SyntheticEvent) => void;
+}
+export interface NavDropdownComponent extends RsRefForwardingComponent<'div', NavDropdownProps> {
+    <ToggleAs extends React.ElementType = typeof Button>(props: NavDropdownProps & {
+        ref?: React.Ref<any>;
+        toggleAs?: ToggleAs;
+    } & React.ComponentProps<ToggleAs>, context: any): JSX.Element | null;
+    /**
+     * @deprecated Use <Nav.Item> instead.
+     */
+    Item: typeof NavDropdownItem;
+    /**
+     * @deprecated Use <Nav.Menu> instead.
+     */
+    Menu: typeof NavDropdownMenu;
+}
+/**
+ * @private this component is not supposed to be used directly
+ *          Instead it's rendered by a <Nav.Menu> call
+ *
+ * <Nav>
+ *   <Nav.Menu> -> This will render <NavDropdown> component
+ *   </Nav.Menu>
+ * </Nav>
+ */
+declare const NavDropdown: NavDropdownComponent;
+export default NavDropdown;

package/esm/Nav/NavDropdown.js

@@ -0,0 +1,170 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+import React, { useContext, useMemo, useReducer } from 'react';
+import PropTypes from 'prop-types';
+import omit from 'lodash/omit';
+import pick from 'lodash/pick';
+import { mergeRefs, PLACEMENT_8, placementPolyfill, useClassNames } from '../utils';
+import deprecatePropType from '../utils/deprecatePropType';
+import { initialState, reducer } from '../Dropdown/DropdownState';
+import Menu from '../Menu/Menu';
+import kebabCase from 'lodash/kebabCase';
+import NavContext from './NavContext';
+import NavDropdownItem from './NavDropdownItem';
+import NavDropdownMenu from './NavDropdownMenu';
+import NavDropdownToggle from './NavDropdownToggle';
+
+/**
+ * @private this component is not supposed to be used directly
+ *          Instead it's rendered by a <Nav.Menu> call
+ *
+ * <Nav>
+ *   <Nav.Menu> -> This will render <NavDropdown> component
+ *   </Nav.Menu>
+ * </Nav>
+ */
+var NavDropdown = /*#__PURE__*/React.forwardRef(function (props, ref) {
+  var nav = useContext(NavContext);
+
+  if (!nav) {
+    throw new Error('<Nav.Dropdown> must be rendered within a <Nav> component.');
+  }
+
+  var _props$as = props.as,
+      Component = _props$as === void 0 ? 'div' : _props$as,
+      title = props.title,
+      onClose = props.onClose,
+      onOpen = props.onOpen,
+      onToggle = props.onToggle,
+      eventKey = props.eventKey,
+      _props$trigger = props.trigger,
+      trigger = _props$trigger === void 0 ? 'click' : _props$trigger,
+      _props$placement = props.placement,
+      placement = _props$placement === void 0 ? 'bottomStart' : _props$placement,
+      toggleAs = props.toggleAs,
+      toggleClassName = props.toggleClassName,
+      _props$classPrefix = props.classPrefix,
+      classPrefix = _props$classPrefix === void 0 ? 'dropdown' : _props$classPrefix,
+      className = props.className,
+      disabled = props.disabled,
+      children = props.children,
+      menuStyle = props.menuStyle,
+      style = props.style,
+      toggleProps = _objectWithoutPropertiesLoose(props, ["as", "title", "onClose", "onOpen", "onToggle", "eventKey", "trigger", "placement", "toggleAs", "toggleClassName", "classPrefix", "className", "disabled", "children", "menuStyle", "style"]);
+
+  var _useClassNames = useClassNames(classPrefix),
+      merge = _useClassNames.merge,
+      withClassPrefix = _useClassNames.withClassPrefix;
+
+  var _useClassNames2 = useClassNames('dropdown-menu'),
+      withMenuClassPrefix = _useClassNames2.withClassPrefix,
+      mergeMenuClassName = _useClassNames2.merge;
+
+  var menuButtonTriggers = useMemo(function () {
+    if (!trigger) {
+      return undefined;
+    }
+
+    var triggerMap = {
+      hover: 'mouseover',
+      click: 'click',
+      contextMenu: 'contextmenu'
+    };
+
+    if (!Array.isArray(trigger)) {
+      return [triggerMap[trigger]];
+    }
+
+    return trigger.map(function (t) {
+      return triggerMap[t];
+    });
+  }, [trigger]);
+
+  var _useReducer = useReducer(reducer, initialState),
+      items = _useReducer[0].items;
+
+  var hasSelectedItem = useMemo(function () {
+    return items.some(function (item) {
+      return item.props.selected;
+    });
+  }, [items]);
+
+  var renderMenuButton = function renderMenuButton(menuButtonProps, menuButtonRef) {
+    return /*#__PURE__*/React.createElement(NavDropdownToggle, _extends({
+      ref: menuButtonRef,
+      as: toggleAs,
+      className: toggleClassName,
+      placement: placement,
+      disabled: disabled
+    }, omit(menuButtonProps, ['open']), omit(toggleProps, ['data-testid'])), title);
+  };
+
+  return /*#__PURE__*/React.createElement(Menu, {
+    renderMenuButton: renderMenuButton,
+    openMenuOn: menuButtonTriggers,
+    renderMenuPopup: function renderMenuPopup(_ref, popupRef) {
+      var open = _ref.open,
+          popupProps = _objectWithoutPropertiesLoose(_ref, ["open"]);
+
+      var menuClassName = mergeMenuClassName(className, withMenuClassPrefix());
+      return /*#__PURE__*/React.createElement("ul", _extends({
+        ref: popupRef,
+        className: menuClassName,
+        style: menuStyle,
+        hidden: !open
+      }, popupProps), children);
+    },
+    onToggleMenu: function onToggleMenu(open, event) {
+      onToggle === null || onToggle === void 0 ? void 0 : onToggle(open, eventKey, event);
+
+      if (open) {
+        onOpen === null || onOpen === void 0 ? void 0 : onOpen();
+      } else {
+        onClose === null || onClose === void 0 ? void 0 : onClose();
+      }
+    }
+  }, function (_ref2, menuContainerRef) {
+    var _withClassPrefix;
+
+    var open = _ref2.open,
+        menuContainer = _objectWithoutPropertiesLoose(_ref2, ["open"]);
+
+    var classes = merge(className, withClassPrefix((_withClassPrefix = {}, _withClassPrefix["placement-" + kebabCase(placementPolyfill(placement))] = !!placement, _withClassPrefix.disabled = disabled, _withClassPrefix.open = open, _withClassPrefix['selected-within'] = hasSelectedItem, _withClassPrefix)));
+    return /*#__PURE__*/React.createElement(Component, _extends({
+      ref: mergeRefs(ref, menuContainerRef),
+      className: classes
+    }, menuContainer, pick(toggleProps, ['data-testid']), {
+      style: style
+    }));
+  });
+});
+NavDropdown.Item = NavDropdownItem;
+NavDropdown.Menu = NavDropdownMenu;
+NavDropdown.displayName = 'Nav.Dropdown';
+NavDropdown.propTypes = {
+  classPrefix: PropTypes.string,
+  trigger: PropTypes.oneOfType([PropTypes.array, PropTypes.oneOf(['click', 'hover', 'contextMenu'])]),
+  placement: PropTypes.oneOf(PLACEMENT_8),
+  title: PropTypes.node,
+  disabled: PropTypes.bool,
+  icon: PropTypes.node,
+  menuStyle: PropTypes.object,
+  className: PropTypes.string,
+  toggleClassName: PropTypes.string,
+  children: PropTypes.node,
+  open: deprecatePropType(PropTypes.bool),
+  eventKey: PropTypes.any,
+  as: PropTypes.elementType,
+  toggleAs: PropTypes.elementType,
+  noCaret: PropTypes.bool,
+  style: PropTypes.object,
+  onClose: PropTypes.func,
+  onOpen: PropTypes.func,
+  onToggle: PropTypes.func,
+  onMouseEnter: PropTypes.func,
+  onMouseLeave: PropTypes.func,
+  onContextMenu: PropTypes.func,
+  onClick: PropTypes.func,
+  renderToggle: PropTypes.func
+};
+export default NavDropdown;

package/esm/Nav/NavDropdownItem.d.ts

@@ -0,0 +1,39 @@
+import { RsRefForwardingComponent, WithAsProps } from '../@types/common';
+import React from 'react';
+import { IconProps } from '@rsuite/icons/lib/Icon';
+export interface NavDropdownItemProps<T = any> extends WithAsProps, Omit<React.HTMLAttributes<HTMLElement>, 'onSelect'> {
+    /** Active the current option */
+    active?: boolean;
+    /** Primary content */
+    children?: React.ReactNode;
+    /** You can use a custom element for this component */
+    as?: React.ElementType;
+    /** Whether to display the divider */
+    divider?: boolean;
+    /** Disable the current option */
+    disabled?: boolean;
+    /** The value of the current option */
+    eventKey?: T;
+    /** Displays a custom panel */
+    panel?: boolean;
+    /** Set the icon */
+    icon?: React.ReactElement<IconProps>;
+    /**
+     * The sub-level menu appears from the right side by default, and when `pullLeft` is set, it appears from the left.
+     * @deprecated Submenus are now pointing the same direction.
+     */
+    pullLeft?: boolean;
+    /**
+     * Whether the submenu is opened.
+     * @deprecated
+     * @internal
+     */
+    open?: boolean;
+    /** Select the callback function for the current option  */
+    onSelect?: (eventKey: T, event: React.SyntheticEvent) => void;
+}
+/**
+ * @private
+ */
+declare const NavDropdownItem: RsRefForwardingComponent<'li', NavDropdownItemProps>;
+export default NavDropdownItem;

package/esm/Nav/NavDropdownItem.js

@@ -0,0 +1,123 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+import React, { useCallback, useContext } from 'react';
+import PropTypes from 'prop-types';
+import deprecatePropType from '../utils/deprecatePropType';
+import MenuItem from '../Menu/MenuItem';
+import isNil from 'lodash/isNil';
+import { mergeRefs, shallowEqual, useClassNames } from '../utils';
+import NavContext from './NavContext';
+import { useRenderDropdownItem } from '../Dropdown/useRenderDropdownItem';
+
+/**
+ * @private
+ */
+var NavDropdownItem = /*#__PURE__*/React.forwardRef(function (props, ref) {
+  var nav = useContext(NavContext);
+
+  if (!nav) {
+    throw new Error('<Nav.Dropdown.Item> should be used within a <Nav> component.');
+  }
+
+  var _props$classPrefix = props.classPrefix,
+      classPrefix = _props$classPrefix === void 0 ? 'dropdown-item' : _props$classPrefix,
+      className = props.className,
+      activeProp = props.active,
+      eventKey = props.eventKey,
+      onSelect = props.onSelect,
+      icon = props.icon,
+      _props$as = props.as,
+      Component = _props$as === void 0 ? 'li' : _props$as,
+      divider = props.divider,
+      panel = props.panel,
+      children = props.children,
+      disabled = props.disabled,
+      restProps = _objectWithoutPropertiesLoose(props, ["classPrefix", "className", "active", "eventKey", "onSelect", "icon", "as", "divider", "panel", "children", "disabled"]);
+
+  var activeKey = nav.activeKey,
+      onSelectFromNav = nav.onSelect;
+
+  var _useClassNames = useClassNames(classPrefix),
+      merge = _useClassNames.merge,
+      withClassPrefix = _useClassNames.withClassPrefix,
+      prefix = _useClassNames.prefix;
+
+  var selected = activeProp || !isNil(eventKey) && shallowEqual(activeKey, eventKey);
+  var handleSelectItem = useCallback(function (event) {
+    onSelect === null || onSelect === void 0 ? void 0 : onSelect(eventKey, event);
+    onSelectFromNav === null || onSelectFromNav === void 0 ? void 0 : onSelectFromNav(eventKey, event);
+  }, [onSelect, eventKey, onSelectFromNav]);
+  var renderDropdownItem = useRenderDropdownItem(Component);
+
+  if (divider) {
+    return renderDropdownItem(_extends({
+      ref: ref,
+      role: 'separator',
+      className: merge(prefix('divider'), className)
+    }, restProps));
+  }
+
+  if (panel) {
+    return renderDropdownItem(_extends({
+      ref: ref,
+      className: merge(prefix('panel'), className),
+      children: children
+    }, restProps));
+  }
+
+  return /*#__PURE__*/React.createElement(MenuItem, {
+    selected: selected,
+    disabled: disabled,
+    onActivate: handleSelectItem
+  }, function (_ref, menuitemRef) {
+    var selected = _ref.selected,
+        active = _ref.active,
+        menuitem = _objectWithoutPropertiesLoose(_ref, ["selected", "active"]);
+
+    var classes = merge(className, withClassPrefix({
+      'with-icon': icon,
+      active: selected,
+      disabled: disabled,
+      focus: active,
+      divider: divider,
+      panel: panel
+    }));
+    var dataAttributes = {
+      'data-event-key': eventKey
+    };
+
+    if (!isNil(eventKey) && typeof eventKey !== 'string') {
+      dataAttributes['data-event-key-type'] = typeof eventKey;
+    }
+
+    return renderDropdownItem(_extends({
+      ref: mergeRefs(ref, menuitemRef),
+      className: classes
+    }, menuitem, dataAttributes, restProps, {
+      children: /*#__PURE__*/React.createElement(React.Fragment, null, icon && /*#__PURE__*/React.cloneElement(icon, {
+        className: prefix('menu-icon')
+      }), children)
+    }));
+  });
+});
+NavDropdownItem.displayName = 'Nav.Dropdown.Item';
+NavDropdownItem.propTypes = {
+  as: PropTypes.elementType,
+  divider: PropTypes.bool,
+  panel: PropTypes.bool,
+  trigger: PropTypes.oneOfType([PropTypes.array, PropTypes.oneOf(['click', 'hover'])]),
+  open: deprecatePropType(PropTypes.bool),
+  active: PropTypes.bool,
+  disabled: PropTypes.bool,
+  pullLeft: deprecatePropType(PropTypes.bool),
+  onSelect: PropTypes.func,
+  onClick: PropTypes.func,
+  icon: PropTypes.node,
+  eventKey: PropTypes.any,
+  className: PropTypes.string,
+  style: PropTypes.object,
+  children: PropTypes.node,
+  classPrefix: PropTypes.string,
+  tabIndex: PropTypes.number
+};
+export default NavDropdownItem;

package/esm/Nav/NavDropdownMenu.d.ts

@@ -0,0 +1,37 @@
+import React from 'react';
+import { StandardProps } from '../@types/common';
+import { IconProps } from '@rsuite/icons/lib/Icon';
+export interface NavDropdownMenuProps<T = any> extends StandardProps {
+    /** Define the title as a submenu */
+    title?: React.ReactNode;
+    /**
+     * The submenu expands from the left and defaults to the right
+     * @deprecated Use openDirection="start" instead
+     */
+    pullLeft?: boolean;
+    /**
+     * Direction that the sub-menu open towards
+     * - start: towards the head of the reading direction (right by default, left in RTL)
+     * - end: towards the end of the reading direction (left by default, right in RTL)
+     *
+     * @default 'end'
+     */
+    openDirection?: 'start' | 'end';
+    /**
+     *  Only used for setting the default expand state when it's a submenu.
+     */
+    eventKey?: T;
+    /** Set the icon */
+    icon?: React.ReactElement<IconProps>;
+    open?: boolean;
+    collapsible?: boolean;
+    expanded?: boolean;
+    active?: boolean;
+    disabled?: boolean;
+    onToggle?: (open: boolean, eventKey?: T | undefined, event?: React.SyntheticEvent) => void;
+}
+/**
+ * @private
+ */
+declare const NavDropdownMenu: React.ForwardRefExoticComponent<NavDropdownMenuProps<any> & Omit<React.HTMLAttributes<HTMLUListElement>, "title" | "onSelect"> & React.RefAttributes<HTMLElement>>;
+export default NavDropdownMenu;

package/esm/Nav/NavDropdownMenu.js

@@ -0,0 +1,143 @@
+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, _templateObject2;
+
+import React, { useCallback, useContext } from 'react';
+import omit from 'lodash/omit';
+import Menu from '../Menu/Menu';
+import MenuItem from '../Menu/MenuItem';
+import { mergeRefs, useClassNames } from '../utils';
+import PropTypes from 'prop-types';
+import AngleLeft from '@rsuite/icons/legacy/AngleLeft';
+import AngleRight from '@rsuite/icons/legacy/AngleRight';
+import useCustom from '../utils/useCustom';
+import NavContext from './NavContext';
+import deprecatePropType from '../utils/deprecatePropType';
+
+/**
+ * @private
+ */
+var NavDropdownMenu = /*#__PURE__*/React.forwardRef(function (props, ref) {
+  var nav = useContext(NavContext);
+
+  if (!nav) {
+    throw new Error('<Nav.Dropdown.Menu> should be used within a <Nav> component.');
+  }
+
+  var onToggle = props.onToggle,
+      eventKey = props.eventKey,
+      title = props.title,
+      _props$classPrefix = props.classPrefix,
+      classPrefix = _props$classPrefix === void 0 ? 'dropdown-menu' : _props$classPrefix,
+      children = props.children,
+      _props$openDirection = props.openDirection,
+      openDirection = _props$openDirection === void 0 ? 'end' : _props$openDirection,
+      rest = _objectWithoutPropertiesLoose(props, ["onToggle", "eventKey", "title", "classPrefix", "children", "openDirection"]);
+
+  var _useCustom = useCustom('DropdownMenu'),
+      rtl = _useCustom.rtl;
+
+  var handleToggleSubmenu = useCallback(function (open, event) {
+    onToggle === null || onToggle === void 0 ? void 0 : onToggle(open, eventKey, event);
+  }, [eventKey, onToggle]);
+
+  var _useClassNames = useClassNames(classPrefix),
+      prefix = _useClassNames.prefix;
+
+  var _useClassNames2 = useClassNames('dropdown-menu'),
+      withMenuClassPrefix = _useClassNames2.withClassPrefix,
+      mergeMenuClassName = _useClassNames2.merge;
+
+  var _useClassNames3 = useClassNames('dropdown-item'),
+      mergeItemClassNames = _useClassNames3.merge,
+      withItemClassPrefix = _useClassNames3.withClassPrefix,
+      prefixItemClassName = _useClassNames3.prefix; // Parent menu exists. This is a submenu.
+  // Should render a `menuitem` that controls this submenu.
+
+
+  var _omit = omit(rest, ['trigger']),
+      icon = _omit.icon,
+      className = _omit.className,
+      disabled = _omit.disabled,
+      menuProps = _objectWithoutPropertiesLoose(_omit, ["icon", "className", "disabled"]);
+
+  var Icon = rtl ? AngleLeft : AngleRight;
+  return /*#__PURE__*/React.createElement(Menu, {
+    openMenuOn: ['mouseover', 'click'],
+    renderMenuButton: function renderMenuButton(_ref, buttonRef) {
+      var open = _ref.open,
+          menuButtonProps = _objectWithoutPropertiesLoose(_ref, ["open"]);
+
+      return /*#__PURE__*/React.createElement(MenuItem, {
+        disabled: disabled
+      }, function (_ref2, menuitemRef) {
+        var selected = _ref2.selected,
+            active = _ref2.active,
+            menuitem = _objectWithoutPropertiesLoose(_ref2, ["selected", "active"]);
+
+        var classes = mergeItemClassNames(className, prefixItemClassName(_templateObject || (_templateObject = _taggedTemplateLiteralLoose(["toggle"]))), withItemClassPrefix({
+          'with-icon': icon,
+          open: open,
+          active: selected,
+          disabled: disabled,
+          focus: active
+        }));
+        return /*#__PURE__*/React.createElement("div", _extends({
+          ref: mergeRefs(buttonRef, menuitemRef),
+          className: classes,
+          "data-event-key": eventKey,
+          "data-event-key-type": typeof eventKey
+        }, menuitem, omit(menuButtonProps, ['role'])), icon && /*#__PURE__*/React.cloneElement(icon, {
+          className: prefix('menu-icon')
+        }), title, /*#__PURE__*/React.createElement(Icon, {
+          className: prefix(_templateObject2 || (_templateObject2 = _taggedTemplateLiteralLoose(["toggle-icon"])))
+        }));
+      });
+    },
+    renderMenuPopup: function renderMenuPopup(_ref3, popupRef) {
+      var open = _ref3.open,
+          popupProps = _objectWithoutPropertiesLoose(_ref3, ["open"]);
+
+      var menuClassName = mergeMenuClassName(className, withMenuClassPrefix());
+      return /*#__PURE__*/React.createElement("ul", _extends({
+        ref: popupRef,
+        className: menuClassName,
+        hidden: !open,
+        "data-direction": openDirection
+      }, popupProps, menuProps), children);
+    },
+    onToggleMenu: handleToggleSubmenu
+  }, function (_ref4, menuContainerRef) {
+    var open = _ref4.open,
+        menuContainer = _objectWithoutPropertiesLoose(_ref4, ["open"]);
+
+    var classes = mergeItemClassNames(className, withItemClassPrefix({
+      disabled: disabled,
+      open: open,
+      submenu: true
+    }));
+    return /*#__PURE__*/React.createElement("li", _extends({
+      ref: mergeRefs(ref, menuContainerRef),
+      className: classes
+    }, menuContainer));
+  });
+});
+NavDropdownMenu.displayName = 'Nav.Dropdown.Menu';
+NavDropdownMenu.propTypes = {
+  active: PropTypes.bool,
+  className: PropTypes.string,
+  children: PropTypes.node,
+  icon: PropTypes.any,
+  classPrefix: PropTypes.string,
+  pullLeft: deprecatePropType(PropTypes.bool, 'Use openDirection="start" instead.'),
+  openDirection: PropTypes.oneOf(['start', 'end']),
+  title: PropTypes.node,
+  open: PropTypes.bool,
+  eventKey: PropTypes.any,
+  expanded: PropTypes.bool,
+  collapsible: PropTypes.bool,
+  onToggle: PropTypes.func
+};
+export default NavDropdownMenu;

package/esm/Nav/NavDropdownToggle.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import Button from '../Button';
+import { WithAsProps, RsRefForwardingComponent, TypeAttributes } from '../@types/common';
+import { NavItemProps } from './NavItem';
+export interface NavDropdownToggleProps extends WithAsProps {
+    icon?: NavItemProps['icon'];
+    noCaret?: boolean;
+    renderToggle?: (props: WithAsProps, ref: React.Ref<any>) => any;
+    placement?: TypeAttributes.Placement8;
+}
+/**
+ * @private this component is not supposed to be used directly
+ *          Instead it's rendered by a <Nav.Menu> call
+ *
+ * <Nav>
+ *   <Nav.Menu> -> This will render <NavDropdown> component that renders a <NavDropdownToggle>
+ *   </Nav.Menu>
+ * </Nav>
+ */
+declare const NavDropdownToggle: RsRefForwardingComponent<typeof Button, NavDropdownToggleProps>;
+export default NavDropdownToggle;

package/esm/Nav/NavDropdownToggle.js

@@ -0,0 +1,57 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+import React from 'react';
+import PropTypes from 'prop-types';
+import ArrowDownLineIcon from '@rsuite/icons/ArrowDownLine';
+import { useClassNames } from '../utils';
+import NavItem from './NavItem';
+
+/**
+ * @private this component is not supposed to be used directly
+ *          Instead it's rendered by a <Nav.Menu> call
+ *
+ * <Nav>
+ *   <Nav.Menu> -> This will render <NavDropdown> component that renders a <NavDropdownToggle>
+ *   </Nav.Menu>
+ * </Nav>
+ */
+var NavDropdownToggle = /*#__PURE__*/React.forwardRef(function (props, ref) {
+  var _props$as = props.as,
+      Component = _props$as === void 0 ? NavItem : _props$as,
+      className = props.className,
+      _props$classPrefix = props.classPrefix,
+      classPrefix = _props$classPrefix === void 0 ? 'dropdown-toggle' : _props$classPrefix,
+      renderToggle = props.renderToggle,
+      children = props.children,
+      noCaret = props.noCaret,
+      rest = _objectWithoutPropertiesLoose(props, ["as", "className", "classPrefix", "renderToggle", "children", "noCaret"]);
+
+  var _useClassNames = useClassNames(classPrefix),
+      withClassPrefix = _useClassNames.withClassPrefix,
+      merge = _useClassNames.merge;
+
+  var _useClassNames2 = useClassNames('nav-item'),
+      prefixNavItem = _useClassNames2.prefix;
+
+  var classes = merge(className, withClassPrefix({
+    'no-caret': noCaret
+  }));
+  var toggle = /*#__PURE__*/React.createElement(Component, _extends({}, rest, {
+    ref: ref,
+    className: classes
+  }), children, !noCaret && /*#__PURE__*/React.createElement(ArrowDownLineIcon, {
+    className: prefixNavItem('caret')
+  }));
+  return renderToggle ? renderToggle(rest, ref) : toggle;
+});
+NavDropdownToggle.displayName = 'Nav.Dropdown.Toggle';
+NavDropdownToggle.propTypes = {
+  className: PropTypes.string,
+  children: PropTypes.node,
+  classPrefix: PropTypes.string,
+  noCaret: PropTypes.bool,
+  as: PropTypes.elementType,
+  renderToggle: PropTypes.func,
+  placement: PropTypes.oneOf(['bottomStart', 'bottomEnd', 'topStart', 'topEnd', 'leftStart', 'rightStart', 'leftEnd', 'rightEnd'])
+};
+export default NavDropdownToggle;

package/esm/Nav/NavItem.d.ts

@@ -21,6 +21,8 @@ export interface NavItemProps<T = string> extends WithAsProps, Omit<React.HTMLAt
 }
 /**
  * The <Nav.Item> API
+ * When used as direct child of <Nav>, render the NavItem
+ * When used within a <Nav.Menu>, render the NavDropdownItem
  */
 declare const NavItem: RsRefForwardingComponent<'a', NavItemProps>;
 export default NavItem;