peerDependencies oxc-transform-react range (^0.145.0) is out of date, breaks npm install after oxc-transform-react@0.147.0

[rakleed]

Related plugins

• plugin-react

• plugin-react-swc

• plugin-rsc

Describe the bug

The published @vitejs/plugin-react@6.1.0 declares:

"peerDependencies": {
  "oxc-transform-react": "^0.145.0"
}

oxc-transform-react has since been published at 0.147.0 on npm (https://www.npmjs.com/package/oxc-transform-react). Installing a project that has oxc-transform-react@^0.147.0 in its own dependencies together with @vitejs/plugin-react@6.1.0 now fails with ERESOLVE, because npm's default resolver won't satisfy a peer range of ^0.145.0 with 0.147.0 installed.

This is the same class of issue as #1144 (stale @rolldown/plugin-babel peer range).

Reproduction

https://stackblitz.com/edit/vitejs-vite-rudrnkqt?file=package.json

Steps to reproduce

1. Open the reproduction link
2. Open the terminal and run: npm install

System Info

System:
    OS: macOS 26.6.2
    CPU: (12) arm64 Apple M3 Pro
    Memory: 637.84 MB / 36.00 GB
    Shell: 5.9 - /bin/zsh
  Binaries:
    Node: 24.19.0 - /opt/homebrew/opt/node@24/bin/node
    npm: 11.17.0 - /opt/homebrew/opt/node@24/bin/npm
    bun: 1.4.0 - /opt/homebrew/bin/bun
  Browsers:
    Chrome: 152.0.7977.65
    Safari: 26.6.2
  npmPackages:
    @vitejs/plugin-react: ^6.1.0 => 6.1.0
    oxc-transform-react: ^0.147.0 => 0.147.0
    vite: ^8.2.2 => 8.2.2

Used Package Manager

npm

Logs

No response

Validations

• Follow our Code of Conduct
• Read the Contributing Guidelines.
• Read the docs.
• Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.
• Make sure this is a Vite issue and not a framework-specific issue.
• Check that this is a concrete bug. For Q&A open a GitHub Discussion or join our Discord Chat Server.
• The provided reproduction is a minimal reproducible example of the bug.

[ArnaudBarre]

@sapphi-red I think we should have it as a dependency and then later rolldown can drop fast refresh from core?

[sapphi-red]

I'm a bit hesitant to do so given that the react compiler feature and the package is still experimental.

[sapphi-red]

refs oxc-project/oxc#26033

[ArnaudBarre]

Should we use =>0.145.0 in the range in the meantime?

[sapphi-red]

I think it depends on how Oxc will maintain the compat. Maybe like >=0.145.0,<0.150.0 so that Oxc can still introduce breaking changes in once a 5 version 🤔

[ArnaudBarre]

@Boshen any opinion on this?

[piotr-cz]

For the time being, such override in package.json should fix it:

{
  "overrides": {
    "@babel/plugin-transform-runtime": "^7.29.7"
  }
}

[nstepien]

TBH it is an experimental package so I think it's fine to allow a broader range and expect breaking changes 🤷‍♂️

"peerDependencies": {
  "oxc-transform-react": "<1.0.0"
}