@carbon/ibm-products 2.43.2-canary.11 → 2.43.2-canary.112

package/es/components/Card/CardFooter.d.ts

@@ -1,50 +1,53 @@
-export function CardFooter({ actions, disabled, footerActionIcon: FooterActionIcon, hasActions, hasButton, onPrimaryButtonClick, onSecondaryButtonClick, primaryButtonDisabled, primaryButtonHref, primaryButtonIcon, primaryButtonKind, primaryButtonPlacement, primaryButtonText, productive, secondaryButtonDisabled, secondaryButtonHref, secondaryButtonIcon, secondaryButtonKind, secondaryButtonPlacement, secondaryButtonText, }: {
-    actions?: any[] | undefined;
-    disabled: any;
-    footerActionIcon: any;
-    hasActions: any;
-    hasButton: any;
-    onPrimaryButtonClick: any;
-    onSecondaryButtonClick: any;
-    primaryButtonDisabled: any;
-    primaryButtonHref: any;
-    primaryButtonIcon: any;
-    primaryButtonKind?: string | undefined;
-    primaryButtonPlacement: any;
-    primaryButtonText: any;
-    productive?: boolean | undefined;
-    secondaryButtonDisabled: any;
-    secondaryButtonHref: any;
-    secondaryButtonIcon: any;
-    secondaryButtonKind?: string | undefined;
-    secondaryButtonPlacement: any;
-    secondaryButtonText: any;
-}): import("react/jsx-runtime").JSX.Element;
-export namespace CardFooter {
-    export namespace propTypes {
-        let actions: PropTypes.Requireable<NonNullable<any[] | PropTypes.ReactNodeLike>>;
-        let disabled: PropTypes.Requireable<boolean>;
-        let footerActionIcon: PropTypes.Requireable<object>;
-        let hasActions: PropTypes.Requireable<boolean>;
-        let hasButton: PropTypes.Requireable<boolean>;
-        let onPrimaryButtonClick: PropTypes.Requireable<(...args: any[]) => any>;
-        let onSecondaryButtonClick: PropTypes.Requireable<(...args: any[]) => any>;
-        let primaryButtonDisabled: PropTypes.Requireable<boolean>;
-        let primaryButtonHref: PropTypes.Requireable<string>;
-        let primaryButtonIcon: PropTypes.Requireable<object>;
-        let primaryButtonKind: PropTypes.Requireable<string>;
-        let primaryButtonPlacement: PropTypes.Requireable<string>;
-        let primaryButtonText: PropTypes.Requireable<string>;
-        let productive: PropTypes.Requireable<boolean>;
-        let secondaryButtonDisabled: PropTypes.Requireable<boolean>;
-        let secondaryButtonHref: PropTypes.Requireable<string>;
-        let secondaryButtonIcon: PropTypes.Requireable<object>;
-        let secondaryButtonKind: PropTypes.Requireable<string>;
-        let secondaryButtonPlacement: PropTypes.Requireable<string>;
-        let secondaryButtonText: PropTypes.Requireable<string>;
-    }
-    export { componentName as displayName };
-}
+import React, { ReactNode } from 'react';
 import PropTypes from 'prop-types';
