@carbon/ibm-products 2.56.1 → 2.57.0-rc.0

package/es/components/PageHeader/PageHeader.js

@@ -6,7 +6,7 @@
  */
 
 import { objectSpread2 as _objectSpread2, objectWithoutProperties as _objectWithoutProperties, slicedToArray as _slicedToArray, defineProperty as _defineProperty, extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
-import { Button, Tooltip, Tag, usePrefix, FlexGrid, Row, Column } from '@carbon/react';
+import { Button, Tooltip, Tag, usePrefix, FlexGrid, Row, Column, DefinitionTooltip } from '@carbon/react';
 import React__default, { useState, useRef, useEffect } from 'react';
 import { string_required_if_more_than_10_tags, TagSet } from '../TagSet/TagSet.js';
 import { spacing, baseFontSize, breakpoints } from '@carbon/layout';
@@ -19,6 +19,7 @@ import cx from 'classnames';
 import { getDevtoolsProps } from '../../global/js/utils/devtools.js';
 import { pkg } from '../../settings.js';
 import { useResizeObserver } from '../../global/js/hooks/useResizeObserver.js';
+import { checkHeightOverflow } from '../../global/js/utils/checkForOverflow.js';
 import { useNearestScroll } from '../../global/js/hooks/useWindowScroll.js';
 import { useWindowResize } from '../../global/js/hooks/useWindowResize.js';
 import { BreadcrumbWithOverflow } from '../BreadcrumbWithOverflow/BreadcrumbWithOverflow.js';
@@ -361,6 +362,12 @@ var PageHeader = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
     }
   };
   var displayedBreadcrumbs = getBreadcrumbs();
