@carbon/react 1.28.0 → 1.29.0

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/index.js

@@ -94,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';
@@ -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';

package/es/types/common.d.ts

@@ -0,0 +1,11 @@
+import * as React from 'react';
+export type ReactAttr<T = HTMLElement> = React.HTMLAttributes<T>;
+export type ForwardRefProps<T, P = unknown> = React.PropsWithoutRef<React.PropsWithChildren<P>> & React.RefAttributes<T>;
+export type ForwardRefReturn<T, P = unknown> = React.ForwardRefExoticComponent<ForwardRefProps<T, P>>;
+/**
+ * For "as" props.  Creates an "as" property that supports native html tags such as 'span', 'a', 'button' as well as custom functional components
+ * All native props for the supplied html tag/component are inferred as part of the base component props, allowing us to use props like `href` on an 'a' element ect
+ */
+export type PolymorphicProps<Element extends React.ElementType, Props> = Props & Omit<React.ComponentProps<Element>, 'as'> & {
+    as?: Element;
+};

package/lib/components/Checkbox/Checkbox.d.ts

@@ -44,7 +44,7 @@ export interface CheckboxProps extends Omit<React.InputHTMLAttributes<HTMLInputE
     /**
      * Provide the text that is displayed when the Checkbox is in an invalid state
      */
-    invalidText: React.ReactNode;
+    invalidText?: React.ReactNode;
     /**
      * Specify whether the Checkbox is currently invalid
      */
@@ -52,7 +52,7 @@ export interface CheckboxProps extends Omit<React.InputHTMLAttributes<HTMLInputE
     /**
      * Provide the text that is displayed when the Checkbox is in an invalid state
      */
-    warnText: React.ReactNode;
+    warnText?: React.ReactNode;
     /**
      * Provide an optional handler that is called when the internal state of
      * Checkbox changes. This handler is called with event and state info.

package/lib/components/Heading/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 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 { type ElementType } from 'react';
+import type { PolymorphicProps } from '../../types/common';
+type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+type SectionBaseProps = {
+    level?: HeadingLevel;
+};
+type SectionProps<E extends ElementType> = PolymorphicProps<E, SectionBaseProps>;
+export declare function Section<E extends ElementType = 'section'>({ as: BaseComponent, level: levelOverride, ...rest }: SectionProps<E>): JSX.Element;
+export declare namespace Section {
+    var propTypes: {
+        /**
+         * Provide an alternative tag or component to use instead of the default
+         * <section> element
+         */
+        as: PropTypes.Requireable<PropTypes.ReactComponentLike>;
+        /**
+         * Specify the content that will be placed in the component
+         */
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Specify a class name for the outermost node of the component
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Overrides the level of the section
+         */
+        level: PropTypes.Requireable<number>;
+    };
+}
+type HeadingProps = JSX.IntrinsicElements[`h${HeadingLevel}`];
+export declare function Heading(props: HeadingProps): JSX.Element;
+export declare namespace Heading {
+    var propTypes: {
+        /**
+         * Specify the content that will be placed in the component
+         */
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Specify a class name for the outermost node of the component
+         */
+        className: PropTypes.Requireable<string>;
+    };
+}
+export {};

package/lib/components/Heading/index.js

@@ -18,21 +18,19 @@ var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
 var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 
 const HeadingContext = /*#__PURE__*/React__default["default"].createContext(1);
-
 function Section(_ref) {
   let {
     as: BaseComponent = 'section',
     level: levelOverride,
-    children,
     ...rest
   } = _ref;
   const parentLevel = React__default["default"].useContext(HeadingContext);
-  const level = typeof levelOverride !== 'undefined' ? levelOverride : parentLevel + 1;
+  const level = levelOverride ?? parentLevel + 1;
+  const BaseComponentAsAny = BaseComponent;
   return /*#__PURE__*/React__default["default"].createElement(HeadingContext.Provider, {
     value: Math.min(level, 6)
-  }, /*#__PURE__*/React__default["default"].createElement(BaseComponent, rest, children));
+  }, /*#__PURE__*/React__default["default"].createElement(BaseComponentAsAny, rest));
 }
-
 Section.propTypes = {
   /**
    * Provide an alternative tag or component to use instead of the default
@@ -55,12 +53,10 @@ Section.propTypes = {
    */
   level: PropTypes__default["default"].number
 };
-
 function Heading(props) {
-  const level = React__default["default"].useContext(HeadingContext);
-  return /*#__PURE__*/React__default["default"].createElement(`h${level}`, props);
+  const HeadingIntrinsic = `h${React__default["default"].useContext(HeadingContext)}`;
+  return /*#__PURE__*/React__default["default"].createElement(HeadingIntrinsic, props);
 }
