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

package/lib/components/TagSet/TagSetOverflow.js

@@ -0,0 +1,147 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+var _typeof = require("@babel/runtime/helpers/typeof");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.TagSetOverflow = void 0;
+
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _classnames = _interopRequireDefault(require("classnames"));
+
+var _carbonComponentsReact = require("carbon-components-react");
+
+var _settings = require("../../settings");
+
+var _pconsole = require("../../global/js/utils/pconsole");
+
+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; }
+
+//
+// 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.
+//
+var componentName = 'TagSetOverflow';
+var blockClass = "".concat(_settings.pkg.prefix, "--tag-set-overflow");
+
+var TagSetOverflow = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
+  var className = _ref.className,
+      overflowTags = _ref.overflowTags,
+      onShowAllClick = _ref.onShowAllClick,
+      overflowAlign = _ref.overflowAlign,
+      overflowDirection = _ref.overflowDirection,
+      showAllTagsLabel = _ref.showAllTagsLabel,
+      allTagsModalSearchThreshold = _ref.allTagsModalSearchThreshold;
+
+  var _useState = (0, _react.useState)(false),
+      _useState2 = (0, _slicedToArray2.default)(_useState, 2),
+      tipOpen = _useState2[0],
+      setTipOpen = _useState2[1];
+
+  var overflowTagContent = (0, _react.useRef)(null);
+
+  var handleChange = function handleChange(ev, _ref2) {
+    var open = _ref2.open;
+    setTipOpen(open);
+  };
+
+  var handleShowAllTagsClick = function handleShowAllTagsClick(ev) {
+    ev.stopPropagation();
+    ev.preventDefault();
+    setTipOpen(false);
+    onShowAllClick();
+  };
+
+  return /*#__PURE__*/_react.default.createElement("span", {
+    "aria-hidden": overflowTags.length === 0,
+    className: (0, _classnames.default)("".concat(blockClass), (0, _defineProperty2.default)({}, "".concat(blockClass, "--hidden"), overflowTags.length === 0)),
+    ref: ref
+  }, /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Tooltip, {
+    align: overflowAlign,
+    className: (0, _classnames.default)(className, "".concat(blockClass, "__tooltip")),
+    direction: overflowDirection,
+    onChange: handleChange,
+    open: tipOpen,
+    triggerText: /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Tag, {
+      onClick: _pconsole.noop
+    }, "+", overflowTags.length),
+    showIcon: false
+  }, /*#__PURE__*/_react.default.createElement("div", {
+    ref: overflowTagContent,
+    className: "".concat(blockClass, "__content")
+  }, /*#__PURE__*/_react.default.createElement("ul", {
+    className: "".concat(blockClass, "__tag-list")
+  }, overflowTags.filter(function (_, index) {
+    return overflowTags.length > allTagsModalSearchThreshold ? index < allTagsModalSearchThreshold : index <= allTagsModalSearchThreshold;
+  }).map(function (tag, index) {
+    return /*#__PURE__*/_react.default.createElement("li", {
+      className: "".concat(blockClass, "__tag-item"),
+      key: index
+    }, /*#__PURE__*/_react.default.cloneElement(tag, {
+      filter: false
+    }));
+  })), overflowTags.length > allTagsModalSearchThreshold && /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Link, {
+    className: "".concat(blockClass, "__show-all-tags-link"),
+    href: "",
+    onClick: handleShowAllTagsClick,
+    role: "button"
+  }, showAllTagsLabel))));
+});
+
+exports.TagSetOverflow = TagSetOverflow;
+TagSetOverflow.displayName = componentName;
+TagSetOverflow.propTypes = {
+  /**
+   * count of overflowTags over which a modal is offered
+   */
+  allTagsModalSearchThreshold: _propTypes.default.number,
+
+  /**
+   * className
+   */
+  className: _propTypes.default.string,
+
+  /**
+   * function to execute on clicking show all
+   */
+  onShowAllClick: _propTypes.default.func.isRequired,
+
+  /**
+   * overflowAlign from the standard tooltip
+   */
+  overflowAlign: _propTypes.default.oneOf(['start', 'center', 'end']),
+
+  /**
+   * overflowDirection from the standard tooltip
+   */
+  overflowDirection: _propTypes.default.oneOf(['top', 'right', 'bottom', 'left']),
+
+  /**
+   * tags shown in overflow
+   */
+  overflowTags: _propTypes.default.arrayOf(_propTypes.default.object).isRequired,
+
+  /**
+   * label for the overflow show all tags link
+   */
+  showAllTagsLabel: _propTypes.default.string
+};
+TagSetOverflow.defaultProps = {
+  allTagsModalSearchThreshold: 10,
+  overflowAlign: 'center',
+  overflowDirection: 'bottom'
+};

