@carbon/react 1.41.2 → 1.42.0-rc.0

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

@@ -0,0 +1,25 @@
+/**
+ * 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, { HTMLAttributes } from 'react';
+interface SideNavMenuItemProps extends HTMLAttributes<HTMLElement> {
+    /**
+     * Specify the children to be rendered inside of the `SideNavMenuItem`
+     */
+    children?: React.ReactNode;
+    /**
+     * Provide an optional class to be applied to the containing node
+     */
+    className?: string;
+    /**
+     * Optionally specify whether the link is "active". An active link is one that
+     * has an href that is the same as the current page. Can also pass in
+     * `aria-current="page"`, as well.
+     */
+    isActive?: boolean;
+}
+declare const SideNavMenuItem: React.ForwardRefExoticComponent<SideNavMenuItemProps & React.RefAttributes<HTMLElement>>;
+export default SideNavMenuItem;

package/es/components/UIShell/SideNavMenuItem.js

@@ -50,6 +50,5 @@ SideNavMenuItem.propTypes = {
    */
   isActive: PropTypes.bool
 };
-var SideNavMenuItem$1 = SideNavMenuItem;
 
-export { SideNavMenuItem$1 as default };
+export { SideNavMenuItem as default };

package/es/index.js

@@ -161,7 +161,6 @@ export { default as ModalWrapper } from './components/ModalWrapper/ModalWrapper.
 export { default as ProgressIndicatorSkeleton } from './components/ProgressIndicator/ProgressIndicator.Skeleton.js';
 export { default as TextInputSkeleton } from './components/TextInput/TextInput.Skeleton.js';
 export { default as TextInput } from './components/TextInput/TextInput.js';
-export { default as TreeNode } from './components/TreeView/TreeNode.js';
 export { default as TreeView } from './components/TreeView/TreeView.js';
 export { default as ProgressBar } from './components/ProgressBar/ProgressBar.js';
 export { default as unstable__FluidComboBox } from './components/FluidComboBox/FluidComboBox.js';
@@ -219,4 +218,5 @@ export { default as SkeletonIcon } from './components/SkeletonIcon/SkeletonIcon.
 export { default as SliderSkeleton } from './components/Slider/Slider.Skeleton.js';
 export { default as Switch } from './components/Switch/Switch.js';
 export { default as IconSwitch } from './components/Switch/IconSwitch.js';
+export { default as TreeNode } from './components/TreeView/TreeNode.js';
 export { Stack } from './components/Stack/Stack.js';

package/icons/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 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.
+ */
+export * from '@carbon/icons-react';

package/lib/components/Breadcrumb/Breadcrumb.Skeleton.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 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';
+export interface BreadcrumbSkeletonProps extends React.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Specify an optional className to add.
+     */
+    className?: string;
+}
+declare function BreadcrumbSkeleton({ className, ...rest }: BreadcrumbSkeletonProps): JSX.Element;
+declare namespace BreadcrumbSkeleton {
+    var propTypes: {
+        /**
+         * Specify an optional className to add.
+         */
+        className: PropTypes.Requireable<string>;
+    };
+}
+export default BreadcrumbSkeleton;
+export { BreadcrumbSkeleton };

package/lib/components/Breadcrumb/Breadcrumb.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 React from 'react';
+import { ForwardRefReturn } from '../../types/common';
+export interface BreadcrumbProps extends React.HTMLAttributes<HTMLElement> {
+    /**
+     * Specify the label for the breadcrumb container
+     */
+    'aria-label'?: string;
+    /**
+     * Specify an optional className to be applied to the container node
+     */
+    className?: string;
+    /**
+     * Optional prop to omit the trailing slash for the breadcrumbs
+     */
+    noTrailingSlash?: boolean;
+}
+declare const Breadcrumb: ForwardRefReturn<HTMLElement, BreadcrumbProps>;
+export default Breadcrumb;

package/lib/components/Breadcrumb/Breadcrumb.js

@@ -61,6 +61,5 @@ Breadcrumb.propTypes = {
    */
   noTrailingSlash: PropTypes__default["default"].bool
 };
-var Breadcrumb$1 = Breadcrumb;
 
-exports["default"] = Breadcrumb$1;
+exports["default"] = Breadcrumb;

