@carbon/react 1.29.0 → 1.30.0-rc.0

package/lib/components/UIShell/HeaderContainer.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import PropTypes from 'prop-types';
+import React from 'react';
+interface HeaderContainerRenderProps {
+    isSideNavExpanded: boolean;
+    onClickSideNavExpand: () => void;
+}
+interface HeaderContainerProps {
+    isSideNavExpanded?: boolean;
+    render: React.ComponentType<HeaderContainerRenderProps>;
+}
+declare function HeaderContainer({ render: Children, isSideNavExpanded, }: HeaderContainerProps): JSX.Element;
+declare namespace HeaderContainer {
+    var propTypes: {
+        /**
+         * Optionally provide a custom class name that is applied to the underlying <header>
+         */
+        isSideNavExpanded: PropTypes.Requireable<boolean>;
+        /**
+         * A function or component that is passed an object parameter with two
+         * properties: `isSideNavExpanded` and `onClickSideNavExpand`. The function or
+         * component can then use those properties to within the components it
+         * returns, such as with the HeaderMenuButton and SideNav components.
+         */
+        render: PropTypes.Validator<NonNullable<PropTypes.ReactComponentLike>>;
+    };
+}
+export default HeaderContainer;

package/lib/components/UIShell/HeaderContainer.js

@@ -20,10 +20,10 @@ function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'defau
 var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
 var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 
-const HeaderContainer = _ref => {
+function HeaderContainer(_ref) {
   let {
-    isSideNavExpanded,
-    render: Children
+    render: Children,
+    isSideNavExpanded = false
   } = _ref;
   //state for expandable sidenav
   const [isSideNavExpandedState, setIsSideNavExpandedState] = React.useState(isSideNavExpanded);
@@ -39,17 +39,19 @@ const HeaderContainer = _ref => {
     isSideNavExpanded: isSideNavExpandedState,
     onClickSideNavExpand: handleHeaderMenuButtonClick
   });
-};
-
+}
 HeaderContainer.propTypes = {
   /**
    * Optionally provide a custom class name that is applied to the underlying <header>
    */
-  isSideNavExpanded: PropTypes__default["default"].bool
-};
-HeaderContainer.defaultProps = {
-  isSideNavExpanded: false
+  isSideNavExpanded: PropTypes__default["default"].bool,
+  /**
+   * A function or component that is passed an object parameter with two
+   * properties: `isSideNavExpanded` and `onClickSideNavExpand`. The function or
+   * component can then use those properties to within the components it
+   * returns, such as with the HeaderMenuButton and SideNav components.
+   */
+  render: PropTypes__default["default"].elementType.isRequired
 };
-var HeaderContainer$1 = HeaderContainer;
 
-exports["default"] = HeaderContainer$1;
+exports["default"] = HeaderContainer;

package/lib/components/UIShell/HeaderGlobalAction.js

@@ -31,7 +31,6 @@ var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
  *
  * Note: children passed to this component should be an Icon.
  */