-declare const componentName: "CardFooter";
+interface CardFooterProps {
+    actions?: ReactNode[] | ReactNode;
+    disabled?: boolean;
+    footerActionIcon?: React.ElementType;
+    hasActions?: boolean;
+    hasButton?: boolean;
+    onPrimaryButtonClick?: () => void;
+    onSecondaryButtonClick?: () => void;
+    primaryButtonDisabled?: boolean;
+    primaryButtonHref?: string;
+    primaryButtonIcon?: React.ElementType;
+    primaryButtonKind?: 'primary' | 'ghost';
+    primaryButtonPlacement?: 'top' | 'bottom';
+    primaryButtonText?: string;
+    productive?: boolean;
+    secondaryButtonDisabled?: boolean;
+    secondaryButtonHref?: string;
+    secondaryButtonIcon?: React.ElementType;
+    secondaryButtonKind?: 'secondary' | 'ghost';
+    secondaryButtonPlacement?: 'top' | 'bottom';
+    secondaryButtonText?: string;
+}
+export declare const CardFooter: {
+    ({ actions, disabled, footerActionIcon: FooterActionIcon, hasActions, hasButton, onPrimaryButtonClick, onSecondaryButtonClick, primaryButtonDisabled, primaryButtonHref, primaryButtonIcon, primaryButtonKind, primaryButtonPlacement, primaryButtonText, productive, secondaryButtonDisabled, secondaryButtonHref, secondaryButtonIcon, secondaryButtonKind, secondaryButtonPlacement, secondaryButtonText, }: CardFooterProps): import("react/jsx-runtime").JSX.Element;
+    /**@ts-ignore */
+    propTypes: {
+        actions: PropTypes.Requireable<NonNullable<any[] | PropTypes.ReactNodeLike>>;
+        disabled: PropTypes.Requireable<boolean>;
+        footerActionIcon: PropTypes.Requireable<object>;
+        hasActions: PropTypes.Requireable<boolean>;
+        hasButton: PropTypes.Requireable<boolean>;
+        onPrimaryButtonClick: PropTypes.Requireable<(...args: any[]) => any>;
+        onSecondaryButtonClick: PropTypes.Requireable<(...args: any[]) => any>;
+        primaryButtonDisabled: PropTypes.Requireable<boolean>;
+        primaryButtonHref: PropTypes.Requireable<string>;
+        primaryButtonIcon: PropTypes.Requireable<object>;
+        primaryButtonKind: PropTypes.Requireable<string>;
+        primaryButtonPlacement: PropTypes.Requireable<string>;
+        primaryButtonText: PropTypes.Requireable<string>;
+        productive: PropTypes.Requireable<boolean>;
+        secondaryButtonDisabled: PropTypes.Requireable<boolean>;
+        secondaryButtonHref: PropTypes.Requireable<string>;
+        secondaryButtonIcon: PropTypes.Requireable<object>;
+        secondaryButtonKind: PropTypes.Requireable<string>;
+        secondaryButtonPlacement: PropTypes.Requireable<string>;
+        secondaryButtonText: PropTypes.Requireable<string>;
+    };
+    /**@ts-ignore */
+    displayName: string;
+};
 export {};

package/es/components/Card/CardFooter.js

@@ -34,7 +34,7 @@ var CardFooter = function CardFooter(_ref) {
     primaryButtonHref = _ref.primaryButtonHref,
     primaryButtonIcon = _ref.primaryButtonIcon,
     _ref$primaryButtonKin = _ref.primaryButtonKind,
-    primaryButtonKind = _ref$primaryButtonKin === void 0 ? defaults.primaryButtonKind : _ref$primaryButtonKin,
+    primaryButtonKind = _ref$primaryButtonKin === void 0 ? 'primary' : _ref$primaryButtonKin,
     primaryButtonPlacement = _ref.primaryButtonPlacement,
     primaryButtonText = _ref.primaryButtonText,
     _ref$productive = _ref.productive,
@@ -43,7 +43,7 @@ var CardFooter = function CardFooter(_ref) {
     secondaryButtonHref = _ref.secondaryButtonHref,
     secondaryButtonIcon = _ref.secondaryButtonIcon,
     _ref$secondaryButtonK = _ref.secondaryButtonKind,
-    secondaryButtonKind = _ref$secondaryButtonK === void 0 ? defaults.secondaryButtonKind : _ref$secondaryButtonK,
+    secondaryButtonKind = _ref$secondaryButtonK === void 0 ? 'secondary' : _ref$secondaryButtonK,
     secondaryButtonPlacement = _ref.secondaryButtonPlacement,
     secondaryButtonText = _ref.secondaryButtonText;
   var blockClass = "".concat(pkg.prefix, "--card");
@@ -73,6 +73,7 @@ var CardFooter = function CardFooter(_ref) {
     size: 16
   })) : /*#__PURE__*/React__default.createElement(FooterActionIcon, null)));
 };
