@instructure/ui-react-utils 11.7.8 → 11.7.9-pr-snapshot-1792147648392

package/CHANGELOG.md

@@ -3,6 +3,19 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [11.7.9-pr-snapshot-1792147648392](https://github.com/instructure/instructure-ui/compare/v11.7.8...v11.7.9-pr-snapshot-1792147648392) (2026-10-16)
+
+### Build System
+
+* **many:** replace babel with swc ([7e36c54](https://github.com/instructure/instructure-ui/commit/7e36c54d240b4fa483801c03ab18e7f860f561e2))
+
+### BREAKING CHANGES
+
+* **many:** `@instructure/ui-babel-preset` and
+  `@instructure/browserslist-config-instui` are removed and will no longer be
+  published. Packages depend on `@swc/helpers` instead of `@babel/runtime`.
+
+
 ## [11.7.8](https://github.com/instructure/instructure-ui/compare/v11.7.7...v11.7.8) (2026-10-02)
 
 **Note:** Version bump only for package @instructure/ui-react-utils

package/es/DeterministicIdContext/DeterministicIdContext.js

@@ -1,40 +1,4 @@
-/*
- * 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 React from 'react';
-/**
- * @deprecated Id generation no longer uses an instance counter map. Ids are now
- * generated with React's built-in `useId` (see `useDeterministicId` /
- * `withDeterministicId`), which is SSR-safe and hydration-stable without any
- * shared counter. This map is retained only for backwards compatibility and is
- * no longer read; it will be removed in the next major version.
- */
 const defaultDeterministicIDMap = new Map();
-
-/**
- * @deprecated This context is no longer consumed by the id generation utilities
- * and has no effect. It is retained only for backwards compatibility and will be
- * removed in the next major version.
- */
-const DeterministicIdContext = /*#__PURE__*/React.createContext(defaultDeterministicIDMap);
-export { DeterministicIdContext, defaultDeterministicIDMap };
+const DeterministicIdContext = React.createContext(defaultDeterministicIDMap);
+export { DeterministicIdContext, defaultDeterministicIDMap };

package/es/DeterministicIdContext/DeterministicIdContextProvider.js

@@ -1,48 +1,9 @@
-/*
- * 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 { DeterministicIdContext, defaultDeterministicIDMap } from './DeterministicIdContext.js';
 import { jsx as _jsx } from "@emotion/react/jsx-runtime";
-/**
- * ---
- * category: components/contexts
- * ---
- * WARNING: providing the `instanceCounterMap` prop will result in unexpected behaviour. DO NOT USE IT!
- *
- * DEPRECATED: the `instanceCounterMap` prop is deprecated. You don't need to supply the
- * `instanceCounterMap` to the component. It handles it internally.
- *
- * This utility component is for wrapping components with `DeterministicIdContext.Provider`
- * See detailed documentation about how to use it: [InstUISettingsProvider](/#InstUISettingsProvider)
- */
-const DeterministicIdContextProvider = ({
-  children,
-  instanceCounterMap = defaultDeterministicIDMap
-}) => {
-  return _jsx(DeterministicIdContext.Provider, {
-    value: instanceCounterMap,
-    children: children
-  });
+import { DeterministicIdContext, defaultDeterministicIDMap } from './DeterministicIdContext.js';
+const DeterministicIdContextProvider = ({ children, instanceCounterMap = defaultDeterministicIDMap })=>{
+    return /*#__PURE__*/ _jsx(DeterministicIdContext.Provider, {
+        value: instanceCounterMap,
+        children: children
+    });
 };
-export { DeterministicIdContextProvider };
+export { DeterministicIdContextProvider };

package/es/DeterministicIdContext/index.js

@@ -1,28 +1,4 @@
-/*
- * 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.
- */
-
 export { DeterministicIdContextProvider } from './DeterministicIdContextProvider.js';
 export { DeterministicIdContext } from './DeterministicIdContext.js';
 export { withDeterministicId } from './withDeterministicId.js';
-export { useDeterministicId } from './useDeterministicId.js';
+export { useDeterministicId } from './useDeterministicId.js';

package/es/DeterministicIdContext/useDeterministicId.js

@@ -1,69 +1,7 @@
-/*
- * 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 { useId } from 'react';
-
-/**
- * A React hook that provides SSR-safe, hydration-stable ID generation for
- * functional components.
- *
- * This hook is the functional component equivalent of the `withDeterministicId`
- * decorator. It is backed by React's built-in {@link https://react.dev/reference/react/useId `useId`},
- * which produces the same id on the server and the client for a given position
- * in the React tree.
- *
- * The returned function may be called multiple times with distinct
- * `instanceName` values to derive several unique, stable ids from the same
- * component instance (e.g. one for an input and one for its messages).
- *
- * Note: for apps that mount more than one independent React root on the same
- * page (including module federation), pass a distinct `identifierPrefix` to each
- * `createRoot`/`hydrateRoot` call so ids stay unique across roots.
- *
- * Read more about it here: [SSR guide](https://instructure.design/#server-side-rendering)
- *
- * @param componentName - Component name used as a human-readable id prefix.
- * @returns A function that generates stable ids. It accepts an optional
- * `instanceName` used as the prefix for that specific id.
- *
- * @example
- * ```tsx
- * const MyComponent = () => {
- *   const getId = useDeterministicId('MyComponent')
- *   const id = getId()
- *   const messagesId = getId('MyComponent-messages')
- *   return <div id={id} aria-describedby={messagesId}>Content</div>
- * }
- * ```
- */
 function useDeterministicId(componentName) {
-  // React wraps the value of `useId` in delimiters that are not valid in a CSS
-  // selector (`:r0:` in React 18, `«r0»` in React 19), which would break any
-  // `querySelector('#' + id)` call, so strip them. The `___` separator keeps the
-  // historical `ComponentName___token` id shape.
-  const base = useId().replace(/[^a-zA-Z0-9-]/g, '');
-  return instanceName => `${instanceName ?? componentName}___${base}`;
+    const base = useId().replace(/[^a-zA-Z0-9-]/g, '');
+    return (instanceName)=>`${instanceName ?? componentName}___${base}`;
 }
 export default useDeterministicId;
-export { useDeterministicId };
+export { useDeterministicId };

package/es/DeterministicIdContext/withDeterministicId.js

@@ -1,73 +1,29 @@
-/*
- * 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 { jsx as _jsx } from "@emotion/react/jsx-runtime";
 import { forwardRef } from 'react';
 import hoistNonReactStatics from 'hoist-non-react-statics';
 import { decorator } from '@instructure/ui-decorator';
 import { useDeterministicId } from './useDeterministicId.js';
 import { warn } from '@instructure/console';
-import { jsx as _jsx } from "@emotion/react/jsx-runtime";
-/**
- * This decorator injects a `deterministicId` prop into the decorated class,
- * used to generate SSR-safe, hydration-stable ids.
- *
- * It is backed by React's built-in {@link https://react.dev/reference/react/useId `useId`},
- * which produces the same id on the server and the client for a given position
- * in the React tree The injected `deterministicId(instanceName?)` function may
- * be called multiple times with distinct `instanceName` values to derive
- * several unique, stable ids from the same component instance.
- *
- * Note: for apps that mount more than one independent React root on the same
- * page (including module federation), pass a distinct `identifierPrefix` to each
- * `createRoot`/`hydrateRoot` call so ids stay unique across roots.
- * Read more about it here: [SSR guide](https://instructure.design/#server-side-rendering)
- */
-const withDeterministicId = decorator(ComposedComponent => {
-  const WithDeterministicId = /*#__PURE__*/forwardRef((props, ref) => {
-    const componentName = ComposedComponent.componentId || ComposedComponent.displayName || ComposedComponent.name;
-    const deterministicId = useDeterministicId(componentName);
-    if (props.deterministicId) {
-      warn(false, `Manually passing the "deterministicId" property is not allowed on the ${componentName} component.\n`, props.deterministicId);
-    }
-    return _jsx(ComposedComponent, {
-      ref: ref,
-      deterministicId: deterministicId,
-      ...props
+const withDeterministicId = decorator((ComposedComponent)=>{
+    const WithDeterministicId = /*#__PURE__*/ forwardRef((props, ref)=>{
+        const componentName = ComposedComponent.componentId || ComposedComponent.displayName || ComposedComponent.name;
+        const deterministicId = useDeterministicId(componentName);
+        if (props.deterministicId) {
+            warn(false, `Manually passing the "deterministicId" property is not allowed on the ${componentName} component.\n`, props.deterministicId);
+        }
+        return /*#__PURE__*/ _jsx(ComposedComponent, {
+            ref: ref,
+            deterministicId: deterministicId,
+            ...props
+        });
     });
-  });
-  hoistNonReactStatics(WithDeterministicId, ComposedComponent);
-
-  // These static fields exist on InstUI components
-  //@ts-expect-error fix this
-  WithDeterministicId.allowedProps = ComposedComponent.allowedProps;
-
-  // added so it can be tested with ReactTestUtils
-  // more info: https://github.com/facebook/react/issues/13455
-  WithDeterministicId.originalType = ComposedComponent.originalType || ComposedComponent;
-  if (typeof process !== 'undefined' && process?.env?.NODE_ENV !== 'production') {
-    WithDeterministicId.displayName = `WithDeterministicId(${ComposedComponent.displayName})`;
-  }
-  return WithDeterministicId;
+    hoistNonReactStatics(WithDeterministicId, ComposedComponent);
+    WithDeterministicId.allowedProps = ComposedComponent.allowedProps;
+    WithDeterministicId.originalType = ComposedComponent.originalType || ComposedComponent;
+    if (typeof process !== 'undefined' && process?.env?.NODE_ENV !== 'production') {
+        WithDeterministicId.displayName = `WithDeterministicId(${ComposedComponent.displayName})`;
+    }
+    return WithDeterministicId;
 });
 export default withDeterministicId;
-export { withDeterministicId };
+export { withDeterministicId };

package/es/callRenderProp.js

@@ -1,50 +1,12 @@
-/*
- * 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 React from 'react';
-/**
- * ---
- * category: utilities/react
- * ---
- * Evaluate a provided value to create a renderable React element.
- * @module callRenderProp
- * @param value
- * @param props
- */
 function callRenderProp(value, props = {}) {
-  if (typeof value === 'function') {
-    // In react 16, `createElement` accepts a function. In react 15 we get an
-    // error on rendering the result. Evaluate the function here if it is not a
-    // react component.
-    // fat arrow functions don't have a prototype
-    if (!(value.prototype && value.prototype.isReactComponent)) {
-      return value(props);
+    if (typeof value === 'function') {
+        if (!(value.prototype && value.prototype.isReactComponent)) {
+            return value(props);
+        }
+        return React.createElement(value, props);
     }
-    // TODO type 'value' properly
-    return /*#__PURE__*/React.createElement(value, props);
-  }
-  return value;
+    return value;
 }
 export default callRenderProp;
-export { callRenderProp };
+export { callRenderProp };

package/es/ensureSingleChild.js

@@ -1,58 +1,18 @@
-/*
- * 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 { jsx as _jsx } from "@emotion/react/jsx-runtime";
 import { Children } from 'react';
 import { safeCloneElement } from './safeCloneElement.js';
-
-/**
- * ---
- * category: utilities/react
- * ---
- *
- * Ensure a single child. If it is a child of length 1, return a
- * cloned instance of the child. If it is a child of length > 1,
- * wrap in a span and return the child. Return null if child has
- * no length.
- * @module ensureSingleChild
- * @param child
- * @param props props for child
- * @returns cloned instance for a single child, or children wrapped in a span
- */
-import { jsx as _jsx } from "@emotion/react/jsx-runtime";
 function ensureSingleChild(child, props = {}) {
-  const childCount = Children.count(child);
-  if (childCount === 0) {
-    return null;
-  } else if (typeof child === 'string' && child.length > 0 || childCount > 1) {
-    return _jsx("span", {
-      ...props,
-      children: child
-    });
-  } else {
-    // TODO: check that we can only end up here if child is ReactElement
-    return safeCloneElement(Array.isArray(child) ? child[0] : child, props);
-  }
+    const childCount = Children.count(child);
+    if (childCount === 0) {
+        return null;
+    } else if (typeof child === 'string' && child.length > 0 || childCount > 1) {
+        return /*#__PURE__*/ _jsx("span", {
+            ...props,
+            children: child
+        });
+    } else {
+        return safeCloneElement(Array.isArray(child) ? child[0] : child, props);
+    }
 }
 export default ensureSingleChild;
-export { ensureSingleChild };
+export { ensureSingleChild };

package/es/getDisplayName.js

@@ -1,39 +1,5 @@
-/*
- * 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
- * ---
- * Get the displayName of a React component.
- * needs a babel plugin to work https://github.com/facebook/react/issues/4915 !!
- * @module getDisplayName
- * @param ReactComponent
- * @returns the component displayName
- */
 function getDisplayName(ReactComponent) {
-  return typeof ReactComponent === 'string' ? ReactComponent : ReactComponent.displayName || ReactComponent.name;
+    return typeof ReactComponent === 'string' ? ReactComponent : ReactComponent.displayName || ReactComponent.name;
 }
 export default getDisplayName;
-export { getDisplayName };
+export { getDisplayName };

package/es/getElementType.js

@@ -1,72 +1,22 @@
-/*
- * 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 { logWarn as warn } from '@instructure/console';
-
-/**
- * A props object that is searched for some fields to determine the
- * element's type.
- */
-
-/**
- * ---
- * category: utilities/react
- * ---
- * Get the React element type for a component. It uses the following logic:
- * 1. type defined by the `as` prop
- * 2. type returned by the `getDefault()` parameter
- * 3. `<a>` if it has a `href` or `to` prop
- * 4. `<button>` if it has an `onClick` prop
- * 5. the component's defaultProp's `as` field
- * 6. `<span>` if none of the above
- *
- * @module getElementType
- * @param Component
- * @param props
- * @param getDefault an optional function that returns the default element type
- * @returns the element type
- */
 function getElementType(Component, props, getDefault) {
-  if (props.as && props.as !== Component.defaultProps?.as) {
-    return props.as;
-  }
-  if (typeof getDefault === 'function') {
-    return getDefault();
-  }
-  if (props.href) {
-    return 'a';
-  }
-  if (props.to) {
-    warn(
-    // if to prop is used without as
-    !props.as, `[${Component.displayName}] \`as\` prop should be provided when using \`to\``);
-    return 'a';
-  }
-  if (typeof props.onClick === 'function') {
-    return 'button';
-  }
-  return Component.defaultProps?.as || 'span';
+    if (props.as && props.as !== Component.defaultProps?.as) {
+        return props.as;
+    }
+    if (typeof getDefault === 'function') {
+        return getDefault();
+    }
+    if (props.href) {
+        return 'a';
+    }
+    if (props.to) {
+        warn(!props.as, `[${Component.displayName}] \`as\` prop should be provided when using \`to\``);
+        return 'a';
+    }
+    if (typeof props.onClick === 'function') {
+        return 'button';
+    }
+    return Component.defaultProps?.as || 'span';
 }
 export default getElementType;
-export { getElementType };
+export { getElementType };

package/es/getInteraction.js

@@ -1,56 +1,10 @@
-/*
- * 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
- * ---
- * Parse the component props for the interaction type. It will return one of 'enabled', 'disabled', or 'readonly'.
- * This is useful for form elements where consumers are able to either use the interaction prop as specified or the
- * native html disabled or readonly attributes
- * @module getInteraction
- * @param args extra arguments
- * @returns The calculated interaction type
- */
-export function getInteraction({
-  props = {},
-  interactionTypes = ['disabled', 'readonly']
-} = {}) {
-  const {
-    interaction,
-    disabled,
-    readOnly
-  } = props;
-
-  // interaction is the source of truth when it is provided
-  if (interaction) return interaction;
-
-  // if there's no interaction specified, use disabled or readOnly if they are defined as props (note, disabled will win
-  // over readOnly if both are provided)
-  if (interactionTypes.includes('disabled') && disabled) return 'disabled';
-  if (interactionTypes.includes('readonly') && readOnly) return 'readonly';
-
-  // We were provided with nothing, use enabled by default
-  return 'enabled';
-}
+export function getInteraction({ props = {}, interactionTypes = [
+    'disabled',
+    'readonly'
+] } = {}) {
+    const { interaction, disabled, readOnly } = props;
+    if (interaction) return interaction;
+    if (interactionTypes.includes('disabled') && disabled) return 'disabled';
+    if (interactionTypes.includes('readonly') && readOnly) return 'readonly';
+    return 'enabled';
+}