rsuite 5.12.0 → 5.13.0

package/cjs/Nav/NavDropdown.js

@@ -0,0 +1,193 @@
+"use strict";
+
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard");
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+exports.__esModule = true;
+exports.default = void 0;
+
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+
+var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _omit = _interopRequireDefault(require("lodash/omit"));
+
+var _pick = _interopRequireDefault(require("lodash/pick"));
+
+var _utils = require("../utils");
+
+var _deprecatePropType = _interopRequireDefault(require("../utils/deprecatePropType"));
+
+var _DropdownState = require("../Dropdown/DropdownState");
+
+var _Menu = _interopRequireDefault(require("../Menu/Menu"));
+
+var _kebabCase = _interopRequireDefault(require("lodash/kebabCase"));
+
+var _NavContext = _interopRequireDefault(require("./NavContext"));
+
+var _NavDropdownItem = _interopRequireDefault(require("./NavDropdownItem"));
+
+var _NavDropdownMenu = _interopRequireDefault(require("./NavDropdownMenu"));
+
+var _NavDropdownToggle = _interopRequireDefault(require("./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.default.forwardRef(function (props, ref) {
+  var nav = (0, _react.useContext)(_NavContext.default);
+
+  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 = (0, _objectWithoutPropertiesLoose2.default)(props, ["as", "title", "onClose", "onOpen", "onToggle", "eventKey", "trigger", "placement", "toggleAs", "toggleClassName", "classPrefix", "className", "disabled", "children", "menuStyle", "style"]);
+
+  var _useClassNames = (0, _utils.useClassNames)(classPrefix),
+      merge = _useClassNames.merge,
+      withClassPrefix = _useClassNames.withClassPrefix;
+
+  var _useClassNames2 = (0, _utils.useClassNames)('dropdown-menu'),
+      withMenuClassPrefix = _useClassNames2.withClassPrefix,
+      mergeMenuClassName = _useClassNames2.merge;
+
+  var menuButtonTriggers = (0, _react.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 = (0, _react.useReducer)(_DropdownState.reducer, _DropdownState.initialState),
+      items = _useReducer[0].items;
+
+  var hasSelectedItem = (0, _react.useMemo)(function () {
+    return items.some(function (item) {
+      return item.props.selected;
+    });
+  }, [items]);
+
+  var renderMenuButton = function renderMenuButton(menuButtonProps, menuButtonRef) {
+    return /*#__PURE__*/_react.default.createElement(_NavDropdownToggle.default, (0, _extends2.default)({
+      ref: menuButtonRef,
+      as: toggleAs,
+      className: toggleClassName,
+      placement: placement,
+      disabled: disabled
+    }, (0, _omit.default)(menuButtonProps, ['open']), (0, _omit.default)(toggleProps, ['data-testid'])), title);
+  };
+
+  return /*#__PURE__*/_react.default.createElement(_Menu.default, {
+    renderMenuButton: renderMenuButton,
+    openMenuOn: menuButtonTriggers,
+    renderMenuPopup: function renderMenuPopup(_ref, popupRef) {
+      var open = _ref.open,
+          popupProps = (0, _objectWithoutPropertiesLoose2.default)(_ref, ["open"]);
+      var menuClassName = mergeMenuClassName(className, withMenuClassPrefix());
+      return /*#__PURE__*/_react.default.createElement("ul", (0, _extends2.default)({
+        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 = (0, _objectWithoutPropertiesLoose2.default)(_ref2, ["open"]);
+    var classes = merge(className, withClassPrefix((_withClassPrefix = {}, _withClassPrefix["placement-" + (0, _kebabCase.default)((0, _utils.placementPolyfill)(placement))] = !!placement, _withClassPrefix.disabled = disabled, _withClassPrefix.open = open, _withClassPrefix['selected-within'] = hasSelectedItem, _withClassPrefix)));
+    return /*#__PURE__*/_react.default.createElement(Component, (0, _extends2.default)({
+      ref: (0, _utils.mergeRefs)(ref, menuContainerRef),
+      className: classes
+    }, menuContainer, (0, _pick.default)(toggleProps, ['data-testid']), {
+      style: style
+    }));
+  });
+});
+
+NavDropdown.Item = _NavDropdownItem.default;
+NavDropdown.Menu = _NavDropdownMenu.default;
+NavDropdown.displayName = 'Nav.Dropdown';
+NavDropdown.propTypes = {
+  classPrefix: _propTypes.default.string,
+  trigger: _propTypes.default.oneOfType([_propTypes.default.array, _propTypes.default.oneOf(['click', 'hover', 'contextMenu'])]),
+  placement: _propTypes.default.oneOf(_utils.PLACEMENT_8),
+  title: _propTypes.default.node,
+  disabled: _propTypes.default.bool,
+  icon: _propTypes.default.node,
+  menuStyle: _propTypes.default.object,
+  className: _propTypes.default.string,
+  toggleClassName: _propTypes.default.string,
+  children: _propTypes.default.node,
+  open: (0, _deprecatePropType.default)(_propTypes.default.bool),
+  eventKey: _propTypes.default.any,
+  as: _propTypes.default.elementType,
+  toggleAs: _propTypes.default.elementType,
+  noCaret: _propTypes.default.bool,
+  style: _propTypes.default.object,
+  onClose: _propTypes.default.func,
+  onOpen: _propTypes.default.func,
+  onToggle: _propTypes.default.func,
+  onMouseEnter: _propTypes.default.func,
+  onMouseLeave: _propTypes.default.func,
+  onContextMenu: _propTypes.default.func,
+  onClick: _propTypes.default.func,
+  renderToggle: _propTypes.default.func
+};
+var _default = NavDropdown;
+exports.default = _default;

package/cjs/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/cjs/Nav/NavDropdownItem.js

@@ -0,0 +1,141 @@
+"use strict";
+
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard");
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+exports.__esModule = true;
+exports.default = void 0;
+
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+
+var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _deprecatePropType = _interopRequireDefault(require("../utils/deprecatePropType"));
+
+var _MenuItem = _interopRequireDefault(require("../Menu/MenuItem"));
+
+var _isNil = _interopRequireDefault(require("lodash/isNil"));
+
+var _utils = require("../utils");
+
+var _NavContext = _interopRequireDefault(require("./NavContext"));
+
+var _useRenderDropdownItem = require("../Dropdown/useRenderDropdownItem");
+
+/**
+ * @private
+ */
+var NavDropdownItem = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
+  var nav = (0, _react.useContext)(_NavContext.default);
+
+  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 = (0, _objectWithoutPropertiesLoose2.default)(props, ["classPrefix", "className", "active", "eventKey", "onSelect", "icon", "as", "divider", "panel", "children", "disabled"]);
+  var activeKey = nav.activeKey,
+      onSelectFromNav = nav.onSelect;
+
+  var _useClassNames = (0, _utils.useClassNames)(classPrefix),
+      merge = _useClassNames.merge,
+      withClassPrefix = _useClassNames.withClassPrefix,
+      prefix = _useClassNames.prefix;
+
+  var selected = activeProp || !(0, _isNil.default)(eventKey) && (0, _utils.shallowEqual)(activeKey, eventKey);
+  var handleSelectItem = (0, _react.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 = (0, _useRenderDropdownItem.useRenderDropdownItem)(Component);
+
+  if (divider) {
+    return renderDropdownItem((0, _extends2.default)({
+      ref: ref,
+      role: 'separator',
+      className: merge(prefix('divider'), className)
+    }, restProps));
+  }
+
+  if (panel) {
+    return renderDropdownItem((0, _extends2.default)({
+      ref: ref,
+      className: merge(prefix('panel'), className),
+      children: children
+    }, restProps));
+  }
+
+  return /*#__PURE__*/_react.default.createElement(_MenuItem.default, {
+    selected: selected,
+    disabled: disabled,
+    onActivate: handleSelectItem
+  }, function (_ref, menuitemRef) {
+    var selected = _ref.selected,
+        active = _ref.active,
+        menuitem = (0, _objectWithoutPropertiesLoose2.default)(_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 (!(0, _isNil.default)(eventKey) && typeof eventKey !== 'string') {
+      dataAttributes['data-event-key-type'] = typeof eventKey;
+    }
+
+    return renderDropdownItem((0, _extends2.default)({
+      ref: (0, _utils.mergeRefs)(ref, menuitemRef),
+      className: classes
+    }, menuitem, dataAttributes, restProps, {
+      children: /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, icon && /*#__PURE__*/_react.default.cloneElement(icon, {
+        className: prefix('menu-icon')
+      }), children)
+    }));
+  });
+});
+
+NavDropdownItem.displayName = 'Nav.Dropdown.Item';
+NavDropdownItem.propTypes = {
+  as: _propTypes.default.elementType,
+  divider: _propTypes.default.bool,
+  panel: _propTypes.default.bool,
+  trigger: _propTypes.default.oneOfType([_propTypes.default.array, _propTypes.default.oneOf(['click', 'hover'])]),
+  open: (0, _deprecatePropType.default)(_propTypes.default.bool),
+  active: _propTypes.default.bool,
+  disabled: _propTypes.default.bool,
+  pullLeft: (0, _deprecatePropType.default)(_propTypes.default.bool),
+  onSelect: _propTypes.default.func,
+  onClick: _propTypes.default.func,
+  icon: _propTypes.default.node,
+  eventKey: _propTypes.default.any,
+  className: _propTypes.default.string,
+  style: _propTypes.default.object,
+  children: _propTypes.default.node,
+  classPrefix: _propTypes.default.string,
+  tabIndex: _propTypes.default.number
+};
+var _default = NavDropdownItem;
+exports.default = _default;

package/cjs/Nav/NavDropdownMenu.d.ts

@@ -0,0 +1,26 @@
+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 */
+    pullLeft?: boolean;
+    /**
+     *  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/cjs/Nav/NavDropdownMenu.js

@@ -0,0 +1,156 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard");
+
+exports.__esModule = true;
+exports.default = void 0;
+
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+
+var _taggedTemplateLiteralLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/taggedTemplateLiteralLoose"));
+
+var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _omit2 = _interopRequireDefault(require("lodash/omit"));
+
+var _Menu = _interopRequireDefault(require("../Menu/Menu"));
+
+var _MenuItem = _interopRequireDefault(require("../Menu/MenuItem"));
+
+var _utils = require("../utils");
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _AngleLeft = _interopRequireDefault(require("@rsuite/icons/legacy/AngleLeft"));
+
+var _AngleRight = _interopRequireDefault(require("@rsuite/icons/legacy/AngleRight"));
+
+var _useCustom2 = _interopRequireDefault(require("../utils/useCustom"));
+
+var _NavContext = _interopRequireDefault(require("./NavContext"));
+
+var _templateObject, _templateObject2;
+
+/**
+ * @private
+ */
+var NavDropdownMenu = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
+  var nav = (0, _react.useContext)(_NavContext.default);
+
+  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,
+      rest = (0, _objectWithoutPropertiesLoose2.default)(props, ["onToggle", "eventKey", "title", "classPrefix", "children"]);
+
+  var _useCustom = (0, _useCustom2.default)('DropdownMenu'),
+      rtl = _useCustom.rtl;
+
+  var handleToggleSubmenu = (0, _react.useCallback)(function (open, event) {
+    onToggle === null || onToggle === void 0 ? void 0 : onToggle(open, eventKey, event);
+  }, [eventKey, onToggle]);
+
+  var _useClassNames = (0, _utils.useClassNames)(classPrefix),
+      prefix = _useClassNames.prefix;
+
+  var _useClassNames2 = (0, _utils.useClassNames)('dropdown-menu'),
+      withMenuClassPrefix = _useClassNames2.withClassPrefix,
+      mergeMenuClassName = _useClassNames2.merge;
+
+  var _useClassNames3 = (0, _utils.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 = (0, _omit2.default)(rest, ['trigger']),
+      icon = _omit.icon,
+      className = _omit.className,
+      disabled = _omit.disabled,
+      menuProps = (0, _objectWithoutPropertiesLoose2.default)(_omit, ["icon", "className", "disabled"]);
+
+  var Icon = rtl ? _AngleLeft.default : _AngleRight.default;
+  return /*#__PURE__*/_react.default.createElement(_Menu.default, {
+    openMenuOn: ['mouseover', 'click'],
+    renderMenuButton: function renderMenuButton(_ref, buttonRef) {
+      var open = _ref.open,
+          menuButtonProps = (0, _objectWithoutPropertiesLoose2.default)(_ref, ["open"]);
+      return /*#__PURE__*/_react.default.createElement(_MenuItem.default, {
+        disabled: disabled
+      }, function (_ref2, menuitemRef) {
+        var selected = _ref2.selected,
+            active = _ref2.active,
+            menuitem = (0, _objectWithoutPropertiesLoose2.default)(_ref2, ["selected", "active"]);
+        var classes = mergeItemClassNames(className, prefixItemClassName(_templateObject || (_templateObject = (0, _taggedTemplateLiteralLoose2.default)(["toggle"]))), withItemClassPrefix({
+          'with-icon': icon,
+          open: open,
+          active: selected,
+          disabled: disabled,
+          focus: active
+        }));
+        return /*#__PURE__*/_react.default.createElement("div", (0, _extends2.default)({
+          ref: (0, _utils.mergeRefs)(buttonRef, menuitemRef),
+          className: classes,
+          "data-event-key": eventKey,
+          "data-event-key-type": typeof eventKey
+        }, menuitem, (0, _omit2.default)(menuButtonProps, ['role'])), icon && /*#__PURE__*/_react.default.cloneElement(icon, {
+          className: prefix('menu-icon')
+        }), title, /*#__PURE__*/_react.default.createElement(Icon, {
+          className: prefix(_templateObject2 || (_templateObject2 = (0, _taggedTemplateLiteralLoose2.default)(["toggle-icon"])))
+        }));
+      });
+    },
+    renderMenuPopup: function renderMenuPopup(_ref3, popupRef) {
+      var open = _ref3.open,
+          popupProps = (0, _objectWithoutPropertiesLoose2.default)(_ref3, ["open"]);
+      var menuClassName = mergeMenuClassName(className, withMenuClassPrefix());
+      return /*#__PURE__*/_react.default.createElement("ul", (0, _extends2.default)({
+        ref: popupRef,
+        className: menuClassName,
+        hidden: !open
+      }, popupProps, menuProps), children);
+    },
+    onToggleMenu: handleToggleSubmenu
+  }, function (_ref4, menuContainerRef) {
+    var open = _ref4.open,
+        menuContainer = (0, _objectWithoutPropertiesLoose2.default)(_ref4, ["open"]);
+    var classes = mergeItemClassNames(className, withItemClassPrefix({
+      disabled: disabled,
+      open: open,
+      submenu: true
+    }));
+    return /*#__PURE__*/_react.default.createElement("li", (0, _extends2.default)({
+      ref: (0, _utils.mergeRefs)(ref, menuContainerRef),
+      className: classes
+    }, menuContainer));
+  });
+});
+
+NavDropdownMenu.displayName = 'Nav.Dropdown.Menu';
+NavDropdownMenu.propTypes = {
+  active: _propTypes.default.bool,
+  className: _propTypes.default.string,
+  children: _propTypes.default.node,
+  icon: _propTypes.default.any,
+  classPrefix: _propTypes.default.string,
+  pullLeft: _propTypes.default.bool,
+  title: _propTypes.default.node,
+  open: _propTypes.default.bool,
+  eventKey: _propTypes.default.any,
+  expanded: _propTypes.default.bool,
+  collapsible: _propTypes.default.bool,
+  onToggle: _propTypes.default.func
+};
+var _default = NavDropdownMenu;
+exports.default = _default;

package/cjs/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/cjs/Nav/NavDropdownToggle.js

@@ -0,0 +1,74 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+exports.__esModule = true;
+exports.default = void 0;
+
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+
+var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
+
+var _react = _interopRequireDefault(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _ArrowDownLine = _interopRequireDefault(require("@rsuite/icons/ArrowDownLine"));
+
+var _utils = require("../utils");
+
+var _NavItem = _interopRequireDefault(require("./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.default.forwardRef(function (props, ref) {
+  var _props$as = props.as,
+      Component = _props$as === void 0 ? _NavItem.default : _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 = (0, _objectWithoutPropertiesLoose2.default)(props, ["as", "className", "classPrefix", "renderToggle", "children", "noCaret"]);
+
+  var _useClassNames = (0, _utils.useClassNames)(classPrefix),
+      withClassPrefix = _useClassNames.withClassPrefix,
+      merge = _useClassNames.merge;
+
+  var _useClassNames2 = (0, _utils.useClassNames)('nav-item'),
+      prefixNavItem = _useClassNames2.prefix;
+
+  var classes = merge(className, withClassPrefix({
+    'no-caret': noCaret
+  }));
+
+  var toggle = /*#__PURE__*/_react.default.createElement(Component, (0, _extends2.default)({}, rest, {
+    ref: ref,
+    className: classes
+  }), children, !noCaret && /*#__PURE__*/_react.default.createElement(_ArrowDownLine.default, {
+    className: prefixNavItem('caret')
+  }));
+
+  return renderToggle ? renderToggle(rest, ref) : toggle;
+});
+
+NavDropdownToggle.displayName = 'Nav.Dropdown.Toggle';
+NavDropdownToggle.propTypes = {
+  className: _propTypes.default.string,
+  children: _propTypes.default.node,
+  classPrefix: _propTypes.default.string,
+  noCaret: _propTypes.default.bool,
+  as: _propTypes.default.elementType,
+  renderToggle: _propTypes.default.func,
+  placement: _propTypes.default.oneOf(['bottomStart', 'bottomEnd', 'topStart', 'topEnd', 'leftStart', 'rightStart', 'leftEnd', 'rightEnd'])
+};
+var _default = NavDropdownToggle;
+exports.default = _default;

package/cjs/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;