@carbon/ibm-products 1.0.0-rc.1 → 1.1.0

package/lib/components/AboutModal/AboutModal.js

@@ -0,0 +1,222 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+var _typeof = require("@babel/runtime/helpers/typeof");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AboutModal = void 0;
+
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _reactResizeDetector = require("react-resize-detector");
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _classnames = _interopRequireDefault(require("classnames"));
+
+var _settings = require("../../settings");
+
+var _uuidv = _interopRequireDefault(require("../../global/js/utils/uuidv4"));
+
+var _devtools = require("../../global/js/utils/devtools");
+
+var _carbonComponentsReact = require("carbon-components-react");
+
+var _excluded = ["additionalInfo", "className", "closeIconDescription", "content", "copyrightText", "legalText", "links", "logo", "onClose", "open", "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; }
+
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) { symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); } keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+
+// The block part of our conventional BEM class names (blockClass__E--M).
+var blockClass = "".concat(_settings.pkg.prefix, "--about-modal");
+var componentName = 'AboutModal'; // NOTE: the component SCSS is not imported here: it is rolled up separately.
+
+/**
+ * The AboutModal component provides a way to communicate product information
+ * to users. It is triggered by a user’s action, appears on top of the main
+ * page content, and is persistent until dismissed. The purpose of this modal
+ * should be immediately apparent to the user, with a clear and obvious path
+ * to completion.
+ */
+
+var AboutModal = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
+  var additionalInfo = _ref.additionalInfo,
+      className = _ref.className,
+      closeIconDescription = _ref.closeIconDescription,
+      content = _ref.content,
+      copyrightText = _ref.copyrightText,
+      legalText = _ref.legalText,
+      links = _ref.links,
+      logo = _ref.logo,
+      onClose = _ref.onClose,
+      open = _ref.open,
+      title = _ref.title,
+      rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
+
+  var _useState = (0, _react.useState)(true),
+      _useState2 = (0, _slicedToArray2.default)(_useState, 2),
+      hasScrollingContent = _useState2[0],
+      setHasScrollingContent = _useState2[1];
+
+  var bodyRef = (0, _react.useRef)();
+  var contentRef = (0, _react.useRef)();
+  var contentId = (0, _uuidv.default)();
+
+  var handleResize = function handleResize() {
+    setHasScrollingContent( // if our scroll height exceeds the client height enable scrolling
+    bodyRef.current.clientHeight < (hasScrollingContent ? // Carbon modal adds 32px bottom margin when scrolling content is enabled
+    bodyRef.current.scrollHeight - 32 : bodyRef.current.scrollHeight));
+  }; // We can't add a ref directly to the ModalBody, so track it in a ref
+  // as the parent of the current bodyRef element
+
+
+  (0, _react.useEffect)(function () {
+    bodyRef.current = contentRef.current.parentElement;
+  }, [bodyRef]); // Detect resize of the ModalBody to recalculate whether scrolling is enabled
+
+  (0, _reactResizeDetector.useResizeDetector)({
+    onResize: handleResize,
+    targetRef: bodyRef
+  });
+  return /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.ComposedModal, (0, _extends2.default)({}, rest, {
+    className: (0, _classnames.default)(blockClass, // Apply the block class to the main HTML element
+    className, // Apply any supplied class names to the main HTML element.
+    (0, _defineProperty2.default)({}, "".concat(blockClass, "--with-tabs"), additionalInfo && additionalInfo.length > 1))
+  }, _objectSpread({
+    onClose: onClose,
+    open: open,
+    ref: ref
+  }, (0, _devtools.getDevtoolsProps)(componentName))), /*#__PURE__*/_react.default.createElement("div", {
+    className: "".concat(blockClass, "__logo")
+  }, logo), /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.ModalHeader, {
+    className: "".concat(blockClass, "__header"),
+    iconDescription: closeIconDescription,
+    label: title,
+    labelClassName: "".concat(blockClass, "__title")
+  }), /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.ModalBody, {
+    "aria-label": hasScrollingContent ? '' : null,
+    "aria-labelledby": hasScrollingContent ? contentId : null,
+    className: "".concat(blockClass, "__body"),
+    hasScrollingContent: hasScrollingContent
+  }, /*#__PURE__*/_react.default.createElement("div", {
+    className: "".concat(blockClass, "__body-content"),
+    ref: contentRef,
+    id: contentId
+  }, content, /*#__PURE__*/_react.default.createElement("div", {
+    className: "".concat(blockClass, "__links-container")
+  }, links && links.length > 0 && links.map(function (link, i) {
+    return /*#__PURE__*/_react.default.createElement(_react.default.Fragment, {
+      key: i
+    }, link);
+  })), legalText && /*#__PURE__*/_react.default.createElement("p", {
+    className: "".concat(blockClass, "__legal-text")
+  }, legalText), copyrightText && /*#__PURE__*/_react.default.createElement("p", {
+    className: "".concat(blockClass, "__copyright-text")
+  }, copyrightText))), /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.ModalFooter, {
+    className: "".concat(blockClass, "__footer")
+  }, additionalInfo && additionalInfo.length > 0 && (additionalInfo.length === 1 ? /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, /*#__PURE__*/_react.default.createElement("p", {
+    className: "".concat(blockClass, "__version-label")
+  }, additionalInfo[0].label), /*#__PURE__*/_react.default.createElement("p", {
+    className: "".concat(blockClass, "__version-number")
+  }, additionalInfo[0].content)) : /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Tabs, {
+    className: "".concat(blockClass, "__tab-container")
+  }, additionalInfo.map(function (tab, i) {
+    return /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Tab, {
+      id: 'about-modal-tab-' + tab.label,
+      label: tab.label,
+      key: i
+    }, tab.content);
+  })))));
+}); // Return a placeholder if not released and not enabled by feature flag
+
+
+exports.AboutModal = AboutModal;
+exports.AboutModal = AboutModal = _settings.pkg.checkComponentEnabled(AboutModal, componentName);
+AboutModal.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.
+
+AboutModal.propTypes = {
+  /**
+   * Additional information to be displayed in the footer. Can be used for
+   * version information and/or a set of tabs with various contents. If only
+   * one set of additional information is provided then no tabs are
+   * displayed and the label and content are just displayed one above the
+   * other in the footer.
+   */
+  additionalInfo: _propTypes.default.arrayOf(_propTypes.default.shape({
+    label: _propTypes.default.string,
+    content: _propTypes.default.node
+  })),
+
+  /**
+   * Provide an optional class to be applied to the modal root node.
+   */
+  className: _propTypes.default.string,
+
+  /**
+   * The accessibility title for the close icon.
+   */
+  closeIconDescription: _propTypes.default.string.isRequired,
+
+  /**
+   * A summary that appears immediately beneath the title, and might
+   * include information such as: version name, server name,
+   * user name, user role, browser version, browser OS etc.
+   */
+  content: _propTypes.default.node.isRequired,
+
+  /**
+   * Trademark and copyright information. Suggested format for copyright -
+   * "Copyright © 2018 Company".
+   */
+  copyrightText: _propTypes.default.node,
+
+  /**
+   * Text providing legal information.
+   */
+  legalText: _propTypes.default.node,
+
+  /**
+   * An array of Carbon `Link` components that contain links to additional
+   * information.
+   */
+  links: _propTypes.default.arrayOf(_propTypes.default.element),
+
+  /**
+   * A visual symbol used to represent the product.
+   */
+  logo: _propTypes.default.node.isRequired,
+
+  /**
+   * Specifies an optional handler which is called when the AboutModal
+   * is closed. Returning `false` prevents the AboutModal from closing.
+   */
+  onClose: _propTypes.default.func,
+
+  /**
+   * Specifies whether the AboutModal is open or not.
+   */
+  open: _propTypes.default.bool,
+
+  /**
+   * The title of the AboutModal is usually the product or service name.
+   */
+  title: _propTypes.default.node.isRequired
+};