package/lib/components/TagSet/index.js

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

package/lib/components/Tearsheet/Tearsheet.js

@@ -0,0 +1,192 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.deprecatedProps = exports.Tearsheet = void 0;
+
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+
+var _react = _interopRequireDefault(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _devtools = require("../../global/js/utils/devtools");
+
+var _propsHelper = require("../../global/js/utils/props-helper");
+
+var _settings = require("../../settings");
+
+var _carbonComponentsReact = require("carbon-components-react");
+
+var _ActionSet = require("../ActionSet");
+
+var _TearsheetShell = require("./TearsheetShell");
+
+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 = 'Tearsheet'; // NOTE: the component SCSS is not imported here: it is rolled up separately.
+
+/**
+ * A tearsheet is a mostly full-screen type of dialog that keeps users
+ * in-context and focused by bringing actionable content front and center while
+ * revealing parts of the UI behind it. There is also a narrow variant of the
+ * tearsheet.
+ *
+ * A tearsheet comprises up to 5 zones, allowing for flexibility depending on
+ * the content: a heading area including a title, an optional navigation area
+ * that sits just below the heading, an optional influencer which is a side
+ * panel on either the left or right side, the main content area, and a set of
+ * action buttons.
+ */
+
+var Tearsheet = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
+  return /*#__PURE__*/_react.default.createElement(_TearsheetShell.TearsheetShell, (0, _extends2.default)({}, (0, _devtools.getDevtoolsProps)(componentName), (0, _propsHelper.prepareProps)(props, [], {
+    ref: ref,
+    size: 'wide'
+  })));
+}); // Return a placeholder if not released and not enabled by feature flag
+
+
+exports.Tearsheet = Tearsheet;
+exports.Tearsheet = Tearsheet = _settings.pkg.checkComponentEnabled(Tearsheet, componentName); // The display name of the component, used by React. Note that displayName
+// is used in preference to relying on function.name.
+
+Tearsheet.displayName = componentName;
+var deprecatedProps = {
+  /**
+   * **Deprecated**
+   *
+   * The position of the top of tearsheet in the viewport. The 'normal'
+   * position is a short distance down from the top of the
+   * viewport, leaving room at the top for a global header bar to show through
+   * from below. The 'lower' position (the default) provides a little extra room at the top
+   * to allow an action bar navigation or breadcrumbs to also show through.
+   */
+  verticalPosition: _propTypes.default.oneOf(['normal', 'lower'])
+}; // The types and DocGen commentary for the component props,
+// in alphabetical order (for consistency).
+// See https://www.npmjs.com/package/prop-types#usage.
+// Note that the descriptions here should be kept in sync with those for the
+// corresponding props for TearsheetNarrow and TearsheetShell components.
+
+exports.deprecatedProps = deprecatedProps;
+Tearsheet.propTypes = _objectSpread({
+  /**
+   * The navigation actions to be shown as buttons in the action area at the
+   * bottom of the tearsheet. Each action is specified as an object with
+   * optional fields: 'label' to supply the button label, 'kind' to select the
+   * button kind (must be 'primary', 'secondary' or 'ghost'), 'loading' to
+   * display a loading indicator, and '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. Any other fields in the object will be passed
+   * through to the button element as HTML attributes.
+   *
+   * See https://react.carbondesignsystem.com/?path=/docs/components-button--default#component-api
+   */
+  actions: (0, _propsHelper.allPropTypes)([_ActionSet.ActionSet.validateActions(function () {
+    return 'max';
+  }), _propTypes.default.arrayOf(_propTypes.default.shape(_objectSpread(_objectSpread({}, _carbonComponentsReact.Button.propTypes), {}, {
+    kind: _propTypes.default.oneOf(['ghost', 'secondary', 'primary']),
+    label: _propTypes.default.string,
+    loading: _propTypes.default.bool,
+    // we duplicate this Button prop to improve the DocGen here
+    onClick: _carbonComponentsReact.Button.propTypes.onClick
+  })))]),
+
+  /**
+   * An optional class or classes to be added to the outermost element.
+   */
+  className: _propTypes.default.string,
+
+  /**
+   * The accessibility title for the close icon (if shown).
+   *
+   * **Note:** This prop is only required if a close icon is shown, i.e. if
+   * there are a no navigation actions and/or hasCloseIcon is true.
+   */
+  closeIconDescription: _propTypes.default.string.isRequired.if(function (_ref) {
+    var actions = _ref.actions,
+        hasCloseIcon = _ref.hasCloseIcon;
+    return (0, _TearsheetShell.tearsheetHasCloseIcon)(actions, hasCloseIcon);
+  }),
+
+  /**
+   * A description of the flow, displayed in the header area of the tearsheet.
+   */
+  description: _propTypes.default.node,
+
+  /**
+   * Enable a close icon ('x') in the header area of the tearsheet. By default,
+   * (when this prop is omitted, or undefined or null) a tearsheet does not
+   * display a close icon if there are navigation actions ("transactional
+   * tearsheet") and displays one if there are no navigation actions ("passive
+   * tearsheet"), and that behavior can be overridden if required by setting
+   * this prop to either true or false.
+   */
+  hasCloseIcon: _propTypes.default.bool,
+
+  /**
+   * The content for the influencer section of the tearsheet, displayed
+   * alongside the main content. This is typically a menu, or filter, or
+   * progress indicator, or similar.
+   */
+  influencer: _propTypes.default.element,
+
+  /**
+   * The position of the influencer section, 'left' or 'right'.
+   */
+  influencerPosition: _propTypes.default.oneOf(['left', 'right']),
+
+  /**
+   * The width of the influencer: 'narrow' (the default) is 256px, and 'wide'
+   * is 320px.
+   */
+  influencerWidth: _propTypes.default.oneOf(['narrow', 'wide']),
+
+  /**
+   * A label for the tearsheet, displayed in the header area of the tearsheet
+   * to maintain context for the tearsheet (e.g. as the title changes from page
+   * to page of a multi-page task).
+   */
+  label: _propTypes.default.node,
+
+  /**
+   * Navigation content, such as a set of tabs, to be displayed at the bottom
+   * of the header area of the tearsheet.
+   */
+  navigation: _propTypes.default.element,
+
+  /**
+   * An optional handler that is called when the user closes the tearsheet (by
+   * clicking the close button, if enabled, or clicking outside, if enabled).
+   * Returning `false` here prevents the modal from closing.
+   */
+  onClose: _propTypes.default.func,
+
+  /**
+   * Specifies whether the tearsheet is currently open.
+   */
+  open: _propTypes.default.bool,
+
+  /**
+   * The main title of the tearsheet, displayed in the header area.
+   */
+  title: _propTypes.default.node
+}, deprecatedProps); // 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.
+
+Tearsheet.defaultProps = {
+  influencerPosition: 'left',
+  influencerWidth: 'narrow',
+  verticalPosition: 'lower'
+};

