@tanstack/router-plugin 1.167.0 → 1.167.2

package/dist/cjs/core/code-splitter/plugins/framework-plugins.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"framework-plugins.cjs","names":[],"sources":["../../../../../src/core/code-splitter/plugins/framework-plugins.ts"],"sourcesContent":["import { createReactRefreshRouteComponentsPlugin } from './react-refresh-route-components'\nimport type { ReferenceRouteCompilerPlugin } from '../plugins'\nimport type { Config } from '../../config'\n\nexport function getReferenceRouteCompilerPlugins(opts: {\n  targetFramework: Config['target']\n  addHmr?: boolean\n}): Array<ReferenceRouteCompilerPlugin> | undefined {\n  switch (opts.targetFramework) {\n    case 'react': {\n      if (opts.addHmr) {\n        return [createReactRefreshRouteComponentsPlugin()]\n      }\n      return undefined\n    }\n    default:\n      return undefined\n  }\n}\n"],"mappings":";;AAIA,SAAgB,iCAAiC,MAGG;AAClD,SAAQ,KAAK,iBAAb;EACE,KAAK;AACH,OAAI,KAAK,OACP,QAAO,CAAC,uCAAA,yCAAyC,CAAC;AAEpD;EAEF,QACE"}
+{"version":3,"file":"framework-plugins.cjs","names":[],"sources":["../../../../../src/core/code-splitter/plugins/framework-plugins.ts"],"sourcesContent":["import { createReactRefreshRouteComponentsPlugin } from './react-refresh-route-components'\nimport { createReactStableHmrSplitRouteComponentsPlugin } from './react-stable-hmr-split-route-components'\nimport type { ReferenceRouteCompilerPlugin } from '../plugins'\nimport type { Config } from '../../config'\n\nexport function getReferenceRouteCompilerPlugins(opts: {\n  targetFramework: Config['target']\n  addHmr?: boolean\n}): Array<ReferenceRouteCompilerPlugin> | undefined {\n  switch (opts.targetFramework) {\n    case 'react': {\n      if (opts.addHmr) {\n        return [\n          createReactRefreshRouteComponentsPlugin(),\n          createReactStableHmrSplitRouteComponentsPlugin(),\n        ]\n      }\n      return undefined\n    }\n    default:\n      return undefined\n  }\n}\n"],"mappings":";;;AAKA,SAAgB,iCAAiC,MAGG;AAClD,SAAQ,KAAK,iBAAb;EACE,KAAK;AACH,OAAI,KAAK,OACP,QAAO,CACL,uCAAA,yCAAyC,EACzC,gDAAA,gDAAgD,CACjD;AAEH;EAEF,QACE"}

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