package/lib/components/AboutModal/index.js

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

package/lib/components/ActionBar/ActionBar.js

@@ -0,0 +1,294 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+var _typeof = require("@babel/runtime/helpers/typeof");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ActionBar = void 0;
+
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+
+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 _settings = require("../../settings");
+
+var _reactResizeDetector = require("react-resize-detector");
+
+var _carbonComponentsReact = require("carbon-components-react");
+
+var _uuidv = _interopRequireDefault(require("../../global/js/utils/uuidv4"));
+
+var _propsHelper = require("../../global/js/utils/props-helper");
+
+var _ActionBarItem = require("./ActionBarItem");
+
+var _ActionBarOverflowItems = require("./ActionBarOverflowItems");
+
+var _excluded = ["actions", "className", "maxVisible", "menuOptionsClass", "onWidthChange", "overflowAriaLabel", "rightAlign"],
+    _excluded2 = ["key"],
+    _excluded3 = ["key"];
+
+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; }
+
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) { symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); } keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+
+// The block part of our conventional BEM class names (blockClass__E--M).
+var blockClass = "".concat(_settings.pkg.prefix, "--action-bar");
+var componentName = 'ActionBar'; // NOTE: the component SCSS is not imported here: it is rolled up separately.
+
+/**
+ * The ActionBar is used internally by the PageHeader to wrap ActionBarItems.
+ */
+
+var ActionBar = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
+  var actions = _ref.actions,
+      className = _ref.className,
+      maxVisible = _ref.maxVisible,
+      menuOptionsClass = _ref.menuOptionsClass,
+      onWidthChange = _ref.onWidthChange,
+      overflowAriaLabel = _ref.overflowAriaLabel,
+      rightAlign = _ref.rightAlign,
+      rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
+
+  var _useState = (0, _react.useState)(0),
+      _useState2 = (0, _slicedToArray2.default)(_useState, 2),
+      displayCount = _useState2[0],
+      setDisplayCount = _useState2[1];
+
+  var _useState3 = (0, _react.useState)([]),
+      _useState4 = (0, _slicedToArray2.default)(_useState3, 2),
+      displayedItems = _useState4[0],
+      setDisplayedItems = _useState4[1];
+
+  var _useState5 = (0, _react.useState)([]),
+      _useState6 = (0, _slicedToArray2.default)(_useState5, 2),
+      hiddenSizingItems = _useState6[0],
+      setHiddenSizingItems = _useState6[1];
+
+  var internalId = (0, _react.useRef)((0, _uuidv.default)());
+  var refDisplayedItems = (0, _react.useRef)(null);
+  var sizingRef = (0, _react.useRef)(null);
+  var sizes = (0, _react.useRef)({}); // create hidden sizing items
+
+  (0, _react.useEffect)(function () {
+    // Hidden action bar and items used to calculate sizes
+    setHiddenSizingItems( /*#__PURE__*/_react.default.createElement("div", {
+      className: "".concat(blockClass, "__hidden-sizing-items"),
+      "aria-hidden": true,
+      ref: sizingRef
+    }, /*#__PURE__*/_react.default.createElement(_ActionBarOverflowItems.ActionBarOverflowItems, {
+      className: "".concat(blockClass, "__hidden-sizing-item"),
+      overflowAriaLabel: "hidden sizing overflow items",
+      overflowItems: [],
+      key: "hidden-overflow-menu"
+    }), actions.map(function (_ref2) {
+      var key = _ref2.key,
+          rest = (0, _objectWithoutProperties2.default)(_ref2, _excluded2);
+      return /*#__PURE__*/_react.default.createElement(_ActionBarItem.ActionBarItem, (0, _extends2.default)({}, rest, {
+        key: "hidden-item-".concat(key),
+        className: "".concat(blockClass, "__hidden-sizing-item")
+      }));
+    })));
+  }, [actions]); // creates displayed items based on actions, displayCount and alignment
+
+  (0, _react.useEffect)(function () {
+    // Calculate the displayed items
+    var newDisplayedItems = actions.map(function (_ref3) {
+      var key = _ref3.key,
+          rest = (0, _objectWithoutProperties2.default)(_ref3, _excluded3);
+      return /*#__PURE__*/_react.default.createElement(_ActionBarItem.ActionBarItem, (0, _extends2.default)({}, rest, {
+        key: key
+      }));
+    }); // extract any there is not enough room for into newOverflowItems
+
+    var newOverflowItems = newDisplayedItems.splice(displayCount); // add overflow menu if needed
+
+    if (newOverflowItems.length) {
+      newDisplayedItems.push( /*#__PURE__*/_react.default.createElement(_ActionBarOverflowItems.ActionBarOverflowItems, {
+        menuOptionsClass: menuOptionsClass,
+        overflowAriaLabel: overflowAriaLabel,
+        overflowItems: newOverflowItems,
+        key: "overflow-menu-".concat(internalId.current)
+      }));
+    }
+
+    setDisplayedItems(newDisplayedItems);
+  }, [actions, displayCount, overflowAriaLabel, menuOptionsClass]); // determine display count based on space available and width of pageActions
+
+  var checkFullyVisibleItems = function checkFullyVisibleItems() {
+    /* istanbul ignore if */
+    if (sizingRef.current) {
+      var sizingItems = Array.from(sizingRef.current.querySelectorAll(".".concat(blockClass, "__hidden-sizing-item"))); // first item is always the overflow even if nothing else is rendered
+
+      var overflowItem = sizingItems.shift(); // determine how many will fit
+
+      var spaceAvailable = refDisplayedItems.current.offsetWidth;
+      var willFit = 0;
+      var maxVisibleWidth = 0;
+      var fitLimit = maxVisible ? Math.min(maxVisible, sizingItems.length) : sizingItems.length; // loop checking the space available
+
+      for (var i = 0; i < fitLimit; i++) {
+        var newSpaceAvailable = spaceAvailable - sizingItems[i].offsetWidth; // update maxVisibleWidth for later use by onWidthChange
+
+        maxVisibleWidth += sizingItems[i].offsetWidth;
+
+        if (newSpaceAvailable >= 0) {
+          spaceAvailable = newSpaceAvailable;
+          willFit += 1;
+        }
+      } // if not enough space for all items then make room for the overflow
+
+
+      var overflowWidth = overflowItem.offsetWidth;
+
+      if (willFit < sizingItems.length) {
+        // Check space for overflow
+        while (willFit > 0 && spaceAvailable < overflowWidth) {
+          willFit -= 1; // Highly unlikely that any action bar item is narrower than the overflow item
+          // Make sure by removing items in reverse order
+
+          spaceAvailable += sizingItems[willFit].offsetWidth;
+        }
+      }
+
+      if (onWidthChange && (sizes.current.minWidth !== overflowWidth || sizes.current.maxWidth !== maxVisibleWidth)) {
+        sizes.current.minWidth = overflowWidth;
+        sizes.current.maxWidth = maxVisibleWidth; // emit onWidthChange
+
+        onWidthChange(_objectSpread({}, sizes.current));
+      }
+
+      if (willFit < 1) {
+        setDisplayCount(0);
+      } else {
+        setDisplayCount(willFit);
+      }
+    }
+  };
+
+  (0, _react.useEffect)(function () {
+    checkFullyVisibleItems(); // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [maxVisible, hiddenSizingItems]);
+  /* istanbul ignore next */
+  // not sure how to fake window resize
+
+  var handleResize = function handleResize() {
+    // width is the space available for all action bar items horizontally
+    // the action bar items are squares so the height should be one item wide
+
+    /* istanbul ignore next */
+    // not sure how to fake window resize
+    checkFullyVisibleItems();
+  };
+  /* istanbul ignore next */
+  // not sure how to fake window resize
+
+
+  var handleActionBarItemsResize = function handleActionBarItemsResize() {
+    // when the hidden sizing items change size
+
+    /* istanbul ignore next */
+    // not sure how to fake window resize
+    checkFullyVisibleItems();
+  };
+
+  (0, _reactResizeDetector.useResizeDetector)({
+    onResize: handleActionBarItemsResize,
+    targetRef: sizingRef
+  });
+
+  var _useResizeDetector = (0, _reactResizeDetector.useResizeDetector)({
+    onResize: handleResize,
+    targetRef: ref
+  }),
+      outerRef = _useResizeDetector.ref;
+
+  return /*#__PURE__*/_react.default.createElement("div", (0, _extends2.default)({}, rest, {
+    className: (0, _classnames.default)([blockClass, className]),
+    ref: outerRef
+  }), hiddenSizingItems, /*#__PURE__*/_react.default.createElement("div", {
+    ref: refDisplayedItems,
+    className: (0, _classnames.default)(["".concat(blockClass, "__displayed-items"), (0, _defineProperty2.default)({}, "".concat(blockClass, "__displayed-items--right"), rightAlign)])
+  }, displayedItems));
+});
+
+exports.ActionBar = ActionBar;
+ActionBar.displayName = componentName;
+ActionBar.propTypes = {
+  /**
+   * Specifies the action bar items. Each item is specified as an object
+   * with required fields: key for array rendering, renderIcon and
+   * iconDescription to provide the icon to display,
+   * and optional 'onClick' to receive notifications when the button is clicked.
+   * Additional fields in the object will be passed to the
+   * Button component, and these can include 'disabled', 'ref', 'className',
+   * and any other Button props.
+   *
+   * Note that the Button props 'kind', 'size',
+   * 'tooltipPosition', 'tooltipAlignment' and 'type' are ignored, as these
+   * cannot be used for an action bar item.
+   *
+   * Carbon Button API https://react.carbondesignsystem.com/?path=/docs/components-button--default#component-api
+   */
+  actions: _propTypes.default.arrayOf(_propTypes.default.shape(_objectSpread(_objectSpread({}, (0, _propsHelper.prepareProps)(_carbonComponentsReact.Button.propTypes, [// props not desired from Button.propTypes
+  'kind', 'size', 'tooltipPosition', 'tooltipAlignment'])), {}, {
+    // Additional props
+    key: _propTypes.default.string.isRequired,
+    // Redefine as form different  to Button and a key prop used by ActionBarItems
+    iconDescription: _propTypes.default.string.isRequired,
+    renderIcon: _carbonComponentsReact.Button.propTypes.renderIcon.isRequired,
+    // We duplicate onClick here to improve DocGen in Storybook
+    onClick: _propTypes.default.func
+  }))),
+  // expects action bar item as array or in fragment,
+
+  /**
+   * className
+   */
+  className: _propTypes.default.string,
+
+  /**
+   * maxVisible : Maximum action bar items visible before going into the overflow menu
+   */
+  maxVisible: _propTypes.default.number,
+
+  /**
+   * class name applied to the overflow options
+   */
+  menuOptionsClass: _propTypes.default.string,
+
+  /**
+   * onItemCountChange - event reporting maxWidth
+   */
+  onWidthChange: _propTypes.default.func,
+
+  /**
+   * overflowAriaLabel label for open close button overflow used for action bar items that do nto fit.
+   */
+  overflowAriaLabel: _propTypes.default.string.isRequired,
+
+  /**
+   * align tags to right of available space
+   */
+  rightAlign: _propTypes.default.bool
+};
+ActionBar.defaultProps = {
+  rightAlign: false
+};

