@carbon/ibm-products 2.21.0 → 2.22.0

package/es/components/SidePanel/SidePanel.js

@@ -92,47 +92,56 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     _useState2 = _slicedToArray(_useState, 2),
     animationComplete = _useState2[0],
     setAnimationComplete = _useState2[1];
-  var _useState3 = useState(0),
-    _useState4 = _slicedToArray(_useState3, 2),
-    panelHeight = _useState4[0],
-    setPanelHeight = _useState4[1];
-  var sidePanelRef = useRef();
-  var sidePanelOverlayRef = useRef();
+  var localRef = useRef();
+  var sidePanelRef = ref || localRef;
+  var overlayRef = useRef();
   var startTrapRef = useRef();
   var endTrapRef = useRef();
-  var sidePanelInnerRef = useRef();
-  var sidePanelCloseRef = useRef();
+  var innerContentRef = useRef();
+  var closeRef = useRef();
+  var animatedScrollRef = useRef();
+  var headerRef = useRef();
+  var titleRef = useRef();
+  var collapsedTitleRef = useRef();
+  var labelTextRef = useRef();
+  var subtitleRef = useRef();
   var previousState = usePreviousValue({
     size: size,
     open: open
   });
+  var _useState3 = useState(-1),
+    _useState4 = _slicedToArray(_useState3, 2),
+    scrollAnimationDistance = _useState4[0],
+    setScrollAnimationDistance = _useState4[1];
+  var _useState5 = useState(true),
+    _useState6 = _slicedToArray(_useState5, 2),
+    doAnimateTitle = _useState6[0],
+    setDoAnimateTitle = _useState6[1];
+  useEffect(function () {
+    setDoAnimateTitle(animateTitle);
+  }, [animateTitle]);
+  var handleScroll = useCallback(function () {
+    var scrollTop = animatedScrollRef.current.scrollTop;
+    sidePanelRef.current.style.setProperty("--".concat(blockClass, "--scroll-animation-progress"), Math.min(scrollTop, scrollAnimationDistance) / scrollAnimationDistance);
+  }, [scrollAnimationDistance, sidePanelRef]);
   var reducedMotion = typeof window !== 'undefined' && (_window = window) !== null && _window !== void 0 && _window.matchMedia ? window.matchMedia('(prefers-reduced-motion: reduce)') : {
     matches: true
   };
-  var getActionsContainerElement = useCallback(function () {
-    var sidePanelOuter = document.querySelector("#".concat(id));
-    return sidePanelOuter && sidePanelOuter.querySelector(".".concat(blockClass, "__actions-container"));
-  }, [id]);
 
   // scroll panel to top going between steps
   useEffect(function () {
-    var panelRef = ref || sidePanelRef;
-    if (panelRef && panelRef.current) {
-      var _document$querySelect;
-      var scrollableSection = panelRef.current.querySelector(".".concat(blockClass, "__inner-content"));
-      var sidePanelOuter = document.querySelector("#".concat(id));
-      var initialTitleHeight = (_document$querySelect = document.querySelector(".".concat(blockClass, "__title-container"))) === null || _document$querySelect === void 0 ? void 0 : _document$querySelect.offsetHeight;
+    if (sidePanelRef && sidePanelRef.current) {
+      var _animatedScrollRef$cu;
+      var scrollableSection = (_animatedScrollRef$cu = animatedScrollRef.current) !== null && _animatedScrollRef$cu !== void 0 ? _animatedScrollRef$cu : innerContentRef.current;
       scrollableSection.scrollTop = 0;
       // The size of the panel has changed while it is still opened
-      // so we need to scroll it to the top and reset the title container
+      // so we need to scroll it to the top and reset the header
       // height css custom property
       if ((previousState === null || previousState === void 0 ? void 0 : previousState.size) !== size) {
-        var _sidePanelOuter$style;
         scrollableSection.scrollTop = 0;
-        sidePanelOuter === null || sidePanelOuter === void 0 || (_sidePanelOuter$style = sidePanelOuter.style) === null || _sidePanelOuter$style === void 0 || _sidePanelOuter$style.setProperty("--".concat(blockClass, "--title-container-height"), "".concat(Number(initialTitleHeight), "px"));
       }
     }
-  }, [currentStep, ref, size, previousState === null || previousState === void 0 ? void 0 : previousState.size, id]);
+  }, [currentStep, sidePanelRef, size, previousState === null || previousState === void 0 ? void 0 : previousState.size, id]);
 
   // set initial focus when side panel opens
   useEffect(function () {
@@ -142,7 +151,7 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       if (primaryFocusElement) {
         return primaryFocusElement;
       } else {
-        return sidePanelCloseRef && sidePanelCloseRef.current;
+        return closeRef && closeRef.current;
       }
     };
     var focusButton = function focusButton(focusContainerElement) {
@@ -150,19 +159,9 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       target === null || target === void 0 || target.focus();
     };
     if (open && animationComplete) {
-      focusButton(sidePanelInnerRef.current);
+      focusButton(innerContentRef.current);
     }
   }, [selectorPrimaryFocus, open, animationComplete]);
