@carbon/ibm-products 2.21.0 → 2.22.0

package/lib/components/SidePanel/SidePanel.js

@@ -99,47 +99,56 @@ var SidePanel = exports.SidePanel = /*#__PURE__*/_react.default.forwardRef(funct
     _useState2 = (0, _slicedToArray2.default)(_useState, 2),
     animationComplete = _useState2[0],
     setAnimationComplete = _useState2[1];
-  var _useState3 = (0, _react.useState)(0),
-    _useState4 = (0, _slicedToArray2.default)(_useState3, 2),
-    panelHeight = _useState4[0],
-    setPanelHeight = _useState4[1];
-  var sidePanelRef = (0, _react.useRef)();
-  var sidePanelOverlayRef = (0, _react.useRef)();
+  var localRef = (0, _react.useRef)();
+  var sidePanelRef = ref || localRef;
+  var overlayRef = (0, _react.useRef)();
   var startTrapRef = (0, _react.useRef)();
   var endTrapRef = (0, _react.useRef)();
-  var sidePanelInnerRef = (0, _react.useRef)();
-  var sidePanelCloseRef = (0, _react.useRef)();
+  var innerContentRef = (0, _react.useRef)();
+  var closeRef = (0, _react.useRef)();
+  var animatedScrollRef = (0, _react.useRef)();
+  var headerRef = (0, _react.useRef)();
+  var titleRef = (0, _react.useRef)();
+  var collapsedTitleRef = (0, _react.useRef)();
+  var labelTextRef = (0, _react.useRef)();
+  var subtitleRef = (0, _react.useRef)();
   var previousState = (0, _hooks.usePreviousValue)({
     size: size,
     open: open
   });
+  var _useState3 = (0, _react.useState)(-1),
+    _useState4 = (0, _slicedToArray2.default)(_useState3, 2),
+    scrollAnimationDistance = _useState4[0],
+    setScrollAnimationDistance = _useState4[1];
+  var _useState5 = (0, _react.useState)(true),
+    _useState6 = (0, _slicedToArray2.default)(_useState5, 2),
+    doAnimateTitle = _useState6[0],
+    setDoAnimateTitle = _useState6[1];
+  (0, _react.useEffect)(function () {
+    setDoAnimateTitle(animateTitle);
+  }, [animateTitle]);
+  var handleScroll = (0, _react.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 = (0, _react.useCallback)(function () {
-    var sidePanelOuter = document.querySelector("#".concat(id));
-    return sidePanelOuter && sidePanelOuter.querySelector(".".concat(blockClass, "__actions-container"));
-  }, [id]);
 
   // scroll panel to top going between steps
   (0, _react.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
   (0, _react.useEffect)(function () {
@@ -149,7 +158,7 @@ var SidePanel = exports.SidePanel = /*#__PURE__*/_react.default.forwardRef(funct
       if (primaryFocusElement) {
         return primaryFocusElement;
       } else {
-        return sidePanelCloseRef && sidePanelCloseRef.current;
+        return closeRef && closeRef.current;
       }
     };
     var focusButton = function focusButton(focusContainerElement) {
@@ -157,19 +166,9 @@ var SidePanel = exports.SidePanel = /*#__PURE__*/_react.default.forwardRef(funct
       target === null || target === void 0 || target.focus();
     };
     if (open && animationComplete) {
-      focusButton(sidePanelInnerRef.current);
+      focusButton(innerContentRef.current);
     }
   }, [selectorPrimaryFocus, open, animationComplete]);
-  (0, _react.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.
@@ -178,120 +177,67 @@ var SidePanel = exports.SidePanel = /*#__PURE__*/_react.default.forwardRef(funct
       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);
+        }
+      }
+    }
+  };
   (0, _react.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
+  (0, _react.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
   (0, _react.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();
       }
     };
@@ -309,7 +255,7 @@ var SidePanel = exports.SidePanel = /*#__PURE__*/_react.default.forwardRef(funct
       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() {
@@ -372,13 +318,13 @@ var SidePanel = exports.SidePanel = /*#__PURE__*/_react.default.forwardRef(funct
 
   // 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) {
       (0, _wrapFocus.default)({
-        bodyNode: sidePanelInnerRef.current,
+        bodyNode: innerContentRef.current,
         startTrapRef: startTrapRef,
         endTrapRef: endTrapRef,
         currentActiveNode: currentActiveNode,
@@ -386,8 +332,23 @@ var SidePanel = exports.SidePanel = /*#__PURE__*/_react.default.forwardRef(funct
       });
     }
   };
-  var primaryActionContainerClassNames = (0, _classnames.default)(["".concat(blockClass, "__actions-container"), (0, _defineProperty2.default)({}, "".concat(blockClass, "__actions-container-condensed"), condensedActions)]);
-  var mainPanelClassNames = (0, _classnames.default)([blockClass, className, "".concat(blockClass, "__container"), "".concat(blockClass, "__container--").concat(size), (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, "".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 = (0, _classnames.default)(["".concat(blockClass, "__actions-container"), (0, _defineProperty2.default)({}, "".concat(blockClass, "__actions-container--condensed"), condensedActions)]);
+  var mainPanelClassNames = (0, _classnames.default)([blockClass, className, "".concat(blockClass, "__container"), "".concat(blockClass, "__container--").concat(size), (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, "".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.default.createElement("div", {
+      className: (0, _classnames.default)("".concat(blockClass, "__title"), (0, _defineProperty2.default)({}, "".concat(blockClass, "__title--no-label"), !labelTextRef.current)),
+      ref: titleRef
+    }, /*#__PURE__*/_react.default.createElement("h2", {
+      className: "".concat(blockClass, "__title-text"),
+      title: title,
+      "aria-hidden": false
+    }, title), doAnimateTitle && !reducedMotion.matches && /*#__PURE__*/_react.default.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';
@@ -398,8 +359,9 @@ var SidePanel = exports.SidePanel = /*#__PURE__*/_react.default.forwardRef(funct
         size: slugCloseSize
       });
     }
-    return /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, /*#__PURE__*/_react.default.createElement("div", {
-      className: (0, _classnames.default)("".concat(blockClass, "__title-container"), (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, "".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.default.createElement("div", {
+      className: (0, _classnames.default)("".concat(blockClass, "__header"), (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, "".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.default.createElement(_react2.Button, {
       "aria-label": navigationBackIconDescription,
       kind: "ghost",
@@ -414,8 +376,9 @@ var SidePanel = exports.SidePanel = /*#__PURE__*/_react.default.forwardRef(funct
       className: "".concat(blockClass, "__navigation-back-button"),
       onClick: onNavigationBack
     }), title && title.length && labelText && labelText.length && /*#__PURE__*/_react.default.createElement("p", {
-      className: "".concat(blockClass, "__label-text")
-    }, labelText), title && title.length && renderTitle()), /*#__PURE__*/_react.default.createElement("div", {
+      className: "".concat(blockClass, "__label-text"),
+      ref: labelTextRef
+    }, labelText), title && title.length && renderTitle(), /*#__PURE__*/_react.default.createElement("div", {
       className: "".concat(blockClass, "__slug-and-close")
     }, normalizedSlug, /*#__PURE__*/_react.default.createElement(_react2.Button, {
       "aria-label": closeIconDescription,
@@ -429,22 +392,23 @@ var SidePanel = exports.SidePanel = /*#__PURE__*/_react.default.forwardRef(funct
       iconDescription: closeIconDescription,
       className: "".concat(blockClass, "__close-button"),
       onClick: onRequestClose,
-      ref: sidePanelCloseRef
+      ref: closeRef
     })), subtitle && /*#__PURE__*/_react.default.createElement("p", {
-      className: (0, _classnames.default)("".concat(blockClass, "__subtitle-text"), (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, "".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: (0, _classnames.default)("".concat(blockClass, "__subtitle-text"), (0, _defineProperty2.default)({}, "".concat(blockClass, "__subtitle-text-no-animation-no-action-toolbar"), !doAnimateTitle && (!actionToolbarButtons || !actionToolbarButtons.length))),
+      ref: subtitleRef
     }, subtitle), actionToolbarButtons && actionToolbarButtons.length && /*#__PURE__*/_react.default.createElement("div", {
-      className: (0, _classnames.default)("".concat(blockClass, "__action-toolbar"), (0, _defineProperty2.default)({}, "".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 = (0, _objectWithoutProperties2.default)(_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 = (0, _objectWithoutProperties2.default)(_ref5, _excluded2);
       return /*#__PURE__*/_react.default.createElement(_react2.Button, (0, _extends2.default)({}, rest, {
         key: label,
         kind: kind || 'ghost',
@@ -460,24 +424,18 @@ var SidePanel = exports.SidePanel = /*#__PURE__*/_react.default.forwardRef(funct
       }), leading && label);
     })));
   };
-  var renderTitle = function renderTitle() {
-    return /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, title && title.length && /*#__PURE__*/_react.default.createElement("h2", {
-      className: "".concat(blockClass, "__title-text"),
-      title: title,
-      "aria-hidden": false
-    }, title), animateTitle && title && title.length && !reducedMotion.matches && /*#__PURE__*/_react.default.createElement("h2", {
-      className: "".concat(blockClass, "__collapsed-title-text"),
-      title: title,
-      "aria-hidden": true
-    }, title));
+  var renderMain = function renderMain() {
+    return /*#__PURE__*/_react.default.createElement("div", {
+      ref: innerContentRef,
+      className: (0, _classnames.default)("".concat(blockClass, "__inner-content"), (0, _defineProperty2.default)((0, _defineProperty2.default)({}, "".concat(blockClass, "__inner-content--static"), !doAnimateTitle), "".concat(blockClass, "--scrolls"), !doAnimateTitle))
+    }, children);
   };
-  var contentRef = ref || sidePanelRef;
-  (0, _useResizeObserver.useResizeObserver)(contentRef, handleResize);
+  (0, _useResizeObserver.useResizeObserver)(sidePanelRef, handleResize, [open]);
   return /*#__PURE__*/_react.default.createElement(_framerMotion.AnimatePresence, null, open && /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, /*#__PURE__*/_react.default.createElement(_framerMotion.motion.div, (0, _extends2.default)({}, (0, _devtools.getDevtoolsProps)(componentName), rest, {
     id: id,
     className: mainPanelClassNames,
     onBlur: handleBlur,
-    ref: contentRef,
+    ref: sidePanelRef,
     role: "complementary",
     "aria-label": title,
     onAnimationComplete: onAnimationEnd,
@@ -494,16 +452,14 @@ var SidePanel = exports.SidePanel = /*#__PURE__*/_react.default.forwardRef(funct
     tabIndex: "0",
     role: "link",
     className: "".concat(blockClass, "__visually-hidden")
-  }, "Focus sentinel"), !animateTitle && renderHeader(), /*#__PURE__*/_react.default.createElement("div", {
-    ref: sidePanelInnerRef,
-    className: (0, _classnames.default)("".concat(blockClass, "__inner-content"), (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, "".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.default.createElement("div", {
-    className: "".concat(blockClass, "__body-content")
-  }, children), /*#__PURE__*/_react.default.createElement(_ActionSet.ActionSet, {
+  }, "Focus sentinel"), doAnimateTitle ? /*#__PURE__*/_react.default.createElement("div", {
+    ref: animatedScrollRef,
+    className: "".concat(blockClass, "__animated-scroll-wrapper ").concat(blockClass, "--scrolls")
+  }, renderHeader(), renderMain()) : /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, renderHeader(), renderMain()), /*#__PURE__*/_react.default.createElement(_ActionSet.ActionSet, {
     actions: actions,
     className: primaryActionContainerClassNames,
     size: size === 'xs' ? 'sm' : size
-  })), /*#__PURE__*/_react.default.createElement("span", {
+  }), /*#__PURE__*/_react.default.createElement("span", {
     ref: endTrapRef,
     tabIndex: "0",
     role: "link",
@@ -513,7 +469,7 @@ var SidePanel = exports.SidePanel = /*#__PURE__*/_react.default.forwardRef(funct
     initial: "hidden",
     animate: "visible",
     exit: "exit",
-    ref: sidePanelOverlayRef,
+    ref: overlayRef,
     className: "".concat(blockClass, "__overlay")
   }))));
 });
@@ -628,8 +584,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.default.string.isRequired.if(function (_ref8) {
-    var slideIn = _ref8.slideIn;
+  selectorPageContent: _propTypes.default.string.isRequired.if(function (_ref7) {
+    var slideIn = _ref7.slideIn;
     return slideIn;
   }),
   /**
@@ -656,8 +612,8 @@ SidePanel.propTypes = {
   /**
    * Sets the title text
    */
-  title: _propTypes.default.string.isRequired.if(function (_ref9) {
-    var labelText = _ref9.labelText;
+  title: _propTypes.default.string.isRequired.if(function (_ref8) {
+    var labelText = _ref8.labelText;
     return labelText;
   })
 };

package/lib/components/TagSet/TagSet.js

@@ -22,8 +22,8 @@ var _propsHelper = require("../../global/js/utils/props-helper");
 var _settings = require("../../settings");
 var _excluded = ["align", "allTagsModalTarget", "className", "maxVisible", "multiline", "overflowAlign", "overflowClassName", "overflowType", "allTagsModalTitle", "allTagsModalSearchLabel", "allTagsModalSearchPlaceholderText", "showAllTagsLabel", "tags", "containingElementRef", "measurementOffset"],
   _excluded2 = ["label", "id"],
-  _excluded3 = ["label"]; //
-// Copyright IBM Corp. 2020, 2023
+  _excluded3 = ["label", "onClose"]; //
+// 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.
@@ -89,6 +89,10 @@ var TagSet = exports.TagSet = /*#__PURE__*/_react.default.forwardRef(function (_
     sizingTags = _useState10[0],
     setSizingTags = _useState10[1];
   var overflowTag = (0, _react.useRef)(null);
+  var _useState11 = (0, _react.useState)(false),
+    _useState12 = (0, _slicedToArray2.default)(_useState11, 2),
+    popoverOpen = _useState12[0],
+    setPopoverOpen = _useState12[1];
   var handleShowAllClick = function handleShowAllClick() {
     setShowAllModalOpen(true);
   };
@@ -112,13 +116,23 @@ var TagSet = exports.TagSet = /*#__PURE__*/_react.default.forwardRef(function (_
     }) : []);
     setSizingTags(newSizingTags);
   }, [tags]);
+  var handleTagOnClose = (0, _react.useCallback)(function (onClose, index) {
+    onClose === null || onClose === void 0 || onClose();
+    if (index <= displayCount - 1) {
+      setPopoverOpen(false);
+    }
+  }, [displayCount]);
   (0, _react.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 = (0, _objectWithoutProperties2.default)(_ref3, _excluded3);
       return /*#__PURE__*/_react.default.createElement(_react2.Tag, (0, _extends2.default)({}, other, {
-        key: "displayed-tag-".concat(index)
+        key: "displayed-tag-".concat(index),
+        onClose: function onClose() {
+          return handleTagOnClose(_onClose, index);
+        }
       }), label);
     }) : [];
 
@@ -141,10 +155,12 @@ var TagSet = exports.TagSet = /*#__PURE__*/_react.default.forwardRef(function (_
       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 = (0, _react.useCallback)(function () {
     if (multiline) {
       return setDisplayCount(maxVisible);

package/lib/components/TagSet/TagSetOverflow.js

@@ -8,7 +8,6 @@ Object.defineProperty(exports, "__esModule", {
 exports.TagSetOverflow = void 0;
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
-var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
 var _react = _interopRequireWildcard(require("react"));
 var _propTypes = _interopRequireDefault(require("prop-types"));
@@ -16,8 +15,8 @@ var _classnames = _interopRequireDefault(require("classnames"));
 var _react2 = require("@carbon/react");
 var _hooks = require("../../global/js/hooks");
 var _settings = require("../../settings");
-var _excluded = ["allTagsModalSearchThreshold", "className", "onShowAllClick", "overflowAlign", "overflowTags", "overflowType", "showAllTagsLabel"]; //
-// Copyright IBM Corp. 2021, 2022
+var _excluded = ["allTagsModalSearchThreshold", "className", "onShowAllClick", "overflowAlign", "overflowTags", "overflowType", "showAllTagsLabel", "popoverOpen", "setPopoverOpen"]; //
+// 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.
@@ -42,11 +41,9 @@ var TagSetOverflow = exports.TagSetOverflow = /*#__PURE__*/_react.default.forwar
     overflowTags = _ref.overflowTags,
     overflowType = _ref.overflowType,
     showAllTagsLabel = _ref.showAllTagsLabel,
+    popoverOpen = _ref.popoverOpen,
+    setPopoverOpen = _ref.setPopoverOpen,
     rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
-  var _useState = (0, _react.useState)(false),
-    _useState2 = (0, _slicedToArray2.default)(_useState, 2),
-    popoverOpen = _useState2[0],
-    setPopoverOpen = _useState2[1];
   var localRef = (0, _react.useRef)();
   var overflowTagContent = (0, _react.useRef)(null);
   (0, _hooks.useClickOutside)(ref || localRef, function () {
@@ -134,6 +131,14 @@ TagSetOverflow.propTypes = {
    * Type of rendering displayed inside of the tag overflow component
    */
   overflowType: _propTypes.default.oneOf(['default', 'tag']),
+  /**
+   * Open state of the popover
+   */
+  popoverOpen: _propTypes.default.bool,
+  /**
+   * Setter function for the popoverOpen state value
+   */
+  setPopoverOpen: _propTypes.default.func,
   /**
    * label for the overflow show all tags link
    */

package/lib/components/index.js

@@ -99,6 +99,12 @@ Object.defineProperty(exports, "Datagrid", {
     return _Datagrid.Datagrid;
   }
 });
+Object.defineProperty(exports, "DelimitedList", {
+  enumerable: true,
+  get: function get() {
+    return _DelimitedList.DelimitedList;
+  }
+});
 Object.defineProperty(exports, "EditFullPage", {
   enumerable: true,
   get: function get() {
@@ -553,4 +559,5 @@ var _EditUpdateCards = require("./EditUpdateCards");
 var _Checklist = require("./Checklist");
 var _Guidebanner = require("./Guidebanner");
 var _InlineTip = require("./InlineTip");
-var _NonLinearReading = require("./NonLinearReading");
+var _NonLinearReading = require("./NonLinearReading");
+var _DelimitedList = require("./DelimitedList");