@carbon/ibm-products 1.0.0-rc.0 → 1.0.1

package/lib/components/EmptyStates/index.js

@@ -0,0 +1,61 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "EmptyState", {
+  enumerable: true,
+  get: function get() {
+    return _EmptyState.EmptyState;
+  }
+});
+Object.defineProperty(exports, "ErrorEmptyState", {
+  enumerable: true,
+  get: function get() {
+    return _ErrorEmptyState.ErrorEmptyState;
+  }
+});
+Object.defineProperty(exports, "NoDataEmptyState", {
+  enumerable: true,
+  get: function get() {
+    return _NoDataEmptyState.NoDataEmptyState;
+  }
+});
+Object.defineProperty(exports, "NoTagsEmptyState", {
+  enumerable: true,
+  get: function get() {
+    return _NoTagsEmptyState.NoTagsEmptyState;
+  }
+});
+Object.defineProperty(exports, "NotFoundEmptyState", {
+  enumerable: true,
+  get: function get() {
+    return _NotFoundEmptyState.NotFoundEmptyState;
+  }
+});
+Object.defineProperty(exports, "NotificationsEmptyState", {
+  enumerable: true,
+  get: function get() {
+    return _NotificationsEmptyState.NotificationsEmptyState;
+  }
+});
+Object.defineProperty(exports, "UnauthorizedEmptyState", {
+  enumerable: true,
+  get: function get() {
+    return _UnauthorizedEmptyState.UnauthorizedEmptyState;
+  }
+});
+
+var _EmptyState = require("./EmptyState");
+
+var _ErrorEmptyState = require("./ErrorEmptyState");
+
+var _NoDataEmptyState = require("./NoDataEmptyState");
+
+var _NoTagsEmptyState = require("./NoTagsEmptyState");
+
+var _NotFoundEmptyState = require("./NotFoundEmptyState");
+
+var _NotificationsEmptyState = require("./NotificationsEmptyState");
+
+var _UnauthorizedEmptyState = require("./UnauthorizedEmptyState");

package/lib/components/ExampleComponent/ExampleComponent.js

