@carbon/ibm-products 2.54.0-canary.70 → 2.54.0-canary.73

package/es/components/CoachmarkOverlayElements/CoachmarkOverlayElements.d.ts

@@ -46,6 +46,18 @@ export interface CoachmarkOverlayElementsProps {
      * The label for the Close button.
      */
     closeButtonLabel?: string;
+    /**
+     * Callback called when clicking on the Next button.
+     */
+    onNext?: () => void;
+    /**
+     * Callback called when clicking on the Previous button.
+     */
+    onBack?: () => void;
+    /**
+     * Current step of the coachmarks.
+     */
+    currentStep?: number;
 }
 /**
  * Composable container to allow for the displaying of CoachmarkOverlayElement

package/es/components/CoachmarkOverlayElements/CoachmarkOverlayElements.js

@@ -20,7 +20,7 @@ import { pkg } from '../../settings.js';
 import '../Coachmark/Coachmark.js';
 import { useCoachmark } from '../Coachmark/utils/context.js';
 
-var _excluded = ["className", "children", "isVisible", "media", "renderMedia", "nextButtonText", "previousButtonLabel", "closeButtonLabel"];
+var _excluded = ["className", "children", "isVisible", "media", "renderMedia", "currentStep", "nextButtonText", "previousButtonLabel", "closeButtonLabel", "onNext", "onBack"];
 
 // The block part of our conventional BEM class names (blockClass__E--M).
 var blockClass = "".concat(pkg.prefix, "--coachmark-overlay-elements");
@@ -41,7 +41,10 @@ var defaults = {
   isVisible: false,
   nextButtonText: 'Next',
   previousButtonLabel: 'Back',
-  closeButtonLabel: 'Got it'
+  closeButtonLabel: 'Got it',
+  onNext: undefined,
+  onBack: undefined,
+  currentStep: 0
 };
 /**
  * Composable container to allow for the displaying of CoachmarkOverlayElement
@@ -54,12 +57,18 @@ var CoachmarkOverlayElements = /*#__PURE__*/React__default.forwardRef(function (
     isVisible = _ref$isVisible === void 0 ? defaults.isVisible : _ref$isVisible,
     media = _ref.media,
     renderMedia = _ref.renderMedia,
+    _ref$currentStep = _ref.currentStep,
+    currentStep = _ref$currentStep === void 0 ? defaults.currentStep : _ref$currentStep,
     _ref$nextButtonText = _ref.nextButtonText,
     nextButtonText = _ref$nextButtonText === void 0 ? defaults.nextButtonText : _ref$nextButtonText,
     _ref$previousButtonLa = _ref.previousButtonLabel,
     previousButtonLabel = _ref$previousButtonLa === void 0 ? defaults.previousButtonLabel : _ref$previousButtonLa,
     _ref$closeButtonLabel = _ref.closeButtonLabel,
     closeButtonLabel = _ref$closeButtonLabel === void 0 ? defaults.closeButtonLabel : _ref$closeButtonLabel,
+    _ref$onNext = _ref.onNext,
+    onNext = _ref$onNext === void 0 ? defaults.onNext : _ref$onNext,
+    _ref$onBack = _ref.onBack,
+    onBack = _ref$onBack === void 0 ? defaults.onBack : _ref$onBack,
     rest = _objectWithoutProperties(_ref, _excluded);
   var buttonFocusRef = useRef(undefined);
   var scrollRef = useRef(undefined);
@@ -67,7 +76,7 @@ var CoachmarkOverlayElements = /*#__PURE__*/React__default.forwardRef(function (
     _useState2 = _slicedToArray(_useState, 2),
     scrollPosition = _useState2[0],
     setScrollPosition = _useState2[1];
-  var _useState3 = useState(0),
+  var _useState3 = useState(currentStep),
     _useState4 = _slicedToArray(_useState3, 2),
     currentProgStep = _useState4[0],
     _setCurrentProgStep = _useState4[1];
@@ -90,6 +99,15 @@ var CoachmarkOverlayElements = /*#__PURE__*/React__default.forwardRef(function (
       playStep: currentProgStep
     });
   }, [currentProgStep, renderMedia]);
+  useEffect(function () {
+    var _scrollRef$current, _scrollRef$current$sc;
+    // When current step is set by props
+    // scroll to the appropriate view on the carrousel
+    var targetStep = clamp(currentStep, progStepFloor, progStepCeil);
+    scrollRef === null || scrollRef === void 0 || (_scrollRef$current = scrollRef.current) === null || _scrollRef$current === void 0 || (_scrollRef$current$sc = _scrollRef$current.scrollToView) === null || _scrollRef$current$sc === void 0 || _scrollRef$current$sc.call(_scrollRef$current, targetStep);
+    // Avoid circular call to this hook
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [currentStep]);
   useEffect(function () {
     // On mount, one of the two primary buttons ("next" or "close")
     // will be rendered and must have focus. (a11y)
@@ -131,7 +149,6 @@ var CoachmarkOverlayElements = /*#__PURE__*/React__default.forwardRef(function (
   }, coachmark.closeButtonProps, {
     ref: buttonFocusRef
   }), closeButtonLabel))) : /*#__PURE__*/React__default.createElement(React__default.Fragment, null, /*#__PURE__*/React__default.createElement(Carousel, {
-    disableArrowScroll: true,
     ref: scrollRef,
     onScroll: function onScroll(scrollPercent) {
       setScrollPosition(scrollPercent);
@@ -146,10 +163,11 @@ var CoachmarkOverlayElements = /*#__PURE__*/React__default.forwardRef(function (
     title: previousButtonLabel,
     disabled: scrollPosition === 0,
     onClick: function onClick() {
-      var _scrollRef$current, _scrollRef$current$sc;
+      var _scrollRef$current2, _scrollRef$current2$s;
       var targetStep = clamp(currentProgStep - 1, progStepFloor, progStepCeil);
-      scrollRef === null || scrollRef === void 0 || (_scrollRef$current = scrollRef.current) === null || _scrollRef$current === void 0 || (_scrollRef$current$sc = _scrollRef$current.scrollToView) === null || _scrollRef$current$sc === void 0 || _scrollRef$current$sc.call(_scrollRef$current, targetStep);
+      scrollRef === null || scrollRef === void 0 || (_scrollRef$current2 = scrollRef.current) === null || _scrollRef$current2 === void 0 || (_scrollRef$current2$s = _scrollRef$current2.scrollToView) === null || _scrollRef$current2$s === void 0 || _scrollRef$current2$s.call(_scrollRef$current2, targetStep);
       setCurrentProgStep(targetStep);
+      onBack === null || onBack === void 0 || onBack();
     }
   }, previousButtonLabel), currentProgStep < progStepCeil ? /*#__PURE__*/React__default.createElement(Button, {
     size: "sm",
@@ -157,10 +175,11 @@ var CoachmarkOverlayElements = /*#__PURE__*/React__default.forwardRef(function (
     title: nextButtonText,
     disabled: scrollPosition === 1,
     onClick: function onClick() {
-      var _scrollRef$current2, _scrollRef$current2$s;
+      var _scrollRef$current3, _scrollRef$current3$s;
       var targetStep = clamp(currentProgStep + 1, progStepFloor, progStepCeil);
-      scrollRef === null || scrollRef === void 0 || (_scrollRef$current2 = scrollRef.current) === null || _scrollRef$current2 === void 0 || (_scrollRef$current2$s = _scrollRef$current2.scrollToView) === null || _scrollRef$current2$s === void 0 || _scrollRef$current2$s.call(_scrollRef$current2, targetStep);
+      scrollRef === null || scrollRef === void 0 || (_scrollRef$current3 = scrollRef.current) === null || _scrollRef$current3 === void 0 || (_scrollRef$current3$s = _scrollRef$current3.scrollToView) === null || _scrollRef$current3$s === void 0 || _scrollRef$current3$s.call(_scrollRef$current3, targetStep);
       setCurrentProgStep(targetStep);
+      onNext === null || onNext === void 0 || onNext();
     }
   }, nextButtonText) : closeButtonLabel && /*#__PURE__*/React__default.createElement(Button, _extends({
     size: "sm",
@@ -194,6 +213,10 @@ CoachmarkOverlayElements.propTypes = {
    * The label for the Close button.
    */
   closeButtonLabel: PropTypes.string,
+  /**
+   * Current step of the coachmarks
+   */
+  currentStep: PropTypes.number,
   /**
    * The visibility of CoachmarkOverlayElements is
    * managed in the parent component.
@@ -215,6 +238,14 @@ CoachmarkOverlayElements.propTypes = {
    * The label for the Next button.
    */
   nextButtonText: PropTypes.string,
+  /**
+   * Optional callback called when clicking on the Previous button.
+   */
+  onBack: PropTypes.func,
+  /**
+   * Optional callback called when clicking on the Next button.
+   */
+  onNext: PropTypes.func,
   /**
    * The label for the Previous button.
    */

package/es/components/CreateTearsheet/CreateTearsheet.js

@@ -196,7 +196,8 @@ var CreateTearsheet = /*#__PURE__*/forwardRef(function (_ref, ref) {
     slug: slug,
     title: title,
     verticalPosition: verticalPosition,
-    closeIconDescription: ''
+    closeIconDescription: '',
+    currentStep: currentStep
   }), /*#__PURE__*/React__default.createElement("div", {
     className: "".concat(blockClass, "__content"),
     ref: contentRef

package/es/components/Tearsheet/TearsheetShell.d.ts

@@ -19,6 +19,10 @@ interface TearsheetShellProps extends PropsWithChildren {
      * An optional class or classes to be added to the outermost element.
      */
     className?: string;
+    /**
+     * Used to track the current step on components which use `StepsContext` and `TearsheetShell`
+     */
+    currentStep?: number;
     /**
      * A description of the flow, displayed in the header area of the tearsheet.
      */

package/es/components/Tearsheet/TearsheetShell.js

@@ -21,7 +21,7 @@ import { usePortalTarget } from '../../global/js/hooks/usePortalTarget.js';
 import { useFocus, claimFocus } from '../../global/js/hooks/useFocus.js';
 import { usePreviousValue } from '../../global/js/hooks/usePreviousValue.js';
 
-var _excluded = ["actions", "aiLabel", "ariaLabel", "children", "className", "closeIconDescription", "description", "hasCloseIcon", "headerActions", "influencer", "influencerPosition", "influencerWidth", "label", "navigation", "onClose", "open", "portalTarget", "selectorPrimaryFocus", "selectorsFloatingMenus", "size", "slug", "title", "verticalPosition", "launcherButtonRef"];
+var _excluded = ["actions", "aiLabel", "ariaLabel", "children", "className", "closeIconDescription", "currentStep", "description", "hasCloseIcon", "headerActions", "influencer", "influencerPosition", "influencerWidth", "label", "navigation", "onClose", "open", "portalTarget", "selectorPrimaryFocus", "selectorsFloatingMenus", "size", "slug", "title", "verticalPosition", "launcherButtonRef"];
 // The block part of our conventional BEM class names (bc__E--M).
 var bc = "".concat(pkg.prefix, "--tearsheet");
 var componentName = 'TearsheetShell';
@@ -68,6 +68,7 @@ var TearsheetShell = /*#__PURE__*/React__default.forwardRef(function (_ref, ref)
     children = _ref.children,
     className = _ref.className,
     closeIconDescription = _ref.closeIconDescription,
+    currentStep = _ref.currentStep,
     description = _ref.description,
     hasCloseIcon = _ref.hasCloseIcon,
     headerActions = _ref.headerActions,
@@ -100,8 +101,7 @@ var TearsheetShell = /*#__PURE__*/React__default.forwardRef(function (_ref, ref)
   var prevOpen = usePreviousValue(open);
   var _useFocus = useFocus(modalRef, selectorPrimaryFocus),
     firstElement = _useFocus.firstElement,
-    keyDownListener = _useFocus.keyDownListener,
-    specifiedElement = _useFocus.specifiedElement;
+    keyDownListener = _useFocus.keyDownListener;
   var modalRefValue = modalRef.current;
 
   // Function to strip html tags out of a string.
@@ -137,23 +137,12 @@ var TearsheetShell = /*#__PURE__*/React__default.forwardRef(function (_ref, ref)
     setDepth(newDepth);
     setPosition(newPosition);
   }
-  handleStackChange.checkFocus = function () {
-    // if we are now the topmost tearsheet, ensure we have focus
-    if (open && position === depth && modalRefValue && !modalRefValue.contains(document.activeElement)) {
-      handleStackChange.claimFocus();
-    }
-  };
-
-  // Callback to give the tearsheet the opportunity to claim focus
-  handleStackChange.claimFocus = function () {
-    claimFocus(firstElement, modalRef, selectorPrimaryFocus);
-  };
   useEffect(function () {
-    if (open) {
+    if (open && position === depth) {
       // Focusing the first element or selectorPrimaryFocus element
       claimFocus(firstElement, modalRef, selectorPrimaryFocus);
     }
-  }, [firstElement, modalRef, open, selectorPrimaryFocus]);
+  }, [currentStep, depth, firstElement, modalRef, modalRefValue, open, position, selectorPrimaryFocus]);
   useEffect(function () {
     if (prevOpen && !open && launcherButtonRef) {
       setTimeout(function () {
@@ -161,22 +150,10 @@ var TearsheetShell = /*#__PURE__*/React__default.forwardRef(function (_ref, ref)
       }, 0);
     }
   }, [launcherButtonRef, open, prevOpen]);
-  useEffect(function () {
-    if (open && position !== depth) {
-      setTimeout(function () {
-        if (selectorPrimaryFocus) {
-          return specifiedElement === null || specifiedElement === void 0 ? void 0 : specifiedElement.focus();
-        }
-        firstElement === null || firstElement === void 0 || firstElement.focus();
-      }, 0);
-    }
-  }, [position, depth, firstElement, open, specifiedElement, selectorPrimaryFocus]);
   useEffect(function () {
     var notify = function notify() {
       return stack.all.forEach(function (handler) {
-        var _handler$checkFocus;
         handler(Math.min(stack.open.length, maxDepth), stack.open.indexOf(handler) + 1);
-        (_handler$checkFocus = handler.checkFocus) === null || _handler$checkFocus === void 0 || _handler$checkFocus.call(handler);
       });
     };
 
@@ -211,14 +188,6 @@ var TearsheetShell = /*#__PURE__*/React__default.forwardRef(function (_ref, ref)
       }
     };
   }, [open, size]);
-  function handleFocus() {
-    // If something within us is receiving focus but we are not the topmost
-    // stacked tearsheet, transfer focus to the topmost tearsheet instead
-    if (position < depth) {
-      var _stack$open$claimFocu, _stack$open;
-      (_stack$open$claimFocu = (_stack$open = stack.open[stack.open.length - 1]).claimFocus) === null || _stack$open$claimFocu === void 0 || _stack$open$claimFocu.call(_stack$open);
-    }
-  }
   if (position <= depth) {
     var _prevDepth$current;
     // Include a modal header if and only if one or more of these is given.
@@ -250,7 +219,6 @@ var TearsheetShell = /*#__PURE__*/React__default.forwardRef(function (_ref, ref)
       onClose: onClose,
       open: open,
       selectorPrimaryFocus: selectorPrimaryFocus,
-      onFocus: handleFocus,
       onKeyDown: keyDownListener,
       preventCloseOnClickOutside: !isPassive,
       ref: modalRef,

package/es/global/js/hooks/useFocus.d.ts

@@ -12,4 +12,4 @@ export function useFocus(modalRef: any, selectorPrimaryFocus: any): {
         specified: any;
     };
 };
-export function claimFocus(firstElement: any, modalRef: any, selectorPrimaryFocus?: string | undefined): any;
+export function claimFocus(firstElement: any, modalRef: any, selectorPrimaryFocus?: string | undefined): void;

package/es/global/js/hooks/useFocus.js

@@ -116,12 +116,15 @@ var claimFocus = function claimFocus(firstElement, modalRef) {
     var _window2;
     var specifiedEl = getSpecificElement(modalRef === null || modalRef === void 0 ? void 0 : modalRef.current, selectorPrimaryFocus);
     if (specifiedEl && ((_window2 = window) === null || _window2 === void 0 || (_window2 = _window2.getComputedStyle(specifiedEl)) === null || _window2 === void 0 ? void 0 : _window2.display) !== 'none') {
-      return specifiedEl.focus();
+      setTimeout(function () {
+        return specifiedEl.focus();
+      }, 0);
     }
+  } else {
+    setTimeout(function () {
+      return firstElement === null || firstElement === void 0 ? void 0 : firstElement.focus();
+    }, 0);
   }
-  setTimeout(function () {
-    return firstElement === null || firstElement === void 0 ? void 0 : firstElement.focus();
-  }, 0);
 };
 
 export { claimFocus, getSpecificElement, useFocus };

package/lib/components/CoachmarkOverlayElements/CoachmarkOverlayElements.d.ts

@@ -46,6 +46,18 @@ export interface CoachmarkOverlayElementsProps {
      * The label for the Close button.
      */
     closeButtonLabel?: string;
+    /**
+     * Callback called when clicking on the Next button.
+     */
+    onNext?: () => void;
+    /**
+     * Callback called when clicking on the Previous button.
+     */
+    onBack?: () => void;
+    /**
+     * Current step of the coachmarks.
+     */
+    currentStep?: number;
 }
 /**
  * Composable container to allow for the displaying of CoachmarkOverlayElement

package/lib/components/CoachmarkOverlayElements/CoachmarkOverlayElements.js

@@ -22,7 +22,7 @@ var settings = require('../../settings.js');
 require('../Coachmark/Coachmark.js');
 var context = require('../Coachmark/utils/context.js');
 
-var _excluded = ["className", "children", "isVisible", "media", "renderMedia", "nextButtonText", "previousButtonLabel", "closeButtonLabel"];
+var _excluded = ["className", "children", "isVisible", "media", "renderMedia", "currentStep", "nextButtonText", "previousButtonLabel", "closeButtonLabel", "onNext", "onBack"];
 
 // The block part of our conventional BEM class names (blockClass__E--M).
 var blockClass = "".concat(settings.pkg.prefix, "--coachmark-overlay-elements");
@@ -43,7 +43,10 @@ var defaults = {
   isVisible: false,
   nextButtonText: 'Next',
   previousButtonLabel: 'Back',
-  closeButtonLabel: 'Got it'
+  closeButtonLabel: 'Got it',
+  onNext: undefined,
+  onBack: undefined,
+  currentStep: 0
 };
 /**
  * Composable container to allow for the displaying of CoachmarkOverlayElement
@@ -56,12 +59,18 @@ exports.CoachmarkOverlayElements = /*#__PURE__*/React.forwardRef(function (_ref,
     isVisible = _ref$isVisible === void 0 ? defaults.isVisible : _ref$isVisible,
     media = _ref.media,
     renderMedia = _ref.renderMedia,
+    _ref$currentStep = _ref.currentStep,
+    currentStep = _ref$currentStep === void 0 ? defaults.currentStep : _ref$currentStep,
     _ref$nextButtonText = _ref.nextButtonText,
     nextButtonText = _ref$nextButtonText === void 0 ? defaults.nextButtonText : _ref$nextButtonText,
     _ref$previousButtonLa = _ref.previousButtonLabel,
     previousButtonLabel = _ref$previousButtonLa === void 0 ? defaults.previousButtonLabel : _ref$previousButtonLa,
     _ref$closeButtonLabel = _ref.closeButtonLabel,
     closeButtonLabel = _ref$closeButtonLabel === void 0 ? defaults.closeButtonLabel : _ref$closeButtonLabel,
+    _ref$onNext = _ref.onNext,
+    onNext = _ref$onNext === void 0 ? defaults.onNext : _ref$onNext,
+    _ref$onBack = _ref.onBack,
+    onBack = _ref$onBack === void 0 ? defaults.onBack : _ref$onBack,
     rest = _rollupPluginBabelHelpers.objectWithoutProperties(_ref, _excluded);
   var buttonFocusRef = React.useRef(undefined);
   var scrollRef = React.useRef(undefined);
@@ -69,7 +78,7 @@ exports.CoachmarkOverlayElements = /*#__PURE__*/React.forwardRef(function (_ref,
     _useState2 = _rollupPluginBabelHelpers.slicedToArray(_useState, 2),
     scrollPosition = _useState2[0],
     setScrollPosition = _useState2[1];
-  var _useState3 = React.useState(0),
+  var _useState3 = React.useState(currentStep),
     _useState4 = _rollupPluginBabelHelpers.slicedToArray(_useState3, 2),
     currentProgStep = _useState4[0],
     _setCurrentProgStep = _useState4[1];
@@ -92,6 +101,15 @@ exports.CoachmarkOverlayElements = /*#__PURE__*/React.forwardRef(function (_ref,
       playStep: currentProgStep
     });
   }, [currentProgStep, renderMedia]);
+  React.useEffect(function () {
+    var _scrollRef$current, _scrollRef$current$sc;
+    // When current step is set by props
+    // scroll to the appropriate view on the carrousel
+    var targetStep = lodash.clamp(currentStep, progStepFloor, progStepCeil);
+    scrollRef === null || scrollRef === void 0 || (_scrollRef$current = scrollRef.current) === null || _scrollRef$current === void 0 || (_scrollRef$current$sc = _scrollRef$current.scrollToView) === null || _scrollRef$current$sc === void 0 || _scrollRef$current$sc.call(_scrollRef$current, targetStep);
+    // Avoid circular call to this hook
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [currentStep]);
   React.useEffect(function () {
     // On mount, one of the two primary buttons ("next" or "close")
     // will be rendered and must have focus. (a11y)
@@ -133,7 +151,6 @@ exports.CoachmarkOverlayElements = /*#__PURE__*/React.forwardRef(function (_ref,
   }, coachmark.closeButtonProps, {
     ref: buttonFocusRef
   }), closeButtonLabel))) : /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Carousel.Carousel, {
-    disableArrowScroll: true,
     ref: scrollRef,
     onScroll: function onScroll(scrollPercent) {
       setScrollPosition(scrollPercent);
@@ -148,10 +165,11 @@ exports.CoachmarkOverlayElements = /*#__PURE__*/React.forwardRef(function (_ref,
     title: previousButtonLabel,
     disabled: scrollPosition === 0,
     onClick: function onClick() {
-      var _scrollRef$current, _scrollRef$current$sc;
+      var _scrollRef$current2, _scrollRef$current2$s;
       var targetStep = lodash.clamp(currentProgStep - 1, progStepFloor, progStepCeil);
-      scrollRef === null || scrollRef === void 0 || (_scrollRef$current = scrollRef.current) === null || _scrollRef$current === void 0 || (_scrollRef$current$sc = _scrollRef$current.scrollToView) === null || _scrollRef$current$sc === void 0 || _scrollRef$current$sc.call(_scrollRef$current, targetStep);
+      scrollRef === null || scrollRef === void 0 || (_scrollRef$current2 = scrollRef.current) === null || _scrollRef$current2 === void 0 || (_scrollRef$current2$s = _scrollRef$current2.scrollToView) === null || _scrollRef$current2$s === void 0 || _scrollRef$current2$s.call(_scrollRef$current2, targetStep);
       setCurrentProgStep(targetStep);
+      onBack === null || onBack === void 0 || onBack();
     }
   }, previousButtonLabel), currentProgStep < progStepCeil ? /*#__PURE__*/React.createElement(react.Button, {
     size: "sm",
@@ -159,10 +177,11 @@ exports.CoachmarkOverlayElements = /*#__PURE__*/React.forwardRef(function (_ref,
     title: nextButtonText,
     disabled: scrollPosition === 1,
     onClick: function onClick() {
-      var _scrollRef$current2, _scrollRef$current2$s;
+      var _scrollRef$current3, _scrollRef$current3$s;
       var targetStep = lodash.clamp(currentProgStep + 1, progStepFloor, progStepCeil);
-      scrollRef === null || scrollRef === void 0 || (_scrollRef$current2 = scrollRef.current) === null || _scrollRef$current2 === void 0 || (_scrollRef$current2$s = _scrollRef$current2.scrollToView) === null || _scrollRef$current2$s === void 0 || _scrollRef$current2$s.call(_scrollRef$current2, targetStep);
+      scrollRef === null || scrollRef === void 0 || (_scrollRef$current3 = scrollRef.current) === null || _scrollRef$current3 === void 0 || (_scrollRef$current3$s = _scrollRef$current3.scrollToView) === null || _scrollRef$current3$s === void 0 || _scrollRef$current3$s.call(_scrollRef$current3, targetStep);
       setCurrentProgStep(targetStep);
+      onNext === null || onNext === void 0 || onNext();
     }
   }, nextButtonText) : closeButtonLabel && /*#__PURE__*/React.createElement(react.Button, _rollupPluginBabelHelpers.extends({
     size: "sm",
@@ -196,6 +215,10 @@ exports.CoachmarkOverlayElements.propTypes = {
    * The label for the Close button.
    */
   closeButtonLabel: index.default.string,
+  /**
+   * Current step of the coachmarks
+   */
+  currentStep: index.default.number,
   /**
    * The visibility of CoachmarkOverlayElements is
    * managed in the parent component.
@@ -217,6 +240,14 @@ exports.CoachmarkOverlayElements.propTypes = {
    * The label for the Next button.
    */
   nextButtonText: index.default.string,
+  /**
+   * Optional callback called when clicking on the Previous button.
+   */
+  onBack: index.default.func,
+  /**
+   * Optional callback called when clicking on the Next button.
+   */
+  onNext: index.default.func,
   /**
    * The label for the Previous button.
    */

package/lib/components/CreateTearsheet/CreateTearsheet.js

@@ -198,7 +198,8 @@ exports.CreateTearsheet = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     slug: slug,
     title: title,
     verticalPosition: verticalPosition,
-    closeIconDescription: ''
+    closeIconDescription: '',
+    currentStep: currentStep
   }), /*#__PURE__*/React.createElement("div", {
     className: "".concat(blockClass, "__content"),
     ref: contentRef

package/lib/components/Tearsheet/TearsheetShell.d.ts

@@ -19,6 +19,10 @@ interface TearsheetShellProps extends PropsWithChildren {
      * An optional class or classes to be added to the outermost element.
      */
     className?: string;
+    /**
+     * Used to track the current step on components which use `StepsContext` and `TearsheetShell`
+     */
+    currentStep?: number;
     /**
      * A description of the flow, displayed in the header area of the tearsheet.
      */

package/lib/components/Tearsheet/TearsheetShell.js

@@ -23,7 +23,7 @@ var usePortalTarget = require('../../global/js/hooks/usePortalTarget.js');
 var useFocus = require('../../global/js/hooks/useFocus.js');
 var usePreviousValue = require('../../global/js/hooks/usePreviousValue.js');
 
-var _excluded = ["actions", "aiLabel", "ariaLabel", "children", "className", "closeIconDescription", "description", "hasCloseIcon", "headerActions", "influencer", "influencerPosition", "influencerWidth", "label", "navigation", "onClose", "open", "portalTarget", "selectorPrimaryFocus", "selectorsFloatingMenus", "size", "slug", "title", "verticalPosition", "launcherButtonRef"];
+var _excluded = ["actions", "aiLabel", "ariaLabel", "children", "className", "closeIconDescription", "currentStep", "description", "hasCloseIcon", "headerActions", "influencer", "influencerPosition", "influencerWidth", "label", "navigation", "onClose", "open", "portalTarget", "selectorPrimaryFocus", "selectorsFloatingMenus", "size", "slug", "title", "verticalPosition", "launcherButtonRef"];
 // The block part of our conventional BEM class names (bc__E--M).
 var bc = "".concat(settings.pkg.prefix, "--tearsheet");
 var componentName = 'TearsheetShell';
@@ -70,6 +70,7 @@ var TearsheetShell = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     children = _ref.children,
     className = _ref.className,
     closeIconDescription = _ref.closeIconDescription,
+    currentStep = _ref.currentStep,
     description = _ref.description,
     hasCloseIcon = _ref.hasCloseIcon,
     headerActions = _ref.headerActions,
@@ -102,8 +103,7 @@ var TearsheetShell = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   var prevOpen = usePreviousValue.usePreviousValue(open);
   var _useFocus = useFocus.useFocus(modalRef, selectorPrimaryFocus),
     firstElement = _useFocus.firstElement,
-    keyDownListener = _useFocus.keyDownListener,
-    specifiedElement = _useFocus.specifiedElement;
+    keyDownListener = _useFocus.keyDownListener;
   var modalRefValue = modalRef.current;
 
   // Function to strip html tags out of a string.
@@ -139,23 +139,12 @@ var TearsheetShell = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     setDepth(newDepth);
     setPosition(newPosition);
   }
-  handleStackChange.checkFocus = function () {
-    // if we are now the topmost tearsheet, ensure we have focus
-    if (open && position === depth && modalRefValue && !modalRefValue.contains(document.activeElement)) {
-      handleStackChange.claimFocus();
-    }
-  };
-
-  // Callback to give the tearsheet the opportunity to claim focus
-  handleStackChange.claimFocus = function () {
-    useFocus.claimFocus(firstElement, modalRef, selectorPrimaryFocus);
-  };
   React.useEffect(function () {
-    if (open) {
+    if (open && position === depth) {
       // Focusing the first element or selectorPrimaryFocus element
       useFocus.claimFocus(firstElement, modalRef, selectorPrimaryFocus);
     }
-  }, [firstElement, modalRef, open, selectorPrimaryFocus]);
+  }, [currentStep, depth, firstElement, modalRef, modalRefValue, open, position, selectorPrimaryFocus]);
   React.useEffect(function () {
     if (prevOpen && !open && launcherButtonRef) {
       setTimeout(function () {
@@ -163,22 +152,10 @@ var TearsheetShell = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       }, 0);
     }
   }, [launcherButtonRef, open, prevOpen]);
-  React.useEffect(function () {
-    if (open && position !== depth) {
-      setTimeout(function () {
-        if (selectorPrimaryFocus) {
-          return specifiedElement === null || specifiedElement === void 0 ? void 0 : specifiedElement.focus();
-        }
-        firstElement === null || firstElement === void 0 || firstElement.focus();
-      }, 0);
-    }
-  }, [position, depth, firstElement, open, specifiedElement, selectorPrimaryFocus]);
   React.useEffect(function () {
     var notify = function notify() {
       return stack.all.forEach(function (handler) {
-        var _handler$checkFocus;
         handler(Math.min(stack.open.length, maxDepth), stack.open.indexOf(handler) + 1);
-        (_handler$checkFocus = handler.checkFocus) === null || _handler$checkFocus === void 0 || _handler$checkFocus.call(handler);
       });
     };
 
@@ -213,14 +190,6 @@ var TearsheetShell = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       }
     };
   }, [open, size]);
-  function handleFocus() {
-    // If something within us is receiving focus but we are not the topmost
-    // stacked tearsheet, transfer focus to the topmost tearsheet instead
-    if (position < depth) {
-      var _stack$open$claimFocu, _stack$open;
-      (_stack$open$claimFocu = (_stack$open = stack.open[stack.open.length - 1]).claimFocus) === null || _stack$open$claimFocu === void 0 || _stack$open$claimFocu.call(_stack$open);
-    }
-  }
   if (position <= depth) {
     var _prevDepth$current;
     // Include a modal header if and only if one or more of these is given.
@@ -252,7 +221,6 @@ var TearsheetShell = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       onClose: onClose,
       open: open,
       selectorPrimaryFocus: selectorPrimaryFocus,
-      onFocus: handleFocus,
       onKeyDown: keyDownListener,
       preventCloseOnClickOutside: !isPassive,
       ref: modalRef,

package/lib/global/js/hooks/useFocus.d.ts

@@ -12,4 +12,4 @@ export function useFocus(modalRef: any, selectorPrimaryFocus: any): {
         specified: any;
     };
 };
-export function claimFocus(firstElement: any, modalRef: any, selectorPrimaryFocus?: string | undefined): any;
+export function claimFocus(firstElement: any, modalRef: any, selectorPrimaryFocus?: string | undefined): void;

package/lib/global/js/hooks/useFocus.js

@@ -118,12 +118,15 @@ var claimFocus = function claimFocus(firstElement, modalRef) {
     var _window2;
     var specifiedEl = getSpecificElement(modalRef === null || modalRef === void 0 ? void 0 : modalRef.current, selectorPrimaryFocus);
     if (specifiedEl && ((_window2 = window) === null || _window2 === void 0 || (_window2 = _window2.getComputedStyle(specifiedEl)) === null || _window2 === void 0 ? void 0 : _window2.display) !== 'none') {
-      return specifiedEl.focus();
+      setTimeout(function () {
+        return specifiedEl.focus();
+      }, 0);
     }
+  } else {
+    setTimeout(function () {
+      return firstElement === null || firstElement === void 0 ? void 0 : firstElement.focus();
+    }, 0);
   }
-  setTimeout(function () {
-    return firstElement === null || firstElement === void 0 ? void 0 : firstElement.focus();
-  }, 0);
 };
 
 exports.claimFocus = claimFocus;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@carbon/ibm-products",
   "description": "Carbon for IBM Products",
-  "version": "2.54.0-canary.70+13e845c84",
+  "version": "2.54.0-canary.73+36bd4f96c",
   "license": "Apache-2.0",
   "main": "lib/index.js",
   "module": "es/index.js",
@@ -120,5 +120,5 @@
     "react": "^16.8.6 || ^17.0.1 || ^18.2.0",
     "react-dom": "^16.8.6 || ^17.0.1 || ^18.2.0"
   },
-  "gitHead": "13e845c84e1583e4cdc5d037f31a8c3b826fabfc"
+  "gitHead": "36bd4f96c4d5ab6f3fd5ef1a732e9efbf6ec5212"
 }