@carbon/ibm-products 1.55.2 → 1.56.0

package/es/components/CoachmarkStack/CoachmarkStackHome.js

@@ -0,0 +1,157 @@
+import _extends from "@babel/runtime/helpers/extends";
+import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
+var _excluded = ["className", "description", "media", "navLinkLabels", "onClickNavItem", "onClose", "portalTarget", "closeButtonLabel", "title"];
+/**
+ * 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.
+ */
+
+import React, { forwardRef } from 'react';
+import pconsole from '../../global/js/utils/pconsole';
+import PropTypes from 'prop-types';
+import cx from 'classnames';
+import { Idea20 } from '@carbon/icons-react';
+import { Button } from 'carbon-components-react';
+import { getDevtoolsProps } from '../../global/js/utils/devtools';
+import { pkg /*, carbon */ } from '../../settings';
+import { createPortal } from 'react-dom';
+import { CoachmarkHeader } from '../Coachmark/CoachmarkHeader';
+import { SteppedAnimatedMedia } from '../SteppedAnimatedMedia';
+
+// Carbon and package components we use.
+/* TODO: @import(s) of carbon components and other package components. */
+
+// The block part of our conventional BEM class names (blockClass__E--M).
+var blockClass = "".concat(pkg.prefix, "--coachmark-stacked-home");
+var overlayClass = "".concat(pkg.prefix, "--coachmark-overlay");
+var componentName = 'CoachmarkStackHome';
+
+/**
+ * DO NOT USE. This component is for the exclusive use
+ * of other Novice to Pro components.
+ */
+export var CoachmarkStackHome = /*#__PURE__*/forwardRef(function (_ref, ref) {
+  var _document$querySelect;
+  var className = _ref.className,
+    description = _ref.description,
+    media = _ref.media,
+    navLinkLabels = _ref.navLinkLabels,
+    onClickNavItem = _ref.onClickNavItem,
+    onClose = _ref.onClose,
+    portalTarget = _ref.portalTarget,
+    closeButtonLabel = _ref.closeButtonLabel,
+    title = _ref.title,
+    rest = _objectWithoutProperties(_ref, _excluded);
+  if (!navLinkLabels) {
+    return pconsole.warn("".concat(componentName, " is a Novice to Pro internal component and is not intended for general use."));
+  }
+  var portalNode = portalTarget ? (_document$querySelect = document.querySelector(portalTarget)) !== null && _document$querySelect !== void 0 ? _document$querySelect : document.querySelector('body') : document.querySelector('body');
+  return /*#__PURE__*/createPortal( /*#__PURE__*/React.createElement("div", _extends({}, rest, {
+    className: cx(blockClass, className),
+    ref: ref,
+    role: "main"
+  }, getDevtoolsProps(componentName)), /*#__PURE__*/React.createElement(CoachmarkHeader, {
+    onClose: onClose
+  }), /*#__PURE__*/React.createElement("div", {
+    className: "".concat(overlayClass, "__body")
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "".concat(overlayClass, "-element")
+  }, !media && /*#__PURE__*/React.createElement(Idea20, {
+    className: "".concat(blockClass, "__icon-idea")
+  }), media && (media.render ? media.render() : /*#__PURE__*/React.createElement(SteppedAnimatedMedia, {
+    className: "".concat(overlayClass, "__element-stepped-media"),
+    filePaths: media.filePaths,
+    playStep: 0
+  })), /*#__PURE__*/React.createElement("div", {
+    className: "".concat(overlayClass, "-element__content")
+  }, title && /*#__PURE__*/React.createElement("h2", {
+    className: "".concat(overlayClass, "-element__title")
+  }, title), description && /*#__PURE__*/React.createElement("p", {
+    className: "".concat(overlayClass, "-element__body")
+  }, description)), /*#__PURE__*/React.createElement("ul", {
+    className: "".concat(blockClass, "__nav-links")
+  }, navLinkLabels.map(function (label, index) {
+    return /*#__PURE__*/React.createElement("li", {
+      key: index
+    }, /*#__PURE__*/React.createElement(Button, {
+      kind: "ghost",
+      size: "sm",
+      onClick: function onClick() {
+        onClickNavItem(index + 1);
+      }
+    }, 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
+CoachmarkStackHome = pkg.checkComponentEnabled(CoachmarkStackHome, componentName);
+
+// The display name of the component, used by React. Note that displayName
+// is used in preference to relying on function.name.
+CoachmarkStackHome.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.
+CoachmarkStackHome.propTypes = {
+  /**
+   * Optional class name for this component.
+   */
+  className: PropTypes.string,
+  /**
+   * The label for the button that will close the stack
+   */
+  closeButtonLabel: PropTypes.string,
+  /**
+   * The description of the Coachmark.
+   */
+  description: PropTypes.node.isRequired,
+  /**
+   * 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: PropTypes.oneOfType([PropTypes.shape({
+    render: PropTypes.func
+  }), PropTypes.shape({
+    filePaths: PropTypes.arrayOf(PropTypes.string)
+  })]),
+  /**
+   * The labels used to link to the stackable Coachmarks.
+   */
+  navLinkLabels: PropTypes.arrayOf(PropTypes.string).isRequired,
+  /**
+   * For internal use only by CoachmarkStack and CoachmarkStackHome.
+   */
+  onClickNavItem: PropTypes.func.isRequired,
+  /**
+   * Function to call when the stack closes.
+   */
+  onClose: PropTypes.func.isRequired,
+  /**
+   * By default, the CoachmarkStackHome will be appended to the end of `document.body`.
+   * The CoachmarkStackHome will remain persistent as the user navigates the app until
+   * the user closes the CoachmarkStackHome.
+   *
+   * Alternatively, the app developer can tightly couple the CoachmarkStackHome to a DOM
+   * element or other component by specifying a CSS selector. The CoachmarkStackHome will
+   * remain visible as long as that element remains visible or mounted. When the
+   * element is hidden or component is unmounted, the CoachmarkStackHome will disappear.
+   */
+  portalTarget: PropTypes.string,
+  /**
+   * The title of the Coachmark.
+   */
+  title: PropTypes.string.isRequired
+};

package/es/components/CoachmarkStack/index.js

@@ -0,0 +1,8 @@
+/**
+ * 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 { CoachmarkStack } from './CoachmarkStack';

package/es/components/NotificationsPanel/NotificationsPanel.js

@@ -20,6 +20,7 @@ import { getDevtoolsProps } from '../../global/js/utils/devtools';
 import { useClickOutside } from '../../global/js/hooks';
 import { pkg } from '../../settings';
 import { timeAgo } from './utils';
+import { prepareProps } from '../../global/js/utils/props-helper';
 import { NotificationsEmptyState } from '../EmptyStates/NotificationsEmptyState';
 
 // Carbon and package components we use.
@@ -289,10 +290,10 @@ export var NotificationsPanel = /*#__PURE__*/React.forwardRef(function (_ref, re
       nowText: nowText
     })), /*#__PURE__*/React.createElement("h6", {
       className: notificationHeaderClassName
-    }, notification.title), notification.description && notification.description.length && renderDescription(notification.id), notification.link && notification.link.text && notification.link.url && /*#__PURE__*/React.createElement(Link, {
+    }, notification.title), notification.description && notification.description.length && renderDescription(notification.id), notification.link && notification.link.text && notification.link.url && /*#__PURE__*/React.createElement(Link, _extends({
       href: notification.link.url,
       className: "".concat(blockClass, "__notifications-link")
-    }, notification.link.text)), /*#__PURE__*/React.createElement(Button, {
+    }, prepareProps({}, notification.link, ['text', 'url'])), notification.link.text)), /*#__PURE__*/React.createElement(Button, {
       kind: "ghost",
       size: "small",
       renderIcon: Close16,

package/es/components/index.js

@@ -46,4 +46,11 @@ export { InlineEdit } from './InlineEdit';
 export { EditInPlace } from './EditInPlace';
 export { Guidebanner } from './Guidebanner';
 export { NonLinearReading } from './NonLinearReading';
+export { Coachmark } from './Coachmark';
+export { CoachmarkFixed } from './CoachmarkFixed';
+export { CoachmarkBeacon } from './CoachmarkBeacon';
+export { CoachmarkButton } from './CoachmarkButton';
+export { CoachmarkOverlayElements } from './CoachmarkOverlayElements';
+export { CoachmarkOverlayElement } from './CoachmarkOverlayElement';
+export { CoachmarkStack } from './CoachmarkStack';
 export { InlineTip } from './InlineTip';

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

@@ -74,7 +74,14 @@ var defaults = {
     // Novice to pro components not yet reviewed and released:
     InlineTip: false,
     Guidebanner: false,
-    NonLinearReading: false
+    NonLinearReading: false,
+    Coachmark: false,
+    CoachmarkBeacon: false,
+    CoachmarkButton: false,
+    CoachmarkFixed: false,
+    CoachmarkOverlayElement: false,
+    CoachmarkOverlayElements: false,
+    CoachmarkStack: false
     /* new component flags here - comment used by generate CLI */
   },
 

package/lib/components/Carousel/Carousel.js

@@ -59,6 +59,7 @@ var Carousel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
   var currentViewIDRef = (0, _react.useRef)(currentViewID);
   var scrollRef = (0, _react.useRef)();
   var carouselRef = (0, _react.useRef)();
+  var mountedRef = (0, _react.useRef)(true);
   var isScrollable = (0, _utils.useIsOverflow)(scrollRef);
   // Scrolling has no complete callback, nor does it return a promise.
   // Since there is no way to tell when a scroll is finished we can set a timeout.
@@ -73,7 +74,7 @@ var Carousel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
     return scrollToView(currentViewID - 1);
   }, [currentViewID, scrollToView]);
   var scrollToView = (0, _react.useCallback)(function (viewID) {
-    if (!isScrolling) {
+    if (!isScrolling && scrollRef.current && mountedRef.current) {
       var _scrollRef$current;
       var targetViewID = (0, _lodash.clamp)(viewID, 0, totalViews - 1);
       setCurrentViewID(targetViewID);
@@ -93,9 +94,11 @@ var Carousel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
     });
   }, [resolveScroll]);
   var resolveScroll = (0, _react.useCallback)(function (resolve) {
-    setIsScrolling(false);
-    var percentage = scrollPosition() / maxScroll();
-    return resolve(parseFloat(percentage.toFixed(2)));
+    if (mountedRef.current) {
+      setIsScrolling(false);
+      var percentage = scrollPosition() / maxScroll();
+      return resolve(parseFloat(percentage.toFixed(2)));
+    }
   }, []);
   var scrollPosition = function scrollPosition() {
     var _scrollRef$current2;
@@ -119,8 +122,10 @@ var Carousel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
 
   // EFFECTS
   (0, _utils.useWindowEvent)('resize', handleResize);
+  // SAVE POINT
+
   (0, _react.useEffect)(function () {
-    if (scrollableChange) {
+    if (scrollableChange && mountedRef.current) {
       scrollableChange(isScrollable);
     }
   }, [isScrollable, scrollableChange]);
@@ -160,6 +165,11 @@ var Carousel = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
       };
     }
   }, [disableArrowScroll]);
+  (0, _react.useEffect)(function () {
+    return function () {
+      mountedRef.current = false;
+    };
+  }, []);
   (0, _react.useImperativeHandle)(ref, function () {
     return {
       scrollNext: scrollNext,

package/lib/components/Coachmark/Coachmark.js

@@ -0,0 +1,247 @@
+"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"];
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+// The block part of our conventional BEM class names (blockClass__E--M).
+var blockClass = "".concat(_settings.pkg.prefix, "--coachmark");
+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 = /*#__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 = function handleClose() {
+    if (isStacked) {
+      // If stacked, do not unmount,
+      // only call its ("parent") onClose method.
+      onClose();
+    } else {
+      setIsOpen(false);
+      onClose();
+    }
+  };
+  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,
+      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: overlayClassName
+  }, children), portalNode)));
+});
+
+// Return a placeholder if not released and not enabled by feature flag
+exports.Coachmark = Coachmark;
+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']),
+  // 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
+   */
+  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'])
+};

package/lib/components/Coachmark/CoachmarkDragbar.js

@@ -0,0 +1,137 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _typeof = require("@babel/runtime/helpers/typeof");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.CoachmarkDragbar = 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 _propTypes = _interopRequireDefault(require("prop-types"));
+var _classnames = _interopRequireDefault(require("classnames"));
+var _iconsReact = require("@carbon/icons-react");
+var _carbonComponentsReact = require("carbon-components-react");
+var _devtools = require("../../global/js/utils/devtools");
+var _settings = require("../../settings");
+var _excluded = ["closeIconDescription", "onClose", "onDrag", "showCloseButton", "theme"];
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+// Carbon and package components we use.
+/* TODO: @import(s) of carbon components and other package components. */
+
+// The block part of our conventional BEM class names (blockClass__E--M).
+var blockClass = "".concat(_settings.pkg.prefix, "--coachmark-dragbar");
+var componentName = 'CoachmarkDragbar';
+var defaults = {
+  closeIconDescription: 'Close',
+  onDrag: function onDrag() {},
+  onClose: function onClose() {},
+  showCloseButton: true,
+  theme: 'light'
+};
+
+/**
+ * DO NOT USE. This component is for the exclusive use
+ * of other Novice to Pro components.
+ */
+var CoachmarkDragbar = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
+  var _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,
+    _ref$onDrag = _ref.onDrag,
+    onDrag = _ref$onDrag === void 0 ? defaults.onDrag : _ref$onDrag,
+    _ref$showCloseButton = _ref.showCloseButton,
+    showCloseButton = _ref$showCloseButton === void 0 ? defaults.showCloseButton : _ref$showCloseButton,
+    _ref$theme = _ref.theme,
+    theme = _ref$theme === void 0 ? defaults.theme : _ref$theme,
+    rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
+  var _useState = (0, _react.useState)(false),
+    _useState2 = (0, _slicedToArray2.default)(_useState, 2),
+    isDragging = _useState2[0],
+    setIsDragging = _useState2[1];
+  (0, _react.useEffect)(function () {
+    var handleDragStop = function handleDragStop() {
+      return setIsDragging(false);
+    };
+    window.addEventListener('mouseup', handleDragStop);
+    return function () {
+      window.removeEventListener('mouseup', handleDragStop);
+    };
+  }, []);
+  (0, _react.useEffect)(function () {
+    var handleDrag = function handleDrag(event) {
+      onDrag(event.movementX, event.movementY);
+    };
+    if (isDragging) {
+      window.addEventListener('mousemove', handleDrag);
+    }
+    return function () {
+      window.removeEventListener('mousemove', handleDrag);
+    };
+  }, [isDragging, onDrag]);
+  var handleDragStart = function handleDragStart() {
+    return setIsDragging(true);
+  };
+  return /*#__PURE__*/_react.default.createElement("header", (0, _extends2.default)({}, rest, {
+    className: (0, _classnames.default)(blockClass, // Apply the block class to the main HTML element
+    "".concat(blockClass, "__").concat(theme),
+    // example: `${blockClass}__template-string-class-${kind}-n-${size}`,
+    {
+      // switched classes dependant on props or state
+      // example: [`${blockClass}__here-if-small`]: size === 'sm',
+    }),
+    ref: ref
+    // role="main"
+  }, (0, _devtools.getDevtoolsProps)(componentName)), /*#__PURE__*/_react.default.createElement("button", {
+    type: "button",
+    className: "".concat(blockClass, "__handle"),
+    onMouseDown: handleDragStart
+  }, /*#__PURE__*/_react.default.createElement(_iconsReact.Draggable16, null)), showCloseButton && /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Button, {
+    kind: "ghost",
+    size: "sm",
+    renderIcon: _iconsReact.Close16,
+    iconDescription: closeIconDescription,
+    hasIconOnly: true,
+    className: "".concat(blockClass, "--close-btn"),
+    onClick: onClose
+  }));
+});
+
+// Return a placeholder if not released and not enabled by feature flag
+exports.CoachmarkDragbar = CoachmarkDragbar;
+exports.CoachmarkDragbar = CoachmarkDragbar = _settings.pkg.checkComponentEnabled(CoachmarkDragbar, componentName);
+
+// The display name of the component, used by React. Note that displayName
+// is used in preference to relying on function.name.
+CoachmarkDragbar.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.
+CoachmarkDragbar.propTypes = {
+  /**
+   * Tooltip text and aria label for the Close button icon.
+   */
+  closeIconDescription: _propTypes.default.string,
+  /**
+   * Function to call when the close button is clicked.
+   */
+  onClose: _propTypes.default.func,
+  /**
+   * Function to call when the user clicks and drags the Coachmark.
+   * For internal use only by the parent CoachmarkOverlay.
+   */
+  onDrag: _propTypes.default.func,
+  /**
+   * Show/hide the "X" close button.
+   */
+  showCloseButton: _propTypes.default.bool,
+  /**
+   * Determines the theme of the component.
+   */
+  theme: _propTypes.default.oneOf(['light', 'dark'])
+};