@@ -0,0 +1,169 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ExampleComponent = void 0;
+
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+
+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 = ["borderColor", "boxedBorder", "className", "disabled", "onPrimaryClick", "onSecondaryClick", "primaryButtonLabel", "primaryKind", "secondaryButtonLabel", "secondaryKind", "size", "style"];
+
+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, "--example-component");
+var componentName = 'ExampleComponent'; // NOTE: the component SCSS is not imported here: it is rolled up separately.
+
+/**
+ * This is an example component to show relevant conventions and usage.
+ */
+
+var ExampleComponent = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
+  var borderColor = _ref.borderColor,
+      boxedBorder = _ref.boxedBorder,
+      className = _ref.className,
+      disabled = _ref.disabled,
+      onPrimaryClick = _ref.onPrimaryClick,
+      onSecondaryClick = _ref.onSecondaryClick,
+      primaryButtonLabel = _ref.primaryButtonLabel,
+      primaryKind = _ref.primaryKind,
+      secondaryButtonLabel = _ref.secondaryButtonLabel,
+      secondaryKind = _ref.secondaryKind,
+      size = _ref.size,
+      style = _ref.style,
+      rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
+  var modeClass = boxedBorder ? "".concat(blockClass, "--boxed-set") : "".concat(blockClass, "--shadow-set");
+
+  var handlePrimaryClick = function handlePrimaryClick(e) {
+    if (onPrimaryClick) {
+      onPrimaryClick(e);
+    }
+  };
+
+  var handleSecondaryClick = function handleSecondaryClick(e) {
+    if (onSecondaryClick) {
+      onSecondaryClick(e);
+    }
+  };
+
+  return /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.ButtonSet, (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.
+    "".concat(blockClass, "--").concat(size), modeClass),
+    ref: ref,
+    role: "main",
+    style: _objectSpread(_objectSpread({}, style), {}, (0, _defineProperty2.default)({}, "--".concat(blockClass, "--border-color"), borderColor))
+  }), /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Button, {
+    className: "".concat(blockClass, "__secondary-button"),
+    kind: secondaryKind,
+    onClick: handleSecondaryClick,
+    disabled: disabled,
+    size: size
+  }, secondaryButtonLabel), /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Button, {
+    className: "".concat(blockClass, "__primary-button"),
+    kind: primaryKind,
+    onClick: handlePrimaryClick,
+    disabled: disabled,
+    size: size
+  }, primaryButtonLabel));
+}); // Return a placeholder if not released and not enabled by feature flag.
+
+
+exports.ExampleComponent = ExampleComponent;
+exports.ExampleComponent = ExampleComponent = _settings.pkg.checkComponentEnabled(ExampleComponent, componentName); // The display name of the component, used by React. Note that displayName
+// is used in preference to relying on function.name.
+
+ExampleComponent.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.
+
+ExampleComponent.propTypes = {
+  /**
+   * What border color (HTML color value) to use.
+   */
+  borderColor: _propTypes.default.string,
+
+  /**
+   * If true, the border is a box, otherwise it is a shadow.
+   */
+  boxedBorder: _propTypes.default.bool,
+
+  /**
+   * Provide an optional class to be applied to the containing node.
+   */
+  className: _propTypes.default.string,
+
+  /**
+   * If true, the buttons are disabled, otherwise they can be used.
+   */
+  disabled: _propTypes.default.bool,
+
+  /**
+   * An optional primary button click handler.
+   */
+  onPrimaryClick: _propTypes.default.func,
+
+  /**
+   * An optional secondary button click handler.
+   */
+  onSecondaryClick: _propTypes.default.func,
+
+  /**
+   * The primary button label.
+   */
+  primaryButtonLabel: _propTypes.default.string.isRequired,
+
+  /**
+   * The kind of button for the primary button ('primary' or 'danger').
+   */
+  primaryKind: _propTypes.default.oneOf(['primary', 'danger']),
+
+  /**
+   * The secondary button label.
+   */
+  secondaryButtonLabel: _propTypes.default.string.isRequired,
+
+  /**
+   * The kind of button for the secondary button ('secondary' or 'tertiary').
+   */
+  secondaryKind: _propTypes.default.oneOf(['secondary', 'tertiary']),
+
+  /**
+   * The size for the buttons ('default', 'small' or 'field').
+   */
+  size: _propTypes.default.oneOf(['default', 'small', 'field']),
+
+  /**
+   * Optional style settings for the containing node.
+   */
+  style: _propTypes.default.object
+}; // 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.
+
+ExampleComponent.defaultProps = {
+  boxedBorder: false,
+  primaryKind: 'primary',
+  secondaryKind: 'secondary',
+  size: 'default'
+};

package/lib/components/ExampleComponent/index.js

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

package/lib/components/ExportModal/ExportModal.js

