@carbon/ibm-products 2.0.0-rc.9 → 2.0.1

package/lib/components/SidePanel/SidePanel.js

@@ -1,69 +1,52 @@
 "use strict";
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-
 var _typeof = require("@babel/runtime/helpers/typeof");
-
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.SidePanel = 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 _framerMotion = require("framer-motion");
-
 var _propTypes = _interopRequireDefault(require("prop-types"));
-
 var _classnames = _interopRequireDefault(require("classnames"));
-
-var _reactResizeDetector = require("react-resize-detector");
-
+var _useResizeObserver = require("../../global/js/hooks/useResizeObserver");
 var _motion = require("@carbon/motion");
-
 var _devtools = require("../../global/js/utils/devtools");
-
 var _propsHelper = require("../../global/js/utils/props-helper");
-
 var _wrapFocus = _interopRequireDefault(require("../../global/js/utils/wrapFocus"));
-
 var _settings = require("../../settings");
-
 var _constants = require("./constants");
-
 var _hooks = require("../../global/js/hooks");
-
 var _react2 = require("@carbon/react");
-
 var _icons = require("@carbon/react/icons");
-
 var _ActionSet = require("../ActionSet");
-
 var _variants = require("./motion/variants");
-
 var _excluded = ["actionToolbarButtons", "actions", "animateTitle", "children", "className", "closeIconDescription", "condensedActions", "currentStep", "includeOverlay", "labelText", "navigationBackIconDescription", "onNavigationBack", "onRequestClose", "onUnmount", "open", "placement", "preventCloseOnClickOutside", "selectorPageContent", "selectorPrimaryFocus", "size", "slideIn", "subtitle", "title"],
-    _excluded2 = ["label", "kind", "icon", "leading", "disabled", "className", "onClick"];
-
+  _excluded2 = ["label", "kind", "icon", "tooltipPosition", "tooltipAlignment", "leading", "disabled", "className", "onClick"];
+/**
+ * Copyright IBM Corp. 2020, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+// Import portions of React that are needed.
+// Other standard imports.
+// Carbon and package components we use.
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
-
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
-
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
-
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
-
 var blockClass = "".concat(_settings.pkg.prefix, "--side-panel");
-var componentName = 'SidePanel'; // NOTE: the component SCSS is not imported here: it is rolled up separately.
-// Default values for props
+var componentName = 'SidePanel';
 
+// NOTE: the component SCSS is not imported here: it is rolled up separately.
+
+// Default values for props
 var defaults = {
   animateTitle: true,
   closeIconDescription: 'Close',
@@ -72,54 +55,50 @@ var defaults = {
   placement: 'right',
   size: 'md'
 };
+
 /**
  * Side panels keep users in-context of a page while performing tasks like navigating, editing, viewing details, or configuring something new.
  */
-
 var SidePanel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
-  var _window, _ref4, _cx4;
-
+  var _window, _ref5, _cx4;
   var actionToolbarButtons = _ref.actionToolbarButtons,
