@carbon/react 1.28.0-rc.0 → 1.29.0-rc.0

package/es/components/StructuredList/StructuredList.Skeleton.js

@@ -16,15 +16,13 @@ var _span, _span2, _span3;
 const StructuredListSkeleton = _ref => {
   let {
     rowCount,
-    border,
     className,
     ...rest
   } = _ref;
   const prefix = usePrefix();
   const StructuredListSkeletonClasses = cx(className, {
     [`${prefix}--skeleton`]: true,
-    [`${prefix}--structured-list`]: true,
-    [`${prefix}--structured-list--border`]: border
+    [`${prefix}--structured-list`]: true
   });
   const rows = [];
 
@@ -59,11 +57,6 @@ const StructuredListSkeleton = _ref => {
 };
 
 StructuredListSkeleton.propTypes = {
-  /**
-   * Specify whether a border should be added to your StructuredListSkeleton
-   */
-  border: PropTypes.bool,
-
   /**
    * Specify an optional className to add.
    */
@@ -75,8 +68,7 @@ StructuredListSkeleton.propTypes = {
   rowCount: PropTypes.number
 };
 StructuredListSkeleton.defaultProps = {
-  rowCount: 5,
-  border: false
+  rowCount: 5
 };
 var StructuredListSkeleton$1 = StructuredListSkeleton;
 

package/es/components/StructuredList/StructuredList.js

@@ -30,7 +30,7 @@ function StructuredListWrapper(props) {
   const classes = cx(`${prefix}--structured-list`, className, {
     [`${prefix}--structured-list--selection`]: selection,
     [`${prefix}--structured-list--condensed`]: isCondensed,
-    [`${prefix}--structured-list--flush`]: isFlush
+    [`${prefix}--structured-list--flush`]: isFlush && !selection
   });
   const [selectedRow, setSelectedRow] = React__default.useState(null);
   return /*#__PURE__*/React__default.createElement(GridSelectedRowStateContext.Provider, {
@@ -72,7 +72,7 @@ StructuredListWrapper.propTypes = {
   isCondensed: PropTypes.bool,
 
   /**
-   * Specify if structured list is flush, default is false
+   * Specify if structured list is flush, not valid for selection variant, default is false
    */
   isFlush: PropTypes.bool,
 

package/es/components/Theme/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 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, { ElementType, type PropsWithChildren } from 'react';
+import { PolymorphicProps } from '../../types/common';
+interface GlobalThemeProps {
+    theme?: 'white' | 'g10' | 'g90' | 'g100';
+}
+export declare const ThemeContext: React.Context<GlobalThemeProps>;
+export declare function GlobalTheme({ children, theme, }: PropsWithChildren<GlobalThemeProps>): JSX.Element;
+export declare namespace GlobalTheme {
+    var propTypes: {
+        /**
+         * Provide child elements to be rendered inside of `GlobalTheme`, this is
+         * typically the root of your app
+         */
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Specify the global theme for your app
+         */
+        theme: PropTypes.Requireable<string>;
+    };
+}
+type ThemeBaseProps = GlobalThemeProps & {
+    className?: string;
+};
+type ThemeProps<E extends ElementType> = PolymorphicProps<E, ThemeBaseProps>;
+/**
+ * Specify the theme to be applied to a page, or a region in a page
+ */
+export declare function Theme<E extends ElementType = 'div'>({ as: BaseComponent, className: customClassName, theme, ...rest }: ThemeProps<E>): JSX.Element;
+export declare namespace Theme {
+    var propTypes: {
+        /**
+         * Specify a custom component or element to be rendered as the top-level
+         * element in the component
+         */
+        as: PropTypes.Requireable<NonNullable<((...args: any[]) => any) | PropTypes.ReactComponentLike | null | undefined>>;
+        /**
+         * Provide child elements to be rendered inside of `Theme`
+         */
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Provide a custom class name to be used on the outermost element rendered by
+         * the component
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Specify the theme
+         */
+        theme: PropTypes.Requireable<string>;
+    };
+}
+/**
+ * Get access to the current theme
+ */
+export declare function useTheme(): GlobalThemeProps;
+export {};

package/es/components/Theme/index.js

@@ -41,14 +41,13 @@ GlobalTheme.propTypes = {
    */
   theme: PropTypes.oneOf(['white', 'g10', 'g90', 'g100'])
 };
+
 /**
  * Specify the theme to be applied to a page, or a region in a page
  */
-
 function Theme(_ref2) {
   let {
     as: BaseComponent = 'div',
-    children,
     className: customClassName,
     theme,
     ...rest
@@ -66,13 +65,14 @@ function Theme(_ref2) {
       theme
     };
   }, [theme]);
+  const BaseComponentAsAny = BaseComponent;
   return /*#__PURE__*/React__default.createElement(ThemeContext.Provider, {
     value: value
   }, /*#__PURE__*/React__default.createElement(LayerContext.Provider, {
     value: 1
-  }, /*#__PURE__*/React__default.createElement(BaseComponent, _extends({}, rest, {
+  }, /*#__PURE__*/React__default.createElement(BaseComponentAsAny, _extends({}, rest, {
     className: className
-  }), children)));
+  }))));
 }
 Theme.propTypes = {
   /**

package/es/components/UIShell/HeaderContainer.js

@@ -7,6 +7,9 @@
 
 import PropTypes from 'prop-types';
 import React__default, { useState, useCallback } from 'react';
+import { useEvent } from '../../internal/useEvent.js';
+import { match } from '../../internal/keyboard/match.js';
+import { Escape } from '../../internal/keyboard/keys.js';
 
 const HeaderContainer = _ref => {
   let {
@@ -15,6 +18,11 @@ const HeaderContainer = _ref => {
   } = _ref;
   //state for expandable sidenav
   const [isSideNavExpandedState, setIsSideNavExpandedState] = useState(isSideNavExpanded);
+  useEvent(window, 'keydown', event => {
+    if (match(event, Escape)) {
+      setIsSideNavExpandedState(false);
+    }
+  });
   const handleHeaderMenuButtonClick = useCallback(() => {
     setIsSideNavExpandedState(prevIsSideNavExpanded => !prevIsSideNavExpanded);
   }, [setIsSideNavExpandedState]);

package/es/components/UIShell/HeaderMenuButton.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 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 { type ComponentProps } from 'react';
+import PropTypes from 'prop-types';
+type HeaderMenuButtonBaseProps = Omit<ComponentProps<'button'>, 'title' | 'type'>;
+interface HeaderMenuButtonProps extends HeaderMenuButtonBaseProps {
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+    className?: string;
+    renderMenuIcon?: JSX.Element;
+    renderCloseIcon?: JSX.Element;
+    isActive?: boolean;
+    isCollapsible?: boolean;
+}
+declare function HeaderMenuButton({ 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, className: customClassName, renderMenuIcon, renderCloseIcon, isActive, isCollapsible, ...rest }: HeaderMenuButtonProps): JSX.Element;
+declare namespace HeaderMenuButton {
+    var propTypes: {
+        /**
+         * Optionally provide a custom class name that is applied to the underlying
+         * button
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Specify whether the menu button is "active".
+         */
+        isActive: PropTypes.Requireable<boolean>;
+        /**
+         * Optionally provide an onClick handler that is called when the underlying
+         * button fires it's onclick event
+         */
+        onClick: PropTypes.Requireable<(...args: any[]) => any>;
+    };
+}
+export default HeaderMenuButton;

package/es/components/UIShell/HeaderMenuButton.js

@@ -14,7 +14,6 @@ import { AriaLabelPropType } from '../../prop-types/AriaPropTypes.js';
 import { usePrefix } from '../../internal/usePrefix.js';
 
 var _Menu, _Close;
-
 function HeaderMenuButton(_ref) {
   let {
     'aria-label': ariaLabel,
@@ -22,38 +21,34 @@ function HeaderMenuButton(_ref) {
     className: customClassName,
     renderMenuIcon,
     renderCloseIcon,
-    onClick,
     isActive,
     isCollapsible,
     ...rest
   } = _ref;
   const prefix = usePrefix();
-  const className = cx({
-    [customClassName]: !!customClassName,
+  const className = cx({ ...(typeof customClassName === 'string' && {
+      [customClassName]: !!customClassName
+    }),
     [`${prefix}--header__action`]: true,
     [`${prefix}--header__menu-trigger`]: true,
     [`${prefix}--header__action--active`]: isActive,
     [`${prefix}--header__menu-toggle`]: true,
     [`${prefix}--header__menu-toggle__hidden`]: !isCollapsible
   });
-  const accessibilityLabel = {
-    'aria-label': ariaLabel,
-    'aria-labelledby': ariaLabelledBy
-  };
   const menuIcon = renderMenuIcon ? renderMenuIcon : _Menu || (_Menu = /*#__PURE__*/React__default.createElement(Menu, {
     size: 20
   }));
   const closeIcon = renderCloseIcon ? renderCloseIcon : _Close || (_Close = /*#__PURE__*/React__default.createElement(Close, {
     size: 20
   }));
-  return /*#__PURE__*/React__default.createElement("button", _extends({}, rest, accessibilityLabel, {
+  return /*#__PURE__*/React__default.createElement("button", _extends({}, rest, {
+    "aria-label": ariaLabel,
+    "aria-labelledby": ariaLabelledBy,
     className: className,
     title: ariaLabel,
-    type: "button",
-    onClick: onClick
+    type: "button"
   }), isActive ? closeIcon : menuIcon);
 }
-
 HeaderMenuButton.propTypes = {
   /**
    * Required props for accessibility label on the underlying menu button

package/es/components/UIShell/HeaderNavigation.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 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 { type ComponentProps } from 'react';
+import PropTypes from 'prop-types';
+type HeaderNavigationProps = ComponentProps<'nav'>;
+declare function HeaderNavigation({ 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, children, className: customClassName, ...rest }: HeaderNavigationProps): JSX.Element;
+declare namespace HeaderNavigation {
+    var propTypes: {
+        /**
+         * Provide valid children of HeaderNavigation, for example `HeaderMenuItem`
+         * or `HeaderMenu`
+         */
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Optionally provide a custom class to apply to the underlying <nav> node
+         */
+        className: PropTypes.Requireable<string>;
+    };
+}
+export default HeaderNavigation;

package/es/components/UIShell/HeaderNavigation.js

@@ -12,29 +12,24 @@ import PropTypes from 'prop-types';
 import { AriaLabelPropType } from '../../prop-types/AriaPropTypes.js';
 import { usePrefix } from '../../internal/usePrefix.js';
 
-function HeaderNavigation(props) {
-  const {
+function HeaderNavigation(_ref) {
+  let {
     'aria-label': ariaLabel,
     'aria-labelledby': ariaLabelledBy,
     children,
     className: customClassName,
     ...rest
-  } = props;
+  } = _ref;
   const prefix = usePrefix();
-  const className = cx(`${prefix}--header__nav`, customClassName); // Assign both label strategies in this option, only one should be defined
-  // so when we spread that should be the one that is applied to the node
-
-  const accessibilityLabel = {
-    'aria-label': ariaLabel,
-    'aria-labelledby': ariaLabelledBy
-  };
-  return /*#__PURE__*/React__default.createElement("nav", _extends({}, rest, accessibilityLabel, {
+  const className = cx(`${prefix}--header__nav`, customClassName);
+  return /*#__PURE__*/React__default.createElement("nav", _extends({}, rest, {
+    "aria-label": ariaLabel,
+    "aria-labelledby": ariaLabelledBy,
     className: className
   }), /*#__PURE__*/React__default.createElement("ul", {
     className: `${prefix}--header__menu-bar`
   }, children));
 }
-
 HeaderNavigation.propTypes = {
   /**
    * Required props for accessibility label on the underlying menu
@@ -53,4 +48,4 @@ HeaderNavigation.propTypes = {
   className: PropTypes.string
 };
 
-export { HeaderNavigation, HeaderNavigation as default };
+export { HeaderNavigation as default };

package/es/components/UIShell/HeaderSideNavItems.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 { type ReactNode } from 'react';
+import PropTypes from 'prop-types';
+interface HeaderSideNavItemsProps {
+    className?: string | undefined;
+    children?: ReactNode;
+    hasDivider?: boolean | undefined;
+}
+declare function HeaderSideNavItems({ className: customClassName, children, hasDivider, }: HeaderSideNavItemsProps): JSX.Element;
+declare namespace HeaderSideNavItems {
+    var propTypes: {
+        /**
+         * The child nodes to be rendered
+         */
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Optionally provide a custom class name that is applied to the underlying
+         * button
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Optionally specify if container will have a bottom divider to differentiate
+         * between original sidenav items and header menu items. False by default.
+         */
+        hasDivider: PropTypes.Requireable<boolean>;
+    };
+}
+export default HeaderSideNavItems;

package/es/components/UIShell/HeaderSideNavItems.js

@@ -10,11 +10,11 @@ import React__default from 'react';
 import PropTypes from 'prop-types';
 import { usePrefix } from '../../internal/usePrefix.js';
 
-const HeaderSideNavItems = _ref => {
+function HeaderSideNavItems(_ref) {
   let {
     className: customClassName,
     children,
-    hasDivider
+    hasDivider = false
   } = _ref;
   const prefix = usePrefix();
   const className = cx({
@@ -24,8 +24,7 @@ const HeaderSideNavItems = _ref => {
   return /*#__PURE__*/React__default.createElement("ul", {
     className: className
   }, children);
-};
-
+}
 HeaderSideNavItems.propTypes = {
   /**
    * The child nodes to be rendered
@@ -44,9 +43,5 @@ HeaderSideNavItems.propTypes = {
    */
   hasDivider: PropTypes.bool
 };
-HeaderSideNavItems.defaultProps = {
-  hasDivider: false
-};
-var HeaderSideNavItems$1 = HeaderSideNavItems;
 
-export { HeaderSideNavItems$1 as default };
+export { HeaderSideNavItems as default };

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

@@ -0,0 +1,21 @@
+/**
+ * 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 React, { type ComponentProps, type FocusEvent, type KeyboardEvent, type MouseEventHandler } from 'react';
+interface SideNavProps extends ComponentProps<'nav'> {
+    expanded?: boolean | undefined;
+    defaultExpanded?: boolean | undefined;
+    isChildOfHeader?: boolean | undefined;
+    onToggle?: (event: FocusEvent<HTMLElement> | KeyboardEvent<HTMLElement> | boolean, value: boolean) => void | undefined;
+    isFixedNav?: boolean | undefined;
+    isRail?: boolean | undefined;
+    isPersistent?: boolean | undefined;
+    addFocusListeners?: boolean | undefined;
+    addMouseListeners?: boolean | undefined;
+    onOverlayClick?: MouseEventHandler<HTMLDivElement> | 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>>;
+export default SideNav;

package/es/components/UIShell/SideNav.js

@@ -6,35 +6,37 @@
  */
 
 import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
-import React__default, { useRef, useState } from 'react';
+import React__default, { useRef, useState, isValidElement } from 'react';
 import cx from 'classnames';
 import PropTypes from 'prop-types';
 import { AriaLabelPropType } from '../../prop-types/AriaPropTypes.js';
 import { CARBON_SIDENAV_ITEMS } from './_utils.js';
 import { usePrefix } from '../../internal/usePrefix.js';
+import { match } from '../../internal/keyboard/match.js';
+import { Escape } from '../../internal/keyboard/keys.js';
 
 // import SideNavFooter from './SideNavFooter';
 
-const SideNav = /*#__PURE__*/React__default.forwardRef(function SideNav(props, ref) {
-  const {
+function SideNavRenderFunction(_ref, ref) {
+  let {
     expanded: expandedProp,
-    defaultExpanded,
-    isChildOfHeader,
+    defaultExpanded = false,
+    isChildOfHeader = true,
     'aria-label': ariaLabel,
     'aria-labelledby': ariaLabelledBy,
     children,
     onToggle,
     className: customClassName,
     // TO-DO: comment back in when footer is added for rails
-    // translateById: t,
-    isFixedNav,
+    // translateById: t = (id) => translations[id],
+    isFixedNav = false,
     isRail,
-    isPersistent,
-    addFocusListeners,
-    addMouseListeners,
+    isPersistent = true,
+    addFocusListeners = true,
+    addMouseListeners = true,
     onOverlayClick,
     ...other
-  } = props;
+  } = _ref;
   const prefix = usePrefix();
   const {
     current: controlled
@@ -67,12 +69,11 @@ const SideNav = /*#__PURE__*/React__default.forwardRef(function SideNav(props, r
   //   ? t('carbon.sidenav.state.open')
   //   : t('carbon.sidenav.state.closed');
 
-  const className = cx({
+  const className = cx(customClassName, {
     [`${prefix}--side-nav`]: true,
     [`${prefix}--side-nav--expanded`]: expanded || expandedViaHoverState,
     [`${prefix}--side-nav--collapsed`]: !expanded && isFixedNav,
     [`${prefix}--side-nav--rail`]: isRail,
-    [customClassName]: !!customClassName,
     [`${prefix}--side-nav--ux`]: isChildOfHeader,
     [`${prefix}--side-nav--hidden`]: !isPersistent
   });
@@ -84,19 +85,25 @@ const SideNav = /*#__PURE__*/React__default.forwardRef(function SideNav(props, r
 
   if (isRail) {
     childrenToRender = React__default.Children.map(children, child => {
-      var _child$type, _child$type2;
-
       // if we are controlled, check for if we have hovered over or the expanded state, else just use the expanded state (uncontrolled)
-      let currentExpansionState = controlled ? expandedViaHoverState || expanded : expanded; // avoid spreading `isSideNavExpanded` to non-Carbon UI Shell children
+      const currentExpansionState = controlled ? expandedViaHoverState || expanded : expanded;
+
+      if ( /*#__PURE__*/isValidElement(child)) {
+        var _childJsxElement$type, _childJsxElement$type2;
+
+        const childJsxElement = child; // avoid spreading `isSideNavExpanded` to non-Carbon UI Shell children
+
+        return /*#__PURE__*/React__default.cloneElement(childJsxElement, { ...(CARBON_SIDENAV_ITEMS.includes(((_childJsxElement$type = childJsxElement.type) === null || _childJsxElement$type === void 0 ? void 0 : _childJsxElement$type.displayName) ?? ((_childJsxElement$type2 = childJsxElement.type) === null || _childJsxElement$type2 === void 0 ? void 0 : _childJsxElement$type2.name)) ? {
+            isSideNavExpanded: currentExpansionState
+          } : {})
+        });
+      }
 
-      return /*#__PURE__*/React__default.cloneElement(child, { ...(CARBON_SIDENAV_ITEMS.includes(((_child$type = child.type) === null || _child$type === void 0 ? void 0 : _child$type.displayName) ?? ((_child$type2 = child.type) === null || _child$type2 === void 0 ? void 0 : _child$type2.name)) ? {
-          isSideNavExpanded: currentExpansionState
-        } : {})
-      });
+      return child;
     });
   }
 
-  let eventHandlers = {};
+  const eventHandlers = {};
 
   if (addFocusListeners) {
     eventHandlers.onFocus = event => {
@@ -110,6 +117,12 @@ const SideNav = /*#__PURE__*/React__default.forwardRef(function SideNav(props, r
         handleToggle(event, false);
       }
     };
+
+    eventHandlers.onKeyDown = event => {
+      if (match(event, Escape)) {
+        handleToggle(event, false);
+      }
+    };
   }
 
   if (addMouseListeners && isRail) {
@@ -128,24 +141,10 @@ const SideNav = /*#__PURE__*/React__default.forwardRef(function SideNav(props, r
     ref: ref,
     className: `${prefix}--side-nav__navigation ${className}`
   }, accessibilityLabel, eventHandlers, other), childrenToRender));
-});
+}
+
+const SideNav = /*#__PURE__*/React__default.forwardRef(SideNavRenderFunction);
 SideNav.displayName = 'SideNav';
-SideNav.defaultProps = {
-  // TO-DO: comment back in when footer is added for rails
-  // translateById: (id) => {
-  //   const translations = {
-  //     'carbon.sidenav.state.open': 'Close',
-  //     'carbon.sidenav.state.closed': 'Open',
-  //   };
-  //   return translations[id];
-  // },
-  defaultExpanded: false,
-  isChildOfHeader: true,
-  isFixedNav: false,
-  isPersistent: true,
-  addFocusListeners: true,
-  addMouseListeners: true
-};
 SideNav.propTypes = {
   /**
    * Required props for accessibility label on the underlying menu

package/es/components/UIShell/SideNavFooter.js

@@ -45,6 +45,7 @@ function SideNavFooter(_ref) {
   }, assistiveText)));
 }
 
+SideNavFooter.displayName = 'SideNavFooter';
 SideNavFooter.propTypes = {
   /**
    * Provide text to be read to screen readers and shown as a tooltip when

package/es/components/UIShell/SideNavHeader.js

@@ -24,6 +24,7 @@ const SideNavHeader = _ref => {
   }, /*#__PURE__*/React__default.createElement(SideNavIcon, null, /*#__PURE__*/React__default.createElement(IconElement, null)), children);
 };
 
+SideNavHeader.displayName = 'SideNavHeader';
 SideNavHeader.propTypes = {
   /**
    * The child nodes to be rendered

package/es/components/UIShell/SideNavItems.js

@@ -35,6 +35,7 @@ const SideNavItems = _ref => {
   }, childrenWithExpandedState);
 };
 
+SideNavItems.displayName = 'SideNavItems';
 SideNavItems.propTypes = {
   /**
    * Provide a single icon as the child to `SideNavIcon` to render in the

package/es/components/UIShell/SideNavMenu.js

@@ -76,6 +76,7 @@ const SideNavMenu = /*#__PURE__*/React__default.forwardRef(function SideNavMenu(
     }, children))
   );
 });
+SideNavMenu.displayName = 'SideNavMenu';
 SideNavMenu.propTypes = {
   /**
    * Provide <SideNavMenuItem>'s inside of the `SideNavMenu`

package/es/index.js

@@ -11,6 +11,8 @@ export { default as CheckboxSkeleton } from './components/Checkbox/Checkbox.Skel
 export { ClassPrefix } from './components/ClassPrefix/index.js';
 export { default as ContentSwitcher } from './components/ContentSwitcher/index.js';
 import './components/DataTable/index.js';
+export { default as DatePicker } from './components/DatePicker/DatePicker.js';
+export { default as DatePickerSkeleton } from './components/DatePicker/DatePicker.Skeleton.js';
 export { default as Dropdown } from './components/Dropdown/Dropdown.js';
 export { default as DropdownSkeleton } from './components/Dropdown/Dropdown.Skeleton.js';
 export { default as FluidForm } from './components/FluidForm/FluidForm.js';
@@ -92,6 +94,7 @@ export { default as TreeView } from './components/TreeView/TreeView.js';
 export { default as HeaderMenuButton } from './components/UIShell/HeaderMenuButton.js';
 export { default as HeaderName } from './components/UIShell/HeaderName.js';
 export { default as HeaderNavigation } from './components/UIShell/HeaderNavigation.js';
+export { default as HeaderSideNavItems } from './components/UIShell/HeaderSideNavItems.js';
 export { default as SkipToContent } from './components/UIShell/SkipToContent.js';
 export { default as SideNavDivider } from './components/UIShell/SideNavDivider.js';
 export { default as SideNavFooter } from './components/UIShell/SideNavFooter.js';
@@ -149,8 +152,6 @@ export { default as TableToolbarAction } from './components/DataTable/TableToolb
 export { default as TableToolbarContent } from './components/DataTable/TableToolbarContent.js';
 export { default as TableToolbarSearch } from './components/DataTable/TableToolbarSearch.js';
 export { default as TableToolbarMenu } from './components/DataTable/TableToolbarMenu.js';
-export { default as DatePickerSkeleton } from './components/DatePicker/DatePicker.Skeleton.js';
-export { default as DatePicker } from './components/DatePicker/DatePicker.js';
 export { default as DatePickerInput } from './components/DatePickerInput/DatePickerInput.js';
 export { ErrorBoundaryContext } from './components/ErrorBoundary/ErrorBoundaryContext.js';
 export { default as FilterableMultiSelect } from './components/MultiSelect/FilterableMultiSelect.js';
@@ -205,7 +206,6 @@ export { default as HeaderGlobalBar } from './components/UIShell/HeaderGlobalBar
 export { default as HeaderMenu } from './components/UIShell/HeaderMenu.js';
 export { default as HeaderMenuItem } from './components/UIShell/HeaderMenuItem.js';
 export { default as HeaderPanel } from './components/UIShell/HeaderPanel.js';
-export { default as HeaderSideNavItems } from './components/UIShell/HeaderSideNavItems.js';
 export { default as Switcher } from './components/UIShell/Switcher.js';
 export { default as SwitcherItem } from './components/UIShell/SwitcherItem.js';
 export { default as SwitcherDivider } from './components/UIShell/SwitcherDivider.js';