@tanstack/router-plugin 1.167.24 → 1.167.26

package/dist/cjs/core/hmr/webpack-adapter.cjs

@@ -13,27 +13,26 @@ _babel_template = require_runtime.__toESM(_babel_template);
 * `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.
+* Returns an array of statements that patches route definitions during HMR.
 */
 function createWebpackHmrStatement(stableRouteOptionKeys, opts) {
 	const handleRouteUpdateCode = require_handle_route_update.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)
+      const tsrReactRefreshUtils =
+        typeof __react_refresh_utils__ !== 'undefined'
+          ? __react_refresh_utils__
+          : undefined
+      const tsrEnqueueUpdate =
+        tsrReactRefreshUtils && typeof tsrReactRefreshUtils.enqueueUpdate === 'function'
+          ? tsrReactRefreshUtils.enqueueUpdate
+          : undefined
+      if (tsrEnqueueUpdate) {
+        tsrEnqueueUpdate(() => {})
       }
     } catch (_err) { /* noop */ }` : "";
-	if (opts.targetFramework === "react") statements.push(_babel_template.statement(`import { performReactRefresh as __tsr_performReactRefresh } from 'react-refresh/runtime'`)());
-	statements.push(_babel_template.statement(`
+	return [_babel_template.statement(`
 if (import.meta.webpackHot) {
   const hot = import.meta.webpackHot
   const hotData = hot.data ??= {}
@@ -55,8 +54,7 @@ if (import.meta.webpackHot) {
   })
   hot.accept()
 }
-`, { syntacticPlaceholders: true })());
-	return statements;
+`, { syntacticPlaceholders: true })()];
 }
 //#endregion
 exports.createWebpackHmrStatement = createWebpackHmrStatement;

