@carbon/ibm-products 1.55.2 → 1.56.0

package/lib/components/CoachmarkStack/CoachmarkStack.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.CoachmarkStack = 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 _reactDom = require("react-dom");
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _classnames = _interopRequireDefault(require("classnames"));
+var _devtools = require("../../global/js/utils/devtools");
+var _settings = require("../../settings");
+var _CoachmarkOverlay = require("../Coachmark/CoachmarkOverlay");
+var _CoachmarkStackHome = require("./CoachmarkStackHome");
+var _CoachmarkTagline = require("../Coachmark/CoachmarkTagline");
+var _context = require("../Coachmark/utils/context");
+var _enums = require("../Coachmark/utils/enums");
+var _excluded = ["children", "className", "onClose", "description", "media", "navLinkLabels", "portalTarget", "closeButtonLabel", "tagline", "theme", "title"];
+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; }
+var blockClass = "".concat(_settings.pkg.prefix, "--coachmark-stack");
+var elementBlockClass = "".concat(_settings.pkg.prefix, "--coachmark-stack-element");
+var componentName = 'CoachmarkStack';
+var defaults = {
+  onClose: function onClose() {},
+  // Pass through to CoachmarkStackHome
+  theme: 'light'
+};
+
+// NOTE
+// The stack is limited to a depth of two Coachmarks:
+// - a single parent CoachmarkStackHome
+// - a single child Coachmark when stacked
+// The parent will include links to all the children.
+// No child Coachmark will include links to any other child Coachmarks.
+
+/**
+ * Stacked coachmarks are used to call out specific functionality or concepts
+ * within the UI that may not be intuitive but are important for the
+ * user to gain understanding of the product's main value and discover new use cases.
+ * This variant allows the stacking of multiple coachmark overlays to be displayed by interacting with the tagline.
+ */
+var CoachmarkStack = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
+  var _document$querySelect;
+  var children = _ref.children,
+    className = _ref.className,
+    _ref$onClose = _ref.onClose,
+    onClose = _ref$onClose === void 0 ? defaults.onClose : _ref$onClose,
+    description = _ref.description,
+    media = _ref.media,
+    navLinkLabels = _ref.navLinkLabels,
+    _ref$portalTarget = _ref.portalTarget,
+    portalTarget = _ref$portalTarget === void 0 ? defaults.portalTarget : _ref$portalTarget,
+    closeButtonLabel = _ref.closeButtonLabel,
+    tagline = _ref.tagline,
+    _ref$theme = _ref.theme,
+    theme = _ref$theme === void 0 ? defaults.theme : _ref$theme,
+    title = _ref.title,
+    rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
+  var portalNode = portalTarget ? (_document$querySelect = document.querySelector(portalTarget)) !== null && _document$querySelect !== void 0 ? _document$querySelect : document.querySelector('body') : document.querySelector('body');
+  var stackHomeRef = (0, _react.useRef)();
+  var stackedCoachmarkRefs = (0, _react.useRef)([]);
+  var _useState = (0, _react.useState)(false),
+    _useState2 = (0, _slicedToArray2.default)(_useState, 2),
+    isOpen = _useState2[0],
+    setIsOpen = _useState2[1];
+  // selectedItemNumber -1 = parent close button was clicked, remove entire stack
+  // selectedItemNumber 0 = (default) the parent is visible, all children are hidden
+  // selectedItemNumber 1+ = a child is visible and stacked atop the parent
+  var _useState3 = (0, _react.useState)(0),
+    _useState4 = (0, _slicedToArray2.default)(_useState3, 2),
+    selectedItemNumber = _useState4[0],
+    setSelectedItemNumber = _useState4[1];
+  // // The parent height and width values to return to after unstacked
+  var _useState5 = (0, _react.useState)(null),
+    _useState6 = (0, _slicedToArray2.default)(_useState5, 2),
+    parentHeight = _useState6[0],
+    setParentHeight = _useState6[1];
+  // parent height = child height when stacked behind a child that is shorter
+  var childArray = _react.Children.toArray(children);
+  var mountedRef = (0, _react.useRef)();
+  // same value as CSS animation speed
+  var delayMs = 240;
+
+  // Unmount or unstack a child
+  var handleClickNavItem = function handleClickNavItem(itemNumber) {
+    setSelectedItemNumber(itemNumber);
+  };
+  var handleClose = function handleClose(isParentCloseButton) {
+    if (isParentCloseButton) {
+      // Trigger slide-out animation
+      setSelectedItemNumber(-1);
+
+      // Unmount after animation is complete
+      var timer = setTimeout(function () {
+        setIsOpen(false);
+        onClose();
+      }, delayMs);
+      return function () {
+        return clearTimeout(timer);
+      };
+    } else {
+      // Unstack child
+      setSelectedItemNumber(0);
+    }
+  };
+  var contextValue = {
+    buttonProps: {
+      'aria-expanded': isOpen,
+      onClick: function onClick() {
+        setIsOpen(true);
+      },
+      // Compensate for accidental open/close on double-click.
+      // Only open on double-click.
+      onDoubleClick: function onDoubleClick() {
+        setIsOpen(true);
+      }
+    },
+    closeButtonProps: {
+      onClick: function onClick() {
+        return handleClose(false);
+      }
+    },
+    isOpen: isOpen
+  };
+  (0, _react.useEffect)(function () {
+    mountedRef.current = true;
+    return function () {
+      mountedRef.current = false;
+    };
+  }, []);
+  (0, _react.useEffect)(function () {
+    setTimeout(function () {
+      if (stackHomeRef.current) {
+        setParentHeight(stackHomeRef.current.clientHeight);
+      }
+    }, 0);
+  }, [stackHomeRef]);
+  (0, _react.useEffect)(function () {
+    var targetSelectedItem = selectedItemNumber - 1;
+    if (!parentHeight) {
+      return;
+    }
+    stackHomeRef.current.style.height = "".concat(parentHeight, "px");
+    if (!isOpen || targetSelectedItem < 0) {
+      return;
+    }
+    var targetHomeHeight = stackedCoachmarkRefs.current[targetSelectedItem].clientHeight;
+    stackHomeRef.current.style.height = "".concat(targetHomeHeight, "px");
+  }, [selectedItemNumber, isOpen, parentHeight]);
+  var wrappedChildren = _react.Children.map(childArray, function (child, idx) {
+    var mountedClass = mountedRef.current ? "".concat(elementBlockClass, "--is-mounted") : '';
+    return /*#__PURE__*/_react.default.createElement(_CoachmarkOverlay.CoachmarkOverlay, {
+      key: idx,
+      ref: function ref(_ref2) {
+        return stackedCoachmarkRefs.current[idx] = _ref2;
+      },
+      kind: _enums.COACHMARK_OVERLAY_KIND.STACKED,
+      onClose: function onClose() {
+        return handleClose(false);
+      },
+      theme: theme,
+      fixedIsVisible: false,
+      className: (0, _classnames.default)(elementBlockClass, mountedClass, idx === selectedItemNumber - 1 && "".concat(elementBlockClass, "--is-visible"), mountedRef.current && "".concat(elementBlockClass, "--is-mounted"))
+    }, child);
+  });
+  return /*#__PURE__*/_react.default.createElement(_context.CoachmarkContext.Provider, {
+    value: contextValue
+  }, /*#__PURE__*/_react.default.createElement("div", (0, _extends2.default)({}, rest, {
+    className: (0, _classnames.default)(blockClass, "".concat(_settings.pkg.prefix, "--coachmark-overlay--stack"), className),
+    ref: ref
+  }, (0, _devtools.getDevtoolsProps)(componentName)), /*#__PURE__*/_react.default.createElement(_CoachmarkTagline.CoachmarkTagline, {
+    title: tagline,
+    onClose: onClose
+  }), /*#__PURE__*/_react.default.createElement(_CoachmarkStackHome.CoachmarkStackHome, {
+    ref: stackHomeRef,
+    className: (0, _classnames.default)("".concat(_settings.pkg.prefix, "--coachmark-overlay"), "".concat(_settings.pkg.prefix, "--coachmark-overlay__").concat(theme), elementBlockClass, selectedItemNumber > 0 && "".concat(elementBlockClass, "--is-stacked"), selectedItemNumber > 0 && "".concat(elementBlockClass, "--is-stacked__").concat(theme), isOpen && "".concat(elementBlockClass, "--is-visible"), mountedRef.current && "".concat(elementBlockClass, "--is-mounted")),
+    description: description,
+    media: media,
+    navLinkLabels: navLinkLabels,
+    onClickNavItem: handleClickNavItem,
+    onClose: function onClose() {
+      handleClose(true);
+    },
+    portalTarget: portalTarget,
+    closeButtonLabel: closeButtonLabel,
+    title: title
+  }), /*#__PURE__*/(0, _reactDom.createPortal)(wrappedChildren, portalNode)));
+});
+
+// Return a placeholder if not released and not enabled by feature flag
+exports.CoachmarkStack = CoachmarkStack;
+exports.CoachmarkStack = CoachmarkStack = _settings.pkg.checkComponentEnabled(CoachmarkStack, componentName);
+
+// The display name of the component, used by React. Note that displayName
+// is used in preference to relying on function.name.
+CoachmarkStack.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.
+CoachmarkStack.propTypes = {
+  /**
+   * CoachmarkStack should use a single CoachmarkOverlayElements component as a child.
+   */
+  children: _propTypes.default.node.isRequired,
+  /**
+   * Provide an optional class to be applied to the containing node.
+   */
+  className: _propTypes.default.string,
+  /**
+   * The label for the button that will close the Stack
+   */
+  closeButtonLabel: _propTypes.default.string,
+  // Pass through to CoachmarkStackHome
+  /**
+   * The description of the Coachmark.
+   */
+  description: _propTypes.default.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.default.oneOfType([_propTypes.default.shape({
+    render: _propTypes.default.func
+  }), _propTypes.default.shape({
+    filePaths: _propTypes.default.arrayOf(_propTypes.default.string)
+  })]),
+  /**
+   * The labels used to link to the stackable Coachmarks.
+   */
+  navLinkLabels: _propTypes.default.arrayOf(_propTypes.default.string).isRequired,
+  /**
+   * Function to call when the CoachmarkStack closes.
+   */
+  onClose: _propTypes.default.func,
+  /**
+   * Where in the DOM to render the stack.
+   * The default is `document.body`.
+   */
+  portalTarget: _propTypes.default.string,
+  /**
+   * The tagline title which will be fixed to the bottom right of the window and will serve as the display trigger.
+   */
+  tagline: _propTypes.default.string.isRequired,
+  /**
+   * Determines the theme of the component.
+   */
+  theme: _propTypes.default.oneOf(['light', 'dark']),
+  /**
+   * The title of the Coachmark.
+   */
+  title: _propTypes.default.string.isRequired
+};

