@tanstack/router-plugin 1.168.24-pre.0 → 1.168.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/router-plugin",
-  "version": "1.168.24-pre.0",
+  "version": "1.168.25",
   "description": "Modern and scalable routing for React applications",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -106,11 +106,12 @@
     "chokidar": "^5.0.0",
     "unplugin": "^3.0.0",
     "zod": "^4.4.3",
-    "@tanstack/router-core": "1.171.16-pre.0",
-    "@tanstack/router-generator": "1.167.22-pre.0",
+    "@tanstack/router-core": "1.171.17",
+    "@tanstack/router-generator": "1.167.23",
     "@tanstack/router-utils": "1.162.2"
   },
   "devDependencies": {
+    "@rsbuild/core": "^2.1.0",
     "@types/babel__core": "^7.20.5",
     "@types/babel__template": "^7.4.4",
     "@types/node": ">=20"
@@ -120,7 +121,7 @@
     "vite": ">=5.0.0 || >=6.0.0 || >=7.0.0 || >=8.0.0",
     "vite-plugin-solid": "^2.11.10 || ^3.0.0-0",
     "webpack": ">=5.92.0",
-    "@tanstack/react-router": "^1.170.19-pre.0"
+    "@tanstack/react-router": "^1.170.20"
   },
   "peerDependenciesMeta": {
     "@rsbuild/core": {

package/skills/router-plugin/SKILL.md

@@ -5,9 +5,10 @@ description: >-
   code splitting. Supports Vite, Webpack, Rspack, and esbuild.
   Configures autoCodeSplitting, routesDirectory, target framework,
   and code split groupings.
-type: core
-library: tanstack-router
-library_version: '1.166.2'
+metadata:
+  type: core
+  library: tanstack-router
+  library_version: '1.168.23'
 sources:
   - TanStack/router:packages/router-plugin/src
   - TanStack/router:docs/router/routing/file-based-routing.md
@@ -170,6 +171,18 @@ The composed plugin assembles up to 3 sub-plugins:
 2. **Code Splitter** (when `autoCodeSplitting: true`) — Splits route files into lazy-loaded chunks using virtual modules
 3. **HMR** (dev mode, when code splitter is off) — Hot-reloads route changes without full refresh
 
+## Route Refactor Workflow
+
+When moving, renaming, adding, or deleting file routes:
+
+1. Change the source files under `routesDirectory`. Keep the exported route identifier named `Route`.
+2. Let the bundler plugin regenerate the tree, or run `pnpm exec tsr generate` when the project uses the CLI.
+3. Inspect the generated diff for the expected route IDs, parents, paths, and imports. Never repair `routeTree.gen.ts` by hand.
+4. Update links, redirects, `from` narrowing, params, preload calls, and tests that reference the old route.
+5. Run route-generation tests, type tests, and a production build. A passing editor typecheck does not prove the plugin generated or split the new route correctly.
+
+Commit `routeTree.gen.ts`; it is generated source used by the application at runtime.
+
 ## Individual Plugin Exports
 
 For advanced use, each sub-plugin is exported separately from the Vite entry:
@@ -227,6 +240,10 @@ function AboutPage() {
 }
 ```
 
+### 4. HIGH: Editing the generated route tree
+
+Changes to `routeTree.gen.ts` are overwritten and can leave source routes, generated types, and runtime routing out of sync. Fix route filenames or plugin configuration, regenerate, and verify the generated diff instead.
+
 ## Cross-References
 
 - [router-core/code-splitting](../../../router-core/skills/router-core/code-splitting/SKILL.md) — manual code splitting concepts