fix: prefer using Rspack/Rsbuild v2 config (#470)

* chore(deps): upgrade Rsbuild/Rspack to 2.0.0-rc.2

- Bump `@rsbuild/core` devDependencies to `^2.0.0-rc.2` across all packages
- Bump sandbox plugins to Rsbuild v2 compatible versions:
  - `@rsbuild/plugin-react` → `^2.0.0-rc.2`
  - `@rsbuild/plugin-vue` → `^2.0.0-alpha.3`
  - `@rsbuild/plugin-sass` → `^2.0.0-alpha.3`
  - `@rsbuild/plugin-babel` → `^2.0.0-alpha.3`
  - `@rspack/core` / `@rspack/cli` → `^2.0.0-rc.2`
  - `@rspack/plugin-react-refresh` → `^2.0.0`
- Migrate `performance.chunkSplit` to top-level `splitChunks` for Rsbuild v2,
  with runtime version detection to preserve Rsbuild v1 compatibility
- Add `// Rspack v1 compatible:` comments to all v1 compat code paths
- All peerDependencies remain `^1.5.0 || ^2.0.0-0` (no major version bump)

* fix(addon-modernjs): cast RsbuildConfig to align cross-package types

Modern.js internally resolves a different version of @rsbuild/core,
causing RsbuildConfig type mismatch with mergeRsbuildConfig.

* fix: revert incompatible sandbox plugin versions

- Keep `performance.chunkSplit` for both v1 and v2 since
  `@rsbuild/plugin-vue@2.0.0-alpha.3` still reads `chunkSplit.strategy`
- Revert `@rsbuild/plugin-sass` to `^1.5.1` in rslib sandboxes (v2 alpha
  has breaking changes with sass module resolution)
- Revert `@rspack/plugin-react-refresh` to `^1.6.1` (v2 is ESM-only,
  incompatible with CJS rspack config)

* fix(sandboxes): migrate rspack config to ESM and fix plugin compat

- Convert `rspack.config.cjs` to `rspack.config.mjs` for
  `@rspack/plugin-react-refresh@2.0.0` ESM compatibility
- Use named export `ReactRefreshRspackPlugin` (v2 dropped default export)
- Keep `@rsbuild/plugin-sass@^1.5.1` in rslib sandboxes since
  `@rsbuild/plugin-sass@2.0.0-alpha.3` is too old for `@rsbuild/core@rc.2`

* fix(builder-rsbuild): use rspackVersion for version detection, drop splitChunks

- Use `rspack.rspackVersion` instead of `rspack.version` for major
  version detection. `rspack.version` returns the webpack-compat version
  (5.75.0), not the actual Rspack version.
- Remove top-level `splitChunks` config to avoid overriding user-provided
  `performance.chunkSplit` settings from rsbuild.config. When both are
  present, Rsbuild v2 ignores `performance.chunkSplit` entirely.
- Keep using `performance.chunkSplit` only, which is deprecated but still
  functional in Rsbuild v2, preserving v1 compatibility.

* fix(builder-rsbuild): use v1/v2 conditional splitChunks and revert plugin-vue

- Use rspackMajorVersion to conditionally apply `performance.chunkSplit` (v1)
  or top-level `splitChunks` (v2) instead of deprecated-but-functional fallback.
- Revert `@rsbuild/plugin-vue` to 1.2.7 in vue3/lit/rslib-vue3 sandboxes
  because alpha.3 crashes when `performance.chunkSplit` is absent in v2 branch.

Author: fi3ework

packages/addon-modernjs/package.json

@@ -48,7 +48,7 @@
   "devDependencies": {
     "@modern-js/app-tools": "^3.1.2",
     "@modern-js/plugin": "^3.1.2",
-    "@rsbuild/core": "^2.0.0-rc.0",
+    "@rsbuild/core": "^2.0.0-rc.2",
     "@types/node": "^22.0.0",
     "storybook": "10.3.5",
     "storybook-builder-rsbuild": "workspace:*",

packages/addon-modernjs/src/preset.ts

@@ -5,7 +5,7 @@ import {
   parseRspackConfig as parseToRsbuildConfig,
 } from '@modern-js/app-tools/builder'
 // TODO: better import from `@modern-js/app-tools/builder`
-import { mergeRsbuildConfig } from '@rsbuild/core'
+import { mergeRsbuildConfig, type RsbuildConfig } from '@rsbuild/core'
 import findUp from 'find-up'
 import { logger } from 'rslog'
 import type {
@@ -124,6 +124,7 @@ export const rsbuildFinal: StorybookConfigRsbuild['rsbuildFinal'] = async (
     builderPluginAdapterHooks(adapterParams),
   ]
 
-  const finalConfig = mergeRsbuildConfig(config, rsbuildConfig)
+  // Modern.js may resolve a different version of @rsbuild/core, cast to align types.
+  const finalConfig = mergeRsbuildConfig(config, rsbuildConfig as RsbuildConfig)
   return finalConfig
 }

packages/addon-rslib/package.json

@@ -42,7 +42,7 @@
     "prepare": "pnpm run build"
   },
   "devDependencies": {
-    "@rsbuild/core": "^2.0.0-rc.0",
+    "@rsbuild/core": "^2.0.0-rc.2",
     "@rslib/core": "^0.20.3",
     "@types/node": "^22.0.0",
     "storybook": "10.3.5",

packages/builder-rsbuild/package.json

@@ -69,7 +69,7 @@
     "util-deprecate": "^1.0.2"
   },
   "devDependencies": {
-    "@rsbuild/core": "^2.0.0-rc.0",
+    "@rsbuild/core": "^2.0.0-rc.2",
     "@storybook/core-webpack": "10.3.5",
     "@types/fs-extra": "^11.0.4",
     "@types/node": "^22.0.0",

packages/builder-rsbuild/src/plugins/rspack-inject-mocker-runtime-plugin.ts

@@ -8,6 +8,7 @@ export class RspackInjectMockerRuntimePlugin {
     compiler: Rspack.Compiler,
   ): typeof HtmlRspackPlugin | null {
     try {
+      // Rspack v1 compatible: check for both `HtmlRspackPlugin` (v2) and `HtmlWebpackPlugin` (v1) names.
       const pluginConstructor = compiler.options.plugins?.find((plugin) => {
         const name = plugin?.constructor?.name
         return name === 'HtmlRspackPlugin' || name === 'HtmlWebpackPlugin'

packages/builder-rsbuild/src/preview/iframe-rsbuild.config.ts

@@ -2,7 +2,7 @@ import { createRequire } from 'node:module'
 import { dirname, join, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import type { RsbuildConfig, Rspack } from '@rsbuild/core'
-import { loadConfig, mergeRsbuildConfig } from '@rsbuild/core'
+import { loadConfig, mergeRsbuildConfig, rspack } from '@rsbuild/core'
 import { pluginTypeCheck } from '@rsbuild/plugin-type-check'
 // @ts-expect-error (I removed this on purpose, because it's incorrect)
 import CaseSensitivePathsPlugin from 'case-sensitive-paths-webpack-plugin'
@@ -61,6 +61,8 @@ const getRspackMajorVersion = (version: unknown): number | null => {
   return Number.isNaN(major) ? null : major
 }
 
+const rspackMajorVersion = getRspackMajorVersion(rspack.rspackVersion)
+
 /** @see https://github.com/web-infra-dev/rsbuild/blob/d8204bb72b5dd32dc736372dff6bb618675a4ad5/packages/core/src/constants.ts#L61 */
 const RAW_QUERY_REGEX = /[?&]raw(?:&|=|$)/
 
@@ -281,15 +283,28 @@ export default async (
         NODE_ENV: JSON.stringify(process.env.NODE_ENV),
       },
     },
-    performance: {
-      chunkSplit: {
-        strategy: 'custom',
-        splitChunks: {
-          chunks: 'all',
-        },
-      },
-      buildCache: cacheConfig,
-    },
+    // Rsbuild v1 compatible: `performance.chunkSplit` is deprecated in Rsbuild v2, use top-level `splitChunks` instead.
+    ...(rspackMajorVersion === 1
+      ? {
+          performance: {
+            chunkSplit: {
+              strategy: 'custom' as const,
+              splitChunks: {
+                chunks: 'all' as const,
+              },
+            },
+            buildCache: cacheConfig,
+          },
+        }
+      : {
+          splitChunks: {
+            preset: 'none' as const,
+            chunks: 'all' as const,
+          },
+          performance: {
+            buildCache: cacheConfig,
+          },
+        }),
     plugins: [
       shouldCheckTs ? pluginTypeCheck(tsCheckOptions) : null,
       pluginHtmlMinifierTerser(() => ({
@@ -394,7 +409,7 @@ export default async (
           ].filter(Boolean),
         )
 
-        const rspackMajorVersion = getRspackMajorVersion(rspack.version)
+        // Rspack v1 compatible: disable `outputModule` experiment which is not supported in Rspack v1.
         if (rspackMajorVersion === 1) {
           const experiments = (config.experiments ??= {}) as Record<
             string,

packages/framework-html/package.json

@@ -55,7 +55,7 @@
     "tsconfig-paths": "^4.2.0"
   },
   "devDependencies": {
-    "@rsbuild/core": "^2.0.0-rc.0",
+    "@rsbuild/core": "^2.0.0-rc.2",
     "@types/node": "^22.0.0",
     "@types/resolve": "^1.20.6",
     "storybook": "10.3.5",

packages/framework-react-native-web/package.json

@@ -53,7 +53,7 @@
     "storybook-react-rsbuild": "workspace:*"
   },
   "devDependencies": {
-    "@rsbuild/core": "^2.0.0-rc.0",
+    "@rsbuild/core": "^2.0.0-rc.2",
     "@types/node": "^22.0.0",
     "@types/react": "^18.3.28",
     "react": "18.3.1",

packages/framework-react/package.json

@@ -64,7 +64,7 @@
     "tsconfig-paths": "^4.2.0"
   },
   "devDependencies": {
-    "@rsbuild/core": "^2.0.0-rc.0",
+    "@rsbuild/core": "^2.0.0-rc.2",
     "@types/node": "^22.0.0",
     "@types/react": "^18.3.28",
     "@types/resolve": "^1.20.6",

packages/framework-vue3/package.json

@@ -51,7 +51,7 @@
     "vue-docgen-loader": "^2.0.1"
   },
   "devDependencies": {
-    "@rsbuild/core": "^2.0.0-rc.0",
+    "@rsbuild/core": "^2.0.0-rc.2",
     "@types/node": "^22.0.0",
     "storybook": "10.3.5",
     "typescript": "^5.9.3",