-      actions = _ref.actions,
-      _ref$animateTitle = _ref.animateTitle,
-      animateTitle = _ref$animateTitle === void 0 ? defaults.animateTitle : _ref$animateTitle,
-      children = _ref.children,
-      className = _ref.className,
-      _ref$closeIconDescrip = _ref.closeIconDescription,
-      closeIconDescription = _ref$closeIconDescrip === void 0 ? defaults.closeIconDescription : _ref$closeIconDescrip,
-      condensedActions = _ref.condensedActions,
-      _ref$currentStep = _ref.currentStep,
-      currentStep = _ref$currentStep === void 0 ? defaults.currentStep : _ref$currentStep,
-      includeOverlay = _ref.includeOverlay,
-      labelText = _ref.labelText,
-      _ref$navigationBackIc = _ref.navigationBackIconDescription,
-      navigationBackIconDescription = _ref$navigationBackIc === void 0 ? defaults.navigationBackIconDescription : _ref$navigationBackIc,
-      onNavigationBack = _ref.onNavigationBack,
-      onRequestClose = _ref.onRequestClose,
-      onUnmount = _ref.onUnmount,
-      open = _ref.open,
-      _ref$placement = _ref.placement,
-      placement = _ref$placement === void 0 ? defaults.placement : _ref$placement,
-      preventCloseOnClickOutside = _ref.preventCloseOnClickOutside,
-      selectorPageContent = _ref.selectorPageContent,
-      selectorPrimaryFocus = _ref.selectorPrimaryFocus,
-      _ref$size = _ref.size,
-      size = _ref$size === void 0 ? defaults.size : _ref$size,
-      slideIn = _ref.slideIn,
-      subtitle = _ref.subtitle,
-      title = _ref.title,
-      rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
-
+    actions = _ref.actions,
+    _ref$animateTitle = _ref.animateTitle,
+    animateTitle = _ref$animateTitle === void 0 ? defaults.animateTitle : _ref$animateTitle,
+    children = _ref.children,
+    className = _ref.className,
+    _ref$closeIconDescrip = _ref.closeIconDescription,
+    closeIconDescription = _ref$closeIconDescrip === void 0 ? defaults.closeIconDescription : _ref$closeIconDescrip,
+    condensedActions = _ref.condensedActions,
+    _ref$currentStep = _ref.currentStep,
+    currentStep = _ref$currentStep === void 0 ? defaults.currentStep : _ref$currentStep,
+    includeOverlay = _ref.includeOverlay,
+    labelText = _ref.labelText,
+    _ref$navigationBackIc = _ref.navigationBackIconDescription,
+    navigationBackIconDescription = _ref$navigationBackIc === void 0 ? defaults.navigationBackIconDescription : _ref$navigationBackIc,
+    onNavigationBack = _ref.onNavigationBack,
+    onRequestClose = _ref.onRequestClose,
+    onUnmount = _ref.onUnmount,
+    open = _ref.open,
+    _ref$placement = _ref.placement,
+    placement = _ref$placement === void 0 ? defaults.placement : _ref$placement,
+    preventCloseOnClickOutside = _ref.preventCloseOnClickOutside,
+    selectorPageContent = _ref.selectorPageContent,
+    selectorPrimaryFocus = _ref.selectorPrimaryFocus,
+    _ref$size = _ref.size,
+    size = _ref$size === void 0 ? defaults.size : _ref$size,
+    slideIn = _ref.slideIn,
+    subtitle = _ref.subtitle,
+    title = _ref.title,
+    rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
   var _useState = (0, _react.useState)(false),
-      _useState2 = (0, _slicedToArray2.default)(_useState, 2),
-      animationComplete = _useState2[0],
-      setAnimationComplete = _useState2[1];
-
+    _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];
-
+    _useState4 = (0, _slicedToArray2.default)(_useState3, 2),
+    panelHeight = _useState4[0],
+    setPanelHeight = _useState4[1];
   var sidePanelRef = (0, _react.useRef)();
   var sidePanelOverlayRef = (0, _react.useRef)();
   var startTrapRef = (0, _react.useRef)();
@@ -132,47 +111,43 @@ var SidePanel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
   });
   var reducedMotion = typeof window !== 'undefined' && (_window = window) !== null && _window !== void 0 && _window.matchMedia ? window.matchMedia('(prefers-reduced-motion: reduce)') : {
     matches: true
-  }; // scroll panel to top going between steps
+  };
 
+  // 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(blockClass, "-outer"));
       var initialTitleHeight = (_document$querySelect = document.querySelector(".".concat(blockClass, "__title-container"))) === null || _document$querySelect === void 0 ? void 0 : _document$querySelect.offsetHeight;
-      scrollableSection.scrollTop = 0; // The size of the panel has changed while it is still opened
+      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
       // 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 ? void 0 : (_sidePanelOuter$style = sidePanelOuter.style) === null || _sidePanelOuter$style === void 0 ? 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]); // set initial focus when side panel opens
+  }, [currentStep, ref, size, previousState === null || previousState === void 0 ? void 0 : previousState.size]);
 
