@carbon/ibm-products 2.23.0 → 2.24.0

package/es/components/SearchBar/SearchBar.js

@@ -0,0 +1,227 @@
+import _extends from "@babel/runtime/helpers/extends";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
+var _excluded = ["className", "clearButtonLabelText", "hideScopesLabel", "labelText", "onChange", "onSubmit", "placeHolderText", "scopes", "scopesTypeLabel", "scopeToString", "selectedScopes", "sortItems", "submitLabel", "translateWithId", "value"];
+/**
+ * Copyright IBM Corp. 2024, 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 portions of React that are needed.
+import React, { useEffect, useState } from 'react';
+
+// Other standard imports.
+import PropTypes from 'prop-types';
+import cx from 'classnames';
+import { getDevtoolsProps } from '../../global/js/utils/devtools';
+import { pkg } from '../../settings';
+
+// Carbon and package components we use.
+import { Search, Button, MultiSelect } from '@carbon/react';
+
+// The block part of our conventional BEM class names (blockClass__E--M).
+var blockClass = "".concat(pkg.prefix, "--search-bar");
+var componentName = 'SearchBar';
+
+// NOTE: the component SCSS is not imported here: it is rolled up separately.
+
+// Default values for props
+var defaults = {
+  onSubmit: function onSubmit() {},
+  onChange: function onChange() {},
+  scopes: [],
+  selectedScopes: [],
+  hideScopesLabel: true
+};
+
+/**
+ * Search bar with input field and search button
+ */
+export var SearchBar = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
+  var className = _ref.className,
+    clearButtonLabelText = _ref.clearButtonLabelText,
+    _ref$hideScopesLabel = _ref.hideScopesLabel,
+    hideScopesLabel = _ref$hideScopesLabel === void 0 ? defaults.hideScopesLabel : _ref$hideScopesLabel,
+    labelText = _ref.labelText,
+    _ref$onChange = _ref.onChange,
+    onChange = _ref$onChange === void 0 ? defaults.onChange : _ref$onChange,
+    _ref$onSubmit = _ref.onSubmit,
+    onSubmit = _ref$onSubmit === void 0 ? defaults.onSubmit : _ref$onSubmit,
+    placeHolderText = _ref.placeHolderText,
+    _ref$scopes = _ref.scopes,
+    scopes = _ref$scopes === void 0 ? defaults.scopes : _ref$scopes,
+    scopesTypeLabel = _ref.scopesTypeLabel,
+    scopeToString = _ref.scopeToString,
+    _ref$selectedScopes = _ref.selectedScopes,
+    selectedScopes = _ref$selectedScopes === void 0 ? defaults.selectedScopes : _ref$selectedScopes,
+    sortItems = _ref.sortItems,
+    submitLabel = _ref.submitLabel,
+    translateWithId = _ref.translateWithId,
+    value = _ref.value,
+    rest = _objectWithoutProperties(_ref, _excluded);
+  var _useState = useState(value || ''),
+    _useState2 = _slicedToArray(_useState, 2),
+    text = _useState2[0],
+    setText = _useState2[1];
+  var _useState3 = useState(selectedScopes || []),
+    _useState4 = _slicedToArray(_useState3, 2),
+    _selectedScopes = _useState4[0],
+    setSelectedScopes = _useState4[1];
+  var _useState5 = useState(false),
+    _useState6 = _slicedToArray(_useState5, 2),
+    isInputDirty = _useState6[0],
+    setIsInputDirty = _useState6[1];
+  useEffect(function () {
+    if (!text || !text.length) {
+      setIsInputDirty(false);
+    } else {
+      setIsInputDirty(true);
+    }
+  }, [text]);
+  /**
+   * Handler for form submit that calls onSubmit prop.
+   * @param {Event} event Submit event generated.
+   */
+  var handleSubmit = function handleSubmit(event) {
+    event.preventDefault();
+    var eventObject = {
+      value: text
+    };
+    if (scopes.length > 0) {
+      eventObject.selectedScopes = _selectedScopes;
+    }
+    onSubmit(eventObject);
+  };
+
+  /**
+   * Handler for when scope selection changes that calls onChangeProp.
+   * @param {{selectedItems: Array<any>}} {selectedItems} Object containing array of selected items.
+   */
+  var handleSearchScopeChange = function handleSearchScopeChange(_ref2) {
+    var selectedItems = _ref2.selectedItems;
+    setSelectedScopes(selectedItems);
+    onChange({
+      selectedScopes: selectedItems,
+      value: text
+    });
+  };
+
+  /**
+   * Handler for search input changes that calls onChange prop.
+   * @param {KeyboardEvent} event Event object from input change.
+   */
+  var handleInputChange = function handleInputChange(event) {
+    var value = event.target.value;
+    var eventObject = {
+      value: value
+    };
+    if (scopes.length > 0) {
+      eventObject.selectedScopes = selectedScopes;
+    }
+    setText(value);
+    onChange(eventObject);
+  };
+  return /*#__PURE__*/React.createElement("form", _extends({}, rest, {
+    ref: ref
+  }, getDevtoolsProps(componentName), {
+    className: cx(blockClass, className, _defineProperty({}, "".concat(blockClass, "--hide-scopes-label"), hideScopesLabel)),
+    onSubmit: handleSubmit
+  }), scopes !== null && scopes !== void 0 && scopes.length ? /*#__PURE__*/React.createElement(MultiSelect, {
+    id: "".concat(blockClass, "__multi-select"),
+    name: "search-scopes",
+    className: "".concat(blockClass, "__scopes"),
+    label: scopesTypeLabel,
+    onChange: handleSearchScopeChange,
+    initialSelectedItems: selectedScopes,
+    items: scopes,
+    itemToString: scopeToString,
+    translateWithId: translateWithId,
+    sortItems: sortItems,
+    size: "lg"
+  }) : null, /*#__PURE__*/React.createElement(Search, {
+    className: "".concat(blockClass, "__input"),
+    closeButtonLabelText: clearButtonLabelText,
+    labelText: labelText || '',
+    name: "search-input",
+    onChange: handleInputChange,
+    placeholder: placeHolderText,
+    value: text,
+    size: "lg"
+  }), /*#__PURE__*/React.createElement(Button, {
+    name: "search-submit",
+    kind: "primary",
+    type: "submit",
+    className: "".concat(blockClass, "__submit"),
+    disabled: !isInputDirty
+  }, submitLabel));
+});
+
+// Return a placeholder if not released and not enabled by feature flag
+SearchBar = pkg.checkComponentEnabled(SearchBar, componentName);
+
+// The display name of the component, used by React. Note that displayName
+// is used in preference to relying on function.name.
+SearchBar.displayName = componentName;
+var conditionalScopePropValidator = function conditionalScopePropValidator(props, propName, componentName) {
+  if (props.scopes && props.scopes.length > 0 && !props[propName]) {
+    return new Error("Required `".concat(propName, "` when `scopes` prop type is supplied to `").concat(componentName, "`. Validation failed."));
+  }
+  for (var _len = arguments.length, rest = new Array(_len > 3 ? _len - 3 : 0), _key = 3; _key < _len; _key++) {
+    rest[_key - 3] = arguments[_key];
+  }
+  return PropTypes.string.apply(PropTypes, [props, propName, componentName].concat(rest));
+};
+
+// The types and DocGen commentary for the component props,
+// in alphabetical order (for consistency).
+// See https://www.npmjs.com/package/prop-types#usage.
+SearchBar.propTypes = {
+  /** @type {string} Optional additional class name. */
+  className: PropTypes.string,
+  /** @type {string} The label text for the search text input. */
+  clearButtonLabelText: PropTypes.string.isRequired,
+  /**
+   * Whether or not the scopes MultiSelect label is visually hidden.
+   */
+  hideScopesLabel: PropTypes.bool,
+  /** @type {string} The label text for the search text input. */
+  labelText: PropTypes.string,
+  /** @type {Function} Function handler for when the user changes their query search. */
+  onChange: PropTypes.func,
+  /** @type {Function} Function handler for when the user submits a search. */
+  onSubmit: PropTypes.func,
+  /** @type {string} Placeholder text to be displayed in the search input. */
+  placeHolderText: PropTypes.string.isRequired,
+  /** @type {Function} Function to get the text for each scope to display in dropdown. */
+  scopeToString: PropTypes.func,
+  /** @type {Array<any>} Array of allowed search scopes. */
+  scopes: PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.string, PropTypes.object])),
+  /** @type {string} The name text for the search scope type. */
+  // eslint-disable-next-line react/require-default-props
+  scopesTypeLabel: conditionalScopePropValidator,
+  /** @type {Array<any> Array of initially selected search scopes. */
+  selectedScopes: PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.string, PropTypes.object])),
+  /**
+   * Optional custom sorting algorithm for an array of scope items.
+   * By default, scope items are sorted in ascending alphabetical order,
+   * with "selected" items moved to the start of the scope items array.
+   */
+  sortItems: PropTypes.func,
+  // eslint-disable-line react/require-default-props
+
+  /** @type {string} The label text for the search submit button. */
+  submitLabel: PropTypes.string.isRequired,
+  /**
+   * Provide accessible label text for the scopes MultiSelect.
+   */
+  titleText: PropTypes.string,
+  /** @type {func} Callback function for translating MultiSelect's child ListBoxMenuIcon SVG title. */
+  translateWithId: PropTypes.func,
+  // eslint-disable-line react/require-default-props
+
+  /** @type {string} Search query value. */
+  value: PropTypes.string
+};

