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

package/es/components/AboutModal/AboutModal.js

@@ -0,0 +1,202 @@
+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 = ["additionalInfo", "className", "closeIconDescription", "content", "copyrightText", "legalText", "links", "logo", "onClose", "open", "title"];
+
+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) { _defineProperty(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; }
+
+/**
+ * Copyright IBM Corp. 2020, 2021
+ *
+ * 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, { useState, useRef, useEffect } from 'react';
+import { useResizeDetector } from 'react-resize-detector'; // Other standard imports.
+
+import PropTypes from 'prop-types';
+import cx from 'classnames';
+import { pkg } from '../../settings';
+import uuidv4 from '../../global/js/utils/uuidv4';
+import { getDevtoolsProps } from '../../global/js/utils/devtools'; // Carbon and package components we use.
+
+import { ComposedModal, ModalHeader, ModalFooter, ModalBody, Tabs, Tab } from 'carbon-components-react'; // The block part of our conventional BEM class names (blockClass__E--M).
+
+var blockClass = "".concat(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.
+ */
+
+export var AboutModal = /*#__PURE__*/React.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 = _objectWithoutProperties(_ref, _excluded);
+
+  var _useState = useState(true),
+      _useState2 = _slicedToArray(_useState, 2),
+      hasScrollingContent = _useState2[0],
+      setHasScrollingContent = _useState2[1];
+
+  var bodyRef = useRef();
+  var contentRef = useRef();
+  var contentId = uuidv4();
+
+  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
+
+
+  useEffect(function () {
+    bodyRef.current = contentRef.current.parentElement;
+  }, [bodyRef]); // Detect resize of the ModalBody to recalculate whether scrolling is enabled
+
+  useResizeDetector({
+    onResize: handleResize,
+    targetRef: bodyRef
+  });
+  return /*#__PURE__*/React.createElement(ComposedModal, _extends({}, rest, {
+    className: cx(blockClass, // Apply the block class to the main HTML element
+    className, // Apply any supplied class names to the main HTML element.
+    _defineProperty({}, "".concat(blockClass, "--with-tabs"), additionalInfo && additionalInfo.length > 1))
+  }, _objectSpread({
+    onClose: onClose,
+    open: open,
+    ref: ref
+  }, getDevtoolsProps(componentName))), /*#__PURE__*/React.createElement("div", {
+    className: "".concat(blockClass, "__logo")
+  }, logo), /*#__PURE__*/React.createElement(ModalHeader, {
+    className: "".concat(blockClass, "__header"),
+    iconDescription: closeIconDescription,
+    label: title,
+    labelClassName: "".concat(blockClass, "__title")
+  }), /*#__PURE__*/React.createElement(ModalBody, {
+    "aria-label": hasScrollingContent ? '' : null,
+    "aria-labelledby": hasScrollingContent ? contentId : null,
+    className: "".concat(blockClass, "__body"),
+    hasScrollingContent: hasScrollingContent
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "".concat(blockClass, "__body-content"),
+    ref: contentRef,
+    id: contentId
+  }, content, /*#__PURE__*/React.createElement("div", {
+    className: "".concat(blockClass, "__links-container")
+  }, links && links.length > 0 && links.map(function (link, i) {
+    return /*#__PURE__*/React.createElement(React.Fragment, {
+      key: i
+    }, link);
+  })), legalText && /*#__PURE__*/React.createElement("p", {
+    className: "".concat(blockClass, "__legal-text")
+  }, legalText), copyrightText && /*#__PURE__*/React.createElement("p", {
+    className: "".concat(blockClass, "__copyright-text")
+  }, copyrightText))), /*#__PURE__*/React.createElement(ModalFooter, {
+    className: "".concat(blockClass, "__footer")
+  }, additionalInfo && additionalInfo.length > 0 && (additionalInfo.length === 1 ? /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("p", {
+    className: "".concat(blockClass, "__version-label")
+  }, additionalInfo[0].label), /*#__PURE__*/React.createElement("p", {
+    className: "".concat(blockClass, "__version-number")
+  }, additionalInfo[0].content)) : /*#__PURE__*/React.createElement(Tabs, {
+    className: "".concat(blockClass, "__tab-container")
+  }, additionalInfo.map(function (tab, i) {
+    return /*#__PURE__*/React.createElement(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
+
+AboutModal = 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.arrayOf(PropTypes.shape({
+    label: PropTypes.string,
+    content: PropTypes.node
+  })),
+
+  /**
+   * Provide an optional class to be applied to the modal root node.
+   */
+  className: PropTypes.string,
+
+  /**
+   * The accessibility title for the close icon.
+   */
+  closeIconDescription: PropTypes.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.node.isRequired,
+
+  /**
+   * Trademark and copyright information. Suggested format for copyright -
+   * "Copyright © 2018 Company".
+   */
+  copyrightText: PropTypes.node,
+
+  /**
+   * Text providing legal information.
+   */
+  legalText: PropTypes.node,
+
+  /**
+   * An array of Carbon `Link` components that contain links to additional
+   * information.
+   */
+  links: PropTypes.arrayOf(PropTypes.element),
+
+  /**
+   * A visual symbol used to represent the product.
+   */
+  logo: PropTypes.node.isRequired,
+
+  /**
+   * Specifies an optional handler which is called when the AboutModal
+   * is closed. Returning `false` prevents the AboutModal from closing.
+   */
+  onClose: PropTypes.func,
+
+  /**
+   * Specifies whether the AboutModal is open or not.
+   */
+  open: PropTypes.bool,
+
+  /**
+   * The title of the AboutModal is usually the product or service name.
+   */
+  title: PropTypes.node.isRequired
+};

package/es/components/AboutModal/index.js

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

package/es/components/ActionBar/ActionBar.js

@@ -0,0 +1,274 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _extends from "@babel/runtime/helpers/extends";
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
+var _excluded = ["actions", "className", "maxVisible", "menuOptionsClass", "onWidthChange", "overflowAriaLabel", "rightAlign"],
+    _excluded2 = ["key"],
+    _excluded3 = ["key"];
+
+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) { _defineProperty(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; }
+
+//
+// Copyright IBM Corp. 2020, 2021
+//
+// 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, useRef } from 'react'; // Other standard imports.
+
+import PropTypes from 'prop-types';
+import cx from 'classnames';
+import { pkg } from '../../settings';
+import { useResizeDetector } from 'react-resize-detector'; // Carbon and package components we use.
+
+import { Button } from 'carbon-components-react';
+import uuidv4 from '../../global/js/utils/uuidv4';
+import { prepareProps } from '../../global/js/utils/props-helper';
+import { ActionBarItem } from './ActionBarItem';
+import { ActionBarOverflowItems } from './ActionBarOverflowItems'; // The block part of our conventional BEM class names (blockClass__E--M).
+
+var blockClass = "".concat(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.
+ */
+
+export var ActionBar = /*#__PURE__*/React.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 = _objectWithoutProperties(_ref, _excluded);
+
+  var _useState = useState(0),
+      _useState2 = _slicedToArray(_useState, 2),
+      displayCount = _useState2[0],
+      setDisplayCount = _useState2[1];
+
+  var _useState3 = useState([]),
+      _useState4 = _slicedToArray(_useState3, 2),
+      displayedItems = _useState4[0],
+      setDisplayedItems = _useState4[1];
+
+  var _useState5 = useState([]),
+      _useState6 = _slicedToArray(_useState5, 2),
+      hiddenSizingItems = _useState6[0],
+      setHiddenSizingItems = _useState6[1];
+
+  var internalId = useRef(uuidv4());
+  var refDisplayedItems = useRef(null);
+  var sizingRef = useRef(null);
+  var sizes = useRef({}); // create hidden sizing items
+
+  useEffect(function () {
+    // Hidden action bar and items used to calculate sizes
+    setHiddenSizingItems( /*#__PURE__*/React.createElement("div", {
+      className: "".concat(blockClass, "__hidden-sizing-items"),
+      "aria-hidden": true,
+      ref: sizingRef
+    }, /*#__PURE__*/React.createElement(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 = _objectWithoutProperties(_ref2, _excluded2);
+
+      return /*#__PURE__*/React.createElement(ActionBarItem, _extends({}, rest, {
+        key: "hidden-item-".concat(key),
+        className: "".concat(blockClass, "__hidden-sizing-item")
+      }));
+    })));
+  }, [actions]); // creates displayed items based on actions, displayCount and alignment
+
+  useEffect(function () {
+    // Calculate the displayed items
+    var newDisplayedItems = actions.map(function (_ref3) {
+      var key = _ref3.key,
+          rest = _objectWithoutProperties(_ref3, _excluded3);
+
+      return /*#__PURE__*/React.createElement(ActionBarItem, _extends({}, 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.createElement(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);
+      }
+    }
+  };
+
+  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();
+  };
+
+  useResizeDetector({
+    onResize: handleActionBarItemsResize,
+    targetRef: sizingRef
+  });
+
+  var _useResizeDetector = useResizeDetector({
+    onResize: handleResize,
+    targetRef: ref
+  }),
+      outerRef = _useResizeDetector.ref;
+
+  return /*#__PURE__*/React.createElement("div", _extends({}, rest, {
+    className: cx([blockClass, className]),
+    ref: outerRef
+  }), hiddenSizingItems, /*#__PURE__*/React.createElement("div", {
+    ref: refDisplayedItems,
+    className: cx(["".concat(blockClass, "__displayed-items"), _defineProperty({}, "".concat(blockClass, "__displayed-items--right"), rightAlign)])
+  }, displayedItems));
+});
+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.arrayOf(PropTypes.shape(_objectSpread(_objectSpread({}, prepareProps(Button.propTypes, [// props not desired from Button.propTypes
+  'kind', 'size', 'tooltipPosition', 'tooltipAlignment'])), {}, {
+    // Additional props
+    key: PropTypes.string.isRequired,
+    // Redefine as form different  to Button and a key prop used by ActionBarItems
+    iconDescription: PropTypes.string.isRequired,
+    renderIcon: Button.propTypes.renderIcon.isRequired,
+    // We duplicate onClick here to improve DocGen in Storybook
+    onClick: PropTypes.func
+  }))),
+  // expects action bar item as array or in fragment,
+
+  /**
+   * className
+   */
+  className: PropTypes.string,
+
+  /**
+   * maxVisible : Maximum action bar items visible before going into the overflow menu
+   */
+  maxVisible: PropTypes.number,
+
+  /**
+   * class name applied to the overflow options
+   */
+  menuOptionsClass: PropTypes.string,
+
+  /**
+   * onItemCountChange - event reporting maxWidth
+   */
+  onWidthChange: PropTypes.func,
+
+  /**
+   * overflowAriaLabel label for open close button overflow used for action bar items that do nto fit.
+   */
+  overflowAriaLabel: PropTypes.string.isRequired,
+
+  /**
+   * align tags to right of available space
+   */
+  rightAlign: PropTypes.bool
+};
+ActionBar.defaultProps = {
+  rightAlign: false
+};

package/es/components/ActionBar/ActionBarItem.js

@@ -0,0 +1,99 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
+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) { _defineProperty(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; }
+
+//
+// Copyright IBM Corp. 2020, 2021
+//
+// 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 from 'react'; // Other standard imports.
+
+import PropTypes from 'prop-types';
+import cx from 'classnames';
+import { pkg } from '../../settings'; // Carbon and package components we use.
+
+import { Button } from 'carbon-components-react'; // The block part of our conventional BEM class names (blockClass__E--M).
+
+var componentName = 'ActionBarItem';
+var blockClass = "".concat(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
+ */
+
+export var ActionBarItem = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
+  var className = _ref.className,
+      rest = _objectWithoutProperties(_ref, _excluded);
+
+  return /*#__PURE__*/React.createElement(Button, _objectSpread(_objectSpread({}, rest), {}, {
+    ref: ref,
+    className: cx(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
+
+ActionBarItem = 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({}, Button.propTypes);
+
+var defaultProps = _objectSpread({}, 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.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.string,
+
+  /**
+   * Optional click handler
+   *
+   * (inherited from Carbon Button)
+   */
+  onClick: PropTypes.func,
+
+  /**
+   * Optional prop to allow overriding the icon rendering.
+   * Can be a React component class
+   *
+   * (inherited from Carbon Button)
+   */
+  renderIcon: PropTypes.oneOfType([PropTypes.func, PropTypes.object])
+});
+ActionBarItem.defaultProps = _objectSpread({}, defaultProps);

package/es/components/ActionBar/ActionBarOverflowItems.js

@@ -0,0 +1,70 @@
+//
+// Copyright IBM Corp. 2020, 2021
+//
+// 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, { useRef } from 'react'; // Other standard imports.
+
+import PropTypes from 'prop-types';
+import cx from 'classnames'; // Carbon and package components we use.
+
+import { OverflowMenu, OverflowMenuItem } from 'carbon-components-react';
+import uuidv4 from '../../global/js/utils/uuidv4'; // The block part of our conventional BEM class names (blockClass__E--M).
+
+import { pkg } from '../../settings';
+var blockClass = "".concat(pkg.prefix, "--action-bar-overflow-items");
+var componentName = 'ActionBar';
+export var ActionBarOverflowItems = function ActionBarOverflowItems(_ref) {
+  var className = _ref.className,
+      menuOptionsClass = _ref.menuOptionsClass,
+      overflowItems = _ref.overflowItems,
+      overflowAriaLabel = _ref.overflowAriaLabel;
+  var internalId = useRef(uuidv4());
+  return /*#__PURE__*/React.createElement(OverflowMenu, {
+    ariaLabel: overflowAriaLabel,
+    className: cx(blockClass, className),
+    direction: "bottom",
+    flipped: true,
+    menuOptionsClass: cx("".concat(blockClass, "__options"), menuOptionsClass)
+  }, React.Children.map(overflowItems, function (item) {
+    // This uses a copy of a menu item option
+    // NOTE: Cannot use a real Tooltip icon below as it uses a <button /> the
+    // div equivalent below is based on Carbon 10.25.0
+    return /*#__PURE__*/React.createElement(OverflowMenuItem, {
+      className: "".concat(blockClass, "__item"),
+      itemText: /*#__PURE__*/React.createElement("div", {
+        className: "".concat(blockClass, "__item-content"),
+        "aria-describedby": "".concat(internalId, "--item-label")
+      }, /*#__PURE__*/React.createElement("span", {
+        className: "".concat(blockClass, "__item-label"),
+        id: "".concat(internalId, "--item-label")
+      }, item.props.iconDescription), /*#__PURE__*/React.createElement(item.props.renderIcon, null))
+    });
+  }));
+};
+ActionBarOverflowItems.displayName = componentName;
+ActionBarOverflowItems.propTypes = {
+  // expects action bar item as array or in fragment,
+
+  /**
+   * className
+   */
+  className: PropTypes.string,
+
+  /**
+   * class name applied to the overflow options
+   */
+  menuOptionsClass: PropTypes.string,
+
+  /**
+   * overflowAriaLabel label for open close button overflow used for action bar items that do nto fit.
+   */
+  overflowAriaLabel: PropTypes.string,
+
+  /**
+   * overflowItems: items to bre shown in the ActionBar overflow menu
+   */
+  overflowItems: PropTypes.arrayOf(PropTypes.element)
+};

package/es/components/ActionBar/index.js

@@ -0,0 +1,8 @@
+/**
+ * Copyright IBM Corp. 2020, 2021
+ *
+ * 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 { ActionBar } from './ActionBar';
+export { ActionBarItem } from './ActionBarItem';