@mui/utils 5.5.3 → 5.6.0

package/CHANGELOG.md

@@ -1,5 +1,79 @@
 # [Versions](https://mui.com/versions/)
 
+## 5.6.0
+
+<!-- generated comparing v5.5.3..master -->
+
+_Apr 5, 2022_
+
+A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
+
+- 🧰 Update peer dependencies to support React 18 (#32063) @eps1lon
+- 🚀 Added the experimental `CssVarsProvider` in `@mui/material` for generating theme CSS variables (#31138) @mnajdova
+- 📣 Moved date and time pickers from the lab to MUI X (#31984) @flaviendelangle
+- Several 🐛 bug fixes and 📚 documentation improvements
+
+### `@mui/material@5.6.0`
+
+- &#8203;<!-- 25 -->[CssVarsProvider] Add experimental CssVarsProvider in @mui/material (#31138) @mnajdova
+- &#8203;<!-- 06 -->[Link] Fix `sx` color to support callback (#32123) @siriwatknp
+- &#8203;<!-- 05 -->[Link] Fix color transformation (#32045) @siriwatknp
+- &#8203;<!-- 04 -->[ListItemButton] Specified width so that text would ellide (#32083) @MatthijsMud
+- &#8203;<!-- 03 -->[TablePagination] Fixed the etEE locale (#32052) @raigoinabox
+
+### `@mui/base@5.0.0-alpha.75`
+
+- &#8203;<!-- 31 -->[Badge] Simplify unstyled API (#31974) @michaldudak
+
+### `@mui/codemod@5.6.0`
+
+- &#8203;<!-- 29 -->[codemod] Add v5.0.0/date-pickers-moved-to-x codemod (#31373) @flaviendelangle
+
+### `@mui/lab@5.0.0-alpha.76`
+
+- &#8203;<!-- 24 -->[DatePicker] Remove date and time pickers from the lab (#31984) @flaviendelangle
+
+### `@mui/joy@5.0.0-alpha.22`
+
+- &#8203;<!-- 07 -->[Joy] Add `Card` components (#32027) @siriwatknp
+
+### Docs
+
+- &#8203;<!-- 30 -->[blog] New article for the date pickers migration to X (#31831) @flaviendelangle
+- &#8203;<!-- 33 -->[docs] Base Menu style revisions and final review (#32097) @samuelsycamore
+- &#8203;<!-- 32 -->[docs] Base Select style revisions and final review (#32095) @samuelsycamore
+- &#8203;<!-- 31 -->[docs] Base Input style revisions and final review (#32096) @samuelsycamore
+- &#8203;<!-- 30 -->[docs] Base Slider style revisions and final review (#32140) @samuelsycamore
+- &#8203;<!-- 29 -->[docs] Base Modal style revisions and final review (#32093) @samuelsycamore
+- &#8203;<!-- 28 -->[docs] Add page for CSS variables support in @mui/material (#32050) @mnajdova
+- &#8203;<!-- 27 -->[docs] Add TSS support for theme style overrides (#31918) @garronej
+- &#8203;<!-- 23 -->[docs] Simplify customization examples in ButtonUnstyled demos (#32092) @michaldudak
+- &#8203;<!-- 22 -->[docs] Fix linking issues for the redirects (#32101) @siriwatknp
+- &#8203;<!-- 21 -->[docs] Create the FormControl page (#32073) @michaldudak
+- &#8203;<!-- 20 -->[docs] Remove trap-focus from the navigation (#32079) @psjishnu
+- &#8203;<!-- 19 -->[docs] Add date-pickers product identifier (#32076) @siriwatknp
+- &#8203;<!-- 18 -->[docs] Move SwitchUnstyled docs to the Base space (#31964) @michaldudak
+- &#8203;<!-- 17 -->[docs] Add docs page for unstyled popper (#31813) @siriwatknp
+- &#8203;<!-- 16 -->[docs] Copy TextareaAutosize docs to Base (#32034) @michaldudak
+- &#8203;<!-- 15 -->[docs] Add react-hook-form-mui to Complementary projects #32015 @TkaczykAdam
+- &#8203;<!-- 14 -->[docs] Improve the translation experience (#32021) @oliviertassinari
+- &#8203;<!-- 13 -->[docs] Add small size Select demo (#32060) @ivan-ngchakming
+- &#8203;<!-- 12 -->[docs] Correct typos (#32029) @apeltop
+- &#8203;<!-- 11 -->[docs] Create SliderUnstyled docs (#31850) @michaldudak
+- &#8203;<!-- 10 -->[docs] Create TablePaginationUnstyled docs (#32018) @michaldudak
+- &#8203;<!-- 09 -->[docs] Move SelectUnstyled docs to the Base space (#31816) @michaldudak
+- &#8203;<!-- 08 -->[docs] Create the TabsUnstyled docs (#32023) @michaldudak
+- &#8203;<!-- 02 -->[website] The studio finally has a name, use it (#32105) @oliviertassinari
+- &#8203;<!-- 01 -->[website] Disable job ad @oliviertassinari
+
+### Core
+
+- &#8203;<!-- 28 -->[core] Update peer deps to support React 18 (#32063) @eps1lon
+- &#8203;<!-- 27 -->[core] Fix running docs:api on Windows (#32091) @michaldudak
+- &#8203;<!-- 26 -->[core] Fix api build script for MUI Base (#32081) @siriwatknp
+
+All contributors of this release in alphabetical order: @apeltop, @eps1lon, @flaviendelangle, @garronej, @ivan-ngchakming, @m4theushw, @MatthijsMud, @michaldudak, @mnajdova, @oliviertassinari, @psjishnu, @raigoinabox, @samuelsycamore, @siriwatknp, @TkaczykAdam
+
 ## 5.5.3
 
 <!-- generated comparing v5.5.2..master -->

package/HTMLElementType.d.ts

@@ -1,3 +1,3 @@
-export default function HTMLElementType(props: {
-    [key: string]: unknown;
-}, propName: string, componentName: string, location: string, propFullName: string): Error | null;
+export default function HTMLElementType(props: {
+    [key: string]: unknown;
+}, propName: string, componentName: string, location: string, propFullName: string): Error | null;

package/chainPropTypes.d.ts

@@ -1,2 +1,2 @@
-import PropTypes from 'prop-types';
-export default function chainPropTypes<A, B>(propType1: PropTypes.Validator<A>, propType2: PropTypes.Validator<B>): PropTypes.Validator<A & B>;
+import PropTypes from 'prop-types';
+export default function chainPropTypes<A, B>(propType1: PropTypes.Validator<A>, propType2: PropTypes.Validator<B>): PropTypes.Validator<A & B>;

package/createChainedFunction.d.ts

@@ -1,7 +1,7 @@
-/**
- * Safe chained function.
- *
- * Will only create a new function if needed,
- * otherwise will pass back existing functions or null.
- */
-export default function createChainedFunction<Args extends any[], This>(...funcs: Array<(this: This, ...args: Args) => any>): (this: This, ...args: Args) => void;
+/**
+ * Safe chained function.
+ *
+ * Will only create a new function if needed,
+ * otherwise will pass back existing functions or null.
+ */
+export default function createChainedFunction<Args extends any[], This>(...funcs: Array<(this: This, ...args: Args) => any>): (this: This, ...args: Args) => void;

package/deepmerge.d.ts

@@ -1,5 +1,5 @@
-export declare function isPlainObject(item: unknown): item is Record<keyof any, unknown>;
-export interface DeepmergeOptions {
-    clone?: boolean;
-}
-export default function deepmerge<T>(target: T, source: unknown, options?: DeepmergeOptions): T;
+export declare function isPlainObject(item: unknown): item is Record<keyof any, unknown>;
+export interface DeepmergeOptions {
+    clone?: boolean;
+}
+export default function deepmerge<T>(target: T, source: unknown, options?: DeepmergeOptions): T;

package/elementAcceptingRef.d.ts

@@ -1,3 +1,3 @@
-import PropTypes from 'prop-types';
-declare const elementAcceptingRef: PropTypes.Requireable<unknown>;
-export default elementAcceptingRef;
+import PropTypes from 'prop-types';
+declare const elementAcceptingRef: PropTypes.Requireable<unknown>;
+export default elementAcceptingRef;

package/elementTypeAcceptingRef.d.ts

@@ -1,3 +1,3 @@
-import PropTypes from 'prop-types';
-declare const _default: PropTypes.Validator<PropTypes.ReactComponentLike | null | undefined>;
-export default _default;
+import PropTypes from 'prop-types';
+declare const _default: PropTypes.Validator<PropTypes.ReactComponentLike | null | undefined>;
+export default _default;

package/exactProp.d.ts

@@ -1,2 +1,2 @@
-import { ValidationMap } from 'prop-types';
-export default function exactProp<T>(propTypes: ValidationMap<T>): ValidationMap<T>;
+import { ValidationMap } from 'prop-types';
+export default function exactProp<T>(propTypes: ValidationMap<T>): ValidationMap<T>;

package/formatMuiErrorMessage.d.ts

@@ -1,6 +1,6 @@
-/**
- * WARNING: Don't import this directly.
- * Use `MuiError` from `@mui/utils/macros/MuiError.macro` instead.
- * @param {number} code
- */
-export default function formatMuiErrorMessage(code: number): string;
+/**
+ * WARNING: Don't import this directly.
+ * Use `MuiError` from `@mui/utils/macros/MuiError.macro` instead.
+ * @param {number} code
+ */
+export default function formatMuiErrorMessage(code: number): string;

package/getDisplayName.d.ts

@@ -1,8 +1,8 @@
-import * as React from 'react';
-export declare function getFunctionName(fn: Function): string;
-/**
- * cherry-pick from
- * https://github.com/facebook/react/blob/769b1f270e1251d9dbdce0fcbd9e92e502d059b8/packages/shared/getComponentName.js
- * originally forked from recompose/getDisplayName with added IE11 support
- */
-export default function getDisplayName(Component: React.ElementType): string | undefined;
+import * as React from 'react';
+export declare function getFunctionName(fn: Function): string;
+/**
+ * cherry-pick from
+ * https://github.com/facebook/react/blob/769b1f270e1251d9dbdce0fcbd9e92e502d059b8/packages/shared/getComponentName.js
+ * originally forked from recompose/getDisplayName with added IE11 support
+ */
+export default function getDisplayName(Component: React.ElementType): string | undefined;

package/getScrollbarSize.d.ts

@@ -1 +1 @@
-export default function getScrollbarSize(doc: Document): number;
+export default function getScrollbarSize(doc: Document): number;

package/index.d.ts

@@ -1,33 +1,33 @@
-export { default as chainPropTypes } from './chainPropTypes';
-export { default as deepmerge } from './deepmerge';
-export { isPlainObject } from './deepmerge';
-export { default as elementAcceptingRef } from './elementAcceptingRef';
-export { default as elementTypeAcceptingRef } from './elementTypeAcceptingRef';
-export { default as exactProp } from './exactProp';
-export { default as formatMuiErrorMessage } from './formatMuiErrorMessage';
-export { default as getDisplayName } from './getDisplayName';
-export { default as HTMLElementType } from './HTMLElementType';
-export { default as ponyfillGlobal } from './ponyfillGlobal';
-export { default as refType } from './refType';
-export { default as unstable_capitalize } from './capitalize';
-export { default as unstable_createChainedFunction } from './createChainedFunction';
-export { default as unstable_debounce } from './debounce';
-export { default as unstable_deprecatedPropType } from './deprecatedPropType';
-export { default as unstable_isMuiElement } from './isMuiElement';
-export { default as unstable_ownerDocument } from './ownerDocument';
-export { default as unstable_ownerWindow } from './ownerWindow';
-export { default as unstable_requirePropFactory } from './requirePropFactory';
-export { default as unstable_setRef } from './setRef';
-export { default as unstable_useEnhancedEffect } from './useEnhancedEffect';
-export { default as unstable_useId } from './useId';
-export { default as unstable_unsupportedProp } from './unsupportedProp';
-export { default as unstable_useControlled } from './useControlled';
-export { default as unstable_useEventCallback } from './useEventCallback';
-export { default as unstable_useForkRef } from './useForkRef';
-export { default as unstable_useIsFocusVisible } from './useIsFocusVisible';
-export { default as unstable_getScrollbarSize } from './getScrollbarSize';
-export { detectScrollType as unstable_detectScrollType, getNormalizedScrollLeft as unstable_getNormalizedScrollLeft, } from './scrollLeft';
-export { default as usePreviousProps } from './usePreviousProps';
-export { default as visuallyHidden } from './visuallyHidden';
-export { default as integerPropType } from './integerPropType';
-export { default as internal_resolveProps } from './resolveProps';
+export { default as chainPropTypes } from './chainPropTypes';
+export { default as deepmerge } from './deepmerge';
+export { isPlainObject } from './deepmerge';
+export { default as elementAcceptingRef } from './elementAcceptingRef';
+export { default as elementTypeAcceptingRef } from './elementTypeAcceptingRef';
+export { default as exactProp } from './exactProp';
+export { default as formatMuiErrorMessage } from './formatMuiErrorMessage';
+export { default as getDisplayName } from './getDisplayName';
+export { default as HTMLElementType } from './HTMLElementType';
+export { default as ponyfillGlobal } from './ponyfillGlobal';
+export { default as refType } from './refType';
+export { default as unstable_capitalize } from './capitalize';
+export { default as unstable_createChainedFunction } from './createChainedFunction';
+export { default as unstable_debounce } from './debounce';
+export { default as unstable_deprecatedPropType } from './deprecatedPropType';
+export { default as unstable_isMuiElement } from './isMuiElement';
+export { default as unstable_ownerDocument } from './ownerDocument';
+export { default as unstable_ownerWindow } from './ownerWindow';
+export { default as unstable_requirePropFactory } from './requirePropFactory';
+export { default as unstable_setRef } from './setRef';
+export { default as unstable_useEnhancedEffect } from './useEnhancedEffect';
+export { default as unstable_useId } from './useId';
+export { default as unstable_unsupportedProp } from './unsupportedProp';
+export { default as unstable_useControlled } from './useControlled';
+export { default as unstable_useEventCallback } from './useEventCallback';
+export { default as unstable_useForkRef } from './useForkRef';
+export { default as unstable_useIsFocusVisible } from './useIsFocusVisible';
+export { default as unstable_getScrollbarSize } from './getScrollbarSize';
+export { detectScrollType as unstable_detectScrollType, getNormalizedScrollLeft as unstable_getNormalizedScrollLeft, } from './scrollLeft';
+export { default as usePreviousProps } from './usePreviousProps';
+export { default as visuallyHidden } from './visuallyHidden';
+export { default as integerPropType } from './integerPropType';
+export { default as internal_resolveProps } from './resolveProps';

package/index.js

@@ -1,4 +1,4 @@
-/** @license MUI v5.5.3
+/** @license MUI v5.6.0
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.

package/integerPropType.d.ts

@@ -1,7 +1,7 @@
-export function getTypeByValue(value: any): any;
-declare function _default(props: any, propName: any, ...other: any[]): RangeError | null;
-declare namespace _default {
-    export { requiredInteger as isRequired };
-}
-export default _default;
-declare function requiredInteger(props: any, propName: any, componentName: any, location: any): RangeError | null;
+export function getTypeByValue(value: any): any;
+declare function _default(props: any, propName: any, ...other: any[]): RangeError | null;
+declare namespace _default {
+    export { requiredInteger as isRequired };
+}
+export default _default;
+declare function requiredInteger(props: any, propName: any, componentName: any, location: any): RangeError | null;

package/isMuiElement.d.ts

@@ -1 +1 @@
-export default function isMuiElement(element: any, muiNames: readonly string[]): boolean;
+export default function isMuiElement(element: any, muiNames: readonly string[]): boolean;

package/legacy/index.js

@@ -1,4 +1,4 @@
-/** @license MUI v5.5.3
+/** @license MUI v5.6.0
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.

package/modern/index.js

@@ -1,4 +1,4 @@
-/** @license MUI v5.5.3
+/** @license MUI v5.6.0
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.

package/ownerDocument.d.ts

@@ -1 +1 @@
-export default function ownerDocument(node: Node | null | undefined): Document;
+export default function ownerDocument(node: Node | null | undefined): Document;

package/ownerWindow.d.ts

@@ -1 +1 @@
-export default function ownerWindow(node: Node | undefined): Window;
+export default function ownerWindow(node: Node | undefined): Window;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/utils",
-  "version": "5.5.3",
+  "version": "5.6.0",
   "private": false,
   "author": "MUI Team",
   "description": "Utility functions for React components.",
@@ -26,7 +26,7 @@
     "url": "https://opencollective.com/mui"
   },
   "peerDependencies": {
-    "react": "^17.0.0"
+    "react": "^17.0.0 || ^18.0.0"
   },
   "dependencies": {
     "@babel/runtime": "^7.17.2",

package/ponyfillGlobal.d.ts

@@ -1,2 +1,2 @@
-declare const _default: any;
-export default _default;
+declare const _default: any;
+export default _default;

package/refType.d.ts

@@ -1,3 +1,3 @@
-import PropTypes from 'prop-types';
-declare const refType: PropTypes.Requireable<object>;
-export default refType;
+import PropTypes from 'prop-types';
+declare const refType: PropTypes.Requireable<object>;
+export default refType;

package/resolveProps.d.ts

@@ -1,9 +1,9 @@
-/**
- * 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<T extends {
-    className?: string;
-} & Record<string, unknown>>(defaultProps: T, props: T): T;
+/**
+ * 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<T extends {
+    className?: string;
+} & Record<string, unknown>>(defaultProps: T, props: T): T;

package/setRef.d.ts

@@ -1,15 +1,15 @@
-import * as React from 'react';
-/**
- * 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<T>(ref: React.MutableRefObject<T | null> | ((instance: T | null) => void) | null | undefined, value: T | null): void;
+import * as React from 'react';
+/**
+ * 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<T>(ref: React.MutableRefObject<T | null> | ((instance: T | null) => void) | null | undefined, value: T | null): void;

package/useEventCallback.d.ts

@@ -1,4 +1,4 @@
-/**
- * https://github.com/facebook/react/issues/14099#issuecomment-440013892
- */
-export default function useEventCallback<Args extends unknown[], Return>(fn: (...args: Args) => Return): (...args: Args) => Return;
+/**
+ * https://github.com/facebook/react/issues/14099#issuecomment-440013892
+ */
+export default function useEventCallback<Args extends unknown[], Return>(fn: (...args: Args) => Return): (...args: Args) => Return;

package/useEventCallback.spec.d.ts

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

package/useForkRef.d.ts

@@ -1,2 +1,2 @@
-import * as React from 'react';
-export default function useForkRef<InstanceA, InstanceB>(refA: React.Ref<InstanceA> | null | undefined, refB: React.Ref<InstanceB> | null | undefined): React.Ref<InstanceA & InstanceB> | null;
+import * as React from 'react';
+export default function useForkRef<InstanceA, InstanceB>(refA: React.Ref<InstanceA> | null | undefined, refB: React.Ref<InstanceB> | null | undefined): React.Ref<InstanceA & InstanceB> | null;

package/useId.d.ts

@@ -1,7 +1,7 @@
-/**
- *
- * @example <div id={useId()} />
- * @param idOverride
- * @returns {string}
- */
-export default function useId(idOverride?: string): string | undefined;
+/**
+ *
+ * @example <div id={useId()} />
+ * @param idOverride
+ * @returns {string}
+ */
+export default function useId(idOverride?: string): string | undefined;

package/useIsFocusVisible.d.ts

@@ -1,9 +1,9 @@
-import * as React from 'react';
-export declare function teardown(doc: Document): void;
-export interface UseIsFocusVisibleResult {
-    isFocusVisibleRef: React.MutableRefObject<boolean>;
-    onBlur: (event: React.FocusEvent<any>) => void;
-    onFocus: (event: React.FocusEvent<any>) => void;
-    ref: React.Ref<unknown>;
-}
-export default function useIsFocusVisible(): UseIsFocusVisibleResult;
+import * as React from 'react';
+export declare function teardown(doc: Document): void;
+export interface UseIsFocusVisibleResult {
+    isFocusVisibleRef: React.MutableRefObject<boolean>;
+    onBlur: (event: React.FocusEvent<any>) => void;
+    onFocus: (event: React.FocusEvent<any>) => void;
+    ref: React.Ref<unknown>;
+}
+export default function useIsFocusVisible(): UseIsFocusVisibleResult;

package/usePreviousProps.d.ts

@@ -1,2 +1,2 @@
-declare const usePreviousProps: (value: object) => object;
-export default usePreviousProps;
+declare const usePreviousProps: (value: object) => object;
+export default usePreviousProps;

package/visuallyHidden.d.ts

@@ -1,2 +1,2 @@
-declare const visuallyHidden: import('react').CSSProperties;
-export default visuallyHidden;
+declare const visuallyHidden: import('react').CSSProperties;
+export default visuallyHidden;