package/es/components/SearchBar/index.js

@@ -0,0 +1,8 @@
+/**
+ * Copyright IBM Corp. 2024, 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 { SearchBar } from './SearchBar';

package/es/components/index.js

@@ -43,7 +43,18 @@ export { EditTearsheetNarrow } from './EditTearsheetNarrow';
 export { EditFullPage } from './EditFullPage';
 export { EditUpdateCards } from './EditUpdateCards';
 export { Checklist } from './Checklist';
+export { Coachmark } from './Coachmark';
+export { CoachmarkBeacon } from './CoachmarkBeacon';
+export { CoachmarkButton } from './CoachmarkButton';
+export { CoachmarkFixed } from './CoachmarkFixed';
+export { CoachmarkOverlayElement } from './CoachmarkOverlayElement';
+export { CoachmarkOverlayElements } from './CoachmarkOverlayElements';
+export { CoachmarkStack } from './CoachmarkStack';
 export { Guidebanner, GuidebannerElement, GuidebannerElementButton, GuidebannerElementLink } from './Guidebanner';
 export { InlineTip, InlineTipButton, InlineTipLink } from './InlineTip';
 export { NonLinearReading } from './NonLinearReading';
-export { DelimitedList } from './DelimitedList';
+export { InterstitialScreen } from './InterstitialScreen';
+export { InterstitialScreenView } from './InterstitialScreenView';
+export { InterstitialScreenViewModule } from './InterstitialScreenViewModule';
+export { DelimitedList } from './DelimitedList';
+export { SearchBar } from './SearchBar';

package/es/global/js/package-settings.js

@@ -69,7 +69,18 @@ var defaults = {
     EditTearsheetNarrow: false,
     EditFullPage: false,
     EditUpdateCards: false,
+    /* new component flags here - comment used by generate CLI */
+
+    // Novice to pro components not yet reviewed and released:
+    Coachmark: false,
+    CoachmarkBeacon: false,
+    CoachmarkButton: false,
+    CoachmarkFixed: false,
+    CoachmarkOverlayElement: false,
+    CoachmarkOverlayElements: false,
+    CoachmarkStack: false,
     DelimitedList: false,