+  // set initial focus when side panel opens
   (0, _react.useEffect)(function () {
     var initialFocus = function initialFocus(focusContainerElement) {
       var containerElement = focusContainerElement;
       var primaryFocusElement = containerElement && containerElement.querySelector(selectorPrimaryFocus);
-
       if (primaryFocusElement) {
         return primaryFocusElement;
       } else {
         return sidePanelCloseRef && sidePanelCloseRef.current;
       }
     };
-
     var focusButton = function focusButton(focusContainerElement) {
       var target = initialFocus(focusContainerElement);
       target === null || target === void 0 ? void 0 : target.focus();
     };
-
     if (open && animationComplete) {
       focusButton(sidePanelInnerRef.current);
     }
@@ -180,46 +155,42 @@ var SidePanel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
   (0, _react.useEffect)(function () {
     if (open && actions && actions.length && animationComplete) {
       var _sidePanelOuter$style2;
-
       var sidePanelOuter = document.querySelector("#".concat(blockClass, "-outer"));
       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 ? void 0 : (_sidePanelOuter$style2 = sidePanelOuter.style) === null || _sidePanelOuter$style2 === void 0 ? void 0 : _sidePanelOuter$style2.setProperty("--".concat(blockClass, "--content-bottom-padding"), actionsHeight);
     }
-  }, [actions, condensedActions, open, animationComplete]); // Add console warning if labelText is provided without a title.
-  // This combination is not allowed.
+  }, [actions, condensedActions, open, animationComplete]);
 
+  // Add console warning if labelText is provided without a title.
+  // This combination is not allowed.
   (0, _react.useEffect)(function () {
     if (!title && labelText) {
       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]);
-  /* istanbul ignore next */
 
-  var handleResize = function handleResize(width, height) {
+  /* istanbul ignore next */
+  var handleResize = function handleResize(_ref2) {
     var _sidePanelOuter$style3;
-
+    var height = _ref2.height;
     setPanelHeight(height);
     var sidePanelOuter = document.querySelector("#".concat(blockClass, "-outer"));
     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 ? void 0 : (_sidePanelOuter$style3 = sidePanelOuter.style) === null || _sidePanelOuter$style3 === void 0 ? void 0 : _sidePanelOuter$style3.setProperty("--".concat(blockClass, "--content-bottom-padding"), actionsHeight);
   };
-
   var getActionsContainerElement = function getActionsContainerElement() {
     var sidePanelOuter = document.querySelector("#".concat(blockClass, "-outer"));
     return sidePanelOuter && sidePanelOuter.querySelector(".".concat(blockClass, "__actions-container"));
-  }; // Title and subtitle scroll animation
-
+  };
 
+  // Title and subtitle scroll animation
   (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(blockClass, "-outer"));
       var sidePanelScrollArea = document.querySelector("#".concat(blockClass, "-outer .").concat(blockClass, "__inner-content"));
       var sidePanelTitleElement = document.querySelector(".".concat(blockClass, "__title-text"));
@@ -231,50 +202,54 @@ var SidePanel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
       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
+      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
-
+        var scrollTop = sidePanelScrollArea.scrollTop;
+        // if scrolling has occurred
         if (scrollTop > 0) {
-          sidePanelOuter.classList.add("".concat(blockClass, "__with-condensed-header")); // Set subtitle opacity calculation here
+          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
+          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
+          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
+          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
+          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');
-          } // Set collapsed title y positioning
-
+          }
 
+          // 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")); // Set label text height
+          sidePanelOuter.style.setProperty("--".concat(blockClass, "--collapsed-title-y-position"), "".concat(collapsedTitleYPosition, "rem"));
 
+          // 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"));
@@ -291,20 +266,13 @@ var SidePanel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
         }
       });
     }
