@tanstack/router-plugin 1.167.30 → 1.167.32

package/dist/esm/vite.js

@@ -1,9 +1,11 @@
-import { configSchema } from "./core/config.js";
-import { unpluginRouterCodeSplitterFactory } from "./core/router-code-splitter-plugin.js";
-import { unpluginRouterGeneratorFactory } from "./core/router-generator-plugin.js";
+import { configSchema, getConfig } from "./core/config.js";
+import { createRouterPluginContext } from "./core/router-plugin-context.js";
+import { createRouterCodeSplitterPlugin } from "./core/router-code-splitter-plugin.js";
+import { createRouterGeneratorPlugin } from "./core/router-generator-plugin.js";
 import { unpluginRouterComposedFactory } from "./core/router-composed-plugin.js";
 import { createVitePlugin } from "unplugin";
 //#region src/vite.ts
+var defaultRouterPluginContext = createRouterPluginContext();
 /**
 * @example
 * ```ts
@@ -13,7 +15,10 @@ import { createVitePlugin } from "unplugin";
 * })
 * ```
 */
-var tanstackRouterGenerator = createVitePlugin(unpluginRouterGeneratorFactory);
+var tanstackRouterGenerator = (options, routerPluginContext) => {
+	const pluginContext = routerPluginContext ?? defaultRouterPluginContext;
+	return createVitePlugin((pluginOptions) => createRouterGeneratorPlugin(pluginOptions, pluginContext))(options);
+};
 /**
 * @example
 * ```ts
@@ -23,7 +28,10 @@ var tanstackRouterGenerator = createVitePlugin(unpluginRouterGeneratorFactory);
 * })
 * ```
 */
-var tanStackRouterCodeSplitter = createVitePlugin(unpluginRouterCodeSplitterFactory);
+var tanStackRouterCodeSplitter = (options, routerPluginContext) => {
+	const pluginContext = routerPluginContext ?? defaultRouterPluginContext;
+	return createVitePlugin((pluginOptions) => createRouterCodeSplitterPlugin(pluginOptions, pluginContext))(options);
+};
 /**
 * @example
 * ```ts
@@ -39,6 +47,6 @@ var tanstackRouter = createVitePlugin(unpluginRouterComposedFactory);
 */
 var TanStackRouterVite = tanstackRouter;
 //#endregion
-export { TanStackRouterVite, configSchema, tanstackRouter as default, tanstackRouter, tanStackRouterCodeSplitter, tanstackRouterGenerator };
+export { TanStackRouterVite, configSchema, tanstackRouter as default, tanstackRouter, getConfig, tanStackRouterCodeSplitter, tanstackRouterGenerator };
 
 //# sourceMappingURL=vite.js.map

package/dist/esm/vite.js.map

