@carbon/react 0.17.0 → 1.0.0-rc.0

package/lib/node_modules/use-resize-observer/polyfilled.js

@@ -0,0 +1,120 @@
+/**
+ * Copyright IBM Corp. 2016, 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.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
+require('../resize-observer-polyfill/dist/ResizeObserver.es.js');
+var ResizeObserver_es = require('../../_virtual/ResizeObserver.es.js');
+var React = require('react');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
+
+function _interopDefault$1(ex) {
+  return ex && _rollupPluginBabelHelpers["typeof"](ex) === 'object' && 'default' in ex ? ex['default'] : ex;
+}
+
+var ResizeObserver = _interopDefault$1(ResizeObserver_es["default"]);
+
+var react = React__default["default"];
+
+function useResizeObserver(opts) {
+  if (opts === void 0) {
+    opts = {};
+  } // `defaultRef` Has to be non-conditionally declared here whether or not it'll
+  // be used as that's how hooks work.
+  // @see https://reactjs.org/docs/hooks-rules.html#explanation
+
+
+  var defaultRef = react.useRef(null); // Saving the callback as a ref. With this, I don't need to put onResize in the
+  // effect dep array, and just passing in an anonymous function without memoising
+  // will not reinstantiate the hook's ResizeObserver
+
+  var onResize = opts.onResize;
+  var onResizeRef = react.useRef(undefined);
+  onResizeRef.current = onResize; // Using a single instance throughought the hook's lifetime
+
+  var resizeObserverRef = react.useRef();
+  var ref = opts.ref || defaultRef;
+
+  var _useState = react.useState({
+    width: undefined,
+    height: undefined
+  }),
+      size = _useState[0],
+      setSize = _useState[1]; // Using a ref to track the previous width / height to avoid unnecessary renders
+
+
+  var previous = react.useRef({
+    width: undefined,
+    height: undefined
+  });
+  react.useEffect(function () {
+    if (resizeObserverRef.current) {
+      return;
+    }
+
+    resizeObserverRef.current = new ResizeObserver(function (entries) {
+      if (!Array.isArray(entries)) {
+        return;
+      } // Since we only observe the one element, we don't need to loop over the
+      // array
+
+
+      if (!entries.length) {
+        return;
+      }
+
+      var entry = entries[0]; // `Math.round` is in line with how CSS resolves sub-pixel values
+
+      var newWidth = Math.round(entry.contentRect.width);
+      var newHeight = Math.round(entry.contentRect.height);
+
+      if (previous.current.width !== newWidth || previous.current.height !== newHeight) {
+        var newSize = {
+          width: newWidth,
+          height: newHeight
+        };
+
+        if (onResizeRef.current) {
+          onResizeRef.current(newSize);
+        } else {
+          previous.current.width = newWidth;
+          previous.current.height = newHeight;
+          setSize(newSize);
+        }
+      }
+    });
+  }, []);
+  react.useEffect(function () {
+    if (_rollupPluginBabelHelpers["typeof"](ref) !== "object" || ref === null || !(ref.current instanceof Element)) {
+      return;
+    }
+
+    var element = ref.current;
+    resizeObserverRef.current.observe(element);
+    return function () {
+      return resizeObserverRef.current.unobserve(element);
+    };
+  }, [ref]);
+  return react.useMemo(function () {
+    return {
+      ref: ref,
+      width: size.width,
+      height: size.height
+    };
+  }, [ref, size ? size.width : null, size ? size.height : null]);
+}
+
+var polyfilled = useResizeObserver;
+var useResizeObserver$1 = polyfilled;
+
+exports["default"] = useResizeObserver$1;

package/lib/prop-types/AriaPropTypes.js

@@ -0,0 +1,24 @@
+/**
+ * Copyright IBM Corp. 2016, 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.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var PropTypes = require('prop-types');
+var isRequiredOneOf = require('./isRequiredOneOf.js');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
+
+var AriaLabelPropType = isRequiredOneOf["default"]({
+  'aria-label': PropTypes__default["default"].string,
+  'aria-labelledby': PropTypes__default["default"].string
+});
+
+exports.AriaLabelPropType = AriaLabelPropType;

package/lib/prop-types/deprecate.js

@@ -0,0 +1,37 @@
+/**
+ * Copyright IBM Corp. 2016, 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.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _rollupPluginBabelHelpers = require('../_virtual/_rollupPluginBabelHelpers.js');
+var warning = require('../internal/warning.js');
+
+var didWarnAboutDeprecation = {};
+function deprecate(propType, message) {
+  function checker(props, propName, componentName) {
+    if (props[propName] === undefined) {
+      return;
+    }
+
+    if (!didWarnAboutDeprecation[componentName] || !didWarnAboutDeprecation[componentName][propName]) {
+      didWarnAboutDeprecation[componentName] = _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, didWarnAboutDeprecation[componentName]), {}, _rollupPluginBabelHelpers.defineProperty({}, propName, true));
+      process.env.NODE_ENV !== "production" ? warning.warning(false, message || "The prop `".concat(propName, "` has been deprecated for the ") + "".concat(componentName, " component. It will be removed in the next major ") + "release") : void 0;
+    }
+
+    for (var _len = arguments.length, rest = new Array(_len > 3 ? _len - 3 : 0), _key = 3; _key < _len; _key++) {
+      rest[_key - 3] = arguments[_key];
+    }
+
+    return propType.apply(void 0, [props, propName, componentName].concat(rest));
+  }
+
+  return checker;
+}
+
+exports["default"] = deprecate;

package/lib/prop-types/isRequiredOneOf.js

@@ -0,0 +1,51 @@
+/**
+ * Copyright IBM Corp. 2016, 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.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _rollupPluginBabelHelpers = require('../_virtual/_rollupPluginBabelHelpers.js');
+
+/**
+ * Copyright IBM Corp. 2016, 2018
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/**
+ * @param {object<string, Function>} propTypes The list of type checkers, keyed by prop names.
+ * @returns {object<string, Function>}
+ *   The new prop type checkers that checks if one of the given props exist,
+ *   in addition to the original type checkings.
+ */
+function isRequiredOneOf(propTypes) {
+  var names = Object.keys(propTypes);
+
+  var checker = function checker(propType) {
+    return function (props, propName, componentName) {
+      if (process.env.NODE_ENV !== "production" && names.every(function (name) {
+        return typeof props[name] === 'undefined';
+      })) {
+        return new Error("".concat(componentName, " requires one of the following props: ").concat(names.join(', ')));
+      }
+
+      for (var _len = arguments.length, rest = new Array(_len > 3 ? _len - 3 : 0), _key = 3; _key < _len; _key++) {
+        rest[_key - 3] = arguments[_key];
+      }
+
+      return propType.apply(void 0, [props, propName, componentName].concat(rest));
+    };
+  };
+
+  return names.reduce(function (o, name) {
+    return _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, o), {}, _rollupPluginBabelHelpers.defineProperty({}, name, checker(propTypes[name])));
+  }, {});
+}
+
+exports["default"] = isRequiredOneOf;