package/lib/components/CoachmarkStack/CoachmarkStackHome.js

@@ -0,0 +1,160 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _typeof = require("@babel/runtime/helpers/typeof");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.CoachmarkStackHome = void 0;
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+var _react = _interopRequireWildcard(require("react"));
+var _pconsole = _interopRequireDefault(require("../../global/js/utils/pconsole"));
+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 _reactDom = require("react-dom");
+var _CoachmarkHeader = require("../Coachmark/CoachmarkHeader");
+var _SteppedAnimatedMedia = require("../SteppedAnimatedMedia");
+var _excluded = ["className", "description", "media", "navLinkLabels", "onClickNavItem", "onClose", "portalTarget", "closeButtonLabel", "title"];
+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-stacked-home");
+var overlayClass = "".concat(_settings.pkg.prefix, "--coachmark-overlay");
+var componentName = 'CoachmarkStackHome';
+
+/**
+ * DO NOT USE. This component is for the exclusive use
+ * of other Novice to Pro components.
+ */
+var CoachmarkStackHome = /*#__PURE__*/(0, _react.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 = (0, _objectWithoutProperties2.default)(_ref, _excluded);
+  if (!navLinkLabels) {
+    return _pconsole.default.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__*/(0, _reactDom.createPortal)( /*#__PURE__*/_react.default.createElement("div", (0, _extends2.default)({}, rest, {
+    className: (0, _classnames.default)(blockClass, className),
+    ref: ref,
+    role: "main"
+  }, (0, _devtools.getDevtoolsProps)(componentName)), /*#__PURE__*/_react.default.createElement(_CoachmarkHeader.CoachmarkHeader, {
+    onClose: onClose
+  }), /*#__PURE__*/_react.default.createElement("div", {
+    className: "".concat(overlayClass, "__body")
+  }, /*#__PURE__*/_react.default.createElement("div", {
+    className: "".concat(overlayClass, "-element")
+  }, !media && /*#__PURE__*/_react.default.createElement(_iconsReact.Idea20, {
+    className: "".concat(blockClass, "__icon-idea")
+  }), media && (media.render ? media.render() : /*#__PURE__*/_react.default.createElement(_SteppedAnimatedMedia.SteppedAnimatedMedia, {
+    className: "".concat(overlayClass, "__element-stepped-media"),
+    filePaths: media.filePaths,
+    playStep: 0
+  })), /*#__PURE__*/_react.default.createElement("div", {
+    className: "".concat(overlayClass, "-element__content")
+  }, title && /*#__PURE__*/_react.default.createElement("h2", {
+    className: "".concat(overlayClass, "-element__title")
+  }, title), description && /*#__PURE__*/_react.default.createElement("p", {
+    className: "".concat(overlayClass, "-element__body")
+  }, description)), /*#__PURE__*/_react.default.createElement("ul", {
+    className: "".concat(blockClass, "__nav-links")
+  }, navLinkLabels.map(function (label, index) {
+    return /*#__PURE__*/_react.default.createElement("li", {
+      key: index
+    }, /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Button, {
+      kind: "ghost",
+      size: "sm",
+      onClick: function onClick() {
+        onClickNavItem(index + 1);
+      }
+    }, label));
+  })), closeButtonLabel && /*#__PURE__*/_react.default.createElement("div", {
+    className: "".concat(overlayClass, "__footer")
+  }, /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Button, {
+    size: "sm",
+    onClick: onClose
+  }, closeButtonLabel))))), portalNode);
+});
+
+// Return a placeholder if not released and not enabled by feature flag
+exports.CoachmarkStackHome = CoachmarkStackHome;
+exports.CoachmarkStackHome = CoachmarkStackHome = _settings.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.default.string,
+  /**
+   * The label for the button that will close the stack
+   */
+  closeButtonLabel: _propTypes.default.string,
+  /**
+   * The description of the Coachmark.
+   */
+  description: _propTypes.default.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.default.oneOfType([_propTypes.default.shape({
+    render: _propTypes.default.func
+  }), _propTypes.default.shape({
+    filePaths: _propTypes.default.arrayOf(_propTypes.default.string)
+  })]),
+  /**
+   * The labels used to link to the stackable Coachmarks.
+   */
+  navLinkLabels: _propTypes.default.arrayOf(_propTypes.default.string).isRequired,
+  /**
+   * For internal use only by CoachmarkStack and CoachmarkStackHome.
+   */
+  onClickNavItem: _propTypes.default.func.isRequired,
+  /**
+   * Function to call when the stack closes.
+   */
+  onClose: _propTypes.default.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.default.string,
+  /**
+   * The title of the Coachmark.
+   */
+  title: _propTypes.default.string.isRequired
+};

