@mui/utils 7.0.0 → 7.0.2

package/modern/requirePropFactory/requirePropFactory.js

@@ -1,25 +0,0 @@
-export default function requirePropFactory(componentNameInError, Component) {
-  if (process.env.NODE_ENV === 'production') {
-    return () => null;
-  }
-
-  // eslint-disable-next-line react/forbid-foreign-prop-types
-  const prevPropTypes = Component ? {
-    ...Component.propTypes
-  } : null;
-  const requireProp = requiredProp => (props, propName, componentName, location, propFullName, ...args) => {
-    const propFullNameSafe = propFullName || propName;
-    const defaultTypeChecker = prevPropTypes?.[propFullNameSafe];
-    if (defaultTypeChecker) {
-      const typeCheckerResult = defaultTypeChecker(props, propName, componentName, location, propFullName, ...args);
-      if (typeCheckerResult) {
-        return typeCheckerResult;
-      }
-    }
-    if (typeof props[propName] !== 'undefined' && !props[requiredProp]) {
-      return new Error(`The prop \`${propFullNameSafe}\` of ` + `\`${componentNameInError}\` can only be used together with the \`${requiredProp}\` prop.`);
-    }
-    return null;
-  };
-  return requireProp;
-}

package/modern/resolveComponentProps/index.js

@@ -1 +0,0 @@
-export { default } from "./resolveComponentProps.js";

package/modern/resolveComponentProps/resolveComponentProps.js

@@ -1,11 +0,0 @@
-/**
- * If `componentProps` is a function, calls it with the provided `ownerState`.
- * Otherwise, just returns `componentProps`.
- */
-function resolveComponentProps(componentProps, ownerState, slotState) {
-  if (typeof componentProps === 'function') {
-    return componentProps(ownerState, slotState);
-  }
-  return componentProps;
-}
-export default resolveComponentProps;

package/modern/resolveProps/index.js

@@ -1 +0,0 @@
-export { default } from "./resolveProps.js";

package/modern/resolveProps/resolveProps.js

@@ -1,43 +0,0 @@
-/**
- * Add keys, values of `defaultProps` that does not exist in `props`
- * @param defaultProps
- * @param props
- * @returns resolved props
- */
-export default function resolveProps(defaultProps, props) {
-  const output = {
-    ...props
-  };
-  for (const key in defaultProps) {
-    if (Object.prototype.hasOwnProperty.call(defaultProps, key)) {
-      const propName = key;
-      if (propName === 'components' || propName === 'slots') {
-        output[propName] = {
-          ...defaultProps[propName],
-          ...output[propName]
-        };
-      } else if (propName === 'componentsProps' || propName === 'slotProps') {
-        const defaultSlotProps = defaultProps[propName];
-        const slotProps = props[propName];
-        if (!slotProps) {
-          output[propName] = defaultSlotProps || {};
-        } else if (!defaultSlotProps) {
-          output[propName] = slotProps;
-        } else {
-          output[propName] = {
-            ...slotProps
-          };
-          for (const slotKey in defaultSlotProps) {
-            if (Object.prototype.hasOwnProperty.call(defaultSlotProps, slotKey)) {
-              const slotPropName = slotKey;
-              output[propName][slotPropName] = resolveProps(defaultSlotProps[slotPropName], slotProps[slotPropName]);
-            }
-          }
-        }
-      } else if (output[propName] === undefined) {
-        output[propName] = defaultProps[propName];
-      }
-    }
-  }
-  return output;
-}

package/modern/setRef/index.js

@@ -1 +0,0 @@
-export { default } from "./setRef.js";

package/modern/setRef/setRef.js

@@ -1,20 +0,0 @@
-/**
- * TODO v5: consider making it private
- *
- * passes {value} to {ref}
- *
- * WARNING: Be sure to only call this inside a callback that is passed as a ref.
- * Otherwise, make sure to cleanup the previous {ref} if it changes. See
- * https://github.com/mui/material-ui/issues/13539
- *
- * Useful if you want to expose the ref of an inner component to the public API
- * while still using it inside the component.
- * @param ref A ref callback or ref object. If anything falsy, this is a no-op.
- */
-export default function setRef(ref, value) {
-  if (typeof ref === 'function') {
-    ref(value);
-  } else if (ref) {
-    ref.current = value;
-  }
-}

