@carbon/react 1.28.0 → 1.29.0

package/lib/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/lib/components/UIShell/HeaderMenuButton.js

@@ -24,7 +24,6 @@ var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
 
 var _Menu, _Close;
-
 function HeaderMenuButton(_ref) {
   let {
     'aria-label': ariaLabel,
@@ -32,38 +31,34 @@ function HeaderMenuButton(_ref) {
     className: customClassName,
     renderMenuIcon,
     renderCloseIcon,
-    onClick,
     isActive,
     isCollapsible,
     ...rest
   } = _ref;
   const prefix = usePrefix.usePrefix();
-  const className = cx__default["default"]({
-    [customClassName]: !!customClassName,
+  const className = cx__default["default"]({ ...(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["default"].createElement(iconsReact.Menu, {
     size: 20
   }));
   const closeIcon = renderCloseIcon ? renderCloseIcon : _Close || (_Close = /*#__PURE__*/React__default["default"].createElement(iconsReact.Close, {
     size: 20
   }));
-  return /*#__PURE__*/React__default["default"].createElement("button", _rollupPluginBabelHelpers["extends"]({}, rest, accessibilityLabel, {
+  return /*#__PURE__*/React__default["default"].createElement("button", _rollupPluginBabelHelpers["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/lib/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/lib/components/UIShell/HeaderNavigation.js

@@ -22,29 +22,24 @@ var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
 var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
 
-function HeaderNavigation(props) {
-  const {
+function HeaderNavigation(_ref) {
+  let {
     'aria-label': ariaLabel,
     'aria-labelledby': ariaLabelledBy,
     children,
     className: customClassName,
     ...rest
-  } = props;
+  } = _ref;
   const prefix = usePrefix.usePrefix();
-  const className = cx__default["default"](`${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["default"].createElement("nav", _rollupPluginBabelHelpers["extends"]({}, rest, accessibilityLabel, {
+  const className = cx__default["default"](`${prefix}--header__nav`, customClassName);
+  return /*#__PURE__*/React__default["default"].createElement("nav", _rollupPluginBabelHelpers["extends"]({}, rest, {
+    "aria-label": ariaLabel,
+    "aria-labelledby": ariaLabelledBy,
     className: className
   }), /*#__PURE__*/React__default["default"].createElement("ul", {
     className: `${prefix}--header__menu-bar`
   }, children));
 }
-
 HeaderNavigation.propTypes = {
   /**
    * Required props for accessibility label on the underlying menu
@@ -63,5 +58,4 @@ HeaderNavigation.propTypes = {
   className: PropTypes__default["default"].string
 };
 
-exports.HeaderNavigation = HeaderNavigation;
 exports["default"] = HeaderNavigation;

package/lib/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/lib/components/UIShell/HeaderSideNavItems.js

@@ -20,11 +20,11 @@ var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
 var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
 
-const HeaderSideNavItems = _ref => {
+function HeaderSideNavItems(_ref) {
   let {
     className: customClassName,
     children,
-    hasDivider
+    hasDivider = false
   } = _ref;
   const prefix = usePrefix.usePrefix();
   const className = cx__default["default"]({
@@ -34,8 +34,7 @@ const HeaderSideNavItems = _ref => {
   return /*#__PURE__*/React__default["default"].createElement("ul", {
     className: className
   }, children);
-};
-
+}
 HeaderSideNavItems.propTypes = {
   /**
    * The child nodes to be rendered
@@ -54,9 +53,5 @@ HeaderSideNavItems.propTypes = {
    */
   hasDivider: PropTypes__default["default"].bool
 };
-HeaderSideNavItems.defaultProps = {
-  hasDivider: false
-};
-var HeaderSideNavItems$1 = HeaderSideNavItems;
 
-exports["default"] = HeaderSideNavItems$1;
+exports["default"] = HeaderSideNavItems;

package/lib/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/lib/components/UIShell/SideNav.js

@@ -16,6 +16,8 @@ var PropTypes = require('prop-types');
 var AriaPropTypes = require('../../prop-types/AriaPropTypes.js');
 var _utils = require('./_utils.js');
 var usePrefix = require('../../internal/usePrefix.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 }; }
 
@@ -25,26 +27,26 @@ var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
 
 // import SideNavFooter from './SideNavFooter';
 
-const SideNav = /*#__PURE__*/React__default["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.usePrefix();
   const {
     current: controlled
@@ -77,12 +79,11 @@ const SideNav = /*#__PURE__*/React__default["default"].forwardRef(function SideN
   //   ? t('carbon.sidenav.state.open')
   //   : t('carbon.sidenav.state.closed');
 
-  const className = cx__default["default"]({
+  const className = cx__default["default"](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
   });
@@ -94,19 +95,25 @@ const SideNav = /*#__PURE__*/React__default["default"].forwardRef(function SideN
 
   if (isRail) {
     childrenToRender = React__default["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__*/React.isValidElement(child)) {
+        var _childJsxElement$type, _childJsxElement$type2;
+
+        const childJsxElement = child; // avoid spreading `isSideNavExpanded` to non-Carbon UI Shell children
+
+        return /*#__PURE__*/React__default["default"].cloneElement(childJsxElement, { ...(_utils.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["default"].cloneElement(child, { ...(_utils.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 => {
@@ -120,6 +127,12 @@ const SideNav = /*#__PURE__*/React__default["default"].forwardRef(function SideN
         handleToggle(event, false);
       }
     };
+
+    eventHandlers.onKeyDown = event => {
+      if (match.match(event, keys.Escape)) {
+        handleToggle(event, false);
+      }
+    };
   }
 
   if (addMouseListeners && isRail) {
@@ -138,24 +151,10 @@ const SideNav = /*#__PURE__*/React__default["default"].forwardRef(function SideN
     ref: ref,
     className: `${prefix}--side-nav__navigation ${className}`
   }, accessibilityLabel, eventHandlers, other), childrenToRender));
-});
+}
+
+const SideNav = /*#__PURE__*/React__default["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/lib/index.js

@@ -98,6 +98,7 @@ var TreeView = require('./components/TreeView/TreeView.js');
 var HeaderMenuButton = require('./components/UIShell/HeaderMenuButton.js');
 var HeaderName = require('./components/UIShell/HeaderName.js');
 var HeaderNavigation = require('./components/UIShell/HeaderNavigation.js');
+var HeaderSideNavItems = require('./components/UIShell/HeaderSideNavItems.js');
 var SkipToContent = require('./components/UIShell/SkipToContent.js');
 var SideNavDivider = require('./components/UIShell/SideNavDivider.js');
 var SideNavFooter = require('./components/UIShell/SideNavFooter.js');
@@ -209,7 +210,6 @@ var HeaderGlobalBar = require('./components/UIShell/HeaderGlobalBar.js');
 var HeaderMenu = require('./components/UIShell/HeaderMenu.js');
 var HeaderMenuItem = require('./components/UIShell/HeaderMenuItem.js');
 var HeaderPanel = require('./components/UIShell/HeaderPanel.js');
-var HeaderSideNavItems = require('./components/UIShell/HeaderSideNavItems.js');
 var Switcher = require('./components/UIShell/Switcher.js');
 var SwitcherItem = require('./components/UIShell/SwitcherItem.js');
 var SwitcherDivider = require('./components/UIShell/SwitcherDivider.js');
@@ -325,6 +325,7 @@ exports.TreeView = TreeView["default"];
 exports.HeaderMenuButton = HeaderMenuButton["default"];
 exports.HeaderName = HeaderName["default"];
 exports.HeaderNavigation = HeaderNavigation["default"];
+exports.HeaderSideNavItems = HeaderSideNavItems["default"];
 exports.SkipToContent = SkipToContent["default"];
 exports.SideNavDivider = SideNavDivider["default"];
 exports.SideNavFooter = SideNavFooter["default"];
@@ -461,7 +462,6 @@ exports.HeaderGlobalBar = HeaderGlobalBar["default"];
 exports.HeaderMenu = HeaderMenu["default"];
 exports.HeaderMenuItem = HeaderMenuItem["default"];
 exports.HeaderPanel = HeaderPanel["default"];
-exports.HeaderSideNavItems = HeaderSideNavItems["default"];
 exports.Switcher = Switcher["default"];
 exports.SwitcherItem = SwitcherItem["default"];
 exports.SwitcherDivider = SwitcherDivider["default"];

package/lib/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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@carbon/react",
   "description": "React components for the Carbon Design System",
-  "version": "1.28.0",
+  "version": "1.29.0",
   "license": "Apache-2.0",
   "main": "lib/index.js",
   "module": "es/index.js",
@@ -46,7 +46,7 @@
     "@carbon/feature-flags": "^0.13.0",
     "@carbon/icons-react": "^11.19.0",
     "@carbon/layout": "^11.13.0",
-    "@carbon/styles": "^1.28.0",
+    "@carbon/styles": "^1.29.0",
     "@carbon/telemetry": "0.1.0",
     "classnames": "2.3.2",
     "copy-to-clipboard": "^3.3.1",
@@ -109,7 +109,7 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "requestanimationframe": "^0.0.23",
-    "rimraf": "^4.0.0",
+    "rimraf": "^5.0.0",
     "rollup": "^2.79.1",
     "rollup-plugin-strip-banner": "^2.0.0",
     "rtlcss": "^4.0.0",
@@ -133,5 +133,5 @@
     "**/*.scss",
     "**/*.css"
   ],
-  "gitHead": "75f69e49161bf54184d4392c3d48115f852dc8fc"
+  "gitHead": "044bb55aff8c9cddef1a7e42d2bfeac59a89c546"
 }