@mui/utils 6.0.0-alpha.1 → 6.0.0-alpha.11

package/legacy/resolveProps/index.js

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

package/legacy/resolveProps/resolveProps.js

@@ -1,34 +0,0 @@
-import _extends from "@babel/runtime/helpers/esm/extends";
-/**
- * Add keys, values of `defaultProps` that does not exist in `props`
- * @param {object} defaultProps
- * @param {object} props
- * @returns {object} resolved props
- */
-export default function resolveProps(defaultProps, props) {
-  var output = _extends({}, props);
-  Object.keys(defaultProps).forEach(function (propName) {
-    if (propName.toString().match(/^(components|slots)$/)) {
-      output[propName] = _extends({}, defaultProps[propName], output[propName]);
-    } else if (propName.toString().match(/^(componentsProps|slotProps)$/)) {
-      var defaultSlotProps = defaultProps[propName] || {};
-      var slotProps = props[propName];
-      output[propName] = {};
-      if (!slotProps || !Object.keys(slotProps)) {
-        // Reduce the iteration if the slot props is empty
-        output[propName] = defaultSlotProps;
-      } else if (!defaultSlotProps || !Object.keys(defaultSlotProps)) {
-        // Reduce the iteration if the default slot props is empty
-        output[propName] = slotProps;
-      } else {
-        output[propName] = _extends({}, slotProps);
-        Object.keys(defaultSlotProps).forEach(function (slotPropName) {
-          output[propName][slotPropName] = resolveProps(defaultSlotProps[slotPropName], slotProps[slotPropName]);
-        });
-      }
-    } else if (output[propName] === undefined) {
-      output[propName] = defaultProps[propName];
-    }
-  });
-  return output;
-}

package/legacy/scrollLeft/index.js

@@ -1 +0,0 @@
-export * from './scrollLeft';

package/legacy/scrollLeft/scrollLeft.js

@@ -1,70 +0,0 @@
-// Source from https://github.com/alitaheri/normalize-scroll-left
-var cachedType;
-
-/**
- * Based on the jquery plugin https://github.com/othree/jquery.rtl-scroll-type
- *
- * Types of scrollLeft, assuming scrollWidth=100 and direction is rtl.
- *
- * Type             | <- Most Left | Most Right -> | Initial
- * ---------------- | ------------ | ------------- | -------
- * default          | 0            | 100           | 100
- * negative (spec*) | -100         | 0             | 0
- * reverse          | 100          | 0             | 0
- *
- * Edge 85: default
- * Safari 14: negative
- * Chrome 85: negative
- * Firefox 81: negative
- * IE11: reverse
- *
- * spec* https://drafts.csswg.org/cssom-view/#dom-window-scroll
- */
-export function detectScrollType() {
-  if (cachedType) {
-    return cachedType;
-  }
-  var dummy = document.createElement('div');
-  var container = document.createElement('div');
-  container.style.width = '10px';
-  container.style.height = '1px';
-  dummy.appendChild(container);
-  dummy.dir = 'rtl';
-  dummy.style.fontSize = '14px';
-  dummy.style.width = '4px';
-  dummy.style.height = '1px';
-  dummy.style.position = 'absolute';
-  dummy.style.top = '-1000px';
-  dummy.style.overflow = 'scroll';
-  document.body.appendChild(dummy);
-  cachedType = 'reverse';
-  if (dummy.scrollLeft > 0) {
-    cachedType = 'default';
-  } else {
-    dummy.scrollLeft = 1;
-    if (dummy.scrollLeft === 0) {
-      cachedType = 'negative';
-    }
-  }
-  document.body.removeChild(dummy);
-  return cachedType;
-}
-
-// Based on https://stackoverflow.com/a/24394376
-export function getNormalizedScrollLeft(element, direction) {
-  var scrollLeft = element.scrollLeft;
-
-  // Perform the calculations only when direction is rtl to avoid messing up the ltr behavior
-  if (direction !== 'rtl') {
-    return scrollLeft;
-  }
-  var type = detectScrollType();
-  switch (type) {
-    case 'negative':
-      return element.scrollWidth - element.clientWidth + scrollLeft;
-    case 'reverse':
-      return element.scrollWidth - element.clientWidth - scrollLeft;
-    default:
-      return scrollLeft;
-  }
-}

package/legacy/setRef/index.js

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

package/legacy/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/legacy/unsupportedProp/index.js

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

package/legacy/unsupportedProp/unsupportedProp.js

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

package/legacy/useControlled/index.js

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

package/legacy/useControlled/useControlled.js