+/**@ts-ignore */
 CardFooter.propTypes = {
   actions: PropTypes.oneOfType([PropTypes.array, PropTypes.node]),
   disabled: PropTypes.bool,
@@ -95,6 +96,7 @@ CardFooter.propTypes = {
   secondaryButtonPlacement: PropTypes.oneOf(['top', 'bottom']),
   secondaryButtonText: PropTypes.string
 };
+/**@ts-ignore */
 CardFooter.displayName = componentName;
 
 export { CardFooter };

package/es/components/Card/CardHeader.d.ts

@@ -1,51 +1,69 @@
-export function CardHeader({ actions, noActionIcons, onPrimaryButtonClick, onSecondaryButtonClick, primaryButtonIcon, primaryButtonPlacement, primaryButtonText, primaryButtonDisabled, description, hasActions, inClickableCard, label, secondaryButtonDisabled, secondaryButtonHref, secondaryButtonIcon, secondaryButtonPlacement, secondaryButtonText, slug, title, titleSize, }: {
-    actions: any;
-    noActionIcons: any;
-    onPrimaryButtonClick: any;
-    onSecondaryButtonClick: any;
-    primaryButtonIcon: any;
-    primaryButtonPlacement: any;
-    primaryButtonText: any;
-    primaryButtonDisabled: any;
-    description: any;
-    hasActions?: boolean | undefined;
-    inClickableCard: any;
-    label: any;
-    secondaryButtonDisabled: any;
-    secondaryButtonHref: any;
-    secondaryButtonIcon: any;
-    secondaryButtonPlacement: any;
-    secondaryButtonText: any;
-    slug: any;
-    title: any;
-    titleSize?: string | undefined;
-}): import("react/jsx-runtime").JSX.Element;
-export namespace CardHeader {
-    export namespace propTypes {
-        let actions: PropTypes.Requireable<NonNullable<any[] | PropTypes.ReactNodeLike>>;
-        let description: PropTypes.Requireable<NonNullable<object | PropTypes.ReactNodeLike>>;
-        let hasActions: PropTypes.Requireable<boolean>;
-        let inClickableCard: PropTypes.Requireable<boolean>;
-        let label: PropTypes.Requireable<string>;
-        let noActionIcons: PropTypes.Requireable<boolean>;
-        let onPrimaryButtonClick: PropTypes.Requireable<(...args: any[]) => any>;
-        let onSecondaryButtonClick: PropTypes.Requireable<(...args: any[]) => any>;
-        let primaryButtonDisabled: PropTypes.Requireable<boolean>;
-        let primaryButtonIcon: PropTypes.Requireable<object>;
-        let primaryButtonPlacement: PropTypes.Requireable<string>;
-        let primaryButtonText: PropTypes.Requireable<string>;
-        let secondaryButtonDisabled: PropTypes.Requireable<boolean>;
-        let secondaryButtonHref: PropTypes.Requireable<string>;
-        let secondaryButtonIcon: PropTypes.Requireable<object>;
-        let secondaryButtonKind: PropTypes.Requireable<string>;
-        let secondaryButtonPlacement: PropTypes.Requireable<string>;
-        let secondaryButtonText: PropTypes.Requireable<string>;
-        let slug: PropTypes.Requireable<NonNullable<PropTypes.ReactNodeLike>>;
-        let title: PropTypes.Requireable<NonNullable<object | PropTypes.ReactNodeLike>>;
-        let titleSize: PropTypes.Requireable<string>;
-    }
-    export { componentName as displayName };
-}
+import React, { ReactNode } from 'react';
 import PropTypes from 'prop-types';
-declare const componentName: "CardHeader";
+interface CardHeaderProps {
+    actions?: ReactNode[] | ReactNode;
+    description?: ReactNode;
+    hasActions?: boolean;
+    /**
+     * is the host card clickable
+     */
+    inClickableCard?: boolean;
+    label?: ReactNode;
+    noActionIcons?: boolean;
+    onPrimaryButtonClick?: () => void;
+    onSecondaryButtonClick?: () => void;
+    primaryButtonDisabled?: boolean;
+    primaryButtonIcon?: React.ElementType;
+    primaryButtonPlacement?: 'top' | 'bottom';
+    primaryButtonText?: string;
+    secondaryButtonDisabled?: boolean;
+    secondaryButtonHref?: string;
+    secondaryButtonIcon?: React.ElementType;
+    secondaryButtonKind?: 'secondary' | 'ghost';
+    secondaryButtonPlacement?: 'top' | 'bottom';
+    secondaryButtonText?: 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.
+     */
+    slug?: ReactNode;
+    title?: ReactNode;
+    titleSize?: 'default' | 'large';
+}
+export declare const CardHeader: {
+    ({ actions, noActionIcons, onPrimaryButtonClick, onSecondaryButtonClick, primaryButtonIcon, primaryButtonPlacement, primaryButtonText, primaryButtonDisabled, description, hasActions, inClickableCard, label, secondaryButtonDisabled, secondaryButtonHref, secondaryButtonIcon, secondaryButtonPlacement, secondaryButtonText, slug, title, titleSize, }: CardHeaderProps): import("react/jsx-runtime").JSX.Element;
+    /**@ts-ignore */
+    propTypes: {
+        actions: PropTypes.Requireable<NonNullable<any[] | PropTypes.ReactNodeLike>>;
+        description: PropTypes.Requireable<NonNullable<object | PropTypes.ReactNodeLike>>;
+        hasActions: PropTypes.Requireable<boolean>;
+        /**
+         * is the host card clickable
+         */
+        inClickableCard: PropTypes.Requireable<boolean>;
+        label: PropTypes.Requireable<string>;
+        noActionIcons: PropTypes.Requireable<boolean>;
+        onPrimaryButtonClick: PropTypes.Requireable<(...args: any[]) => any>;
+        onSecondaryButtonClick: PropTypes.Requireable<(...args: any[]) => any>;
+        primaryButtonDisabled: PropTypes.Requireable<boolean>;
+        primaryButtonIcon: PropTypes.Requireable<object>;
+        primaryButtonPlacement: PropTypes.Requireable<string>;
+        primaryButtonText: PropTypes.Requireable<string>;
+        secondaryButtonDisabled: PropTypes.Requireable<boolean>;
+        secondaryButtonHref: PropTypes.Requireable<string>;
+        secondaryButtonIcon: PropTypes.Requireable<object>;
+        secondaryButtonKind: PropTypes.Requireable<string>;
+        secondaryButtonPlacement: PropTypes.Requireable<string>;
+        secondaryButtonText: PropTypes.Requireable<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.
+         */
+        slug: PropTypes.Requireable<NonNullable<PropTypes.ReactNodeLike>>;
+        title: PropTypes.Requireable<NonNullable<object | PropTypes.ReactNodeLike>>;
+        titleSize: PropTypes.Requireable<string>;
+    };
+    /**@ts-ignore */
+    displayName: string;
+};
 export {};

package/es/components/Card/CardHeader.js

@@ -40,7 +40,7 @@ var CardHeader = function CardHeader(_ref) {
     slug = _ref.slug,
     title = _ref.title,
     _ref$titleSize = _ref.titleSize,
-    titleSize = _ref$titleSize === void 0 ? defaults.titleSize : _ref$titleSize;
+    titleSize = _ref$titleSize === void 0 ? 'default' : _ref$titleSize;
   var carbonPrefix = usePrefix();
   var blockClass = "".concat(pkg.prefix, "--card");
   var headerClass = "".concat(blockClass, "__header");
@@ -63,7 +63,7 @@ var CardHeader = function CardHeader(_ref) {
     d: "M13.2436 16H11.5996L10.9276 13.864H7.95164L7.29164 16H5.68364L8.49164 7.624H10.4596L13.2436 16ZM10.5436 12.508L9.46364 9.064H9.40364L8.33564 12.508H10.5436ZM17.9341 16H14.1301V14.728H15.2341V8.896H14.1301V7.624H17.9341V8.896H16.8181V14.728H17.9341V16Z",
     fill: "#161616"
   })));
