Material UI Updates & Release Notes

A big thanks to the 30 contributors who made this release possible. Here are some highlights ✨:

• ⚙️ Support values other than raw options for Autocomplete via the getOptionValue prop.
• ♿️ Extend the theme's focus indicator to InputBase and text fields with disableUnderline via theme.focusVisible.

@mui/[email protected]

Breaking Changes

• [autocomplete] Change the default popup Paper elevation from 1 to 8 (#49110) @namansancheti

Changes

• Add missing override interfaces for slotProps (#49343) @sai6855
• Export private focus-visible utilities (#49139) @siriwatknp
• Fix onClose types for Menu, Snackbar, and SwipeableDrawer (#49340) @Janpot
• Fix slot handling in Autocomplete chips, TextField inputLabel, and NativeSelect input (#49336) @Janpot
• Fix theme defaultProps and missing exports (#49332) @Janpot
• Remove unnecessary Omit types (#49328) @sai6855
• [autocomplete] Lazily derive the initial input value (#49057) @OskarEichler
• [autocomplete] Prevent crash when changing groupBy (#49150) @silviuaavram
• [autocomplete] Stop filtering once the result limit is reached (#49295) @valkiara
• [autocomplete] Support values other than raw options (#49078) @silviuaavram
• [avatargroup] Improve TypeScript performance when using slotProps (#49213) @sai6855
• [bottomnavigationaction] Document the selected prop (#49190) @siriwatknp
• [breadcrumbs] Build separators in one pass (#49058) @OskarEichler
• [button] Fix loading-position style leaking to non-loading buttons (#49182) @siriwatknp
• [button] Simplify ExtendButton type (#49364) @sai6855
• [buttonbase] Fix LazyRipple retaining event objects when ripples are disabled (#49000) @dizhurnikita
• [checkbox] Set the native indeterminate state on the input (#49053) @lazerg
• [dialogcontent] Render the theme.focusVisible ring on the scrollable content (#49311) @siriwatknp
• [inputbase] Fix slotProps.input event handlers and ref being ignored (#49333) @Janpot
• [link] Remove unwanted Omit type (#49331) @sai6855
• [link] Revert to color-mix when underline color is not accepted (#49077) @silviuaavram
• [modal] Prevent aria-hidden from being applied to non-portal modals (#49026) @ZeeshanTamboli
• [select] Fix flaky opening mouseup timing (#49024) @michelengelen
• [skeleton] Fix the background fallback with CSS theme variables (#49322) @aarongarciah
• [slider] Fix disableSwap when a neighboring thumb is at 0 (#49234) @kwy404
• [snackbar][speeddial] Remove unnecessary Omit in props definitions (#49214) @sai6855
• [speeddial] Fix horizontal persistent tooltip placement (#49073) @Cunninger
• [speeddial] Support action slot object refs (#49056) @OskarEichler
• [table] Improve accessibility for the pagination buttons (#49112) @silviuaavram
• [tablepaginationactions] Align common types with other components (#49347) @sai6855
• [tabs] Derive mounted state from the indicator style instead of setting it in an effect (#49324) @ZeeshanTamboli
• [tabs] Fix selected tab not scrolling into view when scroll buttons appear in auto mode (#48489) @starboyvarun
• [tabs] Respect scroll-padding when scrolling the selected tab into view (#49039) @crispinc-omnea
• [textfield] Add theme CSS variable for autofill box-shadow (#47472) @ludij
• [theme] Fix theme.alpha() for raw colors with CSS variables (#49273) @siriwatknp
• [theme] Fix theming outliers in Paper, BreadcrumbCollapsed, TablePagination, and Tooltip (#49335) @Janpot
• [theme] Keep CSS variable fallbacks in theme.alpha() (#49297) @aarongarciah
• [theme] Render the theme.focusVisible ring on inputs (#49152) @siriwatknp

@mui/[email protected]

• Center the WarningRounded icon within its viewBox (#49043) @itd-mb

@mui/[email protected]

• Remove duplicated filterProps mapping in getThemeValue (#48640) @sai6855
• Resolve InitColorSchemeScript %s placeholder at build time (#49113) @Janpot
• Serialize InitColorSchemeScript configuration values (#49091) @Janpot

@mui/[email protected]

• Document the deprecated slotState parameter and add resolveComponentProps tests (#49137) @usamabhatti1998
• Improve mergeSlotProps performance (#48002) @mj12albert

@mui/[email protected]

• Remove invalid number type from supported OverridableStringUnion type arguments (#49278) @sai6855

@mui/[email protected]

• [masonry] Fix styles with CSS theme variables (#49294) @aarongarciah
• [timelineitem] Keep the spacer selector at one class of specificity (#49028) @Janpot

@mui/[email protected]

• Upgrade required Node.js version in the engines field (#49070) @ZeeshanTamboli
• [formcontrollabel] Stop migrating ActionsComponent and remove inputRef (#49334) @Janpot

@mui/[email protected]

• Escape the </style> tag in server-rendered style output (#49183) @Janpot

Docs

• Add the accessibility conformance report page (#48926) @michelengelen
• Add the v10 migration guide (#49349) @silviuaavram
• Allow reopening cookie preferences from a URL hash (#49124) @brijeshb42
• Clarify how to restore icon data-testid attributes in the v7 migration guide (#49109) @alexfauquette
• Fix @mui/lab version in v7.3.6 changelog (#49145) @mateuseap
• Fix Next.js font optimization docs to preserve typography letter-spacing (#48488) @starboyvarun
• Fix the dead Popper.js documentation links (#49081) @lazerg
• Fix the LLM generated docs paths (#49076) @silviuaavram
• Improve accessibility for checkbox lists (#49111) @silviuaavram
• Warn about untrusted values in the sx prop (#49199) @Janpot
• [autocomplete] Add removal and navigation ARIA descriptions to Chip examples (#49086) @silviuaavram
• [backdrop] Move Backdrop to Utils and clarify it is a low-level utility (#49072) @webernir
• [drawer] Add accessible names to close buttons (#49161) @sai6855
• [material-icons] Add frame synonym for the Portrait icon (#49201) @Janpot
• [material-icons] Improve icon search performance (#44450) @oliviertassinari
• [numberfield] Document the format prop for units and currency (#49160) @Denimworld12
• [snackbar] Demonstrate Escape handling inside a dialog (#49306) @minwookshin
• [system] Avoid any when spreading the sx prop (#49083) @LeusMaximus

Core

• [ci] Add Claude PR review via mui-public reusable workflow (#49037) @Janpot
• [ci] Add the Claude CI flake-fix caller (#49197) @Janpot
• [code-infra] Add the release skill (#48938) @brijeshb42
• [code-infra] Backport #target-branch-reference to docs package.json (#49372) @silviuaavram
• [code-infra] Backport #target-branch-references to master (#49194) @silviuaavram
• [code-infra] Bump @types/node to 22 and group it with Node.js in Renovate (#49189) @Janpot
• [code-infra] Compare the nightly React runs with the stable Argos build (#49123) @LukasTy
• [code-infra] Consume shared commands from code-infra orb (#49082) @brijeshb42
• [code-infra] Convert @mui/lab to TypeScript (#49140) @Janpot
• [code-infra] Convert @mui/material internal svg-icons to TypeScript (#49143) @Janpot
• [code-infra] Convert remaining @mui/system .js+.d.ts pairs to TypeScript (part 2) (#48699) @Janpot
• [code-infra] Enable pnpm autoDedupe (#49242) @Janpot
• [code-infra] Fix Autocomplete JSDoc links after a stale merge (#49315) @silviuaavram
• [code-infra] Fix package.json metadata (#49243) @Janpot
• [code-infra] Include cherry-picks in the changelog (#49375) @brijeshb42
• [code-infra] Mark the Argos reference branch for release branch cuts (#49317) @Janpot
• [code-infra] Migrate to Babel 8 (#49162) @brijeshb42
• [code-infra] Pin the only-allow version in the preinstall hook (#49114) @Janpot
• [code-infra] Prune stale minimumReleaseAgeExclude entries (#49178) @Janpot
• [code-infra] Remove the legacy mark-duplicate workflow (#49363) @brijeshb42
• [code-infra] Run TypeScript 7 alongside the TS6 JS API (#49075) @brijeshb42
• [code-infra] Ship documentation Markdown inside the @mui/material package (#48722) @Janpot
• [code-infra] Show progress and rate limit retry time in release:changelog (#49376) @Janpot
• [code-infra] Update deprecated options in the Vitest test configuration (#49193) @ZeeshanTamboli
• [code-infra] Widen @babel/runtime range and stop emitting empty class fields (#49241) @brijeshb42
• [core] Remove the leftover canary release script (#49163) @Janpot
• [core] Replace @mui/internal-waterfall with es-toolkit (#49155) @Janpot
• [docs-infra] Derive accessibility report data from defaults and tests (#49271) @JCQuintas
• [docs-infra] Generate the accessibility Known gaps table (#49265) @michelengelen
• [docs-infra] Harden the OG image edge function (#49116) @Janpot
• [docs-infra] Keep generated LLM docs on filtered runs (#49290) @Janpot
• [docs-infra] Make core-docs agnostic of styled-components (#49138) @Janpot
• [docs-infra] Migrate deploy-succeeded to event-triggered function (#49158) @brijeshb42
• [docs-infra] Pin StackBlitz demo vite to v7 and plugin-react to v5 (#49151) @Janpot
• [docs-infra] Rate-limit the documentation feedback endpoint (#49115) @Janpot
• [docs-infra] Retire the docs service worker (#49188) @Janpot
• [docs-infra] Use JSON as the source of truth for the accessibility reports (#49270) @michelengelen
• [docs-infra] Validate docs feedback content before posting to Slack (#49088) @Janpot
• [internal] Prepare master for the alpha release (#49284) @silviuaavram
• [material] Convert colors to TypeScript (#49180) @Janpot
• [material] Convert utils and six barrels to TypeScript (#49185) @Janpot
• [test] Add a palette contrast contract for the accessibility reports (#49049) @michelengelen
• [test] Add a visual regression fixture for the DocSearch modal (#49002) @LukasTy
• [test] Automate WCAG 2.4.7 Focus Visible checks (#48945) @michelengelen
• [test] Fix flaky DocSearch modal screenshots (#49122) @LukasTy
• [test] Fix Vitest imports (#49184) @silviuaavram
• [test] Load the regression fonts from npm instead of Google Fonts (#49310) @Janpot
• [test] Make regression screenshot rasterization deterministic (#49208) @Janpot
• [test] Roll the component reports up into a library scorecard (#48925) @michelengelen
• [test] Run module augmentation tests against built declarations (#49142) @LukasTy
• [test][accordion] Add axe tests and WCAG conformance reports (#48924) @michelengelen
• [test][avatar] Add axe tests and WCAG conformance report (#48917) @michelengelen
• [test][avatar] Move the accessibility fixture to the fixture tree (#49087) @michelengelen
• [test][button] Add axe test coverage and WCAG conformance report (#48916) @michelengelen
• [test][checkbox] Add axe tests and WCAG conformance report (#48918) @michelengelen
• [test][docs-infra] Reduce timing dependencies in the cookie consent test (#49154) @LukasTy
• [test][linearprogress] Add axe tests and WCAG conformance report (#48922) @michelengelen
• [test][pagination] Add tests for zero boundary and sibling counts (#49118) @Janpot
• [test][radio] Add axe tests and WCAG conformance reports (#48920) @michelengelen
• [test][switch] Add axe tests and WCAG conformance report (#48919) @michelengelen
• [test][textfield] Add axe tests and WCAG conformance report (#48923) @michelengelen
• [test][togglebutton] Add axe tests and WCAG conformance reports (#48921) @michelengelen

All contributors of this release in alphabetical order: @aarongarciah, @alexfauquette, @brijeshb42, @crispinc-omnea, @Cunninger, @Denimworld12, @dizhurnikita, @itd-mb, @Janpot, @JCQuintas, @kwy404, @lazerg, @LeusMaximus, @ludij, @LukasTy, @mateuseap, @michelengelen, @minwookshin, @mj12albert, @namansancheti, @oliviertassinari, @OskarEichler, @sai6855, @silviuaavram, @siriwatknp, @starboyvarun, @usamabhatti1998, @valkiara, @webernir, @ZeeshanTamboli

A big thanks to the 28 contributors who made this release possible. Here are some highlights ✨:

• ⚙️ Support values other than raw options for Autocomplete via the getOptionValue prop.

@mui/[email protected]

• Add missing override interfaces for slotProps (#49345) @sai6855
• Export private focus-visible utilities (#49139) @siriwatknp
• Fix onClose types for Menu, Snackbar, and SwipeableDrawer (#49351) @Janpot
• Fix slot handling in Autocomplete chips, TextField inputLabel, and NativeSelect input (#49354) @Janpot
• Fix theme defaultProps and missing exports (#49342) @Janpot
• Remove unnecessary Omit types (#49338) @sai6855
• [autocomplete] Lazily derive the initial input value (#49192) @OskarEichler
• [autocomplete] Prevent crash when changing groupBy (#49150) @silviuaavram
• [autocomplete] Stop filtering once the result limit is reached (#49312) @valkiara
• [autocomplete] Support values other than raw options (#49313) @silviuaavram
• [avatargroup] Improve TypeScript performance when using slotProps (#49213) (#49215) @sai6855
• [bottomnavigationaction] Document the selected prop (#49190) (#49196) @sai6855
• [breadcrumbs] Build separators in one pass (#49058) @OskarEichler
• [button] Fix loading-position style leaking to non-loading buttons (#49182) @siriwatknp
• [button] Simplify ExtendButton type (#49366) @sai6855
• [buttonbase] Fix LazyRipple retaining event objects when ripples are disabled (#49000) @dizhurnikita
• [checkbox] Set the native indeterminate state on the input (#49053) @lazerg
• [dialogcontent] Render the theme.focusVisible ring on the scrollable content (#49319) @siriwatknp
• [inputbase] Fix slotProps.input event handlers and ref being ignored (#49341) @Janpot
• [link] Remove unwanted Omit type (#49339) @sai6855
• [link] Revert to color-mix when underline color is not accepted (#49077) @silviuaavram
• [modal] Prevent aria-hidden from being applied to non-portal modals (#49195) @ZeeshanTamboli
• [select] Fix flaky opening mouseup timing (#49024) @michelengelen
• [skeleton] Fix the background fallback with CSS theme variables (#49367) @aarongarciah
• [slider] Fix disableSwap when a neighboring thumb is at 0 (#49246) @kwy404
• [snackbar][speeddial] Remove unnecessary Omit in props definitions (#49272) @sai6855
• [speeddial] Fix horizontal persistent tooltip placement (#49238) @Cunninger
• [speeddial] Support action slot object refs (#49056) @OskarEichler
• [table] Improve accessibility for the pagination buttons (#49112) @silviuaavram
• [tablepaginationactions] Align common types with other components (#49348) @sai6855
• [tabs] Derive mounted state from the indicator style instead of setting it in an effect (#49326) @ZeeshanTamboli
• [tabs] Fix selected tab not scrolling into view when scroll buttons appear in auto mode (#48489) @starboyvarun
• [tabs] Respect scroll-padding when scrolling the selected tab into view (#49039) @crispinc-omnea
• [textfield] Add theme CSS variable for autofill box-shadow (#47472) @ludij
• [theme] Fix theme.alpha() for raw colors with CSS variables (#49320) @siriwatknp
• [theme] Fix theming outliers in Paper, BreadcrumbCollapsed, TablePagination, and Tooltip (#49356) @Janpot
• [theme] Keep CSS variable fallbacks in theme.alpha() (#49368) @aarongarciah

@mui/[email protected]

• Center the WarningRounded icon within its viewBox (#49203) @itd-mb

@mui/[email protected]

• Remove duplicated filterProps mapping in getThemeValue (#48640) @sai6855
• Resolve InitColorSchemeScript %s placeholder at build time (#49113) @Janpot
• Serialize InitColorSchemeScript configuration values (#49091) @Janpot

@mui/[email protected]

• Document the deprecated slotState parameter and add resolveComponentProps tests (#49240) @usamabhatti1998
• Improve mergeSlotProps performance (#48002) @mj12albert

@mui/[email protected]

• Remove invalid number type from supported OverridableStringUnion type arguments (#49307) @sai6855

@mui/[email protected]

• [masonry] Fix styles with CSS theme variables (#49330) @aarongarciah
• [timelineitem] Keep the spacer selector at one class of specificity (#49028) @Janpot

@mui/[email protected]

• Upgrade required Node.js version in the engines field (#49070) @ZeeshanTamboli
• [formcontrollabel] Stop migrating ActionsComponent and remove inputRef (#49358) @Janpot

Docs

• Add the accessibility conformance report page (#49267) @michelengelen
• Add v10 as the next version (#49293) @silviuaavram
• Allow reopening cookie preferences from a URL hash (#49124) @brijeshb42
• Clarify how to restore icon data-testid attributes in the v7 migration guide (#49109) @alexfauquette
• Fix @mui/lab version in v7.3.6 changelog (#49145) @mateuseap
• Fix Next.js font optimization docs to preserve typography letter-spacing (#48488) @starboyvarun
• Fix the dead Popper.js documentation links (#49081) @lazerg
• Fix the LLM generated docs paths (#49076) @silviuaavram
• Improve accessibility for checkbox lists (#49111) @silviuaavram
• Warn about untrusted values in the sx prop (#49212) @Janpot
• [autocomplete] Add removal and navigation ARIA descriptions to Chip examples (#49086) @silviuaavram
• [drawer] Add accessible names to close buttons (#49161) @sai6855
• [material-icons] Add frame synonym for the Portrait icon (#49211) @Janpot
• [material-icons] Improve icon search performance (#49206) @oliviertassinari
• [numberfield] Document the format prop for units and currency (#49160) @Denimworld12
• [snackbar] Demonstrate Escape handling inside a dialog (#49352) @minwookshin
• [system] Avoid any when spreading the sx prop (#49083) @LeusMaximus

Core

• [ci] Add Claude PR review via mui-public reusable workflow (#49037) @Janpot
• [code-infra] Compare the nightly React runs with the stable Argos build (#49123) @LukasTy
• [code-infra] Consume shared commands from code-infra orb (#49082) @brijeshb42
• [code-infra] Convert @mui/lab to TypeScript (#49140) @Janpot
• [code-infra] Convert @mui/material internal svg-icons to TypeScript (#49143) @Janpot
• [code-infra] Convert remaining @mui/system .js+.d.ts pairs to TypeScript (part 2) (#48699) @Janpot
• [code-infra] Fix package.json metadata (#49325) @Janpot
• [code-infra] Include cherry-picks in the changelog (#49377) @brijeshb42
• [code-infra] Migrate to Babel 8 (#49216) @brijeshb42
• [code-infra] Pin the Argos baseline to v9.x (#49316) @Janpot
• [code-infra] Pin the only-allow version in the preinstall hook (#49114) @Janpot
• [code-infra] Run TypeScript 7 alongside the TS6 JS API (#49075) @brijeshb42
• [code-infra] Ship documentation Markdown inside the @mui/material package (#49314) @Janpot
• [code-infra] Show progress and rate limit retry time in release:changelog (#49379) @Janpot
• [code-infra] Update #target-branch-reference for v9.x branch (#49191) @silviuaavram
• [code-infra] Widen @babel/runtime range and stop emitting empty class fields (#49276) @brijeshb42
• [core] Remove the leftover canary release script (#49163) @Janpot
• [core] Replace @mui/internal-waterfall with es-toolkit (#49155) @Janpot
• [core] Update release publish tags from next to latest (#49381) @mnajdova
• [docs-infra] Generate the accessibility Known gaps table (#49355) @michelengelen
• [docs-infra] Harden the OG image edge function (#49116) @Janpot
• [docs-infra] Make core-docs agnostic of styled-components (#49138) @Janpot
• [docs-infra] Migrate deploy-succeeded to event-triggered function (#49158) @brijeshb42
• [docs-infra] Pin StackBlitz demo vite to v7 and plugin-react to v5 (#49151) @Janpot
• [docs-infra] Rate-limit the documentation feedback endpoint (#49115) @Janpot
• [docs-infra] Retire the docs service worker (#49202) @Janpot
• [docs-infra] Update the deploy script to fetch from the v9.x branch (#49371) @mnajdova
• [docs-infra] Validate docs feedback content before posting to Slack (#49088) @Janpot
• [material] Convert colors to TypeScript (#49180) @Janpot
• [material] Convert utils and six barrels to TypeScript (#49185) @Janpot
• [test] Add a palette contrast contract for the accessibility reports (#49049) @michelengelen
• [test] Add a visual regression fixture for the DocSearch modal (#49002) @LukasTy
• [test] Automate WCAG 2.4.7 Focus Visible checks (#49268) @michelengelen
• [test] Fix flaky DocSearch modal screenshots (#49122) @LukasTy
• [test] Fix Vitest imports (#49184) @silviuaavram
• [test] Load the regression fonts from npm instead of Google Fonts (#49357) @Janpot
• [test] Run module augmentation tests against built declarations (#49142) @LukasTy
• [test][accordion] Add axe tests and WCAG conformance reports (#48924) @michelengelen
• [test][avatar] Add axe tests and WCAG conformance report (#48917) @michelengelen
• [test][avatar] Move the accessibility fixture to the fixture tree (#49087) @michelengelen
• [test][button] Add axe test coverage and WCAG conformance report (#48916) @michelengelen
• [test][checkbox] Add axe tests and WCAG conformance report (#48918) @michelengelen
• [test][docs-infra] Reduce timing dependencies in the cookie consent test (#49154) @LukasTy
• [test][linearprogress] Add axe tests and WCAG conformance report (#48922) @michelengelen
• [test][pagination] Add tests for zero boundary and sibling counts (#49118) @Janpot
• [test][radio] Add axe tests and WCAG conformance reports (#48920) @michelengelen
• [test][switch] Add axe tests and WCAG conformance report (#48919) @michelengelen
• [test][textfield] Add axe tests and WCAG conformance report (#48923) @michelengelen
• [test][togglebutton] Add axe tests and WCAG conformance reports (#48921) @michelengelen

All contributors of this release in alphabetical order: @aarongarciah, @alexfauquette, @brijeshb42, @crispinc-omnea, @Cunninger, @Denimworld12, @dizhurnikita, @itd-mb, @Janpot, @kwy404, @lazerg, @LeusMaximus, @ludij, @LukasTy, @mateuseap, @michelengelen, @minwookshin, @mj12albert, @mnajdova, @oliviertassinari, @OskarEichler, @sai6855, @silviuaavram, @siriwatknp, @starboyvarun, @usamabhatti1998, @valkiara, @ZeeshanTamboli

A big thanks to the 19 contributors who made this release possible. Here are some highlights ✨:

♿️ Opt in to a consistent keyboard focus ring across components with the new theme.focusVisible.
♿️ The Tooltip now supports disabled button triggers without an extra wrapper element.

@mui/[email protected]

• [theme] Add theme.focusVisible opt-in keyboard focus ring (#48743) @siriwatknp
• [buttongroup] Prevent sticky hover border on touch devices (#48993) @petr-kratochvil
• [l10n] Complete Traditional Chinese localization (#48946) @nrps9909
• [menulist] Preserve custom list padding when adjusting for the scrollbar (#48707) @creazyfrog
• [pagination] Manage focus whenever first / last / next / previous buttons become disabled (#48877) @silviuaavram
• [tooltip] Improve support for disabled button triggers (#48622) @mayank99

@mui/[email protected]

• Fix resolveProps to correctly merge slotProps defined as functions (#48955) @mnajdova
• Replace deprecated clip CSS property with clip-path (#48966) @ZeeshanTamboli

@mui/[email protected]

• Fix types for components extended with styled (#45988) @megos

Docs

• Bump @docsearch/react to ^4.7.0 (#48886) @LukasTy
• Fix broken links reported by Ahrefs (#48949) @brijeshb42
• Manage focus on Open in Chat button click (#48942) @silviuaavram
• Move focus to the main content with the skip link (#48944) @lazerg
• Use relative link for LICENSE in README (#49040) @loulanyue
• [autocomplete] Remove the "aria-owns" reference (#48958) @silviuaavram
• [table] Fix wrong number of rows reported to screen readers (#47653) @seomsoo
• [table] Reference DataGrid link in the row header section (#48988) @silviuaavram
• [table] Use and document the row header cells (#48965) @silviuaavram
• [tabs] Make tab panel focusable and show keep mounted examples (#48939) @silviuaavram
• [templates] Remove focusable links from hidden carousel slides (#49003) @gonzoblasco

Core

• [code-infra] Fix team sync review requests (#48914) @brijeshb42
• [code-infra] Import the test globals from vitest (#49033) @JCQuintas
• [code-infra] Point the support validator link at frontend-public (#49041) @Janpot
• [code-infra] Update CircleCI orb (#49030) @Janpot
• [code-infra] Use ESM current directory syntax for Vitest config (#49032) @ZeeshanTamboli
• [core] Use @typescript/typescript6 for the docs tooling (#49025) @Janpot
• [core-docs] Remove the globalSelector stylis middleware (#49029) @Janpot
• [test] Add an assertions mode to the axe regression harness (#48915) @michelengelen
• [test] Automate the CSS-dependent WCAG criteria (#48936) @michelengelen
• [test] Fail the regression run when a webfont does not load (#48948) @LukasTy
• [test] Fix typo 'overriden' -> 'overridden' in Alert test comment (#48987) @FirmaSpring
• [test] Replace webfontloader with the CSS Font Loading API (#48995) @LukasTy
• [test] Skip the CrudDashboard VRT on React 18 (#49027) @Janpot
• [test] Use the shared loadFonts from @mui/internal-test-utils (#49007) @LukasTy
• [test] Use the Vitest global expect instead of importing chai (#48996) @JCQuintas
• [test][tooltip] Keep the disabled trigger away from the real pointer (#48947) @LukasTy

All contributors of this release in alphabetical order: @brijeshb42, @creazyfrog, @FirmaSpring, @gonzoblasco, @Janpot, @JCQuintas, @lazerg, @loulanyue, @LukasTy, @mayank99, @megos, @michelengelen, @mnajdova, @nrps9909, @petr-kratochvil, @seomsoo, @silviuaavram, @siriwatknp, @ZeeshanTamboli

A big thanks to the 4 contributors who made this release possible.

@mui/[email protected]

• [transitions] Prevent exit transitions from getting stuck (#48881) @ZeeshanTamboli

@mui/[email protected]

• Include transforms in published package (#48934) @brijeshb42

Core

• [blog] Clarify early bird renewal discount scope (#48906) @DanailH
• [test][pagination] Add more unit tests (#48927) @silviuaavram

All contributors of this release in alphabetical order: @brijeshb42, @DanailH, @silviuaavram, @ZeeshanTamboli

A big thanks to the 18 contributors who made this release possible. Here are some highlights ✨:

♿️ Keyboard navigation in the Toggle Button Group now follows the roving tabindex pattern.
♿️ The Autocomplete announces its loading and no options messages through a new status slot.

@mui/[email protected]

• [autocomplete] Wrap the no results and loading messages in an aria live region (#48690) @silviuaavram
• [buttongroup] Respect global disableRipple / disableFocusRipple in grouped buttons (#48762) @siriwatknp
• [checkbox][radio] Respect global disableRipple from MuiButtonBase defaultProps (#48795) @siriwatknp
• [formcontrollabel] Add missing labelPlacementEnd class (#48843) @siriwatknp
• [listitembutton] Fix typos in component code (#48868) @ZeeshanTamboli
• [menuitem] Add aria-checked for checkbox and radio menu items (#48651) @siriwatknp
• [modal] Replace custom findIndexOf with findIndex (#48827) @ZeeshanTamboli
• [modal][dialog] Fix scrollbar compensation in Shadow DOM (#48826) @ZeeshanTamboli
• [select] Fix endAdornment overlapping the open indicator (#48723) @siriwatknp
• [tablepagination] Add focus style to default InputBase used in Select (#48871) @silviuaavram
• [togglebuttongroup] Add roving tabindex keyboard navigation (#48849) @silviuaavram

@mui/[email protected]

Prevent prototype pollution in cssVarsParser (#48822) @Janpot

@mui/[email protected]

Don't leak state between files in v5.0.0/path-imports (#48797) @manbearwiz
Remove use of eval() (#48701) @oliviertassinari
Transform all style exports in v5.0.0/path-imports codemod (#48800) @manbearwiz

Docs

Clarify container prop inheritance for Shadow DOM (#48670) @Juan-C-Ceballos
Clarify third-party script risk in CSP unsafe-inline note (#48787) @Janpot
Document box-sx-prop codemod (#48888) @SR0725
Document Grid direction column removal in v9 upgrade guide (#48880) @kalayciburak
Fix color contrast in GitHub labels example (#48844) @silviuaavram
Fix per-page canonical URL and stale SEO link (#48789) @brijeshb42
Fix redirect loop on the Design Kits page (#48869) @Janpot
Fix typo 'overriden' -> 'overridden' in CHANGELOG (#48785) @ZhouYinLong-lab
Improve TransferList examples (#48845) @silviuaavram
Link a new theme generator tool (#48847) @mansourcodes
Remove broken learning resource links (#48598) @morning-verlu
Update the 9.2.0 changelog (#48763) @silviuaavram
[autocomplete] Clarify how to render custom start and end adornments (#48883) @DebadityaHait
[drawer] Clarify clipped AppBar spacing (#48887) @rushijagani-dev
[menu] Fix stale selected prop reference in Selected menu section (#48879) @LukasTy
[skeleton] Document preserving typography sizing with custom border radius (#48596) @meaqua9420

Core

• [blog] Fix caret annotation broken by Prettier wrapping (#48884) @bernardobelchior
• [code-infra] Automate team sync on about page (#48794) @brijeshb42
• [code-infra] Bump @mui/internal-code-infra to 0.0.4-canary.101 (#48878) @Janpot
• [code-infra] Fix Dependabot alerts (#48756) @Janpot
• [code-infra] Fix team sync PR creation (#48911) @brijeshb42
• [code-infra] Pin node version in publish CI (#48799) @brijeshb42
• [core-docs] Tighten service worker host check (#48581) @Janpot
• [docs-infra] Change branch name to the allowed one (#48910) @brijeshb42

All contributors of this release in alphabetical order: @bernardobelchior, @brijeshb42, @DebadityaHait, @Janpot, @Juan-C-Ceballos, @kalayciburak, @LukasTy, @manbearwiz, @mansourcodes, @meaqua9420, @morning-verlu, @oliviertassinari, @rushijagani-dev, @silviuaavram, @siriwatknp, @SR0725, @ZeeshanTamboli, @ZhouYinLong-lab

A big thanks to the 9 contributors who made this release possible.

⚙️ Add support for data-* attributes on slotProps.

@mui/[email protected]

• [l10n] Add missing MuiPagination localization to zh-CN locale (#48741) @greymoth-jp
• [select] Guard display ref during mouse down (#48744) @michelengelen

@mui/[email protected]

• [utils] Add opt-in DataAttributesOverrides augmentation for slot props (#48554) @LukasTy

Docs

• [docs] Improve Icon Dialog responsiveness on small screens (#48639) @Prakash1185
• [docs] Fix invalid UTF-8 in skill references (#48739) @mturac

Core

• [code-infra] Resolve Renovate dashboard warnings (#48700) @Sushantplive
• [code-infra] Validate npm publishing through dry run (#48691) @brijeshb42
• [code-infra] Run prettier after renovate update (#48754) @Janpot
• [code-infra] Fix 'A11y results committed?' check on react-pinned nightly jobs (#48740) @Janpot
• [core] Remove leftover Joy UI references (#48719) @siriwatknp
• [code-infra] Bump react-router to 7.15.1 (#48725) @Janpot
• [docs-infra] Drive docs analytics IDs via ANALYTICS_ENV (#48694) @Janpot
• [docs-infra] Pre-render API page descriptions (#48693) @brijeshb42
• [code-infra][icons-material] Build lib/package.json with code-infra --no-expand (#48689) @Janpot
• [code-infra] Fix react@18/next nightly workflow (#48635) @Janpot

All contributors of this release in alphabetical order: @brijeshb42, @greymoth-jp, @Janpot, @LukasTy, @michelengelen, @mturac, @Prakash1185, @siriwatknp, @Sushantplive

A big thanks to the 5 contributors who made this release possible.

@mui/[email protected]

• [autocomplete] Don't submit forms when committing freeSolo value with Enter key (#48679) @mj12albert
• [transitions] Fix RTG import in ESM (#48645) @mj12albert

@mui/[email protected]

• [InitColorSchemeScript] Fix script tag warning in Next.js 16 dev mode (#48671) @siriwatknp

Docs

• Fix typos in release instructions (#48687) @brijeshb42
• Update @mui/x-* packages to latest (#48661) @Janpot

Core

• [code-infra] Convert leaf @mui/system .js+.d.ts pairs to TypeScript (part 1) (#48578) @Janpot
• [code-infra] Bump to latest code-infra packages (#48672) @brijeshb42
• [code-infra] Resolve remaining minimatch advisory (#48662) @Janpot
• [code-infra] Bump nx to resolve minimatch advisory (#48658) @Janpot
• [core] Drop @babel/* pnpm overrides (#48710) @Janpot
• [docs-infra] Revert "Pin StackBlitz demo vite to v7 and plugin-react to v5" (#48709) @Janpot
• [docs-infra] Fix code-block copy button broken on direct page load (#48653) @brijeshb42
• [test] Stabilize Data Grid demo data in Argos screenshots (#48654) @LukasTy

All contributors of this release in alphabetical order: @brijeshb42, @Janpot, @LukasTy, @mj12albert, @siriwatknp

A big thanks to the 9 contributors who made this release possible.

@mui/[email protected]

• [Autocomplete] Update fullWidth prop documentation (#48626) @vipin8797
• [ButtonBase] Fix focus ripple lingering after blur (#48650) @siriwatknp
• [InitColorSchemeScript] Server-render in tests for React 19.3 (#48604) @Janpot
• [Transition] Mount child in same commit when opening from unmounted (#48649) @siriwatknp

@mui/[email protected]

• [styled-engine] Prevent enableCssLayer styles from being overridden by unlayered styles (#48603) @Janpot

Docs

• Send SOURCE to Brevo on newsletter subscribe (#48633) @aemartos
• fix TypeScript heading capitalization (#48619) @ifer47
• Remove outdated security section (#48628) @oliviertassinari
• [legal] Update EULA links on website (#48642) @rluzists1

Core

• Update dependencies to resolve Dependabot security alerts (#48641) @Janpot
• [core-docs] Pin StackBlitz demo vite to v7 and plugin-react to v5 (#48643) @Janpot
• [code-infra] Port codebase to use tsgo (#48616) @brijeshb42
• [docs-infra] Fix immutable cache headers for /_next/static assets (#48655) @brijeshb42
• [docs-infra] Run link checker during docs build instead of as separate CI step (#48634) @Janpot
• [docs-infra] Support turbopack for docs (#48569) @brijeshb42
• [test] Cover docs landing-page composites with Argos (#48589) @LukasTy

All contributors of this release in alphabetical order: @aemartos, @brijeshb42, @ifer47, @Janpot, @LukasTy, @oliviertassinari, @rluzists1, @siriwatknp, @vipin8797

A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:

• ⚙️ Support for the prefers-reduced-motion setting.
• ♿️ Improved support for Windows High Contrast mode with the enhanceHighContrast theme wrapper.

@mui/[email protected]

• [autocomplete] Enable clearing highlight when mouse leaves popup (#48354) @mj12albert
• [autocomplete] Fix freeSolo controlled values cleared by initial null (#48611) @mj12albert
• [autocomplete] Fix item removal when it receives focus from VoiceOver before using Backspace (#48572) @silviuaavram
• [autocomplete] Fix resetHighlightOnMouseLeave JSdoc (#48536) @mj12albert
• [autocomplete] Guard against null inputRef during unmount (#48617) @noam3127
• [badge] Add aria-hidden to badge content and polish docs demos (#48471) @mj12albert
• [badge] Use inline CSS variables for anchorOrigin/overlap positioning (#48549) @siriwatknp
• [button] Fix customized flex gap styles (#48542) @mj12albert
• [dialog] Fix unwanted DialogPaper focus ring (#48535) @mj12albert
• [focus trap] Fix incorrect tab order when tabIndex >= 1 (#48546) @mj12albert
• [progress] Show runtime errors only once (#48591) @silviuaavram
• [select] Allow spacebar to select elements (#48615) @silviuaavram
• [select] Support typeahead when closed (#48563) @mj12albert
• [step button] Choose higher contrast ripple color for dark mode focus (#48612) @silviuaavram
• [stepper] Include StepConnector inside Step element (#48492) @silviuaavram
• [stepper] Proper support for vertical alternativeLabel (#48485) @silviuaavram
• [tabs] Fix React 18 roving tabindex and dedupe invalid-value warning (#48605) @Janpot
• [theme] Add HighContrast theme enhancer (#48319) @silviuaavram
• [timeline item] Fix extra ::before spacing when TimelineOppositeContent is present (#46663) @tyalau
• [tooltip] Prevent stuck-open tooltip when child becomes disabled (#48606) @Janpot
• [transitions] Custom Transition component (#48325) @mj12albert
• [transitions] Support prefers-reduced-motion (#48557) @mj12albert

@mui/[email protected]

• [utils] Prevent prototype pollution in fastDeepAssign (#48580) @Janpot

Docs

• [docs] Add function slotProps documentation (#48574) @mj12albert
• [docs] Clarify styled-components version compatibility (#48533) @nightt5879
• [docs] Fix broken URLs (#48520) @oliviertassinari
• [docs] Fix invalid JSON in Zed MCP setup example (#48490) @pavan-sh
• [docs] Mention release version for enhanceHighContrast (#48609) @silviuaavram
• [docs] Remove outdated MUI X v8 notification (#48600) @cherniavskii
• [docs] Remove redundant enhanceHighContrast information (#48632) @silviuaavram
• [docs-infra] Decrease loaded bundle size on docs (#48584) @brijeshb42
• [docs-infra] Drop multi-locale plumbing from API pages (#48370) @brijeshb42
• [docs-infra] Fix Cookie banner heading (#48529) @oliviertassinari
• [docs-infra] Infinitely cache all static assets (#48627) @brijeshb42
• [docs-infra] Remove outdated noSEOadvantage entries (#48527) @oliviertassinari
• [docs-infra] Restore build-only invariant throws via NEXT_RUNTIME guard (#48475) @Janpot
• [docs-infra] Test HTML validation in broken links checker (#48088) @Janpot
• [docs][icons] Fix Font Awesome Chip demo in dark mode (#48576) @siriwatknp
• [docs][icons] Remove redundant font awesome demo (#48493) @ZeeshanTamboli
• [docs][modal] Add nested modal guidance (#46507) @JakeSaterlay
• [docs][stepper] Fix focus management in examples (#48494) @silviuaavram

Core

• Eslint markdown (#48371) @Janpot
• [agents] Fix some docs links (#48561) @silviuaavram
• [blog] Copy editing improvement on v9 announcement blog posts (#48543) @joserodolfofreitas
• [code-infra] Cleanup unused jss packages (#48590) @brijeshb42
• [code-infra] Collapse canary workflows into nightly and nightly-cron (#48556) @Janpot
• [code-infra] Convert @mui/private-theming to TypeScript (#48565) @Janpot
• [code-infra] Convert @mui/styled-engine to TypeScript (#48544) @Janpot
• [code-infra] Convert @mui/styled-engine-sc to TypeScript (#48577) @Janpot
• [code-infra] Fix duplicate resource_class in test_regressions CI job (#48601) @LukasTy
• [code-infra] Make @mui/internal-docs-utils compatible with TypeScript 6 (#48594) @Janpot
• [code-infra] Migrate CircleCI jobs to Gen2 resource classes (#48593) @LukasTy
• [code-infra] Parallelize visual regression screenshots (#48557) @Janpot
• [code-infra] Run nightly-cron on v7.x (#48579) @Janpot
• [core] Fix typescript@next typecheck (#48587) @Janpot
• [pnpm] Add security settings to pnpm-workspace.yaml (#48582) @Janpot
• [styled-engine-sc] Fix compatibility with Vite and Vitest (#48558) @mj12albert
• [test] Add axe-core tests for mui-material (#48341) @siriwatknp
• [test] Configure Tailwind CSS in the visual-regression app (#48575) @Janpot

All contributors of this release in alphabetical order: @brijeshb42, @cherniavskii, @JakeSaterlay, @Janpot, @joserodolfofreitas, @LukasTy, @mj12albert, @nightt5879, @noam3127, @oliviertassinari, @pavan-sh, @silviuaavram, @siriwatknp, @tyalau, @ZeeshanTamboli

A big thanks to the 5 contributors who made this release possible.

@mui/[email protected]

• [autocomplete] Fix highlight sync and scroll preservation (#48350) @mj12albert
• [autocomplete] Fix popper rendering issues (#48343) @mj12albert
• [autocomplete] Improve highlight tracking and selection state (#48318) @mj12albert
• [button] Fix startIcon alignment (#48339) @mj12albert
• [button] Remove duplicated className entries (#48284) @silviuaavram
• [checkbox] Set aria-checked=mixed when indeterminate (#48286) @mj12albert
• [dialog][drawer][focus trap] Fix initial focus target (#48324) @mj12albert
• [drawer] Fix transition jump (#48340) @mj12albert
• [input] Fix layout shift with display: flex (#48359) @oliviertassinari
• [inputs] Fix autofocus in SSR environment (#48307) @mj12albert
• [popper] Persist positioning styles when popperOptions changes reference (#48302) @mj12albert
• [switch] Fix incorrect role with slotProps.input (#48472) @mj12albert
• [utils] Add shadow dom utils (#48309) @mj12albert

Docs

• [docs] Update banner to announce v9 (#48299) @siriwatknp
• [docs] Add v9 in the versions select in v7.mui.com (#48233) @alexfauquette

Core

• [internal] Update some host-reference entries (#48225) @silviuaavram

All contributors of this release in alphabetical order: @alexfauquette, @mj12albert, @oliviertassinari, @silviuaavram, @siriwatknp

🥳 We're excited to announce the stable release of Material UI v9.0! This major release focuses on accessibility improvements, sx prop performance, and cleanup of deprecated APIs. See the Material UI v9.0 announcement blog posts for more details. Also see the MUI v9 announcement blog posts for the broad ecosystem updates.

Check out the upgrade guide to see how you can move to this version.

@mui/[email protected]

• [slider] Use pointer events instead of mouse events (#48164) @mj12albert
• [switch] Add border to make it visible in high contrast mode (#48180) @silviuaavram
• [transitions] Performance improvements & misc fixes (#48151) @mj12albert
• Remove unnecessary overridesResolvers from styled components (#48204) @sai6855

Core

• [code-infra] Setup workflow to publish internal packages (#47952) @brijeshb42
• [core-docs] Add x-scheduler to MuiProductId type (#48185) @rita-codes
• [docs-infra] Add scheduler to product switcher (#48208) @rita-codes
• [internal] Prepare libraries for v9 stable release (#48206) @siriwatknp

🙇‍♂️ We'd like to extend a big thank you to everyone involved who made this major release possible.

A big thanks to the 15 contributors who made this release possible. A few highlights ✨:

📖 Added the Menubar component page to the docs.

@mui/[email protected]

• [alert][dialog] Accessibility improvements (#48161) @silviuaavram
• [autocomplete] Add root slot (#47916) @GerardasB
• [autocomplete] Fix helper text focusing input when clicked (#48162) @mj12albert
• [autocomplete] Fix popup reopening on window focus regain with openOnFocus (#47914) @aman44444
• [autocomplete] Optimize selected option lookup (#48027) @anchmelev
• [autocomplete] Support full slots for clearIndicator and popupIndicator (#47913) @silviuaavram
• [button-base] Fix native button detection (#47994) @mj12albert
• [input] Fix high contrast cutoff on first character (#48160) @silviuaavram
• [list item text][card header] Revert cleanup of duplicated CSS rules (#47938) @sai6855
• [popper] Add missing classes export (#48033) @mj12albert
• [select] Fix focus visible always set on menu item (#48022) @silviuaavram
• [slider] Accept readonly array for the value prop (#47961) @pcorpet
• [switch] Add border to make it visible in high contrast mode (#48210) @silviuaavram
• [theme] Do not create channel tokens for custom colors when nativeColor is used (#48144) @ZeeshanTamboli
• [transitions] Performance improvements & misc fixes (#48217) @mj12albert

Docs

• [codemod] Add v7 migration docs for deprecated Autocomplete APIs and Autocomplete codemod (#47954) @ZeeshanTamboli
• [menubar] Add Menubar component page (#47942) @siriwatknp
• [progress] Label all demo components (#48168) @mj12albert
• [system] Update styled API docs for easier understanding (#47969) @olivier-lxo
• Fix the dark mode footer row shadow for the Data Grid on the advanced components page (#48152) @arminmeh
• Fix MUI X redirects (#47917) @cherniavskii
• Use direct palette vars in Tailwind v4 snippet (#47955) @Ahmad-Alaziz

Core

• [blog] Blogpost for upcoming price changes for MUI X (#47820) @DanailH
• [blog] Update the 2026 price changes blogpost (#47944) @DanailH
• [code-infra] Add pkg-pr-new as dev dependency (#48023) @silviuaavram
• [docs-infra] Update Release Instructions and Search Index v7 (#48109) @dav-is

All contributors of this release in alphabetical order: @Ahmad-Alaziz, @aman44444, @anchmelev, @arminmeh, @cherniavskii, @DanailH, @dav-is, @GerardasB, @mj12albert, @olivier-lxo, @pcorpet, @sai6855, @silviuaavram, @siriwatknp, @ZeeshanTamboli