improve generator warning

Author: schiller-manuel

packages/router-generator/src/generator.ts

@@ -1090,9 +1090,22 @@ ${acc.routeTree.map((child) => `${child.variableName}Route: typeof ${getResolved
       })
 
       if (transformResult.result === 'no-route-export') {
-        this.logger.warn(
-          `Route file "${node.fullPath}" does not contain any route piece. This is likely a mistake.`,
-        )
+        const fileName = path.basename(node.fullPath)
+        const dirName = path.dirname(node.fullPath)
+        const ignorePrefix = this.config.routeFileIgnorePrefix
+        const ignorePattern = this.config.routeFileIgnorePattern
+        const suggestedFileName = `${ignorePrefix}${fileName}`
+        const suggestedFullPath = path.join(dirName, suggestedFileName)
+
+        let message = `Warning: Route file "${node.fullPath}" does not export a Route. This file will not be included in the route tree.`
+        message += `\n\nIf this file is not intended to be a route, you can exclude it using one of these options:`
+        message += `\n  1. Rename the file to "${suggestedFullPath}" (prefix with "${ignorePrefix}")`
+        message += `\n  2. Use 'routeFileIgnorePattern' in your config to match this file`
+        message += `\n\nCurrent configuration:`
+        message += `\n  routeFileIgnorePrefix: "${ignorePrefix}"`
+        message += `\n  routeFileIgnorePattern: ${ignorePattern ? `"${ignorePattern}"` : 'undefined'}`
+
+        this.logger.warn(message)
         return null
       }
       if (transformResult.result === 'error') {

packages/router-generator/tests/generator/virtual-physical-empty-path-conflict-root/routes/merged/route.tsx

@@ -2,5 +2,4 @@ import { createFileRoute } from '@tanstack/react-router'
 
 // This route.tsx in a physical directory mounted at root level
 // conflicts with the virtual root __root.tsx - can't have two root routes
-export const Route = createFileRoute('')({
-})
+export const Route = createFileRoute('')({})

packages/router-generator/tests/generator/virtual-physical-empty-path-merge/routes/__root.tsx

@@ -1 +1,3 @@
+import { createRootRoute } from '@tanstack/react-router'
+
 export const Route = createRootRoute()