package/lib/components/Tearsheet/TearsheetNarrow.js

@@ -0,0 +1,160 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.deprecatedProps = exports.TearsheetNarrow = void 0;
+
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+
+var _react = _interopRequireDefault(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _devtools = require("../../global/js/utils/devtools");
+
+var _propsHelper = require("../../global/js/utils/props-helper");
+
+var _settings = require("../../settings");
+
+var _carbonComponentsReact = require("carbon-components-react");
+
+var _ActionSet = require("../ActionSet");
+
+var _TearsheetShell = require("./TearsheetShell");
+
+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 = 'TearsheetNarrow'; // NOTE: the component SCSS is not imported here: it is rolled up separately.
+
+/**
+ * A narrow tearsheet is a slimmer variant of the tearsheet, providing a dialog
+ * that keeps users in-context and focused by bringing actionable content front
+ * and center while revealing more of the UI behind it.
+ *
+ * A narrow tearsheet comprises 3 zones: a heading area including a title, the
+ * main content area, and a set of action buttons.
+ */
+
+var TearsheetNarrow = /*#__PURE__*/_react.default.forwardRef(function (props, ref) {
+  return /*#__PURE__*/_react.default.createElement(_TearsheetShell.TearsheetShell, (0, _extends2.default)({}, (0, _devtools.getDevtoolsProps)(componentName), (0, _propsHelper.prepareProps)(props, _TearsheetShell.tearsheetShellWideProps, {
+    ref: ref,
+    size: 'narrow'
+  })));
+}); // Return a placeholder if not released and not enabled by feature flag
+
+
+exports.TearsheetNarrow = TearsheetNarrow;
+exports.TearsheetNarrow = TearsheetNarrow = _settings.pkg.checkComponentEnabled(TearsheetNarrow, componentName); // The display name of the component, used by React. Note that displayName
+// is used in preference to relying on function.name.
+
+TearsheetNarrow.displayName = componentName;
+var deprecatedProps = {
+  /**
+   * **Deprecated**
+   *
+   * The position of the top of tearsheet in the viewport. The 'normal'
+   * position is a short distance down from the top of the
+   * viewport, leaving room at the top for a global header bar to show through
+   * from below. The 'lower' position (the default) provides a little extra room at the top
+   * to allow an action bar navigation or breadcrumbs to also show through.
+   */
+  verticalPosition: _propTypes.default.oneOf(['normal', 'lower'])
+}; // The types and DocGen commentary for the component props,
+// in alphabetical order (for consistency).
+// See https://www.npmjs.com/package/prop-types#usage.
+// Note that the descriptions here should be kept in sync with those for the
+// corresponding props for Tearsheet and TearsheetShell components.
+
+exports.deprecatedProps = deprecatedProps;
+TearsheetNarrow.propTypes = _objectSpread({
+  /**
+   * The navigation actions to be shown as buttons in the action area at the
+   * bottom of the tearsheet. Each action is specified as an object with
+   * optional fields: 'label' to supply the button label, 'kind' to select the
+   * button kind (must be 'primary', 'secondary' or 'ghost'), 'loading' to
+   * display a loading indicator, and '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. Any other fields in the object will be passed
+   * through to the button element as HTML attributes.
+   *
+   * See https://react.carbondesignsystem.com/?path=/docs/components-button--default#component-api
+   */
+  actions: (0, _propsHelper.allPropTypes)([_ActionSet.ActionSet.validateActions(function () {
+    return 'lg';
+  }), _propTypes.default.arrayOf(_propTypes.default.shape(_objectSpread(_objectSpread({}, _carbonComponentsReact.Button.propTypes), {}, {
+    kind: _propTypes.default.oneOf(['ghost', 'secondary', 'primary']),
+    label: _propTypes.default.string,
+    loading: _propTypes.default.bool,
+    // we duplicate this Button prop to improve the DocGen here
+    onClick: _carbonComponentsReact.Button.propTypes.onClick
+  })))]),
+
+  /**
+   * An optional class or classes to be added to the outermost element.
+   */
+  className: _propTypes.default.string,
+
+  /**
+   * The accessibility title for the close icon (if shown).
+   *
+   * **Note:** This prop is only required if a close icon is shown, i.e. if
+   * there are a no navigation actions and/or hasCloseIcon is true.
+   */
+  closeIconDescription: _propTypes.default.string.isRequired.if(function (_ref) {
+    var actions = _ref.actions,
+        hasCloseIcon = _ref.hasCloseIcon;
+    return (0, _TearsheetShell.tearsheetHasCloseIcon)(actions, hasCloseIcon);
+  }),
+
+  /**
+   * A description of the flow, displayed in the header area of the tearsheet.
+   */
+  description: _propTypes.default.node,
+
+  /**
+   * Enable a close icon ('x') in the header area of the tearsheet. By default,
+   * a tearsheet does not display a close icon, but one should be enabled if
+   * the tearsheet is read-only or has no navigation actions (sometimes called
+   * a "passive tearsheet").
+   */
+  hasCloseIcon: _propTypes.default.bool,
+
+  /**
+   * A label for the tearsheet, displayed in the header area of the tearsheet
+   * to maintain context for the tearsheet (e.g. as the title changes from page
+   * to page of a multi-page task).
+   */
+  label: _propTypes.default.node,
+
+  /**
+   * An optional handler that is called when the user closes the tearsheet (by
+   * clicking the close button, if enabled, or clicking outside, if enabled).
+   * Returning `false` here prevents the modal from closing.
+   */
+  onClose: _propTypes.default.func,
+
+  /**
+   * Specifies whether the tearsheet is currently open.
+   */
+  open: _propTypes.default.bool,
+
+  /**
+   * The main title of the tearsheet, displayed in the header area.
+   */
+  title: _propTypes.default.node
+}, deprecatedProps); // 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.
+
+TearsheetNarrow.defaultProps = {
+  verticalPosition: 'lower'
+};