-
 Heading.propTypes = {
   /**
    * Specify the content that will be placed in the component

package/lib/components/Slider/Slider.d.ts

@@ -41,9 +41,13 @@ export interface SliderProps extends Omit<React.InputHTMLAttributes<HTMLInputEle
      */
     inputType?: string;
     /**
-     * `true` to specify if the control is invalid.
+     * `Specify whether the Slider is currently invalid
      */
     invalid?: boolean;
+    /**
+     * Provide the text that is displayed when the Slider is in an invalid state
+     */
+    invalidText?: React.ReactNode;
     /**
      * The label for the slider.
      */
@@ -119,6 +123,14 @@ export interface SliderProps extends Omit<React.InputHTMLAttributes<HTMLInputEle
      * The value.
      */
     value: number;
+    /**
+     * Specify whether the control is currently in warning state
+     */
+    warn?: boolean;
+    /**
+     * Provide the text that is displayed when the control is in warning state
+     */
+    warnText?: React.ReactNode;
 }
 interface CalcValueProps {
     clientX?: number;
@@ -160,9 +172,13 @@ export default class Slider extends PureComponent<SliderProps> {
          */
         inputType: PropTypes.Requireable<string>;
         /**
-         * `true` to specify if the control is invalid.
+         * `Specify whether the Slider is currently invalid
          */
         invalid: PropTypes.Requireable<boolean>;
+        /**
+         * Provide the text that is displayed when the Slider is in an invalid state
+         */
+        invalidText: PropTypes.Requireable<PropTypes.ReactNodeLike>;
         /**
          * The label for the slider.
          */
@@ -229,6 +245,14 @@ export default class Slider extends PureComponent<SliderProps> {
          * The value.
          */
         value: PropTypes.Validator<number>;
+        /**
+         * `Specify whether the Slider is in a warn state
+         */
+        warn: PropTypes.Requireable<boolean>;
+        /**
+         * Provide the text that is displayed when the Slider is in an warn state
+         */
+        warnText: PropTypes.Requireable<PropTypes.ReactNodeLike>;
     };
     static defaultProps: {
         hideTextInput: boolean;

package/lib/components/Slider/Slider.js

@@ -20,6 +20,7 @@ var match = require('../../internal/keyboard/match.js');
 var usePrefix = require('../../internal/usePrefix.js');
 var deprecate = require('../../prop-types/deprecate.js');
 var index = require('../FeatureFlags/index.js');
+var iconsReact = require('@carbon/icons-react');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -444,11 +445,14 @@ class Slider extends React.PureComponent {
       step,
       stepMultiplier: _stepMultiplier,
       inputType,
+      invalidText,
       required,
       disabled,
       name,
       light,
       readOnly,
+      warn,
+      warnText,
       ...other
     } = this.props;
     delete other.onRelease;
@@ -476,8 +480,9 @@ class Slider extends React.PureComponent {
       }, [enabled ? null : className]);
       const inputClasses = cx__default["default"](`${prefix}--text-input`, `${prefix}--slider-text-input`, {
         [`${prefix}--text-input--light`]: light,
-        [`${prefix}--text-input--invalid`]: isValid === false,
-        [`${prefix}--slider-text-input--hidden`]: hideTextInput
+        [`${prefix}--text-input--invalid`]: !readOnly && isValid === false,
+        [`${prefix}--slider-text-input--hidden`]: hideTextInput,
+        [`${prefix}--slider-text-input--warn`]: !readOnly && warn
       });
       return /*#__PURE__*/React__default["default"].createElement("div", {
         className: enabled ? cx__default["default"](`${prefix}--form-item`, className) : `${prefix}--form-item`
@@ -499,7 +504,7 @@ class Slider extends React.PureComponent {
         onKeyDown: this.onKeyDown,
         role: "presentation",
         tabIndex: -1,
-        "data-invalid": isValid ? null : true
+        "data-invalid": !isValid && !readOnly ? true : null
       }, other), /*#__PURE__*/React__default["default"].createElement("div", {
         className: `${prefix}--slider__thumb`,
         role: "slider",
@@ -536,10 +541,18 @@ class Slider extends React.PureComponent {
         onChange: this.onChange,
         onBlur: this.onBlur,
         onKeyUp: this.props.onInputKeyUp,
-        "data-invalid": isValid ? null : true,
-        "aria-invalid": isValid ? undefined : true,
+        "data-invalid": !isValid && !readOnly ? true : null,
+        "aria-invalid": !isValid && !readOnly ? true : undefined,
         readOnly: readOnly
-      })));
+      }), !readOnly && isValid === false && /*#__PURE__*/React__default["default"].createElement(iconsReact.WarningFilled, {
+        className: `${prefix}--slider__invalid-icon`
+      }), !readOnly && warn && isValid && /*#__PURE__*/React__default["default"].createElement(iconsReact.WarningAltFilled, {
+        className: `${prefix}--slider__invalid-icon ${prefix}--slider__invalid-icon--warning`
+      })), !readOnly && isValid === false && /*#__PURE__*/React__default["default"].createElement("div", {
+        className: cx__default["default"](`${prefix}--slider__validation-msg`, `${prefix}--slider__validation-msg--invalid`, `${prefix}--form-requirement`)
+      }, invalidText), !readOnly && warn && isValid && /*#__PURE__*/React__default["default"].createElement("div", {
+        className: cx__default["default"](`${prefix}--slider__validation-msg`, `${prefix}--form-requirement`)
+      }, warnText));
     });
   }
 