package/modern/types/index.js

@@ -1 +0,0 @@
-export {};

package/modern/unsupportedProp/index.js

@@ -1 +0,0 @@
-export { default } from "./unsupportedProp.js";

package/modern/unsupportedProp/unsupportedProp.js

@@ -1,10 +0,0 @@
-export default function unsupportedProp(props, propName, componentName, location, propFullName) {
-  if (process.env.NODE_ENV === 'production') {
-    return null;
-  }
-  const propFullNameSafe = propFullName || propName;
-  if (typeof props[propName] !== 'undefined') {
-    return new Error(`The prop \`${propFullNameSafe}\` is not supported. Please remove it.`);
-  }
-  return null;
-}

package/modern/useControlled/index.js

@@ -1 +0,0 @@
-export { default } from "./useControlled.js";

package/modern/useControlled/useControlled.js

@@ -1,41 +0,0 @@
-'use client';
-
-// TODO: uncomment once we enable eslint-plugin-react-compiler // eslint-disable-next-line react-compiler/react-compiler -- process.env never changes, dependency arrays are intentionally ignored
-/* eslint-disable react-hooks/rules-of-hooks, react-hooks/exhaustive-deps */
-import * as React from 'react';
-export default function useControlled({
-  controlled,
-  default: defaultProp,
-  name,
-  state = 'value'
-}) {
-  // isControlled is ignored in the hook dependency lists as it should never change.
-  const {
-    current: isControlled
-  } = React.useRef(controlled !== undefined);
-  const [valueState, setValue] = React.useState(defaultProp);
-  const value = isControlled ? controlled : valueState;
-  if (process.env.NODE_ENV !== 'production') {
-    React.useEffect(() => {
-      if (isControlled !== (controlled !== undefined)) {
-        console.error([`MUI: A component is changing the ${isControlled ? '' : 'un'}controlled ${state} state of ${name} to be ${isControlled ? 'un' : ''}controlled.`, 'Elements should not switch from uncontrolled to controlled (or vice versa).', `Decide between using a controlled or uncontrolled ${name} ` + 'element for the lifetime of the component.', "The nature of the state is determined during the first render. It's considered controlled if the value is not `undefined`.", 'More info: https://fb.me/react-controlled-components'].join('\n'));
-      }
-    }, [state, name, controlled]);
-    const {
-      current: defaultValue
-    } = React.useRef(defaultProp);
-    React.useEffect(() => {
-      // Object.is() is not equivalent to the === operator.
-      // See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/is for more details.
-      if (!isControlled && !Object.is(defaultValue, defaultProp)) {
-        console.error([`MUI: A component is changing the default ${state} state of an uncontrolled ${name} after being initialized. ` + `To suppress this warning opt to use a controlled ${name}.`].join('\n'));
-      }
-    }, [JSON.stringify(defaultProp)]);
-  }
-  const setValueIfUncontrolled = React.useCallback(newValue => {
-    if (!isControlled) {
-      setValue(newValue);
-    }
-  }, []);
-  return [value, setValueIfUncontrolled];
-}

package/modern/useEnhancedEffect/index.js

@@ -1 +0,0 @@
-export { default } from "./useEnhancedEffect.js";

package/modern/useEnhancedEffect/useEnhancedEffect.js

@@ -1,13 +0,0 @@
-'use client';
-
-import * as React from 'react';
-
-/**
- * A version of `React.useLayoutEffect` that does not show a warning when server-side rendering.
- * This is useful for effects that are only needed for client-side rendering but not for SSR.
- *
- * Before you use this hook, make sure to read https://gist.github.com/gaearon/e7d97cdf38a2907924ea12e4ebdf3c85
- * and confirm it doesn't apply to your use-case.
- */
-const useEnhancedEffect = typeof window !== 'undefined' ? React.useLayoutEffect : React.useEffect;
-export default useEnhancedEffect;