@@ -1 +1 @@
-{"version":3,"file":"vite.js","names":[],"sources":["../../src/vite.ts"],"sourcesContent":["import { createVitePlugin } from 'unplugin'\n\nimport { configSchema } from './core/config'\nimport { unpluginRouterCodeSplitterFactory } from './core/router-code-splitter-plugin'\nimport { unpluginRouterGeneratorFactory } from './core/router-generator-plugin'\nimport { unpluginRouterComposedFactory } from './core/router-composed-plugin'\nimport type { CodeSplittingOptions, Config, getConfig } from './core/config'\n\n/**\n * @example\n * ```ts\n * export default defineConfig({\n *   plugins: [tanstackRouterGenerator()],\n *   // ...\n * })\n * ```\n */\nconst tanstackRouterGenerator = createVitePlugin(unpluginRouterGeneratorFactory)\n\n/**\n * @example\n * ```ts\n * export default defineConfig({\n *   plugins: [tanStackRouterCodeSplitter()],\n *   // ...\n * })\n * ```\n */\nconst tanStackRouterCodeSplitter = createVitePlugin(\n  unpluginRouterCodeSplitterFactory,\n)\n\n/**\n * @example\n * ```ts\n * export default defineConfig({\n *   plugins: [tanstackRouter()],\n *   // ...\n * })\n * ```\n */\nconst tanstackRouter = createVitePlugin(unpluginRouterComposedFactory)\n\n/**\n * @deprecated Use `tanstackRouter` instead.\n */\nconst TanStackRouterVite = tanstackRouter\n\nexport default tanstackRouter\nexport {\n  configSchema,\n  getConfig,\n  tanStackRouterCodeSplitter,\n  tanstackRouterGenerator,\n  TanStackRouterVite,\n  tanstackRouter,\n}\n\nexport type { Config, CodeSplittingOptions }\n"],"mappings":";;;;;;;;;;;;;;;AAiBA,IAAM,0BAA0B,iBAAiB,+BAA+B;;;;;;;;;;AAWhF,IAAM,6BAA6B,iBACjC,kCACD;;;;;;;;;;AAWD,IAAM,iBAAiB,iBAAiB,8BAA8B;;;;AAKtE,IAAM,qBAAqB"}
+{"version":3,"file":"vite.js","names":[],"sources":["../../src/vite.ts"],"sourcesContent":["import { createVitePlugin } from 'unplugin'\n\nimport { configSchema, getConfig } from './core/config'\nimport { createRouterCodeSplitterPlugin } from './core/router-code-splitter-plugin'\nimport { createRouterGeneratorPlugin } from './core/router-generator-plugin'\nimport { unpluginRouterComposedFactory } from './core/router-composed-plugin'\nimport { createRouterPluginContext } from './core/router-plugin-context'\nimport type { CodeSplittingOptions, Config } from './core/config'\nimport type { RouterPluginContext } from './core/router-plugin-context'\n\ntype RouterPluginOptions = Partial<Config | (() => Config)> | undefined\n\nconst defaultRouterPluginContext = createRouterPluginContext()\n\n/**\n * @example\n * ```ts\n * export default defineConfig({\n *   plugins: [tanstackRouterGenerator()],\n *   // ...\n * })\n * ```\n */\nconst tanstackRouterGenerator = (\n  options?: RouterPluginOptions,\n  routerPluginContext?: RouterPluginContext,\n) => {\n  const pluginContext = routerPluginContext ?? defaultRouterPluginContext\n  return createVitePlugin((pluginOptions: RouterPluginOptions) =>\n    createRouterGeneratorPlugin(pluginOptions, pluginContext),\n  )(options)\n}\n\n/**\n * @example\n * ```ts\n * export default defineConfig({\n *   plugins: [tanStackRouterCodeSplitter()],\n *   // ...\n * })\n * ```\n */\nconst tanStackRouterCodeSplitter = (\n  options?: RouterPluginOptions,\n  routerPluginContext?: RouterPluginContext,\n) => {\n  const pluginContext = routerPluginContext ?? defaultRouterPluginContext\n  return createVitePlugin((pluginOptions: RouterPluginOptions) =>\n    createRouterCodeSplitterPlugin(pluginOptions, pluginContext),\n  )(options)\n}\n\n/**\n * @example\n * ```ts\n * export default defineConfig({\n *   plugins: [tanstackRouter()],\n *   // ...\n * })\n * ```\n */\nconst tanstackRouter = createVitePlugin(unpluginRouterComposedFactory)\n\n/**\n * @deprecated Use `tanstackRouter` instead.\n */\nconst TanStackRouterVite = tanstackRouter\n\nexport default tanstackRouter\nexport {\n  configSchema,\n  getConfig,\n  tanStackRouterCodeSplitter,\n  tanstackRouterGenerator,\n  TanStackRouterVite,\n  tanstackRouter,\n}\n\nexport type { Config, CodeSplittingOptions, RouterPluginContext }\n"],"mappings":";;;;;;;AAYA,IAAM,6BAA6B,2BAA2B;;;;;;;;;;AAW9D,IAAM,2BACJ,SACA,wBACG;CACH,MAAM,gBAAgB,uBAAuB;AAC7C,QAAO,kBAAkB,kBACvB,4BAA4B,eAAe,cAAc,CAC1D,CAAC,QAAQ;;;;;;;;;;;AAYZ,IAAM,8BACJ,SACA,wBACG;CACH,MAAM,gBAAgB,uBAAuB;AAC7C,QAAO,kBAAkB,kBACvB,+BAA+B,eAAe,cAAc,CAC7D,CAAC,QAAQ;;;;;;;;;;;AAYZ,IAAM,iBAAiB,iBAAiB,8BAA8B;;;;AAKtE,IAAM,qBAAqB"}

package/dist/esm/webpack.d.ts

@@ -1,4 +1,5 @@
 import { configSchema, CodeSplittingOptions, Config } from './core/config.js';
+import { RouterPluginContext } from './core/router-plugin-context.js';
 /**
  * @example
  * ```ts
@@ -8,53 +9,7 @@ import { configSchema, CodeSplittingOptions, Config } from './core/config.js';
  * }
  * ```
  */
-declare const TanStackRouterGeneratorWebpack: (options?: Partial<{
-    target: "react" | "solid" | "vue";
-    routeFileIgnorePrefix: string;
-    routesDirectory: string;
-    quoteStyle: "single" | "double";
-    semicolons: boolean;
-    disableLogging: boolean;
-    routeTreeFileHeader: string[];
-    indexToken: string | RegExp | {
-        regex: string;
-        flags?: string | undefined;
-    };
-    routeToken: string | RegExp | {
-        regex: string;
-        flags?: string | undefined;
-    };
-    generatedRouteTree: string;
-    disableTypes: boolean;
-    addExtensions: string | boolean;
-    enableRouteTreeFormatting: boolean;
-    tmpDir: string;
-    importRoutesUsingAbsolutePaths: boolean;
-    enableRouteGeneration?: boolean | undefined;
-    codeSplittingOptions?: CodeSplittingOptions | undefined;
-    plugin?: {
-        vite?: {
-            environmentName?: string | undefined;
-        } | undefined;
-        hmr?: {
-            style?: "vite" | "webpack" | undefined;
-        } | undefined;
-    } | undefined;
-    virtualRouteConfig?: string | import('@tanstack/virtual-file-routes').VirtualRootRoute | undefined;
-    routeFilePrefix?: string | undefined;
-    routeFileIgnorePattern?: string | undefined;
-    pathParamsAllowedCharacters?: (";" | ":" | "@" | "&" | "=" | "+" | "$" | ",")[] | undefined;
-    routeTreeFileFooter?: string[] | ((...args: unknown[]) => string[]) | undefined;
-    autoCodeSplitting?: boolean | undefined;
-    customScaffolding?: {
-        routeTemplate?: string | undefined;
-        lazyRouteTemplate?: string | undefined;
-    } | undefined;
-    experimental?: {
-        enableCodeSplitting?: boolean | undefined;
-    } | undefined;
-    plugins?: import('@tanstack/router-generator').GeneratorPlugin[] | undefined;
-} | (() => Config)> | undefined) => import('unplugin').WebpackPluginInstance;
+declare const TanStackRouterGeneratorWebpack: (options?: Partial<Config>, routerPluginContext?: RouterPluginContext) => import('unplugin').WebpackPluginInstance;
 /**
  * @example
  * ```ts
@@ -64,7 +19,7 @@ declare const TanStackRouterGeneratorWebpack: (options?: Partial<{
  * }
  * ```
  */
