Merge remote-tracking branch 'upstream/master' into fix-prop-types

README.md

@@ -97,6 +97,8 @@ via [Open Collective](https://opencollective.com/mui-org) or via [Patreon](http
    
   <a href="https://twicsy.com/?utm_source=mui.com&utm_medium=referral&utm_content=readme" rel="noopener sponsored" target="_blank"><img height="26" width="30" src="https://images.opencollective.com/twicsy/7af290f/logo/78.png" alt="twicsy.com" title="Twicsy: Instant delivery Instagram followers." loading="lazy" />Twicsy</a>
   &nbsp;
+  <a href="https://views4you.com/?utm_source=mui.com&utm_medium=referral&utm_content=readme" rel="noopener sponsored" target="_blank"><img height="26" width="26" src="https://images.opencollective.com/buy-instagram-followers-v4y/6364714/logo/78.png" alt="views4you.com" title="Views4you: Social media growth services." loading="lazy" />Views4You</a>
+  &nbsp;
 </p>
 
 Gold sponsors are those who have pledged \$500/month or more to MUI.

docs/data/material/discover-more/backers/backers.md

@@ -39,6 +39,7 @@ For example, it could be because the service breaks another service's Terms of s
   <a data-ga-event-category="sponsor" data-ga-event-action="docs-backers" data-ga-event-label="goread.io" href="https://goread.io/?utm_source=mui.com&utm_medium=referral&utm_content=backers" rel="noopener sponsored" target="_blank" class="remove-link-arrow" style="margin-right: 16px; display:flex;"><img height="26" width="23" src="https://images.opencollective.com/goread_io/eb6337d/logo/26.png" srcset="https://images.opencollective.com/goread_io/eb6337d/logo/78.png 3x" alt="goread.io" title="Goread.io: Instagram followers, likes, views, and comments." loading="lazy" style="margin-right: 6px;" />Goread.io</a>
   <a data-ga-event-category="sponsor" data-ga-event-action="docs-backers" data-ga-event-label="buzzoid.com" href="https://buzzoid.com/?utm_source=mui.com&utm_medium=referral&utm_content=backers" rel="noopener sponsored" target="_blank" class="remove-link-arrow" style="margin-right: 16px; display:flex;"><img height="26" width="26" src="https://images.opencollective.com/buzzoidz/d23d9bb/logo/26.png" srcset="https://images.opencollective.com/buzzoidz/d23d9bb/logo/78.png 3x" alt="buzzoid.com" title="Buzzoid: Instant delivery Instagram followers." loading="lazy" style="margin-right: 6px;" />Buzzoid</a>
   <a data-ga-event-category="sponsor" data-ga-event-action="docs-backers" data-ga-event-label="twicsy.com" href="https://twicsy.com/?utm_source=mui.com&utm_medium=referral&utm_content=backers" rel="noopener sponsored" target="_blank" class="remove-link-arrow" style="margin-right: 16px; display:flex;"><img height="26" width="30" src="https://images.opencollective.com/twicsy/7af290f/logo/26.png" srcset="https://images.opencollective.com/twicsy/7af290f/logo/78.png 3x" alt="twicsy.com" title="Twicsy: Instant delivery Instagram followers." loading="lazy" style="margin-right: 6px;" />Twicsy</a>
+  <a data-ga-event-category="sponsor" data-ga-event-action="docs-backers" data-ga-event-label="views4you.com" href="https://views4you.com/?utm_source=mui.com&utm_medium=referral&utm_content=backers" rel="noopener sponsored" target="_blank" class="remove-link-arrow" style="margin-right: 16px; display:flex;"><img height="26" width="26" src="https://images.opencollective.com/buy-instagram-followers-v4y/6364714/logo/26.png" srcset="https://images.opencollective.com/buy-instagram-followers-v4y/6364714/logo/78.png 3x" alt="views4you.com" title="Views4you: Social media growth services." loading="lazy" style="margin-right: 6px;" />Views4You</a>
 </p>
 
 Gold sponsors are those who've pledged \$500/month or more to the MUI organization. [Tier benefits](#gold).

docs/data/material/discover-more/related-projects/related-projects.md

@@ -12,10 +12,6 @@ Feel free to submit a pull request!
 
 - [UXPin](https://www.uxpin.com/merge/mui-library): A large UI kit of Material UI components. It renders the components in a web runtime and uses the same React implementation as your production environment.
 
-## IDE tools
-
-- [eslint-plugin-material-ui-unused-classes](https://github.com/jens-ox/eslint-plugin-material-ui-unused-classes): ESLint plugin to detect unused styling classes with `@mui/styles`.
-
 ## Theming
 
 - [material-ui-theme-editor](https://in-your-saas.github.io/material-ui-theme-editor/): A tool to generate themes for your Material UI applications that features live previewing.

docs/data/material/migration/migration-v4/migration-v4.md

@@ -114,7 +114,7 @@ Make sure that your application is still running without errors, and commit the
 
 Before upgrading to v5, please make sure that `ThemeProvider` is defined at the root of your application and in tests—even if you are using the default theme—and `useStyles` is _not_ called before `ThemeProvider`.
 
-Eventually you may want to [migrate from JSS to Emotion](/material-ui/migration/migrating-from-jss/), but in the meantime you can continue to use JSS with the `@mui/styles` package.
+Eventually you will want to [migrate from JSS to Emotion](/material-ui/migration/migrating-from-jss/), but in the meantime you can continue to use the older JSS-based utilities with the deprecated `@mui/styles` package.
 This package requires `ThemeProvider`.
 
 The root of your application should look something like this:

docs/data/material/migration/migration-v4/v5-style-changes.md

@@ -536,7 +536,8 @@ The `createStyles` function from `@mui/material/styles` was moved to the one exp
 
 ### ✅ Update createGenerateClassName import
 
-The `createGenerateClassName` function is no longer exported from `@mui/material/styles`. You should import it directly from `@mui/styles`.
+The `createGenerateClassName` function is no longer exported from `@mui/material/styles`.
+You can import it from the deprecated `@mui/styles` package if you need to continue using it.
 
 ```diff
 -import { createGenerateClassName } from '@mui/material/styles';
@@ -568,7 +569,8 @@ The `MuiThemeProvider` component is no longer exported from `@mui/material/style
 
 ### ✅ Update jssPreset import
 
-The `jssPreset` object is no longer exported from `@mui/material/styles`. You should import it directly from `@mui/styles`.
+The `jssPreset` object is no longer exported from `@mui/material/styles`.
+You can import it from the deprecated `@mui/styles` package if you need to continue using it.
 
 ```diff
 -import { jssPreset } from '@mui/material/styles';
@@ -577,8 +579,8 @@ The `jssPreset` object is no longer exported from `@mui/material/styles`. You sh
 
 ### ✅ Update `makeStyles` import
 
-The `makeStyles` JSS utility is no longer exported from `@mui/material/styles`.
-You can use `@mui/styles/makeStyles` instead.
+Since Material UI v5 doesn't use JSS, the JSS-based `makeStyles` utility is no longer exported by `@mui/material/styles`.
+While migrating your app away from JSS, you can temporarily import this deprecated utility from `@mui/styles/makeStyles` before refactoring your components further.
 
 Make sure to add a `ThemeProvider` at the root of your application, as the `defaultTheme` is no longer available.
 
@@ -607,7 +609,8 @@ If you are using this utility together with `@mui/material`, it's recommended th
 
 ### ✅ Update ServerStyleSheets import
 
-The `ServerStyleSheets` component is no longer exported from `@mui/material/styles`. You should import it directly from `@mui/styles`.
+The `ServerStyleSheets` component is no longer exported from `@mui/material/styles`.
+You can import it from the deprecated `@mui/styles` package if you need to continue using it.
 
 ```diff
 -import { ServerStyleSheets } from '@mui/material/styles';
@@ -616,7 +619,8 @@ The `ServerStyleSheets` component is no longer exported from `@mui/material/styl
 
 ### styled
 
-The `styled` JSS utility is no longer exported from `@mui/material/styles`. You can use the one exported from `@mui/styles` instead.
+Since Material UI v5 doesn't use JSS, the JSS-based `styled` utility exported by `@mui/material/styles` has been replaced with an equivalent Emotion-based utility that's not backwards compatible.
+While migrating your app away from JSS, you can temporarily import the JSS-based utility from the deprecated `@mui/styles` package before refactoring your components further.
 
 Make sure to add a `ThemeProvider` at the root of your application, as the `defaultTheme` is no longer available.
 
@@ -638,7 +642,8 @@ If you are using this utility together with `@mui/material`, it's recommended yo
 
 ### ✅ Update StylesProvider import
 
-The `StylesProvider` component is no longer exported from `@mui/material/styles`. You should import it directly from `@mui/styles`.
+The `StylesProvider` component is no longer exported from `@mui/material/styles`.
+You can import it from the deprecated `@mui/styles` package if you need to continue using it.
 
 ```diff
 -import { StylesProvider } from '@mui/material/styles';
@@ -648,7 +653,7 @@ The `StylesProvider` component is no longer exported from `@mui/material/styles`
 ### ✅ Update useThemeVariants import
 
 The `useThemeVariants` hook is no longer exported from `@mui/material/styles`.
-You should import it directly from `@mui/styles`.
+You can import it from the deprecated `@mui/styles` package if you need to continue using it.
 
 ```diff
 -import { useThemeVariants } from '@mui/material/styles';
@@ -657,8 +662,8 @@ You should import it directly from `@mui/styles`.
 
 ### ✅ Update withStyles import
 
-The `withStyles` JSS utility is no longer exported from `@mui/material/styles`.
-You can use `@mui/styles/withStyles` instead.
+Since Material UI v5 doesn't use JSS, the JSS-based `withStyles` utility is no longer exported by `@mui/material/styles`.
+While migrating your app away from JSS, you can temporarily import this deprecated utility from `@mui/styles/withStyles` before refactoring your components further.
 
 Make sure to add a `ThemeProvider` at the root of your application, as the `defaultTheme` is no longer available.
 

docs/src/components/home/GoldSponsors.tsx

@@ -87,6 +87,11 @@ const BACKLINKs = [
     description: 'Instant delivery Instagram followers.',
     href: 'https://twicsy.com/?utm_source=mui.com&utm_medium=referral&utm_content=homepage',
   },
+  {
+    name: 'Views4You',
+    description: 'Social media growth services.',
+    href: 'https://views4you.com/?utm_source=mui.com&utm_medium=referral&utm_content=homepage',
+  },
 ];
 
 export default function GoldSponsors() {

packages/mui-styles/README.md

@@ -1,6 +1,6 @@
 # @mui/styles
 
-You can leverage our styling solution, even if you are not using our components.
+The legacy styling solution for Material UI, now deprecated and not recommended for use.
 
 ## Installation