@carbon/ibm-products 1.50.0 → 1.52.0

package/es/components/SidePanel/SidePanel.js

@@ -20,7 +20,7 @@ import { motion, AnimatePresence } from 'framer-motion';
 // Other standard imports.
 import PropTypes from 'prop-types';
 import cx from 'classnames';
-import { useResizeDetector } from 'react-resize-detector';
+import { useResizeObserver } from '../../global/js/hooks/useResizeObserver';
 import { moderate02 } from '@carbon/motion';
 import { getDevtoolsProps } from '../../global/js/utils/devtools';
 import { allPropTypes } from '../../global/js/utils/props-helper';
@@ -53,7 +53,7 @@ var defaults = {
  * Side panels keep users in-context of a page while performing tasks like navigating, editing, viewing details, or configuring something new.
  */
 export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
-  var _window, _ref4, _cx4;
+  var _window, _ref5, _cx4;
   var actionToolbarButtons = _ref.actionToolbarButtons,
     actions = _ref.actions,
     _ref$animateTitle = _ref.animateTitle,
@@ -165,8 +165,9 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   }, [labelText, title]);
 
   /* istanbul ignore next */
-  var handleResize = function handleResize(width, height) {
+  var handleResize = function handleResize(_ref2) {
     var _sidePanelOuter$style3;
+    var height = _ref2.height;
     setPanelHeight(height);
     var sidePanelOuter = document.querySelector("#".concat(blockClass, "-outer"));
     var actionsContainer = getActionsContainerElement();
@@ -353,9 +354,9 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
 
   // adds focus trap functionality
   /* istanbul ignore next */
-  var handleBlur = function handleBlur(_ref2) {
-    var oldActiveNode = _ref2.target,
-      currentActiveNode = _ref2.relatedTarget;
+  var handleBlur = function handleBlur(_ref3) {
+    var oldActiveNode = _ref3.target,
+      currentActiveNode = _ref3.relatedTarget;
     // focus trap should only be set if the side panel is a `slideOver` type
     if (open && sidePanelInnerRef && !slideIn) {
       wrapFocus({
@@ -368,7 +369,7 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     }
   };
   var primaryActionContainerClassNames = cx(["".concat(blockClass, "__actions-container"), _defineProperty({}, "".concat(blockClass, "__actions-container-condensed"), condensedActions)]);
-  var mainPanelClassNames = cx([blockClass, className, "".concat(blockClass, "__container"), "".concat(blockClass, "__container--").concat(size), (_ref4 = {}, _defineProperty(_ref4, "".concat(blockClass, "__container-right-placement"), placement === 'right'), _defineProperty(_ref4, "".concat(blockClass, "__container-left-placement"), placement === 'left'), _defineProperty(_ref4, "".concat(blockClass, "__container-with-action-toolbar"), actionToolbarButtons && actionToolbarButtons.length), _defineProperty(_ref4, "".concat(blockClass, "__container-without-overlay"), !includeOverlay && !slideIn), _defineProperty(_ref4, "".concat(blockClass, "__container-is-animating"), !animationComplete || !open), _ref4)]);
+  var mainPanelClassNames = cx([blockClass, className, "".concat(blockClass, "__container"), "".concat(blockClass, "__container--").concat(size), (_ref5 = {}, _defineProperty(_ref5, "".concat(blockClass, "__container-right-placement"), placement === 'right'), _defineProperty(_ref5, "".concat(blockClass, "__container-left-placement"), placement === 'left'), _defineProperty(_ref5, "".concat(blockClass, "__container-with-action-toolbar"), actionToolbarButtons && actionToolbarButtons.length), _defineProperty(_ref5, "".concat(blockClass, "__container-without-overlay"), !includeOverlay && !slideIn), _defineProperty(_ref5, "".concat(blockClass, "__container-is-animating"), !animationComplete || !open), _ref5)]);
   var renderHeader = function renderHeader() {
     var _cx, _cx2;
     return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("div", {
@@ -397,17 +398,17 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       className: cx("".concat(blockClass, "__subtitle-text"), (_cx2 = {}, _defineProperty(_cx2, "".concat(blockClass, "__subtitle-text-no-animation"), !animateTitle), _defineProperty(_cx2, "".concat(blockClass, "__subtitle-text-no-animation-no-action-toolbar"), !animateTitle && (!actionToolbarButtons || !actionToolbarButtons.length)), _defineProperty(_cx2, "".concat(blockClass, "__subtitle-text-is-animating"), !animationComplete && animateTitle), _defineProperty(_cx2, "".concat(blockClass, "__subtitle-without-title"), !title), _cx2))
     }, subtitle), actionToolbarButtons && actionToolbarButtons.length && /*#__PURE__*/React.createElement("div", {
       className: cx("".concat(blockClass, "__action-toolbar"), _defineProperty({}, "".concat(blockClass, "__action-toolbar-no-animation"), !animateTitle))
-    }, actionToolbarButtons.map(function (_ref5) {
-      var label = _ref5.label,
-        kind = _ref5.kind,
-        icon = _ref5.icon,
-        tooltipPosition = _ref5.tooltipPosition,
-        tooltipAlignment = _ref5.tooltipAlignment,
-        leading = _ref5.leading,
-        disabled = _ref5.disabled,
-        className = _ref5.className,
-        onClick = _ref5.onClick,
-        rest = _objectWithoutProperties(_ref5, _excluded2);
+    }, actionToolbarButtons.map(function (_ref6) {
+      var label = _ref6.label,
+        kind = _ref6.kind,
+        icon = _ref6.icon,
+        tooltipPosition = _ref6.tooltipPosition,
+        tooltipAlignment = _ref6.tooltipAlignment,
+        leading = _ref6.leading,
+        disabled = _ref6.disabled,
+        className = _ref6.className,
+        onClick = _ref6.onClick,
+        rest = _objectWithoutProperties(_ref6, _excluded2);
       return /*#__PURE__*/React.createElement(Button, _extends({}, rest, {
         key: label,
         kind: kind || 'ghost',
@@ -435,10 +436,8 @@ export var SidePanel = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     }, title));
   };
   var contentRef = ref || sidePanelRef;
-  useResizeDetector({
-    handleHeight: true,
-    onResize: handleResize,
-    targetRef: contentRef
+  useResizeObserver(contentRef, {
+    callback: handleResize
   });
   return /*#__PURE__*/React.createElement(AnimatePresence, null, open && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(motion.div, _extends({}, getDevtoolsProps(componentName), rest, {
     id: "".concat(blockClass, "-outer"),
@@ -591,8 +590,8 @@ SidePanel.propTypes = {
    * This is the selector to the element that contains all of the page content that will shrink if the panel is a slide in.
    * This prop is required when using the `slideIn` variant of the side panel.
    */
-  selectorPageContent: PropTypes.string.isRequired.if(function (_ref7) {
-    var slideIn = _ref7.slideIn;
+  selectorPageContent: PropTypes.string.isRequired.if(function (_ref8) {
+    var slideIn = _ref8.slideIn;
     return slideIn;
   }),
   /**
@@ -615,8 +614,8 @@ SidePanel.propTypes = {
   /**
    * Sets the title text
    */
-  title: PropTypes.string.isRequired.if(function (_ref8) {
-    var labelText = _ref8.labelText;
+  title: PropTypes.string.isRequired.if(function (_ref9) {
+    var labelText = _ref9.labelText;
     return labelText;
   })
 };

package/es/components/TagSet/TagSet.js

@@ -21,7 +21,7 @@ import cx from 'classnames';
 import { TagSetOverflow } from './TagSetOverflow';
 import { TagSetModal } from './TagSetModal';
 import { Tag } from 'carbon-components-react';
-import { useResizeDetector } from 'react-resize-detector';
+import { useResizeObserver } from '../../global/js/hooks/useResizeObserver';
 import { getDevtoolsProps } from '../../global/js/utils/devtools';
 import { prepareProps, isRequiredIf } from '../../global/js/utils/props-helper';
 import { pkg } from '../../settings';
@@ -202,13 +202,11 @@ export var TagSet = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   var handleModalClose = function handleModalClose() {
     setShowAllModalOpen(false);
   };
-  useResizeDetector({
-    onResize: handleSizerTagsResize,
-    targetRef: sizingContainerRef
+  useResizeObserver(sizingContainerRef, {
+    callback: handleSizerTagsResize
   });
-  useResizeDetector({
-    onResize: handleResize,
-    targetRef: tagSetRef
+  useResizeObserver(tagSetRef, {
+    callback: handleResize
   });
   return /*#__PURE__*/React.createElement("div", _extends({}, rest, {
     className: cx([blockClass, className]),

package/es/components/Tearsheet/TearsheetShell.js

@@ -15,7 +15,7 @@ function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { va
 // Import portions of React that are needed.
 import React, { useEffect, useState, useRef } from 'react';
 import { createPortal } from 'react-dom';
-import { useResizeDetector } from 'react-resize-detector';
+import { useResizeObserver } from '../../global/js/hooks/useResizeObserver';
 
 // Other standard imports.
 import PropTypes from 'prop-types';
@@ -93,12 +93,10 @@ export var TearsheetShell = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     }
   }, [portalTargetIn]);
   var localRef = useRef();
+  var resizer = useRef(null);
   var modalRef = ref || localRef;
-  var _useResizeDetector = useResizeDetector({
-      handleHeight: false
-    }),
-    width = _useResizeDetector.width,
-    resizer = _useResizeDetector.ref;
+  var _useResizeObserver = useResizeObserver(resizer),
+    width = _useResizeObserver.width;
 
   // Keep track of the stack depth and our position in it (1-based, 0=closed)
   var _useState3 = useState(0),

package/es/components/index.js

@@ -37,10 +37,11 @@ export { WebTerminal, WebTerminalContentWrapper, useWebTerminal, WebTerminalProv
 export { EditSidePanel } from './EditSidePanel';
 export { OptionsTile } from './OptionsTile';
 export { DataSpreadsheet } from './DataSpreadsheet';
-export { Datagrid, useDatagrid, useInfiniteScroll, useNestedRows, useSelectRows, useExpandedRow, useOnRowClick, useSortableColumns, useRowIsMouseOver, useColumnCenterAlign, useColumnRightAlign, useDisableSelectRows, useStickyColumn, useActionsColumn, useCustomizeColumns, useSelectAllWithToggle, useColumnOrder, useInlineEdit, useFiltering, getAutoSizedColumnWidth } from './Datagrid';
+export { Datagrid, useDatagrid, useInfiniteScroll, useNestedRows, useSelectRows, useExpandedRow, useOnRowClick, useSortableColumns, useRowIsMouseOver, useColumnCenterAlign, useColumnRightAlign, useDisableSelectRows, useStickyColumn, useActionsColumn, useCustomizeColumns, useSelectAllWithToggle, useColumnOrder, useInlineEdit, useEditableCell, useFiltering, getAutoSizedColumnWidth } from './Datagrid';
 export { EditTearsheet } from './EditTearsheet';
 export { EditTearsheetNarrow } from './EditTearsheetNarrow';
 export { EditFullPage } from './EditFullPage';
 export { EditUpdateCards } from './EditUpdateCards';
 export { InlineEdit } from './InlineEdit';
+export { EditInPlace } from './EditInPlace';
 export { NonLinearReading } from './NonLinearReading';

package/es/global/js/hooks/useResizeObserver.js

@@ -0,0 +1,74 @@
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+/**
+ * Copyright IBM Corp. 2023, 2023
+ *
+ * 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 { useRef, useState, useLayoutEffect } from 'react';
+export var useResizeObserver = function useResizeObserver(ref) {
+  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {
+    callback: null,
+    throttleInterval: 0
+  };
+  var callback = options.callback,
+    throttleInterval = options.throttleInterval;
+  var _useState = useState(0),
+    _useState2 = _slicedToArray(_useState, 2),
+    width = _useState2[0],
+    setWidth = _useState2[1];
+  var _useState3 = useState(0),
+    _useState4 = _slicedToArray(_useState3, 2),
+    height = _useState4[0],
+    setHeight = _useState4[1];
+  var throttleTimeout = useRef(null);
+  var entriesToHandle = useRef(null);
+  useLayoutEffect(function () {
+    if (!(ref !== null && ref !== void 0 && ref.current)) {
+      return;
+    }
+    var doCallbacks = function doCallbacks() {
+      if (!(ref !== null && ref !== void 0 && ref.current) || !Array.isArray(entriesToHandle === null || entriesToHandle === void 0 ? void 0 : entriesToHandle.current)) {
+        return;
+      }
+      var entry = entriesToHandle.current[0];
+      setWidth(entry.contentRect.width);
+      setHeight(entry.contentRect.height);
+      throttleTimeout.current = null;
+      callback && callback(entry.contentRect);
+    };
+    var observer = new ResizeObserver(function (entries) {
+      // always update entriesToHandle
+      entriesToHandle.current = entries;
+      if (throttleInterval) {
+        // if a throttleInterval check for running timeout
+        if (throttleTimeout.current === null) {
+          // no live timeout set entries to handle and move on
+
+          // set up throttle
+          throttleTimeout.current = setTimeout(function () {
+            // do callbacks
+            doCallbacks();
+            // reset throttle
+            throttleTimeout.current = null;
+          }, throttleInterval);
+        }
+      } else {
+        // no throttle do callbacks every time
+        doCallbacks();
+      }
+    });
+
+    // observe all refs passed
+    observer.observe(ref.current);
+    return function () {
+      observer.disconnect();
+      observer = null;
+    };
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [ref, options]);
+  return {
+    width: width,
+    height: height
+  };
+};

package/es/global/js/package-settings.js

@@ -2,7 +2,7 @@ import _defineProperty from "@babel/runtime/helpers/defineProperty";
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); 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 = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
 //
-// Copyright IBM Corp. 2020, 2021
+// Copyright IBM Corp. 2020, 2023
 //
 // This source code is licensed under the Apache-2.0 license found in the
 // LICENSE file in the root directory of this source tree.
@@ -25,6 +25,7 @@ var defaults = {
     CreateTearsheet: true,
     CreateTearsheetStep: true,
     CreateTearsheetDivider: true,
+    EditInPlace: true,
     EmptyState: true,
     ErrorEmptyState: true,
     ExportModal: true,
@@ -78,7 +79,15 @@ var defaults = {
   // feature level flags
   feature: {
     'a-new-feature': false,
-    'default-portal-target-body': true
+    'default-portal-target-body': true,
+    'Datagrid.useExpandedRow': false,
+    'Datagrid.useNestedRows': false,
+    'Datagrid.useInlineEdit': false,
+    'Datagrid.useActionsColumn': false,
+    'Datagrid.useFiltering': false,
+    'Datagrid.useCustomizeColumns': false,
+    'ExampleComponent.secondaryIcon': false,
+    'ExampleComponent.useExample': false
   }
 };
 var warningMessageComponent = function warningMessageComponent(property) {
@@ -87,6 +96,9 @@ var warningMessageComponent = function warningMessageComponent(property) {
 var warningMessageFeature = function warningMessageFeature(property) {
   return "Carbon for IBM Products (WARNING): Feature \"".concat(property, "\" enabled via feature flags.");
 };
+var errorMessageFeature = function errorMessageFeature(property) {
+  return "Carbon for IBM Products (Error): Feature \"".concat(property, "\" not enabled. To enable see the notes on feature flags in the README.");
+};
 var warningMessageAllComponents = 'Carbon for IBM Products (WARNING): All components enabled through use of setAllComponents. This includes components that have not yet completed their review process.';
 var warningMessageAllFeatures = 'Carbon for IBM Products (WARNING): All features enabled through use of setAllFeatures';
 
@@ -108,7 +120,10 @@ var allFeatures = all.INITIAL;
 var silent = false;
 var component = new Proxy(_objectSpread({}, defaults.component), {
   set: function set(target, property, value) {
-    value && !silent && console.warn(warningMessageComponent(property));
+    if (target[property] !== true && !silent && value) {
+      // not already true, not silent, and now true
+      console.warn(warningMessageComponent(property));
+    }
     target[property] = value;
     return true; // value set
   },
@@ -119,7 +134,15 @@ var component = new Proxy(_objectSpread({}, defaults.component), {
 });
 var feature = new Proxy(_objectSpread({}, defaults.feature), {
   set: function set(target, property, value) {
-    value && !silent && console.warn(warningMessageFeature(property));
+    // If we receive a feature flag that doesn't exist in our defaults we should not log
+    // a warning message and instead just return
+    if (!Object.getOwnPropertyDescriptor(defaults.feature, property)) {
+      return true;
+    }
+    if (target[property] !== true && !silent && value) {
+      // not already true, not silent, and now true
+      console.warn(warningMessageFeature(property));
+    }
     target[property] = value;
     return true; // value set
   },
@@ -148,6 +171,14 @@ export default {
     var byDefault = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
     return byDefault ? defaults.feature[featureName] : feature[featureName];
   },
+  checkReportFeatureEnabled: function checkReportFeatureEnabled(featureName) {
+    if (feature[featureName]) {
+      // NOTE: Warning emitted if feature flag is enabled (see Proxy above)
+      return true;
+    } else {
+      console.error(errorMessageFeature(featureName));
+    }
+  },
   isFeaturePublic: function isFeaturePublic(featureName) {
     var byDefault = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
     return Object.prototype.hasOwnProperty.call(byDefault ? defaults.feature : feature, featureName);

package/es/global/js/utils/test-helper.js

@@ -182,6 +182,39 @@ export var expectMultipleWarn = function expectMultipleWarn(messages, test) {
   warn.mockRestore();
   return result;
 };
+var checkLogging = function checkLogging(mock, message) {
+  if (message) {
+    var _expect4;
+    expect(mock).toBeCalled();
+    (_expect4 = expect(mock)).toHaveBeenCalledWith.apply(_expect4, _toConsumableArray(makeMatcherArray(message)));
+  }
+};
+
+/**
+ * A helper function to enable a test to expect a single call to
+ * console.error, for example when intentionally omitting a required prop
+ * or supplying an invalid prop type or value for the purposes of the test.
+ * @param {errors: {string|regex|function|[]}, warnings: {string|regex|function|[]}} messages the expected parameters for the call to
+ * console.error or console.warn, which must be called exactly once. A single string or regex or an
+ * expect matcher can be used to match a single-argument call to console.error (most common),
+ * while an array of strings and/or regex and/or expect matchers can be used to match a
+ * multiple-argument call. Strings can be full or substring matches to the corresponding
+ * argument.
+ * @param {Function} test the test function to call, during which the call to
+ * console.error will be expected.
+ */
+export var expectLogging = function expectLogging(_ref2, test) {
+  var errors = _ref2.errors,
+    warnings = _ref2.warnings;
+  var error = jest.spyOn(console, 'error').mockImplementation(jest.fn());
+  var warn = jest.spyOn(console, 'warn').mockImplementation(jest.fn());
+  var result = test();
+  checkLogging(error, errors);
+  checkLogging(warn, warnings);
+  error.mockRestore();
+  warn.mockRestore();
+  return result;
+};
 
 /**
  * A helper function to enable a test to expect a single call to
@@ -197,11 +230,9 @@ export var expectMultipleWarn = function expectMultipleWarn(messages, test) {
  * console.error will be expected.
  */
 export var expectError = function expectError(message, test) {
-  var _expect4;
   var error = jest.spyOn(console, 'error').mockImplementation(jest.fn());
   var result = test();
-  expect(error).toBeCalledTimes(1);
-  (_expect4 = expect(error)).toHaveBeenCalledWith.apply(_expect4, _toConsumableArray(makeMatcherArray(message)));
+  checkLogging(error, message);
   error.mockRestore();
   return result;
 };

package/es/settings.js

@@ -3,6 +3,7 @@ import pkgSettings from './global/js/package-settings';
 import { settings as carbonSettings } from 'carbon-components';
 import React from 'react';
 import { themes } from '@carbon/themes';
+import pconsole from './global/js/utils/pconsole';
 export var carbon = {
   get prefix() {
     return carbonSettings.prefix;
@@ -14,6 +15,19 @@ export var carbon = {
     return themes;
   }
 };
+var componentDeprecatedWarning = function componentDeprecatedWarning(name, details) {
+  return "Carbon for IBM Products (WARNING): Component \"".concat(name, "\" is deprecated. ").concat(details);
+};
+pkgSettings.logDeprecated = function (component, name) {
+  if (component !== null && component !== void 0 && component.deprecated) {
+    var _pconsole$level;
+    var _component$deprecated = component.deprecated,
+      level = _component$deprecated.level,
+      details = _component$deprecated.details;
+    var logUsing = (_pconsole$level = pconsole === null || pconsole === void 0 ? void 0 : pconsole[level]) !== null && _pconsole$level !== void 0 ? _pconsole$level : pconsole.error;
+    logUsing(componentDeprecatedWarning(name || component.displayName, details));
+  }
+};
 
 // Check that a component is enabled. This function returns a stub which checks
 // the component status on first use and then renders as the component or as
@@ -24,20 +38,19 @@ pkgSettings.checkComponentEnabled = function (component, name) {
   if (component.render) {
     // The component is a forward-ref, so make a stub forward-ref.
     var forward = /*#__PURE__*/React.forwardRef(function (props, ref) {
-      return (
-        // Replace the stub's render fn so this test only happens once.
-        (forward.render = pkgSettings.isComponentEnabled(name) || !pkgSettings.isComponentPublic(name) ?
-        // If the component is enabled, or if it's not a public component,
-        // replace the stub's render fn with the component's render fn.
-        component.render :
-        // Note that Canary is a direct render fn (not a forward-ref) and
-        // will ignore the passed props and ref (if any)
-        Canary.bind(undefined, {
-          componentName: name
-        }))(
-        // Call it now (after this it will be directly called).
-        props, ref)
-      );
+      pkgSettings.logDeprecated(component, name); // may log don't care about result
+      // Replace the stub's render fn so this test only happens once.
+      return (forward.render = pkgSettings.isComponentEnabled(name) || !pkgSettings.isComponentPublic(name) ?
+      // If the component is enabled, or if it's not a public component,
+      // replace the stub's render fn with the component's render fn.
+      component.render :
+      // Note that Canary is a direct render fn (not a forward-ref) and
+      // will ignore the passed props and ref (if any)
+      Canary.bind(undefined, {
+        componentName: name
+      }))(
+      // Call it now (after this it will be directly called).
+      props, ref);
     });
 
     // Transfer object properties already assigned (eg propTypes, displayName)
@@ -47,22 +60,20 @@ pkgSettings.checkComponentEnabled = function (component, name) {
   } else {
     // The component is a direct render fn, so make a stub render fn.
     var _render = function render(props) {
-      return (
-        // Replace the stub render fn so this test only happens once.
-        (_render = pkgSettings.isComponentEnabled(name) || !pkgSettings.isComponentPublic(name) ?
-        // If the component is enabled, or if it's not a public component,
-        // replace the stub render fn with the component render fn.
-        component :
-        // Replace the stub render fn with the Canary render fn, which will
-        // ignore the passed props.
-        Canary.bind(undefined, {
-          componentName: name
-        }))(
-        // Call it now (after this it will be directly called).
-        props)
-      );
+      pkgSettings.logDeprecated(component, name); // may log don't care about result
+      // Replace the stub render fn so this test only happens once.
+      return (_render = pkgSettings.isComponentEnabled(name) || !pkgSettings.isComponentPublic(name) ?
+      // If the component is enabled, or if it's not a public component,
+      // replace the stub render fn with the component render fn.
+      component :
+      // Replace the stub render fn with the Canary render fn, which will
+      // ignore the passed props.
+      Canary.bind(undefined, {
+        componentName: name
+      }))(
+      // Call it now (after this it will be directly called).
+      props);
     };
-
     // Transfer object properties already assigned (eg propTypes, displayName)
     // to a function which calls the stub render fn which checks the component
     // status when first used.

package/lib/components/AboutModal/AboutModal.js

@@ -11,7 +11,7 @@ var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/de
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
 var _react = _interopRequireWildcard(require("react"));
-var _reactResizeDetector = require("react-resize-detector");
+var _useResizeObserver = require("../../global/js/hooks/useResizeObserver");
 var _propTypes = _interopRequireDefault(require("prop-types"));
 var _classnames = _interopRequireDefault(require("classnames"));
 var _settings = require("../../settings");
@@ -71,9 +71,8 @@ var AboutModal = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
   }, [bodyRef]);
 
   // Detect resize of the ModalBody to recalculate whether scrolling is enabled
-  (0, _reactResizeDetector.useResizeDetector)({
-    onResize: handleResize,
-    targetRef: bodyRef
+  (0, _useResizeObserver.useResizeObserver)(bodyRef, {
+    callback: handleResize
   });
   return /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.ComposedModal, (0, _extends2.default)({}, rest, {
     className: (0, _classnames.default)(blockClass,

package/lib/components/ActionBar/ActionBar.js

@@ -14,7 +14,7 @@ var _react = _interopRequireWildcard(require("react"));
 var _propTypes = _interopRequireDefault(require("prop-types"));
 var _classnames = _interopRequireDefault(require("classnames"));
 var _settings = require("../../settings");
-var _reactResizeDetector = require("react-resize-detector");
+var _useResizeObserver = require("../../global/js/hooks/useResizeObserver");
 var _carbonComponentsReact = require("carbon-components-react");
 var _uuidv = _interopRequireDefault(require("../../global/js/utils/uuidv4"));
 var _propsHelper = require("../../global/js/utils/props-helper");
@@ -61,6 +61,8 @@ var ActionBar = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
   var refDisplayedItems = (0, _react.useRef)(null);
   var sizingRef = (0, _react.useRef)(null);
   var sizes = (0, _react.useRef)({});
+  var backupRef = (0, _react.useRef)();
+  var localRef = ref || backupRef;
 
   // create hidden sizing items
   (0, _react.useEffect)(function () {
@@ -175,30 +177,19 @@ var ActionBar = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref) {
 
   /* 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();
   };
-  (0, _reactResizeDetector.useResizeDetector)({
-    onResize: handleActionBarItemsResize,
-    targetRef: sizingRef
+  (0, _useResizeObserver.useResizeObserver)(sizingRef, {
+    callback: handleResize
+  });
+  (0, _useResizeObserver.useResizeObserver)(localRef, {
+    callback: handleResize
   });
-  var _useResizeDetector = (0, _reactResizeDetector.useResizeDetector)({
-      onResize: handleResize,
-      targetRef: ref
-    }),
-    outerRef = _useResizeDetector.ref;
   return /*#__PURE__*/_react.default.createElement("div", (0, _extends2.default)({}, rest, {
     className: (0, _classnames.default)([blockClass, className]),
-    ref: outerRef
+    ref: localRef
   }), hiddenSizingItems, /*#__PURE__*/_react.default.createElement("div", {
     ref: refDisplayedItems,
     className: (0, _classnames.default)(["".concat(blockClass, "__displayed-items"), (0, _defineProperty2.default)({}, "".concat(blockClass, "__displayed-items--right"), rightAlign)])

package/lib/components/BreadcrumbWithOverflow/BreadcrumbWithOverflow.js

@@ -15,7 +15,7 @@ var _propTypes = _interopRequireDefault(require("prop-types"));
 var _classnames = _interopRequireDefault(require("classnames"));
 var _carbonComponentsReact = require("carbon-components-react");
 var _settings = require("../../settings");
-var _reactResizeDetector = require("react-resize-detector");
+var _useResizeObserver = require("../../global/js/hooks/useResizeObserver");
 var _iconsReact = require("@carbon/icons-react");
 var _uuidv = _interopRequireDefault(require("../../global/js/utils/uuidv4"));
 require("../../global/js/utils/props-helper");
@@ -233,24 +233,19 @@ var BreadcrumbWithOverflow = function BreadcrumbWithOverflow(_ref) {
     /* istanbul ignore next */ // not sure how to test resize
     checkFullyVisibleBreadcrumbItems();
   };
-
-  /* istanbul ignore next */ // not sure how to test resize
-  var handleBreadcrumbItemsResize = function handleBreadcrumbItemsResize() {
-    /* istanbul ignore next */ // not sure how to test resize
-    checkFullyVisibleBreadcrumbItems();
-  };
   var backItem = breadcrumbs[breadcrumbs.length - 1];
   /* istanbul ignore if */ // not sure how to test media queries
   if (backItem.isCurrentPage) {
     backItem = breadcrumbs[breadcrumbs.length - 2];
   }
-  (0, _reactResizeDetector.useResizeDetector)({
-    onResize: handleBreadcrumbItemsResize,
-    targetRef: sizingContainerRef
+
+  // container resize
+  (0, _useResizeObserver.useResizeObserver)(sizingContainerRef, {
+    callback: handleResize
   });
-  (0, _reactResizeDetector.useResizeDetector)({
-    onResize: handleResize,
-    targetRef: breadcrumbItemWithOverflow
+  // item resize
+  (0, _useResizeObserver.useResizeObserver)(breadcrumbItemWithOverflow, {
+    callback: handleResize
   });
   return /*#__PURE__*/_react.default.createElement("div", {
     className: (0, _classnames.default)(blockClass, className, (0, _defineProperty2.default)({}, "".concat(blockClass, "__with-items"), displayedBreadcrumbItems.length > 1)),

package/lib/components/ButtonSetWithOverflow/ButtonSetWithOverflow.js

@@ -13,7 +13,7 @@ var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/sli
 var _react = _interopRequireWildcard(require("react"));
 var _propTypes = _interopRequireDefault(require("prop-types"));
 var _classnames = _interopRequireDefault(require("classnames"));
-var _reactResizeDetector = require("react-resize-detector");
+var _useResizeObserver = require("../../global/js/hooks/useResizeObserver");
 var _carbonComponentsReact = require("carbon-components-react");
 var _ButtonMenu = require("../ButtonMenu");
 var _settings = require("../../settings");
@@ -138,18 +138,14 @@ var ButtonSetWithOverflow = function ButtonSetWithOverflow(_ref) {
       }, (0, _propsHelper.prepareProps)(other, ['iconDescription', 'renderIcon'])));
     }).reverse());
   });
-  (0, _reactResizeDetector.useResizeDetector)({
-    onResize: checkFullyVisibleItems,
-    targetRef: sizingContainerRefSet
+  (0, _useResizeObserver.useResizeObserver)(sizingContainerRefSet, {
+    callback: checkFullyVisibleItems
   });
-  (0, _reactResizeDetector.useResizeDetector)({
-    onResize: checkFullyVisibleItems,
-    targetRef: sizingContainerRefCombo
+  (0, _useResizeObserver.useResizeObserver)(sizingContainerRefCombo, {
+    callback: checkFullyVisibleItems
   });
-  (0, _reactResizeDetector.useResizeDetector)({
-    onResize: checkFullyVisibleItems,
-    targetRef: spaceAvailableRef,
-    handleWidth: true
+  (0, _useResizeObserver.useResizeObserver)(spaceAvailableRef, {
+    callback: checkFullyVisibleItems
   });
   return /*#__PURE__*/_react.default.createElement("div", {
     className: (0, _classnames.default)([blockClass, className, (0, _defineProperty2.default)({}, "".concat(blockClass, "--right"), rightAlign)]),