@@ -1,38 +0,0 @@
-'use client';
-
-/* eslint-disable react-hooks/rules-of-hooks, react-hooks/exhaustive-deps */
-import * as React from 'react';
-export default function useControlled(_ref) {
-  var controlled = _ref.controlled,
-    defaultProp = _ref.default,
-    name = _ref.name,
-    _ref$state = _ref.state,
-    state = _ref$state === void 0 ? 'value' : _ref$state;
-  // isControlled is ignored in the hook dependency lists as it should never change.
-  var _React$useRef = React.useRef(controlled !== undefined),
-    isControlled = _React$useRef.current;
-  var _React$useState = React.useState(defaultProp),
-    valueState = _React$useState[0],
-    setValue = _React$useState[1];
-  var value = isControlled ? controlled : valueState;
-  if (process.env.NODE_ENV !== 'production') {
-    React.useEffect(function () {
-      if (isControlled !== (controlled !== undefined)) {
-        console.error(["MUI: A component is changing the ".concat(isControlled ? '' : 'un', "controlled ").concat(state, " state of ").concat(name, " to be ").concat(isControlled ? 'un' : '', "controlled."), 'Elements should not switch from uncontrolled to controlled (or vice versa).', "Decide between using a controlled or uncontrolled ".concat(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]);
-    var _React$useRef2 = React.useRef(defaultProp),
-      defaultValue = _React$useRef2.current;
-    React.useEffect(function () {
-      if (!isControlled && defaultValue !== defaultProp) {
-        console.error(["MUI: A component is changing the default ".concat(state, " state of an uncontrolled ").concat(name, " after being initialized. ") + "To suppress this warning opt to use a controlled ".concat(name, ".")].join('\n'));
-      }
-    }, [JSON.stringify(defaultProp)]);
-  }
-  var setValueIfUncontrolled = React.useCallback(function (newValue) {
-    if (!isControlled) {
-      setValue(newValue);
-    }
-  }, []);
-  return [value, setValueIfUncontrolled];
-}

package/legacy/useEnhancedEffect/index.js

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

package/legacy/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.
- */
-var useEnhancedEffect = typeof window !== 'undefined' ? React.useLayoutEffect : React.useEffect;
-export default useEnhancedEffect;

package/legacy/useEventCallback/index.js

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

package/legacy/useEventCallback/useEventCallback.js

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

package/legacy/useForkRef/index.js

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

package/legacy/useForkRef/useForkRef.js

@@ -1,27 +0,0 @@
-'use client';
-
-import * as React from 'react';
-import setRef from '../setRef';
-export default function useForkRef() {
-  for (var _len = arguments.length, refs = new Array(_len), _key = 0; _key < _len; _key++) {
-    refs[_key] = arguments[_key];
-  }
-  /**
-   * 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(function () {
-    if (refs.every(function (ref) {
-      return ref == null;
-    })) {
-      return null;
-    }
-    return function (instance) {
-      refs.forEach(function (ref) {
-        setRef(ref, instance);
-      });
-    };
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, refs);
-}

package/legacy/useId/index.js

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

package/legacy/useId/useId.js

@@ -1,38 +0,0 @@
-'use client';
-
-import * as React from 'react';
-var globalId = 0;
-function useGlobalId(idOverride) {
-  var _React$useState = React.useState(idOverride),
-    defaultId = _React$useState[0],
-    setDefaultId = _React$useState[1];
-  var id = idOverride || defaultId;
-  React.useEffect(function () {
-    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-".concat(globalId));
-    }
-  }, [defaultId]);
-  return id;
-}
-
-// downstream bundlers may remove unnecessary concatenation, but won't remove toString call -- Workaround for https://github.com/webpack/webpack/issues/14814
-var maybeReactUseId = React['useId'.toString()];
-/**
- *
- * @example <div id={useId()} />
- * @param idOverride
- * @returns {string}
- */
-export default function useId(idOverride) {
-  if (maybeReactUseId !== undefined) {
-    var reactId = maybeReactUseId();
-    return idOverride != null ? idOverride : reactId;
-  }
-  // eslint-disable-next-line react-hooks/rules-of-hooks -- `React.useId` is invariant at runtime.
-  return useGlobalId(idOverride);
-}

package/legacy/useIsFocusVisible/index.js

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

package/legacy/useIsFocusVisible/useIsFocusVisible.js

@@ -1,160 +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';
-var hadKeyboardEvent = true;
-var hadFocusVisibleRecently = false;
-var hadFocusVisibleRecentlyTimeout = new Timeout();
-var 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) {
-  var _ref = node,
-    type = _ref.type,
-    tagName = _ref.tagName;
-  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) {
-  var target = event.target;
-  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() {
-  var ref = React.useCallback(function (node) {
-    if (node != null) {
-      prepare(node.ownerDocument);
-    }
-  }, []);
-  var 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, function () {
-        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: isFocusVisibleRef,
-    onFocus: handleFocusVisible,
-    onBlur: handleBlurVisible,
-    ref: ref
-  };
-}

package/legacy/useLazyRef/index.js

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

package/legacy/useLazyRef/useLazyRef.js

@@ -1,19 +0,0 @@
-'use client';
-
-import * as React from 'react';
-var 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) {
-  var ref = React.useRef(UNINITIALIZED);
-  if (ref.current === UNINITIALIZED) {
-    ref.current = init(initArg);
-  }
-  return ref;
-}

package/legacy/useLocalStorageState/index.js

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

package/legacy/useLocalStorageState/useLocalStorageState.js

@@ -1,121 +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
-var currentTabChangeListeners = new Map();
-function onCurrentTabStorageChange(key, handler) {
-  var listeners = currentTabChangeListeners.get(key);
-  if (!listeners) {
-    listeners = new Set();
-    currentTabChangeListeners.set(key, listeners);
-  }
-  listeners.add(handler);
-}
-function offCurrentTabStorageChange(key, handler) {
-  var listeners = currentTabChangeListeners.get(key);
-  if (!listeners) {
-    return;
-  }
-  listeners.delete(handler);
-  if (listeners.size === 0) {
-    currentTabChangeListeners.delete(key);
-  }
-}
-function emitCurrentTabStorageChange(key) {
-  var listeners = currentTabChangeListeners.get(key);
-  if (listeners) {
-    listeners.forEach(function (listener) {
-      return listener();
-    });
-  }
-}
-function subscribe(area, key, callbark) {
-  if (!key) {
-    return function () {};
-  }
-  var storageHandler = function storageHandler(event) {
-    if (event.storageArea === area && event.key === key) {
-      callbark();
-    }
-  };
-  window.addEventListener('storage', storageHandler);
-  onCurrentTabStorageChange(key, callbark);
-  return function () {
-    window.removeEventListener('storage', storageHandler);
-    offCurrentTabStorageChange(key, callbark);
-  };
-}
-function getSnapshot(area, key) {
-  if (!key) {
-    return null;
-  }
-  try {
-    return area.getItem(key);
-  } catch (_unused) {
-    // 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 (_unused2) {
-    // 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);
-}
-var serverValue = [null, function () {}];
-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) {
-  var initializer = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : null;
-  var _React$useState = React.useState(initializer),
-    initialValue = _React$useState[0];
-  var area = window.localStorage;
-  var subscribeKey = React.useCallback(function (callbark) {
-    return subscribe(area, key, callbark);
-  }, [area, key]);
-  var getKeySnapshot = React.useCallback(function () {
-    var _getSnapshot;
-    return (_getSnapshot = getSnapshot(area, key)) != null ? _getSnapshot : initialValue;
-  }, [area, initialValue, key]);
-
-  // Start with null for the hydration, and then switch to the actual value.
-  var getKeyServerSnapshot = function getKeyServerSnapshot() {
-    return null;
-  };
-  var storedValue = React.useSyncExternalStore(subscribeKey, getKeySnapshot, getKeyServerSnapshot);
-  var setStoredValue = React.useCallback(function (value) {
-    var valueToStore = value instanceof Function ? value(storedValue) : value;
-    setValue(area, key, valueToStore);
-  }, [area, key, storedValue]);
-  var _React$useState2 = React.useState(initialValue),
-    nonStoredValue = _React$useState2[0],
-    setNonStoredValue = _React$useState2[1];
-  if (!key) {
-    return [nonStoredValue, setNonStoredValue];
-  }
-  return [storedValue, setStoredValue];
-}
-export default typeof window === 'undefined' ? useLocalStorageStateServer : useLocalStorageStateBrowser;

package/legacy/useOnMount/index.js

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

package/legacy/useOnMount/useOnMount.js

@@ -1,13 +0,0 @@
-'use client';
-
-import * as React from 'react';
-var EMPTY = [];
-
-/**
- * A React.useEffect equivalent that runs once, when the component is mounted.
- */
-export default function useOnMount(fn) {
-  /* eslint-disable react-hooks/exhaustive-deps */
-  React.useEffect(fn, EMPTY);
-  /* eslint-enable react-hooks/exhaustive-deps */
-}

package/legacy/usePreviousProps/index.js

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

package/legacy/usePreviousProps/usePreviousProps.js

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

package/legacy/useTimeout/index.js

@@ -1,2 +0,0 @@
-export { default } from './useTimeout';
-export { Timeout } from './useTimeout';