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

package/lib/components/Toolbar/index.js

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "Toolbar", {
+  enumerable: true,
+  get: function get() {
+    return _Toolbar.Toolbar;
+  }
+});
+Object.defineProperty(exports, "ToolbarButton", {
+  enumerable: true,
+  get: function get() {
+    return _ToolbarButton.ToolbarButton;
+  }
+});
+Object.defineProperty(exports, "ToolbarGroup", {
+  enumerable: true,
+  get: function get() {
+    return _ToolbarGroup.ToolbarGroup;
+  }
+});
+
+var _Toolbar = require("./Toolbar");
+
+var _ToolbarButton = require("./ToolbarButton");
+
+var _ToolbarGroup = require("./ToolbarGroup");

package/lib/components/UserProfileImage/UserProfileImage.js

@@ -0,0 +1,146 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.UserProfileImage = void 0;
+
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+
+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 _devtools = require("../../global/js/utils/devtools");
+
+require("../../global/js/utils/props-helper");
+
+var _settings = require("../../settings");
+
+var _iconsReact = require("@carbon/icons-react");
+
+var _carbonComponentsReact = require("carbon-components-react");
+
+var _excluded = ["backgroundColor", "className", "kind", "initials", "image", "imageDescription", "size", "theme", "tooltipText"];
+// The block part of our conventional BEM class names (blockClass__E--M).
+var blockClass = "".concat(_settings.pkg.prefix, "--user-profile-image");
+var componentName = 'UserProfileImage'; // NOTE: the component SCSS is not imported here: it is rolled up separately.
+
+/**
+ * This is a user profile image component which displays an image, or initials or icon for a user.
+ */
+
+var UserProfileImage = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
+  var backgroundColor = _ref.backgroundColor,
+      className = _ref.className,
+      kind = _ref.kind,
+      initials = _ref.initials,
+      image = _ref.image,
+      imageDescription = _ref.imageDescription,
+      size = _ref.size,
+      theme = _ref.theme,
+      tooltipText = _ref.tooltipText,
+      rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
+  var icons = {
+    user: {
+      md: _iconsReact.User20,
+      lg: _iconsReact.User24,
+      xlg: _iconsReact.User32
+    },
+    group: {
+      md: _iconsReact.Group20,
+      lg: _iconsReact.Group24,
+      xlg: _iconsReact.Group32
+    }
+  };
+
+  var formatInitials = function formatInitials() {
+    if (initials.length === 2) {
+      return initials;
+    } // RegEx takes in the display name and returns the first and last initials. Thomas Watson and Thomas J. Watson
+    // both return JW.
+
+
+    return initials.match(/(^\S\S?|\b\S)?/g).join('').match(/(^\S|\S$)?/g).join('').toUpperCase();
+  };
+
+  var FillItem = image ? function () {
+    return /*#__PURE__*/_react.default.createElement("img", {
+      alt: imageDescription,
+      src: image,
+      className: "".concat(blockClass, "__photo ").concat(blockClass, "__photo--").concat(size)
+    });
+  } : initials ? formatInitials : kind && size && icons[kind][size];
+
+  var renderUserProfileImage = function renderUserProfileImage() {
+    return /*#__PURE__*/_react.default.createElement("div", (0, _extends2.default)({}, rest, {
+      ref: ref,
+      className: (0, _classnames.default)([blockClass, className, "".concat(blockClass, "--").concat(size), "".concat(blockClass, "--").concat(theme), "".concat(blockClass, "--").concat(backgroundColor)])
+    }, (0, _devtools.getDevtoolsProps)(componentName)), /*#__PURE__*/_react.default.createElement(FillItem, null));
+  };
+
+  return FillItem && (tooltipText ? /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.TooltipIcon, {
+    tooltipText: tooltipText
+  }, renderUserProfileImage()) : renderUserProfileImage());
+}); // Return a placeholder if not released and not enabled by feature flag
+
+
+exports.UserProfileImage = UserProfileImage;
+exports.UserProfileImage = UserProfileImage = _settings.pkg.checkComponentEnabled(UserProfileImage, componentName);
+UserProfileImage.displayName = componentName;
+UserProfileImage.propTypes = {
+  /**
+   * The background color passed should match one of the background colors in the library documentation:
+   * https://pages.github.ibm.com/cdai-design/pal/patterns/user-profile-images/
+   */
+  backgroundColor: _propTypes.default.oneOf(['light-cyan', 'dark-cyan', 'light-gray', 'dark-gray', 'light-green', 'dark-green', 'light-magenta', 'dark-magenta', 'light-purple', 'dark-purple', 'light-teal', 'dark-teal']),
+
+  /**
+   * Provide an optional class to be applied to the containing node.
+   */
+  className: _propTypes.default.string,
+
+  /**
+   * When passing the image prop, supply a full path to the image to be displayed.
+   */
+  image: _propTypes.default.string,
+
+  /**
+   * When passing the image prop use the imageDescription prop to describe the image for screen reader.
+   */
+  imageDescription: _propTypes.default.string.isRequired.if(function (_ref2) {
+    var image = _ref2.image;
+    return image;
+  }),
+
+  /**
+   * When passing the initials prop, either send the initials to be used or the user's display name. The first two capital letters of the display name will be used as the initials.
+   */
+  initials: _propTypes.default.string,
+
+  /**
+   * When passing the kind prop, use either "user" or "group". The values match up to the Carbon Library icons.
+   */
+  kind: _propTypes.default.oneOf(['user', 'group']),
+
+  /**
+   * Set the size of the avatar circle
+   */
+  size: _propTypes.default.oneOf(['xlg', 'lg', 'md']).isRequired,
+
+  /**
+   * Set theme in which the component will be rendered
+   */
+  theme: _propTypes.default.oneOf(['light', 'dark']).isRequired,
+
+  /**
+   * Pass in the display name to have it shown on hover
+   */
+  tooltipText: _propTypes.default.string
+};