package/lib/prop-types/requiredIfGivenPropIsTruthy.js

@@ -0,0 +1,33 @@
+/**
+ * Copyright IBM Corp. 2016, 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.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * @param {Function} name The name of the prop that must exist to validate
+ * the current prop.
+ * @param {Function} propType The original prop type checker.
+ * @returns {Function} The new prop type checker for the current prop that
+ * becomes required if the prop corresponding to the provided prop name exists.
+ */
+function requiredIfGivenPropIsTruthy(name, propType) {
+  return function check(props, propName, componentName) {
+    if (process.env.NODE_ENV !== "production" && props[name] == true && props[propName] == null) {
+      return new Error("You must provide a value for `".concat(propName, "` in `").concat(componentName, "` if `").concat(name, "` exists."));
+    }
+
+    for (var _len = arguments.length, rest = new Array(_len > 3 ? _len - 3 : 0), _key = 3; _key < _len; _key++) {
+      rest[_key - 3] = arguments[_key];
+    }
+
+    return propType.apply(void 0, [props, propName, componentName].concat(rest));
+  };
+}
+
+exports["default"] = requiredIfGivenPropIsTruthy;

package/lib/prop-types/requiredIfValueExists.js

@@ -0,0 +1,36 @@
+/**
+ * Copyright IBM Corp. 2016, 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.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * @param {Function} propType The original prop type checker.
+ * @returns {Function} The new prop type checker for `onChange` that makes it required if `value` exists and `readOnly` does not exist.
+ */
+function requiredIfValueExists(propType) {
+  return function check(props, propName, componentName) {
+    var onChange = props[propName],
+        value = props.value,
+        readOnly = props.readOnly;
+    var exists = onChange !== undefined;
+    var valueExists = value !== undefined;
+
+    if (process.env.NODE_ENV !== "production" && !exists && valueExists && !readOnly) {
+      return new Error("You provided a value prop to `".concat(componentName, "` without an `onChange` handler. ") + 'This will render a read-only field. ' + 'If the field should be mutable use `defaultValue`. Otherwise, set either `onChange` or `readOnly`.');
+    }
+
+    for (var _len = arguments.length, rest = new Array(_len > 3 ? _len - 3 : 0), _key = 3; _key < _len; _key++) {
+      rest[_key - 3] = arguments[_key];
+    }
+
+    return propType.apply(void 0, [props, propName, componentName].concat(rest));
+  };
+}
+
+exports["default"] = requiredIfValueExists;

