feat: state-preserving HMR and hot data revalidation in classic dev

.changeset/align-refresh-registration-backfill.md

@@ -0,0 +1,8 @@
+---
+'rsbuild-plugin-react-router': patch
+---
+
+Align the Fast Refresh registration backfill with react-refresh's own
+component-detection rules so `memo`/`forwardRef` components in pre-lowered
+(MDX) routes register for HMR. Multi-declarator lists, curried arrows, and
+require/import interop callees no longer produce false registrations.

.changeset/classic-dev-hmr.md

@@ -0,0 +1,5 @@
+---
+'rsbuild-plugin-react-router': minor
+---
+
+Add state-preserving Hot Module Replacement for route modules in development: route updates now apply React Refresh registration and in-place route patching instead of triggering a full page reload. Server code changes also trigger hot data revalidation, so loader data refreshes without a reload. This degrades gracefully to the previous full-reload behavior when `@rsbuild/plugin-react` isn't present or Fast Refresh is disabled.

.gitignore

@@ -8,9 +8,11 @@ build
 .unpack-cache/
 .codex/
 .tracedecay/
+.cursor/
 .benchmark/
 task/upstream/
 task/output/
+tests/react-router-framework/.tmp/
 
 # Example build outputs
 **/build/

src/build-output-transforms.ts

@@ -39,6 +39,7 @@ type RegisterBuildOutputTransformsOptions = {
   ssr: boolean;
   isSpaMode: boolean;
   rootRoutePath: string;
+  isDevHmrEnabled?: () => boolean;
 };
 
 export const registerBuildOutputTransforms = ({
@@ -61,6 +62,7 @@ export const registerBuildOutputTransforms = ({
   ssr,
   isSpaMode,
   rootRoutePath,
+  isDevHmrEnabled = () => false,
 }: RegisterBuildOutputTransformsOptions): void => {
   const transformRouteModule = async (args: Parameters<TransformHandler>[0]) =>
     performanceProfiler.record(
@@ -81,6 +83,7 @@ export const registerBuildOutputTransforms = ({
           isBuild,
           isSpaMode,
           rootRoutePath,
+          devHmr: isDevHmrEnabled(),
         })
     );
 
@@ -158,6 +161,8 @@ export const registerBuildOutputTransforms = ({
             environmentName: args.environment?.name,
             isBuild,
             routeChunkConfig,
+            routeId: routeByFilePath.get(args.resourcePath)?.id,
+            devHmr: isDevHmrEnabled(),
           })
       )
   );