package/lib/components/UserProfileImage/index.js

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

package/lib/components/WebTerminal/WebTerminal.js

@@ -0,0 +1,186 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+var _typeof = require("@babel/runtime/helpers/typeof");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.WebTerminal = 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 _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _classnames = _interopRequireDefault(require("classnames"));
+
+var _settings = require("../../settings");
+
+var _iconsReact = require("@carbon/icons-react");
+
+var _carbonComponentsReact = require("carbon-components-react");
+
+var _excluded = ["children", "className", "closeTerminal", "documentationLinks", "documentationLinksIconDescription", "open", "actions", "closeIconDescription"];
+
+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 componentName = 'WebTerminal';
+var blockClass = "".concat(_settings.pkg.prefix, "--web-terminal");
+
+var WebTerminal = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
+  var _ref2;
+
+  var children = _ref.children,
+      className = _ref.className,
+      closeTerminal = _ref.closeTerminal,
+      documentationLinks = _ref.documentationLinks,
+      documentationLinksIconDescription = _ref.documentationLinksIconDescription,
+      open = _ref.open,
+      actions = _ref.actions,
+      closeIconDescription = _ref.closeIconDescription,
+      rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
+
+  var _useState = (0, _react.useState)(open),
+      _useState2 = (0, _slicedToArray2.default)(_useState, 2),
+      shouldRender = _useState2[0],
+      setRender = _useState2[1];
+
+  var showDocumentationLinks = (0, _react.useMemo)(function () {
+    return documentationLinks.length > 0;
+  }, [documentationLinks]);
+  (0, _react.useEffect)(function () {
+    if (open) {
+      setRender(true);
+    }
+  }, [open]);
+
+  var onAnimationEnd = function onAnimationEnd() {
+    if (!open) {
+      setRender(false);
+    }
+  };
+
+  return shouldRender ? /*#__PURE__*/_react.default.createElement("div", (0, _extends2.default)({}, rest, {
+    ref: ref,
+    className: (0, _classnames.default)([blockClass, (_ref2 = {}, (0, _defineProperty2.default)(_ref2, "".concat(blockClass, "--open"), open), (0, _defineProperty2.default)(_ref2, "".concat(blockClass, "--closed"), !open), (0, _defineProperty2.default)(_ref2, className, className), _ref2)]),
+    style: {
+      animation: "".concat(open ? 'webTerminalEntrance 250ms' : 'webTerminalExit 250ms')
+    },
+    onAnimationEnd: onAnimationEnd
+  }), /*#__PURE__*/_react.default.createElement("header", {
+    className: "".concat(blockClass, "__bar")
+  }, /*#__PURE__*/_react.default.createElement("div", {
+    className: "".concat(blockClass, "__actions")
+  }, showDocumentationLinks && /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.OverflowMenu, {
+    renderIcon: _iconsReact.Help16,
+    iconDescription: documentationLinksIconDescription,
+    menuOptionsClass: "".concat(blockClass, "__documentation-overflow"),
+    size: "lg"
+  }, documentationLinks.map(function (_ref3, i) {
+    var rest = (0, _extends2.default)({}, _ref3);
+    return /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.OverflowMenuItem, (0, _extends2.default)({
+      key: i
+    }, rest));
+  })), actions.map(function (_ref4) {
+    var renderIcon = _ref4.renderIcon,
+        onClick = _ref4.onClick,
+        iconDescription = _ref4.iconDescription;
+    return /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Button, {
+      key: iconDescription,
+      hasIconOnly: true,
+      renderIcon: renderIcon,
+      onClick: onClick,
+      iconDescription: iconDescription,
+      kind: "ghost"
+    });
+  })), /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Button, {
+    hasIconOnly: true,
+    renderIcon: _iconsReact.Close16,
+    kind: "ghost",
+    iconDescription: closeIconDescription,
+    onClick: closeTerminal
+  })), /*#__PURE__*/_react.default.createElement("div", {
+    className: "".concat(blockClass, "__body")
+  }, children)) : null;
+}); // Return a placeholder if not released and not enabled by feature flag
+
+
+exports.WebTerminal = WebTerminal;
+exports.WebTerminal = WebTerminal = _settings.pkg.checkComponentEnabled(WebTerminal, componentName); // The display name of the component, used by React. Note that displayName
+// is used in preference to relying on function.name.
+
+WebTerminal.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.
+
+WebTerminal.propTypes = {
+  /**
+   * An array of actions to be displayed in the web terminal header bar
+   */
+  actions: _propTypes.default.arrayOf(_propTypes.default.shape({
+    renderIcon: _propTypes.default.object.isRequired,
+    onClick: _propTypes.default.func.isRequired,
+    iconDescription: _propTypes.default.string.isRequired
+  })),
+
+  /**
+   * Provide your own terminal component as children to show up in the web terminal
+   */
+  children: _propTypes.default.oneOfType([_propTypes.default.arrayOf(_propTypes.default.node), _propTypes.default.node]).isRequired,
+
+  /**
+   * Custom classname for additional styling of the web terminal
+   */
+  className: _propTypes.default.string,
+
+  /**
+   * Icon description for the close button
+   */
+  closeIconDescription: _propTypes.default.string.isRequired,
+
+  /**
+   * Function that should set the open prop to false
+   */
+  closeTerminal: _propTypes.default.func.isRequired,
+
+  /**
+   * Array of objects for each documentation link. Each documentation link uses the prop types of OverflowMenuItems. See more: https://react.carbondesignsystem.com/?path=/docs/components-overflowmenu--default
+   */
+  documentationLinks: _propTypes.default.arrayOf(_propTypes.default.shape(_objectSpread({}, _carbonComponentsReact.OverflowMenuItem.propTypes))),
+
+  /**
+   * Icon description for the documentation link overflow menu
+   */
+  documentationLinksIconDescription: _propTypes.default.string,
+
+  /**
+   * Boolean that determines if the web terminal is opened or closed
+   */
+  open: _propTypes.default.bool.isRequired
+}; // Default values for component props. Default values are not required for
+// props that are required, nor for props where the component can apply
+// 'undefined' values reasonably. Default values should be provided when the
+// component needs to make a choice or assumption when a prop is not supplied.
+
+WebTerminal.defaultProps = {
+  actions: [],
+  documentationLinks: [],
+  documentationLinksIconDescription: 'Show documentation links',
+  className: ''
+};

