@bleedingdev/modern-js-plugin-tanstack 3.2.0-ultramodern.89 → 3.2.0-ultramodern.90

package/dist/esm/runtime/plugin.node.mjs

@@ -12,6 +12,7 @@ import { modifyRoutes, onAfterCreateRouter, onAfterHydrateRouter, onBeforeCreate
 import { applyRouterServerPrepareResult, createRouterServerSnapshot } from "./lifecycle.mjs";
 import { createRouteTreeFromRouteObjects, getModernRouteIdsFromMatches } from "./routeTree.mjs";
 import { createTanstackRscServerPayload, handleTanstackRscRedirect } from "./rsc/payloadRouter.mjs";
+import { getModernTanstackRouterFastDefaults } from "./types.mjs";
 import { createRouteObjectsFromConfig, urlJoin } from "./utils.mjs";
 const setTanstackRscServerPayload = (payload)=>{
     const storageContext = storage.useContext?.();
@@ -177,6 +178,7 @@ const tanstackRouterPlugin = (userConfig = {})=>{
                 };
                 hooks.onBeforeCreateRouter.call(routerLifecycleContext);
                 const tanstackRouter = createRouter({
+                    ...getModernTanstackRouterFastDefaults(mergedConfig),
                     routeTree,
                     history,
                     basepath: '/',

package/dist/esm/runtime/routeTree.mjs

@@ -317,6 +317,8 @@ function createRouteFromRouteObject(opts) {
         component: toRouteComponent(routeObject),
         pendingComponent: toPendingComponent(routeObject),
         errorComponent: toErrorComponent(routeObject),
+        validateSearch: modernRouteObject.validateSearch,
+        loaderDeps: modernRouteObject.loaderDeps,
         wrapInSuspense: true,
         staticData: createRouteStaticData({
             modernRouteId: routeObject.id,
@@ -367,6 +369,8 @@ function createRouteFromModernRoute(opts) {
         component: component || void 0,
         pendingComponent: pendingComponent || void 0,
         errorComponent: errorComponent || void 0,
+        validateSearch: route.validateSearch,
+        loaderDeps: route.loaderDeps,
         wrapInSuspense: true,
         staticData: createRouteStaticData({
             modernRouteId: modernId,
@@ -415,6 +419,8 @@ function createRouteTreeFromModernRoutes(routes, options = {}) {
         component: rootComponent || void 0,
         pendingComponent: pendingComponent || void 0,
         errorComponent: errorComponent || void 0,
+        validateSearch: rootModern?.validateSearch,
+        loaderDeps: rootModern?.loaderDeps,
         wrapInSuspense: true,
         notFoundComponent: DefaultNotFound,
         staticData: createRouteStaticData({
@@ -454,6 +460,8 @@ function createRouteTreeFromRouteObjects(routes, options = {}) {
         component: rootLikeRoute ? toRouteComponent(rootLikeRoute) : void 0,
         pendingComponent: rootLikeRoute ? toPendingComponent(rootLikeRoute) : void 0,
         errorComponent: rootLikeRoute ? toErrorComponent(rootLikeRoute) : void 0,
+        validateSearch: rootLikeRoute?.validateSearch,
+        loaderDeps: rootLikeRoute?.loaderDeps,
         wrapInSuspense: true,
         notFoundComponent: DefaultNotFound,
         staticData: createRouteStaticData({

package/dist/esm/runtime/types.mjs

@@ -0,0 +1,7 @@
+const modernTanstackRouterFastDefaults = {
+    defaultStructuralSharing: true
+};
+const getModernTanstackRouterFastDefaults = (config = {})=>({
+        defaultStructuralSharing: config.defaultStructuralSharing ?? modernTanstackRouterFastDefaults.defaultStructuralSharing
+    });
+export { getModernTanstackRouterFastDefaults, modernTanstackRouterFastDefaults };

package/dist/esm-node/cli/index.mjs

@@ -1,6 +1,7 @@
 import "node:module";
 import node_path from "node:path";
 import { NESTED_ROUTE_SPEC_FILE, filterRoutesForServer, fs } from "@modern-js/utils";
+import { createTanstackRsbuildRouteSplittingProfile, isTanstackStartRouteModuleSource, resolveTanstackRouteCodeSplittingEnabled } from "./routeSplitting.mjs";
 import { generateTanstackRouterTypesSourceForEntry, isTanstackRouterFrameworkEnabled } from "./tanstackTypes.mjs";
 import { __webpack_require__ } from "../rslib-runtime.mjs";
 import { fileURLToPath as __rspack_fileURLToPath } from "node:url";
@@ -82,6 +83,7 @@ async function writeTanstackRouterTypesForEntries(opts) {
 function tanstackRouterPlugin(options = {}) {
     const routesDir = options.routesDir || DEFAULT_ROUTES_DIR;
     const generatedDirName = options.generatedDirName || DEFAULT_GENERATED_DIR_NAME;
+    const routeSplittingProfile = createTanstackRsbuildRouteSplittingProfile(options);
     return {
         name: '@modern-js/plugin-tanstack',
         required: [
@@ -117,6 +119,7 @@ function tanstackRouterPlugin(options = {}) {
                     entry: entry || getRuntimeRouterCli().isRouteEntry(entryPath, routesDir)
                 }));
             api.config(()=>({
+                    ...routeSplittingProfile.defaultConfig,
                     source: {
                         include: [
                             /[\\/]node_modules[\\/]@tanstack[\\/]react-router[\\/]/,
@@ -199,4 +202,4 @@ function tanstackRouterPlugin(options = {}) {
 }
 const src_cli = tanstackRouterPlugin;
 export default src_cli;
-export { generateTanstackRouterTypesSourceForEntry, isTanstackRouterFrameworkEnabled, tanstackRouterPlugin, writeTanstackRegisterFile, writeTanstackRouterTypesForEntries };
+export { createTanstackRsbuildRouteSplittingProfile, generateTanstackRouterTypesSourceForEntry, isTanstackRouterFrameworkEnabled, isTanstackStartRouteModuleSource, resolveTanstackRouteCodeSplittingEnabled, tanstackRouterPlugin, writeTanstackRegisterFile, writeTanstackRouterTypesForEntries };

package/dist/esm-node/cli/routeSplitting.mjs

@@ -0,0 +1,44 @@
+import "node:module";
+const TANSTACK_START_ROUTE_FACTORY_CALLS = [
+    'createFileRoute',
+    'createRootRoute',
+    'createRootRouteWithContext'
+];
+const TANSTACK_START_ROUTE_FACTORY_REGEX = /\b(createFileRoute|createRootRoute|createRootRouteWithContext)\s*(?:<|\()/;
+function isTanstackStartRouteModuleSource(source) {
+    return TANSTACK_START_ROUTE_FACTORY_REGEX.test(source);
+}
+function resolveTanstackRouteCodeSplittingEnabled(option) {
+    if ('boolean' == typeof option) return option;
+    return option?.enabled ?? true;
+}
+function createTanstackRsbuildRouteSplittingProfile(opts) {
+    return {
+        defaultConfig: {
+            output: {
+                splitRouteChunks: resolveTanstackRouteCodeSplittingEnabled(opts.routeCodeSplitting)
+            }
+        },
+        modernRouteChunks: {
+            enabled: resolveTanstackRouteCodeSplittingEnabled(opts.routeCodeSplitting),
+            owner: 'modern'
+        },
+        builderChunkSplit: {
+            owner: 'modern-rsbuild',
+            preserved: true
+        },
+        tanstackStartRspackSplitter: {
+            compatible: false,
+            reason: 'TanStack Start Rsbuild route splitting is tied to TanStack file-route factory modules; Modern generates TanStack route trees from Modern route metadata and owns route chunking through output.splitRouteChunks.',
+            clientDeleteNodes: [
+                'ssr',
+                'server',
+                'headers'
+            ],
+            routeFactoryCalls: [
+                ...TANSTACK_START_ROUTE_FACTORY_CALLS
+            ]
+        }
+    };
+}
+export { createTanstackRsbuildRouteSplittingProfile, isTanstackStartRouteModuleSource, resolveTanstackRouteCodeSplittingEnabled };

package/dist/esm-node/cli/tanstackTypes.mjs

@@ -56,6 +56,14 @@ function pickModernLoaderModule(route) {
         inline
     };
 }
+function pickRouteSearchContractModules(route) {
+    const validateSearchPath = route.validateSearch;
+    const loaderDepsPath = route.loaderDeps;
+    return {
+        validateSearchPath: 'string' == typeof validateSearchPath ? validateSearchPath : null,
+        loaderDepsPath: 'string' == typeof loaderDepsPath ? loaderDepsPath : null
+    };
+}
 function isPathlessLayout(route) {
     return 'nested' === route.type && 'boolean' != typeof route.index && void 0 === route.path;
 }
@@ -89,9 +97,21 @@ async function generateTanstackRouterTypesSourceForEntry(opts) {
     const imports = [];
     const statements = [];
     const loaderImportMap = new Map();
+    const searchContractImportMap = new Map();
     const usedRouteVarNames = new Set();
     let loaderIndex = 0;
+    let validateSearchIndex = 0;
+    let loaderDepsIndex = 0;
     let routeIndex = 0;
+    const resolveRouteModuleNoExt = async (aliasedNoExtPath)=>{
+        const prefix = `${appContext.internalSrcAlias}/`;
+        let absNoExt;
+        if (aliasedNoExtPath.startsWith(prefix)) {
+            const rel = aliasedNoExtPath.slice(prefix.length);
+            absNoExt = path.join(appContext.srcDirectory, rel);
+        } else absNoExt = path.isAbsolute(aliasedNoExtPath) ? aliasedNoExtPath : path.join(appContext.srcDirectory, aliasedNoExtPath);
+        return resolveFileNoExt(absNoExt);
+    };
     const getImportNamesForLoader = async (aliasedNoExtPath, inline, hasAction)=>{
         const key = `${inline ? 'inline' : 'default'}:${hasAction ? 'action' : 'loader'}:${aliasedNoExtPath}`;
         const existing = loaderImportMap.get(key);
@@ -99,13 +119,7 @@ async function generateTanstackRouterTypesSourceForEntry(opts) {
             loaderName: existing,
             actionName: hasAction ? existing.replace(/^loader_/, 'action_') : null
         };
-        const prefix = `${appContext.internalSrcAlias}/`;
-        let absNoExt;
-        if (aliasedNoExtPath.startsWith(prefix)) {
-            const rel = aliasedNoExtPath.slice(prefix.length);
-            absNoExt = path.join(appContext.srcDirectory, rel);
-        } else absNoExt = path.isAbsolute(aliasedNoExtPath) ? aliasedNoExtPath : path.join(appContext.srcDirectory, aliasedNoExtPath);
-        const resolvedNoExt = await resolveFileNoExt(absNoExt);
+        const resolvedNoExt = await resolveRouteModuleNoExt(aliasedNoExtPath);
         if (!resolvedNoExt) return null;
         const relImport = normalizeRelativeImport(path.relative(outDir, resolvedNoExt));
         const importName = `loader_${loaderIndex++}`;
@@ -123,6 +137,18 @@ async function generateTanstackRouterTypesSourceForEntry(opts) {
             actionName
         };
     };
+    const getImportNameForSearchContract = async (aliasedNoExtPath, exportName)=>{
+        const key = `${exportName}:${aliasedNoExtPath}`;
+        const existing = searchContractImportMap.get(key);
+        if (existing) return existing;
+        const resolvedNoExt = await resolveRouteModuleNoExt(aliasedNoExtPath);
+        if (!resolvedNoExt) return null;
+        const relImport = normalizeRelativeImport(path.relative(outDir, resolvedNoExt));
+        const importName = 'validateSearch' === exportName ? `validateSearch_${validateSearchIndex++}` : `loaderDeps_${loaderDepsIndex++}`;
+        imports.push(`import { ${exportName} as ${importName} } from ${quote(relImport)};`);
+        searchContractImportMap.set(key, importName);
+        return importName;
+    };
     const reserveRouteVarName = (preferred)=>{
         let candidate = preferred;
         let suffix = 1;
@@ -143,6 +169,9 @@ async function generateTanstackRouterTypesSourceForEntry(opts) {
         const loaderImports = loaderInfo ? await getImportNamesForLoader(loaderInfo.loaderPath, loaderInfo.inline, Boolean(loaderInfo.inline && routeAction === loaderInfo.loaderPath)) : null;
         const loaderName = loaderImports?.loaderName || null;
         const actionName = loaderImports?.actionName || null;
+        const searchContractInfo = pickRouteSearchContractModules(route);
+        const validateSearchName = searchContractInfo.validateSearchPath ? await getImportNameForSearchContract(searchContractInfo.validateSearchPath, 'validateSearch') : null;
+        const loaderDepsName = searchContractInfo.loaderDepsPath ? await getImportNameForSearchContract(searchContractInfo.loaderDepsPath, 'loaderDeps') : null;
         const rawPath = route.path;
         const hasSplat = 'string' == typeof rawPath && rawPath.includes('*');
         const routeOpts = [
@@ -156,6 +185,8 @@ async function generateTanstackRouterTypesSourceForEntry(opts) {
             routeOpts.push(`path: ${quote(p)},`);
         }
         if (loaderName) routeOpts.push(`loader: modernLoaderToTanstack({ hasSplat: ${hasSplat} }, ${loaderName}),`);
+        if (validateSearchName) routeOpts.push(`validateSearch: ${validateSearchName},`);
+        if (loaderDepsName) routeOpts.push(`loaderDeps: ${loaderDepsName},`);
         const staticDataSnippet = createRouteStaticDataSnippet({
             modernRouteId: route.id,
             loaderName,
@@ -180,17 +211,23 @@ async function generateTanstackRouterTypesSourceForEntry(opts) {
     const rootLoaderImports = rootLoaderInfo?.loaderPath ? await getImportNamesForLoader(rootLoaderInfo.loaderPath, rootLoaderInfo.inline, Boolean(rootLoaderInfo.inline && rootAction === rootLoaderInfo.loaderPath)) : null;
     const rootLoaderName = rootLoaderImports?.loaderName || null;
     const rootActionName = rootLoaderImports?.actionName || null;
+    const rootSearchContractInfo = rootModern ? pickRouteSearchContractModules(rootModern) : null;
+    const rootValidateSearchName = rootSearchContractInfo?.validateSearchPath ? await getImportNameForSearchContract(rootSearchContractInfo.validateSearchPath, 'validateSearch') : null;
+    const rootLoaderDepsName = rootSearchContractInfo?.loaderDepsPath ? await getImportNameForSearchContract(rootSearchContractInfo.loaderDepsPath, 'loaderDeps') : null;
     const topLevelVars = await Promise.all(topLevel.map((route)=>buildRoute({
             parentVar: 'rootRoute',
             route
         })));
     const rootOpts = [];
     if (rootLoaderName) rootOpts.push(`loader: modernLoaderToTanstack({ hasSplat: false }, ${rootLoaderName}),`);
+    if (rootValidateSearchName) rootOpts.push(`validateSearch: ${rootValidateSearchName},`);
+    if (rootLoaderDepsName) rootOpts.push(`loaderDeps: ${rootLoaderDepsName},`);
     const routerGenTs = `/* eslint-disable */
 // This file is auto-generated by Modern.js. Do not edit manually.
 
 import {
   createMemoryHistory,
+  modernTanstackRouterFastDefaults,
   createRootRouteWithContext,
   createRoute,
   createRouter,
@@ -378,6 +415,7 @@ ${statements.join('\n\n')}
 export const routeTree = rootRoute.addChildren([${topLevelVars.join(', ')}]);
 
 export const router = createRouter({
+  ...modernTanstackRouterFastDefaults,
   routeTree,
   history: createMemoryHistory({
     initialEntries: ['/'],

package/dist/esm-node/runtime/index.mjs

@@ -5,3 +5,4 @@ export { Form, RouteActionResponseError, useFetcher } from "./dataMutation.mjs";
 export { tanstackRouterPlugin as default, tanstackRouterPlugin } from "./plugin.mjs";
 export { Link, NavLink } from "./prefetchLink.mjs";
 export { CompositeComponent } from "./rsc/client.mjs";
+export { getModernTanstackRouterFastDefaults, modernTanstackRouterFastDefaults } from "./types.mjs";

package/dist/esm-node/runtime/plugin.mjs

@@ -12,6 +12,7 @@ import { applyRouterRuntimeState } from "./lifecycle.mjs";
 import { Link } from "./prefetchLink.mjs";
 import { createRouteTreeFromRouteObjects } from "./routeTree.mjs";
 import { getTanstackRscSerializationAdapters } from "./rsc/client.mjs";
+import { getModernTanstackRouterFastDefaults } from "./types.mjs";
 import { createRouteObjectsFromConfig, urlJoin } from "./utils.mjs";
 const BLOCKING_SUBSCRIBE_SYMBOL = Symbol.for('@modern-js/plugin-tanstack:blocking-subscribe');
 const BLOCKING_STATE_SYMBOL = Symbol.for('@modern-js/plugin-tanstack:blocking-state');
@@ -145,6 +146,7 @@ const tanstackRouterPlugin = (userConfig = {})=>{
                         const rewrite = createModernBasepathRewrite(_basename);
                         const serializationAdapters = getGlobalEnableRsc() ? getTanstackRscSerializationAdapters() : void 0;
                         cachedRouter = createRouter({
+                            ...getModernTanstackRouterFastDefaults(mergedConfig),
                             routeTree,
                             basepath: '/',
                             rewrite,

package/dist/esm-node/runtime/plugin.node.mjs

@@ -13,6 +13,7 @@ import { modifyRoutes, onAfterCreateRouter, onAfterHydrateRouter, onBeforeCreate
 import { applyRouterServerPrepareResult, createRouterServerSnapshot } from "./lifecycle.mjs";
 import { createRouteTreeFromRouteObjects, getModernRouteIdsFromMatches } from "./routeTree.mjs";
 import { createTanstackRscServerPayload, handleTanstackRscRedirect } from "./rsc/payloadRouter.mjs";
+import { getModernTanstackRouterFastDefaults } from "./types.mjs";
 import { createRouteObjectsFromConfig, urlJoin } from "./utils.mjs";
 const setTanstackRscServerPayload = (payload)=>{
     const storageContext = storage.useContext?.();
@@ -178,6 +179,7 @@ const tanstackRouterPlugin = (userConfig = {})=>{
                 };
                 hooks.onBeforeCreateRouter.call(routerLifecycleContext);
                 const tanstackRouter = createRouter({
+                    ...getModernTanstackRouterFastDefaults(mergedConfig),
                     routeTree,
                     history,
                     basepath: '/',

package/dist/esm-node/runtime/routeTree.mjs

@@ -318,6 +318,8 @@ function createRouteFromRouteObject(opts) {
         component: toRouteComponent(routeObject),
         pendingComponent: toPendingComponent(routeObject),
         errorComponent: toErrorComponent(routeObject),
+        validateSearch: modernRouteObject.validateSearch,
+        loaderDeps: modernRouteObject.loaderDeps,
         wrapInSuspense: true,
         staticData: createRouteStaticData({
             modernRouteId: routeObject.id,
@@ -368,6 +370,8 @@ function createRouteFromModernRoute(opts) {
         component: component || void 0,
         pendingComponent: pendingComponent || void 0,
         errorComponent: errorComponent || void 0,
+        validateSearch: route.validateSearch,
+        loaderDeps: route.loaderDeps,
         wrapInSuspense: true,
         staticData: createRouteStaticData({
             modernRouteId: modernId,
@@ -416,6 +420,8 @@ function createRouteTreeFromModernRoutes(routes, options = {}) {
         component: rootComponent || void 0,
         pendingComponent: pendingComponent || void 0,
         errorComponent: errorComponent || void 0,
+        validateSearch: rootModern?.validateSearch,
+        loaderDeps: rootModern?.loaderDeps,
         wrapInSuspense: true,
         notFoundComponent: DefaultNotFound,
         staticData: createRouteStaticData({
@@ -455,6 +461,8 @@ function createRouteTreeFromRouteObjects(routes, options = {}) {
         component: rootLikeRoute ? toRouteComponent(rootLikeRoute) : void 0,
         pendingComponent: rootLikeRoute ? toPendingComponent(rootLikeRoute) : void 0,
         errorComponent: rootLikeRoute ? toErrorComponent(rootLikeRoute) : void 0,
+        validateSearch: rootLikeRoute?.validateSearch,
+        loaderDeps: rootLikeRoute?.loaderDeps,
         wrapInSuspense: true,
         notFoundComponent: DefaultNotFound,
         staticData: createRouteStaticData({

package/dist/esm-node/runtime/types.mjs

@@ -1 +1,8 @@
 import "node:module";
+const modernTanstackRouterFastDefaults = {
+    defaultStructuralSharing: true
+};
+const getModernTanstackRouterFastDefaults = (config = {})=>({
+        defaultStructuralSharing: config.defaultStructuralSharing ?? modernTanstackRouterFastDefaults.defaultStructuralSharing
+    });
+export { getModernTanstackRouterFastDefaults, modernTanstackRouterFastDefaults };

package/dist/types/cli/index.d.ts

@@ -1,9 +1,13 @@
 import type { AppTools, AppToolsContext, CliPlugin } from '@modern-js/app-tools';
 import type { NestedRouteForCli, PageRoute } from '@modern-js/types';
+import { type TanstackRouteCodeSplittingOption } from './routeSplitting';
+export type { TanstackRouteCodeSplittingOption, TanstackRsbuildRouteSplittingProfile, } from './routeSplitting';
+export { createTanstackRsbuildRouteSplittingProfile, isTanstackStartRouteModuleSource, resolveTanstackRouteCodeSplittingEnabled, } from './routeSplitting';
 export { generateTanstackRouterTypesSourceForEntry, isTanstackRouterFrameworkEnabled, } from './tanstackTypes';
 export type TanstackRouterPluginOptions = {
     routesDir?: string;
     generatedDirName?: string;
+    routeCodeSplitting?: TanstackRouteCodeSplittingOption;
 };
 export declare function writeTanstackRegisterFile(opts: {
     entries: string[];

package/dist/types/cli/routeSplitting.d.ts

@@ -0,0 +1,29 @@
+export type TanstackRouteCodeSplittingOption = boolean | {
+    enabled?: boolean;
+};
+export type TanstackRsbuildRouteSplittingProfile = {
+    defaultConfig: {
+        output: {
+            splitRouteChunks: boolean;
+        };
+    };
+    modernRouteChunks: {
+        enabled: boolean;
+        owner: 'modern';
+    };
+    builderChunkSplit: {
+        owner: 'modern-rsbuild';
+        preserved: true;
+    };
+    tanstackStartRspackSplitter: {
+        compatible: boolean;
+        reason: string;
+        clientDeleteNodes: string[];
+        routeFactoryCalls: string[];
+    };
+};
+export declare function isTanstackStartRouteModuleSource(source: string): boolean;
+export declare function resolveTanstackRouteCodeSplittingEnabled(option?: TanstackRouteCodeSplittingOption): boolean;
+export declare function createTanstackRsbuildRouteSplittingProfile(opts: {
+    routeCodeSplitting?: TanstackRouteCodeSplittingOption;
+}): TanstackRsbuildRouteSplittingProfile;

package/dist/types/runtime/index.d.ts

@@ -7,3 +7,5 @@ export type { LinkProps, NavLinkProps, PrefetchBehavior, } from './prefetchLink'
 export { Link, NavLink } from './prefetchLink';
 export type { AnyCompositeComponent, AnyRenderableServerComponent, CompositeComponentProps, } from './rsc/client';
 export { CompositeComponent } from './rsc/client';
+export type { RouterConfig } from './types';
+export { getModernTanstackRouterFastDefaults, modernTanstackRouterFastDefaults, } from './types';

package/dist/types/runtime/plugin.d.ts

@@ -2,7 +2,7 @@ import type { Plugin, RuntimePluginExtends } from '@modern-js/plugin';
 import type { RuntimePluginAPI } from '@modern-js/plugin/runtime';
 import { type TInternalRuntimeContext } from '@modern-js/runtime/context';
 import { type RouterExtendsHooks } from './hooks';
-import type { RouterConfig } from './types';
+import { type RouterConfig } from './types';
 type TanstackRouterRuntimeConfig = {
     plugins?: TanstackRouterRuntimePlugin[];
     router?: Partial<RouterConfig>;

package/dist/types/runtime/plugin.node.d.ts

@@ -2,7 +2,7 @@ import type { Plugin, RuntimePluginExtends } from '@modern-js/plugin';
 import type { RuntimePluginAPI } from '@modern-js/plugin/runtime';
 import { type TInternalRuntimeContext } from '@modern-js/runtime/context';
 import { type RouterExtendsHooks } from './hooks';
-import type { RouterConfig } from './types';
+import { type RouterConfig } from './types';
 type TanstackRouterRuntimeConfig = {
     plugins?: TanstackRouterRuntimePlugin[];
     router?: Partial<RouterConfig>;

package/dist/types/runtime/types.d.ts

@@ -18,8 +18,15 @@ export type RouterConfig = {
     future?: Partial<{
         v7_startTransition: boolean;
     }>;
+    defaultStructuralSharing?: boolean;
     unstable_reloadOnURLMismatch?: boolean;
 };
+export declare const modernTanstackRouterFastDefaults: {
+    readonly defaultStructuralSharing: true;
+};
+export declare const getModernTanstackRouterFastDefaults: (config?: Partial<Pick<RouterConfig, 'defaultStructuralSharing'>>) => {
+    defaultStructuralSharing: boolean;
+};
 export interface RouterRouteMatchSnapshot {
     routeId: string;
     assetRouteId?: string;

package/package.json

@@ -18,7 +18,7 @@
     "modern.js",
     "tanstack-router"
   ],
-  "version": "3.2.0-ultramodern.89",
+  "version": "3.2.0-ultramodern.90",
   "engines": {
     "node": ">=20"
   },
@@ -86,15 +86,15 @@
   },
   "dependencies": {
     "@swc/helpers": "^0.5.23",
-    "@tanstack/react-router": "1.170.8",
-    "@tanstack/router-core": "1.171.6",
-    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.2.0-ultramodern.89",
-    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.2.0-ultramodern.89",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.2.0-ultramodern.89",
-    "@modern-js/runtime-utils": "npm:@bleedingdev/modern-js-runtime-utils@3.2.0-ultramodern.89"
+    "@tanstack/react-router": "1.170.11",
+    "@tanstack/router-core": "1.171.9",
+    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.2.0-ultramodern.90",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.2.0-ultramodern.90",
+    "@modern-js/runtime-utils": "npm:@bleedingdev/modern-js-runtime-utils@3.2.0-ultramodern.90",
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.2.0-ultramodern.90"
   },
   "peerDependencies": {
-    "@modern-js/runtime": "3.2.0-ultramodern.89",
+    "@modern-js/runtime": "3.2.0-ultramodern.90",
     "react": "^19.2.6",
     "react-dom": "^19.2.6"
   },
@@ -109,8 +109,8 @@
     "@typescript/native-preview": "7.0.0-dev.20260527.2",
     "react": "^19.2.6",
     "react-dom": "^19.2.6",
-    "@modern-js/app-tools": "npm:@bleedingdev/modern-js-app-tools@3.2.0-ultramodern.89",
-    "@modern-js/runtime": "npm:@bleedingdev/modern-js-runtime@3.2.0-ultramodern.89",
+    "@modern-js/runtime": "npm:@bleedingdev/modern-js-runtime@3.2.0-ultramodern.90",
+    "@modern-js/app-tools": "npm:@bleedingdev/modern-js-app-tools@3.2.0-ultramodern.90",
     "@scripts/rstest-config": "2.66.0"
   },
   "sideEffects": false,

package/src/cli/index.ts

@@ -18,11 +18,24 @@ import {
   fs,
   NESTED_ROUTE_SPEC_FILE,
 } from '@modern-js/utils';
+import {
+  createTanstackRsbuildRouteSplittingProfile,
+  type TanstackRouteCodeSplittingOption,
+} from './routeSplitting';
 import {
   generateTanstackRouterTypesSourceForEntry,
   isTanstackRouterFrameworkEnabled,
 } from './tanstackTypes';
 
+export type {
+  TanstackRouteCodeSplittingOption,
+  TanstackRsbuildRouteSplittingProfile,
+} from './routeSplitting';
+export {
+  createTanstackRsbuildRouteSplittingProfile,
+  isTanstackStartRouteModuleSource,
+  resolveTanstackRouteCodeSplittingEnabled,
+} from './routeSplitting';
 export {
   generateTanstackRouterTypesSourceForEntry,
   isTanstackRouterFrameworkEnabled,
@@ -35,6 +48,7 @@ const ENTRYPOINTS_KEY = '@modern-js/plugin-tanstack';
 export type TanstackRouterPluginOptions = {
   routesDir?: string;
   generatedDirName?: string;
+  routeCodeSplitting?: TanstackRouteCodeSplittingOption;
 };
 
 type RuntimeRouterCliHelpers = {
@@ -224,6 +238,8 @@ export function tanstackRouterPlugin(
   const routesDir = options.routesDir || DEFAULT_ROUTES_DIR;
   const generatedDirName =
     options.generatedDirName || DEFAULT_GENERATED_DIR_NAME;
+  const routeSplittingProfile =
+    createTanstackRsbuildRouteSplittingProfile(options);
 
   return {
     name: '@modern-js/plugin-tanstack',
@@ -265,6 +281,7 @@ export function tanstackRouterPlugin(
       }));
 
       api.config(() => ({
+        ...routeSplittingProfile.defaultConfig,
         source: {
           include: [
             /[\\/]node_modules[\\/]@tanstack[\\/]react-router[\\/]/,

package/src/cli/routeSplitting.ts

@@ -0,0 +1,81 @@
+export type TanstackRouteCodeSplittingOption =
+  | boolean
+  | {
+      enabled?: boolean;
+    };
+
+export type TanstackRsbuildRouteSplittingProfile = {
+  defaultConfig: {
+    output: {
+      splitRouteChunks: boolean;
+    };
+  };
+  modernRouteChunks: {
+    enabled: boolean;
+    owner: 'modern';
+  };
+  builderChunkSplit: {
+    owner: 'modern-rsbuild';
+    preserved: true;
+  };
+  tanstackStartRspackSplitter: {
+    compatible: boolean;
+    reason: string;
+    clientDeleteNodes: string[];
+    routeFactoryCalls: string[];
+  };
+};
+
+const TANSTACK_START_ROUTE_FACTORY_CALLS = [
+  'createFileRoute',
+  'createRootRoute',
+  'createRootRouteWithContext',
+] as const;
+
+const TANSTACK_START_ROUTE_FACTORY_REGEX =
+  /\b(createFileRoute|createRootRoute|createRootRouteWithContext)\s*(?:<|\()/;
+
+export function isTanstackStartRouteModuleSource(source: string) {
+  return TANSTACK_START_ROUTE_FACTORY_REGEX.test(source);
+}
+
+export function resolveTanstackRouteCodeSplittingEnabled(
+  option?: TanstackRouteCodeSplittingOption,
+) {
+  if (typeof option === 'boolean') {
+    return option;
+  }
+
+  return option?.enabled ?? true;
+}
+
+export function createTanstackRsbuildRouteSplittingProfile(opts: {
+  routeCodeSplitting?: TanstackRouteCodeSplittingOption;
+}): TanstackRsbuildRouteSplittingProfile {
+  return {
+    defaultConfig: {
+      output: {
+        splitRouteChunks: resolveTanstackRouteCodeSplittingEnabled(
+          opts.routeCodeSplitting,
+        ),
+      },
+    },
+    modernRouteChunks: {
+      enabled: resolveTanstackRouteCodeSplittingEnabled(
+        opts.routeCodeSplitting,
+      ),
+      owner: 'modern',
+    },
+    builderChunkSplit: {
+      owner: 'modern-rsbuild',
+      preserved: true,
+    },
+    tanstackStartRspackSplitter: {
+      compatible: false,
+      reason:
+        'TanStack Start Rsbuild route splitting is tied to TanStack file-route factory modules; Modern generates TanStack route trees from Modern route metadata and owns route chunking through output.splitRouteChunks.',
+      clientDeleteNodes: ['ssr', 'server', 'headers'],
+      routeFactoryCalls: [...TANSTACK_START_ROUTE_FACTORY_CALLS],
+    },
+  };
+}