@mui/utils 5.7.0 → 5.8.0

package/CHANGELOG.md

@@ -1,5 +1,77 @@
 # [Versions](https://mui.com/versions/)
 
+## 5.8.0
+
+<!-- generated comparing v5.7.0..master -->
+
+_May 17, 2022_
+
+A big thanks to the 14 contributors who made this release possible. Here are some highlights ✨:
+
+- 🚀 [Blog post](https://mui.com/blog/premium-plan-release/) for announcing the release of the Premium plan of MUI X is out thanks to @joserodolfofreitas.
+- Codemod for `jss` to `tss-react` migration is out thanks to @ryancogswell
+- And more 🐛 bug fixes and 📚 documentation improvements.
+
+### `@mui/material@5.8.0`
+
+- &#8203;<!-- 37 -->[Autocomplete] Fix `getInputProps` TypeScript return type (#32730) @ZeeshanTamboli
+- &#8203;<!-- 36 -->[Autocomplete] Forward props to renderTags() (#32637) @emlai
+- &#8203;<!-- 35 -->[Badge] Fix TypeScript error when adding style overrides for Badge (#32745) @ZeeshanTamboli
+- &#8203;<!-- 09 -->[Menu] Fix context menu open position (#32661) @oliviertassinari
+
+### `@mui/system@5.8.0`
+
+- &#8203;<!-- 05 -->[system] Add `Container` component and `createContainer` factory (#32263) @mnajdova
+
+### `@mui/base@5.0.0-alpha.81`
+
+- &#8203;<!-- 15 -->[InputUnstyled] Support callbacks in componentsProps (#32271) @michaldudak
+- &#8203;<!-- 14 -->[InputUnstyled] Define ownerState and slot props' types (#32491) @michaldudak
+- &#8203;<!-- 08 -->[MenuUnstyled] Demos improvements (#32714) @michaldudak
+- &#8203;<!-- 07 -->[OptionUnstyled] Define ownerState and slot props' types (#32717) @michaldudak
+
+### `@mui/joy@5.0.0-alpha.28`
+
+- &#8203;<!-- 13 -->[Joy] Add Badge doc (#32790) @siriwatknp
+- &#8203;<!-- 12 -->[Joy] Add global variant feature page (#32695) @siriwatknp
+- &#8203;<!-- 11 -->[Joy] Add avatar page (#32711) @siriwatknp
+
+### `@mui/codemod@5.8.0`
+
+- &#8203;<!-- 33 -->[codemod] Add jss to tss-react codemod (#31802) @ryancogswell
+
+### Docs
+
+- &#8203;<!-- 34 -->[blog] Add release post for MUI X Premium (#32720) @joserodolfofreitas
+- &#8203;<!-- 29 -->[docs] Fix wrong code snippet for overriding styles in theme with a callback value (#32781) @ZeeshanTamboli
+- &#8203;<!-- 28 -->[docs] Update Crowdin logo (#32782) @andrii-bodnar
+- &#8203;<!-- 27 -->[docs] Improve callouts design (#32709) @danilo-leal
+- &#8203;<!-- 26 -->[docs] Revise the "Understanding MUI packages" article (#32382) @danilo-leal
+- &#8203;<!-- 25 -->[docs] Fix link to the material icons (#32771) @oliviertassinari
+- &#8203;<!-- 24 -->[docs] Add notification for Premium release blog post (#32728) @joserodolfofreitas
+- &#8203;<!-- 23 -->[docs] Base Portal style revisions and final review (#32157) @samuelsycamore
+- &#8203;<!-- 22 -->[docs] Add joy to docs package.json (#32744) @siriwatknp
+- &#8203;<!-- 21 -->[docs] Fix TOC-related styles not being applied when disableAd=true (#32733) @cherniavskii
+- &#8203;<!-- 20 -->[docs] Add TypeScript guide on the polymorphic components (#32168) @mnajdova
+- &#8203;<!-- 19 -->[docs] Fix warning mode pass to React.Fragment (#32729) @siriwatknp
+- &#8203;<!-- 18 -->[docs] Revise Showcase copy for clarity + audit appList (#31946) @samuelsycamore
+- &#8203;<!-- 17 -->[examples] Update remix example's tsconfig with required values (#32723) @michaldudak
+- &#8203;<!-- 16 -->[examples] Update to use React 18's createRoot (#32506) @mnajdova
+- &#8203;<!-- 10 -->[l10n] Fix typos and translations on arSD and arEG locales (#31848) @shadigaafar
+- &#8203;<!-- 04 -->[website] Improve communication about MUI X components that are still wip (#32708) @danilo-leal
+- &#8203;<!-- 03 -->[website] Remove scrollbar on x-axis (#32291) @MrHBS
+- &#8203;<!-- 02 -->[website] Update the pricing page for the MUI X premium plan release (#32458) @joserodolfofreitas
+- &#8203;<!-- 01 -->[website] Update sponsors (#32725) @oliviertassinari
+
+### Core
+
+- &#8203;<!-- 32 -->[core] Enabled Renovate's lockfile maintenance (#32635) @michaldudak
+- &#8203;<!-- 31 -->[core] Extract `MuiPage` interface to separate file (#32715) @cherniavskii
+- &#8203;<!-- 30 -->[core] Remove unnecessary `spacing` parameter from `createMixins` method (#32690) @ZeeshanTamboli
+- &#8203;<!-- 06 -->[private-classnames] Remove package and move everything to utils (#32758) @mnajdova
+
+All contributors of this release in alphabetical order: @andrii-bodnar, @cherniavskii, @danilo-leal, @emlai, @joserodolfofreitas, @michaldudak, @mnajdova, @MrHBS, @oliviertassinari, @ryancogswell, @samuelsycamore, @shadigaafar, @siriwatknp, @ZeeshanTamboli
+
 ## 5.7.0
 
 <!-- generated comparing v5.6.4..master -->

package/ClassNameGenerator/ClassNameGenerator.d.ts

@@ -0,0 +1,6 @@
+declare const ClassNameGenerator: {
+    configure(generator: (componentName: string) => string): void;
+    generate(componentName: string): string;
+    reset(): void;
+};
+export default ClassNameGenerator;

package/ClassNameGenerator/ClassNameGenerator.js

@@ -0,0 +1,30 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+const defaultGenerator = componentName => componentName;
+
+const createClassNameGenerator = () => {
+  let generate = defaultGenerator;
+  return {
+    configure(generator) {
+      generate = generator;
+    },
+
+    generate(componentName) {
+      return generate(componentName);
+    },
+
+    reset() {
+      generate = defaultGenerator;
+    }
+
+  };
+};
+
+const ClassNameGenerator = createClassNameGenerator();
+var _default = ClassNameGenerator;
+exports.default = _default;

package/ClassNameGenerator/index.d.ts

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

package/ClassNameGenerator/index.js

@@ -0,0 +1,15 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "default", {
+  enumerable: true,
+  get: function () {
+    return _ClassNameGenerator.default;
+  }
+});
+
+var _ClassNameGenerator = _interopRequireDefault(require("./ClassNameGenerator"));