@@ -0,0 +1,41 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+const require_utils = require("../../utils.cjs");
+let _babel_types = require("@babel/types");
+_babel_types = require_runtime.__toESM(_babel_types);
+let _babel_template = require("@babel/template");
+_babel_template = require_runtime.__toESM(_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);
+}
+function createHotDataKey(exportName) {
+	return `tsr-split-component:${exportName}`;
+}
+var buildStableSplitComponentStatements = _babel_template.statements(`
+    const %%stableComponentIdent%% = import.meta.hot?.data?.[%%hotDataKey%%] ?? %%lazyRouteComponentIdent%%(%%localImporterIdent%%, %%exporterIdent%%)
+    if (import.meta.hot) {
+      import.meta.hot.data[%%hotDataKey%%] = %%stableComponentIdent%%
+    }
+  `, { syntacticPlaceholders: true });
+function createReactStableHmrSplitRouteComponentsPlugin() {
+	return {
+		name: "react-stable-hmr-split-route-components",
+		onSplitRouteProperty(ctx) {
+			if (ctx.splitNodeMeta.splitStrategy !== "lazyRouteComponent") return;
+			const stableComponentIdent = require_utils.getUniqueProgramIdentifier(ctx.programPath, `TSRSplit${capitalizeIdentifier(ctx.splitNodeMeta.exporterIdent)}`);
+			const hotDataKey = createHotDataKey(ctx.splitNodeMeta.exporterIdent);
+			ctx.insertionPath.insertBefore(buildStableSplitComponentStatements({
+				stableComponentIdent,
+				hotDataKey: _babel_types.stringLiteral(hotDataKey),
+				lazyRouteComponentIdent: _babel_types.identifier(ctx.lazyRouteComponentIdent),
+				localImporterIdent: _babel_types.identifier(ctx.splitNodeMeta.localImporterIdent),
+				exporterIdent: _babel_types.stringLiteral(ctx.splitNodeMeta.exporterIdent)
+			}));
+			return _babel_types.identifier(stableComponentIdent.name);
+		}
+	};
+}
+//#endregion
+exports.createReactStableHmrSplitRouteComponentsPlugin = createReactStableHmrSplitRouteComponentsPlugin;
+
+//# sourceMappingURL=react-stable-hmr-split-route-components.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"react-stable-hmr-split-route-components.cjs","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 { 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%% = import.meta.hot?.data?.[%%hotDataKey%%] ?? %%lazyRouteComponentIdent%%(%%localImporterIdent%%, %%exporterIdent%%)\n    if (import.meta.hot) {\n      import.meta.hot.data[%%hotDataKey%%] = %%stableComponentIdent%%\n    }\n  `,\n  {\n    syntacticPlaceholders: true,\n  },\n)\n\nexport function createReactStableHmrSplitRouteComponentsPlugin(): 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          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":";;;;;;;AAKA,SAAS,qBAAqB,KAAa;AACzC,QAAO,IAAI,GAAI,aAAa,GAAG,IAAI,MAAM,EAAE;;AAG7C,SAAS,iBAAiB,YAAoB;AAC5C,QAAO,uBAAuB;;AAGhC,IAAM,sCAAsC,gBAAS,WACnD;;;;;KAMA,EACE,uBAAuB,MACxB,CACF;AAED,SAAgB,iDAA+E;AAC7F,QAAO;EACL,MAAM;EACN,qBAAqB,KAAK;AACxB,OAAI,IAAI,cAAc,kBAAkB,qBACtC;GAGF,MAAM,uBAAuB,cAAA,2BAC3B,IAAI,aACJ,WAAW,qBAAqB,IAAI,cAAc,cAAc,GACjE;GAED,MAAM,aAAa,iBAAiB,IAAI,cAAc,cAAc;AAEpE,OAAI,cAAc,aAChB,oCAAoC;IAClC;IACA,YAAY,aAAE,cAAc,WAAW;IACvC,yBAAyB,aAAE,WAAW,IAAI,wBAAwB;IAClE,oBAAoB,aAAE,WACpB,IAAI,cAAc,mBACnB;IACD,eAAe,aAAE,cAAc,IAAI,cAAc,cAAc;IAChE,CAAC,CACH;AAED,UAAO,aAAE,WAAW,qBAAqB,KAAK;;EAEjD"}

package/dist/cjs/core/code-splitter/plugins/react-stable-hmr-split-route-components.d.cts

@@ -0,0 +1,2 @@
+import { ReferenceRouteCompilerPlugin } from '../plugins.cjs';
+export declare function createReactStableHmrSplitRouteComponentsPlugin(): ReferenceRouteCompilerPlugin;

package/dist/cjs/core/code-splitter/plugins.d.cts

@@ -1,6 +1,7 @@
 import { default as babel } from '@babel/core';
 import { Config, DeletableNodes } from '../config.cjs';
 import { CodeSplitGroupings } from '../constants.cjs';
