@tanstack/router-plugin 1.167.22 → 1.167.23

package/dist/esm/core/code-splitter/plugins/react-stable-hmr-split-route-components.js

@@ -1,7 +1,6 @@
-import { createHmrHotExpressionAst } from "../../hmr-hot-expression.js";
 import { getUniqueProgramIdentifier } from "../../utils.js";
-import * as template from "@babel/template";
 import * as t from "@babel/types";
+import * as template from "@babel/template";
 //#region src/core/code-splitter/plugins/react-stable-hmr-split-route-components.ts
 function capitalizeIdentifier(str) {
 	return str[0].toUpperCase() + str.slice(1);
@@ -19,6 +18,9 @@ var buildStableSplitComponentStatements = template.statements(`
       ((%%hotExpression%%).data ??= {})[%%hotDataKey%%] = %%stableComponentIdent%%
     }
   `, { syntacticPlaceholders: true });
+function hotExpressionAstFor(hmrStyle) {
+	return template.expression.ast(hmrStyle === "webpack" ? "import.meta.webpackHot" : "import.meta.hot");
+}
 function createReactStableHmrSplitRouteComponentsPlugin(opts) {
 	return {
 		name: "react-stable-hmr-split-route-components",
@@ -29,7 +31,7 @@ function createReactStableHmrSplitRouteComponentsPlugin(opts) {
 			ctx.insertionPath.insertBefore(buildStableSplitComponentStatements({
 				stableComponentIdent,
 				hotDataKey: t.stringLiteral(hotDataKey),
-				hotExpression: createHmrHotExpressionAst(opts?.hotExpression ?? ctx.opts.hmrHotExpression),
+				hotExpression: hotExpressionAstFor(opts.hmrStyle),
 				lazyRouteComponentIdent: t.identifier(ctx.lazyRouteComponentIdent),
 				localImporterIdent: t.identifier(ctx.splitNodeMeta.localImporterIdent),
 				exporterIdent: t.stringLiteral(ctx.splitNodeMeta.exporterIdent)

package/dist/esm/core/code-splitter/plugins/react-stable-hmr-split-route-components.js.map

@@ -1 +1 @@
-{"version":3,"file":"react-stable-hmr-split-route-components.js","names":[],"sources":["../../../../../src/core/code-splitter/plugins/react-stable-hmr-split-route-components.ts"],"sourcesContent":["import * as template from '@babel/template'\nimport * as t from '@babel/types'\nimport { createHmrHotExpressionAst } from '../../hmr-hot-expression'\nimport { getUniqueProgramIdentifier } from '../../utils'\nimport type { ReferenceRouteCompilerPlugin } from '../plugins'\n\nfunction capitalizeIdentifier(str: string) {\n  return str[0]!.toUpperCase() + str.slice(1)\n}\n\nfunction createHotDataKey(exportName: string) {\n  return `tsr-split-component:${exportName}`\n}\n\nconst buildStableSplitComponentStatements = template.statements(\n  `\n    const %%stableComponentIdent%% = (() => {\n      const hot = %%hotExpression%%\n      const hotData = hot ? (hot.data ??= {}) : undefined\n      return hotData?.[%%hotDataKey%%] ?? %%lazyRouteComponentIdent%%(%%localImporterIdent%%, %%exporterIdent%%)\n    })()\n    if (%%hotExpression%%) {\n      ((%%hotExpression%%).data ??= {})[%%hotDataKey%%] = %%stableComponentIdent%%\n    }\n  `,\n  {\n    syntacticPlaceholders: true,\n  },\n)\n\nexport function createReactStableHmrSplitRouteComponentsPlugin(opts?: {\n  hotExpression?: string\n}): ReferenceRouteCompilerPlugin {\n  return {\n    name: 'react-stable-hmr-split-route-components',\n    onSplitRouteProperty(ctx) {\n      if (ctx.splitNodeMeta.splitStrategy !== 'lazyRouteComponent') {\n        return\n      }\n\n      const stableComponentIdent = getUniqueProgramIdentifier(\n        ctx.programPath,\n        `TSRSplit${capitalizeIdentifier(ctx.splitNodeMeta.exporterIdent)}`,\n      )\n\n      const hotDataKey = createHotDataKey(ctx.splitNodeMeta.exporterIdent)\n\n      ctx.insertionPath.insertBefore(\n        buildStableSplitComponentStatements({\n          stableComponentIdent,\n          hotDataKey: t.stringLiteral(hotDataKey),\n          hotExpression: createHmrHotExpressionAst(\n            opts?.hotExpression ?? ctx.opts.hmrHotExpression,\n          ),\n          lazyRouteComponentIdent: t.identifier(ctx.lazyRouteComponentIdent),\n          localImporterIdent: t.identifier(\n            ctx.splitNodeMeta.localImporterIdent,\n          ),\n          exporterIdent: t.stringLiteral(ctx.splitNodeMeta.exporterIdent),\n        }),\n      )\n\n      return t.identifier(stableComponentIdent.name)\n    },\n  }\n}\n"],"mappings":";;;;;AAMA,SAAS,qBAAqB,KAAa;AACzC,QAAO,IAAI,GAAI,aAAa,GAAG,IAAI,MAAM,EAAE;;AAG7C,SAAS,iBAAiB,YAAoB;AAC5C,QAAO,uBAAuB;;AAGhC,IAAM,sCAAsC,SAAS,WACnD;;;;;;;;;KAUA,EACE,uBAAuB,MACxB,CACF;AAED,SAAgB,+CAA+C,MAE9B;AAC/B,QAAO;EACL,MAAM;EACN,qBAAqB,KAAK;AACxB,OAAI,IAAI,cAAc,kBAAkB,qBACtC;GAGF,MAAM,uBAAuB,2BAC3B,IAAI,aACJ,WAAW,qBAAqB,IAAI,cAAc,cAAc,GACjE;GAED,MAAM,aAAa,iBAAiB,IAAI,cAAc,cAAc;AAEpE,OAAI,cAAc,aAChB,oCAAoC;IAClC;IACA,YAAY,EAAE,cAAc,WAAW;IACvC,eAAe,0BACb,MAAM,iBAAiB,IAAI,KAAK,iBACjC;IACD,yBAAyB,EAAE,WAAW,IAAI,wBAAwB;IAClE,oBAAoB,EAAE,WACpB,IAAI,cAAc,mBACnB;IACD,eAAe,EAAE,cAAc,IAAI,cAAc,cAAc;IAChE,CAAC,CACH;AAED,UAAO,EAAE,WAAW,qBAAqB,KAAK;;EAEjD"}
+{"version":3,"file":"react-stable-hmr-split-route-components.js","names":[],"sources":["../../../../../src/core/code-splitter/plugins/react-stable-hmr-split-route-components.ts"],"sourcesContent":["import * as template from '@babel/template'\nimport * as t from '@babel/types'\nimport { getUniqueProgramIdentifier } from '../../utils'\nimport type { HmrStyle } from '../../config'\nimport type { ReferenceRouteCompilerPlugin } from '../plugins'\n\nfunction capitalizeIdentifier(str: string) {\n  return str[0]!.toUpperCase() + str.slice(1)\n}\n\nfunction createHotDataKey(exportName: string) {\n  return `tsr-split-component:${exportName}`\n}\n\nconst buildStableSplitComponentStatements = template.statements(\n  `\n    const %%stableComponentIdent%% = (() => {\n      const hot = %%hotExpression%%\n      const hotData = hot ? (hot.data ??= {}) : undefined\n      return hotData?.[%%hotDataKey%%] ?? %%lazyRouteComponentIdent%%(%%localImporterIdent%%, %%exporterIdent%%)\n    })()\n    if (%%hotExpression%%) {\n      ((%%hotExpression%%).data ??= {})[%%hotDataKey%%] = %%stableComponentIdent%%\n    }\n  `,\n  {\n    syntacticPlaceholders: true,\n  },\n)\n\nfunction hotExpressionAstFor(hmrStyle: HmrStyle): t.Expression {\n  return template.expression.ast(\n    hmrStyle === 'webpack' ? 'import.meta.webpackHot' : 'import.meta.hot',\n  )\n}\n\nexport function createReactStableHmrSplitRouteComponentsPlugin(opts: {\n  hmrStyle: HmrStyle\n}): ReferenceRouteCompilerPlugin {\n  return {\n    name: 'react-stable-hmr-split-route-components',\n    onSplitRouteProperty(ctx) {\n      if (ctx.splitNodeMeta.splitStrategy !== 'lazyRouteComponent') {\n        return\n      }\n\n      const stableComponentIdent = getUniqueProgramIdentifier(\n        ctx.programPath,\n        `TSRSplit${capitalizeIdentifier(ctx.splitNodeMeta.exporterIdent)}`,\n      )\n\n      const hotDataKey = createHotDataKey(ctx.splitNodeMeta.exporterIdent)\n\n      ctx.insertionPath.insertBefore(\n        buildStableSplitComponentStatements({\n          stableComponentIdent,\n          hotDataKey: t.stringLiteral(hotDataKey),\n          hotExpression: hotExpressionAstFor(opts.hmrStyle),\n          lazyRouteComponentIdent: t.identifier(ctx.lazyRouteComponentIdent),\n          localImporterIdent: t.identifier(\n            ctx.splitNodeMeta.localImporterIdent,\n          ),\n          exporterIdent: t.stringLiteral(ctx.splitNodeMeta.exporterIdent),\n        }),\n      )\n\n      return t.identifier(stableComponentIdent.name)\n    },\n  }\n}\n"],"mappings":";;;;AAMA,SAAS,qBAAqB,KAAa;AACzC,QAAO,IAAI,GAAI,aAAa,GAAG,IAAI,MAAM,EAAE;;AAG7C,SAAS,iBAAiB,YAAoB;AAC5C,QAAO,uBAAuB;;AAGhC,IAAM,sCAAsC,SAAS,WACnD;;;;;;;;;KAUA,EACE,uBAAuB,MACxB,CACF;AAED,SAAS,oBAAoB,UAAkC;AAC7D,QAAO,SAAS,WAAW,IACzB,aAAa,YAAY,2BAA2B,kBACrD;;AAGH,SAAgB,+CAA+C,MAE9B;AAC/B,QAAO;EACL,MAAM;EACN,qBAAqB,KAAK;AACxB,OAAI,IAAI,cAAc,kBAAkB,qBACtC;GAGF,MAAM,uBAAuB,2BAC3B,IAAI,aACJ,WAAW,qBAAqB,IAAI,cAAc,cAAc,GACjE;GAED,MAAM,aAAa,iBAAiB,IAAI,cAAc,cAAc;AAEpE,OAAI,cAAc,aAChB,oCAAoC;IAClC;IACA,YAAY,EAAE,cAAc,WAAW;IACvC,eAAe,oBAAoB,KAAK,SAAS;IACjD,yBAAyB,EAAE,WAAW,IAAI,wBAAwB;IAClE,oBAAoB,EAAE,WACpB,IAAI,cAAc,mBACnB;IACD,eAAe,EAAE,cAAc,IAAI,cAAc,cAAc;IAChE,CAAC,CACH;AAED,UAAO,EAAE,WAAW,qBAAqB,KAAK;;EAEjD"}

package/dist/esm/core/code-splitter/plugins.d.ts

@@ -1,5 +1,5 @@
 import { default as babel } from '@babel/core';
-import { Config, DeletableNodes } from '../config.js';
+import { Config, DeletableNodes, HmrStyle } from '../config.js';
 import { CodeSplitGroupings } from '../constants.js';
 import { SplitNodeMeta } from './types.js';
 import type * as t from '@babel/types';
@@ -10,7 +10,8 @@ export type CompileCodeSplitReferenceRouteOptions = {
     filename: string;
     id: string;
     addHmr?: boolean;
-    hmrHotExpression?: string;
+    hmrStyle?: HmrStyle;
+    hmrRouteId?: string;
     sharedBindings?: Set<string>;
 };
 export type ReferenceRouteCompilerPluginContext = {

package/dist/esm/core/config.d.ts

@@ -28,8 +28,16 @@ export type CodeSplittingOptions = {
      */
     addHmr?: boolean;
 };
+export type HmrStyle = 'vite' | 'webpack';
 export type HmrOptions = {
-    hotExpression?: string;
+    /**
+     * Selects the HMR runtime style to emit code for.
+     * - `'vite'` (default): ESM `import.meta.hot` with Vite accept-callback semantics.
+     * - `'webpack'`: `import.meta.webpackHot` with webpack / Rspack `module.hot` re-execution semantics.
+     *
+     * Bundler-specific plugin entries (e.g. `rspack.ts`, `webpack.ts`) set this explicitly.
+     */
+    style?: HmrStyle;
 };
 type FileRouteKeys = keyof (Parameters<CreateFileRoute<any, any, any, any, any>>[0] & {});
 export type DeletableNodes = FileRouteKeys | (string & {});
@@ -97,11 +105,11 @@ export declare const configSchema: z.ZodObject<{
     codeSplittingOptions: z.ZodOptional<z.ZodType<CodeSplittingOptions, z.ZodTypeDef, CodeSplittingOptions>>;
     plugin: z.ZodOptional<z.ZodObject<{
         hmr: z.ZodOptional<z.ZodObject<{
-            hotExpression: z.ZodOptional<z.ZodString>;
+            style: z.ZodOptional<z.ZodEnum<["vite", "webpack"]>>;
         }, "strip", z.ZodTypeAny, {
-            hotExpression?: string | undefined;
+            style?: "vite" | "webpack" | undefined;
         }, {
-            hotExpression?: string | undefined;
+            style?: "vite" | "webpack" | undefined;
         }>>;
         vite: z.ZodOptional<z.ZodObject<{
             environmentName: z.ZodOptional<z.ZodString>;
@@ -111,19 +119,19 @@ export declare const configSchema: z.ZodObject<{
             environmentName?: string | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
-        hmr?: {
-            hotExpression?: string | undefined;
-        } | undefined;
         vite?: {
             environmentName?: string | undefined;
         } | undefined;
-    }, {
         hmr?: {
-            hotExpression?: string | undefined;
+            style?: "vite" | "webpack" | undefined;
         } | undefined;
+    }, {
         vite?: {
             environmentName?: string | undefined;
         } | undefined;
+        hmr?: {
+            style?: "vite" | "webpack" | undefined;
+        } | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     target: "react" | "solid" | "vue";
@@ -150,12 +158,12 @@ export declare const configSchema: z.ZodObject<{
     enableRouteGeneration?: boolean | undefined;
     codeSplittingOptions?: CodeSplittingOptions | undefined;
     plugin?: {
-        hmr?: {
-            hotExpression?: string | undefined;
-        } | undefined;
         vite?: {
             environmentName?: string | undefined;
         } | undefined;
+        hmr?: {
+            style?: "vite" | "webpack" | undefined;
+        } | undefined;
     } | undefined;
     virtualRouteConfig?: string | import('@tanstack/virtual-file-routes').VirtualRootRoute | undefined;
     routeFilePrefix?: string | undefined;
@@ -175,12 +183,12 @@ export declare const configSchema: z.ZodObject<{
     enableRouteGeneration?: boolean | undefined;
     codeSplittingOptions?: CodeSplittingOptions | undefined;
     plugin?: {
-        hmr?: {
-            hotExpression?: string | undefined;
-        } | undefined;
         vite?: {
             environmentName?: string | undefined;
         } | undefined;
+        hmr?: {
+            style?: "vite" | "webpack" | undefined;
+        } | undefined;
     } | undefined;
     target?: "react" | "solid" | "vue" | undefined;
     virtualRouteConfig?: string | import('@tanstack/virtual-file-routes').VirtualRootRoute | undefined;
@@ -243,12 +251,12 @@ export declare const getConfig: (inlineConfig: Partial<Config>, root: string) =>
     enableRouteGeneration?: boolean | undefined;
     codeSplittingOptions?: CodeSplittingOptions | undefined;
     plugin?: {
-        hmr?: {
-            hotExpression?: string | undefined;
-        } | undefined;
         vite?: {
             environmentName?: string | undefined;
         } | undefined;
+        hmr?: {
+            style?: "vite" | "webpack" | undefined;
+        } | undefined;
     } | undefined;
     virtualRouteConfig?: string | import('@tanstack/virtual-file-routes').VirtualRootRoute | undefined;
     routeFilePrefix?: string | undefined;

package/dist/esm/core/config.js

@@ -26,7 +26,7 @@ var configSchema$1 = configSchema.extend({
 		return codeSplittingOptionsSchema.parse(v);
 	}).optional(),
 	plugin: z.object({
-		hmr: z.object({ hotExpression: z.string().optional() }).optional(),
+		hmr: z.object({ style: z.enum(["vite", "webpack"]).optional() }).optional(),
 		vite: z.object({ environmentName: z.string().optional() }).optional()
 	}).optional()
 });

package/dist/esm/core/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","names":[],"sources":["../../../src/core/config.ts"],"sourcesContent":["import { z } from 'zod'\nimport {\n  configSchema as generatorConfigSchema,\n  getConfig as getGeneratorConfig,\n} from '@tanstack/router-generator'\nimport type {\n  CreateFileRoute,\n  RegisteredRouter,\n  RouteIds,\n} from '@tanstack/router-core'\nimport type { CodeSplitGroupings } from './constants'\n\nexport const splitGroupingsSchema = z\n  .array(\n    z.array(\n      z.union([\n        z.literal('loader'),\n        z.literal('component'),\n        z.literal('pendingComponent'),\n        z.literal('errorComponent'),\n        z.literal('notFoundComponent'),\n      ]),\n    ),\n    {\n      message:\n        \"  Must be an Array of Arrays containing the split groupings. i.e. [['component'], ['pendingComponent'], ['errorComponent', 'notFoundComponent']]\",\n    },\n  )\n  .superRefine((val, ctx) => {\n    const flattened = val.flat()\n    const unique = [...new Set(flattened)]\n\n    // Elements must be unique,\n    // ie. this shouldn't be allows [['component'], ['component', 'loader']]\n    if (unique.length !== flattened.length) {\n      ctx.addIssue({\n        code: 'custom',\n        message:\n          \"  Split groupings must be unique and not repeated. i.e. i.e. [['component'], ['pendingComponent'], ['errorComponent', 'notFoundComponent']].\" +\n          `\\n  You input was: ${JSON.stringify(val)}.`,\n      })\n    }\n  })\n\nexport type CodeSplittingOptions = {\n  /**\n   * Use this function to programmatically control the code splitting behavior\n   * based on the `routeId` for each route.\n   *\n   * If you just need to change the default behavior, you can use the `defaultBehavior` option.\n   * @param params\n   */\n  splitBehavior?: (params: {\n    routeId: RouteIds<RegisteredRouter['routeTree']>\n  }) => CodeSplitGroupings | undefined | void\n\n  /**\n   * The default/global configuration to control your code splitting behavior per route.\n   * @default [['component'],['pendingComponent'],['errorComponent'],['notFoundComponent']]\n   */\n  defaultBehavior?: CodeSplitGroupings\n\n  /**\n   * The nodes that shall be deleted from the route.\n   * @default undefined\n   */\n  deleteNodes?: Array<DeletableNodes>\n\n  /**\n   * @default true\n   */\n  addHmr?: boolean\n}\n\nexport type HmrOptions = {\n  hotExpression?: string\n}\n\nconst codeSplittingOptionsSchema = z.object({\n  splitBehavior: z.function().optional(),\n  defaultBehavior: splitGroupingsSchema.optional(),\n  deleteNodes: z.array(z.string()).optional(),\n  addHmr: z.boolean().optional().default(true),\n})\n\ntype FileRouteKeys = keyof (Parameters<\n  CreateFileRoute<any, any, any, any, any>\n>[0] & {})\nexport type DeletableNodes = FileRouteKeys | (string & {})\n\nexport const configSchema = generatorConfigSchema.extend({\n  enableRouteGeneration: z.boolean().optional(),\n  codeSplittingOptions: z\n    .custom<CodeSplittingOptions>((v) => {\n      return codeSplittingOptionsSchema.parse(v)\n    })\n    .optional(),\n  plugin: z\n    .object({\n      hmr: z\n        .object({\n          hotExpression: z.string().optional(),\n        })\n        .optional(),\n      vite: z\n        .object({\n          environmentName: z.string().optional(),\n        })\n        .optional(),\n    })\n    .optional(),\n})\n\nexport const getConfig = (inlineConfig: Partial<Config>, root: string) => {\n  const config = getGeneratorConfig(inlineConfig, root)\n\n  return configSchema.parse({ ...inlineConfig, ...config })\n}\n\nexport type Config = z.infer<typeof configSchema>\nexport type ConfigInput = z.input<typeof configSchema>\nexport type ConfigOutput = z.output<typeof configSchema>\n"],"mappings":";;;AAYA,IAAa,uBAAuB,EACjC,MACC,EAAE,MACA,EAAE,MAAM;CACN,EAAE,QAAQ,SAAS;CACnB,EAAE,QAAQ,YAAY;CACtB,EAAE,QAAQ,mBAAmB;CAC7B,EAAE,QAAQ,iBAAiB;CAC3B,EAAE,QAAQ,oBAAoB;CAC/B,CAAC,CACH,EACD,EACE,SACE,oJACH,CACF,CACA,aAAa,KAAK,QAAQ;CACzB,MAAM,YAAY,IAAI,MAAM;AAK5B,KAJe,CAAC,GAAG,IAAI,IAAI,UAAU,CAAC,CAI3B,WAAW,UAAU,OAC9B,KAAI,SAAS;EACX,MAAM;EACN,SACE,kKACsB,KAAK,UAAU,IAAI,CAAC;EAC7C,CAAC;EAEJ;AAoCJ,IAAM,6BAA6B,EAAE,OAAO;CAC1C,eAAe,EAAE,UAAU,CAAC,UAAU;CACtC,iBAAiB,qBAAqB,UAAU;CAChD,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CAC3C,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,QAAQ,KAAK;CAC7C,CAAC;AAOF,IAAa,iBAAe,aAAsB,OAAO;CACvD,uBAAuB,EAAE,SAAS,CAAC,UAAU;CAC7C,sBAAsB,EACnB,QAA8B,MAAM;AACnC,SAAO,2BAA2B,MAAM,EAAE;GAC1C,CACD,UAAU;CACb,QAAQ,EACL,OAAO;EACN,KAAK,EACF,OAAO,EACN,eAAe,EAAE,QAAQ,CAAC,UAAU,EACrC,CAAC,CACD,UAAU;EACb,MAAM,EACH,OAAO,EACN,iBAAiB,EAAE,QAAQ,CAAC,UAAU,EACvC,CAAC,CACD,UAAU;EACd,CAAC,CACD,UAAU;CACd,CAAC;AAEF,IAAa,eAAa,cAA+B,SAAiB;CACxE,MAAM,SAAS,UAAmB,cAAc,KAAK;AAErD,QAAO,eAAa,MAAM;EAAE,GAAG;EAAc,GAAG;EAAQ,CAAC"}
+{"version":3,"file":"config.js","names":[],"sources":["../../../src/core/config.ts"],"sourcesContent":["import { z } from 'zod'\nimport {\n  configSchema as generatorConfigSchema,\n  getConfig as getGeneratorConfig,\n} from '@tanstack/router-generator'\nimport type {\n  CreateFileRoute,\n  RegisteredRouter,\n  RouteIds,\n} from '@tanstack/router-core'\nimport type { CodeSplitGroupings } from './constants'\n\nexport const splitGroupingsSchema = z\n  .array(\n    z.array(\n      z.union([\n        z.literal('loader'),\n        z.literal('component'),\n        z.literal('pendingComponent'),\n        z.literal('errorComponent'),\n        z.literal('notFoundComponent'),\n      ]),\n    ),\n    {\n      message:\n        \"  Must be an Array of Arrays containing the split groupings. i.e. [['component'], ['pendingComponent'], ['errorComponent', 'notFoundComponent']]\",\n    },\n  )\n  .superRefine((val, ctx) => {\n    const flattened = val.flat()\n    const unique = [...new Set(flattened)]\n\n    // Elements must be unique,\n    // ie. this shouldn't be allows [['component'], ['component', 'loader']]\n    if (unique.length !== flattened.length) {\n      ctx.addIssue({\n        code: 'custom',\n        message:\n          \"  Split groupings must be unique and not repeated. i.e. i.e. [['component'], ['pendingComponent'], ['errorComponent', 'notFoundComponent']].\" +\n          `\\n  You input was: ${JSON.stringify(val)}.`,\n      })\n    }\n  })\n\nexport type CodeSplittingOptions = {\n  /**\n   * Use this function to programmatically control the code splitting behavior\n   * based on the `routeId` for each route.\n   *\n   * If you just need to change the default behavior, you can use the `defaultBehavior` option.\n   * @param params\n   */\n  splitBehavior?: (params: {\n    routeId: RouteIds<RegisteredRouter['routeTree']>\n  }) => CodeSplitGroupings | undefined | void\n\n  /**\n   * The default/global configuration to control your code splitting behavior per route.\n   * @default [['component'],['pendingComponent'],['errorComponent'],['notFoundComponent']]\n   */\n  defaultBehavior?: CodeSplitGroupings\n\n  /**\n   * The nodes that shall be deleted from the route.\n   * @default undefined\n   */\n  deleteNodes?: Array<DeletableNodes>\n\n  /**\n   * @default true\n   */\n  addHmr?: boolean\n}\n\nexport type HmrStyle = 'vite' | 'webpack'\n\nexport type HmrOptions = {\n  /**\n   * Selects the HMR runtime style to emit code for.\n   * - `'vite'` (default): ESM `import.meta.hot` with Vite accept-callback semantics.\n   * - `'webpack'`: `import.meta.webpackHot` with webpack / Rspack `module.hot` re-execution semantics.\n   *\n   * Bundler-specific plugin entries (e.g. `rspack.ts`, `webpack.ts`) set this explicitly.\n   */\n  style?: HmrStyle\n}\n\nconst codeSplittingOptionsSchema = z.object({\n  splitBehavior: z.function().optional(),\n  defaultBehavior: splitGroupingsSchema.optional(),\n  deleteNodes: z.array(z.string()).optional(),\n  addHmr: z.boolean().optional().default(true),\n})\n\ntype FileRouteKeys = keyof (Parameters<\n  CreateFileRoute<any, any, any, any, any>\n>[0] & {})\nexport type DeletableNodes = FileRouteKeys | (string & {})\n\nexport const configSchema = generatorConfigSchema.extend({\n  enableRouteGeneration: z.boolean().optional(),\n  codeSplittingOptions: z\n    .custom<CodeSplittingOptions>((v) => {\n      return codeSplittingOptionsSchema.parse(v)\n    })\n    .optional(),\n  plugin: z\n    .object({\n      hmr: z\n        .object({\n          style: z.enum(['vite', 'webpack']).optional(),\n        })\n        .optional(),\n      vite: z\n        .object({\n          environmentName: z.string().optional(),\n        })\n        .optional(),\n    })\n    .optional(),\n})\n\nexport const getConfig = (inlineConfig: Partial<Config>, root: string) => {\n  const config = getGeneratorConfig(inlineConfig, root)\n\n  return configSchema.parse({ ...inlineConfig, ...config })\n}\n\nexport type Config = z.infer<typeof configSchema>\nexport type ConfigInput = z.input<typeof configSchema>\nexport type ConfigOutput = z.output<typeof configSchema>\n"],"mappings":";;;AAYA,IAAa,uBAAuB,EACjC,MACC,EAAE,MACA,EAAE,MAAM;CACN,EAAE,QAAQ,SAAS;CACnB,EAAE,QAAQ,YAAY;CACtB,EAAE,QAAQ,mBAAmB;CAC7B,EAAE,QAAQ,iBAAiB;CAC3B,EAAE,QAAQ,oBAAoB;CAC/B,CAAC,CACH,EACD,EACE,SACE,oJACH,CACF,CACA,aAAa,KAAK,QAAQ;CACzB,MAAM,YAAY,IAAI,MAAM;AAK5B,KAJe,CAAC,GAAG,IAAI,IAAI,UAAU,CAAC,CAI3B,WAAW,UAAU,OAC9B,KAAI,SAAS;EACX,MAAM;EACN,SACE,kKACsB,KAAK,UAAU,IAAI,CAAC;EAC7C,CAAC;EAEJ;AA6CJ,IAAM,6BAA6B,EAAE,OAAO;CAC1C,eAAe,EAAE,UAAU,CAAC,UAAU;CACtC,iBAAiB,qBAAqB,UAAU;CAChD,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CAC3C,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,QAAQ,KAAK;CAC7C,CAAC;AAOF,IAAa,iBAAe,aAAsB,OAAO;CACvD,uBAAuB,EAAE,SAAS,CAAC,UAAU;CAC7C,sBAAsB,EACnB,QAA8B,MAAM;AACnC,SAAO,2BAA2B,MAAM,EAAE;GAC1C,CACD,UAAU;CACb,QAAQ,EACL,OAAO;EACN,KAAK,EACF,OAAO,EACN,OAAO,EAAE,KAAK,CAAC,QAAQ,UAAU,CAAC,CAAC,UAAU,EAC9C,CAAC,CACD,UAAU;EACb,MAAM,EACH,OAAO,EACN,iBAAiB,EAAE,QAAQ,CAAC,UAAU,EACvC,CAAC,CACD,UAAU;EACd,CAAC,CACD,UAAU;CACd,CAAC;AAEF,IAAa,eAAa,cAA+B,SAAiB;CACxE,MAAM,SAAS,UAAmB,cAAc,KAAK;AAErD,QAAO,eAAa,MAAM;EAAE,GAAG;EAAc,GAAG;EAAQ,CAAC"}

package/dist/esm/core/hmr/handle-route-update.d.ts

@@ -0,0 +1 @@
+export declare function getHandleRouteUpdateCode(stableRouteOptionKeys: Array<string>): string;

package/dist/esm/core/{route-hmr-statement.js → hmr/handle-route-update.js}

@@ -1,6 +1,4 @@
-import { createHmrHotExpressionAst } from "./hmr-hot-expression.js";
-import * as template from "@babel/template";
-//#region src/core/route-hmr-statement.ts
+//#region src/core/hmr/handle-route-update.ts
 function handleRouteUpdate(routeId, newRoute) {
 	const router = window.__TSR_ROUTER__;
 	const oldRoute = router.routesById[routeId];
@@ -12,7 +10,9 @@ function handleRouteUpdate(routeId, newRoute) {
 			delete oldRoute.options[key];
 		}
 	});
-	"__TSR_COMPONENT_TYPES__".forEach((key) => {
+	const preserveComponentIdentity = "shellComponent" in oldRoute.options === "shellComponent" in newRoute.options;
+	const componentKeys = "__TSR_COMPONENT_TYPES__";
+	if (preserveComponentIdentity) componentKeys.forEach((key) => {
 		if (key in oldRoute.options && key in newRoute.options) newRoute.options[key] = oldRoute.options[key];
 	});
 	oldRoute.options = newRoute.options;
@@ -43,7 +43,10 @@ function handleRouteUpdate(routeId, newRoute) {
 					if (store) store.set((prev) => {
 						const next = { ...prev };
 						if (removedKeys.has("loader")) next.loaderData = void 0;
-						if (removedKeys.has("beforeLoad")) next.__beforeLoadContext = void 0;
+						if (removedKeys.has("beforeLoad")) {
+							next.__beforeLoadContext = void 0;
+							next.context = rebuildMatchContextWithoutBeforeLoad(next);
+						}
 						return next;
 					});
 				}
@@ -63,26 +66,39 @@ function handleRouteUpdate(routeId, newRoute) {
 		node.optional?.forEach((child) => walkReplaceSegmentTree(route, child));
 		node.wildcard?.forEach((child) => walkReplaceSegmentTree(route, child));
 	}
+	function getStoreMatch(matchId) {
+		return router.stores.pendingMatchStores.get(matchId)?.get() || router.stores.matchStores.get(matchId)?.get() || router.stores.cachedMatchStores.get(matchId)?.get();
+	}
+	function getMatchList(matchId) {
+		const pendingMatches = router.stores.pendingMatches.get();
+		if (pendingMatches.some((match) => match.id === matchId)) return pendingMatches;
+		const activeMatches = router.stores.matches.get();
+		if (activeMatches.some((match) => match.id === matchId)) return activeMatches;
+		const cachedMatches = router.stores.cachedMatches.get();
+		if (cachedMatches.some((match) => match.id === matchId)) return cachedMatches;
+		return [];
+	}
+	function getParentMatch(match) {
+		const matchList = getMatchList(match.id);
+		const matchIndex = matchList.findIndex((item) => item.id === match.id);
+		if (matchIndex <= 0) return;
+		const parentMatch = matchList[matchIndex - 1];
+		return getStoreMatch(parentMatch.id) || parentMatch;
+	}
+	function rebuildMatchContextWithoutBeforeLoad(match) {
+		const parentMatch = getParentMatch(match);
+		const getParentContext = router.getParentContext;
+		return {
+			...(getParentContext ? getParentContext.call(router, parentMatch) : parentMatch?.context ?? router.options.context) ?? {},
+			...match.__routeContext ?? {}
+		};
+	}
 }
 var handleRouteUpdateStr = handleRouteUpdate.toString();
-function createRouteHmrStatement(stableRouteOptionKeys, opts) {
-	return template.statement(`
-if (%%hotExpression%%) {
-  const hot = %%hotExpression%%
-  const hotData = hot.data ??= {}
-  hot.accept((newModule) => {
-    if (Route && newModule && newModule.Route) {
-      const routeId = hotData['tsr-route-id'] ?? Route.id
-      if (routeId) {
-        hotData['tsr-route-id'] = routeId
-      }
-      (${handleRouteUpdateStr.replace(/['"]__TSR_COMPONENT_TYPES__['"]/, JSON.stringify(stableRouteOptionKeys))})(routeId, newModule.Route)
-    }
-    })
-}
-`, { syntacticPlaceholders: true })({ hotExpression: createHmrHotExpressionAst(opts?.hotExpression) });
+function getHandleRouteUpdateCode(stableRouteOptionKeys) {
+	return handleRouteUpdateStr.replace(/['"]__TSR_COMPONENT_TYPES__['"]/, JSON.stringify(stableRouteOptionKeys));
 }
 //#endregion
-export { createRouteHmrStatement };
+export { getHandleRouteUpdateCode };
 
-//# sourceMappingURL=route-hmr-statement.js.map
+//# sourceMappingURL=handle-route-update.js.map

package/dist/esm/core/hmr/handle-route-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-route-update.js","names":[],"sources":["../../../../src/core/hmr/handle-route-update.ts"],"sourcesContent":["import type {\n  AnyRoute,\n  AnyRouteMatch,\n  AnyRouter,\n  RouterWritableStore,\n} from '@tanstack/router-core'\n\ntype AnyRouteWithPrivateProps = AnyRoute & {\n  options: Record<string, unknown>\n  _componentsPromise?: Promise<void>\n  _lazyPromise?: Promise<void>\n  update: (options: Record<string, unknown>) => unknown\n  _path: string\n  _id: string\n  _fullPath: string\n  _to: string\n}\n\ntype AnyRouterWithPrivateMaps = AnyRouter & {\n  routesById: Record<string, AnyRoute>\n  routesByPath: Record<string, AnyRoute>\n  stores: AnyRouter['stores'] & {\n    cachedMatchStores: Map<\n      string,\n      Pick<RouterWritableStore<AnyRouteMatch>, 'get' | 'set'>\n    >\n    pendingMatchStores: Map<\n      string,\n      Pick<RouterWritableStore<AnyRouteMatch>, 'get' | 'set'>\n    >\n    matchStores: Map<\n      string,\n      Pick<RouterWritableStore<AnyRouteMatch>, 'get' | 'set'>\n    >\n  }\n}\n\ntype AnyRouteMatchWithPrivateProps = AnyRouteMatch & {\n  __beforeLoadContext?: unknown\n  __routeContext?: Record<string, unknown>\n  context?: Record<string, unknown>\n}\n\nfunction handleRouteUpdate(\n  routeId: string,\n  newRoute: AnyRouteWithPrivateProps,\n) {\n  const router = window.__TSR_ROUTER__ as AnyRouterWithPrivateMaps\n  const oldRoute = router.routesById[routeId] as\n    | AnyRouteWithPrivateProps\n    | undefined\n\n  if (!oldRoute) {\n    return\n  }\n\n  // Keys whose identity must remain stable to prevent React from\n  // unmounting/remounting the component tree.  React Fast Refresh already\n  // handles hot-updating the function bodies of these components — our job\n  // is only to update non-component route options (loader, head, etc.).\n  // For code-split (splittable) routes, the lazyRouteComponent wrapper is\n  // already cached in the bundler hot data so its identity is stable.\n  // For unsplittable routes (e.g. root routes), the component is a plain\n  // function reference that gets recreated on every module re-execution,\n  // so we must explicitly preserve the old reference.\n  const removedKeys = new Set<string>()\n  Object.keys(oldRoute.options).forEach((key) => {\n    if (!(key in newRoute.options)) {\n      removedKeys.add(key)\n      delete oldRoute.options[key]\n    }\n  })\n\n  const oldHasShellComponent = 'shellComponent' in oldRoute.options\n  const newHasShellComponent = 'shellComponent' in newRoute.options\n  const preserveComponentIdentity =\n    oldHasShellComponent === newHasShellComponent\n\n  // Preserve component identity so React doesn't remount.\n  // React Fast Refresh patches the function bodies in-place.\n  const componentKeys = '__TSR_COMPONENT_TYPES__' as unknown as Array<string>\n  if (preserveComponentIdentity) {\n    componentKeys.forEach((key) => {\n      if (key in oldRoute.options && key in newRoute.options) {\n        newRoute.options[key] = oldRoute.options[key]\n      }\n    })\n  }\n\n  oldRoute.options = newRoute.options\n  oldRoute.update(newRoute.options)\n  oldRoute._componentsPromise = undefined\n  oldRoute._lazyPromise = undefined\n\n  router.routesById[oldRoute.id] = oldRoute\n  router.routesByPath[oldRoute.fullPath] = oldRoute\n\n  router.processedTree.matchCache.clear()\n  router.processedTree.flatCache?.clear()\n  router.processedTree.singleCache.clear()\n  router.resolvePathCache.clear()\n  walkReplaceSegmentTree(oldRoute, router.processedTree.segmentTree)\n\n  const filter = (m: AnyRouteMatch) => m.routeId === oldRoute.id\n  const activeMatch = router.stores.matches.get().find(filter)\n  const pendingMatch = router.stores.pendingMatches.get().find(filter)\n  const cachedMatches = router.stores.cachedMatches.get().filter(filter)\n\n  if (activeMatch || pendingMatch || cachedMatches.length > 0) {\n    // Clear stale match data for removed route options BEFORE invalidating.\n    // Without this, router.invalidate() -> matchRoutes() reuses the existing\n    // match from the store (via ...existingMatch spread) and the stale\n    // loaderData / __beforeLoadContext survives the reload cycle.\n    //\n    // We must update the store directly (not via router.updateMatch) because\n    // updateMatch wraps in startTransition which may defer the state update,\n    // and we need the clear to be visible before invalidate reads the store.\n    if (removedKeys.has('loader') || removedKeys.has('beforeLoad')) {\n      const matchIds = [\n        activeMatch?.id,\n        pendingMatch?.id,\n        ...cachedMatches.map((match) => match.id),\n      ].filter(Boolean) as Array<string>\n      router.batch(() => {\n        for (const matchId of matchIds) {\n          const store =\n            router.stores.pendingMatchStores.get(matchId) ||\n            router.stores.matchStores.get(matchId) ||\n            router.stores.cachedMatchStores.get(matchId)\n          if (store) {\n            store.set((prev) => {\n              const next: AnyRouteMatchWithPrivateProps = { ...prev }\n\n              if (removedKeys.has('loader')) {\n                next.loaderData = undefined\n              }\n              if (removedKeys.has('beforeLoad')) {\n                next.__beforeLoadContext = undefined\n                next.context = rebuildMatchContextWithoutBeforeLoad(next)\n              }\n\n              return next\n            })\n          }\n        }\n      })\n    }\n\n    router.invalidate({ filter, sync: true })\n  }\n\n  function walkReplaceSegmentTree(\n    route: AnyRouteWithPrivateProps,\n    node: AnyRouter['processedTree']['segmentTree'],\n  ) {\n    if (node.route?.id === route.id) node.route = route\n    if (node.index) walkReplaceSegmentTree(route, node.index)\n    node.static?.forEach((child) => walkReplaceSegmentTree(route, child))\n    node.staticInsensitive?.forEach((child) =>\n      walkReplaceSegmentTree(route, child),\n    )\n    node.dynamic?.forEach((child) => walkReplaceSegmentTree(route, child))\n    node.optional?.forEach((child) => walkReplaceSegmentTree(route, child))\n    node.wildcard?.forEach((child) => walkReplaceSegmentTree(route, child))\n  }\n\n  function getStoreMatch(matchId: string) {\n    return (\n      router.stores.pendingMatchStores.get(matchId)?.get() ||\n      router.stores.matchStores.get(matchId)?.get() ||\n      router.stores.cachedMatchStores.get(matchId)?.get()\n    )\n  }\n\n  function getMatchList(matchId: string) {\n    const pendingMatches = router.stores.pendingMatches.get()\n    if (pendingMatches.some((match) => match.id === matchId)) {\n      return pendingMatches\n    }\n\n    const activeMatches = router.stores.matches.get()\n    if (activeMatches.some((match) => match.id === matchId)) {\n      return activeMatches\n    }\n\n    const cachedMatches = router.stores.cachedMatches.get()\n    if (cachedMatches.some((match) => match.id === matchId)) {\n      return cachedMatches\n    }\n\n    return []\n  }\n\n  function getParentMatch(match: AnyRouteMatch) {\n    const matchList = getMatchList(match.id)\n    const matchIndex = matchList.findIndex((item) => item.id === match.id)\n\n    if (matchIndex <= 0) {\n      return undefined\n    }\n\n    const parentMatch = matchList[matchIndex - 1]!\n    return getStoreMatch(parentMatch.id) || parentMatch\n  }\n\n  function rebuildMatchContextWithoutBeforeLoad(\n    match: AnyRouteMatchWithPrivateProps,\n  ) {\n    const parentMatch = getParentMatch(match)\n    const getParentContext = (\n      router as unknown as {\n        getParentContext?: (\n          parentMatch?: AnyRouteMatch,\n        ) => Record<string, unknown> | undefined\n      }\n    ).getParentContext\n    const parentContext = getParentContext\n      ? getParentContext.call(router, parentMatch)\n      : (parentMatch?.context ?? router.options.context)\n\n    return {\n      ...(parentContext ?? {}),\n      ...(match.__routeContext ?? {}),\n    }\n  }\n}\n\nconst handleRouteUpdateStr = handleRouteUpdate.toString()\n\nexport function getHandleRouteUpdateCode(stableRouteOptionKeys: Array<string>) {\n  return handleRouteUpdateStr.replace(\n    /['\"]__TSR_COMPONENT_TYPES__['\"]/,\n    JSON.stringify(stableRouteOptionKeys),\n  )\n}\n"],"mappings":"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"}

package/dist/esm/core/hmr/index.d.ts

@@ -0,0 +1,5 @@
+export { createRouteHmrStatement } from './select-adapter.js';
+export type { CreateRouteHmrStatementOpts } from './select-adapter.js';
+export { createViteHmrStatement } from './vite-adapter.js';
+export { createWebpackHmrStatement } from './webpack-adapter.js';
+export { getHandleRouteUpdateCode } from './handle-route-update.js';

package/dist/esm/core/hmr/select-adapter.d.ts

@@ -0,0 +1,13 @@
+import { Config, HmrStyle } from '../config.js';
+import type * as t from '@babel/types';
+export type CreateRouteHmrStatementOpts = {
+    hmrStyle: HmrStyle;
+    targetFramework: Config['target'];
+    routeId?: string;
+};
+/**
+ * Dispatches to the configured HMR adapter. `hmrStyle` is set explicitly by
+ * the bundler-specific plugin entry (e.g. `rspack.ts` → `'webpack'`), so there
+ * is no runtime inference based on config string shapes.
+ */
+export declare function createRouteHmrStatement(stableRouteOptionKeys: Array<string>, opts: CreateRouteHmrStatementOpts): Array<t.Statement>;

package/dist/esm/core/hmr/select-adapter.js

@@ -0,0 +1,20 @@
+import { createViteHmrStatement } from "./vite-adapter.js";
+import { createWebpackHmrStatement } from "./webpack-adapter.js";
+//#region src/core/hmr/select-adapter.ts
+/**
+* Dispatches to the configured HMR adapter. `hmrStyle` is set explicitly by
+* the bundler-specific plugin entry (e.g. `rspack.ts` → `'webpack'`), so there
+* is no runtime inference based on config string shapes.
+*/
+function createRouteHmrStatement(stableRouteOptionKeys, opts) {
+	const routeId = opts.routeId === "/__root" ? "__root__" : opts.routeId;
+	if (opts.hmrStyle === "webpack") return createWebpackHmrStatement(stableRouteOptionKeys, {
+		targetFramework: opts.targetFramework,
+		routeId
+	});
+	return createViteHmrStatement(stableRouteOptionKeys, { routeId });
+}
+//#endregion
+export { createRouteHmrStatement };
+
+//# sourceMappingURL=select-adapter.js.map

package/dist/esm/core/hmr/select-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-adapter.js","names":[],"sources":["../../../../src/core/hmr/select-adapter.ts"],"sourcesContent":["import { createViteHmrStatement } from './vite-adapter'\nimport { createWebpackHmrStatement } from './webpack-adapter'\nimport type { Config, HmrStyle } from '../config'\nimport type * as t from '@babel/types'\n\nexport type CreateRouteHmrStatementOpts = {\n  hmrStyle: HmrStyle\n  targetFramework: Config['target']\n  routeId?: string\n}\n\n/**\n * Dispatches to the configured HMR adapter. `hmrStyle` is set explicitly by\n * the bundler-specific plugin entry (e.g. `rspack.ts` → `'webpack'`), so there\n * is no runtime inference based on config string shapes.\n */\nexport function createRouteHmrStatement(\n  stableRouteOptionKeys: Array<string>,\n  opts: CreateRouteHmrStatementOpts,\n): Array<t.Statement> {\n  const routeId = opts.routeId === '/__root' ? '__root__' : opts.routeId\n\n  if (opts.hmrStyle === 'webpack') {\n    return createWebpackHmrStatement(stableRouteOptionKeys, {\n      targetFramework: opts.targetFramework,\n      routeId,\n    })\n  }\n  return createViteHmrStatement(stableRouteOptionKeys, {\n    routeId,\n  })\n}\n"],"mappings":";;;;;;;;AAgBA,SAAgB,wBACd,uBACA,MACoB;CACpB,MAAM,UAAU,KAAK,YAAY,YAAY,aAAa,KAAK;AAE/D,KAAI,KAAK,aAAa,UACpB,QAAO,0BAA0B,uBAAuB;EACtD,iBAAiB,KAAK;EACtB;EACD,CAAC;AAEJ,QAAO,uBAAuB,uBAAuB,EACnD,SACD,CAAC"}

package/dist/esm/core/hmr/vite-adapter.d.ts

@@ -0,0 +1,12 @@
+import type * as t from '@babel/types';
+/**
+ * Emits HMR accept code for Vite / native ESM HMR: `import.meta.hot.accept`
+ * with a callback that receives the freshly re-imported module.
+ *
+ * `targetFramework` is currently unused — Vite's framework-specific fast-refresh
+ * plugins handle component body patching via their own accept boundaries — but
+ * we take it for API symmetry with `createWebpackHmrStatement`.
+ */
+export declare function createViteHmrStatement(stableRouteOptionKeys: Array<string>, opts?: {
+    routeId?: string;
+}): Array<t.Statement>;

package/dist/esm/core/hmr/vite-adapter.js

@@ -0,0 +1,34 @@
+import { getHandleRouteUpdateCode } from "./handle-route-update.js";
+import * as template from "@babel/template";
+//#region src/core/hmr/vite-adapter.ts
+/**
+* Emits HMR accept code for Vite / native ESM HMR: `import.meta.hot.accept`
+* with a callback that receives the freshly re-imported module.
+*
+* `targetFramework` is currently unused — Vite's framework-specific fast-refresh
+* plugins handle component body patching via their own accept boundaries — but
+* we take it for API symmetry with `createWebpackHmrStatement`.
+*/
+function createViteHmrStatement(stableRouteOptionKeys, opts = {}) {
+	const handleRouteUpdateCode = getHandleRouteUpdateCode(stableRouteOptionKeys);
+	const routeIdFallback = typeof opts.routeId === "string" ? JSON.stringify(opts.routeId) : "Route.id";
+	return [template.statement(`
+if (import.meta.hot) {
+  const hot = import.meta.hot
+  const hotData = hot.data ??= {}
+  hot.accept((newModule) => {
+    if (Route && newModule && newModule.Route) {
+      const routeId = hotData['tsr-route-id'] ?? ${routeIdFallback}
+      if (routeId) {
+        hotData['tsr-route-id'] = routeId
+      }
+      (${handleRouteUpdateCode})(routeId, newModule.Route)
+    }
+    })
+}
+`, { syntacticPlaceholders: true })()];
+}
+//#endregion
+export { createViteHmrStatement };
+
+//# sourceMappingURL=vite-adapter.js.map

package/dist/esm/core/hmr/vite-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-adapter.js","names":[],"sources":["../../../../src/core/hmr/vite-adapter.ts"],"sourcesContent":["import * as template from '@babel/template'\nimport { getHandleRouteUpdateCode } from './handle-route-update'\nimport type * as t from '@babel/types'\n\n/**\n * Emits HMR accept code for Vite / native ESM HMR: `import.meta.hot.accept`\n * with a callback that receives the freshly re-imported module.\n *\n * `targetFramework` is currently unused — Vite's framework-specific fast-refresh\n * plugins handle component body patching via their own accept boundaries — but\n * we take it for API symmetry with `createWebpackHmrStatement`.\n */\nexport function createViteHmrStatement(\n  stableRouteOptionKeys: Array<string>,\n  opts: {\n    routeId?: string\n  } = {},\n): Array<t.Statement> {\n  const handleRouteUpdateCode = getHandleRouteUpdateCode(stableRouteOptionKeys)\n  // The replacement Route object can be uninitialized; keep a generated id as\n  // fallback for the existing router route we need to patch.\n  const routeIdFallback =\n    typeof opts.routeId === 'string' ? JSON.stringify(opts.routeId) : 'Route.id'\n\n  return [\n    template.statement(\n      `\nif (import.meta.hot) {\n  const hot = import.meta.hot\n  const hotData = hot.data ??= {}\n  hot.accept((newModule) => {\n    if (Route && newModule && newModule.Route) {\n      const routeId = hotData['tsr-route-id'] ?? ${routeIdFallback}\n      if (routeId) {\n        hotData['tsr-route-id'] = routeId\n      }\n      (${handleRouteUpdateCode})(routeId, newModule.Route)\n    }\n    })\n}\n`,\n      {\n        syntacticPlaceholders: true,\n      },\n    )(),\n  ]\n}\n"],"mappings":";;;;;;;;;;;AAYA,SAAgB,uBACd,uBACA,OAEI,EAAE,EACc;CACpB,MAAM,wBAAwB,yBAAyB,sBAAsB;CAG7E,MAAM,kBACJ,OAAO,KAAK,YAAY,WAAW,KAAK,UAAU,KAAK,QAAQ,GAAG;AAEpE,QAAO,CACL,SAAS,UACP;;;;;;mDAM6C,gBAAgB;;;;SAI1D,sBAAsB;;;;GAKzB,EACE,uBAAuB,MACxB,CACF,EAAE,CACJ"}

package/dist/esm/core/hmr/webpack-adapter.d.ts

@@ -0,0 +1,20 @@
+import { Config } from '../config.js';
+import type * as t from '@babel/types';
+/**
+ * Emits HMR accept code for bundlers with webpack-compatible `module.hot`
+ * semantics (classic webpack via `import.meta.webpackHot`, and Rspack).
+ *
+ * Unlike Vite's `hot.accept((newModule) => {...})` — where the callback receives
+ * the freshly re-imported module — webpack re-executes the module factory on
+ * accept, so our HMR logic must live at module top level and read the previous
+ * `routeId` out of `hot.data`. `hot.dispose` stashes it for the next run, and
+ * `hot.accept()` (no callback) enrolls us as a self-accepting boundary.
+ *
+ * Returns an array of statements so that for React we can prepend an
+ * `import { performReactRefresh } from 'react-refresh/runtime'` hoisted to the
+ * top of the module.
+ */
+export declare function createWebpackHmrStatement(stableRouteOptionKeys: Array<string>, opts: {
+    targetFramework: Config['target'];
+    routeId?: string;
+}): Array<t.Statement>;

package/dist/esm/core/hmr/webpack-adapter.js

@@ -0,0 +1,62 @@
+import { getHandleRouteUpdateCode } from "./handle-route-update.js";
+import * as template from "@babel/template";
+//#region src/core/hmr/webpack-adapter.ts
+/**
+* Emits HMR accept code for bundlers with webpack-compatible `module.hot`
+* semantics (classic webpack via `import.meta.webpackHot`, and Rspack).
+*
+* Unlike Vite's `hot.accept((newModule) => {...})` — where the callback receives
+* the freshly re-imported module — webpack re-executes the module factory on
+* accept, so our HMR logic must live at module top level and read the previous
+* `routeId` out of `hot.data`. `hot.dispose` stashes it for the next run, and
+* `hot.accept()` (no callback) enrolls us as a self-accepting boundary.
+*
+* Returns an array of statements so that for React we can prepend an
+* `import { performReactRefresh } from 'react-refresh/runtime'` hoisted to the
+* top of the module.
+*/
+function createWebpackHmrStatement(stableRouteOptionKeys, opts) {
+	const handleRouteUpdateCode = getHandleRouteUpdateCode(stableRouteOptionKeys);
+	const staticRouteIdLiteral = typeof opts.routeId === "string" ? JSON.stringify(opts.routeId) : "undefined";
+	const statements = [];
+	const reactRefreshCall = opts.targetFramework === "react" ? `
+    const tsrRefreshState = globalThis.__TSR_HMR__ ??= {}
+    try {
+      if (!tsrRefreshState.refreshScheduled) {
+        tsrRefreshState.refreshScheduled = true
+        setTimeout(() => {
+          tsrRefreshState.refreshScheduled = false
+          try { __tsr_performReactRefresh() } catch (_e) { /* noop */ }
+        }, 30)
+      }
+    } catch (_err) { /* noop */ }` : "";
+	if (opts.targetFramework === "react") statements.push(template.statement(`import { performReactRefresh as __tsr_performReactRefresh } from 'react-refresh/runtime'`)());
+	statements.push(template.statement(`
+if (import.meta.webpackHot) {
+  const hot = import.meta.webpackHot
+  const hotData = hot.data ??= {}
+  const routeId = hotData['tsr-route-id'] ?? Route.id ?? (Route.isRoot ? '__root__' : ${staticRouteIdLiteral})
+  if (routeId) {
+    hotData['tsr-route-id'] = routeId
+  }
+  const existingRoute =
+    typeof window !== 'undefined' && routeId
+      ? window.__TSR_ROUTER__?.routesById?.[routeId]
+      : undefined
+  if (routeId && existingRoute && existingRoute !== Route) {
+    (${handleRouteUpdateCode})(routeId, Route)${reactRefreshCall}
+  }
+  hot.dispose((data) => {
+    if (routeId) {
+      data['tsr-route-id'] = routeId
+    }
+  })
+  hot.accept()
+}
+`, { syntacticPlaceholders: true })());
+	return statements;
+}
+//#endregion
+export { createWebpackHmrStatement };
+
+//# sourceMappingURL=webpack-adapter.js.map

package/dist/esm/core/hmr/webpack-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webpack-adapter.js","names":[],"sources":["../../../../src/core/hmr/webpack-adapter.ts"],"sourcesContent":["import * as template from '@babel/template'\nimport { getHandleRouteUpdateCode } from './handle-route-update'\nimport type { Config } from '../config'\nimport type * as t from '@babel/types'\n\n/**\n * Emits HMR accept code for bundlers with webpack-compatible `module.hot`\n * semantics (classic webpack via `import.meta.webpackHot`, and Rspack).\n *\n * Unlike Vite's `hot.accept((newModule) => {...})` — where the callback receives\n * the freshly re-imported module — webpack re-executes the module factory on\n * accept, so our HMR logic must live at module top level and read the previous\n * `routeId` out of `hot.data`. `hot.dispose` stashes it for the next run, and\n * `hot.accept()` (no callback) enrolls us as a self-accepting boundary.\n *\n * Returns an array of statements so that for React we can prepend an\n * `import { performReactRefresh } from 'react-refresh/runtime'` hoisted to the\n * top of the module.\n */\nexport function createWebpackHmrStatement(\n  stableRouteOptionKeys: Array<string>,\n  opts: {\n    targetFramework: Config['target']\n    routeId?: string\n  },\n): Array<t.Statement> {\n  const handleRouteUpdateCode = getHandleRouteUpdateCode(stableRouteOptionKeys)\n  const staticRouteIdLiteral =\n    typeof opts.routeId === 'string'\n      ? JSON.stringify(opts.routeId)\n      : 'undefined'\n\n  const statements: Array<t.Statement> = []\n\n  // React-only: route modules aren't React Refresh \"boundaries\" (they export\n  // a non-component `Route`), so the bundler's react-refresh runtime won't\n  // call `performReactRefresh` for us. We kick it manually after swapping\n  // route options so newly-registered component bodies get patched into live\n  // fibers.\n  //\n  // We import `performReactRefresh` directly from `react-refresh/runtime` —\n  // the canonical public API — rather than relying on the ProvidePlugin-\n  // injected `__react_refresh_utils__` global, whose name is an internal\n  // detail of `@rspack/plugin-react-refresh`. The rspack plugin aliases\n  // `react-refresh` → its bundled runtime (getRefreshRuntimeDirPath), so this\n  // resolves to the same singleton the plugin itself uses and shares the\n  // registry React was patched against.\n  //\n  // Use the same delayed refresh style as Rspack's React Refresh runtime.\n  // Route modules and their split component chunks can arrive in separate HMR\n  // steps under CI load; a microtask can run before the split chunk registers\n  // its new component family, causing the refresh to no-op or remount.\n  //\n  // For non-React frameworks we skip this entirely.\n  const reactRefreshCall =\n    opts.targetFramework === 'react'\n      ? `\n    const tsrRefreshState = globalThis.__TSR_HMR__ ??= {}\n    try {\n      if (!tsrRefreshState.refreshScheduled) {\n        tsrRefreshState.refreshScheduled = true\n        setTimeout(() => {\n          tsrRefreshState.refreshScheduled = false\n          try { __tsr_performReactRefresh() } catch (_e) { /* noop */ }\n        }, 30)\n      }\n    } catch (_err) { /* noop */ }`\n      : ''\n\n  if (opts.targetFramework === 'react') {\n    statements.push(\n      template.statement(\n        `import { performReactRefresh as __tsr_performReactRefresh } from 'react-refresh/runtime'`,\n      )(),\n    )\n  }\n\n  statements.push(\n    template.statement(\n      `\nif (import.meta.webpackHot) {\n  const hot = import.meta.webpackHot\n  const hotData = hot.data ??= {}\n  const routeId = hotData['tsr-route-id'] ?? Route.id ?? (Route.isRoot ? '__root__' : ${staticRouteIdLiteral})\n  if (routeId) {\n    hotData['tsr-route-id'] = routeId\n  }\n  const existingRoute =\n    typeof window !== 'undefined' && routeId\n      ? window.__TSR_ROUTER__?.routesById?.[routeId]\n      : undefined\n  if (routeId && existingRoute && existingRoute !== Route) {\n    (${handleRouteUpdateCode})(routeId, Route)${reactRefreshCall}\n  }\n  hot.dispose((data) => {\n    if (routeId) {\n      data['tsr-route-id'] = routeId\n    }\n  })\n  hot.accept()\n}\n`,\n      {\n        syntacticPlaceholders: true,\n      },\n    )(),\n  )\n\n  return statements\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAmBA,SAAgB,0BACd,uBACA,MAIoB;CACpB,MAAM,wBAAwB,yBAAyB,sBAAsB;CAC7E,MAAM,uBACJ,OAAO,KAAK,YAAY,WACpB,KAAK,UAAU,KAAK,QAAQ,GAC5B;CAEN,MAAM,aAAiC,EAAE;CAsBzC,MAAM,mBACJ,KAAK,oBAAoB,UACrB;;;;;;;;;;qCAWA;AAEN,KAAI,KAAK,oBAAoB,QAC3B,YAAW,KACT,SAAS,UACP,2FACD,EAAE,CACJ;AAGH,YAAW,KACT,SAAS,UACP;;;;wFAIkF,qBAAqB;;;;;;;;;OAStG,sBAAsB,mBAAmB,iBAAiB;;;;;;;;;GAU3D,EACE,uBAAuB,MACxB,CACF,EAAE,CACJ;AAED,QAAO"}

package/dist/esm/core/router-code-splitter-plugin.js

@@ -1,5 +1,4 @@
 import { getConfig, splitGroupingsSchema } from "./config.js";
-import { resolveHmrHotExpression } from "./hmr-hot-expression.js";
 import { defaultCodeSplitGroupings, splitRouteIdentNodes, tsrShared, tsrSplit } from "./constants.js";
 import { debug, normalizePath } from "./utils.js";
 import { decodeIdentifier } from "./code-splitter/path-ids.js";
@@ -66,7 +65,7 @@ var unpluginRouterCodeSplitterFactory = (options = {}, { framework: _framework }
 				throw new Error(`The groupings for the route "${id}" are invalid.\n${message}`);
 			}
 		}
-		const pluginSplitBehavior = getShouldSplitFn()?.({ routeId: generatorNodeInfo.routePath });
+		const pluginSplitBehavior = getShouldSplitFn()?.({ routeId: generatorNodeInfo.routeId });
 		if (pluginSplitBehavior) {
 			const res = splitGroupingsSchema.safeParse(pluginSplitBehavior);
 			if (!res.success) {
@@ -82,7 +81,7 @@ var unpluginRouterCodeSplitterFactory = (options = {}, { framework: _framework }
 		if (sharedBindings.size > 0) sharedBindingsMap.set(id, sharedBindings);
 		else sharedBindingsMap.delete(id);
 		const addHmr = (userConfig.codeSplittingOptions?.addHmr ?? true) && !isProduction;
-		const hmrHotExpression = resolveHmrHotExpression(userConfig.plugin?.hmr?.hotExpression);
+		const hmrStyle = userConfig.plugin?.hmr?.style ?? "vite";
 		const compiledReferenceRoute = compileCodeSplitReferenceRoute({
 			code,
 			codeSplitGroupings: splitGroupings,
@@ -91,12 +90,13 @@ var unpluginRouterCodeSplitterFactory = (options = {}, { framework: _framework }
 			id,
 			deleteNodes: userConfig.codeSplittingOptions?.deleteNodes ? new Set(userConfig.codeSplittingOptions.deleteNodes) : void 0,
 			addHmr,
-			hmrHotExpression,
+			hmrStyle,
+			hmrRouteId: generatorNodeInfo.routeId,
 			sharedBindings: sharedBindings.size > 0 ? sharedBindings : void 0,
 			compilerPlugins: getReferenceRouteCompilerPlugins({
 				targetFramework: userConfig.target,
 				addHmr,
-				hmrHotExpression
+				hmrStyle
 			})
 		});
 		if (compiledReferenceRoute === null) {