package/lib/prop-types/types.js

@@ -0,0 +1,14 @@
+/**
+ * Copyright IBM Corp. 2016, 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.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var ButtonKinds = ['primary', 'secondary', 'danger', 'ghost', 'danger--primary', 'danger--ghost', 'danger--tertiary', 'tertiary'];
+
+exports.ButtonKinds = ButtonKinds;

package/lib/tools/array.js

@@ -0,0 +1,36 @@
+/**
+ * Copyright IBM Corp. 2016, 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.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * Shallow compare two arrays for equality
+ * @param {Array} arr1 the first array
+ * @param {Array} arr2 the second array
+ * @returns {boolean} true if both arrays have the same contents, otherwise false
+ */
+function equals(arr1, arr2) {
+  if (!Array.isArray(arr1) || !Array.isArray(arr2) || arr1.length !== arr2.length) {
+    return false;
+  }
+
+  if (arr1 === arr2) {
+    return true;
+  }
+
+  for (var i = 0; i < arr1.length; i++) {
+    if (arr1[i] !== arr2[i]) {
+      return false;
+    }
+  }
+
+  return true;
+}
+
+exports.equals = equals;

package/lib/tools/createPropAdapter.js

@@ -0,0 +1,67 @@
+/**
+ * Copyright IBM Corp. 2016, 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.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _rollupPluginBabelHelpers = require('../_virtual/_rollupPluginBabelHelpers.js');
+
+/**
+ * Copyright IBM Corp. 2016, 2018
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/**
+ * Create an adapter that converts an object of props with potentially deprecated
+ * prop names to the replacement prop names in a newer version. Useful for guarding
+ * against breaking changes when a prop has been renamed
+ *
+ * @param {Array} spec - an array of options which specify a text or regex
+ * matcher alongside a replacement if there is a match
+ * @returns {Function}
+ */
+function createPropAdapter(spec) {
+  // if props aren't passed in we should default the prop to empty object
+  return function () {
+    var input = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+    var output = {};
+    Object.keys(input).forEach(function (key) {
+      var match = spec.find(function (_ref) {
+        var _ref2 = _rollupPluginBabelHelpers.slicedToArray(_ref, 1),
+            regex = _ref2[0];
+
+        return key.match(regex);
+      });
+
+      if (match) {
+        var _match = _rollupPluginBabelHelpers.slicedToArray(match, 2),
+            regex = _match[0],
+            replacer = _match[1];
+
+        output[key.replace(regex, replacer)] = input[key];
+        return;
+      }
+
+      output[key] = input[key];
+    });
+    return output;
+  };
+}
+/**
+ * TODO: REMOVE IN v11
+ * props staring with "default..." were changed to "initial..." in Downshift v3
+ *
+ * @see https://github.com/downshift-js/downshift/releases/tag/v3.0.0
+ */
+
+
+var mapDownshiftProps = createPropAdapter([[/^default/g, 'initial']]);
+
+exports.mapDownshiftProps = mapDownshiftProps;

package/lib/tools/events.js