+    SearchBar: false,
     /* new component flags here - comment used by generate CLI */
 
     // Novice to pro components not yet reviewed and released:
@@ -81,6 +92,9 @@ var defaults = {
     InlineTip: false,
     InlineTipButton: false,
     InlineTipLink: false,
+    InterstitialScreen: false,
+    InterstitialScreenView: false,
+    InterstitialScreenViewModule: false,
     NonLinearReading: false
   },
   // feature level flags

package/lib/components/Card/Card.js

@@ -1,12 +1,11 @@
 "use strict";
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-var _typeof3 = require("@babel/runtime/helpers/typeof");
+var _typeof = require("@babel/runtime/helpers/typeof");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.Card = void 0;
-var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
@@ -26,7 +25,7 @@ var _excluded = ["actionIcons", "actionsPlacement", "children", "className", "cl
 // LICENSE file in the root directory of this source tree.
 //
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
-function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof3(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 var componentName = 'Card';
@@ -169,7 +168,7 @@ var Card = exports.Card = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, re
     var clickable = hasClickEvent && !productive || hasClickEvent && productive && clickZone === 'one';
     var cardProps = _objectSpread(_objectSpread({}, rest), {}, {
       ref: ref,
-      className: (0, _classnames.default)(blockClass, (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, "".concat(blockClass, "__productive"), productive), "".concat(blockClass, "__clickable"), clickable), "".concat(blockClass, "__media-left"), mediaPosition === 'left'), "".concat(blockClass, "--has-slug"), clickable && slug === true || (0, _typeof2.default)(slug) === 'object'), className)
+      className: (0, _classnames.default)(blockClass, (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, "".concat(blockClass, "__productive"), productive), "".concat(blockClass, "__clickable"), clickable), "".concat(blockClass, "__media-left"), mediaPosition === 'left'), "".concat(blockClass, "--has-slug"), !!slug), className)
     }, clickable && clickableProps);
     return cardProps;
   };