package/ClassNameGenerator/package.json

@@ -0,0 +1,6 @@
+{
+  "sideEffects": false,
+  "module": "../esm/ClassNameGenerator/index.js",
+  "main": "./index.js",
+  "types": "./index.d.ts"
+}

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/composeClasses/composeClasses.d.ts

@@ -0,0 +1 @@
+export default function composeClasses<ClassKey extends string>(slots: Record<ClassKey, ReadonlyArray<string | false | undefined | null>>, getUtilityClass: (slot: string) => string, classes: Record<string, string> | undefined): Record<ClassKey, string>;

package/composeClasses/composeClasses.js

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = composeClasses;
+
+function composeClasses(slots, getUtilityClass, classes) {
+  const output = {};
+  Object.keys(slots).forEach( // `Objet.keys(slots)` can't be wider than `T` because we infer `T` from `slots`.
+  // @ts-expect-error https://github.com/microsoft/TypeScript/pull/12253#issuecomment-263132208
+  slot => {
+    output[slot] = slots[slot].reduce((acc, key) => {
+      if (key) {
+        if (classes && classes[key]) {
+          acc.push(classes[key]);
+        }
+
+        acc.push(getUtilityClass(key));
+      }
+
+      return acc;
+    }, []).join(' ');
+  });
+  return output;
+}

package/composeClasses/index.d.ts

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

package/composeClasses/index.js

@@ -0,0 +1,15 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "default", {
+  enumerable: true,
+  get: function () {
+    return _composeClasses.default;
+  }
+});
+
+var _composeClasses = _interopRequireDefault(require("./composeClasses"));

package/composeClasses/package.json