+  var subtitleRef = useRef(null);
+  var isOverflowing = checkHeightOverflow(subtitleRef.current);
+  var subtitleContent = /*#__PURE__*/React__default.createElement("span", {
+    ref: subtitleRef,
+    className: "".concat(blockClass, "__subtitle-text")
+  }, subtitle);
   return /*#__PURE__*/React__default.createElement(React__default.Fragment, null, /*#__PURE__*/React__default.createElement("div", {
     className: "".concat(blockClass, "--offset-top-measuring-element"),
     ref: offsetTopMeasuringRef
@@ -412,11 +419,14 @@ var PageHeader = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
     blockClass: blockClass,
     hasBreadcrumbRow: hasBreadcrumbRow,
     title: title
-  }) : null), thePageActions(false, pageActionsInBreadcrumbRow)) : null, subtitle ? /*#__PURE__*/React__default.createElement(Row, {
+  }) : null), thePageActions(false, pageActionsInBreadcrumbRow)) : null, subtitle && /*#__PURE__*/React__default.createElement(Row, {
     className: "".concat(blockClass, "__subtitle-row")
   }, /*#__PURE__*/React__default.createElement(Column, {
     className: "".concat(blockClass, "__subtitle")
-  }, subtitle)) : null, children ? /*#__PURE__*/React__default.createElement(Row, {
+  }, isOverflowing ? /*#__PURE__*/React__default.createElement(DefinitionTooltip, {
+    definition: subtitle,
+    className: "".concat(blockClass, "__subtitle-tooltip")
+  }, subtitleContent) : subtitleContent)), children ? /*#__PURE__*/React__default.createElement(Row, {
     className: "".concat(blockClass, "__available-row")
   }, /*#__PURE__*/React__default.createElement(Column, {
     className: "".concat(blockClass, "__available-column")

package/es/components/PageHeader/PageHeaderTitle.js

@@ -5,12 +5,13 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import { objectWithoutProperties as _objectWithoutProperties, slicedToArray as _slicedToArray, extends as _extends, defineProperty as _defineProperty } from '../../_virtual/_rollupPluginBabelHelpers.js';
-import React__default, { useState, useRef, useLayoutEffect } from 'react';
+import { objectWithoutProperties as _objectWithoutProperties, extends as _extends, defineProperty as _defineProperty } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import React__default, { useRef } from 'react';
 import PropTypes from '../../_virtual/index.js';
 import cx from 'classnames';
 import { SkeletonText, DefinitionTooltip } from '@carbon/react';
 import { EditInPlace } from '../EditInPlace/EditInPlace.js';
+import { checkWidthOverflow } from '../../global/js/utils/checkForOverflow.js';
 
 var _excluded = ["text", "content", "loading", "icon", "asText", "onChange", "onSave", "editDescription", "editableLabel", "cancelDescription", "saveDescription", "tooltipAlignment"];
 
@@ -43,31 +44,18 @@ var PageHeaderTitle = function PageHeaderTitle(_ref) {
     rest = _objectWithoutProperties(title, _excluded);
   var titleText;
   var isEditable = !!onSave;
-  var _useState = useState(),
-    _useState2 = _slicedToArray(_useState, 2),
-    isEllipsisApplied = _useState2[0],
-    setIsEllipsisApplied = _useState2[1];
-  var longTitleRef = useRef(undefined);
-  var titleRef = useRef(undefined);
-  useLayoutEffect(function () {
-    setIsEllipsisApplied(isEllipsisActive());
-  }, [longTitleRef, titleRef, title]);
-  var isEllipsisActive = function isEllipsisActive() {
-    if (longTitleRef.current) {
-      var _longTitleRef$current, _longTitleRef$current2;
-      return ((_longTitleRef$current = longTitleRef.current) === null || _longTitleRef$current === void 0 ? void 0 : _longTitleRef$current.offsetWidth) < ((_longTitleRef$current2 = longTitleRef.current) === null || _longTitleRef$current2 === void 0 ? void 0 : _longTitleRef$current2.scrollWidth);
-    } else if (titleRef.current) {
-      var _titleRef$current, _titleRef$current2;
-      return ((_titleRef$current = titleRef.current) === null || _titleRef$current === void 0 ? void 0 : _titleRef$current.offsetWidth) < ((_titleRef$current2 = titleRef.current) === null || _titleRef$current2 === void 0 ? void 0 : _titleRef$current2.scrollWidth);
-    }
-    return false;
-  };
+  var titleRef = useRef();
+  var isEllipsisApplied = checkWidthOverflow(titleRef.current);
   if (text || !content) {
     if (text === undefined && typeof title === 'string') {
       text = title;
       asText = title;
     }
     var TitleIcon = icon;
+    var titleContent = /*#__PURE__*/React__default.createElement("span", {
+      ref: titleRef,
+      className: "".concat(blockClass, "__titleText")
+    }, text);
     titleInnards = /*#__PURE__*/React__default.createElement(React__default.Fragment, null, icon && !loading ? /*#__PURE__*/React__default.createElement("span", {
       className: "".concat(blockClass, "__title-icon-wrapper")
     }, /*#__PURE__*/React__default.createElement(TitleIcon, {
@@ -90,14 +78,7 @@ var PageHeaderTitle = function PageHeaderTitle(_ref) {
       align: tooltipAlignment,
       definition: text,
       className: "".concat(blockClass, "__tooltip")
-    }, /*#__PURE__*/React__default.createElement("span", {
-      ref: longTitleRef,
-      className: "".concat(blockClass, "__titleText")
-    }, text)) : /*#__PURE__*/React__default.createElement("span", {
-      ref: titleRef,
-      className: "".concat(blockClass, "__titleText"),
-      title: !loading ? asText : null
-    }, text));
+    }, titleContent) : titleContent);
   } else {
     titleInnards = content;
     titleText = asText;

package/es/components/ProductiveCard/ProductiveCard.d.ts

@@ -66,7 +66,8 @@ export interface ProductiveCardProps extends PropsWithChildren {
      */
     overflowActions?: overflowAction[];
     /**
-     * Aria label prop required for OverflowMenu
+     * Sets the text for the OverflowMenu aria label and the OverflowMenu trigger button tooltip.
+     * Overrides `iconDescription` prop.
      */
     overflowAriaLabel?: string;
     /**
@@ -120,7 +121,10 @@ export interface ProductiveCardProps extends PropsWithChildren {
      */
     titleSize?: 'default' | 'large';
     /**
-     * Tooltip icon description
+     * Sets the text for the OverflowMenu trigger button tooltip and OverflowMenu aria label,
+     * gets overridden by the `overflowAriaLabel` prop.
+     *
+     * @deprecated Please use the `overflowAriaLabel` prop instead.
      */
     iconDescription?: string;
 }

package/es/components/ProductiveCard/ProductiveCard.js

@@ -13,16 +13,14 @@ import { pkg } from '../../settings.js';
 import { prepareProps } from '../../global/js/utils/props-helper.js';
 import { Card } from '../Card/Card.js';
 
-var _excluded = ["actionsPlacement", "iconDescription"];
+var _excluded = ["actionsPlacement"];
 var componentName = 'ProductiveCard';
 var ProductiveCard = /*#__PURE__*/forwardRef(function (_ref, ref) {
   var _ref$actionsPlacement = _ref.actionsPlacement,
     actionsPlacement = _ref$actionsPlacement === void 0 ? 'top' : _ref$actionsPlacement,
-    iconDescription = _ref.iconDescription,
     rest = _objectWithoutProperties(_ref, _excluded);
   var validProps = prepareProps(rest, ['media', 'mediaPosition', 'pictogram', 'primaryButtonClick', 'productive', 'secondaryButtonKind']);
   return /*#__PURE__*/React__default.createElement(Card, _extends({}, _objectSpread2(_objectSpread2({}, validProps), {}, {
-    iconDescription: iconDescription,
     actionsPlacement: actionsPlacement,
     ref: ref,
     productive: true
@@ -69,7 +67,10 @@ ProductiveCard.propTypes = {
    */
   description: PropTypes.oneOfType([PropTypes.string, PropTypes.object, PropTypes.node]),
   /**
-   * Tooltip icon description
+   * Sets the text for the OverflowMenu trigger button tooltip and OverflowMenu aria label,
+   * gets overridden by the `overflowAriaLabel` prop.
+   *
+   * @deprecated Please use the `overflowAriaLabel` prop instead.
    */
   iconDescription: PropTypes.string,
   /**
@@ -99,7 +100,8 @@ ProductiveCard.propTypes = {
     onKeyDown: PropTypes.func
   })),
   /**
-   * Aria label prop required for OverflowMenu
+   * Sets the text for the OverflowMenu aria label and the OverflowMenu trigger button tooltip.
+   * Overrides `iconDescription` prop.
    */
   overflowAriaLabel: PropTypes.string,
   /**

package/es/components/SidePanel/SidePanel.d.ts

@@ -110,14 +110,19 @@ type SidePanelBaseProps = {
      */
     slideIn?: boolean;
     /**
-     * @deprecated please use the `aiLabel` prop
+     * @deprecated please use the `decorator` instead
      *  **Experimental:** Provide a `Slug` component to be rendered inside the `SidePanel` component
      */
     slug?: ReactNode;
     /**
+     * @deprecated please use the `decorator` instead
      * Optional prop that is intended for any scenario where something is being generated by AI to reinforce AI transparency, accountability, and explainability at the UI level.
      */
     aiLabel?: ReactNode;
+    /**
+     * Provide a `decorator` component to be rendered inside the `SidePanel` component
+     */
+    decorator?: ReactNode;
     /**
      * Sets the subtitle text
      */

package/es/components/SidePanel/SidePanel.js

@@ -24,7 +24,7 @@ import usePrefersReducedMotion from '../../global/js/hooks/usePrefersReducedMoti
 import { useFocus, getSpecificElement } from '../../global/js/hooks/useFocus.js';
 import { usePreviousValue } from '../../global/js/hooks/usePreviousValue.js';
 
-var _excluded = ["actionToolbarButtons", "actions", "aiLabel", "animateTitle", "children", "className", "closeIconDescription", "condensedActions", "currentStep", "id", "includeOverlay", "labelText", "navigationBackIconDescription", "onNavigationBack", "onRequestClose", "onUnmount", "open", "placement", "preventCloseOnClickOutside", "selectorPageContent", "selectorPrimaryFocus", "size", "slideIn", "slug", "subtitle", "title", "launcherButtonRef"],
+var _excluded = ["actionToolbarButtons", "actions", "aiLabel", "animateTitle", "children", "className", "closeIconDescription", "condensedActions", "currentStep", "decorator", "id", "includeOverlay", "labelText", "navigationBackIconDescription", "onNavigationBack", "onRequestClose", "onUnmount", "open", "placement", "preventCloseOnClickOutside", "selectorPageContent", "selectorPrimaryFocus", "size", "slideIn", "slug", "subtitle", "title", "launcherButtonRef"],
   _excluded2 = ["label", "kind", "hasIconOnly", "icon", "renderIcon", "tooltipPosition", "tooltipAlignment", "leading", "disabled", "className", "onClick"];
 var blockClass = "".concat(pkg.prefix, "--side-panel");
 var componentName = 'SidePanel';
@@ -57,6 +57,7 @@ var SidePanel = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
     condensedActions = _ref.condensedActions,
     _ref$currentStep = _ref.currentStep,
     currentStep = _ref$currentStep === void 0 ? defaults.currentStep : _ref$currentStep,
+    decorator = _ref.decorator,
     _ref$id = _ref.id,
     id = _ref$id === void 0 ? blockClass : _ref$id,
     includeOverlay = _ref.includeOverlay,
@@ -266,7 +267,7 @@ var SidePanel = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
     if (!open) {
       onUnmount === null || onUnmount === void 0 || onUnmount();
     }
-    setAnimationComplete(true);
+    setAnimationComplete(!animationComplete);
   };
 
   // Set the internal state `animationComplete` to true if
@@ -320,22 +321,24 @@ var SidePanel = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
     }
   }, [slideIn, selectorPageContent, placement, size, shouldReduceMotion, open]);
   useEffect(function () {
-    if (open) {
-      setTimeout(function () {
-        if (selectorPrimaryFocus && getSpecificElement(sidePanelRef === null || sidePanelRef === void 0 ? void 0 : sidePanelRef.current, selectorPrimaryFocus)) {
-          var _window2;
-          var primeFocusEl = getSpecificElement(sidePanelRef === null || sidePanelRef === void 0 ? void 0 : sidePanelRef.current, selectorPrimaryFocus);
-          if (primeFocusEl && ((_window2 = window) === null || _window2 === void 0 || (_window2 = _window2.getComputedStyle(primeFocusEl)) === null || _window2 === void 0 ? void 0 : _window2.display) !== 'none') {
-            primeFocusEl === null || primeFocusEl === void 0 || primeFocusEl.focus();
-          }
-        } else if (!slideIn) {
-          firstElement === null || firstElement === void 0 || firstElement.focus();
+    if (open && animationComplete) {
+      if (selectorPrimaryFocus && getSpecificElement(sidePanelRef === null || sidePanelRef === void 0 ? void 0 : sidePanelRef.current, selectorPrimaryFocus)) {
+        var _window2;
+        var primeFocusEl = getSpecificElement(sidePanelRef === null || sidePanelRef === void 0 ? void 0 : sidePanelRef.current, selectorPrimaryFocus);
+        if (primeFocusEl && ((_window2 = window) === null || _window2 === void 0 || (_window2 = _window2.getComputedStyle(primeFocusEl)) === null || _window2 === void 0 ? void 0 : _window2.display) !== 'none') {
+          setTimeout(function () {
+            return primeFocusEl === null || primeFocusEl === void 0 ? void 0 : primeFocusEl.focus();
+          }, 0);
         }
-      }, 0);
+      } else if (!slideIn) {
+        setTimeout(function () {
+          return firstElement === null || firstElement === void 0 ? void 0 : firstElement.focus();
+        }, 0);
+      }
     }
   }, [animationComplete, firstElement, open, selectorPrimaryFocus, sidePanelRef, slideIn]);
   var primaryActionContainerClassNames = cx(["".concat(blockClass, "__actions-container"), _defineProperty({}, "".concat(blockClass, "__actions-container--condensed"), condensedActions)]);
-  var mainPanelClassNames = cx([blockClass, className, "".concat(blockClass), "".concat(blockClass, "--").concat(size), _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, "".concat(blockClass, "--right-placement"), placement === 'right'), "".concat(blockClass, "--left-placement"), placement === 'left'), "".concat(blockClass, "--slide-in"), slideIn), "".concat(blockClass, "--has-ai-label"), !!aiLabel || !!slug), "".concat(blockClass, "--condensed-actions"), condensedActions), "".concat(blockClass, "--has-overlay"), includeOverlay)]);
+  var mainPanelClassNames = cx([blockClass, className, "".concat(blockClass), "".concat(blockClass, "--").concat(size), _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, "".concat(blockClass, "--right-placement"), placement === 'right'), "".concat(blockClass, "--left-placement"), placement === 'left'), "".concat(blockClass, "--slide-in"), slideIn), "".concat(blockClass, "--has-decorator"), decorator), "".concat(blockClass, "--has-slug"), slug), "".concat(blockClass, "--has-ai-label"), aiLabel), "".concat(blockClass, "--condensed-actions"), condensedActions), "".concat(blockClass, "--has-overlay"), includeOverlay)]);
   var renderTitle = function renderTitle() {
     return /*#__PURE__*/React__default.createElement("div", {
       className: cx("".concat(blockClass, "__title"), _defineProperty({}, "".concat(blockClass, "__title--no-label"), !labelTextRef.current)),
@@ -351,23 +354,29 @@ var SidePanel = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
     }, title));
   };
   var renderHeader = function renderHeader() {
-    var _slug$type, _aiLabel$type;
-    var aiLabelCloseSize = actions && actions.length && /l/.test(size) ? 'md' : 'sm';
-    var normalizedAILabel;
+    var _slug$type, _aiLabel$type, _decorator$type;
+    var closeSize = actions && actions.length && /l/.test(size) ? 'md' : 'sm';
+    var normalizedDecorator;
     /**
      * slug is deprecated
      * can remove this condition in future release
      */
-    if (slug && ((_slug$type = slug['type']) === null || _slug$type === void 0 ? void 0 : _slug$type.displayName) === 'Slug') {
-      normalizedAILabel = /*#__PURE__*/React__default.cloneElement(slug, {
+    if (slug && ((_slug$type = slug['type']) === null || _slug$type === void 0 ? void 0 : _slug$type.displayName) === 'AILabel') {
+      normalizedDecorator = /*#__PURE__*/React__default.cloneElement(slug, {
         // slug size is sm unless actions and size > md
-        size: aiLabelCloseSize
+        size: closeSize
       });
     }
     if (aiLabel && ((_aiLabel$type = aiLabel['type']) === null || _aiLabel$type === void 0 ? void 0 : _aiLabel$type.displayName) === 'AILabel') {
-      normalizedAILabel = /*#__PURE__*/React__default.cloneElement(aiLabel, {
+      normalizedDecorator = /*#__PURE__*/React__default.cloneElement(aiLabel, {
         // aiLabel size is sm unless actions and size > md
-        size: aiLabelCloseSize
+        size: closeSize
+      });
+    }
+    if ((decorator === null || decorator === void 0 || (_decorator$type = decorator['type']) === null || _decorator$type === void 0 ? void 0 : _decorator$type.displayName) === 'AILabel') {
+      normalizedDecorator = /*#__PURE__*/React__default.cloneElement(decorator, {
+        // decorator size is sm unless actions and size > md
+        size: closeSize
       });
     }
     return /*#__PURE__*/React__default.createElement("div", {
@@ -375,7 +384,7 @@ var SidePanel = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
       ref: headerRef
     }, currentStep > 0 && /*#__PURE__*/React__default.createElement(Button, {
       kind: "ghost",
-      size: aiLabelCloseSize,
+      size: closeSize,
       disabled: false,
       renderIcon: function renderIcon(props) {
         return /*#__PURE__*/React__default.createElement(ArrowLeft, _extends({
@@ -389,8 +398,8 @@ var SidePanel = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
       className: "".concat(blockClass, "__label-text"),
       ref: labelTextRef
     }, labelText), title && title.length && renderTitle(), /*#__PURE__*/React__default.createElement("div", {
-      className: "".concat(blockClass, "__ai-label-and-close")
-    }, normalizedAILabel, /*#__PURE__*/React__default.createElement(IconButton, {
+      className: "".concat(blockClass, "__decorator-and-close")
+    }, normalizedDecorator, /*#__PURE__*/React__default.createElement(IconButton, {
       className: "".concat(blockClass, "__close-button"),
       label: closeIconDescription,
       onClick: onRequestClose,
@@ -493,7 +502,13 @@ var deprecatedProps = {
    * **deprecated**
    *  **Experimental:** Provide a `Slug` component to be rendered inside the `SidePanel` component
    */
-  slug: PropTypes.node
+  slug: PropTypes.node,
+  /**
+   * **deprecated**
+   * Please use the `decorator` instead
+   * Optional prop that is intended for any scenario where something is being generated by AI to reinforce AI transparency, accountability, and explainability at the UI level.
+   */
+  aiLabel: PropTypes.node
 };
 SidePanel.propTypes = _objectSpread2({
   /**

package/es/components/TagOverflow/TagOverflow.js

@@ -7,7 +7,7 @@
 
 import { objectWithoutProperties as _objectWithoutProperties, slicedToArray as _slicedToArray, objectSpread2 as _objectSpread2, extends as _extends, defineProperty as _defineProperty } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import React__default, { forwardRef, useRef, useState, useCallback, useEffect, createElement } from 'react';
-import { Tooltip, DismissibleTag, Tag } from '@carbon/react';
+import { DismissibleTag, Tag } from '@carbon/react';
 import PropTypes from '../../_virtual/index.js';
 import { TYPES } from './constants.js';
 import { TagOverflowModal } from './TagOverflowModal.js';
@@ -189,9 +189,6 @@ var TagOverflow = /*#__PURE__*/forwardRef(function (props, ref) {
           return itemRefHandler(id, node);
         },
         key: id
-      }, /*#__PURE__*/React__default.createElement(Tooltip, {
-        align: overflowAlign,
-        label: label
       }, typeof _onClose === 'function' || filter ? /*#__PURE__*/React__default.createElement(DismissibleTag, _extends({}, other, {
         className: "".concat(blockClass, "__item--tag"),
         type: tagType,
@@ -202,7 +199,7 @@ var TagOverflow = /*#__PURE__*/forwardRef(function (props, ref) {
       })) : /*#__PURE__*/React__default.createElement(Tag, _extends({}, other, {
         className: "".concat(blockClass, "__item--tag"),
         type: tagType
-      }), label)));
+      }), label));
     }
   }), /*#__PURE__*/React__default.createElement("span", {
     className: "".concat(blockClass, "__indicator"),

package/es/components/Tearsheet/TearsheetShell.d.ts

@@ -19,6 +19,10 @@ interface TearsheetShellProps extends PropsWithChildren {
      * An optional class or classes to be added to the outermost element.
      */
     className?: string;
+    /**
+     * Used to track the current step on components which use `StepsContext` and `TearsheetShell`
+     */
+    currentStep?: number;
     /**
      * A description of the flow, displayed in the header area of the tearsheet.
      */

package/es/components/Tearsheet/TearsheetShell.js

@@ -21,7 +21,7 @@ import { usePortalTarget } from '../../global/js/hooks/usePortalTarget.js';
 import { useFocus, claimFocus } from '../../global/js/hooks/useFocus.js';
 import { usePreviousValue } from '../../global/js/hooks/usePreviousValue.js';
 
-var _excluded = ["actions", "aiLabel", "ariaLabel", "children", "className", "closeIconDescription", "description", "hasCloseIcon", "headerActions", "influencer", "influencerPosition", "influencerWidth", "label", "navigation", "onClose", "open", "portalTarget", "selectorPrimaryFocus", "selectorsFloatingMenus", "size", "slug", "title", "verticalPosition", "launcherButtonRef"];
+var _excluded = ["actions", "aiLabel", "ariaLabel", "children", "className", "closeIconDescription", "currentStep", "description", "hasCloseIcon", "headerActions", "influencer", "influencerPosition", "influencerWidth", "label", "navigation", "onClose", "open", "portalTarget", "selectorPrimaryFocus", "selectorsFloatingMenus", "size", "slug", "title", "verticalPosition", "launcherButtonRef"];
 // The block part of our conventional BEM class names (bc__E--M).
 var bc = "".concat(pkg.prefix, "--tearsheet");
 var componentName = 'TearsheetShell';
@@ -68,6 +68,7 @@ var TearsheetShell = /*#__PURE__*/React__default.forwardRef(function (_ref, ref)
     children = _ref.children,
     className = _ref.className,
     closeIconDescription = _ref.closeIconDescription,
+    currentStep = _ref.currentStep,
     description = _ref.description,
     hasCloseIcon = _ref.hasCloseIcon,
     headerActions = _ref.headerActions,
@@ -100,8 +101,7 @@ var TearsheetShell = /*#__PURE__*/React__default.forwardRef(function (_ref, ref)
   var prevOpen = usePreviousValue(open);
   var _useFocus = useFocus(modalRef, selectorPrimaryFocus),
     firstElement = _useFocus.firstElement,
-    keyDownListener = _useFocus.keyDownListener,
-    specifiedElement = _useFocus.specifiedElement;
+    keyDownListener = _useFocus.keyDownListener;
   var modalRefValue = modalRef.current;
 
   // Function to strip html tags out of a string.
@@ -137,23 +137,12 @@ var TearsheetShell = /*#__PURE__*/React__default.forwardRef(function (_ref, ref)
     setDepth(newDepth);
     setPosition(newPosition);
   }
-  handleStackChange.checkFocus = function () {
-    // if we are now the topmost tearsheet, ensure we have focus
-    if (open && position === depth && modalRefValue && !modalRefValue.contains(document.activeElement)) {
-      handleStackChange.claimFocus();
-    }
-  };
-
-  // Callback to give the tearsheet the opportunity to claim focus
-  handleStackChange.claimFocus = function () {
-    claimFocus(firstElement, modalRef, selectorPrimaryFocus);
-  };
   useEffect(function () {
-    if (open) {
+    if (open && position === depth) {
       // Focusing the first element or selectorPrimaryFocus element
       claimFocus(firstElement, modalRef, selectorPrimaryFocus);
     }
-  }, [firstElement, modalRef, open, selectorPrimaryFocus]);
+  }, [currentStep, depth, firstElement, modalRef, modalRefValue, open, position, selectorPrimaryFocus]);
   useEffect(function () {
     if (prevOpen && !open && launcherButtonRef) {
       setTimeout(function () {
@@ -161,22 +150,10 @@ var TearsheetShell = /*#__PURE__*/React__default.forwardRef(function (_ref, ref)
       }, 0);
     }
   }, [launcherButtonRef, open, prevOpen]);
-  useEffect(function () {
-    if (open && position !== depth) {
-      setTimeout(function () {
-        if (selectorPrimaryFocus) {
-          return specifiedElement === null || specifiedElement === void 0 ? void 0 : specifiedElement.focus();
-        }
-        firstElement === null || firstElement === void 0 || firstElement.focus();
-      }, 0);
-    }
-  }, [position, depth, firstElement, open, specifiedElement, selectorPrimaryFocus]);
   useEffect(function () {
     var notify = function notify() {
       return stack.all.forEach(function (handler) {
-        var _handler$checkFocus;
         handler(Math.min(stack.open.length, maxDepth), stack.open.indexOf(handler) + 1);
-        (_handler$checkFocus = handler.checkFocus) === null || _handler$checkFocus === void 0 || _handler$checkFocus.call(handler);
       });
     };
 
@@ -211,14 +188,6 @@ var TearsheetShell = /*#__PURE__*/React__default.forwardRef(function (_ref, ref)
       }
     };
   }, [open, size]);
-  function handleFocus() {
-    // If something within us is receiving focus but we are not the topmost
-    // stacked tearsheet, transfer focus to the topmost tearsheet instead
-    if (position < depth) {
-      var _stack$open$claimFocu, _stack$open;
-      (_stack$open$claimFocu = (_stack$open = stack.open[stack.open.length - 1]).claimFocus) === null || _stack$open$claimFocu === void 0 || _stack$open$claimFocu.call(_stack$open);
-    }
-  }
   if (position <= depth) {
     var _prevDepth$current;
     // Include a modal header if and only if one or more of these is given.
@@ -250,7 +219,6 @@ var TearsheetShell = /*#__PURE__*/React__default.forwardRef(function (_ref, ref)
       onClose: onClose,
       open: open,
       selectorPrimaryFocus: selectorPrimaryFocus,
-      onFocus: handleFocus,
       onKeyDown: keyDownListener,
       preventCloseOnClickOutside: !isPassive,
       ref: modalRef,

package/es/global/js/hooks/useFocus.d.ts

@@ -12,4 +12,4 @@ export function useFocus(modalRef: any, selectorPrimaryFocus: any): {
         specified: any;
     };
 };
-export function claimFocus(firstElement: any, modalRef: any, selectorPrimaryFocus?: string | undefined): any;
+export function claimFocus(firstElement: any, modalRef: any, selectorPrimaryFocus?: string | undefined): void;

package/es/global/js/hooks/useFocus.js

@@ -116,12 +116,15 @@ var claimFocus = function claimFocus(firstElement, modalRef) {
     var _window2;
     var specifiedEl = getSpecificElement(modalRef === null || modalRef === void 0 ? void 0 : modalRef.current, selectorPrimaryFocus);
     if (specifiedEl && ((_window2 = window) === null || _window2 === void 0 || (_window2 = _window2.getComputedStyle(specifiedEl)) === null || _window2 === void 0 ? void 0 : _window2.display) !== 'none') {
-      return specifiedEl.focus();
+      setTimeout(function () {
+        return specifiedEl.focus();
+      }, 0);
     }
+  } else {
+    setTimeout(function () {
+      return firstElement === null || firstElement === void 0 ? void 0 : firstElement.focus();
+    }, 0);
   }
-  setTimeout(function () {
-    return firstElement === null || firstElement === void 0 ? void 0 : firstElement.focus();
-  }, 0);
 };
 
 export { claimFocus, getSpecificElement, useFocus };

package/es/global/js/utils/checkForOverflow.d.ts

@@ -0,0 +1,5 @@
+/**
+ * used to calculate if a element is overflowing the width or height of an area
+ */
+export declare const checkWidthOverflow: (el: HTMLElement | null) => boolean;
+export declare const checkHeightOverflow: (el: HTMLElement | null) => boolean;

package/es/global/js/utils/checkForOverflow.js

@@ -0,0 +1,31 @@
+/**
+ * Copyright IBM Corp. 2020, 2024
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+// Copyright IBM Corp. 2024, 2024
+//
+// This source code is licensed under the Apache-2.0 license found in the
+// LICENSE file in the root directory of this source tree.
+//
+
+/**
+ * used to calculate if a element is overflowing the width or height of an area
+ */
+
+var checkWidthOverflow = function checkWidthOverflow(el) {
+  if (el) {
+    return (el === null || el === void 0 ? void 0 : el.offsetWidth) < (el === null || el === void 0 ? void 0 : el.scrollWidth);
+  }
+  return false;
+};
+var checkHeightOverflow = function checkHeightOverflow(el) {
+  if (el) {
+    return (el === null || el === void 0 ? void 0 : el.offsetHeight) < (el === null || el === void 0 ? void 0 : el.scrollHeight);
+  }
+  return false;
+};
+
+export { checkHeightOverflow, checkWidthOverflow };

package/lib/components/APIKeyModal/APIKeyDownloader.d.ts

@@ -10,7 +10,7 @@ export namespace APIKeyDownloader {
     export { componentName as displayName };
     export namespace propTypes {
         let apiKey: PropTypes.Validator<string>;
-        let body: PropTypes.Validator<string>;
+        let body: PropTypes.Requireable<string>;
         let downloadLinkLabel: PropTypes.Requireable<string>;
         let fileName: PropTypes.Validator<string>;
         let fileType: PropTypes.Validator<string>;

package/lib/components/APIKeyModal/APIKeyDownloader.js

@@ -78,7 +78,7 @@ APIKeyDownloader.propTypes = {
   /**
    * body content for the downloader
    */
-  body: index.default.string.isRequired,
+  body: index.default.string,
   /**
    * aria-label for the download link
    */

package/lib/components/APIKeyModal/APIKeyModal.d.ts

@@ -1,3 +1,16 @@
 import React from 'react';
+import PropTypes from 'prop-types';
 import { APIKeyModalProps } from './APIKeyModal.types';
 export declare let APIKeyModal: React.FC<APIKeyModalProps>;
+export declare const deprecatedProps: {
+    /**
+     * deprecated
+     * title for a successful edit
+     */
+    editSuccessTitle: PropTypes.Requireable<string>;
+    /**
+     * deprecated
+     * title for a successful key generation
+     */
+    generateSuccessTitle: PropTypes.Requireable<string>;
+};