+import { SplitNodeMeta } from './types.cjs';
 import type * as t from '@babel/types';
 export type CompileCodeSplitReferenceRouteOptions = {
     codeSplitGroupings: CodeSplitGroupings;
@@ -19,10 +20,20 @@ export type ReferenceRouteCompilerPluginContext = {
     createRouteFn: string;
     opts: CompileCodeSplitReferenceRouteOptions;
 };
+export type ReferenceRouteSplitPropertyCompilerPluginContext = {
+    programPath: babel.NodePath<t.Program>;
+    callExpressionPath: babel.NodePath<t.CallExpression>;
+    insertionPath: babel.NodePath;
+    routeOptions: t.ObjectExpression;
+    prop: t.ObjectProperty;
+    splitNodeMeta: SplitNodeMeta;
+    lazyRouteComponentIdent: string;
+};
 export type ReferenceRouteCompilerPluginResult = {
     modified?: boolean;
 };
 export type ReferenceRouteCompilerPlugin = {
     name: string;
     onUnsplittableRoute?: (ctx: ReferenceRouteCompilerPluginContext) => void | ReferenceRouteCompilerPluginResult;
+    onSplitRouteProperty?: (ctx: ReferenceRouteSplitPropertyCompilerPluginContext) => void | t.Expression;
 };

package/dist/cjs/core/code-splitter/types.d.cts

@@ -0,0 +1,9 @@
+import { SplitRouteIdentNodes } from '../constants.cjs';
+export type SplitStrategy = 'lazyFn' | 'lazyRouteComponent';
+export type SplitNodeMeta = {
+    routeIdent: SplitRouteIdentNodes;
+    splitStrategy: SplitStrategy;
+    localImporterIdent: string;
+    exporterIdent: string;
+    localExporterIdent: string;
+};

package/dist/cjs/core/utils.cjs

@@ -16,10 +16,12 @@ function normalizePath(path) {
 function getUniqueProgramIdentifier(programPath, baseName) {
 	let name = baseName;
 	let suffix = 2;
-	while (programPath.scope.hasBinding(name) || programPath.scope.hasGlobal(name)) {
+	const programScope = programPath.scope.getProgramParent();
+	while (programScope.hasBinding(name) || programScope.hasGlobal(name) || programScope.hasReference(name)) {
 		name = `${baseName}${suffix}`;
 		suffix++;
 	}
+	programScope.references[name] = true;
 	return _babel_types.identifier(name);
 }
 //#endregion

package/dist/cjs/core/utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.cjs","names":[],"sources":["../../../src/core/utils.ts"],"sourcesContent":["import * as t from '@babel/types'\nimport type babel from '@babel/core'\n\nexport const debug =\n  process.env.TSR_VITE_DEBUG &&\n  ['true', 'router-plugin'].includes(process.env.TSR_VITE_DEBUG)\n\n/**\n * Normalizes a file path by converting Windows backslashes to forward slashes.\n * This ensures consistent path handling across different bundlers and operating systems.\n *\n * The route generator stores paths with forward slashes, but rspack/webpack on Windows\n * pass native paths with backslashes to transform handlers.\n */\nexport function normalizePath(path: string): string {\n  return path.replace(/\\\\/g, '/')\n}\n\nexport function getUniqueProgramIdentifier(\n  programPath: babel.NodePath<t.Program>,\n  baseName: string,\n): t.Identifier {\n  let name = baseName\n  let suffix = 2\n\n  while (\n    programPath.scope.hasBinding(name) ||\n    programPath.scope.hasGlobal(name)\n  ) {\n    name = `${baseName}${suffix}`\n    suffix++\n  }\n\n  return t.identifier(name)\n}\n"],"mappings":";;;;AAGA,IAAa,QACX,QAAQ,IAAI,kBACZ,CAAC,QAAQ,gBAAgB,CAAC,SAAS,QAAQ,IAAI,eAAe;;;;;;;;AAShE,SAAgB,cAAc,MAAsB;AAClD,QAAO,KAAK,QAAQ,OAAO,IAAI;;AAGjC,SAAgB,2BACd,aACA,UACc;CACd,IAAI,OAAO;CACX,IAAI,SAAS;AAEb,QACE,YAAY,MAAM,WAAW,KAAK,IAClC,YAAY,MAAM,UAAU,KAAK,EACjC;AACA,SAAO,GAAG,WAAW;AACrB;;AAGF,QAAO,aAAE,WAAW,KAAK"}
+{"version":3,"file":"utils.cjs","names":[],"sources":["../../../src/core/utils.ts"],"sourcesContent":["import * as t from '@babel/types'\nimport type babel from '@babel/core'\n\nexport const debug =\n  process.env.TSR_VITE_DEBUG &&\n  ['true', 'router-plugin'].includes(process.env.TSR_VITE_DEBUG)\n\n/**\n * Normalizes a file path by converting Windows backslashes to forward slashes.\n * This ensures consistent path handling across different bundlers and operating systems.\n *\n * The route generator stores paths with forward slashes, but rspack/webpack on Windows\n * pass native paths with backslashes to transform handlers.\n */\nexport function normalizePath(path: string): string {\n  return path.replace(/\\\\/g, '/')\n}\n\nexport function getUniqueProgramIdentifier(\n  programPath: babel.NodePath<t.Program>,\n  baseName: string,\n): t.Identifier {\n  let name = baseName\n  let suffix = 2\n\n  const programScope = programPath.scope.getProgramParent()\n\n  while (\n    programScope.hasBinding(name) ||\n    programScope.hasGlobal(name) ||\n    programScope.hasReference(name)\n  ) {\n    name = `${baseName}${suffix}`\n    suffix++\n  }\n\n  // Register the name so subsequent calls within the same traversal\n  // see it and avoid collisions\n  programScope.references[name] = true\n\n  return t.identifier(name)\n}\n"],"mappings":";;;;AAGA,IAAa,QACX,QAAQ,IAAI,kBACZ,CAAC,QAAQ,gBAAgB,CAAC,SAAS,QAAQ,IAAI,eAAe;;;;;;;;AAShE,SAAgB,cAAc,MAAsB;AAClD,QAAO,KAAK,QAAQ,OAAO,IAAI;;AAGjC,SAAgB,2BACd,aACA,UACc;CACd,IAAI,OAAO;CACX,IAAI,SAAS;CAEb,MAAM,eAAe,YAAY,MAAM,kBAAkB;AAEzD,QACE,aAAa,WAAW,KAAK,IAC7B,aAAa,UAAU,KAAK,IAC5B,aAAa,aAAa,KAAK,EAC/B;AACA,SAAO,GAAG,WAAW;AACrB;;AAKF,cAAa,WAAW,QAAQ;AAEhC,QAAO,aAAE,WAAW,KAAK"}

package/dist/esm/core/code-splitter/compilers.js

@@ -96,6 +96,10 @@ function collectIdentifiersFromNode(node) {
 	})(node);
 	return ids;
 }
+function getObjectPropertyKeyName(prop) {
+	if (t.isIdentifier(prop.key)) return prop.key.name;
+	if (t.isStringLiteral(prop.key)) return prop.key.value;
+}
 /**
 * Build a map from binding name → declaration AST node for all
 * locally-declared module-level bindings. Built once, O(1) lookup.
@@ -162,10 +166,12 @@ function computeSharedBindings(opts) {
 	const splitGroupsPresent = /* @__PURE__ */ new Set();
 	let hasNonSplit = false;
 	for (const prop of routeOptions.properties) {
-		if (!t.isObjectProperty(prop) || !t.isIdentifier(prop.key)) continue;
-		if (prop.key.name === "codeSplitGroupings") continue;
+		if (!t.isObjectProperty(prop)) continue;
+		const key = getObjectPropertyKeyName(prop);
+		if (!key) continue;
+		if (key === "codeSplitGroupings") continue;
 		if (t.isIdentifier(prop.value) && prop.value.name === "undefined") continue;
-		const groupIndex = findIndexForSplitNode(prop.key.name);
+		const groupIndex = findIndexForSplitNode(key);
 		if (groupIndex === -1) hasNonSplit = true;
 		else splitGroupsPresent.add(groupIndex);
 	}
@@ -177,8 +183,9 @@ function computeSharedBindings(opts) {
 	const fullDepGraph = buildDependencyGraph(declMap, allLocalBindings);
 	const refsByGroup = /* @__PURE__ */ new Map();
 	for (const prop of routeOptions.properties) {
-		if (!t.isObjectProperty(prop) || !t.isIdentifier(prop.key)) continue;
-		const key = prop.key.name;
+		if (!t.isObjectProperty(prop)) continue;
+		const key = getObjectPropertyKeyName(prop);
+		if (!key) continue;
 		if (key === "codeSplitGroupings") continue;
 		const groupIndex = findIndexForSplitNode(key);
 		const directRefs = collectModuleLevelRefsFromNode(prop.value, localModuleLevelBindings);
@@ -384,11 +391,10 @@ function compileCodeSplitReferenceRoute(opts) {
 				if (t.isObjectExpression(routeOptions)) {
 					if (opts.deleteNodes && opts.deleteNodes.size > 0) routeOptions.properties = routeOptions.properties.filter((prop) => {
 						if (t.isObjectProperty(prop)) {
-							if (t.isIdentifier(prop.key)) {
-								if (opts.deleteNodes.has(prop.key.name)) {
-									modified = true;
-									return false;
-								}
+							const key = getObjectPropertyKeyName(prop);
+							if (key && opts.deleteNodes.has(key)) {
+								modified = true;
+								return false;
 							}
 						}
 						return true;
@@ -414,8 +420,8 @@ function compileCodeSplitReferenceRoute(opts) {
 					}
 					routeOptions.properties.forEach((prop) => {
 						if (t.isObjectProperty(prop)) {
-							if (t.isIdentifier(prop.key)) {
-								const key = prop.key.name;
+							const key = getObjectPropertyKeyName(prop);
+							if (key) {
 								const codeSplitGroupingByKey = findIndexForSplitNode(key);
 								if (codeSplitGroupingByKey === -1) return;
 								const codeSplitGroup = [...new Set(opts.codeSplitGroupings[codeSplitGroupingByKey])];
@@ -438,7 +444,25 @@ function compileCodeSplitReferenceRoute(opts) {
 									modified = true;
 									if (!hasImportedOrDefinedIdentifier(LAZY_ROUTE_COMPONENT_IDENT)) programPath.unshiftContainer("body", [template.statement(`import { ${LAZY_ROUTE_COMPONENT_IDENT} } from '${PACKAGE}'`)()]);
 									if (!hasImportedOrDefinedIdentifier(splitNodeMeta.localImporterIdent)) programPath.unshiftContainer("body", [template.statement(`const ${splitNodeMeta.localImporterIdent} = () => import('${splitUrl}')`)()]);
-									prop.value = template.expression(`${LAZY_ROUTE_COMPONENT_IDENT}(${splitNodeMeta.localImporterIdent}, '${splitNodeMeta.exporterIdent}')`)();
+									const insertionPath = path.getStatementParent() ?? path;
+									let splitPropValue;
+									for (const plugin of opts.compilerPlugins ?? []) {
+										const pluginPropValue = plugin.onSplitRouteProperty?.({
+											programPath,
+											callExpressionPath: path,
+											insertionPath,
+											routeOptions,
+											prop,
+											splitNodeMeta,
+											lazyRouteComponentIdent: LAZY_ROUTE_COMPONENT_IDENT
+										});
+										if (!pluginPropValue) continue;
+										modified = true;
+										splitPropValue = pluginPropValue;
+										break;
+									}
+									if (splitPropValue) prop.value = splitPropValue;
+									else prop.value = template.expression(`${LAZY_ROUTE_COMPONENT_IDENT}(${splitNodeMeta.localImporterIdent}, '${splitNodeMeta.exporterIdent}')`)();
 									if (opts.addHmr && !hmrAdded) {
 										programPath.pushContainer("body", routeHmrStatement);
 										modified = true;
@@ -540,7 +564,7 @@ function compileCodeSplitVirtualRoute(opts) {
 				if (t.isObjectExpression(options)) {
 					options.properties.forEach((prop) => {
 						if (t.isObjectProperty(prop)) KNOWN_SPLIT_ROUTE_IDENTS.forEach((splitType) => {
-							if (!t.isIdentifier(prop.key) || prop.key.name !== splitType) return;
+							if (getObjectPropertyKeyName(prop) !== splitType) return;
 							const value = prop.value;
 							if (t.isIdentifier(value) && value.name === "undefined") return;
 							let isExported = false;
@@ -734,18 +758,16 @@ function detectCodeSplitGroupingsFromRoute(opts) {
 			function babelHandleSplittingGroups(routeOptions) {
 				if (t.isObjectExpression(routeOptions)) routeOptions.properties.forEach((prop) => {
 					if (t.isObjectProperty(prop)) {
-						if (t.isIdentifier(prop.key)) {
-							if (prop.key.name === "codeSplitGroupings") {
-								const value = prop.value;
-								if (t.isArrayExpression(value)) codeSplitGroupings = value.elements.map((group) => {
-									if (t.isArrayExpression(group)) return group.elements.map((node) => {
-										if (!t.isStringLiteral(node)) throw new Error("You must provide a string literal for the codeSplitGroupings");
-										return node.value;
-									});
-									throw new Error("You must provide arrays with codeSplitGroupings options.");
+						if (getObjectPropertyKeyName(prop) === "codeSplitGroupings") {
+							const value = prop.value;
+							if (t.isArrayExpression(value)) codeSplitGroupings = value.elements.map((group) => {
+								if (t.isArrayExpression(group)) return group.elements.map((node) => {
+									if (!t.isStringLiteral(node)) throw new Error("You must provide a string literal for the codeSplitGroupings");
+									return node.value;
 								});
-								else throw new Error("You must provide an array of arrays for the codeSplitGroupings.");
-							}
+								throw new Error("You must provide arrays with codeSplitGroupings options.");
+							});
+							else throw new Error("You must provide an array of arrays for the codeSplitGroupings.");
 						}
 					}
 				});