package/lib/components/Card/CardHeader.js

@@ -70,9 +70,9 @@ var CardHeader = exports.CardHeader = function CardHeader(_ref) {
   }));
   var normalizedSlug;
   if (slug) {
-    if (inClickableCard) {
+    if (inClickableCard || typeof slug === 'boolean') {
       normalizedSlug = hollowSlugIcon;
-    } else if (typeof slug !== 'boolean') {
+    } else {
       normalizedSlug = /*#__PURE__*/_react.default.cloneElement(slug, {
         size: label && title || title && titleSize === 'large' ? 'sm' : 'xs'
       });

package/lib/components/Carousel/Carousel.js

@@ -203,9 +203,11 @@ var Carousel = exports.Carousel = /*#__PURE__*/_react.default.forwardRef(functio
   (0, _react.useEffect)(function () {
     function handleWheel(event) {
       // update the scroll position
-      event.stopPropagation();
-      event.preventDefault();
-      event.cancelBubble = false;
+      if (event.shiftKey) {
+        event.stopPropagation();
+        event.preventDefault();
+        event.cancelBubble = false;
+      }
     }
     var scrollDiv = scrollRef.current;
     if (scrollDiv) {

package/lib/components/Coachmark/Coachmark.js

@@ -0,0 +1,264 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _typeof = require("@babel/runtime/helpers/typeof");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Coachmark = void 0;
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+var _react = _interopRequireWildcard(require("react"));
+var _classnames = _interopRequireDefault(require("classnames"));
+var _propTypes = _interopRequireWildcard(require("prop-types"));
+var _reactDom = require("react-dom");
+var _CoachmarkOverlay = require("./CoachmarkOverlay");
+var _context = require("./utils/context");
+var _enums = require("./utils/enums");
+var _hooks = require("./utils/hooks");
+var _devtools = require("../../global/js/utils/devtools");
+var _settings = require("../../settings");
+var _lodash = require("lodash");
+var _excluded = ["align", "children", "className", "onClose", "overlayClassName", "overlayKind", "overlayRef", "portalTarget", "positionTune", "target", "theme"];
+/**
+ * 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.
+ */
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+// The block part of our conventional BEM class names (blockClass__E--M).
+var blockClass = "".concat(_settings.pkg.prefix, "--coachmark");
+var overlayBlockClass = "".concat(blockClass, "-overlay");
+var componentName = 'Coachmark';
+var defaults = {
+  align: 'bottom',
+  onClose: function onClose() {},
+  overlayKind: 'tooltip',
+  theme: 'light'
+};
+
+/**
+ * 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.
+ */
+
+var Coachmark = exports.Coachmark = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
+  var _document$querySelect;
+  var _ref$align = _ref.align,
+    align = _ref$align === void 0 ? defaults.align : _ref$align,
+    children = _ref.children,
+    className = _ref.className,
+    _ref$onClose = _ref.onClose,
+    onClose = _ref$onClose === void 0 ? defaults.onClose : _ref$onClose,
+    overlayClassName = _ref.overlayClassName,
+    _ref$overlayKind = _ref.overlayKind,
+    overlayKind = _ref$overlayKind === void 0 ? defaults.overlayKind : _ref$overlayKind,
+    overlayRef = _ref.overlayRef,
+    portalTarget = _ref.portalTarget,
+    positionTune = _ref.positionTune,
+    target = _ref.target,
+    _ref$theme = _ref.theme,
+    theme = _ref$theme === void 0 ? defaults.theme : _ref$theme,
+    rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
+  var isBeacon = overlayKind === _enums.COACHMARK_OVERLAY_KIND.TOOLTIP;
+  var isStacked = overlayKind === _enums.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 = (0, _react.useState)(isStacked),
+    _useState2 = (0, _slicedToArray2.default)(_useState, 2),
+    isOpen = _useState2[0],
+    setIsOpen = _useState2[1];
+  var _useState3 = (0, _react.useState)(false),
+    _useState4 = (0, _slicedToArray2.default)(_useState3, 2),
+    shouldResetPosition = _useState4[0],
+    setShouldResetPosition = _useState4[1];
+  var _useState5 = (0, _react.useState)(),
+    _useState6 = (0, _slicedToArray2.default)(_useState5, 2),
+    targetRect = _useState6[0],
+    setTargetRect = _useState6[1];
+  var _useState7 = (0, _react.useState)({
+      x: 0,
+      y: 0
+    }),
+    _useState8 = (0, _slicedToArray2.default)(_useState7, 2),
+    targetOffset = _useState8[0],
+    setTargetOffset = _useState8[1];
+  var overlayBackupRef = (0, _react.useRef)();
+  var backupRef = (0, _react.useRef)();
+  var _coachmarkRef = ref || backupRef;
+  var _overlayRef = overlayRef || overlayBackupRef;
+  var closeOverlay = function closeOverlay() {
+    setIsOpen(false);
+  };
+  var handleClose = (0, _react.useCallback)(function () {
+    if (isStacked) {
+      // If stacked, do not unmount,
+      // only call its ("parent") onClose method.
+      onClose();
+    } else {
+      setIsOpen(false);
+      onClose();
+    }
+  }, [isStacked, onClose]);
+  var escFunction = (0, _react.useCallback)(function (event) {
+    if (event.key === 'Escape') {
+      handleClose();
+    }
+  }, [handleClose]);
+  (0, _react.useEffect)(function () {
+    document.addEventListener('keydown', escFunction, false);
+    return function () {
+      document.removeEventListener('keydown', escFunction, false);
+    };
+  }, [escFunction]);
+  var handleTargetClick = function handleTargetClick(e) {
+    setTargetRect(e.target.getBoundingClientRect());
+    setTargetOffset({
+      x: e.target.offsetLeft,
+      y: e.target.offsetTop
+    });
+    if (isBeacon) {
+      // toggle open/closed for beacons
+      setIsOpen(function (prevIsOpen) {
+        return !prevIsOpen;
+      });
+    } else {
+      // reset position for all other kinds
+      setIsOpen(false);
+      setShouldResetPosition(true);
+    }
+  };
+  var contextValue = {
+    buttonProps: {
+      'aria-expanded': isOpen,
+      tabIndex: 0,
+      onClick: handleTargetClick,
+      // Compensate for accidental open/close on double-click.
+      // Only open on double-click.
+      onDoubleClick: handleTargetClick
+    },
+    closeButtonProps: {
+      onClick: handleClose
+    },
+    targetRect: targetRect,
+    targetOffset: targetOffset,
+    align: align,
+    positionTune: positionTune
+  };
+  var handleResize = (0, _lodash.throttle)(function () {
+    closeOverlay();
+  }, 2000);
+
+  // instead of toggling on/off,
+  // keep open and reset to original position
+  (0, _react.useEffect)(function () {
+    if (shouldResetPosition) {
+      setShouldResetPosition(false);
+      setIsOpen(true);
+    }
+  }, [shouldResetPosition]);
+
+  // On unmount:
+  // - DO NOT "Close()" the coachmark.
+  //   - This triggers a "signal" to close it forever.
+  //   - "Closing" should only ever be a user-triggered event.
+  // - DO "hide" the coachmark.
+  //   - The app is doing the action for the user.
+  //   - The user will have the opportunity to open it again.
+  (0, _react.useEffect)(function () {
+    return function () {
+      return setIsOpen(false);
+    };
+  }, []);
+  (0, _hooks.useClickOutsideElement)(_coachmarkRef, _overlayRef, overlayKind, closeOverlay);
+  (0, _hooks.useWindowEvent)('resize', handleResize);
+  return /*#__PURE__*/_react.default.createElement(_context.CoachmarkContext.Provider, {
+    value: contextValue
+  }, /*#__PURE__*/_react.default.createElement("div", (0, _extends2.default)({
+    className: (0, _classnames.default)(blockClass, "".concat(blockClass, "__").concat(theme), className),
+    ref: _coachmarkRef
+  }, rest, (0, _devtools.getDevtoolsProps)(componentName)), target, isOpen && /*#__PURE__*/(0, _reactDom.createPortal)( /*#__PURE__*/_react.default.createElement(_CoachmarkOverlay.CoachmarkOverlay, {
+    ref: _overlayRef,
+    fixedIsVisible: false,
+    kind: overlayKind,
+    onClose: handleClose,
+    theme: theme,
+    className: (0, _classnames.default)(overlayClassName, "".concat(overlayBlockClass, "--is-visible"))
+  }, children), portalNode)));
+});
+
+// Return a placeholder if not released and not enabled by feature flag
+exports.Coachmark = Coachmark = _settings.pkg.checkComponentEnabled(Coachmark, componentName);
+
+// The display name of the component, used by React. Note that displayName
+// is used in preference to relying on function.name.
+Coachmark.displayName = componentName;
+
+// The types and DocGen commentary for the component props,
+// in alphabetical order (for consistency).
+// See https://www.npmjs.com/package/prop-types#usage.
+Coachmark.propTypes = {
+  /**
+   * Where to render the Coachmark relative to its target.
+   * Applies only to Floating and Tooltip Coachmarks.
+   * @see COACHMARK_ALIGNMENT
+   */
+  align: _propTypes.default.oneOf(['bottom', 'bottom-left', 'bottom-right', 'left', 'left-top', 'left-bottom', 'right', 'right-top', 'right-bottom', 'top', 'top-left', 'top-right']),
+  /**
+   * Coachmark should use a single CoachmarkOverlayElements component as a child.
+   * @see CoachmarkOverlayElements
+   */
+  children: _propTypes.default.node.isRequired,
+  /**
+   * Optional class name for this component.
+   */
+  className: _propTypes.default.string,
+  /**
+   * Function to call when the Coachmark closes.
+   */
+  onClose: _propTypes.default.func,
+  /**
+   * Optional class name for the Coachmark Overlay component.
+   */
+  overlayClassName: _propTypes.default.string,
+  /**
+   * What kind or style of Coachmark to render.
+   */
+  overlayKind: _propTypes.default.oneOf(['tooltip', 'floating', 'stacked']),
+  overlayRef: _propTypes.default.oneOfType([
+  // Either a function
+  _propTypes.default.func,
+  // Or the instance of a DOM native element (see the note about SSR)
+  _propTypes.default.shape({
+    current: _propTypes.default.instanceOf(_propTypes.Component)
+  })]),
+  /**
+   * By default, the Coachmark will be appended to the end of `document.body`.
+   * The Coachmark will remain persistent as the user navigates the app until
+   * the user closes the Coachmark.
+   *
+   * Alternatively, the app developer can tightly couple the Coachmark to a DOM
+   * element or other component by specifying a CSS selector. The Coachmark will
+   * remain visible as long as that element remains visible or mounted. When the
+   * element is hidden or component is unmounted, the Coachmark will disappear.
+   */
+  portalTarget: _propTypes.default.string,
+  /**
+   * Fine tune the position of the target in pixels. Applies only to Beacons.
+   */
+  positionTune: _propTypes.default.shape({
+    x: _propTypes.default.number,
+    y: _propTypes.default.number
+  }),
+  /**
+   * The optional button or beacon that the user will click to show the Coachmark.
+   */
+  target: _propTypes.default.node,
+  /**
+   * Determines the theme of the component.
+   */
+  theme: _propTypes.default.oneOf(['light', 'dark'])
+};