@carbon/react 1.44.0 → 1.45.0

package/lib/components/Tag/Tag.js

@@ -54,6 +54,7 @@ const Tag = _ref => {
     onClose,
     size,
     as: BaseComponent,
+    slug,
     ...other
   } = _ref;
   const prefix = usePrefix.usePrefix();
@@ -74,15 +75,26 @@ const Tag = _ref => {
       onClose(event);
     }
   };
+
+  // Slug is always size `md` and `inline`
+  let normalizedSlug;
+  if (slug && slug['type']?.displayName === 'Slug') {
+    normalizedSlug = /*#__PURE__*/React__default["default"].cloneElement(slug, {
+      size: 'sm',
+      kind: 'inline'
+    });
+  }
   if (filter) {
     const ComponentTag = BaseComponent ?? 'div';
     return /*#__PURE__*/React__default["default"].createElement(ComponentTag, _rollupPluginBabelHelpers["extends"]({
       className: tagClasses,
       id: tagId
-    }, other), /*#__PURE__*/React__default["default"].createElement(Text.Text, {
+    }, other), CustomIconElement ? /*#__PURE__*/React__default["default"].createElement("div", {
+      className: `${prefix}--tag__custom-icon`
+    }, /*#__PURE__*/React__default["default"].createElement(CustomIconElement, null)) : '', /*#__PURE__*/React__default["default"].createElement(Text.Text, {
       className: `${prefix}--tag__label`,
       title: typeof children === 'string' ? children : undefined
-    }, children !== null && children !== undefined ? children : typeText), /*#__PURE__*/React__default["default"].createElement("button", {
+    }, children !== null && children !== undefined ? children : typeText), normalizedSlug, /*#__PURE__*/React__default["default"].createElement("button", {
       type: "button",
       className: `${prefix}--tag__close-icon`,
       onClick: handleClose,
@@ -100,7 +112,7 @@ const Tag = _ref => {
     className: `${prefix}--tag__custom-icon`
   }, /*#__PURE__*/React__default["default"].createElement(CustomIconElement, null)) : '', /*#__PURE__*/React__default["default"].createElement(Text.Text, {
     title: typeof children === 'string' ? children : undefined
-  }, children !== null && children !== undefined ? children : typeText));
+  }, children !== null && children !== undefined ? children : typeText), normalizedSlug);
 };
 Tag.propTypes = {
   /**
@@ -109,7 +121,7 @@ Tag.propTypes = {
    */
   as: PropTypes__default["default"].elementType,
   /**
-   * Provide content to be rendered inside of a <Tag>
+   * Provide content to be rendered inside of a `Tag`
    */
   children: PropTypes__default["default"].node,
   /**
@@ -117,11 +129,11 @@ Tag.propTypes = {
    */
   className: PropTypes__default["default"].string,
   /**
-   * Specify if the <Tag> is disabled
+   * Specify if the `Tag` is disabled
    */
   disabled: PropTypes__default["default"].bool,
   /**
-   * Determine if <Tag> is a filter/chip
+   * Determine if `Tag` is a filter/chip
    */
   filter: PropTypes__default["default"].bool,
   /**
@@ -142,12 +154,16 @@ Tag.propTypes = {
    * 'md' (default) sizes.
    */
   size: PropTypes__default["default"].oneOf(['sm', 'md']),
+  /**
+   * **Experimental:** Provide a `Slug` component to be rendered inside the `Tag` component
+   */
+  slug: PropTypes__default["default"].node,
   /**
    * Text to show on clear filters
    */
   title: PropTypes__default["default"].string,
   /**
-   * Specify the type of the <Tag>
+   * Specify the type of the `Tag`
    */
   type: PropTypes__default["default"].oneOf(Object.keys(TYPES))
 };

package/lib/components/TextArea/TextArea.d.ts