-  useEffect(function () {
-    if (open && actions && actions.length && animationComplete) {
-      var _sidePanelOuter$style2;
-      var sidePanelOuter = document.querySelector("#".concat(id));
-      var actionsContainer = getActionsContainerElement();
-      var actionsHeight = (actionsContainer === null || actionsContainer === void 0 ? void 0 : actionsContainer.offsetHeight) + 16; // add additional 1rem spacing to bottom padding
-      actionsHeight = "".concat(Math.round(actionsHeight / 16), "rem");
-      sidePanelOuter === null || sidePanelOuter === void 0 || (_sidePanelOuter$style2 = sidePanelOuter.style) === null || _sidePanelOuter$style2 === void 0 || _sidePanelOuter$style2.setProperty("--".concat(blockClass, "--content-bottom-padding"), actionsHeight);
-    }
-  }, [actions, condensedActions, open, animationComplete, id, getActionsContainerElement]);
 
   // Add console warning if labelText is provided without a title.
   // This combination is not allowed.
@@ -171,120 +170,67 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       console.warn("".concat(componentName, ": The prop `labelText` was provided without a `title`. It is required to have a `title` when using the `labelText` prop."));
     }
   }, [labelText, title]);
+  var checkSetDoAnimateTitle = function checkSetDoAnimateTitle() {
+    if (sidePanelRef !== null && sidePanelRef !== void 0 && sidePanelRef.current && open && animateTitle && animationComplete && titleRef !== null && titleRef !== void 0 && titleRef.current && title && title.length && !reducedMotion.matches) {
+      var _labelTextRef$current, _labelTextRef$current2, _subtitleRef$current$, _subtitleRef$current;
+      var titleEl = titleRef.current;
+      var labelHeight = (_labelTextRef$current = labelTextRef === null || labelTextRef === void 0 || (_labelTextRef$current2 = labelTextRef.current) === null || _labelTextRef$current2 === void 0 ? void 0 : _labelTextRef$current2.offsetHeight) !== null && _labelTextRef$current !== void 0 ? _labelTextRef$current : 0;
+      var subtitleHeight = (_subtitleRef$current$ = subtitleRef === null || subtitleRef === void 0 || (_subtitleRef$current = subtitleRef.current) === null || _subtitleRef$current === void 0 ? void 0 : _subtitleRef$current.offsetHeight) !== null && _subtitleRef$current$ !== void 0 ? _subtitleRef$current$ : 0;
 
-  /* istanbul ignore next */
-  var handleResize = function handleResize(_ref2) {
-    var _sidePanelOuter$style3;
-    var height = _ref2.height;
-    setPanelHeight(height);
-    var sidePanelOuter = document.querySelector("#".concat(id));
-    var actionsContainer = getActionsContainerElement();
-    var actionsHeight = (actionsContainer === null || actionsContainer === void 0 ? void 0 : actionsContainer.offsetHeight) + 16; // add additional 1rem spacing to bottom padding
-    actionsHeight = "".concat(Math.round(actionsHeight / 16), "rem");
-    sidePanelOuter === null || sidePanelOuter === void 0 || (_sidePanelOuter$style3 = sidePanelOuter.style) === null || _sidePanelOuter$style3 === void 0 || _sidePanelOuter$style3.setProperty("--".concat(blockClass, "--content-bottom-padding"), actionsHeight);
-  };
+      // Adjusts space at bottom of titles by changing where scrolling finishes
+      // Styles use border to save use of get computed style
+      var titleVerticalBorder = actionToolbarButtons ? titleEl.offsetHeight - titleEl.clientHeight : 0;
+      var _scrollAnimationDistance = labelHeight + subtitleHeight + titleVerticalBorder;
+      setScrollAnimationDistance(_scrollAnimationDistance);
 
-  // Title and subtitle scroll animation
+      // used to calculate the header moves
+      sidePanelRef.current.style.setProperty("--".concat(blockClass, "--scroll-animation-distance"), _scrollAnimationDistance);
+      var scrollEl = animatedScrollRef.current;
+      if (!scrollEl && animateTitle && !doAnimateTitle) {
+        // may be switching back based on resize
+        scrollEl = innerContentRef.current;
+      }
+      if (scrollEl) {
+        var _window2;
+        var innerComputed = (_window2 = window) === null || _window2 === void 0 ? void 0 : _window2.getComputedStyle(innerContentRef.current);
+        var innerPaddingHeight = innerComputed ? parseFloat(innerComputed === null || innerComputed === void 0 ? void 0 : innerComputed.paddingTop, 10) + parseFloat(innerComputed === null || innerComputed === void 0 ? void 0 : innerComputed.paddingBottom, 10) : 0;
+        var canDoAnimateTitle = (!!labelText || !!actionToolbarButtons || !!subtitle) && scrollEl.scrollHeight - scrollEl.clientHeight >= _scrollAnimationDistance + innerPaddingHeight;
+        if (doAnimateTitle !== canDoAnimateTitle) {
+          // will need updating on resize
+          setDoAnimateTitle(canDoAnimateTitle);
+        }
+      }
+    }
+  };
   useEffect(function () {
-    if (open && animateTitle && animationComplete && title && title.length && !reducedMotion.matches) {
-      var _document$querySelect2, _document$querySelect3, _document$querySelect4;
-      var sidePanelOuter = document.querySelector("#".concat(id));
-      var sidePanelScrollArea = document.querySelector("#".concat(id, " .").concat(blockClass, "__inner-content"));
-      var sidePanelTitleElement = document.querySelector(".".concat(blockClass, "__title-text"));
-      var sidePanelCollapsedTitleElement = document.querySelector(".".concat(blockClass, "__collapsed-title-text"));
-      var sidePanelSubtitleElement = document.querySelector(".".concat("".concat(blockClass, "__subtitle-text")));
-      var sidePanelSubtitleElementHeight = (sidePanelSubtitleElement === null || sidePanelSubtitleElement === void 0 ? void 0 : sidePanelSubtitleElement.offsetHeight) || 0; // set default subtitle height if a subtitle is not provided to enable scrolling animation
-
-      var panelOuterHeight = panelHeight;
-      var scrollSectionHeight = (_document$querySelect2 = document.querySelector(".".concat(blockClass, "__body-content"))) === null || _document$querySelect2 === void 0 ? void 0 : _document$querySelect2.offsetHeight;
-      var titleContainerHeight = (_document$querySelect3 = document.querySelector(".".concat(blockClass, "__title-container"))) === null || _document$querySelect3 === void 0 ? void 0 : _document$querySelect3.offsetHeight;
-      var labelTextHeight = (_document$querySelect4 = document.querySelector(".".concat(blockClass, "__label-text"))) === null || _document$querySelect4 === void 0 ? void 0 : _document$querySelect4.offsetHeight;
-      var totalScrollingContentHeight = titleContainerHeight + sidePanelSubtitleElementHeight + scrollSectionHeight;
-      // if the difference between the total scrolling height and the panel height is less than
-      // the subtitleElement height OR if the subtitle element height is 0, use that difference
-      // as the length of the scroll animation (otherwise the animation will not be able to complete
-      // because there is not enough scrolling distance to complete it).
-      sidePanelSubtitleElementHeight = totalScrollingContentHeight - panelOuterHeight < sidePanelSubtitleElementHeight ? totalScrollingContentHeight - panelOuterHeight : sidePanelSubtitleElementHeight === 0 ? 16 : sidePanelSubtitleElementHeight;
-      sidePanelSubtitleElementHeight = sidePanelSubtitleElementHeight < 0 ? (sidePanelScrollArea === null || sidePanelScrollArea === void 0 ? void 0 : sidePanelScrollArea.scrollHeight) - (sidePanelScrollArea === null || sidePanelScrollArea === void 0 ? void 0 : sidePanelScrollArea.clientHeight) : sidePanelSubtitleElementHeight;
-      /* istanbul ignore next */
-      sidePanelScrollArea && sidePanelScrollArea.addEventListener('scroll', function () {
-        var scrollTop = sidePanelScrollArea.scrollTop;
-        // if scrolling has occurred
-        if (scrollTop > 0) {
-          sidePanelOuter.classList.add("".concat(blockClass, "__with-condensed-header"));
-          // Set subtitle opacity calculation here
-          // as scroll progresses
-          var titleOpacity = Math.min(1, (sidePanelSubtitleElementHeight - scrollTop) / sidePanelSubtitleElementHeight);
-          titleOpacity = titleOpacity < 0 ? 0 : titleOpacity;
-          sidePanelOuter.style.setProperty("--".concat(blockClass, "--subtitle-opacity"), titleOpacity);
-
-          // Calculate divider opacity to avoid border
-          // abruptly appearing when scrolling starts.
-          // This approach uses a pseudo element and sets
-          // the opacity as scroll progresses.
-          var dividerOpacity = Math.min(scrollTop / sidePanelSubtitleElementHeight, 1);
-          sidePanelOuter.style.setProperty("--".concat(blockClass, "--divider-opacity"), "".concat(Math.min(1, dividerOpacity)));
-
-          // We need to know the height of the title element
-          // so that we know how far to place the action toolbar
-          // from the top since it is sticky
-          var titleTextHeight = Math.max(sidePanelTitleElement.offsetHeight);
-          sidePanelOuter.style.setProperty("--".concat(blockClass, "--title-height"), "".concat(titleTextHeight + 16, "px"));
-
-          // Set title y positioning
-          var titleYPosition = Math.min(scrollTop / sidePanelSubtitleElementHeight, 1);
-          sidePanelOuter.style.setProperty("--".concat(blockClass, "--title-y-position"), "".concat(-Math.abs(titleYPosition), "rem"));
-
-          // mark title with aria-hidden={true} if opacity reaches 0
-          if (titleOpacity === 0) {
-            sidePanelTitleElement.setAttribute('aria-hidden', 'true');
-            sidePanelCollapsedTitleElement.setAttribute('aria-hidden', 'false');
-          }
+    if (doAnimateTitle && animatedScrollRef.current) {
+      // only add scroll if the doAnimateTitle is already true
+      // should come back through if false and canDoAnimateTitle is true
+      animatedScrollRef.current.addEventListener('scroll', handleScroll);
+    }
+    if (!doAnimateTitle && sidePanelRef.current) {
+      sidePanelRef.current.style.setProperty("--".concat(blockClass, "--scroll-animation-progress"), 0);
+    }
+  }, [animatedScrollRef, doAnimateTitle, handleScroll, sidePanelRef]);
 
-          // Set collapsed title y positioning
-          var collapsedTitleYPosition = Math.min(1, (sidePanelSubtitleElementHeight - scrollTop) / sidePanelSubtitleElementHeight);
-          collapsedTitleYPosition = collapsedTitleYPosition < 0 ? 0 : collapsedTitleYPosition;
-          sidePanelOuter.style.setProperty("--".concat(blockClass, "--collapsed-title-y-position"), "".concat(collapsedTitleYPosition, "rem"));
+  /* istanbul ignore next */
+  var handleResize = function handleResize() {
+    checkSetDoAnimateTitle();
+  };
 
-          // Set label text height
-          var scrollAnimationProgress = dividerOpacity;
-          var reduceTitleContainerHeightAmount = labelTextHeight * scrollAnimationProgress / titleContainerHeight * 100;
-          sidePanelOuter.style.setProperty("--".concat(blockClass, "--label-text-height"), "".concat(Math.trunc(reduceTitleContainerHeightAmount), "px"));
-          sidePanelOuter.style.setProperty("--".concat(blockClass, "--title-container-height"), "".concat(titleContainerHeight, "px"));
-        } else {
-          sidePanelTitleElement.setAttribute('aria-hidden', 'false');
-          sidePanelCollapsedTitleElement.setAttribute('aria-hidden', 'true');
-          sidePanelOuter.classList.remove("".concat(blockClass, "__with-condensed-header"));
-          sidePanelOuter.style.setProperty("--".concat(blockClass, "--subtitle-opacity"), 1);
-          sidePanelOuter.style.setProperty("--".concat(blockClass, "--title-y-position"), 0);
-          sidePanelOuter.style.setProperty("--".concat(blockClass, "--divider-opacity"), 0);
-          sidePanelOuter.style.setProperty("--".concat(blockClass, "--collapsed-title-y-position"), "1rem");
-          sidePanelOuter.style.setProperty("--".concat(blockClass, "--label-text-height"), "0px");
-        }
-      });
-    }
-    if (open && !animateTitle) {
-      var _sidePanelOuter = document.querySelector("#".concat(id));
-      var _sidePanelTitleElement = document.querySelector(".".concat(blockClass, "__title-container .").concat(blockClass, "__title-text"));
-      var _sidePanelSubtitleElement = document.querySelector(".".concat(blockClass, "__subtitle-text"));
-      var actionToolbarElement = document.querySelector(".".concat(blockClass, "__action-toolbar"));
-      var _labelText = document.querySelector(".".concat(blockClass, "__label-text"));
-      var _sidePanelSubtitleElementHeight = (_sidePanelSubtitleElement === null || _sidePanelSubtitleElement === void 0 ? void 0 : _sidePanelSubtitleElement.offsetHeight) || 0;
-      var sidePanelActionBarElementHeight = (actionToolbarElement === null || actionToolbarElement === void 0 ? void 0 : actionToolbarElement.offsetHeight) || 0;
-      var titleHeight = (_sidePanelTitleElement === null || _sidePanelTitleElement === void 0 ? void 0 : _sidePanelTitleElement.offsetHeight) + 24;
-      var labelHeight = (_labelText === null || _labelText === void 0 ? void 0 : _labelText.offsetHeight) || 0;
-      _sidePanelOuter === null || _sidePanelOuter === void 0 || _sidePanelOuter.style.setProperty("--".concat(blockClass, "--title-text-height"), "".concat(titleHeight, "px"));
-      _sidePanelOuter === null || _sidePanelOuter === void 0 || _sidePanelOuter.style.setProperty("--".concat(blockClass, "--subtitle-container-height"), "".concat(_sidePanelSubtitleElementHeight, "px"));
-      _sidePanelOuter === null || _sidePanelOuter === void 0 || _sidePanelOuter.style.setProperty("--".concat(blockClass, "--action-bar-container-height"), "".concat(sidePanelActionBarElementHeight, "px"));
-      _sidePanelOuter === null || _sidePanelOuter === void 0 || _sidePanelOuter.style.setProperty("--".concat(blockClass, "--label-text-height"), "".concat(labelHeight, "px"));
+  // Calculate scroll distances
+  useEffect(function () {
+    if (sidePanelRef !== null && sidePanelRef !== void 0 && sidePanelRef.current && open && animateTitle && animationComplete && titleRef !== null && titleRef !== void 0 && titleRef.current && title && title.length && !reducedMotion.matches) {
+      checkSetDoAnimateTitle();
     }
-  }, [open, animateTitle, animationComplete, panelHeight, title, size, reducedMotion.matches, id]);
+
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [open, doAnimateTitle /* use do instead of animateTitle directly */, animationComplete, handleScroll, title, size, reducedMotion.matches, id, animatedScrollRef.current]);
 
   // click outside functionality if `includeOverlay` prop is set
   useEffect(function () {
     var handleOutsideClick = function handleOutsideClick(event) {
-      var panelRef = ref || sidePanelRef;
-      if (panelRef.current && sidePanelOverlayRef.current && sidePanelOverlayRef.current.contains(event.target) && onRequestClose) {
+      if (sidePanelRef.current && overlayRef.current && overlayRef.current.contains(event.target) && onRequestClose) {
         onRequestClose();
       }
     };
@@ -302,7 +248,7 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       bodyElement.style.overflow = '';
       document.removeEventListener('click', handleOutsideClick);
     };
-  }, [includeOverlay, onRequestClose, open, preventCloseOnClickOutside, ref, onUnmount]);
+  }, [includeOverlay, onRequestClose, open, preventCloseOnClickOutside, onUnmount, sidePanelRef]);
 
   // initializes the side panel to close
   var onAnimationEnd = function onAnimationEnd() {
@@ -365,13 +311,13 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
 
   // adds focus trap functionality
   /* istanbul ignore next */
-  var handleBlur = function handleBlur(_ref3) {
-    var oldActiveNode = _ref3.target,
-      currentActiveNode = _ref3.relatedTarget;
+  var handleBlur = function handleBlur(_ref2) {
+    var oldActiveNode = _ref2.target,
+      currentActiveNode = _ref2.relatedTarget;
     // focus trap should only be set if the side panel is a `slideOver` type
-    if (open && sidePanelInnerRef && !slideIn) {
+    if (open && innerContentRef && !slideIn) {
       wrapFocus({
-        bodyNode: sidePanelInnerRef.current,
+        bodyNode: innerContentRef.current,
         startTrapRef: startTrapRef,
         endTrapRef: endTrapRef,
         currentActiveNode: currentActiveNode,
@@ -379,8 +325,23 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       });
     }
   };
-  var primaryActionContainerClassNames = cx(["".concat(blockClass, "__actions-container"), _defineProperty({}, "".concat(blockClass, "__actions-container-condensed"), condensedActions)]);
-  var mainPanelClassNames = cx([blockClass, className, "".concat(blockClass, "__container"), "".concat(blockClass, "__container--").concat(size), _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, "".concat(blockClass, "__container-right-placement"), placement === 'right'), "".concat(blockClass, "__container-left-placement"), placement === 'left'), "".concat(blockClass, "__container-with-action-toolbar"), actionToolbarButtons && actionToolbarButtons.length), "".concat(blockClass, "__container-without-overlay"), !includeOverlay && !slideIn), "".concat(blockClass, "__container-is-animating"), !animationComplete || !open), "".concat(blockClass, "__container--has-slug"), slug)]);
+  var primaryActionContainerClassNames = cx(["".concat(blockClass, "__actions-container"), _defineProperty({}, "".concat(blockClass, "__actions-container--condensed"), condensedActions)]);
+  var mainPanelClassNames = cx([blockClass, className, "".concat(blockClass, "__container"), "".concat(blockClass, "__container--").concat(size), _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, "".concat(blockClass, "__container-right-placement"), placement === 'right'), "".concat(blockClass, "__container-left-placement"), placement === 'left'), "".concat(blockClass, "__container--slide-in"), slideIn), "".concat(blockClass, "__container--has-slug"), slug), "".concat(blockClass, "__container--condensed-actions"), condensedActions)]);
+  var renderTitle = function renderTitle() {
+    return /*#__PURE__*/React.createElement("div", {
+      className: cx("".concat(blockClass, "__title"), _defineProperty({}, "".concat(blockClass, "__title--no-label"), !labelTextRef.current)),
+      ref: titleRef
+    }, /*#__PURE__*/React.createElement("h2", {
+      className: "".concat(blockClass, "__title-text"),
+      title: title,
+      "aria-hidden": false
+    }, title), doAnimateTitle && !reducedMotion.matches && /*#__PURE__*/React.createElement("h2", {
+      className: "".concat(blockClass, "__collapsed-title-text"),
+      title: title,
+      "aria-hidden": true,
+      ref: collapsedTitleRef
+    }, title));
+  };
   var renderHeader = function renderHeader() {
     var _slug$type;
     var slugCloseSize = actions && actions.length && /l/.test(size) ? 'md' : 'sm';
@@ -391,8 +352,9 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
         size: slugCloseSize
       });
     }