-
     if (open && !animateTitle) {
       var _sidePanelOuter = document.querySelector("#".concat(blockClass, "-outer"));
-
       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;
@@ -313,59 +281,55 @@ var SidePanel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
       _sidePanelOuter === null || _sidePanelOuter === void 0 ? void 0 : _sidePanelOuter.style.setProperty("--".concat(blockClass, "--action-bar-container-height"), "".concat(sidePanelActionBarElementHeight, "px"));
       _sidePanelOuter === null || _sidePanelOuter === void 0 ? void 0 : _sidePanelOuter.style.setProperty("--".concat(blockClass, "--label-text-height"), "".concat(labelHeight, "px"));
     }
-  }, [open, animateTitle, animationComplete, panelHeight, title, size, reducedMotion.matches]); // click outside functionality if `includeOverlay` prop is set
+  }, [open, animateTitle, animationComplete, panelHeight, title, size, reducedMotion.matches]);
 
+  // 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) {
         onRequestClose();
       }
     };
-
     var bodyElement = document.body;
-
     if (includeOverlay && open) {
       bodyElement.style.overflow = 'hidden';
     } else if (includeOverlay && !open) {
       bodyElement.style.overflow = 'initial';
     }
-
     if (includeOverlay && !preventCloseOnClickOutside) {
       document.addEventListener('click', handleOutsideClick);
     }
-
     return function () {
       document.removeEventListener('click', handleOutsideClick);
     };
-  }, [includeOverlay, onRequestClose, open, preventCloseOnClickOutside, ref, onUnmount]); // initializes the side panel to close
+  }, [includeOverlay, onRequestClose, open, preventCloseOnClickOutside, ref, onUnmount]);
 
+  // initializes the side panel to close
   var onAnimationEnd = function onAnimationEnd() {
     if (!open) {
       onUnmount === null || onUnmount === void 0 ? void 0 : onUnmount();
     }
-
     setAnimationComplete(true);
-  }; // Set the internal state `animationComplete` to true if
-  // prefers reduced motion is true
-
+  };
 
+  // Set the internal state `animationComplete` to true if
+  // prefers reduced motion is true
   (0, _react.useEffect)(function () {
     if (reducedMotion.matches) {
       setAnimationComplete(true);
     }
-  }, [reducedMotion.matches]); // initializes the side panel to open
+  }, [reducedMotion.matches]);
 
+  // initializes the side panel to open
   var _onAnimationStart = function onAnimationStart() {
     setAnimationComplete(false);
-  }; // used to reset margins of the slide in panel when closed/closing
-
+  };
 
+  // used to reset margins of the slide in panel when closed/closing
   (0, _react.useEffect)(function () {
     if (!open && slideIn) {
       var pageContentElement = document.querySelector(selectorPageContent);
-
       if (placement && placement === 'right' && pageContentElement) {
         pageContentElement.style.marginRight = 0;
       } else if (pageContentElement) {
@@ -377,12 +341,12 @@ var SidePanel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
     if (!open && previousState !== null && previousState !== void 0 && previousState.open && reducedMotion.matches) {
       onUnmount === null || onUnmount === void 0 ? void 0 : onUnmount();
     }
-  }, [open, onUnmount, reducedMotion.matches, previousState === null || previousState === void 0 ? void 0 : previousState.open]); // used to set margins of content for slide in panel version
+  }, [open, onUnmount, reducedMotion.matches, previousState === null || previousState === void 0 ? void 0 : previousState.open]);
 
+  // used to set margins of content for slide in panel version
   (0, _react.useEffect)(function () {
     if (open && slideIn) {
       var pageContentElement = document.querySelector(selectorPageContent);
-
       if (placement && placement === 'right' && pageContentElement) {
         pageContentElement.style.marginRight = 0;
         pageContentElement.style.transition = !reducedMotion.matches ? "margin-right ".concat(_motion.moderate02) : null;
@@ -393,14 +357,13 @@ var SidePanel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
         pageContentElement.style.marginLeft = _constants.SIDE_PANEL_SIZES[size];
       }
     }
-  }, [slideIn, selectorPageContent, placement, size, reducedMotion.matches, open]); // adds focus trap functionality
+  }, [slideIn, selectorPageContent, placement, size, reducedMotion.matches, open]);
 
