@carbon/ibm-products 2.0.0-rc.3 → 2.0.0-rc.32

package/es/components/SidePanel/SidePanel.js

@@ -3,39 +3,43 @@ import _defineProperty from "@babel/runtime/helpers/defineProperty";
 import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
 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"];
 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) { _defineProperty(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; }
-
 /**
- * Copyright IBM Corp. 2020, 2021
+ * 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.
-import React, { useState, useEffect, useRef } from 'react'; // Other standard imports.
+import React, { useState, useEffect, useRef } from 'react';
+import { motion, AnimatePresence } from 'framer-motion';
 
+// Other standard imports.
 import PropTypes from 'prop-types';
 import cx from 'classnames';
-import { useResizeDetector } from 'react-resize-detector';
+import { useResizeObserver } from '../../global/js/hooks/useResizeObserver';
 import { moderate02 } from '@carbon/motion';
 import { getDevtoolsProps } from '../../global/js/utils/devtools';
 import { allPropTypes } from '../../global/js/utils/props-helper';
 import wrapFocus from '../../global/js/utils/wrapFocus';
 import { pkg } from '../../settings';
 import { SIDE_PANEL_SIZES } from './constants';
-import { usePreviousValue } from '../../global/js/hooks'; // Carbon and package components we use.
+import { usePreviousValue } from '../../global/js/hooks';
 
+// Carbon and package components we use.
 import { Button } from '@carbon/react';
 import { Close, ArrowLeft } from '@carbon/react/icons';
 import { ActionSet } from '../ActionSet';
+import { overlayVariants, panelVariants } from './motion/variants';
 var blockClass = "".concat(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',
@@ -44,59 +48,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.
  */
-
 export var SidePanel = /*#__PURE__*/React.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 = _objectWithoutProperties(_ref, _excluded);
-
-  var _useState = useState(open),
-      _useState2 = _slicedToArray(_useState, 2),
-      shouldRender = _useState2[0],
-      setRender = _useState2[1];
-
-  var _useState3 = useState(false),
-      _useState4 = _slicedToArray(_useState3, 2),
-      animationComplete = _useState4[0],
-      setAnimationComplete = _useState4[1];
-
-  var _useState5 = useState(0),
-      _useState6 = _slicedToArray(_useState5, 2),
-      panelHeight = _useState6[0],
-      setPanelHeight = _useState6[1];
-
+    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 = _objectWithoutProperties(_ref, _excluded);
+  var _useState = useState(false),
+    _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 startTrapRef = useRef();
@@ -109,88 +104,86 @@ export var SidePanel = /*#__PURE__*/React.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
   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.style.setProperty("--".concat(blockClass, "--title-container-height"), "".concat(Number(initialTitleHeight), "px"));
+        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
   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);
     }
   }, [selectorPrimaryFocus, open, animationComplete]);
   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.style.setProperty("--".concat(blockClass, "--content-bottom-padding"), actionsHeight);
+      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.
   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.offsetHeight + 16; // add additional 1rem spacing to bottom padding
-
+    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.style.setProperty("--".concat(blockClass, "--content-bottom-padding"), actionsHeight);
+    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
   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"));
@@ -202,50 +195,54 @@ export var SidePanel = /*#__PURE__*/React.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"));
@@ -262,20 +259,13 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
         }
       });
     }
-
-    if (open && shouldRender && !animateTitle) {
+    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;
@@ -284,71 +274,55 @@ export var SidePanel = /*#__PURE__*/React.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, shouldRender, 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
   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]); // initialize the side panel to open
-
-  useEffect(function () {
-    if (open) {
-      setRender(true);
-    }
-  }, [open]); // 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();
-      setRender(false);
     }