package/lib/components/CoachmarkStack/index.js

@@ -0,0 +1,12 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "CoachmarkStack", {
+  enumerable: true,
+  get: function get() {
+    return _CoachmarkStack.CoachmarkStack;
+  }
+});
+var _CoachmarkStack = require("./CoachmarkStack");

package/lib/components/NotificationsPanel/NotificationsPanel.js

@@ -17,6 +17,7 @@ var _devtools = require("../../global/js/utils/devtools");
 var _hooks = require("../../global/js/hooks");
 var _settings = require("../../settings");
 var _utils = require("./utils");
+var _propsHelper = require("../../global/js/utils/props-helper");
 var _NotificationsEmptyState = require("../EmptyStates/NotificationsEmptyState");
 var _carbonComponentsReact = require("carbon-components-react");
 var _iconsReact = require("@carbon/icons-react");
@@ -285,10 +286,10 @@ var NotificationsPanel = /*#__PURE__*/_react.default.forwardRef(function (_ref,
       nowText: nowText
     })), /*#__PURE__*/_react.default.createElement("h6", {
       className: notificationHeaderClassName
-    }, notification.title), notification.description && notification.description.length && renderDescription(notification.id), notification.link && notification.link.text && notification.link.url && /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Link, {
+    }, notification.title), notification.description && notification.description.length && renderDescription(notification.id), notification.link && notification.link.text && notification.link.url && /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Link, (0, _extends2.default)({
       href: notification.link.url,
       className: "".concat(blockClass, "__notifications-link")
-    }, notification.link.text)), /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Button, {
+    }, (0, _propsHelper.prepareProps)({}, notification.link, ['text', 'url'])), notification.link.text)), /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Button, {
       kind: "ghost",
       size: "small",
       renderIcon: _iconsReact.Close16,

package/lib/components/index.js

@@ -21,6 +21,48 @@ Object.defineProperty(exports, "Cascade", {
     return _Cascade.Cascade;
   }
 });