package/lib/components/ActionBar/ActionBarItem.js

@@ -0,0 +1,107 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ActionBarItem = void 0;
+
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+
+var _react = _interopRequireDefault(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _classnames = _interopRequireDefault(require("classnames"));
+
+var _settings = require("../../settings");
+
+var _carbonComponentsReact = require("carbon-components-react");
+
+var _excluded = ["className"];
+
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) { symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); } keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+
+// The block part of our conventional BEM class names (blockClass__E--M).
+var componentName = 'ActionBarItem';
+var blockClass = "".concat(_settings.pkg.prefix, "--action-bar-item"); // NOTE: the component SCSS is not imported here: it is rolled up separately.
+
+/**
+ * The ActionBarItem is used in the page header to populate the action bar
+ */
+
+var ActionBarItem = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
+  var className = _ref.className,
+      rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
+  return /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Button, _objectSpread(_objectSpread({}, rest), {}, {
+    ref: ref,
+    className: (0, _classnames.default)(blockClass, className),
+    hasIconOnly: true,
+    kind: 'ghost',
+    size: 'field',
+    tooltipPosition: 'bottom',
+    tooltipAlignment: 'end',
+    type: 'button'
+  }));
+}); // Return a placeholder if not released and not enabled by feature flag
+
+
+exports.ActionBarItem = ActionBarItem;
+exports.ActionBarItem = ActionBarItem = _settings.pkg.checkComponentEnabled(ActionBarItem, componentName); // Props the user cannot change
+
+var reservedProps = ['hasIconOnly', 'kind', 'size', 'tooltipPosition', 'tooltipAlignment', 'type']; // Base props on Carbon Button
+
+var propTypes = _objectSpread({}, _carbonComponentsReact.Button.propTypes);
+
+var defaultProps = _objectSpread({}, _carbonComponentsReact.Button.defaultProps); // Remove reserved props
+
+
+reservedProps.forEach(function (prop) {
+  delete propTypes[prop];
+  delete defaultProps[prop];
+});
+ActionBarItem.displayName = componentName;
+ActionBarItem.propTypes = _objectSpread(_objectSpread({}, propTypes), {}, {
+  /* ***************************************
+  /
+  /  The declarations below allow storybook & DocGen to produce documentation.
+  /  Some or all of them may be inherited from the underlying Carbon component.
+  /
+  / ****************************************/
+
+  /**
+   * Specify an optional className to be added to your Button
+   *
+   * (inherited from Carbon Button)
+   */
+  className: _propTypes.default.string,
+
+  /**
+   * If specifying the `renderIcon` prop, provide a description for that icon that can
+   * be read by screen readers
+   *
+   * (inherited from Carbon Button)
+   */
+  iconDescription: _propTypes.default.string,
+
+  /**
+   * Optional click handler
+   *
+   * (inherited from Carbon Button)
+   */
+  onClick: _propTypes.default.func,
+
+  /**
+   * Optional prop to allow overriding the icon rendering.
+   * Can be a React component class
+   *
+   * (inherited from Carbon Button)
+   */
+  renderIcon: _propTypes.default.oneOfType([_propTypes.default.func, _propTypes.default.object])
+});
+ActionBarItem.defaultProps = _objectSpread({}, defaultProps);