fix(router-core): Pathless Layout Route Renders Empty HTML

packages/router-core/src/router.ts

@@ -3032,6 +3032,7 @@ interface RouteLike {
   children?: Array<RouteLike>
   options?: {
     caseSensitive?: boolean
+    isVirtualLayout?: boolean
   }
 }
 
@@ -3225,6 +3226,8 @@ export function getMatchedRoutes<TRouteLike extends RouteLike>({
     routeParams = getMatchedParams(foundRoute)!
   } else {
     foundRoute = flatRoutes.find((route) => {
+      if (route.options?.isVirtualLayout) return false
+
       const matchedParams = getMatchedParams(route)
 
       if (matchedParams) {

packages/router-generator/src/generator.ts

@@ -525,6 +525,23 @@ export class Generator {
         (d) => d,
       ])
 
+      // After all nodes have been processed we can safely (re)-evaluate
+      // whether a virtual `layout` route should be treated as a virtual-layout wrapper
+      sortedRouteNodes.forEach((node) => {
+        if (
+          node.isVirtual &&
+          node._fsRouteType === 'layout' &&
+          node.children &&
+          !node.children.some((c) => c.cleanedPath === '/')
+        ) {
+          node.isVirtualLayout = true
+        } else {
+          // If the conditions are not met, ensure the flag is falsy so we
+          // don't rely on an outdated value that may have been set earlier.
+          delete node.isVirtualLayout
+        }
+      })
+
       const pluginConfig = plugin.config({
         generator: this,
         rootRouteNode,
@@ -583,6 +600,7 @@ export class Generator {
               `id: '${node.path}'`,
               !node.isNonPath ? `path: '${node.cleanedPath}'` : undefined,
               `getParentRoute: () => ${findParent(node, exportName)}`,
+              node.isVirtualLayout ? `isVirtualLayout: true` : undefined,
             ]
               .filter(Boolean)
               .join(',')}

packages/router-generator/src/types.ts

@@ -13,6 +13,7 @@ export type RouteNode = {
   children?: Array<RouteNode>
   parent?: RouteNode
   exports?: Array<string>
+  isVirtualLayout?: boolean
 }
 
 export interface GetRouteNodesResult {