@@ -0,0 +1,39 @@
+/**
+ * Copyright IBM Corp. 2016, 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.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * Generic utility to compose event handlers so that consumers can supply their
+ * own event listeners on table components. The default heuristic here is to
+ * iterate through the given functions until `preventDefault` is called on the
+ * given event.
+ *
+ * @param {Array<Function>} fns array of functions to apply to the event
+ * @returns {Function}
+ */
+var composeEventHandlers = function composeEventHandlers(fns) {
+  return function (event) {
+    for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+      args[_key - 1] = arguments[_key];
+    }
+
+    for (var i = 0; i < fns.length; i++) {
+      if (event.defaultPrevented) {
+        break;
+      }
+
+      if (typeof fns[i] === 'function') {
+        fns[i].apply(fns, [event].concat(args));
+      }
+    }
+  };
+};
+
+exports.composeEventHandlers = composeEventHandlers;

package/lib/tools/mergeRefs.js

@@ -0,0 +1,35 @@
+/**
+ * Copyright IBM Corp. 2016, 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.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * @param {...Ref<Element>} refs List of React refs to merge.
+ * @returns {Ref<Element>} Merged React ref.
+ */
+var mergeRefs = function mergeRefs() {
+  for (var _len = arguments.length, refs = new Array(_len), _key = 0; _key < _len; _key++) {
+    refs[_key] = arguments[_key];
+  }
+
+  return function (el) {
+    refs.forEach(function (ref) {
+      // https://github.com/facebook/react/issues/13029#issuecomment-410002316
+      if (typeof ref === 'function') {
+        ref(el);
+      } else if (Object(ref) === ref) {
+        ref.current = el;
+      }
+    });
+  };
+};
+
+var mergeRefs$1 = mergeRefs;
+
+exports["default"] = mergeRefs$1;

package/lib/tools/setupGetInstanceId.js

@@ -0,0 +1,23 @@
+/**
+ * Copyright IBM Corp. 2016, 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.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * Generic utility to initialize a method that will return a unique instance id
+ * for a component.
+ */
+function setupGetInstanceId() {
+  var instanceId = 0;
+  return function getInstanceId() {
+    return ++instanceId;
+  };
+}
+
+exports["default"] = setupGetInstanceId;

package/lib/tools/toggleClass.js

@@ -0,0 +1,18 @@
+/**
+ * Copyright IBM Corp. 2016, 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.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+function toggleClass(element, name, add) {
+  if (element.classList.contains(name) === !add) {
+    element.classList[add ? 'add' : 'remove'](name);
+  }
+}
+
+exports["default"] = toggleClass;

package/lib/tools/uniqueId.js

@@ -0,0 +1,19 @@
+/**
+ * Copyright IBM Corp. 2016, 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.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var lastId = 0;
+function uniqueId() {
+  var prefix = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'id';
+  lastId++;
+  return "".concat(prefix).concat(lastId);
+}
+
+exports["default"] = uniqueId;

package/lib/tools/wrapComponent.js

@@ -0,0 +1,52 @@
+/**
+ * Copyright IBM Corp. 2016, 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.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _rollupPluginBabelHelpers = require('../_virtual/_rollupPluginBabelHelpers.js');
+var React = require('react');
+var PropTypes = require('prop-types');
+var cx = require('classnames');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
+var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
+var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
+
+var _excluded = ["className"];
+
+var wrapComponent = function wrapComponent(_ref) {
+  var name = _ref.name,
+      className = _ref.className,
+      type = _ref.type;
+
+  var Component = function Component(_ref2) {
+    var baseClassName = _ref2.className,
+        other = _rollupPluginBabelHelpers.objectWithoutProperties(_ref2, _excluded);
+
+    var componentClass = cx__default["default"](className, baseClassName);
+    return /*#__PURE__*/React__default["default"].createElement(type, _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, other), {}, {
+      // Prevent Weird quirk where `cx` will evaluate to an empty string, '',
+      // and so we have empty `class` attributes in the resulting markup
+      // eslint-disable-next-line no-extra-boolean-cast
+      className: !!componentClass ? componentClass : undefined
+    }));
+  };
+
+  Component.displayName = name;
+  Component.propTypes = {
+    className: PropTypes__default["default"].string
+  };
+  return Component;
+};
+
+var wrapComponent$1 = wrapComponent;
+
+exports["default"] = wrapComponent$1;