@mui/utils 5.15.4 → 5.15.5

package/CHANGELOG.md

@@ -1,5 +1,103 @@
 # [Versions](https://mui.com/versions/)
 
+## v5.15.5
+
+<!-- generated comparing v5.15.4..master -->
+
+_Jan 17, 2024_
+
+A big thanks to the 18 contributors who made this release possible. Here are some highlights ✨:
+
+- Base UI's CSS class prefix is now `base-` (#40205) @michaldudak
+- Bug fixes, and a lot of improvements to code and docs infra
+
+### `@mui/material@5.15.5`
+
+- &#8203;<!-- 42 -->[Accordion] Deprecate \*Props props and classes for v6 (#40418) @DiegoAndai
+- &#8203;<!-- 41 -->[Alert] Update TypeScript types to allow color override types to be added to `iconMapping` and `severity` props (#40551) @2metres
+- &#8203;<!-- 27 -->[Dialog] Remove deprecated onBackdropClick from Dialog tests (#40505) @sai6855
+- &#8203;<!-- 26 -->[Divider] Deprecate props and classes for v6 (#40563) @sai6855
+
+### `@mui/material-next@6.0.0-alpha.118`
+
+- &#8203;<!-- 36 -->[ButtonGroup] Apply MD3 style to `ButtonGroup` (#40124) @lhilgert9
+
+### `@mui/base@5.0.0-beta.32`
+
+#### Breaking changes
+
+- &#8203;<!-- 40 -->Change the CSS class prefix to `base-` (#40205) @michaldudak
+
+The class prefix of Base UI components have been changed from `Mui-` to `base-`. This only affects codebases that uses class names verbatim, i.e. not exposed by JS objects such as `buttonClasses`, but as plain strings or in CSS stylesheets (`.MuiButton.root`)
+
+To adapt your code to the new pattern:
+
+- replace all occurrences of the regex `.Mui([A-Z][A-Za-z]*)-` with `.base-$1-` (so `MuiButton-root` becomes `base-Button-root`, etc.),
+- replace all occurrences of the regex `.Mui-([a-z]*)` with `.base--$1` (so `Mui-disabled` becomes `base--disabled`, etc.).
+
+#### Changes
+
+- &#8203;<!-- 39 -->[Select] Fix screen-reader CSS to avoid body scrollbar (#40599) @brijeshb42
+- &#8203;<!-- 38 -->[Switch] Add border-box to demos (#40638) @zanivan
+
+### `@mui/joy@5.0.0-beta.23`
+
+- &#8203;<!-- 11 -->[ModalDialog] Fix ModalDialog layout prop override (#40512) @maakcode
+- &#8203;<!-- 10 -->[RadioGroup] Allow zero number as a value (#40344) @aacevski
+
+### `@mui/codemod@5.15.5`
+
+- &#8203;<!-- 31 -->Allow `json` files to be transformed (#40536) @ZeeshanTamboli
+
+### `@mui/lab@5.0.0-alpha.161`
+
+- &#8203;<!-- 09 -->Update `@mui/material` peer dependency version (#40528) @ZeeshanTamboli
+
+### `@mui/material-nextjs@5.15.5`
+
+- &#8203;<!-- 08 -->Fix release script (#40519) @petrovmiroslav
+- &#8203;<!-- 07 -->Support Nonces in the App Router Provider (#40269) @josh-feldman
+- &#8203;<!-- 06 -->Polish @mui/material-nextjs (#40473) @oliviertassinari
+
+### `@mui/system@5.15.5`
+
+- &#8203;<!-- 05 -->Fix import path for @mui/system in vite apps (#40490) @brijeshb42
+- &#8203;<!-- 02 -->Fix css vars generation and simplify the code (#40530) @siriwatknp
+- &#8203;<!-- 01 -->Identify zero runtime styled path (#40555) @brijeshb42
+
+### Docs
+
+- &#8203;<!-- 35 -->[joy-ui][Card] Fix text alignment in horizontal aligned card demo (#40562) @ZeeshanTamboli
+- &#8203;<!-- 25 -->Improve instructions about peer dependencies (#40621) @danilo-leal
+- &#8203;<!-- 24 -->Solve page description length @oliviertassinari
+- &#8203;<!-- 23 -->Fix MUI Treasury links (#40561) @siriwatknp
+- &#8203;<!-- 17 -->[material-ui] Update <ListItem button/> to ListItemButton in demos (#40564) @sai6855
+- &#8203;<!-- 16 -->[material-ui] Revise the Snackbar page (#39298) @danilo-leal
+- &#8203;<!-- 15 -->[material-ui] Sharpen Material 3 copy on demo pages (#40546) @samuelsycamore
+- &#8203;<!-- 14 -->[material-ui] Fix typo on Next.js integration guide (#40538) @zanivan
+- &#8203;<!-- 13 -->[material-ui][Snackbar] Remove unused `State` interface from Consecutive Snackbars demo (#40410)
+  @zinoroman
+- &#8203;<!-- 12 -->[website] Resolve broken links reported by `docs:link-check` (#40547) @samuelsycamore
+
+### Core
+
+- &#8203;<!-- 37 -->[blog] Fix 404 link to MUI Treasury @oliviertassinari
+- &#8203;<!-- 34 -->[code-infra] Add `run` command to deploy docs (#40513) @siriwatknp
+- &#8203;<!-- 32 -->[core] Update the lockfile (#40628) @michaldudak
+- &#8203;<!-- 31 -->[core] Remove dead code and follow standard @oliviertassinari
+- &#8203;<!-- 30 -->[core] Simplify server detection (#40471) @oliviertassinari
+- &#8203;<!-- 29 -->[core] Sync playwright cache between MUI X and Material UI (#40475) @oliviertassinari
+- &#8203;<!-- 28 -->[dependencies] Bump tough-cookie (#40437) @michaldudak
+- &#8203;<!-- 22 -->[docs-infra] Enforce brand name rules (#40525) @oliviertassinari
+- &#8203;<!-- 21 -->[docs-infra] Minimize ad layout shift on mobile (#40582) @oliviertassinari
+- &#8203;<!-- 20 -->[docs-infra] Improve API page deprecation info (#40440) @DiegoAndai
+- &#8203;<!-- 19 -->[docs-infra] Remove old tocs banners (#40537) @oliviertassinari
+- &#8203;<!-- 18 -->[docs-infra] Remove dead code aria-label sponsors (#40526) @oliviertassinari
+- &#8203;<!-- 04 -->[utils] Centralize clamp implementation in utils (#40267) @Kamino0
+- &#8203;<!-- 03 -->[website] Polish the Base UI page demos (#40504) @danilo-leal
+
+All contributors of this release in alphabetical order: @2metres, @aacevski, @brijeshb42, @danilo-leal, @DiegoAndai, @josh-feldman, @Kamino0, @lhilgert9, @maakcode, @michaldudak, @oliviertassinari, @petrovmiroslav, @sai6855, @samuelsycamore, @siriwatknp, @zanivan, @ZeeshanTamboli, @zinoroman
+
 ## 5.15.4
 
 <!-- generated comparing v5.15.3..master -->