+  // adds focus trap functionality
   /* istanbul ignore next */
-
-  var handleBlur = function handleBlur(_ref2) {
-    var oldActiveNode = _ref2.target,
-        currentActiveNode = _ref2.relatedTarget;
-
+  var handleBlur = function handleBlur(_ref3) {
+    var oldActiveNode = _ref3.target,
+      currentActiveNode = _ref3.relatedTarget;
     // focus trap should only be set if the side panel is a `slideOver` type
     if (open && sidePanelInnerRef && !slideIn) {
       (0, _wrapFocus.default)({
@@ -412,13 +375,10 @@ var SidePanel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
       });
     }
   };
-
   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), (_ref4 = {}, (0, _defineProperty2.default)(_ref4, "".concat(blockClass, "__container-right-placement"), placement === 'right'), (0, _defineProperty2.default)(_ref4, "".concat(blockClass, "__container-left-placement"), placement === 'left'), (0, _defineProperty2.default)(_ref4, "".concat(blockClass, "__container-with-action-toolbar"), actionToolbarButtons && actionToolbarButtons.length), (0, _defineProperty2.default)(_ref4, "".concat(blockClass, "__container-without-overlay"), !includeOverlay && !slideIn), (0, _defineProperty2.default)(_ref4, "".concat(blockClass, "__container-is-animating"), !animationComplete || !open), _ref4)]);
-
+  var mainPanelClassNames = (0, _classnames.default)([blockClass, className, "".concat(blockClass, "__container"), "".concat(blockClass, "__container--").concat(size), (_ref5 = {}, (0, _defineProperty2.default)(_ref5, "".concat(blockClass, "__container-right-placement"), placement === 'right'), (0, _defineProperty2.default)(_ref5, "".concat(blockClass, "__container-left-placement"), placement === 'left'), (0, _defineProperty2.default)(_ref5, "".concat(blockClass, "__container-with-action-toolbar"), actionToolbarButtons && actionToolbarButtons.length), (0, _defineProperty2.default)(_ref5, "".concat(blockClass, "__container-without-overlay"), !includeOverlay && !slideIn), (0, _defineProperty2.default)(_ref5, "".concat(blockClass, "__container-is-animating"), !animationComplete || !open), _ref5)]);
   var renderHeader = function renderHeader() {
     var _cx, _cx2;
-
     return /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, /*#__PURE__*/_react.default.createElement("div", {
       className: (0, _classnames.default)("".concat(blockClass, "__title-container"), (_cx = {}, (0, _defineProperty2.default)(_cx, "".concat(blockClass, "__on-detail-step"), currentStep > 0), (0, _defineProperty2.default)(_cx, "".concat(blockClass, "__on-detail-step-without-title"), currentStep > 0 && !title), (0, _defineProperty2.default)(_cx, "".concat(blockClass, "__title-container--no-title-animation"), !animateTitle), (0, _defineProperty2.default)(_cx, "".concat(blockClass, "__title-container-is-animating"), !animationComplete || !open), (0, _defineProperty2.default)(_cx, "".concat(blockClass, "__title-container-without-title"), !title), (0, _defineProperty2.default)(_cx, "".concat(blockClass, "__title-container--reduced-motion"), reducedMotion.matches), _cx))
     }, currentStep > 0 && /*#__PURE__*/_react.default.createElement(_react2.Button, {
@@ -453,33 +413,32 @@ var SidePanel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
       className: (0, _classnames.default)("".concat(blockClass, "__subtitle-text"), (_cx2 = {}, (0, _defineProperty2.default)(_cx2, "".concat(blockClass, "__subtitle-text-no-animation"), !animateTitle), (0, _defineProperty2.default)(_cx2, "".concat(blockClass, "__subtitle-text-no-animation-no-action-toolbar"), !animateTitle && (!actionToolbarButtons || !actionToolbarButtons.length)), (0, _defineProperty2.default)(_cx2, "".concat(blockClass, "__subtitle-text-is-animating"), !animationComplete && animateTitle), (0, _defineProperty2.default)(_cx2, "".concat(blockClass, "__subtitle-without-title"), !title), _cx2))
     }, 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 (_ref5) {
-      var _ref6;
-
-      var label = _ref5.label,
-          kind = _ref5.kind,
-          icon = _ref5.icon,
-          leading = _ref5.leading,
-          disabled = _ref5.disabled,
-          className = _ref5.className,
-          onClick = _ref5.onClick,
-          rest = (0, _objectWithoutProperties2.default)(_ref5, _excluded2);
+    }, 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);
       return /*#__PURE__*/_react.default.createElement(_react2.Button, (0, _extends2.default)({}, rest, {
         key: label,
         kind: kind || 'ghost',
         size: "sm",
         renderIcon: icon,
         iconDescription: label,
-        tooltipPosition: "bottom",
-        tooltipAlignment: "center",
+        tooltipPosition: tooltipPosition || 'bottom',
+        tooltipAlignment: tooltipAlignment || 'start',
         hasIconOnly: !leading,
         disabled: disabled,
-        className: (0, _classnames.default)(["".concat(blockClass, "__action-toolbar-button"), className, (_ref6 = {}, (0, _defineProperty2.default)(_ref6, "".concat(blockClass, "__action-toolbar-icon-only-button"), icon && !leading), (0, _defineProperty2.default)(_ref6, "".concat(blockClass, "__action-toolbar-leading-button"), leading), _ref6)]),
+        className: (0, _classnames.default)(["".concat(blockClass, "__action-toolbar-button"), className, (0, _defineProperty2.default)({}, "".concat(blockClass, "__action-toolbar-leading-button"), leading)]),
         onClick: onClick
       }), 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"),
@@ -491,12 +450,9 @@ var SidePanel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
       "aria-hidden": true
     }, title));
   };