-    return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("div", {
-      className: cx("".concat(blockClass, "__title-container"), _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, "".concat(blockClass, "__on-detail-step"), currentStep > 0), "".concat(blockClass, "__on-detail-step-without-title"), currentStep > 0 && !title), "".concat(blockClass, "__title-container--no-title-animation"), !animateTitle), "".concat(blockClass, "__title-container-is-animating"), !animationComplete || !open), "".concat(blockClass, "__title-container-without-title"), !title), "".concat(blockClass, "__title-container--reduced-motion"), reducedMotion.matches))
+    return /*#__PURE__*/React.createElement("div", {
+      className: cx("".concat(blockClass, "__header"), _defineProperty(_defineProperty(_defineProperty({}, "".concat(blockClass, "--on-detail-step"), currentStep > 0), "".concat(blockClass, "__header--no-title-animation"), !doAnimateTitle), "".concat(blockClass, "__header--reduced-motion"), reducedMotion.matches)),
+      ref: headerRef
     }, currentStep > 0 && /*#__PURE__*/React.createElement(Button, {
       "aria-label": navigationBackIconDescription,
       kind: "ghost",
@@ -407,8 +369,9 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       className: "".concat(blockClass, "__navigation-back-button"),
       onClick: onNavigationBack
     }), title && title.length && labelText && labelText.length && /*#__PURE__*/React.createElement("p", {
-      className: "".concat(blockClass, "__label-text")
-    }, labelText), title && title.length && renderTitle()), /*#__PURE__*/React.createElement("div", {
+      className: "".concat(blockClass, "__label-text"),
+      ref: labelTextRef
+    }, labelText), title && title.length && renderTitle(), /*#__PURE__*/React.createElement("div", {
       className: "".concat(blockClass, "__slug-and-close")
     }, normalizedSlug, /*#__PURE__*/React.createElement(Button, {
       "aria-label": closeIconDescription,
@@ -422,22 +385,23 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       iconDescription: closeIconDescription,
       className: "".concat(blockClass, "__close-button"),
       onClick: onRequestClose,
-      ref: sidePanelCloseRef
+      ref: closeRef
     })), subtitle && /*#__PURE__*/React.createElement("p", {
-      className: cx("".concat(blockClass, "__subtitle-text"), _defineProperty(_defineProperty(_defineProperty(_defineProperty({}, "".concat(blockClass, "__subtitle-text-no-animation"), !animateTitle), "".concat(blockClass, "__subtitle-text-no-animation-no-action-toolbar"), !animateTitle && (!actionToolbarButtons || !actionToolbarButtons.length)), "".concat(blockClass, "__subtitle-text-is-animating"), !animationComplete && animateTitle), "".concat(blockClass, "__subtitle-without-title"), !title))
+      className: cx("".concat(blockClass, "__subtitle-text"), _defineProperty({}, "".concat(blockClass, "__subtitle-text-no-animation-no-action-toolbar"), !doAnimateTitle && (!actionToolbarButtons || !actionToolbarButtons.length))),
+      ref: subtitleRef
     }, subtitle), actionToolbarButtons && actionToolbarButtons.length && /*#__PURE__*/React.createElement("div", {
-      className: cx("".concat(blockClass, "__action-toolbar"), _defineProperty({}, "".concat(blockClass, "__action-toolbar-no-animation"), !animateTitle))
-    }, actionToolbarButtons.map(function (_ref6) {
-      var label = _ref6.label,
-        kind = _ref6.kind,
-        icon = _ref6.icon,
-        tooltipPosition = _ref6.tooltipPosition,
-        tooltipAlignment = _ref6.tooltipAlignment,
-        leading = _ref6.leading,
-        disabled = _ref6.disabled,
-        className = _ref6.className,
-        onClick = _ref6.onClick,
-        rest = _objectWithoutProperties(_ref6, _excluded2);
+      className: "".concat(blockClass, "__action-toolbar")
+    }, actionToolbarButtons.map(function (_ref5) {
+      var label = _ref5.label,
+        kind = _ref5.kind,
+        icon = _ref5.icon,
+        tooltipPosition = _ref5.tooltipPosition,
+        tooltipAlignment = _ref5.tooltipAlignment,
+        leading = _ref5.leading,
+        disabled = _ref5.disabled,
+        className = _ref5.className,
+        onClick = _ref5.onClick,
+        rest = _objectWithoutProperties(_ref5, _excluded2);
       return /*#__PURE__*/React.createElement(Button, _extends({}, rest, {
         key: label,
         kind: kind || 'ghost',
@@ -453,24 +417,18 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       }), leading && label);
     })));
   };
