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

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';

package/legacy/useTimeout/useTimeout.js

@@ -1,47 +0,0 @@
-'use client';
-
-import _classCallCheck from "@babel/runtime/helpers/esm/classCallCheck";
-import _createClass from "@babel/runtime/helpers/esm/createClass";
-import useLazyRef from '../useLazyRef/useLazyRef';
-import useOnMount from '../useOnMount/useOnMount';
-export var Timeout = /*#__PURE__*/function () {
-  function Timeout() {
-    var _this = this;
-    _classCallCheck(this, Timeout);
-    this.currentId = null;
-    this.clear = function () {
-      if (_this.currentId !== null) {
-        clearTimeout(_this.currentId);
-        _this.currentId = null;
-      }
-    };
-    this.disposeEffect = function () {
-      return _this.clear;
-    };
-  }
-  return _createClass(Timeout, [{
-    key: "start",
-    value:
-    /**
-     * Executes `fn` after `delay`, clearing any previously scheduled call.
-     */
-    function start(delay, fn) {
-      var _this2 = this;
-      this.clear();
-      this.currentId = setTimeout(function () {
-        _this2.currentId = null;
-        fn();
-      }, delay);
-    }
-  }], [{
-    key: "create",
-    value: function create() {
-      return new Timeout();
-    }
-  }]);
-}();
-export default function useTimeout() {
-  var timeout = useLazyRef(Timeout.create).current;
-  useOnMount(timeout.disposeEffect);
-  return timeout;
-}

package/legacy/visuallyHidden/index.js

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

package/legacy/visuallyHidden/visuallyHidden.js

@@ -1,12 +0,0 @@
-var visuallyHidden = {
-  border: 0,
-  clip: 'rect(0 0 0 0)',
-  height: '1px',
-  margin: '-1px',
-  overflow: 'hidden',
-  padding: 0,
-  position: 'absolute',
-  whiteSpace: 'nowrap',
-  width: '1px'
-};
-export default visuallyHidden;