package/clamp/clamp.d.ts

@@ -0,0 +1,2 @@
+declare function clamp(val: number, min?: number, max?: number): number;
+export default clamp;

package/clamp/clamp.js

@@ -0,0 +1,10 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+function clamp(val, min = Number.MIN_SAFE_INTEGER, max = Number.MAX_SAFE_INTEGER) {
+  return Math.max(min, Math.min(val, max));
+}
+var _default = exports.default = clamp;

package/clamp/index.d.ts

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

package/clamp/index.js

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

package/clamp/package.json

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

package/esm/clamp/clamp.js

@@ -0,0 +1,4 @@
+function clamp(val, min = Number.MIN_SAFE_INTEGER, max = Number.MAX_SAFE_INTEGER) {
+  return Math.max(min, Math.min(val, max));
+}
+export default clamp;

package/esm/clamp/index.js

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

package/esm/generateUtilityClass/generateUtilityClass.js

@@ -1,9 +1,5 @@
 import ClassNameGenerator from '../ClassNameGenerator';
-
-// If GlobalStateSlot is changed, GLOBAL_STATE_CLASSES in
-// \packages\api-docs-builder\utils\parseSlotsAndClasses.ts must be updated accordingly.
-
-const globalStateClassesMapping = {
+export const globalStateClasses = {
   active: 'active',
   checked: 'checked',
   completed: 'completed',
@@ -18,6 +14,9 @@ const globalStateClassesMapping = {
   selected: 'selected'
 };
 export default function generateUtilityClass(componentName, slot, globalStatePrefix = 'Mui') {
-  const globalStateClass = globalStateClassesMapping[slot];
+  const globalStateClass = globalStateClasses[slot];
   return globalStateClass ? `${globalStatePrefix}-${globalStateClass}` : `${ClassNameGenerator.generate(componentName)}-${slot}`;
+}
+export function isGlobalState(slot) {
+  return globalStateClasses[slot] !== undefined;
 }

package/esm/index.js

@@ -36,6 +36,8 @@ 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 { isGlobalState as unstable_isGlobalState } from './generateUtilityClass';
 export * from './generateUtilityClass';
 export { default as unstable_generateUtilityClasses } from './generateUtilityClasses';
-export { default as unstable_ClassNameGenerator } from './ClassNameGenerator';
+export { default as unstable_ClassNameGenerator } from './ClassNameGenerator';
+export { default as clamp } from './clamp';

package/generateUtilityClass/generateUtilityClass.d.ts

@@ -1,2 +1,17 @@
-export type GlobalStateSlot = 'active' | 'checked' | 'completed' | 'disabled' | 'error' | 'expanded' | 'focused' | 'focusVisible' | 'open' | 'readOnly' | 'required' | 'selected';
+export type GlobalStateSlot = keyof typeof globalStateClasses;
+export declare const globalStateClasses: {
+    active: string;
+    checked: string;
+    completed: string;
+    disabled: string;
+    error: string;
+    expanded: string;
+    focused: string;
+    focusVisible: string;
+    open: string;
+    readOnly: string;
+    required: string;
+    selected: string;
+};
 export default function generateUtilityClass(componentName: string, slot: string, globalStatePrefix?: string): string;
+export declare function isGlobalState(slot: string): boolean;

package/generateUtilityClass/generateUtilityClass.js

@@ -5,11 +5,10 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = generateUtilityClass;
+exports.globalStateClasses = void 0;
+exports.isGlobalState = isGlobalState;
 var _ClassNameGenerator = _interopRequireDefault(require("../ClassNameGenerator"));
-// If GlobalStateSlot is changed, GLOBAL_STATE_CLASSES in
-// \packages\api-docs-builder\utils\parseSlotsAndClasses.ts must be updated accordingly.
-
-const globalStateClassesMapping = {
+const globalStateClasses = exports.globalStateClasses = {
   active: 'active',
   checked: 'checked',
   completed: 'completed',
@@ -24,6 +23,9 @@ const globalStateClassesMapping = {
   selected: 'selected'
 };
 function generateUtilityClass(componentName, slot, globalStatePrefix = 'Mui') {
-  const globalStateClass = globalStateClassesMapping[slot];
+  const globalStateClass = globalStateClasses[slot];
   return globalStateClass ? `${globalStatePrefix}-${globalStateClass}` : `${_ClassNameGenerator.default.generate(componentName)}-${slot}`;
+}
+function isGlobalState(slot) {
+  return globalStateClasses[slot] !== undefined;
 }

package/index.d.ts

@@ -34,6 +34,8 @@ 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 { isGlobalState as unstable_isGlobalState } from './generateUtilityClass';
 export * from './generateUtilityClass';
 export { default as unstable_generateUtilityClasses } from './generateUtilityClasses';
 export { default as unstable_ClassNameGenerator } from './ClassNameGenerator';
+export { default as clamp } from './clamp';

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/utils v5.15.4
+ * @mui/utils v5.15.5
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the
@@ -50,8 +50,10 @@ var _exportNames = {
   internal_resolveProps: true,
   unstable_composeClasses: true,
   unstable_generateUtilityClass: true,
+  unstable_isGlobalState: true,
   unstable_generateUtilityClasses: true,
-  unstable_ClassNameGenerator: true
+  unstable_ClassNameGenerator: true,
+  clamp: true
 };
 Object.defineProperty(exports, "HTMLElementType", {
   enumerable: true,
@@ -65,6 +67,12 @@ Object.defineProperty(exports, "chainPropTypes", {
     return _chainPropTypes.default;
   }
 });
+Object.defineProperty(exports, "clamp", {
+  enumerable: true,
+  get: function () {
+    return _clamp.default;
+  }
+});
 Object.defineProperty(exports, "deepmerge", {
   enumerable: true,
   get: function () {
@@ -203,6 +211,12 @@ Object.defineProperty(exports, "unstable_getScrollbarSize", {
     return _getScrollbarSize.default;
   }
 });
+Object.defineProperty(exports, "unstable_isGlobalState", {
+  enumerable: true,
+  get: function () {
+    return _generateUtilityClass.isGlobalState;
+  }
+});
 Object.defineProperty(exports, "unstable_isMuiElement", {
   enumerable: true,
   get: function () {
@@ -335,5 +349,6 @@ Object.keys(_generateUtilityClass).forEach(function (key) {
 });
 var _generateUtilityClasses = _interopRequireDefault(require("./generateUtilityClasses"));
 var _ClassNameGenerator = _interopRequireDefault(require("./ClassNameGenerator"));
+var _clamp = _interopRequireDefault(require("./clamp"));
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }

package/legacy/clamp/clamp.js

@@ -0,0 +1,6 @@
+function clamp(val) {
+  var min = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : Number.MIN_SAFE_INTEGER;
+  var max = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : Number.MAX_SAFE_INTEGER;
+  return Math.max(min, Math.min(val, max));
+}
+export default clamp;

package/legacy/clamp/index.js

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

package/legacy/generateUtilityClass/generateUtilityClass.js

@@ -1,9 +1,5 @@
 import ClassNameGenerator from '../ClassNameGenerator';
-
-// If GlobalStateSlot is changed, GLOBAL_STATE_CLASSES in
-// \packages\api-docs-builder\utils\parseSlotsAndClasses.ts must be updated accordingly.
-
-var globalStateClassesMapping = {
+export var globalStateClasses = {
   active: 'active',
   checked: 'checked',
   completed: 'completed',
@@ -19,6 +15,9 @@ var globalStateClassesMapping = {
 };
 export default function generateUtilityClass(componentName, slot) {
   var globalStatePrefix = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'Mui';
-  var globalStateClass = globalStateClassesMapping[slot];
+  var globalStateClass = globalStateClasses[slot];
   return globalStateClass ? "".concat(globalStatePrefix, "-").concat(globalStateClass) : "".concat(ClassNameGenerator.generate(componentName), "-").concat(slot);
+}
+export function isGlobalState(slot) {
+  return globalStateClasses[slot] !== undefined;
 }

package/legacy/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/utils v5.15.4
+ * @mui/utils v5.15.5
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the
@@ -43,6 +43,8 @@ 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 { isGlobalState as unstable_isGlobalState } from './generateUtilityClass';
 export * from './generateUtilityClass';
 export { default as unstable_generateUtilityClasses } from './generateUtilityClasses';
-export { default as unstable_ClassNameGenerator } from './ClassNameGenerator';
+export { default as unstable_ClassNameGenerator } from './ClassNameGenerator';
+export { default as clamp } from './clamp';

package/modern/clamp/clamp.js

@@ -0,0 +1,4 @@
+function clamp(val, min = Number.MIN_SAFE_INTEGER, max = Number.MAX_SAFE_INTEGER) {
+  return Math.max(min, Math.min(val, max));
+}
+export default clamp;

package/modern/clamp/index.js

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

package/modern/generateUtilityClass/generateUtilityClass.js

@@ -1,9 +1,5 @@
 import ClassNameGenerator from '../ClassNameGenerator';
-
-// If GlobalStateSlot is changed, GLOBAL_STATE_CLASSES in
-// \packages\api-docs-builder\utils\parseSlotsAndClasses.ts must be updated accordingly.
-
-const globalStateClassesMapping = {
+export const globalStateClasses = {
   active: 'active',
   checked: 'checked',
   completed: 'completed',
@@ -18,6 +14,9 @@ const globalStateClassesMapping = {
   selected: 'selected'
 };
 export default function generateUtilityClass(componentName, slot, globalStatePrefix = 'Mui') {
-  const globalStateClass = globalStateClassesMapping[slot];
+  const globalStateClass = globalStateClasses[slot];
   return globalStateClass ? `${globalStatePrefix}-${globalStateClass}` : `${ClassNameGenerator.generate(componentName)}-${slot}`;
+}
+export function isGlobalState(slot) {
+  return globalStateClasses[slot] !== undefined;
 }

package/modern/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/utils v5.15.4
+ * @mui/utils v5.15.5
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the
@@ -43,6 +43,8 @@ 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 { isGlobalState as unstable_isGlobalState } from './generateUtilityClass';
 export * from './generateUtilityClass';
 export { default as unstable_generateUtilityClasses } from './generateUtilityClasses';
-export { default as unstable_ClassNameGenerator } from './ClassNameGenerator';
+export { default as unstable_ClassNameGenerator } from './ClassNameGenerator';
+export { default as clamp } from './clamp';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/utils",
-  "version": "5.15.4",
+  "version": "5.15.5",
   "private": false,
   "author": "MUI Team",
   "description": "Utility functions for React components.",
@@ -26,7 +26,7 @@
     "url": "https://opencollective.com/mui-org"
   },
   "dependencies": {
-    "@babel/runtime": "^7.23.7",
+    "@babel/runtime": "^7.23.8",
     "@types/prop-types": "^15.7.11",
     "prop-types": "^15.8.1",
     "react-is": "^18.2.0"