package/modern/useEventCallback/index.js

@@ -1 +0,0 @@
-export { default } from "./useEventCallback.js";

package/modern/useEventCallback/useEventCallback.js

@@ -1,20 +0,0 @@
-'use client';
-
-import * as React from 'react';
-import useEnhancedEffect from "../useEnhancedEffect/index.js";
-
-/**
- * Inspired by https://github.com/facebook/react/issues/14099#issuecomment-440013892
- * See RFC in https://github.com/reactjs/rfcs/pull/220
- */
-
-function useEventCallback(fn) {
-  const ref = React.useRef(fn);
-  useEnhancedEffect(() => {
-    ref.current = fn;
-  });
-  return React.useRef((...args) =>
-  // @ts-expect-error hide `this`
-  (0, ref.current)(...args)).current;
-}
-export default useEventCallback;

package/modern/useForkRef/index.js

@@ -1 +0,0 @@
-export { default } from "./useForkRef.js";

package/modern/useForkRef/useForkRef.js

@@ -1,40 +0,0 @@
-'use client';
-
-import * as React from 'react';
-import setRef from "../setRef/index.js";
-
-/**
- * Takes an array of refs and returns a new ref which will apply any modification to all of the refs.
- * This is useful when you want to have the ref used in multiple places.
- *
- * ```tsx
- * const rootRef = React.useRef<Instance>(null);
- * const refFork = useForkRef(rootRef, props.ref);
- *
- * return (
- *   <Root {...props} ref={refFork} />
- * );
- * ```
- *
- * @param {Array<React.Ref<Instance> | undefined>} refs The ref array.
- * @returns {React.RefCallback<Instance> | null} The new ref callback.
- */
-export default function useForkRef(...refs) {
-  /**
-   * This will create a new function if the refs passed to this hook change and are all defined.
-   * This means react will call the old forkRef with `null` and the new forkRef
-   * with the ref. Cleanup naturally emerges from this behavior.
-   */
-  return React.useMemo(() => {
-    if (refs.every(ref => ref == null)) {
-      return null;
-    }
-    return instance => {
-      refs.forEach(ref => {
-        setRef(ref, instance);
-      });
-    };
-    // TODO: uncomment once we enable eslint-plugin-react-compiler // eslint-disable-next-line react-compiler/react-compiler -- intentionally ignoring that the dependency array must be an array literal
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, refs);
-}

package/modern/useId/index.js

@@ -1 +0,0 @@
-export { default } from "./useId.js";

package/modern/useId/useId.js

@@ -1,45 +0,0 @@
-'use client';
-
-import * as React from 'react';
-let globalId = 0;
-
-// TODO React 17: Remove `useGlobalId` once React 17 support is removed
-function useGlobalId(idOverride) {
-  const [defaultId, setDefaultId] = React.useState(idOverride);
-  const id = idOverride || defaultId;
-  React.useEffect(() => {
-    if (defaultId == null) {
-      // Fallback to this default id when possible.
-      // Use the incrementing value for client-side rendering only.
-      // We can't use it server-side.
-      // If you want to use random values please consider the Birthday Problem: https://en.wikipedia.org/wiki/Birthday_problem
-      globalId += 1;
-      setDefaultId(`mui-${globalId}`);
-    }
-  }, [defaultId]);
-  return id;
-}
-
-// See https://github.com/mui/material-ui/issues/41190#issuecomment-2040873379 for why
-const safeReact = {
-  ...React
-};
-const maybeReactUseId = safeReact.useId;
-
-/**
- *
- * @example <div id={useId()} />
- * @param idOverride
- * @returns {string}
- */
-export default function useId(idOverride) {
-  // React.useId() is only available from React 17.0.0.
-  if (maybeReactUseId !== undefined) {
-    const reactId = maybeReactUseId();
-    return idOverride ?? reactId;
-  }
-
-  // TODO: uncomment once we enable eslint-plugin-react-compiler // eslint-disable-next-line react-compiler/react-compiler
-  // eslint-disable-next-line react-hooks/rules-of-hooks -- `React.useId` is invariant at runtime.
-  return useGlobalId(idOverride);
-}

package/modern/useIsFocusVisible/index.js

@@ -1,2 +0,0 @@
-export { default } from "./useIsFocusVisible.js";
-export * from "./useIsFocusVisible.js";

package/modern/useIsFocusVisible/useIsFocusVisible.js

@@ -1,163 +0,0 @@
-'use client';
-
-// based on https://github.com/WICG/focus-visible/blob/v4.1.5/src/focus-visible.js
-import * as React from 'react';
-import { Timeout } from "../useTimeout/useTimeout.js";
-let hadKeyboardEvent = true;
-let hadFocusVisibleRecently = false;
-const hadFocusVisibleRecentlyTimeout = new Timeout();
-const inputTypesWhitelist = {
-  text: true,
-  search: true,
-  url: true,
-  tel: true,
-  email: true,
-  password: true,
-  number: true,
-  date: true,
-  month: true,
-  week: true,
-  time: true,
-  datetime: true,
-  'datetime-local': true
-};
-
-/**
- * Computes whether the given element should automatically trigger the
- * `focus-visible` class being added, i.e. whether it should always match
- * `:focus-visible` when focused.
- * @param {Element} node
- * @returns {boolean}
- */
-function focusTriggersKeyboardModality(node) {
-  const {
-    type,
-    tagName
-  } = node;
-  if (tagName === 'INPUT' && inputTypesWhitelist[type] && !node.readOnly) {
-    return true;
-  }
-  if (tagName === 'TEXTAREA' && !node.readOnly) {
-    return true;
-  }
-  if (node.isContentEditable) {
-    return true;
-  }
-  return false;
-}
-
-/**
- * Keep track of our keyboard modality state with `hadKeyboardEvent`.
- * If the most recent user interaction was via the keyboard;
- * and the key press did not include a meta, alt/option, or control key;
- * then the modality is keyboard. Otherwise, the modality is not keyboard.
- * @param {KeyboardEvent} event
- */
-function handleKeyDown(event) {
-  if (event.metaKey || event.altKey || event.ctrlKey) {
-    return;
-  }
-  hadKeyboardEvent = true;
-}
-
-/**
- * If at any point a user clicks with a pointing device, ensure that we change
- * the modality away from keyboard.
- * This avoids the situation where a user presses a key on an already focused
- * element, and then clicks on a different element, focusing it with a
- * pointing device, while we still think we're in keyboard modality.
- */
-function handlePointerDown() {
-  hadKeyboardEvent = false;
-}
-function handleVisibilityChange() {
-  if (this.visibilityState === 'hidden') {
-    // If the tab becomes active again, the browser will handle calling focus
-    // on the element (Safari actually calls it twice).
-    // If this tab change caused a blur on an element with focus-visible,
-    // re-apply the class when the user switches back to the tab.
-    if (hadFocusVisibleRecently) {
-      hadKeyboardEvent = true;
-    }
-  }
-}
-function prepare(doc) {
-  doc.addEventListener('keydown', handleKeyDown, true);
-  doc.addEventListener('mousedown', handlePointerDown, true);
-  doc.addEventListener('pointerdown', handlePointerDown, true);
-  doc.addEventListener('touchstart', handlePointerDown, true);
-  doc.addEventListener('visibilitychange', handleVisibilityChange, true);
-}
-export function teardown(doc) {
-  doc.removeEventListener('keydown', handleKeyDown, true);
-  doc.removeEventListener('mousedown', handlePointerDown, true);
-  doc.removeEventListener('pointerdown', handlePointerDown, true);
-  doc.removeEventListener('touchstart', handlePointerDown, true);
-  doc.removeEventListener('visibilitychange', handleVisibilityChange, true);
-}
-function isFocusVisible(event) {
-  const {
-    target
-  } = event;
-  try {
-    return target.matches(':focus-visible');
-  } catch (error) {
-    // Browsers not implementing :focus-visible will throw a SyntaxError.
-    // We use our own heuristic for those browsers.
-    // Rethrow might be better if it's not the expected error but do we really
-    // want to crash if focus-visible malfunctioned?
-  }
-
-  // No need for validFocusTarget check. The user does that by attaching it to
-  // focusable events only.
-  return hadKeyboardEvent || focusTriggersKeyboardModality(target);
-}
-export default function useIsFocusVisible() {
-  const ref = React.useCallback(node => {
-    if (node != null) {
-      prepare(node.ownerDocument);
-    }
-  }, []);
-  const isFocusVisibleRef = React.useRef(false);
-
-  /**
-   * Should be called if a blur event is fired
-   */
-  function handleBlurVisible() {
-    // checking against potential state variable does not suffice if we focus and blur synchronously.
-    // React wouldn't have time to trigger a re-render so `focusVisible` would be stale.
-    // Ideally we would adjust `isFocusVisible(event)` to look at `relatedTarget` for blur events.
-    // This doesn't work in IE11 due to https://github.com/facebook/react/issues/3751
-    // TODO: check again if React releases their internal changes to focus event handling (https://github.com/facebook/react/pull/19186).
-    if (isFocusVisibleRef.current) {
-      // To detect a tab/window switch, we look for a blur event followed
-      // rapidly by a visibility change.
-      // If we don't see a visibility change within 100ms, it's probably a
-      // regular focus change.
-      hadFocusVisibleRecently = true;
-      hadFocusVisibleRecentlyTimeout.start(100, () => {
-        hadFocusVisibleRecently = false;
-      });
-      isFocusVisibleRef.current = false;
-      return true;
-    }
-    return false;
-  }
-
-  /**
-   * Should be called if a blur event is fired
-   */
-  function handleFocusVisible(event) {
-    if (isFocusVisible(event)) {
-      isFocusVisibleRef.current = true;
-      return true;
-    }
-    return false;
-  }
-  return {
-    isFocusVisibleRef,
-    onFocus: handleFocusVisible,
-    onBlur: handleBlurVisible,
-    ref
-  };
-}

package/modern/useLazyRef/index.js

@@ -1 +0,0 @@
-export { default } from "./useLazyRef.js";

package/modern/useLazyRef/useLazyRef.js

@@ -1,19 +0,0 @@
-'use client';
-
-import * as React from 'react';
-const UNINITIALIZED = {};
-
-/**
- * A React.useRef() that is initialized lazily with a function. Note that it accepts an optional
- * initialization argument, so the initialization function doesn't need to be an inline closure.
- *
- * @usage
- *   const ref = useLazyRef(sortColumns, columns)
- */
-export default function useLazyRef(init, initArg) {
-  const ref = React.useRef(UNINITIALIZED);
-  if (ref.current === UNINITIALIZED) {
-    ref.current = init(initArg);
-  }
-  return ref;
-}

package/modern/useLocalStorageState/index.js

@@ -1 +0,0 @@
-export { default } from "./useLocalStorageState.js";

package/modern/useLocalStorageState/useLocalStorageState.js

@@ -1,108 +0,0 @@
-'use client';
-
-import * as React from 'react';
-
-// storage events only work across tabs, we'll use an event emitter to announce within the current tab
-const currentTabChangeListeners = new Map();
-function onCurrentTabStorageChange(key, handler) {
-  let listeners = currentTabChangeListeners.get(key);
-  if (!listeners) {
-    listeners = new Set();
-    currentTabChangeListeners.set(key, listeners);
-  }
-  listeners.add(handler);
-}
-function offCurrentTabStorageChange(key, handler) {
-  const listeners = currentTabChangeListeners.get(key);
-  if (!listeners) {
-    return;
-  }
-  listeners.delete(handler);
-  if (listeners.size === 0) {
-    currentTabChangeListeners.delete(key);
-  }
-}
-function emitCurrentTabStorageChange(key) {
-  const listeners = currentTabChangeListeners.get(key);
-  if (listeners) {
-    listeners.forEach(listener => listener());
-  }
-}
-function subscribe(area, key, callback) {
-  if (!key) {
-    return () => {};
-  }
-  const storageHandler = event => {
-    if (event.storageArea === area && event.key === key) {
-      callback();
-    }
-  };
-  window.addEventListener('storage', storageHandler);
-  onCurrentTabStorageChange(key, callback);
-  return () => {
-    window.removeEventListener('storage', storageHandler);
-    offCurrentTabStorageChange(key, callback);
-  };
-}
-function getSnapshot(area, key) {
-  if (!key) {
-    return null;
-  }
-  try {
-    return area.getItem(key);
-  } catch {
-    // ignore
-    // See https://developer.mozilla.org/en-US/docs/Web/API/Web_Storage_API/Using_the_Web_Storage_API#feature-detecting_localstorage
-    return null;
-  }
-}
-function setValue(area, key, value) {
-  if (!key) {
-    return;
-  }
-  try {
-    if (value === null) {
-      area.removeItem(key);
-    } else {
-      area.setItem(key, String(value));
-    }
-  } catch {
-    // ignore
-    // See https://developer.mozilla.org/en-US/docs/Web/API/Web_Storage_API/Using_the_Web_Storage_API#feature-detecting_localstorage
-    return;
-  }
-  emitCurrentTabStorageChange(key);
-}
-const serverValue = [null, () => {}];
-function useLocalStorageStateServer() {
-  return serverValue;
-}
-
-/**
- * Sync state to local storage so that it persists through a page refresh. Usage is
- * similar to useState except we pass in a storage key so that we can default
- * to that value on page load instead of the specified initial value.
- *
- * Since the storage API isn't available in server-rendering environments, we
- * return null during SSR and hydration.
- */
-function useLocalStorageStateBrowser(key, initializer = null) {
-  const [initialValue] = React.useState(initializer);
-  const area = window.localStorage;
-  const subscribeKey = React.useCallback(callback => subscribe(area, key, callback), [area, key]);
-  const getKeySnapshot = React.useCallback(() => getSnapshot(area, key) ?? initialValue, [area, initialValue, key]);
-
-  // Start with null for the hydration, and then switch to the actual value.
-  const getKeyServerSnapshot = () => null;
-  const storedValue = React.useSyncExternalStore(subscribeKey, getKeySnapshot, getKeyServerSnapshot);
-  const setStoredValue = React.useCallback(value => {
-    const valueToStore = value instanceof Function ? value(storedValue) : value;
-    setValue(area, key, valueToStore);
-  }, [area, key, storedValue]);
-  const [nonStoredValue, setNonStoredValue] = React.useState(initialValue);
-  if (!key) {
-    return [nonStoredValue, setNonStoredValue];
-  }
-  return [storedValue, setStoredValue];
-}
-export default typeof window === 'undefined' ? useLocalStorageStateServer : useLocalStorageStateBrowser;

package/modern/useOnMount/index.js

@@ -1 +0,0 @@
-export { default } from "./useOnMount.js";

package/modern/useOnMount/useOnMount.js

@@ -1,14 +0,0 @@
-'use client';
-
-import * as React from 'react';
-const EMPTY = [];
-
-/**
- * A React.useEffect equivalent that runs once, when the component is mounted.
- */
-export default function useOnMount(fn) {
-  // TODO: uncomment once we enable eslint-plugin-react-compiler // eslint-disable-next-line react-compiler/react-compiler -- no need to put `fn` in the dependency array
-  /* eslint-disable react-hooks/exhaustive-deps */
-  React.useEffect(fn, EMPTY);
-  /* eslint-enable react-hooks/exhaustive-deps */
-}

package/modern/usePreviousProps/index.js

@@ -1 +0,0 @@
-export { default } from "./usePreviousProps.js";

package/modern/usePreviousProps/usePreviousProps.js

@@ -1,11 +0,0 @@
-'use client';
-
-import * as React from 'react';
-const usePreviousProps = value => {
-  const ref = React.useRef({});
-  React.useEffect(() => {
-    ref.current = value;
-  });
-  return ref.current;
-};
-export default usePreviousProps;

package/modern/useSlotProps/index.js

@@ -1 +0,0 @@
-export { default } from "./useSlotProps.js";