@@ -0,0 +1,15 @@
+---
+"@callstack/repack": minor
+---
+
+Add support for Rspack 2 while keeping Rspack 1 fully working.
+
+Re.Pack now detects the installed `@rspack/core` major version and adapts:
+
+- `experiments.parallelLoader` is only set under Rspack 1 (removed in Rspack 2)
+- `module.parser.javascript.exportsPresence` defaults to `'auto'` under Rspack 2 to keep Metro-like tolerance for invalid imports inside node_modules (overridable in your project config)
+- persistent cache configuration is read from both the Rspack 1 (`experiments.cache`) and Rspack 2 (top-level `cache`) locations; a legacy `experiments.cache` value is automatically applied to `cache` under Rspack 2 (with a warning), preventing silent loss of caching
+- React Refresh: under Rspack 2 Re.Pack applies the official `@rspack/plugin-react-refresh` v2 plugin (now an optional peer dependency - install it alongside `@rspack/core@2`); under Rspack 1 and webpack the client runtime files are bundled with Re.Pack, so the `@rspack/plugin-react-refresh@1` dependency is gone
+- `--trace-*` profiling defaults to the `logger` trace layer under Rspack 2 (published Rspack 2 binaries do not include the perfetto layer)
+- a clear error is raised when running Rspack 2 on Node.js older than 20.19 (Rspack 2 requires Node `^20.19.0 || >=22.12.0`)
+- `ModuleFederationPluginV1` verifies that `@module-federation/runtime-tools` is installed when running under Rspack 2 (it is no longer installed automatically by `@rspack/core`)
@@ -1,8 +1,10 @@
 # Rspack 2.0 Support — Research & Planning
 
-> Status: **Research complete — all decisions made (Q1–Q5 in doc 04, React Refresh in
-> doc 06) and the V1–V11 verification checklist executed against 2.1.2 with no blockers
-> (doc 07). Ready for implementation.**
+> Status: **Implemented on this branch** — core dual-version support (plan phases 0–2)
+> is in `packages/repack`; all decisions recorded (Q1–Q5 in doc 04, React Refresh in
+> doc 06), V1–V11 verification executed with no blockers (doc 07).
+> Remaining follow-ups: CI matrix + tester-app/metro-compat validation under v2 (phase 3)
+> and flipping init/templates/website defaults to v2 (phase 4).
 > Branch: `feat/rspack-2-support`
 > Last updated: 2026-07-02
 
 
@@ -2,8 +2,9 @@ module.exports = {
   clearMocks: true,
   moduleNameMapper: {
     '^(\\.{1,2}/.*)\\.js$': '$1',
+    '^@rspack/core$': '<rootDir>/jest.rspack-core-bridge.js',
   },
   setupFiles: ['./jest.setup.js'],
-  testEnvironment: 'node',
+  testEnvironment: '<rootDir>/jest.environment.js',
   testMatch: ['**/__tests__/**/*.ts?(x)'],
 };
@@ -0,0 +1,20 @@
+const { TestEnvironment: NodeEnvironment } = require('jest-environment-node');
+
+/**
+ * @rspack/core v2 is published as a pure ESM package, which Jest's sandboxed
+ * CJS module runtime cannot load (even `createRequire` inside the sandbox is
+ * wrapped by Jest and loops back into the module registry).
+ *
+ * Test environments are loaded outside the Jest sandbox with Node's real
+ * module system, where loading ESM through `require()`/`import()` is
+ * supported. Load @rspack/core here and expose it to the sandbox via a
+ * global - see jest.rspack-core-bridge.js for the consuming side.
+ */
+class RspackCoreEnvironment extends NodeEnvironment {
+  async setup() {
+    await super.setup();
+    this.global.__RSPACK_CORE__ = await import('@rspack/core');
+  }
+}
+
+module.exports = RspackCoreEnvironment;
@@ -0,0 +1,18 @@
+// @rspack/core v2 is published as a pure ESM package, which Jest's sandboxed
+// CJS module runtime cannot load. The real module is loaded natively by the
+// custom test environment (jest.environment.js) and exposed via a global;
+// this bridge maps `require('@rspack/core')` inside tests onto it.
+//
+// The `__esModule` marker keeps Babel's import interop treating this as an
+// ESM-like namespace, so named imports (`import { rspack } from '@rspack/core'`)
+// keep working.
+const core = globalThis.__RSPACK_CORE__;
+
+if (!core) {
+  throw new Error(
+    '@rspack/core was not preloaded by the test environment - ' +
+      'make sure jest.environment.js is set as the testEnvironment'
+  );
+}
+
+module.exports = { __esModule: true, ...core, default: core.default ?? core };
@@ -65,6 +65,7 @@
   "peerDependencies": {
     "@module-federation/enhanced": ">=0.6.10",
     "@rspack/core": ">=1",
+    "@rspack/plugin-react-refresh": "^2.0.0",
     "react-native": ">=0.74",
     "webpack": ">=5.90"
   },
@@ -75,14 +76,16 @@
     "@rspack/core": {
       "optional": true
     },