package/dist/cjs/core/hmr/webpack-adapter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"webpack-adapter.cjs","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,4BAAA,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,gBAAS,UACP,2FACD,EAAE,CACJ;AAGH,YAAW,KACT,gBAAS,UACP;;;;wFAIkF,qBAAqB;;;;;;;;;OAStG,sBAAsB,mBAAmB,iBAAiB;;;;;;;;;GAU3D,EACE,uBAAuB,MACxB,CACF,EAAE,CACJ;AAED,QAAO"}
+{"version":3,"file":"webpack-adapter.cjs","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 that patches route definitions during HMR.\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  // 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  // Webpack and Rspack refresh plugins inject `__react_refresh_utils__` via\n  // ProvidePlugin. Use it when present instead of importing\n  // `react-refresh/runtime`, because Rsbuild apps may use React without the\n  // React plugin and therefore may not have that optional dependency installed.\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    try {\n      const tsrReactRefreshUtils =\n        typeof __react_refresh_utils__ !== 'undefined'\n          ? __react_refresh_utils__\n          : undefined\n      const tsrEnqueueUpdate =\n        tsrReactRefreshUtils && typeof tsrReactRefreshUtils.enqueueUpdate === 'function'\n          ? tsrReactRefreshUtils.enqueueUpdate\n          : undefined\n      if (tsrEnqueueUpdate) {\n        tsrEnqueueUpdate(() => {})\n      }\n    } catch (_err) { /* noop */ }`\n      : ''\n\n  return [\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"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,SAAgB,0BACd,uBACA,MAIoB;CACpB,MAAM,wBAAwB,4BAAA,yBAAyB,sBAAsB;CAC7E,MAAM,uBACJ,OAAO,KAAK,YAAY,WACpB,KAAK,UAAU,KAAK,QAAQ,GAC5B;CAmBN,MAAM,mBACJ,KAAK,oBAAoB,UACrB;;;;;;;;;;;;;qCAcA;AAEN,QAAO,CACL,gBAAS,UACP;;;;wFAIkF,qBAAqB;;;;;;;;;OAStG,sBAAsB,mBAAmB,iBAAiB;;;;;;;;;GAU3D,EACE,uBAAuB,MACxB,CACF,EAAE,CACJ"}

package/dist/cjs/core/hmr/webpack-adapter.d.cts

@@ -10,9 +10,7 @@ import type * as t from '@babel/types';
  * `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.
+ * Returns an array of statements that patches route definitions during HMR.
  */
 export declare function createWebpackHmrStatement(stableRouteOptionKeys: Array<string>, opts: {
     targetFramework: Config['target'];

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

@@ -10,9 +10,7 @@ import type * as t from '@babel/types';
  * `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.
+ * Returns an array of statements that patches route definitions during HMR.
  */
 export declare function createWebpackHmrStatement(stableRouteOptionKeys: Array<string>, opts: {
     targetFramework: Config['target'];

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

@@ -11,27 +11,26 @@ import * as template from "@babel/template";
 * `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.
+* Returns an array of statements that patches route definitions during HMR.
 */
 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)
+      const tsrReactRefreshUtils =
+        typeof __react_refresh_utils__ !== 'undefined'
+          ? __react_refresh_utils__
+          : undefined
+      const tsrEnqueueUpdate =
+        tsrReactRefreshUtils && typeof tsrReactRefreshUtils.enqueueUpdate === 'function'
+          ? tsrReactRefreshUtils.enqueueUpdate
+          : undefined
+      if (tsrEnqueueUpdate) {
+        tsrEnqueueUpdate(() => {})
       }
     } catch (_err) { /* noop */ }` : "";
-	if (opts.targetFramework === "react") statements.push(template.statement(`import { performReactRefresh as __tsr_performReactRefresh } from 'react-refresh/runtime'`)());
-	statements.push(template.statement(`
+	return [template.statement(`
 if (import.meta.webpackHot) {
   const hot = import.meta.webpackHot
   const hotData = hot.data ??= {}
@@ -53,8 +52,7 @@ if (import.meta.webpackHot) {
   })
   hot.accept()
 }
-`, { syntacticPlaceholders: true })());
-	return statements;
+`, { syntacticPlaceholders: true })()];
 }
 //#endregion
 export { createWebpackHmrStatement };

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

@@ -1 +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"}
+{"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 that patches route definitions during HMR.\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  // 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  // Webpack and Rspack refresh plugins inject `__react_refresh_utils__` via\n  // ProvidePlugin. Use it when present instead of importing\n  // `react-refresh/runtime`, because Rsbuild apps may use React without the\n  // React plugin and therefore may not have that optional dependency installed.\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    try {\n      const tsrReactRefreshUtils =\n        typeof __react_refresh_utils__ !== 'undefined'\n          ? __react_refresh_utils__\n          : undefined\n      const tsrEnqueueUpdate =\n        tsrReactRefreshUtils && typeof tsrReactRefreshUtils.enqueueUpdate === 'function'\n          ? tsrReactRefreshUtils.enqueueUpdate\n          : undefined\n      if (tsrEnqueueUpdate) {\n        tsrEnqueueUpdate(() => {})\n      }\n    } catch (_err) { /* noop */ }`\n      : ''\n\n  return [\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"],"mappings":";;;;;;;;;;;;;;;AAiBA,SAAgB,0BACd,uBACA,MAIoB;CACpB,MAAM,wBAAwB,yBAAyB,sBAAsB;CAC7E,MAAM,uBACJ,OAAO,KAAK,YAAY,WACpB,KAAK,UAAU,KAAK,QAAQ,GAC5B;CAmBN,MAAM,mBACJ,KAAK,oBAAoB,UACrB;;;;;;;;;;;;;qCAcA;AAEN,QAAO,CACL,SAAS,UACP;;;;wFAIkF,qBAAqB;;;;;;;;;OAStG,sBAAsB,mBAAmB,iBAAiB;;;;;;;;;GAU3D,EACE,uBAAuB,MACxB,CACF,EAAE,CACJ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/router-plugin",
-  "version": "1.167.24",
+  "version": "1.167.26",
   "description": "Modern and scalable routing for React applications",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -97,7 +97,7 @@
     "@babel/traverse": "^7.28.5",
     "@babel/types": "^7.28.5",
     "chokidar": "^3.6.0",
-    "unplugin": "^2.1.2",
+    "unplugin": "^3.0.0",
     "zod": "^3.24.2",
     "@tanstack/router-core": "1.168.16",
     "@tanstack/router-generator": "1.166.34",

package/src/core/hmr/webpack-adapter.ts

@@ -13,9 +13,7 @@ import type * as t from '@babel/types'
  * `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.
+ * Returns an array of statements that patches route definitions during HMR.
  */
 export function createWebpackHmrStatement(
   stableRouteOptionKeys: Array<string>,
@@ -30,21 +28,16 @@ export function createWebpackHmrStatement(
       ? JSON.stringify(opts.routeId)
       : 'undefined'
 
-  const statements: Array<t.Statement> = []
-
   // React-only: route modules aren't React Refresh "boundaries" (they export
   // a non-component `Route`), so the bundler's react-refresh runtime won't
   // call `performReactRefresh` for us. We kick it manually after swapping
   // route options so newly-registered component bodies get patched into live
   // fibers.
   //
-  // We import `performReactRefresh` directly from `react-refresh/runtime` —
-  // the canonical public API — rather than relying on the ProvidePlugin-
-  // injected `__react_refresh_utils__` global, whose name is an internal
-  // detail of `@rspack/plugin-react-refresh`. The rspack plugin aliases
-  // `react-refresh` → its bundled runtime (getRefreshRuntimeDirPath), so this
-  // resolves to the same singleton the plugin itself uses and shares the
-  // registry React was patched against.
+  // Webpack and Rspack refresh plugins inject `__react_refresh_utils__` via
+  // ProvidePlugin. Use it when present instead of importing
+  // `react-refresh/runtime`, because Rsbuild apps may use React without the
+  // React plugin and therefore may not have that optional dependency installed.
   //
   // Use the same delayed refresh style as Rspack's React Refresh runtime.
   // Route modules and their split component chunks can arrive in separate HMR
@@ -55,27 +48,22 @@ export function createWebpackHmrStatement(
   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)
+      const tsrReactRefreshUtils =
+        typeof __react_refresh_utils__ !== 'undefined'
+          ? __react_refresh_utils__
+          : undefined
+      const tsrEnqueueUpdate =
+        tsrReactRefreshUtils && typeof tsrReactRefreshUtils.enqueueUpdate === 'function'
+          ? tsrReactRefreshUtils.enqueueUpdate
+          : undefined
+      if (tsrEnqueueUpdate) {
+        tsrEnqueueUpdate(() => {})
       }
     } catch (_err) { /* noop */ }`
       : ''
 
-  if (opts.targetFramework === 'react') {
-    statements.push(
-      template.statement(
-        `import { performReactRefresh as __tsr_performReactRefresh } from 'react-refresh/runtime'`,
-      )(),
-    )
-  }
-
-  statements.push(
+  return [
     template.statement(
       `
 if (import.meta.webpackHot) {
@@ -104,7 +92,5 @@ if (import.meta.webpackHot) {
         syntacticPlaceholders: true,
       },
     )(),
-  )
-
-  return statements
+  ]
 }