@carbon/ibm-products 2.0.0 → 2.1.0

package/es/components/SidePanel/SidePanel.js

@@ -0,0 +1,630 @@
+import _extends from "@babel/runtime/helpers/extends";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
+var _excluded = ["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", "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, 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';
+import { motion, AnimatePresence } from 'framer-motion';
+
+// Other standard imports.
+import PropTypes from 'prop-types';
+import cx from 'classnames';
+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 { 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 defaults = {
+  animateTitle: true,
+  closeIconDescription: 'Close',
+  currentStep: 0,
+  navigationBackIconDescription: 'Back',
+  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, _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(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();
+  var endTrapRef = useRef();
+  var sidePanelInnerRef = useRef();
+  var sidePanelCloseRef = useRef();
+  var previousState = usePreviousValue({
+    size: size,
+    open: open
+  });
+  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
+  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
+      // 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
+  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$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.
+  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(_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
+  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"));
+      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');
+          }
+
+          // 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
+          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(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;
+      _sidePanelOuter === null || _sidePanelOuter === void 0 ? void 0 : _sidePanelOuter.style.setProperty("--".concat(blockClass, "--title-text-height"), "".concat(titleHeight, "px"));
+      _sidePanelOuter === null || _sidePanelOuter === void 0 ? void 0 : _sidePanelOuter.style.setProperty("--".concat(blockClass, "--subtitle-container-height"), "".concat(_sidePanelSubtitleElementHeight, "px"));
+      _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
+  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
+  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
+  useEffect(function () {
+    if (reducedMotion.matches) {
+      setAnimationComplete(true);
+    }
+  }, [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) {
+        pageContentElement.style.marginLeft = 0;
+      }
+    }
+  }, [open, placement, selectorPageContent, slideIn]);
+  useEffect(function () {
+    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
+  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(moderate02) : null;
+        pageContentElement.style.marginRight = SIDE_PANEL_SIZES[size];
+      } else if (pageContentElement) {
+        pageContentElement.style.marginLeft = 0;
+        pageContentElement.style.transition = !reducedMotion.matches ? "margin-left ".concat(moderate02) : null;
+        pageContentElement.style.marginLeft = SIDE_PANEL_SIZES[size];
+      }
+    }
+  }, [slideIn, selectorPageContent, placement, size, reducedMotion.matches, open]);
+
+  // adds focus trap functionality
+  /* istanbul ignore next */
+  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({
+        bodyNode: sidePanelInnerRef.current,
+        startTrapRef: startTrapRef,
+        endTrapRef: endTrapRef,
+        currentActiveNode: currentActiveNode,
+        oldActiveNode: oldActiveNode
+      });
+    }
+  };
+  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), (_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, {
+      "aria-label": navigationBackIconDescription,
+      kind: "ghost",
+      size: "sm",
+      disabled: false,
+      renderIcon: function renderIcon(props) {
+        return /*#__PURE__*/React.createElement(ArrowLeft, _extends({
+          size: 20
+        }, props));
+      },
+      iconDescription: navigationBackIconDescription,
+      className: "".concat(blockClass, "__navigation-back-button"),
+      onClick: onNavigationBack
+    }), title && title.length && labelText && labelText.length && /*#__PURE__*/React.createElement("p", {
+      className: "".concat(blockClass, "__label-text")
+    }, labelText), title && title.length && renderTitle()), /*#__PURE__*/React.createElement(Button, {
+      "aria-label": closeIconDescription,
+      kind: "ghost",
+      size: "sm",
+      renderIcon: function renderIcon(props) {
+        return /*#__PURE__*/React.createElement(Close, _extends({
+          size: 20
+        }, props));
+      },
+      iconDescription: closeIconDescription,
+      className: "".concat(blockClass, "__close-button"),
+      onClick: onRequestClose,
+      ref: sidePanelCloseRef
+    }), subtitle && /*#__PURE__*/React.createElement("p", {
+      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 (_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: tooltipPosition || 'bottom',
+        tooltipAlignment: tooltipAlignment || 'start',
+        hasIconOnly: !leading,
+        disabled: disabled,
+        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"),
+      title: title,
+      "aria-hidden": false
+    }, title), animateTitle && title && title.length && !reducedMotion.matches && /*#__PURE__*/React.createElement("h2", {
+      className: "".concat(blockClass, "__collapsed-title-text"),
+      title: title,
+      "aria-hidden": true
+    }, title));
+  };
+  var contentRef = ref || sidePanelRef;
+  useResizeObserver(contentRef, {
+    callback: handleResize
+  });
+  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,
+    onBlur: handleBlur,
+    ref: contentRef,
+    role: "complementary",
+    "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",
+    role: "link",
+    className: "".concat(blockClass, "__visually-hidden")
+  }, "Focus sentinel"), !animateTitle && renderHeader(), /*#__PURE__*/React.createElement("div", {
+    ref: sidePanelInnerRef,
+    className: cx("".concat(blockClass, "__inner-content"), (_cx4 = {}, _defineProperty(_cx4, "".concat(blockClass, "__static-inner-content"), !animateTitle), _defineProperty(_cx4, "".concat(blockClass, "__static-inner-content-no-actions"), !animateTitle && !(actions !== null && actions !== void 0 && actions.length)), _defineProperty(_cx4, "".concat(blockClass, "__inner-content-with-actions"), actions && actions.length), _cx4))
+  }, animateTitle && renderHeader(), /*#__PURE__*/React.createElement("div", {
+    className: "".concat(blockClass, "__body-content")
+  }, children), /*#__PURE__*/React.createElement(ActionSet, {
+    actions: actions,
+    className: primaryActionContainerClassNames,
+    size: size === 'xs' ? 'sm' : size
+  })), /*#__PURE__*/React.createElement("span", {
+    ref: endTrapRef,
+    tabIndex: "0",
+    role: "link",
+    className: "".concat(blockClass, "__visually-hidden")
+  }, "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")
+  }))));
+});
+
+// Return a placeholder if not released and not enabled by feature flag
+SidePanel = pkg.checkComponentEnabled(SidePanel, componentName);
+SidePanel.propTypes = {
+  /**
+   * Sets the action toolbar buttons
+   */
+  actionToolbarButtons: PropTypes.arrayOf(PropTypes.shape({
+    label: PropTypes.string,
+    leading: PropTypes.bool,
+    icon: PropTypes.oneOfType([PropTypes.object, PropTypes.func]),
+    onClick: PropTypes.func,
+    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'), '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
+   * fields in the object will be passed through to the button element as HTML
+   * attributes.
+   *
+   * See https://react.carbondesignsystem.com/?path=/docs/components-button--default#component-api
+   */
+  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 (_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 (_ref9) {
+    var labelText = _ref9.labelText;
+    return labelText;
+  })
+};
+SidePanel.displayName = componentName;

package/es/components/SidePanel/constants.js

@@ -0,0 +1,14 @@
+/**
+ * Copyright IBM Corp. 2020, 2021
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+export var SIDE_PANEL_SIZES = {
+  xs: '16rem',
+  sm: '20rem',
+  md: '30rem',
+  lg: '40rem',
+  max: '75%'
+};

package/es/components/SidePanel/index.js

@@ -0,0 +1,8 @@
+/**
+ * Copyright IBM Corp. 2020, 2021
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+export { SidePanel } from './SidePanel';