@carbon/ibm-products 1.61.0 → 1.62.0

package/es/components/Coachmark/Coachmark.js

@@ -9,7 +9,7 @@ var _excluded = ["align", "children", "className", "onClose", "overlayClassName"
  * LICENSE file in the root directory of this source tree.
  */
 
-import React, { forwardRef, useEffect, useRef, useState } from 'react';
+import React, { forwardRef, useEffect, useRef, useState, useCallback } from 'react';
 import cx from 'classnames';
 import PropTypes, { Component } from 'prop-types';
 import { createPortal } from 'react-dom';
@@ -22,6 +22,7 @@ import { pkg /*, carbon */ } from '../../settings';
 import { throttle } from 'lodash';
 // The block part of our conventional BEM class names (blockClass__E--M).
 var blockClass = "".concat(pkg.prefix, "--coachmark");
+var overlayBlockClass = "".concat(blockClass, "-overlay");
 var componentName = 'Coachmark';
 var defaults = {
   align: 'bottom',
@@ -83,7 +84,18 @@ export var Coachmark = /*#__PURE__*/forwardRef(function (_ref, ref) {
   var closeOverlay = function closeOverlay() {
     setIsOpen(false);
   };
-  var handleClose = function handleClose() {
+  var escFunction = useCallback(function (event) {
+    if (event.key === 'Escape') {
+      handleClose();
+    }
+  }, [handleClose]);
+  useEffect(function () {
+    document.addEventListener('keydown', escFunction, false);
+    return function () {
+      document.removeEventListener('keydown', escFunction, false);
+    };
+  }, [escFunction]);
+  var handleClose = useCallback(function () {
     if (isStacked) {
       // If stacked, do not unmount,
       // only call its ("parent") onClose method.
@@ -92,7 +104,7 @@ export var Coachmark = /*#__PURE__*/forwardRef(function (_ref, ref) {
       setIsOpen(false);
       onClose();
     }
-  };
+  }, [isStacked, onClose]);
   var handleTargetClick = function handleTargetClick(e) {
     setTargetRect(e.target.getBoundingClientRect());
     setTargetOffset({
@@ -113,6 +125,7 @@ export var Coachmark = /*#__PURE__*/forwardRef(function (_ref, ref) {
   var contextValue = {
     buttonProps: {
       'aria-expanded': isOpen,
+      tabIndex: 0,
       onClick: handleTargetClick,
       // Compensate for accidental open/close on double-click.
       // Only open on double-click.
@@ -164,7 +177,7 @@ export var Coachmark = /*#__PURE__*/forwardRef(function (_ref, ref) {
     kind: overlayKind,
     onClose: handleClose,
     theme: theme,
-    className: overlayClassName
+    className: cx(overlayClassName, "".concat(overlayBlockClass, "--is-visible"))
   }, children), portalNode)));
 });
 
@@ -185,7 +198,6 @@ Coachmark.propTypes = {
    * @see COACHMARK_ALIGNMENT
    */
   align: PropTypes.oneOf(['bottom', 'bottom-left', 'bottom-right', 'left', 'left-top', 'left-bottom', 'right', 'right-top', 'right-bottom', 'top', 'top-left', 'top-right']),
-  // TODO: UPDATE COMMENT HERE - UPDATE MDX TO HAVE DIRECTION TO USE ONLY OVERLAY ELEMENTS>...
   /**
    * Coachmark should use a single CoachmarkOverlayElements component as a child.
    * @see CoachmarkOverlayElements

package/es/components/Coachmark/CoachmarkDragbar.js

@@ -1,7 +1,7 @@
 import _extends from "@babel/runtime/helpers/extends";
 import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
-var _excluded = ["closeIconDescription", "onClose", "onDrag", "showCloseButton", "theme"];
+var _excluded = ["a11yKeyboardHandler", "closeIconDescription", "onClose", "onDrag", "showCloseButton", "theme"];
 /**
  * Copyright IBM Corp. 2023, 2023
  *
@@ -25,6 +25,7 @@ import { pkg /*, carbon */ } from '../../settings';
 
 // The block part of our conventional BEM class names (blockClass__E--M).
 var blockClass = "".concat(pkg.prefix, "--coachmark-dragbar");
+var overlayBlockClass = "".concat(pkg.prefix, "--coachmark-overlay");
 var componentName = 'CoachmarkDragbar';
 var defaults = {
   closeIconDescription: 'Close',
@@ -39,7 +40,8 @@ var defaults = {
  * of other Novice to Pro components.
  */
 export var CoachmarkDragbar = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
-  var _ref$closeIconDescrip = _ref.closeIconDescription,
+  var a11yKeyboardHandler = _ref.a11yKeyboardHandler,
+    _ref$closeIconDescrip = _ref.closeIconDescription,
     closeIconDescription = _ref$closeIconDescrip === void 0 ? defaults.closeIconDescription : _ref$closeIconDescrip,
     _ref$onClose = _ref.onClose,
     onClose = _ref$onClose === void 0 ? defaults.onClose : _ref$onClose,
@@ -89,15 +91,16 @@ export var CoachmarkDragbar = /*#__PURE__*/React.forwardRef(function (_ref, ref)
     // role="main"
   }, getDevtoolsProps(componentName)), /*#__PURE__*/React.createElement("button", {
     type: "button",
-    className: "".concat(blockClass, "__handle"),
-    onMouseDown: handleDragStart
+    className: "".concat(overlayBlockClass, "__handle"),
+    onMouseDown: handleDragStart,
+    onKeyDown: a11yKeyboardHandler
   }, /*#__PURE__*/React.createElement(Draggable16, null)), showCloseButton && /*#__PURE__*/React.createElement(Button, {
     kind: "ghost",
     size: "sm",
     renderIcon: Close16,
     iconDescription: closeIconDescription,
     hasIconOnly: true,
-    className: "".concat(blockClass, "--close-btn"),
+    className: "".concat(overlayBlockClass, "--close-btn"),
     onClick: onClose
   }));
 });
@@ -113,6 +116,10 @@ CoachmarkDragbar.displayName = componentName;
 // in alphabetical order (for consistency).
 // See https://www.npmjs.com/package/prop-types#usage.
 CoachmarkDragbar.propTypes = {
+  /**
+   * Handler to manage keyboard interactions with the dragbar.
+   */
+  a11yKeyboardHandler: PropTypes.func.isRequired,
   /**
    * Tooltip text and aria label for the Close button icon.
    */

package/es/components/Coachmark/CoachmarkHeader.js

@@ -21,6 +21,7 @@ import { pkg /*, carbon */ } from '../../settings';
 
 // The block part of our conventional BEM class names (blockClass__E--M).
 var blockClass = "".concat(pkg.prefix, "--coachmark-header");
+var overlayBlockClass = "".concat(pkg.prefix, "--coachmark-overlay");
 var componentName = 'CoachmarkHeader';
 var defaults = {
   closeIconDescription: 'Close',
@@ -53,7 +54,7 @@ export var CoachmarkHeader = /*#__PURE__*/React.forwardRef(function (_ref, ref)
     renderIcon: Close16,
     iconDescription: closeIconDescription,
     hasIconOnly: true,
-    className: "".concat(blockClass, "--close-btn"),
+    className: "".concat(overlayBlockClass, "--close-btn"),
     onClick: onClose
   }));
 });

package/es/components/Coachmark/CoachmarkOverlay.js

@@ -1,4 +1,5 @@
 import _extends from "@babel/runtime/helpers/extends";
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
 var _excluded = ["children", "onClose", "fixedIsVisible", "className", "kind", "theme"];
 /**
@@ -9,8 +10,8 @@ var _excluded = ["children", "onClose", "fixedIsVisible", "className", "kind", "
  */
 
 // Import portions of React that are needed.
-import React, { forwardRef, useRef } from 'react';
-
+import React, { forwardRef, useRef, useState, useEffect } from 'react';
+import uuidv4 from '../../global/js/utils/uuidv4';
 // Other standard imports.
 import PropTypes from 'prop-types';
 import cx from 'classnames';
@@ -47,12 +48,46 @@ export var CoachmarkOverlay = /*#__PURE__*/forwardRef(function (_ref, ref) {
     _ref$theme = _ref.theme,
     theme = _ref$theme === void 0 ? defaults.theme : _ref$theme,
     rest = _objectWithoutProperties(_ref, _excluded);
+  var _useWindowDimensions = useWindowDimensions(),
+    winHeight = _useWindowDimensions.winHeight,
+    winWidth = _useWindowDimensions.winWidth;
+  var _useState = useState(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    a11yDragMode = _useState2[0],
+    setA11yDragMode = _useState2[1];
   var overlayRef = useRef();
   var coachmark = useCoachmark();
   var isBeacon = kind === COACHMARK_OVERLAY_KIND.TOOLTIP;
   var isDraggable = kind === COACHMARK_OVERLAY_KIND.FLOATING;
+  var isVisible = className && className.includes('is-visible');
+  var handleKeyPress = function handleKeyPress(event) {
+    var shiftKey = event.shiftKey,
+      key = event.key;
+    if (key === 'Enter' || key === ' ') {
+      setA11yDragMode(function (prevVal) {
+        return !prevVal;
+      });
+    } else if (a11yDragMode) {
+      var distanceToMove = shiftKey ? 128 : 32;
+      switch (key) {
+        case 'ArrowLeft':
+          handleDrag(distanceToMove * -1, 0);
+          break;
+        case 'ArrowRight':
+          handleDrag(distanceToMove, 0);
+          break;
+        case 'ArrowUp':
+          handleDrag(0, distanceToMove * -1);
+          break;
+        case 'ArrowDown':
+          handleDrag(0, distanceToMove);
+          break;
+        default:
+          break;
+      }
+    }
+  };
   var styledTune = {};
-  // TODO: check this... this feels like it should be in a hook with no dep array.
   if (isBeacon || isDraggable) {
     if (coachmark.targetRect) {
       styledTune = {
@@ -71,33 +106,94 @@ export var CoachmarkOverlay = /*#__PURE__*/forwardRef(function (_ref, ref) {
       styledTune.top += offsetTune.top;
     }
   }
+  function handleDragBounds(x, y) {
+    var xRes = x;
+    var yRes = y;
+    var xMax = winWidth - 288;
+    var yMax = winHeight - 150;
+    if (xRes < 0) {
+      xRes = 0;
+    } else if (xRes > xMax) {
+      xRes = xMax;
+    }
+    if (yRes < 0) {
+      yRes = 0;
+    } else if (yRes > yMax) {
+      yRes = yMax;
+    }
+    return {
+      targetX: xRes,
+      targetY: yRes
+    };
+  }
   function handleDrag(movementX, movementY) {
     var overlay = overlayRef.current;
     var _overlay$getBoundingC = overlay.getBoundingClientRect(),
       x = _overlay$getBoundingC.x,
       y = _overlay$getBoundingC.y;
+    var _handleDragBounds = handleDragBounds(x + movementX, y + movementY),
+      targetX = _handleDragBounds.targetX,
+      targetY = _handleDragBounds.targetY;
     overlay.style.transform = 'none';
     overlay.style.position = 'fixed';
-    overlay.style.left = "".concat(x + movementX, "px");
-    overlay.style.top = "".concat(y + movementY, "px");
+    overlay.style.left = "".concat(targetX, "px");
+    overlay.style.top = "".concat(targetY, "px");
     overlay.style.bottom = 'auto';
   }
+  var contentId = uuidv4();
   return /*#__PURE__*/React.createElement("div", _extends({}, rest, {
-    className: cx(blockClass, "".concat(blockClass, "--").concat(kind), "".concat(blockClass, "__").concat(theme), (isBeacon || isDraggable) && "".concat(blockClass, "--").concat(coachmark.align), fixedIsVisible && "".concat(blockClass, "--is-visible"), className),
+    className: cx(blockClass, "".concat(blockClass, "--").concat(kind), "".concat(blockClass, "__").concat(theme), (isBeacon || isDraggable) && "".concat(blockClass, "--").concat(coachmark.align), fixedIsVisible && "".concat(blockClass, "--is-visible"), a11yDragMode && "".concat(blockClass, "--is-dragmode"), className),
     ref: overlayRef,
-    style: styledTune
+    style: styledTune,
+    "aria-labelledby": contentId,
+    tabIndex: -1
   }, getDevtoolsProps(componentName)), isDraggable ? /*#__PURE__*/React.createElement(CoachmarkDragbar, {
+    a11yKeyboardHandler: handleKeyPress,
+    onBlur: function onBlur() {
+      return setA11yDragMode(false);
+    },
     onDrag: handleDrag,
+    theme: theme,
     onClose: onClose
   }) : /*#__PURE__*/React.createElement(CoachmarkHeader, {
     onClose: onClose
   }), /*#__PURE__*/React.createElement("div", {
     className: "".concat(blockClass, "__body"),
-    ref: ref
-  }, children), isBeacon && /*#__PURE__*/React.createElement("span", {
+    ref: ref,
+    id: contentId
+  }, React.Children.map(children, function (child) {
+    return /*#__PURE__*/React.cloneElement(child, {
+      isVisible: isVisible
+    });
+  })), isBeacon && /*#__PURE__*/React.createElement("span", {
     className: "".concat(blockClass, "__caret")
   }));
 });
+function getWindowDimensions() {
+  var _window = window,
+    winWidth = _window.innerWidth,
+    winHeight = _window.innerHeight;
+  return {
+    winWidth: winWidth,
+    winHeight: winHeight
+  };
+}
+var useWindowDimensions = function useWindowDimensions() {
+  var _useState3 = useState(getWindowDimensions()),
+    _useState4 = _slicedToArray(_useState3, 2),
+    windowDimensions = _useState4[0],
+    setWindowDimensions = _useState4[1];
+  useEffect(function () {
+    function handleResize() {
+      setWindowDimensions(getWindowDimensions());
+    }
+    window.addEventListener('resize', handleResize);
+    return function () {
+      return window.removeEventListener('resize', handleResize);
+    };
+  }, []);
+  return windowDimensions;
+};
 
 // Return a placeholder if not released and not enabled by feature flag
 CoachmarkOverlay = pkg.checkComponentEnabled(CoachmarkOverlay, componentName);

package/es/components/CoachmarkBeacon/CoachmarkBeacon.js

@@ -47,14 +47,17 @@ export var CoachmarkBeacon = /*#__PURE__*/React.forwardRef(function (_ref, ref)
     className: cx(blockClass, "".concat(blockClass, "-").concat(kind), className),
     ref: ref,
     style: overlayPositionStyle
-  }, getDevtoolsProps(componentName)), /*#__PURE__*/React.createElement("button", _extends({
+  }, getDevtoolsProps(componentName), {
+    role: "tooltip"
+  }), /*#__PURE__*/React.createElement("button", _extends({
     tabIndex: 0,
     type: "button"
   }, coachmark.buttonProps, {
     "aria-label": label,
     className: "".concat(blockClass, "__target")
   }), /*#__PURE__*/React.createElement("svg", {
-    className: "".concat(blockClass, "__center")
+    className: "".concat(blockClass, "__center"),
+    alt: ""
   }, /*#__PURE__*/React.createElement("circle", {
     r: 1,
     cx: 38,

package/es/components/CoachmarkFixed/CoachmarkFixed.js

@@ -10,7 +10,7 @@ var _excluded = ["children", "className", "onClose", "portalTarget", "tagline",
  */
 
 // Import portions of React that are needed.
-import React, { useEffect, useRef, useState } from 'react';
+import React, { useEffect, useRef, useState, useCallback } from 'react';
 
 // Other standard imports.
 import PropTypes from 'prop-types';
@@ -24,7 +24,9 @@ import { getDevtoolsProps } from '../../global/js/utils/devtools';
 import { pkg /*, carbon */ } from '../../settings';
 
 // The block part of our conventional BEM class names (blockClass__E--M).
-var blockClass = "".concat(pkg.prefix, "--coachmark-fixed");
+var coachmarkClass = "".concat(pkg.prefix, "--coachmark");
+var blockClass = "".concat(coachmarkClass, "-fixed");
+var overlayBlockClass = "".concat(coachmarkClass, "-overlay");
 var componentName = 'CoachmarkFixed';
 var defaults = {
   onClose: function onClose() {},
@@ -75,9 +77,14 @@ export var CoachmarkFixed = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     _useState10 = _slicedToArray(_useState9, 2),
     fixedIsVisible = _useState10[0],
     setFixedIsVisible = _useState10[1];
-  var handleClose = function handleClose() {
-    setFixedIsVisible(false);
-  };
+  var prefersReducedMotion = window.matchMedia('(prefers-reduced-motion: reduce)');
+  var handleClose = useCallback(function () {
+    if (prefersReducedMotion.matches) {
+      setIsOpen(false);
+    } else {
+      setFixedIsVisible(false);
+    }
+  }, [prefersReducedMotion.matches]);
   var handleTransitionEnd = function handleTransitionEnd(e) {
     if (e.propertyName === 'transform' && !fixedIsVisible) {
       setIsOpen(false);
@@ -94,9 +101,21 @@ export var CoachmarkFixed = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     setIsOpen(false);
     setShouldResetPosition(true);
   };
+  var escFunction = useCallback(function (event) {
+    if (event.key === 'Escape') {
+      handleClose();
+    }
+  }, [handleClose]);
+  useEffect(function () {
+    document.addEventListener('keydown', escFunction, false);
+    return function () {
+      document.removeEventListener('keydown', escFunction, false);
+    };
+  }, [escFunction]);
   var contextValue = {
     buttonProps: {
       'aria-expanded': isOpen,
+      tabIndex: 0,
       onClick: handleTargetClick,
       // Compensate for accidental open/close on double-click.
       // Only open on double-click.
@@ -151,7 +170,8 @@ export var CoachmarkFixed = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     kind: COACHMARK_OVERLAY_KIND.FIXED,
     onClose: handleClose,
     onTransitionEnd: handleTransitionEnd,
-    theme: theme
+    theme: theme,
+    className: cx(fixedIsVisible && "".concat(overlayBlockClass, "--is-visible"), overlayBlockClass)
   }, children), portalNode)));
 });
 

package/es/components/CoachmarkOverlayElements/CoachmarkOverlayElements.js

@@ -1,7 +1,7 @@
 import _extends from "@babel/runtime/helpers/extends";
 import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
-var _excluded = ["className", "children", "media", "nextButtonText", "previousButtonLabel", "closeButtonLabel"];
+var _excluded = ["className", "children", "isVisible", "media", "nextButtonText", "previousButtonLabel", "closeButtonLabel"];
 /**
  * Copyright IBM Corp. 2023, 2023
  *
@@ -27,6 +27,7 @@ import { pkg /*, carbon */ } from '../../settings';
 var blockClass = "".concat(pkg.prefix, "--coachmark-overlay-elements");
 var componentName = 'CoachmarkOverlayElements';
 var defaults = {
+  isVisible: false,
   nextButtonText: 'Next',
   previousButtonLabel: 'Back',
   closeButtonLabel: 'Got it'
@@ -39,6 +40,8 @@ var defaults = {
 export var CoachmarkOverlayElements = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   var className = _ref.className,
     children = _ref.children,
+    _ref$isVisible = _ref.isVisible,
+    isVisible = _ref$isVisible === void 0 ? defaults.isVisible : _ref$isVisible,
     media = _ref.media,
     _ref$nextButtonText = _ref.nextButtonText,
     nextButtonText = _ref$nextButtonText === void 0 ? defaults.nextButtonText : _ref$nextButtonText,
@@ -56,8 +59,16 @@ export var CoachmarkOverlayElements = /*#__PURE__*/React.forwardRef(function (_r
   var _useState3 = useState(0),
     _useState4 = _slicedToArray(_useState3, 2),
     currentProgStep = _useState4[0],
-    setCurrentProgStep = _useState4[1];
+    _setCurrentProgStep = _useState4[1];
   var coachmark = useCoachmark();
+  var setCurrentProgStep = function setCurrentProgStep(value) {
+    if (currentProgStep > 0 && value === 0 && buttonFocusRef.current) {
+      setTimeout(function () {
+        buttonFocusRef.current.focus();
+      }, 1000);
+    }
+    _setCurrentProgStep(value);
+  };
   var numProgSteps = Children.count(children);
   var progStepFloor = 0;
   var progStepCeil = numProgSteps - 1;
@@ -68,6 +79,13 @@ export var CoachmarkOverlayElements = /*#__PURE__*/React.forwardRef(function (_r
       buttonFocusRef.current.focus();
     }
   }, []);
+  useEffect(function () {
+    setTimeout(function () {
+      if (buttonFocusRef.current && isVisible) {
+        buttonFocusRef.current.focus();
+      }
+    }, 100);
+  }, [isVisible]);
   if (!coachmark) {
     return pconsole.warn("The ".concat(componentName, " is a composable container element which should be used only within the scope of a Coachmark or a CoachmarkFixed component."));
   }
@@ -91,7 +109,9 @@ export var CoachmarkOverlayElements = /*#__PURE__*/React.forwardRef(function (_r
     className: cx("".concat(blockClass, "__footer"), 'coachmark-carousel-controls')
   }, /*#__PURE__*/React.createElement(Button, _extends({
     size: "sm"
-  }, coachmark.closeButtonProps), closeButtonLabel))) : /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Carousel, {
+  }, coachmark.closeButtonProps, {
+    ref: buttonFocusRef
+  }), closeButtonLabel))) : /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Carousel, {
     disableArrowScroll: true,
     ref: scrollRef
   }, children), /*#__PURE__*/React.createElement("div", {
@@ -154,6 +174,11 @@ CoachmarkOverlayElements.propTypes = {
    * The label for the Close button.
    */
   closeButtonLabel: PropTypes.string,
+  /**
+   * The visibility of CoachmarkOverlayElements is
+   * managed in the parent component.
+   */
+  isVisible: PropTypes.bool,
   /**
    * The object describing an image in one of two shapes.
    * If a single media element is required, use `{render}`.

package/es/components/CoachmarkStack/CoachmarkStack.js

@@ -9,7 +9,7 @@ var _excluded = ["children", "className", "onClose", "description", "media", "na
  * LICENSE file in the root directory of this source tree.
  */
 
-import React, { Children, useEffect, useRef, useState } from 'react';
+import React, { Children, useEffect, useRef, useState, useCallback } from 'react';
 import { createPortal } from 'react-dom';
 import PropTypes from 'prop-types';
 import cx from 'classnames';
@@ -88,7 +88,18 @@ export var CoachmarkStack = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   var handleClickNavItem = function handleClickNavItem(itemNumber) {
     setSelectedItemNumber(itemNumber);
   };
-  var handleClose = function handleClose(isParentCloseButton) {
+  var escFunction = useCallback(function (event) {
+    if (event.key === 'Escape') {
+      selectedItemNumber === 0 ? handleClose(true) : handleClose(false);
+    }
+  }, [handleClose, selectedItemNumber]);
+  useEffect(function () {
+    document.addEventListener('keydown', escFunction, false);
+    return function () {
+      document.removeEventListener('keydown', escFunction, false);
+    };
+  }, [escFunction]);
+  var handleClose = useCallback(function (isParentCloseButton) {
     if (isParentCloseButton) {
       // Trigger slide-out animation
       setSelectedItemNumber(-1);
@@ -105,9 +116,10 @@ export var CoachmarkStack = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       // Unstack child
       setSelectedItemNumber(0);
     }
-  };
+  }, [onClose]);
   var contextValue = {
     buttonProps: {
+      tabIndex: 0,
       'aria-expanded': isOpen,
       onClick: function onClick() {
         setIsOpen(true);
@@ -134,7 +146,7 @@ export var CoachmarkStack = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   useEffect(function () {
     setTimeout(function () {
       if (stackHomeRef.current) {
-        setParentHeight(stackHomeRef.current.clientHeight);
+        setParentHeight(stackHomeRef.current.clientHeight + 16);
       }
     }, 0);
   }, [stackHomeRef]);
@@ -145,10 +157,12 @@ export var CoachmarkStack = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     }
     stackHomeRef.current.style.height = "".concat(parentHeight, "px");
     if (!isOpen || targetSelectedItem < 0) {
+      stackHomeRef.current.focus();
       return;
     }
     var targetHomeHeight = stackedCoachmarkRefs.current[targetSelectedItem].clientHeight;
     stackHomeRef.current.style.height = "".concat(targetHomeHeight, "px");
+    stackedCoachmarkRefs.current[targetSelectedItem].focus();
   }, [selectedItemNumber, isOpen, parentHeight]);
   var wrappedChildren = Children.map(childArray, function (child, idx) {
     var mountedClass = mountedRef.current ? "".concat(elementBlockClass, "--is-mounted") : '';
@@ -177,6 +191,7 @@ export var CoachmarkStack = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   }), /*#__PURE__*/React.createElement(CoachmarkStackHome, {
     ref: stackHomeRef,
     className: cx("".concat(pkg.prefix, "--coachmark-overlay"), "".concat(pkg.prefix, "--coachmark-overlay__").concat(theme), elementBlockClass, selectedItemNumber > 0 && "".concat(elementBlockClass, "--is-stacked"), selectedItemNumber > 0 && "".concat(elementBlockClass, "--is-stacked__").concat(theme), isOpen && "".concat(elementBlockClass, "--is-visible"), mountedRef.current && "".concat(elementBlockClass, "--is-mounted")),
+    isOpen: isOpen && selectedItemNumber < 1,
     description: description,
     media: media,
     navLinkLabels: navLinkLabels,

package/es/components/CoachmarkStack/CoachmarkStackHome.js

@@ -1,6 +1,7 @@
 import _extends from "@babel/runtime/helpers/extends";
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
-var _excluded = ["className", "description", "media", "navLinkLabels", "onClickNavItem", "onClose", "portalTarget", "closeButtonLabel", "title"];
+var _excluded = ["className", "description", "isOpen", "media", "navLinkLabels", "onClickNavItem", "onClose", "portalTarget", "closeButtonLabel", "title"];
 /**
  * Copyright IBM Corp. 2023, 2023
  *
@@ -8,7 +9,7 @@ var _excluded = ["className", "description", "media", "navLinkLabels", "onClickN
  * LICENSE file in the root directory of this source tree.
  */
 
-import React, { forwardRef } from 'react';
+import React, { forwardRef, useRef, useEffect, useState } from 'react';
 import pconsole from '../../global/js/utils/pconsole';
 import PropTypes from 'prop-types';
 import cx from 'classnames';
@@ -36,14 +37,27 @@ export var CoachmarkStackHome = /*#__PURE__*/forwardRef(function (_ref, ref) {
   var _document$querySelect;
   var className = _ref.className,
     description = _ref.description,
+    isOpen = _ref.isOpen,
     media = _ref.media,
     navLinkLabels = _ref.navLinkLabels,
     onClickNavItem = _ref.onClickNavItem,
-    onClose = _ref.onClose,
+    _onClose = _ref.onClose,
     portalTarget = _ref.portalTarget,
     closeButtonLabel = _ref.closeButtonLabel,
     title = _ref.title,
     rest = _objectWithoutProperties(_ref, _excluded);
+  var buttonFocusRef = useRef();
+  var _useState = useState(0),
+    _useState2 = _slicedToArray(_useState, 2),
+    linkFocusIndex = _useState2[0],
+    setLinkFocusIndex = _useState2[1];
+  useEffect(function () {
+    setTimeout(function () {
+      if (isOpen && buttonFocusRef.current) {
+        buttonFocusRef.current.focus();
+      }
+    }, 100);
+  }, [isOpen]);
   if (!navLinkLabels) {
     return pconsole.warn("".concat(componentName, " is a Novice to Pro internal component and is not intended for general use."));
   }
@@ -53,7 +67,10 @@ export var CoachmarkStackHome = /*#__PURE__*/forwardRef(function (_ref, ref) {
     ref: ref,
     role: "main"
   }, getDevtoolsProps(componentName)), /*#__PURE__*/React.createElement(CoachmarkHeader, {
-    onClose: onClose
+    onClose: function onClose() {
+      setLinkFocusIndex(0);
+      _onClose();
+    }
   }), /*#__PURE__*/React.createElement("div", {
     className: "".concat(overlayClass, "__body")
   }, /*#__PURE__*/React.createElement("div", {
@@ -73,21 +90,34 @@ export var CoachmarkStackHome = /*#__PURE__*/forwardRef(function (_ref, ref) {
   }, description)), /*#__PURE__*/React.createElement("ul", {
     className: "".concat(blockClass, "__nav-links")
   }, navLinkLabels.map(function (label, index) {
+    if (index === linkFocusIndex) {
+      return renderNavLink(index, label, buttonFocusRef);
+    } else {
+      return renderNavLink(index, label);
+    }
+  })), closeButtonLabel && /*#__PURE__*/React.createElement("div", {
+    className: "".concat(overlayClass, "__footer")
+  }, /*#__PURE__*/React.createElement(Button, {
+    size: "sm",
+    onClick: function onClick() {
+      setLinkFocusIndex(0);
+      _onClose();
+    }
+  }, closeButtonLabel))))), portalNode);
+  function renderNavLink(index, label) {
+    var ref = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : null;
     return /*#__PURE__*/React.createElement("li", {
       key: index
     }, /*#__PURE__*/React.createElement(Button, {
       kind: "ghost",
       size: "sm",
       onClick: function onClick() {
+        setLinkFocusIndex(index);
         onClickNavItem(index + 1);
-      }
+      },
+      ref: ref
     }, label));
-  })), closeButtonLabel && /*#__PURE__*/React.createElement("div", {
-    className: "".concat(overlayClass, "__footer")
-  }, /*#__PURE__*/React.createElement(Button, {
-    size: "sm",
-    onClick: onClose
-  }, closeButtonLabel))))), portalNode);
+  }
 });
 
 // Return a placeholder if not released and not enabled by feature flag
@@ -113,6 +143,10 @@ CoachmarkStackHome.propTypes = {
    * The description of the Coachmark.
    */
   description: PropTypes.node.isRequired,
+  /**
+   * If the stack home is open.
+   */
+  isOpen: PropTypes.bool.isRequired,
   /**
    * The object describing an image in one of two shapes.
    *