-declare const TanStackRouterCodeSplitterWebpack: (options?: unknown) => import('unplugin').WebpackPluginInstance;
+declare const TanStackRouterCodeSplitterWebpack: (options?: Partial<Config>, routerPluginContext?: RouterPluginContext) => import('unplugin').WebpackPluginInstance;
 /**
  * @example
  * ```ts
@@ -78,4 +33,4 @@ declare const TanStackRouterWebpack: (options?: unknown) => import('unplugin').W
 declare const tanstackRouter: (options?: unknown) => import('unplugin').WebpackPluginInstance;
 export default TanStackRouterWebpack;
 export { configSchema, TanStackRouterWebpack, TanStackRouterGeneratorWebpack, TanStackRouterCodeSplitterWebpack, tanstackRouter, };
-export type { Config, CodeSplittingOptions };
+export type { Config, CodeSplittingOptions, RouterPluginContext };

package/dist/esm/webpack.js

@@ -1,9 +1,11 @@
 import { configSchema } from "./core/config.js";
-import { unpluginRouterCodeSplitterFactory } from "./core/router-code-splitter-plugin.js";
-import { unpluginRouterGeneratorFactory } from "./core/router-generator-plugin.js";
+import { createRouterPluginContext } from "./core/router-plugin-context.js";
+import { createRouterCodeSplitterPlugin } from "./core/router-code-splitter-plugin.js";
+import { createRouterGeneratorPlugin } from "./core/router-generator-plugin.js";
 import { unpluginRouterComposedFactory } from "./core/router-composed-plugin.js";
 import { createWebpackPlugin } from "unplugin";
 //#region src/webpack.ts
+var defaultRouterPluginContext = createRouterPluginContext();
 /**
 * Webpack uses `module.hot` / `import.meta.webpackHot` HMR. Force
 * `plugin.hmr.style = 'webpack'` so the router HMR adapter emits the correct
@@ -30,7 +32,10 @@ function withWebpackHmrStyle(options) {
 * }
 * ```
 */
-var TanStackRouterGeneratorWebpack = /* @__PURE__ */ createWebpackPlugin(unpluginRouterGeneratorFactory);
+var TanStackRouterGeneratorWebpack = (options, routerPluginContext) => {
+	const pluginContext = routerPluginContext ?? defaultRouterPluginContext;
+	return createWebpackPlugin((pluginOptions) => createRouterGeneratorPlugin(pluginOptions, pluginContext))(options);
+};
 /**
 * @example
 * ```ts
@@ -40,7 +45,10 @@ var TanStackRouterGeneratorWebpack = /* @__PURE__ */ createWebpackPlugin(unplugi
 * }
 * ```
 */
-var TanStackRouterCodeSplitterWebpack = /* @__PURE__ */ createWebpackPlugin((options, meta) => unpluginRouterCodeSplitterFactory(withWebpackHmrStyle(options), meta));
+var TanStackRouterCodeSplitterWebpack = (options, routerPluginContext) => {
+	const pluginContext = routerPluginContext ?? defaultRouterPluginContext;
+	return createWebpackPlugin((pluginOptions) => createRouterCodeSplitterPlugin(withWebpackHmrStyle(pluginOptions), pluginContext))(options);
+};
 /**
 * @example
 * ```ts

package/dist/esm/webpack.js.map