package/lib/components/WebTerminal/index.js

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

package/lib/components/WebTerminal/preview-components/Navigation.js

@@ -0,0 +1,44 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _carbonComponentsReact = require("carbon-components-react");
+
+var _iconsReact = require("@carbon/icons-react");
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var Navigation = function Navigation(_ref) {
+  var openTerminal = _ref.openTerminal;
+  return /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Header, {
+    "aria-label": "IBM Platform Name"
+  }, /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.HeaderName, {
+    href: "#",
+    prefix: "IBM"
+  }, "[Platform]"), /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.HeaderGlobalBar, null, /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.HeaderGlobalAction, {
+    "aria-label": "Web terminal",
+    onClick: openTerminal
+  }, /*#__PURE__*/_react.default.createElement(_iconsReact.Terminal20, null)), /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.HeaderGlobalAction, {
+    "aria-label": "Search",
+    onClick: function onClick() {}
+  }, /*#__PURE__*/_react.default.createElement(_iconsReact.Search20, null)), /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.HeaderGlobalAction, {
+    "aria-label": "User",
+    onClick: function onClick() {}
+  }, /*#__PURE__*/_react.default.createElement(_iconsReact.User20, null))));
+};
+
+Navigation.propTypes = {
+  /**
+   * Opens the terminal
+   */
+  openTerminal: _propTypes.default.func.isRequired
+};
+var _default = Navigation;
+exports.default = _default;