@@ -25,7 +25,7 @@ export interface TextAreaProps extends React.InputHTMLAttributes<HTMLTextAreaEle
      */
     disabled?: boolean;
     /**
-     * Specify whether to display the character counter
+     * Specify whether to display the counter
      */
     enableCounter?: boolean;
     /**
@@ -60,7 +60,7 @@ export interface TextAreaProps extends React.InputHTMLAttributes<HTMLTextAreaEle
      */
     light?: boolean;
     /**
-     * Max character count allowed for the textarea. This is needed in order for enableCounter to display
+     * Max entity count allowed for the textarea. This is needed in order for enableCounter to display
      */
     maxCount?: number;
     /**
@@ -86,7 +86,7 @@ export interface TextAreaProps extends React.InputHTMLAttributes<HTMLTextAreaEle
      */
     rows?: number;
     /**
-     * Provide a `Slug` component to be rendered inside the `TextArea` component
+     * **Experimental**: Provide a `Slug` component to be rendered inside the `TextArea` component
      */
     slug?: ReactNodeLike;
     /**
@@ -101,6 +101,10 @@ export interface TextAreaProps extends React.InputHTMLAttributes<HTMLTextAreaEle
      * Provide the text that is displayed when the control is in warning state
      */
     warnText?: ReactNodeLike;
+    /**
+     * Specify the method used for calculating the counter number
+     */
+    counterMode?: 'character' | 'word';
 }
 declare const TextArea: React.ForwardRefExoticComponent<TextAreaProps & React.RefAttributes<unknown>>;
 export default TextArea;

package/lib/components/TextArea/TextArea.js