+Object.defineProperty(exports, "Coachmark", {
+  enumerable: true,
+  get: function get() {
+    return _Coachmark.Coachmark;
+  }
+});
+Object.defineProperty(exports, "CoachmarkBeacon", {
+  enumerable: true,
+  get: function get() {
+    return _CoachmarkBeacon.CoachmarkBeacon;
+  }
+});
+Object.defineProperty(exports, "CoachmarkButton", {
+  enumerable: true,
+  get: function get() {
+    return _CoachmarkButton.CoachmarkButton;
+  }
+});
+Object.defineProperty(exports, "CoachmarkFixed", {
+  enumerable: true,
+  get: function get() {
+    return _CoachmarkFixed.CoachmarkFixed;
+  }
+});
+Object.defineProperty(exports, "CoachmarkOverlayElement", {
+  enumerable: true,
+  get: function get() {
+    return _CoachmarkOverlayElement.CoachmarkOverlayElement;
+  }
+});
+Object.defineProperty(exports, "CoachmarkOverlayElements", {
+  enumerable: true,
+  get: function get() {
+    return _CoachmarkOverlayElements.CoachmarkOverlayElements;
+  }
+});
+Object.defineProperty(exports, "CoachmarkStack", {
+  enumerable: true,
+  get: function get() {
+    return _CoachmarkStack.CoachmarkStack;
+  }
+});
 Object.defineProperty(exports, "ComboButton", {
   enumerable: true,
   get: function get() {
@@ -530,4 +572,11 @@ var _InlineEdit = require("./InlineEdit");
 var _EditInPlace = require("./EditInPlace");
 var _Guidebanner = require("./Guidebanner");
 var _NonLinearReading = require("./NonLinearReading");
+var _Coachmark = require("./Coachmark");
+var _CoachmarkFixed = require("./CoachmarkFixed");
+var _CoachmarkBeacon = require("./CoachmarkBeacon");
+var _CoachmarkButton = require("./CoachmarkButton");
+var _CoachmarkOverlayElements = require("./CoachmarkOverlayElements");
+var _CoachmarkOverlayElement = require("./CoachmarkOverlayElement");
+var _CoachmarkStack = require("./CoachmarkStack");
 var _InlineTip = require("./InlineTip");

package/lib/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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@carbon/ibm-products",
   "description": "Carbon for IBM Products",
-  "version": "1.55.2",
+  "version": "1.56.0",
   "license": "Apache-2.0",
   "main": "lib/index.js",
   "module": "es/index.js",
@@ -96,5 +96,5 @@
     "react": "^16.8.6 || ^17.0.1",
     "react-dom": "^16.8.6 || ^17.0.1"
   },
-  "gitHead": "33f2fa8f015f9d04c83142badc07c9f0905130c8"
+  "gitHead": "9f4bc491efe9aa02b6e038c0d13ba4a0757395f1"
 }

package/scss/components/Carousel/_carousel.scss

@@ -71,6 +71,9 @@
       -moz-user-select: none;
       -ms-user-select: none;
       user-select: none;
+      @media (prefers-reduced-motion) {
+        scroll-behavior: auto;
+      }
     }
   }
 }