package/lib/components/WebTerminal/preview-components/documentationLinks.js

@@ -0,0 +1,32 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.documentationLinks = void 0;
+var documentationLinks = [{
+  itemText: 'BX/ICP docs',
+  href: '#',
+  onClick: function onClick() {
+    return console.log('clicked');
+  }
+}, {
+  itemText: 'Kubernetes docs',
+  href: '#',
+  onClick: function onClick() {
+    return console.log('clicked');
+  }
+}, {
+  itemText: 'Docker docs',
+  href: '#',
+  onClick: function onClick() {
+    return console.log('clicked');
+  }
+}, {
+  itemText: 'Helm docs',
+  href: '#',
+  onClick: function onClick() {
+    return console.log('clicked');
+  }
+}];
+exports.documentationLinks = documentationLinks;

package/lib/components/WebTerminal/preview-components/index.js

@@ -0,0 +1,15 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "Navigation", {
+  enumerable: true,
+  get: function get() {
+    return _Navigation.default;
+  }
+});
+
+var _Navigation = _interopRequireDefault(require("./Navigation"));

package/lib/components/_Canary/Canary.js

@@ -0,0 +1,54 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Canary = void 0;
+
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+
+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 _packageSettings = _interopRequireDefault(require("../../global/js/package-settings"));
+
+var _carbonComponentsReact = require("carbon-components-react");
+
+var _excluded = ["className", "componentName"];
+// The block part of our conventional BEM class names (blockClass__E--M).
+var blockClass = "".concat(_packageSettings.default.prefix, "--canary");
+/**
+ *  Canary component used when the component requested is not yet production
+ */
+
+var Canary = function Canary(_ref
+/*, originalArgs*/
+) {
+  var className = _ref.className,
+      componentName = _ref.componentName,
+      rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
+  var instructions = "\nimport { pkg } from '@carbon/ibm-products';\n// NOTE: must happen before component is first used\npkg.component.".concat(componentName, " = true;\n");
+  return /*#__PURE__*/_react.default.createElement("div", (0, _extends2.default)({}, rest, {
+    className: (0, _classnames.default)(blockClass, className)
+  }), /*#__PURE__*/_react.default.createElement("h2", null, "This component ", /*#__PURE__*/_react.default.createElement("strong", null, componentName), " is not ready yet."), /*#__PURE__*/_react.default.createElement("p", null, "To enable it, initialize package flags before the component is first used."), /*#__PURE__*/_react.default.createElement("br", null), /*#__PURE__*/_react.default.createElement("p", null, "e.g. in main.js"), /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.CodeSnippet, {
+    type: "multi"
+  }, instructions), /*#__PURE__*/_react.default.createElement("br", null), /*#__PURE__*/_react.default.createElement("p", null, "View a live example on", ' ', /*#__PURE__*/_react.default.createElement("a", {
+    href: "https://codesandbox.io/s/example-component-olif5?file=/src/config.js"
+  }, "codesandbox"), "."));
+};
+
+exports.Canary = Canary;
+Canary.propTypes = {
+  /** Provide an optional class to be applied to the containing node */
+  className: _propTypes.default.string,
+
+  /** Name of the component that is not ready yet */
+  componentName: _propTypes.default.string.isRequired
+};

package/lib/components/_Canary/index.js

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