@@ -1 +1 @@
-{"version":3,"file":"webpack.js","names":[],"sources":["../../src/webpack.ts"],"sourcesContent":["import { createWebpackPlugin } from 'unplugin'\n\nimport { configSchema } from './core/config'\nimport { unpluginRouterCodeSplitterFactory } from './core/router-code-splitter-plugin'\nimport { unpluginRouterGeneratorFactory } from './core/router-generator-plugin'\nimport { unpluginRouterComposedFactory } from './core/router-composed-plugin'\nimport type { CodeSplittingOptions, Config } from './core/config'\n\n/**\n * Webpack uses `module.hot` / `import.meta.webpackHot` HMR. Force\n * `plugin.hmr.style = 'webpack'` so the router HMR adapter emits the correct\n * accept/dispose shape regardless of user config.\n */\nfunction withWebpackHmrStyle(\n  options: Partial<Config> | undefined,\n): Partial<Config> {\n  return {\n    ...options,\n    plugin: {\n      ...options?.plugin,\n      hmr: {\n        ...options?.plugin?.hmr,\n        style: 'webpack',\n      },\n    },\n  }\n}\n\n/**\n * @example\n * ```ts\n * export default {\n *   // ...\n *   plugins: [TanStackRouterGeneratorWebpack()],\n * }\n * ```\n */\nconst TanStackRouterGeneratorWebpack = /* #__PURE__ */ createWebpackPlugin(\n  unpluginRouterGeneratorFactory,\n)\n\n/**\n * @example\n * ```ts\n * export default {\n *   // ...\n *   plugins: [TanStackRouterCodeSplitterWebpack()],\n * }\n * ```\n */\nconst TanStackRouterCodeSplitterWebpack = /* #__PURE__ */ createWebpackPlugin(\n  (options, meta) =>\n    unpluginRouterCodeSplitterFactory(\n      withWebpackHmrStyle(options as Partial<Config> | undefined),\n      meta,\n    ),\n)\n\n/**\n * @example\n * ```ts\n * export default {\n *   // ...\n *   plugins: [tanstackRouter()],\n * }\n * ```\n */\nconst TanStackRouterWebpack = /* #__PURE__ */ createWebpackPlugin(\n  (options, meta) =>\n    unpluginRouterComposedFactory(\n      withWebpackHmrStyle(options as Partial<Config> | undefined),\n      meta,\n    ),\n)\n\nconst tanstackRouter = TanStackRouterWebpack\nexport default TanStackRouterWebpack\nexport {\n  configSchema,\n  TanStackRouterWebpack,\n  TanStackRouterGeneratorWebpack,\n  TanStackRouterCodeSplitterWebpack,\n  tanstackRouter,\n}\nexport type { Config, CodeSplittingOptions }\n"],"mappings":";;;;;;;;;;;AAaA,SAAS,oBACP,SACiB;AACjB,QAAO;EACL,GAAG;EACH,QAAQ;GACN,GAAG,SAAS;GACZ,KAAK;IACH,GAAG,SAAS,QAAQ;IACpB,OAAO;IACR;GACF;EACF;;;;;;;;;;;AAYH,IAAM,iCAAiD,oCACrD,+BACD;;;;;;;;;;AAWD,IAAM,oCAAoD,qCACvD,SAAS,SACR,kCACE,oBAAoB,QAAuC,EAC3D,KACD,CACJ;;;;;;;;;;AAWD,IAAM,wBAAwC,qCAC3C,SAAS,SACR,8BACE,oBAAoB,QAAuC,EAC3D,KACD,CACJ;AAED,IAAM,iBAAiB"}
+{"version":3,"file":"webpack.js","names":[],"sources":["../../src/webpack.ts"],"sourcesContent":["import { createWebpackPlugin } from 'unplugin'\n\nimport { configSchema } from './core/config'\nimport { createRouterCodeSplitterPlugin } from './core/router-code-splitter-plugin'\nimport { createRouterGeneratorPlugin } from './core/router-generator-plugin'\nimport { unpluginRouterComposedFactory } from './core/router-composed-plugin'\nimport { createRouterPluginContext } from './core/router-plugin-context'\nimport type { CodeSplittingOptions, Config } from './core/config'\nimport type { RouterPluginContext } from './core/router-plugin-context'\n\nconst defaultRouterPluginContext = createRouterPluginContext()\n\n/**\n * Webpack uses `module.hot` / `import.meta.webpackHot` HMR. Force\n * `plugin.hmr.style = 'webpack'` so the router HMR adapter emits the correct\n * accept/dispose shape regardless of user config.\n */\nfunction withWebpackHmrStyle(\n  options: Partial<Config> | undefined,\n): Partial<Config> {\n  return {\n    ...options,\n    plugin: {\n      ...options?.plugin,\n      hmr: {\n        ...options?.plugin?.hmr,\n        style: 'webpack',\n      },\n    },\n  }\n}\n\n/**\n * @example\n * ```ts\n * export default {\n *   // ...\n *   plugins: [TanStackRouterGeneratorWebpack()],\n * }\n * ```\n */\nconst TanStackRouterGeneratorWebpack = (\n  options?: Partial<Config>,\n  routerPluginContext?: RouterPluginContext,\n) => {\n  const pluginContext = routerPluginContext ?? defaultRouterPluginContext\n  return createWebpackPlugin((pluginOptions: Partial<Config> | undefined) =>\n    createRouterGeneratorPlugin(pluginOptions, pluginContext),\n  )(options)\n}\n\n/**\n * @example\n * ```ts\n * export default {\n *   // ...\n *   plugins: [TanStackRouterCodeSplitterWebpack()],\n * }\n * ```\n */\nconst TanStackRouterCodeSplitterWebpack = (\n  options?: Partial<Config>,\n  routerPluginContext?: RouterPluginContext,\n) => {\n  const pluginContext = routerPluginContext ?? defaultRouterPluginContext\n  return createWebpackPlugin((pluginOptions: Partial<Config> | undefined) =>\n    createRouterCodeSplitterPlugin(\n      withWebpackHmrStyle(pluginOptions),\n      pluginContext,\n    ),\n  )(options)\n}\n\n/**\n * @example\n * ```ts\n * export default {\n *   // ...\n *   plugins: [tanstackRouter()],\n * }\n * ```\n */\nconst TanStackRouterWebpack = /* #__PURE__ */ createWebpackPlugin(\n  (options, meta) =>\n    unpluginRouterComposedFactory(\n      withWebpackHmrStyle(options as Partial<Config> | undefined),\n      meta,\n    ),\n)\n\nconst tanstackRouter = TanStackRouterWebpack\nexport default TanStackRouterWebpack\nexport {\n  configSchema,\n  TanStackRouterWebpack,\n  TanStackRouterGeneratorWebpack,\n  TanStackRouterCodeSplitterWebpack,\n  tanstackRouter,\n}\nexport type { Config, CodeSplittingOptions, RouterPluginContext }\n"],"mappings":";;;;;;;AAUA,IAAM,6BAA6B,2BAA2B;;;;;;AAO9D,SAAS,oBACP,SACiB;AACjB,QAAO;EACL,GAAG;EACH,QAAQ;GACN,GAAG,SAAS;GACZ,KAAK;IACH,GAAG,SAAS,QAAQ;IACpB,OAAO;IACR;GACF;EACF;;;;;;;;;;;AAYH,IAAM,kCACJ,SACA,wBACG;CACH,MAAM,gBAAgB,uBAAuB;AAC7C,QAAO,qBAAqB,kBAC1B,4BAA4B,eAAe,cAAc,CAC1D,CAAC,QAAQ;;;;;;;;;;;AAYZ,IAAM,qCACJ,SACA,wBACG;CACH,MAAM,gBAAgB,uBAAuB;AAC7C,QAAO,qBAAqB,kBAC1B,+BACE,oBAAoB,cAAc,EAClC,cACD,CACF,CAAC,QAAQ;;;;;;;;;;;AAYZ,IAAM,wBAAwC,qCAC3C,SAAS,SACR,8BACE,oBAAoB,QAAuC,EAC3D,KACD,CACJ;AAED,IAAM,iBAAiB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/router-plugin",
-  "version": "1.167.30",
+  "version": "1.167.32",
   "description": "Modern and scalable routing for React applications",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -46,6 +46,16 @@
         "default": "./dist/cjs/vite.cjs"
       }
     },