@@ -587,10 +600,15 @@ _rollupPluginBabelHelpers.defineProperty(Slider, "propTypes", {
   inputType: PropTypes__default["default"].string,
 
   /**
-   * `true` to specify if the control is invalid.
+   * `Specify whether the Slider is currently invalid
    */
   invalid: PropTypes__default["default"].bool,
 
+  /**
+   * Provide the text that is displayed when the Slider is in an invalid state
+   */
+  invalidText: PropTypes__default["default"].node,
+
   /**
    * The label for the slider.
    */
@@ -671,7 +689,17 @@ _rollupPluginBabelHelpers.defineProperty(Slider, "propTypes", {
   /**
    * The value.
    */
-  value: PropTypes__default["default"].number.isRequired
+  value: PropTypes__default["default"].number.isRequired,
+
+  /**
+   * `Specify whether the Slider is in a warn state
+   */
+  warn: PropTypes__default["default"].bool,
+
+  /**
+   * Provide the text that is displayed when the Slider is in an warn state
+   */
+  warnText: PropTypes__default["default"].node
 });
 
 _rollupPluginBabelHelpers.defineProperty(Slider, "defaultProps", {

package/lib/components/StructuredList/StructuredList.Skeleton.js

@@ -26,15 +26,13 @@ var _span, _span2, _span3;
 const StructuredListSkeleton = _ref => {
   let {
     rowCount,
-    border,
     className,
     ...rest
   } = _ref;
   const prefix = usePrefix.usePrefix();
   const StructuredListSkeletonClasses = cx__default["default"](className, {
     [`${prefix}--skeleton`]: true,
-    [`${prefix}--structured-list`]: true,
-    [`${prefix}--structured-list--border`]: border
+    [`${prefix}--structured-list`]: true
   });
   const rows = [];
 
@@ -69,11 +67,6 @@ const StructuredListSkeleton = _ref => {
 };
 
 StructuredListSkeleton.propTypes = {
-  /**
-   * Specify whether a border should be added to your StructuredListSkeleton
-   */
-  border: PropTypes__default["default"].bool,
-
   /**
    * Specify an optional className to add.
    */
@@ -85,8 +78,7 @@ StructuredListSkeleton.propTypes = {
   rowCount: PropTypes__default["default"].number
 };
 StructuredListSkeleton.defaultProps = {
-  rowCount: 5,
-  border: false
+  rowCount: 5
 };
 var StructuredListSkeleton$1 = StructuredListSkeleton;
 

package/lib/components/StructuredList/StructuredList.js

@@ -40,7 +40,7 @@ function StructuredListWrapper(props) {
   const classes = cx__default["default"](`${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["default"].useState(null);
   return /*#__PURE__*/React__default["default"].createElement(GridSelectedRowStateContext.Provider, {
@@ -82,7 +82,7 @@ StructuredListWrapper.propTypes = {
   isCondensed: PropTypes__default["default"].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__default["default"].bool,
 

package/lib/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/lib/components/Theme/index.js

@@ -51,14 +51,13 @@ GlobalTheme.propTypes = {
    */
   theme: PropTypes__default["default"].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
@@ -76,13 +75,14 @@ function Theme(_ref2) {
       theme
     };
   }, [theme]);
+  const BaseComponentAsAny = BaseComponent;
   return /*#__PURE__*/React__default["default"].createElement(ThemeContext.Provider, {
     value: value
   }, /*#__PURE__*/React__default["default"].createElement(LayerContext.LayerContext.Provider, {
     value: 1
-  }, /*#__PURE__*/React__default["default"].createElement(BaseComponent, _rollupPluginBabelHelpers["extends"]({}, rest, {
+  }, /*#__PURE__*/React__default["default"].createElement(BaseComponentAsAny, _rollupPluginBabelHelpers["extends"]({}, rest, {
     className: className
-  }), children)));
+  }))));
 }
 Theme.propTypes = {
   /**

package/lib/components/UIShell/HeaderContainer.js

@@ -11,6 +11,9 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var PropTypes = require('prop-types');
 var React = require('react');
+var useEvent = require('../../internal/useEvent.js');
+var match = require('../../internal/keyboard/match.js');
+var keys = require('../../internal/keyboard/keys.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -24,6 +27,11 @@ const HeaderContainer = _ref => {
   } = _ref;
   //state for expandable sidenav
   const [isSideNavExpandedState, setIsSideNavExpandedState] = React.useState(isSideNavExpanded);
+  useEvent.useWindowEvent('keydown', event => {
+    if (match.match(event, keys.Escape)) {
+      setIsSideNavExpandedState(false);
+    }
+  });
   const handleHeaderMenuButtonClick = React.useCallback(() => {
     setIsSideNavExpandedState(prevIsSideNavExpanded => !prevIsSideNavExpanded);
   }, [setIsSideNavExpandedState]);