@@ -0,0 +1,6 @@
+{
+  "sideEffects": false,
+  "module": "../esm/composeClasses/index.js",
+  "main": "./index.js",
+  "types": "./index.d.ts"
+}

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/esm/ClassNameGenerator/ClassNameGenerator.js

@@ -0,0 +1,22 @@
+const defaultGenerator = componentName => componentName;
+
+const createClassNameGenerator = () => {
+  let generate = defaultGenerator;
+  return {
+    configure(generator) {
+      generate = generator;
+    },
+
+    generate(componentName) {
+      return generate(componentName);
+    },
+
+    reset() {
+      generate = defaultGenerator;
+    }
+
+  };
+};
+
+const ClassNameGenerator = createClassNameGenerator();
+export default ClassNameGenerator;

package/esm/ClassNameGenerator/index.js

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

package/esm/composeClasses/composeClasses.js

@@ -0,0 +1,19 @@
+export default function composeClasses(slots, getUtilityClass, classes) {
+  const output = {};
+  Object.keys(slots).forEach( // `Objet.keys(slots)` can't be wider than `T` because we infer `T` from `slots`.
+  // @ts-expect-error https://github.com/microsoft/TypeScript/pull/12253#issuecomment-263132208
+  slot => {
+    output[slot] = slots[slot].reduce((acc, key) => {
+      if (key) {
+        if (classes && classes[key]) {
+          acc.push(classes[key]);
+        }
+
+        acc.push(getUtilityClass(key));
+      }
+
+      return acc;
+    }, []).join(' ');
+  });
+  return output;
+}

package/esm/composeClasses/index.js

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

package/esm/generateUtilityClass/generateUtilityClass.js

@@ -0,0 +1,17 @@
+import ClassNameGenerator from '../ClassNameGenerator';
+const globalStateClassesMapping = {
+  active: 'Mui-active',
+  checked: 'Mui-checked',
+  completed: 'Mui-completed',
+  disabled: 'Mui-disabled',
+  error: 'Mui-error',
+  expanded: 'Mui-expanded',
+  focused: 'Mui-focused',
+  focusVisible: 'Mui-focusVisible',
+  required: 'Mui-required',
+  selected: 'Mui-selected'
+};
+export default function generateUtilityClass(componentName, slot) {
+  const globalStateClass = globalStateClassesMapping[slot];
+  return globalStateClass || `${ClassNameGenerator.generate(componentName)}-${slot}`;
+}

package/esm/generateUtilityClass/index.js

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

package/esm/generateUtilityClasses/generateUtilityClasses.js

@@ -0,0 +1,8 @@
+import generateUtilityClass from '../generateUtilityClass';
+export default function generateUtilityClasses(componentName, slots) {
+  const result = {};
+  slots.forEach(slot => {
+    result[slot] = generateUtilityClass(componentName, slot);
+  });
+  return result;
+}

package/esm/generateUtilityClasses/index.js

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

package/esm/index.js

@@ -30,4 +30,9 @@ export { detectScrollType as unstable_detectScrollType, getNormalizedScrollLeft
 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 internal_resolveProps } from './resolveProps';
+export { default as unstable_composeClasses } from './composeClasses';
+export { default as unstable_generateUtilityClass } from './generateUtilityClass';
+export * from './generateUtilityClass';
+export { default as unstable_generateUtilityClasses } from './generateUtilityClasses';
+export { default as unstable_ClassNameGenerator } from './ClassNameGenerator';

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/generateUtilityClass/generateUtilityClass.d.ts

@@ -0,0 +1,2 @@
+export declare type GlobalStateSlot = 'active' | 'checked' | 'completed' | 'disabled' | 'error' | 'expanded' | 'focused' | 'focusVisible' | 'required' | 'selected';
+export default function generateUtilityClass(componentName: string, slot: string): string;

package/generateUtilityClass/generateUtilityClass.js

@@ -0,0 +1,28 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = generateUtilityClass;
+
+var _ClassNameGenerator = _interopRequireDefault(require("../ClassNameGenerator"));
+
+const globalStateClassesMapping = {
+  active: 'Mui-active',
+  checked: 'Mui-checked',
+  completed: 'Mui-completed',
+  disabled: 'Mui-disabled',
+  error: 'Mui-error',
+  expanded: 'Mui-expanded',
+  focused: 'Mui-focused',
+  focusVisible: 'Mui-focusVisible',
+  required: 'Mui-required',
+  selected: 'Mui-selected'
+};
+
+function generateUtilityClass(componentName, slot) {
+  const globalStateClass = globalStateClassesMapping[slot];
+  return globalStateClass || `${_ClassNameGenerator.default.generate(componentName)}-${slot}`;
+}

