@instructure/ui-react-utils 10.26.1-snapshot-2 → 10.26.1

package/CHANGELOG.md

@@ -3,30 +3,9 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-## [10.26.1-snapshot-2](https://github.com/instructure/instructure-ui/compare/v10.26.0...v10.26.1-snapshot-2) (2025-10-06)
+## [10.26.1](https://github.com/instructure/instructure-ui/compare/v10.26.0...v10.26.1) (2025-10-06)
 
-
-### Features
-
-* **many:** instUI v11 release ([36f5438](https://github.com/instructure/instructure-ui/commit/36f54382669186227ba24798bbf7201ef2f5cd4c))
-
-
-### BREAKING CHANGES
-
-* **many:** InstUI v11 contains the following breaking changes:
-- React 16 and 17 are no longer supported
-- remove `PropTypes` from all packages
-- remove `CodeEditor` component
-- remove `@instui/theme-registry` package
-- remove `@testable`, `@experimental`, `@hack` decorators
-- InstUISettingsProvider's `as` prop is removed
-- `canvas.use()`, `canvasHighContrast.use()` functions are removed
-- `canvasThemeLocal`, `canvasHighContrastThemeLocal` are removed
-- `variables` field on theme objects are removed
-- remove deprecated props from Table: Row's `isStacked`, Body's
-  `isStacked`, `hover`, and `headers`
-- `Table`'s `caption` prop is now required
-- `ui-dom-utils`'s `getComputedStyle` can now return `undefined`
+**Note:** Version bump only for package @instructure/ui-react-utils
 
 
 

package/es/DeterministicIdContext/withDeterministicId.js

@@ -52,6 +52,12 @@ const withDeterministicId = decorator(ComposedComponent => {
   });
   hoistNonReactStatics(WithDeterministicId, ComposedComponent);
 
+  // we have to pass these on, because sometimes users
+  // access propTypes of the component in other components
+  // eslint-disable-next-line react/forbid-foreign-prop-types
+  WithDeterministicId.propTypes = ComposedComponent.propTypes;
+  WithDeterministicId.defaultProps = ComposedComponent.defaultProps;
+
   // These static fields exist on InstUI components
   //@ts-expect-error fix this
   WithDeterministicId.allowedProps = ComposedComponent.allowedProps;

package/es/deprecated.js

@@ -0,0 +1,147 @@
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { decorator } from '@instructure/ui-decorator';
+import { logWarnDeprecated as warnDeprecated } from '@instructure/console';
+/**
+ * ---
+ * category: utilities/react
+ * ---
+ * Deprecate React component props. Warnings will display in the console when deprecated
+ * props are used. Include the version number when the deprecated component will be removed.
+ *
+ * ```js-code
+ *  class Example extends Component {
+ *    static propTypes = {
+ *      currentProp: PropTypes.func
+ *    }
+ *  }
+ *  export default deprecated('7.0.0', {
+ *    deprecatedProp: 'currentProp',
+ *    nowNonExistentProp: true
+ *  })(Example)
+ * ```
+ *
+ * @param {string} version
+ * @param {object} oldProps (if this argument is null or undefined, the entire component is deprecated)
+ * @param {string} message
+ * @return {function} React component with deprecated props behavior
+ * @module deprecated
+ */
+const deprecated = (() => {
+  if (process.env.NODE_ENV === 'production') {
+    const deprecated = function () {
+      return ComposedComponent => ComposedComponent;
+    };
+    deprecated.deprecatePropValues = () => () => null;
+    deprecated.warnDeprecatedProps = () => {};
+    deprecated.warnDeprecatedComponent = () => {};
+    deprecated.changedPackageWarning = () => '';
+    return deprecated;
+  }
+  const deprecated = decorator((ComposedComponent, version, oldProps, message = '') => {
+    class DeprecatedComponent extends ComposedComponent {}
+    DeprecatedComponent.prototype.componentDidMount = function () {
+      if (oldProps) {
+        warnDeprecatedProps(ComposedComponent.name, version, this.props, oldProps, message);
+      } else {
+        warnDeprecatedComponent(version, ComposedComponent.name, message);
+      }
+      if (ComposedComponent.prototype.componentDidMount) {
+        ComposedComponent.prototype.componentDidMount.call(this);
+      }
+    };
+    DeprecatedComponent.prototype.componentDidUpdate = function (prevProps, prevState, prevContext) {
+      if (oldProps) {
+        warnDeprecatedProps(ComposedComponent.name, version, this.props, oldProps, message);
+      } else {
+        warnDeprecatedComponent(version, ComposedComponent.name, message);
+      }
+      if (ComposedComponent.prototype.componentDidUpdate) {
+        ComposedComponent.prototype.componentDidUpdate.call(this, prevProps, prevState, prevContext);
+      }
+    };
+    return DeprecatedComponent;
+  })
+  /**
+   * ---
+   * category: utilities
+   * ---
+   * Trigger a console warning if the specified prop variant is deprecated
+   *
+   * @param {function} propType - validates the prop type. Returns null if valid, error otherwise
+   * @param {array} deprecated - an array of the deprecated variant names
+   * @param {string|function} message - a string with additional information (like the version the prop will be removed) or a function returning a string
+   */;
+  deprecated.deprecatePropValues = (propType, deprecated = [], message) => {
+    return (props, propName, componentName, ...rest) => {
+      const isDeprecatedValue = deprecated.includes(props[propName]);
+      const warningMessage = message && typeof message === 'function' ? message({
+        props,
+        propName,
+        propValue: props[propName]
+      }) : `The '${props[propName]}' value for the \`${propName}\` prop is deprecated. ${message || ''}`;
+      warnDeprecated(!isDeprecatedValue, `[${componentName}] ${warningMessage}`);
+      return isDeprecatedValue ? null : propType(props, propName, componentName, ...rest);
+    };
+  };
+  function warnDeprecatedProps(componentName, version, props, oldProps, message = '') {
+    Object.keys(oldProps).forEach(oldProp => {
+      if (typeof props[oldProp] !== 'undefined') {
+        const newProp = typeof oldProps[oldProp] === 'string' ? oldProps[oldProp] : null;
+        const newPropMessage = newProp ? `. Use \`${newProp}\` instead` : '';
+        warnDeprecated(false, `[${componentName}] \`${oldProp}\` is deprecated and will be removed in version ${version}${newPropMessage}. ${message}`);
+      }
+    });
+  }
+  ;
+  deprecated.warnDeprecatedProps = warnDeprecatedProps;
+  function warnDeprecatedComponent(version, componentName, message) {
+    warnDeprecated(false, `[${componentName}] is deprecated and will be removed in version ${version}. ${message || ''}`);
+  }
+  /**
+   * ---
+   * category: utilities
+   * ---
+   * @param {String} version the version of the package in which the component or function was deprecated
+   * @param {String} componentName the name of the component or Function.name of the utility function
+   * @param {String} message a message to display as a console error in DEV env when condition is false
+   */
+  ;
+  deprecated.warnDeprecatedComponent = warnDeprecatedComponent
+
+  /**
+   * ---
+   * category: utilities
+   * ---
+   * @param {String} prevPackage the previous name of the package
+   * @param {String} newPackage the new version of the package
+   * @return {String} the formatted warning string
+   */;
+  deprecated.changedPackageWarning = (prevPackage, newPackage) => {
+    return `It has been moved from @instructure/${prevPackage} to @instructure/${newPackage}.`;
+  };
+  return deprecated;
+})();
+export default deprecated;
+export { deprecated };

package/es/experimental.js

@@ -0,0 +1,85 @@
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { decorator } from '@instructure/ui-decorator';
+import { logWarn as warn } from '@instructure/console';
+/**
+ * ---
+ * category: utilities/react
+ * ---
+ * Flag React component and component props as experimental.
+ * Warnings will display in the console when experimental components/props
+ * props are used.
+ *
+ * ```js-code
+ *  class Example extends Component {
+ *    static propTypes = {
+ *      currentProp: PropTypes.func
+ *    }
+ *  }
+ *  export default experimental(['experimentalProp'])(Example)
+ * ```
+ *
+ * @module experimental
+ * @param {array} experimentalProps (if this argument is null or undefined, the entire component is flagged)
+ * @param {string} message
+ * @return {function} React component flagged as experimental
+ */
+const experimental = process.env.NODE_ENV == 'production' ? () => ReactComponent => ReactComponent : decorator((ComposedComponent, experimentalProps, message) => {
+  return class ExperimentalComponent extends ComposedComponent {
+    componentDidMount() {
+      if (!this.props.__dangerouslyIgnoreExperimentalWarnings) {
+        if (experimentalProps) {
+          warnExperimentalProps(ComposedComponent.name, this.props, experimentalProps, message);
+        } else {
+          warnExperimentalComponent(ComposedComponent.name, message);
+        }
+      }
+      if (super.componentDidMount) {
+        super.componentDidMount();
+      }
+    }
+    componentDidUpdate(prevProps, prevState, prevContext) {
+      if (!this.props.__dangerouslyIgnoreExperimentalWarnings) {
+        if (experimentalProps) {
+          warnExperimentalProps(ComposedComponent.name, this.props, experimentalProps, message);
+        } else {
+          warnExperimentalComponent(ComposedComponent.name, message);
+        }
+      }
+      if (super.componentDidUpdate) {
+        super.componentDidUpdate(prevProps, prevState, prevContext);
+      }
+    }
+  };
+});
+function warnExperimentalProps(name, props, experimentalProps, message = '') {
+  experimentalProps.forEach(experimentalProp => {
+    warn(typeof props[experimentalProp] === 'undefined', `[${name}] The \`${experimentalProp}\` prop is experimental and its API could change significantly in a future release. ${message}`);
+  });
+}
+function warnExperimentalComponent(name, message = '') {
+  warn(false, `[${name}] is experimental and its API could change significantly in a future release. ${message}`);
+}
+export default experimental;
+export { experimental };

package/es/hack.js

@@ -0,0 +1,96 @@
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { decorator } from '@instructure/ui-decorator';
+import { logWarn as warn } from '@instructure/console';
+
+/**
+ * ---
+ * category: utilities/react
+ * ---
+ * Flag React component props as hack props.
+ * Warnings will display in the console when hack props are used.
+ *
+ * ```js-code
+ *  class Example extends Component {
+ *    static propTypes = {
+ *      currentProp: PropTypes.func
+ *    }
+ *  }
+ *  export default hack(['hackProp'])(Example)
+ * ```
+ *
+ * @module hack
+ * @param {array} hackProps
+ * @param {string} message
+ * @return {function} React component flagged as having hack props
+ */
+const hack = process.env.NODE_ENV == 'production' ? () => Component => Component : decorator((ComposedComponent, hackProps, message) => {
+  return class HackComponent extends ComposedComponent {
+    componentDidMount() {
+      if (hackProps) {
+        warnHackProps(ComposedComponent.name, this.props, hackProps, message);
+      }
+      if (super.componentDidMount) {
+        super.componentDidMount();
+      }
+    }
+    componentDidUpdate(prevProps, prevState, prevContext) {
+      if (hackProps) {
+        warnHackProps(ComposedComponent.name, this.props, hackProps, message);
+      }
+      if (super.componentDidUpdate) {
+        super.componentDidUpdate(prevProps, prevState, prevContext);
+      }
+    }
+  };
+});
+function warnHackProps(name, props, hackProps, message = '') {
+  hackProps.forEach(hackProp => {
+    warn(typeof props[hackProp] === 'undefined', `[${name}] The \`${hackProp}\` prop is a temporary hack and will be removed in a future release. ${message}`);
+  });
+}
+export default hack;
+export {
+/**
+ * ---
+ * category: utilities/react
+ * ---
+ * Flag React component props as hack props.
+ * Warnings will display in the console when hack props are used.
+ *
+ * ```js
+ *  class Example extends Component {
+ *    static propTypes = {
+ *      currentProp: PropTypes.func
+ *    }
+ *  }
+ *  export default hack(['hackProp'])(Example)
+ * ```
+ *
+ * @module hack
+ * @param {array} hackProps
+ * @param {string} message
+ * @return {function} React component flagged as having hack props
+ */
+hack };

package/es/index.js

@@ -24,7 +24,10 @@
 
 /* list utils in alphabetical order */
 export { callRenderProp } from './callRenderProp';
+export { deprecated } from './deprecated';
 export { ensureSingleChild } from './ensureSingleChild';
+export { experimental } from './experimental';
+export { hack } from './hack';
 export { getDisplayName } from './getDisplayName';
 export { getElementType } from './getElementType';
 export { getInteraction } from './getInteraction';

package/lib/DeterministicIdContext/withDeterministicId.js

@@ -60,6 +60,12 @@ const withDeterministicId = exports.withDeterministicId = (0, _decorator.decorat
   });
   (0, _hoistNonReactStatics.default)(WithDeterministicId, ComposedComponent);
 
+  // we have to pass these on, because sometimes users
+  // access propTypes of the component in other components
+  // eslint-disable-next-line react/forbid-foreign-prop-types
+  WithDeterministicId.propTypes = ComposedComponent.propTypes;
+  WithDeterministicId.defaultProps = ComposedComponent.defaultProps;
+
   // These static fields exist on InstUI components
   //@ts-expect-error fix this
   WithDeterministicId.allowedProps = ComposedComponent.allowedProps;

package/lib/deprecated.js

@@ -0,0 +1,153 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.deprecated = exports.default = void 0;
+var _decorator = require("@instructure/ui-decorator/lib/decorator.js");
+var _console = require("@instructure/console");
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+/**
+ * ---
+ * category: utilities/react
+ * ---
+ * Deprecate React component props. Warnings will display in the console when deprecated
+ * props are used. Include the version number when the deprecated component will be removed.
+ *
+ * ```js-code
+ *  class Example extends Component {
+ *    static propTypes = {
+ *      currentProp: PropTypes.func
+ *    }
+ *  }
+ *  export default deprecated('7.0.0', {
+ *    deprecatedProp: 'currentProp',
+ *    nowNonExistentProp: true
+ *  })(Example)
+ * ```
+ *
+ * @param {string} version
+ * @param {object} oldProps (if this argument is null or undefined, the entire component is deprecated)
+ * @param {string} message
+ * @return {function} React component with deprecated props behavior
+ * @module deprecated
+ */
+const deprecated = exports.deprecated = (() => {
+  if (process.env.NODE_ENV === 'production') {
+    const deprecated = function () {
+      return ComposedComponent => ComposedComponent;
+    };
+    deprecated.deprecatePropValues = () => () => null;
+    deprecated.warnDeprecatedProps = () => {};
+    deprecated.warnDeprecatedComponent = () => {};
+    deprecated.changedPackageWarning = () => '';
+    return deprecated;
+  }
+  const deprecated = (0, _decorator.decorator)((ComposedComponent, version, oldProps, message = '') => {
+    class DeprecatedComponent extends ComposedComponent {}
+    DeprecatedComponent.prototype.componentDidMount = function () {
+      if (oldProps) {
+        warnDeprecatedProps(ComposedComponent.name, version, this.props, oldProps, message);
+      } else {
+        warnDeprecatedComponent(version, ComposedComponent.name, message);
+      }
+      if (ComposedComponent.prototype.componentDidMount) {
+        ComposedComponent.prototype.componentDidMount.call(this);
+      }
+    };
+    DeprecatedComponent.prototype.componentDidUpdate = function (prevProps, prevState, prevContext) {
+      if (oldProps) {
+        warnDeprecatedProps(ComposedComponent.name, version, this.props, oldProps, message);
+      } else {
+        warnDeprecatedComponent(version, ComposedComponent.name, message);
+      }
+      if (ComposedComponent.prototype.componentDidUpdate) {
+        ComposedComponent.prototype.componentDidUpdate.call(this, prevProps, prevState, prevContext);
+      }
+    };
+    return DeprecatedComponent;
+  })
+  /**
+   * ---
+   * category: utilities
+   * ---
+   * Trigger a console warning if the specified prop variant is deprecated
+   *
+   * @param {function} propType - validates the prop type. Returns null if valid, error otherwise
+   * @param {array} deprecated - an array of the deprecated variant names
+   * @param {string|function} message - a string with additional information (like the version the prop will be removed) or a function returning a string
+   */;
+  deprecated.deprecatePropValues = (propType, deprecated = [], message) => {
+    return (props, propName, componentName, ...rest) => {
+      const isDeprecatedValue = deprecated.includes(props[propName]);
+      const warningMessage = message && typeof message === 'function' ? message({
+        props,
+        propName,
+        propValue: props[propName]
+      }) : `The '${props[propName]}' value for the \`${propName}\` prop is deprecated. ${message || ''}`;
+      (0, _console.logWarnDeprecated)(!isDeprecatedValue, `[${componentName}] ${warningMessage}`);
+      return isDeprecatedValue ? null : propType(props, propName, componentName, ...rest);
+    };
+  };
+  function warnDeprecatedProps(componentName, version, props, oldProps, message = '') {
+    Object.keys(oldProps).forEach(oldProp => {
+      if (typeof props[oldProp] !== 'undefined') {
+        const newProp = typeof oldProps[oldProp] === 'string' ? oldProps[oldProp] : null;
+        const newPropMessage = newProp ? `. Use \`${newProp}\` instead` : '';
+        (0, _console.logWarnDeprecated)(false, `[${componentName}] \`${oldProp}\` is deprecated and will be removed in version ${version}${newPropMessage}. ${message}`);
+      }
+    });
+  }
+  ;
+  deprecated.warnDeprecatedProps = warnDeprecatedProps;
+  function warnDeprecatedComponent(version, componentName, message) {
+    (0, _console.logWarnDeprecated)(false, `[${componentName}] is deprecated and will be removed in version ${version}. ${message || ''}`);
+  }
+  /**
+   * ---
+   * category: utilities
+   * ---
+   * @param {String} version the version of the package in which the component or function was deprecated
+   * @param {String} componentName the name of the component or Function.name of the utility function
+   * @param {String} message a message to display as a console error in DEV env when condition is false
+   */
+  ;
+  deprecated.warnDeprecatedComponent = warnDeprecatedComponent
+
+  /**
+   * ---
+   * category: utilities
+   * ---
+   * @param {String} prevPackage the previous name of the package
+   * @param {String} newPackage the new version of the package
+   * @return {String} the formatted warning string
+   */;
+  deprecated.changedPackageWarning = (prevPackage, newPackage) => {
+    return `It has been moved from @instructure/${prevPackage} to @instructure/${newPackage}.`;
+  };
+  return deprecated;
+})();
+var _default = exports.default = deprecated;

package/lib/experimental.js

@@ -0,0 +1,91 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.experimental = exports.default = void 0;
+var _decorator = require("@instructure/ui-decorator/lib/decorator.js");
+var _console = require("@instructure/console");
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+/**
+ * ---
+ * category: utilities/react
+ * ---
+ * Flag React component and component props as experimental.
+ * Warnings will display in the console when experimental components/props
+ * props are used.
+ *
+ * ```js-code
+ *  class Example extends Component {
+ *    static propTypes = {
+ *      currentProp: PropTypes.func
+ *    }
+ *  }
+ *  export default experimental(['experimentalProp'])(Example)
+ * ```
+ *
+ * @module experimental
+ * @param {array} experimentalProps (if this argument is null or undefined, the entire component is flagged)
+ * @param {string} message
+ * @return {function} React component flagged as experimental
+ */
+const experimental = exports.experimental = process.env.NODE_ENV == 'production' ? () => ReactComponent => ReactComponent : (0, _decorator.decorator)((ComposedComponent, experimentalProps, message) => {
+  return class ExperimentalComponent extends ComposedComponent {
+    componentDidMount() {
+      if (!this.props.__dangerouslyIgnoreExperimentalWarnings) {
+        if (experimentalProps) {
+          warnExperimentalProps(ComposedComponent.name, this.props, experimentalProps, message);
+        } else {
+          warnExperimentalComponent(ComposedComponent.name, message);
+        }
+      }
+      if (super.componentDidMount) {
+        super.componentDidMount();
+      }
+    }
+    componentDidUpdate(prevProps, prevState, prevContext) {
+      if (!this.props.__dangerouslyIgnoreExperimentalWarnings) {
+        if (experimentalProps) {
+          warnExperimentalProps(ComposedComponent.name, this.props, experimentalProps, message);
+        } else {
+          warnExperimentalComponent(ComposedComponent.name, message);
+        }
+      }
+      if (super.componentDidUpdate) {
+        super.componentDidUpdate(prevProps, prevState, prevContext);
+      }
+    }
+  };
+});
+function warnExperimentalProps(name, props, experimentalProps, message = '') {
+  experimentalProps.forEach(experimentalProp => {
+    (0, _console.logWarn)(typeof props[experimentalProp] === 'undefined', `[${name}] The \`${experimentalProp}\` prop is experimental and its API could change significantly in a future release. ${message}`);
+  });
+}
+function warnExperimentalComponent(name, message = '') {
+  (0, _console.logWarn)(false, `[${name}] is experimental and its API could change significantly in a future release. ${message}`);
+}
+var _default = exports.default = experimental;