diff --git a/docs/data/material/migration/migrating-from-deprecated-apis/migrating-from-deprecated-apis.md b/docs/data/material/migration/migrating-from-deprecated-apis/migrating-from-deprecated-apis.md
index 2fa13df2e1d518..f28287296f0666 100644
--- a/docs/data/material/migration/migrating-from-deprecated-apis/migrating-from-deprecated-apis.md
+++ b/docs/data/material/migration/migrating-from-deprecated-apis/migrating-from-deprecated-apis.md
@@ -56,7 +56,6 @@ Bear in mind that the `.MuiAccordionSummary-gutters` class is applied to the com
```diff
-.MuiAccordionSummary-root .MuiAccordionSummary-contentGutters
+.MuiAccordionSummary-root.MuiAccordionSummary-gutters .MuiAccordionSummary-content
- />
```
```diff
@@ -221,7 +220,7 @@ The Autocomplete's `componentsProps` prop was deprecated in favor of `slotProps`
+ paper: { width: 12 },
+ popper: { width: 14 },
+ popupIndicator: { width: 16 },
- }}
+ }}
/>
```
@@ -240,18 +239,18 @@ The AvatarGroup's `slotProps.additionalAvatar` was deprecated in favor of `slotP
```diff
;
+ >
```
```diff
MuiAvatarGroup: {
defaultProps: {
slotProps: {
-- additionalAvatar: {color: "red"}
-+ surplus: {color: "red"}
+- additionalAvatar: { color: 'red' },
++ surplus: { color: 'red' },
},
},
},
@@ -264,11 +263,11 @@ The AvatarGroup's `componentsProps` was deprecated in favor of `slotProps`:
```diff
;
+ >
```
```diff
@@ -329,7 +328,7 @@ The Badge's `components` prop was deprecated in favor of `slots`:
+ >
```
### componentsProps
@@ -340,7 +339,7 @@ The Badge's `componentsProps` prop was deprecated in favor of `slotProps`:
+ >
```
## Button
@@ -782,7 +781,7 @@ Here's how to migrate:
import { chipClasses } from '@mui/material/Chip';
- MuiChip: {
+ MuiChip: {
styleOverrides: {
root: {
- [`&.${chipClasses.clickableColorPrimary}`]: {
@@ -888,11 +887,10 @@ Here's how to migrate:
- [`& .${chipClasses.deleteIconFilledColorSecondary}`]: {
+ [`&.${chipClasses.filled}.${chipClasses.colorSecondary} > .${chipClasses.deleteIcon}`]: {
color: 'red',
- },
+ },
},
},
- },
-
+ },
```
## CircularProgress
@@ -910,9 +908,9 @@ The CSS classes that composed the `circle` CSS class and `variant` prop values w
Here's how to migrate:
```diff
-- .MuiCircularProgress-circleDeterminate
+-.MuiCircularProgress-circleDeterminate
+-.MuiCircularProgress-circleIndeterminate
+.MuiCircularProgress-determinate > .MuiCircularProgress-circle
-- .MuiCircularProgress-circleIndeterminate
+.MuiCircularProgress-indeterminate > .MuiCircularProgress-circle
```
@@ -929,7 +927,7 @@ Here's how to migrate:
- [`& .${circularProgressClasses.circleIndeterminate}`]: {
+ [`&.${circularProgressClasses.indeterminate} > .${circularProgressClasses.circle}`]: {
color: 'red',
- },
+ },
},
},
},
@@ -1141,7 +1139,7 @@ The Grid's `wrap` prop was deprecated in favor of `flexWrap` MUI System prop:
;
+ >
```
## ImageListItemBar
@@ -1163,13 +1161,13 @@ The CSS classes that composed the following props were deprecated:
Here's how to migrate:
```diff
-- .MuiImageListItemBar-titleWrapBelow
+-.MuiImageListItemBar-titleWrapBelow
+.MuiImageListItemBar-positionBelow > .MuiImageListItemBar-titleWrap
-- .MuiImageListItemBar-titleWrapActionPosLeft
+-.MuiImageListItemBar-titleWrapActionPosLeft
+.MuiImageListItemBar-actionPositionLeft > .MuiImageListItemBar-titleWrap
-- .MuiImageListItemBar-titleWrapActionPosRight
+-.MuiImageListItemBar-titleWrapActionPosRight
+.MuiImageListItemBar-actionPositionRight > .MuiImageListItemBar-titleWrap
-- .MuiImageListItemBar-actionIconActionPosLeft
+-.MuiImageListItemBar-actionIconActionPosLeft
+.MuiImageListItemBar-actionPositionLeft > .MuiImageListItemBar-actionIcon
```
@@ -1216,7 +1214,7 @@ The Modal's `components` prop was deprecated in favor of `slots`:
+ >
```
### componentsProps
@@ -1227,7 +1225,7 @@ The Modal's `componentsProps` prop was deprecated in favor of `slotProps`:
+ >
```
## OutlinedInput
@@ -1408,7 +1406,7 @@ Here's how to migrate:
import { toggleButtonGroupClasses } from '@mui/material/ToggleButtonGroup';
- MuiButtonGroup: {
+ MuiButtonGroup: {
styleOverrides: {
root: {
- [`& .${toggleButtonGroupClasses.groupedHorizontal}`]: {
@@ -1418,9 +1416,10 @@ Here's how to migrate:
- [`& .${toggleButtonGroupClasses.groupedVertical}`]: {
+ [`&.${toggleButtonGroupClasses.vertical} > .${toggleButtonGroupClasses.grouped}`]: {
color: 'red',
- },
+ },
+ },
},
- },
+ },
```
## Tab
@@ -1451,7 +1450,8 @@ Here's how to migrate:
- [`& .${tabClasses.iconWrapper}`]: {
+ [`& .${tabClasses.icon}`]: {
color: 'red',
- },
+ },
+ },
},
},
```
@@ -1471,9 +1471,9 @@ The CSS classes that composed the `direction` prop and `icon` prop were removed.
Here's how to migrate:
```diff
-- .MuiTableSortLabel-iconDirectionDesc
+-.MuiTableSortLabel-iconDirectionDesc
+.MuiTableSortLabel-directionDesc > .MuiTableSortLabel-icon
-- .MuiTableSortLabel-iconDirectionAsc
+-.MuiTableSortLabel-iconDirectionAsc
+.MuiTableSortLabel-directionAsc > .MuiTableSortLabel-icon
```
@@ -1490,7 +1490,7 @@ Here's how to migrate:
- [`& .${tableSortLabelClasses.iconDirectionAsc}`]: {
+ [`&.${tableSortLabelClasses.directionAsc} > .${tableSortLabelClasses.icon}`]: {
color: 'red',
- },
+ },
},
},
},
@@ -1510,18 +1510,18 @@ All of the TextField's slot props (`*Props`) props were deprecated in favor of e
```diff
```
@@ -1615,9 +1615,9 @@ The CSS classes that composed the `line` CSS class and `orientation` prop values
Here's how to migrate:
```diff
-- .MuiStepConnector-lineHorizontal
+-.MuiStepConnector-lineHorizontal
+.MuiStepConnector-horizontal > .MuiStepConnector-line
-- .MuiStepConnector-lineVertical
+-.MuiStepConnector-lineVertical
+.MuiStepConnector-vertical > .MuiStepConnector-line
```
diff --git a/docs/data/material/migration/migrating-to-v6/migrating-to-pigment-css.md b/docs/data/material/migration/migrating-to-v6/migrating-to-pigment-css.md
index a3e87cbb508950..57ea7b1717b201 100644
--- a/docs/data/material/migration/migrating-to-v6/migrating-to-pigment-css.md
+++ b/docs/data/material/migration/migrating-to-v6/migrating-to-pigment-css.md
@@ -6,7 +6,9 @@ Before going through this guide, make sure you have [migrated to Material UI v6
## Introduction
-The default styling engine of Material UI v6 is [Emotion](https://emotion.sh/docs/introduction). It lets you write styles in a CSS-in-JS fashion, which is great for dynamic styles that depend on states and props. However, it has some performance drawbacks when it comes to frequent re-renders because the style recalculation happens on the client-side. It also does not fully support [React Server Components](https://react.dev/reference/rsc/server-components), a new rendering paradigm that renders components ahead of time on the server.
+The default styling engine of Material UI v6 is [Emotion](https://emotion.sh/docs/introduction).
+It lets you write styles in a CSS-in-JS fashion, which is great for dynamic styles that depend on states and props. However, it has some performance drawbacks when it comes to frequent re-renders because the style recalculation happens on the client-side.
+It also does not fully support [React Server Components](https://react.dev/reference/rsc/server-components), a new rendering paradigm that renders components ahead of time on the server.
Pigment CSS aims to solve these problems while keeping the same developer experience of writing styles in a CSS-in-JS fashion.
It can work alongside Emotion to ease the migration process, but it is recommended to fully migrate to Pigment CSS in the end.
@@ -15,7 +17,7 @@ It can work alongside Emotion to ease the migration process, but it is recommend
Pigment CSS can be used with one of the following frameworks:
-- [Next.js App Router](https://nextjs.org/docs/app) with Webpack 5 (Turbo is not supported yet)
+- [Next.js App Router](https://nextjs.org/docs/app) with Webpack v5 (Turbopack is not supported yet)
- [Vite](https://vitejs.dev/)
## Installation
@@ -102,7 +104,7 @@ Finally, import the stylesheet at the top of the layout file.
import type { Metadata } from 'next';
import { Inter } from 'next/font/google';
-+ import '@mui/material-pigment-css/styles.css';
++import '@mui/material-pigment-css/styles.css';
export default function RootLayout(props) {
return (
@@ -155,7 +157,7 @@ Finally, add the Pigment CSS stylesheet to the top of the main file.
```diff title="src/main.(js|tsx)"
import * as React from 'react';
-+ import '@mui/material-pigment-css/styles.css';
++import '@mui/material-pigment-css/styles.css';
import App from './App';
ReactDOM.createRoot(document.getElementById('root')).render(
@@ -171,11 +173,11 @@ Integrating Pigment CSS with Material UI requires you to configure the theme t
Add the following code to your [Next.js](#nextjs) or [Vite](#vite) config file:
```diff
-+ import { extendTheme } from '@mui/material';
++import { extendTheme } from '@mui/material';
-+ const pigmentConfig = {
-+ theme: extendTheme(),
-+ };
++const pigmentConfig = {
++ theme: extendTheme(),
++};
```
If you don't have a custom theme, you are ready to go. Start a development server by running:
@@ -211,6 +213,7 @@ import Card from '@mui/material/Card';
function App() {
const [color, setColor] = useState('#000000');
+
return (
+ ...
+
- )
+ );
}
```
@@ -577,8 +580,8 @@ declare global {
If you are using the `useTheme` hook, replace the import source:
```diff
-- import { useTheme } from '@mui/material/styles';
-+ import { useTheme } from '@mui/material-pigment-css';
+-import { useTheme } from '@mui/material/styles';
++import { useTheme } from '@mui/material-pigment-css';
```
:::info
diff --git a/docs/data/material/migration/migrating-to-v6/migrating-to-v6.md b/docs/data/material/migration/migrating-to-v6/migrating-to-v6.md
index d5e82f71a3a54c..d66a2bcb5c8867 100644
--- a/docs/data/material/migration/migrating-to-v6/migrating-to-v6.md
+++ b/docs/data/material/migration/migrating-to-v6/migrating-to-v6.md
@@ -51,7 +51,7 @@ The exact versions will be pinned on release from the browserslist query: `"> 0.
- Edge 121 (up from 91)
- Firefox 115 (up from 78)
- Safari 15.4 in both macOS and iOS (up from 14 in macOS and 12.5 in iOS)
-- and more (see [.browserslistrc (`stable` entry)](https://github.com/mui/material-ui/blob/v6.0.0/.browserslistrc#L11))
+- and more (see [.browserslistrc `stable` entry](https://github.com/mui/material-ui/blob/v6.0.0/.browserslistrc#L11))
### Removed support for IE 11
@@ -115,6 +115,7 @@ Expect updates as new breaking changes are introduced.
To align with React 19's removal of UMD builds, Material UI has also removed its UMD bundle.
This results in a reduction of the `@mui/material` package size by 2.5MB or 25% of the total package size.
+See [Package Phobia](https://packagephobia.com/result?p=@mui/material) for more details.
Instead, using ESM-based CDNs such as [esm.sh](https://esm.sh/) is recommended.
For alternative installation methods, refer to the [CDN documentation](/material-ui/getting-started/installation/#cdn).
@@ -203,13 +204,13 @@ This brings some breaking changes described in the following sections.
The `Grid2` component API was stabilized, so its import no longer contains the `Unstable_` prefix:
```diff
-- import { Unstable_Grid2 as Grid2 } from '@mui/material';
-+ import { Grid2 } from '@mui/material';
+-import { Unstable_Grid2 as Grid2 } from '@mui/material';
++import { Grid2 } from '@mui/material';
```
```diff
-- import Grid from '@mui/material/Unstable_Grid2';
-+ import Grid from '@mui/material/Grid2';
+-import Grid from '@mui/material/Unstable_Grid2';
++import Grid from '@mui/material/Grid2';
```
#### Size and offset props
@@ -223,28 +224,28 @@ For the default theme this was:
In v6, these props are renamed to `size` and `offset`:
```diff
-
+
```
Note that if the size or offset is the same for all breakpoints, you can use a single value:
```diff
--
-+
+-
++
```
Besides that, the `true` value for the size prop was renamed to `"grow"`:
```diff
--
-+
+-
++
```
Use this codemod to migrate your project to the new size and offset props:
@@ -260,8 +261,8 @@ You need to modify the import from `@mui/material/Unstable_Grid2` to `@mui/mater
If you have custom breakpoints, the change is the same:
```diff
--
-+
+-
++
```
Which you can cover with the same codemod by providing the custom breakpoints as an argument:
@@ -280,8 +281,8 @@ In v6, this is fixed, with the Grid being contained inside its parent's padding:
This removes the need for the `disableEqualOverflow` prop:
```diff
--
-+
+-
++
```
#### Spacing is no longer considered inside the Grid item's box
@@ -318,8 +319,8 @@ The `CssVarsProvider` and `extendTheme` APIs are now stable.
If you already use them in v5, you can now drop the experimental prefix.
```diff
-- import { experimental_extendTheme as extendTheme, Experimental_CssVarsProvider as CssVarsProvider } from '@mui/material/styles';
-+ import { extendTheme, CssVarsProvider } from '@mui/material/styles';
+-import { experimental_extendTheme as extendTheme, Experimental_CssVarsProvider as CssVarsProvider } from '@mui/material/styles';
++import { extendTheme, CssVarsProvider } from '@mui/material/styles';
```
Check out the [CSS theme variables page](/material-ui/customization/css-theme-variables/overview/) to learn more about it.
@@ -373,8 +374,8 @@ npx @mui/codemod@next v6.0.0/system-props
Or do it manually like the example below:
```diff
--
-+
+-