-  var renderTitle = function renderTitle() {
-    return /*#__PURE__*/React.createElement(React.Fragment, null, title && title.length && /*#__PURE__*/React.createElement("h2", {
-      className: "".concat(blockClass, "__title-text"),
-      title: title,
-      "aria-hidden": false
-    }, title), animateTitle && title && title.length && !reducedMotion.matches && /*#__PURE__*/React.createElement("h2", {
-      className: "".concat(blockClass, "__collapsed-title-text"),
-      title: title,
-      "aria-hidden": true
-    }, title));
+  var renderMain = function renderMain() {
+    return /*#__PURE__*/React.createElement("div", {
+      ref: innerContentRef,
+      className: cx("".concat(blockClass, "__inner-content"), _defineProperty(_defineProperty({}, "".concat(blockClass, "__inner-content--static"), !doAnimateTitle), "".concat(blockClass, "--scrolls"), !doAnimateTitle))
+    }, children);
   };
-  var contentRef = ref || sidePanelRef;
-  useResizeObserver(contentRef, handleResize);
+  useResizeObserver(sidePanelRef, handleResize, [open]);
   return /*#__PURE__*/React.createElement(AnimatePresence, null, open && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(motion.div, _extends({}, getDevtoolsProps(componentName), rest, {
     id: id,
     className: mainPanelClassNames,
     onBlur: handleBlur,
-    ref: contentRef,
+    ref: sidePanelRef,
     role: "complementary",
     "aria-label": title,
     onAnimationComplete: onAnimationEnd,
@@ -487,16 +445,14 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     tabIndex: "0",
     role: "link",
     className: "".concat(blockClass, "__visually-hidden")
-  }, "Focus sentinel"), !animateTitle && renderHeader(), /*#__PURE__*/React.createElement("div", {
-    ref: sidePanelInnerRef,
-    className: cx("".concat(blockClass, "__inner-content"), _defineProperty(_defineProperty(_defineProperty({}, "".concat(blockClass, "__static-inner-content"), !animateTitle), "".concat(blockClass, "__static-inner-content-no-actions"), !animateTitle && !(actions !== null && actions !== void 0 && actions.length)), "".concat(blockClass, "__inner-content-with-actions"), actions && actions.length))
-  }, animateTitle && renderHeader(), /*#__PURE__*/React.createElement("div", {
-    className: "".concat(blockClass, "__body-content")
-  }, children), /*#__PURE__*/React.createElement(ActionSet, {
+  }, "Focus sentinel"), doAnimateTitle ? /*#__PURE__*/React.createElement("div", {
+    ref: animatedScrollRef,
+    className: "".concat(blockClass, "__animated-scroll-wrapper ").concat(blockClass, "--scrolls")
+  }, renderHeader(), renderMain()) : /*#__PURE__*/React.createElement(React.Fragment, null, renderHeader(), renderMain()), /*#__PURE__*/React.createElement(ActionSet, {
     actions: actions,
     className: primaryActionContainerClassNames,
     size: size === 'xs' ? 'sm' : size
-  })), /*#__PURE__*/React.createElement("span", {
+  }), /*#__PURE__*/React.createElement("span", {
     ref: endTrapRef,
     tabIndex: "0",
     role: "link",
@@ -506,7 +462,7 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     initial: "hidden",
     animate: "visible",
     exit: "exit",
-    ref: sidePanelOverlayRef,
+    ref: overlayRef,
     className: "".concat(blockClass, "__overlay")
   }))));
 });