-
     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
   useEffect(function () {
     if (reducedMotion.matches) {
       setAnimationComplete(true);
     }
-  }, [reducedMotion.matches]); // initializes the side panel to open
-
-  var _onAnimationStart = function onAnimationStart(event) {
-    event.persist();
-    var isPanelTarget = event.target.id === "".concat(blockClass, "-outer");
-
-    if (isPanelTarget) {
-      setAnimationComplete(false);
-    }
-  }; // used to reset margins of the slide in panel when closed/closing
+  }, [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
   useEffect(function () {
     if (!open && slideIn) {
       var pageContentElement = document.querySelector(selectorPageContent);
-
       if (placement && placement === 'right' && pageContentElement) {
         pageContentElement.style.marginRight = 0;
       } else if (pageContentElement) {
@@ -358,15 +332,14 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   }, [open, placement, selectorPageContent, slideIn]);
   useEffect(function () {
     if (!open && previousState !== null && previousState !== void 0 && previousState.open && reducedMotion.matches) {
-      setRender(false);
       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
   useEffect(function () {
-    if (shouldRender && slideIn) {
+    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(moderate02) : null;
@@ -377,14 +350,13 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
         pageContentElement.style.marginLeft = SIDE_PANEL_SIZES[size];
       }
     }
-  }, [slideIn, selectorPageContent, placement, shouldRender, size, reducedMotion.matches]); // 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) {
       wrapFocus({
@@ -396,13 +368,10 @@ 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), (_ref4 = {}, _defineProperty(_ref4, "".concat(blockClass, "__container-right-placement"), placement === 'right'), _defineProperty(_ref4, "".concat(blockClass, "__container-left-placement"), placement === 'left'), _defineProperty(_ref4, "".concat(blockClass, "__container-with-action-toolbar"), actionToolbarButtons && actionToolbarButtons.length), _defineProperty(_ref4, "".concat(blockClass, "__container-without-overlay"), !includeOverlay && !slideIn), _defineProperty(_ref4, "".concat(blockClass, "__container-is-animating"), !animationComplete || !open), _ref4)]);
-
+  var mainPanelClassNames = cx([blockClass, className, "".concat(blockClass, "__container"), "".concat(blockClass, "__container--").concat(size), (_ref5 = {}, _defineProperty(_ref5, "".concat(blockClass, "__container-right-placement"), placement === 'right'), _defineProperty(_ref5, "".concat(blockClass, "__container-left-placement"), placement === 'left'), _defineProperty(_ref5, "".concat(blockClass, "__container-with-action-toolbar"), actionToolbarButtons && actionToolbarButtons.length), _defineProperty(_ref5, "".concat(blockClass, "__container-without-overlay"), !includeOverlay && !slideIn), _defineProperty(_ref5, "".concat(blockClass, "__container-is-animating"), !animationComplete || !open), _ref5)]);
   var renderHeader = function renderHeader() {
     var _cx, _cx2;
-
     return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("div", {
       className: cx("".concat(blockClass, "__title-container"), (_cx = {}, _defineProperty(_cx, "".concat(blockClass, "__on-detail-step"), currentStep > 0), _defineProperty(_cx, "".concat(blockClass, "__on-detail-step-without-title"), currentStep > 0 && !title), _defineProperty(_cx, "".concat(blockClass, "__title-container--no-title-animation"), !animateTitle), _defineProperty(_cx, "".concat(blockClass, "__title-container-is-animating"), !animationComplete || !open), _defineProperty(_cx, "".concat(blockClass, "__title-container-without-title"), !title), _defineProperty(_cx, "".concat(blockClass, "__title-container--reduced-motion"), reducedMotion.matches), _cx))
     }, currentStep > 0 && /*#__PURE__*/React.createElement(Button, {
@@ -437,34 +406,32 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       className: cx("".concat(blockClass, "__subtitle-text"), (_cx2 = {}, _defineProperty(_cx2, "".concat(blockClass, "__subtitle-text-no-animation"), !animateTitle), _defineProperty(_cx2, "".concat(blockClass, "__subtitle-text-no-animation-no-action-toolbar"), !animateTitle && (!actionToolbarButtons || !actionToolbarButtons.length)), _defineProperty(_cx2, "".concat(blockClass, "__subtitle-text-is-animating"), !animationComplete && animateTitle), _defineProperty(_cx2, "".concat(blockClass, "__subtitle-without-title"), !title), _cx2))
     }, 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 (_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 = _objectWithoutProperties(_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 = _objectWithoutProperties(_ref6, _excluded2);
       return /*#__PURE__*/React.createElement(Button, _extends({}, 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: cx(["".concat(blockClass, "__action-toolbar-button"), className, (_ref6 = {}, _defineProperty(_ref6, "".concat(blockClass, "__action-toolbar-icon-only-button"), icon && !leading), _defineProperty(_ref6, "".concat(blockClass, "__action-toolbar-leading-button"), leading), _ref6)]),
+        className: cx(["".concat(blockClass, "__action-toolbar-button"), className, _defineProperty({}, "".concat(blockClass, "__action-toolbar-leading-button"), leading)]),
         onClick: onClick
       }), 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"),
@@ -476,27 +443,26 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       "aria-hidden": true
     }, title));
   };
-
   var contentRef = ref || sidePanelRef;
-  useResizeDetector({
-    handleHeight: true,
-    onResize: handleResize,
-    targetRef: contentRef
+  useResizeObserver(contentRef, {
+    callback: handleResize
   });
-  return shouldRender && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("div", _extends({}, getDevtoolsProps(componentName), rest, {
+  return /*#__PURE__*/React.createElement(AnimatePresence, null, open && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(motion.div, _extends({}, getDevtoolsProps(componentName), rest, {
     id: "".concat(blockClass, "-outer"),
     className: mainPanelClassNames,
-    style: {
-      animation: !reducedMotion.matches ? "".concat(open ? placement === 'right' ? "side-panel-entrance-right ".concat(moderate02) : "side-panel-entrance-left ".concat(moderate02) : placement === 'right' ? "side-panel-exit-right ".concat(moderate02) : "side-panel-exit-left ".concat(moderate02)) : null
-    },
-    onAnimationEnd: onAnimationEnd,
-    onAnimationStart: function onAnimationStart(event) {
-      return _onAnimationStart(event);
-    },
     onBlur: handleBlur,
     ref: contentRef,
     role: "complementary",
-    "aria-label": title
+    "aria-label": title,
+    onAnimationComplete: onAnimationEnd,
+    onAnimationStart: function onAnimationStart(event) {
+      return _onAnimationStart(event);
+    },
+    variants: panelVariants,
+    initial: "hidden",
+    animate: "visible",
+    exit: "exit",
+    custom: placement
   }), /*#__PURE__*/React.createElement("span", {
     ref: startTrapRef,
     tabIndex: "0",
@@ -516,15 +482,17 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     tabIndex: "0",
     role: "link",
     className: "".concat(blockClass, "__visually-hidden")
-  }, "Focus sentinel")), includeOverlay && /*#__PURE__*/React.createElement("div", {
+  }, "Focus sentinel")), /*#__PURE__*/React.createElement(AnimatePresence, null, includeOverlay && /*#__PURE__*/React.createElement(motion.div, {
+    variants: overlayVariants,
+    initial: "hidden",
+    animate: "visible",
+    exit: "exit",
     ref: sidePanelOverlayRef,
-    className: "".concat(blockClass, "__overlay"),
-    style: {
-      animation: !reducedMotion.matches ? "".concat(open ? "side-panel-overlay-entrance ".concat(moderate02) : "side-panel-overlay-exit ".concat(moderate02)) : null
-    }
-  }));
-}); // Return a placeholder if not released and not enabled by feature flag
+    className: "".concat(blockClass, "__overlay")
+  }))));
+});
 
+// Return a placeholder if not released and not enabled by feature flag
 SidePanel = pkg.checkComponentEnabled(SidePanel, componentName);
 SidePanel.propTypes = {
   /**
@@ -535,14 +503,18 @@ SidePanel.propTypes = {
     leading: PropTypes.bool,
     icon: PropTypes.oneOfType([PropTypes.object, PropTypes.func]),
     onClick: PropTypes.func,
-    kind: PropTypes.oneOf(['ghost', 'tertiary', 'secondary', 'primary'])
+    kind: PropTypes.oneOf(['ghost', 'tertiary', 'secondary', 'primary']),
+    tooltipAlignment: PropTypes.oneOf(['top', 'right', 'bottom', 'left']),
+    tooltipPosition: PropTypes.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
@@ -553,124 +525,105 @@ SidePanel.propTypes = {
    */
   actions: allPropTypes([ActionSet.validateActions(), PropTypes.arrayOf(PropTypes.shape(_objectSpread(_objectSpread({}, Button.propTypes), {}, {
     kind: PropTypes.oneOf(['ghost', 'danger--ghost', 'secondary', 'danger', 'primary']),
+    tooltipPosition: PropTypes.oneOf(['top', 'right', 'bottom', 'left']),
+    tooltipAlignment: PropTypes.oneOf(['start', 'center', 'end']),
     label: PropTypes.string,
     loading: PropTypes.bool,
     // we duplicate this Button prop to improve the DocGen here
     onClick: Button.propTypes.onClick
   })))]),
-
   /**
    * Determines if the title will animate on scroll
    */
   animateTitle: PropTypes.bool,
-
   /**
    * Sets the body content of the side panel
    */
   children: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.node), PropTypes.node]).isRequired,