-
 const HeaderGlobalAction = /*#__PURE__*/React__default["default"].forwardRef(function HeaderGlobalAction(_ref, ref) {
   let {
     'aria-label': ariaLabel,
@@ -69,29 +68,24 @@ HeaderGlobalAction.propTypes = {
    * Required props for the accessibility label of the button
    */
   ...AriaPropTypes.AriaLabelPropType,
-
   /**
    * Provide a custom icon for this global action
    */
   children: PropTypes__default["default"].node.isRequired,
-
   /**
    * Optionally provide a custom class name that is applied to the underlying
    * button
    */
   className: PropTypes__default["default"].string,
-
   /**
    * Specify whether the action is currently active
    */
   isActive: PropTypes__default["default"].bool,
-
   /**
    * Optionally provide an onClick handler that is called when the underlying
    * button fires it's onclick event
    */
   onClick: PropTypes__default["default"].func,
-
   /**
    * Specify the alignment of the tooltip to the icon-only button.
    * Can be one of: start, center, or end.

package/lib/components/UIShell/HeaderGlobalBar.js

@@ -14,7 +14,6 @@ var wrapComponent = require('../../tools/wrapComponent.js');
 /**
  * Generic container for `HeaderGlobalAction` components
  */
-
 var HeaderGlobalBar = wrapComponent["default"]({
   name: 'HeaderGlobalBar',
   className: prefix => `${prefix}--header__global`,

package/lib/components/UIShell/HeaderMenu.js

@@ -32,27 +32,21 @@ var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
  * with managing focus. It also passes along refs to each child so that it can
  * help manage focus state of its children.
  */
-
 class HeaderMenu extends React__default["default"].Component {
   constructor(props) {
     super(props);
-
     _rollupPluginBabelHelpers.defineProperty(this, "_subMenus", /*#__PURE__*/React__default["default"].createRef());
-
     _rollupPluginBabelHelpers.defineProperty(this, "handleOnClick", e => {
       const {
         current: subMenusNode
       } = this._subMenus;
-
       if (!subMenusNode || !subMenusNode.contains(e.target)) {
         e.preventDefault();
       }
-
       this.setState(prevState => ({
         expanded: !prevState.expanded
       }));
     });
-
     _rollupPluginBabelHelpers.defineProperty(this, "handleOnKeyDown", event => {
       // Handle enter or space key for toggling the expanded state of the menu.
       if (match.matches(event, [keys.Enter, keys.Space])) {
@@ -64,34 +58,27 @@ class HeaderMenu extends React__default["default"].Component {
         return;
       }
     });
-
     _rollupPluginBabelHelpers.defineProperty(this, "handleOnBlur", event => {
       // Rough guess for a blur event that is triggered outside of our menu or
       // menubar context
       const itemTriggeredBlur = this.items.find(element => element === event.relatedTarget);
-
       if (event.relatedTarget && (event.relatedTarget.getAttribute('href') && event.relatedTarget.getAttribute('href') !== '#' || itemTriggeredBlur)) {
         return;
       }
-
       this.setState({
         expanded: false,
         selectedIndex: null
       });
     });
-
     _rollupPluginBabelHelpers.defineProperty(this, "handleMenuButtonRef", node => {
       if (this.props.focusRef) {
         this.props.focusRef(node);
       }
-
       this.menuButtonRef = node;
     });
-
     _rollupPluginBabelHelpers.defineProperty(this, "handleItemRef", index => node => {
       this.items[index] = node;
     });
-
     _rollupPluginBabelHelpers.defineProperty(this, "handleMenuClose", event => {
       // Handle ESC keydown for closing the expanded menu.
       if (match.matches(event, [keys.Escape]) && this.state.expanded) {
@@ -100,13 +87,13 @@ class HeaderMenu extends React__default["default"].Component {
         this.setState(() => ({
           expanded: false,
           selectedIndex: null
-        })); // Return focus to menu button when the user hits ESC.
+        }));
 
+        // Return focus to menu button when the user hits ESC.
         this.menuButtonRef.focus();
         return;
       }
     });
-
     _rollupPluginBabelHelpers.defineProperty(this, "_renderMenuItem", (item, index) => {
       if ( /*#__PURE__*/React__default["default"].isValidElement(item)) {
         return /*#__PURE__*/React__default["default"].cloneElement(item, {
@@ -114,7 +101,6 @@ class HeaderMenu extends React__default["default"].Component {
         });
       }
     });
-
     this.state = {
       // Used to manage the expansion state of the menu
       expanded: false,
@@ -124,10 +110,34 @@ class HeaderMenu extends React__default["default"].Component {
     };
     this.items = [];
   }
+
   /**
    * Toggle the expanded state of the menu on click.
    */
 
+  /**
+   * Keyboard event handler for the entire menu.
+   */
+
+  /**
+   * Handle our blur event from our underlying menuitems. Will mostly be used
+   * for toggling the expansion status of our menu in response to a user
+   * clicking off of the menu or menubar.
+   */
+
+  /**
+   * ref handler for our menu button. If we are supplied a `focusRef` prop, we also
+   * forward along the node.
+   *
+   * This is useful when this component is a child in a
+   * menu or menubar as it will allow the parent to explicitly focus the menu
+   * button node when that child should receive focus.
+   */
+
+  /**
+   * Handles individual menuitem refs. We assign them to a class instance
+   * property so that we can properly manage focus of our children.
+   */
 
   render() {
     const prefix = this.context;
@@ -144,6 +154,7 @@ class HeaderMenu extends React__default["default"].Component {
       // eslint-disable-line no-unused-vars
       ...rest
     } = this.props;
+    const hasActiveChildren = React__default["default"].Children.toArray(children).some(child => child.props.isActive || child.props.isCurrentPage);
     const accessibilityLabel = {
       'aria-label': ariaLabel,
       'aria-labelledby': ariaLabelledBy
@@ -158,15 +169,16 @@ class HeaderMenu extends React__default["default"].Component {
       [`${prefix}--header__menu-title`]: true,
       // We set the current class only if `isActive` is passed in and we do
       // not have an `aria-current="page"` set for the breadcrumb item
-      [`${prefix}--header__menu-item--current`]: isActivePage
-    }); // Notes on eslint comments and based on the examples in:
+      [`${prefix}--header__menu-item--current`]: isActivePage || hasActiveChildren && !this.state.expanded
+    });
+
+    // Notes on eslint comments and based on the examples in:
     // https://www.w3.org/TR/wai-aria-practices/examples/menubar/menubar-1/menubar-1.html#
     // - The focus is handled by the <a> menuitem, onMouseOver is for mouse
     // users
     // - aria-haspopup can definitely have the value "menu"
     // - aria-expanded is on their example node with role="menuitem"
     // - href can be set to javascript:void(0), ideally this will be a button
-
     return /*#__PURE__*/React__default["default"].createElement("li", _rollupPluginBabelHelpers["extends"]({}, rest, {
       className: itemClassName,
       onKeyDown: this.handleMenuClose,
@@ -189,61 +201,50 @@ class HeaderMenu extends React__default["default"].Component {
       className: `${prefix}--header__menu`
     }), React__default["default"].Children.map(children, this._renderMenuItem)));
   }
+
   /**
    * We capture the `ref` for each child inside of `this.items` to properly
    * manage focus. In addition to this focus management, all items receive a
    * `tabIndex: -1` so the user won't hit a large number of items in their tab
    * sequence when they might not want to go through all the items.
    */
-
-
 }
-
 _rollupPluginBabelHelpers.defineProperty(HeaderMenu, "propTypes", {
   /**
    * Required props for the accessibility label of the menu
    */
   ...AriaPropTypes.AriaLabelPropType,
-
   /**
    * Optionally provide a custom class to apply to the underlying `<li>` node
    */
   className: PropTypes__default["default"].string,
-
   /**
    * Provide a custom ref handler for the menu button
    */
   focusRef: PropTypes__default["default"].func,
-
   /**
    * Applies selected styles to the item if a user sets this to true and `aria-current !== 'page'`.
    */
   isActive: PropTypes__default["default"].bool,
-
   /**
    * Applies selected styles to the item if a user sets this to true and `aria-current !== 'page'`.
    * @deprecated Please use `isActive` instead. This will be removed in the next major release.
    */
   isCurrentPage: deprecate["default"](PropTypes__default["default"].bool, 'The `isCurrentPage` prop for `HeaderMenu` has ' + 'been deprecated. Please use `isActive` instead. This will be removed in the next major release.'),
-
   /**
    * Provide a label for the link text
    */
   menuLinkName: PropTypes__default["default"].string.isRequired,
-
   /**
    * Optional component to render instead of string
    */
   renderMenuContent: PropTypes__default["default"].func,
-
   /**
    * Optionally provide a tabIndex for the underlying menu button
    */
   tabIndex: PropTypes__default["default"].number
 });
-
 _rollupPluginBabelHelpers.defineProperty(HeaderMenu, "contextType", usePrefix.PrefixContext);
-
 const HeaderMenuForwardRef = /*#__PURE__*/React__default["default"].forwardRef((props, ref) => {
   return /*#__PURE__*/React__default["default"].createElement(HeaderMenu, _rollupPluginBabelHelpers["extends"]({}, props, {
     focusRef: ref

package/lib/components/UIShell/HeaderMenuButton.js

@@ -36,7 +36,8 @@ function HeaderMenuButton(_ref) {
     ...rest
   } = _ref;
   const prefix = usePrefix.usePrefix();
-  const className = cx__default["default"]({ ...(typeof customClassName === 'string' && {
+  const className = cx__default["default"]({
+    ...(typeof customClassName === 'string' && {
       [customClassName]: !!customClassName
     }),
     [`${prefix}--header__action`]: true,
@@ -64,18 +65,15 @@ HeaderMenuButton.propTypes = {
    * Required props for accessibility label on the underlying menu button
    */
   ...AriaPropTypes.AriaLabelPropType,
-
   /**
    * Optionally provide a custom class name that is applied to the underlying
    * button
    */
   className: PropTypes__default["default"].string,
-
   /**
    * Specify whether the menu button is "active".
    */
   isActive: PropTypes__default["default"].bool,
-
   /**
    * Optionally provide an onClick handler that is called when the underlying
    * button fires it's onclick event

package/lib/components/UIShell/HeaderMenuItem.js

@@ -35,11 +35,9 @@ const HeaderMenuItem = /*#__PURE__*/React__default["default"].forwardRef(functio
     ...rest
   } = _ref;
   const prefix = usePrefix.usePrefix();
-
   if (isCurrentPage) {
     isActive = isCurrentPage;
   }
-
   const linkClassName = cx__default["default"]({
     [`${prefix}--header__menu-item`]: true,
     // We set the current class only if `isActive` is passed in and we do
@@ -65,35 +63,29 @@ HeaderMenuItem.propTypes = {
    * custom `Link` element
    */
   ...Link.LinkPropTypes,
-
   /**
    * Pass in children that are either a string or can be read as a string by
    * screen readers
    */
   children: PropTypes__default["default"].node.isRequired,
-
   /**
    * Optionally provide a custom class to apply to the underlying `<li>` node
    */
   className: PropTypes__default["default"].string,
-
   /**
    * Applies selected styles to the item if a user sets this to true and `aria-current !== 'page'`.
    */
   isActive: PropTypes__default["default"].bool,
-
   /**
    * Applies selected styles to the item if a user sets this to true and `aria-current !== 'page'`.
    * @deprecated Please use `isActive` instead. This will be removed in the next major release.
    */
   isCurrentPage: deprecate["default"](PropTypes__default["default"].bool, 'The `isCurrentPage` prop for `HeaderMenuItem` has ' + 'been deprecated. Please use `isActive` instead. This will be removed in the next major release.'),
-
   /**
    * Optionally supply a role for the underlying `<li>` node. Useful for resetting
    * `<ul>` semantics for menus.
    */
   role: PropTypes__default["default"].string,
-
   /**
    * Specify the tab index of the Link
    */

package/lib/components/UIShell/HeaderName.js

@@ -39,30 +39,25 @@ function HeaderName(_ref) {
     className: `${selectorPrefix}--header__name--prefix`
   }, prefix), "\xA0"), children);
 }
-
 HeaderName.propTypes = {
   /**
    * Pass in a valid `element` to replace the underlying `<a>` tag with a
    * custom `Link` element
    */
   ...Link.LinkPropTypes,
-
   /**
    * Pass in children that are either a string or can be read as a string by
    * screen readers
    */
   children: PropTypes__default["default"].node.isRequired,
-
   /**
    * Optionally provide a custom class to apply to the underlying `<li>` node
    */
   className: PropTypes__default["default"].string,
-
   /**
    * Provide an href for the name to link to
    */
   href: PropTypes__default["default"].string,
-
   /**
    * Optionally specify a prefix to your header name. Useful for companies, for
    * example: IBM [Product Name] versus solely [Product Name]

package/lib/components/UIShell/HeaderNavigation.js

@@ -45,13 +45,11 @@ HeaderNavigation.propTypes = {
    * Required props for accessibility label on the underlying menu
    */
   ...AriaPropTypes.AriaLabelPropType,
-
   /**
    * Provide valid children of HeaderNavigation, for example `HeaderMenuItem`
    * or `HeaderMenu`
    */
   children: PropTypes__default["default"].node,
-
   /**
    * Optionally provide a custom class to apply to the underlying <nav> node
    */

package/lib/components/UIShell/HeaderPanel.js

@@ -51,12 +51,10 @@ HeaderPanel.propTypes = {
    * Required props for accessibility label on the underlying menu
    */
   ...AriaPropTypes.AriaLabelPropType,
-
   /**
    * Optionally provide a custom class to apply to the underlying `<li>` node
    */
   className: PropTypes__default["default"].string,
-
   /**
    * Specify whether the panel is expanded
    */

package/lib/components/UIShell/HeaderSideNavItems.js

@@ -40,13 +40,11 @@ HeaderSideNavItems.propTypes = {
    * The child nodes to be rendered
    */
   children: PropTypes__default["default"].node,
-
   /**
    * Optionally provide a custom class name that is applied to the underlying
    * button
    */
   className: PropTypes__default["default"].string,
-
   /**
    * Optionally specify if container will have a bottom divider to differentiate
    * between original sidenav items and header menu items. False by default.

package/lib/components/UIShell/Link.js

@@ -23,7 +23,6 @@ var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
  * in their own components to support use-cases like `react-router` or
  * `@reach/router`
  */
-
 const Link = /*#__PURE__*/React__default["default"].forwardRef(function Link(props, ref) {
   const {
     element,
@@ -31,7 +30,8 @@ const Link = /*#__PURE__*/React__default["default"].forwardRef(function Link(pro
     // eslint-disable-line no-unused-vars
     ...rest
   } = props;
-  return /*#__PURE__*/React__default["default"].createElement(element, { ...rest,
+  return /*#__PURE__*/React__default["default"].createElement(element, {
+    ...rest,
     ref
   });
 });
@@ -41,7 +41,6 @@ const LinkPropTypes = {
    * alternative tag names or custom components like `Link` from `react-router`.
    */
   element: PropTypes__default["default"].elementType,
-
   /**
    * Property to indicate if the side nav container is open (or not). Use to
    * keep local state and styling in step with the SideNav expansion state.

package/lib/components/UIShell/SideNav.d.ts

@@ -10,12 +10,14 @@ interface SideNavProps extends ComponentProps<'nav'> {
     defaultExpanded?: boolean | undefined;
     isChildOfHeader?: boolean | undefined;
     onToggle?: (event: FocusEvent<HTMLElement> | KeyboardEvent<HTMLElement> | boolean, value: boolean) => void | undefined;
+    href?: string | undefined;
     isFixedNav?: boolean | undefined;
     isRail?: boolean | undefined;
     isPersistent?: boolean | undefined;
     addFocusListeners?: boolean | undefined;
     addMouseListeners?: boolean | undefined;
     onOverlayClick?: MouseEventHandler<HTMLDivElement> | undefined;
+    onSideNavBlur?: () => void | undefined;
 }
-declare const SideNav: React.ForwardRefExoticComponent<Pick<SideNavProps, "children" | "className" | "slot" | "style" | "title" | "dir" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "onToggle" | "key" | "id" | "onAnimationEnd" | "aria-controls" | "aria-expanded" | "onClick" | "onKeyDown" | "contentEditable" | "contextMenu" | "draggable" | "hidden" | "lang" | "placeholder" | "spellCheck" | "tabIndex" | "translate" | "radioGroup" | "role" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-current" | "aria-describedby" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "expanded" | "defaultExpanded" | "isChildOfHeader" | "isFixedNav" | "isRail" | "isPersistent" | "addFocusListeners" | "addMouseListeners" | "onOverlayClick"> & React.RefAttributes<HTMLElement>>;
+declare const SideNav: React.ForwardRefExoticComponent<Pick<SideNavProps, "children" | "className" | "slot" | "style" | "title" | "dir" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "onToggle" | "key" | "id" | "onAnimationEnd" | "aria-controls" | "aria-expanded" | "onClick" | "onKeyDown" | "contentEditable" | "contextMenu" | "draggable" | "hidden" | "lang" | "placeholder" | "spellCheck" | "tabIndex" | "translate" | "radioGroup" | "role" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-current" | "aria-describedby" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "href" | "expanded" | "defaultExpanded" | "isChildOfHeader" | "isFixedNav" | "isRail" | "isPersistent" | "addFocusListeners" | "addMouseListeners" | "onOverlayClick" | "onSideNavBlur"> & React.RefAttributes<HTMLElement>>;
 export default SideNav;