@carbon/ibm-products 2.26.0 → 2.27.0

package/es/components/Datagrid/Datagrid/addons/Filtering/FilterProvider.js

@@ -6,9 +6,9 @@
  */
 
 import { slicedToArray as _slicedToArray, objectSpread2 as _objectSpread2, toConsumableArray as _toConsumableArray } from '../../../../../_virtual/_rollupPluginBabelHelpers.js';
-import React__default, { createContext, useState } from 'react';
+import React__default, { createContext, useState, useReducer } from 'react';
 import PropTypes from '../../../../../node_modules/prop-types/index.js';
-import { DROPDOWN, RADIO, NUMBER, DATE, CHECKBOX, CLEAR_SINGLE_FILTER } from './constants.js';
+import { DROPDOWN, RADIO, NUMBER, DATE, CHECKBOX, SAVED_FILTERS, CLEAR_SINGLE_FILTER } from './constants.js';
 
 var FilterContext = /*#__PURE__*/createContext();
 var EventEmitter = {
@@ -139,22 +139,45 @@ var prepareFiltersForTags = function prepareFiltersForTags(filters, renderDateLa
   });
   return tags;
 };
-var FilterProvider = function FilterProvider(_ref3) {
-  var children = _ref3.children,
-    filters = _ref3.filters,
-    filterProps = _ref3.filterProps;
-  var _ref4 = filterProps || {},
-    renderDateLabel = _ref4.renderDateLabel;
+var filteringReducer = function filteringReducer(state, action) {
+  switch (action.type) {
+    case SAVED_FILTERS:
+      {
+        var _ref3 = action.payload || {},
+          savedFilters = _ref3.savedFilters;
+        return _objectSpread2(_objectSpread2({}, state), {}, {
+          savedFilters: savedFilters
+        });
+      }
+    default:
+      return state;
+  }
+};
+var FilterProvider = function FilterProvider(_ref4) {
+  var children = _ref4.children,
+    filters = _ref4.filters,
+    filterProps = _ref4.filterProps;
+  var _ref5 = filterProps || {},
+    renderDateLabel = _ref5.renderDateLabel;
   var filterTags = prepareFiltersForTags(filters, renderDateLabel);
   var _useState = useState(false),
     _useState2 = _slicedToArray(_useState, 2),
     panelOpen = _useState2[0],
     setPanelOpen = _useState2[1];
+  var initialState = {
+    savedFilters: []
+  };
+  var _useReducer = useReducer(filteringReducer, initialState),
+    _useReducer2 = _slicedToArray(_useReducer, 2),
+    state = _useReducer2[0],
+    dispatch = _useReducer2[1];
   var value = {
     filterTags: filterTags,
     EventEmitter: EventEmitter,
     panelOpen: panelOpen,
-    setPanelOpen: setPanelOpen
+    setPanelOpen: setPanelOpen,
+    state: state,
+    dispatch: dispatch
   };
   return /*#__PURE__*/React__default.createElement(FilterContext.Provider, {
     value: value

package/es/components/Datagrid/Datagrid/addons/Filtering/constants.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2022, 2022
+ * Copyright IBM Corp. 2022, 2024
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
@@ -22,3 +22,5 @@ export const CLEAR_SINGLE_FILTER: "clearSingleFilter";
 /** Constants for panel dimensions */
 export const PANEL_WIDTH: 320;
 export const ACTION_SET_HEIGHT: 64;
+/** Constants for local reducer */
+export const SAVED_FILTERS: "savedFilters";

package/es/components/Datagrid/Datagrid/addons/Filtering/constants.js

@@ -28,4 +28,7 @@ var CLEAR_SINGLE_FILTER = 'clearSingleFilter';
 var PANEL_WIDTH = 320;
 var ACTION_SET_HEIGHT = 64;
 
-export { ACTION_SET_HEIGHT, BATCH, CHECKBOX, CLEAR_FILTERS, CLEAR_SINGLE_FILTER, DATE, DROPDOWN, FLYOUT, INSTANT, NUMBER, PANEL, PANEL_WIDTH, RADIO };
+/** Constants for local reducer */
+var SAVED_FILTERS = 'savedFilters';
+
+export { ACTION_SET_HEIGHT, BATCH, CHECKBOX, CLEAR_FILTERS, CLEAR_SINGLE_FILTER, DATE, DROPDOWN, FLYOUT, INSTANT, NUMBER, PANEL, PANEL_WIDTH, RADIO, SAVED_FILTERS };

package/es/components/Datagrid/Datagrid/addons/Filtering/hooks/useFilters.js

@@ -6,11 +6,12 @@
  */
 
 import { slicedToArray as _slicedToArray, extends as _extends, toConsumableArray as _toConsumableArray, objectSpread2 as _objectSpread2, defineProperty as _defineProperty } from '../../../../../../_virtual/_rollupPluginBabelHelpers.js';
-import { DROPDOWN, RADIO, CHECKBOX, NUMBER, DATE, BATCH, INSTANT, PANEL } from '../constants.js';
+import { DROPDOWN, RADIO, CHECKBOX, NUMBER, DATE, BATCH, SAVED_FILTERS, INSTANT, PANEL } from '../constants.js';
 import { Dropdown, FormGroup, RadioButtonGroup, RadioButton, NumberInput, DatePicker, DatePickerInput, Layer, Checkbox } from '@carbon/react';
-import React__default, { useState, useRef, useCallback, useEffect } from 'react';
+import React__default, { useContext, useState, useRef, useCallback, useEffect } from 'react';
 import OverflowCheckboxes from '../OverflowCheckboxes.js';
 import { getInitialStateFromFilters } from '../utils.js';
+import { FilterContext } from '../FilterProvider.js';
 import { handleCheckboxChange } from '../handleCheckboxChange.js';
 import { usePreviousValue } from '../../../../../../global/js/hooks/usePreviousValue.js';
 
@@ -25,6 +26,10 @@ var useFilters = function useFilters(_ref) {
     panelOpen = _ref.panelOpen,
     autoHideFilters = _ref.autoHideFilters,
     isFetching = _ref.isFetching;
+  var _useContext = useContext(FilterContext),
+    state = _useContext.state,
+    localDispatch = _useContext.dispatch;
+  var savedFilters = state.savedFilters;
   /** State */
   var _useState = useState(getInitialStateFromFilters(filters, variation, reactTableFiltersState)),
     _useState2 = _slicedToArray(_useState, 2),
@@ -122,6 +127,16 @@ var useFilters = function useFilters(_ref) {
       filterCopy.splice(index, 1);
     }
     setFiltersObjectArray(filterCopy);
+
+    // Dispatch action from local filter context to track filters in order
+    // to keep history if `isFetching` becomes true. If so, react-table
+    // clears all filter history
+    localDispatch({
+      type: SAVED_FILTERS,
+      payload: {
+        savedFilters: filterCopy
+      }
+    });
     if (updateMethod === INSTANT) {
       setAllFilters(filterCopy);
     }
@@ -312,10 +327,27 @@ var useFilters = function useFilters(_ref) {
       setAllFilters(JSON.parse(prevFiltersObjectArrayRef.current));
       setFetchingReset(true);
     }
+    if (isFetching && fetchingReset) {
+      var cleanFilters = function cleanFilters(originalFilterState) {
+        var copy = _objectSpread2({}, originalFilterState);
+        var updatedFilters = savedFilters.map(function (f) {
+          if (Object.hasOwn(copy, f.id)) {
+            copy[f.id] = f;
+            return copy;
+          }
+          return copy;
+        });
+        return updatedFilters[0];
+      };
+      setFiltersObjectArray(savedFilters);
+      var filterStateCopy = cleanFilters(filtersState);
+      setFiltersState(filterStateCopy);
+    }
     if (!isFetching) {
       setFetchingReset(false);
     }
-  }, [isFetching, reactTableFiltersState, setAllFilters, fetchingReset]);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [isFetching, reactTableFiltersState, setAllFilters, fetchingReset, savedFilters, filtersObjectArray]);
   var cancel = function cancel() {
     // Reverting to previous filters only applies when using batch actions
     if (updateMethod === BATCH) {

package/es/components/Datagrid/Datagrid/addons/stateReducer.js

@@ -116,7 +116,7 @@ var stateReducer = function stateReducer(newState, action) {
           var dataWithRemovedRow = Object.fromEntries(Object.entries(newData).filter(function (_ref5) {
             var _ref6 = _slicedToArray(_ref5, 1),
               key = _ref6[0];
-            return parseInt(key) !== parseInt(rowData.index);
+            return parseInt(key) !== parseInt(_getRowId(rowData.original, rowData.index));
           }));
           return _objectSpread2(_objectSpread2({}, newState), {}, {
             selectedRowData: dataWithRemovedRow

package/es/components/Datagrid/useSelectAllToggle.js

@@ -6,11 +6,12 @@
  */
 
 import { slicedToArray as _slicedToArray, defineProperty as _defineProperty } from '../../_virtual/_rollupPluginBabelHelpers.js';
-import React__default, { useState, useLayoutEffect } from 'react';
+import React__default, { useState } from 'react';
 import cx from '../../node_modules/classnames/index.js';
 import { selectionColumnId } from './common-column-ids.js';
 import SelectAllWithToggle from './Datagrid/DatagridSelectAllWithToggle.js';
 import { pkg } from '../../settings.js';
+import { useIsomorphicEffect } from '../../global/js/hooks/useIsomorphicEffect.js';
 
 var blockClass = "".concat(pkg.prefix, "--datagrid__select-all");
 var useSelectAllToggle = function useSelectAllToggle(hooks) {
@@ -36,11 +37,12 @@ var useSelectAllWithToggleComponent = function useSelectAllWithToggleComponent(h
   hooks.useInstance.push(useInstance);
 };
 var useAddClassNameToSelectRow = function useAddClassNameToSelectRow(hooks) {
-  var _useState = useState(typeof window !== 'undefined' ? window.innerWidth : ''),
+  var _useState = useState(0),
     _useState2 = _slicedToArray(_useState, 2),
     windowSize = _useState2[0],
     setWindowSize = _useState2[1];
-  useLayoutEffect(function () {
+  useIsomorphicEffect(function () {
+    setWindowSize(window.innerWidth);
     function updateSize() {
       setWindowSize(window.innerWidth);
     }

package/es/components/SidePanel/SidePanel.js

@@ -7,7 +7,7 @@
 
 import { objectWithoutProperties as _objectWithoutProperties, slicedToArray as _slicedToArray, defineProperty as _defineProperty, extends as _extends, objectSpread2 as _objectSpread2 } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import React__default, { useState, useRef, useEffect, useCallback } from 'react';
-import { AnimatePresence, motion } from 'framer-motion';
+import { motion, useReducedMotion, AnimatePresence } from 'framer-motion';
 import PropTypes from '../../node_modules/prop-types/index.js';
 import cx from '../../node_modules/classnames/index.js';
 import { useResizeObserver } from '../../global/js/hooks/useResizeObserver.js';
@@ -19,10 +19,10 @@ import { pkg } from '../../settings.js';
 import { SIDE_PANEL_SIZES } from './constants.js';
 import { Button } from '@carbon/react';
 import { ArrowLeft, Close } from '@carbon/react/icons';
-import { overlayVariants, panelVariants } from './motion/variants.js';
+import { actionSetVariants, overlayVariants, panelVariants } from './motion/variants.js';
 import pconsole from '../../global/js/utils/pconsole.js';
-import { usePreviousValue } from '../../global/js/hooks/usePreviousValue.js';
 import { ActionSet } from '../ActionSet/ActionSet.js';
+import { usePreviousValue } from '../../global/js/hooks/usePreviousValue.js';
 
 var _excluded = ["actionToolbarButtons", "actions", "animateTitle", "children", "className", "closeIconDescription", "condensedActions", "currentStep", "id", "includeOverlay", "labelText", "navigationBackIconDescription", "onNavigationBack", "onRequestClose", "onUnmount", "open", "placement", "preventCloseOnClickOutside", "selectorPageContent", "selectorPrimaryFocus", "size", "slideIn", "slug", "subtitle", "title"],
   _excluded2 = ["label", "kind", "icon", "tooltipPosition", "tooltipAlignment", "leading", "disabled", "className", "onClick"];
@@ -40,6 +40,7 @@ var defaults = {
   placement: 'right',
   size: 'md'
 };
+var MotionActionSet = motion(ActionSet);
 
 /**
  * Side panels keep users in-context of a page while performing tasks like navigating, editing, viewing details, or configuring something new.
@@ -107,6 +108,7 @@ var SidePanel = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
     _useState6 = _slicedToArray(_useState5, 2),
     doAnimateTitle = _useState6[0],
     setDoAnimateTitle = _useState6[1];
+  var shouldReduceMotion = useReducedMotion();
   useEffect(function () {
     setDoAnimateTitle(animateTitle);
   }, [animateTitle]);
@@ -429,7 +431,10 @@ var SidePanel = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
     initial: "hidden",
     animate: "visible",
     exit: "exit",
-    custom: placement
+    custom: {
+      placement: placement,
+      shouldReduceMotion: shouldReduceMotion
+    }
   }), /*#__PURE__*/React__default.createElement("span", {
     ref: startTrapRef,
     tabIndex: "0",
@@ -438,10 +443,12 @@ var SidePanel = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
   }, "Focus sentinel"), doAnimateTitle ? /*#__PURE__*/React__default.createElement("div", {
     ref: animatedScrollRef,
     className: "".concat(blockClass, "__animated-scroll-wrapper ").concat(blockClass, "--scrolls")
-  }, renderHeader(), renderMain()) : /*#__PURE__*/React__default.createElement(React__default.Fragment, null, renderHeader(), renderMain()), /*#__PURE__*/React__default.createElement(ActionSet, {
+  }, renderHeader(), renderMain()) : /*#__PURE__*/React__default.createElement(React__default.Fragment, null, renderHeader(), renderMain()), /*#__PURE__*/React__default.createElement(MotionActionSet, {
     actions: actions,
     className: primaryActionContainerClassNames,
-    size: size === 'xs' ? 'sm' : size
+    size: size === 'xs' ? 'sm' : size,
+    custom: shouldReduceMotion,
+    variants: actionSetVariants
   }), /*#__PURE__*/React__default.createElement("span", {
     ref: endTrapRef,
     tabIndex: "0",

package/es/components/SidePanel/motion/variants.d.ts

@@ -16,27 +16,54 @@ export namespace overlayVariants {
     }
 }
 export namespace panelVariants {
-    export namespace visible_1 {
-        export let x: number;
-        export namespace transition_1 {
-            let duration_1: number;
-            export { duration_1 as duration };
-            let ease_1: number[];
-            export { ease_1 as ease };
-        }
-        export { transition_1 as transition };
-    }
+    export function visible_1({ shouldReduceMotion }: {
+        shouldReduceMotion: any;
+    }): {
+        x: number;
+        transition: {
+            duration: number;
+            ease: number[];
+        };
+        opacity: any;
+    };
     export { visible_1 as visible };
-    export function hidden_1(placement: any): {
+    export function hidden_1({ placement, shouldReduceMotion }: {
+        placement: any;
+        shouldReduceMotion: any;
+    }): {
         x: string | number;
+        opacity: any;
     };
     export { hidden_1 as hidden };
-    export function exit_1(placement: any): {
+    export function exit_1({ placement, shouldReduceMotion }: {
+        placement: any;
+        shouldReduceMotion: any;
+    }): {
         x: string | number;
         transition: {
             duration: number;
             ease: number[];
         };
+        opacity: any;
     };
     export { exit_1 as exit };
 }
+export namespace actionSetVariants {
+    export function hidden_2(shouldReduceMotion: any): {
+        opacity: number;
+        transition: {
+            duration: number;
+            ease: number | number[];
+        };
+    };
+    export { hidden_2 as hidden };
+    export function visible_2(shouldReduceMotion: any): {
+        opacity: number;
+        transition: {
+            duration: number;
+            ease: number | number[];
+            delay: number;
+        };
+    };
+    export { visible_2 as visible };
+}

package/es/components/SidePanel/motion/variants.js

@@ -23,27 +23,58 @@ var overlayVariants = {
   }
 };
 var panelVariants = {
-  visible: {
-    x: 0,
-    transition: {
-      duration: DURATIONS.moderate02,
-      ease: EASINGS.productive.standard
-    }
+  visible: function visible(_ref) {
+    var shouldReduceMotion = _ref.shouldReduceMotion;
+    return {
+      x: 0,
+      transition: {
+        duration: DURATIONS.moderate02,
+        ease: EASINGS.productive.standard
+      },
+      opacity: shouldReduceMotion && 1
+    };
   },
-  hidden: function hidden(placement) {
+  hidden: function hidden(_ref2) {
+    var placement = _ref2.placement,
+      shouldReduceMotion = _ref2.shouldReduceMotion;
     return {
-      x: placement === 'right' ? '100%' : -320
+      x: placement === 'right' ? shouldReduceMotion ? 0 : '100%' : shouldReduceMotion ? 0 : -320,
+      opacity: shouldReduceMotion && 0
     };
   },
-  exit: function exit(placement) {
+  exit: function exit(_ref3) {
+    var placement = _ref3.placement,
+      shouldReduceMotion = _ref3.shouldReduceMotion;
     return {
-      x: placement === 'right' ? '100%' : -320,
+      x: placement === 'right' ? shouldReduceMotion ? 0 : '100%' : shouldReduceMotion ? 0 : -320,
       transition: {
         duration: DURATIONS.moderate01,
         ease: EASINGS.productive.exit
+      },
+      opacity: shouldReduceMotion && 0
+    };
+  }
+};
+var actionSetVariants = {
+  hidden: function hidden(shouldReduceMotion) {
+    return {
+      opacity: shouldReduceMotion ? 0 : 1,
+      transition: {
+        duration: shouldReduceMotion ? DURATIONS.moderate01 : DURATIONS.fast01,
+        ease: shouldReduceMotion ? 0 : EASINGS.productive.exit
+      }
+    };
+  },
+  visible: function visible(shouldReduceMotion) {
+    return {
+      opacity: 1,
+      transition: {
+        duration: shouldReduceMotion ? DURATIONS.moderate01 : DURATIONS.fast02,
+        ease: shouldReduceMotion ? 0 : EASINGS.productive.entrance,
+        delay: shouldReduceMotion ? 0.075 : 0
       }
     };
   }
 };
 
-export { overlayVariants, panelVariants };
+export { actionSetVariants, overlayVariants, panelVariants };

package/es/components/StringFormatter/StringFormatter.d.ts

@@ -0,0 +1,6 @@
+/**
+ * StringFormatter allows for truncating text while displaying a tooltip
+ * overlay on hover or focus with the entirety of the provided copy.
+ */
+export let StringFormatter: React.ForwardRefExoticComponent<React.RefAttributes<any>>;
+import React from 'react';

package/es/components/StringFormatter/StringFormatter.js

@@ -0,0 +1,79 @@
+/**
+ * Copyright IBM Corp. 2020, 2024
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { objectWithoutProperties as _objectWithoutProperties, defineProperty as _defineProperty, extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import React__default from 'react';
+import PropTypes from '../../node_modules/prop-types/index.js';
+import cx from '../../node_modules/classnames/index.js';
+import { getDevtoolsProps } from '../../global/js/utils/devtools.js';
+import { pkg } from '../../settings.js';
+import { DefinitionTooltip } from '@carbon/react';
+import { StringFormatterAlignment } from './utils/enums.js';
+
+var _excluded = ["className", "lines", "tooltipDirection", "truncate", "width", "value"];
+var blockClass = "".concat(pkg.prefix, "--string-formatter");
+var componentName = 'StringFormatter';
+var defaults = {
+  lines: 1,
+  tooltipDirection: StringFormatterAlignment.BOTTOM_LEFT,
+  truncate: false,
+  width: null
+};
+
+/**
+ * StringFormatter allows for truncating text while displaying a tooltip
+ * overlay on hover or focus with the entirety of the provided copy.
+ */
+var StringFormatter = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
+  var className = _ref.className,
+    _ref$lines = _ref.lines,
+    lines = _ref$lines === void 0 ? defaults.lines : _ref$lines,
+    _ref$tooltipDirection = _ref.tooltipDirection,
+    tooltipDirection = _ref$tooltipDirection === void 0 ? defaults.tooltipDirection : _ref$tooltipDirection,
+    _ref$truncate = _ref.truncate,
+    truncate = _ref$truncate === void 0 ? defaults.truncate : _ref$truncate,
+    _ref$width = _ref.width,
+    width = _ref$width === void 0 ? defaults.width : _ref$width,
+    value = _ref.value,
+    rest = _objectWithoutProperties(_ref, _excluded);
+  var stringFormatterContent = /*#__PURE__*/React__default.createElement("span", {
+    className: cx("".concat(blockClass, "--content"), _defineProperty({}, "".concat(blockClass, "--truncate"), truncate)),
+    style: {
+      maxWidth: width,
+      WebkitLineClamp: lines
+    }
+  }, value);
+  return /*#__PURE__*/React__default.createElement("span", _extends({}, rest, {
+    className: cx(blockClass, className),
+    ref: ref
+  }, getDevtoolsProps(componentName)), truncate ? /*#__PURE__*/React__default.createElement(DefinitionTooltip, {
+    className: "".concat(blockClass, "__tooltip"),
+    align: tooltipDirection,
+    definition: value,
+    openOnHover: true
+  }, stringFormatterContent) : stringFormatterContent);
+});
+StringFormatter = pkg.checkComponentEnabled(StringFormatter, componentName);
+StringFormatter.displayName = componentName;
+StringFormatter.propTypes = {
+  /**
+   * Provide an optional class to be applied to the containing node.
+   */
+  className: PropTypes.string,
+  /** Number of lines to clamp value. */
+  lines: PropTypes.number,
+  /** Specify the direction of the tooltip. Can be either top or bottom. */
+  tooltipDirection: PropTypes.oneOf(Object.values(StringFormatterAlignment)),
+  /** Whether or not the value should be truncated. */
+  truncate: PropTypes.bool,
+  /** Value to format. */
+  value: PropTypes.string.isRequired,
+  /** Maximum width of value which should include */
+  width: PropTypes.string
+};
+
+export { StringFormatter };

package/es/components/StringFormatter/index.d.ts

@@ -0,0 +1 @@
+export { StringFormatter } from "./StringFormatter";

package/es/components/StringFormatter/utils/enums.d.ts

@@ -0,0 +1,14 @@
+export namespace StringFormatterAlignment {
+    let TOP: string;
+    let TOP_LEFT: string;
+    let TOP_RIGHT: string;
+    let BOTTOM: string;
+    let BOTTOM_LEFT: string;
+    let BOTTOM_RIGHT: string;
+    let LEFT: string;
+    let LEFT_BOTTOM: string;
+    let LEFT_TOP: string;
+    let RIGHT: string;
+    let RIGHT_BOTTOM: string;
+    let RIGHT_TOP: string;
+}

package/es/components/StringFormatter/utils/enums.js

@@ -0,0 +1,23 @@
+/**
+ * Copyright IBM Corp. 2020, 2024
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+var StringFormatterAlignment = {
+  TOP: 'top',
+  TOP_LEFT: 'top-left',
+  TOP_RIGHT: 'top-right',
+  BOTTOM: 'bottom',
+  BOTTOM_LEFT: 'bottom-left',
+  BOTTOM_RIGHT: 'bottom-right',
+  LEFT: 'left',
+  LEFT_BOTTOM: 'left-bottom',
+  LEFT_TOP: 'left-top',
+  RIGHT: 'right',
+  RIGHT_BOTTOM: 'right-bottom',
+  RIGHT_TOP: 'right-top'
+};
+
+export { StringFormatterAlignment };

package/es/components/Tearsheet/TearsheetShell.js

@@ -19,7 +19,7 @@ import { usePortalTarget } from '../../global/js/hooks/usePortalTarget.js';
 import { useFocus } from '../../global/js/hooks/useFocus.js';
 import { ActionSet } from '../ActionSet/ActionSet.js';
 
-var _excluded = ["actions", "ariaLabel", "children", "className", "closeIconDescription", "description", "hasCloseIcon", "headerActions", "influencer", "influencerPosition", "influencerWidth", "label", "navigation", "onClose", "open", "selectorPrimaryFocus", "size", "portalTarget", "title", "verticalPosition"];
+var _excluded = ["actions", "ariaLabel", "children", "className", "closeIconDescription", "description", "hasCloseIcon", "headerActions", "influencer", "influencerPosition", "influencerWidth", "label", "navigation", "onClose", "open", "portalTarget", "selectorPrimaryFocus", "size", "slug", "title", "verticalPosition"];
 
 // The block part of our conventional BEM class names (bc__E--M).
 var bc = "".concat(pkg.prefix, "--tearsheet");
@@ -71,9 +71,10 @@ var TearsheetShell = /*#__PURE__*/React__default.forwardRef(function (_ref, ref)
     navigation = _ref.navigation,
     onClose = _ref.onClose,
     open = _ref.open,
+    portalTargetIn = _ref.portalTarget,
     selectorPrimaryFocus = _ref.selectorPrimaryFocus,
     size = _ref.size,
-    portalTargetIn = _ref.portalTarget,
+    slug = _ref.slug,
     title = _ref.title,
     verticalPosition = _ref.verticalPosition,
     rest = _objectWithoutProperties(_ref, _excluded);
@@ -190,9 +191,10 @@ var TearsheetShell = /*#__PURE__*/React__default.forwardRef(function (_ref, ref)
     var includeActions = actions && (actions === null || actions === void 0 ? void 0 : actions.length) > 0;
     return renderPortalUse( /*#__PURE__*/React__default.createElement(ComposedModal, _extends({}, rest, {
       "aria-label": ariaLabel || getNodeTextContent(title),
-      className: cx(bc, className, _defineProperty(_defineProperty(_defineProperty({}, "".concat(bc, "--stacked-").concat(position, "-of-").concat(depth),
+      className: cx(bc, className, _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, "".concat(bc, "--stacked-").concat(position, "-of-").concat(depth),
       // Don't apply this on the initial open of a single tearsheet.
-      depth > 1 || depth === 1 && prevDepth.current > 1), "".concat(bc, "--wide"), wide), "".concat(bc, "--narrow"), !wide)),
+      depth > 1 || depth === 1 && prevDepth.current > 1), "".concat(bc, "--wide"), wide), "".concat(bc, "--narrow"), !wide), "".concat(bc, "--has-slug"), slug), "".concat(bc, "--has-close"), effectiveHasCloseIcon)),
+      slug: slug,
       style: _defineProperty(_defineProperty({}, "--".concat(bc, "--stacking-scale-factor-single"), (width - 32) / width), "--".concat(bc, "--stacking-scale-factor-double"), (width - 64) / width),
       containerClassName: cx("".concat(bc, "__container"), _defineProperty({}, "".concat(bc, "__container--lower"), verticalPosition === 'lower')),
       onClose: onClose,
@@ -394,6 +396,10 @@ TearsheetShell.propTypes = _objectSpread2({
    * Specifies the width of the tearsheet, 'narrow' or 'wide'.
    */
   size: PropTypes.oneOf(['narrow', 'wide']).isRequired,
+  /**
+   *  **Experimental:** Provide a `Slug` component to be rendered inside the `SidePanel` component
+   */
+  slug: PropTypes.node,
   /**
    * The main title of the tearsheet, displayed in the header area.
    */