@@ -621,8 +577,8 @@ SidePanel.propTypes = {
    * This is the selector to the element that contains all of the page content that will shrink if the panel is a slide in.
    * This prop is required when using the `slideIn` variant of the side panel.
    */
-  selectorPageContent: PropTypes.string.isRequired.if(function (_ref8) {
-    var slideIn = _ref8.slideIn;
+  selectorPageContent: PropTypes.string.isRequired.if(function (_ref7) {
+    var slideIn = _ref7.slideIn;
     return slideIn;
   }),
   /**
@@ -649,8 +605,8 @@ SidePanel.propTypes = {
   /**
    * Sets the title text
    */
-  title: PropTypes.string.isRequired.if(function (_ref9) {
-    var labelText = _ref9.labelText;
+  title: PropTypes.string.isRequired.if(function (_ref8) {
+    var labelText = _ref8.labelText;
     return labelText;
   })
 };

package/es/components/TagSet/TagSet.js

@@ -4,11 +4,11 @@ import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
 var _excluded = ["align", "allTagsModalTarget", "className", "maxVisible", "multiline", "overflowAlign", "overflowClassName", "overflowType", "allTagsModalTitle", "allTagsModalSearchLabel", "allTagsModalSearchPlaceholderText", "showAllTagsLabel", "tags", "containingElementRef", "measurementOffset"],
   _excluded2 = ["label", "id"],
-  _excluded3 = ["label"];
+  _excluded3 = ["label", "onClose"];
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 //
-// Copyright IBM Corp. 2020, 2023
+// 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.
@@ -81,6 +81,10 @@ export var TagSet = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     sizingTags = _useState10[0],
     setSizingTags = _useState10[1];
   var overflowTag = useRef(null);
+  var _useState11 = useState(false),
+    _useState12 = _slicedToArray(_useState11, 2),
+    popoverOpen = _useState12[0],
+    setPopoverOpen = _useState12[1];
   var handleShowAllClick = function handleShowAllClick() {
     setShowAllModalOpen(true);
   };
@@ -104,13 +108,23 @@ export var TagSet = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     }) : []);
     setSizingTags(newSizingTags);
   }, [tags]);