package/lib/components/Breadcrumb/BreadcrumbItem.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 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, { AriaAttributes } from 'react';
+import { ForwardRefReturn } from '../../types/common';
+export interface BreadcrumbItemProps extends React.HTMLAttributes<HTMLLIElement> {
+    'aria-current'?: AriaAttributes['aria-current'];
+    /**
+     * Specify an optional className to be applied to the container node
+     */
+    className?: string;
+    /**
+     * Optional string representing the link location for the BreadcrumbItem
+     */
+    href?: string;
+    /**
+     * Provide if this breadcrumb item represents the current page
+     */
+    isCurrentPage?: boolean;
+}
+declare const BreadcrumbItem: ForwardRefReturn<HTMLLIElement, BreadcrumbItemProps>;
+export default BreadcrumbItem;

package/lib/components/Breadcrumb/BreadcrumbItem.js

@@ -29,7 +29,7 @@ const BreadcrumbItem = /*#__PURE__*/React__default["default"].forwardRef(functio
   let {
     'aria-current': ariaCurrent,
     children,
-    className: customClassName,
+    className: customClassName = '',
     href,
     isCurrentPage,
     ...rest
@@ -42,13 +42,14 @@ const BreadcrumbItem = /*#__PURE__*/React__default["default"].forwardRef(functio
     [`${prefix}--breadcrumb-item--current`]: isCurrentPage && ariaCurrent !== 'page',
     [customClassName]: !!customClassName
   });
-  if (children.type && children.type.displayName !== undefined && children.type.displayName.includes('OverflowMenu')) {
+  const child = children;
+  if (child.type && child.type.displayName !== undefined && child.type.displayName.includes('OverflowMenu')) {
     const horizontalOverflowIcon = /*#__PURE__*/React__default["default"].createElement(iconsReact.OverflowMenuHorizontal, {
       className: `${prefix}--overflow-menu__icon`
     });
     return /*#__PURE__*/React__default["default"].createElement("li", _rollupPluginBabelHelpers["extends"]({
       className: className
-    }, rest), /*#__PURE__*/React__default["default"].cloneElement(children, {
+    }, rest), /*#__PURE__*/React__default["default"].cloneElement(child, {
       menuOptionsClass: `${prefix}--breadcrumb-menu-options`,
       menuOffset: {
         top: 10,
@@ -71,13 +72,14 @@ const BreadcrumbItem = /*#__PURE__*/React__default["default"].forwardRef(functio
   return /*#__PURE__*/React__default["default"].createElement("li", _rollupPluginBabelHelpers["extends"]({
     className: className,
     ref: ref
-  }, rest), /*#__PURE__*/React__default["default"].cloneElement(children, {
+  }, rest), /*#__PURE__*/React__default["default"].cloneElement(child, {
     'aria-current': ariaCurrent,
-    className: cx__default["default"](`${prefix}--link`, children.props.className)
+    className: cx__default["default"](`${prefix}--link`, child.props.className)
   }));
 });
 BreadcrumbItem.displayName = 'BreadcrumbItem';
 BreadcrumbItem.propTypes = {
+  // @ts-expect-error - v12 TODO: BREAKING: This should match AriaAttributes['aria-current']
   'aria-current': PropTypes__default["default"].oneOfType([PropTypes__default["default"].string, PropTypes__default["default"].bool]),
   /**
    * Pass in content that will be inside of the BreadcrumbItem
@@ -96,6 +98,5 @@ BreadcrumbItem.propTypes = {
    */
   isCurrentPage: PropTypes__default["default"].bool
 };
-var BreadcrumbItem$1 = BreadcrumbItem;
 
-exports["default"] = BreadcrumbItem$1;
+exports["default"] = BreadcrumbItem;

package/lib/components/ComboBox/ComboBox.d.ts

@@ -9,10 +9,16 @@ import { type ComponentProps, type ReactNode, type ComponentType, type ReactElem
 import { ListBoxSize } from '../ListBox';
 type ExcludedAttributes = 'id' | 'onChange' | 'onClick' | 'type' | 'size';
 interface OnChangeData<ItemType> {
-    selectedItem: ItemType | null;
+    selectedItem: ItemType | null | undefined;
+    inputValue?: string | null;
 }
 type ItemToStringHandler<ItemType> = (item: ItemType | null) => string;
 export interface ComboBoxProps<ItemType> extends Omit<InputHTMLAttributes<HTMLInputElement>, ExcludedAttributes> {
+    /**
+     * Specify whether or not the ComboBox should allow a value that is
+     * not in the list to be entered in the input
+     */
+    allowCustomValue?: boolean;
     /**
      * Specify a label to be read by screen readers on the container node
      * 'aria-label' of the ListBox component.

package/lib/components/ComboBox/ComboBox.js

@@ -43,7 +43,8 @@ const {
   keyDownEscape,
   clickButton,
   blurButton,
-  changeInput
+  changeInput,
+  blurInput
 } = Downshift__default["default"].stateChangeTypes;
 const defaultItemToString = item => {
   if (typeof item === 'string') {
@@ -121,6 +122,7 @@ const ComboBox = /*#__PURE__*/React.forwardRef((props, ref) => {
     translateWithId,
     warn,
     warnText,
+    allowCustomValue = false,
     ...rest
   } = props;
   const prefix = usePrefix.usePrefix();
@@ -215,6 +217,17 @@ const ComboBox = /*#__PURE__*/React.forwardRef((props, ref) => {
       case changeInput:
         updateHighlightedIndex(getHighlightedIndex(changes));
         break;
+      case blurInput:
+        if (allowCustomValue) {
+          setInputValue(inputValue);
+          if (onChange) {
+            onChange({
+              selectedItem,
+              inputValue
+            });
+          }
+        }
+        break;
     }
   };
   const handleToggleClick = isOpen => event => {
@@ -313,8 +326,18 @@ const ComboBox = /*#__PURE__*/React.forwardRef((props, ref) => {
         if (match.match(event, keys.Space)) {
           event.stopPropagation();
         }
-        if (match.match(event, keys.Enter) && !inputValue) {
+        if (match.match(event, keys.Enter) && (!inputValue || allowCustomValue)) {
           toggleMenu();
+
+          // Since `onChange` does not normally fire when the menu is closed, we should
+          // manually fire it when `allowCustomValue` is provided, the menu is closing,
+          // and there is a value.
+          if (allowCustomValue && isOpen && inputValue) {
+            onChange({
+              selectedItem,
+              inputValue
+            });
+          }
         }
         if (match.match(event, keys.Escape) && inputValue) {
           if (event.target === textInput.current && isOpen) {
@@ -422,6 +445,11 @@ const ComboBox = /*#__PURE__*/React.forwardRef((props, ref) => {
 });
 ComboBox.displayName = 'ComboBox';
 ComboBox.propTypes = {
+  /**
+   * Specify whether or not the ComboBox should allow a value that is
+   * not in the list to be entered in the input
+   */
+  allowCustomValue: PropTypes__default["default"].bool,
   /**
    * 'aria-label' of the ListBox component.
    * Specify a label to be read by screen readers on the container node

package/lib/components/ContentSwitcher/ContentSwitcher.d.ts

@@ -40,7 +40,7 @@ export interface ContentSwitcherProps extends Omit<HTMLAttributes<HTMLElement>,
     /**
      * Choose whether or not to automatically change selection on focus
      */
-    selectionMode: 'automatic' | 'manual';
+    selectionMode?: 'automatic' | 'manual';
     /**
      * Specify the size of the Content Switcher. Currently supports either `sm`, 'md' (default) or 'lg` as an option.
      */

package/lib/components/DataTable/TableBatchAction.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 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';
+export interface TableBatchActionProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    /**
+     * Specify if the button is an icon-only button
+     */
+    hasIconOnly?: boolean;
+    /**
+     * If specifying the `renderIcon` prop, provide a description for that icon that can
+     * be read by screen readers
+     */
+    iconDescription?: string;
+    /**
+     * Optional function to render your own icon in the underlying button
+     */
+    renderIcon?: React.ElementType;
+}
+declare const TableBatchAction: {
+    ({ renderIcon, iconDescription, ...props }: {
+        [x: string]: any;
+        renderIcon?: import("@carbon/icons-react/lib/CarbonIcon").CarbonIconType | undefined;
+        iconDescription?: string | undefined;
+    }): JSX.Element;
+    propTypes: {
+        /**
+         * Specify if the button is an icon-only button
+         */
+        hasIconOnly: PropTypes.Requireable<boolean>;
+        /**
+         * If specifying the `renderIcon` prop, provide a description for that icon that can
+         * be read by screen readers
+         */
+        iconDescription: (props: any) => Error | undefined;
+        /**
+         * Optional function to render your own icon in the underlying button
+         */
+        renderIcon: PropTypes.Requireable<object>;
+    };
+};
+export default TableBatchAction;

package/lib/components/DataTable/TableBatchAction.js

@@ -52,6 +52,5 @@ TableBatchAction.propTypes = {
    */
   renderIcon: PropTypes__default["default"].oneOfType([PropTypes__default["default"].func, PropTypes__default["default"].object])
 };
-var TableBatchAction$1 = TableBatchAction;
 
-exports["default"] = TableBatchAction$1;
+exports["default"] = TableBatchAction;

package/lib/components/DataTable/TableExpandRow.d.ts

@@ -4,8 +4,7 @@
  * 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 { MouseEventHandler, PropsWithChildren } from 'react';
+import React, { MouseEventHandler, PropsWithChildren } from 'react';
 import { TableRowProps } from './TableRow';
 interface TableExpandRowProps extends PropsWithChildren<TableRowProps> {
     /**
@@ -41,48 +40,5 @@ interface TableExpandRowProps extends PropsWithChildren<TableRowProps> {
      */
     onExpand: MouseEventHandler<HTMLButtonElement>;
 }
-declare const TableExpandRow: {
-    ({ ["aria-controls"]: ariaControls, ["aria-label"]: ariaLabel, ariaLabel: deprecatedAriaLabel, className: rowClassName, children, isExpanded, onExpand, expandIconDescription, isSelected, expandHeader, ...rest }: TableExpandRowProps): JSX.Element;
-    propTypes: {
-        /**
-         * Space separated list of one or more ID values referencing the TableExpandedRow(s) being controlled by the TableExpandRow
-         * TODO: make this required in v12
-         */
-        "aria-controls": PropTypes.Requireable<string>;
-        /**
-         * Specify the string read by a voice reader when the expand trigger is
-         * focused
-         */
-        "aria-label": PropTypes.Requireable<string>;
-        /**
-         * Deprecated, please use `aria-label` instead.
-         * Specify the string read by a voice reader when the expand trigger is
-         * focused
-         */
-        ariaLabel: PropTypes.Requireable<string>;
-        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
-        className: PropTypes.Requireable<string>;
-        /**
-         * The id of the matching th node in the table head. Addresses a11y concerns outlined here: https://www.ibm.com/able/guidelines/ci162/info_and_relationships.html and https://www.w3.org/TR/WCAG20-TECHS/H43
-         */
-        expandHeader: PropTypes.Requireable<string>;
-        /**
-         * The description of the chevron right icon, to be put in its SVG `<title>` element.
-         */
-        expandIconDescription: PropTypes.Requireable<string>;
-        /**
-         * Specify whether this row is expanded or not. This helps coordinate data
-         * attributes so that `TableExpandRow` and `TableExpandedRow` work together
-         */
-        isExpanded: PropTypes.Validator<boolean>;
-        /**
-         * Specify if the row is selected
-         */
-        isSelected: PropTypes.Requireable<boolean>;
-        /**
-         * Hook for when a listener initiates a request to expand the given row
-         */
-        onExpand: PropTypes.Validator<(...args: any[]) => any>;
-    };
-};
+declare const TableExpandRow: React.ForwardRefExoticComponent<TableExpandRowProps & React.RefAttributes<HTMLTableCellElement>>;
 export default TableExpandRow;

package/lib/components/DataTable/TableExpandRow.js

@@ -23,7 +23,7 @@ var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
 var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
 var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 
-const TableExpandRow = _ref => {
+const TableExpandRow = /*#__PURE__*/React__default["default"].forwardRef((_ref, ref) => {
   let {
     ['aria-controls']: ariaControls,
     ['aria-label']: ariaLabel,
@@ -45,6 +45,7 @@ const TableExpandRow = _ref => {
   }, rowClassName);
   const previousValue = isExpanded ? 'collapsed' : undefined;
   return /*#__PURE__*/React__default["default"].createElement("tr", _rollupPluginBabelHelpers["extends"]({}, rest, {
+    ref: ref,
     className: className,
     "data-parent-row": true
   }), /*#__PURE__*/React__default["default"].createElement(TableCell["default"], {
@@ -63,17 +64,19 @@ const TableExpandRow = _ref => {
     className: `${prefix}--table-expand__svg`,
     "aria-label": expandIconDescription
   }))), children);
-};
+});
 TableExpandRow.propTypes = {
   /**
    * Space separated list of one or more ID values referencing the TableExpandedRow(s) being controlled by the TableExpandRow
    * TODO: make this required in v12
    */
+  /**@ts-ignore*/
   ['aria-controls']: PropTypes__default["default"].string,
   /**
    * Specify the string read by a voice reader when the expand trigger is
    * focused
    */
+  /**@ts-ignore*/
   ['aria-label']: PropTypes__default["default"].string,
   /**
    * Deprecated, please use `aria-label` instead.
@@ -105,5 +108,6 @@ TableExpandRow.propTypes = {
    */
   onExpand: PropTypes__default["default"].func.isRequired
 };
+TableExpandRow.displayName = 'TableExpandRow';
 
 exports["default"] = TableExpandRow;

package/lib/components/Dropdown/Dropdown.d.ts

@@ -101,7 +101,7 @@ export interface DropdownProps<ItemType> extends Omit<ReactAttr<HTMLDivElement>,
      * An optional callback to render the currently selected item as a react element instead of only
      * as a string.
      */
-    renderSelectedItem?(item: ItemType): string;
+    renderSelectedItem?(item: ItemType): React.JSXElementConstructor<ItemType> | null;
     /**
      * In the case you want to control the dropdown selection entirely.
      */

package/lib/components/Tabs/Tabs.js

@@ -598,8 +598,7 @@ const Tab = /*#__PURE__*/React.forwardRef(function Tab(_ref5, forwardRef) {
   }, /*#__PURE__*/React__default["default"].createElement(Icon, {
     size: 16
   })), /*#__PURE__*/React__default["default"].createElement(Text.Text, {
-    className: `${prefix}--tabs__nav-item-label`,
-    title: children
+    className: `${prefix}--tabs__nav-item-label`
   }, children), /*#__PURE__*/React__default["default"].createElement("div", {
     className: cx__default["default"](`${prefix}--tabs__nav-item--icon`, {
       [`${prefix}--visually-hidden`]: !hasIcon

package/lib/components/TreeView/TreeNode.js

@@ -25,7 +25,7 @@ var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
 var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
 
-function TreeNode(_ref) {
+const TreeNode = /*#__PURE__*/React__default["default"].forwardRef((_ref, ref) => {
   let {
     active,
     children,
@@ -230,7 +230,8 @@ function TreeNode(_ref) {
     /*#__PURE__*/
     // eslint-disable-next-line jsx-a11y/role-supports-aria-props
     React__default["default"].createElement("li", _rollupPluginBabelHelpers["extends"]({}, treeNodeProps, {
-      "aria-expanded": !!expanded
+      "aria-expanded": !!expanded,
+      ref: ref
     }), /*#__PURE__*/React__default["default"].createElement("div", {
       className: `${prefix}--tree-node__label`,
       ref: currentNodeLabel
@@ -249,7 +250,7 @@ function TreeNode(_ref) {
       className: `${prefix}--tree-node__children`
     }, nodesWithProps))
   );
-}
+});
 TreeNode.propTypes = {
   /**
    * The value of the active node in the tree
@@ -309,5 +310,7 @@ TreeNode.propTypes = {
    */
   value: PropTypes__default["default"].string
 };
+TreeNode.displayName = 'TreeNode';
+var TreeNode$1 = TreeNode;
 
-exports["default"] = TreeNode;
+exports["default"] = TreeNode$1;

package/lib/components/UIShell/HeaderMenu.js

@@ -158,7 +158,7 @@ class HeaderMenu extends React__default["default"].Component {
       onKeyDown,
       ...rest
     } = this.props;
-    const hasActiveChildren = React__default["default"].Children.toArray(children).some(child => child.props.isActive || child.props.isCurrentPage);
+    const hasActiveDescendant = childrenArg => React__default["default"].Children.toArray(childrenArg).some(child => child.props.isActive || child.props.isCurrentPage || child.props.children instanceof Array && hasActiveDescendant(child.props.children));
     const accessibilityLabel = {
       'aria-label': ariaLabel,
       'aria-labelledby': ariaLabelledBy
@@ -173,7 +173,7 @@ 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 || hasActiveChildren && !this.state.expanded
+      [`${prefix}--header__menu-item--current`]: isActivePage || hasActiveDescendant(children) && !this.state.expanded
     });
 
     // Notes on eslint comments and based on the examples in:

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

@@ -25,5 +25,5 @@ interface SideNavContextData {
     isRail?: boolean | undefined;
 }
 export declare const SideNavContext: React.Context<SideNavContextData>;
-declare const SideNav: React.ForwardRefExoticComponent<Pick<SideNavProps, "children" | "slot" | "style" | "title" | "className" | "dir" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "onToggle" | "key" | "id" | "aria-controls" | "aria-expanded" | "onClick" | "onAnimationEnd" | "onKeyDown" | "tabIndex" | "color" | "lang" | "role" | "href" | "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" | "contentEditable" | "contextMenu" | "draggable" | "hidden" | "placeholder" | "spellCheck" | "translate" | "radioGroup" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "expanded" | "enterDelayMs" | "defaultExpanded" | "addFocusListeners" | "isChildOfHeader" | "isFixedNav" | "isRail" | "isPersistent" | "addMouseListeners" | "onOverlayClick" | "onSideNavBlur" | "inert"> & React.RefAttributes<HTMLElement>>;
+declare const SideNav: React.ForwardRefExoticComponent<Pick<SideNavProps, "children" | "slot" | "style" | "title" | "className" | "dir" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "onToggle" | "key" | "id" | "aria-controls" | "aria-expanded" | "onClick" | "onAnimationEnd" | "onKeyDown" | "tabIndex" | "color" | "lang" | "role" | "href" | "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" | "contentEditable" | "contextMenu" | "draggable" | "hidden" | "placeholder" | "spellCheck" | "translate" | "radioGroup" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "expanded" | "enterDelayMs" | "defaultExpanded" | "inert" | "addFocusListeners" | "isChildOfHeader" | "isFixedNav" | "isRail" | "isPersistent" | "addMouseListeners" | "onOverlayClick" | "onSideNavBlur"> & React.RefAttributes<HTMLElement>>;
 export default SideNav;

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

@@ -0,0 +1,52 @@
+/**
+ * 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 from 'react';
+import PropTypes from 'prop-types';
+export interface SideNavFooterProps {
+    /**
+     * Provide text to be read to screen readers and shown as a tooltip when
+     * interacting with the toggle button in the footer
+     */
+    assistiveText: string;
+    className?: string;
+    /**
+     * Specify whether the side navigation is expanded or collapsed
+     */
+    expanded: boolean;
+    /**
+     * Provide a function that is called when the toggle button is interacted
+     * with. Useful for controlling the expansion state of the side navigation.
+     */
+    onToggle: (event: React.MouseEvent<HTMLButtonElement>) => void;
+}
+/**
+ * SideNavFooter is used for rendering the button at the bottom of the side
+ * navigation that is a part of the UI Shell. It is responsible for handling the
+ * user interaction to expand or collapse the side navigation.
+ */
+declare function SideNavFooter({ assistiveText, className: customClassName, expanded, onToggle, }: SideNavFooterProps): JSX.Element;
+declare namespace SideNavFooter {
+    var displayName: string;
+    var propTypes: {
+        /**
+         * Provide text to be read to screen readers and shown as a tooltip when
+         * interacting with the toggle button in the footer
+         */
+        assistiveText: PropTypes.Requireable<string>;
+        className: PropTypes.Requireable<string>;
+        /**
+         * Specify whether the side navigation is expanded or collapsed
+         */
+        expanded: PropTypes.Validator<boolean>;
+        /**
+         * Provide a function that is called when the toggle button is interacted
+         * with. Useful for controlling the expansion state of the side navigation.
+         */
+        onToggle: PropTypes.Validator<(...args: any[]) => any>;
+    };
+}
+export default SideNavFooter;

package/lib/components/UIShell/SideNavFooter.js

@@ -22,7 +22,6 @@ var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
 
 var _Close, _ChevronRight;
-
 /**
  * SideNavFooter is used for rendering the button at the bottom of the side
  * navigation that is a part of the UI Shell. It is responsible for handling the