-
   var contentRef = ref || sidePanelRef;
-  (0, _reactResizeDetector.useResizeDetector)({
-    handleHeight: true,
-    onResize: handleResize,
-    targetRef: contentRef
+  (0, _useResizeObserver.useResizeObserver)(contentRef, {
+    callback: handleResize
   });
   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: "".concat(blockClass, "-outer"),
@@ -541,9 +497,9 @@ var SidePanel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
     ref: sidePanelOverlayRef,
     className: "".concat(blockClass, "__overlay")
   }))));
-}); // Return a placeholder if not released and not enabled by feature flag
-
+});
 
+// Return a placeholder if not released and not enabled by feature flag
 exports.SidePanel = SidePanel;
 exports.SidePanel = SidePanel = _settings.pkg.checkComponentEnabled(SidePanel, componentName);
 SidePanel.propTypes = {
@@ -555,14 +511,18 @@ SidePanel.propTypes = {
     leading: _propTypes.default.bool,
     icon: _propTypes.default.oneOfType([_propTypes.default.object, _propTypes.default.func]),
     onClick: _propTypes.default.func,
-    kind: _propTypes.default.oneOf(['ghost', 'tertiary', 'secondary', 'primary'])
+    kind: _propTypes.default.oneOf(['ghost', 'tertiary', 'secondary', 'primary']),
+    tooltipAlignment: _propTypes.default.oneOf(['top', 'right', 'bottom', 'left']),
+    tooltipPosition: _propTypes.default.oneOf(['start', 'center', 'end'])
   })),
