[material-ui] npm install fails when "@mui/material" set to "latest" and no specific React version

[DiegoAndai]

Steps to reproduce

Steps:

1. Open this link to live example: https://stackblitz.com/edit/vitejs-vite-qtsu7a5s?file=index.html,package.json&terminal=dev
2. Run npm install

Current behavior

There's two ways of reproing. The one on the live example is having:

  "dependencies": {
    "@mui/material": "latest"
  }

The other one is having

  "dependencies": {
    "@mui/material": "latest",
    "react": "latest",
    "react-dom": "latest"
  }

Expected behavior

It should successfully install.

The error doesn't happen when specifying the react version:

  "dependencies": {
    "@mui/material": "latest",
    "react": "^19.0.0",
    "react-dom": "^19.0.0"
  }

or

  "dependencies": {
    "@mui/material": "latest",
    "react": "^18.0.0",
    "react-dom": "^18.0.0"
  }

Your environment

npx @mui/envinfo

  System:
    OS: Linux 5.0 undefined
  Binaries:
    Node: 18.20.3 - /usr/local/bin/node
    npm: 10.2.3 - /usr/local/bin/npm
    pnpm: 8.15.6 - /usr/local/bin/pnpm
  Browsers:
    Chrome: Not Found

Search keywords: npm install react ERESOLVE

[DiegoAndai]

This is due to npm install always installing peer dependencies, and:

• @mui/material-pigment-css is a peer dependency of @mui/material
• @pigment-css/react is a dependency of @mui/material-pigment-css, currently set at version 0.0.28
• This version specifies a version for "react" only, and not "react-dom": https://github.com/mui/pigment-css/blob/fc72565beeb9a55c1494b3a2f6ed2bebbda4bb50/packages/pigment-css-react/package.json#L76

Because of this, "react-dom" resolves to latest (19) but "react" resolves to 18, causing the mismatch.

Updating our dependency to @pigment-css/[email protected] should fix it.

[github-actions]

This issue has been closed. If you have a similar problem but not exactly the same, please open a new issue.
Now, if you have additional information related to this issue or things that could help future readers, feel free to leave a comment.