@@ -0,0 +1,298 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+var _typeof = require("@babel/runtime/helpers/typeof");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ExportModal = 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 _carbonComponentsReact = require("carbon-components-react");
+
+var _classnames = _interopRequireDefault(require("classnames"));
+
+var _iconsReact = require("@carbon/icons-react");
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _devtools = require("../../global/js/utils/devtools");
+
+var _uuidv = _interopRequireDefault(require("../../global/js/utils/uuidv4"));
+
+var _settings = require("../../settings");
+
+var _excluded = ["body", "className", "error", "errorMessage", "filename", "inputLabel", "invalidInputText", "loading", "loadingMessage", "onClose", "onRequestSubmit", "open", "preformattedExtensions", "preformattedExtensionsLabel", "primaryButtonText", "secondaryButtonText", "successMessage", "successful", "title", "validExtensions"];
+
+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; }
+
+var componentName = 'ExportModal';
+var ExportModal = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
+  var _preformattedExtensio;
+
+  var body = _ref.body,
+      className = _ref.className,
+      error = _ref.error,
+      errorMessage = _ref.errorMessage,
+      filename = _ref.filename,
+      inputLabel = _ref.inputLabel,
+      invalidInputText = _ref.invalidInputText,
+      loading = _ref.loading,
+      loadingMessage = _ref.loadingMessage,
+      onClose = _ref.onClose,
+      onRequestSubmit = _ref.onRequestSubmit,
+      open = _ref.open,
+      preformattedExtensions = _ref.preformattedExtensions,
+      preformattedExtensionsLabel = _ref.preformattedExtensionsLabel,
+      primaryButtonText = _ref.primaryButtonText,
+      secondaryButtonText = _ref.secondaryButtonText,
+      successMessage = _ref.successMessage,
+      successful = _ref.successful,
+      title = _ref.title,
+      validExtensions = _ref.validExtensions,
+      rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
+
+  var _useState = (0, _react.useState)(filename),
+      _useState2 = (0, _slicedToArray2.default)(_useState, 2),
+      name = _useState2[0],
+      setName = _useState2[1];
+
+  var _useState3 = (0, _react.useState)(false),
+      _useState4 = (0, _slicedToArray2.default)(_useState3, 2),
+      dirtyInput = _useState4[0],
+      setDirtyInput = _useState4[1]; // by default (if it exists) use the first extension in the extension array
+
+
+  var _useState5 = (0, _react.useState)(preformattedExtensions === null || preformattedExtensions === void 0 ? void 0 : (_preformattedExtensio = preformattedExtensions[0]) === null || _preformattedExtensio === void 0 ? void 0 : _preformattedExtensio.extension),
+      _useState6 = (0, _slicedToArray2.default)(_useState5, 2),
+      extension = _useState6[0],
+      setExtension = _useState6[1];
+
+  var onNameChangeHandler = function onNameChangeHandler(evt) {
+    setName(evt.target.value);
+  };
+
+  var onExtensionChangeHandler = function onExtensionChangeHandler(value) {
+    setExtension(value);
+  };
+
+  var onBlurHandler = function onBlurHandler() {
+    setDirtyInput(true);
+  };
+
+  var onSubmitHandler = function onSubmitHandler() {
+    var returnName = extension ? "".concat(filename, ".").concat(extension.toLocaleLowerCase()) : name;
+    onRequestSubmit(returnName);
+  };
+
+  var hasInvalidExtension = function hasInvalidExtension() {
+    if (!dirtyInput || !validExtensions || !validExtensions.length) {
+      return false;
+    }
+
+    if (!name.includes('.')) {
+      return true;
+    }
+
+    var ext = name.split('.').pop();
+
+    if (!validExtensions.includes(ext)) {
+      return true;
+    }
+
+    return false;
+  };
+
+  var blockClass = "".concat(_settings.pkg.prefix, "--export-modal");
+  var internalId = (0, _react.useRef)((0, _uuidv.default)());
+  var primaryButtonDisabled = loading || !name || hasInvalidExtension();
+  var submitted = loading || error || successful;
+  return /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.ComposedModal, (0, _extends2.default)({}, rest, {
+    className: (0, _classnames.default)(blockClass, className),
+    "aria-label": title,
+    size: "sm",
+    preventCloseOnClickOutside: true
+  }, _objectSpread({
+    open: open,
+    ref: ref,
+    onClose: onClose
+  }, (0, _devtools.getDevtoolsProps)(componentName))), /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.ModalHeader, {
+    className: "".concat(blockClass, "__header"),
+    title: title
+  }), /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.ModalBody, {
+    className: "".concat(blockClass, "__body-container")
+  }, !submitted && /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, body && /*#__PURE__*/_react.default.createElement("p", {
+    className: "".concat(blockClass, "__body")
+  }, body), preformattedExtensions.length ? /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.FormGroup, {
+    legendText: preformattedExtensionsLabel
+  }, /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.RadioButtonGroup, {
+    orientation: "vertical",
+    onChange: onExtensionChangeHandler,
+    valueSelected: extension,
+    name: "extensions"
+  }, preformattedExtensions.map(function (o) {
+    return /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.RadioButton, {
+      key: o.extension,
+      id: o.extension,
+      value: o.extension,
+      labelText: "".concat(o.extension, " (").concat(o.description, ")")
+    });
+  }))) : /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.TextInput, {
+    id: "text-input--".concat(internalId.current),
+    value: name,
+    onChange: onNameChangeHandler,
+    labelText: inputLabel,
+    invalid: hasInvalidExtension(),
+    invalidText: invalidInputText,
+    onBlur: onBlurHandler
+  })), /*#__PURE__*/_react.default.createElement("div", {
+    className: "".concat(blockClass, "__messaging")
+  }, loading && /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Loading, {
+    small: true,
+    withOverlay: false
+  }), /*#__PURE__*/_react.default.createElement("p", null, loadingMessage)), successful && /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, /*#__PURE__*/_react.default.createElement(_iconsReact.CheckmarkFilled16, {
+    className: "".concat(blockClass, "__checkmark-icon")
+  }), /*#__PURE__*/_react.default.createElement("p", null, successMessage)), error && /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, /*#__PURE__*/_react.default.createElement(_iconsReact.ErrorFilled16, {
+    className: "".concat(blockClass, "__error-icon")
+  }), /*#__PURE__*/_react.default.createElement("p", null, errorMessage)))), !submitted && /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.ModalFooter, {
+    className: "".concat(blockClass, "__footer")
+  }, /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Button, {
+    type: "button",
+    kind: "secondary",
+    onClick: onClose
+  }, secondaryButtonText), /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Button, {
+    type: "submit",
+    kind: "primary",
+    onClick: onSubmitHandler,
+    disabled: primaryButtonDisabled
+  }, primaryButtonText)));
+}); // Return a placeholder if not released and not enabled by feature flag
+
+exports.ExportModal = ExportModal;
+exports.ExportModal = ExportModal = _settings.pkg.checkComponentEnabled(ExportModal, componentName);
+ExportModal.propTypes = {
+  /**
+   * Body content for the modal
+   */
+  body: _propTypes.default.string,
+
+  /**
+   * Optional class name
+   */
+  className: _propTypes.default.string,
+
+  /**
+   * specify if an error occurred
+   */
+  error: _propTypes.default.bool,
+
+  /**
+   * messaging to display in the event of an error
+   */
+  errorMessage: _propTypes.default.string,
+
+  /**
+   * name of the file being exported
+   */
+  filename: _propTypes.default.string.isRequired,
+
+  /**
+   * label for the text input
+   */
+  inputLabel: _propTypes.default.string,
+
+  /**
+   * text for an invalid input
+   */
+  invalidInputText: _propTypes.default.string,
+
+  /**
+   * specify if the modal is in a loading state
+   */
+  loading: _propTypes.default.bool,
+
+  /**
+   * message to display during the loading state
+   */
+  loadingMessage: _propTypes.default.string,
+
+  /**
+   * Specify a handler for closing modal
+   */
+  onClose: _propTypes.default.func,
+
+  /**
+   * Specify a handler for "submitting" modal. Returns the file name
+   */
+  onRequestSubmit: _propTypes.default.func,
+
+  /**
+   * Specify whether the Modal is currently open
+   */
+  open: _propTypes.default.bool,
+
+  /**
+   * Array of extensions to display as radio buttons
+   */
+  preformattedExtensions: _propTypes.default.arrayOf(_propTypes.default.shape({
+    extension: _propTypes.default.string,
+    description: _propTypes.default.string
+  })),
+
+  /**
+   * Label for the preformatted label form group
+   */
+  preformattedExtensionsLabel: _propTypes.default.string,
+
+  /**
+   * Specify the text for the primary button
+   */
+  primaryButtonText: _propTypes.default.string.isRequired,
+
+  /**
+   * Specify the text for the secondary button
+   */
+  secondaryButtonText: _propTypes.default.string.isRequired,
+
+  /**
+   * messaging to display if the export was successful
+   */
+  successMessage: _propTypes.default.string,
+
+  /**
+   * specify if the export was successful
+   */
+  successful: _propTypes.default.bool,
+
+  /**
+   * The text displayed at the top of the modal
+   */
+  title: _propTypes.default.string.isRequired,
+
+  /**
+   * array of valid extensions the file can have
+   */
+  validExtensions: _propTypes.default.array
+};
+ExportModal.defaultProps = {
+  preformattedExtensions: [],
+  validExtensions: []
+};
+ExportModal.displayName = componentName;

package/lib/components/ExportModal/index.js

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