-  var normalizedSlug;
+  var normalizedSlug = null;
   if (slug) {
     if (inClickableCard || typeof slug === 'boolean') {
       normalizedSlug = hollowSlugIcon;
@@ -104,6 +104,7 @@ var CardHeader = function CardHeader(_ref) {
     disabled: primaryButtonDisabled
   }, primaryButtonText)), normalizedSlug));
 };
+/**@ts-ignore */
 CardHeader.propTypes = {
   actions: PropTypes.oneOfType([PropTypes.array, PropTypes.node]),
   description: PropTypes.oneOfType([PropTypes.string, PropTypes.object, PropTypes.node]),
@@ -134,6 +135,7 @@ CardHeader.propTypes = {
   title: PropTypes.oneOfType([PropTypes.string, PropTypes.object, PropTypes.node]),
   titleSize: PropTypes.oneOf(['default', 'large'])
 };
+/**@ts-ignore */
 CardHeader.displayName = componentName;
 
 export { CardHeader };

package/es/components/Coachmark/Coachmark.d.ts

@@ -12,6 +12,11 @@ interface CoachmarkProps {
      * @see COACHMARK_ALIGNMENT
      */
     align?: 'bottom' | 'bottom-left' | 'bottom-right' | 'left' | 'left-top' | 'left-bottom' | 'right' | 'right-top' | 'right-bottom' | 'top' | 'top-left' | 'top-right';
+    /**
+     * Auto aligns the coachmark based on screen boundaries
+     * Applies only to Tooltip Coachmarks.
+     */
+    autoAlign?: boolean;
     /**
      * Coachmark should use a single CoachmarkOverlayElements component as a child.
      * @see CoachmarkOverlayElements
@@ -51,7 +56,7 @@ interface CoachmarkProps {
     positionTune?: {
         x: number;
         y: number;
-    } | object;
+    };
     /**
      * The optional button or beacon that the user will click to show the Coachmark.
      */

package/es/components/Coachmark/Coachmark.js

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import { objectWithoutProperties as _objectWithoutProperties, slicedToArray as _slicedToArray, extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import { objectWithoutProperties as _objectWithoutProperties, slicedToArray as _slicedToArray, extends as _extends, objectSpread2 as _objectSpread2, defineProperty as _defineProperty } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import React__default, { forwardRef, useState, useRef, useCallback, useEffect } from 'react';
 import cx from 'classnames';
 import PropTypes from '../../node_modules/prop-types/index.js';
@@ -17,8 +17,11 @@ import { useClickOutsideElement, useWindowEvent } from './utils/hooks.js';
 import { getDevtoolsProps } from '../../global/js/utils/devtools.js';
 import { pkg } from '../../settings.js';
 import { throttle } from 'lodash';
+import { Popover, PopoverContent } from '@carbon/react';
+import { useIsomorphicEffect } from '../../global/js/hooks/useIsomorphicEffect.js';
+
+var _excluded = ["align", "autoAlign", "children", "className", "onClose", "overlayClassName", "overlayKind", "overlayRef", "positionTune", "portalTarget", "target", "theme"];
 
-var _excluded = ["align", "children", "className", "onClose", "overlayClassName", "overlayKind", "overlayRef", "portalTarget", "positionTune", "target", "theme"];
 // The block part of our conventional BEM class names (blockClass__E--M).
 var blockClass = "".concat(pkg.prefix, "--coachmark");
 var overlayBlockClass = "".concat(blockClass, "-overlay");
@@ -36,9 +39,10 @@ var defaults = {
  */
 
 var Coachmark = /*#__PURE__*/forwardRef(function (_ref, ref) {
-  var _document$querySelect;
+  var _positionTune$y, _positionTune$x;
   var _ref$align = _ref.align,
     align = _ref$align === void 0 ? defaults.align : _ref$align,
+    autoAlign = _ref.autoAlign,
     children = _ref.children,
     className = _ref.className,
     _ref$onClose = _ref.onClose,
@@ -47,15 +51,14 @@ var Coachmark = /*#__PURE__*/forwardRef(function (_ref, ref) {
     _ref$overlayKind = _ref.overlayKind,
     overlayKind = _ref$overlayKind === void 0 ? defaults.overlayKind : _ref$overlayKind,
     overlayRef = _ref.overlayRef,
-    portalTarget = _ref.portalTarget,
     positionTune = _ref.positionTune,
+    portalTarget = _ref.portalTarget,
     target = _ref.target,
     _ref$theme = _ref.theme,
     theme = _ref$theme === void 0 ? defaults.theme : _ref$theme,
     rest = _objectWithoutProperties(_ref, _excluded);
   var isBeacon = overlayKind === COACHMARK_OVERLAY_KIND.TOOLTIP;
   var isStacked = overlayKind === COACHMARK_OVERLAY_KIND.STACKED;
-  var portalNode = portalTarget ? (_document$querySelect = document.querySelector(portalTarget)) !== null && _document$querySelect !== void 0 ? _document$querySelect : document.querySelector('body') : document.querySelector('body');
   var _useState = useState(isStacked),
     _useState2 = _slicedToArray(_useState, 2),
     isOpen = _useState2[0],
@@ -79,6 +82,11 @@ var Coachmark = /*#__PURE__*/forwardRef(function (_ref, ref) {
   var backupRef = useRef();
   var _coachmarkRef = ref || backupRef;
   var _overlayRef = overlayRef || overlayBackupRef;
+  var portalNode = useRef(null);
+  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 closeOverlay = function closeOverlay() {
     setIsOpen(false);
   };
@@ -120,6 +128,10 @@ var Coachmark = /*#__PURE__*/forwardRef(function (_ref, ref) {
       setShouldResetPosition(true);
     }
   };
+  var overlayPositionStyle = {
+    top: ((_positionTune$y = positionTune === null || positionTune === void 0 ? void 0 : positionTune.y) !== null && _positionTune$y !== void 0 ? _positionTune$y : 0) - 16,
+    left: ((_positionTune$x = positionTune === null || positionTune === void 0 ? void 0 : positionTune.x) !== null && _positionTune$x !== void 0 ? _positionTune$x : 0) - 16
+  };
   var contextValue = {
     buttonProps: {
       'aria-expanded': isOpen,
@@ -135,7 +147,8 @@ var Coachmark = /*#__PURE__*/forwardRef(function (_ref, ref) {
     targetRect: targetRect,
     targetOffset: targetOffset,
     align: align,
-    positionTune: positionTune
+    positionTune: positionTune,
+    isOpen: isOpen
   };
   var handleResize = throttle(function () {
     closeOverlay();
@@ -169,18 +182,35 @@ var Coachmark = /*#__PURE__*/forwardRef(function (_ref, ref) {
   }, /*#__PURE__*/React__default.createElement("div", _extends({
     className: cx(blockClass, "".concat(blockClass, "__").concat(theme), className),
     ref: _coachmarkRef
-  }, rest, getDevtoolsProps(componentName)), target, isOpen && /*#__PURE__*/createPortal( /*#__PURE__*/React__default.createElement(CoachmarkOverlay, {
+  }, rest, getDevtoolsProps(componentName)), overlayKind !== 'tooltip' ? /*#__PURE__*/React__default.createElement(React__default.Fragment, null, target, isOpen && (portalNode === null || portalNode === void 0 ? void 0 : portalNode.current) && /*#__PURE__*/createPortal( /*#__PURE__*/React__default.createElement(CoachmarkOverlay, {
     ref: _overlayRef,
     fixedIsVisible: false,
     kind: overlayKind,
     onClose: handleClose,
     theme: theme,
     className: cx(overlayClassName, "".concat(overlayBlockClass, "--is-visible"))
-  }, children),
-  // Default to `document.body` when `portalNode` is `null`
-  portalNode || document.body)));
+  }, children), // Default to `document.body` when `portalNode` is `null`
+  portalNode === null || portalNode === void 0 ? void 0 : portalNode.current)) : /*#__PURE__*/React__default.createElement(Popover, {
+    highContrast: true,
+    caret: true,
+    style: _objectSpread2({
+      position: 'absolute'
+    }, overlayPositionStyle),
+    align: align,
+    autoAlign: autoAlign,
+    open: isOpen
+  }, target, /*#__PURE__*/React__default.createElement(PopoverContent, null, isOpen && /*#__PURE__*/React__default.createElement(CoachmarkOverlay, {
+    ref: _overlayRef,
+    fixedIsVisible: false,
+    kind: overlayKind,
+    onClose: handleClose,
+    theme: theme,
+    className: cx(overlayClassName, _defineProperty({}, "".concat(overlayBlockClass, "--is-visible"), isOpen))
+  }, children)))));
 });
-var overlayRefType = typeof HTMLElement === 'undefined' ? PropTypes.object : PropTypes.instanceOf(HTMLElement);
+var overlayRefType = typeof HTMLElement === 'undefined' ? PropTypes.object :
+// eslint-disable-next-line ssr-friendly/no-dom-globals-in-module-scope
+PropTypes.instanceOf(HTMLElement);
 
 // Return a placeholder if not released and not enabled by feature flag
 Coachmark = pkg.checkComponentEnabled(Coachmark, componentName);
@@ -199,6 +229,11 @@ 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']),
+  /**
+   * Auto aligns the coachmark based on screen boundaries
+   * Applies only to Tooltip Coachmarks.
+   */
+  autoAlign: PropTypes.bool,
   /**
    * Coachmark should use a single CoachmarkOverlayElements component as a child.
    * @see CoachmarkOverlayElements
@@ -237,6 +272,7 @@ Coachmark.propTypes = {
   /**
    * Fine tune the position of the target in pixels. Applies only to Beacons.
    */
+  // @ts-ignore
   positionTune: PropTypes.shape({
     x: PropTypes.number,
     y: PropTypes.number

package/es/components/Coachmark/CoachmarkOverlay.js

@@ -55,7 +55,7 @@ var CoachmarkOverlay = /*#__PURE__*/forwardRef(function (_ref, ref) {
   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 isVisible = className === null || className === void 0 ? void 0 : className.includes('is-visible');
   var handleKeyPress = function handleKeyPress(event) {
     var shiftKey = event.shiftKey,
       key = event.key;
@@ -163,9 +163,7 @@ var CoachmarkOverlay = /*#__PURE__*/forwardRef(function (_ref, ref) {
     return /*#__PURE__*/React__default.cloneElement(child, {
       isVisible: isVisible
     });
-  })), isBeacon && /*#__PURE__*/React__default.createElement("span", {
-    className: "".concat(blockClass, "__caret")
-  }));
+  })));
 });
 function getWindowDimensions() {
   var _window = window,

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

@@ -1,3 +1,9 @@
+/**
+ * Copyright IBM Corp. 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.
+ */
 /**
  * Reserved for future expansion, i.e. "RING".
  */

package/es/components/CoachmarkBeacon/CoachmarkBeacon.js

@@ -26,7 +26,6 @@ var defaults = {
  * Use beacon for the target prop of a Coachmark component.
  */
 var CoachmarkBeacon = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
-  var _coachmark$positionTu, _coachmark$positionTu2, _coachmark$positionTu3, _coachmark$positionTu4;
   var label = _ref.label,
     className = _ref.className,
     _ref$kind = _ref.kind,
@@ -36,14 +35,9 @@ var CoachmarkBeacon = /*#__PURE__*/React__default.forwardRef(function (_ref, ref
   if (!coachmark) {
     return _div || (_div = /*#__PURE__*/React__default.createElement("div", null, "CoachmarkBeacon is to be use exclusively within the target prop of Coachmark"));
   }
-  var overlayPositionStyle = {
-    top: (_coachmark$positionTu = (_coachmark$positionTu2 = coachmark.positionTune) === null || _coachmark$positionTu2 === void 0 ? void 0 : _coachmark$positionTu2.y) !== null && _coachmark$positionTu !== void 0 ? _coachmark$positionTu : 0,
-    left: (_coachmark$positionTu3 = (_coachmark$positionTu4 = coachmark.positionTune) === null || _coachmark$positionTu4 === void 0 ? void 0 : _coachmark$positionTu4.x) !== null && _coachmark$positionTu3 !== void 0 ? _coachmark$positionTu3 : 0
-  };
   return /*#__PURE__*/React__default.createElement("span", _extends({}, rest, {
     className: cx(blockClass, "".concat(blockClass, "-").concat(kind), className),
-    ref: ref,
-    style: overlayPositionStyle
+    ref: ref
   }, getDevtoolsProps(componentName), {
     role: "tooltip"
   }), /*#__PURE__*/React__default.createElement("button", _extends({

package/es/components/CoachmarkFixed/CoachmarkFixed.js

@@ -16,6 +16,8 @@ import { CoachmarkOverlay } from '../Coachmark/CoachmarkOverlay.js';
 import { CoachmarkTagline } from '../Coachmark/CoachmarkTagline.js';
 import { CoachmarkContext } from '../Coachmark/utils/context.js';
 import { COACHMARK_OVERLAY_KIND } from '../Coachmark/utils/enums.js';
+import { useReducedMotion } from 'framer-motion';
+import { useIsomorphicEffect } from '../../global/js/hooks/useIsomorphicEffect.js';
 
 var _excluded = ["children", "className", "onClose", "portalTarget", "tagline", "theme"];
 // Carbon and package components we use.
@@ -39,7 +41,6 @@ var defaults = {
  * This variant allows the a coachmark overlay to be displayed by interacting with the tagline.
  */
 var CoachmarkFixed = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
-  var _document$querySelect;
   var children = _ref.children,
     className = _ref.className,
     _ref$onClose = _ref.onClose,
@@ -51,7 +52,7 @@ var CoachmarkFixed = /*#__PURE__*/React__default.forwardRef(function (_ref, ref)
     theme = _ref$theme === void 0 ? defaults.theme : _ref$theme,
     rest = _objectWithoutProperties(_ref, _excluded);
   var overlayRef = useRef(null);
-  var portalNode = portalTarget ? (_document$querySelect = document.querySelector(portalTarget)) !== null && _document$querySelect !== void 0 ? _document$querySelect : document.querySelector('body') : document.querySelector('body');
+  var portalNode = useRef(null);
   var _useState = useState(false),
     _useState2 = _slicedToArray(_useState, 2),
     isOpen = _useState2[0],
@@ -75,17 +76,19 @@ var CoachmarkFixed = /*#__PURE__*/React__default.forwardRef(function (_ref, ref)
     _useState10 = _slicedToArray(_useState9, 2),
     fixedIsVisible = _useState10[0],
     setFixedIsVisible = _useState10[1];
-  var prefersReducedMotion = window.matchMedia('(prefers-reduced-motion: reduce)');
+  var shouldReduceMotion = useReducedMotion();
+  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 handleClose = useCallback(function () {
-    console.log('HANDLING CLOSE HERE...');
-    if (prefersReducedMotion.matches) {
+    if (shouldReduceMotion) {
       setIsOpen(false);
     } else {
       setFixedIsVisible(false);
     }
-  }, [prefersReducedMotion.matches]);
+  }, [shouldReduceMotion]);
   var handleTransitionEnd = function handleTransitionEnd(e) {
-    console.log('Here at transition end... ', e.propertyName === 'transform' && !fixedIsVisible);
     if (e.propertyName === 'transform' && !fixedIsVisible) {
       setIsOpen(false);
       onClose();
@@ -164,7 +167,7 @@ var CoachmarkFixed = /*#__PURE__*/React__default.forwardRef(function (_ref, ref)
   }, getDevtoolsProps(componentName)), /*#__PURE__*/React__default.createElement(CoachmarkTagline, {
     title: tagline,
     onClose: onClose
-  }), isOpen && /*#__PURE__*/createPortal( /*#__PURE__*/React__default.createElement(CoachmarkOverlay, {
+  }), isOpen && (portalNode === null || portalNode === void 0 ? void 0 : portalNode.current) && /*#__PURE__*/createPortal( /*#__PURE__*/React__default.createElement(CoachmarkOverlay, {
     ref: overlayRef,
     fixedIsVisible: fixedIsVisible,
     kind: COACHMARK_OVERLAY_KIND.FIXED,
@@ -172,9 +175,8 @@ var CoachmarkFixed = /*#__PURE__*/React__default.forwardRef(function (_ref, ref)
     onTransitionEnd: handleTransitionEnd,
     theme: theme,
     className: cx(fixedIsVisible && "".concat(overlayBlockClass, "--is-visible"), overlayBlockClass)
-  }, children),
-  // Default to `document.body` when `portalNode` is `null`
-  portalNode || document.body)));
+  }, children), // Default to `document.body` when `portalNode` is `null`
+  portalNode === null || portalNode === void 0 ? void 0 : portalNode.current)));
 });
 
 // Return a placeholder if not released and not enabled by feature flag

package/es/components/CoachmarkStack/CoachmarkStack.js

@@ -17,6 +17,7 @@ import { CoachmarkStackHome } from './CoachmarkStackHome.js';
 import { CoachmarkTagline } from '../Coachmark/CoachmarkTagline.js';
 import { CoachmarkContext } from '../Coachmark/utils/context.js';
 import { COACHMARK_OVERLAY_KIND } from '../Coachmark/utils/enums.js';
+import { useIsomorphicEffect } from '../../global/js/hooks/useIsomorphicEffect.js';
 
 var _excluded = ["children", "className", "onClose", "description", "media", "navLinkLabels", "portalTarget", "closeButtonLabel", "tagline", "theme", "title"];
 
@@ -47,7 +48,6 @@ var defaults = {
  * This variant allows the stacking of multiple coachmark overlays to be displayed by interacting with the tagline.
  */
 var CoachmarkStack = /*#__PURE__*/React__default.forwardRef(function (_ref, ref) {
-  var _document$querySelect;
   var children = _ref.children,
     className = _ref.className,
     _ref$onClose = _ref.onClose,
@@ -63,7 +63,11 @@ var CoachmarkStack = /*#__PURE__*/React__default.forwardRef(function (_ref, ref)
     theme = _ref$theme === void 0 ? defaults.theme : _ref$theme,
     title = _ref.title,
     rest = _objectWithoutProperties(_ref, _excluded);
-  var portalNode = portalTarget ? (_document$querySelect = document.querySelector(portalTarget)) !== null && _document$querySelect !== void 0 ? _document$querySelect : document.querySelector('body') : document.querySelector('body');
+  var portalNode = useRef();
+  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 = useRef();
   var stackedCoachmarkRefs = useRef([]);
   var _useState = useState(false),
@@ -206,7 +210,7 @@ var CoachmarkStack = /*#__PURE__*/React__default.forwardRef(function (_ref, ref)
     portalTarget: portalTarget,
     closeButtonLabel: closeButtonLabel,
     title: title
-  }), /*#__PURE__*/createPortal(wrappedChildren, portalNode)));
+  }), portalNode !== null && portalNode !== void 0 && portalNode.current ? /*#__PURE__*/createPortal(wrappedChildren, portalNode === null || portalNode === void 0 ? void 0 : portalNode.current) : null));
 });
 
 // Return a placeholder if not released and not enabled by feature flag