package/generateUtilityClass/index.d.ts

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

package/generateUtilityClass/index.js

@@ -0,0 +1,30 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _exportNames = {};
+Object.defineProperty(exports, "default", {
+  enumerable: true,
+  get: function () {
+    return _generateUtilityClass.default;
+  }
+});
+
+var _generateUtilityClass = _interopRequireWildcard(require("./generateUtilityClass"));
+
+Object.keys(_generateUtilityClass).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _generateUtilityClass[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _generateUtilityClass[key];
+    }
+  });
+});
+
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }

package/generateUtilityClass/package.json

@@ -0,0 +1,6 @@
+{
+  "sideEffects": false,
+  "module": "../esm/generateUtilityClass/index.js",
+  "main": "./index.js",
+  "types": "./index.d.ts"
+}

package/generateUtilityClasses/generateUtilityClasses.d.ts

@@ -0,0 +1 @@
+export default function generateUtilityClasses<T extends string>(componentName: string, slots: T[]): Record<T, string>;

package/generateUtilityClasses/generateUtilityClasses.js

@@ -0,0 +1,18 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = generateUtilityClasses;
+
+var _generateUtilityClass = _interopRequireDefault(require("../generateUtilityClass"));
+
+function generateUtilityClasses(componentName, slots) {
+  const result = {};
+  slots.forEach(slot => {
+    result[slot] = (0, _generateUtilityClass.default)(componentName, slot);
+  });
+  return result;
+}

package/generateUtilityClasses/index.d.ts

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

package/generateUtilityClasses/index.js

@@ -0,0 +1,15 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "default", {
+  enumerable: true,
+  get: function () {
+    return _generateUtilityClasses.default;
+  }
+});
+
+var _generateUtilityClasses = _interopRequireDefault(require("./generateUtilityClasses"));

package/generateUtilityClasses/package.json

@@ -0,0 +1,6 @@
+{
+  "sideEffects": false,
+  "module": "../esm/generateUtilityClasses/index.js",
+  "main": "./index.js",
+  "types": "./index.d.ts"
+}

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,38 @@
-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';
+export { default as unstable_composeClasses } from './composeClasses';
+export { default as unstable_generateUtilityClass } from './generateUtilityClass';
+export * from './generateUtilityClass';
+export { default as unstable_generateUtilityClasses } from './generateUtilityClasses';
+export { default as unstable_ClassNameGenerator } from './ClassNameGenerator';

package/index.js