@@ -49,6 +49,7 @@ const TextArea = /*#__PURE__*/React__default["default"].forwardRef((props, forwa
     placeholder = '',
     enableCounter = false,
     maxCount = undefined,
+    counterMode = 'character',
     warn = false,
     warnText = '',
     rows = 4,
@@ -63,15 +64,25 @@ const TextArea = /*#__PURE__*/React__default["default"].forwardRef((props, forwa
     defaultValue,
     value
   } = other;
-  const [textCount, setTextCount] = React.useState(defaultValue?.toString()?.length || value?.toString()?.length || 0);
   const {
     current: textAreaInstanceId
   } = React.useRef(getInstanceId());
   const textareaRef = React.useRef(null);
   const ref = useMergedRefs.useMergedRefs([forwardRef, textareaRef]);
+  function getInitialTextCount() {
+    const targetValue = defaultValue || value || textareaRef.current?.value || '';
+    const strValue = targetValue.toString();
+    if (counterMode === 'character') {
+      return strValue.length;
+    } else {
+      return strValue.match(/\w+/g)?.length || 0;
+    }
+  }
+  const [textCount, setTextCount] = React.useState(getInitialTextCount());
   React.useEffect(() => {
-    setTextCount(defaultValue?.toString()?.length || value?.toString()?.length || 0);
-  }, [value, defaultValue]);
+    setTextCount(getInitialTextCount());
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [value, defaultValue, counterMode]);
   useIsomorphicEffect["default"](() => {
     if (other.cols && textareaRef.current) {
       textareaRef.current.style.width = '';
@@ -82,14 +93,63 @@ const TextArea = /*#__PURE__*/React__default["default"].forwardRef((props, forwa
   }, [other.cols]);
   const textareaProps = {
     id,
+    onKeyDown: evt => {
+      if (!disabled && enableCounter && counterMode === 'word') {
+        const key = evt.which;
+        if (maxCount && textCount >= maxCount && key === 32) {
+          evt.preventDefault();
+        }
+      }
+    },
+    onPaste: evt => {
+      if (!disabled) {
+        if (counterMode === 'word' && enableCounter && typeof maxCount !== 'undefined' && textareaRef.current !== null) {
+          const existingWords = textareaRef.current.value.match(/\w+/g) || [];
+          const pastedWords = evt.clipboardData.getData('Text').match(/\w+/g) || [];
+          const totalWords = existingWords.length + pastedWords.length;
+          if (totalWords > maxCount) {
+            evt.preventDefault();
+            const allowedWords = existingWords.concat(pastedWords).slice(0, maxCount);
+            setTimeout(() => {
+              setTextCount(maxCount);
+            }, 0);
+            textareaRef.current.value = allowedWords.join(' ');
+          }
+        }
+      }
+    },
     onChange: evt => {
-      if (!disabled && onChange) {
-        evt?.persist?.();
-        // delay textCount assignation to give the textarea element value time to catch up if is a controlled input
-        setTimeout(() => {
-          setTextCount(evt.target?.value?.length);
-        }, 0);
-        onChange(evt);
+      if (!disabled) {
+        if (counterMode == 'character') {
+          evt?.persist?.();
+          // delay textCount assignation to give the textarea element value time to catch up if is a controlled input
+          setTimeout(() => {
+            setTextCount(evt.target?.value?.length);
+          }, 0);
+        } else if (counterMode == 'word') {
+          if (!evt.target.value) {
+            setTimeout(() => {
+              setTextCount(0);
+            }, 0);
+            return;
+          }
+          if (enableCounter && typeof maxCount !== 'undefined' && textareaRef.current !== null) {
+            const matchedWords = evt.target?.value?.match(/\w+/g);
+            if (matchedWords && matchedWords.length <= maxCount) {
+              textareaRef.current.removeAttribute('maxLength');
+              setTimeout(() => {
+                setTextCount(matchedWords.length);
+              }, 0);
+            } else if (matchedWords && matchedWords.length > maxCount) {
+              setTimeout(() => {
+                setTextCount(matchedWords.length);
+              }, 0);
+            }
+          }
+        }
+        if (onChange) {
+          onChange(evt);
+        }
       }
     },
     onClick: evt => {
@@ -124,7 +184,7 @@ const TextArea = /*#__PURE__*/React__default["default"].forwardRef((props, forwa
     htmlFor: id,
     className: labelClasses
   }, labelText) : null;
-  const counter = enableCounter && maxCount ? /*#__PURE__*/React__default["default"].createElement(Text.Text, {
+  const counter = enableCounter && maxCount && (counterMode === 'character' || counterMode === 'word') ? /*#__PURE__*/React__default["default"].createElement(Text.Text, {
     as: "div",
     className: counterClasses
   }, `${textCount}/${maxCount}`) : null;
@@ -157,9 +217,12 @@ const TextArea = /*#__PURE__*/React__default["default"].forwardRef((props, forwa
     ariaDescribedBy = helperId;
   }
   if (enableCounter) {
-    textareaProps.maxLength = maxCount;
+    // handle different counter mode
+    if (counterMode == 'character') {
+      textareaProps.maxLength = maxCount;
+    }
   }
-  const ariaAnnouncement = useAnnouncer.useAnnouncer(textCount, maxCount);
+  const ariaAnnouncement = useAnnouncer.useAnnouncer(textCount, maxCount, counterMode === 'word' ? 'words' : undefined);
   const input = /*#__PURE__*/React__default["default"].createElement("textarea", _rollupPluginBabelHelpers["extends"]({}, other, textareaProps, {
     placeholder: placeholder,
     className: textareaClasses,
@@ -173,7 +236,7 @@ const TextArea = /*#__PURE__*/React__default["default"].forwardRef((props, forwa
 
   // Slug is always size `mini`
   let normalizedSlug;
-  if (slug) {
+  if (slug && slug['type']?.displayName === 'Slug') {
     normalizedSlug = /*#__PURE__*/React__default["default"].cloneElement(slug, {
       size: 'mini'
     });
@@ -207,6 +270,10 @@ TextArea.propTypes = {
    * Specify the `cols` attribute for the underlying `<textarea>` node
    */
   cols: PropTypes__default["default"].number,
+  /**
+   * Specify the method used for calculating the counter number
+   */
+  counterMode: PropTypes__default["default"].oneOf(['character', 'word']),
   /**
    * Optionally provide the default value of the `<textarea>`
    */
@@ -216,7 +283,7 @@ TextArea.propTypes = {
    */
   disabled: PropTypes__default["default"].bool,
   /**
-   * Specify whether to display the character counter
+   * Specify whether to display the counter
    */
   enableCounter: PropTypes__default["default"].bool,
   /**
@@ -250,7 +317,7 @@ TextArea.propTypes = {
    */
   light: deprecate["default"](PropTypes__default["default"].bool, 'The `light` prop for `TextArea` has ' + 'been deprecated in favor of the new `Layer` component. It will be removed in the next major release.'),
   /**
-   * Max character count allowed for the textarea. This is needed in order for enableCounter to display
+   * Max entity count allowed for the textarea. This is needed in order for enableCounter to display
    */
   maxCount: PropTypes__default["default"].number,
   /**
@@ -276,7 +343,7 @@ TextArea.propTypes = {
    */
   rows: PropTypes__default["default"].number,
   /**
-   * Provide a `Slug` component to be rendered inside the `TextArea` component
+   * **Experimental**: Provide a `Slug` component to be rendered inside the `TextArea` component
    */
   slug: PropTypes__default["default"].node,
   /**

package/lib/components/TextInput/TextInput.d.ts

@@ -87,7 +87,7 @@ export interface TextInputProps extends Omit<React.InputHTMLAttributes<HTMLInput
      */
     size?: 'sm' | 'md' | 'lg' | 'xl';
     /**
-     * Provide a `Slug` component to be rendered inside the `TextInput` component
+     * **Experimental**: Provide a `Slug` component to be rendered inside the `TextInput` component
      */
     slug?: ReactNodeLike;
     /**

package/lib/components/TextInput/TextInput.js

@@ -167,7 +167,7 @@ const TextInput = /*#__PURE__*/React__default["default"].forwardRef(function Tex
 
   // Slug is always size `mini`
   let normalizedSlug;
-  if (slug) {
+  if (slug && slug['type']?.displayName === 'Slug') {
     normalizedSlug = /*#__PURE__*/React__default["default"].cloneElement(slug, {
       size: 'mini'
     });
@@ -271,7 +271,7 @@ TextInput.propTypes = {
    */
   size: PropTypes__default["default"].oneOf(['sm', 'md', 'lg']),
   /**
-   * Provide a `Slug` component to be rendered inside the `TextInput` component
+   * **Experimental**: Provide a `Slug` component to be rendered inside the `TextInput` component
    */
   slug: PropTypes__default["default"].node,
   /**

package/lib/components/Tile/Tile.d.ts

@@ -6,12 +6,12 @@ export interface TileProps extends HTMLAttributes<HTMLDivElement> {
     /** @deprecated */
     light?: boolean;
     /**
-     * Specify if the `Tile` component should be rendered with rounded corners. Only valid
+     * **Experimental**: Specify if the `Tile` component should be rendered with rounded corners. Only valid
      * when `slug` prop is present
      */
     hasRoundedCorners?: boolean;
     /**
-     * Provide a `Slug` component to be rendered inside the `SelectableTile` component
+     * **Experimental**: Provide a `Slug` component to be rendered inside the `SelectableTile` component
      */
     slug?: ReactNodeLike;
 }
@@ -30,7 +30,7 @@ export interface ClickableTileProps extends HTMLAttributes<HTMLAnchorElement> {
      */
     disabled?: boolean;
     /**
-     * Specify if the `ClickableTile` component should be rendered with rounded corners.
+     * **Experimental**: Specify if the `ClickableTile` component should be rendered with rounded corners.
      * Only valid when `slug` prop is present
      */
     hasRoundedCorners?: boolean;
@@ -57,7 +57,7 @@ export interface ClickableTileProps extends HTMLAttributes<HTMLAnchorElement> {
      */
     rel?: string;
     /**
-     * Specify if a `Slug` icon should be rendered inside the `ClickableTile`
+     * **Experimental**: Specify if a `Slug` icon should be rendered inside the `ClickableTile`
      */
     slug?: boolean;
 }
@@ -72,7 +72,7 @@ export interface SelectableTileProps extends HTMLAttributes<HTMLDivElement> {
      */
     disabled?: boolean;
     /**
-     * Specify if the `SelectableTile` component should be rendered with rounded corners.
+     * **Experimental**: Specify if the `SelectableTile` component should be rendered with rounded corners.
      * Only valid when `slug` prop is present
      */
     hasRoundedCorners?: boolean;
@@ -102,7 +102,7 @@ export interface SelectableTileProps extends HTMLAttributes<HTMLDivElement> {
      */
     selected?: boolean;
     /**
-     * Provide a `Slug` component to be rendered inside the `SelectableTile` component
+     * **Experimental**: Provide a `Slug` component to be rendered inside the `SelectableTile` component
      */
     slug?: ReactNodeLike;
     /**
@@ -130,7 +130,7 @@ export interface ExpandableTileProps extends HTMLAttributes<HTMLDivElement> {
      */
     expanded?: boolean;
     /**
-     * Specify if the `ExpandableTile` component should be rendered with rounded corners.
+     * **Experimental**: Specify if the `ExpandableTile` component should be rendered with rounded corners.
      * Only valid when `slug` prop is present
      */
     hasRoundedCorners?: boolean;
@@ -147,7 +147,7 @@ export interface ExpandableTileProps extends HTMLAttributes<HTMLDivElement> {
      */
     onKeyUp?(event: KeyboardEvent): void;
     /**
-     * Provide a `Slug` component to be rendered inside the `ExpandableTile` component
+     * **Experimental**: Provide a `Slug` component to be rendered inside the `ExpandableTile` component
      */
     slug?: ReactNodeLike;
     /**

package/lib/components/Tile/Tile.js

@@ -66,7 +66,7 @@ Tile.propTypes = {
    */
   className: PropTypes__default["default"].string,
   /**
-   * Specify if the `Tile` component should be rendered with rounded corners. Only valid
+   * **Experimental**: Specify if the `Tile` component should be rendered with rounded corners. Only valid
    * when `slug` prop is present
    */
   hasRoundedCorners: PropTypes__default["default"].bool,
@@ -78,7 +78,7 @@ Tile.propTypes = {
    */
   light: deprecate["default"](PropTypes__default["default"].bool, 'The `light` prop for `Tile` is no longer needed and has been deprecated. It will be removed in the next major release. Use the Layer component instead.'),
   /**
-   * Provide a `Slug` component to be rendered inside the `Tile` component
+   * **Experimental**: Provide a `Slug` component to be rendered inside the `Tile` component
    */
   slug: PropTypes__default["default"].node
 };
@@ -183,7 +183,7 @@ ClickableTile.propTypes = {
    */
   disabled: PropTypes__default["default"].bool,
   /**
-   * Specify if the `ClickableTile` component should be rendered with rounded corners.
+   * **Experimental**: Specify if the `ClickableTile` component should be rendered with rounded corners.
    * Only valid when `slug` prop is present
    */
   hasRoundedCorners: PropTypes__default["default"].bool,
@@ -279,7 +279,7 @@ const SelectableTile = /*#__PURE__*/React__default["default"].forwardRef(functio
   // Slug is always size `xs`
   const slugRef = React.useRef(null);
   let normalizedSlug;
-  if (slug) {
+  if (slug && slug['type']?.displayName === 'Slug') {
     normalizedSlug = /*#__PURE__*/React__default["default"].cloneElement(slug, {
       size: 'xs',
       ref: slugRef
@@ -318,7 +318,7 @@ SelectableTile.propTypes = {
    */
   disabled: PropTypes__default["default"].bool,
   /**
-   * Specify if the `SelectableTile` component should be rendered with rounded corners.
+   * **Experimental**: Specify if the `SelectableTile` component should be rendered with rounded corners.
    * Only valid when `slug` prop is present
    */
   hasRoundedCorners: PropTypes__default["default"].bool,
@@ -353,7 +353,7 @@ SelectableTile.propTypes = {
    */
   selected: PropTypes__default["default"].bool,
   /**
-   * Provide a `Slug` component to be rendered inside the `SelectableTile` component
+   * **Experimental**: Provide a `Slug` component to be rendered inside the `SelectableTile` component
    */
   slug: PropTypes__default["default"].node,
   /**
@@ -504,7 +504,7 @@ const ExpandableTile = /*#__PURE__*/React__default["default"].forwardRef(functio
 
   // Slug is always size `xs`
   let normalizedSlug;
-  if (slug) {
+  if (slug && slug['type']?.displayName === 'Slug') {
     normalizedSlug = /*#__PURE__*/React__default["default"].cloneElement(slug, {
       size: 'xs'
     });
@@ -583,6 +583,10 @@ ExpandableTile.propTypes = {
    * optional handler to trigger a function when a key is pressed
    */
   onKeyUp: PropTypes__default["default"].func,
+  /**
+   * **Experimental**: Provide a `Slug` component to be rendered inside the `ExpandableTile` component
+   */
+  slug: PropTypes__default["default"].node,
   /**
    * The `tabindex` attribute.
    */

package/lib/components/Tooltip/Tooltip.js

@@ -27,6 +27,10 @@ var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
 var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
 var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 
+/**
+ * Event types that trigger a "drag" to stop.
+ */
+const DRAG_STOP_EVENT_TYPES = new Set(['mouseup', 'touchend', 'touchcancel']);
 function Tooltip(_ref) {
   let {
     align = 'top',
@@ -43,6 +47,8 @@ function Tooltip(_ref) {
   const containerRef = React.useRef(null);
   const tooltipRef = React.useRef(null);
   const [open, setOpen] = useDelayedState.useDelayedState(defaultOpen);
+  const [isDragging, setIsDragging] = React.useState(false);
+  const [isPointerIntersecting, setIsPointerIntersecting] = React.useState(false);
   const id = useId.useId('tooltip');
   const prefix = usePrefix.usePrefix();
   const child = React__default["default"].Children.only(children);
@@ -51,7 +57,11 @@ function Tooltip(_ref) {
     onBlur: () => setOpen(false),
     onClick: () => closeOnActivation && setOpen(false),
     // This should be placed on the trigger in case the element is disabled
-    onMouseEnter
+    onMouseEnter,
+    onMouseLeave,
+    onMouseDown: onDragStart,
+    onMouseMove: onMouseMove,
+    onTouchStart: onDragStart
   };
   function getChildEventHandlers(childProps) {
     const eventHandlerFunctions = ['onFocus', 'onBlur', 'onClick', 'onMouseEnter'];
@@ -81,11 +91,34 @@ function Tooltip(_ref) {
     }
   }
   function onMouseEnter() {
+    setIsPointerIntersecting(true);
     setOpen(true, enterDelayMs);
   }
   function onMouseLeave() {
+    setIsPointerIntersecting(false);
+    if (isDragging) {
+      return;
+    }
     setOpen(false, leaveDelayMs);
   }
+  function onMouseMove(evt) {
+    if (evt.buttons === 1) {
+      setIsDragging(true);
+    } else {
+      setIsDragging(false);
+    }
+  }
+  function onDragStart() {
+    setIsDragging(true);
+  }
+  const onDragStop = React.useCallback(() => {
+    setIsDragging(false);
+    // Close the tooltip, unless the mouse pointer is within the bounds of the
+    // trigger.
+    if (!isPointerIntersecting) {
+      setOpen(false, leaveDelayMs);
+    }
+  }, [isPointerIntersecting, leaveDelayMs, setOpen]);
   useNoInteractiveChildren.useNoInteractiveChildren(tooltipRef, 'The Tooltip component must have no interactive content rendered by the' + '`label` or `description` prop');
   React.useEffect(() => {
     if (containerRef !== null && containerRef.current) {
@@ -95,6 +128,19 @@ function Tooltip(_ref) {
       }
     }
   });
+  React.useEffect(() => {
+    if (isDragging) {
+      // Register drag stop handlers.
+      DRAG_STOP_EVENT_TYPES.forEach(eventType => {
+        document.addEventListener(eventType, onDragStop);
+      });
+    }
+    return () => {
+      DRAG_STOP_EVENT_TYPES.forEach(eventType => {
+        document.removeEventListener(eventType, onDragStop);
+      });
+    };
+  }, [isDragging, onDragStop]);
   return /*#__PURE__*/React__default["default"].createElement(index.Popover, _rollupPluginBabelHelpers["extends"]({}, rest, {
     align: align,
     className: cx__default["default"](`${prefix}--tooltip`, customClassName),

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

@@ -0,0 +1,36 @@
+/**
+ * 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, { ReactNode } from 'react';
+interface HeaderPanelProps {
+    /**
+     * Specify whether focus and blur listeners are added. They are by default.
+     */
+    addFocusListeners?: boolean;
+    /**
+     * The content that will render inside of the `HeaderPanel`
+     */
+    children?: ReactNode;
+    /**
+     * Optionally provide a custom class to apply to the underlying `<li>` node
+     */
+    className?: string;
+    /**
+     * Specify whether the panel is expanded
+     */
+    expanded?: boolean;
+    /**
+     * Provide the `href` to the id of the element on your package that could
+     * be target.
+     */
+    href?: string;
+    /**
+     * An optional listener that is called a callback to collapse the HeaderPanel
+     */
+    onHeaderPanelFocus?: () => void;
+}
+declare const HeaderPanel: React.FC<HeaderPanelProps>;
+export default HeaderPanel;

package/lib/components/UIShell/HeaderPanel.js

@@ -10,9 +10,9 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
-var React = require('react');
 var cx = require('classnames');
 var PropTypes = require('prop-types');
+var React = require('react');
 var usePrefix = require('../../internal/usePrefix.js');
 var useEvent = require('../../internal/useEvent.js');
 var useMergedRefs = require('../../internal/useMergedRefs.js');
@@ -21,9 +21,9 @@ var keys = require('../../internal/keyboard/keys.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
-var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
 var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
+var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 
 const noopFn = () => {};
 const HeaderPanel = /*#__PURE__*/React__default["default"].forwardRef(function HeaderPanel(_ref, ref) {
@@ -34,7 +34,7 @@ const HeaderPanel = /*#__PURE__*/React__default["default"].forwardRef(function H
     addFocusListeners = true,
     onHeaderPanelFocus = noopFn,
     href,
-    ...other
+    ...rest
   } = _ref;
   const prefix = usePrefix.usePrefix();
   const headerPanelReference = React.useRef(null);
@@ -71,12 +71,13 @@ const HeaderPanel = /*#__PURE__*/React__default["default"].forwardRef(function H
   useEvent.useWindowEvent('click', () => {
     const focusedElement = document.activeElement;
     setLastClickedElement(focusedElement);
-    if (children.type?.displayName === 'Switcher' && !focusedElement?.closest(`.${prefix}--header-panel--expanded`) && !focusedElement?.closest(`.${prefix}--header__action`) && !headerPanelRef?.current?.classList.contains(`${prefix}--switcher`) && expanded) {
+    const childJsxElement = children;
+    if (childJsxElement.type?.displayName === 'Switcher' && !focusedElement?.closest(`.${prefix}--header-panel--expanded`) && !focusedElement?.closest(`.${prefix}--header__action`) && !headerPanelReference?.current?.classList.contains(`${prefix}--switcher`) && expanded) {
       setExpandedState(false);
       onHeaderPanelFocus();
     }
   });
-  return /*#__PURE__*/React__default["default"].createElement("div", _rollupPluginBabelHelpers["extends"]({}, other, {
+  return /*#__PURE__*/React__default["default"].createElement("div", _rollupPluginBabelHelpers["extends"]({}, rest, {
     className: className,
     ref: headerPanelRef
   }, eventHandlers), children);
@@ -109,6 +110,5 @@ HeaderPanel.propTypes = {
   onHeaderPanelFocus: PropTypes__default["default"].func
 };
 HeaderPanel.displayName = 'HeaderPanel';
-var HeaderPanel$1 = HeaderPanel;
 
-exports["default"] = HeaderPanel$1;
+exports["default"] = HeaderPanel;

package/lib/components/UIShell/Switcher.js

@@ -70,7 +70,7 @@ const Switcher = /*#__PURE__*/React.forwardRef(function Switcher(props, forwardR
       switcherItem.focus();
     }
   };
-  const childrenWithProps = React__default["default"].Children.map(children, (child, index) => {
+  const childrenWithProps = React__default["default"].Children.toArray(children).map((child, index) => {
     // only setup click handlers if onChange event is passed
     if ( /*#__PURE__*/React__default["default"].isValidElement(child) && child.type && getDisplayName["default"](child.type) === 'Switcher') {
       return /*#__PURE__*/React__default["default"].cloneElement(child, {