+    "./context": {
+      "import": {
+        "types": "./dist/esm/context.d.ts",
+        "default": "./dist/esm/context.js"
+      },
+      "require": {
+        "types": "./dist/cjs/context.d.cts",
+        "default": "./dist/cjs/context.cjs"
+      }
+    },
     "./rspack": {
       "import": {
         "types": "./dist/esm/rspack.d.ts",
@@ -99,8 +109,8 @@
     "chokidar": "^3.6.0",
     "unplugin": "^3.0.0",
     "zod": "^3.24.2",
-    "@tanstack/router-core": "1.169.0",
-    "@tanstack/router-generator": "1.166.38",
+    "@tanstack/router-core": "1.169.1",
+    "@tanstack/router-generator": "1.166.39",
     "@tanstack/router-utils": "1.161.7",
     "@tanstack/virtual-file-routes": "1.161.7"
   },
@@ -116,7 +126,7 @@
     "vite": ">=5.0.0 || >=6.0.0 || >=7.0.0 || >=8.0.0",
     "vite-plugin-solid": "^2.11.10 || ^3.0.0-0",
     "webpack": ">=5.92.0",
-    "@tanstack/react-router": "^1.169.0"
+    "@tanstack/react-router": "^1.169.1"
   },
   "peerDependenciesMeta": {
     "@rsbuild/core": {

package/src/context.ts

@@ -0,0 +1,2 @@
+export { createRouterPluginContext } from './core/router-plugin-context'
+export type { RouterPluginContext } from './core/router-plugin-context'

package/src/core/router-code-splitter-plugin.ts

@@ -22,9 +22,11 @@ import {
 } from './constants'
 import { decodeIdentifier } from './code-splitter/path-ids'
 import { debug, normalizePath } from './utils'
+import { createRouterPluginContext } from './router-plugin-context'
 import type { CodeSplitGroupings, SplitRouteIdentNodes } from './constants'
 import type { GetRoutesByFileMapResultValue } from '@tanstack/router-generator'
 import type { Config } from './config'
+import type { RouterPluginContext } from './router-plugin-context'
 import type {
   UnpluginFactory,
   TransformResult as UnpluginTransformResult,
@@ -76,9 +78,10 @@ const TRANSFORMATION_PLUGINS_BY_FRAMEWORK: Record<
   ],
 }
 
-export const unpluginRouterCodeSplitterFactory: UnpluginFactory<
-  Partial<Config | (() => Config)> | undefined
-> = (options = {}, { framework: _framework }) => {
+export function createRouterCodeSplitterPlugin(
+  options: Partial<Config | (() => Config)> | undefined = {},
+  routerPluginContext: RouterPluginContext,
+): ReturnType<UnpluginFactory<Partial<Config | (() => Config)> | undefined>> {
   let ROOT: string = process.cwd()
   let userConfig: Config
 
@@ -259,7 +262,7 @@ export const unpluginRouterCodeSplitterFactory: UnpluginFactory<
         handler(code, id) {
           const normalizedId = normalizePath(id)
           const generatorFileInfo =
-            globalThis.TSR_ROUTES_BY_ID_MAP?.get(normalizedId)
+            routerPluginContext.routesByFile.get(normalizedId)
           if (
             generatorFileInfo &&
             includedCode.some((included) => code.includes(included))
@@ -402,3 +405,9 @@ export const unpluginRouterCodeSplitterFactory: UnpluginFactory<
     },
   ]
 }
+
+export const unpluginRouterCodeSplitterFactory: UnpluginFactory<
+  Partial<Config | (() => Config)> | undefined
+> = (options = {}) => {
+  return createRouterCodeSplitterPlugin(options, createRouterPluginContext())
+}

package/src/core/router-composed-plugin.ts

@@ -1,7 +1,8 @@
 import { getConfig } from '@tanstack/router-generator'
-import { unpluginRouterGeneratorFactory } from './router-generator-plugin'
-import { unpluginRouterCodeSplitterFactory } from './router-code-splitter-plugin'
-import { unpluginRouterHmrFactory } from './router-hmr-plugin'
+import { createRouterGeneratorPlugin } from './router-generator-plugin'
+import { createRouterCodeSplitterPlugin } from './router-code-splitter-plugin'
+import { createRouterHmrPlugin } from './router-hmr-plugin'
+import { createRouterPluginContext } from './router-plugin-context'
 import type { Config } from './config'
 import type {
   RspackCompiler,
@@ -29,25 +30,27 @@ function applyRspackInlineCssDefaultDefinePlugin(compiler: RspackCompiler) {
 
 export const unpluginRouterComposedFactory: UnpluginFactory<
   Partial<Config | (() => Config)> | undefined
-> = (options = {}, meta) => {
+> = (options = {}, _meta) => {
   const ROOT: string = process.cwd()
   const userConfig = getConfig(
     (typeof options === 'function' ? options() : options) as Partial<Config>,
     ROOT,
   )
+  const routerPluginContext = createRouterPluginContext()
 
-  const getPlugin = (
-    pluginFactory: UnpluginFactory<Partial<Config | (() => Config)>>,
-  ) => {
-    const plugin = pluginFactory(options, meta)
+  const getPlugin = (plugin: ReturnType<UnpluginFactory<any>>) => {
     if (!Array.isArray(plugin)) {
       return [plugin]
     }
     return plugin
   }
 
-  const routerGenerator = getPlugin(unpluginRouterGeneratorFactory)
-  const routerCodeSplitter = getPlugin(unpluginRouterCodeSplitterFactory)
+  const routerGenerator = getPlugin(
+    createRouterGeneratorPlugin(options, routerPluginContext),
+  )
+  const routerCodeSplitter = getPlugin(
+    createRouterCodeSplitterPlugin(options, routerPluginContext),
+  )
 
   const result = [
     {
@@ -85,7 +88,9 @@ export const unpluginRouterComposedFactory: UnpluginFactory<
   const isProduction = process.env.NODE_ENV === 'production'
 
   if (!isProduction && !userConfig.autoCodeSplitting) {
-    const routerHmr = getPlugin(unpluginRouterHmrFactory)
+    const routerHmr = getPlugin(
+      createRouterHmrPlugin(options, routerPluginContext),
+    )
     result.push(...routerHmr)
   }
   return result

package/src/core/router-generator-plugin.ts

@@ -1,17 +1,20 @@
 import { isAbsolute, join, normalize } from 'node:path'
 import { Generator, resolveConfigPath } from '@tanstack/router-generator'
 import { getConfig } from './config'
+import { createRouterPluginContext } from './router-plugin-context'
 
 import type { GeneratorEvent } from '@tanstack/router-generator'
 import type { FSWatcher } from 'chokidar'
 import type { UnpluginFactory } from 'unplugin'
 import type { Config } from './config'
+import type { RouterPluginContext } from './router-plugin-context'
 
 const PLUGIN_NAME = 'unplugin:router-generator'
 
-export const unpluginRouterGeneratorFactory: UnpluginFactory<
-  Partial<Config | (() => Config)> | undefined
-> = (options = {}) => {
+export function createRouterGeneratorPlugin(
+  options: Partial<Config | (() => Config)> | undefined = {},
+  routerPluginContext: RouterPluginContext,
+): ReturnType<UnpluginFactory<Partial<Config | (() => Config)> | undefined>> {
   let ROOT: string = process.cwd()
   let userConfig: Config
   let generator: Generator
@@ -58,7 +61,7 @@ export const unpluginRouterGeneratorFactory: UnpluginFactory<
 
     try {
       await generator.run(generatorEvent)
-      globalThis.TSR_ROUTES_BY_ID_MAP = generator.getRoutesByFileMap()
+      routerPluginContext.routesByFile = generator.getRoutesByFileMap()
     } catch (e) {
       console.error(e)
     }
@@ -146,3 +149,9 @@ export const unpluginRouterGeneratorFactory: UnpluginFactory<
     },
   }
 }
+
+export const unpluginRouterGeneratorFactory: UnpluginFactory<
+  Partial<Config | (() => Config)> | undefined
+> = (options = {}) => {
+  return createRouterGeneratorPlugin(options, createRouterPluginContext())
+}

package/src/core/router-hmr-plugin.ts

@@ -4,8 +4,10 @@ import { getReferenceRouteCompilerPlugins } from './code-splitter/plugins/framew
 import { createRouteHmrStatement } from './hmr'
 import { debug, normalizePath } from './utils'
 import { getConfig } from './config'
+import { createRouterPluginContext } from './router-plugin-context'
 import type { UnpluginFactory } from 'unplugin'
 import type { Config } from './config'
+import type { RouterPluginContext } from './router-plugin-context'
 
 /**
  * This plugin adds HMR support for file routes.
@@ -18,11 +20,18 @@ const includeCode = [
   'createRootRoute(',
   'createRootRouteWithContext(',
 ]
-export const unpluginRouterHmrFactory: UnpluginFactory<
-  Partial<Config> | undefined
-> = (options = {}) => {
+
+export function createRouterHmrPlugin(
+  options: Partial<Config | (() => Config)> | undefined = {},
+  routerPluginContext: RouterPluginContext,
+): ReturnType<UnpluginFactory<Partial<Config> | undefined>> {
   let ROOT: string = process.cwd()
-  let userConfig = options as Config
+
+  const resolveUserConfig = () => {
+    return getConfig(typeof options === 'function' ? options() : options, ROOT)
+  }
+
+  let userConfig = resolveUserConfig()
 
   return {
     name: 'tanstack-router:hmr',
@@ -37,7 +46,7 @@ export const unpluginRouterHmrFactory: UnpluginFactory<
       },
       handler(code, id) {
         const normalizedId = normalizePath(id)
-        const routeEntry = globalThis.TSR_ROUTES_BY_ID_MAP?.get(normalizedId)
+        const routeEntry = routerPluginContext.routesByFile.get(normalizedId)
         if (!routeEntry) {
           return null
         }
@@ -97,7 +106,7 @@ export const unpluginRouterHmrFactory: UnpluginFactory<
     vite: {
       configResolved(config) {
         ROOT = config.root
-        userConfig = getConfig(options, ROOT)
+        userConfig = resolveUserConfig()
       },
       applyToEnvironment(environment) {
         if (userConfig.plugin?.vite?.environmentName) {
@@ -108,3 +117,9 @@ export const unpluginRouterHmrFactory: UnpluginFactory<
     },
   }
 }
+
+export const unpluginRouterHmrFactory: UnpluginFactory<
+  Partial<Config> | undefined
+> = (options = {}) => {
+  return createRouterHmrPlugin(options, createRouterPluginContext())
+}

package/src/core/router-plugin-context.ts

@@ -0,0 +1,11 @@
+import type { GetRoutesByFileMapResult } from '@tanstack/router-generator'
+
+export type RouterPluginContext = {
+  routesByFile: GetRoutesByFileMapResult
+}
+
+export function createRouterPluginContext(): RouterPluginContext {
+  return {
+    routesByFile: new Map(),
+  }
+}

package/src/esbuild.ts

@@ -1,11 +1,17 @@
 import { createEsbuildPlugin } from 'unplugin'
 
 import { configSchema } from './core/config'
-import { unpluginRouterCodeSplitterFactory } from './core/router-code-splitter-plugin'
-import { unpluginRouterGeneratorFactory } from './core/router-generator-plugin'
+import { createRouterCodeSplitterPlugin } from './core/router-code-splitter-plugin'
+import { createRouterGeneratorPlugin } from './core/router-generator-plugin'
 import { unpluginRouterComposedFactory } from './core/router-composed-plugin'
+import { createRouterPluginContext } from './core/router-plugin-context'
 
 import type { CodeSplittingOptions, Config } from './core/config'
+import type { RouterPluginContext } from './core/router-plugin-context'
+
+type RouterPluginOptions = Partial<Config | (() => Config)> | undefined
+
+const defaultRouterPluginContext = createRouterPluginContext()
 
 /**
  * @example
@@ -16,9 +22,15 @@ import type { CodeSplittingOptions, Config } from './core/config'
  * }
  * ```
  */
-const TanStackRouterGeneratorEsbuild = createEsbuildPlugin(
-  unpluginRouterGeneratorFactory,
-)
+const TanStackRouterGeneratorEsbuild = (
+  options?: RouterPluginOptions,
+  routerPluginContext?: RouterPluginContext,
+) => {
+  const pluginContext = routerPluginContext ?? defaultRouterPluginContext
+  return createEsbuildPlugin((pluginOptions: RouterPluginOptions) =>
+    createRouterGeneratorPlugin(pluginOptions, pluginContext),
+  )(options)
+}
 
 /**
  * @example
@@ -29,9 +41,15 @@ const TanStackRouterGeneratorEsbuild = createEsbuildPlugin(
  * }
  * ```
  */
-const TanStackRouterCodeSplitterEsbuild = createEsbuildPlugin(
-  unpluginRouterCodeSplitterFactory,
-)
+const TanStackRouterCodeSplitterEsbuild = (
+  options?: RouterPluginOptions,
+  routerPluginContext?: RouterPluginContext,
+) => {
+  const pluginContext = routerPluginContext ?? defaultRouterPluginContext
+  return createEsbuildPlugin((pluginOptions: RouterPluginOptions) =>
+    createRouterCodeSplitterPlugin(pluginOptions, pluginContext),
+  )(options)
+}
 
 /**
  * @example
@@ -54,4 +72,4 @@ export {
   tanstackRouter,
 }
 
-export type { Config, CodeSplittingOptions }
+export type { Config, CodeSplittingOptions, RouterPluginContext }

package/src/index.ts

@@ -1,6 +1,7 @@
 export { configSchema, getConfig } from './core/config'
 export { unpluginRouterCodeSplitterFactory } from './core/router-code-splitter-plugin'
 export { unpluginRouterGeneratorFactory } from './core/router-generator-plugin'
+export { createRouterPluginContext } from './core/router-plugin-context'
 export type {
   Config,
   ConfigInput,
@@ -9,6 +10,7 @@ export type {
   DeletableNodes,
   HmrOptions,
 } from './core/config'
+export type { RouterPluginContext } from './core/router-plugin-context'
 export {
   tsrSplit,
   splitRouteIdentNodes,

package/src/rspack.ts

@@ -1,13 +1,17 @@
 import { createRspackPlugin } from 'unplugin'
 
 import { configSchema } from './core/config'
-import { unpluginRouterCodeSplitterFactory } from './core/router-code-splitter-plugin'
-import { unpluginRouterGeneratorFactory } from './core/router-generator-plugin'
+import { createRouterCodeSplitterPlugin } from './core/router-code-splitter-plugin'
+import { createRouterGeneratorPlugin } from './core/router-generator-plugin'
 import { unpluginRouterComposedFactory } from './core/router-composed-plugin'
+import { createRouterPluginContext } from './core/router-plugin-context'
 import type { CodeSplittingOptions, Config } from './core/config'
+import type { RouterPluginContext } from './core/router-plugin-context'
 
 type RspackRouterPluginOptions = Partial<Config> | (() => Partial<Config>)
 
+const defaultRouterPluginContext = createRouterPluginContext()
+
 /**
  * Rspack uses webpack-compatible `module.hot` / `import.meta.webpackHot` HMR.
  * Force `plugin.hmr.style = 'webpack'` so the router HMR adapter emits
@@ -50,9 +54,18 @@ function withWebpackHmrStyle(
  * })
  * ```
  */
-const TanStackRouterGeneratorRspack = /* #__PURE__ */ createRspackPlugin(
-  unpluginRouterGeneratorFactory,
-)
+const TanStackRouterGeneratorRspack = (
+  options?: RspackRouterPluginOptions,
+  routerPluginContext?: RouterPluginContext,
+) => {
+  const pluginContext = routerPluginContext ?? defaultRouterPluginContext
+  return createRspackPlugin((pluginOptions) =>
+    createRouterGeneratorPlugin(
+      pluginOptions as Partial<Config | (() => Config)> | undefined,
+      pluginContext,
+    ),
+  )(options)
+}
 
 /**
  * @example
@@ -67,15 +80,20 @@ const TanStackRouterGeneratorRspack = /* #__PURE__ */ createRspackPlugin(
  * })
  * ```
  */
-const TanStackRouterCodeSplitterRspack = /* #__PURE__ */ createRspackPlugin(
-  (options, meta) =>
-    unpluginRouterCodeSplitterFactory(
+const TanStackRouterCodeSplitterRspack = (
+  options?: RspackRouterPluginOptions,
+  routerPluginContext?: RouterPluginContext,
+) => {
+  const pluginContext = routerPluginContext ?? defaultRouterPluginContext
+  return createRspackPlugin((pluginOptions) =>
+    createRouterCodeSplitterPlugin(
       withWebpackHmrStyle(
-        options as RspackRouterPluginOptions | undefined,
+        pluginOptions as RspackRouterPluginOptions | undefined,
       ) as Partial<Config | (() => Config)>,
-      meta,
+      pluginContext,
     ),
-)
+  )(options)
+}
 
 /**
  * @example
@@ -108,4 +126,4 @@ export {
   TanStackRouterCodeSplitterRspack,
   tanstackRouter,
 }
-export type { Config, CodeSplittingOptions }
+export type { Config, CodeSplittingOptions, RouterPluginContext }