@@ -1,4 +1,4 @@
-/** @license MUI v5.7.0
+/** @license MUI v5.8.0
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
@@ -10,6 +10,46 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+var _exportNames = {
+  chainPropTypes: true,
+  deepmerge: true,
+  isPlainObject: true,
+  elementAcceptingRef: true,
+  elementTypeAcceptingRef: true,
+  exactProp: true,
+  formatMuiErrorMessage: true,
+  getDisplayName: true,
+  HTMLElementType: true,
+  ponyfillGlobal: true,
+  refType: true,
+  unstable_capitalize: true,
+  unstable_createChainedFunction: true,
+  unstable_debounce: true,
+  unstable_deprecatedPropType: true,
+  unstable_isMuiElement: true,
+  unstable_ownerDocument: true,
+  unstable_ownerWindow: true,
+  unstable_requirePropFactory: true,
+  unstable_setRef: true,
+  unstable_useEnhancedEffect: true,
+  unstable_useId: true,
+  unstable_unsupportedProp: true,
+  unstable_useControlled: true,
+  unstable_useEventCallback: true,
+  unstable_useForkRef: true,
+  unstable_useIsFocusVisible: true,
+  unstable_getScrollbarSize: true,
+  unstable_detectScrollType: true,
+  unstable_getNormalizedScrollLeft: true,
+  usePreviousProps: true,
+  visuallyHidden: true,
+  integerPropType: true,
+  internal_resolveProps: true,
+  unstable_composeClasses: true,
+  unstable_generateUtilityClass: true,
+  unstable_generateUtilityClasses: true,
+  unstable_ClassNameGenerator: true
+};
 Object.defineProperty(exports, "HTMLElementType", {
   enumerable: true,
   get: function () {
@@ -88,12 +128,24 @@ Object.defineProperty(exports, "refType", {
     return _refType.default;
   }
 });
+Object.defineProperty(exports, "unstable_ClassNameGenerator", {
+  enumerable: true,
+  get: function () {
+    return _ClassNameGenerator.default;
+  }
+});
 Object.defineProperty(exports, "unstable_capitalize", {
   enumerable: true,
   get: function () {
     return _capitalize.default;
   }
 });
+Object.defineProperty(exports, "unstable_composeClasses", {
+  enumerable: true,
+  get: function () {
+    return _composeClasses.default;
+  }
+});
 Object.defineProperty(exports, "unstable_createChainedFunction", {
   enumerable: true,
   get: function () {
@@ -118,6 +170,18 @@ Object.defineProperty(exports, "unstable_detectScrollType", {
     return _scrollLeft.detectScrollType;
   }
 });
+Object.defineProperty(exports, "unstable_generateUtilityClass", {
+  enumerable: true,
+  get: function () {
+    return _generateUtilityClass.default;
+  }
+});
+Object.defineProperty(exports, "unstable_generateUtilityClasses", {
+  enumerable: true,
+  get: function () {
+    return _generateUtilityClasses.default;
+  }
+});
 Object.defineProperty(exports, "unstable_getNormalizedScrollLeft", {
   enumerable: true,
   get: function () {
@@ -279,6 +343,26 @@ var _integerPropType = _interopRequireDefault(require("./integerPropType"));
 
 var _resolveProps = _interopRequireDefault(require("./resolveProps"));
 
+var _composeClasses = _interopRequireDefault(require("./composeClasses"));
+
+var _generateUtilityClass = _interopRequireWildcard(require("./generateUtilityClass"));
+
+Object.keys(_generateUtilityClass).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _generateUtilityClass[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _generateUtilityClass[key];
+    }
+  });
+});
+
+var _generateUtilityClasses = _interopRequireDefault(require("./generateUtilityClasses"));
+
+var _ClassNameGenerator = _interopRequireDefault(require("./ClassNameGenerator"));
+
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
 
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }

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/ClassNameGenerator/ClassNameGenerator.js

@@ -0,0 +1,21 @@
+var defaultGenerator = function defaultGenerator(componentName) {
+  return componentName;
+};
+
+var createClassNameGenerator = function createClassNameGenerator() {
+  var _generate = defaultGenerator;
+  return {
+    configure: function configure(generator) {
+      _generate = generator;
+    },
+    generate: function generate(componentName) {
+      return _generate(componentName);
+    },
+    reset: function reset() {
+      _generate = defaultGenerator;
+    }
+  };
+};
+
+var ClassNameGenerator = createClassNameGenerator();
+export default ClassNameGenerator;

package/legacy/ClassNameGenerator/index.js

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

package/legacy/composeClasses/composeClasses.js

@@ -0,0 +1,19 @@
+export default function composeClasses(slots, getUtilityClass, classes) {
+  var output = {};
+  Object.keys(slots).forEach( // `Objet.keys(slots)` can't be wider than `T` because we infer `T` from `slots`.
+  // @ts-expect-error https://github.com/microsoft/TypeScript/pull/12253#issuecomment-263132208
+  function (slot) {
+    output[slot] = slots[slot].reduce(function (acc, key) {
+      if (key) {
+        if (classes && classes[key]) {
+          acc.push(classes[key]);
+        }
+
+        acc.push(getUtilityClass(key));
+      }
+
+      return acc;
+    }, []).join(' ');
+  });
+  return output;
+}

package/legacy/composeClasses/index.js

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

package/legacy/generateUtilityClass/generateUtilityClass.js

@@ -0,0 +1,17 @@
+import ClassNameGenerator from '../ClassNameGenerator';
+var globalStateClassesMapping = {
+  active: 'Mui-active',
+  checked: 'Mui-checked',
+  completed: 'Mui-completed',
+  disabled: 'Mui-disabled',
+  error: 'Mui-error',
+  expanded: 'Mui-expanded',
+  focused: 'Mui-focused',
+  focusVisible: 'Mui-focusVisible',
+  required: 'Mui-required',
+  selected: 'Mui-selected'
+};
+export default function generateUtilityClass(componentName, slot) {
+  var globalStateClass = globalStateClassesMapping[slot];
+  return globalStateClass || "".concat(ClassNameGenerator.generate(componentName), "-").concat(slot);
+}

package/legacy/generateUtilityClass/index.js

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

package/legacy/generateUtilityClasses/generateUtilityClasses.js

@@ -0,0 +1,8 @@
+import generateUtilityClass from '../generateUtilityClass';
+export default function generateUtilityClasses(componentName, slots) {
+  var result = {};
+  slots.forEach(function (slot) {
+    result[slot] = generateUtilityClass(componentName, slot);
+  });
+  return result;
+}

package/legacy/generateUtilityClasses/index.js

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

package/legacy/index.js

@@ -1,4 +1,4 @@
-/** @license MUI v5.7.0
+/** @license MUI v5.8.0
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
@@ -35,4 +35,9 @@ export { detectScrollType as unstable_detectScrollType, getNormalizedScrollLeft
 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 internal_resolveProps } from './resolveProps';
+export { default as unstable_composeClasses } from './composeClasses';
+export { default as unstable_generateUtilityClass } from './generateUtilityClass';
+export * from './generateUtilityClass';
+export { default as unstable_generateUtilityClasses } from './generateUtilityClasses';
+export { default as unstable_ClassNameGenerator } from './ClassNameGenerator';

package/modern/ClassNameGenerator/ClassNameGenerator.js

@@ -0,0 +1,22 @@
+const defaultGenerator = componentName => componentName;
+
+const createClassNameGenerator = () => {
+  let generate = defaultGenerator;
+  return {
+    configure(generator) {
+      generate = generator;
+    },
+
+    generate(componentName) {
+      return generate(componentName);
+    },
+
+    reset() {
+      generate = defaultGenerator;
+    }
+
+  };
+};
+
+const ClassNameGenerator = createClassNameGenerator();
+export default ClassNameGenerator;

package/modern/ClassNameGenerator/index.js

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

package/modern/composeClasses/composeClasses.js

@@ -0,0 +1,19 @@
+export default function composeClasses(slots, getUtilityClass, classes) {
+  const output = {};
+  Object.keys(slots).forEach( // `Objet.keys(slots)` can't be wider than `T` because we infer `T` from `slots`.
+  // @ts-expect-error https://github.com/microsoft/TypeScript/pull/12253#issuecomment-263132208
+  slot => {
+    output[slot] = slots[slot].reduce((acc, key) => {
+      if (key) {
+        if (classes && classes[key]) {
+          acc.push(classes[key]);
+        }
+
+        acc.push(getUtilityClass(key));
+      }
+
+      return acc;
+    }, []).join(' ');
+  });
+  return output;
+}

package/modern/composeClasses/index.js

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

package/modern/generateUtilityClass/generateUtilityClass.js

@@ -0,0 +1,17 @@
+import ClassNameGenerator from '../ClassNameGenerator';
+const globalStateClassesMapping = {
+  active: 'Mui-active',
+  checked: 'Mui-checked',
+  completed: 'Mui-completed',
+  disabled: 'Mui-disabled',
+  error: 'Mui-error',
+  expanded: 'Mui-expanded',
+  focused: 'Mui-focused',
+  focusVisible: 'Mui-focusVisible',
+  required: 'Mui-required',
+  selected: 'Mui-selected'
+};
+export default function generateUtilityClass(componentName, slot) {
+  const globalStateClass = globalStateClassesMapping[slot];
+  return globalStateClass || `${ClassNameGenerator.generate(componentName)}-${slot}`;
+}

package/modern/generateUtilityClass/index.js

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

package/modern/generateUtilityClasses/generateUtilityClasses.js

@@ -0,0 +1,8 @@
+import generateUtilityClass from '../generateUtilityClass';
+export default function generateUtilityClasses(componentName, slots) {
+  const result = {};
+  slots.forEach(slot => {
+    result[slot] = generateUtilityClass(componentName, slot);
+  });
+  return result;
+}

package/modern/generateUtilityClasses/index.js

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

package/modern/index.js

@@ -1,4 +1,4 @@
-/** @license MUI v5.7.0
+/** @license MUI v5.8.0
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
@@ -35,4 +35,9 @@ export { detectScrollType as unstable_detectScrollType, getNormalizedScrollLeft
 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 internal_resolveProps } from './resolveProps';
+export { default as unstable_composeClasses } from './composeClasses';
+export { default as unstable_generateUtilityClass } from './generateUtilityClass';
+export * from './generateUtilityClass';
+export { default as unstable_generateUtilityClasses } from './generateUtilityClasses';
+export { default as unstable_ClassNameGenerator } from './ClassNameGenerator';

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.7.0",
+  "version": "5.8.0",
   "private": false,
   "author": "MUI Team",
   "description": "Utility functions for React components.",

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;