@mui/codemod 9.0.0-alpha.0 → 9.0.0-alpha.1

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # [Versions](https://mui.com/versions/)
 
+## 9.0.0-alpha.1
+
+<!-- generated comparing v9.0.0-alpha.0..master -->
+
+_Feb 26, 2026_
+
+A big thanks to the 13 contributors who made this release possible. Here are some highlights ✨:
+
+### @mui/material@9.0.0-alpha.1
+
+- [Autocomplete] Prevents Autocomplete menu from opening on right click (#47797) @silviuaavram
+- [Backdrop] Remove aria-hidden by default (#47798) @silviuaavram
+- [ButtonBase] Ensure that onClick propagates when non-native button is clicked (#47800) @silviuaavram
+- [Dialog][Modal] Remove `disableEscapeKeyDown` prop (#47695) @silviuaavram
+- [Grid] Remove system props support (#47846) @siriwatknp
+- [TableCell][theme] Apply `alpha` before color mixing to border bottom color when nativeColor + cssVariables is used (#47762) @ZeeshanTamboli
+- [theme] Remove MuiTouchRipple from theme component types (#47849) @siriwatknp
+- [Tooltip] Fix error is thrown when wrapping an input which is disabled while focused (#47684) @ZeeshanTamboli
+- [useAutocomplete] Improve isOptionEqualToValue value argument type (#47801) @silviuaavram
+
+### Docs
+
+- [docs] Add updated community theme resource (#47847) @PeterTYLiu
+- [docs] Few copy fixes (#47806) @pavan-sh
+- [docs] Fix IPA reader link in blog post (#47796) @pavan-sh
+- [docs] Fix JSX in Overriding component structure docs (#47799) @ZeeshanTamboli
+- [docs] Fix the keyboard navigation in GroupedMenu example (#47842) @silviuaavram
+- [docs] Fix Theme builder video (#47835) @oliviertassinari
+- [docs] Update pricing sankey as done (#47795) @alexfauquette
+- [docs][system] Update sizing docs to clarify `(0, 1]` behavior. (#47845) @matthias-ccri
+
+### Core
+
+- [blog] Blogpost for upcoming price changes for MUI X (#47748) @DanailH
+- [code-infra] Detect browser envs that don't support layout (#47813) @Janpot
+- [code-infra] Enable undefined addition to optional properties (#47750) @brijeshb42
+- [code-infra] Exclusively enable test mode in jsdom (#47812) @Janpot
+- [code-infra] Fix console.warn during test (#47802) @Janpot
+- [code-infra] Remove vale as a workspace dependency (#47860) @brijeshb42
+- [code-infra] Setup flat build for packages (#47670) @brijeshb42
+- [code-infra] Upgrade react-docgen to v8 (#47685) @JCQuintas
+- [docs-infra] Reapply Cookie Banner with Design Fixes (#47744) @dav-is
+- [internal] Remove legacy MUI Base API docs (#47804) @ZeeshanTamboli
+
+All contributors of this release in alphabetical order: @alexfauquette, @brijeshb42, @DanailH, @dav-is, @Janpot, @JCQuintas, @matthias-ccri, @oliviertassinari, @pavan-sh, @PeterTYLiu, @silviuaavram, @siriwatknp, @ZeeshanTamboli
+
 ## 9.0.0-alpha.0
 
 <!-- generated comparing v7.3.8..master -->

package/codemod.js

@@ -1,26 +1,20 @@
 #!/usr/bin/env node
+"use strict";
 
 const childProcess = require('child_process');
-const { promises: fs } = require('fs');
+const {
+  promises: fs
+} = require('fs');
 const path = require('path');
 const yargs = require('yargs');
 const jscodeshiftPackage = require('jscodeshift/package.json');
 const postcssCliPackage = require('postcss-cli/package.json');
-
 const jscodeshiftDirectory = path.dirname(require.resolve('jscodeshift'));
 const jscodeshiftExecutable = path.join(jscodeshiftDirectory, jscodeshiftPackage.bin.jscodeshift);
-
 const postcssCliDirectory = path.dirname(require.resolve('postcss-cli'));
 const postcssExecutable = path.join(postcssCliDirectory, postcssCliPackage.bin.postcss);
-
 async function runJscodeshiftTransform(transform, files, flags, codemodFlags) {
-  const paths = [
-    path.resolve(__dirname, './src', `${transform}/index.js`),
-    path.resolve(__dirname, './src', `${transform}.js`),
-    path.resolve(__dirname, './', `${transform}/index.js`),
-    path.resolve(__dirname, './', `${transform}.js`),
-  ];
-
+  const paths = [path.resolve(__dirname, './src', `${transform}/index.js`), path.resolve(__dirname, './src', `${transform}.js`), path.resolve(__dirname, './', `${transform}/index.js`), path.resolve(__dirname, './', `${transform}.js`)];
   let transformerPath;
   let error;
   for (const item of paths) {
@@ -35,35 +29,15 @@ async function runJscodeshiftTransform(transform, files, flags, codemodFlags) {
       continue;
     }
   }
-
   if (error) {
     if (error?.code === 'ENOENT') {
-      throw new Error(
-        `Transform '${transform}' not found. Check out ${path.resolve(
-          __dirname,
-          './README.md for a list of available codemods.',
-        )}`,
-      );
+      throw new Error(`Transform '${transform}' not found. Check out ${path.resolve(__dirname, './README.md for a list of available codemods.')}`);
     }
     throw error;
   }
-
   const args = [
-    // can't directly spawn `jscodeshiftExecutable` due to https://github.com/facebook/jscodeshift/issues/424
-    jscodeshiftExecutable,
-    '--transform',
-    transformerPath,
-    ...codemodFlags,
-    '--extensions',
-    'js,ts,jsx,tsx,json',
-    '--parser',
-    flags.parser || 'tsx',
-    '--ignore-pattern',
-    '**/node_modules/**',
-    '--ignore-pattern',
-    '**/*.css',
-  ];
-
+  // can't directly spawn `jscodeshiftExecutable` due to https://github.com/facebook/jscodeshift/issues/424
+  jscodeshiftExecutable, '--transform', transformerPath, ...codemodFlags, '--extensions', 'js,ts,jsx,tsx,json', '--parser', flags.parser || 'tsx', '--ignore-pattern', '**/node_modules/**', '--ignore-pattern', '**/*.css'];
   if (flags.dry) {
     args.push('--dry');
   }
@@ -76,43 +50,33 @@ async function runJscodeshiftTransform(transform, files, flags, codemodFlags) {
   if (flags.packageName) {
     args.push(`--packageName=${flags.packageName}`);
   }
-
   args.push(...files);
 
   // eslint-disable-next-line no-console -- debug information
   console.log(`Executing command: jscodeshift ${args.join(' ')}`);
-  const jscodeshiftProcess = childProcess.spawnSync('node', args, { stdio: 'inherit' });
-
+  const jscodeshiftProcess = childProcess.spawnSync('node', args, {
+    stdio: 'inherit'
+  });
   if (jscodeshiftProcess.error) {
     throw jscodeshiftProcess.error;
   }
 }
-
-const parseCssFilePaths = async (files) => {
-  const cssFiles = await Promise.all(
-    files.map(async (filePath) => {
-      const stat = await fs.stat(filePath);
-      if (stat.isDirectory()) {
-        return `${filePath}/**/*.css`;
-      }
-      if (filePath.endsWith('.css')) {
-        return filePath;
-      }
-
-      return null;
-    }),
-  );
-
+const parseCssFilePaths = async files => {
+  const cssFiles = await Promise.all(files.map(async filePath => {
+    const stat = await fs.stat(filePath);
+    if (stat.isDirectory()) {
+      return `${filePath}/**/*.css`;
+    }
+    if (filePath.endsWith('.css')) {
+      return filePath;
+    }
+    return null;
+  }));
   return cssFiles.filter(Boolean);
 };
-
 async function runPostcssTransform(transform, files) {
   // local postcss plugins are loaded through config files https://github.com/postcss/postcss-load-config/issues/17#issuecomment-253125559
-  const paths = [
-    path.resolve(__dirname, './src', `${transform}/postcss.config.js`),
-    path.resolve(__dirname, './', `${transform}/postcss.config.js`),
-  ];
-
+  const paths = [path.resolve(__dirname, './src', `${transform}/postcss.config.js`), path.resolve(__dirname, './', `${transform}/postcss.config.js`)];
   let configPath;
   let error;
   for (const item of paths) {
@@ -127,7 +91,6 @@ async function runPostcssTransform(transform, files) {
       continue;
     }
   }
-
   if (error) {
     // don't throw if the file is not found, postcss transform is optional
     if (error?.code !== 'ENOENT') {
@@ -135,81 +98,62 @@ async function runPostcssTransform(transform, files) {
     }
   } else {
     const cssPaths = await parseCssFilePaths(files);
-
     if (cssPaths.length > 0) {
-      const args = [
-        postcssExecutable,
-        ...cssPaths,
-        '--config',
-        configPath,
-        '--replace',
-        '--verbose',
-      ];
+      const args = [postcssExecutable, ...cssPaths, '--config', configPath, '--replace', '--verbose'];
 
       // eslint-disable-next-line no-console -- debug information
       console.log(`Executing command: postcss ${args.join(' ')}`);
-      const postcssProcess = childProcess.spawnSync('node', args, { stdio: 'inherit' });
-
+      const postcssProcess = childProcess.spawnSync('node', args, {
+        stdio: 'inherit'
+      });
       if (postcssProcess.error) {
         throw postcssProcess.error;
       }
     }
   }
 }
-
 function run(argv) {
-  const { codemod, paths, ...flags } = argv;
-  const files = paths.map((filePath) => path.resolve(filePath));
-
+  const {
+    codemod,
+    paths,
+    ...flags
+  } = argv;
+  const files = paths.map(filePath => path.resolve(filePath));
   runJscodeshiftTransform(codemod, files, flags, argv._);
   runPostcssTransform(codemod, files);
 }
-
-yargs
-  .command({
-    command: '$0 <codemod> <paths...>',
-    describe: 'Applies a `@mui/codemod` to the specified paths',
-    builder: (command) => {
-      return command
-        .positional('codemod', {
-          description: 'The name of the codemod',
-          type: 'string',
-        })
-        .positional('paths', {
-          array: true,
-          description: 'Paths forwarded to `jscodeshift`',
-          type: 'string',
-        })
-        .option('dry', {
-          description: 'dry run (no changes are made to files)',
-          default: false,
-          type: 'boolean',
-        })
-        .option('parser', {
-          description: 'which parser for jscodeshift to use',
-          default: 'tsx',
-          type: 'string',
-        })
-        .option('print', {
-          description: 'print transformed files to stdout, useful for development',
-          default: false,
-          type: 'boolean',
-        })
-        .option('jscodeshift', {
-          description: '(Advanced) Pass options directly to jscodeshift',
-          default: false,
-          type: 'string',
-        })
-        .option('packageName', {
-          description: 'The package name to look for in the import statements',
-          default: '@mui/material',
-          type: 'string',
-        });
-    },
-    handler: run,
-  })
-  .scriptName('npx @mui/codemod')
-  .example('$0 v4.0.0/theme-spacing-api src')
-  .example('$0 v5.0.0/component-rename-prop src -- --component=Grid --from=prop --to=newProp')
-  .help()
-  .parse();
+yargs.command({
+  command: '$0 <codemod> <paths...>',
+  describe: 'Applies a `@mui/codemod` to the specified paths',
+  builder: command => {
+    return command.positional('codemod', {
+      description: 'The name of the codemod',
+      type: 'string'
+    }).positional('paths', {
+      array: true,
+      description: 'Paths forwarded to `jscodeshift`',
+      type: 'string'
+    }).option('dry', {
+      description: 'dry run (no changes are made to files)',
+      default: false,
+      type: 'boolean'
+    }).option('parser', {
+      description: 'which parser for jscodeshift to use',
+      default: 'tsx',
+      type: 'string'
+    }).option('print', {
+      description: 'print transformed files to stdout, useful for development',
+      default: false,
+      type: 'boolean'
+    }).option('jscodeshift', {
+      description: '(Advanced) Pass options directly to jscodeshift',
+      default: false,
+      type: 'string'
+    }).option('packageName', {
+      description: 'The package name to look for in the import statements',
+      default: '@mui/material',
+      type: 'string'
+    });
+  },
+  handler: run
+}).scriptName('npx @mui/codemod').example('$0 v4.0.0/theme-spacing-api src').example('$0 v5.0.0/component-rename-prop src -- --component=Grid --from=prop --to=newProp').help().parse();

package/package.json

@@ -1,9 +1,8 @@
 {
   "name": "@mui/codemod",
-  "version": "9.0.0-alpha.0",
+  "version": "9.0.0-alpha.1",
   "author": "MUI Team",
   "description": "Codemod scripts for Material UI.",
-  "bin": "./codemod.js",
   "keywords": [
     "react",
     "react-component",
@@ -23,9 +22,10 @@
     "url": "https://opencollective.com/mui-org"
   },
   "dependencies": {
-    "@babel/core": "^7.28.6",
+    "@babel/core": "^7.29.0",
     "@babel/runtime": "^7.28.6",
-    "@babel/traverse": "^7.28.6",
+    "@babel/traverse": "^7.29.0",
+    "@mui/material-v5": "npm:@mui/material@5.18.0",
     "jscodeshift": "^17.1.2",
     "jscodeshift-add-imports": "^1.0.11",
     "postcss": "^8.5.6",
@@ -42,5 +42,6 @@
   "type": "commonjs",
   "exports": {
     "./package.json": "./package.json"
-  }
+  },
+  "bin": "./codemod.js"
 }

package/v5.0.0/path-imports.js

@@ -6,11 +6,6 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = transformer;
 var _jscodeshiftAddImports = _interopRequireDefault(require("jscodeshift-add-imports"));
-// istanbul ignore next
-if (globalThis.MUI_TEST_ENV) {
-  const resolve = require.resolve;
-  require.resolve = source => resolve(source.replace(/^@mui\/material\/modern/, '../../../mui-material/src'));
-}
 const barrelImportsToTransform = {
   material: {},
   'icons-material': {}

package/v5.0.0/top-level-imports.js

@@ -12,11 +12,7 @@ function transformer(fileInfo, api, options) {
   const j = api.jscodeshift;
   const importModule = options.importModule || '@mui/material';
   const targetModule = options.targetModule || '@mui/material';
-  let resolveModule = importModule;
-  if (globalThis.MUI_TEST_ENV) {
-    resolveModule = resolveModule.replace(/^@mui\/material/, '@mui/material-v5');
-  }
-  const whitelist = (0, _getJSExports.default)(require.resolve(`${resolveModule}/modern`, {
+  const whitelist = (0, _getJSExports.default)(require.resolve(`@mui/material-v5/modern`, {
     paths: [(0, _path.dirname)(fileInfo.path)]
   }));
   const printOptions = options.printOptions || {