+  var handleTagOnClose = useCallback(function (onClose, index) {
+    onClose === null || onClose === void 0 || onClose();
+    if (index <= displayCount - 1) {
+      setPopoverOpen(false);
+    }
+  }, [displayCount]);
   useEffect(function () {
     // create visible and overflow tags
     var newDisplayedTags = tags && tags.length > 0 ? tags.map(function (_ref3, index) {
       var label = _ref3.label,
+        _onClose = _ref3.onClose,
         other = _objectWithoutProperties(_ref3, _excluded3);
       return /*#__PURE__*/React.createElement(Tag, _extends({}, other, {
-        key: "displayed-tag-".concat(index)
+        key: "displayed-tag-".concat(index),
+        onClose: function onClose() {
+          return handleTagOnClose(_onClose, index);
+        }
       }), label);
     }) : [];
 
@@ -133,10 +147,12 @@ export var TagSet = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       overflowType: overflowType,
       showAllTagsLabel: showAllTagsLabel,
       key: "displayed-tag-overflow",
-      ref: overflowTag
+      ref: overflowTag,
+      popoverOpen: popoverOpen,
+      setPopoverOpen: setPopoverOpen
     }));
     setDisplayedTags(newDisplayedTags);
-  }, [displayCount, overflowAlign, overflowClassName, overflowType, showAllTagsLabel, tags]);
+  }, [displayCount, overflowAlign, overflowClassName, overflowType, showAllTagsLabel, tags, popoverOpen, handleTagOnClose]);
   var checkFullyVisibleTags = useCallback(function () {
     if (multiline) {
       return setDisplayCount(maxVisible);

package/es/components/TagSet/TagSetOverflow.js

@@ -1,16 +1,15 @@
 import _extends from "@babel/runtime/helpers/extends";
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
-import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
-var _excluded = ["allTagsModalSearchThreshold", "className", "onShowAllClick", "overflowAlign", "overflowTags", "overflowType", "showAllTagsLabel"];
+var _excluded = ["allTagsModalSearchThreshold", "className", "onShowAllClick", "overflowAlign", "overflowTags", "overflowType", "showAllTagsLabel", "popoverOpen", "setPopoverOpen"];
 //
-// Copyright IBM Corp. 2021, 2022
+// Copyright IBM Corp. 2021, 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.
 //
 
-import React, { useState, useRef } from 'react';
+import React, { useRef } from 'react';
 import PropTypes from 'prop-types';
 import cx from 'classnames';
 import { Link, Tag, Popover, PopoverContent } from '@carbon/react';
@@ -34,11 +33,9 @@ export var TagSetOverflow = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     overflowTags = _ref.overflowTags,
     overflowType = _ref.overflowType,
     showAllTagsLabel = _ref.showAllTagsLabel,
+    popoverOpen = _ref.popoverOpen,
+    setPopoverOpen = _ref.setPopoverOpen,
     rest = _objectWithoutProperties(_ref, _excluded);
-  var _useState = useState(false),
-    _useState2 = _slicedToArray(_useState, 2),
-    popoverOpen = _useState2[0],
-    setPopoverOpen = _useState2[1];
   var localRef = useRef();
   var overflowTagContent = useRef(null);
   useClickOutside(ref || localRef, function () {
@@ -126,6 +123,14 @@ TagSetOverflow.propTypes = {
    * Type of rendering displayed inside of the tag overflow component
    */
   overflowType: PropTypes.oneOf(['default', 'tag']),
+  /**
+   * Open state of the popover
+   */
+  popoverOpen: PropTypes.bool,
+  /**
+   * Setter function for the popoverOpen state value
+   */
+  setPopoverOpen: PropTypes.func,
   /**
    * label for the overflow show all tags link
    */

package/es/components/index.js

@@ -45,4 +45,5 @@ export { EditUpdateCards } from './EditUpdateCards';
 export { Checklist } from './Checklist';
 export { Guidebanner, GuidebannerElement, GuidebannerElementButton, GuidebannerElementLink } from './Guidebanner';
 export { InlineTip, InlineTipButton, InlineTipLink } from './InlineTip';
-export { NonLinearReading } from './NonLinearReading';
+export { NonLinearReading } from './NonLinearReading';
+export { DelimitedList } from './DelimitedList';