@bleedingdev/modern-js-plugin-tanstack 3.9.0-ultramodern.3 → 3.9.0-ultramodern.5

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

@@ -1,4 +1,5 @@
 import "node:module";
+import { canonicaliseLocalisedRoutes } from "@modern-js/i18n-runtime-extensions";
 import { DefaultNotFound } from "@modern-js/runtime/context";
 import { rootRouteId } from "@tanstack/react-router";
 import { createRouteStaticData } from "../../shared/routeStaticData.mjs";
@@ -58,6 +59,7 @@ function getRootLikeRouteObject(routes) {
     return routes.find((route)=>'/' === route.path && !route.index);
 }
 function createRouteTreeFromRouteObjects(routes, options = {}) {
+    routes = canonicaliseLocalisedRoutes(routes);
     const rootLikeRoute = getRootLikeRouteObject(routes);
     const rootRevalidationState = {};
     const rootShouldRevalidate = rootLikeRoute?.shouldRevalidate;

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

@@ -1,17 +1,33 @@
 import "node:module";
-import * as __rspack_external__modern_js_runtime_router_internal_8b8183c5 from "@modern-js/runtime/router/internal";
+import { routerProviderRegistryHooks } from "@modern-js/runtime/context";
+import { routerPlugin } from "@modern-js/runtime/router/internal";
+import { createRouterPlugin } from "@modern-js/runtime-extensions/router-provider";
+import { createRouterStatePlugin } from "@modern-js/runtime-extensions/router-state-plugin";
 import { tanstackRouterProviderFactory } from "./register.mjs";
-function getRouterPlugin() {
-    const createRouterPlugin = Reflect.get(__rspack_external__modern_js_runtime_router_internal_8b8183c5, 'createRouterPlugin');
-    if ('function' == typeof createRouterPlugin) return createRouterPlugin([
+const createProviderPlugin = createRouterPlugin({
+    defaultProvider: {
+        name: 'react-router',
+        factory: routerPlugin
+    },
+    registryHooks: routerProviderRegistryHooks,
+    localProviders: [
         {
             name: 'tanstack',
             factory: tanstackRouterProviderFactory
         }
-    ]);
-    const legacyRouterPlugin = Reflect.get(__rspack_external__modern_js_runtime_router_internal_8b8183c5, 'routerPlugin');
-    if ('function' == typeof legacyRouterPlugin) return tanstackRouterProviderFactory;
-    throw new Error('[@modern-js/plugin-tanstack] The installed @modern-js/runtime/router/internal exports neither createRouterPlugin nor routerPlugin. Install a compatible @modern-js/runtime version.');
-}
-const routerPlugin = getRouterPlugin();
-export { routerPlugin };
+    ]
+});
+const statePlugin = createRouterStatePlugin({
+    registryHooks: routerProviderRegistryHooks
+});
+const router_routerPlugin = (userConfig = {})=>{
+    const providerPlugin = createProviderPlugin(userConfig);
+    return {
+        ...providerPlugin,
+        setup (api) {
+            statePlugin.setup(api);
+            providerPlugin.setup(api);
+        }
+    };
+};
+export { router_routerPlugin as routerPlugin };

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

@@ -1,5 +1,5 @@
 import "node:module";
-import { getRouterRuntimeState } from "@modern-js/runtime/context";
+import { getRouterRuntimeState } from "@modern-js/runtime-extensions/router-state";
 function getTanstackRouterState(context) {
     const state = getRouterRuntimeState(context);
     if (void 0 === state || 'tanstack' !== state.framework || void 0 === state.instance) return;

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

@@ -14,6 +14,7 @@ function withGlobalLayout(Component, globalApp) {
 }
 function toTanstackRouteObject(route, globalApp) {
     if ('nested' === route.type) return {
+        modernLocalisedRoute: Reflect.get(route, 'modernLocalisedRoute'),
         path: route.path,
         id: route.id,
         loader: route.loader,
@@ -38,6 +39,7 @@ function toTanstackRouteObject(route, globalApp) {
     if ('function' != typeof route.component && 'object' != typeof route.component) return null;
     const LayoutComponent = withGlobalLayout(route.component, globalApp);
     return {
+        modernLocalisedRoute: Reflect.get(route, 'modernLocalisedRoute'),
         path: route.path,
         element: /*#__PURE__*/ react.createElement(LayoutComponent)
     };

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

@@ -1,4 +1,5 @@
-export declare function createModernBasepathRewrite(basepath: string, caseSensitive?: boolean): {
+import type { RouteObject } from '@modern-js/runtime-utils/router';
+export declare function createModernBasepathRewrite(basepath: string, caseSensitive?: boolean, routes?: RouteObject[]): {
     input: ({ url }: {
         url: URL;
     }) => URL;

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

@@ -1,7 +1,14 @@
 /**
- * The router runtime state helpers are owned by @modern-js/runtime (the same
+ * The router runtime state helpers are owned by @modern-js/runtime-extensions (the same
  * implementation backs the built-in react-router provider and the SSR
  * pipeline). This module only re-exports them so every router provider
  * writes to the exact same runtime-context extension slot.
  */
-export { applyRouterRuntimeState, applyRouterServerPrepareResult, createRouterRuntimeState, createRouterServerSnapshot, getRouterRuntimeState, getRouterServerSnapshot, type RouterLifecycleContext, type RouterLifecyclePhase, } from '@modern-js/runtime/context';
+import type { RouterLifecycleContext as NativeRouterLifecycleContext } from '@modern-js/runtime/context';
+import type { InternalRouterServerSnapshot, RouterRouteMatchSnapshot } from '@modern-js/runtime-extensions/router-state';
+export type RouterLifecycleContext = NativeRouterLifecycleContext & {
+    matches?: RouterRouteMatchSnapshot[];
+    cleanup?: () => void | Promise<void>;
+    serverSnapshot?: InternalRouterServerSnapshot;
+};
+export { applyRouterRuntimeState, applyRouterServerPrepareResult, createRouterRuntimeState, createRouterServerSnapshot, getRouterRuntimeState, getRouterServerSnapshot, type RouterLifecyclePhase, } from '@modern-js/runtime-extensions/router-state';

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

@@ -6,5 +6,5 @@
  * This module is intentionally side-effectful (see `sideEffects` in
  * package.json).
  */
-import { type RouterProviderFactory } from '@modern-js/runtime/context';
+import { type RouterProviderFactory } from '@modern-js/runtime-extensions/router-provider';
 export declare const tanstackRouterProviderFactory: RouterProviderFactory;

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

@@ -1,13 +1,2 @@
-/**
- * Entry-injected router module for entrypoints that are NOT TanStack
- * file-route entrypoints (e.g. apps configuring
- * `router: { framework: 'tanstack', createRoutes }` in modern.runtime.ts).
- *
- * The CLI plugin injects `{ name: 'router', path: '<pkg>/runtime/router' }`
- * for those entries. This module creates a framework-resolving wrapper whose
- * app-owned provider realm contains this module graph's TanStack factory.
- */
-import * as runtimeRouter from '@modern-js/runtime/router/internal';
-type LegacyRouterPlugin = (typeof runtimeRouter)['routerPlugin'];
-export declare const routerPlugin: LegacyRouterPlugin;
-export {};
+import { routerPlugin as nativeRouterPlugin } from '@modern-js/runtime/router/internal';
+export declare const routerPlugin: typeof nativeRouterPlugin;

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

@@ -1,4 +1,4 @@
-import { type InternalRouterRuntimeState } from '@modern-js/runtime/context';
+import { type InternalRouterRuntimeState } from '@modern-js/runtime-extensions/router-state';
 import type { AnyRouter } from '@tanstack/react-router';
 /**
  * Router runtime state as published by the TanStack router provider into the

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

@@ -1,7 +1,8 @@
 import type { ModernRoute } from '@modern-js/runtime/context';
 import type { RouteObject } from '@modern-js/runtime-utils/router';
 import type React from 'react';
-export type { InternalRouterServerSnapshot, ModernRoute, RouterFramework, } from '@modern-js/runtime/context';
+export type { ModernRoute } from '@modern-js/runtime/context';
+export type { InternalRouterServerSnapshot, RouterFramework, } from '@modern-js/runtime-extensions/router-state';
 /** TanStack-specific router config. */
 export type RouterConfig = {
     routesConfig: {

package/package.json

@@ -18,7 +18,7 @@
     "modern.js",
     "tanstack-router"
   ],
-  "version": "3.9.0-ultramodern.3",
+  "version": "3.9.0-ultramodern.5",
   "engines": {
     "node": ">=20"
   },
@@ -94,17 +94,19 @@
     }
   },
   "dependencies": {
-    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.9.0-ultramodern.3",
-    "@modern-js/runtime-utils": "npm:@bleedingdev/modern-js-runtime-utils@3.9.0-ultramodern.3",
-    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.9.0-ultramodern.3",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.3",
+    "@modern-js/i18n-runtime-extensions": "npm:@bleedingdev/modern-js-i18n-runtime-extensions@3.9.0-ultramodern.5",
+    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.9.0-ultramodern.5",
+    "@modern-js/runtime-extensions": "npm:@bleedingdev/modern-js-runtime-extensions@3.9.0-ultramodern.5",
+    "@modern-js/runtime-utils": "npm:@bleedingdev/modern-js-runtime-utils@3.9.0-ultramodern.5",
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.9.0-ultramodern.5",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.0-ultramodern.5",
     "@swc/helpers": "^0.5.23",
     "@tanstack/react-router": "1.170.33",
     "@tanstack/router-core": "1.171.28"
   },
   "peerDependencies": {
-    "@modern-js/app-tools": "3.9.0-ultramodern.3",
-    "@modern-js/runtime": "3.9.0-ultramodern.3",
+    "@modern-js/app-tools": "3.9.0-ultramodern.5",
+    "@modern-js/runtime": "3.9.0-ultramodern.5",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
     "react-server-dom-rspack": "0.1.0"
@@ -115,8 +117,9 @@
     }
   },
   "devDependencies": {
-    "@modern-js/app-tools": "npm:@bleedingdev/modern-js-app-tools@3.9.0-ultramodern.3",
-    "@modern-js/runtime": "npm:@bleedingdev/modern-js-runtime@3.9.0-ultramodern.3",
+    "@modern-js/app-tools": "npm:@bleedingdev/modern-js-app-tools@3.9.0-ultramodern.5",
+    "@modern-js/runtime": "npm:@bleedingdev/modern-js-runtime@3.9.0-ultramodern.5",
+    "@modern-js/server-utils": "npm:@bleedingdev/modern-js-server-utils@3.9.0-ultramodern.5",
     "@rslib/core": "1.0.0",
     "@scripts/rstest-config": "2.66.0",
     "@tanstack/history": "1.162.2",

package/rstest.config.mts

@@ -26,18 +26,14 @@ export default {
       include: [
         'tests/realm-isolation.test.ts',
         'tests/router/cli.test.ts',
-        'tests/router/fastDefaults.test.ts',
         'tests/router/flightSerialization.roundtrip.test.tsx',
         'tests/router/generateRouteArtifacts.test.ts',
         'tests/router/hooks.test.ts',
         'tests/router/loaderBridge.test.ts',
-        'tests/router/packageSurface.test.ts',
-        'tests/router/preloadRedirect.test.ts',
-        'tests/router/register.test.ts',
+        'tests/router/localisedIdentity.test.tsx',
         'tests/router/routeHooks.test.ts',
         'tests/router/serverPlugin.test.ts',
         'tests/router/rscDecoderSecurity.test.ts',
-        'tests/router/rscPayloadRouterMatrix.test.ts',
         'tests/router/rsc.test.tsx',
         'tests/router/slotUsageSanitizer.test.ts',
         'tests/router/ssrPreload.test.ts',
@@ -66,7 +62,6 @@ export default {
       include: [
         'tests/router/clientHydration.test.tsx',
         'tests/router/dataMutation.test.tsx',
-        'tests/router/hydrationBoundary.test.tsx',
         'tests/router/prefetchLink.test.tsx',
         'tests/router/prefetchLinkPreload.test.tsx',
       ],

package/src/cli/index.ts

@@ -132,6 +132,16 @@ export function tanstackRouterPlugin(
     name: '@modern-js/plugin-tanstack',
     required: ['@modern-js/runtime'],
     setup: api => {
+      const { srcDirectory, serverCompileExcludedFiles = [] } =
+        api.getAppContext();
+      api.updateAppContext({
+        serverCompileExcludedFiles: [
+          ...new Set([
+            ...serverCompileExcludedFiles,
+            path.join(srcDirectory, generatedDirName, 'register.gen.d.ts'),
+          ]),
+        ],
+      });
       const nestedRoutesForServer: Record<string, unknown> = {};
 
       const isTanstackEntrypoint = (entrypoint: Entrypoint) => {

package/src/cli/tanstackTypes/source.ts

@@ -5,6 +5,7 @@ import type {
   AppTools,
   AppToolsContext,
 } from '@modern-js/app-tools';
+import { canonicaliseLocalisedRoutes } from '@modern-js/i18n-runtime-extensions';
 import { makeLegalIdentifier } from '@modern-js/runtime/cli';
 import type { NestedRouteForCli, PageRoute } from '@modern-js/types';
 import { upath as path } from '@modern-js/utils';
@@ -45,8 +46,9 @@ export async function generateTanstackRouterTypesSourceForEntry(opts: {
     appContext,
     entryName,
     generatedDirName = 'modern-tanstack',
-    routes,
+    routes: rawRoutes,
   } = opts;
+  const routes: RouteForCli[] = canonicaliseLocalisedRoutes(rawRoutes);
   const outDir = path.join(
     appContext.srcDirectory,
     generatedDirName,

package/src/runtime/basepathRewrite.ts

@@ -1,4 +1,8 @@
 // @effect-diagnostics strictBooleanExpressions:off
+import { createLocalisedRouteRewrite } from '@modern-js/i18n-runtime-extensions';
+import type { RouteObject } from '@modern-js/runtime-utils/router';
+import { composeRewrites } from '@tanstack/react-router';
+
 function normalizeBasepath(basepath: string): string {
   if (!basepath) {
     return '/';
@@ -15,10 +19,12 @@ function normalizeBasepath(basepath: string): string {
 export function createModernBasepathRewrite(
   basepath: string,
   caseSensitive = false,
+  routes: RouteObject[] = [],
 ) {
+  const localisedRewrite = createLocalisedRouteRewrite(routes);
   const normalizedBasepath = normalizeBasepath(basepath);
   if (normalizedBasepath === '/') {
-    return undefined;
+    return localisedRewrite;
   }
 
   const normalizedBasepathWithSlash = `${normalizedBasepath}/`;
@@ -29,7 +35,7 @@ export function createModernBasepathRewrite(
     ? normalizedBasepathWithSlash
     : normalizedBasepathWithSlash.toLowerCase();
 
-  return {
+  const basepathRewrite = {
     input: ({ url }: { url: URL }) => {
       const pathname = caseSensitive
         ? url.pathname
@@ -57,4 +63,7 @@ export function createModernBasepathRewrite(
       return url;
     },
   };
+  return localisedRewrite
+    ? composeRewrites([basepathRewrite, localisedRewrite])
+    : basepathRewrite;
 }

package/src/runtime/lifecycle.ts

@@ -1,9 +1,21 @@
 /**
- * The router runtime state helpers are owned by @modern-js/runtime (the same
+ * The router runtime state helpers are owned by @modern-js/runtime-extensions (the same
  * implementation backs the built-in react-router provider and the SSR
  * pipeline). This module only re-exports them so every router provider
  * writes to the exact same runtime-context extension slot.
  */
+
+import type { RouterLifecycleContext as NativeRouterLifecycleContext } from '@modern-js/runtime/context';
+import type {
+  InternalRouterServerSnapshot,
+  RouterRouteMatchSnapshot,
+} from '@modern-js/runtime-extensions/router-state';
+
+export type RouterLifecycleContext = NativeRouterLifecycleContext & {
+  matches?: RouterRouteMatchSnapshot[];
+  cleanup?: () => void | Promise<void>;
+  serverSnapshot?: InternalRouterServerSnapshot;
+};
 export {
   applyRouterRuntimeState,
   applyRouterServerPrepareResult,
@@ -11,6 +23,5 @@ export {
   createRouterServerSnapshot,
   getRouterRuntimeState,
   getRouterServerSnapshot,
-  type RouterLifecycleContext,
   type RouterLifecyclePhase,
-} from '@modern-js/runtime/context';
+} from '@modern-js/runtime-extensions/router-state';

package/src/runtime/plugin.node.tsx

@@ -1,10 +1,10 @@
 // @effect-diagnostics asyncFunction:off newPromise:off strictBooleanExpressions:off unnecessaryArrowBlock:off
 import {
   getGlobalEnableRsc,
-  type InternalRouterServerSnapshot,
   InternalRuntimeContext,
   type TInternalRuntimeContext,
 } from '@modern-js/runtime/context';
+import type { InternalRouterServerSnapshot } from '@modern-js/runtime-extensions/router-state';
 import {
   createRequestContext,
   type RequestContext,
@@ -35,6 +35,7 @@ import {
   type TanstackRouterPluginAPI,
   type TanstackRouterRuntimePlugin,
 } from './pluginShared';
+import { Link } from './prefetchLink';
 import {
   createRouteTreeFromRouteObjects,
   getModernRouteIdsFromMatches,
@@ -98,6 +99,8 @@ export const tanstackRouterPlugin = (
           return;
         }
 
+        context.router = { Link };
+
         const {
           request,
           nonce,
@@ -134,7 +137,11 @@ export const tanstackRouterPlugin = (
           initialEntries: [initialHref],
         });
 
-        const rewrite = createModernBasepathRewrite(_basename);
+        const rewrite = createModernBasepathRewrite(
+          _basename,
+          false,
+          modifiedRouteObjects,
+        );
         const routerLifecycleContext: RouterLifecycleContext = {
           framework: 'tanstack',
           phase: 'ssr-prepare',

package/src/runtime/plugin.tsx

@@ -149,7 +149,11 @@ export const tanstackRouterPlugin = (
         const history = supportHtml5History
           ? createBrowserHistory()
           : createHashHistory();
-        const rewrite = createModernBasepathRewrite(_basename);
+        const rewrite = createModernBasepathRewrite(
+          _basename,
+          false,
+          getRouteObjects(),
+        );
         const serializationAdapters = getGlobalEnableRsc()
           ? getTanstackRscSerializationAdapters()
           : undefined;

package/src/runtime/prefetchLink.tsx

@@ -1,3 +1,4 @@
+import { resolvePreloadFromPrefetch } from '@modern-js/runtime-extensions';
 import {
   type AnyRouter,
   type LinkComponentProps,
@@ -8,29 +9,6 @@ import type { AnchorHTMLAttributes, ReactElement, ReactNode, Ref } from 'react';
 
 export type PrefetchBehavior = 'intent' | 'render' | 'viewport' | 'none';
 
-function resolvePreloadFromPrefetch(
-  prefetch: PrefetchBehavior | undefined,
-  preload: unknown,
-) {
-  if (typeof preload !== 'undefined') {
-    return preload;
-  }
-
-  if (prefetch === 'none') {
-    return false;
-  }
-
-  if (
-    prefetch === 'intent' ||
-    prefetch === 'render' ||
-    prefetch === 'viewport'
-  ) {
-    return prefetch;
-  }
-
-  return 'viewport';
-}
-
 export type LinkProps<
   TRouter extends AnyRouter = RegisteredRouter,
   TFrom extends string = string,

package/src/runtime/register.ts

@@ -10,7 +10,7 @@ import {
   type RouterProviderFactory,
   type RouterProviderPlugin,
   registerRouterProvider,
-} from '@modern-js/runtime/context';
+} from '@modern-js/runtime-extensions/router-provider';
 import { tanstackRouterPlugin } from './plugin';
 
 // TanStack runtime plugin types its API against its own hook registry,

package/src/runtime/routeTree/construction.ts

@@ -1,5 +1,6 @@
 // @effect-diagnostics asyncFunction:off strictBooleanExpressions:off
 
+import { canonicaliseLocalisedRoutes } from '@modern-js/i18n-runtime-extensions';
 import { DefaultNotFound } from '@modern-js/runtime/context';
 import type { RouteObject } from '@modern-js/runtime-utils/router';
 import type { AnyRoute, AnyRouter } from '@tanstack/react-router';
@@ -121,6 +122,7 @@ export function createRouteTreeFromRouteObjects(
   routes: RouteObject[],
   options: RouteTreeOptions = {},
 ): ModernTanstackRootRoute {
+  routes = canonicaliseLocalisedRoutes(routes);
   const rootLikeRoute = getRootLikeRouteObject(routes) as
     | ModernRouteObject
     | undefined;

package/src/runtime/router.ts

@@ -1,43 +1,28 @@
-/**
- * Entry-injected router module for entrypoints that are NOT TanStack
- * file-route entrypoints (e.g. apps configuring
- * `router: { framework: 'tanstack', createRoutes }` in modern.runtime.ts).
- *
- * The CLI plugin injects `{ name: 'router', path: '<pkg>/runtime/router' }`
- * for those entries. This module creates a framework-resolving wrapper whose
- * app-owned provider realm contains this module graph's TanStack factory.
- */
-import * as runtimeRouter from '@modern-js/runtime/router/internal';
+/** App-local composition for custom entries using runtime router selection. */
+import { routerProviderRegistryHooks } from '@modern-js/runtime/context';
+import { routerPlugin as nativeRouterPlugin } from '@modern-js/runtime/router/internal';
+import { createRouterPlugin } from '@modern-js/runtime-extensions/router-provider';
+import { createRouterStatePlugin } from '@modern-js/runtime-extensions/router-state-plugin';
 import { tanstackRouterProviderFactory } from './register';
 
-type LegacyRouterPlugin = (typeof runtimeRouter)['routerPlugin'];
-type CurrentRouterPluginCreator = (
-  localProviders: readonly {
-    name: string;
-    factory: typeof tanstackRouterProviderFactory;
-  }[],
-) => LegacyRouterPlugin;
+const createProviderPlugin = createRouterPlugin({
+  defaultProvider: { name: 'react-router', factory: nativeRouterPlugin },
+  registryHooks: routerProviderRegistryHooks,
+  localProviders: [
+    { name: 'tanstack', factory: tanstackRouterProviderFactory },
+  ],
+});
+const statePlugin = createRouterStatePlugin({
+  registryHooks: routerProviderRegistryHooks,
+});
 
-function getRouterPlugin(): LegacyRouterPlugin {
-  const createRouterPlugin = Reflect.get(runtimeRouter, 'createRouterPlugin') as
-    | CurrentRouterPluginCreator
-    | undefined;
-
-  if (typeof createRouterPlugin === 'function') {
-    return createRouterPlugin([
-      { name: 'tanstack', factory: tanstackRouterProviderFactory },
-    ]);
-  }
-
-  const legacyRouterPlugin = Reflect.get(runtimeRouter, 'routerPlugin');
-
-  if (typeof legacyRouterPlugin === 'function') {
-    return tanstackRouterProviderFactory as unknown as LegacyRouterPlugin;
-  }
-
-  throw new Error(
-    '[@modern-js/plugin-tanstack] The installed @modern-js/runtime/router/internal exports neither createRouterPlugin nor routerPlugin. Install a compatible @modern-js/runtime version.',
-  );
-}
-
-export const routerPlugin: LegacyRouterPlugin = getRouterPlugin();
+export const routerPlugin: typeof nativeRouterPlugin = (userConfig = {}) => {
+  const providerPlugin = createProviderPlugin(userConfig);
+  return {
+    ...providerPlugin,
+    setup(api) {
+      statePlugin.setup(api);
+      providerPlugin.setup(api);
+    },
+  };
+};

package/src/runtime/state.ts

@@ -1,7 +1,7 @@
 import {
   getRouterRuntimeState,
   type InternalRouterRuntimeState,
-} from '@modern-js/runtime/context';
+} from '@modern-js/runtime-extensions/router-state';
 import type { AnyRouter } from '@tanstack/react-router';
 
 /**

package/src/runtime/types.ts

@@ -2,11 +2,11 @@ import type { ModernRoute } from '@modern-js/runtime/context';
 import type { RouteObject } from '@modern-js/runtime-utils/router';
 import type React from 'react';
 
+export type { ModernRoute } from '@modern-js/runtime/context';
 export type {
   InternalRouterServerSnapshot,
-  ModernRoute,
   RouterFramework,
-} from '@modern-js/runtime/context';
+} from '@modern-js/runtime-extensions/router-state';
 
 /** TanStack-specific router config. */
 export type RouterConfig = {

package/src/runtime/utils.tsx

@@ -54,6 +54,7 @@ function toTanstackRouteObject(
 ): RouteObject | null {
   if (route.type === 'nested') {
     return {
+      modernLocalisedRoute: Reflect.get(route, 'modernLocalisedRoute'),
       path: route.path,
       id: route.id,
       loader: route.loader,
@@ -91,9 +92,10 @@ function toTanstackRouteObject(
     globalApp,
   );
   return {
+    modernLocalisedRoute: Reflect.get(route, 'modernLocalisedRoute'),
     path: route.path,
     element: React.createElement(LayoutComponent),
-  };
+  } as ModernRouteObject;
 }
 
 export function createTanstackRouteObjectsFromConfig({

package/tests/realm-isolation.test.ts

@@ -1,4 +1,4 @@
-import type { RouterProviderFactory } from '@modern-js/runtime/context';
+import type { RouterProviderFactory } from '@modern-js/runtime-extensions/router-provider';
 import { rstest } from '@rstest/core';
 import type { RouterExtendsHooks } from '../src/runtime/hooks';
 
@@ -12,6 +12,7 @@ type RouterModule = typeof import('../src/runtime/router');
 
 type Vertical = {
   context: RuntimeContextModule;
+  providers: typeof import('@modern-js/runtime-extensions/router-provider');
   factory: RouterProviderFactory;
   hooks: RouterExtendsHooks;
   Link: unknown;
@@ -32,8 +33,12 @@ async function loadVertical(): Promise<Vertical> {
   const { Link } = await import('../src/runtime/prefetchLink');
   const { useMatches } = await import('../src/runtime/routeHooks');
 
+  const providers = await import(
+    '@modern-js/runtime-extensions/router-provider'
+  );
   return {
     context,
+    providers,
     factory: tanstackRouterProviderFactory,
     hooks: routerProviderRegistryHooks,
     Link,
@@ -50,6 +55,7 @@ function setupRouterWrapper(vertical: Vertical) {
   const plugin = vertical.routerPlugin({ framework: 'tanstack' });
   plugin.setup?.({
     getHooks: () => vertical.hooks,
+    onAfterCreateRouter: () => undefined,
     getRuntimeConfig: () => ({ router: { framework: 'tanstack' } }),
     onBeforeRender: listener => {
       onBeforeRender = listener;
@@ -101,7 +107,7 @@ describe('TanStack provider runtime-realm isolation', () => {
 
       // Mixed-version callers that do not supply a realm still see the shared
       // keep-first fallback, but production wrappers no longer consume it.
-      expect(verticalB.context.resolveRouterProvider('tanstack')).toBe(
+      expect(verticalB.providers.resolveRouterProvider('tanstack')).toBe(
         verticalA.factory,
       );
       expect(warnSpy).toHaveBeenCalledWith(