@carbon/ibm-products 2.47.0 → 2.48.0

package/lib/components/AddSelect/index.d.ts

@@ -1 +1,2 @@
-export { AddSelect } from "./AddSelect";
+export { AddSelect } from './AddSelect';
+export type { AddSelectProps } from './AddSelect';

package/lib/components/Card/Card.d.ts

@@ -55,6 +55,7 @@ interface CardProp extends PropsWithChildren {
     secondaryButtonPlacement?: 'top' | 'bottom';
     secondaryButtonText?: string;
     sequence?: number;
+    iconDescription?: string;
     /**
      * **Experimental?** For all cases a `Slug` component can be provided.
      * Clickable tiles only accept a boolean value of true and display a hollow slug.

package/lib/components/Card/Card.js

@@ -25,7 +25,7 @@ var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
 
 var _Incomplete, _CheckmarkOutline;
-var _excluded = ["actionIcons", "actionsPlacement", "metadata", "children", "className", "clickZone", "description", "disabled", "footerActionIcon", "getStarted", "label", "media", "mediaPosition", "onClick", "onKeyDown", "onPrimaryButtonClick", "overflowActions", "overflowAriaLabel", "onSecondaryButtonClick", "pictogram", "primaryButtonDisabled", "primaryButtonHref", "primaryButtonIcon", "primaryButtonKind", "primaryButtonPlacement", "primaryButtonText", "productive", "secondaryButtonDisabled", "secondaryButtonHref", "secondaryButtonIcon", "secondaryButtonKind", "secondaryButtonPlacement", "secondaryButtonText", "slug", "status", "sequence", "title", "titleSize"],
+var _excluded = ["actionIcons", "actionsPlacement", "metadata", "children", "className", "clickZone", "description", "disabled", "footerActionIcon", "getStarted", "label", "media", "mediaPosition", "onClick", "onKeyDown", "onPrimaryButtonClick", "overflowActions", "overflowAriaLabel", "onSecondaryButtonClick", "pictogram", "primaryButtonDisabled", "primaryButtonHref", "primaryButtonIcon", "primaryButtonKind", "primaryButtonPlacement", "primaryButtonText", "productive", "secondaryButtonDisabled", "secondaryButtonHref", "secondaryButtonIcon", "secondaryButtonKind", "secondaryButtonPlacement", "secondaryButtonText", "slug", "status", "sequence", "title", "titleSize", "iconDescription"],
   _excluded2 = ["id"],
   _excluded3 = ["id", "icon", "onClick", "iconDescription", "href"];
 var componentName = 'Card';
@@ -80,6 +80,8 @@ var Card = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     title = _ref.title,
     _ref$titleSize = _ref.titleSize,
     titleSize = _ref$titleSize === void 0 ? 'default' : _ref$titleSize,
+    _ref$iconDescription = _ref.iconDescription,
+    iconDescription = _ref$iconDescription === void 0 ? 'Options' : _ref$iconDescription,
     rest = _rollupPluginBabelHelpers.objectWithoutProperties(_ref, _excluded);
   var getIcons = function getIcons() {
     return getStarted ? metadata : actionIcons;
@@ -109,7 +111,8 @@ var Card = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
         size: size,
         direction: pos,
         flipped: true,
-        "aria-label": overflowAriaLabel
+        "aria-label": overflowAriaLabel,
+        iconDescription: iconDescription
       }, overflowActions.map(function (_ref2) {
         var id = _ref2.id,
           rest = _rollupPluginBabelHelpers.objectWithoutProperties(_ref2, _excluded2);

package/lib/components/Carousel/index.d.ts

@@ -1,2 +1,9 @@
-export { Carousel } from "./Carousel";
-export { CarouselItem } from "./CarouselItem";
+/**
+ * Copyright IBM Corp. 2023, 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.
+ */
+export { Carousel } from './Carousel';
+export { CarouselItem } from './CarouselItem';
+export type { CarouselProps } from './Carousel';

package/lib/components/Cascade/Cascade.d.ts

@@ -1,5 +1,5 @@
 import React, { ReactNode } from 'react';
-interface CascadeProps {
+export interface CascadeProps {
     children: ReactNode;
     /**
      * Specify an optional className to be applied to
@@ -25,4 +25,3 @@ page as that will distract the user.
 export declare let Cascade: React.ForwardRefExoticComponent<CascadeProps & {
     children?: React.ReactNode;
 } & React.RefAttributes<HTMLDivElement>>;
-export {};

package/lib/components/Cascade/Cascade.js

@@ -12,10 +12,10 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
 var React = require('react');
 var react = require('@carbon/react');
-var cx = require('classnames');
 var index = require('../../node_modules/prop-types/index.js');
-var settings = require('../../settings.js');
+var cx = require('classnames');
 var devtools = require('../../global/js/utils/devtools.js');
+var settings = require('../../settings.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 

package/lib/components/Cascade/index.d.ts

@@ -1 +1,2 @@
-export { Cascade } from "./Cascade";
+export { Cascade } from './Cascade';
+export type { CascadeProps } from './Cascade';

package/lib/components/Checklist/Checklist.d.ts

@@ -11,9 +11,9 @@
  *   ModifiedTabs (ModifiedTabLabelNew, ModifiedTabLabelWithClose)
  *   PageHeader (PageHeaderTitle, PageHeaderUtils)
  */
-import React, { ReactNode } from 'react';
 import { IconButton } from '@carbon/react';
 import { Kind, Theme } from './Checklist.types';
+import React, { ReactNode } from 'react';
 type Task = {
     kind: Kind;
     label: string;
@@ -23,7 +23,7 @@ type TaskList = {
     title?: string;
     tasks: Array<Task>;
 };
-interface ChecklistProps {
+export interface ChecklistProps {
     /**
      * Define both `chartLabel` and `chartValue` to show the chart and its label together.
      */

package/lib/components/Checklist/Checklist.js

@@ -10,17 +10,17 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
+var react = require('@carbon/react');
+var Checklist_types = require('./Checklist.types.js');
 var React = require('react');
+var ChecklistChart = require('./ChecklistChart.js');
+var ChecklistIcon = require('./ChecklistIcon.js');
+var icons = require('@carbon/react/icons');
 var index = require('../../node_modules/prop-types/index.js');
 var cx = require('classnames');
 var devtools = require('../../global/js/utils/devtools.js');
-var uuidv4 = require('../../global/js/utils/uuidv4.js');
 var settings = require('../../settings.js');
-var react = require('@carbon/react');
-var icons = require('@carbon/react/icons');
-var ChecklistIcon = require('./ChecklistIcon.js');
-var ChecklistChart = require('./ChecklistChart.js');
-var Checklist_types = require('./Checklist.types.js');
+var uuidv4 = require('../../global/js/utils/uuidv4.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 

package/lib/components/Checklist/index.d.ts

@@ -1 +1,8 @@
-export { Checklist } from "./Checklist";
+/**
+ * Copyright IBM Corp. 2023, 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.
+ */
+export { Checklist } from './Checklist';
+export type { ChecklistProps } from './Checklist';

package/lib/components/Coachmark/Coachmark.d.ts

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import React, { MutableRefObject, ReactNode } from 'react';
-interface CoachmarkProps {
+export interface CoachmarkProps {
     /**
      * Where to render the Coachmark relative to its target.
      * Applies only to Floating and Tooltip Coachmarks.
@@ -72,4 +72,3 @@ interface CoachmarkProps {
  * user to gain understanding of the product's main value and discover new use cases.
  */
 export declare let Coachmark: React.ForwardRefExoticComponent<CoachmarkProps & React.RefAttributes<HTMLElement>>;
-export {};

package/lib/components/Coachmark/Coachmark.js

@@ -11,13 +11,13 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
 var React = require('react');
-var cx = require('classnames');
+var hooks = require('./utils/hooks.js');
+var enums = require('./utils/enums.js');
+var context = require('./utils/context.js');
+var CoachmarkOverlay = require('./CoachmarkOverlay.js');
 var index = require('../../node_modules/prop-types/index.js');
 var reactDom = require('react-dom');
-var CoachmarkOverlay = require('./CoachmarkOverlay.js');
-var context = require('./utils/context.js');
-var enums = require('./utils/enums.js');
-var hooks = require('./utils/hooks.js');
+var cx = require('classnames');
 var devtools = require('../../global/js/utils/devtools.js');
 var settings = require('../../settings.js');
 var lodash = require('lodash');

package/lib/components/Coachmark/index.d.ts

@@ -1,3 +1,10 @@
-export { Coachmark } from "./Coachmark";
-export { useCoachmark } from "./utils/context";
-export { BEACON_KIND, COACHMARK_OVERLAY_KIND, COACHMARK_ALIGNMENT } from "./utils/enums";
+/**
+ * Copyright IBM Corp. 2023, 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.
+ */
+export { Coachmark } from './Coachmark';
+export { BEACON_KIND, COACHMARK_OVERLAY_KIND, COACHMARK_ALIGNMENT, } from './utils/enums';
+export { useCoachmark } from './utils/context';
+export type { CoachmarkProps } from './Coachmark';

package/lib/components/CoachmarkBeacon/CoachmarkBeacon.d.ts

@@ -4,9 +4,9 @@
  * 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 React from 'react';
 import { BEACON_KIND } from '../Coachmark';
-interface CoachmarkBeaconProps {
+import React from 'react';
+export interface CoachmarkBeaconProps {
     /**
      * Optional class name for this component.
      */
@@ -26,4 +26,3 @@ interface CoachmarkBeaconProps {
  * Use beacon for the target prop of a Coachmark component.
  */
 export declare let CoachmarkBeacon: React.ForwardRefExoticComponent<CoachmarkBeaconProps & React.RefAttributes<HTMLDivElement>>;
-export {};

package/lib/components/CoachmarkBeacon/CoachmarkBeacon.js

@@ -10,12 +10,13 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
-var React = require('react');
+require('../Coachmark/Coachmark.js');
+var context = require('../Coachmark/utils/context.js');
 var index = require('../../node_modules/prop-types/index.js');
+var React = require('react');
 var cx = require('classnames');
 var devtools = require('../../global/js/utils/devtools.js');
 var settings = require('../../settings.js');
-var context = require('../Coachmark/utils/context.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -57,7 +58,7 @@ exports.CoachmarkBeacon = /*#__PURE__*/React__default["default"].forwardRef(func
     className: "".concat(blockClass, "__target")
   }), /*#__PURE__*/React__default["default"].createElement("svg", {
     className: "".concat(blockClass, "__center")
-  }, _circle || (_circle = /*#__PURE__*/React__default["default"].createElement("circle", {
+  }, /*#__PURE__*/React__default["default"].createElement("title", null, label), _circle || (_circle = /*#__PURE__*/React__default["default"].createElement("circle", {
     r: 1,
     cx: 38,
     cy: 38

package/lib/components/CoachmarkBeacon/index.d.ts

@@ -1 +1,8 @@
-export { CoachmarkBeacon } from "./CoachmarkBeacon";
+/**
+ * Copyright IBM Corp. 2023, 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.
+ */
+export { CoachmarkBeacon } from './CoachmarkBeacon';
+export type { CoachmarkBeaconProps } from './CoachmarkBeacon';

package/lib/components/CoachmarkButton/CoachmarkButton.d.ts

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import React from 'react';
-interface CoachmarkButtonProps {
+export interface CoachmarkButtonProps {
     /**
      * Provide an optional class to be applied to the containing node.
      */
@@ -19,4 +19,3 @@ interface CoachmarkButtonProps {
  * Use CoachmarkButton for the target prop of a Coachmark component.
  */
 export declare let CoachmarkButton: React.ForwardRefExoticComponent<CoachmarkButtonProps & React.RefAttributes<HTMLButtonElement>>;
-export {};

package/lib/components/CoachmarkButton/CoachmarkButton.js

@@ -10,12 +10,13 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
-var React = require('react');
+var react = require('@carbon/react');
 var index = require('../../node_modules/prop-types/index.js');
+var React = require('react');
 var cx = require('classnames');
 var devtools = require('../../global/js/utils/devtools.js');
 var settings = require('../../settings.js');
-var react = require('@carbon/react');
+require('../Coachmark/Coachmark.js');
 var context = require('../Coachmark/utils/context.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
@@ -25,6 +26,7 @@ var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
 
 var _div;
 var _excluded = ["className", "label"];
+
 // Carbon and package components we use.
 /* TODO: @import(s) of carbon components and other package components. */
 

package/lib/components/CoachmarkButton/index.d.ts

@@ -1 +1,8 @@
-export { CoachmarkButton } from "./CoachmarkButton";
+/**
+ * Copyright IBM Corp. 2023, 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.
+ */
+export { CoachmarkButton } from './CoachmarkButton';
+export type { CoachmarkButtonProps } from './CoachmarkButton';

package/lib/components/CoachmarkFixed/CoachmarkFixed.d.ts

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import React, { ReactNode } from 'react';
-interface CoachmarkFixedProps {
+export interface CoachmarkFixedProps {
     /**
      * CoachmarkFixed should use a single CoachmarkOverlayElements component as a child.
      */
@@ -45,4 +45,3 @@ interface CoachmarkFixedProps {
  * This variant allows the a coachmark overlay to be displayed by interacting with the tagline.
  */
 export declare let CoachmarkFixed: React.ForwardRefExoticComponent<CoachmarkFixedProps & React.RefAttributes<HTMLDivElement>>;
-export {};

package/lib/components/CoachmarkFixed/CoachmarkFixed.js

@@ -11,15 +11,15 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
 var React = require('react');
+var enums = require('../Coachmark/utils/enums.js');
+var context = require('../Coachmark/utils/context.js');
+var CoachmarkOverlay = require('../Coachmark/CoachmarkOverlay.js');
+var CoachmarkTagline = require('../Coachmark/CoachmarkTagline.js');
 var index = require('../../node_modules/prop-types/index.js');
+var reactDom = require('react-dom');
 var cx = require('classnames');
 var devtools = require('../../global/js/utils/devtools.js');
 var settings = require('../../settings.js');
-var reactDom = require('react-dom');
-var CoachmarkOverlay = require('../Coachmark/CoachmarkOverlay.js');
-var CoachmarkTagline = require('../Coachmark/CoachmarkTagline.js');
-var context = require('../Coachmark/utils/context.js');
-var enums = require('../Coachmark/utils/enums.js');
 var framerMotion = require('framer-motion');
 var useIsomorphicEffect = require('../../global/js/hooks/useIsomorphicEffect.js');
 
@@ -29,6 +29,7 @@ var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
 
 var _excluded = ["children", "className", "onClose", "portalTarget", "tagline", "theme"];
+
 // Carbon and package components we use.
 /* TODO: @import(s) of carbon components and other package components. */
 

package/lib/components/CoachmarkFixed/index.d.ts

@@ -1 +1,8 @@
-export { CoachmarkFixed } from "./CoachmarkFixed";
+/**
+ * Copyright IBM Corp. 2023, 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.
+ */
+export { CoachmarkFixed } from './CoachmarkFixed';
+export type { CoachmarkFixedProps } from './CoachmarkFixed';

package/lib/components/CoachmarkOverlayElement/CoachmarkOverlayElement.d.ts

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import React, { ReactNode } from 'react';
-interface CoachmarkOverlayElementProps {
+export interface CoachmarkOverlayElementProps {
     /**
      * An optional button can be rendered below the description.
      * This can be a link, button, Coachmark button, etc.
@@ -30,4 +30,3 @@ interface CoachmarkOverlayElementProps {
  * in a carousel fashion.
  */
 export declare let CoachmarkOverlayElement: React.ForwardRefExoticComponent<CoachmarkOverlayElementProps & React.RefAttributes<HTMLDivElement>>;
-export {};

package/lib/components/CoachmarkOverlayElement/index.d.ts

@@ -1 +1,8 @@
-export { CoachmarkOverlayElement } from "./CoachmarkOverlayElement";
+/**
+ * Copyright IBM Corp. 2023, 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.
+ */
+export { CoachmarkOverlayElement } from './CoachmarkOverlayElement';
+export type { CoachmarkOverlayElementProps } from './CoachmarkOverlayElement';

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

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import React, { ReactNode } from 'react';
-interface CoachmarkOverlayElementsProps {
+export interface CoachmarkOverlayElementsProps {
     /**
      * CoachmarkOverlayElements should be used with one or many CoachmarkOverlayElement components as children.
      * @see CoachmarkOverlayElement
@@ -47,4 +47,3 @@ interface CoachmarkOverlayElementsProps {
  * components in a carousel fashion.
  */
 export declare let CoachmarkOverlayElements: React.ForwardRefExoticComponent<CoachmarkOverlayElementsProps & React.RefAttributes<HTMLDivElement>>;
-export {};

package/lib/components/CoachmarkOverlayElements/CoachmarkOverlayElements.js

@@ -10,17 +10,19 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
+var react = require('@carbon/react');
 var React = require('react');
+var Carousel = require('../Carousel/Carousel.js');
+require('../Carousel/CarouselItem.js');
 var index = require('../../node_modules/prop-types/index.js');
+var SteppedAnimatedMedia = require('../SteppedAnimatedMedia/SteppedAnimatedMedia.js');
+var lodash = require('lodash');
 var cx = require('classnames');
 var devtools = require('../../global/js/utils/devtools.js');
-var settings = require('../../settings.js');
-var react = require('@carbon/react');
-var lodash = require('lodash');
 var pconsole = require('../../global/js/utils/pconsole.js');
+var settings = require('../../settings.js');
+require('../Coachmark/Coachmark.js');
 var context = require('../Coachmark/utils/context.js');
-var SteppedAnimatedMedia = require('../SteppedAnimatedMedia/SteppedAnimatedMedia.js');
-var Carousel = require('../Carousel/Carousel.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -28,6 +30,7 @@ var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
 
 var _excluded = ["className", "children", "isVisible", "media", "nextButtonText", "previousButtonLabel", "closeButtonLabel"];
+
 // The block part of our conventional BEM class names (blockClass__E--M).
 var blockClass = "".concat(settings.pkg.prefix, "--coachmark-overlay-elements");
 var componentName = 'CoachmarkOverlayElements';
@@ -80,7 +83,8 @@ exports.CoachmarkOverlayElements = /*#__PURE__*/React__default["default"].forwar
   var setCurrentProgStep = function setCurrentProgStep(value) {
     if (currentProgStep > 0 && value === 0 && buttonFocusRef.current) {
       setTimeout(function () {
-        buttonFocusRef.current.focus();
+        var _buttonFocusRef$curre;
+        (_buttonFocusRef$curre = buttonFocusRef.current) === null || _buttonFocusRef$curre === void 0 || _buttonFocusRef$curre.focus();
       }, 1000);
     }
     _setCurrentProgStep(value);

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

@@ -1 +1,8 @@
-export { CoachmarkOverlayElements } from "./CoachmarkOverlayElements";
+/**
+ * Copyright IBM Corp. 2023, 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.
+ */
+export { CoachmarkOverlayElements } from './CoachmarkOverlayElements';
+export type { CoachmarkOverlayElementsProps } from './CoachmarkOverlayElements';

package/lib/components/CoachmarkStack/CoachmarkStack.d.ts

@@ -1,8 +1,73 @@
+/**
+ * Copyright IBM Corp. 2023, 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 React, { ReactNode } from 'react';
+type Media = {
+    render?: () => ReactNode;
+} | {
+    filePaths?: string[];
+};
+interface CoachmarkStackProps {
+    /**
+     * CoachmarkStack should use a single CoachmarkOverlayElements component as a child.
+     */
+    children: ReactNode;
+    /**
+     * Provide an optional class to be applied to the containing node.
+     */
+    className?: string;
+    /**
+     * The label for the button that will close the Stack
+     */
+    closeButtonLabel?: string;
+    /**
+     * The description of the Coachmark.
+     */
+    description: ReactNode;
+    /**
+     * The object describing an image in one of two shapes.
+     *
+     * If a single media element is required, use `{render}`.
+     *
+     * If a stepped animation is required, use `{filePaths}`.
+     *
+     * @see {@link MEDIA_PROP_TYPE}.
+     */
+    media?: Media;
+    /**
+     * The labels used to link to the stackable Coachmarks.
+     */
+    navLinkLabels: string[];
+    /**
+     * Function to call when the CoachmarkStack closes.
+     */
+    onClose?: () => void;
+    /**
+     * Where in the DOM to render the stack.
+     * The default is `document.body`.
+     */
+    portalTarget?: string;
+    /**
+     * The tagline title which will be fixed to the bottom right of the window and will serve as the display trigger.
+     */
+    tagline: string;
+    /**
+     * Determines the theme of the component.
+     */
+    theme?: 'light' | 'dark';
+    /**
+     * The title of the Coachmark.
+     */
+    title: string;
+}
 /**
  * Stacked coachmarks are used to call out specific functionality or concepts
  * within the UI that may not be intuitive but are important for the
  * user to gain understanding of the product's main value and discover new use cases.
  * This variant allows the stacking of multiple coachmark overlays to be displayed by interacting with the tagline.
  */
-export let CoachmarkStack: React.ForwardRefExoticComponent<React.RefAttributes<any>>;
-import React from 'react';
+export declare let CoachmarkStack: React.ForwardRefExoticComponent<CoachmarkStackProps & React.RefAttributes<HTMLDivElement>>;
+export {};

package/lib/components/CoachmarkStack/CoachmarkStack.js

@@ -40,7 +40,8 @@ var elementBlockClass = "".concat(settings.pkg.prefix, "--coachmark-stack-elemen
 var defaults = {
   onClose: function onClose() {},
   // Pass through to CoachmarkStackHome
-  theme: 'light'
+  theme: 'light',
+  portalTarget: 'body'
 };
 
 // NOTE
@@ -72,12 +73,12 @@ exports.CoachmarkStack = /*#__PURE__*/React__default["default"].forwardRef(funct
     theme = _ref$theme === void 0 ? defaults.theme : _ref$theme,
     title = _ref.title,
     rest = _rollupPluginBabelHelpers.objectWithoutProperties(_ref, _excluded);
-  var portalNode = React.useRef();
+  var portalNode = React.useRef(null);
   useIsomorphicEffect.useIsomorphicEffect(function () {
     var _document$querySelect, _document, _document2, _document3;
     portalNode.current = portalTarget ? (_document$querySelect = (_document = document) === null || _document === void 0 ? void 0 : _document.querySelector(portalTarget)) !== null && _document$querySelect !== void 0 ? _document$querySelect : (_document2 = document) === null || _document2 === void 0 ? void 0 : _document2.querySelector('body') : (_document3 = document) === null || _document3 === void 0 ? void 0 : _document3.querySelector('body');
   }, [portalTarget]);
-  var stackHomeRef = React.useRef();
+  var stackHomeRef = React.useRef(null);
   var stackedCoachmarkRefs = React.useRef([]);
   var _useState = React.useState(false),
     _useState2 = _rollupPluginBabelHelpers.slicedToArray(_useState, 2),
@@ -91,7 +92,7 @@ exports.CoachmarkStack = /*#__PURE__*/React__default["default"].forwardRef(funct
     selectedItemNumber = _useState4[0],
     setSelectedItemNumber = _useState4[1];
   // // The parent height and width values to return to after unstacked
-  var _useState5 = React.useState(null),
+  var _useState5 = React.useState(),
     _useState6 = _rollupPluginBabelHelpers.slicedToArray(_useState5, 2),
     parentHeight = _useState6[0],
     setParentHeight = _useState6[1];
@@ -172,14 +173,20 @@ exports.CoachmarkStack = /*#__PURE__*/React__default["default"].forwardRef(funct
     if (!parentHeight) {
       return;
     }
-    stackHomeRef.current.style.height = "".concat(parentHeight, "px");
+    if (stackHomeRef.current) {
+      stackHomeRef.current.style.height = "".concat(parentHeight, "px");
+    }
     if (!isOpen || targetSelectedItem < 0) {
-      stackHomeRef.current.focus();
+      if (stackHomeRef.current) {
+        stackHomeRef.current.focus();
+      }
       return;
     }
     var targetHomeHeight = stackedCoachmarkRefs.current[targetSelectedItem].clientHeight;
-    stackHomeRef.current.style.height = "".concat(targetHomeHeight, "px");
-    stackedCoachmarkRefs.current[targetSelectedItem].focus();
+    if (stackHomeRef.current) {
+      stackHomeRef.current.style.height = "".concat(targetHomeHeight, "px");
+      stackedCoachmarkRefs.current[targetSelectedItem].focus();
+    }
   }, [selectedItemNumber, isOpen, parentHeight]);
   var wrappedChildren = React.Children.map(childArray, function (child, idx) {
     var mountedClass = mountedRef.current ? "".concat(elementBlockClass, "--is-mounted") : '';
@@ -267,7 +274,7 @@ exports.CoachmarkStack.propTypes = {
   /**
    * The labels used to link to the stackable Coachmarks.
    */
-  navLinkLabels: index["default"].arrayOf(index["default"].string).isRequired,
+  navLinkLabels: index["default"].arrayOf(index["default"].string.isRequired).isRequired,
   /**
    * Function to call when the CoachmarkStack closes.
    */