+    "@rspack/plugin-react-refresh": {
+      "optional": true
+    },
     "webpack": {
       "optional": true
     }
   },
   "dependencies": {
     "@callstack/repack-dev-server": "workspace:*",
     "@discoveryjs/json-ext": "^0.5.7",
-    "@rspack/plugin-react-refresh": "1.0.0",
     "babel-loader": "^9.2.1",
     "colorette": "^2.0.20",
     "dedent": "^0.7.0",
@@ -113,8 +116,9 @@
     "@babel/plugin-transform-modules-commonjs": "^7.23.2",
     "@module-federation/enhanced": "0.8.9",
     "@module-federation/sdk": "0.6.10",
-    "@rspack/core": "catalog:",
-    "@swc/helpers": "catalog:",
+    "@rspack/core": "^2.1.2",
+    "@rspack/plugin-react-refresh": "^2.0.2",
+    "@swc/helpers": "^0.5.23",
     "@types/babel__core": "^7.20.5",
     "@types/dedent": "^0.7.0",
     "@types/gradient-string": "^1.1.6",
 
@@ -1,21 +1,45 @@
+import { getRspackMajorVersion } from '../../../helpers/index.js';
 import { getMinimizerConfig } from './getMinimizerConfig.js';
 
-function getExperimentsConfig(bundler: 'rspack' | 'webpack') {
+function getExperimentsConfig(bundler: 'rspack' | 'webpack', rootDir: string) {
   if (bundler === 'rspack') {
-    return { parallelLoader: true };
+    const rspackMajor = getRspackMajorVersion(rootDir) ?? 1;
+    if (rspackMajor < 2) {
+      return { parallelLoader: true };
+    }
+    // Rspack 2 removed `experiments.parallelLoader` (parallel loading is
+    // stable and opt-in per rule via `use[].parallel`) - nothing to set.
+  }
+}
+
+function getModuleConfig(bundler: 'rspack' | 'webpack', rootDir: string) {
+  if (bundler === 'rspack') {
+    const rspackMajor = getRspackMajorVersion(rootDir) ?? 1;
+    if (rspackMajor >= 2) {
+      // Rspack 2 changed the `exportsPresence` default from 'warn' to 'error',
+      // which breaks builds on invalid imports inside node_modules - a common
+      // occurrence in the React Native ecosystem that Metro tolerates.
+      // Restore Metro-like leniency by default; users can override this
+      // in their project config.
+      return {
+        parser: { javascript: { exportsPresence: 'auto' as const } },
+      };
+    }
   }
 }
 
 export async function getRepackConfig(
   bundler: 'rspack' | 'webpack',
   rootDir: string
 ) {
-  const experiments = getExperimentsConfig(bundler);
+  const experiments = getExperimentsConfig(bundler, rootDir);
+  const moduleConfiguration = getModuleConfig(bundler, rootDir);
   const minimizerConfiguration = await getMinimizerConfig(bundler, rootDir);
 
   return {
     devtool: 'source-map',
     experiments,
+    module: moduleConfiguration,
     output: {
       clean: true,
       hashFunction: 'xxhash64',
 
@@ -1,9 +1,11 @@
 import { merge } from 'webpack-merge';
+import { isRspack2 } from '../../../helpers/index.js';
 import type {
   BundleArguments,
   ConfigurationObject,
   StartArguments,
 } from '../../types.js';
+import { migrateLegacyRspackCacheConfig } from '../migrateLegacyRspackCacheConfig.js';
 import { getCliOverrides } from './getCliOverrides.js';
 import { getCommandConfig } from './getCommandConfig.js';
 import { getConfigFilePath } from './getConfigFilePath.js';
@@ -70,6 +72,12 @@ export async function makeCompilerConfig<C extends ConfigurationObject>(
     normalizeConfig(config, options.platforms[index])
   );
 
+  // Rspack 2 silently ignores the legacy `experiments.cache` option -
+  // honor it by moving it to the top-level `cache` option & warn the user
+  if (bundler === 'rspack' && isRspack2(rootDir)) {
+    migrateLegacyRspackCacheConfig(normalizedConfigs);
+  }
+
   const plugins = normalizedConfigs.flatMap((config) =>
     'plugins' in config ? config.plugins : []
   );
 
@@ -1,6 +1,7 @@
 export * from './getDevMiddleware.js';
 export * from './getMaxWorkers.js';
 export * from './getMimeType.js';
+export * from './migrateLegacyRspackCacheConfig.js';
 export * from './parseUrl.js';
 export * from './resetPersistentCache.js';
 export * from './resolveProjectPath.js';
 
@@ -0,0 +1,42 @@
+import * as colorette from 'colorette';
+
+interface CacheLikeConfiguration {
+  cache?: unknown;
+  experiments?: { cache?: unknown };
+}
+
+let warningDisplayed = false;
+
+/**
+ * Rspack 2 moved the persistent cache configuration from `experiments.cache`
+ * to the top-level `cache` option. The legacy key is not validated against -
+ * it's silently ignored, which means users migrating a Rspack 1 config would
+ * lose persistent caching without any signal.
+ *
+ * To prevent that, when running Rspack 2 we honor a legacy `experiments.cache`
+ * value by moving it to `cache` (unless `cache` is already set) and warn the
+ * user to update their project config.
+ */
+export function migrateLegacyRspackCacheConfig(configs: object[]) {
+  for (const config of configs as CacheLikeConfiguration[]) {
+    const legacyCacheConfig = config.experiments?.cache;
+    if (legacyCacheConfig === undefined) continue;
+
+    if (config.cache === undefined) {
+      config.cache = legacyCacheConfig;
+    }
+    delete config.experiments?.cache;
+
+    if (!warningDisplayed) {
+      warningDisplayed = true;
+      console.warn(
+        colorette.yellow(
+          "In Rspack 2 'experiments.cache' was moved to the top-level 'cache' option " +
+            'and the legacy key is silently ignored. ' +
+            "Re.Pack applied your 'experiments.cache' value to 'cache' automatically - " +
+            "please update your project config to use the top-level 'cache' option.\n"
+        )
+      );
+    }
+  }
+}