-
   /**
    * The primary actions to be shown in the side panel. Each action is
    * specified as an object with optional fields: 'label' to supply the button
    * label, 'kind' to select the button kind (must be 'primary', 'secondary' or
-   * 'ghost'), 'loading' to display a loading indicator, and 'onClick' to
+   * 'ghost'), 'tooltipPosition' to select where the tooltip is placed around
+   * the button (must be 'top', 'right', 'bottom', or 'left'), 'tooltipAlignment'
+   * to select how the tooltip is aligned with the button (must be 'start',
+   * 'center', or 'end', 'loading' to display a loading indicator, and 'onClick' to
    * receive notifications when the button is clicked. Additional fields in the
    * object will be passed to the Button component, and these can include
    * 'disabled', 'ref', 'className', and any other Button props. Any other
@@ -573,124 +533,105 @@ SidePanel.propTypes = {
    */
   actions: (0, _propsHelper.allPropTypes)([_ActionSet.ActionSet.validateActions(), _propTypes.default.arrayOf(_propTypes.default.shape(_objectSpread(_objectSpread({}, _react2.Button.propTypes), {}, {
     kind: _propTypes.default.oneOf(['ghost', 'danger--ghost', 'secondary', 'danger', 'primary']),
+    tooltipPosition: _propTypes.default.oneOf(['top', 'right', 'bottom', 'left']),
+    tooltipAlignment: _propTypes.default.oneOf(['start', 'center', 'end']),
     label: _propTypes.default.string,
     loading: _propTypes.default.bool,
     // we duplicate this Button prop to improve the DocGen here
     onClick: _react2.Button.propTypes.onClick
   })))]),
-
   /**
    * Determines if the title will animate on scroll
    */
   animateTitle: _propTypes.default.bool,
-
   /**
    * Sets the body content of the side panel
    */
   children: _propTypes.default.oneOfType([_propTypes.default.arrayOf(_propTypes.default.node), _propTypes.default.node]).isRequired,
-
   /**
    * Sets an optional className to be added to the side panel outermost element
    */
   className: _propTypes.default.string,
-
   /**
    * Sets the close button icon description
    */
   closeIconDescription: _propTypes.default.string,
-
   /**
    * Determines whether the side panel should render the condensed version (affects action buttons primarily)
    */
   condensedActions: _propTypes.default.bool,
-
   /**
    * Sets the current step of the side panel
    */
   currentStep: _propTypes.default.number,
-
   /**
    * Determines whether the side panel should render with an overlay
    */
   includeOverlay: _propTypes.default.bool,
-
   /**
    * Sets the label text which will display above the title text
    */
   labelText: _propTypes.default.string,
-
   /**
    * Sets the icon description for the navigation back icon button
    */
   navigationBackIconDescription: _propTypes.default.string,
-
   /**
    * Changes the current side panel page to the previous page
    */
   onNavigationBack: _propTypes.default.func,
-
   /**
    * Specify a handler for closing the side panel.
    * This handler closes the modal, e.g. changing `open` prop.
    */
   onRequestClose: _propTypes.default.func,
-
   /**
    * Optional function called when the side panel exit animation is complete.
    * This handler can be used for any state cleanup needed before the panel is removed from the DOM.
    */
   onUnmount: _propTypes.default.func,
-
   /**
    * Determines whether the side panel should render or not
    */
   open: _propTypes.default.bool.isRequired,
-
   /**
    * Determines if the side panel is on the right or left
    */
   placement: _propTypes.default.oneOf(['left', 'right']),
-
   /**
    * Prevent closing on click outside of the panel
    */
   preventCloseOnClickOutside: _propTypes.default.bool,
-
   /**
    * 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 (_ref7) {
-    var slideIn = _ref7.slideIn;
+  selectorPageContent: _propTypes.default.string.isRequired.if(function (_ref8) {
+    var slideIn = _ref8.slideIn;
     return slideIn;
   }),
-
   /**
    * Specify a CSS selector that matches the DOM element that should
    * be focused when the side panel opens
    */
   selectorPrimaryFocus: _propTypes.default.string,
-
   /**
    * Sets the size of the side panel
    */
   size: _propTypes.default.oneOf(['xs', 'sm', 'md', 'lg', '2xl']),
-
   /**
    * Determines if this panel slides in
    */
   slideIn: _propTypes.default.bool,
-
   /**
    * Sets the subtitle text
    */
   subtitle: _propTypes.default.node,
-
   /**
    * Sets the title text
    */
-  title: _propTypes.default.string.isRequired.if(function (_ref8) {
-    var labelText = _ref8.labelText;
+  title: _propTypes.default.string.isRequired.if(function (_ref9) {
+    var labelText = _ref9.labelText;
     return labelText;
   })
 };