package/scss/components/Coachmark/_index.scss

@@ -0,0 +1,11 @@
+//
+// 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 './styles/coachmark-dragbar';
+@import './styles/coachmark-header';
+@import './styles/coachmark-overlay';
+@import './styles/coachmark-tagline';

package/scss/components/Coachmark/_storybook-styles.scss

@@ -0,0 +1,20 @@
+//
+// 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 '../../global/styles/project-settings';
+
+.CoachmarkBaseExampleUsage {
+  position: relative;
+  display: inline-block;
+  max-height: 100%;
+  box-sizing: border-box;
+
+  /* stylelint-disable-next-line carbon/layout-token-use */
+  padding: 1rem;
+  margin-left: 50%;
+  transform: translateX(-50%);
+}

package/scss/components/Coachmark/styles/_coachmark-dragbar.scss

@@ -0,0 +1,74 @@
+//
+// 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.
+//
+
+/* stylelint-disable declaration-no-important */
+
+// Standard imports.
+@import '../../../global/styles/project-settings';
+@import '../../../global/styles/mixins';
+
+// Define all component styles in a mixin which is then exported using
+// the Carbon import-once mechanism.
+@mixin coachmark-dragbar {
+  // The block part of our conventional BEM class names (blockClass__E--M).
+  $block-class: #{$pkg-prefix}--coachmark-dragbar;
+
+  .#{$block-class} {
+    display: flex;
+
+    &__handle {
+      flex-grow: 1;
+      padding: $spacing-03 0 0 $spacing-03;
+      border: 0;
+      background-color: transparent;
+      text-align: left;
+
+      &:hover {
+        cursor: move;
+      }
+    }
+
+    &--close-btn {
+      width: $spacing-07;
+      height: $spacing-07;
+      margin-left: auto !important;
+
+      svg > path {
+        margin: 0;
+        fill: $inverse-01 !important;
+      }
+
+      &:hover {
+        background-color: $inverse-hover-ui !important;
+      }
+    }
+
+    &__light {
+      #{$block-class}--close-btn {
+        &:active {
+          background-color: $active-secondary;
+        }
+      }
+    }
+
+    &__dark {
+      #{$block-class}--close-btn {
+        &:active {
+          background-color: $button-tertiary-active;
+        }
+      }
+    }
+
+    svg {
+      color: $inverse-01;
+    }
+  }
+}
+
+@include exports('coachmark-dragbar') {
+  @include coachmark-dragbar;
+}