-
   /**
    * Sets an optional className to be added to the side panel outermost element
    */
   className: PropTypes.string,
-
   /**
    * Sets the close button icon description
    */
   closeIconDescription: PropTypes.string,
-
   /**
    * Determines whether the side panel should render the condensed version (affects action buttons primarily)
    */
   condensedActions: PropTypes.bool,
-
   /**
    * Sets the current step of the side panel
    */
   currentStep: PropTypes.number,
-
   /**
    * Determines whether the side panel should render with an overlay
    */
   includeOverlay: PropTypes.bool,
-
   /**
    * Sets the label text which will display above the title text
    */
   labelText: PropTypes.string,
-
   /**
    * Sets the icon description for the navigation back icon button
    */
   navigationBackIconDescription: PropTypes.string,
-
   /**
    * Changes the current side panel page to the previous page
    */
   onNavigationBack: PropTypes.func,
-
   /**
    * Specify a handler for closing the side panel.
    * This handler closes the modal, e.g. changing `open` prop.
    */
   onRequestClose: PropTypes.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.func,
-
   /**
    * Determines whether the side panel should render or not
    */
   open: PropTypes.bool.isRequired,
-
   /**
    * Determines if the side panel is on the right or left
    */
   placement: PropTypes.oneOf(['left', 'right']),
-
   /**
    * Prevent closing on click outside of the panel
    */
   preventCloseOnClickOutside: PropTypes.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.string.isRequired.if(function (_ref7) {
-    var slideIn = _ref7.slideIn;
+  selectorPageContent: PropTypes.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.string,
-
   /**
    * Sets the size of the side panel
    */
   size: PropTypes.oneOf(['xs', 'sm', 'md', 'lg', '2xl']),
-
   /**
    * Determines if this panel slides in
    */
   slideIn: PropTypes.bool,
-
   /**
    * Sets the subtitle text
    */
   subtitle: PropTypes.node,
-
   /**
    * Sets the title text
    */
-  title: PropTypes.string.isRequired.if(function (_ref8) {
-    var labelText = _ref8.labelText;
+  title: PropTypes.string.isRequired.if(function (_ref9) {
+    var labelText = _ref9.labelText;
     return labelText;
   })
 };