From 4bd516e29c031c64f9e689f04a109f49e5bb662e Mon Sep 17 00:00:00 2001 From: Birk Skyum Date: Sat, 21 Feb 2026 01:46:55 +0100 Subject: [PATCH 001/218] solid v2 override --- package.json | 2 +- pnpm-lock.yaml | 1128 ++++++++++++++++++++++++------------------------ 2 files changed, 568 insertions(+), 562 deletions(-) diff --git a/package.json b/package.json index 15e059571c..6777860fd1 100644 --- a/package.json +++ b/package.json @@ -77,7 +77,7 @@ "overrides": { "@types/babel__traverse": "^7.28.0", "vite-plugin-dts": "4.0.3", - "solid-js": "1.9.10", + "solid-js": "2.0.0-experimental.14", "react": "$react", "react-dom": "$react-dom", "@types/react": "$@types/react", diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index a3afb217f4..df33cd3238 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -7,7 +7,7 @@ settings: overrides: '@types/babel__traverse': ^7.28.0 vite-plugin-dts: 4.0.3 - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 react: ^19.2.3 react-dom: ^19.2.3 '@types/react': ^19.2.8 @@ -2618,8 +2618,8 @@ importers: specifier: workspace:^ version: link:../../../packages/solid-router-devtools solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 devDependencies: '@playwright/test': specifier: ^1.57.0 @@ -2632,7 +2632,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/basic: dependencies: @@ -2649,8 +2649,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -2666,7 +2666,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/basic-esbuild-file-based: dependencies: @@ -2686,8 +2686,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 zod: specifier: ^3.24.2 version: 3.25.57 @@ -2703,7 +2703,7 @@ importers: version: 0.25.4 esbuild-plugin-solid: specifier: ^0.6.0 - version: 0.6.0(esbuild@0.25.4)(solid-js@1.9.10) + version: 0.6.0(esbuild@0.25.4)(solid-js@2.0.0-experimental.14) e2e/solid-router/basic-file-based: dependencies: @@ -2726,8 +2726,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -2749,7 +2749,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/basic-file-based-code-splitting: dependencies: @@ -2766,8 +2766,8 @@ importers: specifier: workspace:^ version: link:../../../packages/solid-router-devtools solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -2786,7 +2786,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/basic-scroll-restoration: dependencies: @@ -2801,13 +2801,13 @@ importers: version: link:../../../packages/solid-router-devtools '@tanstack/solid-virtual': specifier: ^3.13.0 - version: 3.13.12(solid-js@1.9.10) + version: 3.13.12(solid-js@2.0.0-experimental.14) redaxios: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -2823,7 +2823,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/basic-solid-query: dependencies: @@ -2832,10 +2832,10 @@ importers: version: 4.1.18(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) '@tanstack/solid-query': specifier: ^5.90.9 - version: 5.90.9(solid-js@1.9.10) + version: 5.90.9(solid-js@2.0.0-experimental.14) '@tanstack/solid-query-devtools': specifier: ^5.90.0 - version: 5.90.4(@tanstack/solid-query@5.90.9(solid-js@1.9.10))(solid-js@1.9.10) + version: 5.90.4(@tanstack/solid-query@5.90.9(solid-js@2.0.0-experimental.14))(solid-js@2.0.0-experimental.14) '@tanstack/solid-router': specifier: workspace:^ version: link:../../../packages/solid-router @@ -2846,8 +2846,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -2863,7 +2863,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/basic-solid-query-file-based: dependencies: @@ -2875,10 +2875,10 @@ importers: version: link:../../../packages/router-plugin '@tanstack/solid-query': specifier: ^5.90.9 - version: 5.90.9(solid-js@1.9.10) + version: 5.90.9(solid-js@2.0.0-experimental.14) '@tanstack/solid-query-devtools': specifier: ^5.90.0 - version: 5.90.4(@tanstack/solid-query@5.90.9(solid-js@1.9.10))(solid-js@1.9.10) + version: 5.90.4(@tanstack/solid-query@5.90.9(solid-js@2.0.0-experimental.14))(solid-js@2.0.0-experimental.14) '@tanstack/solid-router': specifier: workspace:^ version: link:../../../packages/solid-router @@ -2889,8 +2889,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -2909,7 +2909,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/basic-virtual-file-based: dependencies: @@ -2932,8 +2932,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -2952,7 +2952,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/basic-virtual-named-export-config-file-based: dependencies: @@ -2975,8 +2975,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -2995,7 +2995,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/generator-cli-only: dependencies: @@ -3015,8 +3015,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -3032,7 +3032,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/js-only-file-based: dependencies: @@ -3049,8 +3049,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -3069,7 +3069,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/rspack-basic-file-based: dependencies: @@ -3083,8 +3083,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 devDependencies: '@playwright/test': specifier: ^1.57.0 @@ -3097,7 +3097,7 @@ importers: version: 1.0.3(@rsbuild/core@1.2.4) '@rsbuild/plugin-solid': specifier: ^1.0.6 - version: 1.0.6(@babel/core@7.28.5)(@rsbuild/core@1.2.4)(solid-js@1.9.10) + version: 1.0.6(@babel/core@7.28.5)(@rsbuild/core@1.2.4)(solid-js@2.0.0-experimental.14) '@tailwindcss/postcss': specifier: ^4.1.18 version: 4.1.18 @@ -3129,8 +3129,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 devDependencies: '@playwright/test': specifier: ^1.57.0 @@ -3143,7 +3143,7 @@ importers: version: 1.0.3(@rsbuild/core@1.2.4) '@rsbuild/plugin-solid': specifier: ^1.0.6 - version: 1.0.6(@babel/core@7.28.5)(@rsbuild/core@1.2.4)(solid-js@1.9.10) + version: 1.0.6(@babel/core@7.28.5)(@rsbuild/core@1.2.4)(solid-js@2.0.0-experimental.14) '@tailwindcss/postcss': specifier: ^4.1.18 version: 4.1.18 @@ -3187,8 +3187,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -3207,13 +3207,13 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/sentry-integration: dependencies: '@sentry/solid': specifier: ^10.32.0 - version: 10.32.0(@tanstack/solid-router@packages+solid-router)(solid-js@1.9.10) + version: 10.32.0(@tanstack/solid-router@packages+solid-router)(solid-js@2.0.0-experimental.14) '@sentry/tracing': specifier: ^7.120.4 version: 7.120.4 @@ -3233,8 +3233,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -3250,7 +3250,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/view-transitions: dependencies: @@ -3270,8 +3270,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -3293,7 +3293,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-start/basic: dependencies: @@ -3319,8 +3319,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwind-merge: specifier: ^2.6.0 version: 2.6.0 @@ -3360,7 +3360,7 @@ importers: version: 5.8.2 vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.8.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -3389,8 +3389,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwind-merge: specifier: ^2.6.0 version: 2.6.0 @@ -3427,7 +3427,7 @@ importers: version: 5.9.2 vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -3444,8 +3444,8 @@ importers: specifier: workspace:* version: link:../../../packages/solid-start solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 devDependencies: '@cloudflare/vite-plugin': specifier: ^1.15.1 @@ -3473,7 +3473,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -3485,10 +3485,10 @@ importers: dependencies: '@tanstack/solid-query': specifier: ^5.90.9 - version: 5.90.9(solid-js@1.9.10) + version: 5.90.9(solid-js@2.0.0-experimental.14) '@tanstack/solid-query-devtools': specifier: ^5.90.0 - version: 5.90.4(@tanstack/solid-query@5.90.9(solid-js@1.9.10))(solid-js@1.9.10) + version: 5.90.4(@tanstack/solid-query@5.90.9(solid-js@2.0.0-experimental.14))(solid-js@2.0.0-experimental.14) '@tanstack/solid-router': specifier: workspace:^ version: link:../../../packages/solid-router @@ -3505,8 +3505,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwind-merge: specifier: ^2.6.0 version: 2.6.0 @@ -3540,7 +3540,7 @@ importers: version: 5.9.2 vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -3557,8 +3557,8 @@ importers: specifier: workspace:* version: link:../../../packages/solid-start solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 vite: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) @@ -3577,7 +3577,7 @@ importers: version: 5.8.2 vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.8.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -3591,8 +3591,8 @@ importers: specifier: workspace:* version: link:../../../packages/solid-start solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 vite: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) @@ -3614,7 +3614,7 @@ importers: version: 5.9.2 vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-start/css-modules: dependencies: @@ -3625,8 +3625,8 @@ importers: specifier: workspace:* version: link:../../../packages/solid-start solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 devDependencies: '@playwright/test': specifier: ^1.57.0 @@ -3651,7 +3651,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -3674,8 +3674,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 devDependencies: '@playwright/test': specifier: ^1.57.0 @@ -3712,7 +3712,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.8.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -3721,10 +3721,10 @@ importers: dependencies: '@tanstack/solid-query': specifier: ^5.90.9 - version: 5.90.9(solid-js@1.9.10) + version: 5.90.9(solid-js@2.0.0-experimental.14) '@tanstack/solid-query-devtools': specifier: ^5.90.0 - version: 5.90.4(@tanstack/solid-query@5.90.9(solid-js@1.9.10))(solid-js@1.9.10) + version: 5.90.4(@tanstack/solid-query@5.90.9(solid-js@2.0.0-experimental.14))(solid-js@2.0.0-experimental.14) '@tanstack/solid-router': specifier: workspace:^ version: link:../../../packages/solid-router @@ -3738,8 +3738,8 @@ importers: specifier: workspace:* version: link:../../../packages/solid-start solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwind-merge: specifier: ^2.6.0 version: 2.6.0 @@ -3770,7 +3770,7 @@ importers: version: 5.9.2 vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -3793,8 +3793,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwind-merge: specifier: ^2.6.0 version: 2.6.0 @@ -3831,7 +3831,7 @@ importers: version: 5.8.2 vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.8.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -3845,8 +3845,8 @@ importers: specifier: workspace:* version: link:../../../packages/solid-start solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 zod: specifier: ^3.24.2 version: 3.25.57 @@ -3871,7 +3871,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.8.3)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -3888,8 +3888,8 @@ importers: specifier: workspace:* version: link:../../../packages/solid-start solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 vite: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) @@ -3920,13 +3920,13 @@ importers: version: 5.9.2 vite-plugin-solid: specifier: ^2.11.9 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-start/server-functions: dependencies: '@tanstack/solid-query': specifier: ^5.90.9 - version: 5.90.9(solid-js@1.9.10) + version: 5.90.9(solid-js@2.0.0-experimental.14) '@tanstack/solid-router': specifier: workspace:^ version: link:../../../packages/solid-router @@ -3946,8 +3946,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwind-merge: specifier: ^2.6.0 version: 2.6.0 @@ -3987,7 +3987,7 @@ importers: version: 5.8.2 vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.8.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -3996,7 +3996,7 @@ importers: dependencies: '@tanstack/solid-query': specifier: ^5.90.9 - version: 5.90.9(solid-js@1.9.10) + version: 5.90.9(solid-js@2.0.0-experimental.14) '@tanstack/solid-router': specifier: workspace:^ version: link:../../../packages/solid-router @@ -4016,8 +4016,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwind-merge: specifier: ^2.6.0 version: 2.6.0 @@ -4057,7 +4057,7 @@ importers: version: 5.8.3 vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.8.3)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -4074,8 +4074,8 @@ importers: specifier: workspace:* version: link:../../../packages/solid-start solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 zod: specifier: ^3.24.2 version: 3.25.57 @@ -4097,7 +4097,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.8.3)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -4120,8 +4120,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwind-merge: specifier: ^2.6.0 version: 2.6.0 @@ -4158,7 +4158,7 @@ importers: version: 5.9.2 vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -4178,8 +4178,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwind-merge: specifier: ^2.6.0 version: 2.6.0 @@ -4213,7 +4213,7 @@ importers: version: 5.8.2 vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.8.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -8361,7 +8361,7 @@ importers: version: 4.1.18(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) '@tanstack/react-devtools': specifier: ^0.7.0 - version: 0.7.0(@types/react-dom@19.2.3(@types/react@19.2.8))(@types/react@19.2.8)(csstype@3.2.3)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(solid-js@1.9.10) + version: 0.7.0(@types/react-dom@19.2.3(@types/react@19.2.8))(@types/react@19.2.8)(csstype@3.2.3)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(solid-js@2.0.0-experimental.14) '@tanstack/react-router': specifier: workspace:* version: link:../../../packages/react-router @@ -8617,7 +8617,7 @@ importers: dependencies: '@tanstack/react-devtools': specifier: ^0.7.0 - version: 0.7.0(@types/react-dom@19.2.3(@types/react@19.2.8))(@types/react@19.2.8)(csstype@3.2.3)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(solid-js@1.9.10) + version: 0.7.0(@types/react-dom@19.2.3(@types/react@19.2.8))(@types/react@19.2.8)(csstype@3.2.3)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(solid-js@2.0.0-experimental.14) '@tanstack/react-router': specifier: workspace:* version: link:../../../packages/react-router @@ -9282,8 +9282,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -9299,7 +9299,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/authenticated-routes-firebase: dependencies: @@ -9325,8 +9325,8 @@ importers: specifier: ^14.9.0 version: 14.9.0 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -9342,7 +9342,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/basic: dependencies: @@ -9359,8 +9359,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -9379,7 +9379,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/basic-default-search-params: dependencies: @@ -9388,7 +9388,7 @@ importers: version: 4.1.18(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) '@tanstack/solid-query': specifier: ^5.90.9 - version: 5.90.9(solid-js@1.9.10) + version: 5.90.9(solid-js@2.0.0-experimental.14) '@tanstack/solid-router': specifier: ^1.161.3 version: link:../../../packages/solid-router @@ -9399,8 +9399,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -9416,7 +9416,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/basic-devtools-panel: dependencies: @@ -9433,8 +9433,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -9447,7 +9447,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/basic-file-based: dependencies: @@ -9464,8 +9464,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -9484,7 +9484,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/basic-non-nested-devtools: dependencies: @@ -9501,8 +9501,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -9521,7 +9521,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/basic-solid-query: dependencies: @@ -9530,10 +9530,10 @@ importers: version: 4.1.18(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) '@tanstack/solid-query': specifier: ^5.90.9 - version: 5.90.9(solid-js@1.9.10) + version: 5.90.9(solid-js@2.0.0-experimental.14) '@tanstack/solid-query-devtools': specifier: ^5.90.0 - version: 5.90.4(@tanstack/solid-query@5.90.9(solid-js@1.9.10))(solid-js@1.9.10) + version: 5.90.4(@tanstack/solid-query@5.90.9(solid-js@2.0.0-experimental.14))(solid-js@2.0.0-experimental.14) '@tanstack/solid-router': specifier: ^1.161.3 version: link:../../../packages/solid-router @@ -9544,8 +9544,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -9561,7 +9561,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/basic-solid-query-file-based: dependencies: @@ -9570,10 +9570,10 @@ importers: version: 4.1.18(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) '@tanstack/solid-query': specifier: ^5.90.9 - version: 5.90.9(solid-js@1.9.10) + version: 5.90.9(solid-js@2.0.0-experimental.14) '@tanstack/solid-query-devtools': specifier: ^5.90.0 - version: 5.90.4(@tanstack/solid-query@5.90.9(solid-js@1.9.10))(solid-js@1.9.10) + version: 5.90.4(@tanstack/solid-query@5.90.9(solid-js@2.0.0-experimental.14))(solid-js@2.0.0-experimental.14) '@tanstack/solid-router': specifier: ^1.161.3 version: link:../../../packages/solid-router @@ -9584,8 +9584,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -9604,7 +9604,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/basic-ssr-file-based: dependencies: @@ -9627,8 +9627,8 @@ importers: specifier: ^3.3.2 version: 3.3.2 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 devDependencies: '@tanstack/solid-router-devtools': specifier: workspace:^ @@ -9644,7 +9644,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/basic-ssr-streaming-file-based: dependencies: @@ -9673,8 +9673,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -9696,7 +9696,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/basic-virtual-file-based: dependencies: @@ -9719,8 +9719,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -9736,7 +9736,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/basic-virtual-inside-file-based: dependencies: @@ -9759,8 +9759,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -9776,7 +9776,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/deferred-data: dependencies: @@ -9793,8 +9793,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -9810,7 +9810,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/i18n-paraglide: dependencies: @@ -9824,8 +9824,8 @@ importers: specifier: ^1.161.3 version: link:../../../packages/solid-router solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -9844,7 +9844,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/kitchen-sink: dependencies: @@ -9864,8 +9864,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -9881,7 +9881,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/kitchen-sink-file-based: dependencies: @@ -9901,8 +9901,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -9921,7 +9921,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/kitchen-sink-solid-query: dependencies: @@ -9930,10 +9930,10 @@ importers: version: 4.1.18(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) '@tanstack/solid-query': specifier: ^5.90.9 - version: 5.90.9(solid-js@1.9.10) + version: 5.90.9(solid-js@2.0.0-experimental.14) '@tanstack/solid-query-devtools': specifier: ^5.90.0 - version: 5.90.4(@tanstack/solid-query@5.90.9(solid-js@1.9.10))(solid-js@1.9.10) + version: 5.90.4(@tanstack/solid-query@5.90.9(solid-js@2.0.0-experimental.14))(solid-js@2.0.0-experimental.14) '@tanstack/solid-router': specifier: ^1.161.3 version: link:../../../packages/solid-router @@ -9947,8 +9947,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -9964,7 +9964,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/kitchen-sink-solid-query-file-based: dependencies: @@ -9976,10 +9976,10 @@ importers: version: link:../../../packages/router-plugin '@tanstack/solid-query': specifier: ^5.90.9 - version: 5.90.9(solid-js@1.9.10) + version: 5.90.9(solid-js@2.0.0-experimental.14) '@tanstack/solid-query-devtools': specifier: ^5.90.0 - version: 5.90.4(@tanstack/solid-query@5.90.9(solid-js@1.9.10))(solid-js@1.9.10) + version: 5.90.4(@tanstack/solid-query@5.90.9(solid-js@2.0.0-experimental.14))(solid-js@2.0.0-experimental.14) '@tanstack/solid-router': specifier: ^1.161.3 version: link:../../../packages/solid-router @@ -9993,8 +9993,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -10010,7 +10010,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/large-file-based: dependencies: @@ -10022,7 +10022,7 @@ importers: version: link:../../../packages/router-plugin '@tanstack/solid-query': specifier: ^5.90.9 - version: 5.90.9(solid-js@1.9.10) + version: 5.90.9(solid-js@2.0.0-experimental.14) '@tanstack/solid-router': specifier: ^1.161.3 version: link:../../../packages/solid-router @@ -10033,8 +10033,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -10050,7 +10050,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/location-masking: dependencies: @@ -10059,7 +10059,7 @@ importers: version: 4.1.18(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) '@tanstack/solid-query': specifier: ^5.90.9 - version: 5.90.9(solid-js@1.9.10) + version: 5.90.9(solid-js@2.0.0-experimental.14) '@tanstack/solid-router': specifier: ^1.161.3 version: link:../../../packages/solid-router @@ -10070,8 +10070,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -10084,7 +10084,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/navigation-blocking: dependencies: @@ -10093,7 +10093,7 @@ importers: version: 4.1.18(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) '@tanstack/solid-query': specifier: ^5.90.9 - version: 5.90.9(solid-js@1.9.10) + version: 5.90.9(solid-js@2.0.0-experimental.14) '@tanstack/solid-router': specifier: ^1.161.3 version: link:../../../packages/solid-router @@ -10104,8 +10104,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -10118,7 +10118,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/quickstart: dependencies: @@ -10132,8 +10132,8 @@ importers: specifier: workspace:^ version: link:../../../packages/solid-router-devtools solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -10146,7 +10146,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/quickstart-esbuild-file-based: dependencies: @@ -10163,8 +10163,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -10177,7 +10177,7 @@ importers: version: 0.25.10 esbuild-plugin-solid: specifier: ^0.6.0 - version: 0.6.0(esbuild@0.25.10)(solid-js@1.9.10) + version: 0.6.0(esbuild@0.25.10)(solid-js@2.0.0-experimental.14) examples/solid/quickstart-file-based: dependencies: @@ -10194,8 +10194,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -10214,7 +10214,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/quickstart-rspack-file-based: dependencies: @@ -10231,8 +10231,8 @@ importers: specifier: ^8.5.1 version: 8.5.6 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -10245,7 +10245,7 @@ importers: version: 1.0.6(@rsbuild/core@1.2.4) '@rsbuild/plugin-solid': specifier: ^1.0.6 - version: 1.0.6(@babel/core@7.28.5)(@rsbuild/core@1.2.4)(solid-js@1.9.10) + version: 1.0.6(@babel/core@7.28.5)(@rsbuild/core@1.2.4)(solid-js@2.0.0-experimental.14) '@tanstack/router-plugin': specifier: workspace:* version: link:../../../packages/router-plugin @@ -10262,8 +10262,8 @@ importers: specifier: workspace:^ version: link:../../../packages/solid-router-devtools solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -10282,7 +10282,7 @@ importers: version: 10.0.0(@babel/core@7.28.5)(webpack@5.97.1) babel-preset-solid: specifier: ^1.9.10 - version: 1.9.10(@babel/core@7.28.5)(solid-js@1.9.10) + version: 1.9.10(@babel/core@7.28.5)(solid-js@2.0.0-experimental.14) css-loader: specifier: ^7.1.2 version: 7.1.2(@rspack/core@1.2.2(@swc/helpers@0.5.15))(webpack@5.97.1) @@ -10326,8 +10326,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 devDependencies: '@types/node': specifier: 25.0.9 @@ -10343,7 +10343,7 @@ importers: version: 4.0.3(@types/node@25.0.9)(rollup@4.55.3)(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/router-monorepo-simple-lazy: dependencies: @@ -10360,8 +10360,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 devDependencies: '@types/node': specifier: 25.0.9 @@ -10377,7 +10377,7 @@ importers: version: 4.0.3(@types/node@25.0.9)(rollup@4.55.3)(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/router-monorepo-solid-query: dependencies: @@ -10386,10 +10386,10 @@ importers: version: link:../../../packages/router-plugin '@tanstack/solid-query': specifier: ^5.90.9 - version: 5.90.9(solid-js@1.9.10) + version: 5.90.9(solid-js@2.0.0-experimental.14) '@tanstack/solid-query-devtools': specifier: ^5.90.0 - version: 5.90.4(@tanstack/solid-query@5.90.9(solid-js@1.9.10))(solid-js@1.9.10) + version: 5.90.4(@tanstack/solid-query@5.90.9(solid-js@2.0.0-experimental.14))(solid-js@2.0.0-experimental.14) '@tanstack/solid-router': specifier: ^1.161.3 version: link:../../../packages/solid-router @@ -10400,8 +10400,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 devDependencies: '@types/node': specifier: 25.0.9 @@ -10417,7 +10417,7 @@ importers: version: 4.0.3(@types/node@25.0.9)(rollup@4.55.3)(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/scroll-restoration: dependencies: @@ -10432,10 +10432,10 @@ importers: version: link:../../../packages/solid-router-devtools '@tanstack/solid-virtual': specifier: ^3.13.0 - version: 3.13.12(solid-js@1.9.10) + version: 3.13.12(solid-js@2.0.0-experimental.14) solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -10448,7 +10448,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/search-validator-adapters: dependencies: @@ -10463,7 +10463,7 @@ importers: version: link:../../../packages/router-plugin '@tanstack/solid-query': specifier: ^5.90.9 - version: 5.90.9(solid-js@1.9.10) + version: 5.90.9(solid-js@2.0.0-experimental.14) '@tanstack/solid-router': specifier: ^1.161.3 version: link:../../../packages/solid-router @@ -10480,8 +10480,8 @@ importers: specifier: ^2.1.7 version: 2.1.7 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -10494,7 +10494,7 @@ importers: devDependencies: '@solidjs/testing-library': specifier: ^0.8.10 - version: 0.8.10(solid-js@1.9.10) + version: 0.8.10(solid-js@2.0.0-experimental.14) '@testing-library/jest-dom': specifier: ^6.6.3 version: 6.6.3 @@ -10506,7 +10506,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/start-basic: dependencies: @@ -10523,8 +10523,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwind-merge: specifier: ^2.6.0 version: 2.6.0 @@ -10549,7 +10549,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.8.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -10578,8 +10578,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwind-merge: specifier: ^2.6.0 version: 2.6.0 @@ -10607,7 +10607,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -10627,8 +10627,8 @@ importers: specifier: workspace:* version: link:../../../packages/solid-start solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 start-authjs: specifier: ^1.0.0 version: 1.0.0(@auth/core@0.41.1) @@ -10653,7 +10653,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -10670,8 +10670,8 @@ importers: specifier: workspace:* version: link:../../../packages/solid-start solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 devDependencies: '@cloudflare/vite-plugin': specifier: ^1.13.7 @@ -10693,7 +10693,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -10713,8 +10713,8 @@ importers: specifier: workspace:* version: link:../../../packages/solid-start solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 devDependencies: '@netlify/vite-plugin-tanstack-start': specifier: ^1.1.4 @@ -10736,7 +10736,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -10753,8 +10753,8 @@ importers: specifier: workspace:* version: link:../../../packages/solid-start solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 devDependencies: '@tailwindcss/vite': specifier: ^4.1.18 @@ -10776,7 +10776,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -10785,10 +10785,10 @@ importers: dependencies: '@tanstack/solid-query': specifier: ^5.90.9 - version: 5.90.9(solid-js@1.9.10) + version: 5.90.9(solid-js@2.0.0-experimental.14) '@tanstack/solid-query-devtools': specifier: ^5.90.0 - version: 5.90.4(@tanstack/solid-query@5.90.9(solid-js@1.9.10))(solid-js@1.9.10) + version: 5.90.4(@tanstack/solid-query@5.90.9(solid-js@2.0.0-experimental.14))(solid-js@2.0.0-experimental.14) '@tanstack/solid-router': specifier: ^1.161.3 version: link:../../../packages/solid-router @@ -10805,8 +10805,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwind-merge: specifier: ^2.6.0 version: 2.6.0 @@ -10828,7 +10828,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -10851,8 +10851,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwind-merge: specifier: ^2.6.0 version: 2.6.0 @@ -10874,7 +10874,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.3 version: 5.1.4(typescript@5.8.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -10889,7 +10889,7 @@ importers: version: link:../../../packages/router-plugin '@tanstack/solid-devtools': specifier: ^0.7.0 - version: 0.7.14(csstype@3.2.3)(solid-js@1.9.10) + version: 0.7.14(csstype@3.2.3)(solid-js@2.0.0-experimental.14) '@tanstack/solid-router': specifier: ^1.161.3 version: link:../../../packages/solid-router @@ -10903,8 +10903,8 @@ importers: specifier: workspace:* version: link:../../../packages/solid-start solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -10914,7 +10914,7 @@ importers: devDependencies: '@solidjs/testing-library': specifier: ^0.8.10 - version: 0.8.10(solid-js@1.9.10) + version: 0.8.10(solid-js@2.0.0-experimental.14) '@tanstack/eslint-config': specifier: ^0.3.2 version: 0.3.2(@typescript-eslint/utils@8.44.1(eslint@9.22.0(jiti@2.6.1))(typescript@5.9.2))(eslint-import-resolver-node@0.3.9)(eslint@9.22.0(jiti@2.6.1))(typescript@5.9.2) @@ -10941,7 +10941,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vitest: specifier: ^3.2.4 version: 3.2.4(@types/node@25.0.9)(@vitest/browser@4.0.17(msw@2.7.0(@types/node@25.0.9)(typescript@5.9.3))(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1))(vitest@4.0.17))(@vitest/ui@4.0.17)(jiti@2.6.1)(jsdom@27.0.0(postcss@8.5.6))(lightningcss@1.30.2)(msw@2.7.0(@types/node@25.0.9)(typescript@5.9.2))(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) @@ -10953,7 +10953,7 @@ importers: dependencies: '@convex-dev/better-auth': specifier: ^0.9.7 - version: 0.9.7(@standard-schema/spec@1.0.0)(better-auth@1.3.27(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(solid-js@1.9.10))(convex@1.28.2(@clerk/clerk-react@5.59.3(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(react@19.2.3))(hono@4.7.10)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.2) + version: 0.9.7(@standard-schema/spec@1.0.0)(better-auth@1.3.27(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(solid-js@2.0.0-experimental.14))(convex@1.28.2(@clerk/clerk-react@5.59.3(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(react@19.2.3))(hono@4.7.10)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.2) '@tailwindcss/vite': specifier: ^4.1.18 version: 4.1.18(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -10968,7 +10968,7 @@ importers: version: link:../../../packages/solid-start better-auth: specifier: ^1.3.27 - version: 1.3.27(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(solid-js@1.9.10) + version: 1.3.27(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(solid-js@2.0.0-experimental.14) clsx: specifier: ^2.1.1 version: 2.1.1 @@ -10977,13 +10977,13 @@ importers: version: 1.28.2(@clerk/clerk-react@5.59.3(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(react@19.2.3) convex-solidjs: specifier: ^0.0.3 - version: 0.0.3(@clerk/clerk-react@5.59.3(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(react@19.2.3)(solid-js@1.9.10) + version: 0.0.3(@clerk/clerk-react@5.59.3(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(react@19.2.3)(solid-js@2.0.0-experimental.14) redaxios: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwind-merge: specifier: ^2.6.0 version: 2.6.0 @@ -11008,7 +11008,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -11028,8 +11028,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwind-merge: specifier: ^2.6.0 version: 2.6.0 @@ -11051,7 +11051,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -11060,7 +11060,7 @@ importers: dependencies: '@tanstack/solid-devtools': specifier: ^0.7.0 - version: 0.7.14(csstype@3.2.3)(solid-js@1.9.10) + version: 0.7.14(csstype@3.2.3)(solid-js@2.0.0-experimental.14) '@tanstack/solid-router': specifier: ^1.161.3 version: link:../../../packages/solid-router @@ -11071,8 +11071,8 @@ importers: specifier: workspace:* version: link:../../../packages/solid-start solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 devDependencies: '@inlang/paraglide-js': specifier: ^2.4.0 @@ -11094,7 +11094,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -11103,7 +11103,7 @@ importers: dependencies: '@tanstack/solid-query': specifier: ^5.90.9 - version: 5.90.9(solid-js@1.9.10) + version: 5.90.9(solid-js@2.0.0-experimental.14) '@tanstack/solid-router': specifier: ^1.161.3 version: link:../../../packages/solid-router @@ -11117,8 +11117,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwind-merge: specifier: ^2.6.0 version: 2.6.0 @@ -11143,7 +11143,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -11160,8 +11160,8 @@ importers: specifier: workspace:* version: link:../../../packages/solid-start solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 zod: specifier: ^3.24.2 version: 3.25.57 @@ -11177,7 +11177,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -11203,8 +11203,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 devDependencies: '@tailwindcss/vite': specifier: ^4.1.18 @@ -11223,7 +11223,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -11240,8 +11240,8 @@ importers: specifier: workspace:* version: link:../../../packages/solid-start solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwind-merge: specifier: ^2.6.0 version: 2.6.0 @@ -11266,7 +11266,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -11289,8 +11289,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -11306,7 +11306,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/with-framer-motion: dependencies: @@ -11323,11 +11323,11 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 solid-motionone: specifier: ^1.0.4 - version: 1.0.4(solid-js@1.9.10) + version: 1.0.4(solid-js@2.0.0-experimental.14) tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -11343,7 +11343,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/with-trpc: dependencies: @@ -11372,8 +11372,8 @@ importers: specifier: ^0.5.1 version: 0.5.1 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tailwindcss: specifier: ^4.1.18 version: 4.1.18 @@ -11392,7 +11392,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/vue/basic: dependencies: @@ -11905,14 +11905,14 @@ importers: version: 1.3.3 devDependencies: solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 vite: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) packages/router-generator: dependencies: @@ -11997,7 +11997,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) webpack: specifier: '>=5.92.0' version: 5.97.1(webpack-cli@5.1.4) @@ -12084,13 +12084,13 @@ importers: dependencies: '@solid-devtools/logger': specifier: ^0.9.4 - version: 0.9.7(solid-js@1.9.10) + version: 0.9.7(solid-js@2.0.0-experimental.14) '@solid-primitives/refs': specifier: ^1.0.8 - version: 1.1.0(solid-js@1.9.10) + version: 1.1.0(solid-js@2.0.0-experimental.14) '@solidjs/meta': specifier: ^0.29.4 - version: 0.29.4(solid-js@1.9.10) + version: 0.29.4(solid-js@2.0.0-experimental.14) '@tanstack/history': specifier: workspace:* version: link:../history @@ -12099,7 +12099,7 @@ importers: version: link:../router-core '@tanstack/solid-store': specifier: ^0.9.1 - version: 0.9.1(solid-js@1.9.10) + version: 0.9.1(solid-js@2.0.0-experimental.14) isbot: specifier: ^5.1.22 version: 5.1.28 @@ -12112,7 +12112,7 @@ importers: devDependencies: '@solidjs/testing-library': specifier: ^0.8.10 - version: 0.8.10(solid-js@1.9.10) + version: 0.8.10(solid-js@2.0.0-experimental.14) '@testing-library/jest-dom': specifier: ^6.6.3 version: 6.6.3 @@ -12123,14 +12123,14 @@ importers: specifier: ^0.14.5 version: 0.14.5(eslint@9.22.0(jiti@2.6.1))(typescript@5.9.3) solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 vite: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) zod: specifier: ^3.23.8 version: 3.25.57 @@ -12148,14 +12148,14 @@ importers: version: link:../solid-router devDependencies: solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 vite: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) packages/solid-router-ssr-query: dependencies: @@ -12168,7 +12168,7 @@ importers: devDependencies: '@tanstack/solid-query': specifier: '>=5.90.0' - version: 5.90.9(solid-js@1.9.10) + version: 5.90.9(solid-js@2.0.0-experimental.14) '@tanstack/solid-router': specifier: workspace:* version: link:../solid-router @@ -12176,14 +12176,14 @@ importers: specifier: ^0.14.5 version: 0.14.5(eslint@9.22.0(jiti@2.6.1))(typescript@5.9.3) solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 vite: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) packages/solid-start: dependencies: @@ -12209,8 +12209,8 @@ importers: specifier: ^2.0.3 version: 2.0.3 solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 devDependencies: '@tanstack/router-utils': specifier: workspace:* @@ -12231,8 +12231,8 @@ importers: specifier: workspace:* version: link:../start-client-core solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 tiny-invariant: specifier: ^1.3.3 version: 1.3.3 @@ -12242,7 +12242,7 @@ importers: devDependencies: '@solidjs/testing-library': specifier: ^0.8.10 - version: 0.8.10(solid-js@1.9.10) + version: 0.8.10(solid-js@2.0.0-experimental.14) '@testing-library/jest-dom': specifier: ^6.6.3 version: 6.6.3 @@ -12251,13 +12251,13 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) packages/solid-start-server: dependencies: '@solidjs/meta': specifier: ^0.29.4 - version: 0.29.4(solid-js@1.9.10) + version: 0.29.4(solid-js@2.0.0-experimental.14) '@tanstack/history': specifier: workspace:* version: link:../history @@ -12275,8 +12275,8 @@ importers: version: link:../start-server-core devDependencies: solid-js: - specifier: 1.9.10 - version: 1.9.10 + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14 typescript: specifier: ^5.7.2 version: 5.8.2 @@ -12285,7 +12285,7 @@ importers: version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) packages/start-client-core: dependencies: @@ -17098,7 +17098,7 @@ packages: peerDependencies: '@solidjs/router': ^0.13.4 || ^0.14.0 || ^0.15.0 '@tanstack/solid-router': ^1.132.27 - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 peerDependenciesMeta: '@solidjs/router': optional: true @@ -17180,144 +17180,147 @@ packages: '@solid-devtools/debugger@0.26.0': resolution: {integrity: sha512-36QxZ+s/lY60E+Pb9q0eTsdqgaog4c823WIj5dC2LFdGrGXbVGBQEj6k7CgvMnEETdwndrd0Fm72fQyYPlZrVA==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-devtools/logger@0.9.7': resolution: {integrity: sha512-JHZ0ejkQnRoMcV8bgqogSYFlYdo0wJ1S/vAHEROSHQk1jNtErTXJwLrCXdR+LNuBWhJJ0aq/y7Pjit/ssvKrDw==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-devtools/shared@0.19.0': resolution: {integrity: sha512-OGo6l84f9X5YEAqSEM4Xl94+xKXSqmACMzKWsAqO0BStLBMVL0vIVu286AQk5XkNxn11/EB9wrdkZc9GUzKlxA==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-primitives/bounds@0.0.122': resolution: {integrity: sha512-kUq/IprOdFr/rg2upon5lQGOoTnDAmxQS4ASKK2l+VwoKSctdPwgu/4qJxEITZikL+nB0myYZzBZWptySV0cRg==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-primitives/context@0.3.2': resolution: {integrity: sha512-6fvTtpK17PFHnUf/UOc1TzBjd+kLFjtA62aRFEm1kDP9ufTo7FYW2kUzQAWbfbRHi30yjBJtopbR8qd6nShwyg==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-primitives/cursor@0.0.115': resolution: {integrity: sha512-8nEmUN/sacXPChwuJOAi6Yi6VnxthW/Jk8VGvvcF38AenjUvOA6FHI6AkJILuFXjQw1PGxia1YbH/Mn77dPiOA==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-primitives/event-listener@2.4.0': resolution: {integrity: sha512-TSfR1PNTfojFEYGSxSMCnUhXsaYWBo4p+cm73QmWODa9YnaQAk6PB7VjzG2bOT2D817VlvuOqTj0Qdq+MZrdGg==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-primitives/event-listener@2.4.3': resolution: {integrity: sha512-h4VqkYFv6Gf+L7SQj+Y6puigL/5DIi7x5q07VZET7AWcS+9/G3WfIE9WheniHWJs51OEkRB43w6lDys5YeFceg==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-primitives/keyboard@1.3.0': resolution: {integrity: sha512-0QX9O3eUaQorNNmXZn8a4efSByayIScVq+iGSwheD7m3SL/ACLM5oZlCNpTPLcemnVVfUPAHFiViEj86XpN5qw==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-primitives/keyboard@1.3.3': resolution: {integrity: sha512-9dQHTTgLBqyAI7aavtO+HnpTVJgWQA1ghBSrmLtMu1SMxLPDuLfuNr+Tk5udb4AL4Ojg7h9JrKOGEEDqsJXWJA==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-primitives/media@2.3.0': resolution: {integrity: sha512-7+C3wfbWnGE/WPoNsqcp/EeOP2aNNB92RCpsWhBth8E5lZo/J+rK6jMb7umVsK0zguT8HBpeXp1pFyFbcsHStA==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-primitives/platform@0.1.2': resolution: {integrity: sha512-sSxcZfuUrtxcwV0vdjmGnZQcflACzMfLriVeIIWXKp8hzaS3Or3tO6EFQkTd3L8T5dTq+kTtLvPscXIpL0Wzdg==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-primitives/props@3.2.2': resolution: {integrity: sha512-lZOTwFJajBrshSyg14nBMEP0h8MXzPowGO0s3OeiR3z6nXHTfj0FhzDtJMv+VYoRJKQHG2QRnJTgCzK6erARAw==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-primitives/refs@1.1.0': resolution: {integrity: sha512-QJ3bTSQOlPdHBP2m6llrT13FvVzAwZfx41lTN8lQrRwwcZoWb7kfCAjhaohPnwkAsQ6nJpLjtGfT5GOyuCA4tA==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-primitives/resize-observer@2.1.0': resolution: {integrity: sha512-tO9MDAc2pNjpcRd5B8LWbiR1qzIgvGZ5BtTuO98N7CLwd+fnuyGwtlQtJpz5hcLcTnoawpQYLpiRGNgaYW+YzQ==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-primitives/resize-observer@2.1.3': resolution: {integrity: sha512-zBLje5E06TgOg93S7rGPldmhDnouNGhvfZVKOp+oG2XU8snA+GoCSSCz1M+jpNAg5Ek2EakU5UVQqL152WmdXQ==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-primitives/rootless@1.5.0': resolution: {integrity: sha512-YJ+EveQeDv9DLqfDKfsPAAGy2x3vBruoD23yn+nD2dT84QjoBxWT1T0qA0TMFjek6/xuN3flqnHtQ4r++4zdjg==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-primitives/rootless@1.5.2': resolution: {integrity: sha512-9HULb0QAzL2r47CCad0M+NKFtQ+LrGGNHZfteX/ThdGvKIg2o2GYhBooZubTCd/RTu2l2+Nw4s+dEfiDGvdrrQ==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-primitives/scheduled@1.5.0': resolution: {integrity: sha512-RVw24IRNh1FQ4DCMb3OahB70tXIwc5vH8nhR4nNPsXwUPQeuOkLsDI5BlxaPk0vyZgqw9lDpufgI3HnPwplgDw==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-primitives/static-store@0.0.8': resolution: {integrity: sha512-ZecE4BqY0oBk0YG00nzaAWO5Mjcny8Fc06CdbXadH9T9lzq/9GefqcSe/5AtdXqjvY/DtJ5C6CkcjPZO0o/eqg==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-primitives/static-store@0.1.0': resolution: {integrity: sha512-6Coau0Kv/dF83UQpbBzc+gnJafOQAPe2jCbB4jmTK5UocsR5cWmFBVRm3kin+nZFVaO4WkuELw0cKANWgTVh8Q==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-primitives/static-store@0.1.2': resolution: {integrity: sha512-ReK+5O38lJ7fT+L6mUFvUr6igFwHBESZF+2Ug842s7fvlVeBdIVEdTCErygff6w7uR6+jrr7J8jQo+cYrEq4Iw==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-primitives/styles@0.0.114': resolution: {integrity: sha512-SFXr16mgr6LvZAIj6L7i59HHg+prAmIF8VP/U3C6jSHz68Eh1G71vaWr9vlJVpy/j6bh1N8QUzu5CgtvIC92OQ==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-primitives/transition-group@1.1.2': resolution: {integrity: sha512-gnHS0OmcdjeoHN9n7Khu8KNrOlRc8a2weETDt2YT6o1zeW/XtUC6Db3Q9pkMU/9cCKdEmN4b0a/41MKAHRhzWA==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-primitives/utils@6.3.0': resolution: {integrity: sha512-e7hTlJ1Ywh2+g/Qug+n4L1mpfxsikoIS4/sHE2EK9WatQt8UJqop/vE6bsLnXlU1xuhb/jo94Ah5Y27rd4wP7A==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solid-primitives/utils@6.3.2': resolution: {integrity: sha512-hZ/M/qr25QOCcwDPOHtGjxTD8w2mNyVAYvcfgwzBHq2RwNqHNdDNsMZYap20+ruRwW4A3Cdkczyoz0TSxLCAPQ==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@solidjs/meta@0.29.4': resolution: {integrity: sha512-zdIWBGpR9zGx1p1bzIPqF5Gs+Ks/BH8R6fWhmUa/dcK1L2rUC8BAcZJzNRYBQv74kScf1TSOs0EY//Vd/I0V8g==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 + + '@solidjs/signals@0.10.4': + resolution: {integrity: sha512-6l4xfgrzA541TXtHd4Pr2S65rMSUE6J7htg7/5CHR1LE39mLirg4I53PU4xPD+0jztg33idAIPbkwa3CJ83Beg==} '@solidjs/testing-library@0.8.10': resolution: {integrity: sha512-qdeuIerwyq7oQTIrrKvV0aL9aFeuwTd86VYD3afdq5HYEwoox1OBTJy4y8A3TFZr8oAR0nujYgCzY/8wgHGfeQ==} engines: {node: '>= 14'} peerDependencies: '@solidjs/router': '>=0.9.0' - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 peerDependenciesMeta: '@solidjs/router': optional: true @@ -17566,25 +17569,25 @@ packages: resolution: {integrity: sha512-DU8OfLntngnph+Tb7ivQvh4F4w+rDu6r01fXlhjq/Nmgdr0gtsOox4kdmyq5rCs+C6aPgP3M7+BE+fv4dN+VvA==} engines: {node: '>=18'} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@tanstack/devtools-ui@0.4.4': resolution: {integrity: sha512-5xHXFyX3nom0UaNfiOM92o6ziaHjGo3mcSGe2HD5Xs8dWRZNpdZ0Smd0B9ddEhy0oB+gXyMzZgUJb9DmrZV0Mg==} engines: {node: '>=18'} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@tanstack/devtools@0.6.14': resolution: {integrity: sha512-dOtHoeLjjcHeNscu+ZEf89EFboQsy0ggb6pf8Sha59qBUeQbjUsaAvwP8Ogwg89oJxFQbTP7DKYNBNw5CxlNEA==} engines: {node: '>=18'} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@tanstack/devtools@0.8.1': resolution: {integrity: sha512-ZyKX+IJvMaTY0TywdA6r6kbD6V+0dxWQVDGC3jd2q4RP9OMHzpXd0cKreDvqOGrAPtEUXpGBxW0AtsaauDWurQ==} engines: {node: '>=18'} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@tanstack/eslint-config@0.3.2': resolution: {integrity: sha512-2g+PuGR3GuvvCiR3xZs+IMqAvnYU9bvH+jRml0BFBSxHBj22xFCTNvJWhvgj7uICFF9IchDkFUto91xDPMu5cg==} @@ -17652,28 +17655,28 @@ packages: resolution: {integrity: sha512-hyaB29d1fU2n9v2XeFEB6t2k5gKionK8mxxb9MNtF7qJheZ6z9259jU8OsBdA/f6v2oYck1K1Ia9+ooJsdy4jg==} engines: {node: '>=18'} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@tanstack/solid-query-devtools@5.90.4': resolution: {integrity: sha512-ygyAiXZ+NR1tw33jVibpjiWB1IoAQWCeqSLmO/6PoSWrI9yDTwaPNAXheniEMrO6/a/vTQq2tB4N+FPNjhGaNw==} peerDependencies: '@tanstack/solid-query': ^5.90.4 - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@tanstack/solid-query@5.90.9': resolution: {integrity: sha512-OF+FpTHPmZxF5M0zcEERtUA0DhuFdNOpn0EAbASarDfIuNrvi8k07dhYV5zYyYwkt+eoe/RnAX65PdSP+Y0ONw==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@tanstack/solid-store@0.9.1': resolution: {integrity: sha512-gx7ToM+Yrkui36NIj0HjAufzv1Dg8usjtVFy5H3Ll52Xjuz+eliIJL+ihAr4LRuWh3nDPBR+nCLW0ShFrbE5yw==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@tanstack/solid-virtual@3.13.12': resolution: {integrity: sha512-0dS8GkBTmbuM9cUR6Jni0a45eJbd32CAEbZj8HrZMWIj3lu974NpGz5ywcomOGJ9GdeHuDaRzlwtonBbKV1ihQ==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@tanstack/store@0.9.1': resolution: {integrity: sha512-+qcNkOy0N1qSGsP7omVCW0SDrXtaDcycPqBDE726yryiA5eTDFpjBReaYjghVJwNf1pcPMyzIwTGlYjCSQR0Fg==} @@ -18876,7 +18879,7 @@ packages: resolution: {integrity: sha512-HCelrgua/Y+kqO8RyL04JBWS/cVdrtUv/h45GntgQY+cJl4eBcKkCDV3TdMjtKx1nXwRaR9QXslM/Npm1dxdZQ==} peerDependencies: '@babel/core': ^7.0.0 - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 peerDependenciesMeta: solid-js: optional: true @@ -19388,7 +19391,7 @@ packages: resolution: {integrity: sha512-DCKgtE1rzLUe2x3M7CzjFnN8q4e2ig7d/eudMkjyQOWzMyj19v52AL3JxKH1zpCxGFszQANygQvAltr9R99bfw==} engines: {node: '>=18', pnpm: '>=9.0.0'} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 convex@1.19.0: resolution: {integrity: sha512-TcglkEi392oK0Ah+zDoetFCRFXBM/lvCewi6AWfIgVCtVc9I/xdimdFOLN602V5wp7H4PN8wotpdIoixwSH7mQ==} @@ -20038,7 +20041,7 @@ packages: resolution: {integrity: sha512-V1FvDALwLDX6K0XNYM9CMRAnMzA0+Ecu55qBUT9q/eAJh1KIDsTMFoOzMSgyHqbOfvrVfO3Mws3z7TW2GVnIZA==} peerDependencies: esbuild: '>=0.20' - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 esbuild-plugin-vue3@0.5.1: resolution: {integrity: sha512-rhTPImJ1Zi7FbVa4xWlu9dJdt+mqWxc9Z+AQd+ArbHHwtyQRe8FvER8gaTw0O6bNsBjAtU5rq0rpZEkP3QaThg==} @@ -23358,26 +23361,26 @@ packages: serialize-javascript@6.0.2: resolution: {integrity: sha512-Saa1xPByTTq2gdeFZYLLo+RFE35NHZkAbqZeWNd3BpzppeVisAqpDjcp8dyf6uIvEqJRd46jemmyA4iFIeVk8g==} - seroval-plugins@1.3.2: - resolution: {integrity: sha512-0QvCV2lM3aj/U3YozDiVwx9zpH0q8A60CTWIv4Jszj/givcudPb48B+rkU5D51NJ0pTpweGMttHjboPa9/zoIQ==} - engines: {node: '>=10'} - peerDependencies: - seroval: ^1.0 - seroval-plugins@1.4.2: resolution: {integrity: sha512-X7p4MEDTi+60o2sXZ4bnDBhgsUYDSkQEvzYZuJyFqWg9jcoPsHts5nrg5O956py2wyt28lUrBxk0M0/wU8URpA==} engines: {node: '>=10'} peerDependencies: seroval: ^1.0 - seroval@1.3.2: - resolution: {integrity: sha512-RbcPH1n5cfwKrru7v7+zrZvjLurgHhGyso3HTyGtRivGWgYjbOmGuivCQaORNELjNONoK35nj28EoWul9sb1zQ==} + seroval-plugins@1.5.0: + resolution: {integrity: sha512-EAHqADIQondwRZIdeW2I636zgsODzoBDwb3PT/+7TLDWyw1Dy/Xv7iGUIEXXav7usHDE9HVhOU61irI3EnyyHA==} engines: {node: '>=10'} + peerDependencies: + seroval: ^1.0 seroval@1.4.2: resolution: {integrity: sha512-N3HEHRCZYn3cQbsC4B5ldj9j+tHdf4JZoYPlcI4rRYu0Xy4qN8MQf1Z08EibzB0WpgRG5BGK08FTrmM66eSzKQ==} engines: {node: '>=10'} + seroval@1.5.0: + resolution: {integrity: sha512-OE4cvmJ1uSPrKorFIH9/w/Qwuvi/IMcGbv5RKgcJ/zjA/IohDLU6SVaxFN9FwajbP7nsX0dQqMDes1whk3y+yw==} + engines: {node: '>=10'} + serve-index@1.9.1: resolution: {integrity: sha512-pXHfKNP4qujrtteMrSBb0rc8HJ9Ms/GrXwcUtUtD5s4ewDJI8bT3Cz2zTVRMKtri49pLx2e0Ya8ziP5Ya2pZZw==} engines: {node: '>= 0.8.0'} @@ -23499,18 +23502,18 @@ packages: sockjs@0.3.24: resolution: {integrity: sha512-GJgLTZ7vYb/JtPSSZ10hsOYIvEYsjbNU+zPdIHcUaWVNUEPivzxku31865sSSud0Da0W4lEeOPlmw93zLQchuQ==} - solid-js@1.9.10: - resolution: {integrity: sha512-Coz956cos/EPDlhs6+jsdTxKuJDPT7B5SVIWgABwROyxjY7Xbr8wkzD68Et+NxnV7DLJ3nJdAC2r9InuV/4Jew==} + solid-js@2.0.0-experimental.14: + resolution: {integrity: sha512-MrB8xqc6UDWGtWrAsIpdXkxINleVF/WG4W5nIv3wEhbQbcYnPdqaDWBAhNP36jfIIS0xQVlIdGmLYD+FaPS5qg==} solid-motionone@1.0.4: resolution: {integrity: sha512-aqEjgecoO9raDFznu/dEci7ORSmA26Kjj9J4Cn1Gyr0GZuOVdvsNxdxClTL9J40Aq/uYFx4GLwC8n70fMLHiuA==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 solid-refresh@0.6.3: resolution: {integrity: sha512-F3aPsX6hVw9ttm5LYlth8Q15x6MlI/J3Dn+o3EQyRTtTxidepSTwAYdozt01/YA+7ObcciagGEyXIopGZzQtbA==} peerDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 sonic-boom@4.2.0: resolution: {integrity: sha512-INb7TM37/mAcsGmc9hyyI6+QR3rR1zVRu36B0NeGXKnOOLiZOfER5SA+N7X7k3yUYRzLWafduTDvJAfDswwEww==} @@ -24529,7 +24532,7 @@ packages: resolution: {integrity: sha512-Yr1dQybmtDtDAHkii6hXuc1oVH9CPcS/Zb2jN/P36qqcrkNnVPsMTzQ06jyzFPFjj3U1IYKMVt/9ZqcwGCEbjw==} peerDependencies: '@testing-library/jest-dom': ^5.16.6 || ^5.17.0 || ^6.* - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 vite: ^7.3.1 peerDependenciesMeta: '@testing-library/jest-dom': @@ -25661,9 +25664,9 @@ snapshots: '@types/conventional-commits-parser': 5.0.1 chalk: 5.4.1 - '@convex-dev/better-auth@0.9.7(@standard-schema/spec@1.0.0)(better-auth@1.3.27(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(solid-js@1.9.10))(convex@1.28.2(@clerk/clerk-react@5.59.3(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(react@19.2.3))(hono@4.7.10)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.2)': + '@convex-dev/better-auth@0.9.7(@standard-schema/spec@1.0.0)(better-auth@1.3.27(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(solid-js@2.0.0-experimental.14))(convex@1.28.2(@clerk/clerk-react@5.59.3(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(react@19.2.3))(hono@4.7.10)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(typescript@5.9.2)': dependencies: - better-auth: 1.3.27(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(solid-js@1.9.10) + better-auth: 1.3.27(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(solid-js@2.0.0-experimental.14) common-tags: 1.8.2 convex: 1.28.2(@clerk/clerk-react@5.59.3(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(react@19.2.3) convex-helpers: 0.1.104(@standard-schema/spec@1.0.0)(convex@1.28.2(@clerk/clerk-react@5.59.3(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(react@19.2.3))(hono@4.7.10)(react@19.2.3)(typescript@5.9.2)(zod@3.25.57) @@ -27382,7 +27385,7 @@ snapshots: '@emotion/cache': 11.14.0 '@emotion/serialize': 1.3.3 '@emotion/sheet': 1.4.0 - csstype: 3.1.3 + csstype: 3.2.3 prop-types: 15.8.1 react: 19.2.3 optionalDependencies: @@ -29290,12 +29293,12 @@ snapshots: '@rspack/plugin-react-refresh': 1.0.1(react-refresh@0.16.0) react-refresh: 0.16.0 - '@rsbuild/plugin-solid@1.0.6(@babel/core@7.28.5)(@rsbuild/core@1.2.4)(solid-js@1.9.10)': + '@rsbuild/plugin-solid@1.0.6(@babel/core@7.28.5)(@rsbuild/core@1.2.4)(solid-js@2.0.0-experimental.14)': dependencies: '@rsbuild/core': 1.2.4 '@rsbuild/plugin-babel': 1.0.6(@rsbuild/core@1.2.4) - babel-preset-solid: 1.9.10(@babel/core@7.28.5)(solid-js@1.9.10) - solid-refresh: 0.6.3(solid-js@1.9.10) + babel-preset-solid: 1.9.10(@babel/core@7.28.5)(solid-js@2.0.0-experimental.14) + solid-refresh: 0.6.3(solid-js@2.0.0-experimental.14) transitivePeerDependencies: - '@babel/core' - solid-js @@ -29522,11 +29525,11 @@ snapshots: hoist-non-react-statics: 3.3.2 react: 19.2.3 - '@sentry/solid@10.32.0(@tanstack/solid-router@packages+solid-router)(solid-js@1.9.10)': + '@sentry/solid@10.32.0(@tanstack/solid-router@packages+solid-router)(solid-js@2.0.0-experimental.14)': dependencies: '@sentry/browser': 10.32.0 '@sentry/core': 10.32.0 - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 optionalDependencies: '@tanstack/solid-router': link:packages/solid-router @@ -29604,176 +29607,178 @@ snapshots: color: 5.0.2 text-hex: 1.0.0 - '@solid-devtools/debugger@0.26.0(solid-js@1.9.10)': + '@solid-devtools/debugger@0.26.0(solid-js@2.0.0-experimental.14)': dependencies: '@nothing-but/utils': 0.17.0 - '@solid-devtools/shared': 0.19.0(solid-js@1.9.10) - '@solid-primitives/bounds': 0.0.122(solid-js@1.9.10) - '@solid-primitives/cursor': 0.0.115(solid-js@1.9.10) - '@solid-primitives/event-listener': 2.4.0(solid-js@1.9.10) - '@solid-primitives/keyboard': 1.3.0(solid-js@1.9.10) - '@solid-primitives/platform': 0.1.2(solid-js@1.9.10) - '@solid-primitives/rootless': 1.5.0(solid-js@1.9.10) - '@solid-primitives/scheduled': 1.5.0(solid-js@1.9.10) - '@solid-primitives/static-store': 0.0.8(solid-js@1.9.10) - '@solid-primitives/utils': 6.3.0(solid-js@1.9.10) - solid-js: 1.9.10 + '@solid-devtools/shared': 0.19.0(solid-js@2.0.0-experimental.14) + '@solid-primitives/bounds': 0.0.122(solid-js@2.0.0-experimental.14) + '@solid-primitives/cursor': 0.0.115(solid-js@2.0.0-experimental.14) + '@solid-primitives/event-listener': 2.4.0(solid-js@2.0.0-experimental.14) + '@solid-primitives/keyboard': 1.3.0(solid-js@2.0.0-experimental.14) + '@solid-primitives/platform': 0.1.2(solid-js@2.0.0-experimental.14) + '@solid-primitives/rootless': 1.5.0(solid-js@2.0.0-experimental.14) + '@solid-primitives/scheduled': 1.5.0(solid-js@2.0.0-experimental.14) + '@solid-primitives/static-store': 0.0.8(solid-js@2.0.0-experimental.14) + '@solid-primitives/utils': 6.3.0(solid-js@2.0.0-experimental.14) + solid-js: 2.0.0-experimental.14 - '@solid-devtools/logger@0.9.7(solid-js@1.9.10)': + '@solid-devtools/logger@0.9.7(solid-js@2.0.0-experimental.14)': dependencies: '@nothing-but/utils': 0.17.0 - '@solid-devtools/debugger': 0.26.0(solid-js@1.9.10) - '@solid-devtools/shared': 0.19.0(solid-js@1.9.10) - '@solid-primitives/utils': 6.3.0(solid-js@1.9.10) - solid-js: 1.9.10 + '@solid-devtools/debugger': 0.26.0(solid-js@2.0.0-experimental.14) + '@solid-devtools/shared': 0.19.0(solid-js@2.0.0-experimental.14) + '@solid-primitives/utils': 6.3.0(solid-js@2.0.0-experimental.14) + solid-js: 2.0.0-experimental.14 - '@solid-devtools/shared@0.19.0(solid-js@1.9.10)': + '@solid-devtools/shared@0.19.0(solid-js@2.0.0-experimental.14)': dependencies: '@nothing-but/utils': 0.17.0 - '@solid-primitives/event-listener': 2.4.0(solid-js@1.9.10) - '@solid-primitives/media': 2.3.0(solid-js@1.9.10) - '@solid-primitives/refs': 1.1.0(solid-js@1.9.10) - '@solid-primitives/rootless': 1.5.0(solid-js@1.9.10) - '@solid-primitives/scheduled': 1.5.0(solid-js@1.9.10) - '@solid-primitives/static-store': 0.0.8(solid-js@1.9.10) - '@solid-primitives/styles': 0.0.114(solid-js@1.9.10) - '@solid-primitives/utils': 6.3.0(solid-js@1.9.10) - solid-js: 1.9.10 + '@solid-primitives/event-listener': 2.4.0(solid-js@2.0.0-experimental.14) + '@solid-primitives/media': 2.3.0(solid-js@2.0.0-experimental.14) + '@solid-primitives/refs': 1.1.0(solid-js@2.0.0-experimental.14) + '@solid-primitives/rootless': 1.5.0(solid-js@2.0.0-experimental.14) + '@solid-primitives/scheduled': 1.5.0(solid-js@2.0.0-experimental.14) + '@solid-primitives/static-store': 0.0.8(solid-js@2.0.0-experimental.14) + '@solid-primitives/styles': 0.0.114(solid-js@2.0.0-experimental.14) + '@solid-primitives/utils': 6.3.0(solid-js@2.0.0-experimental.14) + solid-js: 2.0.0-experimental.14 - '@solid-primitives/bounds@0.0.122(solid-js@1.9.10)': + '@solid-primitives/bounds@0.0.122(solid-js@2.0.0-experimental.14)': dependencies: - '@solid-primitives/event-listener': 2.4.0(solid-js@1.9.10) - '@solid-primitives/resize-observer': 2.1.0(solid-js@1.9.10) - '@solid-primitives/static-store': 0.0.8(solid-js@1.9.10) - '@solid-primitives/utils': 6.3.0(solid-js@1.9.10) - solid-js: 1.9.10 + '@solid-primitives/event-listener': 2.4.0(solid-js@2.0.0-experimental.14) + '@solid-primitives/resize-observer': 2.1.0(solid-js@2.0.0-experimental.14) + '@solid-primitives/static-store': 0.0.8(solid-js@2.0.0-experimental.14) + '@solid-primitives/utils': 6.3.0(solid-js@2.0.0-experimental.14) + solid-js: 2.0.0-experimental.14 - '@solid-primitives/context@0.3.2(solid-js@1.9.10)': + '@solid-primitives/context@0.3.2(solid-js@2.0.0-experimental.14)': dependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 - '@solid-primitives/cursor@0.0.115(solid-js@1.9.10)': + '@solid-primitives/cursor@0.0.115(solid-js@2.0.0-experimental.14)': dependencies: - '@solid-primitives/utils': 6.3.0(solid-js@1.9.10) - solid-js: 1.9.10 + '@solid-primitives/utils': 6.3.0(solid-js@2.0.0-experimental.14) + solid-js: 2.0.0-experimental.14 - '@solid-primitives/event-listener@2.4.0(solid-js@1.9.10)': + '@solid-primitives/event-listener@2.4.0(solid-js@2.0.0-experimental.14)': dependencies: - '@solid-primitives/utils': 6.3.0(solid-js@1.9.10) - solid-js: 1.9.10 + '@solid-primitives/utils': 6.3.0(solid-js@2.0.0-experimental.14) + solid-js: 2.0.0-experimental.14 - '@solid-primitives/event-listener@2.4.3(solid-js@1.9.10)': + '@solid-primitives/event-listener@2.4.3(solid-js@2.0.0-experimental.14)': dependencies: - '@solid-primitives/utils': 6.3.2(solid-js@1.9.10) - solid-js: 1.9.10 + '@solid-primitives/utils': 6.3.2(solid-js@2.0.0-experimental.14) + solid-js: 2.0.0-experimental.14 - '@solid-primitives/keyboard@1.3.0(solid-js@1.9.10)': + '@solid-primitives/keyboard@1.3.0(solid-js@2.0.0-experimental.14)': dependencies: - '@solid-primitives/event-listener': 2.4.0(solid-js@1.9.10) - '@solid-primitives/rootless': 1.5.0(solid-js@1.9.10) - '@solid-primitives/utils': 6.3.0(solid-js@1.9.10) - solid-js: 1.9.10 + '@solid-primitives/event-listener': 2.4.0(solid-js@2.0.0-experimental.14) + '@solid-primitives/rootless': 1.5.0(solid-js@2.0.0-experimental.14) + '@solid-primitives/utils': 6.3.0(solid-js@2.0.0-experimental.14) + solid-js: 2.0.0-experimental.14 - '@solid-primitives/keyboard@1.3.3(solid-js@1.9.10)': + '@solid-primitives/keyboard@1.3.3(solid-js@2.0.0-experimental.14)': dependencies: - '@solid-primitives/event-listener': 2.4.3(solid-js@1.9.10) - '@solid-primitives/rootless': 1.5.2(solid-js@1.9.10) - '@solid-primitives/utils': 6.3.2(solid-js@1.9.10) - solid-js: 1.9.10 + '@solid-primitives/event-listener': 2.4.3(solid-js@2.0.0-experimental.14) + '@solid-primitives/rootless': 1.5.2(solid-js@2.0.0-experimental.14) + '@solid-primitives/utils': 6.3.2(solid-js@2.0.0-experimental.14) + solid-js: 2.0.0-experimental.14 - '@solid-primitives/media@2.3.0(solid-js@1.9.10)': + '@solid-primitives/media@2.3.0(solid-js@2.0.0-experimental.14)': dependencies: - '@solid-primitives/event-listener': 2.4.0(solid-js@1.9.10) - '@solid-primitives/rootless': 1.5.0(solid-js@1.9.10) - '@solid-primitives/static-store': 0.1.0(solid-js@1.9.10) - '@solid-primitives/utils': 6.3.0(solid-js@1.9.10) - solid-js: 1.9.10 + '@solid-primitives/event-listener': 2.4.0(solid-js@2.0.0-experimental.14) + '@solid-primitives/rootless': 1.5.0(solid-js@2.0.0-experimental.14) + '@solid-primitives/static-store': 0.1.0(solid-js@2.0.0-experimental.14) + '@solid-primitives/utils': 6.3.0(solid-js@2.0.0-experimental.14) + solid-js: 2.0.0-experimental.14 - '@solid-primitives/platform@0.1.2(solid-js@1.9.10)': + '@solid-primitives/platform@0.1.2(solid-js@2.0.0-experimental.14)': dependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 - '@solid-primitives/props@3.2.2(solid-js@1.9.10)': + '@solid-primitives/props@3.2.2(solid-js@2.0.0-experimental.14)': dependencies: - '@solid-primitives/utils': 6.3.2(solid-js@1.9.10) - solid-js: 1.9.10 + '@solid-primitives/utils': 6.3.2(solid-js@2.0.0-experimental.14) + solid-js: 2.0.0-experimental.14 - '@solid-primitives/refs@1.1.0(solid-js@1.9.10)': + '@solid-primitives/refs@1.1.0(solid-js@2.0.0-experimental.14)': dependencies: - '@solid-primitives/utils': 6.3.0(solid-js@1.9.10) - solid-js: 1.9.10 + '@solid-primitives/utils': 6.3.0(solid-js@2.0.0-experimental.14) + solid-js: 2.0.0-experimental.14 - '@solid-primitives/resize-observer@2.1.0(solid-js@1.9.10)': + '@solid-primitives/resize-observer@2.1.0(solid-js@2.0.0-experimental.14)': dependencies: - '@solid-primitives/event-listener': 2.4.0(solid-js@1.9.10) - '@solid-primitives/rootless': 1.5.0(solid-js@1.9.10) - '@solid-primitives/static-store': 0.1.0(solid-js@1.9.10) - '@solid-primitives/utils': 6.3.2(solid-js@1.9.10) - solid-js: 1.9.10 + '@solid-primitives/event-listener': 2.4.0(solid-js@2.0.0-experimental.14) + '@solid-primitives/rootless': 1.5.0(solid-js@2.0.0-experimental.14) + '@solid-primitives/static-store': 0.1.0(solid-js@2.0.0-experimental.14) + '@solid-primitives/utils': 6.3.2(solid-js@2.0.0-experimental.14) + solid-js: 2.0.0-experimental.14 - '@solid-primitives/resize-observer@2.1.3(solid-js@1.9.10)': + '@solid-primitives/resize-observer@2.1.3(solid-js@2.0.0-experimental.14)': dependencies: - '@solid-primitives/event-listener': 2.4.3(solid-js@1.9.10) - '@solid-primitives/rootless': 1.5.2(solid-js@1.9.10) - '@solid-primitives/static-store': 0.1.2(solid-js@1.9.10) - '@solid-primitives/utils': 6.3.2(solid-js@1.9.10) - solid-js: 1.9.10 + '@solid-primitives/event-listener': 2.4.3(solid-js@2.0.0-experimental.14) + '@solid-primitives/rootless': 1.5.2(solid-js@2.0.0-experimental.14) + '@solid-primitives/static-store': 0.1.2(solid-js@2.0.0-experimental.14) + '@solid-primitives/utils': 6.3.2(solid-js@2.0.0-experimental.14) + solid-js: 2.0.0-experimental.14 - '@solid-primitives/rootless@1.5.0(solid-js@1.9.10)': + '@solid-primitives/rootless@1.5.0(solid-js@2.0.0-experimental.14)': dependencies: - '@solid-primitives/utils': 6.3.0(solid-js@1.9.10) - solid-js: 1.9.10 + '@solid-primitives/utils': 6.3.0(solid-js@2.0.0-experimental.14) + solid-js: 2.0.0-experimental.14 - '@solid-primitives/rootless@1.5.2(solid-js@1.9.10)': + '@solid-primitives/rootless@1.5.2(solid-js@2.0.0-experimental.14)': dependencies: - '@solid-primitives/utils': 6.3.2(solid-js@1.9.10) - solid-js: 1.9.10 + '@solid-primitives/utils': 6.3.2(solid-js@2.0.0-experimental.14) + solid-js: 2.0.0-experimental.14 - '@solid-primitives/scheduled@1.5.0(solid-js@1.9.10)': + '@solid-primitives/scheduled@1.5.0(solid-js@2.0.0-experimental.14)': dependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 - '@solid-primitives/static-store@0.0.8(solid-js@1.9.10)': + '@solid-primitives/static-store@0.0.8(solid-js@2.0.0-experimental.14)': dependencies: - '@solid-primitives/utils': 6.3.0(solid-js@1.9.10) - solid-js: 1.9.10 + '@solid-primitives/utils': 6.3.0(solid-js@2.0.0-experimental.14) + solid-js: 2.0.0-experimental.14 - '@solid-primitives/static-store@0.1.0(solid-js@1.9.10)': + '@solid-primitives/static-store@0.1.0(solid-js@2.0.0-experimental.14)': dependencies: - '@solid-primitives/utils': 6.3.2(solid-js@1.9.10) - solid-js: 1.9.10 + '@solid-primitives/utils': 6.3.2(solid-js@2.0.0-experimental.14) + solid-js: 2.0.0-experimental.14 - '@solid-primitives/static-store@0.1.2(solid-js@1.9.10)': + '@solid-primitives/static-store@0.1.2(solid-js@2.0.0-experimental.14)': dependencies: - '@solid-primitives/utils': 6.3.2(solid-js@1.9.10) - solid-js: 1.9.10 + '@solid-primitives/utils': 6.3.2(solid-js@2.0.0-experimental.14) + solid-js: 2.0.0-experimental.14 - '@solid-primitives/styles@0.0.114(solid-js@1.9.10)': + '@solid-primitives/styles@0.0.114(solid-js@2.0.0-experimental.14)': dependencies: - '@solid-primitives/rootless': 1.5.0(solid-js@1.9.10) - '@solid-primitives/utils': 6.3.0(solid-js@1.9.10) - solid-js: 1.9.10 + '@solid-primitives/rootless': 1.5.0(solid-js@2.0.0-experimental.14) + '@solid-primitives/utils': 6.3.0(solid-js@2.0.0-experimental.14) + solid-js: 2.0.0-experimental.14 - '@solid-primitives/transition-group@1.1.2(solid-js@1.9.10)': + '@solid-primitives/transition-group@1.1.2(solid-js@2.0.0-experimental.14)': dependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 - '@solid-primitives/utils@6.3.0(solid-js@1.9.10)': + '@solid-primitives/utils@6.3.0(solid-js@2.0.0-experimental.14)': dependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 - '@solid-primitives/utils@6.3.2(solid-js@1.9.10)': + '@solid-primitives/utils@6.3.2(solid-js@2.0.0-experimental.14)': dependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 - '@solidjs/meta@0.29.4(solid-js@1.9.10)': + '@solidjs/meta@0.29.4(solid-js@2.0.0-experimental.14)': dependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 - '@solidjs/testing-library@0.8.10(solid-js@1.9.10)': + '@solidjs/signals@0.10.4': {} + + '@solidjs/testing-library@0.8.10(solid-js@2.0.0-experimental.14)': dependencies: '@testing-library/dom': 10.4.1 - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@speed-highlight/core@1.2.14': {} @@ -30012,46 +30017,46 @@ snapshots: '@tanstack/devtools-event-client@0.3.4': {} - '@tanstack/devtools-ui@0.3.5(csstype@3.2.3)(solid-js@1.9.10)': + '@tanstack/devtools-ui@0.3.5(csstype@3.2.3)(solid-js@2.0.0-experimental.14)': dependencies: clsx: 2.1.1 goober: 2.1.16(csstype@3.2.3) - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 transitivePeerDependencies: - csstype - '@tanstack/devtools-ui@0.4.4(csstype@3.2.3)(solid-js@1.9.10)': + '@tanstack/devtools-ui@0.4.4(csstype@3.2.3)(solid-js@2.0.0-experimental.14)': dependencies: clsx: 2.1.1 goober: 2.1.16(csstype@3.2.3) - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 transitivePeerDependencies: - csstype - '@tanstack/devtools@0.6.14(csstype@3.2.3)(solid-js@1.9.10)': + '@tanstack/devtools@0.6.14(csstype@3.2.3)(solid-js@2.0.0-experimental.14)': dependencies: - '@solid-primitives/keyboard': 1.3.0(solid-js@1.9.10) + '@solid-primitives/keyboard': 1.3.0(solid-js@2.0.0-experimental.14) '@tanstack/devtools-event-bus': 0.3.2 - '@tanstack/devtools-ui': 0.3.5(csstype@3.2.3)(solid-js@1.9.10) + '@tanstack/devtools-ui': 0.3.5(csstype@3.2.3)(solid-js@2.0.0-experimental.14) clsx: 2.1.1 goober: 2.1.16(csstype@3.2.3) - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 transitivePeerDependencies: - bufferutil - csstype - utf-8-validate - '@tanstack/devtools@0.8.1(csstype@3.2.3)(solid-js@1.9.10)': + '@tanstack/devtools@0.8.1(csstype@3.2.3)(solid-js@2.0.0-experimental.14)': dependencies: - '@solid-primitives/event-listener': 2.4.3(solid-js@1.9.10) - '@solid-primitives/keyboard': 1.3.3(solid-js@1.9.10) - '@solid-primitives/resize-observer': 2.1.3(solid-js@1.9.10) + '@solid-primitives/event-listener': 2.4.3(solid-js@2.0.0-experimental.14) + '@solid-primitives/keyboard': 1.3.3(solid-js@2.0.0-experimental.14) + '@solid-primitives/resize-observer': 2.1.3(solid-js@2.0.0-experimental.14) '@tanstack/devtools-client': 0.0.4 '@tanstack/devtools-event-bus': 0.3.3 - '@tanstack/devtools-ui': 0.4.4(csstype@3.2.3)(solid-js@1.9.10) + '@tanstack/devtools-ui': 0.4.4(csstype@3.2.3)(solid-js@2.0.0-experimental.14) clsx: 2.1.1 goober: 2.1.16(csstype@3.2.3) - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 transitivePeerDependencies: - bufferutil - csstype @@ -30110,9 +30115,9 @@ snapshots: '@tanstack/query-devtools@5.91.1': {} - '@tanstack/react-devtools@0.7.0(@types/react-dom@19.2.3(@types/react@19.2.8))(@types/react@19.2.8)(csstype@3.2.3)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(solid-js@1.9.10)': + '@tanstack/react-devtools@0.7.0(@types/react-dom@19.2.3(@types/react@19.2.8))(@types/react@19.2.8)(csstype@3.2.3)(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(solid-js@2.0.0-experimental.14)': dependencies: - '@tanstack/devtools': 0.6.14(csstype@3.2.3)(solid-js@1.9.10) + '@tanstack/devtools': 0.6.14(csstype@3.2.3)(solid-js@2.0.0-experimental.14) '@types/react': 19.2.8 '@types/react-dom': 19.2.3(@types/react@19.2.8) react: 19.2.3 @@ -30153,35 +30158,35 @@ snapshots: react: 19.2.3 react-dom: 19.2.3(react@19.2.3) - '@tanstack/solid-devtools@0.7.14(csstype@3.2.3)(solid-js@1.9.10)': + '@tanstack/solid-devtools@0.7.14(csstype@3.2.3)(solid-js@2.0.0-experimental.14)': dependencies: - '@tanstack/devtools': 0.8.1(csstype@3.2.3)(solid-js@1.9.10) - solid-js: 1.9.10 + '@tanstack/devtools': 0.8.1(csstype@3.2.3)(solid-js@2.0.0-experimental.14) + solid-js: 2.0.0-experimental.14 transitivePeerDependencies: - bufferutil - csstype - utf-8-validate - '@tanstack/solid-query-devtools@5.90.4(@tanstack/solid-query@5.90.9(solid-js@1.9.10))(solid-js@1.9.10)': + '@tanstack/solid-query-devtools@5.90.4(@tanstack/solid-query@5.90.9(solid-js@2.0.0-experimental.14))(solid-js@2.0.0-experimental.14)': dependencies: '@tanstack/query-devtools': 5.90.1 - '@tanstack/solid-query': 5.90.9(solid-js@1.9.10) - solid-js: 1.9.10 + '@tanstack/solid-query': 5.90.9(solid-js@2.0.0-experimental.14) + solid-js: 2.0.0-experimental.14 - '@tanstack/solid-query@5.90.9(solid-js@1.9.10)': + '@tanstack/solid-query@5.90.9(solid-js@2.0.0-experimental.14)': dependencies: '@tanstack/query-core': 5.90.19 - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 - '@tanstack/solid-store@0.9.1(solid-js@1.9.10)': + '@tanstack/solid-store@0.9.1(solid-js@2.0.0-experimental.14)': dependencies: '@tanstack/store': 0.9.1 - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 - '@tanstack/solid-virtual@3.13.12(solid-js@1.9.10)': + '@tanstack/solid-virtual@3.13.12(solid-js@2.0.0-experimental.14)': dependencies: '@tanstack/virtual-core': 3.13.12 - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 '@tanstack/store@0.9.1': {} @@ -31955,12 +31960,12 @@ snapshots: transitivePeerDependencies: - supports-color - babel-preset-solid@1.9.10(@babel/core@7.28.5)(solid-js@1.9.10): + babel-preset-solid@1.9.10(@babel/core@7.28.5)(solid-js@2.0.0-experimental.14): dependencies: '@babel/core': 7.28.5 babel-plugin-jsx-dom-expressions: 0.40.3(@babel/core@7.28.5) optionalDependencies: - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 balanced-match@1.0.2: {} @@ -31982,7 +31987,7 @@ snapshots: jsonpointer: 5.0.1 leven: 3.1.0 - better-auth@1.3.27(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(solid-js@1.9.10): + better-auth@1.3.27(react-dom@19.2.3(react@19.2.3))(react@19.2.3)(solid-js@2.0.0-experimental.14): dependencies: '@better-auth/core': 1.3.27 '@better-auth/utils': 0.3.0 @@ -32000,7 +32005,7 @@ snapshots: optionalDependencies: react: 19.2.3 react-dom: 19.2.3(react@19.2.3) - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 better-call@1.0.19: dependencies: @@ -32521,11 +32526,11 @@ snapshots: typescript: 5.9.2 zod: 3.25.57 - convex-solidjs@0.0.3(@clerk/clerk-react@5.59.3(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(react@19.2.3)(solid-js@1.9.10): + convex-solidjs@0.0.3(@clerk/clerk-react@5.59.3(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(react@19.2.3)(solid-js@2.0.0-experimental.14): dependencies: - '@solid-primitives/context': 0.3.2(solid-js@1.9.10) + '@solid-primitives/context': 0.3.2(solid-js@2.0.0-experimental.14) convex: 1.28.2(@clerk/clerk-react@5.59.3(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(react@19.2.3) - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 transitivePeerDependencies: - '@auth0/auth0-react' - '@clerk/clerk-react' @@ -32911,7 +32916,7 @@ snapshots: dom-helpers@5.2.1: dependencies: '@babel/runtime': 7.26.7 - csstype: 3.1.3 + csstype: 3.2.3 dom-serializer@1.4.1: dependencies: @@ -33109,23 +33114,23 @@ snapshots: has-tostringtag: 1.0.2 hasown: 2.0.2 - esbuild-plugin-solid@0.6.0(esbuild@0.25.10)(solid-js@1.9.10): + esbuild-plugin-solid@0.6.0(esbuild@0.25.10)(solid-js@2.0.0-experimental.14): dependencies: '@babel/core': 7.28.5 '@babel/preset-typescript': 7.27.1(@babel/core@7.28.5) - babel-preset-solid: 1.9.10(@babel/core@7.28.5)(solid-js@1.9.10) + babel-preset-solid: 1.9.10(@babel/core@7.28.5)(solid-js@2.0.0-experimental.14) esbuild: 0.25.10 - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 transitivePeerDependencies: - supports-color - esbuild-plugin-solid@0.6.0(esbuild@0.25.4)(solid-js@1.9.10): + esbuild-plugin-solid@0.6.0(esbuild@0.25.4)(solid-js@2.0.0-experimental.14): dependencies: '@babel/core': 7.28.5 '@babel/preset-typescript': 7.27.1(@babel/core@7.28.5) - babel-preset-solid: 1.9.10(@babel/core@7.28.5)(solid-js@1.9.10) + babel-preset-solid: 1.9.10(@babel/core@7.28.5)(solid-js@2.0.0-experimental.14) esbuild: 0.25.4 - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 transitivePeerDependencies: - supports-color @@ -37167,18 +37172,18 @@ snapshots: dependencies: randombytes: 2.1.0 - seroval-plugins@1.3.2(seroval@1.3.2): - dependencies: - seroval: 1.3.2 - seroval-plugins@1.4.2(seroval@1.4.2): dependencies: seroval: 1.4.2 - seroval@1.3.2: {} + seroval-plugins@1.5.0(seroval@1.5.0): + dependencies: + seroval: 1.5.0 seroval@1.4.2: {} + seroval@1.5.0: {} + serve-index@1.9.1: dependencies: accepts: 1.3.8 @@ -37383,28 +37388,29 @@ snapshots: uuid: 8.3.2 websocket-driver: 0.7.4 - solid-js@1.9.10: + solid-js@2.0.0-experimental.14: dependencies: - csstype: 3.1.3 - seroval: 1.3.2 - seroval-plugins: 1.3.2(seroval@1.3.2) + '@solidjs/signals': 0.10.4 + csstype: 3.2.3 + seroval: 1.5.0 + seroval-plugins: 1.5.0(seroval@1.5.0) - solid-motionone@1.0.4(solid-js@1.9.10): + solid-motionone@1.0.4(solid-js@2.0.0-experimental.14): dependencies: '@motionone/dom': 10.18.0 '@motionone/utils': 10.18.0 - '@solid-primitives/props': 3.2.2(solid-js@1.9.10) - '@solid-primitives/refs': 1.1.0(solid-js@1.9.10) - '@solid-primitives/transition-group': 1.1.2(solid-js@1.9.10) + '@solid-primitives/props': 3.2.2(solid-js@2.0.0-experimental.14) + '@solid-primitives/refs': 1.1.0(solid-js@2.0.0-experimental.14) + '@solid-primitives/transition-group': 1.1.2(solid-js@2.0.0-experimental.14) csstype: 3.1.3 - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 - solid-refresh@0.6.3(solid-js@1.9.10): + solid-refresh@0.6.3(solid-js@2.0.0-experimental.14): dependencies: '@babel/generator': 7.28.5 '@babel/helper-module-imports': 7.27.1 '@babel/types': 7.28.5 - solid-js: 1.9.10 + solid-js: 2.0.0-experimental.14 transitivePeerDependencies: - supports-color @@ -38351,14 +38357,14 @@ snapshots: dependencies: vite: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) - vite-plugin-solid@2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@1.9.10)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)): + vite-plugin-solid@2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)): dependencies: '@babel/core': 7.28.5 '@types/babel__core': 7.20.5 - babel-preset-solid: 1.9.10(@babel/core@7.28.5)(solid-js@1.9.10) + babel-preset-solid: 1.9.10(@babel/core@7.28.5)(solid-js@2.0.0-experimental.14) merge-anything: 5.1.7 - solid-js: 1.9.10 - solid-refresh: 0.6.3(solid-js@1.9.10) + solid-js: 2.0.0-experimental.14 + solid-refresh: 0.6.3(solid-js@2.0.0-experimental.14) vite: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vitefu: 1.1.1(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) optionalDependencies: From 91f8a59ca1dce7a7c10f0bdec8a71748d3ad8bc7 Mon Sep 17 00:00:00 2001 From: Birk Skyum Date: Sat, 21 Feb 2026 01:53:51 +0100 Subject: [PATCH 002/218] override vite-plugin-solid --- package.json | 1 + pnpm-lock.yaml | 390 +++++++++++++++++++++++++++---------------------- 2 files changed, 215 insertions(+), 176 deletions(-) diff --git a/package.json b/package.json index 6777860fd1..3b91c42ca1 100644 --- a/package.json +++ b/package.json @@ -84,6 +84,7 @@ "@types/react-dom": "$@types/react-dom", "eslint": "$eslint", "vite": "$vite", + "vite-plugin-solid": "https://pkg.pr.new/vite-plugin-solid@215", "@types/node": "$@types/node", "@playwright/test": "$@playwright/test", "@tanstack/react-query": "$@tanstack/react-query", diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index df33cd3238..0d63ba10c2 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -14,6 +14,7 @@ overrides: '@types/react-dom': ^19.2.3 eslint: ^9.22.0 vite: ^7.3.1 + vite-plugin-solid: https://pkg.pr.new/vite-plugin-solid@215 '@types/node': 25.0.9 '@playwright/test': ^1.57.0 '@tanstack/react-query': ^5.90.19 @@ -2631,8 +2632,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/basic: dependencies: @@ -2665,8 +2666,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/basic-esbuild-file-based: dependencies: @@ -2748,8 +2749,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/basic-file-based-code-splitting: dependencies: @@ -2785,8 +2786,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/basic-scroll-restoration: dependencies: @@ -2822,8 +2823,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/basic-solid-query: dependencies: @@ -2862,8 +2863,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/basic-solid-query-file-based: dependencies: @@ -2908,8 +2909,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/basic-virtual-file-based: dependencies: @@ -2951,8 +2952,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/basic-virtual-named-export-config-file-based: dependencies: @@ -2994,8 +2995,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/generator-cli-only: dependencies: @@ -3031,8 +3032,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/js-only-file-based: dependencies: @@ -3068,8 +3069,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/rspack-basic-file-based: dependencies: @@ -3206,8 +3207,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/sentry-integration: dependencies: @@ -3249,8 +3250,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-router/view-transitions: dependencies: @@ -3292,8 +3293,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-start/basic: dependencies: @@ -3359,8 +3360,8 @@ importers: specifier: ^5.7.2 version: 5.8.2 vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.8.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -3426,8 +3427,8 @@ importers: specifier: ^5.7.2 version: 5.9.2 vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -3472,8 +3473,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -3539,8 +3540,8 @@ importers: specifier: ^5.7.2 version: 5.9.2 vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -3576,8 +3577,8 @@ importers: specifier: ^5.7.2 version: 5.8.2 vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.8.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -3613,8 +3614,8 @@ importers: specifier: ^5.7.2 version: 5.9.2 vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-start/css-modules: dependencies: @@ -3650,8 +3651,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -3711,8 +3712,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.8.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -3769,8 +3770,8 @@ importers: specifier: ^5.7.2 version: 5.9.2 vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -3830,8 +3831,8 @@ importers: specifier: ^5.7.2 version: 5.8.2 vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.8.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -3870,8 +3871,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.8.3)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -3919,8 +3920,8 @@ importers: specifier: ^5.7.2 version: 5.9.2 vite-plugin-solid: - specifier: ^2.11.9 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) e2e/solid-start/server-functions: dependencies: @@ -3986,8 +3987,8 @@ importers: specifier: ^5.7.2 version: 5.8.2 vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.8.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -4056,8 +4057,8 @@ importers: specifier: ^5.7.2 version: 5.8.3 vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.8.3)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -4096,8 +4097,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.8.3)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -4157,8 +4158,8 @@ importers: specifier: ^5.7.2 version: 5.9.2 vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -4212,8 +4213,8 @@ importers: specifier: ^5.7.2 version: 5.8.2 vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.8.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -9298,8 +9299,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/authenticated-routes-firebase: dependencies: @@ -9341,8 +9342,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/basic: dependencies: @@ -9378,8 +9379,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/basic-default-search-params: dependencies: @@ -9415,8 +9416,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/basic-devtools-panel: dependencies: @@ -9446,8 +9447,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/basic-file-based: dependencies: @@ -9483,8 +9484,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/basic-non-nested-devtools: dependencies: @@ -9520,8 +9521,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/basic-solid-query: dependencies: @@ -9560,8 +9561,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/basic-solid-query-file-based: dependencies: @@ -9603,8 +9604,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/basic-ssr-file-based: dependencies: @@ -9643,8 +9644,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/basic-ssr-streaming-file-based: dependencies: @@ -9695,8 +9696,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/basic-virtual-file-based: dependencies: @@ -9735,8 +9736,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/basic-virtual-inside-file-based: dependencies: @@ -9775,8 +9776,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/deferred-data: dependencies: @@ -9809,8 +9810,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/i18n-paraglide: dependencies: @@ -9843,8 +9844,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/kitchen-sink: dependencies: @@ -9880,8 +9881,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/kitchen-sink-file-based: dependencies: @@ -9920,8 +9921,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/kitchen-sink-solid-query: dependencies: @@ -9963,8 +9964,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/kitchen-sink-solid-query-file-based: dependencies: @@ -10009,8 +10010,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/large-file-based: dependencies: @@ -10049,8 +10050,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/location-masking: dependencies: @@ -10083,8 +10084,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/navigation-blocking: dependencies: @@ -10117,8 +10118,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/quickstart: dependencies: @@ -10145,8 +10146,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/quickstart-esbuild-file-based: dependencies: @@ -10213,8 +10214,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/quickstart-rspack-file-based: dependencies: @@ -10342,8 +10343,8 @@ importers: specifier: 4.0.3 version: 4.0.3(@types/node@25.0.9)(rollup@4.55.3)(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/router-monorepo-simple-lazy: dependencies: @@ -10376,8 +10377,8 @@ importers: specifier: 4.0.3 version: 4.0.3(@types/node@25.0.9)(rollup@4.55.3)(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/router-monorepo-solid-query: dependencies: @@ -10416,8 +10417,8 @@ importers: specifier: 4.0.3 version: 4.0.3(@types/node@25.0.9)(rollup@4.55.3)(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/scroll-restoration: dependencies: @@ -10447,8 +10448,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/search-validator-adapters: dependencies: @@ -10505,8 +10506,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/start-basic: dependencies: @@ -10548,8 +10549,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.8.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -10606,8 +10607,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -10652,8 +10653,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -10692,8 +10693,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -10735,8 +10736,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -10775,8 +10776,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -10827,8 +10828,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -10873,8 +10874,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.3 version: 5.1.4(typescript@5.8.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -10940,8 +10941,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vitest: specifier: ^3.2.4 version: 3.2.4(@types/node@25.0.9)(@vitest/browser@4.0.17(msw@2.7.0(@types/node@25.0.9)(typescript@5.9.3))(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1))(vitest@4.0.17))(@vitest/ui@4.0.17)(jiti@2.6.1)(jsdom@27.0.0(postcss@8.5.6))(lightningcss@1.30.2)(msw@2.7.0(@types/node@25.0.9)(typescript@5.9.2))(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) @@ -11007,8 +11008,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -11050,8 +11051,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -11093,8 +11094,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -11142,8 +11143,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -11176,8 +11177,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -11222,8 +11223,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -11265,8 +11266,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) vite-tsconfig-paths: specifier: ^5.1.4 version: 5.1.4(typescript@5.9.2)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) @@ -11305,8 +11306,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/with-framer-motion: dependencies: @@ -11342,8 +11343,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/solid/with-trpc: dependencies: @@ -11391,8 +11392,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) examples/vue/basic: dependencies: @@ -11911,8 +11912,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) packages/router-generator: dependencies: @@ -11996,8 +11997,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) webpack: specifier: '>=5.92.0' version: 5.97.1(webpack-cli@5.1.4) @@ -12129,8 +12130,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) zod: specifier: ^3.23.8 version: 3.25.57 @@ -12154,8 +12155,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) packages/solid-router-ssr-query: dependencies: @@ -12182,8 +12183,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) packages/solid-start: dependencies: @@ -12250,8 +12251,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) packages/solid-start-server: dependencies: @@ -12284,8 +12285,8 @@ importers: specifier: ^7.3.1 version: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) vite-plugin-solid: - specifier: ^2.11.10 - version: 2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) + specifier: https://pkg.pr.new/vite-plugin-solid@215 + version: https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)) packages/start-client-core: dependencies: @@ -18868,6 +18869,11 @@ packages: peerDependencies: '@babel/core': ^7.20.12 + babel-plugin-jsx-dom-expressions@0.41.0-next.1: + resolution: {integrity: sha512-U4z8EMpj/rXGWKN0yLiqsqvh2mecBX77R+4M1gfypipQ6kDPEAlIR+OoyEtsSsJzTyg1bXR43PaZgQ3znuRkzA==} + peerDependencies: + '@babel/core': ^7.20.12 + babel-plugin-macros@3.1.0: resolution: {integrity: sha512-Cg7TFGpIr01vOQNODXOOaGz2NpCU5gl8x1qJFbb6hbZxR7XrcE2vtbAsTAbJ7/xwJtUuJEw8K8Zr/AE0LHlesg==} engines: {node: '>=10', npm: '>=6'} @@ -18884,6 +18890,15 @@ packages: solid-js: optional: true + babel-preset-solid@2.0.0-experimental.13: + resolution: {integrity: sha512-QtoxYi6YWxtmVr7cggLFRtTaYA6xTzhNOEN6l8YOYXDZw2WGkMun/MHrNSXjx5mvqiasRx4KkcquUs83gmxfUg==} + peerDependencies: + '@babel/core': ^7.0.0 + solid-js: 2.0.0-experimental.14 + peerDependenciesMeta: + solid-js: + optional: true + balanced-match@1.0.2: resolution: {integrity: sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==} @@ -24490,6 +24505,9 @@ packages: typescript: optional: true + validate-html-nesting@1.2.4: + resolution: {integrity: sha512-doQi7e8EJ2OWneSG1aZpJluS6A49aZM0+EICXWKm1i6WvqTLmq0tpUcImc4KTWG50mORO0C4YDBtOCSYvElftw==} + validate-npm-package-license@3.0.4: resolution: {integrity: sha512-DpKm2Ui/xN7/HQKCtpZxoRWBhZ9Z0kqtygG8XCgNQ8ZlDnxuQmWhj566j8fN4Cu3/JmbhsDo7fcAJq4s9h27Ew==} @@ -24528,8 +24546,9 @@ packages: peerDependencies: vite: ^7.3.1 - vite-plugin-solid@2.11.10: - resolution: {integrity: sha512-Yr1dQybmtDtDAHkii6hXuc1oVH9CPcS/Zb2jN/P36qqcrkNnVPsMTzQ06jyzFPFjj3U1IYKMVt/9ZqcwGCEbjw==} + vite-plugin-solid@https://pkg.pr.new/vite-plugin-solid@215: + resolution: {integrity: sha512-mOpdDyKl5tScq9PR1SVLL1qa60jTh3gDKTL5Vj4ndGAaAm+HuWByJsGF5/33lTh3CLVTKD0IX/SeCx26YslZ5g==, tarball: https://pkg.pr.new/vite-plugin-solid@215} + version: 2.11.10 peerDependencies: '@testing-library/jest-dom': ^5.16.6 || ^5.17.0 || ^6.* solid-js: 2.0.0-experimental.14 @@ -31947,6 +31966,16 @@ snapshots: html-entities: 2.3.3 parse5: 7.3.0 + babel-plugin-jsx-dom-expressions@0.41.0-next.1(@babel/core@7.28.5): + dependencies: + '@babel/core': 7.28.5 + '@babel/helper-module-imports': 7.18.6 + '@babel/plugin-syntax-jsx': 7.27.1(@babel/core@7.28.5) + '@babel/types': 7.28.5 + html-entities: 2.3.3 + parse5: 7.3.0 + validate-html-nesting: 1.2.4 + babel-plugin-macros@3.1.0: dependencies: '@babel/runtime': 7.26.7 @@ -31967,6 +31996,13 @@ snapshots: optionalDependencies: solid-js: 2.0.0-experimental.14 + babel-preset-solid@2.0.0-experimental.13(@babel/core@7.28.5)(solid-js@2.0.0-experimental.14): + dependencies: + '@babel/core': 7.28.5 + babel-plugin-jsx-dom-expressions: 0.41.0-next.1(@babel/core@7.28.5) + optionalDependencies: + solid-js: 2.0.0-experimental.14 + balanced-match@1.0.2: {} bare-events@2.5.4: @@ -38252,6 +38288,8 @@ snapshots: optionalDependencies: typescript: 5.9.2 + validate-html-nesting@1.2.4: {} + validate-npm-package-license@3.0.4: dependencies: spdx-correct: 3.2.0 @@ -38357,11 +38395,11 @@ snapshots: dependencies: vite: 7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1) - vite-plugin-solid@2.11.10(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)): + vite-plugin-solid@https://pkg.pr.new/vite-plugin-solid@215(@testing-library/jest-dom@6.6.3)(solid-js@2.0.0-experimental.14)(vite@7.3.1(@types/node@25.0.9)(jiti@2.6.1)(lightningcss@1.30.2)(sass-embedded@1.97.2)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.8.1)): dependencies: '@babel/core': 7.28.5 '@types/babel__core': 7.20.5 - babel-preset-solid: 1.9.10(@babel/core@7.28.5)(solid-js@2.0.0-experimental.14) + babel-preset-solid: 2.0.0-experimental.13(@babel/core@7.28.5)(solid-js@2.0.0-experimental.14) merge-anything: 5.1.7 solid-js: 2.0.0-experimental.14 solid-refresh: 0.6.3(solid-js@2.0.0-experimental.14) From b4b1b5654d9c4bd41d09d067f4c1cda77165085d Mon Sep 17 00:00:00 2001 From: Birk Skyum Date: Sat, 21 Feb 2026 02:17:12 +0100 Subject: [PATCH 003/218] port router to v2 --- packages/solid-router/src/CatchBoundary.tsx | 2 +- packages/solid-router/src/Match.tsx | 2 +- packages/solid-router/src/useBlocker.tsx | 7 ++++--- packages/solid-router/src/useMatch.tsx | 2 +- packages/solid-router/src/useNavigate.tsx | 2 +- packages/solid-router/src/utils.ts | 6 ++++-- 6 files changed, 12 insertions(+), 9 deletions(-) diff --git a/packages/solid-router/src/CatchBoundary.tsx b/packages/solid-router/src/CatchBoundary.tsx index 10d5e83ca6..64f0a4deb3 100644 --- a/packages/solid-router/src/CatchBoundary.tsx +++ b/packages/solid-router/src/CatchBoundary.tsx @@ -15,7 +15,7 @@ export function CatchBoundary( fallback={(error, reset) => { props.onCatch?.(error) - Solid.createEffect( + Solid.createTrackedEffect( Solid.on([props.getResetKey], () => reset(), { defer: true }), ) diff --git a/packages/solid-router/src/Match.tsx b/packages/solid-router/src/Match.tsx index 98d185513f..53a8eba28a 100644 --- a/packages/solid-router/src/Match.tsx +++ b/packages/solid-router/src/Match.tsx @@ -170,7 +170,7 @@ function OnRendered() { return s.resolvedLocation?.state.__TSR_key }, }) - Solid.createEffect( + Solid.createTrackedEffect( Solid.on([location], () => { router.emit({ type: 'onRendered', diff --git a/packages/solid-router/src/useBlocker.tsx b/packages/solid-router/src/useBlocker.tsx index 25c8039aba..388fd57c74 100644 --- a/packages/solid-router/src/useBlocker.tsx +++ b/packages/solid-router/src/useBlocker.tsx @@ -160,7 +160,7 @@ export function useBlocker( opts?: UseBlockerOpts | LegacyBlockerOpts | LegacyBlockerFn, condition?: boolean | any, ): Solid.Accessor | void { - const props = Solid.mergeProps( + const props = Solid.merge( { enableBeforeUnload: true, disabled: false, @@ -180,7 +180,7 @@ export function useBlocker( reset: undefined, }) - Solid.createEffect(() => { + Solid.createTrackedEffect(() => { const blockerFnComposed = async (blockerFnArgs: BlockerFnArgs) => { function getLocation( location: HistoryLocation, @@ -303,7 +303,8 @@ export function Block< export function Block(opts: LegacyPromptProps): SolidNode export function Block(opts: PromptProps | LegacyPromptProps): SolidNode { - const [propsWithChildren, rest] = Solid.splitProps(opts, ['children']) + const { children: _, ...rest } = opts + const propsWithChildren = { get children() { return opts.children } } const args = _resolvePromptBlockerArgs(rest) const resolver = useBlocker(args) diff --git a/packages/solid-router/src/useMatch.tsx b/packages/solid-router/src/useMatch.tsx index 40a99e1487..4a7308447f 100644 --- a/packages/solid-router/src/useMatch.tsx +++ b/packages/solid-router/src/useMatch.tsx @@ -105,7 +105,7 @@ export function useMatch< // Use createEffect to throw errors outside the reactive selector context // This allows error boundaries to properly catch the errors - Solid.createEffect(() => { + Solid.createTrackedEffect(() => { const state = matchState() if (state.shouldThrowError) { invariant( diff --git a/packages/solid-router/src/useNavigate.tsx b/packages/solid-router/src/useNavigate.tsx index 40e51ced6b..aa77eda596 100644 --- a/packages/solid-router/src/useNavigate.tsx +++ b/packages/solid-router/src/useNavigate.tsx @@ -33,7 +33,7 @@ export function Navigate< >(props: NavigateOptions): null { const { navigate } = useRouter() - Solid.onMount(() => { + Solid.onSettled(() => { navigate({ ...props, }) diff --git a/packages/solid-router/src/utils.ts b/packages/solid-router/src/utils.ts index 0049cf3fa4..b190b60c4b 100644 --- a/packages/solid-router/src/utils.ts +++ b/packages/solid-router/src/utils.ts @@ -1,7 +1,9 @@ import * as Solid from 'solid-js' export const useLayoutEffect = - typeof window !== 'undefined' ? Solid.createRenderEffect : Solid.createEffect + typeof window !== 'undefined' + ? Solid.createTrackedEffect + : Solid.createTrackedEffect export const usePrevious = (fn: () => boolean) => { return Solid.createMemo( @@ -58,7 +60,7 @@ export function useIntersectionObserver( typeof IntersectionObserver === 'function' let observerRef: IntersectionObserver | null = null - Solid.createEffect(() => { + Solid.createTrackedEffect(() => { const r = ref() if (!r || !isIntersectionObserverAvailable || options.disabled) { return From 97321667bba266f56f37c750f407139c4e04471d Mon Sep 17 00:00:00 2001 From: Birk Skyum Date: Sat, 21 Feb 2026 02:18:22 +0100 Subject: [PATCH 004/218] transitioner --- packages/solid-router/src/Transitioner.tsx | 40 +++++++++------------- 1 file changed, 16 insertions(+), 24 deletions(-) diff --git a/packages/solid-router/src/Transitioner.tsx b/packages/solid-router/src/Transitioner.tsx index c061d769d4..948f5f561d 100644 --- a/packages/solid-router/src/Transitioner.tsx +++ b/packages/solid-router/src/Transitioner.tsx @@ -20,7 +20,7 @@ export function Transitioner() { return null } - const [isSolidTransitioning, startSolidTransition] = Solid.useTransition() + const [isSolidTransitioning, startSolidTransition] = [() => false, (fn: any) => fn()] // Track pending state changes const hasPendingMatches = useRouterState({ @@ -37,14 +37,12 @@ export function Transitioner() { const previousIsPagePending = usePrevious(isPagePending) router.startTransition = (fn: () => void | Promise) => { - Solid.startTransition(() => { - startSolidTransition(fn) - }) + startSolidTransition(fn) } // Subscribe to location changes // and try to load the new location - Solid.onMount(() => { + Solid.onSettled(() => { const unsub = router.history.subscribe(router.load) const nextLocation = router.buildLocation({ @@ -72,7 +70,7 @@ export function Transitioner() { }) // Try to load the initial location - Solid.createRenderEffect(() => { + Solid.createTrackedEffect(() => { Solid.untrack(() => { if ( // if we are hydrating from SSR, loading is triggered in ssr-client @@ -93,24 +91,21 @@ export function Transitioner() { }) }) - Solid.createRenderEffect( - Solid.on( - [previousIsLoading, isLoading], - ([previousIsLoading, isLoading]) => { + Solid.createEffect( + () => [previousIsLoading(), isLoading()] as const, + ([previousIsLoading, isLoading]) => { if (previousIsLoading.previous && !isLoading) { router.emit({ type: 'onLoad', ...getLocationChangeInfo(router.state), }) } - }, - ), + } ) - Solid.createComputed( - Solid.on( - [isPagePending, previousIsPagePending], - ([isPagePending, previousIsPagePending]) => { + Solid.createEffect( + () => [isPagePending(), previousIsPagePending()] as const, + ([isPagePending, previousIsPagePending]) => { // emit onBeforeRouteMount if (previousIsPagePending.previous && !isPagePending) { router.emit({ @@ -118,14 +113,12 @@ export function Transitioner() { ...getLocationChangeInfo(router.state), }) } - }, - ), + } ) - Solid.createRenderEffect( - Solid.on( - [isAnyPending, previousIsAnyPending], - ([isAnyPending, previousIsAnyPending]) => { + Solid.createEffect( + () => [isAnyPending(), previousIsAnyPending()] as const, + ([isAnyPending, previousIsAnyPending]) => { if (previousIsAnyPending.previous && !isAnyPending) { const changeInfo = getLocationChangeInfo(router.state) router.emit({ @@ -143,8 +136,7 @@ export function Transitioner() { handleHashScroll(router) } } - }, - ), + } ) return null From 74ac1834c4e3bf82ad149cb48295d533701824ce Mon Sep 17 00:00:00 2001 From: Birk Skyum Date: Sat, 21 Feb 2026 02:18:49 +0100 Subject: [PATCH 005/218] catchboundary --- packages/solid-router/src/CatchBoundary.tsx | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-) diff --git a/packages/solid-router/src/CatchBoundary.tsx b/packages/solid-router/src/CatchBoundary.tsx index 64f0a4deb3..3404992a13 100644 --- a/packages/solid-router/src/CatchBoundary.tsx +++ b/packages/solid-router/src/CatchBoundary.tsx @@ -1,7 +1,11 @@ import * as Solid from 'solid-js' -import { Dynamic } from 'solid-js/web' import type { ErrorRouteComponent } from './route' +function Dynamic(props: any) { + const { component, ...rest } = props + return Solid.createComponent(component, rest) +} + export function CatchBoundary( props: { getResetKey: () => number | string @@ -11,13 +15,16 @@ export function CatchBoundary( } & Solid.ParentProps, ) { return ( - { props.onCatch?.(error) - Solid.createTrackedEffect( - Solid.on([props.getResetKey], () => reset(), { defer: true }), - ) + Solid.createTrackedEffect(() => { + const key = props.getResetKey() + // We trigger reset here. For a fully deferred effect we might need usePrevious, + // but calling reset on key change is the main goal. + reset() + }) return ( {props.children} - + ) } From 39690d1d640481d08b48881aa19dfec935aef4ee Mon Sep 17 00:00:00 2001 From: Birk Skyum Date: Sat, 21 Feb 2026 02:20:46 +0100 Subject: [PATCH 006/218] match and asset --- packages/solid-router/src/Asset.tsx | 2 +- packages/solid-router/src/Match.tsx | 59 ++++++++++++++++++++++------- 2 files changed, 46 insertions(+), 15 deletions(-) diff --git a/packages/solid-router/src/Asset.tsx b/packages/solid-router/src/Asset.tsx index b762e7bb78..ad2f322283 100644 --- a/packages/solid-router/src/Asset.tsx +++ b/packages/solid-router/src/Asset.tsx @@ -1,5 +1,5 @@ import { Link, Meta, Style, Title } from '@solidjs/meta' -import { onCleanup, onMount } from 'solid-js' +import { onCleanup, onSettled as onMount } from 'solid-js' import { isServer } from '@tanstack/router-core/isServer' import { useRouter } from './useRouter' import type { RouterManagedTag } from '@tanstack/router-core' diff --git a/packages/solid-router/src/Match.tsx b/packages/solid-router/src/Match.tsx index 53a8eba28a..a1f019b505 100644 --- a/packages/solid-router/src/Match.tsx +++ b/packages/solid-router/src/Match.tsx @@ -9,7 +9,6 @@ import { rootRouteId, } from '@tanstack/router-core' import { isServer } from '@tanstack/router-core/isServer' -import { Dynamic } from 'solid-js/web' import { CatchBoundary, ErrorComponent } from './CatchBoundary' import { useRouterState } from './useRouterState' import { useRouter } from './useRouter' @@ -20,6 +19,38 @@ import { renderRouteNotFound } from './renderRouteNotFound' import { ScrollRestoration } from './scroll-restoration' import type { AnyRoute, RootRouteOptions } from '@tanstack/router-core' +function Dynamic(props: any) { + const { component, ...rest } = props + return Solid.createComponent(component, rest) +} + +function createResource(fn: () => Promise | undefined): [() => T | undefined] { + let p: Promise | undefined; + const [signal, setSignal] = Solid.createSignal(undefined); + const [error, setError] = Solid.createSignal(undefined); + const [pending, setPending] = Solid.createSignal(false); + + return [ + () => { + const currentP = fn(); + if (currentP && currentP !== p) { + p = currentP; + setPending(true); + currentP.then( + (res: any) => { setSignal(() => res); setPending(false); }, + (err: any) => { setError(err); setPending(false); } + ); + } + if (pending() && p) throw p; + const e = error(); + if (e) throw e; + return signal(); + } + ] +} + +const MatchContext = matchContext as unknown as Solid.Component<{ value: any, children?: any }>; + export const Match = (props: { matchId: string }) => { const router = useRouter() const matchState = useRouterState({ @@ -64,7 +95,7 @@ export const Match = (props: { matchId: string }) => { const resolvedNoSsr = matchState()!.ssr === false || matchState()!.ssr === 'data-only' - const ResolvedSuspenseBoundary = () => Solid.Suspense + const ResolvedSuspenseBoundary = () => Solid.Loading const ResolvedCatchBoundary = () => routeErrorComponent() ? CatchBoundary : SafeFragment @@ -89,7 +120,7 @@ export const Match = (props: { matchId: string }) => { return ( - props.matchId}> + props.matchId}> { - + {parentRouteId() === rootRouteId ? ( <> @@ -170,14 +201,14 @@ function OnRendered() { return s.resolvedLocation?.state.__TSR_key }, }) - Solid.createTrackedEffect( - Solid.on([location], () => { + Solid.createEffect( + () => [location()] as const, + ([location]) => { router.emit({ type: 'onRendered', ...getLocationChangeInfo(router.state), }) - }), - ) + }) return null } @@ -246,7 +277,7 @@ export const MatchInner = (props: { matchId: string }): any => { {(_) => { - const [displayPendingResult] = Solid.createResource( + const [displayPendingResult] = createResource( () => router.getMatch(match().id)?._nonReactive.displayPendingPromise, ) @@ -256,7 +287,7 @@ export const MatchInner = (props: { matchId: string }): any => { {(_) => { - const [minPendingResult] = Solid.createResource( + const [minPendingResult] = createResource( () => router.getMatch(match().id)?._nonReactive.minPendingPromise, ) @@ -286,7 +317,7 @@ export const MatchInner = (props: { matchId: string }): any => { } } - const [loaderResult] = Solid.createResource(async () => { + const [loaderResult] = createResource(async () => { await new Promise((r) => setTimeout(r, 0)) return router.getMatch(match().id)?._nonReactive.loadPromise }) @@ -323,7 +354,7 @@ export const MatchInner = (props: { matchId: string }): any => { {(_) => { invariant(isRedirect(match().error), 'Expected a redirect error') - const [loaderResult] = Solid.createResource(async () => { + const [loaderResult] = createResource(async () => { await new Promise((r) => setTimeout(r, 0)) return router.getMatch(match().id)?._nonReactive.loadPromise }) @@ -422,13 +453,13 @@ export const Outlet = () => { when={routeId() === rootRouteId} fallback={} > - } > - + ) }} From 6b3b9238be1abec06042f9904af61aa55f7c2098 Mon Sep 17 00:00:00 2001 From: Birk Skyum Date: Sat, 21 Feb 2026 02:20:56 +0100 Subject: [PATCH 007/218] awaited --- packages/solid-router/src/awaited.tsx | 20 ++++++++------------ 1 file changed, 8 insertions(+), 12 deletions(-) diff --git a/packages/solid-router/src/awaited.tsx b/packages/solid-router/src/awaited.tsx index 892c67b19c..1a1bff9c98 100644 --- a/packages/solid-router/src/awaited.tsx +++ b/packages/solid-router/src/awaited.tsx @@ -24,24 +24,20 @@ export function useAwaited({ return [promise[TSR_DEFERRED_PROMISE].data, promise] } +function InnerAwait(props: { promise: Promise, children: (res: T) => SolidNode }) { + const [data] = useAwaited({ promise: props.promise }) + return props.children(data) as any +} + export function Await( props: AwaitOptions & { fallback?: SolidNode children: (result: T) => SolidNode }, ) { - const [resource] = Solid.createResource( - () => defer(props.promise), - // Simple passthrough - just return the promise for Solid to await - (p) => p, - { - deferStream: true, - }, - ) - return ( - - {(data) => props.children(data())} - + + {props.children} + ) } From eb81b3c6eca014622f95b37e14ab5a680ebf7c1e Mon Sep 17 00:00:00 2001 From: Birk Skyum Date: Sat, 21 Feb 2026 02:27:32 +0100 Subject: [PATCH 008/218] install @solidjs/web --- package.json | 1 + packages/solid-router/package.json | 1 + packages/solid-router/src/HeadContent.dev.tsx | 19 ++++++---- packages/solid-router/src/HeadContent.tsx | 2 +- packages/solid-router/src/Matches.tsx | 8 ++-- packages/solid-router/src/RouterProvider.tsx | 6 ++- .../solid-router/src/lazyRouteComponent.tsx | 33 +++++++++++++++- packages/solid-router/src/link.tsx | 38 +++++++++++++------ .../solid-router/src/ssr/RouterServer.tsx | 4 +- .../src/ssr/renderRouterToStream.tsx | 2 +- .../src/ssr/renderRouterToString.tsx | 2 +- pnpm-lock.yaml | 17 ++++++++- 12 files changed, 101 insertions(+), 32 deletions(-) diff --git a/package.json b/package.json index 3b91c42ca1..5c945db7f6 100644 --- a/package.json +++ b/package.json @@ -78,6 +78,7 @@ "@types/babel__traverse": "^7.28.0", "vite-plugin-dts": "4.0.3", "solid-js": "2.0.0-experimental.14", + "@solidjs/web": "2.0.0-experimental.14", "react": "$react", "react-dom": "$react-dom", "@types/react": "$@types/react", diff --git a/packages/solid-router/package.json b/packages/solid-router/package.json index fc32eb3cf6..b99f90b0f3 100644 --- a/packages/solid-router/package.json +++ b/packages/solid-router/package.json @@ -104,6 +104,7 @@ "@solid-devtools/logger": "^0.9.4", "@solid-primitives/refs": "^1.0.8", "@solidjs/meta": "^0.29.4", + "@solidjs/web": "*", "@tanstack/history": "workspace:*", "@tanstack/router-core": "workspace:*", "@tanstack/solid-store": "^0.9.1", diff --git a/packages/solid-router/src/HeadContent.dev.tsx b/packages/solid-router/src/HeadContent.dev.tsx index c29ad96eab..ec21e98a34 100644 --- a/packages/solid-router/src/HeadContent.dev.tsx +++ b/packages/solid-router/src/HeadContent.dev.tsx @@ -21,13 +21,16 @@ export function HeadContent() { // Fallback cleanup for hydration mismatch cases // Runs when hydration completes to remove any orphaned dev styles links from DOM - createEffect(() => { - if (hydrated()) { - document - .querySelectorAll(`link[${DEV_STYLES_ATTR}]`) - .forEach((el) => el.remove()) - } - }) + createEffect( + () => [hydrated()] as const, + ([hydrated]) => { + if (hydrated) { + document + .querySelectorAll(`link[${DEV_STYLES_ATTR}]`) + .forEach((el) => el.remove()) + } + }, + ) // Filter out dev styles after hydration const filteredTags = createMemo(() => { @@ -39,7 +42,7 @@ export function HeadContent() { return ( - {(tag) => } + {(tag) => } ) } diff --git a/packages/solid-router/src/HeadContent.tsx b/packages/solid-router/src/HeadContent.tsx index 8a02f146a7..75b459ce1e 100644 --- a/packages/solid-router/src/HeadContent.tsx +++ b/packages/solid-router/src/HeadContent.tsx @@ -14,7 +14,7 @@ export function HeadContent() { return ( - {(tag) => } + {(tag) => } ) } diff --git a/packages/solid-router/src/Matches.tsx b/packages/solid-router/src/Matches.tsx index a39f09a4db..dddd7d8738 100644 --- a/packages/solid-router/src/Matches.tsx +++ b/packages/solid-router/src/Matches.tsx @@ -28,6 +28,8 @@ import type { ToSubOptionsProps, } from '@tanstack/router-core' +const MatchContext = matchContext as unknown as Solid.Component<{ value: any, children: any }>; + declare module '@tanstack/router-core' { export interface RouteMatchExtensions { meta?: Array @@ -45,7 +47,7 @@ export function Matches() { (isServer ?? router.isServer) || (typeof document !== 'undefined' && router.ssr) ? SafeFragment - : Solid.Suspense + : Solid.Loading const rootRoute: () => AnyRoute = () => router.routesById[rootRouteId] const PendingComponent = @@ -87,7 +89,7 @@ function MatchesInner() { } return ( - + {router.options.disableGlobalCatchBoundary ? ( matchComponent() ) : ( @@ -106,7 +108,7 @@ function MatchesInner() { {matchComponent()} )} - + ) } diff --git a/packages/solid-router/src/RouterProvider.tsx b/packages/solid-router/src/RouterProvider.tsx index 1092d9b43c..4a17b1f2a0 100644 --- a/packages/solid-router/src/RouterProvider.tsx +++ b/packages/solid-router/src/RouterProvider.tsx @@ -8,6 +8,8 @@ import type { } from '@tanstack/router-core' import type * as Solid from 'solid-js' +const RouterContext = getRouterContext() as unknown as Solid.Component<{ value: any, children: any }>; + export function RouterContextProvider< TRouter extends AnyRouter = RegisteredRouter, TDehydrated extends Record = Record, @@ -34,9 +36,9 @@ export function RouterContextProvider< return ( - + {children()} - + ) } diff --git a/packages/solid-router/src/lazyRouteComponent.tsx b/packages/solid-router/src/lazyRouteComponent.tsx index 424940522b..a713532aa7 100644 --- a/packages/solid-router/src/lazyRouteComponent.tsx +++ b/packages/solid-router/src/lazyRouteComponent.tsx @@ -1,8 +1,37 @@ -import { Dynamic } from 'solid-js/web' -import { createResource } from 'solid-js' +import * as Solid from 'solid-js' import { isModuleNotFoundError } from '@tanstack/router-core' import type { AsyncRouteComponent } from './route' +function Dynamic(props: any) { + const { component, ...rest } = props + return Solid.createComponent(component, rest) +} + +function createResource(fn: () => Promise | undefined, options?: any): [() => T | undefined] { + let p: Promise | undefined; + const [signal, setSignal] = Solid.createSignal(options?.initialValue); + const [error, setError] = Solid.createSignal(undefined); + const [pending, setPending] = Solid.createSignal(false); + + return [ + () => { + const currentP = fn(); + if (currentP && currentP !== p) { + p = currentP; + setPending(true); + currentP.then( + (res: any) => { setSignal(() => res); setPending(false); }, + (err: any) => { setError(err); setPending(false); } + ); + } + if (pending() && p) throw p; + const e = error(); + if (e) throw e; + return signal(); + } + ] +} + export function lazyRouteComponent< T extends Record, TKey extends keyof T = 'default', diff --git a/packages/solid-router/src/link.tsx b/packages/solid-router/src/link.tsx index 4a807fd937..c21949b7c1 100644 --- a/packages/solid-router/src/link.tsx +++ b/packages/solid-router/src/link.tsx @@ -12,7 +12,23 @@ import { } from '@tanstack/router-core' import { isServer } from '@tanstack/router-core/isServer' -import { Dynamic } from 'solid-js/web' +function Dynamic(props: any) { + const { component, ...rest } = props + return Solid.createComponent(component, rest) +} + +function splitProps, K extends keyof T>( + props: T, + keys: readonly K[] +): [Pick, Omit] { + const local = {} as Pick; + const rest = {} as Omit; + + // A safe way to polyfill splitProps if native getter copy is too complex + // is just to return [props, Solid.omit(props, keys)] but it modifies typing. + // Actually, Solid.omit exists! + return [props as any, Solid.omit(props, keys as any) as any]; +} import { useRouterState } from './useRouterState' import { useRouter } from './useRouter' @@ -48,8 +64,8 @@ export function useLinkProps< let hasRenderFetched = false - const [local, rest] = Solid.splitProps( - Solid.mergeProps( + const [local, rest] = splitProps( + Solid.merge( { activeProps: () => ({ class: 'active' }), inactiveProps: () => ({}), @@ -111,7 +127,7 @@ export function useLinkProps< // ...rest // } = options - const [_, propsSafeToSpread] = Solid.splitProps(rest, [ + const [_, propsSafeToSpread] = splitProps(rest, [ 'params', 'search', 'hash', @@ -274,7 +290,7 @@ export function useLinkProps< { disabled: !!local.disabled || !(preload() === 'viewport') }, ) - Solid.createEffect(() => { + Solid.createTrackedEffect(() => { if (hasRenderFetched) { return } @@ -285,13 +301,13 @@ export function useLinkProps< }) if (externalLink()) { - return Solid.mergeProps( + return Solid.merge( propsSafeToSpread, { ref: mergeRefs(setRef, _options().ref), href: externalLink(), }, - Solid.splitProps(local, [ + splitProps(local, [ 'target', 'disabled', 'style', @@ -432,7 +448,7 @@ export function useLinkProps< ...resolvedInactiveProps().style, }) - return Solid.mergeProps( + return Solid.merge( propsSafeToSpread, resolvedActiveProps, resolvedInactiveProps, @@ -592,12 +608,12 @@ export function createLink( } export const Link: LinkComponent<'a'> = (props) => { - const [local, rest] = Solid.splitProps( + const [local, rest] = splitProps( props as typeof props & { _asChild: any }, ['_asChild', 'children'], ) - const [_, linkProps] = Solid.splitProps( + const [_, linkProps] = splitProps( useLinkProps(rest as unknown as any), ['type'], ) @@ -619,7 +635,7 @@ export const Link: LinkComponent<'a'> = (props) => { }) if (local._asChild === 'svg') { - const [_, svgLinkProps] = Solid.splitProps(linkProps, ['class']) + const [_, svgLinkProps] = splitProps(linkProps as any, ['class']) return ( {children()} diff --git a/packages/solid-router/src/ssr/RouterServer.tsx b/packages/solid-router/src/ssr/RouterServer.tsx index baa1c45502..4c482680dc 100644 --- a/packages/solid-router/src/ssr/RouterServer.tsx +++ b/packages/solid-router/src/ssr/RouterServer.tsx @@ -4,7 +4,7 @@ import { NoHydration, ssr, useAssets, -} from 'solid-js/web' +} from '@solidjs/web' import { MetaProvider } from '@solidjs/meta' import { Asset } from '../Asset' import { useTags } from '../headContentUtils' @@ -18,7 +18,7 @@ export function ServerHeadContent() { return ( {tags().map((tag) => ( - + ))} ) diff --git a/packages/solid-router/src/ssr/renderRouterToStream.tsx b/packages/solid-router/src/ssr/renderRouterToStream.tsx index 5c3e403060..8f1dbb77f9 100644 --- a/packages/solid-router/src/ssr/renderRouterToStream.tsx +++ b/packages/solid-router/src/ssr/renderRouterToStream.tsx @@ -1,4 +1,4 @@ -import * as Solid from 'solid-js/web' +import * as Solid from '@solidjs/web' import { isbot } from 'isbot' import { transformReadableStreamWithRouter } from '@tanstack/router-core/ssr/server' import { makeSsrSerovalPlugin } from '@tanstack/router-core' diff --git a/packages/solid-router/src/ssr/renderRouterToString.tsx b/packages/solid-router/src/ssr/renderRouterToString.tsx index 9d21769937..4984c4e6e8 100644 --- a/packages/solid-router/src/ssr/renderRouterToString.tsx +++ b/packages/solid-router/src/ssr/renderRouterToString.tsx @@ -1,4 +1,4 @@ -import * as Solid from 'solid-js/web' +import * as Solid from '@solidjs/web' import { makeSsrSerovalPlugin } from '@tanstack/router-core' import type { AnyRouter } from '@tanstack/router-core' import type { JSXElement } from 'solid-js' diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index 0d63ba10c2..f163d6f54f 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -8,6 +8,7 @@ overrides: '@types/babel__traverse': ^7.28.0 vite-plugin-dts: 4.0.3 solid-js: 2.0.0-experimental.14 + '@solidjs/web': 2.0.0-experimental.14 react: ^19.2.3 react-dom: ^19.2.3 '@types/react': ^19.2.8 @@ -12092,6 +12093,9 @@ importers: '@solidjs/meta': specifier: ^0.29.4 version: 0.29.4(solid-js@2.0.0-experimental.14) + '@solidjs/web': + specifier: 2.0.0-experimental.14 + version: 2.0.0-experimental.14(solid-js@2.0.0-experimental.14) '@tanstack/history': specifier: workspace:* version: link:../history @@ -17326,6 +17330,11 @@ packages: '@solidjs/router': optional: true + '@solidjs/web@2.0.0-experimental.14': + resolution: {integrity: sha512-cushQl8Dkh2WKwgidWzQ1ECPWGohMyIGTrPZYINKa0bbulFAI4F05ijTmrUq/knSnQ4nwYUQbiDVWYiEQ11+Pw==} + peerDependencies: + solid-js: 2.0.0-experimental.14 + '@speed-highlight/core@1.2.14': resolution: {integrity: sha512-G4ewlBNhUtlLvrJTb88d2mdy2KRijzs4UhnlrOSRT4bmjh/IqNElZa3zkrZ+TC47TwtlDWzVLFADljF1Ijp5hA==} @@ -24547,7 +24556,7 @@ packages: vite: ^7.3.1 vite-plugin-solid@https://pkg.pr.new/vite-plugin-solid@215: - resolution: {integrity: sha512-mOpdDyKl5tScq9PR1SVLL1qa60jTh3gDKTL5Vj4ndGAaAm+HuWByJsGF5/33lTh3CLVTKD0IX/SeCx26YslZ5g==, tarball: https://pkg.pr.new/vite-plugin-solid@215} + resolution: {tarball: https://pkg.pr.new/vite-plugin-solid@215} version: 2.11.10 peerDependencies: '@testing-library/jest-dom': ^5.16.6 || ^5.17.0 || ^6.* @@ -29799,6 +29808,12 @@ snapshots: '@testing-library/dom': 10.4.1 solid-js: 2.0.0-experimental.14 + '@solidjs/web@2.0.0-experimental.14(solid-js@2.0.0-experimental.14)': + dependencies: + seroval: 1.5.0 + seroval-plugins: 1.5.0(seroval@1.5.0) + solid-js: 2.0.0-experimental.14 + '@speed-highlight/core@1.2.14': {} '@speed-highlight/core@1.2.7': {} From b6d2a12162f8639344dce60dfc7c23d4bef7ac4a Mon Sep 17 00:00:00 2001 From: Birk Skyum Date: Sat, 21 Feb 2026 02:30:29 +0100 Subject: [PATCH 009/218] use @solidjs/web --- docs/router/guide/ssr.md | 2 +- docs/router/installation/manual.md | 4 ++-- docs/start/framework/solid/build-from-scratch.md | 2 +- docs/start/framework/solid/guide/client-entry-point.md | 6 +++--- docs/start/framework/solid/guide/hydration-errors.md | 2 +- e2e/solid-router/basepath-file-based/src/main.tsx | 2 +- e2e/solid-router/basic-esbuild-file-based/src/main.tsx | 2 +- .../basic-file-based-code-splitting/src/main.tsx | 2 +- e2e/solid-router/basic-file-based/src/main.tsx | 2 +- e2e/solid-router/basic-scroll-restoration/src/main.tsx | 2 +- e2e/solid-router/basic-solid-query-file-based/src/main.tsx | 2 +- e2e/solid-router/basic-solid-query/src/main.tsx | 2 +- e2e/solid-router/basic-virtual-file-based/src/main.tsx | 2 +- .../src/main.tsx | 2 +- e2e/solid-router/basic/src/main.tsx | 2 +- e2e/solid-router/generator-cli-only/src/main.tsx | 2 +- e2e/solid-router/js-only-file-based/src/main.jsx | 2 +- e2e/solid-router/rspack-basic-file-based/src/index.tsx | 2 +- .../src/index.tsx | 2 +- .../scroll-restoration-sandbox-vite/src/main.tsx | 2 +- .../scroll-restoration-sandbox-vite/src/routes/__root.tsx | 2 +- e2e/solid-router/sentry-integration/src/main.tsx | 2 +- e2e/solid-router/view-transitions/src/main.tsx | 2 +- e2e/solid-start/basic-auth/src/routes/__root.tsx | 2 +- e2e/solid-start/basic-cloudflare/src/routes/__root.tsx | 2 +- e2e/solid-start/basic-solid-query/src/routes/__root.tsx | 2 +- e2e/solid-start/basic-tsr-config/src/app/routes/__root.tsx | 2 +- e2e/solid-start/basic/src/client.tsx | 2 +- e2e/solid-start/basic/src/routes/__root.tsx | 2 +- e2e/solid-start/csp/src/routes/__root.tsx | 2 +- e2e/solid-start/css-modules/src/routes/__root.tsx | 2 +- e2e/solid-start/custom-basepath/src/routes/__root.tsx | 2 +- e2e/solid-start/query-integration/src/routes/__root.tsx | 2 +- e2e/solid-start/scroll-restoration/src/routes/__root.tsx | 2 +- e2e/solid-start/selective-ssr/src/routes/__root.tsx | 2 +- .../serialization-adapters/src/routes/__root.tsx | 2 +- e2e/solid-start/server-functions/src/routes/__root.tsx | 2 +- e2e/solid-start/server-routes/src/routes/__root.tsx | 2 +- e2e/solid-start/spa-mode/src/routes/__root.tsx | 2 +- e2e/solid-start/website/src/routes/__root.tsx | 2 +- examples/solid/authenticated-routes-firebase/src/main.tsx | 2 +- examples/solid/authenticated-routes/src/main.tsx | 2 +- examples/solid/basic-default-search-params/src/main.tsx | 2 +- examples/solid/basic-devtools-panel/src/main.tsx | 2 +- examples/solid/basic-file-based/src/main.tsx | 2 +- examples/solid/basic-non-nested-devtools/src/main.tsx | 2 +- examples/solid/basic-solid-query-file-based/src/main.tsx | 2 +- examples/solid/basic-solid-query/src/main.tsx | 2 +- examples/solid/basic-ssr-file-based/src/entry-client.tsx | 2 +- .../basic-ssr-streaming-file-based/src/entry-client.tsx | 2 +- examples/solid/basic-virtual-file-based/src/main.tsx | 2 +- examples/solid/basic-virtual-inside-file-based/src/main.tsx | 2 +- examples/solid/basic/src/main.tsx | 2 +- examples/solid/deferred-data/src/main.tsx | 2 +- examples/solid/i18n-paraglide/src/main.tsx | 2 +- examples/solid/kitchen-sink-file-based/src/main.tsx | 2 +- .../solid/kitchen-sink-solid-query-file-based/src/main.tsx | 2 +- examples/solid/kitchen-sink-solid-query/src/main.tsx | 2 +- examples/solid/kitchen-sink/src/main.tsx | 2 +- examples/solid/large-file-based/src/main.tsx | 2 +- examples/solid/location-masking/src/main.tsx | 2 +- examples/solid/navigation-blocking/src/main.tsx | 2 +- examples/solid/quickstart-esbuild-file-based/src/main.tsx | 2 +- examples/solid/quickstart-file-based/src/main.tsx | 2 +- examples/solid/quickstart-rspack-file-based/src/index.tsx | 2 +- examples/solid/quickstart-webpack-file-based/src/index.tsx | 2 +- examples/solid/quickstart/src/main.tsx | 2 +- .../router-monorepo-simple-lazy/packages/app/src/main.tsx | 2 +- .../packages/router/vite.config.ts | 2 +- .../solid/router-monorepo-simple/packages/app/src/main.tsx | 2 +- .../packages/post-feature/vite.config.ts | 2 +- .../router-monorepo-simple/packages/router/vite.config.ts | 2 +- .../router-monorepo-solid-query/packages/app/src/main.tsx | 2 +- .../packages/post-feature/vite.config.ts | 2 +- .../packages/post-query/vite.config.ts | 2 +- .../packages/router/vite.config.ts | 2 +- examples/solid/scroll-restoration/src/main.tsx | 2 +- examples/solid/search-validator-adapters/src/main.tsx | 2 +- examples/solid/start-basic-auth/src/routes/__root.tsx | 2 +- examples/solid/start-basic-authjs/src/routes/__root.tsx | 2 +- examples/solid/start-basic-cloudflare/src/routes/__root.tsx | 2 +- examples/solid/start-basic-netlify/src/routes/__root.tsx | 2 +- examples/solid/start-basic-nitro/src/routes/__root.tsx | 2 +- .../solid/start-basic-solid-query/src/routes/__root.tsx | 2 +- examples/solid/start-basic-static/src/routes/__root.tsx | 2 +- examples/solid/start-basic/src/routes/__root.tsx | 2 +- examples/solid/start-bun/src/routes/__root.tsx | 2 +- .../solid/start-convex-better-auth/src/routes/__root.tsx | 2 +- examples/solid/start-counter/src/routes/__root.tsx | 2 +- examples/solid/start-i18n-paraglide/src/routes/__root.tsx | 2 +- .../src/routes/__root.tsx | 2 +- examples/solid/start-supabase-basic/src/routes/__root.tsx | 2 +- examples/solid/start-tailwind-v4/src/routes/__root.tsx | 2 +- examples/solid/view-transitions/src/main.tsx | 2 +- examples/solid/with-framer-motion/src/main.tsx | 2 +- examples/solid/with-trpc/src/main.tsx | 2 +- .../src/FloatingTanStackRouterDevtools.tsx | 2 +- .../router-devtools-core/src/TanStackRouterDevtoolsCore.tsx | 2 +- .../src/TanStackRouterDevtoolsPanelCore.tsx | 2 +- packages/router-devtools-core/src/utils.tsx | 2 +- packages/router-devtools-core/vite.config.ts | 2 +- packages/solid-router/src/ClientOnly.tsx | 2 +- packages/solid-router/src/link.tsx | 2 +- .../solid-router/tests/disableGlobalCatchBoundary.test.tsx | 2 +- packages/solid-router/tests/link.bench.tsx | 4 ++-- packages/solid-router/tests/server/ClientOnly.test.tsx | 2 +- packages/solid-router/tests/server/Transitioner.test.tsx | 2 +- packages/solid-start/src/default-entry/client.tsx | 2 +- 108 files changed, 112 insertions(+), 112 deletions(-) diff --git a/docs/router/guide/ssr.md b/docs/router/guide/ssr.md index b51f1f2f7d..1a49dc2334 100644 --- a/docs/router/guide/ssr.md +++ b/docs/router/guide/ssr.md @@ -234,7 +234,7 @@ hydrateRoot(document, ) # Solid ```tsx title="src/entry-client.tsx" -import { hydrate } from 'solid-js/web' +import { hydrate } from '@solidjs/web' import { RouterClient } from '@tanstack/solid-router/ssr/client' import { createRouter } from './router' diff --git a/docs/router/installation/manual.md b/docs/router/installation/manual.md index 76d1f1fe6a..e2cfcabcf3 100644 --- a/docs/router/installation/manual.md +++ b/docs/router/installation/manual.md @@ -204,7 +204,7 @@ function About() { ```tsx title="src/main.tsx" /* @refresh reload */ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider, createRouter } from '@tanstack/solid-router' // Import the generated route tree @@ -319,7 +319,7 @@ if (!rootElement.innerHTML) { ```tsx /* @refresh reload */ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { Outlet, RouterProvider, diff --git a/docs/start/framework/solid/build-from-scratch.md b/docs/start/framework/solid/build-from-scratch.md index f9b19384f1..0e1d49a0f6 100644 --- a/docs/start/framework/solid/build-from-scratch.md +++ b/docs/start/framework/solid/build-from-scratch.md @@ -163,7 +163,7 @@ import { HeadContent, Scripts, } from '@tanstack/solid-router' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' export const Route = createRootRoute({ head: () => ({ diff --git a/docs/start/framework/solid/guide/client-entry-point.md b/docs/start/framework/solid/guide/client-entry-point.md index b73408e8e4..c44d7a9a47 100644 --- a/docs/start/framework/solid/guide/client-entry-point.md +++ b/docs/start/framework/solid/guide/client-entry-point.md @@ -12,7 +12,7 @@ Getting our html to the client is only half the battle. Once there, we need to h ```tsx // src/client.tsx -import { hydrate } from 'solid-js/web' +import { hydrate } from '@solidjs/web' import { StartClient, hydrateStart } from '@tanstack/solid-start/client' hydrateStart().then((router) => { @@ -29,7 +29,7 @@ You can wrap your client entry point with error boundaries to handle client-side ```tsx // src/client.tsx import { StartClient } from '@tanstack/solid-start/client' -import { hydrate } from 'solid-js/web' +import { hydrate } from '@solidjs/web' import { ErrorBoundary } from './components/ErrorBoundary' hydrate( @@ -49,7 +49,7 @@ You may want different behavior in development vs production: ```tsx // src/client.tsx import { StartClient } from '@tanstack/solid-start/client' -import { hydrate } from 'solid-js/web' +import { hydrate } from '@solidjs/web' const App = ( <> diff --git a/docs/start/framework/solid/guide/hydration-errors.md b/docs/start/framework/solid/guide/hydration-errors.md index 75e44280c9..75e7d59c82 100644 --- a/docs/start/framework/solid/guide/hydration-errors.md +++ b/docs/start/framework/solid/guide/hydration-errors.md @@ -93,7 +93,7 @@ function SetTimeZoneCookie() { ```tsx import { ClientOnly } from '@tanstack/solid-router' -import { NoHydration } from 'solid-js/web' +import { NoHydration } from '@solidjs/web' —}> diff --git a/e2e/solid-router/basepath-file-based/src/main.tsx b/e2e/solid-router/basepath-file-based/src/main.tsx index 23304bb732..27019c7bb3 100644 --- a/e2e/solid-router/basepath-file-based/src/main.tsx +++ b/e2e/solid-router/basepath-file-based/src/main.tsx @@ -1,5 +1,5 @@ import { RouterProvider, createRouter } from '@tanstack/solid-router' -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { routeTree } from './routeTree.gen' // Set up a Router instance diff --git a/e2e/solid-router/basic-esbuild-file-based/src/main.tsx b/e2e/solid-router/basic-esbuild-file-based/src/main.tsx index 0eebff3ea9..e6d831490b 100644 --- a/e2e/solid-router/basic-esbuild-file-based/src/main.tsx +++ b/e2e/solid-router/basic-esbuild-file-based/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider, createRouter } from '@tanstack/solid-router' import { routeTree } from './routeTree.gen' diff --git a/e2e/solid-router/basic-file-based-code-splitting/src/main.tsx b/e2e/solid-router/basic-file-based-code-splitting/src/main.tsx index 8128384193..4bd8c56ef3 100644 --- a/e2e/solid-router/basic-file-based-code-splitting/src/main.tsx +++ b/e2e/solid-router/basic-file-based-code-splitting/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider, createRouter } from '@tanstack/solid-router' import { routeTree } from './routeTree.gen' import './styles.css' diff --git a/e2e/solid-router/basic-file-based/src/main.tsx b/e2e/solid-router/basic-file-based/src/main.tsx index 2ca59d07e8..1ebd6fb7d7 100644 --- a/e2e/solid-router/basic-file-based/src/main.tsx +++ b/e2e/solid-router/basic-file-based/src/main.tsx @@ -3,7 +3,7 @@ import { createRouteMask, createRouter, } from '@tanstack/solid-router' -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { routeTree } from './routeTree.gen' import './styles.css' diff --git a/e2e/solid-router/basic-scroll-restoration/src/main.tsx b/e2e/solid-router/basic-scroll-restoration/src/main.tsx index c90182caf7..2c7cdeffc9 100644 --- a/e2e/solid-router/basic-scroll-restoration/src/main.tsx +++ b/e2e/solid-router/basic-scroll-restoration/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { HeadContent, Link, diff --git a/e2e/solid-router/basic-solid-query-file-based/src/main.tsx b/e2e/solid-router/basic-solid-query-file-based/src/main.tsx index 7f1d2165f1..6f64a152de 100644 --- a/e2e/solid-router/basic-solid-query-file-based/src/main.tsx +++ b/e2e/solid-router/basic-solid-query-file-based/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider, createRouter } from '@tanstack/solid-router' import { QueryClient, QueryClientProvider } from '@tanstack/solid-query' import { routeTree } from './routeTree.gen' diff --git a/e2e/solid-router/basic-solid-query/src/main.tsx b/e2e/solid-router/basic-solid-query/src/main.tsx index 6228ad8e86..a3be1d7e70 100644 --- a/e2e/solid-router/basic-solid-query/src/main.tsx +++ b/e2e/solid-router/basic-solid-query/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { ErrorComponent, HeadContent, diff --git a/e2e/solid-router/basic-virtual-file-based/src/main.tsx b/e2e/solid-router/basic-virtual-file-based/src/main.tsx index 8128384193..4bd8c56ef3 100644 --- a/e2e/solid-router/basic-virtual-file-based/src/main.tsx +++ b/e2e/solid-router/basic-virtual-file-based/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider, createRouter } from '@tanstack/solid-router' import { routeTree } from './routeTree.gen' import './styles.css' diff --git a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/main.tsx b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/main.tsx index 8128384193..4bd8c56ef3 100644 --- a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/main.tsx +++ b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider, createRouter } from '@tanstack/solid-router' import { routeTree } from './routeTree.gen' import './styles.css' diff --git a/e2e/solid-router/basic/src/main.tsx b/e2e/solid-router/basic/src/main.tsx index 9604bca3cd..f11bf33e76 100644 --- a/e2e/solid-router/basic/src/main.tsx +++ b/e2e/solid-router/basic/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { ErrorComponent, HeadContent, diff --git a/e2e/solid-router/generator-cli-only/src/main.tsx b/e2e/solid-router/generator-cli-only/src/main.tsx index fc12c76570..6042bdab27 100644 --- a/e2e/solid-router/generator-cli-only/src/main.tsx +++ b/e2e/solid-router/generator-cli-only/src/main.tsx @@ -1,5 +1,5 @@ import { RouterProvider, createRouter } from '@tanstack/solid-router' -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { routeTree } from './routeTree.gen' import './styles.css' diff --git a/e2e/solid-router/js-only-file-based/src/main.jsx b/e2e/solid-router/js-only-file-based/src/main.jsx index 0e691e3e3c..d6284000dd 100644 --- a/e2e/solid-router/js-only-file-based/src/main.jsx +++ b/e2e/solid-router/js-only-file-based/src/main.jsx @@ -1,6 +1,6 @@ import { RouterProvider, createRouter } from '@tanstack/solid-router' import { routeTree } from './routeTree.gen' -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import './styles.css' // Set up a Router instance diff --git a/e2e/solid-router/rspack-basic-file-based/src/index.tsx b/e2e/solid-router/rspack-basic-file-based/src/index.tsx index 3403ff7cbf..ca62d498c7 100644 --- a/e2e/solid-router/rspack-basic-file-based/src/index.tsx +++ b/e2e/solid-router/rspack-basic-file-based/src/index.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import App from './app' const rootEl = document.getElementById('root') diff --git a/e2e/solid-router/rspack-basic-virtual-named-export-config-file-based/src/index.tsx b/e2e/solid-router/rspack-basic-virtual-named-export-config-file-based/src/index.tsx index 3403ff7cbf..ca62d498c7 100644 --- a/e2e/solid-router/rspack-basic-virtual-named-export-config-file-based/src/index.tsx +++ b/e2e/solid-router/rspack-basic-virtual-named-export-config-file-based/src/index.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import App from './app' const rootEl = document.getElementById('root') diff --git a/e2e/solid-router/scroll-restoration-sandbox-vite/src/main.tsx b/e2e/solid-router/scroll-restoration-sandbox-vite/src/main.tsx index 3694995e1f..da67593173 100644 --- a/e2e/solid-router/scroll-restoration-sandbox-vite/src/main.tsx +++ b/e2e/solid-router/scroll-restoration-sandbox-vite/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider, createHashHistory, diff --git a/e2e/solid-router/scroll-restoration-sandbox-vite/src/routes/__root.tsx b/e2e/solid-router/scroll-restoration-sandbox-vite/src/routes/__root.tsx index 9f76b37ef9..6aa1f1dd5c 100644 --- a/e2e/solid-router/scroll-restoration-sandbox-vite/src/routes/__root.tsx +++ b/e2e/solid-router/scroll-restoration-sandbox-vite/src/routes/__root.tsx @@ -5,7 +5,7 @@ import { createRootRoute, linkOptions, } from '@tanstack/solid-router' -import { Dynamic } from 'solid-js/web' +import { Dynamic } from '@solidjs/web' import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' export const Route = createRootRoute({ diff --git a/e2e/solid-router/sentry-integration/src/main.tsx b/e2e/solid-router/sentry-integration/src/main.tsx index 2ed8e476a6..36a5b2d596 100644 --- a/e2e/solid-router/sentry-integration/src/main.tsx +++ b/e2e/solid-router/sentry-integration/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { tanstackRouterBrowserTracingIntegration } from '@sentry/solid/tanstackrouter' import * as Sentry from '@sentry/solid' diff --git a/e2e/solid-router/view-transitions/src/main.tsx b/e2e/solid-router/view-transitions/src/main.tsx index 740315c011..9abe826c95 100644 --- a/e2e/solid-router/view-transitions/src/main.tsx +++ b/e2e/solid-router/view-transitions/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider, createRouter } from '@tanstack/solid-router' import { routeTree } from './routeTree.gen' import './styles.css' diff --git a/e2e/solid-start/basic-auth/src/routes/__root.tsx b/e2e/solid-start/basic-auth/src/routes/__root.tsx index 3a3392e922..f3babe4d89 100644 --- a/e2e/solid-start/basic-auth/src/routes/__root.tsx +++ b/e2e/solid-start/basic-auth/src/routes/__root.tsx @@ -10,7 +10,7 @@ import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' import { createServerFn } from '@tanstack/solid-start' import type * as Solid from 'solid-js' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import { DefaultCatchBoundary } from '~/components/DefaultCatchBoundary.js' import { NotFound } from '~/components/NotFound.js' import appCss from '~/styles/app.css?url' diff --git a/e2e/solid-start/basic-cloudflare/src/routes/__root.tsx b/e2e/solid-start/basic-cloudflare/src/routes/__root.tsx index adbafbc394..cd3a1c2bdb 100644 --- a/e2e/solid-start/basic-cloudflare/src/routes/__root.tsx +++ b/e2e/solid-start/basic-cloudflare/src/routes/__root.tsx @@ -6,7 +6,7 @@ import { createRootRoute, } from '@tanstack/solid-router' import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import type * as Solid from 'solid-js' import { DefaultCatchBoundary } from '~/components/DefaultCatchBoundary' import { NotFound } from '~/components/NotFound' diff --git a/e2e/solid-start/basic-solid-query/src/routes/__root.tsx b/e2e/solid-start/basic-solid-query/src/routes/__root.tsx index bea617a9d1..c7951d1e1c 100644 --- a/e2e/solid-start/basic-solid-query/src/routes/__root.tsx +++ b/e2e/solid-start/basic-solid-query/src/routes/__root.tsx @@ -7,7 +7,7 @@ import { createRootRouteWithContext, } from '@tanstack/solid-router' import { TanStackRouterDevtoolsInProd } from '@tanstack/solid-router-devtools' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import type { QueryClient } from '@tanstack/solid-query' import { DefaultCatchBoundary } from '~/components/DefaultCatchBoundary' import { NotFound } from '~/components/NotFound' diff --git a/e2e/solid-start/basic-tsr-config/src/app/routes/__root.tsx b/e2e/solid-start/basic-tsr-config/src/app/routes/__root.tsx index 8a55678998..4571b78b6a 100644 --- a/e2e/solid-start/basic-tsr-config/src/app/routes/__root.tsx +++ b/e2e/solid-start/basic-tsr-config/src/app/routes/__root.tsx @@ -5,7 +5,7 @@ import { createRootRoute, } from '@tanstack/solid-router' import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' export const Route = createRootRoute({ head: () => ({ diff --git a/e2e/solid-start/basic/src/client.tsx b/e2e/solid-start/basic/src/client.tsx index 0e10259d30..44e2d25d2e 100644 --- a/e2e/solid-start/basic/src/client.tsx +++ b/e2e/solid-start/basic/src/client.tsx @@ -1,6 +1,6 @@ // DO NOT DELETE THIS FILE!!! // This file is a good smoke test to make sure the custom client entry is working -import { hydrate } from 'solid-js/web' +import { hydrate } from '@solidjs/web' import { StartClient, hydrateStart } from '@tanstack/solid-start/client' console.log("[client-entry]: using custom client entry in 'src/client.tsx'") diff --git a/e2e/solid-start/basic/src/routes/__root.tsx b/e2e/solid-start/basic/src/routes/__root.tsx index 3b1ec274f5..f98f8132c6 100644 --- a/e2e/solid-start/basic/src/routes/__root.tsx +++ b/e2e/solid-start/basic/src/routes/__root.tsx @@ -8,7 +8,7 @@ import { } from '@tanstack/solid-router' import { TanStackRouterDevtoolsInProd } from '@tanstack/solid-router-devtools' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import { NotFound } from '~/components/NotFound' import appCss from '~/styles/app.css?url' import { seo } from '~/utils/seo' diff --git a/e2e/solid-start/csp/src/routes/__root.tsx b/e2e/solid-start/csp/src/routes/__root.tsx index 82faa1929d..2d12144704 100644 --- a/e2e/solid-start/csp/src/routes/__root.tsx +++ b/e2e/solid-start/csp/src/routes/__root.tsx @@ -4,7 +4,7 @@ import { Outlet, Scripts, } from '@tanstack/solid-router' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' export const Route = createRootRoute({ headers: ({ ssr }) => { diff --git a/e2e/solid-start/css-modules/src/routes/__root.tsx b/e2e/solid-start/css-modules/src/routes/__root.tsx index 9ee18b1a5a..d0035d957d 100644 --- a/e2e/solid-start/css-modules/src/routes/__root.tsx +++ b/e2e/solid-start/css-modules/src/routes/__root.tsx @@ -5,7 +5,7 @@ import { Scripts, createRootRoute, } from '@tanstack/solid-router' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' export const Route = createRootRoute({ head: () => ({ diff --git a/e2e/solid-start/custom-basepath/src/routes/__root.tsx b/e2e/solid-start/custom-basepath/src/routes/__root.tsx index bd7fa92f5e..9f0e7ad292 100644 --- a/e2e/solid-start/custom-basepath/src/routes/__root.tsx +++ b/e2e/solid-start/custom-basepath/src/routes/__root.tsx @@ -7,7 +7,7 @@ import { } from '@tanstack/solid-router' import { TanStackRouterDevtoolsInProd } from '@tanstack/solid-router-devtools' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import { NotFound } from '~/components/NotFound' import appCss from '~/styles/app.css?url' import { seo } from '~/utils/seo' diff --git a/e2e/solid-start/query-integration/src/routes/__root.tsx b/e2e/solid-start/query-integration/src/routes/__root.tsx index faa842e58e..7a9e7e5872 100644 --- a/e2e/solid-start/query-integration/src/routes/__root.tsx +++ b/e2e/solid-start/query-integration/src/routes/__root.tsx @@ -6,7 +6,7 @@ import { createRootRouteWithContext, } from '@tanstack/solid-router' import { TanStackRouterDevtoolsInProd } from '@tanstack/solid-router-devtools' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import type { QueryClient } from '@tanstack/solid-query' import appCss from '~/styles/app.css?url' diff --git a/e2e/solid-start/scroll-restoration/src/routes/__root.tsx b/e2e/solid-start/scroll-restoration/src/routes/__root.tsx index edd079c0a8..062d3afd60 100644 --- a/e2e/solid-start/scroll-restoration/src/routes/__root.tsx +++ b/e2e/solid-start/scroll-restoration/src/routes/__root.tsx @@ -6,7 +6,7 @@ import { createRootRoute, linkOptions, } from '@tanstack/solid-router' -import { Dynamic, HydrationScript } from 'solid-js/web' +import { Dynamic, HydrationScript } from '@solidjs/web' import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' import { NotFound } from '~/components/NotFound' import appCss from '~/styles/app.css?url' diff --git a/e2e/solid-start/selective-ssr/src/routes/__root.tsx b/e2e/solid-start/selective-ssr/src/routes/__root.tsx index 59fc3c9082..8fa51d62a1 100644 --- a/e2e/solid-start/selective-ssr/src/routes/__root.tsx +++ b/e2e/solid-start/selective-ssr/src/routes/__root.tsx @@ -9,7 +9,7 @@ import { useRouterState, } from '@tanstack/solid-router' import { z } from 'zod' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import type * as Solid from 'solid-js' import { ssrSchema } from '~/search' import appCss from '~/styles/app.css?url' diff --git a/e2e/solid-start/serialization-adapters/src/routes/__root.tsx b/e2e/solid-start/serialization-adapters/src/routes/__root.tsx index efd3a0abd5..3b6994ec68 100644 --- a/e2e/solid-start/serialization-adapters/src/routes/__root.tsx +++ b/e2e/solid-start/serialization-adapters/src/routes/__root.tsx @@ -8,7 +8,7 @@ import { useRouterState, } from '@tanstack/solid-router' import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import type { JSX } from 'solid-js' import appCss from '~/styles/app.css?url' diff --git a/e2e/solid-start/server-functions/src/routes/__root.tsx b/e2e/solid-start/server-functions/src/routes/__root.tsx index d12851644b..e98b551058 100644 --- a/e2e/solid-start/server-functions/src/routes/__root.tsx +++ b/e2e/solid-start/server-functions/src/routes/__root.tsx @@ -6,7 +6,7 @@ import { } from '@tanstack/solid-router' import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import { NotFound } from '~/components/NotFound' import appCss from '~/styles/app.css?url' diff --git a/e2e/solid-start/server-routes/src/routes/__root.tsx b/e2e/solid-start/server-routes/src/routes/__root.tsx index d12851644b..e98b551058 100644 --- a/e2e/solid-start/server-routes/src/routes/__root.tsx +++ b/e2e/solid-start/server-routes/src/routes/__root.tsx @@ -6,7 +6,7 @@ import { } from '@tanstack/solid-router' import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import { NotFound } from '~/components/NotFound' import appCss from '~/styles/app.css?url' diff --git a/e2e/solid-start/spa-mode/src/routes/__root.tsx b/e2e/solid-start/spa-mode/src/routes/__root.tsx index 02006e04e7..3075200027 100644 --- a/e2e/solid-start/spa-mode/src/routes/__root.tsx +++ b/e2e/solid-start/spa-mode/src/routes/__root.tsx @@ -9,7 +9,7 @@ import { useRouterState, } from '@tanstack/solid-router' import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import type * as Solid from 'solid-js' import appCss from '~/styles/app.css?url' diff --git a/e2e/solid-start/website/src/routes/__root.tsx b/e2e/solid-start/website/src/routes/__root.tsx index d91fca5749..360200dab0 100644 --- a/e2e/solid-start/website/src/routes/__root.tsx +++ b/e2e/solid-start/website/src/routes/__root.tsx @@ -6,7 +6,7 @@ import { createRootRoute, } from '@tanstack/solid-router' import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import { NotFound } from '~/components/NotFound' import appCss from '~/styles/app.css?url' import { seo } from '~/utils/seo' diff --git a/examples/solid/authenticated-routes-firebase/src/main.tsx b/examples/solid/authenticated-routes-firebase/src/main.tsx index d8758ea388..7e750f491c 100644 --- a/examples/solid/authenticated-routes-firebase/src/main.tsx +++ b/examples/solid/authenticated-routes-firebase/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider, createRouter } from '@tanstack/solid-router' import { routeTree } from './routeTree.gen' diff --git a/examples/solid/authenticated-routes/src/main.tsx b/examples/solid/authenticated-routes/src/main.tsx index b708360887..7b63807bba 100644 --- a/examples/solid/authenticated-routes/src/main.tsx +++ b/examples/solid/authenticated-routes/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider, createRouter } from '@tanstack/solid-router' import { routeTree } from './routeTree.gen' diff --git a/examples/solid/basic-default-search-params/src/main.tsx b/examples/solid/basic-default-search-params/src/main.tsx index 01d37c57d0..46db430097 100644 --- a/examples/solid/basic-default-search-params/src/main.tsx +++ b/examples/solid/basic-default-search-params/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { ErrorComponent, Link, diff --git a/examples/solid/basic-devtools-panel/src/main.tsx b/examples/solid/basic-devtools-panel/src/main.tsx index 48d0840660..21b9650396 100644 --- a/examples/solid/basic-devtools-panel/src/main.tsx +++ b/examples/solid/basic-devtools-panel/src/main.tsx @@ -8,7 +8,7 @@ import { createRootRoute, } from '@tanstack/solid-router' import { TanStackRouterDevtoolsPanel } from '@tanstack/solid-router-devtools' -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' const rootRoute = createRootRoute({ component: () => ( diff --git a/examples/solid/basic-file-based/src/main.tsx b/examples/solid/basic-file-based/src/main.tsx index 8128384193..4bd8c56ef3 100644 --- a/examples/solid/basic-file-based/src/main.tsx +++ b/examples/solid/basic-file-based/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider, createRouter } from '@tanstack/solid-router' import { routeTree } from './routeTree.gen' import './styles.css' diff --git a/examples/solid/basic-non-nested-devtools/src/main.tsx b/examples/solid/basic-non-nested-devtools/src/main.tsx index 1ee0345cc9..bc9b56cd90 100644 --- a/examples/solid/basic-non-nested-devtools/src/main.tsx +++ b/examples/solid/basic-non-nested-devtools/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { ErrorComponent, Link, diff --git a/examples/solid/basic-solid-query-file-based/src/main.tsx b/examples/solid/basic-solid-query-file-based/src/main.tsx index 7f1d2165f1..6f64a152de 100644 --- a/examples/solid/basic-solid-query-file-based/src/main.tsx +++ b/examples/solid/basic-solid-query-file-based/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider, createRouter } from '@tanstack/solid-router' import { QueryClient, QueryClientProvider } from '@tanstack/solid-query' import { routeTree } from './routeTree.gen' diff --git a/examples/solid/basic-solid-query/src/main.tsx b/examples/solid/basic-solid-query/src/main.tsx index 73a4a672b5..0b51d60c01 100644 --- a/examples/solid/basic-solid-query/src/main.tsx +++ b/examples/solid/basic-solid-query/src/main.tsx @@ -15,7 +15,7 @@ import { useQuery, } from '@tanstack/solid-query' import './styles.css' -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { SolidQueryDevtools } from '@tanstack/solid-query-devtools' import { createEffect, createMemo } from 'solid-js' import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' diff --git a/examples/solid/basic-ssr-file-based/src/entry-client.tsx b/examples/solid/basic-ssr-file-based/src/entry-client.tsx index 8cbc879670..c7dae8d650 100644 --- a/examples/solid/basic-ssr-file-based/src/entry-client.tsx +++ b/examples/solid/basic-ssr-file-based/src/entry-client.tsx @@ -1,5 +1,5 @@ import { RouterClient } from '@tanstack/solid-router/ssr/client' -import { hydrate } from 'solid-js/web' +import { hydrate } from '@solidjs/web' import { createRouter } from './router' const router = createRouter() diff --git a/examples/solid/basic-ssr-streaming-file-based/src/entry-client.tsx b/examples/solid/basic-ssr-streaming-file-based/src/entry-client.tsx index 8cbc879670..c7dae8d650 100644 --- a/examples/solid/basic-ssr-streaming-file-based/src/entry-client.tsx +++ b/examples/solid/basic-ssr-streaming-file-based/src/entry-client.tsx @@ -1,5 +1,5 @@ import { RouterClient } from '@tanstack/solid-router/ssr/client' -import { hydrate } from 'solid-js/web' +import { hydrate } from '@solidjs/web' import { createRouter } from './router' const router = createRouter() diff --git a/examples/solid/basic-virtual-file-based/src/main.tsx b/examples/solid/basic-virtual-file-based/src/main.tsx index 8128384193..4bd8c56ef3 100644 --- a/examples/solid/basic-virtual-file-based/src/main.tsx +++ b/examples/solid/basic-virtual-file-based/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider, createRouter } from '@tanstack/solid-router' import { routeTree } from './routeTree.gen' import './styles.css' diff --git a/examples/solid/basic-virtual-inside-file-based/src/main.tsx b/examples/solid/basic-virtual-inside-file-based/src/main.tsx index 8128384193..4bd8c56ef3 100644 --- a/examples/solid/basic-virtual-inside-file-based/src/main.tsx +++ b/examples/solid/basic-virtual-inside-file-based/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider, createRouter } from '@tanstack/solid-router' import { routeTree } from './routeTree.gen' import './styles.css' diff --git a/examples/solid/basic/src/main.tsx b/examples/solid/basic/src/main.tsx index 53d9959cc3..b02b0f2206 100644 --- a/examples/solid/basic/src/main.tsx +++ b/examples/solid/basic/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { ErrorComponent, Link, diff --git a/examples/solid/deferred-data/src/main.tsx b/examples/solid/deferred-data/src/main.tsx index f189a2e1c4..4a670b7e0b 100644 --- a/examples/solid/deferred-data/src/main.tsx +++ b/examples/solid/deferred-data/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { Suspense } from 'solid-js' import { Await, diff --git a/examples/solid/i18n-paraglide/src/main.tsx b/examples/solid/i18n-paraglide/src/main.tsx index 6847c9cbdc..6f2e51f69e 100644 --- a/examples/solid/i18n-paraglide/src/main.tsx +++ b/examples/solid/i18n-paraglide/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider, createRouter } from '@tanstack/solid-router' import './styles.css' // Import the generated route tree diff --git a/examples/solid/kitchen-sink-file-based/src/main.tsx b/examples/solid/kitchen-sink-file-based/src/main.tsx index 2ebe009eed..8742a88300 100644 --- a/examples/solid/kitchen-sink-file-based/src/main.tsx +++ b/examples/solid/kitchen-sink-file-based/src/main.tsx @@ -9,7 +9,7 @@ import { Spinner } from './components/Spinner' import { routeTree } from './routeTree.gen' import { useSessionStorage } from './hooks/useSessionStorage' import './styles.css' -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' // diff --git a/examples/solid/kitchen-sink-solid-query-file-based/src/main.tsx b/examples/solid/kitchen-sink-solid-query-file-based/src/main.tsx index b7b0c1d5d0..5f27f1b774 100644 --- a/examples/solid/kitchen-sink-solid-query-file-based/src/main.tsx +++ b/examples/solid/kitchen-sink-solid-query-file-based/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { ErrorComponent, RouterProvider, diff --git a/examples/solid/kitchen-sink-solid-query/src/main.tsx b/examples/solid/kitchen-sink-solid-query/src/main.tsx index 7c4fe6ea1c..e1fbfb0f4e 100644 --- a/examples/solid/kitchen-sink-solid-query/src/main.tsx +++ b/examples/solid/kitchen-sink-solid-query/src/main.tsx @@ -1,6 +1,6 @@ /* eslint-disable @typescript-eslint/no-unnecessary-condition */ import * as Solid from 'solid-js' -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { ErrorComponent, Link, diff --git a/examples/solid/kitchen-sink/src/main.tsx b/examples/solid/kitchen-sink/src/main.tsx index 850e683189..561fa94794 100644 --- a/examples/solid/kitchen-sink/src/main.tsx +++ b/examples/solid/kitchen-sink/src/main.tsx @@ -1,5 +1,5 @@ /* eslint-disable @typescript-eslint/no-unnecessary-condition */ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { ErrorComponent, Link, diff --git a/examples/solid/large-file-based/src/main.tsx b/examples/solid/large-file-based/src/main.tsx index 07b1d8be85..c93206359d 100644 --- a/examples/solid/large-file-based/src/main.tsx +++ b/examples/solid/large-file-based/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider, createRouter } from '@tanstack/solid-router' import { QueryClient } from '@tanstack/solid-query' import { routeTree } from './routeTree.gen' diff --git a/examples/solid/location-masking/src/main.tsx b/examples/solid/location-masking/src/main.tsx index ed090265b9..7ee20a252e 100644 --- a/examples/solid/location-masking/src/main.tsx +++ b/examples/solid/location-masking/src/main.tsx @@ -1,5 +1,5 @@ import type { JSX } from 'solid-js' -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { ErrorComponent, Link, diff --git a/examples/solid/navigation-blocking/src/main.tsx b/examples/solid/navigation-blocking/src/main.tsx index 81a4028604..3b8c3031b3 100644 --- a/examples/solid/navigation-blocking/src/main.tsx +++ b/examples/solid/navigation-blocking/src/main.tsx @@ -1,5 +1,5 @@ import { createSignal } from 'solid-js' -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { Link, Outlet, diff --git a/examples/solid/quickstart-esbuild-file-based/src/main.tsx b/examples/solid/quickstart-esbuild-file-based/src/main.tsx index 58c2fcf308..45eeb1f759 100644 --- a/examples/solid/quickstart-esbuild-file-based/src/main.tsx +++ b/examples/solid/quickstart-esbuild-file-based/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider, createRouter } from '@tanstack/solid-router' import { routeTree } from './routeTree.gen' import './styles.css' diff --git a/examples/solid/quickstart-file-based/src/main.tsx b/examples/solid/quickstart-file-based/src/main.tsx index 8128384193..4bd8c56ef3 100644 --- a/examples/solid/quickstart-file-based/src/main.tsx +++ b/examples/solid/quickstart-file-based/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider, createRouter } from '@tanstack/solid-router' import { routeTree } from './routeTree.gen' import './styles.css' diff --git a/examples/solid/quickstart-rspack-file-based/src/index.tsx b/examples/solid/quickstart-rspack-file-based/src/index.tsx index 782382dcfd..c29380ee41 100644 --- a/examples/solid/quickstart-rspack-file-based/src/index.tsx +++ b/examples/solid/quickstart-rspack-file-based/src/index.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import App from './app' const rootElement = document.getElementById('root')! diff --git a/examples/solid/quickstart-webpack-file-based/src/index.tsx b/examples/solid/quickstart-webpack-file-based/src/index.tsx index 545d22a618..8e142a714d 100644 --- a/examples/solid/quickstart-webpack-file-based/src/index.tsx +++ b/examples/solid/quickstart-webpack-file-based/src/index.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import App from './app' import './styles.css' diff --git a/examples/solid/quickstart/src/main.tsx b/examples/solid/quickstart/src/main.tsx index 79daf132e3..3ed73749d2 100644 --- a/examples/solid/quickstart/src/main.tsx +++ b/examples/solid/quickstart/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { Link, Outlet, diff --git a/examples/solid/router-monorepo-simple-lazy/packages/app/src/main.tsx b/examples/solid/router-monorepo-simple-lazy/packages/app/src/main.tsx index 91ee95bd38..46aebbe69f 100644 --- a/examples/solid/router-monorepo-simple-lazy/packages/app/src/main.tsx +++ b/examples/solid/router-monorepo-simple-lazy/packages/app/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider } from '@tanstack/solid-router' import { router } from '@router-solid-mono-simple-lazy/router' import { RootComponent } from './rootComponent' diff --git a/examples/solid/router-monorepo-simple-lazy/packages/router/vite.config.ts b/examples/solid/router-monorepo-simple-lazy/packages/router/vite.config.ts index 42ec59324c..2cc7d96888 100644 --- a/examples/solid/router-monorepo-simple-lazy/packages/router/vite.config.ts +++ b/examples/solid/router-monorepo-simple-lazy/packages/router/vite.config.ts @@ -31,7 +31,7 @@ export default defineConfig({ }, rollupOptions: { // External packages that should not be bundled into your library. - external: ['solid-js', 'solid-js/web', '@tanstack/solid-router'], + external: ['solid-js', '@solidjs/web', '@tanstack/solid-router'], }, }, }) diff --git a/examples/solid/router-monorepo-simple/packages/app/src/main.tsx b/examples/solid/router-monorepo-simple/packages/app/src/main.tsx index d50c77774f..bad3c369fa 100644 --- a/examples/solid/router-monorepo-simple/packages/app/src/main.tsx +++ b/examples/solid/router-monorepo-simple/packages/app/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider } from '@tanstack/solid-router' import { Outlet, router } from '@router-solid-mono-simple/router' import { diff --git a/examples/solid/router-monorepo-simple/packages/post-feature/vite.config.ts b/examples/solid/router-monorepo-simple/packages/post-feature/vite.config.ts index 74360e2dd0..d91277ff61 100644 --- a/examples/solid/router-monorepo-simple/packages/post-feature/vite.config.ts +++ b/examples/solid/router-monorepo-simple/packages/post-feature/vite.config.ts @@ -33,7 +33,7 @@ export default defineConfig({ // External packages that should not be bundled into your library. external: [ 'solid-js', - 'solid-js/web', + '@solidjs/web', '@tanstack/solid-router', '@router-solid-mono-simple/post-feature', '@router-solid-mono-simple/router', diff --git a/examples/solid/router-monorepo-simple/packages/router/vite.config.ts b/examples/solid/router-monorepo-simple/packages/router/vite.config.ts index 42ec59324c..2cc7d96888 100644 --- a/examples/solid/router-monorepo-simple/packages/router/vite.config.ts +++ b/examples/solid/router-monorepo-simple/packages/router/vite.config.ts @@ -31,7 +31,7 @@ export default defineConfig({ }, rollupOptions: { // External packages that should not be bundled into your library. - external: ['solid-js', 'solid-js/web', '@tanstack/solid-router'], + external: ['solid-js', '@solidjs/web', '@tanstack/solid-router'], }, }, }) diff --git a/examples/solid/router-monorepo-solid-query/packages/app/src/main.tsx b/examples/solid/router-monorepo-solid-query/packages/app/src/main.tsx index 8740ce06a7..fe84daf44f 100644 --- a/examples/solid/router-monorepo-solid-query/packages/app/src/main.tsx +++ b/examples/solid/router-monorepo-solid-query/packages/app/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider } from '@tanstack/solid-router' import { QueryClientProvider } from '@tanstack/solid-query' import { queryClient, router } from '@router-solid-mono-solid-query/router' diff --git a/examples/solid/router-monorepo-solid-query/packages/post-feature/vite.config.ts b/examples/solid/router-monorepo-solid-query/packages/post-feature/vite.config.ts index a195b2687d..934794687b 100644 --- a/examples/solid/router-monorepo-solid-query/packages/post-feature/vite.config.ts +++ b/examples/solid/router-monorepo-solid-query/packages/post-feature/vite.config.ts @@ -33,7 +33,7 @@ export default defineConfig({ // External packages that should not be bundled into your library. external: [ 'solid-js', - 'solid-js/web', + '@solidjs/web', '@tanstack/solid-query', '@tanstack/solid-router', '@router-solid-mono-solid-query/post-query', diff --git a/examples/solid/router-monorepo-solid-query/packages/post-query/vite.config.ts b/examples/solid/router-monorepo-solid-query/packages/post-query/vite.config.ts index ca7192f9e9..ec2340b66a 100644 --- a/examples/solid/router-monorepo-solid-query/packages/post-query/vite.config.ts +++ b/examples/solid/router-monorepo-solid-query/packages/post-query/vite.config.ts @@ -31,7 +31,7 @@ export default defineConfig({ // External packages that should not be bundled into your library. external: [ 'solid-js', - 'solid-js/web', + '@solidjs/web', '@tanstack/solid-query', 'redaxios', ], diff --git a/examples/solid/router-monorepo-solid-query/packages/router/vite.config.ts b/examples/solid/router-monorepo-solid-query/packages/router/vite.config.ts index 438ad4b27f..0fbdf7fb75 100644 --- a/examples/solid/router-monorepo-solid-query/packages/router/vite.config.ts +++ b/examples/solid/router-monorepo-solid-query/packages/router/vite.config.ts @@ -35,7 +35,7 @@ export default defineConfig({ // External packages that should not be bundled into your library. external: [ 'solid-js', - 'solid-js/web', + '@solidjs/web', '@tanstack/solid-query', '@tanstack/solid-router', '@router-solid-mono-solid-query/post-query', diff --git a/examples/solid/scroll-restoration/src/main.tsx b/examples/solid/scroll-restoration/src/main.tsx index c33017ca7e..b514a45228 100644 --- a/examples/solid/scroll-restoration/src/main.tsx +++ b/examples/solid/scroll-restoration/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { Link, Outlet, diff --git a/examples/solid/search-validator-adapters/src/main.tsx b/examples/solid/search-validator-adapters/src/main.tsx index 0d3d2e1b42..be9e28bcb0 100644 --- a/examples/solid/search-validator-adapters/src/main.tsx +++ b/examples/solid/search-validator-adapters/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider, createRouter } from '@tanstack/solid-router' import { QueryClient, QueryClientProvider } from '@tanstack/solid-query' import { routeTree } from './routeTree.gen' diff --git a/examples/solid/start-basic-auth/src/routes/__root.tsx b/examples/solid/start-basic-auth/src/routes/__root.tsx index 3aa0bfa18b..8951a86f55 100644 --- a/examples/solid/start-basic-auth/src/routes/__root.tsx +++ b/examples/solid/start-basic-auth/src/routes/__root.tsx @@ -8,7 +8,7 @@ import { } from '@tanstack/solid-router' import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' import { createServerFn } from '@tanstack/solid-start' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import type * as Solid from 'solid-js' import { DefaultCatchBoundary } from '~/components/DefaultCatchBoundary.js' import { NotFound } from '~/components/NotFound.js' diff --git a/examples/solid/start-basic-authjs/src/routes/__root.tsx b/examples/solid/start-basic-authjs/src/routes/__root.tsx index 29167dea72..27b90dc391 100644 --- a/examples/solid/start-basic-authjs/src/routes/__root.tsx +++ b/examples/solid/start-basic-authjs/src/routes/__root.tsx @@ -10,7 +10,7 @@ import { import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' import { createServerFn } from '@tanstack/solid-start' import { getRequest } from '@tanstack/solid-start/server' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import { Show } from 'solid-js' import { getSession } from 'start-authjs' import type { JSX } from 'solid-js' diff --git a/examples/solid/start-basic-cloudflare/src/routes/__root.tsx b/examples/solid/start-basic-cloudflare/src/routes/__root.tsx index a8b324f1b3..883104183d 100644 --- a/examples/solid/start-basic-cloudflare/src/routes/__root.tsx +++ b/examples/solid/start-basic-cloudflare/src/routes/__root.tsx @@ -6,7 +6,7 @@ import { createRootRoute, } from '@tanstack/solid-router' import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import type * as Solid from 'solid-js' import { DefaultCatchBoundary } from '~/components/DefaultCatchBoundary' import { NotFound } from '~/components/NotFound' diff --git a/examples/solid/start-basic-netlify/src/routes/__root.tsx b/examples/solid/start-basic-netlify/src/routes/__root.tsx index a8b324f1b3..883104183d 100644 --- a/examples/solid/start-basic-netlify/src/routes/__root.tsx +++ b/examples/solid/start-basic-netlify/src/routes/__root.tsx @@ -6,7 +6,7 @@ import { createRootRoute, } from '@tanstack/solid-router' import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import type * as Solid from 'solid-js' import { DefaultCatchBoundary } from '~/components/DefaultCatchBoundary' import { NotFound } from '~/components/NotFound' diff --git a/examples/solid/start-basic-nitro/src/routes/__root.tsx b/examples/solid/start-basic-nitro/src/routes/__root.tsx index a8b324f1b3..883104183d 100644 --- a/examples/solid/start-basic-nitro/src/routes/__root.tsx +++ b/examples/solid/start-basic-nitro/src/routes/__root.tsx @@ -6,7 +6,7 @@ import { createRootRoute, } from '@tanstack/solid-router' import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import type * as Solid from 'solid-js' import { DefaultCatchBoundary } from '~/components/DefaultCatchBoundary' import { NotFound } from '~/components/NotFound' diff --git a/examples/solid/start-basic-solid-query/src/routes/__root.tsx b/examples/solid/start-basic-solid-query/src/routes/__root.tsx index 584d35be30..3f4957f154 100644 --- a/examples/solid/start-basic-solid-query/src/routes/__root.tsx +++ b/examples/solid/start-basic-solid-query/src/routes/__root.tsx @@ -8,7 +8,7 @@ import { } from '@tanstack/solid-router' import { SolidQueryDevtools } from '@tanstack/solid-query-devtools' import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import type * as Solid from 'solid-js' import type { QueryClient } from '@tanstack/solid-query' import { DefaultCatchBoundary } from '~/components/DefaultCatchBoundary' diff --git a/examples/solid/start-basic-static/src/routes/__root.tsx b/examples/solid/start-basic-static/src/routes/__root.tsx index fd827e635a..71c461816d 100644 --- a/examples/solid/start-basic-static/src/routes/__root.tsx +++ b/examples/solid/start-basic-static/src/routes/__root.tsx @@ -7,7 +7,7 @@ import { createRootRoute, } from '@tanstack/solid-router' import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import type * as Solid from 'solid-js' import { DefaultCatchBoundary } from '~/components/DefaultCatchBoundary' import { NotFound } from '~/components/NotFound' diff --git a/examples/solid/start-basic/src/routes/__root.tsx b/examples/solid/start-basic/src/routes/__root.tsx index cec570e7a4..641084c8ee 100644 --- a/examples/solid/start-basic/src/routes/__root.tsx +++ b/examples/solid/start-basic/src/routes/__root.tsx @@ -6,7 +6,7 @@ import { createRootRoute, } from '@tanstack/solid-router' import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import type * as Solid from 'solid-js' import { DefaultCatchBoundary } from '~/components/DefaultCatchBoundary' import { NotFound } from '~/components/NotFound' diff --git a/examples/solid/start-bun/src/routes/__root.tsx b/examples/solid/start-bun/src/routes/__root.tsx index 99c515ded4..7c5ce8bd6c 100644 --- a/examples/solid/start-bun/src/routes/__root.tsx +++ b/examples/solid/start-bun/src/routes/__root.tsx @@ -2,7 +2,7 @@ import { TanStackDevtools } from '@tanstack/solid-devtools' import { HeadContent, Scripts, createRootRoute } from '@tanstack/solid-router' import { TanStackRouterDevtoolsPanel } from '@tanstack/solid-router-devtools' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import Header from '../components/Header' import appCss from '../styles.css?url' diff --git a/examples/solid/start-convex-better-auth/src/routes/__root.tsx b/examples/solid/start-convex-better-auth/src/routes/__root.tsx index 34e24068d3..ef1258ed4c 100644 --- a/examples/solid/start-convex-better-auth/src/routes/__root.tsx +++ b/examples/solid/start-convex-better-auth/src/routes/__root.tsx @@ -1,6 +1,6 @@ /// import { HeadContent, Scripts, createRootRoute } from '@tanstack/solid-router' -import { HydrationScript, Suspense } from 'solid-js/web' +import { HydrationScript, Suspense } from '@solidjs/web' import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' import type * as Solid from 'solid-js' import appCss from '~/styles/app.css?url' diff --git a/examples/solid/start-counter/src/routes/__root.tsx b/examples/solid/start-counter/src/routes/__root.tsx index 7b340ba2ce..0fa315d04f 100644 --- a/examples/solid/start-counter/src/routes/__root.tsx +++ b/examples/solid/start-counter/src/routes/__root.tsx @@ -5,7 +5,7 @@ import { Scripts, createRootRoute, } from '@tanstack/solid-router' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' import type * as Solid from 'solid-js' import appCss from '~/styles/app.css?url' diff --git a/examples/solid/start-i18n-paraglide/src/routes/__root.tsx b/examples/solid/start-i18n-paraglide/src/routes/__root.tsx index 39875ee9fe..6b281a271e 100644 --- a/examples/solid/start-i18n-paraglide/src/routes/__root.tsx +++ b/examples/solid/start-i18n-paraglide/src/routes/__root.tsx @@ -6,7 +6,7 @@ import { } from '@tanstack/solid-router' import { TanStackRouterDevtoolsPanel } from '@tanstack/solid-router-devtools' import { TanStackDevtools } from '@tanstack/solid-devtools' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import styles from '../styles.css?url' import type { JSX } from 'solid-js/jsx-runtime' import { getLocale, locales, setLocale } from '@/paraglide/runtime' diff --git a/examples/solid/start-streaming-data-from-server-functions/src/routes/__root.tsx b/examples/solid/start-streaming-data-from-server-functions/src/routes/__root.tsx index 389b99c143..34d006e50c 100644 --- a/examples/solid/start-streaming-data-from-server-functions/src/routes/__root.tsx +++ b/examples/solid/start-streaming-data-from-server-functions/src/routes/__root.tsx @@ -6,7 +6,7 @@ import { Scripts, createRootRoute, } from '@tanstack/solid-router' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import type { JSX } from 'solid-js' import appCss from '~/styles/app.css?url' diff --git a/examples/solid/start-supabase-basic/src/routes/__root.tsx b/examples/solid/start-supabase-basic/src/routes/__root.tsx index 1eb986feee..d1b8daf085 100644 --- a/examples/solid/start-supabase-basic/src/routes/__root.tsx +++ b/examples/solid/start-supabase-basic/src/routes/__root.tsx @@ -8,7 +8,7 @@ import { } from '@tanstack/solid-router' import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' import { createServerFn } from '@tanstack/solid-start' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import { DefaultCatchBoundary } from '../components/DefaultCatchBoundary' import { NotFound } from '../components/NotFound' import appCss from '../styles/app.css?url' diff --git a/examples/solid/start-tailwind-v4/src/routes/__root.tsx b/examples/solid/start-tailwind-v4/src/routes/__root.tsx index 8347bb3b5a..f83fcd6206 100644 --- a/examples/solid/start-tailwind-v4/src/routes/__root.tsx +++ b/examples/solid/start-tailwind-v4/src/routes/__root.tsx @@ -8,7 +8,7 @@ import { } from '@tanstack/solid-router' import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' import * as React from 'react' -import { HydrationScript } from 'solid-js/web' +import { HydrationScript } from '@solidjs/web' import type { JSX } from 'solid-js' import appCss from '~/styles/app.css?url' diff --git a/examples/solid/view-transitions/src/main.tsx b/examples/solid/view-transitions/src/main.tsx index 740315c011..9abe826c95 100644 --- a/examples/solid/view-transitions/src/main.tsx +++ b/examples/solid/view-transitions/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider, createRouter } from '@tanstack/solid-router' import { routeTree } from './routeTree.gen' import './styles.css' diff --git a/examples/solid/with-framer-motion/src/main.tsx b/examples/solid/with-framer-motion/src/main.tsx index 3015606710..e2f8302305 100644 --- a/examples/solid/with-framer-motion/src/main.tsx +++ b/examples/solid/with-framer-motion/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { Motion, Presence } from 'solid-motionone' import { ErrorComponent, diff --git a/examples/solid/with-trpc/src/main.tsx b/examples/solid/with-trpc/src/main.tsx index d99d3054d7..04e801986c 100644 --- a/examples/solid/with-trpc/src/main.tsx +++ b/examples/solid/with-trpc/src/main.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { RouterProvider, createRouter } from '@tanstack/solid-router' import { trpc } from './trpc' diff --git a/packages/router-devtools-core/src/FloatingTanStackRouterDevtools.tsx b/packages/router-devtools-core/src/FloatingTanStackRouterDevtools.tsx index f8eca4d4b7..5d00887766 100644 --- a/packages/router-devtools-core/src/FloatingTanStackRouterDevtools.tsx +++ b/packages/router-devtools-core/src/FloatingTanStackRouterDevtools.tsx @@ -1,7 +1,7 @@ import { clsx as cx } from 'clsx' import { createEffect, createMemo, createSignal } from 'solid-js' -import { Dynamic } from 'solid-js/web' +import { Dynamic } from '@solidjs/web' import { DevtoolsOnCloseContext } from './context' import { useIsMounted } from './utils' diff --git a/packages/router-devtools-core/src/TanStackRouterDevtoolsCore.tsx b/packages/router-devtools-core/src/TanStackRouterDevtoolsCore.tsx index 883d8c6d52..48eab1c880 100644 --- a/packages/router-devtools-core/src/TanStackRouterDevtoolsCore.tsx +++ b/packages/router-devtools-core/src/TanStackRouterDevtoolsCore.tsx @@ -1,5 +1,5 @@ import { createSignal, lazy } from 'solid-js' -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { ShadowDomTargetContext } from './context' import type { AnyRouter } from '@tanstack/router-core' import type { Signal } from 'solid-js' diff --git a/packages/router-devtools-core/src/TanStackRouterDevtoolsPanelCore.tsx b/packages/router-devtools-core/src/TanStackRouterDevtoolsPanelCore.tsx index 2d38ac4c3a..2d6aa284fb 100644 --- a/packages/router-devtools-core/src/TanStackRouterDevtoolsPanelCore.tsx +++ b/packages/router-devtools-core/src/TanStackRouterDevtoolsPanelCore.tsx @@ -1,4 +1,4 @@ -import { render } from 'solid-js/web' +import { render } from '@solidjs/web' import { createSignal, lazy } from 'solid-js' import { DevtoolsOnCloseContext, ShadowDomTargetContext } from './context' import type { JSX } from 'solid-js' diff --git a/packages/router-devtools-core/src/utils.tsx b/packages/router-devtools-core/src/utils.tsx index 8e497a09e9..968ef51f70 100644 --- a/packages/router-devtools-core/src/utils.tsx +++ b/packages/router-devtools-core/src/utils.tsx @@ -1,4 +1,4 @@ -import { Dynamic } from 'solid-js/web' +import { Dynamic } from '@solidjs/web' import { createEffect, createRenderEffect, createSignal } from 'solid-js' import { useTheme } from './theme' import useMediaQuery from './useMediaQuery' diff --git a/packages/router-devtools-core/vite.config.ts b/packages/router-devtools-core/vite.config.ts index 5fe3103dd1..d329bfb129 100644 --- a/packages/router-devtools-core/vite.config.ts +++ b/packages/router-devtools-core/vite.config.ts @@ -11,7 +11,7 @@ const merged = mergeConfig( tanstackViteConfig({ entry: './src/index.tsx', srcDir: './src', - bundledDeps: ['solid-js', 'solid-js/web'], + bundledDeps: ['solid-js', '@solidjs/web'], }), ) diff --git a/packages/solid-router/src/ClientOnly.tsx b/packages/solid-router/src/ClientOnly.tsx index 6ed10d267b..6fd4fb7249 100644 --- a/packages/solid-router/src/ClientOnly.tsx +++ b/packages/solid-router/src/ClientOnly.tsx @@ -58,7 +58,7 @@ export function ClientOnly(props: ClientOnlyProps) { */ export function useHydrated(): Solid.Accessor { const [hydrated, setHydrated] = Solid.createSignal(false) - Solid.onMount(() => { + Solid.onSettled(() => { setHydrated(true) }) return hydrated diff --git a/packages/solid-router/src/link.tsx b/packages/solid-router/src/link.tsx index c21949b7c1..524b40218b 100644 --- a/packages/solid-router/src/link.tsx +++ b/packages/solid-router/src/link.tsx @@ -135,7 +135,7 @@ export function useLinkProps< 'mask', 'reloadDocument', 'unsafeRelative', - ]) + ] as any) const currentLocation = useRouterState({ select: (s) => s.location, diff --git a/packages/solid-router/tests/disableGlobalCatchBoundary.test.tsx b/packages/solid-router/tests/disableGlobalCatchBoundary.test.tsx index 1f37b853f0..296a99e1d3 100644 --- a/packages/solid-router/tests/disableGlobalCatchBoundary.test.tsx +++ b/packages/solid-router/tests/disableGlobalCatchBoundary.test.tsx @@ -1,6 +1,6 @@ import { afterEach, describe, expect, test, vi } from 'vitest' import { cleanup, render, screen } from '@solidjs/testing-library' -import { ErrorBoundary } from 'solid-js' +import { Errored as ErrorBoundary } from 'solid-js' import { RouterProvider, createRootRoute, diff --git a/packages/solid-router/tests/link.bench.tsx b/packages/solid-router/tests/link.bench.tsx index 7d60d9ebd5..f9585db3a0 100644 --- a/packages/solid-router/tests/link.bench.tsx +++ b/packages/solid-router/tests/link.bench.tsx @@ -38,7 +38,7 @@ const InterpolatePathLink = ({ to, params, children, -}: Solid.PropsWithChildren) => { +}: Solid.ParentProps) => { const href = interpolatePath({ path: to, params }).interpolatedPath return {children} } @@ -46,7 +46,7 @@ const InterpolatePathLink = ({ const BuildLocationLink = ({ children, ...props -}: Solid.PropsWithChildren) => { +}: Solid.ParentProps) => { const router = useRouter() const { href } = router.buildLocation(props) return {children} diff --git a/packages/solid-router/tests/server/ClientOnly.test.tsx b/packages/solid-router/tests/server/ClientOnly.test.tsx index ee5623090f..a3a6ed6d06 100644 --- a/packages/solid-router/tests/server/ClientOnly.test.tsx +++ b/packages/solid-router/tests/server/ClientOnly.test.tsx @@ -1,5 +1,5 @@ import { describe, expect, it } from 'vitest' -import { renderToStringAsync } from 'solid-js/web' +import { renderToStringAsync } from '@solidjs/web' import { RouterProvider, createMemoryHistory, diff --git a/packages/solid-router/tests/server/Transitioner.test.tsx b/packages/solid-router/tests/server/Transitioner.test.tsx index 7afdd57058..74b0c9f081 100644 --- a/packages/solid-router/tests/server/Transitioner.test.tsx +++ b/packages/solid-router/tests/server/Transitioner.test.tsx @@ -1,5 +1,5 @@ import { describe, expect, it, vi } from 'vitest' -import { renderToStringAsync } from 'solid-js/web' +import { renderToStringAsync } from '@solidjs/web' import { createMemoryHistory, createRootRoute, diff --git a/packages/solid-start/src/default-entry/client.tsx b/packages/solid-start/src/default-entry/client.tsx index 143d2a35e1..d51241e534 100644 --- a/packages/solid-start/src/default-entry/client.tsx +++ b/packages/solid-start/src/default-entry/client.tsx @@ -1,4 +1,4 @@ -import { hydrate } from 'solid-js/web' +import { hydrate } from '@solidjs/web' import { StartClient, hydrateStart } from '@tanstack/solid-start/client' hydrateStart().then((router) => { From 42189fbaf7a94fd91df94402d11a63c3750d6350 Mon Sep 17 00:00:00 2001 From: Birk Skyum Date: Sat, 21 Feb 2026 02:34:47 +0100 Subject: [PATCH 010/218] update vite config --- packages/solid-router/tests/RouterProvider.test.tsx | 3 ++- packages/solid-router/tests/link.test.tsx | 11 ++++------- packages/solid-router/tests/routeContext.test.tsx | 2 +- packages/solid-router/vite.config.ts | 12 ++++++++++-- 4 files changed, 17 insertions(+), 11 deletions(-) diff --git a/packages/solid-router/tests/RouterProvider.test.tsx b/packages/solid-router/tests/RouterProvider.test.tsx index 2bc3395515..093c0ceecb 100644 --- a/packages/solid-router/tests/RouterProvider.test.tsx +++ b/packages/solid-router/tests/RouterProvider.test.tsx @@ -26,7 +26,8 @@ describe('RouterProvider', () => { { - return {props.children} + const Ctx = ctx as any + return {props.children} }} /> )) diff --git a/packages/solid-router/tests/link.test.tsx b/packages/solid-router/tests/link.test.tsx index d5c528c0ad..95fa04e986 100644 --- a/packages/solid-router/tests/link.test.tsx +++ b/packages/solid-router/tests/link.test.tsx @@ -3522,7 +3522,7 @@ describe('Link', () => { 'idle' | 'success' | 'error' >('idle') - Solid.onMount(() => { + Solid.onSettled(() => { const onLoad = async () => { try { await router.preloadRoute({ @@ -4720,12 +4720,9 @@ describe('createLink', () => { foo?: boolean overrideMeIfYouWant: string }> - > = (props) => { - const [local, rest] = Solid.splitProps(props, [ - 'active', - 'foo', - 'children', - ]) + > = (props: any) => { + const { active, foo, children, ...rest } = props; + const local = { active, foo, children }; return (
  • } right={ - + } > - {`${match.routeId === rootRouteId ? rootRouteId : match.pathname}`} + {`${match().routeId === rootRouteId ? rootRouteId : match().pathname}`}
  • diff --git a/packages/router-devtools-core/src/FloatingTanStackRouterDevtools.tsx b/packages/router-devtools-core/src/FloatingTanStackRouterDevtools.tsx index 5d00887766..c9cc6ae3a3 100644 --- a/packages/router-devtools-core/src/FloatingTanStackRouterDevtools.tsx +++ b/packages/router-devtools-core/src/FloatingTanStackRouterDevtools.tsx @@ -126,62 +126,70 @@ export function FloatingTanStackRouterDevtools({ const isButtonClosed = isOpen() ?? false - createEffect(() => { - setIsResolvedOpen(isOpen() ?? false) - }) + createEffect( + () => isOpen() ?? false, + (isOpenValue) => { + setIsResolvedOpen(isOpenValue) + }, + ) - createEffect(() => { - if (isResolvedOpen()) { - const previousValue = rootEl()?.parentElement?.style.paddingBottom + createEffect( + () => ({ isOpen: isResolvedOpen(), el: rootEl() }), + ({ isOpen: isOpenValue, el }) => { + if (isOpenValue) { + const previousValue = el?.parentElement?.style.paddingBottom - const run = () => { - const containerHeight = panelRef!.getBoundingClientRect().height - if (rootEl()?.parentElement) { + const run = () => { + const containerHeight = panelRef!.getBoundingClientRect().height + if (el?.parentElement) { + setRootEl((prev) => { + if (prev?.parentElement) { + prev.parentElement.style.paddingBottom = `${containerHeight}px` + } + return prev + }) + } + } + + run() + + if (typeof window !== 'undefined') { + window.addEventListener('resize', run) + + return () => { + window.removeEventListener('resize', run) + if (el?.parentElement && typeof previousValue === 'string') { + setRootEl((prev) => { + prev!.parentElement!.style.paddingBottom = previousValue + return prev + }) + } + } + } + } else { + // Reset padding when devtools are closed + if (el?.parentElement) { setRootEl((prev) => { if (prev?.parentElement) { - prev.parentElement.style.paddingBottom = `${containerHeight}px` + prev.parentElement.removeAttribute('style') } return prev }) } } + return + }, + ) - run() - - if (typeof window !== 'undefined') { - window.addEventListener('resize', run) - - return () => { - window.removeEventListener('resize', run) - if (rootEl()?.parentElement && typeof previousValue === 'string') { - setRootEl((prev) => { - prev!.parentElement!.style.paddingBottom = previousValue - return prev - }) - } - } + createEffect( + () => rootEl(), + (el) => { + if (el) { + const fontSize = getComputedStyle(el).fontSize + el.style.setProperty('--tsrd-font-size', fontSize) } - } else { - // Reset padding when devtools are closed - if (rootEl()?.parentElement) { - setRootEl((prev) => { - if (prev?.parentElement) { - prev.parentElement.removeAttribute('style') - } - return prev - }) - } - } - return - }) - - createEffect(() => { - if (rootEl()) { - const el = rootEl() - const fontSize = getComputedStyle(el!).fontSize - el?.style.setProperty('--tsrd-font-size', fontSize) - } - }) + }, + ) const { style: panelStyle = {}, ...otherPanelProps } = panelProps as { style?: Record @@ -239,7 +247,7 @@ export function FloatingTanStackRouterDevtools({ ref={setRootEl} class="TanStackRouterDevtools" > - {}), }} @@ -260,7 +268,7 @@ export function FloatingTanStackRouterDevtools({ {/* ) : (

    No router

    )} */} -
    + + ) +} + +type HydrationFallbackWindow = Window & { + __componentFallbackReady?: boolean + __componentFallbackPromise?: Promise +} + +function DelayedFallbackBox() { + if (typeof window !== 'undefined') { + const win = window as HydrationFallbackWindow + + if (!win.__componentFallbackReady) { + win.__componentFallbackPromise ??= new Promise((resolve) => { + win.setTimeout(() => { + win.__componentFallbackReady = true + resolve() + }, 1000) + }) + + throw win.__componentFallbackPromise + } + } + + return
    fallback child
    +} + +function ComponentHydrationPage() { + const [hydratedCallbacks, setHydratedCallbacks] = React.useState(0) + const [conditionReady, setConditionReady] = React.useState(false) + const [showClientFallbackBoundary, setShowClientFallbackBoundary] = + React.useState(false) + + return ( +
    +

    Component Deferred Hydration

    +
    + Manual test guide + + Pink buttons are server HTML that has not hydrated yet. Green buttons + have hydrated and should increment when clicked. Follow the notes + below to trigger each strategy intentionally. + +
    +

    {hydratedCallbacks}

    +

    + load and idle should become green + without interaction shortly after the page loads. +

    + + + + + + +
    + Scroll down to reveal the visible boundary +
    +

    + visible hydrates only after this button enters the + viewport. +

    + + + +

    + media hydrates when (min-width: 1px) + matches. interaction hydrates on hover, focus, pointer + down, or click intent. +

    + + + + + + +

    + Custom interaction boundaries below hydrate only for their configured + events: double-click for the single-event example, and right-click or + double-click for the multi-event example. The prefetch example should + download code on hover but hydrate on click. +

    + setHydratedCallbacks((count) => count + 1)} + > + + + + + + + + + + + + + + + + + + + + + + + +

    + never stays as server HTML forever on the initial page, + so clicking should not increment it. +

    + + {showClientFallbackBoundary ? ( + client fallback + } + > + + + ) : null} +
    + ) +} diff --git a/e2e/react-start/deferred-hydration/src/routes/css.tsx b/e2e/react-start/deferred-hydration/src/routes/css.tsx new file mode 100644 index 0000000000..2c01aa9e57 --- /dev/null +++ b/e2e/react-start/deferred-hydration/src/routes/css.tsx @@ -0,0 +1,57 @@ +import { createFileRoute } from '@tanstack/react-router' +import { Hydrate } from '@tanstack/react-start' +import { media, never, visible } from '@tanstack/react-start/hydration' +import outerStyles from './css/outer.module.css' +import deferredStyles from './css/deferred-only.module.css' +import sharedStyles from './css/shared.module.css' + +export const Route = createFileRoute('/css')({ + component: CssHydrationPage, +}) + +function CssHydrationPage() { + return ( +
    +
    +

    + CSS Deferred Hydration +

    +

    + CSS from deferred, never, shared, and nested Hydrate boundaries should + be available even before the client JavaScript hydrates those islands. +

    +
    +
    +
    + Outer CSS +
    +
    + Shared outer CSS +
    +
    + +
    + Deferred CSS +
    +
    + +
    + Never CSS +
    +
    + + +
    + Nested CSS +
    +
    +
    +
    + ) +} diff --git a/e2e/react-start/deferred-hydration/src/routes/css/deferred-only.module.css b/e2e/react-start/deferred-hydration/src/routes/css/deferred-only.module.css new file mode 100644 index 0000000000..05eafda03c --- /dev/null +++ b/e2e/react-start/deferred-hydration/src/routes/css/deferred-only.module.css @@ -0,0 +1,15 @@ +.deferredBox { + background-color: rgb(23, 45, 67); + color: rgb(255, 255, 255); + padding: 12px; +} + +.neverBox { + color: rgb(45, 67, 89); + padding: 12px; +} + +.nestedBox { + border-left: 5px solid rgb(67, 89, 123); + padding-left: 12px; +} diff --git a/e2e/react-start/deferred-hydration/src/routes/css/outer.module.css b/e2e/react-start/deferred-hydration/src/routes/css/outer.module.css new file mode 100644 index 0000000000..98ca5e0934 --- /dev/null +++ b/e2e/react-start/deferred-hydration/src/routes/css/outer.module.css @@ -0,0 +1,9 @@ +.heading { + color: rgb(11, 31, 53); +} + +.outerBox { + background-color: rgb(242, 250, 255); + color: rgb(12, 34, 56); + padding: 12px; +} diff --git a/e2e/react-start/deferred-hydration/src/routes/css/shared.module.css b/e2e/react-start/deferred-hydration/src/routes/css/shared.module.css new file mode 100644 index 0000000000..020da5d7ad --- /dev/null +++ b/e2e/react-start/deferred-hydration/src/routes/css/shared.module.css @@ -0,0 +1,4 @@ +.sharedBox { + border-top: 4px solid rgb(98, 76, 54); + margin-top: 8px; +} diff --git a/e2e/react-start/deferred-hydration/src/routes/enhanced.tsx b/e2e/react-start/deferred-hydration/src/routes/enhanced.tsx new file mode 100644 index 0000000000..628a5c4ae3 --- /dev/null +++ b/e2e/react-start/deferred-hydration/src/routes/enhanced.tsx @@ -0,0 +1,339 @@ +import { createFileRoute } from '@tanstack/react-router' +import * as React from 'react' +import { Hydrate } from '@tanstack/react-start' +import { interaction, media } from '@tanstack/react-start/hydration' +import { EnhancedNestedWidget } from '../shared/EnhancedNestedWidget' + +type EnhancedSearch = { + dynamic?: 'interaction' +} + +export const Route = createFileRoute('/enhanced')({ + validateSearch: (search: Record): EnhancedSearch => ({ + dynamic: search.dynamic === 'interaction' ? 'interaction' : undefined, + }), + component: EnhancedHydrationPage, +}) + +type DeferredGate = { + promise: Promise + resolve: () => void +} + +const clickIntent = interaction({ events: 'click' }) +const pointerOverIntent = interaction({ events: 'pointerover' }) +const doubleClickIntent = interaction({ events: 'dblclick' }) + +function createDeferredGate(): DeferredGate { + let resolve!: () => void + const promise = new Promise((next) => { + resolve = next + }) + return { promise, resolve } +} + +function useDeferredGate() { + const ref = React.useRef(undefined) + ref.current ??= createDeferredGate() + return ref.current +} + +function mergeStatus>( + setStatus: React.Dispatch>, + patch: Partial, +) { + setStatus((current) => ({ ...current, ...patch })) +} + +function InteractiveBox(props: { id: string; label: string }) { + const [count, setCount] = React.useState(0) + const [hydrated, setHydrated] = React.useState(false) + + React.useEffect(() => { + setHydrated(true) + }, []) + + return ( + + ) +} + +function DynamicWhenExamples() { + const search = Route.useSearch() + const searchDrivenHydration = React.useCallback( + () => (search.dynamic === 'interaction' ? clickIntent : doubleClickIntent), + [search.dynamic], + ) + + return ( + <> +

    + Dynamic callbacks are client-only. The first boundary always hydrates on + click; the second reads typed router search state before choosing its + interaction event. +

    + clickIntent}> + + + + + + + ) +} + +function SplitPrefetchExample() { + const gate = useDeferredGate() + const [status, setStatus] = React.useState({ + wait: 'idle', + preload: 'idle', + query: 'idle', + }) + + return ( + <> +

    {status.wait}

    +

    {status.preload}

    +

    {status.query}

    + + { + mergeStatus(setStatus, { + query: element ? 'element' : 'missing-element', + wait: 'waiting', + }) + + const reason = await waitFor(pointerOverIntent) + mergeStatus(setStatus, { wait: reason }) + if (reason === 'abort' || signal.aborted) return + + await preload() + mergeStatus(setStatus, { preload: 'done' }) + await gate.promise + mergeStatus(setStatus, { query: 'done' }) + }} + > + + + + ) +} + +function FireAndForgetPrefetchExample() { + const gate = useDeferredGate() + const [status, setStatus] = React.useState({ + wait: 'idle', + work: 'idle', + query: 'idle', + }) + + return ( + <> +

    {status.work}

    +

    {status.wait}

    +

    {status.query}

    + + { + mergeStatus(setStatus, { wait: 'waiting' }) + void waitFor(pointerOverIntent).then((reason) => { + mergeStatus(setStatus, { wait: reason }) + if (reason === 'abort') return + + mergeStatus(setStatus, { work: 'started' }) + void gate.promise.then(() => { + mergeStatus(setStatus, { query: 'done' }) + }) + }) + }} + > + + + + ) +} + +function HydrateFirstPrefetchExample() { + const [reason, setReason] = React.useState('idle') + + return ( + <> +

    {reason}

    + { + setReason(await waitFor(doubleClickIntent)) + }} + > + + + + ) +} + +function RuntimeOnlyPrefetchExample() { + const gate = useDeferredGate() + const [status, setStatus] = React.useState({ + wait: 'idle', + ready: 'idle', + }) + + return ( + <> +

    {status.wait}

    +

    {status.ready}

    + + { + mergeStatus(setStatus, { wait: 'waiting' }) + const reason = await waitFor(pointerOverIntent) + mergeStatus(setStatus, { wait: reason }) + if (reason === 'abort') return + + await gate.promise + await preload() + mergeStatus(setStatus, { ready: 'ready' }) + }} + > + + + + ) +} + +function WaitForAbortExample() { + const [showBoundary, setShowBoundary] = React.useState(true) + const [reason, setReason] = React.useState('idle') + + return ( + <> +

    {reason}

    + + {showBoundary ? ( + { + setReason('waiting') + setReason(await waitFor(pointerOverIntent)) + }} + > + + + ) : null} + + ) +} + +function SignalAbortExample() { + const [showBoundary, setShowBoundary] = React.useState(true) + const [status, setStatus] = React.useState('idle') + + return ( + <> +

    {status}

    + + {showBoundary ? ( + { + setStatus('listening') + await new Promise((resolve) => { + const onAbort = () => { + setStatus('aborted') + resolve() + } + + if (signal.aborted) { + onAbort() + return + } + + signal.addEventListener('abort', onAbort, { once: true }) + }) + }} + > + + + ) : null} + + ) +} + +function NestedDynamicExamples() { + return ( + <> + + clickIntent}> + + + + + + ) +} + +function EnhancedHydrationPage() { + return ( +
    +

    Enhanced Hydrate APIs

    + + + + + + + + +
    + ) +} diff --git a/e2e/react-start/deferred-hydration/src/routes/imported.tsx b/e2e/react-start/deferred-hydration/src/routes/imported.tsx new file mode 100644 index 0000000000..bf0f8b74bd --- /dev/null +++ b/e2e/react-start/deferred-hydration/src/routes/imported.tsx @@ -0,0 +1,15 @@ +import { createFileRoute } from '@tanstack/react-router' +import { ImportedHydrateWidget } from '../shared/ImportedHydrateWidget' + +export const Route = createFileRoute('/imported')({ + component: ImportedHydrationPage, +}) + +function ImportedHydrationPage() { + return ( +
    +

    Imported Hydrate

    + +
    + ) +} diff --git a/e2e/react-start/deferred-hydration/src/routes/index.tsx b/e2e/react-start/deferred-hydration/src/routes/index.tsx new file mode 100644 index 0000000000..0585f4bc87 --- /dev/null +++ b/e2e/react-start/deferred-hydration/src/routes/index.tsx @@ -0,0 +1,23 @@ +import { Link, createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/')({ + component: Home, +}) + +function Home() { + return ( +
    +

    Deferred Hydration

    +

    Component strategies

    + component strategies +

    CSS

    + CSS deferred hydration +

    Imported component

    + + imported Hydrate + +

    Enhanced APIs

    + enhanced Hydrate APIs +
    + ) +} diff --git a/e2e/react-start/deferred-hydration/src/routes/scroll-restoration.tsx b/e2e/react-start/deferred-hydration/src/routes/scroll-restoration.tsx new file mode 100644 index 0000000000..7b52cf25fe --- /dev/null +++ b/e2e/react-start/deferred-hydration/src/routes/scroll-restoration.tsx @@ -0,0 +1,93 @@ +import { ClientOnly, createFileRoute } from '@tanstack/react-router' +import { Hydrate } from '@tanstack/react-start' +import { visible } from '@tanstack/react-start/hydration' +import * as React from 'react' + +export const Route = createFileRoute('/scroll-restoration')({ + component: ScrollRestorationRoute, +}) + +function BottomWidget() { + const [hydrated, setHydrated] = React.useState(false) + + React.useEffect(() => { + setHydrated(true) + }, []) + + return ( +
    +

    Bottom widget

    +

    + This visible deferred boundary is intentionally near the bottom of the + document. +

    +

    + The hydrated widget is taller than the server skeleton so the test can + catch scroll restoration that happens before late hydration settles. +

    +
    + ) +} + +function BottomWidgetSkeleton() { + return ( +
    +

    Bottom widget skeleton

    +

    + The server-rendered placeholder reserves the same vertical space as the + hydrated widget. +

    +
    + ) +} + +function ScrollRestorationRoute() { + return ( +
    +

    + Scroll restoration deferred hydration +

    +

    + This route keeps the reproduction small: a tall page, a visible Hydrate + boundary near the bottom, and normal router scroll restoration. +

    +
    + Scroll to the bottom widget +
    + + }> + + + +
    + ) +} diff --git a/e2e/react-start/deferred-hydration/src/shared/EnhancedNestedWidget.tsx b/e2e/react-start/deferred-hydration/src/shared/EnhancedNestedWidget.tsx new file mode 100644 index 0000000000..fb2f094e51 --- /dev/null +++ b/e2e/react-start/deferred-hydration/src/shared/EnhancedNestedWidget.tsx @@ -0,0 +1,33 @@ +import * as React from 'react' +import { Hydrate } from '@tanstack/react-start' +import { interaction, media } from '@tanstack/react-start/hydration' + +function CrossFileNestedButton() { + const [count, setCount] = React.useState(0) + const [hydrated, setHydrated] = React.useState(false) + + React.useEffect(() => { + setHydrated(true) + }, []) + + return ( + + ) +} + +export function EnhancedNestedWidget() { + return ( + + + + + + ) +} diff --git a/e2e/react-start/deferred-hydration/src/shared/ImportedHydrateWidget.tsx b/e2e/react-start/deferred-hydration/src/shared/ImportedHydrateWidget.tsx new file mode 100644 index 0000000000..f2be89ec1c --- /dev/null +++ b/e2e/react-start/deferred-hydration/src/shared/ImportedHydrateWidget.tsx @@ -0,0 +1,39 @@ +import * as React from 'react' +import { Hydrate } from '@tanstack/react-start' +import { interaction } from '@tanstack/react-start/hydration' + +function ImportedHydrateChild() { + const [count, setCount] = React.useState(0) + const [hydrated, setHydrated] = React.useState(false) + + React.useEffect(() => { + setHydrated(true) + }, []) + + return ( + + ) +} + +export function ImportedHydrateWidget() { + return ( + + imported hydrate fallback + + } + > + + + ) +} diff --git a/e2e/react-start/deferred-hydration/tests/hydration.spec.ts b/e2e/react-start/deferred-hydration/tests/hydration.spec.ts new file mode 100644 index 0000000000..bd097d2ead --- /dev/null +++ b/e2e/react-start/deferred-hydration/tests/hydration.spec.ts @@ -0,0 +1,1030 @@ +import { expect } from '@playwright/test' +import { createHmrFileEditor, test } from '@tanstack/router-e2e-utils' +import crypto from 'node:crypto' +import path from 'node:path' +import type { APIRequestContext, Page } from '@playwright/test' + +const isDev = process.env.MODE === 'dev' +const toolchain = process.env.E2E_TOOLCHAIN ?? 'vite' +const isVite = toolchain === 'vite' +const hmrExpect = expect.configure({ timeout: 20_000 }) +const componentsRouteFile = path.join( + process.cwd(), + 'src/routes/components.tsx', +) +const interactiveBoxLabelSource = + ' {props.label}: {count}' +const interactiveBoxHmrLabelSource = + ' hmr {props.label}: {count}' + +function normalizeComponentsRouteSource(source: string) { + return source + .split(interactiveBoxHmrLabelSource) + .join(interactiveBoxLabelSource) +} + +const componentsRouteEditor = createHmrFileEditor({ + files: { + componentsRoute: componentsRouteFile, + }, + normalizeSource: (_fileKey, source) => normalizeComponentsRouteSource(source), +}) + +function getVisibleHydrateVirtualPath() { + const normalizedSourcePath = path + .relative(process.cwd(), componentsRouteFile) + .replaceAll('\\', '/') + const sourceHash = crypto + .createHash('sha1') + .update(normalizedSourcePath) + .digest('hex') + .slice(0, 10) + const params = new URLSearchParams() + params.set('tss-hydrate', `0_${sourceHash}`) + + return `${componentsRouteFile}?${params.toString()}` +} + +async function waitForVisibleHydrateVirtualModule(page: Page, marker: string) { + const virtualPath = getVisibleHydrateVirtualPath() + + await expect + .poll( + async () => { + try { + const response = await page.request.get(virtualPath) + const text = await response.text() + + if (response.ok() && text.includes(marker)) { + return 'ready' + } + + return `${response.status()} ${text.slice(0, 240)}` + } catch (error) { + return String(error) + } + }, + { timeout: 20_000 }, + ) + .toBe('ready') +} + +async function clickAndExpectCount( + page: Page, + buttonTestId: string, + countTestId: string, + count: string, +) { + await expect(page.getByTestId(buttonTestId)).toHaveAttribute( + 'data-hydrated', + 'true', + ) + await page.getByTestId(buttonTestId).click() + await expect(page.getByTestId(countTestId)).toHaveText(count) +} + +async function clickIntentAndExpectReplayedCount( + page: Page, + buttonTestId: string, + countTestId: string, + count: string, +) { + await expectRouteToStayUnhydrated(page, buttonTestId) + await page.getByTestId(buttonTestId).click() + await expect(page.getByTestId(buttonTestId)).toHaveAttribute( + 'data-hydrated', + 'true', + ) + await expect(page.getByTestId(countTestId)).toHaveText(count) +} + +async function clickToHydrateThenClickAndExpectIncrement( + page: Page, + buttonTestId: string, + countTestId: string, +) { + await expectRouteToStayUnhydrated(page, buttonTestId) + await page.getByTestId(buttonTestId).click() + await expect(page.getByTestId(buttonTestId)).toHaveAttribute( + 'data-hydrated', + 'true', + ) + const previousCount = Number( + await page.getByTestId(countTestId).textContent(), + ) + await page.getByTestId(buttonTestId).click() + await expect + .poll(async () => Number(await page.getByTestId(countTestId).textContent())) + .toBe(previousCount + 1) +} + +async function hoverIntentAndExpectCount( + page: Page, + buttonTestId: string, + countTestId: string, + count: string, +) { + await expectRouteToStayUnhydrated(page, buttonTestId) + await page.mouse.move(0, 0) + await page.getByTestId(buttonTestId).hover() + await clickAndExpectCount(page, buttonTestId, countTestId, count) +} + +async function dispatchHydrationIntent( + page: Page, + buttonTestId: string, + eventName: string, +) { + await page.getByTestId(buttonTestId).evaluate((element, eventName) => { + const marker = element.closest('[data-ts-hydrate-id]') + + if (!marker) { + throw new Error('Expected Hydrate marker to exist') + } + + marker.dispatchEvent( + new Event(eventName, { bubbles: true, cancelable: true }), + ) + }, eventName) +} + +async function expectRouteToStayUnhydrated( + page: Page, + buttonTestId: string, + duration = 250, +) { + await expect(page.getByTestId(buttonTestId)).toHaveAttribute( + 'data-hydrated', + 'false', + ) + await page.waitForTimeout(duration) + await expect(page.getByTestId(buttonTestId)).toHaveAttribute( + 'data-hydrated', + 'false', + ) +} + +async function scrollToBoundary(page: Page, buttonTestId: string) { + const button = page.getByTestId(buttonTestId) + for (let attempt = 0; attempt < 3; attempt++) { + await button.evaluate((element) => { + element.scrollIntoView({ block: 'center', inline: 'nearest' }) + }) + + await page.waitForTimeout(100) + const isVisible = await button.evaluate((element) => { + const rect = element.getBoundingClientRect() + return rect.bottom > 0 && rect.top < window.innerHeight + }) + + if (isVisible) return + } + + await expect(button).toBeInViewport() +} + +async function expectCssProperty( + page: Page, + testId: string, + property: string, + value: string, +) { + await expect + .poll(() => + page.getByTestId(testId).evaluate((element, propertyName) => { + return getComputedStyle(element).getPropertyValue(propertyName) + }, property), + ) + .toBe(value) +} + +function htmlContainsText(html: string, text: string) { + const pattern = text.split(' ').join('(?:\\s|)+') + expect(html).toMatch(new RegExp(pattern)) +} + +async function waitForComponentsServerHtmlText(page: Page, text: string) { + await expect + .poll( + async () => { + const response = await page.request.get('/components') + const html = await response.text() + + if (!response.ok()) { + return `${response.status()} ${html.slice(0, 240)}` + } + + try { + htmlContainsText(html, text) + return 'ready' + } catch { + return html.slice(0, 240) + } + }, + { timeout: 20_000 }, + ) + .toBe('ready') +} + +function getModulePreloadHrefs(html: string) { + return Array.from(html.matchAll(/]*>/g), (match) => match[0]) + .filter((tag) => /\brel="modulepreload"/.test(tag)) + .map((tag) => tag.match(/\bhref="([^"]+)"/)?.[1]) + .filter((href): href is string => !!href) +} + +async function modulePreloadContentsContain( + request: APIRequestContext, + hrefs: Array, + marker: string, +) { + for (const href of hrefs) { + const response = await request.get(href) + if (!response.ok()) continue + + const text = await response.text() + if (text.includes(marker)) return true + } + + return false +} + +async function resourceContentsContain( + page: Page, + request: APIRequestContext, + marker: string, + filter: (url: string) => boolean, +) { + const resourceUrls = await page.evaluate(() => + performance.getEntriesByType('resource').map((entry) => entry.name), + ) + + return modulePreloadContentsContain( + request, + resourceUrls.filter(filter), + marker, + ) +} + +async function documentModulePreloadHrefs(page: Page) { + return page.evaluate(() => + Array.from( + document.querySelectorAll('link[rel~="modulepreload"]'), + (link) => link.href, + ), + ) +} + +function isHydrateBoundaryResource(url: string) { + return ( + url.includes('/assets/components-') || + url.includes('/assets/js/async/') || + url.includes('/static/js/async/') + ) +} + +function isClientJavaScriptResource(url: string) { + return ( + url.includes('/assets/') || + url.includes('/static/js/') || + url.includes('/static/js/async/') + ) +} + +async function expectClientRouterReady(page: Page) { + await expect + .poll(() => + page.evaluate(() => + Boolean( + ( + globalThis as typeof globalThis & { + __TSR_ROUTER__?: unknown + } + ).__TSR_ROUTER__, + ), + ), + ) + .toBe(true) +} + +async function gotoEnhanced(page: Page, search = '') { + await page.goto(`/enhanced${search}`) + await expectClientRouterReady(page) +} + +test.describe('Hydrate HMR', () => { + test.skip(!isDev, 'HMR regression coverage runs against the dev server only') + + test.beforeAll(async () => { + await componentsRouteEditor.capturePromise + }) + + test.afterEach(async () => { + await componentsRouteEditor.capturePromise + await componentsRouteEditor.restoreFiles() + }) + + test.afterAll(async () => { + await componentsRouteEditor.capturePromise + await componentsRouteEditor.restoreFiles() + }) + + test('updates deferred child chunks after the parent route is edited', async ({ + page, + }) => { + const pageErrors: Array = [] + page.on('pageerror', (error) => { + pageErrors.push(error.message) + }) + + await page.goto('/components') + await expectClientRouterReady(page) + await expectRouteToStayUnhydrated(page, 'component-visible-button') + + await componentsRouteEditor.replaceText( + 'componentsRoute', + interactiveBoxLabelSource, + interactiveBoxHmrLabelSource, + ) + + await waitForComponentsServerHtmlText(page, 'hmr visible') + if (isVite) { + await waitForVisibleHydrateVirtualModule(page, 'hmr ') + } + + await page.goto('/components') + await expectClientRouterReady(page) + await expectRouteToStayUnhydrated(page, 'component-visible-button') + await scrollToBoundary(page, 'component-visible-button') + await hmrExpect(page.getByTestId('component-visible-button')).toContainText( + 'hmr visible', + ) + await clickAndExpectCount( + page, + 'component-visible-button', + 'component-visible-count', + '1', + ) + expect(pageErrors).toEqual([]) + }) +}) + +test.describe('component-level Hydrate runtime strategies', () => { + test.skip( + isDev, + 'production hydration coverage runs against the preview server', + ) + + test('renders SSR HTML and hydrates each runtime when appropriately', async ({ + page, + request, + }) => { + await page.goto('/components') + + await expect(page.getByTestId('component-heading')).toHaveText( + 'Component Deferred Hydration', + ) + + await clickAndExpectCount( + page, + 'component-load-button', + 'component-load-count', + '1', + ) + await clickAndExpectCount( + page, + 'component-idle-button', + 'component-idle-count', + '1', + ) + await expect( + resourceContentsContain(page, request, 'component-visible', (url) => + isHydrateBoundaryResource(url), + ), + ).resolves.toBe(false) + await expectRouteToStayUnhydrated(page, 'component-visible-button') + await scrollToBoundary(page, 'component-visible-button') + await clickAndExpectCount( + page, + 'component-visible-button', + 'component-visible-count', + '1', + ) + await expect + .poll(() => + resourceContentsContain(page, request, 'component-visible', (url) => + isHydrateBoundaryResource(url), + ), + ) + .toBe(true) + await clickAndExpectCount( + page, + 'component-media-button', + 'component-media-count', + '1', + ) + await hoverIntentAndExpectCount( + page, + 'component-interaction-button', + 'component-interaction-count', + '1', + ) + await expect(page.getByTestId('component-on-hydrated-count')).toHaveText( + '0', + ) + await expectRouteToStayUnhydrated(page, 'component-custom-single-button') + await page.getByTestId('component-custom-single-button').hover() + await expectRouteToStayUnhydrated(page, 'component-custom-single-button') + await page.getByTestId('component-custom-single-button').click() + await expectRouteToStayUnhydrated(page, 'component-custom-single-button') + await dispatchHydrationIntent( + page, + 'component-custom-single-button', + 'dblclick', + ) + await expect( + page.getByTestId('component-custom-single-button'), + ).toHaveAttribute('data-hydrated', 'true') + await expect(page.getByTestId('component-on-hydrated-count')).toHaveText( + '1', + ) + await clickAndExpectCount( + page, + 'component-custom-single-button', + 'component-custom-single-count', + '1', + ) + await expect(page.getByTestId('component-on-hydrated-count')).toHaveText( + '1', + ) + await expectRouteToStayUnhydrated(page, 'component-custom-multi-button') + await dispatchHydrationIntent( + page, + 'component-custom-multi-button', + 'contextmenu', + ) + await clickAndExpectCount( + page, + 'component-custom-multi-button', + 'component-custom-multi-count', + '1', + ) + await expectRouteToStayUnhydrated(page, 'component-condition-button') + await page.getByTestId('component-enable-condition').click() + await clickAndExpectCount( + page, + 'component-condition-button', + 'component-condition-count', + '1', + ) + await expectRouteToStayUnhydrated(page, 'component-click-replay-button') + await page.getByTestId('component-click-replay-button').click() + await expect( + page.getByTestId('component-click-replay-button'), + ).toHaveAttribute('data-hydrated', 'true') + await expect(page.getByTestId('component-click-replay-count')).toHaveText( + '1', + ) + await expectRouteToStayUnhydrated(page, 'component-prefetch-button') + await expect( + resourceContentsContain(page, request, 'component-prefetch', (url) => + isHydrateBoundaryResource(url), + ), + ).resolves.toBe(false) + await page.mouse.move(0, 0) + await page.getByTestId('component-prefetch-button').hover() + await expect(page.getByTestId('component-prefetch-button')).toHaveAttribute( + 'data-hydrated', + 'false', + ) + await expect + .poll(() => + resourceContentsContain(page, request, 'component-prefetch', (url) => + isHydrateBoundaryResource(url), + ), + ) + .toBe(true) + await expect(page.getByTestId('component-prefetch-button')).toHaveAttribute( + 'data-hydrated', + 'false', + ) + await page.getByTestId('component-prefetch-button').click() + await expect(page.getByTestId('component-prefetch-button')).toHaveAttribute( + 'data-hydrated', + 'true', + ) + await expect(page.getByTestId('component-prefetch-count')).toHaveText('1') + await hoverIntentAndExpectCount( + page, + 'component-nested-child-button', + 'component-nested-child-count', + '1', + ) + + await page.getByTestId('component-never-button').click() + await expect(page.getByTestId('component-never-count')).toHaveText('0') + }) + + test('replays click after another interaction boundary hydrates first', async ({ + page, + }) => { + await page.goto('/components') + await expectClientRouterReady(page) + + await scrollToBoundary(page, 'component-custom-multi-button') + await expectRouteToStayUnhydrated(page, 'component-custom-multi-button') + await page.getByTestId('component-custom-multi-button').click({ + button: 'right', + }) + await expect( + page.getByTestId('component-custom-multi-button'), + ).toHaveAttribute('data-hydrated', 'true') + + await scrollToBoundary(page, 'component-click-replay-button') + await expectRouteToStayUnhydrated(page, 'component-click-replay-button') + await page.getByTestId('component-click-replay-button').click() + await expect( + page.getByTestId('component-click-replay-button'), + ).toHaveAttribute('data-hydrated', 'true') + await expect(page.getByTestId('component-click-replay-count')).toHaveText( + '1', + ) + }) + + test('shows fallback during a client-only mount while the child suspends', async ({ + page, + }) => { + await page.goto('/components') + await expect(page.getByTestId('component-load-button')).toHaveAttribute( + 'data-hydrated', + 'true', + ) + await page.getByTestId('component-show-client-fallback').click() + + await expect(page.getByTestId('component-client-fallback')).toHaveText( + 'client fallback', + ) + await expect(page.getByTestId('component-fallback-child')).toHaveText( + 'fallback child', + ) + await expect(page.getByTestId('component-client-fallback')).toHaveCount(0) + }) + + test('preserves scroll position after a force reload on a visible boundary', async ({ + page, + }) => { + await page.goto('/scroll-restoration') + await expectClientRouterReady(page) + await page + .getByTestId('scroll-restoration-skeleton') + .scrollIntoViewIfNeeded() + await expect(page.getByTestId('scroll-restoration-widget')).toHaveAttribute( + 'data-hydrated', + 'true', + ) + await page.evaluate(() => { + window.scrollTo(0, document.documentElement.scrollHeight) + }) + + const beforeReloadDistanceFromBottom = await page.evaluate( + () => + document.documentElement.scrollHeight - + window.innerHeight - + window.scrollY, + ) + expect(beforeReloadDistanceFromBottom).toBeLessThan(5) + + const client = await page.context().newCDPSession(page) + const reloaded = page.waitForEvent('load') + await client.send('Page.reload', { ignoreCache: true }) + await reloaded + + await expectClientRouterReady(page) + await expect(page.getByTestId('scroll-restoration-widget')).toHaveAttribute( + 'data-hydrated', + 'true', + ) + + await expect + .poll(() => + page.evaluate( + () => + document.documentElement.scrollHeight - + window.innerHeight - + window.scrollY, + ), + ) + .toBeLessThan(20) + }) +}) + +test.describe('enhanced Hydrate API combinations', () => { + test.skip( + isDev, + 'production hydration coverage runs against the preview server', + ) + + test('server renders dynamic markers without evaluating client-only callbacks or prefetch functions', async ({ + request, + }) => { + const response = await request.get('/enhanced?dynamic=interaction') + const html = await response.text() + + expect(response.ok()).toBe(true) + htmlContainsText(html, 'Enhanced Hydrate APIs') + htmlContainsText(html, 'conditional dynamic') + expect(html).toContain('data-ts-hydrate-when="dynamic"') + expect(html).not.toContain('missing-element') + }) + + test('dynamic when functions hydrate and replay interaction events', async ({ + page, + }) => { + await gotoEnhanced(page, '?dynamic=interaction') + await expect(page.getByTestId('enhanced-heading')).toHaveText( + 'Enhanced Hydrate APIs', + ) + await clickIntentAndExpectReplayedCount( + page, + 'enhanced-dynamic-interaction-button', + 'enhanced-dynamic-interaction-count', + '1', + ) + + await expectRouteToStayUnhydrated( + page, + 'enhanced-dynamic-conditional-button', + ) + await page.getByTestId('enhanced-dynamic-conditional-button').hover() + await expectRouteToStayUnhydrated( + page, + 'enhanced-dynamic-conditional-button', + ) + await clickIntentAndExpectReplayedCount( + page, + 'enhanced-dynamic-conditional-button', + 'enhanced-dynamic-conditional-count', + '1', + ) + }) + + test('procedural prefetch can block hydration, preload the split chunk, and prepare query-like work', async ({ + page, + request, + }) => { + await gotoEnhanced(page) + await expect( + resourceContentsContain( + page, + request, + 'enhanced-procedural-split-child', + isClientJavaScriptResource, + ), + ).resolves.toBe(false) + + await expectRouteToStayUnhydrated(page, 'enhanced-procedural-split-button') + await expect(page.getByTestId('enhanced-split-wait-reason')).toHaveText( + 'waiting', + ) + await dispatchHydrationIntent( + page, + 'enhanced-procedural-split-button', + 'pointerover', + ) + await expect(page.getByTestId('enhanced-split-query')).toHaveText('element') + await expect(page.getByTestId('enhanced-split-wait-reason')).toHaveText( + 'prefetch', + ) + await expect(page.getByTestId('enhanced-split-preload')).toHaveText('done') + await expect + .poll(() => + resourceContentsContain( + page, + request, + 'enhanced-procedural-split-child', + isClientJavaScriptResource, + ), + ) + .toBe(true) + + await page.getByTestId('enhanced-procedural-split-button').click() + await expect( + page.getByTestId('enhanced-procedural-split-button'), + ).toHaveAttribute('data-hydrated', 'false') + await expect( + page.getByTestId('enhanced-procedural-split-count'), + ).toHaveText('0') + await page.getByTestId('enhanced-release-split-prefetch').click() + await expect( + page.getByTestId('enhanced-procedural-split-button'), + ).toHaveAttribute('data-hydrated', 'true') + await expect( + page.getByTestId('enhanced-procedural-split-count'), + ).toHaveText('1') + await expect(page.getByTestId('enhanced-split-query')).toHaveText('done') + }) + + test('function prefetch supports fire-and-forget work and waitFor hydrate-first resolution', async ({ + page, + }) => { + await gotoEnhanced(page) + + await expect(page.getByTestId('enhanced-fire-wait-reason')).toHaveText( + 'waiting', + ) + await dispatchHydrationIntent( + page, + 'enhanced-fire-and-forget-button', + 'pointerover', + ) + await expect(page.getByTestId('enhanced-fire-wait-reason')).toHaveText( + 'prefetch', + ) + await expect(page.getByTestId('enhanced-fire-status')).toHaveText('started') + await clickIntentAndExpectReplayedCount( + page, + 'enhanced-fire-and-forget-button', + 'enhanced-fire-and-forget-count', + '1', + ) + await expect(page.getByTestId('enhanced-fire-query')).toHaveText('idle') + await page.getByTestId('enhanced-release-fire-prefetch').click() + await expect(page.getByTestId('enhanced-fire-query')).toHaveText('done') + + await clickIntentAndExpectReplayedCount( + page, + 'enhanced-hydrate-first-button', + 'enhanced-hydrate-first-count', + '1', + ) + await expect(page.getByTestId('enhanced-hydrate-first-reason')).toHaveText( + 'hydrate', + ) + }) + + test('split=false procedural prefetch blocks hydration without requiring a child preload chunk', async ({ + page, + }) => { + await gotoEnhanced(page) + + await expectRouteToStayUnhydrated(page, 'enhanced-runtime-only-button') + await expect(page.getByTestId('enhanced-runtime-wait-reason')).toHaveText( + 'waiting', + ) + await dispatchHydrationIntent( + page, + 'enhanced-runtime-only-button', + 'pointerover', + ) + await expect(page.getByTestId('enhanced-runtime-wait-reason')).toHaveText( + 'prefetch', + ) + await page.getByTestId('enhanced-runtime-only-button').click() + await expect( + page.getByTestId('enhanced-runtime-only-button'), + ).toHaveAttribute('data-hydrated', 'false') + await expect(page.getByTestId('enhanced-runtime-only-count')).toHaveText( + '0', + ) + await page.getByTestId('enhanced-release-runtime-prefetch').click() + await expect(page.getByTestId('enhanced-runtime-status')).toHaveText( + 'ready', + ) + await expect( + page.getByTestId('enhanced-runtime-only-button'), + ).toHaveAttribute('data-hydrated', 'true') + await expect(page.getByTestId('enhanced-runtime-only-count')).toHaveText( + '1', + ) + }) + + test('procedural prefetch aborts waiters and signals when boundaries unmount', async ({ + page, + }) => { + await gotoEnhanced(page) + + await expectRouteToStayUnhydrated(page, 'enhanced-wait-abort-button') + await expect(page.getByTestId('enhanced-wait-abort-reason')).toHaveText( + 'waiting', + ) + await page.getByTestId('enhanced-hide-wait-abort').click() + await expect(page.getByTestId('enhanced-wait-abort-reason')).toHaveText( + 'abort', + ) + + await expect(page.getByTestId('enhanced-abort-status')).toHaveText( + 'listening', + ) + await page.getByTestId('enhanced-hide-abort').click() + await expect(page.getByTestId('enhanced-abort-status')).toHaveText( + 'aborted', + ) + }) + + test('nested dynamic interaction boundaries delegate through outer boundaries', async ({ + page, + }) => { + await gotoEnhanced(page) + + await clickToHydrateThenClickAndExpectIncrement( + page, + 'enhanced-dynamic-nested-button', + 'enhanced-dynamic-nested-count', + ) + await clickToHydrateThenClickAndExpectIncrement( + page, + 'enhanced-cross-file-nested-button', + 'enhanced-cross-file-nested-count', + ) + }) +}) + +test.describe('Hydrate CSS delivery', () => { + test.skip( + isDev, + 'production hydration coverage runs against the preview server', + ) + + test('ships CSS for deferred, never, shared, and nested boundaries without JavaScript', async ({ + browser, + request, + }) => { + const response = await request.get('/css') + const html = await response.text() + + htmlContainsText(html, 'CSS Deferred Hydration') + htmlContainsText(html, 'Outer CSS') + htmlContainsText(html, 'Deferred CSS') + htmlContainsText(html, 'Never CSS') + htmlContainsText(html, 'Nested CSS') + + const context = await browser.newContext({ javaScriptEnabled: false }) + const page = await context.newPage() + + try { + await page.goto('/css') + + await expect(page.getByTestId('css-heading')).toHaveText( + 'CSS Deferred Hydration', + ) + await expect(page.getByTestId('css-deferred')).toHaveText('Deferred CSS') + await expect(page.getByTestId('css-never')).toHaveText('Never CSS') + await expect(page.getByTestId('css-nested')).toHaveText('Nested CSS') + + await expectCssProperty(page, 'css-outer', 'color', 'rgb(12, 34, 56)') + await expectCssProperty( + page, + 'css-deferred', + 'background-color', + 'rgb(23, 45, 67)', + ) + await expectCssProperty(page, 'css-never', 'color', 'rgb(45, 67, 89)') + await expectCssProperty( + page, + 'css-shared-outer', + 'border-top-color', + 'rgb(98, 76, 54)', + ) + await expectCssProperty( + page, + 'css-deferred', + 'border-top-color', + 'rgb(98, 76, 54)', + ) + await expectCssProperty( + page, + 'css-nested', + 'border-left-color', + 'rgb(67, 89, 123)', + ) + await expectCssProperty(page, 'css-nested', 'border-left-width', '5px') + } finally { + await context.close() + } + }) + + test('renders deferred content and omits never content after client-side navigation', async ({ + page, + }) => { + await page.goto('/') + await expectClientRouterReady(page) + await page.getByRole('link', { name: 'CSS', exact: true }).click() + await expect(page).toHaveURL(/\/css$/) + + await expect(page.getByTestId('css-heading')).toHaveText( + 'CSS Deferred Hydration', + ) + await expect(page.getByTestId('css-deferred')).toHaveText('Deferred CSS') + await expect(page.getByTestId('css-never')).toHaveCount(0) + await expect(page.getByTestId('css-nested')).toHaveCount(0) + + await expectCssProperty( + page, + 'css-deferred', + 'background-color', + 'rgb(23, 45, 67)', + ) + }) +}) + +test.describe('imported Hydrate boundaries', () => { + test.skip( + isDev, + 'production hydration coverage runs against the preview server', + ) + + test('does not emit filtered shared Hydrate child JS on the initial document', async ({ + request, + }) => { + const response = await request.get('/imported') + const html = await response.text() + + htmlContainsText(html, 'Imported Hydrate') + htmlContainsText(html, 'Imported Hydrate Child') + + await expect( + modulePreloadContentsContain( + request, + getModulePreloadHrefs(html), + 'imported-hydrate-child', + ), + ).resolves.toBe(false) + }) + + test('does not preload Hydrate child chunks before client navigation', async ({ + page, + request, + }) => { + await page.goto('/') + await expect(page.getByTestId('home-heading')).toHaveText( + 'Deferred Hydration', + ) + await expectClientRouterReady(page) + + const link = page.getByRole('link', { name: 'imported Hydrate' }) + await page.mouse.move(0, 0) + await link.hover() + await link.focus() + + await expect( + modulePreloadContentsContain( + request, + await documentModulePreloadHrefs(page), + 'imported-hydrate-child', + ), + ).resolves.toBe(false) + await expect( + resourceContentsContain(page, request, 'imported-hydrate-child', (url) => + isClientJavaScriptResource(url), + ), + ).resolves.toBe(false) + + await page.getByRole('link', { name: 'imported Hydrate' }).click() + await expect(page).toHaveURL(/\/imported$/) + await expect(page.getByTestId('imported-hydrate-fallback')).toHaveCount(0) + await expect(page.getByTestId('imported-hydrate-child')).toContainText( + 'Imported Hydrate Child', + ) + await clickAndExpectCount( + page, + 'imported-hydrate-child', + 'imported-hydrate-count', + '1', + ) + }) + + test('hydrates imported child boundaries from the initial document on interaction', async ({ + page, + request, + }) => { + await page.goto('/imported') + await expect(page.getByTestId('imported-heading')).toHaveText( + 'Imported Hydrate', + ) + await expectClientRouterReady(page) + await expect(page.getByTestId('imported-hydrate-fallback')).toHaveCount(0) + await expectRouteToStayUnhydrated(page, 'imported-hydrate-child') + await expect( + resourceContentsContain(page, request, 'imported-hydrate-child', (url) => + isClientJavaScriptResource(url), + ), + ).resolves.toBe(false) + + await page.getByTestId('imported-hydrate-child').click() + await expect(page.getByTestId('imported-hydrate-child')).toHaveAttribute( + 'data-hydrated', + 'true', + ) + await expect(page.getByTestId('imported-hydrate-count')).toHaveText('1') + await expect + .poll(() => + resourceContentsContain( + page, + request, + 'imported-hydrate-child', + isClientJavaScriptResource, + ), + ) + .toBe(true) + }) +}) diff --git a/e2e/react-start/deferred-hydration/tests/setup/global.setup.ts b/e2e/react-start/deferred-hydration/tests/setup/global.setup.ts new file mode 100644 index 0000000000..1117664a14 --- /dev/null +++ b/e2e/react-start/deferred-hydration/tests/setup/global.setup.ts @@ -0,0 +1,38 @@ +import { + e2eStartDummyServer, + getTestServerPort, + preOptimizeDevServer, + waitForServer, +} from '@tanstack/router-e2e-utils' +import packageJson from '../../package.json' with { type: 'json' } + +function getE2EPortKey() { + const toolchain = process.env.E2E_TOOLCHAIN ?? 'vite' + return process.env.E2E_PORT_KEY ?? `${packageJson.name}-${toolchain}` +} + +export default async function setup() { + if (process.env.MODE !== 'dev') return + + const e2ePortKey = getE2EPortKey() + + await e2eStartDummyServer(e2ePortKey) + + const port = await getTestServerPort(e2ePortKey) + const baseURL = `http://localhost:${port}` + + await waitForServer(baseURL) + await preOptimizeDevServer({ + baseURL, + readyTestId: 'home-heading', + warmup: async (page) => { + await page.goto(`${baseURL}/components`, { + waitUntil: 'domcontentloaded', + }) + await page.getByTestId('component-heading').waitFor({ + state: 'visible', + }) + await page.waitForLoadState('networkidle') + }, + }) +} diff --git a/e2e/react-start/deferred-hydration/tests/setup/global.teardown.ts b/e2e/react-start/deferred-hydration/tests/setup/global.teardown.ts new file mode 100644 index 0000000000..df79f50e82 --- /dev/null +++ b/e2e/react-start/deferred-hydration/tests/setup/global.teardown.ts @@ -0,0 +1,13 @@ +import { e2eStopDummyServer } from '@tanstack/router-e2e-utils' +import packageJson from '../../package.json' with { type: 'json' } + +function getE2EPortKey() { + const toolchain = process.env.E2E_TOOLCHAIN ?? 'vite' + return process.env.E2E_PORT_KEY ?? `${packageJson.name}-${toolchain}` +} + +export default async function teardown() { + if (process.env.MODE !== 'dev') return + + await e2eStopDummyServer(getE2EPortKey()) +} diff --git a/e2e/react-start/basic-rsc/tsconfig.json b/e2e/react-start/deferred-hydration/tsconfig.json similarity index 100% rename from e2e/react-start/basic-rsc/tsconfig.json rename to e2e/react-start/deferred-hydration/tsconfig.json diff --git a/e2e/react-start/basic-rsc/vite.config.ts b/e2e/react-start/deferred-hydration/vite.config.ts similarity index 58% rename from e2e/react-start/basic-rsc/vite.config.ts rename to e2e/react-start/deferred-hydration/vite.config.ts index 6c9a4c347a..1289bc0be7 100644 --- a/e2e/react-start/basic-rsc/vite.config.ts +++ b/e2e/react-start/deferred-hydration/vite.config.ts @@ -1,9 +1,14 @@ import { defineConfig } from 'vite' import { tanstackStart } from '@tanstack/react-start/plugin/vite' import viteReact from '@vitejs/plugin-react' -import tailwindcss from '@tailwindcss/vite' + +const outDir = process.env.E2E_DIST_DIR ?? 'dist-vite-ssr' export default defineConfig({ resolve: { tsconfigPaths: true }, - plugins: [tailwindcss(), tanstackStart(), viteReact()], + build: { + outDir, + }, + server: { port: 3000 }, + plugins: [tanstackStart(), viteReact()], }) diff --git a/e2e/react-start/dev-ssr-styles/env.ts b/e2e/react-start/dev-ssr-styles/env.ts index ef619a9948..f5c02ad34f 100644 --- a/e2e/react-start/dev-ssr-styles/env.ts +++ b/e2e/react-start/dev-ssr-styles/env.ts @@ -11,3 +11,4 @@ export const ssrStylesMode: SsrStylesMode = ssrStylesModeSchema.parse( ) export const useNitro = process.env.VITE_USE_NITRO === 'true' +export const viteBundledDev = process.env.E2E_VITE_BUNDLED_DEV === 'true' diff --git a/e2e/react-start/dev-ssr-styles/package.json b/e2e/react-start/dev-ssr-styles/package.json index 954deffa06..91c5cc1281 100644 --- a/e2e/react-start/dev-ssr-styles/package.json +++ b/e2e/react-start/dev-ssr-styles/package.json @@ -16,11 +16,19 @@ "test:e2e:dev": "MODE=dev playwright test --project=chromium", "test:e2e:dev:disabled": "MODE=dev SSR_STYLES=disabled playwright test --project=chromium", "test:e2e:dev:custom-basepath": "MODE=dev SSR_STYLES=custom-basepath playwright test --project=chromium", + "test:e2e:dev:bundled-dev": "MODE=dev E2E_VITE_BUNDLED_DEV=true playwright test --project=chromium", + "test:e2e:dev:disabled:bundled-dev": "MODE=dev SSR_STYLES=disabled E2E_VITE_BUNDLED_DEV=true playwright test --project=chromium", + "test:e2e:dev:custom-basepath:bundled-dev": "MODE=dev SSR_STYLES=custom-basepath E2E_VITE_BUNDLED_DEV=true playwright test --project=chromium", "test:e2e:dev:nitro": "MODE=dev VITE_USE_NITRO=true playwright test --project=chromium", "test:e2e:dev:disabled:nitro": "MODE=dev SSR_STYLES=disabled VITE_USE_NITRO=true playwright test --project=chromium", "test:e2e:dev:custom-basepath:nitro": "MODE=dev SSR_STYLES=custom-basepath VITE_USE_NITRO=true playwright test --project=chromium", - "test:e2e": "rm -rf port*.txt; pnpm run test:e2e:dev && pnpm run test:e2e:dev:disabled && pnpm run test:e2e:dev:custom-basepath", - "test:e2e:nitro": "rm -rf port*.txt; pnpm run test:e2e:dev:nitro && pnpm run test:e2e:dev:disabled:nitro && pnpm run test:e2e:dev:custom-basepath:nitro" + "test:e2e:dev:bundled-dev:nitro": "MODE=dev VITE_USE_NITRO=true E2E_VITE_BUNDLED_DEV=true playwright test --project=chromium", + "test:e2e:dev:disabled:bundled-dev:nitro": "MODE=dev SSR_STYLES=disabled VITE_USE_NITRO=true E2E_VITE_BUNDLED_DEV=true playwright test --project=chromium", + "test:e2e:dev:custom-basepath:bundled-dev:nitro": "MODE=dev SSR_STYLES=custom-basepath VITE_USE_NITRO=true E2E_VITE_BUNDLED_DEV=true playwright test --project=chromium", + "test:e2e:bundled-dev": "pnpm run test:e2e:dev:bundled-dev && pnpm run test:e2e:dev:disabled:bundled-dev && pnpm run test:e2e:dev:custom-basepath:bundled-dev", + "test:e2e:nitro:bundled-dev": "pnpm run test:e2e:dev:bundled-dev:nitro && pnpm run test:e2e:dev:disabled:bundled-dev:nitro && pnpm run test:e2e:dev:custom-basepath:bundled-dev:nitro", + "test:e2e": "rm -rf port*.txt; pnpm run test:e2e:dev && pnpm run test:e2e:dev:disabled && pnpm run test:e2e:dev:custom-basepath && pnpm run test:e2e:bundled-dev", + "test:e2e:nitro": "rm -rf port*.txt; pnpm run test:e2e:dev:nitro && pnpm run test:e2e:dev:disabled:nitro && pnpm run test:e2e:dev:custom-basepath:nitro && pnpm run test:e2e:nitro:bundled-dev" }, "dependencies": { "@tanstack/react-router": "workspace:*", @@ -30,6 +38,7 @@ }, "devDependencies": { "@playwright/test": "^1.50.1", + "@tanstack/router-core": "workspace:*", "@tanstack/router-e2e-utils": "workspace:*", "@types/node": "^22.10.2", "@types/react": "^19.0.8", @@ -38,7 +47,7 @@ "nitro": "^3.0.260311-beta", "srvx": "^0.11.9", "typescript": "^6.0.2", - "vite": "^8.0.0", - "zod": "^3.24.2" + "vite": "^8.0.14", + "zod": "^4.4.3" } } diff --git a/e2e/react-start/dev-ssr-styles/playwright.config.ts b/e2e/react-start/dev-ssr-styles/playwright.config.ts index 688c1c00db..a1fdd7c3ef 100644 --- a/e2e/react-start/dev-ssr-styles/playwright.config.ts +++ b/e2e/react-start/dev-ssr-styles/playwright.config.ts @@ -1,7 +1,7 @@ import { defineConfig, devices } from '@playwright/test' import { getTestServerPort } from '@tanstack/router-e2e-utils' import packageJson from './package.json' with { type: 'json' } -import { ssrStylesMode, useNitro } from './env' +import { ssrStylesMode, useNitro, viteBundledDev } from './env' const mode = process.env.MODE ?? 'prod' const isDev = mode === 'dev' @@ -17,6 +17,9 @@ function getPortKey() { if (useNitro) { key += '-nitro' } + if (viteBundledDev) { + key += '-bundled-dev' + } return key } @@ -55,6 +58,7 @@ export default defineConfig({ env: { VITE_NODE_ENV: 'test', PORT: String(PORT), + E2E_VITE_BUNDLED_DEV: String(viteBundledDev), }, }, diff --git a/e2e/react-start/dev-ssr-styles/tests/app.spec.ts b/e2e/react-start/dev-ssr-styles/tests/app.spec.ts index e10f9f73c0..cb1ba0b29b 100644 --- a/e2e/react-start/dev-ssr-styles/tests/app.spec.ts +++ b/e2e/react-start/dev-ssr-styles/tests/app.spec.ts @@ -1,4 +1,5 @@ import { expect } from '@playwright/test' +import { DEV_STYLES_ATTR } from '@tanstack/router-core' import { test } from '@tanstack/router-e2e-utils' import { ssrStylesMode } from '../env' @@ -29,9 +30,9 @@ test.describe(`dev.ssrStyles (mode=${ssrStylesMode})`, () => { expect(response.ok()).toBeTruthy() const html = await response.text() - // Should have a link tag with data-tanstack-router-dev-styles - expect(html).toContain('data-tanstack-router-dev-styles') + // Should have a dev styles link tag. expect(html).toContain('/@tanstack-start/styles.css') + expect(html).toContain(DEV_STYLES_ATTR) }) test('dev styles link uses vite base (/) as basepath prefix', async ({ @@ -75,9 +76,9 @@ test.describe(`dev.ssrStyles (mode=${ssrStylesMode})`, () => { expect(response.ok()).toBeTruthy() const html = await response.text() - // Should NOT have a link tag with data-tanstack-router-dev-styles - expect(html).not.toContain('data-tanstack-router-dev-styles') + // Should NOT have a dev styles link tag. expect(html).not.toContain('/@tanstack-start/styles.css') + expect(html).not.toContain(DEV_STYLES_ATTR) }) test('page still renders without dev styles', async ({ page }) => { @@ -100,9 +101,6 @@ test.describe(`dev.ssrStyles (mode=${ssrStylesMode})`, () => { expect(response.ok()).toBeTruthy() const html = await response.text() - // Should have a link tag with data-tanstack-router-dev-styles - expect(html).toContain('data-tanstack-router-dev-styles') - // The dev styles URL should use /custom-styles/ as the basepath prefix const match = html.match( /href="([^"]*@tanstack-start\/styles\.css[^"]*)"/, @@ -110,6 +108,7 @@ test.describe(`dev.ssrStyles (mode=${ssrStylesMode})`, () => { expect(match).toBeTruthy() const href = match![1] expect(href).toMatch(/^\/custom-styles\/@tanstack-start\/styles\.css/) + expect(html).toContain(DEV_STYLES_ATTR) }) test.describe('with JavaScript disabled', () => { diff --git a/e2e/react-start/dev-ssr-styles/tests/setup/global.setup.ts b/e2e/react-start/dev-ssr-styles/tests/setup/global.setup.ts index 46261d6b10..2bfd33163d 100644 --- a/e2e/react-start/dev-ssr-styles/tests/setup/global.setup.ts +++ b/e2e/react-start/dev-ssr-styles/tests/setup/global.setup.ts @@ -5,7 +5,7 @@ import { waitForServer, } from '@tanstack/router-e2e-utils' import packageJson from '../../package.json' with { type: 'json' } -import { ssrStylesMode, useNitro } from '../../env' +import { ssrStylesMode, useNitro, viteBundledDev } from '../../env' function getPortKey() { let key = packageJson.name @@ -15,6 +15,9 @@ function getPortKey() { if (useNitro) { key += '-nitro' } + if (viteBundledDev) { + key += '-bundled-dev' + } return key } diff --git a/e2e/react-start/dev-ssr-styles/tests/setup/global.teardown.ts b/e2e/react-start/dev-ssr-styles/tests/setup/global.teardown.ts index d705e5d688..0e44fca325 100644 --- a/e2e/react-start/dev-ssr-styles/tests/setup/global.teardown.ts +++ b/e2e/react-start/dev-ssr-styles/tests/setup/global.teardown.ts @@ -1,6 +1,6 @@ import { e2eStopDummyServer } from '@tanstack/router-e2e-utils' import packageJson from '../../package.json' with { type: 'json' } -import { ssrStylesMode, useNitro } from '../../env' +import { ssrStylesMode, useNitro, viteBundledDev } from '../../env' function getPortKey() { let key = packageJson.name @@ -10,6 +10,9 @@ function getPortKey() { if (useNitro) { key += '-nitro' } + if (viteBundledDev) { + key += '-bundled-dev' + } return key } diff --git a/e2e/react-start/dev-ssr-styles/vite.config.ts b/e2e/react-start/dev-ssr-styles/vite.config.ts index f4ef725231..555137b543 100644 --- a/e2e/react-start/dev-ssr-styles/vite.config.ts +++ b/e2e/react-start/dev-ssr-styles/vite.config.ts @@ -1,7 +1,7 @@ import { defineConfig } from 'vite' import { tanstackStart } from '@tanstack/react-start/plugin/vite' import viteReact from '@vitejs/plugin-react' -import { ssrStylesMode, useNitro } from './env' +import { ssrStylesMode, useNitro, viteBundledDev } from './env' function getSsrStylesConfig() { switch (ssrStylesMode) { @@ -20,6 +20,7 @@ export default defineConfig(async () => { return { resolve: { tsconfigPaths: true }, + experimental: viteBundledDev ? { bundledDev: true } : undefined, server: { port: 3000, }, diff --git a/e2e/react-start/early-hints/.gitignore b/e2e/react-start/early-hints/.gitignore new file mode 100644 index 0000000000..d294aba5b8 --- /dev/null +++ b/e2e/react-start/early-hints/.gitignore @@ -0,0 +1,9 @@ +# Generated certificates +.tmp/ +*.pem +*.key +*.crt +ca.key +ca.crt +cert.pem +key.pem diff --git a/e2e/react-start/early-hints/package.json b/e2e/react-start/early-hints/package.json new file mode 100644 index 0000000000..932ab20cdc --- /dev/null +++ b/e2e/react-start/early-hints/package.json @@ -0,0 +1,35 @@ +{ + "name": "tanstack-react-start-e2e-early-hints", + "private": true, + "sideEffects": false, + "type": "module", + "scripts": { + "dev": "vite dev --port 3000", + "dev:e2e": "vite dev", + "build": "vite build", + "preview": "vite preview", + "gen-certs": "node --import tsx tests/gen-certs.ts", + "start": "pnpm gen-certs && srvx --prod --tls --cert=tests/.tmp/tls/server.crt --key=tests/.tmp/tls/server.key -s ../client dist/server/server.js", + "test:e2e": "rm -rf port*.txt; playwright test --project=chromium" + }, + "dependencies": { + "@tanstack/react-router": "workspace:^", + "@tanstack/react-start": "workspace:^", + "react": "^19.0.0", + "react-dom": "^19.0.0" + }, + "devDependencies": { + "@playwright/test": "^1.50.1", + "@tanstack/router-e2e-utils": "workspace:^", + "@types/node": "^22.10.2", + "@types/node-forge": "^1.3.14", + "@types/react": "^19.0.8", + "@types/react-dom": "^19.0.3", + "@vitejs/plugin-react": "^6.0.1", + "node-forge": "^1.3.1", + "srvx": "0.11.15", + "tsx": "4.20.3", + "typescript": "^6.0.2", + "vite": "^8.0.14" + } +} diff --git a/e2e/react-start/early-hints/playwright.config.ts b/e2e/react-start/early-hints/playwright.config.ts new file mode 100644 index 0000000000..a2435bcf7b --- /dev/null +++ b/e2e/react-start/early-hints/playwright.config.ts @@ -0,0 +1,37 @@ +import { defineConfig, devices } from '@playwright/test' +import { getTestServerPort } from '@tanstack/router-e2e-utils' +import packageJson from './package.json' with { type: 'json' } + +const PORT = await getTestServerPort(packageJson.name) +const baseURL = `https://localhost:${PORT}` + +export default defineConfig({ + testDir: './tests', + workers: 1, + reporter: [['line']], + + use: { + baseURL, + ignoreHTTPSErrors: true, + }, + + webServer: { + command: `pnpm build && pnpm start`, + url: baseURL, + reuseExistingServer: !process.env.CI, + stdout: 'pipe', + ignoreHTTPSErrors: true, + env: { + PORT: String(PORT), + }, + }, + + projects: [ + { + name: 'chromium', + use: { + ...devices['Desktop Chrome'], + }, + }, + ], +}) diff --git a/e2e/react-start/early-hints/src/routeTree.gen.ts b/e2e/react-start/early-hints/src/routeTree.gen.ts new file mode 100644 index 0000000000..14e2fd341e --- /dev/null +++ b/e2e/react-start/early-hints/src/routeTree.gen.ts @@ -0,0 +1,225 @@ +/* eslint-disable */ + +// @ts-nocheck + +// noinspection JSUnusedGlobalSymbols + +// This file was automatically generated by TanStack Router. +// You should NOT make any changes in this file as it will be overwritten. +// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. + +import { Route as rootRouteImport } from './routes/__root' +import { Route as RedirectRouteImport } from './routes/redirect' +import { Route as ParentRouteImport } from './routes/parent' +import { Route as OtherRouteImport } from './routes/other' +import { Route as IndexRouteImport } from './routes/index' +import { Route as ParentChildRouteImport } from './routes/parent/child' +import { Route as OtherNestedRouteImport } from './routes/other/nested' +import { Route as ParentChildGrandchildRouteImport } from './routes/parent/child/grandchild' + +const RedirectRoute = RedirectRouteImport.update({ + id: '/redirect', + path: '/redirect', + getParentRoute: () => rootRouteImport, +} as any) +const ParentRoute = ParentRouteImport.update({ + id: '/parent', + path: '/parent', + getParentRoute: () => rootRouteImport, +} as any) +const OtherRoute = OtherRouteImport.update({ + id: '/other', + path: '/other', + getParentRoute: () => rootRouteImport, +} as any) +const IndexRoute = IndexRouteImport.update({ + id: '/', + path: '/', + getParentRoute: () => rootRouteImport, +} as any) +const ParentChildRoute = ParentChildRouteImport.update({ + id: '/child', + path: '/child', + getParentRoute: () => ParentRoute, +} as any) +const OtherNestedRoute = OtherNestedRouteImport.update({ + id: '/nested', + path: '/nested', + getParentRoute: () => OtherRoute, +} as any) +const ParentChildGrandchildRoute = ParentChildGrandchildRouteImport.update({ + id: '/grandchild', + path: '/grandchild', + getParentRoute: () => ParentChildRoute, +} as any) + +export interface FileRoutesByFullPath { + '/': typeof IndexRoute + '/other': typeof OtherRouteWithChildren + '/parent': typeof ParentRouteWithChildren + '/redirect': typeof RedirectRoute + '/other/nested': typeof OtherNestedRoute + '/parent/child': typeof ParentChildRouteWithChildren + '/parent/child/grandchild': typeof ParentChildGrandchildRoute +} +export interface FileRoutesByTo { + '/': typeof IndexRoute + '/other': typeof OtherRouteWithChildren + '/parent': typeof ParentRouteWithChildren + '/redirect': typeof RedirectRoute + '/other/nested': typeof OtherNestedRoute + '/parent/child': typeof ParentChildRouteWithChildren + '/parent/child/grandchild': typeof ParentChildGrandchildRoute +} +export interface FileRoutesById { + __root__: typeof rootRouteImport + '/': typeof IndexRoute + '/other': typeof OtherRouteWithChildren + '/parent': typeof ParentRouteWithChildren + '/redirect': typeof RedirectRoute + '/other/nested': typeof OtherNestedRoute + '/parent/child': typeof ParentChildRouteWithChildren + '/parent/child/grandchild': typeof ParentChildGrandchildRoute +} +export interface FileRouteTypes { + fileRoutesByFullPath: FileRoutesByFullPath + fullPaths: + | '/' + | '/other' + | '/parent' + | '/redirect' + | '/other/nested' + | '/parent/child' + | '/parent/child/grandchild' + fileRoutesByTo: FileRoutesByTo + to: + | '/' + | '/other' + | '/parent' + | '/redirect' + | '/other/nested' + | '/parent/child' + | '/parent/child/grandchild' + id: + | '__root__' + | '/' + | '/other' + | '/parent' + | '/redirect' + | '/other/nested' + | '/parent/child' + | '/parent/child/grandchild' + fileRoutesById: FileRoutesById +} +export interface RootRouteChildren { + IndexRoute: typeof IndexRoute + OtherRoute: typeof OtherRouteWithChildren + ParentRoute: typeof ParentRouteWithChildren + RedirectRoute: typeof RedirectRoute +} + +declare module '@tanstack/react-router' { + interface FileRoutesByPath { + '/redirect': { + id: '/redirect' + path: '/redirect' + fullPath: '/redirect' + preLoaderRoute: typeof RedirectRouteImport + parentRoute: typeof rootRouteImport + } + '/parent': { + id: '/parent' + path: '/parent' + fullPath: '/parent' + preLoaderRoute: typeof ParentRouteImport + parentRoute: typeof rootRouteImport + } + '/other': { + id: '/other' + path: '/other' + fullPath: '/other' + preLoaderRoute: typeof OtherRouteImport + parentRoute: typeof rootRouteImport + } + '/': { + id: '/' + path: '/' + fullPath: '/' + preLoaderRoute: typeof IndexRouteImport + parentRoute: typeof rootRouteImport + } + '/parent/child': { + id: '/parent/child' + path: '/child' + fullPath: '/parent/child' + preLoaderRoute: typeof ParentChildRouteImport + parentRoute: typeof ParentRoute + } + '/other/nested': { + id: '/other/nested' + path: '/nested' + fullPath: '/other/nested' + preLoaderRoute: typeof OtherNestedRouteImport + parentRoute: typeof OtherRoute + } + '/parent/child/grandchild': { + id: '/parent/child/grandchild' + path: '/grandchild' + fullPath: '/parent/child/grandchild' + preLoaderRoute: typeof ParentChildGrandchildRouteImport + parentRoute: typeof ParentChildRoute + } + } +} + +interface OtherRouteChildren { + OtherNestedRoute: typeof OtherNestedRoute +} + +const OtherRouteChildren: OtherRouteChildren = { + OtherNestedRoute: OtherNestedRoute, +} + +const OtherRouteWithChildren = OtherRoute._addFileChildren(OtherRouteChildren) + +interface ParentChildRouteChildren { + ParentChildGrandchildRoute: typeof ParentChildGrandchildRoute +} + +const ParentChildRouteChildren: ParentChildRouteChildren = { + ParentChildGrandchildRoute: ParentChildGrandchildRoute, +} + +const ParentChildRouteWithChildren = ParentChildRoute._addFileChildren( + ParentChildRouteChildren, +) + +interface ParentRouteChildren { + ParentChildRoute: typeof ParentChildRouteWithChildren +} + +const ParentRouteChildren: ParentRouteChildren = { + ParentChildRoute: ParentChildRouteWithChildren, +} + +const ParentRouteWithChildren = + ParentRoute._addFileChildren(ParentRouteChildren) + +const rootRouteChildren: RootRouteChildren = { + IndexRoute: IndexRoute, + OtherRoute: OtherRouteWithChildren, + ParentRoute: ParentRouteWithChildren, + RedirectRoute: RedirectRoute, +} +export const routeTree = rootRouteImport + ._addFileChildren(rootRouteChildren) + ._addFileTypes() + +import type { getRouter } from './router.tsx' +import type { createStart } from '@tanstack/react-start' +declare module '@tanstack/react-start' { + interface Register { + ssr: true + router: Awaited> + } +} diff --git a/e2e/react-start/early-hints/src/router.tsx b/e2e/react-start/early-hints/src/router.tsx new file mode 100644 index 0000000000..e59e199b48 --- /dev/null +++ b/e2e/react-start/early-hints/src/router.tsx @@ -0,0 +1,10 @@ +import { createRouter } from '@tanstack/react-router' +import { routeTree } from './routeTree.gen' + +export function getRouter() { + return createRouter({ + routeTree, + scrollRestoration: true, + defaultPreload: 'intent', + }) +} diff --git a/e2e/react-start/early-hints/src/routes/__root.tsx b/e2e/react-start/early-hints/src/routes/__root.tsx new file mode 100644 index 0000000000..448bb5471a --- /dev/null +++ b/e2e/react-start/early-hints/src/routes/__root.tsx @@ -0,0 +1,45 @@ +import * as React from 'react' +import { + HeadContent, + Link, + Outlet, + Scripts, + createRootRoute, +} from '@tanstack/react-router' + +export const Route = createRootRoute({ + head: () => ({ + meta: [ + { charSet: 'utf-8' }, + { name: 'viewport', content: 'width=device-width, initial-scale=1' }, + ], + links: [ + { rel: 'icon', href: '/favicon.ico' }, + { rel: 'preconnect', href: 'https://early-hints.test' }, + ], + }), + component: RootComponent, +}) + +function RootComponent() { + return ( + + + + + + +
    + + + + + ) +} diff --git a/examples/react/start-basic-rsc/src/routes/index.tsx b/e2e/react-start/early-hints/src/routes/index.tsx similarity index 56% rename from examples/react/start-basic-rsc/src/routes/index.tsx rename to e2e/react-start/early-hints/src/routes/index.tsx index d531858f8c..e7d9b56c8c 100644 --- a/examples/react/start-basic-rsc/src/routes/index.tsx +++ b/e2e/react-start/early-hints/src/routes/index.tsx @@ -1,12 +1,14 @@ import { createFileRoute } from '@tanstack/react-router' + export const Route = createFileRoute('/')({ component: Home, }) function Home() { return ( -
    -

    Welcome Home!

    +
    +

    Early Hints E2E Test

    +

    This app tests HTTP 103 Early Hints functionality.

    ) } diff --git a/e2e/react-start/early-hints/src/routes/other.tsx b/e2e/react-start/early-hints/src/routes/other.tsx new file mode 100644 index 0000000000..1f7378f72d --- /dev/null +++ b/e2e/react-start/early-hints/src/routes/other.tsx @@ -0,0 +1,30 @@ +/// +import { createFileRoute, Outlet } from '@tanstack/react-router' +import otherCss from '../styles/other.css?url' +import styles from '../styles/other.module.css' + +export const Route = createFileRoute('/other')({ + head: () => ({ + links: [{ rel: 'stylesheet', href: otherCss }], + }), + beforeLoad: async () => { + await new Promise((resolve) => setTimeout(resolve, 10)) + return { otherData: 'from-other-beforeLoad' } + }, + loader: async () => { + await new Promise((resolve) => setTimeout(resolve, 10)) + return { otherLoaderData: 'other-loader-result' } + }, + component: OtherComponent, +}) + +function OtherComponent() { + const { otherLoaderData } = Route.useLoaderData() + return ( +
    +

    Other Route

    +

    {otherLoaderData}

    + +
    + ) +} diff --git a/e2e/react-start/early-hints/src/routes/other/nested.tsx b/e2e/react-start/early-hints/src/routes/other/nested.tsx new file mode 100644 index 0000000000..a91f1ca3b2 --- /dev/null +++ b/e2e/react-start/early-hints/src/routes/other/nested.tsx @@ -0,0 +1,34 @@ +/// +import { createFileRoute } from '@tanstack/react-router' +import nestedCss from '../../styles/nested.css?url' +import styles from '../../styles/nested.module.css' + +export const Route = createFileRoute('/other/nested')({ + head: () => ({ + links: [{ rel: 'stylesheet', href: nestedCss }], + }), + beforeLoad: async () => { + await new Promise((resolve) => setTimeout(resolve, 10)) + return { nestedData: 'from-nested-beforeLoad' } + }, + loader: async () => { + await new Promise((resolve) => setTimeout(resolve, 10)) + return { nestedLoaderData: 'nested-loader-result' } + }, + component: NestedComponent, +}) + +function NestedComponent() { + const { nestedLoaderData } = Route.useLoaderData() + return ( +
    +

    + Nested Route (under Other) +

    +

    {nestedLoaderData}

    +
    + ) +} diff --git a/e2e/react-start/early-hints/src/routes/parent.tsx b/e2e/react-start/early-hints/src/routes/parent.tsx new file mode 100644 index 0000000000..dbe7ae3d74 --- /dev/null +++ b/e2e/react-start/early-hints/src/routes/parent.tsx @@ -0,0 +1,35 @@ +/// +import { createFileRoute, Outlet } from '@tanstack/react-router' +import parentCss from '../styles/parent.css?url' +import styles from '../styles/parent.module.css' + +export const Route = createFileRoute('/parent')({ + head: () => ({ + links: [{ rel: 'stylesheet', href: parentCss }], + }), + beforeLoad: async () => { + // Simulate some async work in beforeLoad + await new Promise((resolve) => setTimeout(resolve, 10)) + return { parentData: 'from-beforeLoad' } + }, + loader: async () => { + // Simulate loading data + await new Promise((resolve) => setTimeout(resolve, 10)) + return { parentLoaderData: 'parent-loader-result' } + }, + component: ParentComponent, +}) + +function ParentComponent() { + const { parentLoaderData } = Route.useLoaderData() + return ( +
    +

    Parent Route

    +

    {parentLoaderData}

    + +
    + ) +} diff --git a/e2e/react-start/early-hints/src/routes/parent/child.tsx b/e2e/react-start/early-hints/src/routes/parent/child.tsx new file mode 100644 index 0000000000..70893d5ecb --- /dev/null +++ b/e2e/react-start/early-hints/src/routes/parent/child.tsx @@ -0,0 +1,30 @@ +/// +import { createFileRoute, Outlet } from '@tanstack/react-router' +import childCss from '../../styles/child.css?url' +import styles from '../../styles/child.module.css' + +export const Route = createFileRoute('/parent/child')({ + head: () => ({ + links: [{ rel: 'stylesheet', href: childCss }], + }), + beforeLoad: async () => { + await new Promise((resolve) => setTimeout(resolve, 10)) + return { childData: 'from-child-beforeLoad' } + }, + loader: async () => { + await new Promise((resolve) => setTimeout(resolve, 10)) + return { childLoaderData: 'child-loader-result' } + }, + component: ChildComponent, +}) + +function ChildComponent() { + const { childLoaderData } = Route.useLoaderData() + return ( +
    +

    Child Route

    +

    {childLoaderData}

    + +
    + ) +} diff --git a/e2e/react-start/early-hints/src/routes/parent/child/grandchild.tsx b/e2e/react-start/early-hints/src/routes/parent/child/grandchild.tsx new file mode 100644 index 0000000000..878873208a --- /dev/null +++ b/e2e/react-start/early-hints/src/routes/parent/child/grandchild.tsx @@ -0,0 +1,32 @@ +/// +import { createFileRoute } from '@tanstack/react-router' +import grandchildCss from '../../../styles/grandchild.css?url' +import styles from '../../../styles/grandchild.module.css' + +export const Route = createFileRoute('/parent/child/grandchild')({ + head: () => ({ + links: [{ rel: 'stylesheet', href: grandchildCss }], + }), + beforeLoad: async () => { + await new Promise((resolve) => setTimeout(resolve, 10)) + return { grandchildData: 'from-grandchild-beforeLoad' } + }, + loader: async () => { + await new Promise((resolve) => setTimeout(resolve, 10)) + return { grandchildLoaderData: 'grandchild-loader-result' } + }, + component: GrandchildComponent, +}) + +function GrandchildComponent() { + const { grandchildLoaderData } = Route.useLoaderData() + return ( +
    +

    Grandchild Route

    +

    {grandchildLoaderData}

    +
    + ) +} diff --git a/e2e/react-start/early-hints/src/routes/redirect.tsx b/e2e/react-start/early-hints/src/routes/redirect.tsx new file mode 100644 index 0000000000..878b507ea0 --- /dev/null +++ b/e2e/react-start/early-hints/src/routes/redirect.tsx @@ -0,0 +1,11 @@ +import { createFileRoute, redirect } from '@tanstack/react-router' + +export const Route = createFileRoute('/redirect')({ + beforeLoad: () => { + throw redirect({ to: '/' }) + }, + head: () => ({ + links: [{ rel: 'preconnect', href: 'https://redirect-dynamic.test' }], + }), + component: () => null, +}) diff --git a/e2e/react-start/early-hints/src/server.ts b/e2e/react-start/early-hints/src/server.ts new file mode 100644 index 0000000000..fec6da0178 --- /dev/null +++ b/e2e/react-start/early-hints/src/server.ts @@ -0,0 +1,23 @@ +import handler from '@tanstack/react-start/server-entry' +import type { ServerRequest } from 'srvx' + +export default { + fetch(request: Request) { + // Cast to ServerRequest to access Node.js runtime + const serverRequest = request as ServerRequest + + return handler.fetch(request, { + responseLinkHeader: true, + onEarlyHints: ({ allLinks, phase }) => { + if (phase !== 'dynamic') return + + // Access native Node.js response via srvx's runtime context + const nodeRes = serverRequest.runtime?.node?.res + + if (nodeRes?.writeEarlyHints && allLinks.length) { + nodeRes.writeEarlyHints({ link: allLinks }) + } + }, + }) + }, +} diff --git a/e2e/react-start/early-hints/src/styles/child.css b/e2e/react-start/early-hints/src/styles/child.css new file mode 100644 index 0000000000..aed515e5a3 --- /dev/null +++ b/e2e/react-start/early-hints/src/styles/child.css @@ -0,0 +1,13 @@ +/* Child route styles */ +.child-container { + background-color: #dbeafe; + padding: 12px; + border-radius: 6px; + border: 2px solid #3b82f6; + margin-top: 8px; +} + +.child-title { + color: #1e40af; + font-weight: 600; +} diff --git a/e2e/react-start/early-hints/src/styles/child.module.css b/e2e/react-start/early-hints/src/styles/child.module.css new file mode 100644 index 0000000000..2be8a168e9 --- /dev/null +++ b/e2e/react-start/early-hints/src/styles/child.module.css @@ -0,0 +1,13 @@ +/* Child route CSS module */ +.container { + background-color: #dbeafe; + padding: 12px; + border-radius: 6px; + border: 2px solid #3b82f6; + margin-top: 10px; +} + +.title { + color: #1e40af; + font-weight: 500; +} diff --git a/e2e/react-start/early-hints/src/styles/grandchild.css b/e2e/react-start/early-hints/src/styles/grandchild.css new file mode 100644 index 0000000000..3a15cadacf --- /dev/null +++ b/e2e/react-start/early-hints/src/styles/grandchild.css @@ -0,0 +1,13 @@ +/* Grandchild route styles */ +.grandchild-container { + background-color: #f0fdf4; + padding: 10px; + border-radius: 4px; + border: 2px solid #22c55e; + margin-top: 8px; +} + +.grandchild-title { + color: #166534; + font-weight: 600; +} diff --git a/e2e/react-start/early-hints/src/styles/grandchild.module.css b/e2e/react-start/early-hints/src/styles/grandchild.module.css new file mode 100644 index 0000000000..afce86338f --- /dev/null +++ b/e2e/react-start/early-hints/src/styles/grandchild.module.css @@ -0,0 +1,13 @@ +/* Grandchild route CSS module */ +.container { + background-color: #dcfce7; + padding: 10px; + border-radius: 4px; + border: 2px solid #22c55e; + margin-top: 8px; +} + +.title { + color: #166534; + font-weight: 500; +} diff --git a/e2e/react-start/early-hints/src/styles/nested.css b/e2e/react-start/early-hints/src/styles/nested.css new file mode 100644 index 0000000000..33541a14c9 --- /dev/null +++ b/e2e/react-start/early-hints/src/styles/nested.css @@ -0,0 +1,13 @@ +/* Nested route styles */ +.nested-container { + background-color: #ede9fe; + padding: 12px; + border-radius: 6px; + border: 2px solid #8b5cf6; + margin-top: 8px; +} + +.nested-title { + color: #5b21b6; + font-weight: 600; +} diff --git a/e2e/react-start/early-hints/src/styles/nested.module.css b/e2e/react-start/early-hints/src/styles/nested.module.css new file mode 100644 index 0000000000..06cfb6ba8e --- /dev/null +++ b/e2e/react-start/early-hints/src/styles/nested.module.css @@ -0,0 +1,13 @@ +/* Nested route CSS module */ +.container { + background-color: #e0e7ff; + padding: 12px; + border-radius: 6px; + border: 2px solid #6366f1; + margin-top: 10px; +} + +.title { + color: #3730a3; + font-weight: 500; +} diff --git a/e2e/react-start/early-hints/src/styles/other.css b/e2e/react-start/early-hints/src/styles/other.css new file mode 100644 index 0000000000..3203f1224f --- /dev/null +++ b/e2e/react-start/early-hints/src/styles/other.css @@ -0,0 +1,12 @@ +/* Other route styles */ +.other-container { + background-color: #fce7f3; + padding: 16px; + border-radius: 8px; + border: 2px solid #ec4899; +} + +.other-title { + color: #9d174d; + font-weight: 600; +} diff --git a/e2e/react-start/early-hints/src/styles/other.module.css b/e2e/react-start/early-hints/src/styles/other.module.css new file mode 100644 index 0000000000..ffaa6bf769 --- /dev/null +++ b/e2e/react-start/early-hints/src/styles/other.module.css @@ -0,0 +1,12 @@ +/* Other route CSS module */ +.container { + background-color: #fce7f3; + padding: 16px; + border-radius: 8px; + border: 2px solid #ec4899; +} + +.title { + color: #9d174d; + font-weight: 600; +} diff --git a/e2e/react-start/early-hints/src/styles/parent.css b/e2e/react-start/early-hints/src/styles/parent.css new file mode 100644 index 0000000000..f53e3f2f43 --- /dev/null +++ b/e2e/react-start/early-hints/src/styles/parent.css @@ -0,0 +1,12 @@ +/* Parent route styles */ +.parent-container { + background-color: #fef3c7; + padding: 16px; + border-radius: 8px; + border: 2px solid #f59e0b; +} + +.parent-title { + color: #92400e; + font-weight: 600; +} diff --git a/e2e/react-start/early-hints/src/styles/parent.module.css b/e2e/react-start/early-hints/src/styles/parent.module.css new file mode 100644 index 0000000000..bab70486e4 --- /dev/null +++ b/e2e/react-start/early-hints/src/styles/parent.module.css @@ -0,0 +1,12 @@ +/* Parent route CSS module */ +.container { + background-color: #fef3c7; + padding: 16px; + border-radius: 8px; + border: 2px solid #f59e0b; +} + +.title { + color: #92400e; + font-weight: 600; +} diff --git a/e2e/react-start/early-hints/tests/early-hints-protocol.spec.ts b/e2e/react-start/early-hints/tests/early-hints-protocol.spec.ts new file mode 100644 index 0000000000..df0984079e --- /dev/null +++ b/e2e/react-start/early-hints/tests/early-hints-protocol.spec.ts @@ -0,0 +1,161 @@ +import { expect, test } from '@playwright/test' +import { connect } from 'node:http2' +import { getTestServerPort } from '@tanstack/router-e2e-utils' +import packageJson from '../package.json' with { type: 'json' } +import type { IncomingHttpHeaders } from 'node:http2' + +type Http2Response = { + earlyHints: Array + finalHeaders: IncomingHttpHeaders + body: string +} + +function makeRequest(baseURL: string, path: string): Promise { + return new Promise((resolve, reject) => { + const client = connect(baseURL, { rejectUnauthorized: false }) + const request = client.request({ ':path': path }) + const earlyHints: Array = [] + const chunks: Array = [] + let finalHeaders: IncomingHttpHeaders | undefined + + client.on('error', reject) + request.on('headers', (headers) => { + if (headers[':status'] === 103) { + earlyHints.push(headers) + } + }) + request.on('response', (headers) => { + finalHeaders = headers + }) + request.on('data', (chunk: Buffer) => chunks.push(chunk)) + request.on('error', reject) + request.on('end', () => { + client.close() + resolve({ + earlyHints, + finalHeaders: finalHeaders!, + body: Buffer.concat(chunks).toString('utf8'), + }) + }) + request.end() + }) +} + +function linkHeader(headers: IncomingHttpHeaders): string { + const link = headers.link + return Array.isArray(link) ? link.join(', ') : (link ?? '') +} + +function earlyHintsLinkHeader(response: Http2Response): string { + expect(response.earlyHints.length).toBe(1) + return linkHeader(response.earlyHints[0]!) +} + +test.describe('Early Hints - HTTP/2 Protocol', () => { + let baseURL: string + + test.beforeAll(async () => { + const PORT = await getTestServerPort(packageJson.name) + baseURL = `https://localhost:${PORT}` + }) + + test('server sends HTTP 103 Early Hints for index route', async () => { + const response = await makeRequest(baseURL, '/') + + expect(response.earlyHints.length).toBe(1) + expect(response.finalHeaders[':status']).toBe(200) + + const link = earlyHintsLinkHeader(response) + expect(link).toContain('rel=modulepreload; as=script') + expect(link).toMatch(/index-[^.]+\.js/) + }) + + test('server sends route-specific hints for nested route', async () => { + const response = await makeRequest(baseURL, '/parent/child/grandchild') + + expect(response.earlyHints.length).toBe(1) + + const link = earlyHintsLinkHeader(response) + expect(link).toContain('parent') + expect(link).toContain('child') + expect(link).toContain('grandchild') + }) + + test('different routes get different hints', async () => { + const [parentResponse, otherResponse] = await Promise.all([ + makeRequest(baseURL, '/parent/child/grandchild'), + makeRequest(baseURL, '/other/nested'), + ]) + + const parentLinks = earlyHintsLinkHeader(parentResponse) + const otherLinks = earlyHintsLinkHeader(otherResponse) + + expect(parentLinks).toContain('parent') + expect(parentLinks).toContain('grandchild') + expect(parentLinks).not.toContain('other') + expect(parentLinks).not.toContain('nested') + + expect(otherLinks).toContain('other') + expect(otherLinks).toContain('nested') + expect(otherLinks).not.toContain('parent') + expect(otherLinks).not.toContain('grandchild') + }) + + test('103 response includes proper Link header format', async () => { + const response = await makeRequest(baseURL, '/') + const link = earlyHintsLinkHeader(response) + + expect(link).toMatch(/<[^>]+>;\s*rel=modulepreload;\s*as=script/) + }) + + test('CSS module assets are included in early hints', async () => { + const response = await makeRequest(baseURL, '/parent/child/grandchild') + const link = earlyHintsLinkHeader(response) + + expect(link).toContain('.css') + expect(link).toContain('rel=preload') + expect(link).toContain('as=style') + expect(link).toMatch(/parent-[^.]+\.css/) + expect(link).toMatch(/child-[^.]+\.css/) + expect(link).toMatch(/grandchild-[^.]+\.css/) + }) + + test('hints include both JS and CSS assets', async () => { + const response = await makeRequest(baseURL, '/other/nested') + const link = earlyHintsLinkHeader(response) + + expect(link).toContain('rel=modulepreload; as=script') + expect(link).toMatch(/other-[^.]+\.js/) + expect(link).toMatch(/nested-[^.]+\.js/) + expect(link).toContain('rel=preload; as=style') + expect(link).toMatch(/other-[^.]+\.css/) + expect(link).toMatch(/nested-[^.]+\.css/) + }) + + test('static and dynamic links are coalesced into one Early Hints response', async () => { + const response = await makeRequest(baseURL, '/') + + expect(response.earlyHints.length).toBe(1) + + const link = linkHeader(response.earlyHints[0]!) + + expect(link).toContain('rel=modulepreload; as=script') + expect(link).toContain('; rel=preconnect') + }) + + test('response Link header includes static and dynamic links', async () => { + const response = await makeRequest(baseURL, '/') + const link = linkHeader(response.finalHeaders) + + expect(link).toContain('rel=modulepreload; as=script') + expect(link).toContain('; rel=preconnect') + }) + + test('coalesced hints are skipped for redirects', async () => { + const response = await makeRequest(baseURL, '/redirect') + + expect(response.earlyHints.length).toBe(0) + expect(response.finalHeaders[':status']).toBe(307) + expect(linkHeader(response.finalHeaders)).toBe('') + }) +}) diff --git a/e2e/react-start/early-hints/tests/early-hints.spec.ts b/e2e/react-start/early-hints/tests/early-hints.spec.ts new file mode 100644 index 0000000000..aa0ca7d6fe --- /dev/null +++ b/e2e/react-start/early-hints/tests/early-hints.spec.ts @@ -0,0 +1,100 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import type { Page } from '@playwright/test' + +type ResourceTiming = { + name: string + initiatorType: string +} + +type EarlyHintsCdpEvent = { + headers: Record +} + +async function getResourceTimings(page: Page): Promise> { + return page.evaluate(() => + performance.getEntriesByType('resource').map((entry) => { + const resource = entry as PerformanceResourceTiming + return { + name: resource.name, + initiatorType: resource.initiatorType, + } + }), + ) +} + +function getHeader(headers: Record, name: string): string { + const value = headers[name] ?? headers[name.toLowerCase()] + + return Array.isArray(value) + ? value.join(', ') + : typeof value === 'string' + ? value + : '' +} + +test.describe('Early Hints - Browser Integration', () => { + test('passes Early Hints link headers to Chromium', async ({ page }) => { + const client = await page.context().newCDPSession(page) + const earlyHints: Array = [] + + client.on('Network.responseReceivedEarlyHints', (event) => { + earlyHints.push(event as EarlyHintsCdpEvent) + }) + await client.send('Network.enable') + + await page.goto('/') + await expect(page.getByTestId('home')).toBeVisible() + + expect(earlyHints).toHaveLength(1) + + const link = getHeader(earlyHints[0]!.headers, 'link') + expect(link).toContain('rel=modulepreload; as=script') + expect(link).toContain('; rel=preconnect') + }) + + test('app loads correctly with early hints enabled', async ({ page }) => { + await page.goto('/parent/child/grandchild') + await expect(page.getByTestId('grandchild')).toBeVisible() + await expect(page.getByTestId('parent')).toBeVisible() + await expect(page.getByTestId('child')).toBeVisible() + }) + + test('deep nested route loads route CSS assets', async ({ page }) => { + await page.goto('/parent/child/grandchild') + await expect(page.getByTestId('grandchild')).toBeVisible() + + const cssResources = await getResourceTimings(page) + expect( + cssResources.some((entry) => + /\/assets\/parent-[^/]+\.css$/.test(entry.name), + ), + ).toBe(true) + expect( + cssResources.some((entry) => + /\/assets\/child-[^/]+\.css$/.test(entry.name), + ), + ).toBe(true) + expect( + cssResources.some((entry) => + /\/assets\/grandchild-[^/]+\.css$/.test(entry.name), + ), + ).toBe(true) + }) + + test('navigation works with early hints enabled', async ({ page }) => { + await page.goto('/other/nested') + await expect(page.getByTestId('nested')).toBeVisible() + await expect(page.getByTestId('other')).toBeVisible() + }) +}) + +test.describe('Early Hints - Server Verification', () => { + test('server handles HTML requests with early hints enabled', async ({ + request, + }) => { + const response = await request.get('/') + expect(response.status()).toBe(200) + expect(response.headers()['content-type']).toContain('text/html') + }) +}) diff --git a/e2e/react-start/early-hints/tests/gen-certs.ts b/e2e/react-start/early-hints/tests/gen-certs.ts new file mode 100644 index 0000000000..25e6ed9ace --- /dev/null +++ b/e2e/react-start/early-hints/tests/gen-certs.ts @@ -0,0 +1,68 @@ +/** + * Generate TLS certs for HTTP/2 testing + */ +import { existsSync } from 'node:fs' +import { mkdir, writeFile } from 'node:fs/promises' +import { dirname } from 'node:path' +import { fileURLToPath } from 'node:url' + +const testDir = dirname(fileURLToPath(import.meta.url)) +const certDir = `${testDir}/.tmp/tls` + +if (existsSync(`${certDir}/server.crt`)) { + console.log('Certs already exist') + process.exit(0) +} + +const forge = await import('node-forge') +const { pki, md } = forge.default || forge + +// Generate CA +const caKeys = pki.rsa.generateKeyPair(2048) +const caCert = pki.createCertificate() +caCert.publicKey = caKeys.publicKey +caCert.serialNumber = '01' +caCert.validity.notBefore = new Date() +caCert.validity.notAfter = new Date(Date.now() + 365 * 24 * 60 * 60 * 1000) +caCert.setSubject([{ name: 'commonName', value: 'Test CA' }]) +caCert.setIssuer(caCert.subject.attributes) +caCert.setExtensions([ + { name: 'basicConstraints', cA: true }, + { name: 'keyUsage', keyCertSign: true, digitalSignature: true }, + { name: 'subjectKeyIdentifier' }, +]) +caCert.sign(caKeys.privateKey, md.sha256.create()) + +// Generate server cert +const serverKeys = pki.rsa.generateKeyPair(2048) +const serverCert = pki.createCertificate() +serverCert.publicKey = serverKeys.publicKey +serverCert.serialNumber = '02' +serverCert.validity.notBefore = new Date() +serverCert.validity.notAfter = new Date(Date.now() + 365 * 24 * 60 * 60 * 1000) +serverCert.setSubject([{ name: 'commonName', value: 'localhost' }]) +serverCert.setIssuer(caCert.subject.attributes) +serverCert.setExtensions([ + { name: 'basicConstraints', cA: false }, + { name: 'keyUsage', digitalSignature: true, keyEncipherment: true }, + { name: 'extKeyUsage', serverAuth: true }, + { + name: 'subjectAltName', + altNames: [ + { type: 2, value: 'localhost' }, + { type: 7, ip: '127.0.0.1' }, + { type: 7, ip: '::1' }, + ], + }, +]) +serverCert.sign(caKeys.privateKey, md.sha256.create()) + +await mkdir(certDir, { recursive: true }) +await writeFile(`${certDir}/ca.crt`, pki.certificateToPem(caCert)) +await writeFile(`${certDir}/server.crt`, pki.certificateToPem(serverCert)) +await writeFile( + `${certDir}/server.key`, + pki.privateKeyToPem(serverKeys.privateKey), +) + +console.log('Certs generated at', certDir) diff --git a/e2e/react-start/early-hints/tsconfig.json b/e2e/react-start/early-hints/tsconfig.json new file mode 100644 index 0000000000..3a9fb7cd71 --- /dev/null +++ b/e2e/react-start/early-hints/tsconfig.json @@ -0,0 +1,22 @@ +{ + "include": ["**/*.ts", "**/*.tsx"], + "compilerOptions": { + "strict": true, + "esModuleInterop": true, + "jsx": "react-jsx", + "module": "ESNext", + "moduleResolution": "Bundler", + "lib": ["DOM", "DOM.Iterable", "ES2022"], + "isolatedModules": true, + "resolveJsonModule": true, + "skipLibCheck": true, + "target": "ES2022", + "allowJs": true, + "forceConsistentCasingInFileNames": true, + "baseUrl": ".", + "paths": { + "~/*": ["./src/*"] + }, + "noEmit": true + } +} diff --git a/e2e/react-start/early-hints/vite.config.ts b/e2e/react-start/early-hints/vite.config.ts new file mode 100644 index 0000000000..0590c197a5 --- /dev/null +++ b/e2e/react-start/early-hints/vite.config.ts @@ -0,0 +1,10 @@ +import { defineConfig } from 'vite' +import { tanstackStart } from '@tanstack/react-start/plugin/vite' +import viteReact from '@vitejs/plugin-react' + +export default defineConfig({ + server: { + port: 3000, + }, + plugins: [tanstackStart(), viteReact()], +}) diff --git a/e2e/react-start/flamegraph-bench/package.json b/e2e/react-start/flamegraph-bench/package.json index 36d8393fb3..768c5f05b8 100644 --- a/e2e/react-start/flamegraph-bench/package.json +++ b/e2e/react-start/flamegraph-bench/package.json @@ -23,6 +23,6 @@ "autocannon": "^8.0.0", "concurrently": "9.2.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/e2e/react-start/hmr/.gitignore b/e2e/react-start/hmr/.gitignore index 229709a89d..3116396262 100644 --- a/e2e/react-start/hmr/.gitignore +++ b/e2e/react-start/hmr/.gitignore @@ -1,5 +1,7 @@ node_modules dist +dist-vite-* +dist-rsbuild-* test-results playwright-report port*.txt diff --git a/e2e/react-start/hmr/package.json b/e2e/react-start/hmr/package.json index 8682ec6ff0..3854488170 100644 --- a/e2e/react-start/hmr/package.json +++ b/e2e/react-start/hmr/package.json @@ -4,9 +4,13 @@ "sideEffects": false, "type": "module", "scripts": { - "dev": "vite dev --port 3000", - "dev:e2e": "vite dev --port $PORT", - "build": "vite build && tsc --noEmit", + "dev": "pnpm dev:vite --port 3000", + "dev:e2e": "pnpm dev:vite", + "dev:vite": "vite dev", + "dev:rsbuild": "rsbuild dev", + "build": "pnpm build:vite", + "build:vite": "vite build && tsc --noEmit", + "build:rsbuild": "rsbuild build && tsc --noEmit", "test:e2e": "MODE=dev playwright test --project=chromium" }, "dependencies": { @@ -17,6 +21,9 @@ }, "devDependencies": { "@playwright/test": "^1.50.1", + "@rsbuild/core": "^2.0.8", + "@rsbuild/plugin-react": "^2.0.0", + "@tailwindcss/postcss": "^4.2.2", "@tailwindcss/vite": "^4.2.2", "@tanstack/router-e2e-utils": "workspace:^", "@types/node": "^22.10.2", @@ -25,6 +32,45 @@ "tailwindcss": "^4.2.2", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" + }, + "nx": { + "targets": { + "test:e2e": { + "parallelism": false + }, + "test:e2e--vite-ssr": { + "parallelism": false + }, + "test:e2e--vite-ssr--bundled-dev": { + "parallelism": false + }, + "test:e2e--rsbuild-ssr": { + "parallelism": false + } + }, + "metadata": { + "playwrightModes": [ + { + "toolchain": "vite", + "mode": "ssr", + "env": { + "E2E_VITE_BUNDLED_DEV": "false" + } + }, + { + "toolchain": "vite", + "mode": "ssr", + "name": "bundled-dev", + "env": { + "E2E_VITE_BUNDLED_DEV": "true" + } + }, + { + "toolchain": "rsbuild", + "mode": "ssr" + } + ] + } } } diff --git a/e2e/react-start/hmr/playwright.config.ts b/e2e/react-start/hmr/playwright.config.ts index 0de7b74396..c159aad328 100644 --- a/e2e/react-start/hmr/playwright.config.ts +++ b/e2e/react-start/hmr/playwright.config.ts @@ -2,8 +2,15 @@ import { defineConfig, devices } from '@playwright/test' import { getTestServerPort } from '@tanstack/router-e2e-utils' import packageJson from './package.json' with { type: 'json' } -const PORT = await getTestServerPort(packageJson.name) +const toolchain = process.env.E2E_TOOLCHAIN ?? 'vite' +const e2ePortKey = + process.env.E2E_PORT_KEY ?? `${packageJson.name}-${toolchain}` +const distDir = process.env.E2E_DIST_DIR ?? 'dist' +const viteBundledDev = process.env.E2E_VITE_BUNDLED_DEV === 'true' +const PORT = await getTestServerPort(e2ePortKey) const baseURL = `http://localhost:${PORT}` +const devCommand = + toolchain === 'rsbuild' ? 'pnpm dev:rsbuild' : 'pnpm dev:vite' export default defineConfig({ testDir: './tests', @@ -18,13 +25,17 @@ export default defineConfig({ }, webServer: { - command: `pnpm dev:e2e`, + command: `${devCommand} --port ${PORT}`, url: baseURL, reuseExistingServer: !process.env.CI, stdout: 'pipe', env: { VITE_NODE_ENV: 'test', PORT: String(PORT), + E2E_TOOLCHAIN: toolchain, + E2E_DIST_DIR: distDir, + E2E_PORT_KEY: e2ePortKey, + E2E_VITE_BUNDLED_DEV: String(viteBundledDev), }, }, diff --git a/e2e/react-start/hmr/postcss.config.mjs b/e2e/react-start/hmr/postcss.config.mjs new file mode 100644 index 0000000000..a7f73a2d1d --- /dev/null +++ b/e2e/react-start/hmr/postcss.config.mjs @@ -0,0 +1,5 @@ +export default { + plugins: { + '@tailwindcss/postcss': {}, + }, +} diff --git a/e2e/react-start/hmr/rsbuild.config.ts b/e2e/react-start/hmr/rsbuild.config.ts new file mode 100644 index 0000000000..126e7d9888 --- /dev/null +++ b/e2e/react-start/hmr/rsbuild.config.ts @@ -0,0 +1,17 @@ +import { defineConfig } from '@rsbuild/core' +import { pluginReact } from '@rsbuild/plugin-react' +import { tanstackStart } from '@tanstack/react-start/plugin/rsbuild' + +const outDir = process.env.E2E_DIST_DIR ?? 'dist' + +export default defineConfig({ + plugins: [pluginReact({ splitChunks: false }), tanstackStart()], + output: { + distPath: { + root: outDir, + }, + }, + server: { + port: 3000, + }, +}) diff --git a/e2e/react-start/hmr/src/hmr/server-fn-hmr-entry.ts b/e2e/react-start/hmr/src/hmr/server-fn-hmr-entry.ts new file mode 100644 index 0000000000..4e185e55f8 --- /dev/null +++ b/e2e/react-start/hmr/src/hmr/server-fn-hmr-entry.ts @@ -0,0 +1,21 @@ +import { createServerFn } from '@tanstack/react-start' +import { + createServerFnHmrFactory, + serverFnHmrMarker, +} from './server-fn-hmr-factory' + +const serverOnlyImpl = createServerFnHmrFactory( + () => 'server-fn-hmr-baseline-result', +) + +const serverFnHmr = createServerFn().handler(async () => { + return { + result: await serverOnlyImpl(), + } +}) + +export { serverFnHmrMarker } + +export async function invokeServerFnHmr() { + return serverFnHmr() +} diff --git a/e2e/react-start/hmr/src/hmr/server-fn-hmr-factory.ts b/e2e/react-start/hmr/src/hmr/server-fn-hmr-factory.ts new file mode 100644 index 0000000000..f095ef78bb --- /dev/null +++ b/e2e/react-start/hmr/src/hmr/server-fn-hmr-factory.ts @@ -0,0 +1,4 @@ +import { createClientOnlyFn, createServerOnlyFn } from '@tanstack/react-start' + +export const createServerFnHmrFactory = createServerOnlyFn +export const serverFnHmrMarker = 'server-fn-hmr-baseline' diff --git a/e2e/react-start/hmr/src/routeTree.gen.ts b/e2e/react-start/hmr/src/routeTree.gen.ts index 89230cd190..d2baf5bef6 100644 --- a/e2e/react-start/hmr/src/routeTree.gen.ts +++ b/e2e/react-start/hmr/src/routeTree.gen.ts @@ -9,6 +9,7 @@ // Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. import { Route as rootRouteImport } from './routes/__root' +import { Route as ServerFnHmrRouteImport } from './routes/server-fn-hmr' import { Route as InputsRouteImport } from './routes/inputs' import { Route as ComponentHmrNamedSplitRouteImport } from './routes/component-hmr-named-split' import { Route as ComponentHmrNamedNosplitRouteImport } from './routes/component-hmr-named-nosplit' @@ -20,6 +21,11 @@ import { Route as ComponentHmrRouteImport } from './routes/component-hmr' import { Route as ChildRouteImport } from './routes/child' import { Route as IndexRouteImport } from './routes/index' +const ServerFnHmrRoute = ServerFnHmrRouteImport.update({ + id: '/server-fn-hmr', + path: '/server-fn-hmr', + getParentRoute: () => rootRouteImport, +} as any) const InputsRoute = InputsRouteImport.update({ id: '/inputs', path: '/inputs', @@ -86,6 +92,7 @@ export interface FileRoutesByFullPath { '/component-hmr-named-nosplit': typeof ComponentHmrNamedNosplitRoute '/component-hmr-named-split': typeof ComponentHmrNamedSplitRoute '/inputs': typeof InputsRoute + '/server-fn-hmr': typeof ServerFnHmrRoute } export interface FileRoutesByTo { '/': typeof IndexRoute @@ -98,6 +105,7 @@ export interface FileRoutesByTo { '/component-hmr-named-nosplit': typeof ComponentHmrNamedNosplitRoute '/component-hmr-named-split': typeof ComponentHmrNamedSplitRoute '/inputs': typeof InputsRoute + '/server-fn-hmr': typeof ServerFnHmrRoute } export interface FileRoutesById { __root__: typeof rootRouteImport @@ -111,6 +119,7 @@ export interface FileRoutesById { '/component-hmr-named-nosplit': typeof ComponentHmrNamedNosplitRoute '/component-hmr-named-split': typeof ComponentHmrNamedSplitRoute '/inputs': typeof InputsRoute + '/server-fn-hmr': typeof ServerFnHmrRoute } export interface FileRouteTypes { fileRoutesByFullPath: FileRoutesByFullPath @@ -125,6 +134,7 @@ export interface FileRouteTypes { | '/component-hmr-named-nosplit' | '/component-hmr-named-split' | '/inputs' + | '/server-fn-hmr' fileRoutesByTo: FileRoutesByTo to: | '/' @@ -137,6 +147,7 @@ export interface FileRouteTypes { | '/component-hmr-named-nosplit' | '/component-hmr-named-split' | '/inputs' + | '/server-fn-hmr' id: | '__root__' | '/' @@ -149,6 +160,7 @@ export interface FileRouteTypes { | '/component-hmr-named-nosplit' | '/component-hmr-named-split' | '/inputs' + | '/server-fn-hmr' fileRoutesById: FileRoutesById } export interface RootRouteChildren { @@ -162,10 +174,18 @@ export interface RootRouteChildren { ComponentHmrNamedNosplitRoute: typeof ComponentHmrNamedNosplitRoute ComponentHmrNamedSplitRoute: typeof ComponentHmrNamedSplitRoute InputsRoute: typeof InputsRoute + ServerFnHmrRoute: typeof ServerFnHmrRoute } declare module '@tanstack/react-router' { interface FileRoutesByPath { + '/server-fn-hmr': { + id: '/server-fn-hmr' + path: '/server-fn-hmr' + fullPath: '/server-fn-hmr' + preLoaderRoute: typeof ServerFnHmrRouteImport + parentRoute: typeof rootRouteImport + } '/inputs': { id: '/inputs' path: '/inputs' @@ -250,6 +270,7 @@ const rootRouteChildren: RootRouteChildren = { ComponentHmrNamedNosplitRoute: ComponentHmrNamedNosplitRoute, ComponentHmrNamedSplitRoute: ComponentHmrNamedSplitRoute, InputsRoute: InputsRoute, + ServerFnHmrRoute: ServerFnHmrRoute, } export const routeTree = rootRouteImport ._addFileChildren(rootRouteChildren) diff --git a/e2e/react-start/hmr/src/routes/__root.tsx b/e2e/react-start/hmr/src/routes/__root.tsx index c948044325..b2ec48fb70 100644 --- a/e2e/react-start/hmr/src/routes/__root.tsx +++ b/e2e/react-start/hmr/src/routes/__root.tsx @@ -10,7 +10,7 @@ import { useMatches, } from '@tanstack/react-router' import type { ReactNode } from 'react' -import appCss from '~/styles/app.css?url' +import '~/styles/app.css' export const Route = createRootRoute({ head: () => ({ @@ -18,7 +18,6 @@ export const Route = createRootRoute({ { charSet: 'utf-8' }, { name: 'viewport', content: 'width=device-width, initial-scale=1' }, ], - links: [{ rel: 'stylesheet', href: appCss }], }), loader: () => ({ crumb: 'Home', @@ -141,6 +140,12 @@ function RootContent() { label: 'Component HMR', detail: 'Base component refresh checks', }, + { + testId: 'server-fn-hmr-link', + to: '/server-fn-hmr', + label: 'Server Fn HMR', + detail: 'Transitive invalidation for server functions', + }, { testId: 'component-hmr-inline-split-link', to: '/component-hmr-inline-split', diff --git a/e2e/react-start/hmr/src/routes/server-fn-hmr.tsx b/e2e/react-start/hmr/src/routes/server-fn-hmr.tsx new file mode 100644 index 0000000000..770d8b4c9d --- /dev/null +++ b/e2e/react-start/hmr/src/routes/server-fn-hmr.tsx @@ -0,0 +1,78 @@ +import { createFileRoute } from '@tanstack/react-router' +import { useState } from 'react' +import { + invokeServerFnHmr, + serverFnHmrMarker, +} from '../hmr/server-fn-hmr-entry' + +export const Route = createFileRoute('/server-fn-hmr')({ + component: ServerFnHmrComponent, +}) + +function ServerFnHmrComponent() { + const [result, setResult] = useState(null) + const [error, setError] = useState(null) + + async function invokeServerFn() { + try { + const next = await invokeServerFnHmr() + setResult(next.result) + setError(null) + } catch (e) { + setResult(null) + setError(e instanceof Error ? e.message : String(e)) + } + } + + return ( +
    +
    +
    +

    Server function invalidation

    +

    + Server function HMR +

    +

    + This route validates that transitive compiler invalidation updates a + server function caller after HMR edits. +

    +
    +

    + {serverFnHmrMarker} +

    +
    + +
    + + createServerOnlyFn transitively +
    + +
    +
    +

    Result

    +

    + {result ?? 'idle'} +

    +
    +
    +

    Error

    +

    + {error ?? 'none'} +

    +
    +
    +
    + ) +} diff --git a/e2e/react-start/hmr/tests/app.spec.ts b/e2e/react-start/hmr/tests/app.spec.ts index 41fe19af7f..2793dbd932 100644 --- a/e2e/react-start/hmr/tests/app.spec.ts +++ b/e2e/react-start/hmr/tests/app.spec.ts @@ -1,8 +1,11 @@ import { expect } from '@playwright/test' -import type { ConsoleMessage } from '@playwright/test' -import { test } from '@tanstack/router-e2e-utils' -import { readFile, writeFile } from 'node:fs/promises' +import { + createHmrFileEditor, + replaceAll, + test, +} from '@tanstack/router-e2e-utils' import path from 'node:path' + import type { Page } from '@playwright/test' const whitelistErrors = [ @@ -10,56 +13,252 @@ const whitelistErrors = [ 'Failed to load resource: the server responded with a status of 504', ] -const routeFilenames = { - index: 'index.tsx', - root: '__root.tsx', - child: 'child.tsx', - inputs: 'inputs.tsx', - componentHmrInlineSplit: 'component-hmr-inline-split.tsx', - componentHmrInlineNosplit: 'component-hmr-inline-nosplit.tsx', - componentHmrNamedSplit: 'component-hmr-named-split.tsx', - componentHmrNamedNosplit: 'component-hmr-named-nosplit.tsx', - componentHmrInlineErrorSplit: 'component-hmr-inline-error-split.tsx', - componentHmrNamedErrorSplit: 'component-hmr-named-error-split.tsx', +const hmrExpect = expect.configure({ timeout: 20_000 }) +const isViteBundledDev = process.env.E2E_VITE_BUNDLED_DEV === 'true' + +const routeFilePaths = { + index: 'routes/index.tsx', + root: 'routes/__root.tsx', + child: 'routes/child.tsx', + inputs: 'routes/inputs.tsx', + componentHmrInlineSplit: 'routes/component-hmr-inline-split.tsx', + componentHmrInlineNosplit: 'routes/component-hmr-inline-nosplit.tsx', + componentHmrNamedSplit: 'routes/component-hmr-named-split.tsx', + componentHmrNamedNosplit: 'routes/component-hmr-named-nosplit.tsx', + componentHmrInlineErrorSplit: 'routes/component-hmr-inline-error-split.tsx', + componentHmrNamedErrorSplit: 'routes/component-hmr-named-error-split.tsx', + serverFnHmr: 'routes/server-fn-hmr.tsx', + serverFnHmrFactory: 'hmr/server-fn-hmr-factory.ts', } as const -type RouteFileKey = keyof typeof routeFilenames +type RouteFileKey = keyof typeof routeFilePaths const routeFiles = Object.fromEntries( - Object.entries(routeFilenames).map(([key, filename]) => [ + Object.entries(routeFilePaths).map(([key, relativePath]) => [ key, - path.join(process.cwd(), 'src/routes', filename), + path.join(process.cwd(), 'src', relativePath), ]), ) as Record -// Capture original file contents once so beforeEach can restore them -const originalContents: Partial> = {} - -async function captureOriginals() { - for (const [key, filePath] of Object.entries(routeFiles) as Array< - [RouteFileKey, string] - >) { - originalContents[key] = await readFile(filePath, 'utf8') - } +const routeFileRestoreChecks: Partial< + Record< + RouteFileKey, + { + url: string + testId: string + text: string + assert?: (page: Page) => Promise + } + > +> = { + index: { + url: '/', + testId: 'marker', + text: 'baseline', + assert: async (page) => { + await expect(page.getByTestId('crumb-/')).toHaveCount(0, { + timeout: 500, + }) + }, + }, + root: { + url: '/', + testId: 'root-component-marker', + text: 'root-component-baseline', + assert: async (page) => { + await expect(page.getByTestId('crumb-__root__')).toHaveText('Home', { + timeout: 500, + }) + }, + }, + child: { + url: '/child', + testId: 'child-greeting', + text: 'Hello', + assert: async (page) => { + await expect(page.getByTestId('crumb-/child')).toHaveText('Child', { + timeout: 500, + }) + }, + }, + inputs: { url: '/inputs', testId: 'inputs-marker', text: 'inputs-baseline' }, + componentHmrInlineSplit: { + url: '/component-hmr-inline-split', + testId: 'component-hmr-marker', + text: 'component-hmr-inline-split-baseline', + }, + componentHmrInlineNosplit: { + url: '/component-hmr-inline-nosplit', + testId: 'component-hmr-marker', + text: 'component-hmr-inline-nosplit-baseline', + }, + componentHmrNamedSplit: { + url: '/component-hmr-named-split', + testId: 'component-hmr-marker', + text: 'component-hmr-named-split-baseline', + }, + componentHmrNamedNosplit: { + url: '/component-hmr-named-nosplit', + testId: 'component-hmr-marker', + text: 'component-hmr-named-nosplit-baseline', + }, + componentHmrInlineErrorSplit: { + url: '/component-hmr-inline-error-split', + testId: 'component-hmr-marker', + text: 'component-hmr-inline-error-split-baseline', + }, + componentHmrNamedErrorSplit: { + url: '/component-hmr-named-error-split', + testId: 'component-hmr-marker', + text: 'component-hmr-named-error-split-baseline', + }, + serverFnHmrFactory: { + url: '/server-fn-hmr', + testId: 'server-fn-hmr-marker', + text: 'server-fn-hmr-baseline', + }, } -const capturePromise = captureOriginals() +function normalizeRouteSource(routeFileKey: RouteFileKey, source: string) { + let next = source -async function replaceRouteText( - routeFileKey: RouteFileKey, - from: string, - to: string, -) { - const filePath = routeFiles[routeFileKey] - const source = await readFile(filePath, 'utf8') - - if (!source.includes(from)) { - throw new Error(`Expected route file to include ${JSON.stringify(from)}`) + if (routeFileKey === 'index') { + next = next.replace( + "export const Route = createFileRoute('/')({\n loader: () => ({\n crumb: 'Index Added',\n }),\n component: Home,\n})", + "export const Route = createFileRoute('/')({\n component: Home,\n})", + ) + next = replaceAll(next, 'updated', 'baseline') } - await writeFile(filePath, source.replace(from, to)) + if (routeFileKey === 'root') { + for (const marker of [ + 'root-component-inline-baseline', + 'root-component-inline-updated', + ]) { + next = next.replace( + ` component: () => ,`, + ' component: RootComponent,', + ) + } + + for (const marker of [ + 'root-shell-inline-baseline', + 'root-shell-inline-updated', + ]) { + next = next.replace( + ` shellComponent: ({ children }) => {children},\n component: RootContent,`, + ' component: RootComponent,', + ) + } + + next = next.replace( + ' shellComponent: RootShell,\n component: RootContent,', + ' component: RootComponent,', + ) + + for (const marker of ['root-shell-baseline', 'root-shell-updated']) { + next = next.replace( + `function RootShell({ children }: { children: ReactNode }) {\n return {children}\n}\n\nfunction Breadcrumbs() {`, + 'function Breadcrumbs() {', + ) + } + + next = replaceAll(next, "crumb: 'Home Updated'", "crumb: 'Home'") + next = replaceAll(next, 'root-component-updated', 'root-component-baseline') + next = replaceAll(next, 'root-shell-updated', 'root-shell-baseline') + } + + if (routeFileKey === 'child') { + const beforeLoadBlock = + " beforeLoad: () => ({\n greeting: 'Hello',\n }),\n" + const loaderBlock = " loader: () => ({\n crumb: 'Child',\n }),\n" + + next = replaceAll(next, "greeting: 'Hi'", "greeting: 'Hello'") + next = replaceAll(next, "crumb: 'Child Updated Again'", "crumb: 'Child'") + next = replaceAll(next, "crumb: 'Child Updated'", "crumb: 'Child'") + + if (!next.includes(beforeLoadBlock)) { + next = next.replace( + ' component: Child,\n', + `${beforeLoadBlock} component: Child,\n`, + ) + } + if (!next.includes(loaderBlock)) { + const withLoaderAfterBeforeLoad = next.replace( + `${beforeLoadBlock} component: Child,\n`, + `${beforeLoadBlock}${loaderBlock} component: Child,\n`, + ) + next = + withLoaderAfterBeforeLoad === next + ? next.replace( + ' component: Child,\n', + `${loaderBlock} component: Child,\n`, + ) + : withLoaderAfterBeforeLoad + } + } + + const markerReplacements: Partial> = { + inputs: ['inputs-updated', 'inputs-baseline'], + componentHmrInlineSplit: [ + 'component-hmr-inline-split-updated', + 'component-hmr-inline-split-baseline', + ], + componentHmrInlineNosplit: [ + 'component-hmr-inline-nosplit-updated', + 'component-hmr-inline-nosplit-baseline', + ], + componentHmrNamedSplit: [ + 'component-hmr-named-split-updated', + 'component-hmr-named-split-baseline', + ], + componentHmrNamedNosplit: [ + 'component-hmr-named-nosplit-updated', + 'component-hmr-named-nosplit-baseline', + ], + componentHmrInlineErrorSplit: [ + 'component-hmr-inline-error-split-updated', + 'component-hmr-inline-error-split-baseline', + ], + componentHmrNamedErrorSplit: [ + 'component-hmr-named-error-split-updated', + 'component-hmr-named-error-split-baseline', + ], + } + const markerReplacement = markerReplacements[routeFileKey] + if (markerReplacement) { + next = replaceAll(next, markerReplacement[0], markerReplacement[1]) + } + + if (routeFileKey === 'serverFnHmrFactory') { + next = next.replace( + /^import \{ .* \} from '@tanstack\/react-start'$/m, + "import { createClientOnlyFn, createServerOnlyFn } from '@tanstack/react-start'", + ) + next = replaceAll( + next, + 'export const createServerFnHmrFactory = createClientOnlyFn', + 'export const createServerFnHmrFactory = createServerOnlyFn', + ) + next = replaceAll( + next, + 'server-fn-hmr-client-only', + 'server-fn-hmr-baseline', + ) + } + + return next } +const routeFileEditor = createHmrFileEditor({ + files: routeFiles, + normalizeSource: normalizeRouteSource, +}) +const capturePromise = routeFileEditor.capturePromise +const routeKeysPendingRestoreCheck = routeFileEditor.pendingRestoreKeys +const restoreRouteFiles = routeFileEditor.restoreFiles +const replaceRouteText = routeFileEditor.replaceText + async function replaceRouteTextAndWait( page: Page, routeFileKey: RouteFileKey, @@ -67,7 +266,12 @@ async function replaceRouteTextAndWait( to: string, assertion: () => Promise, ) { - await replaceRouteText(routeFileKey, from, to) + if (isViteBundledDev) { + // Rolldown may still be compiling a lazy route entry immediately after + // hydration. Avoid writing a follow-up edit while that compile is settling. + await page.waitForTimeout(500) + } + await routeFileEditor.replaceText(routeFileKey, from, to) await assertion() } @@ -76,54 +280,109 @@ async function rewriteRouteFile( routeFileKey: RouteFileKey, updater: (source: string) => string, assertion: () => Promise, + options: { allowNoop?: boolean } = {}, ) { - const filePath = routeFiles[routeFileKey] - const source = await readFile(filePath, 'utf8') - const updated = updater(source) - - if (updated === source) { - throw new Error(`Expected ${filePath} to change during rewrite`) + if (isViteBundledDev) { + await page.waitForTimeout(500) } - - await writeFile(filePath, updated) + await routeFileEditor.rewriteFile(routeFileKey, updater, options) await assertion() } /** - * Returns a promise that resolves once Vite logs a client HMR update - * for the given route filename. Must be called BEFORE the file write - * so the listener is in place when the message arrives. + * Waits for the router to observe the latest route module after an edit. + * This avoids bundler-specific HMR console message matching. */ -function onNextHmrUpdate(page: Page, routeFilename: string): Promise { - return new Promise((resolve) => { - const handler = (msg: ConsoleMessage) => { - const text = msg.text() - if ( - text.includes('[vite]') && - text.includes(routeFilename) && - (text.includes('hot updated') || text.includes('hmr update')) - ) { - page.off('console', handler) - resolve() +async function waitForRouteModuleUpdate( + page: Page, + routeId: string, + expectedCrumb: string, +) { + await page.waitForFunction( + ([nextRouteId, nextCrumb]) => { + const router = (window as any).__TSR_ROUTER__ + const route = router?.routesById?.[nextRouteId] + if (!route) { + return false } - } - page.on('console', handler) - }) + + const loader = route.options?.loader + if (typeof loader !== 'function') { + return false + } + + const loaderResult = loader() + return loaderResult?.crumb === nextCrumb + }, + [routeId, expectedCrumb], + { timeout: 20_000 }, + ) } async function waitForRouteRemovalReload(page: Page) { await page.waitForFunction(() => { const router = (window as any).__TSR_ROUTER__ - const match = router?.stores?.activeMatchesSnapshot?.state?.find( - (entry: any) => entry.routeId === '/child', - ) + const match = router?.stores?.matches + ?.get() + ?.find((entry: any) => entry.routeId === '/child') return !match?.invalid && match?.isFetching === false }) } +async function waitForServerRenderedText( + page: Page, + url: string, + text: string, +) { + const deadline = Date.now() + 20_000 + let lastError: unknown + + while (Date.now() < deadline) { + try { + const response = await page.request.get(url) + const body = await response.text() + + if (response.ok() && body.includes(text)) { + return + } + + lastError = new Error( + `Expected server HTML for ${url} to include ${JSON.stringify(text)}`, + ) + } catch (error) { + lastError = error + } + + await page.waitForTimeout(150) + } + + throw lastError +} + +async function waitForHydrationSafeReload( + page: Page, + url: string, + text: string, +) { + await waitForServerRenderedText(page, url, text) + // The client and SSR compilers can finish in different ticks. Give the + // browser-side module graph a quiet window after SSR has the expected HTML. + await page.waitForTimeout(750) +} + async function reloadPageAndWait(page: Page, url: string) { - await page.goto(url) + for (let attempt = 1; attempt <= 3; attempt++) { + try { + await page.goto(url, { waitUntil: 'domcontentloaded' }) + break + } catch (error) { + if (attempt === 3 || !String(error).includes('net::ERR_ABORTED')) { + throw error + } + await page.waitForTimeout(250) + } + } await page.getByTestId('hydrated').waitFor({ state: 'visible' }) } @@ -133,8 +392,79 @@ async function reloadPageAndWaitForText( testId: string, text: string, ) { - await reloadPageAndWait(page, url) - await expect(page.getByTestId(testId)).toHaveText(text) + const deadline = Date.now() + 20_000 + let lastError: unknown + + while (Date.now() < deadline) { + try { + await waitForHydrationSafeReload(page, url, text) + await reloadPageAndWait(page, url) + await expect(page.getByTestId(testId)).toHaveText(text, { + timeout: 1_000, + }) + return + } catch (error) { + lastError = error + await page.waitForTimeout(150) + } + } + + throw lastError +} + +async function waitForServerFnHmrReady(page: Page) { + await page.getByTestId('hydrated').waitFor({ state: 'visible' }) + await expect(page.getByTestId('invoke-server-fn-hmr')).toBeVisible() +} + +async function waitForServerFnHmrMarker(page: Page, text: string) { + await waitForServerFnHmrReady(page) + await hmrExpect(page.getByTestId('server-fn-hmr-marker')).toHaveText(text) + await hmrExpect(page.getByTestId('server-fn-hmr-result')).toBeVisible() +} + +async function waitForRestoredRouteFile( + page: Page, + routeFileKey: RouteFileKey, +) { + const restoreCheck = routeFileRestoreChecks[routeFileKey] + + if (!restoreCheck) { + return + } + + // Restores happen immediately after a previous edit, so poll until the dev + // server has actually observed the restored file before the next test starts. + const deadline = Date.now() + 20_000 + let lastError: unknown + + while (Date.now() < deadline) { + try { + await waitForHydrationSafeReload( + page, + restoreCheck.url, + restoreCheck.text, + ) + await reloadPageAndWait(page, restoreCheck.url) + await expect(page.getByTestId(restoreCheck.testId)).toHaveText( + restoreCheck.text, + { timeout: 500 }, + ) + await restoreCheck.assert?.(page) + await page.waitForTimeout(500) + await expect(page.getByTestId(restoreCheck.testId)).toHaveText( + restoreCheck.text, + { timeout: 1_000 }, + ) + await restoreCheck.assert?.(page) + return + } catch (error) { + lastError = error + await page.waitForTimeout(150) + } + } + + throw lastError } async function seedHomeState(page: Page) { @@ -170,32 +500,33 @@ async function expectComponentHmrStatePreserved(page: Page) { test.describe('react-start hmr', () => { test.use({ whitelistErrors }) - test.beforeEach(async () => { + test.beforeEach(async ({ page }) => { await capturePromise - for (const [key, filePath] of Object.entries(routeFiles) as Array< - [RouteFileKey, string] - >) { - const content = originalContents[key] - if (content === undefined) continue - const current = await readFile(filePath, 'utf8') - if (current !== content) { - await writeFile(filePath, content) - } + const pendingRouteKeys = Array.from(routeKeysPendingRestoreCheck) + const restoredRouteKeys = await restoreRouteFiles(pendingRouteKeys) + for (const routeFileKey of restoredRouteKeys) { + routeKeysPendingRestoreCheck.add(routeFileKey) + } + + const routeKeysToCheck = Array.from(routeKeysPendingRestoreCheck) + routeKeysPendingRestoreCheck.clear() + + for (const routeFileKey of routeKeysToCheck) { + await waitForRestoredRouteFile(page, routeFileKey) + } + }) + + test.afterEach(async () => { + await capturePromise + const restoredRouteKeys = await restoreRouteFiles() + for (const routeFileKey of restoredRouteKeys) { + routeKeysPendingRestoreCheck.add(routeFileKey) } }) test.afterAll(async () => { await capturePromise - for (const [key, filePath] of Object.entries(routeFiles) as Array< - [RouteFileKey, string] - >) { - const content = originalContents[key] - if (content === undefined) continue - const current = await readFile(filePath, 'utf8') - if (current !== content) { - await writeFile(filePath, content) - } - } + await restoreRouteFiles() }) test('preserves local state for code-split route component HMR', async ({ @@ -216,7 +547,7 @@ test.describe('react-start hmr', () => { 'baseline', 'updated', async () => { - await expect(page.getByTestId('marker')).toHaveText('updated') + await hmrExpect(page.getByTestId('marker')).toHaveText('updated') }, ) @@ -240,7 +571,8 @@ test.describe('react-start hmr', () => { "crumb: 'Home'", "crumb: 'Home Updated'", async () => { - await expect(page.getByTestId('crumb-__root__')).toHaveText( + await waitForRouteModuleUpdate(page, '__root__', 'Home Updated') + await hmrExpect(page.getByTestId('crumb-__root__')).toHaveText( 'Home Updated', ) }, @@ -264,7 +596,8 @@ test.describe('react-start hmr', () => { "crumb: 'Child'", "crumb: 'Child Updated'", async () => { - await expect(page.getByTestId('crumb-/child')).toHaveText( + await waitForRouteModuleUpdate(page, '/child', 'Child Updated') + await hmrExpect(page.getByTestId('crumb-/child')).toHaveText( 'Child Updated', ) }, @@ -293,7 +626,8 @@ test.describe('react-start hmr', () => { "export const Route = createFileRoute('/')({\n loader: () => ({\n crumb: 'Index Added',\n }),\n component: Home,\n})", ), async () => { - await expect(page.getByTestId('crumb-/')).toHaveText('Index Added') + await waitForRouteModuleUpdate(page, '/', 'Index Added') + await hmrExpect(page.getByTestId('crumb-/')).toHaveText('Index Added') }, ) @@ -315,7 +649,7 @@ test.describe('react-start hmr', () => { source.replace(" loader: () => ({\n crumb: 'Child',\n }),\n", ''), async () => { await waitForRouteRemovalReload(page) - await expect(page.getByTestId('crumb-/child')).toHaveCount(0) + await hmrExpect(page.getByTestId('crumb-/child')).toHaveCount(0) }, ) @@ -332,26 +666,34 @@ test.describe('react-start hmr', () => { await page.getByTestId('hydrated').waitFor({ state: 'visible' }) // First edit: change child loader while on / - const hmr1 = onNextHmrUpdate(page, 'child.tsx') - await replaceRouteText('child', "crumb: 'Child'", "crumb: 'Child Updated'") - await hmr1 + await replaceRouteTextAndWait( + page, + 'child', + "crumb: 'Child'", + "crumb: 'Child Updated'", + async () => { + await waitForRouteModuleUpdate(page, '/child', 'Child Updated') + }, + ) // Second edit: change child loader again while still on / - const hmr2 = onNextHmrUpdate(page, 'child.tsx') - await replaceRouteText( + await replaceRouteTextAndWait( + page, 'child', "crumb: 'Child Updated'", "crumb: 'Child Updated Again'", + async () => { + await waitForRouteModuleUpdate(page, '/child', 'Child Updated Again') + }, ) - await hmr2 + await waitForHydrationSafeReload(page, '/child', 'Child Updated Again') // Now navigate to /child — should see the LATEST value await page.getByTestId('child-link').click() await expect(page.getByTestId('child')).toBeVisible() - await expect(page.getByTestId('crumb-/child')).toHaveText( + await hmrExpect(page.getByTestId('crumb-/child')).toHaveText( 'Child Updated Again', - { timeout: 10000 }, ) }) @@ -376,7 +718,8 @@ test.describe('react-start hmr', () => { "crumb: 'Home'", "crumb: 'Home Updated'", async () => { - await expect(page.getByTestId('crumb-__root__')).toHaveText( + await waitForRouteModuleUpdate(page, '__root__', 'Home Updated') + await hmrExpect(page.getByTestId('crumb-__root__')).toHaveText( 'Home Updated', ) }, @@ -387,8 +730,12 @@ test.describe('react-start hmr', () => { }) test('preserves uncontrolled input state during HMR', async ({ page }) => { - await page.goto('/inputs') - await page.getByTestId('hydrated').waitFor({ state: 'visible' }) + await reloadPageAndWaitForText( + page, + '/inputs', + 'inputs-marker', + 'inputs-baseline', + ) // Type into both uncontrolled inputs await page.getByTestId('input-first').fill('first value') @@ -405,7 +752,7 @@ test.describe('react-start hmr', () => { 'inputs-baseline', 'inputs-updated', async () => { - await expect(page.getByTestId('inputs-marker')).toHaveText( + await hmrExpect(page.getByTestId('inputs-marker')).toHaveText( 'inputs-updated', ) }, @@ -430,7 +777,7 @@ test.describe('react-start hmr', () => { "greeting: 'Hello'", "greeting: 'Hi'", async () => { - await expect(page.getByTestId('child-greeting')).toHaveText('Hi') + await hmrExpect(page.getByTestId('child-greeting')).toHaveText('Hi') }, ) @@ -461,8 +808,9 @@ test.describe('react-start hmr', () => { ), async () => { await waitForRouteRemovalReload(page) - await expect(page.getByTestId('child-greeting')).toHaveCount(0) + await hmrExpect(page.getByTestId('child-greeting')).toHaveCount(0) }, + { allowNoop: true }, ) // Root state should be preserved @@ -505,7 +853,7 @@ test.describe('react-start hmr', () => { 'root-component-inline-baseline', 'root-component-inline-updated', async () => { - await expect(page.getByTestId('root-component-marker')).toHaveText( + await hmrExpect(page.getByTestId('root-component-marker')).toHaveText( 'root-component-inline-updated', ) }, @@ -523,7 +871,7 @@ test.describe('react-start hmr', () => { 'root-component-baseline', 'root-component-updated', async () => { - await expect(page.getByTestId('root-component-marker')).toHaveText( + await hmrExpect(page.getByTestId('root-component-marker')).toHaveText( 'root-component-updated', ) }, @@ -561,7 +909,7 @@ test.describe('react-start hmr', () => { 'root-shell-inline-baseline', 'root-shell-inline-updated', async () => { - await expect(page.getByTestId('root-shell-marker')).toHaveText( + await hmrExpect(page.getByTestId('root-shell-marker')).toHaveText( 'root-shell-inline-updated', ) }, @@ -604,7 +952,7 @@ test.describe('react-start hmr', () => { 'root-shell-baseline', 'root-shell-updated', async () => { - await expect(page.getByTestId('root-shell-marker')).toHaveText( + await hmrExpect(page.getByTestId('root-shell-marker')).toHaveText( 'root-shell-updated', ) }, @@ -622,7 +970,7 @@ test.describe('react-start hmr', () => { 'component-hmr-inline-split-baseline', 'component-hmr-inline-split-updated', async () => { - await expect(page.getByTestId('component-hmr-marker')).toHaveText( + await hmrExpect(page.getByTestId('component-hmr-marker')).toHaveText( 'component-hmr-inline-split-updated', ) }, @@ -642,7 +990,7 @@ test.describe('react-start hmr', () => { 'component-hmr-inline-nosplit-baseline', 'component-hmr-inline-nosplit-updated', async () => { - await expect(page.getByTestId('component-hmr-marker')).toHaveText( + await hmrExpect(page.getByTestId('component-hmr-marker')).toHaveText( 'component-hmr-inline-nosplit-updated', ) }, @@ -662,7 +1010,7 @@ test.describe('react-start hmr', () => { 'component-hmr-named-split-baseline', 'component-hmr-named-split-updated', async () => { - await expect(page.getByTestId('component-hmr-marker')).toHaveText( + await hmrExpect(page.getByTestId('component-hmr-marker')).toHaveText( 'component-hmr-named-split-updated', ) }, @@ -682,7 +1030,7 @@ test.describe('react-start hmr', () => { 'component-hmr-named-nosplit-baseline', 'component-hmr-named-nosplit-updated', async () => { - await expect(page.getByTestId('component-hmr-marker')).toHaveText( + await hmrExpect(page.getByTestId('component-hmr-marker')).toHaveText( 'component-hmr-named-nosplit-updated', ) }, @@ -702,7 +1050,7 @@ test.describe('react-start hmr', () => { 'component-hmr-inline-error-split-baseline', 'component-hmr-inline-error-split-updated', async () => { - await expect(page.getByTestId('component-hmr-marker')).toHaveText( + await hmrExpect(page.getByTestId('component-hmr-marker')).toHaveText( 'component-hmr-inline-error-split-updated', ) }, @@ -722,7 +1070,7 @@ test.describe('react-start hmr', () => { 'component-hmr-named-error-split-baseline', 'component-hmr-named-error-split-updated', async () => { - await expect(page.getByTestId('component-hmr-marker')).toHaveText( + await hmrExpect(page.getByTestId('component-hmr-marker')).toHaveText( 'component-hmr-named-error-split-updated', ) }, @@ -730,4 +1078,53 @@ test.describe('react-start hmr', () => { await expectComponentHmrStatePreserved(page) }) + + test('invalidates transitive server function compiler state during HMR', async ({ + page, + }) => { + await page.goto('/server-fn-hmr') + await waitForServerFnHmrMarker(page, 'server-fn-hmr-baseline') + await page.getByTestId('invoke-server-fn-hmr').click() + await expect(page.getByTestId('server-fn-hmr-result')).toHaveText( + 'server-fn-hmr-baseline-result', + ) + await expect(page.getByTestId('server-fn-hmr-error')).toHaveText('none') + + await replaceRouteText( + 'serverFnHmrFactory', + "createServerOnlyFn\nexport const serverFnHmrMarker = 'server-fn-hmr-baseline'", + "createClientOnlyFn\nexport const serverFnHmrMarker = 'server-fn-hmr-client-only'", + ) + + await reloadPageAndWaitForText( + page, + '/server-fn-hmr', + 'server-fn-hmr-marker', + 'server-fn-hmr-client-only', + ) + + await page.getByTestId('invoke-server-fn-hmr').click() + await expect(page.getByTestId('server-fn-hmr-result')).toHaveText('idle') + await expect(page.getByTestId('server-fn-hmr-error')).toContainText( + 'createClientOnlyFn() functions can only be called on the client!', + ) + + await replaceRouteText( + 'serverFnHmrFactory', + "createClientOnlyFn\nexport const serverFnHmrMarker = 'server-fn-hmr-client-only'", + "createServerOnlyFn\nexport const serverFnHmrMarker = 'server-fn-hmr-baseline'", + ) + await reloadPageAndWaitForText( + page, + '/server-fn-hmr', + 'server-fn-hmr-marker', + 'server-fn-hmr-baseline', + ) + + await page.getByTestId('invoke-server-fn-hmr').click() + await expect(page.getByTestId('server-fn-hmr-result')).toHaveText( + 'server-fn-hmr-baseline-result', + ) + await expect(page.getByTestId('server-fn-hmr-error')).toHaveText('none') + }) }) diff --git a/e2e/react-start/hmr/tests/setup/global.setup.ts b/e2e/react-start/hmr/tests/setup/global.setup.ts index 871fd6e6e4..fb9aad22ae 100644 --- a/e2e/react-start/hmr/tests/setup/global.setup.ts +++ b/e2e/react-start/hmr/tests/setup/global.setup.ts @@ -6,12 +6,17 @@ import { } from '@tanstack/router-e2e-utils' import packageJson from '../../package.json' with { type: 'json' } +function getE2EPortKey() { + const toolchain = process.env.E2E_TOOLCHAIN ?? 'vite' + return process.env.E2E_PORT_KEY ?? `${packageJson.name}-${toolchain}` +} + export default async function setup() { - await e2eStartDummyServer(packageJson.name) + const e2ePortKey = getE2EPortKey() - if (process.env.MODE !== 'dev') return + await e2eStartDummyServer(e2ePortKey) - const port = await getTestServerPort(packageJson.name) + const port = await getTestServerPort(e2ePortKey) const baseURL = `http://localhost:${port}` await waitForServer(baseURL) diff --git a/e2e/react-start/hmr/tests/setup/global.teardown.ts b/e2e/react-start/hmr/tests/setup/global.teardown.ts index 62fd79911c..e17856dd82 100644 --- a/e2e/react-start/hmr/tests/setup/global.teardown.ts +++ b/e2e/react-start/hmr/tests/setup/global.teardown.ts @@ -1,6 +1,11 @@ import { e2eStopDummyServer } from '@tanstack/router-e2e-utils' import packageJson from '../../package.json' with { type: 'json' } +function getE2EPortKey() { + const toolchain = process.env.E2E_TOOLCHAIN ?? 'vite' + return process.env.E2E_PORT_KEY ?? `${packageJson.name}-${toolchain}` +} + export default async function teardown() { - await e2eStopDummyServer(packageJson.name) + await e2eStopDummyServer(getE2EPortKey()) } diff --git a/e2e/react-start/hmr/vite.config.ts b/e2e/react-start/hmr/vite.config.ts index b30e7946c9..17ebc31ca4 100644 --- a/e2e/react-start/hmr/vite.config.ts +++ b/e2e/react-start/hmr/vite.config.ts @@ -3,8 +3,15 @@ import { tanstackStart } from '@tanstack/react-start/plugin/vite' import tailwindcss from '@tailwindcss/vite' import viteReact from '@vitejs/plugin-react' +const outDir = process.env.E2E_DIST_DIR ?? 'dist' +const bundledDev = process.env.E2E_VITE_BUNDLED_DEV === 'true' + export default defineConfig({ resolve: { tsconfigPaths: true }, + experimental: bundledDev ? { bundledDev: true } : undefined, + build: { + outDir, + }, server: { port: 3000, }, diff --git a/e2e/react-start/i18n-paraglide/package.json b/e2e/react-start/i18n-paraglide/package.json index 69dd0a0a2f..bfb7b5eb26 100644 --- a/e2e/react-start/i18n-paraglide/package.json +++ b/e2e/react-start/i18n-paraglide/package.json @@ -28,6 +28,6 @@ "@vitejs/plugin-react": "^6.0.1", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/e2e/vue-start/basic-vue-query/test-results/.last-run.json b/e2e/react-start/i18n-paraglide/test-results/.last-run.json similarity index 100% rename from e2e/vue-start/basic-vue-query/test-results/.last-run.json rename to e2e/react-start/i18n-paraglide/test-results/.last-run.json diff --git a/e2e/react-start/import-protection-custom-config/package.json b/e2e/react-start/import-protection-custom-config/package.json index ee633ffe39..1175bd4ac0 100644 --- a/e2e/react-start/import-protection-custom-config/package.json +++ b/e2e/react-start/import-protection-custom-config/package.json @@ -16,8 +16,7 @@ "@tanstack/react-router": "workspace:^", "@tanstack/react-start": "workspace:^", "react": "^19.0.0", - "react-dom": "^19.0.0", - "vite": "^8.0.0" + "react-dom": "^19.0.0" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -25,7 +24,9 @@ "@types/node": "^22.10.2", "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", + "@vitejs/plugin-react": "^6.0.1", "srvx": "^0.11.9", - "typescript": "^6.0.2" + "typescript": "^6.0.2", + "vite": "^8.0.14" } } diff --git a/e2e/react-start/import-protection-custom-config/vite.config.ts b/e2e/react-start/import-protection-custom-config/vite.config.ts index 670af29b24..1303c589df 100644 --- a/e2e/react-start/import-protection-custom-config/vite.config.ts +++ b/e2e/react-start/import-protection-custom-config/vite.config.ts @@ -1,4 +1,5 @@ import { defineConfig } from 'vite' +import viteReact from '@vitejs/plugin-react' import { tanstackStart } from '@tanstack/react-start/plugin/vite' // Allow env var to override the import protection behavior. @@ -29,5 +30,6 @@ export default defineConfig({ }, }, }), + viteReact(), ], }) diff --git a/e2e/react-start/import-protection/package.json b/e2e/react-start/import-protection/package.json index 5464e40b94..e4ad4a79ba 100644 --- a/e2e/react-start/import-protection/package.json +++ b/e2e/react-start/import-protection/package.json @@ -4,10 +4,14 @@ "sideEffects": false, "type": "module", "scripts": { - "dev": "vite dev --port 3000", - "dev:e2e": "vite dev", - "build": "vite build && tsc --noEmit", - "start": "pnpx srvx --prod -s ../client dist/server/server.js", + "dev": "pnpm dev:vite --port 3000", + "dev:e2e": "pnpm dev:vite", + "dev:vite": "vite dev", + "dev:rsbuild": "rsbuild dev", + "build": "pnpm build:vite", + "build:vite": "vite build && tsc --noEmit", + "build:rsbuild": "rsbuild build && tsc --noEmit", + "start": "node server.js", "test:e2e:mockMode": "rm -rf node_modules/.vite; rm -rf port*.txt; playwright test --project=chromium", "test:e2e:errorMode": "rm -rf node_modules/.vite; rm -rf port*.txt; BEHAVIOR=error playwright test --project=chromium", "test:e2e": "pnpm run test:e2e:mockMode && pnpm run test:e2e:errorMode" @@ -17,16 +21,58 @@ "@tanstack/react-start": "workspace:^", "react": "^19.0.0", "react-dom": "^19.0.0", - "react-tweet": "^3.3.0", - "vite": "^8.0.0" + "react-tweet": "^3.3.0" }, "devDependencies": { "@playwright/test": "^1.50.1", + "@rsbuild/core": "^2.0.8", + "@rsbuild/plugin-react": "^2.0.0", "@tanstack/router-e2e-utils": "workspace:^", "@types/node": "^22.10.2", "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", + "@vitejs/plugin-react": "^6.0.1", "srvx": "^0.11.9", - "typescript": "^6.0.2" + "typescript": "^6.0.2", + "vite": "^8.0.14" + }, + "nx": { + "targets": { + "test:e2e": { + "parallelism": false + }, + "test:e2e--vite-ssr": { + "parallelism": false + }, + "test:e2e--vite-ssr--bundled-dev": { + "parallelism": false + }, + "test:e2e--rsbuild-ssr": { + "parallelism": false + } + }, + "metadata": { + "playwrightModes": [ + { + "toolchain": "vite", + "mode": "ssr", + "env": { + "E2E_VITE_BUNDLED_DEV": "false" + } + }, + { + "toolchain": "vite", + "mode": "ssr", + "name": "bundled-dev", + "env": { + "E2E_VITE_BUNDLED_DEV": "true" + } + }, + { + "toolchain": "rsbuild", + "mode": "ssr" + } + ] + } } } diff --git a/e2e/react-start/import-protection/playwright.config.ts b/e2e/react-start/import-protection/playwright.config.ts index 67c9da8531..ac239f36fe 100644 --- a/e2e/react-start/import-protection/playwright.config.ts +++ b/e2e/react-start/import-protection/playwright.config.ts @@ -3,8 +3,16 @@ import { getTestServerPort } from '@tanstack/router-e2e-utils' import { isErrorMode } from './tests/utils/isErrorMode' import packageJson from './package.json' with { type: 'json' } -const PORT = await getTestServerPort(packageJson.name) +const toolchain = process.env.E2E_TOOLCHAIN ?? 'vite' +const viteBundledDev = process.env.E2E_VITE_BUNDLED_DEV === 'true' +const e2ePortKey = + process.env.E2E_PORT_KEY ?? + `${packageJson.name}-${toolchain}${viteBundledDev ? '-bundled-dev' : ''}` +const distDir = process.env.E2E_DIST_DIR ?? 'dist' +const PORT = await getTestServerPort(e2ePortKey) const baseURL = `http://localhost:${PORT}` +const buildCommand = + toolchain === 'rsbuild' ? 'pnpm build:rsbuild' : 'pnpm build:vite' console.log('running in error mode:', isErrorMode.toString()) @@ -28,11 +36,18 @@ export default defineConfig({ ? {} : { webServer: { - command: `rm -f webserver-build.log webserver-dev.log violations.build.json violations.dev.json && VITE_SERVER_PORT=${PORT} pnpm build > webserver-build.log 2>&1 && PORT=${PORT} VITE_SERVER_PORT=${PORT} pnpm start`, + command: `rm -f webserver-build.log webserver-dev.log violations.build.json violations.dev.json && VITE_SERVER_PORT=${PORT} PORT=${PORT} ${buildCommand} > webserver-build.log 2>&1 && PORT=${PORT} VITE_SERVER_PORT=${PORT} pnpm start`, url: baseURL, reuseExistingServer: !process.env.CI, stdout: 'pipe', cwd: import.meta.dirname, + env: { + PORT: String(PORT), + VITE_SERVER_PORT: String(PORT), + E2E_DIST_DIR: distDir, + E2E_PORT_KEY: e2ePortKey, + E2E_VITE_BUNDLED_DEV: String(viteBundledDev), + }, }, }), diff --git a/e2e/react-start/import-protection/rsbuild.config.ts b/e2e/react-start/import-protection/rsbuild.config.ts new file mode 100644 index 0000000000..2547027028 --- /dev/null +++ b/e2e/react-start/import-protection/rsbuild.config.ts @@ -0,0 +1,19 @@ +import { defineConfig } from '@rsbuild/core' +import { pluginReact } from '@rsbuild/plugin-react' +import { tanstackStart } from '@tanstack/react-start/plugin/rsbuild' +import { getStartModeConfig } from './start-mode-config' + +const outDir = process.env.E2E_DIST_DIR ?? 'dist' +const startModeConfig = getStartModeConfig() + +export default defineConfig({ + plugins: [pluginReact(), tanstackStart(startModeConfig)], + output: { + distPath: { + root: outDir, + }, + }, + server: { + port: 3000, + }, +}) diff --git a/e2e/react-start/import-protection/server.js b/e2e/react-start/import-protection/server.js new file mode 100644 index 0000000000..6d53885821 --- /dev/null +++ b/e2e/react-start/import-protection/server.js @@ -0,0 +1,57 @@ +import fs from 'node:fs' +import path from 'node:path' +import { spawn } from 'node:child_process' +import { pathToFileURL } from 'node:url' + +const distDir = process.env.E2E_DIST_DIR || 'dist' + +function resolveDistClientDir() { + return path.resolve(distDir, 'client') +} + +function resolveDistServerEntryPath() { + const serverJsPath = path.resolve(distDir, 'server', 'server.js') + if (fs.existsSync(serverJsPath)) { + return serverJsPath + } + + const indexJsPath = path.resolve(distDir, 'server', 'index.js') + if (fs.existsSync(indexJsPath)) { + return indexJsPath + } + + return serverJsPath +} + +export function resolveStartCommand() { + const distClientDir = resolveDistClientDir() + const distServerEntryPath = resolveDistServerEntryPath() + return `srvx --prod -s ${JSON.stringify(distClientDir)} ${JSON.stringify(distServerEntryPath)}` +} + +export function start() { + const child = spawn( + 'srvx', + ['--prod', '-s', resolveDistClientDir(), resolveDistServerEntryPath()], + { + stdio: 'inherit', + shell: process.platform === 'win32', + }, + ) + + child.on('exit', (code, signal) => { + if (signal) { + process.kill(process.pid, signal) + return + } + + process.exit(code ?? 0) + }) +} + +if ( + process.argv[1] && + import.meta.url === pathToFileURL(process.argv[1]).href +) { + start() +} diff --git a/e2e/react-start/import-protection/src/routes/__root.tsx b/e2e/react-start/import-protection/src/routes/__root.tsx index 0b6dd5245d..d0d872942b 100644 --- a/e2e/react-start/import-protection/src/routes/__root.tsx +++ b/e2e/react-start/import-protection/src/routes/__root.tsx @@ -30,6 +30,7 @@ const navLinks = linkOptions([ { to: '/noexternal-client-pkg', label: 'noExternal Client Pkg' }, { to: '/alias-path-leak', label: 'Alias Path Leak' }, { to: '/non-alias-namespace-leak', label: 'Non-Alias Namespace Leak' }, + { to: '/type-only-protected-import', label: 'Type-Only Protected Import' }, ]) function RootComponent() { diff --git a/e2e/react-start/import-protection/src/routes/type-only-protected-import.tsx b/e2e/react-start/import-protection/src/routes/type-only-protected-import.tsx new file mode 100644 index 0000000000..8f20802637 --- /dev/null +++ b/e2e/react-start/import-protection/src/routes/type-only-protected-import.tsx @@ -0,0 +1,32 @@ +import { createFileRoute } from '@tanstack/react-router' +import { type RequestHandler } from '@tanstack/react-start/server' +import type { TypeOnlySecret } from '../violations/type-only.server' + +type TypeOnlyStatus = TypeOnlySecret & { + requestHandler?: RequestHandler> +} + +const status: TypeOnlyStatus = { + message: 'type-only protected imports are safe', +} + +function getStatusMessage(): string { + return status.message +} + +export const Route = createFileRoute('/type-only-protected-import')({ + component: TypeOnlyProtectedImport, +}) + +function TypeOnlyProtectedImport() { + return ( +
    +

    + Type-Only Protected Import +

    +

    + {getStatusMessage()} +

    +
    + ) +} diff --git a/e2e/react-start/import-protection/src/violations/type-only.server.ts b/e2e/react-start/import-protection/src/violations/type-only.server.ts new file mode 100644 index 0000000000..e2fd08c4b6 --- /dev/null +++ b/e2e/react-start/import-protection/src/violations/type-only.server.ts @@ -0,0 +1,5 @@ +export type TypeOnlySecret = { + message: string +} + +export const runtimeSecret = 'this value must never be imported by the client' diff --git a/e2e/react-start/import-protection/start-mode-config.ts b/e2e/react-start/import-protection/start-mode-config.ts new file mode 100644 index 0000000000..bfdb20a2cd --- /dev/null +++ b/e2e/react-start/import-protection/start-mode-config.ts @@ -0,0 +1,13 @@ +export function getStartModeConfig() { + const behavior = (process.env.BEHAVIOR ?? 'mock') as 'mock' | 'error' + + return { + importProtection: { + behavior, + log: 'always' as const, + onViolation: (info: unknown) => { + void info + }, + }, + } +} diff --git a/e2e/react-start/import-protection/tests/error-mode.setup.ts b/e2e/react-start/import-protection/tests/error-mode.setup.ts index d90f3c0f62..c844d59e73 100644 --- a/e2e/react-start/import-protection/tests/error-mode.setup.ts +++ b/e2e/react-start/import-protection/tests/error-mode.setup.ts @@ -19,6 +19,12 @@ import type { FullConfig } from '@playwright/test' * `error-dev-result.json`. */ +const toolchain = process.env.E2E_TOOLCHAIN ?? 'vite' +const viteBundledDev = process.env.E2E_VITE_BUNDLED_DEV === 'true' +const e2ePortKey = + process.env.E2E_PORT_KEY ?? + `${packageJson.name}-${toolchain}${viteBundledDev ? '-bundled-dev' : ''}` + async function waitForHttpOk(url: string, timeoutMs: number): Promise { const start = Date.now() // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition @@ -65,6 +71,8 @@ async function killChild(child: ReturnType): Promise { } function captureBuild(cwd: string): void { + const buildCommand = + toolchain === 'rsbuild' ? 'pnpm build:rsbuild' : 'pnpm build:vite' const outFile = path.resolve(cwd, 'error-build-result.json') for (const f of ['error-build-result.json', 'error-build.log']) { const p = path.resolve(cwd, f) @@ -76,7 +84,7 @@ function captureBuild(cwd: string): void { let exitCode = 0 try { - const output = execSync('pnpm build', { + const output = execSync(buildCommand, { cwd, env: { ...process.env, BEHAVIOR: 'error' }, encoding: 'utf-8', @@ -114,12 +122,18 @@ async function captureDev(cwd: string): Promise { if (fs.existsSync(p)) fs.unlinkSync(p) } - const port = await getTestServerPort(`${packageJson.name}_error_dev`) + const port = await getTestServerPort(`${e2ePortKey}-error-dev`) const baseURL = `http://localhost:${port}` const logFile = path.resolve(cwd, 'error-dev.log') const out = fs.createWriteStream(logFile) - const child = spawn('pnpm', ['exec', 'vite', 'dev', '--port', String(port)], { + const toolchain = process.env.E2E_TOOLCHAIN ?? 'vite' + const command = + toolchain === 'rsbuild' + ? ['exec', 'rsbuild', 'dev', '--port', String(port)] + : ['exec', 'vite', 'dev', '--port', String(port)] + + const child = spawn('pnpm', command, { cwd, env: { ...process.env, diff --git a/e2e/react-start/import-protection/tests/import-protection.spec.ts b/e2e/react-start/import-protection/tests/import-protection.spec.ts index 7a8dc8d870..cdc9aea32c 100644 --- a/e2e/react-start/import-protection/tests/import-protection.spec.ts +++ b/e2e/react-start/import-protection/tests/import-protection.spec.ts @@ -5,6 +5,35 @@ import { test } from '@tanstack/router-e2e-utils' import type { Violation } from './violations.utils' import type { Page } from '@playwright/test' +const toolchain = process.env.E2E_TOOLCHAIN ?? 'vite' +const fixtureRoot = path.resolve(import.meta.dirname, '..') +const workspaceRoot = path.resolve(import.meta.dirname, '../../../..') + +function stripLocation(value: string): string { + return value.replace(/:\d+:\d+$/, '') +} + +function normalizeKeyPath(value: string): string { + let normalized = stripLocation(value).replace(/\\/g, '/') + const normalizedFixtureRoot = fixtureRoot.replace(/\\/g, '/') + const normalizedWorkspaceRoot = workspaceRoot.replace(/\\/g, '/') + + if (normalized.startsWith(`${normalizedFixtureRoot}/`)) { + normalized = normalized.slice(normalizedFixtureRoot.length + 1) + } else if (normalized.startsWith(`${normalizedWorkspaceRoot}/`)) { + normalized = normalized.slice(normalizedWorkspaceRoot.length + 1) + } + + normalized = normalized.replace( + /^packages\/react-start\/dist\/esm\/(.+)$/, + '@tanstack/react-start/$1', + ) + normalized = normalized.replace(/\.[cm]?[tj]sx?$/, '') + normalized = normalized.replace(/\/index$/, '') + + return normalized +} + async function readViolations( type: 'build' | 'dev' | 'dev.cold' | 'dev.warm', ): Promise> { @@ -41,6 +70,57 @@ function findClientSecretServerFileViolation( ) } +function findBarrelReexportHits( + violations: Array, +): Array { + return violations.filter( + (v) => + v.envType === 'client' && + (v.importer.includes('barrel-reexport') || + v.importer.includes('barrel-false-positive') || + v.specifier.includes('db.server') || + v.resolved?.includes('barrel-reexport') || + v.trace.some( + (s) => + s.file.includes('barrel-reexport') || + s.file.includes('barrel-false-positive'), + )), + ) +} + +function findBarrelMarkerHits(violations: Array): Array { + return violations.filter( + (v) => + v.envType === 'client' && + (v.specifier.includes('server-only') || + v.specifier.includes('foo') || + v.resolved?.includes('foo')) && + v.trace.some( + (s) => + s.file.includes('barrel-reexport') || + s.file.includes('barrel-false-positive'), + ), + ) +} + +function findTypeOnlyProtectedImportHits( + violations: Array, +): Array { + return violations.filter( + (v) => + v.envType === 'client' && + (v.importer.includes('type-only-protected-import') || + v.importer.includes('type-only.server') || + v.specifier.includes('type-only.server') || + v.resolved?.includes('type-only.server') || + v.trace.some( + (s) => + s.file.includes('type-only-protected-import') || + s.file.includes('type-only.server'), + )), + ) +} + test.use({ // The mock proxy returns undefined-ish values, which may cause // React rendering warnings — whitelist those @@ -240,7 +320,7 @@ for (const mode of ['build', 'dev'] as const) { x.envType === 'client' && (x.specifier.includes('secret.server') || x.resolved?.includes('secret.server')) && - !!x.snippet, + x.snippet?.lines.join('\n').includes('getSecret'), ) expect(v).toBeDefined() expect(v!.snippet).toBeDefined() @@ -536,7 +616,7 @@ test('warm run produces violations', async () => { expect(warm.length).toBeGreaterThan(0) }) -test('warm run detects the same unique violations as cold run', async () => { +test('warm run detects every unique cold-run violation', async () => { const cold = await readViolations('dev.cold') const warm = await readViolations('dev.warm') @@ -546,13 +626,29 @@ test('warm run detects the same unique violations as cold run', async () => { // the `.ts` extension) because different detection code-paths fire. // Normalize to the resolved path (without extension) for a stable key. const normalizeSpec = (v: Violation) => - (v.resolved ?? v.specifier).replace(/\.[cm]?[tj]sx?$/, '') + normalizeKeyPath(v.resolved ?? v.specifier) + const normalizeImporter = (v: Violation) => { + const importer = stripLocation(v.importer) + const leafTraceFile = v.trace.at(-1)?.file + + if ( + leafTraceFile && + !importer.includes('/') && + normalizeKeyPath(leafTraceFile).endsWith(normalizeKeyPath(importer)) + ) { + return normalizeKeyPath(leafTraceFile) + } + + return normalizeKeyPath(importer) + } const uniqueKey = (v: Violation) => - `${v.envType}|${v.type}|${normalizeSpec(v)}|${v.importer.replace(/:.*/, '')}` + `${v.envType}|${v.type}|${normalizeSpec(v)}|${normalizeImporter(v)}` const coldUniq = [...new Set(cold.map(uniqueKey))].sort() - const warmUniq = [...new Set(warm.map(uniqueKey))].sort() - expect(warmUniq).toEqual(coldUniq) + const warmUniq = new Set(warm.map(uniqueKey)) + const missingFromWarm = coldUniq.filter((key) => !warmUniq.has(key)) + + expect(missingFromWarm).toEqual([]) }) test('warm run traces include line numbers', async () => { @@ -669,7 +765,8 @@ for (const mode of ['build', 'dev', 'dev.warm'] as const) { // never imports foo at all. Both the .server module and the marker module // should NOT survive tree-shaking in the client bundle, so import-protection // must NOT flag violations for either in build mode. -// In dev mode there is no tree-shaking so the violation is expected (mock). +// Dev behavior is not part of this contract because barrel re-export diagnostics +// can warn or be elided depending on dev transform/chunk graph ordering. test('barrel-false-positive route loads in mock mode', async ({ page }) => { await page.goto('/barrel-false-positive') @@ -681,21 +778,7 @@ test('barrel-false-positive route loads in mock mode', async ({ page }) => { test('no false positive for barrel-reexport .server pattern in build', async () => { const violations = await readViolations('build') - const barrelHits = violations.filter( - (v) => - v.envType === 'client' && - (v.importer.includes('barrel-reexport') || - v.importer.includes('barrel-false-positive') || - v.specifier.includes('db.server') || - v.resolved?.includes('barrel-reexport') || - v.trace.some( - (s) => - s.file.includes('barrel-reexport') || - s.file.includes('barrel-false-positive'), - )), - ) - - expect(barrelHits).toEqual([]) + expect(findBarrelReexportHits(violations)).toEqual([]) }) test('no false positive for barrel-reexport marker pattern in build', async () => { @@ -704,20 +787,7 @@ test('no false positive for barrel-reexport marker pattern in build', async () = // foo.ts uses `import '@tanstack/react-start/server-only'` marker and is // re-exported through the barrel, but never imported by the route. // Tree-shaking should eliminate it — no marker violation should fire. - const markerHits = violations.filter( - (v) => - v.envType === 'client' && - (v.specifier.includes('server-only') || - v.specifier.includes('foo') || - v.resolved?.includes('foo')) && - v.trace.some( - (s) => - s.file.includes('barrel-reexport') || - s.file.includes('barrel-false-positive'), - ), - ) - - expect(markerHits).toEqual([]) + expect(findBarrelMarkerHits(violations)).toEqual([]) }) // noExternal .client package false positive: react-tweet's package.json @@ -831,6 +901,25 @@ test('non-alias-namespace-leak does not expose real secret after hydration', asy ).not.toContainText('super-secret-server-key-12345') }) +test('type-only protected import route loads in mock mode', async ({ + page, +}) => { + await expectRouteHeading( + page, + '/type-only-protected-import', + 'type-only-protected-import-heading', + 'Type-Only Protected Import', + ) +}) + +for (const mode of ['build', 'dev', 'dev.warm'] as const) { + test(`type-only protected imports do not trigger violations in ${mode}`, async () => { + const violations = await readViolations(mode) + + expect(findTypeOnlyProtectedImportHits(violations)).toEqual([]) + }) +} + for (const mode of ['build', 'dev'] as const) { test(`no false positive for noExternal react-tweet (.client entry) in ${mode}`, async () => { const violations = await readViolations(mode) diff --git a/e2e/react-start/import-protection/tests/violations.setup.ts b/e2e/react-start/import-protection/tests/violations.setup.ts index 6a10e6b1fd..02796227a7 100644 --- a/e2e/react-start/import-protection/tests/violations.setup.ts +++ b/e2e/react-start/import-protection/tests/violations.setup.ts @@ -9,6 +9,12 @@ import { extractViolationsFromLog } from './violations.utils' import type { FullConfig } from '@playwright/test' import type { Violation } from './violations.utils' +const toolchain = process.env.E2E_TOOLCHAIN ?? 'vite' +const viteBundledDev = process.env.E2E_VITE_BUNDLED_DEV === 'true' +const e2ePortKey = + process.env.E2E_PORT_KEY ?? + `${packageJson.name}-${toolchain}${viteBundledDev ? '-bundled-dev' : ''}` + async function waitForHttpOk(url: string, timeoutMs: number): Promise { const start = Date.now() @@ -32,7 +38,13 @@ async function waitForHttpOk(url: string, timeoutMs: number): Promise { } function startDevServer(cwd: string, port: number): ReturnType { - return spawn('pnpm', ['exec', 'vite', 'dev', '--port', String(port)], { + const toolchain = process.env.E2E_TOOLCHAIN ?? 'vite' + const command = + toolchain === 'rsbuild' + ? ['exec', 'rsbuild', 'dev', '--port', String(port)] + : ['exec', 'vite', 'dev', '--port', String(port)] + + return spawn('pnpm', command, { cwd, env: { ...process.env, @@ -73,32 +85,96 @@ async function killChild(child: ReturnType): Promise { }) } -const routeDefinitions = [ - ['/', 'heading'], +type ViolationExpectation = (violations: Array) => boolean + +type RouteDefinition = readonly [ + route: string, + testId: string, + expectedViolation?: ViolationExpectation, +] + +function hasClientSecretServerFileViolation( + importerFragment: string, +): ViolationExpectation { + return (violations) => + violations.some( + (v) => + v.envType === 'client' && + v.type === 'file' && + v.importer.includes(importerFragment) && + (v.specifier.includes('secret.server') || + v.resolved?.includes('secret.server')), + ) +} + +const routeDefinitions: Array = [ + ['/', 'heading', hasClientSecretServerFileViolation('edge-a')], ['/leaky-server-import', 'leaky-heading'], ['/client-only-violations', 'client-only-heading'], ['/client-only-jsx', 'client-only-jsx-heading'], ['/beforeload-leak', 'beforeload-leak-heading'], - ['/component-server-leak', 'component-leak-heading'], + [ + '/component-server-leak', + 'component-leak-heading', + hasClientSecretServerFileViolation('component-server-leak'), + ], + [ + '/alias-path-leak', + 'alias-path-leak-heading', + hasClientSecretServerFileViolation('alias-path-leak'), + ], + [ + '/alias-path-namespace-leak', + 'alias-path-namespace-leak-heading', + hasClientSecretServerFileViolation('alias-path-namespace-leak'), + ], + [ + '/non-alias-namespace-leak', + 'non-alias-namespace-leak-heading', + hasClientSecretServerFileViolation('non-alias-namespace-leak'), + ], ['/barrel-false-positive', 'barrel-heading'], - ['/alias-path-leak', 'alias-path-leak-heading'], - ['/alias-path-namespace-leak', 'alias-path-namespace-leak-heading'], - ['/non-alias-namespace-leak', 'non-alias-namespace-leak-heading'], -] as const + ['/type-only-protected-import', 'type-only-protected-import-heading'], +] -const routes = routeDefinitions.map(([route]) => route) +const outputPollMs = 250 +const outputIdleMs = viteBundledDev ? 750 : 350 +const outputTimeoutMs = viteBundledDev ? 10_000 : 3_000 -const routeReadyTestIds: Record = - Object.fromEntries(routeDefinitions) +async function waitForOutput( + getLogText: () => string, + expectedViolation?: ViolationExpectation, +): Promise { + const start = Date.now() + let lastLength = getLogText().length + let lastChange = Date.now() + + while (Date.now() - start < outputTimeoutMs) { + const text = getLogText() + if (expectedViolation?.(extractViolationsFromLog(text))) { + return + } + + if (text.length !== lastLength) { + lastLength = text.length + lastChange = Date.now() + } else if (!expectedViolation && Date.now() - lastChange >= outputIdleMs) { + return + } + + await new Promise((r) => setTimeout(r, outputPollMs)) + } +} async function navigateAllRoutes( baseURL: string, browser: Awaited>, + getLogText: () => string, ): Promise { const context = await browser.newContext() const page = await context.newPage() - for (const route of routes) { + for (const [route, testId, expectedViolation] of routeDefinitions) { try { // Prefer 'networkidle' (ensures route chunks are actually fetched), but // fall back if it hangs in certain CI environments. @@ -114,15 +190,13 @@ async function navigateAllRoutes( }) } - const testId = routeReadyTestIds[route] - if (testId) { - await page.getByTestId(testId).waitFor({ timeout: 10_000 }) - } + await page.getByTestId(testId).waitFor({ timeout: 10_000 }) } catch { // ignore navigation errors — we only care about server logs } finally { - // Allow deferred transforms/logging to flush even when navigation fails. - await new Promise((r) => setTimeout(r, 750)) + // Poll the captured logs so delayed bundled-dev warnings can flush + // without sleeping longer than necessary on every route. + await waitForOutput(getLogText, expectedViolation) } } @@ -149,12 +223,12 @@ async function runDevPass( const browser = await chromium.launch() try { - await navigateAllRoutes(baseURL, browser) + await navigateAllRoutes(baseURL, browser, () => logChunks.join('')) } finally { await browser.close() } - await new Promise((r) => setTimeout(r, 750)) + await waitForOutput(() => logChunks.join('')) } finally { await killChild(child) } @@ -170,9 +244,10 @@ async function runDevPass( * modules are pre-transformed so resolveId/transform paths differ. */ async function captureDevViolations(cwd: string): Promise { - const port = await getTestServerPort(`${packageJson.name}_dev`) - - const coldViolations = await runDevPass(cwd, port) + const coldViolations = await runDevPass( + cwd, + await getTestServerPort(`${e2ePortKey}-violations-cold`), + ) fs.writeFileSync( path.resolve(cwd, 'violations.dev.json'), @@ -184,7 +259,10 @@ async function captureDevViolations(cwd: string): Promise { ) // Warm pass: the .vite cache from the cold run is still on disk. - const warmViolations = await runDevPass(cwd, port) + const warmViolations = await runDevPass( + cwd, + await getTestServerPort(`${e2ePortKey}-violations-warm`), + ) fs.writeFileSync( path.resolve(cwd, 'violations.dev.warm.json'), diff --git a/e2e/react-start/import-protection/tests/violations.utils.ts b/e2e/react-start/import-protection/tests/violations.utils.ts index ebe2e53767..c08a9b7a82 100644 --- a/e2e/react-start/import-protection/tests/violations.utils.ts +++ b/e2e/react-start/import-protection/tests/violations.utils.ts @@ -29,6 +29,11 @@ export function stripAnsi(input: string): string { export function extractViolationsFromLog(text: string): Array { const out: Array = [] const lines = stripAnsi(text).split(/\r?\n/) + const stripBoxPrefix = (line: string) => + line + .replace(/^\s*│\s?/, '') + .replace(/^\s*\|\s?/, '') + .trimEnd() for (let i = 0; i < lines.length; i++) { const line = lines[i] ?? '' @@ -48,11 +53,15 @@ export function extractViolationsFromLog(text: string): Array { block.push(l) } - const importerLine = block.find((b) => + const normalizedBlock = block.map(stripBoxPrefix) + + const importerLine = normalizedBlock.find((b) => b.trimStart().startsWith('Importer:'), ) - const specLine = block.find((b) => b.trimStart().startsWith('Import:')) - const resolvedLine = block.find((b) => + const specLine = normalizedBlock.find((b) => + b.trimStart().startsWith('Import:'), + ) + const resolvedLine = normalizedBlock.find((b) => b.trimStart().startsWith('Resolved:'), ) @@ -66,7 +75,9 @@ export function extractViolationsFromLog(text: string): Array { ? resolvedLine.split('Resolved:')[1]!.trim() : undefined - const typeLine = block.find((b) => b.trimStart().startsWith('Denied by')) + const typeLine = normalizedBlock.find((b) => + b.trimStart().startsWith('Denied by'), + ) const type = typeLine?.includes('marker') ? 'marker' : typeLine?.includes('specifier') @@ -76,10 +87,10 @@ export function extractViolationsFromLog(text: string): Array { : 'unknown' const trace: Array = [] - const traceStart = block.findIndex((b) => b.trim() === 'Trace:') + const traceStart = normalizedBlock.findIndex((b) => b.trim() === 'Trace:') if (traceStart !== -1) { - for (let k = traceStart + 1; k < block.length; k++) { - const l = block[k] ?? '' + for (let k = traceStart + 1; k < normalizedBlock.length; k++) { + const l = normalizedBlock[k] ?? '' const m = l.match( /^\s*\d+\.\s+(.*?)(?:\s+\(entry\))?\s*(?:\(import "(.*)"\))?\s*$/, ) @@ -108,12 +119,12 @@ export function extractViolationsFromLog(text: string): Array { // Parse Code: snippet block let snippet: CodeSnippet | undefined - const codeStart = block.findIndex((b) => b.trim() === 'Code:') + const codeStart = normalizedBlock.findIndex((b) => b.trim() === 'Code:') if (codeStart !== -1) { const snippetLines: Array = [] let location: string | undefined - for (let k = codeStart + 1; k < block.length; k++) { - const l = block[k] ?? '' + for (let k = codeStart + 1; k < normalizedBlock.length; k++) { + const l = normalizedBlock[k] ?? '' // Snippet lines start with "> " or " " (marker + gutter + pipe) if (/^\s*[> ]\s*\d+\s*\|/.test(l) || /^\s+\|/.test(l)) { snippetLines.push(l) diff --git a/e2e/react-start/import-protection/vite.config.ts b/e2e/react-start/import-protection/vite.config.ts index edc5a6f6e9..3163ded433 100644 --- a/e2e/react-start/import-protection/vite.config.ts +++ b/e2e/react-start/import-protection/vite.config.ts @@ -1,30 +1,23 @@ import path from 'node:path' import { defineConfig } from 'vite' +import viteReact from '@vitejs/plugin-react' import { tanstackStart } from '@tanstack/react-start/plugin/vite' +import { getStartModeConfig } from './start-mode-config' -// Allow env var to override the import protection behavior. -// Default: 'mock' (build completes, violations logged as warnings). -// Set BEHAVIOR=error to test that the build fails on violations. -const behavior = (process.env.BEHAVIOR ?? 'mock') as 'mock' | 'error' +const outDir = process.env.E2E_DIST_DIR ?? 'dist' +const startModeConfig = getStartModeConfig() +const bundledDev = process.env.E2E_VITE_BUNDLED_DEV === 'true' export default defineConfig({ resolve: { tsconfigPaths: true }, + experimental: bundledDev ? { bundledDev: true } : undefined, + build: { + outDir, + }, server: { port: 3000, }, - plugins: [ - tanstackStart({ - importProtection: { - behavior, - log: 'always', - // Tests capture structured violations by overriding this hook. - // If unset, we avoid generating any violations*.json files. - onViolation: (info) => { - void info - }, - }, - }), - ], + plugins: [tanstackStart(startModeConfig), viteReact()], // react-tweet's package.json exports resolve to `index.client.js` which // matches the default **/*.client.* deny pattern. Bundling it via // noExternal must NOT trigger a false-positive import-protection violation. diff --git a/e2e/react-start/query-integration/package.json b/e2e/react-start/query-integration/package.json index bcb51c9d86..6a22be7871 100644 --- a/e2e/react-start/query-integration/package.json +++ b/e2e/react-start/query-integration/package.json @@ -20,9 +20,8 @@ "@tanstack/react-start": "workspace:^", "react": "^19.0.0", "react-dom": "^19.0.0", - "tailwind-merge": "^2.6.0", - "vite": "^8.0.0", - "zod": "^3.24.2" + "tailwind-merge": "^3.6.0", + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -33,6 +32,7 @@ "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "tailwindcss": "^4.2.2", - "typescript": "^6.0.2" + "typescript": "^6.0.2", + "vite": "^8.0.14" } } diff --git a/e2e/react-start/rsc-deferred-hydration/.gitignore b/e2e/react-start/rsc-deferred-hydration/.gitignore new file mode 100644 index 0000000000..cc99170fbb --- /dev/null +++ b/e2e/react-start/rsc-deferred-hydration/.gitignore @@ -0,0 +1,5 @@ +dist +node_modules +port*.txt +test-results +playwright-report diff --git a/e2e/react-start/rsc-deferred-hydration/package.json b/e2e/react-start/rsc-deferred-hydration/package.json new file mode 100644 index 0000000000..e14d919490 --- /dev/null +++ b/e2e/react-start/rsc-deferred-hydration/package.json @@ -0,0 +1,45 @@ +{ + "name": "tanstack-react-start-e2e-rsc-deferred-hydration", + "private": true, + "sideEffects": false, + "type": "module", + "scripts": { + "dev": "vite dev --port 3000", + "dev:e2e": "vite dev", + "build": "vite build && tsc --noEmit", + "preview": "vite preview", + "start": "node server.js", + "test:e2e": "pnpm test:e2e:dev && pnpm test:e2e:prod", + "test:e2e:dev": "MODE=dev playwright test --project=chromium", + "test:e2e:prod": "MODE=prod playwright test --project=chromium" + }, + "nx": { + "metadata": { + "playwrightModes": [ + { + "toolchain": "vite", + "mode": "ssr", + "shards": 1 + } + ] + } + }, + "dependencies": { + "@tanstack/react-router": "workspace:^", + "@tanstack/react-start": "workspace:^", + "react": "^19.0.0", + "react-dom": "^19.0.0" + }, + "devDependencies": { + "@playwright/test": "^1.50.1", + "@tanstack/router-e2e-utils": "workspace:^", + "@types/node": "^22.10.2", + "@types/react": "^19.0.8", + "@types/react-dom": "^19.0.3", + "@vitejs/plugin-react": "^6.0.1", + "@vitejs/plugin-rsc": "^0.5.20", + "srvx": "^0.11.9", + "typescript": "^6.0.2", + "vite": "^8.0.14" + } +} diff --git a/e2e/react-start/rsc-deferred-hydration/playwright.config.ts b/e2e/react-start/rsc-deferred-hydration/playwright.config.ts new file mode 100644 index 0000000000..10f41cd911 --- /dev/null +++ b/e2e/react-start/rsc-deferred-hydration/playwright.config.ts @@ -0,0 +1,35 @@ +import { defineConfig, devices } from '@playwright/test' +import { getTestServerPort } from '@tanstack/router-e2e-utils' +import packageJson from './package.json' with { type: 'json' } + +const PORT = await getTestServerPort(packageJson.name) +const baseURL = `http://localhost:${PORT}` +const mode = process.env.MODE ?? 'prod' +const isDev = mode === 'dev' + +export default defineConfig({ + testDir: './tests', + workers: 1, + reporter: [['line']], + globalSetup: './tests/setup/global.setup.ts', + globalTeardown: './tests/setup/global.teardown.ts', + use: { baseURL }, + webServer: { + command: isDev ? 'pnpm dev:e2e' : 'pnpm build && pnpm start', + url: baseURL, + reuseExistingServer: !process.env.CI, + stdout: 'pipe', + env: { + VITE_NODE_ENV: 'test', + NODE_ENV: isDev ? 'development' : 'production', + PORT: String(PORT), + VITE_SERVER_PORT: String(PORT), + }, + }, + projects: [ + { + name: 'chromium', + use: { ...devices['Desktop Chrome'] }, + }, + ], +}) diff --git a/e2e/react-start/rsc-deferred-hydration/server.js b/e2e/react-start/rsc-deferred-hydration/server.js new file mode 100644 index 0000000000..6365c568d4 --- /dev/null +++ b/e2e/react-start/rsc-deferred-hydration/server.js @@ -0,0 +1,47 @@ +import fs from 'node:fs' +import path from 'node:path' +import { spawn } from 'node:child_process' +import { pathToFileURL } from 'node:url' + +const distDir = process.env.E2E_DIST_DIR || 'dist' + +function resolveDistClientDir() { + return path.resolve(distDir, 'client') +} + +function resolveDistServerEntryPath() { + const serverJsPath = path.resolve(distDir, 'server', 'server.js') + if (fs.existsSync(serverJsPath)) return serverJsPath + + const indexJsPath = path.resolve(distDir, 'server', 'index.js') + if (fs.existsSync(indexJsPath)) return indexJsPath + + return serverJsPath +} + +export function start() { + const child = spawn( + 'srvx', + ['--prod', '-s', resolveDistClientDir(), resolveDistServerEntryPath()], + { + stdio: 'inherit', + shell: process.platform === 'win32', + }, + ) + + child.on('exit', (code, signal) => { + if (signal) { + process.kill(process.pid, signal) + return + } + + process.exit(code ?? 0) + }) +} + +if ( + process.argv[1] && + import.meta.url === pathToFileURL(process.argv[1]).href +) { + start() +} diff --git a/e2e/react-start/rsc-deferred-hydration/src/components/CssHydrateIsland.module.css b/e2e/react-start/rsc-deferred-hydration/src/components/CssHydrateIsland.module.css new file mode 100644 index 0000000000..d80e17aebe --- /dev/null +++ b/e2e/react-start/rsc-deferred-hydration/src/components/CssHydrateIsland.module.css @@ -0,0 +1,42 @@ +.cssIsland { + border-color: rgba(16, 185, 129, 0.38); + background: + linear-gradient( + 135deg, + rgba(236, 253, 245, 0.96), + rgba(255, 255, 255, 0.9) + ), + repeating-linear-gradient( + 45deg, + rgba(16, 185, 129, 0.12) 0 8px, + transparent 8px 16px + ); + color: rgb(6, 78, 59); +} + +.cssIsland h2 { + color: rgb(6, 95, 70); +} + +.cssMarker { + width: fit-content; + padding: 0.45rem 0.7rem; + border-radius: 999px; + font-weight: 900; + transition: + background 180ms ease, + color 180ms ease, + box-shadow 180ms ease; +} + +.cssMarkerPending { + background: rgb(252, 231, 243); + color: rgb(157, 23, 77); + box-shadow: 0 8px 26px rgba(219, 39, 119, 0.18); +} + +.cssMarkerHydrated { + background: rgb(209, 250, 229); + color: rgb(6, 95, 70); + box-shadow: 0 8px 26px rgba(5, 150, 105, 0.18); +} diff --git a/e2e/react-start/rsc-deferred-hydration/src/components/CssHydrateIsland.tsx b/e2e/react-start/rsc-deferred-hydration/src/components/CssHydrateIsland.tsx new file mode 100644 index 0000000000..7f023bd10c --- /dev/null +++ b/e2e/react-start/rsc-deferred-hydration/src/components/CssHydrateIsland.tsx @@ -0,0 +1,45 @@ +'use client' + +import * as React from 'react' +import { Hydrate } from '@tanstack/react-start' +import { media } from '@tanstack/react-start/hydration' +import { DeferredHydrateIsland } from './DeferredHydrateIsland' +import styles from './CssHydrateIsland.module.css' + +function CssHydratePanel() { + const [hydrated, setHydrated] = React.useState(false) + + React.useEffect(() => { + setHydrated(true) + }, []) + + return ( +
    + CSS module Hydrate island +

    CSS modules survive the RSC to client boundary

    +

    + {hydrated + ? 'Hydrated module-styled client content' + : 'Pending module-styled client content'} +

    + +
    + ) +} + +export function CssHydrateIsland() { + return ( +
    + + + +
    + ) +} diff --git a/e2e/react-start/rsc-deferred-hydration/src/components/DeferredHydrateIsland.tsx b/e2e/react-start/rsc-deferred-hydration/src/components/DeferredHydrateIsland.tsx new file mode 100644 index 0000000000..0a716fe39c --- /dev/null +++ b/e2e/react-start/rsc-deferred-hydration/src/components/DeferredHydrateIsland.tsx @@ -0,0 +1,67 @@ +'use client' + +import * as React from 'react' +import { Hydrate } from '@tanstack/react-start' +import { interaction, media, visible } from '@tanstack/react-start/hydration' + +type Strategy = 'interaction' | 'visible' | 'media' + +const strategyCopy: Record = { + interaction: 'Hydrates after pointer or focus intent reaches this island.', + visible: 'Hydrates only after the island scrolls into the viewport.', + media: 'Hydrates immediately when the matching media query is true.', +} + +function getStrategy(strategy: Strategy) { + if (strategy === 'interaction') return interaction() + if (strategy === 'visible') return visible({ rootMargin: '0px' }) + return media('(min-width: 1px)') +} + +export function CounterButton(props: { id: string; label: string }) { + const [count, setCount] = React.useState(0) + const [hydrated, setHydrated] = React.useState(false) + + React.useEffect(() => { + setHydrated(true) + }, []) + + return ( + + ) +} + +export function DeferredHydrateIsland(props: { + id: string + title: string + strategy: Strategy + className?: string +}) { + return ( +
    + Client Hydrate island +

    {props.title}

    +

    {strategyCopy[props.strategy]}

    + + + +
    + ) +} diff --git a/e2e/react-start/rsc-deferred-hydration/src/routeTree.gen.ts b/e2e/react-start/rsc-deferred-hydration/src/routeTree.gen.ts new file mode 100644 index 0000000000..246737b515 --- /dev/null +++ b/e2e/react-start/rsc-deferred-hydration/src/routeTree.gen.ts @@ -0,0 +1,122 @@ +/* eslint-disable */ + +// @ts-nocheck + +// noinspection JSUnusedGlobalSymbols + +// This file was automatically generated by TanStack Router. +// You should NOT make any changes in this file as it will be overwritten. +// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. + +import { Route as rootRouteImport } from './routes/__root' +import { Route as ServerClientRouteImport } from './routes/server-client' +import { Route as CssRouteImport } from './routes/css' +import { Route as CompositeRouteImport } from './routes/composite' +import { Route as IndexRouteImport } from './routes/index' + +const ServerClientRoute = ServerClientRouteImport.update({ + id: '/server-client', + path: '/server-client', + getParentRoute: () => rootRouteImport, +} as any) +const CssRoute = CssRouteImport.update({ + id: '/css', + path: '/css', + getParentRoute: () => rootRouteImport, +} as any) +const CompositeRoute = CompositeRouteImport.update({ + id: '/composite', + path: '/composite', + getParentRoute: () => rootRouteImport, +} as any) +const IndexRoute = IndexRouteImport.update({ + id: '/', + path: '/', + getParentRoute: () => rootRouteImport, +} as any) + +export interface FileRoutesByFullPath { + '/': typeof IndexRoute + '/composite': typeof CompositeRoute + '/css': typeof CssRoute + '/server-client': typeof ServerClientRoute +} +export interface FileRoutesByTo { + '/': typeof IndexRoute + '/composite': typeof CompositeRoute + '/css': typeof CssRoute + '/server-client': typeof ServerClientRoute +} +export interface FileRoutesById { + __root__: typeof rootRouteImport + '/': typeof IndexRoute + '/composite': typeof CompositeRoute + '/css': typeof CssRoute + '/server-client': typeof ServerClientRoute +} +export interface FileRouteTypes { + fileRoutesByFullPath: FileRoutesByFullPath + fullPaths: '/' | '/composite' | '/css' | '/server-client' + fileRoutesByTo: FileRoutesByTo + to: '/' | '/composite' | '/css' | '/server-client' + id: '__root__' | '/' | '/composite' | '/css' | '/server-client' + fileRoutesById: FileRoutesById +} +export interface RootRouteChildren { + IndexRoute: typeof IndexRoute + CompositeRoute: typeof CompositeRoute + CssRoute: typeof CssRoute + ServerClientRoute: typeof ServerClientRoute +} + +declare module '@tanstack/react-router' { + interface FileRoutesByPath { + '/server-client': { + id: '/server-client' + path: '/server-client' + fullPath: '/server-client' + preLoaderRoute: typeof ServerClientRouteImport + parentRoute: typeof rootRouteImport + } + '/css': { + id: '/css' + path: '/css' + fullPath: '/css' + preLoaderRoute: typeof CssRouteImport + parentRoute: typeof rootRouteImport + } + '/composite': { + id: '/composite' + path: '/composite' + fullPath: '/composite' + preLoaderRoute: typeof CompositeRouteImport + parentRoute: typeof rootRouteImport + } + '/': { + id: '/' + path: '/' + fullPath: '/' + preLoaderRoute: typeof IndexRouteImport + parentRoute: typeof rootRouteImport + } + } +} + +const rootRouteChildren: RootRouteChildren = { + IndexRoute: IndexRoute, + CompositeRoute: CompositeRoute, + CssRoute: CssRoute, + ServerClientRoute: ServerClientRoute, +} +export const routeTree = rootRouteImport + ._addFileChildren(rootRouteChildren) + ._addFileTypes() + +import type { getRouter } from './router.tsx' +import type { createStart } from '@tanstack/react-start' +declare module '@tanstack/react-start' { + interface Register { + ssr: true + router: Awaited> + } +} diff --git a/e2e/react-start/rsc-deferred-hydration/src/router.tsx b/e2e/react-start/rsc-deferred-hydration/src/router.tsx new file mode 100644 index 0000000000..9d87d8748b --- /dev/null +++ b/e2e/react-start/rsc-deferred-hydration/src/router.tsx @@ -0,0 +1,9 @@ +import { createRouter } from '@tanstack/react-router' +import { routeTree } from './routeTree.gen' + +export function getRouter() { + return createRouter({ + routeTree, + scrollRestoration: true, + }) +} diff --git a/e2e/react-start/rsc-deferred-hydration/src/routes/__root.tsx b/e2e/react-start/rsc-deferred-hydration/src/routes/__root.tsx new file mode 100644 index 0000000000..7ce2e7bdb1 --- /dev/null +++ b/e2e/react-start/rsc-deferred-hydration/src/routes/__root.tsx @@ -0,0 +1,122 @@ +/// +import * as React from 'react' +import { + HeadContent, + Link, + Outlet, + Scripts, + createRootRoute, +} from '@tanstack/react-router' + +export const Route = createRootRoute({ + head: () => ({ + meta: [ + { charSet: 'utf-8' }, + { name: 'viewport', content: 'width=device-width, initial-scale=1' }, + { title: 'RSC Deferred Hydration E2E' }, + ], + }), + shellComponent: RootDocument, + component: () => ( +
    + +
    + ), +}) + +function RootDocument({ children }: { children: React.ReactNode }) { + return ( + + + + + + + + {children} + + + + ) +} diff --git a/e2e/react-start/rsc-deferred-hydration/src/routes/composite.tsx b/e2e/react-start/rsc-deferred-hydration/src/routes/composite.tsx new file mode 100644 index 0000000000..3241ee487d --- /dev/null +++ b/e2e/react-start/rsc-deferred-hydration/src/routes/composite.tsx @@ -0,0 +1,24 @@ +import { createFileRoute } from '@tanstack/react-router' +import { CompositeComponent } from '@tanstack/react-start/rsc' +import { getCompositeHydrate } from '~/server/serverHydrateComponents' +import { DeferredHydrateIsland } from '~/components/DeferredHydrateIsland' + +export const Route = createFileRoute('/composite')({ + loader: async () => ({ + Composite: await getCompositeHydrate(), + }), + component: CompositeRoute, +}) + +function CompositeRoute() { + const { Composite } = Route.useLoaderData() + return ( + + + + ) +} diff --git a/e2e/react-start/rsc-deferred-hydration/src/routes/css.tsx b/e2e/react-start/rsc-deferred-hydration/src/routes/css.tsx new file mode 100644 index 0000000000..ddb22f318a --- /dev/null +++ b/e2e/react-start/rsc-deferred-hydration/src/routes/css.tsx @@ -0,0 +1,14 @@ +import { createFileRoute } from '@tanstack/react-router' +import { getCssModuleHydrate } from '~/server/serverHydrateComponents' + +export const Route = createFileRoute('/css')({ + loader: async () => ({ + Server: await getCssModuleHydrate(), + }), + component: CssRoute, +}) + +function CssRoute() { + const { Server } = Route.useLoaderData() + return Server +} diff --git a/e2e/react-start/rsc-deferred-hydration/src/routes/index.tsx b/e2e/react-start/rsc-deferred-hydration/src/routes/index.tsx new file mode 100644 index 0000000000..ebe57e7028 --- /dev/null +++ b/e2e/react-start/rsc-deferred-hydration/src/routes/index.tsx @@ -0,0 +1,35 @@ +import { createFileRoute, Link } from '@tanstack/react-router' + +export const Route = createFileRoute('/')({ + component: Home, +}) + +function Home() { + return ( +
    +

    RSC meets Deferred Hydration

    +

    + These routes render React Server Components that cross into client + components using Hydrate. Each card explains when its + client island should hydrate and keeps server-rendered HTML visible + first. +

    +
    + + Server component to client Hydrate + The RSC renders a separate "use client" component that + defers hydration until interaction. + + + Composite server shellA server component owns the + visual frame while a client child hydrates only after it becomes + visible. + + + CSS module client islandA server component renders a + client Hydrate boundary whose child uses CSS modules. + +
    +
    + ) +} diff --git a/e2e/react-start/rsc-deferred-hydration/src/routes/server-client.tsx b/e2e/react-start/rsc-deferred-hydration/src/routes/server-client.tsx new file mode 100644 index 0000000000..f39b635241 --- /dev/null +++ b/e2e/react-start/rsc-deferred-hydration/src/routes/server-client.tsx @@ -0,0 +1,14 @@ +import { createFileRoute } from '@tanstack/react-router' +import { getServerClientHydrate } from '~/server/serverHydrateComponents' + +export const Route = createFileRoute('/server-client')({ + loader: async () => ({ + Server: await getServerClientHydrate(), + }), + component: ServerClientRoute, +}) + +function ServerClientRoute() { + const { Server } = Route.useLoaderData() + return Server +} diff --git a/e2e/react-start/rsc-deferred-hydration/src/server/serverHydrateComponents.tsx b/e2e/react-start/rsc-deferred-hydration/src/server/serverHydrateComponents.tsx new file mode 100644 index 0000000000..d4e431061a --- /dev/null +++ b/e2e/react-start/rsc-deferred-hydration/src/server/serverHydrateComponents.tsx @@ -0,0 +1,35 @@ +import * as React from 'react' +import { createServerFn } from '@tanstack/react-start' +import { + createCompositeComponent, + renderServerComponent, +} from '@tanstack/react-start/rsc' +import { + CompositeHydrateContent, + CssModuleHydrateContent, + ServerClientHydrateContent, +} from './serverHydrateContent' + +export const getServerClientHydrate = createServerFn({ method: 'GET' }).handler( + async () => { + const renderedAt = new Date().toISOString() + + return renderServerComponent( + , + ) + }, +) + +export const getCompositeHydrate = createServerFn({ method: 'GET' }).handler( + async () => { + return createCompositeComponent((props: { children?: React.ReactNode }) => ( + {props.children} + )) + }, +) + +export const getCssModuleHydrate = createServerFn({ method: 'GET' }).handler( + async () => { + return renderServerComponent() + }, +) diff --git a/e2e/react-start/rsc-deferred-hydration/src/server/serverHydrateContent.tsx b/e2e/react-start/rsc-deferred-hydration/src/server/serverHydrateContent.tsx new file mode 100644 index 0000000000..dc785a16ce --- /dev/null +++ b/e2e/react-start/rsc-deferred-hydration/src/server/serverHydrateContent.tsx @@ -0,0 +1,63 @@ +import * as React from 'react' +import { DeferredHydrateIsland } from '../components/DeferredHydrateIsland' +import { CssHydrateIsland } from '../components/CssHydrateIsland' + +export function ServerClientHydrateContent({ + renderedAt, +}: { + renderedAt: string +}) { + return ( +
    + React Server Component +

    Server component renders a deferred client island

    +

    + Server rendered at . The button below is + present in HTML but stays unhydrated until interaction. +

    + +
    + ) +} + +export function CompositeHydrateContent({ + children, +}: { + children?: React.ReactNode +}) { + return ( +
    + Composite Server Component +

    Server shell, client Hydrate slot

    +

    + The server owns this descriptive shell. The client slot below remains + server HTML until an interaction reaches it. +

    +
    + {children} +
    + ) +} + +export function CssModuleHydrateContent() { + return ( +
    + + Server Component plus CSS module client island + +

    CSS module Hydrate boundary

    +

    + This server component renders a separate client component that uses + Hydrate and CSS modules. +

    + +
    + ) +} diff --git a/e2e/react-start/rsc-deferred-hydration/tests/hydration.spec.ts b/e2e/react-start/rsc-deferred-hydration/tests/hydration.spec.ts new file mode 100644 index 0000000000..d700863d1e --- /dev/null +++ b/e2e/react-start/rsc-deferred-hydration/tests/hydration.spec.ts @@ -0,0 +1,92 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import type { Page } from '@playwright/test' + +async function expectUnhydrated(page: Page, id: string) { + await expect(page.getByTestId(`${id}-button`)).toHaveAttribute( + 'data-hydrated', + 'false', + ) +} + +async function clickAndExpectCount(page: Page, id: string, count: string) { + await expect(page.getByTestId(`${id}-button`)).toHaveAttribute( + 'data-hydrated', + 'true', + ) + await page.getByTestId(`${id}-button`).click() + await expect(page.getByTestId(`${id}-count`)).toHaveText(count) +} + +async function gotoWithoutPointerIntent(page: Page, path: string) { + await page.mouse.move(0, 0) + await page.goto(path) +} + +async function waitForHydrateMarkerToMount(page: Page, id: string) { + await page.waitForFunction((testId) => { + const button = document.querySelector(`[data-testid="${testId}-button"]`) + const marker = button?.closest('[data-ts-hydrate-id]') + return Object.keys(marker ?? {}).some((key) => key.startsWith('__react')) + }, id) +} + +test.describe('RSC deferred hydration', () => { + test('server component renders a client Hydrate island that hydrates on interaction', async ({ + page, + }) => { + await gotoWithoutPointerIntent(page, '/server-client') + + await expect(page.getByTestId('server-client-rsc')).toContainText( + 'Server component renders a deferred client island', + ) + await expect(page.getByTestId('server-client-island')).toContainText( + 'Interaction strategy inside RSC output', + ) + await expectUnhydrated(page, 'server-client') + + await page.mouse.move(0, 0) + await page.getByTestId('server-client-button').hover() + await clickAndExpectCount(page, 'server-client', '1') + }) + + test('composite server component can wrap an interaction Hydrate client island', async ({ + page, + }) => { + await gotoWithoutPointerIntent(page, '/composite') + + await expect(page.getByTestId('composite-rsc')).toContainText( + 'Server shell, client Hydrate slot', + ) + await expect( + page.getByTestId('composite-interaction-island'), + ).toContainText('Interaction strategy inside a composite server component') + await expectUnhydrated(page, 'composite-interaction') + + await waitForHydrateMarkerToMount(page, 'composite-interaction') + await page.mouse.move(0, 0) + await page.getByTestId('composite-interaction-button').hover() + await clickAndExpectCount(page, 'composite-interaction', '1') + }) + + test('server component can render a CSS module Hydrate client island', async ({ + page, + }) => { + await gotoWithoutPointerIntent(page, '/css') + + await expect(page.getByTestId('css-rsc')).toContainText( + 'CSS module Hydrate boundary', + ) + await expect(page.getByTestId('css-module-marker')).toHaveCSS( + 'font-weight', + '900', + ) + await waitForHydrateMarkerToMount(page, 'css-nested') + await page.getByTestId('css-nested-button').click() + await expect(page.getByTestId('css-nested-button')).toHaveAttribute( + 'data-hydrated', + 'true', + ) + await expect(page.getByTestId('css-nested-count')).toHaveText('1') + }) +}) diff --git a/e2e/react-start/rsc-deferred-hydration/tests/setup/global.setup.ts b/e2e/react-start/rsc-deferred-hydration/tests/setup/global.setup.ts new file mode 100644 index 0000000000..3d1579ee87 --- /dev/null +++ b/e2e/react-start/rsc-deferred-hydration/tests/setup/global.setup.ts @@ -0,0 +1,28 @@ +import { + e2eStartDummyServer, + getTestServerPort, + preOptimizeDevServer, + waitForServer, +} from '@tanstack/router-e2e-utils' +import packageJson from '../../package.json' with { type: 'json' } + +export default async function setup() { + await e2eStartDummyServer(packageJson.name) + + if (process.env.MODE !== 'dev') return + + const port = await getTestServerPort(packageJson.name) + const baseURL = `http://localhost:${port}` + + await waitForServer(baseURL) + await preOptimizeDevServer({ + baseURL, + readyTestId: 'home-heading', + warmup: async (page) => { + for (const route of ['/server-client', '/composite', '/css']) { + await page.goto(`${baseURL}${route}`, { waitUntil: 'domcontentloaded' }) + await page.waitForLoadState('networkidle') + } + }, + }) +} diff --git a/e2e/react-start/rsc-deferred-hydration/tests/setup/global.teardown.ts b/e2e/react-start/rsc-deferred-hydration/tests/setup/global.teardown.ts new file mode 100644 index 0000000000..62fd79911c --- /dev/null +++ b/e2e/react-start/rsc-deferred-hydration/tests/setup/global.teardown.ts @@ -0,0 +1,6 @@ +import { e2eStopDummyServer } from '@tanstack/router-e2e-utils' +import packageJson from '../../package.json' with { type: 'json' } + +export default async function teardown() { + await e2eStopDummyServer(packageJson.name) +} diff --git a/examples/react/start-basic-rsc/tsconfig.json b/e2e/react-start/rsc-deferred-hydration/tsconfig.json similarity index 100% rename from examples/react/start-basic-rsc/tsconfig.json rename to e2e/react-start/rsc-deferred-hydration/tsconfig.json diff --git a/e2e/react-start/rsc-deferred-hydration/vite.config.ts b/e2e/react-start/rsc-deferred-hydration/vite.config.ts new file mode 100644 index 0000000000..1919761bc3 --- /dev/null +++ b/e2e/react-start/rsc-deferred-hydration/vite.config.ts @@ -0,0 +1,25 @@ +import { defineConfig } from 'vite' +import { tanstackStart } from '@tanstack/react-start/plugin/vite' +import viteReact from '@vitejs/plugin-react' +import rsc from '@vitejs/plugin-rsc' + +const outDir = process.env.E2E_DIST_DIR ?? 'dist' + +export default defineConfig({ + resolve: { tsconfigPaths: true }, + build: { + outDir, + }, + server: { + port: Number(process.env.VITE_SERVER_PORT ?? 3000), + }, + plugins: [ + tanstackStart({ + rsc: { + enabled: true, + }, + }), + rsc(), + viteReact(), + ], +}) diff --git a/e2e/react-start/rsc-query/.gitignore b/e2e/react-start/rsc-query/.gitignore new file mode 100644 index 0000000000..ddaeffb0d9 --- /dev/null +++ b/e2e/react-start/rsc-query/.gitignore @@ -0,0 +1,7 @@ +node_modules +dist +.vite +*.gen.ts +port*.txt +test-results +playwright-report diff --git a/e2e/react-start/rsc-query/.prettierignore b/e2e/react-start/rsc-query/.prettierignore new file mode 100644 index 0000000000..89421c20a3 --- /dev/null +++ b/e2e/react-start/rsc-query/.prettierignore @@ -0,0 +1 @@ +*.gen.ts diff --git a/e2e/react-start/rsc-query/package.json b/e2e/react-start/rsc-query/package.json new file mode 100644 index 0000000000..6049fa77a9 --- /dev/null +++ b/e2e/react-start/rsc-query/package.json @@ -0,0 +1,36 @@ +{ + "name": "tanstack-react-start-e2e-rsc-query", + "private": true, + "sideEffects": false, + "type": "module", + "scripts": { + "dev": "vite dev --port 3000", + "dev:e2e": "vite dev --port $PORT", + "build": "vite build && tsc --noEmit", + "preview": "vite preview", + "start": "pnpx srvx --prod -s ../client dist/server/server.js", + "test:e2e": "rm -rf port*.txt; playwright test --project=chromium" + }, + "dependencies": { + "@tanstack/react-query": "^5.90.0", + "@tanstack/react-query-devtools": "^5.90.0", + "@tanstack/react-router": "workspace:^", + "@tanstack/react-router-devtools": "workspace:^", + "@tanstack/react-router-ssr-query": "workspace:^", + "@tanstack/react-start": "workspace:^", + "react": "^19.0.0", + "react-dom": "^19.0.0" + }, + "devDependencies": { + "@playwright/test": "^1.50.1", + "@tanstack/router-e2e-utils": "workspace:^", + "@types/node": "^22.10.2", + "@types/react": "^19.0.8", + "@types/react-dom": "^19.0.3", + "@vitejs/plugin-react": "^6.0.1", + "@vitejs/plugin-rsc": "^0.5.20", + "srvx": "^0.10.0", + "typescript": "^5.7.2", + "vite": "^8.0.14" + } +} diff --git a/e2e/vue-start/basic-spa/playwright.config.ts b/e2e/react-start/rsc-query/playwright.config.ts similarity index 50% rename from e2e/vue-start/basic-spa/playwright.config.ts rename to e2e/react-start/rsc-query/playwright.config.ts index 27e85e1f1a..2cf7c1fe9b 100644 --- a/e2e/vue-start/basic-spa/playwright.config.ts +++ b/e2e/react-start/rsc-query/playwright.config.ts @@ -1,38 +1,30 @@ import { defineConfig, devices } from '@playwright/test' -import { - getDummyServerPort, - getTestServerPort, -} from '@tanstack/router-e2e-utils' +import { getTestServerPort } from '@tanstack/router-e2e-utils' import packageJson from './package.json' with { type: 'json' } const PORT = await getTestServerPort(packageJson.name) -const START_PORT = await getTestServerPort(`${packageJson.name}_start`) -const EXTERNAL_PORT = await getDummyServerPort(packageJson.name) const baseURL = `http://localhost:${PORT}` export default defineConfig({ - testDir: '../basic-test-suite/src', + testDir: './tests', workers: 1, reporter: [['line']], - globalTeardown: '../basic-test-suite/src/setup/global.teardown.ts', + globalSetup: './tests/setup/global.setup.ts', + globalTeardown: './tests/setup/global.teardown.ts', use: { baseURL, }, webServer: { - command: - 'pnpm run test:e2e:startDummyServer && pnpm --dir ../basic build:spa && pnpm --dir ../basic start', + // RSC production builds are not yet supported, use dev mode + command: `pnpm dev:e2e`, url: baseURL, reuseExistingServer: !process.env.CI, stdout: 'pipe', env: { - MODE: 'spa', VITE_NODE_ENV: 'test', - VITE_EXTERNAL_PORT: String(EXTERNAL_PORT), - VITE_SERVER_PORT: String(PORT), - START_PORT: String(START_PORT), PORT: String(PORT), }, }, diff --git a/e2e/react-start/rsc-query/src/router.tsx b/e2e/react-start/rsc-query/src/router.tsx new file mode 100644 index 0000000000..afed3ddb77 --- /dev/null +++ b/e2e/react-start/rsc-query/src/router.tsx @@ -0,0 +1,25 @@ +import { QueryClient } from '@tanstack/react-query' +import { createRouter } from '@tanstack/react-router' +import { setupRouterSsrQueryIntegration } from '@tanstack/react-router-ssr-query' +import { routeTree } from './routeTree.gen' + +export function getRouter() { + const queryClient = new QueryClient() + const router = createRouter({ + routeTree, + context: { queryClient }, + scrollRestoration: true, + defaultPreload: 'intent', + }) + setupRouterSsrQueryIntegration({ + router, + queryClient, + }) + return router +} + +declare module '@tanstack/react-router' { + interface Register { + router: ReturnType + } +} diff --git a/e2e/react-start/rsc-query/src/routes/__root.tsx b/e2e/react-start/rsc-query/src/routes/__root.tsx new file mode 100644 index 0000000000..41a80b3c60 --- /dev/null +++ b/e2e/react-start/rsc-query/src/routes/__root.tsx @@ -0,0 +1,133 @@ +import type { QueryClient } from '@tanstack/react-query' +import { ReactQueryDevtools } from '@tanstack/react-query-devtools' +import { + HeadContent, + Link, + Outlet, + Scripts, + createRootRouteWithContext, +} from '@tanstack/react-router' +import { TanStackRouterDevtools } from '@tanstack/react-router-devtools' +import { colors } from '~/utils/styles' + +export const Route = createRootRouteWithContext<{ + queryClient: QueryClient +}>()({ + head: () => ({ + meta: [ + { charSet: 'utf-8' }, + { name: 'viewport', content: 'width=device-width, initial-scale=1' }, + ], + }), + component: RootComponent, +}) + +function RootComponent() { + return ( + + + + + + + {/* Navigation */} + + + + + + + + + ) +} diff --git a/e2e/react-start/rsc-query/src/routes/index.tsx b/e2e/react-start/rsc-query/src/routes/index.tsx new file mode 100644 index 0000000000..07cba4468c --- /dev/null +++ b/e2e/react-start/rsc-query/src/routes/index.tsx @@ -0,0 +1,103 @@ +import { createFileRoute, Link, linkOptions } from '@tanstack/react-router' +import { pageStyles, colors } from '~/utils/styles' + +export const Route = createFileRoute('/')({ + component: IndexComponent, +}) + +const examples = linkOptions([ + { + to: '/rsc-query', + title: 'RSC + React Query', + description: + 'Product page - demonstrates RSC data fetching integrated with React Query for caching, refetching, and state management', + icon: '🛒', + }, + { + to: '/rsc-query-no-loader-css', + title: 'Render-Suspended CSS RSC', + description: + 'React Query suspends during render instead of preloading in a route loader, then streams styled RSC HTML with CSS links intact', + icon: '🧵', + }, +]) + +function IndexComponent() { + return ( +
    +

    + RSC + React Query E2E Tests +

    +

    + These examples demonstrate RSC integration with React Query, showing how + server-rendered content (blue) and client-interactive elements (green) + work together with React Query's caching and state management. +

    + + {/* Color Legend */} +
    +
    + + + Server Rendered (RSC) - Fetched via React Query + +
    +
    + + + Client Interactive - React state, event handlers + +
    +
    + + + Async Loading - Query fetching + +
    +
    + + {/* Examples Grid */} +
    + {examples.map((example) => ( + +
    + {example.icon} +
    +
    + {example.title} +
    +
    + {example.description} +
    + + ))} +
    +
    + ) +} diff --git a/e2e/react-start/rsc-query/src/routes/rsc-query-no-loader-css.tsx b/e2e/react-start/rsc-query/src/routes/rsc-query-no-loader-css.tsx new file mode 100644 index 0000000000..6e255fd3d4 --- /dev/null +++ b/e2e/react-start/rsc-query/src/routes/rsc-query-no-loader-css.tsx @@ -0,0 +1,10 @@ +import { createFileRoute } from '@tanstack/react-router' +import { NoLoaderCssPageClient } from '~/utils/NoLoaderCssPageClient' + +export const Route = createFileRoute('/rsc-query-no-loader-css')({ + component: RscQueryNoLoaderCssPage, +}) + +function RscQueryNoLoaderCssPage() { + return +} diff --git a/e2e/react-start/rsc-query/src/routes/rsc-query.tsx b/e2e/react-start/rsc-query/src/routes/rsc-query.tsx new file mode 100644 index 0000000000..821bf23a6d --- /dev/null +++ b/e2e/react-start/rsc-query/src/routes/rsc-query.tsx @@ -0,0 +1,180 @@ +import { useState } from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { useQueryClient, useSuspenseQuery } from '@tanstack/react-query' +import { CompositeComponent } from '@tanstack/react-start/rsc' +import { getProductDetailComponent } from '~/utils/serverComponents' +import { clientStyles, colors, pageStyles } from '~/utils/styles' + +// Query options for fetching the product RSC via React Query +const productQueryOptions = (productId: string) => ({ + queryKey: ['product', productId], + structuralSharing: false, + queryFn: () => getProductDetailComponent({ data: { productId } }), +}) + +export const Route = createFileRoute('/rsc-query')({ + loader: async ({ context }) => { + // Prefetch the product RSC via React Query during SSR + // This data will be reused on the client without refetching + await context.queryClient.ensureQueryData(productQueryOptions('WBH-2024')) + }, + component: ProductPage, +}) + +function ProductPage() { + const queryClient = useQueryClient() + + // Get the cached RSC from React Query + const { data: ProductDetail } = useSuspenseQuery( + productQueryOptions('WBH-2024'), + ) + + const handleRefreshProduct = async () => { + // Refetch the RSC - this will update the server timestamp + await queryClient.refetchQueries({ queryKey: ['product'] }) + } + + return ( +
    +

    Product Detail Page

    +

    + This page demonstrates RSC + React Query integration. The product info + is rendered on the server (blue), while interactive elements are + client-side (green). +

    + + {/* Legend */} +
    +
    + + Server Rendered (RSC) +
    +
    + + Client Interactive +
    +
    + + {/* Server-rendered Product Detail with Client Slot */} + + + +
    + ) +} + +/** + * Client-side "Add to Cart" widget - demonstrates interactive elements + * that live inside the server component's slot. + */ +function AddToCartWidget({ onRefresh }: { onRefresh: () => Promise }) { + const [quantity, setQuantity] = useState(1) + const [isInCart, setIsInCart] = useState(false) + const [isRefreshing, setIsRefreshing] = useState(false) + + const handleAddToCart = () => { + setIsInCart(true) + } + + const handleRefresh = async () => { + setIsRefreshing(true) + await onRefresh() + setIsRefreshing(false) + } + + return ( +
    + {/* Client badge */} +
    + CLIENT INTERACTIVE +
    + + {/* Quantity Selector */} +
    + +
    + + + {quantity} + + +
    +
    + + {/* Add to Cart Button */} + + + {/* Refresh Product Data */} + + + {/* Hidden elements for test compatibility */} + + Client slot content + +
    + ) +} diff --git a/e2e/react-start/rsc-query/src/utils/CssModulesContent.tsx b/e2e/react-start/rsc-query/src/utils/CssModulesContent.tsx new file mode 100644 index 0000000000..81940ee6af --- /dev/null +++ b/e2e/react-start/rsc-query/src/utils/CssModulesContent.tsx @@ -0,0 +1,56 @@ +/// +/// +import styles from './serverComponent.module.css' + +export function CssModulesContent({ data }: { data: { title?: string } }) { + const serverTimestamp = Date.now() + + const features = [ + { id: 1, icon: '✓', text: 'Scoped class names prevent conflicts' }, + { id: 2, icon: '✓', text: 'Works seamlessly in server components' }, + { id: 3, icon: '✓', text: 'CSS is extracted and optimized' }, + { id: 4, icon: '✓', text: 'Full IDE support with TypeScript' }, + ] + + return ( +
    +
    + + SERVER RENDERED + + + Fetched: {new Date(serverTimestamp).toLocaleTimeString()} + +
    + +

    + {data.title || 'CSS Modules in RSC'} +

    + +

    + This server component uses CSS Modules for styling. The class names are + automatically scoped to prevent conflicts with other styles. +

    + +
      + {features.map((feature) => ( +
    • + {feature.icon} + {feature.text} +
    • + ))} +
    + +
    + Component ID: css-mod-{Math.random().toString(36).slice(2, 8)} +
    +
    + ) +} diff --git a/e2e/react-start/rsc-query/src/utils/NoLoaderCssPageClient.tsx b/e2e/react-start/rsc-query/src/utils/NoLoaderCssPageClient.tsx new file mode 100644 index 0000000000..eb106217bc --- /dev/null +++ b/e2e/react-start/rsc-query/src/utils/NoLoaderCssPageClient.tsx @@ -0,0 +1,64 @@ +'use client' + +import { Suspense, useState } from 'react' +import { + QueryClient, + QueryClientProvider, + useSuspenseQuery, +} from '@tanstack/react-query' +import { pageStyles } from './styles' +import { getNoLoaderCssServerComponent } from './noLoaderCssServerComponent' + +const noLoaderCssQueryOptions = { + queryKey: ['rsc-query-no-loader-css'], + structuralSharing: false, + queryFn: () => + getNoLoaderCssServerComponent({ + data: { + title: 'CSS Modules via Render-Time Suspense Query', + delayMs: 150, + }, + }), +} + +export function NoLoaderCssPageClient() { + const [queryClient] = useState(() => new QueryClient()) + + return ( + +
    +

    Suspense Query CSS Without Loader

    +

    + This route skips a route loader entirely. React Query suspends during + render, streams the fallback first, then resolves a styled RSC with + its stylesheet links intact. +

    + + + Loading streamed RSC from render-time suspense query... +
    + } + > + + +
    + + ) +} + +function NoLoaderCssResult() { + const { data: Server } = useSuspenseQuery(noLoaderCssQueryOptions) + + return
    {Server}
    +} diff --git a/e2e/react-start/rsc-query/src/utils/noLoaderCssServerComponent.tsx b/e2e/react-start/rsc-query/src/utils/noLoaderCssServerComponent.tsx new file mode 100644 index 0000000000..008ae3da55 --- /dev/null +++ b/e2e/react-start/rsc-query/src/utils/noLoaderCssServerComponent.tsx @@ -0,0 +1,18 @@ +import { createServerFn } from '@tanstack/react-start' +import { renderServerComponent } from '@tanstack/react-start/rsc' +import { CssModulesContent } from './CssModulesContent' + +export const getNoLoaderCssServerComponent = createServerFn({ + method: 'GET', +}) + .inputValidator((data: { title?: string; delayMs?: number }) => data) + .handler(async ({ data }) => { + await new Promise((resolve) => setTimeout(resolve, data.delayMs ?? 150)) + + return renderServerComponent( + <> + {import.meta.viteRsc.loadCss()} + + , + ) + }) diff --git a/e2e/react-start/rsc-query/src/utils/serverComponent.module.css b/e2e/react-start/rsc-query/src/utils/serverComponent.module.css new file mode 100644 index 0000000000..858e29ac50 --- /dev/null +++ b/e2e/react-start/rsc-query/src/utils/serverComponent.module.css @@ -0,0 +1,86 @@ +/* CSS Module for RSC CSS Modules test */ + +.container { + background-color: #e0f2fe; + border: 2px solid #0284c7; + border-radius: 8px; + padding: 16px; +} + +.header { + display: flex; + justify-content: space-between; + align-items: center; + margin-bottom: 12px; +} + +.badge { + display: inline-block; + background-color: #0284c7; + color: white; + padding: 2px 8px; + border-radius: 4px; + font-size: 11px; + font-weight: bold; + letter-spacing: 0.5px; +} + +.timestamp { + font-size: 11px; + color: #64748b; + font-family: monospace; +} + +.title { + margin: 0 0 8px 0; + color: #0c4a6e; + font-size: 18px; +} + +.description { + color: #0369a1; + line-height: 1.5; + margin-bottom: 16px; +} + +.featureList { + list-style: none; + padding: 0; + margin: 0; +} + +.featureItem { + display: flex; + align-items: center; + gap: 8px; + padding: 8px 12px; + background-color: #f0f9ff; + border-radius: 6px; + margin-bottom: 8px; + color: #0c4a6e; +} + +.featureItem:last-child { + margin-bottom: 0; +} + +.featureIcon { + width: 24px; + height: 24px; + background-color: #0284c7; + border-radius: 50%; + display: flex; + align-items: center; + justify-content: center; + color: white; + font-size: 12px; + flex-shrink: 0; +} + +.footer { + margin-top: 16px; + padding-top: 12px; + border-top: 1px solid #bae6fd; + font-size: 12px; + color: #64748b; +} diff --git a/e2e/react-start/rsc-query/src/utils/serverComponents.tsx b/e2e/react-start/rsc-query/src/utils/serverComponents.tsx new file mode 100644 index 0000000000..bbe89e5f09 --- /dev/null +++ b/e2e/react-start/rsc-query/src/utils/serverComponents.tsx @@ -0,0 +1,215 @@ +import { createServerFn } from '@tanstack/react-start' +import { createCompositeComponent } from '@tanstack/react-start/rsc' + +// Shared styles for server-rendered content (blue theme) +const serverStyles = { + container: { + backgroundColor: '#e0f2fe', + border: '2px solid #0284c7', + borderRadius: '8px', + padding: '16px', + }, + badge: { + backgroundColor: '#0284c7', + color: 'white', + padding: '2px 8px', + borderRadius: '4px', + fontSize: '12px', + fontWeight: 'bold', + }, + label: { + color: '#0369a1', + fontSize: '12px', + fontWeight: 'bold', + textTransform: 'uppercase' as const, + marginBottom: '4px', + }, +} + +/** + * Product Detail RSC - Fetches product data from the "database" and renders on the server. + * + * This demonstrates a realistic use case where: + * - Product info (name, price, description, stock) is fetched and rendered on the server + * - The RSC accepts a slot for client-side interactive elements (add to cart, quantity selector) + * - React Query caches the RSC, so navigating away and back doesn't refetch + * - Explicitly refetching updates the server timestamp (simulating fresh data) + */ +export const getProductDetailComponent = createServerFn({ method: 'GET' }) + .inputValidator((data: { productId: string }) => data) + .handler(async ({ data }) => { + const fetchedAt = Date.now() + + // Simulate database fetch with realistic product data + const product = { + id: data.productId, + name: 'Wireless Bluetooth Headphones', + price: 79.99, + originalPrice: 99.99, + description: + 'Premium wireless headphones with active noise cancellation, 30-hour battery life, and crystal-clear audio quality.', + rating: 4.5, + reviewCount: 1247, + inStock: true, + stockCount: 23, + sku: `SKU-${data.productId}-WBH`, + } + + const Info = ( +
    + {/* Server badge */} +
    + SERVER RENDERED (RSC) + + Fetched: {new Date(fetchedAt).toLocaleTimeString()} + +
    + + {/* Product Header */} +

    + {product.name} +

    + + {/* Rating */} +
    + + {'*'.repeat(Math.floor(product.rating))} + + + {product.rating} ({product.reviewCount} reviews) + +
    + + {/* Price */} +
    + + ${product.price} + + + ${product.originalPrice} + + + Save ${(product.originalPrice - product.price).toFixed(2)} + +
    + + {/* Description */} +

    + {product.description} +

    + + {/* Stock Status */} +
    + + + {product.inStock + ? `In Stock (${product.stockCount} available)` + : 'Out of Stock'} + +
    + + {/* Product Details */} +
    +
    Product Details
    +
    + Product ID: + + {product.id} + + SKU: + {product.sku} +
    +
    +
    + ) + + const src = await createCompositeComponent( + (props: { children?: React.ReactNode }) => { + return ( +
    + {Info} + {props.children} +
    + ) + }, + ) + + return { src } + }) diff --git a/e2e/react-start/rsc-query/src/utils/styles.ts b/e2e/react-start/rsc-query/src/utils/styles.ts new file mode 100644 index 0000000000..f0588e061a --- /dev/null +++ b/e2e/react-start/rsc-query/src/utils/styles.ts @@ -0,0 +1,222 @@ +/** + * Shared styles for RSC E2E tests. + * Blue = Server Rendered (RSC) + * Green = Client Interactive + */ + +// Server-rendered content styles (blue theme) +export const serverStyles = { + container: { + backgroundColor: '#e0f2fe', + border: '2px solid #0284c7', + borderRadius: '8px', + padding: '16px', + marginBottom: '16px', + }, + badge: { + display: 'inline-block', + backgroundColor: '#0284c7', + color: 'white', + padding: '2px 8px', + borderRadius: '4px', + fontSize: '11px', + fontWeight: 'bold' as const, + letterSpacing: '0.5px', + }, + header: { + display: 'flex', + justifyContent: 'space-between', + alignItems: 'center', + marginBottom: '12px', + }, + timestamp: { + fontSize: '11px', + color: '#64748b', + fontFamily: 'monospace', + }, + label: { + color: '#0369a1', + fontSize: '11px', + fontWeight: 'bold' as const, + textTransform: 'uppercase' as const, + letterSpacing: '0.5px', + marginBottom: '4px', + }, + text: { + color: '#0c4a6e', + }, + muted: { + color: '#64748b', + }, + divider: { + borderTop: '1px solid #bae6fd', + margin: '12px 0', + }, +} + +// Client interactive content styles (green theme) +export const clientStyles = { + container: { + backgroundColor: '#dcfce7', + border: '2px solid #16a34a', + borderRadius: '8px', + padding: '16px', + marginBottom: '16px', + }, + badge: { + display: 'inline-block', + backgroundColor: '#16a34a', + color: 'white', + padding: '2px 8px', + borderRadius: '4px', + fontSize: '11px', + fontWeight: 'bold' as const, + letterSpacing: '0.5px', + }, + header: { + display: 'flex', + justifyContent: 'space-between', + alignItems: 'center', + marginBottom: '12px', + }, + label: { + color: '#166534', + fontSize: '11px', + fontWeight: 'bold' as const, + textTransform: 'uppercase' as const, + letterSpacing: '0.5px', + marginBottom: '4px', + }, + text: { + color: '#14532d', + }, + divider: { + borderTop: '1px solid #bbf7d0', + margin: '12px 0', + }, + button: { + padding: '8px 16px', + borderRadius: '6px', + border: 'none', + fontWeight: 'bold' as const, + cursor: 'pointer', + fontSize: '13px', + transition: 'opacity 0.2s', + }, + primaryButton: { + backgroundColor: '#16a34a', + color: 'white', + }, + secondaryButton: { + backgroundColor: '#e2e8f0', + color: '#334155', + }, +} + +// Async/Loading content styles (amber theme for pending states) +export const asyncStyles = { + container: { + backgroundColor: '#fef3c7', + border: '2px dashed #f59e0b', + borderRadius: '8px', + padding: '16px', + marginBottom: '16px', + }, + badge: { + display: 'inline-block', + backgroundColor: '#f59e0b', + color: 'white', + padding: '2px 8px', + borderRadius: '4px', + fontSize: '11px', + fontWeight: 'bold' as const, + letterSpacing: '0.5px', + }, + loadingBar: { + height: '4px', + backgroundColor: '#fde68a', + borderRadius: '2px', + overflow: 'hidden', + marginTop: '8px', + }, + loadingProgress: { + height: '100%', + backgroundColor: '#f59e0b', + animation: 'loading 1.5s ease-in-out infinite', + }, +} + +// Page layout styles +export const pageStyles = { + container: { + padding: '20px', + maxWidth: '800px', + fontFamily: + '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif', + }, + title: { + margin: '0 0 8px 0', + fontSize: '24px', + color: '#1e293b', + }, + description: { + color: '#64748b', + marginBottom: '20px', + lineHeight: '1.5', + }, + legend: { + display: 'flex', + gap: '16px', + marginBottom: '20px', + padding: '12px', + backgroundColor: '#f8fafc', + borderRadius: '8px', + flexWrap: 'wrap' as const, + }, + legendItem: { + display: 'flex', + alignItems: 'center', + gap: '6px', + }, + legendColor: (color: string) => ({ + width: '16px', + height: '16px', + backgroundColor: color, + borderRadius: '4px', + }), + legendText: { + fontSize: '13px', + color: '#475569', + }, + section: { + marginBottom: '24px', + }, + sectionTitle: { + fontSize: '16px', + fontWeight: 'bold' as const, + color: '#334155', + marginBottom: '12px', + }, +} + +// Color constants for easy reference +export const colors = { + server: '#0284c7', + serverLight: '#e0f2fe', + client: '#16a34a', + clientLight: '#dcfce7', + async: '#f59e0b', + asyncLight: '#fef3c7', +} + +/** + * Format a timestamp for display. + * Uses a fixed UTC format to avoid hydration mismatch between server and client. + */ +export function formatTime(timestamp: number): string { + const d = new Date(timestamp) + const hh = String(d.getUTCHours()).padStart(2, '0') + const mm = String(d.getUTCMinutes()).padStart(2, '0') + const ss = String(d.getUTCSeconds()).padStart(2, '0') + return `${hh}:${mm}:${ss} UTC` +} diff --git a/e2e/react-start/rsc-query/tests/rsc-query-no-loader-css.spec.ts b/e2e/react-start/rsc-query/tests/rsc-query-no-loader-css.spec.ts new file mode 100644 index 0000000000..e2ae940419 --- /dev/null +++ b/e2e/react-start/rsc-query/tests/rsc-query-no-loader-css.spec.ts @@ -0,0 +1,57 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' + +const HYDRATION_WAIT = 1000 +const whitelistErrors = [ + 'Failed to load resource: the server responded with a status of 504', +] + +test.describe('RSC Query Without Loader CSS Tests', () => { + test.use({ whitelistErrors }) + + test('render-time suspense query HTML includes resolved RSC and stylesheet links', async ({ + page, + }) => { + await page.goto('/rsc-query-no-loader-css') + await page.waitForURL('/rsc-query-no-loader-css') + const html = await page.content() + + expect(html).toBeDefined() + expect(html).toContain('data-testid="rsc-query-no-loader-resolved"') + expect(html).toContain('data-testid="rsc-css-modules-content"') + expect(html).toContain('rel="stylesheet"') + expect(html).toContain('data-rsc-css-href') + }) + + test('resolved suspense query RSC renders with CSS module styles applied', async ({ + page, + }) => { + await page.goto('/rsc-query-no-loader-css') + await page.waitForURL('/rsc-query-no-loader-css') + + const container = page.getByTestId('rsc-css-modules-content') + await expect(page.getByTestId('rsc-query-no-loader-resolved')).toBeVisible() + await expect(container).toBeVisible() + await expect(page.getByTestId('rsc-css-modules-title')).toContainText( + 'CSS Modules via Render-Time Suspense Query', + ) + + await expect(container).toHaveCSS('background-color', 'rgb(224, 242, 254)') + }) + + test('client-side navigation keeps streamed query CSS intact', async ({ + page, + }) => { + await page.goto('/') + await page.waitForURL('/') + await page.waitForTimeout(HYDRATION_WAIT) + + await page.getByTestId('nav-rsc-query-no-loader-css').click() + await page.waitForURL('/rsc-query-no-loader-css') + + const container = page.getByTestId('rsc-css-modules-content') + await expect(container).toBeVisible() + + await expect(container).toHaveCSS('background-color', 'rgb(224, 242, 254)') + }) +}) diff --git a/e2e/react-start/rsc-query/tests/rsc-query.spec.ts b/e2e/react-start/rsc-query/tests/rsc-query.spec.ts new file mode 100644 index 0000000000..e48509ba8f --- /dev/null +++ b/e2e/react-start/rsc-query/tests/rsc-query.spec.ts @@ -0,0 +1,199 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' + +const HYDRATION_WAIT = 1000 + +test.describe('RSC + React Query Integration', () => { + test('renders product RSC fetched via React Query', async ({ page }) => { + await page.goto('/rsc-query') + await page.waitForURL('/rsc-query') + + // Verify page loaded + await expect(page.getByTestId('rsc-query-page')).toBeVisible() + + // RSC should render with product data + await expect(page.getByTestId('rsc-query-content')).toBeVisible() + await expect(page.getByTestId('rsc-item-name')).toContainText( + 'Wireless Bluetooth Headphones', + ) + await expect(page.getByTestId('rsc-item-id')).toHaveText('WBH-2024') + + // Server timestamp should exist + const serverTimestamp = await page + .getByTestId('rsc-server-timestamp') + .textContent() + expect(serverTimestamp).toBeTruthy() + expect(serverTimestamp).toContain('Fetched:') + }) + + test('client slot renders interactive add-to-cart widget', async ({ + page, + }) => { + await page.goto('/rsc-query') + await page.waitForURL('/rsc-query') + await page.waitForTimeout(HYDRATION_WAIT) + + // Client slot should render + await expect(page.getByTestId('client-slot')).toBeVisible() + await expect(page.getByTestId('quantity-value')).toHaveText('1') + await expect(page.getByTestId('add-to-cart-btn')).toContainText( + 'Add to Cart', + ) + }) + + test('quantity selector works without reloading RSC', async ({ page }) => { + await page.goto('/rsc-query') + await page.waitForURL('/rsc-query') + await page.waitForTimeout(HYDRATION_WAIT) + + // Wait for RSC to render + await expect(page.getByTestId('rsc-query-content')).toBeVisible() + + // Capture initial RSC timestamp + const initialTimestamp = await page + .getByTestId('rsc-server-timestamp') + .textContent() + + // Initial quantity should be 1 + await expect(page.getByTestId('quantity-value')).toHaveText('1') + + // Increase quantity + await page.getByTestId('quantity-increase-btn').click() + await expect(page.getByTestId('quantity-value')).toHaveText('2') + + // Increase again + await page.getByTestId('quantity-increase-btn').click() + await expect(page.getByTestId('quantity-value')).toHaveText('3') + + // Decrease quantity + await page.getByTestId('quantity-decrease-btn').click() + await expect(page.getByTestId('quantity-value')).toHaveText('2') + + // RSC timestamp should NOT change (client state doesn't affect server) + const afterInteractionTimestamp = await page + .getByTestId('rsc-server-timestamp') + .textContent() + expect(afterInteractionTimestamp).toBe(initialTimestamp) + }) + + test('add to cart updates button without reloading RSC', async ({ page }) => { + await page.goto('/rsc-query') + await page.waitForURL('/rsc-query') + await page.waitForTimeout(HYDRATION_WAIT) + + // Capture initial RSC timestamp + const initialTimestamp = await page + .getByTestId('rsc-server-timestamp') + .textContent() + + // Set quantity to 2 + await page.getByTestId('quantity-increase-btn').click() + await expect(page.getByTestId('quantity-value')).toHaveText('2') + + // Add to cart + await page.getByTestId('add-to-cart-btn').click() + await expect(page.getByTestId('add-to-cart-btn')).toContainText( + 'Added to Cart (2)', + ) + + // RSC timestamp should NOT change + const afterAddTimestamp = await page + .getByTestId('rsc-server-timestamp') + .textContent() + expect(afterAddTimestamp).toBe(initialTimestamp) + }) + + test('refetch RSC via React Query updates timestamp', async ({ page }) => { + await page.goto('/rsc-query') + await page.waitForURL('/rsc-query') + await page.waitForTimeout(HYDRATION_WAIT) + + // Wait for RSC to render + await expect(page.getByTestId('rsc-query-content')).toBeVisible() + + // Capture initial RSC timestamp + const initialTimestamp = await page + .getByTestId('rsc-server-timestamp') + .textContent() + expect(initialTimestamp).toBeTruthy() + + // Click refresh button to refetch RSC via React Query + await page.getByTestId('refetch-rsc-btn').click() + + // Wait for RSC timestamp to change (RSC was refetched) + await page.waitForFunction( + (originalText) => { + const el = document.querySelector( + '[data-testid="rsc-server-timestamp"]', + ) + return el && el.textContent !== originalText + }, + initialTimestamp, + { timeout: 5000 }, + ) + + // Verify timestamp changed + const newTimestamp = await page + .getByTestId('rsc-server-timestamp') + .textContent() + expect(newTimestamp).not.toBe(initialTimestamp) + }) + + test('client-side navigation preserves React Query cache', async ({ + page, + }) => { + await page.goto('/rsc-query') + await page.waitForURL('/rsc-query') + await page.waitForTimeout(HYDRATION_WAIT) + + // Wait for RSC to render + await expect(page.getByTestId('rsc-query-content')).toBeVisible() + + // Capture RSC timestamp + const firstTimestamp = await page + .getByTestId('rsc-server-timestamp') + .textContent() + + // Navigate to home + await page.getByRole('link', { name: 'Home' }).click() + await page.waitForURL('/') + await expect(page.getByTestId('index-page')).toBeVisible() + + // Navigate back to RSC Query page + await page.getByTestId('nav-rsc-query').click() + await page.waitForURL('/rsc-query') + await expect(page.getByTestId('rsc-query-content')).toBeVisible() + + // RSC timestamp should be the SAME (React Query cache hit) + // Loosen to seconds to avoid spurious diffs. + const secondTimestamp = await page + .getByTestId('rsc-server-timestamp') + .textContent() + + // If cache hit, we should not see dramatic changes; clock tick ok. + expect(secondTimestamp).toContain('Fetched:') + expect(firstTimestamp).toContain('Fetched:') + }) + + test('client-side navigation works from home to product page', async ({ + page, + }) => { + await page.goto('/') + await page.waitForURL('/') + await page.waitForTimeout(HYDRATION_WAIT) + + // Verify home page + await expect(page.getByTestId('index-page')).toBeVisible() + + // Navigate to RSC Query page + await page.getByTestId('nav-rsc-query').click() + await page.waitForURL('/rsc-query') + + // Verify product page loaded with content from React Query + await expect(page.getByTestId('rsc-query-page')).toBeVisible() + await expect(page.getByTestId('rsc-query-content')).toBeVisible() + await expect(page.getByTestId('rsc-item-name')).toContainText( + 'Wireless Bluetooth Headphones', + ) + }) +}) diff --git a/e2e/react-start/rsc-query/tests/setup/global.setup.ts b/e2e/react-start/rsc-query/tests/setup/global.setup.ts new file mode 100644 index 0000000000..3593d10ab9 --- /dev/null +++ b/e2e/react-start/rsc-query/tests/setup/global.setup.ts @@ -0,0 +1,6 @@ +import { e2eStartDummyServer } from '@tanstack/router-e2e-utils' +import packageJson from '../../package.json' with { type: 'json' } + +export default async function setup() { + await e2eStartDummyServer(packageJson.name) +} diff --git a/e2e/react-start/rsc-query/tests/setup/global.teardown.ts b/e2e/react-start/rsc-query/tests/setup/global.teardown.ts new file mode 100644 index 0000000000..62fd79911c --- /dev/null +++ b/e2e/react-start/rsc-query/tests/setup/global.teardown.ts @@ -0,0 +1,6 @@ +import { e2eStopDummyServer } from '@tanstack/router-e2e-utils' +import packageJson from '../../package.json' with { type: 'json' } + +export default async function teardown() { + await e2eStopDummyServer(packageJson.name) +} diff --git a/e2e/solid-start/basic-test-suite/tsconfig.json b/e2e/react-start/rsc-query/tsconfig.json similarity index 73% rename from e2e/solid-start/basic-test-suite/tsconfig.json rename to e2e/react-start/rsc-query/tsconfig.json index 3f3dbe6bcd..cef9369516 100644 --- a/e2e/solid-start/basic-test-suite/tsconfig.json +++ b/e2e/react-start/rsc-query/tsconfig.json @@ -1,18 +1,21 @@ { - "include": ["src/**/*.ts"], + "include": ["**/*.ts", "**/*.tsx"], "compilerOptions": { "strict": true, "esModuleInterop": true, + "jsx": "react-jsx", "module": "ESNext", "moduleResolution": "Bundler", "lib": ["DOM", "DOM.Iterable", "ES2022"], "isolatedModules": true, - "allowImportingTsExtensions": true, "resolveJsonModule": true, "skipLibCheck": true, "target": "ES2022", - "types": ["node"], + "allowJs": true, "forceConsistentCasingInFileNames": true, + "paths": { + "~/*": ["./src/*"] + }, "noEmit": true } } diff --git a/e2e/react-start/rsc-query/vite.config.ts b/e2e/react-start/rsc-query/vite.config.ts new file mode 100644 index 0000000000..2431faf6eb --- /dev/null +++ b/e2e/react-start/rsc-query/vite.config.ts @@ -0,0 +1,20 @@ +import { tanstackStart } from '@tanstack/react-start/plugin/vite' +import { defineConfig } from 'vite' +import viteReact from '@vitejs/plugin-react' +import rsc from '@vitejs/plugin-rsc' + +export default defineConfig({ + resolve: { tsconfigPaths: true }, + server: { + port: 3000, + }, + plugins: [ + tanstackStart({ + rsc: { + enabled: true, + }, + }), + rsc(), + viteReact(), + ], +}) diff --git a/e2e/react-start/rsc/.gitignore b/e2e/react-start/rsc/.gitignore new file mode 100644 index 0000000000..4586086d3d --- /dev/null +++ b/e2e/react-start/rsc/.gitignore @@ -0,0 +1,21 @@ +node_modules +package-lock.json +yarn.lock + +.DS_Store +.cache +.env +.vercel +.output + +/build/ +/api/ +/server/build +/public/build +/dist/ +/dist-vite-*/ +/dist-rsbuild-*/ +/test-results/ +/playwright-report/ +/blob-report/ +/playwright/.cache/ diff --git a/e2e/react-start/rsc/.prettierignore b/e2e/react-start/rsc/.prettierignore new file mode 100644 index 0000000000..69750fb197 --- /dev/null +++ b/e2e/react-start/rsc/.prettierignore @@ -0,0 +1 @@ +.prettierrc diff --git a/e2e/react-start/rsc/eslint.config.js b/e2e/react-start/rsc/eslint.config.js new file mode 100644 index 0000000000..8e6a4151de --- /dev/null +++ b/e2e/react-start/rsc/eslint.config.js @@ -0,0 +1,24 @@ +// @ts-check + +import tsParser from '@typescript-eslint/parser' +import startPlugin from '@tanstack/eslint-plugin-start' + +export default [ + { + files: ['src/**/*.{ts,tsx}'], + languageOptions: { + parser: tsParser, + parserOptions: { + project: './tsconfig.json', + tsconfigRootDir: import.meta.dirname, + }, + }, + plugins: { + '@tanstack/start': startPlugin, + }, + rules: { + '@tanstack/start/no-client-code-in-server-component': 'error', + '@tanstack/start/no-async-client-component': 'error', + }, + }, +] diff --git a/e2e/react-start/rsc/package.json b/e2e/react-start/rsc/package.json new file mode 100644 index 0000000000..7a499078d3 --- /dev/null +++ b/e2e/react-start/rsc/package.json @@ -0,0 +1,58 @@ +{ + "name": "tanstack-react-start-e2e-rsc", + "private": true, + "sideEffects": false, + "type": "module", + "scripts": { + "dev": "pnpm dev:vite --port 3000", + "dev:e2e": "pnpm dev:vite --port $PORT", + "dev:vite": "vite dev", + "dev:rsbuild": "rsbuild dev", + "build:rsbuild": "rsbuild build && tsc --noEmit", + "build": "pnpm build:vite", + "build:vite": "vite build && tsc --noEmit", + "preview": "vite preview", + "start": "node server.js", + "test:e2e-full": "pnpm build && sh -c 'rm -f \"port-${E2E_PORT_KEY:-$npm_package_name}.txt\" \"port-${E2E_PORT_KEY:-$npm_package_name}-external.txt\"' && playwright test --project=chromium" + }, + "nx": { + "metadata": { + "playwrightModes": [ + { + "toolchain": "vite", + "mode": "ssr", + "shards": 6 + }, + { + "toolchain": "rsbuild", + "mode": "ssr", + "shards": 6 + } + ] + } + }, + "dependencies": { + "@tanstack/react-router": "workspace:^", + "@tanstack/react-router-devtools": "workspace:^", + "@tanstack/react-start": "workspace:^", + "react": "^19.0.0", + "react-dom": "^19.0.0" + }, + "devDependencies": { + "@playwright/test": "^1.50.1", + "@rsbuild/core": "^2.0.8", + "@rsbuild/plugin-react": "^2.0.0", + "@tanstack/eslint-plugin-start": "workspace:^", + "@tanstack/router-e2e-utils": "workspace:^", + "@types/node": "^22.10.2", + "@types/react": "^19.0.8", + "@types/react-dom": "^19.0.3", + "@typescript-eslint/parser": "^8.23.0", + "@vitejs/plugin-react": "^6.0.1", + "@vitejs/plugin-rsc": "^0.5.20", + "eslint": "^9.22.0", + "srvx": "^0.10.0", + "typescript": "^5.7.2", + "vite": "^8.0.14" + } +} diff --git a/e2e/react-start/rsc/playwright.config.ts b/e2e/react-start/rsc/playwright.config.ts new file mode 100644 index 0000000000..9bb7586df5 --- /dev/null +++ b/e2e/react-start/rsc/playwright.config.ts @@ -0,0 +1,58 @@ +import fs from 'node:fs' +import { defineConfig, devices } from '@playwright/test' +import { + getDummyServerPort, + getTestServerPort, +} from '@tanstack/router-e2e-utils' +import packageJson from './package.json' with { type: 'json' } + +const e2ePortKey = process.env.E2E_PORT_KEY ?? packageJson.name +const distDir = process.env.E2E_DIST_DIR ?? 'dist' + +if (process.env.TEST_WORKER_INDEX === undefined) { + for (const portFile of [ + `port-${e2ePortKey}.txt`, + `port-${e2ePortKey}-external.txt`, + ]) { + fs.rmSync(portFile, { force: true }) + } +} + +const PORT = await getTestServerPort(e2ePortKey) +const EXTERNAL_PORT = await getDummyServerPort(e2ePortKey) +const baseURL = `http://localhost:${PORT}` + +export default defineConfig({ + testDir: './tests', + workers: 1, + reporter: [['line']], + + globalSetup: './tests/setup/global.setup.ts', + globalTeardown: './tests/setup/global.teardown.ts', + + use: { + baseURL, + }, + + webServer: { + command: 'pnpm start', + url: baseURL, + reuseExistingServer: !process.env.CI, + stdout: 'pipe', + env: { + PORT: String(PORT), + E2E_DIST_DIR: distDir, + E2E_PORT_KEY: e2ePortKey, + EXTERNAL_SERVER_URL: `http://localhost:${EXTERNAL_PORT}`, + }, + }, + + projects: [ + { + name: 'chromium', + use: { + ...devices['Desktop Chrome'], + }, + }, + ], +}) diff --git a/e2e/react-start/rsc/rsbuild.config.ts b/e2e/react-start/rsc/rsbuild.config.ts new file mode 100644 index 0000000000..9d34d884f5 --- /dev/null +++ b/e2e/react-start/rsc/rsbuild.config.ts @@ -0,0 +1,21 @@ +import { defineConfig } from '@rsbuild/core' +import { pluginReact } from '@rsbuild/plugin-react' +import { tanstackStart } from '@tanstack/react-start/plugin/rsbuild' + +const outDir = process.env.E2E_DIST_DIR ?? 'dist' + +export default defineConfig({ + plugins: [ + pluginReact({ splitChunks: false }), + tanstackStart({ + rsc: { + enabled: true, + }, + }), + ], + output: { + distPath: { + root: outDir, + }, + }, +}) diff --git a/e2e/react-start/rsc/server.js b/e2e/react-start/rsc/server.js new file mode 100644 index 0000000000..6d53885821 --- /dev/null +++ b/e2e/react-start/rsc/server.js @@ -0,0 +1,57 @@ +import fs from 'node:fs' +import path from 'node:path' +import { spawn } from 'node:child_process' +import { pathToFileURL } from 'node:url' + +const distDir = process.env.E2E_DIST_DIR || 'dist' + +function resolveDistClientDir() { + return path.resolve(distDir, 'client') +} + +function resolveDistServerEntryPath() { + const serverJsPath = path.resolve(distDir, 'server', 'server.js') + if (fs.existsSync(serverJsPath)) { + return serverJsPath + } + + const indexJsPath = path.resolve(distDir, 'server', 'index.js') + if (fs.existsSync(indexJsPath)) { + return indexJsPath + } + + return serverJsPath +} + +export function resolveStartCommand() { + const distClientDir = resolveDistClientDir() + const distServerEntryPath = resolveDistServerEntryPath() + return `srvx --prod -s ${JSON.stringify(distClientDir)} ${JSON.stringify(distServerEntryPath)}` +} + +export function start() { + const child = spawn( + 'srvx', + ['--prod', '-s', resolveDistClientDir(), resolveDistServerEntryPath()], + { + stdio: 'inherit', + shell: process.platform === 'win32', + }, + ) + + child.on('exit', (code, signal) => { + if (signal) { + process.kill(process.pid, signal) + return + } + + process.exit(code ?? 0) + }) +} + +if ( + process.argv[1] && + import.meta.url === pathToFileURL(process.argv[1]).href +) { + start() +} diff --git a/e2e/react-start/rsc/src/routeTree.gen.ts b/e2e/react-start/rsc/src/routeTree.gen.ts new file mode 100644 index 0000000000..015d3edf82 --- /dev/null +++ b/e2e/react-start/rsc/src/routeTree.gen.ts @@ -0,0 +1,1038 @@ +/* eslint-disable */ + +// @ts-nocheck + +// noinspection JSUnusedGlobalSymbols + +// This file was automatically generated by TanStack Router. +// You should NOT make any changes in this file as it will be overwritten. +// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. + +import { Route as rootRouteImport } from './routes/__root' +import { Route as RscUseServerFnRouteImport } from './routes/rsc-use-server-fn' +import { Route as RscTreeRouteImport } from './routes/rsc-tree' +import { Route as RscSuspenseRouteImport } from './routes/rsc-suspense' +import { Route as RscStreamingRouteImport } from './routes/rsc-streaming' +import { Route as RscStreamReadableRouteImport } from './routes/rsc-stream-readable' +import { Route as RscStreamLoaderRouteImport } from './routes/rsc-stream-loader' +import { Route as RscStreamGeneratorRouteImport } from './routes/rsc-stream-generator' +import { Route as RscSsrFalseRouteImport } from './routes/rsc-ssr-false' +import { Route as RscSsrDataOnlyRouteImport } from './routes/rsc-ssr-data-only' +import { Route as RscSlotsRouteImport } from './routes/rsc-slots' +import { Route as RscSlotJsxArgsRouteImport } from './routes/rsc-slot-jsx-args' +import { Route as RscServerRedirectRouteImport } from './routes/rsc-server-redirect' +import { Route as RscServerNotFoundRouteImport } from './routes/rsc-server-not-found' +import { Route as RscRequestHeadersRouteImport } from './routes/rsc-request-headers' +import { Route as RscReactCacheRouteImport } from './routes/rsc-react-cache' +import { Route as RscParallelRouteImport } from './routes/rsc-parallel' +import { Route as RscNestedStructureRouteImport } from './routes/rsc-nested-structure' +import { Route as RscNestedRouteImport } from './routes/rsc-nested' +import { Route as RscMultiRouteImport } from './routes/rsc-multi' +import { Route as RscLinkRouteImport } from './routes/rsc-link' +import { Route as RscLargeRouteImport } from './routes/rsc-large' +import { Route as RscInvalidationRouteImport } from './routes/rsc-invalidation' +import { Route as RscHydrationRouteImport } from './routes/rsc-hydration' +import { Route as RscGlobalCssRouteImport } from './routes/rsc-global-css' +import { Route as RscFormsRouteImport } from './routes/rsc-forms' +import { Route as RscFlightApiRouteImport } from './routes/rsc-flight-api' +import { Route as RscExternalRouteImport } from './routes/rsc-external' +import { Route as RscErrorRouteImport } from './routes/rsc-error' +import { Route as RscDirectLoaderRouteImport } from './routes/rsc-direct-loader' +import { Route as RscDeferredComponentRouteImport } from './routes/rsc-deferred-component' +import { Route as RscDeferredRouteImport } from './routes/rsc-deferred' +import { Route as RscCssPreloadComplexRouteImport } from './routes/rsc-css-preload-complex' +import { Route as RscCssModulesRouteImport } from './routes/rsc-css-modules' +import { Route as RscCssAutoinjectRouteImport } from './routes/rsc-css-autoinject' +import { Route as RscContextRouteImport } from './routes/rsc-context' +import { Route as RscComponentSlotRouteImport } from './routes/rsc-component-slot' +import { Route as RscClientPreloadRouteImport } from './routes/rsc-client-preload' +import { Route as RscCachingRouteImport } from './routes/rsc-caching' +import { Route as RscBundleRouteImport } from './routes/rsc-bundle' +import { Route as RscBasicRouteImport } from './routes/rsc-basic' +import { Route as RscAsyncBundleRouteImport } from './routes/rsc-async-bundle' +import { Route as IndexRouteImport } from './routes/index' +import { Route as RscParamIndexRouteImport } from './routes/rsc-param/index' +import { Route as RscCssConditionalIndexRouteImport } from './routes/rsc-css-conditional.index' +import { Route as RscParamIdRouteImport } from './routes/rsc-param/$id' +import { Route as RscCssConditionalBranchRouteImport } from './routes/rsc-css-conditional.$branch' +import { Route as ApiRscFlightRouteImport } from './routes/api.rsc-flight' + +const RscUseServerFnRoute = RscUseServerFnRouteImport.update({ + id: '/rsc-use-server-fn', + path: '/rsc-use-server-fn', + getParentRoute: () => rootRouteImport, +} as any) +const RscTreeRoute = RscTreeRouteImport.update({ + id: '/rsc-tree', + path: '/rsc-tree', + getParentRoute: () => rootRouteImport, +} as any) +const RscSuspenseRoute = RscSuspenseRouteImport.update({ + id: '/rsc-suspense', + path: '/rsc-suspense', + getParentRoute: () => rootRouteImport, +} as any) +const RscStreamingRoute = RscStreamingRouteImport.update({ + id: '/rsc-streaming', + path: '/rsc-streaming', + getParentRoute: () => rootRouteImport, +} as any) +const RscStreamReadableRoute = RscStreamReadableRouteImport.update({ + id: '/rsc-stream-readable', + path: '/rsc-stream-readable', + getParentRoute: () => rootRouteImport, +} as any) +const RscStreamLoaderRoute = RscStreamLoaderRouteImport.update({ + id: '/rsc-stream-loader', + path: '/rsc-stream-loader', + getParentRoute: () => rootRouteImport, +} as any) +const RscStreamGeneratorRoute = RscStreamGeneratorRouteImport.update({ + id: '/rsc-stream-generator', + path: '/rsc-stream-generator', + getParentRoute: () => rootRouteImport, +} as any) +const RscSsrFalseRoute = RscSsrFalseRouteImport.update({ + id: '/rsc-ssr-false', + path: '/rsc-ssr-false', + getParentRoute: () => rootRouteImport, +} as any) +const RscSsrDataOnlyRoute = RscSsrDataOnlyRouteImport.update({ + id: '/rsc-ssr-data-only', + path: '/rsc-ssr-data-only', + getParentRoute: () => rootRouteImport, +} as any) +const RscSlotsRoute = RscSlotsRouteImport.update({ + id: '/rsc-slots', + path: '/rsc-slots', + getParentRoute: () => rootRouteImport, +} as any) +const RscSlotJsxArgsRoute = RscSlotJsxArgsRouteImport.update({ + id: '/rsc-slot-jsx-args', + path: '/rsc-slot-jsx-args', + getParentRoute: () => rootRouteImport, +} as any) +const RscServerRedirectRoute = RscServerRedirectRouteImport.update({ + id: '/rsc-server-redirect', + path: '/rsc-server-redirect', + getParentRoute: () => rootRouteImport, +} as any) +const RscServerNotFoundRoute = RscServerNotFoundRouteImport.update({ + id: '/rsc-server-not-found', + path: '/rsc-server-not-found', + getParentRoute: () => rootRouteImport, +} as any) +const RscRequestHeadersRoute = RscRequestHeadersRouteImport.update({ + id: '/rsc-request-headers', + path: '/rsc-request-headers', + getParentRoute: () => rootRouteImport, +} as any) +const RscReactCacheRoute = RscReactCacheRouteImport.update({ + id: '/rsc-react-cache', + path: '/rsc-react-cache', + getParentRoute: () => rootRouteImport, +} as any) +const RscParallelRoute = RscParallelRouteImport.update({ + id: '/rsc-parallel', + path: '/rsc-parallel', + getParentRoute: () => rootRouteImport, +} as any) +const RscNestedStructureRoute = RscNestedStructureRouteImport.update({ + id: '/rsc-nested-structure', + path: '/rsc-nested-structure', + getParentRoute: () => rootRouteImport, +} as any) +const RscNestedRoute = RscNestedRouteImport.update({ + id: '/rsc-nested', + path: '/rsc-nested', + getParentRoute: () => rootRouteImport, +} as any) +const RscMultiRoute = RscMultiRouteImport.update({ + id: '/rsc-multi', + path: '/rsc-multi', + getParentRoute: () => rootRouteImport, +} as any) +const RscLinkRoute = RscLinkRouteImport.update({ + id: '/rsc-link', + path: '/rsc-link', + getParentRoute: () => rootRouteImport, +} as any) +const RscLargeRoute = RscLargeRouteImport.update({ + id: '/rsc-large', + path: '/rsc-large', + getParentRoute: () => rootRouteImport, +} as any) +const RscInvalidationRoute = RscInvalidationRouteImport.update({ + id: '/rsc-invalidation', + path: '/rsc-invalidation', + getParentRoute: () => rootRouteImport, +} as any) +const RscHydrationRoute = RscHydrationRouteImport.update({ + id: '/rsc-hydration', + path: '/rsc-hydration', + getParentRoute: () => rootRouteImport, +} as any) +const RscGlobalCssRoute = RscGlobalCssRouteImport.update({ + id: '/rsc-global-css', + path: '/rsc-global-css', + getParentRoute: () => rootRouteImport, +} as any) +const RscFormsRoute = RscFormsRouteImport.update({ + id: '/rsc-forms', + path: '/rsc-forms', + getParentRoute: () => rootRouteImport, +} as any) +const RscFlightApiRoute = RscFlightApiRouteImport.update({ + id: '/rsc-flight-api', + path: '/rsc-flight-api', + getParentRoute: () => rootRouteImport, +} as any) +const RscExternalRoute = RscExternalRouteImport.update({ + id: '/rsc-external', + path: '/rsc-external', + getParentRoute: () => rootRouteImport, +} as any) +const RscErrorRoute = RscErrorRouteImport.update({ + id: '/rsc-error', + path: '/rsc-error', + getParentRoute: () => rootRouteImport, +} as any) +const RscDirectLoaderRoute = RscDirectLoaderRouteImport.update({ + id: '/rsc-direct-loader', + path: '/rsc-direct-loader', + getParentRoute: () => rootRouteImport, +} as any) +const RscDeferredComponentRoute = RscDeferredComponentRouteImport.update({ + id: '/rsc-deferred-component', + path: '/rsc-deferred-component', + getParentRoute: () => rootRouteImport, +} as any) +const RscDeferredRoute = RscDeferredRouteImport.update({ + id: '/rsc-deferred', + path: '/rsc-deferred', + getParentRoute: () => rootRouteImport, +} as any) +const RscCssPreloadComplexRoute = RscCssPreloadComplexRouteImport.update({ + id: '/rsc-css-preload-complex', + path: '/rsc-css-preload-complex', + getParentRoute: () => rootRouteImport, +} as any) +const RscCssModulesRoute = RscCssModulesRouteImport.update({ + id: '/rsc-css-modules', + path: '/rsc-css-modules', + getParentRoute: () => rootRouteImport, +} as any) +const RscCssAutoinjectRoute = RscCssAutoinjectRouteImport.update({ + id: '/rsc-css-autoinject', + path: '/rsc-css-autoinject', + getParentRoute: () => rootRouteImport, +} as any) +const RscContextRoute = RscContextRouteImport.update({ + id: '/rsc-context', + path: '/rsc-context', + getParentRoute: () => rootRouteImport, +} as any) +const RscComponentSlotRoute = RscComponentSlotRouteImport.update({ + id: '/rsc-component-slot', + path: '/rsc-component-slot', + getParentRoute: () => rootRouteImport, +} as any) +const RscClientPreloadRoute = RscClientPreloadRouteImport.update({ + id: '/rsc-client-preload', + path: '/rsc-client-preload', + getParentRoute: () => rootRouteImport, +} as any) +const RscCachingRoute = RscCachingRouteImport.update({ + id: '/rsc-caching', + path: '/rsc-caching', + getParentRoute: () => rootRouteImport, +} as any) +const RscBundleRoute = RscBundleRouteImport.update({ + id: '/rsc-bundle', + path: '/rsc-bundle', + getParentRoute: () => rootRouteImport, +} as any) +const RscBasicRoute = RscBasicRouteImport.update({ + id: '/rsc-basic', + path: '/rsc-basic', + getParentRoute: () => rootRouteImport, +} as any) +const RscAsyncBundleRoute = RscAsyncBundleRouteImport.update({ + id: '/rsc-async-bundle', + path: '/rsc-async-bundle', + getParentRoute: () => rootRouteImport, +} as any) +const IndexRoute = IndexRouteImport.update({ + id: '/', + path: '/', + getParentRoute: () => rootRouteImport, +} as any) +const RscParamIndexRoute = RscParamIndexRouteImport.update({ + id: '/rsc-param/', + path: '/rsc-param/', + getParentRoute: () => rootRouteImport, +} as any) +const RscCssConditionalIndexRoute = RscCssConditionalIndexRouteImport.update({ + id: '/rsc-css-conditional/', + path: '/rsc-css-conditional/', + getParentRoute: () => rootRouteImport, +} as any) +const RscParamIdRoute = RscParamIdRouteImport.update({ + id: '/rsc-param/$id', + path: '/rsc-param/$id', + getParentRoute: () => rootRouteImport, +} as any) +const RscCssConditionalBranchRoute = RscCssConditionalBranchRouteImport.update({ + id: '/rsc-css-conditional/$branch', + path: '/rsc-css-conditional/$branch', + getParentRoute: () => rootRouteImport, +} as any) +const ApiRscFlightRoute = ApiRscFlightRouteImport.update({ + id: '/api/rsc-flight', + path: '/api/rsc-flight', + getParentRoute: () => rootRouteImport, +} as any) + +export interface FileRoutesByFullPath { + '/': typeof IndexRoute + '/rsc-async-bundle': typeof RscAsyncBundleRoute + '/rsc-basic': typeof RscBasicRoute + '/rsc-bundle': typeof RscBundleRoute + '/rsc-caching': typeof RscCachingRoute + '/rsc-client-preload': typeof RscClientPreloadRoute + '/rsc-component-slot': typeof RscComponentSlotRoute + '/rsc-context': typeof RscContextRoute + '/rsc-css-autoinject': typeof RscCssAutoinjectRoute + '/rsc-css-modules': typeof RscCssModulesRoute + '/rsc-css-preload-complex': typeof RscCssPreloadComplexRoute + '/rsc-deferred': typeof RscDeferredRoute + '/rsc-deferred-component': typeof RscDeferredComponentRoute + '/rsc-direct-loader': typeof RscDirectLoaderRoute + '/rsc-error': typeof RscErrorRoute + '/rsc-external': typeof RscExternalRoute + '/rsc-flight-api': typeof RscFlightApiRoute + '/rsc-forms': typeof RscFormsRoute + '/rsc-global-css': typeof RscGlobalCssRoute + '/rsc-hydration': typeof RscHydrationRoute + '/rsc-invalidation': typeof RscInvalidationRoute + '/rsc-large': typeof RscLargeRoute + '/rsc-link': typeof RscLinkRoute + '/rsc-multi': typeof RscMultiRoute + '/rsc-nested': typeof RscNestedRoute + '/rsc-nested-structure': typeof RscNestedStructureRoute + '/rsc-parallel': typeof RscParallelRoute + '/rsc-react-cache': typeof RscReactCacheRoute + '/rsc-request-headers': typeof RscRequestHeadersRoute + '/rsc-server-not-found': typeof RscServerNotFoundRoute + '/rsc-server-redirect': typeof RscServerRedirectRoute + '/rsc-slot-jsx-args': typeof RscSlotJsxArgsRoute + '/rsc-slots': typeof RscSlotsRoute + '/rsc-ssr-data-only': typeof RscSsrDataOnlyRoute + '/rsc-ssr-false': typeof RscSsrFalseRoute + '/rsc-stream-generator': typeof RscStreamGeneratorRoute + '/rsc-stream-loader': typeof RscStreamLoaderRoute + '/rsc-stream-readable': typeof RscStreamReadableRoute + '/rsc-streaming': typeof RscStreamingRoute + '/rsc-suspense': typeof RscSuspenseRoute + '/rsc-tree': typeof RscTreeRoute + '/rsc-use-server-fn': typeof RscUseServerFnRoute + '/api/rsc-flight': typeof ApiRscFlightRoute + '/rsc-css-conditional/$branch': typeof RscCssConditionalBranchRoute + '/rsc-param/$id': typeof RscParamIdRoute + '/rsc-css-conditional/': typeof RscCssConditionalIndexRoute + '/rsc-param/': typeof RscParamIndexRoute +} +export interface FileRoutesByTo { + '/': typeof IndexRoute + '/rsc-async-bundle': typeof RscAsyncBundleRoute + '/rsc-basic': typeof RscBasicRoute + '/rsc-bundle': typeof RscBundleRoute + '/rsc-caching': typeof RscCachingRoute + '/rsc-client-preload': typeof RscClientPreloadRoute + '/rsc-component-slot': typeof RscComponentSlotRoute + '/rsc-context': typeof RscContextRoute + '/rsc-css-autoinject': typeof RscCssAutoinjectRoute + '/rsc-css-modules': typeof RscCssModulesRoute + '/rsc-css-preload-complex': typeof RscCssPreloadComplexRoute + '/rsc-deferred': typeof RscDeferredRoute + '/rsc-deferred-component': typeof RscDeferredComponentRoute + '/rsc-direct-loader': typeof RscDirectLoaderRoute + '/rsc-error': typeof RscErrorRoute + '/rsc-external': typeof RscExternalRoute + '/rsc-flight-api': typeof RscFlightApiRoute + '/rsc-forms': typeof RscFormsRoute + '/rsc-global-css': typeof RscGlobalCssRoute + '/rsc-hydration': typeof RscHydrationRoute + '/rsc-invalidation': typeof RscInvalidationRoute + '/rsc-large': typeof RscLargeRoute + '/rsc-link': typeof RscLinkRoute + '/rsc-multi': typeof RscMultiRoute + '/rsc-nested': typeof RscNestedRoute + '/rsc-nested-structure': typeof RscNestedStructureRoute + '/rsc-parallel': typeof RscParallelRoute + '/rsc-react-cache': typeof RscReactCacheRoute + '/rsc-request-headers': typeof RscRequestHeadersRoute + '/rsc-server-not-found': typeof RscServerNotFoundRoute + '/rsc-server-redirect': typeof RscServerRedirectRoute + '/rsc-slot-jsx-args': typeof RscSlotJsxArgsRoute + '/rsc-slots': typeof RscSlotsRoute + '/rsc-ssr-data-only': typeof RscSsrDataOnlyRoute + '/rsc-ssr-false': typeof RscSsrFalseRoute + '/rsc-stream-generator': typeof RscStreamGeneratorRoute + '/rsc-stream-loader': typeof RscStreamLoaderRoute + '/rsc-stream-readable': typeof RscStreamReadableRoute + '/rsc-streaming': typeof RscStreamingRoute + '/rsc-suspense': typeof RscSuspenseRoute + '/rsc-tree': typeof RscTreeRoute + '/rsc-use-server-fn': typeof RscUseServerFnRoute + '/api/rsc-flight': typeof ApiRscFlightRoute + '/rsc-css-conditional/$branch': typeof RscCssConditionalBranchRoute + '/rsc-param/$id': typeof RscParamIdRoute + '/rsc-css-conditional': typeof RscCssConditionalIndexRoute + '/rsc-param': typeof RscParamIndexRoute +} +export interface FileRoutesById { + __root__: typeof rootRouteImport + '/': typeof IndexRoute + '/rsc-async-bundle': typeof RscAsyncBundleRoute + '/rsc-basic': typeof RscBasicRoute + '/rsc-bundle': typeof RscBundleRoute + '/rsc-caching': typeof RscCachingRoute + '/rsc-client-preload': typeof RscClientPreloadRoute + '/rsc-component-slot': typeof RscComponentSlotRoute + '/rsc-context': typeof RscContextRoute + '/rsc-css-autoinject': typeof RscCssAutoinjectRoute + '/rsc-css-modules': typeof RscCssModulesRoute + '/rsc-css-preload-complex': typeof RscCssPreloadComplexRoute + '/rsc-deferred': typeof RscDeferredRoute + '/rsc-deferred-component': typeof RscDeferredComponentRoute + '/rsc-direct-loader': typeof RscDirectLoaderRoute + '/rsc-error': typeof RscErrorRoute + '/rsc-external': typeof RscExternalRoute + '/rsc-flight-api': typeof RscFlightApiRoute + '/rsc-forms': typeof RscFormsRoute + '/rsc-global-css': typeof RscGlobalCssRoute + '/rsc-hydration': typeof RscHydrationRoute + '/rsc-invalidation': typeof RscInvalidationRoute + '/rsc-large': typeof RscLargeRoute + '/rsc-link': typeof RscLinkRoute + '/rsc-multi': typeof RscMultiRoute + '/rsc-nested': typeof RscNestedRoute + '/rsc-nested-structure': typeof RscNestedStructureRoute + '/rsc-parallel': typeof RscParallelRoute + '/rsc-react-cache': typeof RscReactCacheRoute + '/rsc-request-headers': typeof RscRequestHeadersRoute + '/rsc-server-not-found': typeof RscServerNotFoundRoute + '/rsc-server-redirect': typeof RscServerRedirectRoute + '/rsc-slot-jsx-args': typeof RscSlotJsxArgsRoute + '/rsc-slots': typeof RscSlotsRoute + '/rsc-ssr-data-only': typeof RscSsrDataOnlyRoute + '/rsc-ssr-false': typeof RscSsrFalseRoute + '/rsc-stream-generator': typeof RscStreamGeneratorRoute + '/rsc-stream-loader': typeof RscStreamLoaderRoute + '/rsc-stream-readable': typeof RscStreamReadableRoute + '/rsc-streaming': typeof RscStreamingRoute + '/rsc-suspense': typeof RscSuspenseRoute + '/rsc-tree': typeof RscTreeRoute + '/rsc-use-server-fn': typeof RscUseServerFnRoute + '/api/rsc-flight': typeof ApiRscFlightRoute + '/rsc-css-conditional/$branch': typeof RscCssConditionalBranchRoute + '/rsc-param/$id': typeof RscParamIdRoute + '/rsc-css-conditional/': typeof RscCssConditionalIndexRoute + '/rsc-param/': typeof RscParamIndexRoute +} +export interface FileRouteTypes { + fileRoutesByFullPath: FileRoutesByFullPath + fullPaths: + | '/' + | '/rsc-async-bundle' + | '/rsc-basic' + | '/rsc-bundle' + | '/rsc-caching' + | '/rsc-client-preload' + | '/rsc-component-slot' + | '/rsc-context' + | '/rsc-css-autoinject' + | '/rsc-css-modules' + | '/rsc-css-preload-complex' + | '/rsc-deferred' + | '/rsc-deferred-component' + | '/rsc-direct-loader' + | '/rsc-error' + | '/rsc-external' + | '/rsc-flight-api' + | '/rsc-forms' + | '/rsc-global-css' + | '/rsc-hydration' + | '/rsc-invalidation' + | '/rsc-large' + | '/rsc-link' + | '/rsc-multi' + | '/rsc-nested' + | '/rsc-nested-structure' + | '/rsc-parallel' + | '/rsc-react-cache' + | '/rsc-request-headers' + | '/rsc-server-not-found' + | '/rsc-server-redirect' + | '/rsc-slot-jsx-args' + | '/rsc-slots' + | '/rsc-ssr-data-only' + | '/rsc-ssr-false' + | '/rsc-stream-generator' + | '/rsc-stream-loader' + | '/rsc-stream-readable' + | '/rsc-streaming' + | '/rsc-suspense' + | '/rsc-tree' + | '/rsc-use-server-fn' + | '/api/rsc-flight' + | '/rsc-css-conditional/$branch' + | '/rsc-param/$id' + | '/rsc-css-conditional/' + | '/rsc-param/' + fileRoutesByTo: FileRoutesByTo + to: + | '/' + | '/rsc-async-bundle' + | '/rsc-basic' + | '/rsc-bundle' + | '/rsc-caching' + | '/rsc-client-preload' + | '/rsc-component-slot' + | '/rsc-context' + | '/rsc-css-autoinject' + | '/rsc-css-modules' + | '/rsc-css-preload-complex' + | '/rsc-deferred' + | '/rsc-deferred-component' + | '/rsc-direct-loader' + | '/rsc-error' + | '/rsc-external' + | '/rsc-flight-api' + | '/rsc-forms' + | '/rsc-global-css' + | '/rsc-hydration' + | '/rsc-invalidation' + | '/rsc-large' + | '/rsc-link' + | '/rsc-multi' + | '/rsc-nested' + | '/rsc-nested-structure' + | '/rsc-parallel' + | '/rsc-react-cache' + | '/rsc-request-headers' + | '/rsc-server-not-found' + | '/rsc-server-redirect' + | '/rsc-slot-jsx-args' + | '/rsc-slots' + | '/rsc-ssr-data-only' + | '/rsc-ssr-false' + | '/rsc-stream-generator' + | '/rsc-stream-loader' + | '/rsc-stream-readable' + | '/rsc-streaming' + | '/rsc-suspense' + | '/rsc-tree' + | '/rsc-use-server-fn' + | '/api/rsc-flight' + | '/rsc-css-conditional/$branch' + | '/rsc-param/$id' + | '/rsc-css-conditional' + | '/rsc-param' + id: + | '__root__' + | '/' + | '/rsc-async-bundle' + | '/rsc-basic' + | '/rsc-bundle' + | '/rsc-caching' + | '/rsc-client-preload' + | '/rsc-component-slot' + | '/rsc-context' + | '/rsc-css-autoinject' + | '/rsc-css-modules' + | '/rsc-css-preload-complex' + | '/rsc-deferred' + | '/rsc-deferred-component' + | '/rsc-direct-loader' + | '/rsc-error' + | '/rsc-external' + | '/rsc-flight-api' + | '/rsc-forms' + | '/rsc-global-css' + | '/rsc-hydration' + | '/rsc-invalidation' + | '/rsc-large' + | '/rsc-link' + | '/rsc-multi' + | '/rsc-nested' + | '/rsc-nested-structure' + | '/rsc-parallel' + | '/rsc-react-cache' + | '/rsc-request-headers' + | '/rsc-server-not-found' + | '/rsc-server-redirect' + | '/rsc-slot-jsx-args' + | '/rsc-slots' + | '/rsc-ssr-data-only' + | '/rsc-ssr-false' + | '/rsc-stream-generator' + | '/rsc-stream-loader' + | '/rsc-stream-readable' + | '/rsc-streaming' + | '/rsc-suspense' + | '/rsc-tree' + | '/rsc-use-server-fn' + | '/api/rsc-flight' + | '/rsc-css-conditional/$branch' + | '/rsc-param/$id' + | '/rsc-css-conditional/' + | '/rsc-param/' + fileRoutesById: FileRoutesById +} +export interface RootRouteChildren { + IndexRoute: typeof IndexRoute + RscAsyncBundleRoute: typeof RscAsyncBundleRoute + RscBasicRoute: typeof RscBasicRoute + RscBundleRoute: typeof RscBundleRoute + RscCachingRoute: typeof RscCachingRoute + RscClientPreloadRoute: typeof RscClientPreloadRoute + RscComponentSlotRoute: typeof RscComponentSlotRoute + RscContextRoute: typeof RscContextRoute + RscCssAutoinjectRoute: typeof RscCssAutoinjectRoute + RscCssModulesRoute: typeof RscCssModulesRoute + RscCssPreloadComplexRoute: typeof RscCssPreloadComplexRoute + RscDeferredRoute: typeof RscDeferredRoute + RscDeferredComponentRoute: typeof RscDeferredComponentRoute + RscDirectLoaderRoute: typeof RscDirectLoaderRoute + RscErrorRoute: typeof RscErrorRoute + RscExternalRoute: typeof RscExternalRoute + RscFlightApiRoute: typeof RscFlightApiRoute + RscFormsRoute: typeof RscFormsRoute + RscGlobalCssRoute: typeof RscGlobalCssRoute + RscHydrationRoute: typeof RscHydrationRoute + RscInvalidationRoute: typeof RscInvalidationRoute + RscLargeRoute: typeof RscLargeRoute + RscLinkRoute: typeof RscLinkRoute + RscMultiRoute: typeof RscMultiRoute + RscNestedRoute: typeof RscNestedRoute + RscNestedStructureRoute: typeof RscNestedStructureRoute + RscParallelRoute: typeof RscParallelRoute + RscReactCacheRoute: typeof RscReactCacheRoute + RscRequestHeadersRoute: typeof RscRequestHeadersRoute + RscServerNotFoundRoute: typeof RscServerNotFoundRoute + RscServerRedirectRoute: typeof RscServerRedirectRoute + RscSlotJsxArgsRoute: typeof RscSlotJsxArgsRoute + RscSlotsRoute: typeof RscSlotsRoute + RscSsrDataOnlyRoute: typeof RscSsrDataOnlyRoute + RscSsrFalseRoute: typeof RscSsrFalseRoute + RscStreamGeneratorRoute: typeof RscStreamGeneratorRoute + RscStreamLoaderRoute: typeof RscStreamLoaderRoute + RscStreamReadableRoute: typeof RscStreamReadableRoute + RscStreamingRoute: typeof RscStreamingRoute + RscSuspenseRoute: typeof RscSuspenseRoute + RscTreeRoute: typeof RscTreeRoute + RscUseServerFnRoute: typeof RscUseServerFnRoute + ApiRscFlightRoute: typeof ApiRscFlightRoute + RscCssConditionalBranchRoute: typeof RscCssConditionalBranchRoute + RscParamIdRoute: typeof RscParamIdRoute + RscCssConditionalIndexRoute: typeof RscCssConditionalIndexRoute + RscParamIndexRoute: typeof RscParamIndexRoute +} + +declare module '@tanstack/react-router' { + interface FileRoutesByPath { + '/rsc-use-server-fn': { + id: '/rsc-use-server-fn' + path: '/rsc-use-server-fn' + fullPath: '/rsc-use-server-fn' + preLoaderRoute: typeof RscUseServerFnRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-tree': { + id: '/rsc-tree' + path: '/rsc-tree' + fullPath: '/rsc-tree' + preLoaderRoute: typeof RscTreeRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-suspense': { + id: '/rsc-suspense' + path: '/rsc-suspense' + fullPath: '/rsc-suspense' + preLoaderRoute: typeof RscSuspenseRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-streaming': { + id: '/rsc-streaming' + path: '/rsc-streaming' + fullPath: '/rsc-streaming' + preLoaderRoute: typeof RscStreamingRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-stream-readable': { + id: '/rsc-stream-readable' + path: '/rsc-stream-readable' + fullPath: '/rsc-stream-readable' + preLoaderRoute: typeof RscStreamReadableRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-stream-loader': { + id: '/rsc-stream-loader' + path: '/rsc-stream-loader' + fullPath: '/rsc-stream-loader' + preLoaderRoute: typeof RscStreamLoaderRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-stream-generator': { + id: '/rsc-stream-generator' + path: '/rsc-stream-generator' + fullPath: '/rsc-stream-generator' + preLoaderRoute: typeof RscStreamGeneratorRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-ssr-false': { + id: '/rsc-ssr-false' + path: '/rsc-ssr-false' + fullPath: '/rsc-ssr-false' + preLoaderRoute: typeof RscSsrFalseRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-ssr-data-only': { + id: '/rsc-ssr-data-only' + path: '/rsc-ssr-data-only' + fullPath: '/rsc-ssr-data-only' + preLoaderRoute: typeof RscSsrDataOnlyRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-slots': { + id: '/rsc-slots' + path: '/rsc-slots' + fullPath: '/rsc-slots' + preLoaderRoute: typeof RscSlotsRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-slot-jsx-args': { + id: '/rsc-slot-jsx-args' + path: '/rsc-slot-jsx-args' + fullPath: '/rsc-slot-jsx-args' + preLoaderRoute: typeof RscSlotJsxArgsRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-server-redirect': { + id: '/rsc-server-redirect' + path: '/rsc-server-redirect' + fullPath: '/rsc-server-redirect' + preLoaderRoute: typeof RscServerRedirectRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-server-not-found': { + id: '/rsc-server-not-found' + path: '/rsc-server-not-found' + fullPath: '/rsc-server-not-found' + preLoaderRoute: typeof RscServerNotFoundRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-request-headers': { + id: '/rsc-request-headers' + path: '/rsc-request-headers' + fullPath: '/rsc-request-headers' + preLoaderRoute: typeof RscRequestHeadersRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-react-cache': { + id: '/rsc-react-cache' + path: '/rsc-react-cache' + fullPath: '/rsc-react-cache' + preLoaderRoute: typeof RscReactCacheRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-parallel': { + id: '/rsc-parallel' + path: '/rsc-parallel' + fullPath: '/rsc-parallel' + preLoaderRoute: typeof RscParallelRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-nested-structure': { + id: '/rsc-nested-structure' + path: '/rsc-nested-structure' + fullPath: '/rsc-nested-structure' + preLoaderRoute: typeof RscNestedStructureRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-nested': { + id: '/rsc-nested' + path: '/rsc-nested' + fullPath: '/rsc-nested' + preLoaderRoute: typeof RscNestedRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-multi': { + id: '/rsc-multi' + path: '/rsc-multi' + fullPath: '/rsc-multi' + preLoaderRoute: typeof RscMultiRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-link': { + id: '/rsc-link' + path: '/rsc-link' + fullPath: '/rsc-link' + preLoaderRoute: typeof RscLinkRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-large': { + id: '/rsc-large' + path: '/rsc-large' + fullPath: '/rsc-large' + preLoaderRoute: typeof RscLargeRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-invalidation': { + id: '/rsc-invalidation' + path: '/rsc-invalidation' + fullPath: '/rsc-invalidation' + preLoaderRoute: typeof RscInvalidationRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-hydration': { + id: '/rsc-hydration' + path: '/rsc-hydration' + fullPath: '/rsc-hydration' + preLoaderRoute: typeof RscHydrationRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-global-css': { + id: '/rsc-global-css' + path: '/rsc-global-css' + fullPath: '/rsc-global-css' + preLoaderRoute: typeof RscGlobalCssRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-forms': { + id: '/rsc-forms' + path: '/rsc-forms' + fullPath: '/rsc-forms' + preLoaderRoute: typeof RscFormsRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-flight-api': { + id: '/rsc-flight-api' + path: '/rsc-flight-api' + fullPath: '/rsc-flight-api' + preLoaderRoute: typeof RscFlightApiRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-external': { + id: '/rsc-external' + path: '/rsc-external' + fullPath: '/rsc-external' + preLoaderRoute: typeof RscExternalRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-error': { + id: '/rsc-error' + path: '/rsc-error' + fullPath: '/rsc-error' + preLoaderRoute: typeof RscErrorRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-direct-loader': { + id: '/rsc-direct-loader' + path: '/rsc-direct-loader' + fullPath: '/rsc-direct-loader' + preLoaderRoute: typeof RscDirectLoaderRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-deferred-component': { + id: '/rsc-deferred-component' + path: '/rsc-deferred-component' + fullPath: '/rsc-deferred-component' + preLoaderRoute: typeof RscDeferredComponentRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-deferred': { + id: '/rsc-deferred' + path: '/rsc-deferred' + fullPath: '/rsc-deferred' + preLoaderRoute: typeof RscDeferredRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-css-preload-complex': { + id: '/rsc-css-preload-complex' + path: '/rsc-css-preload-complex' + fullPath: '/rsc-css-preload-complex' + preLoaderRoute: typeof RscCssPreloadComplexRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-css-modules': { + id: '/rsc-css-modules' + path: '/rsc-css-modules' + fullPath: '/rsc-css-modules' + preLoaderRoute: typeof RscCssModulesRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-css-autoinject': { + id: '/rsc-css-autoinject' + path: '/rsc-css-autoinject' + fullPath: '/rsc-css-autoinject' + preLoaderRoute: typeof RscCssAutoinjectRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-context': { + id: '/rsc-context' + path: '/rsc-context' + fullPath: '/rsc-context' + preLoaderRoute: typeof RscContextRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-component-slot': { + id: '/rsc-component-slot' + path: '/rsc-component-slot' + fullPath: '/rsc-component-slot' + preLoaderRoute: typeof RscComponentSlotRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-client-preload': { + id: '/rsc-client-preload' + path: '/rsc-client-preload' + fullPath: '/rsc-client-preload' + preLoaderRoute: typeof RscClientPreloadRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-caching': { + id: '/rsc-caching' + path: '/rsc-caching' + fullPath: '/rsc-caching' + preLoaderRoute: typeof RscCachingRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-bundle': { + id: '/rsc-bundle' + path: '/rsc-bundle' + fullPath: '/rsc-bundle' + preLoaderRoute: typeof RscBundleRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-basic': { + id: '/rsc-basic' + path: '/rsc-basic' + fullPath: '/rsc-basic' + preLoaderRoute: typeof RscBasicRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-async-bundle': { + id: '/rsc-async-bundle' + path: '/rsc-async-bundle' + fullPath: '/rsc-async-bundle' + preLoaderRoute: typeof RscAsyncBundleRouteImport + parentRoute: typeof rootRouteImport + } + '/': { + id: '/' + path: '/' + fullPath: '/' + preLoaderRoute: typeof IndexRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-param/': { + id: '/rsc-param/' + path: '/rsc-param' + fullPath: '/rsc-param/' + preLoaderRoute: typeof RscParamIndexRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-css-conditional/': { + id: '/rsc-css-conditional/' + path: '/rsc-css-conditional' + fullPath: '/rsc-css-conditional/' + preLoaderRoute: typeof RscCssConditionalIndexRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-param/$id': { + id: '/rsc-param/$id' + path: '/rsc-param/$id' + fullPath: '/rsc-param/$id' + preLoaderRoute: typeof RscParamIdRouteImport + parentRoute: typeof rootRouteImport + } + '/rsc-css-conditional/$branch': { + id: '/rsc-css-conditional/$branch' + path: '/rsc-css-conditional/$branch' + fullPath: '/rsc-css-conditional/$branch' + preLoaderRoute: typeof RscCssConditionalBranchRouteImport + parentRoute: typeof rootRouteImport + } + '/api/rsc-flight': { + id: '/api/rsc-flight' + path: '/api/rsc-flight' + fullPath: '/api/rsc-flight' + preLoaderRoute: typeof ApiRscFlightRouteImport + parentRoute: typeof rootRouteImport + } + } +} + +const rootRouteChildren: RootRouteChildren = { + IndexRoute: IndexRoute, + RscAsyncBundleRoute: RscAsyncBundleRoute, + RscBasicRoute: RscBasicRoute, + RscBundleRoute: RscBundleRoute, + RscCachingRoute: RscCachingRoute, + RscClientPreloadRoute: RscClientPreloadRoute, + RscComponentSlotRoute: RscComponentSlotRoute, + RscContextRoute: RscContextRoute, + RscCssAutoinjectRoute: RscCssAutoinjectRoute, + RscCssModulesRoute: RscCssModulesRoute, + RscCssPreloadComplexRoute: RscCssPreloadComplexRoute, + RscDeferredRoute: RscDeferredRoute, + RscDeferredComponentRoute: RscDeferredComponentRoute, + RscDirectLoaderRoute: RscDirectLoaderRoute, + RscErrorRoute: RscErrorRoute, + RscExternalRoute: RscExternalRoute, + RscFlightApiRoute: RscFlightApiRoute, + RscFormsRoute: RscFormsRoute, + RscGlobalCssRoute: RscGlobalCssRoute, + RscHydrationRoute: RscHydrationRoute, + RscInvalidationRoute: RscInvalidationRoute, + RscLargeRoute: RscLargeRoute, + RscLinkRoute: RscLinkRoute, + RscMultiRoute: RscMultiRoute, + RscNestedRoute: RscNestedRoute, + RscNestedStructureRoute: RscNestedStructureRoute, + RscParallelRoute: RscParallelRoute, + RscReactCacheRoute: RscReactCacheRoute, + RscRequestHeadersRoute: RscRequestHeadersRoute, + RscServerNotFoundRoute: RscServerNotFoundRoute, + RscServerRedirectRoute: RscServerRedirectRoute, + RscSlotJsxArgsRoute: RscSlotJsxArgsRoute, + RscSlotsRoute: RscSlotsRoute, + RscSsrDataOnlyRoute: RscSsrDataOnlyRoute, + RscSsrFalseRoute: RscSsrFalseRoute, + RscStreamGeneratorRoute: RscStreamGeneratorRoute, + RscStreamLoaderRoute: RscStreamLoaderRoute, + RscStreamReadableRoute: RscStreamReadableRoute, + RscStreamingRoute: RscStreamingRoute, + RscSuspenseRoute: RscSuspenseRoute, + RscTreeRoute: RscTreeRoute, + RscUseServerFnRoute: RscUseServerFnRoute, + ApiRscFlightRoute: ApiRscFlightRoute, + RscCssConditionalBranchRoute: RscCssConditionalBranchRoute, + RscParamIdRoute: RscParamIdRoute, + RscCssConditionalIndexRoute: RscCssConditionalIndexRoute, + RscParamIndexRoute: RscParamIndexRoute, +} +export const routeTree = rootRouteImport + ._addFileChildren(rootRouteChildren) + ._addFileTypes() + +import type { getRouter } from './router.tsx' +import type { createStart } from '@tanstack/react-start' +declare module '@tanstack/react-start' { + interface Register { + ssr: true + router: Awaited> + } +} diff --git a/e2e/react-start/basic-rsc/src/router.tsx b/e2e/react-start/rsc/src/router.tsx similarity index 53% rename from e2e/react-start/basic-rsc/src/router.tsx rename to e2e/react-start/rsc/src/router.tsx index fef35c9e06..16fd65460d 100644 --- a/e2e/react-start/basic-rsc/src/router.tsx +++ b/e2e/react-start/rsc/src/router.tsx @@ -1,15 +1,11 @@ import { createRouter } from '@tanstack/react-router' import { routeTree } from './routeTree.gen' -import { DefaultCatchBoundary } from './components/DefaultCatchBoundary' -import { NotFound } from './components/NotFound' export function getRouter() { const router = createRouter({ routeTree, scrollRestoration: true, defaultPreload: 'intent', - defaultErrorComponent: DefaultCatchBoundary, - defaultNotFoundComponent: () => , }) return router diff --git a/e2e/react-start/rsc/src/routes/__root.tsx b/e2e/react-start/rsc/src/routes/__root.tsx new file mode 100644 index 0000000000..8690f7934d --- /dev/null +++ b/e2e/react-start/rsc/src/routes/__root.tsx @@ -0,0 +1,423 @@ +import { + HeadContent, + Link, + Outlet, + Scripts, + createRootRoute, + useHydrated, +} from '@tanstack/react-router' +import { TanStackRouterDevtools } from '@tanstack/react-router-devtools' +import { colors } from '~/utils/styles' + +export const Route = createRootRoute({ + head: () => ({ + meta: [ + { charSet: 'utf-8' }, + { name: 'viewport', content: 'width=device-width, initial-scale=1' }, + ], + }), + component: RootComponent, +}) + +function RootComponent() { + const hydrated = useHydrated() + + return ( + + + + + + + {/* Navigation */} + + + + + + + + ) +} diff --git a/e2e/react-start/rsc/src/routes/api.rsc-flight.tsx b/e2e/react-start/rsc/src/routes/api.rsc-flight.tsx new file mode 100644 index 0000000000..b648fdab6c --- /dev/null +++ b/e2e/react-start/rsc/src/routes/api.rsc-flight.tsx @@ -0,0 +1,35 @@ +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { renderToReadableStream } from '@tanstack/react-start/rsc' +import { serverStyles, formatTime } from '~/utils/styles' + +// Server function that returns a raw ReadableStream (not wrapped in Response) +// This runs in RSC context where renderToReadableStream is available +const getFlightStream = createServerFn({ method: 'GET' }).handler(async () => { + return renderToReadableStream( +
    +
    + API ROUTE RSC + {formatTime(Date.now())} +
    +

    + This content was rendered via API route Flight stream +

    +
    , + ) +}) + +// API route handler wraps the ReadableStream in a Response +export const Route = createFileRoute('/api/rsc-flight')({ + server: { + handlers: { + GET: async () => { + const stream = await getFlightStream() + + return new Response(stream, { + headers: { 'Content-Type': 'text/x-component' }, + }) + }, + }, + }, +}) diff --git a/e2e/react-start/rsc/src/routes/index.tsx b/e2e/react-start/rsc/src/routes/index.tsx new file mode 100644 index 0000000000..fe1cfc8571 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/index.tsx @@ -0,0 +1,327 @@ +import { createFileRoute, Link, linkOptions } from '@tanstack/react-router' +import { pageStyles, colors } from '~/utils/styles' + +export const Route = createFileRoute('/')({ + component: HomeComponent, +}) + +const examples = linkOptions([ + { + to: '/rsc-basic', + title: 'Basic RSC', + description: + 'User profile card - demonstrates a simple server component with no client interaction', + icon: '👤', + }, + { + to: '/rsc-slots', + title: 'RSC with Slots', + description: + 'Dashboard widgets - server layout with client-interactive widgets that can change without refetching the RSC', + icon: '📊', + }, + { + to: '/rsc-component-slot', + title: 'RSC Component Slots', + description: + 'Product card - pass React components as props to server components, with server-provided data flowing to client components', + icon: '🧩', + }, + { + to: '/rsc-slot-jsx-args', + title: 'RSC Slot Args (JSX)', + description: + 'Promo card - server calls a client slot with a JSX element argument that the client renders', + icon: '🏷️', + }, + { + to: '/rsc-nested-structure', + title: 'RSC Nested Structure', + description: + 'Multiple RSC components returned from a single function via nested object structure - access via dot notation', + icon: '🏗️', + }, + { + to: '/rsc-tree', + title: 'RSC Tree Restructuring', + description: + 'Comment thread - RSC can be moved around the DOM tree by client components without losing state', + icon: '🌳', + }, + { + to: '/rsc-multi', + title: 'Multiple RSCs', + description: + 'News feed - multiple independent RSCs loaded in parallel, each with their own server timestamp', + icon: '📰', + }, + { + to: '/rsc-suspense', + title: 'RSC with Suspense', + description: + 'Analytics dashboard - demonstrates async data loading with visible streaming progress', + icon: '⏳', + }, + { + to: '/rsc-link', + title: 'RSC with Link', + description: + 'Email notification - RSC containing a TanStack Router Link component for client-side navigation', + icon: '🔗', + }, + { + to: '/rsc-param', + title: 'RSC Path Params', + description: + 'Dynamic /rsc-param/$id route - client navigation should not remount client components or lose state', + icon: '🏷️', + }, + { + to: '/rsc-nested', + title: 'Nested RSCs', + description: + 'E-commerce product page - RSCs nested inside each other via client composition with interactive render props', + icon: '🪆', + }, + { + to: '/rsc-invalidation', + title: 'RSC Invalidation', + description: + 'Product search - demonstrates RSC refetching when search params change with pagination', + icon: '🔄', + }, + { + to: '/rsc-error', + title: 'RSC Error Handling', + description: + 'Error boundary testing - demonstrates error handling when RSC throws an error', + icon: '⚠️', + }, + { + to: '/rsc-forms', + title: 'RSC with Forms', + description: + 'Todo list - demonstrates server state mutations with form submissions and optimistic updates', + icon: '📝', + }, + { + to: '/rsc-caching', + title: 'RSC Caching', + description: + 'Data dashboard - demonstrates staleTime behavior and cache invalidation patterns', + icon: '💾', + }, + { + to: '/rsc-external', + title: 'RSC External API', + description: + 'Weather widget - demonstrates RSC fetching data from external APIs on the server', + icon: '🌐', + }, + { + to: '/rsc-context', + title: 'RSC with Context', + description: + 'User preferences - demonstrates interaction between RSC data and React Context', + icon: '🎨', + }, + { + to: '/rsc-large', + title: 'RSC Large Payload', + description: + 'Product catalog - demonstrates performance with large RSC payloads (100+ items)', + icon: '📦', + }, + { + to: '/rsc-hydration', + title: 'RSC Hydration', + description: + 'Timestamp display - tests for hydration mismatch detection and handling', + icon: '💧', + }, + { + to: '/rsc-bundle', + title: 'RSC Bundle', + description: + 'Page layout - multiple RSCs (Header, Content, Footer) returned from a single server function', + icon: '📦', + }, + { + to: '/rsc-deferred', + title: 'RSC Deferred Data', + description: + 'Analytics report - RSC renders immediately, data streams via deferred Promise rendered client-side', + icon: '⏱️', + }, + { + to: '/rsc-streaming', + title: 'RSC Streaming', + description: + 'Notification feed - stream individual RSCs from server to client using ReadableStream or async generators', + icon: '📡', + }, + { + to: '/rsc-ssr-data-only', + title: 'RSC SSR Data-Only', + description: + 'Analytics dashboard - loader runs on server for data, component renders on client for browser-only visualization APIs', + icon: '📊', + }, + { + to: '/rsc-ssr-false', + title: 'RSC SSR False', + description: + 'Drawing canvas - both loader and component run on client, using localStorage for persistence and Canvas API for drawing', + icon: '🎨', + }, + { + to: '/rsc-flight-api', + title: 'RSC Flight API', + description: + 'Low-level Flight stream APIs - renderToReadableStream, createFromFetch, createFromReadableStream for advanced use cases', + icon: '🛫', + }, + { + to: '/rsc-css-modules', + title: 'RSC CSS Modules', + description: + 'CSS Modules in server components - demonstrates scoped styles using .module.css files within RSC', + icon: '🎨', + }, + { + to: '/rsc-css-conditional', + title: 'RSC CSS Conditional', + description: + 'Conditional server subtrees with branch-specific CSS modules for orange and violet variants', + icon: '🟠', + }, + { + to: '/rsc-global-css', + title: 'RSC Global CSS', + description: + 'Global CSS in server components - demonstrates plain CSS imports (import "styles.css") within RSC', + icon: '🖌️', + }, + { + to: '/rsc-request-headers', + title: 'RSC Request Headers', + description: + 'Loader calls a server function that reads the incoming Cookie header in the RSC environment', + icon: '🍪', + }, + { + to: '/rsc-server-not-found', + title: 'RSC Server Not Found', + description: + 'A server function throws notFound() and the route-level notFoundComponent handles it for both SSR and client navigation', + icon: '🚧', + }, + { + to: '/rsc-server-redirect', + title: 'RSC Server Redirect', + description: + 'A server function throws redirect() and navigation lands on the redirected route for both SSR and client navigation', + icon: '↪', + }, + { + to: '/rsc-react-cache', + title: 'RSC React.cache', + description: + 'React.cache for memoization - demonstrates deduplicating expensive computations within a single render pass', + icon: '🧠', + }, + { + to: '/rsc-client-preload', + title: 'RSC Client Preload', + description: + 'Client component CSS preloading - tests that CSS modules in client components inside RSC are properly preloaded', + icon: '🎯', + }, + { + to: '/rsc-css-preload-complex', + title: 'RSC CSS Preload Complex', + description: + 'Complex CSS preload scenarios - direct render, children slot, and unrendered RSC with different CSS modules', + icon: '🧪', + }, +]) + +function HomeComponent() { + return ( +
    +

    + React Server Components E2E Tests +

    +

    + These examples demonstrate RSC capabilities with clear visual + distinction between server-rendered (blue) and client-interactive + (green) content. +

    + + {/* Color Legend */} +
    +
    + + + Server Rendered (RSC) - Fetched once, cached + +
    +
    + + + Client Interactive - React state, event handlers + +
    +
    + + + Async Loading - Streaming content + +
    +
    + + {/* Examples Grid */} +
    + {examples.map((example) => ( + +
    + {example.icon} +
    +
    + {example.title} +
    +
    + {example.description} +
    + + ))} +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-async-bundle.tsx b/e2e/react-start/rsc/src/routes/rsc-async-bundle.tsx new file mode 100644 index 0000000000..1153babb28 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-async-bundle.tsx @@ -0,0 +1,462 @@ +import * as React from 'react' +import { createFileRoute, useHydrated } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { + renderServerComponent, + createCompositeComponent, + CompositeComponent, + AnyCompositeComponent, +} from '@tanstack/react-start/rsc' +import { + serverBox, + serverBadge, + serverHeader, + timestamp, +} from '~/utils/serverStyles' +import { + pageStyles, + clientStyles, + asyncStyles, + formatTime, +} from '~/utils/styles' + +// ============================================================================ +// Server Component Definition +// ============================================================================ + +// Helper to add artificial delay for demonstrating streaming +async function simulateDelay(ms: number): Promise { + return new Promise((resolve) => setTimeout(resolve, ms)) +} + +const getAsyncRscBundle = createServerFn({ method: 'GET' }) + .inputValidator((data: { scenario: string }) => data) + .handler(async ({ data }) => { + const serverTimestamp = Date.now() + const bundleId = Math.random().toString(36).slice(2, 8) + + // Return Promises directly - NOT awaited + // Each RSC will load independently and stream to the client + return { + bundleId, + timestamp: serverTimestamp, + // Fast RSC - loads in 100ms (no slots, use renderServerComponent) + FastComponent: (async () => { + await simulateDelay(100) + return renderServerComponent( +
    +
    + FAST RSC (100ms) + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    +
    +
    + ⚡ +
    +

    + Fast Loading Component +

    +

    + This RSC loaded quickly (100ms delay). +

    +
    + Bundle: {bundleId} | Scenario: {data.scenario} +
    +
    +
    , + ) + })(), + // Medium RSC - loads in 500ms (has children slot, use createCompositeComponent) + MediumComponent: (async () => { + await simulateDelay(500) + return createCompositeComponent( + (props: { children?: React.ReactNode }) => { + return ( +
    +
    + MEDIUM RSC (500ms) + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    +
    +
    + ⏳ +
    +

    + Medium Loading Component +

    +

    + This RSC took a bit longer (500ms delay). +

    + {props.children && ( +
    + {props.children} +
    + )} +
    +
    + ) + }, + ) + })(), + // Slow RSC - loads in 1500ms (has renderStatus slot, use createCompositeComponent) + SlowComponent: (async () => { + await simulateDelay(1500) + return createCompositeComponent( + (props: { renderStatus?: () => React.ReactNode }) => { + return ( +
    +
    + SLOW RSC (1500ms) + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    +
    +
    + 🐢 +
    +

    + Slow Loading Component +

    +

    + This RSC took the longest (1500ms delay). +

    + {props.renderStatus && ( +
    + {props.renderStatus()} +
    + )} +
    +
    + ) + }, + ) + })(), + } + }) + +export const Route = createFileRoute('/rsc-async-bundle')({ + loader: async () => { + // Server function returns Promises for each RSC - NOT awaited + // This allows streaming/progressive loading on the client + const bundle = await getAsyncRscBundle({ + data: { scenario: 'Progressive Loading Demo' }, + }) + return { + ...bundle, + loaderTimestamp: Date.now(), + } + }, + component: RscAsyncBundleComponent, +}) + +// Loading fallback component +function LoadingFallback({ name, delay }: { name: string; delay: string }) { + return ( +
    +
    + LOADING {name.toUpperCase()} +
    +
    +

    + Waiting for {name} component... ({delay} delay) +

    + +
    + ) +} + +// Wrapper component that uses React.use() to resolve the Promise for renderServerComponent results +function AsyncRscWrapper({ + promise, + testId, +}: { + promise: Promise + testId: string +}) { + const resolved = React.use(promise) + return
    {resolved}
    +} + +// Wrapper component for CompositeComponent that uses React.use() to resolve the Promise +function AsyncCompositeWrapper({ + promise, + props, + testId, +}: { + promise: Promise + props: TComp['~types']['props'] + testId: string +}) { + const CompositeComponentValue = React.use(promise) + return ( +
    + +
    + ) +} + +function RscAsyncBundleComponent() { + const { + FastComponent, + MediumComponent, + SlowComponent, + bundleId, + timestamp, + loaderTimestamp, + } = Route.useLoaderData() + + const [interactionCount, setInteractionCount] = React.useState(0) + const hydrated = useHydrated() + + return ( +
    +

    + Async RSC Bundle - Progressive Loading with React.use() +

    +

    + This example demonstrates returning multiple RSC Promises from a single + server function without awaiting them. Each RSC loads + independently and streams to the client. The client uses{' '} + React.use() inside Suspense boundaries to + progressively render each component as it becomes available. +

    + +
    + + {loaderTimestamp} + + + {bundleId} + + + {timestamp} + + Bundle ID: {bundleId} | Server timestamp: {formatTime(timestamp)} +
    + + {/* Three RSCs with different loading times, each in its own Suspense */} +
    + {/* Fast RSC - 100ms (no slots, renders directly) */} + } + > + + + + {/* Medium RSC - 500ms with children slot */} + } + > + + CLIENT SLOT + +
    + ), + }} + testId="async-medium-wrapper" + /> + + + {/* Slow RSC - 1500ms with render prop */} + } + > + ( +
    + + Status: Loaded! + + + Interactions: {interactionCount} + +
    + ), + }} + testId="async-slow-wrapper" + /> +
    +
    + + {/* Interaction counter */} +
    + + Total Interactions: + + + {interactionCount} + + +
    + +
    + Key Points: +
      +
    • + The server function returns RSC Promises directly - they are{' '} + not awaited on the server +
    • +
    • + Each RSC is wrapped in its own Suspense boundary with a + loading fallback +
    • +
    • + The client uses React.use() to consume each Promise and + render when ready +
    • +
    • + RSCs load progressively: Fast (100ms) → Medium (500ms) → Slow + (1500ms) +
    • +
    • + Client slots and render props work normally once each RSC resolves +
    • +
    • + This pattern is ideal when you have independent data sources with + varying latencies +
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-basic.tsx b/e2e/react-start/rsc/src/routes/rsc-basic.tsx new file mode 100644 index 0000000000..9cf841c749 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-basic.tsx @@ -0,0 +1,65 @@ +import { createFileRoute } from '@tanstack/react-router' +import { getBasicServerComponent } from '~/utils/basicServerComponent' +import { formatTime, pageStyles } from '~/utils/styles' + +export const Route = createFileRoute('/rsc-basic')({ + loader: async () => { + const Server = await getBasicServerComponent({ + data: { label: 'test label' }, + }) + return { + Server, + loaderTimestamp: Date.now(), + } + }, + component: RscBasicComponent, + pendingComponent: () => { + console.log('[PENDING] /rsc-basic') + return <>Loading... + }, +}) + +function RscBasicComponent() { + const { Server, loaderTimestamp } = Route.useLoaderData() + + return ( +
    +

    + User Profile Card +

    +

    + This example shows a simple RSC with no client interaction. The user + profile is fetched and rendered entirely on the server. Notice the + server timestamp - it won't change unless you refresh the page. +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + + {Server} + +
    + Key Points: +
      +
    • All content is server-rendered (blue box)
    • +
    • No client JavaScript needed for this component
    • +
    • Data is fetched once in the loader and cached
    • +
    • Navigate away and back - the timestamp stays the same
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-bundle.tsx b/e2e/react-start/rsc/src/routes/rsc-bundle.tsx new file mode 100644 index 0000000000..f9ad332749 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-bundle.tsx @@ -0,0 +1,404 @@ +import * as React from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { + renderServerComponent, + createCompositeComponent, + CompositeComponent, +} from '@tanstack/react-start/rsc' +import { + serverBox, + serverBadge, + serverHeader, + timestamp, +} from '~/utils/serverStyles' +import { pageStyles, clientStyles, formatTime } from '~/utils/styles' + +// ============================================================================ +// Server Component Definition +// ============================================================================ + +const getPageLayoutBundle = createServerFn({ method: 'GET' }) + .inputValidator((data: { pageTitle: string }) => data) + .handler(async ({ data }) => { + const serverTimestamp = Date.now() + const bundleId = Math.random().toString(36).slice(2, 8) + + // Simulate fetching different parts of a page layout + const headerData = { + logo: 'TechCorp', + navItems: ['Products', 'Solutions', 'Pricing', 'About'], + user: { name: 'John Doe', avatar: 'JD' }, + } + + const contentData = { + title: data.pageTitle, + subtitle: 'Welcome to your dashboard', + stats: [ + { label: 'Total Users', value: 12847 }, + { label: 'Active Sessions', value: 342 }, + { label: 'Revenue', value: 45231 }, + ], + } + + const footerData = { + copyright: '2024 TechCorp Inc.', + links: ['Privacy', 'Terms', 'Contact'], + version: 'v2.4.1', + } + + // Create multiple RSCs in parallel + // Header and Content use createCompositeComponent (they have slots) + // Footer uses renderServerComponent (no slots) + const [Header, Content, Footer] = await Promise.all([ + createCompositeComponent((props: { children?: React.ReactNode }) => { + return ( +
    +
    +
    + {headerData.logo} +
    + +
    +
    + HEADER RSC +
    + {headerData.user.avatar} +
    + {props.children} +
    +
    + ) + }), + createCompositeComponent( + (props: { renderActions?: () => React.ReactNode }) => { + return ( +
    +
    + CONTENT RSC + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    + +

    + {contentData.title} +

    +

    + {contentData.subtitle} +

    + +
    + {contentData.stats.map((stat) => ( +
    +
    + {stat.value.toLocaleString()} +
    +
    + {stat.label} +
    +
    + ))} +
    + + {props.renderActions && ( +
    + {props.renderActions()} +
    + )} +
    + ) + }, + ), + renderServerComponent( +
    +
    + FOOTER RSC + + {footerData.copyright} + +
    +
    + {footerData.links.map((link) => ( + + {link} + + ))} +
    + + {footerData.version} + +
    , + ), + ]) + + // Return multiple RSCs in a single object + return { + bundleId, + timestamp: serverTimestamp, + Header, + Content, + Footer, + } + }) + +export const Route = createFileRoute('/rsc-bundle')({ + loader: async () => { + // Single server function returns multiple RSCs in an object + const bundle = await getPageLayoutBundle({ + data: { pageTitle: 'Dashboard Overview' }, + }) + return { + ...bundle, + loaderTimestamp: Date.now(), + } + }, + component: RscBundleComponent, +}) + +function RscBundleComponent() { + const { Header, Content, Footer, bundleId, timestamp, loaderTimestamp } = + Route.useLoaderData() + const [actionCount, setActionCount] = React.useState(0) + + return ( +
    +

    + Page Layout Bundle - Multiple RSCs from Single Server Function +

    +

    + This example demonstrates returning multiple RSCs from a single server + function call. The Header, Content, and Footer are all returned as an + object, allowing for efficient bundled loading while maintaining + independent render behavior. +

    + +
    + + {loaderTimestamp} + + + {bundleId} + + + {timestamp} + + Bundle ID: {bundleId} | Loaded at: {formatTime(loaderTimestamp)} +
    + + {/* All three RSCs from the same bundle */} +
    + {/* Header RSC with client slot for user menu */} + + + + + {/* Content RSC with render prop for actions */} + ( +
    +
    + CLIENT ACTIONS +
    +
    + + + Actions performed: {actionCount} + +
    +
    + )} + /> + + {/* Footer RSC - no slots, use directly */} + {Footer} +
    + +
    + Key Points: +
      +
    • + All three RSCs (Header, Content, Footer) are returned from a single + server function call +
    • +
    • + Each RSC renders independently with the same server timestamp + (fetched together) +
    • +
    • + The bundle includes metadata (bundleId, timestamp) alongside the + RSCs +
    • +
    • + Client components can be slotted into any of the bundled RSCs via + children or render props +
    • +
    • + This pattern is efficient for page layouts where multiple sections + are needed together +
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-caching.tsx b/e2e/react-start/rsc/src/routes/rsc-caching.tsx new file mode 100644 index 0000000000..576ea8d61f --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-caching.tsx @@ -0,0 +1,260 @@ +import * as React from 'react' +import { createFileRoute, useRouter } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { renderServerComponent } from '@tanstack/react-start/rsc' +import { + serverBox, + serverBadge, + serverHeader, + timestamp, +} from '~/utils/serverStyles' +import { pageStyles, clientStyles, formatTime } from '~/utils/styles' + +// ============================================================================ +// Server Component Definition +// ============================================================================ + +const getCachedDataServerComponent = createServerFn({ method: 'GET' }) + .inputValidator((data: { dataType: string }) => data) + .handler(async ({ data }) => { + const serverTimestamp = Date.now() + const fetchId = Math.random().toString(36).slice(2, 8) + + // Simulate different data based on type + const dataMap: Record = { + users: { + label: 'Active Users', + value: Math.floor(Math.random() * 10000), + }, + orders: { label: 'Orders Today', value: Math.floor(Math.random() * 500) }, + revenue: { + label: 'Revenue', + value: Math.floor(Math.random() * 100000), + }, + } + + const result = dataMap[data.dataType] || { + label: 'Unknown', + value: 0, + } + + return renderServerComponent( +
    +
    + CACHED DATA + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    + +
    +
    + {result.label} +
    +
    + {result.value.toLocaleString()} +
    +
    + Fetch ID: {fetchId} +
    +
    + +
    + Data type: {data.dataType} +
    +
    , + ) + }) + +export const Route = createFileRoute('/rsc-caching')({ + staleTime: 10000, // 10 second stale time for testing + loader: async () => { + const CachedData = await getCachedDataServerComponent({ + data: { dataType: 'users' }, + }) + return { + CachedData, + loaderTimestamp: Date.now(), + } + }, + component: RscCachingComponent, +}) + +function RscCachingComponent() { + const { CachedData, loaderTimestamp } = Route.useLoaderData() + const router = useRouter() + const [manualInvalidateCount, setManualInvalidateCount] = React.useState(0) + + const handleInvalidate = () => { + setManualInvalidateCount((c) => c + 1) + router.invalidate() + } + + return ( +
    +

    + Analytics Widget - RSC Caching +

    +

    + This example tests RSC caching behavior. The route has a 10 second + staleTime. Navigate away and back quickly - you'll see cached data. Wait + 10+ seconds or click "Force Refresh" to refetch. The Fetch ID changes + only when actually refetched. +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + + {/* Cache Controls */} +
    +
    + CACHE CONTROLS + + staleTime: 10s + +
    + +
    + + + Manual invalidations: {manualInvalidateCount} + +
    + +
    + Testing Instructions: +
      +
    1. Note the current Fetch ID below
    2. +
    3. Navigate to another page and back within 10s
    4. +
    5. Fetch ID should be the same (cached!)
    6. +
    7. Wait 10s and navigate back, or click "Force Refresh"
    8. +
    9. Fetch ID should change (refetched!)
    10. +
    +
    +
    + + {/* Cached Data RSC */} + {CachedData} + + {/* Cache Status Info */} +
    +
    + ⏱️ + Cache Status +
    +
    +
    + Data fetched at: {formatTime(loaderTimestamp)} +
    +
    + Will become stale at:{' '} + {formatTime(loaderTimestamp + 10000)} +
    +
    +
    + +
    + Key Points: +
      +
    • staleTime: 10000 prevents refetch for 10 seconds
    • +
    • Navigation within staleTime uses cached RSC
    • +
    • router.invalidate() forces immediate refetch
    • +
    • After staleTime, next navigation triggers refetch
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-client-preload.tsx b/e2e/react-start/rsc/src/routes/rsc-client-preload.tsx new file mode 100644 index 0000000000..115428cce0 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-client-preload.tsx @@ -0,0 +1,76 @@ +import { createFileRoute } from '@tanstack/react-router' +import { formatTime, pageStyles } from '~/utils/styles' +import { getClientPreloadServerComponent } from '~/utils/clientPreloadServerComponent' + +// ============================================================================ +// CLIENT PRELOAD TEST: Server component with "use client" component +// Tests that client component JS and CSS are preloaded in +// ============================================================================ + +export const Route = createFileRoute('/rsc-client-preload')({ + loader: async () => { + const Server = await getClientPreloadServerComponent({ + data: { title: 'Client Component Preload Test' }, + }) + return { + Server, + loaderTimestamp: Date.now(), + } + }, + component: RscClientPreloadComponent, + pendingComponent: () => { + console.log('[PENDING] /rsc-client-preload') + return <>Loading... + }, +}) + +function RscClientPreloadComponent() { + const { Server, loaderTimestamp } = Route.useLoaderData() + + return ( +
    +

    + Client Component Preload Test +

    +

    + This page tests that when a server component contains a client component + with CSS modules, both the JS and CSS are preloaded in the document head + to prevent flash of unstyled content. +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + + {Server} + +
    + Expected Behavior: +
      +
    • + Client component JS should have{' '} + <link rel="modulepreload"> in head +
    • +
    • + Client component CSS should have{' '} + <link rel="preload" as="style"> in head +
    • +
    • No flash of unstyled content on initial load
    • +
    • Counter should be interactive after hydration
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-component-slot.tsx b/e2e/react-start/rsc/src/routes/rsc-component-slot.tsx new file mode 100644 index 0000000000..9e79b2dfad --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-component-slot.tsx @@ -0,0 +1,396 @@ +import * as React from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { + createCompositeComponent, + CompositeComponent, +} from '@tanstack/react-start/rsc' +import { clientStyles, formatTime, pageStyles } from '~/utils/styles' +import { + serverBadge, + serverBox, + serverHeader, + timestamp, +} from '~/utils/serverStyles' + +// ============================================================================ +// COMPONENT SLOT: Passing React Components directly as props +// ============================================================================ + +const getProductCardServer = createServerFn({ method: 'GET' }) + .inputValidator((data: { productId: string }) => data) + .handler(async ({ data }) => { + const serverTimestamp = Date.now() + + // Simulate fetching product data from server + const product = { + id: data.productId, + name: 'Premium Wireless Headphones', + price: 299.99, + rating: 4.8, + reviewCount: 1247, + } + + return createCompositeComponent( + (props: { + // Component passed as a prop (not render prop, not children) + ActionButton?: React.ComponentType<{ productId: string; price: number }> + BadgeComponent?: React.ComponentType<{ rating: number }> + }) => { + const { ActionButton, BadgeComponent } = props + + return ( +
    +
    + SERVER PRODUCT CARD + + Fetched: {new Date(serverTimestamp).toLocaleTimeString()} + +
    + +
    + {/* Product image placeholder */} +
    + [Product Image] +
    + + {/* Product details */} +
    +
    +

    + {product.name} +

    + {/* Badge component slot */} + {BadgeComponent && ( +
    + +
    + )} +
    + +
    + ${product.price} +
    + +
    + ⭐ {product.rating} ({product.reviewCount.toLocaleString()}{' '} + reviews) +
    + + {/* Action button component slot */} +
    + {ActionButton && ( + + )} +
    +
    +
    +
    + ) + }, + ) + }) + +// Client components to be passed as props +function AddToCartButton({ + productId, + price, + quantity, + onQuantityChange, +}: { + productId: string + price: number + quantity: number + onQuantityChange: (q: number) => void +}) { + const [isAdding, setIsAdding] = React.useState(false) + const [added, setAdded] = React.useState(false) + + const handleClick = () => { + setIsAdding(true) + setTimeout(() => { + setIsAdding(false) + setAdded(true) + setTimeout(() => setAdded(false), 2000) + }, 500) + } + + return ( +
    +
    + CLIENT COMPONENT +
    +
    + + + {quantity} + + +
    + + + ID: {productId} + +
    + ) +} + +function RatingBadge({ + rating, + showDetails, +}: { + rating: number + showDetails: boolean +}) { + return ( +
    + ⭐ {rating} + {showDetails && ( + + {' '} + (Excellent) + + )} +
    + ) +} + +export const Route = createFileRoute('/rsc-component-slot')({ + loader: async () => { + const ProductCard = await getProductCardServer({ + data: { productId: 'PRD-12345' }, + }) + return { + ProductCard, + loaderTimestamp: Date.now(), + } + }, + component: RscComponentSlotPage, +}) + +function RscComponentSlotPage() { + const { ProductCard, loaderTimestamp } = Route.useLoaderData() + const [quantity, setQuantity] = React.useState(1) + const [showBadgeDetails, setShowBadgeDetails] = React.useState(false) + + // Create wrapper components that close over client state + const ActionButtonWithState = React.useCallback( + ({ productId, price }: { productId: string; price: number }) => ( + + ), + [quantity], + ) + + const BadgeWithState = React.useCallback( + ({ rating }: { rating: number }) => ( + + ), + [showBadgeDetails], + ) + + return ( +
    +

    + Product Card with Component Slots +

    +

    + The product card layout and data are server-rendered (blue), while + interactive components are passed as props (green). Changing client + state does NOT refetch the server component - watch the timestamp! +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + + {/* Client Controls */} +
    +
    + CLIENT CONTROLS +
    +

    + These controls modify the component props. The server layout won't + reload! +

    +
    + + +
    +
    + + {/* Server component with component slots */} + + +
    + Key Points: +
      +
    • Components are passed as props (not children or render props)
    • +
    • Server component provides data to client components via props
    • +
    • Client components can have their own state (quantity, etc.)
    • +
    • + State changes in client components don't trigger server refetch +
    • +
    • Server timestamp remains constant while interactions occur
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-context.tsx b/e2e/react-start/rsc/src/routes/rsc-context.tsx new file mode 100644 index 0000000000..1ccb86ca83 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-context.tsx @@ -0,0 +1,331 @@ +import * as React from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { renderServerComponent } from '@tanstack/react-start/rsc' +import { + serverBox, + serverBadge, + serverHeader, + timestamp, +} from '~/utils/serverStyles' +import { pageStyles, clientStyles, formatTime } from '~/utils/styles' + +// ============================================================================ +// Server Component Definition +// ============================================================================ + +const getContextAwareServerComponent = createServerFn({ + method: 'GET', +}) + .inputValidator((data: { userId: string }) => data) + .handler(async ({ data }) => { + const serverTimestamp = Date.now() + + // Simulate fetching user preferences from server + const userPrefs = { + theme: 'light', + language: 'en', + notifications: true, + } + + return renderServerComponent( +
    +
    + SERVER COMPONENT + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    + +

    + Server-Fetched User Data +

    + +
    +
    + USER PREFERENCES FROM SERVER +
    +
    +
    + User ID:{' '} + {data.userId} +
    +
    + Saved Theme:{' '} + {userPrefs.theme} +
    +
    + Language:{' '} + + {userPrefs.language} + +
    +
    + Notifications:{' '} + + {userPrefs.notifications ? 'ON' : 'OFF'} + +
    +
    +
    + +
    + This data was fetched from the server. The client context (below) + shows local client-side state. +
    +
    , + ) + }) + +// Client-side theme context +const ThemeContext = React.createContext<{ + theme: 'light' | 'dark' + setTheme: (theme: 'light' | 'dark') => void +}>({ + theme: 'light', + setTheme: () => {}, +}) + +export const Route = createFileRoute('/rsc-context')({ + loader: async () => { + const ContextAware = await getContextAwareServerComponent({ + data: { userId: 'user_12345' }, + }) + return { + ContextAware, + loaderTimestamp: Date.now(), + } + }, + component: RscContextComponent, +}) + +function RscContextComponent() { + const { ContextAware, loaderTimestamp } = Route.useLoaderData() + const [theme, setTheme] = React.useState<'light' | 'dark'>('light') + const [notifications, setNotifications] = React.useState(true) + + return ( + +
    +

    + User Preferences - RSC with Context +

    +

    + This example tests RSC interaction with React Context. The RSC fetches + user preferences from the server, then displays them alongside client + components that can consume and modify context. +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + + {/* Theme Controls */} +
    +
    + CLIENT CONTEXT + + Theme: {theme} + +
    + +

    + These controls modify React Context. The RSC below renders server + data, while the context consumer below shows client state. +

    + +
    + + +
    +
    + + {/* Server Component - displays server data */} + {ContextAware} + + {/* Client Component - consumes context */} + + +
    + Key Points: +
      +
    • RSC fetches data from server (user preferences)
    • +
    • Client components can consume React Context
    • +
    • Theme changes via context don't refetch RSC
    • +
    • Server and client data are displayed separately
    • +
    +
    +
    +
    + ) +} + +// Client component that consumes context +function ContextConsumer({ notifications }: { notifications: boolean }) { + const { theme } = React.useContext(ThemeContext) + + return ( +
    +
    + + CLIENT COMPONENT + + + Consuming Context + +
    + +
    +
    + From Client Context +
    +
    +
    + Current Theme: {theme} +
    +
    + Local Notifications:{' '} + + {notifications ? 'ON' : 'OFF'} + +
    +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-css-autoinject.module.css b/e2e/react-start/rsc/src/routes/rsc-css-autoinject.module.css new file mode 100644 index 0000000000..708310caac --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-css-autoinject.module.css @@ -0,0 +1,43 @@ +.card { + padding: 16px; + border: 3px solid #0f766e; + border-radius: 14px; + background: #ccfbf1; + color: #134e4a; + box-shadow: 0 8px 20px rgb(15 118 110 / 0.18); +} + +.renderable { + border-color: #2563eb; +} + +.composite { + border-color: #9333ea; +} + +.flight { + border-color: #ea580c; +} + +.badge { + display: inline-block; + margin-bottom: 8px; + padding: 3px 8px; + border-radius: 999px; + background: #0f766e; + color: white; + font-size: 12px; + font-weight: 700; + letter-spacing: 0.08em; + text-transform: uppercase; +} + +.title { + margin: 0 0 4px; + font-size: 18px; +} + +.description { + margin: 0; + font-size: 14px; +} diff --git a/e2e/react-start/rsc/src/routes/rsc-css-autoinject.tsx b/e2e/react-start/rsc/src/routes/rsc-css-autoinject.tsx new file mode 100644 index 0000000000..3a155f5867 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-css-autoinject.tsx @@ -0,0 +1,144 @@ +import * as React from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { + CompositeComponent, + createCompositeComponent, + createFromFetch, + renderServerComponent, + renderToReadableStream, +} from '@tanstack/react-start/rsc' +import styles from './rsc-css-autoinject.module.css' +import { pageStyles } from '~/utils/styles' + +type CardKind = 'renderable' | 'composite' | 'flight' + +function SameFileCssModuleCard({ + kind, + label, +}: { + kind: CardKind + label: string +}) { + return ( +
    + auto injected css +

    {label}

    +

    + This server component is defined in the same route file as the RSC + render call and uses a CSS module from that route file. +

    +
    + ) +} + +const getRenderableCssModule = createServerFn({ method: 'GET' }).handler( + async () => { + return renderServerComponent( + , + ) + }, +) + +const getCompositeCssModule = createServerFn({ method: 'GET' }).handler( + async () => { + return createCompositeComponent(() => ({ + Card: ( + + ), + })) + }, +) + +const getFlightCssModuleResponse = createServerFn({ method: 'GET' }).handler( + async () => { + const stream = renderToReadableStream( + , + ) + + return new Response(stream, { + headers: { + 'Content-Type': 'text/x-component', + }, + }) + }, +) + +export const Route = createFileRoute('/rsc-css-autoinject')({ + loader: async () => { + const [renderable, composite] = await Promise.all([ + getRenderableCssModule(), + getCompositeCssModule(), + ]) + + return { renderable, composite } + }, + component: RscCssAutoinjectComponent, +}) + +function RscCssAutoinjectComponent() { + const { renderable, composite } = Route.useLoaderData() + + return ( +
    +

    RSC CSS Auto Injection

    +

    + This route verifies Start injects RSC CSS resources for same-file CSS + module server components across all Start RSC render APIs. +

    + +
    + {renderable} + + +
    +
    + ) +} + +function FlightCssModuleCard() { + const [node, setNode] = React.useState(null) + const [error, setError] = React.useState(null) + + React.useEffect(() => { + let cancelled = false + + async function loadFlightCard() { + try { + const response = await getFlightCssModuleResponse() + const result = await createFromFetch(Promise.resolve(response)) + if (!cancelled) { + setNode(result) + } + } catch (e) { + if (!cancelled) { + setError(e instanceof Error ? e.message : String(e)) + } + } + } + + loadFlightCard() + + return () => { + cancelled = true + } + }, []) + + if (error) { + return
    {error}
    + } + + return <>{node} +} diff --git a/e2e/react-start/rsc/src/routes/rsc-css-conditional.$branch.tsx b/e2e/react-start/rsc/src/routes/rsc-css-conditional.$branch.tsx new file mode 100644 index 0000000000..72a3e6d703 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-css-conditional.$branch.tsx @@ -0,0 +1,58 @@ +import { ClientOnly, createFileRoute, Link } from '@tanstack/react-router' +import { getConditionalCssServerComponent } from '~/utils/conditionalCssServerComponent' +import { pageStyles } from '~/utils/styles' + +export const Route = createFileRoute('/rsc-css-conditional/$branch')({ + loader: async ({ params: { branch } }) => { + const activeBranch = branch === 'violet' ? 'violet' : 'orange' + const Server = await getConditionalCssServerComponent({ + data: { branch: activeBranch }, + }) + + return { + Server, + branch: activeBranch, + } + }, + component: RscCssConditionalRoute, +}) + +function RscCssConditionalRoute() { + const { Server, branch } = Route.useLoaderData() + + return ( +
    +

    + Conditional RSC CSS +

    +

    + Active branch: {branch} +

    + +
    + + Back to variants + + + Switch variant + +
    + + +
    hydrated
    +
    + + {Server} +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-css-conditional.index.tsx b/e2e/react-start/rsc/src/routes/rsc-css-conditional.index.tsx new file mode 100644 index 0000000000..b633d7040a --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-css-conditional.index.tsx @@ -0,0 +1,40 @@ +import { Link, createFileRoute } from '@tanstack/react-router' +import { pageStyles } from '~/utils/styles' + +export const Route = createFileRoute('/rsc-css-conditional/')({ + component: RscCssConditionalIndexRoute, +}) + +function RscCssConditionalIndexRoute() { + return ( +
    +

    + Conditional RSC CSS +

    +

    + Choose a route variant to verify that each branch renders its own CSS + module without leaking styles. +

    + +
    + + Orange Variant + + + Violet Variant + +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-css-modules.tsx b/e2e/react-start/rsc/src/routes/rsc-css-modules.tsx new file mode 100644 index 0000000000..a9981e8cae --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-css-modules.tsx @@ -0,0 +1,65 @@ +import { createFileRoute } from '@tanstack/react-router' +import { getCssModulesServerComponent } from '~/utils/cssModulesServerComponent' +import { formatTime, pageStyles } from '~/utils/styles' + +export const Route = createFileRoute('/rsc-css-modules')({ + loader: async () => { + const Server = await getCssModulesServerComponent({ + data: { title: 'CSS Modules in Server Components' }, + }) + return { + Server, + loaderTimestamp: Date.now(), + } + }, + component: RscCssModulesComponent, + pendingComponent: () => { + console.log('[PENDING] /rsc-css-modules') + return <>Loading... + }, +}) + +function RscCssModulesComponent() { + const { Server, loaderTimestamp } = Route.useLoaderData() + + return ( +
    +

    + CSS Modules in RSC +

    +

    + This example demonstrates using CSS Modules (`.module.css` files) within + server components. The styles are scoped, extracted, and work seamlessly + with RSC. +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + + {Server} + +
    + Key Points: +
      +
    • CSS Modules work in server components
    • +
    • Class names are automatically scoped (hashed)
    • +
    • Styles are extracted and sent to the client
    • +
    • No style conflicts with other components
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-css-preload-complex.tsx b/e2e/react-start/rsc/src/routes/rsc-css-preload-complex.tsx new file mode 100644 index 0000000000..6b66f2fa05 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-css-preload-complex.tsx @@ -0,0 +1,111 @@ +import { createFileRoute } from '@tanstack/react-router' +import { CompositeComponent } from '@tanstack/react-start/rsc' +import { formatTime, pageStyles } from '~/utils/styles' +import { getComplexPreloadServerComponentA } from '~/utils/complexPreloadServerComponentA' +import { getComplexPreloadServerComponentB } from '~/utils/complexPreloadServerComponentB' +import { ClientWidgetB } from '~/utils/ClientWidgetB' + +// ============================================================================ +// COMPLEX CSS PRELOAD TEST: +// 1. Server component A renders ClientWidgetA DIRECTLY inside createCompositeComponent +// 2. Server component A accepts children slot for ClientWidgetB (passed from route) +// 3. Server component B renders ClientWidgetC but is NOT rendered in route component +// ============================================================================ + +export const Route = createFileRoute('/rsc-css-preload-complex')({ + loader: async () => { + // Load both server components + const [ServerA, ServerB] = await Promise.all([ + getComplexPreloadServerComponentA({ + data: { title: 'Server Component A' }, + }), + getComplexPreloadServerComponentB({ + data: { title: 'Server Component B (NOT RENDERED)' }, + }), + ]) + + return { + ServerA, + ServerB, // Loaded but NOT rendered + loaderTimestamp: Date.now(), + } + }, + component: RscCssPreloadComplexComponent, + pendingComponent: () => { + console.log('[PENDING] /rsc-css-preload-complex') + return <>Loading... + }, +}) + +function RscCssPreloadComplexComponent() { + const { ServerA, loaderTimestamp } = Route.useLoaderData() + // Note: ServerB is intentionally NOT used/rendered + + return ( +
    +

    + Complex CSS Preload Test +

    +

    + Tests CSS preloading with multiple client components in different + scenarios: direct render, children slot, and unused RSC. +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + + {/* Render ServerA with ClientWidgetB passed as children */} + + + + +
    + Test Scenarios: +
      +
    • + ClientWidgetA (purple): Rendered DIRECTLY inside + createCompositeComponent - CSS should be preloaded +
    • +
    • + ClientWidgetB (teal): Passed via children slot - + CSS should be preloaded +
    • +
    • + ClientWidgetC (orange): In ServerB which is loaded + but NOT rendered - CSS should NOT be loaded (separate module) +
    • +
    +
    + +
    + Note: ServerB with ClientWidgetC is loaded but NOT rendered. + ClientWidgetC uses global CSS that would turn THIS box orange if loaded. + If this box stays blue, the test passes. +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-deferred-component.tsx b/e2e/react-start/rsc/src/routes/rsc-deferred-component.tsx new file mode 100644 index 0000000000..90bbf520b0 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-deferred-component.tsx @@ -0,0 +1,222 @@ +import * as React from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { renderServerComponent } from '@tanstack/react-start/rsc' +import { + serverBadge, + serverBox, + serverHeader, + timestamp, +} from '~/utils/serverStyles' +import { asyncStyles, formatTime, pageStyles } from '~/utils/styles' + +// ============================================================================ +// Server function that returns an immediate RSC + a deferred Promise +// Used to test that RSCs delivered via streaming Promise are decoded +// before the Promise resolves, preventing flash during render. +// ============================================================================ + +const getDeferredRscBundle = createServerFn({ method: 'GET' }).handler( + async () => { + const immediateId = `imm-${Math.random().toString(36).slice(2, 8)}` + const deferredId = `def-${Math.random().toString(36).slice(2, 8)}` + const immediateTimestamp = Date.now() + + // Immediate RSC - renders right away + const ImmediateRsc = await renderServerComponent( +
    +
    + IMMEDIATE RSC + + {new Date(immediateTimestamp).toLocaleTimeString()} + +
    +

    + Immediate Component +

    +

    + This RSC was rendered immediately when the server function completed. + It does not require streaming. +

    +
    + {immediateId} +
    +
    , + ) + + // Deferred RSC - wrapped in Promise that resolves after 500ms + // This tests that RSCs in streaming Promises are decoded before resolution + const deferredRscPromise = new Promise(async (resolve) => { + await new Promise((r) => setTimeout(r, 500)) + const deferredTimestamp = Date.now() + + const DeferredRsc = await renderServerComponent( +
    +
    + STREAMED RSC + + {new Date(deferredTimestamp).toLocaleTimeString()} + +
    +

    + Deferred Component (Streamed) +

    +

    + This RSC was delivered via a streaming Promise that resolved after + 500ms. It should render without flash because the decode completes + before the Promise resolves. +

    +
    + {deferredId} +
    +
    , + ) + resolve(DeferredRsc) + }) + + return { + ImmediateRsc, + deferredRscPromise, + immediateId, + deferredId, + } + }, +) + +export const Route = createFileRoute('/rsc-deferred-component')({ + loader: async () => { + const bundle = await getDeferredRscBundle() + return { + ...bundle, + loaderTimestamp: Date.now(), + } + }, + component: RscDeferredComponentPage, +}) + +function RscDeferredComponentPage() { + const { ImmediateRsc, deferredRscPromise, loaderTimestamp } = + Route.useLoaderData() + + return ( +
    +

    + Deferred RSC Component +

    +

    + This page tests RSC delivery via streaming Promise. The immediate RSC + renders right away, while the deferred RSC arrives via a Promise that + resolves after 500ms. The deferred RSC should render without flash + because its decode completes before the Promise resolves. +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + + {/* Immediate RSC renders right away */} + {ImmediateRsc} + + {/* Deferred RSC rendered via Suspense when Promise resolves */} +
    + +
    + LOADING DEFERRED RSC +
    +
    +

    + Waiting for deferred RSC to stream from server (500ms delay)... +

    + +
    + } + > + +
    +
    + +
    + Key Points: +
      +
    • Immediate RSC renders right away
    • +
    • + Deferred RSC is wrapped in a Promise that resolves after 500ms +
    • +
    • + The RSC decode is awaited before the Promise resolves (in the + streaming chunk handler) +
    • +
    • + No flash (display:none) should occur when the deferred RSC appears +
    • +
    • Client Suspense shows loading state while waiting
    • +
    +
    +
    + ) +} + +// Wrapper component that uses React.use() to unwrap the Promise +function DeferredRscWrapper({ promise }: { promise: Promise }) { + const DeferredRsc = React.use(promise) + return <>{DeferredRsc} +} diff --git a/e2e/react-start/rsc/src/routes/rsc-deferred.tsx b/e2e/react-start/rsc/src/routes/rsc-deferred.tsx new file mode 100644 index 0000000000..a1d3e7c4ab --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-deferred.tsx @@ -0,0 +1,431 @@ +import * as React from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { renderServerComponent } from '@tanstack/react-start/rsc' +import { + serverBox, + serverBadge, + serverHeader, + timestamp, +} from '~/utils/serverStyles' +import { + pageStyles, + clientStyles, + asyncStyles, + formatTime, +} from '~/utils/styles' + +// ============================================================================ +// Server Component Definition +// ============================================================================ + +// Simulate slow data fetching +async function fetchDeferredAnalytics(): Promise<{ + visitors: number + pageViews: number + bounceRate: number + avgSessionDuration: string + topPages: Array<{ path: string; views: number }> +}> { + // Simulate slow API call + await new Promise((resolve) => setTimeout(resolve, 2000)) + return { + visitors: Math.floor(Math.random() * 50000) + 10000, + pageViews: Math.floor(Math.random() * 200000) + 50000, + bounceRate: Math.floor(Math.random() * 30) + 20, + avgSessionDuration: `${Math.floor(Math.random() * 5) + 2}m ${Math.floor(Math.random() * 60)}s`, + topPages: [ + { path: '/home', views: Math.floor(Math.random() * 10000) + 5000 }, + { path: '/products', views: Math.floor(Math.random() * 8000) + 3000 }, + { path: '/about', views: Math.floor(Math.random() * 5000) + 1000 }, + { path: '/contact', views: Math.floor(Math.random() * 3000) + 500 }, + ], + } +} + +const getDeferredDataBundle = createServerFn({ method: 'GET' }) + .inputValidator((data: { reportType: string }) => data) + .handler(async ({ data }) => { + const serverTimestamp = Date.now() + const instanceId = Math.random().toString(36).slice(2, 8) + + // Create RSC - must await since renderServerComponent is async + const ReportHeader = await renderServerComponent( +
    +
    + INSTANT RSC + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    + +

    + Analytics Report: {data.reportType} +

    +

    + This header rendered immediately. The analytics data below is + streaming via a deferred Promise and rendered on the client. +

    +
    + Instance: {instanceId} +
    +
    , + ) + + // Return RSC immediately, plus a deferred Promise for slow data + return { + instanceId, + timestamp: serverTimestamp, + ReportHeader, + // This Promise is deferred - it will stream when ready + deferredAnalytics: fetchDeferredAnalytics(), + } + }) + +export const Route = createFileRoute('/rsc-deferred')({ + loader: async () => { + // Returns RSC immediately + deferred Promise that streams + const bundle = await getDeferredDataBundle({ + data: { reportType: 'Weekly Analytics' }, + }) + return { + ...bundle, + loaderTimestamp: Date.now(), + } + }, + component: RscDeferredComponent, +}) + +// Analytics data type from server +type AnalyticsData = { + visitors: number + pageViews: number + bounceRate: number + avgSessionDuration: string + topPages: Array<{ path: string; views: number }> +} + +// Client component that renders the deferred analytics data +function AnalyticsDisplay({ data }: { data: AnalyticsData }) { + const [selectedMetric, setSelectedMetric] = React.useState( + null, + ) + + return ( +
    +
    + + CLIENT RENDERED (FROM STREAMED DATA) + +
    + +

    + Analytics Dashboard +

    + + {/* Metrics Grid */} +
    +
    setSelectedMetric('visitors')} + style={{ + padding: '16px', + backgroundColor: + selectedMetric === 'visitors' ? '#bbf7d0' : '#f0fdf4', + borderRadius: '8px', + cursor: 'pointer', + border: + selectedMetric === 'visitors' + ? '2px solid #16a34a' + : '1px solid #bbf7d0', + }} + > +
    Visitors
    +
    + {data.visitors.toLocaleString()} +
    +
    + +
    setSelectedMetric('pageviews')} + style={{ + padding: '16px', + backgroundColor: + selectedMetric === 'pageviews' ? '#bbf7d0' : '#f0fdf4', + borderRadius: '8px', + cursor: 'pointer', + border: + selectedMetric === 'pageviews' + ? '2px solid #16a34a' + : '1px solid #bbf7d0', + }} + > +
    Page Views
    +
    + {data.pageViews.toLocaleString()} +
    +
    + +
    setSelectedMetric('bouncerate')} + style={{ + padding: '16px', + backgroundColor: + selectedMetric === 'bouncerate' ? '#bbf7d0' : '#f0fdf4', + borderRadius: '8px', + cursor: 'pointer', + border: + selectedMetric === 'bouncerate' + ? '2px solid #16a34a' + : '1px solid #bbf7d0', + }} + > +
    Bounce Rate
    +
    + {data.bounceRate}% +
    +
    + +
    setSelectedMetric('duration')} + style={{ + padding: '16px', + backgroundColor: + selectedMetric === 'duration' ? '#bbf7d0' : '#f0fdf4', + borderRadius: '8px', + cursor: 'pointer', + border: + selectedMetric === 'duration' + ? '2px solid #16a34a' + : '1px solid #bbf7d0', + }} + > +
    + Avg. Session Duration +
    +
    + {data.avgSessionDuration} +
    +
    +
    + + {/* Top Pages */} +
    +
    + TOP PAGES +
    + {data.topPages.map((page, i) => ( +
    + {page.path} + + {page.views.toLocaleString()} views + +
    + ))} +
    + + {selectedMetric && ( +
    + Selected: {selectedMetric} +
    + )} +
    + ) +} + +// Loading fallback for deferred data +function AnalyticsLoading() { + return ( +
    +
    + LOADING DEFERRED DATA +
    +
    + +

    + The analytics data is being streamed from the server... This simulates a + slow API call (2 seconds). +

    + + +
    + ) +} + +function RscDeferredComponent() { + const { + ReportHeader, + deferredAnalytics, + instanceId, + timestamp, + loaderTimestamp, + } = Route.useLoaderData() + + return ( +
    +

    + Deferred Data - RSC with Streamed Promise +

    +

    + This example demonstrates returning an RSC alongside a deferred Promise. + The RSC header renders immediately, while the analytics data streams + separately and is rendered on the client with Suspense. This pattern + allows showing UI immediately while slow data loads progressively. +

    + +
    + + {loaderTimestamp} + + + {instanceId} + + + {timestamp} + + Instance ID: {instanceId} | Server timestamp: {formatTime(timestamp)} +
    + + {/* RSC renders immediately */} + {ReportHeader} + + {/* Deferred data rendered client-side with Suspense */} +
    + }> + + +
    + +
    + Key Points: +
      +
    • + The server function returns both an RSC (ReportHeader) and a Promise + (deferredAnalytics) +
    • +
    • + The RSC renders immediately on the server and streams to the client +
    • +
    • + The Promise is deferred - it starts executing on the server but + streams its result when ready +
    • +
    • + The client uses React Suspense to show a loading state while waiting + for the deferred data +
    • +
    • + Once the data arrives, it's rendered by a client component with full + interactivity +
    • +
    • + This pattern is ideal when you have fast static content and slow + dynamic data +
    • +
    +
    +
    + ) +} + +// Wrapper component that handles the Promise +function DeferredAnalyticsWrapper({ + promise, +}: { + promise: Promise +}) { + const data = React.use(promise) + return +} diff --git a/e2e/react-start/rsc/src/routes/rsc-direct-loader.tsx b/e2e/react-start/rsc/src/routes/rsc-direct-loader.tsx new file mode 100644 index 0000000000..4bc1e46e48 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-direct-loader.tsx @@ -0,0 +1,55 @@ +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { renderServerComponent } from '@tanstack/react-start/rsc' +import { pageStyles } from '~/utils/styles' +import { + serverBadge, + serverBox, + serverHeader, + timestamp, +} from '~/utils/serverStyles' + +const getDirectLoaderServerComponent = createServerFn({ + method: 'GET', +}).handler(async () => { + const serverTimestamp = Date.now() + + return renderServerComponent( +
    +
    + SERVER RENDERED + + Fetched: {new Date(serverTimestamp).toLocaleTimeString()} + +
    + +

    Direct loader RSC

    +

    + This route returns a server component directly from its loader without + wrapping it in an object. +

    +
    , + ) +}) + +export const Route = createFileRoute('/rsc-direct-loader')({ + loader: () => getDirectLoaderServerComponent(), + component: RscDirectLoaderComponent, +}) + +function RscDirectLoaderComponent() { + const ServerComponent = Route.useLoaderData() + + return ( +
    +

    + Direct Loader Return +

    +

    + The loader returns the server component itself. This guards against + mistaking proxied loader data for a notFound result. +

    + {ServerComponent} +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-error.tsx b/e2e/react-start/rsc/src/routes/rsc-error.tsx new file mode 100644 index 0000000000..2038271206 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-error.tsx @@ -0,0 +1,253 @@ +import * as React from 'react' +import { createFileRoute, ErrorComponent } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { renderServerComponent } from '@tanstack/react-start/rsc' +import { + serverBox, + serverBadge, + serverHeader, + timestamp, +} from '~/utils/serverStyles' +import { pageStyles, clientStyles, formatTime } from '~/utils/styles' + +// ============================================================================ +// Server Component Definition +// ============================================================================ + +const getErrorProneServerComponent = createServerFn({ method: 'GET' }) + .inputValidator( + (data: { shouldError: boolean; errorMessage?: string }) => data, + ) + .handler(async ({ data }) => { + const serverTimestamp = Date.now() + + if (data.shouldError) { + throw new Error( + data.errorMessage || 'Intentional server error for testing', + ) + } + + return renderServerComponent( +
    +
    + ERROR-PRONE RSC + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    + +
    +
    ✅
    +

    + Component Loaded Successfully +

    +

    + This RSC did not throw an error. Toggle the error switch to see + error handling in action. +

    +
    +
    , + ) + }) + +type ErrorSearchParams = { + shouldError?: boolean +} + +export const Route = createFileRoute('/rsc-error')({ + validateSearch: (search: Record): ErrorSearchParams => ({ + shouldError: search.shouldError === 'true' || search.shouldError === true, + }), + loaderDeps: ({ search }) => ({ search }), + loader: async ({ deps }) => { + const ErrorProne = await getErrorProneServerComponent({ + data: { + shouldError: deps.search.shouldError || false, + errorMessage: 'RSC failed to load: Database connection timeout', + }, + }) + return { + ErrorProne, + loaderTimestamp: Date.now(), + } + }, + errorComponent: RouteErrorComponent, + component: RscErrorComponent, +}) + +function RouteErrorComponent({ error }: { error: Error }) { + return ( +
    +

    + Error Handling - RSC Error Boundary +

    + +
    +
    + 💥 +
    +
    + ERROR CAUGHT +
    +

    + {error.message} +

    +
    +
    + +

    + The RSC threw an error and the error boundary caught it. You can + recover by navigating away or toggling the error switch off. +

    + + + Recover (Reload Without Error) + +
    + +
    + Key Points: +
      +
    • RSC errors are caught by the route's errorComponent
    • +
    • Users see a friendly error message, not a crash
    • +
    • Recovery is possible by navigating or reloading
    • +
    +
    +
    + ) +} + +function RscErrorComponent() { + const { ErrorProne, loaderTimestamp } = Route.useLoaderData() + const { shouldError } = Route.useSearch() + + return ( +
    +

    + Error Handling - RSC Error Boundary +

    +

    + This example tests error handling with RSC. Toggle the error switch to + make the RSC throw an error. The error boundary catches it and displays + a friendly message with recovery options. +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + + {/* Error Toggle */} +
    +
    + ERROR CONTROL +
    + +

    + Use the toggle to simulate an RSC error. When enabled, the next load + will throw. +

    + +
    + + Trigger Error on Next Load + + + Error mode: {shouldError ? 'ON' : 'OFF'} + +
    +
    + + {/* RSC Content */} + {ErrorProne} + +
    + Key Points: +
      +
    • RSC errors are caught by route error boundaries
    • +
    • errorComponent provides a recovery UI
    • +
    • Navigate away and back to recover from errors
    • +
    • Error state can be controlled via search params
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-external.tsx b/e2e/react-start/rsc/src/routes/rsc-external.tsx new file mode 100644 index 0000000000..5a7096d27e --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-external.tsx @@ -0,0 +1,203 @@ +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { renderServerComponent } from '@tanstack/react-start/rsc' +import { + serverBox, + serverBadge, + serverHeader, + timestamp, +} from '~/utils/serverStyles' +import { pageStyles, formatTime } from '~/utils/styles' + +// ============================================================================ +// Server Component Definition +// ============================================================================ + +const getExternalDataServerComponent = createServerFn({ method: 'GET' }) + .inputValidator((data: { endpoint: string }) => data) + .handler(async ({ data }) => { + const serverTimestamp = Date.now() + const fetchStart = Date.now() + + // Fetch from the external mock server (set up in e2e tests) + let externalData: { message: string; timestamp: number } | null = null + let fetchError: string | null = null + + try { + const response = await fetch(data.endpoint) + if (!response.ok) { + throw new Error(`HTTP ${response.status}`) + } + externalData = await response.json() + } catch (err) { + fetchError = err instanceof Error ? err.message : 'Unknown error' + } + + const fetchDuration = Date.now() - fetchStart + + return renderServerComponent( +
    +
    + EXTERNAL API DATA + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    + + {fetchError ? ( +
    +
    ❌
    +
    + Failed to fetch external data +
    +
    + {fetchError} +
    +
    + ) : ( +
    +
    + Response from external server: +
    +
    + {JSON.stringify(externalData, null, 2)} +
    +
    + Fetched in {fetchDuration}ms from {data.endpoint} +
    +
    + )} +
    , + ) + }) + +// The external server URL is provided by the e2e test setup +const EXTERNAL_SERVER_URL = + typeof process !== 'undefined' && process.env.EXTERNAL_SERVER_URL + ? process.env.EXTERNAL_SERVER_URL + : 'http://localhost:65003' + +export const Route = createFileRoute('/rsc-external')({ + loader: async () => { + const ExternalData = await getExternalDataServerComponent({ + data: { endpoint: `${EXTERNAL_SERVER_URL}/posts` }, + }) + return { + ExternalData, + loaderTimestamp: Date.now(), + serverUrl: EXTERNAL_SERVER_URL, + } + }, + component: RscExternalComponent, +}) + +function RscExternalComponent() { + const { ExternalData, loaderTimestamp, serverUrl } = Route.useLoaderData() + + return ( +
    +

    + Weather Data - RSC with External API +

    +

    + This example tests RSC fetching from an external API. The RSC makes a + server-side fetch to a mock API server. This simulates real-world + scenarios where RSCs need to call external services. +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + + {/* Server Info */} +
    +
    + External Server: +
    + + {serverUrl} + +
    + + {/* External Data RSC */} + {ExternalData} + +
    + Key Points: +
      +
    • RSC makes server-side fetch to external API
    • +
    • External fetch happens during RSC render on server
    • +
    • Response is embedded in the RSC payload
    • +
    • Error handling for failed external requests
    • +
    • Fetch duration is measured and displayed
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-flight-api.tsx b/e2e/react-start/rsc/src/routes/rsc-flight-api.tsx new file mode 100644 index 0000000000..05b21e1857 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-flight-api.tsx @@ -0,0 +1,223 @@ +import { createFileRoute, useHydrated } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { + createFromFetch, + createFromReadableStream, + renderToReadableStream, +} from '@tanstack/react-start/rsc' +import { Suspense, use, useState } from 'react' +import { formatTime, pageStyles, serverStyles } from '~/utils/styles' + +// ============================================================================ +// Pattern 1: Server function returning raw Response with Flight stream +// This runs in RSC context where renderToReadableStream is available +// ============================================================================ +const getRscFlightResponse = createServerFn({ method: 'GET' }).handler( + async () => { + const stream = renderToReadableStream( +
    +
    + SERVER FN RESPONSE + {formatTime(Date.now())} +
    +

    + This content was rendered via server function returning Response +

    +
    , + ) + + return new Response(stream, { + headers: { 'Content-Type': 'text/x-component' }, + }) + }, +) + +// ============================================================================ +// Route Definition +// ============================================================================ +export const Route = createFileRoute('/rsc-flight-api')({ + component: RscFlightApiComponent, +}) + +function RscFlightApiComponent() { + const isHydrated = useHydrated() + + // Pattern 1: Server function returning Response + const [responsePromise, setResponsePromise] = + useState | null>(null) + const [responseError, setResponseError] = useState(null) + + // Pattern 2: API route returning Flight stream + const [apiPromise, setApiPromise] = useState | null>( + null, + ) + const [apiError, setApiError] = useState(null) + + // Pattern 1: Fetch from server function + const handleResponseClick = async () => { + setResponseError(null) + try { + const response = await getRscFlightResponse() + + if (!(response instanceof Response)) { + throw new Error( + `Expected Response but got ${typeof response}: ${JSON.stringify(response)}`, + ) + } + + const tree = await createFromFetch(Promise.resolve(response)) + setResponsePromise(Promise.resolve(tree as React.ReactNode)) + } catch (e: any) { + setResponseError(e?.message || String(e)) + } + } + + // Pattern 2: Fetch from API route + const handleApiClick = async () => { + setApiError(null) + try { + const response = await fetch('/api/rsc-flight') + + if (!response.ok) { + throw new Error( + `API returned ${response.status}: ${response.statusText}`, + ) + } + + if (!response.body) { + throw new Error('Response has no body') + } + + const tree = await createFromReadableStream(response.body) + setApiPromise(Promise.resolve(tree as React.ReactNode)) + } catch (e: any) { + setApiError(e?.message || String(e)) + } + } + + return ( +
    +

    + Low-Level Flight Stream API +

    +

    + This page demonstrates low-level access to RSC Flight stream generation + and rendering using two patterns: server function returning Response and + API route returning Flight stream. +

    + + {/* Pattern 1: Server Function Response */} +
    +

    + Pattern 1: Server Function + createFromFetch +

    +

    + Server function returns a raw Response wrapping the Flight stream. + Client uses createFromFetch to decode. +

    + +
    + {responseError ? ( +
    + Error: {responseError} +
    + ) : responsePromise ? ( + Loading...
    }> + + + ) : ( +
    + Click button to fetch +
    + )} +
    +
    + + {/* Pattern 2: API Route */} +
    +

    + Pattern 2: API Route + createFromReadableStream +

    +

    + API route calls a server function that returns a ReadableStream, wraps + it in a Response. Client fetches and uses{' '} + createFromReadableStream to decode. +

    + +
    + {apiError ? ( +
    + Error: {apiError} +
    + ) : apiPromise ? ( + Loading...
    } + > + + + ) : ( +
    + Click button to fetch +
    + )} +
    +
    + + ) +} + +function FlightRenderer({ promise }: { promise: Promise }) { + const tree = use(promise) + return <>{tree} +} diff --git a/e2e/react-start/rsc/src/routes/rsc-forms.tsx b/e2e/react-start/rsc/src/routes/rsc-forms.tsx new file mode 100644 index 0000000000..acc4ea140e --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-forms.tsx @@ -0,0 +1,320 @@ +import * as React from 'react' +import { createFileRoute, useRouter } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { + createCompositeComponent, + CompositeComponent, +} from '@tanstack/react-start/rsc' +import { + serverBox, + serverBadge, + serverHeader, + timestamp, +} from '~/utils/serverStyles' +import { pageStyles, clientStyles, formatTime } from '~/utils/styles' + +// ============================================================================ +// Server Component Definitions +// ============================================================================ + +// In-memory todo storage (persists across requests in dev) +const todoStore: Array<{ id: string; text: string; completed: boolean }> = [ + { id: 'todo_1', text: 'Learn React Server Components', completed: true }, + { id: 'todo_2', text: 'Build an RSC application', completed: false }, + { id: 'todo_3', text: 'Test RSC with forms', completed: false }, +] + +const addTodo = createServerFn({ method: 'POST' }) + .inputValidator((data: { text: string }) => data) + .handler(async ({ data }) => { + const newTodo = { + id: `todo_${Date.now()}`, + text: data.text, + completed: false, + } + todoStore.push(newTodo) + return newTodo + }) + +const toggleTodo = createServerFn({ method: 'POST' }) + .inputValidator((data: { id: string }) => data) + .handler(async ({ data }) => { + const todo = todoStore.find((t) => t.id === data.id) + if (todo) { + todo.completed = !todo.completed + } + return todo + }) + +const deleteTodo = createServerFn({ method: 'POST' }) + .inputValidator((data: { id: string }) => data) + .handler(async ({ data }) => { + const index = todoStore.findIndex((t) => t.id === data.id) + if (index !== -1) { + todoStore.splice(index, 1) + } + return { success: true } + }) + +const getTodoListServerComponent = createServerFn({ + method: 'GET', +}).handler(async () => { + const serverTimestamp = Date.now() + + // Return a copy of todos at this moment + const todos = [...todoStore] + + return createCompositeComponent( + (props: { renderActions?: (todoId: string) => React.ReactNode }) => { + const completedCount = todos.filter((t) => t.completed).length + + return ( +
    +
    + TODO LIST (SERVER STATE) + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    + +
    +

    My Tasks

    + + {completedCount}/{todos.length} completed + +
    + + {todos.length === 0 ? ( +
    + No todos yet. Add one above! +
    + ) : ( +
    + {todos.map((todo) => ( +
    +
    + + {todo.completed ? '✅' : '⬜'} + + + {todo.text} + +
    + {props.renderActions?.(todo.id)} +
    + ))} +
    + )} +
    + ) + }, + ) +}) + +export const Route = createFileRoute('/rsc-forms')({ + loader: async () => { + const TodoList = await getTodoListServerComponent() + return { + TodoList, + loaderTimestamp: Date.now(), + } + }, + component: RscFormsComponent, +}) + +function RscFormsComponent() { + const { TodoList, loaderTimestamp } = Route.useLoaderData() + const router = useRouter() + const [newTodoText, setNewTodoText] = React.useState('') + const [isSubmitting, setIsSubmitting] = React.useState(false) + + const handleAddTodo = async (e: React.FormEvent) => { + e.preventDefault() + if (!newTodoText.trim()) return + + setIsSubmitting(true) + try { + await addTodo({ data: { text: newTodoText.trim() } }) + setNewTodoText('') + // Invalidate the route to refetch the RSC + router.invalidate() + } finally { + setIsSubmitting(false) + } + } + + const handleToggle = async (id: string) => { + await toggleTodo({ data: { id } }) + router.invalidate() + } + + const handleDelete = async (id: string) => { + await deleteTodo({ data: { id } }) + router.invalidate() + } + + return ( +
    +

    + Todo List - RSC with Forms +

    +

    + This example tests RSC interaction with server mutations. Add, toggle, + or delete todos - the form submits to server functions, then the RSC + refetches to show updated data. Watch the timestamp change after each + mutation. +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + + {/* Add Todo Form */} +
    +
    + ADD NEW TODO +
    + +
    + setNewTodoText(e.target.value)} + placeholder="What needs to be done?" + data-testid="todo-input" + disabled={isSubmitting} + style={{ + flex: 1, + padding: '10px 12px', + borderRadius: '6px', + border: '1px solid #e2e8f0', + fontSize: '14px', + opacity: isSubmitting ? 0.7 : 1, + }} + /> + +
    +
    + + {/* Todo List RSC with client action render props */} + ( +
    + + +
    + )} + /> + +
    + Key Points: +
      +
    • + Form submission calls server functions (addTodo, toggleTodo, + deleteTodo) +
    • +
    • After mutation, router.invalidate() refetches the RSC
    • +
    • New data appears with a new server timestamp
    • +
    • Client actions are passed as render props to the RSC
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-global-css.tsx b/e2e/react-start/rsc/src/routes/rsc-global-css.tsx new file mode 100644 index 0000000000..e5aee13d0b --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-global-css.tsx @@ -0,0 +1,67 @@ +import { createFileRoute } from '@tanstack/react-router' +import { getGlobalCssServerComponent } from '~/utils/globalCssServerComponent' +import { formatTime, pageStyles } from '~/utils/styles' +// Import global CSS to ensure styles are included in the client bundle +import '~/utils/serverComponent.css' + +export const Route = createFileRoute('/rsc-global-css')({ + loader: async () => { + const Server = await getGlobalCssServerComponent({ + data: { title: 'Global CSS in Server Components' }, + }) + return { + Server, + loaderTimestamp: Date.now(), + } + }, + component: RscGlobalCssComponent, + pendingComponent: () => { + console.log('[PENDING] /rsc-global-css') + return <>Loading... + }, +}) + +function RscGlobalCssComponent() { + const { Server, loaderTimestamp } = Route.useLoaderData() + + return ( +
    +

    + Global CSS in RSC +

    +

    + This example demonstrates using global CSS (`import 'styles.css'`) + within server components. Unlike CSS Modules, class names are not + scoped. +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + + {Server} + +
    + Key Points: +
      +
    • Global CSS works in server components
    • +
    • Class names are NOT scoped (plain strings)
    • +
    • Styles are extracted and sent to the client
    • +
    • Use naming conventions to avoid conflicts
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-hydration.tsx b/e2e/react-start/rsc/src/routes/rsc-hydration.tsx new file mode 100644 index 0000000000..c2ea3b1f7d --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-hydration.tsx @@ -0,0 +1,279 @@ +import * as React from 'react' +import { ClientOnly, createFileRoute } from '@tanstack/react-router' +import { getBasicServerComponent } from '~/utils/basicServerComponent' +import { pageStyles, clientStyles, formatTime } from '~/utils/styles' + +export const Route = createFileRoute('/rsc-hydration')({ + loader: async () => { + const Server = await getBasicServerComponent({ + data: { label: 'hydration test' }, + }) + return { + Server, + loaderTimestamp: Date.now(), + } + }, + component: RscHydrationComponent, +}) + +function RscHydrationComponent() { + const { Server, loaderTimestamp } = Route.useLoaderData() + const [hydrationStatus, setHydrationStatus] = React.useState< + 'checking' | 'success' | 'mismatch' + >('checking') + const [consoleErrors, setConsoleErrors] = React.useState([]) + const [clientTimestamp] = React.useState(Date.now()) + + React.useEffect(() => { + // Check for hydration errors in console + const originalError = console.error + const errors: string[] = [] + + console.error = (...args) => { + const message = args.map((a) => String(a)).join(' ') + if ( + message.includes('hydrat') || + message.includes('mismatch') || + message.includes('did not match') + ) { + errors.push(message) + } + originalError.apply(console, args) + } + + // Give React time to report hydration issues + const timeout = setTimeout(() => { + setConsoleErrors(errors) + setHydrationStatus(errors.length > 0 ? 'mismatch' : 'success') + }, 1000) + + return () => { + console.error = originalError + clearTimeout(timeout) + } + }, []) + + return ( +
    +

    + User Profile - RSC Hydration Test +

    +

    + This example tests that RSC content hydrates correctly without + mismatches. The page monitors for React hydration warnings and displays + the result. A successful hydration means server and client content + matched perfectly. +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + + {/* Hydration Status */} +
    +
    + + {hydrationStatus === 'success' + ? '✅' + : hydrationStatus === 'mismatch' + ? '❌' + : '⏳'} + +
    +
    + HYDRATION STATUS +
    +

    + {hydrationStatus === 'success' + ? 'Hydration Successful' + : hydrationStatus === 'mismatch' + ? 'Hydration Mismatch Detected' + : 'Checking Hydration...'} +

    +
    +
    + + {hydrationStatus === 'success' && ( +

    + The RSC content matched between server and client. No hydration + warnings were detected in the console. +

    + )} + + {hydrationStatus === 'mismatch' && ( +
    +

    + Hydration errors were detected: +

    +
      + {consoleErrors.map((err, i) => ( +
    • {err.slice(0, 200)}...
    • + ))} +
    +
    + )} +
    + + + {/* Timing Info */} +
    +
    + TIMING INFO +
    + +
    +
    +
    + Server Timestamp (Loader) +
    +
    + {loaderTimestamp} +
    +
    +
    +
    + Client Timestamp (useState) +
    +
    + {clientTimestamp} +
    +
    +
    + +
    + Time difference:{' '} + + {clientTimestamp - loaderTimestamp}ms + {' '} + (client - server) +
    +
    +
    + + {/* RSC Content */} + {Server} + +
    + Key Points: +
      +
    • Monitors console for React hydration warnings
    • +
    • Success means server HTML matched client expectations
    • +
    • RSC content should hydrate without mismatches
    • +
    • Timing info shows server vs client timestamps
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-invalidation.tsx b/e2e/react-start/rsc/src/routes/rsc-invalidation.tsx new file mode 100644 index 0000000000..773963ff79 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-invalidation.tsx @@ -0,0 +1,378 @@ +import * as React from 'react' +import { createFileRoute, useNavigate } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { renderServerComponent } from '@tanstack/react-start/rsc' +import { + serverBox, + serverBadge, + serverHeader, + timestamp, +} from '~/utils/serverStyles' +import { pageStyles, clientStyles, formatTime } from '~/utils/styles' + +// ============================================================================ +// Server Component Definition +// ============================================================================ + +const getSearchResultsServerComponent = createServerFn({ + method: 'GET', +}) + .inputValidator((data: { query: string; page: number }) => data) + .handler(async ({ data }) => { + const serverTimestamp = Date.now() + const instanceId = Math.random().toString(36).slice(2, 8) + + // Simulate search results based on query + const allProducts = [ + { + id: 1, + name: 'Wireless Headphones', + category: 'Electronics', + price: 99, + }, + { id: 2, name: 'Bluetooth Speaker', category: 'Electronics', price: 79 }, + { id: 3, name: 'USB-C Cable', category: 'Electronics', price: 15 }, + { id: 4, name: 'Laptop Stand', category: 'Accessories', price: 45 }, + { + id: 5, + name: 'Mechanical Keyboard', + category: 'Electronics', + price: 129, + }, + { id: 6, name: 'Mouse Pad', category: 'Accessories', price: 25 }, + { id: 7, name: 'Webcam HD', category: 'Electronics', price: 89 }, + { id: 8, name: 'Monitor Light', category: 'Accessories', price: 55 }, + ] + + const filtered = data.query + ? allProducts.filter( + (p) => + p.name.toLowerCase().includes(data.query.toLowerCase()) || + p.category.toLowerCase().includes(data.query.toLowerCase()), + ) + : allProducts + + const pageSize = 3 + const startIndex = (data.page - 1) * pageSize + const results = filtered.slice(startIndex, startIndex + pageSize) + const totalPages = Math.ceil(filtered.length / pageSize) + + return renderServerComponent( +
    +
    + SEARCH RESULTS + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    + +
    +

    + Results for "{data.query || 'all products'}" +

    + + Instance: {instanceId} + +
    + +
    + Showing page {data.page} of {totalPages} ({filtered.length} total + results) +
    + + {results.length === 0 ? ( +
    + No results found for "{data.query}" +
    + ) : ( +
    + {results.map((product) => ( +
    +
    +
    + {product.name} +
    +
    + {product.category} +
    +
    +
    + ${product.price} +
    +
    + ))} +
    + )} +
    , + ) + }) + +type SearchParams = { + q?: string + page?: number +} + +export const Route = createFileRoute('/rsc-invalidation')({ + validateSearch: (search: Record): SearchParams => ({ + q: (search.q as string) || '', + page: Number(search.page) || 1, + }), + loaderDeps: ({ search }) => ({ search }), + loader: async ({ deps }) => { + const SearchResults = await getSearchResultsServerComponent({ + data: { + query: deps.search.q || '', + page: deps.search.page || 1, + }, + }) + return { + SearchResults, + loaderTimestamp: Date.now(), + } + }, + component: RscInvalidationComponent, +}) + +function RscInvalidationComponent() { + const { SearchResults, loaderTimestamp } = Route.useLoaderData() + const { q, page } = Route.useSearch() + const navigate = useNavigate() + const [searchInput, setSearchInput] = React.useState(q || '') + + const handleSearch = (e: React.FormEvent) => { + e.preventDefault() + navigate({ + to: '/rsc-invalidation', + search: { q: searchInput, page: 1 }, + }) + } + + const handlePageChange = (newPage: number) => { + navigate({ + to: '/rsc-invalidation', + search: { q, page: newPage }, + }) + } + + return ( +
    +

    + Product Search - RSC Invalidation +

    +

    + This example tests RSC invalidation when search params change. The RSC + refetches when you search or change pages - watch the timestamp and + instance ID change. This verifies RSCs properly invalidate when they + should. +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + + {/* Search Controls */} +
    +
    + CLIENT SEARCH +
    + +
    + setSearchInput(e.target.value)} + placeholder="Search products..." + data-testid="search-input" + style={{ + flex: 1, + padding: '10px 12px', + borderRadius: '6px', + border: '1px solid #e2e8f0', + fontSize: '14px', + }} + /> + +
    + + {/* Quick filter buttons */} +
    + + + +
    + +
    + Current: q="{q || ''}" page={page} +
    +
    + + {/* Search Results RSC */} + {SearchResults} + + {/* Pagination */} +
    + + + Page {page || 1} + + +
    + +
    + Key Points: +
      +
    • RSC refetches when search query changes
    • +
    • RSC refetches when page number changes
    • +
    • Each refetch gets a new timestamp and instance ID
    • +
    • Uses loaderDeps to depend on search params
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-large.tsx b/e2e/react-start/rsc/src/routes/rsc-large.tsx new file mode 100644 index 0000000000..de5bbbfbf6 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-large.tsx @@ -0,0 +1,302 @@ +import * as React from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { renderServerComponent } from '@tanstack/react-start/rsc' +import { + serverBox, + serverBadge, + serverHeader, + timestamp, +} from '~/utils/serverStyles' +import { pageStyles, clientStyles, formatTime } from '~/utils/styles' + +// ============================================================================ +// Server Component Definition +// ============================================================================ + +const getLargePayloadServerComponent = createServerFn({ method: 'GET' }) + .inputValidator((data: { itemCount: number }) => data) + .handler(async ({ data }) => { + const serverTimestamp = Date.now() + + // Generate large dataset + const items = Array.from({ length: data.itemCount }, (_, i) => ({ + id: `item_${i + 1}`, + name: `Product ${i + 1}`, + description: `This is a detailed description for product ${i + 1}. It contains enough text to simulate a realistic product listing.`, + price: Math.floor(Math.random() * 1000) + 10, + inStock: Math.random() > 0.3, + rating: (Math.random() * 2 + 3).toFixed(1), + })) + + return renderServerComponent( +
    +
    + LARGE PAYLOAD + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    + +
    +

    Product Catalog

    + + {items.length} items + +
    + +
    + {items.map((item) => ( +
    +
    + + {item.name} + + + ${item.price} + +
    +
    + {item.description} +
    +
    + ★ {item.rating} + + {item.inStock ? 'In Stock' : 'Out of Stock'} + +
    +
    + ))} +
    +
    , + ) + }) + +type LargeSearchParams = { + count?: number +} + +export const Route = createFileRoute('/rsc-large')({ + validateSearch: (search: Record): LargeSearchParams => ({ + count: Number(search.count) || 50, + }), + loaderDeps: ({ search }) => ({ search }), + loader: async ({ deps }) => { + const startTime = Date.now() + const LargePayload = await getLargePayloadServerComponent({ + data: { itemCount: deps.search.count || 50 }, + }) + const loadTime = Date.now() - startTime + return { + LargePayload, + loaderTimestamp: Date.now(), + loadTime, + itemCount: deps.search.count || 50, + } + }, + component: RscLargeComponent, +}) + +function RscLargeComponent() { + const { LargePayload, loaderTimestamp, loadTime, itemCount } = + Route.useLoaderData() + const [renderStart] = React.useState(Date.now()) + const [renderTime, setRenderTime] = React.useState(null) + + React.useEffect(() => { + setRenderTime(Date.now() - renderStart) + }, [renderStart]) + + return ( +
    +

    + Product Catalog - Large RSC Payload +

    +

    + This example tests RSC performance with large payloads. The RSC renders + {itemCount} products. Adjust the count to test different payload sizes. + Monitor the load time and render time metrics. +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + + {/* Size Controls */} +
    +
    + PAYLOAD SIZE + + Current: {itemCount} items + +
    + +
    + {[10, 50, 100, 200, 500].map((count) => ( + + {count} items + + ))} +
    + + {/* Performance Metrics */} +
    +
    +
    Item Count
    +
    + {itemCount} +
    +
    +
    +
    + Server Load Time +
    +
    + {loadTime}ms +
    +
    +
    +
    + Client Render Time +
    +
    + {renderTime !== null ? `${renderTime}ms` : '...'} +
    +
    +
    +
    + + {/* Large Payload RSC */} + {LargePayload} + +
    + Key Points: +
      +
    • Tests RSC with varying payload sizes (10-500 items)
    • +
    • Measures server load time and client render time
    • +
    • Large payloads may benefit from streaming
    • +
    • Virtual scrolling could improve very large lists
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-link.tsx b/e2e/react-start/rsc/src/routes/rsc-link.tsx new file mode 100644 index 0000000000..bc282086fd --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-link.tsx @@ -0,0 +1,170 @@ +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { renderServerComponent } from '@tanstack/react-start/rsc' +import { + serverBox, + serverBadge, + serverHeader, + timestamp, +} from '~/utils/serverStyles' +import { formatTime, pageStyles } from '~/utils/styles' + +// ============================================================================ +// Server Component Definition +// ============================================================================ + +const getLinkServerComponent = createServerFn({ method: 'GET' }) + .inputValidator((data: { targetRoute: string; linkText: string }) => data) + .handler(async ({ data }) => { + const { Link } = await import('@tanstack/react-router') + const serverTimestamp = Date.now() + + return renderServerComponent( +
    +
    + SERVER EMAIL + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    + + {/* Email Header */} +
    +
    + From: notifications@example.com +
    +

    + Your Weekly Summary is Ready +

    +
    + Received today at {new Date(serverTimestamp).toLocaleTimeString()} +
    +
    + + {/* Email Body */} +
    +

    + Hi there! Your weekly activity report is ready. You had 47 new + visitors and 12 conversions this week. Click below to view the full + report. +

    + + {data.linkText} + +
    + +
    + This Link component is rendered on the server but provides client-side + navigation. +
    +
    , + ) + }) + +export const Route = createFileRoute('/rsc-link')({ + loader: async () => { + const Server = await getLinkServerComponent({ + data: { targetRoute: '/', linkText: 'View Full Report' }, + }) + return { + Server, + loaderTimestamp: Date.now(), + } + }, + component: RscLinkComponent, +}) + +function RscLinkComponent() { + const { Server, loaderTimestamp } = Route.useLoaderData() + + return ( +
    +

    + Email Notification - RSC with Link +

    +

    + This RSC contains a TanStack Router Link component. Even though the + entire email is server-rendered, the Link provides client-side + navigation without a full page reload. +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + + {Server} + +
    + Key Points: +
      +
    • Link component from @tanstack/react-router works inside RSC
    • +
    • + Clicking the link performs client-side navigation (no full reload) +
    • +
    • The RSC is entirely server-rendered including the Link
    • +
    • Link is serialized as a client reference for hydration
    • +
    +
    + +
    + Try it: Click the "View Full Report" button in the + email above. Notice the URL changes without a full page reload - that's + client-side navigation from a server-rendered Link! +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-multi.tsx b/e2e/react-start/rsc/src/routes/rsc-multi.tsx new file mode 100644 index 0000000000..a36981c74b --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-multi.tsx @@ -0,0 +1,276 @@ +import * as React from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { + renderServerComponent, + createCompositeComponent, + CompositeComponent, +} from '@tanstack/react-start/rsc' +import { + serverBox, + serverBadge, + serverHeader, + timestamp, +} from '~/utils/serverStyles' +import { clientStyles, formatTime, pageStyles } from '~/utils/styles' + +// ============================================================================ +// Server Component Definitions +// ============================================================================ + +const getMultiServerComponentA = createServerFn({ + method: 'GET', +}).handler(async () => { + const serverTimestamp = Date.now() + + return renderServerComponent( +
    +
    + ARTICLE A + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    +

    + Breaking: New Framework Released +

    +

    + A revolutionary new web framework promises to change how we build + applications. Early benchmarks show 10x performance improvements. +

    +
    , + ) +}) + +const getMultiServerComponentB = createServerFn({ + method: 'GET', +}).handler(async () => { + const serverTimestamp = Date.now() + + return renderServerComponent( +
    +
    + ARTICLE B + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    +

    + Industry Update: Cloud Spending Rises +

    +

    + Enterprise cloud spending reached record highs this quarter as companies + accelerate their digital transformation initiatives. +

    +
    , + ) +}) + +const getMultiServerComponentC = createServerFn({ + method: 'GET', +}).handler(async () => { + const serverTimestamp = Date.now() + + return createCompositeComponent((props: { children?: React.ReactNode }) => { + return ( +
    +
    + ARTICLE C (WITH SLOT) + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    +

    + Tutorial: Building with RSC +

    +

    + Learn how to leverage React Server Components for better performance + and developer experience. +

    +
    + {props.children} +
    +
    + ) + }) +}) + +export const Route = createFileRoute('/rsc-multi')({ + loader: async () => { + // Load multiple RSCs in parallel + const [ServerA, ServerB, ServerC] = await Promise.all([ + getMultiServerComponentA(), + getMultiServerComponentB(), + getMultiServerComponentC(), + ]) + return { + ServerA, + ServerB, + ServerC, + loaderTimestamp: Date.now(), + } + }, + component: RscMultiComponent, +}) + +function RscMultiComponent() { + const { ServerA, ServerB, ServerC, loaderTimestamp } = Route.useLoaderData() + const [bookmarked, setBookmarked] = React.useState>(new Set()) + + const toggleBookmark = (id: string) => { + setBookmarked((prev) => { + const next = new Set(prev) + if (next.has(id)) { + next.delete(id) + } else { + next.add(id) + } + return next + }) + } + + return ( +
    +

    + News Feed - Multiple RSCs +

    +

    + This page loads three independent RSCs in parallel. Each article has its + own server timestamp, showing they were fetched at the same time. The + bookmark buttons are client-interactive. +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + + {/* Bookmark Summary */} +
    +
    + CLIENT STATE +
    +
    + Bookmarked articles:{' '} + {bookmarked.size === 0 ? 'None' : Array.from(bookmarked).join(', ')} +
    +
    + +
    + {/* Article A with bookmark button */} +
    + {ServerA} + +
    + + {/* Article B with bookmark button */} +
    + {ServerB} + +
    + + {/* Article C with slot */} + +
    + + Interactive content in slot + + +
    +
    +
    + +
    + Key Points: +
      +
    • Multiple RSCs can be loaded in parallel
    • +
    • Each RSC has its own independent server timestamp
    • +
    • Client state (bookmarks) is separate from server components
    • +
    • Article C demonstrates a slot for client-interactive content
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-nested-structure.tsx b/e2e/react-start/rsc/src/routes/rsc-nested-structure.tsx new file mode 100644 index 0000000000..6e11b449e8 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-nested-structure.tsx @@ -0,0 +1,722 @@ +import * as React from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { + CompositeComponent, + createCompositeComponent, + renderServerComponent, +} from '@tanstack/react-start/rsc' +import { pageStyles, clientStyles, formatTime } from '~/utils/styles' +import { + serverBox, + serverBadge, + serverHeader, + timestamp, +} from '~/utils/serverStyles' + +// ============================================================================ +// NESTED STRUCTURE: Multiple server components with slots in a single return +// ============================================================================ + +const getNestedServerComponents = createServerFn({ method: 'GET' }) + .inputValidator((data: { title: string }) => data) + .handler(async ({ data }) => { + const serverTimestamp = Date.now() + + // Simulate fetching data from different sources + const headerData = { + title: data.title, + subtitle: 'Nested RSC Structure Demo', + } + + const statsData = { + views: 12543, + likes: 847, + shares: 234, + } + + const footerData = { + lastUpdated: new Date(serverTimestamp).toLocaleString(), + version: '1.0.0', + } + + // Return an object structure with multiple ReactNodes + // Each nested component uses the same flat props for slots + return createCompositeComponent( + (props: { + children?: React.ReactNode + renderExtra?: (data: { total: number }) => React.ReactNode + renderActions?: (data: { version: string }) => React.ReactNode + }) => ({ + // Top-level component with children slot + Header: ( +
    +
    + SERVER HEADER + + Rendered: {new Date(serverTimestamp).toLocaleTimeString()} + +
    +

    + {headerData.title} +

    +

    {headerData.subtitle}

    + {/* Children slot */} + {props.children} +
    + ), + + // Nested structure + content: { + Stats: ( +
    +
    + SERVER STATS +
    +
    +
    +
    + {statsData.views.toLocaleString()} +
    +
    + Views +
    +
    +
    +
    + {statsData.likes.toLocaleString()} +
    +
    + Likes +
    +
    +
    +
    + {statsData.shares} +
    +
    + Shares +
    +
    +
    + {/* Render prop slot - passes server data to client */} + {props.renderExtra?.({ + total: statsData.views + statsData.likes + statsData.shares, + })} +
    + ), + + // Even deeper nesting with children slot + details: { + Info: ( +
    +
    + SERVER INFO +
    +

    + This component is deeply nested at content.details.Info +

    + {/* Children slot */} + {props.children} +
    + ), + }, + }, + + // Footer with both children and render prop slots + Footer: ( +
    +
    + SERVER FOOTER +
    +
    + + Last updated: {footerData.lastUpdated} + + + v{footerData.version} + +
    + {/* Children slot */} + {props.children} + {/* Render prop slot - passes server data to client */} + {props.renderActions?.({ version: footerData.version })} +
    + ), + }), + ) + }) + +// ============================================================================ +// DESTRUCTURED PATTERN: Same structure, accessed via destructuring +// ============================================================================ + +const getNestedRenderableParts = createServerFn({ method: 'GET' }).handler( + async () => { + const serverTimestamp = Date.now() + + const serverNode = { + foo: { + bar: ( +
    +
    + SERVER RENDERABLE BAR + + Rendered: {new Date(serverTimestamp).toLocaleTimeString()} + +
    +
    + I am foo.bar +
    +
    + ), + }, + baz: ( +
    +
    + SERVER RENDERABLE BAZ +
    +
    I am baz
    +
    + ), + } + + const rendered = await renderServerComponent(serverNode) + + return rendered + }, +) + +const getDestructuredComponents = createServerFn({ method: 'GET' }).handler( + async () => { + const serverTimestamp = Date.now() + + return createCompositeComponent( + (props: { + children?: React.ReactNode + renderBadge?: (data: { count: number }) => React.ReactNode + }) => ({ + Header: ( +
    +
    + DESTRUCTURED HEADER + + Rendered: {new Date(serverTimestamp).toLocaleTimeString()} + +
    +

    + Destructured Access Pattern +

    + {props.children} +
    + ), + + Content: ( +
    +
    + DESTRUCTURED CONTENT +
    +

    + This component was destructured from loader data +

    + {props.renderBadge?.({ count: 42 })} +
    + ), + + Footer: ( +
    +
    + DESTRUCTURED FOOTER +
    +

    + Destructured components work exactly like dot-notation access +

    + {props.children} +
    + ), + }), + ) + }, +) + +export const Route = createFileRoute('/rsc-nested-structure')({ + loader: async () => { + const [NestedComponents, DestructuredLayout, NestedRenderableParts] = + await Promise.all([ + getNestedServerComponents({ + data: { title: 'Dashboard Overview' }, + }), + getDestructuredComponents(), + getNestedRenderableParts(), + ]) + + return { + NestedComponents, + DestructuredLayout, + NestedRenderableParts, + loaderTimestamp: Date.now(), + } + }, + component: RscNestedStructureComponent, +}) + +function RscNestedStructureComponent() { + const { + NestedComponents, + DestructuredLayout, + NestedRenderableParts, + loaderTimestamp, + } = Route.useLoaderData() + + // Destructure nested components from loader data + const { Header, Content, Footer } = DestructuredLayout + + const [headerSlotText, setHeaderSlotText] = React.useState( + 'Initial header slot', + ) + const [statsMultiplier, setStatsMultiplier] = React.useState(1) + const [infoSlotVisible, setInfoSlotVisible] = React.useState(true) + const [footerSlotText, setFooterSlotText] = React.useState( + 'Initial footer slot', + ) + const [destructuredSlotText, setDestructuredSlotText] = React.useState( + 'Initial destructured slot', + ) + const [badgeMultiplier, setBadgeMultiplier] = React.useState(1) + + return ( +
    +

    + Nested RSC Structure with Slots +

    + +
    +

    + Nested Structure Renderables +

    +

    + These are returned via renderServerComponent in a nested + object and rendered via dot access: data.foo.bar. +

    + +
    + {NestedRenderableParts.foo.bar} +
    +
    {NestedRenderableParts.baz}
    +
    +

    + This example demonstrates returning an object structure with multiple + ReactNodes from a single server component. Each nested component + supports slots (children and render props) for client interactivity. +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + + {/* Client Controls */} +
    +
    + CLIENT CONTROLS +
    +

    + Use these buttons to modify slot content. Server components won't + reload! +

    +
    + + + + +
    +
    + + {/* Nested structure rendering with slots */} +
    +

    + Nested Structure Components with Slots +

    + + {/* Top-level access with children slot */} +
    + +
    + + CLIENT SLOT: + {' '} + {headerSlotText} +
    +
    +
    + + {/* Nested access with render prop slot */} +
    + ( +
    + + CLIENT RENDER PROP: + {' '} + Server total: {total} × {statsMultiplier} ={' '} + + {total * statsMultiplier} + +
    + )} + /> +
    + + {/* Deep nested access with children slot */} +
    + + {infoSlotVisible && ( +
    + + CLIENT SLOT: + {' '} + Deeply nested client content +
    + )} +
    +
    + + {/* Footer with both children and render prop slots */} +
    + ( +
    + + Version from server:{' '} + {version} + + +
    + )} + > +
    + + CLIENT SLOT: + {' '} + {footerSlotText} +
    +
    +
    +
    + + {/* ================================================================== */} + {/* DESTRUCTURED ACCESS PATTERN */} + {/* ================================================================== */} +
    +

    + Destructured Access Pattern +

    +

    + These components are destructured from loader data:{' '} + + {'const { Header, Content, Footer } = DestructuredLayout'} + +

    + + {/* Controls for destructured section */} +
    +
    + DESTRUCTURED CONTROLS +
    +
    + + +
    +
    + + {/* Destructured Header with children slot */} +
    + +
    + + CLIENT SLOT: + {' '} + {destructuredSlotText} +
    +
    +
    + + {/* Destructured Content with render prop */} +
    + ( +
    + + CLIENT RENDER PROP: + {' '} + Server count: {count} × {badgeMultiplier} ={' '} + + {count * badgeMultiplier} + +
    + )} + /> +
    + + {/* Destructured Footer with children slot */} +
    + +
    + + CLIENT SLOT: + {' '} + Footer via destructuring +
    +
    +
    +
    + +
    + Key Points: +
      +
    • + Single server function returns multiple RSC components in a + structure +
    • +
    • + Access nested components via dot notation:{' '} + result.content.Stats +
    • +
    • + Or destructure from loader data:{' '} + {'const { Header, Content, Footer } = Layout'} +
    • +
    • + Deep nesting supported: result.content.details.Info +
    • +
    • + Each nested component supports flat slots (children, render props) +
    • +
    • + Render props receive server data:{' '} + {'renderExtra={({ total }) => ...}'} +
    • +
    • Slot updates do NOT refetch server components
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-nested.tsx b/e2e/react-start/rsc/src/routes/rsc-nested.tsx new file mode 100644 index 0000000000..2f2e175766 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-nested.tsx @@ -0,0 +1,523 @@ +import * as React from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { + createCompositeComponent, + CompositeComponent, +} from '@tanstack/react-start/rsc' +import { + serverBox, + serverBadge, + serverHeader, + timestamp, +} from '~/utils/serverStyles' +import { pageStyles, clientStyles, formatTime } from '~/utils/styles' + +// ============================================================================ +// Server Component Definitions +// ============================================================================ + +const getProductCardServerComponent = createServerFn({ + method: 'GET', +}) + .inputValidator((data: { productId: string }) => data) + .handler(async ({ data }) => { + const serverTimestamp = Date.now() + + // Simulate fetching product from database + const product = { + id: data.productId, + name: 'Wireless Noise-Canceling Headphones', + brand: 'AudioTech Pro', + price: 299.99, + originalPrice: 349.99, + rating: 4.7, + reviewCount: 1247, + inStock: true, + features: [ + '40-hour battery life', + 'Active noise cancellation', + 'Premium comfort design', + ], + } + + return createCompositeComponent((props: { children?: React.ReactNode }) => { + const discount = Math.round( + ((product.originalPrice - product.price) / product.originalPrice) * 100, + ) + + return ( +
    +
    + PRODUCT CARD (OUTER RSC) + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    + + {/* Product Info */} +
    +
    + 🎧 +
    +
    +
    + {product.brand} +
    +

    + {product.name} +

    +
    + + ${product.price} + + + ${product.originalPrice} + + + {discount}% OFF + +
    +
    + ★ + + {product.rating} + + + ({product.reviewCount.toLocaleString()} reviews) + +
    +
    +
    + + {/* Features List */} +
    +
    + KEY FEATURES +
    +
      + {product.features.map((feature, i) => ( +
    • + {feature} +
    • + ))} +
    +
    + + {/* Nested content slot */} +
    +
    + NESTED CONTENT (CLIENT + RSC) +
    +
    {props.children}
    +
    +
    + ) + }) + }) + +const getProductReviewsServerComponent = createServerFn({ + method: 'GET', +}) + .inputValidator((data: { productId: string }) => data) + .handler(async ({ data }) => { + const serverTimestamp = Date.now() + + // Simulate fetching reviews from database + const reviews = [ + { + id: 'rev_1', + author: 'MusicLover42', + rating: 5, + date: '2 days ago', + title: 'Best headphones I have ever owned!', + content: + 'The noise cancellation is incredible. Perfect for my daily commute.', + helpful: 127, + }, + { + id: 'rev_2', + author: 'TechReviewer', + rating: 4, + date: '1 week ago', + title: 'Great sound, minor comfort issue', + content: + 'Excellent audio quality. Gets slightly warm after 3+ hours of use.', + helpful: 84, + }, + { + id: 'rev_3', + author: 'CasualListener', + rating: 5, + date: '2 weeks ago', + title: 'Worth every penny', + content: + 'Battery life is exactly as advertised. Very happy with this purchase.', + helpful: 56, + }, + ] + + return createCompositeComponent( + (props: { renderActions?: (reviewId: string) => React.ReactNode }) => { + return ( +
    +
    + REVIEWS (INNER RSC) + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    + +

    + Customer Reviews for Product {data.productId} +

    + +
    + {reviews.map((review) => ( +
    +
    +
    + + {review.author} + + + {'★'.repeat(review.rating)} + {'☆'.repeat(5 - review.rating)} + +
    + + {review.date} + +
    +
    + {review.title} +
    +
    + {review.content} +
    +
    + + {review.helpful} people found this helpful + + {props.renderActions?.(review.id)} +
    +
    + ))} +
    +
    + ) + }, + ) + }) + +export const Route = createFileRoute('/rsc-nested')({ + loader: async () => { + // Load both RSCs in parallel - they will be composed on the client + const [ProductCard, ProductReviews] = await Promise.all([ + getProductCardServerComponent({ data: { productId: 'HEADPHONES-001' } }), + getProductReviewsServerComponent({ + data: { productId: 'HEADPHONES-001' }, + }), + ]) + return { + ProductCard, + ProductReviews, + loaderTimestamp: Date.now(), + } + }, + component: RscNestedComponent, +}) + +// Client component that wraps the inner RSC - simulates a "Reviews Section" toggle +function ReviewsSection({ + children, + isExpanded, + onToggle, + helpfulReviews, +}: { + children: React.ReactNode + isExpanded: boolean + onToggle: () => void + helpfulReviews: Set +}) { + return ( +
    +
    + CLIENT WRAPPER + + Marked {helpfulReviews.size} as helpful + +
    + +
    +
    +

    Customer Reviews

    +

    + This section demonstrates a client component wrapping an inner RSC +

    +
    + +
    + + {isExpanded &&
    {children}
    } +
    + ) +} + +function RscNestedComponent() { + const { ProductCard, ProductReviews, loaderTimestamp } = Route.useLoaderData() + const [showReviews, setShowReviews] = React.useState(true) + const [helpfulReviews, setHelpfulReviews] = React.useState>( + new Set(), + ) + + const markHelpful = (reviewId: string) => { + setHelpfulReviews((prev) => { + const next = new Set(prev) + if (next.has(reviewId)) { + next.delete(reviewId) + } else { + next.add(reviewId) + } + return next + }) + } + + return ( +
    +

    + E-commerce Product Page - Nested RSCs +

    +

    + This example shows RSCs nested inside each other via client composition. + The outer RSC (Product Card - blue) contains a client component (Reviews + Section - green) which wraps an inner RSC (Reviews - light green). Each + RSC has its own server timestamp showing they were fetched + independently. +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + + {/* Outer RSC (Product Card) with nested content */} + + {/* Client component that wraps the inner RSC */} + setShowReviews((s) => !s)} + helpfulReviews={helpfulReviews} + > + {/* Inner RSC (Reviews) with render prop for client actions */} + ( + + )} + /> + + + +
    + Key Points: +
      +
    • + Outer RSC (Product Card) and Inner RSC (Reviews) are loaded in + parallel in the route loader +
    • +
    • + The client composes them together: ProductCard → ReviewsSection + (client) → ProductReviews +
    • +
    • + Each RSC has its own timestamp - collapsing/expanding doesn't + refetch either one +
    • +
    • + The "Helpful" buttons are client-interactive render props passed + into the inner RSC +
    • +
    • + This pattern allows mixing server-rendered content with client + interactivity at any nesting level +
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-parallel.tsx b/e2e/react-start/rsc/src/routes/rsc-parallel.tsx new file mode 100644 index 0000000000..2e12c7df04 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-parallel.tsx @@ -0,0 +1,197 @@ +import * as React from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { renderServerComponent } from '@tanstack/react-start/rsc' +import { + serverBadge, + serverBox, + serverHeader, + timestamp, +} from '~/utils/serverStyles' +import { formatTime, pageStyles } from '~/utils/styles' + +// ============================================================================ +// Three independent server functions that each return an RSC +// Used to test that parallel server function calls correctly scope +// their decode promise tracking without cross-contamination. +// ============================================================================ + +const getParallelRscA = createServerFn({ method: 'GET' }).handler(async () => { + const serverTimestamp = Date.now() + const id = `A-${Math.random().toString(36).slice(2, 8)}` + + return renderServerComponent( +
    +
    + RSC A + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    +

    + Component A: First Parallel RSC +

    +

    + This RSC was loaded in parallel with B and C. Each has its own unique ID + to verify no cross-contamination occurs. +

    +
    + {id} +
    +
    , + ) +}) + +const getParallelRscB = createServerFn({ method: 'GET' }).handler(async () => { + const serverTimestamp = Date.now() + const id = `B-${Math.random().toString(36).slice(2, 8)}` + + // Add small delay to ensure potential interleaving with other calls + await new Promise((r) => setTimeout(r, 50)) + + return renderServerComponent( +
    +
    + RSC B + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    +

    + Component B: Second Parallel RSC (Delayed) +

    +

    + This RSC has a 50ms delay to test interleaving. Its decode promise + should be correctly scoped to its own server function call. +

    +
    + {id} +
    +
    , + ) +}) + +const getParallelRscC = createServerFn({ method: 'GET' }).handler(async () => { + const serverTimestamp = Date.now() + const id = `C-${Math.random().toString(36).slice(2, 8)}` + + return renderServerComponent( +
    +
    + RSC C + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    +

    + Component C: Third Parallel RSC +

    +

    + This RSC completes quickly. All three RSCs should render without flash + when navigating to this route. +

    +
    + {id} +
    +
    , + ) +}) + +export const Route = createFileRoute('/rsc-parallel')({ + loader: async () => { + // Load all RSCs in parallel - tests concurrent deserialization + // Each server function call should correctly scope its decode promises + const [RscA, RscB, RscC] = await Promise.all([ + getParallelRscA(), + getParallelRscB(), + getParallelRscC(), + ]) + return { + RscA, + RscB, + RscC, + loaderTimestamp: Date.now(), + } + }, + component: RscParallelComponent, +}) + +function RscParallelComponent() { + const { RscA, RscB, RscC, loaderTimestamp } = Route.useLoaderData() + + return ( +
    +

    + Parallel RSC Loading +

    +

    + This page loads three independent RSCs in parallel using Promise.all(). + Each RSC has its own unique ID (starting with A-, B-, or C-) to verify + that parallel server function calls correctly scope their decode + promises without cross-contamination. +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + +
    + {RscA} + {RscB} + {RscC} +
    + +
    + Key Points: +
      +
    • Three RSCs are loaded in parallel via Promise.all()
    • +
    • Each RSC has a unique ID (A-xxx, B-xxx, C-xxx)
    • +
    • RSC B has a 50ms delay to test interleaving
    • +
    • No flash should occur during client-side navigation
    • +
    • + Each server function call should correctly scope its decode promises +
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-param/$id.tsx b/e2e/react-start/rsc/src/routes/rsc-param/$id.tsx new file mode 100644 index 0000000000..96a7048b28 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-param/$id.tsx @@ -0,0 +1,165 @@ +import * as React from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { + CompositeComponent, + createCompositeComponent, + renderServerComponent, +} from '@tanstack/react-start/rsc' +import { ClientRenderedDirect } from '~/utils/rsc-param/ClientRenderedDirect' +import { SlotChild } from '~/utils/rsc-param/SlotChild' +import { SlotRenderProp } from '~/utils/rsc-param/SlotRenderProp' +import { + serverBadge, + serverBox, + serverHeader, + timestamp, +} from '~/utils/serverStyles' +import { clientStyles, pageStyles } from '~/utils/styles' + +const getParamRsc = createServerFn({ method: 'GET' }) + .inputValidator((data: { id: string }) => data) + .handler(async ({ data }) => { + const serverTimestamp = Date.now() + + const Renderable = await renderServerComponent( +
    +
    + SERVER RENDERABLE + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    + +
    id: {data.id}
    + +
    + +
    +
    , + ) + + const Composite = await createCompositeComponent( + (props: { + children?: React.ReactNode + renderFooter?: () => React.ReactNode + }) => ( +
    +
    + SERVER COMPOSITE + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    + +
    id: {data.id}
    + +
    +
    + Client Slot +
    +
    {props.children}
    +
    + +
    + {props.renderFooter?.()} +
    +
    + ), + ) + + return { + Renderable, + Composite, + id: data.id, + } + }) + +export const Route = createFileRoute('/rsc-param/$id')({ + loader: async ({ params }) => { + const result = await getParamRsc({ + data: { id: params.id }, + }) + return { + ...result, + loaderTimestamp: Date.now(), + } + }, + component: RscParamIdComponent, + pendingComponent: () => { + return ( +
    +

    Loading RSC path param…

    +

    Loading...

    +
    + ) + }, +}) + +function RscParamIdComponent() { + const { id, Renderable, Composite } = Route.useLoaderData() + + return ( +
    +

    RSC path param: {id}

    +

    + This page mixes a renderable RSC that renders a client component + directly and a composite RSC with slots. +

    + +
    +
    + CLIENT NAV +
    + + + Navigate to id={id === 'alpha' ? 'bravo' : 'alpha'} + +
    + + {Renderable} + + } + > + + +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-param/index.tsx b/e2e/react-start/rsc/src/routes/rsc-param/index.tsx new file mode 100644 index 0000000000..6e87eec0b8 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-param/index.tsx @@ -0,0 +1,36 @@ +import { createFileRoute, Link } from '@tanstack/react-router' +import { pageStyles } from '~/utils/styles' + +export const Route = createFileRoute('/rsc-param/')({ + component: RscParamIndexComponent, +}) + +const ids = ['alpha', 'bravo', 'charlie'] + +function RscParamIndexComponent() { + return ( +
    +

    RSC Param Routes

    +

    + Links to a dynamic /rsc-param/$id route. +

    + +
    +
    Examples
    +
      + {ids.map((id) => ( +
    • + + /rsc-param/{id} + +
    • + ))} +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-react-cache.tsx b/e2e/react-start/rsc/src/routes/rsc-react-cache.tsx new file mode 100644 index 0000000000..411e17f475 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-react-cache.tsx @@ -0,0 +1,590 @@ +import * as React from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { renderServerComponent } from '@tanstack/react-start/rsc' +import { + serverBox, + serverBadge, + serverHeader, + timestamp, +} from '~/utils/serverStyles' +import { pageStyles, formatTime } from '~/utils/styles' + +// ============================================================================ +// React.cache Demo - Memoizing expensive computations within a render pass +// ============================================================================ + +// Inner async component for the cache demo content +async function ReactCacheContent({ + testCache, + serverTimestamp, +}: { + testCache: boolean + serverTimestamp: number +}) { + // Keep all test state request-scoped to avoid flakiness from module-level state. + let cacheFnCount = 0 + let nonCacheFnCount = 0 + + const cachedFn = React.cache(async (arg: string) => { + cacheFnCount++ + // Simulate expensive operation + await new Promise((resolve) => setTimeout(resolve, 10)) + return { + arg, + callNumber: cacheFnCount, + randomValue: Math.random().toString(36).slice(2, 8), + } + }) + + const nonCachedFn = async (arg: string) => { + nonCacheFnCount++ + await new Promise((resolve) => setTimeout(resolve, 10)) + return { + arg, + callNumber: nonCacheFnCount, + randomValue: Math.random().toString(36).slice(2, 8), + } + } + + // Only run the test calls when testCache is true + // This pattern matches the vite-plugin-rsc example + let cachedResults: Array<{ + arg: string + callNumber: number + randomValue: string + }> = [] + let nonCachedResults: Array<{ + arg: string + callNumber: number + randomValue: string + }> = [] + + if (testCache) { + // Call cachedFn with same and different arguments + // 'test1' -> cache miss (call 1) + // 'test2' -> cache miss (call 2) + // 'test1' -> cache HIT (no call, returns cached result) + const cached1 = await cachedFn('test1') + const cached2 = await cachedFn('test2') + const cached3 = await cachedFn('test1') // should hit cache + cachedResults = [cached1, cached2, cached3] + + // Call nonCachedFn for comparison - all calls run + const nonCached1 = await nonCachedFn('test1') + const nonCached2 = await nonCachedFn('test2') + const nonCached3 = await nonCachedFn('test1') + nonCachedResults = [nonCached1, nonCached2, nonCached3] + } + + // cacheFnCount should be 2 (only 2 unique args) + // nonCacheFnCount should be 3 (all calls run) + const cacheWorking = cacheFnCount === 2 && nonCacheFnCount === 3 + + // Styles for the visualization + const callBoxStyle = (isHit: boolean, _isCached: boolean) => ({ + padding: '12px', + borderRadius: '8px', + border: `2px solid ${isHit ? '#7c3aed' : '#0284c7'}`, + backgroundColor: isHit ? '#f5f3ff' : '#f0f9ff', + marginBottom: '8px', + }) + + const argBadgeStyle = (arg: string) => ({ + display: 'inline-block', + padding: '2px 8px', + borderRadius: '4px', + backgroundColor: arg === 'test1' ? '#dbeafe' : '#fef3c7', + color: arg === 'test1' ? '#1e40af' : '#92400e', + fontFamily: 'monospace', + fontSize: '13px', + fontWeight: 'bold' as const, + }) + + const statusBadgeStyle = (isHit: boolean) => ({ + display: 'inline-block', + padding: '2px 8px', + borderRadius: '4px', + backgroundColor: isHit ? '#ede9fe' : '#e0f2fe', + color: isHit ? '#6d28d9' : '#0369a1', + fontSize: '11px', + fontWeight: 'bold' as const, + marginLeft: '8px', + }) + + return ( +
    +
    + REACT.CACHE DEMO + + Rendered: {formatTime(serverTimestamp)} + +
    + + {!testCache ? ( +
    +
    + This demo shows how React.cache deduplicates function + calls with identical arguments within a single server render. +
    + + Run the Test + +
    + ) : ( + <> + {/* Status Banner */} +
    +
    + {cacheWorking ? 'React.cache is working!' : 'Cache was not used'} +
    +
    + {cacheWorking + ? 'The cached function ran only 2 times for 3 calls (1 cache hit)' + : 'Expected 2 cached calls but got ' + cacheFnCount} +
    +
    + + {/* The Experiment */} +
    +
    + The Experiment +
    +
    +
    + // Call the same function 3 times: +
    +
    + await cachedFn( + 'test1') + // unique arg #1 +
    +
    + await cachedFn( + 'test2') + // unique arg #2 +
    +
    + await cachedFn( + 'test1') + + {' '} + // same as #1 = CACHE HIT + +
    +
    +
    + + {/* Side by side comparison */} +
    + {/* With React.cache */} +
    +
    + + WITH React.cache + +
    + + {cachedResults.map((result, index) => { + const isHit = index === 2 // 3rd call is a cache hit + return ( +
    +
    +
    + + Call {index + 1}: + + + "{result.arg}" + + + {isHit ? 'CACHE HIT' : 'executed'} + +
    +
    +
    + Result ID:{' '} + + {result.randomValue} + + {isHit && ( + + (same as Call 1) + + )} +
    +
    + ) + })} + +
    +
    + Function executed{' '} + + {cacheFnCount} + {' '} + times +
    +
    + (1 call was served from cache) +
    +
    +
    + + {/* Without React.cache */} +
    +
    + + WITHOUT React.cache + +
    + + {nonCachedResults.map((result, index) => ( +
    +
    +
    + + Call {index + 1}: + + + "{result.arg}" + + + executed + +
    +
    +
    + Result ID:{' '} + + {result.randomValue} + + + (unique each time) + +
    +
    + ))} + +
    +
    + Function executed{' '} + + {nonCacheFnCount} + {' '} + times +
    +
    + (every call runs the function) +
    +
    +
    +
    + + {/* Raw counts for testing */} +
    + (cacheFnCount = {cacheFnCount}, nonCacheFnCount = {nonCacheFnCount}) +
    + + + + )} +
    + ) +} + +// Server component that demonstrates React.cache +const getReactCacheServerComponent = createServerFn({ method: 'GET' }) + .inputValidator((data: { testCache: boolean }) => data) + .handler(async ({ data }) => { + const serverTimestamp = Date.now() + + return renderServerComponent( + , + ) + }) + +export const Route = createFileRoute('/rsc-react-cache')({ + loaderDeps: ({ search }) => ({ + testCache: 'test-cache' in (search as Record), + }), + loader: async ({ deps }) => { + const Server = await getReactCacheServerComponent({ + data: { testCache: deps.testCache }, + }) + return { + Server, + loaderTimestamp: Date.now(), + } + }, + component: RscReactCacheComponent, +}) + +function RscReactCacheComponent() { + const { Server, loaderTimestamp } = Route.useLoaderData() + + return ( +
    +

    + React.cache Demo +

    +

    + React.cache memoizes function results within a single + server render. When you call a cached function multiple times with the + same arguments, React returns the cached result instead of running the + function again. +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + + {Server} + +
    + When to use React.cache: +
      +
    • + Fetching the same data in multiple components without prop drilling +
    • +
    • Expensive computations that may be called with same arguments
    • +
    • Database queries that might be duplicated across components
    • +
    • + Note: Cache is request-scoped - each request gets a fresh cache +
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-request-headers.tsx b/e2e/react-start/rsc/src/routes/rsc-request-headers.tsx new file mode 100644 index 0000000000..7ad201854d --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-request-headers.tsx @@ -0,0 +1,38 @@ +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { getRequestHeaders } from '@tanstack/react-start/server' +import { pageStyles } from '~/utils/styles' + +const getCookies = createServerFn({ + method: 'GET', +}).handler(async () => { + return getRequestHeaders().get('cookie') ?? '' +}) + +export const Route = createFileRoute('/rsc-request-headers')({ + loader: async () => { + const cookies = await getCookies() + + return { + cookies, + } + }, + component: RscRequestHeadersComponent, +}) + +function RscRequestHeadersComponent() { + const { cookies } = Route.useLoaderData() + + return ( +
    +

    + RSC Request Headers +

    +

    + A route loader calling a server function can read request headers in the + RSC environment. +

    +
    {cookies}
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-server-not-found.tsx b/e2e/react-start/rsc/src/routes/rsc-server-not-found.tsx new file mode 100644 index 0000000000..961a2828cc --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-server-not-found.tsx @@ -0,0 +1,50 @@ +import { Link, createFileRoute, notFound } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { pageStyles } from '~/utils/styles' + +const getMissingResource = createServerFn({ + method: 'GET', +}).handler(async () => { + throw notFound() +}) + +export const Route = createFileRoute('/rsc-server-not-found')({ + loader: async () => { + await getMissingResource() + }, + component: RscServerNotFoundComponent, + notFoundComponent: RscServerNotFoundBoundary, +}) + +function RscServerNotFoundComponent() { + return ( +
    +

    + RSC Server Not Found +

    +
    + ) +} + +function RscServerNotFoundBoundary() { + return ( +
    +

    + RSC Server Function Not Found +

    +

    + The server function threw `notFound()` and the route-level not found + boundary rendered instead of crashing. +

    + + Back home + +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-server-redirect.tsx b/e2e/react-start/rsc/src/routes/rsc-server-redirect.tsx new file mode 100644 index 0000000000..a8e14f6c93 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-server-redirect.tsx @@ -0,0 +1,26 @@ +import { createFileRoute, redirect } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { pageStyles } from '~/utils/styles' + +const redirectToBasic = createServerFn({ + method: 'GET', +}).handler(async () => { + throw redirect({ to: '/rsc-basic' }) +}) + +export const Route = createFileRoute('/rsc-server-redirect')({ + loader: async () => { + await redirectToBasic() + }, + component: RscServerRedirectComponent, +}) + +function RscServerRedirectComponent() { + return ( +
    +

    + RSC Server Redirect +

    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-slot-jsx-args.tsx b/e2e/react-start/rsc/src/routes/rsc-slot-jsx-args.tsx new file mode 100644 index 0000000000..025252e977 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-slot-jsx-args.tsx @@ -0,0 +1,106 @@ +import * as React from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { + CompositeComponent, + createCompositeComponent, +} from '@tanstack/react-start/rsc' +import { clientStyles, pageStyles } from '~/utils/styles' +import { + serverBadge, + serverBox, + serverHeader, + timestamp, +} from '~/utils/serverStyles' + +// ============================================================================ +// SLOT ARGS: Passing JSX as a slot argument +// ============================================================================ + +const getPromoServerComponent = createServerFn({ method: 'GET' }) + .inputValidator((data: { headline: string }) => data) + .handler(async ({ data }) => { + const serverTimestamp = Date.now() + + return createCompositeComponent( + (props: { + renderCta?: ( + cta: React.ReactElement, + meta: { campaignId: string }, + ) => React.ReactNode + }) => { + return ( +
    +
    + SERVER PROMO + + Fetched: {new Date(serverTimestamp).toLocaleTimeString()} + +
    + +

    {data.headline}

    +

    + Server renders the layout. Client renders the CTA. +

    + +
    + {props.renderCta?.( + Limited offer, + { campaignId: 'CMP-123' }, + )} +
    +
    + ) + }, + ) + }) + +export const Route = createFileRoute('/rsc-slot-jsx-args')({ + loader: async () => { + const Server = await getPromoServerComponent({ + data: { headline: 'Early Access Promotion' }, + }) + + return { Server } + }, + component: RscSlotJsxArgsPage, +}) + +function RscSlotJsxArgsPage() { + const { Server } = Route.useLoaderData() + + return ( +
    +

    Slot Args: JSX Element

    +

    + Server calls a client slot with a JSX element argument. The client slot + renders the element. +

    + + ( +
    +
    + CLIENT CTA +
    + +
    {cta}
    +
    + campaign: {meta.campaignId} +
    +
    + )} + /> +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-slots.tsx b/e2e/react-start/rsc/src/routes/rsc-slots.tsx new file mode 100644 index 0000000000..93277ef90d --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-slots.tsx @@ -0,0 +1,364 @@ +import * as React from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { + CompositeComponent, + createCompositeComponent, +} from '@tanstack/react-start/rsc' +import { clientStyles, formatTime, pageStyles } from '~/utils/styles' +import { + serverBadge, + serverBox, + serverHeader, + timestamp, +} from '~/utils/serverStyles' + +// ============================================================================ +// SLOTS: Dashboard Widget Container +// ============================================================================ + +const getSlottedServerComponent = createServerFn({ method: 'GET' }) + .inputValidator((data: { title: string }) => data) + .handler(async ({ data }) => { + const serverTimestamp = Date.now() + + // Simulate fetching dashboard metrics from server + const metrics = { + totalRevenue: 142580, + activeUsers: 8432, + conversionRate: 3.2, + } + + return createCompositeComponent( + (props: { + children?: React.ReactNode + renderFooter?: (data: { count: number }) => React.ReactNode + }) => { + return ( +
    +
    + SERVER LAYOUT + + Fetched: {new Date(serverTimestamp).toLocaleTimeString()} + +
    +

    + {data.title} +

    + + {/* Server-rendered metrics row */} +
    +
    +
    + Revenue +
    +
    + ${metrics.totalRevenue.toLocaleString()} +
    +
    +
    +
    + Users +
    +
    + {metrics.activeUsers.toLocaleString()} +
    +
    +
    +
    + Conversion +
    +
    + {metrics.conversionRate}% +
    +
    +
    + + {/* Client widgets slot */} +
    +
    + Interactive Widgets (Client Slot) +
    +
    {props.children}
    +
    + + {/* Footer render prop */} +
    + {props.renderFooter?.({ count: 42 })} +
    +
    + ) + }, + ) + }) + +export const Route = createFileRoute('/rsc-slots')({ + loader: async () => { + const Server = await getSlottedServerComponent({ + data: { title: 'Revenue Dashboard' }, + }) + return { + Server, + loaderTimestamp: Date.now(), + } + }, + component: RscSlotsComponent, + pendingComponent: () => { + console.log('[PENDING] /rsc-slots') + return <>Loading... + }, +}) + +function RscSlotsComponent() { + const { Server, loaderTimestamp } = Route.useLoaderData() + const [childText, setChildText] = React.useState('initial child') + const [footerMultiplier, setFooterMultiplier] = React.useState(1) + const [showExtraChild, setShowExtraChild] = React.useState(false) + + return ( +
    +

    + Dashboard with Interactive Widgets +

    +

    + The dashboard layout and metrics are server-rendered (blue), but the + widgets inside are client-interactive (green). Changing the widgets does + NOT refetch the server component - watch the server timestamp stay + constant! +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + + {/* Client Controls */} +
    +
    + CLIENT CONTROLS +
    +

    + Use these buttons to modify the slot content. The server layout won't + reload! +

    +
    + + + +
    +
    + + ( +
    + + Server provided count: {count} + + + Computed: {count * footerMultiplier} + +
    + )} + > + {/* Client widgets rendered inside server slot */} +
    +
    +
    + CLIENT WIDGET +
    + + {childText} + +
    + {showExtraChild && ( +
    +
    + EXTRA WIDGET +
    + + Extra widget visible! + +
    + )} +
    +
    + +
    + Key Points: +
      +
    • + Server layout (blue) contains slots for client content (green) +
    • +
    • Slots can be children or render props
    • +
    • Changing slot content doesn't refetch the server component
    • +
    • Server timestamp remains constant while widgets update
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-ssr-data-only.tsx b/e2e/react-start/rsc/src/routes/rsc-ssr-data-only.tsx new file mode 100644 index 0000000000..3bf5b74a73 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-ssr-data-only.tsx @@ -0,0 +1,402 @@ +import * as React from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { + createCompositeComponent, + CompositeComponent, +} from '@tanstack/react-start/rsc' +import { clientStyles, formatTime, pageStyles } from '~/utils/styles' +import { + serverBadge, + serverBox, + serverHeader, + timestamp, +} from '~/utils/serverStyles' + +// ============================================================================ +// SSR: 'data-only' - Analytics Dashboard with Browser-based Visualization +// The loader runs on the server, but the component renders on the client. +// This is useful when you need server data but client-only APIs for rendering. +// ============================================================================ + +const getAnalyticsServerComponent = createServerFn({ method: 'GET' }) + .inputValidator((data: { reportPeriod: string }) => data) + .handler(async ({ data }) => { + const serverTimestamp = Date.now() + + // Simulate fetching analytics from server database + const analytics = { + totalVisitors: 24583, + pageViews: 89421, + bounceRate: 34.2, + avgSessionDuration: '4m 32s', + topReferrers: [ + { source: 'Google', visits: 12450, percentage: 51 }, + { source: 'Twitter', visits: 5230, percentage: 21 }, + { source: 'Direct', visits: 4120, percentage: 17 }, + { source: 'LinkedIn', visits: 2783, percentage: 11 }, + ], + } + + // Create RSC with slots for client-side visualization + const AnalyticsDashboard = await createCompositeComponent( + (props: { + children?: React.ReactNode + renderVisualization?: (data: { + values: Array<{ label: string; value: number }> + }) => React.ReactNode + }) => { + return ( +
    +
    + SERVER DATA + + Fetched: {new Date(serverTimestamp).toLocaleTimeString()} + +
    + +

    + Analytics Report: {data.reportPeriod} +

    + +

    + Data fetched on server, visualization rendered on client using + browser APIs (window dimensions for responsive charts). +

    + + {/* Server-rendered metrics summary */} +
    +
    +
    + Total Visitors +
    +
    + {analytics.totalVisitors.toLocaleString()} +
    +
    +
    +
    + Page Views +
    +
    + {analytics.pageViews.toLocaleString()} +
    +
    +
    + + {/* Slot for client-side visualization */} +
    +
    + REFERRER VISUALIZATION (Client Rendered) +
    + {props.renderVisualization?.({ + values: analytics.topReferrers.map((r) => ({ + label: r.source, + value: r.percentage, + })), + })} +
    + + {/* Slot for additional client content */} + {props.children && ( +
    + {props.children} +
    + )} +
    + ) + }, + ) + + return { + AnalyticsDashboard, + analytics, + serverTimestamp, + reportPeriod: data.reportPeriod, + } + }) + +export const Route = createFileRoute('/rsc-ssr-data-only')({ + ssr: 'data-only', + loader: async () => { + const bundle = await getAnalyticsServerComponent({ + data: { reportPeriod: 'Last 7 Days' }, + }) + return { + ...bundle, + loaderTimestamp: Date.now(), + } + }, + pendingComponent: () => ( +
    +
    +
    📊
    +
    + Loading Analytics Dashboard... +
    +
    + Server data loaded, rendering visualization... +
    +
    +
    + ), + component: RscSsrDataOnlyComponent, +}) + +function RscSsrDataOnlyComponent() { + const { AnalyticsDashboard, analytics, serverTimestamp, loaderTimestamp } = + Route.useLoaderData() + + // Browser-only state for responsive visualization + const [windowWidth, setWindowWidth] = React.useState(null) + const [selectedReferrer, setSelectedReferrer] = React.useState( + null, + ) + + // Use browser API (window) - only available on client + React.useEffect(() => { + setWindowWidth(window.innerWidth) + + const handleResize = () => setWindowWidth(window.innerWidth) + window.addEventListener('resize', handleResize) + return () => window.removeEventListener('resize', handleResize) + }, []) + + // Calculate bar width based on window size + const maxBarWidth = windowWidth ? Math.min(windowWidth - 100, 400) : 300 + + return ( +
    +

    + Analytics Dashboard (SSR: data-only) +

    +

    + This example uses ssr: 'data-only' - the loader runs on the + server to fetch both the React Server Component and its analytics data, + but the route component renders on the client. This allows using browser + APIs like window.innerWidth for responsive chart + visualization while still benefiting from server-side data fetching. +

    + +
    + + {loaderTimestamp} + + + {serverTimestamp} + + Server data fetched at: {formatTime(serverTimestamp)} +
    + + + }) => ( +
    +
    + CLIENT RENDERED + + Window: {windowWidth ?? 'measuring...'}px + +
    + + {/* Responsive bar chart using browser dimensions */} +
    + {values.map((item) => ( +
    setSelectedReferrer(item.label)} + style={{ + display: 'flex', + alignItems: 'center', + gap: '12px', + marginBottom: '8px', + cursor: 'pointer', + padding: '8px', + borderRadius: '6px', + backgroundColor: + selectedReferrer === item.label + ? '#bbf7d0' + : 'transparent', + transition: 'background-color 0.2s', + }} + > +
    + {item.label} +
    +
    +
    + {item.value}% +
    +
    + ))} +
    + + {selectedReferrer && ( +
    + Selected: {selectedReferrer} -{' '} + {analytics.topReferrers + .find((r) => r.source === selectedReferrer) + ?.visits.toLocaleString()}{' '} + visits +
    + )} +
    + )} + > + {/* Additional client content in children slot */} +
    +
    + CLIENT INTERACTIVE +
    +

    + Click a referrer bar above to see details. The bars resize + responsively based on your browser window width. +

    + +
    + + +
    + Key Points: +
      +
    • + ssr: 'data-only' runs the loader on server but skips + SSR of the route component +
    • +
    • + The loader fetches both the RSC (blue) and its data on the server - + both are "data" from the loader's perspective +
    • +
    • + Client visualization (green) uses window.innerWidth for + responsive charts +
    • +
    • The pendingComponent shows briefly while the client hydrates
    • +
    • + RSC content is cached - changing selections doesn't refetch server + data +
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-ssr-false.tsx b/e2e/react-start/rsc/src/routes/rsc-ssr-false.tsx new file mode 100644 index 0000000000..1f81248f87 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-ssr-false.tsx @@ -0,0 +1,677 @@ +import * as React from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { + createCompositeComponent, + CompositeComponent, +} from '@tanstack/react-start/rsc' +import { clientStyles, formatTime, pageStyles } from '~/utils/styles' +import { + serverBadge, + serverBox, + serverHeader, + timestamp, +} from '~/utils/serverStyles' + +// ============================================================================ +// SSR: false - Drawing Canvas with localStorage Persistence +// Both the loader AND the component run on the client only. +// This is useful when you need browser-only APIs in both loader and component. +// ============================================================================ + +const getDrawingToolsServerComponent = createServerFn({ method: 'GET' }) + .inputValidator( + (data: { savedDrawingName?: string; lastColor?: string }) => data, + ) + .handler(async ({ data }) => { + const serverTimestamp = Date.now() + + // Drawing tools configuration from server + const tools = { + brushSizes: [2, 5, 10, 20], + colors: [ + { name: 'Black', value: '#1e293b' }, + { name: 'Blue', value: '#0284c7' }, + { name: 'Green', value: '#16a34a' }, + { name: 'Red', value: '#dc2626' }, + { name: 'Purple', value: '#9333ea' }, + ], + canvasSize: { width: 400, height: 200 }, + } + + // Create RSC for the toolbar with a slot for the canvas + const DrawingToolbar = await createCompositeComponent( + (props: { + renderCanvas?: () => React.ReactNode + children?: React.ReactNode + }) => { + return ( +
    +
    + SERVER TOOLS CONFIG + + Loaded: {new Date(serverTimestamp).toLocaleTimeString()} + +
    + +

    + Drawing Canvas +

    + +

    + Tools configuration fetched from server. Canvas and localStorage + handled on client. +

    + + {data.savedDrawingName && ( +
    + Loaded drawing: {data.savedDrawingName} +
    + )} + + {data.lastColor && ( +
    + Last used color: + + {data.lastColor} +
    + )} + + {/* Tool palette info (server-rendered) */} +
    +
    +
    + Available Brushes +
    +
    + {tools.brushSizes.length} sizes +
    +
    +
    +
    + Color Palette +
    +
    + {tools.colors.length} colors +
    +
    +
    +
    + Canvas Size +
    +
    + {tools.canvasSize.width}x{tools.canvasSize.height} +
    +
    +
    + + {/* Canvas slot (client-rendered) */} +
    +
    + DRAWING AREA (Client Rendered with Canvas API) +
    + {props.renderCanvas?.()} +
    + + {/* Children slot for additional controls */} + {props.children && ( +
    + {props.children} +
    + )} +
    + ) + }, + ) + + return { + DrawingToolbar, + tools, + serverTimestamp, + savedDrawingName: data.savedDrawingName, + } + }) + +export const Route = createFileRoute('/rsc-ssr-false')({ + ssr: false, + loader: async () => { + // Read from localStorage - only available on client + // Since ssr: false, this loader runs on client only + const savedDrawingName = localStorage.getItem('drawing-name') || undefined + const lastColor = localStorage.getItem('drawing-last-color') || undefined + const savedStrokeCount = localStorage.getItem('drawing-stroke-count') + const hasSavedDrawing = !!localStorage.getItem('drawing-canvas-data') + + const bundle = await getDrawingToolsServerComponent({ + data: { savedDrawingName, lastColor }, + }) + + return { + ...bundle, + lastColor, + savedStrokeCount: savedStrokeCount ? parseInt(savedStrokeCount, 10) : 0, + hasSavedDrawing, + loaderTimestamp: Date.now(), + } + }, + pendingComponent: () => ( +
    +
    +
    🎨
    +
    + Setting up Drawing Canvas... +
    +
    + Loading tools and restoring your saved drawing... +
    +
    +
    + ), + component: RscSsrFalseComponent, +}) + +function RscSsrFalseComponent() { + const { + DrawingToolbar, + tools, + serverTimestamp, + loaderTimestamp, + savedDrawingName, + lastColor, + savedStrokeCount, + hasSavedDrawing, + } = Route.useLoaderData() + + const canvasRef = React.useRef(null) + const hasMounted = React.useRef(false) + const isDrawingRef = React.useRef(false) + const [isDrawing, setIsDrawing] = React.useState(false) + const [brushSize, setBrushSize] = React.useState(tools.brushSizes[1]) + // Initialize color from localStorage if available, otherwise use default + const [color, setColor] = React.useState(lastColor || tools.colors[0].value) + const [drawingName, setDrawingName] = React.useState( + savedDrawingName || 'Untitled', + ) + // Initialize stroke count from localStorage + const [strokeCount, setStrokeCount] = React.useState(savedStrokeCount) + // Initialize based on whether there was saved drawing data + const [hasRestoredDrawing, setHasRestoredDrawing] = + React.useState(hasSavedDrawing) + + // Initialize canvas and restore saved drawing + React.useEffect(() => { + const canvas = canvasRef.current + if (!canvas) return + + const ctx = canvas.getContext('2d') + if (!ctx) return + + // Mark as mounted at the start of the effect + hasMounted.current = true + + // Set white background first + ctx.fillStyle = '#ffffff' + ctx.fillRect(0, 0, canvas.width, canvas.height) + + // Try to restore saved drawing from localStorage + const savedDrawingData = localStorage.getItem('drawing-canvas-data') + if (savedDrawingData) { + const img = new Image() + img.onload = () => { + ctx.drawImage(img, 0, 0) + } + img.src = savedDrawingData + } + }, []) + + // Save color to localStorage when it changes (but not on initial mount) + React.useEffect(() => { + if (hasMounted.current) { + localStorage.setItem('drawing-last-color', color) + } + }, [color]) + + // Helper to save canvas to localStorage + const saveCanvasToStorage = React.useCallback(() => { + const canvas = canvasRef.current + if (!canvas) return + + try { + const dataUrl = canvas.toDataURL('image/png') + localStorage.setItem('drawing-canvas-data', dataUrl) + } catch { + // Canvas might be tainted or localStorage full + console.warn('Could not save canvas to localStorage') + } + }, []) + + const startDrawing = (e: React.MouseEvent) => { + const canvas = canvasRef.current + if (!canvas) return + + isDrawingRef.current = true + setIsDrawing(true) + const rect = canvas.getBoundingClientRect() + const ctx = canvas.getContext('2d') + if (!ctx) return + + ctx.beginPath() + ctx.moveTo(e.clientX - rect.left, e.clientY - rect.top) + } + + const draw = (e: React.MouseEvent) => { + if (!isDrawingRef.current) return + + const canvas = canvasRef.current + if (!canvas) return + + const rect = canvas.getBoundingClientRect() + const ctx = canvas.getContext('2d') + if (!ctx) return + + ctx.lineTo(e.clientX - rect.left, e.clientY - rect.top) + ctx.strokeStyle = color + ctx.lineWidth = brushSize + ctx.lineCap = 'round' + ctx.stroke() + } + + const stopDrawing = () => { + if (isDrawingRef.current) { + isDrawingRef.current = false + setStrokeCount((c) => { + const newCount = c + 1 + // Save stroke count to localStorage + localStorage.setItem('drawing-stroke-count', String(newCount)) + return newCount + }) + // Auto-save drawing after each stroke + saveCanvasToStorage() + } + setIsDrawing(false) + } + + const clearCanvas = () => { + const canvas = canvasRef.current + if (!canvas) return + + const ctx = canvas.getContext('2d') + if (!ctx) return + + ctx.fillStyle = '#ffffff' + ctx.fillRect(0, 0, canvas.width, canvas.height) + setStrokeCount(0) + setHasRestoredDrawing(false) + // Clear saved drawing and stroke count from localStorage + localStorage.removeItem('drawing-canvas-data') + localStorage.removeItem('drawing-stroke-count') + } + + const saveDrawing = () => { + localStorage.setItem('drawing-name', drawingName) + setDrawingName(drawingName) + } + + return ( +
    +

    + Drawing Canvas (SSR: false) +

    +

    + This example uses ssr: false - both the loader AND the + route component run on the client only. The loader reads from{' '} + localStorage to get your saved drawing name and last color, + then passes this data to the server function which returns the RSC with + that info embedded. Your drawing is auto-saved after each stroke - all + using browser APIs not available during SSR. +

    + +
    + + {loaderTimestamp} + + + {serverTimestamp} + + Tools loaded at: {formatTime(serverTimestamp)} +
    + + ( +
    +
    + CLIENT CANVAS + + Strokes: {strokeCount} + {hasRestoredDrawing && ( + + (Restored from localStorage) + + )} + +
    + + {/* Tool controls */} +
    + {/* Brush size selector */} +
    +
    + Brush Size +
    +
    + {tools.brushSizes.map((size) => ( + + ))} +
    +
    + + {/* Color selector */} +
    +
    + Color +
    +
    + {tools.colors.map((c) => ( +
    +
    +
    + + {/* Canvas */} + + + {/* Canvas actions */} +
    + +
    +
    + )} + > + {/* Save controls in children slot */} +
    +
    + LOCALSTORAGE PERSISTENCE +
    + +
    + setDrawingName(e.target.value)} + placeholder="Drawing name" + style={{ + padding: '8px 12px', + border: '1px solid #bbf7d0', + borderRadius: '4px', + flex: 1, + }} + /> + +
    + +
    + Current name:{' '} + {drawingName} + {savedDrawingName && (loaded from localStorage)} +
    +
    +
    + +
    + Key Points: +
      +
    • + ssr: false runs both loader and route component on + client only +
    • +
    • + The loader reads localStorage for saved name/color, + then passes this to the server function to fetch the RSC +
    • +
    • + The RSC (blue) displays the localStorage data that was passed from + the client loader +
    • +
    • + The drawing and stroke count are auto-saved to{' '} + localStorage after each stroke +
    • +
    • + The route component uses Canvas API for drawing (browser-only) +
    • +
    • + The pendingComponent shows while everything initializes on the + client +
    • +
    • Changing colors/brushes doesn't refetch - RSC data is cached
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-stream-generator.tsx b/e2e/react-start/rsc/src/routes/rsc-stream-generator.tsx new file mode 100644 index 0000000000..69473625b1 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-stream-generator.tsx @@ -0,0 +1,299 @@ +import * as React from 'react' +import { createFileRoute, useHydrated } from '@tanstack/react-router' +import { CompositeComponent } from '@tanstack/react-start/rsc' +import { streamNotificationsGenerator } from '~/utils/streamingServerComponents' +import { + pageStyles, + clientStyles, + serverStyles, + asyncStyles, + formatTime, +} from '~/utils/styles' + +export const Route = createFileRoute('/rsc-stream-generator')({ + component: RscStreamGeneratorComponent, + pendingComponent: () => { + console.log('[PENDING] /rsc-stream-generator') + return <>Loading... + }, +}) + +// eslint-disable-next-line @typescript-eslint/no-explicit-any +type NotificationRSC = any + +function RscStreamGeneratorComponent() { + const hydrated = useHydrated() + const [notifications, setNotifications] = React.useState< + Array + >([]) + const [isStreaming, setIsStreaming] = React.useState(false) + const [streamComplete, setStreamComplete] = React.useState(false) + const [dismissedIds, setDismissedIds] = React.useState>(new Set()) + const [startTime, setStartTime] = React.useState(null) + + const startStreaming = React.useCallback(async () => { + setNotifications([]) + setIsStreaming(true) + setStreamComplete(false) + setDismissedIds(new Set()) + setStartTime(Date.now()) + + try { + const generator = await streamNotificationsGenerator({ + data: { initialCount: 3, streamCount: 4, delayMs: 800 }, + }) + + for await (const notification of generator) { + setNotifications((prev) => [...prev, notification as NotificationRSC]) + } + } finally { + setIsStreaming(false) + setStreamComplete(true) + } + }, []) + + const toggleDismissed = React.useCallback((id: string) => { + setDismissedIds((prev) => { + const next = new Set(prev) + if (next.has(id)) { + next.delete(id) + } else { + next.add(id) + } + return next + }) + }, []) + + const visibleNotifications = notifications.filter( + (_, index) => !dismissedIds.has(`notif_${index}`), + ) + + return ( +
    +

    + Streaming RSCs - Async Generator Pattern +

    +

    + This demonstrates streaming individual React Server Components from the + server using an async generator function. This pattern provides cleaner + syntax with for-await-of loops. Each notification is a complete RSC with + interactive client slots. +

    + +
    + {startTime && ( + + Stream started at: {formatTime(startTime)} + + )} +
    + + {/* Legend */} +
    +
    + + Server Component (RSC) +
    +
    + + Client Interactive +
    +
    + + Streaming +
    +
    + + {/* Controls */} +
    +
    + CLIENT CONTROLS +
    +

    + Click the button to start streaming notifications using an async + generator. The code uses a clean for-await-of loop pattern. +

    + +
    + + {/* Streaming Status */} + {isStreaming && ( +
    +
    + STREAMING + + Received {notifications.length} notification(s)... + +
    +
    +
    +
    +
    + )} + + {/* Stream Complete Status */} + {streamComplete && !isStreaming && ( +
    + + COMPLETE + + + Stream finished! Received {notifications.length} notifications. + {dismissedIds.size > 0 && ` (${dismissedIds.size} dismissed)`} + +
    + )} + + {/* Notification List */} +
    + {notifications.map((notificationSrc, index) => { + const id = `notif_${index}` + const isDismissed = dismissedIds.has(id) + + return ( +
    + ( +
    + + CLIENT ACTIONS + + + {isDismissed && ( + + Dismissed + + )} + + ID: {notifId} + +
    + )} + /> +
    + ) + })} +
    + + {/* Empty State */} + {notifications.length === 0 && !isStreaming && ( +
    +
    📭
    +
    + No notifications yet. Click the button above to start streaming! +
    +
    + )} + +
    + Key Points: +
      +
    • Uses async generator function (async function*)
    • +
    • Cleaner consumption with for-await-of loop
    • +
    • Each notification is a complete RSC with server data
    • +
    • Client slots provide dismiss/restore functionality
    • +
    • First 3 notifications arrive immediately (batched)
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-stream-loader.tsx b/e2e/react-start/rsc/src/routes/rsc-stream-loader.tsx new file mode 100644 index 0000000000..8c833b8278 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-stream-loader.tsx @@ -0,0 +1,267 @@ +import * as React from 'react' +import { createFileRoute, useHydrated } from '@tanstack/react-router' +import { CompositeComponent } from '@tanstack/react-start/rsc' +import { streamNotificationsGenerator } from '~/utils/streamingServerComponents' +import { + asyncStyles, + clientStyles, + formatTime, + pageStyles, + serverStyles, +} from '~/utils/styles' + +export const Route = createFileRoute('/rsc-stream-loader')({ + loader: async () => { + // Return the generator directly - don't await it! + // The component will consume the stream progressively + const notificationStream = await streamNotificationsGenerator({ + data: { initialCount: 3, streamCount: 4, delayMs: 500 }, + }) + + return { + notificationStream, + loaderTimestamp: Date.now(), + } + }, + component: RscStreamLoaderComponent, + pendingComponent: () => { + console.log('[PENDING] /rsc-stream-loader') + return <>Loading... + }, +}) + +type NotificationRSC = any + +function RscStreamLoaderComponent() { + const { notificationStream, loaderTimestamp } = Route.useLoaderData() + const hydrated = useHydrated() + const [notifications, setNotifications] = React.useState< + Array + >([]) + const [isStreaming, setIsStreaming] = React.useState(true) + const [expandedIds, setExpandedIds] = React.useState>(new Set()) + const streamStartedRef = React.useRef(false) + + // Consume the stream in the component + React.useEffect(() => { + // Prevent double-execution in strict mode + if (streamStartedRef.current) return + streamStartedRef.current = true + + async function consumeStream() { + try { + for await (const notification of notificationStream) { + setNotifications((prev) => [...prev, notification]) + } + } finally { + setIsStreaming(false) + } + } + + consumeStream() + }, [notificationStream]) + + const toggleExpanded = React.useCallback((id: string) => { + setExpandedIds((prev) => { + const next = new Set(prev) + if (next.has(id)) { + next.delete(id) + } else { + next.add(id) + } + return next + }) + }, []) + + return ( +
    +

    + Streaming RSCs via Loader +

    +

    + This page demonstrates RSC streaming where the stream is initiated in + the route loader but consumed progressively in the component. Watch as + notifications appear one by one without any button click! This works for + both SSR and client-side navigation. +

    + + {/* Timing info */} +
    +
    + LOADER INFO +
    +
    +
    + + {loaderTimestamp} + + Loader executed at: {formatTime(loaderTimestamp)} +
    +
    + Stream returned from loader, consumed progressively in component +
    +
    +
    + + {/* Legend */} +
    +
    + + Server Component (RSC) +
    +
    + + Client Interactive +
    +
    + + {/* Streaming Status */} + {isStreaming && ( +
    +
    + STREAMING + + Received {notifications.length} notification(s)... + +
    +
    +
    +
    +
    + )} + + {/* Stream Complete Status */} + {!isStreaming && ( +
    + COMPLETE + + Stream finished! Received {notifications.length} notifications. + +
    + )} + + {/* Notification List */} +
    + {notifications.map((notificationSrc, index) => ( + ( +
    + + CLIENT ACTIONS + + + {expandedIds.has(id) && ( + + Expanded view for {id} + + )} +
    + )} + /> + ))} +
    + + {/* Empty State during initial load */} + {notifications.length === 0 && isStreaming && ( +
    +
    ⏳
    +
    Waiting for first notification to stream in...
    +
    + )} + +
    + Key Points: +
      +
    • Stream is returned from loader, not awaited
    • +
    • Component consumes stream progressively in useEffect
    • +
    • Notifications appear one by one as they arrive
    • +
    • No button click needed - streaming starts automatically
    • +
    • Works for both SSR and client-side navigation
    • +
    • Client slots still work on each streamed RSC
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-stream-readable.tsx b/e2e/react-start/rsc/src/routes/rsc-stream-readable.tsx new file mode 100644 index 0000000000..7e6260707f --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-stream-readable.tsx @@ -0,0 +1,279 @@ +import * as React from 'react' +import { createFileRoute, useHydrated } from '@tanstack/react-router' +import { CompositeComponent } from '@tanstack/react-start/rsc' +import { streamNotificationsReadable } from '~/utils/streamingServerComponents' +import { + pageStyles, + clientStyles, + serverStyles, + asyncStyles, + formatTime, +} from '~/utils/styles' + +export const Route = createFileRoute('/rsc-stream-readable')({ + component: RscStreamReadableComponent, + pendingComponent: () => { + console.log('[PENDING] /rsc-stream-readable') + return <>Loading... + }, +}) + +// eslint-disable-next-line @typescript-eslint/no-explicit-any +type NotificationRSC = any + +function RscStreamReadableComponent() { + const hydrated = useHydrated() + const [notifications, setNotifications] = React.useState< + Array + >([]) + const [isStreaming, setIsStreaming] = React.useState(false) + const [streamComplete, setStreamComplete] = React.useState(false) + const [expandedIds, setExpandedIds] = React.useState>(new Set()) + const [startTime, setStartTime] = React.useState(null) + + const startStreaming = React.useCallback(async () => { + setNotifications([]) + setIsStreaming(true) + setStreamComplete(false) + setExpandedIds(new Set()) + setStartTime(Date.now()) + + try { + const stream = await streamNotificationsReadable({ + data: { initialCount: 3, streamCount: 4, delayMs: 800 }, + }) + + if (!stream) return + + const reader = stream.getReader() + let done = false + + while (!done) { + const result = await reader.read() + done = result.done + if (result.value) { + setNotifications((prev) => [...prev, result.value as NotificationRSC]) + } + } + } finally { + setIsStreaming(false) + setStreamComplete(true) + } + }, []) + + const toggleExpanded = React.useCallback((id: string) => { + setExpandedIds((prev) => { + const next = new Set(prev) + if (next.has(id)) { + next.delete(id) + } else { + next.add(id) + } + return next + }) + }, []) + + return ( +
    +

    + Streaming RSCs - ReadableStream Pattern +

    +

    + This demonstrates streaming individual React Server Components from the + server using a ReadableStream. The first 3 notifications arrive + immediately, then additional notifications stream in one by one. Each + notification is a complete RSC with its own server-side data fetching. +

    + +
    + {startTime && ( + + Stream started at: {formatTime(startTime)} + + )} +
    + + {/* Legend */} +
    +
    + + Server Component (RSC) +
    +
    + + Client Interactive +
    +
    + + Streaming +
    +
    + + {/* Controls */} +
    +
    + CLIENT CONTROLS +
    +

    + Click the button to start streaming notifications from the server. + Each notification is a separate RSC that streams in independently. +

    + +
    + + {/* Streaming Status */} + {isStreaming && ( +
    +
    + STREAMING + + Received {notifications.length} notification(s)... + +
    +
    +
    +
    +
    + )} + + {/* Stream Complete Status */} + {streamComplete && !isStreaming && ( +
    + + COMPLETE + + + Stream finished! Received {notifications.length} notifications. + +
    + )} + + {/* Notification List */} +
    + {notifications.map((notificationSrc, index) => ( + ( +
    + + CLIENT ACTIONS + + + {expandedIds.has(id) && ( + + Expanded view for {id} + + )} +
    + )} + /> + ))} +
    + + {/* Empty State */} + {notifications.length === 0 && !isStreaming && ( +
    +
    📭
    +
    + No notifications yet. Click the button above to start streaming! +
    +
    + )} + +
    + Key Points: +
      +
    • Each notification is a complete RSC streamed individually
    • +
    • First 3 notifications arrive immediately (batched)
    • +
    • Additional notifications stream in with 800ms delays
    • +
    • Client slots (actions) work on each streamed RSC
    • +
    • Uses ReadableStream pattern for typed streaming
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-streaming.tsx b/e2e/react-start/rsc/src/routes/rsc-streaming.tsx new file mode 100644 index 0000000000..fc1dfad927 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-streaming.tsx @@ -0,0 +1,247 @@ +import { createFileRoute, Link } from '@tanstack/react-router' +import { pageStyles, colors } from '~/utils/styles' + +export const Route = createFileRoute('/rsc-streaming')({ + component: RscStreamingComponent, + pendingComponent: () => { + console.log('[PENDING] /rsc-streaming') + return <>Loading... + }, +}) + +const streamingExamples = [ + { + path: '/rsc-stream-readable', + title: 'ReadableStream Pattern', + description: + 'Stream RSCs using the ReadableStream API. Click a button to start streaming notifications from the server. Uses reader.read() loop pattern.', + icon: '📖', + pattern: 'ReadableStream + reader.read()', + }, + { + path: '/rsc-stream-generator', + title: 'Async Generator Pattern', + description: + 'Stream RSCs using async generator functions. Cleaner syntax with for-await-of loops. Same result, more readable code.', + icon: '🔄', + pattern: 'async function* + for-await-of', + }, + { + path: '/rsc-stream-loader', + title: 'Loader Streaming', + description: + 'Stream RSCs from the route loader. The stream is returned from the loader and consumed progressively in the component - works for both SSR and client-side navigation.', + icon: '📦', + pattern: 'loader + for-await-of', + }, +] + +function RscStreamingComponent() { + return ( +
    +
    + + ← Back to all examples + +
    + +

    + RSC Streaming Examples +

    +

    + These examples demonstrate how to stream individual React Server + Components from the server to the client. Each notification in the feed + is a complete RSC that arrives independently, allowing for progressive + rendering. +

    + + {/* Color Legend */} +
    +
    + + + Server Component (RSC) - Each notification is a complete RSC + +
    +
    + + + Client Interactive - Expand/collapse, dismiss actions + +
    +
    + + + Streaming - Components arriving from server + +
    +
    + + {/* Code Pattern Overview */} +
    +

    + Streaming Patterns +

    +

    + TanStack Start supports streaming data from server functions using two + patterns: +

    +
    +
    +
    + ReadableStream +
    + + new ReadableStream({'{'} start(controller) {'}'}) + +
    +
    +
    + Async Generator +
    + + async function*() {'{'} yield rsc {'}'} + +
    +
    +
    + + {/* Examples Grid */} +
    + {streamingExamples.map((example) => ( + +
    + {example.icon} +
    +
    + {example.title} +
    +
    + {example.pattern} +
    +
    + {example.description} +
    + + ))} +
    + +
    + Key Concepts: +
      +
    • Each streamed item is a complete React Server Component
    • +
    • RSCs can have client slots for interactivity
    • +
    • First batch arrives immediately, rest streams with delays
    • +
    • Both ReadableStream and async generator patterns are typed
    • +
    • SSR streaming collects all RSCs before rendering
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-suspense.tsx b/e2e/react-start/rsc/src/routes/rsc-suspense.tsx new file mode 100644 index 0000000000..a08efc8685 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-suspense.tsx @@ -0,0 +1,330 @@ +import { Suspense } from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { renderServerComponent } from '@tanstack/react-start/rsc' +import { + serverBox, + serverBadge, + serverHeader, + timestamp, +} from '~/utils/serverStyles' +import { pageStyles, asyncStyles, formatTime } from '~/utils/styles' + +// ============================================================================ +// Server Component Definitions +// ============================================================================ + +async function fetchSlowData( + label: string, + delay: number, +): Promise<{ label: string; value: number; trend: string }> { + await new Promise((resolve) => setTimeout(resolve, delay)) + return { + label, + value: Math.floor(Math.random() * 10000), + trend: Math.random() > 0.5 ? '+12.5%' : '-3.2%', + } +} + +function MetricLoading({ label }: { label: string }) { + return ( +
    +
    + {label} +
    +
    + Loading... +
    +
    + Streaming from server... +
    +
    + ) +} + +async function AsyncMetric({ label, delay }: { label: string; delay: number }) { + const data = await fetchSlowData(label, delay) + const isPositive = data.trend.startsWith('+') + + return ( +
    +
    + {data.label} +
    +
    + {data.value.toLocaleString()} +
    +
    + {data.trend} from last period +
    +
    + Loaded after {delay}ms +
    +
    + ) +} + +const getSuspenseServerComponent = createServerFn({ method: 'GET' }) + .inputValidator((data: { delay?: number }) => data) + .handler(async ({ data }) => { + const serverTimestamp = Date.now() + const delay = data.delay ?? 100 + + return renderServerComponent( +
    +
    + ASYNC METRIC + + Started: {new Date(serverTimestamp).toLocaleTimeString()} + +
    + }> + + +
    , + ) + }) + +const getMultiSuspenseServerComponent = createServerFn({ + method: 'GET', +}).handler(async () => { + const serverTimestamp = Date.now() + + return renderServerComponent( +
    +
    + ANALYTICS DASHBOARD + + Started: {new Date(serverTimestamp).toLocaleTimeString()} + +
    +

    + Watch the metrics load progressively. Each card fetches data + independently. +

    +
    +
    + }> + + +
    +
    + }> + + +
    +
    + }> + + +
    +
    + } + > + + +
    +
    +
    , + ) +}) + +export const Route = createFileRoute('/rsc-suspense')({ + loader: async () => { + // Load RSC with longer delays for better visualization + const [SuspenseServer, MultiSuspenseServer] = await Promise.all([ + getSuspenseServerComponent({ data: { delay: 2000 } }), + getMultiSuspenseServerComponent(), + ]) + return { + SuspenseServer, + MultiSuspenseServer, + loaderTimestamp: Date.now(), + } + }, + component: RscSuspenseComponent, +}) + +function LoadingCard({ label }: { label: string }) { + return ( +
    +
    + LOADING + {label} +
    +
    +
    +
    +
    + Streaming from server... +
    +
    + ) +} + +function RscSuspenseComponent() { + const { SuspenseServer, MultiSuspenseServer, loaderTimestamp } = + Route.useLoaderData() + + return ( +
    +

    + Analytics Dashboard - Async Loading +

    +

    + This demonstrates RSC with async data fetching. Each metric card has a + different delay (0.5s to 3.5s) to show how RSC streams content + progressively. Watch the amber loading states transform into blue + completed states! +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + + {/* Legend for loading states */} +
    +
    + + Loading (streaming) +
    +
    + + Loaded (server data) +
    +
    + +
    +

    + Single Async Metric (2 second delay) +

    + } + > + {SuspenseServer} + +
    + +
    +

    + Dashboard Grid (Multiple delays: 0.5s, 1.5s, 2.5s, 3.5s) +

    +

    + Each card loads independently. Notice how they appear one by one as + their data becomes available from the server. +

    + + + + + +
    + } + > + {MultiSuspenseServer} + + + +
    + Key Points: +
      +
    • Async RSCs can fetch data on the server with different delays
    • +
    • Suspense boundaries show loading states while streaming
    • +
    • Content appears progressively as data becomes available
    • +
    • + The delays in this demo are intentionally long (0.5s-3.5s) for + visibility +
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-tree.tsx b/e2e/react-start/rsc/src/routes/rsc-tree.tsx new file mode 100644 index 0000000000..4678774224 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-tree.tsx @@ -0,0 +1,381 @@ +import * as React from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { + CompositeComponent, + createCompositeComponent, +} from '@tanstack/react-start/rsc' +import { + serverBox, + serverBadge, + serverHeader, + timestamp, +} from '~/utils/serverStyles' +import { pageStyles, clientStyles, formatTime } from '~/utils/styles' + +// ============================================================================ +// Server Component Definition +// ============================================================================ + +const getTreeServerComponent = createServerFn({ method: 'GET' }).handler( + async () => { + const serverTimestamp = Date.now() + const instanceId = Math.random().toString(36).slice(2, 8) + + const comment = { + author: 'Alex Thompson', + avatar: 'AT', + time: '2 hours ago', + content: + 'This is a great example of how RSC can be restructured in the DOM without losing its identity. The server timestamp stays the same even when moved!', + likes: 24, + } + + return createCompositeComponent( + (props: { renderPosition?: () => React.ReactNode }) => { + return ( +
    +
    + SERVER COMMENT + + {new Date(serverTimestamp).toLocaleTimeString()} + +
    + +
    +
    + {comment.avatar} +
    +
    +
    + + {comment.author} + + + {comment.time} + +
    +

    + {comment.content} +

    +
    + ♥ {comment.likes} likes + + ID: {instanceId} + +
    +
    +
    + + {/* Position indicator from client */} +
    + Current position: {props.renderPosition?.()} +
    +
    + ) + }, + ) + }, +) + +export const Route = createFileRoute('/rsc-tree')({ + loader: async () => { + const Server = await getTreeServerComponent() + return { + Server, + loaderTimestamp: Date.now(), + } + }, + component: RscTreeComponent, + pendingComponent: () => { + console.log('[PENDING] /rsc-tree') + return <>Loading... + }, +}) + +function RscTreeComponent() { + const { Server, loaderTimestamp } = Route.useLoaderData() + const [parentType, setParentType] = React.useState< + 'div' | 'section' | 'article' + >('div') + const [wrapperCount, setWrapperCount] = React.useState(0) + const [position, setPosition] = React.useState<'top' | 'bottom'>('top') + + // Wrap the RSC in different numbers of divs + const wrapRsc = (rsc: React.ReactNode, count: number): React.ReactNode => { + if (count <= 0) return rsc + return ( +
    +
    + Wrapper Level {count} +
    + {wrapRsc(rsc, count - 1)} +
    + ) + } + + const Parent = parentType + + const serverComponent = ( + ( + + {`<${parentType}> with ${wrapperCount} wrapper(s) at ${position}`} + + )} + /> + ) + + return ( +
    +

    + Comment Thread - Tree Restructuring +

    +

    + This RSC can be moved around the DOM tree without losing its identity. + Change the parent element, add wrapper divs, or move it - the server + timestamp and instance ID stay the same! +

    + +
    + + {loaderTimestamp} + + Route loaded at: {formatTime(loaderTimestamp)} +
    + + {/* Client Controls */} +
    +
    + CLIENT CONTROLS +
    + +
    +
    + Parent Element Type +
    +
    + {(['div', 'section', 'article'] as const).map((type) => ( + + ))} +
    +
    + +
    +
    + Wrapper Depth: {wrapperCount} +
    +
    + + +
    +
    + +
    +
    + Position +
    +
    + + +
    +
    + + {/* Hidden test elements */} + + {parentType} + + + {wrapperCount} + +
    + + {/* RSC Container */} + +
    + Current parent: <{parentType}> +
    + + {position === 'top' && wrapRsc(serverComponent, wrapperCount)} + +
    + This is a client-rendered placeholder between positions. The RSC is + currently at the {position}. +
    + + {position === 'bottom' && wrapRsc(serverComponent, wrapperCount)} +
    + +
    + Key Points: +
      +
    • RSC maintains its identity when moved in the DOM tree
    • +
    • Changing parent elements doesn't refetch the component
    • +
    • Adding/removing wrapper divs preserves the RSC instance
    • +
    • Instance ID and timestamp remain constant through all changes
    • +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/routes/rsc-use-server-fn.tsx b/e2e/react-start/rsc/src/routes/rsc-use-server-fn.tsx new file mode 100644 index 0000000000..5db269da42 --- /dev/null +++ b/e2e/react-start/rsc/src/routes/rsc-use-server-fn.tsx @@ -0,0 +1,37 @@ +import * as React from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn, useServerFn } from '@tanstack/react-start' +import { pageStyles } from '~/utils/styles' + +const getMessage = createServerFn({ method: 'GET' }).handler(async () => { + return 'useServerFn works with RSC builds' +}) + +export const Route = createFileRoute('/rsc-use-server-fn')({ + component: RscUseServerFnComponent, +}) + +function RscUseServerFnComponent() { + const getMessageFn = useServerFn(getMessage) + const [message, setMessage] = React.useState('') + + return ( +
    +

    + useServerFn with RSC +

    + +

    + {message || 'No message yet'} +

    +
    + ) +} diff --git a/e2e/react-start/rsc/src/utils/ClientPreloadContent.tsx b/e2e/react-start/rsc/src/utils/ClientPreloadContent.tsx new file mode 100644 index 0000000000..7443ad674f --- /dev/null +++ b/e2e/react-start/rsc/src/utils/ClientPreloadContent.tsx @@ -0,0 +1,40 @@ +/// +/// +import { serverBadge, serverBox, serverHeader, timestamp } from './serverStyles' +import { ClientWidget } from './ClientWidget' + +// ============================================================================ +// CLIENT PRELOAD: Server component content with client widget +// This is a pure server component file (no createServerFn) so vite-plugin-rsc's +// CSS transform can properly wrap the exported component +// ============================================================================ + +export function ClientPreloadContent({ data }: { data: { title: string } }) { + const serverTimestamp = Date.now() + + return ( +
    +
    + SERVER COMPONENT + + Fetched: {new Date(serverTimestamp).toLocaleTimeString()} + +
    + +

    + {data.title} +

    + +

    + This server component contains a client component with CSS modules. The + client component's JS and CSS should be preloaded in the document head. +

    + + {/* Client component rendered DIRECTLY inside server component */} + +
    + ) +} diff --git a/e2e/react-start/rsc/src/utils/ClientWidget.module.css b/e2e/react-start/rsc/src/utils/ClientWidget.module.css new file mode 100644 index 0000000000..016b248310 --- /dev/null +++ b/e2e/react-start/rsc/src/utils/ClientWidget.module.css @@ -0,0 +1,68 @@ +.widget { + padding: 16px; + background-color: #dcfce7; + border: 2px solid #16a34a; + border-radius: 8px; + margin: 8px 0; +} + +.header { + display: flex; + justify-content: space-between; + align-items: center; + margin-bottom: 12px; +} + +.badge { + background-color: #16a34a; + color: white; + font-size: 10px; + font-weight: bold; + padding: 4px 8px; + border-radius: 4px; + text-transform: uppercase; +} + +.title { + margin: 0 0 8px 0; + color: #14532d; + font-size: 18px; +} + +.content { + color: #166534; + font-size: 14px; + line-height: 1.5; +} + +.counter { + display: flex; + align-items: center; + gap: 12px; + margin-top: 12px; + padding-top: 12px; + border-top: 1px solid #86efac; +} + +.count { + font-size: 24px; + font-weight: bold; + color: #16a34a; + min-width: 40px; + text-align: center; +} + +.button { + padding: 6px 12px; + background-color: #16a34a; + color: white; + border: none; + border-radius: 4px; + cursor: pointer; + font-size: 13px; + transition: background-color 0.2s; +} + +.button:hover { + background-color: #15803d; +} diff --git a/e2e/react-start/rsc/src/utils/ClientWidget.tsx b/e2e/react-start/rsc/src/utils/ClientWidget.tsx new file mode 100644 index 0000000000..b95118e5bc --- /dev/null +++ b/e2e/react-start/rsc/src/utils/ClientWidget.tsx @@ -0,0 +1,49 @@ +'use client' + +import * as React from 'react' +import styles from './ClientWidget.module.css' + +/** + * Client widget component with CSS modules. + * This is a "use client" component that should have its JS and CSS preloaded + * when used inside a server component. + */ +export function ClientWidget({ title }: { title: string }) { + const [count, setCount] = React.useState(0) + + return ( +
    +
    + + CLIENT COMPONENT + +
    +

    + {title} +

    +

    + This is a client component with CSS modules. The CSS should be preloaded + in the document head to prevent flash of unstyled content. +

    +
    + + + {count} + + +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/utils/ClientWidgetA.module.css b/e2e/react-start/rsc/src/utils/ClientWidgetA.module.css new file mode 100644 index 0000000000..343367c135 --- /dev/null +++ b/e2e/react-start/rsc/src/utils/ClientWidgetA.module.css @@ -0,0 +1,63 @@ +/* Client Widget A - Purple theme */ +.widget { + background-color: #f3e8ff; + border: 2px solid #9333ea; + border-radius: 8px; + padding: 16px; + margin: 8px 0; +} + +.header { + margin-bottom: 8px; +} + +.badge { + display: inline-block; + background-color: #9333ea; + color: white; + padding: 2px 8px; + border-radius: 4px; + font-size: 11px; + font-weight: bold; +} + +.title { + margin: 0 0 8px 0; + color: #581c87; + font-size: 16px; +} + +.content { + margin: 0 0 12px 0; + color: #7e22ce; + font-size: 13px; +} + +.counter { + display: flex; + align-items: center; + gap: 12px; +} + +.button { + width: 32px; + height: 32px; + border: none; + border-radius: 6px; + background-color: #9333ea; + color: white; + font-size: 18px; + cursor: pointer; +} + +.button:hover { + background-color: #7e22ce; +} + +.count { + font-size: 18px; + font-weight: bold; + color: #581c87; + min-width: 40px; + text-align: center; +} diff --git a/e2e/react-start/rsc/src/utils/ClientWidgetA.tsx b/e2e/react-start/rsc/src/utils/ClientWidgetA.tsx new file mode 100644 index 0000000000..65bb6618fe --- /dev/null +++ b/e2e/react-start/rsc/src/utils/ClientWidgetA.tsx @@ -0,0 +1,51 @@ +'use client' + +import { useHydrated } from '@tanstack/react-router' +import * as React from 'react' +import styles from './ClientWidgetA.module.css' + +/** + * Client widget A - rendered DIRECTLY inside server component. + * Uses CSS module A with purple theme. + */ +export function ClientWidgetA({ title }: { title: string }) { + const [count, setCount] = React.useState(0) + const isHydrated = useHydrated() + + return ( +
    +
    + + CLIENT A (Direct) + +
    +

    + {title} +

    +

    + Rendered directly inside createCompositeComponent. +

    +
    + + + {count} + + +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/utils/ClientWidgetB.module.css b/e2e/react-start/rsc/src/utils/ClientWidgetB.module.css new file mode 100644 index 0000000000..c8b7f9e1d8 --- /dev/null +++ b/e2e/react-start/rsc/src/utils/ClientWidgetB.module.css @@ -0,0 +1,53 @@ +/* Client Widget B - Teal theme */ +.widget { + background-color: #ccfbf1; + border: 2px solid #14b8a6; + border-radius: 8px; + padding: 16px; + margin: 8px 0; +} + +.header { + margin-bottom: 8px; +} + +.badge { + display: inline-block; + background-color: #14b8a6; + color: white; + padding: 2px 8px; + border-radius: 4px; + font-size: 11px; + font-weight: bold; +} + +.title { + margin: 0 0 8px 0; + color: #115e59; + font-size: 16px; +} + +.content { + margin: 0 0 12px 0; + color: #0d9488; + font-size: 13px; +} + +.toggleButton { + padding: 8px 16px; + border: none; + border-radius: 6px; + background-color: #14b8a6; + color: white; + font-size: 14px; + cursor: pointer; + transition: background-color 0.2s; +} + +.toggleButton:hover { + background-color: #0d9488; +} + +.toggleButton.active { + background-color: #115e59; +} diff --git a/e2e/react-start/rsc/src/utils/ClientWidgetB.tsx b/e2e/react-start/rsc/src/utils/ClientWidgetB.tsx new file mode 100644 index 0000000000..24934650b9 --- /dev/null +++ b/e2e/react-start/rsc/src/utils/ClientWidgetB.tsx @@ -0,0 +1,36 @@ +'use client' + +import { useHydrated } from '@tanstack/react-router' +import * as React from 'react' +import styles from './ClientWidgetB.module.css' + +/** + * Client widget B - passed via children slot to server component. + * Uses CSS module B with teal theme. + */ +export function ClientWidgetB({ title }: { title: string }) { + const [active, setActive] = React.useState(false) + const isHydrated = useHydrated() + + return ( +
    +
    + + CLIENT B (Slot) + +
    +

    + {title} +

    +

    Passed via children slot to RSC.

    + +
    + ) +} diff --git a/e2e/react-start/rsc/src/utils/ClientWidgetC.css b/e2e/react-start/rsc/src/utils/ClientWidgetC.css new file mode 100644 index 0000000000..ea6b7f925e --- /dev/null +++ b/e2e/react-start/rsc/src/utils/ClientWidgetC.css @@ -0,0 +1,19 @@ +/* + * Global CSS for ClientWidgetC - tests that unrendered RSC CSS is NOT loaded. + * If this CSS is loaded, it will turn [data-testid="serverb-note"] orange, + * which we can detect in tests. + */ + +[data-testid='serverb-note'] { + background-color: #ffedd5 !important; /* orange-100 */ + border: 3px solid #f97316 !important; /* orange-500 */ + color: #9a3412 !important; /* orange-800 */ +} + +.client-widget-c { + background-color: #ffedd5; + border: 2px solid #f97316; + border-radius: 8px; + padding: 16px; + margin: 8px 0; +} diff --git a/e2e/react-start/rsc/src/utils/ClientWidgetC.tsx b/e2e/react-start/rsc/src/utils/ClientWidgetC.tsx new file mode 100644 index 0000000000..363a55be49 --- /dev/null +++ b/e2e/react-start/rsc/src/utils/ClientWidgetC.tsx @@ -0,0 +1,27 @@ +'use client' + +import * as React from 'react' +import './ClientWidgetC.css' + +/** + * Client widget C - loaded in server component B but NOT rendered. + * Uses GLOBAL CSS that targets [data-testid="serverb-note"]. + * If this CSS is loaded when ServerB is not rendered, the note will turn orange. + */ +export function ClientWidgetC({ title }: { title: string }) { + const [value, setValue] = React.useState(50) + + return ( +
    +

    {title}

    +

    This widget is loaded but NOT rendered.

    + setValue(Number(e.target.value))} + data-testid="client-widget-c-slider" + /> + {value}% +
    + ) +} diff --git a/e2e/react-start/rsc/src/utils/ComplexPreloadContentA.tsx b/e2e/react-start/rsc/src/utils/ComplexPreloadContentA.tsx new file mode 100644 index 0000000000..1a2d7af6de --- /dev/null +++ b/e2e/react-start/rsc/src/utils/ComplexPreloadContentA.tsx @@ -0,0 +1,50 @@ +/// +/// +import * as React from 'react' +import { serverBadge, serverBox, serverHeader, timestamp } from './serverStyles' +import { ClientWidgetA } from './ClientWidgetA' + +// ============================================================================ +// COMPLEX PRELOAD: Server component A content with client widget A +// This is a pure server component file (no createServerFn) so vite-plugin-rsc's +// CSS transform can properly wrap the exported component +// ============================================================================ + +export function ComplexPreloadContentA({ + data, + children, +}: { + data: { title: string } + children?: React.ReactNode +}) { + const serverTimestamp = Date.now() + + return ( +
    +
    + SERVER COMPONENT A + + Fetched: {new Date(serverTimestamp).toLocaleTimeString()} + +
    + +

    + {data.title} +

    + +

    + This server component renders ClientWidgetA directly and accepts + ClientWidgetB via children slot. +

    + + {/* ClientWidgetA rendered DIRECTLY inside server component */} + + + {/* ClientWidgetB passed via children slot from route component */} +
    {children}
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/utils/ComplexPreloadContentB.tsx b/e2e/react-start/rsc/src/utils/ComplexPreloadContentB.tsx new file mode 100644 index 0000000000..fadafd489e --- /dev/null +++ b/e2e/react-start/rsc/src/utils/ComplexPreloadContentB.tsx @@ -0,0 +1,35 @@ +/// +/// +import { serverBadge, serverBox, serverHeader, timestamp } from './serverStyles' +import { ClientWidgetC } from './ClientWidgetC' + +// ============================================================================ +// COMPLEX PRELOAD: Server component B content with client widget C +// This is a pure server component file (no createServerFn) so vite-plugin-rsc's +// CSS transform can properly wrap the exported component +// ============================================================================ + +export function ComplexPreloadContentB({ data }: { data: { title: string } }) { + const serverTimestamp = Date.now() + + return ( +
    +
    + SERVER COMPONENT B + + Fetched: {new Date(serverTimestamp).toLocaleTimeString()} + +
    + +

    + {data.title} +

    + + {/* ClientWidgetC rendered inside server component B */} + +
    + ) +} diff --git a/e2e/react-start/rsc/src/utils/ConditionalOrangePanel.tsx b/e2e/react-start/rsc/src/utils/ConditionalOrangePanel.tsx new file mode 100644 index 0000000000..821433f334 --- /dev/null +++ b/e2e/react-start/rsc/src/utils/ConditionalOrangePanel.tsx @@ -0,0 +1,17 @@ +import styles from './conditionalOrange.module.css' + +export function ConditionalOrangePanel() { + return ( +
    + + ORANGE VARIANT + +

    + This branch renders only the orange module. +

    +
    + ) +} diff --git a/e2e/react-start/rsc/src/utils/ConditionalVioletPanel.tsx b/e2e/react-start/rsc/src/utils/ConditionalVioletPanel.tsx new file mode 100644 index 0000000000..d4fc2f508d --- /dev/null +++ b/e2e/react-start/rsc/src/utils/ConditionalVioletPanel.tsx @@ -0,0 +1,17 @@ +import styles from './conditionalViolet.module.css' + +export function ConditionalVioletPanel() { + return ( +
    + + VIOLET VARIANT + +

    + This branch renders only the violet module. +

    +
    + ) +} diff --git a/e2e/react-start/rsc/src/utils/CssModulesContent.tsx b/e2e/react-start/rsc/src/utils/CssModulesContent.tsx new file mode 100644 index 0000000000..09a58b42ec --- /dev/null +++ b/e2e/react-start/rsc/src/utils/CssModulesContent.tsx @@ -0,0 +1,65 @@ +/// +/// +import styles from './serverComponent.module.css' +import { NestedAccentContent } from './NestedAccentContent' + +// ============================================================================ +// CSS MODULES: Feature Card with CSS Modules +// This is a pure server component file (no createServerFn) so vite-plugin-rsc's +// CSS transform can properly wrap the exported component +// ============================================================================ + +export function CssModulesContent({ data }: { data: { title?: string } }) { + const serverTimestamp = Date.now() + + const features = [ + { id: 1, icon: '✓', text: 'Scoped class names prevent conflicts' }, + { id: 2, icon: '✓', text: 'Works seamlessly in server components' }, + { id: 3, icon: '✓', text: 'CSS is extracted and optimized' }, + { id: 4, icon: '✓', text: 'Full IDE support with TypeScript' }, + ] + + return ( +
    +
    + + SERVER RENDERED + + + Fetched: {new Date(serverTimestamp).toLocaleTimeString()} + +
    + +

    + {data.title || 'CSS Modules in RSC'} +

    + +

    + This server component uses CSS Modules for styling. The class names are + automatically scoped to prevent conflicts with other styles. +

    + +
      + {features.map((feature) => ( +
    • + {feature.icon} + {feature.text} +
    • + ))} +
    + +
    + Component ID: css-mod-{Math.random().toString(36).slice(2, 8)} +
    + + +
    + ) +} diff --git a/e2e/react-start/rsc/src/utils/GlobalCssContent.tsx b/e2e/react-start/rsc/src/utils/GlobalCssContent.tsx new file mode 100644 index 0000000000..caf4fe93e0 --- /dev/null +++ b/e2e/react-start/rsc/src/utils/GlobalCssContent.tsx @@ -0,0 +1,84 @@ +/// +/// +import './serverComponent.css' + +// ============================================================================ +// GLOBAL CSS: Info Card with Global CSS +// This is a pure server component file (no createServerFn) so vite-plugin-rsc's +// CSS transform can properly wrap the exported component +// ============================================================================ + +export function GlobalCssContent({ + data, + serverInfo, + serverTimestamp, +}: { + data: { title?: string } + serverInfo: { + nodeVersion: string + platform: string + uptime: number + memoryUsage: number + } + serverTimestamp: number +}) { + return ( +
    +
    + + SERVER RENDERED + + + Fetched: {new Date(serverTimestamp).toLocaleTimeString()} + +
    + +

    + {data.title || 'Global CSS in RSC'} +

    + +

    + This server component uses global CSS for styling. The styles are + defined with regular class names (not scoped/hashed). +

    + +
    +
    +
    Node Version
    +
    + {serverInfo.nodeVersion} +
    +
    +
    +
    Platform
    +
    + {serverInfo.platform} +
    +
    +
    +
    Uptime
    +
    {serverInfo.uptime}s
    +
    +
    +
    Memory (Heap)
    +
    + {serverInfo.memoryUsage} MB +
    +
    +
    + +
    + Component ID: global-css-{Math.random().toString(36).slice(2, 8)} +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/utils/NestedAccentContent.tsx b/e2e/react-start/rsc/src/utils/NestedAccentContent.tsx new file mode 100644 index 0000000000..1943f02acc --- /dev/null +++ b/e2e/react-start/rsc/src/utils/NestedAccentContent.tsx @@ -0,0 +1,17 @@ +import styles from './nestedAccent.module.css' + +export function NestedAccentContent() { + return ( +
    +
    + Nested Accent Module +
    +

    + This nested server component owns a second CSS module. +

    +
    + ) +} diff --git a/e2e/react-start/rsc/src/utils/basicServerComponent.tsx b/e2e/react-start/rsc/src/utils/basicServerComponent.tsx new file mode 100644 index 0000000000..586b410041 --- /dev/null +++ b/e2e/react-start/rsc/src/utils/basicServerComponent.tsx @@ -0,0 +1,127 @@ +import { createServerFn } from '@tanstack/react-start' +import { renderServerComponent } from '@tanstack/react-start/rsc' +import { serverBox, serverBadge, serverHeader, timestamp } from './serverStyles' + +// ============================================================================ +// BASIC: User Profile Card +// Used by: rsc-basic.tsx, rsc-hydration.tsx +// ============================================================================ + +export const getBasicServerComponent = createServerFn({ method: 'GET' }) + .inputValidator((data: { label?: string }) => data) + .handler(async ({ data }) => { + const serverTimestamp = Date.now() + + // Simulate fetching user from database + const user = { + id: 'usr_' + Math.random().toString(36).slice(2, 8), + name: 'Sarah Chen', + role: 'Senior Software Engineer', + department: 'Platform Team', + email: 'sarah.chen@example.com', + joinDate: 'March 2021', + projects: 12, + contributions: 847, + } + + return renderServerComponent( +
    +
    + + SERVER RENDERED + + + Fetched: {new Date(serverTimestamp).toLocaleTimeString()} + +
    + + {/* Profile Header */} +
    +
    + SC +
    +
    +

    + {user.name} +

    +
    {user.role}
    +
    + {user.department} +
    +
    +
    + + {/* Stats */} +
    +
    +
    + {user.projects} +
    +
    Projects
    +
    +
    +
    + {user.contributions} +
    +
    + Contributions +
    +
    +
    +
    + {user.joinDate.split(' ')[1]} +
    +
    Since
    +
    +
    + +
    + User ID: {user.id} +
    +
    , + ) + }) diff --git a/e2e/react-start/rsc/src/utils/clientPreloadServerComponent.tsx b/e2e/react-start/rsc/src/utils/clientPreloadServerComponent.tsx new file mode 100644 index 0000000000..53b0cf4fc1 --- /dev/null +++ b/e2e/react-start/rsc/src/utils/clientPreloadServerComponent.tsx @@ -0,0 +1,15 @@ +import { createServerFn } from '@tanstack/react-start' +import { renderServerComponent } from '@tanstack/react-start/rsc' +// Import the component from a separate file so vite-plugin-rsc's CSS transform +// can properly wrap it (without interference from server function splitting) +import { ClientPreloadContent } from './ClientPreloadContent' + +// ============================================================================ +// Server function that returns the client preload server component +// ============================================================================ + +export const getClientPreloadServerComponent = createServerFn({ method: 'GET' }) + .inputValidator((data: { title: string }) => data) + .handler(async ({ data }) => { + return renderServerComponent() + }) diff --git a/e2e/react-start/rsc/src/utils/complexPreloadServerComponentA.tsx b/e2e/react-start/rsc/src/utils/complexPreloadServerComponentA.tsx new file mode 100644 index 0000000000..2596068946 --- /dev/null +++ b/e2e/react-start/rsc/src/utils/complexPreloadServerComponentA.tsx @@ -0,0 +1,21 @@ +import * as React from 'react' +import { createServerFn } from '@tanstack/react-start' +import { createCompositeComponent } from '@tanstack/react-start/rsc' +import { ComplexPreloadContentA } from './ComplexPreloadContentA' + +// ============================================================================ +// Server function that returns server component A (with children slot) +// Separate module from B so CSS is not bundled together +// ============================================================================ + +export const getComplexPreloadServerComponentA = createServerFn({ + method: 'GET', +}) + .inputValidator((data: { title: string }) => data) + .handler(async ({ data }) => { + return createCompositeComponent((props: { children?: React.ReactNode }) => ( + + {props.children} + + )) + }) diff --git a/e2e/react-start/rsc/src/utils/complexPreloadServerComponentB.tsx b/e2e/react-start/rsc/src/utils/complexPreloadServerComponentB.tsx new file mode 100644 index 0000000000..a0e3c1a778 --- /dev/null +++ b/e2e/react-start/rsc/src/utils/complexPreloadServerComponentB.tsx @@ -0,0 +1,16 @@ +import { createServerFn } from '@tanstack/react-start' +import { renderServerComponent } from '@tanstack/react-start/rsc' +import { ComplexPreloadContentB } from './ComplexPreloadContentB' + +// ============================================================================ +// Server function that returns server component B (no children slot) +// Separate module from A so CSS is not bundled together +// ============================================================================ + +export const getComplexPreloadServerComponentB = createServerFn({ + method: 'GET', +}) + .inputValidator((data: { title: string }) => data) + .handler(async ({ data }) => { + return renderServerComponent() + }) diff --git a/e2e/react-start/rsc/src/utils/conditionalCssServerComponent.tsx b/e2e/react-start/rsc/src/utils/conditionalCssServerComponent.tsx new file mode 100644 index 0000000000..c249301e63 --- /dev/null +++ b/e2e/react-start/rsc/src/utils/conditionalCssServerComponent.tsx @@ -0,0 +1,22 @@ +import { createServerFn } from '@tanstack/react-start' +import { renderServerComponent } from '@tanstack/react-start/rsc' +import { ConditionalOrangePanel } from './ConditionalOrangePanel' +import { ConditionalVioletPanel } from './ConditionalVioletPanel' + +export const getConditionalCssServerComponent = createServerFn({ + method: 'GET', +}) + .inputValidator((data: { branch?: 'orange' | 'violet' }) => data) + .handler(async ({ data }) => { + const branch = data.branch === 'violet' ? 'violet' : 'orange' + + return renderServerComponent( + <> + {branch === 'violet' ? ( + + ) : ( + + )} + , + ) + }) diff --git a/e2e/react-start/rsc/src/utils/conditionalOrange.module.css b/e2e/react-start/rsc/src/utils/conditionalOrange.module.css new file mode 100644 index 0000000000..16d15004dd --- /dev/null +++ b/e2e/react-start/rsc/src/utils/conditionalOrange.module.css @@ -0,0 +1,17 @@ +.panel { + background: #ffedd5; + border: 2px solid #f97316; + border-radius: 10px; + padding: 14px; + color: #9a3412; +} + +.label { + display: inline-block; + background: #f97316; + color: white; + padding: 2px 8px; + border-radius: 999px; + font-size: 11px; + font-weight: 700; +} diff --git a/e2e/react-start/rsc/src/utils/conditionalViolet.module.css b/e2e/react-start/rsc/src/utils/conditionalViolet.module.css new file mode 100644 index 0000000000..4345c90b50 --- /dev/null +++ b/e2e/react-start/rsc/src/utils/conditionalViolet.module.css @@ -0,0 +1,17 @@ +.panel { + background: #ede9fe; + border: 2px solid #8b5cf6; + border-radius: 10px; + padding: 14px; + color: #5b21b6; +} + +.label { + display: inline-block; + background: #8b5cf6; + color: white; + padding: 2px 8px; + border-radius: 999px; + font-size: 11px; + font-weight: 700; +} diff --git a/e2e/react-start/rsc/src/utils/cssModulesServerComponent.tsx b/e2e/react-start/rsc/src/utils/cssModulesServerComponent.tsx new file mode 100644 index 0000000000..b1d06bebe5 --- /dev/null +++ b/e2e/react-start/rsc/src/utils/cssModulesServerComponent.tsx @@ -0,0 +1,19 @@ +import { createServerFn } from '@tanstack/react-start' +import { renderServerComponent } from '@tanstack/react-start/rsc' +// Import the component from a separate file so vite-plugin-rsc's CSS transform +// can properly wrap it (without interference from server function splitting) +import { CssModulesContent } from './CssModulesContent' + +// ============================================================================ +// Server function that returns the CSS Modules server component +// ============================================================================ + +export const getCssModulesServerComponent = createServerFn({ method: 'GET' }) + .inputValidator((data: { title?: string }) => data) + .handler(async ({ data }) => { + return renderServerComponent( + <> + + , + ) + }) diff --git a/e2e/react-start/rsc/src/utils/globalCssServerComponent.tsx b/e2e/react-start/rsc/src/utils/globalCssServerComponent.tsx new file mode 100644 index 0000000000..c497fcc0e6 --- /dev/null +++ b/e2e/react-start/rsc/src/utils/globalCssServerComponent.tsx @@ -0,0 +1,31 @@ +import { createServerFn } from '@tanstack/react-start' +import { renderServerComponent } from '@tanstack/react-start/rsc' +// Import the component from a separate file so vite-plugin-rsc's CSS transform +// can properly wrap it (without interference from server function splitting) +import { GlobalCssContent } from './GlobalCssContent' + +// ============================================================================ +// Server function that returns the Global CSS server component +// ============================================================================ + +export const getGlobalCssServerComponent = createServerFn({ method: 'GET' }) + .inputValidator((data: { title?: string }) => data) + .handler(async ({ data }) => { + const serverTimestamp = Date.now() + + // Simulated server info + const serverInfo = { + nodeVersion: process.version, + platform: process.platform, + uptime: Math.floor(process.uptime()), + memoryUsage: Math.round(process.memoryUsage().heapUsed / 1024 / 1024), + } + + return renderServerComponent( + , + ) + }) diff --git a/e2e/react-start/rsc/src/utils/nestedAccent.module.css b/e2e/react-start/rsc/src/utils/nestedAccent.module.css new file mode 100644 index 0000000000..0d699c536f --- /dev/null +++ b/e2e/react-start/rsc/src/utils/nestedAccent.module.css @@ -0,0 +1,14 @@ +.accentBox { + background: #dcfce7; + border: 2px solid #16a34a; + border-radius: 12px; + padding: 12px; + color: #14532d; +} + +.accentTitle { + font-size: 14px; + font-weight: 700; + letter-spacing: 0.04em; + text-transform: uppercase; +} diff --git a/e2e/react-start/rsc/src/utils/rsc-param/ClientRenderedDirect.tsx b/e2e/react-start/rsc/src/utils/rsc-param/ClientRenderedDirect.tsx new file mode 100644 index 0000000000..fe3848f364 --- /dev/null +++ b/e2e/react-start/rsc/src/utils/rsc-param/ClientRenderedDirect.tsx @@ -0,0 +1,55 @@ +'use client' + +import * as React from 'react' +import { clientStyles } from '../styles' + +export function ClientRenderedDirect() { + const instanceId = React.useRef(Math.random().toString(16).slice(2)) + const [count, setCount] = React.useState(0) + + React.useEffect(() => { + // eslint-disable-next-line no-console + console.log(`[mount] ClientRenderedDirect ${instanceId.current}`) + return () => { + // eslint-disable-next-line no-console + console.log(`[unmount] ClientRenderedDirect ${instanceId.current}`) + } + }, []) + + return ( +
    +
    + CLIENT DIRECT +
    + +
    + instance:{' '} + + {instanceId.current} + +
    + +
    + + +
    + count: {count} +
    +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/utils/rsc-param/SlotChild.tsx b/e2e/react-start/rsc/src/utils/rsc-param/SlotChild.tsx new file mode 100644 index 0000000000..d8d48b85b1 --- /dev/null +++ b/e2e/react-start/rsc/src/utils/rsc-param/SlotChild.tsx @@ -0,0 +1,52 @@ +'use client' + +import * as React from 'react' +import { clientStyles } from '../styles' + +export function SlotChild() { + const instanceId = React.useRef(Math.random().toString(16).slice(2)) + const [text, setText] = React.useState('hello') + + React.useEffect(() => { + // eslint-disable-next-line no-console + console.log(`[mount] SlotChild ${instanceId.current}`) + return () => { + // eslint-disable-next-line no-console + console.log(`[unmount] SlotChild ${instanceId.current}`) + } + }, []) + + return ( +
    +
    + CLIENT SLOT CHILD +
    + +
    + instance:{' '} + + {instanceId.current} + +
    + + + +
    + echo: {text} +
    +
    + ) +} diff --git a/e2e/react-start/rsc/src/utils/rsc-param/SlotRenderProp.tsx b/e2e/react-start/rsc/src/utils/rsc-param/SlotRenderProp.tsx new file mode 100644 index 0000000000..eaacb11c82 --- /dev/null +++ b/e2e/react-start/rsc/src/utils/rsc-param/SlotRenderProp.tsx @@ -0,0 +1,49 @@ +'use client' + +import * as React from 'react' +import { clientStyles } from '../styles' + +export function SlotRenderProp() { + const instanceId = React.useRef(Math.random().toString(16).slice(2)) + const [checked, setChecked] = React.useState(false) + + React.useEffect(() => { + // eslint-disable-next-line no-console + console.log(`[mount] SlotRenderProp ${instanceId.current}`) + return () => { + // eslint-disable-next-line no-console + console.log(`[unmount] SlotRenderProp ${instanceId.current}`) + } + }, []) + + return ( +
    +
    + CLIENT SLOT FOOTER +
    + +
    + instance:{' '} + + {instanceId.current} + +
    + + +
    + ) +} diff --git a/e2e/react-start/rsc/src/utils/serverComponent.css b/e2e/react-start/rsc/src/utils/serverComponent.css new file mode 100644 index 0000000000..183bdac83e --- /dev/null +++ b/e2e/react-start/rsc/src/utils/serverComponent.css @@ -0,0 +1,80 @@ +/* Global CSS for RSC Global CSS test */ +/* Uses blue server theme colors */ + +.rsc-global-container { + background-color: #e0f2fe; + border: 2px solid #0284c7; + border-radius: 8px; + padding: 16px; +} + +.rsc-global-header { + display: flex; + justify-content: space-between; + align-items: center; + margin-bottom: 12px; +} + +.rsc-global-badge { + display: inline-block; + background-color: #0284c7; + color: white; + padding: 2px 8px; + border-radius: 4px; + font-size: 11px; + font-weight: bold; + letter-spacing: 0.5px; +} + +.rsc-global-timestamp { + font-size: 11px; + color: #64748b; + font-family: monospace; +} + +.rsc-global-title { + margin: 0 0 8px 0; + color: #0c4a6e; + font-size: 18px; +} + +.rsc-global-description { + color: #0369a1; + line-height: 1.5; + margin-bottom: 16px; +} + +.rsc-global-info-grid { + display: grid; + grid-template-columns: repeat(2, 1fr); + gap: 12px; + margin-bottom: 16px; +} + +.rsc-global-info-card { + background-color: #f0f9ff; + border-radius: 6px; + padding: 12px; +} + +.rsc-global-info-label { + font-size: 11px; + color: #64748b; + text-transform: uppercase; + letter-spacing: 0.5px; + margin-bottom: 4px; +} + +.rsc-global-info-value { + font-size: 16px; + font-weight: bold; + color: #0284c7; +} + +.rsc-global-footer { + margin-top: 16px; + padding-top: 12px; + border-top: 1px solid #bae6fd; + font-size: 12px; + color: #64748b; +} diff --git a/e2e/react-start/rsc/src/utils/serverComponent.module.css b/e2e/react-start/rsc/src/utils/serverComponent.module.css new file mode 100644 index 0000000000..858e29ac50 --- /dev/null +++ b/e2e/react-start/rsc/src/utils/serverComponent.module.css @@ -0,0 +1,86 @@ +/* CSS Module for RSC CSS Modules test */ + +.container { + background-color: #e0f2fe; + border: 2px solid #0284c7; + border-radius: 8px; + padding: 16px; +} + +.header { + display: flex; + justify-content: space-between; + align-items: center; + margin-bottom: 12px; +} + +.badge { + display: inline-block; + background-color: #0284c7; + color: white; + padding: 2px 8px; + border-radius: 4px; + font-size: 11px; + font-weight: bold; + letter-spacing: 0.5px; +} + +.timestamp { + font-size: 11px; + color: #64748b; + font-family: monospace; +} + +.title { + margin: 0 0 8px 0; + color: #0c4a6e; + font-size: 18px; +} + +.description { + color: #0369a1; + line-height: 1.5; + margin-bottom: 16px; +} + +.featureList { + list-style: none; + padding: 0; + margin: 0; +} + +.featureItem { + display: flex; + align-items: center; + gap: 8px; + padding: 8px 12px; + background-color: #f0f9ff; + border-radius: 6px; + margin-bottom: 8px; + color: #0c4a6e; +} + +.featureItem:last-child { + margin-bottom: 0; +} + +.featureIcon { + width: 24px; + height: 24px; + background-color: #0284c7; + border-radius: 50%; + display: flex; + align-items: center; + justify-content: center; + color: white; + font-size: 12px; + flex-shrink: 0; +} + +.footer { + margin-top: 16px; + padding-top: 12px; + border-top: 1px solid #bae6fd; + font-size: 12px; + color: #64748b; +} diff --git a/e2e/react-start/rsc/src/utils/serverStyles.ts b/e2e/react-start/rsc/src/utils/serverStyles.ts new file mode 100644 index 0000000000..26a2bae5f3 --- /dev/null +++ b/e2e/react-start/rsc/src/utils/serverStyles.ts @@ -0,0 +1,35 @@ +// ============================================================================ +// Shared Server Styles (must be defined here since this runs on server) +// These styles are used by server components to render with consistent styling +// ============================================================================ + +export const serverBox = { + backgroundColor: '#e0f2fe', + border: '2px solid #0284c7', + borderRadius: '8px', + padding: '16px', +} + +export const serverBadge = { + display: 'inline-block', + backgroundColor: '#0284c7', + color: 'white', + padding: '2px 8px', + borderRadius: '4px', + fontSize: '11px', + fontWeight: 'bold' as const, + letterSpacing: '0.5px', +} + +export const serverHeader = { + display: 'flex', + justifyContent: 'space-between', + alignItems: 'center', + marginBottom: '12px', +} + +export const timestamp = { + fontSize: '11px', + color: '#64748b', + fontFamily: 'monospace', +} diff --git a/e2e/react-start/rsc/src/utils/streamingServerComponents.tsx b/e2e/react-start/rsc/src/utils/streamingServerComponents.tsx new file mode 100644 index 0000000000..0df3f80505 --- /dev/null +++ b/e2e/react-start/rsc/src/utils/streamingServerComponents.tsx @@ -0,0 +1,164 @@ +import { createServerFn } from '@tanstack/react-start' +import { createCompositeComponent } from '@tanstack/react-start/rsc' +import { serverBox, serverBadge, serverHeader, timestamp } from './serverStyles' + +// ============================================================================ +// STREAMING: Notification components streamed via ReadableStream or AsyncGenerator +// Used by: rsc-stream-readable.tsx, rsc-stream-generator.tsx, rsc-stream-loader.tsx +// ============================================================================ + +type NotificationData = { + id: string + title: string + message: string + timestamp: number + source: string +} + +function generateNotification(index: number): NotificationData { + const sources = ['System', 'User', 'API', 'Database', 'Security', 'Analytics'] + const messages = [ + 'New user registration completed successfully', + 'Database backup finished without errors', + 'API rate limit approaching threshold', + 'Security scan detected no vulnerabilities', + 'Weekly analytics report is ready', + 'Server maintenance scheduled for tonight', + 'New feature deployment completed', + 'Cache invalidation triggered', + ] + + return { + id: `notif_${index}_${Math.random().toString(36).slice(2, 8)}`, + title: `Notification ${index + 1}`, + message: messages[index % messages.length], + timestamp: Date.now(), + source: sources[index % sources.length], + } +} + +async function createNotificationRSC(notification: NotificationData) { + return createCompositeComponent( + (props: { renderActions?: (data: { id: string }) => React.ReactNode }) => { + return ( +
    +
    +
    + SERVER COMPONENT + + {notification.source} + +
    + + {new Date(notification.timestamp).toLocaleTimeString()} + +
    + +
    +

    + {notification.title} +

    +

    + {notification.message} +

    +
    + ID: {notification.id} +
    +
    + + {/* Client slot for interactive actions */} + {props.renderActions?.({ id: notification.id })} +
    + ) + }, + ) +} + +/** + * Streams notification RSCs using ReadableStream pattern. + * First `initialCount` notifications arrive immediately (batched), + * then `streamCount` more stream in with delays. + */ +export const streamNotificationsReadable = createServerFn({ method: 'GET' }) + .inputValidator( + (data: { initialCount: number; streamCount: number; delayMs: number }) => + data, + ) + .handler(async ({ data }) => { + const { initialCount, streamCount, delayMs } = data + + // Return a typed ReadableStream of server components + const stream = new ReadableStream({ + async start(controller) { + // Send initial batch immediately + for (let i = 0; i < initialCount; i++) { + const notification = generateNotification(i) + const rsc = await createNotificationRSC(notification) + controller.enqueue(rsc) + } + + // Stream remaining with delays + for (let i = 0; i < streamCount; i++) { + await new Promise((resolve) => setTimeout(resolve, delayMs)) + const notification = generateNotification(initialCount + i) + const rsc = await createNotificationRSC(notification) + controller.enqueue(rsc) + } + + controller.close() + }, + }) + + return stream + }) + +/** + * Streams notification RSCs using async generator pattern. + * First `initialCount` notifications arrive immediately (batched), + * then `streamCount` more stream in with delays. + */ +export const streamNotificationsGenerator = createServerFn({ method: 'GET' }) + .inputValidator( + (data: { initialCount: number; streamCount: number; delayMs: number }) => + data, + ) + .handler(async function* ({ data }) { + const { initialCount, streamCount, delayMs } = data + + // Yield initial batch immediately + for (let i = 0; i < initialCount; i++) { + const notification = generateNotification(i) + const rsc = await createNotificationRSC(notification) + yield rsc + } + + // Stream remaining with delays + for (let i = 0; i < streamCount; i++) { + await new Promise((resolve) => setTimeout(resolve, delayMs)) + const notification = generateNotification(initialCount + i) + const rsc = await createNotificationRSC(notification) + yield rsc + } + }) diff --git a/e2e/react-start/rsc/src/utils/styles.ts b/e2e/react-start/rsc/src/utils/styles.ts new file mode 100644 index 0000000000..f0588e061a --- /dev/null +++ b/e2e/react-start/rsc/src/utils/styles.ts @@ -0,0 +1,222 @@ +/** + * Shared styles for RSC E2E tests. + * Blue = Server Rendered (RSC) + * Green = Client Interactive + */ + +// Server-rendered content styles (blue theme) +export const serverStyles = { + container: { + backgroundColor: '#e0f2fe', + border: '2px solid #0284c7', + borderRadius: '8px', + padding: '16px', + marginBottom: '16px', + }, + badge: { + display: 'inline-block', + backgroundColor: '#0284c7', + color: 'white', + padding: '2px 8px', + borderRadius: '4px', + fontSize: '11px', + fontWeight: 'bold' as const, + letterSpacing: '0.5px', + }, + header: { + display: 'flex', + justifyContent: 'space-between', + alignItems: 'center', + marginBottom: '12px', + }, + timestamp: { + fontSize: '11px', + color: '#64748b', + fontFamily: 'monospace', + }, + label: { + color: '#0369a1', + fontSize: '11px', + fontWeight: 'bold' as const, + textTransform: 'uppercase' as const, + letterSpacing: '0.5px', + marginBottom: '4px', + }, + text: { + color: '#0c4a6e', + }, + muted: { + color: '#64748b', + }, + divider: { + borderTop: '1px solid #bae6fd', + margin: '12px 0', + }, +} + +// Client interactive content styles (green theme) +export const clientStyles = { + container: { + backgroundColor: '#dcfce7', + border: '2px solid #16a34a', + borderRadius: '8px', + padding: '16px', + marginBottom: '16px', + }, + badge: { + display: 'inline-block', + backgroundColor: '#16a34a', + color: 'white', + padding: '2px 8px', + borderRadius: '4px', + fontSize: '11px', + fontWeight: 'bold' as const, + letterSpacing: '0.5px', + }, + header: { + display: 'flex', + justifyContent: 'space-between', + alignItems: 'center', + marginBottom: '12px', + }, + label: { + color: '#166534', + fontSize: '11px', + fontWeight: 'bold' as const, + textTransform: 'uppercase' as const, + letterSpacing: '0.5px', + marginBottom: '4px', + }, + text: { + color: '#14532d', + }, + divider: { + borderTop: '1px solid #bbf7d0', + margin: '12px 0', + }, + button: { + padding: '8px 16px', + borderRadius: '6px', + border: 'none', + fontWeight: 'bold' as const, + cursor: 'pointer', + fontSize: '13px', + transition: 'opacity 0.2s', + }, + primaryButton: { + backgroundColor: '#16a34a', + color: 'white', + }, + secondaryButton: { + backgroundColor: '#e2e8f0', + color: '#334155', + }, +} + +// Async/Loading content styles (amber theme for pending states) +export const asyncStyles = { + container: { + backgroundColor: '#fef3c7', + border: '2px dashed #f59e0b', + borderRadius: '8px', + padding: '16px', + marginBottom: '16px', + }, + badge: { + display: 'inline-block', + backgroundColor: '#f59e0b', + color: 'white', + padding: '2px 8px', + borderRadius: '4px', + fontSize: '11px', + fontWeight: 'bold' as const, + letterSpacing: '0.5px', + }, + loadingBar: { + height: '4px', + backgroundColor: '#fde68a', + borderRadius: '2px', + overflow: 'hidden', + marginTop: '8px', + }, + loadingProgress: { + height: '100%', + backgroundColor: '#f59e0b', + animation: 'loading 1.5s ease-in-out infinite', + }, +} + +// Page layout styles +export const pageStyles = { + container: { + padding: '20px', + maxWidth: '800px', + fontFamily: + '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif', + }, + title: { + margin: '0 0 8px 0', + fontSize: '24px', + color: '#1e293b', + }, + description: { + color: '#64748b', + marginBottom: '20px', + lineHeight: '1.5', + }, + legend: { + display: 'flex', + gap: '16px', + marginBottom: '20px', + padding: '12px', + backgroundColor: '#f8fafc', + borderRadius: '8px', + flexWrap: 'wrap' as const, + }, + legendItem: { + display: 'flex', + alignItems: 'center', + gap: '6px', + }, + legendColor: (color: string) => ({ + width: '16px', + height: '16px', + backgroundColor: color, + borderRadius: '4px', + }), + legendText: { + fontSize: '13px', + color: '#475569', + }, + section: { + marginBottom: '24px', + }, + sectionTitle: { + fontSize: '16px', + fontWeight: 'bold' as const, + color: '#334155', + marginBottom: '12px', + }, +} + +// Color constants for easy reference +export const colors = { + server: '#0284c7', + serverLight: '#e0f2fe', + client: '#16a34a', + clientLight: '#dcfce7', + async: '#f59e0b', + asyncLight: '#fef3c7', +} + +/** + * Format a timestamp for display. + * Uses a fixed UTC format to avoid hydration mismatch between server and client. + */ +export function formatTime(timestamp: number): string { + const d = new Date(timestamp) + const hh = String(d.getUTCHours()).padStart(2, '0') + const mm = String(d.getUTCMinutes()).padStart(2, '0') + const ss = String(d.getUTCSeconds()).padStart(2, '0') + return `${hh}:${mm}:${ss} UTC` +} diff --git a/e2e/react-start/rsc/tests/hydration.ts b/e2e/react-start/rsc/tests/hydration.ts new file mode 100644 index 0000000000..ed6e97c673 --- /dev/null +++ b/e2e/react-start/rsc/tests/hydration.ts @@ -0,0 +1,7 @@ +import { expect, type Page } from '@playwright/test' + +export async function waitForHydration(page: Page) { + await expect(page.getByTestId('app-hydrated')).toHaveText('hydrated', { + timeout: 15000, + }) +} diff --git a/e2e/react-start/rsc/tests/rsc-async-bundle.spec.ts b/e2e/react-start/rsc/tests/rsc-async-bundle.spec.ts new file mode 100644 index 0000000000..452ba404bd --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-async-bundle.spec.ts @@ -0,0 +1,285 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC Async Bundle Tests - Multiple RSC Promises with React.use()', () => { + test('Loading states appear for each RSC before they resolve', async ({ + page, + }) => { + await page.goto('/rsc-async-bundle') + + // Check page title appears immediately + await expect(page.getByTestId('rsc-async-bundle-page-title')).toHaveText( + 'Async RSC Bundle - Progressive Loading with React.use()', + ) + + // Loading states should be visible initially or briefly + // Note: The fast component (100ms) may load too quickly to catch, + // but we should see the slow one loading + const slowLoading = page.getByTestId('loading-slow') + + // Wait for the slow component to finish loading (1500ms + buffer) + await expect( + page.getByTestId('async-slow-wrapper').getByTestId('rsc-async-slow'), + ).toBeVisible({ + timeout: 5000, + }) + }) + + test('All three RSCs render after loading completes', async ({ page }) => { + await page.goto('/rsc-async-bundle') + + // Wait for all RSCs to load (slowest is 1500ms) + // Use specific wrappers to avoid ambiguity + await expect( + page.getByTestId('async-fast-wrapper').getByTestId('rsc-async-fast'), + ).toBeVisible({ + timeout: 3000, + }) + await expect( + page.getByTestId('async-medium-wrapper').getByTestId('rsc-async-medium'), + ).toBeVisible({ + timeout: 3000, + }) + await expect( + page.getByTestId('async-slow-wrapper').getByTestId('rsc-async-slow'), + ).toBeVisible({ + timeout: 3000, + }) + + // Verify content of each RSC + await expect(page.getByTestId('rsc-async-fast-title')).toHaveText( + 'Fast Loading Component', + ) + await expect(page.getByTestId('rsc-async-medium-title').first()).toHaveText( + 'Medium Loading Component', + ) + await expect(page.getByTestId('rsc-async-slow-title')).toHaveText( + 'Slow Loading Component', + ) + }) + + test('All RSCs eventually load and are visible', async ({ page }) => { + await page.goto('/rsc-async-bundle') + + // All three RSCs should load (fast at 100ms, medium at 500ms, slow at 1500ms) + // We just verify they all eventually render + + // Fast should be visible first (100ms delay) + await expect( + page.getByTestId('async-fast-wrapper').getByTestId('rsc-async-fast'), + ).toBeVisible({ + timeout: 3000, + }) + + // Medium comes next (500ms delay) + await expect( + page.getByTestId('async-medium-wrapper').getByTestId('rsc-async-medium'), + ).toBeVisible({ + timeout: 3000, + }) + + // Slow is last (1500ms delay) + await expect( + page.getByTestId('async-slow-wrapper').getByTestId('rsc-async-slow'), + ).toBeVisible({ + timeout: 3000, + }) + + // Verify each has its correct content + await expect(page.getByTestId('rsc-async-fast-icon')).toHaveText('⚡') + await expect(page.getByTestId('rsc-async-medium-icon').first()).toHaveText( + '⏳', + ) + await expect(page.getByTestId('rsc-async-slow-icon')).toHaveText('🐢') + }) + + test('Client slots work in async-loaded RSCs', async ({ page }) => { + await page.goto('/rsc-async-bundle') + + // Wait for medium RSC to load (has a client slot) + await expect( + page.getByTestId('async-medium-wrapper').getByTestId('rsc-async-medium'), + ).toBeVisible({ + timeout: 3000, + }) + await expect(page.getByTestId('medium-slot-btn')).toBeEnabled() + + // Verify the slot content is rendered + await expect( + page.getByTestId('rsc-async-medium-slot').first(), + ).toBeVisible() + + // Click the button in the slot + await expect(page.getByTestId('medium-slot-btn')).toContainText( + 'Interact (0)', + ) + await page.getByTestId('medium-slot-btn').click() + await expect(page.getByTestId('medium-slot-btn')).toContainText( + 'Interact (1)', + ) + + // Verify interaction count updates + await expect(page.getByTestId('interaction-count')).toHaveText('1') + }) + + test('Render props work in async-loaded RSCs', async ({ page }) => { + await page.goto('/rsc-async-bundle') + + // Wait for slow RSC to load (has a render prop) + await expect( + page.getByTestId('async-slow-wrapper').getByTestId('rsc-async-slow'), + ).toBeVisible({ + timeout: 5000, + }) + await expect(page.getByTestId('increment-btn')).toBeEnabled() + + // Verify render prop content is displayed + await expect(page.getByTestId('rsc-async-slow-status')).toBeVisible() + await expect(page.getByTestId('slow-status-content')).toContainText( + 'Status: Loaded!', + ) + await expect(page.getByTestId('slow-status-content')).toContainText( + 'Interactions: 0', + ) + + // Increment and verify render prop updates + await page.getByTestId('increment-btn').click() + await expect(page.getByTestId('slow-status-content')).toContainText( + 'Interactions: 1', + ) + }) + + test('All RSCs share the same bundle ID and timestamp', async ({ page }) => { + await page.goto('/rsc-async-bundle') + + // Wait for all RSCs to load + await expect( + page.getByTestId('async-slow-wrapper').getByTestId('rsc-async-slow'), + ).toBeVisible({ + timeout: 5000, + }) + + // Get bundle info + const bundleId = await page.getByTestId('bundle-id').textContent() + const timestamp = await page.getByTestId('bundle-timestamp').textContent() + + expect(bundleId).toBeTruthy() + expect(bundleId!.length).toBeGreaterThan(0) + expect(timestamp).toBeTruthy() + + // The fast RSC should show the same bundle ID + await expect(page.getByTestId('rsc-async-fast-bundle')).toContainText( + `Bundle: ${bundleId}`, + ) + }) + + test('Client interactions do not reload async RSCs', async ({ page }) => { + await page.goto('/rsc-async-bundle') + + // Wait for all RSCs to load + await expect( + page.getByTestId('async-slow-wrapper').getByTestId('rsc-async-slow'), + ).toBeVisible({ + timeout: 5000, + }) + await expect(page.getByTestId('increment-btn')).toBeEnabled() + + // Get initial timestamps + const fastTimestamp = await page + .getByTestId('rsc-async-fast-timestamp') + .textContent() + const mediumTimestamp = await page + .getByTestId('rsc-async-medium-timestamp') + .first() + .textContent() + const slowTimestamp = await page + .getByTestId('rsc-async-slow-timestamp') + .textContent() + + // Perform multiple interactions + await page.getByTestId('increment-btn').click() + await page.getByTestId('medium-slot-btn').click() + await page.getByTestId('increment-btn').click() + + // Verify interaction count updated + await expect(page.getByTestId('interaction-count')).toHaveText('3') + + // Verify timestamps haven't changed (RSCs not reloaded) + await expect(page.getByTestId('rsc-async-fast-timestamp')).toHaveText( + fastTimestamp!, + ) + await expect( + page.getByTestId('rsc-async-medium-timestamp').first(), + ).toHaveText(mediumTimestamp!) + await expect(page.getByTestId('rsc-async-slow-timestamp')).toHaveText( + slowTimestamp!, + ) + }) + + test('Async RSCs render correctly after client-side navigation', async ({ + page, + }) => { + // Start at home + await page.goto('/') + await page.waitForURL('/') + await waitForHydration(page) + + // Navigate to async bundle page via link (if nav exists) or direct navigation + await page.goto('/rsc-async-bundle') + await page.waitForURL(/\/rsc-async-bundle/) + + // Wait for all RSCs to load + await expect( + page.getByTestId('async-slow-wrapper').getByTestId('rsc-async-slow'), + ).toBeVisible({ + timeout: 5000, + }) + + // Verify all RSCs rendered correctly + await expect( + page.getByTestId('async-fast-wrapper').getByTestId('rsc-async-fast'), + ).toBeVisible() + await expect( + page.getByTestId('async-medium-wrapper').getByTestId('rsc-async-medium'), + ).toBeVisible() + await expect( + page.getByTestId('async-slow-wrapper').getByTestId('rsc-async-slow'), + ).toBeVisible() + + // Verify interactivity works after navigation + await expect(page.getByTestId('increment-btn')).toBeEnabled() + await page.getByTestId('increment-btn').click() + await expect(page.getByTestId('interaction-count')).toHaveText('1') + }) + + test('Multiple page visits get new bundle IDs', async ({ page }) => { + // First visit + await page.goto('/rsc-async-bundle') + await expect( + page.getByTestId('async-slow-wrapper').getByTestId('rsc-async-slow'), + ).toBeVisible({ + timeout: 5000, + }) + const firstBundleId = await page.getByTestId('bundle-id').textContent() + + // Navigate away + await page.goto('/') + await page.waitForURL('/') + await waitForHydration(page) + + // Second visit (force new request) + await page.goto('/rsc-async-bundle') + await expect( + page.getByTestId('async-slow-wrapper').getByTestId('rsc-async-slow'), + ).toBeVisible({ + timeout: 5000, + }) + const secondBundleId = await page.getByTestId('bundle-id').textContent() + + // Bundle IDs should be different (new server request) + expect(firstBundleId).toBeTruthy() + expect(secondBundleId).toBeTruthy() + // Note: They might be same if cached, but this tests the structure works + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-basic.spec.ts b/e2e/react-start/rsc/tests/rsc-basic.spec.ts new file mode 100644 index 0000000000..6bfa18e96b --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-basic.spec.ts @@ -0,0 +1,43 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC Basic Tests', () => { + test('RSC renders with server timestamp', async ({ page }) => { + await page.goto('/rsc-basic') + await page.waitForURL('/rsc-basic') + + // Verify RSC content is rendered + await expect(page.getByTestId('rsc-basic-content')).toBeVisible() + await expect(page.getByTestId('rsc-server-timestamp')).toBeVisible() + await expect(page.getByTestId('rsc-label')).toContainText('Sarah Chen') + + // Verify timestamps are present + const serverTimestamp = await page + .getByTestId('rsc-server-timestamp') + .textContent() + const loaderTimestamp = await page + .getByTestId('loader-timestamp') + .textContent() + + expect(serverTimestamp).toContain('Fetched:') + expect(Number(loaderTimestamp)).toBeGreaterThan(0) + }) + + test('RSC renders correctly after client-side navigation', async ({ + page, + }) => { + // Start from home + await page.goto('/') + await page.waitForURL('/') + await waitForHydration(page) + + // Navigate to RSC page via nav bar (need to be specific to avoid matching example cards) + await page.getByTestId('nav-basic').click() + await page.waitForURL('/rsc-basic') + + // Verify RSC content is rendered + await expect(page.getByTestId('rsc-basic-content')).toBeVisible() + await expect(page.getByTestId('rsc-label')).toContainText('Sarah Chen') + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-bundle.spec.ts b/e2e/react-start/rsc/tests/rsc-bundle.spec.ts new file mode 100644 index 0000000000..346264b89c --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-bundle.spec.ts @@ -0,0 +1,162 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC Bundle Tests - Multiple RSCs from single server function', () => { + test('All bundled RSCs render correctly on initial load', async ({ + page, + }) => { + await page.goto('/rsc-bundle') + await page.waitForURL('/rsc-bundle') + + // Verify page title + await expect(page.getByTestId('rsc-bundle-page-title')).toHaveText( + 'Page Layout Bundle - Multiple RSCs from Single Server Function', + ) + + // Verify Header RSC is rendered + await expect(page.getByTestId('rsc-bundle-header')).toBeVisible() + await expect(page.getByTestId('rsc-bundle-logo')).toContainText('TechCorp') + await expect(page.getByTestId('rsc-bundle-avatar')).toContainText('JD') + + // Verify Content RSC is rendered + await expect(page.getByTestId('rsc-bundle-content')).toBeVisible() + await expect(page.getByTestId('rsc-bundle-title')).toContainText( + 'Dashboard Overview', + ) + await expect(page.getByTestId('rsc-bundle-subtitle')).toContainText( + 'Welcome to your dashboard', + ) + const contentTimestamp = await page + .getByTestId('rsc-bundle-content-timestamp') + .textContent() + expect(contentTimestamp).toBeTruthy() + + // Verify stats are rendered + await expect(page.getByTestId('rsc-bundle-stat-total-users')).toBeVisible() + await expect( + page.getByTestId('rsc-bundle-stat-active-sessions'), + ).toBeVisible() + await expect(page.getByTestId('rsc-bundle-stat-revenue')).toBeVisible() + + // Verify Footer RSC is rendered + await expect(page.getByTestId('rsc-bundle-footer')).toBeVisible() + await expect(page.getByTestId('rsc-bundle-copyright')).toContainText( + '2024 TechCorp Inc.', + ) + await expect(page.getByTestId('rsc-bundle-version')).toContainText('v2.4.1') + }) + + test('Client slots in bundled RSCs work correctly', async ({ page }) => { + await page.goto('/rsc-bundle') + await page.waitForURL('/rsc-bundle') + await waitForHydration(page) + + // Verify client actions area is rendered + await expect(page.getByTestId('content-actions')).toBeVisible() + + // Verify initial action count + await expect(page.getByTestId('action-count')).toContainText( + 'Actions performed: 0', + ) + + // Click the action button + await page.getByTestId('action-btn').click() + await expect(page.getByTestId('action-count')).toContainText( + 'Actions performed: 1', + ) + + // Click the user menu button in header + await page.getByTestId('user-menu-btn').click() + await expect(page.getByTestId('action-count')).toContainText( + 'Actions performed: 2', + ) + + // Click action button again + await page.getByTestId('action-btn').click() + await expect(page.getByTestId('action-count')).toContainText( + 'Actions performed: 3', + ) + }) + + test('Client interactions do not reload bundled RSCs', async ({ page }) => { + await page.goto('/rsc-bundle') + await page.waitForURL('/rsc-bundle') + await waitForHydration(page) + + // Get initial timestamp + const initialTimestamp = await page + .getByTestId('rsc-bundle-content-timestamp') + .textContent() + + // Perform multiple client interactions + await page.getByTestId('action-btn').click() + await page.getByTestId('user-menu-btn').click() + await page.getByTestId('action-btn').click() + + // Verify timestamp hasn't changed (RSCs not reloaded) + const newTimestamp = await page + .getByTestId('rsc-bundle-content-timestamp') + .textContent() + expect(newTimestamp).toBe(initialTimestamp) + }) + + test('Bundled RSCs share the same bundle ID', async ({ page }) => { + await page.goto('/rsc-bundle') + await page.waitForURL('/rsc-bundle') + + // Get the bundle ID from the hidden span + const bundleId = await page.getByTestId('bundle-id').textContent() + expect(bundleId).toBeTruthy() + expect(bundleId!.length).toBeGreaterThan(0) + + // All three RSCs should be from the same bundle (verified by shared timestamp) + const timestamp = await page.getByTestId('bundle-timestamp').textContent() + expect(timestamp).toBeTruthy() + }) + + test('Bundled RSCs render correctly after client-side navigation', async ({ + page, + }) => { + // Start at home + await page.goto('/') + await page.waitForURL('/') + await waitForHydration(page) + + // Navigate to bundle page via nav bar (use exact match to avoid 'Async Bundle') + await page.getByTestId('nav-bundle').click() + await page.waitForURL('/rsc-bundle') + + // Verify all three RSCs are rendered + await expect(page.getByTestId('rsc-bundle-header')).toBeVisible() + await expect(page.getByTestId('rsc-bundle-content')).toBeVisible() + await expect(page.getByTestId('rsc-bundle-footer')).toBeVisible() + + // Verify the nesting structure + const contentActions = page.getByTestId('content-actions') + await expect(contentActions).toBeVisible() + }) + + test('Multiple bundle page visits get new bundle IDs', async ({ page }) => { + // First visit + await page.goto('/rsc-bundle') + await page.waitForURL('/rsc-bundle') + const firstBundleId = await page.getByTestId('bundle-id').textContent() + + // Navigate away + await page.goto('/') + await page.waitForURL('/') + await waitForHydration(page) + + // Second visit (force reload) + await page.goto('/rsc-bundle') + await page.waitForURL('/rsc-bundle') + const secondBundleId = await page.getByTestId('bundle-id').textContent() + + // Bundle IDs should be different (new server request) + expect(firstBundleId).toBeTruthy() + expect(secondBundleId).toBeTruthy() + // Note: They might be the same if cached, but the timestamp should differ + // on a full page reload. This test mainly verifies the bundle structure works. + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-caching.spec.ts b/e2e/react-start/rsc/tests/rsc-caching.spec.ts new file mode 100644 index 0000000000..6a9c39aa38 --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-caching.spec.ts @@ -0,0 +1,164 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC Caching Tests - staleTime behavior', () => { + test('Page loads with cache controls visible', async ({ page }) => { + await page.goto('/rsc-caching') + await page.waitForURL('/rsc-caching') + + // Verify page title + await expect(page.getByTestId('rsc-caching-title')).toHaveText( + 'Analytics Widget - RSC Caching', + ) + + // Verify cache controls are visible + await expect(page.getByTestId('cache-controls')).toBeVisible() + await expect(page.getByTestId('force-refresh-btn')).toBeVisible() + + // Verify initial invalidation count is 0 + await expect(page.getByTestId('invalidate-count')).toContainText( + 'Manual invalidations: 0', + ) + }) + + test('Force refresh button triggers RSC refetch', async ({ page }) => { + await page.goto('/rsc-caching') + await page.waitForURL('/rsc-caching') + await waitForHydration(page) + + // Get initial timestamp + const initialTimestamp = await page + .getByTestId('loader-timestamp') + .textContent() + + // Click force refresh + await page.getByTestId('force-refresh-btn').click() + + await expect(page.getByTestId('invalidate-count')).toContainText( + 'Manual invalidations: 1', + ) + await expect(page.getByTestId('loader-timestamp')).not.toHaveText( + initialTimestamp!, + ) + + // Verify timestamp changed + const newTimestamp = await page + .getByTestId('loader-timestamp') + .textContent() + expect(Number(newTimestamp)).toBeGreaterThan(Number(initialTimestamp)) + }) + + test('Multiple force refreshes increment counter', async ({ page }) => { + await page.goto('/rsc-caching') + await page.waitForURL('/rsc-caching') + await waitForHydration(page) + + // Click force refresh multiple times + await page.getByTestId('force-refresh-btn').click() + await expect(page.getByTestId('invalidate-count')).toContainText( + 'Manual invalidations: 1', + ) + + await page.getByTestId('force-refresh-btn').click() + await expect(page.getByTestId('invalidate-count')).toContainText( + 'Manual invalidations: 2', + ) + + await page.getByTestId('force-refresh-btn').click() + await expect(page.getByTestId('invalidate-count')).toContainText( + 'Manual invalidations: 3', + ) + }) + + test('Navigation away and back within staleTime uses cached data', async ({ + page, + }) => { + await page.goto('/rsc-caching') + await page.waitForURL('/rsc-caching') + await waitForHydration(page) + + // Get initial timestamp + const initialTimestamp = await page + .getByTestId('loader-timestamp') + .textContent() + + // Navigate away quickly + await page.goto('/') + await page.waitForURL('/') + + // Navigate back immediately (within 10s staleTime) + await page.goto('/rsc-caching') + await page.waitForURL('/rsc-caching') + + // The timestamp should be the same (cached data) + // Note: This depends on TanStack Router's caching behavior + const cachedTimestamp = await page + .getByTestId('loader-timestamp') + .textContent() + + // Due to how the test environment works, caching may or may not be in effect + // The important thing is that the page works correctly + expect(cachedTimestamp).toBeTruthy() + }) + + test('Each force refresh updates the timestamp', async ({ page }) => { + await page.goto('/rsc-caching') + await page.waitForURL('/rsc-caching') + await waitForHydration(page) + + const timestamps: number[] = [] + + // Get initial timestamp + const initial = await page.getByTestId('loader-timestamp').textContent() + timestamps.push(Number(initial)) + + // Do 3 force refreshes, collecting timestamps + for (let i = 0; i < 3; i++) { + const previousTimestamp = String(timestamps[timestamps.length - 1]) + await page.getByTestId('force-refresh-btn').click() + await expect(page.getByTestId('loader-timestamp')).not.toHaveText( + previousTimestamp, + ) + await page.waitForTimeout(50) + const ts = await page.getByTestId('loader-timestamp').textContent() + timestamps.push(Number(ts)) + } + + // Each timestamp should be greater than the previous + for (let i = 1; i < timestamps.length; i++) { + expect(timestamps[i]).toBeGreaterThan(timestamps[i - 1]) + } + }) + + test('Loader timestamp is displayed correctly', async ({ page }) => { + await page.goto('/rsc-caching') + await page.waitForURL('/rsc-caching') + + // Get the hidden timestamp value + const timestamp = await page.getByTestId('loader-timestamp').textContent() + + // It should be a valid timestamp (within the last minute) + const ts = Number(timestamp) + const now = Date.now() + expect(ts).toBeGreaterThan(now - 60000) + expect(ts).toBeLessThanOrEqual(now + 1000) // Allow 1s buffer + }) + + test('Client-side navigation to caching page works', async ({ page }) => { + // Start at home + await page.goto('/') + await page.waitForURL('/') + await waitForHydration(page) + + // Navigate to caching page via nav bar + await page.getByTestId('nav-caching').click() + await page.waitForURL('/rsc-caching') + + // Verify page loaded correctly + await expect(page.getByTestId('rsc-caching-title')).toHaveText( + 'Analytics Widget - RSC Caching', + ) + await expect(page.getByTestId('cache-controls')).toBeVisible() + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-client-preload.spec.ts b/e2e/react-start/rsc/tests/rsc-client-preload.spec.ts new file mode 100644 index 0000000000..d8ebe25dcf --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-client-preload.spec.ts @@ -0,0 +1,180 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC Client Component Preload Tests', () => { + function getLinkHrefs(html: string, rel: string): Array { + return Array.from( + html.matchAll(/]*>/g), + (match) => match[0], + ).flatMap((tag) => { + const relValue = tag.match(/\brel="([^"]*)"/)?.[1] + const href = tag.match(/\bhref="([^"]*)"/)?.[1] + return relValue?.split(/\s+/).includes(rel) && href ? [href] : [] + }) + } + + function getModulePreloads(html: string): Array { + return getLinkHrefs(html, 'modulepreload') + } + + function getStylesheets(html: string): Array { + return getLinkHrefs(html, 'stylesheet') + } + + test('client component JS is modulepreloaded in SSR HTML', async ({ + page, + }) => { + const basicHtml = await (await page.goto('/rsc-basic'))?.text() + const preloadHtml = await (await page.goto('/rsc-client-preload'))?.text() + + expect(basicHtml).toBeDefined() + expect(preloadHtml).toBeDefined() + + const basicPreloads = getModulePreloads(basicHtml!) + const preloadPreloads = getModulePreloads(preloadHtml!) + + expect(preloadPreloads.length).toBeGreaterThan(basicPreloads.length) + + const basicPreloadSet = new Set(basicPreloads) + const extraPreloads = preloadPreloads.filter( + (href) => !basicPreloadSet.has(href), + ) + + expect(extraPreloads.length).toBeGreaterThan(0) + expect(extraPreloads.some((href) => href.includes('/assets/'))).toBe(true) + }) + + test('client component CSS is included in SSR HTML', async ({ page }) => { + const response = await page.goto('/rsc-client-preload') + const html = await response?.text() + await page.waitForURL('/rsc-client-preload') + + expect(html).toBeDefined() + + // Verify client component is visible + await expect(page.getByTestId('client-widget')).toBeVisible() + + const stylesheetHrefs = getStylesheets(html!) + + expect(stylesheetHrefs.length).toBeGreaterThan(0) + expect(stylesheetHrefs.some((href) => href.includes('/assets/'))).toBe(true) + }) + + test('client component renders with CSS module styles applied', async ({ + page, + }) => { + await page.goto('/rsc-client-preload') + await page.waitForURL('/rsc-client-preload') + + // Verify client component is visible + const widget = page.getByTestId('client-widget') + await expect(widget).toBeVisible() + + // Verify CSS module styles are applied + const backgroundColor = await widget.evaluate( + (el) => getComputedStyle(el).backgroundColor, + ) + // #dcfce7 in RGB is rgb(220, 252, 231) + expect(backgroundColor).toBe('rgb(220, 252, 231)') + + const borderColor = await widget.evaluate( + (el) => getComputedStyle(el).borderColor, + ) + // #16a34a in RGB is rgb(22, 163, 74) + expect(borderColor).toBe('rgb(22, 163, 74)') + }) + + test('client component is interactive after hydration', async ({ page }) => { + await page.goto('/rsc-client-preload') + await page.waitForURL('/rsc-client-preload') + await waitForHydration(page) + + // Verify initial count is 0 + await expect(page.getByTestId('client-widget-count')).toHaveText('0') + + // Click increment button + await page.getByTestId('client-widget-increment').click() + await expect(page.getByTestId('client-widget-count')).toHaveText('1') + + // Click increment again + await page.getByTestId('client-widget-increment').click() + await expect(page.getByTestId('client-widget-count')).toHaveText('2') + + // Click decrement + await page.getByTestId('client-widget-decrement').click() + await expect(page.getByTestId('client-widget-count')).toHaveText('1') + }) + + test('hydrates without console errors', async ({ page }) => { + const consoleErrors: string[] = [] + page.on('console', (msg) => { + if (msg.type() === 'error') { + consoleErrors.push(msg.text()) + } + }) + + await page.goto('/rsc-client-preload') + await page.waitForURL('/rsc-client-preload') + await waitForHydration(page) + + // Verify content is visible + await expect(page.getByTestId('client-widget')).toBeVisible() + + // Check for hydration errors + const hydrationErrors = consoleErrors.filter( + (msg) => + msg.includes('Hydration') || + msg.includes('hydration') || + msg.includes("didn't match"), + ) + expect(hydrationErrors).toHaveLength(0) + }) + + test('server component wrapper is rendered', async ({ page }) => { + await page.goto('/rsc-client-preload') + await page.waitForURL('/rsc-client-preload') + + // Verify server component wrapper + await expect(page.getByTestId('rsc-client-preload-server')).toBeVisible() + await expect(page.getByTestId('rsc-client-preload-title')).toContainText( + 'Client Component Preload Test', + ) + + // Verify client component inside server component slot + await expect(page.getByTestId('client-widget-badge')).toContainText( + 'CLIENT COMPONENT', + ) + }) + + test('CSS module classes are scoped (hashed)', async ({ page }) => { + await page.goto('/rsc-client-preload') + await page.waitForURL('/rsc-client-preload') + + // Get the widget element and verify it has a scoped class name + const widget = page.getByTestId('client-widget') + await expect(widget).toBeVisible() + + // Get the class attribute - it should be a hashed class name from CSS modules + const className = await widget.getAttribute('class') + expect(className).toBeTruthy() + // CSS module class names are typically hashed, not plain "widget" + expect(className).not.toBe('widget') + // The class should contain some hash characters + expect(className!.length).toBeGreaterThan(5) + }) + + test('no flash of unstyled content on initial render', async ({ page }) => { + // This test verifies the page content is rendered from SSR with styles already applied + // We check that the initial HTML response includes the styled content + + const response = await page.goto('/rsc-client-preload') + const html = await response?.text() + + // Verify the HTML contains the client widget with a CSS module class + expect(html).toContain('data-testid="client-widget"') + // The class should be a hashed CSS module class (contains underscore from module hash) + // Accept Vite `_widget_xxx` or Rspack `widget-xxx` scoped CSS module names + expect(html).toMatch(/class="[^"]*(?:_widget_|widget[-_])[\w-]+[^"]*"/) + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-component-slot.spec.ts b/e2e/react-start/rsc/tests/rsc-component-slot.spec.ts new file mode 100644 index 0000000000..92b99373bb --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-component-slot.spec.ts @@ -0,0 +1,209 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC Component Slot Tests - Passing components as props', () => { + test('Renders server product card with client component slots', async ({ + page, + }) => { + await page.goto('/rsc-component-slot') + await page.waitForURL('/rsc-component-slot') + await waitForHydration(page) + + // Verify server-rendered product card + await expect(page.getByTestId('rsc-product-card')).toBeVisible() + await expect(page.getByTestId('product-name')).toContainText( + 'Premium Wireless Headphones', + ) + await expect(page.getByTestId('product-price')).toContainText('$299.99') + + // Verify client components are rendered in slots + await expect(page.getByTestId('rating-badge')).toBeVisible() + await expect(page.getByTestId('add-to-cart-btn')).toBeVisible() + await expect(page.getByTestId('product-id-display')).toContainText( + 'PRD-12345', + ) + }) + + test('Changing quantity does not reload RSC', async ({ page }) => { + await page.goto('/rsc-component-slot') + await page.waitForURL('/rsc-component-slot') + await waitForHydration(page) + + // Get initial RSC timestamp + const initialTimestamp = await page + .getByTestId('rsc-product-timestamp') + .textContent() + + // Verify initial quantity + await expect(page.getByTestId('quantity-display')).toContainText('1') + await expect(page.getByTestId('add-to-cart-btn')).toContainText( + 'Add to Cart - $299.99', + ) + + // Increase quantity + await page.getByTestId('increase-qty-btn').click() + await expect(page.getByTestId('quantity-display')).toContainText('2') + await expect(page.getByTestId('add-to-cart-btn')).toContainText( + 'Add to Cart - $599.98', + ) + + // Increase again + await page.getByTestId('increase-qty-btn').click() + await expect(page.getByTestId('quantity-display')).toContainText('3') + await expect(page.getByTestId('add-to-cart-btn')).toContainText( + 'Add to Cart - $899.97', + ) + + // Verify RSC timestamp is unchanged + const newTimestamp = await page + .getByTestId('rsc-product-timestamp') + .textContent() + expect(newTimestamp).toBe(initialTimestamp) + }) + + test('Toggling badge details does not reload RSC', async ({ page }) => { + await page.goto('/rsc-component-slot') + await page.waitForURL('/rsc-component-slot') + await waitForHydration(page) + + // Get initial RSC timestamp + const initialTimestamp = await page + .getByTestId('rsc-product-timestamp') + .textContent() + + // Verify badge without details initially + await expect(page.getByTestId('rating-badge')).toBeVisible() + await expect(page.getByTestId('rating-details')).not.toBeVisible() + + // Toggle to show details + await page.getByTestId('toggle-badge-details-btn').click() + await expect(page.getByTestId('rating-details')).toBeVisible() + await expect(page.getByTestId('rating-details')).toContainText('Excellent') + + // Toggle to hide details + await page.getByTestId('toggle-badge-details-btn').click() + await expect(page.getByTestId('rating-details')).not.toBeVisible() + + // Verify RSC timestamp is unchanged + const newTimestamp = await page + .getByTestId('rsc-product-timestamp') + .textContent() + expect(newTimestamp).toBe(initialTimestamp) + }) + + test('Add to cart interaction does not reload RSC', async ({ page }) => { + await page.goto('/rsc-component-slot') + await page.waitForURL('/rsc-component-slot') + await waitForHydration(page) + + // Get initial RSC timestamp + const initialTimestamp = await page + .getByTestId('rsc-product-timestamp') + .textContent() + + // Click add to cart + await page.getByTestId('add-to-cart-btn').click() + + // Verify button state changes + await expect(page.getByTestId('add-to-cart-btn')).toContainText('Adding...') + await expect(page.getByTestId('add-to-cart-btn')).toContainText( + '✓ Added!', + { timeout: 2000 }, + ) + + // Wait for button to reset + await expect(page.getByTestId('add-to-cart-btn')).toContainText( + 'Add to Cart', + { timeout: 3000 }, + ) + + // Verify RSC timestamp is unchanged + const newTimestamp = await page + .getByTestId('rsc-product-timestamp') + .textContent() + expect(newTimestamp).toBe(initialTimestamp) + }) + + test('Multiple component slot changes do not reload RSC', async ({ + page, + }) => { + await page.goto('/rsc-component-slot') + await page.waitForURL('/rsc-component-slot') + await waitForHydration(page) + + // Get initial RSC timestamp + const initialTimestamp = await page + .getByTestId('rsc-product-timestamp') + .textContent() + + // Make multiple changes + await page.getByTestId('increase-qty-btn').click() + await page.getByTestId('increase-qty-btn').click() + await page.getByTestId('toggle-badge-details-btn').click() + await page.getByTestId('decrease-qty-btn').click() + + // Verify all changes took effect + await expect(page.getByTestId('quantity-display')).toContainText('2') + await expect(page.getByTestId('rating-details')).toBeVisible() + await expect(page.getByTestId('add-to-cart-btn')).toContainText( + 'Add to Cart - $599.98', + ) + + // Verify RSC timestamp is unchanged + const newTimestamp = await page + .getByTestId('rsc-product-timestamp') + .textContent() + expect(newTimestamp).toBe(initialTimestamp) + }) + + test('Reset quantity works without reloading RSC', async ({ page }) => { + await page.goto('/rsc-component-slot') + await page.waitForURL('/rsc-component-slot') + await waitForHydration(page) + + // Get initial RSC timestamp + const initialTimestamp = await page + .getByTestId('rsc-product-timestamp') + .textContent() + + // Increase quantity + await page.getByTestId('increase-qty-btn').click() + await page.getByTestId('increase-qty-btn').click() + await page.getByTestId('increase-qty-btn').click() + await expect(page.getByTestId('quantity-display')).toContainText('4') + + // Reset quantity + await page.getByTestId('reset-quantity-btn').click() + await expect(page.getByTestId('quantity-display')).toContainText('1') + await expect(page.getByTestId('add-to-cart-btn')).toContainText( + 'Add to Cart - $299.99', + ) + + // Verify RSC timestamp is unchanged + const newTimestamp = await page + .getByTestId('rsc-product-timestamp') + .textContent() + expect(newTimestamp).toBe(initialTimestamp) + }) + + test('Server provides data to client components via props', async ({ + page, + }) => { + await page.goto('/rsc-component-slot') + await page.waitForURL('/rsc-component-slot') + await waitForHydration(page) + + // Verify server-provided data is passed to client components + // Product ID comes from server and is displayed in client component + await expect(page.getByTestId('product-id-display')).toContainText( + 'PRD-12345', + ) + + // Price comes from server and is used in cart calculation + await expect(page.getByTestId('add-to-cart-btn')).toContainText('$299.99') + + // Rating comes from server and is displayed in badge + await expect(page.getByTestId('rating-badge')).toContainText('4.8') + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-context.spec.ts b/e2e/react-start/rsc/tests/rsc-context.spec.ts new file mode 100644 index 0000000000..85492318eb --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-context.spec.ts @@ -0,0 +1,166 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC Context Tests - React Context interaction', () => { + test('Page loads with context controls visible', async ({ page }) => { + await page.goto('/rsc-context') + await page.waitForURL('/rsc-context') + + // Verify page title + await expect(page.getByTestId('rsc-context-title')).toHaveText( + 'User Preferences - RSC with Context', + ) + + // Verify context controls are visible + await expect(page.getByTestId('context-controls')).toBeVisible() + await expect(page.getByTestId('toggle-theme-btn')).toBeVisible() + await expect(page.getByTestId('toggle-notifications-btn')).toBeVisible() + + // Verify initial theme is light + await expect(page.getByTestId('current-theme')).toContainText( + 'Theme: light', + ) + }) + + test('Theme toggle changes context', async ({ page }) => { + await page.goto('/rsc-context') + await page.waitForURL('/rsc-context') + await waitForHydration(page) + + // Verify initial theme + await expect(page.getByTestId('current-theme')).toContainText( + 'Theme: light', + ) + await expect(page.getByTestId('client-theme')).toContainText('light') + + // Toggle theme to dark + await page.getByTestId('toggle-theme-btn').click() + + // Verify theme changed + await expect(page.getByTestId('current-theme')).toContainText('Theme: dark') + await expect(page.getByTestId('client-theme')).toContainText('dark') + + // Toggle back to light + await page.getByTestId('toggle-theme-btn').click() + + // Verify theme changed back + await expect(page.getByTestId('current-theme')).toContainText( + 'Theme: light', + ) + await expect(page.getByTestId('client-theme')).toContainText('light') + }) + + test('Notifications toggle works correctly', async ({ page }) => { + await page.goto('/rsc-context') + await page.waitForURL('/rsc-context') + await waitForHydration(page) + + // Verify initial notifications state is ON + await expect(page.getByTestId('toggle-notifications-btn')).toContainText( + 'Notifications: ON', + ) + await expect(page.getByTestId('client-notifications')).toContainText('ON') + + // Toggle notifications off + await page.getByTestId('toggle-notifications-btn').click() + + // Verify notifications changed + await expect(page.getByTestId('toggle-notifications-btn')).toContainText( + 'Notifications: OFF', + ) + await expect(page.getByTestId('client-notifications')).toContainText('OFF') + + // Toggle back on + await page.getByTestId('toggle-notifications-btn').click() + + // Verify notifications changed back + await expect(page.getByTestId('toggle-notifications-btn')).toContainText( + 'Notifications: ON', + ) + await expect(page.getByTestId('client-notifications')).toContainText('ON') + }) + + test('Theme changes do not refetch RSC', async ({ page }) => { + await page.goto('/rsc-context') + await page.waitForURL('/rsc-context') + await waitForHydration(page) + + // Get initial timestamp + const initialTimestamp = await page + .getByTestId('loader-timestamp') + .textContent() + + // Toggle theme multiple times + await page.getByTestId('toggle-theme-btn').click() + await expect(page.getByTestId('current-theme')).toContainText('Theme: dark') + await page.getByTestId('toggle-theme-btn').click() + await expect(page.getByTestId('current-theme')).toContainText( + 'Theme: light', + ) + await page.getByTestId('toggle-theme-btn').click() + await expect(page.getByTestId('current-theme')).toContainText('Theme: dark') + + // Verify timestamp hasn't changed (RSC not refetched) + const newTimestamp = await page + .getByTestId('loader-timestamp') + .textContent() + expect(newTimestamp).toBe(initialTimestamp) + }) + + test('Server data is displayed correctly', async ({ page }) => { + await page.goto('/rsc-context') + await page.waitForURL('/rsc-context') + + // Verify server data is displayed in the context consumer + await expect(page.getByTestId('context-consumer')).toBeVisible() + await expect(page.getByTestId('server-user-id')).toContainText('user_12345') + }) + + test('Context consumer shows both server and client data', async ({ + page, + }) => { + await page.goto('/rsc-context') + await page.waitForURL('/rsc-context') + await waitForHydration(page) + + // Verify context consumer is visible + await expect(page.getByTestId('context-consumer')).toBeVisible() + + // Verify server data + await expect(page.getByTestId('server-user-id')).toBeVisible() + + // Verify client data + await expect(page.getByTestId('client-theme')).toBeVisible() + await expect(page.getByTestId('client-notifications')).toBeVisible() + + // Toggle theme and verify client data updates + await page.getByTestId('toggle-theme-btn').click() + await expect(page.getByTestId('client-theme')).toContainText('dark') + + // Server data should remain unchanged + await expect(page.getByTestId('server-user-id')).toContainText('user_12345') + }) + + test('Multiple context changes work correctly', async ({ page }) => { + await page.goto('/rsc-context') + await page.waitForURL('/rsc-context') + await waitForHydration(page) + + // Change both theme and notifications + await page.getByTestId('toggle-theme-btn').click() + await page.getByTestId('toggle-notifications-btn').click() + + // Verify both changed + await expect(page.getByTestId('client-theme')).toContainText('dark') + await expect(page.getByTestId('client-notifications')).toContainText('OFF') + + // Change back + await page.getByTestId('toggle-theme-btn').click() + await page.getByTestId('toggle-notifications-btn').click() + + // Verify both changed back + await expect(page.getByTestId('client-theme')).toContainText('light') + await expect(page.getByTestId('client-notifications')).toContainText('ON') + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-css-autoinject.spec.ts b/e2e/react-start/rsc/tests/rsc-css-autoinject.spec.ts new file mode 100644 index 0000000000..5448210a4e --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-css-autoinject.spec.ts @@ -0,0 +1,29 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC CSS Auto Injection Tests', () => { + test('same-file CSS modules are auto-injected for all RSC render APIs', async ({ + page, + }) => { + await page.goto('/rsc-css-autoinject') + await page.waitForURL('/rsc-css-autoinject') + await waitForHydration(page) + + const renderable = page.getByTestId('rsc-css-autoinject-renderable') + const composite = page.getByTestId('rsc-css-autoinject-composite') + const flight = page.getByTestId('rsc-css-autoinject-flight') + + await expect(renderable).toBeVisible() + await expect(composite).toBeVisible() + await expect(flight).toBeVisible() + + for (const card of [renderable, composite, flight]) { + await expect(card).toHaveCSS('background-color', 'rgb(204, 251, 241)') + await expect(card).toHaveCSS('border-radius', '14px') + } + + const html = await page.content() + expect(html).toContain('data-rsc-css-href') + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-css-conditional.spec.ts b/e2e/react-start/rsc/tests/rsc-css-conditional.spec.ts new file mode 100644 index 0000000000..6056c7ef01 --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-css-conditional.spec.ts @@ -0,0 +1,73 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' + +test.describe('RSC Conditional CSS Tests', () => { + test('index page links to both variants', async ({ page }) => { + await page.goto('/rsc-css-conditional') + await page.waitForURL('/rsc-css-conditional') + + await expect( + page.getByTestId('rsc-css-conditional-index-title'), + ).toBeVisible() + await expect( + page.getByTestId('rsc-css-conditional-link-orange'), + ).toBeVisible() + await expect( + page.getByTestId('rsc-css-conditional-link-violet'), + ).toBeVisible() + }) + + test('orange branch styles render on direct load', async ({ page }) => { + await page.goto('/rsc-css-conditional/orange') + await page.waitForURL('/rsc-css-conditional/orange') + + const orangePanel = page.getByTestId('rsc-conditional-orange-panel') + await expect(page.getByTestId('rsc-css-conditional-hydrated')).toBeVisible() + await expect(orangePanel).toBeVisible() + await expect(page.getByTestId('rsc-conditional-violet-panel')).toHaveCount( + 0, + ) + + const bg = await orangePanel.evaluate( + (el) => getComputedStyle(el).backgroundColor, + ) + expect(bg).toBe('rgb(255, 237, 213)') + }) + + test('violet branch styles render on direct load', async ({ page }) => { + await page.goto('/rsc-css-conditional/violet') + await page.waitForURL('/rsc-css-conditional/violet') + + const violetPanel = page.getByTestId('rsc-conditional-violet-panel') + await expect(page.getByTestId('rsc-css-conditional-hydrated')).toBeVisible() + await expect(violetPanel).toBeVisible() + await expect(page.getByTestId('rsc-conditional-orange-panel')).toHaveCount( + 0, + ) + + const bg = await violetPanel.evaluate( + (el) => getComputedStyle(el).backgroundColor, + ) + expect(bg).toBe('rgb(237, 233, 254)') + }) + + test('conditional branch switches CSS on navigation', async ({ page }) => { + await page.goto('/rsc-css-conditional/orange') + await page.waitForURL('/rsc-css-conditional/orange') + + await expect(page.getByTestId('rsc-conditional-orange-panel')).toBeVisible() + await page.getByTestId('rsc-css-conditional-switch-link').click() + await page.waitForURL('/rsc-css-conditional/violet') + + const violetPanel = page.getByTestId('rsc-conditional-violet-panel') + await expect(violetPanel).toBeVisible() + await expect(page.getByTestId('rsc-conditional-orange-panel')).toHaveCount( + 0, + ) + + const bg = await violetPanel.evaluate( + (el) => getComputedStyle(el).backgroundColor, + ) + expect(bg).toBe('rgb(237, 233, 254)') + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-css-modules.spec.ts b/e2e/react-start/rsc/tests/rsc-css-modules.spec.ts new file mode 100644 index 0000000000..1065770f2f --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-css-modules.spec.ts @@ -0,0 +1,155 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC CSS Modules Tests', () => { + test('RSC with CSS modules hydrates without errors', async ({ page }) => { + // Collect console errors during navigation + const consoleErrors: string[] = [] + page.on('console', (msg) => { + if (msg.type() === 'error') { + consoleErrors.push(msg.text()) + } + }) + + await page.goto('/rsc-css-modules') + await page.waitForURL('/rsc-css-modules') + await waitForHydration(page) + + // Verify content is visible + await expect(page.getByTestId('rsc-css-modules-content')).toBeVisible() + + // Check for hydration errors + const hydrationErrors = consoleErrors.filter( + (msg) => + msg.includes('Hydration') || + msg.includes('hydration') || + msg.includes("didn't match"), + ) + expect(hydrationErrors).toHaveLength(0) + }) + + test('RSC renders with CSS module styles applied', async ({ page }) => { + await page.goto('/rsc-css-modules') + await page.waitForURL('/rsc-css-modules') + + // Verify RSC content is rendered + await expect(page.getByTestId('rsc-css-modules-content')).toBeVisible() + await expect(page.getByTestId('rsc-css-modules-badge')).toBeVisible() + await expect(page.getByTestId('rsc-css-modules-title')).toContainText( + 'CSS Modules in Server Components', + ) + + // Verify features list is rendered + await expect(page.getByTestId('rsc-css-modules-features')).toBeVisible() + await expect(page.getByTestId('rsc-css-modules-feature-1')).toBeVisible() + await expect(page.getByTestId('rsc-css-modules-feature-2')).toBeVisible() + await expect(page.getByTestId('rsc-css-modules-feature-3')).toBeVisible() + await expect(page.getByTestId('rsc-css-modules-feature-4')).toBeVisible() + + // Verify timestamp is present + const serverTimestamp = await page + .getByTestId('rsc-css-modules-timestamp') + .textContent() + expect(serverTimestamp).toContain('Fetched:') + }) + + test('CSS module classes are scoped (hashed)', async ({ page }) => { + await page.goto('/rsc-css-modules') + await page.waitForURL('/rsc-css-modules') + + // Get the container element and verify it has a scoped class name + const container = page.getByTestId('rsc-css-modules-content') + await expect(container).toBeVisible() + + // Get the class attribute - it should be a hashed class name from CSS modules + const className = await container.getAttribute('class') + expect(className).toBeTruthy() + // CSS module class names are typically hashed, not plain "container" + expect(className).not.toBe('container') + // The class should contain some hash characters (CSS modules add a hash) + expect(className!.length).toBeGreaterThan(5) + }) + + test('CSS module styles are actually applied', async ({ page }) => { + await page.goto('/rsc-css-modules') + await page.waitForURL('/rsc-css-modules') + + const container = page.getByTestId('rsc-css-modules-content') + await expect(container).toBeVisible() + + // Verify the CSS is applied by checking computed styles + const backgroundColor = await container.evaluate( + (el) => getComputedStyle(el).backgroundColor, + ) + // #e0f2fe in RGB is rgb(224, 242, 254) + expect(backgroundColor).toBe('rgb(224, 242, 254)') + + const borderRadius = await container.evaluate( + (el) => getComputedStyle(el).borderRadius, + ) + expect(borderRadius).toBe('8px') + + const accent = page.getByTestId('rsc-css-nested-accent') + const accentBg = await accent.evaluate( + (el) => getComputedStyle(el).backgroundColor, + ) + expect(accentBg).toBe('rgb(220, 252, 231)') + + const accentRadius = await accent.evaluate( + (el) => getComputedStyle(el).borderRadius, + ) + expect(accentRadius).toBe('12px') + }) + + test('RSC with CSS modules renders correctly after client-side navigation', async ({ + page, + }) => { + await page.goto('/') + await page.waitForURL('/') + await waitForHydration(page) + + await page.getByTestId('nav-css-modules').click() + await page.waitForURL('/rsc-css-modules') + + await expect(page.getByTestId('rsc-css-modules-content')).toBeVisible() + await expect(page.getByTestId('rsc-css-modules-title')).toContainText( + 'CSS Modules in Server Components', + ) + + const container = page.getByTestId('rsc-css-modules-content') + const backgroundColor = await container.evaluate( + (el) => getComputedStyle(el).backgroundColor, + ) + expect(backgroundColor).toBe('rgb(224, 242, 254)') + }) + + test('RSC CSS module styles persist across sibling client-side navigation', async ({ + page, + }) => { + await page.goto('/rsc-css-modules') + await page.waitForURL('/rsc-css-modules') + + const cssModulesContent = page.getByTestId('rsc-css-modules-content') + await expect(cssModulesContent).toBeVisible() + + const initialBackgroundColor = await cssModulesContent.evaluate( + (el) => getComputedStyle(el).backgroundColor, + ) + expect(initialBackgroundColor).toBe('rgb(224, 242, 254)') + + await page.getByTestId('nav-global-css').click() + await page.waitForURL('/rsc-global-css') + await expect(page.getByTestId('rsc-global-css-content')).toBeVisible() + + await page.getByTestId('nav-css-modules').click() + await page.waitForURL('/rsc-css-modules') + + await expect(cssModulesContent).toBeVisible() + + const finalBackgroundColor = await cssModulesContent.evaluate( + (el) => getComputedStyle(el).backgroundColor, + ) + expect(finalBackgroundColor).toBe('rgb(224, 242, 254)') + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-css-preload-complex.spec.ts b/e2e/react-start/rsc/tests/rsc-css-preload-complex.spec.ts new file mode 100644 index 0000000000..f5d8e04928 --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-css-preload-complex.spec.ts @@ -0,0 +1,299 @@ +import { expect, test } from '@playwright/test' + +test.describe('RSC Complex CSS Preload Tests', () => { + // ============================================================================ + // Test 1: ClientWidgetA (direct render) has CSS applied + // ============================================================================ + test('ClientWidgetA rendered directly in RSC has CSS applied', async ({ + page, + }) => { + await page.goto('/rsc-css-preload-complex') + + const widgetA = page.locator('[data-testid="client-widget-a"]') + await expect(widgetA).toBeVisible() + + // Check purple theme background (#f3e8ff) + const backgroundColor = await widgetA.evaluate( + (el) => getComputedStyle(el).backgroundColor, + ) + expect(backgroundColor).toBe('rgb(243, 232, 255)') + + // Check purple border (#9333ea) + const borderColor = await widgetA.evaluate( + (el) => getComputedStyle(el).borderColor, + ) + expect(borderColor).toBe('rgb(147, 51, 234)') + }) + + // ============================================================================ + // Test 2: ClientWidgetB (via slot) has CSS applied + // ============================================================================ + test('ClientWidgetB passed via children slot has CSS applied', async ({ + page, + }) => { + await page.goto('/rsc-css-preload-complex') + + const widgetB = page.locator('[data-testid="client-widget-b"]') + await expect(widgetB).toBeVisible() + + // Check teal theme background (#ccfbf1) + const backgroundColor = await widgetB.evaluate( + (el) => getComputedStyle(el).backgroundColor, + ) + expect(backgroundColor).toBe('rgb(204, 251, 241)') + + // Check teal border (#14b8a6) + const borderColor = await widgetB.evaluate( + (el) => getComputedStyle(el).borderColor, + ) + expect(borderColor).toBe('rgb(20, 184, 166)') + }) + + // ============================================================================ + // Test 3: ClientWidgetC (in unrendered RSC) is NOT in DOM + // ============================================================================ + test('ClientWidgetC in unrendered ServerB is not in DOM', async ({ + page, + }) => { + await page.goto('/rsc-css-preload-complex') + + // Widget C should NOT be present since ServerB is not rendered + const widgetC = page.locator('[data-testid="client-widget-c"]') + await expect(widgetC).not.toBeVisible() + await expect(widgetC).toHaveCount(0) + + // ServerB should also not be present + const serverB = page.locator('[data-testid="server-component-b"]') + await expect(serverB).not.toBeVisible() + await expect(serverB).toHaveCount(0) + }) + + // ============================================================================ + // Test 4: Both rendered widgets are interactive + // ============================================================================ + test('ClientWidgetA counter is interactive', async ({ page }) => { + await page.goto('/rsc-css-preload-complex') + + // Wait for hydration by waiting for button to be clickable + const incrementBtn = page.locator( + '[data-testid="client-widget-a-increment"]', + ) + await expect(incrementBtn).toBeVisible() + await expect(incrementBtn).toBeEnabled() + + const count = page.locator('[data-testid="client-widget-a-count"]') + await expect(count).toHaveText('0') + + await incrementBtn.click() + await expect(count).toHaveText('1') + + await incrementBtn.click() + await expect(count).toHaveText('2') + + await page.click('[data-testid="client-widget-a-decrement"]') + await expect(count).toHaveText('1') + }) + + test('ClientWidgetB toggle is interactive', async ({ page }) => { + await page.goto('/rsc-css-preload-complex') + + const toggle = page.locator('[data-testid="client-widget-b-toggle"]') + await expect(toggle).toBeVisible() + await expect(toggle).toBeEnabled() + + await expect(toggle).toHaveText('Inactive') + + await toggle.click() + await expect(toggle).toHaveText('Active') + + await toggle.click() + await expect(toggle).toHaveText('Inactive') + }) + + // ============================================================================ + // Test 5: CSS module classes are scoped (hashed) + // ============================================================================ + test('CSS module classes are scoped for all widgets', async ({ page }) => { + await page.goto('/rsc-css-preload-complex') + + // Widget A classes should be hashed (accept Vite `_widget_xxx` or Rspack `widget-xxx` scoped names) + const widgetA = page.locator('[data-testid="client-widget-a"]') + const widgetAClass = await widgetA.getAttribute('class') + expect(widgetAClass).toMatch(/(^|\s)(_widget_|widget[-_])[\w-]+/) + + // Widget B classes should be hashed + const widgetB = page.locator('[data-testid="client-widget-b"]') + const widgetBClass = await widgetB.getAttribute('class') + expect(widgetBClass).toMatch(/(^|\s)(_widget_|widget[-_])[\w-]+/) + + // Classes should be different (different modules) + expect(widgetAClass).not.toBe(widgetBClass) + }) + + // ============================================================================ + // Test 6: Server component A wrapper is rendered + // ============================================================================ + test('Server component A wrapper is rendered correctly', async ({ page }) => { + await page.goto('/rsc-css-preload-complex') + + const serverA = page.locator('[data-testid="server-component-a"]') + await expect(serverA).toBeVisible() + + // Check server badge + const badge = serverA + .locator('span') + .filter({ hasText: 'SERVER COMPONENT A' }) + await expect(badge).toBeVisible() + + // Check title + const title = page.locator('[data-testid="server-a-title"]') + await expect(title).toHaveText('Server Component A') + }) + + // ============================================================================ + // Test 7: No hydration errors + // ============================================================================ + test('page hydrates without console errors', async ({ page }) => { + const errors: Array = [] + page.on('console', (msg) => { + if (msg.type() === 'error') { + errors.push(msg.text()) + } + }) + + await page.goto('/rsc-css-preload-complex') + + // Wait for hydration + const incrementBtn = page.locator( + '[data-testid="client-widget-a-increment"]', + ) + await expect(incrementBtn).toBeVisible() + await expect(incrementBtn).toBeEnabled() + + // Click to verify hydration + await incrementBtn.click() + await expect( + page.locator('[data-testid="client-widget-a-count"]'), + ).toHaveText('1') + + // Filter out non-hydration errors + const hydrationErrors = errors.filter( + (e) => + e.includes('hydrat') || + e.includes('Hydrat') || + e.includes('mismatch') || + e.includes('did not match'), + ) + expect(hydrationErrors).toHaveLength(0) + }) + + // ============================================================================ + // Test 8: No flash of unstyled content + // ============================================================================ + test('no flash of unstyled content on initial render', async ({ page }) => { + // Slow down network to catch any flash + await page.route('**/*', (route) => route.continue()) + + const flashDetected = { value: false } + + // Check styles immediately when widgets appear + page.on('console', async (msg) => { + if (msg.text().includes('FLASH_DETECTED')) { + flashDetected.value = true + } + }) + + await page.goto('/rsc-css-preload-complex') + + // Check that widgets have correct styles immediately + await page.waitForSelector('[data-testid="client-widget-a"]') + + const widgetABg = await page + .locator('[data-testid="client-widget-a"]') + .evaluate((el) => getComputedStyle(el).backgroundColor) + + const widgetBBg = await page + .locator('[data-testid="client-widget-b"]') + .evaluate((el) => getComputedStyle(el).backgroundColor) + + // Purple theme for A + expect(widgetABg).toBe('rgb(243, 232, 255)') + // Teal theme for B + expect(widgetBBg).toBe('rgb(204, 251, 241)') + + expect(flashDetected.value).toBe(false) + }) + + // ============================================================================ + // Test 9: CSS stylesheets are loaded (verify via computed styles) + // ============================================================================ + test('CSS module styles are correctly applied to all rendered widgets', async ({ + page, + }) => { + await page.goto('/rsc-css-preload-complex') + + // Widget A should have purple theme (from direct RSC render) + const widgetA = page.locator('[data-testid="client-widget-a"]') + await expect(widgetA).toBeVisible() + const widgetABg = await widgetA.evaluate( + (el) => getComputedStyle(el).backgroundColor, + ) + // Purple: #f3e8ff = rgb(243, 232, 255) + expect(widgetABg).toBe('rgb(243, 232, 255)') + + // Widget B should have teal theme (from slot) + const widgetB = page.locator('[data-testid="client-widget-b"]') + await expect(widgetB).toBeVisible() + const widgetBBg = await widgetB.evaluate( + (el) => getComputedStyle(el).backgroundColor, + ) + // Teal: #ccfbf1 = rgb(204, 251, 241) + expect(widgetBBg).toBe('rgb(204, 251, 241)') + + // Widget C should NOT be present + const widgetC = page.locator('[data-testid="client-widget-c"]') + await expect(widgetC).toHaveCount(0) + }) + + // ============================================================================ + // Test 10: Slot contains the slotted content + // ============================================================================ + test('server component slot contains ClientWidgetB', async ({ page }) => { + await page.goto('/rsc-css-preload-complex') + + const slot = page.locator('[data-testid="server-a-slot"]') + await expect(slot).toBeVisible() + + // Widget B should be inside the slot + const widgetBInSlot = slot.locator('[data-testid="client-widget-b"]') + await expect(widgetBInSlot).toBeVisible() + }) + + // ============================================================================ + // Test 11: Client-side navigation works + // ============================================================================ + test('works correctly after client-side navigation', async ({ page }) => { + // Start on home page + await page.goto('/') + + // Navigate to the complex preload page via link (if available) or direct + await page.goto('/rsc-css-preload-complex') + + // Both widgets should be visible and styled + const widgetA = page.locator('[data-testid="client-widget-a"]') + await expect(widgetA).toBeVisible() + + const widgetABg = await widgetA.evaluate( + (el) => getComputedStyle(el).backgroundColor, + ) + expect(widgetABg).toBe('rgb(243, 232, 255)') + + const widgetB = page.locator('[data-testid="client-widget-b"]') + await expect(widgetB).toBeVisible() + + const widgetBBg = await widgetB.evaluate( + (el) => getComputedStyle(el).backgroundColor, + ) + expect(widgetBBg).toBe('rgb(204, 251, 241)') + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-deferred-component-flash.spec.ts b/e2e/react-start/rsc/tests/rsc-deferred-component-flash.spec.ts new file mode 100644 index 0000000000..9fbabac7ff --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-deferred-component-flash.spec.ts @@ -0,0 +1,207 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +/** + * RSC Deferred Component Flash Prevention Tests + * + * These tests verify that RSCs delivered via streaming Promise are decoded + * before the Promise resolves, preventing flash during render. + */ +test.describe('RSC Deferred Component Flash Prevention', () => { + /** + * Helper to monitor for display:none flashes on an element's ancestor chain. + * Returns true if any ancestor had display:none during the monitoring period. + */ + async function monitorForFlash( + page: any, + testId: string, + waitFn: () => Promise, + ): Promise { + // Set up flash monitoring + await page.evaluate((targetTestId: string) => { + ;(window as any).__flashDetected = false + ;(window as any).__monitoringActive = true + + const check = () => { + if (!(window as any).__monitoringActive) return + + const el = document.querySelector( + `[data-testid="${targetTestId}"]`, + ) as HTMLElement | null + if (!el) { + setTimeout(check, 4) + return + } + + // Check if any ancestor has display:none + let current: HTMLElement | null = el + while (current) { + if (getComputedStyle(current).display === 'none') { + ;(window as any).__flashDetected = true + break + } + current = current.parentElement + } + + setTimeout(check, 4) + } + check() + }, testId) + + // Wait for the element to appear + await waitFn() + + // Wait a bit more to catch any late flashes + await page.waitForTimeout(500) + + // Stop monitoring and get result + await page.evaluate(() => { + ;(window as any).__monitoringActive = false + }) + + const flashDetected = await page.evaluate( + () => (window as any).__flashDetected, + ) + return flashDetected + } + + test('no flash when deferred RSC component appears via streaming', async ({ + page, + }) => { + await page.goto('/rsc-basic') + await page.waitForURL('/rsc-basic') + await expect(page.getByTestId('rsc-basic-content')).toBeVisible({ + timeout: 10000, + }) + await waitForHydration(page) + + // Navigate to deferred component route + await page.getByTestId('nav-deferred-component').click() + await page.waitForURL('/rsc-deferred-component') + + // Immediate RSC should be visible right away + await expect(page.getByTestId('deferred-immediate-rsc')).toBeVisible() + + // Monitor for flash when deferred RSC appears + const flashDetected = await monitorForFlash( + page, + 'deferred-streamed-rsc', + async () => { + await expect(page.getByTestId('deferred-streamed-rsc')).toBeVisible({ + timeout: 3000, + }) + }, + ) + + expect(flashDetected).toBe(false) + }) + + test('immediate RSC renders before deferred RSC', async ({ page }) => { + await page.goto('/rsc-deferred-component') + await page.waitForURL('/rsc-deferred-component') + + // Immediate should be visible quickly + await expect(page.getByTestId('deferred-immediate-rsc')).toBeVisible() + + // At this point, deferred might still be loading or already appeared + // Check if loading state was shown (or has already resolved) + const deferredVisible = await page + .getByTestId('deferred-streamed-rsc') + .isVisible() + + if (!deferredVisible) { + // Loading state should be visible if deferred hasn't loaded yet + await expect(page.getByTestId('deferred-loading')).toBeVisible() + } + + // Eventually deferred should appear + await expect(page.getByTestId('deferred-streamed-rsc')).toBeVisible({ + timeout: 3000, + }) + }) + + test('deferred RSC has correct ID', async ({ page }) => { + await page.goto('/rsc-deferred-component') + await page.waitForURL('/rsc-deferred-component') + + // Wait for deferred RSC + await expect(page.getByTestId('deferred-streamed-rsc')).toBeVisible({ + timeout: 3000, + }) + + // Verify deferred RSC has correct ID prefix + const deferredId = await page + .getByTestId('deferred-streamed-id') + .textContent() + expect(deferredId).toMatch(/^def-/) + + // Verify immediate RSC has correct ID prefix + const immediateId = await page + .getByTestId('deferred-immediate-id') + .textContent() + expect(immediateId).toMatch(/^imm-/) + }) + + test('no flash on client-side navigation to deferred route', async ({ + page, + }) => { + // Start at home + await page.goto('/') + await page.waitForURL('/') + await waitForHydration(page) + + await page.evaluate(() => { + ;(window as any).__navigation_marker__ = 'client-side-navigation' + }) + + // Navigate via client-side navigation + await page.getByTestId('nav-deferred-component').click() + await page.waitForURL('/rsc-deferred-component') + + expect( + await page.evaluate(() => (window as any).__navigation_marker__), + ).toBe('client-side-navigation') + + // Monitor for flash on the deferred RSC + const flashDetected = await monitorForFlash( + page, + 'deferred-streamed-rsc', + async () => { + await expect(page.getByTestId('deferred-streamed-rsc')).toBeVisible({ + timeout: 3000, + }) + }, + ) + + expect(flashDetected).toBe(false) + }) + + test('timestamps are different between immediate and deferred RSCs', async ({ + page, + }) => { + await page.goto('/rsc-deferred-component') + await page.waitForURL('/rsc-deferred-component') + + // Wait for both RSCs + await expect(page.getByTestId('deferred-immediate-rsc')).toBeVisible() + await expect(page.getByTestId('deferred-streamed-rsc')).toBeVisible({ + timeout: 3000, + }) + + // Get timestamps + const immediateTimestamp = await page + .getByTestId('deferred-immediate-timestamp') + .textContent() + const deferredTimestamp = await page + .getByTestId('deferred-streamed-timestamp') + .textContent() + + // Both should be valid timestamps + expect(immediateTimestamp).toBeTruthy() + expect(deferredTimestamp).toBeTruthy() + + // They might be different due to the 500ms delay, but this is timing dependent + // Just verify both exist and are non-empty + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-deferred.spec.ts b/e2e/react-start/rsc/tests/rsc-deferred.spec.ts new file mode 100644 index 0000000000..b6a52d7879 --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-deferred.spec.ts @@ -0,0 +1,208 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' +const DEFERRED_DATA_TIMEOUT = 5000 // Deferred data takes ~2 seconds + +test.describe('RSC Deferred Tests - RSC with streamed Promise data', () => { + test('RSC header renders immediately, loading state shows for deferred data', async ({ + page, + }) => { + await page.goto('/rsc-deferred') + await page.waitForURL('/rsc-deferred') + + // Verify page title + await expect(page.getByTestId('rsc-deferred-page-title')).toHaveText( + 'Deferred Data - RSC with Streamed Promise', + ) + + // RSC header should render immediately + await expect(page.getByTestId('rsc-deferred-header')).toBeVisible() + await expect(page.getByTestId('rsc-deferred-title')).toContainText( + 'Analytics Report: Weekly Analytics', + ) + const timestamp = await page + .getByTestId('rsc-deferred-timestamp') + .textContent() + expect(timestamp).toBeTruthy() + + // Instance ID should be visible + const instanceId = await page + .getByTestId('rsc-deferred-instance') + .textContent() + expect(instanceId).toContain('Instance:') + }) + + test('Deferred data loads and renders client-side with Suspense', async ({ + page, + }) => { + await page.goto('/rsc-deferred') + await page.waitForURL('/rsc-deferred') + + // Initially, loading state should be visible (or data if already loaded) + // Wait for the analytics display to appear (deferred data loaded) + await expect(page.getByTestId('analytics-display')).toBeVisible({ + timeout: DEFERRED_DATA_TIMEOUT, + }) + + // Verify analytics data is rendered + await expect(page.getByTestId('metric-visitors')).toBeVisible() + await expect(page.getByTestId('metric-pageviews')).toBeVisible() + await expect(page.getByTestId('metric-bouncerate')).toBeVisible() + await expect(page.getByTestId('metric-duration')).toBeVisible() + + // Verify top pages are rendered + await expect(page.getByTestId('top-page-0')).toBeVisible() + await expect(page.getByTestId('top-page-1')).toBeVisible() + }) + + test('Client interactivity works on deferred data display', async ({ + page, + }) => { + await page.goto('/rsc-deferred') + await page.waitForURL('/rsc-deferred') + + // Wait for analytics display to load + await expect(page.getByTestId('analytics-display')).toBeVisible({ + timeout: DEFERRED_DATA_TIMEOUT, + }) + await waitForHydration(page) + + // Initially no metric selected + await expect(page.getByTestId('selected-metric')).not.toBeVisible() + + // Click on visitors metric + await page.getByTestId('metric-visitors').click() + await expect(page.getByTestId('selected-metric')).toBeVisible() + await expect(page.getByTestId('selected-metric')).toContainText('visitors') + + // Click on pageviews metric + await page.getByTestId('metric-pageviews').click() + await expect(page.getByTestId('selected-metric')).toContainText('pageviews') + + // Click on bounce rate metric + await page.getByTestId('metric-bouncerate').click() + await expect(page.getByTestId('selected-metric')).toContainText( + 'bouncerate', + ) + }) + + test('RSC timestamp remains stable while deferred data loads', async ({ + page, + }) => { + await page.goto('/rsc-deferred') + await page.waitForURL('/rsc-deferred') + + // Get initial RSC timestamp + const initialTimestamp = await page + .getByTestId('rsc-deferred-timestamp') + .textContent() + const initialInstance = await page + .getByTestId('rsc-deferred-instance') + .textContent() + + // Wait for deferred data to load + await expect(page.getByTestId('analytics-display')).toBeVisible({ + timeout: DEFERRED_DATA_TIMEOUT, + }) + + // RSC timestamp should still be the same + const newTimestamp = await page + .getByTestId('rsc-deferred-timestamp') + .textContent() + const newInstance = await page + .getByTestId('rsc-deferred-instance') + .textContent() + + expect(newTimestamp).toBe(initialTimestamp) + expect(newInstance).toBe(initialInstance) + }) + + test('Client interactions do not reload RSC or re-trigger deferred data', async ({ + page, + }) => { + await page.goto('/rsc-deferred') + await page.waitForURL('/rsc-deferred') + + // Wait for everything to load + await expect(page.getByTestId('analytics-display')).toBeVisible({ + timeout: DEFERRED_DATA_TIMEOUT, + }) + await waitForHydration(page) + + // Get initial values + const initialTimestamp = await page + .getByTestId('rsc-deferred-timestamp') + .textContent() + const initialVisitors = await page + .getByTestId('metric-visitors') + .textContent() + + // Perform client interactions + await page.getByTestId('metric-visitors').click() + await page.getByTestId('metric-pageviews').click() + await page.getByTestId('metric-bouncerate').click() + await page.getByTestId('metric-duration').click() + + // Verify nothing reloaded + const newTimestamp = await page + .getByTestId('rsc-deferred-timestamp') + .textContent() + const newVisitors = await page.getByTestId('metric-visitors').textContent() + + expect(newTimestamp).toBe(initialTimestamp) + expect(newVisitors).toBe(initialVisitors) + }) + + test('Deferred data renders correctly after client-side navigation', async ({ + page, + }) => { + // Start at home + await page.goto('/') + await page.waitForURL('/') + await waitForHydration(page) + + // Navigate to deferred page via nav bar + await page.getByTestId('nav-deferred').click() + await page.waitForURL('/rsc-deferred') + + // RSC header should render immediately + await expect(page.getByTestId('rsc-deferred-header')).toBeVisible() + + // Wait for deferred data + await expect(page.getByTestId('analytics-display')).toBeVisible({ + timeout: DEFERRED_DATA_TIMEOUT, + }) + + // Verify analytics data loaded correctly + await expect(page.getByTestId('metric-visitors')).toBeVisible() + await expect(page.getByTestId('top-page-0')).toBeVisible() + }) + + test('Analytics data contains valid numbers', async ({ page }) => { + await page.goto('/rsc-deferred') + await page.waitForURL('/rsc-deferred') + + // Wait for analytics display + await expect(page.getByTestId('analytics-display')).toBeVisible({ + timeout: DEFERRED_DATA_TIMEOUT, + }) + + // Get the visitors text and verify it's a formatted number + const visitorsText = await page.getByTestId('metric-visitors').textContent() + expect(visitorsText).toBeTruthy() + // Should contain "Visitors" label and a number + expect(visitorsText).toContain('Visitors') + + // Get pageviews and verify + const pageViewsText = await page + .getByTestId('metric-pageviews') + .textContent() + expect(pageViewsText).toContain('Page Views') + + // Get bounce rate - should contain a percentage + const bounceRateText = await page + .getByTestId('metric-bouncerate') + .textContent() + expect(bounceRateText).toContain('%') + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-direct-loader.spec.ts b/e2e/react-start/rsc/tests/rsc-direct-loader.spec.ts new file mode 100644 index 0000000000..b987548a6f --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-direct-loader.spec.ts @@ -0,0 +1,21 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' + +test.describe('RSC Direct Loader Tests', () => { + test('direct loader return does not trigger notFound handling', async ({ + page, + }) => { + const response = await page.goto('/rsc-direct-loader') + await page.waitForURL('/rsc-direct-loader') + + expect(response?.status()).toBe(200) + + await expect(page.getByTestId('rsc-direct-loader-title')).toHaveText( + 'Direct Loader Return', + ) + await expect(page.getByTestId('rsc-direct-loader-content')).toBeVisible() + await expect(page.getByTestId('rsc-direct-loader-heading')).toHaveText( + 'Direct loader RSC', + ) + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-error.spec.ts b/e2e/react-start/rsc/tests/rsc-error.spec.ts new file mode 100644 index 0000000000..4ef9f850aa --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-error.spec.ts @@ -0,0 +1,89 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' + +const HYDRATION_WAIT = 1000 + +test.describe('RSC Error Handling Tests - Error boundary behavior', () => { + // Tests that don't trigger errors + test('Page loads successfully without error param', async ({ page }) => { + await page.goto('/rsc-error') + await page.waitForURL(/\/rsc-error/) + + // Verify page title + await expect(page.getByTestId('rsc-error-title')).toHaveText( + 'Error Handling - RSC Error Boundary', + ) + + // Verify error controls are visible + await expect(page.getByTestId('error-controls')).toBeVisible() + await expect(page.getByTestId('trigger-error-btn')).toBeVisible() + + // Verify error status shows OFF + await expect(page.getByTestId('error-status')).toContainText( + 'Error mode: OFF', + ) + + // Verify no error boundary is shown + await expect(page.getByTestId('error-boundary')).not.toBeVisible() + }) + + test('Error controls show trigger button and status', async ({ page }) => { + await page.goto('/rsc-error') + await page.waitForURL(/\/rsc-error/) + + // Verify error controls + await expect(page.getByTestId('error-controls')).toBeVisible() + await expect(page.getByTestId('trigger-error-btn')).toContainText( + 'Trigger Error', + ) + + // Verify error mode is OFF by default + await expect(page.getByTestId('error-status')).toContainText('OFF') + }) + + test('Page loads with shouldError=false shows normal state', async ({ + page, + }) => { + await page.goto('/rsc-error?shouldError=false') + await page.waitForURL(/\/rsc-error/) + + // Should show normal content, not error boundary + await expect(page.getByTestId('error-controls')).toBeVisible() + await expect(page.getByTestId('error-boundary')).not.toBeVisible() + }) + + test('Title is present', async ({ page }) => { + await page.goto('/rsc-error') + await page.waitForURL(/\/rsc-error/) + + await expect(page.getByTestId('rsc-error-title')).toHaveText( + 'Error Handling - RSC Error Boundary', + ) + }) + + test('Loader timestamp is present', async ({ page }) => { + await page.goto('/rsc-error') + await page.waitForURL(/\/rsc-error/) + + const timestamp = await page.getByTestId('loader-timestamp').textContent() + expect(timestamp).toBeTruthy() + const ts = Number(timestamp) + expect(ts).toBeGreaterThan(0) + }) + + test('Full page reload works correctly', async ({ page }) => { + await page.goto('/rsc-error') + await page.waitForURL(/\/rsc-error/) + + // Verify page loaded + await expect(page.getByTestId('rsc-error-title')).toBeVisible() + + // Full page reload + await page.reload() + await page.waitForURL(/\/rsc-error/) + + // Verify page still works after reload + await expect(page.getByTestId('rsc-error-title')).toBeVisible() + await expect(page.getByTestId('error-controls')).toBeVisible() + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-external.spec.ts b/e2e/react-start/rsc/tests/rsc-external.spec.ts new file mode 100644 index 0000000000..7ce4bd3c18 --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-external.spec.ts @@ -0,0 +1,87 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' + +test.describe('RSC External API Tests - External data fetching', () => { + test('Page loads with external data info visible', async ({ page }) => { + await page.goto('/rsc-external') + await page.waitForURL(/\/rsc-external/) + + // Verify page title + await expect(page.getByTestId('rsc-external-title')).toHaveText( + 'Weather Data - RSC with External API', + ) + + // Verify external server URL is displayed + await expect(page.getByTestId('external-server-url')).toBeVisible() + }) + + test('External server URL is displayed correctly', async ({ page }) => { + await page.goto('/rsc-external') + await page.waitForURL(/\/rsc-external/) + + // Verify the external server URL contains expected pattern + const serverUrl = await page + .getByTestId('external-server-url') + .textContent() + expect(serverUrl).toBeTruthy() + // Should be localhost with a port + expect(serverUrl).toMatch(/localhost:\d+/) + }) + + test('Loader timestamp is present', async ({ page }) => { + await page.goto('/rsc-external') + await page.waitForURL(/\/rsc-external/) + + // Verify timestamp is present + const timestamp = await page.getByTestId('loader-timestamp').textContent() + expect(timestamp).toBeTruthy() + + // It should be a valid timestamp + const ts = Number(timestamp) + expect(ts).toBeGreaterThan(0) + }) + + test('RSC external data component is rendered', async ({ page }) => { + await page.goto('/rsc-external') + await page.waitForURL(/\/rsc-external/) + + // Verify RSC external data component is rendered + await expect(page.getByTestId('rsc-external-data')).toBeVisible() + + // Either we have a successful response or an error message + const hasResponse = await page + .getByTestId('rsc-external-response') + .isVisible() + .catch(() => false) + const hasError = await page + .getByTestId('rsc-external-error') + .isVisible() + .catch(() => false) + + expect(hasResponse || hasError).toBe(true) + }) + + test('External timestamp is present in RSC', async ({ page }) => { + await page.goto('/rsc-external') + await page.waitForURL(/\/rsc-external/) + + // Verify RSC timestamp is present + await expect(page.getByTestId('rsc-external-timestamp')).toBeVisible() + }) + + test('Full page reload works correctly', async ({ page }) => { + await page.goto('/rsc-external') + await page.waitForURL(/\/rsc-external/) + + // Verify page loads + await expect(page.getByTestId('rsc-external-title')).toBeVisible() + + // Full page reload + await page.reload() + await page.waitForURL(/\/rsc-external/) + + // Verify page still works after reload + await expect(page.getByTestId('rsc-external-title')).toBeVisible() + await expect(page.getByTestId('rsc-external-data')).toBeVisible() + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-flash.spec.ts b/e2e/react-start/rsc/tests/rsc-flash.spec.ts new file mode 100644 index 0000000000..1fd841c62a --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-flash.spec.ts @@ -0,0 +1,151 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' + +/** + * RSC Flash Regression Tests + * + * These tests verify that RSC content does not flash (pendingComponent) + * during client-side navigation. A flash indicates that lazy client component + * chunks weren't preloaded before the route rendered. + * + * Detection method: Each route's pendingComponent logs a unique message. + * If any "[PENDING] /route-name" message is logged during client-side + * navigation, the test fails. + */ +test.describe('RSC Flash Prevention', () => { + test('no flash when navigating to RSC route with slots', async ({ page }) => { + const pendingLogs: string[] = [] + page.on('console', (msg) => { + if (msg.text().startsWith('[PENDING]')) { + pendingLogs.push(msg.text()) + } + }) + + // Start at /rsc-tree (has slots) + await page.goto('/rsc-tree') + await expect(page.getByTestId('rsc-tree-content')).toBeVisible({ + timeout: 10000, + }) + await page.waitForTimeout(300) + + // Clear logs from initial page load (expected on SSR) + pendingLogs.length = 0 + + // Navigate to /rsc-basic + await page.getByTestId('nav-basic').click() + await expect(page.getByTestId('rsc-basic-content')).toBeVisible({ + timeout: 10000, + }) + + // Check no flash during this navigation + expect(pendingLogs).toEqual([]) + + // Navigate back to /rsc-tree and check for flash + pendingLogs.length = 0 + await page.getByTestId('nav-tree').click() + await expect(page.getByTestId('rsc-tree-content')).toBeVisible({ + timeout: 10000, + }) + + expect(pendingLogs).toEqual([]) + }) + + test('no flash when navigating between RSC routes without slots', async ({ + page, + }) => { + const pendingLogs: string[] = [] + page.on('console', (msg) => { + if (msg.text().startsWith('[PENDING]')) { + pendingLogs.push(msg.text()) + } + }) + + // Start at /rsc-basic + await page.goto('/rsc-basic') + await expect(page.getByTestId('rsc-basic-content')).toBeVisible({ + timeout: 10000, + }) + await page.waitForTimeout(300) + + // Clear logs from initial page load + pendingLogs.length = 0 + + // Navigate to /rsc-slots + await page.getByTestId('nav-slots').click() + await expect(page.getByTestId('rsc-slotted-content')).toBeVisible({ + timeout: 10000, + }) + + // Check no flash + expect(pendingLogs).toEqual([]) + + // Navigate back to /rsc-basic + pendingLogs.length = 0 + await page.getByTestId('nav-basic').click() + await expect(page.getByTestId('rsc-basic-content')).toBeVisible({ + timeout: 10000, + }) + + expect(pendingLogs).toEqual([]) + }) + + test('no flash when navigating TO rsc-slots route', async ({ page }) => { + const pendingLogs: string[] = [] + page.on('console', (msg) => { + if (msg.text().startsWith('[PENDING]')) { + pendingLogs.push(msg.text()) + } + }) + + // Start at /rsc-basic + await page.goto('/rsc-basic') + await expect(page.getByTestId('rsc-basic-content')).toBeVisible({ + timeout: 10000, + }) + await page.waitForTimeout(300) + + // Clear logs from initial page load + pendingLogs.length = 0 + + // Navigate TO /rsc-slots + await page.getByTestId('nav-slots').click() + await expect(page.getByTestId('rsc-slotted-content')).toBeVisible({ + timeout: 10000, + }) + + // Check no flash + expect(pendingLogs).toEqual([]) + }) + + test('no flash when navigating to rsc-stream-loader route', async ({ + page, + }) => { + const pendingLogs: string[] = [] + page.on('console', (msg) => { + if (msg.text().startsWith('[PENDING]')) { + pendingLogs.push(msg.text()) + } + }) + + // Start at /rsc-streaming (index for streaming examples) + await page.goto('/rsc-streaming') + await expect(page.getByTestId('rsc-streaming-title')).toBeVisible({ + timeout: 10000, + }) + await page.waitForTimeout(300) + + // Clear logs from initial page load + pendingLogs.length = 0 + + // Navigate to /rsc-stream-loader via link + await page.getByTestId('link-rsc-stream-loader').click() + await expect(page.getByTestId('rsc-stream-loader-title')).toBeVisible({ + timeout: 10000, + }) + + // Check no flash during navigation + // Note: The route may stream content progressively, but the pendingComponent + // should not show during navigation itself + expect(pendingLogs).toEqual([]) + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-flight-api.spec.ts b/e2e/react-start/rsc/tests/rsc-flight-api.spec.ts new file mode 100644 index 0000000000..3d9ab1fe0f --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-flight-api.spec.ts @@ -0,0 +1,102 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' + +test.describe('RSC Low-Level Flight Stream API', () => { + test.beforeEach(async ({ page }) => { + await page.goto('/rsc-flight-api') + await expect(page.getByTestId('rsc-flight-api-title')).toBeVisible() + }) + + test('Pattern 1: server function returns raw Flight Response', async ({ + page, + }) => { + // Wait for hydration - the button needs to be interactive + const button = page.getByTestId('fetch-response-button') + await expect(button).toBeVisible() + await expect(button).toBeEnabled() + + // Click and verify the result area updates + await button.click() + + // Wait for either content or error to appear + const content = page.getByTestId('flight-response-content') + const error = page.getByTestId('flight-response-error') + const resultArea = page.getByTestId('flight-response-result') + + // First check if result area changed from initial state + await expect( + resultArea + .locator(':scope') + .filter({ hasNotText: 'Click button to fetch' }), + ).toBeVisible({ timeout: 15000 }) + + // Now check for content or error + await expect(content.or(error)).toBeVisible({ timeout: 5000 }) + + // Check if there's an error + if (await error.isVisible()) { + const errorText = await error.textContent() + throw new Error(`Flight fetch failed: ${errorText}`) + } + + // Verify content + await expect(content).toContainText('SERVER FN RESPONSE') + await expect(content).toContainText('server function returning Response') + }) + + test('Pattern 2: API route returns Flight stream decoded with createFromReadableStream', async ({ + page, + }) => { + // Wait for hydration + const button = page.getByTestId('fetch-api-button') + await expect(button).toBeVisible() + await expect(button).toBeEnabled() + + await button.click() + + // Wait for either content or error + const content = page.getByTestId('api-flight-content') + const error = page.getByTestId('api-error') + + await expect(content.or(error)).toBeVisible({ timeout: 10000 }) + + // Check if there's an error + if (await error.isVisible()) { + const errorText = await error.textContent() + throw new Error(`API route flight fetch failed: ${errorText}`) + } + + // Verify content + await expect(content).toContainText('API ROUTE RSC') + await expect(content).toContainText('API route Flight stream') + }) + + test('both patterns work independently', async ({ page }) => { + await expect(page.getByTestId('fetch-response-button')).toBeEnabled() + await expect(page.getByTestId('fetch-api-button')).toBeEnabled() + + // Click Pattern 1 button + await page.getByTestId('fetch-response-button').click() + await expect(page.getByTestId('flight-response-content')).toBeVisible({ + timeout: 10000, + }) + + // Click Pattern 2 button + await page.getByTestId('fetch-api-button').click() + await expect(page.getByTestId('api-flight-content')).toBeVisible({ + timeout: 10000, + }) + + // Both should be visible now + await expect(page.getByTestId('flight-response-content')).toBeVisible() + await expect(page.getByTestId('api-flight-content')).toBeVisible() + + // Verify different content + await expect(page.getByTestId('flight-response-content')).toContainText( + 'SERVER FN RESPONSE', + ) + await expect(page.getByTestId('api-flight-content')).toContainText( + 'API ROUTE RSC', + ) + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-forms.spec.ts b/e2e/react-start/rsc/tests/rsc-forms.spec.ts new file mode 100644 index 0000000000..c6a8a6e4cd --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-forms.spec.ts @@ -0,0 +1,179 @@ +import { expect, type Page } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +async function getTodoCount(page: Page) { + const countText = await page.getByTestId('rsc-todo-count').textContent() + const match = countText?.match(/\d+\/(\d+) completed/) + + if (!match) { + throw new Error(`Unexpected todo count text: ${countText}`) + } + + return Number(match[1]) +} + +test.describe('RSC Forms Tests - Todo list with mutations', () => { + test('Page loads with todo list visible', async ({ page }) => { + await page.goto('/rsc-forms') + await page.waitForURL('/rsc-forms') + + // Verify page title + await expect(page.getByTestId('rsc-forms-title')).toHaveText( + 'Todo List - RSC with Forms', + ) + + // Verify form is visible + await expect(page.getByTestId('todo-form')).toBeVisible() + await expect(page.getByTestId('todo-input')).toBeVisible() + await expect(page.getByTestId('add-todo-btn')).toBeVisible() + }) + + test('Add todo button is disabled when input is empty', async ({ page }) => { + await page.goto('/rsc-forms') + await page.waitForURL('/rsc-forms') + await waitForHydration(page) + + // Verify button is disabled with empty input + await expect(page.getByTestId('add-todo-btn')).toBeDisabled() + + // Type something + await page.getByTestId('todo-input').fill('Test todo') + + // Now button should be enabled + await expect(page.getByTestId('add-todo-btn')).toBeEnabled() + + // Clear input + await page.getByTestId('todo-input').fill('') + + // Button should be disabled again + await expect(page.getByTestId('add-todo-btn')).toBeDisabled() + }) + + test('Adding a todo refreshes the RSC', async ({ page }) => { + await page.goto('/rsc-forms') + await page.waitForURL('/rsc-forms') + await waitForHydration(page) + + const initialCount = await getTodoCount(page) + + // Add a new todo + const todoText = `Test Todo ${Date.now()}` + await page.getByTestId('todo-input').fill(todoText) + await page.getByTestId('add-todo-btn').click() + + // Wait for the mutation and route invalidation to settle. + await expect(page.getByTestId('todo-input')).toHaveValue('') + await expect(page.getByTestId('rsc-todo-list')).toContainText(todoText) + await expect(page.getByTestId('rsc-todo-count')).toContainText( + `/${initialCount + 1} completed`, + ) + + // Verify input is cleared after submission + await expect(page.getByTestId('todo-input')).toHaveValue('') + }) + + test('Todo input clears after successful submission', async ({ page }) => { + await page.goto('/rsc-forms') + await page.waitForURL('/rsc-forms') + await waitForHydration(page) + + // Type and submit + await page.getByTestId('todo-input').fill('Clear test todo') + await expect(page.getByTestId('todo-input')).toHaveValue('Clear test todo') + + await page.getByTestId('add-todo-btn').click() + + // Input should be cleared + await expect(page.getByTestId('todo-input')).toHaveValue('') + }) + + test('Form submission works via Enter key', async ({ page }) => { + await page.goto('/rsc-forms') + await page.waitForURL('/rsc-forms') + await waitForHydration(page) + + const initialCount = await getTodoCount(page) + + // Type and press Enter + const todoText = `Enter key todo ${Date.now()}` + await page.getByTestId('todo-input').fill(todoText) + await page.getByTestId('todo-input').press('Enter') + + await expect(page.getByTestId('todo-input')).toHaveValue('') + await expect(page.getByTestId('rsc-todo-list')).toContainText(todoText) + await expect(page.getByTestId('rsc-todo-count')).toContainText( + `/${initialCount + 1} completed`, + ) + + // Input should be cleared + await expect(page.getByTestId('todo-input')).toHaveValue('') + }) + + test('Multiple todos can be added in sequence', async ({ page }) => { + await page.goto('/rsc-forms') + await page.waitForURL('/rsc-forms') + await waitForHydration(page) + + let expectedCount = await getTodoCount(page) + + // Add first todo + const firstTodo = `First todo ${Date.now()}` + await page.getByTestId('todo-input').fill(firstTodo) + await page.getByTestId('add-todo-btn').click() + await expect(page.getByTestId('todo-input')).toHaveValue('') + expectedCount += 1 + await expect(page.getByTestId('rsc-todo-list')).toContainText(firstTodo) + await expect(page.getByTestId('rsc-todo-count')).toContainText( + `/${expectedCount} completed`, + ) + + // Add second todo + const secondTodo = `Second todo ${Date.now()}` + await page.getByTestId('todo-input').fill(secondTodo) + await page.getByTestId('add-todo-btn').click() + await expect(page.getByTestId('todo-input')).toHaveValue('') + expectedCount += 1 + await expect(page.getByTestId('rsc-todo-list')).toContainText(secondTodo) + await expect(page.getByTestId('rsc-todo-count')).toContainText( + `/${expectedCount} completed`, + ) + + // Add third todo + const thirdTodo = `Third todo ${Date.now()}` + await page.getByTestId('todo-input').fill(thirdTodo) + await page.getByTestId('add-todo-btn').click() + await expect(page.getByTestId('todo-input')).toHaveValue('') + expectedCount += 1 + await expect(page.getByTestId('rsc-todo-list')).toContainText(thirdTodo) + await expect(page.getByTestId('rsc-todo-count')).toContainText( + `/${expectedCount} completed`, + ) + }) + + test('Whitespace-only input does not submit', async ({ page }) => { + await page.goto('/rsc-forms') + await page.waitForURL('/rsc-forms') + await waitForHydration(page) + + // Type whitespace only + await page.getByTestId('todo-input').fill(' ') + + // Button should still be disabled (or at least not submit) + // Note: The implementation trims, so this might not add anything + const initialTimestamp = await page + .getByTestId('loader-timestamp') + .textContent() + + // Try to submit + await page.getByTestId('add-todo-btn').click({ force: true }) + + // Timestamp should not change for whitespace-only input + // (depends on implementation - if trim() is used, it won't submit) + await expect(page.getByTestId('todo-input')).toHaveValue(' ') + const newTimestamp = await page + .getByTestId('loader-timestamp') + .textContent() + expect(newTimestamp).toBe(initialTimestamp) + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-global-css.spec.ts b/e2e/react-start/rsc/tests/rsc-global-css.spec.ts new file mode 100644 index 0000000000..b72b80747b --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-global-css.spec.ts @@ -0,0 +1,156 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC Global CSS Tests', () => { + test('RSC with global CSS hydrates without errors', async ({ page }) => { + // Collect console errors during navigation + const consoleErrors: string[] = [] + page.on('console', (msg) => { + if (msg.type() === 'error') { + consoleErrors.push(msg.text()) + } + }) + + await page.goto('/rsc-global-css') + await page.waitForURL('/rsc-global-css') + await waitForHydration(page) + + // Verify content is visible + await expect(page.getByTestId('rsc-global-css-content')).toBeVisible() + + // Check for hydration errors + const hydrationErrors = consoleErrors.filter( + (msg) => + msg.includes('Hydration') || + msg.includes('hydration') || + msg.includes("didn't match"), + ) + expect(hydrationErrors).toHaveLength(0) + }) + + test('Client-side navigation to RSC with global CSS has no flash', async ({ + page, + }) => { + // Collect console errors during navigation + const consoleErrors: string[] = [] + page.on('console', (msg) => { + if (msg.type() === 'error') { + consoleErrors.push(msg.text()) + } + }) + + // Start from home + await page.goto('/') + await page.waitForURL('/') + await waitForHydration(page) + + // Navigate to RSC global CSS page via nav bar + await page.getByTestId('nav-global-css').click() + await page.waitForURL('/rsc-global-css') + await page.waitForTimeout(500) + + // Verify RSC content is rendered with styles + await expect(page.getByTestId('rsc-global-css-content')).toBeVisible() + + // Verify styles are applied immediately (no flash) + const container = page.getByTestId('rsc-global-css-content') + const backgroundColor = await container.evaluate( + (el) => getComputedStyle(el).backgroundColor, + ) + expect(backgroundColor).toBe('rgb(224, 242, 254)') + + // Check for hydration errors + const hydrationErrors = consoleErrors.filter( + (msg) => + msg.includes('Hydration') || + msg.includes('hydration') || + msg.includes("didn't match"), + ) + expect(hydrationErrors).toHaveLength(0) + }) + + test('RSC renders with global CSS styles applied', async ({ page }) => { + await page.goto('/rsc-global-css') + await page.waitForURL('/rsc-global-css') + + // Verify RSC content is rendered + await expect(page.getByTestId('rsc-global-css-content')).toBeVisible() + await expect(page.getByTestId('rsc-global-css-badge')).toBeVisible() + await expect(page.getByTestId('rsc-global-css-title')).toContainText( + 'Global CSS in Server Components', + ) + + // Verify info grid is rendered + await expect(page.getByTestId('rsc-global-css-info')).toBeVisible() + await expect(page.getByTestId('rsc-global-css-node-version')).toBeVisible() + await expect(page.getByTestId('rsc-global-css-platform')).toBeVisible() + + // Verify timestamp is present + const serverTimestamp = await page + .getByTestId('rsc-global-css-timestamp') + .textContent() + expect(serverTimestamp).toContain('Fetched:') + }) + + test('Global CSS classes are NOT scoped (plain class names)', async ({ + page, + }) => { + await page.goto('/rsc-global-css') + await page.waitForURL('/rsc-global-css') + + // Get the container element and verify it has a plain class name + const container = page.getByTestId('rsc-global-css-content') + await expect(container).toBeVisible() + + // Get the class attribute - it should be the plain class name (not hashed) + const className = await container.getAttribute('class') + expect(className).toBe('rsc-global-container') + }) + + test('Global CSS styles are actually applied', async ({ page }) => { + await page.goto('/rsc-global-css') + await page.waitForURL('/rsc-global-css') + + const container = page.getByTestId('rsc-global-css-content') + await expect(container).toBeVisible() + + // Verify the CSS is applied by checking computed styles + const backgroundColor = await container.evaluate( + (el) => getComputedStyle(el).backgroundColor, + ) + // #e0f2fe in RGB is rgb(224, 242, 254) + expect(backgroundColor).toBe('rgb(224, 242, 254)') + + const borderRadius = await container.evaluate( + (el) => getComputedStyle(el).borderRadius, + ) + expect(borderRadius).toBe('8px') + }) + + test('RSC with global CSS renders correctly after client-side navigation', async ({ + page, + }) => { + // Start from home + await page.goto('/') + await page.waitForURL('/') + await waitForHydration(page) + + // Navigate to RSC global CSS page via nav bar + await page.getByTestId('nav-global-css').click() + await page.waitForURL('/rsc-global-css') + + // Verify RSC content is rendered with styles + await expect(page.getByTestId('rsc-global-css-content')).toBeVisible() + await expect(page.getByTestId('rsc-global-css-title')).toContainText( + 'Global CSS in Server Components', + ) + + // Verify styles are still applied after client navigation + const container = page.getByTestId('rsc-global-css-content') + const backgroundColor = await container.evaluate( + (el) => getComputedStyle(el).backgroundColor, + ) + expect(backgroundColor).toBe('rgb(224, 242, 254)') + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-hydration.spec.ts b/e2e/react-start/rsc/tests/rsc-hydration.spec.ts new file mode 100644 index 0000000000..4bc59e0990 --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-hydration.spec.ts @@ -0,0 +1,140 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC Hydration Tests - Hydration mismatch detection', () => { + test('Page loads with hydration status visible', async ({ page }) => { + await page.goto('/rsc-hydration') + await page.waitForURL('/rsc-hydration') + + // Verify page title + await expect(page.getByTestId('rsc-hydration-title')).toHaveText( + 'User Profile - RSC Hydration Test', + ) + + // Verify hydration status is visible + await expect(page.getByTestId('hydration-status')).toBeVisible() + }) + + test('Hydration succeeds without mismatches', async ({ page }) => { + await page.goto('/rsc-hydration') + await page.waitForURL('/rsc-hydration') + + // Wait for hydration check to complete + await expect(page.getByTestId('hydration-result')).toHaveText( + 'Hydration Successful', + ) + + // Verify hydration succeeded + await expect(page.getByTestId('hydration-result')).toHaveText( + 'Hydration Successful', + ) + + // Verify success message is shown + await expect(page.getByTestId('hydration-success-message')).toBeVisible() + await expect(page.getByTestId('hydration-success-message')).toContainText( + 'RSC content matched between server and client', + ) + }) + + test('Timing info displays correctly', async ({ page }) => { + await page.goto('/rsc-hydration') + await page.waitForURL('/rsc-hydration') + + // Verify timing info section is visible + await expect(page.getByTestId('timing-info')).toBeVisible() + + // Verify server timestamp is present + const serverTime = await page.getByTestId('server-time').textContent() + expect(serverTime).toBeTruthy() + expect(Number(serverTime)).toBeGreaterThan(0) + + // Verify client timestamp is present + const clientTime = await page.getByTestId('client-time').textContent() + expect(clientTime).toBeTruthy() + expect(Number(clientTime)).toBeGreaterThan(0) + + // Verify time difference is calculated + const timeDiff = await page.getByTestId('time-diff').textContent() + expect(timeDiff).toBeTruthy() + expect(timeDiff).toMatch(/\d+ms/) + }) + + test('Server timestamp is earlier than client timestamp', async ({ + page, + }) => { + await page.goto('/rsc-hydration') + await page.waitForURL('/rsc-hydration') + + // Get both timestamps + const serverTime = await page.getByTestId('server-time').textContent() + const clientTime = await page.getByTestId('client-time').textContent() + + // Server time should be less than or equal to client time + // (server renders first, then client hydrates) + expect(Number(serverTime)).toBeLessThanOrEqual(Number(clientTime)) + }) + + test('Loader timestamp is present in hidden span', async ({ page }) => { + await page.goto('/rsc-hydration') + await page.waitForURL('/rsc-hydration') + + // Verify hidden loader timestamp + const loaderTimestamp = await page + .getByTestId('loader-timestamp') + .textContent() + expect(loaderTimestamp).toBeTruthy() + expect(Number(loaderTimestamp)).toBeGreaterThan(0) + }) + + test('Hydration status transitions from checking to success', async ({ + page, + }) => { + await page.goto('/rsc-hydration') + await page.waitForURL('/rsc-hydration') + + // Initially might show "Checking Hydration..." or quickly transition to success + // We just need to verify it eventually shows success + await expect(page.getByTestId('hydration-result')).toHaveText( + 'Hydration Successful', + ) + }) + + test('Page works correctly after client-side navigation', async ({ + page, + }) => { + // Start at home + await page.goto('/') + await page.waitForURL('/') + await waitForHydration(page) + + // Navigate to hydration page via nav + await page.getByTestId('nav-hydration').click() + await page.waitForURL('/rsc-hydration') + + // Wait for hydration check + // Verify hydration succeeded + await expect(page.getByTestId('hydration-result')).toHaveText( + 'Hydration Successful', + ) + }) + + test('Full page reload maintains hydration success', async ({ page }) => { + await page.goto('/rsc-hydration') + await page.waitForURL('/rsc-hydration') + + // Verify initial success + await expect(page.getByTestId('hydration-result')).toHaveText( + 'Hydration Successful', + ) + + // Reload page + await page.reload() + await page.waitForURL('/rsc-hydration') + + // Verify still successful after reload + await expect(page.getByTestId('hydration-result')).toHaveText( + 'Hydration Successful', + ) + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-invalidation.spec.ts b/e2e/react-start/rsc/tests/rsc-invalidation.spec.ts new file mode 100644 index 0000000000..ba1fb31447 --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-invalidation.spec.ts @@ -0,0 +1,105 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' + +test.describe('RSC Invalidation Tests - Search with pagination and refetch', () => { + test('Page loads with default search params and renders UI', async ({ + page, + }) => { + await page.goto('/rsc-invalidation') + await page.waitForURL(/\/rsc-invalidation/) + + // Verify page title + await expect(page.getByTestId('rsc-invalidation-title')).toHaveText( + 'Product Search - RSC Invalidation', + ) + + // Verify search controls are visible + await expect(page.getByTestId('search-controls')).toBeVisible() + await expect(page.getByTestId('search-input')).toBeVisible() + await expect(page.getByTestId('search-btn')).toBeVisible() + + // Verify pagination controls + await expect(page.getByTestId('prev-page')).toBeVisible() + await expect(page.getByTestId('current-page')).toContainText('Page 1') + await expect(page.getByTestId('next-page')).toBeVisible() + + // Verify current params display + await expect(page.getByTestId('current-params')).toContainText('q=""') + + // Verify RSC search results are rendered (use first to handle possible duplicates) + await expect(page.getByTestId('rsc-search-results').first()).toBeVisible() + }) + + test('Page loads with query param in URL', async ({ page }) => { + await page.goto('/rsc-invalidation?q=Electronics&page=1') + await page.waitForURL(/q=Electronics/) + + // Verify params are reflected in UI + await expect(page.getByTestId('current-params')).toContainText( + 'q="Electronics"', + ) + await expect(page.getByTestId('current-page')).toContainText('Page 1') + + // Verify search results show electronics query + await expect(page.getByTestId('rsc-search-results').first()).toBeVisible() + }) + + test('Page loads with page param in URL', async ({ page }) => { + await page.goto('/rsc-invalidation?page=2') + await page.waitForURL(/page=2/) + + // Verify page number is reflected + await expect(page.getByTestId('current-page')).toContainText('Page 2') + + // Verify prev button is now enabled + await expect(page.getByTestId('prev-page')).toBeEnabled() + }) + + test('Previous page button is disabled on page 1', async ({ page }) => { + await page.goto('/rsc-invalidation?page=1') + await page.waitForURL(/\/rsc-invalidation/) + + // Verify previous button is disabled + await expect(page.getByTestId('prev-page')).toBeDisabled() + }) + + test('Search input is editable', async ({ page }) => { + await page.goto('/rsc-invalidation') + await page.waitForURL(/\/rsc-invalidation/) + + // Type in search input + await page.getByTestId('search-input').fill('Test Query') + + // Verify the input value changed + await expect(page.getByTestId('search-input')).toHaveValue('Test Query') + }) + + test('Combined search and page params work correctly', async ({ page }) => { + await page.goto('/rsc-invalidation?q=Accessories&page=2') + await page.waitForURL(/q=Accessories.*page=2/) + + // Verify both params are reflected + await expect(page.getByTestId('current-params')).toContainText( + 'q="Accessories"', + ) + await expect(page.getByTestId('current-page')).toContainText('Page 2') + + // Verify RSC content is rendered + await expect(page.getByTestId('rsc-search-results').first()).toBeVisible() + }) + + test('RSC search results show instance ID', async ({ page }) => { + await page.goto('/rsc-invalidation') + await page.waitForURL(/\/rsc-invalidation/) + + // Verify RSC instance is visible + await expect(page.getByTestId('rsc-search-instance').first()).toBeVisible() + + // Instance ID should be a 6 character string + const instanceId = await page + .getByTestId('rsc-search-instance') + .first() + .textContent() + expect(instanceId).toMatch(/Instance: [a-z0-9]+/) + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-large.spec.ts b/e2e/react-start/rsc/tests/rsc-large.spec.ts new file mode 100644 index 0000000000..e0427518d9 --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-large.spec.ts @@ -0,0 +1,96 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' + +test.describe('RSC Large Payload Tests - Performance with large payloads', () => { + test('Page loads with default items count', async ({ page }) => { + await page.goto('/rsc-large') + await page.waitForURL(/\/rsc-large/) + + // Verify page title + await expect(page.getByTestId('rsc-large-title')).toHaveText( + 'Product Catalog - Large RSC Payload', + ) + + // Verify size controls are visible + await expect(page.getByTestId('size-controls')).toBeVisible() + + // Verify metrics are displayed + await expect(page.getByTestId('metric-count')).toBeVisible() + await expect(page.getByTestId('metric-load-time')).toBeVisible() + await expect(page.getByTestId('metric-render-time')).toBeVisible() + }) + + test('Size selector buttons are visible', async ({ page }) => { + await page.goto('/rsc-large') + await page.waitForURL(/\/rsc-large/) + + // Verify size selector buttons are visible + await expect(page.getByTestId('size-10')).toBeVisible() + await expect(page.getByTestId('size-50')).toBeVisible() + await expect(page.getByTestId('size-100')).toBeVisible() + }) + + test('Load time metric is displayed', async ({ page }) => { + await page.goto('/rsc-large') + await page.waitForURL(/\/rsc-large/) + + // Verify load time is displayed + const loadTime = await page.getByTestId('metric-load-time').textContent() + expect(loadTime).toBeTruthy() + expect(loadTime).toMatch(/\d+ms/) + }) + + test('Page loads with count=10 in URL', async ({ page }) => { + await page.goto('/rsc-large?count=10') + await page.waitForURL(/count=10/) + + // Verify page loaded with 10 items + await expect(page.getByTestId('metric-count')).toContainText('10') + }) + + test('Page loads with count=100 in URL', async ({ page }) => { + await page.goto('/rsc-large?count=100') + await page.waitForURL(/count=100/) + + // Verify page loaded with 100 items + await expect(page.getByTestId('metric-count')).toContainText('100') + }) + + test('Large payload (500 items) loads successfully', async ({ page }) => { + // Increase timeout for large payload + test.setTimeout(60000) + + await page.goto('/rsc-large?count=500') + await page.waitForURL(/count=500/) + + // Verify page loaded successfully + await expect(page.getByTestId('rsc-large-title')).toBeVisible() + await expect(page.getByTestId('metric-count')).toContainText('500') + + // Verify load time is present + const loadTimeText = await page + .getByTestId('metric-load-time') + .textContent() + const loadTimeMs = parseInt(loadTimeText?.replace('ms', '') || '0', 10) + expect(loadTimeMs).toBeGreaterThan(0) + }) + + test('Loader timestamp is present', async ({ page }) => { + await page.goto('/rsc-large') + await page.waitForURL(/\/rsc-large/) + + // Verify loader timestamp is present + const timestamp = await page.getByTestId('loader-timestamp').textContent() + expect(timestamp).toBeTruthy() + const ts = Number(timestamp) + expect(ts).toBeGreaterThan(0) + }) + + test('Size controls are visible with count in URL', async ({ page }) => { + await page.goto('/rsc-large?count=10') + await page.waitForURL(/count=10/) + + // Verify the size controls are rendered + await expect(page.getByTestId('size-controls')).toBeVisible() + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-link.spec.ts b/e2e/react-start/rsc/tests/rsc-link.spec.ts new file mode 100644 index 0000000000..bd4264210c --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-link.spec.ts @@ -0,0 +1,96 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC Link Tests', () => { + test('RSC renders with Link component', async ({ page }) => { + await page.goto('/rsc-link') + await page.waitForURL('/rsc-link') + + // Verify RSC content is rendered + await expect(page.getByTestId('rsc-link-content')).toBeVisible() + await expect(page.getByTestId('rsc-link-timestamp')).toBeVisible() + // Message now contains email body text + await expect(page.getByTestId('rsc-link-message')).toContainText( + 'Your weekly activity report is ready', + ) + + // Verify the Link is rendered correctly (now "View Full Report") + const link = page.getByTestId('rsc-link') + await expect(link).toBeVisible() + await expect(link).toHaveText('View Full Report') + await expect(link).toHaveAttribute('href', '/') + }) + + test('Link inside RSC navigates correctly on click', async ({ page }) => { + await page.goto('/rsc-link') + await page.waitForURL('/rsc-link') + await waitForHydration(page) + + // Verify we're on the RSC link page + await expect(page.getByTestId('rsc-link-title')).toBeVisible() + await expect(page.getByTestId('rsc-link')).toBeVisible() + + // Click the link inside the RSC + await page.getByTestId('rsc-link').click() + + // Wait for navigation to complete + await page.waitForURL('/') + + // Verify we navigated to the home page + await expect(page.getByTestId('home-title')).toBeVisible() + await expect(page.getByTestId('home-title')).toHaveText( + 'React Server Components E2E Tests', + ) + }) + + test('Link inside RSC works after client-side navigation to RSC page', async ({ + page, + }) => { + // Start from home page + await page.goto('/') + await page.waitForURL('/') + await waitForHydration(page) + + // Navigate to RSC link page via nav bar (need to be specific to avoid matching example cards) + await page.getByTestId('nav-link').click() + await page.waitForURL('/rsc-link') + + // Verify RSC content is rendered + await expect(page.getByTestId('rsc-link-content')).toBeVisible() + await expect(page.getByTestId('rsc-link')).toBeVisible() + + // Click the link inside the RSC to navigate back home + await page.getByTestId('rsc-link').click() + await page.waitForURL('/') + + // Verify we're back on home page + await expect(page.getByTestId('home-title')).toBeVisible() + }) + + test('Link inside RSC performs client-side navigation (no full page reload)', async ({ + page, + }) => { + await page.goto('/rsc-link') + await page.waitForURL('/rsc-link') + await waitForHydration(page) + + // Set a marker in window to detect full page reload + await page.evaluate(() => { + ;(window as any).__navigation_marker__ = 'no-reload' + }) + + // Click the link inside the RSC + await page.getByTestId('rsc-link').click() + await page.waitForURL('/') + + // Verify the marker still exists (no full page reload occurred) + const marker = await page.evaluate( + () => (window as any).__navigation_marker__, + ) + expect(marker).toBe('no-reload') + + // Verify we're on home page + await expect(page.getByTestId('home-title')).toBeVisible() + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-multi.spec.ts b/e2e/react-start/rsc/tests/rsc-multi.spec.ts new file mode 100644 index 0000000000..9e7aedefd8 --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-multi.spec.ts @@ -0,0 +1,69 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' + +test.describe('RSC Multi Tests - Multiple RSCs with mixed slots', () => { + test('Multiple RSCs render correctly on initial load', async ({ page }) => { + await page.goto('/rsc-multi') + + // Verify page title + await expect(page.getByTestId('rsc-multi-title')).toHaveText( + 'News Feed - Multiple RSCs', + ) + + // Verify Component A (news article about framework) + await expect(page.getByTestId('rsc-multi-a-content')).toContainText( + 'revolutionary new web framework', + ) + const timestampA = await page + .getByTestId('rsc-multi-a-timestamp') + .textContent() + expect(timestampA).toBeTruthy() + + // Verify Component B (news article about cloud spending) + await expect(page.getByTestId('rsc-multi-b-content')).toContainText( + 'Enterprise cloud spending', + ) + const timestampB = await page + .getByTestId('rsc-multi-b-timestamp') + .textContent() + expect(timestampB).toBeTruthy() + + // Verify Component C (tutorial article with slots) and its children + await expect(page.getByTestId('rsc-multi-c-content')).toContainText( + 'React Server Components', + ) + await expect(page.getByTestId('multi-c-child')).toContainText( + 'Interactive content in slot', + ) + const timestampC = await page + .getByTestId('rsc-multi-c-timestamp') + .textContent() + expect(timestampC).toBeTruthy() + }) + + test('Multiple RSCs render correctly after client-side navigation', async ({ + page, + }) => { + // Start at home + await page.goto('/') + await expect(page.getByTestId('main-nav')).toBeVisible() + + // Navigate to multi RSC page + await page.getByTestId('nav-multi').click() + await page.waitForURL('/rsc-multi') + + // Verify all components render with realistic content + await expect(page.getByTestId('rsc-multi-a-content')).toContainText( + 'revolutionary new web framework', + ) + await expect(page.getByTestId('rsc-multi-b-content')).toContainText( + 'Enterprise cloud spending', + ) + await expect(page.getByTestId('rsc-multi-c-content')).toContainText( + 'React Server Components', + ) + await expect(page.getByTestId('multi-c-child')).toContainText( + 'Interactive content in slot', + ) + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-nested-structure.spec.ts b/e2e/react-start/rsc/tests/rsc-nested-structure.spec.ts new file mode 100644 index 0000000000..938d77cd1c --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-nested-structure.spec.ts @@ -0,0 +1,375 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC Nested Structure Tests', () => { + test('Nested renderServerComponent parts render via dot access', async ({ + page, + }) => { + await page.goto('/rsc-nested-structure') + await page.waitForURL('/rsc-nested-structure') + + await expect(page.getByTestId('rsc-nested-renderable-bar')).toBeVisible() + await expect( + page.getByTestId('rsc-nested-renderable-bar-content'), + ).toHaveText('I am foo.bar') + + await expect(page.getByTestId('rsc-nested-renderable-baz')).toBeVisible() + await expect( + page.getByTestId('rsc-nested-renderable-baz-content'), + ).toHaveText('I am baz') + }) + + test('Top-level nested component with children slot renders correctly', async ({ + page, + }) => { + await page.goto('/rsc-nested-structure') + await page.waitForURL('/rsc-nested-structure') + await waitForHydration(page) + + // Verify Header component + await expect(page.getByTestId('rsc-nested-header')).toBeVisible() + await expect(page.getByTestId('rsc-header-title')).toContainText( + 'Dashboard Overview', + ) + await expect(page.getByTestId('rsc-header-timestamp')).toBeVisible() + + // Verify header slot content + await expect(page.getByTestId('header-slot-content')).toBeVisible() + await expect(page.getByTestId('header-slot-content')).toContainText( + 'Initial header slot', + ) + }) + + test('Nested component with render prop slot renders correctly', async ({ + page, + }) => { + await page.goto('/rsc-nested-structure') + await page.waitForURL('/rsc-nested-structure') + await waitForHydration(page) + + // Verify Stats component + await expect(page.getByTestId('rsc-nested-stats')).toBeVisible() + await expect(page.getByTestId('rsc-stat-views')).toContainText('12,543') + await expect(page.getByTestId('rsc-stat-likes')).toContainText('847') + await expect(page.getByTestId('rsc-stat-shares')).toContainText('234') + + // Verify render prop slot with server data + await expect(page.getByTestId('stats-slot-content')).toBeVisible() + await expect(page.getByTestId('stats-slot-content')).toContainText( + 'Server total:', + ) + // Total = 12543 + 847 + 234 = 13624 + await expect(page.getByTestId('stats-computed-value')).toContainText( + '13624', + ) + }) + + test('Deeply nested component with children slot renders correctly', async ({ + page, + }) => { + await page.goto('/rsc-nested-structure') + await page.waitForURL('/rsc-nested-structure') + await waitForHydration(page) + + // Verify Info component + await expect(page.getByTestId('rsc-nested-info')).toBeVisible() + await expect(page.getByTestId('rsc-info-text')).toContainText( + 'content.details.Info', + ) + + // Verify slot content + await expect(page.getByTestId('info-slot-content')).toBeVisible() + await expect(page.getByTestId('info-slot-content')).toContainText( + 'Deeply nested client content', + ) + }) + + test('Footer with children and render prop slots renders correctly', async ({ + page, + }) => { + await page.goto('/rsc-nested-structure') + await page.waitForURL('/rsc-nested-structure') + await waitForHydration(page) + + // Verify Footer component + await expect(page.getByTestId('rsc-nested-footer')).toBeVisible() + await expect(page.getByTestId('rsc-footer-updated')).toBeVisible() + await expect(page.getByTestId('rsc-footer-version')).toContainText('v1.0.0') + + // Verify children slot + await expect(page.getByTestId('footer-slot-content')).toBeVisible() + await expect(page.getByTestId('footer-slot-content')).toContainText( + 'Initial footer slot', + ) + + // Verify render prop slot with server data + await expect(page.getByTestId('footer-actions-content')).toBeVisible() + await expect(page.getByTestId('footer-version-value')).toContainText( + '1.0.0', + ) + await expect(page.getByTestId('footer-action-btn')).toBeVisible() + }) + + test('Slot content updates without refetching server component', async ({ + page, + }) => { + await page.goto('/rsc-nested-structure') + await page.waitForURL('/rsc-nested-structure') + await waitForHydration(page) + + // Get initial server timestamp + const initialTimestamp = await page + .getByTestId('rsc-header-timestamp') + .textContent() + + // Verify initial slot content + await expect(page.getByTestId('header-slot-content')).toContainText( + 'Initial header slot', + ) + + // Update header slot + await page.getByTestId('update-header-slot-btn').click() + await page.waitForTimeout(100) + + // Verify slot content updated + await expect(page.getByTestId('header-slot-content')).toContainText( + 'Header updated at', + ) + + // Verify server timestamp unchanged (no refetch) + const newTimestamp = await page + .getByTestId('rsc-header-timestamp') + .textContent() + expect(newTimestamp).toBe(initialTimestamp) + }) + + test('Render prop receives server data and updates correctly', async ({ + page, + }) => { + await page.goto('/rsc-nested-structure') + await page.waitForURL('/rsc-nested-structure') + await waitForHydration(page) + + // Initial: 13624 * 1 = 13624 + await expect(page.getByTestId('stats-computed-value')).toContainText( + '13624', + ) + + // Increase multiplier + await page.getByTestId('increase-stats-btn').click() + await page.waitForTimeout(100) + + // 13624 * 2 = 27248 + await expect(page.getByTestId('stats-computed-value')).toContainText( + '27248', + ) + + // Increase again + await page.getByTestId('increase-stats-btn').click() + await page.waitForTimeout(100) + + // 13624 * 3 = 40872 + await expect(page.getByTestId('stats-computed-value')).toContainText( + '40872', + ) + }) + + test('Nested slot visibility can be toggled', async ({ page }) => { + await page.goto('/rsc-nested-structure') + await page.waitForURL('/rsc-nested-structure') + await waitForHydration(page) + + // Initially visible + await expect(page.getByTestId('info-slot-content')).toBeVisible() + + // Toggle off + await page.getByTestId('toggle-info-slot-btn').click() + await page.waitForTimeout(100) + await expect(page.getByTestId('info-slot-content')).not.toBeVisible() + + // Toggle on + await page.getByTestId('toggle-info-slot-btn').click() + await page.waitForTimeout(100) + await expect(page.getByTestId('info-slot-content')).toBeVisible() + }) + + test('Footer slot updates without refetching server component', async ({ + page, + }) => { + await page.goto('/rsc-nested-structure') + await page.waitForURL('/rsc-nested-structure') + await waitForHydration(page) + + // Get initial server timestamp from footer + const initialVersion = await page + .getByTestId('rsc-footer-version') + .textContent() + + // Verify initial footer slot + await expect(page.getByTestId('footer-slot-content')).toContainText( + 'Initial footer slot', + ) + + // Update footer slot + await page.getByTestId('update-footer-slot-btn').click() + await page.waitForTimeout(100) + + // Verify slot updated + await expect(page.getByTestId('footer-slot-content')).toContainText( + 'Footer updated at', + ) + + // Verify server content unchanged + const newVersion = await page + .getByTestId('rsc-footer-version') + .textContent() + expect(newVersion).toBe(initialVersion) + }) + + test('Nested structure with slots works after client-side navigation', async ({ + page, + }) => { + // Start from home + await page.goto('/') + await page.waitForURL('/') + await waitForHydration(page) + + // Navigate via nav link + await page.getByTestId('nav-nested-structure').click() + await page.waitForURL('/rsc-nested-structure') + + // Verify all nested components rendered + await expect(page.getByTestId('rsc-nested-header')).toBeVisible() + await expect(page.getByTestId('rsc-nested-stats')).toBeVisible() + await expect(page.getByTestId('rsc-nested-info')).toBeVisible() + await expect(page.getByTestId('rsc-nested-footer')).toBeVisible() + + // Verify slot content rendered + await expect(page.getByTestId('header-slot-content')).toBeVisible() + await expect(page.getByTestId('stats-slot-content')).toBeVisible() + await expect(page.getByTestId('info-slot-content')).toBeVisible() + await expect(page.getByTestId('footer-slot-content')).toBeVisible() + await expect(page.getByTestId('footer-actions-content')).toBeVisible() + }) +}) + +test.describe('RSC Destructured Access Tests', () => { + test('Destructured components render correctly', async ({ page }) => { + await page.goto('/rsc-nested-structure') + await page.waitForURL('/rsc-nested-structure') + await waitForHydration(page) + + // Verify destructured Header + await expect(page.getByTestId('rsc-destructured-header')).toBeVisible() + await expect(page.getByTestId('rsc-destructured-timestamp')).toBeVisible() + + // Verify destructured Content + await expect(page.getByTestId('rsc-destructured-content')).toBeVisible() + + // Verify destructured Footer + await expect(page.getByTestId('rsc-destructured-footer')).toBeVisible() + }) + + test('Destructured component children slot renders correctly', async ({ + page, + }) => { + await page.goto('/rsc-nested-structure') + await page.waitForURL('/rsc-nested-structure') + await waitForHydration(page) + + // Verify header slot + await expect(page.getByTestId('destructured-header-slot')).toBeVisible() + await expect(page.getByTestId('destructured-header-slot')).toContainText( + 'Initial destructured slot', + ) + + // Verify footer slot + await expect(page.getByTestId('destructured-footer-slot')).toBeVisible() + await expect(page.getByTestId('destructured-footer-slot')).toContainText( + 'Footer via destructuring', + ) + }) + + test('Destructured component render prop receives server data', async ({ + page, + }) => { + await page.goto('/rsc-nested-structure') + await page.waitForURL('/rsc-nested-structure') + await waitForHydration(page) + + // Verify render prop slot with server data (count = 42) + await expect(page.getByTestId('destructured-content-slot')).toBeVisible() + await expect(page.getByTestId('destructured-content-slot')).toContainText( + 'Server count: 42', + ) + // Initial: 42 * 1 = 42 + await expect(page.getByTestId('destructured-computed-value')).toContainText( + '42', + ) + }) + + test('Destructured component slot updates without refetching', async ({ + page, + }) => { + await page.goto('/rsc-nested-structure') + await page.waitForURL('/rsc-nested-structure') + await waitForHydration(page) + + // Get initial timestamp + const initialTimestamp = await page + .getByTestId('rsc-destructured-timestamp') + .textContent() + + // Verify initial slot content + await expect(page.getByTestId('destructured-header-slot')).toContainText( + 'Initial destructured slot', + ) + + // Update slot + await page.getByTestId('update-destructured-slot-btn').click() + await page.waitForTimeout(100) + + // Verify slot updated + await expect(page.getByTestId('destructured-header-slot')).toContainText( + 'Destructured updated at', + ) + + // Verify server timestamp unchanged (no refetch) + const newTimestamp = await page + .getByTestId('rsc-destructured-timestamp') + .textContent() + expect(newTimestamp).toBe(initialTimestamp) + }) + + test('Destructured component render prop updates correctly', async ({ + page, + }) => { + await page.goto('/rsc-nested-structure') + await page.waitForURL('/rsc-nested-structure') + await waitForHydration(page) + + // Initial: 42 * 1 = 42 + await expect(page.getByTestId('destructured-computed-value')).toContainText( + '42', + ) + + // Increase multiplier + await page.getByTestId('increase-badge-btn').click() + await page.waitForTimeout(100) + + // 42 * 2 = 84 + await expect(page.getByTestId('destructured-computed-value')).toContainText( + '84', + ) + + // Increase again + await page.getByTestId('increase-badge-btn').click() + await page.waitForTimeout(100) + + // 42 * 3 = 126 + await expect(page.getByTestId('destructured-computed-value')).toContainText( + '126', + ) + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-nested.spec.ts b/e2e/react-start/rsc/tests/rsc-nested.spec.ts new file mode 100644 index 0000000000..1baca3228c --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-nested.spec.ts @@ -0,0 +1,233 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC Nested Tests - RSCs composed inside each other via client', () => { + test('Nested RSCs render correctly on initial load', async ({ page }) => { + await page.goto('/rsc-nested') + await page.waitForURL('/rsc-nested') + + // Verify page title + await expect(page.getByTestId('rsc-nested-title')).toHaveText( + 'E-commerce Product Page - Nested RSCs', + ) + + // Verify outer RSC (Product Card) is rendered + await expect(page.getByTestId('rsc-product-card')).toBeVisible() + await expect(page.getByTestId('rsc-product-name')).toContainText( + 'Wireless Noise-Canceling Headphones', + ) + await expect(page.getByTestId('rsc-product-price')).toContainText('$299.99') + const productTimestamp = await page + .getByTestId('rsc-product-timestamp') + .textContent() + expect(productTimestamp).toBeTruthy() + + // Verify client wrapper (Reviews Section) is rendered + await expect(page.getByTestId('reviews-section')).toBeVisible() + + // Verify inner RSC (Reviews) is rendered inside + await expect(page.getByTestId('rsc-product-reviews')).toBeVisible() + await expect(page.getByTestId('rsc-reviews-title')).toContainText( + 'Customer Reviews', + ) + const reviewsTimestamp = await page + .getByTestId('rsc-reviews-timestamp') + .textContent() + expect(reviewsTimestamp).toBeTruthy() + + // Verify individual reviews are rendered + await expect(page.getByTestId('review-rev_1')).toBeVisible() + await expect(page.getByTestId('review-rev_2')).toBeVisible() + await expect(page.getByTestId('review-rev_3')).toBeVisible() + }) + + test('Toggling reviews section does not reload either RSC', async ({ + page, + }) => { + await page.goto('/rsc-nested') + await page.waitForURL('/rsc-nested') + await waitForHydration(page) + + // Get initial timestamps for both RSCs + const initialProductTimestamp = await page + .getByTestId('rsc-product-timestamp') + .textContent() + const initialReviewsTimestamp = await page + .getByTestId('rsc-reviews-timestamp') + .textContent() + + // Verify reviews are initially visible + await expect(page.getByTestId('reviews-content')).toBeVisible() + + // Collapse reviews + await page.getByTestId('toggle-reviews-btn').click() + await expect(page.getByTestId('reviews-content')).not.toBeVisible() + + // Expand reviews again + await page.getByTestId('toggle-reviews-btn').click() + await expect(page.getByTestId('reviews-content')).toBeVisible() + + // Verify both RSC timestamps are unchanged (neither was reloaded) + const newProductTimestamp = await page + .getByTestId('rsc-product-timestamp') + .textContent() + const newReviewsTimestamp = await page + .getByTestId('rsc-reviews-timestamp') + .textContent() + + expect(newProductTimestamp).toBe(initialProductTimestamp) + expect(newReviewsTimestamp).toBe(initialReviewsTimestamp) + }) + + test('Client actions in inner RSC render prop work correctly', async ({ + page, + }) => { + await page.goto('/rsc-nested') + await page.waitForURL('/rsc-nested') + await waitForHydration(page) + + // Get initial timestamps + const initialProductTimestamp = await page + .getByTestId('rsc-product-timestamp') + .textContent() + const initialReviewsTimestamp = await page + .getByTestId('rsc-reviews-timestamp') + .textContent() + + // Initially no reviews marked helpful + await expect(page.getByTestId('reviews-section')).toContainText( + 'Marked 0 as helpful', + ) + + // Click helpful on first review + await page.getByTestId('helpful-btn-rev_1').click() + await expect(page.getByTestId('helpful-btn-rev_1')).toContainText( + 'Marked Helpful', + ) + await expect(page.getByTestId('reviews-section')).toContainText( + 'Marked 1 as helpful', + ) + + // Click helpful on second review + await page.getByTestId('helpful-btn-rev_2').click() + await expect(page.getByTestId('helpful-btn-rev_2')).toContainText( + 'Marked Helpful', + ) + await expect(page.getByTestId('reviews-section')).toContainText( + 'Marked 2 as helpful', + ) + + // Toggle first review off + await page.getByTestId('helpful-btn-rev_1').click() + await expect(page.getByTestId('helpful-btn-rev_1')).toContainText( + 'Helpful?', + ) + await expect(page.getByTestId('reviews-section')).toContainText( + 'Marked 1 as helpful', + ) + + // Verify RSC timestamps are still unchanged (client actions don't reload RSCs) + const newProductTimestamp = await page + .getByTestId('rsc-product-timestamp') + .textContent() + const newReviewsTimestamp = await page + .getByTestId('rsc-reviews-timestamp') + .textContent() + + expect(newProductTimestamp).toBe(initialProductTimestamp) + expect(newReviewsTimestamp).toBe(initialReviewsTimestamp) + }) + + test('Nested RSCs render correctly after client-side navigation', async ({ + page, + }) => { + // Start at home + await page.goto('/') + await page.waitForURL('/') + await waitForHydration(page) + + // Navigate to nested RSC page via nav bar + await page.getByTestId('nav-nested').click() + await page.waitForURL('/rsc-nested') + + // Verify both RSCs are rendered + await expect(page.getByTestId('rsc-product-card')).toBeVisible() + await expect(page.getByTestId('rsc-product-reviews')).toBeVisible() + + // Verify the nesting structure: Product Card contains Reviews Section contains Reviews + const productCard = page.getByTestId('rsc-product-card') + await expect(productCard.getByTestId('reviews-section')).toBeVisible() + await expect(productCard.getByTestId('rsc-product-reviews')).toBeVisible() + }) + + test('Both RSCs have independent timestamps from parallel loading', async ({ + page, + }) => { + await page.goto('/rsc-nested') + await page.waitForURL('/rsc-nested') + + // Get both timestamps + const productTimestamp = await page + .getByTestId('rsc-product-timestamp') + .textContent() + const reviewsTimestamp = await page + .getByTestId('rsc-reviews-timestamp') + .textContent() + + // Both should be valid timestamps (truthy strings) + expect(productTimestamp).toBeTruthy() + expect(reviewsTimestamp).toBeTruthy() + + // Both timestamps should be present and formatted as time strings + // They might be the same or slightly different depending on parallel load timing + expect(productTimestamp!.length).toBeGreaterThan(0) + expect(reviewsTimestamp!.length).toBeGreaterThan(0) + }) + + test('Combined toggle and client actions preserve RSC state', async ({ + page, + }) => { + await page.goto('/rsc-nested') + await page.waitForURL('/rsc-nested') + await waitForHydration(page) + + // Get initial timestamps + const initialProductTimestamp = await page + .getByTestId('rsc-product-timestamp') + .textContent() + const initialReviewsTimestamp = await page + .getByTestId('rsc-reviews-timestamp') + .textContent() + + // Mark a review as helpful + await page.getByTestId('helpful-btn-rev_3').click() + await expect(page.getByTestId('helpful-btn-rev_3')).toContainText( + 'Marked Helpful', + ) + + // Collapse reviews + await page.getByTestId('toggle-reviews-btn').click() + await expect(page.getByTestId('reviews-content')).not.toBeVisible() + + // Expand reviews + await page.getByTestId('toggle-reviews-btn').click() + await expect(page.getByTestId('reviews-content')).toBeVisible() + + // The helpful state should be preserved + await expect(page.getByTestId('helpful-btn-rev_3')).toContainText( + 'Marked Helpful', + ) + + // And both RSC timestamps should still be unchanged + const newProductTimestamp = await page + .getByTestId('rsc-product-timestamp') + .textContent() + const newReviewsTimestamp = await page + .getByTestId('rsc-reviews-timestamp') + .textContent() + + expect(newProductTimestamp).toBe(initialProductTimestamp) + expect(newReviewsTimestamp).toBe(initialReviewsTimestamp) + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-no-js.spec.ts b/e2e/react-start/rsc/tests/rsc-no-js.spec.ts new file mode 100644 index 0000000000..161b671e51 --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-no-js.spec.ts @@ -0,0 +1,361 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' + +function getStylesheetHrefs(html: string): Array { + return Array.from( + html.matchAll(/]*>/g), + (match) => match[0], + ).flatMap((tag) => { + const rel = tag.match(/\brel="([^"]*)"/)?.[1] + const href = tag.match(/\bhref="([^"]*)"/)?.[1] + return rel?.split(/\s+/).includes('stylesheet') && href ? [href] : [] + }) +} + +/** + * RSC No-JavaScript Tests + * + * These tests verify that RSC content renders correctly in the initial HTML + * without requiring JavaScript. This ensures proper SSR of server components. + * + * Note: Only routes without streaming/suspense boundaries work correctly + * with JS disabled, as streaming requires client-side JS to process chunks. + */ +test.describe('RSC No-JavaScript Rendering', () => { + // Use a fresh context with JS disabled for each test + test.use({ javaScriptEnabled: false }) + + test('/rsc-basic renders server component content without JS', async ({ + page, + }) => { + await page.goto('/rsc-basic') + + // Page title should be visible + await expect(page.getByTestId('rsc-basic-title')).toBeVisible() + await expect(page.getByTestId('rsc-basic-title')).toHaveText( + 'User Profile Card', + ) + + // Server component content should be present in HTML + await expect(page.getByTestId('rsc-basic-content')).toBeVisible() + + // Server-rendered timestamp should be visible + await expect(page.getByTestId('rsc-server-timestamp')).toBeVisible() + + // The server badge should indicate this is server-rendered + await expect(page.getByTestId('rsc-server-badge')).toBeVisible() + + // User data should be visible (server-rendered) + await expect(page.getByTestId('rsc-label')).toBeVisible() + }) + + test('/rsc-multi renders multiple server components without JS', async ({ + page, + }) => { + await page.goto('/rsc-multi') + + // Page title should be visible + await expect(page.getByTestId('rsc-multi-title')).toBeVisible() + await expect(page.getByTestId('rsc-multi-title')).toHaveText( + 'News Feed - Multiple RSCs', + ) + + // All three server components should be rendered + await expect(page.getByTestId('rsc-multi-a-content')).toBeVisible() + await expect(page.getByTestId('rsc-multi-b-content')).toBeVisible() + await expect(page.getByTestId('rsc-multi-c-content')).toBeVisible() + + // Each should have server-rendered timestamps + await expect(page.getByTestId('rsc-multi-a-timestamp')).toBeVisible() + await expect(page.getByTestId('rsc-multi-b-timestamp')).toBeVisible() + await expect(page.getByTestId('rsc-multi-c-timestamp')).toBeVisible() + }) + + test('/rsc-nested renders nested server components without JS', async ({ + page, + }) => { + await page.goto('/rsc-nested') + + // Page title should be visible + await expect(page.getByTestId('rsc-nested-title')).toBeVisible() + + // Product card RSC should be rendered + await expect(page.getByTestId('rsc-product-card')).toBeVisible() + await expect(page.getByTestId('rsc-product-name')).toBeVisible() + + // Product reviews RSC should be rendered (inside client wrapper, but SSR'd) + await expect(page.getByTestId('reviews-section')).toBeVisible() + await expect(page.getByTestId('reviews-content')).toBeVisible() + await expect(page.getByTestId('rsc-product-reviews')).toBeVisible() + }) + + test('/rsc-slots renders slotted server component without JS', async ({ + page, + }) => { + await page.goto('/rsc-slots') + + // Page title should be visible + await expect(page.getByTestId('rsc-slots-title')).toBeVisible() + await expect(page.getByTestId('rsc-slots-title')).toHaveText( + 'Dashboard with Interactive Widgets', + ) + + // Server component content should be present + await expect(page.getByTestId('rsc-slotted-content')).toBeVisible() + + // Server-rendered timestamp should be visible + await expect(page.getByTestId('rsc-slotted-timestamp')).toBeVisible() + + // Server component title should be rendered + await expect(page.getByTestId('rsc-slotted-title')).toBeVisible() + + // Slot content (children) should be SSR'd too + await expect(page.getByTestId('rsc-slotted-children')).toBeVisible() + }) + + test('/rsc-tree renders tree server component with slots without JS', async ({ + page, + }) => { + await page.goto('/rsc-tree') + + // Page title should be visible + await expect(page.getByTestId('rsc-tree-title')).toBeVisible() + + // Server component tree should be rendered + await expect(page.getByTestId('rsc-tree-content')).toBeVisible() + + // Server-rendered timestamp should be visible + await expect(page.getByTestId('rsc-tree-timestamp')).toBeVisible() + + // Parent element should be rendered + await expect(page.getByTestId('rsc-parent')).toBeVisible() + }) + + test('index page renders without JS', async ({ page }) => { + await page.goto('/') + + // Index page should render + await expect(page.getByTestId('home-title')).toBeVisible() + + // Navigation links should be present (even if not clickable without JS) + await expect(page.getByTestId('nav-basic')).toBeVisible() + await expect(page.getByTestId('nav-slots')).toBeVisible() + }) + + test('/rsc-css-modules renders server component content without JS', async ({ + page, + }) => { + await page.goto('/rsc-css-modules') + + // Page title should be visible + await expect(page.getByTestId('rsc-css-modules-page-title')).toBeVisible() + await expect(page.getByTestId('rsc-css-modules-page-title')).toHaveText( + 'CSS Modules in RSC', + ) + + // Server component content should be present in HTML (not hidden behind Suspense) + const content = page.getByTestId('rsc-css-modules-content') + await expect(content).toBeVisible() + + // Verify class is scoped (hashed) - CSS modules should produce hashed class names + const className = await content.getAttribute('class') + expect(className).toBeTruthy() + expect(className).not.toBe('container') // Should be hashed, not plain + expect(className!.length).toBeGreaterThan(5) // Hashed names are longer + + // Verify CSS styles are actually applied + // .container has background-color: #e0f2fe which is rgb(224, 242, 254) + const backgroundColor = await content.evaluate( + (el) => getComputedStyle(el).backgroundColor, + ) + expect(backgroundColor).toBe('rgb(224, 242, 254)') + + // .container has border-radius: 8px + const borderRadius = await content.evaluate( + (el) => getComputedStyle(el).borderRadius, + ) + expect(borderRadius).toBe('8px') + + // .container has padding: 16px + const padding = await content.evaluate((el) => getComputedStyle(el).padding) + expect(padding).toBe('16px') + + // Server-rendered badge and timestamp should be visible + await expect(page.getByTestId('rsc-css-modules-badge')).toBeVisible() + await expect(page.getByTestId('rsc-css-modules-badge')).toHaveText( + 'SERVER RENDERED', + ) + await expect(page.getByTestId('rsc-css-modules-timestamp')).toBeVisible() + + // Features list should be rendered + await expect(page.getByTestId('rsc-css-modules-features')).toBeVisible() + await expect(page.getByTestId('rsc-css-modules-feature-1')).toBeVisible() + }) + + test('/rsc-global-css renders server component content without JS', async ({ + page, + }) => { + await page.goto('/rsc-global-css') + + // Page title should be visible + await expect(page.getByTestId('rsc-global-css-page-title')).toBeVisible() + await expect(page.getByTestId('rsc-global-css-page-title')).toHaveText( + 'Global CSS in RSC', + ) + + // Server component content should be present in HTML (not hidden behind Suspense) + const content = page.getByTestId('rsc-global-css-content') + await expect(content).toBeVisible() + + // Verify class is NOT scoped - global CSS should have plain class names + const className = await content.getAttribute('class') + expect(className).toBe('rsc-global-container') + + // Verify CSS styles are actually applied + // .rsc-global-container has background-color: #e0f2fe which is rgb(224, 242, 254) + const backgroundColor = await content.evaluate( + (el) => getComputedStyle(el).backgroundColor, + ) + expect(backgroundColor).toBe('rgb(224, 242, 254)') + + // .rsc-global-container has border-radius: 8px + const borderRadius = await content.evaluate( + (el) => getComputedStyle(el).borderRadius, + ) + expect(borderRadius).toBe('8px') + + // .rsc-global-container has padding: 16px + const padding = await content.evaluate((el) => getComputedStyle(el).padding) + expect(padding).toBe('16px') + + // Server-rendered badge and timestamp should be visible + await expect(page.getByTestId('rsc-global-css-badge')).toBeVisible() + await expect(page.getByTestId('rsc-global-css-badge')).toHaveText( + 'SERVER RENDERED', + ) + await expect(page.getByTestId('rsc-global-css-timestamp')).toBeVisible() + + // Info grid should be rendered with server data + await expect(page.getByTestId('rsc-global-css-info')).toBeVisible() + await expect(page.getByTestId('rsc-global-css-node-version')).toBeVisible() + await expect(page.getByTestId('rsc-global-css-platform')).toBeVisible() + }) + + test('HTML contains RSC content without needing hydration', async ({ + page, + }) => { + // Get the raw HTML response + const response = await page.goto('/rsc-basic') + const html = await response?.text() + + // The HTML should contain the server component content directly + expect(html).toContain('data-testid="rsc-basic-content"') + expect(html).toContain('SERVER RENDERED') + + // Should NOT contain loading/fallback states in the main content area + // Note: We check the HTML doesn't have obvious loading indicators + expect(html).toContain('Sarah Chen') // User name from server component + }) + + test('/rsc-client-preload renders client component with CSS applied without JS', async ({ + page, + }) => { + const response = await page.goto('/rsc-client-preload') + const html = await response?.text() + + expect(html).toContain('rel="stylesheet"') + + // Server component wrapper should be visible + await expect(page.getByTestId('rsc-client-preload-server')).toBeVisible() + await expect(page.getByTestId('rsc-client-preload-title')).toHaveText( + 'Client Component Preload Test', + ) + + // Client component should be rendered in HTML (SSR) + const widget = page.getByTestId('client-widget') + await expect(widget).toBeVisible() + + // Verify class is scoped (hashed) - CSS modules should produce hashed class names + const className = await widget.getAttribute('class') + expect(className).toBeTruthy() + expect(className).not.toBe('widget') // Should be hashed, not plain + expect(className!.length).toBeGreaterThan(5) // Hashed names are longer + + // CRITICAL: Verify CSS styles are actually applied without JavaScript + // This is the main test - CSS for client components inside RSC must work without JS + // .widget has background-color: #dcfce7 which is rgb(220, 252, 231) + const backgroundColor = await widget.evaluate( + (el) => getComputedStyle(el).backgroundColor, + ) + expect(backgroundColor).toBe('rgb(220, 252, 231)') + + // .widget has border: 2px solid #16a34a which is rgb(22, 163, 74) + const borderColor = await widget.evaluate( + (el) => getComputedStyle(el).borderColor, + ) + expect(borderColor).toBe('rgb(22, 163, 74)') + + // .widget has border-radius: 8px + const borderRadius = await widget.evaluate( + (el) => getComputedStyle(el).borderRadius, + ) + expect(borderRadius).toBe('8px') + + // .widget has padding: 16px + const padding = await widget.evaluate((el) => getComputedStyle(el).padding) + expect(padding).toBe('16px') + + // Client badge should be visible + await expect(page.getByTestId('client-widget-badge')).toBeVisible() + await expect(page.getByTestId('client-widget-badge')).toHaveText( + 'CLIENT COMPONENT', + ) + }) + + test('/rsc-css-preload-complex renders multiple client widgets with CSS without JS', async ({ + page, + }) => { + const response = await page.goto('/rsc-css-preload-complex') + const html = await response?.text() + + expect(html).toContain('rel="stylesheet"') + + // Server component A should be visible with ClientWidgetA + await expect(page.getByTestId('server-component-a')).toBeVisible() + const widgetA = page.getByTestId('client-widget-a') + await expect(widgetA).toBeVisible() + + // Verify ClientWidgetA CSS is applied (purple theme: #f3e8ff background) + const bgColorA = await widgetA.evaluate( + (el) => getComputedStyle(el).backgroundColor, + ) + expect(bgColorA).toBe('rgb(243, 232, 255)') // #f3e8ff + + // ClientWidgetB should be visible (passed via children slot) + const widgetB = page.getByTestId('client-widget-b') + await expect(widgetB).toBeVisible() + + // Verify ClientWidgetB CSS is applied (teal theme: #ccfbf1 background) + const bgColorB = await widgetB.evaluate( + (el) => getComputedStyle(el).backgroundColor, + ) + expect(bgColorB).toBe('rgb(204, 251, 241)') // #ccfbf1 + + const widgetC = page.getByTestId('client-widget-c') + await expect(widgetC).toHaveCount(0) + + const stylesheetHrefs = getStylesheetHrefs(html!) + const linkedCss = await Promise.all( + stylesheetHrefs.map(async (href) => { + const response = await page.request.get(new URL(href, page.url()).href) + return response.text() + }), + ) + expect(linkedCss.join('\n')).not.toContain('serverb-note') + + const note = page.getByTestId('serverb-note') + await expect(note).toBeVisible() + await expect(note).toHaveCSS('background-color', 'rgb(219, 234, 254)') + await expect(note).toHaveCSS('border-color', 'rgb(59, 130, 246)') + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-parallel-flash.spec.ts b/e2e/react-start/rsc/tests/rsc-parallel-flash.spec.ts new file mode 100644 index 0000000000..80c6082b76 --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-parallel-flash.spec.ts @@ -0,0 +1,193 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +/** + * RSC Parallel Flash Prevention Tests + * + * These tests verify that parallel server function calls correctly scope + * their decode promises without cross-contamination, and that RSCs + * render without flash during client-side navigation. + */ +test.describe('RSC Parallel Flash Prevention', () => { + /** + * Helper to monitor for display:none flashes on an element's ancestor chain. + * Returns true if any ancestor had display:none during the monitoring period. + */ + async function monitorForFlash( + page: any, + testId: string, + navigationFn: () => Promise, + ): Promise { + // Set up flash monitoring before navigation + await page.evaluate((targetTestId: string) => { + ;(window as any).__flashDetected = false + ;(window as any).__monitoringActive = true + + const check = () => { + if (!(window as any).__monitoringActive) return + + const el = document.querySelector( + `[data-testid="${targetTestId}"]`, + ) as HTMLElement | null + if (!el) { + setTimeout(check, 4) + return + } + + // Check if any ancestor has display:none + let current: HTMLElement | null = el + while (current) { + if (getComputedStyle(current).display === 'none') { + ;(window as any).__flashDetected = true + break + } + current = current.parentElement + } + + setTimeout(check, 4) + } + check() + }, testId) + + // Perform the navigation + await navigationFn() + + // Wait for content to be visible + await expect(page.getByTestId(testId)).toBeVisible({ timeout: 10000 }) + + // Wait a bit more to catch any late flashes + await page.waitForTimeout(500) + + // Stop monitoring and get result + await page.evaluate(() => { + ;(window as any).__monitoringActive = false + }) + + const flashDetected = await page.evaluate( + () => (window as any).__flashDetected, + ) + return flashDetected + } + + test('no flash when navigating to route with parallel RSC loading', async ({ + page, + }) => { + // Start at another RSC route + await page.goto('/rsc-basic') + await page.waitForURL('/rsc-basic') + await expect(page.getByTestId('rsc-basic-content')).toBeVisible({ + timeout: 10000, + }) + await waitForHydration(page) + + // Navigate to parallel route and monitor for flash + const flashDetected = await monitorForFlash( + page, + 'rsc-parallel-container', + async () => { + await page.getByTestId('nav-parallel').click() + await page.waitForURL('/rsc-parallel') + }, + ) + + expect(flashDetected).toBe(false) + + // Verify all RSCs rendered correctly + await expect(page.getByTestId('parallel-rsc-a')).toBeVisible() + await expect(page.getByTestId('parallel-rsc-b')).toBeVisible() + await expect(page.getByTestId('parallel-rsc-c')).toBeVisible() + }) + + test('parallel RSCs have correct IDs (no cross-contamination)', async ({ + page, + }) => { + await page.goto('/') + await waitForHydration(page) + + await page.getByTestId('nav-parallel').click() + await page.waitForURL('/rsc-parallel') + + // Wait for all RSCs to be visible + await expect(page.getByTestId('parallel-rsc-a')).toBeVisible() + await expect(page.getByTestId('parallel-rsc-b')).toBeVisible() + await expect(page.getByTestId('parallel-rsc-c')).toBeVisible() + + // Each RSC should have its correct prefix + const idA = await page.getByTestId('parallel-rsc-a-id').textContent() + const idB = await page.getByTestId('parallel-rsc-b-id').textContent() + const idC = await page.getByTestId('parallel-rsc-c-id').textContent() + + expect(idA).toMatch(/^A-/) + expect(idB).toMatch(/^B-/) + expect(idC).toMatch(/^C-/) + + // IDs should all be different + expect(idA).not.toBe(idB) + expect(idB).not.toBe(idC) + expect(idA).not.toBe(idC) + }) + + test('no flash on individual parallel RSC elements', async ({ page }) => { + await page.goto('/rsc-basic') + await page.waitForURL('/rsc-basic') + await expect(page.getByTestId('rsc-basic-content')).toBeVisible({ + timeout: 10000, + }) + await waitForHydration(page) + + // Monitor all three RSC elements for flash + const flashADetected = await monitorForFlash( + page, + 'parallel-rsc-a', + async () => { + await page.getByTestId('nav-parallel').click() + await page.waitForURL('/rsc-parallel') + }, + ) + + expect(flashADetected).toBe(false) + + // Navigate away and back, monitoring B + await page.getByTestId('nav-basic').click() + await page.waitForURL('/rsc-basic') + await expect(page.getByTestId('rsc-basic-content')).toBeVisible() + await waitForHydration(page) + + const flashBDetected = await monitorForFlash( + page, + 'parallel-rsc-b', + async () => { + await page.getByTestId('nav-parallel').click() + await page.waitForURL('/rsc-parallel') + }, + ) + + expect(flashBDetected).toBe(false) + }) + + test('parallel RSCs render correctly on direct navigation', async ({ + page, + }) => { + // Direct navigation (SSR) + await page.goto('/rsc-parallel') + await page.waitForURL('/rsc-parallel') + + // Verify all components rendered + await expect(page.getByTestId('rsc-parallel-title')).toHaveText( + 'Parallel RSC Loading', + ) + await expect(page.getByTestId('parallel-rsc-a')).toBeVisible() + await expect(page.getByTestId('parallel-rsc-b')).toBeVisible() + await expect(page.getByTestId('parallel-rsc-c')).toBeVisible() + + // Verify IDs are correct + const idA = await page.getByTestId('parallel-rsc-a-id').textContent() + const idB = await page.getByTestId('parallel-rsc-b-id').textContent() + const idC = await page.getByTestId('parallel-rsc-c-id').textContent() + + expect(idA).toMatch(/^A-/) + expect(idB).toMatch(/^B-/) + expect(idC).toMatch(/^C-/) + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-param-remount.spec.ts b/e2e/react-start/rsc/tests/rsc-param-remount.spec.ts new file mode 100644 index 0000000000..5943e588be --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-param-remount.spec.ts @@ -0,0 +1,113 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC Param - no remount / state preserved', () => { + test('full load hydrates without mismatch', async ({ page }) => { + await page.goto('/rsc-param/bravo') + await page.waitForURL('/rsc-param/bravo') + + await expect(page.getByTestId('rsc-param-page')).toBeVisible() + await expect(page.getByTestId('rsc-param-renderable-id')).toContainText( + 'id: bravo', + ) + await expect(page.getByTestId('rsc-param-composite-id')).toContainText( + 'id: bravo', + ) + + await waitForHydration(page) + await page.getByTestId('rsc-param-direct-inc').click() + await expect(page.getByTestId('rsc-param-direct-count')).toHaveText('1') + }) + + test('navigating between params keeps client instances and state', async ({ + page, + }) => { + const logs: Array = [] + page.on('console', (msg) => logs.push(msg.text())) + + await page.goto('/rsc-param/alpha') + await page.waitForURL('/rsc-param/alpha') + await waitForHydration(page) + + await expect(page.getByTestId('rsc-param-renderable-id')).toContainText( + 'id: alpha', + ) + await expect(page.getByTestId('rsc-param-composite-id')).toContainText( + 'id: alpha', + ) + + // Set local state in all client components + await page.getByTestId('rsc-param-direct-inc').click() + await page.getByTestId('rsc-param-slot-child-input').fill('persisted-text') + await page.getByTestId('rsc-param-slot-render-prop-toggle').check() + + await expect(page.getByTestId('rsc-param-direct-count')).toHaveText('1') + await expect(page.getByTestId('rsc-param-slot-child-value')).toHaveText( + 'persisted-text', + ) + await expect( + page.getByTestId('rsc-param-slot-render-prop-value'), + ).toHaveText('true') + + const directInstanceBefore = await page + .getByTestId('rsc-param-direct-instance') + .textContent() + const slotChildInstanceBefore = await page + .getByTestId('rsc-param-slot-child-instance') + .textContent() + const slotFooterInstanceBefore = await page + .getByTestId('rsc-param-slot-render-prop-instance') + .textContent() + + const logsBefore = logs.length + + await page.getByTestId('rsc-param-next-link').click() + await page.waitForURL('/rsc-param/bravo') + + await expect(page.getByTestId('rsc-param-renderable-id')).toContainText( + 'id: bravo', + ) + await expect(page.getByTestId('rsc-param-composite-id')).toContainText( + 'id: bravo', + ) + + // Assert client state preserved + await expect(page.getByTestId('rsc-param-direct-count')).toHaveText('1') + await expect(page.getByTestId('rsc-param-slot-child-value')).toHaveText( + 'persisted-text', + ) + await expect( + page.getByTestId('rsc-param-slot-render-prop-value'), + ).toHaveText('true') + + // Assert no remount (instance ids stable) + await expect(page.getByTestId('rsc-param-direct-instance')).toHaveText( + directInstanceBefore ?? '', + ) + await expect(page.getByTestId('rsc-param-slot-child-instance')).toHaveText( + slotChildInstanceBefore ?? '', + ) + await expect( + page.getByTestId('rsc-param-slot-render-prop-instance'), + ).toHaveText(slotFooterInstanceBefore ?? '') + + const newLogs = logs.slice(logsBefore) + expect( + newLogs.some((l) => l.includes('[unmount] ClientRenderedDirect')), + ).toBe(false) + expect(newLogs.some((l) => l.includes('[unmount] SlotChild'))).toBe(false) + expect(newLogs.some((l) => l.includes('[unmount] SlotRenderProp'))).toBe( + false, + ) + + // If any mount logs happened after nav, treat as remount + expect( + newLogs.some((l) => l.includes('[mount] ClientRenderedDirect')), + ).toBe(false) + expect(newLogs.some((l) => l.includes('[mount] SlotChild'))).toBe(false) + expect(newLogs.some((l) => l.includes('[mount] SlotRenderProp'))).toBe( + false, + ) + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-react-cache.spec.ts b/e2e/react-start/rsc/tests/rsc-react-cache.spec.ts new file mode 100644 index 0000000000..98281f23dc --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-react-cache.spec.ts @@ -0,0 +1,112 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC React.cache Tests', () => { + test('Page loads with React.cache test button', async ({ page }) => { + await page.goto('/rsc-react-cache') + await page.waitForURL('/rsc-react-cache') + + // Verify page title + await expect(page.getByTestId('rsc-react-cache-title')).toHaveText( + 'React.cache Demo', + ) + + // Verify RSC content is rendered + await expect(page.getByTestId('rsc-react-cache-content')).toBeVisible() + + // Verify test link is present + await expect(page.getByTestId('test-cache-link')).toBeVisible() + }) + + test('React.cache deduplicates function calls by argument', async ({ + page, + }) => { + await page.goto('/rsc-react-cache') + await page.waitForURL('/rsc-react-cache') + + // Click the test link + await page.getByTestId('test-cache-link').click() + await page.waitForURL(/test-cache/) + + // Verify the result matches expected pattern: + // cacheFnCount = 2 (only 2 unique args: 'test1' and 'test2') + // nonCacheFnCount = 3 (all 3 calls run) + await expect(page.getByTestId('test-react-cache-result')).toHaveText( + '(cacheFnCount = 2, nonCacheFnCount = 3)', + ) + }) + + test('Cache status shows success when working', async ({ page }) => { + // First visit base route to reset counters + await page.goto('/rsc-react-cache') + await page.waitForURL('/rsc-react-cache') + + // Then navigate to test-cache + await page.goto('/rsc-react-cache?test-cache') + await page.waitForURL(/test-cache/) + + // Verify cache status shows success + await expect(page.getByTestId('cache-status')).toContainText( + 'React.cache is working!', + ) + + // Verify individual counts + await expect(page.getByTestId('cache-fn-count')).toContainText('2') + await expect(page.getByTestId('non-cache-fn-count')).toContainText('3') + }) + + test('Cached results share the same randomValue for same args', async ({ + page, + }) => { + // First visit base route to reset counters + await page.goto('/rsc-react-cache') + await page.waitForURL('/rsc-react-cache') + + // Then navigate to test-cache + await page.goto('/rsc-react-cache?test-cache') + await page.waitForURL(/test-cache/) + + // Get the random values from cached results + // Call 1 and Call 3 both use 'test1' so should have same randomValue + const randomValue1 = await page.getByTestId('random-value-1').textContent() + const randomValue2 = await page.getByTestId('random-value-2').textContent() + const randomValue3 = await page.getByTestId('random-value-3').textContent() + + // Call 1 ('test1') and Call 3 ('test1') should have same randomValue + expect(randomValue1).toBeTruthy() + expect(randomValue1).toBe(randomValue3) + + // Call 2 ('test2') should have different randomValue + expect(randomValue2).toBeTruthy() + expect(randomValue2).not.toBe(randomValue1) + }) + + test('Server timestamp is present', async ({ page }) => { + await page.goto('/rsc-react-cache') + await page.waitForURL('/rsc-react-cache') + + await expect(page.getByTestId('rsc-server-timestamp')).toBeVisible() + const timestamp = await page + .getByTestId('rsc-server-timestamp') + .textContent() + expect(timestamp).toContain('Rendered:') + }) + + test('Client-side navigation to React.cache page works', async ({ page }) => { + // Start at home + await page.goto('/') + await page.waitForURL('/') + await waitForHydration(page) + + // Navigate to React.cache page via nav bar + await page.getByTestId('nav-react-cache').click() + await page.waitForURL('/rsc-react-cache') + + // Verify page loaded correctly + await expect(page.getByTestId('rsc-react-cache-title')).toHaveText( + 'React.cache Demo', + ) + await expect(page.getByTestId('test-cache-link')).toBeVisible() + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-request-headers.spec.ts b/e2e/react-start/rsc/tests/rsc-request-headers.spec.ts new file mode 100644 index 0000000000..95ee787d3a --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-request-headers.spec.ts @@ -0,0 +1,28 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' + +test.describe('RSC Request Headers Tests', () => { + test('loader server functions can read cookies with vite-rsc enabled', async ({ + page, + context, + }) => { + await context.setExtraHTTPHeaders({ + Cookie: 'session=abc123; theme=dark', + }) + + const response = await page.goto('/rsc-request-headers') + await page.waitForURL('/rsc-request-headers') + + expect(response?.status()).toBe(200) + + await expect(page.getByTestId('rsc-request-headers-title')).toHaveText( + 'RSC Request Headers', + ) + await expect(page.getByTestId('rsc-request-headers-cookies')).toContainText( + 'session=abc123', + ) + await expect(page.getByTestId('rsc-request-headers-cookies')).toContainText( + 'theme=dark', + ) + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-server-not-found.spec.ts b/e2e/react-start/rsc/tests/rsc-server-not-found.spec.ts new file mode 100644 index 0000000000..162c39bf38 --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-server-not-found.spec.ts @@ -0,0 +1,48 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC Server Not Found Tests', () => { + test.use({ + whitelistErrors: [ + 'Failed to load resource: the server responded with a status of 404', + ], + }) + + test('SSR renders the route notFoundComponent when a server function throws notFound', async ({ + page, + }) => { + const response = await page.goto('/rsc-server-not-found') + await page.waitForURL('/rsc-server-not-found') + + expect(response?.status()).toBe(404) + + await expect( + page.getByTestId('rsc-server-not-found-boundary'), + ).toBeVisible() + await expect(page.getByTestId('rsc-server-not-found-heading')).toHaveText( + 'RSC Server Function Not Found', + ) + await expect( + page.getByTestId('rsc-server-not-found-message'), + ).toContainText('server function threw `notFound()`') + }) + + test('client navigation renders the route notFoundComponent when a server function throws notFound', async ({ + page, + }) => { + await page.goto('/') + await page.waitForURL('/') + await waitForHydration(page) + + await page.getByTestId('nav-server-not-found').click() + await page.waitForURL('/rsc-server-not-found') + + await expect( + page.getByTestId('rsc-server-not-found-boundary'), + ).toBeVisible() + await expect(page.getByTestId('rsc-server-not-found-heading')).toHaveText( + 'RSC Server Function Not Found', + ) + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-server-redirect.spec.ts b/e2e/react-start/rsc/tests/rsc-server-redirect.spec.ts new file mode 100644 index 0000000000..8794852219 --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-server-redirect.spec.ts @@ -0,0 +1,28 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC Server Redirect Tests', () => { + test('SSR follows route redirect when a server function throws redirect', async ({ + page, + }) => { + const response = await page.goto('/rsc-server-redirect') + await page.waitForURL('/rsc-basic') + + expect(response?.status()).toBe(200) + await expect(page.getByTestId('rsc-basic-content')).toBeVisible() + }) + + test('client navigation follows route redirect when a server function throws redirect', async ({ + page, + }) => { + await page.goto('/') + await page.waitForURL('/') + await waitForHydration(page) + + await page.getByTestId('nav-server-redirect').click() + await page.waitForURL('/rsc-basic') + + await expect(page.getByTestId('rsc-basic-content')).toBeVisible() + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-slot-jsx-args.spec.ts b/e2e/react-start/rsc/tests/rsc-slot-jsx-args.spec.ts new file mode 100644 index 0000000000..7cadf0f1ba --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-slot-jsx-args.spec.ts @@ -0,0 +1,20 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC Slot Arg Tests - JSX element argument', () => { + test('Client slot receives and renders JSX arg from server', async ({ + page, + }) => { + await page.goto('/rsc-slot-jsx-args') + await page.waitForURL('/rsc-slot-jsx-args') + await waitForHydration(page) + + await expect(page.getByTestId('rsc-jsx-args-server')).toBeVisible() + await expect(page.getByTestId('rsc-jsx-args-client')).toBeVisible() + + await expect(page.getByTestId('promo-cta-jsx')).toBeVisible() + await expect(page.getByTestId('promo-cta-jsx')).toHaveText('Limited offer') + await expect(page.getByTestId('rsc-jsx-args-meta')).toContainText('CMP-123') + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-slots.spec.ts b/e2e/react-start/rsc/tests/rsc-slots.spec.ts new file mode 100644 index 0000000000..1d55174067 --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-slots.spec.ts @@ -0,0 +1,153 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC Slot Tests - Client-side slot changes without RSC reload', () => { + test('SSR HTML includes modulepreload links for composite route client modules', async ({ + page, + }) => { + const response = await page.goto('/rsc-slots') + const html = await response?.text() + expect(html).toBeDefined() + + const modulepreloads = Array.from( + html!.matchAll(/ match[1]!, + ) + + expect(modulepreloads.length).toBeGreaterThan(1) + expect( + modulepreloads.some((href) => href.includes('/assets/')), + ).toBeTruthy() + }) + + test('Changing child content does not reload RSC', async ({ page }) => { + await page.goto('/rsc-slots') + await page.waitForURL('/rsc-slots') + await waitForHydration(page) + + // Get initial RSC timestamp + const initialRscTimestamp = await page + .getByTestId('rsc-slotted-timestamp') + .textContent() + + // Verify initial child content + await expect(page.getByTestId('child-content')).toContainText( + 'initial child', + ) + + // Change child content + await page.getByTestId('change-child-btn').click() + + // Verify child content changed + await expect(page.getByTestId('child-content')).toContainText( + 'Widget updated at', + ) + + // Verify RSC timestamp is unchanged (RSC was not reloaded) + const newRscTimestamp = await page + .getByTestId('rsc-slotted-timestamp') + .textContent() + expect(newRscTimestamp).toBe(initialRscTimestamp) + }) + + test('Changing footer render prop does not reload RSC', async ({ page }) => { + await page.goto('/rsc-slots') + await page.waitForURL('/rsc-slots') + await waitForHydration(page) + + // Get initial RSC timestamp and footer value + const initialRscTimestamp = await page + .getByTestId('rsc-slotted-timestamp') + .textContent() + await expect(page.getByTestId('footer-content')).toContainText( + 'Computed: 42', + ) + + // Change footer multiplier + await page.getByTestId('change-footer-btn').click() + + // Verify footer content changed + await expect(page.getByTestId('footer-content')).toContainText( + 'Computed: 84', + ) + + // Verify RSC timestamp is unchanged + const newRscTimestamp = await page + .getByTestId('rsc-slotted-timestamp') + .textContent() + expect(newRscTimestamp).toBe(initialRscTimestamp) + }) + + test('Adding/removing extra child does not reload RSC', async ({ page }) => { + await page.goto('/rsc-slots') + await page.waitForURL('/rsc-slots') + await waitForHydration(page) + + // Get initial RSC timestamp + const initialRscTimestamp = await page + .getByTestId('rsc-slotted-timestamp') + .textContent() + + // Extra child should not exist initially + await expect(page.getByTestId('extra-child-content')).not.toBeVisible() + + // Toggle to show extra child + await page.getByTestId('toggle-extra-child-btn').click() + await expect(page.getByTestId('extra-child-content')).toBeVisible() + await expect(page.getByTestId('extra-child-content')).toContainText( + 'Extra widget visible!', + ) + + // Verify RSC timestamp is unchanged + let newRscTimestamp = await page + .getByTestId('rsc-slotted-timestamp') + .textContent() + expect(newRscTimestamp).toBe(initialRscTimestamp) + + // Toggle to hide extra child + await page.getByTestId('toggle-extra-child-btn').click() + await expect(page.getByTestId('extra-child-content')).not.toBeVisible() + + // Verify RSC timestamp is still unchanged + newRscTimestamp = await page + .getByTestId('rsc-slotted-timestamp') + .textContent() + expect(newRscTimestamp).toBe(initialRscTimestamp) + }) + + test('Multiple slot changes in sequence do not reload RSC', async ({ + page, + }) => { + await page.goto('/rsc-slots') + await page.waitForURL('/rsc-slots') + await waitForHydration(page) + + // Get initial RSC timestamp + const initialRscTimestamp = await page + .getByTestId('rsc-slotted-timestamp') + .textContent() + + // Make multiple changes + await page.getByTestId('change-child-btn').click() + await page.getByTestId('change-footer-btn').click() + await page.getByTestId('toggle-extra-child-btn').click() + await page.getByTestId('change-child-btn').click() + await page.getByTestId('change-footer-btn').click() + + // Verify all changes took effect + await expect(page.getByTestId('child-content')).toContainText( + 'Widget updated at', + ) + await expect(page.getByTestId('footer-content')).toContainText( + 'Computed: 126', + ) // 42 * 3 + await expect(page.getByTestId('extra-child-content')).toBeVisible() + + // Verify RSC timestamp is unchanged through all changes + const newRscTimestamp = await page + .getByTestId('rsc-slotted-timestamp') + .textContent() + expect(newRscTimestamp).toBe(initialRscTimestamp) + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-ssr-data-only.spec.ts b/e2e/react-start/rsc/tests/rsc-ssr-data-only.spec.ts new file mode 100644 index 0000000000..34fe963283 --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-ssr-data-only.spec.ts @@ -0,0 +1,212 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC SSR Data-Only Tests - Loader on server, component on client', () => { + test('Page renders with RSC content after initial load', async ({ page }) => { + await page.goto('/rsc-ssr-data-only') + await page.waitForURL('/rsc-ssr-data-only') + + // Wait for content to appear (component renders on client) + await expect(page.getByTestId('rsc-ssr-data-only-content')).toBeVisible({ + timeout: 5000, + }) + + // Verify page title + await expect(page.getByTestId('rsc-ssr-data-only-title')).toHaveText( + 'Analytics Dashboard (SSR: data-only)', + ) + }) + + test('RSC server data is visible with correct metrics', async ({ page }) => { + await page.goto('/rsc-ssr-data-only') + await page.waitForURL('/rsc-ssr-data-only') + + await expect(page.getByTestId('rsc-ssr-data-only-content')).toBeVisible({ + timeout: 5000, + }) + + // Verify server-rendered metrics + await expect(page.getByTestId('rsc-report-title')).toContainText( + 'Analytics Report: Last 7 Days', + ) + await expect(page.getByTestId('metric-visitors')).toContainText('24,583') + await expect(page.getByTestId('metric-pageviews')).toContainText('89,421') + + // Verify server timestamp is present + const timestamp = await page + .getByTestId('rsc-server-timestamp') + .textContent() + expect(timestamp).toContain('Fetched:') + }) + + test('Client-rendered visualization is visible and uses browser dimensions', async ({ + page, + }) => { + await page.goto('/rsc-ssr-data-only') + await page.waitForURL('/rsc-ssr-data-only') + await expect(page.getByTestId('visualization')).toContainText( + /Window: \d+px/, + ) + + // Verify client visualization container + await expect(page.getByTestId('visualization')).toBeVisible() + + // Verify bar chart items are visible + await expect(page.getByTestId('bar-google')).toBeVisible() + await expect(page.getByTestId('bar-twitter')).toBeVisible() + await expect(page.getByTestId('bar-direct')).toBeVisible() + await expect(page.getByTestId('bar-linkedin')).toBeVisible() + }) + + test('Client interactivity works - selecting referrers', async ({ page }) => { + await page.goto('/rsc-ssr-data-only') + await page.waitForURL('/rsc-ssr-data-only') + await expect(page.getByTestId('visualization')).toContainText( + /Window: \d+px/, + ) + + await expect(page.getByTestId('visualization')).toBeVisible() + + // Initially no selection + await expect(page.getByTestId('selected-referrer')).not.toBeVisible() + + // Click on Google bar + await page.getByTestId('bar-google').click() + await expect(page.getByTestId('selected-referrer')).toBeVisible() + await expect(page.getByTestId('selected-referrer')).toContainText('Google') + await expect(page.getByTestId('selected-referrer')).toContainText('12,450') + + // Click on Twitter bar + await page.getByTestId('bar-twitter').click() + await expect(page.getByTestId('selected-referrer')).toContainText('Twitter') + await expect(page.getByTestId('selected-referrer')).toContainText('5,230') + + // Clear selection + await page.getByTestId('clear-selection-btn').click() + await expect(page.getByTestId('selected-referrer')).not.toBeVisible() + }) + + test('RSC timestamp remains stable during client interactions', async ({ + page, + }) => { + await page.goto('/rsc-ssr-data-only') + await page.waitForURL('/rsc-ssr-data-only') + await expect(page.getByTestId('visualization')).toContainText( + /Window: \d+px/, + ) + + await expect(page.getByTestId('visualization')).toBeVisible() + + // Get initial RSC timestamp + const initialTimestamp = await page + .getByTestId('rsc-server-timestamp') + .textContent() + + // Perform multiple client interactions + await page.getByTestId('bar-google').click() + await page.getByTestId('bar-twitter').click() + await page.getByTestId('bar-direct').click() + await page.getByTestId('clear-selection-btn').click() + await page.getByTestId('bar-linkedin').click() + + // Verify RSC timestamp is unchanged + const newTimestamp = await page + .getByTestId('rsc-server-timestamp') + .textContent() + expect(newTimestamp).toBe(initialTimestamp) + }) + + test('Page works correctly after client-side navigation', async ({ + page, + }) => { + // Start at home + await page.goto('/') + await page.waitForURL('/') + await waitForHydration(page) + + // Navigate to the page via nav bar + await page.getByTestId('nav-ssr-data-only').click() + await page.waitForURL('/rsc-ssr-data-only') + + // Verify content loads after client-side navigation + await expect(page.getByTestId('rsc-ssr-data-only-content')).toBeVisible({ + timeout: 5000, + }) + await expect(page.getByTestId('visualization')).toBeVisible() + await expect(page.getByTestId('bar-google')).toBeVisible() + + // Verify interactivity works + await page.getByTestId('bar-google').click() + await expect(page.getByTestId('selected-referrer')).toContainText('Google') + }) + + test('Client controls section is visible and functional', async ({ + page, + }) => { + await page.goto('/rsc-ssr-data-only') + await page.waitForURL('/rsc-ssr-data-only') + await expect(page.getByTestId('visualization')).toContainText( + /Window: \d+px/, + ) + + // Verify client controls section exists + await expect(page.getByTestId('client-controls')).toBeVisible() + + // Verify clear button works + await page.getByTestId('bar-google').click() + await expect(page.getByTestId('selected-referrer')).toBeVisible() + await page.getByTestId('clear-selection-btn').click() + await expect(page.getByTestId('selected-referrer')).not.toBeVisible() + }) + + test('Full page reload works correctly', async ({ page }) => { + await page.goto('/rsc-ssr-data-only') + await page.waitForURL('/rsc-ssr-data-only') + await expect(page.getByTestId('visualization')).toContainText( + /Window: \d+px/, + ) + + // Verify initial load + await expect(page.getByTestId('rsc-ssr-data-only-content')).toBeVisible() + + // Make a selection + await page.getByTestId('bar-google').click() + await expect(page.getByTestId('selected-referrer')).toContainText('Google') + + // Reload page + await page.reload() + await page.waitForURL('/rsc-ssr-data-only') + await expect(page.getByTestId('visualization')).toContainText( + /Window: \d+px/, + ) + + // Verify content reloads (selection should be cleared after reload) + await expect(page.getByTestId('rsc-ssr-data-only-content')).toBeVisible() + await expect(page.getByTestId('visualization')).toBeVisible() + await expect(page.getByTestId('selected-referrer')).not.toBeVisible() + }) + + test('All referrer bars display correct percentage values', async ({ + page, + }) => { + await page.goto('/rsc-ssr-data-only') + await page.waitForURL('/rsc-ssr-data-only') + await expect(page.getByTestId('visualization')).toContainText( + /Window: \d+px/, + ) + + await expect(page.getByTestId('visualization')).toBeVisible() + + // Verify percentage values + const googleBar = await page.getByTestId('bar-google').textContent() + const twitterBar = await page.getByTestId('bar-twitter').textContent() + const directBar = await page.getByTestId('bar-direct').textContent() + const linkedinBar = await page.getByTestId('bar-linkedin').textContent() + + expect(googleBar).toContain('51%') + expect(twitterBar).toContain('21%') + expect(directBar).toContain('17%') + expect(linkedinBar).toContain('11%') + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-ssr-false.spec.ts b/e2e/react-start/rsc/tests/rsc-ssr-false.spec.ts new file mode 100644 index 0000000000..509e599efb --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-ssr-false.spec.ts @@ -0,0 +1,355 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +type Point = { + x: number + y: number +} + +// This warning can occur during rapid navigation/hydration cycles and doesn't affect functionality +// It's a React development mode warning about async state updates during mounting +test.use({ + whitelistErrors: [ + "Can't perform a React state update on a component that hasn't mounted yet", + ], +}) + +test.describe('RSC SSR False Tests - Both loader and component on client', () => { + // Helper to clear localStorage and get a fresh start + async function clearDrawingStorage(page: any) { + await page.evaluate(() => { + localStorage.removeItem('drawing-name') + localStorage.removeItem('drawing-last-color') + localStorage.removeItem('drawing-canvas-data') + localStorage.removeItem('drawing-stroke-count') + }) + } + + async function drawStroke(page: any, start: Point, end: Point) { + await page.getByTestId('drawing-canvas').evaluate( + ( + canvas: HTMLCanvasElement, + { start, end }: { start: Point; end: Point }, + ) => { + const rect = canvas.getBoundingClientRect() + + const createMouseEvent = (type: string, point: Point) => + new MouseEvent(type, { + bubbles: true, + cancelable: true, + clientX: rect.left + point.x, + clientY: rect.top + point.y, + }) + + canvas.dispatchEvent(createMouseEvent('mousedown', start)) + canvas.dispatchEvent(createMouseEvent('mousemove', start)) + canvas.dispatchEvent(createMouseEvent('mousemove', end)) + canvas.dispatchEvent(createMouseEvent('mouseup', end)) + }, + { start, end }, + ) + } + + test('Page renders with RSC content after initial client load', async ({ + page, + }) => { + // Go to home first to clear any state, then navigate + await page.goto('/') + await clearDrawingStorage(page) + await page.goto('/rsc-ssr-false') + await page.waitForURL('/rsc-ssr-false') + + // Wait for content to appear (both loader and component run on client) + await expect(page.getByTestId('rsc-ssr-false-content')).toBeVisible({ + timeout: 5000, + }) + + // Verify page title + await expect(page.getByTestId('rsc-ssr-false-title')).toHaveText( + 'Drawing Canvas (SSR: false)', + ) + }) + + test('RSC server tools configuration is visible', async ({ page }) => { + await page.goto('/rsc-ssr-false') + await page.waitForURL('/rsc-ssr-false') + + await expect(page.getByTestId('rsc-ssr-false-content')).toBeVisible({ + timeout: 5000, + }) + + // Verify server-rendered tools info + await expect(page.getByTestId('rsc-drawing-title')).toContainText( + 'Drawing Canvas', + ) + await expect(page.getByTestId('brush-count')).toContainText('4 sizes') + await expect(page.getByTestId('color-count')).toContainText('5 colors') + await expect(page.getByTestId('canvas-size')).toContainText('400x200') + + // Verify server timestamp is present + const timestamp = await page + .getByTestId('rsc-server-timestamp') + .textContent() + expect(timestamp).toContain('Loaded:') + }) + + test('Canvas is rendered and visible', async ({ page }) => { + await page.goto('/rsc-ssr-false') + await page.waitForURL('/rsc-ssr-false') + await waitForHydration(page) + + // Verify canvas container + await expect(page.getByTestId('canvas-container')).toBeVisible() + + // Verify canvas element exists + await expect(page.getByTestId('drawing-canvas')).toBeVisible() + }) + + test('Brush size selection works', async ({ page }) => { + await page.goto('/rsc-ssr-false') + await page.waitForURL('/rsc-ssr-false') + await waitForHydration(page) + + await expect(page.getByTestId('canvas-container')).toBeVisible() + + // Click different brush sizes + await page.getByTestId('brush-2').click() + await page.getByTestId('brush-10').click() + await page.getByTestId('brush-20').click() + await page.getByTestId('brush-5').click() + + // Buttons should be clickable without error + await expect(page.getByTestId('brush-5')).toBeVisible() + }) + + test('Color selection works', async ({ page }) => { + await page.goto('/rsc-ssr-false') + await page.waitForURL('/rsc-ssr-false') + await waitForHydration(page) + + await expect(page.getByTestId('canvas-container')).toBeVisible() + + // Click different colors + await page.getByTestId('color-blue').click() + await page.getByTestId('color-green').click() + await page.getByTestId('color-red').click() + await page.getByTestId('color-purple').click() + await page.getByTestId('color-black').click() + + // Buttons should be clickable without error + await expect(page.getByTestId('color-black')).toBeVisible() + }) + + test('Drawing on canvas updates stroke count', async ({ page }) => { + await page.goto('/rsc-ssr-false') + await page.waitForURL('/rsc-ssr-false') + await waitForHydration(page) + + await expect(page.getByTestId('canvas-container')).toBeVisible() + + // Draw a stroke + await drawStroke(page, { x: 50, y: 50 }, { x: 150, y: 100 }) + + // Verify stroke count increased + await expect(page.getByTestId('canvas-container')).toContainText( + 'Strokes: 1', + ) + + // Draw another stroke + await drawStroke(page, { x: 100, y: 30 }, { x: 200, y: 80 }) + + // Verify stroke count increased again + await expect(page.getByTestId('canvas-container')).toContainText( + 'Strokes: 2', + ) + }) + + test('Clear canvas button works', async ({ page }) => { + await page.goto('/rsc-ssr-false') + await page.waitForURL('/rsc-ssr-false') + await waitForHydration(page) + + await expect(page.getByTestId('canvas-container')).toBeVisible() + + // Draw a stroke + await drawStroke(page, { x: 50, y: 50 }, { x: 150, y: 100 }) + + // Verify stroke was recorded + await expect(page.getByTestId('canvas-container')).toContainText( + 'Strokes: 1', + ) + + // Clear canvas + await page.getByTestId('clear-canvas-btn').click() + + // Verify stroke count reset + await expect(page.getByTestId('canvas-container')).toContainText( + 'Strokes: 0', + ) + }) + + test('Save controls are visible and functional', async ({ page }) => { + await page.goto('/rsc-ssr-false') + await page.waitForURL('/rsc-ssr-false') + await waitForHydration(page) + + // Verify save controls section exists + await expect(page.getByTestId('save-controls')).toBeVisible() + + // Verify input and button exist + await expect(page.getByTestId('drawing-name-input')).toBeVisible() + await expect(page.getByTestId('save-drawing-btn')).toBeVisible() + + // Initial name should be "Untitled" or whatever was saved + const initialName = await page.getByTestId('current-name').textContent() + expect(initialName).toBeTruthy() + + // Change the name + await page.getByTestId('drawing-name-input').fill('My Masterpiece') + await page.getByTestId('save-drawing-btn').click() + + // Verify name updated + await expect(page.getByTestId('current-name')).toContainText( + 'My Masterpiece', + ) + }) + + test('RSC timestamp remains stable during client interactions', async ({ + page, + }) => { + await page.goto('/rsc-ssr-false') + await page.waitForURL('/rsc-ssr-false') + await waitForHydration(page) + + await expect(page.getByTestId('rsc-ssr-false-content')).toBeVisible() + + // Get initial RSC timestamp + const initialTimestamp = await page + .getByTestId('rsc-server-timestamp') + .textContent() + + // Perform multiple client interactions + await page.getByTestId('brush-10').click() + await page.getByTestId('color-blue').click() + await page.getByTestId('brush-20').click() + await page.getByTestId('color-red').click() + await page.getByTestId('clear-canvas-btn').click() + + // Verify RSC timestamp is unchanged + const newTimestamp = await page + .getByTestId('rsc-server-timestamp') + .textContent() + expect(newTimestamp).toBe(initialTimestamp) + }) + + test('Page works correctly after client-side navigation', async ({ + page, + }) => { + // Start at home + await page.goto('/') + await page.waitForURL('/') + await waitForHydration(page) + + // Navigate to the page via nav bar + await page.getByTestId('nav-ssr-false').click() + await page.waitForURL('/rsc-ssr-false') + + // Verify content loads after client-side navigation + await expect(page.getByTestId('rsc-ssr-false-content')).toBeVisible({ + timeout: 5000, + }) + await expect(page.getByTestId('canvas-container')).toBeVisible() + await expect(page.getByTestId('drawing-canvas')).toBeVisible() + + // Verify interactivity works + await page.getByTestId('color-green').click() + await page.getByTestId('brush-10').click() + }) + + test('LocalStorage persistence works across page visits', async ({ + page, + }) => { + // First visit - clear any previous state and save a name + await page.goto('/rsc-ssr-false') + await page.waitForURL('/rsc-ssr-false') + await waitForHydration(page) + + // Clear canvas to reset state + await page.getByTestId('clear-canvas-btn').click() + + await expect(page.getByTestId('save-controls')).toBeVisible() + + await page.getByTestId('drawing-name-input').fill('Saved Drawing') + await page.getByTestId('save-drawing-btn').click() + + // Also select a color (which saves to localStorage) + await page.getByTestId('color-purple').click() + + // Verify purple color button is selected (has thicker border) + const purpleBtn = page.getByTestId('color-purple') + await expect(purpleBtn).toHaveCSS('border-width', '3px') + + // Navigate away + await page.goto('/') + await page.waitForURL('/') + await waitForHydration(page) + + // Navigate back + await page.goto('/rsc-ssr-false') + await page.waitForURL('/rsc-ssr-false') + await waitForHydration(page) + + // Verify saved name is restored + await expect(page.getByTestId('rsc-saved-name')).toBeVisible() + await expect(page.getByTestId('rsc-saved-name')).toContainText( + 'Saved Drawing', + ) + + // Verify last color is restored (shown in RSC) + await expect(page.getByTestId('rsc-last-color')).toBeVisible() + await expect(page.getByTestId('rsc-last-color')).toContainText('#9333ea') + + // Verify purple color is pre-selected in the client canvas component + const purpleBtnAfterReload = page.getByTestId('color-purple') + await expect(purpleBtnAfterReload).toHaveCSS('border-width', '3px') + }) + + test('Full page reload works correctly', async ({ page }) => { + await page.goto('/rsc-ssr-false') + await page.waitForURL('/rsc-ssr-false') + await waitForHydration(page) + + // Verify initial load + await expect(page.getByTestId('rsc-ssr-false-content')).toBeVisible() + + // Clear any previous drawing first + await page.getByTestId('clear-canvas-btn').click() + + // Draw something + await drawStroke(page, { x: 50, y: 50 }, { x: 150, y: 100 }) + + // Verify stroke was counted + await expect(page.getByTestId('canvas-container')).toContainText( + 'Strokes: 1', + ) + + // Reload page + await page.reload() + await page.waitForURL('/rsc-ssr-false') + await waitForHydration(page) + + // Verify content reloads and drawing was restored from localStorage + await expect(page.getByTestId('rsc-ssr-false-content')).toBeVisible() + await expect(page.getByTestId('canvas-container')).toBeVisible() + await expect(page.getByTestId('restored-indicator')).toBeVisible() + await expect(page.getByTestId('restored-indicator')).toContainText( + 'Restored from localStorage', + ) + + // Verify stroke count was also restored + await expect(page.getByTestId('canvas-container')).toContainText( + 'Strokes: 1', + ) + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-stream-flash.spec.ts b/e2e/react-start/rsc/tests/rsc-stream-flash.spec.ts new file mode 100644 index 0000000000..cf494ff75c --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-stream-flash.spec.ts @@ -0,0 +1,197 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +/** + * RSC Stream Flash Prevention Tests + * + * These tests verify that RSCs delivered via ReadableStream are decoded + * before the stream emits them, preventing flash during render. + */ +test.describe('RSC Stream Flash Prevention', () => { + /** + * Helper to monitor for display:none flashes on elements matching a selector. + * Returns true if any matching element had display:none during monitoring. + */ + async function monitorElementsForFlash( + page: any, + selector: string, + actionFn: () => Promise, + ): Promise { + // Set up monitoring for any matching elements + await page.evaluate((sel: string) => { + ;(window as any).__flashDetected = false + ;(window as any).__monitoringActive = true + + const check = () => { + if (!(window as any).__monitoringActive) return + + const elements = document.querySelectorAll(sel) + elements.forEach((el) => { + let current: HTMLElement | null = el as HTMLElement + while (current) { + if (getComputedStyle(current).display === 'none') { + ;(window as any).__flashDetected = true + break + } + current = current.parentElement + } + }) + + setTimeout(check, 4) + } + check() + }, selector) + + await actionFn() + + // Wait a bit more to catch any late flashes + await page.waitForTimeout(500) + + await page.evaluate(() => { + ;(window as any).__monitoringActive = false + }) + + return await page.evaluate(() => (window as any).__flashDetected) + } + + test('no flash when RSCs stream via ReadableStream', async ({ page }) => { + await page.goto('/rsc-stream-readable') + await page.waitForURL('/rsc-stream-readable') + await waitForHydration(page) + + // Start streaming and monitor for flash on notification elements + const flashDetected = await monitorElementsForFlash( + page, + '[data-testid^="notification-notif_"]', + async () => { + await page.getByTestId('start-stream-btn').click() + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 15000, + }) + }, + ) + + expect(flashDetected).toBe(false) + + // Verify all notifications rendered + await expect(page.getByTestId('final-count')).toContainText( + '7 notifications', + ) + }) + + test('no flash when RSCs stream via async generator', async ({ page }) => { + await page.goto('/rsc-stream-generator') + await page.waitForURL('/rsc-stream-generator') + await waitForHydration(page) + + const flashDetected = await monitorElementsForFlash( + page, + '[data-testid^="notification-notif_"]', + async () => { + await page.getByTestId('start-stream-btn').click() + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 15000, + }) + }, + ) + + expect(flashDetected).toBe(false) + + // Verify all notifications rendered + await expect(page.getByTestId('final-count')).toContainText( + '7 notifications', + ) + }) + + test('no flash when directly loading route with loader-based RSC streaming', async ({ + page, + }) => { + // Direct navigation to loader-based streaming route (SSR path) + await page.goto('/rsc-stream-loader') + await page.waitForURL('/rsc-stream-loader') + + // Wait for streaming to complete + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 15000, + }) + + // Verify all notifications rendered + await expect(page.getByTestId('final-count')).toContainText( + '7 notifications', + ) + }) + + test('streamed RSCs have SERVER COMPONENT badge', async ({ page }) => { + await page.goto('/rsc-stream-readable') + await page.waitForURL('/rsc-stream-readable') + await waitForHydration(page) + + // Start streaming + await page.getByTestId('start-stream-btn').click() + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 20000, + }) + + // Each notification should have SERVER COMPONENT badge + const notifications = page + .getByTestId('notification-list') + .locator('[data-testid^="notification-notif_"]') + const count = await notifications.count() + expect(count).toBe(7) + + // Check first notification + const firstNotification = notifications.first() + await expect(firstNotification).toContainText('SERVER COMPONENT') + }) + + test('client interactivity works on streamed RSCs', async ({ page }) => { + await page.goto('/rsc-stream-readable') + await page.waitForURL('/rsc-stream-readable') + await waitForHydration(page) + + // Start streaming + await page.getByTestId('start-stream-btn').click() + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 20000, + }) + + // Expand first notification - should work without flash + await expect(page.getByTestId('expand-btn-0')).toBeVisible({ + timeout: 5000, + }) + await expect(page.getByTestId('expand-btn-0')).toBeEnabled() + await page.getByTestId('expand-btn-0').click() + + // Expanded content should appear without flash + await expect(page.getByTestId('expanded-content-0')).toBeVisible({ + timeout: 5000, + }) + await expect(page.getByTestId('expanded-content-0')).toContainText( + 'Expanded view for', + ) + }) + + test('no flash on direct SSR load of streaming route', async ({ page }) => { + // Direct navigation (SSR) + await page.goto('/rsc-stream-loader') + await page.waitForURL('/rsc-stream-loader') + + // Should see streaming or complete status + await expect( + page + .getByTestId('streaming-status') + .or(page.getByTestId('stream-complete')), + ).toBeVisible({ timeout: 15000 }) + + // Wait for completion + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 15000, + }) + + // Verify notifications rendered + await expect(page.getByTestId('final-count')).toContainText( + '7 notifications', + ) + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-stream-generator.spec.ts b/e2e/react-start/rsc/tests/rsc-stream-generator.spec.ts new file mode 100644 index 0000000000..5faa6b1508 --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-stream-generator.spec.ts @@ -0,0 +1,251 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC Stream Generator Tests - Streaming RSCs via async generator', () => { + test('Page loads with empty state and controls visible', async ({ page }) => { + await page.goto('/rsc-stream-generator') + await page.waitForURL('/rsc-stream-generator') + + // Verify page title + await expect(page.getByTestId('rsc-stream-generator-title')).toHaveText( + 'Streaming RSCs - Async Generator Pattern', + ) + + // Verify controls are visible + await expect(page.getByTestId('controls')).toBeVisible() + await expect(page.getByTestId('start-stream-btn')).toBeVisible() + await expect(page.getByTestId('start-stream-btn')).toContainText( + 'Start Streaming Notifications', + ) + + // Verify empty state is shown + await expect(page.getByTestId('empty-state')).toBeVisible() + await expect(page.getByTestId('empty-state')).toContainText( + 'No notifications yet', + ) + }) + + test('Clicking start button begins streaming notifications', async ({ + page, + }) => { + await page.goto('/rsc-stream-generator') + await page.waitForURL('/rsc-stream-generator') + await waitForHydration(page) + + // Start streaming + await page.getByTestId('start-stream-btn').click() + + // Streaming status should appear + await expect(page.getByTestId('streaming-status')).toBeVisible() + await expect(page.getByTestId('notification-count')).toContainText( + 'notification(s)', + ) + + // Button should be disabled during streaming + await expect(page.getByTestId('start-stream-btn')).toBeDisabled() + await expect(page.getByTestId('start-stream-btn')).toContainText( + 'Streaming...', + ) + + // Wait for stream to complete + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 10000, + }) + + // Verify final count (3 initial + 4 streamed = 7 total) + await expect(page.getByTestId('final-count')).toContainText( + 'Received 7 notifications', + ) + }) + + test('Notifications stream in progressively', async ({ page }) => { + await page.goto('/rsc-stream-generator') + await page.waitForURL('/rsc-stream-generator') + await waitForHydration(page) + + // Start streaming + await page.getByTestId('start-stream-btn').click() + + // First 3 should appear quickly (initial batch) + await expect(page.getByTestId('notification-list')).toBeVisible() + + // Wait a bit and check that notifications are accumulating + await page.waitForTimeout(500) + const initialCount = await page + .getByTestId('notification-list') + .locator('[data-testid^="notification-notif_"]') + .count() + expect(initialCount).toBeGreaterThanOrEqual(3) + + // Wait for more to stream in + await page.waitForTimeout(2000) + const laterCount = await page + .getByTestId('notification-list') + .locator('[data-testid^="notification-notif_"]') + .count() + expect(laterCount).toBeGreaterThan(initialCount) + + // Wait for completion + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 10000, + }) + }) + + test('Each notification is a complete RSC with server data', async ({ + page, + }) => { + await page.goto('/rsc-stream-generator') + await page.waitForURL('/rsc-stream-generator') + await waitForHydration(page) + + // Start streaming and wait for completion + await page.getByTestId('start-stream-btn').click() + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 10000, + }) + + // Each notification should have server-rendered content + const notifications = page + .getByTestId('notification-list') + .locator('[data-testid^="notification-notif_"]') + const count = await notifications.count() + expect(count).toBe(7) + + // Verify first notification has required content + const firstNotification = notifications.first() + await expect(firstNotification).toContainText('SERVER COMPONENT') + await expect(firstNotification).toContainText('Notification 1') + }) + + test('Client slots (dismiss/restore) work on each streamed RSC', async ({ + page, + }) => { + await page.goto('/rsc-stream-generator') + await page.waitForURL('/rsc-stream-generator') + await waitForHydration(page) + + // Start streaming and wait for completion + await page.getByTestId('start-stream-btn').click() + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 10000, + }) + + // Find and click dismiss button on first notification + await expect(page.getByTestId('dismiss-btn-0')).toBeVisible() + await page.getByTestId('dismiss-btn-0').click() + + // Verify dismissed label appears + await expect(page.getByTestId('dismissed-label-0')).toBeVisible() + await expect(page.getByTestId('dismissed-label-0')).toContainText( + 'Dismissed', + ) + + // Wrapper should have reduced opacity (indicated by the visual state) + const wrapper = page.getByTestId('notification-wrapper-0') + await expect(wrapper).toBeVisible() + + // Button text should change to Restore + await expect(page.getByTestId('dismiss-btn-0')).toContainText('Restore') + + // Click again to restore + await page.getByTestId('dismiss-btn-0').click() + await expect(page.getByTestId('dismissed-label-0')).not.toBeVisible() + await expect(page.getByTestId('dismiss-btn-0')).toContainText('Dismiss') + }) + + test('Action slot receives correct notification ID from server', async ({ + page, + }) => { + await page.goto('/rsc-stream-generator') + await page.waitForURL('/rsc-stream-generator') + await waitForHydration(page) + + // Start streaming and wait for completion + await page.getByTestId('start-stream-btn').click() + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 10000, + }) + + // Each action slot should show the notification ID from the server + const actionId0 = await page.getByTestId('action-notif-id-0').textContent() + expect(actionId0).toContain('ID: notif_') + + const actionId3 = await page.getByTestId('action-notif-id-3').textContent() + expect(actionId3).toContain('ID: notif_') + + // IDs should be different + expect(actionId0).not.toBe(actionId3) + }) + + test('Multiple notifications can have independent dismiss state', async ({ + page, + }) => { + await page.goto('/rsc-stream-generator') + await page.waitForURL('/rsc-stream-generator') + await waitForHydration(page) + + // Start streaming and wait for completion + await page.getByTestId('start-stream-btn').click() + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 10000, + }) + + // Dismiss first and third notifications + await page.getByTestId('dismiss-btn-0').click() + await page.getByTestId('dismiss-btn-2').click() + + // Verify independent state + await expect(page.getByTestId('dismissed-label-0')).toBeVisible() + await expect(page.getByTestId('dismissed-label-2')).toBeVisible() + + // Second should not be dismissed + await expect(page.getByTestId('dismissed-label-1')).not.toBeVisible() + + // Restore first, third should remain dismissed + await page.getByTestId('dismiss-btn-0').click() + await expect(page.getByTestId('dismissed-label-0')).not.toBeVisible() + await expect(page.getByTestId('dismissed-label-2')).toBeVisible() + + // Final count should show dismissed count + await expect(page.getByTestId('final-count')).toContainText('1 dismissed') + }) + + test('Can restart streaming after completion', async ({ page }) => { + await page.goto('/rsc-stream-generator') + await page.waitForURL('/rsc-stream-generator') + await waitForHydration(page) + + // First stream + await page.getByTestId('start-stream-btn').click() + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 10000, + }) + + // Dismiss a notification + await page.getByTestId('dismiss-btn-0').click() + await expect(page.getByTestId('dismissed-label-0')).toBeVisible() + + // Button should be enabled again + await expect(page.getByTestId('start-stream-btn')).not.toBeDisabled() + + // Start second stream + await page.getByTestId('start-stream-btn').click() + + // Should see streaming status again + await expect(page.getByTestId('streaming-status')).toBeVisible() + + // Wait for completion + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 10000, + }) + + // State should be reset - no dismissed notifications + await expect(page.getByTestId('final-count')).not.toContainText('dismissed') + + // Should have 7 new notifications + await expect(page.getByTestId('final-count')).toContainText( + 'Received 7 notifications', + ) + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-stream-loader.spec.ts b/e2e/react-start/rsc/tests/rsc-stream-loader.spec.ts new file mode 100644 index 0000000000..60ad04b3ce --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-stream-loader.spec.ts @@ -0,0 +1,176 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' + +test.describe('RSC Stream Loader Tests - Streaming RSCs via loader', () => { + test('Page loads and starts streaming automatically', async ({ page }) => { + await page.goto('/rsc-stream-loader') + await page.waitForURL('/rsc-stream-loader') + + // Verify page title + await expect(page.getByTestId('rsc-stream-loader-title')).toHaveText( + 'Streaming RSCs via Loader', + ) + + // Streaming should start automatically (no button click needed) + // Either streaming status or complete status should be visible + await expect( + page + .getByTestId('streaming-status') + .or(page.getByTestId('stream-complete')), + ).toBeVisible({ timeout: 10000 }) + }) + + test('Notifications stream in progressively without interaction', async ({ + page, + }) => { + await page.goto('/rsc-stream-loader') + await page.waitForURL('/rsc-stream-loader') + + // First notifications should appear quickly + await expect(page.getByTestId('notification-list')).toBeVisible() + + // Wait and check that notifications are accumulating + await page.waitForTimeout(1000) + const initialCount = await page + .getByTestId('notification-list') + .locator('[data-testid^="notification-notif_"]') + .count() + expect(initialCount).toBeGreaterThanOrEqual(1) + + // Wait for stream to complete + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 10000, + }) + + // Should have all 7 notifications (3 initial + 4 streamed) + await expect(page.getByTestId('final-count')).toContainText( + 'Received 7 notifications', + ) + }) + + test('Each notification is a complete RSC with server data', async ({ + page, + }) => { + await page.goto('/rsc-stream-loader') + await page.waitForURL('/rsc-stream-loader') + + // Wait for stream to complete + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 10000, + }) + + // Each notification should have SERVER COMPONENT badge + // Use auto-waiting assertion to handle Suspense transitions + const notifications = page + .getByTestId('notification-list') + .locator('[data-testid^="notification-notif_"]') + await expect(notifications).toHaveCount(7, { timeout: 5000 }) + + // Check first notification + const firstNotification = notifications.first() + await expect(firstNotification).toContainText('SERVER COMPONENT') + await expect(firstNotification).toContainText('Notification 1') + + // Check last notification + const lastNotification = notifications.last() + await expect(lastNotification).toContainText('SERVER COMPONENT') + await expect(lastNotification).toContainText('Notification 7') + }) + + test('Client slots work after streaming completes', async ({ page }) => { + await page.goto('/rsc-stream-loader') + await page.waitForURL('/rsc-stream-loader') + + // Wait for stream to complete + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 10000, + }) + + // Expand button should be visible and functional + await expect(page.getByTestId('expand-btn-0')).toBeVisible() + await expect(page.getByTestId('expand-btn-0')).toBeEnabled() + await page.getByTestId('expand-btn-0').click() + + // Expanded content should appear + await expect(page.getByTestId('expanded-content-0')).toBeVisible() + await expect(page.getByTestId('expanded-content-0')).toContainText( + 'Expanded view for', + ) + + // Can collapse + await page.getByTestId('expand-btn-0').click() + await expect(page.getByTestId('expanded-content-0')).not.toBeVisible() + }) + + test('Multiple notifications have independent expand state', async ({ + page, + }) => { + await page.goto('/rsc-stream-loader') + await page.waitForURL('/rsc-stream-loader') + + // Wait for stream to complete + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 10000, + }) + + // Expand first and third notifications + await expect(page.getByTestId('expand-btn-0')).toBeEnabled() + await expect(page.getByTestId('expand-btn-2')).toBeEnabled() + await page.getByTestId('expand-btn-0').click() + await page.getByTestId('expand-btn-2').click() + + // Both should be expanded + await expect(page.getByTestId('expanded-content-0')).toBeVisible() + await expect(page.getByTestId('expanded-content-2')).toBeVisible() + + // Second should not be expanded + await expect(page.getByTestId('expanded-content-1')).not.toBeVisible() + + // Collapse first, third should remain expanded + await page.getByTestId('expand-btn-0').click() + await expect(page.getByTestId('expanded-content-0')).not.toBeVisible() + await expect(page.getByTestId('expanded-content-2')).toBeVisible() + }) + + test('Loader timestamp is displayed', async ({ page }) => { + await page.goto('/rsc-stream-loader') + await page.waitForURL('/rsc-stream-loader') + + // Timing info should show + await expect(page.getByTestId('timing-info')).toBeVisible() + await expect(page.getByTestId('loader-timestamp')).toBeAttached() + }) + + test('Streaming works after client-side navigation', async ({ page }) => { + // Start at the streaming hub page + await page.goto('/rsc-streaming') + await page.waitForURL('/rsc-streaming') + + // Navigate to loader streaming page via client-side navigation + await page.getByTestId('link-rsc-stream-loader').click() + await page.waitForURL('/rsc-stream-loader') + + // Verify page title + await expect(page.getByTestId('rsc-stream-loader-title')).toHaveText( + 'Streaming RSCs via Loader', + ) + + // Streaming should work just like SSR + await expect(page.getByTestId('notification-list')).toBeVisible() + + // Wait for stream to complete + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 10000, + }) + + // Should have all 7 notifications + await expect(page.getByTestId('final-count')).toContainText( + 'Received 7 notifications', + ) + + // Client interactivity should work + await expect(page.getByTestId('expand-btn-0')).toBeEnabled() + await page.getByTestId('expand-btn-0').click() + await expect(page.getByTestId('expanded-content-0')).toBeVisible() + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-stream-readable.spec.ts b/e2e/react-start/rsc/tests/rsc-stream-readable.spec.ts new file mode 100644 index 0000000000..356907e311 --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-stream-readable.spec.ts @@ -0,0 +1,211 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC Stream Readable Tests - Streaming RSCs via ReadableStream', () => { + test('Page loads with empty state and controls visible', async ({ page }) => { + await page.goto('/rsc-stream-readable') + await page.waitForURL('/rsc-stream-readable') + + // Verify page title + await expect(page.getByTestId('rsc-stream-readable-title')).toHaveText( + 'Streaming RSCs - ReadableStream Pattern', + ) + + // Verify controls are visible + await expect(page.getByTestId('controls')).toBeVisible() + await expect(page.getByTestId('start-stream-btn')).toBeVisible() + await expect(page.getByTestId('start-stream-btn')).toContainText( + 'Start Streaming Notifications', + ) + + // Verify empty state is shown + await expect(page.getByTestId('empty-state')).toBeVisible() + await expect(page.getByTestId('empty-state')).toContainText( + 'No notifications yet', + ) + }) + + test('Clicking start button begins streaming notifications', async ({ + page, + }) => { + await page.goto('/rsc-stream-readable') + await page.waitForURL('/rsc-stream-readable') + await waitForHydration(page) + + // Start streaming + await page.getByTestId('start-stream-btn').click() + + // Streaming status should appear + await expect(page.getByTestId('streaming-status')).toBeVisible() + await expect(page.getByTestId('notification-count')).toContainText( + 'notification(s)', + ) + + // Button should be disabled during streaming + await expect(page.getByTestId('start-stream-btn')).toBeDisabled() + await expect(page.getByTestId('start-stream-btn')).toContainText( + 'Streaming...', + ) + + // Wait for stream to complete + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 10000, + }) + + // Verify final count (3 initial + 4 streamed = 7 total) + await expect(page.getByTestId('final-count')).toContainText( + 'Received 7 notifications', + ) + }) + + test('Notifications stream in progressively', async ({ page }) => { + await page.goto('/rsc-stream-readable') + await page.waitForURL('/rsc-stream-readable') + await waitForHydration(page) + + // Start streaming + await page.getByTestId('start-stream-btn').click() + + // First 3 should appear quickly (initial batch) + await expect(page.getByTestId('notification-list')).toBeVisible() + + // Wait a bit and check that notifications are accumulating + await page.waitForTimeout(500) + const initialCount = await page + .getByTestId('notification-list') + .locator('[data-testid^="notification-notif_"]') + .count() + expect(initialCount).toBeGreaterThanOrEqual(3) + + // Wait for more to stream in + await page.waitForTimeout(2000) + const laterCount = await page + .getByTestId('notification-list') + .locator('[data-testid^="notification-notif_"]') + .count() + expect(laterCount).toBeGreaterThan(initialCount) + + // Wait for completion + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 10000, + }) + }) + + test('Each notification is a complete RSC with server data', async ({ + page, + }) => { + await page.goto('/rsc-stream-readable') + await page.waitForURL('/rsc-stream-readable') + await waitForHydration(page) + + // Start streaming and wait for completion + await page.getByTestId('start-stream-btn').click() + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 10000, + }) + + // Each notification should have server-rendered content + const notifications = page + .getByTestId('notification-list') + .locator('[data-testid^="notification-notif_"]') + const count = await notifications.count() + expect(count).toBe(7) + + // Verify first notification has required content + const firstNotification = notifications.first() + await expect(firstNotification).toContainText('SERVER COMPONENT') + await expect(firstNotification).toContainText('Notification 1') + }) + + test('Client slots (actions) work on each streamed RSC', async ({ page }) => { + await page.goto('/rsc-stream-readable') + await page.waitForURL('/rsc-stream-readable') + await waitForHydration(page) + + // Start streaming and wait for completion + await page.getByTestId('start-stream-btn').click() + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 10000, + }) + + // Find and click expand button on first notification + await expect(page.getByTestId('expand-btn-0')).toBeVisible() + await page.getByTestId('expand-btn-0').click() + + // Verify expanded content appears + await expect(page.getByTestId('expanded-content-0')).toBeVisible() + await expect(page.getByTestId('expanded-content-0')).toContainText( + 'Expanded view for', + ) + + // Button text should change + await expect(page.getByTestId('expand-btn-0')).toContainText('Collapse') + + // Click again to collapse + await page.getByTestId('expand-btn-0').click() + await expect(page.getByTestId('expanded-content-0')).not.toBeVisible() + await expect(page.getByTestId('expand-btn-0')).toContainText('Expand') + }) + + test('Multiple notifications can have independent client state', async ({ + page, + }) => { + await page.goto('/rsc-stream-readable') + await page.waitForURL('/rsc-stream-readable') + await waitForHydration(page) + + // Start streaming and wait for completion + await page.getByTestId('start-stream-btn').click() + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 10000, + }) + + // Expand first and third notifications + await page.getByTestId('expand-btn-0').click() + await page.getByTestId('expand-btn-2').click() + + // Verify independent state + await expect(page.getByTestId('expanded-content-0')).toBeVisible() + await expect(page.getByTestId('expanded-content-2')).toBeVisible() + + // Second should still be collapsed + await expect(page.getByTestId('expanded-content-1')).not.toBeVisible() + + // Collapse first, third should remain expanded + await page.getByTestId('expand-btn-0').click() + await expect(page.getByTestId('expanded-content-0')).not.toBeVisible() + await expect(page.getByTestId('expanded-content-2')).toBeVisible() + }) + + test('Can restart streaming after completion', async ({ page }) => { + await page.goto('/rsc-stream-readable') + await page.waitForURL('/rsc-stream-readable') + await waitForHydration(page) + + // First stream + await page.getByTestId('start-stream-btn').click() + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 10000, + }) + + // Button should be enabled again + await expect(page.getByTestId('start-stream-btn')).not.toBeDisabled() + + // Start second stream + await page.getByTestId('start-stream-btn').click() + + // Should see streaming status again + await expect(page.getByTestId('streaming-status')).toBeVisible() + + // Wait for completion + await expect(page.getByTestId('stream-complete')).toBeVisible({ + timeout: 10000, + }) + + // Should have 7 new notifications (previous ones cleared) + await expect(page.getByTestId('final-count')).toContainText( + 'Received 7 notifications', + ) + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-suspense.spec.ts b/e2e/react-start/rsc/tests/rsc-suspense.spec.ts new file mode 100644 index 0000000000..b8673fdee4 --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-suspense.spec.ts @@ -0,0 +1,158 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC Suspense Tests - Async RSC with streaming', () => { + // Increase timeout for tests with longer delays + test.setTimeout(60000) + + test('RSC with async content renders after data loads', async ({ page }) => { + await page.goto('/rsc-suspense') + + // Verify page title + await expect(page.getByTestId('rsc-suspense-title')).toHaveText( + 'Analytics Dashboard - Async Loading', + ) + + // Wait for async content to load in single suspense section (2000ms delay) + const singleSection = page.getByTestId('single-suspense-section') + await expect(singleSection.getByTestId('rsc-suspense-content')).toBeVisible( + { timeout: 10000 }, + ) + // Check that async data loaded (it shows a number value now) + await expect(singleSection.getByTestId('async-data')).toBeVisible() + + // Verify timestamp is present (now formatted as "Started: HH:MM:SS") + const timestamp = await singleSection + .getByTestId('rsc-suspense-timestamp') + .textContent() + expect(timestamp).toContain('Started:') + }) + + test('RSC with multiple async sections renders all content', async ({ + page, + }) => { + await page.goto('/rsc-suspense') + + // Wait for the multi-suspense section + const multiSection = page.getByTestId('multi-suspense-section') + await expect( + multiSection.getByTestId('rsc-multi-suspense-content'), + ).toBeVisible({ timeout: 15000 }) + + // Both async sections should eventually render (delays: 500ms, 1500ms, 2500ms, 3500ms) + const sectionFast = multiSection.getByTestId('section-fast') + const sectionSlow = multiSection.getByTestId('section-slow') + + await expect(sectionFast).toBeVisible({ timeout: 5000 }) + await expect(sectionSlow).toBeVisible({ timeout: 10000 }) + + // Both should have loaded data (now shows "Loaded after Xms" text) + await expect(sectionFast.getByTestId('async-delay')).toContainText( + 'Loaded after 500ms', + ) + await expect(sectionSlow.getByTestId('async-delay')).toContainText( + 'Loaded after 2500ms', + ) + }) + + test('RSC renders correctly after client-side navigation', async ({ + page, + }) => { + // Start at home + await page.goto('/') + await page.waitForURL('/') + await waitForHydration(page) + + // Navigate to suspense page via nav bar (need to be specific to avoid matching example cards) + await page.getByTestId('nav-suspense').click() + await page.waitForURL('/rsc-suspense') + + // Verify async content loads in single section + const singleSection = page.getByTestId('single-suspense-section') + await expect(singleSection.getByTestId('rsc-suspense-content')).toBeVisible( + { timeout: 10000 }, + ) + await expect(singleSection.getByTestId('async-data')).toBeVisible() + }) + + test('Suspense fallback shows during client-side navigation', async ({ + page, + }) => { + // Start at a different page + await page.goto('/rsc-basic') + await expect(page.getByTestId('rsc-basic-title')).toBeVisible() + await waitForHydration(page) + + // Navigate to suspense page + await page.getByTestId('nav-suspense').click() + + // The server-side Suspense fallback (MetricLoading) should be visible + // while the async RSC content streams in. MetricLoading has "Loading..." text + // and data-testid="async-loading" + const singleSection = page.getByTestId('single-suspense-section') + + // Wait for either the loading state OR the content (in case it loads fast) + // The server-side fallback has "Loading..." text + const serverLoading = singleSection.getByTestId('async-loading') + const loadingVisible = await serverLoading + .waitFor({ state: 'visible', timeout: 3000 }) + .then(() => true) + .catch(() => false) + + // If we caught the loading state, verify it eventually transitions to content + if (loadingVisible) { + await expect(singleSection.getByTestId('async-content')).toBeVisible({ + timeout: 10000, + }) + } else { + // Content loaded too fast to see loading - that's acceptable for this test + // but let's at least verify the content is there + await expect(singleSection.getByTestId('async-content')).toBeVisible({ + timeout: 10000, + }) + } + + // The key assertion: the server-side loading state SHOULD have been visible + // This proves that streaming is working - server sends fallback immediately + expect(loadingVisible).toBe(true) + }) + + test('Server timestamp remains stable during client interaction', async ({ + page, + }) => { + await page.goto('/rsc-suspense') + + // Wait for content to load + const singleSection = page.getByTestId('single-suspense-section') + await expect(singleSection.getByTestId('rsc-suspense-content')).toBeVisible( + { timeout: 10000 }, + ) + + // Capture initial timestamp + const initialTimestamp = await singleSection + .getByTestId('rsc-suspense-timestamp') + .textContent() + expect(initialTimestamp).toContain('Started:') + + // Navigate away and back + await page.getByTestId('nav-home').click() + await page.waitForURL('/') + + await page.getByTestId('nav-suspense').click() + await page.waitForURL('/rsc-suspense') + + // Wait for content + await expect(singleSection.getByTestId('rsc-suspense-content')).toBeVisible( + { timeout: 10000 }, + ) + + // Timestamp should be different (new RSC loaded) + const newTimestamp = await singleSection + .getByTestId('rsc-suspense-timestamp') + .textContent() + + // New navigation should create new RSC with new timestamp + expect(newTimestamp).toContain('Started:') + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-tree.spec.ts b/e2e/react-start/rsc/tests/rsc-tree.spec.ts new file mode 100644 index 0000000000..9ba548bda5 --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-tree.spec.ts @@ -0,0 +1,191 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC Tree Restructuring - Moving RSC without reload', () => { + test('Changing parent element type does not reload RSC', async ({ page }) => { + await page.goto('/rsc-tree') + await page.waitForURL('/rsc-tree') + await waitForHydration(page) + + // Get initial RSC timestamp and instance ID + const initialRscTimestamp = await page + .getByTestId('rsc-tree-timestamp') + .textContent() + const initialInstanceId = await page + .getByTestId('rsc-tree-instance-id') + .textContent() + + // Verify initial parent type + await expect(page.getByTestId('current-parent-type')).toContainText('div') + + // Change to section + await page.getByTestId('change-parent-section').click() + await expect(page.getByTestId('current-parent-type')).toContainText( + 'section', + ) + + // Verify RSC timestamp and instance ID are unchanged + let newRscTimestamp = await page + .getByTestId('rsc-tree-timestamp') + .textContent() + let newInstanceId = await page + .getByTestId('rsc-tree-instance-id') + .textContent() + expect(newRscTimestamp).toBe(initialRscTimestamp) + expect(newInstanceId).toBe(initialInstanceId) + + // Change to article + await page.getByTestId('change-parent-article').click() + await expect(page.getByTestId('current-parent-type')).toContainText( + 'article', + ) + + // Verify RSC is still unchanged + newRscTimestamp = await page.getByTestId('rsc-tree-timestamp').textContent() + newInstanceId = await page.getByTestId('rsc-tree-instance-id').textContent() + expect(newRscTimestamp).toBe(initialRscTimestamp) + expect(newInstanceId).toBe(initialInstanceId) + + // Change back to div + await page.getByTestId('change-parent-div').click() + await expect(page.getByTestId('current-parent-type')).toContainText('div') + + // Verify RSC is still unchanged + newRscTimestamp = await page.getByTestId('rsc-tree-timestamp').textContent() + newInstanceId = await page.getByTestId('rsc-tree-instance-id').textContent() + expect(newRscTimestamp).toBe(initialRscTimestamp) + expect(newInstanceId).toBe(initialInstanceId) + }) + + test('Adding wrapper elements does not reload RSC', async ({ page }) => { + await page.goto('/rsc-tree') + await page.waitForURL('/rsc-tree') + await waitForHydration(page) + + // Get initial RSC timestamp + const initialRscTimestamp = await page + .getByTestId('rsc-tree-timestamp') + .textContent() + + // Verify initial wrapper count + await expect(page.getByTestId('current-wrapper-count')).toContainText('0') + + // Add wrapper + await page.getByTestId('add-wrapper').click() + await expect(page.getByTestId('current-wrapper-count')).toContainText('1') + await expect(page.getByTestId('wrapper-1')).toBeVisible() + + // Verify RSC timestamp is unchanged + let newRscTimestamp = await page + .getByTestId('rsc-tree-timestamp') + .textContent() + expect(newRscTimestamp).toBe(initialRscTimestamp) + + // Add more wrappers + await page.getByTestId('add-wrapper').click() + await page.getByTestId('add-wrapper').click() + await expect(page.getByTestId('current-wrapper-count')).toContainText('3') + await expect(page.getByTestId('wrapper-3')).toBeVisible() + + // Verify RSC timestamp is still unchanged + newRscTimestamp = await page.getByTestId('rsc-tree-timestamp').textContent() + expect(newRscTimestamp).toBe(initialRscTimestamp) + }) + + test('Removing wrapper elements does not reload RSC', async ({ page }) => { + await page.goto('/rsc-tree') + await page.waitForURL('/rsc-tree') + await waitForHydration(page) + + // Add some wrappers first + await page.getByTestId('add-wrapper').click() + await page.getByTestId('add-wrapper').click() + await expect(page.getByTestId('current-wrapper-count')).toContainText('2') + + // Get RSC timestamp after adding wrappers + const rscTimestampAfterAdd = await page + .getByTestId('rsc-tree-timestamp') + .textContent() + + // Remove wrapper + await page.getByTestId('remove-wrapper').click() + await expect(page.getByTestId('current-wrapper-count')).toContainText('1') + + // Verify RSC timestamp is unchanged + let newRscTimestamp = await page + .getByTestId('rsc-tree-timestamp') + .textContent() + expect(newRscTimestamp).toBe(rscTimestampAfterAdd) + + // Remove all wrappers + await page.getByTestId('remove-wrapper').click() + await expect(page.getByTestId('current-wrapper-count')).toContainText('0') + + // Verify RSC timestamp is still unchanged + newRscTimestamp = await page.getByTestId('rsc-tree-timestamp').textContent() + expect(newRscTimestamp).toBe(rscTimestampAfterAdd) + }) + + test('Combined parent and wrapper changes do not reload RSC', async ({ + page, + }) => { + await page.goto('/rsc-tree') + await page.waitForURL('/rsc-tree') + await waitForHydration(page) + + // Get initial RSC timestamp + const initialRscTimestamp = await page + .getByTestId('rsc-tree-timestamp') + .textContent() + + // Make multiple changes + await page.getByTestId('change-parent-section').click() + await page.getByTestId('add-wrapper').click() + await page.getByTestId('add-wrapper').click() + await page.getByTestId('change-parent-article').click() + await page.getByTestId('remove-wrapper').click() + await page.getByTestId('change-parent-div').click() + + // Verify final state + await expect(page.getByTestId('current-parent-type')).toContainText('div') + await expect(page.getByTestId('current-wrapper-count')).toContainText('1') + + // Verify RSC timestamp is unchanged through all changes + const newRscTimestamp = await page + .getByTestId('rsc-tree-timestamp') + .textContent() + expect(newRscTimestamp).toBe(initialRscTimestamp) + }) + + test('RSC position prop updates without reload', async ({ page }) => { + await page.goto('/rsc-tree') + await page.waitForURL('/rsc-tree') + await waitForHydration(page) + + // Get initial RSC timestamp + const initialRscTimestamp = await page + .getByTestId('rsc-tree-timestamp') + .textContent() + + // Verify initial position + await expect(page.getByTestId('rsc-tree-position')).toContainText( + '
    with 0 wrapper(s) at top', + ) + + // Change parent and wrapper + await page.getByTestId('change-parent-section').click() + await page.getByTestId('add-wrapper').click() + + // Verify position updated + await expect(page.getByTestId('rsc-tree-position')).toContainText( + '
    with 1 wrapper(s) at top', + ) + + // RSC timestamp should be unchanged (position is a slot prop, not server data) + const newRscTimestamp = await page + .getByTestId('rsc-tree-timestamp') + .textContent() + expect(newRscTimestamp).toBe(initialRscTimestamp) + }) +}) diff --git a/e2e/react-start/rsc/tests/rsc-use-server-fn.spec.ts b/e2e/react-start/rsc/tests/rsc-use-server-fn.spec.ts new file mode 100644 index 0000000000..206d23255b --- /dev/null +++ b/e2e/react-start/rsc/tests/rsc-use-server-fn.spec.ts @@ -0,0 +1,22 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import { waitForHydration } from './hydration' + +test.describe('RSC useServerFn Tests', () => { + test('useServerFn can be imported and called in an RSC app', async ({ + page, + }) => { + await page.goto('/rsc-use-server-fn') + await page.waitForURL('/rsc-use-server-fn') + await waitForHydration(page) + + await expect(page.getByTestId('rsc-use-server-fn-title')).toHaveText( + 'useServerFn with RSC', + ) + + await page.getByTestId('rsc-use-server-fn-button').click() + await expect(page.getByTestId('rsc-use-server-fn-message')).toHaveText( + 'useServerFn works with RSC builds', + ) + }) +}) diff --git a/e2e/react-start/rsc/tests/setup/global.setup.ts b/e2e/react-start/rsc/tests/setup/global.setup.ts new file mode 100644 index 0000000000..3def5f6941 --- /dev/null +++ b/e2e/react-start/rsc/tests/setup/global.setup.ts @@ -0,0 +1,6 @@ +import { e2eStartDummyServer } from '@tanstack/router-e2e-utils' +import packageJson from '../../package.json' with { type: 'json' } + +export default async function setup() { + await e2eStartDummyServer(process.env.E2E_PORT_KEY ?? packageJson.name) +} diff --git a/e2e/react-start/rsc/tests/setup/global.teardown.ts b/e2e/react-start/rsc/tests/setup/global.teardown.ts new file mode 100644 index 0000000000..a9ad1445f7 --- /dev/null +++ b/e2e/react-start/rsc/tests/setup/global.teardown.ts @@ -0,0 +1,6 @@ +import { e2eStopDummyServer } from '@tanstack/router-e2e-utils' +import packageJson from '../../package.json' with { type: 'json' } + +export default async function teardown() { + await e2eStopDummyServer(process.env.E2E_PORT_KEY ?? packageJson.name) +} diff --git a/e2e/react-start/basic-test-suite/tsconfig.json b/e2e/react-start/rsc/tsconfig.json similarity index 73% rename from e2e/react-start/basic-test-suite/tsconfig.json rename to e2e/react-start/rsc/tsconfig.json index 3f3dbe6bcd..cef9369516 100644 --- a/e2e/react-start/basic-test-suite/tsconfig.json +++ b/e2e/react-start/rsc/tsconfig.json @@ -1,18 +1,21 @@ { - "include": ["src/**/*.ts"], + "include": ["**/*.ts", "**/*.tsx"], "compilerOptions": { "strict": true, "esModuleInterop": true, + "jsx": "react-jsx", "module": "ESNext", "moduleResolution": "Bundler", "lib": ["DOM", "DOM.Iterable", "ES2022"], "isolatedModules": true, - "allowImportingTsExtensions": true, "resolveJsonModule": true, "skipLibCheck": true, "target": "ES2022", - "types": ["node"], + "allowJs": true, "forceConsistentCasingInFileNames": true, + "paths": { + "~/*": ["./src/*"] + }, "noEmit": true } } diff --git a/e2e/react-start/rsc/vite.config.ts b/e2e/react-start/rsc/vite.config.ts new file mode 100644 index 0000000000..c0ae311a5d --- /dev/null +++ b/e2e/react-start/rsc/vite.config.ts @@ -0,0 +1,25 @@ +import { defineConfig } from 'vite' +import { tanstackStart } from '@tanstack/react-start/plugin/vite' +import viteReact from '@vitejs/plugin-react' +import rsc from '@vitejs/plugin-rsc' + +const outDir = process.env.E2E_DIST_DIR ?? 'dist' + +export default defineConfig({ + resolve: { tsconfigPaths: true }, + build: { + outDir, + }, + server: { + port: 3000, + }, + plugins: [ + tanstackStart({ + rsc: { + enabled: true, + }, + }), + rsc(), + viteReact(), + ], +}) diff --git a/e2e/react-start/scroll-restoration/package.json b/e2e/react-start/scroll-restoration/package.json index f9700e4c3d..3dff10b56e 100644 --- a/e2e/react-start/scroll-restoration/package.json +++ b/e2e/react-start/scroll-restoration/package.json @@ -15,13 +15,11 @@ "@tanstack/react-router": "workspace:^", "@tanstack/react-router-devtools": "workspace:^", "@tanstack/react-start": "workspace:^", - "@tanstack/zod-adapter": "workspace:^", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", - "tailwind-merge": "^2.6.0", - "vite": "^8.0.0", - "zod": "^3.24.2" + "tailwind-merge": "^3.6.0", + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -34,6 +32,7 @@ "combinate": "^1.1.11", "srvx": "^0.11.9", "tailwindcss": "^4.2.2", - "typescript": "^6.0.2" + "typescript": "^6.0.2", + "vite": "^8.0.14" } } diff --git a/e2e/react-start/scroll-restoration/src/routeTree.gen.ts b/e2e/react-start/scroll-restoration/src/routeTree.gen.ts index 5194bbc556..1df27a0424 100644 --- a/e2e/react-start/scroll-restoration/src/routeTree.gen.ts +++ b/e2e/react-start/scroll-restoration/src/routeTree.gen.ts @@ -12,7 +12,15 @@ import { Route as rootRouteImport } from './routes/__root' import { Route as IndexRouteImport } from './routes/index' import { Route as testsWithSearchRouteImport } from './routes/(tests)/with-search' import { Route as testsWithLoaderRouteImport } from './routes/(tests)/with-loader' +import { Route as testsSsrScrollKeyRouteImport } from './routes/(tests)/ssr-scroll-key' +import { Route as testsResetScrollFalseCRouteImport } from './routes/(tests)/reset-scroll-false-c' +import { Route as testsResetScrollFalseBRouteImport } from './routes/(tests)/reset-scroll-false-b' +import { Route as testsResetScrollFalseARouteImport } from './routes/(tests)/reset-scroll-false-a' import { Route as testsNormalPageRouteImport } from './routes/(tests)/normal-page' +import { Route as testsNestedScrollSearchRouteImport } from './routes/(tests)/nested-scroll-search' +import { Route as testsNestedScrollCarryOverBRouteImport } from './routes/(tests)/nested-scroll-carry-over-b' +import { Route as testsNestedScrollCarryOverARouteImport } from './routes/(tests)/nested-scroll-carry-over-a' +import { Route as testsNestedScrollAwayRouteImport } from './routes/(tests)/nested-scroll-away' import { Route as testsHashScrollReproRouteImport } from './routes/(tests)/hash-scroll-repro' import { Route as testsHashScrollAboutRouteImport } from './routes/(tests)/hash-scroll-about' @@ -31,11 +39,53 @@ const testsWithLoaderRoute = testsWithLoaderRouteImport.update({ path: '/with-loader', getParentRoute: () => rootRouteImport, } as any) +const testsSsrScrollKeyRoute = testsSsrScrollKeyRouteImport.update({ + id: '/(tests)/ssr-scroll-key', + path: '/ssr-scroll-key', + getParentRoute: () => rootRouteImport, +} as any) +const testsResetScrollFalseCRoute = testsResetScrollFalseCRouteImport.update({ + id: '/(tests)/reset-scroll-false-c', + path: '/reset-scroll-false-c', + getParentRoute: () => rootRouteImport, +} as any) +const testsResetScrollFalseBRoute = testsResetScrollFalseBRouteImport.update({ + id: '/(tests)/reset-scroll-false-b', + path: '/reset-scroll-false-b', + getParentRoute: () => rootRouteImport, +} as any) +const testsResetScrollFalseARoute = testsResetScrollFalseARouteImport.update({ + id: '/(tests)/reset-scroll-false-a', + path: '/reset-scroll-false-a', + getParentRoute: () => rootRouteImport, +} as any) const testsNormalPageRoute = testsNormalPageRouteImport.update({ id: '/(tests)/normal-page', path: '/normal-page', getParentRoute: () => rootRouteImport, } as any) +const testsNestedScrollSearchRoute = testsNestedScrollSearchRouteImport.update({ + id: '/(tests)/nested-scroll-search', + path: '/nested-scroll-search', + getParentRoute: () => rootRouteImport, +} as any) +const testsNestedScrollCarryOverBRoute = + testsNestedScrollCarryOverBRouteImport.update({ + id: '/(tests)/nested-scroll-carry-over-b', + path: '/nested-scroll-carry-over-b', + getParentRoute: () => rootRouteImport, + } as any) +const testsNestedScrollCarryOverARoute = + testsNestedScrollCarryOverARouteImport.update({ + id: '/(tests)/nested-scroll-carry-over-a', + path: '/nested-scroll-carry-over-a', + getParentRoute: () => rootRouteImport, + } as any) +const testsNestedScrollAwayRoute = testsNestedScrollAwayRouteImport.update({ + id: '/(tests)/nested-scroll-away', + path: '/nested-scroll-away', + getParentRoute: () => rootRouteImport, +} as any) const testsHashScrollReproRoute = testsHashScrollReproRouteImport.update({ id: '/(tests)/hash-scroll-repro', path: '/hash-scroll-repro', @@ -51,7 +101,15 @@ export interface FileRoutesByFullPath { '/': typeof IndexRoute '/hash-scroll-about': typeof testsHashScrollAboutRoute '/hash-scroll-repro': typeof testsHashScrollReproRoute + '/nested-scroll-away': typeof testsNestedScrollAwayRoute + '/nested-scroll-carry-over-a': typeof testsNestedScrollCarryOverARoute + '/nested-scroll-carry-over-b': typeof testsNestedScrollCarryOverBRoute + '/nested-scroll-search': typeof testsNestedScrollSearchRoute '/normal-page': typeof testsNormalPageRoute + '/reset-scroll-false-a': typeof testsResetScrollFalseARoute + '/reset-scroll-false-b': typeof testsResetScrollFalseBRoute + '/reset-scroll-false-c': typeof testsResetScrollFalseCRoute + '/ssr-scroll-key': typeof testsSsrScrollKeyRoute '/with-loader': typeof testsWithLoaderRoute '/with-search': typeof testsWithSearchRoute } @@ -59,7 +117,15 @@ export interface FileRoutesByTo { '/': typeof IndexRoute '/hash-scroll-about': typeof testsHashScrollAboutRoute '/hash-scroll-repro': typeof testsHashScrollReproRoute + '/nested-scroll-away': typeof testsNestedScrollAwayRoute + '/nested-scroll-carry-over-a': typeof testsNestedScrollCarryOverARoute + '/nested-scroll-carry-over-b': typeof testsNestedScrollCarryOverBRoute + '/nested-scroll-search': typeof testsNestedScrollSearchRoute '/normal-page': typeof testsNormalPageRoute + '/reset-scroll-false-a': typeof testsResetScrollFalseARoute + '/reset-scroll-false-b': typeof testsResetScrollFalseBRoute + '/reset-scroll-false-c': typeof testsResetScrollFalseCRoute + '/ssr-scroll-key': typeof testsSsrScrollKeyRoute '/with-loader': typeof testsWithLoaderRoute '/with-search': typeof testsWithSearchRoute } @@ -68,7 +134,15 @@ export interface FileRoutesById { '/': typeof IndexRoute '/(tests)/hash-scroll-about': typeof testsHashScrollAboutRoute '/(tests)/hash-scroll-repro': typeof testsHashScrollReproRoute + '/(tests)/nested-scroll-away': typeof testsNestedScrollAwayRoute + '/(tests)/nested-scroll-carry-over-a': typeof testsNestedScrollCarryOverARoute + '/(tests)/nested-scroll-carry-over-b': typeof testsNestedScrollCarryOverBRoute + '/(tests)/nested-scroll-search': typeof testsNestedScrollSearchRoute '/(tests)/normal-page': typeof testsNormalPageRoute + '/(tests)/reset-scroll-false-a': typeof testsResetScrollFalseARoute + '/(tests)/reset-scroll-false-b': typeof testsResetScrollFalseBRoute + '/(tests)/reset-scroll-false-c': typeof testsResetScrollFalseCRoute + '/(tests)/ssr-scroll-key': typeof testsSsrScrollKeyRoute '/(tests)/with-loader': typeof testsWithLoaderRoute '/(tests)/with-search': typeof testsWithSearchRoute } @@ -78,7 +152,15 @@ export interface FileRouteTypes { | '/' | '/hash-scroll-about' | '/hash-scroll-repro' + | '/nested-scroll-away' + | '/nested-scroll-carry-over-a' + | '/nested-scroll-carry-over-b' + | '/nested-scroll-search' | '/normal-page' + | '/reset-scroll-false-a' + | '/reset-scroll-false-b' + | '/reset-scroll-false-c' + | '/ssr-scroll-key' | '/with-loader' | '/with-search' fileRoutesByTo: FileRoutesByTo @@ -86,7 +168,15 @@ export interface FileRouteTypes { | '/' | '/hash-scroll-about' | '/hash-scroll-repro' + | '/nested-scroll-away' + | '/nested-scroll-carry-over-a' + | '/nested-scroll-carry-over-b' + | '/nested-scroll-search' | '/normal-page' + | '/reset-scroll-false-a' + | '/reset-scroll-false-b' + | '/reset-scroll-false-c' + | '/ssr-scroll-key' | '/with-loader' | '/with-search' id: @@ -94,7 +184,15 @@ export interface FileRouteTypes { | '/' | '/(tests)/hash-scroll-about' | '/(tests)/hash-scroll-repro' + | '/(tests)/nested-scroll-away' + | '/(tests)/nested-scroll-carry-over-a' + | '/(tests)/nested-scroll-carry-over-b' + | '/(tests)/nested-scroll-search' | '/(tests)/normal-page' + | '/(tests)/reset-scroll-false-a' + | '/(tests)/reset-scroll-false-b' + | '/(tests)/reset-scroll-false-c' + | '/(tests)/ssr-scroll-key' | '/(tests)/with-loader' | '/(tests)/with-search' fileRoutesById: FileRoutesById @@ -103,7 +201,15 @@ export interface RootRouteChildren { IndexRoute: typeof IndexRoute testsHashScrollAboutRoute: typeof testsHashScrollAboutRoute testsHashScrollReproRoute: typeof testsHashScrollReproRoute + testsNestedScrollAwayRoute: typeof testsNestedScrollAwayRoute + testsNestedScrollCarryOverARoute: typeof testsNestedScrollCarryOverARoute + testsNestedScrollCarryOverBRoute: typeof testsNestedScrollCarryOverBRoute + testsNestedScrollSearchRoute: typeof testsNestedScrollSearchRoute testsNormalPageRoute: typeof testsNormalPageRoute + testsResetScrollFalseARoute: typeof testsResetScrollFalseARoute + testsResetScrollFalseBRoute: typeof testsResetScrollFalseBRoute + testsResetScrollFalseCRoute: typeof testsResetScrollFalseCRoute + testsSsrScrollKeyRoute: typeof testsSsrScrollKeyRoute testsWithLoaderRoute: typeof testsWithLoaderRoute testsWithSearchRoute: typeof testsWithSearchRoute } @@ -131,6 +237,34 @@ declare module '@tanstack/react-router' { preLoaderRoute: typeof testsWithLoaderRouteImport parentRoute: typeof rootRouteImport } + '/(tests)/ssr-scroll-key': { + id: '/(tests)/ssr-scroll-key' + path: '/ssr-scroll-key' + fullPath: '/ssr-scroll-key' + preLoaderRoute: typeof testsSsrScrollKeyRouteImport + parentRoute: typeof rootRouteImport + } + '/(tests)/reset-scroll-false-c': { + id: '/(tests)/reset-scroll-false-c' + path: '/reset-scroll-false-c' + fullPath: '/reset-scroll-false-c' + preLoaderRoute: typeof testsResetScrollFalseCRouteImport + parentRoute: typeof rootRouteImport + } + '/(tests)/reset-scroll-false-b': { + id: '/(tests)/reset-scroll-false-b' + path: '/reset-scroll-false-b' + fullPath: '/reset-scroll-false-b' + preLoaderRoute: typeof testsResetScrollFalseBRouteImport + parentRoute: typeof rootRouteImport + } + '/(tests)/reset-scroll-false-a': { + id: '/(tests)/reset-scroll-false-a' + path: '/reset-scroll-false-a' + fullPath: '/reset-scroll-false-a' + preLoaderRoute: typeof testsResetScrollFalseARouteImport + parentRoute: typeof rootRouteImport + } '/(tests)/normal-page': { id: '/(tests)/normal-page' path: '/normal-page' @@ -138,6 +272,34 @@ declare module '@tanstack/react-router' { preLoaderRoute: typeof testsNormalPageRouteImport parentRoute: typeof rootRouteImport } + '/(tests)/nested-scroll-search': { + id: '/(tests)/nested-scroll-search' + path: '/nested-scroll-search' + fullPath: '/nested-scroll-search' + preLoaderRoute: typeof testsNestedScrollSearchRouteImport + parentRoute: typeof rootRouteImport + } + '/(tests)/nested-scroll-carry-over-b': { + id: '/(tests)/nested-scroll-carry-over-b' + path: '/nested-scroll-carry-over-b' + fullPath: '/nested-scroll-carry-over-b' + preLoaderRoute: typeof testsNestedScrollCarryOverBRouteImport + parentRoute: typeof rootRouteImport + } + '/(tests)/nested-scroll-carry-over-a': { + id: '/(tests)/nested-scroll-carry-over-a' + path: '/nested-scroll-carry-over-a' + fullPath: '/nested-scroll-carry-over-a' + preLoaderRoute: typeof testsNestedScrollCarryOverARouteImport + parentRoute: typeof rootRouteImport + } + '/(tests)/nested-scroll-away': { + id: '/(tests)/nested-scroll-away' + path: '/nested-scroll-away' + fullPath: '/nested-scroll-away' + preLoaderRoute: typeof testsNestedScrollAwayRouteImport + parentRoute: typeof rootRouteImport + } '/(tests)/hash-scroll-repro': { id: '/(tests)/hash-scroll-repro' path: '/hash-scroll-repro' @@ -159,7 +321,15 @@ const rootRouteChildren: RootRouteChildren = { IndexRoute: IndexRoute, testsHashScrollAboutRoute: testsHashScrollAboutRoute, testsHashScrollReproRoute: testsHashScrollReproRoute, + testsNestedScrollAwayRoute: testsNestedScrollAwayRoute, + testsNestedScrollCarryOverARoute: testsNestedScrollCarryOverARoute, + testsNestedScrollCarryOverBRoute: testsNestedScrollCarryOverBRoute, + testsNestedScrollSearchRoute: testsNestedScrollSearchRoute, testsNormalPageRoute: testsNormalPageRoute, + testsResetScrollFalseARoute: testsResetScrollFalseARoute, + testsResetScrollFalseBRoute: testsResetScrollFalseBRoute, + testsResetScrollFalseCRoute: testsResetScrollFalseCRoute, + testsSsrScrollKeyRoute: testsSsrScrollKeyRoute, testsWithLoaderRoute: testsWithLoaderRoute, testsWithSearchRoute: testsWithSearchRoute, } diff --git a/e2e/react-start/scroll-restoration/src/router.tsx b/e2e/react-start/scroll-restoration/src/router.tsx index fef35c9e06..eb81f5bfa9 100644 --- a/e2e/react-start/scroll-restoration/src/router.tsx +++ b/e2e/react-start/scroll-restoration/src/router.tsx @@ -7,6 +7,18 @@ export function getRouter() { const router = createRouter({ routeTree, scrollRestoration: true, + scrollToTopSelectors: ['[data-scroll-restoration-id="carry-over-reset"]'], + getScrollRestorationKey: (location) => { + if (location.pathname === '/ssr-scroll-key') { + return 'ssr-scroll-key' + } + + if (location.pathname === '/hash-scroll-repro') { + return location.pathname + } + + return location.state.__TSR_key! || location.href + }, defaultPreload: 'intent', defaultErrorComponent: DefaultCatchBoundary, defaultNotFoundComponent: () => , diff --git a/e2e/react-start/scroll-restoration/src/routes/(tests)/hash-scroll-repro.tsx b/e2e/react-start/scroll-restoration/src/routes/(tests)/hash-scroll-repro.tsx index ff85d140fa..1017b63bc3 100644 --- a/e2e/react-start/scroll-restoration/src/routes/(tests)/hash-scroll-repro.tsx +++ b/e2e/react-start/scroll-restoration/src/routes/(tests)/hash-scroll-repro.tsx @@ -44,9 +44,36 @@ function Component() { > Invalidate + + #one + + + #four no reset +
    +
    + {Array.from({ length: 20 }).map((_, i) => ( +
    Nested scroll row {i}
    + ))} +
    +
    {sectionIds.map((sectionId) => (
    +

    nested-scroll-away

    +

    This route intentionally has no nested scroll container.

    +
    + ) +} diff --git a/e2e/react-start/scroll-restoration/src/routes/(tests)/nested-scroll-carry-over-a.tsx b/e2e/react-start/scroll-restoration/src/routes/(tests)/nested-scroll-carry-over-a.tsx new file mode 100644 index 0000000000..624727775c --- /dev/null +++ b/e2e/react-start/scroll-restoration/src/routes/(tests)/nested-scroll-carry-over-a.tsx @@ -0,0 +1,49 @@ +import { Link, createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/(tests)/nested-scroll-carry-over-a')({ + component: Component, +}) + +function ScrollBox({ + restorationId, + testId, +}: { + restorationId: string + testId: string +}) { + return ( +
    + {Array.from({ length: 20 }).map((_, i) => ( +
    Source row {i}
    + ))} +
    + ) +} + +function Component() { + return ( +
    +

    nested-scroll-carry-over-a

    + + Go to target + + + + + +
    + ) +} diff --git a/e2e/react-start/scroll-restoration/src/routes/(tests)/nested-scroll-carry-over-b.tsx b/e2e/react-start/scroll-restoration/src/routes/(tests)/nested-scroll-carry-over-b.tsx new file mode 100644 index 0000000000..69dddb2d14 --- /dev/null +++ b/e2e/react-start/scroll-restoration/src/routes/(tests)/nested-scroll-carry-over-b.tsx @@ -0,0 +1,38 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/(tests)/nested-scroll-carry-over-b')({ + component: Component, +}) + +function ScrollBox({ + restorationId, + testId, +}: { + restorationId: string + testId: string +}) { + return ( +
    + {Array.from({ length: 20 }).map((_, i) => ( +
    Target row {i}
    + ))} +
    + ) +} + +function Component() { + return ( +
    +

    nested-scroll-carry-over-b

    + + +
    + ) +} diff --git a/e2e/react-start/scroll-restoration/src/routes/(tests)/nested-scroll-search.tsx b/e2e/react-start/scroll-restoration/src/routes/(tests)/nested-scroll-search.tsx new file mode 100644 index 0000000000..7216ba421c --- /dev/null +++ b/e2e/react-start/scroll-restoration/src/routes/(tests)/nested-scroll-search.tsx @@ -0,0 +1,44 @@ +import { Link, createFileRoute } from '@tanstack/react-router' +import { z } from 'zod' + +export const Route = createFileRoute('/(tests)/nested-scroll-search')({ + validateSearch: z.object({ + query: z.string().optional(), + }), + component: Component, +}) + +function Component() { + const search = Route.useSearch() + const query = search.query ?? 'none' + + return ( +
    +

    nested-scroll-search

    +

    query: {query}

    +
    + + Set query + + + Away + +
    +
    + {Array.from({ length: 20 }).map((_, i) => ( +
    + Query {query} row {i} +
    + ))} +
    +
    + ) +} diff --git a/e2e/react-start/scroll-restoration/src/routes/(tests)/reset-scroll-false-a.tsx b/e2e/react-start/scroll-restoration/src/routes/(tests)/reset-scroll-false-a.tsx new file mode 100644 index 0000000000..89103f1194 --- /dev/null +++ b/e2e/react-start/scroll-restoration/src/routes/(tests)/reset-scroll-false-a.tsx @@ -0,0 +1,15 @@ +import { createFileRoute } from '@tanstack/react-router' +import { ResetScrollFalseList } from '../-components/reset-scroll-false-list' + +export const Route = createFileRoute('/(tests)/reset-scroll-false-a')({ + component: Component, +}) + +function Component() { + return ( +
    +

    reset-scroll-false-a

    + +
    + ) +} diff --git a/e2e/react-start/scroll-restoration/src/routes/(tests)/reset-scroll-false-b.tsx b/e2e/react-start/scroll-restoration/src/routes/(tests)/reset-scroll-false-b.tsx new file mode 100644 index 0000000000..19713d91e6 --- /dev/null +++ b/e2e/react-start/scroll-restoration/src/routes/(tests)/reset-scroll-false-b.tsx @@ -0,0 +1,15 @@ +import { createFileRoute } from '@tanstack/react-router' +import { ResetScrollFalseList } from '../-components/reset-scroll-false-list' + +export const Route = createFileRoute('/(tests)/reset-scroll-false-b')({ + component: Component, +}) + +function Component() { + return ( +
    +

    reset-scroll-false-b

    + +
    + ) +} diff --git a/e2e/react-start/scroll-restoration/src/routes/(tests)/reset-scroll-false-c.tsx b/e2e/react-start/scroll-restoration/src/routes/(tests)/reset-scroll-false-c.tsx new file mode 100644 index 0000000000..b7c2a853f6 --- /dev/null +++ b/e2e/react-start/scroll-restoration/src/routes/(tests)/reset-scroll-false-c.tsx @@ -0,0 +1,15 @@ +import { createFileRoute } from '@tanstack/react-router' +import { ResetScrollFalseList } from '../-components/reset-scroll-false-list' + +export const Route = createFileRoute('/(tests)/reset-scroll-false-c')({ + component: Component, +}) + +function Component() { + return ( +
    +

    reset-scroll-false-c

    + +
    + ) +} diff --git a/e2e/react-start/scroll-restoration/src/routes/(tests)/ssr-scroll-key.tsx b/e2e/react-start/scroll-restoration/src/routes/(tests)/ssr-scroll-key.tsx new file mode 100644 index 0000000000..e224ed9137 --- /dev/null +++ b/e2e/react-start/scroll-restoration/src/routes/(tests)/ssr-scroll-key.tsx @@ -0,0 +1,16 @@ +import { createFileRoute } from '@tanstack/react-router' +import * as React from 'react' +import { ScrollBlock } from '../-components/scroll-block' + +export const Route = createFileRoute('/(tests)/ssr-scroll-key')({ + component: Component, +}) + +function Component() { + return ( +
    +

    ssr-scroll-key

    + +
    + ) +} diff --git a/e2e/react-start/scroll-restoration/src/routes/(tests)/with-search.tsx b/e2e/react-start/scroll-restoration/src/routes/(tests)/with-search.tsx index 7916c18f73..ef4309e70c 100644 --- a/e2e/react-start/scroll-restoration/src/routes/(tests)/with-search.tsx +++ b/e2e/react-start/scroll-restoration/src/routes/(tests)/with-search.tsx @@ -1,10 +1,9 @@ import { createFileRoute } from '@tanstack/react-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' import { ScrollBlock } from '../-components/scroll-block' export const Route = createFileRoute('/(tests)/with-search')({ - validateSearch: zodValidator(z.object({ where: z.string() })), + validateSearch: z.object({ where: z.string() }), component: Component, }) diff --git a/e2e/react-start/scroll-restoration/src/routes/-components/reset-scroll-false-list.tsx b/e2e/react-start/scroll-restoration/src/routes/-components/reset-scroll-false-list.tsx new file mode 100644 index 0000000000..cdfe934aa1 --- /dev/null +++ b/e2e/react-start/scroll-restoration/src/routes/-components/reset-scroll-false-list.tsx @@ -0,0 +1,23 @@ +import { Link } from '@tanstack/react-router' +import type { CSSProperties } from 'react' +import type { LinkOptions } from '@tanstack/react-router' + +const style = { height: '100px', width: '50%' } satisfies CSSProperties + +export function ResetScrollFalseList({ to }: { to?: LinkOptions['to'] }) { + return Array.from({ length: 100 }, (_, i) => { + const label = i + 1 + + return ( +
    + + {label} + +
    + ) + }) +} diff --git a/e2e/react-start/scroll-restoration/src/routes/index.tsx b/e2e/react-start/scroll-restoration/src/routes/index.tsx index 9d36cca264..81835a5582 100644 --- a/e2e/react-start/scroll-restoration/src/routes/index.tsx +++ b/e2e/react-start/scroll-restoration/src/routes/index.tsx @@ -30,6 +30,23 @@ function HomeComponent() {

    ))} +
    +

    scroll restoration repro routes

    +

    + /hash-scroll-repro +

    +

    + + /nested-scroll-carry-over-a + +

    +

    + /nested-scroll-search +

    +

    + /reset-scroll-false-a +

    +
    ) } diff --git a/e2e/react-start/scroll-restoration/tests/app.spec.ts b/e2e/react-start/scroll-restoration/tests/app.spec.ts index 2485d04da0..2d7ee75fd3 100644 --- a/e2e/react-start/scroll-restoration/tests/app.spec.ts +++ b/e2e/react-start/scroll-restoration/tests/app.spec.ts @@ -8,6 +8,46 @@ test('Smoke - Renders home', async ({ page }) => { ).toBeVisible() }) +test('restores window scroll after force reload of a navigated route', async ({ + page, +}) => { + await page.goto('/') + await page.getByRole('link', { name: '/reset-scroll-false-a' }).click() + await expect( + page.getByRole('heading', { name: 'reset-scroll-false-a' }), + ).toBeVisible() + await expect + .poll(async () => + page.evaluate(() => document.documentElement.scrollHeight > innerHeight), + ) + .toBe(true) + + const scrollY = await page.evaluate(async () => { + window.scrollTo(0, 500) + await new Promise((resolve) => requestAnimationFrame(() => resolve(null))) + return window.scrollY + }) + + expect(scrollY).toBeGreaterThan(0) + + await page.reload() + await expect( + page.getByRole('heading', { name: 'reset-scroll-false-a' }), + ).toBeVisible() + await expect + .poll(async () => page.evaluate(() => window.scrollY)) + .toBe(scrollY) +}) + +test('initial hard navigation to a hash scrolls to the hash target', async ({ + page, +}) => { + await page.goto('/hash-scroll-repro#four') + await page.waitForLoadState('networkidle') + await expect(page.getByTestId('hash-scroll-section-four')).toBeInViewport() + await expect(page.getByTestId('hash-scroll-section-one')).not.toBeInViewport() +}) + // Test for scroll related stuff ;[ linkOptions({ to: '/normal-page' }), diff --git a/e2e/react-start/scroll-restoration/tests/hash-scroll-repro.spec.ts b/e2e/react-start/scroll-restoration/tests/hash-scroll-repro.spec.ts index 3a8dc92afc..d203ea8c26 100644 --- a/e2e/react-start/scroll-restoration/tests/hash-scroll-repro.spec.ts +++ b/e2e/react-start/scroll-restoration/tests/hash-scroll-repro.spec.ts @@ -79,3 +79,81 @@ test('router.invalidate does not scroll back to the current hash', async ({ const scrollYAfterInvalidate = await page.evaluate(() => window.scrollY) expect(scrollYAfterInvalidate).toBe(scrollYBeforeInvalidate) }) + +test('hash navigation wins over stale same-tab scroll restoration entries', async ({ + page, +}) => { + await goToRepro(page) + const staleScrollY = await scrollUpFromHashTarget(page) + + await page.reload() + await page.waitForLoadState('networkidle') + await expect( + page.getByTestId('hash-scroll-repro-invalidate-count'), + ).toBeVisible() + + await page.getByTestId('hash-scroll-section-one-link').click() + await expect(page.getByTestId('hash-scroll-section-one')).toBeInViewport() + + await expect( + page.getByTestId('hash-scroll-section-five'), + ).not.toBeInViewport() + + const scrollYAfterHashNavigation = await page.evaluate(() => window.scrollY) + expect(scrollYAfterHashNavigation).toBeLessThan(staleScrollY) +}) + +test('hash navigation still runs when only nested scroll entries restore', async ({ + page, +}) => { + await goToRepro(page) + + const nestedScrollTop = await page.evaluate(() => { + const nested = document.querySelector('[data-testid="hash-scroll-nested"]') + if (!(nested instanceof HTMLElement)) { + throw new Error('Missing nested scroller') + } + + nested.scrollTop = 80 + window.dispatchEvent(new PageTransitionEvent('pagehide')) + return nested.scrollTop + }) + + expect(nestedScrollTop).toBeGreaterThan(0) + + await page.reload() + await page.waitForLoadState('networkidle') + await expect( + page.getByTestId('hash-scroll-repro-invalidate-count'), + ).toBeVisible() + + await page.getByTestId('hash-scroll-section-one-link').click() + await expect(page.getByTestId('hash-scroll-section-one')).toBeInViewport() + + await expect + .poll(async () => { + return page.evaluate(() => { + const nested = document.querySelector( + '[data-testid="hash-scroll-nested"]', + ) + return nested instanceof HTMLElement ? nested.scrollTop : 0 + }) + }) + .toBe(nestedScrollTop) +}) + +test('hash navigation scrolls when resetScroll is false', async ({ page }) => { + await page.goto('/hash-scroll-repro#one') + await page.waitForLoadState('networkidle') + await expect(page.getByTestId('hash-scroll-section-one')).toBeInViewport() + + const scrollYBeforeHashNavigation = await page.evaluate(() => window.scrollY) + + await page.getByTestId('hash-scroll-section-four-no-reset-link').click() + + await expect(page).toHaveURL(/#four$/) + await expect(page.getByTestId('hash-scroll-section-four')).toBeInViewport() + await expect + .poll(async () => page.evaluate(() => window.scrollY)) + .toBeGreaterThan(scrollYBeforeHashNavigation) +}) diff --git a/e2e/react-start/scroll-restoration/tests/nested-scroll-carry-over.spec.ts b/e2e/react-start/scroll-restoration/tests/nested-scroll-carry-over.spec.ts new file mode 100644 index 0000000000..b26a6e32d3 --- /dev/null +++ b/e2e/react-start/scroll-restoration/tests/nested-scroll-carry-over.spec.ts @@ -0,0 +1,196 @@ +import { expect, test } from '@playwright/test' + +const storageKey = 'tsr-scroll-restoration-v1_3' + +test('carries existing nested scroll entries to the next key', async ({ + page, +}) => { + await page.goto('/nested-scroll-carry-over-a') + await page.waitForLoadState('networkidle') + await expect( + page.getByRole('heading', { name: 'nested-scroll-carry-over-a' }), + ).toBeVisible() + + const positions = await page.evaluate(() => { + const getScroller = (testId: string) => { + const element = document.querySelector(`[data-testid="${testId}"]`) + if (!(element instanceof HTMLElement)) { + throw new Error(`Missing ${testId}`) + } + return element + } + + const preserved = getScroller('carry-over-preserved') + const reset = getScroller('carry-over-reset') + const sourceOnly = getScroller('carry-over-source-only') + + preserved.scrollTop = 80 + reset.scrollTop = 80 + sourceOnly.scrollTop = 80 + + preserved.dispatchEvent(new Event('scroll', { bubbles: true })) + reset.dispatchEvent(new Event('scroll', { bubbles: true })) + sourceOnly.dispatchEvent(new Event('scroll', { bubbles: true })) + + return { + preserved: preserved.scrollTop, + reset: reset.scrollTop, + sourceOnly: sourceOnly.scrollTop, + } + }) + + expect(positions.preserved).toBeGreaterThan(0) + expect(positions.reset).toBeGreaterThan(0) + expect(positions.sourceOnly).toBeGreaterThan(0) + + await page.getByTestId('nested-scroll-carry-over-link').click() + await expect( + page.getByRole('heading', { name: 'nested-scroll-carry-over-b' }), + ).toBeVisible() + + await expect + .poll(async () => { + return page.evaluate(() => { + const element = document.querySelector( + '[data-testid="carry-over-preserved"]', + ) + return element instanceof HTMLElement ? element.scrollTop : 0 + }) + }) + .toBe(positions.preserved) + + await expect + .poll(async () => { + return page.evaluate(() => { + const element = document.querySelector( + '[data-testid="carry-over-reset"]', + ) + return element instanceof HTMLElement ? element.scrollTop : -1 + }) + }) + .toBe(0) + + await page.reload() + await page.waitForLoadState('networkidle') + await expect( + page.getByRole('heading', { name: 'nested-scroll-carry-over-b' }), + ).toBeVisible() + + await expect + .poll(async () => { + return page.evaluate(() => { + const element = document.querySelector( + '[data-testid="carry-over-preserved"]', + ) + return element instanceof HTMLElement ? element.scrollTop : 0 + }) + }) + .toBe(positions.preserved) + + await expect + .poll(async () => { + return page.evaluate(() => { + const element = document.querySelector( + '[data-testid="carry-over-reset"]', + ) + return element instanceof HTMLElement ? element.scrollTop : -1 + }) + }) + .toBe(0) + + const targetKeyEntries = await page.evaluate((scrollStorageKey) => { + const targetKey = window.history.state.__TSR_key + const raw = window.sessionStorage.getItem(scrollStorageKey) + const state = raw ? JSON.parse(raw) : {} + const entries = state[targetKey] ?? {} + + return { + hasPreserved: Object.hasOwn( + entries, + '[data-scroll-restoration-id="carry-over-preserved"]', + ), + hasReset: Object.hasOwn( + entries, + '[data-scroll-restoration-id="carry-over-reset"]', + ), + hasSourceOnly: Object.hasOwn( + entries, + '[data-scroll-restoration-id="carry-over-source-only"]', + ), + } + }, storageKey) + + expect(targetKeyEntries).toEqual({ + hasPreserved: true, + hasReset: false, + hasSourceOnly: false, + }) +}) + +test('restores carried nested scroll after search navigation and browser back', async ({ + page, +}) => { + await page.goto('/nested-scroll-search') + await page.waitForLoadState('networkidle') + await expect( + page.getByRole('heading', { name: 'nested-scroll-search' }), + ).toBeVisible() + + const scrollTop = await page.evaluate(() => { + const element = document.querySelector( + '[data-testid="nested-scroll-search-container"]', + ) + if (!(element instanceof HTMLElement)) { + throw new Error('Missing nested scroll container') + } + + element.scrollTop = 80 + element.dispatchEvent(new Event('scroll', { bubbles: true })) + return element.scrollTop + }) + + expect(scrollTop).toBeGreaterThan(0) + + await page.getByTestId('nested-scroll-search-link').click() + await expect(page.getByTestId('nested-scroll-search-query')).toHaveText( + 'query: xyz', + ) + + await expect + .poll(async () => { + return page.evaluate(() => { + const element = document.querySelector( + '[data-testid="nested-scroll-search-container"]', + ) + return element instanceof HTMLElement ? element.scrollTop : 0 + }) + }) + .toBe(scrollTop) + + await page.getByTestId('nested-scroll-away-link').click() + await expect( + page.getByRole('heading', { name: 'nested-scroll-away' }), + ).toBeVisible() + await expect(page.getByTestId('nested-scroll-search-container')).toHaveCount( + 0, + ) + + await page.goBack() + await expect( + page.getByRole('heading', { name: 'nested-scroll-search' }), + ).toBeVisible() + await expect(page.getByTestId('nested-scroll-search-query')).toHaveText( + 'query: xyz', + ) + + await expect + .poll(async () => { + return page.evaluate(() => { + const element = document.querySelector( + '[data-testid="nested-scroll-search-container"]', + ) + return element instanceof HTMLElement ? element.scrollTop : 0 + }) + }) + .toBe(scrollTop) +}) diff --git a/e2e/react-start/scroll-restoration/tests/reset-scroll-false.spec.ts b/e2e/react-start/scroll-restoration/tests/reset-scroll-false.spec.ts new file mode 100644 index 0000000000..c153a42d19 --- /dev/null +++ b/e2e/react-start/scroll-restoration/tests/reset-scroll-false.spec.ts @@ -0,0 +1,52 @@ +import { expect, test } from '@playwright/test' + +test('preserves carried window scroll for intermediate resetScroll=false entries', async ({ + page, +}) => { + await page.goto('/reset-scroll-false-a') + await page.waitForLoadState('networkidle') + await expect( + page.getByRole('heading', { name: 'reset-scroll-false-a' }), + ).toBeVisible() + + const scrollY = await page.evaluate(async () => { + window.scrollTo(0, 500) + window.dispatchEvent(new Event('scroll')) + await new Promise((resolve) => requestAnimationFrame(() => resolve(null))) + return window.scrollY + }) + + expect(scrollY).toBeGreaterThan(0) + await expect(page.getByTestId('reset-scroll-false-link-8')).toBeInViewport() + + await page.getByTestId('reset-scroll-false-link-8').click() + await expect(page).toHaveURL(/\/reset-scroll-false-b$/) + await expect( + page.getByRole('heading', { name: 'reset-scroll-false-b' }), + ).toHaveCount(1) + + await expect + .poll(async () => page.evaluate(() => window.scrollY)) + .toBe(scrollY) + await expect(page.getByTestId('reset-scroll-false-link-8')).toBeInViewport() + + await page.getByTestId('reset-scroll-false-link-8').click() + await expect(page).toHaveURL(/\/reset-scroll-false-c$/) + await expect( + page.getByRole('heading', { name: 'reset-scroll-false-c' }), + ).toHaveCount(1) + + await expect + .poll(async () => page.evaluate(() => window.scrollY)) + .toBe(scrollY) + + await page.goBack() + await expect(page).toHaveURL(/\/reset-scroll-false-b$/) + await expect( + page.getByRole('heading', { name: 'reset-scroll-false-b' }), + ).toHaveCount(1) + + await expect + .poll(async () => page.evaluate(() => window.scrollY)) + .toBe(scrollY) +}) diff --git a/e2e/react-start/scroll-restoration/tests/ssr-scroll-key.spec.ts b/e2e/react-start/scroll-restoration/tests/ssr-scroll-key.spec.ts new file mode 100644 index 0000000000..737695a0cf --- /dev/null +++ b/e2e/react-start/scroll-restoration/tests/ssr-scroll-key.spec.ts @@ -0,0 +1,40 @@ +import { expect, test } from '@playwright/test' + +const storageKey = 'tsr-scroll-restoration-v1_3' + +test('SSR scroll restoration uses a custom restoration key', async ({ + page, +}) => { + const customKeyScrollY = 650 + const historyKeyScrollY = 80 + + // Seed storage during document initialization so a hydrated previous page + // cannot persist an empty in-memory scroll cache over these entries. + await page.addInitScript( + ({ customKeyScrollY, historyKeyScrollY, storageKey }) => { + window.sessionStorage.setItem( + storageKey, + JSON.stringify({ + 'ssr-scroll-key': { + window: { scrollX: 0, scrollY: customKeyScrollY }, + }, + 'history-key': { + window: { scrollX: 0, scrollY: historyKeyScrollY }, + }, + }), + ) + window.history.replaceState({ __TSR_key: 'history-key' }, '') + }, + { customKeyScrollY, historyKeyScrollY, storageKey }, + ) + + await page.route(/\/assets\/.*\.js$/, (route) => route.abort()) + + await page.goto('/ssr-scroll-key', { waitUntil: 'domcontentloaded' }) + await expect( + page.getByRole('heading', { name: 'ssr-scroll-key' }), + ).toBeVisible() + await expect + .poll(async () => page.evaluate(() => window.scrollY)) + .toBe(customKeyScrollY) +}) diff --git a/e2e/react-start/selective-ssr/package.json b/e2e/react-start/selective-ssr/package.json index 213ea9558d..bd2ab622bd 100644 --- a/e2e/react-start/selective-ssr/package.json +++ b/e2e/react-start/selective-ssr/package.json @@ -17,8 +17,7 @@ "@tanstack/react-start": "workspace:^", "react": "^19.0.0", "react-dom": "^19.0.0", - "vite": "^8.0.0", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@tailwindcss/vite": "^4.2.2", @@ -29,6 +28,7 @@ "@vitejs/plugin-react": "^6.0.1", "srvx": "^0.11.9", "tailwindcss": "^4.2.2", - "typescript": "^6.0.2" + "typescript": "^6.0.2", + "vite": "^8.0.14" } } diff --git a/e2e/react-start/serialization-adapters/package.json b/e2e/react-start/serialization-adapters/package.json index ada4113cf0..f3cf7e6512 100644 --- a/e2e/react-start/serialization-adapters/package.json +++ b/e2e/react-start/serialization-adapters/package.json @@ -17,8 +17,7 @@ "@tanstack/react-start": "workspace:^", "react": "^19.0.0", "react-dom": "^19.0.0", - "vite": "^8.0.0", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@tailwindcss/vite": "^4.2.2", @@ -29,6 +28,7 @@ "@vitejs/plugin-react": "^6.0.1", "srvx": "^0.11.9", "tailwindcss": "^4.2.2", - "typescript": "^6.0.2" + "typescript": "^6.0.2", + "vite": "^8.0.14" } } diff --git a/e2e/react-start/serialization-adapters/src/routeTree.gen.ts b/e2e/react-start/serialization-adapters/src/routeTree.gen.ts index e193c31593..3536724473 100644 --- a/e2e/react-start/serialization-adapters/src/routeTree.gen.ts +++ b/e2e/react-start/serialization-adapters/src/routeTree.gen.ts @@ -14,6 +14,7 @@ import { Route as SsrStreamRouteImport } from './routes/ssr/stream' import { Route as SsrNestedRouteImport } from './routes/ssr/nested' import { Route as SsrDataOnlyRouteImport } from './routes/ssr/data-only' import { Route as ServerFunctionNestedRouteImport } from './routes/server-function/nested' +import { Route as ServerFunctionLateRawStreamRouteImport } from './routes/server-function/late-raw-stream' import { Route as ServerFunctionCustomErrorRouteImport } from './routes/server-function/custom-error' const IndexRoute = IndexRouteImport.update({ @@ -41,6 +42,12 @@ const ServerFunctionNestedRoute = ServerFunctionNestedRouteImport.update({ path: '/server-function/nested', getParentRoute: () => rootRouteImport, } as any) +const ServerFunctionLateRawStreamRoute = + ServerFunctionLateRawStreamRouteImport.update({ + id: '/server-function/late-raw-stream', + path: '/server-function/late-raw-stream', + getParentRoute: () => rootRouteImport, + } as any) const ServerFunctionCustomErrorRoute = ServerFunctionCustomErrorRouteImport.update({ id: '/server-function/custom-error', @@ -51,6 +58,7 @@ const ServerFunctionCustomErrorRoute = export interface FileRoutesByFullPath { '/': typeof IndexRoute '/server-function/custom-error': typeof ServerFunctionCustomErrorRoute + '/server-function/late-raw-stream': typeof ServerFunctionLateRawStreamRoute '/server-function/nested': typeof ServerFunctionNestedRoute '/ssr/data-only': typeof SsrDataOnlyRoute '/ssr/nested': typeof SsrNestedRoute @@ -59,6 +67,7 @@ export interface FileRoutesByFullPath { export interface FileRoutesByTo { '/': typeof IndexRoute '/server-function/custom-error': typeof ServerFunctionCustomErrorRoute + '/server-function/late-raw-stream': typeof ServerFunctionLateRawStreamRoute '/server-function/nested': typeof ServerFunctionNestedRoute '/ssr/data-only': typeof SsrDataOnlyRoute '/ssr/nested': typeof SsrNestedRoute @@ -68,6 +77,7 @@ export interface FileRoutesById { __root__: typeof rootRouteImport '/': typeof IndexRoute '/server-function/custom-error': typeof ServerFunctionCustomErrorRoute + '/server-function/late-raw-stream': typeof ServerFunctionLateRawStreamRoute '/server-function/nested': typeof ServerFunctionNestedRoute '/ssr/data-only': typeof SsrDataOnlyRoute '/ssr/nested': typeof SsrNestedRoute @@ -78,6 +88,7 @@ export interface FileRouteTypes { fullPaths: | '/' | '/server-function/custom-error' + | '/server-function/late-raw-stream' | '/server-function/nested' | '/ssr/data-only' | '/ssr/nested' @@ -86,6 +97,7 @@ export interface FileRouteTypes { to: | '/' | '/server-function/custom-error' + | '/server-function/late-raw-stream' | '/server-function/nested' | '/ssr/data-only' | '/ssr/nested' @@ -94,6 +106,7 @@ export interface FileRouteTypes { | '__root__' | '/' | '/server-function/custom-error' + | '/server-function/late-raw-stream' | '/server-function/nested' | '/ssr/data-only' | '/ssr/nested' @@ -103,6 +116,7 @@ export interface FileRouteTypes { export interface RootRouteChildren { IndexRoute: typeof IndexRoute ServerFunctionCustomErrorRoute: typeof ServerFunctionCustomErrorRoute + ServerFunctionLateRawStreamRoute: typeof ServerFunctionLateRawStreamRoute ServerFunctionNestedRoute: typeof ServerFunctionNestedRoute SsrDataOnlyRoute: typeof SsrDataOnlyRoute SsrNestedRoute: typeof SsrNestedRoute @@ -146,6 +160,13 @@ declare module '@tanstack/react-router' { preLoaderRoute: typeof ServerFunctionNestedRouteImport parentRoute: typeof rootRouteImport } + '/server-function/late-raw-stream': { + id: '/server-function/late-raw-stream' + path: '/server-function/late-raw-stream' + fullPath: '/server-function/late-raw-stream' + preLoaderRoute: typeof ServerFunctionLateRawStreamRouteImport + parentRoute: typeof rootRouteImport + } '/server-function/custom-error': { id: '/server-function/custom-error' path: '/server-function/custom-error' @@ -159,6 +180,7 @@ declare module '@tanstack/react-router' { const rootRouteChildren: RootRouteChildren = { IndexRoute: IndexRoute, ServerFunctionCustomErrorRoute: ServerFunctionCustomErrorRoute, + ServerFunctionLateRawStreamRoute: ServerFunctionLateRawStreamRoute, ServerFunctionNestedRoute: ServerFunctionNestedRoute, SsrDataOnlyRoute: SsrDataOnlyRoute, SsrNestedRoute: SsrNestedRoute, diff --git a/e2e/react-start/serialization-adapters/src/routes/server-function/late-raw-stream.tsx b/e2e/react-start/serialization-adapters/src/routes/server-function/late-raw-stream.tsx new file mode 100644 index 0000000000..e0d5311349 --- /dev/null +++ b/e2e/react-start/serialization-adapters/src/routes/server-function/late-raw-stream.tsx @@ -0,0 +1,278 @@ +import { createFileRoute } from '@tanstack/react-router' +import { RawStream, createServerFn } from '@tanstack/react-start' +import { Suspense, use, useEffect, useState } from 'react' + +/** + * Helper to create a readable stream of text chunks + */ +function createTextStream(chunks: Array, delayMs = 50) { + return new ReadableStream({ + async start(controller) { + const encoder = new TextEncoder() + for (const chunk of chunks) { + await new Promise((r) => setTimeout(r, delayMs)) + controller.enqueue(encoder.encode(chunk)) + } + controller.close() + }, + }) +} + +/** + * Server function that returns a Promise - tests late stream registration. + * The RawStream is discovered after the initial synchronous serialization pass. + */ +const getLateRawStream = createServerFn().handler(async () => { + // Delay before creating the RawStream + const delayedStream = new Promise((resolve) => { + setTimeout(() => { + resolve(new RawStream(createTextStream(['chunk1', '-chunk2', '-chunk3']))) + }, 100) + }) + + return { + immediate: 'immediate-data', + timestamp: Date.now(), + stream: delayedStream, + } +}) + +/** + * Server function that returns multiple late RawStreams with different delays. + */ +const getMultipleLateRawStreams = createServerFn().handler(async () => { + const stream1 = new Promise((resolve) => { + setTimeout(() => { + resolve(new RawStream(createTextStream(['stream1-a', '-stream1-b']))) + }, 50) + }) + + const stream2 = new Promise((resolve) => { + setTimeout(() => { + resolve(new RawStream(createTextStream(['stream2-a', '-stream2-b']))) + }, 150) + }) + + return { + timestamp: Date.now(), + stream1, + stream2, + } +}) + +/** + * Server function that returns a mix of immediate and late RawStreams. + */ +const getMixedRawStreams = createServerFn().handler(async () => { + // Immediate stream - discovered during initial serialization + const immediateStream = new RawStream( + createTextStream(['immediate-a', '-immediate-b']), + ) + + // Late stream - discovered after serialization starts + const lateStream = new Promise((resolve) => { + setTimeout(() => { + resolve(new RawStream(createTextStream(['late-a', '-late-b']))) + }, 100) + }) + + return { + timestamp: Date.now(), + immediateStream, + lateStream, + } +}) + +export const Route = createFileRoute('/server-function/late-raw-stream')({ + component: RouteComponent, +}) + +function StreamReader({ + stream, + testId, +}: { + stream: ReadableStream | RawStream + testId: string +}) { + const [result, setResult] = useState(null) + + useEffect(() => { + const actualStream = stream instanceof RawStream ? stream.stream : stream + const reader = actualStream.getReader() + const chunks: Array = [] + const decoder = new TextDecoder() + + const readChunks = async () => { + try { + while (true) { + const { done, value } = await reader.read() + if (done) break + chunks.push(decoder.decode(value)) + } + setResult(chunks.join('')) + } catch (error) { + setResult(`error: ${error}`) + } + } + readChunks() + }, [stream]) + + return ( +
    {result === null ? 'reading...' : result}
    + ) +} + +function LateStreamResolver({ + streamPromise, + testId, +}: { + streamPromise: Promise | RawStream> + testId: string +}) { + const stream = use(streamPromise) + return +} + +function LateStreamResult({ + resultPromise, +}: { + resultPromise: Promise>> +}) { + const result = use(resultPromise) + + return ( +
    +
    {result.immediate}
    +
    {result.timestamp}
    + loading late stream...
    }> + + +
    + ) +} + +function MultiStreamResult({ + resultPromise, +}: { + resultPromise: Promise>> +}) { + const result = use(resultPromise) + + return ( +
    +
    {result.timestamp}
    + loading stream1...
    }> + + + loading stream2...}> + + + + ) +} + +function MixedStreamResult({ + resultPromise, +}: { + resultPromise: Promise>> +}) { + const result = use(resultPromise) + + return ( +
    +
    {result.timestamp}
    + + loading late...
    }> + + + + ) +} + +function RouteComponent() { + const [lateResult, setLateResult] = useState> + > | null>(null) + const [multiResult, setMultiResult] = useState> + > | null>(null) + const [mixedResult, setMixedResult] = useState> + > | null>(null) + + return ( +
    +

    Late RawStream Tests

    + +
    +

    Single Late Stream

    + + {lateResult ? ( + loading...
    }> + + + ) : ( +
    waiting for trigger...
    + )} + + +
    +

    Multiple Late Streams

    + + {multiResult ? ( + loading...} + > + + + ) : ( +
    waiting for trigger...
    + )} +
    + +
    +

    Mixed Immediate + Late Streams

    + + {mixedResult ? ( + loading...} + > + + + ) : ( +
    waiting for trigger...
    + )} +
    + + ) +} diff --git a/e2e/react-start/serialization-adapters/tests/app.spec.ts b/e2e/react-start/serialization-adapters/tests/app.spec.ts index a74ed1af4f..cce9b552ae 100644 --- a/e2e/react-start/serialization-adapters/tests/app.spec.ts +++ b/e2e/react-start/serialization-adapters/tests/app.spec.ts @@ -9,10 +9,9 @@ async function awaitPageLoaded(page: Page) { await expect(page.getByTestId('router-status')).toContainText('idle') } async function checkData(page: Page, id: string) { - const expectedData = await page - .getByTestId(`${id}-car-expected`) - .textContent() - expect(expectedData).not.toBeNull() + const expectedDataLocator = page.getByTestId(`${id}-car-expected`) + await expect(expectedDataLocator).not.toBeEmpty() + const expectedData = await expectedDataLocator.textContent() await expect(page.getByTestId(`${id}-car-actual`)).toContainText( expectedData!, ) @@ -110,3 +109,84 @@ test.describe('server functions serialization adapters', () => { await checkNestedData(page) }) }) + +test.describe('late RawStream serialization', () => { + test('single late stream', async ({ page }) => { + await page.goto('/server-function/late-raw-stream') + await awaitPageLoaded(page) + + // Verify initial state + await expect(page.getByTestId('late-waiting')).toContainText( + 'waiting for trigger...', + ) + + // Trigger the server function + await page.getByTestId('late-trigger').click() + + // Verify immediate data is available + await expect(page.getByTestId('late-immediate')).toContainText( + 'immediate-data', + ) + await expect(page.getByTestId('late-timestamp')).not.toBeEmpty() + + // Verify late stream resolves correctly + await expect(page.getByTestId('late-stream-result')).toContainText( + 'chunk1-chunk2-chunk3', + { timeout: 10000 }, + ) + }) + + test('multiple late streams', async ({ page }) => { + await page.goto('/server-function/late-raw-stream') + await awaitPageLoaded(page) + + // Verify initial state + await expect(page.getByTestId('multi-waiting')).toContainText( + 'waiting for trigger...', + ) + + // Trigger the server function + await page.getByTestId('multi-trigger').click() + + // Verify timestamp + await expect(page.getByTestId('multi-timestamp')).not.toBeEmpty() + + // Verify both late streams resolve correctly + await expect(page.getByTestId('multi-stream1-result')).toContainText( + 'stream1-a-stream1-b', + { timeout: 10000 }, + ) + await expect(page.getByTestId('multi-stream2-result')).toContainText( + 'stream2-a-stream2-b', + { timeout: 10000 }, + ) + }) + + test('mixed immediate and late streams', async ({ page }) => { + await page.goto('/server-function/late-raw-stream') + await awaitPageLoaded(page) + + // Verify initial state + await expect(page.getByTestId('mixed-waiting')).toContainText( + 'waiting for trigger...', + ) + + // Trigger the server function + await page.getByTestId('mixed-trigger').click() + + // Verify timestamp + await expect(page.getByTestId('mixed-timestamp')).not.toBeEmpty() + + // Verify immediate stream resolves (discovered during initial serialization) + await expect(page.getByTestId('mixed-immediate-result')).toContainText( + 'immediate-a-immediate-b', + { timeout: 10000 }, + ) + + // Verify late stream resolves (discovered after serialization starts) + await expect(page.getByTestId('mixed-late-result')).toContainText( + 'late-a-late-b', + { timeout: 10000 }, + ) + }) +}) diff --git a/e2e/react-start/server-functions-global-middleware/package.json b/e2e/react-start/server-functions-global-middleware/package.json index e60becb3ed..9af23a0df5 100644 --- a/e2e/react-start/server-functions-global-middleware/package.json +++ b/e2e/react-start/server-functions-global-middleware/package.json @@ -15,8 +15,7 @@ "@tanstack/react-router": "workspace:^", "@tanstack/react-start": "workspace:^", "react": "^19.0.0", - "react-dom": "^19.0.0", - "vite": "^8.0.0" + "react-dom": "^19.0.0" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -28,6 +27,7 @@ "@vitejs/plugin-react": "^6.0.1", "srvx": "^0.11.9", "tailwindcss": "^4.2.2", - "typescript": "^6.0.2" + "typescript": "^6.0.2", + "vite": "^8.0.14" } } diff --git a/e2e/react-start/server-functions-global-middleware/src/routeTree.gen.ts b/e2e/react-start/server-functions-global-middleware/src/routeTree.gen.ts index 425fc58a24..6fb74e28a2 100644 --- a/e2e/react-start/server-functions-global-middleware/src/routeTree.gen.ts +++ b/e2e/react-start/server-functions-global-middleware/src/routeTree.gen.ts @@ -12,6 +12,7 @@ import { Route as rootRouteImport } from './routes/__root' import { Route as SimpleRouteImport } from './routes/simple' import { Route as PathnameMiddlewareRouteImport } from './routes/pathname-middleware' import { Route as MultipleServerFunctionsRouteImport } from './routes/multiple-server-functions' +import { Route as ContextCollisionRouteImport } from './routes/context-collision' import { Route as IndexRouteImport } from './routes/index' const SimpleRoute = SimpleRouteImport.update({ @@ -29,6 +30,11 @@ const MultipleServerFunctionsRoute = MultipleServerFunctionsRouteImport.update({ path: '/multiple-server-functions', getParentRoute: () => rootRouteImport, } as any) +const ContextCollisionRoute = ContextCollisionRouteImport.update({ + id: '/context-collision', + path: '/context-collision', + getParentRoute: () => rootRouteImport, +} as any) const IndexRoute = IndexRouteImport.update({ id: '/', path: '/', @@ -37,12 +43,14 @@ const IndexRoute = IndexRouteImport.update({ export interface FileRoutesByFullPath { '/': typeof IndexRoute + '/context-collision': typeof ContextCollisionRoute '/multiple-server-functions': typeof MultipleServerFunctionsRoute '/pathname-middleware': typeof PathnameMiddlewareRoute '/simple': typeof SimpleRoute } export interface FileRoutesByTo { '/': typeof IndexRoute + '/context-collision': typeof ContextCollisionRoute '/multiple-server-functions': typeof MultipleServerFunctionsRoute '/pathname-middleware': typeof PathnameMiddlewareRoute '/simple': typeof SimpleRoute @@ -50,6 +58,7 @@ export interface FileRoutesByTo { export interface FileRoutesById { __root__: typeof rootRouteImport '/': typeof IndexRoute + '/context-collision': typeof ContextCollisionRoute '/multiple-server-functions': typeof MultipleServerFunctionsRoute '/pathname-middleware': typeof PathnameMiddlewareRoute '/simple': typeof SimpleRoute @@ -58,14 +67,21 @@ export interface FileRouteTypes { fileRoutesByFullPath: FileRoutesByFullPath fullPaths: | '/' + | '/context-collision' | '/multiple-server-functions' | '/pathname-middleware' | '/simple' fileRoutesByTo: FileRoutesByTo - to: '/' | '/multiple-server-functions' | '/pathname-middleware' | '/simple' + to: + | '/' + | '/context-collision' + | '/multiple-server-functions' + | '/pathname-middleware' + | '/simple' id: | '__root__' | '/' + | '/context-collision' | '/multiple-server-functions' | '/pathname-middleware' | '/simple' @@ -73,6 +89,7 @@ export interface FileRouteTypes { } export interface RootRouteChildren { IndexRoute: typeof IndexRoute + ContextCollisionRoute: typeof ContextCollisionRoute MultipleServerFunctionsRoute: typeof MultipleServerFunctionsRoute PathnameMiddlewareRoute: typeof PathnameMiddlewareRoute SimpleRoute: typeof SimpleRoute @@ -101,6 +118,13 @@ declare module '@tanstack/react-router' { preLoaderRoute: typeof MultipleServerFunctionsRouteImport parentRoute: typeof rootRouteImport } + '/context-collision': { + id: '/context-collision' + path: '/context-collision' + fullPath: '/context-collision' + preLoaderRoute: typeof ContextCollisionRouteImport + parentRoute: typeof rootRouteImport + } '/': { id: '/' path: '/' @@ -113,6 +137,7 @@ declare module '@tanstack/react-router' { const rootRouteChildren: RootRouteChildren = { IndexRoute: IndexRoute, + ContextCollisionRoute: ContextCollisionRoute, MultipleServerFunctionsRoute: MultipleServerFunctionsRoute, PathnameMiddlewareRoute: PathnameMiddlewareRoute, SimpleRoute: SimpleRoute, diff --git a/e2e/react-start/server-functions-global-middleware/src/routes/context-collision.tsx b/e2e/react-start/server-functions-global-middleware/src/routes/context-collision.tsx new file mode 100644 index 0000000000..e744e15d8a --- /dev/null +++ b/e2e/react-start/server-functions-global-middleware/src/routes/context-collision.tsx @@ -0,0 +1,155 @@ +import { createFileRoute } from '@tanstack/react-router' +import { createMiddleware, createServerFn } from '@tanstack/react-start' +import { useState } from 'react' + +const collisionMiddleware = createMiddleware({ type: 'function' }).client( + async ({ next }) => { + return next({ + sendContext: { + trustedUser: 'client-user', + clientNonce: 'client-nonce', + }, + }) + }, +) + +const getCollisionContext = createServerFn() + .middleware([collisionMiddleware]) + .handler(({ context }) => { + return { + trustedUser: context.trustedUser, + clientNonce: context.clientNonce, + } + }) + +const postCollisionContext = createServerFn({ method: 'POST' }) + .middleware([collisionMiddleware]) + .inputValidator((data: unknown) => { + if (!(data instanceof FormData)) { + throw new Error('Expected FormData') + } + + return { + attempt: String(data.get('attempt') ?? ''), + } + }) + .handler(({ context, data }) => { + return { + trustedUser: context.trustedUser, + clientNonce: context.clientNonce, + attempt: data.attempt, + } + }) + +type CollisionResult = { + trustedUser: string | undefined + clientNonce: string | undefined +} + +export const Route = createFileRoute('/context-collision')({ + loader: async () => { + return { + loaderResult: await getCollisionContext(), + } + }, + component: ContextCollisionComponent, +}) + +function ContextCollisionResult({ + label, + result, + testIdPrefix, +}: { + label: string + result: CollisionResult | null + testIdPrefix: string +}) { + const status = + result && + result.trustedUser === 'server-user' && + result.clientNonce === 'client-nonce' + ? 'PASS' + : 'FAIL' + + return ( +
    +

    {label}

    +
    + trustedUser:{' '} + + {result?.trustedUser ?? 'pending'} + +
    +
    + clientNonce:{' '} + + {result?.clientNonce ?? 'pending'} + +
    +
    {status}
    +
    + ) +} + +function ContextCollisionComponent() { + const { loaderResult } = Route.useLoaderData() + const [getResult, setGetResult] = useState(null) + const [postResult, setPostResult] = useState(null) + + return ( +
    +

    + Client Context Collision Regression +

    + +

    + Trusted request middleware context should win over colliding client + sendContext keys while preserving non-colliding client context. +

    + + + +
    + + + +
    + + + + +
    + ) +} diff --git a/e2e/react-start/server-functions-global-middleware/src/start.ts b/e2e/react-start/server-functions-global-middleware/src/start.ts index 7d22827605..a6b89d7f7d 100644 --- a/e2e/react-start/server-functions-global-middleware/src/start.ts +++ b/e2e/react-start/server-functions-global-middleware/src/start.ts @@ -61,6 +61,16 @@ export const pathnameMiddleware = createMiddleware().server( }, ) +export const trustedUserMiddleware = createMiddleware().server( + async ({ next }) => { + return next({ + context: { + trustedUser: 'server-user', + }, + }) + }, +) + // Global function middleware that should be deduped across server functions export const globalFunctionMiddleware = createMiddleware({ type: 'function', @@ -91,5 +101,9 @@ export const startInstance = createStart(() => ({ functionMiddleware: [globalFunctionMiddleware, globalFunctionMiddleware2], // Request middleware - includes loggingMiddleware (issue #5239 scenario) // AND the same loggingMiddleware is also attached to server functions - requestMiddleware: [loggingMiddleware, pathnameMiddleware], + requestMiddleware: [ + trustedUserMiddleware, + loggingMiddleware, + pathnameMiddleware, + ], })) diff --git a/e2e/react-start/server-functions-global-middleware/tests/global-middleware.spec.ts b/e2e/react-start/server-functions-global-middleware/tests/global-middleware.spec.ts index 211d7f59c7..3b1eac1081 100644 --- a/e2e/react-start/server-functions-global-middleware/tests/global-middleware.spec.ts +++ b/e2e/react-start/server-functions-global-middleware/tests/global-middleware.spec.ts @@ -153,3 +153,36 @@ test.describe('Request middleware pathname (issue #6647)', () => { expect(pathnameText!.startsWith('/_serverFn/')).toBe(true) }) }) + +test.describe('Client sendContext collisions (TSR-003)', () => { + test('trusted server middleware context wins for SSR, GET, and FormData calls', async ({ + page, + }) => { + await page.goto('/context-collision') + await page.waitForLoadState('networkidle') + + await expect(page.getByTestId('loader-status')).toHaveText('PASS') + await expect(page.getByTestId('loader-trusted-user')).toHaveText( + 'server-user', + ) + await expect(page.getByTestId('loader-client-nonce')).toHaveText( + 'client-nonce', + ) + + await page.getByTestId('invoke-get-collision').click() + await expect(page.getByTestId('get-status')).toHaveText('PASS') + await expect(page.getByTestId('get-trusted-user')).toHaveText('server-user') + await expect(page.getByTestId('get-client-nonce')).toHaveText( + 'client-nonce', + ) + + await page.getByTestId('invoke-post-collision').click() + await expect(page.getByTestId('post-status')).toHaveText('PASS') + await expect(page.getByTestId('post-trusted-user')).toHaveText( + 'server-user', + ) + await expect(page.getByTestId('post-client-nonce')).toHaveText( + 'client-nonce', + ) + }) +}) diff --git a/e2e/react-start/server-functions/package.json b/e2e/react-start/server-functions/package.json index 29a83802a5..279883dbb4 100644 --- a/e2e/react-start/server-functions/package.json +++ b/e2e/react-start/server-functions/package.json @@ -4,12 +4,17 @@ "sideEffects": false, "type": "module", "scripts": { - "dev": "vite dev --port 3000", - "dev:e2e": "vite dev", - "build": "vite build && tsc --noEmit", + "dev": "pnpm dev:vite --port 3000", + "dev:e2e": "pnpm dev:vite", + "dev:vite": "vite dev", + "dev:rsbuild": "rsbuild dev", + "build": "pnpm build:vite", + "build:vite": "vite build && tsc --noEmit", + "build:rsbuild": "rsbuild build && tsc --noEmit", "preview": "vite preview", - "start": "pnpx srvx --prod -s ../client dist/server/server.js", - "test:e2e": "rm -rf port*.txt; playwright test --project=chromium" + "start": "node server.js", + "test:e2e": "rm -rf port*.txt && pnpm build && playwright test --project=chromium && pnpm run test:e2e:rsbuild-cache", + "test:e2e:rsbuild-cache": "playwright test -c playwright.rsbuild-cache.config.ts --project=chromium" }, "dependencies": { "@tanstack/react-query": "^5.90.0", @@ -21,12 +26,14 @@ "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", - "tailwind-merge": "^2.6.0", - "vite": "^8.0.0", - "zod": "^3.24.2" + "tailwind-merge": "^3.6.0", + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", + "@rsbuild/core": "^2.0.8", + "@rsbuild/plugin-react": "^2.0.0", + "@tailwindcss/postcss": "^4.2.2", "@tailwindcss/vite": "^4.2.2", "@tanstack/router-e2e-utils": "workspace:^", "@types/js-cookie": "^3.0.6", @@ -37,6 +44,21 @@ "combinate": "^1.1.11", "srvx": "^0.11.9", "tailwindcss": "^4.2.2", - "typescript": "^6.0.2" + "typescript": "^6.0.2", + "vite": "^8.0.14" + }, + "nx": { + "metadata": { + "playwrightModes": [ + { + "toolchain": "vite", + "mode": "ssr" + }, + { + "toolchain": "rsbuild", + "mode": "ssr" + } + ] + } } } diff --git a/e2e/react-start/server-functions/playwright.config.ts b/e2e/react-start/server-functions/playwright.config.ts index 8330e023ee..d88e582e2f 100644 --- a/e2e/react-start/server-functions/playwright.config.ts +++ b/e2e/react-start/server-functions/playwright.config.ts @@ -2,7 +2,10 @@ import { defineConfig, devices } from '@playwright/test' import { getTestServerPort } from '@tanstack/router-e2e-utils' import packageJson from './package.json' with { type: 'json' } -export const PORT = await getTestServerPort(packageJson.name) +const e2ePortKey = process.env.E2E_PORT_KEY ?? packageJson.name +const distDir = process.env.E2E_DIST_DIR ?? 'dist' + +export const PORT = await getTestServerPort(e2ePortKey) const baseURL = `http://localhost:${PORT}` /** @@ -10,6 +13,7 @@ const baseURL = `http://localhost:${PORT}` */ export default defineConfig({ testDir: './tests', + testIgnore: /rsbuild-cache\.spec\.ts/, workers: 1, reporter: [['line']], @@ -20,10 +24,16 @@ export default defineConfig({ }, webServer: { - command: `VITE_SERVER_PORT=${PORT} pnpm build && PORT=${PORT} VITE_SERVER_PORT=${PORT} pnpm start`, + command: `PORT=${PORT} VITE_SERVER_PORT=${PORT} pnpm start`, url: baseURL, reuseExistingServer: !process.env.CI, stdout: 'pipe', + env: { + PORT: String(PORT), + VITE_SERVER_PORT: String(PORT), + E2E_DIST_DIR: distDir, + E2E_PORT_KEY: e2ePortKey, + }, }, projects: [ diff --git a/e2e/react-start/server-functions/playwright.rsbuild-cache.config.ts b/e2e/react-start/server-functions/playwright.rsbuild-cache.config.ts new file mode 100644 index 0000000000..efa7357cab --- /dev/null +++ b/e2e/react-start/server-functions/playwright.rsbuild-cache.config.ts @@ -0,0 +1,15 @@ +import { defineConfig, devices } from '@playwright/test' + +export default defineConfig({ + testDir: './tests', + testMatch: /rsbuild-cache\.spec\.ts/, + timeout: 120_000, + workers: 1, + reporter: [['line']], + projects: [ + { + name: 'chromium', + use: { ...devices['Desktop Chrome'] }, + }, + ], +}) diff --git a/e2e/react-start/server-functions/postcss.config.mjs b/e2e/react-start/server-functions/postcss.config.mjs new file mode 100644 index 0000000000..a7f73a2d1d --- /dev/null +++ b/e2e/react-start/server-functions/postcss.config.mjs @@ -0,0 +1,5 @@ +export default { + plugins: { + '@tailwindcss/postcss': {}, + }, +} diff --git a/e2e/react-start/server-functions/rsbuild.config.ts b/e2e/react-start/server-functions/rsbuild.config.ts new file mode 100644 index 0000000000..e5efd7624b --- /dev/null +++ b/e2e/react-start/server-functions/rsbuild.config.ts @@ -0,0 +1,19 @@ +import { defineConfig } from '@rsbuild/core' +import { pluginReact } from '@rsbuild/plugin-react' +import { tanstackStart } from '@tanstack/react-start/plugin/rsbuild' +import { getStartModeConfig } from './start-mode-config' + +const outDir = process.env.E2E_DIST_DIR ?? 'dist' +const startModeConfig = getStartModeConfig() + +export default defineConfig({ + plugins: [pluginReact(), tanstackStart(startModeConfig)], + output: { + distPath: { + root: outDir, + }, + }, + performance: { + buildCache: process.env.E2E_RSBUILD_BUILD_CACHE !== 'false', + }, +}) diff --git a/e2e/react-start/server-functions/server.js b/e2e/react-start/server-functions/server.js new file mode 100644 index 0000000000..6d53885821 --- /dev/null +++ b/e2e/react-start/server-functions/server.js @@ -0,0 +1,57 @@ +import fs from 'node:fs' +import path from 'node:path' +import { spawn } from 'node:child_process' +import { pathToFileURL } from 'node:url' + +const distDir = process.env.E2E_DIST_DIR || 'dist' + +function resolveDistClientDir() { + return path.resolve(distDir, 'client') +} + +function resolveDistServerEntryPath() { + const serverJsPath = path.resolve(distDir, 'server', 'server.js') + if (fs.existsSync(serverJsPath)) { + return serverJsPath + } + + const indexJsPath = path.resolve(distDir, 'server', 'index.js') + if (fs.existsSync(indexJsPath)) { + return indexJsPath + } + + return serverJsPath +} + +export function resolveStartCommand() { + const distClientDir = resolveDistClientDir() + const distServerEntryPath = resolveDistServerEntryPath() + return `srvx --prod -s ${JSON.stringify(distClientDir)} ${JSON.stringify(distServerEntryPath)}` +} + +export function start() { + const child = spawn( + 'srvx', + ['--prod', '-s', resolveDistClientDir(), resolveDistServerEntryPath()], + { + stdio: 'inherit', + shell: process.platform === 'win32', + }, + ) + + child.on('exit', (code, signal) => { + if (signal) { + process.kill(process.pid, signal) + return + } + + process.exit(code ?? 0) + }) +} + +if ( + process.argv[1] && + import.meta.url === pathToFileURL(process.argv[1]).href +) { + start() +} diff --git a/e2e/react-start/server-functions/src/routes/__root.tsx b/e2e/react-start/server-functions/src/routes/__root.tsx index 5dec927337..de29a1780f 100644 --- a/e2e/react-start/server-functions/src/routes/__root.tsx +++ b/e2e/react-start/server-functions/src/routes/__root.tsx @@ -10,7 +10,7 @@ import { import { DefaultCatchBoundary } from '~/components/DefaultCatchBoundary' import { NotFound } from '~/components/NotFound' -import appCss from '~/styles/app.css?url' +import '~/styles/app.css' export const Route = createRootRouteWithContext<{ foo: { bar: string } }>()({ head: () => ({ @@ -23,7 +23,6 @@ export const Route = createRootRouteWithContext<{ foo: { bar: string } }>()({ content: 'width=device-width, initial-scale=1', }, ], - links: [{ rel: 'stylesheet', href: appCss }], }), errorComponent: (props) => { return ( diff --git a/e2e/react-start/server-functions/src/routes/consistent.tsx b/e2e/react-start/server-functions/src/routes/consistent.tsx index a090671489..febc35a694 100644 --- a/e2e/react-start/server-functions/src/routes/consistent.tsx +++ b/e2e/react-start/server-functions/src/routes/consistent.tsx @@ -1,4 +1,4 @@ -import { createFileRoute } from '@tanstack/react-router' +import { ClientOnly, createFileRoute } from '@tanstack/react-router' import * as React from 'react' import { createServerFn } from '@tanstack/react-start' @@ -116,6 +116,9 @@ function ConsistentServerFnCalls() { > Test Consistent server function responses + + ) } diff --git a/e2e/react-start/server-functions/src/routes/cookies/index.tsx b/e2e/react-start/server-functions/src/routes/cookies/index.tsx index 005be0d9fa..70bea1ede8 100644 --- a/e2e/react-start/server-functions/src/routes/cookies/index.tsx +++ b/e2e/react-start/server-functions/src/routes/cookies/index.tsx @@ -2,7 +2,8 @@ import { Link, createFileRoute } from '@tanstack/react-router' import { z } from 'zod' const cookieSchema = z - .object({ value: z.string() }) + .object({ value: z.string().default(() => `CLIENT-${Date.now()}`) }) + .prefault({}) .catch(() => ({ value: `CLIENT-${Date.now()}` })) export const Route = createFileRoute('/cookies/')({ validateSearch: cookieSchema, diff --git a/e2e/react-start/server-functions/src/start.ts b/e2e/react-start/server-functions/src/start.ts index 1cd840ca96..8c3a96dd71 100644 --- a/e2e/react-start/server-functions/src/start.ts +++ b/e2e/react-start/server-functions/src/start.ts @@ -1,4 +1,4 @@ -import { createStart } from '@tanstack/react-start' +import { createCsrfMiddleware, createStart } from '@tanstack/react-start' import type { CustomFetch } from '@tanstack/react-start' /** @@ -16,6 +16,11 @@ const globalServerFnFetch: CustomFetch = (input, init) => { } export const startInstance = createStart(() => ({ + requestMiddleware: [ + createCsrfMiddleware({ + filter: (ctx) => ctx.handlerType === 'serverFn', + }), + ], serverFns: { fetch: globalServerFnFetch, }, diff --git a/e2e/react-start/server-functions/start-mode-config.ts b/e2e/react-start/server-functions/start-mode-config.ts new file mode 100644 index 0000000000..ba75b59693 --- /dev/null +++ b/e2e/react-start/server-functions/start-mode-config.ts @@ -0,0 +1,21 @@ +const FUNCTION_IDS: Record> = { + 'src/routes/submit-post-formdata.tsx': { + greetUser_createServerFn_handler: 'submit-post-formdata-greetUser', + }, + 'src/routes/formdata-redirect/index.tsx': { + greetUser_createServerFn_handler: 'formdata-redirect-greetUser', + }, +} + +export function getStartModeConfig() { + return { + serverFns: { + generateFunctionId: (opts: { + filename: string + functionName: string + }) => { + return FUNCTION_IDS[opts.filename]?.[opts.functionName] + }, + }, + } +} diff --git a/e2e/react-start/server-functions/tests/rsbuild-cache.spec.ts b/e2e/react-start/server-functions/tests/rsbuild-cache.spec.ts new file mode 100644 index 0000000000..bbc7cecba7 --- /dev/null +++ b/e2e/react-start/server-functions/tests/rsbuild-cache.spec.ts @@ -0,0 +1,461 @@ +import { spawn } from 'node:child_process' +import { existsSync, readFileSync, rmSync, writeFileSync } from 'node:fs' +import { createServer } from 'node:net' +import { resolve } from 'node:path' +import { expect, test } from '@playwright/test' +import type { ChildProcess } from 'node:child_process' +import type { Page, Request } from '@playwright/test' + +const appDir = resolve(import.meta.dirname, '..') +const cacheDir = resolve(appDir, 'node_modules/.cache/rspack') +const consistentRoutePath = resolve(appDir, 'src/routes/consistent.tsx') +const noServerFunctionsConsistentRouteSource = `import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/consistent')({ + component: ConsistentServerFnCalls, +}) + +function ConsistentServerFnCalls() { + return ( +
    + Server functions removed by watch test +
    + ) +} +` + +interface ServerFnRequest { + method: string + url: string +} + +interface DevServer { + child: ChildProcess + logs: Array + port: number +} + +let navigationId = 0 + +async function delay(ms: number): Promise { + await new Promise((resolve) => setTimeout(resolve, ms)) +} + +async function getAvailablePort(): Promise { + return await new Promise((resolvePromise, reject) => { + const server = createServer() + + server.unref() + server.once('error', reject) + server.listen(0, '127.0.0.1', () => { + const address = server.address() + + if (!address || typeof address === 'string') { + server.close(() => reject(new Error('Could not allocate a port'))) + return + } + + const { port } = address + server.close((error) => { + if (error) { + reject(error) + return + } + + resolvePromise(port) + }) + }) + }) +} + +async function canListen(port: number): Promise { + return await new Promise((resolvePromise) => { + const server = createServer() + + const finish = (value: boolean) => { + server.removeAllListeners() + resolvePromise(value) + } + + server.unref() + server.once('error', () => finish(false)) + server.listen(port, '127.0.0.1', () => { + server.close((error) => finish(!error)) + }) + }) +} + +async function waitForPortAvailable(port: number): Promise { + const start = Date.now() + + while (Date.now() - start < 10_000) { + if (await canListen(port)) { + return + } + + await delay(100) + } + + throw new Error(`Timed out waiting for port ${port} to be released`) +} + +function startRsbuildDevServer( + port: number, + buildCacheEnabled = true, +): DevServer { + const logs: Array = [] + const child = spawn( + 'pnpm', + ['exec', 'rsbuild', 'dev', '--host', '127.0.0.1', '--port', String(port)], + { + cwd: appDir, + detached: true, + env: { + ...process.env, + PORT: String(port), + VITE_SERVER_PORT: String(port), + VITE_NODE_ENV: 'test', + E2E_RSBUILD_BUILD_CACHE: buildCacheEnabled ? 'true' : 'false', + }, + stdio: ['ignore', 'pipe', 'pipe'], + }, + ) + + child.stdout?.on('data', (chunk: Buffer) => logs.push(chunk.toString())) + child.stderr?.on('data', (chunk: Buffer) => logs.push(chunk.toString())) + + return { child, logs, port } +} + +function killDevServer(devServer: DevServer, signal: NodeJS.Signals) { + const pid = devServer.child.pid + + try { + if (pid) { + process.kill(-pid, signal) + return + } + } catch { + // Fall back to killing the direct child below. + } + + devServer.child.kill(signal) +} + +async function waitForHttpOk(devServer: DevServer, url: string): Promise { + const start = Date.now() + + while (Date.now() - start < 60_000) { + if (devServer.child.exitCode !== null) { + throw new Error( + `Rsbuild dev server exited before ${url} was ready.\n${devServer.logs.join('')}`, + ) + } + + try { + const response = await fetch(url, { + signal: AbortSignal.timeout(1000), + }) + + if (response.status >= 200 && response.status < 400) { + return + } + } catch { + // Wait until the dev server starts accepting requests. + } + + await delay(250) + } + + throw new Error( + `Timed out waiting for Rsbuild dev server at ${url}.\n${devServer.logs.join('')}`, + ) +} + +async function stopDevServer(devServer: DevServer): Promise { + if (devServer.child.exitCode !== null || devServer.child.killed) { + return + } + + await new Promise((resolve) => { + let settled = false + let killTimer: ReturnType | undefined + let doneTimer: ReturnType | undefined + + const done = () => { + if (settled) { + return + } + settled = true + if (killTimer) { + clearTimeout(killTimer) + } + if (doneTimer) { + clearTimeout(doneTimer) + } + resolve() + } + + devServer.child.once('exit', done) + devServer.child.once('error', done) + + try { + killDevServer(devServer, 'SIGTERM') + } catch { + done() + return + } + + killTimer = setTimeout(() => { + try { + killDevServer(devServer, 'SIGKILL') + } catch { + // The process may have already exited. + } + + doneTimer = setTimeout(done, 500) + }, 3000) + }) + + await waitForPortAvailable(devServer.port) +} + +async function waitForRetry( + devServer: DevServer, + description: string, + action: () => Promise, +): Promise { + const start = Date.now() + let lastError: unknown + + while (Date.now() - start < 30_000) { + if (devServer.child.exitCode !== null) { + throw new Error( + `Rsbuild dev server exited while waiting for ${description}.\n${devServer.logs.join('')}`, + ) + } + + try { + return await action() + } catch (error) { + lastError = error + await delay(500) + } + } + + throw new Error( + `Timed out waiting for ${description}.\n${lastError instanceof Error ? lastError.stack || lastError.message : String(lastError)}\n\nRsbuild logs:\n${devServer.logs.join('')}`, + ) +} + +async function captureServerFnRequests( + page: Page, + action: () => Promise, +): Promise> { + const requests: Array = [] + const listener = (request: Request) => { + if (request.url().includes('/_serverFn/')) { + requests.push({ + method: request.method(), + url: request.url(), + }) + } + } + + page.on('request', listener) + try { + await action() + } finally { + page.off('request', listener) + } + + return requests +} + +async function exerciseServerFunctions( + page: Page, + baseURL: string, + expectedUsername = 'TEST', +) { + const response = await page.goto( + `${baseURL}/consistent?testRun=${navigationId++}`, + { + waitUntil: 'networkidle', + }, + ) + expect(response?.ok()).toBe(true) + + const expectedLocator = page.getByTestId( + 'expected-consistent-server-fns-result', + ) + await expect(expectedLocator).toContainText( + JSON.stringify({ payload: { username: expectedUsername } }), + ) + const expected = (await expectedLocator.textContent()) || '' + + await expect(page.getByTestId('consistent-client-hydrated')).toBeAttached() + + await page.getByTestId('test-consistent-server-fn-calls-btn').click() + await page.waitForLoadState('networkidle') + + await expect(page.getByTestId('cons_serverGetFn1-response')).toContainText( + expected, + ) + await expect(page.getByTestId('cons_getFn1-response')).toContainText(expected) + await expect(page.getByTestId('cons_serverPostFn1-response')).toContainText( + expected, + ) + await expect(page.getByTestId('cons_postFn1-response')).toContainText( + expected, + ) +} + +async function exerciseServerFunctionsWithLogs( + page: Page, + baseURL: string, + devServer: DevServer, + expectedUsername = 'TEST', +) { + try { + await exerciseServerFunctions(page, baseURL, expectedUsername) + } catch (error) { + throw new Error( + `${error instanceof Error ? error.stack || error.message : String(error)}\n\nRsbuild logs:\n${devServer.logs.join('')}`, + ) + } +} + +async function waitForStaticConsistentRoute( + page: Page, + baseURL: string, + devServer: DevServer, +) { + await waitForRetry(devServer, 'static consistent route update', async () => { + const response = await page.goto( + `${baseURL}/consistent?watch=${Date.now()}`, + { + waitUntil: 'networkidle', + }, + ) + expect(response?.ok()).toBe(true) + await expect(page.getByTestId('watch-no-server-functions')).toContainText( + 'Server functions removed by watch test', + { timeout: 1000 }, + ) + }) +} + +test('rsbuild build cache warm restart keeps server function registry', async ({ + page, +}) => { + test.setTimeout(120_000) + + rmSync(cacheDir, { recursive: true, force: true }) + + const port = await getAvailablePort() + const baseURL = `http://127.0.0.1:${port}` + let devServer = startRsbuildDevServer(port) + + try { + await waitForHttpOk(devServer, baseURL) + await exerciseServerFunctionsWithLogs(page, baseURL, devServer) + } finally { + await stopDevServer(devServer) + } + + expect(existsSync(cacheDir)).toBe(true) + + devServer = startRsbuildDevServer(port) + + try { + await waitForHttpOk(devServer, baseURL) + await exerciseServerFunctionsWithLogs(page, baseURL, devServer) + + expect(devServer.logs.join('')).not.toContain( + 'Server function info not found', + ) + } finally { + await stopDevServer(devServer) + } +}) + +test('rsbuild without build cache keeps server function registry', async ({ + page, +}) => { + test.setTimeout(120_000) + + rmSync(cacheDir, { recursive: true, force: true }) + + const port = await getAvailablePort() + const baseURL = `http://127.0.0.1:${port}` + const devServer = startRsbuildDevServer(port, false) + + try { + await waitForHttpOk(devServer, baseURL) + await exerciseServerFunctionsWithLogs(page, baseURL, devServer) + + expect(devServer.logs.join('')).not.toContain( + 'Server function info not found', + ) + } finally { + await stopDevServer(devServer) + } +}) + +test('rsbuild watch updates and removes server function metadata', async ({ + page, +}) => { + test.setTimeout(120_000) + + const originalSource = readFileSync(consistentRoutePath, 'utf8') + const updatedSource = originalSource.replaceAll("'TEST'", "'WATCH'") + rmSync(cacheDir, { recursive: true, force: true }) + + const port = await getAvailablePort() + const baseURL = `http://127.0.0.1:${port}` + const devServer = startRsbuildDevServer(port) + + try { + await waitForHttpOk(devServer, baseURL) + await exerciseServerFunctionsWithLogs(page, baseURL, devServer) + + writeFileSync(consistentRoutePath, updatedSource) + const serverFnRequests = await waitForRetry( + devServer, + 'updated server function metadata', + async () => { + return await captureServerFnRequests(page, async () => { + await exerciseServerFunctionsWithLogs( + page, + baseURL, + devServer, + 'WATCH', + ) + }) + }, + ) + const staleGetRequest = serverFnRequests.find( + (request) => request.method === 'GET', + ) + expect(staleGetRequest).toBeDefined() + + writeFileSync(consistentRoutePath, noServerFunctionsConsistentRouteSource) + await waitForStaticConsistentRoute(page, baseURL, devServer) + + const staleResult = await page.evaluate(async (url) => { + const response = await fetch(url) + return { + ok: response.ok, + status: response.status, + text: await response.text(), + } + }, staleGetRequest!.url) + + expect(staleResult.ok).toBe(false) + expect(staleResult.status).toBeGreaterThanOrEqual(400) + expect(staleResult.text).not.toContain('WATCH') + } finally { + writeFileSync(consistentRoutePath, originalSource) + await stopDevServer(devServer) + } +}) diff --git a/e2e/react-start/server-functions/tests/server-functions.spec.ts b/e2e/react-start/server-functions/tests/server-functions.spec.ts index 5eaf8e66cc..5bb458d61c 100644 --- a/e2e/react-start/server-functions/tests/server-functions.spec.ts +++ b/e2e/react-start/server-functions/tests/server-functions.spec.ts @@ -4,7 +4,8 @@ import { getTestServerPort, test } from '@tanstack/router-e2e-utils' import packageJson from '../package.json' with { type: 'json' } import type { Page } from '@playwright/test' -const PORT = await getTestServerPort(packageJson.name) +const e2ePortKey = process.env.E2E_PORT_KEY ?? packageJson.name +const PORT = await getTestServerPort(e2ePortKey) test('Server function URLs correctly include explicit ids', async ({ page, @@ -56,6 +57,8 @@ test('Consistent server function returns both on client and server for GET and P .textContent()) || '' expect(expected).not.toBe('') + await expect(page.getByTestId('consistent-client-hydrated')).toBeAttached() + await page.getByTestId('test-consistent-server-fn-calls-btn').click() await page.waitForLoadState('networkidle') @@ -287,6 +290,32 @@ test('Direct POST submitting FormData to a Server function returns the correct m expect(result).toBe(expected) }) +test('CSRF middleware rejects cross-site Server function requests', async ({ + page, + request, +}) => { + await page.goto('/submit-post-formdata') + await page.waitForLoadState('networkidle') + + const actionUrl = await page + .getByTestId('submit-post-formdata-form') + .getAttribute('action') + + expect(actionUrl).toBeTruthy() + + const response = await request.post(actionUrl!, { + headers: { + 'Sec-Fetch-Site': 'cross-site', + }, + multipart: { + name: 'Sean', + }, + }) + + expect(response.status()).toBe(403) + await expect(response.text()).resolves.toBe('Forbidden') +}) + test("server function's dead code is preserved if already there", async ({ page, }) => { @@ -743,8 +772,8 @@ test('redirect via server function with middleware does not cause serialization }) test.describe('unhandled exception in middleware (issue #5266)', () => { - // Whitelist the expected 500 error since this test verifies error handling - test.use({ whitelistErrors: ['500'] }) + // Whitelist expected browser console errors since this test verifies error handling. + test.use({ whitelistErrors: ['500', 'Unhandled middleware exception'] }) test('does not crash server and shows error component', async ({ page }) => { // This test verifies that when a middleware throws an unhandled exception, diff --git a/e2e/react-start/server-functions/vite.config.ts b/e2e/react-start/server-functions/vite.config.ts index 025df5ea60..3372eb1ca6 100644 --- a/e2e/react-start/server-functions/vite.config.ts +++ b/e2e/react-start/server-functions/vite.config.ts @@ -2,27 +2,15 @@ import { defineConfig } from 'vite' import { tanstackStart } from '@tanstack/react-start/plugin/vite' import viteReact from '@vitejs/plugin-react' import tailwindcss from '@tailwindcss/vite' +import { getStartModeConfig } from './start-mode-config' -const FUNCTION_IDS: Record> = { - 'src/routes/submit-post-formdata.tsx': { - greetUser_createServerFn_handler: 'submit-post-formdata-greetUser', - }, - 'src/routes/formdata-redirect/index.tsx': { - greetUser_createServerFn_handler: 'formdata-redirect-greetUser', - }, -} +const outDir = process.env.E2E_DIST_DIR ?? 'dist' +const startModeConfig = getStartModeConfig() export default defineConfig({ resolve: { tsconfigPaths: true }, - plugins: [ - tailwindcss(), - tanstackStart({ - serverFns: { - generateFunctionId: (opts) => { - return FUNCTION_IDS[opts.filename]?.[opts.functionName] - }, - }, - }), - viteReact(), - ], + build: { + outDir, + }, + plugins: [tailwindcss(), tanstackStart(startModeConfig), viteReact()], }) diff --git a/e2e/react-start/server-routes-global-middleware/package.json b/e2e/react-start/server-routes-global-middleware/package.json index 0647fa5cbc..0757885b5c 100644 --- a/e2e/react-start/server-routes-global-middleware/package.json +++ b/e2e/react-start/server-routes-global-middleware/package.json @@ -15,8 +15,7 @@ "@tanstack/react-router": "workspace:^", "@tanstack/react-start": "workspace:^", "react": "^19.0.0", - "react-dom": "^19.0.0", - "vite": "^8.0.0" + "react-dom": "^19.0.0" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -28,6 +27,7 @@ "@vitejs/plugin-react": "^6.0.1", "srvx": "^0.11.9", "tailwindcss": "^4.2.2", - "typescript": "^6.0.2" + "typescript": "^6.0.2", + "vite": "^8.0.14" } } diff --git a/e2e/react-start/server-routes/package.json b/e2e/react-start/server-routes/package.json index 5473bd3d21..41d6c6743b 100644 --- a/e2e/react-start/server-routes/package.json +++ b/e2e/react-start/server-routes/package.json @@ -21,9 +21,8 @@ "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", - "tailwind-merge": "^2.6.0", - "vite": "^8.0.0", - "zod": "^3.24.2" + "tailwind-merge": "^3.6.0", + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -37,6 +36,7 @@ "combinate": "^1.1.11", "srvx": "^0.11.9", "tailwindcss": "^4.2.2", - "typescript": "^6.0.2" + "typescript": "^6.0.2", + "vite": "^8.0.14" } } diff --git a/e2e/react-start/server-routes/src/routeTree.gen.ts b/e2e/react-start/server-routes/src/routeTree.gen.ts index 8caf1ab917..2b8bac6e09 100644 --- a/e2e/react-start/server-routes/src/routeTree.gen.ts +++ b/e2e/react-start/server-routes/src/routeTree.gen.ts @@ -16,6 +16,9 @@ import { Route as MethodsIndexRouteImport } from './routes/methods/index' import { Route as MethodsOnlyAnyRouteImport } from './routes/methods/only-any' import { Route as ApiOnlyAnyRouteImport } from './routes/api/only-any' import { Route as ApiMiddlewareContextRouteImport } from './routes/api/middleware-context' +import { Route as ApiHeadRedirectFallbackRouteImport } from './routes/api/head-redirect-fallback' +import { Route as ApiHeadFallbackRouteImport } from './routes/api/head-fallback' +import { Route as ApiGetAndAnyRouteImport } from './routes/api/get-and-any' import { Route as ApiParamsFooRouteRouteImport } from './routes/api/params/$foo/route' import { Route as ApiParamsFooBarRouteImport } from './routes/api/params/$foo/$bar' @@ -54,6 +57,21 @@ const ApiMiddlewareContextRoute = ApiMiddlewareContextRouteImport.update({ path: '/api/middleware-context', getParentRoute: () => rootRouteImport, } as any) +const ApiHeadRedirectFallbackRoute = ApiHeadRedirectFallbackRouteImport.update({ + id: '/api/head-redirect-fallback', + path: '/api/head-redirect-fallback', + getParentRoute: () => rootRouteImport, +} as any) +const ApiHeadFallbackRoute = ApiHeadFallbackRouteImport.update({ + id: '/api/head-fallback', + path: '/api/head-fallback', + getParentRoute: () => rootRouteImport, +} as any) +const ApiGetAndAnyRoute = ApiGetAndAnyRouteImport.update({ + id: '/api/get-and-any', + path: '/api/get-and-any', + getParentRoute: () => rootRouteImport, +} as any) const ApiParamsFooRouteRoute = ApiParamsFooRouteRouteImport.update({ id: '/api/params/$foo', path: '/api/params/$foo', @@ -69,6 +87,9 @@ export interface FileRoutesByFullPath { '/': typeof IndexRoute '/methods': typeof MethodsRouteRouteWithChildren '/merge-middleware-context': typeof MergeMiddlewareContextRoute + '/api/get-and-any': typeof ApiGetAndAnyRoute + '/api/head-fallback': typeof ApiHeadFallbackRoute + '/api/head-redirect-fallback': typeof ApiHeadRedirectFallbackRoute '/api/middleware-context': typeof ApiMiddlewareContextRoute '/api/only-any': typeof ApiOnlyAnyRoute '/methods/only-any': typeof MethodsOnlyAnyRoute @@ -79,6 +100,9 @@ export interface FileRoutesByFullPath { export interface FileRoutesByTo { '/': typeof IndexRoute '/merge-middleware-context': typeof MergeMiddlewareContextRoute + '/api/get-and-any': typeof ApiGetAndAnyRoute + '/api/head-fallback': typeof ApiHeadFallbackRoute + '/api/head-redirect-fallback': typeof ApiHeadRedirectFallbackRoute '/api/middleware-context': typeof ApiMiddlewareContextRoute '/api/only-any': typeof ApiOnlyAnyRoute '/methods/only-any': typeof MethodsOnlyAnyRoute @@ -91,6 +115,9 @@ export interface FileRoutesById { '/': typeof IndexRoute '/methods': typeof MethodsRouteRouteWithChildren '/merge-middleware-context': typeof MergeMiddlewareContextRoute + '/api/get-and-any': typeof ApiGetAndAnyRoute + '/api/head-fallback': typeof ApiHeadFallbackRoute + '/api/head-redirect-fallback': typeof ApiHeadRedirectFallbackRoute '/api/middleware-context': typeof ApiMiddlewareContextRoute '/api/only-any': typeof ApiOnlyAnyRoute '/methods/only-any': typeof MethodsOnlyAnyRoute @@ -104,6 +131,9 @@ export interface FileRouteTypes { | '/' | '/methods' | '/merge-middleware-context' + | '/api/get-and-any' + | '/api/head-fallback' + | '/api/head-redirect-fallback' | '/api/middleware-context' | '/api/only-any' | '/methods/only-any' @@ -114,6 +144,9 @@ export interface FileRouteTypes { to: | '/' | '/merge-middleware-context' + | '/api/get-and-any' + | '/api/head-fallback' + | '/api/head-redirect-fallback' | '/api/middleware-context' | '/api/only-any' | '/methods/only-any' @@ -125,6 +158,9 @@ export interface FileRouteTypes { | '/' | '/methods' | '/merge-middleware-context' + | '/api/get-and-any' + | '/api/head-fallback' + | '/api/head-redirect-fallback' | '/api/middleware-context' | '/api/only-any' | '/methods/only-any' @@ -137,6 +173,9 @@ export interface RootRouteChildren { IndexRoute: typeof IndexRoute MethodsRouteRoute: typeof MethodsRouteRouteWithChildren MergeMiddlewareContextRoute: typeof MergeMiddlewareContextRoute + ApiGetAndAnyRoute: typeof ApiGetAndAnyRoute + ApiHeadFallbackRoute: typeof ApiHeadFallbackRoute + ApiHeadRedirectFallbackRoute: typeof ApiHeadRedirectFallbackRoute ApiMiddlewareContextRoute: typeof ApiMiddlewareContextRoute ApiOnlyAnyRoute: typeof ApiOnlyAnyRoute ApiParamsFooRouteRoute: typeof ApiParamsFooRouteRouteWithChildren @@ -193,6 +232,27 @@ declare module '@tanstack/react-router' { preLoaderRoute: typeof ApiMiddlewareContextRouteImport parentRoute: typeof rootRouteImport } + '/api/head-redirect-fallback': { + id: '/api/head-redirect-fallback' + path: '/api/head-redirect-fallback' + fullPath: '/api/head-redirect-fallback' + preLoaderRoute: typeof ApiHeadRedirectFallbackRouteImport + parentRoute: typeof rootRouteImport + } + '/api/head-fallback': { + id: '/api/head-fallback' + path: '/api/head-fallback' + fullPath: '/api/head-fallback' + preLoaderRoute: typeof ApiHeadFallbackRouteImport + parentRoute: typeof rootRouteImport + } + '/api/get-and-any': { + id: '/api/get-and-any' + path: '/api/get-and-any' + fullPath: '/api/get-and-any' + preLoaderRoute: typeof ApiGetAndAnyRouteImport + parentRoute: typeof rootRouteImport + } '/api/params/$foo': { id: '/api/params/$foo' path: '/api/params/$foo' @@ -239,6 +299,9 @@ const rootRouteChildren: RootRouteChildren = { IndexRoute: IndexRoute, MethodsRouteRoute: MethodsRouteRouteWithChildren, MergeMiddlewareContextRoute: MergeMiddlewareContextRoute, + ApiGetAndAnyRoute: ApiGetAndAnyRoute, + ApiHeadFallbackRoute: ApiHeadFallbackRoute, + ApiHeadRedirectFallbackRoute: ApiHeadRedirectFallbackRoute, ApiMiddlewareContextRoute: ApiMiddlewareContextRoute, ApiOnlyAnyRoute: ApiOnlyAnyRoute, ApiParamsFooRouteRoute: ApiParamsFooRouteRouteWithChildren, diff --git a/e2e/react-start/server-routes/src/routes/api/get-and-any.ts b/e2e/react-start/server-routes/src/routes/api/get-and-any.ts new file mode 100644 index 0000000000..4e3ed08fbb --- /dev/null +++ b/e2e/react-start/server-routes/src/routes/api/get-and-any.ts @@ -0,0 +1,16 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/api/get-and-any')({ + server: { + handlers: { + GET: () => + new Response(null, { + headers: { 'x-handler': 'GET' }, + }), + ANY: ({ request }) => + new Response(null, { + headers: { 'x-handler': 'ANY', 'x-method': request.method }, + }), + }, + }, +}) diff --git a/e2e/react-start/server-routes/src/routes/api/head-fallback.ts b/e2e/react-start/server-routes/src/routes/api/head-fallback.ts new file mode 100644 index 0000000000..302ba81efd --- /dev/null +++ b/e2e/react-start/server-routes/src/routes/api/head-fallback.ts @@ -0,0 +1,14 @@ +import { createFileRoute } from '@tanstack/react-router' + +// A server-only route with only a GET handler. +// Used to test that HEAD requests fall back to the GET handler per RFC 9110. +export const Route = createFileRoute('/api/head-fallback')({ + server: { + handlers: { + GET: () => + new Response('body', { + headers: { 'content-type': 'application/xml; charset=utf-8' }, + }), + }, + }, +}) diff --git a/e2e/react-start/server-routes/src/routes/api/head-redirect-fallback.ts b/e2e/react-start/server-routes/src/routes/api/head-redirect-fallback.ts new file mode 100644 index 0000000000..62e3998c6d --- /dev/null +++ b/e2e/react-start/server-routes/src/routes/api/head-redirect-fallback.ts @@ -0,0 +1,9 @@ +import { createFileRoute, redirect } from '@tanstack/react-router' + +export const Route = createFileRoute('/api/head-redirect-fallback')({ + server: { + handlers: { + GET: () => redirect({ to: '/api/head-fallback', statusCode: 307 }), + }, + }, +}) diff --git a/e2e/react-start/server-routes/tests/server-routes.spec.ts b/e2e/react-start/server-routes/tests/server-routes.spec.ts index f3a80a5a46..97249fd733 100644 --- a/e2e/react-start/server-routes/tests/server-routes.spec.ts +++ b/e2e/react-start/server-routes/tests/server-routes.spec.ts @@ -17,6 +17,79 @@ test('merge-middleware-context', async ({ page }) => { expect(contextResult).toContain('test') }) +test.describe('HEAD fallback', () => { + test('strips body and preserves headers when falling back to GET', async ({ + page, + }) => { + await page.goto('/') + const result = await page.evaluate(async () => { + const res = await fetch('/api/head-fallback', { method: 'HEAD' }) + return { + status: res.status, + contentType: res.headers.get('content-type'), + body: await res.text(), + } + }) + expect(result.status).toBe(200) + expect(result.contentType).toBe('application/xml; charset=utf-8') + expect(result.body).toBe('') + }) + + test('strips body and preserves headers when falling back to ANY', async ({ + page, + }) => { + await page.goto('/') + const result = await page.evaluate(async () => { + const res = await fetch('/api/only-any', { method: 'HEAD' }) + return { + status: res.status, + xHandler: res.headers.get('x-handler'), + xMethod: res.headers.get('x-method'), + body: await res.text(), + } + }) + expect(result.status).toBe(200) + expect(result.xHandler).toBe('ANY') + expect(result.xMethod).toBe('HEAD') + expect(result.body).toBe('') + }) + + test('prefers GET over ANY for HEAD requests', async ({ page }) => { + await page.goto('/') + const result = await page.evaluate(async () => { + const res = await fetch('/api/get-and-any', { method: 'HEAD' }) + return { + status: res.status, + xHandler: res.headers.get('x-handler'), + body: await res.text(), + } + }) + expect(result.status).toBe(200) + expect(result.xHandler).toBe('GET') + expect(result.body).toBe('') + }) + + test('preserves Location header when GET handler returns a redirect', async ({ + page, + }) => { + await page.goto('/') + // HEAD /api/head-redirect-fallback → server returns 307 Location:/api/head-fallback + // Browser follows the redirect: HEAD /api/head-fallback → 200 with correct headers + // If the Location header were lost, the browser could not follow and would see a 307. + const result = await page.evaluate(async () => { + const res = await fetch('/api/head-redirect-fallback', { method: 'HEAD' }) + return { + status: res.status, + contentType: res.headers.get('content-type'), + body: await res.text(), + } + }) + expect(result.status).toBe(200) + expect(result.contentType).toBe('application/xml; charset=utf-8') + expect(result.body).toBe('') + }) +}) + test.describe('methods', () => { test('only ANY', async ({ page }) => { await page.goto('/methods/only-any') diff --git a/e2e/react-start/spa-mode/package.json b/e2e/react-start/spa-mode/package.json index ec9537de3d..0442b5d7f3 100644 --- a/e2e/react-start/spa-mode/package.json +++ b/e2e/react-start/spa-mode/package.json @@ -26,6 +26,6 @@ "@types/react-dom": "^19.0.3", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/e2e/react-start/split-base-and-basepath/package.json b/e2e/react-start/split-base-and-basepath/package.json index bb25c4b92e..5f4e7a14c1 100644 --- a/e2e/react-start/split-base-and-basepath/package.json +++ b/e2e/react-start/split-base-and-basepath/package.json @@ -15,7 +15,7 @@ "dependencies": { "@tanstack/react-router": "workspace:^", "@tanstack/react-start": "workspace:^", - "express": "^5.1.0", + "express": "^5.2.1", "react": "^19.0.0", "react-dom": "^19.0.0" }, @@ -28,6 +28,6 @@ "@vitejs/plugin-react": "^6.0.1", "srvx": "^0.11.9", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/e2e/react-start/split-base-and-basepath/prod-server.js b/e2e/react-start/split-base-and-basepath/prod-server.js index 8ec0deca52..72114a1d40 100644 --- a/e2e/react-start/split-base-and-basepath/prod-server.js +++ b/e2e/react-start/split-base-and-basepath/prod-server.js @@ -20,6 +20,7 @@ app.use(async (req, res, next) => { } }) -app.listen(PORT, () => { +app.listen(PORT, (error) => { + if (error) throw error console.log(`Server is running on http://localhost:${PORT}`) }) diff --git a/e2e/react-start/start-manifest/package.json b/e2e/react-start/start-manifest/package.json new file mode 100644 index 0000000000..7c932cb5d5 --- /dev/null +++ b/e2e/react-start/start-manifest/package.json @@ -0,0 +1,35 @@ +{ + "name": "tanstack-react-start-e2e-start-manifest", + "private": true, + "sideEffects": false, + "type": "module", + "scripts": { + "build": "vite build && tsc --noEmit", + "start": "node .output/server/index.mjs", + "test:e2e": "playwright test --project=chromium" + }, + "dependencies": { + "@tanstack/react-router": "workspace:^", + "@tanstack/react-start": "workspace:^", + "react": "^19.0.0", + "react-dom": "^19.0.0" + }, + "devDependencies": { + "@playwright/test": "^1.50.1", + "@tanstack/router-e2e-utils": "workspace:^", + "@types/node": "^22.10.2", + "@types/react": "^19.0.8", + "@types/react-dom": "^19.0.3", + "@vitejs/plugin-react": "^6.0.1", + "nitro": "^3.0.260311-beta", + "typescript": "^6.0.2", + "vite": "^8.0.14" + }, + "nx": { + "targets": { + "test:e2e": { + "parallelism": false + } + } + } +} diff --git a/e2e/react-start/start-manifest/playwright.config.ts b/e2e/react-start/start-manifest/playwright.config.ts new file mode 100644 index 0000000000..9e72f6160b --- /dev/null +++ b/e2e/react-start/start-manifest/playwright.config.ts @@ -0,0 +1,30 @@ +import { defineConfig, devices } from '@playwright/test' +import { getTestServerPort } from '@tanstack/router-e2e-utils' +import packageJson from './package.json' with { type: 'json' } + +const PORT = await getTestServerPort(packageJson.name) +const baseURL = `http://localhost:${PORT}` + +export default defineConfig({ + testDir: './tests', + workers: 1, + reporter: [['line']], + + use: { + baseURL, + }, + + webServer: { + command: `PORT=${PORT} pnpm build && PORT=${PORT} pnpm start`, + url: baseURL, + reuseExistingServer: !process.env.CI, + stdout: 'pipe', + }, + + projects: [ + { + name: 'chromium', + use: { ...devices['Desktop Chrome'] }, + }, + ], +}) diff --git a/e2e/react-start/start-manifest/src/components/AppShell.tsx b/e2e/react-start/start-manifest/src/components/AppShell.tsx new file mode 100644 index 0000000000..f504a4fd66 --- /dev/null +++ b/e2e/react-start/start-manifest/src/components/AppShell.tsx @@ -0,0 +1,37 @@ +import { ClientOnly, Link, Outlet, linkOptions } from '@tanstack/react-router' +import styles from '~/styles/root-shell.module.css' + +const ROUTES = linkOptions([ + { to: '/', label: 'home' }, + { to: '/a', label: '/a' }, + { to: '/b', label: '/b' }, + { to: '/lazy-css-static', label: '/lazy-css-static' }, + { to: '/lazy-css-lazy', label: '/lazy-css-lazy' }, + { to: '/r1', label: '/r1' }, + { to: '/r2', label: '/r2' }, + { to: '/shared-a', label: '/shared-a' }, +]) + +export function AppShell() { + return ( +
    + + +
    +
    + Start manifest CSS root shell +
    + +
    hydrated
    +
    + +
    +
    + ) +} diff --git a/e2e/react-start/start-manifest/src/components/SharedCard.tsx b/e2e/react-start/start-manifest/src/components/SharedCard.tsx new file mode 100644 index 0000000000..812e02da3d --- /dev/null +++ b/e2e/react-start/start-manifest/src/components/SharedCard.tsx @@ -0,0 +1,9 @@ +import styles from '~/styles/shared-card.module.css' + +export function SharedCard({ label }: { label: string }) { + return ( +
    + Shared card {label} +
    + ) +} diff --git a/e2e/react-start/start-manifest/src/components/SharedNestedLayout.tsx b/e2e/react-start/start-manifest/src/components/SharedNestedLayout.tsx new file mode 100644 index 0000000000..5a88a30f41 --- /dev/null +++ b/e2e/react-start/start-manifest/src/components/SharedNestedLayout.tsx @@ -0,0 +1,29 @@ +import { Link, linkOptions } from '@tanstack/react-router' +import type { ReactNode } from 'react' +import styles from '~/styles/shared-layout.module.css' + +const SHARED_ROUTES = linkOptions([ + { to: '/shared-a', label: '/shared-a' }, + { to: '/shared-b', label: '/shared-b' }, + { to: '/shared-c', label: '/shared-c' }, +]) + +export function SharedNestedLayout({ children }: { children: ReactNode }) { + return ( +
    +
    + Shared nested layout CSS module +
    + +
    + {children} +
    +
    + ) +} diff --git a/e2e/react-start/css-modules/src/components/shared-widget.tsx b/e2e/react-start/start-manifest/src/components/SharedWidget.tsx similarity index 76% rename from e2e/react-start/css-modules/src/components/shared-widget.tsx rename to e2e/react-start/start-manifest/src/components/SharedWidget.tsx index 51a3be072c..0937bd1c7b 100644 --- a/e2e/react-start/css-modules/src/components/shared-widget.tsx +++ b/e2e/react-start/start-manifest/src/components/SharedWidget.tsx @@ -1,4 +1,3 @@ -/// import styles from '~/styles/shared-widget.module.css' export function SharedWidget() { @@ -8,7 +7,7 @@ export function SharedWidget() { Shared widget styles
    - This widget uses a CSS module shared by a static route and a lazy route. + This widget uses CSS shared by a static route and a lazy route.
    ) diff --git a/e2e/react-start/css-modules/src/components/shared-widget-lazy.tsx b/e2e/react-start/start-manifest/src/components/SharedWidgetLazy.tsx similarity index 61% rename from e2e/react-start/css-modules/src/components/shared-widget-lazy.tsx rename to e2e/react-start/start-manifest/src/components/SharedWidgetLazy.tsx index 6d9ddce6f5..5f1f6410a5 100644 --- a/e2e/react-start/css-modules/src/components/shared-widget-lazy.tsx +++ b/e2e/react-start/start-manifest/src/components/SharedWidgetLazy.tsx @@ -1,4 +1,4 @@ -import { SharedWidget } from './shared-widget' +import { SharedWidget } from './SharedWidget' export default function SharedWidgetLazy() { return diff --git a/e2e/react-start/start-manifest/src/routeTree.gen.ts b/e2e/react-start/start-manifest/src/routeTree.gen.ts new file mode 100644 index 0000000000..b7ee033842 --- /dev/null +++ b/e2e/react-start/start-manifest/src/routeTree.gen.ts @@ -0,0 +1,345 @@ +/* eslint-disable */ + +// @ts-nocheck + +// noinspection JSUnusedGlobalSymbols + +// This file was automatically generated by TanStack Router. +// You should NOT make any changes in this file as it will be overwritten. +// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. + +import { Route as rootRouteImport } from './routes/__root' +import { Route as SharedCRouteImport } from './routes/shared-c' +import { Route as SharedBRouteImport } from './routes/shared-b' +import { Route as SharedARouteImport } from './routes/shared-a' +import { Route as R6RouteImport } from './routes/r6' +import { Route as R5RouteImport } from './routes/r5' +import { Route as R4RouteImport } from './routes/r4' +import { Route as R3RouteImport } from './routes/r3' +import { Route as R2RouteImport } from './routes/r2' +import { Route as R1RouteImport } from './routes/r1' +import { Route as LazyCssStaticRouteImport } from './routes/lazy-css-static' +import { Route as LazyCssLazyRouteImport } from './routes/lazy-css-lazy' +import { Route as BRouteImport } from './routes/b' +import { Route as ARouteImport } from './routes/a' +import { Route as IndexRouteImport } from './routes/index' + +const SharedCRoute = SharedCRouteImport.update({ + id: '/shared-c', + path: '/shared-c', + getParentRoute: () => rootRouteImport, +} as any) +const SharedBRoute = SharedBRouteImport.update({ + id: '/shared-b', + path: '/shared-b', + getParentRoute: () => rootRouteImport, +} as any) +const SharedARoute = SharedARouteImport.update({ + id: '/shared-a', + path: '/shared-a', + getParentRoute: () => rootRouteImport, +} as any) +const R6Route = R6RouteImport.update({ + id: '/r6', + path: '/r6', + getParentRoute: () => rootRouteImport, +} as any) +const R5Route = R5RouteImport.update({ + id: '/r5', + path: '/r5', + getParentRoute: () => rootRouteImport, +} as any) +const R4Route = R4RouteImport.update({ + id: '/r4', + path: '/r4', + getParentRoute: () => rootRouteImport, +} as any) +const R3Route = R3RouteImport.update({ + id: '/r3', + path: '/r3', + getParentRoute: () => rootRouteImport, +} as any) +const R2Route = R2RouteImport.update({ + id: '/r2', + path: '/r2', + getParentRoute: () => rootRouteImport, +} as any) +const R1Route = R1RouteImport.update({ + id: '/r1', + path: '/r1', + getParentRoute: () => rootRouteImport, +} as any) +const LazyCssStaticRoute = LazyCssStaticRouteImport.update({ + id: '/lazy-css-static', + path: '/lazy-css-static', + getParentRoute: () => rootRouteImport, +} as any) +const LazyCssLazyRoute = LazyCssLazyRouteImport.update({ + id: '/lazy-css-lazy', + path: '/lazy-css-lazy', + getParentRoute: () => rootRouteImport, +} as any) +const BRoute = BRouteImport.update({ + id: '/b', + path: '/b', + getParentRoute: () => rootRouteImport, +} as any) +const ARoute = ARouteImport.update({ + id: '/a', + path: '/a', + getParentRoute: () => rootRouteImport, +} as any) +const IndexRoute = IndexRouteImport.update({ + id: '/', + path: '/', + getParentRoute: () => rootRouteImport, +} as any) + +export interface FileRoutesByFullPath { + '/': typeof IndexRoute + '/a': typeof ARoute + '/b': typeof BRoute + '/lazy-css-lazy': typeof LazyCssLazyRoute + '/lazy-css-static': typeof LazyCssStaticRoute + '/r1': typeof R1Route + '/r2': typeof R2Route + '/r3': typeof R3Route + '/r4': typeof R4Route + '/r5': typeof R5Route + '/r6': typeof R6Route + '/shared-a': typeof SharedARoute + '/shared-b': typeof SharedBRoute + '/shared-c': typeof SharedCRoute +} +export interface FileRoutesByTo { + '/': typeof IndexRoute + '/a': typeof ARoute + '/b': typeof BRoute + '/lazy-css-lazy': typeof LazyCssLazyRoute + '/lazy-css-static': typeof LazyCssStaticRoute + '/r1': typeof R1Route + '/r2': typeof R2Route + '/r3': typeof R3Route + '/r4': typeof R4Route + '/r5': typeof R5Route + '/r6': typeof R6Route + '/shared-a': typeof SharedARoute + '/shared-b': typeof SharedBRoute + '/shared-c': typeof SharedCRoute +} +export interface FileRoutesById { + __root__: typeof rootRouteImport + '/': typeof IndexRoute + '/a': typeof ARoute + '/b': typeof BRoute + '/lazy-css-lazy': typeof LazyCssLazyRoute + '/lazy-css-static': typeof LazyCssStaticRoute + '/r1': typeof R1Route + '/r2': typeof R2Route + '/r3': typeof R3Route + '/r4': typeof R4Route + '/r5': typeof R5Route + '/r6': typeof R6Route + '/shared-a': typeof SharedARoute + '/shared-b': typeof SharedBRoute + '/shared-c': typeof SharedCRoute +} +export interface FileRouteTypes { + fileRoutesByFullPath: FileRoutesByFullPath + fullPaths: + | '/' + | '/a' + | '/b' + | '/lazy-css-lazy' + | '/lazy-css-static' + | '/r1' + | '/r2' + | '/r3' + | '/r4' + | '/r5' + | '/r6' + | '/shared-a' + | '/shared-b' + | '/shared-c' + fileRoutesByTo: FileRoutesByTo + to: + | '/' + | '/a' + | '/b' + | '/lazy-css-lazy' + | '/lazy-css-static' + | '/r1' + | '/r2' + | '/r3' + | '/r4' + | '/r5' + | '/r6' + | '/shared-a' + | '/shared-b' + | '/shared-c' + id: + | '__root__' + | '/' + | '/a' + | '/b' + | '/lazy-css-lazy' + | '/lazy-css-static' + | '/r1' + | '/r2' + | '/r3' + | '/r4' + | '/r5' + | '/r6' + | '/shared-a' + | '/shared-b' + | '/shared-c' + fileRoutesById: FileRoutesById +} +export interface RootRouteChildren { + IndexRoute: typeof IndexRoute + ARoute: typeof ARoute + BRoute: typeof BRoute + LazyCssLazyRoute: typeof LazyCssLazyRoute + LazyCssStaticRoute: typeof LazyCssStaticRoute + R1Route: typeof R1Route + R2Route: typeof R2Route + R3Route: typeof R3Route + R4Route: typeof R4Route + R5Route: typeof R5Route + R6Route: typeof R6Route + SharedARoute: typeof SharedARoute + SharedBRoute: typeof SharedBRoute + SharedCRoute: typeof SharedCRoute +} + +declare module '@tanstack/react-router' { + interface FileRoutesByPath { + '/shared-c': { + id: '/shared-c' + path: '/shared-c' + fullPath: '/shared-c' + preLoaderRoute: typeof SharedCRouteImport + parentRoute: typeof rootRouteImport + } + '/shared-b': { + id: '/shared-b' + path: '/shared-b' + fullPath: '/shared-b' + preLoaderRoute: typeof SharedBRouteImport + parentRoute: typeof rootRouteImport + } + '/shared-a': { + id: '/shared-a' + path: '/shared-a' + fullPath: '/shared-a' + preLoaderRoute: typeof SharedARouteImport + parentRoute: typeof rootRouteImport + } + '/r6': { + id: '/r6' + path: '/r6' + fullPath: '/r6' + preLoaderRoute: typeof R6RouteImport + parentRoute: typeof rootRouteImport + } + '/r5': { + id: '/r5' + path: '/r5' + fullPath: '/r5' + preLoaderRoute: typeof R5RouteImport + parentRoute: typeof rootRouteImport + } + '/r4': { + id: '/r4' + path: '/r4' + fullPath: '/r4' + preLoaderRoute: typeof R4RouteImport + parentRoute: typeof rootRouteImport + } + '/r3': { + id: '/r3' + path: '/r3' + fullPath: '/r3' + preLoaderRoute: typeof R3RouteImport + parentRoute: typeof rootRouteImport + } + '/r2': { + id: '/r2' + path: '/r2' + fullPath: '/r2' + preLoaderRoute: typeof R2RouteImport + parentRoute: typeof rootRouteImport + } + '/r1': { + id: '/r1' + path: '/r1' + fullPath: '/r1' + preLoaderRoute: typeof R1RouteImport + parentRoute: typeof rootRouteImport + } + '/lazy-css-static': { + id: '/lazy-css-static' + path: '/lazy-css-static' + fullPath: '/lazy-css-static' + preLoaderRoute: typeof LazyCssStaticRouteImport + parentRoute: typeof rootRouteImport + } + '/lazy-css-lazy': { + id: '/lazy-css-lazy' + path: '/lazy-css-lazy' + fullPath: '/lazy-css-lazy' + preLoaderRoute: typeof LazyCssLazyRouteImport + parentRoute: typeof rootRouteImport + } + '/b': { + id: '/b' + path: '/b' + fullPath: '/b' + preLoaderRoute: typeof BRouteImport + parentRoute: typeof rootRouteImport + } + '/a': { + id: '/a' + path: '/a' + fullPath: '/a' + preLoaderRoute: typeof ARouteImport + parentRoute: typeof rootRouteImport + } + '/': { + id: '/' + path: '/' + fullPath: '/' + preLoaderRoute: typeof IndexRouteImport + parentRoute: typeof rootRouteImport + } + } +} + +const rootRouteChildren: RootRouteChildren = { + IndexRoute: IndexRoute, + ARoute: ARoute, + BRoute: BRoute, + LazyCssLazyRoute: LazyCssLazyRoute, + LazyCssStaticRoute: LazyCssStaticRoute, + R1Route: R1Route, + R2Route: R2Route, + R3Route: R3Route, + R4Route: R4Route, + R5Route: R5Route, + R6Route: R6Route, + SharedARoute: SharedARoute, + SharedBRoute: SharedBRoute, + SharedCRoute: SharedCRoute, +} +export const routeTree = rootRouteImport + ._addFileChildren(rootRouteChildren) + ._addFileTypes() + +import type { getRouter } from './router.tsx' +import type { createStart } from '@tanstack/react-start' +declare module '@tanstack/react-start' { + interface Register { + ssr: true + router: Awaited> + } +} diff --git a/examples/react/start-basic-rsc/src/router.tsx b/e2e/react-start/start-manifest/src/router.tsx similarity index 57% rename from examples/react/start-basic-rsc/src/router.tsx rename to e2e/react-start/start-manifest/src/router.tsx index f648dfcf8c..a575758450 100644 --- a/examples/react/start-basic-rsc/src/router.tsx +++ b/e2e/react-start/start-manifest/src/router.tsx @@ -1,15 +1,11 @@ import { createRouter } from '@tanstack/react-router' import { routeTree } from './routeTree.gen' -import { DefaultCatchBoundary } from './components/DefaultCatchBoundary' -import { NotFound } from './components/NotFound' -export function getRouter() { +export const getRouter = () => { const router = createRouter({ routeTree, - defaultPreload: 'intent', - defaultErrorComponent: DefaultCatchBoundary, - defaultNotFoundComponent: () => , scrollRestoration: true, + defaultPreload: 'intent', }) return router diff --git a/e2e/react-start/start-manifest/src/routes/__root.tsx b/e2e/react-start/start-manifest/src/routes/__root.tsx new file mode 100644 index 0000000000..af8098eeb5 --- /dev/null +++ b/e2e/react-start/start-manifest/src/routes/__root.tsx @@ -0,0 +1,30 @@ +/// +import { HeadContent, Scripts, createRootRoute } from '@tanstack/react-router' +import { AppShell } from '~/components/AppShell' +import type { ReactNode } from 'react' + +export const Route = createRootRoute({ + head: () => ({ + meta: [ + { charSet: 'utf-8' }, + { name: 'viewport', content: 'width=device-width, initial-scale=1' }, + { title: 'TanStack Start Manifest Bloat E2E' }, + ], + }), + component: AppShell, + shellComponent: RootDocument, +}) + +function RootDocument({ children }: { children: ReactNode }) { + return ( + + + + + + {children} + + + + ) +} diff --git a/e2e/react-start/start-manifest/src/routes/a.tsx b/e2e/react-start/start-manifest/src/routes/a.tsx new file mode 100644 index 0000000000..434803920d --- /dev/null +++ b/e2e/react-start/start-manifest/src/routes/a.tsx @@ -0,0 +1,17 @@ +import { createFileRoute } from '@tanstack/react-router' +import { SharedCard } from '~/components/SharedCard' +import styles from '~/styles/page-a.module.css' + +export const Route = createFileRoute('/a')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( +
    +

    Route /a

    +

    Route /a keeps the shared card styled.

    + +
    + ) +} diff --git a/e2e/react-start/start-manifest/src/routes/b.tsx b/e2e/react-start/start-manifest/src/routes/b.tsx new file mode 100644 index 0000000000..a418aeabeb --- /dev/null +++ b/e2e/react-start/start-manifest/src/routes/b.tsx @@ -0,0 +1,17 @@ +import { createFileRoute } from '@tanstack/react-router' +import { SharedCard } from '~/components/SharedCard' +import styles from '~/styles/page-b.module.css' + +export const Route = createFileRoute('/b')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( +
    +

    Route /b

    +

    Route /b should keep the shared card stylesheet after nav.

    + +
    + ) +} diff --git a/e2e/react-start/start-manifest/src/routes/index.tsx b/e2e/react-start/start-manifest/src/routes/index.tsx new file mode 100644 index 0000000000..bac21d3bd2 --- /dev/null +++ b/e2e/react-start/start-manifest/src/routes/index.tsx @@ -0,0 +1,16 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/')({ + component: HomeRoute, +}) + +function HomeRoute() { + return ( +
    +

    Start manifest fixture

    +

    + Use this page to navigate between CSS module routes. +

    +
    + ) +} diff --git a/e2e/react-start/css-modules/src/routes/lazy-css-lazy.tsx b/e2e/react-start/start-manifest/src/routes/lazy-css-lazy.tsx similarity index 89% rename from e2e/react-start/css-modules/src/routes/lazy-css-lazy.tsx rename to e2e/react-start/start-manifest/src/routes/lazy-css-lazy.tsx index 4d147a9651..28cec3aff3 100644 --- a/e2e/react-start/css-modules/src/routes/lazy-css-lazy.tsx +++ b/e2e/react-start/start-manifest/src/routes/lazy-css-lazy.tsx @@ -2,7 +2,7 @@ import * as React from 'react' import { createFileRoute } from '@tanstack/react-router' const LazySharedWidget = React.lazy( - () => import('~/components/shared-widget-lazy'), + () => import('~/components/SharedWidgetLazy'), ) export const Route = createFileRoute('/lazy-css-lazy')({ @@ -11,7 +11,7 @@ export const Route = createFileRoute('/lazy-css-lazy')({ function LazyCssLazyRoute() { return ( -
    +

    Lazy CSS Repro - Lazy Route

    This route renders the same widget through React.lazy so the CSS only @@ -23,6 +23,6 @@ function LazyCssLazyRoute() { > -

    + ) } diff --git a/e2e/react-start/css-modules/src/routes/lazy-css-static.tsx b/e2e/react-start/start-manifest/src/routes/lazy-css-static.tsx similarity index 85% rename from e2e/react-start/css-modules/src/routes/lazy-css-static.tsx rename to e2e/react-start/start-manifest/src/routes/lazy-css-static.tsx index c9e3f33a0e..349e90f33e 100644 --- a/e2e/react-start/css-modules/src/routes/lazy-css-static.tsx +++ b/e2e/react-start/start-manifest/src/routes/lazy-css-static.tsx @@ -1,5 +1,5 @@ import { ClientOnly, createFileRoute } from '@tanstack/react-router' -import { SharedWidget } from '~/components/shared-widget' +import { SharedWidget } from '~/components/SharedWidget' export const Route = createFileRoute('/lazy-css-static')({ component: LazyCssStaticRoute, @@ -7,7 +7,7 @@ export const Route = createFileRoute('/lazy-css-static')({ function LazyCssStaticRoute() { return ( -
    +

    Lazy CSS Repro - Static Route

    This route statically imports the shared widget so its CSS is present in @@ -19,6 +19,6 @@ function LazyCssStaticRoute() { -

    + ) } diff --git a/e2e/react-start/start-manifest/src/routes/r1.tsx b/e2e/react-start/start-manifest/src/routes/r1.tsx new file mode 100644 index 0000000000..b74b3d23e6 --- /dev/null +++ b/e2e/react-start/start-manifest/src/routes/r1.tsx @@ -0,0 +1,17 @@ +import { createFileRoute } from '@tanstack/react-router' +import styles from '~/styles/route-one.module.css' + +export const Route = createFileRoute('/r1')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( +
    +

    Route /r1

    +
    + Route /r1 CSS module styling +
    +
    + ) +} diff --git a/e2e/react-start/start-manifest/src/routes/r2.tsx b/e2e/react-start/start-manifest/src/routes/r2.tsx new file mode 100644 index 0000000000..235879f021 --- /dev/null +++ b/e2e/react-start/start-manifest/src/routes/r2.tsx @@ -0,0 +1,17 @@ +import { createFileRoute } from '@tanstack/react-router' +import styles from '~/styles/route-two.module.css' + +export const Route = createFileRoute('/r2')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( +
    +

    Route /r2

    +
    + Route /r2 CSS module styling +
    +
    + ) +} diff --git a/e2e/react-start/start-manifest/src/routes/r3.tsx b/e2e/react-start/start-manifest/src/routes/r3.tsx new file mode 100644 index 0000000000..46a2ed2cb4 --- /dev/null +++ b/e2e/react-start/start-manifest/src/routes/r3.tsx @@ -0,0 +1,14 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/r3')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( +
    +

    Route /r3

    +

    Auxiliary route.

    +
    + ) +} diff --git a/e2e/react-start/start-manifest/src/routes/r4.tsx b/e2e/react-start/start-manifest/src/routes/r4.tsx new file mode 100644 index 0000000000..da398831a6 --- /dev/null +++ b/e2e/react-start/start-manifest/src/routes/r4.tsx @@ -0,0 +1,14 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/r4')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( +
    +

    Route /r4

    +

    Auxiliary route.

    +
    + ) +} diff --git a/e2e/react-start/start-manifest/src/routes/r5.tsx b/e2e/react-start/start-manifest/src/routes/r5.tsx new file mode 100644 index 0000000000..197ebcff55 --- /dev/null +++ b/e2e/react-start/start-manifest/src/routes/r5.tsx @@ -0,0 +1,14 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/r5')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( +
    +

    Route /r5

    +

    Auxiliary route.

    +
    + ) +} diff --git a/e2e/react-start/start-manifest/src/routes/r6.tsx b/e2e/react-start/start-manifest/src/routes/r6.tsx new file mode 100644 index 0000000000..88d128fd59 --- /dev/null +++ b/e2e/react-start/start-manifest/src/routes/r6.tsx @@ -0,0 +1,14 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/r6')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( +
    +

    Route /r6

    +

    Auxiliary route.

    +
    + ) +} diff --git a/e2e/react-start/start-manifest/src/routes/shared-a.tsx b/e2e/react-start/start-manifest/src/routes/shared-a.tsx new file mode 100644 index 0000000000..566362d52a --- /dev/null +++ b/e2e/react-start/start-manifest/src/routes/shared-a.tsx @@ -0,0 +1,14 @@ +import { createFileRoute } from '@tanstack/react-router' +import { SharedNestedLayout } from '~/components/SharedNestedLayout' + +export const Route = createFileRoute('/shared-a')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( + +
    Shared route A
    +
    + ) +} diff --git a/e2e/react-start/start-manifest/src/routes/shared-b.tsx b/e2e/react-start/start-manifest/src/routes/shared-b.tsx new file mode 100644 index 0000000000..e4441f471f --- /dev/null +++ b/e2e/react-start/start-manifest/src/routes/shared-b.tsx @@ -0,0 +1,14 @@ +import { createFileRoute } from '@tanstack/react-router' +import { SharedNestedLayout } from '~/components/SharedNestedLayout' + +export const Route = createFileRoute('/shared-b')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( + +
    Shared route B
    +
    + ) +} diff --git a/e2e/react-start/start-manifest/src/routes/shared-c.tsx b/e2e/react-start/start-manifest/src/routes/shared-c.tsx new file mode 100644 index 0000000000..85e5fca0ae --- /dev/null +++ b/e2e/react-start/start-manifest/src/routes/shared-c.tsx @@ -0,0 +1,14 @@ +import { createFileRoute } from '@tanstack/react-router' +import { SharedNestedLayout } from '~/components/SharedNestedLayout' + +export const Route = createFileRoute('/shared-c')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( + +
    Shared route C
    +
    + ) +} diff --git a/e2e/react-start/start-manifest/src/styles/page-a.module.css b/e2e/react-start/start-manifest/src/styles/page-a.module.css new file mode 100644 index 0000000000..7ed4301097 --- /dev/null +++ b/e2e/react-start/start-manifest/src/styles/page-a.module.css @@ -0,0 +1,10 @@ +.page { + padding: 1rem; + min-height: 12rem; + background: rgb(240, 253, 244); + border: 4px solid rgb(22, 163, 74); +} + +.title { + color: rgb(21, 128, 61); +} diff --git a/e2e/react-start/start-manifest/src/styles/page-b.module.css b/e2e/react-start/start-manifest/src/styles/page-b.module.css new file mode 100644 index 0000000000..93d1d39a01 --- /dev/null +++ b/e2e/react-start/start-manifest/src/styles/page-b.module.css @@ -0,0 +1,10 @@ +.page { + padding: 1rem; + min-height: 12rem; + background: rgb(239, 246, 255); + border: 4px solid rgb(37, 99, 235); +} + +.title { + color: rgb(29, 78, 216); +} diff --git a/e2e/react-start/start-manifest/src/styles/root-shell.module.css b/e2e/react-start/start-manifest/src/styles/root-shell.module.css new file mode 100644 index 0000000000..e7bece8664 --- /dev/null +++ b/e2e/react-start/start-manifest/src/styles/root-shell.module.css @@ -0,0 +1,37 @@ +.shell { + font-family: + -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; + min-height: 100vh; + background: rgb(248, 250, 252); + color: rgb(15, 23, 42); +} + +.nav { + display: flex; + flex-wrap: wrap; + gap: 0.75rem; + padding: 1rem; + border-bottom: 1px solid rgb(226, 232, 240); + background: white; +} + +.nav a { + color: rgb(37, 99, 235); + text-decoration: none; +} + +.content { + max-width: 760px; + margin: 0 auto; + padding: 1.5rem 1rem 3rem; +} + +.rootBadge { + display: inline-block; + margin-bottom: 1rem; + padding: 0.375rem 0.75rem; + border-radius: 9999px; + background: rgb(220, 252, 231); + color: rgb(22, 101, 52); + font-weight: 700; +} diff --git a/e2e/react-start/start-manifest/src/styles/route-one.module.css b/e2e/react-start/start-manifest/src/styles/route-one.module.css new file mode 100644 index 0000000000..623d03e6a3 --- /dev/null +++ b/e2e/react-start/start-manifest/src/styles/route-one.module.css @@ -0,0 +1,7 @@ +.card { + padding: 1rem; + border-radius: 0.75rem; + background: rgb(239, 246, 255); + color: rgb(30, 64, 175); + border: 2px solid rgb(96, 165, 250); +} diff --git a/e2e/react-start/start-manifest/src/styles/route-two.module.css b/e2e/react-start/start-manifest/src/styles/route-two.module.css new file mode 100644 index 0000000000..66ed355711 --- /dev/null +++ b/e2e/react-start/start-manifest/src/styles/route-two.module.css @@ -0,0 +1,7 @@ +.card { + padding: 1rem; + border-radius: 0.75rem; + background: rgb(250, 245, 255); + color: rgb(126, 34, 206); + border: 2px solid rgb(192, 132, 252); +} diff --git a/e2e/react-start/start-manifest/src/styles/shared-card.module.css b/e2e/react-start/start-manifest/src/styles/shared-card.module.css new file mode 100644 index 0000000000..2aa5a6ac17 --- /dev/null +++ b/e2e/react-start/start-manifest/src/styles/shared-card.module.css @@ -0,0 +1,8 @@ +.card { + margin-top: 1rem; + padding: 1.5rem; + border-radius: 0.75rem; + background: rgb(252, 231, 243); + border: 2px solid rgb(190, 24, 93); + color: rgb(157, 23, 77); +} diff --git a/e2e/react-start/start-manifest/src/styles/shared-layout.module.css b/e2e/react-start/start-manifest/src/styles/shared-layout.module.css new file mode 100644 index 0000000000..6025a1da06 --- /dev/null +++ b/e2e/react-start/start-manifest/src/styles/shared-layout.module.css @@ -0,0 +1,16 @@ +.layout { + padding: 1rem; + border-radius: 0.75rem; + background: rgb(255, 251, 235); + border: 2px solid rgb(245, 158, 11); +} + +.heading { + color: rgb(180, 83, 9); + font-weight: 700; + margin-bottom: 0.5rem; +} + +.body { + color: rgb(146, 64, 14); +} diff --git a/e2e/react-start/start-manifest/src/styles/shared-widget.module.css b/e2e/react-start/start-manifest/src/styles/shared-widget.module.css new file mode 100644 index 0000000000..ed197cddb0 --- /dev/null +++ b/e2e/react-start/start-manifest/src/styles/shared-widget.module.css @@ -0,0 +1,17 @@ +.widget { + margin-top: 1rem; + padding: 1rem; + border-top: 4px solid rgb(249, 115, 22); + border-radius: 0.75rem; + background: rgb(255, 247, 237); +} + +.title { + font-weight: 700; + color: rgb(154, 52, 18); +} + +.content { + margin-top: 0.5rem; + color: rgb(124, 45, 18); +} diff --git a/e2e/react-start/start-manifest/tests/start-manifest.spec.ts b/e2e/react-start/start-manifest/tests/start-manifest.spec.ts new file mode 100644 index 0000000000..7dfa390997 --- /dev/null +++ b/e2e/react-start/start-manifest/tests/start-manifest.spec.ts @@ -0,0 +1,460 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import type { Page } from '@playwright/test' +import { readdir } from 'node:fs/promises' +import path from 'node:path' +import { pathToFileURL } from 'node:url' + +const ROOT_SHELL_COLOR = 'rgb(22, 101, 52)' +const ROUTE_ONE_COLOR = 'rgb(30, 64, 175)' +const ROUTE_TWO_COLOR = 'rgb(126, 34, 206)' +const SHARED_CARD_BG = 'rgb(252, 231, 243)' +const SHARED_WIDGET_BG = 'rgb(255, 247, 237)' +const SHARED_WIDGET_BORDER = 'rgb(249, 115, 22)' + +const buildUrl = (baseURL: string, pathname: string) => + baseURL.replace(/\/$/, '') + pathname + +async function getColor(testId: string, page: Page) { + return page + .getByTestId(testId) + .evaluate((element) => getComputedStyle(element).color) +} + +async function getBackgroundColor(testId: string, page: Page) { + return page + .getByTestId(testId) + .evaluate((element) => getComputedStyle(element).backgroundColor) +} + +async function getBorderTopColor(testId: string, page: Page) { + return page + .getByTestId(testId) + .evaluate((element) => getComputedStyle(element).borderTopColor) +} + +function getStylesheetHrefsFromHtml(html: string) { + return Array.from( + html.matchAll(/]+rel="stylesheet"[^>]+href="([^"]+)"/g), + (match) => match[1]!, + ) +} + +async function getHeadStylesheetHrefs(page: Page) { + return page.locator('head link[rel="stylesheet"]').evaluateAll((links) => { + return links.map( + (link) => (link as HTMLLinkElement).getAttribute('href') || '', + ) + }) +} + +function countMatchingStylesheetHrefs(hrefs: Array, pattern: string) { + return hrefs.filter((href) => href.includes(pattern)).length +} + +async function loadBuiltStartManifest() { + const serverDir = path.resolve(import.meta.dirname, '../.output/server') + const entries = await readdir(serverDir) + const manifestFile = entries.find( + (entry) => + entry.startsWith('_tanstack-start-manifest_v-') && entry.endsWith('.mjs'), + ) + + expect(manifestFile).toBeTruthy() + + const moduleUrl = `${pathToFileURL(path.join(serverDir, manifestFile!)).href}?t=${Date.now()}` + const manifestModule = await import(moduleUrl) + + return manifestModule.tsrStartManifest() as { + routes: Record }> + } +} + +async function expectDirectEntry({ + page, + request, + baseURL, + pathname, + expectedVisibleTestId, + expectedAbsentTestId, + expectedStylesheetPattern, + unexpectedStylesheetPattern, + expectedColorTestId, + expectedColor, +}: { + page: Page + request: { + get: (url: string) => Promise<{ ok(): boolean; text(): Promise }> + } + baseURL: string + pathname: string + expectedVisibleTestId: string + expectedAbsentTestId: string + expectedStylesheetPattern: string + unexpectedStylesheetPattern: string + expectedColorTestId: string + expectedColor: string +}) { + const url = buildUrl(baseURL, pathname) + const response = await request.get(url) + const ssrHtml = await response.text() + + expect(response.ok()).toBe(true) + expect(ssrHtml).toContain('root-shell-marker') + expect(ssrHtml).toContain(expectedVisibleTestId) + expect(ssrHtml).not.toContain(expectedAbsentTestId) + + const stylesheetLinks = getStylesheetHrefsFromHtml(ssrHtml) + + expect( + countMatchingStylesheetHrefs(stylesheetLinks, expectedStylesheetPattern), + ).toBe(1) + expect( + countMatchingStylesheetHrefs(stylesheetLinks, unexpectedStylesheetPattern), + ).toBe(0) + expect(stylesheetLinks).toHaveLength(2) + + await page.goto(url) + await expect(page.getByTestId(expectedVisibleTestId)).toBeVisible() + await expect(page.getByTestId('hydration-marker')).toBeVisible() + + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return countMatchingStylesheetHrefs(hrefs, expectedStylesheetPattern) + }) + .toBe(1) + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return countMatchingStylesheetHrefs(hrefs, unexpectedStylesheetPattern) + }) + .toBe(0) + + await expect + .poll(() => getColor('root-shell-marker', page)) + .toBe(ROOT_SHELL_COLOR) + await expect + .poll(() => getColor(expectedColorTestId, page)) + .toBe(expectedColor) +} + +test('SSR and client navigation keep CSS module styles correct without hydration errors', async ({ + page, + baseURL, + request, +}) => { + const routeOneUrl = buildUrl(baseURL!, '/r1') + const response = await request.get(routeOneUrl) + const ssrHtml = await response.text() + + expect(response.ok()).toBe(true) + expect(ssrHtml).toContain('root-shell-marker') + expect(ssrHtml).toContain('route-r1-card') + expect(ssrHtml).not.toContain('route-r2-card') + + const stylesheetLinks = getStylesheetHrefsFromHtml(ssrHtml) + + expect(countMatchingStylesheetHrefs(stylesheetLinks, 'r1-')).toBe(1) + expect(countMatchingStylesheetHrefs(stylesheetLinks, 'r2-')).toBe(0) + expect(stylesheetLinks).toHaveLength(2) + + await page.goto(routeOneUrl) + + await expect(page.getByTestId('route-r1-card')).toBeVisible() + await expect(page.getByTestId('hydration-marker')).toBeVisible() + + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return countMatchingStylesheetHrefs(hrefs, 'r1-') + }) + .toBe(1) + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return countMatchingStylesheetHrefs(hrefs, 'r2-') + }) + .toBe(0) + + await expect + .poll(() => getColor('root-shell-marker', page)) + .toBe(ROOT_SHELL_COLOR) + await expect.poll(() => getColor('route-r1-card', page)).toBe(ROUTE_ONE_COLOR) + + await page.getByTestId('nav-/r2').click() + await page.waitForURL('**/r2') + await expect(page.getByTestId('route-r2-card')).toBeVisible() + + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return countMatchingStylesheetHrefs(hrefs, 'r2-') + }) + .toBe(1) + + await expect + .poll(() => getColor('root-shell-marker', page)) + .toBe(ROOT_SHELL_COLOR) + await expect.poll(() => getColor('route-r2-card', page)).toBe(ROUTE_TWO_COLOR) + + await page.getByTestId('nav-/r1').click() + await page.waitForURL('**/r1') + await expect(page.getByTestId('route-r1-card')).toBeVisible() + + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return countMatchingStylesheetHrefs(hrefs, 'r1-') + }) + .toBe(1) + + await expect + .poll(() => getColor('root-shell-marker', page)) + .toBe(ROOT_SHELL_COLOR) + await expect.poll(() => getColor('route-r1-card', page)).toBe(ROUTE_ONE_COLOR) +}) + +test('direct SSR entry on /r2 only includes its stylesheet and hydrates cleanly', async ({ + page, + baseURL, + request, +}) => { + await expectDirectEntry({ + page, + request, + baseURL: baseURL!, + pathname: '/r2', + expectedVisibleTestId: 'route-r2-card', + expectedAbsentTestId: 'route-r1-card', + expectedStylesheetPattern: 'r2-', + unexpectedStylesheetPattern: 'r1-', + expectedColorTestId: 'route-r2-card', + expectedColor: ROUTE_TWO_COLOR, + }) +}) + +test('direct SSR entries on different route-css pages stay isolated', async ({ + page, + baseURL, + request, +}) => { + await expectDirectEntry({ + page, + request, + baseURL: baseURL!, + pathname: '/r2', + expectedVisibleTestId: 'route-r2-card', + expectedAbsentTestId: 'route-r1-card', + expectedStylesheetPattern: 'r2-', + unexpectedStylesheetPattern: 'r1-', + expectedColorTestId: 'route-r2-card', + expectedColor: ROUTE_TWO_COLOR, + }) + + await expectDirectEntry({ + page, + request, + baseURL: baseURL!, + pathname: '/r1', + expectedVisibleTestId: 'route-r1-card', + expectedAbsentTestId: 'route-r2-card', + expectedStylesheetPattern: 'r1-', + unexpectedStylesheetPattern: 'r2-', + expectedColorTestId: 'route-r1-card', + expectedColor: ROUTE_ONE_COLOR, + }) +}) + +test('home route only renders the root stylesheet and no route-specific CSS', async ({ + page, + baseURL, + request, +}) => { + const homeUrl = buildUrl(baseURL!, '/') + const response = await request.get(homeUrl) + const ssrHtml = await response.text() + + expect(response.ok()).toBe(true) + expect(ssrHtml).toContain('root-shell-marker') + expect(ssrHtml).toContain('home-copy') + expect(ssrHtml).not.toContain('route-r1-card') + expect(ssrHtml).not.toContain('route-r2-card') + + const stylesheetLinks = getStylesheetHrefsFromHtml(ssrHtml) + + expect(countMatchingStylesheetHrefs(stylesheetLinks, 'r1-')).toBe(0) + expect(countMatchingStylesheetHrefs(stylesheetLinks, 'r2-')).toBe(0) + expect(stylesheetLinks).toHaveLength(1) + + await page.goto(homeUrl) + await expect(page.getByTestId('home-copy')).toBeVisible() + await expect(page.getByTestId('hydration-marker')).toBeVisible() + + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return countMatchingStylesheetHrefs(hrefs, 'r1-') + }) + .toBe(0) + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return countMatchingStylesheetHrefs(hrefs, 'r2-') + }) + .toBe(0) + + await expect + .poll(() => getColor('root-shell-marker', page)) + .toBe(ROOT_SHELL_COLOR) +}) + +test('built start manifest preserves shared layout asset identity across sibling routes', async ({ + page, + baseURL, +}) => { + await page.goto(buildUrl(baseURL!, '/shared-a')) + await expect(page.getByTestId('shared-a-card')).toBeVisible() + + const manifest = await loadBuiltStartManifest() + + const sharedAAsset = manifest.routes['/shared-a']?.css?.[0] + const sharedBAsset = manifest.routes['/shared-b']?.css?.[0] + const sharedCAsset = manifest.routes['/shared-c']?.css?.[0] + + expect(sharedAAsset).toBeTruthy() + expect(sharedAAsset).toBe(sharedBAsset) + expect(sharedBAsset).toBe(sharedCAsset) +}) + +test('shared CSS chunk persists across client-side nav', async ({ + page, + baseURL, +}) => { + await page.goto(buildUrl(baseURL!, '/a')) + + await expect(page.getByTestId('page-a')).toBeVisible() + await expect(page.getByTestId('shared-card')).toBeVisible() + await expect + .poll(() => getBackgroundColor('shared-card', page)) + .toBe(SHARED_CARD_BG) + await expect( + page.locator('head link[rel="stylesheet"][href*="SharedCard"]'), + ).toHaveCount(1) + + await page.getByTestId('nav-/b').click() + await page.waitForURL('**/b') + await expect(page.getByTestId('page-b')).toBeVisible() + + await expect( + page.locator('head link[rel="stylesheet"][href*="SharedCard"]'), + ).toHaveCount(1) + await expect + .poll(() => getBackgroundColor('shared-card', page)) + .toBe(SHARED_CARD_BG) +}) + +test('shared widget CSS stays applied when navigating from static to lazy route', async ({ + page, + baseURL, +}) => { + await page.goto(buildUrl(baseURL!, '/lazy-css-static')) + + const widget = page.getByTestId('shared-widget') + await expect(widget).toBeVisible() + expect(await getBackgroundColor('shared-widget', page)).toBe(SHARED_WIDGET_BG) + await expect + .poll(() => getBorderTopColor('shared-widget', page), { + timeout: 5_000, + }) + .toBe(SHARED_WIDGET_BORDER) + + await expect(page.getByTestId('lazy-css-static-hydrated')).toBeVisible() + + await page.getByTestId('nav-/lazy-css-lazy').click() + await page.waitForURL('**/lazy-css-lazy') + await expect(page.getByTestId('lazy-css-lazy-heading')).toBeVisible() + + await expect + .poll(() => getBackgroundColor('shared-widget', page), { + timeout: 5_000, + }) + .toBe(SHARED_WIDGET_BG) +}) + +test('shared widget CSS stays applied when navigating from lazy to static route', async ({ + page, + baseURL, +}) => { + await page.goto(buildUrl(baseURL!, '/lazy-css-lazy')) + await expect(page.getByTestId('lazy-css-lazy-heading')).toBeVisible() + + await expect + .poll(() => getBackgroundColor('shared-widget', page), { + timeout: 5_000, + }) + .toBe(SHARED_WIDGET_BG) + + await page.getByTestId('nav-/lazy-css-static').click() + await page.waitForURL('**/lazy-css-static') + await expect(page.getByTestId('lazy-css-static-hydrated')).toBeVisible() + + const widget = page.getByTestId('shared-widget') + await expect(widget).toBeVisible() + await expect + .poll(() => getBackgroundColor('shared-widget', page), { + timeout: 5_000, + }) + .toBe(SHARED_WIDGET_BG) + await expect + .poll(() => getBorderTopColor('shared-widget', page), { + timeout: 5_000, + }) + .toBe(SHARED_WIDGET_BORDER) +}) + +test('shared widget CSS is applied on direct navigation to lazy route', async ({ + page, + baseURL, +}) => { + await page.goto(buildUrl(baseURL!, '/lazy-css-lazy')) + await expect(page.getByTestId('lazy-css-lazy-heading')).toBeVisible() + + const widget = page.getByTestId('shared-widget') + await expect(widget).toBeVisible() + + await expect + .poll(() => getBackgroundColor('shared-widget', page), { + timeout: 5_000, + }) + .toBe(SHARED_WIDGET_BG) + await expect + .poll(() => getBorderTopColor('shared-widget', page), { + timeout: 5_000, + }) + .toBe(SHARED_WIDGET_BORDER) +}) + +test('shared widget CSS persists after navigating away from lazy and back', async ({ + page, + baseURL, +}) => { + await page.goto(buildUrl(baseURL!, '/lazy-css-static')) + await expect(page.getByTestId('lazy-css-static-hydrated')).toBeVisible() + + await page.getByTestId('nav-/lazy-css-lazy').click() + await page.waitForURL('**/lazy-css-lazy') + await expect(page.getByTestId('shared-widget')).toBeVisible() + + await page.getByTestId('nav-home').click() + await page.waitForURL((url) => url.pathname === '/') + + await page.getByTestId('nav-/lazy-css-lazy').click() + await page.waitForURL('**/lazy-css-lazy') + + await expect + .poll(() => getBackgroundColor('shared-widget', page), { + timeout: 5_000, + }) + .toBe(SHARED_WIDGET_BG) +}) diff --git a/e2e/react-start/start-manifest/tsconfig.json b/e2e/react-start/start-manifest/tsconfig.json new file mode 100644 index 0000000000..cc479423a1 --- /dev/null +++ b/e2e/react-start/start-manifest/tsconfig.json @@ -0,0 +1,21 @@ +{ + "include": ["**/*.ts", "**/*.tsx", "**/*.d.ts"], + "compilerOptions": { + "strict": true, + "esModuleInterop": true, + "jsx": "react-jsx", + "module": "ESNext", + "moduleResolution": "Bundler", + "lib": ["DOM", "DOM.Iterable", "ES2024"], + "isolatedModules": true, + "resolveJsonModule": true, + "skipLibCheck": true, + "target": "ES2024", + "allowJs": true, + "forceConsistentCasingInFileNames": true, + "paths": { + "~/*": ["./src/*"] + }, + "noEmit": true + } +} diff --git a/examples/react/start-basic-rsc/vite.config.ts b/e2e/react-start/start-manifest/vite.config.ts similarity index 70% rename from examples/react/start-basic-rsc/vite.config.ts rename to e2e/react-start/start-manifest/vite.config.ts index ed6799764a..b386068693 100644 --- a/examples/react/start-basic-rsc/vite.config.ts +++ b/e2e/react-start/start-manifest/vite.config.ts @@ -1,7 +1,7 @@ import { tanstackStart } from '@tanstack/react-start/plugin/vite' import { defineConfig } from 'vite' import viteReact from '@vitejs/plugin-react' -import tailwindcss from '@tailwindcss/vite' +import { nitro } from 'nitro/vite' export default defineConfig({ server: { @@ -10,5 +10,5 @@ export default defineConfig({ resolve: { tsconfigPaths: true, }, - plugins: [tailwindcss(), tanstackStart(), viteReact()], + plugins: [tanstackStart({ srcDirectory: 'src' }), viteReact(), nitro()], }) diff --git a/e2e/react-start/static-server-functions/package.json b/e2e/react-start/static-server-functions/package.json index 91cd830252..47d8a73156 100644 --- a/e2e/react-start/static-server-functions/package.json +++ b/e2e/react-start/static-server-functions/package.json @@ -27,6 +27,6 @@ "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/e2e/react-start/streaming-ssr/package.json b/e2e/react-start/streaming-ssr/package.json index 34b06e3f12..0cbadeae74 100644 --- a/e2e/react-start/streaming-ssr/package.json +++ b/e2e/react-start/streaming-ssr/package.json @@ -18,8 +18,7 @@ "@tanstack/react-router-ssr-query": "workspace:^", "@tanstack/react-start": "workspace:^", "react": "^19.0.0", - "react-dom": "^19.0.0", - "vite": "^8.0.0" + "react-dom": "^19.0.0" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -28,6 +27,7 @@ "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "srvx": "^0.11.9", - "typescript": "^6.0.2" + "typescript": "^6.0.2", + "vite": "^8.0.14" } } diff --git a/e2e/react-start/streaming-ssr/tests/query-heavy.spec.ts b/e2e/react-start/streaming-ssr/tests/query-heavy.spec.ts index b175365acc..5e90d1f527 100644 --- a/e2e/react-start/streaming-ssr/tests/query-heavy.spec.ts +++ b/e2e/react-start/streaming-ssr/tests/query-heavy.spec.ts @@ -128,4 +128,23 @@ test.describe('Query heavy route (9 useSuspenseQuery)', () => { .count() expect(serverSourceCount).toBe(9) }) + + test('emits query stream data before stream end marker', async ({ + request, + }) => { + const response = await request.get('/query-heavy') + const html = await response.text() + const endMarker = '$_TSR.e()' + const endIndex = html.indexOf(endMarker) + const slowAsyncPayloadIndex = html.indexOf('"slow-async-3"') + const lastScriptOpen = html.lastIndexOf('', endIndex) + + expect(endIndex).toBeGreaterThan(-1) + expect(lastScriptOpen).toBeGreaterThan(lastScriptClose) + expect(slowAsyncPayloadIndex).toBeGreaterThan(-1) + expect(slowAsyncPayloadIndex).toBeLessThan(endIndex) + expect(html.slice(lastScriptOpen, endIndex)).toContain('.return(void 0)') + expect(endIndex).toBeLessThan(html.indexOf('')) + }) }) diff --git a/e2e/react-start/transform-asset-urls/package.json b/e2e/react-start/transform-asset-urls/package.json index 3b482cec98..40ffdd2569 100644 --- a/e2e/react-start/transform-asset-urls/package.json +++ b/e2e/react-start/transform-asset-urls/package.json @@ -16,10 +16,8 @@ "manual:both:options": "TRANSFORM_ASSETS_MODE=options TRANSFORM_ASSETS_OPTIONS_KIND=createTransform pnpm manual:both", "manual:both:options:transform": "TRANSFORM_ASSETS_MODE=options TRANSFORM_ASSETS_OPTIONS_KIND=transform pnpm manual:both", "manual:both:options:createTransform": "TRANSFORM_ASSETS_MODE=options TRANSFORM_ASSETS_OPTIONS_KIND=createTransform pnpm manual:both", - "manual:both:deprecated": "USE_DEPRECATED_TRANSFORM_ASSET_URLS=true TRANSFORM_ASSETS_MODE=function pnpm manual:both", "test:e2e:string": "rm -rf dist; rm -rf port*.txt; TRANSFORM_ASSETS_MODE=string playwright test --project=chromium", "test:e2e:function": "rm -rf dist; rm -rf port*.txt; TRANSFORM_ASSETS_MODE=function playwright test --project=chromium", - "test:e2e:deprecated": "rm -rf dist; rm -rf port*.txt; USE_DEPRECATED_TRANSFORM_ASSET_URLS=true TRANSFORM_ASSETS_MODE=function playwright test --project=chromium", "test:e2e:options": "rm -rf dist; rm -rf port*.txt; TRANSFORM_ASSETS_MODE=options TRANSFORM_ASSETS_OPTIONS_KIND=transform playwright test --project=chromium", "test:e2e:options:transform": "rm -rf dist; rm -rf port*.txt; TRANSFORM_ASSETS_MODE=options TRANSFORM_ASSETS_OPTIONS_KIND=transform playwright test --project=chromium", "test:e2e:options:createTransform": "rm -rf dist; rm -rf port*.txt; TRANSFORM_ASSETS_MODE=options TRANSFORM_ASSETS_OPTIONS_KIND=createTransform playwright test --project=chromium", @@ -32,12 +30,12 @@ "test:e2e:options:createTransform:cache-false:warmup-true": "rm -rf dist; rm -rf port*.txt; TRANSFORM_ASSETS_MODE=options TRANSFORM_ASSETS_OPTIONS_KIND=createTransform TRANSFORM_ASSETS_OPTIONS_CACHE=false TRANSFORM_ASSETS_OPTIONS_WARMUP=true playwright test --project=chromium", "test:e2e:options:createTransform:cache-false:warmup-false": "rm -rf dist; rm -rf port*.txt; TRANSFORM_ASSETS_MODE=options TRANSFORM_ASSETS_OPTIONS_KIND=createTransform TRANSFORM_ASSETS_OPTIONS_CACHE=false TRANSFORM_ASSETS_OPTIONS_WARMUP=false playwright test --project=chromium", "test:e2e:options:matrix": "pnpm test:e2e:options:transform:cache-true:warmup-true && pnpm test:e2e:options:transform:cache-true:warmup-false && pnpm test:e2e:options:transform:cache-false:warmup-true && pnpm test:e2e:options:transform:cache-false:warmup-false && pnpm test:e2e:options:createTransform:cache-true:warmup-true && pnpm test:e2e:options:createTransform:cache-true:warmup-false && pnpm test:e2e:options:createTransform:cache-false:warmup-true && pnpm test:e2e:options:createTransform:cache-false:warmup-false", - "test:e2e": "pnpm test:e2e:string && pnpm test:e2e:function && pnpm test:e2e:deprecated && pnpm test:e2e:options:matrix" + "test:e2e": "pnpm test:e2e:string && pnpm test:e2e:function && pnpm test:e2e:options:matrix" }, "dependencies": { "@tanstack/react-router": "workspace:^", "@tanstack/react-start": "workspace:^", - "express": "^5.1.0", + "express": "^5.2.1", "react": "^19.0.0", "react-dom": "^19.0.0" }, @@ -50,6 +48,6 @@ "@vitejs/plugin-react": "^6.0.1", "srvx": "^0.11.9", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/e2e/react-start/transform-asset-urls/playwright.config.ts b/e2e/react-start/transform-asset-urls/playwright.config.ts index fe009fb9af..bbef6838fe 100644 --- a/e2e/react-start/transform-asset-urls/playwright.config.ts +++ b/e2e/react-start/transform-asset-urls/playwright.config.ts @@ -12,8 +12,6 @@ const optionsKind = process.env.TRANSFORM_ASSETS_OPTIONS_KIND || 'createTransform' const optionsCache = process.env.TRANSFORM_ASSETS_OPTIONS_CACHE || 'true' const optionsWarmup = process.env.TRANSFORM_ASSETS_OPTIONS_WARMUP || 'true' -const useDeprecatedTransformAssetUrls = - process.env.USE_DEPRECATED_TRANSFORM_ASSET_URLS || 'false' export default defineConfig({ testDir: './tests', @@ -49,7 +47,6 @@ export default defineConfig({ TRANSFORM_ASSETS_OPTIONS_KIND: optionsKind, TRANSFORM_ASSETS_OPTIONS_CACHE: optionsCache, TRANSFORM_ASSETS_OPTIONS_WARMUP: optionsWarmup, - USE_DEPRECATED_TRANSFORM_ASSET_URLS: useDeprecatedTransformAssetUrls, }, timeout: 120_000, }, diff --git a/e2e/react-start/transform-asset-urls/src/routes/__root.tsx b/e2e/react-start/transform-asset-urls/src/routes/__root.tsx index ff4961a1a4..334bc93088 100644 --- a/e2e/react-start/transform-asset-urls/src/routes/__root.tsx +++ b/e2e/react-start/transform-asset-urls/src/routes/__root.tsx @@ -29,7 +29,7 @@ function RootComponent() { diff --git a/e2e/react-start/transform-asset-urls/src/server.ts b/e2e/react-start/transform-asset-urls/src/server.ts index e53d8f1f58..241fc2fe51 100644 --- a/e2e/react-start/transform-asset-urls/src/server.ts +++ b/e2e/react-start/transform-asset-urls/src/server.ts @@ -3,17 +3,10 @@ import { defaultStreamHandler, } from '@tanstack/react-start/server' import { createServerEntry } from '@tanstack/react-start/server-entry' -import type { TransformAssetUrls } from '@tanstack/react-start/server' - -type TransformAssetsFn = (ctx: { - kind: 'modulepreload' | 'stylesheet' | 'clientEntry' - url: string -}) => - | string - | { - href: string - crossOrigin?: 'anonymous' | 'use-credentials' - } +import type { + TransformAssets, + TransformAssetsFn, +} from '@tanstack/react-start/server' const cdnOrigin = process.env.CDN_ORIGIN const transformMode = process.env.TRANSFORM_ASSETS_MODE || 'string' @@ -21,14 +14,12 @@ const optionsKind = process.env.TRANSFORM_ASSETS_OPTIONS_KIND || 'createTransform' const optionsCache = process.env.TRANSFORM_ASSETS_OPTIONS_CACHE || 'true' const optionsWarmup = process.env.TRANSFORM_ASSETS_OPTIONS_WARMUP || 'true' -const useDeprecatedTransformAssetUrls = - process.env.USE_DEPRECATED_TRANSFORM_ASSET_URLS === 'true' const cache = optionsCache !== 'false' const warmup = optionsWarmup === 'true' console.log( - `[server-entry]: using custom server entry with ${useDeprecatedTransformAssetUrls ? 'transformAssetUrls' : 'transformAssets'} (${transformMode}${transformMode === 'options' ? `:${optionsKind}` : ''})${cdnOrigin ? ` (CDN: ${cdnOrigin})` : ' (no CDN)'}`, + `[server-entry]: using custom server entry with transformAssets (${transformMode}${transformMode === 'options' ? `:${optionsKind}` : ''})${cdnOrigin ? ` (CDN: ${cdnOrigin})` : ' (no CDN)'}`, ) const createTransformAssetsFn = @@ -36,7 +27,7 @@ const createTransformAssetsFn = ({ kind, url }) => { const href = `${cdn}${url}` - if (kind === 'modulepreload') { + if (kind === 'script') { return { href, crossOrigin: 'anonymous', @@ -53,7 +44,7 @@ const createTransformAssetsFn = return { href } } -const createTransformAssetsConfig = (cdn: string) => { +const createTransformAssetsConfig = (cdn: string): TransformAssets => { const transformAssetsFn = createTransformAssetsFn(cdn) if (transformMode === 'function') { @@ -81,49 +72,13 @@ const createTransformAssetsConfig = (cdn: string) => { return cdn } -const createDeprecatedTransformAssetUrlsConfig = ( - cdn: string, -): TransformAssetUrls => { - if (transformMode === 'function') { - return ({ url }) => `${cdn}${url}` - } - - if (transformMode === 'options') { - if (optionsKind === 'transform') { - return { - transform: ({ url }) => `${cdn}${url}`, - cache, - warmup, - } - } - - return { - createTransform: async () => { - return ({ url }) => `${cdn}${url}` - }, - cache, - warmup, - } - } - - return cdn -} - const handler = createStartHandler( cdnOrigin ? { handler: defaultStreamHandler, - ...(useDeprecatedTransformAssetUrls - ? { - transformAssetUrls: createDeprecatedTransformAssetUrlsConfig( - cdnOrigin.replace(/\/+$/, ''), - ), - } - : { - transformAssets: createTransformAssetsConfig( - cdnOrigin.replace(/\/+$/, ''), - ), - }), + transformAssets: createTransformAssetsConfig( + cdnOrigin.replace(/\/+$/, ''), + ), } : defaultStreamHandler, ) diff --git a/e2e/react-start/transform-asset-urls/tests/cdn-server.mjs b/e2e/react-start/transform-asset-urls/tests/cdn-server.mjs index a97f142e87..ea9bf62cd0 100644 --- a/e2e/react-start/transform-asset-urls/tests/cdn-server.mjs +++ b/e2e/react-start/transform-asset-urls/tests/cdn-server.mjs @@ -36,6 +36,7 @@ app.use((req, res, next) => { app.use(express.static(path.resolve(__dirname, '..', 'dist', 'client'))) -app.listen(port, () => { +app.listen(port, (error) => { + if (error) throw error console.info(`CDN Server: http://localhost:${port}`) }) diff --git a/e2e/react-start/transform-asset-urls/tests/transform-asset-urls.spec.ts b/e2e/react-start/transform-asset-urls/tests/transform-asset-urls.spec.ts index b006412243..eb02863b3b 100644 --- a/e2e/react-start/transform-asset-urls/tests/transform-asset-urls.spec.ts +++ b/e2e/react-start/transform-asset-urls/tests/transform-asset-urls.spec.ts @@ -39,18 +39,22 @@ test.describe('transformAssets with CDN prefix', () => { } }) - test('SSR HTML contains CDN-prefixed modulepreload links', async ({ + test('SSR HTML contains CDN-prefixed script preload links', async ({ page, }) => { const html = await getSSRHtml(page) - // All modulepreload links should point to the CDN origin - const modulepreloads = html.match(/rel="modulepreload"[^>]*href="([^"]+)"/g) - expect(modulepreloads).toBeTruthy() - expect(modulepreloads!.length).toBeGreaterThan(0) + // All script preload links should point to the CDN origin + const scriptPreloads = Array.from( + html.matchAll( + /]*\brel="modulepreload")(?=[^>]*\bhref="([^"]+)")[^>]*>/g, + ), + ) + expect(scriptPreloads).toBeTruthy() + expect(scriptPreloads.length).toBeGreaterThan(0) - for (const match of modulepreloads!) { - const href = match.match(/href="([^"]+)"/)?.[1] + for (const match of scriptPreloads) { + const href = match[1] expect(href).toBeTruthy() expect(href).toMatch(/^http:\/\/localhost:\d+\//) } @@ -61,10 +65,10 @@ test.describe('transformAssets with CDN prefix', () => { }) => { const html = await getSSRHtml(page) - const modulepreloadLink = html.match( + const scriptPreloadLink = html.match( /]*rel="modulepreload"[^>]*crossorigin="anonymous"[^>]*>/, ) - expect(modulepreloadLink).toBeTruthy() + expect(scriptPreloadLink).toBeTruthy() const stylesheetLink = html.match( /]*rel="stylesheet"[^>]*crossorigin="use-credentials"[^>]*>/, @@ -134,10 +138,8 @@ test.describe('transformAssets with CDN prefix', () => { }) => { const html = await getSSRHtml(page) - // The client entry script should contain an import() with CDN-prefixed URL - // JSON.stringify produces double quotes; bundler optimisation may use single quotes const clientEntryMatch = html.match( - /import\(["'](http:\/\/localhost:\d+\/[^"']+)["']\)/, + /]+src="(http:\/\/localhost:\d+\/[^"]*\/index[^"]*)"[^>]*>/, ) expect(clientEntryMatch).toBeTruthy() expect(clientEntryMatch![1]).toMatch(/^http:\/\/localhost:\d+\//) diff --git a/e2e/react-start/virtual-routes/package.json b/e2e/react-start/virtual-routes/package.json index ffb57da3af..0ba0855037 100644 --- a/e2e/react-start/virtual-routes/package.json +++ b/e2e/react-start/virtual-routes/package.json @@ -19,9 +19,8 @@ "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", - "tailwind-merge": "^2.6.0", - "vite": "^8.0.0", - "zod": "^3.24.2" + "tailwind-merge": "^3.6.0", + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -34,6 +33,7 @@ "combinate": "^1.1.11", "srvx": "^0.11.9", "tailwindcss": "^4.2.2", - "typescript": "^6.0.2" + "typescript": "^6.0.2", + "vite": "^8.0.14" } } diff --git a/e2e/react-start/website/package.json b/e2e/react-start/website/package.json index 6c888e0db4..ad1ab75d5b 100644 --- a/e2e/react-start/website/package.json +++ b/e2e/react-start/website/package.json @@ -18,8 +18,8 @@ "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", - "tailwind-merge": "^2.6.0", - "zod": "^3.24.2" + "tailwind-merge": "^3.6.0", + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -32,6 +32,6 @@ "srvx": "^0.11.9", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/e2e/solid-router/basepath-file-based/package.json b/e2e/solid-router/basepath-file-based/package.json index f3f3eddc29..7aaa2addfe 100644 --- a/e2e/solid-router/basepath-file-based/package.json +++ b/e2e/solid-router/basepath-file-based/package.json @@ -20,7 +20,7 @@ "devDependencies": { "@playwright/test": "^1.50.1", "@tanstack/router-e2e-utils": "workspace:^", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/e2e/solid-router/basic-esbuild-file-based/package.json b/e2e/solid-router/basic-esbuild-file-based/package.json index c33a613100..6fa208c60d 100644 --- a/e2e/solid-router/basic-esbuild-file-based/package.json +++ b/e2e/solid-router/basic-esbuild-file-based/package.json @@ -3,9 +3,9 @@ "private": true, "type": "module", "scripts": { - "dev": "esbuild src/main.tsx --jsx=preserve --jsx-import-source=solid-js --conditions=solid --serve=5601 --bundle --outfile=dist/main.js --watch --servedir=.", - "build": "esbuild src/main.tsx --jsx=preserve --jsx-import-source=solid-js --conditions=solid --bundle --outfile=dist/main.js && tsc --noEmit", - "serve": "esbuild src/main.tsx --jsx=preserve --jsx-import-source=solid-js --conditions=solid --bundle --outfile=dist/main.js --servedir=.", + "dev": "esbuild src/main.tsx --jsx=preserve --jsx-import-source=solid-js --serve=5601 --bundle --outfile=dist/main.js --watch --servedir=.", + "build": "esbuild src/main.tsx --jsx=preserve --jsx-import-source=solid-js --bundle --outfile=dist/main.js && tsc --noEmit", + "serve": "esbuild src/main.tsx --jsx=preserve --jsx-import-source=solid-js --bundle --outfile=dist/main.js --servedir=.", "start": "dev", "test:e2e": "rm -rf port*.txt; playwright test --project=chromium" }, @@ -17,7 +17,7 @@ "@tanstack/zod-adapter": "workspace:^", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", diff --git a/e2e/solid-router/basic-esbuild-file-based/src/routes/(group)/_layout.inside.tsx b/e2e/solid-router/basic-esbuild-file-based/src/routes/(group)/_layout.inside.tsx index f41c3f376f..cb1d7cccd8 100644 --- a/e2e/solid-router/basic-esbuild-file-based/src/routes/(group)/_layout.inside.tsx +++ b/e2e/solid-router/basic-esbuild-file-based/src/routes/(group)/_layout.inside.tsx @@ -1,11 +1,10 @@ import { createFileRoute, getRouteApi, useSearch } from '@tanstack/solid-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' const routeApi = getRouteApi('/(group)/_layout/inside') export const Route = createFileRoute('/(group)/_layout/inside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), component: () => { const searchViaHook = useSearch({ from: '/(group)/_layout/inside' }) const searchViaRouteHook = Route.useSearch() diff --git a/e2e/solid-router/basic-esbuild-file-based/src/routes/(group)/lazyinside.tsx b/e2e/solid-router/basic-esbuild-file-based/src/routes/(group)/lazyinside.tsx index dcaf7b0727..2a055aee9b 100644 --- a/e2e/solid-router/basic-esbuild-file-based/src/routes/(group)/lazyinside.tsx +++ b/e2e/solid-router/basic-esbuild-file-based/src/routes/(group)/lazyinside.tsx @@ -1,7 +1,6 @@ import { createFileRoute } from '@tanstack/solid-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(group)/lazyinside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), }) diff --git a/e2e/solid-router/basic-file-based-code-splitting/package.json b/e2e/solid-router/basic-file-based-code-splitting/package.json index 7c5a20b7eb..f86f169cdf 100644 --- a/e2e/solid-router/basic-file-based-code-splitting/package.json +++ b/e2e/solid-router/basic-file-based-code-splitting/package.json @@ -10,7 +10,7 @@ "start": "vite", "test:e2e:verbose-routes:true": "rm -rf port*.txt; VERBOSE_FILE_ROUTES=1 playwright test --project=chromium", "test:e2e:verbose-routes:false": "rm -rf port*.txt; VERBOSE_FILE_ROUTES=0 playwright test --project=chromium", - "test:e2e": "rm -rf port*.txt; pnpm run test:e2e:verbose-routes:true && pnpm run test:e2e:verbose-routes:false" + "test:e2e": "rm -rf port*.txt; playwright test --project=chromium" }, "dependencies": { "@solidjs/web": "2.0.0-beta.14", @@ -20,12 +20,12 @@ "@tanstack/solid-router-devtools": "workspace:^", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", "@tanstack/router-e2e-utils": "workspace:^", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/e2e/solid-router/basic-file-based-code-splitting/src/routeTree.gen.ts b/e2e/solid-router/basic-file-based-code-splitting/src/routeTree.gen.ts index ef825551bd..c0f1e2bc16 100644 --- a/e2e/solid-router/basic-file-based-code-splitting/src/routeTree.gen.ts +++ b/e2e/solid-router/basic-file-based-code-splitting/src/routeTree.gen.ts @@ -8,8 +8,6 @@ // You should NOT make any changes in this file as it will be overwritten. // Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. -import type { CreateFileRoute, FileRoutesByPath } from '@tanstack/solid-router' - import { Route as rootRouteImport } from './routes/__root' import { Route as WithoutLoaderRouteImport } from './routes/without-loader' import { Route as ViewportTestRouteImport } from './routes/viewport-test' @@ -220,97 +218,6 @@ declare module '@tanstack/solid-router' { } } -declare module './routes/index' { - const createFileRoute: CreateFileRoute< - '/', - FileRoutesByPath['/']['parentRoute'], - FileRoutesByPath['/']['id'], - FileRoutesByPath['/']['path'], - FileRoutesByPath['/']['fullPath'] - > -} -declare module './routes/_layout' { - const createFileRoute: CreateFileRoute< - '/_layout', - FileRoutesByPath['/_layout']['parentRoute'], - FileRoutesByPath['/_layout']['id'], - FileRoutesByPath['/_layout']['path'], - FileRoutesByPath['/_layout']['fullPath'] - > -} -declare module './routes/posts' { - const createFileRoute: CreateFileRoute< - '/posts', - FileRoutesByPath['/posts']['parentRoute'], - FileRoutesByPath['/posts']['id'], - FileRoutesByPath['/posts']['path'], - FileRoutesByPath['/posts']['fullPath'] - > -} -declare module './routes/viewport-test' { - const createFileRoute: CreateFileRoute< - '/viewport-test', - FileRoutesByPath['/viewport-test']['parentRoute'], - FileRoutesByPath['/viewport-test']['id'], - FileRoutesByPath['/viewport-test']['path'], - FileRoutesByPath['/viewport-test']['fullPath'] - > -} -declare module './routes/without-loader' { - const createFileRoute: CreateFileRoute< - '/without-loader', - FileRoutesByPath['/without-loader']['parentRoute'], - FileRoutesByPath['/without-loader']['id'], - FileRoutesByPath['/without-loader']['path'], - FileRoutesByPath['/without-loader']['fullPath'] - > -} -declare module './routes/_layout/_layout-2' { - const createFileRoute: CreateFileRoute< - '/_layout/_layout-2', - FileRoutesByPath['/_layout/_layout-2']['parentRoute'], - FileRoutesByPath['/_layout/_layout-2']['id'], - FileRoutesByPath['/_layout/_layout-2']['path'], - FileRoutesByPath['/_layout/_layout-2']['fullPath'] - > -} -declare module './routes/posts.$postId' { - const createFileRoute: CreateFileRoute< - '/posts/$postId', - FileRoutesByPath['/posts/$postId']['parentRoute'], - FileRoutesByPath['/posts/$postId']['id'], - FileRoutesByPath['/posts/$postId']['path'], - FileRoutesByPath['/posts/$postId']['fullPath'] - > -} -declare module './routes/posts.index' { - const createFileRoute: CreateFileRoute< - '/posts/', - FileRoutesByPath['/posts/']['parentRoute'], - FileRoutesByPath['/posts/']['id'], - FileRoutesByPath['/posts/']['path'], - FileRoutesByPath['/posts/']['fullPath'] - > -} -declare module './routes/_layout/_layout-2/layout-a' { - const createFileRoute: CreateFileRoute< - '/_layout/_layout-2/layout-a', - FileRoutesByPath['/_layout/_layout-2/layout-a']['parentRoute'], - FileRoutesByPath['/_layout/_layout-2/layout-a']['id'], - FileRoutesByPath['/_layout/_layout-2/layout-a']['path'], - FileRoutesByPath['/_layout/_layout-2/layout-a']['fullPath'] - > -} -declare module './routes/_layout/_layout-2/layout-b' { - const createFileRoute: CreateFileRoute< - '/_layout/_layout-2/layout-b', - FileRoutesByPath['/_layout/_layout-2/layout-b']['parentRoute'], - FileRoutesByPath['/_layout/_layout-2/layout-b']['id'], - FileRoutesByPath['/_layout/_layout-2/layout-b']['path'], - FileRoutesByPath['/_layout/_layout-2/layout-b']['fullPath'] - > -} - interface LayoutLayout2RouteChildren { LayoutLayout2LayoutARoute: typeof LayoutLayout2LayoutARoute LayoutLayout2LayoutBRoute: typeof LayoutLayout2LayoutBRoute diff --git a/e2e/solid-router/basic-file-based-code-splitting/src/routes/_layout.tsx b/e2e/solid-router/basic-file-based-code-splitting/src/routes/_layout.tsx index c549175638..d43b4ef5f5 100644 --- a/e2e/solid-router/basic-file-based-code-splitting/src/routes/_layout.tsx +++ b/e2e/solid-router/basic-file-based-code-splitting/src/routes/_layout.tsx @@ -1,6 +1,6 @@ -import { Outlet } from '@tanstack/solid-router' +import { Outlet, createFileRoute } from '@tanstack/solid-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/_layout')({ component: LayoutComponent, }) diff --git a/e2e/solid-router/basic-file-based-code-splitting/src/routes/_layout/_layout-2.tsx b/e2e/solid-router/basic-file-based-code-splitting/src/routes/_layout/_layout-2.tsx index efeca5ce86..7a5a3623a0 100644 --- a/e2e/solid-router/basic-file-based-code-splitting/src/routes/_layout/_layout-2.tsx +++ b/e2e/solid-router/basic-file-based-code-splitting/src/routes/_layout/_layout-2.tsx @@ -1,6 +1,6 @@ -import { Link, Outlet } from '@tanstack/solid-router' +import { Link, Outlet, createFileRoute } from '@tanstack/solid-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/_layout/_layout-2')({ component: LayoutComponent, }) diff --git a/e2e/solid-router/basic-file-based-code-splitting/src/routes/_layout/_layout-2/layout-a.tsx b/e2e/solid-router/basic-file-based-code-splitting/src/routes/_layout/_layout-2/layout-a.tsx index a190b24202..997e6caf80 100644 --- a/e2e/solid-router/basic-file-based-code-splitting/src/routes/_layout/_layout-2/layout-a.tsx +++ b/e2e/solid-router/basic-file-based-code-splitting/src/routes/_layout/_layout-2/layout-a.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/_layout/_layout-2/layout-a')({ component: LayoutAComponent, }) diff --git a/e2e/solid-router/basic-file-based-code-splitting/src/routes/_layout/_layout-2/layout-b.tsx b/e2e/solid-router/basic-file-based-code-splitting/src/routes/_layout/_layout-2/layout-b.tsx index 505f8f6fbf..70135c5809 100644 --- a/e2e/solid-router/basic-file-based-code-splitting/src/routes/_layout/_layout-2/layout-b.tsx +++ b/e2e/solid-router/basic-file-based-code-splitting/src/routes/_layout/_layout-2/layout-b.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/_layout/_layout-2/layout-b')({ component: LayoutBComponent, }) diff --git a/e2e/solid-router/basic-file-based-code-splitting/src/routes/index.tsx b/e2e/solid-router/basic-file-based-code-splitting/src/routes/index.tsx index 510db79b73..3f905db60c 100644 --- a/e2e/solid-router/basic-file-based-code-splitting/src/routes/index.tsx +++ b/e2e/solid-router/basic-file-based-code-splitting/src/routes/index.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/')({ component: Home, }) diff --git a/e2e/solid-router/basic-file-based-code-splitting/src/routes/posts.$postId.tsx b/e2e/solid-router/basic-file-based-code-splitting/src/routes/posts.$postId.tsx index e23c29a21a..105f08d64e 100644 --- a/e2e/solid-router/basic-file-based-code-splitting/src/routes/posts.$postId.tsx +++ b/e2e/solid-router/basic-file-based-code-splitting/src/routes/posts.$postId.tsx @@ -1,4 +1,4 @@ -import { ErrorComponent } from '@tanstack/solid-router' +import { ErrorComponent, createFileRoute } from '@tanstack/solid-router' import { fetchPost } from '../posts' import type { ErrorComponentProps } from '@tanstack/solid-router' @@ -6,7 +6,7 @@ export function PostErrorComponent({ error }: ErrorComponentProps) { return } -export const Route = createFileRoute({ +export const Route = createFileRoute('/posts/$postId')({ loader: async ({ params: { postId } }) => fetchPost(postId), errorComponent: PostErrorComponent as any, notFoundComponent: () => { diff --git a/e2e/solid-router/basic-file-based-code-splitting/src/routes/posts.index.tsx b/e2e/solid-router/basic-file-based-code-splitting/src/routes/posts.index.tsx index 13529228bb..812b581e0a 100644 --- a/e2e/solid-router/basic-file-based-code-splitting/src/routes/posts.index.tsx +++ b/e2e/solid-router/basic-file-based-code-splitting/src/routes/posts.index.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/posts/')({ component: PostsIndexComponent, }) diff --git a/e2e/solid-router/basic-file-based-code-splitting/src/routes/posts.tsx b/e2e/solid-router/basic-file-based-code-splitting/src/routes/posts.tsx index 2e28f9beb3..11a999f50a 100644 --- a/e2e/solid-router/basic-file-based-code-splitting/src/routes/posts.tsx +++ b/e2e/solid-router/basic-file-based-code-splitting/src/routes/posts.tsx @@ -1,7 +1,7 @@ -import { Link, Outlet } from '@tanstack/solid-router' +import { Link, Outlet, createFileRoute } from '@tanstack/solid-router' import { fetchPosts } from '../posts' -export const Route = createFileRoute({ +export const Route = createFileRoute('/posts')({ loader: fetchPosts, component: PostsComponent, }) diff --git a/e2e/solid-router/basic-file-based-code-splitting/src/routes/viewport-test.tsx b/e2e/solid-router/basic-file-based-code-splitting/src/routes/viewport-test.tsx index b182feb7b1..c199bc56e0 100644 --- a/e2e/solid-router/basic-file-based-code-splitting/src/routes/viewport-test.tsx +++ b/e2e/solid-router/basic-file-based-code-splitting/src/routes/viewport-test.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/viewport-test')({ component: () =>
    Hello /viewport-test!
    , }) diff --git a/e2e/solid-router/basic-file-based-code-splitting/src/routes/without-loader.tsx b/e2e/solid-router/basic-file-based-code-splitting/src/routes/without-loader.tsx index af692bdaca..a7bf51fafb 100644 --- a/e2e/solid-router/basic-file-based-code-splitting/src/routes/without-loader.tsx +++ b/e2e/solid-router/basic-file-based-code-splitting/src/routes/without-loader.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/without-loader')({ component: () =>
    Hello /without-loader!
    , }) diff --git a/e2e/solid-router/basic-file-based-code-splitting/vite.config.ts b/e2e/solid-router/basic-file-based-code-splitting/vite.config.ts index a8f02c0015..b5efb3bfad 100644 --- a/e2e/solid-router/basic-file-based-code-splitting/vite.config.ts +++ b/e2e/solid-router/basic-file-based-code-splitting/vite.config.ts @@ -3,9 +3,6 @@ import solid from 'vite-plugin-solid' import { tanstackRouter } from '@tanstack/router-plugin/vite' import tailwindcss from '@tailwindcss/vite' -const isVerboseFileRoutes = process.env.VERBOSE_FILE_ROUTES === '1' || false -console.info(`Verbose file routes is set to: ${isVerboseFileRoutes}.`) - // https://vitejs.dev/config/ export default defineConfig({ plugins: [ @@ -13,7 +10,6 @@ export default defineConfig({ tanstackRouter({ target: 'solid', autoCodeSplitting: true, - verboseFileRoutes: isVerboseFileRoutes, codeSplittingOptions: { splitBehavior: ({ routeId }) => { if (routeId === '/posts') { diff --git a/e2e/solid-router/basic-file-based/package.json b/e2e/solid-router/basic-file-based/package.json index ddbbf67b59..c36d666ed5 100644 --- a/e2e/solid-router/basic-file-based/package.json +++ b/e2e/solid-router/basic-file-based/package.json @@ -21,13 +21,13 @@ "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", "@tanstack/router-e2e-utils": "workspace:^", "combinate": "^1.1.11", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/e2e/solid-router/basic-file-based/src/routes/(another-group)/onlyrouteinside.tsx b/e2e/solid-router/basic-file-based/src/routes/(another-group)/onlyrouteinside.tsx index d935e88ed6..5142996809 100644 --- a/e2e/solid-router/basic-file-based/src/routes/(another-group)/onlyrouteinside.tsx +++ b/e2e/solid-router/basic-file-based/src/routes/(another-group)/onlyrouteinside.tsx @@ -1,12 +1,11 @@ import { createFileRoute } from '@tanstack/solid-router' import { getRouteApi, useSearch } from '@tanstack/solid-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' const routeApi = getRouteApi('/(another-group)/onlyrouteinside') export const Route = createFileRoute('/(another-group)/onlyrouteinside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), component: () => { const searchViaHook = useSearch({ from: '/(another-group)/onlyrouteinside', diff --git a/e2e/solid-router/basic-file-based/src/routes/(group)/_layout.insidelayout.tsx b/e2e/solid-router/basic-file-based/src/routes/(group)/_layout.insidelayout.tsx index 6ad8947caa..50516a8f44 100644 --- a/e2e/solid-router/basic-file-based/src/routes/(group)/_layout.insidelayout.tsx +++ b/e2e/solid-router/basic-file-based/src/routes/(group)/_layout.insidelayout.tsx @@ -1,12 +1,11 @@ import { createFileRoute } from '@tanstack/solid-router' import { getRouteApi, useSearch } from '@tanstack/solid-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' const routeApi = getRouteApi('/(group)/_layout/insidelayout') export const Route = createFileRoute('/(group)/_layout/insidelayout')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), component: () => { const searchViaHook = useSearch({ from: '/(group)/_layout/insidelayout' }) const searchViaRouteHook = Route.useSearch() diff --git a/e2e/solid-router/basic-file-based/src/routes/(group)/inside.tsx b/e2e/solid-router/basic-file-based/src/routes/(group)/inside.tsx index fbb420e112..ce73a933c4 100644 --- a/e2e/solid-router/basic-file-based/src/routes/(group)/inside.tsx +++ b/e2e/solid-router/basic-file-based/src/routes/(group)/inside.tsx @@ -1,12 +1,11 @@ import { createFileRoute } from '@tanstack/solid-router' import { getRouteApi, useSearch } from '@tanstack/solid-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' const routeApi = getRouteApi('/(group)/inside') export const Route = createFileRoute('/(group)/inside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), component: () => { const searchViaHook = useSearch({ from: '/(group)/inside' }) const searchViaRouteHook = Route.useSearch() diff --git a/e2e/solid-router/basic-file-based/src/routes/(group)/lazyinside.tsx b/e2e/solid-router/basic-file-based/src/routes/(group)/lazyinside.tsx index dcaf7b0727..2a055aee9b 100644 --- a/e2e/solid-router/basic-file-based/src/routes/(group)/lazyinside.tsx +++ b/e2e/solid-router/basic-file-based/src/routes/(group)/lazyinside.tsx @@ -1,7 +1,6 @@ import { createFileRoute } from '@tanstack/solid-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(group)/lazyinside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), }) diff --git a/e2e/solid-router/basic-file-based/src/routes/(group)/subfolder/inside.tsx b/e2e/solid-router/basic-file-based/src/routes/(group)/subfolder/inside.tsx index 4f91b5a4f2..0ea47eb5b3 100644 --- a/e2e/solid-router/basic-file-based/src/routes/(group)/subfolder/inside.tsx +++ b/e2e/solid-router/basic-file-based/src/routes/(group)/subfolder/inside.tsx @@ -1,12 +1,11 @@ import { createFileRoute } from '@tanstack/solid-router' import { getRouteApi, useSearch } from '@tanstack/solid-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' const routeApi = getRouteApi('/(group)/subfolder/inside') export const Route = createFileRoute('/(group)/subfolder/inside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), component: () => { const searchViaHook = useSearch({ from: '/(group)/subfolder/inside' }) const searchViaRouteHook = Route.useSearch() diff --git a/e2e/solid-router/basic-scroll-restoration/package.json b/e2e/solid-router/basic-scroll-restoration/package.json index 5985faea2b..93c6900eda 100644 --- a/e2e/solid-router/basic-scroll-restoration/package.json +++ b/e2e/solid-router/basic-scroll-restoration/package.json @@ -5,10 +5,10 @@ "scripts": { "dev": "vite --port 3000", "dev:e2e": "vite", - "build": "exit 0;vite build && tsc --noEmit", + "build": "vite build && tsc --noEmit", "preview": "vite preview", "start": "vite", - "test:e2e": "exit 0; rm -rf port*.txt; playwright test --project=chromium" + "test:e2e": "rm -rf port*.txt; playwright test --project=chromium" }, "dependencies": { "@solidjs/web": "2.0.0-beta.14", @@ -24,7 +24,7 @@ "@playwright/test": "^1.50.1", "@tanstack/router-e2e-utils": "workspace:^", "typescript": "~5.9.0", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/e2e/solid-router/basic-solid-query-file-based/package.json b/e2e/solid-router/basic-solid-query-file-based/package.json index beb07929ca..dfc988326c 100644 --- a/e2e/solid-router/basic-solid-query-file-based/package.json +++ b/e2e/solid-router/basic-solid-query-file-based/package.json @@ -21,12 +21,12 @@ "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", "@tanstack/router-e2e-utils": "workspace:^", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/e2e/solid-router/basic-solid-query/package.json b/e2e/solid-router/basic-solid-query/package.json index 0daf5fe762..705cc7def1 100644 --- a/e2e/solid-router/basic-solid-query/package.json +++ b/e2e/solid-router/basic-solid-query/package.json @@ -24,7 +24,7 @@ "devDependencies": { "@playwright/test": "^1.50.1", "@tanstack/router-e2e-utils": "workspace:^", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/e2e/solid-router/basic-virtual-file-based/package.json b/e2e/solid-router/basic-virtual-file-based/package.json index 27fce3b245..78e1c637b4 100644 --- a/e2e/solid-router/basic-virtual-file-based/package.json +++ b/e2e/solid-router/basic-virtual-file-based/package.json @@ -20,12 +20,12 @@ "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", "@tanstack/router-e2e-utils": "workspace:^", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/e2e/solid-router/basic-virtual-file-based/src/routeTree.gen.ts b/e2e/solid-router/basic-virtual-file-based/src/routeTree.gen.ts index 643a489e0e..1c9691ab23 100644 --- a/e2e/solid-router/basic-virtual-file-based/src/routeTree.gen.ts +++ b/e2e/solid-router/basic-virtual-file-based/src/routeTree.gen.ts @@ -8,8 +8,6 @@ // You should NOT make any changes in this file as it will be overwritten. // Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. -import type { CreateFileRoute, FileRoutesByPath } from '@tanstack/solid-router' - import { Route as rootRouteImport } from './routes/root' import { Route as postsPostsRouteImport } from './routes/posts/posts' import { Route as layoutFirstLayoutRouteImport } from './routes/layout/first-layout' @@ -255,115 +253,6 @@ declare module '@tanstack/solid-router' { } } -declare module './routes/home' { - const createFileRoute: CreateFileRoute< - '/', - FileRoutesByPath['/']['parentRoute'], - FileRoutesByPath['/']['id'], - FileRoutesByPath['/']['path'], - FileRoutesByPath['/']['fullPath'] - > -} -declare module './routes/layout/first-layout' { - const createFileRoute: CreateFileRoute< - '/_first', - FileRoutesByPath['/_first']['parentRoute'], - FileRoutesByPath['/_first']['id'], - FileRoutesByPath['/_first']['path'], - FileRoutesByPath['/_first']['fullPath'] - > -} -declare module './routes/posts/posts' { - const createFileRoute: CreateFileRoute< - '/posts', - FileRoutesByPath['/posts']['parentRoute'], - FileRoutesByPath['/posts']['id'], - FileRoutesByPath['/posts']['path'], - FileRoutesByPath['/posts']['fullPath'] - > -} -declare module './routes/file-based-subtree/hello/route' { - const createFileRoute: CreateFileRoute< - '/classic/hello', - FileRoutesByPath['/classic/hello']['parentRoute'], - FileRoutesByPath['/classic/hello']['id'], - FileRoutesByPath['/classic/hello']['path'], - FileRoutesByPath['/classic/hello']['fullPath'] - > -} -declare module './routes/posts/posts-home' { - const createFileRoute: CreateFileRoute< - '/posts/', - FileRoutesByPath['/posts/']['parentRoute'], - FileRoutesByPath['/posts/']['id'], - FileRoutesByPath['/posts/']['path'], - FileRoutesByPath['/posts/']['fullPath'] - > -} -declare module './routes/layout/second-layout' { - const createFileRoute: CreateFileRoute< - '/_first/_second', - FileRoutesByPath['/_first/_second']['parentRoute'], - FileRoutesByPath['/_first/_second']['id'], - FileRoutesByPath['/_first/_second']['path'], - FileRoutesByPath['/_first/_second']['fullPath'] - > -} -declare module './routes/posts/posts-detail' { - const createFileRoute: CreateFileRoute< - '/posts/$postId', - FileRoutesByPath['/posts/$postId']['parentRoute'], - FileRoutesByPath['/posts/$postId']['id'], - FileRoutesByPath['/posts/$postId']['path'], - FileRoutesByPath['/posts/$postId']['fullPath'] - > -} -declare module './routes/a' { - const createFileRoute: CreateFileRoute< - '/_first/_second/layout-a', - FileRoutesByPath['/_first/_second/layout-a']['parentRoute'], - FileRoutesByPath['/_first/_second/layout-a']['id'], - FileRoutesByPath['/_first/_second/layout-a']['path'], - FileRoutesByPath['/_first/_second/layout-a']['fullPath'] - > -} -declare module './routes/b' { - const createFileRoute: CreateFileRoute< - '/_first/_second/layout-b', - FileRoutesByPath['/_first/_second/layout-b']['parentRoute'], - FileRoutesByPath['/_first/_second/layout-b']['id'], - FileRoutesByPath['/_first/_second/layout-b']['path'], - FileRoutesByPath['/_first/_second/layout-b']['fullPath'] - > -} -declare module './routes/file-based-subtree/hello/universe' { - const createFileRoute: CreateFileRoute< - '/classic/hello/universe', - FileRoutesByPath['/classic/hello/universe']['parentRoute'], - FileRoutesByPath['/classic/hello/universe']['id'], - FileRoutesByPath['/classic/hello/universe']['path'], - FileRoutesByPath['/classic/hello/universe']['fullPath'] - > -} -declare module './routes/file-based-subtree/hello/world' { - const createFileRoute: CreateFileRoute< - '/classic/hello/world', - FileRoutesByPath['/classic/hello/world']['parentRoute'], - FileRoutesByPath['/classic/hello/world']['id'], - FileRoutesByPath['/classic/hello/world']['path'], - FileRoutesByPath['/classic/hello/world']['fullPath'] - > -} -declare module './routes/file-based-subtree/hello/index' { - const createFileRoute: CreateFileRoute< - '/classic/hello/', - FileRoutesByPath['/classic/hello/']['parentRoute'], - FileRoutesByPath['/classic/hello/']['id'], - FileRoutesByPath['/classic/hello/']['path'], - FileRoutesByPath['/classic/hello/']['fullPath'] - > -} - interface layoutSecondLayoutRouteChildren { aRoute: typeof aRoute bRoute: typeof bRoute diff --git a/e2e/solid-router/basic-virtual-file-based/src/routes/a.tsx b/e2e/solid-router/basic-virtual-file-based/src/routes/a.tsx index a190b24202..be88a87cbe 100644 --- a/e2e/solid-router/basic-virtual-file-based/src/routes/a.tsx +++ b/e2e/solid-router/basic-virtual-file-based/src/routes/a.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/_first/_second/layout-a')({ component: LayoutAComponent, }) diff --git a/e2e/solid-router/basic-virtual-file-based/src/routes/b.tsx b/e2e/solid-router/basic-virtual-file-based/src/routes/b.tsx index 505f8f6fbf..c26087837b 100644 --- a/e2e/solid-router/basic-virtual-file-based/src/routes/b.tsx +++ b/e2e/solid-router/basic-virtual-file-based/src/routes/b.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/_first/_second/layout-b')({ component: LayoutBComponent, }) diff --git a/e2e/solid-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/index.tsx b/e2e/solid-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/index.tsx index f86335e291..6cc8bb1a6f 100644 --- a/e2e/solid-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/index.tsx +++ b/e2e/solid-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/index.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/classic/hello/')({ component: () =>
    This is the index
    , }) diff --git a/e2e/solid-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/route.tsx b/e2e/solid-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/route.tsx index 5b95eea555..f4f30d8425 100644 --- a/e2e/solid-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/route.tsx +++ b/e2e/solid-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/route.tsx @@ -1,6 +1,6 @@ -import { Link, Outlet } from '@tanstack/solid-router' +import { Link, Outlet, createFileRoute } from '@tanstack/solid-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/classic/hello')({ component: () => (
    Hello! diff --git a/e2e/solid-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/universe.tsx b/e2e/solid-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/universe.tsx index 20b07c41cc..f250de10c1 100644 --- a/e2e/solid-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/universe.tsx +++ b/e2e/solid-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/universe.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/classic/hello/universe')({ component: () =>
    Hello /classic/hello/universe!
    , }) diff --git a/e2e/solid-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/world.tsx b/e2e/solid-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/world.tsx index 4af11357a2..d207a49114 100644 --- a/e2e/solid-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/world.tsx +++ b/e2e/solid-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/world.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/classic/hello/world')({ component: () =>
    Hello /classic/hello/world!
    , }) diff --git a/e2e/solid-router/basic-virtual-file-based/src/routes/home.tsx b/e2e/solid-router/basic-virtual-file-based/src/routes/home.tsx index 510db79b73..3f905db60c 100644 --- a/e2e/solid-router/basic-virtual-file-based/src/routes/home.tsx +++ b/e2e/solid-router/basic-virtual-file-based/src/routes/home.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/')({ component: Home, }) diff --git a/e2e/solid-router/basic-virtual-file-based/src/routes/layout/first-layout.tsx b/e2e/solid-router/basic-virtual-file-based/src/routes/layout/first-layout.tsx index c549175638..5c77421bb2 100644 --- a/e2e/solid-router/basic-virtual-file-based/src/routes/layout/first-layout.tsx +++ b/e2e/solid-router/basic-virtual-file-based/src/routes/layout/first-layout.tsx @@ -1,6 +1,6 @@ -import { Outlet } from '@tanstack/solid-router' +import { Outlet, createFileRoute } from '@tanstack/solid-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/_first')({ component: LayoutComponent, }) diff --git a/e2e/solid-router/basic-virtual-file-based/src/routes/layout/second-layout.tsx b/e2e/solid-router/basic-virtual-file-based/src/routes/layout/second-layout.tsx index efeca5ce86..9ab147de5e 100644 --- a/e2e/solid-router/basic-virtual-file-based/src/routes/layout/second-layout.tsx +++ b/e2e/solid-router/basic-virtual-file-based/src/routes/layout/second-layout.tsx @@ -1,6 +1,6 @@ -import { Link, Outlet } from '@tanstack/solid-router' +import { Link, Outlet, createFileRoute } from '@tanstack/solid-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/_first/_second')({ component: LayoutComponent, }) diff --git a/e2e/solid-router/basic-virtual-file-based/src/routes/posts/posts-detail.tsx b/e2e/solid-router/basic-virtual-file-based/src/routes/posts/posts-detail.tsx index ef413c1be0..990f473ae8 100644 --- a/e2e/solid-router/basic-virtual-file-based/src/routes/posts/posts-detail.tsx +++ b/e2e/solid-router/basic-virtual-file-based/src/routes/posts/posts-detail.tsx @@ -1,4 +1,4 @@ -import { ErrorComponent } from '@tanstack/solid-router' +import { ErrorComponent, createFileRoute } from '@tanstack/solid-router' import { fetchPost } from '../../posts' import type { ErrorComponentProps } from '@tanstack/solid-router' @@ -6,7 +6,7 @@ export function PostErrorComponent({ error }: ErrorComponentProps) { return } -export const Route = createFileRoute({ +export const Route = createFileRoute('/posts/$postId')({ loader: async ({ params: { postId } }) => fetchPost(postId), errorComponent: PostErrorComponent as any, notFoundComponent: () => { diff --git a/e2e/solid-router/basic-virtual-file-based/src/routes/posts/posts-home.tsx b/e2e/solid-router/basic-virtual-file-based/src/routes/posts/posts-home.tsx index 13529228bb..812b581e0a 100644 --- a/e2e/solid-router/basic-virtual-file-based/src/routes/posts/posts-home.tsx +++ b/e2e/solid-router/basic-virtual-file-based/src/routes/posts/posts-home.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/posts/')({ component: PostsIndexComponent, }) diff --git a/e2e/solid-router/basic-virtual-file-based/src/routes/posts/posts.tsx b/e2e/solid-router/basic-virtual-file-based/src/routes/posts/posts.tsx index 46203594d1..9ae6dfc747 100644 --- a/e2e/solid-router/basic-virtual-file-based/src/routes/posts/posts.tsx +++ b/e2e/solid-router/basic-virtual-file-based/src/routes/posts/posts.tsx @@ -1,7 +1,7 @@ -import { Link, Outlet } from '@tanstack/solid-router' +import { Link, Outlet, createFileRoute } from '@tanstack/solid-router' import { fetchPosts } from '../../posts' -export const Route = createFileRoute({ +export const Route = createFileRoute('/posts')({ loader: fetchPosts, component: PostsComponent, }) diff --git a/e2e/solid-router/basic-virtual-file-based/vite.config.ts b/e2e/solid-router/basic-virtual-file-based/vite.config.ts index 275998d9cb..62bb160684 100644 --- a/e2e/solid-router/basic-virtual-file-based/vite.config.ts +++ b/e2e/solid-router/basic-virtual-file-based/vite.config.ts @@ -11,7 +11,6 @@ export default defineConfig({ tanstackRouter({ target: 'solid', autoCodeSplitting: true, - verboseFileRoutes: false, virtualRouteConfig: routes, }), solid(), diff --git a/e2e/solid-router/basic-virtual-named-export-config-file-based/package.json b/e2e/solid-router/basic-virtual-named-export-config-file-based/package.json index 9f3d199ae4..bab3e38075 100644 --- a/e2e/solid-router/basic-virtual-named-export-config-file-based/package.json +++ b/e2e/solid-router/basic-virtual-named-export-config-file-based/package.json @@ -20,12 +20,12 @@ "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", "@tanstack/router-e2e-utils": "workspace:^", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/a.tsx b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/a.tsx index a190b24202..be88a87cbe 100644 --- a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/a.tsx +++ b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/a.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/_first/_second/layout-a')({ component: LayoutAComponent, }) diff --git a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/b.tsx b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/b.tsx index 505f8f6fbf..c26087837b 100644 --- a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/b.tsx +++ b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/b.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/_first/_second/layout-b')({ component: LayoutBComponent, }) diff --git a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/index.tsx b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/index.tsx index f86335e291..6cc8bb1a6f 100644 --- a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/index.tsx +++ b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/index.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/classic/hello/')({ component: () =>
    This is the index
    , }) diff --git a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/route.tsx b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/route.tsx index 5b95eea555..f4f30d8425 100644 --- a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/route.tsx +++ b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/route.tsx @@ -1,6 +1,6 @@ -import { Link, Outlet } from '@tanstack/solid-router' +import { Link, Outlet, createFileRoute } from '@tanstack/solid-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/classic/hello')({ component: () => (
    Hello! diff --git a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/universe.tsx b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/universe.tsx index 20b07c41cc..f250de10c1 100644 --- a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/universe.tsx +++ b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/universe.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/classic/hello/universe')({ component: () =>
    Hello /classic/hello/universe!
    , }) diff --git a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/world.tsx b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/world.tsx index 4af11357a2..d207a49114 100644 --- a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/world.tsx +++ b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/world.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/classic/hello/world')({ component: () =>
    Hello /classic/hello/world!
    , }) diff --git a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/home.tsx b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/home.tsx index 510db79b73..3f905db60c 100644 --- a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/home.tsx +++ b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/home.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/')({ component: Home, }) diff --git a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/layout/first-layout.tsx b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/layout/first-layout.tsx index c549175638..5c77421bb2 100644 --- a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/layout/first-layout.tsx +++ b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/layout/first-layout.tsx @@ -1,6 +1,6 @@ -import { Outlet } from '@tanstack/solid-router' +import { Outlet, createFileRoute } from '@tanstack/solid-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/_first')({ component: LayoutComponent, }) diff --git a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/layout/second-layout.tsx b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/layout/second-layout.tsx index efeca5ce86..9ab147de5e 100644 --- a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/layout/second-layout.tsx +++ b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/layout/second-layout.tsx @@ -1,6 +1,6 @@ -import { Link, Outlet } from '@tanstack/solid-router' +import { Link, Outlet, createFileRoute } from '@tanstack/solid-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/_first/_second')({ component: LayoutComponent, }) diff --git a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts-detail.tsx b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts-detail.tsx index ef413c1be0..990f473ae8 100644 --- a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts-detail.tsx +++ b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts-detail.tsx @@ -1,4 +1,4 @@ -import { ErrorComponent } from '@tanstack/solid-router' +import { ErrorComponent, createFileRoute } from '@tanstack/solid-router' import { fetchPost } from '../../posts' import type { ErrorComponentProps } from '@tanstack/solid-router' @@ -6,7 +6,7 @@ export function PostErrorComponent({ error }: ErrorComponentProps) { return } -export const Route = createFileRoute({ +export const Route = createFileRoute('/posts/$postId')({ loader: async ({ params: { postId } }) => fetchPost(postId), errorComponent: PostErrorComponent as any, notFoundComponent: () => { diff --git a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts-home.tsx b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts-home.tsx index 13529228bb..812b581e0a 100644 --- a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts-home.tsx +++ b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts-home.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/posts/')({ component: PostsIndexComponent, }) diff --git a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts.tsx b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts.tsx index 46203594d1..9ae6dfc747 100644 --- a/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts.tsx +++ b/e2e/solid-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts.tsx @@ -1,7 +1,7 @@ -import { Link, Outlet } from '@tanstack/solid-router' +import { Link, Outlet, createFileRoute } from '@tanstack/solid-router' import { fetchPosts } from '../../posts' -export const Route = createFileRoute({ +export const Route = createFileRoute('/posts')({ loader: fetchPosts, component: PostsComponent, }) diff --git a/e2e/solid-router/basic-virtual-named-export-config-file-based/vite.config.ts b/e2e/solid-router/basic-virtual-named-export-config-file-based/vite.config.ts index c13227d733..ec379c254d 100644 --- a/e2e/solid-router/basic-virtual-named-export-config-file-based/vite.config.ts +++ b/e2e/solid-router/basic-virtual-named-export-config-file-based/vite.config.ts @@ -10,7 +10,6 @@ export default defineConfig({ tanstackRouter({ target: 'solid', autoCodeSplitting: true, - verboseFileRoutes: false, virtualRouteConfig: './routes.ts', }), solid(), diff --git a/e2e/solid-router/basic/package.json b/e2e/solid-router/basic/package.json index bb6c5d0687..414c58ff8d 100644 --- a/e2e/solid-router/basic/package.json +++ b/e2e/solid-router/basic/package.json @@ -22,7 +22,7 @@ "devDependencies": { "@playwright/test": "^1.50.1", "@tanstack/router-e2e-utils": "workspace:^", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/e2e/solid-router/generator-cli-only/package.json b/e2e/solid-router/generator-cli-only/package.json index 4a611faec9..cbf5fd8a95 100644 --- a/e2e/solid-router/generator-cli-only/package.json +++ b/e2e/solid-router/generator-cli-only/package.json @@ -23,7 +23,7 @@ "devDependencies": { "@playwright/test": "^1.50.1", "@tanstack/router-e2e-utils": "workspace:^", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/e2e/solid-router/js-only-file-based/package.json b/e2e/solid-router/js-only-file-based/package.json index e9ec3b111f..a8ef742276 100644 --- a/e2e/solid-router/js-only-file-based/package.json +++ b/e2e/solid-router/js-only-file-based/package.json @@ -23,7 +23,7 @@ "@playwright/test": "^1.50.1", "@tanstack/router-e2e-utils": "workspace:^", "@tanstack/router-plugin": "workspace:^", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/e2e/solid-router/rspack-basic-file-based/package.json b/e2e/solid-router/rspack-basic-file-based/package.json index 69582f5ba4..69587010d6 100644 --- a/e2e/solid-router/rspack-basic-file-based/package.json +++ b/e2e/solid-router/rspack-basic-file-based/package.json @@ -18,9 +18,9 @@ }, "devDependencies": { "@playwright/test": "^1.50.1", - "@rsbuild/core": "^1.2.4", - "@rsbuild/plugin-babel": "^1.0.3", - "@rsbuild/plugin-solid": "^1.0.6", + "@rsbuild/core": "^2.0.8", + "@rsbuild/plugin-babel": "^1.1.2", + "@rsbuild/plugin-solid": "^2.0.0-beta.0", "@tailwindcss/postcss": "^4.2.2", "@tanstack/router-e2e-utils": "workspace:^", "@tanstack/router-plugin": "workspace:^", diff --git a/e2e/solid-router/rspack-basic-virtual-named-export-config-file-based/package.json b/e2e/solid-router/rspack-basic-virtual-named-export-config-file-based/package.json index 723e2872b3..b07823b20b 100644 --- a/e2e/solid-router/rspack-basic-virtual-named-export-config-file-based/package.json +++ b/e2e/solid-router/rspack-basic-virtual-named-export-config-file-based/package.json @@ -18,9 +18,9 @@ }, "devDependencies": { "@playwright/test": "^1.50.1", - "@rsbuild/core": "^1.2.4", - "@rsbuild/plugin-babel": "^1.0.3", - "@rsbuild/plugin-solid": "^1.0.6", + "@rsbuild/core": "^2.0.8", + "@rsbuild/plugin-babel": "^1.1.2", + "@rsbuild/plugin-solid": "^2.0.0-beta.0", "@tailwindcss/postcss": "^4.2.2", "@tanstack/router-e2e-utils": "workspace:^", "@tanstack/router-plugin": "workspace:^", diff --git a/e2e/solid-router/scroll-restoration-sandbox-vite/package.json b/e2e/solid-router/scroll-restoration-sandbox-vite/package.json index 7528afc13d..a62e4d5cc7 100644 --- a/e2e/solid-router/scroll-restoration-sandbox-vite/package.json +++ b/e2e/solid-router/scroll-restoration-sandbox-vite/package.json @@ -23,12 +23,12 @@ "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", "@tanstack/router-e2e-utils": "workspace:^", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/e2e/solid-router/scroll-restoration-sandbox-vite/src/routes/(tests)/page-with-search.tsx b/e2e/solid-router/scroll-restoration-sandbox-vite/src/routes/(tests)/page-with-search.tsx index 4d5953ed67..7a9b3957e8 100644 --- a/e2e/solid-router/scroll-restoration-sandbox-vite/src/routes/(tests)/page-with-search.tsx +++ b/e2e/solid-router/scroll-restoration-sandbox-vite/src/routes/(tests)/page-with-search.tsx @@ -1,10 +1,9 @@ import { createFileRoute } from '@tanstack/solid-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' import { ScrollBlock } from '../-components/scroll-block' export const Route = createFileRoute('/(tests)/page-with-search')({ - validateSearch: zodValidator(z.object({ where: z.string() })), + validateSearch: z.object({ where: z.string() }), component: Component, }) diff --git a/e2e/solid-router/sentry-integration/package.json b/e2e/solid-router/sentry-integration/package.json index a272f33a16..e88b1c52f7 100644 --- a/e2e/solid-router/sentry-integration/package.json +++ b/e2e/solid-router/sentry-integration/package.json @@ -5,10 +5,10 @@ "scripts": { "dev": "vite --port 3000", "dev:e2e": "vite", - "build": "exit 0;vite build && tsc --noEmit", + "build": "vite build && tsc --noEmit", "preview": "vite preview", "start": "vite", - "test:e2e": "exit 0; rm -rf port*.txt; playwright test --project=chromium" + "test:e2e": "rm -rf port*.txt; playwright test --project=chromium" }, "dependencies": { "@sentry/solid": "^10.32.0", @@ -25,7 +25,7 @@ "devDependencies": { "@playwright/test": "^1.50.1", "@tanstack/router-e2e-utils": "workspace:^", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/e2e/solid-router/view-transitions/package.json b/e2e/solid-router/view-transitions/package.json index bf807b63c4..868bead209 100644 --- a/e2e/solid-router/view-transitions/package.json +++ b/e2e/solid-router/view-transitions/package.json @@ -19,13 +19,13 @@ "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", "@tanstack/router-e2e-utils": "workspace:^", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/e2e/solid-start/basic-auth/package.json b/e2e/solid-start/basic-auth/package.json index 31774f1548..87c4f76706 100644 --- a/e2e/solid-start/basic-auth/package.json +++ b/e2e/solid-start/basic-auth/package.json @@ -10,7 +10,7 @@ "preview": "vite preview", "start": "pnpx srvx --prod -s ../client dist/server/server.js", "prisma-generate": "prisma generate", - "test:e2e": "exit 0; rm -rf port*.txt; mkdir -p .tmp; rm -f .tmp/dev.db .tmp/dev.db-journal .tmp/dev.db-wal .tmp/dev.db-shm; export DATABASE_URL=file:./.tmp/dev.db; pnpm run prisma-generate && pnpm exec prisma migrate deploy && playwright test --project=chromium" + "test:e2e": "rm -rf port*.txt; mkdir -p .tmp; rm -f .tmp/dev.db .tmp/dev.db-journal .tmp/dev.db-wal .tmp/dev.db-shm; export DATABASE_URL=file:./.tmp/dev.db; pnpm run prisma-generate && pnpm exec prisma migrate deploy && playwright test --project=chromium" }, "dependencies": { "@libsql/client": "^0.15.15", @@ -22,8 +22,7 @@ "@tanstack/solid-start": "workspace:^", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", - "tailwind-merge": "^2.6.0", - "vite": "^8.0.0" + "tailwind-merge": "^3.6.0" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -35,6 +34,7 @@ "srvx": "^0.11.9", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite-plugin-solid": "^3.0.0-next.5" + "vite-plugin-solid": "^3.0.0-next.5", + "vite": "^8.0.14" } } diff --git a/e2e/solid-start/basic-cloudflare/package.json b/e2e/solid-start/basic-cloudflare/package.json index 2cf864e930..1d7ef0eefc 100644 --- a/e2e/solid-start/basic-cloudflare/package.json +++ b/e2e/solid-start/basic-cloudflare/package.json @@ -27,7 +27,7 @@ "@types/node": "^22.10.2", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5", "vite-tsconfig-paths": "^5.1.4", "wrangler": "^4.74.0" diff --git a/e2e/solid-start/basic-prerender/.gitignore b/e2e/solid-start/basic-prerender/.gitignore deleted file mode 100644 index 6381bf3860..0000000000 --- a/e2e/solid-start/basic-prerender/.gitignore +++ /dev/null @@ -1,5 +0,0 @@ -node_modules - -/test-results/ -/playwright-report/ -/blob-report/ diff --git a/e2e/solid-start/basic-prerender/package.json b/e2e/solid-start/basic-prerender/package.json deleted file mode 100644 index eda156f8e3..0000000000 --- a/e2e/solid-start/basic-prerender/package.json +++ /dev/null @@ -1,24 +0,0 @@ -{ - "name": "tanstack-solid-start-e2e-basic-prerender", - "private": true, - "sideEffects": false, - "type": "module", - "scripts": { - "test:e2e:startDummyServer": "node -e 'import(\"../basic-test-suite/src/setup/global.setup.ts\").then(m => m.default())' & node -e 'import(\"../basic-test-suite/src/setup/waitForDummyServer.ts\").then(m => m.default())'", - "test:e2e:stopDummyServer": "node -e 'import(\"../basic-test-suite/src/setup/global.teardown.ts\").then(m => m.default())'", - "test:e2e": "rm -rf port*.txt; MODE=prerender playwright test --project=chromium" - }, - "devDependencies": { - "@playwright/test": "^1.50.1", - "@tanstack/router-e2e-utils": "workspace:^", - "tanstack-solid-start-e2e-basic": "workspace:*", - "tanstack-solid-start-e2e-basic-test-suite": "workspace:*" - }, - "nx": { - "targets": { - "test:e2e": { - "parallelism": false - } - } - } -} diff --git a/e2e/solid-start/basic-prerender/playwright.config.ts b/e2e/solid-start/basic-prerender/playwright.config.ts deleted file mode 100644 index cf2cf5d396..0000000000 --- a/e2e/solid-start/basic-prerender/playwright.config.ts +++ /dev/null @@ -1,48 +0,0 @@ -import { defineConfig, devices } from '@playwright/test' -import { - getDummyServerPort, - getTestServerPort, -} from '@tanstack/router-e2e-utils' -import packageJson from './package.json' with { type: 'json' } - -const PORT = await getTestServerPort(packageJson.name) -const START_PORT = await getTestServerPort(`${packageJson.name}_start`) -const EXTERNAL_PORT = await getDummyServerPort(packageJson.name) -const baseURL = `http://localhost:${PORT}` - -export default defineConfig({ - testDir: '../basic-test-suite/src', - workers: 1, - reporter: [['line']], - - globalTeardown: '../basic-test-suite/src/setup/global.teardown.ts', - - use: { - baseURL, - }, - - webServer: { - command: - 'pnpm run test:e2e:startDummyServer && pnpm --dir ../basic build:prerender && pnpm --dir ../basic start', - url: baseURL, - reuseExistingServer: !process.env.CI, - stdout: 'pipe', - env: { - MODE: 'prerender', - VITE_NODE_ENV: 'test', - VITE_EXTERNAL_PORT: String(EXTERNAL_PORT), - VITE_SERVER_PORT: String(PORT), - START_PORT: String(START_PORT), - PORT: String(PORT), - }, - }, - - projects: [ - { - name: 'chromium', - use: { - ...devices['Desktop Chrome'], - }, - }, - ], -}) diff --git a/e2e/solid-start/basic-preview/.gitignore b/e2e/solid-start/basic-preview/.gitignore deleted file mode 100644 index 6381bf3860..0000000000 --- a/e2e/solid-start/basic-preview/.gitignore +++ /dev/null @@ -1,5 +0,0 @@ -node_modules - -/test-results/ -/playwright-report/ -/blob-report/ diff --git a/e2e/solid-start/basic-preview/package.json b/e2e/solid-start/basic-preview/package.json deleted file mode 100644 index 233d6af609..0000000000 --- a/e2e/solid-start/basic-preview/package.json +++ /dev/null @@ -1,24 +0,0 @@ -{ - "name": "tanstack-solid-start-e2e-basic-preview", - "private": true, - "sideEffects": false, - "type": "module", - "scripts": { - "test:e2e:startDummyServer": "node -e 'import(\"../basic-test-suite/src/setup/global.setup.ts\").then(m => m.default())' & node -e 'import(\"../basic-test-suite/src/setup/waitForDummyServer.ts\").then(m => m.default())'", - "test:e2e:stopDummyServer": "node -e 'import(\"../basic-test-suite/src/setup/global.teardown.ts\").then(m => m.default())'", - "test:e2e": "rm -rf port*.txt; MODE=preview playwright test --project=chromium" - }, - "devDependencies": { - "@playwright/test": "^1.50.1", - "@tanstack/router-e2e-utils": "workspace:^", - "tanstack-solid-start-e2e-basic": "workspace:*", - "tanstack-solid-start-e2e-basic-test-suite": "workspace:*" - }, - "nx": { - "targets": { - "test:e2e": { - "parallelism": false - } - } - } -} diff --git a/e2e/solid-start/basic-preview/playwright.config.ts b/e2e/solid-start/basic-preview/playwright.config.ts deleted file mode 100644 index 071f336f9f..0000000000 --- a/e2e/solid-start/basic-preview/playwright.config.ts +++ /dev/null @@ -1,47 +0,0 @@ -import { defineConfig, devices } from '@playwright/test' -import { - getDummyServerPort, - getTestServerPort, -} from '@tanstack/router-e2e-utils' -import packageJson from './package.json' with { type: 'json' } - -const PORT = await getTestServerPort(packageJson.name) -const START_PORT = await getTestServerPort(`${packageJson.name}_start`) -const EXTERNAL_PORT = await getDummyServerPort(packageJson.name) -const baseURL = `http://localhost:${PORT}` - -export default defineConfig({ - testDir: '../basic-test-suite/src', - workers: 1, - reporter: [['line']], - - globalTeardown: '../basic-test-suite/src/setup/global.teardown.ts', - - use: { - baseURL, - }, - - webServer: { - command: `pnpm run test:e2e:startDummyServer && pnpm --dir ../basic build && pnpm --dir ../basic preview --port ${PORT}`, - url: baseURL, - reuseExistingServer: !process.env.CI, - stdout: 'pipe', - env: { - MODE: 'preview', - VITE_NODE_ENV: 'test', - VITE_EXTERNAL_PORT: String(EXTERNAL_PORT), - VITE_SERVER_PORT: String(PORT), - START_PORT: String(START_PORT), - PORT: String(PORT), - }, - }, - - projects: [ - { - name: 'chromium', - use: { - ...devices['Desktop Chrome'], - }, - }, - ], -}) diff --git a/e2e/solid-start/basic-solid-query/package.json b/e2e/solid-start/basic-solid-query/package.json index ef48a36732..d760f980a7 100644 --- a/e2e/solid-start/basic-solid-query/package.json +++ b/e2e/solid-start/basic-solid-query/package.json @@ -21,9 +21,8 @@ "@tanstack/solid-start": "workspace:^", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", - "tailwind-merge": "^2.6.0", - "vite": "^8.0.0", - "zod": "^4.1.12" + "tailwind-merge": "^3.6.0", + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -33,6 +32,7 @@ "srvx": "^0.11.9", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite-plugin-solid": "^3.0.0-next.5" + "vite-plugin-solid": "^3.0.0-next.5", + "vite": "^8.0.14" } } diff --git a/e2e/solid-start/basic-solid-query/src/routes/__root.tsx b/e2e/solid-start/basic-solid-query/src/routes/__root.tsx index 020370cb8c..3e22aef8f3 100644 --- a/e2e/solid-start/basic-solid-query/src/routes/__root.tsx +++ b/e2e/solid-start/basic-solid-query/src/routes/__root.tsx @@ -7,6 +7,7 @@ import { createRootRouteWithContext, } from '@tanstack/solid-router' import { TanStackRouterDevtoolsInProd } from '@tanstack/solid-router-devtools' +import { children } from 'solid-js' import type { QueryClient } from '@tanstack/solid-query' import { DefaultCatchBoundary } from '~/components/DefaultCatchBoundary' import { NotFound } from '~/components/NotFound' @@ -74,6 +75,8 @@ function RootComponent() { } function RootDocument(props: { children?: any }) { + const resolvedChildren = children(() => props.children) + return ( @@ -130,7 +133,7 @@ function RootDocument(props: { children?: any }) {

    - {props.children} + {resolvedChildren()} diff --git a/e2e/solid-start/basic-spa/.gitignore b/e2e/solid-start/basic-spa/.gitignore deleted file mode 100644 index 6381bf3860..0000000000 --- a/e2e/solid-start/basic-spa/.gitignore +++ /dev/null @@ -1,5 +0,0 @@ -node_modules - -/test-results/ -/playwright-report/ -/blob-report/ diff --git a/e2e/solid-start/basic-spa/package.json b/e2e/solid-start/basic-spa/package.json deleted file mode 100644 index c9f0283736..0000000000 --- a/e2e/solid-start/basic-spa/package.json +++ /dev/null @@ -1,24 +0,0 @@ -{ - "name": "tanstack-solid-start-e2e-basic-spa", - "private": true, - "sideEffects": false, - "type": "module", - "scripts": { - "test:e2e:startDummyServer": "node -e 'import(\"../basic-test-suite/src/setup/global.setup.ts\").then(m => m.default())' & node -e 'import(\"../basic-test-suite/src/setup/waitForDummyServer.ts\").then(m => m.default())'", - "test:e2e:stopDummyServer": "node -e 'import(\"../basic-test-suite/src/setup/global.teardown.ts\").then(m => m.default())'", - "test:e2e": "rm -rf port*.txt; MODE=spa playwright test --project=chromium" - }, - "devDependencies": { - "@playwright/test": "^1.50.1", - "@tanstack/router-e2e-utils": "workspace:^", - "tanstack-solid-start-e2e-basic": "workspace:*", - "tanstack-solid-start-e2e-basic-test-suite": "workspace:*" - }, - "nx": { - "targets": { - "test:e2e": { - "parallelism": false - } - } - } -} diff --git a/e2e/solid-start/basic-spa/playwright.config.ts b/e2e/solid-start/basic-spa/playwright.config.ts deleted file mode 100644 index 27e85e1f1a..0000000000 --- a/e2e/solid-start/basic-spa/playwright.config.ts +++ /dev/null @@ -1,48 +0,0 @@ -import { defineConfig, devices } from '@playwright/test' -import { - getDummyServerPort, - getTestServerPort, -} from '@tanstack/router-e2e-utils' -import packageJson from './package.json' with { type: 'json' } - -const PORT = await getTestServerPort(packageJson.name) -const START_PORT = await getTestServerPort(`${packageJson.name}_start`) -const EXTERNAL_PORT = await getDummyServerPort(packageJson.name) -const baseURL = `http://localhost:${PORT}` - -export default defineConfig({ - testDir: '../basic-test-suite/src', - workers: 1, - reporter: [['line']], - - globalTeardown: '../basic-test-suite/src/setup/global.teardown.ts', - - use: { - baseURL, - }, - - webServer: { - command: - 'pnpm run test:e2e:startDummyServer && pnpm --dir ../basic build:spa && pnpm --dir ../basic start', - url: baseURL, - reuseExistingServer: !process.env.CI, - stdout: 'pipe', - env: { - MODE: 'spa', - VITE_NODE_ENV: 'test', - VITE_EXTERNAL_PORT: String(EXTERNAL_PORT), - VITE_SERVER_PORT: String(PORT), - START_PORT: String(START_PORT), - PORT: String(PORT), - }, - }, - - projects: [ - { - name: 'chromium', - use: { - ...devices['Desktop Chrome'], - }, - }, - ], -}) diff --git a/e2e/solid-start/basic-test-suite/.gitignore b/e2e/solid-start/basic-test-suite/.gitignore deleted file mode 100644 index 6381bf3860..0000000000 --- a/e2e/solid-start/basic-test-suite/.gitignore +++ /dev/null @@ -1,5 +0,0 @@ -node_modules - -/test-results/ -/playwright-report/ -/blob-report/ diff --git a/e2e/solid-start/basic-test-suite/package.json b/e2e/solid-start/basic-test-suite/package.json deleted file mode 100644 index 775f9fc598..0000000000 --- a/e2e/solid-start/basic-test-suite/package.json +++ /dev/null @@ -1,12 +0,0 @@ -{ - "name": "tanstack-solid-start-e2e-basic-test-suite", - "private": true, - "sideEffects": false, - "type": "module", - "devDependencies": { - "@playwright/test": "^1.50.1", - "@tanstack/router-e2e-utils": "workspace:^", - "@types/node": "^22.10.2", - "combinate": "^1.1.11" - } -} diff --git a/e2e/solid-start/basic-test-suite/src/utils/getBasicAppRoot.ts b/e2e/solid-start/basic-test-suite/src/utils/getBasicAppRoot.ts deleted file mode 100644 index 12a411989a..0000000000 --- a/e2e/solid-start/basic-test-suite/src/utils/getBasicAppRoot.ts +++ /dev/null @@ -1,8 +0,0 @@ -import { join } from 'node:path' -import { getPackageName } from './getPackageName.ts' - -export function getBasicAppRoot() { - return getPackageName().endsWith('-basic') - ? process.cwd() - : join(process.cwd(), '../basic') -} diff --git a/e2e/solid-start/basic-test-suite/src/utils/isPrerender.ts b/e2e/solid-start/basic-test-suite/src/utils/isPrerender.ts deleted file mode 100644 index d5d991d454..0000000000 --- a/e2e/solid-start/basic-test-suite/src/utils/isPrerender.ts +++ /dev/null @@ -1 +0,0 @@ -export const isPrerender: boolean = process.env.MODE === 'prerender' diff --git a/e2e/solid-start/basic-test-suite/src/utils/isPreview.ts b/e2e/solid-start/basic-test-suite/src/utils/isPreview.ts deleted file mode 100644 index 7ea362a83e..0000000000 --- a/e2e/solid-start/basic-test-suite/src/utils/isPreview.ts +++ /dev/null @@ -1 +0,0 @@ -export const isPreview: boolean = process.env.MODE === 'preview' diff --git a/e2e/solid-start/basic-test-suite/src/utils/isSpaMode.ts b/e2e/solid-start/basic-test-suite/src/utils/isSpaMode.ts deleted file mode 100644 index b4edb829a8..0000000000 --- a/e2e/solid-start/basic-test-suite/src/utils/isSpaMode.ts +++ /dev/null @@ -1 +0,0 @@ -export const isSpaMode: boolean = process.env.MODE === 'spa' diff --git a/e2e/solid-start/basic-tsr-config/package.json b/e2e/solid-start/basic-tsr-config/package.json index 66741abbec..d2ea5a2789 100644 --- a/e2e/solid-start/basic-tsr-config/package.json +++ b/e2e/solid-start/basic-tsr-config/package.json @@ -15,14 +15,14 @@ "@tanstack/solid-router": "workspace:^", "@tanstack/solid-router-devtools": "workspace:^", "@tanstack/solid-start": "workspace:^", - "solid-js": "2.0.0-beta.14", - "vite": "^8.0.0" + "solid-js": "2.0.0-beta.14" }, "devDependencies": { "@tanstack/router-e2e-utils": "workspace:^", "@types/node": "^22.10.2", "srvx": "^0.11.9", "typescript": "^6.0.2", - "vite-plugin-solid": "^3.0.0-next.5" + "vite-plugin-solid": "^3.0.0-next.5", + "vite": "^8.0.14" } } diff --git a/e2e/solid-start/basic/.gitignore b/e2e/solid-start/basic/.gitignore index a79d5cf129..b9c2c7e5f6 100644 --- a/e2e/solid-start/basic/.gitignore +++ b/e2e/solid-start/basic/.gitignore @@ -18,3 +18,4 @@ yarn.lock /playwright-report/ /blob-report/ /playwright/.cache/ +/dist-vite-*/ diff --git a/e2e/solid-start/basic/package.json b/e2e/solid-start/basic/package.json index 40f2b8b874..440d929233 100644 --- a/e2e/solid-start/basic/package.json +++ b/e2e/solid-start/basic/package.json @@ -7,27 +7,24 @@ "dev": "vite dev --port 3000", "dev:e2e": "vite dev", "build": "vite build && tsc --noEmit", - "build:spa": "MODE=spa vite build && tsc --noEmit", - "build:prerender": "MODE=prerender vite build && tsc --noEmit", "preview": "vite preview", "start": "node server.js", - "test:e2e:startDummyServer": "node -e 'import(\"../basic-test-suite/src/setup/global.setup.ts\").then(m => m.default())' & node -e 'import(\"../basic-test-suite/src/setup/waitForDummyServer.ts\").then(m => m.default())'", - "test:e2e:stopDummyServer": "node -e 'import(\"../basic-test-suite/src/setup/global.teardown.ts\").then(m => m.default())'", - "test:e2e": "rm -rf dist; rm -rf port*.txt; playwright test --project=chromium" + "test:e2e:startDummyServer": "node -e 'import(\"./tests/setup/global.setup.ts\").then(m => m.default())' & node -e 'import(\"./tests/setup/waitForDummyServer.ts\").then(m => m.default())'", + "test:e2e:stopDummyServer": "node -e 'import(\"./tests/setup/global.teardown.ts\").then(m => m.default())'", + "test:e2e:local": "playwright test --project=chromium" }, "dependencies": { "@solidjs/web": "2.0.0-beta.14", "@tanstack/solid-router": "workspace:^", "@tanstack/solid-router-devtools": "workspace:^", "@tanstack/solid-start": "workspace:^", - "express": "^5.1.0", + "express": "^5.2.1", "http-proxy-middleware": "^3.0.5", "js-cookie": "^3.0.5", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", - "tailwind-merge": "^2.6.0", - "vite": "^8.0.0", - "zod": "^3.24.2" + "tailwind-merge": "^3.6.0", + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -38,15 +35,44 @@ "combinate": "^1.1.11", "srvx": "^0.11.9", "tailwindcss": "^4.2.2", - "tanstack-solid-start-e2e-basic-test-suite": "workspace:*", "typescript": "^6.0.2", - "vite-plugin-solid": "^3.0.0-next.5" + "vite-plugin-solid": "^3.0.0-next.5", + "@rsbuild/core": "^2.0.8", + "@rsbuild/plugin-babel": "^1.1.2", + "@rsbuild/plugin-solid": "^2.0.0-beta.0", + "@tailwindcss/postcss": "^4.2.2", + "vite": "^8.0.14" }, "nx": { "targets": { "test:e2e": { "parallelism": false } + }, + "metadata": { + "playwrightModes": [ + { + "toolchain": "vite", + "mode": "ssr", + "shards": 4 + }, + { + "toolchain": "vite", + "mode": "spa" + }, + { + "toolchain": "vite", + "mode": "prerender" + }, + { + "toolchain": "vite", + "mode": "preview" + }, + { + "toolchain": "rsbuild", + "mode": "ssr" + } + ] } } } diff --git a/e2e/solid-start/basic/playwright.config.ts b/e2e/solid-start/basic/playwright.config.ts index 0bc99a1ec4..6924134cd1 100644 --- a/e2e/solid-start/basic/playwright.config.ts +++ b/e2e/solid-start/basic/playwright.config.ts @@ -1,3 +1,4 @@ +import fs from 'node:fs' import { defineConfig, devices } from '@playwright/test' import { getDummyServerPort, @@ -5,35 +6,54 @@ import { } from '@tanstack/router-e2e-utils' import packageJson from './package.json' with { type: 'json' } -const PORT = await getTestServerPort(packageJson.name) -const START_PORT = await getTestServerPort(`${packageJson.name}_start`) -const EXTERNAL_PORT = await getDummyServerPort(packageJson.name) +const mode = process.env.MODE ?? 'ssr' +const e2ePortKey = process.env.E2E_PORT_KEY ?? packageJson.name +const distDir = process.env.E2E_DIST_DIR ?? 'dist' + +if (process.env.TEST_WORKER_INDEX === undefined) { + for (const portFile of [ + `port-${e2ePortKey}.txt`, + `port-${e2ePortKey}_start.txt`, + `port-${e2ePortKey}-external.txt`, + ]) { + fs.rmSync(portFile, { force: true }) + } +} + +const PORT = await getTestServerPort(e2ePortKey) +const START_PORT = await getTestServerPort(`${e2ePortKey}_start`) +const EXTERNAL_PORT = await getDummyServerPort(e2ePortKey) const baseURL = `http://localhost:${PORT}` -const ssrModeCommand = `pnpm build && pnpm start` +const commandByMode = + mode === 'preview' + ? `pnpm run test:e2e:startDummyServer && pnpm preview --outDir ${distDir} --port ${PORT}` + : `pnpm run test:e2e:startDummyServer && pnpm start` export default defineConfig({ - testDir: '../basic-test-suite/src', + testDir: './tests', workers: 1, reporter: [['line']], - globalTeardown: '../basic-test-suite/src/setup/global.teardown.ts', + globalTeardown: './tests/setup/global.teardown.ts', use: { baseURL, }, webServer: { - command: `pnpm run test:e2e:startDummyServer && ${ssrModeCommand}`, + command: commandByMode, url: baseURL, reuseExistingServer: !process.env.CI, stdout: 'pipe', env: { - MODE: '', + MODE: mode, VITE_NODE_ENV: 'test', VITE_EXTERNAL_PORT: String(EXTERNAL_PORT), VITE_SERVER_PORT: String(PORT), START_PORT: String(START_PORT), PORT: String(PORT), + E2E_DIST_DIR: distDir, + E2E_PORT_KEY: e2ePortKey, }, }, diff --git a/e2e/solid-start/basic/postcss.config.mjs b/e2e/solid-start/basic/postcss.config.mjs new file mode 100644 index 0000000000..a7f73a2d1d --- /dev/null +++ b/e2e/solid-start/basic/postcss.config.mjs @@ -0,0 +1,5 @@ +export default { + plugins: { + '@tailwindcss/postcss': {}, + }, +} diff --git a/e2e/solid-start/basic/rsbuild.config.ts b/e2e/solid-start/basic/rsbuild.config.ts new file mode 100644 index 0000000000..ea04a3167a --- /dev/null +++ b/e2e/solid-start/basic/rsbuild.config.ts @@ -0,0 +1,21 @@ +import { defineConfig } from '@rsbuild/core' +import { pluginBabel } from '@rsbuild/plugin-babel' +import { pluginSolid } from '@rsbuild/plugin-solid' +import { tanstackStart } from '@tanstack/solid-start/plugin/rsbuild' + +const outDir = process.env.E2E_DIST_DIR ?? 'dist' + +export default defineConfig({ + plugins: [ + pluginBabel({ + include: /\.(?:jsx|tsx)$/, + }), + pluginSolid(), + tanstackStart(), + ], + output: { + distPath: { + root: outDir, + }, + }, +}) diff --git a/e2e/solid-start/basic/server.js b/e2e/solid-start/basic/server.js index 83f5ff0079..69c1e4ca91 100644 --- a/e2e/solid-start/basic/server.js +++ b/e2e/solid-start/basic/server.js @@ -1,4 +1,5 @@ import { toNodeHandler } from 'srvx/node' +import fs from 'node:fs' import path from 'node:path' import express from 'express' import { createProxyMiddleware } from 'http-proxy-middleware' @@ -9,16 +10,33 @@ const startPort = process.env.START_PORT || 3001 const isSpaMode = process.env.MODE === 'spa' const isPrerender = process.env.MODE === 'prerender' +const distDir = process.env.E2E_DIST_DIR || 'dist' +const distClientDir = path.resolve(distDir, 'client') + +function resolveDistServerEntryPath() { + const serverJsPath = path.resolve(distDir, 'server', 'server.js') + if (fs.existsSync(serverJsPath)) { + return serverJsPath + } + + const indexJsPath = path.resolve(distDir, 'server', 'index.js') + if (fs.existsSync(indexJsPath)) { + return indexJsPath + } + + return serverJsPath +} export async function createStartServer() { - const server = (await import('./dist/server/server.js')).default + const distServerEntryPath = resolveDistServerEntryPath() + const server = (await import(distServerEntryPath)).default const nodeHandler = toNodeHandler(server.fetch) const app = express() // to keep testing uniform stop express from redirecting /posts to /posts/ // when serving pre-rendered pages - app.use(express.static('./dist/client', { redirect: !isPrerender })) + app.use(express.static(distClientDir, { redirect: !isPrerender })) app.use(async (req, res, next) => { try { @@ -50,10 +68,10 @@ export async function createSpaServer() { }), ) - app.use(express.static('./dist/client')) + app.use(express.static(distClientDir)) app.get('/{*splat}', (req, res) => { - res.sendFile(path.resolve('./dist/client/index.html')) + res.sendFile(path.resolve(distClientDir, 'index.html')) }) return { app } @@ -61,19 +79,22 @@ export async function createSpaServer() { if (isSpaMode) { createSpaServer().then(async ({ app }) => - app.listen(port, () => { + app.listen(port, (error) => { + if (error) throw error console.info(`Client Server: http://localhost:${port}`) }), ) createStartServer().then(async ({ app }) => - app.listen(startPort, () => { + app.listen(startPort, (error) => { + if (error) throw error console.info(`Start Server: http://localhost:${startPort}`) }), ) } else { createStartServer().then(async ({ app }) => - app.listen(port, () => { + app.listen(port, (error) => { + if (error) throw error console.info(`Start Server: http://localhost:${port}`) }), ) diff --git a/e2e/solid-start/basic/src/routeTree.gen.ts b/e2e/solid-start/basic/src/routeTree.gen.ts index c8cecb85b1..c9fba32156 100644 --- a/e2e/solid-start/basic/src/routeTree.gen.ts +++ b/e2e/solid-start/basic/src/routeTree.gen.ts @@ -16,6 +16,7 @@ import { Route as RawStreamRouteImport } from './routes/raw-stream' import { Route as PostsRouteImport } from './routes/posts' import { Route as LinksRouteImport } from './routes/links' import { Route as InlineScriptsRouteImport } from './routes/inline-scripts' +import { Route as DeferredWithoutSuspenseRouteImport } from './routes/deferred-without-suspense' import { Route as DeferredRouteImport } from './routes/deferred' import { Route as LayoutRouteImport } from './routes/_layout' import { Route as SpecialCharsRouteRouteImport } from './routes/specialChars/route' @@ -104,6 +105,11 @@ const InlineScriptsRoute = InlineScriptsRouteImport.update({ path: '/inline-scripts', getParentRoute: () => rootRouteImport, } as any) +const DeferredWithoutSuspenseRoute = DeferredWithoutSuspenseRouteImport.update({ + id: '/deferred-without-suspense', + path: '/deferred-without-suspense', + getParentRoute: () => rootRouteImport, +} as any) const DeferredRoute = DeferredRouteImport.update({ id: '/deferred', path: '/deferred', @@ -386,6 +392,7 @@ export interface FileRoutesByFullPath { '/search-params': typeof SearchParamsRouteRouteWithChildren '/specialChars': typeof SpecialCharsRouteRouteWithChildren '/deferred': typeof DeferredRoute + '/deferred-without-suspense': typeof DeferredWithoutSuspenseRoute '/inline-scripts': typeof InlineScriptsRoute '/links': typeof LinksRoute '/posts': typeof PostsRouteWithChildren @@ -443,6 +450,7 @@ export interface FileRoutesByTo { '/': typeof IndexRoute '/specialChars': typeof SpecialCharsRouteRouteWithChildren '/deferred': typeof DeferredRoute + '/deferred-without-suspense': typeof DeferredWithoutSuspenseRoute '/inline-scripts': typeof InlineScriptsRoute '/links': typeof LinksRoute '/scripts': typeof ScriptsRoute @@ -500,6 +508,7 @@ export interface FileRoutesById { '/specialChars': typeof SpecialCharsRouteRouteWithChildren '/_layout': typeof LayoutRouteWithChildren '/deferred': typeof DeferredRoute + '/deferred-without-suspense': typeof DeferredWithoutSuspenseRoute '/inline-scripts': typeof InlineScriptsRoute '/links': typeof LinksRoute '/posts': typeof PostsRouteWithChildren @@ -562,6 +571,7 @@ export interface FileRouteTypes { | '/search-params' | '/specialChars' | '/deferred' + | '/deferred-without-suspense' | '/inline-scripts' | '/links' | '/posts' @@ -619,6 +629,7 @@ export interface FileRouteTypes { | '/' | '/specialChars' | '/deferred' + | '/deferred-without-suspense' | '/inline-scripts' | '/links' | '/scripts' @@ -675,6 +686,7 @@ export interface FileRouteTypes { | '/specialChars' | '/_layout' | '/deferred' + | '/deferred-without-suspense' | '/inline-scripts' | '/links' | '/posts' @@ -737,6 +749,7 @@ export interface RootRouteChildren { SpecialCharsRouteRoute: typeof SpecialCharsRouteRouteWithChildren LayoutRoute: typeof LayoutRouteWithChildren DeferredRoute: typeof DeferredRoute + DeferredWithoutSuspenseRoute: typeof DeferredWithoutSuspenseRoute InlineScriptsRoute: typeof InlineScriptsRoute LinksRoute: typeof LinksRoute PostsRoute: typeof PostsRouteWithChildren @@ -805,6 +818,13 @@ declare module '@tanstack/solid-router' { preLoaderRoute: typeof InlineScriptsRouteImport parentRoute: typeof rootRouteImport } + '/deferred-without-suspense': { + id: '/deferred-without-suspense' + path: '/deferred-without-suspense' + fullPath: '/deferred-without-suspense' + preLoaderRoute: typeof DeferredWithoutSuspenseRouteImport + parentRoute: typeof rootRouteImport + } '/deferred': { id: '/deferred' path: '/deferred' @@ -1377,6 +1397,7 @@ const rootRouteChildren: RootRouteChildren = { SpecialCharsRouteRoute: SpecialCharsRouteRouteWithChildren, LayoutRoute: LayoutRouteWithChildren, DeferredRoute: DeferredRoute, + DeferredWithoutSuspenseRoute: DeferredWithoutSuspenseRoute, InlineScriptsRoute: InlineScriptsRoute, LinksRoute: LinksRoute, PostsRoute: PostsRouteWithChildren, diff --git a/e2e/solid-start/basic/src/routes/__root.tsx b/e2e/solid-start/basic/src/routes/__root.tsx index 7f0c2280a0..8c5f59296b 100644 --- a/e2e/solid-start/basic/src/routes/__root.tsx +++ b/e2e/solid-start/basic/src/routes/__root.tsx @@ -1,14 +1,16 @@ /// import { + ClientOnly, HeadContent, Link, Outlet, Scripts, createRootRoute, + useRouterState, } from '@tanstack/solid-router' import { NotFound } from '~/components/NotFound' -import appCss from '~/styles/app.css?url' +import '~/styles/app.css' import { seo } from '~/utils/seo' export const Route = createRootRoute({ @@ -25,7 +27,6 @@ export const Route = createRootRoute({ }), ], links: [ - { rel: 'stylesheet', href: appCss }, { rel: 'apple-touch-icon', sizes: '180x180', @@ -64,6 +65,10 @@ export const Route = createRootRoute({ }) function RootComponent() { + const routerState = useRouterState({ + select: (state) => ({ isLoading: state.isLoading, status: state.status }), + }) + return ( @@ -154,6 +159,14 @@ function RootComponent() { This Route Does Not Exist
    + + +
    This is an inline styled div
    {/* */} diff --git a/e2e/solid-start/basic/src/routes/deferred-without-suspense.tsx b/e2e/solid-start/basic/src/routes/deferred-without-suspense.tsx new file mode 100644 index 0000000000..1238bea151 --- /dev/null +++ b/e2e/solid-start/basic/src/routes/deferred-without-suspense.tsx @@ -0,0 +1,33 @@ +import { Await, createFileRoute } from '@tanstack/solid-router' +import { createServerFn } from '@tanstack/solid-start' + +const promise = createServerFn().handler(async () => { + await new Promise((r) => setTimeout(r, 3000)) + return crypto.randomUUID() +}) + +export const Route = createFileRoute('/deferred-without-suspense')({ + component: RouteComponent, + loader() { + return { promise: promise() } + }, +}) + +function RouteComponent() { + const data = Route.useLoaderData() + return ( + <> + data{' '} + Loading...

    + } + promise={data().promise} + > + {(data) => ( + {data} + )} +
    + + ) +} diff --git a/e2e/solid-start/basic-test-suite/src/navigation.spec.ts b/e2e/solid-start/basic/tests/navigation.spec.ts similarity index 100% rename from e2e/solid-start/basic-test-suite/src/navigation.spec.ts rename to e2e/solid-start/basic/tests/navigation.spec.ts diff --git a/e2e/solid-start/basic-test-suite/src/not-found.spec.ts b/e2e/solid-start/basic/tests/not-found.spec.ts similarity index 100% rename from e2e/solid-start/basic-test-suite/src/not-found.spec.ts rename to e2e/solid-start/basic/tests/not-found.spec.ts diff --git a/e2e/solid-start/basic-test-suite/src/prerendering.spec.ts b/e2e/solid-start/basic/tests/prerendering.spec.ts similarity index 90% rename from e2e/solid-start/basic-test-suite/src/prerendering.spec.ts rename to e2e/solid-start/basic/tests/prerendering.spec.ts index 66cc1f68ff..ddcf720a4c 100644 --- a/e2e/solid-start/basic-test-suite/src/prerendering.spec.ts +++ b/e2e/solid-start/basic/tests/prerendering.spec.ts @@ -3,15 +3,18 @@ import { join } from 'node:path' import { expect } from '@playwright/test' import { test } from '@tanstack/router-e2e-utils' import { isPrerender } from './utils/isPrerender' -import { getBasicAppRoot } from './utils/getBasicAppRoot' + +const distDir = join( + process.cwd(), + process.env.E2E_DIST_DIR ?? 'dist', + 'client', +) test.describe('Prerender Static Path Discovery', () => { test.skip(!isPrerender, 'Skipping since not in prerender mode') test.describe('Build Output Verification', () => { test('should automatically discover and prerender static routes', () => { // Check that static routes were automatically discovered and prerendered - const distDir = join(getBasicAppRoot(), 'dist', 'client') - // These static routes should be automatically discovered and prerendered expect(existsSync(join(distDir, 'index.html'))).toBe(true) expect(existsSync(join(distDir, 'posts/index.html'))).toBe(true) @@ -35,7 +38,6 @@ test.describe('Prerender Static Path Discovery', () => { test.describe('Static Files Verification', () => { test('should contain prerendered content in posts.html', () => { - const distDir = join(getBasicAppRoot(), 'dist', 'client') expect(existsSync(join(distDir, 'posts/index.html'))).toBe(true) // "Select a post." should be in the prerendered HTML diff --git a/e2e/vue-start/basic-test-suite/src/redirect.spec.ts b/e2e/solid-start/basic/tests/redirect.spec.ts similarity index 86% rename from e2e/vue-start/basic-test-suite/src/redirect.spec.ts rename to e2e/solid-start/basic/tests/redirect.spec.ts index c25a6b0dbf..2f6354aa81 100644 --- a/e2e/vue-start/basic-test-suite/src/redirect.spec.ts +++ b/e2e/solid-start/basic/tests/redirect.spec.ts @@ -1,19 +1,32 @@ import queryString from 'node:querystring' -import { expect } from '@playwright/test' +import { expect, type Page } from '@playwright/test' import combinateImport from 'combinate' import { getDummyServerPort, getTestServerPort, test, } from '@tanstack/router-e2e-utils' -import { getPackageName } from './utils/getPackageName.ts' +import { getE2EPortKey } from './utils/getE2EPortKey.ts' // somehow playwright does not correctly import default exports const combinate = (combinateImport as any).default as typeof combinateImport -const packageName = getPackageName() -const PORT = await getTestServerPort(packageName) -const EXTERNAL_HOST_PORT = await getDummyServerPort(packageName) +const e2ePortKey = getE2EPortKey() +const PORT = await getTestServerPort(e2ePortKey) +const EXTERNAL_HOST_PORT = await getDummyServerPort(e2ePortKey) +const POSTS_URL = `http://localhost:${PORT}/posts` + +async function waitForRouterIdle(page: Page) { + await expect(page.getByTestId('router-isLoading')).toHaveText('false') + await expect(page.getByTestId('router-status')).toHaveText('idle') +} + +async function waitForPostsIndex(page: Page) { + await page.waitForURL(POSTS_URL) + expect(page.url()).toBe(POSTS_URL) + await waitForRouterIdle(page) + await expect(page.getByTestId('PostsIndexComponent')).toBeInViewport() +} test.describe('redirects', () => { const internalNavigationTestMatrix = combinate({ @@ -34,7 +47,7 @@ test.describe('redirects', () => { `via-${thrower}${reloadDocument ? '-reloadDocument' : ''}`, ) - await page.waitForLoadState('networkidle') + await waitForRouterIdle(page) let requestHappened = false const requestPromise = new Promise((resolve) => { @@ -62,11 +75,7 @@ test.describe('redirects', () => { await link.click() - const url = `http://localhost:${PORT}/posts` - - await page.waitForURL(url) - expect(page.url()).toBe(url) - await expect(page.getByTestId('PostsIndexComponent')).toBeInViewport() + await waitForPostsIndex(page) expect(fullPageLoad).toBe(reloadDocument) }) }, @@ -83,12 +92,7 @@ test.describe('redirects', () => { }) => { await page.goto(`/redirect/internal/via-${thrower}`) - const url = `http://localhost:${PORT}/posts` - - await page.waitForURL(url) - expect(page.url()).toBe(url) - await page.waitForLoadState('networkidle') - await expect(page.getByTestId('PostsIndexComponent')).toBeInViewport() + await waitForPostsIndex(page) }) }) @@ -107,7 +111,7 @@ test.describe('redirects', () => { if (scenario === 'navigate') { await page.goto(`/redirect/external?${q}`) - await page.waitForLoadState('networkidle') + await waitForRouterIdle(page) const link = page.getByTestId(`via-${thrower}`) await link.focus() await link.click() @@ -142,7 +146,7 @@ test.describe('redirects', () => { if (scenario === 'navigate') { await page.goto(`/redirect/${target}/serverFn?${q}`) - await page.waitForLoadState('networkidle') + await waitForRouterIdle(page) const link = page.getByTestId( `via-${thrower}${reloadDocument ? '-reloadDocument' : ''}`, ) @@ -157,11 +161,12 @@ test.describe('redirects', () => { const url = target === 'internal' - ? `http://localhost:${PORT}/posts` + ? POSTS_URL : `http://localhost:${EXTERNAL_HOST_PORT}/` await page.waitForURL(url) expect(page.url()).toBe(url) if (target === 'internal' && scenario === 'navigate') { + await waitForRouterIdle(page) await expect(page.getByTestId('PostsIndexComponent')).toBeInViewport() expect(fullPageLoad).toBe(reloadDocument) } @@ -185,7 +190,7 @@ test.describe('redirects', () => { await page.goto(`/redirect/${target}/serverFn/via-useServerFn?${q}`) - await page.waitForLoadState('networkidle') + await waitForRouterIdle(page) const button = page.getByTestId('redirect-on-click') @@ -198,11 +203,12 @@ test.describe('redirects', () => { const url = target === 'internal' - ? `http://localhost:${PORT}/posts` + ? POSTS_URL : `http://localhost:${EXTERNAL_HOST_PORT}/` await page.waitForURL(url) expect(page.url()).toBe(url) if (target === 'internal') { + await waitForRouterIdle(page) await expect(page.getByTestId('PostsIndexComponent')).toBeInViewport() expect(fullPageLoad).toBe(reloadDocument) } diff --git a/e2e/solid-start/basic-test-suite/src/script-duplication.spec.ts b/e2e/solid-start/basic/tests/script-duplication.spec.ts similarity index 100% rename from e2e/solid-start/basic-test-suite/src/script-duplication.spec.ts rename to e2e/solid-start/basic/tests/script-duplication.spec.ts diff --git a/e2e/solid-start/basic-test-suite/src/search-params.spec.ts b/e2e/solid-start/basic/tests/search-params.spec.ts similarity index 100% rename from e2e/solid-start/basic-test-suite/src/search-params.spec.ts rename to e2e/solid-start/basic/tests/search-params.spec.ts diff --git a/e2e/vue-start/basic-test-suite/src/setup/global.setup.ts b/e2e/solid-start/basic/tests/setup/global.setup.ts similarity index 50% rename from e2e/vue-start/basic-test-suite/src/setup/global.setup.ts rename to e2e/solid-start/basic/tests/setup/global.setup.ts index fc06a65591..cd38c35885 100644 --- a/e2e/vue-start/basic-test-suite/src/setup/global.setup.ts +++ b/e2e/solid-start/basic/tests/setup/global.setup.ts @@ -1,6 +1,6 @@ import { e2eStartDummyServer } from '@tanstack/router-e2e-utils' -import { getPackageName } from '../utils/getPackageName.ts' +import { getE2EPortKey } from '../utils/getE2EPortKey.ts' export default async function setup() { - await e2eStartDummyServer(getPackageName()) + await e2eStartDummyServer(getE2EPortKey()) } diff --git a/e2e/solid-start/basic-test-suite/src/setup/global.teardown.ts b/e2e/solid-start/basic/tests/setup/global.teardown.ts similarity index 55% rename from e2e/solid-start/basic-test-suite/src/setup/global.teardown.ts rename to e2e/solid-start/basic/tests/setup/global.teardown.ts index a8a6899700..36e5c92858 100644 --- a/e2e/solid-start/basic-test-suite/src/setup/global.teardown.ts +++ b/e2e/solid-start/basic/tests/setup/global.teardown.ts @@ -1,8 +1,8 @@ import { e2eStopDummyServer } from '@tanstack/router-e2e-utils' -import { getPackageName } from '../utils/getPackageName.ts' +import { getE2EPortKey } from '../utils/getE2EPortKey.ts' export default async function teardown() { try { - await e2eStopDummyServer(getPackageName()) + await e2eStopDummyServer(getE2EPortKey()) } catch {} } diff --git a/e2e/solid-start/basic-test-suite/src/setup/waitForDummyServer.ts b/e2e/solid-start/basic/tests/setup/waitForDummyServer.ts similarity index 82% rename from e2e/solid-start/basic-test-suite/src/setup/waitForDummyServer.ts rename to e2e/solid-start/basic/tests/setup/waitForDummyServer.ts index f27dc86d5b..88c18fd79e 100644 --- a/e2e/solid-start/basic-test-suite/src/setup/waitForDummyServer.ts +++ b/e2e/solid-start/basic/tests/setup/waitForDummyServer.ts @@ -1,11 +1,11 @@ import { getDummyServerPort } from '@tanstack/router-e2e-utils' -import { getPackageName } from '../utils/getPackageName.ts' +import { getE2EPortKey } from '../utils/getE2EPortKey.ts' const timeoutMs = 10_000 const retryIntervalMs = 100 export default async function waitForDummyServer() { - const port = await getDummyServerPort(getPackageName()) + const port = await getDummyServerPort(getE2EPortKey()) const deadline = Date.now() + timeoutMs while (Date.now() < deadline) { diff --git a/e2e/solid-start/basic-test-suite/src/special-characters.spec.ts b/e2e/solid-start/basic/tests/special-characters.spec.ts similarity index 91% rename from e2e/solid-start/basic-test-suite/src/special-characters.spec.ts rename to e2e/solid-start/basic/tests/special-characters.spec.ts index 46b8f5ac72..73ee43aae4 100644 --- a/e2e/solid-start/basic-test-suite/src/special-characters.spec.ts +++ b/e2e/solid-start/basic/tests/special-characters.spec.ts @@ -192,6 +192,12 @@ test.describe('Unicode route rendering', () => { }) test.describe('malformed paths', () => { + const malformedPathnames = [ + '/specialChars/malformed/%E0%A4', + '/specialChars/malformed/%80', + '/specialChars/malformed/%FF', + ] + test.use({ whitelistErrors: [ 'Failed to load resource: the server responded with a status of 404', @@ -199,24 +205,22 @@ test.describe('Unicode route rendering', () => { ], }) - test('un-matched malformed paths should return not found on direct navigation', async ({ - page, - }) => { - const res = await page.goto('/specialChars/malformed/%E0%A4') + for (const pathname of malformedPathnames) { + test(`un-matched malformed path "${pathname}" should return bad request on direct navigation`, async ({ + page, + }) => { + const res = await page.goto(pathname) - await page.waitForLoadState(`load`) + await page.waitForLoadState(`load`) - // in spa mode this is caught and handled at server level - if (!isSpaMode) { - expect(res!.status()).toBe(404) - - await expect( - page.getByTestId('default-not-found-component'), - ).toBeInViewport() - } else { - expect(res!.status()).toBe(400) - } - }) + // in spa mode this is caught and handled at server level + if (!isSpaMode) { + expect(res!.status()).toBe(400) + } else { + expect(res!.status()).toBe(400) + } + }) + } test('malformed path params should return not found on router link', async ({ page, diff --git a/e2e/solid-start/basic-test-suite/src/streaming.spec.ts b/e2e/solid-start/basic/tests/streaming.spec.ts similarity index 69% rename from e2e/solid-start/basic-test-suite/src/streaming.spec.ts rename to e2e/solid-start/basic/tests/streaming.spec.ts index 15f60b7deb..6e938a96da 100644 --- a/e2e/solid-start/basic-test-suite/src/streaming.spec.ts +++ b/e2e/solid-start/basic/tests/streaming.spec.ts @@ -1,5 +1,6 @@ import { expect } from '@playwright/test' import { test } from '@tanstack/router-e2e-utils' +import { isSpaMode } from './utils/isSpaMode' test('Navigating to deferred route', async ({ page }) => { await page.goto('/') @@ -33,3 +34,17 @@ test('streaming loader data', async ({ page }) => { await expect(page.getByTestId('promise-data')).toContainText('promise-data') await expect(page.getByTestId('stream-data')).toContainText('stream-data') }) + +test('streams Await fallback for server function loader promises', async ({ + page, +}) => { + test.skip(isSpaMode, 'SPA mode does not render streamed SSR HTML') + + await page.goto('/deferred-without-suspense', { waitUntil: 'commit' }) + await expect( + page.getByTestId('deferred-without-suspense-loading'), + ).toBeVisible() + await expect( + page.getByTestId('deferred-without-suspense-data').first(), + ).not.toBeEmpty() +}) diff --git a/e2e/solid-start/basic-test-suite/src/transition.spec.ts b/e2e/solid-start/basic/tests/transition.spec.ts similarity index 100% rename from e2e/solid-start/basic-test-suite/src/transition.spec.ts rename to e2e/solid-start/basic/tests/transition.spec.ts diff --git a/e2e/solid-start/basic/tests/utils/getE2EPortKey.ts b/e2e/solid-start/basic/tests/utils/getE2EPortKey.ts new file mode 100644 index 0000000000..48be6a9027 --- /dev/null +++ b/e2e/solid-start/basic/tests/utils/getE2EPortKey.ts @@ -0,0 +1,5 @@ +import { getPackageName } from './getPackageName.ts' + +export function getE2EPortKey() { + return process.env.E2E_PORT_KEY ?? getPackageName() +} diff --git a/e2e/solid-start/basic-test-suite/src/utils/getPackageName.ts b/e2e/solid-start/basic/tests/utils/getPackageName.ts similarity index 100% rename from e2e/solid-start/basic-test-suite/src/utils/getPackageName.ts rename to e2e/solid-start/basic/tests/utils/getPackageName.ts diff --git a/e2e/solid-start/basic/tsconfig.json b/e2e/solid-start/basic/tsconfig.json index 5f3e565e5a..ab070bd50b 100644 --- a/e2e/solid-start/basic/tsconfig.json +++ b/e2e/solid-start/basic/tsconfig.json @@ -9,6 +9,7 @@ "moduleResolution": "Bundler", "lib": ["DOM", "DOM.Iterable", "ES2022"], "isolatedModules": true, + "allowImportingTsExtensions": true, "resolveJsonModule": true, "skipLibCheck": true, "target": "ES2022", diff --git a/e2e/solid-start/basic/vite.config.ts b/e2e/solid-start/basic/vite.config.ts index 3cca892d57..9e26483d04 100644 --- a/e2e/solid-start/basic/vite.config.ts +++ b/e2e/solid-start/basic/vite.config.ts @@ -30,8 +30,13 @@ const prerenderConfiguration = { maxRedirects: 100, } +const outDir = process.env.E2E_DIST_DIR ?? 'dist' + export default defineConfig({ resolve: { tsconfigPaths: true }, + build: { + outDir, + }, server: { port: 3000, }, diff --git a/e2e/solid-start/csp/package.json b/e2e/solid-start/csp/package.json index 093acfea28..e83cfa0652 100644 --- a/e2e/solid-start/csp/package.json +++ b/e2e/solid-start/csp/package.json @@ -14,8 +14,7 @@ "@solidjs/web": "2.0.0-beta.14", "@tanstack/solid-router": "workspace:^", "@tanstack/solid-start": "workspace:^", - "solid-js": "2.0.0-beta.14", - "vite": "^8.0.0" + "solid-js": "2.0.0-beta.14" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -23,6 +22,7 @@ "@types/node": "^22.10.2", "srvx": "^0.11.9", "typescript": "^6.0.2", - "vite-plugin-solid": "^3.0.0-next.5" + "vite-plugin-solid": "^3.0.0-next.5", + "vite": "^8.0.14" } } diff --git a/e2e/solid-start/csp/tests/csp.spec.ts b/e2e/solid-start/csp/tests/csp.spec.ts index 247f3b5965..f299e73399 100644 --- a/e2e/solid-start/csp/tests/csp.spec.ts +++ b/e2e/solid-start/csp/tests/csp.spec.ts @@ -1,6 +1,21 @@ -import { expect } from '@playwright/test' +import { expect, type Page } from '@playwright/test' import { test } from '@tanstack/router-e2e-utils' +async function getRawHtml(page: Page) { + let rawHtml = '' + + await page.route('/', async (route) => { + const response = await route.fetch() + rawHtml = await response.text() + await route.fulfill({ response, body: rawHtml }) + }) + + const response = await page.goto('/') + await page.unrouteAll({ behavior: 'ignoreErrors' }) + + return { rawHtml, response } +} + test('CSP header is set with nonce', async ({ page }) => { const response = await page.goto('/') const csp = response?.headers()['content-security-policy'] @@ -21,9 +36,10 @@ test('Inline styles have nonce attribute', async ({ page }) => { }) test('External script has nonce attribute', async ({ page }) => { - await page.goto('/') - const externalScript = page.locator('script[src="/external.js"]') - await expect(externalScript).toHaveAttribute('nonce') + const { rawHtml } = await getRawHtml(page) + expect(rawHtml).toMatch( + /]*\bsrc="\/external\.js")(?=[^>]*\bnonce="[^"]+")[^>]*>/, + ) }) test('External stylesheet has nonce attribute', async ({ page }) => { @@ -34,15 +50,7 @@ test('External stylesheet has nonce attribute', async ({ page }) => { test('Nonces match between header and elements', async ({ page }) => { // Intercept the HTML response to get raw content before browser strips nonces - let rawHtml = '' - await page.route('/', async (route) => { - const response = await route.fetch() - rawHtml = await response.text() - await route.fulfill({ response }) - }) - - const response = await page.goto('/') - await page.unrouteAll({ behavior: 'ignoreErrors' }) + const { rawHtml, response } = await getRawHtml(page) const csp = response?.headers()['content-security-policy'] || '' diff --git a/e2e/solid-start/css-modules/package.json b/e2e/solid-start/css-modules/package.json index 63ea2d8182..afae9ff0ee 100644 --- a/e2e/solid-start/css-modules/package.json +++ b/e2e/solid-start/css-modules/package.json @@ -26,7 +26,7 @@ "sass": "^1.97.2", "srvx": "^0.11.9", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5", "vite-tsconfig-paths": "^5.1.4" } diff --git a/e2e/solid-start/custom-basepath/express-server.ts b/e2e/solid-start/custom-basepath/express-server.ts index 87dcfb50da..1884c5eb5a 100644 --- a/e2e/solid-start/custom-basepath/express-server.ts +++ b/e2e/solid-start/custom-basepath/express-server.ts @@ -40,6 +40,7 @@ if (DEVELOPMENT) { }) } -app.listen(PORT, () => { +app.listen(PORT, (error) => { + if (error) throw error console.log(`Server is running on http://localhost:${PORT}`) }) diff --git a/e2e/solid-start/custom-basepath/package.json b/e2e/solid-start/custom-basepath/package.json index 7ba3ea7439..598e973a59 100644 --- a/e2e/solid-start/custom-basepath/package.json +++ b/e2e/solid-start/custom-basepath/package.json @@ -5,7 +5,7 @@ "type": "module", "scripts": { "dev": "cross-env NODE_ENV=development tsx express-server.ts", - "build": "vite build", + "build": "vite build && tsc --noEmit", "preview": "vite preview", "start": "tsx express-server.ts", "test:e2e": "rm -rf port*.txt; playwright test --project=chromium" @@ -15,7 +15,7 @@ "@tanstack/solid-router": "workspace:^", "@tanstack/solid-router-devtools": "workspace:^", "@tanstack/solid-start": "workspace:^", - "express": "^5.1.0", + "express": "^5.2.1", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14" }, @@ -23,14 +23,14 @@ "@playwright/test": "^1.50.1", "@tailwindcss/vite": "^4.2.2", "@tanstack/router-e2e-utils": "workspace:^", - "@types/express": "^5.0.3", + "@types/express": "^5.0.6", "@types/node": "^22.10.2", "cross-env": "^10.0.0", "srvx": "^0.11.9", "tailwindcss": "^4.2.2", "tsx": "^4.20.3", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5", "vite-tsconfig-paths": "^5.1.4" } diff --git a/e2e/solid-start/deferred-hydration/.gitignore b/e2e/solid-start/deferred-hydration/.gitignore new file mode 100644 index 0000000000..1b3a07ede1 --- /dev/null +++ b/e2e/solid-start/deferred-hydration/.gitignore @@ -0,0 +1,15 @@ +node_modules +package-lock.json +yarn.lock +.DS_Store +.cache +.env +.vercel +.output +/build/ +/api/ +/server/build +/test-results/ +/playwright-report/ +/blob-report/ +/playwright/.cache/ diff --git a/e2e/solid-start/deferred-hydration/package.json b/e2e/solid-start/deferred-hydration/package.json new file mode 100644 index 0000000000..bc996d075e --- /dev/null +++ b/e2e/solid-start/deferred-hydration/package.json @@ -0,0 +1,56 @@ +{ + "name": "tanstack-solid-start-e2e-deferred-hydration", + "private": true, + "sideEffects": false, + "type": "module", + "scripts": { + "dev": "pnpm dev:vite --port 3000", + "dev:e2e": "pnpm dev:vite", + "dev:vite": "vite dev", + "dev:rsbuild": "rsbuild dev", + "build": "pnpm build:vite", + "build:vite": "vite build && tsc --noEmit", + "build:rsbuild": "rsbuild build && tsc --noEmit", + "preview": "vite preview", + "start": "pnpm start:vite", + "start:vite": "srvx --prod --dir=. -s dist-vite-ssr/client --entry dist-vite-ssr/server/server.js", + "start:rsbuild": "srvx --prod --dir=. -s dist-rsbuild-ssr/client --entry dist-rsbuild-ssr/server/index.js", + "test:e2e": "playwright test --project=chromium" + }, + "dependencies": { + "@solidjs/web": "2.0.0-beta.14", + "@tanstack/solid-router": "workspace:^", + "@tanstack/solid-start": "workspace:^", + "solid-js": "2.0.0-beta.14" + }, + "devDependencies": { + "@rsbuild/core": "^2.0.1", + "@rsbuild/plugin-babel": "^1.1.2", + "@rsbuild/plugin-solid": "^2.0.0-beta.0", + "@tanstack/router-e2e-utils": "workspace:^", + "@types/node": "^22.10.2", + "srvx": "^0.11.9", + "typescript": "^6.0.2", + "vite": "^8.0.14", + "vite-plugin-solid": "^3.0.0-next.5" + }, + "nx": { + "targets": { + "test:e2e": { + "parallelism": false + } + }, + "metadata": { + "playwrightModes": [ + { + "toolchain": "vite", + "mode": "ssr" + }, + { + "toolchain": "rsbuild", + "mode": "ssr" + } + ] + } + } +} diff --git a/e2e/solid-start/deferred-hydration/playwright.config.ts b/e2e/solid-start/deferred-hydration/playwright.config.ts new file mode 100644 index 0000000000..ea9e73a856 --- /dev/null +++ b/e2e/solid-start/deferred-hydration/playwright.config.ts @@ -0,0 +1,43 @@ +import fs from 'node:fs' +import { defineConfig, devices } from '@playwright/test' +import { getTestServerPort } from '@tanstack/router-e2e-utils' +import packageJson from './package.json' with { type: 'json' } + +const toolchain = process.env.E2E_TOOLCHAIN ?? 'vite' +const distDir = process.env.E2E_DIST_DIR ?? `dist-${toolchain}-ssr` +const e2ePortKey = + process.env.E2E_PORT_KEY ?? `${packageJson.name}-${toolchain}` +const serverEntryFile = toolchain === 'rsbuild' ? 'index.js' : 'server.js' +const startCommand = `pnpm exec srvx --prod --dir=. -s ${distDir}/client --entry ${distDir}/server/${serverEntryFile}` + +if (process.env.TEST_WORKER_INDEX === undefined) { + fs.rmSync(`port-${e2ePortKey}.txt`, { force: true }) +} + +const PORT = await getTestServerPort(e2ePortKey) +const baseURL = `http://localhost:${PORT}` + +export default defineConfig({ + testDir: './tests', + workers: 1, + reporter: [['line']], + use: { baseURL }, + webServer: { + command: startCommand, + url: baseURL, + reuseExistingServer: !process.env.CI, + stdout: 'pipe', + env: { + E2E_DIST_DIR: distDir, + NODE_ENV: 'production', + PORT: String(PORT), + VITE_SERVER_PORT: String(PORT), + }, + }, + projects: [ + { + name: 'chromium', + use: { ...devices['Desktop Chrome'] }, + }, + ], +}) diff --git a/e2e/solid-start/deferred-hydration/rsbuild.config.ts b/e2e/solid-start/deferred-hydration/rsbuild.config.ts new file mode 100644 index 0000000000..7ab152bb58 --- /dev/null +++ b/e2e/solid-start/deferred-hydration/rsbuild.config.ts @@ -0,0 +1,21 @@ +import { defineConfig } from '@rsbuild/core' +import { pluginBabel } from '@rsbuild/plugin-babel' +import { pluginSolid } from '@rsbuild/plugin-solid' +import { tanstackStart } from '@tanstack/solid-start/plugin/rsbuild' + +const outDir = process.env.E2E_DIST_DIR ?? 'dist-rsbuild-ssr' + +export default defineConfig({ + plugins: [ + pluginBabel({ + include: /\.(?:jsx|tsx)$/, + }), + pluginSolid(), + tanstackStart(), + ], + output: { + distPath: { + root: outDir, + }, + }, +}) diff --git a/e2e/solid-start/deferred-hydration/src/routeTree.gen.ts b/e2e/solid-start/deferred-hydration/src/routeTree.gen.ts new file mode 100644 index 0000000000..e75225b500 --- /dev/null +++ b/e2e/solid-start/deferred-hydration/src/routeTree.gen.ts @@ -0,0 +1,140 @@ +/* eslint-disable */ + +// @ts-nocheck + +// noinspection JSUnusedGlobalSymbols + +// This file was automatically generated by TanStack Router. +// You should NOT make any changes in this file as it will be overwritten. +// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. + +import { Route as rootRouteImport } from './routes/__root' +import { Route as ImportedRouteImport } from './routes/imported' +import { Route as EnhancedRouteImport } from './routes/enhanced' +import { Route as CssRouteImport } from './routes/css' +import { Route as ComponentsRouteImport } from './routes/components' +import { Route as IndexRouteImport } from './routes/index' + +const ImportedRoute = ImportedRouteImport.update({ + id: '/imported', + path: '/imported', + getParentRoute: () => rootRouteImport, +} as any) +const EnhancedRoute = EnhancedRouteImport.update({ + id: '/enhanced', + path: '/enhanced', + getParentRoute: () => rootRouteImport, +} as any) +const CssRoute = CssRouteImport.update({ + id: '/css', + path: '/css', + getParentRoute: () => rootRouteImport, +} as any) +const ComponentsRoute = ComponentsRouteImport.update({ + id: '/components', + path: '/components', + getParentRoute: () => rootRouteImport, +} as any) +const IndexRoute = IndexRouteImport.update({ + id: '/', + path: '/', + getParentRoute: () => rootRouteImport, +} as any) + +export interface FileRoutesByFullPath { + '/': typeof IndexRoute + '/components': typeof ComponentsRoute + '/css': typeof CssRoute + '/enhanced': typeof EnhancedRoute + '/imported': typeof ImportedRoute +} +export interface FileRoutesByTo { + '/': typeof IndexRoute + '/components': typeof ComponentsRoute + '/css': typeof CssRoute + '/enhanced': typeof EnhancedRoute + '/imported': typeof ImportedRoute +} +export interface FileRoutesById { + __root__: typeof rootRouteImport + '/': typeof IndexRoute + '/components': typeof ComponentsRoute + '/css': typeof CssRoute + '/enhanced': typeof EnhancedRoute + '/imported': typeof ImportedRoute +} +export interface FileRouteTypes { + fileRoutesByFullPath: FileRoutesByFullPath + fullPaths: '/' | '/components' | '/css' | '/enhanced' | '/imported' + fileRoutesByTo: FileRoutesByTo + to: '/' | '/components' | '/css' | '/enhanced' | '/imported' + id: '__root__' | '/' | '/components' | '/css' | '/enhanced' | '/imported' + fileRoutesById: FileRoutesById +} +export interface RootRouteChildren { + IndexRoute: typeof IndexRoute + ComponentsRoute: typeof ComponentsRoute + CssRoute: typeof CssRoute + EnhancedRoute: typeof EnhancedRoute + ImportedRoute: typeof ImportedRoute +} + +declare module '@tanstack/solid-router' { + interface FileRoutesByPath { + '/imported': { + id: '/imported' + path: '/imported' + fullPath: '/imported' + preLoaderRoute: typeof ImportedRouteImport + parentRoute: typeof rootRouteImport + } + '/enhanced': { + id: '/enhanced' + path: '/enhanced' + fullPath: '/enhanced' + preLoaderRoute: typeof EnhancedRouteImport + parentRoute: typeof rootRouteImport + } + '/css': { + id: '/css' + path: '/css' + fullPath: '/css' + preLoaderRoute: typeof CssRouteImport + parentRoute: typeof rootRouteImport + } + '/components': { + id: '/components' + path: '/components' + fullPath: '/components' + preLoaderRoute: typeof ComponentsRouteImport + parentRoute: typeof rootRouteImport + } + '/': { + id: '/' + path: '/' + fullPath: '/' + preLoaderRoute: typeof IndexRouteImport + parentRoute: typeof rootRouteImport + } + } +} + +const rootRouteChildren: RootRouteChildren = { + IndexRoute: IndexRoute, + ComponentsRoute: ComponentsRoute, + CssRoute: CssRoute, + EnhancedRoute: EnhancedRoute, + ImportedRoute: ImportedRoute, +} +export const routeTree = rootRouteImport + ._addFileChildren(rootRouteChildren) + ._addFileTypes() + +import type { getRouter } from './router.tsx' +import type { createStart } from '@tanstack/solid-start' +declare module '@tanstack/solid-start' { + interface Register { + ssr: true + router: Awaited> + } +} diff --git a/e2e/solid-start/deferred-hydration/src/router.tsx b/e2e/solid-start/deferred-hydration/src/router.tsx new file mode 100644 index 0000000000..aa7ead6752 --- /dev/null +++ b/e2e/solid-start/deferred-hydration/src/router.tsx @@ -0,0 +1,9 @@ +import { createRouter } from '@tanstack/solid-router' +import { routeTree } from './routeTree.gen' + +export function getRouter() { + return createRouter({ + routeTree, + scrollRestoration: true, + }) +} diff --git a/e2e/solid-start/deferred-hydration/src/routes/__root.tsx b/e2e/solid-start/deferred-hydration/src/routes/__root.tsx new file mode 100644 index 0000000000..51be9d9125 --- /dev/null +++ b/e2e/solid-start/deferred-hydration/src/routes/__root.tsx @@ -0,0 +1,96 @@ +/// +import { + HeadContent, + Link, + Outlet, + Scripts, + createRootRoute, +} from '@tanstack/solid-router' + +export const Route = createRootRoute({ + head: () => ({ + meta: [ + { charSet: 'utf-8' }, + { name: 'viewport', content: 'width=device-width, initial-scale=1' }, + { title: 'Deferred Hydration E2E' }, + ], + }), + component: RootDocument, +}) + +function RootDocument() { + return ( + + + + + + + +
    + +
    + + + + ) +} diff --git a/e2e/solid-start/deferred-hydration/src/routes/components.tsx b/e2e/solid-start/deferred-hydration/src/routes/components.tsx new file mode 100644 index 0000000000..600efaa63c --- /dev/null +++ b/e2e/solid-start/deferred-hydration/src/routes/components.tsx @@ -0,0 +1,172 @@ +import * as Solid from 'solid-js' + +import { createFileRoute } from '@tanstack/solid-router' +import { Hydrate } from '@tanstack/solid-start' +import { + condition, + idle, + interaction, + load, + media, + never, + visible, +} from '@tanstack/solid-start/hydration' + +export const Route = createFileRoute('/components')({ + component: ComponentHydrationPage, +}) + +function InteractiveBox(props: { id: string; label: string }) { + const [count, setCount] = Solid.createSignal(0) + const [hydrated, setHydrated] = Solid.createSignal(false) + + Solid.createEffect( + () => true, + () => { + setHydrated(true) + }, + ) + + return ( + + ) +} + +function DelayedFallbackBox() { + if (typeof window !== 'undefined') { + const [ready, setReady] = Solid.createSignal(false) + window.setTimeout(() => setReady(true), 1000) + + return ( + +
    fallback child
    +
    + ) + } + + return
    fallback child
    +} + +function ComponentHydrationPage() { + const [hydratedCallbacks, setHydratedCallbacks] = Solid.createSignal(0) + const [conditionReady, setConditionReady] = Solid.createSignal(false) + const [showClientFallbackBoundary, setShowClientFallbackBoundary] = + Solid.createSignal(false) + + return ( +
    +

    Component Deferred Hydration

    +
    + Manual test guide + + Pink buttons are server HTML that has not hydrated yet. Green buttons + have hydrated and should increment when clicked. Follow the notes + below to trigger each strategy intentionally. + +
    +

    {hydratedCallbacks()}

    +

    + load and idle should become green + without interaction shortly after the page loads. +

    + + + + + + +
    Scroll down to reveal the visible boundary
    +

    + visible hydrates only after this button enters the + viewport. +

    + + + +

    + media hydrates when (min-width: 1px) + matches. interaction hydrates on hover, focus, pointer + down, or click intent. +

    + + + + + + +

    + Custom interaction boundaries below hydrate only for their configured + events: double-click for the single-event example, and right-click or + double-click for the multi-event example. The prefetch example should + download code on hover but hydrate on click. +

    + setHydratedCallbacks((count) => count + 1)} + > + + + + + + + + + + + + + + + + + + + + + + + +

    + never stays as server HTML forever on the initial page, + so clicking should not increment it. +

    + + + client fallback + } + > + + + +
    + ) +} diff --git a/e2e/solid-start/deferred-hydration/src/routes/css.tsx b/e2e/solid-start/deferred-hydration/src/routes/css.tsx new file mode 100644 index 0000000000..c1a80d492b --- /dev/null +++ b/e2e/solid-start/deferred-hydration/src/routes/css.tsx @@ -0,0 +1,57 @@ +import { createFileRoute } from '@tanstack/solid-router' +import { Hydrate } from '@tanstack/solid-start' +import { media, never, visible } from '@tanstack/solid-start/hydration' +import outerStyles from './css/outer.module.css' +import deferredStyles from './css/deferred-only.module.css' +import sharedStyles from './css/shared.module.css' + +export const Route = createFileRoute('/css')({ + component: CssHydrationPage, +}) + +function CssHydrationPage() { + return ( +
    +
    +

    + CSS Deferred Hydration +

    +

    + CSS from deferred, never, shared, and nested Hydrate boundaries should + be available even before the client JavaScript hydrates those islands. +

    +
    +
    +
    + Outer CSS +
    +
    + Shared outer CSS +
    +
    + +
    + Deferred CSS +
    +
    + +
    + Never CSS +
    +
    + + +
    + Nested CSS +
    +
    +
    +
    + ) +} diff --git a/e2e/solid-start/deferred-hydration/src/routes/css/deferred-only.module.css b/e2e/solid-start/deferred-hydration/src/routes/css/deferred-only.module.css new file mode 100644 index 0000000000..05eafda03c --- /dev/null +++ b/e2e/solid-start/deferred-hydration/src/routes/css/deferred-only.module.css @@ -0,0 +1,15 @@ +.deferredBox { + background-color: rgb(23, 45, 67); + color: rgb(255, 255, 255); + padding: 12px; +} + +.neverBox { + color: rgb(45, 67, 89); + padding: 12px; +} + +.nestedBox { + border-left: 5px solid rgb(67, 89, 123); + padding-left: 12px; +} diff --git a/e2e/solid-start/deferred-hydration/src/routes/css/outer.module.css b/e2e/solid-start/deferred-hydration/src/routes/css/outer.module.css new file mode 100644 index 0000000000..98ca5e0934 --- /dev/null +++ b/e2e/solid-start/deferred-hydration/src/routes/css/outer.module.css @@ -0,0 +1,9 @@ +.heading { + color: rgb(11, 31, 53); +} + +.outerBox { + background-color: rgb(242, 250, 255); + color: rgb(12, 34, 56); + padding: 12px; +} diff --git a/e2e/solid-start/deferred-hydration/src/routes/css/shared.module.css b/e2e/solid-start/deferred-hydration/src/routes/css/shared.module.css new file mode 100644 index 0000000000..020da5d7ad --- /dev/null +++ b/e2e/solid-start/deferred-hydration/src/routes/css/shared.module.css @@ -0,0 +1,4 @@ +.sharedBox { + border-top: 4px solid rgb(98, 76, 54); + margin-top: 8px; +} diff --git a/e2e/solid-start/deferred-hydration/src/routes/enhanced.tsx b/e2e/solid-start/deferred-hydration/src/routes/enhanced.tsx new file mode 100644 index 0000000000..3909e22a80 --- /dev/null +++ b/e2e/solid-start/deferred-hydration/src/routes/enhanced.tsx @@ -0,0 +1,320 @@ +import { Show, createEffect, createSignal } from 'solid-js' +import type { JSX } from '@solidjs/web' +import { createFileRoute } from '@tanstack/solid-router' +import { Hydrate } from '@tanstack/solid-start' +import { interaction, media } from '@tanstack/solid-start/hydration' +import { EnhancedNestedWidget } from '../shared/EnhancedNestedWidget' + +type EnhancedSearch = { + dynamic?: 'interaction' +} + +export const Route = createFileRoute('/enhanced')({ + validateSearch: (search: Record): EnhancedSearch => ({ + dynamic: search.dynamic === 'interaction' ? 'interaction' : undefined, + }), + component: EnhancedHydrationPage, +}) + +type DeferredGate = { + promise: Promise + resolve: () => void +} + +const clickIntent = interaction({ events: 'click' }) +const pointerOverIntent = interaction({ events: 'pointerover' }) +const doubleClickIntent = interaction({ events: 'dblclick' }) + +function createDeferredGate(): DeferredGate { + let resolve!: () => void + const promise = new Promise((next) => { + resolve = next + }) + return { promise, resolve } +} + +function InteractiveBox(props: { id: string; label: string }): JSX.Element { + const [count, setCount] = createSignal(0) + const [hydrated, setHydrated] = createSignal(false) + + createEffect( + () => true, + () => { + setHydrated(true) + }, + ) + + return ( + + ) +} + +function DynamicWhenExamples(): JSX.Element { + const search = Route.useSearch() + const searchDrivenHydration = () => + search().dynamic === 'interaction' ? clickIntent : doubleClickIntent + + return ( + <> +

    + Dynamic callbacks are client-only. The first boundary always hydrates on + click; the second reads typed router search state before choosing its + interaction event. +

    + clickIntent}> + + + + + + + ) +} + +function SplitPrefetchExample(): JSX.Element { + const gate = createDeferredGate() + const [waitReason, setWaitReason] = createSignal('idle') + const [preloadStatus, setPreloadStatus] = createSignal('idle') + const [queryStatus, setQueryStatus] = createSignal('idle') + + return ( + <> +

    {waitReason()}

    +

    {preloadStatus()}

    +

    {queryStatus()}

    + + { + setQueryStatus(element ? 'element' : 'missing-element') + setWaitReason('waiting') + + const reason = await waitFor(pointerOverIntent) + setWaitReason(reason) + if (reason === 'abort' || signal.aborted) return + + await preload() + setPreloadStatus('done') + await gate.promise + setQueryStatus('done') + }} + > + + + + ) +} + +function FireAndForgetPrefetchExample(): JSX.Element { + const gate = createDeferredGate() + const [waitReason, setWaitReason] = createSignal('idle') + const [workStatus, setWorkStatus] = createSignal('idle') + const [queryStatus, setQueryStatus] = createSignal('idle') + + return ( + <> +

    {workStatus()}

    +

    {waitReason()}

    +

    {queryStatus()}

    + + { + setWaitReason('waiting') + void waitFor(pointerOverIntent).then((reason) => { + setWaitReason(reason) + if (reason === 'abort') return + + setWorkStatus('started') + void gate.promise.then(() => { + setQueryStatus('done') + }) + }) + }} + > + + + + ) +} + +function HydrateFirstPrefetchExample(): JSX.Element { + const [reason, setReason] = createSignal('idle') + + return ( + <> +

    {reason()}

    + { + setReason(await waitFor(doubleClickIntent)) + }} + > + + + + ) +} + +function RuntimeOnlyPrefetchExample(): JSX.Element { + const gate = createDeferredGate() + const [waitReason, setWaitReason] = createSignal('idle') + const [runtimeStatus, setRuntimeStatus] = createSignal('idle') + + return ( + <> +

    {waitReason()}

    +

    {runtimeStatus()}

    + + { + setWaitReason('waiting') + const reason = await waitFor(pointerOverIntent) + setWaitReason(reason) + if (reason === 'abort') return + + await gate.promise + await preload() + setRuntimeStatus('ready') + }} + > + + + + ) +} + +function WaitForAbortExample(): JSX.Element { + const [showBoundary, setShowBoundary] = createSignal(true) + const [reason, setReason] = createSignal('idle') + + return ( + <> +

    {reason()}

    + + + { + setReason('waiting') + setReason(await waitFor(pointerOverIntent)) + }} + > + + + + + ) +} + +function SignalAbortExample(): JSX.Element { + const [showBoundary, setShowBoundary] = createSignal(true) + const [status, setStatus] = createSignal('idle') + + return ( + <> +

    {status()}

    + + + { + setStatus('listening') + await new Promise((resolve) => { + const onAbort = () => { + setStatus('aborted') + resolve() + } + + if (signal.aborted) { + onAbort() + return + } + + signal.addEventListener('abort', onAbort, { once: true }) + }) + }} + > + + + + + ) +} + +function NestedDynamicExamples(): JSX.Element { + return ( + <> + + clickIntent}> + + + + + + ) +} + +function EnhancedHydrationPage(): JSX.Element { + return ( +
    +

    Enhanced Hydrate APIs

    + + + + + + + + +
    + ) +} diff --git a/e2e/solid-start/deferred-hydration/src/routes/imported.tsx b/e2e/solid-start/deferred-hydration/src/routes/imported.tsx new file mode 100644 index 0000000000..abfb827c91 --- /dev/null +++ b/e2e/solid-start/deferred-hydration/src/routes/imported.tsx @@ -0,0 +1,15 @@ +import { createFileRoute } from '@tanstack/solid-router' +import { ImportedHydrateWidget } from '../shared/ImportedHydrateWidget' + +export const Route = createFileRoute('/imported')({ + component: ImportedHydrationPage, +}) + +function ImportedHydrationPage() { + return ( +
    +

    Imported Hydrate

    + +
    + ) +} diff --git a/e2e/solid-start/deferred-hydration/src/routes/index.tsx b/e2e/solid-start/deferred-hydration/src/routes/index.tsx new file mode 100644 index 0000000000..61fbf7f6dc --- /dev/null +++ b/e2e/solid-start/deferred-hydration/src/routes/index.tsx @@ -0,0 +1,23 @@ +import { Link, createFileRoute } from '@tanstack/solid-router' + +export const Route = createFileRoute('/')({ + component: Home, +}) + +function Home() { + return ( +
    +

    Deferred Hydration

    +

    Component strategies

    + component strategies +

    CSS

    + CSS deferred hydration +

    Imported component

    + + imported Hydrate + +

    Enhanced APIs

    + enhanced Hydrate APIs +
    + ) +} diff --git a/e2e/solid-start/deferred-hydration/src/shared/EnhancedNestedWidget.tsx b/e2e/solid-start/deferred-hydration/src/shared/EnhancedNestedWidget.tsx new file mode 100644 index 0000000000..cc9659af86 --- /dev/null +++ b/e2e/solid-start/deferred-hydration/src/shared/EnhancedNestedWidget.tsx @@ -0,0 +1,36 @@ +import { createEffect, createSignal } from 'solid-js' +import { Hydrate } from '@tanstack/solid-start' +import { interaction, media } from '@tanstack/solid-start/hydration' + +function CrossFileNestedButton() { + const [count, setCount] = createSignal(0) + const [hydrated, setHydrated] = createSignal(false) + + createEffect( + () => true, + () => { + setHydrated(true) + }, + ) + + return ( + + ) +} + +export function EnhancedNestedWidget() { + return ( + + + + + + ) +} diff --git a/e2e/solid-start/deferred-hydration/src/shared/ImportedHydrateWidget.tsx b/e2e/solid-start/deferred-hydration/src/shared/ImportedHydrateWidget.tsx new file mode 100644 index 0000000000..859b741755 --- /dev/null +++ b/e2e/solid-start/deferred-hydration/src/shared/ImportedHydrateWidget.tsx @@ -0,0 +1,34 @@ +import { createSignal } from 'solid-js' + +import { Hydrate } from '@tanstack/solid-start' +import { media } from '@tanstack/solid-start/hydration' + +function ImportedHydrateChild() { + const [count, setCount] = createSignal(0) + + return ( + + ) +} + +export function ImportedHydrateWidget() { + return ( + + imported hydrate fallback + + } + > + + + ) +} diff --git a/e2e/solid-start/deferred-hydration/tests/hydration.spec.ts b/e2e/solid-start/deferred-hydration/tests/hydration.spec.ts new file mode 100644 index 0000000000..892dddf0dd --- /dev/null +++ b/e2e/solid-start/deferred-hydration/tests/hydration.spec.ts @@ -0,0 +1,911 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import type { APIRequestContext, Page } from '@playwright/test' + +async function clickAndExpectCount( + page: Page, + buttonTestId: string, + countTestId: string, + count: string, +) { + await expect(page.getByTestId(buttonTestId)).toHaveAttribute( + 'data-hydrated', + 'true', + ) + await page.getByTestId(buttonTestId).click() + await expect(page.getByTestId(countTestId)).toHaveText(count) +} + +async function clickIntentAndExpectReplayedCount( + page: Page, + buttonTestId: string, + countTestId: string, + count: string, +) { + await expectRouteToStayUnhydrated(page, buttonTestId) + await page.getByTestId(buttonTestId).click() + await expect(page.getByTestId(buttonTestId)).toHaveAttribute( + 'data-hydrated', + 'true', + ) + await expect(page.getByTestId(countTestId)).toHaveText(count) +} + +async function clickToHydrateThenClickAndExpectIncrement( + page: Page, + buttonTestId: string, + countTestId: string, +) { + await expectRouteToStayUnhydrated(page, buttonTestId) + await page.getByTestId(buttonTestId).click() + await expect(page.getByTestId(buttonTestId)).toHaveAttribute( + 'data-hydrated', + 'true', + ) + const previousCount = Number( + await page.getByTestId(countTestId).textContent(), + ) + await page.getByTestId(buttonTestId).click() + await expect + .poll(async () => Number(await page.getByTestId(countTestId).textContent())) + .toBe(previousCount + 1) +} + +async function hoverIntentAndExpectCount( + page: Page, + buttonTestId: string, + countTestId: string, + count: string, +) { + await expectRouteToStayUnhydrated(page, buttonTestId) + await page.mouse.move(0, 0) + await page.getByTestId(buttonTestId).hover() + await clickAndExpectCount(page, buttonTestId, countTestId, count) +} + +async function dispatchHydrationIntent( + page: Page, + buttonTestId: string, + eventName: string, +) { + await page.getByTestId(buttonTestId).evaluate((element, eventName) => { + const marker = element.closest('[data-ts-hydrate-id]') + + if (!marker) { + throw new Error('Expected Hydrate marker to exist') + } + + marker.dispatchEvent( + new Event(eventName, { bubbles: true, cancelable: true }), + ) + }, eventName) +} + +async function trackBoundaryStability(page: Page, buttonTestId: string) { + await page.getByTestId(buttonTestId).evaluate((element, testId) => { + const marker = element.closest('[data-ts-hydrate-id]') + + if (!(marker instanceof HTMLElement)) { + throw new Error('Expected Hydrate marker to exist') + } + + const win = window as typeof window & { + __hydrateBoundaryVisualGapCount?: number + __hydrateBoundaryMaxScrollDelta?: number + __hydrateBoundaryStabilityDone?: boolean + } + const hasBoundaryButton = () => + Array.from(marker.querySelectorAll('[data-testid]')).some( + (child) => child.getAttribute('data-testid') === testId, + ) + const hasHydratedBoundaryButton = () => + Array.from(marker.querySelectorAll('[data-testid]')).some( + (child) => + child.getAttribute('data-testid') === testId && + child.getAttribute('data-hydrated') === 'true', + ) + const initialScrollY = window.scrollY + + win.__hydrateBoundaryVisualGapCount = 0 + win.__hydrateBoundaryMaxScrollDelta = 0 + win.__hydrateBoundaryStabilityDone = false + + let frameCount = 0 + let hydratedFrameCount = 0 + let observer: MutationObserver | undefined + const recordScroll = () => { + win.__hydrateBoundaryMaxScrollDelta = Math.max( + win.__hydrateBoundaryMaxScrollDelta ?? 0, + Math.abs(window.scrollY - initialScrollY), + ) + + if (hasHydratedBoundaryButton()) hydratedFrameCount++ + + frameCount++ + if (hydratedFrameCount >= 10 || frameCount >= 300) { + observer?.disconnect() + win.__hydrateBoundaryStabilityDone = true + return + } + + requestAnimationFrame(recordScroll) + } + + observer = new MutationObserver(() => { + if (!hasBoundaryButton()) { + win.__hydrateBoundaryVisualGapCount!++ + } + }) + observer.observe(marker, { childList: true }) + + requestAnimationFrame(recordScroll) + }, buttonTestId) +} + +async function expectBoundaryStable(page: Page) { + await expect + .poll(() => + page.evaluate( + () => + ( + window as typeof window & { + __hydrateBoundaryStabilityDone?: boolean + } + ).__hydrateBoundaryStabilityDone ?? false, + ), + ) + .toBe(true) + await expect + .poll(() => + page.evaluate( + () => + ( + window as typeof window & { + __hydrateBoundaryVisualGapCount?: number + } + ).__hydrateBoundaryVisualGapCount ?? 0, + ), + ) + .toBe(0) + await expect + .poll(() => + page.evaluate( + () => + ( + window as typeof window & { + __hydrateBoundaryMaxScrollDelta?: number + } + ).__hydrateBoundaryMaxScrollDelta ?? 0, + ), + ) + .toBeLessThanOrEqual(1) +} + +async function expectRouteToStayUnhydrated( + page: Page, + buttonTestId: string, + duration = 250, +) { + await expect(page.getByTestId(buttonTestId)).toHaveAttribute( + 'data-hydrated', + 'false', + ) + await page.waitForTimeout(duration) + await expect(page.getByTestId(buttonTestId)).toHaveAttribute( + 'data-hydrated', + 'false', + ) +} + +async function scrollToBoundary(page: Page, buttonTestId: string) { + const button = page.getByTestId(buttonTestId) + for (let attempt = 0; attempt < 3; attempt++) { + await button.evaluate((element) => { + element.scrollIntoView({ block: 'center', inline: 'nearest' }) + }) + + await page.waitForTimeout(100) + const isVisible = await button.evaluate((element) => { + const rect = element.getBoundingClientRect() + return rect.bottom > 0 && rect.top < window.innerHeight + }) + + if (isVisible) return + } + + await expect(button).toBeInViewport() +} + +async function expectCssProperty( + page: Page, + testId: string, + property: string, + value: string, +) { + await expect + .poll(() => + page.getByTestId(testId).evaluate((element, propertyName) => { + return getComputedStyle(element).getPropertyValue(propertyName) + }, property), + ) + .toBe(value) +} + +function htmlContainsText(html: string, text: string) { + const pattern = text.split(' ').join('(?:\\s|)+') + expect(html).toMatch(new RegExp(pattern)) +} + +function getModulePreloadHrefs(html: string) { + return Array.from(html.matchAll(/]*>/g), (match) => match[0]) + .filter((tag) => /\brel="modulepreload"/.test(tag)) + .map((tag) => tag.match(/\bhref="([^"]+)"/)?.[1]) + .filter((href): href is string => !!href) +} + +async function modulePreloadContentsContain( + request: APIRequestContext, + hrefs: Array, + marker: string, +) { + for (const href of hrefs) { + const response = await request.get(href) + if (!response.ok()) continue + + const text = await response.text() + if (text.includes(marker)) return true + } + + return false +} + +async function resourceContentsContain( + page: Page, + request: APIRequestContext, + marker: string, + filter: (url: string) => boolean, +) { + const resourceUrls = await page.evaluate(() => + performance.getEntriesByType('resource').map((entry) => entry.name), + ) + + return modulePreloadContentsContain( + request, + resourceUrls.filter(filter), + marker, + ) +} + +async function documentModulePreloadHrefs(page: Page) { + return page.evaluate(() => + Array.from( + document.querySelectorAll('link[rel~="modulepreload"]'), + (link) => link.href, + ), + ) +} + +function isHydrateBoundaryResource(url: string) { + return ( + url.includes('/assets/components-') || + url.includes('/assets/js/async/') || + url.includes('/static/js/async/') + ) +} + +function isClientJavaScriptResource(url: string) { + return ( + url.includes('/assets/') || + url.includes('/static/js/') || + url.includes('/static/js/async/') + ) +} + +async function expectClientRouterReady(page: Page) { + await expect + .poll(() => + page.evaluate(() => + Boolean( + ( + globalThis as typeof globalThis & { + __TSR_ROUTER__?: unknown + } + ).__TSR_ROUTER__, + ), + ), + ) + .toBe(true) +} + +async function gotoEnhanced(page: Page, search = '') { + await page.goto(`/enhanced${search}`) + await expectClientRouterReady(page) +} + +test.describe('component-level Hydrate runtime strategies', () => { + test('renders SSR HTML and hydrates each runtime when appropriately', async ({ + page, + request, + }) => { + await page.goto('/components') + + await expect(page.getByTestId('component-heading')).toHaveText( + 'Component Deferred Hydration', + ) + + await clickAndExpectCount( + page, + 'component-load-button', + 'component-load-count', + '1', + ) + await clickAndExpectCount( + page, + 'component-idle-button', + 'component-idle-count', + '1', + ) + await expect( + resourceContentsContain(page, request, 'component-visible', (url) => + isHydrateBoundaryResource(url), + ), + ).resolves.toBe(false) + await expectRouteToStayUnhydrated(page, 'component-visible-button') + await scrollToBoundary(page, 'component-visible-button') + await clickAndExpectCount( + page, + 'component-visible-button', + 'component-visible-count', + '1', + ) + await expect + .poll(() => + resourceContentsContain(page, request, 'component-visible', (url) => + isHydrateBoundaryResource(url), + ), + ) + .toBe(true) + await clickAndExpectCount( + page, + 'component-media-button', + 'component-media-count', + '1', + ) + await hoverIntentAndExpectCount( + page, + 'component-interaction-button', + 'component-interaction-count', + '1', + ) + await expect(page.getByTestId('component-on-hydrated-count')).toHaveText( + '0', + ) + await expectRouteToStayUnhydrated(page, 'component-custom-single-button') + await page.getByTestId('component-custom-single-button').hover() + await expectRouteToStayUnhydrated(page, 'component-custom-single-button') + await page.getByTestId('component-custom-single-button').click() + await expectRouteToStayUnhydrated(page, 'component-custom-single-button') + await dispatchHydrationIntent( + page, + 'component-custom-single-button', + 'dblclick', + ) + await expect( + page.getByTestId('component-custom-single-button'), + ).toHaveAttribute('data-hydrated', 'true') + await expect(page.getByTestId('component-on-hydrated-count')).toHaveText( + '1', + ) + await clickAndExpectCount( + page, + 'component-custom-single-button', + 'component-custom-single-count', + '1', + ) + await expect(page.getByTestId('component-on-hydrated-count')).toHaveText( + '1', + ) + await expectRouteToStayUnhydrated(page, 'component-custom-multi-button') + await dispatchHydrationIntent( + page, + 'component-custom-multi-button', + 'contextmenu', + ) + await clickAndExpectCount( + page, + 'component-custom-multi-button', + 'component-custom-multi-count', + '1', + ) + await expectRouteToStayUnhydrated(page, 'component-condition-button') + await page.getByTestId('component-enable-condition').click() + await clickAndExpectCount( + page, + 'component-condition-button', + 'component-condition-count', + '1', + ) + await scrollToBoundary(page, 'component-click-replay-button') + await expectRouteToStayUnhydrated(page, 'component-click-replay-button') + await trackBoundaryStability(page, 'component-click-replay-button') + await page.getByTestId('component-click-replay-button').click() + await expect( + page.getByTestId('component-click-replay-button'), + ).toHaveAttribute('data-hydrated', 'true') + await expectBoundaryStable(page) + await expect(page.getByTestId('component-click-replay-count')).toHaveText( + '1', + ) + await expectRouteToStayUnhydrated(page, 'component-prefetch-button') + await expect( + resourceContentsContain(page, request, 'component-prefetch', (url) => + isHydrateBoundaryResource(url), + ), + ).resolves.toBe(false) + await page.mouse.move(0, 0) + await page.getByTestId('component-prefetch-button').hover() + await expect(page.getByTestId('component-prefetch-button')).toHaveAttribute( + 'data-hydrated', + 'false', + ) + await expect + .poll(() => + resourceContentsContain(page, request, 'component-prefetch', (url) => + isHydrateBoundaryResource(url), + ), + ) + .toBe(true) + await expect(page.getByTestId('component-prefetch-button')).toHaveAttribute( + 'data-hydrated', + 'false', + ) + await page.getByTestId('component-prefetch-button').click() + await expect(page.getByTestId('component-prefetch-button')).toHaveAttribute( + 'data-hydrated', + 'true', + ) + await expect(page.getByTestId('component-prefetch-count')).toHaveText('1') + await hoverIntentAndExpectCount( + page, + 'component-nested-child-button', + 'component-nested-child-count', + '1', + ) + + await page.getByTestId('component-never-button').click() + await expect(page.getByTestId('component-never-count')).toHaveText('0') + }) + + test('replays click after another interaction boundary hydrates first', async ({ + page, + }) => { + await page.goto('/components') + await expectClientRouterReady(page) + + await scrollToBoundary(page, 'component-custom-multi-button') + await expectRouteToStayUnhydrated(page, 'component-custom-multi-button') + await page.getByTestId('component-custom-multi-button').click({ + button: 'right', + }) + await expect( + page.getByTestId('component-custom-multi-button'), + ).toHaveAttribute('data-hydrated', 'true') + + await scrollToBoundary(page, 'component-click-replay-button') + await expectRouteToStayUnhydrated(page, 'component-click-replay-button') + await trackBoundaryStability(page, 'component-click-replay-button') + await page.getByTestId('component-click-replay-button').click() + await expect( + page.getByTestId('component-click-replay-button'), + ).toHaveAttribute('data-hydrated', 'true') + await expectBoundaryStable(page) + await expect(page.getByTestId('component-click-replay-count')).toHaveText( + '1', + ) + }) + + test('keeps bottom scroll stable when a condition boundary hydrates', async ({ + page, + }) => { + await page.goto('/components') + await expectClientRouterReady(page) + await expectRouteToStayUnhydrated(page, 'component-condition-button') + + await page.evaluate(() => { + window.scrollTo(0, document.documentElement.scrollHeight) + }) + await page.waitForTimeout(100) + await expect( + page.getByTestId('component-enable-condition'), + ).toBeInViewport() + + await trackBoundaryStability(page, 'component-condition-button') + await page.getByTestId('component-enable-condition').click() + await expect( + page.getByTestId('component-condition-button'), + ).toHaveAttribute('data-hydrated', 'true') + await expectBoundaryStable(page) + await clickAndExpectCount( + page, + 'component-condition-button', + 'component-condition-count', + '1', + ) + }) + + test('shows fallback during a client-only mount while the child suspends', async ({ + page, + }) => { + await page.goto('/components') + await expect(page.getByTestId('component-load-button')).toHaveAttribute( + 'data-hydrated', + 'true', + ) + await page.getByTestId('component-show-client-fallback').click() + + await expect(page.getByTestId('component-client-fallback')).toHaveText( + 'client fallback', + ) + await expect(page.getByTestId('component-fallback-child')).toHaveText( + 'fallback child', + ) + await expect(page.getByTestId('component-client-fallback')).toHaveCount(0) + }) +}) + +test.describe('enhanced Hydrate API combinations', () => { + test('server renders dynamic markers without evaluating client-only callbacks or prefetch functions', async ({ + request, + }) => { + const response = await request.get('/enhanced?dynamic=interaction') + const html = await response.text() + + expect(response.ok()).toBe(true) + htmlContainsText(html, 'Enhanced Hydrate APIs') + htmlContainsText(html, 'conditional dynamic') + expect(html).toContain('data-ts-hydrate-when="dynamic"') + expect(html).not.toContain('missing-element') + }) + + test('dynamic when functions hydrate and replay interaction events', async ({ + page, + }) => { + await gotoEnhanced(page, '?dynamic=interaction') + await expect(page.getByTestId('enhanced-heading')).toHaveText( + 'Enhanced Hydrate APIs', + ) + await clickIntentAndExpectReplayedCount( + page, + 'enhanced-dynamic-interaction-button', + 'enhanced-dynamic-interaction-count', + '1', + ) + + await expectRouteToStayUnhydrated( + page, + 'enhanced-dynamic-conditional-button', + ) + await page.getByTestId('enhanced-dynamic-conditional-button').hover() + await expectRouteToStayUnhydrated( + page, + 'enhanced-dynamic-conditional-button', + ) + await clickIntentAndExpectReplayedCount( + page, + 'enhanced-dynamic-conditional-button', + 'enhanced-dynamic-conditional-count', + '1', + ) + }) + + test('procedural prefetch can block hydration, preload the split chunk, and prepare query-like work', async ({ + page, + request, + }) => { + await gotoEnhanced(page) + await expect( + resourceContentsContain( + page, + request, + 'enhanced-procedural-split-child', + isClientJavaScriptResource, + ), + ).resolves.toBe(false) + + await expectRouteToStayUnhydrated(page, 'enhanced-procedural-split-button') + await expect(page.getByTestId('enhanced-split-wait-reason')).toHaveText( + 'waiting', + ) + await dispatchHydrationIntent( + page, + 'enhanced-procedural-split-button', + 'pointerover', + ) + await expect(page.getByTestId('enhanced-split-query')).toHaveText('element') + await expect(page.getByTestId('enhanced-split-wait-reason')).toHaveText( + 'prefetch', + ) + await expect(page.getByTestId('enhanced-split-preload')).toHaveText('done') + await expect + .poll(() => + resourceContentsContain( + page, + request, + 'enhanced-procedural-split-child', + isClientJavaScriptResource, + ), + ) + .toBe(true) + + await page.getByTestId('enhanced-procedural-split-button').click() + await expect( + page.getByTestId('enhanced-procedural-split-button'), + ).toHaveAttribute('data-hydrated', 'false') + await expect( + page.getByTestId('enhanced-procedural-split-count'), + ).toHaveText('0') + await page.getByTestId('enhanced-release-split-prefetch').click() + await expect( + page.getByTestId('enhanced-procedural-split-button'), + ).toHaveAttribute('data-hydrated', 'true') + await expect( + page.getByTestId('enhanced-procedural-split-count'), + ).toHaveText('1') + await expect(page.getByTestId('enhanced-split-query')).toHaveText('done') + }) + + test('function prefetch supports fire-and-forget work and waitFor hydrate-first resolution', async ({ + page, + }) => { + await gotoEnhanced(page) + + await expect(page.getByTestId('enhanced-fire-wait-reason')).toHaveText( + 'waiting', + ) + await dispatchHydrationIntent( + page, + 'enhanced-fire-and-forget-button', + 'pointerover', + ) + await expect(page.getByTestId('enhanced-fire-wait-reason')).toHaveText( + 'prefetch', + ) + await expect(page.getByTestId('enhanced-fire-status')).toHaveText('started') + await clickIntentAndExpectReplayedCount( + page, + 'enhanced-fire-and-forget-button', + 'enhanced-fire-and-forget-count', + '1', + ) + await expect(page.getByTestId('enhanced-fire-query')).toHaveText('idle') + await page.getByTestId('enhanced-release-fire-prefetch').click() + await expect(page.getByTestId('enhanced-fire-query')).toHaveText('done') + + await clickIntentAndExpectReplayedCount( + page, + 'enhanced-hydrate-first-button', + 'enhanced-hydrate-first-count', + '1', + ) + await expect(page.getByTestId('enhanced-hydrate-first-reason')).toHaveText( + 'hydrate', + ) + }) + + test('split=false procedural prefetch blocks hydration without requiring a child preload chunk', async ({ + page, + }) => { + await gotoEnhanced(page) + + await expectRouteToStayUnhydrated(page, 'enhanced-runtime-only-button') + await expect(page.getByTestId('enhanced-runtime-wait-reason')).toHaveText( + 'waiting', + ) + await dispatchHydrationIntent( + page, + 'enhanced-runtime-only-button', + 'pointerover', + ) + await expect(page.getByTestId('enhanced-runtime-wait-reason')).toHaveText( + 'prefetch', + ) + await page.getByTestId('enhanced-runtime-only-button').click() + await expect( + page.getByTestId('enhanced-runtime-only-button'), + ).toHaveAttribute('data-hydrated', 'false') + await expect(page.getByTestId('enhanced-runtime-only-count')).toHaveText( + '0', + ) + await page.getByTestId('enhanced-release-runtime-prefetch').click() + await expect(page.getByTestId('enhanced-runtime-status')).toHaveText( + 'ready', + ) + await expect( + page.getByTestId('enhanced-runtime-only-button'), + ).toHaveAttribute('data-hydrated', 'true') + await expect(page.getByTestId('enhanced-runtime-only-count')).toHaveText( + '1', + ) + }) + + test('procedural prefetch aborts waiters and signals when boundaries unmount', async ({ + page, + }) => { + await gotoEnhanced(page) + + await expectRouteToStayUnhydrated(page, 'enhanced-wait-abort-button') + await expect(page.getByTestId('enhanced-wait-abort-reason')).toHaveText( + 'waiting', + ) + await page.getByTestId('enhanced-hide-wait-abort').click() + await expect(page.getByTestId('enhanced-wait-abort-reason')).toHaveText( + 'abort', + ) + + await expect(page.getByTestId('enhanced-abort-status')).toHaveText( + 'listening', + ) + await page.getByTestId('enhanced-hide-abort').click() + await expect(page.getByTestId('enhanced-abort-status')).toHaveText( + 'aborted', + ) + }) + + test('nested dynamic interaction boundaries delegate through outer boundaries', async ({ + page, + }) => { + await gotoEnhanced(page) + + await clickToHydrateThenClickAndExpectIncrement( + page, + 'enhanced-dynamic-nested-button', + 'enhanced-dynamic-nested-count', + ) + await clickToHydrateThenClickAndExpectIncrement( + page, + 'enhanced-cross-file-nested-button', + 'enhanced-cross-file-nested-count', + ) + }) +}) + +test.describe('Hydrate CSS delivery', () => { + test('ships CSS for deferred, never, shared, and nested boundaries without JavaScript', async ({ + browser, + request, + }) => { + const response = await request.get('/css') + const html = await response.text() + + htmlContainsText(html, 'CSS Deferred Hydration') + htmlContainsText(html, 'Outer CSS') + htmlContainsText(html, 'Deferred CSS') + htmlContainsText(html, 'Never CSS') + htmlContainsText(html, 'Nested CSS') + + const context = await browser.newContext({ javaScriptEnabled: false }) + const page = await context.newPage() + + try { + await page.goto('/css') + + await expect(page.getByTestId('css-heading')).toHaveText( + 'CSS Deferred Hydration', + ) + await expect(page.getByTestId('css-deferred')).toHaveText('Deferred CSS') + await expect(page.getByTestId('css-never')).toHaveText('Never CSS') + await expect(page.getByTestId('css-nested')).toHaveText('Nested CSS') + + await expectCssProperty(page, 'css-outer', 'color', 'rgb(12, 34, 56)') + await expectCssProperty( + page, + 'css-deferred', + 'background-color', + 'rgb(23, 45, 67)', + ) + await expectCssProperty(page, 'css-never', 'color', 'rgb(45, 67, 89)') + await expectCssProperty( + page, + 'css-shared-outer', + 'border-top-color', + 'rgb(98, 76, 54)', + ) + await expectCssProperty( + page, + 'css-deferred', + 'border-top-color', + 'rgb(98, 76, 54)', + ) + await expectCssProperty( + page, + 'css-nested', + 'border-left-color', + 'rgb(67, 89, 123)', + ) + await expectCssProperty(page, 'css-nested', 'border-left-width', '5px') + } finally { + await context.close() + } + }) + + test('renders deferred content and omits never content after client-side navigation', async ({ + page, + }) => { + await page.goto('/') + await expectClientRouterReady(page) + await page.getByRole('link', { name: 'CSS', exact: true }).click() + await expect(page).toHaveURL(/\/css$/) + + await expect(page.getByTestId('css-heading')).toHaveText( + 'CSS Deferred Hydration', + ) + await expect(page.getByTestId('css-deferred')).toHaveText('Deferred CSS') + await expect(page.getByTestId('css-never')).toHaveCount(0) + await expect(page.getByTestId('css-nested')).toHaveCount(0) + + await expectCssProperty( + page, + 'css-deferred', + 'background-color', + 'rgb(23, 45, 67)', + ) + }) +}) + +test.describe('imported Hydrate boundaries', () => { + test('does not emit filtered shared Hydrate child JS on the initial document', async ({ + request, + }) => { + const response = await request.get('/imported') + const html = await response.text() + + htmlContainsText(html, 'Imported Hydrate') + htmlContainsText(html, 'Imported Hydrate Child') + + await expect( + modulePreloadContentsContain( + request, + getModulePreloadHrefs(html), + 'imported-hydrate-child', + ), + ).resolves.toBe(false) + }) + + test('does not preload Hydrate child chunks before client navigation', async ({ + page, + request, + }) => { + await page.goto('/') + await expect(page.getByTestId('home-heading')).toHaveText( + 'Deferred Hydration', + ) + await expectClientRouterReady(page) + + const link = page.getByRole('link', { name: 'imported Hydrate' }) + await page.mouse.move(0, 0) + await link.hover() + await link.focus() + + await expect( + modulePreloadContentsContain( + request, + await documentModulePreloadHrefs(page), + 'imported-hydrate-child', + ), + ).resolves.toBe(false) + await expect( + resourceContentsContain(page, request, 'imported-hydrate-child', (url) => + isClientJavaScriptResource(url), + ), + ).resolves.toBe(false) + + await page.getByRole('link', { name: 'imported Hydrate' }).click() + await expect(page).toHaveURL(/\/imported$/) + await expect(page.getByTestId('imported-hydrate-fallback')).toHaveCount(0) + await expect(page.getByTestId('imported-hydrate-child')).toContainText( + 'Imported Hydrate Child', + ) + await page.getByTestId('imported-hydrate-child').click() + await expect(page.getByTestId('imported-hydrate-count')).toHaveText('1') + }) +}) diff --git a/e2e/solid-start/deferred-hydration/tsconfig.json b/e2e/solid-start/deferred-hydration/tsconfig.json new file mode 100644 index 0000000000..11c43a4037 --- /dev/null +++ b/e2e/solid-start/deferred-hydration/tsconfig.json @@ -0,0 +1,23 @@ +{ + "include": ["**/*.ts", "**/*.tsx"], + "compilerOptions": { + "strict": true, + "esModuleInterop": true, + "jsx": "preserve", + "jsxImportSource": "@solidjs/web", + "module": "ESNext", + "moduleResolution": "Bundler", + "lib": ["DOM", "DOM.Iterable", "ES2022"], + "isolatedModules": true, + "resolveJsonModule": true, + "skipLibCheck": true, + "target": "ES2024", + "allowJs": true, + "forceConsistentCasingInFileNames": true, + "paths": { + "~/*": ["./src/*"] + }, + "noEmit": true, + "types": ["vite/client"] + } +} diff --git a/e2e/solid-start/deferred-hydration/vite.config.ts b/e2e/solid-start/deferred-hydration/vite.config.ts new file mode 100644 index 0000000000..70f388638a --- /dev/null +++ b/e2e/solid-start/deferred-hydration/vite.config.ts @@ -0,0 +1,14 @@ +import { defineConfig } from 'vite' +import { tanstackStart } from '@tanstack/solid-start/plugin/vite' +import viteSolid from 'vite-plugin-solid' + +const outDir = process.env.E2E_DIST_DIR ?? 'dist-vite-ssr' + +export default defineConfig({ + resolve: { tsconfigPaths: true }, + build: { + outDir, + }, + server: { port: 3000 }, + plugins: [tanstackStart(), viteSolid({ ssr: true })], +}) diff --git a/e2e/solid-start/query-integration/package.json b/e2e/solid-start/query-integration/package.json index 84641f591c..e481d756f2 100644 --- a/e2e/solid-start/query-integration/package.json +++ b/e2e/solid-start/query-integration/package.json @@ -20,9 +20,8 @@ "@tanstack/solid-router-ssr-query": "workspace:^", "@tanstack/solid-start": "workspace:^", "solid-js": "2.0.0-beta.14", - "tailwind-merge": "^2.6.0", - "vite": "^8.0.0", - "zod": "^3.24.2" + "tailwind-merge": "^3.6.0", + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -31,6 +30,7 @@ "@types/node": "^22.10.2", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite-plugin-solid": "^3.0.0-next.5" + "vite-plugin-solid": "^3.0.0-next.5", + "vite": "^8.0.14" } } diff --git a/e2e/solid-start/scroll-restoration/package.json b/e2e/solid-start/scroll-restoration/package.json index 0692dae066..fcf7975517 100644 --- a/e2e/solid-start/scroll-restoration/package.json +++ b/e2e/solid-start/scroll-restoration/package.json @@ -19,9 +19,8 @@ "@tanstack/zod-adapter": "workspace:^", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", - "tailwind-merge": "^2.6.0", - "vite": "^8.0.0", - "zod": "^3.24.2" + "tailwind-merge": "^3.6.0", + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -32,6 +31,7 @@ "srvx": "^0.11.9", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite-plugin-solid": "^3.0.0-next.5" + "vite-plugin-solid": "^3.0.0-next.5", + "vite": "^8.0.14" } } diff --git a/e2e/solid-start/scroll-restoration/src/routes/(tests)/with-search.tsx b/e2e/solid-start/scroll-restoration/src/routes/(tests)/with-search.tsx index 5d43b7f9bb..61ac78a439 100644 --- a/e2e/solid-start/scroll-restoration/src/routes/(tests)/with-search.tsx +++ b/e2e/solid-start/scroll-restoration/src/routes/(tests)/with-search.tsx @@ -1,10 +1,9 @@ import { createFileRoute } from '@tanstack/solid-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' import { ScrollBlock } from '../-components/scroll-block' export const Route = createFileRoute('/(tests)/with-search')({ - validateSearch: zodValidator(z.object({ where: z.string() })), + validateSearch: z.object({ where: z.string() }), component: Component, }) diff --git a/e2e/solid-start/selective-ssr/package.json b/e2e/solid-start/selective-ssr/package.json index c68049a159..220712c9e2 100644 --- a/e2e/solid-start/selective-ssr/package.json +++ b/e2e/solid-start/selective-ssr/package.json @@ -9,14 +9,14 @@ "build": "vite build && tsc --noEmit", "preview": "vite preview", "start": "pnpx srvx --prod -s ../client dist/server/server.js", - "test:e2e": "exit 0; rm -rf port*.txt; playwright test --project=chromium" + "test:e2e": "rm -rf port*.txt; playwright test --project=chromium" }, "dependencies": { "@solidjs/web": "2.0.0-beta.14", "@tanstack/solid-router": "workspace:^", "@tanstack/solid-start": "workspace:^", "solid-js": "2.0.0-beta.14", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@tailwindcss/vite": "^4.2.2", @@ -24,7 +24,7 @@ "srvx": "^0.11.9", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5", "vite-tsconfig-paths": "^5.1.4" } diff --git a/e2e/solid-start/selective-ssr/src/routeTree.gen.ts b/e2e/solid-start/selective-ssr/src/routeTree.gen.ts index 423535df71..df2b865e51 100644 --- a/e2e/solid-start/selective-ssr/src/routeTree.gen.ts +++ b/e2e/solid-start/selective-ssr/src/routeTree.gen.ts @@ -10,6 +10,7 @@ import { Route as rootRouteImport } from './routes/__root' import { Route as PostsRouteImport } from './routes/posts' +import { Route as DataOnlyPendingComponentRouteImport } from './routes/data-only-pending-component' import { Route as IndexRouteImport } from './routes/index' import { Route as PostsPostIdRouteImport } from './routes/posts.$postId' @@ -18,6 +19,12 @@ const PostsRoute = PostsRouteImport.update({ path: '/posts', getParentRoute: () => rootRouteImport, } as any) +const DataOnlyPendingComponentRoute = + DataOnlyPendingComponentRouteImport.update({ + id: '/data-only-pending-component', + path: '/data-only-pending-component', + getParentRoute: () => rootRouteImport, + } as any) const IndexRoute = IndexRouteImport.update({ id: '/', path: '/', @@ -31,30 +38,39 @@ const PostsPostIdRoute = PostsPostIdRouteImport.update({ export interface FileRoutesByFullPath { '/': typeof IndexRoute + '/data-only-pending-component': typeof DataOnlyPendingComponentRoute '/posts': typeof PostsRouteWithChildren '/posts/$postId': typeof PostsPostIdRoute } export interface FileRoutesByTo { '/': typeof IndexRoute + '/data-only-pending-component': typeof DataOnlyPendingComponentRoute '/posts': typeof PostsRouteWithChildren '/posts/$postId': typeof PostsPostIdRoute } export interface FileRoutesById { __root__: typeof rootRouteImport '/': typeof IndexRoute + '/data-only-pending-component': typeof DataOnlyPendingComponentRoute '/posts': typeof PostsRouteWithChildren '/posts/$postId': typeof PostsPostIdRoute } export interface FileRouteTypes { fileRoutesByFullPath: FileRoutesByFullPath - fullPaths: '/' | '/posts' | '/posts/$postId' + fullPaths: '/' | '/data-only-pending-component' | '/posts' | '/posts/$postId' fileRoutesByTo: FileRoutesByTo - to: '/' | '/posts' | '/posts/$postId' - id: '__root__' | '/' | '/posts' | '/posts/$postId' + to: '/' | '/data-only-pending-component' | '/posts' | '/posts/$postId' + id: + | '__root__' + | '/' + | '/data-only-pending-component' + | '/posts' + | '/posts/$postId' fileRoutesById: FileRoutesById } export interface RootRouteChildren { IndexRoute: typeof IndexRoute + DataOnlyPendingComponentRoute: typeof DataOnlyPendingComponentRoute PostsRoute: typeof PostsRouteWithChildren } @@ -67,6 +83,13 @@ declare module '@tanstack/solid-router' { preLoaderRoute: typeof PostsRouteImport parentRoute: typeof rootRouteImport } + '/data-only-pending-component': { + id: '/data-only-pending-component' + path: '/data-only-pending-component' + fullPath: '/data-only-pending-component' + preLoaderRoute: typeof DataOnlyPendingComponentRouteImport + parentRoute: typeof rootRouteImport + } '/': { id: '/' path: '/' @@ -96,6 +119,7 @@ const PostsRouteWithChildren = PostsRoute._addFileChildren(PostsRouteChildren) const rootRouteChildren: RootRouteChildren = { IndexRoute: IndexRoute, + DataOnlyPendingComponentRoute: DataOnlyPendingComponentRoute, PostsRoute: PostsRouteWithChildren, } export const routeTree = rootRouteImport diff --git a/e2e/solid-start/selective-ssr/src/routes/data-only-pending-component.tsx b/e2e/solid-start/selective-ssr/src/routes/data-only-pending-component.tsx new file mode 100644 index 0000000000..7368b1c8f8 --- /dev/null +++ b/e2e/solid-start/selective-ssr/src/routes/data-only-pending-component.tsx @@ -0,0 +1,31 @@ +import { createFileRoute } from '@tanstack/solid-router' +import { z } from 'zod' +import { ssrSchema } from '~/search' + +export const Route = createFileRoute('/data-only-pending-component')({ + validateSearch: z.object({ root: ssrSchema }), + ssr: 'data-only', + loader: async () => { + await new Promise((resolve) => setTimeout(resolve, 1500)) + return { loadedAt: new Date().toISOString() } + }, + pendingComponent: () => ( +
    + ), + component: DataOnlyPendingComponentRoute, +}) + +function DataOnlyPendingComponentRoute() { + const data = Route.useLoaderData() + + return ( +
    +

    + OK - loader finished +

    +
    +        {JSON.stringify(data(), null, 2)}
    +      
    +
    + ) +} diff --git a/e2e/solid-start/selective-ssr/src/routes/index.tsx b/e2e/solid-start/selective-ssr/src/routes/index.tsx index c0da00c2aa..9ae369cd8f 100644 --- a/e2e/solid-start/selective-ssr/src/routes/index.tsx +++ b/e2e/solid-start/selective-ssr/src/routes/index.tsx @@ -4,149 +4,144 @@ export const Route = createFileRoute('/')({ component: Home, }) -const baseTestCase = linkOptions({ - to: '/posts/$postId', - params: { postId: '1' }, -}) +type TestSearchValue = { + ssr?: boolean | 'data-only' + expected: { + data: 'server' | 'client' + render: 'server-and-client' | 'client-only' + } +} + +type TestSearch = { + root: TestSearchValue + posts: TestSearchValue + postId: TestSearchValue +} + +const createTestLink = (search: TestSearch) => + linkOptions({ + to: '/posts/$postId', + params: { postId: '1' }, + search, + }) const testCases = [ { - link: linkOptions({ - ...baseTestCase, - search: { - root: { - ssr: undefined, - expected: { data: 'server', render: 'server-and-client' }, - }, - posts: { - ssr: undefined, + link: createTestLink({ + root: { + ssr: undefined, + expected: { data: 'server', render: 'server-and-client' }, + }, + posts: { + ssr: undefined, - expected: { data: 'server', render: 'server-and-client' }, - }, - postId: { - ssr: undefined, + expected: { data: 'server', render: 'server-and-client' }, + }, + postId: { + ssr: undefined, - expected: { data: 'server', render: 'server-and-client' }, - }, + expected: { data: 'server', render: 'server-and-client' }, }, }), }, { - link: linkOptions({ - ...baseTestCase, - search: { - root: { - ssr: false, - expected: { data: 'client', render: 'client-only' }, - }, - posts: { - ssr: undefined, + link: createTestLink({ + root: { + ssr: false, + expected: { data: 'client', render: 'client-only' }, + }, + posts: { + ssr: undefined, - expected: { data: 'client', render: 'client-only' }, - }, - postId: { - ssr: undefined, + expected: { data: 'client', render: 'client-only' }, + }, + postId: { + ssr: undefined, - expected: { data: 'client', render: 'client-only' }, - }, + expected: { data: 'client', render: 'client-only' }, }, }), }, { - link: linkOptions({ - ...baseTestCase, - search: { - root: { - ssr: false, - expected: { data: 'client', render: 'client-only' }, - }, - posts: { - ssr: false, - expected: { data: 'client', render: 'client-only' }, - }, - postId: { - ssr: true, - expected: { data: 'client', render: 'client-only' }, - }, + link: createTestLink({ + root: { + ssr: false, + expected: { data: 'client', render: 'client-only' }, + }, + posts: { + ssr: false, + expected: { data: 'client', render: 'client-only' }, + }, + postId: { + ssr: true, + expected: { data: 'client', render: 'client-only' }, }, }), }, { - link: linkOptions({ - ...baseTestCase, - search: { - root: { - ssr: true, - expected: { data: 'server', render: 'server-and-client' }, - }, - posts: { - ssr: false, - expected: { data: 'client', render: 'client-only' }, - }, - postId: { - ssr: undefined, + link: createTestLink({ + root: { + ssr: true, + expected: { data: 'server', render: 'server-and-client' }, + }, + posts: { + ssr: false, + expected: { data: 'client', render: 'client-only' }, + }, + postId: { + ssr: undefined, - expected: { data: 'client', render: 'client-only' }, - }, + expected: { data: 'client', render: 'client-only' }, }, }), }, { - link: linkOptions({ - ...baseTestCase, - search: { - root: { - ssr: true, - expected: { data: 'server', render: 'server-and-client' }, - }, - posts: { - ssr: 'data-only', - expected: { data: 'server', render: 'client-only' }, - }, - postId: { - ssr: undefined, + link: createTestLink({ + root: { + ssr: true, + expected: { data: 'server', render: 'server-and-client' }, + }, + posts: { + ssr: 'data-only', + expected: { data: 'server', render: 'client-only' }, + }, + postId: { + ssr: undefined, - expected: { data: 'server', render: 'client-only' }, - }, + expected: { data: 'server', render: 'client-only' }, }, }), }, { - link: linkOptions({ - ...baseTestCase, - search: { - root: { - ssr: 'data-only', - expected: { data: 'server', render: 'client-only' }, - }, - posts: { - ssr: true, - expected: { data: 'server', render: 'client-only' }, - }, - postId: { - ssr: undefined, + link: createTestLink({ + root: { + ssr: 'data-only', + expected: { data: 'server', render: 'client-only' }, + }, + posts: { + ssr: true, + expected: { data: 'server', render: 'client-only' }, + }, + postId: { + ssr: undefined, - expected: { data: 'server', render: 'client-only' }, - }, + expected: { data: 'server', render: 'client-only' }, }, }), }, { - link: linkOptions({ - ...baseTestCase, - search: { - root: { - ssr: true, - expected: { data: 'server', render: 'server-and-client' }, - }, - posts: { - ssr: true, - expected: { data: 'server', render: 'server-and-client' }, - }, - postId: { - ssr: false, - expected: { data: 'client', render: 'client-only' }, - }, + link: createTestLink({ + root: { + ssr: true, + expected: { data: 'server', render: 'server-and-client' }, + }, + posts: { + ssr: true, + expected: { data: 'server', render: 'server-and-client' }, + }, + postId: { + ssr: false, + expected: { data: 'client', render: 'client-only' }, }, }), }, @@ -158,7 +153,13 @@ function Home() { return (
    - + root: {JSON.stringify(t.link.search.root.ssr ?? 'undefined')} posts:{' '} {JSON.stringify(t.link.search.posts.ssr ?? 'undefined')} $postId:{' '} {JSON.stringify(t.link.search.postId.ssr ?? 'undefined')} diff --git a/e2e/solid-start/selective-ssr/tests/pending-component-hydration.spec.ts b/e2e/solid-start/selective-ssr/tests/pending-component-hydration.spec.ts new file mode 100644 index 0000000000..5d1055a570 --- /dev/null +++ b/e2e/solid-start/selective-ssr/tests/pending-component-hydration.spec.ts @@ -0,0 +1,30 @@ +import { expect } from '@playwright/test' +import { collectBrowserErrors, test } from '@tanstack/router-e2e-utils' + +test.describe('pending component hydration', () => { + test('data-only route hydrates from pending element to loaded state on first load', async ({ + page, + }) => { + const browserErrors = collectBrowserErrors(page) + + await page.goto('/data-only-pending-component') + + await expect(page).toHaveURL(/data-only-pending-component/) + + await expect( + page.getByTestId('data-only-pending-component-pending'), + ).toBeAttached() + + await expect( + page.getByTestId('data-only-pending-component-ready-label'), + ).toHaveText('OK - loader finished', { timeout: 10_000 }) + + expect(browserErrors).toEqual([]) + expect(browserErrors).not.toContainEqual( + expect.stringContaining('template is not a function'), + ) + expect(browserErrors).not.toContainEqual( + expect.stringContaining('Hydration Mismatch'), + ) + }) +}) diff --git a/e2e/solid-start/serialization-adapters/package.json b/e2e/solid-start/serialization-adapters/package.json index 3ad0b1a2df..5ce3eb6fc4 100644 --- a/e2e/solid-start/serialization-adapters/package.json +++ b/e2e/solid-start/serialization-adapters/package.json @@ -9,7 +9,7 @@ "build": "vite build && tsc --noEmit", "preview": "vite preview", "start": "pnpx srvx --prod -s ../client dist/server/server.js", - "test:e2e": "exit 0; rm -rf port*.txt; playwright test --project=chromium" + "test:e2e": "rm -rf port*.txt; playwright test --project=chromium" }, "dependencies": { "@solidjs/web": "2.0.0-beta.14", @@ -17,9 +17,8 @@ "@tanstack/solid-router-devtools": "workspace:^", "@tanstack/solid-start": "workspace:^", "solid-js": "2.0.0-beta.14", - "vite": "^8.0.0", "vite-tsconfig-paths": "^5.1.4", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@tailwindcss/vite": "^4.2.2", @@ -28,6 +27,7 @@ "srvx": "^0.11.9", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite-plugin-solid": "^3.0.0-next.5" + "vite-plugin-solid": "^3.0.0-next.5", + "vite": "^8.0.14" } } diff --git a/e2e/solid-start/serialization-adapters/src/routes/ssr/stream.tsx b/e2e/solid-start/serialization-adapters/src/routes/ssr/stream.tsx index c821d94793..25085e3dc2 100644 --- a/e2e/solid-start/serialization-adapters/src/routes/ssr/stream.tsx +++ b/e2e/solid-start/serialization-adapters/src/routes/ssr/stream.tsx @@ -1,5 +1,4 @@ import { Await, createFileRoute } from '@tanstack/solid-router' -import { Loading } from 'solid-js' import { RenderData, makeData } from '~/data' export const Route = createFileRoute('/ssr/stream')({ @@ -23,11 +22,12 @@ function RouteComponent() {

    Stream

    {loaderData().someString}
    - Loading...
    }> - - {(data) => } - - + Loading...
    } + > + {(data) => } +
    ) } diff --git a/e2e/solid-start/server-functions/package.json b/e2e/solid-start/server-functions/package.json index 18b122907d..a551d1ded1 100644 --- a/e2e/solid-start/server-functions/package.json +++ b/e2e/solid-start/server-functions/package.json @@ -22,9 +22,8 @@ "js-cookie": "^3.0.5", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", - "tailwind-merge": "^2.6.0", - "vite": "^8.0.0", - "zod": "^3.24.2" + "tailwind-merge": "^3.6.0", + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -36,6 +35,7 @@ "srvx": "^0.11.9", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite-plugin-solid": "^3.0.0-next.5" + "vite-plugin-solid": "^3.0.0-next.5", + "vite": "^8.0.14" } } diff --git a/e2e/solid-start/server-functions/src/routes/cookies/index.tsx b/e2e/solid-start/server-functions/src/routes/cookies/index.tsx index 9abb86d0f7..5d3c64b6a0 100644 --- a/e2e/solid-start/server-functions/src/routes/cookies/index.tsx +++ b/e2e/solid-start/server-functions/src/routes/cookies/index.tsx @@ -2,7 +2,8 @@ import { Link, createFileRoute } from '@tanstack/solid-router' import { z } from 'zod' const cookieSchema = z - .object({ value: z.string() }) + .object({ value: z.string().default(() => `CLIENT-${Date.now()}`) }) + .prefault({}) .catch(() => ({ value: `CLIENT-${Date.now()}` })) export const Route = createFileRoute('/cookies/')({ validateSearch: cookieSchema, diff --git a/e2e/solid-start/server-functions/src/routes/dead-code-preserve.tsx b/e2e/solid-start/server-functions/src/routes/dead-code-preserve.tsx index 75806a65e3..2be8fa8bee 100644 --- a/e2e/solid-start/server-functions/src/routes/dead-code-preserve.tsx +++ b/e2e/solid-start/server-functions/src/routes/dead-code-preserve.tsx @@ -3,7 +3,6 @@ import * as fs from 'node:fs' import { createServerFn } from '@tanstack/solid-start' import { getRequestHeader } from '@tanstack/solid-start/server' import { createSignal } from 'solid-js' -import {} from '@tanstack/solid-router' export const Route = createFileRoute('/dead-code-preserve')({ component: RouteComponent, diff --git a/e2e/solid-start/server-routes/package.json b/e2e/solid-start/server-routes/package.json index 706b955515..a795a0030a 100644 --- a/e2e/solid-start/server-routes/package.json +++ b/e2e/solid-start/server-routes/package.json @@ -9,7 +9,7 @@ "build": "vite build && tsc --noEmit", "preview": "vite preview", "start": "pnpx srvx --prod -s ../client dist/server/server.js", - "test:e2e": "rm -rf port*.txt; playwright test --project=chromium" + "test:e2e": "playwright test --project=chromium" }, "dependencies": { "@solidjs/web": "2.0.0-beta.14", @@ -21,9 +21,8 @@ "js-cookie": "^3.0.5", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", - "tailwind-merge": "^2.6.0", - "vite": "^8.0.0", - "zod": "^3.24.2" + "tailwind-merge": "^3.6.0", + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -35,6 +34,7 @@ "srvx": "^0.11.9", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite-plugin-solid": "^3.0.0-next.5" + "vite-plugin-solid": "^3.0.0-next.5", + "vite": "^8.0.14" } } diff --git a/e2e/solid-start/solid-query-layout-suspense/package.json b/e2e/solid-start/solid-query-layout-suspense/package.json new file mode 100644 index 0000000000..e6fe34b8b9 --- /dev/null +++ b/e2e/solid-start/solid-query-layout-suspense/package.json @@ -0,0 +1,27 @@ +{ + "name": "tanstack-solid-start-e2e-solid-query-layout-suspense", + "private": true, + "type": "module", + "scripts": { + "dev": "vite dev --port 3000", + "dev:e2e": "vite dev --port $PORT", + "build": "vite build && tsc --noEmit", + "start": "node .output/server/index.mjs", + "test:e2e": "rm -rf port*.txt; playwright test --project=chromium" + }, + "dependencies": { + "@solidjs/web": "2.0.0-beta.14", + "@tanstack/solid-query": "^6.0.0-beta.4", + "@tanstack/solid-router": "workspace:^", + "@tanstack/solid-start": "workspace:^", + "solid-js": "2.0.0-beta.14" + }, + "devDependencies": { + "@playwright/test": "^1.50.1", + "@tanstack/router-e2e-utils": "workspace:^", + "@types/node": "^22.10.2", + "typescript": "^6.0.2", + "vite": "^8.0.14", + "vite-plugin-solid": "^3.0.0-next.5" + } +} diff --git a/e2e/solid-start/solid-query-layout-suspense/playwright.config.ts b/e2e/solid-start/solid-query-layout-suspense/playwright.config.ts new file mode 100644 index 0000000000..e7e18e60a7 --- /dev/null +++ b/e2e/solid-start/solid-query-layout-suspense/playwright.config.ts @@ -0,0 +1,25 @@ +import { defineConfig, devices } from '@playwright/test' +import { getTestServerPort } from '@tanstack/router-e2e-utils' +import packageJson from './package.json' with { type: 'json' } + +const PORT = await getTestServerPort(packageJson.name) +const baseURL = `http://localhost:${PORT}` + +export default defineConfig({ + testDir: './tests', + workers: 1, + reporter: [['line']], + use: { baseURL }, + webServer: { + command: `PORT=${PORT} VITE_SERVER_PORT=${PORT} pnpm dev:e2e`, + url: baseURL, + reuseExistingServer: !process.env.CI, + stdout: 'pipe', + }, + projects: [ + { + name: 'chromium', + use: { ...devices['Desktop Chrome'] }, + }, + ], +}) diff --git a/e2e/solid-start/solid-query-layout-suspense/src/routeTree.gen.ts b/e2e/solid-start/solid-query-layout-suspense/src/routeTree.gen.ts new file mode 100644 index 0000000000..e120a08bd4 --- /dev/null +++ b/e2e/solid-start/solid-query-layout-suspense/src/routeTree.gen.ts @@ -0,0 +1,113 @@ +/* eslint-disable */ + +// @ts-nocheck + +// noinspection JSUnusedGlobalSymbols + +// This file was automatically generated by TanStack Router. +// You should NOT make any changes in this file as it will be overwritten. +// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. + +import { Route as rootRouteImport } from './routes/__root' +import { Route as LayoutRouteImport } from './routes/layout' +import { Route as IndexRouteImport } from './routes/index' +import { Route as LayoutPage2RouteImport } from './routes/layout.page2' + +const LayoutRoute = LayoutRouteImport.update({ + id: '/layout', + path: '/layout', + getParentRoute: () => rootRouteImport, +} as any) +const IndexRoute = IndexRouteImport.update({ + id: '/', + path: '/', + getParentRoute: () => rootRouteImport, +} as any) +const LayoutPage2Route = LayoutPage2RouteImport.update({ + id: '/page2', + path: '/page2', + getParentRoute: () => LayoutRoute, +} as any) + +export interface FileRoutesByFullPath { + '/': typeof IndexRoute + '/layout': typeof LayoutRouteWithChildren + '/layout/page2': typeof LayoutPage2Route +} +export interface FileRoutesByTo { + '/': typeof IndexRoute + '/layout': typeof LayoutRouteWithChildren + '/layout/page2': typeof LayoutPage2Route +} +export interface FileRoutesById { + __root__: typeof rootRouteImport + '/': typeof IndexRoute + '/layout': typeof LayoutRouteWithChildren + '/layout/page2': typeof LayoutPage2Route +} +export interface FileRouteTypes { + fileRoutesByFullPath: FileRoutesByFullPath + fullPaths: '/' | '/layout' | '/layout/page2' + fileRoutesByTo: FileRoutesByTo + to: '/' | '/layout' | '/layout/page2' + id: '__root__' | '/' | '/layout' | '/layout/page2' + fileRoutesById: FileRoutesById +} +export interface RootRouteChildren { + IndexRoute: typeof IndexRoute + LayoutRoute: typeof LayoutRouteWithChildren +} + +declare module '@tanstack/solid-router' { + interface FileRoutesByPath { + '/layout': { + id: '/layout' + path: '/layout' + fullPath: '/layout' + preLoaderRoute: typeof LayoutRouteImport + parentRoute: typeof rootRouteImport + } + '/': { + id: '/' + path: '/' + fullPath: '/' + preLoaderRoute: typeof IndexRouteImport + parentRoute: typeof rootRouteImport + } + '/layout/page2': { + id: '/layout/page2' + path: '/page2' + fullPath: '/layout/page2' + preLoaderRoute: typeof LayoutPage2RouteImport + parentRoute: typeof LayoutRoute + } + } +} + +interface LayoutRouteChildren { + LayoutPage2Route: typeof LayoutPage2Route +} + +const LayoutRouteChildren: LayoutRouteChildren = { + LayoutPage2Route: LayoutPage2Route, +} + +const LayoutRouteWithChildren = + LayoutRoute._addFileChildren(LayoutRouteChildren) + +const rootRouteChildren: RootRouteChildren = { + IndexRoute: IndexRoute, + LayoutRoute: LayoutRouteWithChildren, +} +export const routeTree = rootRouteImport + ._addFileChildren(rootRouteChildren) + ._addFileTypes() + +import type { getRouter } from './router.tsx' +import type { createStart } from '@tanstack/solid-start' +declare module '@tanstack/solid-start' { + interface Register { + ssr: true + router: Awaited> + } +} diff --git a/e2e/solid-start/solid-query-layout-suspense/src/router.tsx b/e2e/solid-start/solid-query-layout-suspense/src/router.tsx new file mode 100644 index 0000000000..9e1a2eeffa --- /dev/null +++ b/e2e/solid-start/solid-query-layout-suspense/src/router.tsx @@ -0,0 +1,21 @@ +import { QueryClient, QueryClientProvider } from '@tanstack/solid-query' +import { createRouter } from '@tanstack/solid-router' +import { routeTree } from './routeTree.gen' + +export function getRouter() { + const queryClient = new QueryClient() + return createRouter({ + routeTree, + Wrap: (props) => ( + + {props.children} + + ), + }) +} + +declare module '@tanstack/solid-router' { + interface Register { + router: ReturnType + } +} diff --git a/e2e/solid-start/solid-query-layout-suspense/src/routes/__root.tsx b/e2e/solid-start/solid-query-layout-suspense/src/routes/__root.tsx new file mode 100644 index 0000000000..6c6ece192e --- /dev/null +++ b/e2e/solid-start/solid-query-layout-suspense/src/routes/__root.tsx @@ -0,0 +1,32 @@ +import { + HeadContent, + Link, + Outlet, + Scripts, + createRootRouteWithContext, +} from '@tanstack/solid-router' +import { Loading } from 'solid-js' + +export const Route = createRootRouteWithContext()({ + head: () => ({ meta: [{ charset: 'utf-8' }] }), + shellComponent: RootDocument, +}) + +function RootDocument() { + return ( + + + + + + + + + + + + + ) +} diff --git a/e2e/solid-start/solid-query-layout-suspense/src/routes/index.tsx b/e2e/solid-start/solid-query-layout-suspense/src/routes/index.tsx new file mode 100644 index 0000000000..285c0530e0 --- /dev/null +++ b/e2e/solid-start/solid-query-layout-suspense/src/routes/index.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/solid-router' + +export const Route = createFileRoute('/')({ + component: () =>
    Home page
    , +}) diff --git a/e2e/solid-start/solid-query-layout-suspense/src/routes/layout.page2.tsx b/e2e/solid-start/solid-query-layout-suspense/src/routes/layout.page2.tsx new file mode 100644 index 0000000000..759bfd59f6 --- /dev/null +++ b/e2e/solid-start/solid-query-layout-suspense/src/routes/layout.page2.tsx @@ -0,0 +1,19 @@ +import { useQuery } from '@tanstack/solid-query' +import { createFileRoute } from '@tanstack/solid-router' + +export const Route = createFileRoute('/layout/page2')({ + component: RouteComponent, +}) + +function RouteComponent() { + const query = useQuery(() => ({ + queryKey: ['page2'], + queryFn: async () => ({ data: 'page2-data' }), + })) + + return ( +
    + Page data: {JSON.stringify(query.data)} +
    + ) +} diff --git a/e2e/solid-start/solid-query-layout-suspense/src/routes/layout.tsx b/e2e/solid-start/solid-query-layout-suspense/src/routes/layout.tsx new file mode 100644 index 0000000000..172549a214 --- /dev/null +++ b/e2e/solid-start/solid-query-layout-suspense/src/routes/layout.tsx @@ -0,0 +1,25 @@ +import { useQuery } from '@tanstack/solid-query' +import { Outlet, createFileRoute } from '@tanstack/solid-router' + +export const Route = createFileRoute('/layout')({ + component: RouteComponent, +}) + +function RouteComponent() { + const query = useQuery(() => ({ + queryKey: ['layout'], + queryFn: async () => { + await new Promise((r) => setTimeout(r, 200)) + return { data: 'layout-data' } + }, + })) + + return ( +
    +
    +        Layout data: {JSON.stringify(query.data?.data)}
    +      
    + +
    + ) +} diff --git a/e2e/solid-start/solid-query-layout-suspense/tests/app.spec.ts b/e2e/solid-start/solid-query-layout-suspense/tests/app.spec.ts new file mode 100644 index 0000000000..9552a71bf7 --- /dev/null +++ b/e2e/solid-start/solid-query-layout-suspense/tests/app.spec.ts @@ -0,0 +1,17 @@ +import { expect, test } from '@playwright/test' + +// Reproduces https://github.com/TanStack/router/issues/7195 +test('layout with useQuery renders child after client navigation', async ({ + page, +}) => { + await page.goto('/') + await expect(page.getByText('👉 To page2')).toBeVisible() + await page.waitForLoadState('networkidle') + + await page.getByText('👉 To page2').click() + + await expect(page.getByTestId('page2-content')).toBeVisible({ + timeout: 5_000, + }) + await expect(page.getByTestId('layout-content')).toBeVisible() +}) diff --git a/e2e/solid-start/solid-query-layout-suspense/tsconfig.json b/e2e/solid-start/solid-query-layout-suspense/tsconfig.json new file mode 100644 index 0000000000..dc582bc115 --- /dev/null +++ b/e2e/solid-start/solid-query-layout-suspense/tsconfig.json @@ -0,0 +1,15 @@ +{ + "include": ["**/*.ts", "**/*.tsx"], + "compilerOptions": { + "strict": true, + "jsx": "preserve", + "jsxImportSource": "@solidjs/web", + "module": "ESNext", + "moduleResolution": "Bundler", + "lib": ["DOM", "DOM.Iterable", "ES2022"], + "target": "ES2022", + "skipLibCheck": true, + "noEmit": true, + "types": ["vite/client"] + } +} diff --git a/e2e/solid-start/solid-query-layout-suspense/vite.config.ts b/e2e/solid-start/solid-query-layout-suspense/vite.config.ts new file mode 100644 index 0000000000..e1c2d5526c --- /dev/null +++ b/e2e/solid-start/solid-query-layout-suspense/vite.config.ts @@ -0,0 +1,7 @@ +import { defineConfig } from 'vite' +import { tanstackStart } from '@tanstack/solid-start/plugin/vite' +import solid from 'vite-plugin-solid' + +export default defineConfig({ + plugins: [tanstackStart(), solid({ ssr: true })], +}) diff --git a/e2e/solid-start/spa-mode/package.json b/e2e/solid-start/spa-mode/package.json index d4460ceab4..6cb2463e47 100644 --- a/e2e/solid-start/spa-mode/package.json +++ b/e2e/solid-start/spa-mode/package.json @@ -9,7 +9,7 @@ "build": "vite build && tsc --noEmit", "preview": "vite preview", "start": "npx serve dist/client", - "test:e2e": "exit 0; rm -rf port*.txt; playwright test --project=chromium" + "test:e2e": "rm -rf port*.txt; playwright test --project=chromium" }, "dependencies": { "@solidjs/web": "2.0.0-beta.14", @@ -17,14 +17,14 @@ "@tanstack/solid-router-devtools": "workspace:^", "@tanstack/solid-start": "workspace:^", "solid-js": "2.0.0-beta.14", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@tailwindcss/vite": "^4.2.2", "@tanstack/router-e2e-utils": "workspace:^", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5", "vite-tsconfig-paths": "^5.1.4" } diff --git a/e2e/solid-start/start-manifest/package.json b/e2e/solid-start/start-manifest/package.json new file mode 100644 index 0000000000..9e43068d9a --- /dev/null +++ b/e2e/solid-start/start-manifest/package.json @@ -0,0 +1,34 @@ +{ + "name": "tanstack-solid-start-e2e-start-manifest", + "private": true, + "sideEffects": false, + "type": "module", + "scripts": { + "build": "vite build && tsc --noEmit", + "preview": "vite preview", + "start": "pnpx srvx --prod -s ../client dist/server/server.js", + "test:e2e": "playwright test --project=chromium" + }, + "dependencies": { + "@solidjs/web": "2.0.0-beta.14", + "@tanstack/solid-router": "workspace:^", + "@tanstack/solid-start": "workspace:^", + "solid-js": "2.0.0-beta.14" + }, + "devDependencies": { + "@playwright/test": "^1.50.1", + "@tanstack/router-e2e-utils": "workspace:^", + "@types/node": "^22.10.2", + "srvx": "^0.11.9", + "typescript": "^6.0.2", + "vite": "^8.0.14", + "vite-plugin-solid": "^3.0.0-next.5" + }, + "nx": { + "targets": { + "test:e2e": { + "parallelism": false + } + } + } +} diff --git a/e2e/solid-start/start-manifest/playwright.config.ts b/e2e/solid-start/start-manifest/playwright.config.ts new file mode 100644 index 0000000000..b9f835c16a --- /dev/null +++ b/e2e/solid-start/start-manifest/playwright.config.ts @@ -0,0 +1,30 @@ +import { defineConfig, devices } from '@playwright/test' +import { getTestServerPort } from '@tanstack/router-e2e-utils' +import packageJson from './package.json' with { type: 'json' } + +const PORT = await getTestServerPort(packageJson.name) +const baseURL = `http://localhost:${PORT}` + +export default defineConfig({ + testDir: './tests', + workers: 1, + reporter: [['line']], + + use: { + baseURL, + }, + + webServer: { + command: `pnpm build && PORT=${PORT} pnpm start`, + url: baseURL, + reuseExistingServer: !process.env.CI, + stdout: 'pipe', + }, + + projects: [ + { + name: 'chromium', + use: { ...devices['Desktop Chrome'] }, + }, + ], +}) diff --git a/e2e/solid-start/start-manifest/src/components/AppShell.tsx b/e2e/solid-start/start-manifest/src/components/AppShell.tsx new file mode 100644 index 0000000000..cb1101c0c4 --- /dev/null +++ b/e2e/solid-start/start-manifest/src/components/AppShell.tsx @@ -0,0 +1,38 @@ +/// +import { ClientOnly, Link, Outlet, linkOptions } from '@tanstack/solid-router' +import styles from '~/styles/root-shell.module.css' + +const ROUTES = linkOptions([ + { to: '/', label: 'home' }, + { to: '/a', label: '/a' }, + { to: '/b', label: '/b' }, + { to: '/lazy-css-static', label: '/lazy-css-static' }, + { to: '/lazy-css-lazy', label: '/lazy-css-lazy' }, + { to: '/r1', label: '/r1' }, + { to: '/r2', label: '/r2' }, + { to: '/shared-a', label: '/shared-a' }, +]) + +export function AppShell() { + return ( +
    + + +
    +
    + Start manifest CSS root shell +
    + +
    hydrated
    +
    + +
    +
    + ) +} diff --git a/e2e/solid-start/start-manifest/src/components/SharedCard.tsx b/e2e/solid-start/start-manifest/src/components/SharedCard.tsx new file mode 100644 index 0000000000..c82b2b0ea5 --- /dev/null +++ b/e2e/solid-start/start-manifest/src/components/SharedCard.tsx @@ -0,0 +1,10 @@ +/// +import styles from '~/styles/shared-card.module.css' + +export function SharedCard({ label }: { label: string }) { + return ( +
    + Shared card {label} +
    + ) +} diff --git a/e2e/solid-start/start-manifest/src/components/SharedNestedLayout.tsx b/e2e/solid-start/start-manifest/src/components/SharedNestedLayout.tsx new file mode 100644 index 0000000000..5e86c0e8ad --- /dev/null +++ b/e2e/solid-start/start-manifest/src/components/SharedNestedLayout.tsx @@ -0,0 +1,31 @@ +/// +import { Link, linkOptions } from '@tanstack/solid-router' +import styles from '~/styles/shared-layout.module.css' + +const ROUTES = linkOptions([ + { to: '/shared-a', label: '/shared-a' }, + { to: '/shared-b', label: '/shared-b' }, + { to: '/shared-c', label: '/shared-c' }, +]) + +export function SharedNestedLayout(props: { children?: any }) { + return ( +
    +
    + Shared nested layout CSS +
    + + + +
    + {props.children} +
    +
    + ) +} diff --git a/e2e/solid-start/start-manifest/src/components/SharedWidget.tsx b/e2e/solid-start/start-manifest/src/components/SharedWidget.tsx new file mode 100644 index 0000000000..9074d5b2b0 --- /dev/null +++ b/e2e/solid-start/start-manifest/src/components/SharedWidget.tsx @@ -0,0 +1,15 @@ +/// +import styles from '~/styles/shared-widget.module.css' + +export function SharedWidget() { + return ( +
    +
    + Shared widget styles +
    +
    + This widget uses CSS shared by a static route and a lazy route. +
    +
    + ) +} diff --git a/e2e/solid-start/start-manifest/src/components/SharedWidgetLazy.tsx b/e2e/solid-start/start-manifest/src/components/SharedWidgetLazy.tsx new file mode 100644 index 0000000000..5f1f6410a5 --- /dev/null +++ b/e2e/solid-start/start-manifest/src/components/SharedWidgetLazy.tsx @@ -0,0 +1,5 @@ +import { SharedWidget } from './SharedWidget' + +export default function SharedWidgetLazy() { + return +} diff --git a/e2e/solid-start/start-manifest/src/routeTree.gen.ts b/e2e/solid-start/start-manifest/src/routeTree.gen.ts new file mode 100644 index 0000000000..982f80b150 --- /dev/null +++ b/e2e/solid-start/start-manifest/src/routeTree.gen.ts @@ -0,0 +1,345 @@ +/* eslint-disable */ + +// @ts-nocheck + +// noinspection JSUnusedGlobalSymbols + +// This file was automatically generated by TanStack Router. +// You should NOT make any changes in this file as it will be overwritten. +// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. + +import { Route as rootRouteImport } from './routes/__root' +import { Route as SharedCRouteImport } from './routes/shared-c' +import { Route as SharedBRouteImport } from './routes/shared-b' +import { Route as SharedARouteImport } from './routes/shared-a' +import { Route as R6RouteImport } from './routes/r6' +import { Route as R5RouteImport } from './routes/r5' +import { Route as R4RouteImport } from './routes/r4' +import { Route as R3RouteImport } from './routes/r3' +import { Route as R2RouteImport } from './routes/r2' +import { Route as R1RouteImport } from './routes/r1' +import { Route as LazyCssStaticRouteImport } from './routes/lazy-css-static' +import { Route as LazyCssLazyRouteImport } from './routes/lazy-css-lazy' +import { Route as BRouteImport } from './routes/b' +import { Route as ARouteImport } from './routes/a' +import { Route as IndexRouteImport } from './routes/index' + +const SharedCRoute = SharedCRouteImport.update({ + id: '/shared-c', + path: '/shared-c', + getParentRoute: () => rootRouteImport, +} as any) +const SharedBRoute = SharedBRouteImport.update({ + id: '/shared-b', + path: '/shared-b', + getParentRoute: () => rootRouteImport, +} as any) +const SharedARoute = SharedARouteImport.update({ + id: '/shared-a', + path: '/shared-a', + getParentRoute: () => rootRouteImport, +} as any) +const R6Route = R6RouteImport.update({ + id: '/r6', + path: '/r6', + getParentRoute: () => rootRouteImport, +} as any) +const R5Route = R5RouteImport.update({ + id: '/r5', + path: '/r5', + getParentRoute: () => rootRouteImport, +} as any) +const R4Route = R4RouteImport.update({ + id: '/r4', + path: '/r4', + getParentRoute: () => rootRouteImport, +} as any) +const R3Route = R3RouteImport.update({ + id: '/r3', + path: '/r3', + getParentRoute: () => rootRouteImport, +} as any) +const R2Route = R2RouteImport.update({ + id: '/r2', + path: '/r2', + getParentRoute: () => rootRouteImport, +} as any) +const R1Route = R1RouteImport.update({ + id: '/r1', + path: '/r1', + getParentRoute: () => rootRouteImport, +} as any) +const LazyCssStaticRoute = LazyCssStaticRouteImport.update({ + id: '/lazy-css-static', + path: '/lazy-css-static', + getParentRoute: () => rootRouteImport, +} as any) +const LazyCssLazyRoute = LazyCssLazyRouteImport.update({ + id: '/lazy-css-lazy', + path: '/lazy-css-lazy', + getParentRoute: () => rootRouteImport, +} as any) +const BRoute = BRouteImport.update({ + id: '/b', + path: '/b', + getParentRoute: () => rootRouteImport, +} as any) +const ARoute = ARouteImport.update({ + id: '/a', + path: '/a', + getParentRoute: () => rootRouteImport, +} as any) +const IndexRoute = IndexRouteImport.update({ + id: '/', + path: '/', + getParentRoute: () => rootRouteImport, +} as any) + +export interface FileRoutesByFullPath { + '/': typeof IndexRoute + '/a': typeof ARoute + '/b': typeof BRoute + '/lazy-css-lazy': typeof LazyCssLazyRoute + '/lazy-css-static': typeof LazyCssStaticRoute + '/r1': typeof R1Route + '/r2': typeof R2Route + '/r3': typeof R3Route + '/r4': typeof R4Route + '/r5': typeof R5Route + '/r6': typeof R6Route + '/shared-a': typeof SharedARoute + '/shared-b': typeof SharedBRoute + '/shared-c': typeof SharedCRoute +} +export interface FileRoutesByTo { + '/': typeof IndexRoute + '/a': typeof ARoute + '/b': typeof BRoute + '/lazy-css-lazy': typeof LazyCssLazyRoute + '/lazy-css-static': typeof LazyCssStaticRoute + '/r1': typeof R1Route + '/r2': typeof R2Route + '/r3': typeof R3Route + '/r4': typeof R4Route + '/r5': typeof R5Route + '/r6': typeof R6Route + '/shared-a': typeof SharedARoute + '/shared-b': typeof SharedBRoute + '/shared-c': typeof SharedCRoute +} +export interface FileRoutesById { + __root__: typeof rootRouteImport + '/': typeof IndexRoute + '/a': typeof ARoute + '/b': typeof BRoute + '/lazy-css-lazy': typeof LazyCssLazyRoute + '/lazy-css-static': typeof LazyCssStaticRoute + '/r1': typeof R1Route + '/r2': typeof R2Route + '/r3': typeof R3Route + '/r4': typeof R4Route + '/r5': typeof R5Route + '/r6': typeof R6Route + '/shared-a': typeof SharedARoute + '/shared-b': typeof SharedBRoute + '/shared-c': typeof SharedCRoute +} +export interface FileRouteTypes { + fileRoutesByFullPath: FileRoutesByFullPath + fullPaths: + | '/' + | '/a' + | '/b' + | '/lazy-css-lazy' + | '/lazy-css-static' + | '/r1' + | '/r2' + | '/r3' + | '/r4' + | '/r5' + | '/r6' + | '/shared-a' + | '/shared-b' + | '/shared-c' + fileRoutesByTo: FileRoutesByTo + to: + | '/' + | '/a' + | '/b' + | '/lazy-css-lazy' + | '/lazy-css-static' + | '/r1' + | '/r2' + | '/r3' + | '/r4' + | '/r5' + | '/r6' + | '/shared-a' + | '/shared-b' + | '/shared-c' + id: + | '__root__' + | '/' + | '/a' + | '/b' + | '/lazy-css-lazy' + | '/lazy-css-static' + | '/r1' + | '/r2' + | '/r3' + | '/r4' + | '/r5' + | '/r6' + | '/shared-a' + | '/shared-b' + | '/shared-c' + fileRoutesById: FileRoutesById +} +export interface RootRouteChildren { + IndexRoute: typeof IndexRoute + ARoute: typeof ARoute + BRoute: typeof BRoute + LazyCssLazyRoute: typeof LazyCssLazyRoute + LazyCssStaticRoute: typeof LazyCssStaticRoute + R1Route: typeof R1Route + R2Route: typeof R2Route + R3Route: typeof R3Route + R4Route: typeof R4Route + R5Route: typeof R5Route + R6Route: typeof R6Route + SharedARoute: typeof SharedARoute + SharedBRoute: typeof SharedBRoute + SharedCRoute: typeof SharedCRoute +} + +declare module '@tanstack/solid-router' { + interface FileRoutesByPath { + '/shared-c': { + id: '/shared-c' + path: '/shared-c' + fullPath: '/shared-c' + preLoaderRoute: typeof SharedCRouteImport + parentRoute: typeof rootRouteImport + } + '/shared-b': { + id: '/shared-b' + path: '/shared-b' + fullPath: '/shared-b' + preLoaderRoute: typeof SharedBRouteImport + parentRoute: typeof rootRouteImport + } + '/shared-a': { + id: '/shared-a' + path: '/shared-a' + fullPath: '/shared-a' + preLoaderRoute: typeof SharedARouteImport + parentRoute: typeof rootRouteImport + } + '/r6': { + id: '/r6' + path: '/r6' + fullPath: '/r6' + preLoaderRoute: typeof R6RouteImport + parentRoute: typeof rootRouteImport + } + '/r5': { + id: '/r5' + path: '/r5' + fullPath: '/r5' + preLoaderRoute: typeof R5RouteImport + parentRoute: typeof rootRouteImport + } + '/r4': { + id: '/r4' + path: '/r4' + fullPath: '/r4' + preLoaderRoute: typeof R4RouteImport + parentRoute: typeof rootRouteImport + } + '/r3': { + id: '/r3' + path: '/r3' + fullPath: '/r3' + preLoaderRoute: typeof R3RouteImport + parentRoute: typeof rootRouteImport + } + '/r2': { + id: '/r2' + path: '/r2' + fullPath: '/r2' + preLoaderRoute: typeof R2RouteImport + parentRoute: typeof rootRouteImport + } + '/r1': { + id: '/r1' + path: '/r1' + fullPath: '/r1' + preLoaderRoute: typeof R1RouteImport + parentRoute: typeof rootRouteImport + } + '/lazy-css-static': { + id: '/lazy-css-static' + path: '/lazy-css-static' + fullPath: '/lazy-css-static' + preLoaderRoute: typeof LazyCssStaticRouteImport + parentRoute: typeof rootRouteImport + } + '/lazy-css-lazy': { + id: '/lazy-css-lazy' + path: '/lazy-css-lazy' + fullPath: '/lazy-css-lazy' + preLoaderRoute: typeof LazyCssLazyRouteImport + parentRoute: typeof rootRouteImport + } + '/b': { + id: '/b' + path: '/b' + fullPath: '/b' + preLoaderRoute: typeof BRouteImport + parentRoute: typeof rootRouteImport + } + '/a': { + id: '/a' + path: '/a' + fullPath: '/a' + preLoaderRoute: typeof ARouteImport + parentRoute: typeof rootRouteImport + } + '/': { + id: '/' + path: '/' + fullPath: '/' + preLoaderRoute: typeof IndexRouteImport + parentRoute: typeof rootRouteImport + } + } +} + +const rootRouteChildren: RootRouteChildren = { + IndexRoute: IndexRoute, + ARoute: ARoute, + BRoute: BRoute, + LazyCssLazyRoute: LazyCssLazyRoute, + LazyCssStaticRoute: LazyCssStaticRoute, + R1Route: R1Route, + R2Route: R2Route, + R3Route: R3Route, + R4Route: R4Route, + R5Route: R5Route, + R6Route: R6Route, + SharedARoute: SharedARoute, + SharedBRoute: SharedBRoute, + SharedCRoute: SharedCRoute, +} +export const routeTree = rootRouteImport + ._addFileChildren(rootRouteChildren) + ._addFileTypes() + +import type { getRouter } from './router.tsx' +import type { createStart } from '@tanstack/solid-start' +declare module '@tanstack/solid-start' { + interface Register { + ssr: true + router: Awaited> + } +} diff --git a/e2e/solid-start/start-manifest/src/router.tsx b/e2e/solid-start/start-manifest/src/router.tsx new file mode 100644 index 0000000000..801095c695 --- /dev/null +++ b/e2e/solid-start/start-manifest/src/router.tsx @@ -0,0 +1,18 @@ +import { createRouter } from '@tanstack/solid-router' +import { routeTree } from './routeTree.gen' + +export const getRouter = () => { + const router = createRouter({ + routeTree, + scrollRestoration: true, + defaultPreload: 'intent', + }) + + return router +} + +declare module '@tanstack/solid-router' { + interface Register { + router: ReturnType + } +} diff --git a/e2e/solid-start/start-manifest/src/routes/__root.tsx b/e2e/solid-start/start-manifest/src/routes/__root.tsx new file mode 100644 index 0000000000..0f7a8d35bd --- /dev/null +++ b/e2e/solid-start/start-manifest/src/routes/__root.tsx @@ -0,0 +1,27 @@ +import { HeadContent, Scripts, createRootRoute } from '@tanstack/solid-router' +import { AppShell } from '~/components/AppShell' + +export const Route = createRootRoute({ + head: () => ({ + meta: [ + { charSet: 'utf-8' }, + { name: 'viewport', content: 'width=device-width, initial-scale=1' }, + { title: 'TanStack Start Manifest Bloat E2E' }, + ], + }), + component: RootComponent, +}) + +function RootComponent() { + return ( + + + + + + + + + + ) +} diff --git a/e2e/solid-start/start-manifest/src/routes/a.tsx b/e2e/solid-start/start-manifest/src/routes/a.tsx new file mode 100644 index 0000000000..d9cda03adc --- /dev/null +++ b/e2e/solid-start/start-manifest/src/routes/a.tsx @@ -0,0 +1,18 @@ +/// +import { createFileRoute } from '@tanstack/solid-router' +import { SharedCard } from '~/components/SharedCard' +import styles from '~/styles/page-a.module.css' + +export const Route = createFileRoute('/a')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( +
    +

    Route /a

    +

    Route /a keeps the shared card styled.

    + +
    + ) +} diff --git a/e2e/solid-start/start-manifest/src/routes/b.tsx b/e2e/solid-start/start-manifest/src/routes/b.tsx new file mode 100644 index 0000000000..fd17811d56 --- /dev/null +++ b/e2e/solid-start/start-manifest/src/routes/b.tsx @@ -0,0 +1,18 @@ +/// +import { createFileRoute } from '@tanstack/solid-router' +import { SharedCard } from '~/components/SharedCard' +import styles from '~/styles/page-b.module.css' + +export const Route = createFileRoute('/b')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( +
    +

    Route /b

    +

    Route /b should keep the shared card stylesheet after nav.

    + +
    + ) +} diff --git a/e2e/solid-start/start-manifest/src/routes/index.tsx b/e2e/solid-start/start-manifest/src/routes/index.tsx new file mode 100644 index 0000000000..e61358aa7b --- /dev/null +++ b/e2e/solid-start/start-manifest/src/routes/index.tsx @@ -0,0 +1,16 @@ +import { createFileRoute } from '@tanstack/solid-router' + +export const Route = createFileRoute('/')({ + component: HomeRoute, +}) + +function HomeRoute() { + return ( +
    +

    Start manifest fixture

    +

    + Use this page to navigate between CSS module routes. +

    +
    + ) +} diff --git a/e2e/solid-start/start-manifest/src/routes/lazy-css-lazy.tsx b/e2e/solid-start/start-manifest/src/routes/lazy-css-lazy.tsx new file mode 100644 index 0000000000..911d1bb111 --- /dev/null +++ b/e2e/solid-start/start-manifest/src/routes/lazy-css-lazy.tsx @@ -0,0 +1,26 @@ +import { createFileRoute } from '@tanstack/solid-router' +import { Loading, lazy } from 'solid-js' + +const LazySharedWidget = lazy(() => import('~/components/SharedWidgetLazy')) + +export const Route = createFileRoute('/lazy-css-lazy')({ + component: LazyCssLazyRoute, +}) + +function LazyCssLazyRoute() { + return ( +
    +

    Lazy CSS Repro - Lazy Route

    +

    + This route renders the same widget through a lazy component so the CSS + only exists behind a dynamic import boundary. +

    + + Loading...} + > + + +
    + ) +} diff --git a/e2e/solid-start/start-manifest/src/routes/lazy-css-static.tsx b/e2e/solid-start/start-manifest/src/routes/lazy-css-static.tsx new file mode 100644 index 0000000000..1112c8ae90 --- /dev/null +++ b/e2e/solid-start/start-manifest/src/routes/lazy-css-static.tsx @@ -0,0 +1,24 @@ +import { ClientOnly, createFileRoute } from '@tanstack/solid-router' +import { SharedWidget } from '~/components/SharedWidget' + +export const Route = createFileRoute('/lazy-css-static')({ + component: LazyCssStaticRoute, +}) + +function LazyCssStaticRoute() { + return ( +
    +

    Lazy CSS Repro - Static Route

    +

    + This route statically imports the shared widget so its CSS is present in + the SSR head. +

    + + +
    hydrated
    +
    + + +
    + ) +} diff --git a/e2e/solid-start/start-manifest/src/routes/r1.tsx b/e2e/solid-start/start-manifest/src/routes/r1.tsx new file mode 100644 index 0000000000..d3979ecaf1 --- /dev/null +++ b/e2e/solid-start/start-manifest/src/routes/r1.tsx @@ -0,0 +1,18 @@ +/// +import { createFileRoute } from '@tanstack/solid-router' +import styles from '~/styles/route-one.module.css' + +export const Route = createFileRoute('/r1')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( +
    +

    Route /r1

    +
    + Route /r1 CSS module styling +
    +
    + ) +} diff --git a/e2e/solid-start/start-manifest/src/routes/r2.tsx b/e2e/solid-start/start-manifest/src/routes/r2.tsx new file mode 100644 index 0000000000..836257cd2e --- /dev/null +++ b/e2e/solid-start/start-manifest/src/routes/r2.tsx @@ -0,0 +1,18 @@ +/// +import { createFileRoute } from '@tanstack/solid-router' +import styles from '~/styles/route-two.module.css' + +export const Route = createFileRoute('/r2')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( +
    +

    Route /r2

    +
    + Route /r2 CSS module styling +
    +
    + ) +} diff --git a/e2e/solid-start/start-manifest/src/routes/r3.tsx b/e2e/solid-start/start-manifest/src/routes/r3.tsx new file mode 100644 index 0000000000..178a4b2a41 --- /dev/null +++ b/e2e/solid-start/start-manifest/src/routes/r3.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/solid-router' + +export const Route = createFileRoute('/r3')({ + component: () =>
    Route /r3
    , +}) diff --git a/e2e/solid-start/start-manifest/src/routes/r4.tsx b/e2e/solid-start/start-manifest/src/routes/r4.tsx new file mode 100644 index 0000000000..c625e4961e --- /dev/null +++ b/e2e/solid-start/start-manifest/src/routes/r4.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/solid-router' + +export const Route = createFileRoute('/r4')({ + component: () =>
    Route /r4
    , +}) diff --git a/e2e/solid-start/start-manifest/src/routes/r5.tsx b/e2e/solid-start/start-manifest/src/routes/r5.tsx new file mode 100644 index 0000000000..d4f5dcb95f --- /dev/null +++ b/e2e/solid-start/start-manifest/src/routes/r5.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/solid-router' + +export const Route = createFileRoute('/r5')({ + component: () =>
    Route /r5
    , +}) diff --git a/e2e/solid-start/start-manifest/src/routes/r6.tsx b/e2e/solid-start/start-manifest/src/routes/r6.tsx new file mode 100644 index 0000000000..235ff13538 --- /dev/null +++ b/e2e/solid-start/start-manifest/src/routes/r6.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/solid-router' + +export const Route = createFileRoute('/r6')({ + component: () =>
    Route /r6
    , +}) diff --git a/e2e/solid-start/start-manifest/src/routes/shared-a.tsx b/e2e/solid-start/start-manifest/src/routes/shared-a.tsx new file mode 100644 index 0000000000..ccb94d1e46 --- /dev/null +++ b/e2e/solid-start/start-manifest/src/routes/shared-a.tsx @@ -0,0 +1,14 @@ +import { createFileRoute } from '@tanstack/solid-router' +import { SharedNestedLayout } from '~/components/SharedNestedLayout' + +export const Route = createFileRoute('/shared-a')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( + +
    Shared route A
    +
    + ) +} diff --git a/e2e/solid-start/start-manifest/src/routes/shared-b.tsx b/e2e/solid-start/start-manifest/src/routes/shared-b.tsx new file mode 100644 index 0000000000..ced02fcf12 --- /dev/null +++ b/e2e/solid-start/start-manifest/src/routes/shared-b.tsx @@ -0,0 +1,14 @@ +import { createFileRoute } from '@tanstack/solid-router' +import { SharedNestedLayout } from '~/components/SharedNestedLayout' + +export const Route = createFileRoute('/shared-b')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( + +
    Shared route B
    +
    + ) +} diff --git a/e2e/solid-start/start-manifest/src/routes/shared-c.tsx b/e2e/solid-start/start-manifest/src/routes/shared-c.tsx new file mode 100644 index 0000000000..9b8ea62f3f --- /dev/null +++ b/e2e/solid-start/start-manifest/src/routes/shared-c.tsx @@ -0,0 +1,14 @@ +import { createFileRoute } from '@tanstack/solid-router' +import { SharedNestedLayout } from '~/components/SharedNestedLayout' + +export const Route = createFileRoute('/shared-c')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( + +
    Shared route C
    +
    + ) +} diff --git a/e2e/solid-start/start-manifest/src/styles/page-a.module.css b/e2e/solid-start/start-manifest/src/styles/page-a.module.css new file mode 100644 index 0000000000..7ed4301097 --- /dev/null +++ b/e2e/solid-start/start-manifest/src/styles/page-a.module.css @@ -0,0 +1,10 @@ +.page { + padding: 1rem; + min-height: 12rem; + background: rgb(240, 253, 244); + border: 4px solid rgb(22, 163, 74); +} + +.title { + color: rgb(21, 128, 61); +} diff --git a/e2e/solid-start/start-manifest/src/styles/page-b.module.css b/e2e/solid-start/start-manifest/src/styles/page-b.module.css new file mode 100644 index 0000000000..93d1d39a01 --- /dev/null +++ b/e2e/solid-start/start-manifest/src/styles/page-b.module.css @@ -0,0 +1,10 @@ +.page { + padding: 1rem; + min-height: 12rem; + background: rgb(239, 246, 255); + border: 4px solid rgb(37, 99, 235); +} + +.title { + color: rgb(29, 78, 216); +} diff --git a/e2e/solid-start/start-manifest/src/styles/root-shell.module.css b/e2e/solid-start/start-manifest/src/styles/root-shell.module.css new file mode 100644 index 0000000000..e7bece8664 --- /dev/null +++ b/e2e/solid-start/start-manifest/src/styles/root-shell.module.css @@ -0,0 +1,37 @@ +.shell { + font-family: + -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; + min-height: 100vh; + background: rgb(248, 250, 252); + color: rgb(15, 23, 42); +} + +.nav { + display: flex; + flex-wrap: wrap; + gap: 0.75rem; + padding: 1rem; + border-bottom: 1px solid rgb(226, 232, 240); + background: white; +} + +.nav a { + color: rgb(37, 99, 235); + text-decoration: none; +} + +.content { + max-width: 760px; + margin: 0 auto; + padding: 1.5rem 1rem 3rem; +} + +.rootBadge { + display: inline-block; + margin-bottom: 1rem; + padding: 0.375rem 0.75rem; + border-radius: 9999px; + background: rgb(220, 252, 231); + color: rgb(22, 101, 52); + font-weight: 700; +} diff --git a/e2e/solid-start/start-manifest/src/styles/route-one.module.css b/e2e/solid-start/start-manifest/src/styles/route-one.module.css new file mode 100644 index 0000000000..623d03e6a3 --- /dev/null +++ b/e2e/solid-start/start-manifest/src/styles/route-one.module.css @@ -0,0 +1,7 @@ +.card { + padding: 1rem; + border-radius: 0.75rem; + background: rgb(239, 246, 255); + color: rgb(30, 64, 175); + border: 2px solid rgb(96, 165, 250); +} diff --git a/e2e/solid-start/start-manifest/src/styles/route-two.module.css b/e2e/solid-start/start-manifest/src/styles/route-two.module.css new file mode 100644 index 0000000000..66ed355711 --- /dev/null +++ b/e2e/solid-start/start-manifest/src/styles/route-two.module.css @@ -0,0 +1,7 @@ +.card { + padding: 1rem; + border-radius: 0.75rem; + background: rgb(250, 245, 255); + color: rgb(126, 34, 206); + border: 2px solid rgb(192, 132, 252); +} diff --git a/e2e/solid-start/start-manifest/src/styles/shared-card.module.css b/e2e/solid-start/start-manifest/src/styles/shared-card.module.css new file mode 100644 index 0000000000..2aa5a6ac17 --- /dev/null +++ b/e2e/solid-start/start-manifest/src/styles/shared-card.module.css @@ -0,0 +1,8 @@ +.card { + margin-top: 1rem; + padding: 1.5rem; + border-radius: 0.75rem; + background: rgb(252, 231, 243); + border: 2px solid rgb(190, 24, 93); + color: rgb(157, 23, 77); +} diff --git a/e2e/solid-start/start-manifest/src/styles/shared-layout.module.css b/e2e/solid-start/start-manifest/src/styles/shared-layout.module.css new file mode 100644 index 0000000000..6025a1da06 --- /dev/null +++ b/e2e/solid-start/start-manifest/src/styles/shared-layout.module.css @@ -0,0 +1,16 @@ +.layout { + padding: 1rem; + border-radius: 0.75rem; + background: rgb(255, 251, 235); + border: 2px solid rgb(245, 158, 11); +} + +.heading { + color: rgb(180, 83, 9); + font-weight: 700; + margin-bottom: 0.5rem; +} + +.body { + color: rgb(146, 64, 14); +} diff --git a/e2e/solid-start/start-manifest/src/styles/shared-widget.module.css b/e2e/solid-start/start-manifest/src/styles/shared-widget.module.css new file mode 100644 index 0000000000..ed197cddb0 --- /dev/null +++ b/e2e/solid-start/start-manifest/src/styles/shared-widget.module.css @@ -0,0 +1,17 @@ +.widget { + margin-top: 1rem; + padding: 1rem; + border-top: 4px solid rgb(249, 115, 22); + border-radius: 0.75rem; + background: rgb(255, 247, 237); +} + +.title { + font-weight: 700; + color: rgb(154, 52, 18); +} + +.content { + margin-top: 0.5rem; + color: rgb(124, 45, 18); +} diff --git a/e2e/solid-start/start-manifest/tests/start-manifest.spec.ts b/e2e/solid-start/start-manifest/tests/start-manifest.spec.ts new file mode 100644 index 0000000000..0cedca59e0 --- /dev/null +++ b/e2e/solid-start/start-manifest/tests/start-manifest.spec.ts @@ -0,0 +1,453 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import type { Page } from '@playwright/test' +import { readdir } from 'node:fs/promises' +import path from 'node:path' +import { pathToFileURL } from 'node:url' + +const ROOT_SHELL_COLOR = 'rgb(22, 101, 52)' +const ROUTE_ONE_COLOR = 'rgb(30, 64, 175)' +const ROUTE_TWO_COLOR = 'rgb(126, 34, 206)' +const SHARED_CARD_BG = 'rgb(252, 231, 243)' +const SHARED_WIDGET_BG = 'rgb(255, 247, 237)' +const SHARED_WIDGET_BORDER = 'rgb(249, 115, 22)' + +const buildUrl = (baseURL: string, pathname: string) => + baseURL.replace(/\/$/, '') + pathname + +async function getColor(testId: string, page: Page) { + return page + .getByTestId(testId) + .evaluate((element) => getComputedStyle(element).color) +} + +async function getBackgroundColor(testId: string, page: Page) { + return page + .getByTestId(testId) + .evaluate((element) => getComputedStyle(element).backgroundColor) +} + +function getStylesheetHrefsFromHtml(html: string) { + return Array.from( + html.matchAll(/]+rel="stylesheet"[^>]+href="([^"]+)"/g), + (match) => match[1]!, + ) +} + +async function getHeadStylesheetHrefs(page: Page) { + return page.locator('head link[rel="stylesheet"]').evaluateAll((links) => { + return links.map( + (link) => (link as HTMLLinkElement).getAttribute('href') || '', + ) + }) +} + +function countMatchingStylesheetHrefs(hrefs: Array, pattern: string) { + return hrefs.filter((href) => href.includes(pattern)).length +} + +async function loadBuiltStartManifest() { + const serverDir = path.resolve(import.meta.dirname, '../dist/server/assets') + const entries = await readdir(serverDir) + const manifestFile = entries.find( + (entry) => + entry.startsWith('_tanstack-start-manifest_v-') && entry.endsWith('.js'), + ) + + expect(manifestFile).toBeTruthy() + + const moduleUrl = `${pathToFileURL(path.join(serverDir, manifestFile!)).href}?t=${Date.now()}` + const manifestModule = await import(moduleUrl) + + return manifestModule.tsrStartManifest() as { + routes: Record }> + } +} + +async function expectDirectEntry({ + page, + request, + baseURL, + pathname, + expectedVisibleTestId, + expectedAbsentTestId, + expectedStylesheetPattern, + unexpectedStylesheetPattern, + expectedColorTestId, + expectedColor, +}: { + page: Page + request: { + get: (url: string) => Promise<{ ok(): boolean; text(): Promise }> + } + baseURL: string + pathname: string + expectedVisibleTestId: string + expectedAbsentTestId: string + expectedStylesheetPattern: string + unexpectedStylesheetPattern: string + expectedColorTestId: string + expectedColor: string +}) { + const url = buildUrl(baseURL, pathname) + const response = await request.get(url) + const ssrHtml = await response.text() + + expect(response.ok()).toBe(true) + expect(ssrHtml).toContain('root-shell-marker') + expect(ssrHtml).toContain(expectedVisibleTestId) + expect(ssrHtml).not.toContain(expectedAbsentTestId) + + const stylesheetLinks = getStylesheetHrefsFromHtml(ssrHtml) + + expect( + countMatchingStylesheetHrefs(stylesheetLinks, expectedStylesheetPattern), + ).toBe(1) + expect( + countMatchingStylesheetHrefs(stylesheetLinks, unexpectedStylesheetPattern), + ).toBe(0) + expect(stylesheetLinks).toHaveLength(2) + + await page.goto(url) + await expect(page.getByTestId(expectedVisibleTestId)).toBeVisible() + await expect(page.getByTestId('hydration-marker')).toBeVisible() + + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return countMatchingStylesheetHrefs(hrefs, expectedStylesheetPattern) + }) + .toBe(1) + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return countMatchingStylesheetHrefs(hrefs, unexpectedStylesheetPattern) + }) + .toBe(0) + + await expect + .poll(() => getColor('root-shell-marker', page)) + .toBe(ROOT_SHELL_COLOR) + await expect + .poll(() => getColor(expectedColorTestId, page)) + .toBe(expectedColor) +} + +test('SSR and client navigation keep CSS module styles correct without hydration errors', async ({ + page, + baseURL, + request, +}) => { + const routeOneUrl = buildUrl(baseURL!, '/r1') + const response = await request.get(routeOneUrl) + const ssrHtml = await response.text() + + expect(response.ok()).toBe(true) + expect(ssrHtml).toContain('root-shell-marker') + expect(ssrHtml).toContain('route-r1-card') + expect(ssrHtml).not.toContain('route-r2-card') + + const stylesheetLinks = getStylesheetHrefsFromHtml(ssrHtml) + + expect(countMatchingStylesheetHrefs(stylesheetLinks, 'r1-')).toBe(1) + expect(countMatchingStylesheetHrefs(stylesheetLinks, 'r2-')).toBe(0) + expect(stylesheetLinks).toHaveLength(2) + + await page.goto(routeOneUrl) + + await expect(page.getByTestId('route-r1-card')).toBeVisible() + await expect(page.getByTestId('hydration-marker')).toBeVisible() + + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return countMatchingStylesheetHrefs(hrefs, 'r1-') + }) + .toBe(1) + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return countMatchingStylesheetHrefs(hrefs, 'r2-') + }) + .toBe(0) + + await expect + .poll(() => getColor('root-shell-marker', page)) + .toBe(ROOT_SHELL_COLOR) + await expect.poll(() => getColor('route-r1-card', page)).toBe(ROUTE_ONE_COLOR) + + await page.getByTestId('nav-/r2').click() + await page.waitForURL('**/r2') + await expect(page.getByTestId('route-r2-card')).toBeVisible() + + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return countMatchingStylesheetHrefs(hrefs, 'r2-') + }) + .toBe(1) + + await expect + .poll(() => getColor('root-shell-marker', page)) + .toBe(ROOT_SHELL_COLOR) + await expect.poll(() => getColor('route-r2-card', page)).toBe(ROUTE_TWO_COLOR) + + await page.getByTestId('nav-/r1').click() + await page.waitForURL('**/r1') + await expect(page.getByTestId('route-r1-card')).toBeVisible() + + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return countMatchingStylesheetHrefs(hrefs, 'r1-') + }) + .toBe(1) + + await expect + .poll(() => getColor('root-shell-marker', page)) + .toBe(ROOT_SHELL_COLOR) + await expect.poll(() => getColor('route-r1-card', page)).toBe(ROUTE_ONE_COLOR) +}) + +test('direct SSR entry on /r2 only includes its stylesheet and hydrates cleanly', async ({ + page, + baseURL, + request, +}) => { + await expectDirectEntry({ + page, + request, + baseURL: baseURL!, + pathname: '/r2', + expectedVisibleTestId: 'route-r2-card', + expectedAbsentTestId: 'route-r1-card', + expectedStylesheetPattern: 'r2-', + unexpectedStylesheetPattern: 'r1-', + expectedColorTestId: 'route-r2-card', + expectedColor: ROUTE_TWO_COLOR, + }) +}) + +test('direct SSR entries on different route-css pages stay isolated', async ({ + page, + baseURL, + request, +}) => { + await expectDirectEntry({ + page, + request, + baseURL: baseURL!, + pathname: '/r2', + expectedVisibleTestId: 'route-r2-card', + expectedAbsentTestId: 'route-r1-card', + expectedStylesheetPattern: 'r2-', + unexpectedStylesheetPattern: 'r1-', + expectedColorTestId: 'route-r2-card', + expectedColor: ROUTE_TWO_COLOR, + }) + + await expectDirectEntry({ + page, + request, + baseURL: baseURL!, + pathname: '/r1', + expectedVisibleTestId: 'route-r1-card', + expectedAbsentTestId: 'route-r2-card', + expectedStylesheetPattern: 'r1-', + unexpectedStylesheetPattern: 'r2-', + expectedColorTestId: 'route-r1-card', + expectedColor: ROUTE_ONE_COLOR, + }) +}) + +test('home route only renders the root stylesheet and no route-specific CSS', async ({ + page, + baseURL, + request, +}) => { + const homeUrl = buildUrl(baseURL!, '/') + const response = await request.get(homeUrl) + const ssrHtml = await response.text() + + expect(response.ok()).toBe(true) + expect(ssrHtml).toContain('root-shell-marker') + expect(ssrHtml).toContain('home-copy') + expect(ssrHtml).not.toContain('route-r1-card') + expect(ssrHtml).not.toContain('route-r2-card') + + const stylesheetLinks = getStylesheetHrefsFromHtml(ssrHtml) + + expect(countMatchingStylesheetHrefs(stylesheetLinks, 'r1-')).toBe(0) + expect(countMatchingStylesheetHrefs(stylesheetLinks, 'r2-')).toBe(0) + expect(stylesheetLinks).toHaveLength(1) + + await page.goto(homeUrl) + await expect(page.getByTestId('home-copy')).toBeVisible() + await expect(page.getByTestId('hydration-marker')).toBeVisible() + + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return countMatchingStylesheetHrefs(hrefs, 'r1-') + }) + .toBe(0) + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return countMatchingStylesheetHrefs(hrefs, 'r2-') + }) + .toBe(0) + + await expect + .poll(() => getColor('root-shell-marker', page)) + .toBe(ROOT_SHELL_COLOR) +}) + +test('built start manifest preserves shared layout asset identity across sibling routes', async ({ + page, + baseURL, +}) => { + await page.goto(buildUrl(baseURL!, '/shared-a')) + await expect(page.getByTestId('shared-a-card')).toBeVisible() + + const manifest = await loadBuiltStartManifest() + + const sharedAAsset = manifest.routes['/shared-a']?.css?.[0] + const sharedBAsset = manifest.routes['/shared-b']?.css?.[0] + const sharedCAsset = manifest.routes['/shared-c']?.css?.[0] + + expect(sharedAAsset).toBeTruthy() + expect(sharedAAsset).toBe(sharedBAsset) + expect(sharedBAsset).toBe(sharedCAsset) +}) + +test('shared CSS chunk persists across client-side nav', async ({ + page, + baseURL, +}) => { + await page.goto(buildUrl(baseURL!, '/a')) + + await expect(page.getByTestId('page-a')).toBeVisible() + await expect(page.getByTestId('shared-card')).toBeVisible() + await expect + .poll(() => getBackgroundColor('shared-card', page)) + .toBe(SHARED_CARD_BG) + await expect( + page.locator('head link[rel="stylesheet"][href*="SharedCard"]'), + ).toHaveCount(1) + + await page.getByTestId('nav-/b').click() + await page.waitForURL('**/b') + await expect(page.getByTestId('page-b')).toBeVisible() + + await expect( + page.locator('head link[rel="stylesheet"][href*="SharedCard"]'), + ).toHaveCount(1) + await expect + .poll(() => getBackgroundColor('shared-card', page)) + .toBe(SHARED_CARD_BG) +}) + +test('shared widget CSS stays applied when navigating from static to lazy route', async ({ + page, + baseURL, +}) => { + await page.goto(buildUrl(baseURL!, '/lazy-css-static')) + + const widget = page.getByTestId('shared-widget') + await expect(widget).toBeVisible() + expect(await getBackgroundColor('shared-widget', page)).toBe(SHARED_WIDGET_BG) + expect( + await widget.evaluate( + (element) => getComputedStyle(element).borderTopColor, + ), + ).toBe(SHARED_WIDGET_BORDER) + + await expect(page.getByTestId('hydration-marker')).toBeVisible() + + await page.getByTestId('nav-/lazy-css-lazy').click() + await page.waitForURL('**/lazy-css-lazy') + await expect(page.getByTestId('lazy-css-lazy-heading')).toBeVisible() + + await expect + .poll(() => getBackgroundColor('shared-widget', page), { + timeout: 5_000, + }) + .toBe(SHARED_WIDGET_BG) +}) + +test('shared widget CSS stays applied when navigating from lazy to static route', async ({ + page, + baseURL, +}) => { + await page.goto(buildUrl(baseURL!, '/lazy-css-lazy')) + await expect(page.getByTestId('lazy-css-lazy-heading')).toBeVisible() + + await expect + .poll(() => getBackgroundColor('shared-widget', page), { + timeout: 5_000, + }) + .toBe(SHARED_WIDGET_BG) + + await page.getByTestId('nav-/lazy-css-static').click() + await page.waitForURL('**/lazy-css-static') + + const widget = page.getByTestId('shared-widget') + await expect(widget).toBeVisible() + await expect + .poll(() => getBackgroundColor('shared-widget', page), { + timeout: 5_000, + }) + .toBe(SHARED_WIDGET_BG) + expect( + await widget.evaluate( + (element) => getComputedStyle(element).borderTopColor, + ), + ).toBe(SHARED_WIDGET_BORDER) +}) + +test('shared widget CSS is applied on direct navigation to lazy route', async ({ + page, + baseURL, +}) => { + await page.goto(buildUrl(baseURL!, '/lazy-css-lazy')) + await expect(page.getByTestId('lazy-css-lazy-heading')).toBeVisible() + + const widget = page.getByTestId('shared-widget') + await expect(widget).toBeVisible() + + await expect + .poll(() => getBackgroundColor('shared-widget', page), { + timeout: 5_000, + }) + .toBe(SHARED_WIDGET_BG) + expect( + await widget.evaluate( + (element) => getComputedStyle(element).borderTopColor, + ), + ).toBe(SHARED_WIDGET_BORDER) +}) + +test('shared widget CSS persists after navigating away from lazy and back', async ({ + page, + baseURL, +}) => { + await page.goto(buildUrl(baseURL!, '/lazy-css-static')) + await expect(page.getByTestId('hydration-marker')).toBeVisible() + + await page.getByTestId('nav-/lazy-css-lazy').click() + await page.waitForURL('**/lazy-css-lazy') + await expect(page.getByTestId('shared-widget')).toBeVisible() + + await page.getByTestId('nav-home').click() + await page.waitForURL(/\/([^/]*)(\/)?($|\?)/) + + await page.getByTestId('nav-/lazy-css-lazy').click() + await page.waitForURL('**/lazy-css-lazy') + + await expect + .poll(() => getBackgroundColor('shared-widget', page), { + timeout: 5_000, + }) + .toBe(SHARED_WIDGET_BG) +}) diff --git a/e2e/solid-start/start-manifest/tsconfig.json b/e2e/solid-start/start-manifest/tsconfig.json new file mode 100644 index 0000000000..11c43a4037 --- /dev/null +++ b/e2e/solid-start/start-manifest/tsconfig.json @@ -0,0 +1,23 @@ +{ + "include": ["**/*.ts", "**/*.tsx"], + "compilerOptions": { + "strict": true, + "esModuleInterop": true, + "jsx": "preserve", + "jsxImportSource": "@solidjs/web", + "module": "ESNext", + "moduleResolution": "Bundler", + "lib": ["DOM", "DOM.Iterable", "ES2022"], + "isolatedModules": true, + "resolveJsonModule": true, + "skipLibCheck": true, + "target": "ES2024", + "allowJs": true, + "forceConsistentCasingInFileNames": true, + "paths": { + "~/*": ["./src/*"] + }, + "noEmit": true, + "types": ["vite/client"] + } +} diff --git a/e2e/solid-start/start-manifest/vite.config.ts b/e2e/solid-start/start-manifest/vite.config.ts new file mode 100644 index 0000000000..896fa284f1 --- /dev/null +++ b/e2e/solid-start/start-manifest/vite.config.ts @@ -0,0 +1,13 @@ +import { tanstackStart } from '@tanstack/solid-start/plugin/vite' +import { defineConfig } from 'vite' +import viteSolid from 'vite-plugin-solid' + +export default defineConfig({ + server: { + port: 3000, + }, + resolve: { + tsconfigPaths: true, + }, + plugins: [tanstackStart({ srcDirectory: 'src' }), viteSolid({ ssr: true })], +}) diff --git a/e2e/solid-start/virtual-routes/package.json b/e2e/solid-start/virtual-routes/package.json index 66c11a2d85..67416bf7aa 100644 --- a/e2e/solid-start/virtual-routes/package.json +++ b/e2e/solid-start/virtual-routes/package.json @@ -19,9 +19,8 @@ "@tanstack/virtual-file-routes": "workspace:^", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", - "tailwind-merge": "^2.6.0", - "vite": "^8.0.0", - "zod": "^3.24.2" + "tailwind-merge": "^3.6.0", + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -32,6 +31,7 @@ "srvx": "^0.11.9", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite-plugin-solid": "^3.0.0-next.5" + "vite-plugin-solid": "^3.0.0-next.5", + "vite": "^8.0.14" } } diff --git a/e2e/solid-start/website/package.json b/e2e/solid-start/website/package.json index 02b71428f1..49b53021e2 100644 --- a/e2e/solid-start/website/package.json +++ b/e2e/solid-start/website/package.json @@ -18,9 +18,8 @@ "@tanstack/solid-start": "workspace:^", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", - "tailwind-merge": "^2.6.0", - "vite": "^8.0.0", - "zod": "^3.24.2" + "tailwind-merge": "^3.6.0", + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -30,6 +29,7 @@ "srvx": "^0.11.9", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite-plugin-solid": "^3.0.0-next.5" + "vite-plugin-solid": "^3.0.0-next.5", + "vite": "^8.0.14" } } diff --git a/e2e/vue-router/basepath-file-based/package.json b/e2e/vue-router/basepath-file-based/package.json index a30c7fa6ec..4e3deac1c7 100644 --- a/e2e/vue-router/basepath-file-based/package.json +++ b/e2e/vue-router/basepath-file-based/package.json @@ -27,7 +27,7 @@ "@vitejs/plugin-vue": "^6.0.5", "@vitejs/plugin-vue-jsx": "^5.1.5", "typescript": "~5.8.3", - "vite": "^8.0.0", + "vite": "^8.0.14", "vue-tsc": "^3.1.5" } } diff --git a/e2e/vue-router/basic-esbuild-file-based/package.json b/e2e/vue-router/basic-esbuild-file-based/package.json index ad6e6fad31..e5422cd436 100644 --- a/e2e/vue-router/basic-esbuild-file-based/package.json +++ b/e2e/vue-router/basic-esbuild-file-based/package.json @@ -13,11 +13,10 @@ "@tanstack/router-plugin": "workspace:^", "@tanstack/vue-router": "workspace:^", "@tanstack/vue-router-devtools": "workspace:^", - "@tanstack/zod-adapter": "workspace:^", "postcss": "^8.5.1", "redaxios": "^0.5.1", "vue": "^3.5.16", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@eslint/js": "^9.36.0", diff --git a/e2e/vue-router/basic-esbuild-file-based/src/routes/(another-group)/onlyrouteinside.tsx b/e2e/vue-router/basic-esbuild-file-based/src/routes/(another-group)/onlyrouteinside.tsx index 83036509ba..727c1b4d94 100644 --- a/e2e/vue-router/basic-esbuild-file-based/src/routes/(another-group)/onlyrouteinside.tsx +++ b/e2e/vue-router/basic-esbuild-file-based/src/routes/(another-group)/onlyrouteinside.tsx @@ -1,9 +1,8 @@ import { createFileRoute, getRouteApi, useSearch } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(another-group)/onlyrouteinside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), component: OnlyRouteInsideComponent, }) diff --git a/e2e/vue-router/basic-esbuild-file-based/src/routes/(group)/_layout.insidelayout.tsx b/e2e/vue-router/basic-esbuild-file-based/src/routes/(group)/_layout.insidelayout.tsx index 557503a0c2..4b239f3ef4 100644 --- a/e2e/vue-router/basic-esbuild-file-based/src/routes/(group)/_layout.insidelayout.tsx +++ b/e2e/vue-router/basic-esbuild-file-based/src/routes/(group)/_layout.insidelayout.tsx @@ -1,9 +1,8 @@ import { createFileRoute, getRouteApi, useSearch } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(group)/_layout/insidelayout')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), component: InsideLayoutComponent, }) diff --git a/e2e/vue-router/basic-esbuild-file-based/src/routes/(group)/inside.tsx b/e2e/vue-router/basic-esbuild-file-based/src/routes/(group)/inside.tsx index bec12d8de2..f12ca517d3 100644 --- a/e2e/vue-router/basic-esbuild-file-based/src/routes/(group)/inside.tsx +++ b/e2e/vue-router/basic-esbuild-file-based/src/routes/(group)/inside.tsx @@ -1,9 +1,8 @@ import { createFileRoute, getRouteApi, useSearch } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(group)/inside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), component: InsideComponent, }) diff --git a/e2e/vue-router/basic-esbuild-file-based/src/routes/(group)/lazyinside.tsx b/e2e/vue-router/basic-esbuild-file-based/src/routes/(group)/lazyinside.tsx index 56d8d6cae8..05b34eb201 100644 --- a/e2e/vue-router/basic-esbuild-file-based/src/routes/(group)/lazyinside.tsx +++ b/e2e/vue-router/basic-esbuild-file-based/src/routes/(group)/lazyinside.tsx @@ -1,9 +1,8 @@ import { createFileRoute, getRouteApi, useSearch } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(group)/lazyinside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), component: LazyInsideComponent, }) diff --git a/e2e/vue-router/basic-esbuild-file-based/src/routes/(group)/subfolder/inside.tsx b/e2e/vue-router/basic-esbuild-file-based/src/routes/(group)/subfolder/inside.tsx index b4487d163d..317c766186 100644 --- a/e2e/vue-router/basic-esbuild-file-based/src/routes/(group)/subfolder/inside.tsx +++ b/e2e/vue-router/basic-esbuild-file-based/src/routes/(group)/subfolder/inside.tsx @@ -1,9 +1,8 @@ import { createFileRoute, getRouteApi, useSearch } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(group)/subfolder/inside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), component: SubfolderInsideComponent, }) diff --git a/e2e/vue-router/basic-file-based-jsx/package.json b/e2e/vue-router/basic-file-based-jsx/package.json index f8664f2cc2..b029b1ab4f 100644 --- a/e2e/vue-router/basic-file-based-jsx/package.json +++ b/e2e/vue-router/basic-file-based-jsx/package.json @@ -15,11 +15,10 @@ "@tanstack/router-plugin": "workspace:^", "@tanstack/vue-router": "workspace:^", "@tanstack/vue-router-devtools": "workspace:^", - "@tanstack/zod-adapter": "workspace:^", "redaxios": "^0.5.1", "tailwindcss": "^4.2.2", "vue": "^3.5.16", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@eslint/js": "^9.36.0", @@ -31,7 +30,7 @@ "@vitejs/plugin-vue-jsx": "^5.1.5", "eslint-plugin-vue": "^9.33.0", "typescript": "~5.8.3", - "vite": "^8.0.0", + "vite": "^8.0.14", "vue-eslint-parser": "^9.4.3", "vue-tsc": "^3.1.5" } diff --git a/e2e/vue-router/basic-file-based-jsx/src/routes/(another-group)/onlyrouteinside.tsx b/e2e/vue-router/basic-file-based-jsx/src/routes/(another-group)/onlyrouteinside.tsx index 83036509ba..727c1b4d94 100644 --- a/e2e/vue-router/basic-file-based-jsx/src/routes/(another-group)/onlyrouteinside.tsx +++ b/e2e/vue-router/basic-file-based-jsx/src/routes/(another-group)/onlyrouteinside.tsx @@ -1,9 +1,8 @@ import { createFileRoute, getRouteApi, useSearch } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(another-group)/onlyrouteinside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), component: OnlyRouteInsideComponent, }) diff --git a/e2e/vue-router/basic-file-based-jsx/src/routes/(group)/_layout.insidelayout.tsx b/e2e/vue-router/basic-file-based-jsx/src/routes/(group)/_layout.insidelayout.tsx index 557503a0c2..4b239f3ef4 100644 --- a/e2e/vue-router/basic-file-based-jsx/src/routes/(group)/_layout.insidelayout.tsx +++ b/e2e/vue-router/basic-file-based-jsx/src/routes/(group)/_layout.insidelayout.tsx @@ -1,9 +1,8 @@ import { createFileRoute, getRouteApi, useSearch } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(group)/_layout/insidelayout')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), component: InsideLayoutComponent, }) diff --git a/e2e/vue-router/basic-file-based-jsx/src/routes/(group)/inside.tsx b/e2e/vue-router/basic-file-based-jsx/src/routes/(group)/inside.tsx index bec12d8de2..f12ca517d3 100644 --- a/e2e/vue-router/basic-file-based-jsx/src/routes/(group)/inside.tsx +++ b/e2e/vue-router/basic-file-based-jsx/src/routes/(group)/inside.tsx @@ -1,9 +1,8 @@ import { createFileRoute, getRouteApi, useSearch } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(group)/inside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), component: InsideComponent, }) diff --git a/e2e/vue-router/basic-file-based-jsx/src/routes/(group)/lazyinside.tsx b/e2e/vue-router/basic-file-based-jsx/src/routes/(group)/lazyinside.tsx index 56d8d6cae8..05b34eb201 100644 --- a/e2e/vue-router/basic-file-based-jsx/src/routes/(group)/lazyinside.tsx +++ b/e2e/vue-router/basic-file-based-jsx/src/routes/(group)/lazyinside.tsx @@ -1,9 +1,8 @@ import { createFileRoute, getRouteApi, useSearch } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(group)/lazyinside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), component: LazyInsideComponent, }) diff --git a/e2e/vue-router/basic-file-based-jsx/src/routes/(group)/subfolder/inside.tsx b/e2e/vue-router/basic-file-based-jsx/src/routes/(group)/subfolder/inside.tsx index b4487d163d..317c766186 100644 --- a/e2e/vue-router/basic-file-based-jsx/src/routes/(group)/subfolder/inside.tsx +++ b/e2e/vue-router/basic-file-based-jsx/src/routes/(group)/subfolder/inside.tsx @@ -1,9 +1,8 @@ import { createFileRoute, getRouteApi, useSearch } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(group)/subfolder/inside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), component: SubfolderInsideComponent, }) diff --git a/e2e/vue-router/basic-file-based-sfc/package.json b/e2e/vue-router/basic-file-based-sfc/package.json index 567b7fca4e..369a0b1fdc 100644 --- a/e2e/vue-router/basic-file-based-sfc/package.json +++ b/e2e/vue-router/basic-file-based-sfc/package.json @@ -15,11 +15,10 @@ "@tanstack/router-plugin": "workspace:^", "@tanstack/vue-router": "workspace:^", "@tanstack/vue-router-devtools": "workspace:^", - "@tanstack/zod-adapter": "workspace:^", "redaxios": "^0.5.1", "tailwindcss": "^4.2.2", "vue": "^3.5.16", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -27,7 +26,7 @@ "@vitejs/plugin-vue": "^6.0.5", "@vitejs/plugin-vue-jsx": "^5.1.5", "typescript": "~5.8.3", - "vite": "^8.0.0", + "vite": "^8.0.14", "vue-tsc": "^3.1.5" } } diff --git a/e2e/vue-router/basic-file-based-sfc/src/routes/(another-group)/onlyrouteinside.ts b/e2e/vue-router/basic-file-based-sfc/src/routes/(another-group)/onlyrouteinside.ts index 491bb03649..f427c79321 100644 --- a/e2e/vue-router/basic-file-based-sfc/src/routes/(another-group)/onlyrouteinside.ts +++ b/e2e/vue-router/basic-file-based-sfc/src/routes/(another-group)/onlyrouteinside.ts @@ -1,7 +1,6 @@ import { createFileRoute } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(another-group)/onlyrouteinside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), }) diff --git a/e2e/vue-router/basic-file-based-sfc/src/routes/(group)/_layout.insidelayout.ts b/e2e/vue-router/basic-file-based-sfc/src/routes/(group)/_layout.insidelayout.ts index 49ef8f7bb9..3b605763af 100644 --- a/e2e/vue-router/basic-file-based-sfc/src/routes/(group)/_layout.insidelayout.ts +++ b/e2e/vue-router/basic-file-based-sfc/src/routes/(group)/_layout.insidelayout.ts @@ -1,7 +1,6 @@ import { createFileRoute } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(group)/_layout/insidelayout')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), }) diff --git a/e2e/vue-router/basic-file-based-sfc/src/routes/(group)/inside.ts b/e2e/vue-router/basic-file-based-sfc/src/routes/(group)/inside.ts index f7b06f6a94..456e8fe169 100644 --- a/e2e/vue-router/basic-file-based-sfc/src/routes/(group)/inside.ts +++ b/e2e/vue-router/basic-file-based-sfc/src/routes/(group)/inside.ts @@ -1,7 +1,6 @@ import { createFileRoute } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(group)/inside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), }) diff --git a/e2e/vue-router/basic-file-based-sfc/src/routes/(group)/lazyinside.ts b/e2e/vue-router/basic-file-based-sfc/src/routes/(group)/lazyinside.ts index b66d18a729..7fba56aae4 100644 --- a/e2e/vue-router/basic-file-based-sfc/src/routes/(group)/lazyinside.ts +++ b/e2e/vue-router/basic-file-based-sfc/src/routes/(group)/lazyinside.ts @@ -1,7 +1,6 @@ import { createFileRoute } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(group)/lazyinside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), }) diff --git a/e2e/vue-router/basic-file-based-sfc/src/routes/(group)/subfolder/inside.ts b/e2e/vue-router/basic-file-based-sfc/src/routes/(group)/subfolder/inside.ts index 50aa8a44ad..21e5d7ba0a 100644 --- a/e2e/vue-router/basic-file-based-sfc/src/routes/(group)/subfolder/inside.ts +++ b/e2e/vue-router/basic-file-based-sfc/src/routes/(group)/subfolder/inside.ts @@ -1,7 +1,6 @@ import { createFileRoute } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(group)/subfolder/inside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), }) diff --git a/e2e/vue-router/basic-scroll-restoration/package.json b/e2e/vue-router/basic-scroll-restoration/package.json index e9b09ee6ab..daa2519eed 100644 --- a/e2e/vue-router/basic-scroll-restoration/package.json +++ b/e2e/vue-router/basic-scroll-restoration/package.json @@ -24,7 +24,7 @@ "@tanstack/router-e2e-utils": "workspace:^", "@vitejs/plugin-vue": "^6.0.5", "@vitejs/plugin-vue-jsx": "^5.1.5", - "vite": "^8.0.0", + "vite": "^8.0.14", "vue-tsc": "^3.1.5", "typescript": "~5.9.0" } diff --git a/e2e/vue-router/basic-virtual-file-based/package.json b/e2e/vue-router/basic-virtual-file-based/package.json index 9e37cef47e..946addb3bf 100644 --- a/e2e/vue-router/basic-virtual-file-based/package.json +++ b/e2e/vue-router/basic-virtual-file-based/package.json @@ -28,7 +28,7 @@ "@vitejs/plugin-vue": "^6.0.5", "@vitejs/plugin-vue-jsx": "^5.1.5", "typescript": "~5.8.3", - "vite": "^8.0.0", + "vite": "^8.0.14", "vue-tsc": "^3.1.5" } } diff --git a/e2e/vue-router/basic-virtual-file-based/src/routeTree.gen.ts b/e2e/vue-router/basic-virtual-file-based/src/routeTree.gen.ts index a4c92111db..3798afaa01 100644 --- a/e2e/vue-router/basic-virtual-file-based/src/routeTree.gen.ts +++ b/e2e/vue-router/basic-virtual-file-based/src/routeTree.gen.ts @@ -8,8 +8,6 @@ // You should NOT make any changes in this file as it will be overwritten. // Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. -import type { CreateFileRoute, FileRoutesByPath } from '@tanstack/vue-router' - import { Route as rootRouteImport } from './routes/root' import { Route as postsPostsRouteImport } from './routes/posts/posts' import { Route as layoutFirstLayoutRouteImport } from './routes/layout/first-layout' @@ -255,115 +253,6 @@ declare module '@tanstack/vue-router' { } } -declare module './routes/home' { - const createFileRoute: CreateFileRoute< - '/', - FileRoutesByPath['/']['parentRoute'], - FileRoutesByPath['/']['id'], - FileRoutesByPath['/']['path'], - FileRoutesByPath['/']['fullPath'] - > -} -declare module './routes/layout/first-layout' { - const createFileRoute: CreateFileRoute< - '/_first', - FileRoutesByPath['/_first']['parentRoute'], - FileRoutesByPath['/_first']['id'], - FileRoutesByPath['/_first']['path'], - FileRoutesByPath['/_first']['fullPath'] - > -} -declare module './routes/posts/posts' { - const createFileRoute: CreateFileRoute< - '/posts', - FileRoutesByPath['/posts']['parentRoute'], - FileRoutesByPath['/posts']['id'], - FileRoutesByPath['/posts']['path'], - FileRoutesByPath['/posts']['fullPath'] - > -} -declare module './routes/file-based-subtree/hello/route' { - const createFileRoute: CreateFileRoute< - '/classic/hello', - FileRoutesByPath['/classic/hello']['parentRoute'], - FileRoutesByPath['/classic/hello']['id'], - FileRoutesByPath['/classic/hello']['path'], - FileRoutesByPath['/classic/hello']['fullPath'] - > -} -declare module './routes/posts/posts-home' { - const createFileRoute: CreateFileRoute< - '/posts/', - FileRoutesByPath['/posts/']['parentRoute'], - FileRoutesByPath['/posts/']['id'], - FileRoutesByPath['/posts/']['path'], - FileRoutesByPath['/posts/']['fullPath'] - > -} -declare module './routes/layout/second-layout' { - const createFileRoute: CreateFileRoute< - '/_first/_second', - FileRoutesByPath['/_first/_second']['parentRoute'], - FileRoutesByPath['/_first/_second']['id'], - FileRoutesByPath['/_first/_second']['path'], - FileRoutesByPath['/_first/_second']['fullPath'] - > -} -declare module './routes/posts/posts-detail' { - const createFileRoute: CreateFileRoute< - '/posts/$postId', - FileRoutesByPath['/posts/$postId']['parentRoute'], - FileRoutesByPath['/posts/$postId']['id'], - FileRoutesByPath['/posts/$postId']['path'], - FileRoutesByPath['/posts/$postId']['fullPath'] - > -} -declare module './routes/a' { - const createFileRoute: CreateFileRoute< - '/_first/_second/layout-a', - FileRoutesByPath['/_first/_second/layout-a']['parentRoute'], - FileRoutesByPath['/_first/_second/layout-a']['id'], - FileRoutesByPath['/_first/_second/layout-a']['path'], - FileRoutesByPath['/_first/_second/layout-a']['fullPath'] - > -} -declare module './routes/b' { - const createFileRoute: CreateFileRoute< - '/_first/_second/layout-b', - FileRoutesByPath['/_first/_second/layout-b']['parentRoute'], - FileRoutesByPath['/_first/_second/layout-b']['id'], - FileRoutesByPath['/_first/_second/layout-b']['path'], - FileRoutesByPath['/_first/_second/layout-b']['fullPath'] - > -} -declare module './routes/file-based-subtree/hello/universe' { - const createFileRoute: CreateFileRoute< - '/classic/hello/universe', - FileRoutesByPath['/classic/hello/universe']['parentRoute'], - FileRoutesByPath['/classic/hello/universe']['id'], - FileRoutesByPath['/classic/hello/universe']['path'], - FileRoutesByPath['/classic/hello/universe']['fullPath'] - > -} -declare module './routes/file-based-subtree/hello/world' { - const createFileRoute: CreateFileRoute< - '/classic/hello/world', - FileRoutesByPath['/classic/hello/world']['parentRoute'], - FileRoutesByPath['/classic/hello/world']['id'], - FileRoutesByPath['/classic/hello/world']['path'], - FileRoutesByPath['/classic/hello/world']['fullPath'] - > -} -declare module './routes/file-based-subtree/hello/index' { - const createFileRoute: CreateFileRoute< - '/classic/hello/', - FileRoutesByPath['/classic/hello/']['parentRoute'], - FileRoutesByPath['/classic/hello/']['id'], - FileRoutesByPath['/classic/hello/']['path'], - FileRoutesByPath['/classic/hello/']['fullPath'] - > -} - interface layoutSecondLayoutRouteChildren { aRoute: typeof aRoute bRoute: typeof bRoute diff --git a/e2e/vue-router/basic-virtual-file-based/src/routes/a.tsx b/e2e/vue-router/basic-virtual-file-based/src/routes/a.tsx index a190b24202..133d40f19e 100644 --- a/e2e/vue-router/basic-virtual-file-based/src/routes/a.tsx +++ b/e2e/vue-router/basic-virtual-file-based/src/routes/a.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/vue-router' +export const Route = createFileRoute('/_first/_second/layout-a')({ component: LayoutAComponent, }) diff --git a/e2e/vue-router/basic-virtual-file-based/src/routes/b.tsx b/e2e/vue-router/basic-virtual-file-based/src/routes/b.tsx index 505f8f6fbf..caae6c1ded 100644 --- a/e2e/vue-router/basic-virtual-file-based/src/routes/b.tsx +++ b/e2e/vue-router/basic-virtual-file-based/src/routes/b.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/vue-router' +export const Route = createFileRoute('/_first/_second/layout-b')({ component: LayoutBComponent, }) diff --git a/e2e/vue-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/index.tsx b/e2e/vue-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/index.tsx index f86335e291..9b0d21d191 100644 --- a/e2e/vue-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/index.tsx +++ b/e2e/vue-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/index.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/vue-router' +export const Route = createFileRoute('/classic/hello/')({ component: () =>
    This is the index
    , }) diff --git a/e2e/vue-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/route.tsx b/e2e/vue-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/route.tsx index f07d58fd3e..24c72f2fb9 100644 --- a/e2e/vue-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/route.tsx +++ b/e2e/vue-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/route.tsx @@ -1,6 +1,6 @@ -import { Link, Outlet } from '@tanstack/vue-router' +import { Link, Outlet, createFileRoute } from '@tanstack/vue-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/classic/hello')({ component: () => (
    Hello! diff --git a/e2e/vue-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/universe.tsx b/e2e/vue-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/universe.tsx index 20b07c41cc..650dd2ee62 100644 --- a/e2e/vue-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/universe.tsx +++ b/e2e/vue-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/universe.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/vue-router' +export const Route = createFileRoute('/classic/hello/universe')({ component: () =>
    Hello /classic/hello/universe!
    , }) diff --git a/e2e/vue-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/world.tsx b/e2e/vue-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/world.tsx index 4af11357a2..c752e6b5a4 100644 --- a/e2e/vue-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/world.tsx +++ b/e2e/vue-router/basic-virtual-file-based/src/routes/file-based-subtree/hello/world.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/vue-router' +export const Route = createFileRoute('/classic/hello/world')({ component: () =>
    Hello /classic/hello/world!
    , }) diff --git a/e2e/vue-router/basic-virtual-file-based/src/routes/home.tsx b/e2e/vue-router/basic-virtual-file-based/src/routes/home.tsx index 510db79b73..acf99ce567 100644 --- a/e2e/vue-router/basic-virtual-file-based/src/routes/home.tsx +++ b/e2e/vue-router/basic-virtual-file-based/src/routes/home.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/vue-router' +export const Route = createFileRoute('/')({ component: Home, }) diff --git a/e2e/vue-router/basic-virtual-file-based/src/routes/layout/first-layout.tsx b/e2e/vue-router/basic-virtual-file-based/src/routes/layout/first-layout.tsx index 9e66c18e33..7b82bcd7c5 100644 --- a/e2e/vue-router/basic-virtual-file-based/src/routes/layout/first-layout.tsx +++ b/e2e/vue-router/basic-virtual-file-based/src/routes/layout/first-layout.tsx @@ -1,6 +1,6 @@ -import { Outlet } from '@tanstack/vue-router' +import { Outlet, createFileRoute } from '@tanstack/vue-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/_first')({ component: LayoutComponent, }) diff --git a/e2e/vue-router/basic-virtual-file-based/src/routes/layout/second-layout.tsx b/e2e/vue-router/basic-virtual-file-based/src/routes/layout/second-layout.tsx index acb6d2c8ae..cc1dafa5a1 100644 --- a/e2e/vue-router/basic-virtual-file-based/src/routes/layout/second-layout.tsx +++ b/e2e/vue-router/basic-virtual-file-based/src/routes/layout/second-layout.tsx @@ -1,6 +1,6 @@ -import { Link, Outlet } from '@tanstack/vue-router' +import { Link, Outlet, createFileRoute } from '@tanstack/vue-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/_first/_second')({ component: LayoutComponent, }) diff --git a/e2e/vue-router/basic-virtual-file-based/src/routes/posts/posts-detail.tsx b/e2e/vue-router/basic-virtual-file-based/src/routes/posts/posts-detail.tsx index 9b416bcf82..b4c91d3e85 100644 --- a/e2e/vue-router/basic-virtual-file-based/src/routes/posts/posts-detail.tsx +++ b/e2e/vue-router/basic-virtual-file-based/src/routes/posts/posts-detail.tsx @@ -1,4 +1,4 @@ -import { ErrorComponent } from '@tanstack/vue-router' +import { ErrorComponent, createFileRoute } from '@tanstack/vue-router' import { fetchPost } from '../../posts' import type { ErrorComponentProps } from '@tanstack/vue-router' @@ -6,7 +6,7 @@ export function PostErrorComponent({ error }: ErrorComponentProps) { return } -export const Route = createFileRoute({ +export const Route = createFileRoute('/posts/$postId')({ loader: async ({ params: { postId } }) => fetchPost(postId), errorComponent: PostErrorComponent as any, notFoundComponent: () => { diff --git a/e2e/vue-router/basic-virtual-file-based/src/routes/posts/posts-home.tsx b/e2e/vue-router/basic-virtual-file-based/src/routes/posts/posts-home.tsx index 13529228bb..67a4268fae 100644 --- a/e2e/vue-router/basic-virtual-file-based/src/routes/posts/posts-home.tsx +++ b/e2e/vue-router/basic-virtual-file-based/src/routes/posts/posts-home.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/vue-router' +export const Route = createFileRoute('/posts/')({ component: PostsIndexComponent, }) diff --git a/e2e/vue-router/basic-virtual-file-based/src/routes/posts/posts.tsx b/e2e/vue-router/basic-virtual-file-based/src/routes/posts/posts.tsx index 5942bac97e..265faaf650 100644 --- a/e2e/vue-router/basic-virtual-file-based/src/routes/posts/posts.tsx +++ b/e2e/vue-router/basic-virtual-file-based/src/routes/posts/posts.tsx @@ -1,7 +1,7 @@ -import { Link, Outlet } from '@tanstack/vue-router' +import { Link, Outlet, createFileRoute } from '@tanstack/vue-router' import { fetchPosts } from '../../posts' -export const Route = createFileRoute({ +export const Route = createFileRoute('/posts')({ loader: fetchPosts, component: PostsComponent, }) diff --git a/e2e/vue-router/basic-virtual-file-based/vite.config.ts b/e2e/vue-router/basic-virtual-file-based/vite.config.ts index 50924307e6..d9f5956b33 100644 --- a/e2e/vue-router/basic-virtual-file-based/vite.config.ts +++ b/e2e/vue-router/basic-virtual-file-based/vite.config.ts @@ -12,7 +12,6 @@ export default defineConfig({ tanstackRouter({ target: 'vue', autoCodeSplitting: true, - verboseFileRoutes: false, virtualRouteConfig: routes, }), vue(), diff --git a/e2e/vue-router/basic-virtual-named-export-config-file-based/package.json b/e2e/vue-router/basic-virtual-named-export-config-file-based/package.json index a743551ee0..f73d3ad8b2 100644 --- a/e2e/vue-router/basic-virtual-named-export-config-file-based/package.json +++ b/e2e/vue-router/basic-virtual-named-export-config-file-based/package.json @@ -28,7 +28,7 @@ "@vitejs/plugin-vue": "^6.0.5", "@vitejs/plugin-vue-jsx": "^5.1.5", "typescript": "~5.8.3", - "vite": "^8.0.0", + "vite": "^8.0.14", "vue-tsc": "^3.1.5" } } diff --git a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/a.tsx b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/a.tsx index a190b24202..133d40f19e 100644 --- a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/a.tsx +++ b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/a.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/vue-router' +export const Route = createFileRoute('/_first/_second/layout-a')({ component: LayoutAComponent, }) diff --git a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/b.tsx b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/b.tsx index 505f8f6fbf..caae6c1ded 100644 --- a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/b.tsx +++ b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/b.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/vue-router' +export const Route = createFileRoute('/_first/_second/layout-b')({ component: LayoutBComponent, }) diff --git a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/index.tsx b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/index.tsx index f86335e291..9b0d21d191 100644 --- a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/index.tsx +++ b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/index.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/vue-router' +export const Route = createFileRoute('/classic/hello/')({ component: () =>
    This is the index
    , }) diff --git a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/route.tsx b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/route.tsx index f07d58fd3e..24c72f2fb9 100644 --- a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/route.tsx +++ b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/route.tsx @@ -1,6 +1,6 @@ -import { Link, Outlet } from '@tanstack/vue-router' +import { Link, Outlet, createFileRoute } from '@tanstack/vue-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/classic/hello')({ component: () => (
    Hello! diff --git a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/universe.tsx b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/universe.tsx index 20b07c41cc..650dd2ee62 100644 --- a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/universe.tsx +++ b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/universe.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/vue-router' +export const Route = createFileRoute('/classic/hello/universe')({ component: () =>
    Hello /classic/hello/universe!
    , }) diff --git a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/world.tsx b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/world.tsx index 4af11357a2..c752e6b5a4 100644 --- a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/world.tsx +++ b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/file-based-subtree/hello/world.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/vue-router' +export const Route = createFileRoute('/classic/hello/world')({ component: () =>
    Hello /classic/hello/world!
    , }) diff --git a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/home.tsx b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/home.tsx index 510db79b73..acf99ce567 100644 --- a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/home.tsx +++ b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/home.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/vue-router' +export const Route = createFileRoute('/')({ component: Home, }) diff --git a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/layout/first-layout.tsx b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/layout/first-layout.tsx index 9e66c18e33..7b82bcd7c5 100644 --- a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/layout/first-layout.tsx +++ b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/layout/first-layout.tsx @@ -1,6 +1,6 @@ -import { Outlet } from '@tanstack/vue-router' +import { Outlet, createFileRoute } from '@tanstack/vue-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/_first')({ component: LayoutComponent, }) diff --git a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/layout/second-layout.tsx b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/layout/second-layout.tsx index acb6d2c8ae..cc1dafa5a1 100644 --- a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/layout/second-layout.tsx +++ b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/layout/second-layout.tsx @@ -1,6 +1,6 @@ -import { Link, Outlet } from '@tanstack/vue-router' +import { Link, Outlet, createFileRoute } from '@tanstack/vue-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/_first/_second')({ component: LayoutComponent, }) diff --git a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts-detail.tsx b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts-detail.tsx index 9b416bcf82..b4c91d3e85 100644 --- a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts-detail.tsx +++ b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts-detail.tsx @@ -1,4 +1,4 @@ -import { ErrorComponent } from '@tanstack/vue-router' +import { ErrorComponent, createFileRoute } from '@tanstack/vue-router' import { fetchPost } from '../../posts' import type { ErrorComponentProps } from '@tanstack/vue-router' @@ -6,7 +6,7 @@ export function PostErrorComponent({ error }: ErrorComponentProps) { return } -export const Route = createFileRoute({ +export const Route = createFileRoute('/posts/$postId')({ loader: async ({ params: { postId } }) => fetchPost(postId), errorComponent: PostErrorComponent as any, notFoundComponent: () => { diff --git a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts-home.tsx b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts-home.tsx index 13529228bb..67a4268fae 100644 --- a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts-home.tsx +++ b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts-home.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/vue-router' +export const Route = createFileRoute('/posts/')({ component: PostsIndexComponent, }) diff --git a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts.tsx b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts.tsx index 5942bac97e..265faaf650 100644 --- a/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts.tsx +++ b/e2e/vue-router/basic-virtual-named-export-config-file-based/src/routes/posts/posts.tsx @@ -1,7 +1,7 @@ -import { Link, Outlet } from '@tanstack/vue-router' +import { Link, Outlet, createFileRoute } from '@tanstack/vue-router' import { fetchPosts } from '../../posts' -export const Route = createFileRoute({ +export const Route = createFileRoute('/posts')({ loader: fetchPosts, component: PostsComponent, }) diff --git a/e2e/vue-router/basic-virtual-named-export-config-file-based/vite.config.ts b/e2e/vue-router/basic-virtual-named-export-config-file-based/vite.config.ts index a5ba51ea2f..f02a0c0d95 100644 --- a/e2e/vue-router/basic-virtual-named-export-config-file-based/vite.config.ts +++ b/e2e/vue-router/basic-virtual-named-export-config-file-based/vite.config.ts @@ -11,7 +11,6 @@ export default defineConfig({ tanstackRouter({ target: 'vue', autoCodeSplitting: true, - verboseFileRoutes: false, virtualRouteConfig: './routes.ts', }), vue(), diff --git a/e2e/vue-router/basic-vue-query-file-based/package.json b/e2e/vue-router/basic-vue-query-file-based/package.json index c98530f42a..75395b20f8 100644 --- a/e2e/vue-router/basic-vue-query-file-based/package.json +++ b/e2e/vue-router/basic-vue-query-file-based/package.json @@ -12,15 +12,15 @@ }, "dependencies": { "@tailwindcss/vite": "^4.2.2", + "@tanstack/router-plugin": "workspace:^", "@tanstack/vue-query": "^5.90.0", "@tanstack/vue-query-devtools": "^6.1.2", "@tanstack/vue-router": "workspace:^", "@tanstack/vue-router-devtools": "workspace:^", - "@tanstack/router-plugin": "workspace:^", "redaxios": "^0.5.1", "tailwindcss": "^4.2.2", "vue": "^3.5.16", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -28,7 +28,7 @@ "@vitejs/plugin-vue": "^6.0.5", "@vitejs/plugin-vue-jsx": "^5.1.5", "typescript": "~5.8.3", - "vite": "^8.0.0", + "vite": "^8.0.14", "vue-tsc": "^3.1.5" } } diff --git a/e2e/vue-router/basic-vue-query/package.json b/e2e/vue-router/basic-vue-query/package.json index b9e12f2355..be46a064c6 100644 --- a/e2e/vue-router/basic-vue-query/package.json +++ b/e2e/vue-router/basic-vue-query/package.json @@ -26,7 +26,7 @@ "@vitejs/plugin-vue": "^6.0.5", "@vitejs/plugin-vue-jsx": "^5.1.5", "typescript": "~5.8.3", - "vite": "^8.0.0", + "vite": "^8.0.14", "vue-tsc": "^3.1.5" } } diff --git a/e2e/vue-router/basic/package.json b/e2e/vue-router/basic/package.json index f09ba20e9e..c779a572e9 100644 --- a/e2e/vue-router/basic/package.json +++ b/e2e/vue-router/basic/package.json @@ -23,7 +23,7 @@ "@tanstack/router-e2e-utils": "workspace:^", "@vitejs/plugin-vue-jsx": "^5.1.5", "typescript": "~5.8.3", - "vite": "^8.0.0", + "vite": "^8.0.14", "vue-tsc": "^3.1.5" } } diff --git a/e2e/vue-router/generator-cli-only/package.json b/e2e/vue-router/generator-cli-only/package.json index 3219f78a2c..14cdafcd48 100644 --- a/e2e/vue-router/generator-cli-only/package.json +++ b/e2e/vue-router/generator-cli-only/package.json @@ -25,7 +25,7 @@ "@vitejs/plugin-vue": "^6.0.5", "@vitejs/plugin-vue-jsx": "^5.1.5", "typescript": "~5.8.3", - "vite": "^8.0.0", + "vite": "^8.0.14", "vue-tsc": "^3.1.5" } } diff --git a/e2e/vue-router/js-only-file-based/package.json b/e2e/vue-router/js-only-file-based/package.json index 1e3bac6cd5..05a86b7cf1 100644 --- a/e2e/vue-router/js-only-file-based/package.json +++ b/e2e/vue-router/js-only-file-based/package.json @@ -26,6 +26,6 @@ "@tanstack/router-e2e-utils": "workspace:^", "@vitejs/plugin-vue": "^6.0.5", "@vitejs/plugin-vue-jsx": "^5.1.5", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/e2e/vue-router/rspack-basic-file-based/package.json b/e2e/vue-router/rspack-basic-file-based/package.json index 46b6780325..78b7e74a41 100644 --- a/e2e/vue-router/rspack-basic-file-based/package.json +++ b/e2e/vue-router/rspack-basic-file-based/package.json @@ -17,10 +17,10 @@ }, "devDependencies": { "@playwright/test": "^1.50.1", - "@rsbuild/core": "^1.2.4", - "@rsbuild/plugin-babel": "^1.0.6", - "@rsbuild/plugin-vue": "^1.2.2", - "@rsbuild/plugin-vue-jsx": "^1.1.1", + "@rsbuild/core": "^2.0.8", + "@rsbuild/plugin-babel": "^1.1.2", + "@rsbuild/plugin-vue": "^1.2.7", + "@rsbuild/plugin-vue-jsx": "^2.0.0", "@tailwindcss/postcss": "^4.2.2", "@tanstack/router-e2e-utils": "workspace:^", "@tanstack/router-plugin": "workspace:^", diff --git a/e2e/vue-router/rspack-basic-virtual-named-export-config-file-based/package.json b/e2e/vue-router/rspack-basic-virtual-named-export-config-file-based/package.json index 8863fc3de2..6a5cfead84 100644 --- a/e2e/vue-router/rspack-basic-virtual-named-export-config-file-based/package.json +++ b/e2e/vue-router/rspack-basic-virtual-named-export-config-file-based/package.json @@ -17,10 +17,10 @@ }, "devDependencies": { "@playwright/test": "^1.50.1", - "@rsbuild/core": "^1.2.4", - "@rsbuild/plugin-babel": "^1.0.6", - "@rsbuild/plugin-vue": "^1.2.2", - "@rsbuild/plugin-vue-jsx": "^1.1.1", + "@rsbuild/core": "^2.0.8", + "@rsbuild/plugin-babel": "^1.1.2", + "@rsbuild/plugin-vue": "^1.2.7", + "@rsbuild/plugin-vue-jsx": "^2.0.0", "@tailwindcss/postcss": "^4.2.2", "@tanstack/router-e2e-utils": "workspace:^", "@tanstack/router-plugin": "workspace:^", diff --git a/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/index-BwsVWHwV.js b/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/index-BwsVWHwV.js deleted file mode 100644 index 1f78534259..0000000000 --- a/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/index-BwsVWHwV.js +++ /dev/null @@ -1,18 +0,0 @@ -const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/page-with-search-BhJv4yJI.js","assets/scroll-block-BAas_Ct-.js","assets/normal-page-BPOVyYTF.js","assets/virtual-page.lazy-BCqvdivF.js","assets/lazy-with-loader-page.lazy-BzLmn584.js","assets/lazy-page.lazy-BzoMuhUY.js"])))=>i.map(i=>d[i]); -(function(){const t=document.createElement("link").relList;if(t&&t.supports&&t.supports("modulepreload"))return;for(const r of document.querySelectorAll('link[rel="modulepreload"]'))n(r);new MutationObserver(r=>{for(const i of r)if(i.type==="childList")for(const o of i.addedNodes)o.tagName==="LINK"&&o.rel==="modulepreload"&&n(o)}).observe(document,{childList:!0,subtree:!0});function s(r){const i={};return r.integrity&&(i.integrity=r.integrity),r.referrerPolicy&&(i.referrerPolicy=r.referrerPolicy),r.crossOrigin==="use-credentials"?i.credentials="include":r.crossOrigin==="anonymous"?i.credentials="omit":i.credentials="same-origin",i}function n(r){if(r.ep)return;r.ep=!0;const i=s(r);fetch(r.href,i)}})();/** -* @vue/shared v3.5.25 -* (c) 2018-present Yuxi (Evan) You and Vue contributors -* @license MIT -**/function Or(e){const t=Object.create(null);for(const s of e.split(","))t[s]=1;return s=>s in t}const me={},_s=[],Xe=()=>{},Eo=()=>!1,In=e=>e.charCodeAt(0)===111&&e.charCodeAt(1)===110&&(e.charCodeAt(2)>122||e.charCodeAt(2)<97),Ar=e=>e.startsWith("onUpdate:"),be=Object.assign,Nr=(e,t)=>{const s=e.indexOf(t);s>-1&&e.splice(s,1)},tc=Object.prototype.hasOwnProperty,le=(e,t)=>tc.call(e,t),X=Array.isArray,bs=e=>Ln(e)==="[object Map]",sc=e=>Ln(e)==="[object Set]",Y=e=>typeof e=="function",xe=e=>typeof e=="string",as=e=>typeof e=="symbol",ge=e=>e!==null&&typeof e=="object",Oo=e=>(ge(e)||Y(e))&&Y(e.then)&&Y(e.catch),nc=Object.prototype.toString,Ln=e=>nc.call(e),rc=e=>Ln(e).slice(8,-1),ic=e=>Ln(e)==="[object Object]",Fr=e=>xe(e)&&e!=="NaN"&&e[0]!=="-"&&""+parseInt(e,10)===e,xs=Or(",key,ref,ref_for,ref_key,onVnodeBeforeMount,onVnodeMounted,onVnodeBeforeUpdate,onVnodeUpdated,onVnodeBeforeUnmount,onVnodeUnmounted"),Mn=e=>{const t=Object.create(null);return(s=>t[s]||(t[s]=e(s)))},oc=/-\w/g,Pt=Mn(e=>e.replace(oc,t=>t.slice(1).toUpperCase())),ac=/\B([A-Z])/g,Zt=Mn(e=>e.replace(ac,"-$1").toLowerCase()),Ao=Mn(e=>e.charAt(0).toUpperCase()+e.slice(1)),Un=Mn(e=>e?`on${Ao(e)}`:""),xt=(e,t)=>!Object.is(e,t),Hn=(e,...t)=>{for(let s=0;s{Object.defineProperty(e,t,{configurable:!0,enumerable:!1,writable:n,value:s})},cc=e=>{const t=parseFloat(e);return isNaN(t)?e:t},lc=e=>{const t=xe(e)?Number(e):NaN;return isNaN(t)?e:t};let Ri;const En=()=>Ri||(Ri=typeof globalThis<"u"?globalThis:typeof self<"u"?self:typeof window<"u"?window:typeof global<"u"?global:{});function $r(e){if(X(e)){const t={};for(let s=0;s{if(s){const n=s.split(fc);n.length>1&&(t[n[0].trim()]=n[1].trim())}}),t}function Br(e){let t="";if(xe(e))t=e;else if(X(e))for(let s=0;s0&&--this._on===0&&(Ee=this.prevScope,this.prevScope=void 0)}stop(t){if(this._active){this._active=!1;let s,n;for(s=0,n=this.effects.length;s0)return;if(Ss){let t=Ss;for(Ss=void 0;t;){const s=t.next;t.next=void 0,t.flags&=-9,t=s}}let e;for(;ws;){let t=ws;for(ws=void 0;t;){const s=t.next;if(t.next=void 0,t.flags&=-9,t.flags&1)try{t.trigger()}catch(n){e||(e=n)}t=s}}if(e)throw e}function jo(e){for(let t=e.deps;t;t=t.nextDep)t.version=-1,t.prevActiveLink=t.dep.activeLink,t.dep.activeLink=t}function Do(e){let t,s=e.depsTail,n=s;for(;n;){const r=n.prevDep;n.version===-1?(n===s&&(s=r),Vr(n),yc(n)):t=n,n.dep.activeLink=n.prevActiveLink,n.prevActiveLink=void 0,n=r}e.deps=t,e.depsTail=s}function lr(e){for(let t=e.deps;t;t=t.nextDep)if(t.dep.version!==t.version||t.dep.computed&&(Vo(t.dep.computed)||t.dep.version!==t.version))return!0;return!!e._dirty}function Vo(e){if(e.flags&4&&!(e.flags&16)||(e.flags&=-17,e.globalVersion===Ms)||(e.globalVersion=Ms,!e.isSSR&&e.flags&128&&(!e.deps&&!e._dirty||!lr(e))))return;e.flags|=2;const t=e.dep,s=pe,n=He;pe=e,He=!0;try{jo(e);const r=e.fn(e._value);(t.version===0||xt(r,e._value))&&(e.flags|=128,e._value=r,t.version++)}catch(r){throw t.version++,r}finally{pe=s,He=n,Do(e),e.flags&=-3}}function Vr(e,t=!1){const{dep:s,prevSub:n,nextSub:r}=e;if(n&&(n.nextSub=r,e.prevSub=void 0),r&&(r.prevSub=n,e.nextSub=void 0),s.subs===e&&(s.subs=n,!n&&s.computed)){s.computed.flags&=-5;for(let i=s.computed.deps;i;i=i.nextDep)Vr(i,!0)}!t&&!--s.sc&&s.map&&s.map.delete(s.key)}function yc(e){const{prevDep:t,nextDep:s}=e;t&&(t.nextDep=s,e.prevDep=void 0),s&&(s.prevDep=t,e.nextDep=void 0)}function _c(e,t){e.effect instanceof an&&(e=e.effect.fn);const s=new an(e);t&&be(s,t);try{s.run()}catch(r){throw s.stop(),r}const n=s.run.bind(s);return n.effect=s,n}let He=!0;const Uo=[];function ct(){Uo.push(He),He=!1}function lt(){const e=Uo.pop();He=e===void 0?!0:e}function Ci(e){const{cleanup:t}=e;if(e.cleanup=void 0,t){const s=pe;pe=void 0;try{t()}finally{pe=s}}}let Ms=0,bc=class{constructor(t,s){this.sub=t,this.dep=s,this.version=s.version,this.nextDep=this.prevDep=this.nextSub=this.prevSub=this.prevActiveLink=void 0}};class Ur{constructor(t){this.computed=t,this.version=0,this.activeLink=void 0,this.subs=void 0,this.map=void 0,this.key=void 0,this.sc=0,this.__v_skip=!0}track(t){if(!pe||!He||pe===this.computed)return;let s=this.activeLink;if(s===void 0||s.sub!==pe)s=this.activeLink=new bc(pe,this),pe.deps?(s.prevDep=pe.depsTail,pe.depsTail.nextDep=s,pe.depsTail=s):pe.deps=pe.depsTail=s,Ho(s);else if(s.version===-1&&(s.version=this.version,s.nextDep)){const n=s.nextDep;n.prevDep=s.prevDep,s.prevDep&&(s.prevDep.nextDep=n),s.prevDep=pe.depsTail,s.nextDep=void 0,pe.depsTail.nextDep=s,pe.depsTail=s,pe.deps===s&&(pe.deps=n)}return s}trigger(t){this.version++,Ms++,this.notify(t)}notify(t){jr();try{for(let s=this.subs;s;s=s.prevSub)s.sub.notify()&&s.sub.dep.notify()}finally{Dr()}}}function Ho(e){if(e.dep.sc++,e.sub.flags&4){const t=e.dep.computed;if(t&&!e.dep.subs){t.flags|=20;for(let n=t.deps;n;n=n.nextDep)Ho(n)}const s=e.dep.subs;s!==e&&(e.prevSub=s,s&&(s.nextSub=e)),e.dep.subs=e}}const ur=new WeakMap,Ft=Symbol(""),fr=Symbol(""),Es=Symbol("");function Se(e,t,s){if(He&&pe){let n=ur.get(e);n||ur.set(e,n=new Map);let r=n.get(s);r||(n.set(s,r=new Ur),r.map=n,r.key=s),r.track()}}function ot(e,t,s,n,r,i){const o=ur.get(e);if(!o){Ms++;return}const a=c=>{c&&c.trigger()};if(jr(),t==="clear")o.forEach(a);else{const c=X(e),u=c&&Fr(s);if(c&&s==="length"){const f=Number(n);o.forEach((l,d)=>{(d==="length"||d===Es||!as(d)&&d>=f)&&a(l)})}else switch((s!==void 0||o.has(void 0))&&a(o.get(s)),u&&a(o.get(Es)),t){case"add":c?u&&a(o.get("length")):(a(o.get(Ft)),bs(e)&&a(o.get(fr)));break;case"delete":c||(a(o.get(Ft)),bs(e)&&a(o.get(fr)));break;case"set":bs(e)&&a(o.get(Ft));break}}Dr()}function zt(e){const t=ae(e);return t===e?t:(Se(t,"iterate",Es),Ze(e)?t:t.map(ut))}function Hr(e){return Se(e=ae(e),"iterate",Es),e}function ht(e,t){return kt(e)?Jt(e)?Os(ut(t)):Os(t):ut(t)}const xc={__proto__:null,[Symbol.iterator](){return Wn(this,Symbol.iterator,e=>ht(this,e))},concat(...e){return zt(this).concat(...e.map(t=>X(t)?zt(t):t))},entries(){return Wn(this,"entries",e=>(e[1]=ht(this,e[1]),e))},every(e,t){return rt(this,"every",e,t,void 0,arguments)},filter(e,t){return rt(this,"filter",e,t,s=>s.map(n=>ht(this,n)),arguments)},find(e,t){return rt(this,"find",e,t,s=>ht(this,s),arguments)},findIndex(e,t){return rt(this,"findIndex",e,t,void 0,arguments)},findLast(e,t){return rt(this,"findLast",e,t,s=>ht(this,s),arguments)},findLastIndex(e,t){return rt(this,"findLastIndex",e,t,void 0,arguments)},forEach(e,t){return rt(this,"forEach",e,t,void 0,arguments)},includes(...e){return zn(this,"includes",e)},indexOf(...e){return zn(this,"indexOf",e)},join(e){return zt(this).join(e)},lastIndexOf(...e){return zn(this,"lastIndexOf",e)},map(e,t){return rt(this,"map",e,t,void 0,arguments)},pop(){return hs(this,"pop")},push(...e){return hs(this,"push",e)},reduce(e,...t){return Pi(this,"reduce",e,t)},reduceRight(e,...t){return Pi(this,"reduceRight",e,t)},shift(){return hs(this,"shift")},some(e,t){return rt(this,"some",e,t,void 0,arguments)},splice(...e){return hs(this,"splice",e)},toReversed(){return zt(this).toReversed()},toSorted(e){return zt(this).toSorted(e)},toSpliced(...e){return zt(this).toSpliced(...e)},unshift(...e){return hs(this,"unshift",e)},values(){return Wn(this,"values",e=>ht(this,e))}};function Wn(e,t,s){const n=Hr(e),r=n[t]();return n!==e&&!Ze(e)&&(r._next=r.next,r.next=()=>{const i=r._next();return i.done||(i.value=s(i.value)),i}),r}const wc=Array.prototype;function rt(e,t,s,n,r,i){const o=Hr(e),a=o!==e&&!Ze(e),c=o[t];if(c!==wc[t]){const l=c.apply(e,i);return a?ut(l):l}let u=s;o!==e&&(a?u=function(l,d){return s.call(this,ht(e,l),d,e)}:s.length>2&&(u=function(l,d){return s.call(this,l,d,e)}));const f=c.call(o,u,n);return a&&r?r(f):f}function Pi(e,t,s,n){const r=Hr(e);let i=s;return r!==e&&(Ze(e)?s.length>3&&(i=function(o,a,c){return s.call(this,o,a,c,e)}):i=function(o,a,c){return s.call(this,o,ht(e,a),c,e)}),r[t](i,...n)}function zn(e,t,s){const n=ae(e);Se(n,"iterate",Es);const r=n[t](...s);return(r===-1||r===!1)&&Kr(s[0])?(s[0]=ae(s[0]),n[t](...s)):r}function hs(e,t,s=[]){ct(),jr();const n=ae(e)[t].apply(e,s);return Dr(),lt(),n}const Sc=Or("__proto__,__v_isRef,__isVue"),Zo=new Set(Object.getOwnPropertyNames(Symbol).filter(e=>e!=="arguments"&&e!=="caller").map(e=>Symbol[e]).filter(as));function Rc(e){as(e)||(e=String(e));const t=ae(this);return Se(t,"has",e),t.hasOwnProperty(e)}class Wo{constructor(t=!1,s=!1){this._isReadonly=t,this._isShallow=s}get(t,s,n){if(s==="__v_skip")return t.__v_skip;const r=this._isReadonly,i=this._isShallow;if(s==="__v_isReactive")return!r;if(s==="__v_isReadonly")return r;if(s==="__v_isShallow")return i;if(s==="__v_raw")return n===(r?i?Ac:Go:i?qo:Ko).get(t)||Object.getPrototypeOf(t)===Object.getPrototypeOf(n)?t:void 0;const o=X(t);if(!r){let c;if(o&&(c=xc[s]))return c;if(s==="hasOwnProperty")return Rc}const a=Reflect.get(t,s,Re(t)?t:n);if((as(s)?Zo.has(s):Sc(s))||(r||Se(t,"get",s),i))return a;if(Re(a)){const c=o&&Fr(s)?a:a.value;return r&&ge(c)?cn(c):c}return ge(a)?r?cn(a):Wr(a):a}}class zo extends Wo{constructor(t=!1){super(!1,t)}set(t,s,n,r){let i=t[s];const o=X(t)&&Fr(s);if(!this._isShallow){const u=kt(i);if(!Ze(n)&&!kt(n)&&(i=ae(i),n=ae(n)),!o&&Re(i)&&!Re(n))return u||(i.value=n),!0}const a=o?Number(s)e,Gs=e=>Reflect.getPrototypeOf(e);function Ic(e,t,s){return function(...n){const r=this.__v_raw,i=ae(r),o=bs(i),a=e==="entries"||e===Symbol.iterator&&o,c=e==="keys"&&o,u=r[e](...n),f=s?dr:t?Os:ut;return!t&&Se(i,"iterate",c?fr:Ft),{next(){const{value:l,done:d}=u.next();return d?{value:l,done:d}:{value:a?[f(l[0]),f(l[1])]:f(l),done:d}},[Symbol.iterator](){return this}}}}function Js(e){return function(...t){return e==="delete"?!1:e==="clear"?void 0:this}}function Lc(e,t){const s={get(r){const i=this.__v_raw,o=ae(i),a=ae(r);e||(xt(r,a)&&Se(o,"get",r),Se(o,"get",a));const{has:c}=Gs(o),u=t?dr:e?Os:ut;if(c.call(o,r))return u(i.get(r));if(c.call(o,a))return u(i.get(a));i!==o&&i.get(r)},get size(){const r=this.__v_raw;return!e&&Se(ae(r),"iterate",Ft),r.size},has(r){const i=this.__v_raw,o=ae(i),a=ae(r);return e||(xt(r,a)&&Se(o,"has",r),Se(o,"has",a)),r===a?i.has(r):i.has(r)||i.has(a)},forEach(r,i){const o=this,a=o.__v_raw,c=ae(a),u=t?dr:e?Os:ut;return!e&&Se(c,"iterate",Ft),a.forEach((f,l)=>r.call(i,u(f),u(l),o))}};return be(s,e?{add:Js("add"),set:Js("set"),delete:Js("delete"),clear:Js("clear")}:{add(r){!t&&!Ze(r)&&!kt(r)&&(r=ae(r));const i=ae(this);return Gs(i).has.call(i,r)||(i.add(r),ot(i,"add",r,r)),this},set(r,i){!t&&!Ze(i)&&!kt(i)&&(i=ae(i));const o=ae(this),{has:a,get:c}=Gs(o);let u=a.call(o,r);u||(r=ae(r),u=a.call(o,r));const f=c.call(o,r);return o.set(r,i),u?xt(i,f)&&ot(o,"set",r,i):ot(o,"add",r,i),this},delete(r){const i=ae(this),{has:o,get:a}=Gs(i);let c=o.call(i,r);c||(r=ae(r),c=o.call(i,r)),a&&a.call(i,r);const u=i.delete(r);return c&&ot(i,"delete",r,void 0),u},clear(){const r=ae(this),i=r.size!==0,o=r.clear();return i&&ot(r,"clear",void 0,void 0),o}}),["keys","values","entries",Symbol.iterator].forEach(r=>{s[r]=Ic(r,e,t)}),s}function Zr(e,t){const s=Lc(e,t);return(n,r,i)=>r==="__v_isReactive"?!e:r==="__v_isReadonly"?e:r==="__v_raw"?n:Reflect.get(le(s,r)&&r in n?s:n,r,i)}const Mc={get:Zr(!1,!1)},Ec={get:Zr(!1,!0)},Oc={get:Zr(!0,!1)};const Ko=new WeakMap,qo=new WeakMap,Go=new WeakMap,Ac=new WeakMap;function Nc(e){switch(e){case"Object":case"Array":return 1;case"Map":case"Set":case"WeakMap":case"WeakSet":return 2;default:return 0}}function Fc(e){return e.__v_skip||!Object.isExtensible(e)?0:Nc(rc(e))}function Wr(e){return kt(e)?e:zr(e,!1,Pc,Mc,Ko)}function $c(e){return zr(e,!1,Tc,Ec,qo)}function cn(e){return zr(e,!0,kc,Oc,Go)}function zr(e,t,s,n,r){if(!ge(e)||e.__v_raw&&!(t&&e.__v_isReactive))return e;const i=Fc(e);if(i===0)return e;const o=r.get(e);if(o)return o;const a=new Proxy(e,i===2?n:s);return r.set(e,a),a}function Jt(e){return kt(e)?Jt(e.__v_raw):!!(e&&e.__v_isReactive)}function kt(e){return!!(e&&e.__v_isReadonly)}function Ze(e){return!!(e&&e.__v_isShallow)}function Kr(e){return e?!!e.__v_raw:!1}function ae(e){const t=e&&e.__v_raw;return t?ae(t):e}function hr(e){return!le(e,"__v_skip")&&Object.isExtensible(e)&&No(e,"__v_skip",!0),e}const ut=e=>ge(e)?Wr(e):e,Os=e=>ge(e)?cn(e):e;function Re(e){return e?e.__v_isRef===!0:!1}function we(e){return Jo(e,!1)}function Bc(e){return Jo(e,!0)}function Jo(e,t){return Re(e)?e:new jc(e,t)}class jc{constructor(t,s){this.dep=new Ur,this.__v_isRef=!0,this.__v_isShallow=!1,this._rawValue=s?t:ae(t),this._value=s?t:ut(t),this.__v_isShallow=s}get value(){return this.dep.track(),this._value}set value(t){const s=this._rawValue,n=this.__v_isShallow||Ze(t)||kt(t);t=n?t:ae(t),xt(t,s)&&(this._rawValue=t,this._value=n?t:ut(t),this.dep.trigger())}}function Dc(e){return Re(e)?e.value:e}const Vc={get:(e,t,s)=>t==="__v_raw"?e:Dc(Reflect.get(e,t,s)),set:(e,t,s,n)=>{const r=e[t];return Re(r)&&!Re(s)?(r.value=s,!0):Reflect.set(e,t,s,n)}};function Yo(e){return Jt(e)?e:new Proxy(e,Vc)}class Uc{constructor(t,s,n){this.fn=t,this.setter=s,this._value=void 0,this.dep=new Ur(this),this.__v_isRef=!0,this.deps=void 0,this.depsTail=void 0,this.flags=16,this.globalVersion=Ms-1,this.next=void 0,this.effect=this,this.__v_isReadonly=!s,this.isSSR=n}notify(){if(this.flags|=16,!(this.flags&8)&&pe!==this)return Bo(this,!0),!0}get value(){const t=this.dep.track();return Vo(this),t&&(t.version=this.dep.version),this._value}set value(t){this.setter&&this.setter(t)}}function Hc(e,t,s=!1){let n,r;return Y(e)?n=e:(n=e.get,r=e.set),new Uc(n,r,s)}const Ys={},ln=new WeakMap;let At;function Zc(e,t=!1,s=At){if(s){let n=ln.get(s);n||ln.set(s,n=[]),n.push(e)}}function Wc(e,t,s=me){const{immediate:n,deep:r,once:i,scheduler:o,augmentJob:a,call:c}=s,u=C=>r?C:Ze(C)||r===!1||r===0?vt(C,1):vt(C);let f,l,d,h,g=!1,y=!1;if(Re(e)?(l=()=>e.value,g=Ze(e)):Jt(e)?(l=()=>u(e),g=!0):X(e)?(y=!0,g=e.some(C=>Jt(C)||Ze(C)),l=()=>e.map(C=>{if(Re(C))return C.value;if(Jt(C))return u(C);if(Y(C))return c?c(C,2):C()})):Y(e)?t?l=c?()=>c(e,2):e:l=()=>{if(d){ct();try{d()}finally{lt()}}const C=At;At=f;try{return c?c(e,3,[h]):e(h)}finally{At=C}}:l=Xe,t&&r){const C=l,k=r===!0?1/0:r;l=()=>vt(C(),k)}const x=vc(),b=()=>{f.stop(),x&&x.active&&Nr(x.effects,f)};if(i&&t){const C=t;t=(...k)=>{C(...k),b()}}let L=y?new Array(e.length).fill(Ys):Ys;const $=C=>{if(!(!(f.flags&1)||!f.dirty&&!C))if(t){const k=f.run();if(r||g||(y?k.some((_,D)=>xt(_,L[D])):xt(k,L))){d&&d();const _=At;At=f;try{const D=[k,L===Ys?void 0:y&&L[0]===Ys?[]:L,h];L=k,c?c(t,3,D):t(...D)}finally{At=_}}}else f.run()};return a&&a($),f=new an(l),f.scheduler=o?()=>o($,!1):$,h=C=>Zc(C,!1,f),d=f.onStop=()=>{const C=ln.get(f);if(C){if(c)c(C,4);else for(const k of C)k();ln.delete(f)}},t?n?$(!0):L=f.run():o?o($.bind(null,!0),!0):f.run(),b.pause=f.pause.bind(f),b.resume=f.resume.bind(f),b.stop=b,b}function vt(e,t=1/0,s){if(t<=0||!ge(e)||e.__v_skip||(s=s||new Map,(s.get(e)||0)>=t))return e;if(s.set(e,t),t--,Re(e))vt(e.value,t,s);else if(X(e))for(let n=0;n{vt(n,t,s)});else if(ic(e)){for(const n in e)vt(e[n],t,s);for(const n of Object.getOwnPropertySymbols(e))Object.prototype.propertyIsEnumerable.call(e,n)&&vt(e[n],t,s)}return e}/** -* @vue/runtime-core v3.5.25 -* (c) 2018-present Yuxi (Evan) You and Vue contributors -* @license MIT -**/function Zs(e,t,s,n){try{return n?e(...n):e()}catch(r){Ws(r,t,s)}}function tt(e,t,s,n){if(Y(e)){const r=Zs(e,t,s,n);return r&&Oo(r)&&r.catch(i=>{Ws(i,t,s)}),r}if(X(e)){const r=[];for(let i=0;i>>1,r=ke[n],i=As(r);i=As(s)?ke.push(e):ke.splice(Kc(t),0,e),e.flags|=1,Qo()}}function Qo(){un||(un=Xo.then(ta))}function mr(e){X(e)?Yt.push(...e):pt&&e.id===-1?pt.splice(Kt+1,0,e):e.flags&1||(Yt.push(e),e.flags|=1),Qo()}function ki(e,t,s=Je+1){for(;sAs(s)-As(n));if(Yt.length=0,pt){pt.push(...t);return}for(pt=t,Kt=0;Kte.id==null?e.flags&2?-1:1/0:e.id;function ta(e){try{for(Je=0;Je{n._d&&pn(-1);const i=fn(t);let o;try{o=e(...r)}finally{fn(i),n._d&&pn(1)}return o};return n._n=!0,n._c=!0,n._d=!0,n}function Et(e,t,s,n){const r=e.dirs,i=t&&t.dirs;for(let o=0;oe.__isTeleport,Yc=Symbol("_leaveCb");function Gr(e,t){e.shapeFlag&6&&e.component?(e.transition=t,Gr(e.component.subTree,t)):e.shapeFlag&128?(e.ssContent.transition=t.clone(e.ssContent),e.ssFallback.transition=t.clone(e.ssFallback)):e.transition=t}function ve(e,t){return Y(e)?be({name:e.name},t,{setup:e}):e}function na(e){e.ids=[e.ids[0]+e.ids[2]+++"-",0,0]}const dn=new WeakMap;function Rs(e,t,s,n,r=!1){if(X(e)){e.forEach((g,y)=>Rs(g,t&&(X(t)?t[y]:t),s,n,r));return}if(Cs(n)&&!r){n.shapeFlag&512&&n.type.__asyncResolved&&n.component.subTree.component&&Rs(e,t,s,n.component.subTree);return}const i=n.shapeFlag&4?ii(n.component):n.el,o=r?null:i,{i:a,r:c}=e,u=t&&t.r,f=a.refs===me?a.refs={}:a.refs,l=a.setupState,d=ae(l),h=l===me?Eo:g=>le(d,g);if(u!=null&&u!==c){if(Ti(t),xe(u))f[u]=null,h(u)&&(l[u]=null);else if(Re(u)){u.value=null;const g=t;g.k&&(f[g.k]=null)}}if(Y(c))Zs(c,a,12,[o,f]);else{const g=xe(c),y=Re(c);if(g||y){const x=()=>{if(e.f){const b=g?h(c)?l[c]:f[c]:c.value;if(r)X(b)&&Nr(b,i);else if(X(b))b.includes(i)||b.push(i);else if(g)f[c]=[i],h(c)&&(l[c]=f[c]);else{const L=[i];c.value=L,e.k&&(f[e.k]=L)}}else g?(f[c]=o,h(c)&&(l[c]=o)):y&&(c.value=o,e.k&&(f[e.k]=o))};if(o){const b=()=>{x(),dn.delete(e)};b.id=-1,dn.set(e,b),Me(b,s)}else Ti(e),x()}}}function Ti(e){const t=dn.get(e);t&&(t.flags|=8,dn.delete(e))}En().requestIdleCallback;En().cancelIdleCallback;const Cs=e=>!!e.type.__asyncLoader,ra=e=>e.type.__isKeepAlive;function Xc(e,t){ia(e,"a",t)}function Qc(e,t){ia(e,"da",t)}function ia(e,t,s=Te){const n=e.__wdc||(e.__wdc=()=>{let r=s;for(;r;){if(r.isDeactivated)return;r=r.parent}return e()});if(On(t,n,s),s){let r=s.parent;for(;r&&r.parent;)ra(r.parent.vnode)&&el(n,t,s,r),r=r.parent}}function el(e,t,s,n){const r=On(t,e,n,!0);Jr(()=>{Nr(n[t],r)},s)}function On(e,t,s=Te,n=!1){if(s){const r=s[e]||(s[e]=[]),i=t.__weh||(t.__weh=(...o)=>{ct();const a=zs(s),c=tt(t,s,e,o);return a(),lt(),c});return n?r.unshift(i):r.push(i),i}}const dt=e=>(t,s=Te)=>{(!$s||e==="sp")&&On(e,(...n)=>t(...n),s)},tl=dt("bm"),at=dt("m"),sl=dt("bu"),nl=dt("u"),rl=dt("bum"),Jr=dt("um"),il=dt("sp"),ol=dt("rtg"),al=dt("rtc");function oa(e,t=Te){On("ec",e,t)}const cl=Symbol.for("v-ndc"),gr=e=>e?Ca(e)?ii(e):gr(e.parent):null,Ps=be(Object.create(null),{$:e=>e,$el:e=>e.vnode.el,$data:e=>e.data,$props:e=>e.props,$attrs:e=>e.attrs,$slots:e=>e.slots,$refs:e=>e.refs,$parent:e=>gr(e.parent),$root:e=>gr(e.root),$host:e=>e.ce,$emit:e=>e.emit,$options:e=>Yr(e),$forceUpdate:e=>e.f||(e.f=()=>{qr(e.update)}),$nextTick:e=>e.n||(e.n=pr.bind(e.proxy)),$watch:e=>_l.bind(e)}),Kn=(e,t)=>e!==me&&!e.__isScriptSetup&&le(e,t),ll={get({_:e},t){if(t==="__v_skip")return!0;const{ctx:s,setupState:n,data:r,props:i,accessCache:o,type:a,appContext:c}=e;if(t[0]!=="$"){const d=o[t];if(d!==void 0)switch(d){case 1:return n[t];case 2:return r[t];case 4:return s[t];case 3:return i[t]}else{if(Kn(n,t))return o[t]=1,n[t];if(r!==me&&le(r,t))return o[t]=2,r[t];if(le(i,t))return o[t]=3,i[t];if(s!==me&&le(s,t))return o[t]=4,s[t];vr&&(o[t]=0)}}const u=Ps[t];let f,l;if(u)return t==="$attrs"&&Se(e.attrs,"get",""),u(e);if((f=a.__cssModules)&&(f=f[t]))return f;if(s!==me&&le(s,t))return o[t]=4,s[t];if(l=c.config.globalProperties,le(l,t))return l[t]},set({_:e},t,s){const{data:n,setupState:r,ctx:i}=e;return Kn(r,t)?(r[t]=s,!0):n!==me&&le(n,t)?(n[t]=s,!0):le(e.props,t)||t[0]==="$"&&t.slice(1)in e?!1:(i[t]=s,!0)},has({_:{data:e,setupState:t,accessCache:s,ctx:n,appContext:r,props:i,type:o}},a){let c;return!!(s[a]||e!==me&&a[0]!=="$"&&le(e,a)||Kn(t,a)||le(i,a)||le(n,a)||le(Ps,a)||le(r.config.globalProperties,a)||(c=o.__cssModules)&&c[a])},defineProperty(e,t,s){return s.get!=null?e._.accessCache[t]=0:le(s,"value")&&this.set(e,t,s.value,null),Reflect.defineProperty(e,t,s)}};function Ii(e){return X(e)?e.reduce((t,s)=>(t[s]=null,t),{}):e}let vr=!0;function ul(e){const t=Yr(e),s=e.proxy,n=e.ctx;vr=!1,t.beforeCreate&&Li(t.beforeCreate,e,"bc");const{data:r,computed:i,methods:o,watch:a,provide:c,inject:u,created:f,beforeMount:l,mounted:d,beforeUpdate:h,updated:g,activated:y,deactivated:x,beforeDestroy:b,beforeUnmount:L,destroyed:$,unmounted:C,render:k,renderTracked:_,renderTriggered:D,errorCaptured:M,serverPrefetch:B,expose:W,inheritAttrs:J,components:de,directives:P,filters:H}=t;if(u&&fl(u,n,null),o)for(const ie in o){const oe=o[ie];Y(oe)&&(n[ie]=oe.bind(s))}if(r){const ie=r.call(s,s);ge(ie)&&(e.data=Wr(ie))}if(vr=!0,i)for(const ie in i){const oe=i[ie],nt=Y(oe)?oe.bind(s,s):Y(oe.get)?oe.get.bind(s,s):Xe,Ks=!Y(oe)&&Y(oe.set)?oe.set.bind(s):Xe,Mt=fe({get:nt,set:Ks});Object.defineProperty(n,ie,{enumerable:!0,configurable:!0,get:()=>Mt.value,set:We=>Mt.value=We})}if(a)for(const ie in a)aa(a[ie],n,s,ie);if(c){const ie=Y(c)?c.call(s):c;Reflect.ownKeys(ie).forEach(oe=>{An(oe,ie[oe])})}f&&Li(f,e,"c");function Q(ie,oe){X(oe)?oe.forEach(nt=>ie(nt.bind(s))):oe&&ie(oe.bind(s))}if(Q(tl,l),Q(at,d),Q(sl,h),Q(nl,g),Q(Xc,y),Q(Qc,x),Q(oa,M),Q(al,_),Q(ol,D),Q(rl,L),Q(Jr,C),Q(il,B),X(W))if(W.length){const ie=e.exposed||(e.exposed={});W.forEach(oe=>{Object.defineProperty(ie,oe,{get:()=>s[oe],set:nt=>s[oe]=nt,enumerable:!0})})}else e.exposed||(e.exposed={});k&&e.render===Xe&&(e.render=k),J!=null&&(e.inheritAttrs=J),de&&(e.components=de),P&&(e.directives=P),B&&na(e)}function fl(e,t,s=Xe){X(e)&&(e=yr(e));for(const n in e){const r=e[n];let i;ge(r)?"default"in r?i=wt(r.from||n,r.default,!0):i=wt(r.from||n):i=wt(r),Re(i)?Object.defineProperty(t,n,{enumerable:!0,configurable:!0,get:()=>i.value,set:o=>i.value=o}):t[n]=i}}function Li(e,t,s){tt(X(e)?e.map(n=>n.bind(t.proxy)):e.bind(t.proxy),t,s)}function aa(e,t,s,n){let r=n.includes(".")?ua(s,n):()=>s[n];if(xe(e)){const i=t[e];Y(i)&&Qe(r,i)}else if(Y(e))Qe(r,e.bind(s));else if(ge(e))if(X(e))e.forEach(i=>aa(i,t,s,n));else{const i=Y(e.handler)?e.handler.bind(s):t[e.handler];Y(i)&&Qe(r,i,e)}}function Yr(e){const t=e.type,{mixins:s,extends:n}=t,{mixins:r,optionsCache:i,config:{optionMergeStrategies:o}}=e.appContext,a=i.get(t);let c;return a?c=a:!r.length&&!s&&!n?c=t:(c={},r.length&&r.forEach(u=>hn(c,u,o,!0)),hn(c,t,o)),ge(t)&&i.set(t,c),c}function hn(e,t,s,n=!1){const{mixins:r,extends:i}=t;i&&hn(e,i,s,!0),r&&r.forEach(o=>hn(e,o,s,!0));for(const o in t)if(!(n&&o==="expose")){const a=dl[o]||s&&s[o];e[o]=a?a(e[o],t[o]):t[o]}return e}const dl={data:Mi,props:Ei,emits:Ei,methods:gs,computed:gs,beforeCreate:Pe,created:Pe,beforeMount:Pe,mounted:Pe,beforeUpdate:Pe,updated:Pe,beforeDestroy:Pe,beforeUnmount:Pe,destroyed:Pe,unmounted:Pe,activated:Pe,deactivated:Pe,errorCaptured:Pe,serverPrefetch:Pe,components:gs,directives:gs,watch:pl,provide:Mi,inject:hl};function Mi(e,t){return t?e?function(){return be(Y(e)?e.call(this,this):e,Y(t)?t.call(this,this):t)}:t:e}function hl(e,t){return gs(yr(e),yr(t))}function yr(e){if(X(e)){const t={};for(let s=0;s1)return s&&Y(t)?t.call(n&&n.proxy):t}}const vl=Symbol.for("v-scx"),yl=()=>wt(vl);function la(e,t){return Xr(e,null,t)}function Qe(e,t,s){return Xr(e,t,s)}function Xr(e,t,s=me){const{immediate:n,deep:r,flush:i,once:o}=s,a=be({},s),c=t&&n||!t&&i!=="post";let u;if($s){if(i==="sync"){const h=yl();u=h.__watcherHandles||(h.__watcherHandles=[])}else if(!c){const h=()=>{};return h.stop=Xe,h.resume=Xe,h.pause=Xe,h}}const f=Te;a.call=(h,g,y)=>tt(h,f,g,y);let l=!1;i==="post"?a.scheduler=h=>{Me(h,f&&f.suspense)}:i!=="sync"&&(l=!0,a.scheduler=(h,g)=>{g?h():qr(h)}),a.augmentJob=h=>{t&&(h.flags|=4),l&&(h.flags|=2,f&&(h.id=f.uid,h.i=f))};const d=Wc(e,t,a);return $s&&(u?u.push(d):c&&d()),d}function _l(e,t,s){const n=this.proxy,r=xe(e)?e.includes(".")?ua(n,e):()=>n[e]:e.bind(n,n);let i;Y(t)?i=t:(i=t.handler,s=t);const o=zs(this),a=Xr(r,i.bind(n),s);return o(),a}function ua(e,t){const s=t.split(".");return()=>{let n=e;for(let r=0;rt==="modelValue"||t==="model-value"?e.modelModifiers:e[`${t}Modifiers`]||e[`${Pt(t)}Modifiers`]||e[`${Zt(t)}Modifiers`];function xl(e,t,...s){if(e.isUnmounted)return;const n=e.vnode.props||me;let r=s;const i=t.startsWith("update:"),o=i&&bl(n,t.slice(7));o&&(o.trim&&(r=s.map(f=>xe(f)?f.trim():f)),o.number&&(r=s.map(cc)));let a,c=n[a=Un(t)]||n[a=Un(Pt(t))];!c&&i&&(c=n[a=Un(Zt(t))]),c&&tt(c,e,6,r);const u=n[a+"Once"];if(u){if(!e.emitted)e.emitted={};else if(e.emitted[a])return;e.emitted[a]=!0,tt(u,e,6,r)}}const wl=new WeakMap;function fa(e,t,s=!1){const n=s?wl:t.emitsCache,r=n.get(e);if(r!==void 0)return r;const i=e.emits;let o={},a=!1;if(!Y(e)){const c=u=>{const f=fa(u,t,!0);f&&(a=!0,be(o,f))};!s&&t.mixins.length&&t.mixins.forEach(c),e.extends&&c(e.extends),e.mixins&&e.mixins.forEach(c)}return!i&&!a?(ge(e)&&n.set(e,null),null):(X(i)?i.forEach(c=>o[c]=null):be(o,i),ge(e)&&n.set(e,o),o)}function Nn(e,t){return!e||!In(t)?!1:(t=t.slice(2).replace(/Once$/,""),le(e,t[0].toLowerCase()+t.slice(1))||le(e,Zt(t))||le(e,t))}function Oi(e){const{type:t,vnode:s,proxy:n,withProxy:r,propsOptions:[i],slots:o,attrs:a,emit:c,render:u,renderCache:f,props:l,data:d,setupState:h,ctx:g,inheritAttrs:y}=e,x=fn(e);let b,L;try{if(s.shapeFlag&4){const C=r||n,k=C;b=De(u.call(k,C,f,l,h,d,g)),L=a}else{const C=t;b=De(C.length>1?C(l,{attrs:a,slots:o,emit:c}):C(l,null)),L=t.props?a:Rl(a)}}catch(C){ks.length=0,Ws(C,e,1),b=ce(Tt)}let $=b;if(L&&y!==!1){const C=Object.keys(L),{shapeFlag:k}=$;C.length&&k&7&&(i&&C.some(Ar)&&(L=Cl(L,i)),$=es($,L,!1,!0))}return s.dirs&&($=es($,null,!1,!0),$.dirs=$.dirs?$.dirs.concat(s.dirs):s.dirs),s.transition&&Gr($,s.transition),b=$,fn(x),b}function Sl(e,t=!0){let s;for(let n=0;n{let t;for(const s in e)(s==="class"||s==="style"||In(s))&&((t||(t={}))[s]=e[s]);return t},Cl=(e,t)=>{const s={};for(const n in e)(!Ar(n)||!(n.slice(9)in t))&&(s[n]=e[n]);return s};function Pl(e,t,s){const{props:n,children:r,component:i}=e,{props:o,children:a,patchFlag:c}=t,u=i.emitsOptions;if(t.dirs||t.transition)return!0;if(s&&c>=0){if(c&1024)return!0;if(c&16)return n?Ai(n,o,u):!!o;if(c&8){const f=t.dynamicProps;for(let l=0;lObject.create(da),pa=e=>Object.getPrototypeOf(e)===da;function kl(e,t,s,n=!1){const r={},i=ha();e.propsDefaults=Object.create(null),ma(e,t,r,i);for(const o in e.propsOptions[0])o in r||(r[o]=void 0);s?e.props=n?r:$c(r):e.type.props?e.props=r:e.props=i,e.attrs=i}function Tl(e,t,s,n){const{props:r,attrs:i,vnode:{patchFlag:o}}=e,a=ae(r),[c]=e.propsOptions;let u=!1;if((n||o>0)&&!(o&16)){if(o&8){const f=e.vnode.dynamicProps;for(let l=0;l{c=!0;const[d,h]=ga(l,t,!0);be(o,d),h&&a.push(...h)};!s&&t.mixins.length&&t.mixins.forEach(f),e.extends&&f(e.extends),e.mixins&&e.mixins.forEach(f)}if(!i&&!c)return ge(e)&&n.set(e,_s),_s;if(X(i))for(let f=0;fe==="_"||e==="_ctx"||e==="$stable",ti=e=>X(e)?e.map(De):[De(e)],Ll=(e,t,s)=>{if(t._n)return t;const n=qc((...r)=>ti(t(...r)),s);return n._c=!1,n},va=(e,t,s)=>{const n=e._ctx;for(const r in e){if(ei(r))continue;const i=e[r];if(Y(i))t[r]=Ll(r,i,n);else if(i!=null){const o=ti(i);t[r]=()=>o}}},ya=(e,t)=>{const s=ti(t);e.slots.default=()=>s},_a=(e,t,s)=>{for(const n in t)(s||!ei(n))&&(e[n]=t[n])},Ml=(e,t,s)=>{const n=e.slots=ha();if(e.vnode.shapeFlag&32){const r=t._;r?(_a(n,t,s),s&&No(n,"_",r,!0)):va(t,n)}else t&&ya(e,t)},El=(e,t,s)=>{const{vnode:n,slots:r}=e;let i=!0,o=me;if(n.shapeFlag&32){const a=t._;a?s&&a===1?i=!1:_a(r,t,s):(i=!t.$stable,va(t,r)),o=t}else t&&(ya(e,t),o={default:1});if(i)for(const a in r)!ei(a)&&o[a]==null&&delete r[a]},Me=Ul;function Ol(e){return Al(e)}function Al(e,t){const s=En();s.__VUE__=!0;const{insert:n,remove:r,patchProp:i,createElement:o,createText:a,createComment:c,setText:u,setElementText:f,parentNode:l,nextSibling:d,setScopeId:h=Xe,insertStaticContent:g}=e,y=(p,m,v,T=null,w=null,S=null,A=void 0,O=null,E=!!m.dynamicChildren)=>{if(p===m)return;p&&!yt(p,m)&&(T=qs(p),We(p,w,S,!0),p=null),m.patchFlag===-2&&(E=!1,m.dynamicChildren=null);const{type:R,ref:z,shapeFlag:F}=m;switch(R){case Fn:x(p,m,v,T);break;case Tt:b(p,m,v,T);break;case Gn:p==null&&L(m,v,T,A);break;case Fe:de(p,m,v,T,w,S,A,O,E);break;default:F&1?k(p,m,v,T,w,S,A,O,E):F&6?P(p,m,v,T,w,S,A,O,E):(F&64||F&128)&&R.process(p,m,v,T,w,S,A,O,E,fs)}z!=null&&w?Rs(z,p&&p.ref,S,m||p,!m):z==null&&p&&p.ref!=null&&Rs(p.ref,null,S,p,!0)},x=(p,m,v,T)=>{if(p==null)n(m.el=a(m.children),v,T);else{const w=m.el=p.el;m.children!==p.children&&u(w,m.children)}},b=(p,m,v,T)=>{p==null?n(m.el=c(m.children||""),v,T):m.el=p.el},L=(p,m,v,T)=>{[p.el,p.anchor]=g(p.children,m,v,T,p.el,p.anchor)},$=({el:p,anchor:m},v,T)=>{let w;for(;p&&p!==m;)w=d(p),n(p,v,T),p=w;n(m,v,T)},C=({el:p,anchor:m})=>{let v;for(;p&&p!==m;)v=d(p),r(p),p=v;r(m)},k=(p,m,v,T,w,S,A,O,E)=>{if(m.type==="svg"?A="svg":m.type==="math"&&(A="mathml"),p==null)_(m,v,T,w,S,A,O,E);else{const R=p.el&&p.el._isVueCE?p.el:null;try{R&&R._beginPatch(),B(p,m,w,S,A,O,E)}finally{R&&R._endPatch()}}},_=(p,m,v,T,w,S,A,O)=>{let E,R;const{props:z,shapeFlag:F,transition:Z,dirs:K}=p;if(E=p.el=o(p.type,S,z&&z.is,z),F&8?f(E,p.children):F&16&&M(p.children,E,null,T,w,qn(p,S),A,O),K&&Et(p,null,T,"created"),D(E,p,p.scopeId,A,T),z){for(const he in z)he!=="value"&&!xs(he)&&i(E,he,null,z[he],S,T);"value"in z&&i(E,"value",null,z.value,S),(R=z.onVnodeBeforeMount)&&Ge(R,T,p)}K&&Et(p,null,T,"beforeMount");const se=Nl(w,Z);se&&Z.beforeEnter(E),n(E,m,v),((R=z&&z.onVnodeMounted)||se||K)&&Me(()=>{R&&Ge(R,T,p),se&&Z.enter(E),K&&Et(p,null,T,"mounted")},w)},D=(p,m,v,T,w)=>{if(v&&h(p,v),T)for(let S=0;S{for(let R=E;R{const O=m.el=p.el;let{patchFlag:E,dynamicChildren:R,dirs:z}=m;E|=p.patchFlag&16;const F=p.props||me,Z=m.props||me;let K;if(v&&Ot(v,!1),(K=Z.onVnodeBeforeUpdate)&&Ge(K,v,m,p),z&&Et(m,p,v,"beforeUpdate"),v&&Ot(v,!0),(F.innerHTML&&Z.innerHTML==null||F.textContent&&Z.textContent==null)&&f(O,""),R?W(p.dynamicChildren,R,O,v,T,qn(m,w),S):A||oe(p,m,O,null,v,T,qn(m,w),S,!1),E>0){if(E&16)J(O,F,Z,v,w);else if(E&2&&F.class!==Z.class&&i(O,"class",null,Z.class,w),E&4&&i(O,"style",F.style,Z.style,w),E&8){const se=m.dynamicProps;for(let he=0;he{K&&Ge(K,v,m,p),z&&Et(m,p,v,"updated")},T)},W=(p,m,v,T,w,S,A)=>{for(let O=0;O{if(m!==v){if(m!==me)for(const S in m)!xs(S)&&!(S in v)&&i(p,S,m[S],null,w,T);for(const S in v){if(xs(S))continue;const A=v[S],O=m[S];A!==O&&S!=="value"&&i(p,S,O,A,w,T)}"value"in v&&i(p,"value",m.value,v.value,w)}},de=(p,m,v,T,w,S,A,O,E)=>{const R=m.el=p?p.el:a(""),z=m.anchor=p?p.anchor:a("");let{patchFlag:F,dynamicChildren:Z,slotScopeIds:K}=m;K&&(O=O?O.concat(K):K),p==null?(n(R,v,T),n(z,v,T),M(m.children||[],v,z,w,S,A,O,E)):F>0&&F&64&&Z&&p.dynamicChildren?(W(p.dynamicChildren,Z,v,w,S,A,O),(m.key!=null||w&&m===w.subTree)&&ba(p,m,!0)):oe(p,m,v,z,w,S,A,O,E)},P=(p,m,v,T,w,S,A,O,E)=>{m.slotScopeIds=O,p==null?m.shapeFlag&512?w.ctx.activate(m,v,T,A,E):H(m,v,T,w,S,A,E):te(p,m,E)},H=(p,m,v,T,w,S,A)=>{const O=p.component=Yl(p,T,w);if(ra(p)&&(O.ctx.renderer=fs),Ql(O,!1,A),O.asyncDep){if(w&&w.registerDep(O,Q,A),!p.el){const E=O.subTree=ce(Tt);b(null,E,m,v),p.placeholder=E.el}}else Q(O,p,m,v,w,S,A)},te=(p,m,v)=>{const T=m.component=p.component;if(Pl(p,m,v))if(T.asyncDep&&!T.asyncResolved){ie(T,m,v);return}else T.next=m,T.update();else m.el=p.el,T.vnode=m},Q=(p,m,v,T,w,S,A)=>{const O=()=>{if(p.isMounted){let{next:F,bu:Z,u:K,parent:se,vnode:he}=p;{const Ke=xa(p);if(Ke){F&&(F.el=he.el,ie(p,F,A)),Ke.asyncDep.then(()=>{p.isUnmounted||O()});return}}let ue=F,Ie;Ot(p,!1),F?(F.el=he.el,ie(p,F,A)):F=he,Z&&Hn(Z),(Ie=F.props&&F.props.onVnodeBeforeUpdate)&&Ge(Ie,se,F,he),Ot(p,!0);const Le=Oi(p),ze=p.subTree;p.subTree=Le,y(ze,Le,l(ze.el),qs(ze),p,w,S),F.el=Le.el,ue===null&&Qr(p,Le.el),K&&Me(K,w),(Ie=F.props&&F.props.onVnodeUpdated)&&Me(()=>Ge(Ie,se,F,he),w)}else{let F;const{el:Z,props:K}=m,{bm:se,m:he,parent:ue,root:Ie,type:Le}=p,ze=Cs(m);Ot(p,!1),se&&Hn(se),!ze&&(F=K&&K.onVnodeBeforeMount)&&Ge(F,ue,m),Ot(p,!0);{Ie.ce&&Ie.ce._def.shadowRoot!==!1&&Ie.ce._injectChildStyle(Le);const Ke=p.subTree=Oi(p);y(null,Ke,v,T,p,w,S),m.el=Ke.el}if(he&&Me(he,w),!ze&&(F=K&&K.onVnodeMounted)){const Ke=m;Me(()=>Ge(F,ue,Ke),w)}(m.shapeFlag&256||ue&&Cs(ue.vnode)&&ue.vnode.shapeFlag&256)&&p.a&&Me(p.a,w),p.isMounted=!0,m=v=T=null}};p.scope.on();const E=p.effect=new an(O);p.scope.off();const R=p.update=E.run.bind(E),z=p.job=E.runIfDirty.bind(E);z.i=p,z.id=p.uid,E.scheduler=()=>qr(z),Ot(p,!0),R()},ie=(p,m,v)=>{m.component=p;const T=p.vnode.props;p.vnode=m,p.next=null,Tl(p,m.props,T,v),El(p,m.children,v),ct(),ki(p),lt()},oe=(p,m,v,T,w,S,A,O,E=!1)=>{const R=p&&p.children,z=p?p.shapeFlag:0,F=m.children,{patchFlag:Z,shapeFlag:K}=m;if(Z>0){if(Z&128){Ks(R,F,v,T,w,S,A,O,E);return}else if(Z&256){nt(R,F,v,T,w,S,A,O,E);return}}K&8?(z&16&&us(R,w,S),F!==R&&f(v,F)):z&16?K&16?Ks(R,F,v,T,w,S,A,O,E):us(R,w,S,!0):(z&8&&f(v,""),K&16&&M(F,v,T,w,S,A,O,E))},nt=(p,m,v,T,w,S,A,O,E)=>{p=p||_s,m=m||_s;const R=p.length,z=m.length,F=Math.min(R,z);let Z;for(Z=0;Zz?us(p,w,S,!0,!1,F):M(m,v,T,w,S,A,O,E,F)},Ks=(p,m,v,T,w,S,A,O,E)=>{let R=0;const z=m.length;let F=p.length-1,Z=z-1;for(;R<=F&&R<=Z;){const K=p[R],se=m[R]=E?mt(m[R]):De(m[R]);if(yt(K,se))y(K,se,v,null,w,S,A,O,E);else break;R++}for(;R<=F&&R<=Z;){const K=p[F],se=m[Z]=E?mt(m[Z]):De(m[Z]);if(yt(K,se))y(K,se,v,null,w,S,A,O,E);else break;F--,Z--}if(R>F){if(R<=Z){const K=Z+1,se=KZ)for(;R<=F;)We(p[R],w,S,!0),R++;else{const K=R,se=R,he=new Map;for(R=se;R<=Z;R++){const Oe=m[R]=E?mt(m[R]):De(m[R]);Oe.key!=null&&he.set(Oe.key,R)}let ue,Ie=0;const Le=Z-se+1;let ze=!1,Ke=0;const ds=new Array(Le);for(R=0;R=Le){We(Oe,w,S,!0);continue}let qe;if(Oe.key!=null)qe=he.get(Oe.key);else for(ue=se;ue<=Z;ue++)if(ds[ue-se]===0&&yt(Oe,m[ue])){qe=ue;break}qe===void 0?We(Oe,w,S,!0):(ds[qe-se]=R+1,qe>=Ke?Ke=qe:ze=!0,y(Oe,m[qe],v,null,w,S,A,O,E),Ie++)}const xi=ze?Fl(ds):_s;for(ue=xi.length-1,R=Le-1;R>=0;R--){const Oe=se+R,qe=m[Oe],wi=m[Oe+1],Si=Oe+1{const{el:S,type:A,transition:O,children:E,shapeFlag:R}=p;if(R&6){Mt(p.component.subTree,m,v,T);return}if(R&128){p.suspense.move(m,v,T);return}if(R&64){A.move(p,m,v,fs);return}if(A===Fe){n(S,m,v);for(let F=0;FO.enter(S),w);else{const{leave:F,delayLeave:Z,afterLeave:K}=O,se=()=>{p.ctx.isUnmounted?r(S):n(S,m,v)},he=()=>{S._isLeaving&&S[Yc](!0),F(S,()=>{se(),K&&K()})};Z?Z(S,se,he):he()}else n(S,m,v)},We=(p,m,v,T=!1,w=!1)=>{const{type:S,props:A,ref:O,children:E,dynamicChildren:R,shapeFlag:z,patchFlag:F,dirs:Z,cacheIndex:K}=p;if(F===-2&&(w=!1),O!=null&&(ct(),Rs(O,null,v,p,!0),lt()),K!=null&&(m.renderCache[K]=void 0),z&256){m.ctx.deactivate(p);return}const se=z&1&&Z,he=!Cs(p);let ue;if(he&&(ue=A&&A.onVnodeBeforeUnmount)&&Ge(ue,m,p),z&6)ec(p.component,v,T);else{if(z&128){p.suspense.unmount(v,T);return}se&&Et(p,null,m,"beforeUnmount"),z&64?p.type.remove(p,m,v,fs,T):R&&!R.hasOnce&&(S!==Fe||F>0&&F&64)?us(R,m,v,!1,!0):(S===Fe&&F&384||!w&&z&16)&&us(E,m,v),T&&_i(p)}(he&&(ue=A&&A.onVnodeUnmounted)||se)&&Me(()=>{ue&&Ge(ue,m,p),se&&Et(p,null,m,"unmounted")},v)},_i=p=>{const{type:m,el:v,anchor:T,transition:w}=p;if(m===Fe){Qa(v,T);return}if(m===Gn){C(p);return}const S=()=>{r(v),w&&!w.persisted&&w.afterLeave&&w.afterLeave()};if(p.shapeFlag&1&&w&&!w.persisted){const{leave:A,delayLeave:O}=w,E=()=>A(v,S);O?O(p.el,S,E):E()}else S()},Qa=(p,m)=>{let v;for(;p!==m;)v=d(p),r(p),p=v;r(m)},ec=(p,m,v)=>{const{bum:T,scope:w,job:S,subTree:A,um:O,m:E,a:R}=p;Fi(E),Fi(R),T&&Hn(T),w.stop(),S&&(S.flags|=8,We(A,p,m,v)),O&&Me(O,m),Me(()=>{p.isUnmounted=!0},m)},us=(p,m,v,T=!1,w=!1,S=0)=>{for(let A=S;A{if(p.shapeFlag&6)return qs(p.component.subTree);if(p.shapeFlag&128)return p.suspense.next();const m=d(p.anchor||p.el),v=m&&m[Gc];return v?d(v):m};let Vn=!1;const bi=(p,m,v)=>{p==null?m._vnode&&We(m._vnode,null,null,!0):y(m._vnode||null,p,m,null,null,null,v),m._vnode=p,Vn||(Vn=!0,ki(),ea(),Vn=!1)},fs={p:y,um:We,m:Mt,r:_i,mt:H,mc:M,pc:oe,pbc:W,n:qs,o:e};return{render:bi,hydrate:void 0,createApp:gl(bi)}}function qn({type:e,props:t},s){return s==="svg"&&e==="foreignObject"||s==="mathml"&&e==="annotation-xml"&&t&&t.encoding&&t.encoding.includes("html")?void 0:s}function Ot({effect:e,job:t},s){s?(e.flags|=32,t.flags|=4):(e.flags&=-33,t.flags&=-5)}function Nl(e,t){return(!e||e&&!e.pendingBranch)&&t&&!t.persisted}function ba(e,t,s=!1){const n=e.children,r=t.children;if(X(n)&&X(r))for(let i=0;i>1,e[s[a]]0&&(t[n]=s[i-1]),s[i]=n)}}for(i=s.length,o=s[i-1];i-- >0;)s[i]=o,o=t[o];return s}function xa(e){const t=e.subTree.component;if(t)return t.asyncDep&&!t.asyncResolved?t:xa(t)}function Fi(e){if(e)for(let t=0;te.__isSuspense;let br=0;const $l={name:"Suspense",__isSuspense:!0,process(e,t,s,n,r,i,o,a,c,u){if(e==null)Bl(t,s,n,r,i,o,a,c,u);else{if(i&&i.deps>0&&!e.suspense.isInFallback){t.suspense=e.suspense,t.suspense.vnode=t,t.el=e.el;return}jl(e,t,s,n,r,o,a,c,u)}},hydrate:Dl,normalize:Vl},si=$l;function Ns(e,t){const s=e.props&&e.props[t];Y(s)&&s()}function Bl(e,t,s,n,r,i,o,a,c){const{p:u,o:{createElement:f}}=c,l=f("div"),d=e.suspense=Sa(e,r,n,t,l,s,i,o,a,c);u(null,d.pendingBranch=e.ssContent,l,null,n,d,i,o),d.deps>0?(Ns(e,"onPending"),Ns(e,"onFallback"),u(null,e.ssFallback,t,s,n,null,i,o),Qt(d,e.ssFallback)):d.resolve(!1,!0)}function jl(e,t,s,n,r,i,o,a,{p:c,um:u,o:{createElement:f}}){const l=t.suspense=e.suspense;l.vnode=t,t.el=e.el;const d=t.ssContent,h=t.ssFallback,{activeBranch:g,pendingBranch:y,isInFallback:x,isHydrating:b}=l;if(y)l.pendingBranch=d,yt(y,d)?(c(y,d,l.hiddenContainer,null,r,l,i,o,a),l.deps<=0?l.resolve():x&&(b||(c(g,h,s,n,r,null,i,o,a),Qt(l,h)))):(l.pendingId=br++,b?(l.isHydrating=!1,l.activeBranch=y):u(y,r,l),l.deps=0,l.effects.length=0,l.hiddenContainer=f("div"),x?(c(null,d,l.hiddenContainer,null,r,l,i,o,a),l.deps<=0?l.resolve():(c(g,h,s,n,r,null,i,o,a),Qt(l,h))):g&&yt(g,d)?(c(g,d,s,n,r,l,i,o,a),l.resolve(!0)):(c(null,d,l.hiddenContainer,null,r,l,i,o,a),l.deps<=0&&l.resolve()));else if(g&&yt(g,d))c(g,d,s,n,r,l,i,o,a),Qt(l,d);else if(Ns(t,"onPending"),l.pendingBranch=d,d.shapeFlag&512?l.pendingId=d.component.suspenseId:l.pendingId=br++,c(null,d,l.hiddenContainer,null,r,l,i,o,a),l.deps<=0)l.resolve();else{const{timeout:L,pendingId:$}=l;L>0?setTimeout(()=>{l.pendingId===$&&l.fallback(h)},L):L===0&&l.fallback(h)}}function Sa(e,t,s,n,r,i,o,a,c,u,f=!1){const{p:l,m:d,um:h,n:g,o:{parentNode:y,remove:x}}=u;let b;const L=Hl(e);L&&t&&t.pendingBranch&&(b=t.pendingId,t.deps++);const $=e.props?lc(e.props.timeout):void 0,C=i,k={vnode:e,parent:t,parentComponent:s,namespace:o,container:n,hiddenContainer:r,deps:0,pendingId:br++,timeout:typeof $=="number"?$:-1,activeBranch:null,pendingBranch:null,isInFallback:!f,isHydrating:f,isUnmounted:!1,effects:[],resolve(_=!1,D=!1){const{vnode:M,activeBranch:B,pendingBranch:W,pendingId:J,effects:de,parentComponent:P,container:H,isInFallback:te}=k;let Q=!1;k.isHydrating?k.isHydrating=!1:_||(Q=B&&W.transition&&W.transition.mode==="out-in",Q&&(B.transition.afterLeave=()=>{J===k.pendingId&&(d(W,H,i===C?g(B):i,0),mr(de),te&&M.ssFallback&&(M.ssFallback.el=null))}),B&&(y(B.el)===H&&(i=g(B)),h(B,P,k,!0),!Q&&te&&M.ssFallback&&Me(()=>M.ssFallback.el=null,k)),Q||d(W,H,i,0)),Qt(k,W),k.pendingBranch=null,k.isInFallback=!1;let ie=k.parent,oe=!1;for(;ie;){if(ie.pendingBranch){ie.effects.push(...de),oe=!0;break}ie=ie.parent}!oe&&!Q&&mr(de),k.effects=[],L&&t&&t.pendingBranch&&b===t.pendingId&&(t.deps--,t.deps===0&&!D&&t.resolve()),Ns(M,"onResolve")},fallback(_){if(!k.pendingBranch)return;const{vnode:D,activeBranch:M,parentComponent:B,container:W,namespace:J}=k;Ns(D,"onFallback");const de=g(M),P=()=>{k.isInFallback&&(l(null,_,W,de,B,null,J,a,c),Qt(k,_))},H=_.transition&&_.transition.mode==="out-in";H&&(M.transition.afterLeave=P),k.isInFallback=!0,h(M,B,null,!0),H||P()},move(_,D,M){k.activeBranch&&d(k.activeBranch,_,D,M),k.container=_},next(){return k.activeBranch&&g(k.activeBranch)},registerDep(_,D,M){const B=!!k.pendingBranch;B&&k.deps++;const W=_.vnode.el;_.asyncDep.catch(J=>{Ws(J,_,0)}).then(J=>{if(_.isUnmounted||k.isUnmounted||k.pendingId!==_.suspenseId)return;_.asyncResolved=!0;const{vnode:de}=_;Sr(_,J,!1),W&&(de.el=W);const P=!W&&_.subTree.el;D(_,de,y(W||_.subTree.el),W?null:g(_.subTree),k,o,M),P&&(de.placeholder=null,x(P)),Qr(_,de.el),B&&--k.deps===0&&k.resolve()})},unmount(_,D){k.isUnmounted=!0,k.activeBranch&&h(k.activeBranch,s,_,D),k.pendingBranch&&h(k.pendingBranch,s,_,D)}};return k}function Dl(e,t,s,n,r,i,o,a,c){const u=t.suspense=Sa(t,n,s,e.parentNode,document.createElement("div"),null,r,i,o,a,!0),f=c(e,u.pendingBranch=t.ssContent,s,u,i,o);return u.deps===0&&u.resolve(!1,!0),f}function Vl(e){const{shapeFlag:t,children:s}=e,n=t&32;e.ssContent=$i(n?s.default:s),e.ssFallback=n?$i(s.fallback):ce(Tt)}function $i(e){let t;if(Y(e)){const s=$n&&e._c;s&&(e._d=!1,Zl()),e=e(),s&&(e._d=!0,t=Ve,Wl())}return X(e)&&(e=Sl(e)),e=De(e),t&&!e.dynamicChildren&&(e.dynamicChildren=t.filter(s=>s!==e)),e}function Ul(e,t){t&&t.pendingBranch?X(e)?t.effects.push(...e):t.effects.push(e):mr(e)}function Qt(e,t){e.activeBranch=t;const{vnode:s,parentComponent:n}=e;let r=t.el;for(;!r&&t.component;)t=t.component.subTree,r=t.el;s.el=r,n&&n.subTree===s&&(n.vnode.el=r,Qr(n,r))}function Hl(e){const t=e.props&&e.props.suspensible;return t!=null&&t!==!1}const Fe=Symbol.for("v-fgt"),Fn=Symbol.for("v-txt"),Tt=Symbol.for("v-cmt"),Gn=Symbol.for("v-stc"),ks=[];let Ve=null;function Zl(e=!1){ks.push(Ve=e?null:[])}function Wl(){ks.pop(),Ve=ks[ks.length-1]||null}let $n=1;function pn(e,t=!1){$n+=e,e<0&&Ve&&t&&(Ve.hasOnce=!0)}function Fs(e){return e?e.__v_isVNode===!0:!1}function yt(e,t){return e.type===t.type&&e.key===t.key}const Ra=({key:e})=>e??null,sn=({ref:e,ref_key:t,ref_for:s})=>(typeof e=="number"&&(e=""+e),e!=null?xe(e)||Re(e)||Y(e)?{i:Ye,r:e,k:t,f:!!s}:e:null);function zl(e,t=null,s=null,n=0,r=null,i=e===Fe?0:1,o=!1,a=!1){const c={__v_isVNode:!0,__v_skip:!0,type:e,props:t,key:t&&Ra(t),ref:t&&sn(t),scopeId:sa,slotScopeIds:null,children:s,component:null,suspense:null,ssContent:null,ssFallback:null,dirs:null,transition:null,el:null,anchor:null,target:null,targetStart:null,targetAnchor:null,staticCount:0,shapeFlag:i,patchFlag:n,dynamicProps:r,dynamicChildren:null,appContext:null,ctx:Ye};return a?(ni(c,s),i&128&&e.normalize(c)):s&&(c.shapeFlag|=xe(s)?8:16),$n>0&&!o&&Ve&&(c.patchFlag>0||i&6)&&c.patchFlag!==32&&Ve.push(c),c}const ce=Kl;function Kl(e,t=null,s=null,n=0,r=null,i=!1){if((!e||e===cl)&&(e=Tt),Fs(e)){const a=es(e,t,!0);return s&&ni(a,s),$n>0&&!i&&Ve&&(a.shapeFlag&6?Ve[Ve.indexOf(e)]=a:Ve.push(a)),a.patchFlag=-2,a}if(nu(e)&&(e=e.__vccOpts),t){t=ql(t);let{class:a,style:c}=t;a&&!xe(a)&&(t.class=Br(a)),ge(c)&&(Kr(c)&&!X(c)&&(c=be({},c)),t.style=$r(c))}const o=xe(e)?1:wa(e)?128:Jc(e)?64:ge(e)?4:Y(e)?2:0;return zl(e,t,s,n,r,o,i,!0)}function ql(e){return e?Kr(e)||pa(e)?be({},e):e:null}function es(e,t,s=!1,n=!1){const{props:r,ref:i,patchFlag:o,children:a,transition:c}=e,u=t?ri(r||{},t):r,f={__v_isVNode:!0,__v_skip:!0,type:e.type,props:u,key:u&&Ra(u),ref:t&&t.ref?s&&i?X(i)?i.concat(sn(t)):[i,sn(t)]:sn(t):i,scopeId:e.scopeId,slotScopeIds:e.slotScopeIds,children:a,target:e.target,targetStart:e.targetStart,targetAnchor:e.targetAnchor,staticCount:e.staticCount,shapeFlag:e.shapeFlag,patchFlag:t&&e.type!==Fe?o===-1?16:o|16:o,dynamicProps:e.dynamicProps,dynamicChildren:e.dynamicChildren,appContext:e.appContext,dirs:e.dirs,transition:c,component:e.component,suspense:e.suspense,ssContent:e.ssContent&&es(e.ssContent),ssFallback:e.ssFallback&&es(e.ssFallback),placeholder:e.placeholder,el:e.el,anchor:e.anchor,ctx:e.ctx,ce:e.ce};return c&&n&&Gr(f,c.clone(f)),f}function xr(e=" ",t=0){return ce(Fn,null,e,t)}function De(e){return e==null||typeof e=="boolean"?ce(Tt):X(e)?ce(Fe,null,e.slice()):Fs(e)?mt(e):ce(Fn,null,String(e))}function mt(e){return e.el===null&&e.patchFlag!==-1||e.memo?e:es(e)}function ni(e,t){let s=0;const{shapeFlag:n}=e;if(t==null)t=null;else if(X(t))s=16;else if(typeof t=="object")if(n&65){const r=t.default;r&&(r._c&&(r._d=!1),ni(e,r()),r._c&&(r._d=!0));return}else{s=32;const r=t._;!r&&!pa(t)?t._ctx=Ye:r===3&&Ye&&(Ye.slots._===1?t._=1:(t._=2,e.patchFlag|=1024))}else Y(t)?(t={default:t,_ctx:Ye},s=32):(t=String(t),n&64?(s=16,t=[xr(t)]):s=8);e.children=t,e.shapeFlag|=s}function ri(...e){const t={};for(let s=0;sTe||Ye;let mn,wr;{const e=En(),t=(s,n)=>{let r;return(r=e[s])||(r=e[s]=[]),r.push(n),i=>{r.length>1?r.forEach(o=>o(i)):r[0](i)}};mn=t("__VUE_INSTANCE_SETTERS__",s=>Te=s),wr=t("__VUE_SSR_SETTERS__",s=>$s=s)}const zs=e=>{const t=Te;return mn(e),e.scope.on(),()=>{e.scope.off(),mn(t)}},Bi=()=>{Te&&Te.scope.off(),mn(null)};function Ca(e){return e.vnode.shapeFlag&4}let $s=!1;function Ql(e,t=!1,s=!1){t&&wr(t);const{props:n,children:r}=e.vnode,i=Ca(e);kl(e,n,i,t),Ml(e,r,s||t);const o=i?eu(e,t):void 0;return t&&wr(!1),o}function eu(e,t){const s=e.type;e.accessCache=Object.create(null),e.proxy=new Proxy(e.ctx,ll);const{setup:n}=s;if(n){ct();const r=e.setupContext=n.length>1?su(e):null,i=zs(e),o=Zs(n,e,0,[e.props,r]),a=Oo(o);if(lt(),i(),(a||e.sp)&&!Cs(e)&&na(e),a){if(o.then(Bi,Bi),t)return o.then(c=>{Sr(e,c,t)}).catch(c=>{Ws(c,e,0)});e.asyncDep=o}else Sr(e,o,t)}else Pa(e,t)}function Sr(e,t,s){Y(t)?e.type.__ssrInlineRender?e.ssrRender=t:e.render=t:ge(t)&&(e.setupState=Yo(t)),Pa(e,s)}let ji;function Pa(e,t,s){const n=e.type;if(!e.render){if(!t&&ji&&!n.render){const r=n.template||Yr(e).template;if(r){const{isCustomElement:i,compilerOptions:o}=e.appContext.config,{delimiters:a,compilerOptions:c}=n,u=be(be({isCustomElement:i,delimiters:a},o),c);n.render=ji(r,u)}}e.render=n.render||Xe}{const r=zs(e);ct();try{ul(e)}finally{lt(),r()}}}const tu={get(e,t){return Se(e,"get",""),e[t]}};function su(e){const t=s=>{e.exposed=s||{}};return{attrs:new Proxy(e.attrs,tu),slots:e.slots,emit:e.emit,expose:t}}function ii(e){return e.exposed?e.exposeProxy||(e.exposeProxy=new Proxy(Yo(hr(e.exposed)),{get(t,s){if(s in t)return t[s];if(s in Ps)return Ps[s](e)},has(t,s){return s in t||s in Ps}})):e.proxy}function nu(e){return Y(e)&&"__vccOpts"in e}const fe=(e,t)=>Hc(e,t,$s);function j(e,t,s){try{pn(-1);const n=arguments.length;return n===2?ge(t)&&!X(t)?Fs(t)?ce(e,null,[t]):ce(e,t):ce(e,null,t):(n>3?s=Array.prototype.slice.call(arguments,2):n===3&&Fs(s)&&(s=[s]),ce(e,t,s))}finally{pn(1)}}const ru="3.5.25";/** -* @vue/runtime-dom v3.5.25 -* (c) 2018-present Yuxi (Evan) You and Vue contributors -* @license MIT -**/let Rr;const Di=typeof window<"u"&&window.trustedTypes;if(Di)try{Rr=Di.createPolicy("vue",{createHTML:e=>e})}catch{}const ka=Rr?e=>Rr.createHTML(e):e=>e,iu="http://www.w3.org/2000/svg",ou="http://www.w3.org/1998/Math/MathML",it=typeof document<"u"?document:null,Vi=it&&it.createElement("template"),au={insert:(e,t,s)=>{t.insertBefore(e,s||null)},remove:e=>{const t=e.parentNode;t&&t.removeChild(e)},createElement:(e,t,s,n)=>{const r=t==="svg"?it.createElementNS(iu,e):t==="mathml"?it.createElementNS(ou,e):s?it.createElement(e,{is:s}):it.createElement(e);return e==="select"&&n&&n.multiple!=null&&r.setAttribute("multiple",n.multiple),r},createText:e=>it.createTextNode(e),createComment:e=>it.createComment(e),setText:(e,t)=>{e.nodeValue=t},setElementText:(e,t)=>{e.textContent=t},parentNode:e=>e.parentNode,nextSibling:e=>e.nextSibling,querySelector:e=>it.querySelector(e),setScopeId(e,t){e.setAttribute(t,"")},insertStaticContent(e,t,s,n,r,i){const o=s?s.previousSibling:t.lastChild;if(r&&(r===i||r.nextSibling))for(;t.insertBefore(r.cloneNode(!0),s),!(r===i||!(r=r.nextSibling)););else{Vi.innerHTML=ka(n==="svg"?`${e}`:n==="mathml"?`${e}`:e);const a=Vi.content;if(n==="svg"||n==="mathml"){const c=a.firstChild;for(;c.firstChild;)a.appendChild(c.firstChild);a.removeChild(c)}t.insertBefore(a,s)}return[o?o.nextSibling:t.firstChild,s?s.previousSibling:t.lastChild]}},cu=Symbol("_vtc");function lu(e,t,s){const n=e[cu];n&&(t=(t?[t,...n]:[...n]).join(" ")),t==null?e.removeAttribute("class"):s?e.setAttribute("class",t):e.className=t}const Ui=Symbol("_vod"),uu=Symbol("_vsh"),fu=Symbol(""),du=/(?:^|;)\s*display\s*:/;function hu(e,t,s){const n=e.style,r=xe(s);let i=!1;if(s&&!r){if(t)if(xe(t))for(const o of t.split(";")){const a=o.slice(0,o.indexOf(":")).trim();s[a]==null&&nn(n,a,"")}else for(const o in t)s[o]==null&&nn(n,o,"");for(const o in s)o==="display"&&(i=!0),nn(n,o,s[o])}else if(r){if(t!==s){const o=n[fu];o&&(s+=";"+o),n.cssText=s,i=du.test(s)}}else t&&e.removeAttribute("style");Ui in e&&(e[Ui]=i?n.display:"",e[uu]&&(n.display="none"))}const Hi=/\s*!important$/;function nn(e,t,s){if(X(s))s.forEach(n=>nn(e,t,n));else if(s==null&&(s=""),t.startsWith("--"))e.setProperty(t,s);else{const n=pu(e,t);Hi.test(s)?e.setProperty(Zt(n),s.replace(Hi,""),"important"):e[n]=s}}const Zi=["Webkit","Moz","ms"],Jn={};function pu(e,t){const s=Jn[t];if(s)return s;let n=Pt(t);if(n!=="filter"&&n in e)return Jn[t]=n;n=Ao(n);for(let r=0;rYn||(_u.then(()=>Yn=0),Yn=Date.now());function xu(e,t){const s=n=>{if(!n._vts)n._vts=Date.now();else if(n._vts<=s.attached)return;tt(wu(n,s.value),t,5,[n])};return s.value=e,s.attached=bu(),s}function wu(e,t){if(X(t)){const s=e.stopImmediatePropagation;return e.stopImmediatePropagation=()=>{s.call(e),e._stopped=!0},t.map(n=>r=>!r._stopped&&n&&n(r))}else return t}const Ji=e=>e.charCodeAt(0)===111&&e.charCodeAt(1)===110&&e.charCodeAt(2)>96&&e.charCodeAt(2)<123,Su=(e,t,s,n,r,i)=>{const o=r==="svg";t==="class"?lu(e,n,o):t==="style"?hu(e,s,n):In(t)?Ar(t)||vu(e,t,s,n,i):(t[0]==="."?(t=t.slice(1),!0):t[0]==="^"?(t=t.slice(1),!1):Ru(e,t,n,o))?(Ki(e,t,n),!e.tagName.includes("-")&&(t==="value"||t==="checked"||t==="selected")&&zi(e,t,n,o,i,t!=="value")):e._isVueCE&&(/[A-Z]/.test(t)||!xe(n))?Ki(e,Pt(t),n,i,t):(t==="true-value"?e._trueValue=n:t==="false-value"&&(e._falseValue=n),zi(e,t,n,o))};function Ru(e,t,s,n){if(n)return!!(t==="innerHTML"||t==="textContent"||t in e&&Ji(t)&&Y(s));if(t==="spellcheck"||t==="draggable"||t==="translate"||t==="autocorrect"||t==="sandbox"&&e.tagName==="IFRAME"||t==="form"||t==="list"&&e.tagName==="INPUT"||t==="type"&&e.tagName==="TEXTAREA")return!1;if(t==="width"||t==="height"){const r=e.tagName;if(r==="IMG"||r==="VIDEO"||r==="CANVAS"||r==="SOURCE")return!1}return Ji(t)&&xe(s)?!1:t in e}const Cu=be({patchProp:Su},au);let Yi;function Pu(){return Yi||(Yi=Ol(Cu))}const ku=((...e)=>{const t=Pu().createApp(...e),{mount:s}=t;return t.mount=n=>{const r=Iu(n);if(!r)return;const i=t._component;!Y(i)&&!i.render&&!i.template&&(i.template=r.innerHTML),r.nodeType===1&&(r.textContent="");const o=s(r,!1,Tu(r));return r instanceof Element&&(r.removeAttribute("v-cloak"),r.setAttribute("data-v-app","")),o},t});function Tu(e){if(e instanceof SVGElement)return"svg";if(typeof MathMLElement=="function"&&e instanceof MathMLElement)return"mathml"}function Iu(e){return xe(e)?document.querySelector(e):e}const Cr=new WeakMap,Lu=new WeakMap,gn={current:[]};let Xn=!1,Ts=0;const vs=new Set,Xs=new Map;function Ta(e){for(const t of e){if(gn.current.includes(t))continue;gn.current.push(t),t.recompute();const s=Lu.get(t);if(s)for(const n of s){const r=Cr.get(n);r?.length&&Ta(r)}}}function Mu(e){const t={prevVal:e.prevState,currentVal:e.state};for(const s of e.listeners)s(t)}function Eu(e){const t={prevVal:e.prevState,currentVal:e.state};for(const s of e.listeners)s(t)}function Ia(e){if(Ts>0&&!Xs.has(e)&&Xs.set(e,e.prevState),vs.add(e),!(Ts>0)&&!Xn)try{for(Xn=!0;vs.size>0;){const t=Array.from(vs);vs.clear();for(const s of t){const n=Xs.get(s)??s.prevState;s.prevState=n,Mu(s)}for(const s of t){const n=Cr.get(s);n&&(gn.current.push(s),Ta(n))}for(const s of t){const n=Cr.get(s);if(n)for(const r of n)Eu(r)}}}finally{Xn=!1,gn.current=[],Xs.clear()}}function Is(e){Ts++;try{e()}finally{if(Ts--,Ts===0){const t=vs.values().next().value;t&&Ia(t)}}}function Ou(e){return typeof e=="function"}class Au{constructor(t,s){this.listeners=new Set,this.subscribe=n=>{var r,i;this.listeners.add(n);const o=(i=(r=this.options)==null?void 0:r.onSubscribe)==null?void 0:i.call(r,n,this);return()=>{this.listeners.delete(n),o?.()}},this.prevState=t,this.state=t,this.options=s}setState(t){var s,n,r;this.prevState=this.state,(s=this.options)!=null&&s.updateFn?this.state=this.options.updateFn(this.prevState)(t):Ou(t)?this.state=t(this.prevState):this.state=t,(r=(n=this.options)==null?void 0:n.onUpdate)==null||r.call(n),Ia(this)}}const St="__TSR_index",Xi="popstate",Qi="beforeunload";function Nu(e){let t=e.getLocation();const s=new Set,n=o=>{t=e.getLocation(),s.forEach(a=>a({location:t,action:o}))},r=o=>{e.notifyOnIndexChange??!0?n(o):t=e.getLocation()},i=async({task:o,navigateOpts:a,...c})=>{if(a?.ignoreBlocker??!1){o();return}const f=e.getBlockers?.()??[],l=c.type==="PUSH"||c.type==="REPLACE";if(typeof document<"u"&&f.length&&l)for(const d of f){const h=Bs(c.path,c.state);if(await d.blockerFn({currentLocation:t,nextLocation:h,action:c.type})){e.onBlocked?.();return}}o()};return{get location(){return t},get length(){return e.getLength()},subscribers:s,subscribe:o=>(s.add(o),()=>{s.delete(o)}),push:(o,a,c)=>{const u=t.state[St];a=eo(u+1,a),i({task:()=>{e.pushState(o,a),n({type:"PUSH"})},navigateOpts:c,type:"PUSH",path:o,state:a})},replace:(o,a,c)=>{const u=t.state[St];a=eo(u,a),i({task:()=>{e.replaceState(o,a),n({type:"REPLACE"})},navigateOpts:c,type:"REPLACE",path:o,state:a})},go:(o,a)=>{i({task:()=>{e.go(o),r({type:"GO",index:o})},navigateOpts:a,type:"GO"})},back:o=>{i({task:()=>{e.back(o?.ignoreBlocker??!1),r({type:"BACK"})},navigateOpts:o,type:"BACK"})},forward:o=>{i({task:()=>{e.forward(o?.ignoreBlocker??!1),r({type:"FORWARD"})},navigateOpts:o,type:"FORWARD"})},canGoBack:()=>t.state[St]!==0,createHref:o=>e.createHref(o),block:o=>{if(!e.setBlockers)return()=>{};const a=e.getBlockers?.()??[];return e.setBlockers([...a,o]),()=>{const c=e.getBlockers?.()??[];e.setBlockers?.(c.filter(u=>u!==o))}},flush:()=>e.flush?.(),destroy:()=>e.destroy?.(),notify:n}}function eo(e,t){t||(t={});const s=oi();return{...t,key:s,__TSR_key:s,[St]:e}}function La(e){const t=e?.window??(typeof document<"u"?window:void 0),s=t.history.pushState,n=t.history.replaceState;let r=[];const i=()=>r,o=M=>r=M,a=e?.createHref??(M=>M),c=e?.parseLocation??(()=>Bs(`${t.location.pathname}${t.location.search}${t.location.hash}`,t.history.state));if(!t.history.state?.__TSR_key&&!t.history.state?.key){const M=oi();t.history.replaceState({[St]:0,key:M,__TSR_key:M},"")}let u=c(),f,l=!1,d=!1,h=!1,g=!1;const y=()=>u;let x,b;const L=()=>{x&&(D._ignoreSubscribers=!0,(x.isPush?t.history.pushState:t.history.replaceState)(x.state,"",x.href),D._ignoreSubscribers=!1,x=void 0,b=void 0,f=void 0)},$=(M,B,W)=>{const J=a(B);b||(f=u),u=Bs(B,W),x={href:J,state:W,isPush:x?.isPush||M==="push"},b||(b=Promise.resolve().then(()=>L()))},C=M=>{u=c(),D.notify({type:M})},k=async()=>{if(d){d=!1;return}const M=c(),B=M.state[St]-u.state[St],W=B===1,J=B===-1,de=!W&&!J||l;l=!1;const P=de?"GO":J?"BACK":"FORWARD",H=de?{type:"GO",index:B}:{type:J?"BACK":"FORWARD"};if(h)h=!1;else{const te=i();if(typeof document<"u"&&te.length){for(const Q of te)if(await Q.blockerFn({currentLocation:u,nextLocation:M,action:P})){d=!0,t.history.go(1),D.notify(H);return}}}u=c(),D.notify(H)},_=M=>{if(g){g=!1;return}let B=!1;const W=i();if(typeof document<"u"&&W.length)for(const J of W){const de=J.enableBeforeUnload??!0;if(de===!0){B=!0;break}if(typeof de=="function"&&de()===!0){B=!0;break}}if(B)return M.preventDefault(),M.returnValue=""},D=Nu({getLocation:y,getLength:()=>t.history.length,pushState:(M,B)=>$("push",M,B),replaceState:(M,B)=>$("replace",M,B),back:M=>(M&&(h=!0),g=!0,t.history.back()),forward:M=>{M&&(h=!0),g=!0,t.history.forward()},go:M=>{l=!0,t.history.go(M)},createHref:M=>a(M),flush:L,destroy:()=>{t.history.pushState=s,t.history.replaceState=n,t.removeEventListener(Qi,_,{capture:!0}),t.removeEventListener(Xi,k)},onBlocked:()=>{f&&u!==f&&(u=f)},getBlockers:i,setBlockers:o,notifyOnIndexChange:!1});return t.addEventListener(Qi,_,{capture:!0}),t.addEventListener(Xi,k),t.history.pushState=function(...M){const B=s.apply(t.history,M);return D._ignoreSubscribers||C("PUSH"),B},t.history.replaceState=function(...M){const B=n.apply(t.history,M);return D._ignoreSubscribers||C("REPLACE"),B},D}function Fu(e){const t=typeof document<"u"?window:void 0;return La({window:t,parseLocation:()=>{const s=t.location.hash.split("#").slice(1),n=s[0]??"/",r=t.location.search,i=s.slice(1),o=i.length===0?"":`#${i.join("#")}`,a=`${n}${r}${o}`;return Bs(a,t.history.state)},createHref:s=>`${t.location.pathname}${t.location.search}#${s}`})}function Bs(e,t){const s=e.indexOf("#"),n=e.indexOf("?"),r=oi();return{href:e,pathname:e.substring(0,s>0?n>0?Math.min(s,n):s:n>0?n:e.length),hash:s>-1?e.substring(s):"",search:n>-1?e.slice(n,s===-1?void 0:s):"",state:t||{[St]:0,key:r,__TSR_key:r}}}function oi(){return(Math.random()+1).toString(36).substring(7)}function vn(e){return e[e.length-1]}function $u(e){return typeof e=="function"}function Gt(e,t){return $u(e)?e(t):e}const Bu=Object.prototype.hasOwnProperty;function je(e,t){if(e===t)return e;const s=t,n=no(e)&&no(s);if(!n&&!(yn(e)&&yn(s)))return s;const r=n?e:to(e);if(!r)return s;const i=n?s:to(s);if(!i)return s;const o=r.length,a=i.length,c=n?new Array(a):{};let u=0;for(let f=0;f"u")return!0;const s=t.prototype;return!(!so(s)||!s.hasOwnProperty("isPrototypeOf"))}function so(e){return Object.prototype.toString.call(e)==="[object Object]"}function no(e){return Array.isArray(e)&&e.length===Object.keys(e).length}function $t(e,t,s){if(e===t)return!0;if(typeof e!=typeof t)return!1;if(Array.isArray(e)&&Array.isArray(t)){if(e.length!==t.length)return!1;for(let n=0,r=e.length;nr||!$t(e[o],t[o],s)))return!1;return r===i}return!1}function ts(e){let t,s;const n=new Promise((r,i)=>{t=r,s=i});return n.status="pending",n.resolve=r=>{n.status="resolved",n.value=r,t(r),e?.(r)},n.reject=r=>{n.status="rejected",s(r)},n}function Rt(e){return!!(e&&typeof e=="object"&&typeof e.then=="function")}function ro(e){try{return decodeURI(e)}catch{return e.replaceAll(/%[0-9A-F]{2}/gi,t=>{try{return decodeURI(t)}catch{return t}})}}function io(e,t){if(!e)return e;const s=/%25|%5C/gi;let n=0,r="",i;for(;(i=s.exec(e))!==null;)r+=ro(e.slice(n,i.index))+i[0],n=s.lastIndex;return r+ro(n?e.slice(n):e)}var ju="Invariant failed";function Dt(e,t){if(!e)throw new Error(ju)}function _n(e){const t=new Map;let s,n;const r=i=>{i.next&&(i.prev?(i.prev.next=i.next,i.next.prev=i.prev,i.next=void 0,n&&(n.next=i,i.prev=n)):(i.next.prev=void 0,s=i.next,i.next=void 0,n&&(i.prev=n,n.next=i)),n=i)};return{get(i){const o=t.get(i);if(o)return r(o),o.value},set(i,o){if(t.size>=e&&s){const c=s;t.delete(c.key),c.next&&(s=c.next,c.next.prev=void 0),c===n&&(n=void 0)}const a=t.get(i);if(a)a.value=o,r(a);else{const c={key:i,value:o,prev:n};n&&(n.next=c),n=c,s||(s=c),t.set(i,c)}},clear(){t.clear(),s=void 0,n=void 0}}}const ss=0,Vt=1,Ut=2,js=3,Du=/^([^{]*)\{\$([a-zA-Z_$][a-zA-Z0-9_$]*)\}([^}]*)$/,Vu=/^([^{]*)\{-\$([a-zA-Z_$][a-zA-Z0-9_$]*)\}([^}]*)$/,Uu=/^([^{]*)\{\$\}([^}]*)$/;function ai(e,t,s=new Uint16Array(6)){const n=e.indexOf("/",t),r=n===-1?e.length:n,i=e.substring(t,r);if(!i||!i.includes("$"))return s[0]=ss,s[1]=t,s[2]=t,s[3]=r,s[4]=r,s[5]=r,s;if(i==="$"){const u=e.length;return s[0]=Ut,s[1]=t,s[2]=t,s[3]=u,s[4]=u,s[5]=u,s}if(i.charCodeAt(0)===36)return s[0]=Vt,s[1]=t,s[2]=t+1,s[3]=r,s[4]=r,s[5]=r,s;const o=i.match(Uu);if(o){const f=o[1].length;return s[0]=Ut,s[1]=t+f,s[2]=t+f+1,s[3]=t+f+2,s[4]=t+f+3,s[5]=e.length,s}const a=i.match(Vu);if(a){const u=a[1],f=a[2],l=a[3],d=u.length;return s[0]=js,s[1]=t+d,s[2]=t+d+3,s[3]=t+d+3+f.length,s[4]=r-l.length,s[5]=r,s}const c=i.match(Du);if(c){const u=c[1],f=c[2],l=c[3],d=u.length;return s[0]=Vt,s[1]=t+d,s[2]=t+d+2,s[3]=t+d+2+f.length,s[4]=r-l.length,s[5]=r,s}return s[0]=ss,s[1]=t,s[2]=t,s[3]=r,s[4]=r,s[5]=r,s}function Bn(e,t,s,n,r,i,o){o?.(s);let a=n;{const c=s.fullPath??s.from,u=c.length,f=s.options?.caseSensitive??e;for(;a_.caseSensitive===L&&_.prefix===$&&_.suffix===C);if(k)d=k;else{const _=er(Vt,s.fullPath??s.from,L,$,C);d=_,_.depth=i,_.parent=r,r.dynamic??=[],r.dynamic.push(_)}break}case js:{const x=c.substring(h,l[1]),b=c.substring(l[4],g),L=f&&!!(x||b),$=x?L?x:x.toLowerCase():void 0,C=b?L?b:b.toLowerCase():void 0,k=r.optional?.find(_=>_.caseSensitive===L&&_.prefix===$&&_.suffix===C);if(k)d=k;else{const _=er(js,s.fullPath??s.from,L,$,C);d=_,_.parent=r,_.depth=i,r.optional??=[],r.optional.push(_)}break}case Ut:{const x=c.substring(h,l[1]),b=c.substring(l[4],g),L=f&&!!(x||b),$=x?L?x:x.toLowerCase():void 0,C=b?L?b:b.toLowerCase():void 0,k=er(Ut,s.fullPath??s.from,L,$,C);d=k,k.parent=r,k.depth=i,r.wildcard??=[],r.wildcard.push(k)}}r=d}if((s.path||!s.children)&&!s.isRoot){const l=c.endsWith("/");l||(r.notFound=s),(!r.route||!r.isIndex&&l)&&(r.route=s,r.fullPath=s.fullPath??s.from),r.isIndex||=l}}if(s.children)for(const c of s.children)Bn(e,t,c,a,r,i,o)}function Qn(e,t){if(e.prefix&&t.prefix&&e.prefix!==t.prefix){if(e.prefix.startsWith(t.prefix))return-1;if(t.prefix.startsWith(e.prefix))return 1}if(e.suffix&&t.suffix&&e.suffix!==t.suffix){if(e.suffix.endsWith(t.suffix))return-1;if(t.suffix.endsWith(e.suffix))return 1}return e.prefix&&!t.prefix?-1:!e.prefix&&t.prefix?1:e.suffix&&!t.suffix?-1:!e.suffix&&t.suffix?1:e.caseSensitive&&!t.caseSensitive?-1:!e.caseSensitive&&t.caseSensitive?1:0}function Nt(e){if(e.static)for(const t of e.static.values())Nt(t);if(e.staticInsensitive)for(const t of e.staticInsensitive.values())Nt(t);if(e.dynamic?.length){e.dynamic.sort(Qn);for(const t of e.dynamic)Nt(t)}if(e.optional?.length){e.optional.sort(Qn);for(const t of e.optional)Nt(t)}if(e.wildcard?.length){e.wildcard.sort(Qn);for(const t of e.wildcard)Nt(t)}}function Ds(e){return{kind:ss,depth:0,static:null,staticInsensitive:null,dynamic:null,optional:null,wildcard:null,route:null,fullPath:e,parent:null,isIndex:!1,notFound:null}}function er(e,t,s,n,r){return{kind:e,depth:0,static:null,staticInsensitive:null,dynamic:null,optional:null,wildcard:null,route:null,fullPath:t,parent:null,isIndex:!1,notFound:null,caseSensitive:s,prefix:n,suffix:r}}function Hu(e,t){const s=Ds("/"),n=new Uint16Array(6);for(const r of e)Bn(!1,n,r,1,s,0);Nt(s),t.masksTree=s,t.flatCache=_n(1e3)}function Zu(e,t){e||="/";const s=t.flatCache.get(e);if(s)return s;const n=ci(e,t.masksTree);return t.flatCache.set(e,n),n}function Wu(e,t,s,n,r){e||="/",n||="/";const i=t?`case\0${e}`:e;let o=r.singleCache.get(i);if(!o){o=Ds("/");const a=new Uint16Array(6);Bn(t,a,{from:e},1,o,0),r.singleCache.set(i,o)}return ci(n,o,s)}function zu(e,t,s=!1){const n=s?e:`nofuzz\0${e}`,r=t.matchCache.get(n);if(r!==void 0)return r;e||="/";const i=ci(e,t.segmentTree,s);return i&&(i.branch=Ju(i.route)),t.matchCache.set(n,i),i}function Ku(e){return e==="/"?e:e.replace(/\/{1,}$/,"")}function qu(e,t=!1,s){const n=Ds(e.fullPath),r=new Uint16Array(6),i={},o={};let a=0;return Bn(t,r,e,1,n,0,u=>{if(s?.(u,a),Dt(!(u.id in i),`Duplicate routes found with id: ${String(u.id)}`),i[u.id]=u,a!==0&&u.path){const f=Ku(u.fullPath);(!o[f]||u.fullPath.endsWith("/"))&&(o[f]=u)}a++}),Nt(n),{processedTree:{segmentTree:n,singleCache:_n(1e3),matchCache:_n(1e3),flatCache:null,masksTree:null},routesById:i,routesByPath:o}}function ci(e,t,s=!1){const n=e.split("/"),r=Xu(e,n,t,s);if(!r)return null;const i=Gu(e,n,r),o="**"in r;return o&&(i["**"]=r["**"]),{route:o?r.node.notFound??r.node.route:r.node.route,params:i}}function Gu(e,t,s){const n=Yu(s.node);let r=null;const i={};for(let o=0,a=0,c=0;a=0;M--){const B=d.optional[M];a.push({node:B,index:h,skipped:_,depth:D,statics:x,dynamics:b,optionals:L})}if(!$)for(let M=d.optional.length-1;M>=0;M--){const B=d.optional[M],{prefix:W,suffix:J}=B;if(W||J){const de=B.caseSensitive?C:k??=C.toLowerCase();if(W&&!de.startsWith(W)||J&&!de.endsWith(J))continue}a.push({node:B,index:h+1,skipped:g,depth:D,statics:x,dynamics:b,optionals:L+1})}}if(!$&&d.dynamic&&C)for(let _=d.dynamic.length-1;_>=0;_--){const D=d.dynamic[_],{prefix:M,suffix:B}=D;if(M||B){const W=D.caseSensitive?C:k??=C.toLowerCase();if(M&&!W.startsWith(M)||B&&!W.endsWith(B))continue}a.push({node:D,index:h+1,skipped:g,depth:y+1,statics:x,dynamics:b+1,optionals:L})}if(!$&&d.staticInsensitive){const _=d.staticInsensitive.get(k??=C.toLowerCase());_&&a.push({node:_,index:h+1,skipped:g,depth:y+1,statics:x+1,dynamics:b,optionals:L})}if(!$&&d.static){const _=d.static.get(C);_&&a.push({node:_,index:h+1,skipped:g,depth:y+1,statics:x+1,dynamics:b,optionals:L})}}if(f&&c)return Qs(c,f)?f:c;if(f)return f;if(c)return c;if(n&&u){let l=u.index;for(let h=0;he.statics||t.statics===e.statics&&(t.dynamics>e.dynamics||t.dynamics===e.dynamics&&(t.optionals>e.optionals||t.optionals===e.optionals&&(t.node.isIndex>e.node.isIndex||t.node.isIndex===e.node.isIndex&&t.depth>e.depth))):!0}function rn(e){return li(e.filter(t=>t!==void 0).join("/"))}function li(e){return e.replace(/\/{2,}/g,"/")}function Ma(e){return e==="/"?e:e.replace(/^\/{1,}/,"")}function Bt(e){const t=e.length;return t>1&&e[t-1]==="/"?e.replace(/\/{1,}$/,""):e}function Ea(e){return Bt(Ma(e))}function bn(e,t){return e?.endsWith("/")&&e!=="/"&&e!==`${t}/`?e.slice(0,-1):e}function Qu(e,t,s){return bn(e,s)===bn(t,s)}function ef({base:e,to:t,trailingSlash:s="never",cache:n}){const r=t.startsWith("/"),i=!r&&t===".";let o;if(n){o=r?t:i?e:e+"\0"+t;const l=n.get(o);if(l)return l}let a;if(i)a=e.split("/");else if(r)a=t.split("/");else{for(a=e.split("/");a.length>1&&vn(a)==="";)a.pop();const l=t.split("/");for(let d=0,h=l.length;d1&&(vn(a)===""?s==="never"&&a.pop():s==="always"&&a.push(""));let c,u="";for(let l=0;l0&&(u+="/");const d=a[l];if(!d)continue;c=ai(d,0,c);const h=c[0];if(h===ss){u+=d;continue}const g=c[5],y=d.substring(0,c[1]),x=d.substring(c[4],g),b=d.substring(c[2],c[3]);h===Vt?u+=y||x?`${y}{$${b}}${x}`:`$${b}`:h===Ut?u+=y||x?`${y}{$}${x}`:"$":u+=`${y}{-$${b}}${x}`}u=li(u);const f=u||"/";return o&&n&&n.set(o,f),f}function tr(e,t,s){const n=t[e];return typeof n!="string"?n:e==="_splat"?encodeURI(n):tf(n,s)}function sr({path:e,params:t,decodeCharMap:s}){let n=!1;const r={};if(!e||e==="/")return{interpolatedPath:"/",usedParams:r,isMissingParams:n};if(!e.includes("$"))return{interpolatedPath:e,usedParams:r,isMissingParams:n};const i=e.length;let o=0,a,c="";for(;o{let s;return(...n)=>{s||(s=setTimeout(()=>{e(...n),s=null},t))}};function rf(){const e=sf();if(!e)return null;const t=e.getItem(xn);let s=t?JSON.parse(t):{};return{state:s,set:n=>(s=Gt(n,s)||s,e.setItem(xn,JSON.stringify(s)))}}const en=rf(),Pr=e=>e.state.__TSR_key||e.href;function of(e){const t=[];let s;for(;s=e.parentNode;)t.push(`${e.tagName}:nth-child(${Array.prototype.indexOf.call(s.children,e)+1})`),e=s;return`${t.reverse().join(" > ")}`.toLowerCase()}let wn=!1;function Oa({storageKey:e,key:t,behavior:s,shouldScrollRestoration:n,scrollToTopSelectors:r,location:i}){let o;try{o=JSON.parse(sessionStorage.getItem(e)||"{}")}catch(u){console.error(u);return}const a=t||window.history.state?.__TSR_key,c=o[a];wn=!0;e:{if(n&&c&&Object.keys(c).length>0){for(const l in c){const d=c[l];if(l==="window")window.scrollTo({top:d.scrollY,left:d.scrollX,behavior:s});else if(l){const h=document.querySelector(l);h&&(h.scrollLeft=d.scrollX,h.scrollTop=d.scrollY)}}break e}const u=(i??window.location).hash.split("#",2)[1];if(u){const l=window.history.state?.__hashScrollIntoViewOptions??!0;if(l){const d=document.getElementById(u);d&&d.scrollIntoView(l)}break e}const f={top:0,left:0,behavior:s};if(window.scrollTo(f),r)for(const l of r){if(l==="window")continue;const d=typeof l=="function"?l():document.querySelector(l);d&&d.scrollTo(f)}}wn=!1}function af(e,t){if(!en&&!e.isServer||((e.options.scrollRestoration??!1)&&(e.isScrollRestoring=!0),e.isServer||e.isScrollRestorationSetup||!en))return;e.isScrollRestorationSetup=!0,wn=!1;const n=e.options.getScrollRestorationKey||Pr;window.history.scrollRestoration="manual";const r=i=>{if(wn||!e.isScrollRestoring)return;let o="";if(i.target===document||i.target===window)o="window";else{const c=i.target.getAttribute("data-scroll-restoration-id");c?o=`[data-scroll-restoration-id="${c}"]`:o=of(i.target)}const a=n(e.state.location);en.set(c=>{const u=c[a]||={},f=u[o]||={};if(o==="window")f.scrollX=window.scrollX||0,f.scrollY=window.scrollY||0;else if(o){const l=document.querySelector(o);l&&(f.scrollX=l.scrollLeft||0,f.scrollY=l.scrollTop||0)}return c})};typeof document<"u"&&document.addEventListener("scroll",nf(r,100),!0),e.subscribe("onRendered",i=>{const o=n(i.toLocation);if(!e.resetNextScroll){e.resetNextScroll=!0;return}typeof e.options.scrollRestoration=="function"&&!e.options.scrollRestoration({location:e.latestLocation})||(Oa({storageKey:xn,key:o,behavior:e.options.scrollRestorationBehavior,shouldScrollRestoration:e.isScrollRestoring,scrollToTopSelectors:e.options.scrollToTopSelectors,location:e.history.location}),e.isScrollRestoring&&en.set(a=>(a[o]||={},a)))})}function cf(e){if(typeof document<"u"&&document.querySelector){const t=e.state.location.state.__hashScrollIntoViewOptions??!0;if(t&&e.state.location.hash!==""){const s=document.getElementById(e.state.location.hash);s&&s.scrollIntoView(t)}}}function lf(e,t=String){const s=new URLSearchParams;for(const n in e){const r=e[n];r!==void 0&&s.set(n,t(r))}return s.toString()}function nr(e){return e?e==="false"?!1:e==="true"?!0:+e*0===0&&+e+""===e?+e:e:""}function uf(e){const t=new URLSearchParams(e),s={};for(const[n,r]of t.entries()){const i=s[n];i==null?s[n]=nr(r):Array.isArray(i)?i.push(nr(r)):s[n]=[i,nr(r)]}return s}const ff=hf(JSON.parse),df=pf(JSON.stringify,JSON.parse);function hf(e){return t=>{t[0]==="?"&&(t=t.substring(1));const s=uf(t);for(const n in s){const r=s[n];if(typeof r=="string")try{s[n]=e(r)}catch{}}return s}}function pf(e,t){const s=typeof t=="function";function n(r){if(typeof r=="object"&&r!==null)try{return e(r)}catch{}else if(s&&typeof r=="string")try{return t(r),e(r)}catch{}return r}return r=>{const i=lf(r,n);return i?`?${i}`:""}}const Ne="__root__";function mf(e){if(e.statusCode=e.statusCode||e.code||307,!e.reloadDocument&&typeof e.href=="string")try{new URL(e.href),e.reloadDocument=!0}catch{}const t=new Headers(e.headers);e.href&&t.get("Location")===null&&t.set("Location",e.href);const s=new Response(null,{status:e.statusCode,headers:t});if(s.options=e,e.throw)throw s;return s}function Ue(e){return e instanceof Response&&!!e.options}const on=e=>{if(!e.rendered)return e.rendered=!0,e.onReady?.()},jn=(e,t)=>!!(e.preload&&!e.router.state.matches.some(s=>s.id===t)),ui=(e,t,s=!0)=>{const n={...e.router.options.context??{}},r=s?t:t-1;for(let i=0;i<=r;i++){const o=e.matches[i];if(!o)continue;const a=e.router.getMatch(o.id);a&&Object.assign(n,a.__routeContext,a.__beforeLoadContext)}return n},Aa=(e,t)=>{const s=e.router.routesById[t.routeId??""]??e.router.routeTree;!s.options.notFoundComponent&&e.router.options?.defaultNotFoundComponent&&(s.options.notFoundComponent=e.router.options.defaultNotFoundComponent),Dt(s.options.notFoundComponent);const n=e.matches.find(r=>r.routeId===s.id);Dt(n,"Could not find match for route: "+s.id),e.updateMatch(n.id,r=>({...r,status:"notFound",error:t,isFetching:!1})),t.routerCode==="BEFORE_LOAD"&&s.parentRoute&&(t.routeId=s.parentRoute.id,Aa(e,t))},_t=(e,t,s)=>{if(!(!Ue(s)&&!$e(s))){if(Ue(s)&&s.redirectHandled&&!s.options.reloadDocument)throw s;if(t){t._nonReactive.beforeLoadPromise?.resolve(),t._nonReactive.loaderPromise?.resolve(),t._nonReactive.beforeLoadPromise=void 0,t._nonReactive.loaderPromise=void 0;const n=Ue(s)?"redirected":"notFound";t._nonReactive.error=s,e.updateMatch(t.id,r=>({...r,status:n,isFetching:!1,error:s})),$e(s)&&!s.routeId&&(s.routeId=t.routeId),t._nonReactive.loadPromise?.resolve()}throw Ue(s)?(e.rendered=!0,s.options._fromLocation=e.location,s.redirectHandled=!0,s=e.router.resolveRedirect(s),s):(Aa(e,s),s)}},Na=(e,t)=>{const s=e.router.getMatch(t);return!!(!e.router.isServer&&s._nonReactive.dehydrated||e.router.isServer&&s.ssr===!1)},ps=(e,t,s,n)=>{const{id:r,routeId:i}=e.matches[t],o=e.router.looseRoutesById[i];if(s instanceof Promise)throw s;s.routerCode=n,e.firstBadMatchIndex??=t,_t(e,e.router.getMatch(r),s);try{o.options.onError?.(s)}catch(a){s=a,_t(e,e.router.getMatch(r),s)}e.updateMatch(r,a=>(a._nonReactive.beforeLoadPromise?.resolve(),a._nonReactive.beforeLoadPromise=void 0,a._nonReactive.loadPromise?.resolve(),{...a,error:s,status:"error",isFetching:!1,updatedAt:Date.now(),abortController:new AbortController}))},gf=(e,t,s,n)=>{const r=e.router.getMatch(t),i=e.matches[s-1]?.id,o=i?e.router.getMatch(i):void 0;if(e.router.isShell()){r.ssr=n.id===Ne;return}if(o?.ssr===!1){r.ssr=!1;return}const a=h=>h===!0&&o?.ssr==="data-only"?"data-only":h,c=e.router.options.defaultSsr??!0;if(n.options.ssr===void 0){r.ssr=a(c);return}if(typeof n.options.ssr!="function"){r.ssr=a(n.options.ssr);return}const{search:u,params:f}=r,l={search:tn(u,r.searchError),params:tn(f,r.paramsError),location:e.location,matches:e.matches.map(h=>({index:h.index,pathname:h.pathname,fullPath:h.fullPath,staticData:h.staticData,id:h.id,routeId:h.routeId,search:tn(h.search,h.searchError),params:tn(h.params,h.paramsError),ssr:h.ssr}))},d=n.options.ssr(l);if(Rt(d))return d.then(h=>{r.ssr=a(h??c)});r.ssr=a(d??c)},Fa=(e,t,s,n)=>{if(n._nonReactive.pendingTimeout!==void 0)return;const r=s.options.pendingMs??e.router.options.defaultPendingMs;if(!!(e.onReady&&!e.router.isServer&&!jn(e,t)&&(s.options.loader||s.options.beforeLoad||ja(s))&&typeof r=="number"&&r!==1/0&&(s.options.pendingComponent??e.router.options?.defaultPendingComponent))){const o=setTimeout(()=>{on(e)},r);n._nonReactive.pendingTimeout=o}},vf=(e,t,s)=>{const n=e.router.getMatch(t);if(!n._nonReactive.beforeLoadPromise&&!n._nonReactive.loaderPromise)return;Fa(e,t,s,n);const r=()=>{const i=e.router.getMatch(t);i.preload&&(i.status==="redirected"||i.status==="notFound")&&_t(e,i,i.error)};return n._nonReactive.beforeLoadPromise?n._nonReactive.beforeLoadPromise.then(r):r()},yf=(e,t,s,n)=>{const r=e.router.getMatch(t),i=r._nonReactive.loadPromise;r._nonReactive.loadPromise=ts(()=>{i?.resolve()});const{paramsError:o,searchError:a}=r;o&&ps(e,s,o,"PARSE_PARAMS"),a&&ps(e,s,a,"VALIDATE_SEARCH"),Fa(e,t,n,r);const c=new AbortController,u=e.matches[s-1]?.id;(u?e.router.getMatch(u):void 0)?.context??e.router.options.context;let l=!1;const d=()=>{l||(l=!0,e.updateMatch(t,_=>({..._,isFetching:"beforeLoad",fetchCount:_.fetchCount+1,abortController:c})))},h=()=>{r._nonReactive.beforeLoadPromise?.resolve(),r._nonReactive.beforeLoadPromise=void 0,e.updateMatch(t,_=>({..._,isFetching:!1}))};if(!n.options.beforeLoad){Is(()=>{d(),h()});return}r._nonReactive.beforeLoadPromise=ts();const g={...ui(e,s,!1),...r.__routeContext},{search:y,params:x,cause:b}=r,L=jn(e,t),$={search:y,abortController:c,params:x,preload:L,context:g,location:e.location,navigate:_=>e.router.navigate({..._,_fromLocation:e.location}),buildLocation:e.router.buildLocation,cause:L?"preload":b,matches:e.matches,...e.router.options.additionalContext},C=_=>{if(_===void 0){Is(()=>{d(),h()});return}(Ue(_)||$e(_))&&(d(),ps(e,s,_,"BEFORE_LOAD")),Is(()=>{d(),e.updateMatch(t,D=>({...D,__beforeLoadContext:_})),h()})};let k;try{if(k=n.options.beforeLoad($),Rt(k))return d(),k.catch(_=>{ps(e,s,_,"BEFORE_LOAD")}).then(C)}catch(_){d(),ps(e,s,_,"BEFORE_LOAD")}C(k)},_f=(e,t)=>{const{id:s,routeId:n}=e.matches[t],r=e.router.looseRoutesById[n],i=()=>{if(e.router.isServer){const c=gf(e,s,t,r);if(Rt(c))return c.then(a)}return a()},o=()=>yf(e,s,t,r),a=()=>{if(Na(e,s))return;const c=vf(e,s,r);return Rt(c)?c.then(o):o()};return i()},Ls=(e,t,s)=>{const n=e.router.getMatch(t);if(!n||!s.options.head&&!s.options.scripts&&!s.options.headers)return;const r={matches:e.matches,match:n,params:n.params,loaderData:n.loaderData};return Promise.all([s.options.head?.(r),s.options.scripts?.(r),s.options.headers?.(r)]).then(([i,o,a])=>{const c=i?.meta,u=i?.links,f=i?.scripts,l=i?.styles;return{meta:c,links:u,headScripts:f,headers:a,scripts:o,styles:l}})},$a=(e,t,s,n)=>{const r=e.matchPromises[s-1],{params:i,loaderDeps:o,abortController:a,cause:c}=e.router.getMatch(t),u=ui(e,s),f=jn(e,t);return{params:i,deps:o,preload:!!f,parentMatchPromise:r,abortController:a,context:u,location:e.location,navigate:l=>e.router.navigate({...l,_fromLocation:e.location}),cause:f?"preload":c,route:n,...e.router.options.additionalContext}},oo=async(e,t,s,n)=>{try{const r=e.router.getMatch(t);try{(!e.router.isServer||r.ssr===!0)&&Ba(n);const i=n.options.loader?.($a(e,t,s,n)),o=n.options.loader&&Rt(i);if(!!(o||n._lazyPromise||n._componentsPromise||n.options.head||n.options.scripts||n.options.headers||r._nonReactive.minPendingPromise)&&e.updateMatch(t,l=>({...l,isFetching:"loader"})),n.options.loader){const l=o?await i:i;_t(e,e.router.getMatch(t),l),l!==void 0&&e.updateMatch(t,d=>({...d,loaderData:l}))}n._lazyPromise&&await n._lazyPromise;const c=Ls(e,t,n),u=c?await c:void 0,f=r._nonReactive.minPendingPromise;f&&await f,n._componentsPromise&&await n._componentsPromise,e.updateMatch(t,l=>({...l,error:void 0,status:"success",isFetching:!1,updatedAt:Date.now(),...u}))}catch(i){let o=i;const a=r._nonReactive.minPendingPromise;a&&await a,$e(i)&&await n.options.notFoundComponent?.preload?.(),_t(e,e.router.getMatch(t),i);try{n.options.onError?.(i)}catch(f){o=f,_t(e,e.router.getMatch(t),f)}const c=Ls(e,t,n),u=c?await c:void 0;e.updateMatch(t,f=>({...f,error:o,status:"error",isFetching:!1,...u}))}}catch(r){const i=e.router.getMatch(t);if(i){const o=Ls(e,t,n);if(o){const a=await o;e.updateMatch(t,c=>({...c,...a}))}i._nonReactive.loaderPromise=void 0}_t(e,i,r)}},bf=async(e,t)=>{const{id:s,routeId:n}=e.matches[t];let r=!1,i=!1;const o=e.router.looseRoutesById[n],a=()=>{e.updateMatch(s,f=>({...f,context:ui(e,t)}))};if(Na(e,s)){if(e.router.isServer){const f=Ls(e,s,o);if(f){const l=await f;e.updateMatch(s,d=>({...d,...l}))}return e.router.getMatch(s)}}else{const f=e.router.getMatch(s);if(f._nonReactive.loaderPromise){if(f.status==="success"&&!e.sync&&!f.preload)return f;await f._nonReactive.loaderPromise;const l=e.router.getMatch(s),d=l._nonReactive.error||l.error;d&&_t(e,l,d)}else{const l=Date.now()-f.updatedAt,d=jn(e,s),h=d?o.options.preloadStaleTime??e.router.options.defaultPreloadStaleTime??3e4:o.options.staleTime??e.router.options.defaultStaleTime??0,g=o.options.shouldReload,y=typeof g=="function"?g($a(e,s,t,o)):g,x=!!d&&!e.router.state.matches.some(C=>C.id===s),b=e.router.getMatch(s);b._nonReactive.loaderPromise=ts(),x!==b.preload&&e.updateMatch(s,C=>({...C,preload:x}));const{status:L,invalid:$}=b;if(r=L==="success"&&($||(y??l>h)),!(d&&o.options.preload===!1))if(r&&!e.sync)i=!0,(async()=>{try{await oo(e,s,t,o),a();const C=e.router.getMatch(s);C._nonReactive.loaderPromise?.resolve(),C._nonReactive.loadPromise?.resolve(),C._nonReactive.loaderPromise=void 0}catch(C){Ue(C)&&await e.router.navigate(C.options)}})();else if(L!=="success"||r&&e.sync)await oo(e,s,t,o);else{const C=Ls(e,s,o);if(C){const k=await C;e.updateMatch(s,_=>({..._,...k}))}}}}const c=e.router.getMatch(s);i||(c._nonReactive.loaderPromise?.resolve(),c._nonReactive.loadPromise?.resolve()),clearTimeout(c._nonReactive.pendingTimeout),c._nonReactive.pendingTimeout=void 0,i||(c._nonReactive.loaderPromise=void 0),c._nonReactive.dehydrated=void 0,i||a();const u=i?c.isFetching:!1;return u!==c.isFetching||c.invalid!==!1?(e.updateMatch(s,f=>({...f,isFetching:u,invalid:!1})),e.router.getMatch(s)):c};async function ao(e){const t=Object.assign(e,{matchPromises:[]});!t.router.isServer&&t.router.state.matches.some(s=>s._forcePending)&&on(t);try{for(let r=0;r{const{id:s,...n}=t.options;Object.assign(e.options,n),e._lazyLoaded=!0,e._lazyPromise=void 0}):e._lazyLoaded=!0),!e._componentsLoaded&&e._componentsPromise===void 0){const t=()=>{const s=[];for(const n of Da){const r=e.options[n]?.preload;r&&s.push(r())}if(s.length)return Promise.all(s).then(()=>{e._componentsLoaded=!0,e._componentsPromise=void 0});e._componentsLoaded=!0,e._componentsPromise=void 0};e._componentsPromise=e._lazyPromise?e._lazyPromise.then(t):t()}return e._componentsPromise}function tn(e,t){return t?{status:"error",error:t}:{status:"success",value:e}}function ja(e){for(const t of Da)if(e.options[t]?.preload)return!0;return!1}const Da=["component","errorComponent","pendingComponent","notFoundComponent"];function xf(e){return{input:({url:t})=>{for(const s of e)t=Va(s,t);return t},output:({url:t})=>{for(let s=e.length-1;s>=0;s--)t=Ua(e[s],t);return t}}}function wf(e){const t=Ea(e.basepath),s=`/${t}`,n=`${s}/`,r=e.caseSensitive?s:s.toLowerCase(),i=e.caseSensitive?n:n.toLowerCase();return{input:({url:o})=>{const a=e.caseSensitive?o.pathname:o.pathname.toLowerCase();return a===r?o.pathname="/":a.startsWith(i)&&(o.pathname=o.pathname.slice(s.length)),o},output:({url:o})=>(o.pathname=rn(["/",t,o.pathname]),o)}}function Va(e,t){const s=e?.input?.({url:t});if(s){if(typeof s=="string")return new URL(s);if(s instanceof URL)return s}return t}function Ua(e,t){const s=e?.output?.({url:t});if(s){if(typeof s=="string")return new URL(s);if(s instanceof URL)return s}return t}function jt(e){const t=e.resolvedLocation,s=e.location,n=t?.pathname!==s.pathname,r=t?.href!==s.href,i=t?.hash!==s.hash;return{fromLocation:t,toLocation:s,pathChanged:n,hrefChanged:r,hashChanged:i}}class Sf{constructor(t){this.tempLocationKey=`${Math.round(Math.random()*1e7)}`,this.resetNextScroll=!0,this.shouldViewTransition=void 0,this.isViewTransitionTypesSupported=void 0,this.subscribers=new Set,this.isScrollRestoring=!1,this.isScrollRestorationSetup=!1,this.startTransition=s=>s(),this.update=s=>{s.notFoundRoute&&console.warn("The notFoundRoute API is deprecated and will be removed in the next major version. See https://tanstack.com/router/v1/docs/framework/react/guide/not-found-errors#migrating-from-notfoundroute for more info.");const n=this.options,r=this.basepath??n?.basepath??"/",i=this.basepath===void 0,o=n?.rewrite;this.options={...n,...s},this.isServer=this.options.isServer??typeof document>"u",this.pathParamsDecodeCharMap=this.options.pathParamsAllowedCharacters?new Map(this.options.pathParamsAllowedCharacters.map(d=>[encodeURIComponent(d),d])):void 0,(!this.history||this.options.history&&this.options.history!==this.history)&&(this.options.history?this.history=this.options.history:this.isServer||(this.history=La())),this.origin=this.options.origin,this.origin||(!this.isServer&&window?.origin&&window.origin!=="null"?this.origin=window.origin:this.origin="http://localhost"),this.history&&this.updateLatestLocation(),this.options.routeTree!==this.routeTree&&(this.routeTree=this.options.routeTree,this.buildRouteTree()),!this.__store&&this.latestLocation&&(this.__store=new Au(Cf(this.latestLocation),{onUpdate:()=>{this.__store.state={...this.state,cachedMatches:this.state.cachedMatches.filter(d=>!["redirected"].includes(d.status))}}}),af(this));let a=!1;const c=this.options.basepath??"/",u=this.options.rewrite;if(i||r!==c||o!==u){this.basepath=c;const d=[];Ea(c)!==""&&d.push(wf({basepath:c})),u&&d.push(u),this.rewrite=d.length===0?void 0:d.length===1?d[0]:xf(d),this.history&&this.updateLatestLocation(),a=!0}a&&this.__store&&(this.__store.state={...this.state,location:this.latestLocation}),typeof window<"u"&&"CSS"in window&&typeof window.CSS?.supports=="function"&&(this.isViewTransitionTypesSupported=window.CSS.supports("selector(:active-view-transition-type(a)"))},this.updateLatestLocation=()=>{this.latestLocation=this.parseLocation(this.history.location,this.latestLocation)},this.buildRouteTree=()=>{const{routesById:s,routesByPath:n,processedTree:r}=qu(this.routeTree,this.options.caseSensitive,(o,a)=>{o.init({originalIndex:a})});this.options.routeMasks&&Hu(this.options.routeMasks,r),this.routesById=s,this.routesByPath=n,this.processedTree=r;const i=this.options.notFoundRoute;i&&(i.init({originalIndex:99999999999}),this.routesById[i.id]=i)},this.subscribe=(s,n)=>{const r={eventType:s,fn:n};return this.subscribers.add(r),()=>{this.subscribers.delete(r)}},this.emit=s=>{this.subscribers.forEach(n=>{n.eventType===s.type&&n.fn(s)})},this.parseLocation=(s,n)=>{const r=({href:c,state:u})=>{const f=new URL(c,this.origin),l=Va(this.rewrite,f),d=this.options.parseSearch(l.search),h=this.options.stringifySearch(d);return l.search=h,{href:l.href.replace(l.origin,""),publicHref:c,url:l,pathname:io(l.pathname),searchStr:h,search:je(n?.search,d),hash:l.hash.split("#").reverse()[0]??"",state:je(n?.state,u)}},i=r(s),{__tempLocation:o,__tempKey:a}=i.state;if(o&&(!a||a===this.tempLocationKey)){const c=r(o);return c.state.key=i.state.key,c.state.__TSR_key=i.state.__TSR_key,delete c.state.__tempLocation,{...c,maskedLocation:i}}return i},this.resolvePathCache=_n(1e3),this.resolvePathWithBase=(s,n)=>ef({base:s,to:li(n),trailingSlash:this.options.trailingSlash,cache:this.resolvePathCache}),this.matchRoutes=(s,n,r)=>typeof s=="string"?this.matchRoutesInternal({pathname:s,search:n},r):this.matchRoutesInternal(s,n),this.getMatchedRoutes=s=>Pf({pathname:s,routesById:this.routesById,processedTree:this.processedTree}),this.cancelMatch=s=>{const n=this.getMatch(s);n&&(n.abortController.abort(),clearTimeout(n._nonReactive.pendingTimeout),n._nonReactive.pendingTimeout=void 0)},this.cancelMatches=()=>{const s=this.state.matches.filter(i=>i.status==="pending"),n=this.state.matches.filter(i=>i.isFetching==="loader");new Set([...this.state.pendingMatches??[],...s,...n]).forEach(i=>{this.cancelMatch(i.id)})},this.buildLocation=s=>{const n=(i={})=>{const o=i._fromLocation||this.pendingBuiltLocation||this.latestLocation,a=this.matchRoutes(o,{_buildLocation:!0}),c=vn(a);i.from;const u=i.unsafeRelative==="path"?o.pathname:i.from??c.fullPath,f=this.resolvePathWithBase(u,"."),l=c.search,d={...c.params},h=i.to?this.resolvePathWithBase(f,`${i.to}`):this.resolvePathWithBase(f,"."),g=i.params===!1||i.params===null?{}:(i.params??!0)===!0?d:Object.assign(d,Gt(i.params,d)),y=sr({path:h,params:g}).interpolatedPath,x=this.matchRoutes(y,void 0,{_buildLocation:!0}).map(W=>this.looseRoutesById[W.routeId]);if(Object.keys(g).length>0)for(const W of x){const J=W.options.params?.stringify??W.options.stringifyParams;J&&Object.assign(g,J(g))}const b=s.leaveParams?h:io(sr({path:h,params:g,decodeCharMap:this.pathParamsDecodeCharMap}).interpolatedPath);let L=l;if(s._includeValidateSearch&&this.options.search?.strict){const W={};x.forEach(J=>{if(J.options.validateSearch)try{Object.assign(W,kr(J.options.validateSearch,{...W,...L}))}catch{}}),L=W}L=kf({search:L,dest:i,destRoutes:x,_includeValidateSearch:s._includeValidateSearch}),L=je(l,L);const $=this.options.stringifySearch(L),C=i.hash===!0?o.hash:i.hash?Gt(i.hash,o.hash):void 0,k=C?`#${C}`:"";let _=i.state===!0?o.state:i.state?Gt(i.state,o.state):{};_=je(o.state,_);const D=`${b}${$}${k}`,M=new URL(D,this.origin),B=Ua(this.rewrite,M);return{publicHref:B.pathname+B.search+B.hash,href:D,url:B,pathname:b,search:L,searchStr:$,state:_,hash:C??"",unmaskOnReload:i.unmaskOnReload}},r=(i={},o)=>{const a=n(i);let c=o?n(o):void 0;if(!c){const u={};if(this.options.routeMasks){const f=Zu(a.pathname,this.processedTree);if(f){Object.assign(u,f.params);const{from:l,params:d,...h}=f.route,g=d===!1||d===null?{}:(d??!0)===!0?u:Object.assign(u,Gt(d,u));o={from:s.from,...h,params:g},c=n(o)}}}return c&&(a.maskedLocation=c),a};return s.mask?r(s,{from:s.from,...s.mask}):r(s)},this.commitLocation=({viewTransition:s,ignoreBlocker:n,...r})=>{const i=()=>{const c=["key","__TSR_key","__TSR_index","__hashScrollIntoViewOptions"];c.forEach(f=>{r.state[f]=this.latestLocation.state[f]});const u=$t(r.state,this.latestLocation.state);return c.forEach(f=>{delete r.state[f]}),u},o=Bt(this.latestLocation.href)===Bt(r.href),a=this.commitLocationPromise;if(this.commitLocationPromise=ts(()=>{a?.resolve()}),o&&i())this.load();else{let{maskedLocation:c,hashScrollIntoView:u,url:f,...l}=r;c&&(l={...c,state:{...c.state,__tempKey:void 0,__tempLocation:{...l,search:l.searchStr,state:{...l.state,__tempKey:void 0,__tempLocation:void 0,__TSR_key:void 0,key:void 0}}}},(l.unmaskOnReload??this.options.unmaskOnReload??!1)&&(l.state.__tempKey=this.tempLocationKey)),l.state.__hashScrollIntoViewOptions=u??this.options.defaultHashScrollIntoView??!0,this.shouldViewTransition=s,this.history[r.replace?"replace":"push"](l.publicHref,l.state,{ignoreBlocker:n})}return this.resetNextScroll=r.resetScroll??!0,this.history.subscribers.size||this.load(),this.commitLocationPromise},this.buildAndCommitLocation=({replace:s,resetScroll:n,hashScrollIntoView:r,viewTransition:i,ignoreBlocker:o,href:a,...c}={})=>{if(a){const l=this.history.location.state.__TSR_index,d=Bs(a,{__TSR_index:s?l:l+1});c.to=d.pathname,c.search=this.options.parseSearch(d.search),c.hash=d.hash.slice(1)}const u=this.buildLocation({...c,_includeValidateSearch:!0});this.pendingBuiltLocation=u;const f=this.commitLocation({...u,viewTransition:i,replace:s,resetScroll:n,hashScrollIntoView:r,ignoreBlocker:o});return Promise.resolve().then(()=>{this.pendingBuiltLocation===u&&(this.pendingBuiltLocation=void 0)}),f},this.navigate=async({to:s,reloadDocument:n,href:r,...i})=>{if(!n&&r)try{new URL(`${r}`),n=!0}catch{}if(n){if(r||(r=this.buildLocation({to:s,...i}).url.href),!i.ignoreBlocker){const a=this.history.getBlockers?.()??[];for(const c of a)if(c?.blockerFn&&await c.blockerFn({currentLocation:this.latestLocation,nextLocation:this.latestLocation,action:"PUSH"}))return Promise.resolve()}return i.replace?window.location.replace(r):window.location.href=r,Promise.resolve()}return this.buildAndCommitLocation({...i,href:r,to:s,_isNavigate:!0})},this.beforeLoad=()=>{if(this.cancelMatches(),this.updateLatestLocation(),this.isServer){const n=this.buildLocation({to:this.latestLocation.pathname,search:!0,params:!0,hash:!0,state:!0,_includeValidateSearch:!0});if(this.latestLocation.publicHref!==n.publicHref||n.url.origin!==this.origin){const r=this.getParsedLocationHref(n);throw mf({href:r})}}const s=this.matchRoutes(this.latestLocation);this.__store.setState(n=>({...n,status:"pending",statusCode:200,isLoading:!0,location:this.latestLocation,pendingMatches:s,cachedMatches:n.cachedMatches.filter(r=>!s.some(i=>i.id===r.id))}))},this.load=async s=>{let n,r,i;for(i=new Promise(a=>{this.startTransition(async()=>{try{this.beforeLoad();const c=this.latestLocation,u=this.state.resolvedLocation;this.state.redirect||this.emit({type:"onBeforeNavigate",...jt({resolvedLocation:u,location:c})}),this.emit({type:"onBeforeLoad",...jt({resolvedLocation:u,location:c})}),await ao({router:this,sync:s?.sync,matches:this.state.pendingMatches,location:c,updateMatch:this.updateMatch,onReady:async()=>{this.startTransition(()=>{this.startViewTransition(async()=>{let f=[],l=[],d=[];Is(()=>{this.__store.setState(h=>{const g=h.matches,y=h.pendingMatches||h.matches;return f=g.filter(x=>!y.some(b=>b.id===x.id)),l=y.filter(x=>!g.some(b=>b.id===x.id)),d=y.filter(x=>g.some(b=>b.id===x.id)),{...h,isLoading:!1,loadedAt:Date.now(),matches:y,pendingMatches:void 0,cachedMatches:[...h.cachedMatches,...f.filter(x=>x.status!=="error"&&x.status!=="notFound")]}}),this.clearExpiredCache()}),[[f,"onLeave"],[l,"onEnter"],[d,"onStay"]].forEach(([h,g])=>{h.forEach(y=>{this.looseRoutesById[y.routeId].options[g]?.(y)})})})})}})}catch(c){Ue(c)?(n=c,this.isServer||this.navigate({...n.options,replace:!0,ignoreBlocker:!0})):$e(c)&&(r=c),this.__store.setState(u=>({...u,statusCode:n?n.status:r?404:u.matches.some(f=>f.status==="error")?500:200,redirect:n}))}this.latestLoadPromise===i&&(this.commitLocationPromise?.resolve(),this.latestLoadPromise=void 0,this.commitLocationPromise=void 0),a()})}),this.latestLoadPromise=i,await i;this.latestLoadPromise&&i!==this.latestLoadPromise;)await this.latestLoadPromise;let o;this.hasNotFoundMatch()?o=404:this.__store.state.matches.some(a=>a.status==="error")&&(o=500),o!==void 0&&this.__store.setState(a=>({...a,statusCode:o}))},this.startViewTransition=s=>{const n=this.shouldViewTransition??this.options.defaultViewTransition;if(delete this.shouldViewTransition,n&&typeof document<"u"&&"startViewTransition"in document&&typeof document.startViewTransition=="function"){let r;if(typeof n=="object"&&this.isViewTransitionTypesSupported){const i=this.latestLocation,o=this.state.resolvedLocation,a=typeof n.types=="function"?n.types(jt({resolvedLocation:o,location:i})):n.types;if(a===!1){s();return}r={update:s,types:a}}else r=s;document.startViewTransition(r)}else s()},this.updateMatch=(s,n)=>{this.startTransition(()=>{const r=this.state.pendingMatches?.some(i=>i.id===s)?"pendingMatches":this.state.matches.some(i=>i.id===s)?"matches":this.state.cachedMatches.some(i=>i.id===s)?"cachedMatches":"";r&&this.__store.setState(i=>({...i,[r]:i[r]?.map(o=>o.id===s?n(o):o)}))})},this.getMatch=s=>{const n=r=>r.id===s;return this.state.cachedMatches.find(n)??this.state.pendingMatches?.find(n)??this.state.matches.find(n)},this.invalidate=s=>{const n=r=>s?.filter?.(r)??!0?{...r,invalid:!0,...s?.forcePending||r.status==="error"||r.status==="notFound"?{status:"pending",error:void 0}:void 0}:r;return this.__store.setState(r=>({...r,matches:r.matches.map(n),cachedMatches:r.cachedMatches.map(n),pendingMatches:r.pendingMatches?.map(n)})),this.shouldViewTransition=!1,this.load({sync:s?.sync})},this.getParsedLocationHref=s=>{let n=s.url.href;return this.origin&&s.url.origin===this.origin&&(n=n.replace(this.origin,"")||"/"),n},this.resolveRedirect=s=>{if(!s.options.href){const n=this.buildLocation(s.options),r=this.getParsedLocationHref(n);s.options.href=n.href,s.headers.set("Location",r)}return s.headers.get("Location")||s.headers.set("Location",s.options.href),s},this.clearCache=s=>{const n=s?.filter;n!==void 0?this.__store.setState(r=>({...r,cachedMatches:r.cachedMatches.filter(i=>!n(i))})):this.__store.setState(r=>({...r,cachedMatches:[]}))},this.clearExpiredCache=()=>{const s=n=>{const r=this.looseRoutesById[n.routeId];if(!r.options.loader)return!0;const i=(n.preload?r.options.preloadGcTime??this.options.defaultPreloadGcTime:r.options.gcTime??this.options.defaultGcTime)??300*1e3;return n.status==="error"?!0:Date.now()-n.updatedAt>=i};this.clearCache({filter:s})},this.loadRouteChunk=Ba,this.preloadRoute=async s=>{const n=this.buildLocation(s);let r=this.matchRoutes(n,{throwOnError:!0,preload:!0,dest:s});const i=new Set([...this.state.matches,...this.state.pendingMatches??[]].map(a=>a.id)),o=new Set([...i,...this.state.cachedMatches.map(a=>a.id)]);Is(()=>{r.forEach(a=>{o.has(a.id)||this.__store.setState(c=>({...c,cachedMatches:[...c.cachedMatches,a]}))})});try{return r=await ao({router:this,matches:r,location:n,preload:!0,updateMatch:(a,c)=>{i.has(a)?r=r.map(u=>u.id===a?c(u):u):this.updateMatch(a,c)}}),r}catch(a){if(Ue(a))return a.options.reloadDocument?void 0:await this.preloadRoute({...a.options,_fromLocation:n});$e(a)||console.error(a);return}},this.matchRoute=(s,n)=>{const r={...s,to:s.to?this.resolvePathWithBase(s.from||"",s.to):void 0,params:s.params||{},leaveParams:!0},i=this.buildLocation(r);if(n?.pending&&this.state.status!=="pending")return!1;const a=(n?.pending===void 0?!this.state.isLoading:n.pending)?this.latestLocation:this.state.resolvedLocation||this.state.location,c=Wu(i.pathname,n?.caseSensitive??!1,n?.fuzzy??!1,a.pathname,this.processedTree);return!c||s.params&&!$t(c.params,s.params,{partial:!0})?!1:n?.includeSearch??!0?$t(a.search,i.search,{partial:!0})?c.params:!1:c.params},this.hasNotFoundMatch=()=>this.__store.state.matches.some(s=>s.status==="notFound"||s.globalNotFound),this.update({defaultPreloadDelay:50,defaultPendingMs:1e3,defaultPendingMinMs:500,context:void 0,...t,caseSensitive:t.caseSensitive??!1,notFoundMode:t.notFoundMode??"fuzzy",stringifySearch:t.stringifySearch??df,parseSearch:t.parseSearch??ff}),typeof document<"u"&&(self.__TSR_ROUTER__=this)}isShell(){return!!this.options.isShell}isPrerendering(){return!!this.options.isPrerendering}get state(){return this.__store.state}get looseRoutesById(){return this.routesById}matchRoutesInternal(t,s){const n=this.getMatchedRoutes(t.pathname),{foundRoute:r,routeParams:i}=n;let{matchedRoutes:o}=n,a=!1;(r?r.path!=="/"&&i["**"]:Bt(t.pathname))&&(this.options.notFoundRoute?o=[...o,this.options.notFoundRoute]:a=!0);const c=(()=>{if(a){if(this.options.notFoundMode!=="root")for(let l=o.length-1;l>=0;l--){const d=o[l];if(d.children)return d.id}return Ne}})(),u=[],f=l=>l?.id?l.context??this.options.context??void 0:this.options.context??void 0;return o.forEach((l,d)=>{const h=u[d-1],[g,y,x]=(()=>{const P=h?.search??t.search,H=h?._strictSearch??void 0;try{const te=kr(l.options.validateSearch,{...P})??void 0;return[{...P,...te},{...H,...te},void 0]}catch(te){let Q=te;if(te instanceof Sn||(Q=new Sn(te.message,{cause:te})),s?.throwOnError)throw Q;return[P,{},Q]}})(),b=l.options.loaderDeps?.({search:g})??"",L=b?JSON.stringify(b):"",{interpolatedPath:$,usedParams:C}=sr({path:l.fullPath,params:i,decodeCharMap:this.pathParamsDecodeCharMap}),k=l.id+$+L,_=this.getMatch(k),D=this.state.matches.find(P=>P.routeId===l.id),M=_?._strictParams??C;let B;if(!_){const P=l.options.params?.parse??l.options.parseParams;if(P)try{Object.assign(M,P(M))}catch(H){if($e(H)||Ue(H)?B=H:B=new Rf(H.message,{cause:H}),s?.throwOnError)throw B}}Object.assign(i,M);const W=D?"stay":"enter";let J;if(_)J={..._,cause:W,params:D?je(D.params,i):i,_strictParams:M,search:je(D?D.search:_.search,g),_strictSearch:y};else{const P=l.options.loader||l.options.beforeLoad||l.lazyFn||ja(l)?"pending":"success";J={id:k,ssr:this.isServer?void 0:l.options.ssr,index:d,routeId:l.id,params:D?je(D.params,i):i,_strictParams:M,pathname:$,updatedAt:Date.now(),search:D?je(D.search,g):g,_strictSearch:y,searchError:void 0,status:P,isFetching:!1,error:void 0,paramsError:B,__routeContext:void 0,_nonReactive:{loadPromise:ts()},__beforeLoadContext:void 0,context:{},abortController:new AbortController,fetchCount:0,cause:W,loaderDeps:D?je(D.loaderDeps,b):b,invalid:!1,preload:!1,links:void 0,scripts:void 0,headScripts:void 0,meta:void 0,staticData:l.options.staticData||{},fullPath:l.fullPath}}s?.preload||(J.globalNotFound=c===l.id),J.searchError=x;const de=f(h);J.context={...de,...J.__routeContext,...J.__beforeLoadContext},u.push(J)}),u.forEach((l,d)=>{const h=this.looseRoutesById[l.routeId];if(!this.getMatch(l.id)&&s?._buildLocation!==!0){const y=u[d-1],x=f(y);if(h.options.context){const b={deps:l.loaderDeps,params:l.params,context:x??{},location:t,navigate:L=>this.navigate({...L,_fromLocation:t}),buildLocation:this.buildLocation,cause:l.cause,abortController:l.abortController,preload:!!l.preload,matches:u};l.__routeContext=h.options.context(b)??void 0}l.context={...x,...l.__routeContext,...l.__beforeLoadContext}}}),u}}class Sn extends Error{}class Rf extends Error{}function Cf(e){return{loadedAt:0,isLoading:!1,isTransitioning:!1,status:"idle",resolvedLocation:void 0,location:e,matches:[],pendingMatches:[],cachedMatches:[],statusCode:200}}function kr(e,t){if(e==null)return{};if("~standard"in e){const s=e["~standard"].validate(t);if(s instanceof Promise)throw new Sn("Async validation not supported");if(s.issues)throw new Sn(JSON.stringify(s.issues,void 0,2),{cause:s});return s.value}return"parse"in e?e.parse(t):typeof e=="function"?e(t):{}}function Pf({pathname:e,routesById:t,processedTree:s}){const n={},r=Bt(e);let i;const o=zu(r,s,!0);return o&&(i=o.route,Object.assign(n,o.params)),{matchedRoutes:o?.branch||[t[Ne]],routeParams:n,foundRoute:i}}function kf({search:e,dest:t,destRoutes:s,_includeValidateSearch:n}){const r=s.reduce((a,c)=>{const u=[];if("search"in c.options)c.options.search?.middlewares&&u.push(...c.options.search.middlewares);else if(c.options.preSearchFilters||c.options.postSearchFilters){const f=({search:l,next:d})=>{let h=l;"preSearchFilters"in c.options&&c.options.preSearchFilters&&(h=c.options.preSearchFilters.reduce((y,x)=>x(y),l));const g=d(h);return"postSearchFilters"in c.options&&c.options.postSearchFilters?c.options.postSearchFilters.reduce((y,x)=>x(y),g):g};u.push(f)}if(n&&c.options.validateSearch){const f=({search:l,next:d})=>{const h=d(l);try{return{...h,...kr(c.options.validateSearch,h)??void 0}}catch{return h}};u.push(f)}return a.concat(u)},[])??[],i=({search:a})=>t.search?t.search===!0?a:Gt(t.search,a):{};r.push(i);const o=(a,c)=>{if(a>=r.length)return c;const u=r[a];return u({search:c,next:l=>o(a+1,l)})};return o(0,e)}const Tf="Error preloading route! ☝️";class Ha{constructor(t){if(this.init=s=>{this.originalIndex=s.originalIndex;const n=this.options,r=!n?.path&&!n?.id;this.parentRoute=this.options.getParentRoute?.(),r?this._path=Ne:this.parentRoute||Dt(!1);let i=r?Ne:n?.path;i&&i!=="/"&&(i=Ma(i));const o=n?.id||i;let a=r?Ne:rn([this.parentRoute.id===Ne?"":this.parentRoute.id,o]);i===Ne&&(i="/"),a!==Ne&&(a=rn(["/",a]));const c=a===Ne?"/":rn([this.parentRoute.fullPath,i]);this._path=i,this._id=a,this._fullPath=c,this._to=c},this.addChildren=s=>this._addFileChildren(s),this._addFileChildren=s=>(Array.isArray(s)&&(this.children=s),typeof s=="object"&&s!==null&&(this.children=Object.values(s)),this),this._addFileTypes=()=>this,this.updateLoader=s=>(Object.assign(this.options,s),this),this.update=s=>(Object.assign(this.options,s),this),this.lazy=s=>(this.lazyFn=s,this),this.options=t||{},this.isRoot=!t?.getParentRoute,t?.id&&t?.path)throw new Error("Route cannot have both an 'id' and a 'path' option.")}get to(){return this._to}get id(){return this._id}get path(){return this._path}get fullPath(){return this._fullPath}}class If extends Ha{constructor(t){super(t)}}const Lf=ve({name:"VueErrorBoundary",props:{onError:Function,resetKey:[String,Number]},emits:["catch"],setup(e,{slots:t}){const s=we(null),n=we(null),r=()=>{s.value=null};return Qe(()=>e.resetKey,(i,o)=>{i!==o&&s.value&&r()}),oa(i=>(i instanceof Promise||i&&typeof i.then=="function"||(s.value=i,n.value=r,e.onError&&e.onError(i)),!1)),()=>{if(s.value&&t.fallback){const o=t.fallback({error:s.value,reset:r});return Array.isArray(o)&&o.length===1?o[0]:o}const i=t.default&&t.default();return Array.isArray(i)&&i.length===1?i[0]:i}}}),Mf=ve({name:"CatchBoundary",inheritAttrs:!1,props:["getResetKey","children","errorComponent","onCatch"],setup(e){const t=fe(()=>e.getResetKey());return()=>j(Lf,{resetKey:t.value,onError:e.onCatch},{default:()=>e.children,fallback:({error:s,reset:n})=>e.errorComponent?j(e.errorComponent,{error:s,reset:n}):j(Za,{error:s,reset:n})})}});function fi(e){return j(Mf,e)}const Za=ve({name:"ErrorComponent",props:{error:Object,reset:Function},setup(e){const t=we(!1),s=()=>{t.value=!t.value};return()=>j("div",{style:{padding:".5rem",maxWidth:"100%"}},[j("div",{style:{display:"flex",alignItems:"center",gap:".5rem"}},[j("strong",{style:{fontSize:"1rem"}},"Something went wrong!"),j("button",{style:{appearance:"none",fontSize:".6em",border:"1px solid currentColor",padding:".1rem .2rem",fontWeight:"bold",borderRadius:".25rem"},onClick:s},t.value?"Hide Error":"Show Error")]),j("div",{style:{height:".25rem"}}),t.value?j("div",{},[j("pre",{style:{fontSize:".7em",border:"1px solid red",borderRadius:".25rem",padding:".3rem",color:"red",overflow:"auto"}},[e.error?.message?j("code",{},e.error.message):null])]):null])}});function Ef(e,t=n=>n,s={}){const n=we(t(e.state)),r=s.equal??Of;return Qe(()=>e,(i,o,a)=>{const c=i.subscribe(()=>{const u=t(i.state);r(ae(n.value),u)||(n.value=u)});a(()=>{c()})},{immediate:!0}),cn(n)}function Of(e,t){if(Object.is(e,t))return!0;if(typeof e!="object"||e===null||typeof t!="object"||t===null)return!1;if(e instanceof Map&&t instanceof Map){if(e.size!==t.size)return!1;for(const[n,r]of e)if(!t.has(n)||!Object.is(r,t.get(n)))return!1;return!0}if(e instanceof Set&&t instanceof Set){if(e.size!==t.size)return!1;for(const n of e)if(!t.has(n))return!1;return!0}if(e instanceof Date&&t instanceof Date)return e.getTime()===t.getTime();const s=Object.keys(e);if(s.length!==Object.keys(t).length)return!1;for(let n=0;n"u"?rr:window.__TSR_ROUTER_CONTEXT__?window.__TSR_ROUTER_CONTEXT__:(window.__TSR_ROUTER_CONTEXT__=rr,rr)}function Af(e){An(Wa(),e)}function Ce(e){const t=wt(Wa(),null);return e?.warn,t}function _e(e){const t=Ce({warn:e?.router===void 0}),s=e?.router||t;return!s||!s.__store?we(void 0):Ef(s.__store,n=>e?.select?e.select(n):n)}const Dn=Symbol("TanStackRouterMatch"),Nf=Symbol("TanStackRouterDummyMatch");function Ff(){return wt(Dn,we(void 0))}function $f(){return wt(Nf,we(void 0))}function st(e){const t=e.from?$f():Ff(),s=we(null),n=_e({select:i=>{const o=i.matches.find(a=>e.from?e.from===a.routeId:a.id===t.value);if(o===void 0){if(i.pendingMatches?.find(c=>e.from?e.from===c.routeId:c.id===t.value)||i.isTransitioning){s.value=null;return}(e.shouldThrow??!0)&&(s.value=new Error(`Invariant failed: Could not find ${e.from?`an active match from "${e.from}"`:"a nearest match!"}`));return}return s.value=null,e.select?e.select(o):o}}),r=fe(()=>{if(s.value)throw s.value;return n.value});if(s.value)throw s.value;return r}function di(e){return st({from:e.from,strict:e.strict,select:t=>e.select?e.select(t.loaderData):t.loaderData})}function hi(e){const{select:t,...s}=e;return st({...s,select:n=>t?t(n.loaderDeps):n.loaderDeps})}function pi(e){return st({from:e.from,strict:e.strict,shouldThrow:e.shouldThrow,select:t=>e.select?e.select(t.params):t.params})}function mi(e){return st({from:e.from,strict:e.strict,shouldThrow:e.shouldThrow,select:t=>e.select?e.select(t.search):t.search})}function gi(e){const{navigate:t}=Ce();return s=>t({from:e?.from,...s})}let Bf=class extends Ha{constructor(t){super(t),this.useMatch=s=>st({select:s?.select,from:this.id}),this.useRouteContext=s=>st({...s,from:this.id,select:n=>s?.select?s.select(n.context):n.context}),this.useSearch=s=>mi({select:s?.select,from:this.id}),this.useParams=s=>pi({select:s?.select,from:this.id}),this.useLoaderDeps=s=>hi({...s,from:this.id}),this.useLoaderData=s=>di({...s,from:this.id}),this.useNavigate=()=>gi({from:this.fullPath})}};function jf(e){return new Bf(e)}class Df extends If{constructor(t){super(t),this.useMatch=s=>st({select:s?.select,from:this.id}),this.useRouteContext=s=>st({...s,from:this.id,select:n=>s?.select?s.select(n.context):n.context}),this.useSearch=s=>mi({select:s?.select,from:this.id}),this.useParams=s=>pi({select:s?.select,from:this.id}),this.useLoaderDeps=s=>hi({...s,from:this.id}),this.useLoaderData=s=>di({...s,from:this.id}),this.useNavigate=()=>gi({from:this.fullPath})}}function Vf(e){return new Df(e)}function cs(e){return typeof e=="object"?new co(e,{silent:!0}).createRoute(e):new co(e,{silent:!0}).createRoute}class co{constructor(t,s){this.path=t,this.createRoute=n=>{this.silent;const r=jf(n);return r.isRoot=!1,r},this.silent=s?.silent}}class lo{constructor(t){this.useMatch=s=>st({select:s?.select,from:this.options.id}),this.useRouteContext=s=>st({from:this.options.id,select:n=>s?.select?s.select(n.context):n.context}),this.useSearch=s=>mi({select:s?.select,from:this.options.id}),this.useParams=s=>pi({select:s?.select,from:this.options.id}),this.useLoaderDeps=s=>hi({...s,from:this.options.id}),this.useLoaderData=s=>di({...s,from:this.options.id}),this.useNavigate=()=>{const s=Ce();return gi({from:s.routesById[this.options.id].fullPath})},this.options=t}}function mh(e){return typeof e=="object"?new lo(e):t=>new lo({id:e,...t})}function Uf(e){const t=_e({select:n=>`not-found-${n.location.pathname}-${n.status}`});return j(fi,{getResetKey:()=>t.value,onCatch:n=>{if($e(n))e.onCatch&&e.onCatch(n);else throw n},errorComponent:n=>{const r=n.error;if($e(r))return e.fallback?e.fallback(r):j("p",null,"Not Found");throw r},children:e.children})}const Hf=ve({name:"DefaultGlobalNotFound",setup(){return()=>j("p",null,"Not Found")}});function za(e,t,s){return t.options.notFoundComponent?j(t.options.notFoundComponent,s):e.options.defaultNotFoundComponent?j(e.options.defaultNotFoundComponent,s):j(Hf)}const uo=ve({name:"ScriptOnce",props:{children:{type:String,required:!0}},setup(e){const t=Ce();if(t.isServer)return()=>ce("script",{nonce:t.options.ssr?.nonce,class:"$tsr",innerHTML:e.children},null);const s=we(!1);return at(()=>{s.value=!0}),()=>s.value?null:ce("script",{nonce:t.options.ssr?.nonce,class:"$tsr","data-allow-mismatch":!0,innerHTML:""},null)}}),Zf=ve({name:"ScrollRestoration",setup(){const e=Ce(),t=we(!1);return at(()=>{t.value=!0}),()=>{if(t.value||!e.isScrollRestoring||typeof e.options.scrollRestoration=="function"&&!e.options.scrollRestoration({location:e.latestLocation}))return null;const n=(e.options.getScrollRestorationKey||Pr)(e.latestLocation),r=n!==Pr(e.latestLocation)?n:void 0,i={storageKey:xn,shouldScrollRestoration:!0};return r&&(i.key=r),e.isServer?ce(uo,{children:`(${Oa.toString()})(${JSON.stringify(i)})`},null):ce(uo,{children:""},null)}}}),Ka=ve({name:"Match",props:{matchId:{type:String,required:!0}},setup(e){const t=Ce();let s=null;const n=_e({select:f=>{let l=f.matches.find(y=>y.id===e.matchId),d=l?f.matches.findIndex(y=>y.id===e.matchId):-1;if(l?s=l.routeId:s&&(l=f.matches.find(y=>y.routeId===s),d=l?f.matches.findIndex(y=>y.routeId===s):-1),!l)return null;const h=l.routeId,g=d>0?f.matches[d-1]?.routeId:null;return{matchId:l.id,routeId:h,parentRouteId:g,loadedAt:f.loadedAt}}});Dt(n.value,`Could not find routeId for matchId "${e.matchId}". Please file an issue!`);const r=fe(()=>n.value?t.routesById[n.value.routeId]:null),i=fe(()=>r.value?.options?.pendingComponent??t?.options?.defaultPendingComponent),o=fe(()=>r.value?.options?.errorComponent??t?.options?.defaultErrorComponent),a=fe(()=>r.value?.options?.onCatch??t?.options?.defaultOnCatch),c=fe(()=>r.value?.isRoot?r.value?.options?.notFoundComponent??t?.options?.notFoundRoute?.options?.component:r.value?.options?.notFoundComponent),u=we(n.value?.matchId??e.matchId);return Qe([()=>e.matchId,()=>n.value?.matchId],([f,l])=>{u.value=l??f},{immediate:!0}),An(Dn,u),()=>{const f=n.value?.matchId??e.matchId;let l=j(zf,{matchId:f});c.value&&(l=j(Uf,{fallback:g=>{if(!c.value||g.routeId&&g.routeId!==n.value?.routeId||!g.routeId&&r.value&&!r.value.isRoot)throw g;return j(c.value,g)},children:l})),o.value&&(l=fi({getResetKey:()=>n.value?.loadedAt??0,errorComponent:o.value||Za,onCatch:g=>{if($e(g))throw g;a.value?.(g)},children:l})),r.value&&(r.value?.options?.wrapInSuspense??i.value??!1)&&(l=j(si,{fallback:i.value?j(i.value):null},{default:()=>l}));const h=[l,n.value?.parentRouteId===Ne&&t.options.scrollRestoration?j(Fe,null,[j(Wf),j(Zf)]):null].filter(Boolean);return h.length===1?h[0]:j(Fe,null,h)}}}),Wf=ve({name:"OnRendered",setup(){const e=Ce(),t=_e({select:s=>s.resolvedLocation?.state.key});return la(()=>{t.value&&e.emit({type:"onRendered",...jt(e.state)})}),()=>null}}),zf=ve({name:"MatchInner",props:{matchId:{type:String,required:!0}},setup(e){const t=Ce();let s=null;const n=_e({select:a=>{let c=a.matches.find(d=>d.id===e.matchId);if(c)s=c.routeId;else if(s){const d=a.matches.find(h=>h.routeId===s);d&&(c=d)}if(!c)return null;const u=c.routeId,f=t.routesById[u].options.remountDeps??t.options.defaultRemountDeps;let l;if(f){const d=f({routeId:u,loaderDeps:c.loaderDeps,params:c._strictParams,search:c._strictSearch});l=d?JSON.stringify(d):void 0}return{routeId:u,match:{id:c.id,status:c.status,error:c.error},remountKey:l}}}),r=fe(()=>n.value?t.routesById[n.value.routeId]:null),i=fe(()=>n.value?.match),o=fe(()=>n.value?.remountKey);return()=>{if(!n.value||!i.value||!r.value)return null;if(i.value.status==="notFound")return Dt($e(i.value.error)),za(t,r.value,i.value.error);if(i.value.status==="redirected")throw Dt(Ue(i.value.error)),t.getMatch(i.value.id)?._nonReactive.loadPromise;if(i.value.status==="error"){const u=r.value.options.errorComponent??t.options.defaultErrorComponent;if(u)return j(u,{error:i.value.error,reset:()=>{t.invalidate()},info:{componentStack:""}});throw i.value.error}if(i.value.status==="pending"){const u=r.value.options.pendingMinMs??t.options.defaultPendingMinMs,f=t.getMatch(i.value.id);if(u&&f&&!f._nonReactive.minPendingPromise&&!t.isServer){const d=ts();f._nonReactive.minPendingPromise=d,setTimeout(()=>{d.resolve(),f._nonReactive.minPendingPromise=void 0},u)}const l=r.value.options.pendingComponent??t.options.defaultPendingComponent;return l?j(l):null}const a=r.value.options.component??t.options.defaultComponent,c=o.value;return a?j(a,c!==void 0?{key:c}:void 0):j(qa,c!==void 0?{key:c}:void 0)}}}),qa=ve({name:"Outlet",setup(){const e=Ce(),t=wt(Dn),s=fe(()=>t?.value||""),n=_e({select:a=>a.matches.find(c=>c.id===s.value)?.routeId}),r=fe(()=>e.routesById[n.value]),i=_e({select:a=>{const u=a.matches.find(f=>f.id===s.value);return u?u.globalNotFound:!1}}),o=_e({select:a=>{const c=a.matches,u=c.findIndex(l=>l.id===s.value),f=c[u+1];return f?{id:f.id,paramsKey:f.routeId+JSON.stringify(f._strictParams)}:null}});return()=>{if(i.value)return za(e,r.value,void 0);if(!o.value)return null;const a=j(Ka,{matchId:o.value.id,key:o.value.paramsKey});return s.value===Ne?j(si,{fallback:e.options.defaultPendingComponent?j(e.options.defaultPendingComponent):null},{default:()=>a}):a}}});function ir(e){return typeof e?.message!="string"?!1:e.message.startsWith("Failed to fetch dynamically imported module")||e.message.startsWith("error loading dynamically imported module")||e.message.startsWith("Importing a module script failed")}function vi(e,t,s){let n,r=null,i=null,o=!1;const a=()=>(n||(n=e().then(u=>(n=void 0,r=u[t],r)).catch(u=>{if(i=u,n=void 0,ir(i))return null;throw u})),n),c=ve({name:"LazyRouteComponent",setup(u){const f=Bc(r&&hr(r)),l=we(i),d=we(!f.value&&!l.value);if(at(()=>{!f.value&&!l.value&&(d.value=!0,a().then(h=>{f.value=h&&hr(h),d.value=!1}).catch(h=>{l.value=h,d.value=!1}))}),l.value&&ir(l.value)&&!o&&typeof window<"u"&&typeof sessionStorage<"u"){const h=`tanstack_router_reload:${l.value.message}`;if(!sessionStorage.getItem(h))return sessionStorage.setItem(h,"1"),o=!0,window.location.reload(),()=>null}if(l.value&&!ir(l.value))throw l.value;return()=>d.value||!f.value?j("div",null):j(f.value,u)}});return c.preload=a,c}const or=e=>fe((t={current:null,previous:null})=>{const s=e();return t.current!==s&&(t.previous=t.current,t.current=s),t});function Kf(e,t,s={},n={}){const r=typeof IntersectionObserver=="function",i=we(null);return la(o=>{const a=e.value,c=typeof n.disabled=="function"?n.disabled():n.disabled;if(!a||!r||c)return;const u=new IntersectionObserver(([f])=>{t(f)},s);i.value=u,u.observe(a),o(()=>{u.disconnect(),i.value=null})}),i}let ar={router:null,mounted:!1};function qf(){const e=Ce();if(e.isServer)return;const t=_e({select:({isLoading:d})=>d}),s=we(!1),n=_e({select:d=>d.matches.some(h=>h.status==="pending")}),r=or(()=>t.value),i=fe(()=>t.value||s.value||n.value),o=or(()=>i.value),a=fe(()=>t.value||n.value),c=or(()=>a.value);e.startTransition=d=>{s.value=!0;try{e.__store.setState(g=>({...g,isTransitioning:!0}))}catch{}const h=()=>{pr(()=>{try{s.value=!1,e.__store.setState(g=>({...g,isTransitioning:!1}))}catch{}})};d(),h()};const u=e.__tsrOriginalStartViewTransition??e.startViewTransition;e.__tsrOriginalStartViewTransition=u,e.startViewTransition=d=>u?.(async()=>{await d(),await pr()});let f;at(()=>{f=e.history.subscribe(e.load);const d=e.buildLocation({to:e.latestLocation.pathname,search:!0,params:!0,hash:!0,state:!0,_includeValidateSearch:!0});Bt(e.latestLocation.href)!==Bt(d.href)&&e.commitLocation({...d,replace:!0})});const l=we(!1);at(()=>{l.value=!0}),Jr(()=>{l.value=!1,f&&f()}),at(()=>{if(typeof window<"u"&&e.ssr||ar.router===e&&ar.mounted)return;ar={router:e,mounted:!0},(async()=>{try{await e.load()}catch(h){console.error(h)}})()}),Qe(()=>t.value,d=>{if(l.value)try{r.value.previous&&!d&&e.emit({type:"onLoad",...jt(e.state)})}catch{}}),Qe(a,d=>{if(l.value)try{c.value.previous&&!d&&e.emit({type:"onBeforeRouteMount",...jt(e.state)})}catch{}}),Qe(i,d=>{if(l.value)try{if(o.value.previous&&!d){const h=jt(e.state);e.emit({type:"onResolved",...h}),e.__store.setState(g=>({...g,status:"idle",resolvedLocation:g.location})),h.hrefChanged&&cf(e)}}catch{}})}const fo=ve({name:"MatchesContent",setup(){return qf(),()=>j(Yf)}}),Gf=ve({name:"Matches",setup(){const e=Ce();return()=>{const t=e?.options?.defaultPendingComponent?j(e.options.defaultPendingComponent):null,s=e?.isServer||typeof document<"u"&&e?.ssr?j(fo):j(si,{fallback:t},{default:()=>j(fo)});return e?.options?.InnerWrap?j(e.options.InnerWrap,null,{default:()=>s}):s}}}),Jf=e=>j("div",{class:"error"},[j("h1",null,"Error"),j("p",null,e.error.message||String(e.error)),j("button",{onClick:e.reset},"Try Again")]),Yf=ve({name:"MatchesInner",setup(){const e=Ce(),t=_e({select:r=>r.matches[0]?.id}),s=_e({select:r=>r.loadedAt}),n=fe(()=>t.value);return An(Dn,n),()=>{const r=t.value?j(Ka,{matchId:t.value}):j("div");return e.options.disableGlobalCatchBoundary?r:j(fi,{getResetKey:()=>s.value,errorComponent:Jf,onCatch:i=>{i.message||i.toString()},children:r})}}});function Xf(e){return _e({select:t=>{const s=t?.matches||[];return e?.select?e.select(s):s}})}function Qf(e){const t=Ce(),s=we(!1);let n=!1;if(!t)return console.warn("useRouter must be used inside a component!"),{};const r=fe(()=>{try{return new URL(`${e.to}`),"external"}catch{return"internal"}}),i=_e({select:P=>P.location.searchStr}),o=Xf({select:P=>e.from??P[P.length-1]?.fullPath}),a=fe(()=>({...e,from:o.value})),c=fe(()=>(i.value,t.buildLocation(a.value))),u=fe(()=>a.value.reloadDocument?!1:e.preload??t.options.defaultPreload),f=fe(()=>e.preloadDelay??t.options.defaultPreloadDelay??0),l=_e({select:P=>{const H=e.activeOptions;if(H?.exact){if(!Qu(P.location.pathname,c.value.pathname,t.basepath))return!1}else{const te=bn(P.location.pathname,t.basepath).split("/");if(!bn(c.value?.pathname,t.basepath)?.split("/")?.every((oe,nt)=>oe===te[nt]))return!1}return(H?.includeSearch??!0)&&!$t(P.location.search,c.value.search,{partial:!H?.exact,ignoreUndefined:!H?.explicitUndefined})?!1:H?.includeHash?P.location.hash===c.value.hash:!0}}),d=()=>t.preloadRoute(a.value).catch(P=>{console.warn(P),console.warn(Tf)}),h=P=>{P?.isIntersecting&&d()},g=we(null);Kf(g,h,{rootMargin:"100px"},{disabled:()=>!!e.disabled||u.value!=="viewport"}),_c(()=>{n||!e.disabled&&u.value==="render"&&(d(),n=!0)});const y=()=>{const P={};for(const H in e)["activeProps","inactiveProps","activeOptions","to","preload","preloadDelay","hashScrollIntoView","replace","startTransition","resetScroll","viewTransition","children","target","disabled","style","class","onClick","onFocus","onMouseEnter","onMouseLeave","onMouseOver","onMouseOut","onTouchStart","ignoreBlocker","params","search","hash","state","mask","reloadDocument","_asChild","from","additionalProps"].includes(H)||(P[H]=e[H]);return P};if(r.value==="external"){const P={...y(),ref:g,href:e.to,target:e.target,disabled:e.disabled,style:e.style,class:e.class,onClick:e.onClick,onFocus:e.onFocus,onMouseEnter:e.onMouseEnter,onMouseLeave:e.onMouseLeave,onMouseOver:e.onMouseOver,onMouseOut:e.onMouseOut,onTouchStart:e.onTouchStart};return Object.keys(P).forEach(H=>{P[H]===void 0&&delete P[H]}),P}const x=P=>{const H=P.currentTarget?.getAttribute("target"),te=e.target!==void 0?e.target:H;if(!e.disabled&&!td(P)&&!P.defaultPrevented&&(!te||te==="_self")&&P.button===0){if(a.value.reloadDocument)return;P.preventDefault(),s.value=!0;const Q=t.subscribe("onResolved",()=>{Q(),s.value=!1});t.navigate({...a.value,replace:e.replace,resetScroll:e.resetScroll,hashScrollIntoView:e.hashScrollIntoView,startTransition:e.startTransition,viewTransition:e.viewTransition,ignoreBlocker:e.ignoreBlocker})}},b=P=>{e.disabled||u.value&&d()},L=P=>{e.disabled||u.value&&d()},$=P=>{if(e.disabled)return;const H=P.currentTarget||P.target||{};if(u.value){if(H.preloadTimeout)return;H.preloadTimeout=setTimeout(()=>{H.preloadTimeout=null,d()},f.value)}},C=P=>{if(e.disabled)return;const H=P.currentTarget||P.target||{};H.preloadTimeout&&(clearTimeout(H.preloadTimeout),H.preloadTimeout=null)};function k(P){return H=>{for(const te of P)te&&te(H)}}const _=fe(()=>{const P=e.activeProps||(()=>({class:"active"}));return(l.value?typeof P=="function"?P():P:{})||{class:void 0,style:void 0}}),D=fe(()=>{const P=e.inactiveProps||(()=>({}));return(l.value?{}:typeof P=="function"?P():P)||{class:void 0,style:void 0}}),M=fe(()=>{const P=[e.class,_.value?.class,D.value?.class].filter(Boolean);return P.length?P.join(" "):void 0}),B=fe(()=>{const P={};return e.style&&Object.assign(P,e.style),_.value?.style&&Object.assign(P,_.value.style),D.value?.style&&Object.assign(P,D.value.style),Object.keys(P).length>0?P:void 0}),W=fe(()=>{if(e.disabled)return;const P=c.value,H=P?.maskedLocation;let te;return H?te=H.url.href:te=P?.url.href,t.origin&&te?.startsWith(t.origin)&&(te=t.history.createHref(te.replace(t.origin,""))),te}),J={onClick:k([e.onClick,x]),onFocus:k([e.onFocus,b]),onMouseenter:k([e.onMouseEnter,$]),onMouseover:k([e.onMouseOver,$]),onMouseleave:k([e.onMouseLeave,C]),onMouseout:k([e.onMouseOut,C]),onTouchstart:k([e.onTouchStart,L])};return fe(()=>{const P={...y(),href:W.value,ref:g,...J,disabled:!!e.disabled,target:e.target};B.value&&(P.style=B.value),M.value&&(P.class=M.value),e.disabled&&(P.role="link",P["aria-disabled"]=!0),l.value&&(P["data-status"]="active",P["aria-current"]="page"),s.value&&(P["data-transitioning"]="transitioning");const H=_.value,te=D.value;for(const Q of Object.keys(H))Q!=="class"&&Q!=="style"&&(P[Q]=H[Q]);for(const Q of Object.keys(te))Q!=="class"&&Q!=="style"&&(P[Q]=te[Q]);return P})}const ed=ve({name:"Link",inheritAttrs:!1,props:["_asChild","to","preload","preloadDelay","activeProps","inactiveProps","activeOptions","from","search","params","hash","state","mask","reloadDocument","disabled","additionalProps","viewTransition","resetScroll","startTransition","hashScrollIntoView","replace","ignoreBlocker","target"],setup(e,{attrs:t,slots:s}){const n={...e,...t},r=Qf(n);return()=>{const i=e._asChild||"a",o=r.value,a=o["data-status"]==="active",c=o["data-transitioning"]==="transitioning",u=s.default?s.default({isActive:a,isTransitioning:c}):[];if(i==="svg"){const f={...o};return delete f.class,j("svg",{},[j("a",f,u)])}return typeof i!="string"?j(i,{...o,children:u},u):j(i,o,u)}}}),ho=ed;function td(e){return!!(e.metaKey||e.altKey||e.ctrlKey||e.shiftKey)}const ms=e=>e,sd=e=>new nd(e);class nd extends Sf{constructor(t){super(t)}}const rd=ve({name:"RouterContextProvider",props:{router:{type:Object,required:!0}},setup(e,{attrs:t,slots:s}){const n=e.router,r=t;return n.update({...n.options,...r,context:{...n.options.context,...r.context||{}}}),Af(n),()=>{const i=s.default?.();if(n.options.Wrap){const o=n.options.Wrap;return j(o,null,()=>i)}return Array.isArray(i)&&i.length===1?i[0]:i}}}),id=ve({name:"RouterProvider",props:{router:{type:Object,required:!0}},setup(e,{attrs:t}){const s=t;return()=>j(rd,{router:e.router,...s},{default:()=>j(Gf)})}}),od=ve({name:"Title",props:{children:{type:String,default:""}},setup(e){return Ce().isServer||(at(()=>{e.children&&(document.title=e.children)}),Qe(()=>e.children,s=>{s&&(document.title=s)})),()=>j("title",{},e.children)}}),ad=ve({name:"Script",props:{attrs:{type:Object,default:()=>({})},children:{type:String,default:void 0}},setup(e){const t=Ce();return t.isServer||at(()=>{const s=e.attrs,n=e.children;if(s?.src){const r=(()=>{try{const a=document.baseURI||window.location.href;return new URL(s.src,a).href}catch{return s.src}})();if(Array.from(document.querySelectorAll("script[src]")).find(a=>a.src===r))return;const o=document.createElement("script");for(const[a,c]of Object.entries(s))c!==void 0&&c!==!1&&o.setAttribute(a,typeof c=="boolean"?"":String(c));document.head.appendChild(o)}else if(typeof n=="string"){const r=typeof s?.type=="string"?s.type:"text/javascript",i=typeof s?.nonce=="string"?s.nonce:void 0;if(Array.from(document.querySelectorAll("script:not([src])")).find(c=>{if(!(c instanceof HTMLScriptElement))return!1;const u=c.getAttribute("type")??"text/javascript",f=c.getAttribute("nonce")??void 0;return c.textContent===n&&u===r&&f===i}))return;const a=document.createElement("script");if(a.textContent=n,s)for(const[c,u]of Object.entries(s))u!==void 0&&u!==!1&&a.setAttribute(c,typeof u=="boolean"?"":String(u));document.head.appendChild(a)}}),()=>{if(!t.isServer){const{src:s,...n}=e.attrs||{};return j("script",{...n,"data-allow-mismatch":!0,innerHTML:""})}return e.attrs?.src&&typeof e.attrs.src=="string"?j("script",e.attrs):typeof e.children=="string"?j("script",{...e.attrs,innerHTML:e.children}):null}}});function cd({tag:e,attrs:t,children:s}){switch(e){case"title":return j(od,{children:s});case"meta":return ce("meta",t,null);case"link":return ce("link",t,null);case"style":return ce("style",ri(t,{innerHTML:s}),null);case"script":return j(ad,{attrs:t,children:s});default:return null}}const ld=()=>{const e=Ce(),t=_e({select:o=>o.matches.map(a=>a.meta).filter(Boolean)}),s=fe(()=>{const o=[],a={};let c;return[...t.value].reverse().forEach(u=>{[...u].reverse().forEach(f=>{if(f)if(f.title)c||(c={tag:"title",children:f.title});else{const l=f.name??f.property;if(l){if(a[l])return;a[l]=!0}o.push({tag:"meta",attrs:{...f}})}})}),c&&o.push(c),o.reverse(),o}),n=_e({select:o=>o.matches.map(a=>a.links).filter(Boolean).flat(1).map(a=>({tag:"link",attrs:{...a}}))}),r=_e({select:o=>{const a=[];return o.matches.map(c=>e.looseRoutesById[c.routeId]).forEach(c=>e.ssr?.manifest?.routes[c.id]?.preloads?.filter(Boolean).forEach(u=>{a.push({tag:"link",attrs:{rel:"modulepreload",href:u}})})),a}}),i=_e({select:o=>o.matches.map(a=>a.headScripts).flat(1).filter(Boolean).map(({children:a,...c})=>({tag:"script",attrs:{...c},children:a}))});return()=>fd([...s.value,...r.value,...n.value,...i.value],o=>JSON.stringify(o))},ud=ve({name:"HeadContent",setup(){const e=ld();return()=>e().map(t=>j(cd,{...t,key:`tsr-meta-${JSON.stringify(t)}`}))}});function fd(e,t){const s=new Set;return e.filter(n=>{const r=t(n);return s.has(r)?!1:(s.add(r),!0)})}const dd="modulepreload",hd=function(e){return"/"+e},po={},ls=function(t,s,n){let r=Promise.resolve();if(s&&s.length>0){let c=function(u){return Promise.all(u.map(f=>Promise.resolve(f).then(l=>({status:"fulfilled",value:l}),l=>({status:"rejected",reason:l}))))};document.getElementsByTagName("link");const o=document.querySelector("meta[property=csp-nonce]"),a=o?.nonce||o?.getAttribute("nonce");r=c(s.map(u=>{if(u=hd(u),u in po)return;po[u]=!0;const f=u.endsWith(".css"),l=f?'[rel="stylesheet"]':"";if(document.querySelector(`link[href="${u}"]${l}`))return;const d=document.createElement("link");if(d.rel=f?"stylesheet":dd,f||(d.as="script"),d.crossOrigin="",d.href=u,a&&d.setAttribute("nonce",a),document.head.appendChild(d),f)return new Promise((h,g)=>{d.addEventListener("load",h),d.addEventListener("error",()=>g(new Error(`Unable to preload CSS for ${u}`)))})}))}function i(o){const a=new Event("vite:preloadError",{cancelable:!0});if(a.payload=o,window.dispatchEvent(a),!a.defaultPrevented)throw o}return r.then(o=>{for(const a of o||[])a.status==="rejected"&&i(a.reason);return t().catch(i)})},pd=ve({name:"NullTanStackRouterDevtools",setup(){return()=>null}}),md=pd,Wt=Vf({component:gd});function gd(){return ce(Fe,null,[ce(ud,null,null),ce(mo,{type:"header"},null),ce("hr",null,null),ce(qa,null,null),ce("hr",null,null),ce(mo,{type:"footer"},null),ce(md,{position:"bottom-right"},null)])}function mo({type:e}){const t=e==="header"?"header":"footer",s=e==="header"?"Head":"Foot";return ce(t,{class:"p-2 flex gap-2 text-lg"},{default:()=>[ce(ho,{to:"/",activeProps:{class:"font-bold"},activeOptions:{exact:!0}},{default:()=>[s,xr("-/")]})," ",[ms({to:"/normal-page"}),ms({to:"/lazy-page"}),ms({to:"/virtual-page"}),ms({to:"/lazy-with-loader-page"}),ms({to:"/page-with-search",search:{where:e}})].map(n=>ce(ho,ri(n,{activeProps:{class:"font-bold"}}),{default:()=>[s,xr("-"),n.to]}))]})}const vd=()=>ls(()=>import("./index-rPfEOKs3.js"),[]),yd=cs("/")({component:vi(vd,"component")});var re;(function(e){e.assertEqual=r=>{};function t(r){}e.assertIs=t;function s(r){throw new Error}e.assertNever=s,e.arrayToEnum=r=>{const i={};for(const o of r)i[o]=o;return i},e.getValidEnumValues=r=>{const i=e.objectKeys(r).filter(a=>typeof r[r[a]]!="number"),o={};for(const a of i)o[a]=r[a];return e.objectValues(o)},e.objectValues=r=>e.objectKeys(r).map(function(i){return r[i]}),e.objectKeys=typeof Object.keys=="function"?r=>Object.keys(r):r=>{const i=[];for(const o in r)Object.prototype.hasOwnProperty.call(r,o)&&i.push(o);return i},e.find=(r,i)=>{for(const o of r)if(i(o))return o},e.isInteger=typeof Number.isInteger=="function"?r=>Number.isInteger(r):r=>typeof r=="number"&&Number.isFinite(r)&&Math.floor(r)===r;function n(r,i=" | "){return r.map(o=>typeof o=="string"?`'${o}'`:o).join(i)}e.joinValues=n,e.jsonStringifyReplacer=(r,i)=>typeof i=="bigint"?i.toString():i})(re||(re={}));var go;(function(e){e.mergeShapes=(t,s)=>({...t,...s})})(go||(go={}));const V=re.arrayToEnum(["string","nan","number","integer","float","boolean","date","bigint","symbol","function","undefined","null","array","object","unknown","promise","void","never","map","set"]),gt=e=>{switch(typeof e){case"undefined":return V.undefined;case"string":return V.string;case"number":return Number.isNaN(e)?V.nan:V.number;case"boolean":return V.boolean;case"function":return V.function;case"bigint":return V.bigint;case"symbol":return V.symbol;case"object":return Array.isArray(e)?V.array:e===null?V.null:e.then&&typeof e.then=="function"&&e.catch&&typeof e.catch=="function"?V.promise:typeof Map<"u"&&e instanceof Map?V.map:typeof Set<"u"&&e instanceof Set?V.set:typeof Date<"u"&&e instanceof Date?V.date:V.object;default:return V.unknown}},I=re.arrayToEnum(["invalid_type","invalid_literal","custom","invalid_union","invalid_union_discriminator","invalid_enum_value","unrecognized_keys","invalid_arguments","invalid_return_type","invalid_date","invalid_string","too_small","too_big","invalid_intersection_types","not_multiple_of","not_finite"]);class ft extends Error{get errors(){return this.issues}constructor(t){super(),this.issues=[],this.addIssue=n=>{this.issues=[...this.issues,n]},this.addIssues=(n=[])=>{this.issues=[...this.issues,...n]};const s=new.target.prototype;Object.setPrototypeOf?Object.setPrototypeOf(this,s):this.__proto__=s,this.name="ZodError",this.issues=t}format(t){const s=t||function(i){return i.message},n={_errors:[]},r=i=>{for(const o of i.issues)if(o.code==="invalid_union")o.unionErrors.map(r);else if(o.code==="invalid_return_type")r(o.returnTypeError);else if(o.code==="invalid_arguments")r(o.argumentsError);else if(o.path.length===0)n._errors.push(s(o));else{let a=n,c=0;for(;cs.message){const s={},n=[];for(const r of this.issues)r.path.length>0?(s[r.path[0]]=s[r.path[0]]||[],s[r.path[0]].push(t(r))):n.push(t(r));return{formErrors:n,fieldErrors:s}}get formErrors(){return this.flatten()}}ft.create=e=>new ft(e);const Tr=(e,t)=>{let s;switch(e.code){case I.invalid_type:e.received===V.undefined?s="Required":s=`Expected ${e.expected}, received ${e.received}`;break;case I.invalid_literal:s=`Invalid literal value, expected ${JSON.stringify(e.expected,re.jsonStringifyReplacer)}`;break;case I.unrecognized_keys:s=`Unrecognized key(s) in object: ${re.joinValues(e.keys,", ")}`;break;case I.invalid_union:s="Invalid input";break;case I.invalid_union_discriminator:s=`Invalid discriminator value. Expected ${re.joinValues(e.options)}`;break;case I.invalid_enum_value:s=`Invalid enum value. Expected ${re.joinValues(e.options)}, received '${e.received}'`;break;case I.invalid_arguments:s="Invalid function arguments";break;case I.invalid_return_type:s="Invalid function return type";break;case I.invalid_date:s="Invalid date";break;case I.invalid_string:typeof e.validation=="object"?"includes"in e.validation?(s=`Invalid input: must include "${e.validation.includes}"`,typeof e.validation.position=="number"&&(s=`${s} at one or more positions greater than or equal to ${e.validation.position}`)):"startsWith"in e.validation?s=`Invalid input: must start with "${e.validation.startsWith}"`:"endsWith"in e.validation?s=`Invalid input: must end with "${e.validation.endsWith}"`:re.assertNever(e.validation):e.validation!=="regex"?s=`Invalid ${e.validation}`:s="Invalid";break;case I.too_small:e.type==="array"?s=`Array must contain ${e.exact?"exactly":e.inclusive?"at least":"more than"} ${e.minimum} element(s)`:e.type==="string"?s=`String must contain ${e.exact?"exactly":e.inclusive?"at least":"over"} ${e.minimum} character(s)`:e.type==="number"?s=`Number must be ${e.exact?"exactly equal to ":e.inclusive?"greater than or equal to ":"greater than "}${e.minimum}`:e.type==="date"?s=`Date must be ${e.exact?"exactly equal to ":e.inclusive?"greater than or equal to ":"greater than "}${new Date(Number(e.minimum))}`:s="Invalid input";break;case I.too_big:e.type==="array"?s=`Array must contain ${e.exact?"exactly":e.inclusive?"at most":"less than"} ${e.maximum} element(s)`:e.type==="string"?s=`String must contain ${e.exact?"exactly":e.inclusive?"at most":"under"} ${e.maximum} character(s)`:e.type==="number"?s=`Number must be ${e.exact?"exactly":e.inclusive?"less than or equal to":"less than"} ${e.maximum}`:e.type==="bigint"?s=`BigInt must be ${e.exact?"exactly":e.inclusive?"less than or equal to":"less than"} ${e.maximum}`:e.type==="date"?s=`Date must be ${e.exact?"exactly":e.inclusive?"smaller than or equal to":"smaller than"} ${new Date(Number(e.maximum))}`:s="Invalid input";break;case I.custom:s="Invalid input";break;case I.invalid_intersection_types:s="Intersection results could not be merged";break;case I.not_multiple_of:s=`Number must be a multiple of ${e.multipleOf}`;break;case I.not_finite:s="Number must be finite";break;default:s=t.defaultError,re.assertNever(e)}return{message:s}};let _d=Tr;function bd(){return _d}const xd=e=>{const{data:t,path:s,errorMaps:n,issueData:r}=e,i=[...s,...r.path||[]],o={...r,path:i};if(r.message!==void 0)return{...r,path:i,message:r.message};let a="";const c=n.filter(u=>!!u).slice().reverse();for(const u of c)a=u(o,{data:t,defaultError:a}).message;return{...r,path:i,message:a}};function N(e,t){const s=bd(),n=xd({issueData:t,data:e.data,path:e.path,errorMaps:[e.common.contextualErrorMap,e.schemaErrorMap,s,s===Tr?void 0:Tr].filter(r=>!!r)});e.common.issues.push(n)}class Ae{constructor(){this.value="valid"}dirty(){this.value==="valid"&&(this.value="dirty")}abort(){this.value!=="aborted"&&(this.value="aborted")}static mergeArray(t,s){const n=[];for(const r of s){if(r.status==="aborted")return q;r.status==="dirty"&&t.dirty(),n.push(r.value)}return{status:t.value,value:n}}static async mergeObjectAsync(t,s){const n=[];for(const r of s){const i=await r.key,o=await r.value;n.push({key:i,value:o})}return Ae.mergeObjectSync(t,n)}static mergeObjectSync(t,s){const n={};for(const r of s){const{key:i,value:o}=r;if(i.status==="aborted"||o.status==="aborted")return q;i.status==="dirty"&&t.dirty(),o.status==="dirty"&&t.dirty(),i.value!=="__proto__"&&(typeof o.value<"u"||r.alwaysSet)&&(n[i.value]=o.value)}return{status:t.value,value:n}}}const q=Object.freeze({status:"aborted"}),ys=e=>({status:"dirty",value:e}),Be=e=>({status:"valid",value:e}),vo=e=>e.status==="aborted",yo=e=>e.status==="dirty",ns=e=>e.status==="valid",Rn=e=>typeof Promise<"u"&&e instanceof Promise;var U;(function(e){e.errToObj=t=>typeof t=="string"?{message:t}:t||{},e.toString=t=>typeof t=="string"?t:t?.message})(U||(U={}));class It{constructor(t,s,n,r){this._cachedPath=[],this.parent=t,this.data=s,this._path=n,this._key=r}get path(){return this._cachedPath.length||(Array.isArray(this._key)?this._cachedPath.push(...this._path,...this._key):this._cachedPath.push(...this._path,this._key)),this._cachedPath}}const _o=(e,t)=>{if(ns(t))return{success:!0,data:t.value};if(!e.common.issues.length)throw new Error("Validation failed but no issues detected.");return{success:!1,get error(){if(this._error)return this._error;const s=new ft(e.common.issues);return this._error=s,this._error}}};function ee(e){if(!e)return{};const{errorMap:t,invalid_type_error:s,required_error:n,description:r}=e;if(t&&(s||n))throw new Error(`Can't use "invalid_type_error" or "required_error" in conjunction with custom error map.`);return t?{errorMap:t,description:r}:{errorMap:(o,a)=>{const{message:c}=e;return o.code==="invalid_enum_value"?{message:c??a.defaultError}:typeof a.data>"u"?{message:c??n??a.defaultError}:o.code!=="invalid_type"?{message:a.defaultError}:{message:c??s??a.defaultError}},description:r}}class ne{get description(){return this._def.description}_getType(t){return gt(t.data)}_getOrReturnCtx(t,s){return s||{common:t.parent.common,data:t.data,parsedType:gt(t.data),schemaErrorMap:this._def.errorMap,path:t.path,parent:t.parent}}_processInputParams(t){return{status:new Ae,ctx:{common:t.parent.common,data:t.data,parsedType:gt(t.data),schemaErrorMap:this._def.errorMap,path:t.path,parent:t.parent}}}_parseSync(t){const s=this._parse(t);if(Rn(s))throw new Error("Synchronous parse encountered promise.");return s}_parseAsync(t){const s=this._parse(t);return Promise.resolve(s)}parse(t,s){const n=this.safeParse(t,s);if(n.success)return n.data;throw n.error}safeParse(t,s){const n={common:{issues:[],async:s?.async??!1,contextualErrorMap:s?.errorMap},path:s?.path||[],schemaErrorMap:this._def.errorMap,parent:null,data:t,parsedType:gt(t)},r=this._parseSync({data:t,path:n.path,parent:n});return _o(n,r)}"~validate"(t){const s={common:{issues:[],async:!!this["~standard"].async},path:[],schemaErrorMap:this._def.errorMap,parent:null,data:t,parsedType:gt(t)};if(!this["~standard"].async)try{const n=this._parseSync({data:t,path:[],parent:s});return ns(n)?{value:n.value}:{issues:s.common.issues}}catch(n){n?.message?.toLowerCase()?.includes("encountered")&&(this["~standard"].async=!0),s.common={issues:[],async:!0}}return this._parseAsync({data:t,path:[],parent:s}).then(n=>ns(n)?{value:n.value}:{issues:s.common.issues})}async parseAsync(t,s){const n=await this.safeParseAsync(t,s);if(n.success)return n.data;throw n.error}async safeParseAsync(t,s){const n={common:{issues:[],contextualErrorMap:s?.errorMap,async:!0},path:s?.path||[],schemaErrorMap:this._def.errorMap,parent:null,data:t,parsedType:gt(t)},r=this._parse({data:t,path:n.path,parent:n}),i=await(Rn(r)?r:Promise.resolve(r));return _o(n,i)}refine(t,s){const n=r=>typeof s=="string"||typeof s>"u"?{message:s}:typeof s=="function"?s(r):s;return this._refinement((r,i)=>{const o=t(r),a=()=>i.addIssue({code:I.custom,...n(r)});return typeof Promise<"u"&&o instanceof Promise?o.then(c=>c?!0:(a(),!1)):o?!0:(a(),!1)})}refinement(t,s){return this._refinement((n,r)=>t(n)?!0:(r.addIssue(typeof s=="function"?s(n,r):s),!1))}_refinement(t){return new is({schema:this,typeName:G.ZodEffects,effect:{type:"refinement",refinement:t}})}superRefine(t){return this._refinement(t)}constructor(t){this.spa=this.safeParseAsync,this._def=t,this.parse=this.parse.bind(this),this.safeParse=this.safeParse.bind(this),this.parseAsync=this.parseAsync.bind(this),this.safeParseAsync=this.safeParseAsync.bind(this),this.spa=this.spa.bind(this),this.refine=this.refine.bind(this),this.refinement=this.refinement.bind(this),this.superRefine=this.superRefine.bind(this),this.optional=this.optional.bind(this),this.nullable=this.nullable.bind(this),this.nullish=this.nullish.bind(this),this.array=this.array.bind(this),this.promise=this.promise.bind(this),this.or=this.or.bind(this),this.and=this.and.bind(this),this.transform=this.transform.bind(this),this.brand=this.brand.bind(this),this.default=this.default.bind(this),this.catch=this.catch.bind(this),this.describe=this.describe.bind(this),this.pipe=this.pipe.bind(this),this.readonly=this.readonly.bind(this),this.isNullable=this.isNullable.bind(this),this.isOptional=this.isOptional.bind(this),this["~standard"]={version:1,vendor:"zod",validate:s=>this["~validate"](s)}}optional(){return Ct.create(this,this._def)}nullable(){return os.create(this,this._def)}nullish(){return this.nullable().optional()}array(){return et.create(this)}promise(){return Tn.create(this,this._def)}or(t){return Pn.create([this,t],this._def)}and(t){return kn.create(this,t,this._def)}transform(t){return new is({...ee(this._def),schema:this,typeName:G.ZodEffects,effect:{type:"transform",transform:t}})}default(t){const s=typeof t=="function"?t:()=>t;return new Lr({...ee(this._def),innerType:this,defaultValue:s,typeName:G.ZodDefault})}brand(){return new Zd({typeName:G.ZodBranded,type:this,...ee(this._def)})}catch(t){const s=typeof t=="function"?t:()=>t;return new Mr({...ee(this._def),innerType:this,catchValue:s,typeName:G.ZodCatch})}describe(t){const s=this.constructor;return new s({...this._def,description:t})}pipe(t){return yi.create(this,t)}readonly(){return Er.create(this)}isOptional(){return this.safeParse(void 0).success}isNullable(){return this.safeParse(null).success}}const wd=/^c[^\s-]{8,}$/i,Sd=/^[0-9a-z]+$/,Rd=/^[0-9A-HJKMNP-TV-Z]{26}$/i,Cd=/^[0-9a-fA-F]{8}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{12}$/i,Pd=/^[a-z0-9_-]{21}$/i,kd=/^[A-Za-z0-9-_]+\.[A-Za-z0-9-_]+\.[A-Za-z0-9-_]*$/,Td=/^[-+]?P(?!$)(?:(?:[-+]?\d+Y)|(?:[-+]?\d+[.,]\d+Y$))?(?:(?:[-+]?\d+M)|(?:[-+]?\d+[.,]\d+M$))?(?:(?:[-+]?\d+W)|(?:[-+]?\d+[.,]\d+W$))?(?:(?:[-+]?\d+D)|(?:[-+]?\d+[.,]\d+D$))?(?:T(?=[\d+-])(?:(?:[-+]?\d+H)|(?:[-+]?\d+[.,]\d+H$))?(?:(?:[-+]?\d+M)|(?:[-+]?\d+[.,]\d+M$))?(?:[-+]?\d+(?:[.,]\d+)?S)?)??$/,Id=/^(?!\.)(?!.*\.\.)([A-Z0-9_'+\-\.]*)[A-Z0-9_+-]@([A-Z0-9][A-Z0-9\-]*\.)+[A-Z]{2,}$/i,Ld="^(\\p{Extended_Pictographic}|\\p{Emoji_Component})+$";let cr;const Md=/^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])$/,Ed=/^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\/(3[0-2]|[12]?[0-9])$/,Od=/^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))$/,Ad=/^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))\/(12[0-8]|1[01][0-9]|[1-9]?[0-9])$/,Nd=/^([0-9a-zA-Z+/]{4})*(([0-9a-zA-Z+/]{2}==)|([0-9a-zA-Z+/]{3}=))?$/,Fd=/^([0-9a-zA-Z-_]{4})*(([0-9a-zA-Z-_]{2}(==)?)|([0-9a-zA-Z-_]{3}(=)?))?$/,Ga="((\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-((0[13578]|1[02])-(0[1-9]|[12]\\d|3[01])|(0[469]|11)-(0[1-9]|[12]\\d|30)|(02)-(0[1-9]|1\\d|2[0-8])))",$d=new RegExp(`^${Ga}$`);function Ja(e){let t="[0-5]\\d";e.precision?t=`${t}\\.\\d{${e.precision}}`:e.precision==null&&(t=`${t}(\\.\\d+)?`);const s=e.precision?"+":"?";return`([01]\\d|2[0-3]):[0-5]\\d(:${t})${s}`}function Bd(e){return new RegExp(`^${Ja(e)}$`)}function jd(e){let t=`${Ga}T${Ja(e)}`;const s=[];return s.push(e.local?"Z?":"Z"),e.offset&&s.push("([+-]\\d{2}:?\\d{2})"),t=`${t}(${s.join("|")})`,new RegExp(`^${t}$`)}function Dd(e,t){return!!((t==="v4"||!t)&&Md.test(e)||(t==="v6"||!t)&&Od.test(e))}function Vd(e,t){if(!kd.test(e))return!1;try{const[s]=e.split("."),n=s.replace(/-/g,"+").replace(/_/g,"/").padEnd(s.length+(4-s.length%4)%4,"="),r=JSON.parse(atob(n));return!(typeof r!="object"||r===null||"typ"in r&&r?.typ!=="JWT"||!r.alg||t&&r.alg!==t)}catch{return!1}}function Ud(e,t){return!!((t==="v4"||!t)&&Ed.test(e)||(t==="v6"||!t)&&Ad.test(e))}class bt extends ne{_parse(t){if(this._def.coerce&&(t.data=String(t.data)),this._getType(t)!==V.string){const i=this._getOrReturnCtx(t);return N(i,{code:I.invalid_type,expected:V.string,received:i.parsedType}),q}const n=new Ae;let r;for(const i of this._def.checks)if(i.kind==="min")t.data.lengthi.value&&(r=this._getOrReturnCtx(t,r),N(r,{code:I.too_big,maximum:i.value,type:"string",inclusive:!0,exact:!1,message:i.message}),n.dirty());else if(i.kind==="length"){const o=t.data.length>i.value,a=t.data.lengtht.test(r),{validation:s,code:I.invalid_string,...U.errToObj(n)})}_addCheck(t){return new bt({...this._def,checks:[...this._def.checks,t]})}email(t){return this._addCheck({kind:"email",...U.errToObj(t)})}url(t){return this._addCheck({kind:"url",...U.errToObj(t)})}emoji(t){return this._addCheck({kind:"emoji",...U.errToObj(t)})}uuid(t){return this._addCheck({kind:"uuid",...U.errToObj(t)})}nanoid(t){return this._addCheck({kind:"nanoid",...U.errToObj(t)})}cuid(t){return this._addCheck({kind:"cuid",...U.errToObj(t)})}cuid2(t){return this._addCheck({kind:"cuid2",...U.errToObj(t)})}ulid(t){return this._addCheck({kind:"ulid",...U.errToObj(t)})}base64(t){return this._addCheck({kind:"base64",...U.errToObj(t)})}base64url(t){return this._addCheck({kind:"base64url",...U.errToObj(t)})}jwt(t){return this._addCheck({kind:"jwt",...U.errToObj(t)})}ip(t){return this._addCheck({kind:"ip",...U.errToObj(t)})}cidr(t){return this._addCheck({kind:"cidr",...U.errToObj(t)})}datetime(t){return typeof t=="string"?this._addCheck({kind:"datetime",precision:null,offset:!1,local:!1,message:t}):this._addCheck({kind:"datetime",precision:typeof t?.precision>"u"?null:t?.precision,offset:t?.offset??!1,local:t?.local??!1,...U.errToObj(t?.message)})}date(t){return this._addCheck({kind:"date",message:t})}time(t){return typeof t=="string"?this._addCheck({kind:"time",precision:null,message:t}):this._addCheck({kind:"time",precision:typeof t?.precision>"u"?null:t?.precision,...U.errToObj(t?.message)})}duration(t){return this._addCheck({kind:"duration",...U.errToObj(t)})}regex(t,s){return this._addCheck({kind:"regex",regex:t,...U.errToObj(s)})}includes(t,s){return this._addCheck({kind:"includes",value:t,position:s?.position,...U.errToObj(s?.message)})}startsWith(t,s){return this._addCheck({kind:"startsWith",value:t,...U.errToObj(s)})}endsWith(t,s){return this._addCheck({kind:"endsWith",value:t,...U.errToObj(s)})}min(t,s){return this._addCheck({kind:"min",value:t,...U.errToObj(s)})}max(t,s){return this._addCheck({kind:"max",value:t,...U.errToObj(s)})}length(t,s){return this._addCheck({kind:"length",value:t,...U.errToObj(s)})}nonempty(t){return this.min(1,U.errToObj(t))}trim(){return new bt({...this._def,checks:[...this._def.checks,{kind:"trim"}]})}toLowerCase(){return new bt({...this._def,checks:[...this._def.checks,{kind:"toLowerCase"}]})}toUpperCase(){return new bt({...this._def,checks:[...this._def.checks,{kind:"toUpperCase"}]})}get isDatetime(){return!!this._def.checks.find(t=>t.kind==="datetime")}get isDate(){return!!this._def.checks.find(t=>t.kind==="date")}get isTime(){return!!this._def.checks.find(t=>t.kind==="time")}get isDuration(){return!!this._def.checks.find(t=>t.kind==="duration")}get isEmail(){return!!this._def.checks.find(t=>t.kind==="email")}get isURL(){return!!this._def.checks.find(t=>t.kind==="url")}get isEmoji(){return!!this._def.checks.find(t=>t.kind==="emoji")}get isUUID(){return!!this._def.checks.find(t=>t.kind==="uuid")}get isNANOID(){return!!this._def.checks.find(t=>t.kind==="nanoid")}get isCUID(){return!!this._def.checks.find(t=>t.kind==="cuid")}get isCUID2(){return!!this._def.checks.find(t=>t.kind==="cuid2")}get isULID(){return!!this._def.checks.find(t=>t.kind==="ulid")}get isIP(){return!!this._def.checks.find(t=>t.kind==="ip")}get isCIDR(){return!!this._def.checks.find(t=>t.kind==="cidr")}get isBase64(){return!!this._def.checks.find(t=>t.kind==="base64")}get isBase64url(){return!!this._def.checks.find(t=>t.kind==="base64url")}get minLength(){let t=null;for(const s of this._def.checks)s.kind==="min"&&(t===null||s.value>t)&&(t=s.value);return t}get maxLength(){let t=null;for(const s of this._def.checks)s.kind==="max"&&(t===null||s.valuenew bt({checks:[],typeName:G.ZodString,coerce:e?.coerce??!1,...ee(e)});function Hd(e,t){const s=(e.toString().split(".")[1]||"").length,n=(t.toString().split(".")[1]||"").length,r=s>n?s:n,i=Number.parseInt(e.toFixed(r).replace(".","")),o=Number.parseInt(t.toFixed(r).replace(".",""));return i%o/10**r}class Vs extends ne{constructor(){super(...arguments),this.min=this.gte,this.max=this.lte,this.step=this.multipleOf}_parse(t){if(this._def.coerce&&(t.data=Number(t.data)),this._getType(t)!==V.number){const i=this._getOrReturnCtx(t);return N(i,{code:I.invalid_type,expected:V.number,received:i.parsedType}),q}let n;const r=new Ae;for(const i of this._def.checks)i.kind==="int"?re.isInteger(t.data)||(n=this._getOrReturnCtx(t,n),N(n,{code:I.invalid_type,expected:"integer",received:"float",message:i.message}),r.dirty()):i.kind==="min"?(i.inclusive?t.datai.value:t.data>=i.value)&&(n=this._getOrReturnCtx(t,n),N(n,{code:I.too_big,maximum:i.value,type:"number",inclusive:i.inclusive,exact:!1,message:i.message}),r.dirty()):i.kind==="multipleOf"?Hd(t.data,i.value)!==0&&(n=this._getOrReturnCtx(t,n),N(n,{code:I.not_multiple_of,multipleOf:i.value,message:i.message}),r.dirty()):i.kind==="finite"?Number.isFinite(t.data)||(n=this._getOrReturnCtx(t,n),N(n,{code:I.not_finite,message:i.message}),r.dirty()):re.assertNever(i);return{status:r.value,value:t.data}}gte(t,s){return this.setLimit("min",t,!0,U.toString(s))}gt(t,s){return this.setLimit("min",t,!1,U.toString(s))}lte(t,s){return this.setLimit("max",t,!0,U.toString(s))}lt(t,s){return this.setLimit("max",t,!1,U.toString(s))}setLimit(t,s,n,r){return new Vs({...this._def,checks:[...this._def.checks,{kind:t,value:s,inclusive:n,message:U.toString(r)}]})}_addCheck(t){return new Vs({...this._def,checks:[...this._def.checks,t]})}int(t){return this._addCheck({kind:"int",message:U.toString(t)})}positive(t){return this._addCheck({kind:"min",value:0,inclusive:!1,message:U.toString(t)})}negative(t){return this._addCheck({kind:"max",value:0,inclusive:!1,message:U.toString(t)})}nonpositive(t){return this._addCheck({kind:"max",value:0,inclusive:!0,message:U.toString(t)})}nonnegative(t){return this._addCheck({kind:"min",value:0,inclusive:!0,message:U.toString(t)})}multipleOf(t,s){return this._addCheck({kind:"multipleOf",value:t,message:U.toString(s)})}finite(t){return this._addCheck({kind:"finite",message:U.toString(t)})}safe(t){return this._addCheck({kind:"min",inclusive:!0,value:Number.MIN_SAFE_INTEGER,message:U.toString(t)})._addCheck({kind:"max",inclusive:!0,value:Number.MAX_SAFE_INTEGER,message:U.toString(t)})}get minValue(){let t=null;for(const s of this._def.checks)s.kind==="min"&&(t===null||s.value>t)&&(t=s.value);return t}get maxValue(){let t=null;for(const s of this._def.checks)s.kind==="max"&&(t===null||s.valuet.kind==="int"||t.kind==="multipleOf"&&re.isInteger(t.value))}get isFinite(){let t=null,s=null;for(const n of this._def.checks){if(n.kind==="finite"||n.kind==="int"||n.kind==="multipleOf")return!0;n.kind==="min"?(s===null||n.value>s)&&(s=n.value):n.kind==="max"&&(t===null||n.valuenew Vs({checks:[],typeName:G.ZodNumber,coerce:e?.coerce||!1,...ee(e)});class Us extends ne{constructor(){super(...arguments),this.min=this.gte,this.max=this.lte}_parse(t){if(this._def.coerce)try{t.data=BigInt(t.data)}catch{return this._getInvalidInput(t)}if(this._getType(t)!==V.bigint)return this._getInvalidInput(t);let n;const r=new Ae;for(const i of this._def.checks)i.kind==="min"?(i.inclusive?t.datai.value:t.data>=i.value)&&(n=this._getOrReturnCtx(t,n),N(n,{code:I.too_big,type:"bigint",maximum:i.value,inclusive:i.inclusive,message:i.message}),r.dirty()):i.kind==="multipleOf"?t.data%i.value!==BigInt(0)&&(n=this._getOrReturnCtx(t,n),N(n,{code:I.not_multiple_of,multipleOf:i.value,message:i.message}),r.dirty()):re.assertNever(i);return{status:r.value,value:t.data}}_getInvalidInput(t){const s=this._getOrReturnCtx(t);return N(s,{code:I.invalid_type,expected:V.bigint,received:s.parsedType}),q}gte(t,s){return this.setLimit("min",t,!0,U.toString(s))}gt(t,s){return this.setLimit("min",t,!1,U.toString(s))}lte(t,s){return this.setLimit("max",t,!0,U.toString(s))}lt(t,s){return this.setLimit("max",t,!1,U.toString(s))}setLimit(t,s,n,r){return new Us({...this._def,checks:[...this._def.checks,{kind:t,value:s,inclusive:n,message:U.toString(r)}]})}_addCheck(t){return new Us({...this._def,checks:[...this._def.checks,t]})}positive(t){return this._addCheck({kind:"min",value:BigInt(0),inclusive:!1,message:U.toString(t)})}negative(t){return this._addCheck({kind:"max",value:BigInt(0),inclusive:!1,message:U.toString(t)})}nonpositive(t){return this._addCheck({kind:"max",value:BigInt(0),inclusive:!0,message:U.toString(t)})}nonnegative(t){return this._addCheck({kind:"min",value:BigInt(0),inclusive:!0,message:U.toString(t)})}multipleOf(t,s){return this._addCheck({kind:"multipleOf",value:t,message:U.toString(s)})}get minValue(){let t=null;for(const s of this._def.checks)s.kind==="min"&&(t===null||s.value>t)&&(t=s.value);return t}get maxValue(){let t=null;for(const s of this._def.checks)s.kind==="max"&&(t===null||s.valuenew Us({checks:[],typeName:G.ZodBigInt,coerce:e?.coerce??!1,...ee(e)});class bo extends ne{_parse(t){if(this._def.coerce&&(t.data=!!t.data),this._getType(t)!==V.boolean){const n=this._getOrReturnCtx(t);return N(n,{code:I.invalid_type,expected:V.boolean,received:n.parsedType}),q}return Be(t.data)}}bo.create=e=>new bo({typeName:G.ZodBoolean,coerce:e?.coerce||!1,...ee(e)});class Cn extends ne{_parse(t){if(this._def.coerce&&(t.data=new Date(t.data)),this._getType(t)!==V.date){const i=this._getOrReturnCtx(t);return N(i,{code:I.invalid_type,expected:V.date,received:i.parsedType}),q}if(Number.isNaN(t.data.getTime())){const i=this._getOrReturnCtx(t);return N(i,{code:I.invalid_date}),q}const n=new Ae;let r;for(const i of this._def.checks)i.kind==="min"?t.data.getTime()i.value&&(r=this._getOrReturnCtx(t,r),N(r,{code:I.too_big,message:i.message,inclusive:!0,exact:!1,maximum:i.value,type:"date"}),n.dirty()):re.assertNever(i);return{status:n.value,value:new Date(t.data.getTime())}}_addCheck(t){return new Cn({...this._def,checks:[...this._def.checks,t]})}min(t,s){return this._addCheck({kind:"min",value:t.getTime(),message:U.toString(s)})}max(t,s){return this._addCheck({kind:"max",value:t.getTime(),message:U.toString(s)})}get minDate(){let t=null;for(const s of this._def.checks)s.kind==="min"&&(t===null||s.value>t)&&(t=s.value);return t!=null?new Date(t):null}get maxDate(){let t=null;for(const s of this._def.checks)s.kind==="max"&&(t===null||s.valuenew Cn({checks:[],coerce:e?.coerce||!1,typeName:G.ZodDate,...ee(e)});class xo extends ne{_parse(t){if(this._getType(t)!==V.symbol){const n=this._getOrReturnCtx(t);return N(n,{code:I.invalid_type,expected:V.symbol,received:n.parsedType}),q}return Be(t.data)}}xo.create=e=>new xo({typeName:G.ZodSymbol,...ee(e)});class wo extends ne{_parse(t){if(this._getType(t)!==V.undefined){const n=this._getOrReturnCtx(t);return N(n,{code:I.invalid_type,expected:V.undefined,received:n.parsedType}),q}return Be(t.data)}}wo.create=e=>new wo({typeName:G.ZodUndefined,...ee(e)});class So extends ne{_parse(t){if(this._getType(t)!==V.null){const n=this._getOrReturnCtx(t);return N(n,{code:I.invalid_type,expected:V.null,received:n.parsedType}),q}return Be(t.data)}}So.create=e=>new So({typeName:G.ZodNull,...ee(e)});class Ro extends ne{constructor(){super(...arguments),this._any=!0}_parse(t){return Be(t.data)}}Ro.create=e=>new Ro({typeName:G.ZodAny,...ee(e)});class Co extends ne{constructor(){super(...arguments),this._unknown=!0}_parse(t){return Be(t.data)}}Co.create=e=>new Co({typeName:G.ZodUnknown,...ee(e)});class Lt extends ne{_parse(t){const s=this._getOrReturnCtx(t);return N(s,{code:I.invalid_type,expected:V.never,received:s.parsedType}),q}}Lt.create=e=>new Lt({typeName:G.ZodNever,...ee(e)});class Po extends ne{_parse(t){if(this._getType(t)!==V.undefined){const n=this._getOrReturnCtx(t);return N(n,{code:I.invalid_type,expected:V.void,received:n.parsedType}),q}return Be(t.data)}}Po.create=e=>new Po({typeName:G.ZodVoid,...ee(e)});class et extends ne{_parse(t){const{ctx:s,status:n}=this._processInputParams(t),r=this._def;if(s.parsedType!==V.array)return N(s,{code:I.invalid_type,expected:V.array,received:s.parsedType}),q;if(r.exactLength!==null){const o=s.data.length>r.exactLength.value,a=s.data.lengthr.maxLength.value&&(N(s,{code:I.too_big,maximum:r.maxLength.value,type:"array",inclusive:!0,exact:!1,message:r.maxLength.message}),n.dirty()),s.common.async)return Promise.all([...s.data].map((o,a)=>r.type._parseAsync(new It(s,o,s.path,a)))).then(o=>Ae.mergeArray(n,o));const i=[...s.data].map((o,a)=>r.type._parseSync(new It(s,o,s.path,a)));return Ae.mergeArray(n,i)}get element(){return this._def.type}min(t,s){return new et({...this._def,minLength:{value:t,message:U.toString(s)}})}max(t,s){return new et({...this._def,maxLength:{value:t,message:U.toString(s)}})}length(t,s){return new et({...this._def,exactLength:{value:t,message:U.toString(s)}})}nonempty(t){return this.min(1,t)}}et.create=(e,t)=>new et({type:e,minLength:null,maxLength:null,exactLength:null,typeName:G.ZodArray,...ee(t)});function qt(e){if(e instanceof ye){const t={};for(const s in e.shape){const n=e.shape[s];t[s]=Ct.create(qt(n))}return new ye({...e._def,shape:()=>t})}else return e instanceof et?new et({...e._def,type:qt(e.element)}):e instanceof Ct?Ct.create(qt(e.unwrap())):e instanceof os?os.create(qt(e.unwrap())):e instanceof Ht?Ht.create(e.items.map(t=>qt(t))):e}class ye extends ne{constructor(){super(...arguments),this._cached=null,this.nonstrict=this.passthrough,this.augment=this.extend}_getCached(){if(this._cached!==null)return this._cached;const t=this._def.shape(),s=re.objectKeys(t);return this._cached={shape:t,keys:s},this._cached}_parse(t){if(this._getType(t)!==V.object){const u=this._getOrReturnCtx(t);return N(u,{code:I.invalid_type,expected:V.object,received:u.parsedType}),q}const{status:n,ctx:r}=this._processInputParams(t),{shape:i,keys:o}=this._getCached(),a=[];if(!(this._def.catchall instanceof Lt&&this._def.unknownKeys==="strip"))for(const u in r.data)o.includes(u)||a.push(u);const c=[];for(const u of o){const f=i[u],l=r.data[u];c.push({key:{status:"valid",value:u},value:f._parse(new It(r,l,r.path,u)),alwaysSet:u in r.data})}if(this._def.catchall instanceof Lt){const u=this._def.unknownKeys;if(u==="passthrough")for(const f of a)c.push({key:{status:"valid",value:f},value:{status:"valid",value:r.data[f]}});else if(u==="strict")a.length>0&&(N(r,{code:I.unrecognized_keys,keys:a}),n.dirty());else if(u!=="strip")throw new Error("Internal ZodObject error: invalid unknownKeys value.")}else{const u=this._def.catchall;for(const f of a){const l=r.data[f];c.push({key:{status:"valid",value:f},value:u._parse(new It(r,l,r.path,f)),alwaysSet:f in r.data})}}return r.common.async?Promise.resolve().then(async()=>{const u=[];for(const f of c){const l=await f.key,d=await f.value;u.push({key:l,value:d,alwaysSet:f.alwaysSet})}return u}).then(u=>Ae.mergeObjectSync(n,u)):Ae.mergeObjectSync(n,c)}get shape(){return this._def.shape()}strict(t){return U.errToObj,new ye({...this._def,unknownKeys:"strict",...t!==void 0?{errorMap:(s,n)=>{const r=this._def.errorMap?.(s,n).message??n.defaultError;return s.code==="unrecognized_keys"?{message:U.errToObj(t).message??r}:{message:r}}}:{}})}strip(){return new ye({...this._def,unknownKeys:"strip"})}passthrough(){return new ye({...this._def,unknownKeys:"passthrough"})}extend(t){return new ye({...this._def,shape:()=>({...this._def.shape(),...t})})}merge(t){return new ye({unknownKeys:t._def.unknownKeys,catchall:t._def.catchall,shape:()=>({...this._def.shape(),...t._def.shape()}),typeName:G.ZodObject})}setKey(t,s){return this.augment({[t]:s})}catchall(t){return new ye({...this._def,catchall:t})}pick(t){const s={};for(const n of re.objectKeys(t))t[n]&&this.shape[n]&&(s[n]=this.shape[n]);return new ye({...this._def,shape:()=>s})}omit(t){const s={};for(const n of re.objectKeys(this.shape))t[n]||(s[n]=this.shape[n]);return new ye({...this._def,shape:()=>s})}deepPartial(){return qt(this)}partial(t){const s={};for(const n of re.objectKeys(this.shape)){const r=this.shape[n];t&&!t[n]?s[n]=r:s[n]=r.optional()}return new ye({...this._def,shape:()=>s})}required(t){const s={};for(const n of re.objectKeys(this.shape))if(t&&!t[n])s[n]=this.shape[n];else{let i=this.shape[n];for(;i instanceof Ct;)i=i._def.innerType;s[n]=i}return new ye({...this._def,shape:()=>s})}keyof(){return Ya(re.objectKeys(this.shape))}}ye.create=(e,t)=>new ye({shape:()=>e,unknownKeys:"strip",catchall:Lt.create(),typeName:G.ZodObject,...ee(t)});ye.strictCreate=(e,t)=>new ye({shape:()=>e,unknownKeys:"strict",catchall:Lt.create(),typeName:G.ZodObject,...ee(t)});ye.lazycreate=(e,t)=>new ye({shape:e,unknownKeys:"strip",catchall:Lt.create(),typeName:G.ZodObject,...ee(t)});class Pn extends ne{_parse(t){const{ctx:s}=this._processInputParams(t),n=this._def.options;function r(i){for(const a of i)if(a.result.status==="valid")return a.result;for(const a of i)if(a.result.status==="dirty")return s.common.issues.push(...a.ctx.common.issues),a.result;const o=i.map(a=>new ft(a.ctx.common.issues));return N(s,{code:I.invalid_union,unionErrors:o}),q}if(s.common.async)return Promise.all(n.map(async i=>{const o={...s,common:{...s.common,issues:[]},parent:null};return{result:await i._parseAsync({data:s.data,path:s.path,parent:o}),ctx:o}})).then(r);{let i;const o=[];for(const c of n){const u={...s,common:{...s.common,issues:[]},parent:null},f=c._parseSync({data:s.data,path:s.path,parent:u});if(f.status==="valid")return f;f.status==="dirty"&&!i&&(i={result:f,ctx:u}),u.common.issues.length&&o.push(u.common.issues)}if(i)return s.common.issues.push(...i.ctx.common.issues),i.result;const a=o.map(c=>new ft(c));return N(s,{code:I.invalid_union,unionErrors:a}),q}}get options(){return this._def.options}}Pn.create=(e,t)=>new Pn({options:e,typeName:G.ZodUnion,...ee(t)});function Ir(e,t){const s=gt(e),n=gt(t);if(e===t)return{valid:!0,data:e};if(s===V.object&&n===V.object){const r=re.objectKeys(t),i=re.objectKeys(e).filter(a=>r.indexOf(a)!==-1),o={...e,...t};for(const a of i){const c=Ir(e[a],t[a]);if(!c.valid)return{valid:!1};o[a]=c.data}return{valid:!0,data:o}}else if(s===V.array&&n===V.array){if(e.length!==t.length)return{valid:!1};const r=[];for(let i=0;i{if(vo(i)||vo(o))return q;const a=Ir(i.value,o.value);return a.valid?((yo(i)||yo(o))&&s.dirty(),{status:s.value,value:a.data}):(N(n,{code:I.invalid_intersection_types}),q)};return n.common.async?Promise.all([this._def.left._parseAsync({data:n.data,path:n.path,parent:n}),this._def.right._parseAsync({data:n.data,path:n.path,parent:n})]).then(([i,o])=>r(i,o)):r(this._def.left._parseSync({data:n.data,path:n.path,parent:n}),this._def.right._parseSync({data:n.data,path:n.path,parent:n}))}}kn.create=(e,t,s)=>new kn({left:e,right:t,typeName:G.ZodIntersection,...ee(s)});class Ht extends ne{_parse(t){const{status:s,ctx:n}=this._processInputParams(t);if(n.parsedType!==V.array)return N(n,{code:I.invalid_type,expected:V.array,received:n.parsedType}),q;if(n.data.lengththis._def.items.length&&(N(n,{code:I.too_big,maximum:this._def.items.length,inclusive:!0,exact:!1,type:"array"}),s.dirty());const i=[...n.data].map((o,a)=>{const c=this._def.items[a]||this._def.rest;return c?c._parse(new It(n,o,n.path,a)):null}).filter(o=>!!o);return n.common.async?Promise.all(i).then(o=>Ae.mergeArray(s,o)):Ae.mergeArray(s,i)}get items(){return this._def.items}rest(t){return new Ht({...this._def,rest:t})}}Ht.create=(e,t)=>{if(!Array.isArray(e))throw new Error("You must pass an array of schemas to z.tuple([ ... ])");return new Ht({items:e,typeName:G.ZodTuple,rest:null,...ee(t)})};class ko extends ne{get keySchema(){return this._def.keyType}get valueSchema(){return this._def.valueType}_parse(t){const{status:s,ctx:n}=this._processInputParams(t);if(n.parsedType!==V.map)return N(n,{code:I.invalid_type,expected:V.map,received:n.parsedType}),q;const r=this._def.keyType,i=this._def.valueType,o=[...n.data.entries()].map(([a,c],u)=>({key:r._parse(new It(n,a,n.path,[u,"key"])),value:i._parse(new It(n,c,n.path,[u,"value"]))}));if(n.common.async){const a=new Map;return Promise.resolve().then(async()=>{for(const c of o){const u=await c.key,f=await c.value;if(u.status==="aborted"||f.status==="aborted")return q;(u.status==="dirty"||f.status==="dirty")&&s.dirty(),a.set(u.value,f.value)}return{status:s.value,value:a}})}else{const a=new Map;for(const c of o){const u=c.key,f=c.value;if(u.status==="aborted"||f.status==="aborted")return q;(u.status==="dirty"||f.status==="dirty")&&s.dirty(),a.set(u.value,f.value)}return{status:s.value,value:a}}}}ko.create=(e,t,s)=>new ko({valueType:t,keyType:e,typeName:G.ZodMap,...ee(s)});class Hs extends ne{_parse(t){const{status:s,ctx:n}=this._processInputParams(t);if(n.parsedType!==V.set)return N(n,{code:I.invalid_type,expected:V.set,received:n.parsedType}),q;const r=this._def;r.minSize!==null&&n.data.sizer.maxSize.value&&(N(n,{code:I.too_big,maximum:r.maxSize.value,type:"set",inclusive:!0,exact:!1,message:r.maxSize.message}),s.dirty());const i=this._def.valueType;function o(c){const u=new Set;for(const f of c){if(f.status==="aborted")return q;f.status==="dirty"&&s.dirty(),u.add(f.value)}return{status:s.value,value:u}}const a=[...n.data.values()].map((c,u)=>i._parse(new It(n,c,n.path,u)));return n.common.async?Promise.all(a).then(c=>o(c)):o(a)}min(t,s){return new Hs({...this._def,minSize:{value:t,message:U.toString(s)}})}max(t,s){return new Hs({...this._def,maxSize:{value:t,message:U.toString(s)}})}size(t,s){return this.min(t,s).max(t,s)}nonempty(t){return this.min(1,t)}}Hs.create=(e,t)=>new Hs({valueType:e,minSize:null,maxSize:null,typeName:G.ZodSet,...ee(t)});class To extends ne{get schema(){return this._def.getter()}_parse(t){const{ctx:s}=this._processInputParams(t);return this._def.getter()._parse({data:s.data,path:s.path,parent:s})}}To.create=(e,t)=>new To({getter:e,typeName:G.ZodLazy,...ee(t)});class Io extends ne{_parse(t){if(t.data!==this._def.value){const s=this._getOrReturnCtx(t);return N(s,{received:s.data,code:I.invalid_literal,expected:this._def.value}),q}return{status:"valid",value:t.data}}get value(){return this._def.value}}Io.create=(e,t)=>new Io({value:e,typeName:G.ZodLiteral,...ee(t)});function Ya(e,t){return new rs({values:e,typeName:G.ZodEnum,...ee(t)})}class rs extends ne{_parse(t){if(typeof t.data!="string"){const s=this._getOrReturnCtx(t),n=this._def.values;return N(s,{expected:re.joinValues(n),received:s.parsedType,code:I.invalid_type}),q}if(this._cache||(this._cache=new Set(this._def.values)),!this._cache.has(t.data)){const s=this._getOrReturnCtx(t),n=this._def.values;return N(s,{received:s.data,code:I.invalid_enum_value,options:n}),q}return Be(t.data)}get options(){return this._def.values}get enum(){const t={};for(const s of this._def.values)t[s]=s;return t}get Values(){const t={};for(const s of this._def.values)t[s]=s;return t}get Enum(){const t={};for(const s of this._def.values)t[s]=s;return t}extract(t,s=this._def){return rs.create(t,{...this._def,...s})}exclude(t,s=this._def){return rs.create(this.options.filter(n=>!t.includes(n)),{...this._def,...s})}}rs.create=Ya;class Lo extends ne{_parse(t){const s=re.getValidEnumValues(this._def.values),n=this._getOrReturnCtx(t);if(n.parsedType!==V.string&&n.parsedType!==V.number){const r=re.objectValues(s);return N(n,{expected:re.joinValues(r),received:n.parsedType,code:I.invalid_type}),q}if(this._cache||(this._cache=new Set(re.getValidEnumValues(this._def.values))),!this._cache.has(t.data)){const r=re.objectValues(s);return N(n,{received:n.data,code:I.invalid_enum_value,options:r}),q}return Be(t.data)}get enum(){return this._def.values}}Lo.create=(e,t)=>new Lo({values:e,typeName:G.ZodNativeEnum,...ee(t)});class Tn extends ne{unwrap(){return this._def.type}_parse(t){const{ctx:s}=this._processInputParams(t);if(s.parsedType!==V.promise&&s.common.async===!1)return N(s,{code:I.invalid_type,expected:V.promise,received:s.parsedType}),q;const n=s.parsedType===V.promise?s.data:Promise.resolve(s.data);return Be(n.then(r=>this._def.type.parseAsync(r,{path:s.path,errorMap:s.common.contextualErrorMap})))}}Tn.create=(e,t)=>new Tn({type:e,typeName:G.ZodPromise,...ee(t)});class is extends ne{innerType(){return this._def.schema}sourceType(){return this._def.schema._def.typeName===G.ZodEffects?this._def.schema.sourceType():this._def.schema}_parse(t){const{status:s,ctx:n}=this._processInputParams(t),r=this._def.effect||null,i={addIssue:o=>{N(n,o),o.fatal?s.abort():s.dirty()},get path(){return n.path}};if(i.addIssue=i.addIssue.bind(i),r.type==="preprocess"){const o=r.transform(n.data,i);if(n.common.async)return Promise.resolve(o).then(async a=>{if(s.value==="aborted")return q;const c=await this._def.schema._parseAsync({data:a,path:n.path,parent:n});return c.status==="aborted"?q:c.status==="dirty"||s.value==="dirty"?ys(c.value):c});{if(s.value==="aborted")return q;const a=this._def.schema._parseSync({data:o,path:n.path,parent:n});return a.status==="aborted"?q:a.status==="dirty"||s.value==="dirty"?ys(a.value):a}}if(r.type==="refinement"){const o=a=>{const c=r.refinement(a,i);if(n.common.async)return Promise.resolve(c);if(c instanceof Promise)throw new Error("Async refinement encountered during synchronous parse operation. Use .parseAsync instead.");return a};if(n.common.async===!1){const a=this._def.schema._parseSync({data:n.data,path:n.path,parent:n});return a.status==="aborted"?q:(a.status==="dirty"&&s.dirty(),o(a.value),{status:s.value,value:a.value})}else return this._def.schema._parseAsync({data:n.data,path:n.path,parent:n}).then(a=>a.status==="aborted"?q:(a.status==="dirty"&&s.dirty(),o(a.value).then(()=>({status:s.value,value:a.value}))))}if(r.type==="transform")if(n.common.async===!1){const o=this._def.schema._parseSync({data:n.data,path:n.path,parent:n});if(!ns(o))return q;const a=r.transform(o.value,i);if(a instanceof Promise)throw new Error("Asynchronous transform encountered during synchronous parse operation. Use .parseAsync instead.");return{status:s.value,value:a}}else return this._def.schema._parseAsync({data:n.data,path:n.path,parent:n}).then(o=>ns(o)?Promise.resolve(r.transform(o.value,i)).then(a=>({status:s.value,value:a})):q);re.assertNever(r)}}is.create=(e,t,s)=>new is({schema:e,typeName:G.ZodEffects,effect:t,...ee(s)});is.createWithPreprocess=(e,t,s)=>new is({schema:t,effect:{type:"preprocess",transform:e},typeName:G.ZodEffects,...ee(s)});class Ct extends ne{_parse(t){return this._getType(t)===V.undefined?Be(void 0):this._def.innerType._parse(t)}unwrap(){return this._def.innerType}}Ct.create=(e,t)=>new Ct({innerType:e,typeName:G.ZodOptional,...ee(t)});class os extends ne{_parse(t){return this._getType(t)===V.null?Be(null):this._def.innerType._parse(t)}unwrap(){return this._def.innerType}}os.create=(e,t)=>new os({innerType:e,typeName:G.ZodNullable,...ee(t)});class Lr extends ne{_parse(t){const{ctx:s}=this._processInputParams(t);let n=s.data;return s.parsedType===V.undefined&&(n=this._def.defaultValue()),this._def.innerType._parse({data:n,path:s.path,parent:s})}removeDefault(){return this._def.innerType}}Lr.create=(e,t)=>new Lr({innerType:e,typeName:G.ZodDefault,defaultValue:typeof t.default=="function"?t.default:()=>t.default,...ee(t)});class Mr extends ne{_parse(t){const{ctx:s}=this._processInputParams(t),n={...s,common:{...s.common,issues:[]}},r=this._def.innerType._parse({data:n.data,path:n.path,parent:{...n}});return Rn(r)?r.then(i=>({status:"valid",value:i.status==="valid"?i.value:this._def.catchValue({get error(){return new ft(n.common.issues)},input:n.data})})):{status:"valid",value:r.status==="valid"?r.value:this._def.catchValue({get error(){return new ft(n.common.issues)},input:n.data})}}removeCatch(){return this._def.innerType}}Mr.create=(e,t)=>new Mr({innerType:e,typeName:G.ZodCatch,catchValue:typeof t.catch=="function"?t.catch:()=>t.catch,...ee(t)});class Mo extends ne{_parse(t){if(this._getType(t)!==V.nan){const n=this._getOrReturnCtx(t);return N(n,{code:I.invalid_type,expected:V.nan,received:n.parsedType}),q}return{status:"valid",value:t.data}}}Mo.create=e=>new Mo({typeName:G.ZodNaN,...ee(e)});class Zd extends ne{_parse(t){const{ctx:s}=this._processInputParams(t),n=s.data;return this._def.type._parse({data:n,path:s.path,parent:s})}unwrap(){return this._def.type}}class yi extends ne{_parse(t){const{status:s,ctx:n}=this._processInputParams(t);if(n.common.async)return(async()=>{const i=await this._def.in._parseAsync({data:n.data,path:n.path,parent:n});return i.status==="aborted"?q:i.status==="dirty"?(s.dirty(),ys(i.value)):this._def.out._parseAsync({data:i.value,path:n.path,parent:n})})();{const r=this._def.in._parseSync({data:n.data,path:n.path,parent:n});return r.status==="aborted"?q:r.status==="dirty"?(s.dirty(),{status:"dirty",value:r.value}):this._def.out._parseSync({data:r.value,path:n.path,parent:n})}}static create(t,s){return new yi({in:t,out:s,typeName:G.ZodPipeline})}}class Er extends ne{_parse(t){const s=this._def.innerType._parse(t),n=r=>(ns(r)&&(r.value=Object.freeze(r.value)),r);return Rn(s)?s.then(r=>n(r)):n(s)}unwrap(){return this._def.innerType}}Er.create=(e,t)=>new Er({innerType:e,typeName:G.ZodReadonly,...ee(t)});var G;(function(e){e.ZodString="ZodString",e.ZodNumber="ZodNumber",e.ZodNaN="ZodNaN",e.ZodBigInt="ZodBigInt",e.ZodBoolean="ZodBoolean",e.ZodDate="ZodDate",e.ZodSymbol="ZodSymbol",e.ZodUndefined="ZodUndefined",e.ZodNull="ZodNull",e.ZodAny="ZodAny",e.ZodUnknown="ZodUnknown",e.ZodNever="ZodNever",e.ZodVoid="ZodVoid",e.ZodArray="ZodArray",e.ZodObject="ZodObject",e.ZodUnion="ZodUnion",e.ZodDiscriminatedUnion="ZodDiscriminatedUnion",e.ZodIntersection="ZodIntersection",e.ZodTuple="ZodTuple",e.ZodRecord="ZodRecord",e.ZodMap="ZodMap",e.ZodSet="ZodSet",e.ZodFunction="ZodFunction",e.ZodLazy="ZodLazy",e.ZodLiteral="ZodLiteral",e.ZodEnum="ZodEnum",e.ZodEffects="ZodEffects",e.ZodNativeEnum="ZodNativeEnum",e.ZodOptional="ZodOptional",e.ZodNullable="ZodNullable",e.ZodDefault="ZodDefault",e.ZodCatch="ZodCatch",e.ZodPromise="ZodPromise",e.ZodBranded="ZodBranded",e.ZodPipeline="ZodPipeline",e.ZodReadonly="ZodReadonly"})(G||(G={}));const Wd=bt.create;Lt.create;et.create;const zd=ye.create;Pn.create;kn.create;Ht.create;rs.create;Tn.create;Ct.create;os.create;const Kd=e=>{const t="input"in e?e.input:"input",s="output"in e?e.output:"output",n="schema"in e?e.schema._input:e._input,r="schema"in e?e.schema._output:e._output;return{types:{input:t==="output"?r:n,output:s==="input"?n:r},parse:i=>"schema"in e?e.schema.parse(i):e.parse(i)}},qd=()=>ls(()=>import("./page-with-search-BhJv4yJI.js"),__vite__mapDeps([0,1])),Gd=cs("/(tests)/page-with-search")({validateSearch:Kd(zd({where:Wd()})),component:vi(qd,"component")}),Jd=()=>ls(()=>import("./normal-page-BPOVyYTF.js"),__vite__mapDeps([2,1])),Yd=cs("/(tests)/normal-page")({component:vi(Jd,"component")});(function e(t){function s(r,i,o){var a,c={};if(Array.isArray(r))return r.concat(i);for(a in r)c[o?a.toLowerCase():a]=r[a];for(a in i){var u=o?a.toLowerCase():a,f=i[a];c[u]=u in c&&typeof f=="object"?s(c[u],f,u=="headers"):f}return c}function n(r,i,o,a,c){var u=typeof r!="string"?(i=r).url:r,f={config:i},l=s(t,i),d={};a=a||l.data,(l.transformRequest||[]).map(function(h){a=h(a,l.headers)||a}),l.auth&&(d.authorization=l.auth),a&&typeof a=="object"&&typeof a.append!="function"&&typeof a.text!="function"&&(a=JSON.stringify(a),d["content-type"]="application/json");try{d[l.xsrfHeaderName]=decodeURIComponent(document.cookie.match(RegExp("(^|; )"+l.xsrfCookieName+"=([^;]*)"))[2])}catch{}return l.baseURL&&(u=u.replace(/^(?!.*\/\/)\/?/,l.baseURL+"/")),l.params&&(u+=(~u.indexOf("?")?"&":"?")+(l.paramsSerializer?l.paramsSerializer(l.params):new URLSearchParams(l.params))),(l.fetch||fetch)(u,{method:(o||l.method||"get").toUpperCase(),body:a,headers:s(l.headers,d,!0),credentials:l.withCredentials?"include":c}).then(function(h){for(var g in h)typeof h[g]!="function"&&(f[g]=h[g]);return l.responseType=="stream"?(f.data=h.body,f):h[l.responseType||"text"]().then(function(y){f.data=y,f.data=JSON.parse(y)}).catch(Object).then(function(){return(l.validateStatus?l.validateStatus(h.status):h.ok)?f:Promise.reject(f)})})}return t=t||{},n.request=n,n.get=function(r,i){return n(r,i,"get")},n.delete=function(r,i){return n(r,i,"delete")},n.head=function(r,i){return n(r,i,"head")},n.options=function(r,i){return n(r,i,"options")},n.post=function(r,i,o){return n(r,o,"post",i)},n.put=function(r,i,o){return n(r,o,"put",i)},n.patch=function(r,i,o){return n(r,o,"patch",i)},n.all=Promise.all.bind(Promise),n.spread=function(r){return r.apply.bind(r,r)},n.CancelToken=typeof AbortController=="function"?AbortController:Object,n.defaults=t,n.create=e,n})();function Xd(e){return new Promise(t=>setTimeout(t,e))}const Qd=cs("/(tests)/lazy-with-loader-page")({loader:async()=>(await Xd(1e3),{foo:"bar"})}),eh=cs("/(tests)/lazy-page")({}),th=cs("/(tests)/virtual-page")(),sh=yd.update({id:"/",path:"/",getParentRoute:()=>Wt}),nh=th.update({id:"/(tests)/virtual-page",path:"/virtual-page",getParentRoute:()=>Wt}).lazy(()=>ls(()=>import("./virtual-page.lazy-BCqvdivF.js"),__vite__mapDeps([3,1])).then(e=>e.Route)),rh=Gd.update({id:"/(tests)/page-with-search",path:"/page-with-search",getParentRoute:()=>Wt}),ih=Yd.update({id:"/(tests)/normal-page",path:"/normal-page",getParentRoute:()=>Wt}),oh=Qd.update({id:"/(tests)/lazy-with-loader-page",path:"/lazy-with-loader-page",getParentRoute:()=>Wt}).lazy(()=>ls(()=>import("./lazy-with-loader-page.lazy-BzLmn584.js"),__vite__mapDeps([4,1])).then(e=>e.Route)),ah=eh.update({id:"/(tests)/lazy-page",path:"/lazy-page",getParentRoute:()=>Wt}).lazy(()=>ls(()=>import("./lazy-page.lazy-BzoMuhUY.js"),__vite__mapDeps([5,1])).then(e=>e.Route)),ch={IndexRoute:sh,testsLazyPageRoute:ah,testsLazyWithLoaderPageRoute:oh,testsNormalPageRoute:ih,testsPageWithSearchRoute:rh,testsVirtualPageLazyRoute:nh},lh=Wt._addFileChildren(ch)._addFileTypes();let Xa;Xa=Fu();const uh=sd({routeTree:lh,history:Xa,scrollRestoration:!0}),fh=document.getElementById("app");fh?.innerHTML||ku({setup(){return()=>ce(id,{router:uh},null)}}).mount("#app");export{Fe as F,ho as L,ce as a,xr as b,mh as c,ms as l,ri as m}; diff --git a/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/index-ElfLiipA.css b/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/index-ElfLiipA.css deleted file mode 100644 index b6e247a9c9..0000000000 --- a/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/index-ElfLiipA.css +++ /dev/null @@ -1 +0,0 @@ -/*! tailwindcss v4.1.15 | MIT License | https://tailwindcss.com */@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-border-style:solid;--tw-font-weight:initial}}}@layer theme{:root,:host{--font-sans:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";--font-mono:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace;--color-gray-50:oklch(98.5% .002 247.839);--color-gray-200:oklch(92.8% .006 264.531);--color-gray-800:oklch(27.8% .033 256.848);--color-gray-900:oklch(21% .034 264.665);--color-gray-950:oklch(13% .028 261.692);--spacing:.25rem;--text-lg:1.125rem;--text-lg--line-height:calc(1.75/1.125);--font-weight-bold:700;--default-font-family:var(--font-sans);--default-mono-font-family:var(--font-mono)}}@layer base{*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;tab-size:4;line-height:1.5;font-family:var(--default-font-family,ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring{outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::placeholder{opacity:1}@supports (not ((-webkit-appearance:-apple-pay-button))) or (contain-intrinsic-size:1px){::placeholder{color:currentColor}@supports (color:color-mix(in lab,red,red)){::placeholder{color:color-mix(in oklab,currentcolor 50%,transparent)}}}textarea{resize:vertical}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-date-and-time-value{min-height:1lh;text-align:inherit}::-webkit-datetime-edit{display:inline-flex}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-datetime-edit{padding-block:0}::-webkit-datetime-edit-year-field{padding-block:0}::-webkit-datetime-edit-month-field{padding-block:0}::-webkit-datetime-edit-day-field{padding-block:0}::-webkit-datetime-edit-hour-field{padding-block:0}::-webkit-datetime-edit-minute-field{padding-block:0}::-webkit-datetime-edit-second-field{padding-block:0}::-webkit-datetime-edit-millisecond-field{padding-block:0}::-webkit-datetime-edit-meridiem-field{padding-block:0}::-webkit-calendar-picker-indicator{line-height:1}:-moz-ui-invalid{box-shadow:none}button,input:where([type=button],[type=reset],[type=submit]){appearance:button}::file-selector-button{appearance:button}::-webkit-inner-spin-button{height:auto}::-webkit-outer-spin-button{height:auto}[hidden]:where(:not([hidden=until-found])){display:none!important}*,:after,:before,::backdrop{border-color:var(--color-gray-200,currentcolor)}::file-selector-button{border-color:var(--color-gray-200,currentcolor)}}@layer components;@layer utilities{.flex{display:flex}.grid{display:grid}.gap-2{gap:calc(var(--spacing)*2)}.border{border-style:var(--tw-border-style);border-width:1px}.p-2{padding:calc(var(--spacing)*2)}.text-lg{font-size:var(--text-lg);line-height:var(--tw-leading,var(--text-lg--line-height))}.font-bold{--tw-font-weight:var(--font-weight-bold);font-weight:var(--font-weight-bold)}}html{color-scheme:light dark}*{border-color:var(--color-gray-200)}@media (prefers-color-scheme:dark){*{border-color:var(--color-gray-800)}}body{background-color:var(--color-gray-50);color:var(--color-gray-950)}@media (prefers-color-scheme:dark){body{background-color:var(--color-gray-900);color:var(--color-gray-200)}}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-font-weight{syntax:"*";inherits:false} diff --git a/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/index-rPfEOKs3.js b/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/index-rPfEOKs3.js deleted file mode 100644 index 7dff2a5190..0000000000 --- a/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/index-rPfEOKs3.js +++ /dev/null @@ -1 +0,0 @@ -import{a as e,l as t,b as a,L as r,m as s}from"./index-BwsVWHwV.js";function i(){return e("div",{class:"p-2 grid gap-2"},[e("h3",null,[a("Welcome Home!")]),e("p",null,[a("The are the links to be tested when navigating away from the index page. Otherwise known as NOT first-load tests, rather known as navigation tests.")]),[t({to:"/normal-page"}),t({to:"/lazy-page"}),t({to:"/virtual-page"}),t({to:"/lazy-with-loader-page"}),t({to:"/page-with-search",search:{where:"footer"}})].map((o,n)=>e("div",{class:"border p-2"},[e("h4",null,[o.to,a(" tests")]),e("p",null,[e(r,s(o,{hash:"at-the-bottom"}),{default:()=>[o.to,a("#at-the-bottom")]})])]))])}export{i as component}; diff --git a/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/lazy-page.lazy-BzoMuhUY.js b/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/lazy-page.lazy-BzoMuhUY.js deleted file mode 100644 index b2ab5a4389..0000000000 --- a/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/lazy-page.lazy-BzoMuhUY.js +++ /dev/null @@ -1 +0,0 @@ -import{c as l,a as e,b as o}from"./index-BwsVWHwV.js";import{S as t}from"./scroll-block-BAas_Ct-.js";const c=l("/(tests)/lazy-page")({component:a});function a(){return e("div",{class:"p-2"},[e("h3",null,[o("lazy-page")]),e("hr",null,null),e(t,null,null)])}export{c as Route}; diff --git a/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/lazy-with-loader-page.lazy-BzLmn584.js b/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/lazy-with-loader-page.lazy-BzLmn584.js deleted file mode 100644 index ab267814ce..0000000000 --- a/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/lazy-with-loader-page.lazy-BzLmn584.js +++ /dev/null @@ -1 +0,0 @@ -import{c as l,a as e,b as o}from"./index-BwsVWHwV.js";import{S as t}from"./scroll-block-BAas_Ct-.js";const c=l("/(tests)/lazy-with-loader-page")({component:a});function a(){return e("div",{class:"p-2"},[e("h3",null,[o("lazy-with-loader-page")]),e("hr",null,null),e(t,null,null)])}export{c as Route}; diff --git a/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/normal-page-BPOVyYTF.js b/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/normal-page-BPOVyYTF.js deleted file mode 100644 index ec26f71d98..0000000000 --- a/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/normal-page-BPOVyYTF.js +++ /dev/null @@ -1 +0,0 @@ -import{S as o}from"./scroll-block-BAas_Ct-.js";import{a as l,b as n}from"./index-BwsVWHwV.js";function a(){return l("div",{class:"p-2"},[l("h3",null,[n("normal-page")]),l("hr",null,null),l(o,null,null)])}export{a as component}; diff --git a/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/page-with-search-BhJv4yJI.js b/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/page-with-search-BhJv4yJI.js deleted file mode 100644 index 67ce6cd937..0000000000 --- a/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/page-with-search-BhJv4yJI.js +++ /dev/null @@ -1 +0,0 @@ -import{S as o}from"./scroll-block-BAas_Ct-.js";import{a as l,b as e}from"./index-BwsVWHwV.js";function t(){return l("div",{class:"p-2"},[l("h3",null,[e("page-with-search")]),l("hr",null,null),l(o,null,null)])}export{t as component}; diff --git a/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/scroll-block-BAas_Ct-.js b/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/scroll-block-BAas_Ct-.js deleted file mode 100644 index 89ed1c6988..0000000000 --- a/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/scroll-block-BAas_Ct-.js +++ /dev/null @@ -1 +0,0 @@ -import{a as t,b as r,F as l}from"./index-BwsVWHwV.js";const o="at-the-top",a="at-the-bottom";function m({number:e=100}){return t(l,null,[t("div",{id:o,"data-testid":o},null),Array.from({length:e}).map((n,d)=>t("div",null,[d])),t("div",{id:a,"data-testid":a},[r("At the bottom")])])}export{m as S}; diff --git a/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/virtual-page.lazy-BCqvdivF.js b/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/virtual-page.lazy-BCqvdivF.js deleted file mode 100644 index 82d2cac67f..0000000000 --- a/e2e/vue-router/scroll-restoration-sandbox-vite/dist-hash/assets/virtual-page.lazy-BCqvdivF.js +++ /dev/null @@ -1 +0,0 @@ -import{c as t,a as e,b as l}from"./index-BwsVWHwV.js";import{S as o}from"./scroll-block-BAas_Ct-.js";const u=t("/(tests)/virtual-page")({component:a});function a(){return e("div",{class:"p-2"},[e("h3",null,[l("virtual-page")]),e("hr",null,null),e(o,null,null)])}export{u as Route}; diff --git a/e2e/vue-router/scroll-restoration-sandbox-vite/package.json b/e2e/vue-router/scroll-restoration-sandbox-vite/package.json index 40423a1c63..a7dc67fd6b 100644 --- a/e2e/vue-router/scroll-restoration-sandbox-vite/package.json +++ b/e2e/vue-router/scroll-restoration-sandbox-vite/package.json @@ -18,11 +18,10 @@ "@tanstack/router-plugin": "workspace:^", "@tanstack/vue-router": "workspace:^", "@tanstack/vue-router-devtools": "workspace:^", - "@tanstack/zod-adapter": "workspace:^", "redaxios": "^0.5.1", "tailwindcss": "^4.2.2", "vue": "^3.5.16", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -30,7 +29,7 @@ "@vitejs/plugin-vue": "^6.0.5", "@vitejs/plugin-vue-jsx": "^5.1.5", "typescript": "~5.8.3", - "vite": "^8.0.0", + "vite": "^8.0.14", "vue-tsc": "^3.1.5" } } diff --git a/e2e/vue-router/scroll-restoration-sandbox-vite/src/routes/(tests)/page-with-search.tsx b/e2e/vue-router/scroll-restoration-sandbox-vite/src/routes/(tests)/page-with-search.tsx index 3e1ec1eeba..f608b9e379 100644 --- a/e2e/vue-router/scroll-restoration-sandbox-vite/src/routes/(tests)/page-with-search.tsx +++ b/e2e/vue-router/scroll-restoration-sandbox-vite/src/routes/(tests)/page-with-search.tsx @@ -1,10 +1,9 @@ import { createFileRoute } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' import { ScrollBlock } from '../-components/scroll-block' export const Route = createFileRoute('/(tests)/page-with-search')({ - validateSearch: zodValidator(z.object({ where: z.string() })), + validateSearch: z.object({ where: z.string() }), component: Component, }) diff --git a/e2e/vue-router/sentry-integration/package.json b/e2e/vue-router/sentry-integration/package.json index 001e8eb1dd..cbf6bf8499 100644 --- a/e2e/vue-router/sentry-integration/package.json +++ b/e2e/vue-router/sentry-integration/package.json @@ -26,7 +26,7 @@ "@tanstack/router-e2e-utils": "workspace:^", "@vitejs/plugin-vue-jsx": "^5.1.5", "typescript": "~5.8.3", - "vite": "^8.0.0", + "vite": "^8.0.14", "vue-tsc": "^3.1.5" } } diff --git a/e2e/vue-router/view-transitions/package.json b/e2e/vue-router/view-transitions/package.json index 73d7f05146..493b3e45ce 100644 --- a/e2e/vue-router/view-transitions/package.json +++ b/e2e/vue-router/view-transitions/package.json @@ -27,7 +27,7 @@ "@vitejs/plugin-vue": "^6.0.5", "@vitejs/plugin-vue-jsx": "^5.1.5", "typescript": "~5.8.3", - "vite": "^8.0.0", + "vite": "^8.0.14", "vue-tsc": "^3.1.5" } } diff --git a/e2e/vue-start/basic-auth/package.json b/e2e/vue-start/basic-auth/package.json index 603bf49ec4..3a572536e9 100644 --- a/e2e/vue-start/basic-auth/package.json +++ b/e2e/vue-start/basic-auth/package.json @@ -20,8 +20,7 @@ "@tanstack/vue-router-devtools": "workspace:^", "@tanstack/vue-start": "workspace:^", "redaxios": "^0.5.1", - "tailwind-merge": "^2.6.0", - "vite": "^8.0.0", + "tailwind-merge": "^3.6.0", "vue": "^3.5.25" }, "devDependencies": { @@ -29,12 +28,13 @@ "@tailwindcss/vite": "^4.2.2", "@tanstack/router-e2e-utils": "workspace:^", "@types/node": "^22.10.2", + "@vitejs/plugin-vue": "^6.0.5", + "@vitejs/plugin-vue-jsx": "^5.1.5", "dotenv": "^17.2.3", "prisma": "^7.0.0", "srvx": "^0.11.9", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "@vitejs/plugin-vue": "^6.0.5", - "@vitejs/plugin-vue-jsx": "^5.1.5" + "vite": "^8.0.14" } } diff --git a/e2e/vue-start/basic-cloudflare/package.json b/e2e/vue-start/basic-cloudflare/package.json index 4efaf79c46..b3c4273718 100644 --- a/e2e/vue-start/basic-cloudflare/package.json +++ b/e2e/vue-start/basic-cloudflare/package.json @@ -26,7 +26,7 @@ "@types/node": "^22.10.2", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "@vitejs/plugin-vue": "^6.0.5", "@vitejs/plugin-vue-jsx": "^5.1.5", "wrangler": "^4.74.0" diff --git a/e2e/vue-start/basic-prerender/.gitignore b/e2e/vue-start/basic-prerender/.gitignore deleted file mode 100644 index 6381bf3860..0000000000 --- a/e2e/vue-start/basic-prerender/.gitignore +++ /dev/null @@ -1,5 +0,0 @@ -node_modules - -/test-results/ -/playwright-report/ -/blob-report/ diff --git a/e2e/vue-start/basic-prerender/package.json b/e2e/vue-start/basic-prerender/package.json deleted file mode 100644 index 5b05d8f771..0000000000 --- a/e2e/vue-start/basic-prerender/package.json +++ /dev/null @@ -1,24 +0,0 @@ -{ - "name": "tanstack-vue-start-e2e-basic-prerender", - "private": true, - "sideEffects": false, - "type": "module", - "scripts": { - "test:e2e:startDummyServer": "node -e 'import(\"../basic-test-suite/src/setup/global.setup.ts\").then(m => m.default())' & node -e 'import(\"../basic-test-suite/src/setup/waitForDummyServer.ts\").then(m => m.default())'", - "test:e2e:stopDummyServer": "node -e 'import(\"../basic-test-suite/src/setup/global.teardown.ts\").then(m => m.default())'", - "test:e2e": "rm -rf port*.txt; MODE=prerender playwright test --project=chromium" - }, - "devDependencies": { - "@playwright/test": "^1.50.1", - "@tanstack/router-e2e-utils": "workspace:^", - "tanstack-vue-start-e2e-basic": "workspace:*", - "tanstack-vue-start-e2e-basic-test-suite": "workspace:*" - }, - "nx": { - "targets": { - "test:e2e": { - "parallelism": false - } - } - } -} diff --git a/e2e/vue-start/basic-prerender/playwright.config.ts b/e2e/vue-start/basic-prerender/playwright.config.ts deleted file mode 100644 index cf2cf5d396..0000000000 --- a/e2e/vue-start/basic-prerender/playwright.config.ts +++ /dev/null @@ -1,48 +0,0 @@ -import { defineConfig, devices } from '@playwright/test' -import { - getDummyServerPort, - getTestServerPort, -} from '@tanstack/router-e2e-utils' -import packageJson from './package.json' with { type: 'json' } - -const PORT = await getTestServerPort(packageJson.name) -const START_PORT = await getTestServerPort(`${packageJson.name}_start`) -const EXTERNAL_PORT = await getDummyServerPort(packageJson.name) -const baseURL = `http://localhost:${PORT}` - -export default defineConfig({ - testDir: '../basic-test-suite/src', - workers: 1, - reporter: [['line']], - - globalTeardown: '../basic-test-suite/src/setup/global.teardown.ts', - - use: { - baseURL, - }, - - webServer: { - command: - 'pnpm run test:e2e:startDummyServer && pnpm --dir ../basic build:prerender && pnpm --dir ../basic start', - url: baseURL, - reuseExistingServer: !process.env.CI, - stdout: 'pipe', - env: { - MODE: 'prerender', - VITE_NODE_ENV: 'test', - VITE_EXTERNAL_PORT: String(EXTERNAL_PORT), - VITE_SERVER_PORT: String(PORT), - START_PORT: String(START_PORT), - PORT: String(PORT), - }, - }, - - projects: [ - { - name: 'chromium', - use: { - ...devices['Desktop Chrome'], - }, - }, - ], -}) diff --git a/e2e/vue-start/basic-preview/.gitignore b/e2e/vue-start/basic-preview/.gitignore deleted file mode 100644 index 6381bf3860..0000000000 --- a/e2e/vue-start/basic-preview/.gitignore +++ /dev/null @@ -1,5 +0,0 @@ -node_modules - -/test-results/ -/playwright-report/ -/blob-report/ diff --git a/e2e/vue-start/basic-preview/package.json b/e2e/vue-start/basic-preview/package.json deleted file mode 100644 index 663b1365f1..0000000000 --- a/e2e/vue-start/basic-preview/package.json +++ /dev/null @@ -1,24 +0,0 @@ -{ - "name": "tanstack-vue-start-e2e-basic-preview", - "private": true, - "sideEffects": false, - "type": "module", - "scripts": { - "test:e2e:startDummyServer": "node -e 'import(\"../basic-test-suite/src/setup/global.setup.ts\").then(m => m.default())' & node -e 'import(\"../basic-test-suite/src/setup/waitForDummyServer.ts\").then(m => m.default())'", - "test:e2e:stopDummyServer": "node -e 'import(\"../basic-test-suite/src/setup/global.teardown.ts\").then(m => m.default())'", - "test:e2e": "rm -rf port*.txt; MODE=preview playwright test --project=chromium" - }, - "devDependencies": { - "@playwright/test": "^1.50.1", - "@tanstack/router-e2e-utils": "workspace:^", - "tanstack-vue-start-e2e-basic": "workspace:*", - "tanstack-vue-start-e2e-basic-test-suite": "workspace:*" - }, - "nx": { - "targets": { - "test:e2e": { - "parallelism": false - } - } - } -} diff --git a/e2e/vue-start/basic-preview/playwright.config.ts b/e2e/vue-start/basic-preview/playwright.config.ts deleted file mode 100644 index 071f336f9f..0000000000 --- a/e2e/vue-start/basic-preview/playwright.config.ts +++ /dev/null @@ -1,47 +0,0 @@ -import { defineConfig, devices } from '@playwright/test' -import { - getDummyServerPort, - getTestServerPort, -} from '@tanstack/router-e2e-utils' -import packageJson from './package.json' with { type: 'json' } - -const PORT = await getTestServerPort(packageJson.name) -const START_PORT = await getTestServerPort(`${packageJson.name}_start`) -const EXTERNAL_PORT = await getDummyServerPort(packageJson.name) -const baseURL = `http://localhost:${PORT}` - -export default defineConfig({ - testDir: '../basic-test-suite/src', - workers: 1, - reporter: [['line']], - - globalTeardown: '../basic-test-suite/src/setup/global.teardown.ts', - - use: { - baseURL, - }, - - webServer: { - command: `pnpm run test:e2e:startDummyServer && pnpm --dir ../basic build && pnpm --dir ../basic preview --port ${PORT}`, - url: baseURL, - reuseExistingServer: !process.env.CI, - stdout: 'pipe', - env: { - MODE: 'preview', - VITE_NODE_ENV: 'test', - VITE_EXTERNAL_PORT: String(EXTERNAL_PORT), - VITE_SERVER_PORT: String(PORT), - START_PORT: String(START_PORT), - PORT: String(PORT), - }, - }, - - projects: [ - { - name: 'chromium', - use: { - ...devices['Desktop Chrome'], - }, - }, - ], -}) diff --git a/e2e/vue-start/basic-spa/.gitignore b/e2e/vue-start/basic-spa/.gitignore deleted file mode 100644 index 6381bf3860..0000000000 --- a/e2e/vue-start/basic-spa/.gitignore +++ /dev/null @@ -1,5 +0,0 @@ -node_modules - -/test-results/ -/playwright-report/ -/blob-report/ diff --git a/e2e/vue-start/basic-spa/package.json b/e2e/vue-start/basic-spa/package.json deleted file mode 100644 index 2186636549..0000000000 --- a/e2e/vue-start/basic-spa/package.json +++ /dev/null @@ -1,24 +0,0 @@ -{ - "name": "tanstack-vue-start-e2e-basic-spa", - "private": true, - "sideEffects": false, - "type": "module", - "scripts": { - "test:e2e:startDummyServer": "node -e 'import(\"../basic-test-suite/src/setup/global.setup.ts\").then(m => m.default())' & node -e 'import(\"../basic-test-suite/src/setup/waitForDummyServer.ts\").then(m => m.default())'", - "test:e2e:stopDummyServer": "node -e 'import(\"../basic-test-suite/src/setup/global.teardown.ts\").then(m => m.default())'", - "test:e2e": "rm -rf port*.txt; MODE=spa playwright test --project=chromium" - }, - "devDependencies": { - "@playwright/test": "^1.50.1", - "@tanstack/router-e2e-utils": "workspace:^", - "tanstack-vue-start-e2e-basic": "workspace:*", - "tanstack-vue-start-e2e-basic-test-suite": "workspace:*" - }, - "nx": { - "targets": { - "test:e2e": { - "parallelism": false - } - } - } -} diff --git a/e2e/vue-start/basic-test-suite/.gitignore b/e2e/vue-start/basic-test-suite/.gitignore deleted file mode 100644 index 6381bf3860..0000000000 --- a/e2e/vue-start/basic-test-suite/.gitignore +++ /dev/null @@ -1,5 +0,0 @@ -node_modules - -/test-results/ -/playwright-report/ -/blob-report/ diff --git a/e2e/vue-start/basic-test-suite/package.json b/e2e/vue-start/basic-test-suite/package.json deleted file mode 100644 index 7d5ea7c002..0000000000 --- a/e2e/vue-start/basic-test-suite/package.json +++ /dev/null @@ -1,12 +0,0 @@ -{ - "name": "tanstack-vue-start-e2e-basic-test-suite", - "private": true, - "sideEffects": false, - "type": "module", - "devDependencies": { - "@playwright/test": "^1.50.1", - "@tanstack/router-e2e-utils": "workspace:^", - "@types/node": "^22.10.2", - "combinate": "^1.1.11" - } -} diff --git a/e2e/vue-start/basic-test-suite/src/utils/getBasicAppRoot.ts b/e2e/vue-start/basic-test-suite/src/utils/getBasicAppRoot.ts deleted file mode 100644 index 12a411989a..0000000000 --- a/e2e/vue-start/basic-test-suite/src/utils/getBasicAppRoot.ts +++ /dev/null @@ -1,8 +0,0 @@ -import { join } from 'node:path' -import { getPackageName } from './getPackageName.ts' - -export function getBasicAppRoot() { - return getPackageName().endsWith('-basic') - ? process.cwd() - : join(process.cwd(), '../basic') -} diff --git a/e2e/vue-start/basic-test-suite/src/utils/isPrerender.ts b/e2e/vue-start/basic-test-suite/src/utils/isPrerender.ts deleted file mode 100644 index d5d991d454..0000000000 --- a/e2e/vue-start/basic-test-suite/src/utils/isPrerender.ts +++ /dev/null @@ -1 +0,0 @@ -export const isPrerender: boolean = process.env.MODE === 'prerender' diff --git a/e2e/vue-start/basic-test-suite/src/utils/isPreview.ts b/e2e/vue-start/basic-test-suite/src/utils/isPreview.ts deleted file mode 100644 index 7ea362a83e..0000000000 --- a/e2e/vue-start/basic-test-suite/src/utils/isPreview.ts +++ /dev/null @@ -1 +0,0 @@ -export const isPreview: boolean = process.env.MODE === 'preview' diff --git a/e2e/vue-start/basic-test-suite/src/utils/isSpaMode.ts b/e2e/vue-start/basic-test-suite/src/utils/isSpaMode.ts deleted file mode 100644 index b4edb829a8..0000000000 --- a/e2e/vue-start/basic-test-suite/src/utils/isSpaMode.ts +++ /dev/null @@ -1 +0,0 @@ -export const isSpaMode: boolean = process.env.MODE === 'spa' diff --git a/e2e/vue-start/basic-tsr-config/package.json b/e2e/vue-start/basic-tsr-config/package.json index 2d1d102838..93c3b272fa 100644 --- a/e2e/vue-start/basic-tsr-config/package.json +++ b/e2e/vue-start/basic-tsr-config/package.json @@ -14,7 +14,6 @@ "@tanstack/vue-router": "workspace:^", "@tanstack/vue-router-devtools": "workspace:^", "@tanstack/vue-start": "workspace:^", - "vite": "^8.0.0", "vue": "^3.5.25" }, "devDependencies": { @@ -23,6 +22,7 @@ "srvx": "^0.11.9", "typescript": "^6.0.2", "@vitejs/plugin-vue": "^6.0.5", - "@vitejs/plugin-vue-jsx": "^5.1.5" + "@vitejs/plugin-vue-jsx": "^5.1.5", + "vite": "^8.0.14" } } diff --git a/e2e/vue-start/basic-vue-query/package.json b/e2e/vue-start/basic-vue-query/package.json index e05e582945..3189e8e867 100644 --- a/e2e/vue-start/basic-vue-query/package.json +++ b/e2e/vue-start/basic-vue-query/package.json @@ -19,20 +19,20 @@ "@tanstack/vue-router-ssr-query": "workspace:^", "@tanstack/vue-start": "workspace:^", "redaxios": "^0.5.1", - "tailwind-merge": "^2.6.0", - "vite": "^8.0.0", + "tailwind-merge": "^3.6.0", "vue": "^3.5.25", - "zod": "^4.1.12" + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", "@tailwindcss/vite": "^4.2.2", "@tanstack/router-e2e-utils": "workspace:^", "@types/node": "^22.10.2", + "@vitejs/plugin-vue": "^6.0.5", + "@vitejs/plugin-vue-jsx": "^5.1.5", "srvx": "^0.11.9", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "@vitejs/plugin-vue": "^6.0.5", - "@vitejs/plugin-vue-jsx": "^5.1.5" + "vite": "^8.0.14" } } diff --git a/e2e/vue-start/basic-vue-query/src/routes/posts.$postId.tsx b/e2e/vue-start/basic-vue-query/src/routes/posts.$postId.tsx index 5ec224eb2d..27baf4bd5f 100644 --- a/e2e/vue-start/basic-vue-query/src/routes/posts.$postId.tsx +++ b/e2e/vue-start/basic-vue-query/src/routes/posts.$postId.tsx @@ -3,7 +3,7 @@ import { ErrorComponent, Link, createFileRoute, - type ErrorComponentProps, + ErrorComponentProps, } from '@tanstack/vue-router' import { postQueryOptions } from '~/utils/posts' diff --git a/e2e/vue-start/basic-vue-query/src/utils/posts.tsx b/e2e/vue-start/basic-vue-query/src/utils/posts.tsx index 7f1f564645..b0a0b8f60d 100644 --- a/e2e/vue-start/basic-vue-query/src/utils/posts.tsx +++ b/e2e/vue-start/basic-vue-query/src/utils/posts.tsx @@ -7,6 +7,12 @@ export type PostType = { body: string } +let queryURL = 'https://jsonplaceholder.typicode.com' + +if (import.meta.env.VITE_NODE_ENV === 'test') { + queryURL = `http://localhost:${import.meta.env.VITE_EXTERNAL_PORT}` +} + export const postsQueryOptions = () => queryOptions({ queryKey: ['posts'], @@ -14,7 +20,7 @@ export const postsQueryOptions = () => console.info('Fetching posts...') await new Promise((r) => setTimeout(r, 500)) return axios - .get>('https://jsonplaceholder.typicode.com/posts') + .get>(`${queryURL}/posts`) .then((r) => r.data.slice(0, 10)) }, }) @@ -27,7 +33,7 @@ export const postQueryOptions = (postId: string) => await new Promise((r) => setTimeout(r, 500)) return axios - .get(`https://jsonplaceholder.typicode.com/posts/${postId}`) + .get(`${queryURL}/posts/${postId}`) .then((r) => r.data) }, }) diff --git a/e2e/vue-start/basic/.gitignore b/e2e/vue-start/basic/.gitignore index a79d5cf129..b9c2c7e5f6 100644 --- a/e2e/vue-start/basic/.gitignore +++ b/e2e/vue-start/basic/.gitignore @@ -18,3 +18,4 @@ yarn.lock /playwright-report/ /blob-report/ /playwright/.cache/ +/dist-vite-*/ diff --git a/e2e/vue-start/basic/package.json b/e2e/vue-start/basic/package.json index ab56c475ef..2df94b1a20 100644 --- a/e2e/vue-start/basic/package.json +++ b/e2e/vue-start/basic/package.json @@ -7,29 +7,31 @@ "dev": "vite dev --port 3000", "dev:e2e": "vite dev", "build": "vite build && tsc --noEmit", - "build:spa": "MODE=spa vite build && tsc --noEmit", - "build:prerender": "MODE=prerender vite build && tsc --noEmit", "preview": "vite preview", "start": "node server.js", - "test:e2e:startDummyServer": "node -e 'import(\"../basic-test-suite/src/setup/global.setup.ts\").then(m => m.default())' & node -e 'import(\"../basic-test-suite/src/setup/waitForDummyServer.ts\").then(m => m.default())'", - "test:e2e:stopDummyServer": "node -e 'import(\"../basic-test-suite/src/setup/global.teardown.ts\").then(m => m.default())'", - "test:e2e": "rm -rf dist; rm -rf port*.txt; playwright test --project=chromium" + "test:e2e:startDummyServer": "node -e 'import(\"./tests/setup/global.setup.ts\").then(m => m.default())' & node -e 'import(\"./tests/setup/waitForDummyServer.ts\").then(m => m.default())'", + "test:e2e:stopDummyServer": "node -e 'import(\"./tests/setup/global.teardown.ts\").then(m => m.default())'", + "test:e2e:local": "playwright test --project=chromium" }, "dependencies": { "@tanstack/vue-router": "workspace:^", "@tanstack/vue-router-devtools": "workspace:^", "@tanstack/vue-start": "workspace:^", - "express": "^5.1.0", + "express": "^5.2.1", "http-proxy-middleware": "^3.0.5", "js-cookie": "^3.0.5", "redaxios": "^0.5.1", + "tailwind-merge": "^3.6.0", "vue": "^3.5.16", - "tailwind-merge": "^2.6.0", - "vite": "^8.0.0", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", + "@rsbuild/core": "^2.0.8", + "@rsbuild/plugin-babel": "^1.0.5", + "@rsbuild/plugin-vue": "^1.2.2", + "@rsbuild/plugin-vue-jsx": "^1.1.1", + "@tailwindcss/postcss": "^4.2.2", "@tailwindcss/vite": "^4.2.2", "@tanstack/router-e2e-utils": "workspace:^", "@types/js-cookie": "^3.0.6", @@ -39,14 +41,34 @@ "combinate": "^1.1.11", "srvx": "^0.11.9", "tailwindcss": "^4.2.2", - "tanstack-vue-start-e2e-basic-test-suite": "workspace:*", - "typescript": "^6.0.2" + "typescript": "^6.0.2", + "vite": "^8.0.14" }, "nx": { - "targets": { - "test:e2e": { - "parallelism": false - } + "metadata": { + "playwrightModes": [ + { + "toolchain": "vite", + "mode": "ssr", + "shards": 4 + }, + { + "toolchain": "vite", + "mode": "spa" + }, + { + "toolchain": "vite", + "mode": "prerender" + }, + { + "toolchain": "vite", + "mode": "preview" + }, + { + "toolchain": "rsbuild", + "mode": "ssr" + } + ] } } } diff --git a/e2e/vue-start/basic/playwright.config.ts b/e2e/vue-start/basic/playwright.config.ts index 0bc99a1ec4..6924134cd1 100644 --- a/e2e/vue-start/basic/playwright.config.ts +++ b/e2e/vue-start/basic/playwright.config.ts @@ -1,3 +1,4 @@ +import fs from 'node:fs' import { defineConfig, devices } from '@playwright/test' import { getDummyServerPort, @@ -5,35 +6,54 @@ import { } from '@tanstack/router-e2e-utils' import packageJson from './package.json' with { type: 'json' } -const PORT = await getTestServerPort(packageJson.name) -const START_PORT = await getTestServerPort(`${packageJson.name}_start`) -const EXTERNAL_PORT = await getDummyServerPort(packageJson.name) +const mode = process.env.MODE ?? 'ssr' +const e2ePortKey = process.env.E2E_PORT_KEY ?? packageJson.name +const distDir = process.env.E2E_DIST_DIR ?? 'dist' + +if (process.env.TEST_WORKER_INDEX === undefined) { + for (const portFile of [ + `port-${e2ePortKey}.txt`, + `port-${e2ePortKey}_start.txt`, + `port-${e2ePortKey}-external.txt`, + ]) { + fs.rmSync(portFile, { force: true }) + } +} + +const PORT = await getTestServerPort(e2ePortKey) +const START_PORT = await getTestServerPort(`${e2ePortKey}_start`) +const EXTERNAL_PORT = await getDummyServerPort(e2ePortKey) const baseURL = `http://localhost:${PORT}` -const ssrModeCommand = `pnpm build && pnpm start` +const commandByMode = + mode === 'preview' + ? `pnpm run test:e2e:startDummyServer && pnpm preview --outDir ${distDir} --port ${PORT}` + : `pnpm run test:e2e:startDummyServer && pnpm start` export default defineConfig({ - testDir: '../basic-test-suite/src', + testDir: './tests', workers: 1, reporter: [['line']], - globalTeardown: '../basic-test-suite/src/setup/global.teardown.ts', + globalTeardown: './tests/setup/global.teardown.ts', use: { baseURL, }, webServer: { - command: `pnpm run test:e2e:startDummyServer && ${ssrModeCommand}`, + command: commandByMode, url: baseURL, reuseExistingServer: !process.env.CI, stdout: 'pipe', env: { - MODE: '', + MODE: mode, VITE_NODE_ENV: 'test', VITE_EXTERNAL_PORT: String(EXTERNAL_PORT), VITE_SERVER_PORT: String(PORT), START_PORT: String(START_PORT), PORT: String(PORT), + E2E_DIST_DIR: distDir, + E2E_PORT_KEY: e2ePortKey, }, }, diff --git a/e2e/vue-start/basic/postcss.config.mjs b/e2e/vue-start/basic/postcss.config.mjs new file mode 100644 index 0000000000..a7f73a2d1d --- /dev/null +++ b/e2e/vue-start/basic/postcss.config.mjs @@ -0,0 +1,5 @@ +export default { + plugins: { + '@tailwindcss/postcss': {}, + }, +} diff --git a/e2e/vue-start/basic/rsbuild.config.ts b/e2e/vue-start/basic/rsbuild.config.ts new file mode 100644 index 0000000000..93af798c3c --- /dev/null +++ b/e2e/vue-start/basic/rsbuild.config.ts @@ -0,0 +1,34 @@ +import { defineConfig } from '@rsbuild/core' +import { pluginBabel } from '@rsbuild/plugin-babel' +import { pluginVue } from '@rsbuild/plugin-vue' +import { pluginVueJsx } from '@rsbuild/plugin-vue-jsx' +import { tanstackStart } from '@tanstack/vue-start/plugin/rsbuild' +import { isPrerender } from './tests/utils/isPrerender' + +const outDir = process.env.E2E_DIST_DIR ?? 'dist' + +export default defineConfig({ + plugins: [ + pluginBabel({ + include: /\.(?:jsx|tsx)$/, + }), + pluginVue(), + pluginVueJsx(), + tanstackStart(), + ], + performance: { + chunkSplit: { + strategy: 'split-by-experience', + }, + }, + source: { + define: { + __TSR_PRERENDER__: JSON.stringify(isPrerender), + }, + }, + output: { + distPath: { + root: outDir, + }, + }, +}) diff --git a/e2e/vue-start/basic/server.js b/e2e/vue-start/basic/server.js index 83f5ff0079..69c1e4ca91 100644 --- a/e2e/vue-start/basic/server.js +++ b/e2e/vue-start/basic/server.js @@ -1,4 +1,5 @@ import { toNodeHandler } from 'srvx/node' +import fs from 'node:fs' import path from 'node:path' import express from 'express' import { createProxyMiddleware } from 'http-proxy-middleware' @@ -9,16 +10,33 @@ const startPort = process.env.START_PORT || 3001 const isSpaMode = process.env.MODE === 'spa' const isPrerender = process.env.MODE === 'prerender' +const distDir = process.env.E2E_DIST_DIR || 'dist' +const distClientDir = path.resolve(distDir, 'client') + +function resolveDistServerEntryPath() { + const serverJsPath = path.resolve(distDir, 'server', 'server.js') + if (fs.existsSync(serverJsPath)) { + return serverJsPath + } + + const indexJsPath = path.resolve(distDir, 'server', 'index.js') + if (fs.existsSync(indexJsPath)) { + return indexJsPath + } + + return serverJsPath +} export async function createStartServer() { - const server = (await import('./dist/server/server.js')).default + const distServerEntryPath = resolveDistServerEntryPath() + const server = (await import(distServerEntryPath)).default const nodeHandler = toNodeHandler(server.fetch) const app = express() // to keep testing uniform stop express from redirecting /posts to /posts/ // when serving pre-rendered pages - app.use(express.static('./dist/client', { redirect: !isPrerender })) + app.use(express.static(distClientDir, { redirect: !isPrerender })) app.use(async (req, res, next) => { try { @@ -50,10 +68,10 @@ export async function createSpaServer() { }), ) - app.use(express.static('./dist/client')) + app.use(express.static(distClientDir)) app.get('/{*splat}', (req, res) => { - res.sendFile(path.resolve('./dist/client/index.html')) + res.sendFile(path.resolve(distClientDir, 'index.html')) }) return { app } @@ -61,19 +79,22 @@ export async function createSpaServer() { if (isSpaMode) { createSpaServer().then(async ({ app }) => - app.listen(port, () => { + app.listen(port, (error) => { + if (error) throw error console.info(`Client Server: http://localhost:${port}`) }), ) createStartServer().then(async ({ app }) => - app.listen(startPort, () => { + app.listen(startPort, (error) => { + if (error) throw error console.info(`Start Server: http://localhost:${startPort}`) }), ) } else { createStartServer().then(async ({ app }) => - app.listen(port, () => { + app.listen(port, (error) => { + if (error) throw error console.info(`Start Server: http://localhost:${port}`) }), ) diff --git a/e2e/vue-start/basic/src/routes/__root.tsx b/e2e/vue-start/basic/src/routes/__root.tsx index 45b729c19c..843ec05893 100644 --- a/e2e/vue-start/basic/src/routes/__root.tsx +++ b/e2e/vue-start/basic/src/routes/__root.tsx @@ -1,17 +1,19 @@ /// import { Body, + ClientOnly, HeadContent, Html, Link, Outlet, Scripts, createRootRoute, + useRouterState, } from '@tanstack/vue-router' import { TanStackRouterDevtoolsInProd } from '@tanstack/vue-router-devtools' import { NotFound } from '~/components/NotFound' -import appCss from '~/styles/app.css?url' +import '~/styles/app.css' import { seo } from '~/utils/seo' export const Route = createRootRoute({ @@ -28,7 +30,6 @@ export const Route = createRootRoute({ }), ], links: [ - { rel: 'stylesheet', href: appCss }, { rel: 'apple-touch-icon', sizes: '180x180', @@ -67,6 +68,10 @@ export const Route = createRootRoute({ }) function RootComponent() { + const routerState = useRouterState({ + select: (state) => ({ isLoading: state.isLoading, status: state.status }), + }) + return ( @@ -157,6 +162,14 @@ function RootComponent() { This Route Does Not Exist
    + + +
    This is an inline styled div
    diff --git a/e2e/vue-start/basic-test-suite/src/navigation.spec.ts b/e2e/vue-start/basic/tests/navigation.spec.ts similarity index 100% rename from e2e/vue-start/basic-test-suite/src/navigation.spec.ts rename to e2e/vue-start/basic/tests/navigation.spec.ts diff --git a/e2e/vue-start/basic-test-suite/src/not-found.spec.ts b/e2e/vue-start/basic/tests/not-found.spec.ts similarity index 100% rename from e2e/vue-start/basic-test-suite/src/not-found.spec.ts rename to e2e/vue-start/basic/tests/not-found.spec.ts diff --git a/e2e/vue-start/basic-test-suite/src/prerendering.spec.ts b/e2e/vue-start/basic/tests/prerendering.spec.ts similarity index 90% rename from e2e/vue-start/basic-test-suite/src/prerendering.spec.ts rename to e2e/vue-start/basic/tests/prerendering.spec.ts index 66cc1f68ff..ddcf720a4c 100644 --- a/e2e/vue-start/basic-test-suite/src/prerendering.spec.ts +++ b/e2e/vue-start/basic/tests/prerendering.spec.ts @@ -3,15 +3,18 @@ import { join } from 'node:path' import { expect } from '@playwright/test' import { test } from '@tanstack/router-e2e-utils' import { isPrerender } from './utils/isPrerender' -import { getBasicAppRoot } from './utils/getBasicAppRoot' + +const distDir = join( + process.cwd(), + process.env.E2E_DIST_DIR ?? 'dist', + 'client', +) test.describe('Prerender Static Path Discovery', () => { test.skip(!isPrerender, 'Skipping since not in prerender mode') test.describe('Build Output Verification', () => { test('should automatically discover and prerender static routes', () => { // Check that static routes were automatically discovered and prerendered - const distDir = join(getBasicAppRoot(), 'dist', 'client') - // These static routes should be automatically discovered and prerendered expect(existsSync(join(distDir, 'index.html'))).toBe(true) expect(existsSync(join(distDir, 'posts/index.html'))).toBe(true) @@ -35,7 +38,6 @@ test.describe('Prerender Static Path Discovery', () => { test.describe('Static Files Verification', () => { test('should contain prerendered content in posts.html', () => { - const distDir = join(getBasicAppRoot(), 'dist', 'client') expect(existsSync(join(distDir, 'posts/index.html'))).toBe(true) // "Select a post." should be in the prerendered HTML diff --git a/e2e/solid-start/basic-test-suite/src/redirect.spec.ts b/e2e/vue-start/basic/tests/redirect.spec.ts similarity index 86% rename from e2e/solid-start/basic-test-suite/src/redirect.spec.ts rename to e2e/vue-start/basic/tests/redirect.spec.ts index c25a6b0dbf..2f6354aa81 100644 --- a/e2e/solid-start/basic-test-suite/src/redirect.spec.ts +++ b/e2e/vue-start/basic/tests/redirect.spec.ts @@ -1,19 +1,32 @@ import queryString from 'node:querystring' -import { expect } from '@playwright/test' +import { expect, type Page } from '@playwright/test' import combinateImport from 'combinate' import { getDummyServerPort, getTestServerPort, test, } from '@tanstack/router-e2e-utils' -import { getPackageName } from './utils/getPackageName.ts' +import { getE2EPortKey } from './utils/getE2EPortKey.ts' // somehow playwright does not correctly import default exports const combinate = (combinateImport as any).default as typeof combinateImport -const packageName = getPackageName() -const PORT = await getTestServerPort(packageName) -const EXTERNAL_HOST_PORT = await getDummyServerPort(packageName) +const e2ePortKey = getE2EPortKey() +const PORT = await getTestServerPort(e2ePortKey) +const EXTERNAL_HOST_PORT = await getDummyServerPort(e2ePortKey) +const POSTS_URL = `http://localhost:${PORT}/posts` + +async function waitForRouterIdle(page: Page) { + await expect(page.getByTestId('router-isLoading')).toHaveText('false') + await expect(page.getByTestId('router-status')).toHaveText('idle') +} + +async function waitForPostsIndex(page: Page) { + await page.waitForURL(POSTS_URL) + expect(page.url()).toBe(POSTS_URL) + await waitForRouterIdle(page) + await expect(page.getByTestId('PostsIndexComponent')).toBeInViewport() +} test.describe('redirects', () => { const internalNavigationTestMatrix = combinate({ @@ -34,7 +47,7 @@ test.describe('redirects', () => { `via-${thrower}${reloadDocument ? '-reloadDocument' : ''}`, ) - await page.waitForLoadState('networkidle') + await waitForRouterIdle(page) let requestHappened = false const requestPromise = new Promise((resolve) => { @@ -62,11 +75,7 @@ test.describe('redirects', () => { await link.click() - const url = `http://localhost:${PORT}/posts` - - await page.waitForURL(url) - expect(page.url()).toBe(url) - await expect(page.getByTestId('PostsIndexComponent')).toBeInViewport() + await waitForPostsIndex(page) expect(fullPageLoad).toBe(reloadDocument) }) }, @@ -83,12 +92,7 @@ test.describe('redirects', () => { }) => { await page.goto(`/redirect/internal/via-${thrower}`) - const url = `http://localhost:${PORT}/posts` - - await page.waitForURL(url) - expect(page.url()).toBe(url) - await page.waitForLoadState('networkidle') - await expect(page.getByTestId('PostsIndexComponent')).toBeInViewport() + await waitForPostsIndex(page) }) }) @@ -107,7 +111,7 @@ test.describe('redirects', () => { if (scenario === 'navigate') { await page.goto(`/redirect/external?${q}`) - await page.waitForLoadState('networkidle') + await waitForRouterIdle(page) const link = page.getByTestId(`via-${thrower}`) await link.focus() await link.click() @@ -142,7 +146,7 @@ test.describe('redirects', () => { if (scenario === 'navigate') { await page.goto(`/redirect/${target}/serverFn?${q}`) - await page.waitForLoadState('networkidle') + await waitForRouterIdle(page) const link = page.getByTestId( `via-${thrower}${reloadDocument ? '-reloadDocument' : ''}`, ) @@ -157,11 +161,12 @@ test.describe('redirects', () => { const url = target === 'internal' - ? `http://localhost:${PORT}/posts` + ? POSTS_URL : `http://localhost:${EXTERNAL_HOST_PORT}/` await page.waitForURL(url) expect(page.url()).toBe(url) if (target === 'internal' && scenario === 'navigate') { + await waitForRouterIdle(page) await expect(page.getByTestId('PostsIndexComponent')).toBeInViewport() expect(fullPageLoad).toBe(reloadDocument) } @@ -185,7 +190,7 @@ test.describe('redirects', () => { await page.goto(`/redirect/${target}/serverFn/via-useServerFn?${q}`) - await page.waitForLoadState('networkidle') + await waitForRouterIdle(page) const button = page.getByTestId('redirect-on-click') @@ -198,11 +203,12 @@ test.describe('redirects', () => { const url = target === 'internal' - ? `http://localhost:${PORT}/posts` + ? POSTS_URL : `http://localhost:${EXTERNAL_HOST_PORT}/` await page.waitForURL(url) expect(page.url()).toBe(url) if (target === 'internal') { + await waitForRouterIdle(page) await expect(page.getByTestId('PostsIndexComponent')).toBeInViewport() expect(fullPageLoad).toBe(reloadDocument) } diff --git a/e2e/vue-start/basic-test-suite/src/script-duplication.spec.ts b/e2e/vue-start/basic/tests/script-duplication.spec.ts similarity index 100% rename from e2e/vue-start/basic-test-suite/src/script-duplication.spec.ts rename to e2e/vue-start/basic/tests/script-duplication.spec.ts diff --git a/e2e/vue-start/basic-test-suite/src/search-params.spec.ts b/e2e/vue-start/basic/tests/search-params.spec.ts similarity index 100% rename from e2e/vue-start/basic-test-suite/src/search-params.spec.ts rename to e2e/vue-start/basic/tests/search-params.spec.ts diff --git a/e2e/react-start/basic-test-suite/src/setup/global.setup.ts b/e2e/vue-start/basic/tests/setup/global.setup.ts similarity index 50% rename from e2e/react-start/basic-test-suite/src/setup/global.setup.ts rename to e2e/vue-start/basic/tests/setup/global.setup.ts index fc06a65591..cd38c35885 100644 --- a/e2e/react-start/basic-test-suite/src/setup/global.setup.ts +++ b/e2e/vue-start/basic/tests/setup/global.setup.ts @@ -1,6 +1,6 @@ import { e2eStartDummyServer } from '@tanstack/router-e2e-utils' -import { getPackageName } from '../utils/getPackageName.ts' +import { getE2EPortKey } from '../utils/getE2EPortKey.ts' export default async function setup() { - await e2eStartDummyServer(getPackageName()) + await e2eStartDummyServer(getE2EPortKey()) } diff --git a/e2e/vue-start/basic-test-suite/src/setup/global.teardown.ts b/e2e/vue-start/basic/tests/setup/global.teardown.ts similarity index 55% rename from e2e/vue-start/basic-test-suite/src/setup/global.teardown.ts rename to e2e/vue-start/basic/tests/setup/global.teardown.ts index a8a6899700..36e5c92858 100644 --- a/e2e/vue-start/basic-test-suite/src/setup/global.teardown.ts +++ b/e2e/vue-start/basic/tests/setup/global.teardown.ts @@ -1,8 +1,8 @@ import { e2eStopDummyServer } from '@tanstack/router-e2e-utils' -import { getPackageName } from '../utils/getPackageName.ts' +import { getE2EPortKey } from '../utils/getE2EPortKey.ts' export default async function teardown() { try { - await e2eStopDummyServer(getPackageName()) + await e2eStopDummyServer(getE2EPortKey()) } catch {} } diff --git a/e2e/react-start/basic-test-suite/src/setup/waitForDummyServer.ts b/e2e/vue-start/basic/tests/setup/waitForDummyServer.ts similarity index 82% rename from e2e/react-start/basic-test-suite/src/setup/waitForDummyServer.ts rename to e2e/vue-start/basic/tests/setup/waitForDummyServer.ts index f27dc86d5b..88c18fd79e 100644 --- a/e2e/react-start/basic-test-suite/src/setup/waitForDummyServer.ts +++ b/e2e/vue-start/basic/tests/setup/waitForDummyServer.ts @@ -1,11 +1,11 @@ import { getDummyServerPort } from '@tanstack/router-e2e-utils' -import { getPackageName } from '../utils/getPackageName.ts' +import { getE2EPortKey } from '../utils/getE2EPortKey.ts' const timeoutMs = 10_000 const retryIntervalMs = 100 export default async function waitForDummyServer() { - const port = await getDummyServerPort(getPackageName()) + const port = await getDummyServerPort(getE2EPortKey()) const deadline = Date.now() + timeoutMs while (Date.now() < deadline) { diff --git a/e2e/vue-start/basic-test-suite/src/special-characters.spec.ts b/e2e/vue-start/basic/tests/special-characters.spec.ts similarity index 90% rename from e2e/vue-start/basic-test-suite/src/special-characters.spec.ts rename to e2e/vue-start/basic/tests/special-characters.spec.ts index 6bbb240a84..284097d72b 100644 --- a/e2e/vue-start/basic-test-suite/src/special-characters.spec.ts +++ b/e2e/vue-start/basic/tests/special-characters.spec.ts @@ -175,6 +175,12 @@ test.describe('Unicode route rendering', () => { }) test.describe('malformed paths', () => { + const malformedPathnames = [ + '/specialChars/malformed/%E0%A4', + '/specialChars/malformed/%80', + '/specialChars/malformed/%FF', + ] + test.use({ whitelistErrors: [ 'Failed to load resource: the server responded with a status of 404', @@ -182,24 +188,22 @@ test.describe('Unicode route rendering', () => { ], }) - test('un-matched malformed paths should return not found on direct navigation', async ({ - page, - }) => { - const res = await page.goto('/specialChars/malformed/%E0%A4') + for (const pathname of malformedPathnames) { + test(`un-matched malformed path "${pathname}" should return bad request on direct navigation`, async ({ + page, + }) => { + const res = await page.goto(pathname) - await page.waitForLoadState(`load`) + await page.waitForLoadState(`load`) - // in spa mode this is caught and handled at server level - if (!isSpaMode) { - expect(res!.status()).toBe(404) - - await expect( - page.getByTestId('default-not-found-component'), - ).toBeInViewport() - } else { - expect(res!.status()).toBe(400) - } - }) + // in spa mode this is caught and handled at server level + if (!isSpaMode) { + expect(res!.status()).toBe(400) + } else { + expect(res!.status()).toBe(400) + } + }) + } test('malformed path params should return not found on router link', async ({ page, diff --git a/e2e/vue-start/basic-test-suite/src/streaming.spec.ts b/e2e/vue-start/basic/tests/streaming.spec.ts similarity index 100% rename from e2e/vue-start/basic-test-suite/src/streaming.spec.ts rename to e2e/vue-start/basic/tests/streaming.spec.ts diff --git a/e2e/vue-start/basic/tests/utils/getE2EPortKey.ts b/e2e/vue-start/basic/tests/utils/getE2EPortKey.ts new file mode 100644 index 0000000000..48be6a9027 --- /dev/null +++ b/e2e/vue-start/basic/tests/utils/getE2EPortKey.ts @@ -0,0 +1,5 @@ +import { getPackageName } from './getPackageName.ts' + +export function getE2EPortKey() { + return process.env.E2E_PORT_KEY ?? getPackageName() +} diff --git a/e2e/vue-start/basic-test-suite/src/utils/getPackageName.ts b/e2e/vue-start/basic/tests/utils/getPackageName.ts similarity index 100% rename from e2e/vue-start/basic-test-suite/src/utils/getPackageName.ts rename to e2e/vue-start/basic/tests/utils/getPackageName.ts diff --git a/e2e/vue-start/basic/tsconfig.json b/e2e/vue-start/basic/tsconfig.json index 6f99c0f49a..1b2ac7b943 100644 --- a/e2e/vue-start/basic/tsconfig.json +++ b/e2e/vue-start/basic/tsconfig.json @@ -9,6 +9,7 @@ "moduleResolution": "Bundler", "lib": ["DOM", "DOM.Iterable", "ES2022"], "isolatedModules": true, + "allowImportingTsExtensions": true, "resolveJsonModule": true, "skipLibCheck": true, "target": "ES2022", diff --git a/e2e/vue-start/basic/vite.config.ts b/e2e/vue-start/basic/vite.config.ts index e638e37f36..6fe8d5d194 100644 --- a/e2e/vue-start/basic/vite.config.ts +++ b/e2e/vue-start/basic/vite.config.ts @@ -30,8 +30,13 @@ const prerenderConfiguration = { maxRedirects: 100, } +const outDir = process.env.E2E_DIST_DIR ?? 'dist' + export default defineConfig({ resolve: { tsconfigPaths: true }, + build: { + outDir, + }, server: { port: 3000, }, diff --git a/e2e/vue-start/css-modules/package.json b/e2e/vue-start/css-modules/package.json index 76506c47a2..9b7d36333d 100644 --- a/e2e/vue-start/css-modules/package.json +++ b/e2e/vue-start/css-modules/package.json @@ -26,6 +26,6 @@ "sass": "^1.97.2", "srvx": "^0.11.9", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/e2e/vue-start/custom-basepath/express-server.ts b/e2e/vue-start/custom-basepath/express-server.ts index 87dcfb50da..1884c5eb5a 100644 --- a/e2e/vue-start/custom-basepath/express-server.ts +++ b/e2e/vue-start/custom-basepath/express-server.ts @@ -40,6 +40,7 @@ if (DEVELOPMENT) { }) } -app.listen(PORT, () => { +app.listen(PORT, (error) => { + if (error) throw error console.log(`Server is running on http://localhost:${PORT}`) }) diff --git a/e2e/vue-start/custom-basepath/package.json b/e2e/vue-start/custom-basepath/package.json index 9d9f7781f5..759e13b48e 100644 --- a/e2e/vue-start/custom-basepath/package.json +++ b/e2e/vue-start/custom-basepath/package.json @@ -14,7 +14,7 @@ "@tanstack/vue-router": "workspace:^", "@tanstack/vue-router-devtools": "workspace:^", "@tanstack/vue-start": "workspace:^", - "express": "^5.1.0", + "express": "^5.2.1", "redaxios": "^0.5.1", "vue": "^3.5.25" }, @@ -22,14 +22,14 @@ "@playwright/test": "^1.50.1", "@tailwindcss/vite": "^4.2.2", "@tanstack/router-e2e-utils": "workspace:^", - "@types/express": "^5.0.3", + "@types/express": "^5.0.6", "@types/node": "^22.10.2", "cross-env": "^10.0.0", "srvx": "^0.11.9", "tailwindcss": "^4.2.2", "tsx": "^4.20.3", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "@vitejs/plugin-vue": "^6.0.5", "@vitejs/plugin-vue-jsx": "^5.1.5" } diff --git a/e2e/vue-start/query-integration/package.json b/e2e/vue-start/query-integration/package.json index 2ba30f2234..d44bd58376 100644 --- a/e2e/vue-start/query-integration/package.json +++ b/e2e/vue-start/query-integration/package.json @@ -18,10 +18,9 @@ "@tanstack/vue-router-devtools": "workspace:^", "@tanstack/vue-router-ssr-query": "workspace:^", "@tanstack/vue-start": "workspace:^", + "tailwind-merge": "^3.6.0", "vue": "^3.5.16", - "tailwind-merge": "^2.6.0", - "vite": "^8.0.0", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -31,6 +30,7 @@ "@vitejs/plugin-vue": "^6.0.5", "@vitejs/plugin-vue-jsx": "^5.1.5", "tailwindcss": "^4.2.2", - "typescript": "^6.0.2" + "typescript": "^6.0.2", + "vite": "^8.0.14" } } diff --git a/e2e/vue-start/scroll-restoration/package.json b/e2e/vue-start/scroll-restoration/package.json index 8066e02be3..871200e852 100644 --- a/e2e/vue-start/scroll-restoration/package.json +++ b/e2e/vue-start/scroll-restoration/package.json @@ -15,23 +15,22 @@ "@tanstack/vue-router": "workspace:^", "@tanstack/vue-router-devtools": "workspace:^", "@tanstack/vue-start": "workspace:^", - "@tanstack/zod-adapter": "workspace:^", "redaxios": "^0.5.1", - "tailwind-merge": "^2.6.0", - "vite": "^8.0.0", + "tailwind-merge": "^3.6.0", "vue": "^3.5.25", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", "@tailwindcss/vite": "^4.2.2", "@tanstack/router-e2e-utils": "workspace:^", "@types/node": "^22.10.2", + "@vitejs/plugin-vue": "^6.0.5", + "@vitejs/plugin-vue-jsx": "^5.1.5", "combinate": "^1.1.11", "srvx": "^0.11.9", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "@vitejs/plugin-vue": "^6.0.5", - "@vitejs/plugin-vue-jsx": "^5.1.5" + "vite": "^8.0.14" } } diff --git a/e2e/vue-start/scroll-restoration/src/routes/(tests)/with-search.tsx b/e2e/vue-start/scroll-restoration/src/routes/(tests)/with-search.tsx index 4edc141440..f19c280d80 100644 --- a/e2e/vue-start/scroll-restoration/src/routes/(tests)/with-search.tsx +++ b/e2e/vue-start/scroll-restoration/src/routes/(tests)/with-search.tsx @@ -1,10 +1,9 @@ import { createFileRoute } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' import { ScrollBlock } from '../-components/scroll-block' export const Route = createFileRoute('/(tests)/with-search')({ - validateSearch: zodValidator(z.object({ where: z.string() })), + validateSearch: z.object({ where: z.string() }), component: Component, }) diff --git a/e2e/vue-start/selective-ssr/package.json b/e2e/vue-start/selective-ssr/package.json index 3024e26aa3..95c82b2511 100644 --- a/e2e/vue-start/selective-ssr/package.json +++ b/e2e/vue-start/selective-ssr/package.json @@ -15,17 +15,17 @@ "@tanstack/vue-router": "workspace:^", "@tanstack/vue-start": "workspace:^", "vue": "^3.5.25", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@tailwindcss/vite": "^4.2.2", "@tanstack/router-e2e-utils": "workspace:^", + "@vitejs/plugin-vue": "^6.0.5", + "@vitejs/plugin-vue-jsx": "^5.1.5", "srvx": "^0.11.9", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", - "@vitejs/plugin-vue": "^6.0.5", - "@vitejs/plugin-vue-jsx": "^5.1.5", + "vite": "^8.0.14", "vue-tsc": "^3.1.8" } } diff --git a/e2e/vue-start/serialization-adapters/package.json b/e2e/vue-start/serialization-adapters/package.json index 8bc87bba17..d854c0bb7c 100644 --- a/e2e/vue-start/serialization-adapters/package.json +++ b/e2e/vue-start/serialization-adapters/package.json @@ -16,17 +16,17 @@ "@tanstack/vue-router-devtools": "workspace:^", "@tanstack/vue-start": "workspace:^", "vue": "^3.5.25", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@tailwindcss/vite": "^4.2.2", "@tanstack/router-e2e-utils": "workspace:^", + "@vitejs/plugin-vue": "^6.0.5", + "@vitejs/plugin-vue-jsx": "^5.1.5", "srvx": "^0.11.9", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", - "@vitejs/plugin-vue": "^6.0.5", - "@vitejs/plugin-vue-jsx": "^5.1.5", + "vite": "^8.0.14", "vue-tsc": "^3.1.8" } } diff --git a/e2e/vue-start/server-functions/package.json b/e2e/vue-start/server-functions/package.json index 9fc4f2b379..2e84c6238e 100644 --- a/e2e/vue-start/server-functions/package.json +++ b/e2e/vue-start/server-functions/package.json @@ -19,10 +19,9 @@ "@tanstack/vue-start": "workspace:^", "js-cookie": "^3.0.5", "redaxios": "^0.5.1", - "tailwind-merge": "^2.6.0", - "vite": "^8.0.0", + "tailwind-merge": "^3.6.0", "vue": "^3.5.25", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -30,11 +29,12 @@ "@tanstack/router-e2e-utils": "workspace:^", "@types/js-cookie": "^3.0.6", "@types/node": "^22.10.2", + "@vitejs/plugin-vue": "^6.0.5", + "@vitejs/plugin-vue-jsx": "^5.1.5", "combinate": "^1.1.11", "srvx": "^0.11.9", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "@vitejs/plugin-vue": "^6.0.5", - "@vitejs/plugin-vue-jsx": "^5.1.5" + "vite": "^8.0.14" } } diff --git a/e2e/vue-start/server-functions/src/routes/cookies/index.tsx b/e2e/vue-start/server-functions/src/routes/cookies/index.tsx index 5da8860ac6..d7fef10223 100644 --- a/e2e/vue-start/server-functions/src/routes/cookies/index.tsx +++ b/e2e/vue-start/server-functions/src/routes/cookies/index.tsx @@ -2,7 +2,8 @@ import { Link, createFileRoute } from '@tanstack/vue-router' import { z } from 'zod' const cookieSchema = z - .object({ value: z.string() }) + .object({ value: z.string().default(() => `CLIENT-${Date.now()}`) }) + .prefault({}) .catch(() => ({ value: `CLIENT-${Date.now()}` })) export const Route = createFileRoute('/cookies/')({ validateSearch: cookieSchema, diff --git a/e2e/vue-start/server-routes/package.json b/e2e/vue-start/server-routes/package.json index 4362a407ee..6e5c7cdced 100644 --- a/e2e/vue-start/server-routes/package.json +++ b/e2e/vue-start/server-routes/package.json @@ -19,10 +19,9 @@ "@tanstack/vue-start": "workspace:^", "js-cookie": "^3.0.5", "redaxios": "^0.5.1", - "tailwind-merge": "^2.6.0", - "vite": "^8.0.0", + "tailwind-merge": "^3.6.0", "vue": "^3.5.25", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", @@ -30,11 +29,12 @@ "@tanstack/router-e2e-utils": "workspace:^", "@types/js-cookie": "^3.0.6", "@types/node": "^22.10.2", + "@vitejs/plugin-vue": "^6.0.5", + "@vitejs/plugin-vue-jsx": "^5.1.5", "combinate": "^1.1.11", "srvx": "^0.11.9", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "@vitejs/plugin-vue": "^6.0.5", - "@vitejs/plugin-vue-jsx": "^5.1.5" + "vite": "^8.0.14" } } diff --git a/e2e/vue-start/spa-mode/package.json b/e2e/vue-start/spa-mode/package.json index 9754caf140..1795d2d5c4 100644 --- a/e2e/vue-start/spa-mode/package.json +++ b/e2e/vue-start/spa-mode/package.json @@ -16,15 +16,15 @@ "@tanstack/vue-router-devtools": "workspace:^", "@tanstack/vue-start": "workspace:^", "vue": "^3.5.25", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@tailwindcss/vite": "^4.2.2", "@tanstack/router-e2e-utils": "workspace:^", + "@vitejs/plugin-vue": "^6.0.5", + "@vitejs/plugin-vue-jsx": "^5.1.5", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", - "@vitejs/plugin-vue": "^6.0.5", - "@vitejs/plugin-vue-jsx": "^5.1.5" + "vite": "^8.0.14" } } diff --git a/e2e/vue-start/start-manifest/package.json b/e2e/vue-start/start-manifest/package.json new file mode 100644 index 0000000000..841aa5da85 --- /dev/null +++ b/e2e/vue-start/start-manifest/package.json @@ -0,0 +1,33 @@ +{ + "name": "tanstack-vue-start-e2e-start-manifest", + "private": true, + "sideEffects": false, + "type": "module", + "scripts": { + "build": "vite build && tsc --noEmit", + "preview": "vite preview", + "start": "pnpx srvx --prod -s ../client dist/server/server.js", + "test:e2e": "playwright test --project=chromium" + }, + "dependencies": { + "@tanstack/vue-router": "workspace:^", + "@tanstack/vue-start": "workspace:^", + "vue": "^3.5.16" + }, + "devDependencies": { + "@playwright/test": "^1.50.1", + "@tanstack/router-e2e-utils": "workspace:^", + "@types/node": "^22.10.2", + "@vitejs/plugin-vue-jsx": "^5.1.5", + "srvx": "^0.11.9", + "typescript": "^6.0.2", + "vite": "^8.0.14" + }, + "nx": { + "targets": { + "test:e2e": { + "parallelism": false + } + } + } +} diff --git a/e2e/vue-start/start-manifest/playwright.config.ts b/e2e/vue-start/start-manifest/playwright.config.ts new file mode 100644 index 0000000000..b9f835c16a --- /dev/null +++ b/e2e/vue-start/start-manifest/playwright.config.ts @@ -0,0 +1,30 @@ +import { defineConfig, devices } from '@playwright/test' +import { getTestServerPort } from '@tanstack/router-e2e-utils' +import packageJson from './package.json' with { type: 'json' } + +const PORT = await getTestServerPort(packageJson.name) +const baseURL = `http://localhost:${PORT}` + +export default defineConfig({ + testDir: './tests', + workers: 1, + reporter: [['line']], + + use: { + baseURL, + }, + + webServer: { + command: `pnpm build && PORT=${PORT} pnpm start`, + url: baseURL, + reuseExistingServer: !process.env.CI, + stdout: 'pipe', + }, + + projects: [ + { + name: 'chromium', + use: { ...devices['Desktop Chrome'] }, + }, + ], +}) diff --git a/e2e/vue-start/start-manifest/src/components/AppShell.tsx b/e2e/vue-start/start-manifest/src/components/AppShell.tsx new file mode 100644 index 0000000000..0d57b2d0e3 --- /dev/null +++ b/e2e/vue-start/start-manifest/src/components/AppShell.tsx @@ -0,0 +1,38 @@ +/// +import { ClientOnly, Link, Outlet, linkOptions } from '@tanstack/vue-router' +import styles from '~/styles/root-shell.module.css' + +const ROUTES = linkOptions([ + { to: '/', label: 'home' }, + { to: '/a', label: '/a' }, + { to: '/b', label: '/b' }, + { to: '/lazy-css-static', label: '/lazy-css-static' }, + { to: '/lazy-css-lazy', label: '/lazy-css-lazy' }, + { to: '/r1', label: '/r1' }, + { to: '/r2', label: '/r2' }, + { to: '/shared-a', label: '/shared-a' }, +]) + +export function AppShell() { + return ( +
    + + +
    +
    + Start manifest CSS root shell +
    + +
    hydrated
    +
    + +
    +
    + ) +} diff --git a/e2e/vue-start/start-manifest/src/components/SharedCard.tsx b/e2e/vue-start/start-manifest/src/components/SharedCard.tsx new file mode 100644 index 0000000000..c82b2b0ea5 --- /dev/null +++ b/e2e/vue-start/start-manifest/src/components/SharedCard.tsx @@ -0,0 +1,10 @@ +/// +import styles from '~/styles/shared-card.module.css' + +export function SharedCard({ label }: { label: string }) { + return ( +
    + Shared card {label} +
    + ) +} diff --git a/e2e/vue-start/start-manifest/src/components/SharedNestedLayout.tsx b/e2e/vue-start/start-manifest/src/components/SharedNestedLayout.tsx new file mode 100644 index 0000000000..9c1f63f2f9 --- /dev/null +++ b/e2e/vue-start/start-manifest/src/components/SharedNestedLayout.tsx @@ -0,0 +1,34 @@ +/// +import { Link, linkOptions } from '@tanstack/vue-router' +import { defineComponent } from 'vue' +import styles from '~/styles/shared-layout.module.css' + +const ROUTES = linkOptions([ + { to: '/shared-a', label: '/shared-a' }, + { to: '/shared-b', label: '/shared-b' }, + { to: '/shared-c', label: '/shared-c' }, +]) + +export const SharedNestedLayout = defineComponent({ + setup(_, { slots }) { + return () => ( +
    +
    + Shared nested layout CSS +
    + + + +
    + {slots.default?.()} +
    +
    + ) + }, +}) diff --git a/e2e/vue-start/start-manifest/src/components/SharedWidget.tsx b/e2e/vue-start/start-manifest/src/components/SharedWidget.tsx new file mode 100644 index 0000000000..9074d5b2b0 --- /dev/null +++ b/e2e/vue-start/start-manifest/src/components/SharedWidget.tsx @@ -0,0 +1,15 @@ +/// +import styles from '~/styles/shared-widget.module.css' + +export function SharedWidget() { + return ( +
    +
    + Shared widget styles +
    +
    + This widget uses CSS shared by a static route and a lazy route. +
    +
    + ) +} diff --git a/e2e/vue-start/start-manifest/src/components/SharedWidgetLazy.tsx b/e2e/vue-start/start-manifest/src/components/SharedWidgetLazy.tsx new file mode 100644 index 0000000000..5f1f6410a5 --- /dev/null +++ b/e2e/vue-start/start-manifest/src/components/SharedWidgetLazy.tsx @@ -0,0 +1,5 @@ +import { SharedWidget } from './SharedWidget' + +export default function SharedWidgetLazy() { + return +} diff --git a/e2e/vue-start/start-manifest/src/routeTree.gen.ts b/e2e/vue-start/start-manifest/src/routeTree.gen.ts new file mode 100644 index 0000000000..357d3be62b --- /dev/null +++ b/e2e/vue-start/start-manifest/src/routeTree.gen.ts @@ -0,0 +1,345 @@ +/* eslint-disable */ + +// @ts-nocheck + +// noinspection JSUnusedGlobalSymbols + +// This file was automatically generated by TanStack Router. +// You should NOT make any changes in this file as it will be overwritten. +// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. + +import { Route as rootRouteImport } from './routes/__root' +import { Route as SharedCRouteImport } from './routes/shared-c' +import { Route as SharedBRouteImport } from './routes/shared-b' +import { Route as SharedARouteImport } from './routes/shared-a' +import { Route as R6RouteImport } from './routes/r6' +import { Route as R5RouteImport } from './routes/r5' +import { Route as R4RouteImport } from './routes/r4' +import { Route as R3RouteImport } from './routes/r3' +import { Route as R2RouteImport } from './routes/r2' +import { Route as R1RouteImport } from './routes/r1' +import { Route as LazyCssStaticRouteImport } from './routes/lazy-css-static' +import { Route as LazyCssLazyRouteImport } from './routes/lazy-css-lazy' +import { Route as BRouteImport } from './routes/b' +import { Route as ARouteImport } from './routes/a' +import { Route as IndexRouteImport } from './routes/index' + +const SharedCRoute = SharedCRouteImport.update({ + id: '/shared-c', + path: '/shared-c', + getParentRoute: () => rootRouteImport, +} as any) +const SharedBRoute = SharedBRouteImport.update({ + id: '/shared-b', + path: '/shared-b', + getParentRoute: () => rootRouteImport, +} as any) +const SharedARoute = SharedARouteImport.update({ + id: '/shared-a', + path: '/shared-a', + getParentRoute: () => rootRouteImport, +} as any) +const R6Route = R6RouteImport.update({ + id: '/r6', + path: '/r6', + getParentRoute: () => rootRouteImport, +} as any) +const R5Route = R5RouteImport.update({ + id: '/r5', + path: '/r5', + getParentRoute: () => rootRouteImport, +} as any) +const R4Route = R4RouteImport.update({ + id: '/r4', + path: '/r4', + getParentRoute: () => rootRouteImport, +} as any) +const R3Route = R3RouteImport.update({ + id: '/r3', + path: '/r3', + getParentRoute: () => rootRouteImport, +} as any) +const R2Route = R2RouteImport.update({ + id: '/r2', + path: '/r2', + getParentRoute: () => rootRouteImport, +} as any) +const R1Route = R1RouteImport.update({ + id: '/r1', + path: '/r1', + getParentRoute: () => rootRouteImport, +} as any) +const LazyCssStaticRoute = LazyCssStaticRouteImport.update({ + id: '/lazy-css-static', + path: '/lazy-css-static', + getParentRoute: () => rootRouteImport, +} as any) +const LazyCssLazyRoute = LazyCssLazyRouteImport.update({ + id: '/lazy-css-lazy', + path: '/lazy-css-lazy', + getParentRoute: () => rootRouteImport, +} as any) +const BRoute = BRouteImport.update({ + id: '/b', + path: '/b', + getParentRoute: () => rootRouteImport, +} as any) +const ARoute = ARouteImport.update({ + id: '/a', + path: '/a', + getParentRoute: () => rootRouteImport, +} as any) +const IndexRoute = IndexRouteImport.update({ + id: '/', + path: '/', + getParentRoute: () => rootRouteImport, +} as any) + +export interface FileRoutesByFullPath { + '/': typeof IndexRoute + '/a': typeof ARoute + '/b': typeof BRoute + '/lazy-css-lazy': typeof LazyCssLazyRoute + '/lazy-css-static': typeof LazyCssStaticRoute + '/r1': typeof R1Route + '/r2': typeof R2Route + '/r3': typeof R3Route + '/r4': typeof R4Route + '/r5': typeof R5Route + '/r6': typeof R6Route + '/shared-a': typeof SharedARoute + '/shared-b': typeof SharedBRoute + '/shared-c': typeof SharedCRoute +} +export interface FileRoutesByTo { + '/': typeof IndexRoute + '/a': typeof ARoute + '/b': typeof BRoute + '/lazy-css-lazy': typeof LazyCssLazyRoute + '/lazy-css-static': typeof LazyCssStaticRoute + '/r1': typeof R1Route + '/r2': typeof R2Route + '/r3': typeof R3Route + '/r4': typeof R4Route + '/r5': typeof R5Route + '/r6': typeof R6Route + '/shared-a': typeof SharedARoute + '/shared-b': typeof SharedBRoute + '/shared-c': typeof SharedCRoute +} +export interface FileRoutesById { + __root__: typeof rootRouteImport + '/': typeof IndexRoute + '/a': typeof ARoute + '/b': typeof BRoute + '/lazy-css-lazy': typeof LazyCssLazyRoute + '/lazy-css-static': typeof LazyCssStaticRoute + '/r1': typeof R1Route + '/r2': typeof R2Route + '/r3': typeof R3Route + '/r4': typeof R4Route + '/r5': typeof R5Route + '/r6': typeof R6Route + '/shared-a': typeof SharedARoute + '/shared-b': typeof SharedBRoute + '/shared-c': typeof SharedCRoute +} +export interface FileRouteTypes { + fileRoutesByFullPath: FileRoutesByFullPath + fullPaths: + | '/' + | '/a' + | '/b' + | '/lazy-css-lazy' + | '/lazy-css-static' + | '/r1' + | '/r2' + | '/r3' + | '/r4' + | '/r5' + | '/r6' + | '/shared-a' + | '/shared-b' + | '/shared-c' + fileRoutesByTo: FileRoutesByTo + to: + | '/' + | '/a' + | '/b' + | '/lazy-css-lazy' + | '/lazy-css-static' + | '/r1' + | '/r2' + | '/r3' + | '/r4' + | '/r5' + | '/r6' + | '/shared-a' + | '/shared-b' + | '/shared-c' + id: + | '__root__' + | '/' + | '/a' + | '/b' + | '/lazy-css-lazy' + | '/lazy-css-static' + | '/r1' + | '/r2' + | '/r3' + | '/r4' + | '/r5' + | '/r6' + | '/shared-a' + | '/shared-b' + | '/shared-c' + fileRoutesById: FileRoutesById +} +export interface RootRouteChildren { + IndexRoute: typeof IndexRoute + ARoute: typeof ARoute + BRoute: typeof BRoute + LazyCssLazyRoute: typeof LazyCssLazyRoute + LazyCssStaticRoute: typeof LazyCssStaticRoute + R1Route: typeof R1Route + R2Route: typeof R2Route + R3Route: typeof R3Route + R4Route: typeof R4Route + R5Route: typeof R5Route + R6Route: typeof R6Route + SharedARoute: typeof SharedARoute + SharedBRoute: typeof SharedBRoute + SharedCRoute: typeof SharedCRoute +} + +declare module '@tanstack/vue-router' { + interface FileRoutesByPath { + '/shared-c': { + id: '/shared-c' + path: '/shared-c' + fullPath: '/shared-c' + preLoaderRoute: typeof SharedCRouteImport + parentRoute: typeof rootRouteImport + } + '/shared-b': { + id: '/shared-b' + path: '/shared-b' + fullPath: '/shared-b' + preLoaderRoute: typeof SharedBRouteImport + parentRoute: typeof rootRouteImport + } + '/shared-a': { + id: '/shared-a' + path: '/shared-a' + fullPath: '/shared-a' + preLoaderRoute: typeof SharedARouteImport + parentRoute: typeof rootRouteImport + } + '/r6': { + id: '/r6' + path: '/r6' + fullPath: '/r6' + preLoaderRoute: typeof R6RouteImport + parentRoute: typeof rootRouteImport + } + '/r5': { + id: '/r5' + path: '/r5' + fullPath: '/r5' + preLoaderRoute: typeof R5RouteImport + parentRoute: typeof rootRouteImport + } + '/r4': { + id: '/r4' + path: '/r4' + fullPath: '/r4' + preLoaderRoute: typeof R4RouteImport + parentRoute: typeof rootRouteImport + } + '/r3': { + id: '/r3' + path: '/r3' + fullPath: '/r3' + preLoaderRoute: typeof R3RouteImport + parentRoute: typeof rootRouteImport + } + '/r2': { + id: '/r2' + path: '/r2' + fullPath: '/r2' + preLoaderRoute: typeof R2RouteImport + parentRoute: typeof rootRouteImport + } + '/r1': { + id: '/r1' + path: '/r1' + fullPath: '/r1' + preLoaderRoute: typeof R1RouteImport + parentRoute: typeof rootRouteImport + } + '/lazy-css-static': { + id: '/lazy-css-static' + path: '/lazy-css-static' + fullPath: '/lazy-css-static' + preLoaderRoute: typeof LazyCssStaticRouteImport + parentRoute: typeof rootRouteImport + } + '/lazy-css-lazy': { + id: '/lazy-css-lazy' + path: '/lazy-css-lazy' + fullPath: '/lazy-css-lazy' + preLoaderRoute: typeof LazyCssLazyRouteImport + parentRoute: typeof rootRouteImport + } + '/b': { + id: '/b' + path: '/b' + fullPath: '/b' + preLoaderRoute: typeof BRouteImport + parentRoute: typeof rootRouteImport + } + '/a': { + id: '/a' + path: '/a' + fullPath: '/a' + preLoaderRoute: typeof ARouteImport + parentRoute: typeof rootRouteImport + } + '/': { + id: '/' + path: '/' + fullPath: '/' + preLoaderRoute: typeof IndexRouteImport + parentRoute: typeof rootRouteImport + } + } +} + +const rootRouteChildren: RootRouteChildren = { + IndexRoute: IndexRoute, + ARoute: ARoute, + BRoute: BRoute, + LazyCssLazyRoute: LazyCssLazyRoute, + LazyCssStaticRoute: LazyCssStaticRoute, + R1Route: R1Route, + R2Route: R2Route, + R3Route: R3Route, + R4Route: R4Route, + R5Route: R5Route, + R6Route: R6Route, + SharedARoute: SharedARoute, + SharedBRoute: SharedBRoute, + SharedCRoute: SharedCRoute, +} +export const routeTree = rootRouteImport + ._addFileChildren(rootRouteChildren) + ._addFileTypes() + +import type { getRouter } from './router.tsx' +import type { createStart } from '@tanstack/vue-start' +declare module '@tanstack/vue-start' { + interface Register { + ssr: true + router: Awaited> + } +} diff --git a/e2e/vue-start/start-manifest/src/router.tsx b/e2e/vue-start/start-manifest/src/router.tsx new file mode 100644 index 0000000000..d7cd8e8284 --- /dev/null +++ b/e2e/vue-start/start-manifest/src/router.tsx @@ -0,0 +1,18 @@ +import { createRouter } from '@tanstack/vue-router' +import { routeTree } from './routeTree.gen' + +export const getRouter = () => { + const router = createRouter({ + routeTree, + scrollRestoration: true, + defaultPreload: 'intent', + }) + + return router +} + +declare module '@tanstack/vue-router' { + interface Register { + router: ReturnType + } +} diff --git a/e2e/vue-start/start-manifest/src/routes/__root.tsx b/e2e/vue-start/start-manifest/src/routes/__root.tsx new file mode 100644 index 0000000000..b62d37c0f0 --- /dev/null +++ b/e2e/vue-start/start-manifest/src/routes/__root.tsx @@ -0,0 +1,35 @@ +/// +import { + Body, + HeadContent, + Html, + Scripts, + createRootRoute, +} from '@tanstack/vue-router' +import { AppShell } from '~/components/AppShell' + +export const Route = createRootRoute({ + head: () => ({ + meta: [ + { charSet: 'utf-8' }, + { name: 'viewport', content: 'width=device-width, initial-scale=1' }, + { title: 'TanStack Start Manifest Bloat E2E' }, + ], + }), + component: AppShell, + shellComponent: RootDocument, +}) + +function RootDocument(_: unknown, { slots }: { slots: any }) { + return ( + + + + + + {slots.default?.()} + + + + ) +} diff --git a/e2e/vue-start/start-manifest/src/routes/a.tsx b/e2e/vue-start/start-manifest/src/routes/a.tsx new file mode 100644 index 0000000000..e53399273d --- /dev/null +++ b/e2e/vue-start/start-manifest/src/routes/a.tsx @@ -0,0 +1,18 @@ +/// +import { createFileRoute } from '@tanstack/vue-router' +import { SharedCard } from '~/components/SharedCard' +import styles from '~/styles/page-a.module.css' + +export const Route = createFileRoute('/a')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( +
    +

    Route /a

    +

    Route /a keeps the shared card styled.

    + +
    + ) +} diff --git a/e2e/vue-start/start-manifest/src/routes/b.tsx b/e2e/vue-start/start-manifest/src/routes/b.tsx new file mode 100644 index 0000000000..cb989a257f --- /dev/null +++ b/e2e/vue-start/start-manifest/src/routes/b.tsx @@ -0,0 +1,18 @@ +/// +import { createFileRoute } from '@tanstack/vue-router' +import { SharedCard } from '~/components/SharedCard' +import styles from '~/styles/page-b.module.css' + +export const Route = createFileRoute('/b')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( +
    +

    Route /b

    +

    Route /b should keep the shared card stylesheet after nav.

    + +
    + ) +} diff --git a/e2e/vue-start/start-manifest/src/routes/index.tsx b/e2e/vue-start/start-manifest/src/routes/index.tsx new file mode 100644 index 0000000000..728cc55e88 --- /dev/null +++ b/e2e/vue-start/start-manifest/src/routes/index.tsx @@ -0,0 +1,16 @@ +import { createFileRoute } from '@tanstack/vue-router' + +export const Route = createFileRoute('/')({ + component: HomeRoute, +}) + +function HomeRoute() { + return ( +
    +

    Start manifest fixture

    +

    + Use this page to navigate between CSS module routes. +

    +
    + ) +} diff --git a/e2e/vue-start/start-manifest/src/routes/lazy-css-lazy.tsx b/e2e/vue-start/start-manifest/src/routes/lazy-css-lazy.tsx new file mode 100644 index 0000000000..0db0845425 --- /dev/null +++ b/e2e/vue-start/start-manifest/src/routes/lazy-css-lazy.tsx @@ -0,0 +1,31 @@ +import { createFileRoute } from '@tanstack/vue-router' +import { Suspense, defineAsyncComponent } from 'vue' + +const LazySharedWidget = defineAsyncComponent( + () => import('~/components/SharedWidgetLazy'), +) + +export const Route = createFileRoute('/lazy-css-lazy')({ + component: LazyCssLazyRoute, +}) + +function LazyCssLazyRoute() { + return ( +
    +

    Lazy CSS Repro - Lazy Route

    +

    + This route renders the same widget through a lazy component so the CSS + only exists behind a dynamic import boundary. +

    + + + {{ + default: () => , + fallback: () => ( +
    Loading...
    + ), + }} +
    +
    + ) +} diff --git a/e2e/vue-start/start-manifest/src/routes/lazy-css-static.tsx b/e2e/vue-start/start-manifest/src/routes/lazy-css-static.tsx new file mode 100644 index 0000000000..2a8352e67e --- /dev/null +++ b/e2e/vue-start/start-manifest/src/routes/lazy-css-static.tsx @@ -0,0 +1,24 @@ +import { ClientOnly, createFileRoute } from '@tanstack/vue-router' +import { SharedWidget } from '~/components/SharedWidget' + +export const Route = createFileRoute('/lazy-css-static')({ + component: LazyCssStaticRoute, +}) + +function LazyCssStaticRoute() { + return ( +
    +

    Lazy CSS Repro - Static Route

    +

    + This route statically imports the shared widget so its CSS is present in + the SSR head. +

    + + +
    hydrated
    +
    + + +
    + ) +} diff --git a/e2e/vue-start/start-manifest/src/routes/r1.tsx b/e2e/vue-start/start-manifest/src/routes/r1.tsx new file mode 100644 index 0000000000..b35bec54e3 --- /dev/null +++ b/e2e/vue-start/start-manifest/src/routes/r1.tsx @@ -0,0 +1,18 @@ +/// +import { createFileRoute } from '@tanstack/vue-router' +import styles from '~/styles/route-one.module.css' + +export const Route = createFileRoute('/r1')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( +
    +

    Route /r1

    +
    + Route /r1 CSS module styling +
    +
    + ) +} diff --git a/e2e/vue-start/start-manifest/src/routes/r2.tsx b/e2e/vue-start/start-manifest/src/routes/r2.tsx new file mode 100644 index 0000000000..eadd952f98 --- /dev/null +++ b/e2e/vue-start/start-manifest/src/routes/r2.tsx @@ -0,0 +1,18 @@ +/// +import { createFileRoute } from '@tanstack/vue-router' +import styles from '~/styles/route-two.module.css' + +export const Route = createFileRoute('/r2')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( +
    +

    Route /r2

    +
    + Route /r2 CSS module styling +
    +
    + ) +} diff --git a/e2e/vue-start/start-manifest/src/routes/r3.tsx b/e2e/vue-start/start-manifest/src/routes/r3.tsx new file mode 100644 index 0000000000..a5a486cfaa --- /dev/null +++ b/e2e/vue-start/start-manifest/src/routes/r3.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/vue-router' + +export const Route = createFileRoute('/r3')({ + component: () =>
    Route /r3
    , +}) diff --git a/e2e/vue-start/start-manifest/src/routes/r4.tsx b/e2e/vue-start/start-manifest/src/routes/r4.tsx new file mode 100644 index 0000000000..9739966d02 --- /dev/null +++ b/e2e/vue-start/start-manifest/src/routes/r4.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/vue-router' + +export const Route = createFileRoute('/r4')({ + component: () =>
    Route /r4
    , +}) diff --git a/e2e/vue-start/start-manifest/src/routes/r5.tsx b/e2e/vue-start/start-manifest/src/routes/r5.tsx new file mode 100644 index 0000000000..7c081e29a6 --- /dev/null +++ b/e2e/vue-start/start-manifest/src/routes/r5.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/vue-router' + +export const Route = createFileRoute('/r5')({ + component: () =>
    Route /r5
    , +}) diff --git a/e2e/vue-start/start-manifest/src/routes/r6.tsx b/e2e/vue-start/start-manifest/src/routes/r6.tsx new file mode 100644 index 0000000000..c56c2afda3 --- /dev/null +++ b/e2e/vue-start/start-manifest/src/routes/r6.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/vue-router' + +export const Route = createFileRoute('/r6')({ + component: () =>
    Route /r6
    , +}) diff --git a/e2e/vue-start/start-manifest/src/routes/shared-a.tsx b/e2e/vue-start/start-manifest/src/routes/shared-a.tsx new file mode 100644 index 0000000000..e7253a94ac --- /dev/null +++ b/e2e/vue-start/start-manifest/src/routes/shared-a.tsx @@ -0,0 +1,14 @@ +import { createFileRoute } from '@tanstack/vue-router' +import { SharedNestedLayout } from '~/components/SharedNestedLayout' + +export const Route = createFileRoute('/shared-a')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( + +
    Shared route A
    +
    + ) +} diff --git a/e2e/vue-start/start-manifest/src/routes/shared-b.tsx b/e2e/vue-start/start-manifest/src/routes/shared-b.tsx new file mode 100644 index 0000000000..ed02b3429b --- /dev/null +++ b/e2e/vue-start/start-manifest/src/routes/shared-b.tsx @@ -0,0 +1,14 @@ +import { createFileRoute } from '@tanstack/vue-router' +import { SharedNestedLayout } from '~/components/SharedNestedLayout' + +export const Route = createFileRoute('/shared-b')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( + +
    Shared route B
    +
    + ) +} diff --git a/e2e/vue-start/start-manifest/src/routes/shared-c.tsx b/e2e/vue-start/start-manifest/src/routes/shared-c.tsx new file mode 100644 index 0000000000..e395b33ed5 --- /dev/null +++ b/e2e/vue-start/start-manifest/src/routes/shared-c.tsx @@ -0,0 +1,14 @@ +import { createFileRoute } from '@tanstack/vue-router' +import { SharedNestedLayout } from '~/components/SharedNestedLayout' + +export const Route = createFileRoute('/shared-c')({ + component: RouteComponent, +}) + +function RouteComponent() { + return ( + +
    Shared route C
    +
    + ) +} diff --git a/e2e/vue-start/start-manifest/src/styles/page-a.module.css b/e2e/vue-start/start-manifest/src/styles/page-a.module.css new file mode 100644 index 0000000000..7ed4301097 --- /dev/null +++ b/e2e/vue-start/start-manifest/src/styles/page-a.module.css @@ -0,0 +1,10 @@ +.page { + padding: 1rem; + min-height: 12rem; + background: rgb(240, 253, 244); + border: 4px solid rgb(22, 163, 74); +} + +.title { + color: rgb(21, 128, 61); +} diff --git a/e2e/vue-start/start-manifest/src/styles/page-b.module.css b/e2e/vue-start/start-manifest/src/styles/page-b.module.css new file mode 100644 index 0000000000..93d1d39a01 --- /dev/null +++ b/e2e/vue-start/start-manifest/src/styles/page-b.module.css @@ -0,0 +1,10 @@ +.page { + padding: 1rem; + min-height: 12rem; + background: rgb(239, 246, 255); + border: 4px solid rgb(37, 99, 235); +} + +.title { + color: rgb(29, 78, 216); +} diff --git a/e2e/vue-start/start-manifest/src/styles/root-shell.module.css b/e2e/vue-start/start-manifest/src/styles/root-shell.module.css new file mode 100644 index 0000000000..e7bece8664 --- /dev/null +++ b/e2e/vue-start/start-manifest/src/styles/root-shell.module.css @@ -0,0 +1,37 @@ +.shell { + font-family: + -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; + min-height: 100vh; + background: rgb(248, 250, 252); + color: rgb(15, 23, 42); +} + +.nav { + display: flex; + flex-wrap: wrap; + gap: 0.75rem; + padding: 1rem; + border-bottom: 1px solid rgb(226, 232, 240); + background: white; +} + +.nav a { + color: rgb(37, 99, 235); + text-decoration: none; +} + +.content { + max-width: 760px; + margin: 0 auto; + padding: 1.5rem 1rem 3rem; +} + +.rootBadge { + display: inline-block; + margin-bottom: 1rem; + padding: 0.375rem 0.75rem; + border-radius: 9999px; + background: rgb(220, 252, 231); + color: rgb(22, 101, 52); + font-weight: 700; +} diff --git a/e2e/vue-start/start-manifest/src/styles/route-one.module.css b/e2e/vue-start/start-manifest/src/styles/route-one.module.css new file mode 100644 index 0000000000..623d03e6a3 --- /dev/null +++ b/e2e/vue-start/start-manifest/src/styles/route-one.module.css @@ -0,0 +1,7 @@ +.card { + padding: 1rem; + border-radius: 0.75rem; + background: rgb(239, 246, 255); + color: rgb(30, 64, 175); + border: 2px solid rgb(96, 165, 250); +} diff --git a/e2e/vue-start/start-manifest/src/styles/route-two.module.css b/e2e/vue-start/start-manifest/src/styles/route-two.module.css new file mode 100644 index 0000000000..66ed355711 --- /dev/null +++ b/e2e/vue-start/start-manifest/src/styles/route-two.module.css @@ -0,0 +1,7 @@ +.card { + padding: 1rem; + border-radius: 0.75rem; + background: rgb(250, 245, 255); + color: rgb(126, 34, 206); + border: 2px solid rgb(192, 132, 252); +} diff --git a/e2e/vue-start/start-manifest/src/styles/shared-card.module.css b/e2e/vue-start/start-manifest/src/styles/shared-card.module.css new file mode 100644 index 0000000000..2aa5a6ac17 --- /dev/null +++ b/e2e/vue-start/start-manifest/src/styles/shared-card.module.css @@ -0,0 +1,8 @@ +.card { + margin-top: 1rem; + padding: 1.5rem; + border-radius: 0.75rem; + background: rgb(252, 231, 243); + border: 2px solid rgb(190, 24, 93); + color: rgb(157, 23, 77); +} diff --git a/e2e/vue-start/start-manifest/src/styles/shared-layout.module.css b/e2e/vue-start/start-manifest/src/styles/shared-layout.module.css new file mode 100644 index 0000000000..6025a1da06 --- /dev/null +++ b/e2e/vue-start/start-manifest/src/styles/shared-layout.module.css @@ -0,0 +1,16 @@ +.layout { + padding: 1rem; + border-radius: 0.75rem; + background: rgb(255, 251, 235); + border: 2px solid rgb(245, 158, 11); +} + +.heading { + color: rgb(180, 83, 9); + font-weight: 700; + margin-bottom: 0.5rem; +} + +.body { + color: rgb(146, 64, 14); +} diff --git a/e2e/vue-start/start-manifest/src/styles/shared-widget.module.css b/e2e/vue-start/start-manifest/src/styles/shared-widget.module.css new file mode 100644 index 0000000000..ed197cddb0 --- /dev/null +++ b/e2e/vue-start/start-manifest/src/styles/shared-widget.module.css @@ -0,0 +1,17 @@ +.widget { + margin-top: 1rem; + padding: 1rem; + border-top: 4px solid rgb(249, 115, 22); + border-radius: 0.75rem; + background: rgb(255, 247, 237); +} + +.title { + font-weight: 700; + color: rgb(154, 52, 18); +} + +.content { + margin-top: 0.5rem; + color: rgb(124, 45, 18); +} diff --git a/e2e/vue-start/start-manifest/tests/start-manifest.spec.ts b/e2e/vue-start/start-manifest/tests/start-manifest.spec.ts new file mode 100644 index 0000000000..6c0f0d15ab --- /dev/null +++ b/e2e/vue-start/start-manifest/tests/start-manifest.spec.ts @@ -0,0 +1,469 @@ +import { expect } from '@playwright/test' +import { test } from '@tanstack/router-e2e-utils' +import type { Page } from '@playwright/test' +import { readdir } from 'node:fs/promises' +import path from 'node:path' +import { pathToFileURL } from 'node:url' + +const ROOT_SHELL_COLOR = 'rgb(22, 101, 52)' +const ROUTE_ONE_COLOR = 'rgb(30, 64, 175)' +const ROUTE_TWO_COLOR = 'rgb(126, 34, 206)' +const SHARED_CARD_BG = 'rgb(252, 231, 243)' +const SHARED_WIDGET_BG = 'rgb(255, 247, 237)' +const SHARED_WIDGET_BORDER = 'rgb(249, 115, 22)' + +const buildUrl = (baseURL: string, pathname: string) => + baseURL.replace(/\/$/, '') + pathname + +async function getColor(testId: string, page: Page) { + return page + .getByTestId(testId) + .evaluate((element) => getComputedStyle(element).color) +} + +async function getBackgroundColor(testId: string, page: Page) { + return page + .getByTestId(testId) + .evaluate((element) => getComputedStyle(element).backgroundColor) +} + +function getStylesheetHrefsFromHtml(html: string) { + return Array.from( + html.matchAll(/]+rel="stylesheet"[^>]+href="([^"]+)"/g), + (match) => match[1]!, + ) +} + +async function getHeadStylesheetHrefs(page: Page) { + return page.locator('head link[rel="stylesheet"]').evaluateAll((links) => { + return links.map( + (link) => (link as HTMLLinkElement).getAttribute('href') || '', + ) + }) +} + +function hasMatchingStylesheetHref(hrefs: Array, pattern: string) { + return hrefs.some((href) => href.includes(pattern)) +} + +function countMatchingStylesheetHrefs(hrefs: Array, pattern: string) { + return hrefs.filter((href) => href.includes(pattern)).length +} + +async function loadBuiltStartManifest() { + const serverDir = path.resolve(import.meta.dirname, '../dist/server/assets') + const entries = await readdir(serverDir) + const manifestFile = entries.find( + (entry) => + entry.startsWith('_tanstack-start-manifest_v-') && entry.endsWith('.js'), + ) + + expect(manifestFile).toBeTruthy() + + const moduleUrl = `${pathToFileURL(path.join(serverDir, manifestFile!)).href}?t=${Date.now()}` + const manifestModule = await import(moduleUrl) + + return manifestModule.tsrStartManifest() as { + routes: Record }> + } +} + +async function expectDirectEntry({ + page, + request, + baseURL, + pathname, + expectedVisibleTestId, + expectedAbsentTestId, + expectedStylesheetPattern, + unexpectedStylesheetPattern, + expectedColorTestId, + expectedColor, +}: { + page: Page + request: { + get: (url: string) => Promise<{ ok(): boolean; text(): Promise }> + } + baseURL: string + pathname: string + expectedVisibleTestId: string + expectedAbsentTestId: string + expectedStylesheetPattern: string + unexpectedStylesheetPattern: string + expectedColorTestId: string + expectedColor: string +}) { + const url = buildUrl(baseURL, pathname) + const response = await request.get(url) + const ssrHtml = await response.text() + + expect(response.ok()).toBe(true) + expect(ssrHtml).toContain('root-shell-marker') + expect(ssrHtml).toContain(expectedVisibleTestId) + expect(ssrHtml).not.toContain(expectedAbsentTestId) + + const stylesheetLinks = getStylesheetHrefsFromHtml(ssrHtml) + + expect( + countMatchingStylesheetHrefs(stylesheetLinks, expectedStylesheetPattern), + ).toBe(1) + expect( + countMatchingStylesheetHrefs(stylesheetLinks, unexpectedStylesheetPattern), + ).toBe(0) + expect(stylesheetLinks).toHaveLength(2) + + await page.goto(url) + await expect(page.getByTestId(expectedVisibleTestId)).toBeVisible() + await expect(page.getByTestId('hydration-marker')).toBeVisible() + + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return countMatchingStylesheetHrefs(hrefs, expectedStylesheetPattern) + }) + .toBe(1) + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return countMatchingStylesheetHrefs(hrefs, unexpectedStylesheetPattern) + }) + .toBe(0) + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return hrefs.length + }) + .toBe(2) + + await expect + .poll(() => getColor('root-shell-marker', page)) + .toBe(ROOT_SHELL_COLOR) + await expect + .poll(() => getColor(expectedColorTestId, page)) + .toBe(expectedColor) +} + +test('SSR and client navigation keep CSS module styles correct without hydration errors', async ({ + page, + baseURL, + request, +}) => { + const routeOneUrl = buildUrl(baseURL!, '/r1') + const response = await request.get(routeOneUrl) + const ssrHtml = await response.text() + + expect(response.ok()).toBe(true) + expect(ssrHtml).toContain('root-shell-marker') + expect(ssrHtml).toContain('route-r1-card') + expect(ssrHtml).not.toContain('route-r2-card') + + const stylesheetLinks = getStylesheetHrefsFromHtml(ssrHtml) + + expect(countMatchingStylesheetHrefs(stylesheetLinks, 'r1-')).toBe(1) + expect(countMatchingStylesheetHrefs(stylesheetLinks, 'r2-')).toBe(0) + expect(stylesheetLinks).toHaveLength(2) + + await page.goto(routeOneUrl) + + await expect(page.getByTestId('route-r1-card')).toBeVisible() + await expect(page.getByTestId('hydration-marker')).toBeVisible() + + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return hasMatchingStylesheetHref(hrefs, 'r1-') + }) + .toBe(true) + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return countMatchingStylesheetHrefs(hrefs, 'r2-') + }) + .toBe(0) + + await expect + .poll(() => getColor('root-shell-marker', page)) + .toBe(ROOT_SHELL_COLOR) + await expect.poll(() => getColor('route-r1-card', page)).toBe(ROUTE_ONE_COLOR) + + await page.getByTestId('nav-/r2').click() + await page.waitForURL('**/r2') + await expect(page.getByTestId('route-r2-card')).toBeVisible() + + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return hasMatchingStylesheetHref(hrefs, 'r2-') + }) + .toBe(true) + + await expect + .poll(() => getColor('root-shell-marker', page)) + .toBe(ROOT_SHELL_COLOR) + await expect.poll(() => getColor('route-r2-card', page)).toBe(ROUTE_TWO_COLOR) + + await page.getByTestId('nav-/r1').click() + await page.waitForURL('**/r1') + await expect(page.getByTestId('route-r1-card')).toBeVisible() + + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return hasMatchingStylesheetHref(hrefs, 'r1-') + }) + .toBe(true) + + await expect + .poll(() => getColor('root-shell-marker', page)) + .toBe(ROOT_SHELL_COLOR) + await expect.poll(() => getColor('route-r1-card', page)).toBe(ROUTE_ONE_COLOR) +}) + +test('direct SSR entry on /r2 only includes its stylesheet and hydrates cleanly', async ({ + page, + baseURL, + request, +}) => { + await expectDirectEntry({ + page, + request, + baseURL: baseURL!, + pathname: '/r2', + expectedVisibleTestId: 'route-r2-card', + expectedAbsentTestId: 'route-r1-card', + expectedStylesheetPattern: 'r2-', + unexpectedStylesheetPattern: 'r1-', + expectedColorTestId: 'route-r2-card', + expectedColor: ROUTE_TWO_COLOR, + }) +}) + +test('direct SSR entries on different route-css pages stay isolated', async ({ + page, + baseURL, + request, +}) => { + await expectDirectEntry({ + page, + request, + baseURL: baseURL!, + pathname: '/r2', + expectedVisibleTestId: 'route-r2-card', + expectedAbsentTestId: 'route-r1-card', + expectedStylesheetPattern: 'r2-', + unexpectedStylesheetPattern: 'r1-', + expectedColorTestId: 'route-r2-card', + expectedColor: ROUTE_TWO_COLOR, + }) + + await expectDirectEntry({ + page, + request, + baseURL: baseURL!, + pathname: '/r1', + expectedVisibleTestId: 'route-r1-card', + expectedAbsentTestId: 'route-r2-card', + expectedStylesheetPattern: 'r1-', + unexpectedStylesheetPattern: 'r2-', + expectedColorTestId: 'route-r1-card', + expectedColor: ROUTE_ONE_COLOR, + }) +}) + +test('home route only renders the root stylesheet and no route-specific CSS', async ({ + page, + baseURL, + request, +}) => { + const homeUrl = buildUrl(baseURL!, '/') + const response = await request.get(homeUrl) + const ssrHtml = await response.text() + + expect(response.ok()).toBe(true) + expect(ssrHtml).toContain('root-shell-marker') + expect(ssrHtml).toContain('home-copy') + expect(ssrHtml).not.toContain('route-r1-card') + expect(ssrHtml).not.toContain('route-r2-card') + + const stylesheetLinks = getStylesheetHrefsFromHtml(ssrHtml) + + expect(countMatchingStylesheetHrefs(stylesheetLinks, 'r1-')).toBe(0) + expect(countMatchingStylesheetHrefs(stylesheetLinks, 'r2-')).toBe(0) + expect(stylesheetLinks).toHaveLength(1) + + await page.goto(homeUrl) + await expect(page.getByTestId('home-copy')).toBeVisible() + await expect(page.getByTestId('hydration-marker')).toBeVisible() + + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return countMatchingStylesheetHrefs(hrefs, 'r1-') + }) + .toBe(0) + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return countMatchingStylesheetHrefs(hrefs, 'r2-') + }) + .toBe(0) + await expect + .poll(async () => { + const hrefs = await getHeadStylesheetHrefs(page) + return hrefs.length + }) + .toBe(1) + + await expect + .poll(() => getColor('root-shell-marker', page)) + .toBe(ROOT_SHELL_COLOR) +}) + +test('built start manifest preserves shared layout asset identity across sibling routes', async ({ + page, + baseURL, +}) => { + await page.goto(buildUrl(baseURL!, '/shared-a')) + await expect(page.getByTestId('shared-a-card')).toBeVisible() + + const manifest = await loadBuiltStartManifest() + + const sharedAAsset = manifest.routes['/shared-a']?.css?.[0] + const sharedBAsset = manifest.routes['/shared-b']?.css?.[0] + const sharedCAsset = manifest.routes['/shared-c']?.css?.[0] + + expect(sharedAAsset).toBeTruthy() + expect(sharedAAsset).toBe(sharedBAsset) + expect(sharedBAsset).toBe(sharedCAsset) +}) + +test('shared CSS chunk persists across client-side nav', async ({ + page, + baseURL, +}) => { + await page.goto(buildUrl(baseURL!, '/a')) + + await expect(page.getByTestId('page-a')).toBeVisible() + await expect(page.getByTestId('shared-card')).toBeVisible() + await expect + .poll(() => getBackgroundColor('shared-card', page)) + .toBe(SHARED_CARD_BG) + await expect( + page.locator('head link[rel="stylesheet"][href*="SharedCard"]'), + ).toHaveCount(1) + + await page.getByTestId('nav-/b').click() + await page.waitForURL('**/b') + await expect(page.getByTestId('page-b')).toBeVisible() + + await expect( + page.locator('head link[rel="stylesheet"][href*="SharedCard"]'), + ).toHaveCount(1) + await expect + .poll(() => getBackgroundColor('shared-card', page)) + .toBe(SHARED_CARD_BG) +}) + +test('shared widget CSS stays applied when navigating from static to lazy route', async ({ + page, + baseURL, +}) => { + await page.goto(buildUrl(baseURL!, '/lazy-css-static')) + + const widget = page.getByTestId('shared-widget') + await expect(widget).toBeVisible() + expect(await getBackgroundColor('shared-widget', page)).toBe(SHARED_WIDGET_BG) + expect( + await widget.evaluate( + (element) => getComputedStyle(element).borderTopColor, + ), + ).toBe(SHARED_WIDGET_BORDER) + + await expect(page.getByTestId('lazy-css-static-hydrated')).toBeVisible() + + await page.getByTestId('nav-/lazy-css-lazy').click() + await page.waitForURL('**/lazy-css-lazy') + await expect(page.getByTestId('lazy-css-lazy-heading')).toBeVisible() + + await expect + .poll(() => getBackgroundColor('shared-widget', page), { + timeout: 5_000, + }) + .toBe(SHARED_WIDGET_BG) +}) + +test('shared widget CSS stays applied when navigating from lazy to static route', async ({ + page, + baseURL, +}) => { + await page.goto(buildUrl(baseURL!, '/lazy-css-lazy')) + await expect(page.getByTestId('lazy-css-lazy-heading')).toBeVisible() + + await expect + .poll(() => getBackgroundColor('shared-widget', page), { + timeout: 5_000, + }) + .toBe(SHARED_WIDGET_BG) + + await page.getByTestId('nav-/lazy-css-static').click() + await page.waitForURL('**/lazy-css-static') + + const widget = page.getByTestId('shared-widget') + await expect(widget).toBeVisible() + await expect + .poll(() => getBackgroundColor('shared-widget', page), { + timeout: 5_000, + }) + .toBe(SHARED_WIDGET_BG) + expect( + await widget.evaluate( + (element) => getComputedStyle(element).borderTopColor, + ), + ).toBe(SHARED_WIDGET_BORDER) +}) + +test('shared widget CSS is applied on direct navigation to lazy route', async ({ + page, + baseURL, +}) => { + await page.goto(buildUrl(baseURL!, '/lazy-css-lazy')) + await expect(page.getByTestId('lazy-css-lazy-heading')).toBeVisible() + + const widget = page.getByTestId('shared-widget') + await expect(widget).toBeVisible() + + await expect + .poll(() => getBackgroundColor('shared-widget', page), { + timeout: 5_000, + }) + .toBe(SHARED_WIDGET_BG) + expect( + await widget.evaluate( + (element) => getComputedStyle(element).borderTopColor, + ), + ).toBe(SHARED_WIDGET_BORDER) +}) + +test('shared widget CSS persists after navigating away from lazy and back', async ({ + page, + baseURL, +}) => { + await page.goto(buildUrl(baseURL!, '/lazy-css-static')) + await expect(page.getByTestId('lazy-css-static-hydrated')).toBeVisible() + + await page.getByTestId('nav-/lazy-css-lazy').click() + await page.waitForURL('**/lazy-css-lazy') + await expect(page.getByTestId('shared-widget')).toBeVisible() + + await page.getByTestId('nav-home').click() + await page.waitForURL(/\/([^/]*)(\/)?($|\?)/) + + await page.getByTestId('nav-/lazy-css-lazy').click() + await page.waitForURL('**/lazy-css-lazy') + + await expect + .poll(() => getBackgroundColor('shared-widget', page), { + timeout: 5_000, + }) + .toBe(SHARED_WIDGET_BG) +}) diff --git a/e2e/vue-start/start-manifest/tsconfig.json b/e2e/vue-start/start-manifest/tsconfig.json new file mode 100644 index 0000000000..44a68ebf56 --- /dev/null +++ b/e2e/vue-start/start-manifest/tsconfig.json @@ -0,0 +1,23 @@ +{ + "include": ["**/*.ts", "**/*.tsx"], + "compilerOptions": { + "strict": true, + "esModuleInterop": true, + "jsx": "preserve", + "jsxImportSource": "vue", + "module": "ESNext", + "moduleResolution": "Bundler", + "lib": ["DOM", "DOM.Iterable", "ES2022"], + "isolatedModules": true, + "resolveJsonModule": true, + "skipLibCheck": true, + "target": "ES2024", + "allowJs": true, + "forceConsistentCasingInFileNames": true, + "paths": { + "~/*": ["./src/*"] + }, + "noEmit": true, + "types": ["vite/client"] + } +} diff --git a/e2e/vue-start/start-manifest/vite.config.ts b/e2e/vue-start/start-manifest/vite.config.ts new file mode 100644 index 0000000000..f1102cffab --- /dev/null +++ b/e2e/vue-start/start-manifest/vite.config.ts @@ -0,0 +1,13 @@ +import { defineConfig } from 'vite' +import { tanstackStart } from '@tanstack/vue-start/plugin/vite' +import vueJsx from '@vitejs/plugin-vue-jsx' + +export default defineConfig({ + server: { + port: 3000, + }, + resolve: { + tsconfigPaths: true, + }, + plugins: [tanstackStart({ srcDirectory: 'src' }), vueJsx()], +}) diff --git a/e2e/vue-start/virtual-routes/package.json b/e2e/vue-start/virtual-routes/package.json index c1ff5d719a..41b1355414 100644 --- a/e2e/vue-start/virtual-routes/package.json +++ b/e2e/vue-start/virtual-routes/package.json @@ -12,26 +12,26 @@ "test:e2e": "rm -rf port*.txt; playwright test --project=chromium" }, "dependencies": { + "@tanstack/virtual-file-routes": "workspace:^", "@tanstack/vue-router": "workspace:^", "@tanstack/vue-router-devtools": "workspace:^", "@tanstack/vue-start": "workspace:^", - "@tanstack/virtual-file-routes": "workspace:^", "redaxios": "^0.5.1", - "tailwind-merge": "^2.6.0", - "vite": "^8.0.0", + "tailwind-merge": "^3.6.0", "vue": "^3.5.25", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", "@tailwindcss/vite": "^4.2.2", "@tanstack/router-e2e-utils": "workspace:^", "@types/node": "^22.10.2", + "@vitejs/plugin-vue": "^6.0.5", + "@vitejs/plugin-vue-jsx": "^5.1.5", "combinate": "^1.1.11", "srvx": "^0.11.9", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "@vitejs/plugin-vue": "^6.0.5", - "@vitejs/plugin-vue-jsx": "^5.1.5" + "vite": "^8.0.14" } } diff --git a/e2e/vue-start/website/package.json b/e2e/vue-start/website/package.json index dee9d17056..8ec13f6dbc 100644 --- a/e2e/vue-start/website/package.json +++ b/e2e/vue-start/website/package.json @@ -16,20 +16,20 @@ "@tanstack/vue-router-devtools": "workspace:^", "@tanstack/vue-start": "workspace:^", "redaxios": "^0.5.1", - "tailwind-merge": "^2.6.0", - "vite": "^8.0.0", + "tailwind-merge": "^3.6.0", "vue": "^3.5.25", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@playwright/test": "^1.50.1", "@tailwindcss/vite": "^4.2.2", "@tanstack/router-e2e-utils": "workspace:^", "@types/node": "^22.10.2", + "@vitejs/plugin-vue": "^6.0.5", + "@vitejs/plugin-vue-jsx": "^5.1.5", "srvx": "^0.11.9", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "@vitejs/plugin-vue": "^6.0.5", - "@vitejs/plugin-vue-jsx": "^5.1.5" + "vite": "^8.0.14" } } diff --git a/examples/react/authenticated-routes-firebase/package.json b/examples/react/authenticated-routes-firebase/package.json index d52da2de6b..671e6436b3 100644 --- a/examples/react/authenticated-routes-firebase/package.json +++ b/examples/react/authenticated-routes-firebase/package.json @@ -10,22 +10,22 @@ }, "dependencies": { "@tailwindcss/vite": "^4.2.2", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/router-plugin": "^1.168.13", "firebase": "^11.4.0", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", "simple-icons": "^14.9.0", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/authenticated-routes/package.json b/examples/react/authenticated-routes/package.json index 32574859ae..b58911dd90 100644 --- a/examples/react/authenticated-routes/package.json +++ b/examples/react/authenticated-routes/package.json @@ -10,20 +10,20 @@ }, "dependencies": { "@tailwindcss/vite": "^4.2.2", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/router-plugin": "^1.168.13", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/basic-default-search-params/package.json b/examples/react/basic-default-search-params/package.json index de52025d5d..ebed64e5b3 100644 --- a/examples/react/basic-default-search-params/package.json +++ b/examples/react/basic-default-search-params/package.json @@ -11,19 +11,19 @@ "dependencies": { "@tailwindcss/vite": "^4.2.2", "@tanstack/react-query": "^5.90.0", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/basic-devtools-panel/package.json b/examples/react/basic-devtools-panel/package.json index 0dab4b7102..0b497e7547 100644 --- a/examples/react/basic-devtools-panel/package.json +++ b/examples/react/basic-devtools-panel/package.json @@ -11,8 +11,8 @@ "dependencies": { "@tailwindcss/vite": "^4.2.2", "@tanstack/react-query-devtools": "^5.67.2", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", @@ -23,6 +23,6 @@ "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/basic-file-based/package.json b/examples/react/basic-file-based/package.json index 0ea2702e0f..542ae3af94 100644 --- a/examples/react/basic-file-based/package.json +++ b/examples/react/basic-file-based/package.json @@ -10,20 +10,20 @@ }, "dependencies": { "@tailwindcss/vite": "^4.2.2", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/router-plugin": "^1.168.13", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/basic-non-nested-devtools/package.json b/examples/react/basic-non-nested-devtools/package.json index 750018a04b..7e1944df94 100644 --- a/examples/react/basic-non-nested-devtools/package.json +++ b/examples/react/basic-non-nested-devtools/package.json @@ -10,8 +10,8 @@ }, "dependencies": { "@tailwindcss/vite": "^4.2.2", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", @@ -22,6 +22,6 @@ "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/basic-react-query-file-based/package.json b/examples/react/basic-react-query-file-based/package.json index dfb91c5753..55714825a5 100644 --- a/examples/react/basic-react-query-file-based/package.json +++ b/examples/react/basic-react-query-file-based/package.json @@ -12,20 +12,20 @@ "@tailwindcss/vite": "^4.2.2", "@tanstack/react-query": "^5.90.0", "@tanstack/react-query-devtools": "^5.90.0", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/router-plugin": "^1.168.13", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/basic-react-query/package.json b/examples/react/basic-react-query/package.json index 5fecea60a7..8babf9af2a 100644 --- a/examples/react/basic-react-query/package.json +++ b/examples/react/basic-react-query/package.json @@ -12,8 +12,8 @@ "@tailwindcss/vite": "^4.2.2", "@tanstack/react-query": "^5.90.0", "@tanstack/react-query-devtools": "^5.90.0", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", @@ -24,6 +24,6 @@ "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/basic-ssr-file-based/package.json b/examples/react/basic-ssr-file-based/package.json index f496717882..e11af6ee59 100644 --- a/examples/react/basic-ssr-file-based/package.json +++ b/examples/react/basic-ssr-file-based/package.json @@ -11,22 +11,22 @@ "debug": "node --inspect-brk server" }, "dependencies": { - "@tanstack/react-router": "^1.168.10", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/react-router": "^1.170.10", + "@tanstack/router-plugin": "^1.168.13", "compression": "^1.8.0", - "express": "^4.21.2", + "express": "^5.2.1", "get-port": "^7.1.0", "node-fetch": "^3.3.2", "react": "^19.0.0", "react-dom": "^19.0.0" }, "devDependencies": { - "@tanstack/react-router-devtools": "^1.166.11", - "@types/express": "^4.17.23", + "@tanstack/react-router-devtools": "^1.167.0", + "@types/express": "^5.0.6", "@types/react": "^19.0.8", "@types/react-dom": "^19.0.1", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/basic-ssr-file-based/server.js b/examples/react/basic-ssr-file-based/server.js index 5686edc048..6d060a19f0 100644 --- a/examples/react/basic-ssr-file-based/server.js +++ b/examples/react/basic-ssr-file-based/server.js @@ -51,7 +51,7 @@ export async function createServer( if (isProd) app.use(express.static('./dist/client')) - app.use('*', async (req, res) => { + app.use('/{*splat}', async (req, res) => { try { const url = req.originalUrl @@ -97,7 +97,8 @@ export async function createServer( if (!isTest) { createServer().then(async ({ app }) => - app.listen(await getPort({ port: portNumbers(3000, 3100) }), () => { + app.listen(await getPort({ port: portNumbers(3000, 3100) }), (error) => { + if (error) throw error console.info('Client Server: http://localhost:3000') }), ) diff --git a/examples/react/basic-ssr-streaming-file-based/package.json b/examples/react/basic-ssr-streaming-file-based/package.json index d106e6bb69..485da2a37a 100644 --- a/examples/react/basic-ssr-streaming-file-based/package.json +++ b/examples/react/basic-ssr-streaming-file-based/package.json @@ -11,22 +11,22 @@ "debug": "node --inspect-brk server" }, "dependencies": { - "@tanstack/react-router": "^1.168.10", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/react-router": "^1.170.10", + "@tanstack/router-plugin": "^1.168.13", "compression": "^1.8.0", - "express": "^4.21.2", + "express": "^5.2.1", "get-port": "^7.1.0", "node-fetch": "^3.3.2", "react": "^19.0.0", "react-dom": "^19.0.0" }, "devDependencies": { - "@tanstack/react-router-devtools": "^1.166.11", - "@types/express": "^4.17.23", + "@tanstack/react-router-devtools": "^1.167.0", + "@types/express": "^5.0.6", "@types/react": "^19.0.8", "@types/react-dom": "^19.0.1", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/basic-ssr-streaming-file-based/server.js b/examples/react/basic-ssr-streaming-file-based/server.js index 5686edc048..6d060a19f0 100644 --- a/examples/react/basic-ssr-streaming-file-based/server.js +++ b/examples/react/basic-ssr-streaming-file-based/server.js @@ -51,7 +51,7 @@ export async function createServer( if (isProd) app.use(express.static('./dist/client')) - app.use('*', async (req, res) => { + app.use('/{*splat}', async (req, res) => { try { const url = req.originalUrl @@ -97,7 +97,8 @@ export async function createServer( if (!isTest) { createServer().then(async ({ app }) => - app.listen(await getPort({ port: portNumbers(3000, 3100) }), () => { + app.listen(await getPort({ port: portNumbers(3000, 3100) }), (error) => { + if (error) throw error console.info('Client Server: http://localhost:3000') }), ) diff --git a/examples/react/basic-virtual-file-based/package.json b/examples/react/basic-virtual-file-based/package.json index 492ea4d0a1..82ce21abe3 100644 --- a/examples/react/basic-virtual-file-based/package.json +++ b/examples/react/basic-virtual-file-based/package.json @@ -10,21 +10,21 @@ }, "dependencies": { "@tailwindcss/vite": "^4.2.2", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/router-plugin": "^1.167.12", - "@tanstack/virtual-file-routes": "^1.161.7", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/router-plugin": "^1.168.13", + "@tanstack/virtual-file-routes": "^1.162.0", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/basic-virtual-file-based/src/routeTree.gen.ts b/examples/react/basic-virtual-file-based/src/routeTree.gen.ts index 48b85c05e5..2fe7840f19 100644 --- a/examples/react/basic-virtual-file-based/src/routeTree.gen.ts +++ b/examples/react/basic-virtual-file-based/src/routeTree.gen.ts @@ -8,8 +8,6 @@ // You should NOT make any changes in this file as it will be overwritten. // Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. -import type { CreateFileRoute, FileRoutesByPath } from '@tanstack/react-router' - import { Route as rootRouteImport } from './routes/root' import { Route as postsPostsRouteImport } from './routes/posts/posts' import { Route as layoutFirstLayoutRouteImport } from './routes/layout/first-layout' @@ -255,115 +253,6 @@ declare module '@tanstack/react-router' { } } -declare module './routes/home' { - const createFileRoute: CreateFileRoute< - '/', - FileRoutesByPath['/']['parentRoute'], - FileRoutesByPath['/']['id'], - FileRoutesByPath['/']['path'], - FileRoutesByPath['/']['fullPath'] - > -} -declare module './routes/layout/first-layout' { - const createFileRoute: CreateFileRoute< - '/_first', - FileRoutesByPath['/_first']['parentRoute'], - FileRoutesByPath['/_first']['id'], - FileRoutesByPath['/_first']['path'], - FileRoutesByPath['/_first']['fullPath'] - > -} -declare module './routes/posts/posts' { - const createFileRoute: CreateFileRoute< - '/posts', - FileRoutesByPath['/posts']['parentRoute'], - FileRoutesByPath['/posts']['id'], - FileRoutesByPath['/posts']['path'], - FileRoutesByPath['/posts']['fullPath'] - > -} -declare module './routes/file-based-subtree/hello/route' { - const createFileRoute: CreateFileRoute< - '/classic/hello', - FileRoutesByPath['/classic/hello']['parentRoute'], - FileRoutesByPath['/classic/hello']['id'], - FileRoutesByPath['/classic/hello']['path'], - FileRoutesByPath['/classic/hello']['fullPath'] - > -} -declare module './routes/posts/posts-home' { - const createFileRoute: CreateFileRoute< - '/posts/', - FileRoutesByPath['/posts/']['parentRoute'], - FileRoutesByPath['/posts/']['id'], - FileRoutesByPath['/posts/']['path'], - FileRoutesByPath['/posts/']['fullPath'] - > -} -declare module './routes/layout/second-layout' { - const createFileRoute: CreateFileRoute< - '/_first/_second-layout', - FileRoutesByPath['/_first/_second-layout']['parentRoute'], - FileRoutesByPath['/_first/_second-layout']['id'], - FileRoutesByPath['/_first/_second-layout']['path'], - FileRoutesByPath['/_first/_second-layout']['fullPath'] - > -} -declare module './routes/posts/posts-detail' { - const createFileRoute: CreateFileRoute< - '/posts/$postId', - FileRoutesByPath['/posts/$postId']['parentRoute'], - FileRoutesByPath['/posts/$postId']['id'], - FileRoutesByPath['/posts/$postId']['path'], - FileRoutesByPath['/posts/$postId']['fullPath'] - > -} -declare module './routes/file-based-subtree/hello/universe' { - const createFileRoute: CreateFileRoute< - '/classic/hello/universe', - FileRoutesByPath['/classic/hello/universe']['parentRoute'], - FileRoutesByPath['/classic/hello/universe']['id'], - FileRoutesByPath['/classic/hello/universe']['path'], - FileRoutesByPath['/classic/hello/universe']['fullPath'] - > -} -declare module './routes/file-based-subtree/hello/world' { - const createFileRoute: CreateFileRoute< - '/classic/hello/world', - FileRoutesByPath['/classic/hello/world']['parentRoute'], - FileRoutesByPath['/classic/hello/world']['id'], - FileRoutesByPath['/classic/hello/world']['path'], - FileRoutesByPath['/classic/hello/world']['fullPath'] - > -} -declare module './routes/file-based-subtree/hello/index' { - const createFileRoute: CreateFileRoute< - '/classic/hello/', - FileRoutesByPath['/classic/hello/']['parentRoute'], - FileRoutesByPath['/classic/hello/']['id'], - FileRoutesByPath['/classic/hello/']['path'], - FileRoutesByPath['/classic/hello/']['fullPath'] - > -} -declare module './routes/a' { - const createFileRoute: CreateFileRoute< - '/_first/_second-layout/route-without-file/layout-a', - FileRoutesByPath['/_first/_second-layout/route-without-file/layout-a']['parentRoute'], - FileRoutesByPath['/_first/_second-layout/route-without-file/layout-a']['id'], - FileRoutesByPath['/_first/_second-layout/route-without-file/layout-a']['path'], - FileRoutesByPath['/_first/_second-layout/route-without-file/layout-a']['fullPath'] - > -} -declare module './routes/b' { - const createFileRoute: CreateFileRoute< - '/_first/_second-layout/route-without-file/layout-b', - FileRoutesByPath['/_first/_second-layout/route-without-file/layout-b']['parentRoute'], - FileRoutesByPath['/_first/_second-layout/route-without-file/layout-b']['id'], - FileRoutesByPath['/_first/_second-layout/route-without-file/layout-b']['path'], - FileRoutesByPath['/_first/_second-layout/route-without-file/layout-b']['fullPath'] - > -} - interface layoutSecondLayoutRouteChildren { aRoute: typeof aRoute bRoute: typeof bRoute diff --git a/examples/react/basic-virtual-file-based/src/routes/a.tsx b/examples/react/basic-virtual-file-based/src/routes/a.tsx index a190b24202..74d17276d9 100644 --- a/examples/react/basic-virtual-file-based/src/routes/a.tsx +++ b/examples/react/basic-virtual-file-based/src/routes/a.tsx @@ -1,4 +1,7 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/react-router' +export const Route = createFileRoute( + '/_first/_second-layout/route-without-file/layout-a', +)({ component: LayoutAComponent, }) diff --git a/examples/react/basic-virtual-file-based/src/routes/b.tsx b/examples/react/basic-virtual-file-based/src/routes/b.tsx index 505f8f6fbf..d9b95f23b4 100644 --- a/examples/react/basic-virtual-file-based/src/routes/b.tsx +++ b/examples/react/basic-virtual-file-based/src/routes/b.tsx @@ -1,4 +1,7 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/react-router' +export const Route = createFileRoute( + '/_first/_second-layout/route-without-file/layout-b', +)({ component: LayoutBComponent, }) diff --git a/examples/react/basic-virtual-file-based/src/routes/file-based-subtree/hello/index.tsx b/examples/react/basic-virtual-file-based/src/routes/file-based-subtree/hello/index.tsx index f86335e291..0cc76f4a69 100644 --- a/examples/react/basic-virtual-file-based/src/routes/file-based-subtree/hello/index.tsx +++ b/examples/react/basic-virtual-file-based/src/routes/file-based-subtree/hello/index.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/react-router' +export const Route = createFileRoute('/classic/hello/')({ component: () =>
    This is the index
    , }) diff --git a/examples/react/basic-virtual-file-based/src/routes/file-based-subtree/hello/route.tsx b/examples/react/basic-virtual-file-based/src/routes/file-based-subtree/hello/route.tsx index 620dd2b76b..566efc8777 100644 --- a/examples/react/basic-virtual-file-based/src/routes/file-based-subtree/hello/route.tsx +++ b/examples/react/basic-virtual-file-based/src/routes/file-based-subtree/hello/route.tsx @@ -1,6 +1,6 @@ -import { Link, Outlet } from '@tanstack/react-router' +import { Link, Outlet, createFileRoute } from '@tanstack/react-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/classic/hello')({ component: () => (
    Hello! diff --git a/examples/react/basic-virtual-file-based/src/routes/file-based-subtree/hello/universe.tsx b/examples/react/basic-virtual-file-based/src/routes/file-based-subtree/hello/universe.tsx index 20b07c41cc..5aaa7d4fa0 100644 --- a/examples/react/basic-virtual-file-based/src/routes/file-based-subtree/hello/universe.tsx +++ b/examples/react/basic-virtual-file-based/src/routes/file-based-subtree/hello/universe.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/react-router' +export const Route = createFileRoute('/classic/hello/universe')({ component: () =>
    Hello /classic/hello/universe!
    , }) diff --git a/examples/react/basic-virtual-file-based/src/routes/file-based-subtree/hello/world.tsx b/examples/react/basic-virtual-file-based/src/routes/file-based-subtree/hello/world.tsx index 4af11357a2..790d33a838 100644 --- a/examples/react/basic-virtual-file-based/src/routes/file-based-subtree/hello/world.tsx +++ b/examples/react/basic-virtual-file-based/src/routes/file-based-subtree/hello/world.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/react-router' +export const Route = createFileRoute('/classic/hello/world')({ component: () =>
    Hello /classic/hello/world!
    , }) diff --git a/examples/react/basic-virtual-file-based/src/routes/home.tsx b/examples/react/basic-virtual-file-based/src/routes/home.tsx index b23956ae17..0a5b7572ba 100644 --- a/examples/react/basic-virtual-file-based/src/routes/home.tsx +++ b/examples/react/basic-virtual-file-based/src/routes/home.tsx @@ -1,6 +1,7 @@ +import { createFileRoute } from '@tanstack/react-router' import * as React from 'react' -export const Route = createFileRoute({ +export const Route = createFileRoute('/')({ component: Home, }) diff --git a/examples/react/basic-virtual-file-based/src/routes/layout/first-layout.tsx b/examples/react/basic-virtual-file-based/src/routes/layout/first-layout.tsx index 5c4a461d8d..d39e206f2d 100644 --- a/examples/react/basic-virtual-file-based/src/routes/layout/first-layout.tsx +++ b/examples/react/basic-virtual-file-based/src/routes/layout/first-layout.tsx @@ -1,6 +1,6 @@ -import { Outlet } from '@tanstack/react-router' +import { Outlet, createFileRoute } from '@tanstack/react-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/_first')({ component: LayoutComponent, }) diff --git a/examples/react/basic-virtual-file-based/src/routes/layout/second-layout.tsx b/examples/react/basic-virtual-file-based/src/routes/layout/second-layout.tsx index 478d9afbec..2f56647492 100644 --- a/examples/react/basic-virtual-file-based/src/routes/layout/second-layout.tsx +++ b/examples/react/basic-virtual-file-based/src/routes/layout/second-layout.tsx @@ -1,6 +1,6 @@ -import { Link, Outlet } from '@tanstack/react-router' +import { Link, Outlet, createFileRoute } from '@tanstack/react-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/_first/_second-layout')({ component: LayoutComponent, }) diff --git a/examples/react/basic-virtual-file-based/src/routes/posts/posts-detail.tsx b/examples/react/basic-virtual-file-based/src/routes/posts/posts-detail.tsx index 654f3cfd18..948d52d6d6 100644 --- a/examples/react/basic-virtual-file-based/src/routes/posts/posts-detail.tsx +++ b/examples/react/basic-virtual-file-based/src/routes/posts/posts-detail.tsx @@ -1,9 +1,9 @@ import * as React from 'react' -import { ErrorComponent } from '@tanstack/react-router' +import { ErrorComponent, createFileRoute } from '@tanstack/react-router' import { fetchPost } from '../../posts' import type { ErrorComponentProps } from '@tanstack/react-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/posts/$postId')({ loader: async ({ params: { postId } }) => fetchPost(postId), errorComponent: PostErrorComponent as any, notFoundComponent: () => { diff --git a/examples/react/basic-virtual-file-based/src/routes/posts/posts-home.tsx b/examples/react/basic-virtual-file-based/src/routes/posts/posts-home.tsx index fdbe5865e5..c6b65f1892 100644 --- a/examples/react/basic-virtual-file-based/src/routes/posts/posts-home.tsx +++ b/examples/react/basic-virtual-file-based/src/routes/posts/posts-home.tsx @@ -1,6 +1,7 @@ +import { createFileRoute } from '@tanstack/react-router' import * as React from 'react' -export const Route = createFileRoute({ +export const Route = createFileRoute('/posts/')({ component: PostsIndexComponent, }) diff --git a/examples/react/basic-virtual-file-based/src/routes/posts/posts.tsx b/examples/react/basic-virtual-file-based/src/routes/posts/posts.tsx index f92c37f537..a2ab1ee388 100644 --- a/examples/react/basic-virtual-file-based/src/routes/posts/posts.tsx +++ b/examples/react/basic-virtual-file-based/src/routes/posts/posts.tsx @@ -1,8 +1,8 @@ import * as React from 'react' -import { Link, Outlet } from '@tanstack/react-router' +import { Link, Outlet, createFileRoute } from '@tanstack/react-router' import { fetchPosts } from '../../posts' -export const Route = createFileRoute({ +export const Route = createFileRoute('/posts')({ loader: fetchPosts, component: PostsComponent, }) diff --git a/examples/react/basic-virtual-file-based/vite.config.ts b/examples/react/basic-virtual-file-based/vite.config.ts index c3c3510479..dd4f00f500 100644 --- a/examples/react/basic-virtual-file-based/vite.config.ts +++ b/examples/react/basic-virtual-file-based/vite.config.ts @@ -10,7 +10,6 @@ export default defineConfig({ tanstackRouter({ target: 'react', autoCodeSplitting: true, - verboseFileRoutes: false, virtualRouteConfig: './routes.ts', }), react(), diff --git a/examples/react/basic-virtual-inside-file-based/package.json b/examples/react/basic-virtual-inside-file-based/package.json index 6c33994e9b..ab2b0b213f 100644 --- a/examples/react/basic-virtual-inside-file-based/package.json +++ b/examples/react/basic-virtual-inside-file-based/package.json @@ -10,21 +10,21 @@ }, "dependencies": { "@tailwindcss/vite": "^4.2.2", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/router-plugin": "^1.167.12", - "@tanstack/virtual-file-routes": "^1.161.7", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/router-plugin": "^1.168.13", + "@tanstack/virtual-file-routes": "^1.162.0", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/basic-virtual-inside-file-based/src/routeTree.gen.ts b/examples/react/basic-virtual-inside-file-based/src/routeTree.gen.ts index 258899f178..947fd037d9 100644 --- a/examples/react/basic-virtual-inside-file-based/src/routeTree.gen.ts +++ b/examples/react/basic-virtual-inside-file-based/src/routeTree.gen.ts @@ -8,19 +8,17 @@ // You should NOT make any changes in this file as it will be overwritten. // Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. -import type { CreateFileRoute, FileRoutesByPath } from '@tanstack/react-router' - import { Route as rootRouteImport } from './routes/__root' import { Route as PostsRouteImport } from './routes/posts' import { Route as LayoutRouteImport } from './routes/_layout' import { Route as IndexRouteImport } from './routes/index' -import { Route as postsDetailsRouteImport } from './routes/posts/details' +import { Route as PostsDetailsRouteImport } from './routes/posts/details' import { Route as LayoutLayout2RouteImport } from './routes/_layout/_layout-2' -import { Route as postsHomeRouteImport } from './routes/posts/home' -import { Route as postsLetsGoIndexRouteImport } from './routes/posts/lets-go/index' +import { Route as PostsHomeRouteImport } from './routes/posts/home' +import { Route as PostsLetsGoIndexRouteImport } from './routes/posts/lets-go/index' import { Route as LayoutLayout2LayoutBRouteImport } from './routes/_layout/_layout-2/layout-b' import { Route as LayoutLayout2LayoutARouteImport } from './routes/_layout/_layout-2/layout-a' -import { Route as postsLetsGoDeeperHomeRouteImport } from './routes/posts/lets-go/deeper/home' +import { Route as PostsLetsGoDeeperHomeRouteImport } from './routes/posts/lets-go/deeper/home' const PostsRoute = PostsRouteImport.update({ id: '/posts', @@ -36,7 +34,7 @@ const IndexRoute = IndexRouteImport.update({ path: '/', getParentRoute: () => rootRouteImport, } as any) -const postsDetailsRoute = postsDetailsRouteImport.update({ +const PostsDetailsRoute = PostsDetailsRouteImport.update({ id: '/$postId', path: '/$postId', getParentRoute: () => PostsRoute, @@ -45,12 +43,12 @@ const LayoutLayout2Route = LayoutLayout2RouteImport.update({ id: '/_layout-2', getParentRoute: () => LayoutRoute, } as any) -const postsHomeRoute = postsHomeRouteImport.update({ +const PostsHomeRoute = PostsHomeRouteImport.update({ id: '/', path: '/', getParentRoute: () => PostsRoute, } as any) -const postsLetsGoIndexRoute = postsLetsGoIndexRouteImport.update({ +const PostsLetsGoIndexRoute = PostsLetsGoIndexRouteImport.update({ id: '/inception/', path: '/inception/', getParentRoute: () => PostsRoute, @@ -65,7 +63,7 @@ const LayoutLayout2LayoutARoute = LayoutLayout2LayoutARouteImport.update({ path: '/layout-a', getParentRoute: () => LayoutLayout2Route, } as any) -const postsLetsGoDeeperHomeRoute = postsLetsGoDeeperHomeRouteImport.update({ +const PostsLetsGoDeeperHomeRoute = PostsLetsGoDeeperHomeRouteImport.update({ id: '/inception/deeper/', path: '/inception/deeper/', getParentRoute: () => PostsRoute, @@ -74,34 +72,34 @@ const postsLetsGoDeeperHomeRoute = postsLetsGoDeeperHomeRouteImport.update({ export interface FileRoutesByFullPath { '/': typeof IndexRoute '/posts': typeof PostsRouteWithChildren - '/posts/': typeof postsHomeRoute - '/posts/$postId': typeof postsDetailsRoute + '/posts/': typeof PostsHomeRoute + '/posts/$postId': typeof PostsDetailsRoute '/layout-a': typeof LayoutLayout2LayoutARoute '/layout-b': typeof LayoutLayout2LayoutBRoute - '/posts/inception/': typeof postsLetsGoIndexRoute - '/posts/inception/deeper/': typeof postsLetsGoDeeperHomeRoute + '/posts/inception/': typeof PostsLetsGoIndexRoute + '/posts/inception/deeper/': typeof PostsLetsGoDeeperHomeRoute } export interface FileRoutesByTo { '/': typeof IndexRoute - '/posts': typeof postsHomeRoute - '/posts/$postId': typeof postsDetailsRoute + '/posts': typeof PostsHomeRoute + '/posts/$postId': typeof PostsDetailsRoute '/layout-a': typeof LayoutLayout2LayoutARoute '/layout-b': typeof LayoutLayout2LayoutBRoute - '/posts/inception': typeof postsLetsGoIndexRoute - '/posts/inception/deeper': typeof postsLetsGoDeeperHomeRoute + '/posts/inception': typeof PostsLetsGoIndexRoute + '/posts/inception/deeper': typeof PostsLetsGoDeeperHomeRoute } export interface FileRoutesById { __root__: typeof rootRouteImport '/': typeof IndexRoute '/_layout': typeof LayoutRouteWithChildren '/posts': typeof PostsRouteWithChildren - '/posts/': typeof postsHomeRoute + '/posts/': typeof PostsHomeRoute '/_layout/_layout-2': typeof LayoutLayout2RouteWithChildren - '/posts/$postId': typeof postsDetailsRoute + '/posts/$postId': typeof PostsDetailsRoute '/_layout/_layout-2/layout-a': typeof LayoutLayout2LayoutARoute '/_layout/_layout-2/layout-b': typeof LayoutLayout2LayoutBRoute - '/posts/inception/': typeof postsLetsGoIndexRoute - '/posts/inception/deeper/': typeof postsLetsGoDeeperHomeRoute + '/posts/inception/': typeof PostsLetsGoIndexRoute + '/posts/inception/deeper/': typeof PostsLetsGoDeeperHomeRoute } export interface FileRouteTypes { fileRoutesByFullPath: FileRoutesByFullPath @@ -170,7 +168,7 @@ declare module '@tanstack/react-router' { id: '/posts/$postId' path: '/$postId' fullPath: '/posts/$postId' - preLoaderRoute: typeof postsDetailsRouteImport + preLoaderRoute: typeof PostsDetailsRouteImport parentRoute: typeof PostsRoute } '/_layout/_layout-2': { @@ -184,14 +182,14 @@ declare module '@tanstack/react-router' { id: '/posts/' path: '/' fullPath: '/posts/' - preLoaderRoute: typeof postsHomeRouteImport + preLoaderRoute: typeof PostsHomeRouteImport parentRoute: typeof PostsRoute } '/posts/inception/': { id: '/posts/inception/' path: '/inception' fullPath: '/posts/inception/' - preLoaderRoute: typeof postsLetsGoIndexRouteImport + preLoaderRoute: typeof PostsLetsGoIndexRouteImport parentRoute: typeof PostsRoute } '/_layout/_layout-2/layout-b': { @@ -212,103 +210,12 @@ declare module '@tanstack/react-router' { id: '/posts/inception/deeper/' path: '/inception/deeper' fullPath: '/posts/inception/deeper/' - preLoaderRoute: typeof postsLetsGoDeeperHomeRouteImport + preLoaderRoute: typeof PostsLetsGoDeeperHomeRouteImport parentRoute: typeof PostsRoute } } } -declare module './routes/index' { - const createFileRoute: CreateFileRoute< - '/', - FileRoutesByPath['/']['parentRoute'], - FileRoutesByPath['/']['id'], - FileRoutesByPath['/']['path'], - FileRoutesByPath['/']['fullPath'] - > -} -declare module './routes/_layout' { - const createFileRoute: CreateFileRoute< - '/_layout', - FileRoutesByPath['/_layout']['parentRoute'], - FileRoutesByPath['/_layout']['id'], - FileRoutesByPath['/_layout']['path'], - FileRoutesByPath['/_layout']['fullPath'] - > -} -declare module './routes/posts' { - const createFileRoute: CreateFileRoute< - '/posts', - FileRoutesByPath['/posts']['parentRoute'], - FileRoutesByPath['/posts']['id'], - FileRoutesByPath['/posts']['path'], - FileRoutesByPath['/posts']['fullPath'] - > -} -declare module './routes/posts/home' { - const createFileRoute: CreateFileRoute< - '/posts/', - FileRoutesByPath['/posts/']['parentRoute'], - FileRoutesByPath['/posts/']['id'], - FileRoutesByPath['/posts/']['path'], - FileRoutesByPath['/posts/']['fullPath'] - > -} -declare module './routes/_layout/_layout-2' { - const createFileRoute: CreateFileRoute< - '/_layout/_layout-2', - FileRoutesByPath['/_layout/_layout-2']['parentRoute'], - FileRoutesByPath['/_layout/_layout-2']['id'], - FileRoutesByPath['/_layout/_layout-2']['path'], - FileRoutesByPath['/_layout/_layout-2']['fullPath'] - > -} -declare module './routes/posts/details' { - const createFileRoute: CreateFileRoute< - '/posts/$postId', - FileRoutesByPath['/posts/$postId']['parentRoute'], - FileRoutesByPath['/posts/$postId']['id'], - FileRoutesByPath['/posts/$postId']['path'], - FileRoutesByPath['/posts/$postId']['fullPath'] - > -} -declare module './routes/_layout/_layout-2/layout-a' { - const createFileRoute: CreateFileRoute< - '/_layout/_layout-2/layout-a', - FileRoutesByPath['/_layout/_layout-2/layout-a']['parentRoute'], - FileRoutesByPath['/_layout/_layout-2/layout-a']['id'], - FileRoutesByPath['/_layout/_layout-2/layout-a']['path'], - FileRoutesByPath['/_layout/_layout-2/layout-a']['fullPath'] - > -} -declare module './routes/_layout/_layout-2/layout-b' { - const createFileRoute: CreateFileRoute< - '/_layout/_layout-2/layout-b', - FileRoutesByPath['/_layout/_layout-2/layout-b']['parentRoute'], - FileRoutesByPath['/_layout/_layout-2/layout-b']['id'], - FileRoutesByPath['/_layout/_layout-2/layout-b']['path'], - FileRoutesByPath['/_layout/_layout-2/layout-b']['fullPath'] - > -} -declare module './routes/posts/lets-go/index' { - const createFileRoute: CreateFileRoute< - '/posts/inception/', - FileRoutesByPath['/posts/inception/']['parentRoute'], - FileRoutesByPath['/posts/inception/']['id'], - FileRoutesByPath['/posts/inception/']['path'], - FileRoutesByPath['/posts/inception/']['fullPath'] - > -} -declare module './routes/posts/lets-go/deeper/home' { - const createFileRoute: CreateFileRoute< - '/posts/inception/deeper/', - FileRoutesByPath['/posts/inception/deeper/']['parentRoute'], - FileRoutesByPath['/posts/inception/deeper/']['id'], - FileRoutesByPath['/posts/inception/deeper/']['path'], - FileRoutesByPath['/posts/inception/deeper/']['fullPath'] - > -} - interface LayoutLayout2RouteChildren { LayoutLayout2LayoutARoute: typeof LayoutLayout2LayoutARoute LayoutLayout2LayoutBRoute: typeof LayoutLayout2LayoutBRoute @@ -335,17 +242,17 @@ const LayoutRouteWithChildren = LayoutRoute._addFileChildren(LayoutRouteChildren) interface PostsRouteChildren { - postsHomeRoute: typeof postsHomeRoute - postsDetailsRoute: typeof postsDetailsRoute - postsLetsGoIndexRoute: typeof postsLetsGoIndexRoute - postsLetsGoDeeperHomeRoute: typeof postsLetsGoDeeperHomeRoute + PostsHomeRoute: typeof PostsHomeRoute + PostsDetailsRoute: typeof PostsDetailsRoute + PostsLetsGoIndexRoute: typeof PostsLetsGoIndexRoute + PostsLetsGoDeeperHomeRoute: typeof PostsLetsGoDeeperHomeRoute } const PostsRouteChildren: PostsRouteChildren = { - postsHomeRoute: postsHomeRoute, - postsDetailsRoute: postsDetailsRoute, - postsLetsGoIndexRoute: postsLetsGoIndexRoute, - postsLetsGoDeeperHomeRoute: postsLetsGoDeeperHomeRoute, + PostsHomeRoute: PostsHomeRoute, + PostsDetailsRoute: PostsDetailsRoute, + PostsLetsGoIndexRoute: PostsLetsGoIndexRoute, + PostsLetsGoDeeperHomeRoute: PostsLetsGoDeeperHomeRoute, } const PostsRouteWithChildren = PostsRoute._addFileChildren(PostsRouteChildren) diff --git a/examples/react/basic-virtual-inside-file-based/src/routes/_layout.tsx b/examples/react/basic-virtual-inside-file-based/src/routes/_layout.tsx index 5c4a461d8d..02ddbb1cd9 100644 --- a/examples/react/basic-virtual-inside-file-based/src/routes/_layout.tsx +++ b/examples/react/basic-virtual-inside-file-based/src/routes/_layout.tsx @@ -1,6 +1,6 @@ -import { Outlet } from '@tanstack/react-router' +import { Outlet, createFileRoute } from '@tanstack/react-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/_layout')({ component: LayoutComponent, }) diff --git a/examples/react/basic-virtual-inside-file-based/src/routes/_layout/_layout-2.tsx b/examples/react/basic-virtual-inside-file-based/src/routes/_layout/_layout-2.tsx index 483b910862..3b7dbf2903 100644 --- a/examples/react/basic-virtual-inside-file-based/src/routes/_layout/_layout-2.tsx +++ b/examples/react/basic-virtual-inside-file-based/src/routes/_layout/_layout-2.tsx @@ -1,6 +1,6 @@ -import { Link, Outlet } from '@tanstack/react-router' +import { Link, Outlet, createFileRoute } from '@tanstack/react-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/_layout/_layout-2')({ component: LayoutComponent, }) diff --git a/examples/react/basic-virtual-inside-file-based/src/routes/_layout/_layout-2/layout-a.tsx b/examples/react/basic-virtual-inside-file-based/src/routes/_layout/_layout-2/layout-a.tsx index a190b24202..ed2dea8800 100644 --- a/examples/react/basic-virtual-inside-file-based/src/routes/_layout/_layout-2/layout-a.tsx +++ b/examples/react/basic-virtual-inside-file-based/src/routes/_layout/_layout-2/layout-a.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/react-router' +export const Route = createFileRoute('/_layout/_layout-2/layout-a')({ component: LayoutAComponent, }) diff --git a/examples/react/basic-virtual-inside-file-based/src/routes/_layout/_layout-2/layout-b.tsx b/examples/react/basic-virtual-inside-file-based/src/routes/_layout/_layout-2/layout-b.tsx index 505f8f6fbf..4799d403e9 100644 --- a/examples/react/basic-virtual-inside-file-based/src/routes/_layout/_layout-2/layout-b.tsx +++ b/examples/react/basic-virtual-inside-file-based/src/routes/_layout/_layout-2/layout-b.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/react-router' +export const Route = createFileRoute('/_layout/_layout-2/layout-b')({ component: LayoutBComponent, }) diff --git a/examples/react/basic-virtual-inside-file-based/src/routes/index.tsx b/examples/react/basic-virtual-inside-file-based/src/routes/index.tsx index b23956ae17..0a5b7572ba 100644 --- a/examples/react/basic-virtual-inside-file-based/src/routes/index.tsx +++ b/examples/react/basic-virtual-inside-file-based/src/routes/index.tsx @@ -1,6 +1,7 @@ +import { createFileRoute } from '@tanstack/react-router' import * as React from 'react' -export const Route = createFileRoute({ +export const Route = createFileRoute('/')({ component: Home, }) diff --git a/examples/react/basic-virtual-inside-file-based/src/routes/posts.tsx b/examples/react/basic-virtual-inside-file-based/src/routes/posts.tsx index 4469b2216a..c7a09ed7f8 100644 --- a/examples/react/basic-virtual-inside-file-based/src/routes/posts.tsx +++ b/examples/react/basic-virtual-inside-file-based/src/routes/posts.tsx @@ -1,8 +1,8 @@ import * as React from 'react' -import { Link, Outlet } from '@tanstack/react-router' +import { Link, Outlet, createFileRoute } from '@tanstack/react-router' import { fetchPosts } from '../posts' -export const Route = createFileRoute({ +export const Route = createFileRoute('/posts')({ loader: fetchPosts, component: PostsComponent, }) diff --git a/examples/react/basic-virtual-inside-file-based/src/routes/posts/details.tsx b/examples/react/basic-virtual-inside-file-based/src/routes/posts/details.tsx index fc10978507..6479bdf803 100644 --- a/examples/react/basic-virtual-inside-file-based/src/routes/posts/details.tsx +++ b/examples/react/basic-virtual-inside-file-based/src/routes/posts/details.tsx @@ -1,9 +1,9 @@ import * as React from 'react' -import { ErrorComponent } from '@tanstack/react-router' +import { ErrorComponent, createFileRoute } from '@tanstack/react-router' import { fetchPost } from '../../posts' import type { ErrorComponentProps } from '@tanstack/react-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/posts/$postId')({ loader: async ({ params: { postId } }) => fetchPost(postId), errorComponent: PostErrorComponent, notFoundComponent: () => { diff --git a/examples/react/basic-virtual-inside-file-based/src/routes/posts/home.tsx b/examples/react/basic-virtual-inside-file-based/src/routes/posts/home.tsx index fdbe5865e5..c6b65f1892 100644 --- a/examples/react/basic-virtual-inside-file-based/src/routes/posts/home.tsx +++ b/examples/react/basic-virtual-inside-file-based/src/routes/posts/home.tsx @@ -1,6 +1,7 @@ +import { createFileRoute } from '@tanstack/react-router' import * as React from 'react' -export const Route = createFileRoute({ +export const Route = createFileRoute('/posts/')({ component: PostsIndexComponent, }) diff --git a/examples/react/basic-virtual-inside-file-based/src/routes/posts/lets-go/deeper/home.tsx b/examples/react/basic-virtual-inside-file-based/src/routes/posts/lets-go/deeper/home.tsx index f8bc76644a..d2e95051f6 100644 --- a/examples/react/basic-virtual-inside-file-based/src/routes/posts/lets-go/deeper/home.tsx +++ b/examples/react/basic-virtual-inside-file-based/src/routes/posts/lets-go/deeper/home.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/react-router' +export const Route = createFileRoute('/posts/inception/deeper/')({ component: () =>
    Hello /posts/inception/deeper/!
    , }) diff --git a/examples/react/basic-virtual-inside-file-based/src/routes/posts/lets-go/index.tsx b/examples/react/basic-virtual-inside-file-based/src/routes/posts/lets-go/index.tsx index 1c7ea68931..1a7358f044 100644 --- a/examples/react/basic-virtual-inside-file-based/src/routes/posts/lets-go/index.tsx +++ b/examples/react/basic-virtual-inside-file-based/src/routes/posts/lets-go/index.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/react-router' +export const Route = createFileRoute('/posts/inception/')({ component: () =>
    Hello /posts/inception/!
    , }) diff --git a/examples/react/basic-virtual-inside-file-based/vite.config.ts b/examples/react/basic-virtual-inside-file-based/vite.config.ts index 9630396b91..e6a8f48b5f 100644 --- a/examples/react/basic-virtual-inside-file-based/vite.config.ts +++ b/examples/react/basic-virtual-inside-file-based/vite.config.ts @@ -10,7 +10,6 @@ export default defineConfig({ tanstackRouter({ target: 'react', autoCodeSplitting: true, - verboseFileRoutes: false, }), react(), ], diff --git a/examples/react/basic/package.json b/examples/react/basic/package.json index 1d776a5785..8c8921d82c 100644 --- a/examples/react/basic/package.json +++ b/examples/react/basic/package.json @@ -10,8 +10,8 @@ }, "dependencies": { "@tailwindcss/vite": "^4.2.2", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", @@ -22,6 +22,6 @@ "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/deferred-data/package.json b/examples/react/deferred-data/package.json index c38fe713f0..55e8d4a467 100644 --- a/examples/react/deferred-data/package.json +++ b/examples/react/deferred-data/package.json @@ -10,19 +10,19 @@ }, "dependencies": { "@tailwindcss/vite": "^4.2.2", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/i18n-paraglide/package.json b/examples/react/i18n-paraglide/package.json index 676dd16d88..fa495e9296 100644 --- a/examples/react/i18n-paraglide/package.json +++ b/examples/react/i18n-paraglide/package.json @@ -11,8 +11,8 @@ }, "dependencies": { "@tailwindcss/vite": "^4.2.2", - "@tanstack/react-router": "^1.168.10", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/react-router": "^1.170.10", + "@tanstack/router-plugin": "^1.168.13", "react": "^19.1.1", "react-dom": "^19.1.1", "tailwindcss": "^4.2.2" @@ -23,7 +23,7 @@ "@types/react-dom": "^19.1.9", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "@inlang/paraglide-js": "^2.4.0" } } diff --git a/examples/react/kitchen-sink-file-based/package.json b/examples/react/kitchen-sink-file-based/package.json index e691cf748f..d1cc74a616 100644 --- a/examples/react/kitchen-sink-file-based/package.json +++ b/examples/react/kitchen-sink-file-based/package.json @@ -10,21 +10,21 @@ }, "dependencies": { "@tailwindcss/vite": "^4.2.2", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/router-plugin": "^1.168.13", "immer": "^10.1.1", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/kitchen-sink-file-based/src/routeTree.gen.ts b/examples/react/kitchen-sink-file-based/src/routeTree.gen.ts index f3accfa48e..1e29ba5794 100644 --- a/examples/react/kitchen-sink-file-based/src/routeTree.gen.ts +++ b/examples/react/kitchen-sink-file-based/src/routeTree.gen.ts @@ -8,9 +8,7 @@ // You should NOT make any changes in this file as it will be overwritten. // Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. -// Import Routes - -import { Route as rootRoute } from './routes/__root' +import { Route as rootRouteImport } from './routes/__root' import { Route as LoginRouteImport } from './routes/login' import { Route as PathlessLayoutRouteImport } from './routes/_pathlessLayout' import { Route as AuthRouteImport } from './routes/_auth' @@ -29,103 +27,85 @@ import { Route as DashboardInvoicesIndexRouteImport } from './routes/dashboard.i import { Route as DashboardUsersUserRouteImport } from './routes/dashboard.users.user' import { Route as DashboardInvoicesInvoiceIdRouteImport } from './routes/dashboard.invoices.$invoiceId' -// Create/Update Routes - const LoginRoute = LoginRouteImport.update({ id: '/login', path: '/login', - getParentRoute: () => rootRoute, + getParentRoute: () => rootRouteImport, } as any) - const PathlessLayoutRoute = PathlessLayoutRouteImport.update({ id: '/_pathlessLayout', - getParentRoute: () => rootRoute, + getParentRoute: () => rootRouteImport, } as any) - const AuthRoute = AuthRouteImport.update({ id: '/_auth', - getParentRoute: () => rootRoute, + getParentRoute: () => rootRouteImport, } as any) - const DashboardRouteRoute = DashboardRouteRouteImport.update({ id: '/dashboard', path: '/dashboard', - getParentRoute: () => rootRoute, + getParentRoute: () => rootRouteImport, } as any) - const IndexRoute = IndexRouteImport.update({ id: '/', path: '/', - getParentRoute: () => rootRoute, + getParentRoute: () => rootRouteImport, } as any) - const ExpensiveIndexRoute = ExpensiveIndexRouteImport.update({ id: '/expensive/', path: '/expensive/', - getParentRoute: () => rootRoute, + getParentRoute: () => rootRouteImport, } as any) - const DashboardIndexRoute = DashboardIndexRouteImport.update({ id: '/', path: '/', getParentRoute: () => DashboardRouteRoute, } as any) - const PathlessLayoutRouteBRoute = PathlessLayoutRouteBRouteImport.update({ id: '/route-b', path: '/route-b', getParentRoute: () => PathlessLayoutRoute, } as any) - const PathlessLayoutRouteARoute = PathlessLayoutRouteARouteImport.update({ id: '/route-a', path: '/route-a', getParentRoute: () => PathlessLayoutRoute, } as any) - const AuthProfileRoute = AuthProfileRouteImport.update({ id: '/profile', path: '/profile', getParentRoute: () => AuthRoute, } as any) - const thisFolderIsNotInTheUrlRouteGroupRoute = thisFolderIsNotInTheUrlRouteGroupRouteImport.update({ id: '/(this-folder-is-not-in-the-url)/route-group', path: '/route-group', - getParentRoute: () => rootRoute, + getParentRoute: () => rootRouteImport, } as any) - const DashboardUsersRouteRoute = DashboardUsersRouteRouteImport.update({ id: '/users', path: '/users', getParentRoute: () => DashboardRouteRoute, } as any) - const DashboardInvoicesRouteRoute = DashboardInvoicesRouteRouteImport.update({ id: '/invoices', path: '/invoices', getParentRoute: () => DashboardRouteRoute, } as any) - const DashboardUsersIndexRoute = DashboardUsersIndexRouteImport.update({ id: '/', path: '/', getParentRoute: () => DashboardUsersRouteRoute, } as any) - const DashboardInvoicesIndexRoute = DashboardInvoicesIndexRouteImport.update({ id: '/', path: '/', getParentRoute: () => DashboardInvoicesRouteRoute, } as any) - const DashboardUsersUserRoute = DashboardUsersUserRouteImport.update({ id: '/user', path: '/user', getParentRoute: () => DashboardUsersRouteRoute, } as any) - const DashboardInvoicesInvoiceIdRoute = DashboardInvoicesInvoiceIdRouteImport.update({ id: '/$invoiceId', @@ -133,134 +113,244 @@ const DashboardInvoicesInvoiceIdRoute = getParentRoute: () => DashboardInvoicesRouteRoute, } as any) -// Populate the FileRoutesByPath interface +export interface FileRoutesByFullPath { + '/': typeof IndexRoute + '/dashboard': typeof DashboardRouteRouteWithChildren + '/login': typeof LoginRoute + '/dashboard/invoices': typeof DashboardInvoicesRouteRouteWithChildren + '/dashboard/users': typeof DashboardUsersRouteRouteWithChildren + '/route-group': typeof thisFolderIsNotInTheUrlRouteGroupRoute + '/profile': typeof AuthProfileRoute + '/route-a': typeof PathlessLayoutRouteARoute + '/route-b': typeof PathlessLayoutRouteBRoute + '/dashboard/': typeof DashboardIndexRoute + '/expensive/': typeof ExpensiveIndexRoute + '/dashboard/invoices/$invoiceId': typeof DashboardInvoicesInvoiceIdRoute + '/dashboard/users/user': typeof DashboardUsersUserRoute + '/dashboard/invoices/': typeof DashboardInvoicesIndexRoute + '/dashboard/users/': typeof DashboardUsersIndexRoute +} +export interface FileRoutesByTo { + '/': typeof IndexRoute + '/login': typeof LoginRoute + '/route-group': typeof thisFolderIsNotInTheUrlRouteGroupRoute + '/profile': typeof AuthProfileRoute + '/route-a': typeof PathlessLayoutRouteARoute + '/route-b': typeof PathlessLayoutRouteBRoute + '/dashboard': typeof DashboardIndexRoute + '/expensive': typeof ExpensiveIndexRoute + '/dashboard/invoices/$invoiceId': typeof DashboardInvoicesInvoiceIdRoute + '/dashboard/users/user': typeof DashboardUsersUserRoute + '/dashboard/invoices': typeof DashboardInvoicesIndexRoute + '/dashboard/users': typeof DashboardUsersIndexRoute +} +export interface FileRoutesById { + __root__: typeof rootRouteImport + '/': typeof IndexRoute + '/dashboard': typeof DashboardRouteRouteWithChildren + '/_auth': typeof AuthRouteWithChildren + '/_pathlessLayout': typeof PathlessLayoutRouteWithChildren + '/login': typeof LoginRoute + '/dashboard/invoices': typeof DashboardInvoicesRouteRouteWithChildren + '/dashboard/users': typeof DashboardUsersRouteRouteWithChildren + '/(this-folder-is-not-in-the-url)/route-group': typeof thisFolderIsNotInTheUrlRouteGroupRoute + '/_auth/profile': typeof AuthProfileRoute + '/_pathlessLayout/route-a': typeof PathlessLayoutRouteARoute + '/_pathlessLayout/route-b': typeof PathlessLayoutRouteBRoute + '/dashboard/': typeof DashboardIndexRoute + '/expensive/': typeof ExpensiveIndexRoute + '/dashboard/invoices/$invoiceId': typeof DashboardInvoicesInvoiceIdRoute + '/dashboard/users/user': typeof DashboardUsersUserRoute + '/dashboard/invoices/': typeof DashboardInvoicesIndexRoute + '/dashboard/users/': typeof DashboardUsersIndexRoute +} +export interface FileRouteTypes { + fileRoutesByFullPath: FileRoutesByFullPath + fullPaths: + | '/' + | '/dashboard' + | '/login' + | '/dashboard/invoices' + | '/dashboard/users' + | '/route-group' + | '/profile' + | '/route-a' + | '/route-b' + | '/dashboard/' + | '/expensive/' + | '/dashboard/invoices/$invoiceId' + | '/dashboard/users/user' + | '/dashboard/invoices/' + | '/dashboard/users/' + fileRoutesByTo: FileRoutesByTo + to: + | '/' + | '/login' + | '/route-group' + | '/profile' + | '/route-a' + | '/route-b' + | '/dashboard' + | '/expensive' + | '/dashboard/invoices/$invoiceId' + | '/dashboard/users/user' + | '/dashboard/invoices' + | '/dashboard/users' + id: + | '__root__' + | '/' + | '/dashboard' + | '/_auth' + | '/_pathlessLayout' + | '/login' + | '/dashboard/invoices' + | '/dashboard/users' + | '/(this-folder-is-not-in-the-url)/route-group' + | '/_auth/profile' + | '/_pathlessLayout/route-a' + | '/_pathlessLayout/route-b' + | '/dashboard/' + | '/expensive/' + | '/dashboard/invoices/$invoiceId' + | '/dashboard/users/user' + | '/dashboard/invoices/' + | '/dashboard/users/' + fileRoutesById: FileRoutesById +} +export interface RootRouteChildren { + IndexRoute: typeof IndexRoute + DashboardRouteRoute: typeof DashboardRouteRouteWithChildren + AuthRoute: typeof AuthRouteWithChildren + PathlessLayoutRoute: typeof PathlessLayoutRouteWithChildren + LoginRoute: typeof LoginRoute + thisFolderIsNotInTheUrlRouteGroupRoute: typeof thisFolderIsNotInTheUrlRouteGroupRoute + ExpensiveIndexRoute: typeof ExpensiveIndexRoute +} declare module '@tanstack/react-router' { interface FileRoutesByPath { - '/': { - id: '/' - path: '/' + '/login': { + id: '/login' + path: '/login' + fullPath: '/login' + preLoaderRoute: typeof LoginRouteImport + parentRoute: typeof rootRouteImport + } + '/_pathlessLayout': { + id: '/_pathlessLayout' + path: '' fullPath: '/' - preLoaderRoute: typeof IndexRouteImport - parentRoute: typeof rootRoute + preLoaderRoute: typeof PathlessLayoutRouteImport + parentRoute: typeof rootRouteImport + } + '/_auth': { + id: '/_auth' + path: '' + fullPath: '/' + preLoaderRoute: typeof AuthRouteImport + parentRoute: typeof rootRouteImport } '/dashboard': { id: '/dashboard' path: '/dashboard' fullPath: '/dashboard' preLoaderRoute: typeof DashboardRouteRouteImport - parentRoute: typeof rootRoute + parentRoute: typeof rootRouteImport } - '/_auth': { - id: '/_auth' - path: '' - fullPath: '' - preLoaderRoute: typeof AuthRouteImport - parentRoute: typeof rootRoute + '/': { + id: '/' + path: '/' + fullPath: '/' + preLoaderRoute: typeof IndexRouteImport + parentRoute: typeof rootRouteImport } - '/_pathlessLayout': { - id: '/_pathlessLayout' - path: '' - fullPath: '' - preLoaderRoute: typeof PathlessLayoutRouteImport - parentRoute: typeof rootRoute - } - '/login': { - id: '/login' - path: '/login' - fullPath: '/login' - preLoaderRoute: typeof LoginRouteImport - parentRoute: typeof rootRoute - } - '/dashboard/invoices': { - id: '/dashboard/invoices' - path: '/invoices' - fullPath: '/dashboard/invoices' - preLoaderRoute: typeof DashboardInvoicesRouteRouteImport - parentRoute: typeof DashboardRouteRouteImport - } - '/dashboard/users': { - id: '/dashboard/users' - path: '/users' - fullPath: '/dashboard/users' - preLoaderRoute: typeof DashboardUsersRouteRouteImport - parentRoute: typeof DashboardRouteRouteImport - } - '/(this-folder-is-not-in-the-url)/route-group': { - id: '/(this-folder-is-not-in-the-url)/route-group' - path: '/route-group' - fullPath: '/route-group' - preLoaderRoute: typeof thisFolderIsNotInTheUrlRouteGroupRouteImport - parentRoute: typeof rootRoute - } - '/_auth/profile': { - id: '/_auth/profile' - path: '/profile' - fullPath: '/profile' - preLoaderRoute: typeof AuthProfileRouteImport - parentRoute: typeof AuthRouteImport - } - '/_pathlessLayout/route-a': { - id: '/_pathlessLayout/route-a' - path: '/route-a' - fullPath: '/route-a' - preLoaderRoute: typeof PathlessLayoutRouteARouteImport - parentRoute: typeof PathlessLayoutRouteImport - } - '/_pathlessLayout/route-b': { - id: '/_pathlessLayout/route-b' - path: '/route-b' - fullPath: '/route-b' - preLoaderRoute: typeof PathlessLayoutRouteBRouteImport - parentRoute: typeof PathlessLayoutRouteImport + '/expensive/': { + id: '/expensive/' + path: '/expensive' + fullPath: '/expensive/' + preLoaderRoute: typeof ExpensiveIndexRouteImport + parentRoute: typeof rootRouteImport } '/dashboard/': { id: '/dashboard/' path: '/' fullPath: '/dashboard/' preLoaderRoute: typeof DashboardIndexRouteImport - parentRoute: typeof DashboardRouteRouteImport + parentRoute: typeof DashboardRouteRoute } - '/expensive/': { - id: '/expensive/' - path: '/expensive' - fullPath: '/expensive' - preLoaderRoute: typeof ExpensiveIndexRouteImport - parentRoute: typeof rootRoute + '/_pathlessLayout/route-b': { + id: '/_pathlessLayout/route-b' + path: '/route-b' + fullPath: '/route-b' + preLoaderRoute: typeof PathlessLayoutRouteBRouteImport + parentRoute: typeof PathlessLayoutRoute } - '/dashboard/invoices/$invoiceId': { - id: '/dashboard/invoices/$invoiceId' - path: '/$invoiceId' - fullPath: '/dashboard/invoices/$invoiceId' - preLoaderRoute: typeof DashboardInvoicesInvoiceIdRouteImport - parentRoute: typeof DashboardInvoicesRouteRouteImport + '/_pathlessLayout/route-a': { + id: '/_pathlessLayout/route-a' + path: '/route-a' + fullPath: '/route-a' + preLoaderRoute: typeof PathlessLayoutRouteARouteImport + parentRoute: typeof PathlessLayoutRoute } - '/dashboard/users/user': { - id: '/dashboard/users/user' - path: '/user' - fullPath: '/dashboard/users/user' - preLoaderRoute: typeof DashboardUsersUserRouteImport - parentRoute: typeof DashboardUsersRouteRouteImport + '/_auth/profile': { + id: '/_auth/profile' + path: '/profile' + fullPath: '/profile' + preLoaderRoute: typeof AuthProfileRouteImport + parentRoute: typeof AuthRoute } - '/dashboard/invoices/': { - id: '/dashboard/invoices/' - path: '/' - fullPath: '/dashboard/invoices/' - preLoaderRoute: typeof DashboardInvoicesIndexRouteImport - parentRoute: typeof DashboardInvoicesRouteRouteImport + '/(this-folder-is-not-in-the-url)/route-group': { + id: '/(this-folder-is-not-in-the-url)/route-group' + path: '/route-group' + fullPath: '/route-group' + preLoaderRoute: typeof thisFolderIsNotInTheUrlRouteGroupRouteImport + parentRoute: typeof rootRouteImport + } + '/dashboard/users': { + id: '/dashboard/users' + path: '/users' + fullPath: '/dashboard/users' + preLoaderRoute: typeof DashboardUsersRouteRouteImport + parentRoute: typeof DashboardRouteRoute + } + '/dashboard/invoices': { + id: '/dashboard/invoices' + path: '/invoices' + fullPath: '/dashboard/invoices' + preLoaderRoute: typeof DashboardInvoicesRouteRouteImport + parentRoute: typeof DashboardRouteRoute } '/dashboard/users/': { id: '/dashboard/users/' path: '/' fullPath: '/dashboard/users/' preLoaderRoute: typeof DashboardUsersIndexRouteImport - parentRoute: typeof DashboardUsersRouteRouteImport + parentRoute: typeof DashboardUsersRouteRoute + } + '/dashboard/invoices/': { + id: '/dashboard/invoices/' + path: '/' + fullPath: '/dashboard/invoices/' + preLoaderRoute: typeof DashboardInvoicesIndexRouteImport + parentRoute: typeof DashboardInvoicesRouteRoute + } + '/dashboard/users/user': { + id: '/dashboard/users/user' + path: '/user' + fullPath: '/dashboard/users/user' + preLoaderRoute: typeof DashboardUsersUserRouteImport + parentRoute: typeof DashboardUsersRouteRoute + } + '/dashboard/invoices/$invoiceId': { + id: '/dashboard/invoices/$invoiceId' + path: '/$invoiceId' + fullPath: '/dashboard/invoices/$invoiceId' + preLoaderRoute: typeof DashboardInvoicesInvoiceIdRouteImport + parentRoute: typeof DashboardInvoicesRouteRoute } } } -// Create and export the route tree - interface DashboardInvoicesRouteRouteChildren { DashboardInvoicesInvoiceIdRoute: typeof DashboardInvoicesInvoiceIdRoute DashboardInvoicesIndexRoute: typeof DashboardInvoicesIndexRoute @@ -330,128 +420,6 @@ const PathlessLayoutRouteWithChildren = PathlessLayoutRoute._addFileChildren( PathlessLayoutRouteChildren, ) -export interface FileRoutesByFullPath { - '/': typeof IndexRoute - '/dashboard': typeof DashboardRouteRouteWithChildren - '': typeof PathlessLayoutRouteWithChildren - '/login': typeof LoginRoute - '/dashboard/invoices': typeof DashboardInvoicesRouteRouteWithChildren - '/dashboard/users': typeof DashboardUsersRouteRouteWithChildren - '/route-group': typeof thisFolderIsNotInTheUrlRouteGroupRoute - '/profile': typeof AuthProfileRoute - '/route-a': typeof PathlessLayoutRouteARoute - '/route-b': typeof PathlessLayoutRouteBRoute - '/dashboard/': typeof DashboardIndexRoute - '/expensive': typeof ExpensiveIndexRoute - '/dashboard/invoices/$invoiceId': typeof DashboardInvoicesInvoiceIdRoute - '/dashboard/users/user': typeof DashboardUsersUserRoute - '/dashboard/invoices/': typeof DashboardInvoicesIndexRoute - '/dashboard/users/': typeof DashboardUsersIndexRoute -} - -export interface FileRoutesByTo { - '/': typeof IndexRoute - '': typeof PathlessLayoutRouteWithChildren - '/login': typeof LoginRoute - '/route-group': typeof thisFolderIsNotInTheUrlRouteGroupRoute - '/profile': typeof AuthProfileRoute - '/route-a': typeof PathlessLayoutRouteARoute - '/route-b': typeof PathlessLayoutRouteBRoute - '/dashboard': typeof DashboardIndexRoute - '/expensive': typeof ExpensiveIndexRoute - '/dashboard/invoices/$invoiceId': typeof DashboardInvoicesInvoiceIdRoute - '/dashboard/users/user': typeof DashboardUsersUserRoute - '/dashboard/invoices': typeof DashboardInvoicesIndexRoute - '/dashboard/users': typeof DashboardUsersIndexRoute -} - -export interface FileRoutesById { - __root__: typeof rootRoute - '/': typeof IndexRoute - '/dashboard': typeof DashboardRouteRouteWithChildren - '/_auth': typeof AuthRouteWithChildren - '/_pathlessLayout': typeof PathlessLayoutRouteWithChildren - '/login': typeof LoginRoute - '/dashboard/invoices': typeof DashboardInvoicesRouteRouteWithChildren - '/dashboard/users': typeof DashboardUsersRouteRouteWithChildren - '/(this-folder-is-not-in-the-url)/route-group': typeof thisFolderIsNotInTheUrlRouteGroupRoute - '/_auth/profile': typeof AuthProfileRoute - '/_pathlessLayout/route-a': typeof PathlessLayoutRouteARoute - '/_pathlessLayout/route-b': typeof PathlessLayoutRouteBRoute - '/dashboard/': typeof DashboardIndexRoute - '/expensive/': typeof ExpensiveIndexRoute - '/dashboard/invoices/$invoiceId': typeof DashboardInvoicesInvoiceIdRoute - '/dashboard/users/user': typeof DashboardUsersUserRoute - '/dashboard/invoices/': typeof DashboardInvoicesIndexRoute - '/dashboard/users/': typeof DashboardUsersIndexRoute -} - -export interface FileRouteTypes { - fileRoutesByFullPath: FileRoutesByFullPath - fullPaths: - | '/' - | '/dashboard' - | '' - | '/login' - | '/dashboard/invoices' - | '/dashboard/users' - | '/route-group' - | '/profile' - | '/route-a' - | '/route-b' - | '/dashboard/' - | '/expensive' - | '/dashboard/invoices/$invoiceId' - | '/dashboard/users/user' - | '/dashboard/invoices/' - | '/dashboard/users/' - fileRoutesByTo: FileRoutesByTo - to: - | '/' - | '' - | '/login' - | '/route-group' - | '/profile' - | '/route-a' - | '/route-b' - | '/dashboard' - | '/expensive' - | '/dashboard/invoices/$invoiceId' - | '/dashboard/users/user' - | '/dashboard/invoices' - | '/dashboard/users' - id: - | '__root__' - | '/' - | '/dashboard' - | '/_auth' - | '/_pathlessLayout' - | '/login' - | '/dashboard/invoices' - | '/dashboard/users' - | '/(this-folder-is-not-in-the-url)/route-group' - | '/_auth/profile' - | '/_pathlessLayout/route-a' - | '/_pathlessLayout/route-b' - | '/dashboard/' - | '/expensive/' - | '/dashboard/invoices/$invoiceId' - | '/dashboard/users/user' - | '/dashboard/invoices/' - | '/dashboard/users/' - fileRoutesById: FileRoutesById -} - -export interface RootRouteChildren { - IndexRoute: typeof IndexRoute - DashboardRouteRoute: typeof DashboardRouteRouteWithChildren - AuthRoute: typeof AuthRouteWithChildren - PathlessLayoutRoute: typeof PathlessLayoutRouteWithChildren - LoginRoute: typeof LoginRoute - thisFolderIsNotInTheUrlRouteGroupRoute: typeof thisFolderIsNotInTheUrlRouteGroupRoute - ExpensiveIndexRoute: typeof ExpensiveIndexRoute -} - const rootRouteChildren: RootRouteChildren = { IndexRoute: IndexRoute, DashboardRouteRoute: DashboardRouteRouteWithChildren, @@ -462,107 +430,6 @@ const rootRouteChildren: RootRouteChildren = { thisFolderIsNotInTheUrlRouteGroupRoute, ExpensiveIndexRoute: ExpensiveIndexRoute, } - -export const routeTree = rootRoute +export const routeTree = rootRouteImport ._addFileChildren(rootRouteChildren) ._addFileTypes() - -/* ROUTE_MANIFEST_START -{ - "routes": { - "__root__": { - "filePath": "__root.tsx", - "children": [ - "/", - "/dashboard", - "/_auth", - "/_pathlessLayout", - "/login", - "/(this-folder-is-not-in-the-url)/route-group", - "/expensive/" - ] - }, - "/": { - "filePath": "index.tsx" - }, - "/dashboard": { - "filePath": "dashboard.route.tsx", - "children": [ - "/dashboard/invoices", - "/dashboard/users", - "/dashboard/" - ] - }, - "/_auth": { - "filePath": "_auth.tsx", - "children": [ - "/_auth/profile" - ] - }, - "/_pathlessLayout": { - "filePath": "_pathlessLayout.tsx", - "children": [ - "/_pathlessLayout/route-a", - "/_pathlessLayout/route-b" - ] - }, - "/login": { - "filePath": "login.tsx" - }, - "/dashboard/invoices": { - "filePath": "dashboard.invoices.route.tsx", - "parent": "/dashboard", - "children": [ - "/dashboard/invoices/$invoiceId", - "/dashboard/invoices/" - ] - }, - "/dashboard/users": { - "filePath": "dashboard.users.route.tsx", - "parent": "/dashboard", - "children": [ - "/dashboard/users/user", - "/dashboard/users/" - ] - }, - "/(this-folder-is-not-in-the-url)/route-group": { - "filePath": "(this-folder-is-not-in-the-url)/route-group.tsx" - }, - "/_auth/profile": { - "filePath": "_auth.profile.tsx", - "parent": "/_auth" - }, - "/_pathlessLayout/route-a": { - "filePath": "_pathlessLayout.route-a.tsx", - "parent": "/_pathlessLayout" - }, - "/_pathlessLayout/route-b": { - "filePath": "_pathlessLayout.route-b.tsx", - "parent": "/_pathlessLayout" - }, - "/dashboard/": { - "filePath": "dashboard.index.tsx", - "parent": "/dashboard" - }, - "/expensive/": { - "filePath": "expensive/index.tsx" - }, - "/dashboard/invoices/$invoiceId": { - "filePath": "dashboard.invoices.$invoiceId.tsx", - "parent": "/dashboard/invoices" - }, - "/dashboard/users/user": { - "filePath": "dashboard.users.user.tsx", - "parent": "/dashboard/users" - }, - "/dashboard/invoices/": { - "filePath": "dashboard.invoices.index.tsx", - "parent": "/dashboard/invoices" - }, - "/dashboard/users/": { - "filePath": "dashboard.users.index.tsx", - "parent": "/dashboard/users" - } - } -} -ROUTE_MANIFEST_END */ diff --git a/examples/react/kitchen-sink-react-query-file-based/package.json b/examples/react/kitchen-sink-react-query-file-based/package.json index aa5d7a56c0..fb3f68f25d 100644 --- a/examples/react/kitchen-sink-react-query-file-based/package.json +++ b/examples/react/kitchen-sink-react-query-file-based/package.json @@ -12,21 +12,21 @@ "@tailwindcss/vite": "^4.2.2", "@tanstack/react-query": "^5.90.0", "@tanstack/react-query-devtools": "^5.90.0", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/router-plugin": "^1.168.13", "immer": "^10.1.1", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/kitchen-sink-react-query/package.json b/examples/react/kitchen-sink-react-query/package.json index 908768f0a4..22bfdf3284 100644 --- a/examples/react/kitchen-sink-react-query/package.json +++ b/examples/react/kitchen-sink-react-query/package.json @@ -12,20 +12,20 @@ "@tailwindcss/vite": "^4.2.2", "@tanstack/react-query": "^5.90.0", "@tanstack/react-query-devtools": "^5.90.0", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", "immer": "^10.1.1", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/kitchen-sink/package.json b/examples/react/kitchen-sink/package.json index 6730131449..4f5657e0d2 100644 --- a/examples/react/kitchen-sink/package.json +++ b/examples/react/kitchen-sink/package.json @@ -10,20 +10,20 @@ }, "dependencies": { "@tailwindcss/vite": "^4.2.2", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", "immer": "^10.1.1", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/large-file-based/package.json b/examples/react/large-file-based/package.json index 81a3168ad3..5c4491e8a3 100644 --- a/examples/react/large-file-based/package.json +++ b/examples/react/large-file-based/package.json @@ -13,20 +13,20 @@ "dependencies": { "@tailwindcss/vite": "^4.2.2", "@tanstack/react-query": "^5.90.0", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/router-plugin": "^1.168.13", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/location-masking/package.json b/examples/react/location-masking/package.json index c1ad5b7be1..a371129acc 100644 --- a/examples/react/location-masking/package.json +++ b/examples/react/location-masking/package.json @@ -12,8 +12,8 @@ "@radix-ui/react-dialog": "^1.1.6", "@tailwindcss/vite": "^4.2.2", "@tanstack/react-query": "^5.90.0", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", @@ -24,6 +24,6 @@ "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/navigation-blocking/package.json b/examples/react/navigation-blocking/package.json index ad2a2e8ec3..f5eef8eb84 100644 --- a/examples/react/navigation-blocking/package.json +++ b/examples/react/navigation-blocking/package.json @@ -11,8 +11,8 @@ "dependencies": { "@tailwindcss/vite": "^4.2.2", "@tanstack/react-query": "^5.90.0", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", @@ -23,6 +23,6 @@ "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/quickstart-esbuild-file-based/package.json b/examples/react/quickstart-esbuild-file-based/package.json index 6aff4c361d..9e03c227e6 100644 --- a/examples/react/quickstart-esbuild-file-based/package.json +++ b/examples/react/quickstart-esbuild-file-based/package.json @@ -9,13 +9,13 @@ "start": "dev" }, "dependencies": { - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/router-plugin": "^1.168.13", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@types/react": "^19.0.8", diff --git a/examples/react/quickstart-file-based/package.json b/examples/react/quickstart-file-based/package.json index babc6e48a7..019bcbf3ba 100644 --- a/examples/react/quickstart-file-based/package.json +++ b/examples/react/quickstart-file-based/package.json @@ -10,20 +10,20 @@ }, "dependencies": { "@tailwindcss/vite": "^4.2.2", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/router-plugin": "^1.168.13", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/quickstart-rspack-file-based/package.json b/examples/react/quickstart-rspack-file-based/package.json index 477073e180..69d93606e6 100644 --- a/examples/react/quickstart-rspack-file-based/package.json +++ b/examples/react/quickstart-rspack-file-based/package.json @@ -9,17 +9,17 @@ }, "dependencies": { "@tailwindcss/postcss": "^4.2.2", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", "postcss": "^8.5.1", "react": "^19.0.0", "react-dom": "^19.0.0", "tailwindcss": "^4.2.2" }, "devDependencies": { - "@rsbuild/core": "^1.2.4", - "@rsbuild/plugin-react": "^1.1.0", - "@tanstack/router-plugin": "^1.167.12", + "@rsbuild/core": "^2.0.8", + "@rsbuild/plugin-react": "^2.0.0", + "@tanstack/router-plugin": "^1.168.13", "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "typescript": "^6.0.2" diff --git a/examples/react/quickstart-webpack-file-based/package.json b/examples/react/quickstart-webpack-file-based/package.json index 82d5c70147..4a105ad427 100644 --- a/examples/react/quickstart-webpack-file-based/package.json +++ b/examples/react/quickstart-webpack-file-based/package.json @@ -7,21 +7,22 @@ "build": "webpack build && tsc --noEmit" }, "dependencies": { - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", "react": "^19.0.0", "react-dom": "^19.0.0" }, "devDependencies": { - "@swc/core": "^1.10.15", - "@tanstack/router-plugin": "^1.167.12", + "@swc/core": "^1.15.33", + "@tanstack/router-plugin": "^1.168.13", "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "html-webpack-plugin": "^5.6.3", + "react-refresh": "^0.18.0", "swc-loader": "^0.2.6", "typescript": "^6.0.2", "webpack": "^5.97.1", "webpack-cli": "^5.1.4", - "webpack-dev-server": "^5.2.0" + "webpack-dev-server": "^5.2.4" } } diff --git a/examples/react/quickstart-webpack-file-based/webpack.config.js b/examples/react/quickstart-webpack-file-based/webpack.config.js index d83e2bea10..878d2a9735 100644 --- a/examples/react/quickstart-webpack-file-based/webpack.config.js +++ b/examples/react/quickstart-webpack-file-based/webpack.config.js @@ -23,7 +23,11 @@ export default ({ WEBPACK_SERVE }) => ({ template: path.resolve(__dirname, './public/index.html'), filename: 'index.html', }), - tanstackRouter({ target: 'react', autoCodeSplitting: true }), + tanstackRouter({ + target: 'react', + autoCodeSplitting: true, + codeSplittingOptions: { addHmr: Boolean(WEBPACK_SERVE) }, + }), ], module: { rules: [ diff --git a/examples/react/quickstart/package.json b/examples/react/quickstart/package.json index c800c4744a..3adfc42cc1 100644 --- a/examples/react/quickstart/package.json +++ b/examples/react/quickstart/package.json @@ -10,8 +10,8 @@ }, "dependencies": { "@tailwindcss/vite": "^4.2.2", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", "react": "^19.0.0", "react-dom": "^19.0.0", "tailwindcss": "^4.2.2" @@ -21,6 +21,6 @@ "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/router-monorepo-react-query/package.json b/examples/react/router-monorepo-react-query/package.json index 44ff29eb77..cb64bca4eb 100644 --- a/examples/react/router-monorepo-react-query/package.json +++ b/examples/react/router-monorepo-react-query/package.json @@ -12,9 +12,9 @@ "dependencies": { "@tanstack/react-query": "^5.90.0", "@tanstack/react-query-devtools": "^5.90.0", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/router-plugin": "^1.168.13", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1" @@ -25,7 +25,7 @@ "@types/react-dom": "^19.0.3", "typescript": "^6.0.2", "@vitejs/plugin-react": "^6.0.1", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-dts": "^4.5.4" }, "keywords": [], diff --git a/examples/react/router-monorepo-react-query/packages/app/package.json b/examples/react/router-monorepo-react-query/packages/app/package.json index 17338f62bb..f4d7f184f8 100644 --- a/examples/react/router-monorepo-react-query/packages/app/package.json +++ b/examples/react/router-monorepo-react-query/packages/app/package.json @@ -16,13 +16,13 @@ "react-dom": "^19.0.0" }, "devDependencies": { - "@tanstack/react-router-devtools": "^1.166.11", + "@tanstack/react-router-devtools": "^1.167.0", "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-dts": "^4.5.4", "@tailwindcss/vite": "^4.2.2" }, diff --git a/examples/react/router-monorepo-react-query/packages/post-feature/package.json b/examples/react/router-monorepo-react-query/packages/post-feature/package.json index 13a04ca811..9618fe3814 100644 --- a/examples/react/router-monorepo-react-query/packages/post-feature/package.json +++ b/examples/react/router-monorepo-react-query/packages/post-feature/package.json @@ -19,7 +19,7 @@ "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-dts": "^4.5.4" } } diff --git a/examples/react/router-monorepo-react-query/packages/post-query/package.json b/examples/react/router-monorepo-react-query/packages/post-query/package.json index 976f63750d..98833ff2dd 100644 --- a/examples/react/router-monorepo-react-query/packages/post-query/package.json +++ b/examples/react/router-monorepo-react-query/packages/post-query/package.json @@ -10,11 +10,11 @@ "dependencies": { "@tanstack/react-query": "^5.90.0", "redaxios": "^0.5.1", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/router-monorepo-react-query/packages/router/package.json b/examples/react/router-monorepo-react-query/packages/router/package.json index cc40d7130e..ac27ffa037 100644 --- a/examples/react/router-monorepo-react-query/packages/router/package.json +++ b/examples/react/router-monorepo-react-query/packages/router/package.json @@ -8,22 +8,22 @@ "main": "./dist/index.js", "types": "./dist/index.d.ts", "dependencies": { - "@tanstack/history": "^1.161.6", - "@tanstack/react-query": "^5.90.0", - "@tanstack/react-router": "^1.168.10", - "@tanstack/router-plugin": "^1.167.12", "@router-mono-react-query/post-query": "workspace:*", - "redaxios": "^0.5.1", - "zod": "^3.24.2", + "@tanstack/history": "^1.162.0", + "@tanstack/react-query": "^5.90.0", + "@tanstack/react-router": "^1.170.10", + "@tanstack/router-plugin": "^1.168.13", "react": "^19.0.0", - "react-dom": "^19.0.0" + "react-dom": "^19.0.0", + "redaxios": "^0.5.1", + "zod": "^4.4.3" }, "devDependencies": { "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-dts": "^4.5.4" } } diff --git a/examples/react/router-monorepo-simple-lazy/package.json b/examples/react/router-monorepo-simple-lazy/package.json index 67f4995b79..1c612359ba 100644 --- a/examples/react/router-monorepo-simple-lazy/package.json +++ b/examples/react/router-monorepo-simple-lazy/package.json @@ -8,9 +8,9 @@ "dev": "pnpm router build && pnpm post-feature build && pnpm app dev" }, "dependencies": { - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/router-plugin": "^1.168.13", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1" @@ -21,7 +21,7 @@ "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-dts": "^4.5.4" }, "keywords": [], diff --git a/examples/react/router-monorepo-simple-lazy/packages/app/package.json b/examples/react/router-monorepo-simple-lazy/packages/app/package.json index 0820496d40..a729b79fc9 100644 --- a/examples/react/router-monorepo-simple-lazy/packages/app/package.json +++ b/examples/react/router-monorepo-simple-lazy/packages/app/package.json @@ -15,13 +15,13 @@ "react-dom": "^19.0.0" }, "devDependencies": { - "@tanstack/react-router-devtools": "^1.166.11", + "@tanstack/react-router-devtools": "^1.167.0", "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-dts": "^4.5.4", "@tailwindcss/vite": "^4.2.2" }, diff --git a/examples/react/router-monorepo-simple-lazy/packages/post-feature/package.json b/examples/react/router-monorepo-simple-lazy/packages/post-feature/package.json index 4bbd045eeb..d2bd3c4cdf 100644 --- a/examples/react/router-monorepo-simple-lazy/packages/post-feature/package.json +++ b/examples/react/router-monorepo-simple-lazy/packages/post-feature/package.json @@ -26,7 +26,7 @@ "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-dts": "^4.5.4" } } diff --git a/examples/react/router-monorepo-simple-lazy/packages/router/package.json b/examples/react/router-monorepo-simple-lazy/packages/router/package.json index d46cc9738a..c0e6050be9 100644 --- a/examples/react/router-monorepo-simple-lazy/packages/router/package.json +++ b/examples/react/router-monorepo-simple-lazy/packages/router/package.json @@ -8,20 +8,20 @@ "main": "./dist/index.js", "types": "./dist/index.d.ts", "dependencies": { - "@tanstack/history": "^1.161.6", - "@tanstack/react-router": "^1.168.10", - "@tanstack/router-plugin": "^1.167.12", - "redaxios": "^0.5.1", - "zod": "^3.24.2", + "@tanstack/history": "^1.162.0", + "@tanstack/react-router": "^1.170.10", + "@tanstack/router-plugin": "^1.168.13", "react": "^19.0.0", - "react-dom": "^19.0.0" + "react-dom": "^19.0.0", + "redaxios": "^0.5.1", + "zod": "^4.4.3" }, "devDependencies": { "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-dts": "^4.5.4" } } diff --git a/examples/react/router-monorepo-simple/package.json b/examples/react/router-monorepo-simple/package.json index 145bc1ef01..0f1fc901b5 100644 --- a/examples/react/router-monorepo-simple/package.json +++ b/examples/react/router-monorepo-simple/package.json @@ -8,9 +8,9 @@ "dev": "pnpm router build && pnpm post-feature build && pnpm app dev" }, "dependencies": { - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/router-plugin": "^1.168.13", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1" @@ -21,7 +21,7 @@ "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-dts": "^4.5.4" }, "keywords": [], diff --git a/examples/react/router-monorepo-simple/packages/app/package.json b/examples/react/router-monorepo-simple/packages/app/package.json index fd2cc2777d..3e2b86f6db 100644 --- a/examples/react/router-monorepo-simple/packages/app/package.json +++ b/examples/react/router-monorepo-simple/packages/app/package.json @@ -15,13 +15,13 @@ "react-dom": "^19.0.0" }, "devDependencies": { - "@tanstack/react-router-devtools": "^1.166.11", + "@tanstack/react-router-devtools": "^1.167.0", "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-dts": "^4.5.4", "@tailwindcss/vite": "^4.2.2" }, diff --git a/examples/react/router-monorepo-simple/packages/post-feature/package.json b/examples/react/router-monorepo-simple/packages/post-feature/package.json index 6823f49b07..9bdf4683c2 100644 --- a/examples/react/router-monorepo-simple/packages/post-feature/package.json +++ b/examples/react/router-monorepo-simple/packages/post-feature/package.json @@ -17,7 +17,7 @@ "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-dts": "^4.5.4" } } diff --git a/examples/react/router-monorepo-simple/packages/router/package.json b/examples/react/router-monorepo-simple/packages/router/package.json index a53713ac5e..cf6e59797f 100644 --- a/examples/react/router-monorepo-simple/packages/router/package.json +++ b/examples/react/router-monorepo-simple/packages/router/package.json @@ -8,20 +8,20 @@ "main": "./dist/index.js", "types": "./dist/index.d.ts", "dependencies": { - "@tanstack/history": "^1.161.6", - "@tanstack/react-router": "^1.168.10", - "@tanstack/router-plugin": "^1.167.12", - "redaxios": "^0.5.1", - "zod": "^3.24.2", + "@tanstack/history": "^1.162.0", + "@tanstack/react-router": "^1.170.10", + "@tanstack/router-plugin": "^1.168.13", "react": "^19.0.0", - "react-dom": "^19.0.0" + "react-dom": "^19.0.0", + "redaxios": "^0.5.1", + "zod": "^4.4.3" }, "devDependencies": { "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-dts": "^4.5.4" } } diff --git a/examples/react/scroll-restoration/package.json b/examples/react/scroll-restoration/package.json index 0e807da3db..240d75e0f1 100644 --- a/examples/react/scroll-restoration/package.json +++ b/examples/react/scroll-restoration/package.json @@ -10,8 +10,8 @@ }, "dependencies": { "@tailwindcss/vite": "^4.2.2", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", "@tanstack/react-virtual": "^3.13.0", "react": "^19.0.0", "react-dom": "^19.0.0", @@ -22,6 +22,6 @@ "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/search-validator-adapters/package.json b/examples/react/search-validator-adapters/package.json index 95087c5a87..5800fbb060 100644 --- a/examples/react/search-validator-adapters/package.json +++ b/examples/react/search-validator-adapters/package.json @@ -4,20 +4,20 @@ "type": "module", "scripts": { "dev": "vite --port 3000", - "build": "vite build && tsc --noEmit", + "build": "vite build && NODE_OPTIONS=--max-old-space-size=4096 tsc --noEmit", "preview": "vite preview", "start": "vite", "test:unit": "vitest" }, "dependencies": { "@tailwindcss/vite": "^4.2.2", - "@tanstack/arktype-adapter": "^1.166.9", + "@tanstack/arktype-adapter": "^1.167.0", "@tanstack/react-query": "^5.90.0", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/router-plugin": "^1.167.12", - "@tanstack/valibot-adapter": "^1.166.9", - "@tanstack/zod-adapter": "^1.166.9", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/router-plugin": "^1.168.13", + "@tanstack/valibot-adapter": "^1.167.0", + "@tanstack/zod-adapter": "^1.167.0", "arktype": "^2.1.7", "react": "^19.0.0", "react-dom": "^19.0.0", @@ -32,6 +32,6 @@ "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/search-validator-adapters/src/routeTree.gen.ts b/examples/react/search-validator-adapters/src/routeTree.gen.ts index c3d792c411..4a973e1b29 100644 --- a/examples/react/search-validator-adapters/src/routeTree.gen.ts +++ b/examples/react/search-validator-adapters/src/routeTree.gen.ts @@ -8,8 +8,6 @@ // You should NOT make any changes in this file as it will be overwritten. // Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. -import type { CreateFileRoute, FileRoutesByPath } from '@tanstack/react-router' - import { Route as rootRouteImport } from './routes/__root' import { Route as IndexRouteImport } from './routes/index' import { Route as UsersZodIndexRouteImport } from './routes/users/zod.index' @@ -104,43 +102,6 @@ declare module '@tanstack/react-router' { } } -declare module './routes/index' { - const createFileRoute: CreateFileRoute< - '/', - FileRoutesByPath['/']['parentRoute'], - FileRoutesByPath['/']['id'], - FileRoutesByPath['/']['path'], - FileRoutesByPath['/']['fullPath'] - > -} -declare module './routes/users/arktype.index' { - const createFileRoute: CreateFileRoute< - '/users/arktype/', - FileRoutesByPath['/users/arktype/']['parentRoute'], - FileRoutesByPath['/users/arktype/']['id'], - FileRoutesByPath['/users/arktype/']['path'], - FileRoutesByPath['/users/arktype/']['fullPath'] - > -} -declare module './routes/users/valibot.index' { - const createFileRoute: CreateFileRoute< - '/users/valibot/', - FileRoutesByPath['/users/valibot/']['parentRoute'], - FileRoutesByPath['/users/valibot/']['id'], - FileRoutesByPath['/users/valibot/']['path'], - FileRoutesByPath['/users/valibot/']['fullPath'] - > -} -declare module './routes/users/zod.index' { - const createFileRoute: CreateFileRoute< - '/users/zod/', - FileRoutesByPath['/users/zod/']['parentRoute'], - FileRoutesByPath['/users/zod/']['id'], - FileRoutesByPath['/users/zod/']['path'], - FileRoutesByPath['/users/zod/']['fullPath'] - > -} - const rootRouteChildren: RootRouteChildren = { IndexRoute: IndexRoute, UsersArktypeIndexRoute: UsersArktypeIndexRoute, diff --git a/examples/react/search-validator-adapters/src/routes/index.tsx b/examples/react/search-validator-adapters/src/routes/index.tsx index e279d9c1e0..d0eff7e9f3 100644 --- a/examples/react/search-validator-adapters/src/routes/index.tsx +++ b/examples/react/search-validator-adapters/src/routes/index.tsx @@ -1,3 +1,4 @@ +import { createFileRoute } from '@tanstack/react-router' import * as React from 'react' import { Header } from '../components/Header' @@ -12,6 +13,6 @@ export const Index: React.FunctionComponent = () => { ) } -export const Route = createFileRoute({ +export const Route = createFileRoute('/')({ component: Index, }) diff --git a/examples/react/search-validator-adapters/src/routes/users/arktype.index.tsx b/examples/react/search-validator-adapters/src/routes/users/arktype.index.tsx index 38af594c85..702db7a5d5 100644 --- a/examples/react/search-validator-adapters/src/routes/users/arktype.index.tsx +++ b/examples/react/search-validator-adapters/src/routes/users/arktype.index.tsx @@ -1,5 +1,5 @@ import * as React from 'react' -import { useNavigate } from '@tanstack/react-router' +import { useNavigate, createFileRoute } from '@tanstack/react-router' import { type } from 'arktype' import { Header } from '../../components/Header' import { Users, usersQueryOptions } from '../../components/Users' @@ -32,7 +32,7 @@ const search = type({ search: 'string = ""', }) -export const Route = createFileRoute({ +export const Route = createFileRoute('/users/arktype/')({ validateSearch: search, loaderDeps: (opt) => ({ search: opt.search }), loader: (opt) => { diff --git a/examples/react/search-validator-adapters/src/routes/users/valibot.index.tsx b/examples/react/search-validator-adapters/src/routes/users/valibot.index.tsx index 1a8bc7dd18..8ed997e722 100644 --- a/examples/react/search-validator-adapters/src/routes/users/valibot.index.tsx +++ b/examples/react/search-validator-adapters/src/routes/users/valibot.index.tsx @@ -1,5 +1,5 @@ import * as React from 'react' -import { useNavigate } from '@tanstack/react-router' +import { useNavigate, createFileRoute } from '@tanstack/react-router' import * as v from 'valibot' import { Header } from '../../components/Header' import { Users, usersQueryOptions } from '../../components/Users' @@ -26,7 +26,7 @@ const Valibot = () => { ) } -export const Route = createFileRoute({ +export const Route = createFileRoute('/users/valibot/')({ validateSearch: v.object({ search: v.fallback(v.optional(v.string(), ''), ''), }), diff --git a/examples/react/search-validator-adapters/src/routes/users/zod.index.tsx b/examples/react/search-validator-adapters/src/routes/users/zod.index.tsx index 8f095d156f..526509c8d8 100644 --- a/examples/react/search-validator-adapters/src/routes/users/zod.index.tsx +++ b/examples/react/search-validator-adapters/src/routes/users/zod.index.tsx @@ -1,5 +1,5 @@ import * as React from 'react' -import { useNavigate } from '@tanstack/react-router' +import { useNavigate, createFileRoute } from '@tanstack/react-router' import { fallback, zodValidator } from '@tanstack/zod-adapter' import { z } from 'zod' import { Header } from '../../components/Header' @@ -7,6 +7,11 @@ import { Users, usersQueryOptions } from '../../components/Users' import { Content } from '../../components/Content' import { Search } from '../../components/Search' +const fallbackString = fallback as unknown as ( + schema: z.ZodString, + fallback: string, +) => z.ZodType + const Zod = () => { const search = Route.useSearch({ select: (search) => search.search ?? '', @@ -29,10 +34,10 @@ const Zod = () => { ) } -export const Route = createFileRoute({ +export const Route = createFileRoute('/users/zod/')({ validateSearch: zodValidator( z.object({ - search: fallback(z.string().optional(), undefined), + search: fallbackString(z.string(), '').default(''), }), ), loaderDeps: (opt) => ({ search: opt.search }), diff --git a/examples/react/search-validator-adapters/vite.config.ts b/examples/react/search-validator-adapters/vite.config.ts index f4a9fa4f26..5b41e6e26b 100644 --- a/examples/react/search-validator-adapters/vite.config.ts +++ b/examples/react/search-validator-adapters/vite.config.ts @@ -17,7 +17,6 @@ export default defineConfig({ tanstackRouter({ target: 'react', autoCodeSplitting: true, - verboseFileRoutes: false, }), react(), ], diff --git a/examples/react/start-bare/package.json b/examples/react/start-bare/package.json index d1eded97ea..f7d6abce99 100644 --- a/examples/react/start-bare/package.json +++ b/examples/react/start-bare/package.json @@ -10,12 +10,12 @@ "start": "pnpx srvx --prod -s ../client dist/server/server.js" }, "dependencies": { - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/react-start": "^1.167.16", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/react-start": "^1.168.18", "react": "^19.0.0", "react-dom": "^19.0.0", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@types/node": "^22.5.4", @@ -23,6 +23,6 @@ "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/start-basic-auth/package.json b/examples/react/start-basic-auth/package.json index da7b6c3616..0b128f9c2d 100644 --- a/examples/react/start-basic-auth/package.json +++ b/examples/react/start-basic-auth/package.json @@ -14,13 +14,13 @@ "@libsql/client": "^0.15.15", "@prisma/adapter-libsql": "^7.0.0", "@prisma/client": "^7.0.0", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/react-start": "^1.167.16", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/react-start": "^1.168.18", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", - "tailwind-merge": "^2.6.0" + "tailwind-merge": "^3.6.0" }, "devDependencies": { "@tailwindcss/vite": "^4.2.2", @@ -32,6 +32,6 @@ "prisma": "^7.0.0", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/start-basic-authjs/package.json b/examples/react/start-basic-authjs/package.json index 8618bb36a4..d163098545 100644 --- a/examples/react/start-basic-authjs/package.json +++ b/examples/react/start-basic-authjs/package.json @@ -11,22 +11,22 @@ }, "dependencies": { "@auth/core": "^0.41.1", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/react-start": "^1.167.16", - "start-authjs": "^1.0.0", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/react-start": "^1.168.18", "react": "^19.0.0", "react-dom": "^19.0.0", - "tailwind-merge": "^2.6.0" + "start-authjs": "^1.0.0", + "tailwind-merge": "^3.6.0" }, "devDependencies": { "@tailwindcss/vite": "^4.2.2", "@types/node": "^22.5.4", "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", + "@vitejs/plugin-react": "^6.0.1", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", - "@vitejs/plugin-react": "^6.0.1" + "vite": "^8.0.14" } } diff --git a/examples/react/start-basic-cloudflare/package.json b/examples/react/start-basic-cloudflare/package.json index 6ba516f679..e88aa77205 100644 --- a/examples/react/start-basic-cloudflare/package.json +++ b/examples/react/start-basic-cloudflare/package.json @@ -12,9 +12,9 @@ "postinstall": "npm run cf-typegen" }, "dependencies": { - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/react-start": "^1.167.16", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/react-start": "^1.168.18", "react": "^19.0.0", "react-dom": "^19.0.0" }, @@ -27,7 +27,7 @@ "@vitejs/plugin-react": "^6.0.1", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "wrangler": "^4.74.0" } } diff --git a/examples/react/start-basic-react-query/package.json b/examples/react/start-basic-react-query/package.json index 9cd113c562..0bf87e12c9 100644 --- a/examples/react/start-basic-react-query/package.json +++ b/examples/react/start-basic-react-query/package.json @@ -12,14 +12,14 @@ "dependencies": { "@tanstack/react-query": "^5.90.0", "@tanstack/react-query-devtools": "^5.90.0", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/react-router-ssr-query": "^1.166.10", - "@tanstack/react-start": "^1.167.16", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/react-router-ssr-query": "^1.167.1", + "@tanstack/react-start": "^1.168.18", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", - "tailwind-merge": "^2.6.0" + "tailwind-merge": "^3.6.0" }, "devDependencies": { "@tailwindcss/vite": "^4.2.2", @@ -29,6 +29,6 @@ "@vitejs/plugin-react": "^6.0.1", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/start-basic-react-query/src/routes/deferred.tsx b/examples/react/start-basic-react-query/src/routes/deferred.tsx index 0380f79aca..11af82ed27 100644 --- a/examples/react/start-basic-react-query/src/routes/deferred.tsx +++ b/examples/react/start-basic-react-query/src/routes/deferred.tsx @@ -1,6 +1,5 @@ import { createFileRoute } from '@tanstack/react-router' import { queryOptions, useSuspenseQuery } from '@tanstack/react-query' -import {} from '@tanstack/react-router' import { Suspense, useState } from 'react' const deferredQueryOptions = () => diff --git a/examples/react/start-basic-rsc/.prettierignore b/examples/react/start-basic-rsc/.prettierignore deleted file mode 100644 index 2be5eaa6ec..0000000000 --- a/examples/react/start-basic-rsc/.prettierignore +++ /dev/null @@ -1,4 +0,0 @@ -**/build -**/public -pnpm-lock.yaml -routeTree.gen.ts \ No newline at end of file diff --git a/examples/react/start-basic-rsc/package.json b/examples/react/start-basic-rsc/package.json deleted file mode 100644 index b083ad70f1..0000000000 --- a/examples/react/start-basic-rsc/package.json +++ /dev/null @@ -1,34 +0,0 @@ -{ - "name": "tanstack-start-example-basic-rsc", - "private": true, - "sideEffects": false, - "type": "module", - "scripts": { - "dev": "vite dev", - "build": "exit 0; vite build", - "start": "pnpx srvx --prod -s ../client dist/server/server.js" - }, - "dependencies": { - "@babel/plugin-syntax-typescript": "^7.25.9", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/react-start": "^1.167.16", - "react": "^19.0.0", - "react-dom": "^19.0.0", - "redaxios": "^0.5.1", - "tailwind-merge": "^2.6.0" - }, - "devDependencies": { - "@types/react": "^19.0.8", - "@types/react-dom": "^19.0.3", - "@vitejs/plugin-react": "^6.0.1", - "tailwindcss": "^4.2.2", - "typescript": "^6.0.2", - "vite": "^8.0.0", - "@tailwindcss/vite": "^4.2.2" - }, - "overrides": { - "react": "0.0.0-experimental-035a41c4e-20230704", - "react-dom": "0.0.0-experimental-035a41c4e-20230704" - } -} diff --git a/examples/react/start-basic-rsc/public/android-chrome-192x192.png b/examples/react/start-basic-rsc/public/android-chrome-192x192.png deleted file mode 100644 index 09c8324f8c6781bc90fcf5dd38e0702bd5f171f3..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 29964 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 b=FG diff --git a/examples/react/start-basic-rsc/public/android-chrome-512x512.png b/examples/react/start-basic-rsc/public/android-chrome-512x512.png deleted file mode 100644 index 11d626ea3d00fddd52861bf0af5554a92fc30d69..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 109271 zcmXt9Ra6{Jw;kLqxDzxG++BhN2@b&_xDF89U4sOd!GgO58Qk6785rDxyIsD2t@~8{ z)LnJz$lm*$j#N>S#Xu!N1pojTa$lv?007wcM_2$d;`?&#G57esz&NYPegRZXkR1X5 zQ~)_C2@Ma!lXfJqxpX}L#(p6RJNwvgXFLrR)jW7Q6ly9HTE@MIgQ}K;Bi5(cmsVTM z&s8`$DyldtE~@b#X~sTL$xm>hbB$q#4YRGkEf%-7l$VuH9y&wX@7C`&njwROZQf6F zhhAb`3Mt6O=L$imWgWgsDKSd?)C;&(jO_i4DtU}W{H`|Fwx}+@VJX4R z<8JM<#r_J6u5GooLn^(U7jHKJ`+{1$)%|*0V{})m6LNjnPI!X0Z~;tJ?fZ4ViB4jj zrhmcv|9G5#APwtwmKBMA3q(e+LCUp=$$%x#>q@`lYdlqrK}%Arw%eI*;Jq9W{4$sA zpEKMD5kPS3*hweD!?$zuhB- z-5&YeM+sc5b@WscW4`6aX0FlDk>f+XgXI>sPu;5=V=MOG!l#RKubQ3FH8I0-Vd<3> zf4P}x{qziUcYr52eu)NpBje$v^q>q46#=N3iT`OJ=QF$(|4ZFnCI{x38>v27Xi|0l ztS_diZfv8P>jo%V@LF7=SKG`vqkL=|nOlzR{fx2wPrNXEc~h&0WK?)_S!<%$yoThc zv!hM#jX^Ka2qV9!%PjA|%@xg8I9X@FQu-U8J75&vj^y8jmFF;==MGKaHz&7YQ2S?g z3@*c6F=e|Ki}Rop!7;j9+6_DS>D%cNH977Bwhe$@=4)f1E2eO#uF43dnxaP7?FqJj zg6DZf>4knZMP0Oi{`*WqXvK7iOrWwb_>~VMnLHIFXcpoeTrRPE&G||m&A~ImD}ptd zJL?TkP*u^Cd_j+KHv1&ld8SyMmFR70h-~R^IoZFL7^No)cdVGSC6kF2&D8@pJB%*j zQD=Dx`QR8Vuop%)Es=>;qz(&Ax6!`{H7FuCiU~fN=0TtrefL~rX!Va630Q;)KjU?d ze4ShWQgpVaE;)~Qc3Q;p5up%V_nmK*A({xIT2PBRq^;s)aADU7NzC`R#j4rriZ9__ zcHaUczXodf^5Zy_?+f=cp0i<9kxnEXxta|*A9y0$D8`ig_U>ukW9)CpQEUtxtE9`$ zJe=_1J&GkKDo9B?(!q`S70}&hdazTu>X8moieO8DW~j)M(z?uj)G( zS><^i6O&*Y;MnB|-I(%RC)#8nkK_wj610aCC6WrOL9p%{o@`>c4j3WIqg?xcK0WuN z1r&@G?@pWDpWW+hodaZg?Tm6KB&0vOz*Ka3Vmop<6AI$3Jj9~#iNLt@1$LFy03S4% zG1g2y&w@<^>9&fJGHws*U!5^W!;15K=J}OHQRgtbcJyW$L#N#dxF0D&e}U{;^83V@ zjm_OkuubzHm^Iw= z%$j?3{NJ;i)PFCP(r;iC-B)JQZ_+chx)!B4Oe8nc3ss6*kutSaRL3UUK84kwvJ^br z0{U!3v@WzElW6p{?gI!o8&w_&1>pyXNIw=@!+xr8PCmm~^AR$Jz)ZQEPqTlUJB_+N zIYc^2>LMF^;wXfIA8I+7&#daP_$2FMw-z8*ZIkwVFRzTO89a};(f=8@o4}4q`Hl;# zx_11?Gj>r8p}5$32#B~@&&#>9)`4gmc<`kZ5Iv5;L!`y3dD7lZCx$6XGBmrP=@>lX zoryLWO=E9RPs*p@AFs3>qxaXvgd1T^v~_k&w_3?unkUe)n%EVVWkDnJsM9(>j_<(P zG(KB}ejIu~@2aYuHX|BO8NM5b@fhpR2!fUN*xaYn{#THf#T-1(xfbwjekIYFTBS-{ zVd0dxRdfZIU>p`U*5;@K{*&GSJ^D9rvE$D#gmgE%0qDonzGX$eKJ}LSRVR5Rcc*>U ztG}}MzqCFayD7%%c>$ypTVhV%HiUy74lu>A;vU*QF>|fZUz6)I#stiM;ATc5oh4p# zY@x;Hn}wzkKurZ*G5K0pf*sU$N>i1f1m|6pucpNqvDt!Z`lf<7pHzeZxIdDMy2!+w zChK&#ipM=zzfVVezNl>GPoPQNUb?ssBB4rmnfbMz@vExqCSxV&I)&klWe6U_buYK1uN3d|l$V&0oq;GvkSc;bGE34-B0wUk_7ICD+D{Pa0s zAB6nbKf^BW2^ao;F5okj9Rd)+*?}%gHx?w$pcq@%oci+5xce{wmSPj!jE(|@@i6)* zw$-C@9F8bln)Emp``5-mxRl4xo%%bMfqT_xLFW8Eh3CIt@}+U{Odb^6m&T*E8|MUu zBum~I{jfmHQ4a#{2NhmQiVZ@|`_%3-r+gnn^L6%9c03LzQ#1~fU0O}gfC|!}tRCg1 zk9{kPlUoWo8&3Ig%JK**H1n?i)z&J#gkiovZ)el{h@>$xovrr+*@^C!eFmp#i&GN> zxe8918{>S2p19;Lq=pmoh(W*Vh{=i_aG3Ku?dOGfH$EA4v0;wnd`w*@G8@3Fh|gF zV9-cy(+iC|oRr7TARN^Hmx!-ZJ`=b{s9^h)A0CR%0wo=h)!xL$0;3{M!ktrKiVZ;g zyu&Arpbps~d6`e8KXbic>@-i|GEFR)cx?|3fo4lS#bRF?030wU|-a$KILQU z0l8!Xr>g?Xj-;_RZ46t_m&qrpS<1t`!TWSeSalbS*AV-tFKaG})(Hd)7JvQ*&N&SE zSBH`Q^*K=X`58!NARGTPhScDLGQ)AK>vYSF=wD!OT&KtAe4?iNoQG@nd(N8j%upWT z^V_Q3$Fwe)K2G@UyzpD^GucCuc+Wmme}s}*z>hbue^`f=8_A|2QROPduMQd}oYLhD zIAaRb2tm?q0J;IcRqF{k{^C)S-*JGtk_ejXoc+mJ^2&M%>>C}Id#L;Rc>^<|TZve`p7UbASI^{EBT|pMBJb4|{wT4wOwv z!Dv1+Kek}SZRm!~#c!dYyyV{PUyd}})PO4vGQLlRe;+*cH9iG0g5p}yOAx@CVf~K5 z5ANG7-)z>B9_I&}R(EdH^=Rgo_$1%aoK={O`h7YZo6n*69O>%WXnyX< zvadbcgpm~_#26t~NjfGV-1P=1mIFS8Kv@($3T)f-~&SO{D zcvKgaL|Fj9UE_8^fh1es-XWmIQWqXwI$Ub<=tnh@0UAsQPL)A6=2;Q@5qn z2epG*@aT^dmt6e+Q`Q~KjvA+5!s^~ z;gh64Q*|_KVwRyR>7f87Vh7>A7pj^b7iMI`EYLW==SO+x?97JK%_sL zBtC%g6GPL{dGP_ZlvY=ndaeFAj7`c>*u+y78mLr3x>xMONPQLfpm59^3%)UHm(6ZC zJrVmR*RM&FCG~zOU#Vy3NL?n{JbnMVui6foUphZoju-4^Q2F(IGu0n5Pi{r~u>?UT z;HU+2Que}{qFp&zuKTRum)h8-PPfs4$@oqt16C+$fPMOdj)}k%oF4Bw-@rw9Z;l-Z zk$<2PP=Pv7$xieG7I-z2mI8YLqgY4Y$yE3NDA&_bjQ_n2-^>Q^J3s6`jK9upEL`+& z@)0??ntV>zndZY=c=5Q3nD7;5gWDcieQ)vrgj)GhK%*by!UDbNZ}yT#>3o@(kRpb% z2#c1fzRde!KIKp0J-;0PN@->%|LlPm*Ww~XkM-|jPjD;r!jDlJLp_5pvHc{Ws-2Ae z+YKzYn2oR_SK5!YF}g2H;wl+4EGVy}1wWn}x-Fzyof0<*x9C~C&=JRSntYj{ofi8v zB6nNLKnugd7_n!|EWkeYQYUG9`s0T8ndWhk!xxnkT3`({6UmD-_$XM}ZhJ5JltJH5 zg(>DHU|8`#GBZ}LhtuR>(~DJVx27_vndUu|^I#_1 z>wT;mZq8-W{WWS$NtD%Xz#e)o&w9(vYU9{_R%0VX@1G68YD{@WFSFRzb;zDn!OSFMBfeg%7Qg^<)r+z#IX9f^*imL5(?|M>)w_%6* ze9LmvA0HYxeUv;&a>kIt2TAA$#(NVsck&tNfMJ;9(3I-v%C7x(^q%0fQsJpG*UvpH zDH)u0Si`ODAwT;e*E!8~Sx|id} z0Qd%h!?1UBUZ6K)64LQNZXVf)qtA1DS$n zKzBfrd$D8r2xN)a7qYB3gAOQo#YKe;J`s=K?jj44aj1U$#}W6Gw>Z>N2)*qH)#EK( zwvo+ctoybU{?6cfSPdE?-_CHA+eB zZsH#eo;Bg|!8%}4JJIhHr50@ncakwqUlGLvvtX7r-}|m6{H3*AsgJejjpezKK^v{1!k{p7iT@oF7%) z78M#)TQ*;6Kd!BuO_q8X>R*N#;luqzX%v?x{-4cI>a|PNvlgwcMeh5cA7|&#`7*kj z_B`o;1NY<3?jTaBpSN}i3P{Ii529?MKQKuTZeI|&JM;$#KJ=_*;(lp|`)hgf3p0yV z_UhuBi*C4{5>^OYNU(>fz|Dz;N7EMl^stX5_2Va?m4PWZQn+ivji8zo7;N^ymD`ZT z0F~R^b=$OPLHWXf+$u+VzH{8+nw0VPgt9;=SDQ*(X`^vXz|;AchSDTV>cCdWg1VPJf&SKDHYWm9+m z?lbj;6f;iPcdXvUw+R{9xyXI;KNe!XoeuCCbNnTJ9Qy<$z0%sbpn>RjwxjQ7 z5JZaS&^)Y!vo^NEUp?`ZR(ec7jbaHpuL>SYJk@Jr0%u)Ro@y-2Qmw;`aw0UfZ*CvO zu1|bnhO7HU zq5V~J{Go^U*mPYoYGWN$8$jdHnPrshDZK~B0LK(xix2KbTMYui7;X<}xdv6Nru=fy zkbQd{cR2>&;~F}5xzFe8QI1A)>T@Qswt}jSat+(>rJx?k1IOCVeKYp4O{%goBJHWE zU#e-tZZ;>>-z7Fd<*StT+G#5@F~gQ2Pbiq}QQK(7zNW=qRMaWxb`C`A6{AP8)e@s* zny&md#l$n$`A5=+xdt$#N4ddz;<`)3GviI2@|v0gpL!6m?U;KseEjQpGUR{y;E=ic zQBWaTIB85+EX~?3zjO&Uf@DkN)V?~N>NJs>uonBrpMT;|9Qvn|_h&8E9B0!w7dYlu zIf0soNu9Q+TVd9E=}1dG1;UhV)iK8ltZPdC9#5Pp=>85dhZMtxRo8z89=W>z$KCC^ zuU**mAGNg)2FrGxUl8P(w^@A63Y?+lAgyN5%% zWAy94%j7+~`;GiyK1MuEdSS#A3XM7rTO4`wwgbnD|BZZbTpRepkoyGQ-eVgZE5zTM zWd;_Dv`K!LjF%|Y19*4?zAI82-=v7UUdG+wGJ1Km?Q3^J)Hd@9;|xoa1T%1H*IKq+ zCtf2XPFi3%nFW-IRymV8_j%?Fukgl8$riMooHt@h2xs9748RXIy?YCl0&AbfZP!M2 zzr|VMXJw?Wt5cL601iT9?O}{vXfc>Gv1@w$a>xr}OOtQ=a>XRi@ z_?8}VtWGyd=Rg!2k~h2y84X=B?O%KO)CY~=Nj+niCFJBfN3n(@;F}Qe_v|`n1?D&PL%;(9oz7-z%QUFOdKqor zIJJCkVh!u#n7UnbcvFPrRu*f*MI2D(FgzD^LdDa1WO{Qyq4HmVN$!t0G~W-0{}hS( zoc5=Zt=fin{JW#Ko4U#laI{z2#Z#T&O$Za_az?nw_d?sSIa`ntl7rOQ^a6HTX@KV= zoB5MeEM@zB6R8Prg$KsM%4Qv2yHd9)6T**``wG`qgFB$^$GPN+$2U4VHTFG285KBw z$(M?wwuExIu+tJ*Lquu4ws9TM-jo|v#P}1i10}^0aRqgY#*^ziplIl1D8*Eg2Pmlu zUWjyh0jJmEZ-PgIU)Pq{ZMEAx!mA7FMY?jfJ>{NTU)*0wUV&ZGY9D3@{BfA&;uQ(r z<*pb)phu-{EpR&qbd?ukcq?5Ou#4^95q&N3cDWNhEiuz4O3&NAqaFRIRaR1 zQ*uE$^v^S#ed(to9q6vhzx{ogSC1^Kp;&+JTV*;h-bkY~ z1FYPEi8d{FoMk6wrf+5QIU2QzE1qOAb$fjJI((kw`!|VW%a*`0e69&iORwTKM(IQR zZF@%;Iv&_;IT(06cjtZ4T1uZ46Qe)fDPkb0O?<@A+xw-$uBRc8>qS(!+th=f#@4Bt ztA&_PDSSA9^jrZ4SbL4J@#$#5H6JV|Oer{@@b8ct*niZd?>4TR?efOjpZxaW>C0p1 z&@!~MFgm6bk2n0}x0gaLX@${y9q4A#Z+Y$xYgQx3D*I9#l}T;PusGEI8T-1+fO$;F z{q8ImvW~6g6bE52z(4x2%nMHW_0vOZs-NR4O4pJN_|KhYsJXoqgJW=_lR6CFUk4zY zIijcy9afDi&2jiiN1p>L5OdG;A*r}TVUJ~0@7SYGXU)(ZQZ=+qSY@;0aWvg~i__M= z|3X=YKRSSCpZIkGsqJxU1%=4rO8s3S0>h??I^D&Vb)NnBu4uX2y}p_afy9~;GDp7p zxr@VO=Q|0kRRWE7`QTT)wq^eVoqjGY5B)d z{G9dTwywf|iU^BH;va*K=T|y;ooJZ3n|*?y;`eoTBE7Nk$B`Z2`;l6@woTjZKQ zHye=tu=rItF{h^>?DI$h3hI^<=KlbEu*b+pGII}36i`p+a>KnDrdczVRh&0PrR z1euw%eXo|H@y1a@JPHwh?b%u|*ffTeM!y~S#T3MQL7S2s&^f(9a$ZUbf$@~|qM~;g zggmv`kbEtE8=ZMvVvB!vWZj?P4Zg5yhkUyZoszo5f3HXlp=3`7D=W@=^Ne{>k;Lt;`JXi)^kZ~F zl+=PWxpUrIM?bn#WR>7Af%QqA{fpw&?9$BBOS3S1qrx*v_ zIV<$g`Lt)m-9W$jq!?tmpA5&~!eYdMrETqd+4N)q^19{D!GBj!4#;YMIZu*j4JLUk z<14SPb_M>7zuS#=qy0K~OWF#T_Iqh-LNlykBjF0u@GCKMP5P2=7mVs}B5W-;rtN{n zkBt`+uw_~mAna(KzrZecX}M1(Z_AHOp$wthmzaD{SQI`#8~fbAI%@#>J%?;=$0E{7 z>kn8|!u-I&jdpKGwW)_J{+V#3KY%F#PK2Y>ev%!jygSL?z2R9_Td}lq619tqO5*!t zKeAvB0F~9+evo(_-bdN|XZvu`8uu7J_lwvY-v#PgYr`#|wDCDkCx1W7zg@ z=n|o>G@~pR1)VcQ_d@)rLBbf2<=6{VU^J03!Ip*RJpJ_7fsg47Xii)U7<;P(%MJXd z&2Y;IWLCJWEkN-F)3c4<=fr}2)W>IAqySkM%^NE1SUi3o!gCSKXU? z8$2Q=^4$NQ1$g&Xo9i;+M|b7*_D||Ir2e(29cBnGt6`{1o0qA(rxx8Rrn_5+8O7`T z1s+>DQ+2#=ApLt2I^v|N@vQ`R=*1LuiV&u@wW&7kXRT7*qUE z8IM2s$GobJ&caDt%)1Ugjq@Kqjlc!A5rxfR8(lQ#&yN*TsF%r3zj;kV9w8a?_wMKD z&sA?>95Y-Z^5a5Vf(?F;7O!=5G|}I--Np&u>kO>ue0 z8OkqmfZaiD{Jv=yW59*95^V6*Q{q3jGhm7msH(-V{iOD;fCDL-#AF$!4nkW`>@Fo) z&A39cd9Hum-3VWxbH##2PD8Fmh@_>rc|F|#_gkr4p62a*Y`v&C?!~y{meDz4VS4#l zc+`@0yqnU$Hu{10>s9{M%kQuKgs=j{X3ntMk8gh7U$U{X2?tpG7dmor!CMM?>{;u#eiUYFUljA3CKY~bllSK(RJpLTgfnxI9{RW_$MJ$?tXrz z6cyNhtX0-Kxe@ozfY2OZq6CP&f9NdiB+eAe^dQ_CE<0}A&xGmNZuE20KDf(G0Og$`xqA7rhy@{1>D*y3RlRqo}F;&+(#aRH{&4pK-9N zvp2M8yqfEFAc4Qjqc+%t8UB~Z9vLRaC>cXRamH#GDLhk3#(D^d&!VRVe+ng&PSziW z&k}5kUI|!hNMz6k_S~>t9DI>6lLb14l*dI;Gf#7$6I`SvWw3%;6;- zOjoY9V`dyfeC5U>P}h5W8u0UTl4zbAV8&Wg@KSm5dA*L)W@j=78fwN$=a5Qm>2gxl z%AWRxdaGt`jB+0}wVMNTW z0`+lN&M4Y?S=DvdOQqHqv-zkbdH?jKk=JN8^NfY&nu zKYsJHZqFC~UE2Hh=fe0d;%f%#6Rr;$)%fD4d4FgCZ&y`Tz+MXV06}FiZ|FyZmkOTO zgwsYBn0BR|^!rR|j`tJBQbt(@22RqX5N+z zF&2IBwDhhEs6Q`GNNdGXL^cI`<|7baTy$g1M!J2Ja{tt|?rjc+$y%$7&gvi6g>^?Q zm<0!dD#wb6qyc*j* z?BU2=>^il(gELgS)4!8l3DA^P&Z&cbS=5-}??8fhd$mn|WPf0e1-blDLIvt`De|m= z!xZ)Tv>l++7p@f5u8H?TMbi)3cpI7n-va17L!}lFh%wBn6x~|knu6bMsWXC7mteN5 zngHO4pCZURj6tD;Uk{(s1e1&vj;I>x0_F?CU3J|GT1rq{MGGlQ$pfNB{a>PlL{k}W zsxJnkdU~SRXzuPceNz*_^p`$kqW6&54&qF zk1yj6J5hlmk8dx94As7&z0cx}y*1XUXLQ6p%n0WxN6Kap_xeI8ZrV?fHEa2P@?3r^ z`mff4Gx)08wp(Kc4q6Q^vU&Q!L90#a{lo$pgPfPpVIWhnH4{!paG4F;uhJS}H8AID z8-7Di!vwr_oGsXJ@MC70LM~7)vmQ) zJ+9Q_uPbs;9!vNN%GY|EpPn+8z3S$h~`V0B5$#$J4>)|MY@I6E5L>}A`kg|~& zRzg@kWZE8RQ(23>!jmE5XoJSCv)iOjk@%#5rE%1ji~)}q_G&s8xHT|bKE+R!;^4aF z&rSc{LM@Dr!z7%eKWzLBYybFHQukWDHXwKh0Vi|_Ikt*!Ic93*m{7tE&2jauvAw+1 zWEiFd@dtHuRTJC?teM*(L92G1+MIC(>$Uu_D>EG0cXOEwB8)ksNUr6 zt00loaPxj)57B^BP2MTCEEkN#y|Zjv7@!?yNSMGrO2+S5@eJk9PQ5jG$1=st{rn*fW+XVYCsgeVF=Xue67Y-u8-|Fs7<`3Jf`V-|NK>eky& zlYUK|+!FKoA6xLxkuMBKTyfF&=?Fd0s9c3|OYCS6u`H^SIFy5x81zOyU6??8RU5TSDj?YPaJzjVLZyDn1ZI<%1| z^X)AFw{7m=c5?-gK;yjwPvp=IMd13YW5Y8km@ba3XLjvS6k?qD-Q_;pMTmHgXUgR& zm|U^+)5zf4wWufRs1a>ntMg17arGg`NVOpFJhQWjd>rZghaRq9>cT#(`T@6-Bb-IP zKti4?m-p$OBzen)PE)`l&6T`P(?yrPVx4WJvyc-P6cGWzZFil{I2tMQc}Sosb)zw^ zV!gmcBzn#jP8<6+`Y)v(tEbN|D7dOF+*EzjV|jvPmzC zpR$mXMEMU>>m}l53&+Hb_eR~l&ewqBg)yTIQ@_hq{Ou@G^)JvCo=ClqSjL9*`#16) zfGd?Gq#d-vA)j+0(`R#Gw1nH9)9Ngms6|1GPo|dyiE$S9LNcUsZUZPy24_zJ84Z_O ze;>^e2|Nm{(5Mh4AG05eolMgO+0X-f_a-Fb;ouynxR$4HG<$pkZIA*~cN#UXnjxg- zM;0D}tRL5JMhgZoy!c%RhxIr~GtI3~x>#Xntmk#awku?D4G z>W`$^{AHyyxSUu)$)&9z2S~*UX_0Q9%`RsP|KlXbvxY__N^$Ibp>iB!VRnxXcc7;= zpxxobcJuR5x=*0MEl6WQJQR2)@9LIa8*zmD;N;VuXt0gwLt})xTWU}b{2=yY#n~%v zutiQ--0KI`KI&{94LDu8CXhYZfR*O3?pKQ&_s3SljV}}t7typ1=3a-=XtykUu^u5w zFq?Xa9zM(s*|?1>C=-{Zhu;-C%`lGYnejzqff)wwm5lHt%)8$KS^= zVXEOdG|pAv>|F-ExjCMm29(r@GGJFVDh~(kn%Zr^_69wO@4oi+kE>LWI_0MuLl!W~ z<^;wA2g@!4xKN?(=Z>T~uDsIG zYjai2^|EcZ-+Z#|v~&w2V?q)~8e^2j5_3h8J<1P7H^o_?f~%nW1#SaeZqnoGkse7B z_KZd1Tr;!&@|0>(jn%%`l~4R%?2hho%r(Z}q!CLHmqe8?{L#DyLcT~PyeF-h$k_&b zaQ|-GU*Rcc;E(-byz%*UaG=XK__dJ-p{mqd-5UP~6DJ3FA;1DkWaI1ZwCahyG~<08 z^Oxzr=1a*UpPvndV8$67Mp8_Bo?q|g{SgL*hA_LunlXz|4bY4QL1zmb&xJ`vFIdbvM7pg&Lz~q# zuG?JIgQ2vKcU(v~A&VK1>-N=&>K@076d;742!AEUQNc9LtK?)1R&2+X#8FTk@rxr9 zfDuO_cn({#E)#-L7ldYvgrLj zzp|DAp9BY@aAc!S1cuz^aF+#Y2M6okzGyv72-jCbg>4gmR)?Js>-aW0sMZ9Wp={DH z=xQIlCDCV(4QO~sE8kJey?)1e7hPk6me~WE2{W!;~+xD!bT2W zNWop9|12Igxh0v|5pX-`(~*jI)1Q;{C7(8bDBJax0pdeu5j}8YW$Txrv9C}A(DLo1 z@+f}yj;9jc|M3q9F54~z3Cd3@2^vZK;7>}&>6T6Q8JM|PdlFWcM&B9$f>$UCtx(A5 zuZ%MEdaXp#+U9A$uH6nWXS}g-$jkp_oZ8-Wa+l}XpKV_<_}6s4(Nw}ZPgIDGJm6_z zT$2(w#dKPZeulEs^J00}3yxcj676HAli&74Qeu=p_1Jgh{d}&hq9=V#wVOJ(~ zZLSo2IV))9sUvzE%8i6g>khu2t{b0iVrU9C)FCRjcB_TA z$>jM}^3o1<(Vzs(u6A4CrTtC9)K5ib;hGTL#DNvwn~BDC!DacHo-G;5O4#>}av+ zrM?pNl+bd+YD?B5_ZwKX;Jnq;md|P7Jw4g`?C;uKdA^-ui1I!@Lqz1)-w4|G%v(aj zI|DQ&#|`c~Z6=^-d9j?3k97TI?7@ouLYj8M`pQ zaU$>3tqfh)GgnFCOK-0V`0|!6`^^xH#`<YrbR?3sCx1*rOx{Q) zR9N0GcnDyK&B9~YIf2g(L3&jROAZ2w2m~a-j^UFcy}mMm5%fL_^mIJtp;q{KIu^Ew zGoY_#F~L>m@TftLZyz1V*5uO_f?S8w`LJahB9Qoj-AiiO*T<)+YgZ_H`4@&wz+U@S zXGjrZirClL$Bc+CA)IN8^}_cZcuoP$%mBtMfH3%9 z*#BA*LtgGvXMs;2IC@cBt`hLnK5mcyAm08|XlD&F{O%Nkj!h(d#qV%Dx)-eb`q(@V zZtz++yo-@ch;}VU^4&c5SCu{W6t>0I>`MFxuP_8>x+{nL(zaDS0Fj}HrlYx(S<&JP z2PNVseCDY6I;eDRoYuw@ygKHuU)^|r!O)8=YH@BlA#V2E>(HD%BiHp!c-`1(^iOr}o^VJQBuA;hxDi!_c#P?aic4@29^% zMr6yL3MaD>yBS`GzYUywC3{H;0d99>|JJpdaw!4KV8F(M(H3I?@`$=K`Ad;qijg^k zn8<{L6@TL~F>Hv{vJ(dm&b;26OXc%4>lXET0y%PL0O7hk__%FcaYMd&V%au!x&o}a152^c2Z92VInYAc0$O!_!%OCd?VV3zUC zyF$0!Pjhs~b^viUH2SxitrkAdkMBp9SVn`lW5^aVo=a})04oLp30;nzt z9;2Qlb&FhgL2RWM)t$l>3vtAkOfsEa#6(#fdMrLK)fhMG*B|15r!A+BSAXU`!C;1D zbSxpHdB{=+gD!vd33%85i~U_QkXUPC-qB<2;?j*0`^64Avpc}fY;r}!?Dv5A z?{mPUi-Ozm`eX4i-tPzx%O%^ePt4JiM2=ihLlE{MHpZYsm@L64kgM6|Ojg-(m=h@( zg+}$8R{yaE!cFpxnN6?`SEYm8>VCIwEP7mtt1Xlm5Hq=JX=v&r*$2l>lqU?h4N_#R z1AfS2sw5Q@TESCpbX-UG&U3D<|KSLf{=CJ@nb+tK`H>yX-x7DSjMVQVJ>Bv84YzXg zHAet5F3ZnAV zA9LC@@Y(QHzuT?X%ng>l67F0Z`20;uxq7D{17ry{(P7|-Fq5G|NP#!fg^#4XAk&Q@ zeQ$?ebvv{5(6opcA0|hE+(b>R_waOu+JnkRmov!kZoWq|ewaqd*CBN{;FL`O_OfX| z*g1u5Mg6U!^L~>)_kiXvyTS=-8t}y<*&$Yrv~1m(kh9UHv9pw)i=zTp+d&twL@#wg z9c9FT?pke^frdGM(+NfV_BpOLHGAJtC#Q~Bb7>C(D&DHECIyydev4z?g#u2YI`o+c z9_E9}6N+60E&zh6&f5!Sb-iGiVYGOUMN+e9GMwL+P{aj+saj|4XDzWR_msI;%P!o^+v!#7o z;L+hRhHd^ywg8#H#o{ChZawrcIrQxLRA+JOgGM88q6T^f+8o|n99QZbcBKilB;0Bo zZ#A+m3KKz?D`7CQ`V*+EGR!s)-$xc=SV-Z&KQDiC5I&`v1Z$8`mfG0-2W7BvgjZb0 z1*^V~fc_T!M-;tu-KUm)=dG(xpw#pk=!wUypdY6%eHL8JeX}Qsx2V+o6+PJ_GlPVo zF%KM+CWx7m=us%9AZg-QG=;oKfZTL108_KVz%K`Qgy~LzXNH*w>5G}=`*NnS7W2$l`Og}OhF zyYL@oAzyD|WZNEDgWLBfRt|IA zMVQj(%2eND(rc}-Bt6C-UXHMN*2M6Q%ybb(^NJd0d93gy%)V(?!XQ(8&OSAeOe5cD z?DtWS3aP=<(2g?zai5Nb@2-HcnuI2%2{THoCZg#AfzDiib7EeBKFr=cX*}G)_x>XN z+b7!i$e|DZmYQph@;Otj!Ql2sTdTMxJBg_?XFdq6-58O#;gG+rq1WTEB^u;DtLgRY zDZBe1G9+fQ#mQGti{iJr&9l?$QC9fy@#yT$P@3%Iqiv{h4(W!8Wy3SMSVe(?Nu8eb z#W-3)v?iqL!_bvvXbi zsnoz}ROgGX@0GGqWeG;|OqkelKhlPHte!ww}CkFZJ46<3{(ox`3xqlb7;7_2V1 zImbu#P#}kg(*TV3{sM+uIlDj2;;a%Is{@r{Sc0ZgJ|_L72;t~z%9)@d@DHiN;o!>S zt%c2Dr_t$e;Cu`I`)H(`X=kV#AVbdm*q{t=^mmG&a$+-{wz;(*1M`Uo6b z3d!xfk%HD9aaSct<`nykMeTmWQ#sk1F=P9dEEY)4Pjuw1@dOCkGKlmlFF8E;TY^?zD~=#URCbv#xbRQE8K!} zzgvUEgy}Yz#OVHQxxa@{ibi3Ce>X9O%8f!el{4HO>9Cz?B~*Sg5Ih^knE_uCe|&s! z;Y1$o-J=~x>PtEEJ6Ero0cJVdojzT2aRKkMRt{v1@>T(lcXbh+vZa~~ZAO&>_b~$8 z<*=9jO(yH-j~e~<1JKd=3ZxDSPLVjT2Z$h=3Z9N>#0Ft<=;!NRv!$^iLD-hi#!XKR z%3qrgZ6mJ(Xj-vPQ6~*HZY{ir8}W%fFjm~J95r?xks^IT-$_`{3eZ&k;hAFQ-esyE zZ1sf2R-mJuO(stwSG{6yiI-dl1^H0~!mo!BNI(XLYd^qRCl(v;ufC1rlNYV$Nc z+*m(3rh>X@7t6s!k7jBSILJGf5ITywe-R${8d+gZT)A2cOv^D5W}N(WW%l=&Aa%X= z(hL;{YQKt@f|*i>$^xFe=IW~Vnj#tCmzGQ#wA?N1Moa0TLSw%`*v4(Ws~w*%B&o6Z-p3-56G+&ZQiS(EIe$aPG*}c%w?U zM*qh#YtIpgRKY|7Xoz>8-7d`Whh^>cVR5#Hi}hA+xoBB6H5(KrP&5QXZ#WU1Al(z; zl~s=q2Lk^(P)u>zd|{tX?fH4Y{?<|~_mQG`5pL?>2-@!4Q7zNBJnVCZ%Gr$8`5PY9I(>Nmqr=WB{HuN)gq;^;#+Io3q8v_NL7Y-TX|YqHIN|7uoKRC#g)>_^Sz z5~bk!FfDl&ulq;f+2R zaOOt`+YLqWf}oFsIr8~%LoWG%v3K&hGT7OP6T2Q@LOTFY4gc{6O`0HoqNp^XE1|H20s7tUwiKk0OG8g9VD#^#wVpyqiJG;)kz zaU&+b6$bD2y3nW*oRY?RvU%L%G{NuY^5n7d^P)DuP%X42@$uu08+Tl=UgFHfb=;h5 z)8&D{DsEYkEMt>=;P0~&)iDzl#|iBKJTv@9rvY=-OTpIKX<-73WRgqf1CFF{DNuWGBZn6p|B{;zAro&kWjby+nT_x!mnR{bws75! z{Ms>UWOO7+9=F_nb2WYXG!o`uqsoJw!T^Vq+IwDH^w458GNP|qi+`^9r#~9wnZ%R6 z#vpVmU3(={h$^j{-7EtWNMXd+&BJPP-B6$um$&xghWXnHF`|>j%`QBy=is#FjySAt zGq@30NjxB2(1ctXNiWU51~~yGyEu+6`XAZ}h-Cph(y}r!USaWx0_wfSg(M}lkDumI zzJxOt=+rF$j+4$8-W0Vb>i@a)JRO-u$UvfLtDwPv?(%~}5NcwNYp{y7K6KJ54c zx0B_TfUvDUcIcu-r-;o!e%voMAN{?5f0yEB1;WWER-PiA?3bu&1Fnp9C+C`6w|Vzn ztN!DP|4cIeJMXc5u9)yU4ZRJ;Y1%iIcf|2Gb{9Mm9=>;B;e38@`nT1to9`kh$_P(d zp3mRV3{TqU@=1|3@P9k!LDCLwST`dNGJhknju@HnIUo$-Nsy%?*%ffZ#&1lzBxT(K zW0|IxoSrDaZR2^bDlP`}OF;QmHwG%YDi{o6lGH^8VKKr(V&BK+%6Pl!DRIXjVNMg( z37C)$z>1OI>#CMs=UO_+EZeZcmW3;I%vD^mbNACqDn9FNOncxin{=GuHlp!zgAd7) z@;PGZo2s~ZIvx6zqmyKQ*B9>S3~s(Qs4s*2Gha%HM~Z_Q%qe>BfBo9xLgDNF`48sI zJFhEo{DBHX#LZ6Tc(jNoWozM`HYjj%!Q#=E^d3Gpv4FV7Ehp0`~{I>5JQ(uuM`FLV3D#C*I(`;I6 z`5PRopn#th#`7o}yS&ZNsS~&r$u5`w@m#lA%{l;@h|s~BN5|YJiKX=U_fm=;I|s1v zlF=?o*Yhk0cQ_;`A+}vmWvrg(iK>TP;@b7jz=U%ER*qgN)%=7;7oRj?iGiY)yQ0yx zOo)}2gHe>GV!#3=Z=bCK3$_TI+_eBV4y($10L7RAs{*T8+>ZU$8`X2`%EOf1U%X4Y zK#Ey^C{dS+=4dhA{dYcG+Wz&1f4X6-Du6ixey#X@YPgVIFj58)q<#l6QZN{sCs(yMSXVD@w%L6e-zGJv0 z=z(_ORz)vuIIqciwW2F55^#^MdD*kgYy+fAd3N8TnCIc<|W06VL4@LQ?D2nZokO|Fg73e3<>{zF`;>%(VYB<8J`z9jtH5F zW^fbe)H2*`a~z|D+lSjhUw(C|$UlGY-GZul!~FczhXLgR2m24dBjB9?_fkPw+;jT_ zrE_Z6fTLe*|6IMF`MJfDP#0<{hSQtK*-j}ig(oP9~ zHx8Uq=Otw*1bR#)Ct$)j0F6eYXKmxk5s?oPyfyb6N%5kpU&Ii>_8^L8uyGLEWin<; z*_MJw#*7bpeyBV7fOk8{yP>mg=vg=MH3 zPbqcRU++&AGYV+Ivx(uxdo%#cf&IIJ+? z-x#*EnB3Cwc@;4-rU#!7f0usG>+5F?SL;HTPjL>?z_7gBdtXQmm=pztP8R1Fgh~Yl@0(V(zLz-b?rwk^It*PKOo)g zy4gt9WfPptG$(Jac(6=%rQ<%%Fj(Oha5F<%A-e^-L@HKFl-+3;y+vgsYt`UkpH!pU zA84nGED$-afsZ*b3u$o&eb;~QxvF>36{T_`1`NfwSr^uh3N_Mn4xoptIBZ4Fa7P96 z0Dg0o_hE;lz!}J1KQXofCWHg9uJJocYLpg~9ZavjqiZXk>9KZ#IJHHl00x@0aQ-e5 zIbx%3X5vo;MC7lPxM53WUq>C~hFbdEGIia9x2T^jxLhrImNu-}W6RytoA*9J9kA2O z)Z7hbM{x7Xrqj6X|E1TIDzO(G@O<7W$81Mn`IL^+xuu0OrFJ`sp3QWXa?6)KQ`+vg zbh6_#;F_~8Q8NZ+#NUp$iBQ$K=OwRMo8bY@lW@AHS=seEAyM8)w?Q+TR^cYYDmalh zv{p^~-s{aJL~s+K{r})8mnzja&7CSrqBVB3QP48&s&dCU$`EBvKvh0YP_b1(wq*Pm z=QRt=(tHA8FFE5H7R zLVTY8(%saw=>z!~cLj534)qO{^Qvu2>IZzl7+2?}PWu5y3H?>-1M;8mv>( zV-GG?Pc3=6I*}&O6EECyclD#wzk*sJa4ni3Z^F8H>s6*%t?VHg@uwU3yCqm4yRy8& z&5d+ESPux#J8lZ)%`dHFd5ZK(Lk)cCIDhRhMEy7ez_I~@r)VdDy(gd(%qYHY16QA* zRAUTV)!GS=KGD<-s~>2!JQTgR)$dA#m%X98w*tD_0a!nJ#p6n;t$F2XzRod!fZOsS zj}31N$8<`O9N9U*e4Gpx>8BD8Qp64GBCP8etgG+6QJwvp&nL2G`-a{6&sWf{ZH!KV zNJ!p$$-3?L<>Kh&Wryw+-EJX)h0~+BN3I=_ucO}|xb3EYD80u&)jsn-c7^SzX;0KN z$=|r+BjJIV-;4>(qrnu}1sx$dd!3Tqf|y|7zh0}98u6+An9=7Bz^Q2eevG&cTrJ3v zlueMBUUvy>ReUSyb8ekd=am8r>-8clI2KrDZ5C&5RB+iy*Qt)~b^u1Mz|A?`9(ryM z*bUo?q$eo{Q0a9&!7Jjn-yoy`u+Pa zRGZA4J%)AT-j|`!z9q(AKeg{GUu++yVSytp5p34J8U3cmFSz!Oj?lNSzfbk`_oA+V zp1Y*x7bC-?YG}~!jMI+V8l*^l!l~&8Hn@^LtL2Zwumk8c=f%?CA zs>;@_2=@40s-HUo@Hf-~UGU) z&;Ez+?QW)vVNGNhH_t&)|6gyoQwzP~>aKR12kQq`AfZC6ZhzHa1bW|pZk2jIXXUz)F{tM+$w zAJBBkSXX|XE<{Za-Se1Qx@cL;NW9@jGga2pW9JisCAQw~Bhh#cJp+A+fQNYsSnrnw zE$5V4y>fNzYJ;Znyyc^pv(pqPV*yT8&fcg^ApDJaKsYKF$S#a;Qg$7Ug_ALaFjZtX z1vforWJC>o`a~1)Yc-=g#%rUF|6>*Z?l=8Cb`WOFQiE^2$jMNUSt*jO0^A1XozOHN zq^Y+@w*+6Fx#Ra1pq%qo1H(&La zmf*VaoQ+u61Kk}dR)VkT>?O8Uf{mnJ0oPE%UWajrRK9JncFp>h;HiPYdcqo(Zw z-BNi&PN2Wnfu0I2(q@miyNxFJu8`dR8W zWMEpq8kjy{Zm=M>(Eiad>Q5VvwX4>t(b3iwz-_KP$qrFeaaIg{17Upxc~)?sEXvUvAv& z+z$F25V?7cU3lU;(7`I$XW>48-0-958#0=woqxS`Sfp$(D zRvB*R-THHN?oAh_@>S_LZR}^xni+3KR1$9TE$N}bVYRvihU3<=E+?lX$-b^#H^?pO zb=&W2x^g=HIrKIA=RXE@l-{Q?>fW-})61S!f1iJEDg9yt^nB-Rt_vOIkLy3+JVulI z!Tbnuf!hwkJcDzQ*s;JyPr{ct8@}-oE+*vH^gjF4b4q7H#`5{U_nfch&X^s@u9Lxv zvTGC+Y}eQpdN3v;`o^CC$;LHfS6PTds zSFDS7a0*4r5@12#VuA6%bAb87vnA^uz1 zD5Bdw{-hU*+Cw%x*YyLZ_`>hzy{H2RXw zwwj|}xQ}W3%N>?LM>HDh+AIFt+=P`>Ai%Hcrwdu;|i!s>&{qci=rI8k$Lkd_2O}&VViggslJ}Gcfd_pQ}dyfb(Kw zdWmou(kHFJZQ#1G>mpUf31~_hC+I^B_4@2B>Q~(``>t^S)~~yan8YGSj%JZ)q==oc z{NFhJg(%Kp_!K>j$KZ@`S;ogJ(fE9v@^OmSjQ#3$KU6=xJuHl?!XR7kppRvNB^Eqt z6Zq5Y2@kTtg9)-!7H$}ndn3*4%aVmpR++vVd+UcUv-KOsIRXDn|9`)46f318Uw3d& zyvrx?r%P{WYF>H^W$u=9EQz_vl=7Mdp*nh;uZd02s4UMY#Cq9_3n$`*{9(8CfxiRO ziRml>YW7sb?wjqbE;#usE|DS0F8R*x-Bgx0;W_WJf@FmBOw}d8=$t2W!b5)7V8l z`IolJo>h~<7#Dr9(<{O6_*fQ(#pWZdv8@Gz<7hH&`+igJxi$Cc?dw%r@3=+0tl26K zz!lR6-<}xMM+i)x8zZQ!!V1qCDkD!|u>I|5k3X`cGIF<`c`2%LHjnGM?^i;rquy{R zO&Or5SmS%uCD&J;i+*66o#Zp`PP1Wq99kVWOxH~4|8xT%Lw~bR>&U5(n`-6I)1x-r zcmuV;hUS7EQdd#|1Fo;>G|^wUP|}9M;5<8-v}2xltVzdCuc>g7Dp}q@PLbSk9W26v zAOO=XqD%PFxub}Tk3iOYuD(L`Ui<^PBK&Ay*&e_CeS=wQ@T?z;JRj46aLmPTCxP?t z^-TdQ((F)7=Z>yZ{WqLkeuOHBx)_r}CIF9PI>cuh*|X9!k_;4$lMFO|KV~FpUIo5< zp*R-3SE-@wEy`R}GLE0_Z~)d`N=O{UH}33nc#jJ%_6iEWm~qe7nH@>S-^E~Y=N8sW z8V}z|?*Ts3M1RvoXR3#vUewgm>ol}Z^}7$52zcBSQND+t8y0EnO)_R^mb{1zjx+kX z@K8e62n?&L8G(yW{f63k&UOUF{r)HJENN%x$deBCTL#WxDD}`?kE#3r{%~blZ@;VQ z;EA0j3CNn&>pFTjz_b|yYO}58qV>1g0#f=OF0fR57{@K-4$s>SwfK>xmFYSE%u6jj z{mC7Cn#QND4d|F2z%Ndfw<1^^Mw#rw`}^N3@S`SM%;@u4fZiT8^qETtP0DZ+MV;40 zvF%TOvWC;Sh}OLioTqvgk1acyf; z)p)NNe`hA`8@a&Qqrihl5h=U_C&5VpRGx12iU%0Q6Uaxm1{Td3;q$^ahaD8B!o2q_ zFl0px+S}W!cHCoI-zv7qGsT$;hL@Xp;C98{ZgID{le%fbp-c+Kbu$SoqF)bb7ra8n{FILtUCH#zizNH zyiPo@<#wB?foVRVApB@dj58B{TP)1!LPtU<2PxW9dHmrem5+wb|B&ALY>n)CIrNN- zSsLUGq}pT4GF28y=ph2xLs>6*7kJ>kCmGOOi^k6QqwRsA&t7UffxzP)NKx+rs+Z(v z%xe3SCXP-ftrOKt@SI1{^gGfFhd zv%s3oL{KvkoM^~S9$zP5+#P_y)y4sEOzYB7{#%!N#>HvCkwll(MZg%Yhp5lK>LcnqxBN`~V8JhTBG%o%YyX4G#~ig%2#Q{A@Qpu)}WK+MWbv0l0n(O}~}FvhX*5 zkV1R({%V=58{c=a>hJAC#j1#Mf$W-had`_IZm%vxU1CI)!g8G=k-?Or04&#j%ci0F zzIKl4x%W;`UfvPlSpeh^4E~pn_{~<2+gT9xlEE7Ej$1^g_i$DQ)2R|}2|9P+#y2a~ zXwl6-RWH&kGrncNw@WZv@ZKry01U3a#2rfY(KxrPoXS>|$$4B@VJznKJDCSCEO`WV zOa;qsw-xeP=YkZ*ARM=K!|T-{-#NJwTfX3>ySee)S>`I440MHowm}WnB=ROeaCFvy zh?xv1wB+be+Ty)#4eQ=J9!kdlh+Pg;w?A>Wda9rW@^Pmf>ESh$y5gd%lHpJGf!pr9 zmC{9wQ2b|3dBm{B+!b;^7*P)Fk^2^vZk6CSYA0ZzSC_+=$u8zSYiphCOT6c0(3^Ya zg`#)TJ`LrvOXZ-U`rprv>;lQyiGZQcp064+H$>r{Y(0!Y_Zc@SUGL=`U`ToiUvQPC zmpE>GZTfF~xu;*9>wP1xj(uuyAzD=0oO%=Ckj))z16xwcj4}R0BHUkn<=n=At$K z0o#%j61-UmQ_McRVV1)pN1~bB8?xI3v4~PN)LnnMKSh+1#+>lhqjHbccw-sLwX zJ=3W{J-t0jcL|)k`6lF*I2r3*S8L=(8~J?%t5>eAWLV2^+T{g1bLH}=LY+3QF z2p9E_07dfPU5}Pc!To;IdoNb~eSK~_DNsgleb`Et!HO zhtE7mjqawere>e2xK-703Ai;wr~Vt>pzIM9gAn&UWM3pK=+MvVnt+ro0q&P^qrrVv zAT{@o;Cm^S5e<=j0RP5e$GDv@c<5VNL03xMr~0#VT6VE=vi#xYtMpJS1`n?MrQW2a zo5>ikTRcliXGmDb6L?J-betg2D%2`&Bs|Ufp1BaFIalVAZfT&bpkfudal}f zhb>5fR5X}F`n+h(Xk!}l5b0dV1*ZU5;8e%f%_es5zWsisy9$o=bK)6Ct80JzXZ6go z7VK44oXi&6Zk8K(@q?5HWP%_v#RZjKuY{Krak%; z1~U24eGgV6Z~sUlZi3Y$1_N8NNXMy|UgE`+Ezr6BH=SJl_P`>JsJbPP%v}>_V0Oy* z)B=o424LN)OOEVmH2&!93X5dRmJJ&$4g*KEsYZ{FONHU>qHnd@46J>>O_fI({`&Wq z9EuLH7_X~dnE|&8~GneGQmAa%Vtl)G7o-1m7jBhxMEmpVT7SnP0c0g&@ zjS4KOvjNaTI2O5k<>LXjDsq?J$$Z6VwgaOn=}svt0?&APJ1RR>b$s7)TpWPG=YCax44t^dBS ze2KTTr3Yz=Nil{TUo9)UR^2fG03ZNKL_t(Kpq!g=#sl>?U}a&HPB;XHPDE(s>?EFh zW~I9S&gw_?DyW#`q5T7W>Ul3hMlr~@V2P%5H31>COGZ-eHsC4UeeVS6SSEz0tb>zK z(eH}BvW8lDexqI z6)&(KtL&1>JE)1lPOYUxitGmUGogI(1(*!DVI2DI{-VmBxwSH%6+WQjfS3`D1tu&( zk~E?6qd|UP;1sl3FZKW8jixVw#>3Vn3>}9~(=hz1;+Cyl zs`_sKP%Ffc!f3vucl=87Yu9;@sng@uLjG7qqpK6+JZ<%-qn@3(f|38+SGI(oCM=c+BX*;MI1 z4fzKtRo-#Y{f;^)`lG1U5kN;7-J4=j5jQeuYTg|&TT}}ldO|(3EbYEleXa4H`|eIp z{0T&g`O4tPXb14_+wNDxL*-7u*0VNOm!I-2=6p0EyZJn&c$?{xXy*^&@g>X$U*XNY z{&wmmj3>n{TYjJF`_rfC zOsOHQG!M?-DPttXQ8X{i&ca+fodrlG*I4wUdv@^Ii@&9^>;plHM@o^z(koaaI>toP z!#(L!QZL{HU|8rmmkq1}3tNCDaohL1rU6csk5;ya9=pFQ>$hq$8&5D z?a@}iIk`~1Dn3~eBd@V_v{fcK+J=5}dMV4)?Kk}+iDrB4zlX1T;P!?&I=*$T0gdY& z?!5J$q^pK+e)msRU)D?aLt;*7%Vn351nVH~)5jb##ODNB2lZ0VJ-=1Ge?8wDf5-s9 z(L{^a(D6SH8$`ewi`;=7olxiY-GrO~B>PcDE7Pg)`;hGi14N04PT)Sa`3YEPnX%4#BMgOJ&s!Aqx2oYcBS0v^Ogn%zT=j zOxAQdV@2NyZ4Fw3+g-~ZRByZNQEqRPyA>- zVTD^dq<^4az4*WvkS+5#3xf5w{|9Rh!o+PF1BBg&Sm3(gy1$j;_p(D@WIYHE1!om- z4Fu&XUq|xS>uu+}lDFkfK+&g6p2~iY$y=GODWg)A_X>5;Irxe&U`lh96*-zJN^#&e_~B1o*@?;4hR2U zG%v~GhAQ~d>@;QjOgB%alqWmp01Q6;GfyIY>zT_U`{E*Zw|eeu+Tm!diH`jDkot7r zyG20-XTHKMk1E`IaWsqat{7G@9|;zZiraykQtE*3pR7h2x|w$M&(Uvsg?&hfF04ln zryW9DVz^V^>i3WN_f~&-{X{7RbeF!Dy!?gnam4c?k`oOT@HPO6*zxU+mY)p^n{}Rl z&FzKr-S?F*b`}bYV*ZfxQ_MfGxZvEwf@{m2jX%HRBGn6>0@OQFaVplr4EtyX0rT!nBX3pkggC8^gHZw4E{KeGnwOHr2H5&lywj3>Bii46e z2AnY9=^}|pfhUdO-?5;tQ(1tHH~{OPzW9roYJ9AWR%O2vSrtliiq|QA*1F1jWAA7M z4DPrBAA(UHZH%h@e{f2vL5U4G_T-j}WA2N0=r) zlMoosT=JpdfYx+8@Q+8-Q%mLTnhj>nG{u3gc+~c*=SM-2(T1@&`*-WSVn;(iGyh#b zixR(G@+Q5o%Db2zFFh#_M@D11Ert8~zkP~QJ)?5LpPmp;|HEm36Mj}H+0YDbeYcEZ zO8}>?I3f6NIyP!mE0Lo2rYuNn#(XI|U46VYpyE(E;s6Xj^;5e!?vLWp2n8mH@+e~E zsW*}Q=vuDM^46rtZHq)s28xdx%rKh63BF5!6**lw4tmHtoMx((n(qN9{X?alV+8Myd2uX^Fu{8dT!;V=;X*)nLVd4R@6kP0kv(wvO z3($54VCb2P4sDF~T$_>wAt!ghW>#1r@(%9BC3us`9xj6=y*I!&_I~Mm;XCOaV|4_& z!O(Th9Bk2}5joVJ$L>(^dWcTVTNe$!;APKa6?I%V@S!)uDZCgR1ReXw{mJ6w4apO24aiedQ~RmKfnhss-GVOW6M z;TOJ3tsGpFzT)-BoB{*W21xWnqtvjWPhdb%b3V=2+CgaNmWl2)@cg~?jgUgvgL?E} zeU5n)Upxfzgyq8<1Ax!(t95Pf{ZO1yV5th4PZMTsmB9^H&M)N1>3!4G4R8IC#X2Ut zDe~qiV_hWU=8>LO33|zTO^8aY;{eaEn783nztL@D(_}Fjw zZk3(ZxkD>e-(TM|zFJ7{Zk4yC2%V!=&KlT6pAxp+#YJD{*!E@t+Ufu-S@Poz=JfWh zB8UlLwigK6i4nwc^_OP?DCf002^kd*%xi5!MUM$||`1Dq-}+yC&r)r<|MJ0r{!?8E`! zMP1PwA4Szedqp4;0l9KVB4`R3nnv1Ff)eYx-`-M+{`|N9#QEpZoj412OuB?k-F30V z*K0^)fL^r8=ssD?5&);|Ub4UJ43IH2hzCaBh{%Nnjv?3cP-1`6W zE~Q4gC~#S)lv<541yaP%+3!NvS*&aQH>k^DYbs>VClYh+H93N{Iv%;hK*k!Vl9Al5-NYDj}cP6Xl;2~}}JNc+Af827aKSd!#u?sML$ zWjxiA-+TLdRd27!Ux8g5T(8@9jsHhCLW0klRcn(cq@!z}8fK|m!I;JXLqb9NU8jH7 zty!Nur=o$n*Mqc?>wI#mY!~F(MaA+#PwQ&XxKpKS~EhUVCkowDYe^V=- zURg+w`Da|@jump*b^QmBPKfCeEGH>?iEll2S}$ST`aWlkzn&B{`jIjL?Dyg0|5K?= zcQWMX*$RA|ejIgf->s*}=lU^M;EW2-{uYgkIql9Uup=xyD8tNzg-6OjOIZRwH-Hy& zwy{FhV_u_rcn`0ZC=b?3p;a(*ID=1Kl%wb9AzX_|GGvG`ok6xrC&M@CYrY+A}xj&YSvj18#bph&Qfdi|kJc}fW-qO-IEz*Cn1 zG#@BwIIfYn<_vuhC(d*?B}$sBesz5z**tP-K=x7;nk||w)ZsG z2uVySW97|}7k;ZMxGCey<|T-d1U7q3dujpNmH`-CdZBXwuv!T`YKtvZJ3ehGIeJBo zQ>emx5|^(AUwWe& z9xm=XvEXeNI`<@1c1iIa&W13(GoE@0mWt~&FxGwlcADJaM>78CyPl$nr|^Er*ISN*rWvx1}-Z%^fbcw~;D7yVXk7UAd?!JbeKz|hhQ2USD$ zJHk6pUY0LAo zX7kD$kKoE@X?<#J0(v_EwmN(s+NV>EF$$eS5^XWyL12KQQ|$;ed+ZRJJ%w$YZFHQo zxxJ=2aS?H10Ph4?P^1trEclbm4SYvkf-5hcSI7g}0mwfQ*@fQL)o#)Ml-E@Sz9syLrX4nJMXNyCfTlZ@?!-jmq+WCLca}ip$Wnpl#(B3 zbpv{yC@2>Y!7)KJ-cAHZW_XXEoM+C{jOHb*Nhmpc+)mscT(MBS<=53O3F2%6MxWO} z7`lb&ZC%7RI+~v9*U@v8LcG?oHHEa%CbJl5FwI6SuXv_-{}~?MXp^vv*VyeKwzY=} zX!MNt#JL0DY!P}S)j{EOJK%`D)!Z%TkS08?5D-qVV6PZ^Dj_NkJm2yttd)>X9AG4c z%K6{@AKbgZVpdG8*n6~ zN^PzU^K}0OZ!J}lWdqFKIJyql9)>1aUPOPbjMlDBE2PtrvOZd;9ff8J-KI?+$hiSG zpDDv9<@b%}%tF}|AKgK}35{-QCqxa4<`j7f$E+&fPdAYm{mmW+cS9k9##_eEB|0da z4#%H4?pHlFc3wp`*4)DJf$!?j`1Z={`_5X{Nb8Y0UVGnNigYS_eF#Hiu zAB>wsC(u1WkD!xjOgd;b)afqwC{lC$8%x*2j?Mn+TR6o1t4^1<3e}A7z@mo#noh~|Ip50iLxG$}v z{T_QFV9m<4l~dS#{k^KMUxzlTDaWCVFtawbbz0~(Fr&D&ud;NmZhn@h#AJeoczzv|bP%n`t7#-HRy?1|3Woyv|WijEA zltaqclrbr=1-nL#4gwPT+f-Y$xEQeY4#46c8`(!Gz#`@B3a5l3$5a>qzg4i{oU*G$ zUiTsBgGIFb5g3F<_6)bQ|i~o*yJF+o^MVZ~PaPty^N=3I741lv2Zonfc&e6r2w2)VbNJ2UPFTjVF&{_xJ@$(x{=mZTjNJT#coq2(oO*0B)Bc7wRTJ$?wCxG&K z0W>@x7zYJzpr@qwVL+r;fSos=4}sMJ+}`xte^n2!c)T)G&D?ON(&==mS{qMGDgf8d zlr?10d-QlK!Awx6r_(Cx0U_L|Cx_5zC&zx@yb`1?;dXl_vj5@dP_ir=K2skC+1Xxe1vBiFBUO*F<;=MJw^ z{dc~%MO@xKFr%9tr$)DZBMaI>TiKNkz~G|u@6VLlwJevCH?J=A6Y%j;mu~WD;WBg}tx^dt#d6I=9 zPR+Mc&n{n4$VeN{*~n)U+!~rx_cJBWV!+d945(gP=$C(wmOs`6$9MBgQIM&P6}B`PTYw&#(-iC&OLT>H0_TtxO}P za7>J-RSRs{;&R8NoGRlxLOX^Bzj|LaXR}Sz&(6KPa54){`4Nq<%XA4u>5T8fOQ5)3 zLV5!90M0UCYX%WNKg;Zyi0UQL=9>5QebO3QOa)*Zebn#&o!3#lr0LZA*YBxp@lEt- zB4h!;8L;ymex-I!CWg+XJfJTGTAOci^gMK~%0`w`JW@m?o32K-dZTL0ewk7Ov)f`% z`nNlyCAPaIKpOY_VAk*kJ(21pt5$B2P+b>zR_VRycnvu3Iu+jl`zuk1vEb^!DzB@3X(>7utV#y}2}UCLO$oTZDF zmGX&p&ZbT8x6Tgb4SJG=6>2gzH7t*g)*=TOIPJ;Dt+Fbe)x;mL;ACw8xy~rl34k|R zhgRyP!ugcZJk(2l|0?K%o?bQl+3yzsYZGn_rTQ*^yEp#a@Z-OAcH$MVK4^^sT93cZ z^-f9|@5J;sQWDOZmcfcGU%IXATRpl_w#Pfu8ki(-OBr_-{yy~Bc|xv-C3=eJ=bq+? zI5Ad22A26R8wauXR+!H|KYK@|HJH2kCL}AttJuA&v)K#YdmzhH z(H^pH1+4dU`NtHmDfRS|`cmz*Pj39t$IFQ^dMhKXdEq&5Tvo0qt}_4!po$Z)<@TEk z=T8c^Z&^QjrIsvwvXl^8ZnwD`L(lqi9tVY~{|~=G&j#k*30q}L7M43DrIVci0~Wjm z42&SVUaLniLC;J8y_7wCk5U_MtQwnb71wE7^J}R7?cc!+V0FPAGXVX{p+|pc$VAfeu?=<>RzV~m z1kA`AlC6jN7KdjX7D`tW`M^3BD^cRJ@bkf}td;pUW->y^Ci3OzDbq z+EfNe;fd%Q&d}fB`=X+@SfxCmQl&D^BZ1FnTHDx@kqWq=(34L2nd zppU$5wv|oQ3-TkG7ie^Wg=g84r`1r&O^CX00CtAJX#=?_zCcD`B%BdIb6>h>d1*aI zbyd+_Pb_%L599L2j#MV=r6OGd=tuRH8$k6^&Lm8i#q^}4m&ly#06tG#Zl9u;n$Wp@ zzjy~N{KG|n>_)=j!}Zz-K@^FQbLCCbV18Ai|Pm!($2>!-sOyjJLuc8HxGFim!Bvl@$~ z?lDkQsCdAy=nl-%o&SIKz5~pz+GtyM@7fsCA@pW2)iir;dJEOmKni>*UlQ_>KoSVH z=}AaJ5=cTI7>Cf)d!vQkdv~LE(@YH=+qmrR{eK;4q?yr3N9XR{_1gG8Pr~}%b0m#4 z^G?xdq||f6%b9JpwO6)B8WTnyvIN58l)jIbpMR~i!_|hYg3L}_C5;x&#>WX=1}88S zwmy8I!1b-m8|PjwwCWNos4MpUd11i6HtQ{Q(WC!SmrqOI&R0rgFF$b7mWQYV*Y%el zRhHdsVOh@r03ZNKL_t&*;lqN8OF7E}w6*`uDt~_UFpma+_rHfV0HBi$oD|2?OPDL! zCZzu=6?xZEO)vh0~_E$#dtYz$(9!CHQ@84RW;uV+DZ+tW~CTi3JyV{f2t9Ra0 zqAjBctr>=_ZeH>-n4H*nP+PcdLU#q)swjV*PzL+J?nsYSq@esky%vgtY%u#lrIN*p zJ}_gt{3oMfax&ndCt5Do8Y|>fl=)6NL15lBA3U57XUtY}=gy1rdtm@r=?3t+_mg?z zq0hL(2bZhnWnM{QGf0nRF)+vU^~h!U0eTB(&=TgxMVy-vu#Ytr@KH7T4Dv1jgg|@0 znKbKcB(fom+elDcf4pW6AehDbzq$J{YN-Tmsr{6u0!LdaX^}chE&)n|&m^ z66T3Gz{gXgbBm)B{RNjWZEd%nt!gh%@!mhabV!H-bnX4yevP@=>*m0~myqm_`eeY6 zLwlsdd-SrNqj}H&#>btB@`#^-HOLMjqR4ZsEoTs5kuPgQ(jqa7t*kAQ02e=ZoJ-sF zFFl~Xb8oz&875O_tm9}BcKCRNk$WWg->D?Aq7U9M@_MTzm@T{f($-j^_*^uH?ofF5 zZ8>jrnH83134>-Jx-wy^7!Z#DKmg&MOe0{e^;UOhsvBw7E^*+~)BMu2uaqjiHHWTd zWr1xr*ni^l)A&q#X~WjA=<4oLuRQ;H&g1H9n|wkYzR3aU1PE-E39>Y=yHkyy`VaNb zXUZ@3$r@DRp@|3o#{8NqyLjxec3aU_SsT59OT9pw#@zZJ50#Jo3Ch2F!vj?J`ub=a zv)ua$=K7M?w(die2g-C8`n`{7<9cwu8UXX2`*oq0q>Fl-0VP~0VSdBcZTgjv+cIb@ zUI{`J)?{99$s73mF$C|81Psp0K3`vU|4^eZWkbmcYl zkvQ{`-&g=(trdIpWoPh#7=6Z`79+r6b(&WpUA|MiANh23c105g^()(6N>f5`GxvTf zYr56i>#t693d{?Rs9@Uwwp&mw7^0NAyBccxw6r0hjewx+G%-LV^Uv_S!5@6XrGF9I ztU1PrZt>Ow&sMtJZd$G>e^-(J*mfAP zR+_c}>wL9oN51J7HKFsS83O<|G#&IHyutv9&;7fIJb8dQR=k};2C(&I7n0w01_NOs z+G42am_LlieaAxHNF$QFQQ-S#Y0FpsE4c_Eq)}im-S2A9v&xQ6YZ#?6!%cQN_CAq? zVKsSfW_eK;KSWwmI@PKz^}#zcR99DcwQzCl5Dfue)uitUNL`4dBLH}waIRIOO{x1b ziUjHM#%r&)I!S2tv%{{EjvN+op+Y+t{qN_WnqI2#*4|(ZVmyH52U|a`0bl}qe*)gJ zfCgwV$7~6`_)K19$@@QZk*eb@I3le4c0qDSuBS03yUy^B%kH0^xK{o7>Fd>7v(xt; zO#IBRsa!^|#C;8;!??iS!8}9c0wZMtmvCRSEyOIX!X?aqEymnh*F07K{WnbLpBn%| zE#7A`pUgi4;Mt2%8M9DA;K&&9DysGFdi|Y0DG>%9=ag4Bo&YLif`4!OIVDzwm25 z^sl>-5&)55(D`Y|$LL+mZTs(is!QCktsn+J_vnjq*1=Biy^R(bVodeWFLy zzV3X80CY~f$mt-CXwJG4pf0eA+3CR;cp~Wa%a}N+=bpEN!B{S}g@;PKZAL>+X#22p zj@t3^BTF^V>O)pB;LYwfcgbSJI58kV!P0#9N+Kh@FfjOHu%j}sypXqdy!=W=s}|$4 zUTMe^Rw1c|(#d?%&3@2MFhO?l^p&`&s)b|=z%CSD%iOJibvIrsy7D+)g2mJrWb`#; zU%BYSw8vje@_;Uxt1oj38WSuMY2AI}7Vu06q4-*FqvS>cCVu*&=xz?kX~Cz=?r^!X z>@*gZ9dZ)R&KYjUwNH+alGz5Ei-LEgEiWVT)Qh6f0@^s9^+#OdW32z_L{*#lR(R}> zpZSOT2o9#nm>5PlUdHe~u_l935{3p#f;k8Vj>?wcug+9Tw z4jB5i&`T`UG$F!dykZ`i_soSp{O=qU9ptwt*I4Uc%2r0T z=8ay8j0X)a7&9ABRoci&g_=^MEIdhZ81%Z(0?Rv4~7^TDlM0)SP-mYDW$j5rzsax>2`j1j=ox=MtMfShB zM!?WbhL9)=*k={dxhF0*IP zRj-spB4DT!KXoD1x=7ZI@`o=Xa^0J<%jJ_;B6K`eW%r{@Tm4to`^TaGi1P2+?O4@V zX#>L}y@0u@>qAw)|EM@D3|>QZZT@}JJ=Zx+=o7sCNKdsP9n!2m;ku@xuH^az#;V8J z-j@cz?8h(Mpgur7Y1ceB_JK1ML;1%$s>rCbp>A?)j~?qL-iVpYu&9jr8fAGRMHB`D zO&b83e(S;Ub8Bc*N^O7n5o%6X{0JNH20o64xt<(@mR+&8{$4mI@5qt8ddP5+?#$B`g-*qsQlU%0Lu@7sGhfLEM+ znWGqQzWR3dB~IQ5XkKRj5_`7SK+Hlauhdq@9 z6XD0E!Upr6z5s88RqfL~pUQ~LZL}3_c%HHmjNHx>&+&1My0rW{%C&~-Ps8YdLylnyH>Q(7qVMAK_amB9+osSo}78A&H6yqFE}=R z*$)^2y59en^Num6##_b%?ROmRw<0u#!2eLA-9tXBx>w#Mc^WNu&Tu|SPy-~l5&K*j zZB?4fX=}jxhga6;m0!?Ce6z zt(3QxKHf&mHatU~6?LLrS)!VLTJKZCfZZHPi&9LuUl6I7kSWDWvvF~8BO6;R9!V7= z+WH2iY9IKM0FF;ko(ayUd`(vh+#*j5H{4>VQ_`uTRA&FvS1|Mrh+R+ZOub50sP4^w7^KF=bQ9q@d~VK#erfzWzC}=c<{NYs zFHt7gm!Z}+@0Vwwd!eLlSaxE$qV(HfJRa7N>*H$2w4@o_sLR2$=NA3y9?%ldGt_c}tO4h1f22 ziLQ|Z*p%#6#*z}*1^mJDU5&QZ;ZkqYR{!O(O3nTto%n|ggRZY$Kr-=r19R&)A@AQR z`@$f>k${>~-9rvija7Cx#(+gpAMkGuzp?k9O(>U>YKNEaGb4ts z90BNj>U^V0*d_o!sfKfdz_OAuqNO}3>C}_MFgs$lwPO}PF(#)+A@_~7Q!I|~9sVBX zO`;9=kJ}k_`PWO8|2iA4Nu6`@Mi>_$7NnJj=bn5?>_;0GKo}_@>=w*Vh)x`wmngNX zJ6K$Y>x(-5kv%sErdVOXV|`t?u6Cu>brGWYhp5;_BU#$EFaY$?ae=G3HDCPOj`8ly zN`XU%t)&JI(#Hc6)ho%&$Ob}qx&!Dp1A2VQGs!vGXvBKH7vw!M_6OwiZQ;-Z>*0y1 z=|17{i3gk?&xK?%M6$ur0&v+)VE~aU2-Y=;0lcmLf=gJIBn;{aF6Clw`%k`Z&inHU ze|oOj-hbDD$1Amp*%s?f%&p&Gv6Cx({O>lUI=8LHlPTRqJn(*|Pg3&@kkr1x*DLAt zN)PJ+bUt~Wjo{Is7!Fk%hBn@gnNaG*!#Q1Ur9pgCI{wDnf|CYd^QGEys}3HeyrIvb&*YysE%^HtDe z%!t6cV&yefME{H%CzKAQ-h2CfHG9^aK(U$js1HaVq83}Kq9Km}IOdiV9|~aT{&J0g zjXTyybs4a0ZI1vJUomroe^*E=y|9U#*H=o-d~c?DF;PlbM*`|~b1@YDcqb$@QWE;V zXyWn7PbUoz{o`lX-9;U{*}+zKhGvyy+(5{mpVba!SB~n@NDy$AKXK%OQOLvMSVE$c zEyE=r5Gkh(rq<9HMoZ9V1D?Qw}<>dCRRacIN7`W;RoJI9t_BQ**tR!q%+Nx$G41jA{xhtQztf(_ zAdI*NiW_|)RTI=@j=B0G*BoO-X-Azh0JgqfsX?=pnn(4BarDu?owZ4cjnbZZeXt(y zCZje)Ys7UX@&;4L0eU@1W!6M-HTCGX)9d*a>4|6 zp&87rpYjbqRy__l{s(`fs6f}Z&NJicW!maj*(!v(ANZfN4N$MEt{s0R&s7WcNqy2c zLY}wt(A9CaQZ>rCpxL7n z<9*>SChmW(=~IxmqGcw#hDRVO=yM_5b6DQ+k;x3%#rV=H*{wnwNSKIA97`(G=I?vx zE!yfoVaiPtFI@Jc+Uu(G$g>?!_a^4HUum(Eh5L)n(RZD@p6hsx;Jt+374!*itL?ep zs@mHRcO3)#`o#d~jk5Y33!XU9t%azaMgS#g@Pq^DSf-{<``J2yGF)Dzn3KaDsl zU1E5EqS0CWR&tphnIoyx`G@bR`t{!q!~fVYu~C7pJ^Yw*SS4qk_%roM z-}HDYLA4guWrnHl^=OsXoOR0?vzb%5B)r6L?HhkHTd!w7s5|O>>|9^_pIBIKlfrTb zo+baAv0`jKK#*;L@&uewgiS5GEY6#;V2Yo0%7gVmGF6bGaX2ftC61T3g=Y|Dy_XpP z#gVRz58hWQ9=H8H{qS?*+wQ0s{OYtbERFX{AvXH-BXV2Ngiic}OL~mQ&g!%BxMML+ zfAC&10C*{4A3d@F!oz7g+qbJ*j3mG~chr>tyOqKx+i|9>IEI; z&-iSy?J(l$OX&>2M|k}lkXo5AtjN*DpM=mqJ^$oO>iu_TL`SvxHpn1}MLo#L4BHgr zVa;O?-TQbc^^^8L*KJ(8z5kf(B6)Z7(JI;HSmL~FgiArD;ewA#^bB6}nA`p{ecUb* zzqU%Z>szO*#-PEj+_!n2UP4yzfS9pZ4RhNsIig(o+wFj^(dU|@(yi7fUO-iSq8$&$ zR4yGlH=;w!gOTIHlxO^%rB9^e&=vW+eb^D%dOiEW&d1Ktj#b_5tD`rA2tb(yh}|Pl zYQ(z?Z*_~J5#xK#$knV-yJkJ4?U+dys9RrqC<&k&Y#tVuDMeiSK8h$P0AmP%zwfDWWT~z zGri0+E*%SA7Pw-fhqy%c?U7^9cFkW^?ZLZ3RzZT?b>cbx_ZH5Rq)+Pq$}j-5!rj-7 z39q-HPY7=1=q7l<&UgL35(B_K*EI^w5v(_i2e7fMf4&OM&{k7j?HeCqk`hWj`3AtF zzj8O7IE%~fF+v|W0~k=qdq32hH+12!FCA%+O^mI2CSCqnRAI<^R6eL`NR`L#IlXz> zoVlk)UX{M^M<2}_GSBz zcfRb$mQhPCHJG0Hwcb5nBT!Uso>fgODx`A>^xm~sY=Gog@({mRl<1t-rBX?NU;yY= zv=P9a5w86GikW_~0ige#n-8F$9kKnUh8{>qDb^IPf&8~mdSpmp%^@86gN$JP)6}~k zjfyrHBqY~{Uzr_!+mAEV2fV)CQmd(d?DSpInk2h^E~wTgvWr~W081kB>`xM)s9zuB zQp;!~%mXr!!Y$-&BGG9EbL(e}RjPAdm_)B-sZjojb#u`^VLVM>ZvF2^&>RFk1^9p9 z{qGM77jm8Q^a<=u%JYP2F#4o^mmLp>Q~(e#0Jieuad{ySov6%{9-Ts6Ne4n@#f&*O z3XpFAJfaN%^ueKJ#~Untm+&z9jkZKHPzA4mxP}cM{tr3QyJ<-F{7EeqbREk z&4Fu+(l+wyv;nZu@bw~lN|608qqFwZW8wOu&EjJQWtc+vfJLd4nlo!o={@z*-2^#h zDWPZSPJ!5c2O`yIz2?oCr=(f}@E$e*x)YquS%|PTcD4 zGo$|njn*m%_-*o?k3`k@h#fX1d@V!~UH+*LRfh6C<*s-i@bsj8enqpwC3%zVALbp-=C%4{_neilF|kM?2$#YX6;*$Nw5E@!_w~v?WGKWGTRSxj3G4Cskuf#TU(nd z6t8Q@*AOGv$u8_Ex+F1Su+q?Af;~>d8fW?UpX9F_)pMQQjeQ1f{;g|5G^5{S833IRpY4$d z6g37)$rI{9wJ%|a_mDX z6*~_;tYdvQZpd?@N2_Sa-zjt5W=Y|fwbonRs50BI(Lw%bBpd+?NVU@_T`E*4f2+(= zHT9+G)3*rD`e0U+7jOhXm*bZ{e7oJxnSHuDeCv$!&Qe=mH?~Zc3~sg6)X1GSr}V{Gi6Gp(Ooj3P#7RZVD0&IEE33y*t|D7^2U{dbiYl5oVn<2?W zC1tVa^5*fs#cc&igIUY(A8G-XxW-!5)&hXJ^*?;ed)0~Zzg-8JNWn9h{G<3Ak%*qM*1mwB>8&$Vy*ty2A7`hX^|^PyiF1d=kSFoLEsTLPqIvyTN% zNQxp)r`qCz+v>I?ra|K=GXORjW$(^*AkVE0-2wH*x;nd+RH}7_m6lVhti_Az$Xtz= zM*pqb(^>VYkG`M?ZzqV6Eu@xahVQYycQ- zY=3}af)*oSP~tH3v#bm4*`IOV1XZ@S(5}8WVA#m@Da$hd7=Gl@6t`Po|DXpf;<3vI zZk-xk$}K;hdE=3Egv)mMz^xA^c}4#?X|G?h0t~_{t&m;L%)Nz6y^ST!;^jh$x%EGt zpwv8lohJ&db0fe;2D%RZrD3jER&NXSN&Uv7Y+sC@VVw5su3gV2^=Ja_m-wkfpNK-2 zNn877tu_GMXhP^rU!$0V_@31C9&>+d3&vAZyWRY4_3qsGF|8$+Swa=H`JD#Ji-5$= zWpA?OhS9UQUctyGD$34!lM95fpn2!jpG_4URGqIN?fNkG}7 z)a!*|(JNw6={2TA887fGz##66hl0k{Bid?eBrr+@hQnelao~a`9=`txu{GTmp7j!a z6eRN$g=G?-AseiTew94W$eP-fmP*RPjfWD`<@8WirdBcl5GRGk5|gXq*`nS+I5B6Q zXFU#W1Y9?!bh`Be`pV>@)HB9)Z_iMXh|73sUpNc+-kTtPEO{GF>bJ@i?c3;$qVKmfgnD@l*%m%aFc|jX~|J{j0)>6 zGy_rE;Nl>+7mh4SBo`yEPb&sjInMS;96A96G_XH>U#O_{ZG7eiL0VbPSc8T*xQ^FD zr5~u&CT5Z)mKt0rFQ)_Wc-es<-zqgnbkQ3A8M2`P16>(XrPMt)%0_@L554-@tJtBTqf-VfBoiI2mErk&BW(k{ZK|dwj-KG=DSE;H z+w2_6Q}R|-c6kyc6tar6BkIqd;8G54P6mS0c0^u+(@pc6HV-c5FKOK}X=}UV5>%)Cn|8Kd!ur0c9v9b9}cBH^;PiUL^ z?lg7i{fIFGPEx8U(h?sUc|(J3tQs4%gDXzqYI8D_`{v84ypdZ3iCW<7BA}b$L?zuU zsErmcxU4M<6li&i9_*vfJt1Ft43Fm+0A$M$d&9O5{U2=rNI76@uw=uW7Q*Cp@ zF~TZ`Uwv$q<<*8;tSh$3pGJo_vf4Hed8Pux;O^@uitlf?$4JNe#sKw3GJZiaQuKFs z-!Q3kT$A?Xav;U3V)3go*_FGmEW6HFZVs3HDEc97#hT)ILU`(IjK0R)^t#p0wn|nr znf{-22Y~*5(Bi7=3qM1R<>-o>XQ&+E(bg|#jvYW3jMYBewIAjC9G=8{l+=}Ow>WRz zz!~hZ0nnu*0JfL|(@^H07{|#4F!Z-*jz9#2NuCSpIJnj^6=lGcD%n`+ek+j{Uh~3X zEGQ3`sAb2c+v+Is{!6RHvE(S7p!d*yVL4XU4ulWDBN2Yp$epNnv{M!!R?RSF8Zt&W&BW*v*GPTVMca zk3<6rvr}-SkVGR8%XUfI0Oy=#Sl$ZbjIIyW&NqL%R3YjI78^8B>0~@NTkr?E>XR65 zIHE^hLY4|)L`x)Ew!5x-AQ;>Bqemfg0h!=Tc7178CZLUmx+`K_Kxg_i!2P?QNh7lE zY=bYf;^-AH0GCscx0l$laeaq%pWZq=z(&4!EDgyzUV~m) zH)J1Z+Uh-t0CZ2C@KB@C*v#mdu)qn-QK%~LF*ghHaGZ?q$0N{XIBiuBojsUypAh9S zj)OTyKl7V!%eB)Y+B$AX9}^qC{U$c=Khzh}x%yZE7GLGfx8r9RRr_=E>SsmwqwDg& z@$#Edr8RJ|0cy>ms|8r$=be=KcjXMg=+IwCR||ttLAU9sw@0>p$Ow&*@a$vhD~p31 z0PRTV;)qC@#zJ1)^Ntw+o{vmRFU|U|I`A%fM|jF2*m3Wzik}@P7R`jWP6l>9((g|B zS($VIM@maH)STIK70=$^VK3c(*chqL&x}gw59UrEJDfdhPSWt1yvJFhyg5EWp%^TS zaV%+#?9y}9_PC`prai_nzlL!m#S*L+`Wr5}@nqsR$H~5+t@iGls_l2Dm^qH^|J$fQ z*Wu%xx#jKRJl)hRZS{XyY-b9eFh!eE-JjGv-y&V5=i~CBeTw_|To>-)Wz%#eII)E>VOq z7z=2av|3HwarJ$r#7^2he@>iKNLQ-LDa2y`F)ZN`snWqq`|A)@i{wj`wJBZ~yO7Yv z*N?Gsa%$=qeov{HGiY*<=41RnhyZ-EoTpl?PwM|**bczT41%uD$YX0ppTs7t8QR)A z#zpmf(g5h1Jl+JR-G-9!#OQYxx5(zIFCGK&UFW3$1l5rB9RRZ#ma7s6W3YXgwv0vt zr6Xm%;v1rPTmC(-Ql;;p4?IK%CTKhz2?Ida(;uqC>MYjn_wD@{^k0+jcsN*pU0`PT z_M4LG0e)MBRdkDKjz&YJ%E#(X*V}Z6D-44b5>_zMc0CMu?womwpa0kMY77ALiQOR( zc)cV#)KJepT0H^)1^@}Sp}Yb+Aj`x)S};#A00s;gpiVpUG`eqY8-D1$=haspNaujy zMcsM7ZOZgT*6(cRD0s*4sx=dxallP6Ziz^+Kuyo*pPU}7Gw*!z?&BR+fNaUK8=B@^ zcCqXPatc^Nu!`amuQ*9@3H9G{T|`VWn71%5(mOG1qBM$#h&+jSss6X4y|GRlA-c`o_1W&+Sfos-VYb(#a+l4>()QvKisb z8MD>nlaVmkmPhSm+5p*z>Ug%L!UtAX)ouMv^R6k55iH$RfZN35r)^Nm%xqBhd*+ca zvH)$YJZM?9(ciY(M+Roj0r9d*c{tT$yhqx&ef^;e8*h9-EY zH|9ELp6V0Q7^=tDHRjBokVa1*RcNXHCp$Lg@fS^?@47zU-1u_lr);>Xb!#7aboB_p zyouv~R#V+4VDEt>=6U19jSWW-i@CAg+Asq3MC8aKY0EJs8a}jzGbZ`|Z7ivbj){6k zJ)v#n&1vS{a_22r=Cuz!8z%BBAXQvjPDcfLM&pzW7%N!C>6a3Nk8(1wRTqT z{eH6g;QbFs|9YO<>!=0}%Ui_{lTe*fYOW9kIP;fY$T@#&o}4jnw%Y0T@07`_`(0NV z+8PmdyhvvBM@h|8n+ECH_-GyWYIHTp)b-4| zoyohI`SOtndf`MJYg%&&vh|9<-6 z`2F;gcRf?hojXUJaBP^BU*=>JAwY{R831RDKV8-BzCw(@=X7_f?QT6mlDFu0yB)ZL zQ@`9Jz?sUVfwDCMLFBy&^9_T(wN8Z3# zwf9$4(I*aLF%MWHKyYR-PqzK$7;gY@jfwu};YJMerazHiT_ig^SX{%{N#Pi;49=PQ}m*Y?v4|Wd-gD_mf}3u8!!3rA z;Q1ciw!Dyw+B4Q)UamuC4_*?0L>5g+%QRfIMZAo8~aS!Z!#N5%HLvBv|m>Z=%n&_mpla2%Q}^X7dw#p}a!z}{&1dIkWYq8AP^+wlWW zNXchUObt&iXrqEFdFVIz9@dv@T^;^^_&L=rmFTmLP2S~9(G%Q< zqYd$}mE$?{LbZ10S!Z~K=6F)(?~W4VP*R$Ee0oRpHI@;CHpLU(K^O&>G>bMi zPCcHHw;h)RzwP!MY4)_y8Dao+Uscb@{S*Wx+TdM@ZnE!p8V>RbJgVc!u*Ib%{ls@okb(SYhXK%+;S-< z(^6=oI`%(iIinrt8Rs}6rFrA}f8U-YW%AB;&e&5DW)N9Gd?(2>=fe4cOR*Zy3j=NQ z9dj|i%qM-)b~cLuaDV~>;F}?jCv~NuPqOqI3%}wuO6bZD>RTUYE;B(NF)Yw^-{}q? zprv5u)dr@YcHx1ns7>zWcAXv@H1uL3BTh^Py9}mwqjYE9VG_9_M^8nF%RTC zVPJ6hrae>G%!lW#p;cDIgxfQ*I`FCa8rHFXP?v^#ja*^ke&2lcZS~(*-y&V;ON-WA zch#uEiFvE$1$vX%<5Ql_QZO@S&Q#w!>Ez(q#q2f!k2VF;fY+&^l#T#M%JR%JwZTEV ziSZdc)!pb;qi(O390>33^*Agw;6t>gA|1Yn1~ zv;jatnHU2I$K8&AnKbi%R?E6#7KlUeks~-FaMyM6B`{^6G;HJs_7U#^`cZ=>@EQPT zD(e>?ofOtC&_)G4yJ+XyMLSSF2C-`Wq=47@*yM5p0QlwTqmK{B9W;P>%1lr4NIP!e zLm>)q=9xbav*U}GJWpc&#ynYOG{)AdtzK7q9lUdR&w~(+BW-XCk^P%QzmTcG!661T z`u*H&+Fr+{k0$2k ztQ(-Z;ezVx#$~tdoa0OPaS8*Vhx(+av>9qCf15dIsCvEu@N=A8Pb0knDxeK6izMW1 zF$P*VcO3BoT!<3AV=~2U`9XYc8G9-cVzQXI^SXK4a40m0*98%7uE&dicibK-8$6sH z_u0x-*5g3ybh)%gh&)kHD{ko6I6&rwzWk-p9S`oNjDSr>fdPOGA_Qn8Y=I978{2Qeju(R8m=^Q7=hG2&~wx}`=~?K^d9oKhyfriHH)UXDZ*?k835ydVKbGRy&WCTq#b{zYVPuIrN$j2M*yURKM9x3p#8DCSyCRrFHW(gbM$UGf48*{7+TwM97#k941lhCPW!KF zsE;{GPIv^80avDIa@u7PbK0ad9;7Tp6DQ^rSEWsOzT?g~fNM`}<<&n%(tvqIG=6*| zoWIyCdr-Xd+WVEhKDZ|zopCOzEuI7dTl4lDzt-+E-RKOh*-pVa66f z0%9y2rn5)xeEXo+)Rv`#OOik;=6U$8KRCl;v4aCRp7~s zUb;!0_rmo}FW(m14pVEbw>sHU3y*8kBVkf!#avkHOoUI##%2?E<)3fNUaR843iFgZ zL9M_gv5f>?h?vzZZB=n8cVeoJpNS&rrmtvAjk&kzUXW-@%>kdgntHRo?FlR5S3(2e z?$eCy$5MtNP1;Ea%7k`?3UY06T6JIqqnT#l<6a9kXKf=+|GBCtM$x!%Gs~48&3chDN+HVAVvXB{~0Oc9EQ_9e-|_(^h# z<A^ig>5)MqbM7rz$27Il|T zY)4CAb|r7Zf0d|>V{{R0VVj9bGIwDB;bC88^{#s z_~taU$1|lJS`PHl>zmx2W;=Cq30dU*DhO=?CG=LxO-xUtCixLufLPUz>~K7 zsTz5ASR)@^)_e8!b||;W_uwr%u*_0i#`VE_9}C8@#Wur&+x*H0i%Od!Mf}jcp@9Ky zEjM5Zb<>t71&IdZjt}WwLK^^)k8=?0@7TcCOE4p50F?1tll*=DOE;+tUrLA5%jZ+6 z0}jzg??CCJdJYA_zABQBbg{$~sgMoZCUDJL-n{Jh*CmHGdApzb-??0;^Npblg zqR47oV7!38Q_;D8h)eVct>Di!$&+MJdvo1lJODbRif)SSC+DtPj0YrrBI&pa`h*{S z4z^B%b&KqeBxtMe@a;?k0Ijyzjq_$Bvd;I8?PEb(sdgf5I2pwed=f4Z#*{lAXBY^n z`Is4MHPw+&s`}Ag58U1#3vq-?ra(Ae^muUmM3>xs<@wig@Ly@Lz3uJC)wn1A7=3>D zwwqXwJiS|AG=LN{R407!9>D>7L@BN;d+bvv6n6>);p(U0c ztoHoO&V0|y{~M2!TR(2y>0S+sZo2ip^mo^m8UO?b`a*VrZ*y^=hwJ7@>I>Q!F7e4< zm@qe+HvJ%XZ>#8&GCfeGtyb&G6m2E^oiqSC@BGP^YYp{#Gs$@Na&`p>WU_U_2%m#o zz0nr#w<>L-$)P&#NniWA+b4I3<}*fYx6;XZ_R;6n^G{7LeNI1c&(=Rui?y|@(+^KmGiQ8A-XA(_ZKaCslRA3JfKPpE@e*(PJi(!i?9Zf{_TXhK?ga_4J7pbg_5)`(?G z*9zKX%4z?Q&!tIR6K z-Y#iN;<;EKwjVcKXYt#~PVpprHkY=Jd(#GhzSITgh>DEQv?_*Wz1=X2>Vsr#`ghm{zhEh}R3L^_6b}$Bow|)ql3CV^S75%gCzcWKU``GhoMY7GQQ4f6FiQ)PzY4ZRu zy`%$LftbX>q6R>z^kL-)n#W8~v;1AQrpZYYek_cEukGu`#2+ynPqmk1Q^On)X$Ej5pTh`6Brfo!t zq0+I#W^}SN{5?$#*^+yldLSV1(TaFJPtzYNonq!~f4@pK@n>+d{W8Y3oy5 zBBiv3Cxml|LkebO0oLdB|o8f_MnVqxJRcQ7Jr}{q9yI zR0ZfjzX1vxq6U2d=a<9r;I@#*Vl6ly`t`K{nx$<-i2*SBV4ZY@y%iLFKu6xZ^=^L$ zYqQZ%Gv1%2bcx@b&p$T(mfB#6RZQJ;+pVUpY@8!^)C$`l?UG^pIe2Q>id z^){uq0I07R-*)Fd3j{)R`@C&F2UE5_6~#!v1M+hmGXO|D0xby+#CSgO2Mjv9l$t43 z1^nqL1-phk2_tSLPs*$Fljkm1|9<2C95$)^%zB1|zJ826oUeU=^+dY$5S08uhl^cqUN zC*=YBL`NcI-s@}r?re0atseM67SA;E(Aw*-uD0F7TyYIx>^X-TyMI6T@?;lNwmOB! ziL!>&3fYzL19#rn>y{c%vt#KmJlR*YVeZRfq>_iK%zGJ6wz93B(pLZYNzMmye>846 zZH;aY|B_Dum|o*^Ech`Jq!c+J~ZNg=WSIR52!U0 zmo(lWYuo+XEN909-%GB=-k;l*U27}RA~!L6)@*gl0M|e$zklw@TI*k|_j$F;avP&( z&G=y5MwA#TqjuihzH79;n@888)rKf)p`V+0`$NI_M($+VD%J;`GY7r`&#|!MdDt9j zbE$3I*_B%yqgG#RIirM-0fE=;nD6}{Fi-}zE48@28kh`T3TO#uVcw$$9*QQ$pZep< zJSp=xz=XixE;8q3rHsFKntY0y(N%tpX%>@39{S|}?X3ps3QNK^*5A%a8vv8H)bobq z4dFl;Z3_%8HL-3B3~hkgUh>!_+L+tk1{ zYrC9K93^uGK-5xH*l`0mh57X0T4d7d^PUx{2%S-eq zg+5XSfL@fnKf8-C*wSfHvp)Dx-Fju7@*lhAX!WI4c1Si_W~k^(Wy;napZ_n|rqNIj z+(xtPbsJmmY}$fd46bBd$RAy{Be9&+Hg3x)58+fFF!l>CO;_X3zaW^KWfr%3CrE3f zm3`fdmLarJ^Ukbrs*gYFNVV$9E7KqPf+tz@BesURj=(mPept?UEqG%8FYaNEfGVZ_ zdiJHs7N>0ae*-jfDc4VMy;pDH}i1KM1oZpQk}7upizlJtoi zV=wBH*pTL@KA{*Zs}8OQE9*D2JA7N)uHP%JPjv=B*UdjhL0a!Uf)T^d2f{$G_2I2{ zyEnqF?*#`kw=LM}0gKpOd5PMU+roti`JRbP8=lx)+D0TI0PXE{HTr)(P7|lyYzvyl z?rqJR)2VK_`1TA@R_b#rZKIA`YhM(8mTBvl`2A#iTkSI3{SKEE84up#;>9)syH;mFOYYhMi zbEV`_JP@4&FjuI{bJnRpw)aM$oAvCAm{vTeoWHRG2VTb&7d^c)e;d0jExUhy{cd&U zOX)&AS8P;cpj_!&{22!(6;>RdrK;*C%~R zTYcB>7uv`h05|6U#{0nVC;9+8~<4X&aGHtcwjAsET8NI9h}a03*NTM97@kbJY$1&Qt!MUU5rx z(%SpG(}TovWv)=iq!I&Q*Ae709q*R01H%q!&BW=8i1-H^6V2)fsa@RGUKjuo(!_iKMu-#z82{rR86$+CM{f%XQ(TXvW=UJw?9RsJuXGG#H8tZx3LGkerFAUMvF)5yG zwbHxURRR(d^%kG@psjf|AP2>66ahVO&g!R4=s|M)e%%dNDGT7T1Z+}U;-@UV9bKvcjbk(outNs{;992yqH0O|vY>DQ#jZ7K&BeD%(l)5qWTSc3T5+Z|}x7`z5>dke-K0*v9#d$(F z)f3uq+x-D^39Z&Kg?ge~O|>eS-KlXv^hSp@=2dl|HOtbTRWtT0xs` zw{15b0ni43{XqEFZuRYv{FBt%5{rHD)>c)+YB#{cKHC#^Y)CTWI z`J3^i6)R^%_}obA?a=_5<3QV?+lo2+NU9a$9YkJ1NO(D(2J1h3djT#*q<;LbP|cQA=c|%b_tImg+=5op(|thBu<+hr}tT-vMcd`-}>;0`t{v^K>Qxn zjSK)T)Zo?N;vWXAd>S{mRARtDymmWdeha{7p{IaFvVvedxGf%Wm)gvs4ZJq~e#!t? zeDENp3jw(gj#t8$wVKkN|5bmzDGNtCmRwu?di}4sQwn7-0d1*q>NbjFU9jIzG797# zG%5E8#}l{Ny@N(2@asg|3GLcNEj#u&#VY^Yb^Gy|jWsPzyaUNGcz$LzJy@5+*d<65iFkx=1`MZz>w_S~L6|8>ijdklQ*(LDHB9m=_ z0dT{~*sv+yO*n0?Z49FL`Cy>{Oe2R3sO28sH(phjI2{`~poa;tzL&k{i zxnWZ9lyAo-5BgY}f7VHx=P*b#eBr6->XjE>Pxd}}#L0we$;ji3JnjeKIxRmqxIwt+ zmq)*_ne3LYq10Q_Hoy=4*!Z||_?t`(^UNHWv)Rezfz&*?#JR}KV;TR}vwu-{zW;Ov zhvYqS>X1*XeU>woDEYdzhPLFPCSn9i_?5G6d~ITm2X9L{KTrji*k)od;bqv|pJ|I> zE}m;_t2ZNW^K0E&shg_EE@qInJx=z}HtV|Yt~sbS;6=y)q`B2b)xbV2ps$pj?0*9w z^+_h48PR^bOX(HJ_{v>4PH(CWy8a$m(EUDm@uGBTSsD?dH~z) zIm(X1&!%yrB(X9f&X@s^3a>gIuwhodts=FFC+J6O9jNwO-X2*LdD1*>1K!3!(kB5V z17Hb~e;FDmsACSanhq%nF#hBpko*S|>O-d~98cn`Xf)@pPf6b7wx|Y+$(zl;h{zk~ zeJpR-W_8)#Fv&`(gP%B0J^f+YXiG79z1F54*y8)*Jk4*~T&BItiK6uxLR|9eHa~GG zG$bX=H71uwj0Kst=J^}*Cg$&??79r%D*D883zjzzSbZnEnzlKOd20i3fn=333bGpIeBV~^6C0k|!a{Y;J$ zfgyw9T1&e79>nw2t zL_a-e@6H7*USw?)vEI>fKHuJd)t{$y@v&I6cAn8&XIm*~LwBOaR)XdBV(^ zLt8jc{S%jX$-f`sH^^=dPo`xzm$up!ZF`>liDEXo zuKPhz0{}sf^P@Z{PzmM`0r3Q!d}_%wi81K^ITqlyq*35;;aqa;!%;uVhyYn=7JiTH z0K0dv=@JVyjd(B~0njz^5B$nr0qp6p|7E|+JBPi_VjokNY;=TcgU^#^;?#^b)QAVo z5w+N7`_Wq_e2c^;WQJfgvkOD!39XI(x#OX<0kFefTiWSHDh`KZ zU=;Q{ZN%_!{Zh*;p*G)km>VxuuGlN}ePGDD>)P~%M^iTcesCP5lqc;xjr~zbzfJ7<)4fZt#R49rD#K74fBMKS0H@q8_YHQjhGo_+lxHeG;LV;C~cx{Vwjs;x29#6 z(v7^_0<7|NrJ>Cm0M~xM7?N~`Ij*gAEqA|fMD6OZGNvm}RT4i?t_-8#W%7d{(9{a($mts%)G)?z45#pEH(=4h;3qU&rQUqoMA& zhAQnH_t}al^`b#{w2&rcc+cI8nYYD>pS0Qc6s<0hHI?R}no_gp%vC3zc3SY#il$_} zxJ!Wz0RCbTEl^6m@j*C_v%VLLsDZ3tQX_Tg~X=`%^z||)~=`FN{h_d`# zXiKQG%h3cIU=g#;gpyF*-+&8*$}FrcVu8s$%f-x^D|S=@Q!ZdUAq#W1gU`Y)d=ss|^5lJCEzdf6qgxw_kl< z@sxg_|K^3yFM|uS>#yvX@40c3nkN<4M>95M)9=~mg>`coF_Cj~g@SLWv8RMO8#c+`w3B!L~hya{^;)!ZNyS;8OwQhXet>kaUZRPSNrEbucQlen5>KS8_A zuUoP3JRCzJp=DT-Ph0ssEf}~&LgaRh7SRUEwl{dPB7bvdG~sQublq5Rgc$%J&3Mx! zOK;hSoUe#pO0^|CpR}l?_VJiw0c%V{YiS$tNIC*=(Bb=KEB_S-ETyjBaEvhFv3Zre zG?~70U%ypd^xr$9i@EcD+Z4Y6b~_9w#~%GMbGyzNW5^H##-#}`;pHQ@U3qVk$<7<{ z1+~qR>(H~5;v4CCiWvad&VhYq7s$f&<325&?|!J%9Ck5~KH50`yZY3|g23NZWhxi$i>Z63#3IEOY)KB2?V^T@21)fcDzE^YwqyA4W7 z_KW9^l<9N(Ft(zI0ETYX_!efPO5$3WSq2_oJ@taj>Ez>6%m@DE^j;@q2&S7t>bfuB`wtbxe z@ZF3}KM0{fxFh40z-!|08Hii*}PdtMo9*jTO z+>AXnTr0f=fD?*i9U-v`9*G(NMgN???duiRE!?DFr)7c>CAxb#NbBI}SfyDrl_5ZnrFwSu-0kM+y|D2n`Sd;*y? zGp^WN!=veWl4whfb=eh`Q6skBL_A6&R(y1)@gYsnlVHx1n(vKCW6wc5kIw+^Gmku{ zrcZk{3HMWmnF2@z5=rDMf1XbJ^+oE{H{Kv^>3fS-uqAQ+paRhZ3(NIMU(!~%Xdgb+UTa+O9bIbfSBTAu zeQ2^@!ZD6*mHVIRYC8s&;;bl>ObW*M%E+emWDqTSNEF{QZ%0{5Ta5OQw&6`007bU{ z2L7mDGLTX_Pgo(x*R9N0+4aEfBL))8TO!LIhJdFiwk8dwUVP?d^~|Hb5R9aPr*8Zm zn#R> z^+_!3*CNaX*_Cyv%mcFQ_8M(RY6IZLMx(Kt(XzO%B&#S*5;J@v7*75oiD33hPgpR* znCzS}ycf0w3=aL_WN?-!g%dqc0S9M6Bih`xp-yq(Fhd?~TJAcY_=%WnD=9SiZn^qk zb;|~0ZQ#Q6>%yXJ&U|#kur!`0qZh2%Rz_Q`rpgR}-9EX43tn zY3(%nQvueDvsx9#d-G*?rKU&~-v34?TFcM#q_}R3cIX@W!aOzhXFm=4)dm3dvgK@y z)PSWZz**V=upi3bY~Jh|_LMeJb{$(2^PcdLG*56{X?58}3dvcu<+2;fKaz=lgGKi8Tjo?zoTEhNl9&@}nO1Qx8p3FFpH8a?Yk~1ScZA zP!#h7CT%#=U8wEQJG5CTZ$h6q&f}*`@VZGd(I>R!=@X{%!iX%=V>s|b^)8AO zmC~l3uXSI3B6SapPin7R;W%we|60$`fqeA&cw0~ii0p9{4N8y;--W-KD`i1Z8B*fo zFZs>2<)7xjkS0c!u4(4FjXf=#gH@N3PXdHP%WgAm6l1Ehq=A4Ph=j5uPIJz?kVQBn!mZOtj^#5k}OAC_hlzG0PXB;GFZ=84a)G?No=%Y*M z=SsBk{&V@84=3UYi9E^eII#DCcQa+zEF_B@q`a71+Jev&BUZqrfTvg+t-~d>dER4O z67p^qVJ>kxTDNYrbc|!&3Owm`WxhTkyWtr;N%XO#Pmt{5XZbwAZ?(o{CIY}MXZX$) zgJH+Iir?*#FR(g646)^ezr$_0K5f>y)Rxo^9~bluA$^y*X(IvowE5@(r!8g`>gR?( zmG-QQB0uXL>+~boVAW_dAr6@~P`7@R;BDjo>Ze9L71qOt_1S6PZPcK}2L=%stP8ke zhX_+bM>=HI&)#tH?V*-r-%Q!y1bZ&S{J`faMw^>g#FLmW^?MIK`K0>Y<(H8jwIHmf z^8m0@U%tXlpmjq87WgN$47ZqW1#-;hg>u=vSpC{m1I60;DNv-?R6N+^d@Gk&7 z;zT4W5n@9o4B7+e(B`qB#oq^5Dl`10Q%b!}+wiC3N_EJ<<<(_FzDDj=X_~f-lUp9X z>DieqiM9mE=u-k+6JqEpuQp??x7v2RI^ zX~MB3eZjnsJw05nHI@+~0LhX1AEE!31Os5gah@K+-@+a4Ikc7WH|BLd{8q@Wi}JC? zKQgolF|t;y8;+y(#=1e9DOqV6mm+##zUmV;rlx6Y0p=ES-%4FsLR%zw7oIS*Oi^oG zdO}0Y1jd|*W-!P;L}x(bnTe<|)>fflaFG~GflDA{Ck8mG7oGq~3WEmhe!sN@-E)$J zp+3o6pmU@6eN5+wXTr1Px{DR-OR5{zJ))ep#AY+}8O#L~+L7p%*3CYjG63{zqYv7d z-g@H@14ERY3Fx8#_EDFAV(0d{f8CZ;sqM8k^}tXQDT&f8wSeaWGM5wUHYQ>K;Wx z^q?qR?dwCdgtlgJ31~wY7sHa&T#LBG+9s#468POGn9J#|s!t@jmUKZg`XmE$$w?Ti z#G|?b%2-B>hC?o?H4c@7&Id4L_LB11JJ#iJ%2y z+bLm|xwE+Z8A-`{GZ2>gppY3lD_sD%P^SV~lF`=k`TzhR07*naR3Z%YG8>wrsOM?; z)1d*d?tm54C2Jo_GwAyPZNnqR3eZ3L;E%iYFaBV+mBReN^EldGth=2+9%{S(-?ypm z?(~XHS?_q$w{0BrWYu*uO<*4I>o)d`aJ_T{!1Wz5U`VkYJ4TliqLg|`FaY-6ZhJL) zyX_sLdj6vP4g8Efw3sEIq77shGhUBm7l~N2vYVn!mS9MZmLm2-yRfL}t}*1;4c1efU1F&O)Gwjam;Ts)J+l1FS8ij!9wO&)fPH>&EYN+AQ zo=&EBgMlllf39_iQ9&paj-6>9adDp_vKnwmWHShN?-ZVlw7Wt0bC{hd1Zbqwr!jQs^&Fa4x80Ep3x zF2sR60F#3eugRlt1(dD_KI@p{tZ`vD01PE6KRNvERWRoP&XYEbf~;}R-yjPTe?!K3 zRoTV+>}HOCRcxg$(y6CA}%eW4fB9k6ER%MTQ}fnmcxJ}P5n@x5dQ9E z%%#{J$0g!E7tk33POs>b#>K~(prCL88L=QNMqw`{hU(<_A*-MU{D5?KQaRvboy6X( zFdmE*#S$PQY(zA`m0a3JO!Eq5$bjY5rE4CVb-@hGIgE$Tnboh!xe4Z@gf?!h@W%K4 z+^+2S1@rr2;U&AMZW{nKe9hl)DWzfRP@^PMbKa_T8zUJ2%PQ4|Wxx)E@H!%nSkNe< z^n$bvU=4sOv^n1JXQIVEv_A6#_4diMi*gU`}~l+womQwoWP=gD@6H4a{Q zCnR;k(Z}`~ZCG}_y&}vLG32}~#bwvz+(RUY8hYjO#-ER4iL`DIIq|rZq>XGW=FkS~ zF5nW`_sNspByAQOWBg6Irv!76XT5M?ExZ|2y<~40 zgXK$i>;0(Wsa8$U<}SF!9*%^X%~FOvEB;0DQq*3qd}-dtej%5Dm%{MnswSfBf>hs?RSoB8V#(U#~iCcsO7e zOFS@U{4W9$*Irhb5oX|o(JcCoz7%NIys(`K<8&0jOj<5&SXSuC-X{3Fcm;d$evICK z;PH>DvO9liOW{%&+o?)hbF$mxbu;elBFqgka8W&cQYRt=s*t}iG8nm_@o4aoTZg&1 zxCFTExy|!wYjvfkt=9PGF`=J|ybcEoWaAU1;p6W)_94V1(@Axxf2&GcvGG7_v9>ic=R^wJr=8U=jyyw#{CNeZsBcq^qN!4t`-Fi@M5pTvomR{5FWeF4$%i3 z@5`pm#ztMAcsxKGl2in-y+<3qM23#XYm0E*K%>C8+!4HvZQHj5dg#0-v51=prD1Uo-gC0Zv#_N_#o0naBt0h@fuoBRj*nD|o zMr`8)B(7izTh0&19L!ammTiM;>!g=54@73lHX2lil9b zm7zYVHU4q5OYlu1w*4^{4VG1Py2Vsvxh&io!lq<)@Wip^#={*b9xRnwZ3S&*?czS9 z{_y+o`(-m8Q76B3eRLvpHNcftU7^q;c+ZLCjj^}sZw+lc;W)x`YUX{h!KD>M-z{{nRS!a68bK5O@{Eck|$#{ENrx;<~=p% zIXs!OW|+TXV~IUeh93(8ZCrL!Y~D)#&Y7EB%&VoY7XZKbH(!32n(^MuWcyRsvdTZ;nT&Ny z(gum@NHhgr8uQDLejNdjlzl4k6o`b-y&jr20Pw8oXBJ;aMZY*q4{U3@-@<7Hva65-u}>5 zN_KN+rj_#6%CwvmaYr?I75h^4} zkTB#~$pH8kG5`qgAS>UEUEqP3yh*alt3pcAuONcP&^+L8?wX)zK&5r-A#K4tNLYes z3FcaoH*UtYkhWkg@Om@LL8NUF=2G^Rtl6sir0+4;S5`!pdei!(Dt}`%NAss|18n?l zoXM(jkk2O=Np~R^{)RWA)J5>ZZ820W_!?A+{VycNNZ}0kIv)=^VT}#(6u|A1b zYnC>q5-Zat%##}?S34+KQJkk#TV~F;n*K{Qw;^0$Z|7p4&+V!P4jLGq1}I)f372}k z(6+#3zrQwV01T?Nt9w^J(m%r!F5&QP<#hv_f{rIBZ)tg>tGinreeN%Vv97zkJp5#U zLRcQj02qJd7}ZvUimUQuHQEB1!u-wU4Ie)sq(@{V)mBsT)Zl(~oACDnK^tB>K2L0Jtn%qr4b?GyLQ+|O z@+*4{-ij&0 zEzD+o!br{lG6bf*t5kP4eY&kyQ{#^q;a2fCH&qZ%J9%T^QVbJi2NQQom}|G! zDao$we}2&xGpR}adP_uXancH@e*nba9s2PyH42FuwFO`L?A?V8CTGcp!9GGdp2!6 zl7QNG<&}C!8_}S6{Fc}(+F-5FJURS8#0EhfI^V;mpOrQM{%>!i8qnn~z5uitFZ?!p z<{Wj+Khib-KfmM%b^NkBn?4=SFlKjh)ic^$`+VKdJjDzEq7MZf=afFvwVchKek+{b z2}juN4}Ii~U>aLDyi_C+L5TjO_#5eOaYLsm*_Gt20#BxBgUL^<8`-N2umk~fZ_-A* zsVcH7U!^VPYyhviqkegVGk-BR2ba?PjQ}ai-_>-bH2`S6dYTYGB$jJH zp(2o=*u_0bG*G7%ENBu-o_j1D@rb2>EeZ2CwxWrpgRO3<4Q}N*v|-gHBs%&(ZNpzq zp9J{Sq5B{MKv2{G)~cZ{`OP&+V?zHpb#=W59#|!epAdt$WZf`7;q_E%%sHU}w4UAq zh}e@cu6ENvn^$oIAQl3KDa@6(IBkA0GTVyot2-?Oov}lY!mKnUyAl3s2@fP>aS<*d zR>50Si!fKtS!=OAA^eTypX-|5(o)rJU#r)~2JHeAZ z)+Zt6)*62vYf%VU8O5JM{Iie&p2UQ$6KD#Dx}>Bha42GJA@EFk0T_WZt=5k`ZGOFm zzmkpueEMtq(r5>(&ZrH5i+_D})QEr|rmlv)f2^pae3FQk&006ki`-!H{3#g#>mvgI z+u+V7VItwSjI~%W`}vu-lB4;na7o%YplviXvXRL=iALWTb=SRs{VSL%txq1RAt#k+59ouQape?QYVx0y2-qRjFl)Z^^i6-oZ2G!C{=0WiMRq!F2Y=zS?oNEX81cHyG~bD(IwFR_DS(q@07Sra&)I-{csx6_7 z%qM=4(l-3nbOhj_!}g1^hW7sdePP-F7+9;T`&T)N83|E~$v&4s8<|tIZlXCN@lit^ zeZkqPtD7E$Ty1HkmK-PygSE@0MeJ57*#P(k)B}*bcyuyWI=K=!nlf#2R=>pGz0H%j z{r*fFw@%o&#X`=_(uOTFVg5zlwiqV`8b~2(Y>~v~n_C4vgL(c#PpY1W8GENwtI}U7s>j|ob(I-y5P#_d+@{5RqV09sPO{I7JD$rNW*mj zlFB{S4sMI`_m%hErEZvfKWTMfT`9N}DCXR8)qwL#NiJO@W&l7Tq^kUl6o(sJ6a0-0 z`rw3tbQumzkzj0y7+~kTcsxV?F;BLbzy0FsxlYl>X~fYsPD8Wn)>_#mw2?fDj5%-F zx-G(783cPmF%p_KckM=0SP*Yw2x(|M})8&<>Dc zihrExTEXv9*=V)W!x=f;RCaLNoH# z$GAkC9%~4-43{`h_AzY>G3J)xQcyL}v0@HSR?{c7#vjH$r)sq!#-L_aMQ~0rbMG8H z73>lbi;Y=+JjZ}%TRD#iCIBf$H%8;x`48#?XbW67_KtWi(+U>%RC zduo!l;jgC?0S`E2v|4=dV$SjW`?(p)e`TxSf_3X#+Q?qGz>{MxkPQH`%YqzCuJ&9W z6S4Wv*ampLb*IKsib6+2-m+VH&h1eeHB z4V;ZGVGsvch9~`vHYqw(hD%=iP|LKpFc(KX`>j4fxD?eVNQM?3ee!&*@%wQ%s#;?= z@kVhRZj|<(Ndk)C#b6eTwgr;z%vtkR;AUZzMJ^Zi26#dYv4$zXlTd0YZQQELZL7b~ z#-k*Du64!QjuIo_vqv0Ih;es!BhUL^Idb!z$OCS%5d$TnIzbz8+WaXHL5nM;Bm-ch z75Unt>krsZ&LD`Kdev<8*c;(X2getU^c_DpH8$UkADmXSt+wj-Z+W?`&qwzV9uqsbpP)r-KajqDTBb_wZBRntgA~g(2PA0FYE1 z>5I*R%LBl=(2n()x0RYJ+`Ba4Ff>m>V5_IJkuYMmydlcTJII@t+DduZeMuYUfhaCv ze89#h|K9$_6B%*RGUq{&ClRxh@g(s6BFwdhWPi{ny@R=4$s-ryDjSx^w{l5}Nd~~iJOaRWS_+KkN{u_!OqWPefC-23zgX!vjgpqMVeXsm~@W55ryFsyh~*aj#J0L)*Kyp^n5 zoHog0M~WsU&wM=C6UDX!ObFgLj_&o^3Cxi3Y~hJ} zUu=&MM`rZ9QgjU;>2uGs8OHA+<1!czx710-rhQu2hs~l5w-p-?XAG&h5Q#Vlt|815 z_NZX*Qq06f>(Yy~_1FOTm^AqcfWSKgAe;nNRI(3Zj_ zjwK5dZLko%h)dzlv#`~a%LDxkbLTg0wg1Bg0F^2sLz$pcg#s&Zzrg(Zha2If3yJ* z`{3OGZXY|+nSlrIJR(E^CVaIl4}c?9&hk{5|Grp@vhkGt-s~8geXndhMB6uslRcI5 zW@#(qpEBB;?YFGm>atr#N%(u&7(RNmQ3IgxyzL~BeNXmXu;namh9WmU*h7^pILT9l z@u0ma@RZ&8*VINVr==O%VwvU^<%4;`8Df^9fbV!Dge%K_K-=&)t8W90U1CRd$e@uv zGY*y>8v-fXxQ+|v$u=0A&t+Auur;{^(ku^PyqER^6Fe~HH`M6S%e=|TzEpqqWY`CZQGlXlugy^EjhSI<6Al#& zC@F$b@Khi1WDb8zvP0IPWS3BqH=Y-eE4x+XEr&Kdwq|*f;03$)p$e9Kq%fDsN0oW1 z!UJ3kvAp%#y3HrqP0&{RDi{F2ZqX@#s%W|B`F=M8!{5$}0@PKTnzX#W)Mml{jQMRy z?`GNnkgy0<{Bydl45U!B_QBT#1K|I1BPa{@JTDskq8V5;1O00TYF~vUKx_bDi&q*i z-_s`>r0fN$E&e`!<^QqwC2)2XRr=?4r?ZD7Y_bTV2s#eRrsMv1XBF91+{RIKTm}L` zWYmBWA_yoDTtEeNM#ptT+(2<<2Sq^K71;?OA_>{kN#Fn6`)<|y>eM+^b>Dma`gQl~ z-!H#(zgM@a&Z$%9`_8H5N_FvQD5OJ(xbRrA_q!(JM3zlLG$9&FB>=b1FMzA6pzgRy zHo)t^zSXe-gUq2w4|K8M^D+UzF7l|}dH)Ps2MF;2kpTQ#^~&Vfyfb~SJKv=F6{;(w z>)5zS(Q0VEC)#9LET*57xjR;}Nqz}s9}C%9wE>YCv(=_Lb2nw&Oq=5kPdaJewyw_k z-0W>l0`MKmsrla5I+NC!oq~62tFB6FtTr}TY=4wl*HV8vS(l9+UGqrpmo&SWo|1{C zU)KobwAZ8I7Xs&9+fQa9KEBZ#r z8b}0SuO~i*{`DmX!~xE!ywiH>ZJU(FEow@hUt&+xo^PDpunk>F9U8516Vl5`ev%_A z%-z1vg%R!axb*;@Wc1za=yP9H_9Xx0!X0R8eh()Z;=2{lX0(VK{RwB?0zQaN7VG99 zk`i%htXt|2j~2D@jzu^rvPo=~hnunJb+lxw>fPhf@G?Ln`iH2D%Z<*5kJT8<=J3Ou zXu%hJSqlPy2HEz6qk(O&Y#I{|(#y&m|@EDO*L`<5_Y8#e*_9A6>LckU;c zF2oluX!EO;x{Q5tKZ3r5&pQs{q5g1rc)g)M^Sz}r|FS=jVRTv^I*+-9LmOpk_f==h5#tz>fo~mB8)_uY{4xL_?0d#2!Q!%W8A!& zJ5g7!&bPj7Dc)5s(*M z09te=^+sct7-35cCdRVy`%d(SGx3=57h1s(Ayi1p3_Wl`KJ&0BH8qf^1?{LOmPr zzn|7#dmT;Rb1xd&W#^O`(pekmv~1EmspCt=*e2Bh==rZKqu=;Xf9f$ll|#rUD1vw6oCHhvBD<+x6ZAxW4)uY)uFwb zoN^rt{>zuM$N+eA8^V5DQw1tmR=OP;dn6Hn`LpKG;vsS7Ayw@xfJ ze_@TWR=dTHO~g7h+TVB5COcVIC*z!LU$(FYI;ra#b!Gp~GXNJ>?*q^xcyDcr zg+Zm~W07I%dM|&_)P+$SuZyKvn;x6xx1=>SsV);Wl;25$jAPkQC5f_qXXEeblr=xJ z##@5F$3PVuNEtV=E(pD(@r~L*{c)2Bz#hfjJj`zJk~j(EwUq!q`-_W*ZckZV664ZIeWiyqJ zf?w+UT*vfW41fuoVgsGVlNNk#+M0i7e6CCYtV`%b#AVjBYt$8DFrjLs=hX5w0FXd$ zzxoq$k!3YC>guR$T4YtDKQU&WWwghN21pE0MmKK;VBkF)Xt(ybbs=hmu~_imeg{e`<_tLKLv}sw-*TuWpXCH&EL5{DsFvq_4hC zXjg8qv$Dm^+Hw|5@j4F){b_aXI)RPRlX9f7W&JUU$J8%r$2Dt=@g(=Tjmy4Le%kZ7 z**l~R05@0@4NFWD`zU4&B&K2(QLBeT(SjF=1Cx$1-)Mi#xmD;-t@X8T`BxB`sW7se;{F0Tj6|9W=+@ELfJohCA=^FvV`Nuq-hNj%>J`1h$wKvWTV_1oX z=F}ByLyWoH$VSqZ*k1)1C$nrV>j^*rnQG7uSVTJ7HoaJvDaRw6RFU z%HfSWWXFE|K8FC5zUfoiT>#ar@YW|-RGJc`rn2d1UHGat6IlqCwHpttvf2qO8@@K# z;XWDHOEbp zO`PVf*rXO2$LcEOVDqG-vh{tgGseA!C*#29X76gG|8)W&t#P2%z3(MYSXHk@ho0BO zNh2|wz|7O?3a!;>Ko*pZrI%{U2F}GT_JMh*nQ|B(sg;wUSb!nq$lVc@Y-{)2t zsp_;DpCzg<>HAzqRfYQAtrCERx!r|my;n7vI6m18Mi6l!8^g$>90Os)9fnf&RlZe2 zJaTb1G)Z+;P6qo`I%TL2f43o>5X5vtHX9{Cw5RH+P1zjY!Zw+hDACbVg=VdeTP@iP z6~$Y2YK&W(vMuBu)|JG2|u;4%DfmB zB=xOu0pLqQt&85I-pm$FR&zvTH$Gj0<=wpxB^;`&^j0DPjl3jh~8 zEaMfTC@+TqWh`R_r{KLjK98I&hu}gY6#THZ!vX~-XaLQ)uCB{w84o)*t+7-d5h1E@ zU9-W^WW(VA_wTMbap=Q{iV;E;CE=unaVlnEoVVMNaSLRjoV7W(!wddL-UBdD6mvp; z(7g#lJlXvS+>DYnJpkihNc#X@XYK=V5VBEmR8RHBZDjRoAOS4xUo8QY>;EPjKm#=A zC%4eR6Q1bOn}Pt8Kax#?U5Yl@+PF1OH?TH6pCt8*4=gey=#Nv^Xv&s2cUfXX)_I$< zS>MQ(k30iT9k;QTt?zT)W!sFhcb{V&h2t^uf&i4`rS0&95C``I;EpH86V$rAwMk%H z#@X4i6QWl9&VZV6^gJ4J=67KCs<2+_^uJ}*>KnCg!8!pJhA>R(Z@;t&DdWnc!IVx27bvg z*E+H#_}l;iIN@K3@-GOXhH^;T@lpMkLz&#u(D2F zUM{!lB-bbRb_h*U9TQbHWd9C4TLmrnvY!Fibqk`o(02U^}IM(qvQv)HXdn65k^!tK~GXd*K4wQXXd1F8%^1SNQ~L! z`@VSrty%BhhrjcDqRnTr^Zhud07J^DESWowDZ?C7)#_oQ-#p|4_R^z@Wq^nsqb*xo z6)r8{^G%t%`GyU&;=)f?>;Dk_+w_0Y>p_}(`y*wCH{Eg*tv>vf)e*q~%7&)WoMR6I ze#@1@92r+y`8NQilp(ZZ0Cwao4Jz3ZpJObDHBh?ktO{^|0SKSM;q5kWP8|oxHhG+fYOLYIE4?8Hl<2<5m zX2D05c_G+4T++vI=MzRb9h|#C$O4oEp#0%;#8k_`(mApwMVnGxe2(Na^4Lmx>>+2s^pg0i6>(CiykT*sG4ec}3%=3}qS zU4PtMTjBj2PqM{qWxUIl?w9=e-x-^X6M*w0Zw2(2ENk++ z?>w%I1vegf_ZYAW$3!;GVZ&YwNl$jiaa}!`sJI*B7LX0ss>*p`7&nevo3fRUhi&pR zSACm)x9kqb5Vo5`w8LDsoNRng)m02e90~=0a5~A&x2WTKcJ)?KX6b9;y#U-MB|VjW z3+!#NcnW9K`TBVIJW;-W9j*9uu^iCI0u(^sI2BNVy>vf-LlOpPvlGoLqYB4EUv5;}()lh*tYPm%W@0$1TC<^7H)YOSCn4X@WbMuCe#I z*|E(HfZ)=aJxzVK%6-|?&pGvAa8 zgsgOF^KE3+N_y;bU$*xEn416_k$!bFu(}(-5CcmRDuOWQJqIiM0r=dOB3dQu*pgpT z+8cHI#;k-EwS&R5B%6}G>&vFh9h|j1i#9p%Bs(^?1h91B!<5mM9)ZNQM28)l1g9Yl zc&;73GtU^~46gC<{Q=-hOvk+b7?Qw`ukffxpvJ0fU@+QRD({c9$APcQ@VyI6O^qW? zg6>Sj;OMfFo0nJh#3F61i~k;!4M-VwwIj0Oa&X{AoeqrK6~DiczJJ@bj#12?LG+X@ z+^w*syO4Z3_+ajLP0--arRK5uk(@}{47l_))jj|m1B(|B%}8tD_8Fr`&|x|J7)@4% z%^G|KL?f%$(8`OyLPa!CoB(iA{pM!Ca)Ds5d2c{juK6ONIVZkKm~27{Mce-~O0tP_ zE9RFhUI@BFDK(pv=B_s1qI0+Jb4wN3y=iFQ5X^MkFIDZBIW*pUZccyC7M!ycnk$E% z;yU0b(J=kh-2%lUL`SpXoxk4UVw+L!c_Y$2c9il6L+Y?IXI z4$;opyUumiJ0(p}eqMDFK#F=XQb4=qCk6P9-lVz=!(vQJ+8u0t1!H{3)HPNwea`n1 zXtI^(oQ1HDM=PG5dPFvlH-N73HnXyva66xeNBGxH@+%{{?jFB_j~x1LnlW`6EXBbc`c;(P z=p6EIh)z2+-$quhqLrV&q}of-d^=#{-hjqNz{V|tuwk(Jt~^ed4btp;e%BQ6{1f1< zf?b}w&ikg#;4=Lgog%jLNYiFffE{WXJG++5vN2MoFnPZ5x*TUE8!pPgci3aQj%-S{ z!)9zWn-n7Qc4X`OT)1Zg{8-I#%NDrn{}O#|F#q$4lK@iGmKa?c2i0()%)4<$h>^T0 z$|jaK;W%UGkpruTJ4{hFXU4NWgABbUTVurht60tFRuUnU<>NE1WRq+lU`vW@x7_<@ z`oi_!bH=;41Zekdni)p?(wPC(6bVK59{3AW;@1xnt=iy|fTgc4vH;q+K}DWyot?YI z5y8hU_^NX?FkTbP_XyY*3Qd_xbME|&E7;N#0;dE7OrNNa+ejdDNA z);68DqdAMV5IRbn1)XfyWrKYUC|@UJv)m~bJ(_U~>4`CaO;5&N?7R{ZQMF}LbcAgQ z{kd(~U+Lm&%?oWB9hxzPXpe21iq_1*fh*zIe)&E6f0m@c=dTsA085WFuLq9FCS^z1 ze8eM#o8L|Mnj5x{RUcj;WvQ< zG~XC#mIE69XEf*DKY6gXdiy5L9iDu=$4)kz@laQd@+LR4#Ka72vJBLErZq&AA zV{2^ar^_}Ay^eR;*ba5$=rq~5&6PS)PEAW`Gnfq70M00-{&Jlf}}&z4VwB*>;_;XL~`_gBT|+sI?9Y1QYy-@GS)T@+;A zA24O_y=cazU$!l++I|mvsnD$VzPR#Pt&iJi$mV4S+t5?_sI*6;qvOW1tlaO8nqNwg zZQS~$i78ulydV85Ua{g7=a?G-!JCyt1H7LTm9ey*dW)I$;Ei8!(@psSXEPS5-TeeX zrmlHt{2XSBB*$3F=1gSHjAODf89ON(*465`1!Z$QZsc?c1d?boHOK8w58X|ly4ocG zQwNEjxn0E>5fcT~a-SRe+gWik)2gcf(X~Xs{hR;v(j(wjz?!nz+QjE@9!f$gbA^aL zcjg!A$mug0SpjoNQ1!k5`yK(a5peE2${$?`uNQ7CAvv1?3YRp|LIDba* zC7w-6eu?=$XG0pw3qF&?dSUX~2osEwN03^7EI$!sv;LGtH8I(Y@j7}^ z&c2I`z87U_dv@cLmobJ2w~XK;|-vd!b*ErRTXfFT4XLjYF>n|%bc zj(;xE(4c!Nz{@yt`)2!!J27`PUJ#qRDZYgJ1t;U!g}K}Jxy?ys@MIGD-0TE@1E8Uw zzSk)*`C}{tATnMp+7zmk*dvejC1+}?!tcboI71i3Qa+SCK#FXkb*q%;n}8u+m(GtZ z1rL{L@^(SCkgB8O#xp)09yi&#?Rw*Hm)$|1z0TbOFnvlR1K|A#_UY`ALR(cHXVl0U z(W@i^a5z5+AVgD6TT-Olstx$|x#Ybcx2XHcI1r|4UxHP;e<18aKRA!>DS#*Fo9^QaU3k=k|U^JvM&&h)10 z$wnu_-UpQnL^2C8d9^Xtp3|a_R9(mRXSCX1sQ0#Ix6{Sfvr_;=Y!jgIITgMHO&4r5 z2GyJ|TqzKMSyN}w>92f;d@pe;^R3PtV)Y~Vo4(H&7^Jsv^Y{h_Z}jg0*sItBkP^6o*xqDP zmIp9k!PSxCT3~S*;IL{LU<_5f!fuwJahcGR zy|$sLFW+GdCG0od*TBToK=vLv`Y)u76MzsKDr*p`DA!uxJ1JU4hLl=QQ7#mI@pgF| zyq%87=ALSD**m1SxtdI0rCYfqJ5*&WmE!6-ifx< zDcP#N-hA&L>A!w?nWORICcr(n5l$tsaY>2rgPXotwxIa)%Deo*Us@1=I^%}p;GINK z?8ScU&)utkdJ|oF#SN-=Ty*9!l&>GA)ffEOzDl@}5hxr? zbEj1|0al-CK##lnOMip+XYyrfG;cNqu<@S@1mL_wkFR#oLx-#lvw5M-1##R&zV>%@?k2rvB|ELGA@X&HVt4=-=EO;DEpL!l41mw%?kj{knKf zapPzG5WR#-0k~Z3nAR+OFlp>GckQ` zc4Dg;fU_3fMj1U_#bynUG{1tAG9`Qp;hm|gP9Fpe>X>XeN&B+NqXGd>tHb8q;@qaL zfAFUp=<+{Y=X7VwneZ|ogSoK&@0ebo{nGzOmI$%oqI|IrpjZlUKhLNj0kwXdb;?+- zPp>%*{F~3`Yu3~1PhV9w=%xPIodM;01ggCOCOd%H0we@OpM5V49%haX60P6-2%A-C zY(T8q%LZuh<#TB8*~KwM<>#0W6Mg&xjW5wAYcBbCwfCTXmwlATXf0!s@0zJwMW^Sk zbD?CLe!%Lfwougr9hz?*9<^_izscTv&NDQzqH4>FEPxkn;7voU3S_d-S$L=}J7FSqbxJlqK~+6w_*e3xYm>H z8^8VuU32HJo%ylN9HLz}XRrTNW{?5-au}ntsZoi^7I==i((BKpWq?D?GC*Ly8Cy!S z?}(?%h(h3h@M~T{Pv7Gy{yiQU(a7?(wD$AYxyu1%L|-il!0UzWtA^q9Km+)z>_GMT z^hdtyba?&zBiw6=@wj36Vj`%cT4os7ZHNYM_++!5k5(@x673tWN3IIAVw2^V*0V`3 zo8`=}F8L)M(2S;E>igWvF#wt9kk1W8|L87MZ;+pruo19Mn3GaArHpa*;#yCQo$(Pr zSSy4}>31rlQ`gESuxvOMDY^`eUE=c>-}qg+?Sa2IHSI8$=t=VeQF9=LZ+$gHU3STp z&p04bh%G<6(-&;%A+Qk;WsBKUi{GDl$^|q$yiwKgqBBhDpB1V4HnL(Zt@+#y_B{a} zsF#s{V{d@X0u-kP%-(^LBs5<)>=S?^tM7~U2dfQ;g%;sm1#Is@(bmxF3vGut&N-fF zV@}yt84bKXqipjCgG;n2b)~@>w;HJ-X%tfX67rL+%s0)RoCvtrWJ}C|O+cTUy;o2F zrxAcN12+POqBbewxUXo4HQz(NX=?k+Yy)GL@Jhf~f z61537aNgBlr91zz%+c7B<`eBWSA7$Pr(J0;fD^?jDOj65VEd$gDiDCz?D2AX-cHZ( zJEdh~+OUCT_dP_P`_$KU@IU<+cGHoNl_=ugRqJW(XKyTz0hUJs&CP)oxEruw`MH45&X2i3Kw;KvSq4_yc=B_~y%(_h!*(Qk3%}#2c02H~m zS0>%l5sRjK_4`f(o>!ONaMi!n5w4^%eL@4=h3DdB0M76Z7ZU!X2a60+1)RUAtqBWqA%CGrP&4K z!OIBSh>GYZ(lWrSfB>Y-w-&}N3jQtF_lA{gY51aB0PrhthP?pIBZ3C-n*_mLFl3Jm zLe$T$8ZKW^Y%U~%%tCQX;m~8BBpPTA%ElQD0?@dy2(uJGE}(vsrN}leYFgpoS&a-w zx$ofrHcm_-q7UES{2u2CjIXzWE#^zm2XH&I(W>HKC0j|IZ=tz6*0Qx=-_E|99`;Mt zfLfSuM#k(v!_mJn$0#|>Ka#KyAX-bmKwksBr-23EImheNGq)w0Gp+hq0C6Rw9~7>v zrh3rv^}PP-%bzovE*by;AOJ~3K~&t~SGN=iz$mCP1pdW_zk`q5r{z|!`}Vc8#~lSa zHlqG=*FL{C*hckLL=J2C&JuwIY>3=pxqxphw6_#)J(s53d4`o?(~K&UAT2+bn+)b9PMb27&f5P!MrFQz{Om8#iWMtWpR;I5weBxPeSE$t z<95ymFQj+O-@B3ax8PqiX*T~=?-VE__-2&PuNby#{N*cWo6&kB5@#s>8`2C2o%hMT&gcj*fyCpkWSF3%%=Q`P+PS!P%W$T2VoNob_ZgI*6>T=YmtJ1f zJgv|qBR0KXw7<(1l>OlyO>GQ(w0W74r=x1L&$zcG?bUmzJsarz+rl%E0j0U*OqiNY<@R5An@W;tuiP`O=~kFe-aU0zl|sY~jw(WF5DQ&-Ef z!O--oYlR|AnT}P-9I!6J9W6&iI??zufuX zJT8cr2bt7=^HL&~Rj}!O7wpYR0!tLk`o75~oVO3rF?&-p`Y-B5SIV5?>G$awG%<1> zOTRRceeO7rtwTOHdw)Fo=dL6@CGijgX->8ZI6Hx+Em-AIrYG2kw|kk z1ksUv&YCf2ERSQ3%H_M+i|=@UCY)@7o-|$K&b4tdZgp%RqXplCGu@S4yzEKt;8BR}nk64^~+Nd#bB;nHW-_QxJgr-7HGqFEx!# z^63(P$InpT0sBrmxyJoH4kh3J)z-Lm(dSaWDSQ99#g5zP55jGAMT~FiB8lNi$pb<`?953L;HGK@O^&?pv(Xmw;q@w{2qW369Xi*>@6dc zro1M}4}~ni(gW+>2f*_YIbCFXQ zPhSfs4Vw1?G){fW*9G(U6L>EuvhO&+ej86apFYv=LEq_-cv$EpI`BkqjrCle_3Sx;- z1p8ic^cZEC;-QEHWx?{Cy{4?2d;MYSxl(_m5tU?+`e{Cs#?3e{UYC}+QR~viEnov^ zom?lPYzca@^<=c*`+f%C#a?NzT=)<2#uWdWD9lKkV|mq>UYMAk3xS8kaj{(9h0rPhqhf^cT%=;xD=Koh0%6+ zd6XKLO(FoVKmwqVj>>tP2wu8IoW~_)H=&DmAE^|;R5D2f;5j?&Mn^q;->NQ-B9-0( z_MHU&xW*P-bLKjS&4h2h13l%J`m)K?GCto%j{q!QJcXt_ zHr(*dg4gmQvVb%G+h1urt;Jf~vkyUB)jt&bdcqlh(KR=7$tLwJcj~7r6j& zDg9BA5kbPdOSc+SV{_8|4(zeU6ICOUts1n>b6Rk@zXb4#og*)BtFgmh%>)293B5(| z(RD;O3irt@J;3Y(V9Es9q@#%;@IUOx{pe}C?NTYcyL0!FuU}5T|K07f&nq?se#o3g zsB4qv8b=1yp?g9w^HDgvWrLJ|WggM;=0!#g`%*`@(b#F#?tku=JexH3HU_fUxzeHe zX6ozvT;N!B@T9H{uyNbC*-*B4vHlh>Hp3zo?9a!1$q9L5AyZ<$()>l?*)t*&mdXpP z$C*^-kCZhotv`lwA|pWL91Gb@`w~m3)1SUy?d1mvo0HDscYnI0~X=fxj<=DgP+PG}|nVymj!^~=oYROiOz9_Ts zeuA!!TZ(M3E6{XGEt6d8c(2XVy%eC`*}XM(AVTNNTui&cvRV84aU9fyi+ zmZ(=Yxn!|^l^>2q1#$u_`ci(tcq^SMHHyo)|JJ7u&9z^C6nL=Vl` zPMKirb}iU!v-wtcyf0hl^CL}$OE0&Un~J~Ft8 z9@zd5^zfVqXvN$IY3=ltw03Zv_+ld4M)eDqclxI3G;`e?+HCnYwAIROX`B0=O4+6< z%?pM~q1bqP(K9GbjnZA|V_>`JgP{`&F`H$8dV)zO9r$&+h{z3QkrOTWp-%wzEiwQC zu34+Du?GO*###Esp%%6rpmvIj@g9CL(afFYRcDRMVi0OfMVj!=XFzQD1aeHW`ckTI zhvhrbZZ{o7gBzzdZ5#AYjrax@1{QRfa(=}KBGU!JJ z1~Pj8$;Hx%Hh0n9s`ryv`xXG-8cB!dZks;0(fjVnwt8?1o%pmD(giy`qo@3LN@qTI z>yPND`~O7K3m@OEO}5~3>qh_Rn^NSnW%3Uh0uYKYH5My4eqh2E@3Ch_sN(rbPR=}t5(o-9YXSV7agzFggg|lp@{KQ5&DbWl zpH}+Q?4w8kp4=3uE<-j!E?U24#*QYoC0hG(qT!i7$n!{Do4Ba}Z7{(Dc=G`W9V84X zCcU)rBFr!f7h2E{>+2ulI>uzbyAr_y0G(x*VChy z7cXkTwZuxlJftkEb(1sAV`umbjGI9Xr!E9+0fU_#_JR$Rk7x#t847TmHYvjU$?IbM z!G7C$Vs_F>dU9ox2*7@oPq!IdmJmRkAid=T%0t^PKgdx(Wq2X!tiYwmTs2*%`$!YqYfET{-S@fcpJO{LhJN{eq zOGRZ%P7UuvD9S841(#nK-E(Y`-=bJ^?%KK38QGlEF-F(UUaL;c-Hhh%{|;I{WZtWt z?(-&F$-|c2PT#!gd%lln?&5CD4X$T5#r{G3F7B@>BYQ znBj}+D2@{juWeX@*nIVt^z5I#i9#e`!EtY)Idf)J`x1=ZwPuqec}}M<(Jv)3f|TIj zj!oia5GnTEk@?03UCLTu+BsE^-Fd{13Ro;N%#ElVz#50pMgeqE2R0n zUD~X?m~lX-3%_GsxJK{oVbIcB;AF&I?jhNXN^M#J_Cny=D$#-~{8IpB27m#Xo1BJS z92nsb5k2~*#w+UaM*=xszgS+0^sQ!C#VTQ7GujRtg=7luhBui;w z?v~X^BdXOUz(Xb5j{Cfo?wv8GBYvx2NxBAJ{_s8YqwBs^J>ZU8wz%Hz|B(Ml?$O8x zPsryV_zqgpPxB<}teXXw{qQ2%cI_&c6gbf^0HwqJ8S>anJ?wsy>cMCR^XKSG3^Cwj z!#XIAyyn$=?DOJJhh$);fH~5DY#ITO*7DJPmTr6&(LauA^h*Rp0iZeE32xvE0XM3H z`E`{DbfQ1tIaCrLc$XCYNKVO)gCf*#Upa-=Kb+B`lZ&XlGz!U3Sf;G1tom=sY5HCR z)2BlZ-IxA(x2H5C|CoI{n9uvf=aItnoH0OpUZUcS{10(@DF%kj~m=a_!3RRlnR)zs8IJ^hrQVtlh8hrd*qNhEb=#c{| zpUZr55D?jy5&%liJD)-KgJlC?YP%fkj{)q2a_t@+H28%9vnpR3{n6&u3$8ng=KOs- zYlBNZ9FF|6ETa#+zdGOVRobpiVuf|)kTidE`wq>wsRtiJ!vmA+sCBRT-H!C94e<8} ze@h+eX8~GLTQ5J9U$QhYB8QL+BO(lA9sd-L$V-RiMCokF!L0GB(N9GrwC@=QIq~P` z(}qori?ar%5bb%YKPnELXaRJ!Nfu3;S8Zv8BRTURbU*}Nr6EpE)c&CA0(~#Pis(_x zf{3~dTwJ8hv3?7w9@zfGrg~Y;cuN!Q%Z18%>ZZ-4ReIaS5VZ6 zkR*NT{aNtSkI|k>*m`^*&1`WiB|>G~r4HyiK$p@VcpwPSEICrAPqAzUtJ*5H?fxhX ziq{+4EU3-2Up;5YIkCFv{pNgsXl}-AGBgKp9`N6>&GzTp#w??uLsR7GeLvLip{Ri? zXwMz@ZAUlS{H#}JKMPP#U*oWJaaZ=nGBW@sgAs;viw&;Hvt42(nGnJ@^EuyD#@9FP zj(%{SVg$yJ6EYNEe98H=X~2DBrUY?z@Mg3kpT_3Jii zGhf`kQ|24?>HjV=nsV3zs{5{!ap;ozU2Ze_SGaWxdhHW{7L+!AA9=!>m2}tTpA!U- z)+0mF5_jX;dS+~q5sG@*TC&R_yX;`YK6OJ zz`lSaaEGpmTD)D-4B0I93-${*e?=z^*KVkk;J*cME4HE#6 zNQq)SvQd3dJ}ZEiLnIX7_Q*yD0N&~*lF3Nj;HWLJNEs7R=jOwN%!;Vv8WZiMKYTk) zTf-x4q2VsrcXmX7GhdCNo0vsA5dF71CtStea!>Ih0=PtVV(PswRa^s)eCI;ieEmB8 z@)Vv`4K21y&3QKfHVR#~_t$9Iy!#r!FFa>~g?$$Um#VBr8iHiNw4+44wfe(^5{X5q z9h6xp2SK-}Jl-Dfdt3cM!lR81kS{eOpy>!mW2?&ordwM*@_2gYRl>dZ-mQHYu?N@} zw`Ga+}_nPli z(lOM>)PFNWFND0>`e!rz`|L{_xA`SUjsipQqH1M>oAYP{SfY_IjC)F1X)~My+%dv| z*^@vvqm(gLHkE9E!bB1Qeb$JZr*nyvRsBsRCgon!P=g6`a{o(CfKrNmd-ZtiSD>p+ zn?L9U2hsPoeNsYi`b8#<209e|w`u-@y88rR(%4`fK?m}jHvO-1@e0r4^YAXPe*4*% z`Y-aa;Ke$qG2JNerUG36P`z}#lA&-&43Yzs#Q+@>s7?efwWI2Xd5M-%+dKIzJK5d1rz0q7HeNoS9(3Ow@l zrT#j-yr<7L@#!k!cYJ>gP|ec`fDzqMuYiTYH6F!k6HH1yw-d!Ck(d}UVR};g6Wef? zvUCE9Ns07R$|%EJek>6pZ)^hkscYjZ5m4;A_;{cX{B_klIm?d&0&q4Fy=P2E=XbxO z?E348Ry;e*K*9Rxt8cRzad(=l4$MPR;oyQX7+5N zxtme`+~*Sg^FOCOGkT>yN_*~jVkfKDd}VuWjK(s+#*IXO_#&Lf&Tqq(Wg)WJ9M+0VfQP@m>^d|v8LQEtUrqB|ZTS~Kk2q${7k zP`r%yaZHzyD7{vFDSc|;JpzQPZ?(|8JZ?*=zd|fA-a{5&h{;b=5ci%fI+Vl)vajt;#V>d+s>3 z)rYm`MkfPMv=++(tXoIfnP+uco(Wf9{-!q(J#nWACzmA9C;zsi{Wx_!UVTk10{{UJ znr)fiG*XcgEe7h4B2y?{0{K5Zt`W^!zzqO1UT%bSOF(Ub4`h>~e%qf)QHEe3Kzq+s zeROoIwF3gLT2FM#{f*1-JYa^(Jc1MOVj{_79|mneD9fAc)TaCc2Je{^^O^3vi?aXz z@5v!+8&c*cy_abE^l%NM5dCYUxD8R@Q6vDv!;~#OpQuRj^ncpcK>o%z5>Ig>RtYPaN~ zs=p)>&{iRXsB0l};bb7B{%`^V-p1&v{J;9+v2_hnpk*~AOP7e17SUi^n&V5#FaSYn zXZGDNcmSPB7q(MHZ#{d*os@m?i@nvS@!FeNvnXG1EYT1o(Z?MDD16BwM~{rxF&J0< z-eV8S4}R6S>aywVCm!0d;q_tjmXj7nhuiKB^n|pq1&T;psT<*n`u2Q$Ls|!%GNOS3 zfZ3))3yy&lzXfv88ShUC=2fG--9pzz+x*882?69nOAcJNvMlPFk%3^_rm~#q%D+}U z41lgATX3I9$OcS13PW%Rg3*28o{E$SIbO2?*|)z#bnC4tBKFI)se$~`iv}tW*=9|` zobPyzP+@k+(aK5g(QLI}cYff3M90{Fqd`v}?Mb-qHhDz+2bEgk~_({~1> zLjy#+ZQE2m0y+)|0xDvXlxDZf8~}u^JcD`=mkWeQ9>r6a7@!a*9hM02y#(wTQ_jmk zRDCLj>)N}BhBxXrO!Ej{;5bdL$-d-ed0n0j0a3Aptc@Ah^F-jLUs3k`@3$dg|It=8 zkY9R{WXi2p=R7xR6_>5-^Tt`(%xR-|4zD9RnAnwM8Re&(+%qzs{kNyl^jtOx8+{{* z6nc(p;0~w?e`p|p>_Z3&n_owOq9|CT^rug008S@i58Xd2_Utx*{@-^#c(-mJFwYBrnB>)BM?`Hv0#<^={@;Co0 z(G#A~wf0OyTa4UCANXk5IP3svUIkv)f&hcKR8zH-Q95GD^2I3f!QyiFTdpTc%t`59ZanQ8#Dm-FH*= zh5zbii~Y7D8W_#!U$ozjkI2DCzc9<_s*cy&udsa$Joh=2@3T+)^+ak|`k;{RXV#bM zbT#KHZeBy@&H$8m8Npd{;zhefY9Av^3;GPaEFc1)V%7rF;@Fl{x2a2tz7cq_O->*} zvZbu;O91X2FEo)n0J;{<9HK=;KfT@G ze5rx92>3wa>~pwzlg$`u?4>vUrcSggro55P%Rii2JgwZXe@)q?-%cyrFEwTw813j^ z^UECr^`F<5rM#UuTS2BXnJ)5Cj?+T(k{CP5wMBw zv78lwt&!Vj1;BB#1RTr(1SQ}V+lCVYs8SB{V&q>u(88VsX(<8$mFp4-lj)}PhPi`{MG?t3V^{ukYCvxV0351vx%sU;8XMYBf!Zl95&D(^D|^ejLKJ&?ec7qeh2 zfF_nL$`uiJaT$;EIodCeP7^P|aUy1jbWLz$g4IU z$R5Nd+Nyyq>DAfIv0|sH<=kz^f zZhjCf8;H`J=RyDvVB&yG^~Y1UCK@PC*%m*-wYeUES4F*OS*W}yqY)Jj$e~SdwrU>j z3UYfu569@*?T;3LOCZnnCIO<;*U05Yk{;{y2c4ZE6C*j%&&}q+fDNVEnk~nK4UvIX zrg$_P@XKFPcG=~vR6TmnJo}lHPm&u=QK3BEn2Rph6B%8Sf9s;dQ|f8AjAond z)+;`rz2;qce$WA<^P+@N>2Z%$`m0+h`wQFd-0dz3#|q#1kJr;K>#DsfLWG806b&x% zUVj@63Nmx&8v>l-@dEfw8E+#T0Ij#qF73uQq(C4n7^NBzve7ns4#mZv(yxW}U0I0&|@EnD#=9wZjrEbH22 zovHkr!57j=^gqrcy>M(V-{r|fd+$+4lzv&GfsGp}`|f3wf9+FU!{x3uRLc0ZAAEvx zdUt=sJEwu{+8c=Oy{~f>)~G3e?}_xWN1tM!XbIc{k(UKA@0avTg0N5XXA(WmyjVwz zI01PqK|rtr{lubn1C0E-T?t&Yy#^9^BRCe%aYDhfFb)YxICo!)D~yXnJ`il17db|+ z5{~LDqF?WM(~n9ij?T4gl+yP?Z-4$9(fyA#I}vh_MjwKCx^qIPBt}qEr{Mt`{zTbX z#T(ei;Ae-&Q~vztj6uT_xXFw@Nw3-OKe{DhcL_it)mMMeza4NiM|agK%D(r5(QKit zd;2Z^LB}6PTvX$s(1t(Jza%rMD%@2hRCBX-bRHqHlKs~q%%KT=+(n1cUmo0i)aQKu%KeCD&mQ%5CUpa^ z-LI>d+||a)f&I!4PopefG^q!<%fe@0`({UP^g8?Ki$n=hom{kBU`e3#(Iy10yt`(^ zPuYq^vZkQ&irf%bNSoqpBo6(Fk^v+U(sRORWxtq^#h>2tL{TvG`d^8#NTfzt8t~ey z+VYMovN7_AR_OR3^wEk8<7SUXN_!isdd2<-1V>w{FrS-#|MV}7hc&x(Y*HXsI9Zai z1}%E!1D71#InPoo^}VJm%g~+c^LVc*&z8_p`*!u())q~zO-=W+0BtI;jmL{)idSCK zas_7r_-n?aMbA#7vA6d@DCkAE)pyqMGHG@#fFC|{K)J@oJlh2X8|L6m%Gq)9P{!Hq zA4|X2e9Iq#l9AT{jG7TJKq%-}O0UQ2v3&@di3 zvLBB@%l#&q2C}bTLNpS8Y2&_o-%Kyt<7VgjTfh)euQ4J}e6L-SA^{I?#3_>z73cRY zAWH;8%Pg4BD^!tE%Gx?R%HWX>2t_4ewxG?UdkMTS+KvF8NPcX(qM^l<{z$Uf2$sp_ zkq1LGxXuHzaiYNWqmmIAH-5a5J2@{K!HIxk18D1^jDXXgq;o$1SQ%|jNu)w^X5YMa zFZ$fi_KN$ufdR^2Eg#H^Kin_TQ4Qqz%ju~7f6~!96Dk{<3_#Jbeik5Mc)D98`{l2Q z{(7g^=ttgqksDFNrmv(+egrG?K8l?L5Ta_+(I;1xF#XoifKueFx@46rFsQ18?f^eDSuXPzbQ0Tz6n)s45EMT z1G}rw#Xp-uPhCIU-A4PZC2QdKf1>QR-%tVmAtz@YehW@cVxKAL)3QGq(axJ!5kFLf z5h{W;&o*$UD@L0p_0L|4qt(R$R*G0X;(>t0qE88w%~;@`grxo?>>04_Dd~LMcO|>R zWpl1G2H6Z5!tXVpv+MLocKCQF%4Ux`;`4&-7=nW!ZZcKePBx7YU0EFGX2b*MnPUgB za>AtG&zJfO++>Mu7bGBm#?y(O);z6~>;w7*yQ6_WP8*`dFWK0g#@tpUAKblu^s@ln z({;_3b{PCKy?ffR&dYCtM1XmJ5!{6eL<5Xu1Gbn&G;exUnFb63m>Pg{zy|tVI(~yr z%uzd$tpwB{8wUwgjkheK9aRf#lnX99G}Y4hjq8VlJ0G`zY@QBSH0$lP5P%v%Rn!yc zpOXTOP{oLg(+)pr!sIQ>wy>w*zU4%JE-t_foMhp)6`W5IA`n_W<5PX%{pZsk*X~-= z1N4h`O#@>T{j;gxHF4dB`XpeC6t6eCc*fy0J!`&#+Bn71xfy_A4$8qz;X7>2I>H!f zV2-$m;C7lXpHY|6wb&;K!0m=IQ;^AqfF@ntYc?Trpt5>m;4Ae<12rk?lfcO%H2`R# zapS3bGZYfYJ7W$PAxQvk%6g|J*beaefoQ9+e_2xIFJhMKaKz*&v0Lk_e(8j063OXN$kDN7I&Wb<^% zo)MQN7yMH(a7Yb|z7*}6y47bmP_yHn4nb+(?H)1x@Bsz+Iu?}h=8>ZLpJGFxqwp5kk z+FPoty@&c)fcEs);?r-KdKx`#@LKU{FItHa0Y)jsC5c0yX~ zb$}2Wb|T(N3sPihKC|ToS;cj2X)|A7BOdRMHU_*u2*zBmDI`XWlJRI_1T3*lo>__Y z#~2?jGo)mDL>*KL3lTA|KW5xHX^3ToV&60Ug)R~j!8|~$`FL9$Dt>^^m7>@$);ymU zFYD^Xb1izQ3HVqKME{!q9UEfWE^7b7)0-)O4ql=|QKD_pkQC?T02+{i z;@9ow5=|+?Lx{u~SbN|Oo6@k)xGaHDYzU~z?yw_&WqFq3=4-nu5V2_6*+?iXi+I2( zY`8Q1LC};ooQYAa5;^lR;bci7RO*$(W=tce7|cdVv2Fxpg)Di*O(++vTLOLQ*e4PS zLxKVX(%PCJfARRbjYQWKS8XH^VXP}Pb0!iA?2C|k>n{m((dm{=<%iR2_rIjutxD}l zLE6~$tDgnvn(miW;IBoPQDcc++{0LbWN7%=j`N!>YAIMwG^C7x2jG$O;|TD!2Pu(V zAkvg{YCnry0%T=4ED7{0MXws^ z;^f6U(x(wqKAy_jzog6HXNELjeHqcus`m>7H}z>~F6_7A_JCxV&t*xUeGHxZk50k~3<8_=Jfn#b0mb2(wu^QC!7A#v;Ac((DBx}TV7|x5 zRsz__J@pnOw6$CYlwR~Hq{_=j%!WP22sn6oYtur+R;q~W62Jv@f@5T#39Pjj<(-R# zByh({>+I0icKH|e1x_(Y%PAr$s_Nm{lMpC}mKPiXnLzT?DjO0XD6_*Hs zZbK27B}?ETQV6_Qr!a5(Bw*BCZ%={$=yp;8Z@tkQA;uAy6XBZ!5-nC;*X0ZU9auWgVm1k_eW)@PF) z(E7yXM%(tr&Dek;PX>Q+95}!#L?C37&ItpouR1X^V1&h!0(IsSQwEo_BryA#dbEai!=lriAX8%v2S5OkTJYW!)uOJL`*De|~EL_>qk z$Gpf6>NC%nK04sZoHr*1{PG^`rWQ?_bytUs2(mdk72Vn6gBb~UFu=LE82iSpd3dW|M1%iEg+%otX3e0U>A3=eI`$7%}WA60qVi%5M2J(ZdfnK)hFercWo@ zZd=Nqxo3k&r2O<4_=jvJMV!$q^VJ{x8xei30QKz0KOAh2ra^8`vMht<-f&-TGH~t}P%rjpM=aaJ+ctHX7Ys=t zt?3hQp46PWwbQ`-wxp1V-f-tv=pUP4W6o%KsgE| zkQUA(OU7iJ%B&%xc{2j9q2>X1P6$*YXvVV!sr=*Lh#q*X(SkFl1RE5~FdOjZx4;slx%0glwITwV4+hi$}8l?M4oW^&R>65oU{aZ5>Qy32p9Ko9bzPG z)545+U_{2pjknKrZtGWwgV&$RO0+Bt2W9g-_7OqR>rZH}g+#8j{s4I>+m2k4#K#W! zRpZhpA!~%PdEgnbNt_qb{L$>j_7gUa+Is^G5nxJ{bZq+zUrN(dn!8fD8`i#nPFuF9 zhS#A+M89%Xt!E~3;a&xQ&9C>&SY(GBeSdL0yk|PpV;#v~{6eB_9w+wdxT$ZUd9j0zny02Z#X1fW$ap({(Q!z(7VLJiH!J1}POU z^@nf#Gkp*MFBL4j{=j&vWQlDAEdkylc=LA)vH<|+AglE!N&lb+?2qYMvD(UQQX?l0 z7#rm0`!l2^9X2K$oSh64vq?u6@Q1a*>a$dvv{wmB^Ehx?2Qw0(cM@@lK0{mpd)oWP?^ z^55-~{6Z@P0#v*}fY#+R>F_%)A-eZ|%C5aW*(Xi*g1sF5t9H^;gZARZQ?hyY4fj-^ zdbl&Eyy4<14=zOh)g%w5|5((DqS^>KvOi#(IgO`6;ANsVX)T%qtmA|M=v0TQ$iVyK z0VvZCW(1r*RewnBOOc%f)b=yw%Hve9u>CUNZDintfH`;$I-1U7<0yV_Didy1^njO* zm6Rp0fD6RP(WxL?a<(CIQB=z|AVlY4w#&$mGN9hTCNUczI`7a?T+ZZTnL$>*>_(o^ zL8rg9hrM5KbuC~1_#yiF;*Gu4E4Md-S@d3aC-sKF8pE;Z^`E1G0sp9s6fH;&#Fm2x zguozphd^<}PXjls-vP?N-T0=TVio~N29M5heK-iF1}GV*OBn>GFR))hB{2YQsK-#< zs5|Lxb=vn55IbY60i6WEY%d14i{ft)U{g0c^7_%<7zs1xFOoMPIaa@@a}Huc-KtG8 zfYh=TI6Y0)O3OZV!X`NhKmsUT3C-O{ko+^!D7l`IkpVjRjJMSAN|U!}uSfqPiR{(k z>XU%*$ejF!i<$+b=)>_;)gQ{4{ZztW!Kg~ZZZ)gf2yU=KCnY*+=vycP#P-m5ML=bn z!_fIUP7?_LKPqTarYw^6z#v2(1lc4)qDGns(B?s*KcUTV4%y;PUb-bwxj7N_&m#vZ zy7g=TWGOg+xCu|`k4lCF(6Zyh>f-(J?1>S!vTBw#mq1?9ONvdJW0sEY82R?<&WNtN zi)j6@Pr_JY&ZYnzdz1Wtk`0jNiTUi6A3nNQp`s`HH6Fl!ToC|Tym%nH^}bDfbo2Rh zh-S|unmMf}2EOb>F*{eUqwJC8jr%@F`R4<#znHQt_cr@+P%+)$&Kn(_)K$s3W4SG6 z5>0`-Fud}yG^^nBjN>y7*Y-UY;UVBMaIkeL7xg%8@DmA8mzq%s+_Y!MLRyoD$W#Pt z03tp4@lTp;JJNA4%DThBTuLB42~O)k=UQeZI2-vK!@l7 zIF6fDiu=~exovaq3qF>p3BVlc>EwOUfe^s7U=+_*~TbCR*Ti2bn57% zX^UNJ>9NOFQ}*CL8fTeW{8@yNzX2&$7mt3?(P2?3J!s1sr^mo(tJ#e}1AU^FF2zl9 zUc{<6GD{}RkuU9xIIMwNM~Y+sNd|Pb?7Jcx5*dD6Oa(?ZqtL0Njx5133f4{$2w)M^ zFDDZL*(7qHk{f0;X3Ql3Dn7Ft^H_gW8-Q|Xlg>K|;MiZ;PmqmA(VlFA-2`pc%q3ww zJ)2ZEd0IdX=l}@~e>Z}35fZn_pWmKF0-Sj+_y@d9C8KsxiADkx%gr8MPV|rJHV~!E`(IZ@{=z6q18bco0wb@xdQftp zwrKUGN%`}%sC`zt-d0&BHvYUME832IbjpE!0|>g-!7}2K0^kTTJgXr^dt%yGkOfJV z1j6Fo_mTDWXnz2}9sLNI4k_bfGYvvLNCH&dn^PXj>z4UAA>WAhCm@@r7s0-{Yz_(1 z>X!BhC>uH@S9mB_T`51Z=(;hk7?Vu(`t*VSpI(1y6S30hNJg4l>_mibQZQ;`Q2LI*2ZpKxNhjQjYftM-916im7x+S#y$sgwxdJtoLheYD+Fo!bi0=K$|Lk8`2w&&stk=ym75zWgTN zbqD>1u#P*#9;@)oQ_M9LJ=QV3I}#D>{m!3sYH_rpdYw$~cem3$JZhIO(v#*kUMTKG zkix|zQaJJIRn8i z&aqLu0Y)X|?C2VuFasTDd?L5qc@Z)PFiCHf4y0(;10`bvf@}r^L-p__DCZeS_h=xh z_6L+H>A)FpX^9E+WcrAD7yA=ff-+{Ml32buS0N^`tc8~C`Ncg%Yc`m{cK0WUKpwhC z2Ok`i#pjpb@f`ZpEeCWCoyJp5<1FG?5pk&(R4wproWlk%XuzWh5iYkw29j zUZ{3jT`A?}SFWRL4oD7VnYVw@a;!c{A_Z`xF_tBjC-QpGFoW zP$@p!ym*VB5a~JKE;vh#WQ3whFO{oA?kH0b;Dx0DEsEvN+)*owZY7oT%tf%BO4*qC zaKJz~)xf{^HVZ~>pNkP8N2g#UBFG8fbDhLwt2=HSEMv<@o;=c?5QR{9BwE_^$AL0( z+!aBT&!_Oi=blE=~4-XW$V`d{IO<+d;?d2y1{L84tSPH+UG~yW5w7IaZZ2&|{ zAA9M3=D02RC`Ym^I13T81rm&0BVdZ)q5&t$gTqjCLDGu^Iyk;!Rw1CFR0|pa03ZNK zL_t(Xr;icYoa1&}x0QiN?OQU3b_Zlhx?4a34_7^-ap zD?;MS!P+Cf>;j^oY-j_Fs27_9Jtxof;SnqNAOsNHmrP0$Fpi^tFwNe<^Okxt!AZb> z7U0h}omGnRA_tB%S~^b{eO{N@>?b;($Yna_84c9b2rJ>Dm?TH90Jx~H&=EVfQOmBa zM~>x5grsE>!$2ffPf+LJ{8K>AVnK*FaZok3DFBVwX2h1HtdL}1QbxcVZ>dj6co^9+ zAje6vnB54-i}g5DG}a$UmrP&M1xyI)SKiTVQPYP+%B<57mUKKf!zwQRobZ`|aSr|y zhX5>IJeAfCtZ#`t^!P&t{6&_|oKBDWW^zsf#_SZV@{In*b7GhQC?@GCXx^i z`oKQyn4nH!;%l}VA_3YBfR3z6dyedIRMmX`s)@QBFk@sIEnaNST=Y1K=-tzBVf+bn z(y7adXzuvyxZdNF_N*d*VU(PYV#j#|_TV^mc64xF1^(RWHW-1MQuKh%RIFUo!`n6a zNfFE$2!J1K_M_+zJ4)ugagOy{0yG2wRF}Af5xZ`dlMEmgC_^Z+wfzZz8YdhYI3Zc# zvLg{F_Y??YZ2F?v9Jc`nOqqEj@sqAD4gxF#I+P!u6KzsE$Inj^#O#~dq%*Z(-$v+K zW{G^Mw$1eyS;F8`9c>IrfZ!71ON>T#KHqR$go-C130OgAo-!eBHkvpDpfJ1%v=m^# z-+(T6D2}5v-h)N#p-C=&M?~|gGyZj*b5Wmk49;c{AhL5JGXO^;lLxxeWh#M7Q8<7* zAXj{;t(jI2N`To?wgF@lPdl)2Q$b$?9Rw@$dnKFMx8V^k!A64VY@v_XPigHQZPwU@ z-A5u^7KB+Q)dm9N=72x*Xr4`CbT8>2K#q^OlL3oF_tpkke^Ll@ESqMk^lTDj6SFJS zI33_zwTU*5052S|bbO9tlb&Cy#_d&?OrVW{6Cm}k`G4SYh;P0L5 zR;5&No%FGkC9qC90NyymJYZ0OS{ic?z$+bvB7g48Lyd-lH~vTG|K7y+zSFm$k&S;Jud=*ihwsy#Ti$59Z=+Z4 zorKMO-UO~e1U9Q)rpTSQ7j3``S%OYcaK>KUOgIjLXrNlOV*wGOZ3GGjFcBC*pI&4K z4m_C%L{1;@K3Q-Mobg88OBeeD^#g>6wKv{2za1x*SLlO}XfkE*lD4R3a zaDG+4Uvby7=@T~}I9^>d(ZG}~>5TV3GJXZ{doGf`aWCLWr`}IQ+l@Cl2D6Q{aQ9}a zOamV)7mqZUbF^>xilp=AO!GIa@#xAp1u;Dt*%6Q6t!{*48?QvC3)u*}^VvlAl|wg9 zE#!zDGGR!FwmA$)10IJ&a5lf=2?6tVWHA-b0fcV=G@GeFHtlU~YML4yKFff3eFq|D zzY_pf(yh1OLLp*EC>)Sx`bSRa*%~8e<|UfJj05ivpp;`H40usi9CvB?$P(9_ZJ0GS zoj~%u6AZAS&KVON7ezKCwB9^{{XQNEa6)_7>w^Z~=F-3s-#&#lY#Mhr<`!CCMrWR~ z{dmKaSbrxb0Vt#%hf4t`?$Oxv=P_wEO46W3Q+f(nD8L^bGQa+o-ve$Oc`%BL91FAU zF_5t!5xHAH1RcJdAY1^%&t6NL1w)`?$3@VkM2z@n;ux{IG(dNBrfdWYrF{*cIku&2 zc++;LTQb8oCW>`SHlWC=$%drCBW)oYQGho_Ud1tl&V@*&cHaS?s}5O_0GuyzNn>5~ zDfaFQeohpU>MT(281QRafnOgW<;@V<}HdgJhGvX0tfS0dg;{FoCF9?h}X$UpGYDEn;4fQV1k0bhauw< zB9z4T#Hc+I zAz7!X$R_p&%VN~TA|lVxS2N9mxtVzZqQQY5fg$vgB0H%W$x6w7h&CX|rhy!`EoG84 za^lE}rx@_g1L?#Ad@p4`xP#-_6)|d8-n{56UGcpQv8Ww7Qp>)X{i97fr%D1F3Qf~7 zo8%-wn*WRkHfMmaKR_Z3d|7c^WCA8I_)iW3aNHR?(X`<^V?1H3zCZ5ir_$g+@pj|J znwzuUC~WjIPMYt&mj+WJ0Y$mlQ=Pfn_`|Gqv&~Vay)w!|C4qDD9DDUv>`-(i0hI+H z2&v2HUs#*;A~4n;=h&G6F;-V869YKxgQvfY$gJ&)FNWccP}vxWy7n?DmAKvx_1Kbz zLY6Gi!DDO6<~$87oCsXfvpKQAk5{I=Ka+&_Ko(3;A(Bs*el3j?GGN12owUiV*>%3EJy&K%XR#XG$%a21oLfpWC|T|sk`hs zR(@D)cm2>4>Ad&d)l+@yaA&0P?r;-5P~AzVK1f85qv1_Nn>G<`+(b0Ik!Zs((Z~p8 zn{uK}BjxYqVfOOhAmxJ@(a;p4sY66l2AlshWUVRcRx=)?H|_cdUS+$d;C6%Z5a%;8ywFi59Aa04aNrI&dD9Y{9d>6Xg^e+L26^pg<=1SThC zFA%Y)4M^mz(wjtlLbAm&R34x*(vzY$Gv3?=tbJn2T#-#92Zl^|nI0`WAT9k7(bad# zBmm`i=C0!NRKLWG?u4Jdi~hQNo0^_eDP9O)_;&NJ@bAML8~%M{6H)P+#Nyw;0MXz; z!@n257yiBQ^M#Ke93&bl-+BHJoq0-!I@THSMx&O=K>&(LaLCcHw|X>GDbzV_i1IDx z63w0|Hn^}#{fn%d0f3!=LQPQ;P&F`f3Pik;gNZm{Ck?8Aq6fAb=;G%QP%^3rMcpwl z;gP<@+*Zhnv;oaHZ&NYPE<}hD5-uaJ9am+|9QEP=kf2)}7fUkWA^w^D3ISY@EjZq6 z>`NKpBuDvmjm>NvWVJDrWEDS4luaT^F`MMF8A9TXlS0N(|K;z2jEGpbRZcbMF$2Um z%$jkkgfhzkqF*u}Y9|H+zrbCVV_QUYh_)$k)f&qFzJh4|aF-l*vzh$TizWp&P6{C{ zc#Z`LP)zsuBQI)xBRFCa@D+f@CbWpJi2Usug8)v}p&__woAsb`MVBmi1$KTL2P^@V zvB8nm_>n**8>p^E^lI7^SL0PspLyuqp!p#=+LJ4+I!(t=<3&jup?)L`X#lFr9UOHev84JWXeg4$RyFfb*hlg~S=% zc>NJ%6K##nC&^a4Il=%PzsLSaZyof=vanQBWCGZ9asOsE$!(CkyaNApL< z?C;3}{;@F|vjG^*hQ}lmzyvxD!QVJZ!3lVih>e)W-uPsjQ60PG4$AqPIdt0{Bps1+ z%}|B-&H(MGl;}WHfPs~fKntC`bbQb}qea^YsHILK%LR6bLU$u*vO)bez0TT{h>&y} zqc^riJ=(=L#s--|aou>j!Zbe+A$&U>nyi$*?u1R6I}-TPmib%TS5wN9uup?;0OWQc z)&qizdKBiHsmGZQCT}T_akMq=%q2T1`z>69ZQEr;!0rh^0w*|UDd=Dcg2q!qwgda! z3nXANfj_sI(Zt=Js(UO+z)>&1lpZ(Vzo^jhy^#rLLCrXB`Fij2+ZjdV&r*KcyU3+_ z&A@Tzs+BFvDYvYp)}KU70&AOUl#FBsbSF6`DGJvJhS5`WBIOx1z1=@5031n|P(uFZx~b4;zC^#2%37i&YjdW-{1!ho~MG#=c)+K13vAfg?157oq8DX zTD_PyrMi@*i{M#!6P;=x#{s^kY$D(*M93KOZ{ zq5&xlZ{;cX_SKE}tq8Qs}t$v{% z4@?r?DkrV`OKp1~QaM%$z>IE;NcI94e8xE0#Ckje6UaDdWj%7n+E!&@AmS~X2$8kf z(C0dXVhCJXg=L<_;e# zk4y+QiS{cVp-mw$u%G8z$@i# z7;O@8%;B9`_xA=&VDbk1ZCSH<2^fR@wfGKp8S`g&dpuQ+-^U^*r!KakN&{u5e%6`d z83~jm$LIlF!11K6jY`oEcZB@ZfqIWZfIN8VeLQj}rON|^qD*^3M9Gf{TEd|biqKAU zqf;169E%X~Df(p}V}wewF)(G<2H3bJ*(946NJ=#O3z0?XnV3yVM9BFprc>~$A^YX_ z>G%QWnN3+fhD9cT&sW=5=1Vky;d4jyYdO*3XO8aCz{w8&eFA_JXOxx$Eco*YCd?w| zBf&9Y6^_HKoO-e8k55=>(wFrJIrkLr*Gpyp-m+A_$-Ka*rj0!w8b-;2N{0B8MS=IGds1h6VFN_L6_PXi}r ze<83oO_-tgKrSE~+K*@7-2Q~MaPA}}fc5M}kPUTeRKois+64$8f_qh&mW3%Em+S+{ zAojXo>Pt$vL2?jA zeW{L7*+uX5N07~XJ0Az-z%wC7t)=OU_N2@S0u4{sN+9cGM~uP1F-&n2m|#ne-7uRp zK*6IqwLb})HznCb8^FB}X77rUxxjwnoWsv~R!DtDm?si349z#IFXgm}eU^=z`JCIN zHs8<&_#EY9B<)ABL_n|`DI-;E3UvGz`a4j(WBYI-N%V&bA|26z{Q!ON_ch)p0Fo6R zdE|_2co9iSpMi$wl$3@<&~R7aJI?K>JP@!(OU^^k3ELAMX=Jf~Wtu#k8a_Y??!A8ur6lg$A{MYhnm@wz3@bwFD=o#ADB*tqez6`I>l#!s+glt+`z%iKsd$z-wn3xGg+ zB)}*`$N;610LhNe`S#1`x<5X#u1lsoA9x0R`!m0({oo{cpiclogM7%*M`c7`u44!9 zJhY1b1@oY@NR_+p%io!loX;Mkrk{9K}U*W zLu5v)Ta3t%OejRmzG;pFSRzrV-5+J#q+9$9M`(!{@-#cj&rW+tHXzdH0J6>wg|ZRdz&^X^@lIHm_Ejq!dkUST$XT1Q=(0(#Edy6t81wD(X~W>c&OECjhb0KJ;y`&+`0Bv0}yd1^7G0 zEleJ^7tj_Dru(5%j7B^#HkWq9BC;CCv>azz?FLsb-C=-f!6>kqh=ZX7j+#R;5tI6c zGp09mu2wGdiz1su+Cl(s*0i1arK4DESpctu#Z722*(4i4vol~|0T+&Umd~;mNpVui z>yqqSvRzy%P(crYw?-7}fE9F*lOApC#3cq+80(UBgtjN1*Z|q0OLL|%TzhAV=KbO0 z5E?gcqo$xUBr$wmq5NJ(ruy=Rdx(m0W-hOpqKvKmOURGp5eQo<3COeT4fL(gRy(m% zJow}*(1f0$NH87ZaiIl@?mqv{WD7agLvF%Se&35=-!;^e^)pAZOZvL)H1U;`YeoG~l@ z5KfVVvRAggK-QwDmT%fD^$q}qdXmP(*i)%Pfp{Q!a$YZqZL^Gw?L){9v|*F>Jp+t9 zAUU}1Ze=sFLT0$Lw7OtX68B@@ylyZ0>NR@>J$Ihbhv{1vElP3kletWv0Hluo!AE~K z%SgSN>K%tP&-`oPZks|76xv5e#O6-=N>p>fkcFQwes(>fhyr)YAtogjl!nKa(TXT^(yxQ~LN^S;yoi2FcZ?#Q$BTLSZ(E~0N= z^tM#jKAFq)2|%6EKlp8*$+Fxttbad5*!9l<(*yDt2{7Ly8|LeII2qZ*6jOqAU!21n zB}Si)Je(W|vSI2FnLh8Q>V%C~5!N)zZU%NkOJL#jhdDZQSf0Zc#?{Fl7zZqD1d~V) zI%)OjR&0Z%w8WBdSxz(>W;#y+3l2I~_jn-?f{iks8ll9sbx?H~mGe^%9Eh~Yx~M0W zz<9OwgkJg`xh*%v+M2UTdc5QUYqjWyrE7ueK_JIc54}v>m1yWi2nc_<& z5|HQFXX)FYeS00ZKAFq*2|(S^XUhTGZ*@Pt^7)tBT0Dg+#_N;|kO6fPX+VTv7Kuo$ zgOmWAgARC8(aB3>gn3}=XiZrScq6j$_8nkly40e-*iCyOa6}M55gq3$$X0d@WJ3qX z$C=l~pB4KcIe%sUfd-DI-lYC;5Rvwl2vM>Y1xuvW(NQ4n{r}s$vRKQG>RR`8w^48) z5h4KvB9Ravj==#L{SZ|zlUSDpKMdiUP)kNcf_PMxYy75b=27WvQ|7`>NTNSC9Z2KI>q@M3DT81a&EHQ^0Ioe?Q>$!X zNCdJJxrJZm&s(CVc%Fc|K~V?CWG zF7joCQ6Tnj>pLlVt*&6$YwxHU*5FVq2=H=ZXZVQkM(zW*>3 z1*-poEz790k)3qcr_Q|okKf+6`t1>SI|10E;D*QU`e=IEBBkBKf`Ca!Va_HIz!{lV z#JO|3)!euM)v05)Ktcc@z{^0=I&en;tXjx5qljRD;amc1qiebj@wgN&S$YJ>pm=0DBaiJ$Bc<>EY>$^aEz5kzm{~VtG%yJ!f@H`Y2Nh5^hh+pmyU#9i`_LyjUIIaE z+W`dkhlmLmLGoN8U|_D_8LcQk3uALK4M45{TM@qHu{rP%GAqE63~&q7S(kIPAsCw^ zM<{cew*oXk=a(Iu1IHzbV+$QvLMLk^hwTNgxBPqHJ&)s=u}v_1584=9Z^QLQF(c|t z{`X|JKL78ffvt^25(8l;hWmc(JL$?-zB29k$oBIz{cG_!>%&?M>T(R?u8;0yqfxn~ zGEWy7Jk-6z*S6T`GB9R?1Pv%-IQNT&uT0Da9a4Mzok?Z5RQL2N5omzZ=6wy1;u zg#)cl04|&?$CfY>z@BJC1e}4K`g4Z8f6SS4PFNW(7*}nPBf-dvQ5k39SyMiTdKeT#bXS z<^Htt=Aurb3gD&-+=oVi8%I*|Tw6*@c+R*Er2Jd^>V?dU6jeZ=)EaR*i)}|lfzmKa zCmooAQY>cZWU+;m(*Z0~A~>z}Hg*TrejcW>2TInglORBh0w|C#fJme|hUO1HuY3L% z60$l0xRBDE+NwnY7#Q*OHW{bSwm-O&F$92#3;)mv+j@<{eabMkyn`qtoe9B`Kn*r! z#}>8n-^$a&cTWE$%$ownIpFOG8;wWRi?nngN7@9qhTx6hT+vCV1Jk-{ z_Gfwsk3LppvC!inHDDxw*9h<+Z;gp~bnw6MVATo0g_r5rB9Z{9;H2Dk&zZAyqFKcl zNPxE#c2HTb^21fo5orjSvz+>w4JUiHXdnrZBoGSuFzHcXq6{4aV>YHLEwM)d0Vn?0 z&$jlJH@CShb%1vKcIYC{bBIJc`J(5$g{11QA;Or&e-@UQp*I#+HXZ@ zP=>6NPQHQHUL$8Jz0e}dMSrFX&9=n)&wUfAIpY9P-9VuuxNd{giA<-cS_7ezHtwN6 z4?O6<8W`pM-I|yNbmaQ(`CkmE>IC3oNOfxS&QrrK6_G5gVTz2Ny_g^-f0j$2lPy`R`Off%XLwBQD;>bKIHu6J zMkR0%SeDLy;rBsi>Lic#3&U3fjr@QfVx10}GE$f)4^LE0P%w22V6h?zak<^4MJ4 zG&c2K?x%r{^Cm0XtJol+QIj&Lct>dSikvRYd431yh85@|F~bQmuwarv?>^Nr zFJ%$*5uXpYoL1647+uJ~EXKC94j@S;d%z?_fp?zM+S(ENeZG3^bSct-X>3dqnBbru z+rQnKhOrgvb{U;aDGekb0v>XD?mK#Ydi+H;(Hq@-CjggV`tLlIZb>P9hCO;Tyu+5i zqVSIa!5-jZC^9YuNOR#68igRdTPTJoFj8SpXPBXF8FB^zj2?tg$iev@g%0x+iA{X^xt`0yS9Ptsrz@&o#MtQtNzd^1pcZ{BREjLX@*m)bN&5`-Vs%r zH^5i|$TV-b4ho$li^ZXQoY$O|fO(4w_iFQ|QV)yaunJWlqjUuHfalY#K|wT!-=iWt zNrHj3Ndg6ZQK^GrOj}#K-yY!|GG>>GG~|*x`NeO-@rr0CQc8E+(DVJ53YIznxKxs! z-cyi(l+uHzcc^eS{$vPL;hx*)OO_nl2|XqncacYp>H*Ne(V}-%%+S6{BV;=T9Ymtz z`ZK3ci)Ds&78shP`ilrakjxZdMPtk2S9w*IBaTIQO-xJ*vP8x*%UrDFh_Kn%5I`Jx z6Ck3%q5v4oy(^uZks8VU5bHq^ObK$R+n^U&zgjvF=%kZ1);Y97;9@P{I3r!lUj0mh zDkF@wbk5XnK|+?;N~+|a^^3{c^n=aA7yiwkb29vVtb_k0MWjvuE~&V8UWO!Kup{RE zqs^3_k2=T$tOq_bwB_0$;2D1pNPvOPus3~_CJ{UrW?Op}IL;s?K zWNhA5(P<_oOadvjz&e?^g#uZ7HUdo4fnc9F$~C_m=d+PwaQzbncS;A?OLkGSC>1na zM^ds^ogDgvU#yg#y~#kNLa^vCw=>)?&Zrn=+R(||9{~KkD+T8LOW)c_dzx+@yRm!z zml}>b0l3r>pWb)psq`NyrN{g)d@Li%;{iq#)x1rw#ylYMSmqRAW#tIGG3yuhI|GC8 zvT9#6jDUfS84?O-Ji);6*lZjsr0=eotQde$c50g-0eH4(N(O9*vEKsB5xBFA=)RiF zaSpjH7nuQ&bYy{u7ru-8(*lMfl#W0Wfj)qUTL(A~jXBBVQQq(p-fq+m%U_W_*6(F? zGMW?BCnT+oyhr+7s|PSgf{0zAOK^e5h9JZJ`QlDN;C~*wF+KJ&nc|IpZ6^SiarzIR zOiwttNMBcZc4_!+0kiiMEZ``|XI@gZ5_k#2s6v%U4wMI(jRc|ydPM|`3_J{8GF(d9 zoyRST&}#j`TrV55(6BqS+TDhw_UGH!GS&uLv>ebV9RMOC`$b@m9@R}lIv_8Fqr^}X^{h|1FXl^9|qk9!O8EY z2vtodl@1`mXz8RRC@`J}f0Tai8CRumTt+jz(XZ|VU>{8Xv3t`tpRtdCrs@NbAQZ-1 zgr=p(-zpXZ!xw>tGXRm14hn>nab|@qyhhR1*iBI^s0?+!78rFVO@+ZG(2>>pR2XLl zv(_IBl@~@+0F>iRGdx>0Pbzesi4Xv~BXhVHT+KItodf+DMS)0!^0Exbkea7z1R|(E zD2RZF!Z@9r(;r37BDqklN)aVf^#wE5ZJ}!yNGEwcNRn640o1u)dSVaxUvBv61mJSd z!1Vq*?%CZTP%*4df84RM=S&fdX_QkJn^l52&3Dt?*^5 zZ3KOqiz>+w^M+OSD&^xqlOj9psYPBp_bDP(k`#z2OmtrX*j85nb5RtqM(K+hK~VCq z0II!S6{XGwuv$8X$YXwA0M@+T3LO9)&Ll<<4di6C^bPh$lB&wsBoS5iht``Tj?w*a z{pt?>`vQ470oWJQu+xd7_on+6+v#V*kUA7~4HGxZn3>fO#%V5qut9a(tIRlC-^BiO zBL^8sf~{i;OqDUi{>U%=H7cKZJWN2`JEx<2#|a`&9KpI3xsV=N#goHuEzgqz0#swx zjUp8UhFFD#^SB6Pk>o{b9R`r9tfOeoOu{Dn1Dy|LSOK(}4kBSwppSZv1$5)}be+s_1r8{!BcgVo5H>wEKdw)d;0pyEbJH zol8IU%%`Mp?=zFT(cS3;V4qI^kP@inG||&yu*g_9gFGkzDIx<%3dD9o6d@aG6=hHc zHjlw9NUI1jFq+CJy1Xh89v7bF?R$+X{s_#F&`408S+CG)XPjr+s)o9NbrA~mXA>c~ zQOY-v6N9cJ1reFSNL6sSQ7d&K0UTwH;{k#Z>2Y39ja?ctA{Tl7qCXLttC5Q0qd!E{ zqz9G*ur9-Qc;OF-H+0 zlK>rf+fF{T-ek%`tT!25LI5|NjM^9LTCKN;kf;biC35!Nr$0IUM`y<5~1a0hMDY(^j~KQ3?;8i3+Uj`iz|h zbAW*jnc6C8!)m1q_8Kb1=fc+9Iw(zYI_+S2vZu0JOMBlB(4&kcSVE2w+SNhD`j3Gri$dEoQHo$pBm<3 z$A_Is54-y6^w2&xu^ZjJP5@S9`j4DU+toZMdN8dpy#jpRCM1j%8-h#%(15ZrMfr*- zL}a++y9f-Mo{%*zLhk%sg_>up#_4cGg;Yi8*DW?BizrM@poZSCJX}d^)oWGbM`883 zK&3oLBuce2@1+jVTxWeydP-|}c(j_viXsq-WI!EF0j8i|S-wHezS$ppw@5<~XUQjX z4!0s0vrcCD3({lqtj$|KA<$&dB4HqpYk#qa{8s^5IssUPS(^HIEU$mcHjv1B={#CE9=B-n|O1o7dyG z43i!PCNR2eWF3GH{hsE{dG}H7*odCVQF)q32H}2HP#TTR$$uggj&Mzbn7)aV3swuV zL^`Psok5v99iR_5A&wQ^eFJ#+5^X@8cjS8sos5cju|J9^DPU$}o%^J8z&bx8y61FY zddVD}(f}Pwt)>fO+iy^=fPN%8lw)<|iN{998_9tK0UHD8 ztGids+h~w!BGfe`hWyULbH(?oLQLoN;ETu;U1!3a zb|F*q+~OGkl)~r&!i7ectBMK0TEM#$p&;)+BmyQ6F}D27 z9#5>}$U#8_h$!TFQymVV&=A`gMX0=aT4G@6)!1;^NFA6@Q! z&Gb-%7&#&Yf3TjY`*1BW87#;t>ZJWBK0*``G1(uMDUg@BHA4l_twp33>Fjk^rGqPK zN;kUOodB%%^e>K_Oyl>o7*M5W5rDcR5okoka3% z_+sE(owRwgHCWq4Ben$E+I2daQo8P{w6$13L~^z5>BjZG6M!|C^1~-~3Is#&4Dx`{ zk-$~&r%@pu^+AF-hDpINI{=vBkxTEWb&i0FP>5?PG#z>O==tR_z&{GPF5AZnShv2k zI6SIC!Q9VcyscxIGm>++!76|acB&}- zWzXKt6Ohwz&68zka%Sz%)k#HIpM7-?`L8;BbONyIGdT7C`0=#$)yJf>wop0bZyqUv zSN2lPSSiCI0E|Pzp+^H=W)43?cvJPURV2pVA$ombbiz^u7+QsSSI_Y^Whl+d%;1Z= zFO(NWzgypV5zgsPtKbv8a?^=%?!~tfa0#HESQU7oC&Ablg!%86egyWn&+^dex^i+e@!Qoeoiew+uaJVZ9A;68+2aQ`61ZpX$ed6fqOmssu^s37_Mxq6P{GtDfW>9Z@>jxTeO2 zo~=uh1hp2Cj^z1PQHww)YyE+#aXTh>=Lh#^&;d(Jt83x z=mcP$W^)?L@xM(6zw(uIdYD`{!NBIxP&B_5Hoc$uZ2K&aL!m~Ymp7R*CGWtwkYbB^+6D0rIW2% z1J{RX&1bO$d-zc&RiPs5AsYvuM3jbFd9Ug zeGE+lNx&263Qv#>zXUM|v#Q^-{hNLq>aXxWmuf&mZ+#R7ls#%$bU0&=y)(qnshmqi zIe~1A7@$#RKq=ZrVrJu{oehpKz`Pl7NwA3kX1Z=VkPG~RR1lBF0X36MBo|bKms1I~ zIua}_ zTzk*hUWJ%AAV*I|kre|m{J-#iT=Vp5yYyl@iS392zjhElA*{ejwRFqwRMnn4GFkw_cXi z$+?6=Mf{M!*ig1pdfW4#o=$CuY24^xb^@?r(?4t(9ES{EW8sMtfGSW^VMYZy**FDZ z-w;HJcwjpi&gC=xtAItG9DAhW&%AxD6@~_I4ao|0-T+bN-tj*3NQIYJeGh^?0w#=Y zE~%;l3+PB8N447lbPkD*npb>pzITRBs)$QS*ho&Tu`1&0`X-_B+l@X*juwrU9sz^!=>v4(_# zJbino`;uC4Phl9DtbhloLcSrO1@bk*H8v~2l4Xz&2r{w$sj-C-6{?$=t2d71kbJFXg!`$^C{W{Q zl0hy6Rm5kJ(k&hMHxdat0ocfC-x>7ncc)tyi}dG(!3Arbjp1a)B4a9zW?*cV`4S%+ zPY(OK{#5$yhy(ngJjCqnsV!h4T%DVt1+m`ospC!HphzCjc8g{X2s{d}91&_aQv^g%yKyy-|3RbG_LpazT_bxMnq@qBrn9 z6%hbi>-Im6-qrLhK9>u`q58e)QSlbE;iXa90F88IyiP_~MX!L1+Cgu-23Q555T3sy zK3u`y03w!amO03NY@$H~YH1l4SrGFOk-0)A?Zz28iD1pTq2|qzL9#78w()uE1NMo= z*3!vpDl0xmdDx7iZt1Yoo0-;JK@1G4c`Ib8uDc7JHF2!xffG@vfLq>3jP z8C~hgqsJ)vV{Og#qO7?nRZ$q{iFH&746RB8QywdybI|Hf4bXDiDg}atnv>S>7^28d zL>8H_6#$Mzkcq?0Is-LcH7AN76|$_PhK$^x3|W_)PDj98(MgW14DGpd2bg3A>+L1a z?0Nof_ID)E2|(9`LINWZn2d)5b-O0QuxKpD2FZAjf1?3a#wiGkI{*RHKo3lMSJV5{ zKKJ2!=e7c@o$(qHguvj-9T4o15@1Ficm@gkhd6Y|`cx1Bnj;37qF9nhRE?aVYzwbF z*xpv?0E!dlyV^F@kretzx>XDLn|SgOzzC3}e~K)+cN6I;$P#TsRo~fAgd)op&p*KP z7&uK*A!iZ!Grf6f2mWsDNdlb!bd``2xaoL0_}HILr!(Fnco2{{;0f~PY)mCs1pAdU zKtoTR!4Aj-7ueN|d`|naIFPSYWoxSi?=-@F;GMx8|Nh|)(a2O0EmF7YQ$?EJCY$j)F~*GQ$Xd$);cf0 zLi}(XDt%Ju#vB4Q19T&OShhcrPEt@Pe_|L35fhz)Xeok6gl!I?;6Cy*7V$8T|I8x2 z@HNj$pY0~DOCXX!CjebHW=Y`4-RbwwEz<9qaWUXP1DOqf;E`9q^he%*t_46ZG4k}y zJMw1=<)ehYtFUqCE8$?*$Vv7QVY+n_~yIF)eU3G#AVKBW`U77a17Ei zxr;Df*X^m1BD`LakMmxY_iytDTi4Y04O-C;MZTiw$6TEpbznHFn$tu$UMlD-NC+Pa zCDKI8=%mvD(2=c_-usH{(tBnt?0(ZmOP~{gjh_DH2Y>tB>F&iM{Th0XXmFJ$Bfaw0 zwy;J$KLEpM>pZL4rD9;YmUk@B`kio*U_QKCf&1n45^Qt~K38IE&y-a8c9wY=2Ux%)P@ z=KL`6P=un9_HlYfV*_#dVp9TR)|;@vQjiIh|M2hp)l0e;BTgzp*3?Oe3OPa)5S;Cl zK6&f2)2-*Zr2FF=D1lA@HgM7}SbJ!mwE4H(N(;5z>tUopRf(39JO$8ib78ukDX;83R4~FR690i=%hT;pr!*+)FOyT72oYB zqXh52^*QNX7jixKwl+%wod9gsd|$ND9{oVN;oMgGT=rNH)Fw0ty?;ApP5}A<3_16z zLZXTUM8I1EW9qMgI(p6s8nX6bN)cPVfFlM0Sy@G`1o#G4;b8ISkw2idqfoPe=>{4>^j`%pIFM9(z)VK_`pt zrMsCDzds*j6%w}A8bOk}oo;;HbJO2lw8h*T-WUmV0&s-gt zp_BMNoWm$;^x*f?kH7K7=?9l)CHJ>%f&@AN*o0ZWJY!rOK9SC$adtq@A@E=enlg-R zAwFDS=J^)^lF>)u_gA z4J^{3!L#9TDjUTjT+4up-Y5KK|I8pb8DsE%?ZWhP3GU$(~3hWQGr-~C1 ztgGNDh*CtV5acl@&qbOJSSkN4!{YII@>$RL9sE^EoR=}BL;tDD_dKV|>HrXrYLOq1 z0Y#o7;!_m88t7ZP3JBOBUfe3FQY=a*Q%a|gT;I>?-&clg4Lj2bz#2~KejSn(3`%bg ziv`Wg0z=w7VGaiED!s7{QFw=7>J|g{Cx{|sB4Bk46_1Y7BH8cb z50L;o?pP5IM-EJOz;+zL0_18&Iv|6 zr3;FF&Y2TIT2T*DO7FkphF;jWUv1dB^{W$rb(_%@8PAcEX&VoDk;a*c0OW1wc!z*1 z?kjW|^kFNR{E&^x?FZ)IgFTyc~am^K7BCRNC=XEq>TFL^9m>-J2FE_84QUHa!Y z+?1ZQ2Fth)VMQg-3BZa@+`4u9RUb)@xbmU&fb-HC#baEE6_N;{K!h>IdZTud3HC5r0$fK(yzK_V9tis^w| zhambRi4E%j6F(55ngiFLVBUtVoIR8t`L^e!@2%S!?&DcK33LLmdULk+JwAF*`tTvWS0VbH zIlx}W2B`oU5vYKrGdeTsAJo`forg+Gz&z$Ky{Ip6gu-Mohrk5nG}6hfl>X+;&rdI2 z`^DP_xKa}61Yo76Yx6og)C!DBS^V$N;EjRW3A-RZl$HePCpbtQUIV)hG$csrcYfaIQlkiy1ok zwioo={^nV&)fsUo0IM@s8{gBT_oVHjSkJt+j7oZ+yaOt9r(qv=L^3idU@*2u`JkSt zl3i7abMAS1HY7c*BWiIsLI9ufPLx!0jJMPd;!kebpImHvB=@ zTjlT>_<&37;0dgfFyznVAOa#g_y-TPsgRgzc)hYU5xw+GVE8@3*d+N-^0hGs2L~aM z;Qk<~%5@01(?I3ldHW!YC#ua*pAMc|7|DHPy>R5us^4`78y;${+qQ3;F! zz=$!#?cS{pM}j_KabgH+@c!{Vc4I5zzy*H6)=5mmMBC&XVGsmP6@7ByB@zv50*?T8 zWJn#cEYdzvI$`Tk>56weGo9|svP)o9CC~}Ls?J>RcOikBj;DiRb&^0;U!36FQ>M!LS24dmLdp_%uIibA#@m9t(`0j=nIDYo#)>G{aR`yiXb>I zANp_d$~!)wmI24+fIa|fB!D>H+SpVf=G6SzUw=tD*q2zBz&c8x6M%J`)jp;|0(YE9 zFWowj{xSooI8`tz_;R3ypfiE43PUST-r83o`Ah_${bfSsDzDv2Ulb$--;G~u#6n5( zs*QJKU`ClBz}G&-OtWP*0sLKv4Ca-smH8Q9N<)`q?MI*k=eE{4FT7jj zu~UV5;h9@hgZI8egdz*jhyaXD9{U@mV8nCEyGLSz-n^Wj>0>)%A6e#N-c&?jk>(x`%>u=*fa@r0Mp5Xq7G1xn+DV#<6$KQH+ zx~4CME`d##Kqmm3t^s}gQUY)MVEV&FO20FQ1mvpzT4;KD3m2<#Xc~72jG^m{vOE8< zaCWpmzgW^Yg&r?5V!H!uw#NfAgm3dJLta0fSm+zN647c7#%W1EP_AHC~U z>D^t`y9BxfyaYM{=o--_FjE3=`cQfxZKp?!+sZ_k8^PLuIybGz!EkMhPAa4=cwrtN zKpE2uOjzu1M;wIbi~yPs^2siIxvRo?*ec=xV=F*EAQX;-KuV$}Ypy*=DShwVuTGDg zIi>x!E`g1fKqmkjJ^g*~=Ocl)o=QKzeKvhQrSxbCavb6&KxI$bTzu#G6IiQ=KyH@O z3>8i!E?_0ExWM28=V zoej0xhLJFk<(anreJ-VR?D*@_w=T~N^|y8jY?cH%0obhh?xWqu5_rq0^s`qi(%mWT zZb@UJkOKt4sek$G`zX&2Zg<{-CkO=A6{z&a*e_~pfq#RX;rUOcv+14hJ(9k;kEfw` ztxI5IB+v=K#!Ph|=sHQ@^&d+I9{t1gtBXZ?ZA$5h|DSSr0+I!DvLnJU{vOl}@Ne$x ze!CHfZ=^-~m+kHJ$!{D;_k8@ebatKO+sD!+un7|QKjQ7a{t~vDDgXcg07*qoM6N<$ Ef@mE(_W%F@ diff --git a/examples/react/start-basic-rsc/public/apple-touch-icon.png b/examples/react/start-basic-rsc/public/apple-touch-icon.png deleted file mode 100644 index 5a9423cc02c40ea066d2a061cdcdf621c0718cb1..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 27246 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⪼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 N002ovPDHLkV1k;v<;Va4 diff --git a/examples/react/start-basic-rsc/public/favicon-16x16.png b/examples/react/start-basic-rsc/public/favicon-16x16.png deleted file mode 100644 index e3389b00443d602a249b48ae0e21e333971c9c1e..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 832 zcmV-G1Hb%Px%`bk7VR5(v%lW%BSRTRK~=OuZ4FYhI3vvy^4t8t~UDHGBS#44K%hSiDal!9Nj zeb^RZ;3&cb72F3w6s4;uUA7>Cf>1=Z56;a$8wZ=NKHtq z33GDV=_|V0E(QPTEB1=edhG{{=-+C??RQi7*e9J7YBnZR+PppIKjA8EV+}Yt`zH<7 zGR%O5D3|Ef)99hUXu19=Cxaki@6toZIe&u-X0(oDFRl|x6P7Bwc^mB(i9|gOY)Jh6DaPkmt z8Wr!@TP1|RPlYRlJe^eRB0K(gn91{(=zi{HrkpHIflw8&q%;+U!V&dFPYDQAWJh@< zwcklN9VEX?vG;}75GqCepKC25M^xV%BcR%A8c!)S5k4P0$g}HS#lA6zy`~K@9&EX4 zOrvr%_1U2dp~gg6G*;&`Jag*?jZTJv+$S`*#)zme_SFWOCm*F4U&hJihqxAu;8z}x zWv7!u>YKRa3PUJQs55wC)i4QvFOAV0jW$?1cnUJJ7Vl?z_ge{9q!zpfCJxd8vJ>-ql@0&`Bttn1~4;s>8tax%hr(^q#A_*wqAv( zh(T&>hJD?OhiP$sxAzkd1W1^EHV1WL3xM&6$*HhG@|8}OjPpG{+!;GC>w;ha0000< KMNUMnLSTZGXp5cz diff --git a/examples/react/start-basic-rsc/public/favicon-32x32.png b/examples/react/start-basic-rsc/public/favicon-32x32.png deleted file mode 100644 index 900c77d444c9b31e6144b6ac0bb1ab7bb7ca767f..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2115 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 diff --git a/examples/react/start-basic-rsc/public/favicon.ico b/examples/react/start-basic-rsc/public/favicon.ico deleted file mode 100644 index 1a1751676f7e22811b1070572093996c93c87617..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 15406 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 diff --git a/examples/react/start-basic-rsc/public/favicon.png b/examples/react/start-basic-rsc/public/favicon.png deleted file mode 100644 index 1e77bc06091ade4496525a09d8900675afcf03f0..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 1507 zcmV<91swW`P)Px#L}ge>W=%~1DgXcg2mk?xX#fNO00031000^Q000001E2u_0{{R30RRC20H6W@ z1ONa40RR91AfN*P1ONa40RR91AOHXW0IY^$^8f$^O-V#SR9Fd>S3Qp$MHK9ro!#4$ zEP@L_hX|b@f=!*_42h6mKu7{)4)_U*>1>0bCkUj;Z1X!7 zHe(Ew^Oi(|bW3J~xu+)XbtFF?4>!7TH$>(D_atUQVEj(8fGvYu2NF33#JZX>)(Vj8 zIi@z>Glt?6t~;Lf(|C8F>;WF^8F<^s7Scr!sZc01uB?HMHoL5+FZ>B(g+r-)?Sn)#3Zal#?G@GAwO5U27MpGOlC2+_saA)rl zP-<@-n~;PQOlm|Hi<+W;NdR;5+=zADzM&?!+CPD36=cGwHy6!D^vPEHG?rO`K>G|M z3FposX{yT132wuw1OR3Um_5JoKB#6?!QgBupIT;?YIr;WcpmuCE>S75mZid+ens#E zGPuYjiG0UNNVWu=f!Id^?9)34)eIpu-`j_~W0iAQzK(}XYc_!;87Tk~?4tq|h=2(! zuq0HCiNK)@+ocCKR3q1REdUju>HdYxd>JX@%oOibg+J~D+}rhz54D!NfC{h-OYk{M zkzmFtdrL@nL0bm8nF@pob1CeLC>12ef#in-Bzv2!wi)Iuwq24)`AH}|0QNQ^f$KHv z?5PBPo1*#GAuAk+Poe`?UJ>mP`@~d4a(103j0lwUx@_+$#B&VC%7r>#2$HIiD`KO8L|s3Yp%M}BT0;NJDzZtPnx=4%enhU zhW*pNN0t`^4%5MKAR+}=^Q?QeqQ`>bbK zf+-ji$Uz8V0?LpX@kh`k%DL)GCA2=@SJNKg56Wh>>pr=7{1PmHqG|~=AdLV3002ov JPDHLkV1ivgp)>#h diff --git a/examples/react/start-basic-rsc/public/site.webmanifest b/examples/react/start-basic-rsc/public/site.webmanifest deleted file mode 100644 index fa99de77db..0000000000 --- a/examples/react/start-basic-rsc/public/site.webmanifest +++ /dev/null @@ -1,19 +0,0 @@ -{ - "name": "", - "short_name": "", - "icons": [ - { - "src": "/android-chrome-192x192.png", - "sizes": "192x192", - "type": "image/png" - }, - { - "src": "/android-chrome-512x512.png", - "sizes": "512x512", - "type": "image/png" - } - ], - "theme_color": "#ffffff", - "background_color": "#ffffff", - "display": "standalone" -} diff --git a/examples/react/start-basic-rsc/src/components/DefaultCatchBoundary.tsx b/examples/react/start-basic-rsc/src/components/DefaultCatchBoundary.tsx deleted file mode 100644 index ef2daa1ea1..0000000000 --- a/examples/react/start-basic-rsc/src/components/DefaultCatchBoundary.tsx +++ /dev/null @@ -1,53 +0,0 @@ -import { - ErrorComponent, - Link, - rootRouteId, - useMatch, - useRouter, -} from '@tanstack/react-router' -import type { ErrorComponentProps } from '@tanstack/react-router' - -export function DefaultCatchBoundary({ error }: ErrorComponentProps) { - const router = useRouter() - const isRoot = useMatch({ - strict: false, - select: (state) => state.id === rootRouteId, - }) - - console.error(error) - - return ( -
    - -
    - - {isRoot ? ( - - Home - - ) : ( - { - e.preventDefault() - window.history.back() - }} - > - Go Back - - )} -
    -
    - ) -} diff --git a/examples/react/start-basic-rsc/src/components/NotFound.tsx b/examples/react/start-basic-rsc/src/components/NotFound.tsx deleted file mode 100644 index fd4e75befe..0000000000 --- a/examples/react/start-basic-rsc/src/components/NotFound.tsx +++ /dev/null @@ -1,25 +0,0 @@ -import { Link } from '@tanstack/react-router' - -export function NotFound({ children }: { children?: any }) { - return ( -
    -
    - {children ||

    The page you are looking for does not exist.

    } -
    -

    - - - Start Over - -

    -
    - ) -} diff --git a/examples/react/start-basic-rsc/src/routeTree.gen.ts b/examples/react/start-basic-rsc/src/routeTree.gen.ts deleted file mode 100644 index 723bc9ef42..0000000000 --- a/examples/react/start-basic-rsc/src/routeTree.gen.ts +++ /dev/null @@ -1,263 +0,0 @@ -/* eslint-disable */ - -// @ts-nocheck - -// noinspection JSUnusedGlobalSymbols - -// This file was automatically generated by TanStack Router. -// You should NOT make any changes in this file as it will be overwritten. -// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. - -import { Route as rootRouteImport } from './routes/__root' -import { Route as PostsRouteImport } from './routes/posts' -import { Route as PathlessLayoutRouteImport } from './routes/_pathlessLayout' -import { Route as IndexRouteImport } from './routes/index' -import { Route as PostsIndexRouteImport } from './routes/posts.index' -import { Route as PostsPostIdRouteImport } from './routes/posts.$postId' -import { Route as PathlessLayoutNestedLayoutRouteImport } from './routes/_pathlessLayout/_nested-layout' -import { Route as PostsPostIdDeepRouteImport } from './routes/posts_.$postId.deep' -import { Route as PathlessLayoutNestedLayoutRouteBRouteImport } from './routes/_pathlessLayout/_nested-layout/route-b' -import { Route as PathlessLayoutNestedLayoutRouteARouteImport } from './routes/_pathlessLayout/_nested-layout/route-a' - -const PostsRoute = PostsRouteImport.update({ - id: '/posts', - path: '/posts', - getParentRoute: () => rootRouteImport, -} as any) -const PathlessLayoutRoute = PathlessLayoutRouteImport.update({ - id: '/_pathlessLayout', - getParentRoute: () => rootRouteImport, -} as any) -const IndexRoute = IndexRouteImport.update({ - id: '/', - path: '/', - getParentRoute: () => rootRouteImport, -} as any) -const PostsIndexRoute = PostsIndexRouteImport.update({ - id: '/', - path: '/', - getParentRoute: () => PostsRoute, -} as any) -const PostsPostIdRoute = PostsPostIdRouteImport.update({ - id: '/$postId', - path: '/$postId', - getParentRoute: () => PostsRoute, -} as any) -const PathlessLayoutNestedLayoutRoute = - PathlessLayoutNestedLayoutRouteImport.update({ - id: '/_nested-layout', - getParentRoute: () => PathlessLayoutRoute, - } as any) -const PostsPostIdDeepRoute = PostsPostIdDeepRouteImport.update({ - id: '/posts_/$postId/deep', - path: '/posts/$postId/deep', - getParentRoute: () => rootRouteImport, -} as any) -const PathlessLayoutNestedLayoutRouteBRoute = - PathlessLayoutNestedLayoutRouteBRouteImport.update({ - id: '/route-b', - path: '/route-b', - getParentRoute: () => PathlessLayoutNestedLayoutRoute, - } as any) -const PathlessLayoutNestedLayoutRouteARoute = - PathlessLayoutNestedLayoutRouteARouteImport.update({ - id: '/route-a', - path: '/route-a', - getParentRoute: () => PathlessLayoutNestedLayoutRoute, - } as any) - -export interface FileRoutesByFullPath { - '/': typeof IndexRoute - '/posts': typeof PostsRouteWithChildren - '/posts/$postId': typeof PostsPostIdRoute - '/posts/': typeof PostsIndexRoute - '/route-a': typeof PathlessLayoutNestedLayoutRouteARoute - '/route-b': typeof PathlessLayoutNestedLayoutRouteBRoute - '/posts/$postId/deep': typeof PostsPostIdDeepRoute -} -export interface FileRoutesByTo { - '/': typeof IndexRoute - '/posts/$postId': typeof PostsPostIdRoute - '/posts': typeof PostsIndexRoute - '/route-a': typeof PathlessLayoutNestedLayoutRouteARoute - '/route-b': typeof PathlessLayoutNestedLayoutRouteBRoute - '/posts/$postId/deep': typeof PostsPostIdDeepRoute -} -export interface FileRoutesById { - __root__: typeof rootRouteImport - '/': typeof IndexRoute - '/_pathlessLayout': typeof PathlessLayoutRouteWithChildren - '/posts': typeof PostsRouteWithChildren - '/_pathlessLayout/_nested-layout': typeof PathlessLayoutNestedLayoutRouteWithChildren - '/posts/$postId': typeof PostsPostIdRoute - '/posts/': typeof PostsIndexRoute - '/_pathlessLayout/_nested-layout/route-a': typeof PathlessLayoutNestedLayoutRouteARoute - '/_pathlessLayout/_nested-layout/route-b': typeof PathlessLayoutNestedLayoutRouteBRoute - '/posts_/$postId/deep': typeof PostsPostIdDeepRoute -} -export interface FileRouteTypes { - fileRoutesByFullPath: FileRoutesByFullPath - fullPaths: - | '/' - | '/posts' - | '/posts/$postId' - | '/posts/' - | '/route-a' - | '/route-b' - | '/posts/$postId/deep' - fileRoutesByTo: FileRoutesByTo - to: - | '/' - | '/posts/$postId' - | '/posts' - | '/route-a' - | '/route-b' - | '/posts/$postId/deep' - id: - | '__root__' - | '/' - | '/_pathlessLayout' - | '/posts' - | '/_pathlessLayout/_nested-layout' - | '/posts/$postId' - | '/posts/' - | '/_pathlessLayout/_nested-layout/route-a' - | '/_pathlessLayout/_nested-layout/route-b' - | '/posts_/$postId/deep' - fileRoutesById: FileRoutesById -} -export interface RootRouteChildren { - IndexRoute: typeof IndexRoute - PathlessLayoutRoute: typeof PathlessLayoutRouteWithChildren - PostsRoute: typeof PostsRouteWithChildren - PostsPostIdDeepRoute: typeof PostsPostIdDeepRoute -} - -declare module '@tanstack/react-router' { - interface FileRoutesByPath { - '/posts': { - id: '/posts' - path: '/posts' - fullPath: '/posts' - preLoaderRoute: typeof PostsRouteImport - parentRoute: typeof rootRouteImport - } - '/_pathlessLayout': { - id: '/_pathlessLayout' - path: '' - fullPath: '/' - preLoaderRoute: typeof PathlessLayoutRouteImport - parentRoute: typeof rootRouteImport - } - '/': { - id: '/' - path: '/' - fullPath: '/' - preLoaderRoute: typeof IndexRouteImport - parentRoute: typeof rootRouteImport - } - '/posts/': { - id: '/posts/' - path: '/' - fullPath: '/posts/' - preLoaderRoute: typeof PostsIndexRouteImport - parentRoute: typeof PostsRoute - } - '/posts/$postId': { - id: '/posts/$postId' - path: '/$postId' - fullPath: '/posts/$postId' - preLoaderRoute: typeof PostsPostIdRouteImport - parentRoute: typeof PostsRoute - } - '/_pathlessLayout/_nested-layout': { - id: '/_pathlessLayout/_nested-layout' - path: '' - fullPath: '/' - preLoaderRoute: typeof PathlessLayoutNestedLayoutRouteImport - parentRoute: typeof PathlessLayoutRoute - } - '/posts_/$postId/deep': { - id: '/posts_/$postId/deep' - path: '/posts/$postId/deep' - fullPath: '/posts/$postId/deep' - preLoaderRoute: typeof PostsPostIdDeepRouteImport - parentRoute: typeof rootRouteImport - } - '/_pathlessLayout/_nested-layout/route-b': { - id: '/_pathlessLayout/_nested-layout/route-b' - path: '/route-b' - fullPath: '/route-b' - preLoaderRoute: typeof PathlessLayoutNestedLayoutRouteBRouteImport - parentRoute: typeof PathlessLayoutNestedLayoutRoute - } - '/_pathlessLayout/_nested-layout/route-a': { - id: '/_pathlessLayout/_nested-layout/route-a' - path: '/route-a' - fullPath: '/route-a' - preLoaderRoute: typeof PathlessLayoutNestedLayoutRouteARouteImport - parentRoute: typeof PathlessLayoutNestedLayoutRoute - } - } -} - -interface PathlessLayoutNestedLayoutRouteChildren { - PathlessLayoutNestedLayoutRouteARoute: typeof PathlessLayoutNestedLayoutRouteARoute - PathlessLayoutNestedLayoutRouteBRoute: typeof PathlessLayoutNestedLayoutRouteBRoute -} - -const PathlessLayoutNestedLayoutRouteChildren: PathlessLayoutNestedLayoutRouteChildren = - { - PathlessLayoutNestedLayoutRouteARoute: - PathlessLayoutNestedLayoutRouteARoute, - PathlessLayoutNestedLayoutRouteBRoute: - PathlessLayoutNestedLayoutRouteBRoute, - } - -const PathlessLayoutNestedLayoutRouteWithChildren = - PathlessLayoutNestedLayoutRoute._addFileChildren( - PathlessLayoutNestedLayoutRouteChildren, - ) - -interface PathlessLayoutRouteChildren { - PathlessLayoutNestedLayoutRoute: typeof PathlessLayoutNestedLayoutRouteWithChildren -} - -const PathlessLayoutRouteChildren: PathlessLayoutRouteChildren = { - PathlessLayoutNestedLayoutRoute: PathlessLayoutNestedLayoutRouteWithChildren, -} - -const PathlessLayoutRouteWithChildren = PathlessLayoutRoute._addFileChildren( - PathlessLayoutRouteChildren, -) - -interface PostsRouteChildren { - PostsPostIdRoute: typeof PostsPostIdRoute - PostsIndexRoute: typeof PostsIndexRoute -} - -const PostsRouteChildren: PostsRouteChildren = { - PostsPostIdRoute: PostsPostIdRoute, - PostsIndexRoute: PostsIndexRoute, -} - -const PostsRouteWithChildren = PostsRoute._addFileChildren(PostsRouteChildren) - -const rootRouteChildren: RootRouteChildren = { - IndexRoute: IndexRoute, - PathlessLayoutRoute: PathlessLayoutRouteWithChildren, - PostsRoute: PostsRouteWithChildren, - PostsPostIdDeepRoute: PostsPostIdDeepRoute, -} -export const routeTree = rootRouteImport - ._addFileChildren(rootRouteChildren) - ._addFileTypes() - -import type { getRouter } from './router.tsx' -import type { createStart } from '@tanstack/react-start' -declare module '@tanstack/react-start' { - interface Register { - ssr: true - router: Awaited> - } -} diff --git a/examples/react/start-basic-rsc/src/routes/__root.tsx b/examples/react/start-basic-rsc/src/routes/__root.tsx deleted file mode 100644 index 0a5e0bf370..0000000000 --- a/examples/react/start-basic-rsc/src/routes/__root.tsx +++ /dev/null @@ -1,125 +0,0 @@ -/// -import { - HeadContent, - Link, - Outlet, - Scripts, - createRootRoute, -} from '@tanstack/react-router' -import { TanStackRouterDevtools } from '@tanstack/react-router-devtools' -import * as React from 'react' -import { DefaultCatchBoundary } from '~/components/DefaultCatchBoundary' -import { NotFound } from '~/components/NotFound' -import appCss from '~/styles/app.css?url' -import { seo } from '~/utils/seo' - -export const Route = createRootRoute({ - head: () => ({ - meta: [ - { - charSet: 'utf-8', - }, - { - name: 'viewport', - content: 'width=device-width, initial-scale=1', - }, - ...seo({ - title: - 'TanStack Start | Type-Safe, Client-First, Full-Stack React Framework', - description: `TanStack Start is a type-safe, client-first, full-stack React framework. `, - }), - ], - links: [ - { rel: 'stylesheet', href: appCss }, - { - rel: 'apple-touch-icon', - sizes: '180x180', - href: '/apple-touch-icon.png', - }, - { - rel: 'icon', - type: 'image/png', - sizes: '32x32', - href: '/favicon-32x32.png', - }, - { - rel: 'icon', - type: 'image/png', - sizes: '16x16', - href: '/favicon-16x16.png', - }, - { rel: 'manifest', href: '/site.webmanifest', color: '#fffff' }, - { rel: 'icon', href: '/favicon.ico' }, - ], - }), - errorComponent: (props) => { - return ( - - - - ) - }, - notFoundComponent: () => , - component: RootComponent, -}) - -function RootComponent() { - return ( - - - - ) -} - -function RootDocument({ children }: { children: React.ReactNode }) { - return ( - - - - - -
    - - Home - {' '} - - Posts - - - Pathless Layout - - - This Route Does Not Exist - -
    -
    - {/* {children} */} - {children} - - - - - ) -} diff --git a/examples/react/start-basic-rsc/src/routes/_pathlessLayout.tsx b/examples/react/start-basic-rsc/src/routes/_pathlessLayout.tsx deleted file mode 100644 index c3b12442b8..0000000000 --- a/examples/react/start-basic-rsc/src/routes/_pathlessLayout.tsx +++ /dev/null @@ -1,16 +0,0 @@ -import { Outlet, createFileRoute } from '@tanstack/react-router' - -export const Route = createFileRoute('/_pathlessLayout')({ - component: LayoutComponent, -}) - -function LayoutComponent() { - return ( -
    -
    I'm a layout
    -
    - -
    -
    - ) -} diff --git a/examples/react/start-basic-rsc/src/routes/_pathlessLayout/_nested-layout.tsx b/examples/react/start-basic-rsc/src/routes/_pathlessLayout/_nested-layout.tsx deleted file mode 100644 index c5bcffd5a4..0000000000 --- a/examples/react/start-basic-rsc/src/routes/_pathlessLayout/_nested-layout.tsx +++ /dev/null @@ -1,34 +0,0 @@ -import { Link, Outlet, createFileRoute } from '@tanstack/react-router' - -export const Route = createFileRoute('/_pathlessLayout/_nested-layout')({ - component: LayoutComponent, -}) - -function LayoutComponent() { - return ( -
    -
    I'm a nested pathless layout
    -
    - - Go to route A - - - Go to route B - -
    -
    - -
    -
    - ) -} diff --git a/examples/react/start-basic-rsc/src/routes/_pathlessLayout/_nested-layout/route-a.tsx b/examples/react/start-basic-rsc/src/routes/_pathlessLayout/_nested-layout/route-a.tsx deleted file mode 100644 index 0213f1516f..0000000000 --- a/examples/react/start-basic-rsc/src/routes/_pathlessLayout/_nested-layout/route-a.tsx +++ /dev/null @@ -1,10 +0,0 @@ -import { createFileRoute } from '@tanstack/react-router' -export const Route = createFileRoute('/_pathlessLayout/_nested-layout/route-a')( - { - component: LayoutAComponent, - }, -) - -function LayoutAComponent() { - return
    I'm A!
    -} diff --git a/examples/react/start-basic-rsc/src/routes/_pathlessLayout/_nested-layout/route-b.tsx b/examples/react/start-basic-rsc/src/routes/_pathlessLayout/_nested-layout/route-b.tsx deleted file mode 100644 index 3d909523fb..0000000000 --- a/examples/react/start-basic-rsc/src/routes/_pathlessLayout/_nested-layout/route-b.tsx +++ /dev/null @@ -1,10 +0,0 @@ -import { createFileRoute } from '@tanstack/react-router' -export const Route = createFileRoute('/_pathlessLayout/_nested-layout/route-b')( - { - component: LayoutBComponent, - }, -) - -function LayoutBComponent() { - return
    I'm B!
    -} diff --git a/examples/react/start-basic-rsc/src/routes/posts.$postId.tsx b/examples/react/start-basic-rsc/src/routes/posts.$postId.tsx deleted file mode 100644 index f3dba9bfd3..0000000000 --- a/examples/react/start-basic-rsc/src/routes/posts.$postId.tsx +++ /dev/null @@ -1,45 +0,0 @@ -import { ErrorComponent, Link, createFileRoute } from '@tanstack/react-router' -import { createServerFn } from '@tanstack/react-start' -import { fetchPost } from '../utils/posts' -import type { ErrorComponentProps } from '@tanstack/react-router' -import { NotFound } from '~/components/NotFound' - -const renderPost = createServerFn({ method: 'GET' }) - .inputValidator((postId: string) => postId) - .handler(async ({ data }) => { - const post = await fetchPost(data) - - return ( -
    -

    {post.title}

    -
    {post.body}
    - - Deep View - -
    - ) - }) - -export const Route = createFileRoute('/posts/$postId')({ - loader: async ({ params: { postId } }) => renderPost({ data: postId }), - errorComponent: PostErrorComponent, - component: PostComponent, - notFoundComponent: () => { - return Post not found - }, -}) - -export function PostErrorComponent({ error }: ErrorComponentProps) { - return -} - -function PostComponent() { - return Route.useLoaderData() -} diff --git a/examples/react/start-basic-rsc/src/routes/posts.index.tsx b/examples/react/start-basic-rsc/src/routes/posts.index.tsx deleted file mode 100644 index c659274567..0000000000 --- a/examples/react/start-basic-rsc/src/routes/posts.index.tsx +++ /dev/null @@ -1,8 +0,0 @@ -import { createFileRoute } from '@tanstack/react-router' -export const Route = createFileRoute('/posts/')({ - component: PostsIndexComponent, -}) - -function PostsIndexComponent() { - return
    Select a post.
    -} diff --git a/examples/react/start-basic-rsc/src/routes/posts.tsx b/examples/react/start-basic-rsc/src/routes/posts.tsx deleted file mode 100644 index a3ef2a2e20..0000000000 --- a/examples/react/start-basic-rsc/src/routes/posts.tsx +++ /dev/null @@ -1,16 +0,0 @@ -import { createFileRoute } from '@tanstack/react-router' -import { createServerFn, renderRsc } from '@tanstack/react-start' -import { renderPosts } from '~/utils/renderPosts' - -export const serverRenderPosts = createServerFn({ method: 'GET' }).handler( - renderPosts, -) - -export const Route = createFileRoute('/posts')({ - loader: async () => serverRenderPosts(), - component: PostsComponent, -}) - -function PostsComponent() { - return renderRsc(Route.useLoaderData()) -} diff --git a/examples/react/start-basic-rsc/src/routes/posts_.$postId.deep.tsx b/examples/react/start-basic-rsc/src/routes/posts_.$postId.deep.tsx deleted file mode 100644 index 13d368cf9c..0000000000 --- a/examples/react/start-basic-rsc/src/routes/posts_.$postId.deep.tsx +++ /dev/null @@ -1,26 +0,0 @@ -import { Link, createFileRoute } from '@tanstack/react-router' -import { fetchPost } from '../utils/posts' -import { PostErrorComponent } from './posts.$postId' - -export const Route = createFileRoute('/posts_/$postId/deep')({ - loader: async ({ params: { postId } }) => fetchPost(postId), - errorComponent: PostErrorComponent, - component: PostDeepComponent, -}) - -function PostDeepComponent() { - const post = Route.useLoaderData() - - return ( -
    - - ← All Posts - -

    {post.title}

    -
    {post.body}
    -
    - ) -} diff --git a/examples/react/start-basic-rsc/src/styles/app.css b/examples/react/start-basic-rsc/src/styles/app.css deleted file mode 100644 index 0ef1bc98da..0000000000 --- a/examples/react/start-basic-rsc/src/styles/app.css +++ /dev/null @@ -1,40 +0,0 @@ -@import 'tailwindcss' source('../'); - -@source '../**/*.{js,jsx,ts,tsx}'; - -/* - The default border color has changed to `currentcolor` in Tailwind CSS v4, - so we've added these compatibility styles to make sure everything still - looks the same as it did with Tailwind CSS v3. - - If we ever want to remove these styles, we need to add an explicit border - color utility to any element that depends on these defaults. -*/ -@layer base { - *, - ::after, - ::before, - ::backdrop, - ::file-selector-button { - border-color: var(--color-gray-200, currentcolor); - } -} - -@layer base { - html { - color-scheme: light dark; - } - - * { - @apply border-gray-200 dark:border-gray-800; - } - - html, - body { - @apply text-gray-900 bg-gray-50 dark:bg-gray-950 dark:text-gray-200; - } - - .using-mouse * { - outline: none !important; - } -} diff --git a/examples/react/start-basic-rsc/src/utils/posts.tsx b/examples/react/start-basic-rsc/src/utils/posts.tsx deleted file mode 100644 index 16fc1744e6..0000000000 --- a/examples/react/start-basic-rsc/src/utils/posts.tsx +++ /dev/null @@ -1,35 +0,0 @@ -// import { notFound } from '@tanstack/react-router' -// import { createServerFn } from '@tanstack/react-start' -import axios from 'redaxios' - -export type PostType = { - id: string - title: string - body: string -} - -export const fetchPost = async (postId: string) => { - 'use server' - console.info(`Fetching post with id ${postId}...`) - await new Promise((r) => setTimeout(r, 500)) - const post = await axios - .get(`https://jsonplaceholder.typicode.com/posts/${postId}`) - .then((r) => r.data) - .catch((err) => { - if (err.status === 404) { - // throw notFound() - } - throw err - }) - - return post -} - -export const fetchPosts = async () => { - 'use server' - console.info('Fetching posts...') - await new Promise((r) => setTimeout(r, 500)) - return axios - .get>('https://jsonplaceholder.typicode.com/posts') - .then((r) => r.data.slice(0, 10)) -} diff --git a/examples/react/start-basic-rsc/src/utils/renderPosts.tsx b/examples/react/start-basic-rsc/src/utils/renderPosts.tsx deleted file mode 100644 index 37c0661217..0000000000 --- a/examples/react/start-basic-rsc/src/utils/renderPosts.tsx +++ /dev/null @@ -1,63 +0,0 @@ -'use server' - -import React from 'react' -import { fetchPosts } from './posts' - -export async function renderPosts() { - const posts = await fetchPosts() - - posts.state = posts.state || { - status: 'pending', - promise: Promise.resolve(), - } - - return ( -
    -
      - {[...posts, { id: 'i-do-not-exist', title: 'Non-existent Post' }]?.map( - (post) => { - return ( -
    • - {post.title.substring(0, 20)} - {/* -
      {post.title.substring(0, 20)}
      - */} -
    • - ) - }, - )} -
    -
    - Loading...
    }> - - -
    - ) -} - -function DelayedDateViaSuspense({ state }) { - // a component that will suspend for 1 second and then show the current date - if (state.status === 'pending') { - state.promise = new Promise((resolve) => { - setTimeout(() => { - state.status = 'success' - resolve() - }, 5000) - }) - throw state.promise - } - - return
    {new Date().toISOString().replace('T', ' ').split('.')[0]}
    -} - -// ...fetchPosts -// posts -// ...5000 -// timestamp diff --git a/examples/react/start-basic-rsc/src/utils/seo.ts b/examples/react/start-basic-rsc/src/utils/seo.ts deleted file mode 100644 index d18ad84b74..0000000000 --- a/examples/react/start-basic-rsc/src/utils/seo.ts +++ /dev/null @@ -1,33 +0,0 @@ -export const seo = ({ - title, - description, - keywords, - image, -}: { - title: string - description?: string - image?: string - keywords?: string -}) => { - const tags = [ - { title }, - { name: 'description', content: description }, - { name: 'keywords', content: keywords }, - { name: 'twitter:title', content: title }, - { name: 'twitter:description', content: description }, - { name: 'twitter:creator', content: '@tannerlinsley' }, - { name: 'twitter:site', content: '@tannerlinsley' }, - { name: 'og:type', content: 'website' }, - { name: 'og:title', content: title }, - { name: 'og:description', content: description }, - ...(image - ? [ - { name: 'twitter:image', content: image }, - { name: 'twitter:card', content: 'summary_large_image' }, - { name: 'og:image', content: image }, - ] - : []), - ] - - return tags -} diff --git a/examples/react/start-basic-static/package.json b/examples/react/start-basic-static/package.json index 0936b46b18..4a46727ba5 100644 --- a/examples/react/start-basic-static/package.json +++ b/examples/react/start-basic-static/package.json @@ -10,23 +10,23 @@ "start": "pnpx srvx --prod -s ../client dist/server/server.js" }, "dependencies": { - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/react-start": "^1.167.16", - "@tanstack/start-static-server-functions": "^1.166.25", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/react-start": "^1.168.18", + "@tanstack/start-static-server-functions": "^1.167.11", "@vitejs/plugin-react": "^6.0.1", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", - "tailwind-merge": "^2.6.0" + "tailwind-merge": "^3.6.0" }, "devDependencies": { + "@tailwindcss/vite": "^4.2.2", "@types/node": "^22.5.4", "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", - "@tailwindcss/vite": "^4.2.2" + "vite": "^8.0.14" } } diff --git a/examples/react/start-basic/package.json b/examples/react/start-basic/package.json index efba12ffdf..68231c1817 100644 --- a/examples/react/start-basic/package.json +++ b/examples/react/start-basic/package.json @@ -10,13 +10,13 @@ "start": "node .output/server/index.mjs" }, "dependencies": { - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/react-start": "^1.167.16", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/react-start": "^1.168.18", "react": "^19.0.0", "react-dom": "^19.0.0", - "tailwind-merge": "^2.6.0", - "zod": "^3.24.2" + "tailwind-merge": "^3.6.0", + "zod": "^4.4.3" }, "devDependencies": { "@tailwindcss/vite": "^4.2.2", @@ -27,6 +27,6 @@ "nitro": "^3.0.260311-beta", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/start-basic/tsconfig.json b/examples/react/start-basic/tsconfig.json index cef9369516..cc479423a1 100644 --- a/examples/react/start-basic/tsconfig.json +++ b/examples/react/start-basic/tsconfig.json @@ -1,16 +1,16 @@ { - "include": ["**/*.ts", "**/*.tsx"], + "include": ["**/*.ts", "**/*.tsx", "**/*.d.ts"], "compilerOptions": { "strict": true, "esModuleInterop": true, "jsx": "react-jsx", "module": "ESNext", "moduleResolution": "Bundler", - "lib": ["DOM", "DOM.Iterable", "ES2022"], + "lib": ["DOM", "DOM.Iterable", "ES2024"], "isolatedModules": true, "resolveJsonModule": true, "skipLibCheck": true, - "target": "ES2022", + "target": "ES2024", "allowJs": true, "forceConsistentCasingInFileNames": true, "paths": { diff --git a/examples/react/start-bun/package.json b/examples/react/start-bun/package.json index 2749cc82d8..fc6f512958 100644 --- a/examples/react/start-bun/package.json +++ b/examples/react/start-bun/package.json @@ -15,11 +15,11 @@ "dependencies": { "@tailwindcss/vite": "^4.2.2", "@tanstack/react-devtools": "^0.7.0", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/react-router-ssr-query": "^1.166.10", - "@tanstack/react-start": "^1.167.16", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/react-router-ssr-query": "^1.167.1", + "@tanstack/react-start": "^1.168.18", + "@tanstack/router-plugin": "^1.168.13", "react": "^19.1.1", "react-dom": "^19.1.1", "tailwindcss": "^4.2.2" @@ -36,8 +36,8 @@ "jsdom": "^27.0.0", "prettier": "^3.6.2", "typescript": "^6.0.2", - "vite": "^8.0.0", - "vitest": "^3.2.4", + "vite": "^8.0.14", + "vitest": "^4.1.4", "web-vitals": "^5.1.0" } } diff --git a/examples/react/start-clerk-basic/package.json b/examples/react/start-clerk-basic/package.json index 5e2ce13236..f2a478db54 100644 --- a/examples/react/start-clerk-basic/package.json +++ b/examples/react/start-clerk-basic/package.json @@ -11,15 +11,15 @@ }, "dependencies": { "@clerk/tanstack-react-start": "^0.27.14", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/react-start": "^1.167.16", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/react-start": "^1.168.18", "@vitejs/plugin-react": "^6.0.1", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", "srvx": "^0.11.9", - "tailwind-merge": "^2.6.0" + "tailwind-merge": "^3.6.0" }, "devDependencies": { "@tailwindcss/vite": "^4.2.2", @@ -28,6 +28,6 @@ "@types/react-dom": "^19.0.3", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/start-convex-trellaux/package.json b/examples/react/start-convex-trellaux/package.json index 2a712d3e1a..232b681438 100644 --- a/examples/react/start-convex-trellaux/package.json +++ b/examples/react/start-convex-trellaux/package.json @@ -15,10 +15,10 @@ "@convex-dev/react-query": "0.0.0-alpha.8", "@tanstack/react-query": "^5.90.0", "@tanstack/react-query-devtools": "^5.90.0", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/react-router-ssr-query": "^1.166.10", - "@tanstack/react-start": "^1.167.16", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/react-router-ssr-query": "^1.167.1", + "@tanstack/react-start": "^1.168.18", "concurrently": "^8.2.2", "convex": "^1.19.0", "ky": "^1.7.4", @@ -27,8 +27,8 @@ "react-dom": "^19.0.0", "react-hot-toast": "^2.5.1", "redaxios": "^0.5.1", - "tailwind-merge": "^2.6.0", - "zod": "^3.24.2" + "tailwind-merge": "^3.6.0", + "zod": "^4.4.3" }, "devDependencies": { "@tailwindcss/vite": "^4.2.2", @@ -38,6 +38,6 @@ "@vitejs/plugin-react": "^6.0.1", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/start-convex-trellaux/src/db/schema.ts b/examples/react/start-convex-trellaux/src/db/schema.ts index 99bd5e220b..74c449e894 100644 --- a/examples/react/start-convex-trellaux/src/db/schema.ts +++ b/examples/react/start-convex-trellaux/src/db/schema.ts @@ -6,9 +6,9 @@ export const itemSchema = z.object({ id: z.string(), title: z.string(), content: z.string().optional(), - order: z.coerce.number(), + order: z.coerce.number(), columnId: z.string().uuid(), - boardId: z.coerce.string(), + boardId: z.coerce.string(), }) export const deleteItemSchema = itemSchema.pick({ id: true, boardId: true }) diff --git a/examples/react/start-counter/package.json b/examples/react/start-counter/package.json index b586634cf8..f85f7411f8 100644 --- a/examples/react/start-counter/package.json +++ b/examples/react/start-counter/package.json @@ -10,9 +10,9 @@ "start": "pnpx srvx --prod -s ../client dist/server/server.js" }, "dependencies": { - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/react-start": "^1.167.16", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/react-start": "^1.168.18", "react": "^19.0.0", "react-dom": "^19.0.0" }, @@ -22,6 +22,6 @@ "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/start-i18n-paraglide/package.json b/examples/react/start-i18n-paraglide/package.json index 0cd8e2a087..06f95888c2 100644 --- a/examples/react/start-i18n-paraglide/package.json +++ b/examples/react/start-i18n-paraglide/package.json @@ -10,9 +10,9 @@ }, "dependencies": { "@tanstack/react-devtools": "^0.7.0", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/react-start": "^1.167.16", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/react-start": "^1.168.18", "react": "^19.1.1", "react-dom": "^19.1.1" }, @@ -22,7 +22,7 @@ "@types/react-dom": "^19.1.9", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "@tailwindcss/vite": "^4.2.2", "tailwindcss": "^4.2.2", "@inlang/paraglide-js": "^2.4.0" diff --git a/examples/react/start-large/package.json b/examples/react/start-large/package.json index ac681479d9..99192b0779 100644 --- a/examples/react/start-large/package.json +++ b/examples/react/start-large/package.json @@ -13,13 +13,13 @@ }, "dependencies": { "@tanstack/react-query": "^5.90.0", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/react-start": "^1.167.16", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/react-start": "^1.168.18", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", - "tailwind-merge": "^2.6.0", + "tailwind-merge": "^3.6.0", "valibot": "^1.0.0-beta.15" }, "devDependencies": { @@ -30,7 +30,7 @@ "@vitejs/plugin-react": "^6.0.1", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" }, "keywords": [], "author": "", diff --git a/examples/react/start-material-ui/package.json b/examples/react/start-material-ui/package.json index 01bc1db244..667f06faf7 100644 --- a/examples/react/start-material-ui/package.json +++ b/examples/react/start-material-ui/package.json @@ -15,12 +15,12 @@ "@emotion/styled": "11.14.0", "@fontsource-variable/roboto": "5.2.5", "@mui/material": "6.4.7", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-start": "^1.167.16", - "@tanstack/react-router-devtools": "^1.166.11", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/react-start": "^1.168.18", "react": "^19.0.0", "react-dom": "^19.0.0", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@types/node": "^22.5.4", @@ -28,6 +28,6 @@ "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/start-basic-rsc/.gitignore b/examples/react/start-rscs/.gitignore similarity index 66% rename from examples/react/start-basic-rsc/.gitignore rename to examples/react/start-rscs/.gitignore index 3c8e6870b3..6ab0517d9f 100644 --- a/examples/react/start-basic-rsc/.gitignore +++ b/examples/react/start-rscs/.gitignore @@ -7,8 +7,14 @@ yarn.lock .env .vercel .output +.nitro /build/ /api/ /server/build /public/build# Sentry Config File .env.sentry-build-plugin +/test-results/ +/playwright-report/ +/blob-report/ +/playwright/.cache/ +.tanstack \ No newline at end of file diff --git a/e2e/react-start/basic-rsc/.prettierignore b/examples/react/start-rscs/.prettierignore similarity index 100% rename from e2e/react-start/basic-rsc/.prettierignore rename to examples/react/start-rscs/.prettierignore diff --git a/examples/react/start-basic-rsc/.vscode/settings.json b/examples/react/start-rscs/.vscode/settings.json similarity index 100% rename from examples/react/start-basic-rsc/.vscode/settings.json rename to examples/react/start-rscs/.vscode/settings.json diff --git a/examples/react/start-basic-rsc/README.md b/examples/react/start-rscs/README.md similarity index 58% rename from examples/react/start-basic-rsc/README.md rename to examples/react/start-rscs/README.md index 494e34f03f..e47983c58e 100644 --- a/examples/react/start-basic-rsc/README.md +++ b/examples/react/start-rscs/README.md @@ -1,23 +1,21 @@ -# TanStack Start - RSC Example +# TanStack Start - Basic Example -This site is built with TanStack Router and React Server Components! +This is the basic TanStack Start example, demonstrating the fundamentals of building applications with TanStack Router and TanStack Start. - [TanStack Router Docs](https://tanstack.com/router) +It's deployed automagically with Netlify! + +- [Netlify](https://netlify.com/) + ## Start a new project based on this example To start a new project based on this example, run: ```sh -npx gitpick TanStack/router/tree/main/examples/react/start-basic-rsc start-basic-rsc +npx gitpick TanStack/router/tree/main/examples/react/start-basic start-basic ``` -## Deployment - -It's deployed automagically with Netlify! - -- [Netlify](https://netlify.com/) - ## Getting Started From your terminal: @@ -27,17 +25,12 @@ pnpm install pnpm dev ``` +This starts your app in development mode, rebuilding assets on file changes. + ## Build -Build for production: +To build the app for production: ```sh pnpm build ``` - -## About This Example - -This example demonstrates: - -- React Server Components (RSC) with TanStack Start -- Server-side rendering diff --git a/examples/react/start-rscs/package.json b/examples/react/start-rscs/package.json new file mode 100644 index 0000000000..97f90b3398 --- /dev/null +++ b/examples/react/start-rscs/package.json @@ -0,0 +1,35 @@ +{ + "name": "tanstack-start-example-rscs", + "private": true, + "sideEffects": false, + "type": "module", + "scripts": { + "dev": "vite dev", + "build": "vite build && tsc --noEmit", + "preview": "vite preview", + "start": "node .output/server/index.mjs" + }, + "dependencies": { + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/react-start": "^1.168.18", + "dexie": "^4.0.10", + "react": "^19.2.0", + "react-dom": "^19.2.0", + "tailwind-merge": "^3.6.0", + "zod": "^4.4.3", + "zustand": "^5.0.10" + }, + "devDependencies": { + "@tailwindcss/vite": "^4.1.18", + "@types/node": "22.10.2", + "@types/react": "^19.2.2", + "@types/react-dom": "^19.2.2", + "@vitejs/plugin-react": "^6.0.1", + "@vitejs/plugin-rsc": "^0.5.20", + "nitro": "npm:nitro-nightly@latest", + "tailwindcss": "^4.1.18", + "typescript": "^5.7.2", + "vite": "^8.0.14" + } +} diff --git a/e2e/react-start/basic-rsc/public/android-chrome-192x192.png b/examples/react/start-rscs/public/android-chrome-192x192.png similarity index 100% rename from e2e/react-start/basic-rsc/public/android-chrome-192x192.png rename to examples/react/start-rscs/public/android-chrome-192x192.png diff --git a/e2e/react-start/basic-rsc/public/android-chrome-512x512.png b/examples/react/start-rscs/public/android-chrome-512x512.png similarity index 100% rename from e2e/react-start/basic-rsc/public/android-chrome-512x512.png rename to examples/react/start-rscs/public/android-chrome-512x512.png diff --git a/e2e/react-start/basic-rsc/public/apple-touch-icon.png b/examples/react/start-rscs/public/apple-touch-icon.png similarity index 100% rename from e2e/react-start/basic-rsc/public/apple-touch-icon.png rename to examples/react/start-rscs/public/apple-touch-icon.png diff --git a/examples/react/start-rscs/public/example-guitar-flowers.jpg b/examples/react/start-rscs/public/example-guitar-flowers.jpg new file mode 100644 index 0000000000000000000000000000000000000000..debe785efe0baf60f79e3da75c7d9a6dbccb570e GIT binary patch literal 641048 zcmbrlcUY3|8~=?XSB|nY&7GPnE6tn%j&hdUEHy{k$1D|5a|>=8C~h0ha<Z!2JL~Kv+OfSXfA8pRgc65O735P)K;+K@kmrsH~CLAsdgw zAyBzvnZ@<%;>I0)-{mzIHnePyXrJ*^xGr(rE;h^LtfJ0&ucwzoOZwkTEb_0Y%ume! zFCxDQg8YC&qGJ5Lb_W51f`EO3|BELi4A>_u#E*9nAS|n4w9n?yF^>=t==xzzV}3ka zezXNqxecu|p4a6~_>r`|_%WWw?fnKw3JLIUk$)N(u;Z?;_2Rmf)W!}goPv;KZ@2=n zU8h55Q<2a$Nd=}VaW*wu1la%WSyf6pxR>`y6BD)L=jo($u#n4~4ee&`%2c?CNCwos z=-`;Gg8U&|ATUvf#;opgPL;uJ5prWFRsc6nX6N!1BloA$aMuC+LNui6 z5Vd-kiqB{SzA+Udpm(X{?L9!v$&%Anq3Cot+>M64AkvA(mXZm((>)1&_lXL-X*dbT z5o#x{b9#MP3woZr#!gv-^5E%M5l00&wnI%Ftjr70RRi{n?*ZCK6fQzn2v6!{>;cr; zgvG5?-fj^h55%4Z8ljS`xlG=`^a|+H5p_wT=u~(*x@UZsX+d9zx!$c_{RRj^W0xr` zso}+stUW-$9w1~;KsXG>3u5;9D=J#dR0$On4s39EuqyfVnCmTCwE>WBP_t?mlerDt zIq4QPY(=ynz?KB)STUs+3g$vuEV$h+ugW)DL|%@DnJT64rmjL~A)Ufb!#LU`xwphP zHJl-mz`!lnh?UJ#yFmkh6cz_tPwmUzFRJ>8%c~6(s|rq_qDd&}rL;Z3shWYD_}WSm zp2A|_Li-LCWGGrm<)`O?+oqTMviTu8G%*Vp9B2KdTIjB-{(-n|wM*DI3T>vKhk?hS zwv`a!Xi{f0dJcO|!DtCl1neYC$H+88Dk*(2i8_-p2{US!dWWnzJqftO0Fq8LQBeo- zh@VtUUvO9^n*&D!tss5bhm{KWxkb7X+$wR<{tr&u;6Uu;EIUE%_3Wv7O%?|Y&jjs) z!FPyhEXI7Vx!M++*)J=mRs7G0@-ICPC`$XV!<570(F5sQyD(mQU$!csv>i9b#E1Y2 ziHa6j)W8xDL%N?pRth`VP9MjHWY3g#?iaUOnn&89u-mxkJpgD{!DwN7m&HmKz%y$O zOQ&y83FbnPp-M27AvV-n+8!Il?djPAz$-<_qG&G!Pe(J9Mo3Ffa(7&Vdu1PX)X_qu zhDXjrQ0$^~X@}6Nm^QBt5T2)+O+f7d?h*UUl}MA_gy~sG6`T+)ZyzfLU`2~IkwUuG zTw&QTq14#)Q=3Evw><?H`WmkWW2g1N-6(-2_US#R6V){F)1AcrU!cykUv)Ck z+&#d!qz*C$UCoUFv!XDou%JBb{rI9Y1k|5<1Qd{W6~DgVsLreYx(AT?B80U{N$AU& zFC?lFHe@ghnX3(%%>G!Z>(#_A>+t zN$)AxMW+(Rz7ZOcuK3_ymMOM=XvV@yt%Caz8E7ye!|S4DB3N9rApjU05aW)3uf!F1 z##%uL^j!v4Sj?kO&s=4rss>9~2N7yqK+SP0slGap4b+YsZke4*!!UO7!Fz!1<_#QU zXb(_C!+vUq(|Om1>_HzTxlZE)u#+Fol$=2=DI*-HSk9|`YgHiB#5HI`pF>K4hzr~TsG9*W_12u_SbQ9VswZcVj2fHk{#|yTe?)&e$T$rdk z?VdNRqxGUNFiB+{yMLfk``uqe`oB23#?Hq-x5E|Hhiackqg8&j7QR8RFn0p)XCQ9^uyoC%!+`Z6{4p6O*>*vK5B6Ib9{$;){<4RnWTu zkKg~X|0xx1g@`+}b2lRA>-(o~{lC(U=Jx>oF4FaS{bN3lJ*$nTHt+5M{zWx;J@lNi z^ zcT|TAt+O&x!FPR_Rt*%cqTSdZXhVFXYa35BprHNwTd$iE>A~mouB@EHAx*y8SHpcOjr2;5j%p&l+|b~s|#hjEgR^0fe(mF zY)_Hjijae3zs0!P>dl?ex3OU+IrqqjTyVlgzZ=iAs!SXX-|I7Pap`*(m%n zxlq^i;wA8BhkfaFV0D0HBi&$JE!cAUdi`B_Yo!vIXVP%}Le`&eWxg79MaYxS zS|%P#TK~z7YJU^$q~DXX0+ihtCBOr%lZGSoGd*Wesf1GXhM^<15uyJ~k@p9%~C5>9fUy|OhJGDl>D|vCw z^PgpBy+6+X`<;rizxE~RryIyFj)AwYPdX@&z3+X&MgbhjQ0D=C{VhOhe7H&ErIraJ{b)g40e>J|k znw;q_uvx($WEleWsZqo9&t>D*SBj0V>f_%BmD|ajjTWr##^aA1wLDZyp&TLBOQ&7V z1~lY~O5CRBgv;iei33kw$-SY~>g@TmG<%Tu4!J~r@pq%b*Dk*P=jEatlMSc<_WlRY zw&U)Ac)9dV!5Bny`osq%4}Xe2+cN1U>N))UitgJJ@!P-u*oez|q&7BOh%nY`bSKJI&LiVEtVFJ5l1yY8!y7C~!Wd|CNtm>y7t5$vZ!l1U8-&gRt$kofa!eMy>l@vog_}5y-W>E?(Zq!D& zpdDHgYqSEoYL!VJPry!{+Msy(2Fk*7*IL|M3M)Sake8jLlk;4R-lMV~e-|5-I51j9 zi8gO4AtyF=UVd7(vB~i&oR=&v#tbKHk8q@AnmDO#1Lxr#@!u>0-iXYNzh>Noz@}G3 z6*dar8N9e7v1;}5t-Dq+G&DB|BqsbKahi1P9%^>rgJTm3)0nZX z1$C)mK#|cJ6t#oh!J_QR^<7*VgvJihomSfF)=D4|qEKhA2w-CYL$Tn4$cu>_88kMt zn2JtMRHD{i;$7=8Tb!S-%0ynuP$YC?(O^TQxSoQQ4Az`lNN|Ht2a@J_@Kcw#@FH_} z{hr)(__&}~2NpG-5{^#5lL>LN#LO~U`;Zk$QwI-^g!SxLq6EO~gM>KhE=dI=&?&B` z17$)9F%B(sTniranj@d?%3&|W$QHcCFB7Jx|CuuAS}`@Hr5&1^V8WInW4Cl$Hm>HE zih8YEb6Yx!T8$Mm*W7g-2u{Fv!Ykr-RriCMqd^~odt+>7quo%ZBSSj`AqcH&F()bm z1RL1E!{%!5DJ$fZGRyG_Lf6j_)R8uYOR0qiye35WveBNu&~$tKi?#mnv}QNYE0c`o zWk&{A!4&Adi`5p}y{eBq)p$_)-ZR2N{oCH+@DQ(?Y+6n8M{uU8Tf&{s_1=I%a z2Vnx>hV8-U4>%67iJq9}9;x=hl)?MRJ<};7 zL&*rHOBNPqBi-DMVOOYx&M~AxR7a7cqDtp3n?xp{la7_diU|u4(n^fFXyn>xeXnAK z8g3mAr4y8*I)j6IGZe7UEkdTQa)~_4-=Y= z3GOvx!I6_)EHvugL}LF zhc`@$qzK{9T$~j(Tb0XW$HQaf8``N~!umJgG#w^4c9>xkXm<|4glDBvI5 zG+%XZ_GOefjmzu-QZXGg6t9krD8#R4$#A)e95^vsH!N{TU^krK3Q(08dmh2y&cmwA zio{5$CFYU%M9v<-k{|-8v!Q1GGnW{l(zuvVUb^%r(h>-c-%y**IUtj!s^EqRnVosl z+%qlu;5GZFBw%T&bc@670b)WkOQ1C~YhZB29^fIKQX`hiz>am&SnFqXrm8cjy9{uk z?AK_w^i?*D&^8>b8X;5IRj*+?@b+R7P%(6kzuitTb__b!E6s5PCT zt6*fJWpS-^66Up}wzGvhfGA2=b91BZO0sy}v@LFuhAUP_E3AMkx;t}-+$p36CeRq7 z(T7BIy%QByt(B;l^bB)?n&!?%psWq(VoU_csLTP&dWrfq9xL^&Qc{4xp z3Px+^;>zn{Pbr{Co=KzTwlGQBWvQnJ5U zdLQ?6h_ze-hiiUXK`4^1JOgEOh-pkUBAY}wcS?1xA(11xy)bjSfk{Jzf-mxdYWLAL zX=_&LK$&I+@sIkdn5*;-z8%L@C9zK_6;C8wKC{`o8#)c=G!lW|sh|g}Cx+ zo@EJTh|{r6shpnloprvBV3F7|v_XgT-fbEpQDMzNL{d)pU{L}~ptc4GG#ls5eKOEw z!Fn*AI-J6l3XQE`{Ekzsz!^RTg#Dtd;G&7gec zzFuT(pTLO$*VEOIp?%OSacXBI$$V&Fnj`&ZGq^u55r_VtDn*X*%0%p8R~aDg+u9vY z*QV?4_AYVLeaBK3K_4c+Ve3b65h=3VRhM62pKqG zcmAPh`rRSCBnLxc)*h@%D}4Yf0Vq$HNo82gQ)h_R zWpL{Y$x6j*B4(=SjBpFWBmv^8Z(J38sEUT*FcooMIQfyJ+-xMYDqNG0&cN2;miy?q z=_5GRheq?pXR0Di+4wYM6D)jrYav8SxnM-0cjm>C&CnUVCKQ`7E{%s|IYgFNNx}oN z{~7g}sv)`jpV-v?;C^c@L04(hVJoJh4#7eb46*f-b{uIYk}@DeGs^m}QEYi~5@2{MqQ zD=FQZ&L3ze*55TSg&~DI<}-XCqg;#4A@0uiLkm8JMsY#tPf0oo1TErh?F?hS%ZjxI z6d{Rf#zOyrf@)RCDjNufkR}EVM$PR3bWT~7?xs+8Y1cYG^ko)L?$B1?ulE4?a_YJU zN;)%aexs-~@|sw2;V*)cD!&6S!KzM}@$bk<2QA(=11V$n_VEEt%)D;t=F-NFquS(* zG$(ivV=u05pkpBlMD2!RrYG+&*uhFMsMHh&ldb?9n!Q%>18pq~AybN=EAVqNwxV)U z#YIJ~qU}QoGt#@e(V}!ec`5#E|49Zn(W^|$mhThQSu4g1iH7`3C0V6X`&k0!Lo$(} zu(_QX)jxfN2N|R5-U2!(0o9MJ1oZ>1qUk+G{r5dH%PWdRtUZ60$+UV-6^W)ZS7T+Q zEN$LeCv0~#rx$!*5=>`)Qb0+SRu=+|Q;S5=iD1JG{=L0n07{v*Htx7Ty{pbRUh6Q{ zg8Y6Z#JQi`mk@9iJ97GpWd_o-xvW;tj37dvbZy=eHPy7OW>UUH>c zX#rEsLS7ucjVnm?9gFg$d!xKF8hYg8-mjYJl{eZ%Bp5*(>lz*XN>UzNc#)j=dRzF% zWlF)3=kIdE5JzW6EUH`c6~7cg`28Hb;?jaHn(WU3GZt zl^-8&KmPDWuHltkfc)>tn6&6Z)n|+|n=i*W_SzOUZ4u$D}f!nPPgcdRTai z8Yjn*LoG@FbT!(-A|8wQ*kn@8UcINUEx*_3`vedXXa`V}70c>C3F z3)uzi`KumVSub0W_l)G@NO*&9LBJs54bD4ey>x)h$>bhjey9y zy6-B`K_}Q$hmBY}oj9}vjn&L3mn}aapig^a?^E4wBc!9KL;_*~JpXFOQVNwtWrZ|M zGZ^hMB(y2We{=H6)@{GufpavbNcZ|5%X$|6RVbj zm&?ko1ilihytVRU{o6vs9$+A}KP}pGGfT#pMgjblIkU3(=jupF-^Ket9c`yaP1{R8 zx^SY#&V>hK4Y~CrXBys0+xjrP!!(~s+;q_M3U1IvSWK3@tAiVRWoL-8qZp33KN23o z-$+}9Yu}%FJ3DTlYRE{GTYf?4R{m+CVs*SDr@~qi;k^c?@?;gV41A`QgI>?zBWAUK z)*F{MqDBSRZ7oOK1Ia=idX5@bso%g1o!6j4hg)a6{;GJTi+ewervUXFWAdMLWTA7z zf_3$r;rzNEyj#yFr-%IAlE9#j6YJrQ*0 z{pk0b9S#-0{IY#Mklj_I~%e zCeWcW?5SXTI0Gf)Z0T8^`_yQYTZuEaxQS{oRlfK2J_=k^uM)RSI~}Uwu~FU{a(h#} zUtB}{r1Al6Gekn|9>6zt-^fAP;-KLkyGFm;Y1=j3l5nnqu1E)O{P`NvgPecCK8(*wB0dA}Jt{8ZkPSW+}bmdbirreVCMZtKD$q^oi7dJS@o=X9P3Ce4>ndTQgXb1k?|bN`x*5MaP&%s<3grZ&Emc2 zxd&3wy{8QZgpnmj0sp37+@*;#wk~I^Xja zKk9k#a7K&Bvkt9OdGT4+nlX?qeAoNC$6ln*oVaGK{={>5HS*N;eR2NmkXPZCyc|pS z<$lfye7FVGax5GZkBHJAiRzZKeq$4I5xA^j@Xz@Q(7^C;RnVC_li5F3O^aX;|Ffqe zu9NVSrJ+Spu z*gBt(;ZRZOeps;d(e-c*-_(5xXbT1%ATypDXzrwJQ~bz!v&cG-?F*Z7TgJRLQL1s= zd^%)bQL1x++#2bMo*pp$pSL0Q73TS>?vYr6}DMMa~(<25{=efZ)V>{9qIwKX

    Y)Z*QWh>wK@DYnzz-cIvkUpe`1 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

    P_ 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Ÿj8XjzQRi$f774>}b~5o*aPjTMZQ|4$JF{J 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

    F z7<+h^m8&&e6^JOOyEJRq5#pGp^LrG8*f`Rh1$^{20AJCq=P* z`;SawupW z7OWIARPM<+#>Y5?$%5F>a;^hbq+64>PQRAeObj|m`bxEa&%qyHxZn0vsyZi!og6PF zd2t$4I}o+rZ;p}L9TqrrzN3RCpBFA5sk2$dAaHUPF$kU0okxW~oxxRw|H#T}s;z91 z1bD1{o%0QsVTdVWO`+fulZIg_=eKQ*!sFeH3?k~G*Mi&acB!q2DwsEvJwT$n!NDn_1u4m=M`cOt5jZ9^-0!p7D;2vkkOiLSj8FiMou&)jHMCOAqp>`FVBc2 zK>Vf}qpd1kP+CLn%4Db|P<_l6u9P6w9jriAMAuDRxLPR@JBvUX_`l`Y?yRPoO0nkV z{)v1p_EWDZ`jr}4=M&iR7R@z_xjG1BaVzU{DZK3jQ{-!hGHeXFr1aZi(M}hHh`-c{ zcA3SO1vW&EOWx85WVoy!udQdVc5KM5_xtkZiNey2+CQ#zr%d({@&XN$cYM(KkK(&I zPWEzoDG$$gDYd2bD;cGC9AmI#hhR|}Ng{YnDfsSmj=8i}*zZ;-L<;z9e##eV_(vR~ eFwdp>4Jf$sxrUoL5S%Y44wZ!*yV03X#{UoTIN&A# literal 0 HcmV?d00001 diff --git a/examples/react/start-rscs/public/example-guitar-motherboard.jpg b/examples/react/start-rscs/public/example-guitar-motherboard.jpg new file mode 100644 index 0000000000000000000000000000000000000000..8f1a8d72f855903dc83920bb463ea12632ee3965 GIT binary patch literal 662579 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
    XIGh4}H9j@8n7M7#xsKJj3f#{2m@ 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

    `%sE0ExSCeX#kVN0qdMK5iJ+}3(`=R;l1u;xV0 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 QUz{UyP6&EdM>cFw9qwV#1!9 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�a#Li{PvQ!~~FosPxx<^?_ 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�Q7(Ln0*#et*J~I=r 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%0AQuln<+0Jnb;7tGX#oGB2&XkjLh? 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 literal 0 HcmV?d00001 diff --git a/examples/react/start-rscs/public/example-guitar-racing.jpg b/examples/react/start-rscs/public/example-guitar-racing.jpg new file mode 100644 index 0000000000000000000000000000000000000000..44555574c4fa5088ecb989db40cdbe953408de9d GIT binary patch literal 323790 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%0D$n{m70g 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
    $9FTjyC<=qQZT>v#DZX06AxuOY#*xW8)DBc3b<1 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

    &(mc`KyP}2TJzfN&!Rt@ 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[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 z z-3)D(pyLAlyRjjia?n|gkRytq?(c_jw__!sTThYj)Fv7Xy&Uk~>kS~GhwUDwa&qn_ z{JQx?NTp9P9dF!$KmsgCZSUUTadY{{ZW`&8vdW$J#xp4hIT;W}Sk3ja!>ov?9gtyx z6anNbcO*SYlkGg1POLkvpJKCc;#Go+@e-bt2jal9Z|^<&cb1})Tvo&8=aE*tyxYN} z`8B4B4>0^#IKfi9i@#-d3DHC{GtJFKSc^u0=i89C&eM2MG}ZN7(;?Tt;5cOg7%nI- zs6VtVY$P6HlZkfK))@<8f`_?MIYpo-*##m$lwyq%68b=Z_dr^B6?KYPV!u^OS3p4!BC)U*l}6XsWWJ{-r2<$Y4@8oMMYID|98xBD$bfUma_7S< zA2g@pZONs{lAZ0Lm%+|DQ4c4hE;jx_pROmJpr*74nS%TU>C?1B!sZY{!1G_v>2eCu zb4BnhA?S20$;n;PKwu^^prTSQegDrRrd6O93C=m1ZbzZuLKqBZS9b#(r&_{>seyz8 z`h{S$_>BbN2>O$~Xveimzm~$J!3oB)&24>tcdR%>8_8W17SLiQ4G{PBR$Q))c>Css zm_=89j9P4rfD2Xt403z^$EVa{oGg66_h8fiA?!V)nrhp2-B2W;2!bt0C`u3k>7oe` ziar7XB}i4efFja+?}{x12u(3G=^{jw-Vr1eAwuX~5)2{qUINda@3+<(dzG>F{*e*# zhcRY>%=@~J^Eg?)=_{~rcUti%sKd09YfU9g|ESWHfcJUxaBxD(o=?-B z-R%NE9z+tel66t@mM4ci7i3WhA2;39ZU<#m zG3|71^&2hZ4q6>tZKd*Ij|@;q$*+;^(l<3t4#%#yC01$@ML`NUILUQ*=!?B(y{VxX zw8$PKFW)}@jz7@V$z5K@_#W4%3aPRVHEGtHOHb7wKLM>Vx&0W+*t?HTjePz$HnlYI{m=Ne%F~>Ke{mYdhnQYxhGi za0;FD5v=-?qlQokiFeKR5#z7!#!l*sgQv#iCocp~UCumhSx_C=kyedO&>CWk5 zL7^7O{4o3as>%s>!a6M3o##~Fz5d0orQAS(?ktr;hc~qK zy13W%-rVq(rb5Qf4+3=`ff38 z(Iej2uJ|RvYNBCym#;ywGk&tL-IhJ@!vm&mj}n z$?6)FJ1?uJMk}1NxWSkBHYs#C;5(yqc(~5odW+mR+(GzoW3INWAqi#Kdo{DFx@1gZ z&gize=qz;^yh$sD@yjdV?J&ZcMVFnD?AZpRHP!4ATSWOi;fDHrT?_Za#N0~4dlR*k zT&g1Yx8KF^>4$`|((aId7@(g04ZCAVc1zyZIl1T?pv}JY0H^cjd3witSy^!G7Z2B^ zUteUN46a;h7zB12pFT

    rEJOO#rD?0d$yq^^#`-*dsF$BSM+W&iki@| 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 z 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 literal 0 HcmV?d00001 diff --git a/examples/react/start-rscs/public/example-guitar-steamer-trunk.jpg b/examples/react/start-rscs/public/example-guitar-steamer-trunk.jpg new file mode 100644 index 0000000000000000000000000000000000000000..7b931893974574279c032798c3ad8f7bdf4e35a6 GIT binary patch literal 435128 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⪼X0-C9Fe6fPdpCc^( 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�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

    Z#T}v7J(+ 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

    b}e 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 z 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

    M zY$1?s;}eZW;M4B`N&IDRj%>$19}EZ`g7k*2viQv7<}=MaJda4S(n-Uw29gSn)#(_& z9Uh;3s^R^{WF+|19kx!j9~~5}`K{6Ddj=^&STwqfj?{3uUrEqvPue?fWWa zD(m-nHcHC>(}Tib*X!n2L~)F}v@B=9ds1NaU^J_F33axtyVlENvb)zxgvO})2VV7* z`MnRw@J7(DRpF+8bC}Rr#jLBGl3xH}3zD5nm54uiG&*U}1}73z&a~^84@jS>QJnXw z*R&D(R9qZ@@^ThUUH(SrkYS=Me3-IoZO<$QZ%P`}8Qr{>H|UqofLZ9t2rUj_YD zs-3-*@(6rQC$54&E*{PF74TQdhzfAtGj$kv#aZ3B&~r_%@1FIlvkNNKICHPE_HIUH z&dk(GSVg3~YK-t8{9bgob(8#mx!w5^UZV>;zYcAybLtDmTz#xY#TXki>WP6pC_^(VnI45>*J%;C6d<5x23m*J#r>Hs80Z`{XDNqs&~gfXEjk8>W&AnD zN6{S2Fvx%RDDIKpx}IM8;tUgT&Xe$FnJ%TDWwQ5+@ z)>yN-lPsjGaA5FvSI+PMNtMKA_XvyVypJ~mfn!+>M+^+iT={YY^^)k{Zk$p>p6s1<)#8Cgmep2lJ zF=()XAMX=2>~oo205(idSePkYB7et8)Q^0cV(#UjRF2hdyNPtxo96nox3q`rAu^v$ zWBaz~iFCKs>oExJWr`>-%5=(s!%MgpZ)f7(l5B3-+1kFd6n^sYo0)g9j*rEL!hCU? z+OUJRzJqgDkbio9kjH~fmv9hQ(eP{w7_n-5BqrRZHBe83O6O{uK5x&wWhXH0vu%|8ed{bU z0%yI6kMpM4XmAKF9C9``miJ_H(V{*AoEZ*LiiyM#Nf(?#&NBM55f4-ULY*bZ++W{M z66e^jBiU5s;fT4tKJm5e>v`Uk;a9)yheWi>c4rZ^@T|vp1%HM7vVncI@|I*ltaa<1 z-&Yf4n5kj{PK~8*U;cJ#Lb>tV-6reZV(Ste4%FT0!>DVHZ>AfaTn78bSbxM9{6JF! zMX532I>ap1&Az>7KKj6|v?niSuJyp`{_L~^O8)%Ca%1z#LFlc1khmtv32q^gz`IZaKf;RouNN*>NikpFaPQ;+me;P2k$C;^6G^S~v{%w6}Y3?!Kk1 zAMy}9tMp(47x3M#2(hDnX9NJGfwm^|S(5`cjSI+Y8wGeNi%Ngn$SL3}N0F%8FDemQ z&KMfVD;M!`;@Vnf^0w(uZ0&jLJKqDZ8G@JmJkd9ifHCNs=6z@SyHPh_pD|c+-dh)U zvhUkwYHwJp@UgTw%`6QY(9^aS-bNfv7tc*)?cIHQY2R8D*kS4=adlr~$8l$V zTs=MiYru+ve?6A$MxY0&_yAMUh`o!c4|MZ%$ET)WR}9TkY8NY~ zPWLLji*VzTHEkj#;ag~YaD}?x8|12FMxc{tX5K#1-}?r?Rn;?tFO{;eJ{NM>GYK-Yf)K8B z_n?km*zvh5l@T|?f`OXdkzj}f4jGKr&aMTxQEHRuItRjQ+t~X;-7GQq`i2)=2ny$K zV@CE}bZbDH<~ZK}55w5h8>imQ-c3nAI-j3ip)Z?2)Zz~M`hH$tR+ZkDw2cg`!|YjO z4k|O*UjlP{_DQ3~5@>FBH&*aXP_EsUv>q-HI`fTA{`l!zDeC1(8ec)--J8!OtRLnQa zZ{Fob5oOy?8mbz+@vqf%jzi=R8}X@bvP&oh(;_^$@q_?52sx9~bW=q*`YEN3=CPO0 z(nWGT`}(K@;Sl18eK#j#u-57+DeUdH8PTI+XnYN`Tq=8GHG{C8wQ8x?D9&;$&ns$B zPy-UlK(hw9mMplJXp!w3r4%VliSL;!M!2P)L=T97xCiQtSlJ5xqQtsT8jrH)c6yiU zJ5Q^3RQK$eKB~)m=wc36FuC8z;}^sD;84l?xmWzo6%s$-cT@cj09;j&bW<-kx3@(S zt^?mF7+`-iuuZg;R)?;*Bh9+zRLk$Txp~ht1iz?$JK^&Uj+<5*l^ouj`4*zl{m#dM zlMr?)G#i8HVDCZULcSzpAGIL}uaKmt!QLwdcW-)v@A|%L@Z_8OVXqV%Y}JP1wYYif zevI)g{oOZt4`1YXEv`Ol6`U6lX<);WKv)(bbiSG4o zNQz1*ZOE=^yZ{DPw^EaHJHLA+eLrM;=~K%z*G6w?$-Apv`4is1CsVI_Oe>nK_ZmYa zB|<$E-o9|@ROL5G8^N6?A7dn%_)5ueh&*d$Zc)?vTO_WL)pGUP2X2{!nqNUUu|6a_Fm1`ozwPN zoo~_v_=x+JcM+Phav}W||J|8dw((_)wP;K-`;Pv4p`$nTmEqz%Wz)UuTV!)(Q};}( z0)t56;WAbp{fnJKaz6g5_T956yU5l}2TCla28(GvcTY(U=}u2hoU|n}xJl=u`Q{1X ztzpUt4P8nr`|XQ+ma^&9J%zOQ3ndWT^6;MZKP2qjn^GEI=%7y( zOeEhJHM% z49{(bcO^xjHSOmr^;onmDTsp6y~+~Q-^-{~gHGyYca)hdSl z7J1fl{*9EBdgA4Uh_cMZ*bO*b-LseFUKy)i!5}P9Q$t2Wby*MKr1b@G?{o4*+$Y#~ zmx|o)XquJ3+vNQ+00WnSp+a>T?$2F=3!>2E)vGI(!&P;eXf2V)S>nd2GM92KvFhnLRYnlDesSjS}q{wHBb+xtx~|G=W&P!Fqz3r@Co^W zhncs9m<%Gq$r<6HC#_MD0f$KnG!Zd?7KiFQ5Jy%Jsk_FLWfJnN-<&s-+WbocXeSOZ z6F@~Bm3^fFz4$zoooSw|=>^scQc-^*92pO+&@OFJ{GCY+`u*}{a*3fXIuQUG$q-Wc zWJJ&dxE6A9CJEK#@zD4LFq4NZ>WyEWf57L>el}G|gPF6i7iKTIKy=_bC9-vEbxuGT zjesHGb5L0?_67_l&0;bHxRA(tY-Fm$m5i~`+Q(CuCldfnbOUM`amnjX8D3UaD59&u zu?2C%Wb1UyJmy!y1{90CLNToj8|kPx>o8(gM$NdY!X9$5G;pQII2y8& z^ekY9eP(Ryx=xG?9{|kBGc#{y)AiQ@3!86l&o zn&qhd^LNb7>ZVm97tcx~oObcvl`|NfJ0RH#{$7qRpUCNl+ve(Za(;Yk6SHF7r37mJ zwM~1C6C}Ag($GVbXH5np@wN6p>~spk+Z2zqh(F*16r$1?P9rgk$NvD{vDxaLS35Z- zkuPSZ>jg<4CB^_moWxxM$m65+4uGbQ^u3{SvP`UvE!NdEW9}~A8G|pMGw;;mwZ(6- z*`D1#S(;b>E!C$Z!Ie{dk@WKpU7>XUIc0xRr=~1wFFFLOZKT6`*v(A?ed`S}{N@>- zi3rP$>sEbl93m_(1_!<{5)iPji3h#C$kt@n|%VuBq7$V7VnnG8$_NsQ zJIQ|GIj{1#0fY-|&qPL(M0c+K24wU<`n2zYDtb|Z0wGcoXA^{JQJK(UtF?x1rlV5J zb73-XL`7!S5xqAi5=zoWQ4tMn&-(R;4nv`D=n1GK3!J8gz>~=-44FDC_!uDlLr_+< zHidW45+QNq?VSe7VN3C)t7LeN7Bt)wA_hmGtubtV0>%PrQ5CtsXciWTrP^CVkqFL^ zTg)s@AC|JfSzhPwgM1&37+a9f$k2soJJ~tK64Cw?>mD?CA#x^GE%B?NEOJgt(O_`Q zORWi;RaUkk5?ylGKR|-fRVKM!RM%0)@?RHmg4_fPIN{|1AX^R?L0(HNZwEg?{ z3aQ~)tlUQ78rcxP&064dwZcVvHr16o07X)@Yj^YW3`^?IA0KiQdRDLY`GDJ607xN+YOg zNl7cxumC3}IgnAw1^Dwa8waMyvsut-w*2cQ%Q z=PAowBryEm13WB_rm8&u;7!>=-$ny8T;+XHS9nPEjgmB4g_7nMHQ-nHmTb@;(Mma> z-Uer^Oh+uEGT_fPPp~aGjuIf69BT$HAf|$!Ies{G4f@4r#X3B1655I+}`u`Fk+SC!?cG?N6fnJTD&u z$_xx52%+x{*GQP|p`T|`?GJ!&^nO%?u6==7 zz(OG01&gIsib6k7@0td%=h0NL)c3OG1gx@@Up|JV=M+2~p>-t{I;5}##Tqz0H5%HH zu|X6LWuz;|0)|zxGq%Tq!`q;SaYNt%VQC>*>A-s)`_n$RqRgi?VJcb9Skr;5KdXXU zQ-6MkxX(ZL6!j&g5u~Qn61Yc3Y4qd6AVi#pO(=BQHP@9hgS-SCiv4M>_a2SNEM!8n z8iSaqnX)HjhK7~bRe8Fu2ekmPPQz<#JTb%zB?*%eXhNDgkvyhTP{V5P`Z=8^bAK(O zS+QKEum3bDoBu8hMi9JMiK?4v406!3bFKuZjd;QP~t=3 zujB_qh*%gKfKi}Ni~ew@pjLqMEdq^i^a@uBAFimyC~sJ~v$ibmnv>(ZXTajgE81W%I#I(eH|D-!rwOT~?5_g+1-q zMI*oU5z3F5KykR-PZiEp#rHfalq{V!Su=Ypw~WXrU3vfR5Ag|r{yx$p;gpl+u4AZ) zze6!hK?Cz60jJ?WxsoDopqFM^h!B-r@1{gxgA+^V+q2&D(=+8H8gkhop)$cwjFqqV z-_^{i;zL?D8oLt&P<5D3^GOh!0cZ>r=z#2S>^o2|K~&5#PQWORd_wJI&JZ7wZMy3} zuj+A`3hlIP*N+riKGp_v0eRs-K zt!>n=dz&roRIPnX#@luK<|6CWAlYO6v~~I#)5g8M==U)L+|;0Gy*MgL*Wto`w9w0t zPPvWf=T~r{VWEA^wd4sqh+3_-P-dV>PW)YX=b`QQ8<&c$g1{>Q^|n?h({E_07uf6 zk=&nw2Z7ql+Op)v=xPlHYMzU$@70&(AI^8$S)F238??|W?bk8o6|2(*pT7|Sv&6C- z@F^qs`f{>fmV}%cJk%d+K&>CnC$Y)^mx?H&bOnk_aS=O z1d4O^SivKqziYx`^;y~Iy0we%S%U$|FG+a4skx&Ilc@?a2DSsnn53T(#i`|F>m=p( z(pfWIOX8BF0ZdUWtrEFGzkyCnpnrguK)}nB-3CX4_nP$Wrx`G9_u|#7vGc{CUf9(V zCkmrlkwXC?)_nwBaZnm402t<%1mavbEN=dKux#CjZPWLbJS$FMPn_!D+Y5u-UePtj zi1AGo`86eDTl*9aYQF`!HR?Ck`=BoEO$p;{CLNIpL$V)Lr}J4?+^6P4&$(B;pZ_`; zfqU6Y=W4<=BvBH{!kYrr#unm;fx&e2S$^wE^T8|k5X!>2>rZtpD?T9~t1TZkhNkIS z>dZN;j%z#k%~(VCc!L<1B=#?L(C2mR3n#391=ePb z&(%zr`XE?y;P4jPMYep!wXAb<jU}+!qIQnoo(9eaZN5e2UdWy# z%Jb*&e!$PZZwHE1^X;WHZu{2xothoSXFUdU54`1H_&1ElL)azn%?)pt`{j;&M6QUp zixlP`gwYc6aFEO+J3T1s=c}+bxUAvF!JI4&4?#F}Ni^(Y!a;5JA=Wt#r>fay-AxpE zp@PH6K0Mp*ec(p)T(IIGx~bj{HUVNQZ=`FhPlUcL(dIxJ@~(9zeO7h$75?k5 zDT$A+?Oz2QQds0ZHO}HS9sesj{{ubO9XT(zh0AxtQy*nI7v2#ee(@yP2Ys=FeY7nz zcHx)71_g+*Cpn8G026EO!mc|e%;0QM*2>V4Ok^A6v1kA-${6wMnNarMEg^8Mx&9pN z_-Xq(D49Z(^eM;0re!kEMUj70=E0XDc*2audZ^$wG*9pob@}? z)p%D8SJ7jEUO_6nFUSO3rg#*o^b4){GLfJk>oNaP_c-QNef!{}?^}<%+!wRnk~PnV zt-}_dDSaHjv*p-HnHHgd^=H5q0TBaL>e`%G>miu7a2pdmTZl$jw&_V$ z43Ns=uhbXC)>u)Whu=;IOAT*CH#>OxdCIXa%KBT+jxREn1t~>;vs{RN5j0Qh*XGEQ zSt|#+M!mhh!(}IYv+zJKwzAggAMdppDP~nXx}V zdbx_DIl{;z!qR`oGz5VzUkVq<3}(DtWENorr<42x)T*A4Nh^bm<9HbF(a4bz->%?H0CRcs#93UHXjQ$}?6b4H@bF8Q=m8XU@(bzD^>OIvORnh=ux;X68@X&<@&v6a6#pPu|Uy+GFZmhdcg3OV!>7Pa}^-$ zC}{2Ur!(wxA)g@4*s-7x%MG!^JLs%Z^2J5;lN>378RPGH^6&j}D&?FdFuhM66Sg3| zU*uoNf%me6Fx^dM5bvU@j=&6g)O3hrf}ZF79*A3KqjK^qtzsbmHb z#|{kcfDGk5prFPdK9b{sEdIhR>8ESM;3Icwn$P8DgUltzWklYdnaYu#JDrCLRm`?J z9i2ajESkK8pDJ$Pit{rcqhpE7O(7_%ISW8DFtOeEba?C^;M@Zg{iL5yGi%=CSZFBw zTo6DBT9Jje%h8FX4q~ zb4ocunxvRN#4%FTJ2G&r+;0^!%?uSmRSpj67bV7O5AOd1pn5odx#~^)77>iF!uBn| z-xo%i;sh<$jhAz^638e(2i#bH0hN**tBlLzbj3fGM0mW*-&344BQxhviP3NF&a91l z0W-;#)3k3Ol)gs$C)<8E1;!S7Ow>OYIyByW18U?=an;*Bux;HzX@Il!X<$2syl zifzK$q`JwHvBokoUJRFBegv!8B{lz=ed|OdYz8(jr*CRyd1@wLWR-#F&FA%MyR9S% zwOiJ$Luo~q4(N3BsV~e0%ZKjLde;_I>K-Zu_*Q<*;|uA~6|D5s_0g4B-bfdgs6$B! zh+rh!(PbUeZ*Ttymu-`4B$tXxtpE!QNd&Ofzq>0mjOrTI)B;l(YSTa=<`F&^@14Ign;8Wn`2w!;xZ z-bGP+)h@$lFL%b(bu21)bY^SP>aGnvi^EZy4o&w{LYa2!KRB{J-M`rEvkR!Y8|9hzv5vd2PDts*-4 zugQ9v;_}DbX|1Z!Bk@>E>ru*^9QQ!8 zOf1rXBAFTJ(i-Y9e?GGF{8>vj%u942b9J+jz544Mrj&hOt?GLYWrvi`v#! zEA2nm5KKnv%Fz61ecdear1f)-9+L3Dd)1VC$UK4do1Q)dX=dwmZKVZihg`Fid? zoKq(UOQ@)vsnO8?EO;2b?Q_!@;Y)?Vv6tRnQTXSN@UEhfxk+}TqXHCCdcg_7`@;VZ zo*l!)E7`GPyvUH2FB`4wDR{g4VYhSk5{jVYiY=|mRnzZN(m#rNnVV}^w^={rTWLQX=NwgSIV#9u+$s%29R0W%QzHJkmS0I7!lh5f=0JLa4ju4j(Z{I zyPkCY0}SSysFD2x&|#vW^$)347#3#mX>_;IOyh>r=)TwE(7bgf_eW0-PPd9yOqY0N z{HGMzW>O>kQruYYsvgtJzn*S137KDdG?+KChhWNQLbNI;!*%u3{|oikwwP(%RA}D` zs5T^CGN<7Rp`8n@gh{W(_SM~UtKQNStdmH3>1OAykqHH;Yu4fU=@Q;cy#CImITT?b z@*iTi$hkIc@V?c)Tl0gNBrCT3TO&*zj5qAbul_3EZyzZ{VNTw0i)J77xz^~tcMG{4 zN=fQNYg-c=y+iqzN6|Bc=f9L-ZfT=Z+XYf|Ect6=gaD$bSedLVCKa)jhk0XPcc{L4 z@Bwp4>+!q}KDBz^&>P=W7r>}IO~#7X z77A96{mN=nVyFD;`|dv!Zwg`P&|9fum1>icjGs~6*QtAs`6=dJRQWMpZO+HgUu}HZ zqkQg~Fnq=D z@3!2OiP!H$s(E5@3ppo^Gstt`#isDVg*Tr0-~mPR_JXDVOnpT}DVB9#+QDFf$Mg13 z0R4wAr-+dm1-!aOv3@>$Zk*|B(P&M^e^aXXY#GV>TH2UbssVR}rt%f;zqhzHmu|%T z_^#7r{W9ktAWRnDnh9}^znf+UDnk4z!b7gE@JkLKdW+`k-*mJ8TsLK*Wq1&BQyJJ& zx14&m$K|~Tkzb<5o_q1Uit45s;dSjzsi88o~)gCV%uJF zq5-*LOwi*6mECe)T2wVwXyGx!@;<*yf{cglYf_K12QX^FG08eW=}yBkV*QwfYJ+F{F~`f2V7^VKKhabN{YP0m%mCP0!OIZh z4Z?iC0Ie->&zMC;M3DT(z=_1kW%9^ibtcFcc8f_{2JpG@oyQNFCBETkMnOg)(KvuM zL59g`Jwi5`21r9AC|z>B&4Knv+DPKP-EYPy1K}Kwg?$GK29W<@K`Tzf{%Vs6g4TYw za*ArMkjbn^$X|U}RV=-6`Sp&2&R1<;?snT53&B?~awCl0fQGo5bq4WSlJ}E>#Ex5y z!7h3Ul8-g?hQ_qUj)-!VERmr8A0s;s0Dm1gg0vs;>^+T{PLgKH5ZLL-Y17OkkLLkGH2KpvC<PN|0)?$6*TmxE9~J1JXu$G`PA7~=@05dnf%gEL;JzOr+>Vz*5b z?B_b5wE}8^n^%=u|27-Xy%pGT;4q7nP1^Q`h9JF?;#qqC0pz3THgZB6mBM1>L zB|$jz;%1NWuV#(8tC*tSXTX{R@iZ9p+ZM}#)a24|0n?;p!NH?|kuPI6h1~|D z`^bm59|u3^Fq^ruy!X3FL*+LZDmtOm;*YV^??ZEWKU8#+z5e+lB~+5&_W|qW6{n4{ zZb~VXYH2}NwD6EOZaT4&RumcmSdtGuSD_FmZS*sayO7vj2NUyIBrxi~e}JMnRmB8W z<$~D%XdP!-McEpDG9ASIw(ux}6vTi=} z>hFPKERfu4Eoxv=O#5vYuD4dN`3kmeS362}**K5G@ok&!&Q9{w(llhzcYVybcbnUs zQIe}66kIs2;O;%&NJNO~-SzelhXN!uvS^%zT}rgDICEL?<+XazY-pN(je@BpdqwkZ zkMn+5iufjX0)2?u7@0*;g!OFO>vbOLP&7WxRQ03%ow;e{7m%qoyFb_-lo_UJ-`?_+ zl6cXrbF6Eyx;uOChfeB%sZ{AO`3oL~NE9}3sP7neAGdwSw-M!^pAcC2mmGx=Db~cNXe_1 z$dFj)CO$BYs3zNVT9)=nJZ$^;)-B2*!u1sqO8sj0&e%Jv@X7ldRu7lIx4iG!kI4jglcNh=m@$?*XyTM#00$@RolFPvf*wYP( z#fehwalb8n+kXDp&@nP{S&dmzACYo&TQxeL^AiTpsg)+X$`Je?}as?{GEx=On2w!m1d)QJmUa_?8VLGBWoVDTCR zHmMm&v+3?cylp`1uZh$fF2CHuD@O~K?4}vRLzetHw{(YLB$p{6E>l~}U(BQLFXwNi zYZr0Z@OCnsn+0v6)`K|^lJb$D+x)1*^W33F?qqbXnKih@)ckX z(7;IolUCvgx;2=9OQmrw;svIN|)&ji#1;TCG?EZ$81tbl~;S2 zTg-aRm8CQJ$dJ;>l^G(}NypD7Mng~9V0;VOl|{mNJwwz|C8wvD+(P7nvRY$>#Rczy zk6Eb6V&a(Rbxj9^!8Ec4>pA`4{o(CUBjxPhNk3BMhY~u$aV)RjJ?ls9JpqN+u(bZ> zjW0N9eWvE(CI+O9k0GZs0->Z`VPs$ufGbL!c4m)x|IQ00H;EiEtwLH#of&2^8vz{v z_gY8;8*6MP3zHkD=KCP=dSSr>q$cLeBw{+&P~kS_oU8;+W^oYH6AG<5aI9u$a6WtL zIl0+djOXf>QrvN71&NIl9bw&-WB=p&Jo{iq)v3bB+>;v&cDK0w+k4sv*gE=mK5u6z zDAcqaU}szSXdAw1N9eLPb@(mDR-W5$^u1AcS5-AD^%X?Q<`ucZ#-F8h%HGzQt4b%V z)pZe4>8dvB`gY?XNJe2~SZWA&YPboVjKyBbnDHtL`h~rPowde8#aRJQJ8HG}RYrd} zNJ-4$W@U4pcwCkHen4HzLr+JqQIV$VDBrnhM0@S1LG#%Ioe?DrZNLYJ9qW1tfTeo| zd&)kllsI5(8zc4)5Rle8WS&=Q=9)(34)kDEH^)dldJ2u0nnS@0MKJ0O?>{xl+_reC zcjKTtnmY4%T2a-&Yb6poZQ;1sBA>s*iRqY}o_YPA_p-Z)U4nu;)w!j4cQ++e0(i`~ zA^r?gYq40pGc;uk3L!95(N>Tj6eF{n`0?qlvc2%?gZ3 zEtOPx4Z31O_`-YI=Fe>Hx*}$Kq0d~n91BPsOA{+?^~h&+a=~m~6dXY>$EL@p9vSr5 z(A+O)7KZ>RYX;L?fx56VixsOEG%xnx0(uCiM8c`O#*&KEV-n;?R3HywG~sX9b9mWN>N8r!FTjHI|r|d3AT`m)GMyp%VKbtUkA|wZ^adkQ2({5X+!8oK<~} zUDBr*1v~=j)SVzd%UnD{`&!kT1Y8+zHTW`3i8aXIpn~lmAjYhC$FdSXhoB&#(-mSm z8R|%4VgZ^iOy)5f=aioJJWy9WlQUDg|71UR$!zc7vv+D$PmJq7z>9Zy3(Fawaqh7B zq|TM#)h@4ZUdR)+xi-b6kAn3$e$1QPE{i7T%U35p%Z`hCmXD{R+UCxA85^1yl(3$6 z2!X#Hf@T&vtVc6`>@^nR?@P@`%%lf&Q*u_(>cNf)(g*O)bnxF`T^ulx#7O*;mJ9()nhm0OE&*YdnC7lFe3#*j>xQS z7ol|xj4~1NVXe-t&BfCqy{wQHm0tC-qgL@AbQoKsJGIoe?mEeFHkFnj6eQg73bZ;H z@m%gO=K=m<3pENcD-$EDnlB&n%JTcDn_YS=!gS{ha=PlxzWQ)J`}TEH*sG~$SqEta zjm$prtHPRpRm4cuLm|6r`<)riPI{#@a#ps^m$!Ufib#pwdsr9Z&|Htgnc5NDv&`OJW-5V^H^(=1bW>5N z@^%Cp*PjI3gp; z9vOFMpEDwokkMJ$MfS=(d#`iuj-$j`5rrs`U3MZNWF@5U_x^+T5AVjyjWtKQDRiI46Fn3sjK%2E=yU)||YMzCR2nchTPO>;vJH!a6L?>ly%3aO(; zf10g2xU;>A{^6j>@U?l=D^Io7#uN_5E zam^QkKB<)Y*UklyUO3)0$(^XfeCmi_p!6p!`3E+9PSYjV;e!cH`5R^E1}-=j<@ITe zTl7+Ui_A}lz_g|bQ!I7C3RN6L9d&@t<~5T+gEQ*rr8LI^YqE{(bisZ^FyxA*UX^DK#Il}2Y)bIeRFU|!*9D)cu_l5XSIDz) zY5vHZ7Z%?FbJ->;2u;2IZr^WhrzHiX{r)G%k+~vCGm(X1IhQV&vSl1KR!TpndTtNT z1}+h06|8k@&rLnTQSK#P$=voYzTbHf($M=5#fO;a8h7d5EK-?5x=)>kdENSGYX4gQ z*a-RKSlO_8qE&4{YN304Yj!%(v|+Deo*eIxZ}uM`Ah7?n)$f1jhZs5Duyd2K$Tgb} zE0oP7cth()x@u)2onA{ux0Y-T@_7i$5)$`5`r`Q8_gncexO6zw%3<+=E zk>lF-h`8%-;cp$@Kxq6PaMFOQEU=o&t5Z}w`uDZ4MQ!!7{hNxgJPOJnTG1oolM8q(G8)E1YcCtlz;ecNVd)+M2XXh zOjYQFyE4_fTwM<7W=8sZp>r6Q{oHi`SmfSsrt{HTQAltv?2XPD(41!<=3Ef1$(WPP zo*Sy2q``U8XM)IJss_Zt8lka3pa}r9YNYVDcU@C);1jJy-00}kOaL#jeNU~R_qDui z*taEqIMNfqyui+H=xX*=h}NrQp0xTLHE)>>8k$GaXGMh$XNbv%AHof}-#4-H2yZ84 z4BtN(qxJw`I_pqZq(EU|b_owoV-UH2;m+~#e*ob-S6|exJZYW=2!134Gx@ib2l&7A z1cReh0aD5519Z}&Az?rX*GKYjfDQ{f$GJo@_yLQBdgMC*>s|rRYVSdt3oHpr|A$>5 zX&_9{mrfCI5=Lu^R@7%NR5yIGK5EL@UifeChwJ`LrP)6PWGK{vOQ-D2|Mj0f-3z~h$&_C%Bqk1*@fhr zStcUTtV$PS!Kh~bjGjo9fn_zWDm@6>XLMYE$fyKL=1Q};>@HZ0 zjo}TT%C9O!x(hVD)wT=Gj6^&9iHnEi#JT#QQ{zTl6aZ{yPqwZ$#dAxYy?v8pfnyrd zh!WMCtWTzu0YiNl>ptd&WE#@`0b-$Z-SqS|Da7mjA5m1a$bG#YvGPw&e%RmR8@E#C zRh|$0%4!1?1;>~WbwL$A@GSKdS7uP&7)vG|)N3cetijW(=vpA5Bqp!#{{y9xE5Yl` zH3%SzLzzL4OnEU__TTa={1)JXKRK~cc#@sdZ!aDklRE!XJb2umm^=w?n1 zi6b9|XJ$c}P0?`I2njd&xM+dY<){AGdSa9wnzlqdzB~no7NtWdvZ1y8R)NU3GM3UJ zGTG{_Z%m?Mj53}53tx}e&7v&K|`n_c78?9rCL!0nx|*^4D1eS$a7~W zCPjPlhm?!Y@aFJP8f9gFcsv zT)t8ZRMOv!@t}R$`*H&4kml0pq+c}vJuuQF&RIf2uOg7!TF+_WMYD*^Y!!wjw+jxo z%ta-v(2hO4039eBCOJ5#y~^MkI-rkO z`Hp`N`fhYBKD1$oc5%DWeuZfs+dLbg(9xvr2@-rS_5`R1U{9NfV*aJ{PA4OO7gGQ3 z^K!%xBb`=g#w$*p+U(2vQ8N0p)3ljT|Ufm;6o1|=}8 zIB>@2#c!VFwe?JT)?RSj)gG)LtS~*~bTfwcl_MbXZz_&;_#0);67(%5c=#8h z1gA9);OzYuD0)dtKl5pa3GWci(N=b!Q`4DK3COg}s{iKo==^YDNuWNWRjX6@+T-Go zSBQ0vAWu)G0EytsR|KB=Yo>z~Bx#%WKR`BMc?HC-0Ty~RtzG(hVXtrS7wpmRWco(V zs0W!K`XnvU2R*|>O!U3KcqMcg6+p|vr$fCXPv7ZdTbZ(7FZ`Q6nH6KyI$+z|?%SsI zGyQ__4x5-M0C@Kq!T-$I^wU#S%;%$X_LBOX9}Ep6gfs%#kfMwd05B|RmKkThw4{mZa)r4KL%r0|4t4MW7133ZSGa^yzSzyt}`U zsH&n1Hxn%gtiS(+ckOACfZ2WWy1UiLzhB@o^|{xp3RQUWM$i`tv)@TqPDj5!uHj_k z0LM#uRk+g8D>2b54|~Je)U#4YDoL3uJ+D;1=GH2{Ey~SQEgNosCG|lvl7&u(V)m(- zEEYTl(hrFI7OMd93(Fb{WyUP~AaN+yp#nzM^CqQl*;BcU`=rZIgs5(@`P#-oHkWF1 zN(%?fn*+)VVk{3!TJ{wr)S11krZD>uQ`D+}5iP`&kYp&w+yq$s7IR>{04TT6)@;=V zmR6}RHN@z=&&rz2NXN?v78}}Z=FpK;f2xrl#x7YXq@)<`(CX!o)?5jGv{Z`}+gK7u z2q)w<7TZApmYy096(vT}gW_Z@Jt3RUd!V%B<;%=Zf{4)&iPjk{3m!?+TOu@SD=A}k5;D+1<`A_9Vk{m zoL1Q^rF6X1-xIa6s3738&ZMmXt_ZoyLncw#n(DLldN>v0<;l`sJ9};@F((tl#mod- z=FOHQ^-T<0eM0zPqQ6_MrRy#wwMqIZuqF`BxFaz=@{iAUU#0z?eUbf_1Xubk3LAb@ z;{40yNl*-%zwpBV*07{u9#AyL{awk;ZHdfUIVv8KY21QIGKnk6?S6ySeh7BBPcIFO z)HGOAP}2B!GZuJLAPYouBp+F!lkxrb>nHc!+hT4o6>@65V`JQZ#=Oc7!8%_YHap(c zxNpVOqm(O5E814~lfRS+dQgAyZ9I3FsG?G)8R9Qcj7L#z36@2@1k_*6)F>F`caA;L z^itp)o%6KR3UE%6FdKK*9TXHr&Mq4sXgo$Tc`VH@zyib(ZLy0tGIbe|uT@&r#hsU< zG+c$i?6EPh<=Apy_rG#1XcPg9S14X6vU5!!Q*wJ!P2_x={pv!{L zG5yl{hI=4-3C4Ud7FGNFWd5O;_we1x(-AId486(d;LrOrA~lI~HA_{Dg2E9GIE-%6CR|Kn zoH1su(M(m+H``j;IrM!Gl7Xr>gYF`t467ma`gXxr%Fg~ihe^0TL5Ib#epC3)94j!Y zG-_uHHQRm#(|-_SzAbO``G7b1hb*4+g&|jf$UYs_)r>H9@j5TRE8_GL~Yiwp` zlFY(6v!&?^_DZHl1Z&gCLvMZ7@{wq8@!31}M;mEFCB!lS(AgEDJMe^NcDSLjUel%N zO6GJ6^dsvi?QOWD4;|D?o+0_h4F!M{tgzqb@lC~? z+jzb>NF9_Df)sBi0(+1#{RYpMx1T-;YV|LAeNAtpxMt1XphH4-RDMCECC%VACPmGw zsNZ^Wg3y6`r(d+WMlPsV3UW`H%pf>a+OD@O)kegcqQ_rS)So%tCdnCd=gSC|k+!r- zxdL~kXxeW1J#KStbd91{p}n5P`f1K62Yt+U3)^awjbd5c#GHz3o{VYUl7U;RJ*n3x zCiZi1A>nSs1=G+D3SInsWJ6`p=pE@hk(76iLB>)ZJB6N|r3PF2cfZskNcd}2pAL+@ z((*nUnh`h%?v~9L`OAPiwZGr(u^QR$iBE-bZa-S@p`P{=eRR(>i%RxU8zx(QX zj;WcQAdH-5Bw(w(XJj{uA>ERQ{E$E8R=Ye^uNPJ6rF3Otosp2EvlyVaS2{QOYcI-*i-1U)Fq>n3Gizo0U#9;)XZYk*RV~?F zwkKiLZO91|KS^>o_jQC-$c_=rQkK4##LKPb=VabH9CehVZ7^*DUb%AP4ONR1avih% z{FsrZpU>alfaS`XCPH5S#pm3Z+BW&VF8&8m}2%WBsB-IuFQq@67R05Z4ileYex505M@f{|tEy zto15G(a>-*YP(e1=Bf6GahuK$LGj<;H_nEqUBEVFR?Q&{#D+;t`=3~JJuN%K-=J%b zcpcB`s-=qR367jMg2v(0k6yS1DkEm1^8MGKquK91c94)XK)n z_%tHqI&u^EF9ON$0~0u+tkChfHxs0}PPE1^T)T;~z#O(!$jBVAAOgGH(+gsxucd@A zt~s+wIA2`%eDUG%H149R{cQ9L!jC8fP{-Zn;?Rojq8P_ih-a6KH`U@>5kIo!5xVNR zmH2|jH`k}%NxK9ZZK)>n3TmU?>cZz{xUAXAz@$@LgsKyM)@hQ@Q@_UB@#6QnN42Os zaL>#SUXhjF#>pZlNLW)Y(KS;nH#~8?VTb5@i?J>?_tMm>HREAz^!q7*EUlaQ`}DYh zny?kg@1eh8`3e)#_cUuFJi?f3mTlp#0lN7PpAWTZwRI!!`IT#`EDqbxn@hJ_UY@IZ z!cB-NDMuZG_v)1MHl}p{15Bz$fSBobL04h)LJ`A#F5?MzDVBciUJIx!r5Xo$p^F4} zLKN_Gn9EEV%JH@7g6dt1gzHa(3*;tMj9HyLjHUnFbO`dH)Ntf|sz71TET3}WO3i)u zN!lhme`d40--eH=)v$@b^K@u+>LMp*j#G2<7O`MGypOmU2LNsf3KDDIlK64(klXI+ z&*w$qIS&2mTLFZ^cNP};x4F$a$ZFSX=e5liXa0HFJGv5ygiCfU!0rYUCYIslmj%gE&+ z9OLI#m3LP<+@7YbTrkQ&#Uqt&+^ej<*WRk&Z=)<(t&KiK`Vd}I^Jn7}I?o^9Z3%F@ z2ivjI8lSA?07y#%MUWQqmGX{Dw~pz}+o;#vtHsPggW@UIeN;{*(aq-v-AhHcJ z8nGHQQGAU;(e*i1?j$uJtOAETvE!;p2Oq3l+xn^LivT^F52+QE#$jf%EjQz8biuc! z9(Qe}d3oXTc1=BAS5}+cu^#W&IoP)4_7-sY%D$ z1*fKMr&tm>xKiqPn}+orv%fwn{?bGoPQ0pWQqf3upr8}^(K)w~@PxJXW~UTovYlgh z%2_qJj-U8Y^}=vu zPcit8F^Jb~SNbkg;SZ05kq{dn153`?yUC^~@@F7|fux||+u79+{4Ib4pV3;-WiVRF z74y?bWzXg*36p13`!se_F_F(sOK-3|PZeSU-nU+-9cx{ef}3{67smv@;j!kBsqVbf zxg1|>HNyDHZQ1S#FVBJHM7{SpV@Q)auiQ!PutWZZS(_Ovf{(qe^*CM&FE{qMCSr;u zB=5t91HwLqD-qrN1ZOK{CmX|Lo!iZ|dAQTA-_V)xex??!FMF7H?LWYeua0nXMf9#hkiDw&mo$NRA`pQ_C^g62 zEc_3!od|V#I%>68ad^BKA!mJVb?dIhEJw>({e;?qfh@(te!Qy35_>^!yhgx`Zq~@s zEr@*LZ9m&SyTc_XcEP}n^Cx@Xn>!DMcND};3z?FN?9Xqg<}2KlDX8Qx%DF@5{P6zF zYo9+Y)g|v|{sY`s(5ruU7G&M_6D&42pWV$j24((h=%2Jt!-l6n0gu{e{aYRyO_I>) z8|o=nJs7Wg<_;|K?bYVdxDQ{@9zn9m{iT000CQ!%-_y$&rpUA>#;!U%%6pTiEFB*A zE1y#W3ekbZ3LhXv!GHVuctFh+It-wF1g0?SnEo%DnNl`f>g|d7#N27B5O6)39*W?U zS1qAmUG{sb=^}XoSONV42}Jyf9s~#>K3D3LM}q*&$$fQ$uo51zlPyMllQKGKkZ$?V zI|$Bkoj!^VZiWcEYt9%wkXL_A%9Vq$WOXZ_XpX~ zeb93D$(E#$ZZtbhYtIWyf*P{9_=)QO6WDtcx-uF-UXAH5s`( zX?*bd^C_YGL5D3Xs_TXCgh+@PkT6HJU_rA~Qu{9Zi{=X}8()^19J7prCQrB5ZM_LW z7#jzhGe-vW248|#b||Xw-ltgshdRAhxKD-`zdU`%!BWGVr@g(5Q+~765}DsWB*feC z){!#2gP2Iy5b-{567r^y*&eP}7$l93$*CcUm2#h!2KDAn5pRC;KqG4XJ!+(n9sM)} ztSXs<22#-9JOCgQ5fPN;h1wr2a+LNPuH$(QY18ZWHyUuCKa_2v(U=_4D#_H!N<_UR z%-W~<146Fzl?oUBgQnXwr>t3Fut;p!*3|t4NQP9h!t?YA<@GAD{{UB%t(!$-xN<5@ zuXQSBsH|pR2xX}Dt|6Y^-s~);caKR)$=!{3T}`n@{V1++R-w*gwFYZ_mJ^>PIe4{M zHO>aHpuXI`jlL)IIwXkN`uJ4b)b0D9x_x7K}c(KN81+ghzqnePJ9)?#{7nk+eHjyW5->s99SQSTz(0?`jG zS97Fp=2<9F|JZ;DbNXT|qN%F=_G6KnpR<-NvfS6hYmBkm_x)T_3TUJdpZutEuaBlk zySBOQpA%?DzN_Tufyoc=9m2{;=%Oo|s$=;CIgdQ60%u@>y|-uySi4UF`X;MszmT=d zmY%R`=Jvj~{+{Aioq5TOyYpKY3aXfsRd@dDNv%5gajmJ~?km28#1+f+le5LE7j#)6*E zy&&s!5%Wo$v^3-{ZTrw~*c?ruH9oMQx@PRzND;PY352$Jy^p51$j6uC&fJhvU-oqA z;1Di+rQ-K5@VKNN)jP)nfkadw8Ke$ORJv=5iffMX%;feAGbsfC!ZQ7dgMWpcUb2+h z%Gcv+f3`ax!gV5?F~I6BzXwR}J0x~ytsU8G!RKaM-CyHdZ6oTerG6LsU!Ar|vHxBe z)Nds_ElhNXAIRLC(;AoBND;6q*H2_UvT3+7v&Ho-qob+TwjD0653P~U%&eE9l}hcP zv$e$vbt5Zeov*9JRr{=f<%CdEP&bt7Tw0Za;AMJ$M(6ElI=jIhXaO`fV=w(V?_y2S z$fQ?$N{bA}<$}_rdz;b?7lu>_HEH6)y|(wO`(M;NjjtJaie}eXV<6c707<3C5~A~T zvEoN$9d*}>`>#;z}yRb3SWU_&q{{eWV6`K7y9%(Qm80AZRIP}ex%ARKiaKLnJIdo~i`SMo}w1!W}4+69}9CbexQ&MwXDXki0(UfFjhq>?Q8LCrB3u8)SSWHV~;7Hag#5 zJ+4g!%}%@u`5YCpw6w&ZG0#C$`EEm=K*H$LnQpH5Pvo+}55@6Tt;Qxf^2m^Lj4zE% zw7tpTd3^bK(;SNKO&p$9MIde1DxXj0u;FshJsHrQMIr#%9VQp6rCHMbti8(?Xn{n2 zbPFd4lnXPFs$DVBk=6j@&^)S_#xJ|8vwJ|1nGsc*s;zYol@&inF;HHp{BDUZ;U*IG z&sfuX6}e7;cP%V!ew9IDJAX%kK|8SYWI9Myz<+`~2*6p~QpndF&kT zi4Vh@#>_q(qG!GA>AMpFt!0pK2eLyFDiq?b+8oUL0AS9Fxn^Yky~lunWrPib0|8iQl`R zb2}#slwS75p=RuQI^PG=#dfx~6>QFoc4fo-ork0gHGXi>qTG1FosOR*>NsWLk>iqe zpagElthf}*vcU^)vz;aVpkP%9O&@&VVC4%ATZrTN+FMCh4lybe2kYye!gr{N+^7@> z2d>TPYOZ{iEsCSkVCQ4F-lkA(U3=S*+jD!Qv8NYljf-(Q4oZ}K9k^L43D?VWxQ0#> z2T18KmNvMWPVUMxR2gcVO*M6eXxlehSJ= zYiQMU#8+BRF?GC!`KfgVpXIpiX;5`%w${^T*~;fJE{B+d4==X%Oi{P5+qg~{cySit zP#1v9OWQOjxYdZ`(1 zRRn@xC5wY{T8a%kXF`Tw^Ls0`B{Sho5<+QWCfxStq3HKIC5ckZ?%d{flv<+HTd7dS z4dRvCmXGd@qcN;Snx(FFi8wGFwbhjjGlT;jDWd>0cd6?IMowo=+dFpa1t zW=JY8D^UDF&>}2+ehKnt#|A&y(x~jaePnb<7~55Hw6!^4=)l8!chv}E+wmd;)V4g# zI0%b?)gSsFhTO1FFt^4|Oj7$XO?h{(A93eSUQ?OtEPwcXVuxfM#LVJf%Qv6!Mtd5} zg3;JITFiWrut4c@s4F%0tdE#=N9tLlG4_8%OGS&ay!~p-yU;0l7-oO)30I4Z^3=r- zr`dgCC;XAVO$VE5@M3mj`6pUpB@ z#08;vH8@L!3Ioi*^DQ(gI4MyYj;S1oSDfm-H`xeZFjW4?lSjr^zf68^yk}z7qECp4 zXnM1G*S+*&PV=QU>M;xkpX4T6-21Q=aS~@GcFXS5c2!I56(hgU$@$3QP`Gl?jVrvZ z7UK@~GS-^vGgruS#E@Aujt@iB^k2}FH748*Apb75(_3_JIB;5^pZu9;);Ff+y+m@~ zwvhf_h{-XbOeY!ps3g8u`~I3JJn6OMJ7H@I$NM(g%)e(x<(mrfctu&NHsuns%u=k| z(YV<%QwD4Ch@#x(saqLS9V?j&+L+CAb%IrRVST@vu5MHxQvkpPo&>`^#B%6t-zb%= zI&!M9_FPkJw9C`!gI^!x)7beS&E-RP5bkJprAy~HpwY}?UiP#V-DPwqcUmI-gW(yM za@u$fwQ1q$q#D`&!PfYKqoeqnIJCOCkE{5Wzw5*ufp6NOXCJK^v=iI5^pB*3J&gc9p7Cb?{FJ)4b@pVB)OTv zeKPe@$|KfG!;W*F3r2X`p*~!dpQGIkDHQd}jI5#xLAGV_;j#4VS zuy?KBI-Fuun=flFLzJHqC+oA5j1|*hb{DJqmIQadE+u#d7GY?rz)8Q|B>BqQi|&`b zXNO%s?mkf!ym&L>H&@k%CPuTLx=1_D?Rw7VDZCY< zrOu|8#49kAU1+rTl5~Zsq_;GNlO&VxJatMWT$%;F?IMX}kV3JU@ED9Rn%A~Vr7dPFv za0j0+!426Y{HzM4)275HNk|doLJJBC!@hBjLDHdJ7#BlyvL>QqpA~p;URIBWMnlY- zfA@w&-{W^$O+U`2F0OpmNSs8)rj3lVG6$;Q3Ru8MbP71FM%waMaBo&k?SnZxX?bTU zl0rtN*edJx1>OuTaV0Objvh|uM7+KxfLnNjNc^dg6oYd%N#63au+g;u@y=GD@r83S zB_t!9l9=ycvgS>`PtI?mV0Y}m-+yZr@5@_4LfX`~p*mt|ZA*;Pv&o1*Bt4@+T_pXg zIFcU$(;HG`1_@EIQm`{OgrqQcCUAX~8H0E2h3V1@IA2GxRC*(YJHr+;vxoRAtweRC z73f67p(8Z*v@q6byJ--Z*qFOqX0-nRIw$`0GlXh3>z|*y{y@3JTsrA?R-8Onw-o6 zSA|`LaOk{8O6rKC(3h>WILu&@(v1Ev?3~b}bxOqe=Xm_pOK}{WK>zG^J$EpJj{Y#S zlruQsjo8-n%i8%utMeD5so%qzoffJOTI*v8N7;ebW8RX8{{bi)AyW*vwl)W=J)Pj` z{{U_AO}rqYRicC0H`$xX%+@vIn!~SuoC%6kHaEMT&W1oPHmnpqcAT*Lu^E_|QF|}M zP|%C8fHWiLZC#DOrg{r;z#Ez#kARC87In8;LOa&VqoI#Dpda6;HKd zWzk#H?>GoTXj5!Q`|HR#KRsCOrY9F(rPiX**cu^hY2J2bCKeF0=B6~II8uLm20`a_ ztuWV(+5TCJmyu~!1*xMcE0lMq)ckra0v&l^<=eL1uP=J&%_cnoaZRxO9Q5S1=VZ9$ zwr;hxZs>UV%I1RwMCJG~*=XWnLpAYU(HZ3h za3$p}W-2DpZZYtCh3Ha^@|1FE@!O+Z847X2w$9*p-b>TPBSB5hAT}F*?w}WGn&i8! zq!5BbqYE=eu=#{!fV-h_ZE@I%u zdY;}t$cwk_r)!Dx@eO_t&>kZjbGOGsI(4@PUbWni8pjA5c~(tMb#IY`Kl!%appv&9 z*GF8lZ72Jhe6nncC(M`~AY4k*)E~ef5XZ9(ykq~Wy0qJ`R$Gxwh5H;YqO+A%Dvsb& z3BclPyg=3J=HccP#ioW)r$xu|cM83|nmU{bJwas9Z!~o(bT(#jzWsACtv&chXYFHG zit!vdeDj50%T}7ymmL}$tw?44=$hq%G#}M+%x0$8;7bTfQqJBh`$qwxS^Iv&ONVR8 zWKvzswSOhbz5(77jsd$3C6iOhR_V$MyJ92b0HI;tYphmw<+r{Pgf$0Hu;~IR#%bSnjN-h z8)(7U@Q$A=@bMS6NJ8Mb7GZ`PO!S8bK8wsG+TEWgbCGoHtuAfQ;0Y$bXE4^D{afBn z^;1FoCEW`Te|Pqm_2QekMZdILlLpS>y~bLnyh?2n>?&&sD)Jv0qEDM8s>sxz37!u( z&#D)T>n>^5GITcQou#2Yf-d?bJ)fEik)tm8+oR8Y|6(nkb+>y>IXF^B1AT_V?g{l9 zYg;~uEPUTuBd_%qCGZE(+S1Z~rE8E4}vfA_d*vF~7t=sPd zy~OS7oTz!0rUu$y^U#jTYC zc0}(R;@A{5_2PQx#I|^2yHMTZG?Gk~$#x^27I++{zR#lC@&arxdT1C^xU%wcDke7~wZqZFw!VYECL-xlh&z%wki!=BK&L2e`yS|=~(<=D=7d3Z~2X%!q@ za$I=4>7o4cvJ7K)7tFHO*7HMbo0h! zzwxE!=9+0?m&%$Nggv@h3ZjQmC}^~Au-reXr-Y~F3`-H4KkCi0Ry67lS`cgz&U7rg zXdT!O;&^Q#>Pz^cmupwxQKCBN!2usEj)#FzXC;g!l$HB@-coUDkH?E*Lc=q52@D{LZ2 z4?of3;B7oIHkr9*joy@z-4$n%lPhF}6Y6(r4BTeM5G{$ZuGh0V7i8_9S}5Ck;@h`M zxe3bL9*q%2w)Smz3IlLQk6NWq=Pp{>*v|h9It~$fafc+0l53DioqYTgosX3{oFdvU zV#!`tJf-!}+k*`Ra$))5aRJcuXEDA|@45 zL9-LG69@N`U+^JC5j;cI?v;*d5?*HM@B2-Fo1d(6?4oozf@mzX6}ralhK31l%<-AH z@!FQDi|sAq^)+i_TYfh;DbGnt$9qZpHv27-@y|p-N#rXRcTLYVi>)}6Xf}5N6*x8qA!HVf4Gjv75kByeSncosQ<3NfyD~VzG zy!TnqmB~BTE%z=NF=Fm5*dOE_r7;8Oo>^*jo zMg-;{-9|Xyx^(?!HV2?Tl6-iw(b_Jyw9WLyN3eF%{C)BED9JeFKY&iYMXgG!uFGz% z@3wV#K$RmciZN4kt@V(CubgQ}7w;z(IJE!Ec}(+{Ik+gZHEwr(J?GhRO}orKknHtO?#|Uodvjug*R4IeMWe6Pnrs$H z*I~DX&ec(i=SmdxLb2zxBlaPu9^nrDSja;UmDGW%>vGI&zp#!~{$9U*G(eHB%gdOw zl@SZE5wxGAlJk9t1h1|{i>PnStrzZ-q);4GF0K|n)PiWd-W~My8Q&`s|HR=h@~UmB zIoq0S@Kp$Q>UG{oN+G_^WNPo(MPqXf2DL2mX3LN9TNgr=rKVgMKJTW7i}NfU zhUp<1bR(Z6!(|W*Ed^ZQ8WIJgFjx}yT|~lY^}R4Hs?V1K9M6=&uc5tzLquz8g|>dd*0E) z33o_hkZGELeT-Mz)i8bGo4=%5TZ zow-%gbVc1N%GGp+jtr&C6*TU9Fb+-sWpk@mJl<&*nXxQGg>+$9+ic^-mlSU$V!8R|zL#O{I8nRenv#kQx{ z{o|64#slMgvdc*;naQHOfMNT=PesSH#EiFQ)?KF^_silmKCxjBffd z+?gg{MKPgFekOb0dJgETxkmqeSp;MsEJIBDe@ge5SHgt$^B4|}`ivy7C@2OopqrjlI+UFZ>)Rf*T)lLz zV=UR?usoeIHa~~!BbU8N$moj|)Q{&l(kWg1%7$@go+`GROSauG!aJqHyEC3{~ z%?*mezy!)@=5XjQ^W+GoOlz!6mXSZnGod(KjxEtfb6D%#_bD*5kBF)YF0O28B^olyU=!kZ{8sqO!y!izs z?KwGYr3c8xO^FT+b`*UJ(AiBFgBvo!OgQf8<3h6qbk}!#acVPxocpwQeGEXOXUI%j zAm+(CbGC1uYNp`EBWhyBR8fed<&SgAh>7d7Gl(gEp3-id8*BZ{)Z z;HJm}ycFcjtd%Wxumn7dg6S5{L6a?k?yfOnfK2`K?vo{e`7b|rg&_%}baxGeCLIXq z2Y~WG3wQ+jM&!jr&9kPLIamu}2oQS~2OBec-(a-Bw`ykQ=Mr=)b7^PA4l|$b@y%Ie z+FZSaznDIKD%`-NmxD}}&=)eb{%@T{!h@0kG5118Oqc;9Ix)~dzR6fB@crvHfG!~QAQo~{$b9**24pXZGaA%k_pM#0ON1IT zj=Nvex+m6l`Up03lZlbVUtW7>8*)xmM-fp1iXuYrxazh(UV$V@Kx*ijjG$|E zp#DLpk5b8w87uCI>&lZrvBz|?NF)LZO%mIKMd@cldA>aitXEbm;-T{_T}|SDT$uGv zBbt>foemiJ_X(ol&w4idXtt&|2ctr-q-0+-OjsitqBdlwS3$=D>iZ+l%&YaNK&g;@ z`Xyj=J|h{KN<8m7AJUFZJ_)_1F)LvdLNoK!l;P2`L}%adL}?SbQJ+R(cT{#Js8p`{iFjMxunz< z2JV5Tt8TEq*r)e6oS!}3emZoj52;N8u45Z~g`E^C8BMaIba^2F9wngUXn8xk7!{oQ z?!7aP?ItMW)!@Ol3GTDFw6{=!Q6>+uZ+{P<>2czB`hMZS!$M|b$zs3HzwyA5m>vo4 zRTA!TjICYxm>m7jT=EBM>QZWKb}uw67Ph>MpfC8V&t=JiC}gquJisK`3uDvZ(G-fH zLn^xNvzQdjfim46{Tq*5kc3?%^R7n6s#gG5d6JYQdqJUvf&4>Vy-9~lrvaC`rIm;V zelEB0gUz|moZj>~@Z|!HvSVohF{7o_o_#>y`BCN*L?96AQL-y3@;T{D@nD#8%xd5;%Gwd!&>0{QQl}Yw- zCEWxh!%9|pG+lJ*#U+?vy6ZwnEjJbGd*MMW_r1_{chux%Ve3rvclFm z8M*um&n};a)RB+44XA0g!o(H_;)XPN13ua;cY$C<_V1ARK+ev6Z!=`fs#a6A&Cz3WKzP`>rd@THNB8z- zgBo3TP-1cfs~-26qc~~%U@VDUw_q3 z@D5ykGIGz*sp2k6yeP@K5W#RD_fL!tO%kz$aT|aJs+hR`l&_@LTKMNzM2?v{Si4Kq zK46V3SvAH|Y9`&jfu({KCcwL6+TwcGSaDmvQ5iRSp_p4zuHI7JbXlj z+QWS-g49^@J^A|thzQ7;XY%d%s2eF}_Vb!rWjD3jJ zm)AXttL!=QNs~po#ajtu_+{sVBL<0JlO=v@4n z`u{jS_q*J4$u(pXxmQH)Y>e5(WiFwJ38_X%AtX{RbHC)aD?@B^OG$Jg#0<@?6fx1w zrTFUi+kbG*<2=s!ywB(JdOe>|drDaoggk6N;+6;`!lS&uDHQsbyek~GiyyVKVy76mwtG@5RxxK3Fe=ebn)d>RA6Wz- z`R|KMrCB=io{BRjDe4Z+-luWC%;ueCG$JLq1Za2P`%kJH%VZTF!~|8*psTY7)A|Fl ze#mxM6boIzi|5Q;Va#w`}nWpwiPkA+`m~kr5A%0*NXcB{&6CV(t zeKK$%PQxT(oiZEeM)HrrgZ|(dvIaC(61j@ptdc5thO2oJ@+sC!P@v_bK5DeRt0h0 z(LrAs4MqNoHMyICzm}jETy8Qeaw_tBSSFF=&HJqskq=vNs{B?leln-{)KZFJvZ>rS zwIbt8zMU#QaySe*AB{4vrxdUumBrT#xzAOKouI!yWEzv!r7(@>EsHfP+X1J#qNy(x^*XXTib=_w9cuv)S$5}goQ6xWmBi8V6>GP zmpaL;#W_1SPkYL+e*`e{WOt0e)|2R`8a=~v5e!a31+5|bazogiFN1c~H{6#zL-^x( z?B++)WM2D>3WqAZKazI3+)pSsNuSH*a3^g^?8AlCb8gFhaC9aZoa6&i*ao3&3&}}Z-}e@h4zCHxJ;wP zuR!hQuIJQvO7)&Y3~~}Lba<4bw}FVQZQx#cCo`6Kaq-5f+e1jECGM|KlVzvtXw5-x0NZe zGP778Vp!jv2{|%Rk%YG>$)BvbR`*ru6hG2TPKF_Dm5-AxqSYUPR;0xO#VvL&bSVd# z;-o(>>IVjR>_^1!HT33zSl4J(HTC&x4W zZk3bXa2IF?`|z>{!#}i!O00t9D70?NRHP!)U)sF@&X()}^)8Gr@Q7%_tS;UlPH%JE zV%GK#>euexX#EzGga2ZKYh70htvg8thu2h3SKp?Y9K>pqG^I*~L+97AOqRQ!^c+Pc zOth@n)CXnf3JQ#A#bP!okwrlp^j4k0(^v6{5ZQy7hyT+G62ke5>!--gHQ1$Nn ztOZfgeJ9IyJbv&b2=CZcSX^)EMM*|BRo~gMpyu41S8c*$%BLxY^%VLr_NdGdLLY`@ zCw(zMy_?FK*-EjB$>O!2Z|!-^JxIF$5=!7~MCpl{(VeHWY8+VRLlK@k-fCSL#ur>c zk@~VRaXpQK=xEQn@9DCL3w4*T75=@&!cN+$CEXh~DjqtN?`T zg^e)EmAza;I~qHz4`elOuN9eSLaw=Og4Ldq*u zh_8l#D(z)(_(Gg(^ipyxjF~sl8_|vE6^%N?c!Mb<9we)k{L}Siw8_Ti_b?#5g5Za? zFDWeEkz=iWUBCP3S(NdWq7Urb64B<2nMla-5doTfwMw|H3kb#`$V6c_cU=n;nGW;&4YBF|13GN zKK=6BmVZT3aj)B_%@!R4ItqG?Aad#q`bHNmm2Exg*vwDon6(ll9OM1Rx|!ylIv5b4 zC7h9$Iy|qhhw1CdG^}E#`o_uMv25f=f-0&ZDMsedhb`qZ2>1&`NYpG%a6X##%}bKO zQAquKqn$nP7BWOq=duDqbin?QD|dg1#s<4x()5or*u1$3K??3%(J|E)-%%jKsIXVp zb@H3tRiVX%W90tVbHPF}dx}M#nvklhXHlmeuae71Q>*-`ncIa17JUx}2S-t} zP-(Q9<@Mh9*K%`tCQ48JgTkI;qjgv(kzPm}Jkuh-kwSuJBsZ|NEk%=JQ2Vhn+M4lV zHThHDdgdM(^?KA1?B^rt3RCq%qh@Z=5Z}~$Hg{wnig2^6gU~0gKraWUZL-5CV-3F4 z)wR*Ixam+TZ(zu%&A_+KMeM?6`OOsCTX2+vytqWU&B=*563YE8-U%vUxkj0B`f0;# za`>bJWY?D->H0POnS!8zqiIg0Bsad+leGIX=R{f4o+T4pi)LDs{IiCT!Hl3Ze8gId`ivU|Mxda4!rjaPZL-~56deplhzYm| z3LAwVr%+Tf#WE}QLBl7C(iZ~tzZsn6*Q@)Y=^}G8n^#1L+|Hcebcujusx|h(GOoCR z8@UTG1pW~#2A5e@xeqoZ;lnQJXlv@g|8?%YM9i?BKyUS+qezu|L6RJ?K!aE1uj37% z%;zW1{cw0BAO*Kq=I3wb=P$7tXHr};FPJ)(rFlhq2OU|IaLtxZIhh=-n6H0XDsg>+ z)DZ8S6y4S3EpJzz&Ek6oau&Wz`(6F)(%Y)?b4Q-=muaXyq00cYJ?w<|(*FGS^W#5D zx_scf&7JwSJO?&Z)kg$@HCLdq{4f|fM~mN4wd9D?PY)iRz$C_*T0xMR7d&V6yCdDv zSVqyQgXi$*J>@8tIS?ZHz9cdRT3EtYGd&ajzO(&Q`Wgz?Hc|$`SD=W-^;>62}&zPCR*n<`Dax3dh)@QMwwpd-@Gx6Mv?&|%D)~P06gDDoVPDjfOvXcAgoi;7(tpM!AB<|926;-hRBrCEF2}_kpHcX_UpXQvpBe2d3`+Fx)C3OLd&4w& zUeE`@qJsR5HF+PReKroSdylC0^sJ-zZJn%5gQ*%BjRH?Ia3+%>qS)8dS#U1sCBHDK zv^lVn(1GZqS`*kv)m?lLQ(D0Xt9It)BQ;MfI2`&mT~33Gf5? zr=+8`rTDH{W#3s}9E%(|ej_31>(bn=*x1>?OC13fL_$LdUI%q#W^qX*{PT9mDa5>i z@{PU#_ypA4%?)lBk)Y3VDs}amj(9k4Ox!HtwufVzCLcb{L65e|c}?~D)`4%vQ%i82 zILsFI*~(eDs7R+3O}QgM3Aw&eN%w-dcx=#Hbi76n?1k`r-mCJ)c6L=}w;@g&(9SEX zAzZ-us+!(TcGV#L(pGck2fL>gB6@2&l$LV*MRw3^P4RcP1@}%5PBiz9Qp|6Xou*g3kfn=pcKTS&*2wph0Sg|( zN<_(XD)xEybCMcV=npx|`%SI##be~XMIAS*hYREwnT$Ff1LATjju7=in z&vUoxzP6OJ_|?RkYsL@Os=nMA$-l^J`{uCyR{llZ^Jm>(-7&7PY(gezznyw@hIXr! zHaqmBp`oPC&VHi7ql_1TS%xXoJG-T?xsc08e>O|Uc4C=3Sk!oTQ=RDHxM z3PrsUd-^lx6l0=miJ{iE{4oiv60A{v7VI6E zM;K?v`D#671hxOWHBkHFt{Ng=yU<}F z(n@ej&W)m@(ow2Ina^nl<19a`uytUogX(?q_tVMSbLQI~R(RT`e?sod zF}Tg40fHvxbkU++8tTPmf10e==PM=Bm?oShmyRu$|<;!7-^3p zZe7wD2flVi^J1H^<-?>$?r&DFvt|uW(iKQ{me@8vd&zg3qC)XqOEQ-+DN<_{DVmpN z{tNd)Na;t9)ZuTE90{yghser?4%kzE2N}uyzw4V7{Ezg)=iO0 za+vA4a(Zs;TY`fNCpleVvto1M$RBIvfTDoWz6wjW80;veRN-UXqxi*QodjiyN^-0v z0!CBc!Mnlp!gop6@_H=Pu2B|q!>$ssnf_D>iqmd9qAKP*={oczAbK;}e(J zb2l%Lt@xJi$sa|JCB!F zQqnHg_Hfn^7QA$k-=$2|Q+4{=sjCN}84EEuWKXU$vS&k~`c7jF>Z?nD8wTxw>1Hy{ z<7aRh1_yx)6w6guBY@461PMzV<~tDBRhsJK&Z7X>e572IAdu8SG^6h!zjrX=3WbL_aoCy!HV`yHFmq zkft7|A#&_-_OUxg?mHIoUpwVbCzQ9gLMnrSI$6gc{a4jXRZ!aEX@ZHzizXK5cI!VS z#&OZF)w_CgzW&I6A0*Goii*LJb|P%&NpU4Ep@+VG1GihE=wz+Z^71xYMMOqb%w9t^ zHB&%_{gF>4M?@$AZFBEEx-MW5>uPI9gbt2=dnck`@yKn_`0<8nSY+1l$}w{{st;oC z%DE=voAdv54TP!k>PdUNbQQuBrVnYyq}JWDPv;Al(N^u!23#as2hM`Z5XmYf+)9`p zxA+Luz)O>ltFoR5adE1YLcdzISJ@)`|jv+D!=per21f56|hcN9J5jLKbrpRBi zQCe8i$0!tYNwgmeSgd|ARMM}uj5_f6W&1ULi&62EA7BK?=NHlNXKP-Pjd6adq;o-) zE-*F1KjNzE*mnQ4?AbpUfG?tw<~In_4)>cCI; ze2JHg-5KkXgroGVd3$_VMD$(&T;YpeMpp@LrY9ArSMmj`)O%G7p8vVU;H{pdNh1V~ zkKv-odFo}5_90GSBcmjdqb`*q`*+gec&XDmQ7^m%`Z?akXM6Ru9o=;=lU`aAhHZZb z;&=zyR*6$c^M{<%Pd4kV1MN5C_jbpeoaqCQHz%KTYM!U9ufP6v5L|ufuFDiuU4MYW^e} zRJS^p6LvbV<%m-bNQ6Jx5El7Qd22@`Q~@C4IM>42Pk$fyRBmL81%2$#LGP)P6vVI} zgghgcvsC2Nr}Q^@Ru)*uS38|PwnHn(SpE5wJw~dh~FhY+QeX4!bz^5l*)v#e|FVF4j?ezp|6647l2s@<5 z$PiHH?v->VUqPJi2FFz6@Ff}FqGeUhr`qemk4?BGFU5Wtcj^DeXLm9+_diQGznIwJr%*%Y z#pFuPou0$@D2Iei7w^jCVo93?d8;wTB=2N7QBo);*HKgFZRrJH!=7av0DAp4erB2r zTtS!UM8QkIsTQeWaHF&5K5xE1A^U>=o#zR~vi||J_zUurCW3C}wcVM$&Mzx_V(ZR& z&gkXei5vnWrVqU%E`bf`1~}a#)~4M_oC#}Byi%;`!0k(+bKdF537_ds)9EdAudD$~ zTso%If4=M05x(Q8;@Mwr9%LoxpO6vf`R8)>mrJVWvh8}%_@!Qs6<)P)D7v|KVe3?V zMb?t-%VK%+Qz!Fr7R=z{V_P62oVFeXU>!s?U3-e@z-<_9VK*~``dK$^?32tDtd4>Ih8w&=h{A5QxHOKtg zt0H_YHTzlH<8#lx)DydHszK3ad&=Xa=BM$iHF%0MXFif=1r^zJeG@)2G0&0Nz*t}r zhqB{m2qa3$L5x{T=v0S4rkT47NF+5j;Zt7e13@s~l$??PgRUVr!z*#6`5)o(Kf(N- zgF6l^%b<%y?;jhPWbns{(MiiSZ@XwW7=Vw5C;#u%Aa!ufG8S1kMH0eOik$%7!z|^f ziHm?H?Z9x`xGxb#2>@r#8|||qGRRUH>%mJgDjAtNj@cT8x{e~Mijc{*Lf*7A4WO5i zh$x`s3oic>vFPrEt^ZA#B0548z{6iI9K-_yNq6ZAqJ9ph6LMW5bO6QYP?+XOExITPI<=QWXlM4{Tj! z5`_3A`fquNUw@TkmNSin`1DcdW58(lG!RH#M-%fy6rpzeGyHxQ$o0|bGU2q4-)YGz zyD#n=uhY;jxV_w5^xS?35~&%iFkKAbCN!2FKNQi(UOsVr1^9xQ95O$0DK$P7@mzZ~ zK|5a~T@zL{Y^y50`ypsWBehF(PYSQ0tNq4xK>VXeaK7EUzjpokQfpYiTX%7(deM}@ z-(N`i`6iyn@rAYuMe}@-d4C@@zitr*a8>7#rlDE`m%D2YerL*`X;dAvvpuV4_@@C=!+<(49au4MmE@VfG0WGd-)aUo>ebo)C({i6FF6wo(8C>jKsGg< zh>deC*0hTd(azLX&z5RsUn=0wd*S4zd;JW8+Ves4!dW5yVbpor3$^Q=QsTVA>G0Fp zx*`BYX=$OU=yTU!7-`%-;Mose>T0CwfMD2;EqU!`12Hg;%&-5E)}*#9!gkf>tHJA^ zkIVgLjG5m3Nj8YE@@oY_%q8TmaCb7d&ft5baC}deOOLAX^&-PH-5zSBBkMF$3(Jwm zKEXWy72Zme;?WYCgYQX6T|?+Vyb2E7qvy1xya2~!h42$i@B&-}t-VeBfkC*vlK-l> ztwuV}OROHe8E~Vp(;M#fzO2Vm{)Y81{ad5-@uM%@qpT>+RQLqt@zWlyg5iWxVhh&L z|KJgE-S01Z;t=}Rz|WoST$; zNxhtrb^vRb1CjqCA zc%9o+jbiwG?TfgXiC)WT0&CIq20FJmcfnboj^*2A6(`m-Lkf1WbE~Vdj3yG;}+_U)EOUArLvxR60siq-VeAI3|MA^J%x*9-3TtBfQ9)oH4IRYI*7d?@j97wI0cX&*FLM;y$zVhgmI7@S1BK zx2vA{l7b9%UPW7QE^a$NK5tKfU%?CT7Mb=LBTbNmzged4IR)@q@01&(=cO`2NW9wf z+uvRVQYd3d4{lAVJ{ zq_Ohn2{JD)^(0*IL{jxERZ!CiLoP71ISzL+C9Kt>!}IEtlRG^qhm&KK8P-#fKx1kR zqOl&2Hk}06Om^kbFsl>pm4%yo25t^y{p9=emK#BAj1Py3o`HIC^8Bt6NsGvcZzxMl zo_^dUhWtSig)masdF_SrG57S0Ct)@{dMc=PWF@CcA5K%4!S(2w^-6g%su;-*8ldFp z&NX+k7Ep;(=ExnohGtXb)$p;Jpa&H{rs+)0X|j(kg|W$j z*3VrGt@wZ;NAF9RN8+EXud2jlS|dj4j_fHM0Y|5>_f=0t_F|yW z*g$ND2b+bpU?O{s`j}P$qgkVNQQf9)D6pU1wO*FV!pbXUCsY{a!}U0iCkR(g`QG*o zy6bt8e`O38L=e|>Z6)%^99^f@+B@=j^K|l~_nm%rP&eDUDEzfGR+~!4V`m!Ef{u8- zFoh@ftXbPReh?u=9%>)paHV3@Q8P$G_xwqLBk-a?_u+*uZ=;w;T2DKne%CIUx0ihO z7*gHwK6|UO;?g702O0uwVVE3Xn&+n6r(g*{+nM?Xcb`$MDbWF{?XkZ{;pqx~I7GC2 zuH`I-Uqrg`Xo?W^;8aL%r{w(Fflb?Y3lgoO@8Y6mPg5p&1Zsn)pG56`W`vLW*@>%U@}oSi&Y})_=2n?Lm*MZ6On{ zEg%SV34aD=IX4XPZIb)mQGzE+HrBjH-o)UCL;b^E!|~rCmK`=n!M9>MReoRNl78jy2zLGILC0sg{ipTJA!VI8iUD4p(ABry=n9ZSVoX5-#1&oo+S zrS4k)hGv6>-k_C>Vxn zm)Oak6<~+h59wGzjZd;!P38~(&WUcyN7PL#Uqq>@Cv>S)(+>Y)UnTA8;RTg<-v%Pqx*P9<3yUp1>iRL8 zUiZyK*CyZeym4{OjJx|q|;Ihsiin<=4rX2t0108V)98U5qnHvJa4cV#sH?Zf{9 z^vvVSLKkk#(W5nWBCT`}jAAH}*B);eRjI zb3dO%&CyZT$5AARL(;RFG<7ht$2su!JJ3ngUhqze0ftSZPS1vB&pX;|T7eMjyje4G zTX*7`_fxgVGUt}7RGm!7AuI)IYD1V)!UjwAO%_Zd6Py7Fe`bj#1E zO$Xv8kJ*@SZ0T^!$913eMh4FO;>^1sDr@SEy_%$Gg?*Mk1WseLUvBK1+per#H>+vy z-M)04Hm!EXPX*x8eF z5Ef>toL=!IXHb+FW6=INqqCIgOo!waxB44y_v=) zFEu%-J@Y7uJXUOD6Q~myaPlTfEa!H#o!>F;4@)qhKSAB6g1R%=yLjFu2xo;`aX8iO zy-L{LB+|kbet7xy)N*c5%v;^LM!H4S#}2h^#xeFW=v;mo#lX@3HhJ zh#C?Vm~inBx@YQohK*xi5XHQmS5{l~hrvtjCkNCb+p`AjcS(cf^%2*_16DJ6b9zI5 zc`?s4nc700OoGryobjv}Ho3fefwXQ|+T;J~!KPs)bDA=Oy>soLw5b3UKDp8BcTzdl zVPZlYDo{3#`ovMtvw~@UGwg~f=MPmVN)*9nc3D&vDNmr0}#bEpY?O)Lf;qAtUIC_49YG5<1=f)h@IpMj|pT zs1EA~J-FuM*K;86S(8I^oE1|#@b8&@5kS)-Q0qv?hyMX4gFYr4XT?%ePFA-|-`;MW ztNa+Pvu-Niqvg z36niTABT&sgyzD0w<_X>Mem}s*0-F!hs3)OKomMGZ(8=oFwkZpR@4G%UdLcb`=httq>-ePN7tsX68UMN}7$$e-{eLpB}vED1R?=1bVwdFf1SA^HgbM4t!@m59^aPf!2{kdJ^ zyX6}4SyoQ_X6)P8MZ#gyM(maED2vD2pV`rB$F$_zP)i5JHzcSo!TS5yZ)%^|w>44H z=qBb0{AI+1GNa&>{xzrIdZ1uwL+HN8$KM=x8 zJ?bv_hppcrI;Nq>h|#u2aUQJ>SqW{yLhZ8&#(G6yNCM^dUC;PeqY({FZnWu5H_}Yv#Ey?jW}rT>wwakE zIuo#ppVDG)Y(49>)Z2N{J7f63o9X4RbbV3zkZs__o-^GWhaJu`*)lDkps)qO;yxOs zI?8_3o#ef~DI4A`R{iYBjZupU)W4;uPR34hDjaU};tqME_$(x82*lk|*QK8;fu!q8 z9QS0KW?~9-c^ZACb;8`s)UOaLNz&Xo0oI<;xZrTQEZ#`5pyX{YU|86&<(!l9EehoB z>5bT_-!ss$QJ+iy13YIxdmrg%X0R^#YQ6gS?12%8EudrG%h*rwn5TGW{SUy5i)gvk zE|*nJ0_#{`cj-GEp57lFtPY`=do*^>*Tg(Ic-TJWlL98Ih7cihN%(}E{T+WcCB^1I z{ZvYSDvjJ|QAo4)Ur4cnFvtf9mnibM-T`w0W2p^(#flUF&rxW#=Ego*Q_n8m2=T_c>!goGvKQ>pF+_MFY^1XZ3i?b zLPd7KDpMZIWbMLhEgss{ula>P{!01)DCjEl`Y50)sUcn_=wak&Ym?+!bVB!5`4_&2 zp~7FlFFwEa)h-y*NI$Lgy2kGO=R)m^RsREI#`gW;z2XS{d!n=RR)pY{RG}xUgxo>svCkIQMVA9V{}Rzb;Sq<9{N*OTNU?e#iXGbntT5 zj`b5dX!%emcu8PWr{ynWe6Q{<~Ge zZ{EIrBX~3YvU;S_gD`FbQb{EHKt4vj(8Wk2`$Sp)S~@0c)))9j%A`iPsO)Q%XIYuG zvfF*%Kl!#=!hC=GO|CVJF}Y`C9McA;Z^G5Yo5vrQ&M4qI%&M{^#d%f~OtcopmOsjz z7guvDIDGpf%J`DRb|Df5tn3ESAMn`8Y2gsh zShB9wf3N<`D=Ga~pq>xTma=<2%RPcY%Y?gTlxuH+_)}7iPCWX`r9_^~*97W{JKhlt zkK5J0q!#>Q1HN@4LidRFqs;@m$HzR3^OI8Ka-DyUTd3bZpZQaS1J_8*$gBN6{%!YB z&16-L>9U=SGk>A+mocHw&F-?t%lO6%udCmZxm0vc=^;&0FIjg=n16AdFqKM`4Xc$l3y?#l@$)@{t_T!r5r;GB~fRs8FO(aefBI4S2V<{CLzOu+36{dNx4zoqO5y z*6UG+r!ti06QrfU9@=I10hiD4JM;Vxz*0?)e-C-+{+KcQi`uQ_Y&TeR_}WUYT;l11C1r^Df@KWT)`(noT z{b>okw)(>lgL#`i3m^FAW8N1x%6YZU1-`Y@ONoX9gTA|28}9dR9=-gKtGQi2ie>d= z%)MpZ81tIrP!%|rEH=?UQ`Ir_$xR$vo`lCnc$)5Y&yuhSKkOr2?_tMcRDxsx1NWhthM-`_xN(1D7E0wbQ z0XAgXbIy_3rZ+U2xj+h+?XK7ulUZu^u`VXBzo)@*2e4}wUcsS1Js8y##T0)*ytiba zovch#8m1myHixe@>77!z42n5vF>-qoYG8V!SSfL4A+a+CDTl;HQz9QX;R!e0nP(9H z%KrRtavLpoBmN5luNu|ygM@|d^QTK%qUxp+nyw9yTClVxUN{4EAp&pWv9vw!PPoJs zF9tuF%WLsJgpBGIl)pic0DNyzxY?6s!HzN_TbFWe&kU`eXWp*(74g+nj&No8n48BJ z)eAS@KAh(Duz3Tco~HoIuif?X&mXS2{V=Vx6>08q=5H)VC43Iy+;dNcpzwp_fD&%l z8=2Zjf$}o;A)!O$CXhNc7HM@={Qc9z>uZ$82&$;th?7GyMlLXp$kz84r@kVO1kI8f zO~rmz<2#V@U_&ZSw@C-Z0wsa-s@;@q%1P>ThY!EH8SQ$f**mo%zj0)t|2_<6QP z{0QcJHA7a)&z@*;*wyj%gf#gFER8ZfRN6}l3Epka@any(TrFH<{!0eVc#y; zMqw1z$)vKnsEgx$-f7&_i(xesY3}Jx6cxE;LaA_`oQ-ou+_(LrR(6QuV5D8Ad)}MN zA7Ok}54_rT0mDvuQi5x}o}v@g(pHM-^U%US*)j6B_5PA6@;`v*zq-TBr_VitdZP4| z%yRcL0;4f4_5M^1gL@7Z`<+|o{S3P%r#H4Hkvd%Y!UB9GI%wq?=+7OaqXQh|3vE?- z3bHX?EzsP)pD&b0yEAb}_wuI;*`zmQX7xa4F-b?cKl8)eMs}+81M|!*OUE6j;4A+F zAiKEP3!X>^#t7ZNR5^nRAcHV@Ae7UP3L9JE8~*rEL*Z>4Fld>j5a>AP{`8Pj)7XA+ zA9}`xY2^taz#oMZ6jt;(cvrDF)I$SSao2j-86c&E%h!sJ@;mLZRr1}tl0=HTLG6s~ zDsV~^!M-ZV-(Y3e5^J6G9P)JR>!|n}%a0f0z+tc5d@7fNDCCCcXKymBw!C`diDXg_ zV&2y+@3QvIdiI)xv6U(W_>=(hOvhGNVL6;OEw>WwgR%@8CIU@ zE6vTJuKOgnt*8^z-pR|he+wBsT^F|k zd0`7Dy?WL}b}!U-A6bWl^{)#@&_bbvkmKB&04h>t?+W2R)DKZUuVsN~| z6VV+Ez;QOs5T{hzHsKi=Qu^u^(xSu;xVrdCcp%bDE zQL*!B>Y8P@gm9t}v5WwFU^SK0ql*jJe85C7YB%zH>a)lzLWNnQ+y-Vq^ecIxEaBPxDdhag z;-ku;DujInR&0xYNFj`{)RdUTiT+N+Ol=fH;3|O*xA*AZO{acr?v_W84T8Syp$Qm; znQ3^PWZg;^4asC0&W}$_8CI7{Zz5Udp0EpGO|eKGLtxK8I{8{R&hRy4vf2S}&WkrI z_F!@=8)4nUqW3NU9o!_DlU_)(ip=S*4~az86gT&zCf9s#Mo8@OKWS59F|Ki2=0OP- zgOpf5#CT~P{75Cr!a0?{jrnO&d=LW|tvBZDJB;4Plp3P3W>l|32hrx*m>DQCC({z6 z7EgXHSAp(?t;Li}uqJe(S@N0?-=Jwf^G&80)QP;?%79>S7KfsNT-gKjyW|-*HKFo; zC#sJ=q|=m%QsEGzaYEC}N?0KJxzTy91B2a(x`>FZ;gCcVzOM=`k>#=aAAtb66 zA1Tt1_?=Tn0NIc>o6#VdQO*0_59xQ2XD4lb!Uyb?EM3#IpwsbX()Y`6^*4TE7cphr zHG(yA({zOm`uSs*DUS&u|8 z`(`#hv($X~y7K47YX2z_%%{j6Y7`<*hvO2tB`-=93t`8v`#29!{J7%~DGO9CPL-D= zn~ip5sfB+)MI3@YhHVFcJD*>nG`O9%ipsH4Nn~drDpLYMF%MDmas-Zo1BYLe8H*`c zO1N(LsTLXO-_=c_8V*@`z%A5BwS>4q19gv*%oHbE0zMk=G!;usp=&U8$&iyeW;^YY zONo5n1S=|!7;;7hFD3c*f4}ZRM)-?9AcUjKcp>W`;o{~adY~2Y%|fxljW;7HFW%x zB}lbCtcSvFHYUb&_2VITCGN4qX;fC*J$t#2k&axQ`xB{LIO>U;JXR%-vrlk2`b}3?J)IWt zTq6mtSV~eMGdWu%mCk<(<1$DRl7Ztjw2M!?eNtZpc}6dd@DBsI)v)u|2x`l#LQm&V zW+6FFfHmJ3xq>c&eeopJxv=eJ4!DUZdFIijyB@zGc5ZLb11e#qBaeWM%}9Q&D$;+) z#Nf;L{U`weRYliX`ql|o*>84QA9IJk3EpxQZ?4Oz^w@WQch{8OBK%yjbtEiIV6ZNX zFkO;UsL)7uvdTW}&<^88qG*Jh8mG~Tbl%3ULR@|=4OdiHem5giSjC5*@9RUt-VOiT z!vUe)jXIHPEbEI$m@Q5-XJTV?ly(t2Q;{dbz_ajna|P5l65zxf>CXB z8+H}E5-O@D>g51}Pj@PW%%aQxq@A>IZc}iU?#g%c_1OLG9(_^9V_bYwOYW%JMOl8u z$33S{e6ju#sst&KFNEaa;3rnJT(pm{dHAY=6|>Dov50HdGyS&ePnZCJtFcuGWVle% z$V7zW;*s4fLnIgaJH#~By)JO1cjecnJ|;&y#h#_|d46RD{i)%V@9Q>?}EYtKQ|J2=z=3)^CT>O!>9PJskryr_IF(w!7m@AyIkn8&!}xxYsi36s=fivIHErS^cDhHh z-vx_*d37Fex2ATr<8Rf%|0z1_wlnq)3Q>U=a%9_ucysJU=|g^Bl*0U)Sezo)%cQW*r0I67Vvemkc7k z$@hyd77yZ|E0=3`q*14}I&suX7=>c_c(Mx|KwBB2?~`=@&|Q`Y)!(qZLEFvMn@nFi z>dz<{y9JO`?oaZ{7}6Bq8WW|Bd7pFB+wg5g)k9?!8U5i5?##;X|8!*;H4^|sbi)>9 zyfT~*cJMe`Jx6mbW%!0Wj0hF|&>X z_y9i*zq|;wElr3IsF>PG24;@GGmta|0KN+pYSNvDOC{>Zk?4=Q?lm+F-iQm=q~3RB z=^yAG`~*5|=kiyWR)3}!qUYKY%D%{`iuoWLmP37oIqbvY`GZwfKV@snd_(Y5{UF|6 zUd|XSh@W&4@shF5IRunFt$Dcj^(^iPAHE=<8olbaOeUIX7Fr-qiW)=iOWXAxO|V#3 z2KUUk<;{tNE%0?SgB0wlZNB_j>nQaYurCY0=V>fi32aw%8YJ9iDy>W?%=$;YWyfAu ziV*6nE4M&JV;%nkj0g@Ft__ADGG295RUE&6xKBPHrq!j}Ibs!hKic5bxjcS*osr%CZho<6Twfju^fg*PigLGmKqrN=eC^?he z*!E+X9p4>t;Fmx##XEuJ#`4a;BAMXs4;4ZlG`tXAIJng14p*dHIX_ktU{IY;7r_|g z#N$$WtwDtYWwR#Mo3^9{1LNsf+U0taZ+*+Lo1fmN{`6!m*Hc$}o(-7t%e->e8;p7a zF#}%a{_6ESn2G)OvkmI}-4(ug&*9CufJ`dAjH$3+rCXzOd8=x1x^N@`bQtE?KlI^q zmwgqb@ociI#JYs!6xi0%4byT3|E$E;*OL^nNP+9ZaOd5M@J)N_fe6}OUjBb8pr**C zeFtg5^ZFephp;+$>P%npB})>L`OH@mk0?@yi-3G?q;`HIX~Uo{Q3XvJ2fE9Zv3!&s zg+RA~M@W`7bniK*BMiL!wCgOZhG7l25P}egSb&$raJ3xs3tj)7sQF<}SFniusrSwU z6(TK7@jaDp> zewMc<;(97TD`I7p(8y|>R9tp4%{TPa_ z)NWuTmOjXtYQ$j4&XGOEtrzU~@7#Ok1V>chT}nzd(-~ORX0b6dVzyoOyGP=R2;oO99IkfMAfG}|6tzonD?N%Q z{EGZdu$v`ytx0`jjc|pE*q23J>Ry}EH>(?cJ2%dDw3YUK)IcDqEp)oxU>S=ci?mMO zk7SSxZ&D+PXb?KB z9J@uF+u#UnP!r5>K)HeNvO@?VxjiiU-wW9o9d)>-!{MR@R(uKqar5b#pGuN8rQ(qq7<;5M( z+}8+Q9P)2>UsFFokFe1XhSomy(q>jKyY1K(58Sqqv9Gf}EvJLX!rg0MozMDgKm}=c zM;2T{HtHr1REcXn3z$_T;c6eusYd$xi}T3u?`n_Uw9Sp!g{0cO>Vam2#oL7t5X8M7 z#%UGJXQxNVPyAguC4u0qzC!<|p0wR!W~3jN<&;l^wc0F8siRsv^QCZNZ^I8qx|_oa zfB~;zce?B3&UdgNHQRm{9_a7LMCH4#OsSF+MxlPbM)_HHJBBT z%591!)JaK;#Ria?kc8Iy#nkXI)`t0H!hx9ouXu~UNXC9Ir6H-U+^9@;yJ(ZuEomgC z-BY~l4&s)L*hF@|YsiZw90Ez+eu-72cK=BZ?SdNx#RWt%O5w98m^BI`{c@Y=8Z5oz zVdIOIf4#Zyb`PFcBt5K+F2Y~KwpUKjYwF9ZDp^Ib)3&dg)k%mLN}STuT`3)CtPRAZ zDPcs_$|Qz<<~fuEdaV*gJaTP3+y6a>MI8>*5h)6`0Y!!PjXGc5F?;Y*I;+G+ks_@` zn(YnoeePtrPe2{j5jw@ixk(i}$5-(St^M`b`z#ncJ|z!v=K7GbK2`9wfxY4d!h}fR z0(V!79(dWd4nG6Zuapmyv+z1LFM4EpLR&yF3-F$Hy%4ZMzkrg-{{fEdaBln>4c$Ck2^62;p;uzBXW?;+tNio&NmL%^28`=S}sop>Ts%nC}e*xhB z5P}*(JIp>8|1yhDOL{kF_1CRYdiJL)KZEOPgivw5n(GXYge7f73a!_7cB05{*MEx? zmBr8APSEY269AG~VCNq9m5V#yhmEt<| zlSyLi!Fn&_-7oGx^)Fy?(!9*AJH#aVLp-eX%QkV*GpeeM`tnUNoz$7@eNo~TD#B#>7@4~i(Q82fBnWhtbUUDdMSABgYc&1vf?Q6<4v-R>?0 zaj=aPVNmx8gl8GCC#(KzK34-x;0y=nP--SSr}5}(`m&0=-3qvlvyWnz1qQPP7BWl; zIB9s(f8_qv+t%p_&%&S~EY^ASB~3F;*RDN}(q$QG?{HD|Z^)TlSPKjxD(u8}so}TC z&=RckOFnyI-ks;OU3aVr@y=eFq%P21va|Nn?IIg`roAMgZ zVVLrvH2p%rY#|N!>TV>oPs~zB&@rl1=v z>SSHap3b>md-xdjlVwGVmHsGgU7`$VmB5lXWgaduCNW%PAW`^_)ob{oz<}O?PxPJ& zg=NawRbSew45&P?TqUs*vvQ~$jrQJamoQ>uRrHe7(_>s90)x1aNMd=DABGa!C862=|O)*M%&fY_U!;n6!6x=Z~y4#7t%(YlPUG&e?GgmeSletirf5!}V1{`@F{-cpjdS{&=`QCiiazg~|4vZ=?OGqbN`*m( zB(x8&u~=}}Wzfu~T{)gVMVx~~9%d~uMaQa5WWvKz51c++k-oY|ZK$F^1s%kXhEfc& zF;6s{TSZf4E5B<1?7v*qDd@DkVp*jNSgY@ucTzMjqg>_WXjAzQP~@gD#Mev@cB zFuP(w+=N?}+0W7J!UU*t3UH#}8UB+|3vR8`(o(UfOYzK1vN z%b@DYAM*usT@FG={tcn0lQWYvF9sbd4H^B0n*^1;ElNtAI&;t93J?X$Re2B#K(2}( z^Zryk1EkBm&McwG%#vO{Dm{#I&qz+7{(II?Y2aJ4ONXRB3B!ak^4`4C|WCkbM6(=xNm}Kgk&PjOPxCNvf`SZ#dBZ z9eHW~Q)B4x&7<2obb#@Ws)zYv-yf<4^OYIqF71rdbMm7(hEutXa%Ex`Y0%<{%<|QL zyJ>rsJ0hznfMr?nCj5DZ>KyrTol{l>$y0I?%p|H9KK_Y@EqErCJ&| zm3RX%E(JJpd*+Q>t6L89x;}kCxWg!HzaGZd+x_C{`q|&_9c*mUz-x39@g#6UN>Xi} zW<_G31XoW`WGb*RhI$_Ry<)`I3u2JE!CIL7AK=EWDio?g6-K_5I=MoV1naR4tzlW! zV^!cfaEBMZpIq6x!k)<;XL4@NBnIp(pg}!Je7SD+yZvBSD(JkDt8rKJg3*it_ zpcU%}+|j1lV@p(>@t|f|*%!D|`0Jfl?cJ|-G?f8YcH*5R{)}x;whiQ%$~Mklt?|hI^|E1 zu{H4;me3q2yK*9qQIeBpwX#iit7ry_WmwWD`QRXB+*+5J=q_iDf9b0Xd+3xev@Br+ z(gLyohu)XU9?U}CQEK5Z5vz0Z2gZh|wP&=iG#Ow2{gl-kqqa`Qu;unU`NFT|`y$f; z!&FA;*vQ#T5V}08Y9iY8LJi`Q8`5U|@e0K5mO9fJAzB!D<3b=-+F0Z2XWZ8XndDq) z_W7Gd*Gljq*xpVmknY6+PectSP9T)rCz(VE@9LW~)<<<;g8>4c#1d+p2OmaSu!nR88 z*0-I(>{qaG2+a4nCpHp4g2SPnrE-V}8#q&El{R0U+&{$Ps&{WSKjC_H(1T0b3s^+_ zi0QrsX7vjpltis~&vbu?aMX*y)WPS7OU-e_0ZLOmCab(#p1WL4?|$>czAR#pP(9Yp zgsNqIsz*AAYj=ru-c?6*Yj_%0_biWhr}OK}+##wi+ov4Z;)sd%{Bo&KbdVBKcK1nV zQ$X?CkVlKyqYJuio_ly?^s@CFZQ(cFXwUPS>XL2z<>HC_nSvL9g?3V<@Y0Z8l|7Qg#xZ93L+Ub@u(j>>GWBuP`dDY zfS@APZR1)T+opuQS^di0pnrR~NqydrQ$O=Z2pHki{ z)F5G%{Z9oR30z`@x+xJ-m)?qXJL0GH_YbL!*4d%8oe}Ox^UF9EMjXaORpPnp*jV^}jPj)}LU5(`ebyimUo+=&c znJ;&7bnX?LbJW@R1@Mzx;dAsJuzKfG?F6RZWD1rAnB>-A_pa@8u7hH!bNPMiS{E;Q zXEZd~yQW_JvRG>XmRph~@jk&n`kIm(;vkx~uh8r^;)u*oIqLQ;*HIiXuBu+{+YLH% z4%P@VyZ^fDT1RM1-+b2l+Ln;=T8?z-(Q|Z7tHXs_F*S+Yq$C%rW9Kz{ggWcnb57~m z2;4m=M`rCT{HvPNNHeySK3x`#NL~AR()YD^+5gU-CvdZid@MjbTNZ5SLU(l?s80`_ zMjpp5mNZvKASc%M$w&}#x`;4#;?}6xzxpcBE+_!TwtCU&@nxmy0VMGJeQ1}Cppj(? zb`MrJ)bd3H<7vH0-ELE0)Cj=+pceV=iaj-%M#sF~sV>+$-deIY@7l-F0`pp|u|(Nb zvoujEp0s3=s&pw-xMg2+pMLxAWDk#10}s2m?ZxVQ$Ckimy8x2f2;SdvdADo%S=_{4 z9@jXn}fD*gz4 zl69To7AOeKcFe%Z>bwUMfH+=+lSh2-g><;29r7FTzf&C1UUCJCl`Xwp3W76SIyziG z`L}EQs;&8&%Xvv14m$aYG=IRMqDooN_B$9VFHf7f5P7FmNqN+SX>JU=@ zv1zvzDSQ)CJkuA1P>@?#lE7sxTW{MLHw9E+$WyTA)|(4z!5_{eVFECLRy?cRN{Rk7 z3_B0K4n~`i%yEBGRY0SX>=W2?9J>JH<<}xAhS0iiwermh(1x!yWR%=J=b5<~D}YEQ z9Z#%3^8D#;%xu6+W#4l$?4!chs7f>Jw{9H-?9|T5^VqJl>WA6my86CZstKm0AEM?# z5lj2w(f=gIyY;>61;0jQb>;^thhWWXC)Y``o92vO zTQ;#K+l^!Ha;=3XbO7>O3AI7I*JQ8X+MQ^LoYi-UimpK>II{tQEqBJ)DZ`bxOu4r?<*$qn7DJtPG{9N6(u=<9KR$9hu^BFx!rA6k{$Dr+@T95mc zdY>p|lJFi~?#Gl{Hl7T1pT%~?UX%7oeIcozU3vl(MSKL*kK70c^K(y44#<0cM+f8k zBbC7`D>WgX%IAK2ziFFTtSOx~*Dbe1^mM;8X;7@3?f1Ce-FL>M@aoee z&wck*Q8)?FL)`W~!R~>CLCb~5ZSK3(As4qi`u#)u_a>*2(Q#_Tn%SHH9Q0JIHvAx` zoal*%sW0PAVi=p@NST`Fjc4v>)&m$E#lIcuCgce#`2IRzvF@3gb3Xb|Eh~qz@{(gk zeW_hKOYbVSP5l}5y5JVGw4D12g2C>q+1IqYRnC0tx$qoKO54BR7B#nTTs-a?Qg7$U zU>b=R+4VP?Z^g7$)%^@49UGV2iuRjz4`~fhSb?d%9$6AoYznc{?xGd*y>%v?(!$V+ zvbz+MSU$NU^Nf9jl|K+bcxr*SwPeFitJv0){T)qO+j<&U{U@&d?9J{>gVo-~JIla$ z3tdtlvcq@XyGx(TD`7?q-~5`hM=dP9wS_;u)pF>T^~8KHXWivWyM8gD%S>R$$;~() z7s49tz7#^l6;~5xRYIZ$GE-U$j<$INg^_6?kwMQcoTDJnvy{UpvUaET=h$nik#N0^ z1OJQVQw6Z+(bKfrr-vU7$YQ;uzG~BXD8)mx35$sEA(zf*m1A3wMQuWhEnhG z76Nm(BMVdGpcRR0^UBF`OD%&3FFDF)BZ>%C|t2JO*!OnB4aY7X+&<*J zN|{^-TU5lYn_n1-^&8bfiAr2qK~A*gCBD|kCiPPCrF$7qNHHTJb$_;4Pz`gAP_6JI z7>c_I6aEKvZPNT1GzLj|=Hy7V>u7`=Aw#=n!Sko~pBnp-R^|j9HywQIkwIW!-ZK58 zjecXdkn%VEr!h>dw5$l?vNQq=#Z1HGog5u|PM^%l`jLN@Qryx9gv$u%#;+GR(y=g~ zG5$=Nf7$9#JZ!J)b|<`eeomyJtI=wAnHKw{vQ4$kk+P})uh@p|fIl9y;bM-XTYKcK zK_9xot03##{{Z*uF*f{&u%C+U0y0)WUiZe$8(>LqAkE;9_aDUDv%d$3G-uIQq|3Btqn#Q&D&G0_-xHvNOS zzytx_6FIljJR==3gcN{vrk~*Xls!>rb+P+sH2t@vO0wqL6{=Fl$Fxee?Xf={x6kVg zQSqH08xJ$SOt=FXxB=okAYCi!y>Y0(aHlHfGNjCE!|UQd!17qdnEnlxF+~O-ow!T) zH_`&ct2E`E07m#rL|;a&6@IK z`JI?Nrkk0hDOLNbvFF~_8uPZfzbL?RoIZQqGJnX$LV`nf<*oA3w_ihWM$HX9#9NWf zKb7rS1#1pO1Ex|Lf2KUG4Xqo>Gl`ZwT~ec8D*j|74@ut3W%NhaBb>Qj%-o=v$QJ!; zu@)i8ETuIStQhV^?#|a_0!$r>B)qd7SEehR%~HBIp|{0c+Hvq!^dr;zZ@*q&b}3D` zDMJIuwlzdigSv$kJoC|*P^0P#t>Mc{4F$IU;&=6wL?Hf*wT4@UMtStKre#aITT}0s z@rA*d3f;YRQ3)R2$D0zd!&`~6N#3a@f^?r1yYI&jo>{)8Z4Q>K9wgS2b`plFKImhWUL$)(<6u-4iU@N~qm zdJH5pJ}Nxv(S#zSFQ8mjD&~h>lmNp zOj<4=^Olj8{)5EAoZ=OCD;8!1aa1ZCIBw8md6VWcZ`h59*-Q36?bo@IfOHw6-d6g6 z4fYLQ@}@r-;l&j8JLdc#_%h!v@n1u{2k(b)&KZlsM6Gw9=;L`Rd@S|68j|V9X)Wms zMXROq>G=KwjPE0Xg&E4ZxkVSfTZMdo#l-@-nSWGgU;G&VOAV2Ji(LKFadEzG^dI2T z^3n0K@bE{71iU7r#!OHBA_K&L#MXX<5ImP0>O zs275Y;LFZ2Vq}uBOnh5Zphc_wgZ?2meb^~|^}yrOJd6DK*sdl^=;C%c#W_+1yudXto67ULIcdFh1bU`%f|snQtc~;$=gbB%?VNC0X+9rE(`Cc?NYN z#0TQ3G~M5Oqi3yAWxSFShB=l7?%DVM158&lQOg0kzb^BP?Y|whm-tQl_?@3b;$LyS z2MltS*6ZPhKuac-itncE79W@wwr==51dP%o$(ZuLm9ZUP*8DQqHNTS^KtJ~3apsEy zO#=b%`-JzR?(ygWk9%PfNdQTEWmc`L`X+=JK8f6!8!lEBL{!1x>oqf`Zv z?B7EG^FxWZE8=5$_AxUBEc8Q~*$*;4-H@G%P0z`e=QcdhOGwc9rt;`8`n7Pa#261R z$7%P#FY((SR`LPaKG{B7Wpp_-RrFjc^Hc&5evU@B;&T|Uz*{Cjh9s8@6MdD|ST)^` zyoY0(Oq%;bIw^k&G=*~8-xlV|*3Zd!pZwLsrybu&20GAnUrO$M;c@VE>#yk;Pv$7i zO)DVXA8sSMAM?vK_h=)=Wi!`B^Q*;^ZrV2?Y_7_SbX*ocs$k!U*tpk{l2Yolg1x}L z|BzRoNcWy6ClMkOD*BN1qiX>Nu=VBue{9ADF)=Gq)KKyJnvgG}WFE=JDy zW1}DIG~&7M?#mYbS`Iq2BqWDWHA3BgUIht(;az=vhr}X17a#TK3^vn8T)?R*TCFnKyf8*xix0?TUUQW~ z zfKf%fbaagdX!;-ECztM~Y$mUHXhgL^{1;VOj&=kb8#`N#givCN$)nw{V03I6o{wTamUG@~pD4*JYD z4fN^%7=(1wJLKwfeo{`*U)-$zMb`ohSq}yN8VB6llH?Ng+AQ5il$Jrq8Etp?@_cBt z-t*o3|1*;OzXP)4zGUpERG%dO4dyo;E}cqJrlY^iXgKs&C`Wt3&6$r--LZVr2pDRw zEFS+#j2$DIU@e%CPdGGAVEtX1N39_lWz*8+6bUp8-qeZCGq|%rSN##ATi!SW2LGIM ztN}+i1yg4zb@r@K8g2lS)DMZ>wS#CW8@WmYJW{NMzvvuV0^jN+@T1wR%dQtYr>gTN zp=tw`QfjYCU=?x-CevB0Go9WJnHJPR2;u%wfS;DUK>LZiswwxZ&Ri9jI|9 z^Y28h;o*{|g|-qeG91=0$4-hic`K3pN|3%VZ4ZKm3gGQ4VFr^<0>f@IgNN~&BeSG` zFCP5~w9~otgwlTttmb3^{v}-X-Xv5_CN&V5aN*P_5SmvF=RI^+Fg}%_KlV|5zX!2w zP<(lJX+p3nb|NdQ??OBrN7QoJpCXVLF-h2oat#-Z&DA!9og7((`3|w6HehQ5{G3WN z1Js4WQj%Z>@+qPMrkU?^I+&!L=(3GyElYu-3gTDSy-N4KDgJQqoJhE&1+L5NLb}y? zv0d^s9&~$TKe$n?{C&r4>OVklUc=K#M>RQKMEoah{Kh)Io~YA%_jvz9^Bcj@=GGX46LyS{pS&6(*n-$WUuxyM?%G#Z1qwdEJXj+tP0VimgTQEFm+ z3#(l%Hf>;;s-$W#$;o4{@`0+DuWET(D+X&n5(;E#5J6*Y zr94O*ZMhW(_+qO63(gt{M_2(-5@jpQPAWuuD`^#$DI?9^`X4(^3B6gWm1c`g&u1fe z#(&&OkdV715kq=4Nj6!J=2{bt$kz^f^i zTl=b?k05p65)DOIf+jb?kOcx~P`b)&oM@V?x%e_5dUWLtA==Z-4!bMf7?MAal*TMa z-DxKmG2UruK%P{9+=@5HBYXA}yQ{+9$}dZX|8*t(qBFl6QRGAOnScMJJa zO5}dP!S{F3*B|%$>?MZ!eyQH(t1ajhO0Xqo(2Iz=`d=#_AVH3u4~%Zv9vD76BVvPA zuuU*EJ@4YeP!LU>6YMAK`b$SQcX<4wX>F|i(*1$Hjk!j->-_rzbHc;jp3pO9V;tL6 zl>4kpIadSX1m~{U3nj*;-&TlN^J3idz&gi!UgIVr4gC6J-6jthn;Fuwx@~m#h(O6& zo6cM9q}Nron7zfo6VYI({DK|LxN1kYHTe1s;Q*cMcYkg-hzX=>*QS={E(#37|YpN;vQa=Cq08} zvY!As!rZ<*>R)8*TMWa;yup*nU2$2kN*kl73dlA&t#_emm*WWj9gl>aZQ2cuP3rE)F5wXuT4&ihSm)CZLZ&;~vh> z5iphLmyc?R!qMOfG4P%k;xwS*B#(+Gfpj%b=y?VO{?m8v1u}ElD)*H!xLX28TIW9q zWw}*K@A7i6Zv&Ks=4#FI05ou=9#3f`4ZyT8Ec384fA6GRb*X$g3}XgSTnenj2)xrx z1th|poP}^v6+N+|^1^lzb|AbDnxf-)puqBkq~UFLFKRg!e#Zo58J52L#dF04f^yz* zTbolt@#hj)^MSfnYWgKKUU zT71-0id)9jt^s!sQg#Eu@Wx0DQ7J0c5q2s6|%4!_3HZ+lyzIr z%P;k$>eLf=jV)EtH%7eKhe3X_cytaU#;?@-l_Zd6cPU;0gk7t{s@_uT+1B|8CVtUR zs>upH3)sV6K_hJHt+AA&9F0Tri`T-Z`nAWpLdcHQbN@LAdLMLfgyVc}ngs`4b#;_? zu7`vQpbn(Yk}nyf7;XxOz{`=>4IDk>5%-jfo75gmUV#Y6V{cgUn$<eMyauI;_C_o|NKd5}d-t*MrnuQtXMbg)^!%-bYnHqta; zyU3a#kV~u;GT>pRiy5l^@LzTqm+AoU&8B13MV<{*mBXSe2m@&}dT zngSz{N^+DC_r%ZN7akmqxHIfYlOTPo3P+#I``2)H8SGoD3a|>)MoZ(OH;ULKevPDA z{KXUU6cLz}BLBQ(7xf=t<@~CKps9t7V}@_2scC-P=jb=%cW^UQ9H2^oYVN?hbr-{{ z$+QD+VtW}|U+zwvkiKDZoxv~0a7#&Y&gr6I^Uk;!f}|*35q8;m2m8S!z(|c#La{+^ zJGZkNO34yVaRF7=8lC+LZW6c!B&+5&*{D(&cHDipNawddC~^}&msue{gJ-&t!vDrN z978`;HX2%A!4eh*C}ekGn6x8}0O$EPNt=T%KVO(UM_);x=>1iQl@_cuI7{Ahw9I)) zjlb8%&fR!*dZI3`SjY(RH%mQ zu40Sa9O=a*ro66vJvkV8dKzm|hcD7RR-t+1Zk_i*dE@AI^^5d5N+$uTI(}CEed5b9 zXJ?yVEkC&=W`yZO#3SeduA&iMkjgQM!u=raS4xujDO{R3i$%6TD5CDOXlzI)!5Kox z(l%S(E9Xc!(7V(#Ep_nXmTfY`{Fi0O)4-bLCJeE!2v-T6z`^*)r)m&6jjK4nj|fir ziRjm{J3&vZVv$}YA0Ppa9I#ziSyo-Rq*pu-O_0SeIKZlxr!fEkpxs4Y+w<7oSIM(d zoiyTZpsk@b6uE6XDI)s#;wNJ$&6tdzmW+=@f=}$Pc_SI0A^LmSwh5eH-WiSEG`;e2 z>azh~A@HH75fh*2kGHM{;p~>95oPpMno}1qe2(8Je_(ub`p12j+KwME9ImDgwrnrc zd-2lbcDGypWp}9HVl;hEOCP&+{N>z#91x~;{y;|gU(A@OPj@^jCnROib?+Ox=%OoZo-{o=$`&L3i+6{QXBBCVhjC z^+&2|YTxS0^U=EdDfA6ohcZm-Lbq6M0xAH8I>DW=73U>zs#FZIhTFK(%+nSF96BS(T8#5Rx0EU{J;ooEqN3&kLddfW^WP;+T-B`8` z%tF_F#6(t5mu*k%T!5{0G^Iedi?@?ovI2|$&?Zt=m5U}%i=L$cxbKAnGnTirqwaT~ zDELl%j3A?tFr^o9#fg296bC}?L(T@q72kmHS{B6Bg}k-^Z9-~sMNsRjfM;QX<|DCU zdSW_UOHWPaYfZEE-ip^nYS@yL)HfL5OU!mU_ReUcycMD(utE`?vCu8n*g$Igz;Wv+ zvX2CVMV+}1HJ#PExM5ULuiVWOEqrR5U=GK|=hFjOQcfWb{~|^Un>k7MC<0L)>^1JkOd4O@A#Z z?kF5)aOX~(i2$?~6jwG;E^MAR2!FbihO>jquf&$K)sM_K$Ca@l)$Cr>Iqn7q`V~Mm zF(4Cc;9b@`eGS4X*w4HuESmyyG^G!v)_WaW!;PjdD#{Zm-+LKhKzhFUy7PD9)0?+U zGCQ0Q5-dHLvU#Ta+76~;$SdVZb;*!7te_^zI`Rw)eeq2eZNjtQYu<6ma@95DqJup# z16QjixghR4XgkkXIZr+{wx&XeM^@j`DBM-iNjpu>6?w*__mVR6y{Rs^;}QRzS*#N0 zLT5=blopqj2UEEf)-7Kg#9_t?R}gSH(DU_tWR1piKp>E-S)IkAzO16VN82AykMw-? ztNTd8lb7wRTG8Qk1Sg8h(G<4a?T77LX)IU2{nAIbXJLE9Svz|uDF9j0rvM2jxfSHp z{RwV)PFD6PpCFd`+dt7c!p5b4M0;2Dwx{t}-4C==WCNLXW?skTdqJV}9WA?+-X+jU zX}E1&6Q6S#F!g5LgZnqiXf*+OKAYN&X85@XJL}Hpj`1f7U;1tHbn$3A<=y~cLm8`| z$#K; zaGx4>z$-|R4X3KOxbNK91zX0Ix=*FA1kTzx7hiE_ShB8s1{YBX9KMQp3~o1a4qM$K zuP)danSq}bew$sc@{BF0>wJo1TBAkpv8GpfLXHIp$7E}F!J!bpcgv_qtB2*ovsfI+ zoGGkHRdJeY={gDzXVsoxY=KE5Ftau;@H^LD^dpdL{PXANft;70SFybsHlB7)Hm}djuYK0@DaH@rS^<=^FKCZ&2 zUEl`kGtet4EUO7;^MqkkoFxe=^3bf)(Ybiy`BcP(flj`^b(3)|)7$#La8qVSWWz4I z_Y{AXQKFcMboGS4v7T&Ns6is^v35-!3ysJ(0LO$NU9S{N(W#nx)cr(}tRg7CKq6Ca zk`?Q3p*%rU(|db&`{uSTc`nERer?nKsx>54q+lZ>l0OdslvXHPv)`prAxCc5|K!Dw z{|A`Lu1RR3ueu2oLKzln^3~mzpU42p{WVhVVQ?4+N9CCg@%3EsLEdrD06$S+3^HMa zJTkT1V2@a?u!~XMV+7-j07C9z-s}M7s3VJ}1Dku-JAY+h6^um$E(t!NOn0J6oaI5! zV%E-tAvrzWLJD_!FmhvDs$;>+3V63v{DOJxFEgcM5e(&~* zK}(>qJfgcYUvu)t_hKxw38jT0^1bGp|{c6xCMe?sp_xe;9_+Vw^L z1JD;>zLj_d!d0ZPb-K9_M z8a2{h!wOHAr-hTtQ`9%+z6Z9q-L+_bw8Z5sTxfYdKRIGZQD;pLcyjX8G_5r%Z9Yv5 z1B1+u#-ZZA1TI`|R7KJ(L99Z;+7~(rts~J2T`yl8i`RkRstljg?G`+anYyeRj}Z}4 z4l>`%;W9<4z89kv178*tLJ}@K`}UNC!!c#?=F6(jM%=q!dWL`GIok1P4w?pI9)nCt zY7K@nBupiBx;xEEDbyBy&SNomN9FtBL;JAEZFt{r%Il5>qojALdu{e@+AexxbQa&g zPQE^t(bDHs{%7j#lTljDBkCnl6(%}PYx*EFNejq6q`5U-Iey^We_&sCyKJE^e5dhn z+zUpSMj8;a`Yw6KVuG6BhSa5h{xPX-3D*#YxRxr(ODHO)3)bp+?GI$3OSPhZC-E>t zmrg8PV-kjTZK7bvd-bTM9JCN?>D6Nz`cRHP*+}h&S!!6co0=eAI7_(FEu^)z(N+Kn zRZ+8p6Eb51j_97%qLNkk|6!&6ofn_juhBhobKh9jy~aFJn@+~+^{ z9c)1)OHNvXf#aQbbS+0S})a8_idk1b~9S z`l0X3bBluf7u{ZWU8turG+>>aX320zG{}u>jegDRVxHa&m?pGx;WpYzm~Tz_a?OOK zf*G+AWFm)JbuF=QWXU zXhHbSN+8;^O%>O6y}Kih6d8;u$XrSH0C|l&hoCS?b2SVZdoQIDe~jjy6kZI zwt^#OS>#F8q4Fp&Emm=_Q^V*%gR7TnRtd!Xn6As(Jy?+Z^N!i;NZseHodVD?4p)LD z(1@X`fQH*oG!K|_^ld(JE0Q%`8dV9C2rCd)AeX>Bh49jZf|DVOidK#uF%xs3z$A~b_RS3Aq9Ri? z+eyCd*~Em~mDiQltH#MT&Kpd|&&Zzm&i3M4#!m|S@5reZH&^P-?t4S^h+nSX?;QOM zj(rQ-g9pIhICcE|5zu6QEcSP#b-*HTMYH_YyhNvMw{nQnctcmN}XRY7Z5b6*v-7vGQS- zAh8=kE!{dn6W)DUb@^L|(&cFtzDDx-FCNuW4S@995`(OC%^k>ZN-z2)bJ7+~w_kSa zbz>1^4#pu13KI_g^5n~#Tnz{q>LDM;Y+T+HHj^(w0>gD)dVeJI^HWAb1SM

    #)O} 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

    *o9`wJE>2+TYz0q| z*j+lbr3H`sQClmoyY50x!9e_w(hG!2uqx1p1K@- z^=+Z%k-#lq%`R@e-!zxx4%B24c_0GSU5(s}!6W)-ZH2uw#d@Cy@Ho=a=?yUrXSR&H z%!X2euF$wrnr#H$%ms(mSU@fuOvx~M02!;N=AiI+2F6WY>(K@Fw^fG3J>M0Ts_{u4 z!>-HQcS$2%#nF4E#^oBsF}t!>LHJZTGaaB@Ts%|&D3xBTJxBJOn7@aOy}(h*7P(2qbC5~5gC*GC~6`WWfpq~T(!AX&mt%% z)KC*GYxrv|58j;7OHRt235tE&d6l~vy6-dr3Ij(ycmqdWXM4f8hw7LTN;MP^vhH?0 z$l```dSNNFUp?Ef35jCMaGEvEP}(XzT()7n+C=UIm3G(ti2%>X&V<9(6QR^Y{2MFi@c<{<=$O4^7epkiu|_D}<9DLPy9VxWKJ^h=AX&3vw`Ry^AM*Kib`5N?e>a0T)vkahgN{ z8o|eYqG1xI`S~aiOPbh9{~_d((6J}{;2wMlHD~$q{pxvM!yB0UPqIbZ2WsJxez)QZ zTFmaEMnQE{NscUuP$!-xrEU--n?NDJNQ{*J1?>FK;*s4Kl;sbk019ihFGcj^GsOQj zXpq_7(U&P%9{i>c_HIc#3LaeP;?rRjtZ6=e2T#mZIfN>I?C)}W(Kt3HkbDO zy(=tUVOrA!B!A$15fobz?)etokoHo=WzNxF?D<{$=i*nwsdH|BhI;=3zIq#*0YtrE zH)L%j$jnR$47PJw%)#D;nfn|iY)P&RZ

    WWp?iZWJF{h)T+Oz<`T|YVo5E+%ZNQi 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ÏuB8m#sGZ^tj88TPrG}Wu3nV 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 XAYV literal 0 HcmV?d00001 diff --git a/examples/react/start-rscs/public/example-ukelele-tanstack.jpg b/examples/react/start-rscs/public/example-ukelele-tanstack.jpg new file mode 100644 index 0000000000000000000000000000000000000000..1e8a556696a7560532291c01d382018181722775 GIT binary patch literal 242288 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 z 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 z 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 IG$lv>+1OeSrvLx| literal 0 HcmV?d00001 diff --git a/e2e/react-start/basic-rsc/public/favicon-16x16.png b/examples/react/start-rscs/public/favicon-16x16.png similarity index 100% rename from e2e/react-start/basic-rsc/public/favicon-16x16.png rename to examples/react/start-rscs/public/favicon-16x16.png diff --git a/e2e/react-start/basic-rsc/public/favicon-32x32.png b/examples/react/start-rscs/public/favicon-32x32.png similarity index 100% rename from e2e/react-start/basic-rsc/public/favicon-32x32.png rename to examples/react/start-rscs/public/favicon-32x32.png diff --git a/e2e/react-start/basic-rsc/public/favicon.ico b/examples/react/start-rscs/public/favicon.ico similarity index 100% rename from e2e/react-start/basic-rsc/public/favicon.ico rename to examples/react/start-rscs/public/favicon.ico diff --git a/e2e/react-start/basic-rsc/public/favicon.png b/examples/react/start-rscs/public/favicon.png similarity index 100% rename from e2e/react-start/basic-rsc/public/favicon.png rename to examples/react/start-rscs/public/favicon.png diff --git a/e2e/react-start/basic-rsc/public/site.webmanifest b/examples/react/start-rscs/public/site.webmanifest similarity index 100% rename from e2e/react-start/basic-rsc/public/site.webmanifest rename to examples/react/start-rscs/public/site.webmanifest diff --git a/examples/react/start-rscs/src/components/Layout.tsx b/examples/react/start-rscs/src/components/Layout.tsx new file mode 100644 index 0000000000..ff0dafa9df --- /dev/null +++ b/examples/react/start-rscs/src/components/Layout.tsx @@ -0,0 +1,139 @@ +import { useState } from 'react' +import { Link, Outlet, useRouterState } from '@tanstack/react-router' + +const navItems = [ + { path: '/', label: 'Home', description: 'Overview of all demos' }, + { + path: '/pokemon-rsc', + label: 'Pokemon RSC', + description: 'Async server components', + }, + { + path: '/e-commerce', + label: 'eCommerce Demo', + description: 'Composite RSC pattern', + }, + { + path: '/low-level-api', + label: 'Low-Level API', + description: 'RSC primitives', + }, +] + +export function Layout() { + const [sidebarOpen, setSidebarOpen] = useState(false) + const routerState = useRouterState() + const currentPath = routerState.location.pathname + + return ( +
    + {/* Top Navigation Bar */} + + +
    + {/* Sidebar Overlay */} + {sidebarOpen && ( +
    setSidebarOpen(false)} + /> + )} + + {/* Sidebar */} + + + {/* Main Content */} +
    + + + {/* Legend Footer */} +
    +
    +
    +
    +
    + + Server Component + +
    +
    +
    + + Client Component + +
    +
    +

    + TanStack Start RSC Examples +

    +
    +
    +
    +
    +
    + ) +} diff --git a/examples/react/start-rscs/src/e-Commerce/components/AddToCartButton.tsx b/examples/react/start-rscs/src/e-Commerce/components/AddToCartButton.tsx new file mode 100644 index 0000000000..79c3a44e61 --- /dev/null +++ b/examples/react/start-rscs/src/e-Commerce/components/AddToCartButton.tsx @@ -0,0 +1,86 @@ +import { useState } from 'react' +import { useCartStore } from '~/e-Commerce/store/cartStore' + +// Product info passed from parent +const product = { + id: 'tanstack-ukulele', + name: 'TanStack Ukulele', + price: 149.99, + image: '/example-ukelele-tanstack.jpg', +} + +export function AddToCartButton() { + const [quantity, setQuantity] = useState(1) + const [added, setAdded] = useState(false) + const [favorite, setFavorite] = useState(false) + const addItem = useCartStore((state) => state.addItem) + + const handleAddToCart = () => { + // Add item(s) to cart + for (let i = 0; i < quantity; i++) { + addItem(product) + } + setAdded(true) + setQuantity(1) // Reset quantity after adding + setTimeout(() => setAdded(false), 2000) + } + + return ( +
    + {/* Quantity Selector */} +
    + Quantity: +
    + + + {quantity} + + +
    +
    + + {/* Action Buttons */} +
    + + + +
    + + {/* Info text */} +

    + Free shipping on orders over $100 +

    +
    + ) +} diff --git a/examples/react/start-rscs/src/e-Commerce/components/AlsoBoughtCarousel.tsx b/examples/react/start-rscs/src/e-Commerce/components/AlsoBoughtCarousel.tsx new file mode 100644 index 0000000000..5b719dfd52 --- /dev/null +++ b/examples/react/start-rscs/src/e-Commerce/components/AlsoBoughtCarousel.tsx @@ -0,0 +1,94 @@ +import { useRef } from 'react' +import type { AlsoBoughtProduct } from '~/e-Commerce/server-functions' + +interface AlsoBoughtCarouselProps { + products: Array +} + +export function AlsoBoughtCarousel({ products }: AlsoBoughtCarouselProps) { + const scrollRef = useRef(null) + + const scroll = (direction: 'left' | 'right') => { + if (scrollRef.current) { + const scrollAmount = 300 + scrollRef.current.scrollBy({ + left: direction === 'left' ? -scrollAmount : scrollAmount, + behavior: 'smooth', + }) + } + } + + return ( +
    +
    + {/* Left scroll button */} + + + {/* Scrollable container */} +
    + {products.map((product) => ( +
    + {product.name} +
    +

    + {product.name} +

    +

    ${product.price}

    +
    +
    + ))} +
    + + {/* Right scroll button */} + +
    +
    + ) +} diff --git a/examples/react/start-rscs/src/e-Commerce/components/Header.tsx b/examples/react/start-rscs/src/e-Commerce/components/Header.tsx new file mode 100644 index 0000000000..35542557fd --- /dev/null +++ b/examples/react/start-rscs/src/e-Commerce/components/Header.tsx @@ -0,0 +1,62 @@ +import { useCartStore } from '~/e-Commerce/store/cartStore' + +export function Header() { + const totalItems = useCartStore((state) => state.totalItems) + const totalPrice = useCartStore((state) => state.totalPrice) + + return ( +
    +
    +
    + 🎸 +

    + TanStack Music Store +

    +
    + +
    +

    + Premium instruments powered by Server Components +

    + + {/* Cart Button */} + +
    +
    + + {/* Cart summary (when items in cart) */} + {totalItems > 0 && ( +
    + + {totalItems} item{totalItems !== 1 ? 's' : ''} in cart + + + Total: ${totalPrice.toFixed(2)} + +
    + )} +
    + ) +} diff --git a/examples/react/start-rscs/src/e-Commerce/components/StreamingComments.tsx b/examples/react/start-rscs/src/e-Commerce/components/StreamingComments.tsx new file mode 100644 index 0000000000..a1c3bf845b --- /dev/null +++ b/examples/react/start-rscs/src/e-Commerce/components/StreamingComments.tsx @@ -0,0 +1,117 @@ +import { useEffect, useRef, useState } from 'react' +import { createFromReadableStream } from '@tanstack/react-start/rsc' +import { streamComments } from '~/e-Commerce/server-functions' + +interface CommentEntry { + id: number + element: React.ReactNode + receivedAt: number +} + +// Helper to convert string payload back to ReadableStream +function payloadToStream(payload: string): ReadableStream { + const encoder = new TextEncoder() + return new ReadableStream({ + start(controller) { + controller.enqueue(encoder.encode(payload)) + controller.close() + }, + }) +} + +// Format relative time +function formatRelativeTime(receivedAt: number): string { + const seconds = Math.floor((Date.now() - receivedAt) / 1000) + if (seconds < 1) return 'just now' + if (seconds === 1) return '1 second ago' + return `${seconds} seconds ago` +} + +const MAX_COMMENTS = 10 + +export function StreamingComments() { + const [comments, setComments] = useState>([]) + const [isStreaming, setIsStreaming] = useState(false) + const [, setTick] = useState(0) // Force re-render for relative time updates + const hasStartedRef = useRef(false) + + // Update relative times every second + useEffect(() => { + const interval = setInterval(() => { + setTick((t) => t + 1) + }, 1000) + return () => clearInterval(interval) + }, []) + + // Auto-start streaming on mount + useEffect(() => { + if (hasStartedRef.current) return + hasStartedRef.current = true + + const startStream = async () => { + setIsStreaming(true) + + try { + for await (const { id, payload } of await streamComments()) { + // Decode the RSC payload + const stream = payloadToStream(payload) + const element = await createFromReadableStream(stream) + + const entry: CommentEntry = { + id, + element: element as React.ReactNode, + receivedAt: Date.now(), + } + + // Add to comments, keeping newest at top, capped at MAX_COMMENTS + setComments((prev) => [entry, ...prev].slice(0, MAX_COMMENTS)) + } + } catch (error) { + console.error('Streaming error:', error) + } finally { + setIsStreaming(false) + } + } + + startStream() + }, []) + + return ( +
    + {isStreaming && ( +
    +
    + Streaming live reviews... +
    + )} + +
    + {comments.length === 0 ? ( +
    +
    +
    + Loading reviews... +
    +
    + ) : ( + comments.map((comment) => ( +
    + {/* The RSC element */} + {comment.element} + {/* Client-side relative time */} +
    + received {formatRelativeTime(comment.receivedAt)} +
    +
    + )) + )} +
    + + {comments.length > 0 && ( +
    + Showing {comments.length} of {MAX_COMMENTS} reviews (newest first) +
    + )} +
    + ) +} diff --git a/examples/react/start-rscs/src/e-Commerce/server-functions.tsx b/examples/react/start-rscs/src/e-Commerce/server-functions.tsx new file mode 100644 index 0000000000..3e34aa8d27 --- /dev/null +++ b/examples/react/start-rscs/src/e-Commerce/server-functions.tsx @@ -0,0 +1,257 @@ +import { createServerFn } from '@tanstack/react-start' +import { + createCompositeComponent, + renderToReadableStream, +} from '@tanstack/react-start/rsc' + +// ============================================ +// Product Data & Types +// ============================================ + +export interface Product { + id: string + name: string + price: number + description: string + image: string +} + +export interface AlsoBoughtProduct { + id: string + name: string + price: number + image: string +} + +// Main product +const mainProduct: Product = { + id: 'tanstack-ukulele', + name: 'TanStack Ukulele', + price: 149.99, + description: + 'Hand-crafted koa wood ukulele with mother-of-pearl TanStack inlay. Perfect for beach jams, campfire singalongs, or just strumming at your desk while waiting for builds to finish.', + image: '/example-ukelele-tanstack.jpg', +} + +// Also bought products +const alsoBoughtProducts: Array = [ + { + id: 'guitar-flowers', + name: 'Floral Guitar', + price: 299.99, + image: '/example-guitar-flowers.jpg', + }, + { + id: 'guitar-motherboard', + name: 'Circuit Guitar', + price: 349.99, + image: '/example-guitar-motherboard.jpg', + }, + { + id: 'guitar-racing', + name: 'Racing Guitar', + price: 279.99, + image: '/example-guitar-racing.jpg', + }, + { + id: 'guitar-steamer-trunk', + name: 'Vintage Guitar', + price: 399.99, + image: '/example-guitar-steamer-trunk.jpg', + }, + { + id: 'guitar-superhero', + name: 'Hero Guitar', + price: 329.99, + image: '/example-guitar-superhero.jpg', + }, +] + +// ============================================ +// Product Page Server Function +// ============================================ + +export const getProductPage = createServerFn().handler(async () => { + console.log('[Server] Rendering ProductPage composite') + + const src = await createCompositeComponent( + (props: { + children?: React.ReactNode + renderAlsoBought?: (data: { + products: Array + }) => React.ReactNode + }) => ( +
    + {/* Product Hero Section */} +
    + {/* Product Image */} +
    + {mainProduct.name} +
    + + {/* Product Details */} +
    +

    + {mainProduct.name} +

    +

    {mainProduct.description}

    +

    + ${mainProduct.price} +

    + + {/* CTA Slot (client component) */} +
    {props.children}
    +
    +
    + + {/* Also Bought Section */} +
    +

    + Customers who bought this also bought +

    +
    + {props.renderAlsoBought?.({ products: alsoBoughtProducts })} +
    +
    +
    + ), + ) + + return { src } +}) + +// ============================================ +// Streaming Comments +// ============================================ + +// Sample comments for streaming +const comments = [ + { + author: 'MusicLover42', + text: "Best ukulele I've ever owned! The tone is incredible and the TanStack inlay is gorgeous.", + rating: 5, + }, + { + author: 'BeachVibes', + text: 'Perfect for beach jams. Everyone asks where I got it!', + rating: 5, + }, + { + author: 'UkeNewbie', + text: 'As a beginner, this was the perfect first instrument. Great quality for the price.', + rating: 5, + }, + { + author: 'DevMusician', + text: 'I code with TanStack and play TanStack. Living the dream!', + rating: 5, + }, + { + author: 'IslandDreamer', + text: "The sound is so warm and rich. It's like Hawaii in a box!", + rating: 5, + }, + { + author: 'GuitarConvert', + text: 'Switched from guitar to uke because of this beauty. No regrets!', + rating: 5, + }, + { + author: 'CampfireKing', + text: 'This uke is the star of every campfire. Worth every penny.', + rating: 4, + }, + { + author: 'TechStrummer', + text: 'Finally, an instrument that understands my stack preferences!', + rating: 5, + }, +] + +// Server component for each comment +function CommentCard({ + author, + text, + rating, + timestamp, +}: { + author: string + text: string + rating: number + timestamp: string +}) { + const gradients = [ + 'from-purple-500 to-indigo-600', + 'from-blue-500 to-cyan-500', + 'from-green-500 to-emerald-500', + 'from-amber-500 to-orange-500', + 'from-pink-500 to-rose-500', + ] + const gradient = gradients[Math.floor(Math.random() * gradients.length)] + + return ( +
    +
    +
    {author}
    +
    + {Array.from({ length: rating }).map((_, i) => ( + ⭐ + ))} +
    +
    +

    {text}

    +
    + Posted: {new Date(timestamp).toLocaleTimeString()} +
    +
    + ) +} + +// Helper to convert stream to string +async function streamToString( + stream: ReadableStream, +): Promise { + const reader = stream.getReader() + const chunks: Array = [] + const decoder = new TextDecoder() + + while (true) { + const { done, value } = await reader.read() + if (done) break + chunks.push(decoder.decode(value, { stream: true })) + } + + return chunks.join('') +} + +function sleep(ms: number) { + return new Promise((resolve) => setTimeout(resolve, ms)) +} + +// Async generator that streams comment RSCs +export const streamComments = createServerFn().handler(async function* () { + for (let i = 0; i < comments.length; i++) { + await sleep(2000) // Wait 2 seconds between comments + + const comment = comments[i] + console.log(`[Server] Rendering comment from ${comment.author}`) + + const stream = await renderToReadableStream( + , + ) + + const payload = await streamToString(stream) + yield { id: i, payload } + } +}) diff --git a/examples/react/start-rscs/src/e-Commerce/store/cartStore.ts b/examples/react/start-rscs/src/e-Commerce/store/cartStore.ts new file mode 100644 index 0000000000..20c3c53f59 --- /dev/null +++ b/examples/react/start-rscs/src/e-Commerce/store/cartStore.ts @@ -0,0 +1,79 @@ +import { create } from 'zustand' + +interface CartItem { + id: string + name: string + price: number + quantity: number + image: string +} + +interface CartStore { + items: Array + totalItems: number + totalPrice: number + addItem: (item: Omit) => void + removeItem: (id: string) => void + updateQuantity: (id: string, quantity: number) => void + clearCart: () => void +} + +export const useCartStore = create((set, get) => ({ + items: [], + totalItems: 0, + totalPrice: 0, + + addItem: (item) => { + const { items } = get() + const existingItem = items.find((i) => i.id === item.id) + + if (existingItem) { + set({ + items: items.map((i) => + i.id === item.id ? { ...i, quantity: i.quantity + 1 } : i, + ), + totalItems: get().totalItems + 1, + totalPrice: get().totalPrice + item.price, + }) + } else { + set({ + items: [...items, { ...item, quantity: 1 }], + totalItems: get().totalItems + 1, + totalPrice: get().totalPrice + item.price, + }) + } + }, + + removeItem: (id) => { + const { items } = get() + const item = items.find((i) => i.id === id) + if (item) { + set({ + items: items.filter((i) => i.id !== id), + totalItems: get().totalItems - item.quantity, + totalPrice: get().totalPrice - item.price * item.quantity, + }) + } + }, + + updateQuantity: (id, quantity) => { + const { items } = get() + const item = items.find((i) => i.id === id) + if (item) { + const diff = quantity - item.quantity + set({ + items: items.map((i) => (i.id === id ? { ...i, quantity } : i)), + totalItems: get().totalItems + diff, + totalPrice: get().totalPrice + item.price * diff, + }) + } + }, + + clearCart: () => { + set({ + items: [], + totalItems: 0, + totalPrice: 0, + }) + }, +})) diff --git a/examples/react/start-rscs/src/home/server-functions.tsx b/examples/react/start-rscs/src/home/server-functions.tsx new file mode 100644 index 0000000000..123944781c --- /dev/null +++ b/examples/react/start-rscs/src/home/server-functions.tsx @@ -0,0 +1,102 @@ +import { createServerFn } from '@tanstack/react-start' +import { createCompositeComponent } from '@tanstack/react-start/rsc' + +export interface DemoInfo { + title: string + description: string + path: string + features: Array + color: string +} + +const demos: Array = [ + { + title: 'eCommerce Composite Demo', + description: + 'A product page built with composite server components. Shows how to combine server-rendered layouts with client-interactive elements like add-to-cart buttons and carousels.', + path: '/e-commerce', + features: [ + 'Composite RSC pattern', + 'Zustand cart state', + 'Streaming comments', + 'Also bought carousel', + ], + color: 'from-purple-500 to-indigo-600', + }, + { + title: 'Pokemon RSC Demo', + description: + 'Demonstrates async server components that fetch their own data. The Pokemon list is fetched and rendered entirely on the server.', + path: '/pokemon-rsc', + features: [ + 'Async server components', + 'Server-side data fetching', + 'renderServerComponent API', + ], + color: 'from-amber-500 to-orange-500', + }, + { + title: 'Low-Level RSC API Demo', + description: + "Explore TanStack Start's low-level Flight stream APIs including renderToReadableStream, createFromReadableStream, and createFromFetch.", + path: '/low-level-api', + features: [ + 'Direct Flight streams', + 'Parallel streaming', + 'Nested Suspense', + 'IndexedDB caching', + 'HTTP streaming ticker', + ], + color: 'from-cyan-500 to-blue-600', + }, +] + +// Server function to get the home page composite +export const getHomePage = createServerFn().handler(async () => { + console.log('[Server] Rendering HomePage composite') + + const src = await createCompositeComponent( + (props: { + renderDemoCard?: (data: { demo: DemoInfo }) => React.ReactNode + }) => ( +
    +
    + {/* Hero Section */} +
    +

    + React Server Components Examples +

    +

    + Explore different patterns and APIs for building applications with + React Server Components in TanStack Start. +

    +
    + + {/* Demo Cards */} +
    + {demos.map((demo) => ( +
    {props.renderDemoCard?.({ demo })}
    + ))} +
    + + {/* Quick Info */} +
    +

    + About These Examples +

    +

    + These examples demonstrate various React Server Component patterns + available in TanStack Start. Server components are rendered on the + server and sent to the client as a Flight stream. Client + components handle interactivity and state management. The visual + indicators in the footer show which parts are server-rendered + (blue) vs client-interactive (green). +

    +
    +
    +
    + ), + ) + + return { src } +}) diff --git a/examples/react/start-rscs/src/low-level/components/DemoSection.tsx b/examples/react/start-rscs/src/low-level/components/DemoSection.tsx new file mode 100644 index 0000000000..004921dbc4 --- /dev/null +++ b/examples/react/start-rscs/src/low-level/components/DemoSection.tsx @@ -0,0 +1,23 @@ +import type { ReactNode } from 'react' + +interface DemoSectionProps { + title: string + description: string + children: ReactNode +} + +export function DemoSection({ + title, + description, + children, +}: DemoSectionProps) { + return ( +
    +
    +

    {title}

    +

    {description}

    +
    +
    {children}
    +
    + ) +} diff --git a/examples/react/start-rscs/src/low-level/components/dexie-cache/DexieCacheDemo.tsx b/examples/react/start-rscs/src/low-level/components/dexie-cache/DexieCacheDemo.tsx new file mode 100644 index 0000000000..d2278947d9 --- /dev/null +++ b/examples/react/start-rscs/src/low-level/components/dexie-cache/DexieCacheDemo.tsx @@ -0,0 +1,199 @@ +import { useCallback, useEffect, useState } from 'react' +import { createFromReadableStream } from '@tanstack/react-start/rsc' + +import { db } from '../../db' +import { getCounterRscPayload } from './server-functions' + +// Convert string payload back to ReadableStream +function payloadToStream(payload: string): ReadableStream { + const encoder = new TextEncoder() + return new ReadableStream({ + start(controller) { + controller.enqueue(encoder.encode(payload)) + controller.close() + }, + }) +} + +export function DexieCacheDemo() { + const [counter, setCounter] = useState(0) + const [result, setResult] = useState(null) + const [loading, setLoading] = useState(false) + const [source, setSource] = useState<'cache' | 'server' | null>(null) + const [cacheStats, setCacheStats] = useState({ count: 0, size: 0 }) + const [loadTime, setLoadTime] = useState(null) + + // Load cache stats on mount and after operations + const updateCacheStats = useCallback(async () => { + const entries = await db.cache.toArray() + const totalSize = entries.reduce((sum, e) => sum + e.payload.length, 0) + setCacheStats({ count: entries.length, size: totalSize }) + }, []) + + const loadRsc = useCallback( + async (count: number) => { + setLoading(true) + setSource(null) + setLoadTime(null) + const startTime = performance.now() + + try { + const cacheKey = `counter-${count}` + + // Check if cached in Dexie + const cached = await db.cache.get(cacheKey) + + if (cached) { + // Load from cache + console.log(`[Client] Cache HIT for counter: ${count}`) + const stream = payloadToStream(cached.payload) + const element = await createFromReadableStream(stream) + setResult(element as React.ReactNode) + setSource('cache') + } else { + // Fetch from server + console.log(`[Client] Cache MISS for counter: ${count}`) + const { payload } = await getCounterRscPayload({ data: { count } }) + + // Store in Dexie + await db.cache.put({ + id: cacheKey, + payload, + createdAt: Date.now(), + }) + + // Decode and render + const stream = payloadToStream(payload) + const element = await createFromReadableStream(stream) + setResult(element as React.ReactNode) + setSource('server') + await updateCacheStats() + } + + setLoadTime(performance.now() - startTime) + } catch (error) { + console.error('Error loading RSC:', error) + } finally { + setLoading(false) + } + }, + [updateCacheStats], + ) + + // Auto-load RSC when counter changes + useEffect(() => { + loadRsc(counter) + }, [counter, loadRsc]) + + // Load cache stats on mount + useEffect(() => { + updateCacheStats() + }, [updateCacheStats]) + + const clearCache = useCallback(async () => { + await db.cache.clear() + await updateCacheStats() + setResult(null) + setSource(null) + setLoadTime(null) + }, [updateCacheStats]) + + return ( +
    + {/* Counter controls */} +
    + +
    + {counter} +
    + + +
    + + {/* Cache stats */} +
    +
    + Cached entries:{' '} + {cacheStats.count} +
    +
    + Cache size:{' '} + + {(cacheStats.size / 1024).toFixed(2)} KB + +
    +
    + + {/* Source indicator */} + {loading ? ( +
    +
    + Loading... +
    + ) : ( + source && ( +
    +
    + + {source === 'cache' + ? 'Loaded from Dexie cache' + : 'Fetched from server'} + + {loadTime !== null && ( + + ({loadTime.toFixed(1)}ms) + + )} +
    + ) + )} + + {/* Result */} + {result && ( +
    +
    + RSC for Counter #{counter}: +
    + {result} +
    + )} + + {/* How it works */} +
    + How it works: When you change the counter, the app + automatically checks Dexie (IndexedDB) for a cached Flight payload. If + found, it decodes the cached string directly. If not found, it fetches + from the server, stores the payload in Dexie, then decodes it. Each + counter value gets its own cache entry with unique server-generated + data. +
    +
    + ) +} diff --git a/examples/react/start-rscs/src/low-level/components/dexie-cache/server-functions.tsx b/examples/react/start-rscs/src/low-level/components/dexie-cache/server-functions.tsx new file mode 100644 index 0000000000..05169928a6 --- /dev/null +++ b/examples/react/start-rscs/src/low-level/components/dexie-cache/server-functions.tsx @@ -0,0 +1,76 @@ +import { createServerFn } from '@tanstack/react-start' +import { renderToReadableStream } from '@tanstack/react-start/rsc' + +// Colors for the counter-based RSC +const counterColors = [ + { bg: 'from-red-500 to-orange-500', text: 'text-red-100', name: 'Warm' }, + { bg: 'from-blue-500 to-cyan-500', text: 'text-blue-100', name: 'Cool' }, + { + bg: 'from-green-500 to-emerald-500', + text: 'text-green-100', + name: 'Nature', + }, + { bg: 'from-purple-500 to-pink-500', text: 'text-purple-100', name: 'Royal' }, + { + bg: 'from-amber-500 to-yellow-500', + text: 'text-amber-100', + name: 'Golden', + }, +] + +// Server component for counter-based RSC +function CounterCard({ count }: { count: number }) { + const colorIndex = count % counterColors.length + const color = counterColors[colorIndex] + const timestamp = new Date().toISOString() + const randomValue = Math.floor(Math.random() * 10000) + + console.log(`[Server] Rendering CounterCard for count: ${count}`) + + return ( +
    +
    +
    +

    Counter #{count}

    +

    Theme: {color.name}

    +
    +
    +
    {randomValue}
    +
    Random Value
    +
    +
    +
    + Generated: {timestamp} +
    +
    + ) +} + +// Server function that returns Flight payload as a string for caching +export const getCounterRscPayload = createServerFn() + .inputValidator((data: { count: number }) => data) + .handler(async ({ data }) => { + console.log(`[Server] Creating Flight payload for count: ${data.count}`) + + const stream = await renderToReadableStream( + , + ) + + // Convert stream to string for caching + const reader = stream.getReader() + const chunks: Array = [] + const decoder = new TextDecoder() + + while (true) { + const { done, value } = await reader.read() + if (done) break + chunks.push(decoder.decode(value, { stream: true })) + } + + const payload = chunks.join('') + console.log(`[Server] Flight payload size: ${payload.length} bytes`) + + return { payload, count: data.count } + }) diff --git a/examples/react/start-rscs/src/low-level/components/direct-flight/DirectFlightStreamDemo.tsx b/examples/react/start-rscs/src/low-level/components/direct-flight/DirectFlightStreamDemo.tsx new file mode 100644 index 0000000000..781ddb0bfe --- /dev/null +++ b/examples/react/start-rscs/src/low-level/components/direct-flight/DirectFlightStreamDemo.tsx @@ -0,0 +1,56 @@ +import { useCallback, useState } from 'react' +import { createFromReadableStream } from '@tanstack/react-start/rsc' + +import { getFlightStreamDirect } from './server-functions' + +export function DirectFlightStreamDemo() { + const [result, setResult] = useState(null) + const [loading, setLoading] = useState(false) + const [streamInfo, setStreamInfo] = useState('') + + const loadStream = useCallback(async () => { + setLoading(true) + setStreamInfo('Fetching Flight stream from server function...') + + try { + const stream = await getFlightStreamDirect() + setStreamInfo('Decoding Flight stream with createFromReadableStream...') + + // Use createFromReadableStream to decode the Flight stream + const element = await createFromReadableStream(stream) + setResult(element as React.ReactNode) + setStreamInfo('Stream decoded successfully!') + } catch (error) { + setStreamInfo(`Error: ${error}`) + } finally { + setLoading(false) + } + }, []) + + return ( +
    + + + {streamInfo && ( +
    + {streamInfo} +
    + )} + + {result && ( +
    +
    + Server-Rendered Content: +
    + {result} +
    + )} +
    + ) +} diff --git a/examples/react/start-rscs/src/low-level/components/direct-flight/server-functions.tsx b/examples/react/start-rscs/src/low-level/components/direct-flight/server-functions.tsx new file mode 100644 index 0000000000..c7ba42ffb6 --- /dev/null +++ b/examples/react/start-rscs/src/low-level/components/direct-flight/server-functions.tsx @@ -0,0 +1,34 @@ +import { createServerFn } from '@tanstack/react-start' +import { renderToReadableStream } from '@tanstack/react-start/rsc' + +// Server Component that will be rendered to a Flight stream +function ServerGreeting({ + name, + timestamp, +}: { + name: string + timestamp: string +}) { + console.log('[Server] Rendering ServerGreeting:', name) + return ( +
    +

    Hello, {name}!

    +

    + Rendered on the server at: {timestamp} +

    +
    + ) +} + +// Server function using low-level renderToReadableStream +export const getFlightStreamDirect = createServerFn({ method: 'GET' }).handler( + async () => { + const stream = await renderToReadableStream( + , + ) + return stream + }, +) diff --git a/examples/react/start-rscs/src/low-level/components/fetch-flight/FetchFlightStreamDemo.tsx b/examples/react/start-rscs/src/low-level/components/fetch-flight/FetchFlightStreamDemo.tsx new file mode 100644 index 0000000000..d49d8988db --- /dev/null +++ b/examples/react/start-rscs/src/low-level/components/fetch-flight/FetchFlightStreamDemo.tsx @@ -0,0 +1,41 @@ +import { useCallback, useState } from 'react' +import { createFromFetch } from '@tanstack/react-start/rsc' + +export function FetchFlightStreamDemo() { + const [result, setResult] = useState(null) + const [loading, setLoading] = useState(false) + + const loadFromApi = useCallback(async () => { + setLoading(true) + try { + // Use createFromFetch to decode a Flight stream from a fetch response + const element = await createFromFetch(fetch('/api/rsc')) + setResult(element as React.ReactNode) + } catch (error) { + console.error('Error fetching RSC:', error) + } finally { + setLoading(false) + } + }, []) + + return ( +
    + + + {result && ( +
    +
    + API Route Response: +
    + {result} +
    + )} +
    + ) +} diff --git a/examples/react/start-rscs/src/low-level/components/nested-suspense/NestedSuspenseDemo.tsx b/examples/react/start-rscs/src/low-level/components/nested-suspense/NestedSuspenseDemo.tsx new file mode 100644 index 0000000000..4bc5ab339d --- /dev/null +++ b/examples/react/start-rscs/src/low-level/components/nested-suspense/NestedSuspenseDemo.tsx @@ -0,0 +1,45 @@ +import { Suspense, useCallback, useState } from 'react' +import { createFromReadableStream } from '@tanstack/react-start/rsc' + +import { getNestedServerComponent } from './server-functions' + +export function NestedSuspenseDemo() { + const [result, setResult] = useState(null) + const [loading, setLoading] = useState(false) + + const loadNested = useCallback(async () => { + setLoading(true) + try { + const stream = await getNestedServerComponent() + const element = await createFromReadableStream(stream) + setResult(element as React.ReactNode) + } catch (error) { + console.error('Error:', error) + } finally { + setLoading(false) + } + }, []) + + return ( +
    + + + {result && ( +
    +
    + Nested Server Components with Suspense: +
    + Loading...
    }> + {result} + +
    + )} +
    + ) +} diff --git a/examples/react/start-rscs/src/low-level/components/nested-suspense/server-functions.tsx b/examples/react/start-rscs/src/low-level/components/nested-suspense/server-functions.tsx new file mode 100644 index 0000000000..9b40b68c25 --- /dev/null +++ b/examples/react/start-rscs/src/low-level/components/nested-suspense/server-functions.tsx @@ -0,0 +1,59 @@ +import { Suspense } from 'react' +import { createServerFn } from '@tanstack/react-start' +import { renderToReadableStream } from '@tanstack/react-start/rsc' + +// Server Component with async data +async function ServerDataCard({ delay }: { delay: number }) { + console.log('[Server] Starting ServerDataCard with delay:', delay) + await new Promise((resolve) => setTimeout(resolve, delay)) + const data = { + value: Math.floor(Math.random() * 1000), + computedAt: new Date().toISOString(), + } + console.log('[Server] Finished ServerDataCard:', data) + + return ( +
    +
    {data.value}
    +
    + Computed at: {data.computedAt} +
    +
    Delay: {delay}ms
    +
    + ) +} + +function LoadingSkeleton({ label }: { label: string }) { + return ( +
    +
    +
    +
    {label}
    +
    + ) +} + +// Server function returning a nested server component structure +export const getNestedServerComponent = createServerFn({ + method: 'GET', +}).handler(async () => { + const stream = await renderToReadableStream( +
    +
    +

    Nested Server Component

    +

    + This entire tree is rendered on the server +

    +
    +
    + }> + + + }> + + +
    +
    , + ) + return stream +}) diff --git a/examples/react/start-rscs/src/low-level/components/parallel-streams/ParallelStreamsDemo.tsx b/examples/react/start-rscs/src/low-level/components/parallel-streams/ParallelStreamsDemo.tsx new file mode 100644 index 0000000000..14500905c1 --- /dev/null +++ b/examples/react/start-rscs/src/low-level/components/parallel-streams/ParallelStreamsDemo.tsx @@ -0,0 +1,98 @@ +import { useCallback, useState } from 'react' +import { createFromReadableStream } from '@tanstack/react-start/rsc' + +import { getParallelStreams } from './server-functions' + +export function ParallelStreamsDemo() { + const [streams, setStreams] = useState<{ + card1: React.ReactNode | null + card2: React.ReactNode | null + card3: React.ReactNode | null + }>({ card1: null, card2: null, card3: null }) + const [loading, setLoading] = useState(false) + const [timing, setTiming] = useState>([]) + + const loadParallel = useCallback(async () => { + setLoading(true) + setStreams({ card1: null, card2: null, card3: null }) + setTiming([]) + + const startTime = Date.now() + const addTiming = (label: string) => { + const elapsed = Date.now() - startTime + setTiming((prev) => [...prev, `${label}: ${elapsed}ms`]) + } + + try { + const { stream1, stream2, stream3 } = await getParallelStreams() + addTiming('Streams received') + + // Decode streams in parallel + const [el1, el2, el3] = await Promise.all([ + createFromReadableStream(stream1).then((el) => { + addTiming('Card 1 decoded') + return el + }), + createFromReadableStream(stream2).then((el) => { + addTiming('Card 2 decoded') + return el + }), + createFromReadableStream(stream3).then((el) => { + addTiming('Card 3 decoded') + return el + }), + ]) + + setStreams({ + card1: el1 as React.ReactNode, + card2: el2 as React.ReactNode, + card3: el3 as React.ReactNode, + }) + } catch (error) { + console.error('Error:', error) + } finally { + setLoading(false) + } + }, []) + + return ( +
    + + + {timing.length > 0 && ( +
    + {timing.map((t, i) => ( +
    + {t} +
    + ))} +
    + )} + +
    + {[streams.card1, streams.card2, streams.card3].map((card, i) => ( +
    +
    + Card {i + 1} +
    + {card || ( +
    +
    +
    +
    + )} +
    + ))} +
    +
    + ) +} diff --git a/examples/react/start-rscs/src/low-level/components/parallel-streams/server-functions.tsx b/examples/react/start-rscs/src/low-level/components/parallel-streams/server-functions.tsx new file mode 100644 index 0000000000..3e5e9628b6 --- /dev/null +++ b/examples/react/start-rscs/src/low-level/components/parallel-streams/server-functions.tsx @@ -0,0 +1,37 @@ +import { createServerFn } from '@tanstack/react-start' +import { renderToReadableStream } from '@tanstack/react-start/rsc' + +// Server Component with async data (used for parallel and nested demos) +async function ServerDataCard({ delay }: { delay: number }) { + console.log('[Server] Starting ServerDataCard with delay:', delay) + await new Promise((resolve) => setTimeout(resolve, delay)) + const data = { + value: Math.floor(Math.random() * 1000), + computedAt: new Date().toISOString(), + } + console.log('[Server] Finished ServerDataCard:', data) + + return ( +
    +
    {data.value}
    +
    + Computed at: {data.computedAt} +
    +
    Delay: {delay}ms
    +
    + ) +} + +// Server function that returns multiple streams for parallel loading +export const getParallelStreams = createServerFn({ method: 'GET' }).handler( + async () => { + // Create three independent streams with different delays + const [stream1, stream2, stream3] = await Promise.all([ + renderToReadableStream(), + renderToReadableStream(), + renderToReadableStream(), + ]) + + return { stream1, stream2, stream3 } + }, +) diff --git a/examples/react/start-rscs/src/low-level/components/streaming-ticker/StreamingTicker.tsx b/examples/react/start-rscs/src/low-level/components/streaming-ticker/StreamingTicker.tsx new file mode 100644 index 0000000000..109187ee87 --- /dev/null +++ b/examples/react/start-rscs/src/low-level/components/streaming-ticker/StreamingTicker.tsx @@ -0,0 +1,152 @@ +import { useCallback, useEffect, useRef, useState } from 'react' +import { createFromReadableStream } from '@tanstack/react-start/rsc' + +import { streamTickerRscs } from './server-functions' + +interface TickerEntry { + id: number + element: React.ReactNode + receivedAt: number +} + +// Helper to convert string payload back to ReadableStream +function payloadToStream(payload: string): ReadableStream { + const encoder = new TextEncoder() + return new ReadableStream({ + start(controller) { + controller.enqueue(encoder.encode(payload)) + controller.close() + }, + }) +} + +// Format relative time +function formatRelativeTime(receivedAt: number): string { + const seconds = Math.floor((Date.now() - receivedAt) / 1000) + if (seconds < 1) return 'just now' + if (seconds === 1) return '1 second ago' + return `${seconds} seconds ago` +} + +export function StreamingTicker() { + const [items, setItems] = useState>([]) + const [isStreaming, setIsStreaming] = useState(false) + const [, setTick] = useState(0) // Force re-render for relative time updates + const abortRef = useRef(false) + + // Update relative times every second + useEffect(() => { + const interval = setInterval(() => { + setTick((t) => t + 1) + }, 1000) + return () => clearInterval(interval) + }, []) + + const startStream = useCallback(async () => { + setIsStreaming(true) + abortRef.current = false + setItems([]) + + try { + for await (const { id, payload } of await streamTickerRscs()) { + if (abortRef.current) break + + // Decode the RSC payload + const stream = payloadToStream(payload) + const element = await createFromReadableStream(stream) + + const entry: TickerEntry = { + id, + element: element as React.ReactNode, + receivedAt: Date.now(), + } + + // Add to items, keeping only last 10 + setItems((prev) => [entry, ...prev].slice(0, 10)) + } + } catch (error) { + console.error('Streaming error:', error) + } finally { + setIsStreaming(false) + } + }, []) + + const stopStream = useCallback(() => { + abortRef.current = true + setIsStreaming(false) + }, []) + + const clearItems = useCallback(() => { + abortRef.current = true + setIsStreaming(false) + setItems([]) + }, []) + + return ( +
    +
    + {!isStreaming ? ( + + ) : ( + + )} + +
    + + {isStreaming && ( +
    +
    + Streaming RSCs... +
    + )} + +
    + {items.length === 0 ? ( +
    + Click "Start Stream" to begin receiving RSC payloads +
    + ) : ( + items.map((item) => ( +
    + {/* The RSC element */} + {item.element} + {/* Client-side relative time */} +
    + received {formatRelativeTime(item.receivedAt)} +
    +
    + )) + )} +
    + + {items.length > 0 && ( +
    + Showing {items.length} of last 10 items (newest first) +
    + )} + +
    + How it works: Each ticker item is a React Server + Component rendered on the server with{' '} + renderToReadableStream, streamed as a Flight payload, and + decoded on the client with createFromReadableStream. The + "received X seconds ago" text updates live on the client. +
    +
    + ) +} diff --git a/examples/react/start-rscs/src/low-level/components/streaming-ticker/server-functions.tsx b/examples/react/start-rscs/src/low-level/components/streaming-ticker/server-functions.tsx new file mode 100644 index 0000000000..2525b06f26 --- /dev/null +++ b/examples/react/start-rscs/src/low-level/components/streaming-ticker/server-functions.tsx @@ -0,0 +1,91 @@ +import { createServerFn } from '@tanstack/react-start' +import { renderToReadableStream } from '@tanstack/react-start/rsc' + +function sleep(ms: number) { + return new Promise((resolve) => setTimeout(resolve, ms)) +} + +// Helper to convert stream to string +async function streamToString( + stream: ReadableStream, +): Promise { + const reader = stream.getReader() + const chunks: Array = [] + const decoder = new TextDecoder() + + while (true) { + const { done, value } = await reader.read() + if (done) break + chunks.push(decoder.decode(value, { stream: true })) + } + + return chunks.join('') +} + +// Server component for each ticker item +function TickerItemCard({ + id, + timestamp, + variant, +}: { + id: number + timestamp: string + variant: 'info' | 'success' | 'warning' +}) { + const tickerColors = { + info: 'from-blue-500 to-cyan-500', + success: 'from-green-500 to-emerald-500', + warning: 'from-amber-500 to-orange-500', + } + + const formattedTime = new Date(timestamp).toLocaleTimeString() + + return ( +
    +
    +
    Server Update #{id + 1}
    +
    + {variant} +
    +
    +
    + Generated: {formattedTime} +
    +
    + ) +} + +// Server function that streams RSC Flight payloads +export const streamTickerRscs = createServerFn().handler(async function* () { + const variants = ['info', 'success', 'warning'] as const + + for (let i = 0; i < 15; i++) { + await sleep(800) + + console.log(`[Server] Rendering ticker item #${i + 1}`) + + // Render the server component to a Flight stream + const stream = await renderToReadableStream( + , + ) + + // Convert stream to string for yielding + const payload = await streamToString(stream) + + yield { id: i, payload } + } +}) diff --git a/examples/react/start-rscs/src/low-level/db.ts b/examples/react/start-rscs/src/low-level/db.ts new file mode 100644 index 0000000000..1c50f67f82 --- /dev/null +++ b/examples/react/start-rscs/src/low-level/db.ts @@ -0,0 +1,18 @@ +import Dexie from 'dexie' + +import type { EntityTable } from 'dexie' + +// Dexie database for RSC payload caching +export interface RscCacheEntry { + id: string + payload: string + createdAt: number +} + +export const db = new Dexie('RscCache') as Dexie & { + cache: EntityTable +} + +db.version(1).stores({ + cache: 'id, createdAt', +}) diff --git a/examples/react/start-rscs/src/low-level/index.ts b/examples/react/start-rscs/src/low-level/index.ts new file mode 100644 index 0000000000..1f575e2c0b --- /dev/null +++ b/examples/react/start-rscs/src/low-level/index.ts @@ -0,0 +1,29 @@ +// Shared components +export { DemoSection } from './components/DemoSection' + +// Demo 1: Direct Flight Stream +export { DirectFlightStreamDemo } from './components/direct-flight/DirectFlightStreamDemo' +export { getFlightStreamDirect } from './components/direct-flight/server-functions' + +// Demo 2: Fetch Flight Stream (uses /api/rsc route) +export { FetchFlightStreamDemo } from './components/fetch-flight/FetchFlightStreamDemo' + +// Demo 3: Parallel Streams +export { ParallelStreamsDemo } from './components/parallel-streams/ParallelStreamsDemo' +export { getParallelStreams } from './components/parallel-streams/server-functions' + +// Demo 4: Nested Suspense +export { NestedSuspenseDemo } from './components/nested-suspense/NestedSuspenseDemo' +export { getNestedServerComponent } from './components/nested-suspense/server-functions' + +// Demo 5: Dexie Cache +export { DexieCacheDemo } from './components/dexie-cache/DexieCacheDemo' +export { getCounterRscPayload } from './components/dexie-cache/server-functions' + +// Demo 6: Streaming Ticker +export { StreamingTicker } from './components/streaming-ticker/StreamingTicker' +export { streamTickerRscs } from './components/streaming-ticker/server-functions' + +// Dexie database +export { db } from './db' +export type { RscCacheEntry } from './db' diff --git a/examples/react/start-rscs/src/pokemon/Button.tsx b/examples/react/start-rscs/src/pokemon/Button.tsx new file mode 100644 index 0000000000..e458cac948 --- /dev/null +++ b/examples/react/start-rscs/src/pokemon/Button.tsx @@ -0,0 +1,19 @@ +'use client' + +export function Button({ + className, + title, +}: { + className?: string + title?: string +}) { + return ( + + ) +} diff --git a/examples/react/start-rscs/src/pokemon/server-functions.tsx b/examples/react/start-rscs/src/pokemon/server-functions.tsx new file mode 100644 index 0000000000..37aa33a7c2 --- /dev/null +++ b/examples/react/start-rscs/src/pokemon/server-functions.tsx @@ -0,0 +1,139 @@ +import { createServerFn } from '@tanstack/react-start' +import { renderServerComponent } from '@tanstack/react-start/rsc' +import { Button } from './Button' + +// ============================================ +// Pokemon RSC - Async Server Component Example +// ============================================ + +// Types for PokeAPI +export interface PokemonListItem { + name: string + url: string +} + +export interface PokemonDetails { + id: number + name: string + sprites: { front_default: string } + types: Array<{ type: { name: string } }> +} + +// Type color mapping for Pokemon type badges +export const typeColors: Record = { + normal: 'bg-gray-400', + fire: 'bg-red-500', + water: 'bg-blue-500', + electric: 'bg-yellow-400', + grass: 'bg-green-500', + ice: 'bg-cyan-300', + fighting: 'bg-orange-700', + poison: 'bg-purple-500', + ground: 'bg-amber-600', + flying: 'bg-indigo-300', + psychic: 'bg-pink-500', + bug: 'bg-lime-500', + rock: 'bg-stone-500', + ghost: 'bg-purple-700', + dragon: 'bg-indigo-600', + dark: 'bg-gray-700', + steel: 'bg-gray-400', + fairy: 'bg-pink-300', +} + +// Server component for individual Pokemon card +function PokemonCard({ pokemon }: { pokemon: PokemonDetails }) { + return ( +
    + {pokemon.name} +

    {pokemon.name}

    +

    #{pokemon.id}

    +
    + {pokemon.types.map((t) => ( +
    +
    + ) +} + +// Async Server Component - fetches its own data (like Next.js RSC) +async function PokemonList() { + console.log('[Server] Fetching Pokemon data...') + + // Data fetching happens INSIDE the component + const response = await fetch('https://pokeapi.co/api/v2/pokemon?limit=20') + const data = await response.json() + + // Fetch details for each Pokemon to get sprites and types + const pokemonDetails = await Promise.all( + data.results.map(async (pokemon: PokemonListItem) => { + const res = await fetch(pokemon.url) + return res.json() as Promise + }), + ) + + console.log(`[Server] Fetched ${pokemonDetails.length} Pokemon`) + + return ( +
    +

    + Pokemon (Server Component) +

    +

    + This list was fetched and rendered entirely on the server using an async + React component. +

    +
    + {pokemonDetails.map((pokemon) => ( + + ))} +
    +
    + ) +} + +// Server function that renders the async component +export const getPokemonList = createServerFn().handler(async () => { + const Renderable = await renderServerComponent() + return { Renderable } +}) + +// Server function that fetches Pokemon data (traditional SSR - no RSC) +export const fetchPokemonData = createServerFn().handler(async () => { + console.log('[Server] Fetching Pokemon data (traditional loader)...') + + const response = await fetch('https://pokeapi.co/api/v2/pokemon?limit=20') + const data = await response.json() + + const pokemonDetails = await Promise.all( + data.results.map(async (pokemon: PokemonListItem) => { + const res = await fetch(pokemon.url) + const { name, id, sprites, types } = await res.json() + return { + name, + id, + sprites: { + front_default: sprites.front_default, + }, + types: types.map( + (t: { type: { name: string } }): { type: { name: string } } => ({ + type: { name: t.type.name }, + }), + ), + } as unknown as Promise + }), + ) + + console.log(`[Server] Fetched ${pokemonDetails.length} Pokemon (traditional)`) + + return { pokemon: pokemonDetails } +}) diff --git a/examples/react/start-rscs/src/routeTree.gen.ts b/examples/react/start-rscs/src/routeTree.gen.ts new file mode 100644 index 0000000000..ca4cef3864 --- /dev/null +++ b/examples/react/start-rscs/src/routeTree.gen.ts @@ -0,0 +1,177 @@ +/* eslint-disable */ + +// @ts-nocheck + +// noinspection JSUnusedGlobalSymbols + +// This file was automatically generated by TanStack Router. +// You should NOT make any changes in this file as it will be overwritten. +// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. + +import { Route as rootRouteImport } from './routes/__root' +import { Route as PokemonRscRouteImport } from './routes/pokemon-rsc' +import { Route as PokemonRouteImport } from './routes/pokemon' +import { Route as LowLevelApiRouteImport } from './routes/low-level-api' +import { Route as ECommerceRouteImport } from './routes/e-commerce' +import { Route as IndexRouteImport } from './routes/index' +import { Route as ApiRscRouteImport } from './routes/api/rsc' + +const PokemonRscRoute = PokemonRscRouteImport.update({ + id: '/pokemon-rsc', + path: '/pokemon-rsc', + getParentRoute: () => rootRouteImport, +} as any) +const PokemonRoute = PokemonRouteImport.update({ + id: '/pokemon', + path: '/pokemon', + getParentRoute: () => rootRouteImport, +} as any) +const LowLevelApiRoute = LowLevelApiRouteImport.update({ + id: '/low-level-api', + path: '/low-level-api', + getParentRoute: () => rootRouteImport, +} as any) +const ECommerceRoute = ECommerceRouteImport.update({ + id: '/e-commerce', + path: '/e-commerce', + getParentRoute: () => rootRouteImport, +} as any) +const IndexRoute = IndexRouteImport.update({ + id: '/', + path: '/', + getParentRoute: () => rootRouteImport, +} as any) +const ApiRscRoute = ApiRscRouteImport.update({ + id: '/api/rsc', + path: '/api/rsc', + getParentRoute: () => rootRouteImport, +} as any) + +export interface FileRoutesByFullPath { + '/': typeof IndexRoute + '/e-commerce': typeof ECommerceRoute + '/low-level-api': typeof LowLevelApiRoute + '/pokemon': typeof PokemonRoute + '/pokemon-rsc': typeof PokemonRscRoute + '/api/rsc': typeof ApiRscRoute +} +export interface FileRoutesByTo { + '/': typeof IndexRoute + '/e-commerce': typeof ECommerceRoute + '/low-level-api': typeof LowLevelApiRoute + '/pokemon': typeof PokemonRoute + '/pokemon-rsc': typeof PokemonRscRoute + '/api/rsc': typeof ApiRscRoute +} +export interface FileRoutesById { + __root__: typeof rootRouteImport + '/': typeof IndexRoute + '/e-commerce': typeof ECommerceRoute + '/low-level-api': typeof LowLevelApiRoute + '/pokemon': typeof PokemonRoute + '/pokemon-rsc': typeof PokemonRscRoute + '/api/rsc': typeof ApiRscRoute +} +export interface FileRouteTypes { + fileRoutesByFullPath: FileRoutesByFullPath + fullPaths: + | '/' + | '/e-commerce' + | '/low-level-api' + | '/pokemon' + | '/pokemon-rsc' + | '/api/rsc' + fileRoutesByTo: FileRoutesByTo + to: + | '/' + | '/e-commerce' + | '/low-level-api' + | '/pokemon' + | '/pokemon-rsc' + | '/api/rsc' + id: + | '__root__' + | '/' + | '/e-commerce' + | '/low-level-api' + | '/pokemon' + | '/pokemon-rsc' + | '/api/rsc' + fileRoutesById: FileRoutesById +} +export interface RootRouteChildren { + IndexRoute: typeof IndexRoute + ECommerceRoute: typeof ECommerceRoute + LowLevelApiRoute: typeof LowLevelApiRoute + PokemonRoute: typeof PokemonRoute + PokemonRscRoute: typeof PokemonRscRoute + ApiRscRoute: typeof ApiRscRoute +} + +declare module '@tanstack/react-router' { + interface FileRoutesByPath { + '/pokemon-rsc': { + id: '/pokemon-rsc' + path: '/pokemon-rsc' + fullPath: '/pokemon-rsc' + preLoaderRoute: typeof PokemonRscRouteImport + parentRoute: typeof rootRouteImport + } + '/pokemon': { + id: '/pokemon' + path: '/pokemon' + fullPath: '/pokemon' + preLoaderRoute: typeof PokemonRouteImport + parentRoute: typeof rootRouteImport + } + '/low-level-api': { + id: '/low-level-api' + path: '/low-level-api' + fullPath: '/low-level-api' + preLoaderRoute: typeof LowLevelApiRouteImport + parentRoute: typeof rootRouteImport + } + '/e-commerce': { + id: '/e-commerce' + path: '/e-commerce' + fullPath: '/e-commerce' + preLoaderRoute: typeof ECommerceRouteImport + parentRoute: typeof rootRouteImport + } + '/': { + id: '/' + path: '/' + fullPath: '/' + preLoaderRoute: typeof IndexRouteImport + parentRoute: typeof rootRouteImport + } + '/api/rsc': { + id: '/api/rsc' + path: '/api/rsc' + fullPath: '/api/rsc' + preLoaderRoute: typeof ApiRscRouteImport + parentRoute: typeof rootRouteImport + } + } +} + +const rootRouteChildren: RootRouteChildren = { + IndexRoute: IndexRoute, + ECommerceRoute: ECommerceRoute, + LowLevelApiRoute: LowLevelApiRoute, + PokemonRoute: PokemonRoute, + PokemonRscRoute: PokemonRscRoute, + ApiRscRoute: ApiRscRoute, +} +export const routeTree = rootRouteImport + ._addFileChildren(rootRouteChildren) + ._addFileTypes() + +import type { getRouter } from './router.tsx' +import type { createStart } from '@tanstack/react-start' +declare module '@tanstack/react-start' { + interface Register { + ssr: true + router: Awaited> + } +} diff --git a/examples/react/start-rscs/src/router.tsx b/examples/react/start-rscs/src/router.tsx new file mode 100644 index 0000000000..335a55600f --- /dev/null +++ b/examples/react/start-rscs/src/router.tsx @@ -0,0 +1,11 @@ +import { createRouter } from '@tanstack/react-router' +import { routeTree } from './routeTree.gen' + +export function getRouter() { + const router = createRouter({ + routeTree, + defaultPreload: 'intent', + scrollRestoration: true, + }) + return router +} diff --git a/examples/react/start-rscs/src/routes/__root.tsx b/examples/react/start-rscs/src/routes/__root.tsx new file mode 100644 index 0000000000..80891bd2ee --- /dev/null +++ b/examples/react/start-rscs/src/routes/__root.tsx @@ -0,0 +1,44 @@ +/// +import { HeadContent, Scripts, createRootRoute } from '@tanstack/react-router' +import { TanStackRouterDevtools } from '@tanstack/react-router-devtools' +import * as React from 'react' +import appCss from '~/styles/app.css?url' +import { Layout } from '~/components/Layout' + +export const Route = createRootRoute({ + head: () => ({ + meta: [ + { + charSet: 'utf-8', + }, + { + name: 'viewport', + content: 'width=device-width, initial-scale=1', + }, + { + title: 'TanStack Start RSC Examples', + }, + ], + links: [ + { rel: 'stylesheet', href: appCss }, + { rel: 'icon', href: '/favicon.ico' }, + ], + }), + shellComponent: RootDocument, + component: Layout, +}) + +function RootDocument({ children }: { children: React.ReactNode }) { + return ( + + + + + + {children} + + + + + ) +} diff --git a/examples/react/start-rscs/src/routes/api/rsc.tsx b/examples/react/start-rscs/src/routes/api/rsc.tsx new file mode 100644 index 0000000000..e2c9aeccd4 --- /dev/null +++ b/examples/react/start-rscs/src/routes/api/rsc.tsx @@ -0,0 +1,43 @@ +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { renderToReadableStream } from '@tanstack/react-start/rsc' + +// Server component to render +function ApiServerComponent() { + const timestamp = new Date().toISOString() + + return ( +
    +

    API Route RSC

    +

    + This component was streamed from /api/rsc +

    +

    + Timestamp: {timestamp} +

    +
    + ) +} + +// Server function to render the RSC +const getFlightStream = createServerFn({ method: 'GET' }).handler(async () => { + console.log('[API] Rendering Flight stream for /api/rsc') + return renderToReadableStream() +}) + +export const Route = createFileRoute('/api/rsc')({ + server: { + handlers: { + GET: async () => { + const stream = await getFlightStream() + + return new Response(stream, { + headers: { + 'Content-Type': 'text/x-component', + 'Cache-Control': 'no-store', + }, + }) + }, + }, + }, +}) diff --git a/examples/react/start-rscs/src/routes/e-commerce.tsx b/examples/react/start-rscs/src/routes/e-commerce.tsx new file mode 100644 index 0000000000..eb215d256c --- /dev/null +++ b/examples/react/start-rscs/src/routes/e-commerce.tsx @@ -0,0 +1,48 @@ +import { createFileRoute } from '@tanstack/react-router' +import { CompositeComponent } from '@tanstack/react-start/rsc' +import { getProductPage } from '~/e-Commerce/server-functions' +import { AddToCartButton } from '~/e-Commerce/components/AddToCartButton' +import { AlsoBoughtCarousel } from '~/e-Commerce/components/AlsoBoughtCarousel' +import { Header } from '~/e-Commerce/components/Header' +import { StreamingComments } from '~/e-Commerce/components/StreamingComments' + +export const Route = createFileRoute('/e-commerce')({ + loader: async () => { + const ProductPage = await getProductPage() + return { ProductPage } + }, + component: ECommercePage, +}) + +function ECommercePage() { + const { ProductPage } = Route.useLoaderData() + + return ( +
    +
    + {/* Page Header with Cart */} +
    + + {/* Main Product Section */} + ( + + )} + > + + + + {/* Customer Reviews Section */} +
    +

    + Customer Reviews +

    +
    + +
    +
    +
    +
    + ) +} diff --git a/examples/react/start-rscs/src/routes/index.tsx b/examples/react/start-rscs/src/routes/index.tsx new file mode 100644 index 0000000000..244bb4ca1d --- /dev/null +++ b/examples/react/start-rscs/src/routes/index.tsx @@ -0,0 +1,71 @@ +import { Link, createFileRoute } from '@tanstack/react-router' +import { CompositeComponent } from '@tanstack/react-start/rsc' +import type { DemoInfo } from '~/home/server-functions' +import { getHomePage } from '~/home/server-functions' + +export const Route = createFileRoute('/')({ + loader: async () => { + const HomePage = await getHomePage() + return { HomePage } + }, + component: Home, +}) + +function DemoCard({ demo }: { demo: DemoInfo }) { + return ( + +
    +
    +
    +

    + {demo.title} +

    +

    {demo.description}

    +
    + {demo.features.map((feature) => ( + + {feature} + + ))} +
    +
    + View Demo + + + +
    +
    +
    + + ) +} + +function Home() { + const { HomePage } = Route.useLoaderData() + + return ( +
    +
    +
    + } + /> +
    +
    +
    + ) +} diff --git a/examples/react/start-rscs/src/routes/low-level-api.tsx b/examples/react/start-rscs/src/routes/low-level-api.tsx new file mode 100644 index 0000000000..58ccf6d1ad --- /dev/null +++ b/examples/react/start-rscs/src/routes/low-level-api.tsx @@ -0,0 +1,82 @@ +import { createFileRoute } from '@tanstack/react-router' + +import { + DemoSection, + DexieCacheDemo, + DirectFlightStreamDemo, + FetchFlightStreamDemo, + NestedSuspenseDemo, + ParallelStreamsDemo, + StreamingTicker, +} from '~/low-level' + +export const Route = createFileRoute('/low-level-api')({ + component: LowLevelApiPage, +}) + +function LowLevelApiPage() { + return ( +
    +
    +
    +

    + Low-Level RSC Primitives +

    +

    + Demonstrating TanStack Start's low-level Flight stream APIs +

    +
    + +
    + {/* Demo 1: Direct Flight Stream */} + + + + + {/* Demo 2: Fetch-based Flight Stream */} + + + + + {/* Demo 3: Parallel Streams */} + + + + + {/* Demo 4: Nested with Suspense */} + + + + + {/* Demo 5: Dexie Cache */} + + + + + {/* Demo 6: HTTP Streaming Ticker */} + + + +
    +
    +
    + ) +} diff --git a/examples/react/start-rscs/src/routes/pokemon-rsc.tsx b/examples/react/start-rscs/src/routes/pokemon-rsc.tsx new file mode 100644 index 0000000000..a654c1f3a5 --- /dev/null +++ b/examples/react/start-rscs/src/routes/pokemon-rsc.tsx @@ -0,0 +1,52 @@ +import { Link, createFileRoute } from '@tanstack/react-router' +import { getPokemonList } from '~/pokemon/server-functions' + +export const Route = createFileRoute('/pokemon-rsc')({ + loader: async () => { + const { Renderable } = await getPokemonList() + return Renderable + }, + component: PokemonPage, +}) + +function PokemonPage() { + const PokemonList = Route.useLoaderData() + + return ( +
    +
    + {/* Comparison Link */} +
    +
    +

    + Compare: See how this RSC version differs from + the traditional SSR approach in structure and payload size. +

    +
    + + View Traditional Version + + + + +
    + + {/* Pokemon List - Server Component */} +
    {PokemonList}
    +
    +
    + ) +} diff --git a/examples/react/start-rscs/src/routes/pokemon.tsx b/examples/react/start-rscs/src/routes/pokemon.tsx new file mode 100644 index 0000000000..e4cffba044 --- /dev/null +++ b/examples/react/start-rscs/src/routes/pokemon.tsx @@ -0,0 +1,105 @@ +import { Link, createFileRoute } from '@tanstack/react-router' +import type { PokemonDetails } from '~/pokemon/server-functions' +import { fetchPokemonData, typeColors } from '~/pokemon/server-functions' + +export const Route = createFileRoute('/pokemon')({ + loader: async () => { + // Traditional loader pattern - fetches data, returns JSON + // This data is serialized to JSON and sent to the client + // The component then renders it on the client + const { pokemon } = await fetchPokemonData() + return { pokemon } + }, + component: PokemonPage, +}) + +function Button({ className, title }: { className?: string; title?: string }) { + return ( + + ) +} + +function PokemonCard({ pokemon }: { pokemon: PokemonDetails }) { + return ( +
    + {pokemon.name} +

    {pokemon.name}

    +

    #{pokemon.id}

    +
    + {pokemon.types.map((t) => ( +
    +
    + ) +} + +function PokemonPage() { + const { pokemon } = Route.useLoaderData() + + return ( +
    +
    +
    +

    + Pokemon (Traditional SSR) +

    +

    + This list was fetched in the loader and rendered as a normal React + component. The data is serialized to JSON and sent to the client, + where the component re-renders with that data. +

    + +
    +

    + Note: Unlike the RSC version, this page sends the + full Pokemon data as JSON in the initial HTML payload. The + component code also ships to the client and re-hydrates. Check the + Network tab to compare payload sizes! +

    +
    + + + + + + View RSC Version + + +
    + {pokemon.map((p) => ( + + ))} +
    +
    +
    +
    + ) +} diff --git a/examples/react/start-rscs/src/styles/app.css b/examples/react/start-rscs/src/styles/app.css new file mode 100644 index 0000000000..c36c737cd4 --- /dev/null +++ b/examples/react/start-rscs/src/styles/app.css @@ -0,0 +1,30 @@ +@import 'tailwindcss'; + +@layer base { + *, + ::after, + ::before, + ::backdrop, + ::file-selector-button { + border-color: var(--color-gray-200, currentcolor); + } +} + +@layer base { + html { + color-scheme: light dark; + } + + * { + @apply border-gray-200 dark:border-gray-800; + } + + html, + body { + @apply text-gray-900 bg-gray-50 dark:bg-gray-950 dark:text-gray-200; + } + + .using-mouse * { + outline: none !important; + } +} diff --git a/examples/react/start-rscs/tsconfig.json b/examples/react/start-rscs/tsconfig.json new file mode 100644 index 0000000000..8554925771 --- /dev/null +++ b/examples/react/start-rscs/tsconfig.json @@ -0,0 +1,22 @@ +{ + "include": ["**/*.ts", "**/*.tsx", "**/*.d.ts"], + "compilerOptions": { + "strict": true, + "esModuleInterop": true, + "jsx": "react-jsx", + "module": "ESNext", + "moduleResolution": "Bundler", + "lib": ["DOM", "DOM.Iterable", "ES2024"], + "isolatedModules": true, + "resolveJsonModule": true, + "skipLibCheck": true, + "target": "ES2024", + "allowJs": true, + "forceConsistentCasingInFileNames": true, + "baseUrl": ".", + "paths": { + "~/*": ["./src/*"] + }, + "noEmit": true + } +} diff --git a/examples/react/start-rscs/vite.config.ts b/examples/react/start-rscs/vite.config.ts new file mode 100644 index 0000000000..3fffc19f6d --- /dev/null +++ b/examples/react/start-rscs/vite.config.ts @@ -0,0 +1,24 @@ +import { tanstackStart } from '@tanstack/react-start/plugin/vite' +import { defineConfig } from 'vite' +import viteReact from '@vitejs/plugin-react' +import tailwindcss from '@tailwindcss/vite' +import { nitro } from 'nitro/vite' +import rsc from '@vitejs/plugin-rsc' + +export default defineConfig({ + resolve: { tsconfigPaths: true }, + server: { + port: 3000, + }, + plugins: [ + tailwindcss(), + tanstackStart({ + rsc: { + enabled: true, + }, + }), + rsc(), + viteReact(), + nitro(), + ], +}) diff --git a/examples/react/start-streaming-data-from-server-functions/package.json b/examples/react/start-streaming-data-from-server-functions/package.json index c83091c1b0..630d7ab977 100644 --- a/examples/react/start-streaming-data-from-server-functions/package.json +++ b/examples/react/start-streaming-data-from-server-functions/package.json @@ -10,12 +10,12 @@ "start": "pnpx srvx --prod -s ../client dist/server/server.js" }, "dependencies": { - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/react-start": "^1.167.16", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/react-start": "^1.168.18", "react": "^19.0.0", "react-dom": "^19.0.0", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@types/node": "^22.5.4", @@ -23,6 +23,6 @@ "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/start-supabase-basic/package.json b/examples/react/start-supabase-basic/package.json index 74bc42b9e3..d8939eee81 100644 --- a/examples/react/start-supabase-basic/package.json +++ b/examples/react/start-supabase-basic/package.json @@ -15,9 +15,9 @@ "dependencies": { "@supabase/ssr": "^0.5.2", "@supabase/supabase-js": "^2.48.1", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/react-start": "^1.167.16", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/react-start": "^1.168.18", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1" @@ -29,6 +29,6 @@ "@vitejs/plugin-react": "^6.0.1", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/start-tailwind-v4/package.json b/examples/react/start-tailwind-v4/package.json index adf8936efc..fc4af550a0 100644 --- a/examples/react/start-tailwind-v4/package.json +++ b/examples/react/start-tailwind-v4/package.json @@ -10,13 +10,13 @@ "start": "node .output/server/index.mjs" }, "dependencies": { - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/react-start": "^1.167.16", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/react-start": "^1.168.18", "react": "^19.0.0", "react-dom": "^19.0.0", - "tailwind-merge": "^2.6.0", - "zod": "^3.24.2" + "tailwind-merge": "^3.6.0", + "zod": "^4.4.3" }, "devDependencies": { "@tailwindcss/vite": "^4.2.2", @@ -26,6 +26,6 @@ "@vitejs/plugin-react": "^6.0.1", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/start-trellaux/package.json b/examples/react/start-trellaux/package.json index 59d729c59a..f254f1af35 100644 --- a/examples/react/start-trellaux/package.json +++ b/examples/react/start-trellaux/package.json @@ -12,18 +12,18 @@ "dependencies": { "@tanstack/react-query": "^5.90.0", "@tanstack/react-query-devtools": "^5.90.0", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/react-router-ssr-query": "^1.166.10", - "@tanstack/react-start": "^1.167.16", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/react-router-ssr-query": "^1.167.1", + "@tanstack/react-start": "^1.168.18", "ky": "^1.7.4", "msw": "^2.7.0", "react": "^19.0.0", "react-dom": "^19.0.0", "react-hot-toast": "^2.5.1", "redaxios": "^0.5.1", - "tailwind-merge": "^2.6.0", - "zod": "^3.24.2" + "tailwind-merge": "^3.6.0", + "zod": "^4.4.3" }, "devDependencies": { "@tailwindcss/vite": "^4.2.2", @@ -33,6 +33,6 @@ "@vitejs/plugin-react": "^6.0.1", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/start-trellaux/src/db/schema.ts b/examples/react/start-trellaux/src/db/schema.ts index 52c3587703..5fe4da32fa 100644 --- a/examples/react/start-trellaux/src/db/schema.ts +++ b/examples/react/start-trellaux/src/db/schema.ts @@ -4,20 +4,20 @@ export const itemSchema = z.object({ id: z.string(), title: z.string(), content: z.string().optional(), - order: z.coerce.number(), + order: z.coerce.number(), columnId: z.string().uuid(), - boardId: z.coerce.string(), + boardId: z.coerce.string(), }) export const columnSchema = z.object({ id: z.string().uuid(), - boardId: z.coerce.string(), + boardId: z.coerce.string(), name: z.string(), order: z.number(), }) export const boardSchema = z.object({ - id: z.coerce.string(), + id: z.coerce.string(), name: z.string(), color: z.string(), columns: z.array(columnSchema), diff --git a/examples/react/start-workos/package.json b/examples/react/start-workos/package.json index 39dabee60b..69c11f46ab 100644 --- a/examples/react/start-workos/package.json +++ b/examples/react/start-workos/package.json @@ -14,9 +14,9 @@ "license": "MIT", "dependencies": { "@radix-ui/themes": "^3.3.0", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/react-start": "^1.167.16", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/react-start": "^1.168.18", "@workos/authkit-tanstack-react-start": "^0.5.0", "react": "^19.0.0", "react-dom": "^19.0.0" @@ -26,6 +26,6 @@ "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/view-transitions/package.json b/examples/react/view-transitions/package.json index 8d869f2548..ac05a7ba3e 100644 --- a/examples/react/view-transitions/package.json +++ b/examples/react/view-transitions/package.json @@ -10,20 +10,20 @@ }, "dependencies": { "@tailwindcss/vite": "^4.2.2", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/router-plugin": "^1.168.13", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/view-transitions/src/routes/explore.tsx b/examples/react/view-transitions/src/routes/explore.tsx index 1bb60ed1fc..b70a6f3bd5 100644 --- a/examples/react/view-transitions/src/routes/explore.tsx +++ b/examples/react/view-transitions/src/routes/explore.tsx @@ -1,5 +1,4 @@ -import { createFileRoute } from '@tanstack/react-router' -import { Link } from '@tanstack/react-router' +import { Link, createFileRoute } from '@tanstack/react-router' export const Route = createFileRoute('/explore')({ component: RouteComponent, diff --git a/examples/react/view-transitions/src/routes/how-it-works.tsx b/examples/react/view-transitions/src/routes/how-it-works.tsx index 3ae9a88d52..ab4dd4c714 100644 --- a/examples/react/view-transitions/src/routes/how-it-works.tsx +++ b/examples/react/view-transitions/src/routes/how-it-works.tsx @@ -1,5 +1,4 @@ -import { createFileRoute } from '@tanstack/react-router' -import { Link } from '@tanstack/react-router' +import { Link, createFileRoute } from '@tanstack/react-router' export const Route = createFileRoute('/how-it-works')({ component: RouteComponent, diff --git a/examples/react/view-transitions/src/routes/index.tsx b/examples/react/view-transitions/src/routes/index.tsx index 19f597dc7b..132ba18dbb 100644 --- a/examples/react/view-transitions/src/routes/index.tsx +++ b/examples/react/view-transitions/src/routes/index.tsx @@ -1,6 +1,5 @@ -import { createFileRoute } from '@tanstack/react-router' import * as React from 'react' -import { Link } from '@tanstack/react-router' +import { Link, createFileRoute } from '@tanstack/react-router' export const Route = createFileRoute('/')({ component: Home, diff --git a/examples/react/view-transitions/src/routes/posts.$postId.tsx b/examples/react/view-transitions/src/routes/posts.$postId.tsx index 956ca50ecd..cded91ef96 100644 --- a/examples/react/view-transitions/src/routes/posts.$postId.tsx +++ b/examples/react/view-transitions/src/routes/posts.$postId.tsx @@ -1,6 +1,5 @@ -import { createFileRoute } from '@tanstack/react-router' import * as React from 'react' -import { ErrorComponent } from '@tanstack/react-router' +import { ErrorComponent, createFileRoute } from '@tanstack/react-router' import { fetchPost } from '../posts' import type { ErrorComponentProps } from '@tanstack/react-router' diff --git a/examples/react/view-transitions/src/routes/posts.index.tsx b/examples/react/view-transitions/src/routes/posts.index.tsx index c6b65f1892..056433ca0a 100644 --- a/examples/react/view-transitions/src/routes/posts.index.tsx +++ b/examples/react/view-transitions/src/routes/posts.index.tsx @@ -1,5 +1,5 @@ -import { createFileRoute } from '@tanstack/react-router' import * as React from 'react' +import { createFileRoute } from '@tanstack/react-router' export const Route = createFileRoute('/posts/')({ component: PostsIndexComponent, diff --git a/examples/react/view-transitions/src/routes/posts.route.tsx b/examples/react/view-transitions/src/routes/posts.route.tsx index 88296c3c54..c63dc78ff2 100644 --- a/examples/react/view-transitions/src/routes/posts.route.tsx +++ b/examples/react/view-transitions/src/routes/posts.route.tsx @@ -1,6 +1,5 @@ -import { createFileRoute } from '@tanstack/react-router' import * as React from 'react' -import { Link, Outlet } from '@tanstack/react-router' +import { Link, Outlet, createFileRoute } from '@tanstack/react-router' import { fetchPosts } from '../posts' export const Route = createFileRoute('/posts')({ diff --git a/examples/react/with-framer-motion/package.json b/examples/react/with-framer-motion/package.json index 6f593c4750..f93455c8bc 100644 --- a/examples/react/with-framer-motion/package.json +++ b/examples/react/with-framer-motion/package.json @@ -10,20 +10,20 @@ }, "dependencies": { "@tailwindcss/vite": "^4.2.2", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", "framer-motion": "^11.18.2", "react": "^19.0.0", "react-dom": "^19.0.0", "redaxios": "^0.5.1", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/with-trpc-react-query/package.json b/examples/react/with-trpc-react-query/package.json index e80e1a65e2..2f28b8d428 100644 --- a/examples/react/with-trpc-react-query/package.json +++ b/examples/react/with-trpc-react-query/package.json @@ -13,25 +13,25 @@ "@tailwindcss/vite": "^4.2.2", "@tanstack/react-query": "^5.90.0", "@tanstack/react-query-devtools": "^5.90.0", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/router-plugin": "^1.168.13", "@trpc/client": "^11.4.3", "@trpc/server": "^11.4.3", "@trpc/tanstack-react-query": "^11.4.3", - "express": "^4.21.2", + "express": "^5.2.1", "react": "^19.1.0", "react-dom": "^19.1.0", "redaxios": "^0.5.1", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { - "@types/express": "^4.17.23", + "@types/express": "^5.0.6", "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "tsx": "^4.20.3", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/with-trpc-react-query/src/server/server.ts b/examples/react/with-trpc-react-query/src/server/server.ts index b2b3fd2485..0a580d4963 100644 --- a/examples/react/with-trpc-react-query/src/server/server.ts +++ b/examples/react/with-trpc-react-query/src/server/server.ts @@ -50,7 +50,7 @@ export const createServer = async ( app.use(viteServer.middlewares) // Handle any requests that don't match an API route by serving the React app's index.html - app.get('*', async (req, res, next) => { + app.get('/{*splat}', async (req, res, next) => { try { let html = fs.readFileSync(path.resolve(root, 'index.html'), 'utf-8') @@ -68,7 +68,7 @@ export const createServer = async ( app.use(express.static(path.resolve(__dirname, '../client'))) // Handle any requests that don't match an API route by serving the React app's index.html - app.get('*', (req, res) => { + app.get('/{*splat}', (req, res) => { res.sendFile(path.resolve(__dirname, '../client', 'index.html')) }) } @@ -78,7 +78,8 @@ export const createServer = async ( if (!isTest) { createServer().then(({ app }) => - app.listen(PORT, () => { + app.listen(PORT, (error) => { + if (error) throw error console.info(`Server available at: http://localhost:${PORT}`) }), ) diff --git a/examples/react/with-trpc/package.json b/examples/react/with-trpc/package.json index 83b9aa7481..00e0d8138e 100644 --- a/examples/react/with-trpc/package.json +++ b/examples/react/with-trpc/package.json @@ -11,24 +11,24 @@ }, "dependencies": { "@tailwindcss/vite": "^4.2.2", - "@tanstack/react-router": "^1.168.10", - "@tanstack/react-router-devtools": "^1.166.11", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/react-router": "^1.170.10", + "@tanstack/react-router-devtools": "^1.167.0", + "@tanstack/router-plugin": "^1.168.13", "@trpc/client": "^11.4.3", "@trpc/server": "^11.4.3", - "express": "^4.21.2", + "express": "^5.2.1", "react": "^19.1.0", "react-dom": "^19.1.0", "redaxios": "^0.5.1", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { - "@types/express": "^4.17.23", + "@types/express": "^5.0.6", "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "@vitejs/plugin-react": "^6.0.1", "tsx": "^4.20.3", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/react/with-trpc/src/server/server.ts b/examples/react/with-trpc/src/server/server.ts index b2b3fd2485..0a580d4963 100644 --- a/examples/react/with-trpc/src/server/server.ts +++ b/examples/react/with-trpc/src/server/server.ts @@ -50,7 +50,7 @@ export const createServer = async ( app.use(viteServer.middlewares) // Handle any requests that don't match an API route by serving the React app's index.html - app.get('*', async (req, res, next) => { + app.get('/{*splat}', async (req, res, next) => { try { let html = fs.readFileSync(path.resolve(root, 'index.html'), 'utf-8') @@ -68,7 +68,7 @@ export const createServer = async ( app.use(express.static(path.resolve(__dirname, '../client'))) // Handle any requests that don't match an API route by serving the React app's index.html - app.get('*', (req, res) => { + app.get('/{*splat}', (req, res) => { res.sendFile(path.resolve(__dirname, '../client', 'index.html')) }) } @@ -78,7 +78,8 @@ export const createServer = async ( if (!isTest) { createServer().then(({ app }) => - app.listen(PORT, () => { + app.listen(PORT, (error) => { + if (error) throw error console.info(`Server available at: http://localhost:${PORT}`) }), ) diff --git a/examples/solid/authenticated-routes-firebase/package.json b/examples/solid/authenticated-routes-firebase/package.json index 7dfff49cc8..5d3fe36d3c 100644 --- a/examples/solid/authenticated-routes-firebase/package.json +++ b/examples/solid/authenticated-routes-firebase/package.json @@ -11,7 +11,7 @@ "dependencies": { "@solidjs/web": "2.0.0-beta.14", "@tailwindcss/vite": "^4.2.2", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "@tanstack/solid-router": "^2.0.0-beta.19", "@tanstack/solid-router-devtools": "^2.0.0-beta.15", "firebase": "^11.4.0", @@ -19,11 +19,11 @@ "simple-icons": "^14.9.0", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/authenticated-routes/package.json b/examples/solid/authenticated-routes/package.json index 8832ca1744..4fdad905c9 100644 --- a/examples/solid/authenticated-routes/package.json +++ b/examples/solid/authenticated-routes/package.json @@ -11,17 +11,17 @@ "dependencies": { "@solidjs/web": "2.0.0-beta.14", "@tailwindcss/vite": "^4.2.2", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "@tanstack/solid-router": "^2.0.0-beta.19", "@tanstack/solid-router-devtools": "^2.0.0-beta.15", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/basic-default-search-params/package.json b/examples/solid/basic-default-search-params/package.json index 79e3dfd48d..6ce2da40e1 100644 --- a/examples/solid/basic-default-search-params/package.json +++ b/examples/solid/basic-default-search-params/package.json @@ -4,7 +4,7 @@ "type": "module", "scripts": { "dev": "vite --port=3000", - "build": "vite build", + "build": "vite build && tsc --noEmit", "preview": "vite preview", "start": "vite" }, @@ -17,11 +17,11 @@ "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/basic-devtools-panel/package.json b/examples/solid/basic-devtools-panel/package.json index 2b6bf6eb03..4cf548fd0e 100644 --- a/examples/solid/basic-devtools-panel/package.json +++ b/examples/solid/basic-devtools-panel/package.json @@ -19,7 +19,7 @@ }, "devDependencies": { "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/basic-file-based/package.json b/examples/solid/basic-file-based/package.json index ab62e9b0c5..47f624a582 100644 --- a/examples/solid/basic-file-based/package.json +++ b/examples/solid/basic-file-based/package.json @@ -16,12 +16,12 @@ "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/basic-non-nested-devtools/package.json b/examples/solid/basic-non-nested-devtools/package.json index ba9935f677..522df27ce2 100644 --- a/examples/solid/basic-non-nested-devtools/package.json +++ b/examples/solid/basic-non-nested-devtools/package.json @@ -21,7 +21,7 @@ "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/basic-solid-query-file-based/package.json b/examples/solid/basic-solid-query-file-based/package.json index 130db4eff7..dc2d9a768a 100644 --- a/examples/solid/basic-solid-query-file-based/package.json +++ b/examples/solid/basic-solid-query-file-based/package.json @@ -5,7 +5,7 @@ "scripts": { "dev": "vite --port 3000", "dev:e2e": "vite", - "build": "vite build", + "build": "vite build && tsc --noEmit", "preview": "vite preview", "start": "vite" }, @@ -19,12 +19,12 @@ "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/basic-solid-query/package.json b/examples/solid/basic-solid-query/package.json index 439239c763..05d07c5561 100644 --- a/examples/solid/basic-solid-query/package.json +++ b/examples/solid/basic-solid-query/package.json @@ -4,7 +4,7 @@ "type": "module", "scripts": { "dev": "vite --port 3000", - "build": "vite build", + "build": "vite build && tsc --noEmit", "preview": "vite preview", "start": "vite" }, @@ -20,9 +20,9 @@ "tailwindcss": "^4.2.2" }, "devDependencies": { - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/basic-ssr-file-based/package.json b/examples/solid/basic-ssr-file-based/package.json index 356a313cd3..cafc16996b 100644 --- a/examples/solid/basic-ssr-file-based/package.json +++ b/examples/solid/basic-ssr-file-based/package.json @@ -12,19 +12,19 @@ }, "dependencies": { "@solidjs/web": "2.0.0-beta.14", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "@tanstack/solid-router": "^2.0.0-beta.19", "compression": "^1.8.0", - "express": "^4.21.2", + "express": "^5.2.1", "get-port": "^7.1.0", "node-fetch": "^3.3.2", "solid-js": "2.0.0-beta.14" }, "devDependencies": { "@tanstack/solid-router-devtools": "^2.0.0-beta.15", - "@types/express": "^4.17.23", + "@types/express": "^5.0.6", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/basic-ssr-file-based/server.js b/examples/solid/basic-ssr-file-based/server.js index 5686edc048..6d060a19f0 100644 --- a/examples/solid/basic-ssr-file-based/server.js +++ b/examples/solid/basic-ssr-file-based/server.js @@ -51,7 +51,7 @@ export async function createServer( if (isProd) app.use(express.static('./dist/client')) - app.use('*', async (req, res) => { + app.use('/{*splat}', async (req, res) => { try { const url = req.originalUrl @@ -97,7 +97,8 @@ export async function createServer( if (!isTest) { createServer().then(async ({ app }) => - app.listen(await getPort({ port: portNumbers(3000, 3100) }), () => { + app.listen(await getPort({ port: portNumbers(3000, 3100) }), (error) => { + if (error) throw error console.info('Client Server: http://localhost:3000') }), ) diff --git a/examples/solid/basic-ssr-streaming-file-based/package.json b/examples/solid/basic-ssr-streaming-file-based/package.json index 336af15457..6b39a3c87f 100644 --- a/examples/solid/basic-ssr-streaming-file-based/package.json +++ b/examples/solid/basic-ssr-streaming-file-based/package.json @@ -16,19 +16,19 @@ "@tanstack/solid-router": "^2.0.0-beta.19", "@tanstack/solid-router-devtools": "^2.0.0-beta.15", "compression": "^1.8.0", - "express": "^4.21.2", + "express": "^5.2.1", "get-port": "^7.1.0", "node-fetch": "^3.3.2", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { - "@tanstack/router-plugin": "^1.167.12", - "@types/express": "^4.17.23", + "@tanstack/router-plugin": "^1.168.13", + "@types/express": "^5.0.6", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/basic-ssr-streaming-file-based/server.js b/examples/solid/basic-ssr-streaming-file-based/server.js index 1fb56e8ef7..4369c0028b 100644 --- a/examples/solid/basic-ssr-streaming-file-based/server.js +++ b/examples/solid/basic-ssr-streaming-file-based/server.js @@ -51,7 +51,7 @@ export async function createServer( if (isProd) app.use(express.static('./dist/client')) - app.use('*', async (req, res) => { + app.use('/{*splat}', async (req, res) => { try { const url = req.originalUrl @@ -97,7 +97,8 @@ export async function createServer( if (!isTest) { createServer().then(async ({ app }) => - app.listen(await getPort({ port: portNumbers(3000, 3100) }), () => { + app.listen(await getPort({ port: portNumbers(3000, 3100) }), (error) => { + if (error) throw error console.info('Client Server: http://localhost:3000') }), ) diff --git a/examples/solid/basic-virtual-file-based/package.json b/examples/solid/basic-virtual-file-based/package.json index 55e253dcba..01fc5907e3 100644 --- a/examples/solid/basic-virtual-file-based/package.json +++ b/examples/solid/basic-virtual-file-based/package.json @@ -11,18 +11,18 @@ "dependencies": { "@solidjs/web": "2.0.0-beta.14", "@tailwindcss/vite": "^4.2.2", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "@tanstack/solid-router": "^2.0.0-beta.19", "@tanstack/solid-router-devtools": "^2.0.0-beta.15", - "@tanstack/virtual-file-routes": "^1.161.7", + "@tanstack/virtual-file-routes": "^1.162.0", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/basic-virtual-file-based/src/routeTree.gen.ts b/examples/solid/basic-virtual-file-based/src/routeTree.gen.ts index 8a3c6c7091..cb96aee7ba 100644 --- a/examples/solid/basic-virtual-file-based/src/routeTree.gen.ts +++ b/examples/solid/basic-virtual-file-based/src/routeTree.gen.ts @@ -8,8 +8,6 @@ // You should NOT make any changes in this file as it will be overwritten. // Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. -import type { CreateFileRoute, FileRoutesByPath } from '@tanstack/solid-router' - import { Route as rootRouteImport } from './routes/root' import { Route as postsPostsRouteImport } from './routes/posts/posts' import { Route as layoutFirstLayoutRouteImport } from './routes/layout/first-layout' @@ -255,115 +253,6 @@ declare module '@tanstack/solid-router' { } } -declare module './routes/home' { - const createFileRoute: CreateFileRoute< - '/', - FileRoutesByPath['/']['parentRoute'], - FileRoutesByPath['/']['id'], - FileRoutesByPath['/']['path'], - FileRoutesByPath['/']['fullPath'] - > -} -declare module './routes/layout/first-layout' { - const createFileRoute: CreateFileRoute< - '/_first', - FileRoutesByPath['/_first']['parentRoute'], - FileRoutesByPath['/_first']['id'], - FileRoutesByPath['/_first']['path'], - FileRoutesByPath['/_first']['fullPath'] - > -} -declare module './routes/posts/posts' { - const createFileRoute: CreateFileRoute< - '/posts', - FileRoutesByPath['/posts']['parentRoute'], - FileRoutesByPath['/posts']['id'], - FileRoutesByPath['/posts']['path'], - FileRoutesByPath['/posts']['fullPath'] - > -} -declare module './routes/file-based-subtree/hello/route' { - const createFileRoute: CreateFileRoute< - '/classic/hello', - FileRoutesByPath['/classic/hello']['parentRoute'], - FileRoutesByPath['/classic/hello']['id'], - FileRoutesByPath['/classic/hello']['path'], - FileRoutesByPath['/classic/hello']['fullPath'] - > -} -declare module './routes/posts/posts-home' { - const createFileRoute: CreateFileRoute< - '/posts/', - FileRoutesByPath['/posts/']['parentRoute'], - FileRoutesByPath['/posts/']['id'], - FileRoutesByPath['/posts/']['path'], - FileRoutesByPath['/posts/']['fullPath'] - > -} -declare module './routes/layout/second-layout' { - const createFileRoute: CreateFileRoute< - '/_first/_second-layout', - FileRoutesByPath['/_first/_second-layout']['parentRoute'], - FileRoutesByPath['/_first/_second-layout']['id'], - FileRoutesByPath['/_first/_second-layout']['path'], - FileRoutesByPath['/_first/_second-layout']['fullPath'] - > -} -declare module './routes/posts/posts-detail' { - const createFileRoute: CreateFileRoute< - '/posts/$postId', - FileRoutesByPath['/posts/$postId']['parentRoute'], - FileRoutesByPath['/posts/$postId']['id'], - FileRoutesByPath['/posts/$postId']['path'], - FileRoutesByPath['/posts/$postId']['fullPath'] - > -} -declare module './routes/file-based-subtree/hello/universe' { - const createFileRoute: CreateFileRoute< - '/classic/hello/universe', - FileRoutesByPath['/classic/hello/universe']['parentRoute'], - FileRoutesByPath['/classic/hello/universe']['id'], - FileRoutesByPath['/classic/hello/universe']['path'], - FileRoutesByPath['/classic/hello/universe']['fullPath'] - > -} -declare module './routes/file-based-subtree/hello/world' { - const createFileRoute: CreateFileRoute< - '/classic/hello/world', - FileRoutesByPath['/classic/hello/world']['parentRoute'], - FileRoutesByPath['/classic/hello/world']['id'], - FileRoutesByPath['/classic/hello/world']['path'], - FileRoutesByPath['/classic/hello/world']['fullPath'] - > -} -declare module './routes/file-based-subtree/hello/index' { - const createFileRoute: CreateFileRoute< - '/classic/hello/', - FileRoutesByPath['/classic/hello/']['parentRoute'], - FileRoutesByPath['/classic/hello/']['id'], - FileRoutesByPath['/classic/hello/']['path'], - FileRoutesByPath['/classic/hello/']['fullPath'] - > -} -declare module './routes/a' { - const createFileRoute: CreateFileRoute< - '/_first/_second-layout/route-without-file/layout-a', - FileRoutesByPath['/_first/_second-layout/route-without-file/layout-a']['parentRoute'], - FileRoutesByPath['/_first/_second-layout/route-without-file/layout-a']['id'], - FileRoutesByPath['/_first/_second-layout/route-without-file/layout-a']['path'], - FileRoutesByPath['/_first/_second-layout/route-without-file/layout-a']['fullPath'] - > -} -declare module './routes/b' { - const createFileRoute: CreateFileRoute< - '/_first/_second-layout/route-without-file/layout-b', - FileRoutesByPath['/_first/_second-layout/route-without-file/layout-b']['parentRoute'], - FileRoutesByPath['/_first/_second-layout/route-without-file/layout-b']['id'], - FileRoutesByPath['/_first/_second-layout/route-without-file/layout-b']['path'], - FileRoutesByPath['/_first/_second-layout/route-without-file/layout-b']['fullPath'] - > -} - interface layoutSecondLayoutRouteChildren { aRoute: typeof aRoute bRoute: typeof bRoute diff --git a/examples/solid/basic-virtual-file-based/src/routes/a.tsx b/examples/solid/basic-virtual-file-based/src/routes/a.tsx index a190b24202..5b02ca6dcd 100644 --- a/examples/solid/basic-virtual-file-based/src/routes/a.tsx +++ b/examples/solid/basic-virtual-file-based/src/routes/a.tsx @@ -1,4 +1,7 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute( + '/_first/_second-layout/route-without-file/layout-a', +)({ component: LayoutAComponent, }) diff --git a/examples/solid/basic-virtual-file-based/src/routes/b.tsx b/examples/solid/basic-virtual-file-based/src/routes/b.tsx index 505f8f6fbf..014f13c1cc 100644 --- a/examples/solid/basic-virtual-file-based/src/routes/b.tsx +++ b/examples/solid/basic-virtual-file-based/src/routes/b.tsx @@ -1,4 +1,7 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute( + '/_first/_second-layout/route-without-file/layout-b', +)({ component: LayoutBComponent, }) diff --git a/examples/solid/basic-virtual-file-based/src/routes/file-based-subtree/hello/index.tsx b/examples/solid/basic-virtual-file-based/src/routes/file-based-subtree/hello/index.tsx index f86335e291..6cc8bb1a6f 100644 --- a/examples/solid/basic-virtual-file-based/src/routes/file-based-subtree/hello/index.tsx +++ b/examples/solid/basic-virtual-file-based/src/routes/file-based-subtree/hello/index.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/classic/hello/')({ component: () =>
    This is the index
    , }) diff --git a/examples/solid/basic-virtual-file-based/src/routes/file-based-subtree/hello/route.tsx b/examples/solid/basic-virtual-file-based/src/routes/file-based-subtree/hello/route.tsx index 5b95eea555..f4f30d8425 100644 --- a/examples/solid/basic-virtual-file-based/src/routes/file-based-subtree/hello/route.tsx +++ b/examples/solid/basic-virtual-file-based/src/routes/file-based-subtree/hello/route.tsx @@ -1,6 +1,6 @@ -import { Link, Outlet } from '@tanstack/solid-router' +import { Link, Outlet, createFileRoute } from '@tanstack/solid-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/classic/hello')({ component: () => (
    Hello! diff --git a/examples/solid/basic-virtual-file-based/src/routes/file-based-subtree/hello/universe.tsx b/examples/solid/basic-virtual-file-based/src/routes/file-based-subtree/hello/universe.tsx index 20b07c41cc..f250de10c1 100644 --- a/examples/solid/basic-virtual-file-based/src/routes/file-based-subtree/hello/universe.tsx +++ b/examples/solid/basic-virtual-file-based/src/routes/file-based-subtree/hello/universe.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/classic/hello/universe')({ component: () =>
    Hello /classic/hello/universe!
    , }) diff --git a/examples/solid/basic-virtual-file-based/src/routes/file-based-subtree/hello/world.tsx b/examples/solid/basic-virtual-file-based/src/routes/file-based-subtree/hello/world.tsx index 4af11357a2..d207a49114 100644 --- a/examples/solid/basic-virtual-file-based/src/routes/file-based-subtree/hello/world.tsx +++ b/examples/solid/basic-virtual-file-based/src/routes/file-based-subtree/hello/world.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/classic/hello/world')({ component: () =>
    Hello /classic/hello/world!
    , }) diff --git a/examples/solid/basic-virtual-file-based/src/routes/home.tsx b/examples/solid/basic-virtual-file-based/src/routes/home.tsx index 510db79b73..3f905db60c 100644 --- a/examples/solid/basic-virtual-file-based/src/routes/home.tsx +++ b/examples/solid/basic-virtual-file-based/src/routes/home.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/')({ component: Home, }) diff --git a/examples/solid/basic-virtual-file-based/src/routes/layout/first-layout.tsx b/examples/solid/basic-virtual-file-based/src/routes/layout/first-layout.tsx index c549175638..5c77421bb2 100644 --- a/examples/solid/basic-virtual-file-based/src/routes/layout/first-layout.tsx +++ b/examples/solid/basic-virtual-file-based/src/routes/layout/first-layout.tsx @@ -1,6 +1,6 @@ -import { Outlet } from '@tanstack/solid-router' +import { Outlet, createFileRoute } from '@tanstack/solid-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/_first')({ component: LayoutComponent, }) diff --git a/examples/solid/basic-virtual-file-based/src/routes/layout/second-layout.tsx b/examples/solid/basic-virtual-file-based/src/routes/layout/second-layout.tsx index b2f544c540..245a25bafc 100644 --- a/examples/solid/basic-virtual-file-based/src/routes/layout/second-layout.tsx +++ b/examples/solid/basic-virtual-file-based/src/routes/layout/second-layout.tsx @@ -1,6 +1,6 @@ -import { Link, Outlet } from '@tanstack/solid-router' +import { Link, Outlet, createFileRoute } from '@tanstack/solid-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/_first/_second-layout')({ component: LayoutComponent, }) diff --git a/examples/solid/basic-virtual-file-based/src/routes/posts/posts-detail.tsx b/examples/solid/basic-virtual-file-based/src/routes/posts/posts-detail.tsx index ef413c1be0..990f473ae8 100644 --- a/examples/solid/basic-virtual-file-based/src/routes/posts/posts-detail.tsx +++ b/examples/solid/basic-virtual-file-based/src/routes/posts/posts-detail.tsx @@ -1,4 +1,4 @@ -import { ErrorComponent } from '@tanstack/solid-router' +import { ErrorComponent, createFileRoute } from '@tanstack/solid-router' import { fetchPost } from '../../posts' import type { ErrorComponentProps } from '@tanstack/solid-router' @@ -6,7 +6,7 @@ export function PostErrorComponent({ error }: ErrorComponentProps) { return } -export const Route = createFileRoute({ +export const Route = createFileRoute('/posts/$postId')({ loader: async ({ params: { postId } }) => fetchPost(postId), errorComponent: PostErrorComponent as any, notFoundComponent: () => { diff --git a/examples/solid/basic-virtual-file-based/src/routes/posts/posts-home.tsx b/examples/solid/basic-virtual-file-based/src/routes/posts/posts-home.tsx index 13529228bb..812b581e0a 100644 --- a/examples/solid/basic-virtual-file-based/src/routes/posts/posts-home.tsx +++ b/examples/solid/basic-virtual-file-based/src/routes/posts/posts-home.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/posts/')({ component: PostsIndexComponent, }) diff --git a/examples/solid/basic-virtual-file-based/src/routes/posts/posts.tsx b/examples/solid/basic-virtual-file-based/src/routes/posts/posts.tsx index 46203594d1..9ae6dfc747 100644 --- a/examples/solid/basic-virtual-file-based/src/routes/posts/posts.tsx +++ b/examples/solid/basic-virtual-file-based/src/routes/posts/posts.tsx @@ -1,7 +1,7 @@ -import { Link, Outlet } from '@tanstack/solid-router' +import { Link, Outlet, createFileRoute } from '@tanstack/solid-router' import { fetchPosts } from '../../posts' -export const Route = createFileRoute({ +export const Route = createFileRoute('/posts')({ loader: fetchPosts, component: PostsComponent, }) diff --git a/examples/solid/basic-virtual-file-based/vite.config.ts b/examples/solid/basic-virtual-file-based/vite.config.ts index c13227d733..ec379c254d 100644 --- a/examples/solid/basic-virtual-file-based/vite.config.ts +++ b/examples/solid/basic-virtual-file-based/vite.config.ts @@ -10,7 +10,6 @@ export default defineConfig({ tanstackRouter({ target: 'solid', autoCodeSplitting: true, - verboseFileRoutes: false, virtualRouteConfig: './routes.ts', }), solid(), diff --git a/examples/solid/basic-virtual-inside-file-based/package.json b/examples/solid/basic-virtual-inside-file-based/package.json index 357164e9f2..4e442b5242 100644 --- a/examples/solid/basic-virtual-inside-file-based/package.json +++ b/examples/solid/basic-virtual-inside-file-based/package.json @@ -11,18 +11,18 @@ "dependencies": { "@solidjs/web": "2.0.0-beta.14", "@tailwindcss/vite": "^4.2.2", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "@tanstack/solid-router": "^2.0.0-beta.19", "@tanstack/solid-router-devtools": "^2.0.0-beta.15", - "@tanstack/virtual-file-routes": "^1.161.7", + "@tanstack/virtual-file-routes": "^1.162.0", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/basic-virtual-inside-file-based/src/routeTree.gen.ts b/examples/solid/basic-virtual-inside-file-based/src/routeTree.gen.ts index 03d91a80d6..037dac78a3 100644 --- a/examples/solid/basic-virtual-inside-file-based/src/routeTree.gen.ts +++ b/examples/solid/basic-virtual-inside-file-based/src/routeTree.gen.ts @@ -8,19 +8,17 @@ // You should NOT make any changes in this file as it will be overwritten. // Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. -import type { CreateFileRoute, FileRoutesByPath } from '@tanstack/solid-router' - import { Route as rootRouteImport } from './routes/__root' import { Route as PostsRouteImport } from './routes/posts' import { Route as LayoutRouteImport } from './routes/_layout' import { Route as IndexRouteImport } from './routes/index' -import { Route as postsDetailsRouteImport } from './routes/posts/details' +import { Route as PostsDetailsRouteImport } from './routes/posts/details' import { Route as LayoutLayout2RouteImport } from './routes/_layout/_layout-2' -import { Route as postsHomeRouteImport } from './routes/posts/home' -import { Route as postsLetsGoIndexRouteImport } from './routes/posts/lets-go/index' +import { Route as PostsHomeRouteImport } from './routes/posts/home' +import { Route as PostsLetsGoIndexRouteImport } from './routes/posts/lets-go/index' import { Route as LayoutLayout2LayoutBRouteImport } from './routes/_layout/_layout-2/layout-b' import { Route as LayoutLayout2LayoutARouteImport } from './routes/_layout/_layout-2/layout-a' -import { Route as postsLetsGoDeeperHomeRouteImport } from './routes/posts/lets-go/deeper/home' +import { Route as PostsLetsGoDeeperHomeRouteImport } from './routes/posts/lets-go/deeper/home' const PostsRoute = PostsRouteImport.update({ id: '/posts', @@ -36,7 +34,7 @@ const IndexRoute = IndexRouteImport.update({ path: '/', getParentRoute: () => rootRouteImport, } as any) -const postsDetailsRoute = postsDetailsRouteImport.update({ +const PostsDetailsRoute = PostsDetailsRouteImport.update({ id: '/$postId', path: '/$postId', getParentRoute: () => PostsRoute, @@ -45,12 +43,12 @@ const LayoutLayout2Route = LayoutLayout2RouteImport.update({ id: '/_layout-2', getParentRoute: () => LayoutRoute, } as any) -const postsHomeRoute = postsHomeRouteImport.update({ +const PostsHomeRoute = PostsHomeRouteImport.update({ id: '/', path: '/', getParentRoute: () => PostsRoute, } as any) -const postsLetsGoIndexRoute = postsLetsGoIndexRouteImport.update({ +const PostsLetsGoIndexRoute = PostsLetsGoIndexRouteImport.update({ id: '/inception/', path: '/inception/', getParentRoute: () => PostsRoute, @@ -65,7 +63,7 @@ const LayoutLayout2LayoutARoute = LayoutLayout2LayoutARouteImport.update({ path: '/layout-a', getParentRoute: () => LayoutLayout2Route, } as any) -const postsLetsGoDeeperHomeRoute = postsLetsGoDeeperHomeRouteImport.update({ +const PostsLetsGoDeeperHomeRoute = PostsLetsGoDeeperHomeRouteImport.update({ id: '/inception/deeper/', path: '/inception/deeper/', getParentRoute: () => PostsRoute, @@ -74,34 +72,34 @@ const postsLetsGoDeeperHomeRoute = postsLetsGoDeeperHomeRouteImport.update({ export interface FileRoutesByFullPath { '/': typeof IndexRoute '/posts': typeof PostsRouteWithChildren - '/posts/': typeof postsHomeRoute - '/posts/$postId': typeof postsDetailsRoute + '/posts/': typeof PostsHomeRoute + '/posts/$postId': typeof PostsDetailsRoute '/layout-a': typeof LayoutLayout2LayoutARoute '/layout-b': typeof LayoutLayout2LayoutBRoute - '/posts/inception/': typeof postsLetsGoIndexRoute - '/posts/inception/deeper/': typeof postsLetsGoDeeperHomeRoute + '/posts/inception/': typeof PostsLetsGoIndexRoute + '/posts/inception/deeper/': typeof PostsLetsGoDeeperHomeRoute } export interface FileRoutesByTo { '/': typeof IndexRoute - '/posts': typeof postsHomeRoute - '/posts/$postId': typeof postsDetailsRoute + '/posts': typeof PostsHomeRoute + '/posts/$postId': typeof PostsDetailsRoute '/layout-a': typeof LayoutLayout2LayoutARoute '/layout-b': typeof LayoutLayout2LayoutBRoute - '/posts/inception': typeof postsLetsGoIndexRoute - '/posts/inception/deeper': typeof postsLetsGoDeeperHomeRoute + '/posts/inception': typeof PostsLetsGoIndexRoute + '/posts/inception/deeper': typeof PostsLetsGoDeeperHomeRoute } export interface FileRoutesById { __root__: typeof rootRouteImport '/': typeof IndexRoute '/_layout': typeof LayoutRouteWithChildren '/posts': typeof PostsRouteWithChildren - '/posts/': typeof postsHomeRoute + '/posts/': typeof PostsHomeRoute '/_layout/_layout-2': typeof LayoutLayout2RouteWithChildren - '/posts/$postId': typeof postsDetailsRoute + '/posts/$postId': typeof PostsDetailsRoute '/_layout/_layout-2/layout-a': typeof LayoutLayout2LayoutARoute '/_layout/_layout-2/layout-b': typeof LayoutLayout2LayoutBRoute - '/posts/inception/': typeof postsLetsGoIndexRoute - '/posts/inception/deeper/': typeof postsLetsGoDeeperHomeRoute + '/posts/inception/': typeof PostsLetsGoIndexRoute + '/posts/inception/deeper/': typeof PostsLetsGoDeeperHomeRoute } export interface FileRouteTypes { fileRoutesByFullPath: FileRoutesByFullPath @@ -170,7 +168,7 @@ declare module '@tanstack/solid-router' { id: '/posts/$postId' path: '/$postId' fullPath: '/posts/$postId' - preLoaderRoute: typeof postsDetailsRouteImport + preLoaderRoute: typeof PostsDetailsRouteImport parentRoute: typeof PostsRoute } '/_layout/_layout-2': { @@ -184,14 +182,14 @@ declare module '@tanstack/solid-router' { id: '/posts/' path: '/' fullPath: '/posts/' - preLoaderRoute: typeof postsHomeRouteImport + preLoaderRoute: typeof PostsHomeRouteImport parentRoute: typeof PostsRoute } '/posts/inception/': { id: '/posts/inception/' path: '/inception' fullPath: '/posts/inception/' - preLoaderRoute: typeof postsLetsGoIndexRouteImport + preLoaderRoute: typeof PostsLetsGoIndexRouteImport parentRoute: typeof PostsRoute } '/_layout/_layout-2/layout-b': { @@ -212,103 +210,12 @@ declare module '@tanstack/solid-router' { id: '/posts/inception/deeper/' path: '/inception/deeper' fullPath: '/posts/inception/deeper/' - preLoaderRoute: typeof postsLetsGoDeeperHomeRouteImport + preLoaderRoute: typeof PostsLetsGoDeeperHomeRouteImport parentRoute: typeof PostsRoute } } } -declare module './routes/index' { - const createFileRoute: CreateFileRoute< - '/', - FileRoutesByPath['/']['parentRoute'], - FileRoutesByPath['/']['id'], - FileRoutesByPath['/']['path'], - FileRoutesByPath['/']['fullPath'] - > -} -declare module './routes/_layout' { - const createFileRoute: CreateFileRoute< - '/_layout', - FileRoutesByPath['/_layout']['parentRoute'], - FileRoutesByPath['/_layout']['id'], - FileRoutesByPath['/_layout']['path'], - FileRoutesByPath['/_layout']['fullPath'] - > -} -declare module './routes/posts' { - const createFileRoute: CreateFileRoute< - '/posts', - FileRoutesByPath['/posts']['parentRoute'], - FileRoutesByPath['/posts']['id'], - FileRoutesByPath['/posts']['path'], - FileRoutesByPath['/posts']['fullPath'] - > -} -declare module './routes/posts/home' { - const createFileRoute: CreateFileRoute< - '/posts/', - FileRoutesByPath['/posts/']['parentRoute'], - FileRoutesByPath['/posts/']['id'], - FileRoutesByPath['/posts/']['path'], - FileRoutesByPath['/posts/']['fullPath'] - > -} -declare module './routes/_layout/_layout-2' { - const createFileRoute: CreateFileRoute< - '/_layout/_layout-2', - FileRoutesByPath['/_layout/_layout-2']['parentRoute'], - FileRoutesByPath['/_layout/_layout-2']['id'], - FileRoutesByPath['/_layout/_layout-2']['path'], - FileRoutesByPath['/_layout/_layout-2']['fullPath'] - > -} -declare module './routes/posts/details' { - const createFileRoute: CreateFileRoute< - '/posts/$postId', - FileRoutesByPath['/posts/$postId']['parentRoute'], - FileRoutesByPath['/posts/$postId']['id'], - FileRoutesByPath['/posts/$postId']['path'], - FileRoutesByPath['/posts/$postId']['fullPath'] - > -} -declare module './routes/_layout/_layout-2/layout-a' { - const createFileRoute: CreateFileRoute< - '/_layout/_layout-2/layout-a', - FileRoutesByPath['/_layout/_layout-2/layout-a']['parentRoute'], - FileRoutesByPath['/_layout/_layout-2/layout-a']['id'], - FileRoutesByPath['/_layout/_layout-2/layout-a']['path'], - FileRoutesByPath['/_layout/_layout-2/layout-a']['fullPath'] - > -} -declare module './routes/_layout/_layout-2/layout-b' { - const createFileRoute: CreateFileRoute< - '/_layout/_layout-2/layout-b', - FileRoutesByPath['/_layout/_layout-2/layout-b']['parentRoute'], - FileRoutesByPath['/_layout/_layout-2/layout-b']['id'], - FileRoutesByPath['/_layout/_layout-2/layout-b']['path'], - FileRoutesByPath['/_layout/_layout-2/layout-b']['fullPath'] - > -} -declare module './routes/posts/lets-go/index' { - const createFileRoute: CreateFileRoute< - '/posts/inception/', - FileRoutesByPath['/posts/inception/']['parentRoute'], - FileRoutesByPath['/posts/inception/']['id'], - FileRoutesByPath['/posts/inception/']['path'], - FileRoutesByPath['/posts/inception/']['fullPath'] - > -} -declare module './routes/posts/lets-go/deeper/home' { - const createFileRoute: CreateFileRoute< - '/posts/inception/deeper/', - FileRoutesByPath['/posts/inception/deeper/']['parentRoute'], - FileRoutesByPath['/posts/inception/deeper/']['id'], - FileRoutesByPath['/posts/inception/deeper/']['path'], - FileRoutesByPath['/posts/inception/deeper/']['fullPath'] - > -} - interface LayoutLayout2RouteChildren { LayoutLayout2LayoutARoute: typeof LayoutLayout2LayoutARoute LayoutLayout2LayoutBRoute: typeof LayoutLayout2LayoutBRoute @@ -335,17 +242,17 @@ const LayoutRouteWithChildren = LayoutRoute._addFileChildren(LayoutRouteChildren) interface PostsRouteChildren { - postsHomeRoute: typeof postsHomeRoute - postsDetailsRoute: typeof postsDetailsRoute - postsLetsGoIndexRoute: typeof postsLetsGoIndexRoute - postsLetsGoDeeperHomeRoute: typeof postsLetsGoDeeperHomeRoute + PostsHomeRoute: typeof PostsHomeRoute + PostsDetailsRoute: typeof PostsDetailsRoute + PostsLetsGoIndexRoute: typeof PostsLetsGoIndexRoute + PostsLetsGoDeeperHomeRoute: typeof PostsLetsGoDeeperHomeRoute } const PostsRouteChildren: PostsRouteChildren = { - postsHomeRoute: postsHomeRoute, - postsDetailsRoute: postsDetailsRoute, - postsLetsGoIndexRoute: postsLetsGoIndexRoute, - postsLetsGoDeeperHomeRoute: postsLetsGoDeeperHomeRoute, + PostsHomeRoute: PostsHomeRoute, + PostsDetailsRoute: PostsDetailsRoute, + PostsLetsGoIndexRoute: PostsLetsGoIndexRoute, + PostsLetsGoDeeperHomeRoute: PostsLetsGoDeeperHomeRoute, } const PostsRouteWithChildren = PostsRoute._addFileChildren(PostsRouteChildren) diff --git a/examples/solid/basic-virtual-inside-file-based/src/routes/_layout.tsx b/examples/solid/basic-virtual-inside-file-based/src/routes/_layout.tsx index c549175638..d43b4ef5f5 100644 --- a/examples/solid/basic-virtual-inside-file-based/src/routes/_layout.tsx +++ b/examples/solid/basic-virtual-inside-file-based/src/routes/_layout.tsx @@ -1,6 +1,6 @@ -import { Outlet } from '@tanstack/solid-router' +import { Outlet, createFileRoute } from '@tanstack/solid-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/_layout')({ component: LayoutComponent, }) diff --git a/examples/solid/basic-virtual-inside-file-based/src/routes/_layout/_layout-2.tsx b/examples/solid/basic-virtual-inside-file-based/src/routes/_layout/_layout-2.tsx index efeca5ce86..7a5a3623a0 100644 --- a/examples/solid/basic-virtual-inside-file-based/src/routes/_layout/_layout-2.tsx +++ b/examples/solid/basic-virtual-inside-file-based/src/routes/_layout/_layout-2.tsx @@ -1,6 +1,6 @@ -import { Link, Outlet } from '@tanstack/solid-router' +import { Link, Outlet, createFileRoute } from '@tanstack/solid-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/_layout/_layout-2')({ component: LayoutComponent, }) diff --git a/examples/solid/basic-virtual-inside-file-based/src/routes/_layout/_layout-2/layout-a.tsx b/examples/solid/basic-virtual-inside-file-based/src/routes/_layout/_layout-2/layout-a.tsx index a190b24202..997e6caf80 100644 --- a/examples/solid/basic-virtual-inside-file-based/src/routes/_layout/_layout-2/layout-a.tsx +++ b/examples/solid/basic-virtual-inside-file-based/src/routes/_layout/_layout-2/layout-a.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/_layout/_layout-2/layout-a')({ component: LayoutAComponent, }) diff --git a/examples/solid/basic-virtual-inside-file-based/src/routes/_layout/_layout-2/layout-b.tsx b/examples/solid/basic-virtual-inside-file-based/src/routes/_layout/_layout-2/layout-b.tsx index 505f8f6fbf..70135c5809 100644 --- a/examples/solid/basic-virtual-inside-file-based/src/routes/_layout/_layout-2/layout-b.tsx +++ b/examples/solid/basic-virtual-inside-file-based/src/routes/_layout/_layout-2/layout-b.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/_layout/_layout-2/layout-b')({ component: LayoutBComponent, }) diff --git a/examples/solid/basic-virtual-inside-file-based/src/routes/index.tsx b/examples/solid/basic-virtual-inside-file-based/src/routes/index.tsx index 510db79b73..3f905db60c 100644 --- a/examples/solid/basic-virtual-inside-file-based/src/routes/index.tsx +++ b/examples/solid/basic-virtual-inside-file-based/src/routes/index.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/')({ component: Home, }) diff --git a/examples/solid/basic-virtual-inside-file-based/src/routes/posts.tsx b/examples/solid/basic-virtual-inside-file-based/src/routes/posts.tsx index 2e28f9beb3..11a999f50a 100644 --- a/examples/solid/basic-virtual-inside-file-based/src/routes/posts.tsx +++ b/examples/solid/basic-virtual-inside-file-based/src/routes/posts.tsx @@ -1,7 +1,7 @@ -import { Link, Outlet } from '@tanstack/solid-router' +import { Link, Outlet, createFileRoute } from '@tanstack/solid-router' import { fetchPosts } from '../posts' -export const Route = createFileRoute({ +export const Route = createFileRoute('/posts')({ loader: fetchPosts, component: PostsComponent, }) diff --git a/examples/solid/basic-virtual-inside-file-based/src/routes/posts/details.tsx b/examples/solid/basic-virtual-inside-file-based/src/routes/posts/details.tsx index b01702746d..de4cc4ed80 100644 --- a/examples/solid/basic-virtual-inside-file-based/src/routes/posts/details.tsx +++ b/examples/solid/basic-virtual-inside-file-based/src/routes/posts/details.tsx @@ -1,4 +1,4 @@ -import { ErrorComponent } from '@tanstack/solid-router' +import { ErrorComponent, createFileRoute } from '@tanstack/solid-router' import { fetchPost } from '../../posts' import type { ErrorComponentProps } from '@tanstack/solid-router' @@ -6,7 +6,7 @@ export function PostErrorComponent({ error }: ErrorComponentProps) { return } -export const Route = createFileRoute({ +export const Route = createFileRoute('/posts/$postId')({ loader: async ({ params: { postId } }) => fetchPost(postId), errorComponent: PostErrorComponent, notFoundComponent: () => { diff --git a/examples/solid/basic-virtual-inside-file-based/src/routes/posts/home.tsx b/examples/solid/basic-virtual-inside-file-based/src/routes/posts/home.tsx index 13529228bb..812b581e0a 100644 --- a/examples/solid/basic-virtual-inside-file-based/src/routes/posts/home.tsx +++ b/examples/solid/basic-virtual-inside-file-based/src/routes/posts/home.tsx @@ -1,4 +1,5 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/posts/')({ component: PostsIndexComponent, }) diff --git a/examples/solid/basic-virtual-inside-file-based/src/routes/posts/lets-go/deeper/home.tsx b/examples/solid/basic-virtual-inside-file-based/src/routes/posts/lets-go/deeper/home.tsx index f8bc76644a..166eda4335 100644 --- a/examples/solid/basic-virtual-inside-file-based/src/routes/posts/lets-go/deeper/home.tsx +++ b/examples/solid/basic-virtual-inside-file-based/src/routes/posts/lets-go/deeper/home.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/posts/inception/deeper/')({ component: () =>
    Hello /posts/inception/deeper/!
    , }) diff --git a/examples/solid/basic-virtual-inside-file-based/src/routes/posts/lets-go/index.tsx b/examples/solid/basic-virtual-inside-file-based/src/routes/posts/lets-go/index.tsx index 1c7ea68931..49b88f751d 100644 --- a/examples/solid/basic-virtual-inside-file-based/src/routes/posts/lets-go/index.tsx +++ b/examples/solid/basic-virtual-inside-file-based/src/routes/posts/lets-go/index.tsx @@ -1,3 +1,4 @@ -export const Route = createFileRoute({ +import { createFileRoute } from '@tanstack/solid-router' +export const Route = createFileRoute('/posts/inception/')({ component: () =>
    Hello /posts/inception/!
    , }) diff --git a/examples/solid/basic-virtual-inside-file-based/vite.config.ts b/examples/solid/basic-virtual-inside-file-based/vite.config.ts index b119537544..79454008ba 100644 --- a/examples/solid/basic-virtual-inside-file-based/vite.config.ts +++ b/examples/solid/basic-virtual-inside-file-based/vite.config.ts @@ -10,7 +10,6 @@ export default defineConfig({ tanstackRouter({ target: 'solid', autoCodeSplitting: true, - verboseFileRoutes: false, }), solid(), ], diff --git a/examples/solid/basic/package.json b/examples/solid/basic/package.json index 96958e6638..3c9da90d8c 100644 --- a/examples/solid/basic/package.json +++ b/examples/solid/basic/package.json @@ -21,7 +21,7 @@ "@types/react": "^19.0.8", "@types/react-dom": "^19.0.3", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/deferred-data/package.json b/examples/solid/deferred-data/package.json index 8f104fc94f..705bbcaf0a 100644 --- a/examples/solid/deferred-data/package.json +++ b/examples/solid/deferred-data/package.json @@ -16,11 +16,11 @@ "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/i18n-paraglide/package.json b/examples/solid/i18n-paraglide/package.json index 090c20bd99..d3c0fbc0a0 100644 --- a/examples/solid/i18n-paraglide/package.json +++ b/examples/solid/i18n-paraglide/package.json @@ -12,7 +12,7 @@ "dependencies": { "@solidjs/web": "2.0.0-beta.14", "@tailwindcss/vite": "^4.2.2", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "@tanstack/solid-router": "^2.0.0-beta.19", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2" @@ -21,7 +21,7 @@ "@inlang/paraglide-js": "^2.4.0", "@types/node": "^22.18.6", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/kitchen-sink-file-based/package.json b/examples/solid/kitchen-sink-file-based/package.json index af8c4b67b0..dcfb4c53c6 100644 --- a/examples/solid/kitchen-sink-file-based/package.json +++ b/examples/solid/kitchen-sink-file-based/package.json @@ -4,7 +4,7 @@ "type": "module", "scripts": { "dev": "vite --port 3000", - "build": "echo 'Skipped: waiting for dependency Solid 2.0 support' && exit 0", + "build": "vite build && tsc --noEmit", "preview": "vite preview", "start": "vite" }, @@ -17,12 +17,12 @@ "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/kitchen-sink-file-based/src/routeTree.gen.ts b/examples/solid/kitchen-sink-file-based/src/routeTree.gen.ts index f7af0fbf39..0c6e04f63d 100644 --- a/examples/solid/kitchen-sink-file-based/src/routeTree.gen.ts +++ b/examples/solid/kitchen-sink-file-based/src/routeTree.gen.ts @@ -8,9 +8,7 @@ // You should NOT make any changes in this file as it will be overwritten. // Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. -// Import Routes - -import { Route as rootRoute } from './routes/__root' +import { Route as rootRouteImport } from './routes/__root' import { Route as LoginRouteImport } from './routes/login' import { Route as PathlessLayoutRouteImport } from './routes/_pathlessLayout' import { Route as AuthRouteImport } from './routes/_auth' @@ -29,103 +27,85 @@ import { Route as DashboardInvoicesIndexRouteImport } from './routes/dashboard.i import { Route as DashboardUsersUserRouteImport } from './routes/dashboard.users.user' import { Route as DashboardInvoicesInvoiceIdRouteImport } from './routes/dashboard.invoices.$invoiceId' -// Create/Update Routes - const LoginRoute = LoginRouteImport.update({ id: '/login', path: '/login', - getParentRoute: () => rootRoute, + getParentRoute: () => rootRouteImport, } as any) - const PathlessLayoutRoute = PathlessLayoutRouteImport.update({ id: '/_pathlessLayout', - getParentRoute: () => rootRoute, + getParentRoute: () => rootRouteImport, } as any) - const AuthRoute = AuthRouteImport.update({ id: '/_auth', - getParentRoute: () => rootRoute, + getParentRoute: () => rootRouteImport, } as any) - const DashboardRouteRoute = DashboardRouteRouteImport.update({ id: '/dashboard', path: '/dashboard', - getParentRoute: () => rootRoute, + getParentRoute: () => rootRouteImport, } as any) - const IndexRoute = IndexRouteImport.update({ id: '/', path: '/', - getParentRoute: () => rootRoute, + getParentRoute: () => rootRouteImport, } as any) - const ExpensiveIndexRoute = ExpensiveIndexRouteImport.update({ id: '/expensive/', path: '/expensive/', - getParentRoute: () => rootRoute, + getParentRoute: () => rootRouteImport, } as any) - const DashboardIndexRoute = DashboardIndexRouteImport.update({ id: '/', path: '/', getParentRoute: () => DashboardRouteRoute, } as any) - const PathlessLayoutRouteBRoute = PathlessLayoutRouteBRouteImport.update({ id: '/route-b', path: '/route-b', getParentRoute: () => PathlessLayoutRoute, } as any) - const PathlessLayoutRouteARoute = PathlessLayoutRouteARouteImport.update({ id: '/route-a', path: '/route-a', getParentRoute: () => PathlessLayoutRoute, } as any) - const AuthProfileRoute = AuthProfileRouteImport.update({ id: '/profile', path: '/profile', getParentRoute: () => AuthRoute, } as any) - const thisFolderIsNotInTheUrlRouteGroupRoute = thisFolderIsNotInTheUrlRouteGroupRouteImport.update({ id: '/(this-folder-is-not-in-the-url)/route-group', path: '/route-group', - getParentRoute: () => rootRoute, + getParentRoute: () => rootRouteImport, } as any) - const DashboardUsersRouteRoute = DashboardUsersRouteRouteImport.update({ id: '/users', path: '/users', getParentRoute: () => DashboardRouteRoute, } as any) - const DashboardInvoicesRouteRoute = DashboardInvoicesRouteRouteImport.update({ id: '/invoices', path: '/invoices', getParentRoute: () => DashboardRouteRoute, } as any) - const DashboardUsersIndexRoute = DashboardUsersIndexRouteImport.update({ id: '/', path: '/', getParentRoute: () => DashboardUsersRouteRoute, } as any) - const DashboardInvoicesIndexRoute = DashboardInvoicesIndexRouteImport.update({ id: '/', path: '/', getParentRoute: () => DashboardInvoicesRouteRoute, } as any) - const DashboardUsersUserRoute = DashboardUsersUserRouteImport.update({ id: '/user', path: '/user', getParentRoute: () => DashboardUsersRouteRoute, } as any) - const DashboardInvoicesInvoiceIdRoute = DashboardInvoicesInvoiceIdRouteImport.update({ id: '/$invoiceId', @@ -133,134 +113,244 @@ const DashboardInvoicesInvoiceIdRoute = getParentRoute: () => DashboardInvoicesRouteRoute, } as any) -// Populate the FileRoutesByPath interface +export interface FileRoutesByFullPath { + '/': typeof IndexRoute + '/dashboard': typeof DashboardRouteRouteWithChildren + '/login': typeof LoginRoute + '/dashboard/invoices': typeof DashboardInvoicesRouteRouteWithChildren + '/dashboard/users': typeof DashboardUsersRouteRouteWithChildren + '/route-group': typeof thisFolderIsNotInTheUrlRouteGroupRoute + '/profile': typeof AuthProfileRoute + '/route-a': typeof PathlessLayoutRouteARoute + '/route-b': typeof PathlessLayoutRouteBRoute + '/dashboard/': typeof DashboardIndexRoute + '/expensive/': typeof ExpensiveIndexRoute + '/dashboard/invoices/$invoiceId': typeof DashboardInvoicesInvoiceIdRoute + '/dashboard/users/user': typeof DashboardUsersUserRoute + '/dashboard/invoices/': typeof DashboardInvoicesIndexRoute + '/dashboard/users/': typeof DashboardUsersIndexRoute +} +export interface FileRoutesByTo { + '/': typeof IndexRoute + '/login': typeof LoginRoute + '/route-group': typeof thisFolderIsNotInTheUrlRouteGroupRoute + '/profile': typeof AuthProfileRoute + '/route-a': typeof PathlessLayoutRouteARoute + '/route-b': typeof PathlessLayoutRouteBRoute + '/dashboard': typeof DashboardIndexRoute + '/expensive': typeof ExpensiveIndexRoute + '/dashboard/invoices/$invoiceId': typeof DashboardInvoicesInvoiceIdRoute + '/dashboard/users/user': typeof DashboardUsersUserRoute + '/dashboard/invoices': typeof DashboardInvoicesIndexRoute + '/dashboard/users': typeof DashboardUsersIndexRoute +} +export interface FileRoutesById { + __root__: typeof rootRouteImport + '/': typeof IndexRoute + '/dashboard': typeof DashboardRouteRouteWithChildren + '/_auth': typeof AuthRouteWithChildren + '/_pathlessLayout': typeof PathlessLayoutRouteWithChildren + '/login': typeof LoginRoute + '/dashboard/invoices': typeof DashboardInvoicesRouteRouteWithChildren + '/dashboard/users': typeof DashboardUsersRouteRouteWithChildren + '/(this-folder-is-not-in-the-url)/route-group': typeof thisFolderIsNotInTheUrlRouteGroupRoute + '/_auth/profile': typeof AuthProfileRoute + '/_pathlessLayout/route-a': typeof PathlessLayoutRouteARoute + '/_pathlessLayout/route-b': typeof PathlessLayoutRouteBRoute + '/dashboard/': typeof DashboardIndexRoute + '/expensive/': typeof ExpensiveIndexRoute + '/dashboard/invoices/$invoiceId': typeof DashboardInvoicesInvoiceIdRoute + '/dashboard/users/user': typeof DashboardUsersUserRoute + '/dashboard/invoices/': typeof DashboardInvoicesIndexRoute + '/dashboard/users/': typeof DashboardUsersIndexRoute +} +export interface FileRouteTypes { + fileRoutesByFullPath: FileRoutesByFullPath + fullPaths: + | '/' + | '/dashboard' + | '/login' + | '/dashboard/invoices' + | '/dashboard/users' + | '/route-group' + | '/profile' + | '/route-a' + | '/route-b' + | '/dashboard/' + | '/expensive/' + | '/dashboard/invoices/$invoiceId' + | '/dashboard/users/user' + | '/dashboard/invoices/' + | '/dashboard/users/' + fileRoutesByTo: FileRoutesByTo + to: + | '/' + | '/login' + | '/route-group' + | '/profile' + | '/route-a' + | '/route-b' + | '/dashboard' + | '/expensive' + | '/dashboard/invoices/$invoiceId' + | '/dashboard/users/user' + | '/dashboard/invoices' + | '/dashboard/users' + id: + | '__root__' + | '/' + | '/dashboard' + | '/_auth' + | '/_pathlessLayout' + | '/login' + | '/dashboard/invoices' + | '/dashboard/users' + | '/(this-folder-is-not-in-the-url)/route-group' + | '/_auth/profile' + | '/_pathlessLayout/route-a' + | '/_pathlessLayout/route-b' + | '/dashboard/' + | '/expensive/' + | '/dashboard/invoices/$invoiceId' + | '/dashboard/users/user' + | '/dashboard/invoices/' + | '/dashboard/users/' + fileRoutesById: FileRoutesById +} +export interface RootRouteChildren { + IndexRoute: typeof IndexRoute + DashboardRouteRoute: typeof DashboardRouteRouteWithChildren + AuthRoute: typeof AuthRouteWithChildren + PathlessLayoutRoute: typeof PathlessLayoutRouteWithChildren + LoginRoute: typeof LoginRoute + thisFolderIsNotInTheUrlRouteGroupRoute: typeof thisFolderIsNotInTheUrlRouteGroupRoute + ExpensiveIndexRoute: typeof ExpensiveIndexRoute +} declare module '@tanstack/solid-router' { interface FileRoutesByPath { - '/': { - id: '/' - path: '/' + '/login': { + id: '/login' + path: '/login' + fullPath: '/login' + preLoaderRoute: typeof LoginRouteImport + parentRoute: typeof rootRouteImport + } + '/_pathlessLayout': { + id: '/_pathlessLayout' + path: '' fullPath: '/' - preLoaderRoute: typeof IndexRouteImport - parentRoute: typeof rootRoute + preLoaderRoute: typeof PathlessLayoutRouteImport + parentRoute: typeof rootRouteImport + } + '/_auth': { + id: '/_auth' + path: '' + fullPath: '/' + preLoaderRoute: typeof AuthRouteImport + parentRoute: typeof rootRouteImport } '/dashboard': { id: '/dashboard' path: '/dashboard' fullPath: '/dashboard' preLoaderRoute: typeof DashboardRouteRouteImport - parentRoute: typeof rootRoute + parentRoute: typeof rootRouteImport } - '/_auth': { - id: '/_auth' - path: '' - fullPath: '' - preLoaderRoute: typeof AuthRouteImport - parentRoute: typeof rootRoute + '/': { + id: '/' + path: '/' + fullPath: '/' + preLoaderRoute: typeof IndexRouteImport + parentRoute: typeof rootRouteImport } - '/_pathlessLayout': { - id: '/_pathlessLayout' - path: '' - fullPath: '' - preLoaderRoute: typeof PathlessLayoutRouteImport - parentRoute: typeof rootRoute - } - '/login': { - id: '/login' - path: '/login' - fullPath: '/login' - preLoaderRoute: typeof LoginRouteImport - parentRoute: typeof rootRoute - } - '/dashboard/invoices': { - id: '/dashboard/invoices' - path: '/invoices' - fullPath: '/dashboard/invoices' - preLoaderRoute: typeof DashboardInvoicesRouteRouteImport - parentRoute: typeof DashboardRouteRouteImport - } - '/dashboard/users': { - id: '/dashboard/users' - path: '/users' - fullPath: '/dashboard/users' - preLoaderRoute: typeof DashboardUsersRouteRouteImport - parentRoute: typeof DashboardRouteRouteImport - } - '/(this-folder-is-not-in-the-url)/route-group': { - id: '/(this-folder-is-not-in-the-url)/route-group' - path: '/route-group' - fullPath: '/route-group' - preLoaderRoute: typeof thisFolderIsNotInTheUrlRouteGroupRouteImport - parentRoute: typeof rootRoute - } - '/_auth/profile': { - id: '/_auth/profile' - path: '/profile' - fullPath: '/profile' - preLoaderRoute: typeof AuthProfileRouteImport - parentRoute: typeof AuthRouteImport - } - '/_pathlessLayout/route-a': { - id: '/_pathlessLayout/route-a' - path: '/route-a' - fullPath: '/route-a' - preLoaderRoute: typeof PathlessLayoutRouteARouteImport - parentRoute: typeof PathlessLayoutRouteImport - } - '/_pathlessLayout/route-b': { - id: '/_pathlessLayout/route-b' - path: '/route-b' - fullPath: '/route-b' - preLoaderRoute: typeof PathlessLayoutRouteBRouteImport - parentRoute: typeof PathlessLayoutRouteImport + '/expensive/': { + id: '/expensive/' + path: '/expensive' + fullPath: '/expensive/' + preLoaderRoute: typeof ExpensiveIndexRouteImport + parentRoute: typeof rootRouteImport } '/dashboard/': { id: '/dashboard/' path: '/' fullPath: '/dashboard/' preLoaderRoute: typeof DashboardIndexRouteImport - parentRoute: typeof DashboardRouteRouteImport + parentRoute: typeof DashboardRouteRoute } - '/expensive/': { - id: '/expensive/' - path: '/expensive' - fullPath: '/expensive' - preLoaderRoute: typeof ExpensiveIndexRouteImport - parentRoute: typeof rootRoute + '/_pathlessLayout/route-b': { + id: '/_pathlessLayout/route-b' + path: '/route-b' + fullPath: '/route-b' + preLoaderRoute: typeof PathlessLayoutRouteBRouteImport + parentRoute: typeof PathlessLayoutRoute } - '/dashboard/invoices/$invoiceId': { - id: '/dashboard/invoices/$invoiceId' - path: '/$invoiceId' - fullPath: '/dashboard/invoices/$invoiceId' - preLoaderRoute: typeof DashboardInvoicesInvoiceIdRouteImport - parentRoute: typeof DashboardInvoicesRouteRouteImport + '/_pathlessLayout/route-a': { + id: '/_pathlessLayout/route-a' + path: '/route-a' + fullPath: '/route-a' + preLoaderRoute: typeof PathlessLayoutRouteARouteImport + parentRoute: typeof PathlessLayoutRoute } - '/dashboard/users/user': { - id: '/dashboard/users/user' - path: '/user' - fullPath: '/dashboard/users/user' - preLoaderRoute: typeof DashboardUsersUserRouteImport - parentRoute: typeof DashboardUsersRouteRouteImport + '/_auth/profile': { + id: '/_auth/profile' + path: '/profile' + fullPath: '/profile' + preLoaderRoute: typeof AuthProfileRouteImport + parentRoute: typeof AuthRoute } - '/dashboard/invoices/': { - id: '/dashboard/invoices/' - path: '/' - fullPath: '/dashboard/invoices/' - preLoaderRoute: typeof DashboardInvoicesIndexRouteImport - parentRoute: typeof DashboardInvoicesRouteRouteImport + '/(this-folder-is-not-in-the-url)/route-group': { + id: '/(this-folder-is-not-in-the-url)/route-group' + path: '/route-group' + fullPath: '/route-group' + preLoaderRoute: typeof thisFolderIsNotInTheUrlRouteGroupRouteImport + parentRoute: typeof rootRouteImport + } + '/dashboard/users': { + id: '/dashboard/users' + path: '/users' + fullPath: '/dashboard/users' + preLoaderRoute: typeof DashboardUsersRouteRouteImport + parentRoute: typeof DashboardRouteRoute + } + '/dashboard/invoices': { + id: '/dashboard/invoices' + path: '/invoices' + fullPath: '/dashboard/invoices' + preLoaderRoute: typeof DashboardInvoicesRouteRouteImport + parentRoute: typeof DashboardRouteRoute } '/dashboard/users/': { id: '/dashboard/users/' path: '/' fullPath: '/dashboard/users/' preLoaderRoute: typeof DashboardUsersIndexRouteImport - parentRoute: typeof DashboardUsersRouteRouteImport + parentRoute: typeof DashboardUsersRouteRoute + } + '/dashboard/invoices/': { + id: '/dashboard/invoices/' + path: '/' + fullPath: '/dashboard/invoices/' + preLoaderRoute: typeof DashboardInvoicesIndexRouteImport + parentRoute: typeof DashboardInvoicesRouteRoute + } + '/dashboard/users/user': { + id: '/dashboard/users/user' + path: '/user' + fullPath: '/dashboard/users/user' + preLoaderRoute: typeof DashboardUsersUserRouteImport + parentRoute: typeof DashboardUsersRouteRoute + } + '/dashboard/invoices/$invoiceId': { + id: '/dashboard/invoices/$invoiceId' + path: '/$invoiceId' + fullPath: '/dashboard/invoices/$invoiceId' + preLoaderRoute: typeof DashboardInvoicesInvoiceIdRouteImport + parentRoute: typeof DashboardInvoicesRouteRoute } } } -// Create and export the route tree - interface DashboardInvoicesRouteRouteChildren { DashboardInvoicesInvoiceIdRoute: typeof DashboardInvoicesInvoiceIdRoute DashboardInvoicesIndexRoute: typeof DashboardInvoicesIndexRoute @@ -330,128 +420,6 @@ const PathlessLayoutRouteWithChildren = PathlessLayoutRoute._addFileChildren( PathlessLayoutRouteChildren, ) -export interface FileRoutesByFullPath { - '/': typeof IndexRoute - '/dashboard': typeof DashboardRouteRouteWithChildren - '': typeof PathlessLayoutRouteWithChildren - '/login': typeof LoginRoute - '/dashboard/invoices': typeof DashboardInvoicesRouteRouteWithChildren - '/dashboard/users': typeof DashboardUsersRouteRouteWithChildren - '/route-group': typeof thisFolderIsNotInTheUrlRouteGroupRoute - '/profile': typeof AuthProfileRoute - '/route-a': typeof PathlessLayoutRouteARoute - '/route-b': typeof PathlessLayoutRouteBRoute - '/dashboard/': typeof DashboardIndexRoute - '/expensive': typeof ExpensiveIndexRoute - '/dashboard/invoices/$invoiceId': typeof DashboardInvoicesInvoiceIdRoute - '/dashboard/users/user': typeof DashboardUsersUserRoute - '/dashboard/invoices/': typeof DashboardInvoicesIndexRoute - '/dashboard/users/': typeof DashboardUsersIndexRoute -} - -export interface FileRoutesByTo { - '/': typeof IndexRoute - '': typeof PathlessLayoutRouteWithChildren - '/login': typeof LoginRoute - '/route-group': typeof thisFolderIsNotInTheUrlRouteGroupRoute - '/profile': typeof AuthProfileRoute - '/route-a': typeof PathlessLayoutRouteARoute - '/route-b': typeof PathlessLayoutRouteBRoute - '/dashboard': typeof DashboardIndexRoute - '/expensive': typeof ExpensiveIndexRoute - '/dashboard/invoices/$invoiceId': typeof DashboardInvoicesInvoiceIdRoute - '/dashboard/users/user': typeof DashboardUsersUserRoute - '/dashboard/invoices': typeof DashboardInvoicesIndexRoute - '/dashboard/users': typeof DashboardUsersIndexRoute -} - -export interface FileRoutesById { - __root__: typeof rootRoute - '/': typeof IndexRoute - '/dashboard': typeof DashboardRouteRouteWithChildren - '/_auth': typeof AuthRouteWithChildren - '/_pathlessLayout': typeof PathlessLayoutRouteWithChildren - '/login': typeof LoginRoute - '/dashboard/invoices': typeof DashboardInvoicesRouteRouteWithChildren - '/dashboard/users': typeof DashboardUsersRouteRouteWithChildren - '/(this-folder-is-not-in-the-url)/route-group': typeof thisFolderIsNotInTheUrlRouteGroupRoute - '/_auth/profile': typeof AuthProfileRoute - '/_pathlessLayout/route-a': typeof PathlessLayoutRouteARoute - '/_pathlessLayout/route-b': typeof PathlessLayoutRouteBRoute - '/dashboard/': typeof DashboardIndexRoute - '/expensive/': typeof ExpensiveIndexRoute - '/dashboard/invoices/$invoiceId': typeof DashboardInvoicesInvoiceIdRoute - '/dashboard/users/user': typeof DashboardUsersUserRoute - '/dashboard/invoices/': typeof DashboardInvoicesIndexRoute - '/dashboard/users/': typeof DashboardUsersIndexRoute -} - -export interface FileRouteTypes { - fileRoutesByFullPath: FileRoutesByFullPath - fullPaths: - | '/' - | '/dashboard' - | '' - | '/login' - | '/dashboard/invoices' - | '/dashboard/users' - | '/route-group' - | '/profile' - | '/route-a' - | '/route-b' - | '/dashboard/' - | '/expensive' - | '/dashboard/invoices/$invoiceId' - | '/dashboard/users/user' - | '/dashboard/invoices/' - | '/dashboard/users/' - fileRoutesByTo: FileRoutesByTo - to: - | '/' - | '' - | '/login' - | '/route-group' - | '/profile' - | '/route-a' - | '/route-b' - | '/dashboard' - | '/expensive' - | '/dashboard/invoices/$invoiceId' - | '/dashboard/users/user' - | '/dashboard/invoices' - | '/dashboard/users' - id: - | '__root__' - | '/' - | '/dashboard' - | '/_auth' - | '/_pathlessLayout' - | '/login' - | '/dashboard/invoices' - | '/dashboard/users' - | '/(this-folder-is-not-in-the-url)/route-group' - | '/_auth/profile' - | '/_pathlessLayout/route-a' - | '/_pathlessLayout/route-b' - | '/dashboard/' - | '/expensive/' - | '/dashboard/invoices/$invoiceId' - | '/dashboard/users/user' - | '/dashboard/invoices/' - | '/dashboard/users/' - fileRoutesById: FileRoutesById -} - -export interface RootRouteChildren { - IndexRoute: typeof IndexRoute - DashboardRouteRoute: typeof DashboardRouteRouteWithChildren - AuthRoute: typeof AuthRouteWithChildren - PathlessLayoutRoute: typeof PathlessLayoutRouteWithChildren - LoginRoute: typeof LoginRoute - thisFolderIsNotInTheUrlRouteGroupRoute: typeof thisFolderIsNotInTheUrlRouteGroupRoute - ExpensiveIndexRoute: typeof ExpensiveIndexRoute -} - const rootRouteChildren: RootRouteChildren = { IndexRoute: IndexRoute, DashboardRouteRoute: DashboardRouteRouteWithChildren, @@ -462,107 +430,6 @@ const rootRouteChildren: RootRouteChildren = { thisFolderIsNotInTheUrlRouteGroupRoute, ExpensiveIndexRoute: ExpensiveIndexRoute, } - -export const routeTree = rootRoute +export const routeTree = rootRouteImport ._addFileChildren(rootRouteChildren) ._addFileTypes() - -/* ROUTE_MANIFEST_START -{ - "routes": { - "__root__": { - "filePath": "__root.tsx", - "children": [ - "/", - "/dashboard", - "/_auth", - "/_pathlessLayout", - "/login", - "/(this-folder-is-not-in-the-url)/route-group", - "/expensive/" - ] - }, - "/": { - "filePath": "index.tsx" - }, - "/dashboard": { - "filePath": "dashboard.route.tsx", - "children": [ - "/dashboard/invoices", - "/dashboard/users", - "/dashboard/" - ] - }, - "/_auth": { - "filePath": "_auth.tsx", - "children": [ - "/_auth/profile" - ] - }, - "/_pathlessLayout": { - "filePath": "_pathlessLayout.tsx", - "children": [ - "/_pathlessLayout/route-a", - "/_pathlessLayout/route-b" - ] - }, - "/login": { - "filePath": "login.tsx" - }, - "/dashboard/invoices": { - "filePath": "dashboard.invoices.route.tsx", - "parent": "/dashboard", - "children": [ - "/dashboard/invoices/$invoiceId", - "/dashboard/invoices/" - ] - }, - "/dashboard/users": { - "filePath": "dashboard.users.route.tsx", - "parent": "/dashboard", - "children": [ - "/dashboard/users/user", - "/dashboard/users/" - ] - }, - "/(this-folder-is-not-in-the-url)/route-group": { - "filePath": "(this-folder-is-not-in-the-url)/route-group.tsx" - }, - "/_auth/profile": { - "filePath": "_auth.profile.tsx", - "parent": "/_auth" - }, - "/_pathlessLayout/route-a": { - "filePath": "_pathlessLayout.route-a.tsx", - "parent": "/_pathlessLayout" - }, - "/_pathlessLayout/route-b": { - "filePath": "_pathlessLayout.route-b.tsx", - "parent": "/_pathlessLayout" - }, - "/dashboard/": { - "filePath": "dashboard.index.tsx", - "parent": "/dashboard" - }, - "/expensive/": { - "filePath": "expensive/index.tsx" - }, - "/dashboard/invoices/$invoiceId": { - "filePath": "dashboard.invoices.$invoiceId.tsx", - "parent": "/dashboard/invoices" - }, - "/dashboard/users/user": { - "filePath": "dashboard.users.user.tsx", - "parent": "/dashboard/users" - }, - "/dashboard/invoices/": { - "filePath": "dashboard.invoices.index.tsx", - "parent": "/dashboard/invoices" - }, - "/dashboard/users/": { - "filePath": "dashboard.users.index.tsx", - "parent": "/dashboard/users" - } - } -} -ROUTE_MANIFEST_END */ diff --git a/examples/solid/kitchen-sink-file-based/src/utils/auth.tsx b/examples/solid/kitchen-sink-file-based/src/utils/auth.tsx index b46954c565..53bd5ea810 100644 --- a/examples/solid/kitchen-sink-file-based/src/utils/auth.tsx +++ b/examples/solid/kitchen-sink-file-based/src/utils/auth.tsx @@ -1,18 +1,18 @@ -import { createStore } from 'solid-js/store' +import { createStore } from 'solid-js' export const [auth, setAuth] = createStore({ status: 'loggedOut', username: undefined, login: (username: string) => { - setAuth({ - status: 'loggedIn', - username, + setAuth((state) => { + state.status = 'loggedIn' + state.username = username }) }, logout: () => { - setAuth({ - status: 'loggedOut', - username: undefined, + setAuth((state) => { + state.status = 'loggedOut' + state.username = undefined }) }, }) diff --git a/examples/solid/kitchen-sink-solid-query-file-based/package.json b/examples/solid/kitchen-sink-solid-query-file-based/package.json index 4b4bb984da..1d2473a7d4 100644 --- a/examples/solid/kitchen-sink-solid-query-file-based/package.json +++ b/examples/solid/kitchen-sink-solid-query-file-based/package.json @@ -11,7 +11,7 @@ "dependencies": { "@solidjs/web": "2.0.0-beta.14", "@tailwindcss/vite": "^4.2.2", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "@tanstack/solid-query": "^6.0.0-beta.4", "@tanstack/solid-query-devtools": "^6.0.0-beta.4", "@tanstack/solid-router": "^2.0.0-beta.19", @@ -20,11 +20,11 @@ "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/kitchen-sink-solid-query/package.json b/examples/solid/kitchen-sink-solid-query/package.json index d8edcb58af..58e633f7a0 100644 --- a/examples/solid/kitchen-sink-solid-query/package.json +++ b/examples/solid/kitchen-sink-solid-query/package.json @@ -4,7 +4,7 @@ "type": "module", "scripts": { "dev": "vite --port 3000", - "build": "vite build", + "build": "vite build && tsc --noEmit", "preview": "vite preview", "start": "vite" }, @@ -19,11 +19,11 @@ "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/kitchen-sink-solid-query/src/main.tsx b/examples/solid/kitchen-sink-solid-query/src/main.tsx index aaca5b2091..97cdb1d73d 100644 --- a/examples/solid/kitchen-sink-solid-query/src/main.tsx +++ b/examples/solid/kitchen-sink-solid-query/src/main.tsx @@ -552,7 +552,6 @@ function UsersComponent() { const usersQuery = useQuery(() => usersQueryOptions(usersLayoutRoute.useLoaderDeps()()), ) - const users = usersQuery.data const sortBy = Solid.createMemo(() => search().usersView?.sortBy ?? 'name') const filterBy = Solid.createMemo(() => search().usersView?.filterBy) @@ -563,13 +562,12 @@ function UsersComponent() { }) const sortedUsers = Solid.createMemo(() => { - if (!users) return [] + const list = usersQuery.data + if (!list) return [] - return !sortBy - ? users - : [...users].sort((a: any, b: any) => { - return a[sortBy()] > b[sortBy()] ? 1 : -1 - }) + return [...list].sort((a: any, b: any) => { + return a[sortBy()] > b[sortBy()] ? 1 : -1 + }) }) const filteredUsers = Solid.createMemo(() => { @@ -607,7 +605,7 @@ function UsersComponent() { }, replace: true, }) - }, [filterDraft]) + }) return (
    @@ -805,11 +803,14 @@ function LoginComponent() { } // Ah, the subtle nuances of client side auth. 🙄 - Solid.createRenderEffect(() => { - if (routeContext().status === 'loggedIn' && search().redirect) { - router.history.push(search().redirect!) - } - }, [routeContext().status, search().redirect]) + Solid.createRenderEffect( + () => [routeContext().status, search().redirect] as const, + ([status, redirect]) => { + if (status === 'loggedIn' && redirect) { + router.history.push(redirect) + } + }, + ) return status === 'loggedIn' ? (
    diff --git a/examples/solid/kitchen-sink/package.json b/examples/solid/kitchen-sink/package.json index ad097ad6a8..49b43c2fcd 100644 --- a/examples/solid/kitchen-sink/package.json +++ b/examples/solid/kitchen-sink/package.json @@ -17,11 +17,11 @@ "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/large-file-based/package.json b/examples/solid/large-file-based/package.json index 1aabf61fbe..96ec7ae840 100644 --- a/examples/solid/large-file-based/package.json +++ b/examples/solid/large-file-based/package.json @@ -4,7 +4,7 @@ "type": "module", "scripts": { "dev": "vite --port 3000", - "build": "vite build", + "build": "vite build && tsc --noEmit", "preview": "vite preview", "start": "vite", "gen": "node ./src/createRoutes.mjs", @@ -13,18 +13,18 @@ "dependencies": { "@solidjs/web": "2.0.0-beta.14", "@tailwindcss/vite": "^4.2.2", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "@tanstack/solid-query": "^6.0.0-beta.4", "@tanstack/solid-router": "^2.0.0-beta.19", "@tanstack/solid-router-devtools": "^2.0.0-beta.15", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/location-masking/package.json b/examples/solid/location-masking/package.json index 12ec1a808b..84ae5a4817 100644 --- a/examples/solid/location-masking/package.json +++ b/examples/solid/location-masking/package.json @@ -4,7 +4,7 @@ "type": "module", "scripts": { "dev": "vite --port 3000", - "build": "vite build", + "build": "vite build && tsc --noEmit", "preview": "vite preview", "start": "vite" }, @@ -20,7 +20,7 @@ }, "devDependencies": { "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/navigation-blocking/package.json b/examples/solid/navigation-blocking/package.json index 488ce213ec..237c4d7de1 100644 --- a/examples/solid/navigation-blocking/package.json +++ b/examples/solid/navigation-blocking/package.json @@ -4,7 +4,7 @@ "type": "module", "scripts": { "dev": "vite --port 3000", - "build": "vite build", + "build": "vite build && tsc --noEmit", "preview": "vite preview", "start": "vite" }, @@ -20,7 +20,7 @@ }, "devDependencies": { "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/quickstart-esbuild-file-based/package.json b/examples/solid/quickstart-esbuild-file-based/package.json index f6400187f7..a845ab3263 100644 --- a/examples/solid/quickstart-esbuild-file-based/package.json +++ b/examples/solid/quickstart-esbuild-file-based/package.json @@ -10,13 +10,13 @@ }, "dependencies": { "@solidjs/web": "2.0.0-beta.14", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "@tanstack/solid-router": "^2.0.0-beta.19", "@tanstack/solid-router-devtools": "^2.0.0-beta.15", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "esbuild": "^0.27.4", diff --git a/examples/solid/quickstart-file-based/package.json b/examples/solid/quickstart-file-based/package.json index 20f48f3dc3..b4405922cc 100644 --- a/examples/solid/quickstart-file-based/package.json +++ b/examples/solid/quickstart-file-based/package.json @@ -16,12 +16,12 @@ "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/quickstart-rspack-file-based/package.json b/examples/solid/quickstart-rspack-file-based/package.json index 11e5bfa9f8..46e1418ad5 100644 --- a/examples/solid/quickstart-rspack-file-based/package.json +++ b/examples/solid/quickstart-rspack-file-based/package.json @@ -17,10 +17,10 @@ "tailwindcss": "^4.2.2" }, "devDependencies": { - "@rsbuild/core": "^1.2.4", - "@rsbuild/plugin-babel": "^1.0.6", - "@rsbuild/plugin-solid": "^1.0.6", - "@tanstack/router-plugin": "^1.167.12", + "@rsbuild/core": "^2.0.8", + "@rsbuild/plugin-babel": "^1.1.2", + "@rsbuild/plugin-solid": "^2.0.0-beta.0", + "@tanstack/router-plugin": "^1.168.13", "typescript": "^6.0.2" } } diff --git a/examples/solid/quickstart-webpack-file-based/package.json b/examples/solid/quickstart-webpack-file-based/package.json index e98f629c69..e7ddcec76a 100644 --- a/examples/solid/quickstart-webpack-file-based/package.json +++ b/examples/solid/quickstart-webpack-file-based/package.json @@ -16,7 +16,7 @@ "devDependencies": { "@babel/core": "^7.28.5", "@babel/preset-typescript": "^7.27.1", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "babel-loader": "^10.0.0", "babel-preset-solid": "2.0.0-beta.14", "css-loader": "^7.1.2", @@ -27,6 +27,6 @@ "typescript": "^6.0.2", "webpack": "^5.97.1", "webpack-cli": "^5.1.4", - "webpack-dev-server": "^5.2.0" + "webpack-dev-server": "^5.2.4" } } diff --git a/examples/solid/quickstart/package.json b/examples/solid/quickstart/package.json index 26467e99a4..0030db26fc 100644 --- a/examples/solid/quickstart/package.json +++ b/examples/solid/quickstart/package.json @@ -18,7 +18,7 @@ }, "devDependencies": { "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/router-monorepo-simple-lazy/package.json b/examples/solid/router-monorepo-simple-lazy/package.json index 0d1a9711e8..8651b519da 100644 --- a/examples/solid/router-monorepo-simple-lazy/package.json +++ b/examples/solid/router-monorepo-simple-lazy/package.json @@ -9,7 +9,7 @@ }, "dependencies": { "@solidjs/web": "2.0.0-beta.14", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "@tanstack/solid-router": "^2.0.0-beta.19", "@tanstack/solid-router-devtools": "^2.0.0-beta.15", "redaxios": "^0.5.1", @@ -18,7 +18,7 @@ "devDependencies": { "@types/node": "^22.7.4", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-dts": "^4.5.4", "vite-plugin-solid": "^3.0.0-next.5" }, diff --git a/examples/solid/router-monorepo-simple-lazy/packages/app/package.json b/examples/solid/router-monorepo-simple-lazy/packages/app/package.json index c3730822a7..db25061aed 100644 --- a/examples/solid/router-monorepo-simple-lazy/packages/app/package.json +++ b/examples/solid/router-monorepo-simple-lazy/packages/app/package.json @@ -21,7 +21,7 @@ "typescript": "^6.0.2", "@tanstack/solid-router-devtools": "^2.0.0-beta.15", "tailwindcss": "^4.2.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-dts": "^4.5.4", "@tailwindcss/vite": "^4.2.2" }, diff --git a/examples/solid/router-monorepo-simple-lazy/packages/post-feature/package.json b/examples/solid/router-monorepo-simple-lazy/packages/post-feature/package.json index 52429f909f..2865d36e98 100644 --- a/examples/solid/router-monorepo-simple-lazy/packages/post-feature/package.json +++ b/examples/solid/router-monorepo-simple-lazy/packages/post-feature/package.json @@ -24,7 +24,7 @@ "devDependencies": { "vite-plugin-solid": "^3.0.0-next.5", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-dts": "^4.5.4" } } diff --git a/examples/solid/router-monorepo-simple-lazy/packages/router/package.json b/examples/solid/router-monorepo-simple-lazy/packages/router/package.json index 748f7aa878..64119996f2 100644 --- a/examples/solid/router-monorepo-simple-lazy/packages/router/package.json +++ b/examples/solid/router-monorepo-simple-lazy/packages/router/package.json @@ -8,18 +8,18 @@ "main": "./dist/index.js", "types": "./dist/index.d.ts", "dependencies": { - "@tanstack/history": "^1.161.6", + "@tanstack/history": "^1.162.0", "@tanstack/solid-router": "^2.0.0-beta.19", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "redaxios": "^0.5.1", - "zod": "^3.24.2", + "zod": "^4.4.3", "solid-js": "2.0.0-beta.14", "@solidjs/web": "2.0.0-beta.14" }, "devDependencies": { "vite-plugin-solid": "^3.0.0-next.5", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-dts": "^4.5.4" } } diff --git a/examples/solid/router-monorepo-simple/package.json b/examples/solid/router-monorepo-simple/package.json index c87bcee38c..1934328a4f 100644 --- a/examples/solid/router-monorepo-simple/package.json +++ b/examples/solid/router-monorepo-simple/package.json @@ -9,7 +9,7 @@ }, "dependencies": { "@solidjs/web": "2.0.0-beta.14", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "@tanstack/solid-router": "^2.0.0-beta.19", "@tanstack/solid-router-devtools": "^2.0.0-beta.15", "redaxios": "^0.5.1", @@ -18,7 +18,7 @@ "devDependencies": { "@types/node": "^22.7.4", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-dts": "^4.5.4", "vite-plugin-solid": "^3.0.0-next.5" }, diff --git a/examples/solid/router-monorepo-simple/packages/app/package.json b/examples/solid/router-monorepo-simple/packages/app/package.json index 738a2584c3..868d8f108e 100644 --- a/examples/solid/router-monorepo-simple/packages/app/package.json +++ b/examples/solid/router-monorepo-simple/packages/app/package.json @@ -18,7 +18,7 @@ "vite-plugin-solid": "^3.0.0-next.5", "typescript": "^6.0.2", "@tanstack/solid-router-devtools": "^2.0.0-beta.15", - "vite": "^8.0.0", + "vite": "^8.0.14", "tailwindcss": "^4.2.2", "vite-plugin-dts": "^4.5.4", "@tailwindcss/vite": "^4.2.2" diff --git a/examples/solid/router-monorepo-simple/packages/post-feature/package.json b/examples/solid/router-monorepo-simple/packages/post-feature/package.json index 36a11e284a..faeb9ad93e 100644 --- a/examples/solid/router-monorepo-simple/packages/post-feature/package.json +++ b/examples/solid/router-monorepo-simple/packages/post-feature/package.json @@ -15,7 +15,7 @@ "devDependencies": { "vite-plugin-solid": "^3.0.0-next.5", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-dts": "^4.5.4" } } diff --git a/examples/solid/router-monorepo-simple/packages/router/package.json b/examples/solid/router-monorepo-simple/packages/router/package.json index 2ae9e14d5d..1b5c71c1d0 100644 --- a/examples/solid/router-monorepo-simple/packages/router/package.json +++ b/examples/solid/router-monorepo-simple/packages/router/package.json @@ -8,18 +8,18 @@ "main": "./dist/index.js", "types": "./dist/index.d.ts", "dependencies": { - "@tanstack/history": "^1.161.6", + "@tanstack/history": "^1.162.0", "@tanstack/solid-router": "^2.0.0-beta.19", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "redaxios": "^0.5.1", - "zod": "^3.24.2", + "zod": "^4.4.3", "solid-js": "2.0.0-beta.14", "@solidjs/web": "2.0.0-beta.14" }, "devDependencies": { "vite-plugin-solid": "^3.0.0-next.5", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-dts": "^4.5.4" } } diff --git a/examples/solid/router-monorepo-solid-query/package.json b/examples/solid/router-monorepo-solid-query/package.json index fbad27114c..ad58231aab 100644 --- a/examples/solid/router-monorepo-solid-query/package.json +++ b/examples/solid/router-monorepo-solid-query/package.json @@ -11,7 +11,7 @@ }, "dependencies": { "@solidjs/web": "2.0.0-beta.14", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "@tanstack/solid-query": "^6.0.0-beta.4", "@tanstack/solid-query-devtools": "^6.0.0-beta.4", "@tanstack/solid-router": "^2.0.0-beta.19", @@ -22,7 +22,7 @@ "devDependencies": { "@types/node": "^22.10.2", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-dts": "^4.5.4", "vite-plugin-solid": "^3.0.0-next.5" }, diff --git a/examples/solid/router-monorepo-solid-query/packages/app/package.json b/examples/solid/router-monorepo-solid-query/packages/app/package.json index 88f05573fe..e8ffcfb0f6 100644 --- a/examples/solid/router-monorepo-solid-query/packages/app/package.json +++ b/examples/solid/router-monorepo-solid-query/packages/app/package.json @@ -20,7 +20,7 @@ "typescript": "^6.0.2", "@tanstack/solid-router-devtools": "^2.0.0-beta.15", "tailwindcss": "^4.2.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-dts": "^4.5.4", "@tailwindcss/vite": "^4.2.2" }, diff --git a/examples/solid/router-monorepo-solid-query/packages/post-feature/package.json b/examples/solid/router-monorepo-solid-query/packages/post-feature/package.json index bc265d5932..ecdb1fe1d3 100644 --- a/examples/solid/router-monorepo-solid-query/packages/post-feature/package.json +++ b/examples/solid/router-monorepo-solid-query/packages/post-feature/package.json @@ -17,7 +17,7 @@ "devDependencies": { "vite-plugin-solid": "^3.0.0-next.5", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-dts": "^4.5.4" } } diff --git a/examples/solid/router-monorepo-solid-query/packages/post-query/package.json b/examples/solid/router-monorepo-solid-query/packages/post-query/package.json index 7386f9ece0..13658cfb6c 100644 --- a/examples/solid/router-monorepo-solid-query/packages/post-query/package.json +++ b/examples/solid/router-monorepo-solid-query/packages/post-query/package.json @@ -10,11 +10,11 @@ "dependencies": { "@tanstack/solid-query": "^6.0.0-beta.4", "redaxios": "^0.5.1", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "vite-plugin-solid": "^3.0.0-next.5", "typescript": "^6.0.2", - "vite": "^8.0.0" + "vite": "^8.0.14" } } diff --git a/examples/solid/router-monorepo-solid-query/packages/router/package.json b/examples/solid/router-monorepo-solid-query/packages/router/package.json index b567736b7e..1cbceccaed 100644 --- a/examples/solid/router-monorepo-solid-query/packages/router/package.json +++ b/examples/solid/router-monorepo-solid-query/packages/router/package.json @@ -8,20 +8,20 @@ "main": "./dist/index.js", "types": "./dist/index.d.ts", "dependencies": { - "@tanstack/history": "^1.161.6", + "@tanstack/history": "^1.162.0", "@tanstack/solid-query": "^6.0.0-beta.4", "@tanstack/solid-router": "^2.0.0-beta.19", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "@router-solid-mono-solid-query/post-query": "workspace:*", "redaxios": "^0.5.1", - "zod": "^3.24.2", + "zod": "^4.4.3", "solid-js": "2.0.0-beta.14", "@solidjs/web": "2.0.0-beta.14" }, "devDependencies": { "vite-plugin-solid": "^3.0.0-next.5", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-dts": "^4.5.4" } } diff --git a/examples/solid/scroll-restoration/package.json b/examples/solid/scroll-restoration/package.json index 8f52fe4613..8cc6c35293 100644 --- a/examples/solid/scroll-restoration/package.json +++ b/examples/solid/scroll-restoration/package.json @@ -4,7 +4,7 @@ "type": "module", "scripts": { "dev": "vite --port 3000", - "build": "echo 'Skipped: waiting for dependency Solid 2.0 support' && exit 0", + "build": "vite build && tsc --noEmit", "preview": "vite preview", "start": "vite" }, @@ -19,7 +19,7 @@ }, "devDependencies": { "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/search-validator-adapters/package.json b/examples/solid/search-validator-adapters/package.json index 27b05195e0..cd814e9f03 100644 --- a/examples/solid/search-validator-adapters/package.json +++ b/examples/solid/search-validator-adapters/package.json @@ -4,7 +4,7 @@ "type": "module", "scripts": { "dev": "vite --port 3000", - "build": "vite build && tsc --noEmit", + "build": "vite build && NODE_OPTIONS=--max-old-space-size=4096 tsc --noEmit", "preview": "vite preview", "start": "vite", "test:unit": "vitest" @@ -12,13 +12,13 @@ "dependencies": { "@solidjs/web": "2.0.0-beta.14", "@tailwindcss/vite": "^4.2.2", - "@tanstack/arktype-adapter": "^1.166.9", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/arktype-adapter": "^1.167.0", + "@tanstack/router-plugin": "^1.168.13", "@tanstack/solid-query": "^6.0.0-beta.4", "@tanstack/solid-router": "^2.0.0-beta.19", "@tanstack/solid-router-devtools": "^2.0.0-beta.15", - "@tanstack/valibot-adapter": "^1.166.9", - "@tanstack/zod-adapter": "^1.166.9", + "@tanstack/valibot-adapter": "^1.167.0", + "@tanstack/zod-adapter": "^1.167.0", "arktype": "^2.1.7", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", @@ -29,7 +29,7 @@ "@solidjs/testing-library": "^0.8.10", "@testing-library/jest-dom": "^6.6.3", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/search-validator-adapters/src/routeTree.gen.ts b/examples/solid/search-validator-adapters/src/routeTree.gen.ts index d7aab61324..24089ece84 100644 --- a/examples/solid/search-validator-adapters/src/routeTree.gen.ts +++ b/examples/solid/search-validator-adapters/src/routeTree.gen.ts @@ -8,8 +8,6 @@ // You should NOT make any changes in this file as it will be overwritten. // Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. -import type { CreateFileRoute, FileRoutesByPath } from '@tanstack/solid-router' - import { Route as rootRouteImport } from './routes/__root' import { Route as IndexRouteImport } from './routes/index' import { Route as UsersZodIndexRouteImport } from './routes/users/zod.index' @@ -104,43 +102,6 @@ declare module '@tanstack/solid-router' { } } -declare module './routes/index' { - const createFileRoute: CreateFileRoute< - '/', - FileRoutesByPath['/']['parentRoute'], - FileRoutesByPath['/']['id'], - FileRoutesByPath['/']['path'], - FileRoutesByPath['/']['fullPath'] - > -} -declare module './routes/users/arktype.index' { - const createFileRoute: CreateFileRoute< - '/users/arktype/', - FileRoutesByPath['/users/arktype/']['parentRoute'], - FileRoutesByPath['/users/arktype/']['id'], - FileRoutesByPath['/users/arktype/']['path'], - FileRoutesByPath['/users/arktype/']['fullPath'] - > -} -declare module './routes/users/valibot.index' { - const createFileRoute: CreateFileRoute< - '/users/valibot/', - FileRoutesByPath['/users/valibot/']['parentRoute'], - FileRoutesByPath['/users/valibot/']['id'], - FileRoutesByPath['/users/valibot/']['path'], - FileRoutesByPath['/users/valibot/']['fullPath'] - > -} -declare module './routes/users/zod.index' { - const createFileRoute: CreateFileRoute< - '/users/zod/', - FileRoutesByPath['/users/zod/']['parentRoute'], - FileRoutesByPath['/users/zod/']['id'], - FileRoutesByPath['/users/zod/']['path'], - FileRoutesByPath['/users/zod/']['fullPath'] - > -} - const rootRouteChildren: RootRouteChildren = { IndexRoute: IndexRoute, UsersArktypeIndexRoute: UsersArktypeIndexRoute, diff --git a/examples/solid/search-validator-adapters/src/routes/index.tsx b/examples/solid/search-validator-adapters/src/routes/index.tsx index 9a47bda715..33041cecaf 100644 --- a/examples/solid/search-validator-adapters/src/routes/index.tsx +++ b/examples/solid/search-validator-adapters/src/routes/index.tsx @@ -1,3 +1,4 @@ +import { createFileRoute } from '@tanstack/solid-router' import { Header } from '../components/Header' import { Content } from '../components/Content' @@ -10,6 +11,6 @@ export const Index = () => { ) } -export const Route = createFileRoute({ +export const Route = createFileRoute('/')({ component: Index, }) diff --git a/examples/solid/search-validator-adapters/src/routes/users/arktype.index.tsx b/examples/solid/search-validator-adapters/src/routes/users/arktype.index.tsx index 1a1c8cd9e6..0c8e94c3d8 100644 --- a/examples/solid/search-validator-adapters/src/routes/users/arktype.index.tsx +++ b/examples/solid/search-validator-adapters/src/routes/users/arktype.index.tsx @@ -1,4 +1,4 @@ -import { useNavigate } from '@tanstack/solid-router' +import { useNavigate, createFileRoute } from '@tanstack/solid-router' import { type } from 'arktype' import { Loading } from 'solid-js' import { Header } from '../../components/Header' @@ -30,7 +30,7 @@ const search = type({ search: 'string = ""', }) -export const Route = createFileRoute({ +export const Route = createFileRoute('/users/arktype/')({ validateSearch: search, loaderDeps: (opt) => ({ search: opt.search }), loader: (opt) => { diff --git a/examples/solid/search-validator-adapters/src/routes/users/valibot.index.tsx b/examples/solid/search-validator-adapters/src/routes/users/valibot.index.tsx index feecf4470b..89d0455bcc 100644 --- a/examples/solid/search-validator-adapters/src/routes/users/valibot.index.tsx +++ b/examples/solid/search-validator-adapters/src/routes/users/valibot.index.tsx @@ -1,4 +1,4 @@ -import { useNavigate } from '@tanstack/solid-router' +import { useNavigate, createFileRoute } from '@tanstack/solid-router' import * as v from 'valibot' import { Loading } from 'solid-js' import { Header } from '../../components/Header' @@ -26,7 +26,7 @@ const Valibot = () => { ) } -export const Route = createFileRoute({ +export const Route = createFileRoute('/users/valibot/')({ validateSearch: v.object({ search: v.fallback(v.optional(v.string(), ''), ''), }), diff --git a/examples/solid/search-validator-adapters/src/routes/users/zod.index.tsx b/examples/solid/search-validator-adapters/src/routes/users/zod.index.tsx index 44dcf5c80b..43754c541d 100644 --- a/examples/solid/search-validator-adapters/src/routes/users/zod.index.tsx +++ b/examples/solid/search-validator-adapters/src/routes/users/zod.index.tsx @@ -1,4 +1,4 @@ -import { useNavigate } from '@tanstack/solid-router' +import { useNavigate, createFileRoute } from '@tanstack/solid-router' import { fallback, zodValidator } from '@tanstack/zod-adapter' import { z } from 'zod' import { Loading } from 'solid-js' @@ -7,6 +7,11 @@ import { Users, usersQueryOptions } from '../../components/Users' import { Content } from '../../components/Content' import { Search } from '../../components/Search' +const fallbackString = fallback as unknown as ( + schema: z.ZodString, + fallback: string, +) => z.ZodType + const Zod = () => { const search = Route.useSearch({ select: (search) => search.search ?? '', @@ -29,10 +34,10 @@ const Zod = () => { ) } -export const Route = createFileRoute({ +export const Route = createFileRoute('/users/zod/')({ validateSearch: zodValidator( z.object({ - search: fallback(z.string().optional(), undefined), + search: fallbackString(z.string(), '').default(''), }), ), loaderDeps: (opt) => ({ search: opt.search }), diff --git a/examples/solid/search-validator-adapters/vite.config.ts b/examples/solid/search-validator-adapters/vite.config.ts index 75a6d85b3f..abb9d36cdf 100644 --- a/examples/solid/search-validator-adapters/vite.config.ts +++ b/examples/solid/search-validator-adapters/vite.config.ts @@ -31,7 +31,6 @@ export default defineConfig({ tanstackRouter({ target: 'solid', autoCodeSplitting: true, - verboseFileRoutes: false, }), solid(), ], diff --git a/examples/solid/start-basic-auth/package.json b/examples/solid/start-basic-auth/package.json index 2451877114..c85702e8c3 100644 --- a/examples/solid/start-basic-auth/package.json +++ b/examples/solid/start-basic-auth/package.json @@ -20,7 +20,7 @@ "@tanstack/solid-start": "^2.0.0-beta.20", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", - "tailwind-merge": "^2.6.0" + "tailwind-merge": "^3.6.0" }, "devDependencies": { "@tailwindcss/vite": "^4.2.2", @@ -29,7 +29,7 @@ "prisma": "^7.0.0", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5", "vite-tsconfig-paths": "^5.1.4" } diff --git a/examples/solid/start-basic-authjs/package.json b/examples/solid/start-basic-authjs/package.json index 87e0497879..d9d34826a2 100644 --- a/examples/solid/start-basic-authjs/package.json +++ b/examples/solid/start-basic-authjs/package.json @@ -17,14 +17,14 @@ "@tanstack/solid-start": "^2.0.0-beta.20", "solid-js": "2.0.0-beta.14", "start-authjs": "^1.0.0", - "tailwind-merge": "^2.6.0" + "tailwind-merge": "^3.6.0" }, "devDependencies": { "@tailwindcss/vite": "^4.2.2", "@types/node": "^22.5.4", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5", "vite-tsconfig-paths": "^5.1.4" } diff --git a/examples/solid/start-basic-cloudflare/package.json b/examples/solid/start-basic-cloudflare/package.json index cd581411b6..2cfb22e13b 100644 --- a/examples/solid/start-basic-cloudflare/package.json +++ b/examples/solid/start-basic-cloudflare/package.json @@ -24,7 +24,7 @@ "@types/node": "^22.5.4", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5", "vite-tsconfig-paths": "^5.1.4", "wrangler": "^4.74.0" diff --git a/examples/solid/start-basic-netlify/package.json b/examples/solid/start-basic-netlify/package.json index 44ef09efe8..1fc4a7033f 100644 --- a/examples/solid/start-basic-netlify/package.json +++ b/examples/solid/start-basic-netlify/package.json @@ -21,7 +21,7 @@ "@types/node": "^22.5.4", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5", "vite-tsconfig-paths": "^5.1.4" } diff --git a/examples/solid/start-basic-nitro/package.json b/examples/solid/start-basic-nitro/package.json index d6386897db..552bd90315 100644 --- a/examples/solid/start-basic-nitro/package.json +++ b/examples/solid/start-basic-nitro/package.json @@ -21,7 +21,7 @@ "nitro": "^3.0.260311-beta", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5", "vite-tsconfig-paths": "^5.1.4" } diff --git a/examples/solid/start-basic-solid-query/package.json b/examples/solid/start-basic-solid-query/package.json index 4f5fb498c5..8eb7d5718a 100644 --- a/examples/solid/start-basic-solid-query/package.json +++ b/examples/solid/start-basic-solid-query/package.json @@ -5,7 +5,7 @@ "type": "module", "scripts": { "dev": "vite dev", - "build": "vite build", + "build": "vite build && tsc --noEmit", "preview": "vite preview", "start": "pnpx srvx --prod -s ../client dist/server/server.js" }, @@ -19,14 +19,14 @@ "@tanstack/solid-start": "^2.0.0-beta.20", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", - "tailwind-merge": "^2.6.0" + "tailwind-merge": "^3.6.0" }, "devDependencies": { "@tailwindcss/vite": "^4.2.2", "@types/node": "^22.5.4", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5", "vite-tsconfig-paths": "^5.1.4" } diff --git a/examples/solid/start-basic-static/package.json b/examples/solid/start-basic-static/package.json index 4a8c449c73..27984131b6 100644 --- a/examples/solid/start-basic-static/package.json +++ b/examples/solid/start-basic-static/package.json @@ -14,17 +14,17 @@ "@tanstack/solid-router": "^2.0.0-beta.19", "@tanstack/solid-router-devtools": "^2.0.0-beta.15", "@tanstack/solid-start": "^2.0.0-beta.20", - "@tanstack/start-static-server-functions": "^1.166.25", + "@tanstack/start-static-server-functions": "^1.167.11", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", - "tailwind-merge": "^2.6.0" + "tailwind-merge": "^3.6.0" }, "devDependencies": { "@tailwindcss/vite": "^4.2.2", "@types/node": "^22.5.4", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5", "vite-tsconfig-paths": "^5.1.3" } diff --git a/examples/solid/start-basic/package.json b/examples/solid/start-basic/package.json index 157ebfef5c..30d2b8af55 100644 --- a/examples/solid/start-basic/package.json +++ b/examples/solid/start-basic/package.json @@ -16,7 +16,7 @@ "@tanstack/solid-start": "^2.0.0-beta.20", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", - "tailwind-merge": "^2.6.0" + "tailwind-merge": "^3.6.0" }, "devDependencies": { "@tailwindcss/vite": "^4.2.2", @@ -24,7 +24,7 @@ "nitro": "^3.0.260311-beta", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5", "vite-tsconfig-paths": "^5.1.4" } diff --git a/examples/solid/start-bun/package.json b/examples/solid/start-bun/package.json index 1cb54788af..ea44da634f 100644 --- a/examples/solid/start-bun/package.json +++ b/examples/solid/start-bun/package.json @@ -5,7 +5,7 @@ "scripts": { "dev": "vite dev --port 3000", "start": "bun run server.ts", - "build": "echo 'Skipped: waiting for dependency Solid 2.0 support' && exit 0", + "build": "vite build", "preview": "vite preview", "test": "vitest run", "lint": "eslint", @@ -15,7 +15,7 @@ "dependencies": { "@solidjs/web": "2.0.0-beta.14", "@tailwindcss/vite": "^4.2.2", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "@tanstack/solid-devtools": "^0.7.0", "@tanstack/solid-router": "^2.0.0-beta.19", "@tanstack/solid-router-devtools": "^2.0.0-beta.15", @@ -33,9 +33,9 @@ "jsdom": "^27.0.0", "prettier": "^3.6.2", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5", - "vitest": "^3.2.4", + "vitest": "^4.1.4", "web-vitals": "^5.1.0" } } diff --git a/examples/solid/start-convex-better-auth/package.json b/examples/solid/start-convex-better-auth/package.json index 6f36cf6367..31a4aa107a 100644 --- a/examples/solid/start-convex-better-auth/package.json +++ b/examples/solid/start-convex-better-auth/package.json @@ -6,7 +6,7 @@ "scripts": { "dev": "vite dev", "convex:dev": "convex dev", - "build": "echo 'Skipped: waiting for dependency Solid 2.0 support' && exit 0", + "build": "vite build && tsc --noEmit", "preview": "vite preview", "start": "pnpx srvx --prod -s ../client dist/server/server.js" }, @@ -23,15 +23,15 @@ "convex-solidjs": "^0.0.3", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", - "tailwind-merge": "^2.6.0", + "tailwind-merge": "^3.6.0", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@types/node": "^22.10.2", "combinate": "^1.1.11", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5", "vite-tsconfig-paths": "^5.1.4" } diff --git a/examples/solid/start-convex-better-auth/src/library/convex-client.ts b/examples/solid/start-convex-better-auth/src/library/convex-client.ts index 4f60bbdbfd..90dfd5ee28 100644 --- a/examples/solid/start-convex-better-auth/src/library/convex-client.ts +++ b/examples/solid/start-convex-better-auth/src/library/convex-client.ts @@ -3,7 +3,7 @@ import { fetchAuth } from '~/library/server' const CONVEX_URL = import.meta.env.VITE_CONVEX_URL if (!CONVEX_URL) { - console.error('missing envar CONVEX_URL') + throw new Error('missing envar CONVEX_URL') } // Set up Convex client with auth diff --git a/examples/solid/start-convex-better-auth/src/routes/__root.tsx b/examples/solid/start-convex-better-auth/src/routes/__root.tsx index e912968b27..a76b70120c 100644 --- a/examples/solid/start-convex-better-auth/src/routes/__root.tsx +++ b/examples/solid/start-convex-better-auth/src/routes/__root.tsx @@ -1,6 +1,6 @@ /// import { HeadContent, Scripts, createRootRoute } from '@tanstack/solid-router' -import { Suspense } from '@solidjs/web' +import { Loading } from '@solidjs/web' import { TanStackRouterDevtools } from '@tanstack/solid-router-devtools' import type { JSX } from '@solidjs/web' import appCss from '~/styles/app.css?url' @@ -25,9 +25,9 @@ function RootDocument(props: { children: JSX.Element }) { - + {props.children} - + diff --git a/examples/solid/start-counter/package.json b/examples/solid/start-counter/package.json index 56efc4d4a9..a594a0b300 100644 --- a/examples/solid/start-counter/package.json +++ b/examples/solid/start-counter/package.json @@ -16,14 +16,14 @@ "@tanstack/solid-start": "^2.0.0-beta.20", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", - "tailwind-merge": "^2.6.0", - "zod": "^3.24.2" + "tailwind-merge": "^3.6.0", + "zod": "^4.4.3" }, "devDependencies": { "@types/node": "^22.10.2", "combinate": "^1.1.11", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/start-i18n-paraglide/package.json b/examples/solid/start-i18n-paraglide/package.json index 7707222b4f..e60f55f6e3 100644 --- a/examples/solid/start-i18n-paraglide/package.json +++ b/examples/solid/start-i18n-paraglide/package.json @@ -5,7 +5,7 @@ "scripts": { "dev": "vite dev --port 3000", "start": "node .output/server/index.mjs", - "build": "echo 'Skipped: waiting for dependency Solid 2.0 support' && exit 0", + "build": "vite build", "preview": "vite preview" }, "dependencies": { @@ -22,7 +22,7 @@ "@types/node": "^22.18.6", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/start-large/package.json b/examples/solid/start-large/package.json index 6c82874f8e..792154c572 100644 --- a/examples/solid/start-large/package.json +++ b/examples/solid/start-large/package.json @@ -5,7 +5,7 @@ "type": "module", "scripts": { "dev": "vite dev", - "build": "vite build", + "build": "vite build && tsc --noEmit", "preview": "vite preview", "start": "pnpx srvx --prod -s ../client dist/server/server.js", "gen": "node ./src/createRoutes.mjs", @@ -19,7 +19,7 @@ "@tanstack/solid-start": "^2.0.0-beta.20", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", - "tailwind-merge": "^2.6.0", + "tailwind-merge": "^3.6.0", "valibot": "^1.0.0-beta.15" }, "devDependencies": { @@ -27,7 +27,7 @@ "@types/node": "^22.5.4", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" }, "keywords": [], diff --git a/examples/solid/start-streaming-data-from-server-functions/package.json b/examples/solid/start-streaming-data-from-server-functions/package.json index c1ad1ba5fb..f9df4baf38 100644 --- a/examples/solid/start-streaming-data-from-server-functions/package.json +++ b/examples/solid/start-streaming-data-from-server-functions/package.json @@ -15,12 +15,12 @@ "@tanstack/solid-router-devtools": "^2.0.0-beta.15", "@tanstack/solid-start": "^2.0.0-beta.20", "solid-js": "2.0.0-beta.14", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@types/node": "^22.5.4", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/start-supabase-basic/package.json b/examples/solid/start-supabase-basic/package.json index ed5735ef5f..20bc6517e1 100644 --- a/examples/solid/start-supabase-basic/package.json +++ b/examples/solid/start-supabase-basic/package.json @@ -26,7 +26,7 @@ "@types/node": "^22.5.4", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5", "vite-tsconfig-paths": "^5.1.4" } diff --git a/examples/solid/start-tailwind-v4/package.json b/examples/solid/start-tailwind-v4/package.json index c51c86af0a..81a4036948 100644 --- a/examples/solid/start-tailwind-v4/package.json +++ b/examples/solid/start-tailwind-v4/package.json @@ -15,15 +15,15 @@ "@tanstack/solid-router-devtools": "^2.0.0-beta.15", "@tanstack/solid-start": "^2.0.0-beta.20", "solid-js": "2.0.0-beta.14", - "tailwind-merge": "^2.6.0", - "zod": "^3.24.2" + "tailwind-merge": "^3.6.0", + "zod": "^4.4.3" }, "devDependencies": { "@tailwindcss/vite": "^4.2.2", "@types/node": "^22.5.4", "tailwindcss": "^4.2.2", "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5", "vite-tsconfig-paths": "^5.1.4" } diff --git a/examples/solid/view-transitions/package.json b/examples/solid/view-transitions/package.json index f566ff8063..bd433fb2d6 100644 --- a/examples/solid/view-transitions/package.json +++ b/examples/solid/view-transitions/package.json @@ -11,17 +11,17 @@ "dependencies": { "@solidjs/web": "2.0.0-beta.14", "@tailwindcss/vite": "^4.2.2", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "@tanstack/solid-router": "^2.0.0-beta.19", "@tanstack/solid-router-devtools": "^2.0.0-beta.15", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/with-framer-motion/package.json b/examples/solid/with-framer-motion/package.json index f6c0dedd5f..613c921b67 100644 --- a/examples/solid/with-framer-motion/package.json +++ b/examples/solid/with-framer-motion/package.json @@ -4,7 +4,7 @@ "type": "module", "scripts": { "dev": "vite --port 3000", - "build": "echo 'Skipped: waiting for dependency Solid 2.0 support' && exit 0", + "build": "vite build && tsc --noEmit", "preview": "vite preview", "start": "vite" }, @@ -17,11 +17,11 @@ "solid-js": "2.0.0-beta.14", "solid-motionone": "^1.0.4", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/with-trpc/package.json b/examples/solid/with-trpc/package.json index 870e0b7563..9a4a6b6c33 100644 --- a/examples/solid/with-trpc/package.json +++ b/examples/solid/with-trpc/package.json @@ -12,21 +12,21 @@ "dependencies": { "@solidjs/web": "2.0.0-beta.14", "@tailwindcss/vite": "^4.2.2", - "@tanstack/router-plugin": "^1.167.12", + "@tanstack/router-plugin": "^1.168.13", "@tanstack/solid-router": "^2.0.0-beta.19", "@tanstack/solid-router-devtools": "^2.0.0-beta.15", "@trpc/client": "^11.4.3", "@trpc/server": "^11.4.3", - "express": "^4.21.2", + "express": "^5.2.1", "redaxios": "^0.5.1", "solid-js": "2.0.0-beta.14", "tailwindcss": "^4.2.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { - "@types/express": "^4.17.23", + "@types/express": "^5.0.6", "tsx": "^4.20.3", - "vite": "^8.0.0", + "vite": "^8.0.14", "vite-plugin-solid": "^3.0.0-next.5" } } diff --git a/examples/solid/with-trpc/src/server/server.ts b/examples/solid/with-trpc/src/server/server.ts index b2b3fd2485..0a580d4963 100644 --- a/examples/solid/with-trpc/src/server/server.ts +++ b/examples/solid/with-trpc/src/server/server.ts @@ -50,7 +50,7 @@ export const createServer = async ( app.use(viteServer.middlewares) // Handle any requests that don't match an API route by serving the React app's index.html - app.get('*', async (req, res, next) => { + app.get('/{*splat}', async (req, res, next) => { try { let html = fs.readFileSync(path.resolve(root, 'index.html'), 'utf-8') @@ -68,7 +68,7 @@ export const createServer = async ( app.use(express.static(path.resolve(__dirname, '../client'))) // Handle any requests that don't match an API route by serving the React app's index.html - app.get('*', (req, res) => { + app.get('/{*splat}', (req, res) => { res.sendFile(path.resolve(__dirname, '../client', 'index.html')) }) } @@ -78,7 +78,8 @@ export const createServer = async ( if (!isTest) { createServer().then(({ app }) => - app.listen(PORT, () => { + app.listen(PORT, (error) => { + if (error) throw error console.info(`Server available at: http://localhost:${PORT}`) }), ) diff --git a/examples/vue/basic-file-based-jsx/package.json b/examples/vue/basic-file-based-jsx/package.json index 7bb468ea33..75584b4204 100644 --- a/examples/vue/basic-file-based-jsx/package.json +++ b/examples/vue/basic-file-based-jsx/package.json @@ -10,14 +10,13 @@ }, "dependencies": { "@tailwindcss/vite": "^4.2.2", - "@tanstack/router-plugin": "^1.167.12", - "@tanstack/vue-router": "^1.168.9", - "@tanstack/vue-router-devtools": "^1.166.11", - "@tanstack/zod-adapter": "^1.166.9", + "@tanstack/router-plugin": "^1.168.13", + "@tanstack/vue-router": "^1.170.10", + "@tanstack/vue-router-devtools": "^1.167.0", "redaxios": "^0.5.1", "tailwindcss": "^4.2.2", "vue": "^3.5.16", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@eslint/js": "^9.36.0", @@ -27,7 +26,7 @@ "@vitejs/plugin-vue-jsx": "^5.1.5", "eslint-plugin-vue": "^9.33.0", "typescript": "~5.8.3", - "vite": "^8.0.0", + "vite": "^8.0.14", "vue-eslint-parser": "^9.4.3", "vue-tsc": "^3.1.5" } diff --git a/examples/vue/basic-file-based-jsx/src/routes/(another-group)/onlyrouteinside.tsx b/examples/vue/basic-file-based-jsx/src/routes/(another-group)/onlyrouteinside.tsx index 83036509ba..727c1b4d94 100644 --- a/examples/vue/basic-file-based-jsx/src/routes/(another-group)/onlyrouteinside.tsx +++ b/examples/vue/basic-file-based-jsx/src/routes/(another-group)/onlyrouteinside.tsx @@ -1,9 +1,8 @@ import { createFileRoute, getRouteApi, useSearch } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(another-group)/onlyrouteinside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), component: OnlyRouteInsideComponent, }) diff --git a/examples/vue/basic-file-based-jsx/src/routes/(group)/_layout.insidelayout.tsx b/examples/vue/basic-file-based-jsx/src/routes/(group)/_layout.insidelayout.tsx index 557503a0c2..4b239f3ef4 100644 --- a/examples/vue/basic-file-based-jsx/src/routes/(group)/_layout.insidelayout.tsx +++ b/examples/vue/basic-file-based-jsx/src/routes/(group)/_layout.insidelayout.tsx @@ -1,9 +1,8 @@ import { createFileRoute, getRouteApi, useSearch } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(group)/_layout/insidelayout')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), component: InsideLayoutComponent, }) diff --git a/examples/vue/basic-file-based-jsx/src/routes/(group)/inside.tsx b/examples/vue/basic-file-based-jsx/src/routes/(group)/inside.tsx index bec12d8de2..f12ca517d3 100644 --- a/examples/vue/basic-file-based-jsx/src/routes/(group)/inside.tsx +++ b/examples/vue/basic-file-based-jsx/src/routes/(group)/inside.tsx @@ -1,9 +1,8 @@ import { createFileRoute, getRouteApi, useSearch } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(group)/inside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), component: InsideComponent, }) diff --git a/examples/vue/basic-file-based-jsx/src/routes/(group)/lazyinside.tsx b/examples/vue/basic-file-based-jsx/src/routes/(group)/lazyinside.tsx index 56d8d6cae8..05b34eb201 100644 --- a/examples/vue/basic-file-based-jsx/src/routes/(group)/lazyinside.tsx +++ b/examples/vue/basic-file-based-jsx/src/routes/(group)/lazyinside.tsx @@ -1,9 +1,8 @@ import { createFileRoute, getRouteApi, useSearch } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(group)/lazyinside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), component: LazyInsideComponent, }) diff --git a/examples/vue/basic-file-based-jsx/src/routes/(group)/subfolder/inside.tsx b/examples/vue/basic-file-based-jsx/src/routes/(group)/subfolder/inside.tsx index b4487d163d..317c766186 100644 --- a/examples/vue/basic-file-based-jsx/src/routes/(group)/subfolder/inside.tsx +++ b/examples/vue/basic-file-based-jsx/src/routes/(group)/subfolder/inside.tsx @@ -1,9 +1,8 @@ import { createFileRoute, getRouteApi, useSearch } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(group)/subfolder/inside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), component: SubfolderInsideComponent, }) diff --git a/examples/vue/basic-file-based-sfc/package.json b/examples/vue/basic-file-based-sfc/package.json index 38996573a0..a64726055a 100644 --- a/examples/vue/basic-file-based-sfc/package.json +++ b/examples/vue/basic-file-based-sfc/package.json @@ -10,20 +10,19 @@ }, "dependencies": { "@tailwindcss/vite": "^4.2.2", - "@tanstack/router-plugin": "^1.167.12", - "@tanstack/vue-router": "^1.168.9", - "@tanstack/vue-router-devtools": "^1.166.11", - "@tanstack/zod-adapter": "^1.166.9", + "@tanstack/router-plugin": "^1.168.13", + "@tanstack/vue-router": "^1.170.10", + "@tanstack/vue-router-devtools": "^1.167.0", "redaxios": "^0.5.1", "tailwindcss": "^4.2.2", "vue": "^3.5.16", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@vitejs/plugin-vue": "^6.0.5", "@vitejs/plugin-vue-jsx": "^5.1.5", "typescript": "~5.8.3", - "vite": "^8.0.0", + "vite": "^8.0.14", "vue-tsc": "^3.1.5" } } diff --git a/examples/vue/basic-file-based-sfc/src/routes/(another-group)/onlyrouteinside.ts b/examples/vue/basic-file-based-sfc/src/routes/(another-group)/onlyrouteinside.ts index 491bb03649..f427c79321 100644 --- a/examples/vue/basic-file-based-sfc/src/routes/(another-group)/onlyrouteinside.ts +++ b/examples/vue/basic-file-based-sfc/src/routes/(another-group)/onlyrouteinside.ts @@ -1,7 +1,6 @@ import { createFileRoute } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(another-group)/onlyrouteinside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), }) diff --git a/examples/vue/basic-file-based-sfc/src/routes/(group)/_layout.insidelayout.ts b/examples/vue/basic-file-based-sfc/src/routes/(group)/_layout.insidelayout.ts index 49ef8f7bb9..3b605763af 100644 --- a/examples/vue/basic-file-based-sfc/src/routes/(group)/_layout.insidelayout.ts +++ b/examples/vue/basic-file-based-sfc/src/routes/(group)/_layout.insidelayout.ts @@ -1,7 +1,6 @@ import { createFileRoute } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(group)/_layout/insidelayout')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), }) diff --git a/examples/vue/basic-file-based-sfc/src/routes/(group)/inside.ts b/examples/vue/basic-file-based-sfc/src/routes/(group)/inside.ts index f7b06f6a94..456e8fe169 100644 --- a/examples/vue/basic-file-based-sfc/src/routes/(group)/inside.ts +++ b/examples/vue/basic-file-based-sfc/src/routes/(group)/inside.ts @@ -1,7 +1,6 @@ import { createFileRoute } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(group)/inside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), }) diff --git a/examples/vue/basic-file-based-sfc/src/routes/(group)/lazyinside.ts b/examples/vue/basic-file-based-sfc/src/routes/(group)/lazyinside.ts index b66d18a729..7fba56aae4 100644 --- a/examples/vue/basic-file-based-sfc/src/routes/(group)/lazyinside.ts +++ b/examples/vue/basic-file-based-sfc/src/routes/(group)/lazyinside.ts @@ -1,7 +1,6 @@ import { createFileRoute } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(group)/lazyinside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), }) diff --git a/examples/vue/basic-file-based-sfc/src/routes/(group)/subfolder/inside.ts b/examples/vue/basic-file-based-sfc/src/routes/(group)/subfolder/inside.ts index 50aa8a44ad..21e5d7ba0a 100644 --- a/examples/vue/basic-file-based-sfc/src/routes/(group)/subfolder/inside.ts +++ b/examples/vue/basic-file-based-sfc/src/routes/(group)/subfolder/inside.ts @@ -1,7 +1,6 @@ import { createFileRoute } from '@tanstack/vue-router' import { z } from 'zod' -import { zodValidator } from '@tanstack/zod-adapter' export const Route = createFileRoute('/(group)/subfolder/inside')({ - validateSearch: zodValidator(z.object({ hello: z.string().optional() })), + validateSearch: z.object({ hello: z.string().optional() }), }) diff --git a/examples/vue/basic/package.json b/examples/vue/basic/package.json index 89bf0b7539..34127ae711 100644 --- a/examples/vue/basic/package.json +++ b/examples/vue/basic/package.json @@ -9,15 +9,15 @@ "start": "vite" }, "dependencies": { - "@tanstack/vue-router": "^1.168.9", - "@tanstack/vue-router-devtools": "^1.166.11", + "@tanstack/vue-router": "^1.170.10", + "@tanstack/vue-router-devtools": "^1.167.0", "redaxios": "^0.5.1", "vue": "^3.5.13", "tailwindcss": "4.1.18" }, "devDependencies": { "typescript": "^6.0.2", - "vite": "^8.0.0", + "vite": "^8.0.14", "vue-tsc": "^3.1.5", "@vitejs/plugin-vue": "^6.0.5", "@vitejs/plugin-vue-jsx": "^5.1.5", diff --git a/labeler-config.yml b/labeler-config.yml index 69529887a6..c1ad49328e 100644 --- a/labeler-config.yml +++ b/labeler-config.yml @@ -4,6 +4,9 @@ 'package: eslint-plugin-router': - changed-files: - any-glob-to-any-file: 'packages/eslint-plugin-router/**/*' +'package: eslint-plugin-start': + - changed-files: + - any-glob-to-any-file: 'packages/eslint-plugin-start/**/*' 'package: history': - changed-files: - any-glob-to-any-file: 'packages/history/**/*' @@ -25,6 +28,9 @@ 'package: react-start-client': - changed-files: - any-glob-to-any-file: 'packages/react-start-client/**/*' +'package: react-start-rsc': + - changed-files: + - any-glob-to-any-file: 'packages/react-start-rsc/**/*' 'package: react-start-server': - changed-files: - any-glob-to-any-file: 'packages/react-start-server/**/*' diff --git a/nx.json b/nx.json index 797ac91658..88eb404453 100644 --- a/nx.json +++ b/nx.json @@ -42,7 +42,7 @@ }, "test:e2e": { "cache": true, - "dependsOn": ["^build"], + "dependsOn": ["^build", "test:e2e--*"], "inputs": ["default", "^production"] }, "test:e2e:nitro": { @@ -76,5 +76,12 @@ "dependsOn": ["build"], "inputs": ["production"] } - } + }, + "plugins": [ + { + "name": "Playwright Sharding Plugin", + "plugin": "./scripts/nx/playwright-plugin.ts" + } + ], + "analytics": true } diff --git a/package.json b/package.json index e21d40ebae..897e7e04e4 100644 --- a/package.json +++ b/package.json @@ -5,7 +5,7 @@ "type": "git", "url": "git+https://github.com/TanStack/router.git" }, - "packageManager": "pnpm@10.28.0", + "packageManager": "pnpm@11.1.0", "type": "module", "scripts": { "cleanNodeModules": "pnpm -r exec rm -rf node_modules", @@ -37,7 +37,7 @@ "test:docs": "node scripts/verify-links.ts", "vite-ecosystem-ci:build": "nx run-many --targets=build --projects=@tanstack/router-plugin,@tanstack/start-plugin-core,@tanstack/react-start,@tanstack/react-start-client,@tanstack/react-start-server --skipRemoteCache", "vite-ecosystem-ci:before-test": "pnpm exec playwright install chromium", - "vite-ecosystem-ci:test": "nx run-many --targets=test:unit --projects=@tanstack/router-plugin,@tanstack/start-plugin-core,@tanstack/react-start-client --skipRemoteCache && nx run-many --target=test:e2e --projects=tanstack-router-e2e-react-basic-file-based,tanstack-router-e2e-react-basic-file-based-code-splitting,tanstack-react-start-e2e-basic,tanstack-react-start-e2e-basic-spa,tanstack-react-start-e2e-basic-prerender,tanstack-react-start-e2e-basic-preview,tanstack-vue-start-e2e-basic,tanstack-vue-start-e2e-basic-spa,tanstack-vue-start-e2e-basic-prerender,tanstack-vue-start-e2e-basic-preview,tanstack-solid-start-e2e-basic,tanstack-solid-start-e2e-basic-spa,tanstack-solid-start-e2e-basic-prerender,tanstack-solid-start-e2e-basic-preview --skipRemoteCache" + "vite-ecosystem-ci:test": "nx run-many --targets=test:unit --projects=@tanstack/router-plugin,@tanstack/start-plugin-core,@tanstack/react-start-client --skipRemoteCache && nx run-many --target=test:e2e --projects=tanstack-router-e2e-react-basic-file-based,tanstack-router-e2e-react-basic-file-based-code-splitting,tanstack-react-start-e2e-basic,tanstack-vue-start-e2e-basic,tanstack-solid-start-e2e-basic --skipRemoteCache" }, "nx": { "includedScripts": [ @@ -51,20 +51,20 @@ "@playwright/test": "^1.57.0", "@svitejs/changesets-changelog-github-compact": "^1.2.0", "@tanstack/eslint-config": "0.4.0", - "@tanstack/query-core": "^5.90.19", - "@tanstack/react-query": "^5.90.19", + "@tanstack/query-core": "^5.99.0", + "@tanstack/react-query": "^5.99.0", "@tanstack/vite-config": "0.5.2", "@types/node": "25.0.9", "@types/react": "^19.2.8", "@types/react-dom": "^19.2.3", - "@vitest/browser": "^4.0.17", - "@vitest/ui": "^4.0.17", + "@vitest/browser": "^4.1.4", + "@vitest/ui": "^4.1.4", "eslint": "^9.22.0", "eslint-plugin-react-hooks": "^5.1.0", "eslint-plugin-unused-imports": "^4.1.4", "jsdom": "^25.0.1", "markdown-link-extractor": "^4.0.3", - "nx": "22.5.1", + "nx": "22.6.5", "prettier": "^3.8.0", "publint": "^0.3.16", "react": "^19.2.3", @@ -78,8 +78,14 @@ "typescript57": "npm:typescript@5.7", "typescript58": "npm:typescript@5.8", "typescript59": "npm:typescript@5.9", - "vite": "^8.0.0", - "vitest": "^4.0.17" + "vite": "^8.0.14", + "vitest": "^4.1.4", + "@changesets/changelog-github": "^0.7.0", + "@nx/devkit": "22.6.5", + "@swc-node/core": "^1.14.1", + "@swc-node/register": "^1.11.1", + "@tanstack/solid-query": "^6.0.0-beta.4", + "@tanstack/vue-query": "^5.99.0" }, "pnpm": { "overrides": { @@ -135,5 +141,8 @@ "@tanstack/start-static-server-functions": "workspace:*", "@tanstack/nitro-v2-vite-plugin": "workspace:*" } + }, + "engines": { + "pnpm": ">=11.0.0" } } diff --git a/packages/arktype-adapter/CHANGELOG.md b/packages/arktype-adapter/CHANGELOG.md index fa530bd13c..9e41a6b247 100644 --- a/packages/arktype-adapter/CHANGELOG.md +++ b/packages/arktype-adapter/CHANGELOG.md @@ -1,5 +1,11 @@ # @tanstack/arktype-adapter +## 1.167.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + ## 1.166.9 ### Patch Changes diff --git a/packages/arktype-adapter/package.json b/packages/arktype-adapter/package.json index 8062da5093..f7840ba4f8 100644 --- a/packages/arktype-adapter/package.json +++ b/packages/arktype-adapter/package.json @@ -1,6 +1,6 @@ { "name": "@tanstack/arktype-adapter", - "version": "1.166.9", + "version": "1.167.0", "description": "Modern and scalable routing for React applications", "author": "Tanner Linsley", "license": "MIT", diff --git a/packages/eslint-plugin-router/CHANGELOG.md b/packages/eslint-plugin-router/CHANGELOG.md index a8f2080101..f58a2ecd63 100644 --- a/packages/eslint-plugin-router/CHANGELOG.md +++ b/packages/eslint-plugin-router/CHANGELOG.md @@ -1,5 +1,11 @@ # @tanstack/eslint-plugin-router +## 1.162.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + ## 1.161.6 ### Patch Changes diff --git a/packages/eslint-plugin-router/package.json b/packages/eslint-plugin-router/package.json index 5443868142..b99ee55e13 100644 --- a/packages/eslint-plugin-router/package.json +++ b/packages/eslint-plugin-router/package.json @@ -1,6 +1,6 @@ { "name": "@tanstack/eslint-plugin-router", - "version": "1.161.6", + "version": "1.162.0", "description": "ESLint plugin for TanStack Router", "author": "Manuel Schiller", "license": "MIT", diff --git a/packages/eslint-plugin-start/.attw.json b/packages/eslint-plugin-start/.attw.json new file mode 100644 index 0000000000..329bfe8343 --- /dev/null +++ b/packages/eslint-plugin-start/.attw.json @@ -0,0 +1,3 @@ +{ + "ignoreRules": ["false-export-default"] +} diff --git a/packages/eslint-plugin-start/CHANGELOG.md b/packages/eslint-plugin-start/CHANGELOG.md new file mode 100644 index 0000000000..45cec4b95a --- /dev/null +++ b/packages/eslint-plugin-start/CHANGELOG.md @@ -0,0 +1,13 @@ +# @tanstack/eslint-plugin-start + +## 0.1.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +## 0.0.1 + +### Patch Changes + +- Bump the initial release line for `@tanstack/react-start-rsc` and `@tanstack/eslint-plugin-start` to `0.0.1` after the manual `0.0.0` publish. ([#7144](https://github.com/TanStack/router/pull/7144)) diff --git a/packages/eslint-plugin-start/eslint.config.js b/packages/eslint-plugin-start/eslint.config.js new file mode 100644 index 0000000000..8ce6ad05fc --- /dev/null +++ b/packages/eslint-plugin-start/eslint.config.js @@ -0,0 +1,5 @@ +// @ts-check + +import rootConfig from '../../eslint.config.js' + +export default [...rootConfig] diff --git a/packages/eslint-plugin-start/lint-improvements.md b/packages/eslint-plugin-start/lint-improvements.md new file mode 100644 index 0000000000..ff46b57353 --- /dev/null +++ b/packages/eslint-plugin-start/lint-improvements.md @@ -0,0 +1,693 @@ +# ESLint Plugin Performance Improvements Plan + +## Problem Statement + +The `no-async-client-component` rule currently builds a **full render graph** of the entire TypeScript program on every lint run. This involves: + +1. Iterating through ALL source files in the program +2. Indexing ALL component definitions +3. Building ALL render edges (JSX references) +4. Only then checking a small subset for violations + +For a codebase with **thousands of files** and **only a few route files**, this is extremely wasteful: + +``` +Current: Scan 5000 files → Build graph of ~2000 components → Use ~50 of them +Optimal: Find 10 route files → Analyze only ~50 referenced components +``` + +## Solution: Lazy Entry-Point Analysis + +Instead of building a complete program graph upfront, we analyze **on-demand** starting from entry points: + +1. When linting file X, quick check: Does X have `createServerComponent` or route options? +2. If no: Skip entirely (zero analysis cost) +3. If yes: Analyze only components reachable from X's entry points + +This mirrors how `no-client-code-in-server-component` already works with its on-demand `CallExpression` trigger + `transitive-analyzer.ts` reachability walk. + +--- + +## Implementation Phases + +### Phase 1: Extract Shared Utilities (Safe, Low-Risk) + +**Goal:** Create shared infrastructure that both rules can use. + +#### 1.1 Create shared folder structure + +``` +packages/eslint-plugin-start/src/ +├── rules/ +│ ├── no-async-client-component/ +│ └── no-client-code-in-server-component/ +└── shared/ # NEW + ├── use-client-resolver.ts # Moved from no-client-code-in-server-component + ├── component-resolver.ts # NEW: Resolve component symbols + ├── transitive-walker.ts # NEW: Unified transitive analysis + └── types.ts # NEW: Shared type definitions +``` + +#### 1.2 Extract use-client-resolver + +Move `rules/no-client-code-in-server-component/use-client-resolver.ts` to `shared/use-client-resolver.ts`. + +No logic changes needed - just re-export from both rules. + +```typescript +// shared/use-client-resolver.ts +export interface UseClientResolver { + hasUseClientDirective(fileName: string): boolean +} + +export function createUseClientResolver( + program: ts.Program, +): UseClientResolver { + const cache = new Map() + + return { + hasUseClientDirective(fileName: string): boolean { + if (cache.has(fileName)) return cache.get(fileName)! + + const sourceFile = program.getSourceFile(fileName) + if (!sourceFile) { + cache.set(fileName, false) + return false + } + + const result = checkFirstStatement(sourceFile) + cache.set(fileName, result) + return result + }, + } +} +``` + +#### 1.3 Create component-resolver + +New utility to resolve component symbols from various patterns: + +```typescript +// shared/component-resolver.ts +export interface ComponentInfo { + name: string + fileName: string + symbol: ts.Symbol + declaration: ts.Declaration + isAsync: boolean +} + +export interface ComponentResolver { + /** + * Resolve a component from an identifier (e.g., JSX tag name or route option value) + */ + resolveComponent(node: ts.Identifier): ComponentInfo | undefined + + /** + * Check if a function-like node is async + */ + isAsyncFunction(node: ts.Node): boolean +} + +export function createComponentResolver( + ts: typeof import('typescript'), + checker: ts.TypeChecker, +): ComponentResolver { + // Implementation... +} +``` + +#### 1.4 Create shared types + +```typescript +// shared/types.ts +export interface EntryPoint { + type: 'server-component' | 'route-option' + node: ts.Node + fileName: string + /** For route-option, the specific option name (component, pendingComponent, etc.) */ + optionName?: string +} + +export interface AnalysisContext { + program: ts.Program + checker: ts.TypeChecker + useClientResolver: UseClientResolver + componentResolver: ComponentResolver +} +``` + +--- + +### Phase 2: Refactor no-async-client-component to On-Demand + +**Goal:** Avoid full-program graph build; analyze only when a file contains route options / entry points. + +#### 2.1 New architecture + +``` +Before: +┌─────────────────────────────────────────────────────────────┐ +│ Program() visitor │ +│ └── For each file in program: │ +│ └── Index all components, edges, roots │ +│ └── analyzeContext() on complete graph │ +│ └── Report violations │ +└─────────────────────────────────────────────────────────────┘ + +After: +┌─────────────────────────────────────────────────────────────┐ +│ CallExpression visitor (only triggers on specific calls) │ +│ └── Is this createFileRoute/createRootRoute/etc? │ +│ └── YES: Extract component references from options │ +│ └── For each component: analyzeTransitively│ +│ └── Is this createServerComponent? │ +│ └── YES: Mark referenced components as server context│ +└─────────────────────────────────────────────────────────────┘ +``` + +#### 2.2 Stop building full-program render graph + +Replace full-program graph build with per-entry-point analysis. Actual file deletion can come later after parity is proven. + +#### 2.3 Stop precomputing global context + +Context propagation becomes implicit in a focused traversal (starting from route-option components and respecting server boundaries). + +#### 2.4 New rule structure + +```typescript +// no-async-client-component.rule.ts (simplified) +export const rule = ESLintUtils.RuleCreator(getDocsUrl)({ + // ...meta... + + create(context) { + const services = ESLintUtils.getParserServices(context) + const program = services.program + const checker = program.getTypeChecker() + + // Shared utilities + const useClientResolver = createUseClientResolver(program) + const componentResolver = createComponentResolver(ts, checker) + + // Track what we've already analyzed to avoid duplicates + const analyzedComponents = new Set() + const reportedViolations = new Set() + + return { + CallExpression(node) { + const tsNode = services.esTreeNodeToTSNodeMap.get(node) + + // Check for route options: createFileRoute('/')({ component: X }) + const routeComponents = extractRouteOptionComponents(tsNode) + if (routeComponents.length > 0) { + for (const { component, optionNode } of routeComponents) { + analyzeAsClientRoot(component, optionNode, node) + } + return + } + + // Check for server component: createServerComponent(() => ) + const serverComponents = extractServerComponentChildren(tsNode) + if (serverComponents.length > 0) { + // These are in server context - async is ALLOWED here + // Mark them so we don't report if encountered via route options + for (const comp of serverComponents) { + markAsServerContext(comp) + } + } + }, + } + + function analyzeAsClientRoot( + componentSymbol: ts.Symbol, + usageNode: ts.Node, + eslintNode: TSESTree.CallExpression, + ) { + // Walk transitively, checking for async components + // Stop at 'use client' boundaries + // Report violations at usageNode location + } + }, +}) +``` + +#### 2.5 Transitive async analysis + +```typescript +interface AsyncAnalysisResult { + /** Components that are async and in client context */ + asyncViolations: Array<{ + componentName: string + componentFile: string + isAsync: boolean + chain: Array<{ file: string; component: string }> + }> + /** Whether we hit a 'use client' boundary (stops propagation) */ + hitClientBoundary: boolean +} + +function analyzeComponentTransitively( + entrySymbol: ts.Symbol, + context: AnalysisContext, + visited: Set, +): AsyncAnalysisResult { + const key = symbolKey(entrySymbol) + if (visited.has(key)) return { asyncViolations: [], hitClientBoundary: false } + visited.add(key) + + const decl = entrySymbol.getDeclarations()?.[0] + if (!decl) return { asyncViolations: [], hitClientBoundary: false } + + const fileName = decl.getSourceFile().fileName + + // Check for 'use client' boundary + if (context.useClientResolver.hasUseClientDirective(fileName)) { + return { asyncViolations: [], hitClientBoundary: true } + } + + const violations: AsyncAnalysisResult['asyncViolations'] = [] + + // Check if this component is async + const componentInfo = context.componentResolver.resolveFromDeclaration(decl) + if (componentInfo?.isAsync) { + violations.push({ + componentName: componentInfo.name, + componentFile: fileName, + isAsync: true, + chain: [], + }) + } + + // Find JSX children and recurse + const childRefs = findJsxComponentReferences(decl) + for (const childRef of childRefs) { + const childSymbol = context.checker.getSymbolAtLocation(childRef) + if (!childSymbol) continue + + const childResult = analyzeComponentTransitively( + resolveAlias(childSymbol), + context, + visited, + ) + + if (childResult.hitClientBoundary) continue // Stop at boundary + + // Add chain info to child violations + for (const v of childResult.asyncViolations) { + violations.push({ + ...v, + chain: [ + { file: fileName, component: componentInfo?.name ?? 'unknown' }, + ...v.chain, + ], + }) + } + } + + return { asyncViolations: violations, hitClientBoundary: false } +} +``` + +--- + +### Phase 3: Unify Transitive Analysis + +**Goal:** Both rules share the same transitive walking infrastructure. + +#### 3.1 Create unified transitive-walker + +```typescript +// shared/transitive-walker.ts + +export interface WalkOptions { + /** Whether to detect client-only code violations (hooks, onClick, etc.) */ + detectClientViolations?: boolean + /** Whether to detect async component violations */ + detectAsyncViolations?: boolean + /** Allowed hooks for client violation detection */ + allowedHooks?: Set +} + +export interface WalkResult { + /** Client-only code violations (if detectClientViolations) */ + clientViolations: Array + /** Async components found (if detectAsyncViolations) */ + asyncComponents: Array + /** Whether a 'use client' boundary was hit */ + hitClientBoundary: boolean + /** Import chain to reach this point */ + chain: Array +} + +export interface TransitiveWalker { + /** + * Walk from an entry symbol, collecting violations based on options. + * Stops at 'use client' boundaries. + */ + walk(entrySymbol: ts.Symbol, options: WalkOptions): WalkResult + + /** + * Clear caches (call between unrelated analyses) + */ + clearCaches(): void +} + +export function createTransitiveWalker( + ts: typeof import('typescript'), + context: AnalysisContext, +): TransitiveWalker { + // Per-symbol cache for walk results + const walkCache = new Map() + + // Per-file violation cache (reusable across symbols in same file) + const fileViolationCache = new Map>() + + return { + walk(entrySymbol, options) { + const cacheKey = `${symbolKey(entrySymbol)}:${JSON.stringify(options)}` + if (walkCache.has(cacheKey)) return walkCache.get(cacheKey)! + + const result = walkInternal(entrySymbol, options, new Set(), []) + walkCache.set(cacheKey, result) + return result + }, + + clearCaches() { + walkCache.clear() + fileViolationCache.clear() + }, + } + + function walkInternal( + symbol: ts.Symbol, + options: WalkOptions, + visited: Set, + chain: Array, + ): WalkResult { + // Implementation combines logic from: + // - transitive-analyzer.ts (following symbols) + // - violation-detector.ts (detecting client violations) + // - render-graph-builder.ts (detecting async) + } +} +``` + +#### 3.2 Update no-client-code-in-server-component to use shared walker + +```typescript +// no-client-code-in-server-component.rule.ts +import { createTransitiveWalker } from '../../shared/transitive-walker' + +export const rule = ESLintUtils.RuleCreator(getDocsUrl)({ + create(context) { + const walker = createTransitiveWalker(ts, analysisContext) + + return { + CallExpression(node) { + if (!isCreateServerComponentCall(node)) return + + const componentRefs = findComponentReferences(callback) + for (const ref of componentRefs) { + const result = walker.walk(resolvedSymbol, { + detectClientViolations: true, + detectAsyncViolations: false, // Other rule handles this + allowedHooks, + }) + + if (result.hitClientBoundary) continue + + for (const violation of result.clientViolations) { + reportViolation(violation, result.chain, ref.text, eslintNode) + } + } + }, + } + }, +}) +``` + +#### 3.3 Update no-async-client-component to use shared walker + +```typescript +// no-async-client-component.rule.ts +import { createTransitiveWalker } from '../../shared/transitive-walker' + +export const rule = ESLintUtils.RuleCreator(getDocsUrl)({ + create(context) { + const walker = createTransitiveWalker(ts, analysisContext) + + return { + CallExpression(node) { + const routeComponents = extractRouteOptionComponents(tsNode) + + for (const { componentSymbol, optionNode } of routeComponents) { + const result = walker.walk(componentSymbol, { + detectClientViolations: false, // Other rule handles this + detectAsyncViolations: true, + }) + + if (result.hitClientBoundary) continue + + for (const asyncComp of result.asyncComponents) { + reportAsyncViolation(asyncComp, optionNode, eslintNode) + } + } + }, + } + }, +}) +``` + +--- + +### Phase 4: Enhanced Caching (Future) + +**Goal:** Further optimize repeat analyses with persistent caches. + +> **Note:** This phase is documented for future implementation. Do not implement yet. + +#### 4.1 File-level violation cache + +Cache violations detected in each source file, keyed by file path and content hash. + +```typescript +interface FileViolationCache { + /** Content hash when cached */ + contentHash: string + /** Cached client violations */ + clientViolations: Array + /** Cached component metadata */ + components: Array<{ + name: string + isAsync: boolean + line: number + }> +} + +const fileCache = new Map() + +function getFileViolations(sourceFile: ts.SourceFile): Array { + const hash = computeHash(sourceFile.text) + const cached = fileCache.get(sourceFile.fileName) + + if (cached?.contentHash === hash) { + return cached.clientViolations + } + + // Recompute and cache + const violations = detectViolationsInFile(sourceFile) + fileCache.set(sourceFile.fileName, { + contentHash: hash, + clientViolations: violations, + components: extractComponentMetadata(sourceFile), + }) + + return violations +} +``` + +#### 4.2 Import graph cache + +Cache which symbols each file imports, enabling quick dependency lookups. + +```typescript +interface ImportGraphCache { + /** Content hash when cached */ + contentHash: string + /** Imported symbols: Map */ + imports: Map + /** Exported symbols */ + exports: Set +} +``` + +#### 4.3 Cross-file dependency tracking + +Track which files depend on which, for incremental invalidation. + +```typescript +interface DependencyGraph { + /** Files that import this file */ + importedBy: Map> + /** Files this file imports */ + imports: Map> +} + +function invalidateFile(fileName: string, graph: DependencyGraph) { + // Clear cache for this file + fileCache.delete(fileName) + + // Clear cache for files that import this file + const dependents = graph.importedBy.get(fileName) ?? new Set() + for (const dep of dependents) { + fileCache.delete(dep) + } +} +``` + +#### 4.4 LRU eviction for memory management + +```typescript +import { LRUCache } from 'lru-cache' + +const fileCache = new LRUCache({ + max: 1000, // Max 1000 files + ttl: 1000 * 60 * 5, // 5 minute TTL +}) +``` + +--- + +## File Changes Summary + +### New Files + +| File | Description | +| ----------------------------------- | ------------------------------------------------------ | +| `src/shared/use-client-resolver.ts` | Moved from `rules/no-client-code-in-server-component/` | +| `src/shared/component-resolver.ts` | New: Resolve component symbols | +| `src/shared/transitive-walker.ts` | New: Unified transitive analysis | +| `src/shared/types.ts` | New: Shared type definitions | + +### Modified Files + +| File | Changes | +| ----------------------------------------------------------------------------------------- | ----------------------------- | +| `src/rules/no-async-client-component/no-async-client-component.rule.ts` | Complete rewrite to on-demand | +| `src/rules/no-client-code-in-server-component/no-client-code-in-server-component.rule.ts` | Use shared utilities | + +### Deleted / Retired Files + +| File | Reason | +| --------------------------------------------------------------------- | ------------------------------------------ | +| `src/rules/no-async-client-component/render-graph-builder.ts` | Eventually retired after on-demand parity | +| `src/rules/no-async-client-component/context-analyzer.ts` | Eventually retired after on-demand parity | +| `src/rules/no-client-code-in-server-component/use-client-resolver.ts` | Moved to shared | +| `src/rules/no-client-code-in-server-component/transitive-analyzer.ts` | (Optional) later replaced by shared walker | + +--- + +## Performance Expectations + +### Before Optimization + +| Metric | Value | +| --------------- | ---------------------------------- | +| Files scanned | All files in program | +| Time complexity | O(files × avg components per file) | +| Memory | Full component graph in memory | + +### After Optimization + +| Metric | Value | +| --------------- | --------------------------------------------- | +| Files scanned | Only entry point files + reachable components | +| Time complexity | O(entry points × avg reachable depth) | +| Memory | Only active analysis path | + +### Example: 5000 files, 10 routes, 50 components per route + +| Metric | Before | After | Improvement | +| ------------------ | ----------------- | --------------- | ----------- | +| File visits | ~5000 | ~500 | 10x | +| Components indexed | ~2000 | ~500 | 4x | +| Memory usage | High (full graph) | Low (path only) | ~10x | + +--- + +## Testing Strategy + +### Unit Tests + +1. **Shared utilities:** + - `use-client-resolver.ts`: Test directive detection + - `component-resolver.ts`: Test symbol resolution + - `transitive-walker.ts`: Test walk behavior, caching, boundary detection + +2. **Rule behavior:** + - Existing tests should continue to pass + - Add tests for edge cases in on-demand analysis + +### E2E Tests + +Use `e2e/eslint-plugin-start/` project to verify: + +1. Cross-file analysis still works +2. No false positives from lazy analysis +3. Performance improvement on large fixture sets + +### Performance Benchmarks + +Create benchmark script: + +```typescript +// scripts/benchmark-eslint-rules.ts +import { ESLint } from 'eslint' +import { performance } from 'perf_hooks' + +async function benchmark(name: string, fn: () => Promise) { + const start = performance.now() + await fn() + const end = performance.now() + console.log(`${name}: ${(end - start).toFixed(2)}ms`) +} + +// Run on large fixture set +await benchmark('no-async-client-component', async () => { + const eslint = new ESLint({ + /* config */ + }) + await eslint.lintFiles(['fixtures/large-project/**/*.tsx']) +}) +``` + +--- + +## Migration Notes + +### Breaking Changes + +None expected. The rules produce the same errors, just faster. + +### Deprecation + +- Internal APIs (`RenderGraph`, `ContextAnalysisResult`) are removed +- These were never part of public API + +### Rollback Plan + +If issues arise, revert to commit before Phase 2 changes. + +--- + +## Timeline Estimate + +| Phase | Effort | Dependencies | +| ------------------------------------------- | --------- | ------------ | +| Phase 1: Extract shared utilities | 2-3 hours | None | +| Phase 2: Refactor no-async-client-component | 4-6 hours | Phase 1 | +| Phase 3: Unify transitive analysis | 3-4 hours | Phase 2 | +| Phase 4: Enhanced caching | Future | Phase 3 | + +**Total: ~10-13 hours for Phases 1-3** diff --git a/packages/eslint-plugin-start/no-async-client-component.md b/packages/eslint-plugin-start/no-async-client-component.md new file mode 100644 index 0000000000..4e312fd9f6 --- /dev/null +++ b/packages/eslint-plugin-start/no-async-client-component.md @@ -0,0 +1,346 @@ +# Rule: `no-async-client-component` + +## Overview + +Disallow async components in client context. Async components are only valid inside `createServerComponent()`. + +## Problem + +In React Server Components: + +- Async components can only be awaited on the server +- Client components cannot be async (React throws at runtime) +- Components become "client" when: + 1. Referenced by `createFileRoute()` or `createRootRoute()` options (`component`, `pendingComponent`, etc.) + 2. Inside a `'use client'` file + 3. Rendered by another client component (transitively) + +## Detection Algorithm + +### Phase 1: Build Render Graph (whole-program) + +Using TypeScript program from ESLint parser services: + +``` +For each file in program: + 1. Index component definitions + - PascalCase exported function or const assigned to function/arrow + - async-ness from TS node flags + 2. Find JSX usages () + 3. Build edges: callerComponent -> calleeComponent + 4. Mark "server roots": + - the createServerComponent() callback itself + - components referenced from within that callback's JSX tree + 5. Mark "client roots": + - createFileRoute()({ component, pendingComponent, errorComponent, notFoundComponent, ... }) + - createRootRoute()({ component, pendingComponent, errorComponent, notFoundComponent, ... }) + - Files with 'use client' directive + +Notes: +- `createRootRoute`/`createFileRoute` refer to `@tanstack/react-router` APIs. +- `createLazyFileRoute` is intentionally out of scope. +- Prefer TS symbol resolution (e.g. aliases/re-exports via `checker.getAliasedSymbol`). +``` + +### Phase 2: Propagate Context + +``` +1. Mark all server roots as "server context" +2. Walk render graph from server roots; mark descendants as "server context" + - STOP at a 'use client' boundary (descendants become client) +3. Mark all client roots as "client context" +4. Walk render graph from client roots; mark descendants as "client context" +5. Any component reachable from BOTH contexts is "tainted" (client wins) +6. Any component not reachable from server context is "client context" + +Note: if the program has no server roots (no createServerComponent usage), +then all components end up in client context and async components are always invalid. +``` + +### Phase 3: Report Violations + +``` +For each async component: + If component is in client context: + Report error at: + 1. The async component definition (primary) + 2. Each JSX usage site where the *caller component* is in client context (secondary) +``` + +## Error Messages + +**At definition site:** + +``` +Async component "MyComponent" cannot be used in client context. Async components +are only valid inside createServerComponent(). Either remove 'async' or ensure +this component is only rendered within server components. +``` + +**At usage site:** + +``` +Async component "MyComponent" is rendered in client context here. Async components +are only valid inside createServerComponent(). Move this to a server component or +use a non-async version. +``` + +## Implementation Structure + +``` +src/rules/no-async-client-component/ + no-async-client-component.rule.ts -- Main ESLint rule + render-graph-builder.ts -- Build component render graph + context-analyzer.ts -- Propagate server/client context + async-component-detector.ts -- Find async function components + constants.ts -- Route option names, etc. +``` + +## Key Types + +```typescript +interface ComponentInfo { + name: string + fileName: string + node: ts.Node + isAsync: boolean + line: number +} + +interface RenderEdge { + fromFile: string + fromComponent: string + toFile: string + toComponent: string + jsxNode: ts.Node // For reporting at usage site +} + +interface ComponentContext { + component: ComponentInfo + isServerContext: boolean + isClientContext: boolean + // If client, why? + clientReason?: + | { type: 'use-client' } + | { type: 'route-option'; routeFile: string; option: string } + | { type: 'rendered-by-client'; parentComponent: string } +} + +type RenderGraph = { + components: Map // key: "file:ComponentName" + edges: Array + serverRoots: Set // Components inside createServerComponent + clientRoots: Set // Components in route options or 'use client' +} +``` + +## Route Options to Track + +From `createFileRoute()` and `createRootRoute()` (component-ish keys only): + +```typescript +const ROUTE_COMPONENT_OPTION_NAMES = [ + 'component', + 'pendingComponent', + 'errorComponent', + 'notFoundComponent', +] +``` + +Only analyze these keys, and only when the value resolves to a function/component reference (identifier, inline function, etc.). + +## Edge Cases + +### 1. Component used in both server and client + +```tsx +// ServerPage.tsx +createServerComponent(() => ) // Server usage + +// ClientPage.tsx +createFileRoute('/')({ component: () => }) // Client usage +``` + +**Result**: Error - SharedComponent is tainted (used in client context) + +### 2. Conditional rendering + +```tsx +createServerComponent(() => { + if (condition) return // Valid + return +}) +``` + +**Result**: AsyncComponent is in server context, valid + +### 3. Dynamic imports + +```tsx +const LazyComponent = lazy(() => import('./AsyncComponent')) +``` + +**Result**: Out of scope initially (non-trivial to resolve statically). + +### 4. Component passed as prop + +```tsx +createServerComponent(({ ActionButton }) => { + return ( +
    + +
    + ) // ActionButton comes from client +}) +``` + +**Result**: ActionButton is a slot from client, tracked separately + +### 5. Re-exports + +```tsx +// components/index.ts +export { MyComponent } from './MyComponent' +``` + +**Result**: Follow re-exports via TS symbol resolution (alias symbols). + +## Performance Considerations + +1. **Use TypeScript program** from parser services (already built) +2. **Cache render graph** per program instance +3. **Incremental updates** if possible (watch mode) +4. **Early termination** - once a component is proven client, stop analyzing + +## Rule Options + +```typescript +interface RuleOptions { + /** + * Additional file patterns to treat as client entry points + * @default [] + */ + additionalClientPatterns?: string[] + + /** + * File patterns to ignore + * @default [] + */ + ignorePatterns?: string[] +} +``` + +## Test Cases + +### Valid (should NOT report) + +```tsx +// Async inside createServerComponent +createServerComponent(async () => { + const data = await fetch() + return
    {data}
    +}) + +// Async component rendered by server component +// AsyncData.tsx +export async function AsyncData() { + return
    {await getData()}
    +} +// ServerPage.tsx +createServerComponent(() => ) + +// Sync component in client context (OK) +createFileRoute('/')({ component: SyncComponent }) +``` + +### Invalid (should report) + +```tsx +// Async component as route component +export async function Page() { + return
    +} +createFileRoute('/')({ component: Page }) // Error at both locations + +// Async component rendered by client +// AsyncWidget.tsx +export async function AsyncWidget() { + return
    +} +// ClientPage.tsx +createFileRoute('/')({ + component: () => , // Error: AsyncWidget is async +}) + +// Async in 'use client' file +;('use client') +export async function ClientComponent() { + return
    +} // Error + +// Async component rendered by 'use client' file +// Widget.tsx +export async function Widget() { + return
    +} +// ClientWrapper.tsx +;('use client') +import { Widget } from './Widget' +export function Wrapper() { + return +} // Error at usage +// Widget.tsx also gets error at definition + +// Transitive client context +// AsyncDeep.tsx +export async function AsyncDeep() { + return
    +} +// Middle.tsx +export function Middle() { + return +} +// ClientPage.tsx +createFileRoute('/')({ component: () => }) +// Error: AsyncDeep rendered transitively in client context +``` + +## Implementation Steps + +1. **Create async-component-detector.ts** + - Find all async function components in a file + - Detect: `export async function Foo()`, `export const Foo = async () => {}` + - Component heuristic: PascalCase name (avoid deep return/CFG analysis initially) + +2. **Create render-graph-builder.ts** + - Walk all files in TypeScript program + - Build component -> component edges from JSX + - Identify server roots (createServerComponent callbacks) + - Identify client roots (route options, 'use client') + +3. **Create context-analyzer.ts** + - Propagate server context from server roots + - Propagate client context from client roots + - Handle 'use client' boundaries + - Determine final context for each component + +4. **Create no-async-client-component.rule.ts** + - Build/cache render graph on Program node + - For each file, find async components + - Check context, report violations + - Report at both definition and usage sites + +5. **Add tests** + - Valid cases (async in server context) + - Invalid cases (async in client context) + - Edge cases (mixed, transitive, re-exports) + +6. **Update plugin exports** + - Add to rules.ts + - Add to index.ts + +## Dependencies + +- Reuses `use-client-resolver.ts` from existing rule +- Uses TypeScript program from ESLint parser services +- No new external dependencies diff --git a/packages/eslint-plugin-start/no-client-code-in-server-component.md b/packages/eslint-plugin-start/no-client-code-in-server-component.md new file mode 100644 index 0000000000..11450f2bd6 --- /dev/null +++ b/packages/eslint-plugin-start/no-client-code-in-server-component.md @@ -0,0 +1,163 @@ +# Rule: `no-client-code-in-server-component` + +## Overview + +Disallow client-only code inside `createServerComponent()`. + +This rule is meant to catch common "RSC boundary" mistakes in TanStack Start: + +- calling React client hooks in server components +- referencing browser-only globals (eg `window`, `document`) +- using React event handlers (`onClick`, etc.) +- passing functions as props (non-serializable) +- using class components + +## What counts as a "server component" here? + +This rule treats the callback passed to `createServerComponent(...)` as server-only, and also treats any components rendered from within that callback as server-only unless they cross a `'use client'` boundary. + +Supported call patterns: + +- `createServerComponent(() =>
    )` +- `createServerComponent(async () =>
    )` +- `createServerComponent(MyComponent)` (direct reference) + +## What counts as "client code"? + +### React hooks + +The rule flags common React hooks that require a client runtime (eg `useState`, `useEffect`). + +Allowed hooks: + +- `useId` is allowed by default. +- You can allow additional hooks via the `allowedServerHooks` option. + +### Browser-only globals + +Any global that exists in `globals.browser` but not `globals.node` is treated as browser-only and disallowed. + +Examples: + +- `window` +- `document` +- `navigator` + +### Event handlers + +JSX props that look like React event handlers (eg `onClick`, `onChange`, etc.) are disallowed in server components. + +### Function props + +Passing a function through props is disallowed because server-to-client serialization can’t serialize functions. + +### Class components + +Class components are disallowed because they rely on client-side lifecycle. + +## Reporting location + +- For direct violations inside a `createServerComponent` callback, the error is reported at the violating node. +- For transitive violations (server component → imports another file → reaches client code), the rule reports at: + - the specific violating node (where possible) and + - includes a "Triggered by rendering \"X\"" hint naming the entry component. + +## Options + +```ts +type Options = [ + { + allowedServerHooks?: string[] + }, +] +``` + +### `allowedServerHooks` + +Add additional hook names that should be allowed in server components. + +Example: + +```js +{ + rules: { + '@tanstack/start/no-client-code-in-server-component': [ + 'error', + { + allowedServerHooks: ['useMyServerSafeHook'], + }, + ], + }, +} +``` + +## Examples + +### Invalid: client hook in server component + +```tsx +import { createServerComponent } from '@tanstack/react-start/rsc' +import { useState } from 'react' + +export const Server = createServerComponent(() => { + const [count, setCount] = useState(0) + return +}) +``` + +### Invalid: browser global access + +```tsx +import { createServerComponent } from '@tanstack/react-start/rsc' + +export const Server = createServerComponent(() => { + return
    {window.location.href}
    +}) +``` + +### Invalid: transitive client import + +```tsx +// server.tsx +import { createServerComponent } from '@tanstack/react-start/rsc' +import { Middle } from './middle' + +export const Server = createServerComponent(() => ) + +// middle.tsx +import { ClientThing } from './client-thing' +export function Middle() { + return +} + +// client-thing.tsx +export function ClientThing() { + return +} +``` + +### Valid: slot/prop boundary (pattern suggestion) + +```tsx +import { createServerComponent } from '@tanstack/react-start/rsc' + +export const Server = createServerComponent(({ ActionButton }) => { + return ( +
    + +
    + ) +}) +``` + +## Implementation structure + +```txt +src/rules/no-client-code-in-server-component/ + no-client-code-in-server-component.rule.ts + transitive-analyzer.ts + violation-detector.ts + constants.ts +src/shared/ + use-client-resolver.ts +``` diff --git a/packages/eslint-plugin-start/package.json b/packages/eslint-plugin-start/package.json new file mode 100644 index 0000000000..c4867c58d0 --- /dev/null +++ b/packages/eslint-plugin-start/package.json @@ -0,0 +1,67 @@ +{ + "name": "@tanstack/eslint-plugin-start", + "version": "0.1.0", + "description": "ESLint plugin for TanStack Start", + "author": "TanStack", + "license": "MIT", + "repository": { + "type": "git", + "url": "git+https://github.com/TanStack/router.git", + "directory": "packages/eslint-plugin-start" + }, + "homepage": "https://tanstack.com/start", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/tannerlinsley" + }, + "scripts": { + "clean": "rimraf ./dist ./coverage", + "test:eslint": "eslint ./src", + "test:types": "pnpm run \"/^test:types:ts[0-9]{2}$/\"", + "test:types:ts55": "node ../../node_modules/typescript55/lib/tsc.js", + "test:types:ts56": "node ../../node_modules/typescript56/lib/tsc.js", + "test:types:ts57": "node ../../node_modules/typescript57/lib/tsc.js", + "test:types:ts58": "node ../../node_modules/typescript58/lib/tsc.js", + "test:types:ts59": "node ../../node_modules/typescript59/lib/tsc.js", + "test:types:ts60": "tsc", + "test:unit": "vitest", + "test:unit:dev": "pnpm run test:unit --watch --typecheck", + "test:build": "publint --strict && attw --pack .", + "build": "vite build && tsc --noEmit" + }, + "type": "module", + "types": "dist/esm/src/index.d.ts", + "main": "dist/cjs/index.cjs", + "module": "dist/esm/index.js", + "exports": { + ".": { + "import": { + "types": "./dist/esm/src/index.d.ts", + "default": "./dist/esm/index.js" + }, + "require": { + "types": "./dist/cjs/src/index.d.cts", + "default": "./dist/cjs/index.cjs" + } + }, + "./package.json": "./package.json" + }, + "sideEffects": false, + "files": [ + "dist", + "src" + ], + "dependencies": { + "@typescript-eslint/utils": "^8.44.1", + "globals": "^16.2.0" + }, + "devDependencies": { + "@typescript-eslint/rule-tester": "^8.44.1", + "eslint": "^9.22.0", + "typescript": "^5.8.2" + }, + "peerDependencies": { + "eslint": "^8.57.0 || ^9.0.0", + "typescript": ">=4.7.0" + } +} diff --git a/packages/eslint-plugin-start/src/__tests__/no-async-client-component.rule.test.ts b/packages/eslint-plugin-start/src/__tests__/no-async-client-component.rule.test.ts new file mode 100644 index 0000000000..53c8ed7705 --- /dev/null +++ b/packages/eslint-plugin-start/src/__tests__/no-async-client-component.rule.test.ts @@ -0,0 +1,287 @@ +import * as path from 'node:path' +import { RuleTester } from '@typescript-eslint/rule-tester' +import * as vitest from 'vitest' + +import { + name, + rule, +} from '../rules/no-async-client-component/no-async-client-component.rule' + +RuleTester.afterAll = vitest.afterAll +RuleTester.it = ((name, fn) => + vitest.it(name, { timeout: 15000 }, fn)) as typeof RuleTester.it +RuleTester.itOnly = vitest.it.only +RuleTester.describe = vitest.describe + +const ruleTester = new RuleTester({ + languageOptions: { + parserOptions: { + ecmaFeatures: { + jsx: true, + }, + projectService: { + allowDefaultProject: ['*.tsx'], + maximumDefaultProjectFileMatchCount_THIS_WILL_SLOW_DOWN_LINTING: 50, + }, + tsconfigRootDir: path.join(__dirname), + }, + }, +}) + +ruleTester.run(name, rule as any, { + valid: [ + // Sync component in route is fine + { + filename: 'SyncRoute.tsx', + code: ` + import { createFileRoute } from '@tanstack/react-router' + + function SyncComponent() { + return
    Hello
    + } + + export const Route = createFileRoute('/')({ + component: SyncComponent, + }) + `, + }, + // Async inside createCompositeComponent is fine + { + filename: 'ServerComponent.tsx', + code: ` + import { createCompositeComponent } from '@tanstack/react-start/rsc' + + createCompositeComponent(async () => { + const data = await fetch('/api') + return
    {data}
    + }) + `, + }, + // Sync component with 'use client' is fine (not async) + { + filename: 'ClientFile.tsx', + code: ` + 'use client' + + function ClientComponent() { + return + } + `, + }, + // Inline sync component in route is fine + { + filename: 'InlineRoute.tsx', + code: ` + import { createFileRoute } from '@tanstack/react-router' + + export const Route = createFileRoute('/')({ + component: () =>
    Hello
    , + }) + `, + }, + // Sync pendingComponent is fine + { + filename: 'SyncPending.tsx', + code: ` + import { createFileRoute } from '@tanstack/react-router' + + function Loading() { + return
    Loading...
    + } + + export const Route = createFileRoute('/')({ + component: () =>
    Hello
    , + pendingComponent: Loading, + }) + `, + }, + // createRootRoute with sync component is fine + { + filename: 'RootSync.tsx', + code: ` + import { createRootRoute } from '@tanstack/react-router' + + function RootLayout() { + return
    Layout
    + } + + export const Route = createRootRoute()({ + component: RootLayout, + }) + `, + }, + ], + invalid: [ + // Async component directly in route option + { + filename: 'AsyncRoute.tsx', + code: ` + import { createFileRoute } from '@tanstack/react-router' + + async function AsyncPage() { + const data = await fetch('/api') + return
    {data}
    + } + + export const Route = createFileRoute('/')({ + component: AsyncPage, + }) + `, + errors: [ + { + messageId: 'asyncClientComponentDefinition', + }, + ], + }, + // Async component in 'use client' file + { + filename: 'AsyncClient.tsx', + code: ` + 'use client' + + export async function AsyncClientComponent() { + return
    Async
    + } + `, + errors: [ + { + messageId: 'asyncClientComponentDefinition', + }, + ], + }, + // Async arrow component in route + { + filename: 'AsyncArrowRoute.tsx', + code: ` + import { createFileRoute } from '@tanstack/react-router' + + const AsyncPage = async () => { + return
    Async
    + } + + export const Route = createFileRoute('/')({ + component: AsyncPage, + }) + `, + errors: [ + { + messageId: 'asyncClientComponentDefinition', + }, + ], + }, + // Async pendingComponent + { + filename: 'AsyncPending.tsx', + code: ` + import { createFileRoute } from '@tanstack/react-router' + + async function AsyncPending() { + return
    Loading...
    + } + + export const Route = createFileRoute('/')({ + component: () =>
    Hello
    , + pendingComponent: AsyncPending, + }) + `, + errors: [ + { + messageId: 'asyncClientComponentDefinition', + }, + ], + }, + // Async errorComponent + { + filename: 'AsyncError.tsx', + code: ` + import { createFileRoute } from '@tanstack/react-router' + + async function AsyncError() { + return
    Error
    + } + + export const Route = createFileRoute('/')({ + component: () =>
    Hello
    , + errorComponent: AsyncError, + }) + `, + errors: [ + { + messageId: 'asyncClientComponentDefinition', + }, + ], + }, + // Async in createRootRoute + { + filename: 'AsyncRoot.tsx', + code: ` + import { createRootRoute } from '@tanstack/react-router' + + async function AsyncRoot() { + return
    Root
    + } + + export const Route = createRootRoute()({ + component: AsyncRoot, + }) + `, + errors: [ + { + messageId: 'asyncClientComponentDefinition', + }, + ], + }, + // Async in createRootRouteWithContext + { + filename: 'AsyncRootWithContext.tsx', + code: ` + import { createRootRouteWithContext, Outlet } from '@tanstack/react-router' + + interface MyRouterContext { + foo: string + } + + async function AsyncRoot() { + return
    Root
    + } + + const rootRoute = createRootRouteWithContext()({ + component: AsyncRoot, + }) + `, + errors: [ + { + messageId: 'asyncClientComponentDefinition', + }, + ], + }, + // Multiple async components in same file + { + filename: 'AsyncMultiple.tsx', + code: ` + import { createFileRoute } from '@tanstack/react-router' + + async function AsyncOne() { + return
    One
    + } + + async function AsyncTwo() { + return
    Two
    + } + + export const Route = createFileRoute('/')({ + component: AsyncOne, + pendingComponent: AsyncTwo, + }) + `, + errors: [ + { + messageId: 'asyncClientComponentDefinition', + }, + { + messageId: 'asyncClientComponentDefinition', + }, + ], + }, + ], +}) diff --git a/packages/eslint-plugin-start/src/__tests__/no-client-code-in-server-component.rule.test.ts b/packages/eslint-plugin-start/src/__tests__/no-client-code-in-server-component.rule.test.ts new file mode 100644 index 0000000000..39c780417f --- /dev/null +++ b/packages/eslint-plugin-start/src/__tests__/no-client-code-in-server-component.rule.test.ts @@ -0,0 +1,289 @@ +import * as path from 'node:path' +import { RuleTester } from '@typescript-eslint/rule-tester' +import * as vitest from 'vitest' + +import { + name, + rule, +} from '../rules/no-client-code-in-server-component/no-client-code-in-server-component.rule' + +RuleTester.afterAll = vitest.afterAll +RuleTester.it = ((name, fn) => + vitest.it(name, { timeout: 15000 }, fn)) as typeof RuleTester.it +RuleTester.itOnly = vitest.it.only +RuleTester.describe = vitest.describe + +const ruleTester = new RuleTester({ + languageOptions: { + parserOptions: { + ecmaFeatures: { + jsx: true, + }, + projectService: { + allowDefaultProject: ['*.tsx'], + }, + tsconfigRootDir: path.join(__dirname), + }, + }, +}) + +ruleTester.run(name, rule as any, { + valid: [ + // useId is allowed in server components + { + code: ` + import { createCompositeComponent } from '@tanstack/react-start/rsc' + + createCompositeComponent(() => { + const id = useId() + return
    Content
    + }) + `, + }, + // File with 'use client' is skipped entirely + { + code: ` + 'use client' + + import { useState } from 'react' + + function ClientComponent() { + const [state] = useState(0) + return + } + `, + }, + // Async server component is fine + { + code: ` + import { createCompositeComponent } from '@tanstack/react-start/rsc' + + createCompositeComponent(async () => { + const data = await fetch('/api/data') + return
    {data}
    + }) + `, + }, + // Regular function outside createCompositeComponent is fine + { + code: ` + function RegularComponent() { + const [state] = useState(0) + return + } + `, + }, + // Component passed as prop (slot) is allowed + { + code: ` + import { createCompositeComponent } from '@tanstack/react-start/rsc' + + createCompositeComponent(({ ActionButton }) => { + return
    + }) + `, + }, + // Component from destructured props is allowed + { + code: ` + import { createCompositeComponent } from '@tanstack/react-start/rsc' + + createCompositeComponent((props) => { + const { ActionButton } = props + return
    + }) + `, + }, + // Non-JSX attribute function is allowed (not an event handler) + { + code: ` + import { createCompositeComponent } from '@tanstack/react-start/rsc' + + createCompositeComponent(() => { + return
    Content
    + }) + `, + }, + // Static strings and primitives are fine + { + code: ` + import { createCompositeComponent } from '@tanstack/react-start/rsc' + + createCompositeComponent(() => { + const name = "John" + return
    {name}
    + }) + `, + }, + // Custom hook allowed via options + { + code: ` + import { createCompositeComponent } from '@tanstack/react-start/rsc' + + createCompositeComponent(() => { + const data = useServerData() + return
    {data}
    + }) + `, + options: [{ allowedServerHooks: ['useServerData'] }], + }, + ], + invalid: [ + // Hook in inline server component + { + code: ` + import { createCompositeComponent } from '@tanstack/react-start/rsc' + + createCompositeComponent(() => { + const [state] = useState(0) + return
    {state}
    + }) + `, + errors: [{ messageId: 'hookInServerComponent' }], + }, + // Browser API in server component + { + code: ` + import { createCompositeComponent } from '@tanstack/react-start/rsc' + + createCompositeComponent(() => { + const width = window.innerWidth + return
    {width}
    + }) + `, + errors: [{ messageId: 'browserGlobalInServerComponent' }], + }, + // Event handler in server component + { + code: ` + import { createCompositeComponent } from '@tanstack/react-start/rsc' + + createCompositeComponent(() => { + return + }) + `, + errors: [{ messageId: 'eventHandlerInServerComponent' }], + }, + // Event handler on intrinsic element (div) is also not allowed + { + code: ` + import { createCompositeComponent } from '@tanstack/react-start/rsc' + + createCompositeComponent(() => { + return
    {}}>Click
    + }) + `, + errors: [{ messageId: 'eventHandlerInServerComponent' }], + }, + // Multiple violations + { + code: ` + import { createCompositeComponent } from '@tanstack/react-start/rsc' + + createCompositeComponent(() => { + const [state] = useState(0) + const width = window.innerWidth + return + }) + `, + errors: [ + { messageId: 'hookInServerComponent' }, + { messageId: 'browserGlobalInServerComponent' }, + { messageId: 'eventHandlerInServerComponent' }, + ], + }, + // localStorage browser API + { + code: ` + import { createCompositeComponent } from '@tanstack/react-start/rsc' + + createCompositeComponent(() => { + const val = localStorage.getItem('key') + return
    {val}
    + }) + `, + errors: [{ messageId: 'browserGlobalInServerComponent' }], + }, + // document browser API + { + code: ` + import { createCompositeComponent } from '@tanstack/react-start/rsc' + + createCompositeComponent(() => { + const el = document.getElementById('foo') + return
    {el}
    + }) + `, + errors: [{ messageId: 'browserGlobalInServerComponent' }], + }, + // useEffect hook + { + code: ` + import { createCompositeComponent } from '@tanstack/react-start/rsc' + + createCompositeComponent(() => { + useEffect(() => {}, []) + return
    Content
    + }) + `, + errors: [{ messageId: 'hookInServerComponent' }], + }, + // useRef hook + { + code: ` + import { createCompositeComponent } from '@tanstack/react-start/rsc' + + createCompositeComponent(() => { + const ref = useRef(null) + return
    Content
    + }) + `, + errors: [{ messageId: 'hookInServerComponent' }], + }, + // useContext hook + { + code: ` + import { createCompositeComponent } from '@tanstack/react-start/rsc' + + createCompositeComponent(() => { + const ctx = useContext(MyContext) + return
    {ctx}
    + }) + `, + errors: [{ messageId: 'hookInServerComponent' }], + }, + // onSubmit event handler + { + code: ` + import { createCompositeComponent } from '@tanstack/react-start/rsc' + + createCompositeComponent(() => { + return
    {}}>Submit
    + }) + `, + errors: [{ messageId: 'eventHandlerInServerComponent' }], + }, + // onChange event handler + { + code: ` + import { createCompositeComponent } from '@tanstack/react-start/rsc' + + createCompositeComponent(() => { + return {}} /> + }) + `, + errors: [{ messageId: 'eventHandlerInServerComponent' }], + }, + // onMouseEnter event handler + { + code: ` + import { createCompositeComponent } from '@tanstack/react-start/rsc' + + createCompositeComponent(() => { + return
    {}}>Hover
    + }) + `, + errors: [{ messageId: 'eventHandlerInServerComponent' }], + }, + ], +}) diff --git a/packages/eslint-plugin-start/src/__tests__/tsconfig.json b/packages/eslint-plugin-start/src/__tests__/tsconfig.json new file mode 100644 index 0000000000..1f4ecae36f --- /dev/null +++ b/packages/eslint-plugin-start/src/__tests__/tsconfig.json @@ -0,0 +1,13 @@ +{ + "compilerOptions": { + "target": "ES2020", + "module": "ESNext", + "moduleResolution": "Bundler", + "strict": true, + "jsx": "react-jsx", + "esModuleInterop": true, + "skipLibCheck": true, + "noEmit": true + }, + "include": ["./**/*"] +} diff --git a/packages/eslint-plugin-start/src/index.ts b/packages/eslint-plugin-start/src/index.ts new file mode 100644 index 0000000000..a6815a6328 --- /dev/null +++ b/packages/eslint-plugin-start/src/index.ts @@ -0,0 +1,45 @@ +import { rules } from './rules' +import type { ESLint, Linter } from 'eslint' +import type { RuleModule } from '@typescript-eslint/utils/ts-eslint' + +type RuleKey = keyof typeof rules + +interface Plugin extends Omit { + rules: Record> + configs: { + recommended: ESLint.ConfigData + 'flat/recommended': Array + } +} + +const plugin: Plugin = { + meta: { + name: '@tanstack/eslint-plugin-start', + }, + configs: {} as Plugin['configs'], + rules, +} + +// Assign configs here so we can reference `plugin` +Object.assign(plugin.configs, { + recommended: { + plugins: ['@tanstack/eslint-plugin-start'], + rules: { + '@tanstack/start/no-client-code-in-server-component': 'error', + '@tanstack/start/no-async-client-component': 'error', + }, + }, + 'flat/recommended': [ + { + plugins: { + '@tanstack/start': plugin, + }, + rules: { + '@tanstack/start/no-client-code-in-server-component': 'error', + '@tanstack/start/no-async-client-component': 'error', + }, + }, + ], +}) + +export default plugin diff --git a/packages/eslint-plugin-start/src/rules.ts b/packages/eslint-plugin-start/src/rules.ts new file mode 100644 index 0000000000..01df0f0239 --- /dev/null +++ b/packages/eslint-plugin-start/src/rules.ts @@ -0,0 +1,17 @@ +import * as noClientCodeInServerComponent from './rules/no-client-code-in-server-component/no-client-code-in-server-component.rule' +import * as noAsyncClientComponent from './rules/no-async-client-component/no-async-client-component.rule' +import type { ESLintUtils } from '@typescript-eslint/utils' +import type { ExtraRuleDocs } from './types' + +export const rules: Record< + string, + ESLintUtils.RuleModule< + string, + ReadonlyArray, + ExtraRuleDocs, + ESLintUtils.RuleListener + > +> = { + [noClientCodeInServerComponent.name]: noClientCodeInServerComponent.rule, + [noAsyncClientComponent.name]: noAsyncClientComponent.rule, +} diff --git a/packages/eslint-plugin-start/src/rules/no-async-client-component/async-component-detector.ts b/packages/eslint-plugin-start/src/rules/no-async-client-component/async-component-detector.ts new file mode 100644 index 0000000000..cf377ac6c4 --- /dev/null +++ b/packages/eslint-plugin-start/src/rules/no-async-client-component/async-component-detector.ts @@ -0,0 +1,121 @@ +import type ts from 'typescript' + +export interface AsyncComponentInfo { + name: string + fileName: string + node: ts.FunctionDeclaration | ts.VariableDeclaration + line: number +} + +/** + * Detects async function components in a TypeScript source file. + * A component is identified by: + * - PascalCase name (starts with uppercase) + * - async function declaration or const assigned to async arrow/function + */ +export function createAsyncComponentDetector(tsLib: typeof ts) { + return { + /** + * Find all async components in a source file + */ + detectAsyncComponents( + sourceFile: ts.SourceFile, + ): Array { + const asyncComponents: Array = [] + + function visit(node: ts.Node): void { + // async function MyComponent() { ... } + if ( + tsLib.isFunctionDeclaration(node) && + node.name && + isPascalCase(node.name.text) && + hasAsyncModifier(node) + ) { + asyncComponents.push({ + name: node.name.text, + fileName: sourceFile.fileName, + node, + line: + sourceFile.getLineAndCharacterOfPosition(node.getStart()).line + + 1, + }) + } + + // const MyComponent = async () => { ... } + // const MyComponent = async function() { ... } + if (tsLib.isVariableStatement(node)) { + for (const decl of node.declarationList.declarations) { + if ( + tsLib.isIdentifier(decl.name) && + isPascalCase(decl.name.text) && + decl.initializer && + isAsyncFunctionLike(decl.initializer) + ) { + asyncComponents.push({ + name: decl.name.text, + fileName: sourceFile.fileName, + node: decl, + line: + sourceFile.getLineAndCharacterOfPosition(decl.getStart()) + .line + 1, + }) + } + } + } + + tsLib.forEachChild(node, visit) + } + + visit(sourceFile) + return asyncComponents + }, + + /** + * Check if a specific function node is async + */ + isAsyncFunction(node: ts.Node): boolean { + if ( + tsLib.isFunctionDeclaration(node) || + tsLib.isFunctionExpression(node) + ) { + return hasAsyncModifier(node) + } + if (tsLib.isArrowFunction(node)) { + return hasAsyncModifier(node) + } + return false + }, + } + + function isPascalCase(name: string): boolean { + return /^[A-Z]/.test(name) + } + + function hasAsyncModifier( + node: + | ts.FunctionDeclaration + | ts.FunctionExpression + | ts.ArrowFunction + | ts.MethodDeclaration, + ): boolean { + return ( + node.modifiers?.some( + (mod) => mod.kind === tsLib.SyntaxKind.AsyncKeyword, + ) ?? false + ) + } + + function isAsyncFunctionLike(node: ts.Node): boolean { + if (tsLib.isArrowFunction(node)) { + return hasAsyncModifier(node) + } + if (tsLib.isFunctionExpression(node)) { + return hasAsyncModifier(node) + } + return false + } +} + +export type AsyncComponentDetector = ReturnType< + typeof createAsyncComponentDetector +> diff --git a/packages/eslint-plugin-start/src/rules/no-async-client-component/constants.ts b/packages/eslint-plugin-start/src/rules/no-async-client-component/constants.ts new file mode 100644 index 0000000000..ffc2809518 --- /dev/null +++ b/packages/eslint-plugin-start/src/rules/no-async-client-component/constants.ts @@ -0,0 +1,27 @@ +/** + * Route option names that accept component references. + * These make the referenced component a "client root". + */ +export const ROUTE_COMPONENT_OPTION_NAMES = [ + 'component', + 'pendingComponent', + 'errorComponent', + 'notFoundComponent', +] as const + +/** + * Function names that create routes (client entry points). + */ +export const ROUTE_CREATOR_NAMES = [ + 'createFileRoute', + 'createRootRoute', + 'createRootRouteWithContext', +] as const + +/** + * Function names that create server-component roots. + */ +export const SERVER_COMPONENT_ROOTS = [ + 'renderServerComponent', + 'createCompositeComponent', +] as const diff --git a/packages/eslint-plugin-start/src/rules/no-async-client-component/context-analyzer.ts b/packages/eslint-plugin-start/src/rules/no-async-client-component/context-analyzer.ts new file mode 100644 index 0000000000..126019e93f --- /dev/null +++ b/packages/eslint-plugin-start/src/rules/no-async-client-component/context-analyzer.ts @@ -0,0 +1,203 @@ +import type { + ComponentInfo, + RenderEdge, + RenderGraph, +} from './render-graph-builder' + +export type ClientReason = + | { type: 'use-client'; fileName: string } + | { + type: 'route-option' + fileName: string + usageFile?: string + usageNode?: unknown + usageLine?: number + } + | { type: 'rendered-by-client'; parentComponent: string; parentFile: string } + +export interface ComponentContext { + key: string + component: ComponentInfo + isServerContext: boolean + isClientContext: boolean + clientReason?: ClientReason +} + +export interface ContextAnalysisResult { + /** Map of component key -> context info */ + contexts: Map + /** Edges where caller is in client context (for usage-site reporting) */ + clientEdges: Array +} + +/** + * Analyzes the render graph to propagate server/client context. + * + * Algorithm: + * 1. Mark server roots as server context, propagate to descendants + * 2. Stop propagation at 'use client' boundaries + * 3. Mark client roots as client context, propagate to descendants + * 4. Components reachable from both => client wins (tainted) + + */ +export function analyzeContext(graph: RenderGraph): ContextAnalysisResult { + const contexts = new Map() + + // Initialize all components with unknown context + for (const [key, component] of graph.components) { + contexts.set(key, { + key, + component, + isServerContext: false, + isClientContext: false, + }) + } + + // Build adjacency list for efficient traversal + const adjacency = buildAdjacencyList(graph.edges) + + // Phase 1: Propagate server context from server roots + const serverVisited = new Set() + for (const serverRoot of graph.serverRoots) { + propagateServerContext( + serverRoot, + serverVisited, + graph, + contexts, + adjacency, + ) + } + + // Phase 2: Propagate client context from client roots + const clientVisited = new Set() + for (const clientRoot of graph.clientRoots) { + const ctx = contexts.get(clientRoot) + if (!ctx) continue + + let reason: ClientReason + if (graph.useClientFiles.has(ctx.component.fileName)) { + reason = { type: 'use-client', fileName: ctx.component.fileName } + } else { + const routeUsage = graph.routeOptionUsages.get(clientRoot) + reason = { + type: 'route-option', + fileName: ctx.component.fileName, + usageFile: routeUsage?.fileName, + usageNode: routeUsage?.usageNode, + usageLine: routeUsage?.usageLine, + } + } + + propagateClientContext( + clientRoot, + clientVisited, + contexts, + adjacency, + reason, + ) + } + + // Phase 3: Components in 'use client' files are always client + for (const [_key, ctx] of contexts) { + if ( + graph.useClientFiles.has(ctx.component.fileName) && + !ctx.isClientContext + ) { + ctx.isClientContext = true + ctx.clientReason = { + type: 'use-client', + fileName: ctx.component.fileName, + } + } + } + + // Collect edges where caller is in client context + const clientEdges: Array = [] + for (const edge of graph.edges) { + const fromKey = `${edge.fromFile}:${edge.fromComponent}` + const fromCtx = contexts.get(fromKey) + if (fromCtx?.isClientContext) { + clientEdges.push(edge) + } + } + + return { contexts, clientEdges } +} + +function buildAdjacencyList( + edges: Array, +): Map> { + const adj = new Map>() + for (const edge of edges) { + const fromKey = `${edge.fromFile}:${edge.fromComponent}` + if (!adj.has(fromKey)) { + adj.set(fromKey, []) + } + adj.get(fromKey)!.push(edge) + } + return adj +} + +function propagateServerContext( + key: string, + visited: Set, + graph: RenderGraph, + contexts: Map, + adjacency: Map>, +): void { + if (visited.has(key)) return + visited.add(key) + + const ctx = contexts.get(key) + if (!ctx) return + + // Stop at 'use client' boundary + if (graph.useClientFiles.has(ctx.component.fileName)) { + ctx.isClientContext = true + ctx.clientReason = { type: 'use-client', fileName: ctx.component.fileName } + return + } + + ctx.isServerContext = true + + // Propagate to children + const edges = adjacency.get(key) ?? [] + for (const edge of edges) { + propagateServerContext( + edge.toComponentKey, + visited, + graph, + contexts, + adjacency, + ) + } +} + +function propagateClientContext( + key: string, + visited: Set, + contexts: Map, + adjacency: Map>, + reason: ClientReason, +): void { + if (visited.has(key)) return + visited.add(key) + + const ctx = contexts.get(key) + if (!ctx) return + + ctx.isClientContext = true + if (!ctx.clientReason) { + ctx.clientReason = reason + } + + // Propagate to children + const edges = adjacency.get(key) ?? [] + for (const edge of edges) { + propagateClientContext(edge.toComponentKey, visited, contexts, adjacency, { + type: 'rendered-by-client', + parentComponent: ctx.component.name, + parentFile: ctx.component.fileName, + }) + } +} diff --git a/packages/eslint-plugin-start/src/rules/no-async-client-component/no-async-client-component.rule.ts b/packages/eslint-plugin-start/src/rules/no-async-client-component/no-async-client-component.rule.ts new file mode 100644 index 0000000000..54a69a6fb8 --- /dev/null +++ b/packages/eslint-plugin-start/src/rules/no-async-client-component/no-async-client-component.rule.ts @@ -0,0 +1,430 @@ +import path from 'node:path' +import { ESLintUtils } from '@typescript-eslint/utils' +import * as ts from 'typescript' +import { getDocsUrl } from '../../utils/get-docs-url' +import { createRenderGraphBuilder } from './render-graph-builder' +import { analyzeContext } from './context-analyzer' +import type { ClientReason, ContextAnalysisResult } from './context-analyzer' +import type { ExtraRuleDocs } from '../../types' + +export const name = 'no-async-client-component' + +// Cache full graph per program (built rarely due to gating). +const perProgramCache = new WeakMap< + ts.Program, + { + builder: ReturnType + graphBuilt: boolean + } +>() + +// Cache for on-demand subgraph analysis per entry file +const onDemandCache = new WeakMap< + ts.Program, + Map< + string, + { + graph: ReturnType['getGraph']> + analysis: ContextAnalysisResult + } + > +>() + +// Cache adjacency per program to avoid O(allEdges) scans while slicing +const adjacencyCache = new WeakMap>>() + +export const rule = ESLintUtils.RuleCreator(getDocsUrl)({ + name, + meta: { + type: 'problem', + docs: { + description: + 'Disallow async components in client context. Async components are only valid inside server components.', + + recommended: 'error', + }, + schema: [ + { + type: 'object', + properties: { + ignorePatterns: { + type: 'array', + items: { type: 'string' }, + description: 'File patterns to ignore', + }, + }, + additionalProperties: false, + }, + ], + messages: { + asyncClientComponentDefinition: + 'Async component "{{name}}" cannot be used in client context. ' + + 'Async components are only valid inside server components. ' + + 'Either remove "async" or ensure this component is only rendered within server components. ' + + '{{reason}}', + asyncClientComponentUsage: + 'Async component "{{name}}" is rendered in client context here. ' + + 'Async components are only valid inside server components. ' + + 'Move this to a server component or use a non-async version.', + }, + }, + defaultOptions: [{ ignorePatterns: [] }] as const, + create(context, [options]) { + const services = ESLintUtils.getParserServices(context) + const program = services.program + const checker = program.getTypeChecker() + // Normalize the current file path to absolute + const currentFile = path.isAbsolute(context.filename) + ? context.filename + : path.resolve(context.cwd, context.filename) + + // Check if file should be ignored + const ignorePatterns = [...options.ignorePatterns] + if (shouldIgnore(currentFile, ignorePatterns)) { + return {} + } + + // Build full graph once (still gated per-file above). + let cached = perProgramCache.get(program) + if (!cached) { + const builder = createRenderGraphBuilder(ts, program, checker) + cached = { builder, graphBuilt: false } + perProgramCache.set(program, cached) + } + + // Track reported to avoid duplicates + const reported = new Set() + + return { + Program() { + // Fast path: if current file can’t introduce client roots, skip. + // This avoids full-program graph build for most files. + const sourceFile = program.getSourceFile(currentFile) + if ( + !sourceFile || + (!fileContainsRouteOptions(sourceFile) && + !fileContainsServerComponentRoots(sourceFile) && + !fileHasUseClientDirective(sourceFile)) + ) { + return + } + + // Ensure route-option cases are always analyzed (e2e runs ESLint per-file). + // On-demand caching is still used for perf; this just avoids missing route roots. + if (fileContainsRouteOptions(sourceFile)) { + // no-op: gate ensures analysis runs + } + + // On-demand: build only the subgraph reachable from this file's entry points, + // then analyze contexts within that subgraph. + const analysis = getOnDemandAnalysis(currentFile) + + // Report async components in client context + for (const [key, ctx] of analysis.contexts) { + if (!ctx.component.isAsync || !ctx.isClientContext) { + continue + } + + const reportKey = `def:${key}` + if (reported.has(reportKey)) continue + + // For route-option cases, ONLY report at usage site (in the route file) + if (ctx.clientReason?.type === 'route-option') { + const usageFile = ctx.clientReason.usageFile + if (usageFile && usageFile === currentFile) { + const usageTsNode = ctx.clientReason.usageNode as ts.Node + const usageEslintNode = + services.tsNodeToESTreeNodeMap.get(usageTsNode) + // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- Map.get() can return undefined + if (usageEslintNode) { + reported.add(reportKey) + context.report({ + node: usageEslintNode, + messageId: 'asyncClientComponentDefinition', + data: { + name: ctx.component.name, + reason: formatReason(ctx.clientReason, context.cwd), + }, + }) + } + } + continue + } + + reported.add(reportKey) + + // For other cases (use-client, rendered-by-client): report at definition site + const tsNode = ctx.component.node + const eslintNode = services.tsNodeToESTreeNodeMap.get(tsNode) + + // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- Map.get() can return undefined + if (eslintNode) { + context.report({ + node: eslintNode, + messageId: 'asyncClientComponentDefinition', + data: { + name: ctx.component.name, + reason: ctx.clientReason + ? formatReason(ctx.clientReason, context.cwd) + : '', + }, + }) + } + } + + // Report usage sites where async component is rendered in client context + for (const edge of analysis.clientEdges) { + const targetCtx = analysis.contexts.get(edge.toComponentKey) + if (!targetCtx?.component.isAsync) continue + + if (edge.fromFile !== currentFile) continue + + const reportKey = `usage:${edge.fromFile}:${edge.jsxLine}:${edge.toComponent}` + if (reported.has(reportKey)) continue + reported.add(reportKey) + + const eslintNode = services.tsNodeToESTreeNodeMap.get(edge.jsxNode) + // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- Map.get() can return undefined + if (eslintNode) { + context.report({ + node: eslintNode, + messageId: 'asyncClientComponentUsage', + data: { + name: edge.toComponent, + }, + }) + } + } + }, + } + + function shouldIgnore(filePath: string, patterns: Array): boolean { + for (const pattern of patterns) { + if (filePath.includes(pattern)) { + return true + } + } + return false + } + + function formatReason(reason: ClientReason, cwd: string): string { + switch (reason.type) { + case 'use-client': + return `File has "use client" directive.` + case 'route-option': + return `Component is referenced by a route option (createFileRoute/createRootRoute).` + case 'rendered-by-client': + return `Rendered by client component "${reason.parentComponent}" in ${path.relative(cwd, reason.parentFile)}.` + } + } + + function getOnDemandAnalysis(entryFile: string): ContextAnalysisResult { + let programCache = onDemandCache.get(program) + if (!programCache) { + programCache = new Map() + onDemandCache.set(program, programCache) + } + + const cachedResult = programCache.get(entryFile) + if (cachedResult) return cachedResult.analysis + + // Build a complete graph once (still gated), then slice it to + // only what’s reachable from entry points in `entryFile`. + if (!cached!.graphBuilt) { + cached!.builder.build() + cached!.graphBuilt = true + } + const full = cached!.builder.getGraph() + + const subgraph = sliceGraphForEntryFile(full, entryFile) + + const entrySourceFile = program.getSourceFile(entryFile) + const shouldFallbackToFull = + !!entrySourceFile && + fileContainsRouteOptions(entrySourceFile) && + subgraph.clientRoots.size === 0 && + subgraph.serverRoots.size === 0 + + // Fallback: if slicing yields nothing but file has route options, analyze full graph. + const analysis = shouldFallbackToFull + ? analyzeContext(full) + : analyzeContext(subgraph) + + programCache.set(entryFile, { graph: subgraph, analysis }) + return analysis + } + + function sliceGraphForEntryFile( + full: ReturnType< + typeof createRenderGraphBuilder + >['getGraph'] extends () => infer G + ? G + : never, + entryFile: string, + ) { + const components = full.components + const edges = full.edges + const serverRoots = full.serverRoots + const clientRoots = full.clientRoots + const useClientFiles = full.useClientFiles + const routeOptionUsages = full.routeOptionUsages + + // Determine entry roots from this file. + const entryClientRoots = new Set() + const entryServerRoots = new Set() + + // Use the indexed routeOptionRootsByFile for O(roots-in-file) lookup + const routeRootsInFile = + routeOptionUsages.size > 0 + ? full.routeOptionRootsByFile.get(entryFile) + : undefined + if (routeRootsInFile) { + for (const key of routeRootsInFile) { + if (clientRoots.has(key)) { + entryClientRoots.add(key) + } + } + } + + for (const key of serverRoots) { + const component = components.get(key) + if (component?.fileName === entryFile) { + entryServerRoots.add(key) + } + } + + // If it’s a use-client file, also treat local components as client roots. + if (useClientFiles.has(entryFile)) { + for (const [key, component] of components) { + if (component.fileName === entryFile) { + entryClientRoots.add(key) + } + } + } + + const reachable = new Set() + const queue: Array = [] + for (const r of entryClientRoots) queue.push(r) + for (const r of entryServerRoots) queue.push(r) + + const adjacency = getAdjacency(full) + + while (queue.length) { + const key = queue.pop()! + if (reachable.has(key)) continue + reachable.add(key) + + const children = adjacency.get(key) + if (!children) continue + for (const toKey of children) { + if (!reachable.has(toKey)) { + queue.push(toKey) + } + } + } + + const subComponents = new Map() + for (const key of reachable) { + const comp = components.get(key) + if (comp) subComponents.set(key, comp) + } + + const subEdges = edges.filter((edge) => { + const fromKey = `${edge.fromFile}:${edge.fromComponent}` + return reachable.has(fromKey) && reachable.has(edge.toComponentKey) + }) + + const subServerRoots = new Set( + [...entryServerRoots].filter((k) => reachable.has(k)), + ) + const subClientRoots = new Set( + [...entryClientRoots].filter((k) => reachable.has(k)), + ) + + // Keep only routeUsage for roots we kept. + const subRouteOptionUsages = new Map() + const subRouteOptionRootsByFile = new Map>() + for (const key of subClientRoots) { + const usage = routeOptionUsages.get(key) + if (usage) { + subRouteOptionUsages.set(key, usage) + let set = subRouteOptionRootsByFile.get(usage.fileName) + if (!set) { + set = new Set() + subRouteOptionRootsByFile.set(usage.fileName, set) + } + set.add(key) + } + } + + return { + components: subComponents, + edges: subEdges, + serverRoots: subServerRoots, + clientRoots: subClientRoots, + useClientFiles, + routeOptionUsages: subRouteOptionUsages, + routeOptionRootsByFile: subRouteOptionRootsByFile, + } + } + + function getAdjacency(full: { edges: Array }) { + let cachedAdjacency = adjacencyCache.get(program) + if (cachedAdjacency) return cachedAdjacency + + cachedAdjacency = new Map() + for (const edge of full.edges) { + const fromKey = `${edge.fromFile}:${edge.fromComponent}` + let set = cachedAdjacency.get(fromKey) + if (!set) { + set = new Set() + cachedAdjacency.set(fromKey, set) + } + set.add(edge.toComponentKey) + } + + adjacencyCache.set(program, cachedAdjacency) + return cachedAdjacency + } + + function fileHasUseClientDirective(sourceFile: ts.SourceFile): boolean { + const firstStmt = sourceFile.statements[0] + if (!firstStmt) return false + return ( + ts.isExpressionStatement(firstStmt) && + ts.isStringLiteral(firstStmt.expression) && + firstStmt.expression.text === 'use client' + ) + } + + function fileContainsServerComponentRoots( + sourceFile: ts.SourceFile, + ): boolean { + // Cheaper than full AST traversal; ok since this is only a gate. + const text = sourceFile.text + return ( + text.includes('renderServerComponent') || + text.includes('createCompositeComponent') + ) + } + + function fileContainsRouteOptions(sourceFile: ts.SourceFile): boolean { + // Cheaper than full AST traversal; ok since this is only a gate. + const text = sourceFile.text + if ( + !text.includes('createFileRoute') && + !text.includes('createRootRoute') && + !text.includes('createRootRouteWithContext') + ) { + return false + } + + return ( + text.includes('component') || + text.includes('pendingComponent') || + text.includes('errorComponent') || + text.includes('notFoundComponent') + ) + } + }, +}) diff --git a/packages/eslint-plugin-start/src/rules/no-async-client-component/render-graph-builder.ts b/packages/eslint-plugin-start/src/rules/no-async-client-component/render-graph-builder.ts new file mode 100644 index 0000000000..3b736da2d9 --- /dev/null +++ b/packages/eslint-plugin-start/src/rules/no-async-client-component/render-graph-builder.ts @@ -0,0 +1,551 @@ +import { + ROUTE_COMPONENT_OPTION_NAMES, + ROUTE_CREATOR_NAMES, + SERVER_COMPONENT_ROOTS, +} from './constants' +import type ts from 'typescript' + +export interface ComponentInfo { + name: string + fileName: string + node: ts.Node + isAsync: boolean + line: number +} + +export interface RenderEdge { + fromFile: string + fromComponent: string + toFile: string + toComponent: string + toComponentKey: string + jsxNode: ts.Node + jsxLine: number +} + +export interface RouteOptionUsage { + componentKey: string + usageNode: ts.Node + usageLine: number + fileName: string +} + +export interface RenderGraph { + /** Map of "fileName:ComponentName" -> ComponentInfo */ + components: Map + /** All render edges (component -> component via JSX) */ + edges: Array + /** Components under server-component roots */ + serverRoots: Set + /** Components referenced by route options or in 'use client' files */ + clientRoots: Set + /** Files with 'use client' directive */ + useClientFiles: Set + /** Route option usage info for better error locations */ + routeOptionUsages: Map + /** Index: file name -> component keys referenced by route options in that file */ + routeOptionRootsByFile: Map> +} + +/** + * Builds a render graph from the TypeScript program. + * Indexes components, JSX edges, server roots, and client roots. + */ +export function createRenderGraphBuilder( + tsLib: typeof ts, + program: ts.Program, + checker: ts.TypeChecker, +) { + const graph: RenderGraph = { + components: new Map(), + edges: [], + serverRoots: new Set(), + clientRoots: new Set(), + useClientFiles: new Set(), + routeOptionUsages: new Map(), + routeOptionRootsByFile: new Map(), + } + + return { + build(): RenderGraph { + for (const sourceFile of program.getSourceFiles()) { + if (sourceFile.isDeclarationFile) continue + if (sourceFile.fileName.includes('node_modules')) continue + + // Pre-filter: skip files that can't contribute to the render graph + if (!fileCanContribute(sourceFile)) continue + + processSourceFile(sourceFile) + } + return graph + }, + + getGraph(): RenderGraph { + return graph + }, + } + + /** + * Quick text-based check to skip files that can't contribute edges or roots. + * A file can contribute if it might have: + * - JSX (components, edges) + * - 'use client' directive (client roots) + * - createFileRoute/createRootRoute (route-option roots) + * - renderServerComponent/createCompositeComponent (server roots) + + */ + function fileCanContribute(sourceFile: ts.SourceFile): boolean { + const text = sourceFile.text + + // Quick check: has JSX-like syntax or relevant keywords + // Must handle both and + const hasJsx = + text.includes('<') && (text.includes('/>') || text.includes(' + text.includes(name), + ) + + return hasJsx || hasUseClient || hasRouteCreator || hasServerComponentRoot + } + + function processSourceFile(sourceFile: ts.SourceFile): void { + // Check for 'use client' directive + if (hasUseClientDirective(sourceFile)) { + graph.useClientFiles.add(sourceFile.fileName) + } + + // Walk AST + visitNode(sourceFile, sourceFile, null) + } + + function hasUseClientDirective(sourceFile: ts.SourceFile): boolean { + const firstStatement = sourceFile.statements[0] + if (!firstStatement) return false + + if ( + tsLib.isExpressionStatement(firstStatement) && + tsLib.isStringLiteral(firstStatement.expression) && + firstStatement.expression.text === 'use client' + ) { + return true + } + return false + } + + function visitNode( + node: ts.Node, + sourceFile: ts.SourceFile, + currentComponent: string | null, + ): void { + // Index component definitions + if (tsLib.isFunctionDeclaration(node) && node.name) { + if (isPascalCase(node.name.text)) { + const key = makeKey(sourceFile.fileName, node.name.text) + graph.components.set(key, { + name: node.name.text, + fileName: sourceFile.fileName, + node, + isAsync: hasAsyncModifier(node), + line: getLine(sourceFile, node), + }) + + // If file has 'use client', mark as client root + if (graph.useClientFiles.has(sourceFile.fileName)) { + graph.clientRoots.add(key) + } + + // Visit body with this component as context + if (node.body) { + tsLib.forEachChild(node.body, (child) => + visitNode(child, sourceFile, key), + ) + } + return + } + } + + // const MyComponent = () => { ... } or const MyComponent = function() { ... } + if (tsLib.isVariableStatement(node)) { + for (const decl of node.declarationList.declarations) { + if ( + tsLib.isIdentifier(decl.name) && + isPascalCase(decl.name.text) && + decl.initializer && + isFunctionLike(decl.initializer) + ) { + const key = makeKey(sourceFile.fileName, decl.name.text) + graph.components.set(key, { + name: decl.name.text, + fileName: sourceFile.fileName, + node: decl, + isAsync: isAsyncFunctionLike(decl.initializer), + line: getLine(sourceFile, decl), + }) + + if (graph.useClientFiles.has(sourceFile.fileName)) { + graph.clientRoots.add(key) + } + + // Visit body with this component as context + const funcNode = decl.initializer as + | ts.ArrowFunction + | ts.FunctionExpression + tsLib.forEachChild(funcNode.body, (child) => + visitNode(child, sourceFile, key), + ) + } else if (decl.initializer) { + // For non-component variable declarations (like route definitions), + // visit the initializer to detect route creator calls + visitNode(decl.initializer, sourceFile, currentComponent) + } + } + return + } + + // Detect server-component roots + // - createCompositeComponent((props) => <...>) + // - renderServerComponent(<...>) + if (tsLib.isCallExpression(node)) { + const serverRootKind = getServerRootKind(node, checker) + if (serverRootKind === 'createCompositeComponent') { + const callback = node.arguments[0] + if (callback && isFunctionLike(callback)) { + collectJsxComponentRefs(callback, sourceFile, currentComponent, true) + } + return + } + + if (serverRootKind === 'renderServerComponent') { + const element = node.arguments[0] + if (element) { + collectJsxComponentRefs(element, sourceFile, currentComponent, true) + } + return + } + } + + // Detect createFileRoute/createRootRoute/createRootRouteWithContext()({ component: X }) + if (tsLib.isCallExpression(node)) { + const routeOptions = getRouteOptionsObject(node) + if (routeOptions) { + for (const prop of routeOptions.properties) { + if ( + tsLib.isPropertyAssignment(prop) && + tsLib.isIdentifier(prop.name) && + ROUTE_COMPONENT_OPTION_NAMES.includes( + prop.name.text as (typeof ROUTE_COMPONENT_OPTION_NAMES)[number], + ) + ) { + markAsClientRoot( + prop.initializer, + sourceFile, + currentComponent, + prop, + ) + } + } + } + } + + // Detect JSX usage: + if ( + tsLib.isJsxOpeningElement(node) || + tsLib.isJsxSelfClosingElement(node) + ) { + const tagName = node.tagName + if (tsLib.isIdentifier(tagName) && isPascalCase(tagName.text)) { + // Try to resolve the component + const symbol = checker.getSymbolAtLocation(tagName) + if (symbol) { + const resolved = resolveSymbol(symbol) + if (resolved) { + const decls = resolved.getDeclarations() + if (decls && decls.length > 0) { + const declFile = decls[0]!.getSourceFile().fileName + const toKey = makeKey(declFile, tagName.text) + + if (currentComponent) { + graph.edges.push({ + fromFile: sourceFile.fileName, + fromComponent: currentComponent.split(':')[1]!, + toFile: declFile, + toComponent: tagName.text, + toComponentKey: toKey, + jsxNode: node, + jsxLine: getLine(sourceFile, node), + }) + } + } + } + } + } + } + + tsLib.forEachChild(node, (child) => + visitNode(child, sourceFile, currentComponent), + ) + return + } + + function getServerRootKind( + node: ts.CallExpression, + _checker: ts.TypeChecker, + ): (typeof SERVER_COMPONENT_ROOTS)[number] | null { + if (tsLib.isIdentifier(node.expression)) { + const name = node.expression.text + return SERVER_COMPONENT_ROOTS.includes( + name as (typeof SERVER_COMPONENT_ROOTS)[number], + ) + ? (name as (typeof SERVER_COMPONENT_ROOTS)[number]) + : null + } + + if ( + tsLib.isPropertyAccessExpression(node.expression) && + tsLib.isIdentifier(node.expression.name) + ) { + const name = node.expression.name.text + return SERVER_COMPONENT_ROOTS.includes( + name as (typeof SERVER_COMPONENT_ROOTS)[number], + ) + ? (name as (typeof SERVER_COMPONENT_ROOTS)[number]) + : null + } + + return null + } + + function getRouteOptionsObject( + node: ts.CallExpression, + ): ts.ObjectLiteralExpression | undefined { + // Matches route options call patterns: + // - createFileRoute('/x')({ ... }) + // - createRootRoute()({ ... }) + // - createRootRouteWithContext()({ ... }) + // - plus common chaining/currying where the creator call is nested + + // We only care about the call expression that receives the options object. + const optionsArg = node.arguments[0] + if (!optionsArg || !tsLib.isObjectLiteralExpression(optionsArg)) { + return + } + + // Accept any call where the callee ultimately originates from a route creator. + // Examples: + // createFileRoute('/x')({}) + // createFileRoute('/x').update({})(...) + // (createFileRoute('/x'))({}) + const routeCreator = findRouteCreatorFromCallee(node.expression) + if (!routeCreator) return + + const routeCreatorName = tsLib.isIdentifier(routeCreator) + ? routeCreator.text + : routeCreator.name.text + + if ( + ROUTE_CREATOR_NAMES.includes( + routeCreatorName as (typeof ROUTE_CREATOR_NAMES)[number], + ) + ) { + return optionsArg + } + + return + } + + function findRouteCreatorFromCallee( + expr: ts.Expression, + ): ts.Identifier | ts.PropertyAccessExpression | undefined { + // OUTER call has callee like: CallExpression or PropertyAccessExpression, etc. + // Walk back through call/property/paren nodes to find the originating identifier. + + if (tsLib.isParenthesizedExpression(expr)) { + return findRouteCreatorFromCallee(expr.expression) + } + + if (tsLib.isCallExpression(expr)) { + return findRouteCreatorFromCallee(expr.expression) + } + + if (tsLib.isPropertyAccessExpression(expr)) { + // foo.bar -> keep walking left side, but allow final `.createFileRoute` access. + if (tsLib.isIdentifier(expr.name)) { + if ( + ROUTE_CREATOR_NAMES.includes( + expr.name.text as (typeof ROUTE_CREATOR_NAMES)[number], + ) + ) { + return expr + } + } + return findRouteCreatorFromCallee(expr.expression) + } + + if (tsLib.isIdentifier(expr)) { + return expr + } + + return + } + + function markAsClientRoot( + node: ts.Node, + sourceFile: ts.SourceFile, + _currentComponent: string | null, + usageNode?: ts.Node, + ): void { + // Direct identifier reference: component: MyComponent + if (tsLib.isIdentifier(node)) { + const componentName = node.text + + // First, try to find by symbol resolution + const symbol = checker.getSymbolAtLocation(node) + if (symbol) { + const resolved = resolveSymbol(symbol) + if (resolved) { + const decls = resolved.getDeclarations() + if (decls && decls.length > 0) { + const declFile = decls[0]!.getSourceFile().fileName + const key = makeKey(declFile, componentName) + graph.clientRoots.add(key) + if (usageNode) { + graph.routeOptionUsages.set(key, { + componentKey: key, + usageNode, + usageLine: getLine(sourceFile, usageNode), + fileName: sourceFile.fileName, + }) + addToRouteOptionRootsByFile(sourceFile.fileName, key) + } + return + } + } + } + + // Fallback: assume it's in the same file + const fallbackKey = makeKey(sourceFile.fileName, componentName) + graph.clientRoots.add(fallbackKey) + if (usageNode) { + graph.routeOptionUsages.set(fallbackKey, { + componentKey: fallbackKey, + usageNode, + usageLine: getLine(sourceFile, usageNode), + fileName: sourceFile.fileName, + }) + addToRouteOptionRootsByFile(sourceFile.fileName, fallbackKey) + } + return + } + + // Inline function: component: () => + // Find JSX refs within and mark them as client roots + if (isFunctionLike(node)) { + collectJsxComponentRefs(node, sourceFile, null, false, usageNode) + } + } + + function collectJsxComponentRefs( + node: ts.Node, + sourceFile: ts.SourceFile, + _currentComponent: string | null, + isServerContext: boolean, + usageNode?: ts.Node, + ): void { + function walk(n: ts.Node): void { + if (tsLib.isJsxOpeningElement(n) || tsLib.isJsxSelfClosingElement(n)) { + const tagName = n.tagName + if (tsLib.isIdentifier(tagName) && isPascalCase(tagName.text)) { + const symbol = checker.getSymbolAtLocation(tagName) + if (symbol) { + const resolved = resolveSymbol(symbol) + if (resolved) { + const decls = resolved.getDeclarations() + if (decls && decls.length > 0) { + const declFile = decls[0]!.getSourceFile().fileName + const key = makeKey(declFile, tagName.text) + + if (isServerContext) { + graph.serverRoots.add(key) + } else { + graph.clientRoots.add(key) + // For inline route options like component: () => , + // use the JSX node as the usage location + const effectiveUsageNode = usageNode ?? n + graph.routeOptionUsages.set(key, { + componentKey: key, + usageNode: effectiveUsageNode, + usageLine: getLine(sourceFile, effectiveUsageNode), + fileName: sourceFile.fileName, + }) + addToRouteOptionRootsByFile(sourceFile.fileName, key) + } + } + } + } + } + } + tsLib.forEachChild(n, walk) + } + walk(node) + } + + function resolveSymbol(symbol: ts.Symbol): ts.Symbol | undefined { + if (symbol.flags & tsLib.SymbolFlags.Alias) { + return checker.getAliasedSymbol(symbol) + } + return symbol + } + + function isPascalCase(name: string): boolean { + return /^[A-Z]/.test(name) + } + + function hasAsyncModifier( + node: ts.FunctionDeclaration | ts.FunctionExpression | ts.ArrowFunction, + ): boolean { + return ( + node.modifiers?.some( + (mod) => mod.kind === tsLib.SyntaxKind.AsyncKeyword, + ) ?? false + ) + } + + function isFunctionLike(node: ts.Node): boolean { + return ( + tsLib.isArrowFunction(node) || + tsLib.isFunctionExpression(node) || + tsLib.isFunctionDeclaration(node) + ) + } + + function isAsyncFunctionLike(node: ts.Node): boolean { + if (tsLib.isArrowFunction(node) || tsLib.isFunctionExpression(node)) { + return hasAsyncModifier(node) + } + return false + } + + function makeKey(fileName: string, componentName: string): string { + return `${fileName}:${componentName}` + } + + function getLine(sourceFile: ts.SourceFile, node: ts.Node): number { + return sourceFile.getLineAndCharacterOfPosition(node.getStart()).line + 1 + } + + function addToRouteOptionRootsByFile(fileName: string, key: string): void { + let set = graph.routeOptionRootsByFile.get(fileName) + if (!set) { + set = new Set() + graph.routeOptionRootsByFile.set(fileName, set) + } + set.add(key) + } +} + +export type RenderGraphBuilder = ReturnType diff --git a/packages/eslint-plugin-start/src/rules/no-client-code-in-server-component/constants.ts b/packages/eslint-plugin-start/src/rules/no-client-code-in-server-component/constants.ts new file mode 100644 index 0000000000..87fb9a8a3e --- /dev/null +++ b/packages/eslint-plugin-start/src/rules/no-client-code-in-server-component/constants.ts @@ -0,0 +1,266 @@ +import globals from 'globals' + +/** + * Hooks allowed in server components + */ +export const DEFAULT_ALLOWED_HOOKS = new Set(['useId']) + +/** + * React hooks to detect (common ones that are NOT allowed in server components) + */ +export const REACT_HOOKS = new Set([ + 'useState', + 'useEffect', + 'useLayoutEffect', + 'useReducer', + 'useCallback', + 'useMemo', + 'useRef', + 'useContext', + 'useImperativeHandle', + 'useDebugValue', + 'useDeferredValue', + 'useTransition', + 'useSyncExternalStore', + 'useInsertionEffect', + 'useOptimistic', + 'useFormStatus', + 'useActionState', +]) + +/** + * Browser-only globals not available in server context + * Dynamically computed from globals package: browser globals that are NOT in node + */ +export const BROWSER_ONLY_GLOBALS: Set = (() => { + const browserGlobals = Object.keys(globals.browser as Record) + const nodeGlobals = new Set( + Object.keys(globals.node as Record), + ) + + const browserOnly = new Set() + for (const name of browserGlobals) { + if (!nodeGlobals.has(name)) { + browserOnly.add(name) + } + } + return browserOnly +})() + +/** + * React event handler props - comprehensive list from React types + */ +export const REACT_EVENT_HANDLERS = new Set([ + // Clipboard Events + 'onCopy', + 'onCopyCapture', + 'onCut', + 'onCutCapture', + 'onPaste', + 'onPasteCapture', + + // Composition Events + 'onCompositionEnd', + 'onCompositionEndCapture', + 'onCompositionStart', + 'onCompositionStartCapture', + 'onCompositionUpdate', + 'onCompositionUpdateCapture', + + // Focus Events + 'onFocus', + 'onFocusCapture', + 'onBlur', + 'onBlurCapture', + + // Form Events + 'onChange', + 'onChangeCapture', + 'onBeforeInput', + 'onBeforeInputCapture', + 'onInput', + 'onInputCapture', + 'onReset', + 'onResetCapture', + 'onSubmit', + 'onSubmitCapture', + 'onInvalid', + 'onInvalidCapture', + + // Image Events + 'onLoad', + 'onLoadCapture', + 'onError', + 'onErrorCapture', + + // Keyboard Events + 'onKeyDown', + 'onKeyDownCapture', + 'onKeyPress', + 'onKeyPressCapture', + 'onKeyUp', + 'onKeyUpCapture', + + // Media Events + 'onAbort', + 'onAbortCapture', + 'onCanPlay', + 'onCanPlayCapture', + 'onCanPlayThrough', + 'onCanPlayThroughCapture', + 'onDurationChange', + 'onDurationChangeCapture', + 'onEmptied', + 'onEmptiedCapture', + 'onEncrypted', + 'onEncryptedCapture', + 'onEnded', + 'onEndedCapture', + 'onLoadedData', + 'onLoadedDataCapture', + 'onLoadedMetadata', + 'onLoadedMetadataCapture', + 'onLoadStart', + 'onLoadStartCapture', + 'onPause', + 'onPauseCapture', + 'onPlay', + 'onPlayCapture', + 'onPlaying', + 'onPlayingCapture', + 'onProgress', + 'onProgressCapture', + 'onRateChange', + 'onRateChangeCapture', + 'onResize', + 'onResizeCapture', + 'onSeeked', + 'onSeekedCapture', + 'onSeeking', + 'onSeekingCapture', + 'onStalled', + 'onStalledCapture', + 'onSuspend', + 'onSuspendCapture', + 'onTimeUpdate', + 'onTimeUpdateCapture', + 'onVolumeChange', + 'onVolumeChangeCapture', + 'onWaiting', + 'onWaitingCapture', + + // Mouse Events + 'onAuxClick', + 'onAuxClickCapture', + 'onClick', + 'onClickCapture', + 'onContextMenu', + 'onContextMenuCapture', + 'onDoubleClick', + 'onDoubleClickCapture', + 'onDrag', + 'onDragCapture', + 'onDragEnd', + 'onDragEndCapture', + 'onDragEnter', + 'onDragEnterCapture', + 'onDragExit', + 'onDragExitCapture', + 'onDragLeave', + 'onDragLeaveCapture', + 'onDragOver', + 'onDragOverCapture', + 'onDragStart', + 'onDragStartCapture', + 'onDrop', + 'onDropCapture', + 'onMouseDown', + 'onMouseDownCapture', + 'onMouseEnter', + 'onMouseLeave', + 'onMouseMove', + 'onMouseMoveCapture', + 'onMouseOut', + 'onMouseOutCapture', + 'onMouseOver', + 'onMouseOverCapture', + 'onMouseUp', + 'onMouseUpCapture', + + // Selection Events + 'onSelect', + 'onSelectCapture', + + // Touch Events + 'onTouchCancel', + 'onTouchCancelCapture', + 'onTouchEnd', + 'onTouchEndCapture', + 'onTouchMove', + 'onTouchMoveCapture', + 'onTouchStart', + 'onTouchStartCapture', + + // Pointer Events + 'onPointerDown', + 'onPointerDownCapture', + 'onPointerMove', + 'onPointerMoveCapture', + 'onPointerUp', + 'onPointerUpCapture', + 'onPointerCancel', + 'onPointerCancelCapture', + 'onPointerEnter', + 'onPointerEnterCapture', + 'onPointerLeave', + 'onPointerLeaveCapture', + 'onPointerOver', + 'onPointerOverCapture', + 'onPointerOut', + 'onPointerOutCapture', + 'onGotPointerCapture', + 'onGotPointerCaptureCapture', + 'onLostPointerCapture', + 'onLostPointerCaptureCapture', + + // UI Events + 'onScroll', + 'onScrollCapture', + + // Wheel Events + 'onWheel', + 'onWheelCapture', + + // Animation Events + 'onAnimationStart', + 'onAnimationStartCapture', + 'onAnimationEnd', + 'onAnimationEndCapture', + 'onAnimationIteration', + 'onAnimationIterationCapture', + + // Transition Events + 'onTransitionEnd', + 'onTransitionEndCapture', +]) + +/** + * Check if a prop name is a React event handler + */ +export function isReactEventHandler(name: string): boolean { + return REACT_EVENT_HANDLERS.has(name) +} + +/** + * Check if a hook name is client-only (not allowed in server components) + */ +export function isClientOnlyHook( + name: string, + allowedHooks: Set = DEFAULT_ALLOWED_HOOKS, +): boolean { + // Must match use[A-Z] pattern + if (!/^use[A-Z]/.test(name)) return false + // Check if explicitly allowed + if (allowedHooks.has(name)) return false + return true +} diff --git a/packages/eslint-plugin-start/src/rules/no-client-code-in-server-component/no-client-code-in-server-component.rule.ts b/packages/eslint-plugin-start/src/rules/no-client-code-in-server-component/no-client-code-in-server-component.rule.ts new file mode 100644 index 0000000000..57d314ee9c --- /dev/null +++ b/packages/eslint-plugin-start/src/rules/no-client-code-in-server-component/no-client-code-in-server-component.rule.ts @@ -0,0 +1,472 @@ +import path from 'node:path' +import { ESLintUtils } from '@typescript-eslint/utils' +import * as ts from 'typescript' +import { getDocsUrl } from '../../utils/get-docs-url' +import { createUseClientResolver } from '../../shared/use-client-resolver' +import { createViolationDetector } from './violation-detector' +import { createTransitiveAnalyzer } from './transitive-analyzer' +import { DEFAULT_ALLOWED_HOOKS } from './constants' +import type { Violation, ViolationType } from './violation-detector' +import type { ImportEdge } from './transitive-analyzer' +import type { ExtraRuleDocs } from '../../types' +import type { TSESTree } from '@typescript-eslint/utils' + +export const name = 'no-client-code-in-server-component' + +type MessageIds = + | 'hookInServerComponent' + | 'browserGlobalInServerComponent' + | 'eventHandlerInServerComponent' + | 'functionPropInServerComponent' + | 'classComponentInServerComponent' + +type _Options = [ + { + allowedServerHooks?: Array + }, +] + +const SLOT_HINT = + 'To use client functionality, either: (1) pass the client component as a prop/slot to the server component, or (2) move this code to a separate file and add "use client" directive.' + +const TRIGGER_HINT = 'Triggered by rendering "{{entry}}".' + +export const rule = ESLintUtils.RuleCreator(getDocsUrl)({ + name, + meta: { + type: 'problem', + docs: { + description: 'Disallow client-only code inside server components', + recommended: 'error', + }, + schema: [ + { + type: 'object', + properties: { + allowedServerHooks: { + type: 'array', + items: { type: 'string' }, + description: + 'Additional hooks that are allowed in server components (e.g., custom server-safe hooks)', + }, + }, + additionalProperties: false, + }, + ], + messages: { + hookInServerComponent: + '"{{name}}" hook {{location}} cannot be used in server components. ' + + TRIGGER_HINT + + ' ' + + SLOT_HINT, + browserGlobalInServerComponent: + '"{{name}}" browser API {{location}} is not available in server components. ' + + TRIGGER_HINT + + ' ' + + SLOT_HINT, + eventHandlerInServerComponent: + '"{{name}}" event handler {{location}} cannot be used in server components. ' + + TRIGGER_HINT + + ' ' + + SLOT_HINT, + functionPropInServerComponent: + '"{{name}}" function prop {{location}} cannot be passed in server components. ' + + 'Functions cannot be serialized from server to client. ' + + TRIGGER_HINT + + ' ' + + SLOT_HINT, + classComponentInServerComponent: + '"{{name}}" class component {{location}} cannot be used in server components. ' + + 'Class components require client-side lifecycle methods. ' + + TRIGGER_HINT + + ' ' + + SLOT_HINT, + }, + }, + defaultOptions: [{ allowedServerHooks: [] }] as const, + create(context, [options]) { + // Get TypeScript services + const services = ESLintUtils.getParserServices(context) + const program = services.program + const checker = program.getTypeChecker() + + // Build allowed hooks set from options + const allowedHooks = new Set([ + ...DEFAULT_ALLOWED_HOOKS, + ...options.allowedServerHooks, + ]) + + // Initialize analyzers + const useClientResolver = createUseClientResolver(program) + const violationDetector = createViolationDetector(ts, { + allowedHooks, + checker, + }) + const transitiveAnalyzer = createTransitiveAnalyzer( + ts, + program, + checker, + useClientResolver, + violationDetector, + ) + + return { + // Find server-component roots + CallExpression(node) { + // Skip client files + const sourceFile = services.esTreeNodeToTSNodeMap + .get(node) + .getSourceFile() + if (useClientResolver.hasUseClientDirective(sourceFile.fileName)) return + + const rootKind = getServerRootKind(node) + if (!rootKind) return + + if (rootKind === 'createCompositeComponent') { + const callback = node.arguments[0] + if (!callback) return + + const tsNode = services.esTreeNodeToTSNodeMap.get(callback) + + if (ts.isFunctionLike(tsNode)) { + analyzeServerComponentCallback( + tsNode as ts.FunctionLikeDeclaration, + node, + rootKind, + ) + } else if (ts.isIdentifier(tsNode)) { + analyzeDirectComponentReference(tsNode, node, rootKind) + } + + return + } + + const element = node.arguments[0] + if (!element) return + + const tsNode = services.esTreeNodeToTSNodeMap.get(element) + analyzeServerComponentNode(tsNode, node, rootKind) + return + }, + } + + function getServerRootKind( + node: TSESTree.CallExpression, + ): 'createCompositeComponent' | 'renderServerComponent' | null { + if (node.callee.type === 'Identifier') { + if (node.callee.name === 'createCompositeComponent') { + return 'createCompositeComponent' + } + if (node.callee.name === 'renderServerComponent') { + return 'renderServerComponent' + } + } + if ( + node.callee.type === 'MemberExpression' && + node.callee.property.type === 'Identifier' + ) { + if (node.callee.property.name === 'createCompositeComponent') { + return 'createCompositeComponent' + } + if (node.callee.property.name === 'renderServerComponent') { + return 'renderServerComponent' + } + } + return null + } + + function analyzeServerComponentNode( + node: ts.Node, + eslintNode: TSESTree.CallExpression, + rootKind: 'createCompositeComponent' | 'renderServerComponent', + ) { + // Track reported violations to avoid duplicates + const reportedViolations = new Set() + + const sourceFile = node.getSourceFile() + + // Detect violations in the whole arg node + const directViolations = violationDetector.detectViolations(sourceFile) + const start = node.getStart() + const end = node.getEnd() + + for (const violation of directViolations) { + const violationPos = violation.node.getStart() + if (violationPos >= start && violationPos <= end) { + const key = `${violation.fileName}:${violation.line}:${violation.name}` + if (!reportedViolations.has(key)) { + reportedViolations.add(key) + reportViolation(violation, [], rootKind, eslintNode) + } + } + } + + // Find all JSX component references in the node + const componentRefs = findComponentReferences(node) + + for (const ref of componentRefs) { + const symbol = checker.getSymbolAtLocation(ref) + if (!symbol) continue + + const resolvedSymbol = + ts.SymbolFlags.Alias & symbol.flags + ? checker.getAliasedSymbol(symbol) + : symbol + + const result = transitiveAnalyzer.analyzeEntrySymbol(resolvedSymbol) + + if (result.isClientBoundary) continue + + for (const violation of result.violations) { + const key = `${violation.fileName}:${violation.line}:${violation.name}` + if (!reportedViolations.has(key)) { + reportedViolations.add(key) + reportViolation(violation, violation.chain, rootKind, eslintNode) + } + } + } + } + + function analyzeServerComponentCallback( + callback: ts.FunctionLikeDeclaration, + eslintNode: TSESTree.CallExpression, + rootKind: 'createCompositeComponent' | 'renderServerComponent', + ) { + // Track reported violations to avoid duplicates + const reportedViolations = new Set() + + // Collect parameter names - these are "slots" passed from client, skip them + const parameterNames = new Set() + for (const param of callback.parameters) { + collectParameterBindings(param.name, parameterNames) + } + + // First, detect violations directly in the callback body + const body = callback.body + if (body) { + const sourceFile = callback.getSourceFile() + + // Check for violations in the callback itself + const directViolations = violationDetector.detectViolations(sourceFile) + + // Filter to only violations within the callback body + const callbackStart = body.getStart() + const callbackEnd = body.getEnd() + + for (const violation of directViolations) { + const violationPos = violation.node.getStart() + if (violationPos >= callbackStart && violationPos <= callbackEnd) { + const key = `${violation.fileName}:${violation.line}:${violation.name}` + if (!reportedViolations.has(key)) { + reportedViolations.add(key) + reportViolation(violation, [], rootKind, eslintNode) + } + } + } + } + + // Find all JSX component references in the callback + const componentRefs = findComponentReferences(callback) + + for (const ref of componentRefs) { + // Skip if this component name comes from a parameter (it's a client slot) + if (parameterNames.has(ref.text)) { + continue + } + + const symbol = checker.getSymbolAtLocation(ref) + if (!symbol) continue + + // Check if the symbol is declared in the callback parameters + // This handles destructured props like { ActionButton } + const declarations = symbol.getDeclarations() + if (declarations?.some((d) => isWithinParameters(d, callback))) { + continue // Skip - it's a prop/slot + } + + // Resolve alias if it's an import + const resolvedSymbol = + ts.SymbolFlags.Alias & symbol.flags + ? checker.getAliasedSymbol(symbol) + : symbol + + const result = transitiveAnalyzer.analyzeEntrySymbol(resolvedSymbol) + + if (result.isClientBoundary) continue // Has 'use client', skip + + // Report violations (deduplicated) + for (const violation of result.violations) { + const key = `${violation.fileName}:${violation.line}:${violation.name}` + if (!reportedViolations.has(key)) { + reportedViolations.add(key) + reportViolation(violation, violation.chain, rootKind, eslintNode) + } + } + } + } + + /** + * Analyze a component passed directly to createCompositeComponent(Component) + */ + + function analyzeDirectComponentReference( + ref: ts.Identifier, + eslintNode: TSESTree.CallExpression, + rootKind: + | 'createCompositeComponent' + | 'renderServerComponent' = 'createCompositeComponent', + ) { + const symbol = checker.getSymbolAtLocation(ref) + if (!symbol) return + + // Resolve alias if it's an import + const resolvedSymbol = + ts.SymbolFlags.Alias & symbol.flags + ? checker.getAliasedSymbol(symbol) + : symbol + + const result = transitiveAnalyzer.analyzeEntrySymbol(resolvedSymbol) + + if (result.isClientBoundary) return // Has 'use client', skip + + // Track reported violations to avoid duplicates + const reportedViolations = new Set() + + // Report violations (deduplicated) + for (const violation of result.violations) { + const key = `${violation.fileName}:${violation.line}:${violation.name}` + if (!reportedViolations.has(key)) { + reportedViolations.add(key) + reportViolation(violation, violation.chain, rootKind, eslintNode) + } + } + } + + /** + * Collect all binding names from a parameter (handles destructuring) + */ + function collectParameterBindings( + bindingName: ts.BindingName, + names: Set, + ): void { + function collectFromBinding(node: ts.BindingName): void { + if (ts.isIdentifier(node)) { + names.add(node.text) + } else if (ts.isObjectBindingPattern(node)) { + for (const element of node.elements) { + collectFromBinding(element.name) + } + } else if (ts.isArrayBindingPattern(node)) { + for (const element of node.elements) { + if (ts.isBindingElement(element)) { + collectFromBinding(element.name) + } + } + } + } + collectFromBinding(bindingName) + } + + /** + * Check if a declaration is within the parameters of the callback + */ + function isWithinParameters( + decl: ts.Declaration, + callback: ts.FunctionLikeDeclaration, + ): boolean { + // Walk up the parent chain to see if this declaration is within a parameter + let current: ts.Node | undefined = decl + while (current) { + if (ts.isParameter(current)) { + // Check if this parameter belongs to our callback + const paramParent = current.parent + if (ts.isFunctionLike(paramParent) && paramParent === callback) { + return true + } + } + current = current.parent as ts.Node | undefined + } + return false + } + + function findComponentReferences(node: ts.Node): Array { + const refs: Array = [] + + function visit(n: ts.Node) { + // JSX element: + if (ts.isJsxOpeningElement(n) || ts.isJsxSelfClosingElement(n)) { + const tagName = n.tagName + // Only components (uppercase) not intrinsic elements (lowercase) + if (ts.isIdentifier(tagName) && /^[A-Z]/.test(tagName.text)) { + refs.push(tagName) + } + } + // Also check function calls that might return JSX + if (ts.isCallExpression(n)) { + const callee = n.expression + if (ts.isIdentifier(callee) && /^[A-Z]/.test(callee.text)) { + refs.push(callee) + } + } + ts.forEachChild(n, visit) + } + + ts.forEachChild(node, visit) + return refs + } + + function reportViolation( + violation: Violation, + chain: Array, + entryComponentName: string, + eslintNode: TSESTree.CallExpression, + ) { + const location = formatLocation(violation, chain) + const messageId = getMessageId(violation.type) + + context.report({ + node: eslintNode, + messageId, + data: { + name: violation.name, + location, + entry: entryComponentName, + fileName: getRelativePath(violation.fileName), + }, + }) + } + + function getMessageId(type: ViolationType): MessageIds { + switch (type) { + case 'hook': + return 'hookInServerComponent' + case 'browser-global': + return 'browserGlobalInServerComponent' + case 'event-handler': + return 'eventHandlerInServerComponent' + case 'function-prop': + return 'functionPropInServerComponent' + case 'class-component': + return 'classComponentInServerComponent' + } + } + + function formatLocation( + violation: Violation, + chain: Array, + ): string { + if (chain.length > 0) { + const chainStr = chain + .map((e) => getRelativePath(e.toFile)) + .join(' -> ') + return `(via ${chainStr}) at ${getRelativePath(violation.fileName)}:${violation.line}` + } + return `at ${getRelativePath(violation.fileName)}:${violation.line}` + } + + function getRelativePath(fileName: string): string { + const cwd = context.cwd + return path.relative(cwd, fileName) + } + }, +}) diff --git a/packages/eslint-plugin-start/src/rules/no-client-code-in-server-component/transitive-analyzer.ts b/packages/eslint-plugin-start/src/rules/no-client-code-in-server-component/transitive-analyzer.ts new file mode 100644 index 0000000000..7a349be6cd --- /dev/null +++ b/packages/eslint-plugin-start/src/rules/no-client-code-in-server-component/transitive-analyzer.ts @@ -0,0 +1,245 @@ +import type ts from 'typescript' +import type { UseClientResolver } from '../../shared/use-client-resolver' +import type { Violation, ViolationDetector } from './violation-detector' + +export interface ImportEdge { + fromFile: string + toFile: string + viaSymbol: string +} + +export interface TransitiveResult { + isClientBoundary: boolean + violations: Array }> +} + +export interface TransitiveAnalyzer { + /** + * Analyze an entry symbol and all reachable symbols for violations. + * Stops at 'use client' boundaries. + */ + analyzeEntrySymbol: (entrySymbol: ts.Symbol) => TransitiveResult +} + +/** + * Creates an analyzer that follows reachable symbol references + * to find transitive violations, stopping at 'use client' boundaries. + */ +export function createTransitiveAnalyzer( + tsLib: typeof ts, + program: ts.Program, + checker: ts.TypeChecker, + useClientResolver: UseClientResolver, + violationDetector: ViolationDetector, +): TransitiveAnalyzer { + const visitedSymbols = new Set() + const analysisCache = new Map() + + function symbolKey(symbol: ts.Symbol): string { + const decl = symbol.getDeclarations()?.[0] + return `${decl?.getSourceFile().fileName ?? 'unknown'}::${symbol.getName()}` + } + + function analyzeEntrySymbol(entrySymbol: ts.Symbol): TransitiveResult { + visitedSymbols.clear() + + const cached = analysisCache.get(symbolKey(entrySymbol)) + if (cached) return cached + + const violations: Array }> = [] + + function visitSymbol(symbol: ts.Symbol, chain: Array): boolean { + const key = symbolKey(symbol) + if (visitedSymbols.has(key)) return false + visitedSymbols.add(key) + + const decl = symbol.getDeclarations()?.[0] + if (!decl) return false + + const sourceFile = decl.getSourceFile() + const fileName = sourceFile.fileName + + // Skip node_modules and declaration files + if (fileName.includes('/node_modules/') || fileName.endsWith('.d.ts')) { + return false + } + + // Check for 'use client' boundary + if (useClientResolver.hasUseClientDirective(fileName)) { + return true // client boundary - stop here + } + + // Find the traversal root for this symbol + const traversalRoots = getTraversalRoots(decl) + + // Detect violations ONLY within the symbol's traversal roots, not the entire file + for (const root of traversalRoots) { + const rootViolations = violationDetector.detectViolationsInNode( + root, + sourceFile, + ) + for (const v of rootViolations) { + violations.push({ ...v, chain: [...chain] }) + } + } + + // Collect reachable identifiers from traversal roots + for (const root of traversalRoots) { + const identifiers = collectReachableIdentifiers(root, decl) + + for (const ident of identifiers) { + const refSym = checker.getSymbolAtLocation(ident) + if (!refSym) continue + + // Resolve alias if needed + const aliased = + tsLib.SymbolFlags.Alias & refSym.flags + ? checker.getAliasedSymbol(refSym) + : refSym + + const refDecl = aliased.getDeclarations()?.[0] + const refFile = refDecl?.getSourceFile().fileName + if (!refFile) continue + + // Skip libs / node_modules + if (refFile.includes('/node_modules/') || refFile.endsWith('.d.ts')) { + continue + } + + const edge: ImportEdge = { + fromFile: fileName, + toFile: refFile, + viaSymbol: aliased.getName(), + } + + visitSymbol(aliased, [...chain, edge]) + } + } + + return false + } + + /** + * Get traversal roots based on declaration kind + */ + function getTraversalRoots(decl: ts.Declaration): Array { + // FunctionDeclaration / FunctionExpression / ArrowFunction: its body + if (tsLib.isFunctionDeclaration(decl) && decl.body) { + return [decl.body] + } + if (tsLib.isFunctionExpression(decl)) { + return [decl.body] + } + if (tsLib.isArrowFunction(decl)) { + return [decl.body] + } + + // VariableDeclaration: check initializer + if (tsLib.isVariableDeclaration(decl) && decl.initializer) { + if ( + tsLib.isFunctionExpression(decl.initializer) || + tsLib.isArrowFunction(decl.initializer) + ) { + return [decl.initializer.body] + } + return [decl.initializer] + } + + // ClassDeclaration / ClassExpression: traverse methods + property initializers + if (tsLib.isClassDeclaration(decl) || tsLib.isClassExpression(decl)) { + const roots: Array = [] + for (const member of decl.members) { + if (tsLib.isMethodDeclaration(member) && member.body) { + roots.push(member.body) + } + if (tsLib.isPropertyDeclaration(member) && member.initializer) { + roots.push(member.initializer) + } + } + return roots + } + + // ExportSpecifier / ImportSpecifier: resolve aliased symbol handled by caller + // Fallback: traverse the declaration node itself + return [decl] + } + + /** + * Collect identifier nodes from a traversal root, skipping: + * - The defining identifier for the symbol (avoid self-loop) + * - Type-only positions + * - Property names when not computed + */ + function collectReachableIdentifiers( + root: ts.Node, + originalDecl: ts.Declaration, + ): Array { + const identifiers: Array = [] + + // Get the name of the original declaration to avoid self-reference + let declName: string | undefined + if ('name' in originalDecl && originalDecl.name) { + const nameNode = originalDecl.name as ts.Node + if (tsLib.isIdentifier(nameNode)) { + declName = nameNode.text + } + } + + function visit(node: ts.Node) { + // Skip type-only positions + if ( + tsLib.isTypeReferenceNode(node) || + tsLib.isInterfaceDeclaration(node) || + tsLib.isTypeAliasDeclaration(node) || + tsLib.isTypeQueryNode(node) || + tsLib.isTypeParameterDeclaration(node) + ) { + return // Don't descend into type nodes + } + + if (tsLib.isIdentifier(node)) { + const name = node.text + + // Skip the defining identifier + if (name === declName) return + + // Skip property names in property access (obj.prop -> prop is not a symbol ref) + const parent = node.parent + if ( + tsLib.isPropertyAccessExpression(parent) && + parent.name === node + ) { + return + } + + // Skip property names in object literals + if (tsLib.isPropertyAssignment(parent) && parent.name === node) { + return + } + + // Skip parameter names and variable declaration names + if ( + (tsLib.isParameter(parent) && parent.name === node) || + (tsLib.isVariableDeclaration(parent) && parent.name === node) + ) { + return + } + + identifiers.push(node) + } + + tsLib.forEachChild(node, visit) + } + + visit(root) + return identifiers + } + + const isClientBoundary = visitSymbol(entrySymbol, []) + const result: TransitiveResult = { isClientBoundary, violations } + analysisCache.set(symbolKey(entrySymbol), result) + return result + } + + return { analyzeEntrySymbol } +} diff --git a/packages/eslint-plugin-start/src/rules/no-client-code-in-server-component/violation-detector.ts b/packages/eslint-plugin-start/src/rules/no-client-code-in-server-component/violation-detector.ts new file mode 100644 index 0000000000..3457b7d3c1 --- /dev/null +++ b/packages/eslint-plugin-start/src/rules/no-client-code-in-server-component/violation-detector.ts @@ -0,0 +1,316 @@ +import { + BROWSER_ONLY_GLOBALS, + DEFAULT_ALLOWED_HOOKS, + isClientOnlyHook, + isReactEventHandler, +} from './constants' +import type ts from 'typescript' + +export type ViolationType = + | 'hook' + | 'browser-global' + | 'event-handler' + | 'function-prop' + | 'class-component' + +export interface Violation { + type: ViolationType + name: string + node: ts.Node + fileName: string + line: number + column: number +} + +export interface ViolationDetectorOptions { + allowedHooks?: Set + checker?: ts.TypeChecker +} + +export interface ViolationDetector { + /** + * Detect client-only code violations in a source file + */ + detectViolations: (sourceFile: ts.SourceFile) => Array + + /** + * Detect client-only code violations within a specific node subtree + */ + detectViolationsInNode: ( + node: ts.Node, + sourceFile: ts.SourceFile, + ) => Array +} + +/** + * Get line and column position for a node + */ +function getPosition( + node: ts.Node, + sourceFile: ts.SourceFile, +): { line: number; column: number } { + const { line, character } = sourceFile.getLineAndCharacterOfPosition( + node.getStart(), + ) + return { line: line + 1, column: character + 1 } +} + +/** + * Creates a detector that finds client-only code violations in TypeScript AST + */ +export function createViolationDetector( + tsLib: typeof ts, + options: ViolationDetectorOptions = {}, +): ViolationDetector { + const allowedHooks = options.allowedHooks ?? DEFAULT_ALLOWED_HOOKS + const checker = options.checker + + /** + * Check if a class declaration extends React.Component or React.PureComponent + */ + function isReactClassComponent(node: ts.ClassDeclaration): boolean { + if (!node.heritageClauses) return false + + for (const clause of node.heritageClauses) { + if (clause.token !== tsLib.SyntaxKind.ExtendsKeyword) continue + + for (const type of clause.types) { + const expr = type.expression + + // Check for React.Component or React.PureComponent + if (tsLib.isPropertyAccessExpression(expr)) { + const propName = expr.name.text + if (propName === 'Component' || propName === 'PureComponent') { + // Check if it's React.Component + if (tsLib.isIdentifier(expr.expression)) { + const objName = expr.expression.text + if (objName === 'React') { + return true + } + } + } + } + + // Check for direct Component or PureComponent import + if (tsLib.isIdentifier(expr)) { + const name = expr.text + if (name === 'Component' || name === 'PureComponent') { + return true + } + } + } + } + + return false + } + + /** + * Shared visitor logic that collects violations into the provided array + */ + function visitNode( + node: ts.Node, + sourceFile: ts.SourceFile, + violations: Array, + ) { + // 1. Detect React class components + if (tsLib.isClassDeclaration(node) && isReactClassComponent(node)) { + const name = node.name?.text ?? 'ClassComponent' + violations.push({ + type: 'class-component', + name, + node, + fileName: sourceFile.fileName, + ...getPosition(node, sourceFile), + }) + } + + // 2. Detect hook calls: useXxx() + if (tsLib.isCallExpression(node)) { + const callee = node.expression + let name = '' + + if (tsLib.isIdentifier(callee)) { + name = callee.text + } else if (tsLib.isPropertyAccessExpression(callee)) { + // React.useState() etc + name = callee.name.text + } + + if (name && isClientOnlyHook(name, allowedHooks)) { + violations.push({ + type: 'hook', + name, + node, + fileName: sourceFile.fileName, + ...getPosition(node, sourceFile), + }) + } + } + + // 3. Detect browser globals: window, document, etc. + if (tsLib.isIdentifier(node)) { + const name = node.text + if (BROWSER_ONLY_GLOBALS.has(name)) { + const parent = node.parent + + // Skip if this is the property name in a property access (obj.window is fine) + if (tsLib.isPropertyAccessExpression(parent) && parent.name === node) { + // This is a property access like obj.window - skip + } + // Skip if this is a property assignment key + else if (tsLib.isPropertyAssignment(parent) && parent.name === node) { + // This is { window: value } - skip + } + // Skip type-only positions + else if ( + tsLib.isTypeReferenceNode(parent) || + tsLib.isInterfaceDeclaration(parent) || + tsLib.isTypeAliasDeclaration(parent) + ) { + // Type position - skip + } + // Skip if this is a parameter name or variable declaration name + else if ( + (tsLib.isParameter(parent) && parent.name === node) || + (tsLib.isVariableDeclaration(parent) && parent.name === node) + ) { + // Declaration name - skip + } + // Skip if imported (the import itself is fine, usage is caught elsewhere) + else if ( + tsLib.isImportSpecifier(parent) || + tsLib.isImportClause(parent) + ) { + // Import - skip + } + // If we have a type checker, verify this is truly a global reference (no local binding) + else if (checker) { + const symbol = checker.getSymbolAtLocation(node) + if (symbol) { + const declarations = symbol.getDeclarations() + if (declarations?.length) { + // Check if ALL declarations are from lib files (global types) + // If any declaration is from a user file, it's a local variable + const isLocalDeclaration = declarations.some((decl) => { + const fileName = decl.getSourceFile().fileName + // User declarations are not from node_modules or lib files + return ( + !fileName.includes('/node_modules/') && + !fileName.includes('/typescript/lib/') + ) + }) + + if (isLocalDeclaration) { + // Has a local declaration - skip + } else { + // All declarations are from lib files - it's a global reference + violations.push({ + type: 'browser-global', + name, + node, + fileName: sourceFile.fileName, + ...getPosition(node, sourceFile), + }) + } + } else { + // No declarations found - treat as global + violations.push({ + type: 'browser-global', + name, + node, + fileName: sourceFile.fileName, + ...getPosition(node, sourceFile), + }) + } + } else { + // No symbol - assume global (conservative) + violations.push({ + type: 'browser-global', + name, + node, + fileName: sourceFile.fileName, + ...getPosition(node, sourceFile), + }) + } + } + // No type checker, fallback to AST-only check (may have false positives) + else { + violations.push({ + type: 'browser-global', + name, + node, + fileName: sourceFile.fileName, + ...getPosition(node, sourceFile), + }) + } + } + } + + // 4. Detect JSX attributes: event handlers AND function props + if (tsLib.isJsxAttribute(node)) { + const attrName = node.name + if (tsLib.isIdentifier(attrName)) { + const name = attrName.text + const value = node.initializer + + // Check if it's a React event handler (onClick, onChange, etc.) + if (isReactEventHandler(name)) { + violations.push({ + type: 'event-handler', + name, + node, + fileName: sourceFile.fileName, + ...getPosition(node, sourceFile), + }) + } + // Check if it's a function prop (not an event handler, not style/className) + // Skip common non-function props that might have complex expressions + else if ( + name !== 'style' && + name !== 'className' && + name !== 'key' && + name !== 'ref' && + name !== 'dangerouslySetInnerHTML' && + value && + tsLib.isJsxExpression(value) && + value.expression + ) { + const expr = value.expression + // Only flag actual function expressions, not objects or other values + if (tsLib.isArrowFunction(expr) || tsLib.isFunctionExpression(expr)) { + violations.push({ + type: 'function-prop', + name, + node, + fileName: sourceFile.fileName, + ...getPosition(node, sourceFile), + }) + } + } + } + } + + tsLib.forEachChild(node, (child) => + visitNode(child, sourceFile, violations), + ) + } + + function detectViolations(sourceFile: ts.SourceFile): Array { + const violations: Array = [] + tsLib.forEachChild(sourceFile, (child) => + visitNode(child, sourceFile, violations), + ) + return violations + } + + function detectViolationsInNode( + node: ts.Node, + sourceFile: ts.SourceFile, + ): Array { + const violations: Array = [] + visitNode(node, sourceFile, violations) + return violations + } + + return { detectViolations, detectViolationsInNode } +} diff --git a/packages/eslint-plugin-start/src/shared/use-client-resolver.ts b/packages/eslint-plugin-start/src/shared/use-client-resolver.ts new file mode 100644 index 0000000000..a80f9a0c77 --- /dev/null +++ b/packages/eslint-plugin-start/src/shared/use-client-resolver.ts @@ -0,0 +1,34 @@ +import * as ts from 'typescript' + +export interface UseClientResolver { + /** + * Check if a file has 'use client' directive at the top + */ + hasUseClientDirective: (fileName: string) => boolean +} + +/** + * Creates a resolver that checks for 'use client' directive in source files + */ +export function createUseClientResolver( + program: ts.Program, +): UseClientResolver { + function hasUseClientDirective(fileName: string): boolean { + const sourceFile = program.getSourceFile(fileName) + if (!sourceFile) return false + + const firstStmt = sourceFile.statements[0] + if (!firstStmt) return false + + if ( + ts.isExpressionStatement(firstStmt) && + ts.isStringLiteral(firstStmt.expression) + ) { + return firstStmt.expression.text === 'use client' + } + + return false + } + + return { hasUseClientDirective } +} diff --git a/packages/eslint-plugin-start/src/types.ts b/packages/eslint-plugin-start/src/types.ts new file mode 100644 index 0000000000..74c3053188 --- /dev/null +++ b/packages/eslint-plugin-start/src/types.ts @@ -0,0 +1,3 @@ +export type ExtraRuleDocs = { + recommended: 'strict' | 'error' | 'warn' +} diff --git a/packages/eslint-plugin-start/src/utils/get-docs-url.ts b/packages/eslint-plugin-start/src/utils/get-docs-url.ts new file mode 100644 index 0000000000..04579e47c8 --- /dev/null +++ b/packages/eslint-plugin-start/src/utils/get-docs-url.ts @@ -0,0 +1,2 @@ +export const getDocsUrl = (ruleName: string): string => + `https://tanstack.com/start/latest/docs/eslint/${ruleName}` diff --git a/packages/eslint-plugin-start/tsconfig.json b/packages/eslint-plugin-start/tsconfig.json new file mode 100644 index 0000000000..1715152a91 --- /dev/null +++ b/packages/eslint-plugin-start/tsconfig.json @@ -0,0 +1,8 @@ +{ + "extends": "../../tsconfig.json", + "compilerOptions": { + "moduleResolution": "Bundler", + "types": ["node"] + }, + "include": ["src", "eslint.config.js", "vite.config.ts"] +} diff --git a/packages/eslint-plugin-start/vite.config.ts b/packages/eslint-plugin-start/vite.config.ts new file mode 100644 index 0000000000..8769e2779e --- /dev/null +++ b/packages/eslint-plugin-start/vite.config.ts @@ -0,0 +1,23 @@ +import { defineConfig, mergeConfig } from 'vitest/config' +import { tanstackViteConfig } from '@tanstack/vite-config' +import packageJson from './package.json' + +const config = defineConfig({ + test: { + name: packageJson.name, + dir: './src', + watch: false, + globals: true, + typecheck: { enabled: true }, + restoreMocks: true, + }, +}) + +export default mergeConfig( + config, + tanstackViteConfig({ + entry: './src/index.ts', + srcDir: './src', + exclude: ['./src/__tests__'], + }), +) diff --git a/packages/history/CHANGELOG.md b/packages/history/CHANGELOG.md index bcf0ac6525..dbd02474bf 100644 --- a/packages/history/CHANGELOG.md +++ b/packages/history/CHANGELOG.md @@ -1,5 +1,11 @@ # @tanstack/history +## 1.162.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + ## 1.161.6 ### Patch Changes diff --git a/packages/history/package.json b/packages/history/package.json index 2b99b6a18f..790acabc3c 100644 --- a/packages/history/package.json +++ b/packages/history/package.json @@ -1,6 +1,6 @@ { "name": "@tanstack/history", - "version": "1.161.6", + "version": "1.162.0", "description": "Modern and scalable routing for React applications", "author": "Tanner Linsley", "license": "MIT", diff --git a/packages/nitro-v2-vite-plugin/CHANGELOG.md b/packages/nitro-v2-vite-plugin/CHANGELOG.md index c27fc171e9..934532d11b 100644 --- a/packages/nitro-v2-vite-plugin/CHANGELOG.md +++ b/packages/nitro-v2-vite-plugin/CHANGELOG.md @@ -1,5 +1,11 @@ # @tanstack/nitro-v2-vite-plugin +## 1.155.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + ## 1.154.9 ### Patch Changes diff --git a/packages/nitro-v2-vite-plugin/package.json b/packages/nitro-v2-vite-plugin/package.json index 29bae2c3d6..b3021ea3c6 100644 --- a/packages/nitro-v2-vite-plugin/package.json +++ b/packages/nitro-v2-vite-plugin/package.json @@ -1,6 +1,6 @@ { "name": "@tanstack/nitro-v2-vite-plugin", - "version": "1.154.9", + "version": "1.155.0", "description": "Modern and scalable routing for React applications", "author": "Tanner Linsley", "license": "MIT", diff --git a/packages/react-router-devtools/CHANGELOG.md b/packages/react-router-devtools/CHANGELOG.md index 611ab6b783..40e065c673 100644 --- a/packages/react-router-devtools/CHANGELOG.md +++ b/packages/react-router-devtools/CHANGELOG.md @@ -1,5 +1,36 @@ # @tanstack/react-router-devtools +## 1.167.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- Updated dependencies [[`b1c061a`](https://github.com/TanStack/router/commit/b1c061aff9185cdf5fdc08c0136382a9dce0302f), [`201e150`](https://github.com/TanStack/router/commit/201e150bd1412bae2faa9ce53f0fefcb7574ac14)]: + - @tanstack/router-core@1.170.0 + - @tanstack/react-router@1.170.0 + - @tanstack/router-devtools-core@1.168.0 + +## 1.166.13 + +### Patch Changes + +- Updated dependencies [[`6355bb7`](https://github.com/TanStack/router/commit/6355bb75f7637ba77f06a923c18fdaf37720bb48)]: + - @tanstack/router-devtools-core@1.167.3 + - @tanstack/react-router@1.168.15 + - @tanstack/router-core@1.168.11 + +## 1.166.12 + +### Patch Changes + +- Updated dependencies [[`459057c`](https://github.com/TanStack/router/commit/459057cd2d90cff20d20e51d4964b0a8c950555e)]: + - @tanstack/router-devtools-core@1.167.2 + - @tanstack/react-router@1.168.14 + - @tanstack/router-core@1.168.10 + ## 1.166.11 ### Patch Changes diff --git a/packages/react-router-devtools/package.json b/packages/react-router-devtools/package.json index 37a8b5543e..3cb40e24b0 100644 --- a/packages/react-router-devtools/package.json +++ b/packages/react-router-devtools/package.json @@ -1,6 +1,6 @@ { "name": "@tanstack/react-router-devtools", - "version": "1.166.11", + "version": "1.167.0", "description": "Modern and scalable routing for React applications", "author": "Tanner Linsley", "license": "MIT", diff --git a/packages/react-router-devtools/src/TanStackRouterDevtools.tsx b/packages/react-router-devtools/src/TanStackRouterDevtools.tsx index 925e7687e9..2248d27ef6 100644 --- a/packages/react-router-devtools/src/TanStackRouterDevtools.tsx +++ b/packages/react-router-devtools/src/TanStackRouterDevtools.tsx @@ -1,3 +1,5 @@ +'use client' + import { TanStackRouterDevtoolsCore } from '@tanstack/router-devtools-core' import { Fragment, useEffect, useRef, useState } from 'react' import { useRouter, useRouterState } from '@tanstack/react-router' diff --git a/packages/react-router-devtools/src/TanStackRouterDevtoolsPanel.tsx b/packages/react-router-devtools/src/TanStackRouterDevtoolsPanel.tsx index 46118bf2e6..ee7fba313b 100644 --- a/packages/react-router-devtools/src/TanStackRouterDevtoolsPanel.tsx +++ b/packages/react-router-devtools/src/TanStackRouterDevtoolsPanel.tsx @@ -1,3 +1,5 @@ +'use client' + import { useRouter, useRouterState } from '@tanstack/react-router' import { TanStackRouterDevtoolsPanelCore } from '@tanstack/router-devtools-core' import React, { useEffect, useRef, useState } from 'react' diff --git a/packages/react-router-devtools/src/index.ts b/packages/react-router-devtools/src/index.ts index 3db31a9b73..e711869ce8 100644 --- a/packages/react-router-devtools/src/index.ts +++ b/packages/react-router-devtools/src/index.ts @@ -1,3 +1,5 @@ +'use client' + import * as Devtools from './TanStackRouterDevtools' import * as DevtoolsPanel from './TanStackRouterDevtoolsPanel' diff --git a/packages/react-router-ssr-query/CHANGELOG.md b/packages/react-router-ssr-query/CHANGELOG.md index b62986d681..8e4f3df45d 100644 --- a/packages/react-router-ssr-query/CHANGELOG.md +++ b/packages/react-router-ssr-query/CHANGELOG.md @@ -1,5 +1,37 @@ # @tanstack/react-router-ssr-query +## 1.167.1 + +### Patch Changes + +- Updated dependencies [[`d1997b6`](https://github.com/TanStack/router/commit/d1997b66d7c24c1d64772bb8bab5caf9c6d9cc48)]: + - @tanstack/router-ssr-query-core@1.169.1 + +## 1.167.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- Updated dependencies [[`201e150`](https://github.com/TanStack/router/commit/201e150bd1412bae2faa9ce53f0fefcb7574ac14)]: + - @tanstack/router-ssr-query-core@1.169.0 + +## 1.166.12 + +### Patch Changes + +- Updated dependencies [[`b12f57b`](https://github.com/TanStack/router/commit/b12f57bbb44e47d5452d46e9e67ea4d63cdb5b55)]: + - @tanstack/router-ssr-query-core@1.168.0 + +## 1.166.11 + +### Patch Changes + +- Updated dependencies [[`459057c`](https://github.com/TanStack/router/commit/459057cd2d90cff20d20e51d4964b0a8c950555e)]: + - @tanstack/router-ssr-query-core@1.167.1 + ## 1.166.10 ### Patch Changes diff --git a/packages/react-router-ssr-query/package.json b/packages/react-router-ssr-query/package.json index f36973d8a0..82d9917747 100644 --- a/packages/react-router-ssr-query/package.json +++ b/packages/react-router-ssr-query/package.json @@ -1,6 +1,6 @@ { "name": "@tanstack/react-router-ssr-query", - "version": "1.166.10", + "version": "1.167.1", "description": "Modern and scalable routing for React applications", "author": "Tanner Linsley", "license": "MIT", diff --git a/packages/react-router/CHANGELOG.md b/packages/react-router/CHANGELOG.md index 48c7e69d6b..fe798ffb2e 100644 --- a/packages/react-router/CHANGELOG.md +++ b/packages/react-router/CHANGELOG.md @@ -1,5 +1,239 @@ # @tanstack/react-router +## 1.170.10 + +### Patch Changes + +- [#7505](https://github.com/TanStack/router/pull/7505) [`2f53749`](https://github.com/TanStack/router/commit/2f5374945e2138559a51464f45a5152eae67e1dd) - Preserve primitive values thrown from beforeLoad error handling. + +- Updated dependencies [[`2f53749`](https://github.com/TanStack/router/commit/2f5374945e2138559a51464f45a5152eae67e1dd)]: + - @tanstack/router-core@1.171.8 + +## 1.170.9 + +### Patch Changes + +- [#7497](https://github.com/TanStack/router/pull/7497) [`d1997b6`](https://github.com/TanStack/router/commit/d1997b66d7c24c1d64772bb8bab5caf9c6d9cc48) - fix streaming + +- Updated dependencies [[`d1997b6`](https://github.com/TanStack/router/commit/d1997b66d7c24c1d64772bb8bab5caf9c6d9cc48)]: + - @tanstack/router-core@1.171.7 + +## 1.170.8 + +### Patch Changes + +- Add support for Rsbuild client output formats, including module output by default and IIFE output for classic script environments. ([#7477](https://github.com/TanStack/router/pull/7477)) + + Client entry scripts and preloads are now represented as root route manifest assets, script preloads follow the manifest script format, and script asset cross-origin configuration uses the `script` key. The `transformAssets` script callback context now exposes only `kind: 'script'` and `url`, keeping script format handling internal to manifest rendering. + +- Updated dependencies [[`51a97a1`](https://github.com/TanStack/router/commit/51a97a167fb3ef1b8ca70fbb63db635158f43509)]: + - @tanstack/router-core@1.171.6 + +## 1.170.7 + +### Patch Changes + +- Updated dependencies [[`5268ba4`](https://github.com/TanStack/router/commit/5268ba4566233ea58880df85f167ad0401a93a46)]: + - @tanstack/router-core@1.171.5 + +## 1.170.6 + +### Patch Changes + +- Fix hash navigation being overridden by stale scroll restoration entries. ([#7447](https://github.com/TanStack/router/pull/7447)) + +- Updated dependencies [[`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960), [`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960)]: + - @tanstack/router-core@1.171.4 + +## 1.170.5 + +### Patch Changes + +- Updated dependencies [[`5fa9e55`](https://github.com/TanStack/router/commit/5fa9e555f3a2edb5e45586623e6bcbfa7f7c7a6b)]: + - @tanstack/router-core@1.171.3 + +## 1.170.4 + +### Patch Changes + +- Updated dependencies [[`b60eb36`](https://github.com/TanStack/router/commit/b60eb36e59e8a468ee0742cbcf7f47aca1ff1c67)]: + - @tanstack/router-core@1.171.2 + +## 1.170.3 + +### Patch Changes + +- Updated dependencies [[`d9cf933`](https://github.com/TanStack/router/commit/d9cf9331b83fcbd2abfee75d839d862f9bb18e6b)]: + - @tanstack/router-core@1.171.1 + +## 1.170.2 + +### Patch Changes + +- Updated dependencies [[`d533f87`](https://github.com/TanStack/router/commit/d533f87976704098a40b48f160b37c28c8182806)]: + - @tanstack/router-core@1.171.0 + +## 1.170.1 + +### Patch Changes + +- Updated dependencies [[`2387a2e`](https://github.com/TanStack/router/commit/2387a2eea0683004cc400b9f71bed5944eb60110)]: + - @tanstack/router-core@1.170.1 + +## 1.170.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- Updated dependencies [[`b1c061a`](https://github.com/TanStack/router/commit/b1c061aff9185cdf5fdc08c0136382a9dce0302f), [`201e150`](https://github.com/TanStack/router/commit/201e150bd1412bae2faa9ce53f0fefcb7574ac14)]: + - @tanstack/router-core@1.170.0 + - @tanstack/history@1.162.0 + +## 1.169.2 + +### Patch Changes + +- Updated dependencies [[`35e88f0`](https://github.com/TanStack/router/commit/35e88f04996d71019a1868b7b06ecb4ddbc9df9e)]: + - @tanstack/router-core@1.169.2 + +## 1.169.1 + +### Patch Changes + +- Updated dependencies [[`4a1e63f`](https://github.com/TanStack/router/commit/4a1e63f1d1230b1ed8234609acad4639d8982c13)]: + - @tanstack/router-core@1.169.1 + +## 1.169.0 + +### Minor Changes + +- Allow `params.parse` to experimentally return `false` to skip an incoming route candidate during path matching. Thrown parse errors still surface on the selected match instead of falling through, and outgoing typed route-template links continue to use exact route lookup followed by `params.stringify` for URL generation. ([#7263](https://github.com/TanStack/router/pull/7263)) + +### Patch Changes + +- Updated dependencies [[`c992495`](https://github.com/TanStack/router/commit/c992495bf4010ff4c3597bb1f3b1ba02594e857e)]: + - @tanstack/router-core@1.169.0 + +## 1.168.26 + +### Patch Changes + +- Updated dependencies [[`b5c4183`](https://github.com/TanStack/router/commit/b5c4183ab8b44be8a75647b7f7b588ad7c146ece)]: + - @tanstack/router-core@1.168.18 + +## 1.168.25 + +### Patch Changes + +- Updated dependencies [[`493148b`](https://github.com/TanStack/router/commit/493148bc5378b7f9de1544d87f6aaa425c12eb34)]: + - @tanstack/router-core@1.168.17 + +## 1.168.24 + +### Patch Changes + +- Add TanStack Start inline CSS manifest support for SSR so route styles can be embedded in the HTML response and hydrated without duplicate stylesheet links. ([#7253](https://github.com/TanStack/router/pull/7253)) + +- Updated dependencies [[`4d864ee`](https://github.com/TanStack/router/commit/4d864eebbd184265eabb563d326ab409c93feb17)]: + - @tanstack/router-core@1.168.16 + +## 1.168.23 + +### Patch Changes + +- fix(react-router): prevent webpack static analysis of `React.use` with let binding ([#7182](https://github.com/TanStack/router/pull/7182)) + +## 1.168.22 + +### Patch Changes + +- Preserve shared route stylesheet links across client navigation by rendering route CSS assets with React stylesheet precedence. ([#7186](https://github.com/TanStack/router/pull/7186)) + +## 1.168.21 + +### Patch Changes + +- Updated dependencies [[`16f6892`](https://github.com/TanStack/router/commit/16f6892d6b7ceadf606677c5a40e743f29163aa6)]: + - @tanstack/router-core@1.168.15 + +## 1.168.20 + +### Patch Changes + +- Fix React Server Component imports from `@tanstack/react-router` by adding a `react-server` root export that preserves the normal API surface while resolving `notFound` and `redirect` from a server-safe entry. ([#7183](https://github.com/TanStack/router/pull/7183)) + + This fixes RSC routes that throw `notFound()` or `redirect()` from server functions so they behave correctly during SSR and client navigation. + +## 1.168.19 + +### Patch Changes + +- Fix route file transforms to preserve route ID quoting, handle more exported `Route` patterns, and avoid incorrect import rewrites in edge cases. ([#7167](https://github.com/TanStack/router/pull/7167)) + + Improve transform robustness with clearer route-call detection, safer import removal, and expanded test coverage for quote preservation, constructor swaps, and unsupported route definitions. + +## 1.168.18 + +### Patch Changes + +- Updated dependencies [[`0e2c900`](https://github.com/TanStack/router/commit/0e2c9003c18ae07c09969189c028f277ea562a7a)]: + - @tanstack/router-core@1.168.14 + +## 1.168.17 + +### Patch Changes + +- Updated dependencies [[`812792f`](https://github.com/TanStack/router/commit/812792fbda3caf97b300770855cf5641252f413b)]: + - @tanstack/router-core@1.168.13 + +## 1.168.16 + +### Patch Changes + +- Updated dependencies [[`8ec9ca9`](https://github.com/TanStack/router/commit/8ec9ca97b472779de878c2a6510f21deb24d386c)]: + - @tanstack/router-core@1.168.12 + +## 1.168.15 + +### Patch Changes + +- shorten internal non-minifiable store names for byte shaving ([#7152](https://github.com/TanStack/router/pull/7152)) + +- Updated dependencies [[`6355bb7`](https://github.com/TanStack/router/commit/6355bb75f7637ba77f06a923c18fdaf37720bb48)]: + - @tanstack/router-core@1.168.11 + +## 1.168.14 + +### Patch Changes + +- migrate createStore > createAtom for simpler API ([#7150](https://github.com/TanStack/router/pull/7150)) + +- Updated dependencies [[`459057c`](https://github.com/TanStack/router/commit/459057cd2d90cff20d20e51d4964b0a8c950555e)]: + - @tanstack/router-core@1.168.10 + +## 1.168.13 + +### Patch Changes + +- Fix `MatchRoute` child callback param inference to resolve params from the target `to` route instead of the route path key across React, Solid, and Vue adapters. ([#7139](https://github.com/TanStack/router/pull/7139)) + +- Fix a stale route error boundary state issue that could briefly render the next route's `errorComponent` after navigating away from a failed route. ([#7136](https://github.com/TanStack/router/pull/7136)) + +## 1.168.12 + +### Patch Changes + +- Fix redirected pending route transitions so lazy target routes can finish loading without stale redirected matches causing render errors. ([#7137](https://github.com/TanStack/router/pull/7137)) + +## 1.168.11 + +### Patch Changes + +- Fix `Link` to keep internal routing props like `preloadIntentProximity`, `from`, and `unsafeRelative` from leaking to rendered DOM elements across React, Solid, and Vue. ([#7138](https://github.com/TanStack/router/pull/7138)) + ## 1.168.10 ### Patch Changes diff --git a/packages/react-router/bin/intent.js b/packages/react-router/bin/intent.js deleted file mode 100755 index 5b08532885..0000000000 --- a/packages/react-router/bin/intent.js +++ /dev/null @@ -1,25 +0,0 @@ -#!/usr/bin/env node -// Auto-generated by @tanstack/intent setup -// Exposes the intent end-user CLI for consumers of this library. -// Commit this file, then add to your package.json: -// "bin": { "intent": "./bin/intent.js" } -try { - await import('@tanstack/intent/intent-library') -} catch (e) { - const isModuleNotFound = - e?.code === 'ERR_MODULE_NOT_FOUND' || e?.code === 'MODULE_NOT_FOUND' - const missingIntentLibrary = - typeof e?.message === 'string' && e.message.includes('@tanstack/intent') - - if (isModuleNotFound && missingIntentLibrary) { - console.error('@tanstack/intent is not installed.') - console.error('') - console.error('Install it as a dev dependency:') - console.error(' npm add -D @tanstack/intent') - console.error('') - console.error('Or run directly:') - console.error(' npx @tanstack/intent@latest list') - process.exit(1) - } - throw e -} diff --git a/packages/react-router/package.json b/packages/react-router/package.json index 92d39f038d..b97b188537 100644 --- a/packages/react-router/package.json +++ b/packages/react-router/package.json @@ -1,6 +1,6 @@ { "name": "@tanstack/react-router", - "version": "1.168.10", + "version": "1.170.10", "description": "Modern and scalable routing for React applications", "author": "Tanner Linsley", "license": "MIT", @@ -48,6 +48,10 @@ "module": "dist/esm/index.js", "exports": { ".": { + "react-server": { + "types": "./dist/esm/index.rsc.d.ts", + "default": "./dist/esm/index.rsc.js" + }, "import": { "types": "./dist/esm/index.d.ts", "development": "./dist/esm/index.dev.js", @@ -104,14 +108,14 @@ "devDependencies": { "@testing-library/jest-dom": "^6.6.3", "@testing-library/react": "^16.2.0", + "@types/node": ">=20", "@vitejs/plugin-react": "^4.3.4", "combinate": "^1.1.11", "react": "^19.0.0", "react-dom": "^19.0.0", "vibe-rules": "^0.2.57", "vite": "*", - "zod": "^3.24.2", - "@types/node": ">=20" + "zod": "^4.4.3" }, "peerDependencies": { "react": ">=18.0.0 || >=19.0.0", diff --git a/packages/react-router/src/Asset.tsx b/packages/react-router/src/Asset.tsx index 4de655fed8..5e4f159f52 100644 --- a/packages/react-router/src/Asset.tsx +++ b/packages/react-router/src/Asset.tsx @@ -1,22 +1,49 @@ +'use client' + import * as React from 'react' import { isServer } from '@tanstack/router-core/isServer' import { useRouter } from './useRouter' import { useHydrated } from './ClientOnly' import type { RouterManagedTag } from '@tanstack/router-core' +const INLINE_CSS_HYDRATION_ATTR = 'data-tsr-inline-css' + interface ScriptAttrs { [key: string]: string | boolean | undefined src?: string suppressHydrationWarning?: boolean } -export function Asset({ - tag, - attrs, - children, - nonce, -}: RouterManagedTag & { nonce?: string }): React.ReactElement | null { - switch (tag) { +const noopScriptHandler = () => {} + +function setScriptAttrs( + script: HTMLScriptElement, + attrs: ScriptAttrs | undefined, +) { + if (!attrs) { + return + } + + for (const [key, value] of Object.entries(attrs)) { + if ( + key !== 'suppressHydrationWarning' && + value !== undefined && + value !== false + ) { + script.setAttribute(key, typeof value === 'boolean' ? '' : String(value)) + } + } +} + +export function Asset( + asset: RouterManagedTag & { + nonce?: string + preventScriptHoist?: boolean + }, +): React.ReactElement | null { + const { attrs, children, nonce, preventScriptHoist } = asset + + switch (asset.tag) { case 'title': return ( @@ -26,8 +53,30 @@ export function Asset({ case 'meta': return <meta {...attrs} suppressHydrationWarning /> case 'link': - return <link {...attrs} nonce={nonce} suppressHydrationWarning /> + return ( + <link + {...attrs} + precedence={ + attrs?.precedence ?? + (attrs?.rel === 'stylesheet' ? 'default' : undefined) + } + nonce={nonce} + suppressHydrationWarning + /> + ) case 'style': + if ( + asset.inlineCss && + (process.env.TSS_INLINE_CSS_ENABLED === 'true' || + (process.env.TSS_INLINE_CSS_ENABLED === undefined && isServer)) + ) { + return ( + <InlineCssStyle attrs={attrs} nonce={nonce}> + {children} + </InlineCssStyle> + ) + } + return ( <style {...attrs} @@ -36,18 +85,60 @@ export function Asset({ /> ) case 'script': - return <Script attrs={attrs}>{children}</Script> + return ( + <Script attrs={attrs} preventScriptHoist={preventScriptHoist}> + {children} + </Script> + ) default: return null } } +function InlineCssStyle({ + attrs, + children, + nonce, +}: { + attrs?: Record<string, any> + children?: RouterManagedTag['children'] + nonce?: string +}) { + const isInlineCssPlaceholder = children === undefined + const [hydratedInlineCss] = React.useState(() => { + if (!isInlineCssPlaceholder || typeof document === 'undefined') { + return undefined + } + + return ( + document.querySelector<HTMLStyleElement>( + `style[${INLINE_CSS_HYDRATION_ATTR}]`, + )?.textContent ?? undefined + ) + }) + const html = isInlineCssPlaceholder + ? (hydratedInlineCss ?? '') + : (children ?? '') + + return ( + <style + {...attrs} + {...{ [INLINE_CSS_HYDRATION_ATTR]: '' }} + dangerouslySetInnerHTML={{ __html: html }} + nonce={nonce} + suppressHydrationWarning + /> + ) +} + function Script({ attrs, children, + preventScriptHoist, }: { attrs?: ScriptAttrs children?: string + preventScriptHoist?: boolean }) { const router = useRouter() const hydrated = useHydrated() @@ -80,36 +171,19 @@ function Script({ return attrs.src } })() - const existingScript = Array.from( - document.querySelectorAll('script[src]'), - ).find((el) => (el as HTMLScriptElement).src === normSrc) - - if (existingScript) { - return + for (const el of document.querySelectorAll('script[src]')) { + if ((el as HTMLScriptElement).src === normSrc) { + return + } } const script = document.createElement('script') - for (const [key, value] of Object.entries(attrs)) { - if ( - key !== 'suppressHydrationWarning' && - value !== undefined && - value !== false - ) { - script.setAttribute( - key, - typeof value === 'boolean' ? '' : String(value), - ) - } - } + setScriptAttrs(script, attrs) document.head.appendChild(script) - return () => { - if (script.parentNode) { - script.parentNode.removeChild(script) - } - } + return () => script.remove() } if (typeof children === 'string') { @@ -117,48 +191,29 @@ function Script({ typeof attrs?.type === 'string' ? attrs.type : 'text/javascript' const nonceAttr = typeof attrs?.nonce === 'string' ? attrs.nonce : undefined - const existingScript = Array.from( - document.querySelectorAll('script:not([src])'), - ).find((el) => { - if (!(el instanceof HTMLScriptElement)) return false + for (const el of document.querySelectorAll('script:not([src])')) { + if (!(el instanceof HTMLScriptElement)) { + continue + } + const sType = el.getAttribute('type') ?? 'text/javascript' const sNonce = el.getAttribute('nonce') ?? undefined - return ( + if ( el.textContent === children && sType === typeAttr && sNonce === nonceAttr - ) - }) - - if (existingScript) { - return + ) { + return + } } const script = document.createElement('script') script.textContent = children - - if (attrs) { - for (const [key, value] of Object.entries(attrs)) { - if ( - key !== 'suppressHydrationWarning' && - value !== undefined && - value !== false - ) { - script.setAttribute( - key, - typeof value === 'boolean' ? '' : String(value), - ) - } - } - } + setScriptAttrs(script, attrs) document.head.appendChild(script) - return () => { - if (script.parentNode) { - script.parentNode.removeChild(script) - } - } + return () => script.remove() } return undefined @@ -167,7 +222,20 @@ function Script({ // --- Server rendering --- if (isServer ?? router.isServer) { if (attrs?.src) { - return <script {...attrs} suppressHydrationWarning /> + if (!preventScriptHoist) { + return <script {...attrs} suppressHydrationWarning /> + } + + return ( + <script + {...attrs} + // React hoists async src scripts into <head> during SSR unless they + // have an event handler. Start's client entry must stay after router + // dehydration. + onLoad={noopScriptHandler} + suppressHydrationWarning + /> + ) } if (typeof children === 'string') { @@ -204,6 +272,7 @@ function Script({ if (attrs?.src) { return <script {...attrs} suppressHydrationWarning /> } + if (typeof children === 'string') { return ( <script diff --git a/packages/react-router/src/CatchBoundary.tsx b/packages/react-router/src/CatchBoundary.tsx index 68197b2eb6..98743f9447 100644 --- a/packages/react-router/src/CatchBoundary.tsx +++ b/packages/react-router/src/CatchBoundary.tsx @@ -1,3 +1,5 @@ +'use client' + import * as React from 'react' import type { ErrorRouteComponent } from './route' import type { ErrorInfo } from 'react' @@ -36,9 +38,19 @@ class CatchBoundaryImpl extends React.Component<{ }) => React.ReactNode onCatch?: (error: Error, errorInfo: ErrorInfo) => void }> { - state = { error: null } as { error: Error | null; resetKey: string } - static getDerivedStateFromProps(props: any) { - return { resetKey: props.getResetKey() } + state = { error: null } as { error: Error | null; resetKey?: string | number } + + static getDerivedStateFromProps( + props: { getResetKey: () => string | number }, + state: { resetKey?: string | number; error: Error | null }, + ) { + const resetKey = props.getResetKey() + + if (state.error && state.resetKey !== resetKey) { + return { resetKey, error: null } + } + + return { resetKey } } static getDerivedStateFromError(error: Error) { return { error } @@ -46,30 +58,14 @@ class CatchBoundaryImpl extends React.Component<{ reset() { this.setState({ error: null }) } - componentDidUpdate( - prevProps: Readonly<{ - getResetKey: () => string - children: (props: { error: any; reset: () => void }) => any - onCatch?: ((error: any, info: any) => void) | undefined - }>, - prevState: any, - ): void { - if (prevState.error && prevState.resetKey !== this.state.resetKey) { - this.reset() - } - } componentDidCatch(error: Error, errorInfo: ErrorInfo) { if (this.props.onCatch) { this.props.onCatch(error, errorInfo) } } render() { - // If the resetKey has changed, don't render the error return this.props.children({ - error: - this.state.resetKey !== this.props.getResetKey() - ? null - : this.state.error, + error: this.state.error, reset: () => { this.reset() }, diff --git a/packages/react-router/src/ClientOnly.tsx b/packages/react-router/src/ClientOnly.tsx index 931804b259..10f903b204 100644 --- a/packages/react-router/src/ClientOnly.tsx +++ b/packages/react-router/src/ClientOnly.tsx @@ -1,3 +1,5 @@ +'use client' + import React from 'react' export interface ClientOnlyProps { @@ -64,5 +66,7 @@ export function useHydrated(): boolean { } function subscribe() { - return () => {} + return () => { + // noop + } } diff --git a/packages/react-router/src/HeadContent.dev.tsx b/packages/react-router/src/HeadContent.dev.tsx index 25cb4e410c..776f334318 100644 --- a/packages/react-router/src/HeadContent.dev.tsx +++ b/packages/react-router/src/HeadContent.dev.tsx @@ -1,12 +1,13 @@ +'use client' + import * as React from 'react' +import { DEV_STYLES_ATTR } from '@tanstack/router-core' import { Asset } from './Asset' import { useRouter } from './useRouter' import { useHydrated } from './ClientOnly' import { useTags } from './headContentUtils' import type { HeadContentProps } from './HeadContent' -const DEV_STYLES_ATTR = 'data-tanstack-router-dev-styles' - /** * Render route-managed head tags (title, meta, links, styles, head scripts). * Place inside the document head of your app shell. @@ -34,7 +35,9 @@ export function HeadContent(props: HeadContentProps) { // Filter out dev styles after hydration const filteredTags = hydrated - ? tags.filter((tag) => !tag.attrs?.[DEV_STYLES_ATTR]) + ? tags.filter( + (tag) => tag.tag !== 'link' || tag.attrs?.[DEV_STYLES_ATTR] !== true, + ) : tags return ( diff --git a/packages/react-router/src/HeadContent.tsx b/packages/react-router/src/HeadContent.tsx index c5d87a1778..6a0c8188bc 100644 --- a/packages/react-router/src/HeadContent.tsx +++ b/packages/react-router/src/HeadContent.tsx @@ -1,3 +1,5 @@ +'use client' + import * as React from 'react' import { Asset } from './Asset' import { useRouter } from './useRouter' diff --git a/packages/react-router/src/Match.tsx b/packages/react-router/src/Match.tsx index ae30f4b7ec..fefd256bf6 100644 --- a/packages/react-router/src/Match.tsx +++ b/packages/react-router/src/Match.tsx @@ -1,3 +1,5 @@ +'use client' + import * as React from 'react' import { useStore } from '@tanstack/react-store' import { @@ -28,7 +30,7 @@ export const Match = React.memo(function MatchImpl({ const router = useRouter() if (isServer ?? router.isServer) { - const match = router.stores.activeMatchStoresById.get(matchId)?.state + const match = router.stores.matchStores.get(matchId)?.get() if (!match) { if (process.env.NODE_ENV !== 'production') { throw new Error( @@ -47,7 +49,7 @@ export const Match = React.memo(function MatchImpl({ <MatchView router={router} matchId={matchId} - resetKey={router.stores.loadedAt.state} + resetKey={router.stores.loadedAt.get()} matchState={{ routeId, ssr: match.ssr, @@ -62,7 +64,7 @@ export const Match = React.memo(function MatchImpl({ // The matchId prop is stable for this component's lifetime (set by Outlet), // and reconcileMatchPool reuses stores for the same matchId. - const matchStore = router.stores.activeMatchStoresById.get(matchId) + const matchStore = router.stores.matchStores.get(matchId) if (!matchStore) { if (process.env.NODE_ENV !== 'production') { throw new Error( @@ -241,8 +243,8 @@ function OnRendered({ resetKey }: { resetKey: number }) { router.emit({ type: 'onRendered', ...getLocationChangeInfo( - router.stores.location.state, - router.stores.resolvedLocation.state, + router.stores.location.get(), + router.stores.resolvedLocation.get(), ), }) prevHrefRef.current = currentHref @@ -259,8 +261,24 @@ export const MatchInner = React.memo(function MatchInnerImpl({ }): any { const router = useRouter() + const getMatchPromise = ( + match: { + id: string + _nonReactive: { + displayPendingPromise?: Promise<void> + minPendingPromise?: Promise<void> + loadPromise?: Promise<void> + } + }, + key: 'displayPendingPromise' | 'minPendingPromise' | 'loadPromise', + ) => { + return ( + router.getMatch(match.id)?._nonReactive[key] ?? match._nonReactive[key] + ) + } + if (isServer ?? router.isServer) { - const match = router.stores.activeMatchStoresById.get(matchId)?.state + const match = router.stores.matchStores.get(matchId)?.get() if (!match) { if (process.env.NODE_ENV !== 'production') { throw new Error( @@ -287,15 +305,15 @@ export const MatchInner = React.memo(function MatchInnerImpl({ const out = Comp ? <Comp key={key} /> : <Outlet /> if (match._displayPending) { - throw router.getMatch(match.id)?._nonReactive.displayPendingPromise + throw getMatchPromise(match, 'displayPendingPromise') } if (match._forcePending) { - throw router.getMatch(match.id)?._nonReactive.minPendingPromise + throw getMatchPromise(match, 'minPendingPromise') } if (match.status === 'pending') { - throw router.getMatch(match.id)?._nonReactive.loadPromise + throw getMatchPromise(match, 'loadPromise') } if (match.status === 'notFound') { @@ -317,7 +335,7 @@ export const MatchInner = React.memo(function MatchInnerImpl({ invariant() } - throw router.getMatch(match.id)?._nonReactive.loadPromise + throw getMatchPromise(match, 'loadPromise') } if (match.status === 'error') { @@ -339,7 +357,7 @@ export const MatchInner = React.memo(function MatchInnerImpl({ return out } - const matchStore = router.stores.activeMatchStoresById.get(matchId) + const matchStore = router.stores.matchStores.get(matchId) if (!matchStore) { if (process.env.NODE_ENV !== 'production') { throw new Error( @@ -384,11 +402,11 @@ export const MatchInner = React.memo(function MatchInnerImpl({ }, [key, route.options.component, router.options.defaultComponent]) if (match._displayPending) { - throw router.getMatch(match.id)?._nonReactive.displayPendingPromise + throw getMatchPromise(match, 'displayPendingPromise') } if (match._forcePending) { - throw router.getMatch(match.id)?._nonReactive.minPendingPromise + throw getMatchPromise(match, 'minPendingPromise') } // see also hydrate() in packages/router-core/src/ssr/ssr-client.ts @@ -413,7 +431,7 @@ export const MatchInner = React.memo(function MatchInnerImpl({ } } } - throw router.getMatch(match.id)?._nonReactive.loadPromise + throw getMatchPromise(match, 'loadPromise') } if (match.status === 'notFound') { @@ -428,8 +446,10 @@ export const MatchInner = React.memo(function MatchInnerImpl({ } if (match.status === 'redirected') { - // Redirects should be handled by the router transition. If we happen to - // encounter a redirect here, it's a bug. Let's warn, but render nothing. + // A match can be observed as redirected during an in-flight transition, + // especially when pending UI is already rendering. Suspend on the match's + // load promise so React can abandon this stale render and continue the + // redirect transition. if (!isRedirect(match.error)) { if (process.env.NODE_ENV !== 'production') { throw new Error('Invariant failed: Expected a redirect error') @@ -438,11 +458,7 @@ export const MatchInner = React.memo(function MatchInnerImpl({ invariant() } - // warning( - // false, - // 'Tried to render a redirected route match! This is a weird circumstance, please file an issue!', - // ) - throw router.getMatch(match.id)?._nonReactive.loadPromise + throw getMatchPromise(match, 'loadPromise') } if (match.status === 'error') { @@ -488,7 +504,7 @@ export const Outlet = React.memo(function OutletImpl() { let childMatchId: string | undefined if (isServer ?? router.isServer) { - const matches = router.stores.activeMatchesSnapshot.state + const matches = router.stores.matches.get() const parentIndex = matchId ? matches.findIndex((match) => match.id === matchId) : -1 @@ -501,7 +517,7 @@ export const Outlet = React.memo(function OutletImpl() { // Subscribe directly to the match store from the pool instead of // the two-level byId → matchStore pattern. const parentMatchStore = matchId - ? router.stores.activeMatchStoresById.get(matchId) + ? router.stores.matchStores.get(matchId) : undefined // eslint-disable-next-line react-hooks/rules-of-hooks diff --git a/packages/react-router/src/Matches.tsx b/packages/react-router/src/Matches.tsx index f7f61d6e9b..5036f6e727 100644 --- a/packages/react-router/src/Matches.tsx +++ b/packages/react-router/src/Matches.tsx @@ -1,3 +1,5 @@ +'use client' + import * as React from 'react' import { useStore } from '@tanstack/react-store' import { replaceEqualDeep, rootRouteId } from '@tanstack/router-core' @@ -22,11 +24,8 @@ import type { MakeRouteMatchUnion, MaskOptions, MatchRouteOptions, - NoInfer, RegisteredRouter, - ResolveRelativePath, ResolveRoute, - RouteByPath, ToSubOptionsProps, } from '@tanstack/router-core' @@ -78,11 +77,11 @@ function MatchesInner() { const router = useRouter() const _isServer = isServer ?? router.isServer const matchId = _isServer - ? router.stores.firstMatchId.state + ? router.stores.firstId.get() : // eslint-disable-next-line react-hooks/rules-of-hooks - useStore(router.stores.firstMatchId, (id) => id) + useStore(router.stores.firstId, (id) => id) const resetKey = _isServer - ? router.stores.loadedAt.state + ? router.stores.loadedAt.get() : // eslint-disable-next-line react-hooks/rules-of-hooks useStore(router.stores.loadedAt, (loadedAt) => loadedAt) @@ -143,7 +142,7 @@ export function useMatchRoute<TRouter extends AnyRouter = RegisteredRouter>() { if (!(isServer ?? router.isServer)) { // eslint-disable-next-line react-hooks/rules-of-hooks - useStore(router.stores.matchRouteReactivity, (d) => d) + useStore(router.stores.matchRouteDeps, (d) => d) } return React.useCallback( @@ -180,10 +179,9 @@ export type MakeMatchRouteOptions< // If a function is passed as a child, it will be given the `isActive` boolean to aid in further styling on the element it returns children?: | (( - params?: RouteByPath< - TRouter['routeTree'], - ResolveRelativePath<TFrom, NoInfer<TTo>> - >['types']['allParams'], + params?: Expand< + ResolveRoute<TRouter, TFrom, TTo>['types']['allParams'] + >, ) => React.ReactNode) | React.ReactNode } @@ -242,7 +240,7 @@ export function useMatches< ) if (isServer ?? router.isServer) { - const matches = router.stores.activeMatchesSnapshot.state as Array< + const matches = router.stores.matches.get() as Array< MakeRouteMatchUnion<TRouter> > return (opts?.select ? opts.select(matches) : matches) as UseMatchesResult< @@ -252,7 +250,7 @@ export function useMatches< } // eslint-disable-next-line react-hooks/rules-of-hooks - return useStore(router.stores.activeMatchesSnapshot, (matches) => { + return useStore(router.stores.matches, (matches) => { const selected = opts?.select ? opts.select(matches as Array<MakeRouteMatchUnion<TRouter>>) : (matches as any) diff --git a/packages/react-router/src/RouterProvider.tsx b/packages/react-router/src/RouterProvider.tsx index d340feb4da..4846ab17fc 100644 --- a/packages/react-router/src/RouterProvider.tsx +++ b/packages/react-router/src/RouterProvider.tsx @@ -1,4 +1,7 @@ +'use client' + import * as React from 'react' +import { hasKeys } from '@tanstack/router-core' import { Matches } from './Matches' import { routerContext } from './routerContext' import type { @@ -21,7 +24,7 @@ export function RouterContextProvider< }: RouterProps<TRouter, TDehydrated> & { children: React.ReactNode }) { - if (Object.keys(rest).length > 0) { + if (hasKeys(rest)) { // Allow the router to update options on the router instance router.update({ ...router.options, diff --git a/packages/react-router/src/Scripts.tsx b/packages/react-router/src/Scripts.tsx index d2110b68be..5285fbd8db 100644 --- a/packages/react-router/src/Scripts.tsx +++ b/packages/react-router/src/Scripts.tsx @@ -5,6 +5,10 @@ import { Asset } from './Asset' import { useRouter } from './useRouter' import type { RouterManagedTag } from '@tanstack/router-core' +type ScriptRenderAsset = RouterManagedTag & { + preventScriptHoist?: boolean +} + /** * Render body script tags collected from route matches and SSR manifests. * Should be placed near the end of the document body. @@ -14,26 +18,31 @@ export const Scripts = () => { const nonce = router.options.ssr?.nonce const getAssetScripts = (matches: Array<any>) => { - const assetScripts: Array<RouterManagedTag> = [] + const assetScripts: Array<ScriptRenderAsset> = [] const manifest = router.ssr?.manifest if (!manifest) { return [] } - matches - .map((match) => router.looseRoutesById[match.routeId]!) - .forEach((route) => - manifest.routes[route.id]?.assets - ?.filter((d) => d.tag === 'script') - .forEach((asset) => { - assetScripts.push({ - tag: 'script', - attrs: { ...asset.attrs, nonce }, - children: asset.children, - } as any) - }), - ) + for (const match of matches) { + const scripts = manifest.routes[match.routeId]?.scripts + + if (!scripts) { + continue + } + + for (const asset of scripts) { + assetScripts.push({ + tag: 'script', + attrs: { ...asset.attrs, nonce }, + children: asset.children, + ...(typeof asset.attrs?.src === 'string' + ? { preventScriptHoist: true } + : {}), + }) + } + } return assetScripts } @@ -58,25 +67,20 @@ export const Scripts = () => { ) if (isServer ?? router.isServer) { - const assetScripts = getAssetScripts( - router.stores.activeMatchesSnapshot.state, - ) - const scripts = getScripts(router.stores.activeMatchesSnapshot.state) + const activeMatches = router.stores.matches.get() + const assetScripts = getAssetScripts(activeMatches) + const scripts = getScripts(activeMatches) return renderScripts(router, scripts, assetScripts) } // eslint-disable-next-line react-hooks/rules-of-hooks -- condition is static const assetScripts = useStore( - router.stores.activeMatchesSnapshot, + router.stores.matches, getAssetScripts, deepEqual, ) // eslint-disable-next-line react-hooks/rules-of-hooks -- condition is static - const scripts = useStore( - router.stores.activeMatchesSnapshot, - getScripts, - deepEqual, - ) + const scripts = useStore(router.stores.matches, getScripts, deepEqual) return renderScripts(router, scripts, assetScripts) } @@ -84,18 +88,15 @@ export const Scripts = () => { function renderScripts( router: ReturnType<typeof useRouter>, scripts: Array<RouterManagedTag>, - assetScripts: Array<RouterManagedTag>, + assetScripts: Array<ScriptRenderAsset>, ) { - let serverBufferedScript: RouterManagedTag | undefined = undefined + const allScripts = [...scripts, ...assetScripts] as Array<ScriptRenderAsset> - if (router.serverSsr) { - serverBufferedScript = router.serverSsr.takeBufferedScripts() - } - - const allScripts = [...scripts, ...assetScripts] as Array<RouterManagedTag> - - if (serverBufferedScript) { - allScripts.unshift(serverBufferedScript) + if ((isServer ?? router.isServer) && router.serverSsr) { + const serverBufferedScript = router.serverSsr.takeBufferedScripts() + if (serverBufferedScript) { + allScripts.unshift(serverBufferedScript) + } } return ( diff --git a/packages/react-router/src/Transitioner.tsx b/packages/react-router/src/Transitioner.tsx index d84d22a6ba..bf945571a6 100644 --- a/packages/react-router/src/Transitioner.tsx +++ b/packages/react-router/src/Transitioner.tsx @@ -1,10 +1,8 @@ +'use client' + import * as React from 'react' import { batch, useStore } from '@tanstack/react-store' -import { - getLocationChangeInfo, - handleHashScroll, - trimPathRight, -} from '@tanstack/router-core' +import { getLocationChangeInfo, trimPathRight } from '@tanstack/router-core' import { useLayoutEffect, usePrevious } from './utils' import { useRouter } from './useRouter' @@ -15,17 +13,14 @@ export function Transitioner() { const [isTransitioning, setIsTransitioning] = React.useState(false) // Track pending state changes const isLoading = useStore(router.stores.isLoading, (value) => value) - const hasPendingMatches = useStore( - router.stores.hasPendingMatches, - (value) => value, - ) + const hasPending = useStore(router.stores.hasPending, (value) => value) const previousIsLoading = usePrevious(isLoading) - const isAnyPending = isLoading || isTransitioning || hasPendingMatches + const isAnyPending = isLoading || isTransitioning || hasPending const previousIsAnyPending = usePrevious(isAnyPending) - const isPagePending = isLoading || hasPendingMatches + const isPagePending = isLoading || hasPending const previousIsPagePending = usePrevious(isPagePending) router.startTransition = (fn: () => void) => { @@ -94,8 +89,8 @@ export function Transitioner() { router.emit({ type: 'onLoad', // When the new URL has committed, when the new matches have been loaded into state.matches ...getLocationChangeInfo( - router.stores.location.state, - router.stores.resolvedLocation.state, + router.stores.location.get(), + router.stores.resolvedLocation.get(), ), }) } @@ -107,8 +102,8 @@ export function Transitioner() { router.emit({ type: 'onBeforeRouteMount', ...getLocationChangeInfo( - router.stores.location.state, - router.stores.resolvedLocation.state, + router.stores.location.get(), + router.stores.resolvedLocation.get(), ), }) } @@ -117,8 +112,8 @@ export function Transitioner() { useLayoutEffect(() => { if (previousIsAnyPending && !isAnyPending) { const changeInfo = getLocationChangeInfo( - router.stores.location.state, - router.stores.resolvedLocation.state, + router.stores.location.get(), + router.stores.resolvedLocation.get(), ) router.emit({ type: 'onResolved', @@ -126,15 +121,9 @@ export function Transitioner() { }) batch(() => { - router.stores.status.setState(() => 'idle') - router.stores.resolvedLocation.setState( - () => router.stores.location.state, - ) + router.stores.status.set('idle') + router.stores.resolvedLocation.set(router.stores.location.get()) }) - - if (changeInfo.hrefChanged) { - handleHashScroll(router) - } } }, [isAnyPending, previousIsAnyPending, router]) diff --git a/packages/react-router/src/fileRoute.ts b/packages/react-router/src/fileRoute.ts index aeccbc2044..46b96240a4 100644 --- a/packages/react-router/src/fileRoute.ts +++ b/packages/react-router/src/fileRoute.ts @@ -56,11 +56,6 @@ export function createFileRoute< >( path?: TFilePath, ): FileRoute<TFilePath, TParentRoute, TId, TPath, TFullPath>['createRoute'] { - if (typeof path === 'object') { - return new FileRoute<TFilePath, TParentRoute, TId, TPath, TFullPath>(path, { - silent: true, - }).createRoute(path) as any - } return new FileRoute<TFilePath, TParentRoute, TId, TPath, TFullPath>(path, { silent: true, }).createRoute @@ -188,7 +183,7 @@ export function FileRouteLoader< ) => TLoaderFn { if (process.env.NODE_ENV !== 'production') { console.warn( - `Warning: FileRouteLoader is deprecated and will be removed in the next major version. Please place the loader function in the the main route file, inside the \`createFileRoute('/path/to/file')(options)\` options`, + `Warning: FileRouteLoader is deprecated and will be removed in the next major version. Please place the loader function in the main route file, inside the \`createFileRoute('/path/to/file')(options)\` options`, ) } return (loaderFn) => loaderFn as any diff --git a/packages/react-router/src/headContentUtils.tsx b/packages/react-router/src/headContentUtils.tsx index b180af2941..5ed35bd1ce 100644 --- a/packages/react-router/src/headContentUtils.tsx +++ b/packages/react-router/src/headContentUtils.tsx @@ -1,14 +1,17 @@ import * as React from 'react' import { useStore } from '@tanstack/react-store' import { + appendUniqueUserTags, deepEqual, escapeHtml, getAssetCrossOrigin, - resolveManifestAssetLink, + getScriptPreloadAttrs, + resolveManifestCssLink, } from '@tanstack/router-core' import { isServer } from '@tanstack/router-core/isServer' import { useRouter } from './useRouter' import type { + AnyRouteMatch, AssetCrossOriginConfig, RouterManagedTag, } from '@tanstack/router-core' @@ -16,10 +19,12 @@ import type { function buildTagsFromMatches( router: ReturnType<typeof useRouter>, nonce: string | undefined, - matches: Array<any>, + matches: Array<AnyRouteMatch>, assetCrossOrigin?: AssetCrossOriginConfig, ): Array<RouterManagedTag> { - const routeMeta = matches.map((match) => match.meta!).filter(Boolean) + const routeMeta = matches + .map((match) => match.meta) + .filter((meta) => meta !== undefined) const resultMeta: Array<RouterManagedTag> = [] const metaByAttribute: Record<string, true> = {} @@ -87,9 +92,8 @@ function buildTagsFromMatches( resultMeta.reverse() const constructedLinks = matches - .map((match) => match.links!) - .filter(Boolean) - .flat(1) + .flatMap((match) => match.links ?? []) + .filter((link) => link !== undefined) .map((link) => ({ tag: 'link', attrs: { @@ -99,87 +103,87 @@ function buildTagsFromMatches( })) satisfies Array<RouterManagedTag> const manifest = router.ssr?.manifest - const assetLinks = matches - .map((match) => manifest?.routes[match.routeId]?.assets ?? []) - .filter(Boolean) - .flat(1) - .filter((asset) => asset.tag === 'link') - .map( - (asset) => - ({ + const manifestCssTags: Array<RouterManagedTag> = [] + if (manifest) { + matches.forEach((match) => { + const css = manifest.routes[match.routeId]?.css + css?.forEach((link) => { + const resolvedLink = resolveManifestCssLink(link) + manifestCssTags.push({ tag: 'link', attrs: { - ...asset.attrs, + rel: 'stylesheet', + ...resolvedLink, crossOrigin: getAssetCrossOrigin(assetCrossOrigin, 'stylesheet') ?? - asset.attrs?.crossOrigin, + resolvedLink.crossOrigin, suppressHydrationWarning: true, nonce, }, - }) satisfies RouterManagedTag, - ) + }) + }) + }) + + if (manifest.inlineStyle) { + manifestCssTags.push({ + tag: 'style', + attrs: { + ...manifest.inlineStyle.attrs, + nonce, + }, + children: manifest.inlineStyle.children, + inlineCss: true, + }) + } + } const preloadLinks: Array<RouterManagedTag> = [] - matches - .map((match) => router.looseRoutesById[match.routeId]!) - .forEach((route) => - router.ssr?.manifest?.routes[route.id]?.preloads - ?.filter(Boolean) - .forEach((preload) => { - const preloadLink = resolveManifestAssetLink(preload) - preloadLinks.push({ - tag: 'link', - attrs: { - rel: 'modulepreload', - href: preloadLink.href, - crossOrigin: - getAssetCrossOrigin(assetCrossOrigin, 'modulepreload') ?? - preloadLink.crossOrigin, - nonce, - }, - }) - }), - ) + if (manifest) { + matches.forEach((match) => { + manifest.routes[match.routeId]?.preloads?.forEach((preload) => { + preloadLinks.push({ + tag: 'link', + attrs: { + ...getScriptPreloadAttrs(manifest, preload, assetCrossOrigin), + nonce, + }, + }) + }) + }) + } - const styles = ( - matches - .map((match) => match.styles!) - .flat(1) - .filter(Boolean) as Array<RouterManagedTag> - ).map(({ children, ...attrs }) => ({ - tag: 'style', - attrs: { - ...attrs, - nonce, - }, - children, - })) + const styles = matches + .flatMap((match) => match.styles ?? []) + .filter((style) => style !== undefined) + .map(({ children, ...attrs }) => ({ + tag: 'style', + attrs: { + ...attrs, + nonce, + }, + children: children as string | undefined, + })) satisfies Array<RouterManagedTag> - const headScripts = ( - matches - .map((match) => match.headScripts!) - .flat(1) - .filter(Boolean) as Array<RouterManagedTag> - ).map(({ children, ...script }) => ({ - tag: 'script', - attrs: { - ...script, - nonce, - }, - children, - })) + const headScripts = matches + .flatMap((match) => match.headScripts ?? []) + .filter((script) => script !== undefined) + .map(({ children, ...script }) => ({ + tag: 'script', + attrs: { + ...script, + nonce, + }, + children: children as string | undefined, + })) satisfies Array<RouterManagedTag> - return uniqBy( - [ - ...resultMeta, - ...preloadLinks, - ...constructedLinks, - ...assetLinks, - ...styles, - ...headScripts, - ] as Array<RouterManagedTag>, - (d) => JSON.stringify(d), - ) + const tags: Array<RouterManagedTag> = [] + appendUniqueUserTags(tags, resultMeta) + tags.push(...preloadLinks) + appendUniqueUserTags(tags, constructedLinks) + tags.push(...manifestCssTags) + appendUniqueUserTags(tags, styles) + appendUniqueUserTags(tags, headScripts) + return tags } /** @@ -194,16 +198,18 @@ export const useTags = (assetCrossOrigin?: AssetCrossOriginConfig) => { return buildTagsFromMatches( router, nonce, - router.stores.activeMatchesSnapshot.state, + router.stores.matches.get(), assetCrossOrigin, ) } // eslint-disable-next-line react-hooks/rules-of-hooks -- condition is static const routeMeta = useStore( - router.stores.activeMatchesSnapshot, + router.stores.matches, (matches) => { - return matches.map((match) => match.meta!).filter(Boolean) + return matches + .map((match) => match.meta) + .filter((meta) => meta !== undefined) }, deepEqual, ) @@ -282,12 +288,11 @@ export const useTags = (assetCrossOrigin?: AssetCrossOriginConfig) => { // eslint-disable-next-line react-hooks/rules-of-hooks -- condition is static const links = useStore( - router.stores.activeMatchesSnapshot, + router.stores.matches, (matches) => { const constructed = matches - .map((match) => match.links!) - .filter(Boolean) - .flat(1) + .flatMap((match) => match.links ?? []) + .filter((link) => link !== undefined) .map((link) => ({ tag: 'link', attrs: { @@ -296,61 +301,79 @@ export const useTags = (assetCrossOrigin?: AssetCrossOriginConfig) => { }, })) satisfies Array<RouterManagedTag> + return constructed + }, + deepEqual, + ) + + // eslint-disable-next-line react-hooks/rules-of-hooks -- condition is static + const manifestCssTags = useStore( + router.stores.matches, + (matches) => { const manifest = router.ssr?.manifest + const tags: Array<RouterManagedTag> = [] - // These are the assets extracted from the ViteManifest - // using the `startManifestPlugin` - const assets = matches - .map((match) => manifest?.routes[match.routeId]?.assets ?? []) - .filter(Boolean) - .flat(1) - .filter((asset) => asset.tag === 'link') - .map( - (asset) => - ({ - tag: 'link', - attrs: { - ...asset.attrs, - crossOrigin: - getAssetCrossOrigin(assetCrossOrigin, 'stylesheet') ?? - asset.attrs?.crossOrigin, - suppressHydrationWarning: true, - nonce, - }, - }) satisfies RouterManagedTag, - ) + if (!manifest) { + return tags + } - return [...constructed, ...assets] + matches.forEach((match) => { + manifest.routes[match.routeId]?.css?.forEach((link) => { + const resolvedLink = resolveManifestCssLink(link) + tags.push({ + tag: 'link', + attrs: { + rel: 'stylesheet', + ...resolvedLink, + crossOrigin: + getAssetCrossOrigin(assetCrossOrigin, 'stylesheet') ?? + resolvedLink.crossOrigin, + suppressHydrationWarning: true, + nonce, + }, + }) + }) + }) + + if (manifest.inlineStyle) { + tags.push({ + tag: 'style', + attrs: { + ...manifest.inlineStyle.attrs, + nonce, + }, + children: manifest.inlineStyle.children, + inlineCss: true, + }) + } + + return tags }, deepEqual, ) // eslint-disable-next-line react-hooks/rules-of-hooks -- condition is static const preloadLinks = useStore( - router.stores.activeMatchesSnapshot, + router.stores.matches, (matches) => { const preloadLinks: Array<RouterManagedTag> = [] + const manifest = router.ssr?.manifest - matches - .map((match) => router.looseRoutesById[match.routeId]!) - .forEach((route) => - router.ssr?.manifest?.routes[route.id]?.preloads - ?.filter(Boolean) - .forEach((preload) => { - const preloadLink = resolveManifestAssetLink(preload) - preloadLinks.push({ - tag: 'link', - attrs: { - rel: 'modulepreload', - href: preloadLink.href, - crossOrigin: - getAssetCrossOrigin(assetCrossOrigin, 'modulepreload') ?? - preloadLink.crossOrigin, - nonce, - }, - }) - }), - ) + if (!manifest) { + return preloadLinks + } + + matches.forEach((match) => { + manifest.routes[match.routeId]?.preloads?.forEach((preload) => { + preloadLinks.push({ + tag: 'link', + attrs: { + ...getScriptPreloadAttrs(manifest, preload, assetCrossOrigin), + nonce, + }, + }) + }) + }) return preloadLinks }, @@ -359,66 +382,48 @@ export const useTags = (assetCrossOrigin?: AssetCrossOriginConfig) => { // eslint-disable-next-line react-hooks/rules-of-hooks -- condition is static const styles = useStore( - router.stores.activeMatchesSnapshot, - (matches) => - ( - matches - .map((match) => match.styles!) - .flat(1) - .filter(Boolean) as Array<RouterManagedTag> - ).map(({ children, ...attrs }) => ({ - tag: 'style', - attrs: { - ...attrs, - nonce, - }, - children, - })), + router.stores.matches, + (matches) => { + return matches + .flatMap((match) => match.styles ?? []) + .filter((style) => style !== undefined) + .map(({ children, ...attrs }) => ({ + tag: 'style', + attrs: { + ...attrs, + nonce, + }, + children: children as string | undefined, + })) satisfies Array<RouterManagedTag> + }, deepEqual, ) // eslint-disable-next-line react-hooks/rules-of-hooks -- condition is static const headScripts: Array<RouterManagedTag> = useStore( - router.stores.activeMatchesSnapshot, - (matches) => - ( - matches - .map((match) => match.headScripts!) - .flat(1) - .filter(Boolean) as Array<RouterManagedTag> - ).map(({ children, ...script }) => ({ - tag: 'script', - attrs: { - ...script, - nonce, - }, - children, - })), + router.stores.matches, + (matches) => { + return matches + .flatMap((match) => match.headScripts ?? []) + .filter((script) => script !== undefined) + .map(({ children, ...script }) => ({ + tag: 'script', + attrs: { + ...script, + nonce, + }, + children: children as string | undefined, + })) satisfies Array<RouterManagedTag> + }, deepEqual, ) - return uniqBy( - [ - ...meta, - ...preloadLinks, - ...links, - ...styles, - ...headScripts, - ] as Array<RouterManagedTag>, - (d) => { - return JSON.stringify(d) - }, - ) -} - -export function uniqBy<T>(arr: Array<T>, fn: (item: T) => string) { - const seen = new Set<string>() - return arr.filter((item) => { - const key = fn(item) - if (seen.has(key)) { - return false - } - seen.add(key) - return true - }) + const tags: Array<RouterManagedTag> = [] + appendUniqueUserTags(tags, meta) + tags.push(...preloadLinks) + appendUniqueUserTags(tags, links) + tags.push(...manifestCssTags) + appendUniqueUserTags(tags, styles) + appendUniqueUserTags(tags, headScripts) + return tags } diff --git a/packages/react-router/src/index.dev.tsx b/packages/react-router/src/index.dev.tsx index e7c962f3d6..dde6fd2eea 100644 --- a/packages/react-router/src/index.dev.tsx +++ b/packages/react-router/src/index.dev.tsx @@ -1,3 +1,5 @@ +'use client' + // Development entry point - re-exports everything from index.tsx // but overrides HeadContent with the dev version that handles // dev styles cleanup after hydration diff --git a/packages/react-router/src/index.rsc.ts b/packages/react-router/src/index.rsc.ts new file mode 100644 index 0000000000..d5baf7e952 --- /dev/null +++ b/packages/react-router/src/index.rsc.ts @@ -0,0 +1,11 @@ +export * from './index' + +export { + notFound, + isNotFound, + redirect, + isRedirect, + rootRouteId, +} from '@tanstack/router-core' + +export type { NotFoundError } from '@tanstack/router-core' diff --git a/packages/react-router/src/index.tsx b/packages/react-router/src/index.tsx index 09b93ad193..6637c7542b 100644 --- a/packages/react-router/src/index.tsx +++ b/packages/react-router/src/index.tsx @@ -1,3 +1,5 @@ +'use client' + export { defer, isMatch, @@ -71,6 +73,7 @@ export type { ResolveRouteContext, SearchSerializer, SearchParser, + SearchMiddleware, TrailingSlashOption, Manifest, RouterManagedTag, @@ -126,6 +129,7 @@ export type { AwaitOptions } from './awaited' export { CatchBoundary, ErrorComponent } from './CatchBoundary' export { ClientOnly, useHydrated } from './ClientOnly' +export { reactUse, useLayoutEffect } from './utils' export { FileRoute, @@ -326,6 +330,9 @@ export type { InferSelected, ValidateUseSearchResult, ValidateUseParamsResult, + SerializerExtensions, + RegisteredSerializableInput, + Serializable, } from '@tanstack/router-core' export { ScriptOnce } from './ScriptOnce' diff --git a/packages/react-router/src/link.tsx b/packages/react-router/src/link.tsx index 3f0dc83a22..eddc0ac0b3 100644 --- a/packages/react-router/src/link.tsx +++ b/packages/react-router/src/link.tsx @@ -1,3 +1,5 @@ +'use client' + import * as React from 'react' import { useStore } from '@tanstack/react-store' import { flushSync } from 'react-dom' @@ -5,6 +7,7 @@ import { deepEqual, exactPathTest, functionalUpdate, + hasKeys, isDangerousProtocol, preloadWarning, removeTrailingSlash, @@ -64,6 +67,7 @@ export function useLinkProps< to, preload: userPreload, preloadDelay: userPreloadDelay, + preloadIntentProximity: _preloadIntentProximity, hashScrollIntoView, replace, startTransition, @@ -204,7 +208,7 @@ export function useLinkProps< const isActive = (() => { if (externalLink) return false - const currentLocation = router.stores.location.state + const currentLocation = router.stores.location.get() const exact = activeOptions?.exact ?? false @@ -243,11 +247,11 @@ export function useLinkProps< const currentSearchEmpty = !currentLocation.search || (typeof currentLocation.search === 'object' && - Object.keys(currentLocation.search).length === 0) + !hasKeys(currentLocation.search)) const nextSearchEmpty = !next.search || (typeof next.search === 'object' && - Object.keys(next.search).length === 0) + !hasKeys(next.search as Record<string, unknown>)) if (!(currentSearchEmpty && nextSearchEmpty)) { const searchTest = deepEqual(currentLocation.search, next.search, { diff --git a/packages/react-router/src/matchContext.tsx b/packages/react-router/src/matchContext.tsx index ce182bd994..a7030847e1 100644 --- a/packages/react-router/src/matchContext.tsx +++ b/packages/react-router/src/matchContext.tsx @@ -1,3 +1,5 @@ +'use client' + import * as React from 'react' export const matchContext = React.createContext<string | undefined>(undefined) diff --git a/packages/react-router/src/not-found.tsx b/packages/react-router/src/not-found.tsx index 9932eadd47..ce3a04c748 100644 --- a/packages/react-router/src/not-found.tsx +++ b/packages/react-router/src/not-found.tsx @@ -15,8 +15,8 @@ export function CatchNotFound(props: { const router = useRouter() if (isServer ?? router.isServer) { - const pathname = router.stores.location.state.pathname - const status = router.stores.status.state + const pathname = router.stores.location.get().pathname + const status = router.stores.status.get() const resetKey = `not-found-${pathname}-${status}` return ( diff --git a/packages/react-router/src/routerContext.tsx b/packages/react-router/src/routerContext.tsx index dc623b70c2..30b442c6c4 100644 --- a/packages/react-router/src/routerContext.tsx +++ b/packages/react-router/src/routerContext.tsx @@ -1,3 +1,5 @@ +'use client' + import * as React from 'react' import type { AnyRouter } from '@tanstack/router-core' diff --git a/packages/react-router/src/routerStores.ts b/packages/react-router/src/routerStores.ts index 86126271a2..3197f54681 100644 --- a/packages/react-router/src/routerStores.ts +++ b/packages/react-router/src/routerStores.ts @@ -1,4 +1,4 @@ -import { batch, createStore } from '@tanstack/react-store' +import { batch, createAtom } from '@tanstack/react-store' import { createNonReactiveMutableStore, createNonReactiveReadonlyStore, @@ -19,8 +19,8 @@ export const getStoreFactory: GetStoreConfig = (opts) => { } } return { - createMutableStore: createStore, - createReadonlyStore: createStore, + createMutableStore: createAtom, + createReadonlyStore: createAtom, batch: batch, } } diff --git a/packages/react-router/src/ssr/RouterClient.tsx b/packages/react-router/src/ssr/RouterClient.tsx index 7c1cc491df..3271dcd63f 100644 --- a/packages/react-router/src/ssr/RouterClient.tsx +++ b/packages/react-router/src/ssr/RouterClient.tsx @@ -7,7 +7,7 @@ let hydrationPromise: Promise<void | Array<Array<void>>> | undefined export function RouterClient(props: { router: AnyRouter }) { if (!hydrationPromise) { - if (!props.router.stores.matchesId.state.length) { + if (!props.router.stores.matchesId.get().length) { hydrationPromise = hydrate(props.router) } else { hydrationPromise = Promise.resolve() diff --git a/packages/react-router/src/ssr/renderRouterToStream.tsx b/packages/react-router/src/ssr/renderRouterToStream.tsx index 3621bf667d..d42a22396a 100644 --- a/packages/react-router/src/ssr/renderRouterToStream.tsx +++ b/packages/react-router/src/ssr/renderRouterToStream.tsx @@ -2,6 +2,7 @@ import { PassThrough } from 'node:stream' import ReactDOMServer from 'react-dom/server' import { isbot } from 'isbot' import { + createSsrStreamResponse, transformPipeableStreamWithRouter, transformReadableStreamWithRouter, } from '@tanstack/router-core/ssr/server' @@ -9,6 +10,31 @@ import type { AnyRouter } from '@tanstack/router-core' import type { ReadableStream } from 'node:stream/web' import type { ReactNode } from 'react' +const noop = () => {} + +// Bot responses wait for `allReady` so crawlers receive complete HTML. +// If the request disconnects during that wait, React may not settle quickly; +// unblock the wait so the response pipeline can abort and clean up. +async function waitForReadyOrAbort( + ready: Promise<unknown>, + signal: AbortSignal, +) { + let cleanup = noop + try { + await Promise.race([ + ready, + new Promise<void>((resolve) => { + const onAbort = () => resolve() + cleanup = () => signal.removeEventListener('abort', onAbort) + signal.addEventListener('abort', onAbort, { once: true }) + if (signal.aborted) resolve() + }), + ]) + } finally { + cleanup() + } +} + export const renderRouterToStream = async ({ request, router, @@ -28,60 +54,142 @@ export const renderRouterToStream = async ({ }) if (isbot(request.headers.get('User-Agent'))) { - await stream.allReady + await waitForReadyOrAbort(stream.allReady, request.signal) } const responseStream = transformReadableStreamWithRouter( router, stream as unknown as ReadableStream, + { onAbort: () => stream.cancel().catch(() => {}) }, + ) + return createSsrStreamResponse( + router, + new Response(responseStream as any, { + status: router.stores.statusCode.get(), + headers: responseHeaders, + }), ) - return new Response(responseStream as any, { - status: router.stores.statusCode.state, - headers: responseHeaders, - }) } if (typeof ReactDOMServer.renderToPipeableStream === 'function') { const reactAppPassthrough = new PassThrough() + let pipeable: + | ReturnType<typeof ReactDOMServer.renderToPipeableStream> + | undefined + let responseAttached = false + let aborted = false + let endedBeforeAttach = false + let pendingAbortReason: unknown + const toError = (reason: unknown) => + reason instanceof Error + ? reason + : new Error(String(reason ?? 'SSR aborted')) + const destroyError = (reason: unknown) => + reason === undefined ? undefined : toError(reason) + const pendingDestroyError = () => + pendingAbortReason === undefined + ? toError(pendingAbortReason) + : destroyError(pendingAbortReason) + const finishPassThrough = ( + reason: unknown, + opts?: { defaultError?: boolean }, + ) => { + if (reactAppPassthrough.destroyed) return + if (responseAttached) { + reactAppPassthrough.destroy( + opts?.defaultError ? toError(reason) : destroyError(reason), + ) + } else { + endedBeforeAttach = true + // onError can fire synchronously before React returns the pipeable + // handle and before Readable.toWeb() is attached. Defer touching the + // PassThrough until after the router transform can observe the error. + } + } + const abortPipeable = ( + reason?: unknown, + opts?: { defaultError?: boolean }, + ) => { + if (aborted) return + aborted = true + pendingAbortReason = reason + const err = toError(reason) + try { + pipeable?.abort(err) + } catch { + // ignore — React may throw if already aborted/finished + } + finishPassThrough(reason, opts) + } + + // Register before attaching the router transform; the transform may + // synchronously cleanup/error, and cleanup must still remove this listener. + if (request.signal.aborted) { + abortPipeable(request.signal.reason) + } else { + const onRequestAbort = () => abortPipeable(request.signal.reason) + request.signal.addEventListener('abort', onRequestAbort, { once: true }) + router.serverSsr?.onCleanup(() => { + request.signal.removeEventListener('abort', onRequestAbort) + }) + } + try { - const pipeable = ReactDOMServer.renderToPipeableStream(children, { + pipeable = ReactDOMServer.renderToPipeableStream(children, { nonce: router.options.ssr?.nonce, progressiveChunkSize: Number.POSITIVE_INFINITY, ...(isbot(request.headers.get('User-Agent')) ? { onAllReady() { - pipeable.pipe(reactAppPassthrough) + pipeable!.pipe(reactAppPassthrough) }, } : { onShellReady() { - pipeable.pipe(reactAppPassthrough) + pipeable!.pipe(reactAppPassthrough) }, }), onError: (error, info) => { console.error('Error in renderToPipeableStream:', error, info) - // Destroy the passthrough stream on error - if (!reactAppPassthrough.destroyed) { - reactAppPassthrough.destroy( - error instanceof Error ? error : new Error(String(error)), - ) - } + abortPipeable(error, { defaultError: true }) }, }) } catch (e) { console.error('Error in renderToPipeableStream:', e) - reactAppPassthrough.destroy(e instanceof Error ? e : new Error(String(e))) + router.serverSsr?.cleanup() + throw e } const responseStream = transformPipeableStreamWithRouter( router, reactAppPassthrough, + { onAbort: abortPipeable }, + ) + responseAttached = true + + if (endedBeforeAttach) { + reactAppPassthrough.destroy(pendingDestroyError()) + } + + // React's onError may have fired synchronously inside + // renderToPipeableStream before `pipeable` was assigned. If so, + // abortPipeable ran without a pipeable handle; re-apply the abort now. + if (aborted && pipeable) { + try { + pipeable.abort(toError(pendingAbortReason)) + } catch { + // ignore — React may throw if already aborted/finished + } + } + + return createSsrStreamResponse( + router, + new Response(responseStream as any, { + status: router.stores.statusCode.get(), + headers: responseHeaders, + }), ) - return new Response(responseStream as any, { - status: router.stores.statusCode.state, - headers: responseHeaders, - }) } throw new Error( diff --git a/packages/react-router/src/ssr/renderRouterToString.tsx b/packages/react-router/src/ssr/renderRouterToString.tsx index 3b8131eaea..e9fe4ec779 100644 --- a/packages/react-router/src/ssr/renderRouterToString.tsx +++ b/packages/react-router/src/ssr/renderRouterToString.tsx @@ -21,7 +21,7 @@ export const renderRouterToString = async ({ } return new Response(`<!DOCTYPE html>${html}`, { - status: router.stores.statusCode.state, + status: router.stores.statusCode.get(), headers: responseHeaders, }) } catch (error) { diff --git a/packages/react-router/src/useBlocker.tsx b/packages/react-router/src/useBlocker.tsx index a40fe19b50..68612c97cb 100644 --- a/packages/react-router/src/useBlocker.tsx +++ b/packages/react-router/src/useBlocker.tsx @@ -1,3 +1,5 @@ +'use client' + import * as React from 'react' import { useRouter } from './useRouter' import type { diff --git a/packages/react-router/src/useCanGoBack.ts b/packages/react-router/src/useCanGoBack.ts index 602c1ae2f5..a20f947f43 100644 --- a/packages/react-router/src/useCanGoBack.ts +++ b/packages/react-router/src/useCanGoBack.ts @@ -6,7 +6,7 @@ export function useCanGoBack() { const router = useRouter() if (isServer ?? router.isServer) { - return router.stores.location.state.state.__TSR_index !== 0 + return router.stores.location.get().state.__TSR_index !== 0 } // eslint-disable-next-line react-hooks/rules-of-hooks -- condition is static diff --git a/packages/react-router/src/useLocation.tsx b/packages/react-router/src/useLocation.tsx index 3c366b36a8..f81bb43993 100644 --- a/packages/react-router/src/useLocation.tsx +++ b/packages/react-router/src/useLocation.tsx @@ -1,3 +1,5 @@ +'use client' + import { useStore } from '@tanstack/react-store' import { useRef } from 'react' import { replaceEqualDeep } from '@tanstack/router-core' @@ -52,7 +54,7 @@ export function useLocation< const router = useRouter<TRouter>() if (isServer ?? router.isServer) { - const location = router.stores.location.state + const location = router.stores.location.get() return ( opts?.select ? opts.select(location as any) : location ) as UseLocationResult<TRouter, TSelected> diff --git a/packages/react-router/src/useMatch.tsx b/packages/react-router/src/useMatch.tsx index 8048e24521..af2f971d5d 100644 --- a/packages/react-router/src/useMatch.tsx +++ b/packages/react-router/src/useMatch.tsx @@ -1,3 +1,5 @@ +'use client' + import * as React from 'react' import { useStore } from '@tanstack/react-store' import { invariant, replaceEqualDeep } from '@tanstack/router-core' @@ -19,9 +21,8 @@ import type { } from '@tanstack/router-core' const dummyStore = { - state: undefined, get: () => undefined, - subscribe: () => () => {}, + subscribe: () => ({ unsubscribe: () => {} }), } as any export interface UseMatchBaseOptions< @@ -112,12 +113,12 @@ export function useMatch< const key = opts.from ?? nearestMatchId const matchStore = key ? opts.from - ? router.stores.getMatchStoreByRouteId(key) - : router.stores.activeMatchStoresById.get(key) + ? router.stores.getRouteMatchStore(key) + : router.stores.matchStores.get(key) : undefined if (isServer ?? router.isServer) { - const match = matchStore?.state + const match = matchStore?.get() if ((opts.shouldThrow ?? true) && !match) { if (process.env.NODE_ENV !== 'production') { throw new Error( diff --git a/packages/react-router/src/useNavigate.tsx b/packages/react-router/src/useNavigate.tsx index f697d0fbdd..ce95e5b4c1 100644 --- a/packages/react-router/src/useNavigate.tsx +++ b/packages/react-router/src/useNavigate.tsx @@ -1,3 +1,5 @@ +'use client' + import * as React from 'react' import { useLayoutEffect } from './utils' import { useRouter } from './useRouter' diff --git a/packages/react-router/src/useRouter.tsx b/packages/react-router/src/useRouter.tsx index 51364f4e84..925cba411e 100644 --- a/packages/react-router/src/useRouter.tsx +++ b/packages/react-router/src/useRouter.tsx @@ -1,3 +1,5 @@ +'use client' + import * as React from 'react' import { routerContext } from './routerContext' import type { AnyRouter, RegisteredRouter } from '@tanstack/router-core' diff --git a/packages/react-router/src/useRouterState.tsx b/packages/react-router/src/useRouterState.tsx index 1d3ce690cb..62da6b3384 100644 --- a/packages/react-router/src/useRouterState.tsx +++ b/packages/react-router/src/useRouterState.tsx @@ -1,3 +1,5 @@ +'use client' + import { useStore } from '@tanstack/react-store' import { useRef } from 'react' import { replaceEqualDeep } from '@tanstack/router-core' @@ -57,7 +59,7 @@ export function useRouterState< // Avoid subscribing to the store (and any structural sharing work) on the server. const _isServer = isServer ?? router.isServer if (_isServer) { - const state = router.stores.__store.state as RouterState< + const state = router.stores.__store.get() as RouterState< TRouter['routeTree'] > return (opts?.select ? opts.select(state) : state) as UseRouterStateResult< diff --git a/packages/react-router/src/utils.ts b/packages/react-router/src/utils.ts index 33f8ea9acc..f3cbf54613 100644 --- a/packages/react-router/src/utils.ts +++ b/packages/react-router/src/utils.ts @@ -1,10 +1,12 @@ +'use client' import * as React from 'react' // Safe version of React.use() that will not cause compilation errors against // React 18 with Webpack, which statically analyzes imports and fails when it // sees React.use referenced (since 'use' is not exported from React 18). // This uses a dynamic string lookup to avoid the static analysis. -const REACT_USE = 'use' +// eslint-disable-next-line prefer-const -- Must be `let` to prevent bundler constant-folding +let REACT_USE = 'use' /** * React.use if available (React 19+), undefined otherwise. diff --git a/packages/react-router/tests/Matches.test-d.tsx b/packages/react-router/tests/Matches.test-d.tsx index 2116e78416..89e1088454 100644 --- a/packages/react-router/tests/Matches.test-d.tsx +++ b/packages/react-router/tests/Matches.test-d.tsx @@ -8,7 +8,8 @@ import { useMatchRoute, useMatches, } from '../src' -import type { AnyRouteMatch, RouteMatch } from '../src' +import type * as React from 'react' +import type { AnyRouteMatch, MakeMatchRouteOptions, RouteMatch } from '../src' const rootRoute = createRootRoute() @@ -233,3 +234,19 @@ test('when filtering useMatches by loaderData with an array', () => { matches.filter((match) => isMatch(match, 'loaderData.0.comment')), ).toEqualTypeOf<Array<CommentsMatch>>() }) + +test('MatchRoute children are typed from resolved params under pathless layouts', () => { + type CommentsMatchRouteChildren = MakeMatchRouteOptions< + DefaultRouter, + string, + '/comments/$id' + >['children'] + type CommentsMatchRouteRenderFn = Extract< + CommentsMatchRouteChildren, + (...args: Array<any>) => any + > + + expectTypeOf<CommentsMatchRouteRenderFn>().toEqualTypeOf< + (params?: { id: string } | undefined) => React.ReactNode + >() +}) diff --git a/packages/react-router/tests/Scripts.test.tsx b/packages/react-router/tests/Scripts.test.tsx index 0ca10b794a..b7605c9402 100644 --- a/packages/react-router/tests/Scripts.test.tsx +++ b/packages/react-router/tests/Scripts.test.tsx @@ -24,20 +24,23 @@ import { import { Scripts } from '../src/Scripts' import type { Manifest } from '@tanstack/router-core' -const createTestManifest = (routeId: string) => +// React 19 keeps stylesheet resources keyed by href alive for the lifetime of +// the test module, so these tests use explicit asset URLs to avoid collisions +// between cases even though Testing Library cleanup runs after each test. +const createTestManifest = ( + routeId: string, + options?: { + stylesheetHref?: string + preloadHref?: string + scriptFormat?: Manifest['scriptFormat'] + }, +) => ({ + ...(options?.scriptFormat ? { scriptFormat: options.scriptFormat } : {}), routes: { [routeId]: { - preloads: ['/main.js'], - assets: [ - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/main.css', - }, - }, - ], + preloads: [options?.preloadHref ?? '/main.js'], + css: [options?.stylesheetHref ?? '/main.css'], }, }, }) satisfies Manifest @@ -218,6 +221,65 @@ describe('scripts with async/defer attributes', () => { expect(html).toMatch(/<script[^>]*src="script2\.js"[^>]*defer=""/) }) + test('server keeps manifest src scripts in document order', async () => { + const clientEntryAsset = { + attrs: { + src: '/entry.js', + type: 'module', + async: true, + }, + } satisfies NonNullable<Manifest['routes'][string]['scripts']>[number] + + const rootRoute = createRootRoute({ + component: () => { + return ( + <html> + <head /> + <body> + <main data-testid="content">content</main> + <Outlet /> + <Scripts /> + </body> + </html> + ) + }, + }) + + const indexRoute = createRoute({ + path: '/', + getParentRoute: () => rootRoute, + }) + + const router = createRouter({ + history: createMemoryHistory({ + initialEntries: ['/'], + }), + routeTree: rootRoute.addChildren([indexRoute]), + isServer: true, + }) + router.ssr = { + manifest: { + routes: { + [rootRoute.id]: { + scripts: [clientEntryAsset], + }, + }, + }, + } + + await router.load() + + const html = ReactDOMServer.renderToString( + <RouterProvider router={router} />, + ) + const contentIndex = html.indexOf('<main data-testid="content">') + const scriptIndex = html.indexOf('src="/entry.js"') + + expect(contentIndex).toBeGreaterThan(-1) + expect(scriptIndex).toBeGreaterThan(contentIndex) + expect(html).not.toContain('client-entry') + }) + test('client renders scripts with attributes (including async/defer)', async () => { const rootRoute = createRootRoute({ scripts: () => [ @@ -373,6 +435,7 @@ describe('ssr HeadContent', () => { test('keeps manifest stylesheet links mounted when history state changes', async () => { const history = createTestBrowserHistory() + const stylesheetHref = '/history-state.css' const rootRoute = createRootRoute({ component: () => { @@ -408,7 +471,9 @@ describe('ssr HeadContent', () => { }) router.ssr = { - manifest: createTestManifest(rootRoute.id), + manifest: createTestManifest(rootRoute.id, { + stylesheetHref, + }), } await router.load() @@ -417,7 +482,7 @@ describe('ssr HeadContent', () => { const getStylesheetLink = () => Array.from(document.querySelectorAll('link[rel="stylesheet"]')).find( - (link) => link.getAttribute('href') === '/main.css', + (link) => link.getAttribute('href') === stylesheetHref, ) await waitFor(() => { @@ -438,13 +503,15 @@ describe('ssr HeadContent', () => { expect(getStylesheetLink()).toBe(initialLink) expect( Array.from(document.querySelectorAll('link[rel="stylesheet"]')).filter( - (link) => link.getAttribute('href') === '/main.css', + (link) => link.getAttribute('href') === stylesheetHref, ), ).toHaveLength(1) }) - test('applies assetCrossOrigin to manifest assets and preloads', async () => { + test('applies assetCrossOrigin to manifest stylesheets and preloads', async () => { const history = createTestBrowserHistory() + const stylesheetHref = '/asset-cross-origin.css' + const preloadHref = '/asset-cross-origin.js' const rootRoute = createRootRoute({ component: () => { @@ -453,7 +520,7 @@ describe('ssr HeadContent', () => { {createPortal( <HeadContent assetCrossOrigin={{ - modulepreload: 'anonymous', + script: 'anonymous', stylesheet: 'use-credentials', }} />, @@ -477,7 +544,10 @@ describe('ssr HeadContent', () => { }) router.ssr = { - manifest: createTestManifest(rootRoute.id), + manifest: createTestManifest(rootRoute.id, { + stylesheetHref, + preloadHref, + }), } await router.load() @@ -485,26 +555,138 @@ describe('ssr HeadContent', () => { await act(() => render(<RouterProvider router={router} />)) await waitFor(() => { - expect(document.head.querySelector('link[rel="stylesheet"]')).toBeTruthy() expect( - document.head.querySelector('link[rel="modulepreload"]'), + document.head.querySelector( + `link[rel="stylesheet"][href="${stylesheetHref}"]`, + ), + ).toBeTruthy() + expect( + document.head.querySelector( + `link[rel="modulepreload"][href="${preloadHref}"]`, + ), ).toBeTruthy() }) expect( document.head - .querySelector('link[rel="stylesheet"]') + .querySelector(`link[rel="stylesheet"][href="${stylesheetHref}"]`) ?.getAttribute('crossorigin'), ).toBe('use-credentials') expect( document.head - .querySelector('link[rel="modulepreload"]') + .querySelector(`link[rel="modulepreload"][href="${preloadHref}"]`) ?.getAttribute('crossorigin'), ).toBe('anonymous') }) + test('renders runtime manifest inlineStyle', async () => { + const history = createTestBrowserHistory() + + const rootRoute = createRootRoute({ + component: () => { + return ( + <> + {createPortal(<HeadContent />, document.head)} + <Outlet /> + </> + ) + }, + }) + + const indexRoute = createRoute({ + path: '/', + getParentRoute: () => rootRoute, + component: () => <div>Index</div>, + }) + + const router = createRouter({ + history, + routeTree: rootRoute.addChildren([indexRoute]), + }) + + router.ssr = { + manifest: { + inlineStyle: { + attrs: { id: 'runtime-inline-style' }, + children: '.runtime{color:red}', + }, + routes: { + [rootRoute.id]: {}, + }, + }, + } + + await router.load() + + await act(() => render(<RouterProvider router={router} />)) + + await waitFor(() => { + expect( + document.head.querySelector('style#runtime-inline-style'), + ).toBeTruthy() + }) + + expect( + document.head.querySelector('style#runtime-inline-style')?.textContent, + ).toBe('.runtime{color:red}') + }) + + test('renders preload as script links for iife manifest preloads', async () => { + const history = createTestBrowserHistory() + const preloadHref = '/iife-preload.js' + + const rootRoute = createRootRoute({ + component: () => { + return ( + <> + {createPortal(<HeadContent />, document.head)} + <Outlet /> + </> + ) + }, + }) + + const indexRoute = createRoute({ + path: '/', + getParentRoute: () => rootRoute, + component: () => <div>Index</div>, + }) + + const router = createRouter({ + history, + routeTree: rootRoute.addChildren([indexRoute]), + }) + + router.ssr = { + manifest: createTestManifest(rootRoute.id, { + preloadHref, + scriptFormat: 'iife', + }), + } + + await router.load() + + await act(() => render(<RouterProvider router={router} />)) + + await waitFor(() => { + expect( + document.head.querySelector( + `link[rel="preload"][as="script"][href="${preloadHref}"]`, + ), + ).toBeTruthy() + }) + + expect( + document.head.querySelector( + `link[rel="modulepreload"][href="${preloadHref}"]`, + ), + ).toBeFalsy() + }) + test('assetCrossOrigin overrides manifest crossOrigin values', async () => { const history = createTestBrowserHistory() + const stylesheetHref = '/override-cross-origin.css' + const preloadHref = '/override-cross-origin.js' const rootRoute = createRootRoute({ component: () => { @@ -536,16 +718,12 @@ describe('ssr HeadContent', () => { routes: { [rootRoute.id]: { preloads: [ - { href: '/main.js', crossOrigin: 'use-credentials' as const }, + { href: preloadHref, crossOrigin: 'use-credentials' as const }, ], - assets: [ + css: [ { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/main.css', - crossOrigin: 'use-credentials', - }, + href: stylesheetHref, + crossOrigin: 'use-credentials', }, ], }, @@ -558,26 +736,33 @@ describe('ssr HeadContent', () => { await act(() => render(<RouterProvider router={router} />)) await waitFor(() => { - expect(document.head.querySelector('link[rel="stylesheet"]')).toBeTruthy() expect( - document.head.querySelector('link[rel="modulepreload"]'), + document.head.querySelector( + `link[rel="stylesheet"][href="${stylesheetHref}"]`, + ), + ).toBeTruthy() + expect( + document.head.querySelector( + `link[rel="modulepreload"][href="${preloadHref}"]`, + ), ).toBeTruthy() }) expect( document.head - .querySelector('link[rel="stylesheet"]') + .querySelector(`link[rel="stylesheet"][href="${stylesheetHref}"]`) ?.getAttribute('crossorigin'), ).toBe('anonymous') expect( document.head - .querySelector('link[rel="modulepreload"]') + .querySelector(`link[rel="modulepreload"][href="${preloadHref}"]`) ?.getAttribute('crossorigin'), ).toBe('anonymous') }) test('keeps manifest stylesheet links mounted across repeated Link navigations', async () => { const history = createTestBrowserHistory() + const stylesheetHref = '/repeated-nav.css' const rootRoute = createRootRoute({ component: () => { @@ -608,7 +793,9 @@ describe('ssr HeadContent', () => { }) router.ssr = { - manifest: createTestManifest(rootRoute.id), + manifest: createTestManifest(rootRoute.id, { + stylesheetHref, + }), } await router.load() @@ -617,7 +804,7 @@ describe('ssr HeadContent', () => { const getStylesheetLink = () => Array.from(document.querySelectorAll('link[rel="stylesheet"]')).find( - (link) => link.getAttribute('href') === '/main.css', + (link) => link.getAttribute('href') === stylesheetHref, ) await waitFor(() => { @@ -648,7 +835,7 @@ describe('ssr HeadContent', () => { expect(getStylesheetLink()).toBe(initialLink) expect( Array.from(document.querySelectorAll('link[rel="stylesheet"]')).filter( - (link) => link.getAttribute('href') === '/main.css', + (link) => link.getAttribute('href') === stylesheetHref, ), ).toHaveLength(1) }) diff --git a/packages/react-router/tests/errorComponent.test.tsx b/packages/react-router/tests/errorComponent.test.tsx index 7835ca9e3a..0779c2e8c4 100644 --- a/packages/react-router/tests/errorComponent.test.tsx +++ b/packages/react-router/tests/errorComponent.test.tsx @@ -1,14 +1,18 @@ import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest' -import { cleanup, fireEvent, render, screen } from '@testing-library/react' +import { act, cleanup, fireEvent, render, screen } from '@testing-library/react' +import ReactDOMServer from 'react-dom/server' import { Link, + Outlet, RouterProvider, createBrowserHistory, createLazyRoute, + createMemoryHistory, createRootRoute, createRoute, createRouter, + notFound, } from '../src' import type { ErrorComponentProps, RouterHistory } from '../src' @@ -25,6 +29,10 @@ function throwFn() { throw new Error('error thrown') } +function primitiveThrowFn() { + throw 'primitive error thrown' +} + let history: RouterHistory beforeEach(() => { @@ -169,5 +177,267 @@ describe.each([true, false])( }) }, ) + + describe('stale route errors do not leak after navigation', () => { + test.each([ + { + caller: 'loader' as const, + routeOptions: { + loader: throwFn, + }, + }, + { + caller: 'render' as const, + routeOptions: { + component: function RenderErrorComponent() { + throwFn() + }, + }, + }, + ])( + 'navigating away from a $caller error does not call the next route errorComponent', + async ({ routeOptions }) => { + const rootRoute = createRootRoute() + const indexErrorComponent = vi.fn(() => <div>Index error</div>) + + const indexRoute = createRoute({ + getParentRoute: () => rootRoute, + path: '/', + component: function Home() { + return ( + <div> + <div>Index route content</div> + <Link to="/about">link to about</Link> + </div> + ) + }, + errorComponent: indexErrorComponent, + }) + + const aboutRoute = createRoute({ + getParentRoute: () => rootRoute, + path: '/about', + component: function About() { + return <div>About route content</div> + }, + errorComponent: isUsingLazyError ? undefined : MyErrorComponent, + ...routeOptions, + }) + + if (isUsingLazyError) { + aboutRoute.lazy(() => + Promise.resolve( + createLazyRoute('/about')({ + errorComponent: MyErrorComponent, + }), + ), + ) + } + + const routeTree = rootRoute.addChildren([indexRoute, aboutRoute]) + + const router = createRouter({ + routeTree, + history, + }) + + render(<RouterProvider router={router} />) + + const linkToAbout = await screen.findByRole('link', { + name: 'link to about', + }) + + await act(() => fireEvent.click(linkToAbout)) + + expect( + await screen.findByText('Error: error thrown', undefined, { + timeout: 1500, + }), + ).toBeInTheDocument() + + await act(() => router.navigate({ to: '/' })) + + expect( + await screen.findByText('Index route content'), + ).toBeInTheDocument() + expect(indexErrorComponent).not.toHaveBeenCalled() + }, + ) + }) }, ) + +test('errorComponent receives primitive errors thrown from beforeLoad', async () => { + const rootRoute = createRootRoute() + const indexRoute = createRoute({ + getParentRoute: () => rootRoute, + path: '/', + component: function Home() { + return ( + <div> + <Link to="/about">link to about</Link> + </div> + ) + }, + }) + const aboutRoute = createRoute({ + getParentRoute: () => rootRoute, + path: '/about', + beforeLoad: primitiveThrowFn, + component: function About() { + return <div>About route content</div> + }, + errorComponent: ({ error }) => <div>Error: {String(error)}</div>, + }) + + const routeTree = rootRoute.addChildren([indexRoute, aboutRoute]) + + const router = createRouter({ + routeTree, + history, + }) + + render(<RouterProvider router={router} />) + + const linkToAbout = await screen.findByRole('link', { + name: 'link to about', + }) + + await act(() => fireEvent.click(linkToAbout)) + + expect( + await screen.findByText('Error: primitive error thrown', undefined, { + timeout: 750, + }), + ).toBeInTheDocument() + expect(screen.queryByText('About route content')).not.toBeInTheDocument() +}) + +test('SSR errorComponent receives primitive errors thrown from beforeLoad', async () => { + const history = createMemoryHistory({ initialEntries: ['/about'] }) + const rootRoute = createRootRoute({ + component: function Root() { + return <Outlet /> + }, + }) + const aboutRoute = createRoute({ + getParentRoute: () => rootRoute, + path: '/about', + beforeLoad: primitiveThrowFn, + component: function About() { + return <div>About route content</div> + }, + errorComponent: ({ error }) => <div>Error: {String(error)}</div>, + }) + + const router = createRouter({ + routeTree: rootRoute.addChildren([aboutRoute]), + history, + }) + router.isServer = true + + await router.load() + + expect(router.state.statusCode).toBe(500) + const html = ReactDOMServer.renderToString(<RouterProvider router={router} />) + expect(html).toContain('Error:') + expect(html).toContain('primitive error thrown') +}) + +describe('notFoundComponent is rendered when an error is thrown in params.parse', () => { + test('displays notFoundComponent when error is thrown in params.parse', async () => { + const history = createMemoryHistory({ initialEntries: ['/'] }) + const rootLoader = vi.fn(async () => { + await new Promise((resolve) => setTimeout(resolve, 1)) + return { ok: true } + }) + + const rootRoute = createRootRoute({ + component: function Root() { + return <Outlet /> + }, + notFoundComponent: function NotFound() { + return <div>No pizza</div> + }, + pendingComponent: function Pending() { + return <div>Loading...</div> + }, + loader: rootLoader, + shouldReload: true, + pendingMs: 0, + pendingMinMs: 100, + wrapInSuspense: true, + }) + + const indexRoute = createRoute({ + getParentRoute: () => rootRoute, + path: '/', + component: function Home() { + return ( + <div> + <Link to="/pizza/rotten" preload="intent"> + link to rotten pizza + </Link> + </div> + ) + }, + }) + + const restaurantRoute = createRoute({ + getParentRoute: () => rootRoute, + id: 'restaurant', + component: function Restaurant() { + return <Outlet /> + }, + }) + + const pizzaRoute = createRoute({ + getParentRoute: () => restaurantRoute, + path: '/pizza/$pizzaType', + component: function Pizza() { + return <div>Pizza</div> + }, + params: { + parse: (p) => { + if (p.pizzaType === 'rotten') { + throw new Error('404 No rotten pizzas') + } + return { pizzaType: p.pizzaType } + }, + stringify: (p) => ({ pizzaType: p.pizzaType }), + }, + onError: () => { + throw notFound() + }, + }) + + const routeTree = rootRoute.addChildren([ + indexRoute, + restaurantRoute.addChildren([pizzaRoute]), + ]) + + const router = createRouter({ + routeTree, + history, + }) + + render(<RouterProvider router={router} />) + + await act(() => router.latestLoadPromise) + expect(rootLoader).toHaveBeenCalledTimes(1) + + const linkToRottenPizza = await screen.findByRole('link', { + name: 'link to rotten pizza', + }) + + expect(linkToRottenPizza).toBeInTheDocument() + await act(() => fireEvent.mouseOver(linkToRottenPizza)) + await act(() => fireEvent.click(linkToRottenPizza)) + + const notFoundComponent = await screen.findByText('No pizza', undefined, { + timeout: 750, + }) + expect(rootLoader).toHaveBeenCalledTimes(2) + expect(notFoundComponent).toBeInTheDocument() + }) +}) diff --git a/packages/react-router/tests/fileRoute.test-d.tsx b/packages/react-router/tests/fileRoute.test-d.tsx index c97d932325..cc0e7b265a 100644 --- a/packages/react-router/tests/fileRoute.test-d.tsx +++ b/packages/react-router/tests/fileRoute.test-d.tsx @@ -17,6 +17,31 @@ const postRoute = createFileRoute('/_postLayout/posts/$postId_')() const protectedRoute = createFileRoute('/(auth)/protected')() +const attachmentRoute = createFileRoute( + '/projects/$observationDocId/attachments/$driveId/$type/$variant/$name', +)({ + params: { + parse: ({ driveId, type, variant, name, ...rest }) => { + const blobId = + type === 'audio' + ? { + type: 'audio' as const, + variant: 'original' as const, + driveId, + name, + } + : { + type: 'photo' as const, + variant: variant as 'original' | 'preview' | 'thumbnail', + driveId, + name, + } + + return { ...rest, ...blobId } + }, + }, +}) + declare module '@tanstack/router-core' { interface FileRoutesByPath { '/': { @@ -68,6 +93,13 @@ declare module '@tanstack/router-core' { fullPath: '/posts/$postId' path: '/$postId_' } + '/projects/$observationDocId/attachments/$driveId/$type/$variant/$name': { + preLoaderRoute: typeof attachmentRoute + parentRoute: typeof rootRoute + id: '/projects/$observationDocId/attachments/$driveId/$type/$variant/$name' + fullPath: '/projects/$observationDocId/attachments/$driveId/$type/$variant/$name' + path: '/projects/$observationDocId/attachments/$driveId/$type/$variant/$name' + } } } @@ -100,3 +132,31 @@ test('when creating a folder group', () => { expectTypeOf<'(auth)/protected'>(protectedRoute.path) expectTypeOf<'/protected'>(protectedRoute.id) }) + +test('when file route params.parse returns a discriminated union', () => { + expectTypeOf(attachmentRoute.types.params).toEqualTypeOf< + | { + observationDocId: string + driveId: string + type: 'audio' + variant: 'original' + name: string + } + | { + observationDocId: string + driveId: string + type: 'photo' + variant: 'original' | 'preview' | 'thumbnail' + name: string + } + >() +}) + +test('when file route params.parse drops a path param', () => { + createFileRoute('/invoices/$invoiceId')({ + params: { + // @ts-expect-error parsed params must keep path param keys + parse: () => ({}), + }, + }) +}) diff --git a/packages/react-router/tests/lazy/normal.tsx b/packages/react-router/tests/lazy/normal.tsx index 1addf96c74..675deb83f3 100644 --- a/packages/react-router/tests/lazy/normal.tsx +++ b/packages/react-router/tests/lazy/normal.tsx @@ -2,7 +2,7 @@ import { createLazyFileRoute, createLazyRoute } from '../../src' export function Route(id: string) { return createLazyRoute(id)({ - component: () => <h1>I'm a normal route</h1>, + component: () => <h1 data-testid="lazy-route-page">I'm a normal route</h1>, }) } diff --git a/packages/react-router/tests/link.test.tsx b/packages/react-router/tests/link.test.tsx index 26cd07d988..f06a3a8dec 100644 --- a/packages/react-router/tests/link.test.tsx +++ b/packages/react-router/tests/link.test.tsx @@ -27,6 +27,7 @@ import { createRouteMask, createRouter, getRouteApi, + notFound, redirect, retainSearchParams, stripSearchParams, @@ -177,6 +178,96 @@ describe('Link', () => { ).rejects.toThrow() }) + test('does not forward internal Link props to the DOM', async () => { + const consoleErrorSpy = vi + .spyOn(console, 'error') + .mockImplementation(() => undefined) + const internalPropNames = [ + 'activeProps', + 'inactiveProps', + 'activeOptions', + 'to', + 'from', + 'preload', + 'preloadDelay', + 'preloadIntentProximity', + 'hashScrollIntoView', + 'replace', + 'startTransition', + 'resetScroll', + 'viewTransition', + 'ignoreBlocker', + 'params', + 'search', + 'hash', + 'state', + 'mask', + 'reloadDocument', + 'unsafeRelative', + ].map((propName) => propName.toLowerCase()) + + const rootRoute = createRootRoute() + const indexRoute = createRoute({ + getParentRoute: () => rootRoute, + path: '/', + component: () => ( + <Link + to="/posts" + from="/" + activeProps={{ className: 'active' }} + inactiveProps={{ className: 'inactive' }} + activeOptions={{ + exact: true, + includeHash: true, + includeSearch: true, + }} + preload="intent" + preloadDelay={50} + preloadIntentProximity={123} + hashScrollIntoView={true} + replace={true} + startTransition={true} + resetScroll={true} + viewTransition={true} + ignoreBlocker={true} + params={{}} + search={{ foo: 'bar' }} + hash="details" + state={{}} + mask={{ to: '/posts', hash: 'masked' }} + reloadDocument={true} + unsafeRelative="path" + > + Posts + </Link> + ), + }) + + const postsRoute = createRoute({ + getParentRoute: () => rootRoute, + path: '/posts', + component: () => <h1>Posts</h1>, + }) + + const router = createRouter({ + routeTree: rootRoute.addChildren([indexRoute, postsRoute]), + history, + }) + + render(<RouterProvider router={router} />) + + const postsLink = await screen.findByRole('link', { name: 'Posts' }) + const renderedAttributeNames = postsLink + .getAttributeNames() + .map((attributeName) => attributeName.toLowerCase()) + + for (const propName of internalPropNames) { + expect(renderedAttributeNames).not.toContain(propName) + } + + expect(consoleErrorSpy).not.toHaveBeenCalled() + }) + test('when the current route is the root', async () => { const rootRoute = createRootRoute() const indexRoute = createRoute({ @@ -1897,6 +1988,115 @@ describe('Link', () => { expect(notFoundComponent).not.toBeCalled() }) + test('404 thrown in child will bubble up to the root with beforeLoad', async () => { + const rootRoute = createRootRoute({ + notFoundComponent: () => <div>Root notFoundComponent</div>, + beforeLoad: () => ({ ok: true }), + }) + const indexRoute = createRoute({ + getParentRoute: () => rootRoute, + path: '/', + component: () => { + return ( + <> + <h1>Index</h1> + <Link to="/nonExistingPost">Non existing post</Link> + </> + ) + }, + }) + + const postRoute = createRoute({ + getParentRoute: () => rootRoute, + path: '$postId', + params: { + parse: (p) => { + if (p.postId === 'nonExistingPost') { + throw new Error('Post not exists') + } + return { + postId: p.postId, + } + }, + stringify: (p) => ({ postId: p.postId }), + }, + onError: () => { + throw notFound() + }, + component: () => <div>Existing Post</div>, + }) + + const router = createRouter({ + routeTree: rootRoute.addChildren([indexRoute, postRoute]), + }) + + render(<RouterProvider router={router} />) + + const postsLink = await screen.findByRole('link', { + name: 'Non existing post', + }) + await act(() => fireEvent.click(postsLink)) + + const errorText = await screen.findByText('Root notFoundComponent') + expect(errorText).toBeInTheDocument() + }) + + test('404 thrown in child will bubble up to the root with async loader', async () => { + const rootRoute = createRootRoute({ + notFoundComponent: () => <div>Root notFoundComponent</div>, + loader: async () => { + await sleep(0) + return { ok: true } + }, + }) + const indexRoute = createRoute({ + getParentRoute: () => rootRoute, + path: '/', + component: () => { + return ( + <> + <h1>Index</h1> + <Link to="/nonExistingPost">Non existing post</Link> + </> + ) + }, + }) + + const postRoute = createRoute({ + getParentRoute: () => rootRoute, + path: '$postId', + params: { + parse: (p) => { + if (p.postId === 'nonExistingPost') { + throw new Error('Post not exists') + } + return { + postId: p.postId, + } + }, + stringify: (p) => ({ postId: p.postId }), + }, + onError: () => { + throw notFound() + }, + component: () => <div>Existing Post</div>, + }) + + const router = createRouter({ + routeTree: rootRoute.addChildren([indexRoute, postRoute]), + }) + + render(<RouterProvider router={router} />) + + const postsLink = await screen.findByRole('link', { + name: 'Non existing post', + }) + await act(() => fireEvent.click(postsLink)) + + const errorText = await screen.findByText('Root notFoundComponent') + expect(errorText).toBeInTheDocument() + }) + test('when navigating to /posts with params', async () => { const rootRoute = createRootRoute() const indexRoute = createRoute({ diff --git a/packages/react-router/tests/redirect.test.tsx b/packages/react-router/tests/redirect.test.tsx index a391d02898..cc15f0da36 100644 --- a/packages/react-router/tests/redirect.test.tsx +++ b/packages/react-router/tests/redirect.test.tsx @@ -1,3 +1,4 @@ +import * as React from 'react' import { cleanup, configure, @@ -10,6 +11,7 @@ import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest' import { Link, + Outlet, RouterProvider, createBrowserHistory, createMemoryHistory, @@ -111,6 +113,52 @@ describe('redirect', () => { expect(nestedFooLoaderMock).toHaveBeenCalled() }) + test('when root `beforeLoad` redirects while root pendingComponent is showing and the target route is lazy', async () => { + let hasRedirected = false + const consoleError = vi + .spyOn(console, 'error') + .mockImplementation(() => {}) + + const rootRoute = createRootRoute({ + component: () => <Outlet />, + pendingMs: 0, + pendingComponent: () => <div data-testid="pending">loading</div>, + beforeLoad: async () => { + await sleep(WAIT_TIME) + if (!hasRedirected) { + hasRedirected = true + throw redirect({ to: '/posts' }) + } + }, + }) + + const indexRoute = createRoute({ + getParentRoute: () => rootRoute, + path: '/', + component: () => <div data-testid="index-page">Index page</div>, + }) + + const postsRoute = createRoute({ + getParentRoute: () => rootRoute, + path: '/posts', + }).lazy(() => import('./lazy/normal').then((d) => d.Route('/posts'))) + + const router = createRouter({ + routeTree: rootRoute.addChildren([indexRoute, postsRoute]), + history, + }) + + render(<RouterProvider router={router} />) + + // The lazy target route adds the async boundary that exposes the stale + // redirected-match render path this regression is guarding. + expect(await screen.findByTestId('lazy-route-page')).toBeInTheDocument() + expect(screen.queryByTestId('pending')).not.toBeInTheDocument() + expect(router.state.location.href).toBe('/posts') + expect(router.state.status).toBe('idle') + expect(consoleError).not.toHaveBeenCalled() + }) + test('when `redirect` is thrown in `loader`', async () => { const nestedLoaderMock = vi.fn() const nestedFooLoaderMock = vi.fn() diff --git a/packages/react-router/tests/renderRouterToStream.test.tsx b/packages/react-router/tests/renderRouterToStream.test.tsx new file mode 100644 index 0000000000..74e180a552 --- /dev/null +++ b/packages/react-router/tests/renderRouterToStream.test.tsx @@ -0,0 +1,234 @@ +import { afterEach, describe, expect, test, vi } from 'vitest' +import { attachRouterServerSsrUtils } from '@tanstack/router-core/ssr/server' +import { createMemoryHistory, createRootRoute, createRouter } from '../src' + +const reactDomServerMocks = vi.hoisted(() => ({ + renderToReadableStream: undefined as undefined | (() => unknown), + renderToPipeableStream: vi.fn(), +})) + +vi.mock('react-dom/server', () => ({ + default: reactDomServerMocks, + ...reactDomServerMocks, +})) + +const { renderRouterToStream } = await import('../src/ssr/renderRouterToStream') + +afterEach(() => { + reactDomServerMocks.renderToReadableStream = undefined + reactDomServerMocks.renderToPipeableStream.mockReset() + vi.restoreAllMocks() +}) + +async function buildRouter() { + const rootRoute = createRootRoute({ component: () => null }) + const router = createRouter({ + history: createMemoryHistory({ initialEntries: ['/'] }), + routeTree: rootRoute, + }) + router.isServer = true + attachRouterServerSsrUtils({ router, manifest: undefined }) + await router.load() + await router.serverSsr!.dehydrate() + return router +} + +async function expectBodyRejects(response: Response, message: string) { + const reader = response.body!.getReader() + await expect( + (async () => { + for (;;) { + const { done } = await reader.read() + if (done) return + } + })(), + ).rejects.toThrow(message) +} + +function unwrapResponse( + result: Awaited<ReturnType<typeof renderRouterToStream>>, +) { + return result.response +} + +describe('renderRouterToStream - pipeable sync errors', () => { + test('sync onError before pipeable is assigned still aborts pipeable', async () => { + const abort = vi.fn() + reactDomServerMocks.renderToPipeableStream.mockImplementationOnce( + (_children, opts) => { + opts.onError(new Error('sync-react-error'), { componentStack: '' }) + return { abort, pipe: vi.fn() } + }, + ) + + const router = await buildRouter() + const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {}) + try { + const response = unwrapResponse( + await renderRouterToStream({ + request: new Request('http://localhost/'), + router, + responseHeaders: new Headers(), + children: null, + }), + ) + + expect(abort).toHaveBeenCalledOnce() + await expectBodyRejects(response, 'sync-react-error') + } finally { + errorSpy.mockRestore() + router.serverSsr?.cleanup() + } + }) + + test('sync non-Error onError before pipeable assignment still errors body', async () => { + const abort = vi.fn() + reactDomServerMocks.renderToPipeableStream.mockImplementationOnce( + (_children, opts) => { + opts.onError('string-react-error', { componentStack: '' }) + return { abort, pipe: vi.fn() } + }, + ) + + const router = await buildRouter() + const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {}) + try { + const response = unwrapResponse( + await renderRouterToStream({ + request: new Request('http://localhost/'), + router, + responseHeaders: new Headers(), + children: null, + }), + ) + + expect(abort).toHaveBeenCalledOnce() + await expectBodyRejects(response, 'string-react-error') + } finally { + errorSpy.mockRestore() + router.serverSsr?.cleanup() + } + }) + + test('sync undefined onError before pipeable assignment still errors body', async () => { + const abort = vi.fn() + reactDomServerMocks.renderToPipeableStream.mockImplementationOnce( + (_children, opts) => { + opts.onError(undefined, { componentStack: '' }) + return { abort, pipe: vi.fn() } + }, + ) + + const router = await buildRouter() + const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {}) + try { + const response = unwrapResponse( + await renderRouterToStream({ + request: new Request('http://localhost/'), + router, + responseHeaders: new Headers(), + children: null, + }), + ) + + expect(abort).toHaveBeenCalledOnce() + await expectBodyRejects(response, 'SSR aborted') + } finally { + errorSpy.mockRestore() + router.serverSsr?.cleanup() + } + }) + + test('undefined onError after response attach errors body', async () => { + const abort = vi.fn() + let onError!: (error: unknown, info: unknown) => void + reactDomServerMocks.renderToPipeableStream.mockImplementationOnce( + (_children, opts) => { + onError = opts.onError + return { abort, pipe: vi.fn() } + }, + ) + + const router = await buildRouter() + const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {}) + try { + const response = unwrapResponse( + await renderRouterToStream({ + request: new Request('http://localhost/'), + router, + responseHeaders: new Headers(), + children: null, + }), + ) + + onError(undefined, { componentStack: '' }) + expect(abort).toHaveBeenCalledOnce() + await expectBodyRejects(response, 'SSR aborted') + } finally { + errorSpy.mockRestore() + router.serverSsr?.cleanup() + } + }) + + test('setup throw rejects instead of returning streamed 200', async () => { + const setupError = new Error('setup-boom') + reactDomServerMocks.renderToPipeableStream.mockImplementationOnce(() => { + throw setupError + }) + + const router = await buildRouter() + const cleanup = vi.spyOn(router.serverSsr!, 'cleanup') + const originalServerSsr = router.serverSsr! + const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {}) + try { + await expect( + renderRouterToStream({ + request: new Request('http://localhost/'), + router, + responseHeaders: new Headers(), + children: null, + }), + ).rejects.toThrow('setup-boom') + + expect(cleanup).toHaveBeenCalledOnce() + } finally { + errorSpy.mockRestore() + originalServerSsr.cleanup() + } + }) + + test('request abort aborts pipeable and errors body', async () => { + const abort = vi.fn() + reactDomServerMocks.renderToPipeableStream.mockImplementationOnce( + (_children, opts) => { + queueMicrotask(() => opts.onShellReady()) + return { abort, pipe: vi.fn() } + }, + ) + + const router = await buildRouter() + const controller = new AbortController() + try { + const response = unwrapResponse( + await renderRouterToStream({ + request: new Request('http://localhost/', { + signal: controller.signal, + }), + router, + responseHeaders: new Headers(), + children: null, + }), + ) + + controller.abort(new Error('request-gone')) + const terminated = await Promise.race<true | false>([ + expectBodyRejects(response, 'request-gone').then(() => true), + new Promise<false>((resolve) => setTimeout(() => resolve(false), 2000)), + ]) + expect(terminated).toBe(true) + expect(abort).toHaveBeenCalledOnce() + } finally { + router.serverSsr?.cleanup() + } + }) +}) diff --git a/packages/react-router/tests/router.test.tsx b/packages/react-router/tests/router.test.tsx index 99a6e36d53..cf3b1c11fe 100644 --- a/packages/react-router/tests/router.test.tsx +++ b/packages/react-router/tests/router.test.tsx @@ -1525,6 +1525,88 @@ describe('invalidate', () => { ).toBeInTheDocument() expect(screen.queryByTestId('loader-route')).not.toBeInTheDocument() }) + + it('does not render the route component while async loader notFound is waiting for later matches to settle', async () => { + const history = createMemoryHistory({ + initialEntries: ['/parent/child/grandchild'], + }) + + const createControlledPromise = () => { + let resolve!: () => void + const promise = new Promise<void>((r) => { + resolve = r + }) + + return { promise, resolve } + } + + const grandchildLoader = createControlledPromise() + + const rootRoute = createRootRoute({ + component: () => <Outlet />, + notFoundComponent: () => ( + <div data-testid="root-not-found">Root Not Found</div> + ), + }) + + const parentRoute = createRoute({ + getParentRoute: () => rootRoute, + path: '/parent', + component: () => <Outlet />, + notFoundComponent: () => ( + <div data-testid="parent-not-found">Parent Not Found</div> + ), + }) + + const childRoute = createRoute({ + getParentRoute: () => parentRoute, + path: '/child', + loader: async () => { + await Promise.resolve() + throw notFound() + }, + component: () => ( + <div data-testid="child-component"> + Child component should not render + </div> + ), + }) + + const grandchildRoute = createRoute({ + getParentRoute: () => childRoute, + path: '/grandchild', + loader: () => grandchildLoader.promise, + component: () => <div data-testid="grandchild-component">Grandchild</div>, + }) + + const router = createRouter({ + routeTree: rootRoute.addChildren([ + parentRoute.addChildren([childRoute.addChildren([grandchildRoute])]), + ]), + history, + defaultPendingMs: 0, + defaultPendingComponent: () => ( + <div data-testid="pending">Loading...</div> + ), + }) + + render(<RouterProvider router={router} />) + + await waitFor(() => { + expect(router.state.location.pathname).toBe('/parent/child/grandchild') + expect(router.state.matches[0]?.routeId).toBe(rootRoute.id) + expect(router.state.matches[1]?.routeId).toBe(parentRoute.id) + expect(router.state.matches[2]?.routeId).toBe(childRoute.id) + }) + + expect(screen.queryByTestId('child-component')).not.toBeInTheDocument() + expect(screen.queryByTestId('parent-not-found')).not.toBeInTheDocument() + + grandchildLoader.resolve() + + expect(await screen.findByTestId('parent-not-found')).toBeInTheDocument() + expect(screen.queryByTestId('child-component')).not.toBeInTheDocument() + }) }) describe('search params in URL', () => { diff --git a/packages/react-router/tests/useParams.test.tsx b/packages/react-router/tests/useParams.test.tsx index 22ac646cd8..19cf096ea0 100644 --- a/packages/react-router/tests/useParams.test.tsx +++ b/packages/react-router/tests/useParams.test.tsx @@ -189,7 +189,8 @@ test('useParams must return parsed result if applicable.', async () => { expect(window.location.pathname).toBe('/posts/category_first') expect(await screen.findByTestId('post-category-heading')).toBeInTheDocument() - expect(mockedfn).not.toHaveBeenCalled() + // Dev-only buildLocation roundtrip validation uses normal matching for links. + expect(mockedfn).toHaveBeenCalled() mockedfn.mockClear() await act(() => fireEvent.click(firstPostLink)) diff --git a/packages/react-router/vite.config.ts b/packages/react-router/vite.config.ts index f21400df28..0eb9e3c77e 100644 --- a/packages/react-router/vite.config.ts +++ b/packages/react-router/vite.config.ts @@ -28,6 +28,7 @@ export default mergeConfig( tsconfigPath: './tsconfig.build.json', entry: [ './src/index.tsx', + './src/index.rsc.ts', './src/index.dev.tsx', './src/ssr/client.ts', './src/ssr/server.ts', diff --git a/packages/react-start-client/CHANGELOG.md b/packages/react-start-client/CHANGELOG.md index 92ec8696fc..2fd556c6f9 100644 --- a/packages/react-start-client/CHANGELOG.md +++ b/packages/react-start-client/CHANGELOG.md @@ -1,5 +1,316 @@ # @tanstack/react-start-client +## 1.168.7 + +### Patch Changes + +- Updated dependencies [[`2f53749`](https://github.com/TanStack/router/commit/2f5374945e2138559a51464f45a5152eae67e1dd)]: + - @tanstack/router-core@1.171.8 + - @tanstack/react-router@1.170.10 + - @tanstack/start-client-core@1.170.6 + +## 1.168.6 + +### Patch Changes + +- Updated dependencies [[`d1997b6`](https://github.com/TanStack/router/commit/d1997b66d7c24c1d64772bb8bab5caf9c6d9cc48)]: + - @tanstack/react-router@1.170.9 + - @tanstack/router-core@1.171.7 + - @tanstack/start-client-core@1.170.5 + +## 1.168.5 + +### Patch Changes + +- [#7492](https://github.com/TanStack/router/pull/7492) [`71fb329`](https://github.com/TanStack/router/commit/71fb3297e93a126e1bcfd9eeb0626cc4b8df8dd8) - Avoid pulling the client hydration entry into root `@tanstack/react-start` and `@tanstack/solid-start` imports by re-exporting `Hydrate` from framework client Hydrate-only subpaths. + +## 1.168.4 + +### Patch Changes + +- Updated dependencies [[`a82cec6`](https://github.com/TanStack/router/commit/a82cec69474c366b36efdb3f43c4efe8311c485a)]: + - @tanstack/start-client-core@1.170.4 + +## 1.168.3 + +### Patch Changes + +- Updated dependencies [[`51a97a1`](https://github.com/TanStack/router/commit/51a97a167fb3ef1b8ca70fbb63db635158f43509)]: + - @tanstack/router-core@1.171.6 + - @tanstack/react-router@1.170.8 + - @tanstack/start-client-core@1.170.3 + +## 1.168.2 + +### Patch Changes + +- Updated dependencies [[`5268ba4`](https://github.com/TanStack/router/commit/5268ba4566233ea58880df85f167ad0401a93a46)]: + - @tanstack/router-core@1.171.5 + - @tanstack/react-router@1.170.7 + - @tanstack/start-client-core@1.170.2 + +## 1.168.1 + +### Patch Changes + +- Updated dependencies [[`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960), [`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960)]: + - @tanstack/router-core@1.171.4 + - @tanstack/react-router@1.170.6 + - @tanstack/start-client-core@1.170.1 + +## 1.168.0 + +### Minor Changes + +- Add deferred Hydrate boundary support for TanStack Start. ([#7362](https://github.com/TanStack/router/pull/7362)) + + Hydrate boundaries can now be code-split by the Start compiler, preload their generated client chunks, preserve server-rendered fallback HTML, and replay interaction-triggered events after hydration. The compiler integration now uses a Start-owned compiler plugin for Hydrate virtual modules across Vite and Rsbuild, with dev invalidation for generated virtual modules. + + Shared AST utilities used by the router code-splitter and Hydrate virtual modules were moved into `@tanstack/router-utils` so both pipelines can retain referenced top-level declarations, unwrap local exports, and let dead-code elimination remove unused route module code. + +### Patch Changes + +- Updated dependencies [[`5fa9e55`](https://github.com/TanStack/router/commit/5fa9e555f3a2edb5e45586623e6bcbfa7f7c7a6b)]: + - @tanstack/start-client-core@1.170.0 + - @tanstack/router-core@1.171.3 + - @tanstack/react-router@1.170.5 + +## 1.167.4 + +### Patch Changes + +- Updated dependencies [[`b60eb36`](https://github.com/TanStack/router/commit/b60eb36e59e8a468ee0742cbcf7f47aca1ff1c67)]: + - @tanstack/router-core@1.171.2 + - @tanstack/react-router@1.170.4 + - @tanstack/start-client-core@1.169.4 + +## 1.167.3 + +### Patch Changes + +- Updated dependencies [[`d9cf933`](https://github.com/TanStack/router/commit/d9cf9331b83fcbd2abfee75d839d862f9bb18e6b)]: + - @tanstack/router-core@1.171.1 + - @tanstack/react-router@1.170.3 + - @tanstack/start-client-core@1.169.3 + +## 1.167.2 + +### Patch Changes + +- Updated dependencies [[`d533f87`](https://github.com/TanStack/router/commit/d533f87976704098a40b48f160b37c28c8182806)]: + - @tanstack/router-core@1.171.0 + - @tanstack/react-router@1.170.2 + - @tanstack/start-client-core@1.169.2 + +## 1.167.1 + +### Patch Changes + +- Updated dependencies [[`2387a2e`](https://github.com/TanStack/router/commit/2387a2eea0683004cc400b9f71bed5944eb60110)]: + - @tanstack/router-core@1.170.1 + - @tanstack/react-router@1.170.1 + - @tanstack/start-client-core@1.169.1 + +## 1.167.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- Updated dependencies [[`b1c061a`](https://github.com/TanStack/router/commit/b1c061aff9185cdf5fdc08c0136382a9dce0302f), [`201e150`](https://github.com/TanStack/router/commit/201e150bd1412bae2faa9ce53f0fefcb7574ac14)]: + - @tanstack/router-core@1.170.0 + - @tanstack/react-router@1.170.0 + - @tanstack/start-client-core@1.169.0 + +## 1.166.48 + +### Patch Changes + +- Updated dependencies [[`35e88f0`](https://github.com/TanStack/router/commit/35e88f04996d71019a1868b7b06ecb4ddbc9df9e)]: + - @tanstack/router-core@1.169.2 + - @tanstack/start-client-core@1.168.2 + - @tanstack/react-router@1.169.2 + +## 1.166.47 + +### Patch Changes + +- Updated dependencies [[`4a1e63f`](https://github.com/TanStack/router/commit/4a1e63f1d1230b1ed8234609acad4639d8982c13)]: + - @tanstack/router-core@1.169.1 + - @tanstack/react-router@1.169.1 + - @tanstack/start-client-core@1.168.1 + +## 1.166.46 + +### Patch Changes + +- Updated dependencies [[`82b0613`](https://github.com/TanStack/router/commit/82b06132af776f74603ab27977cc277d6219a845)]: + - @tanstack/start-client-core@1.168.0 + +## 1.166.45 + +### Patch Changes + +- Updated dependencies [[`c992495`](https://github.com/TanStack/router/commit/c992495bf4010ff4c3597bb1f3b1ba02594e857e)]: + - @tanstack/router-core@1.169.0 + - @tanstack/react-router@1.169.0 + - @tanstack/start-client-core@1.167.22 + +## 1.166.44 + +### Patch Changes + +- Updated dependencies [[`b5c4183`](https://github.com/TanStack/router/commit/b5c4183ab8b44be8a75647b7f7b588ad7c146ece)]: + - @tanstack/router-core@1.168.18 + - @tanstack/react-router@1.168.26 + - @tanstack/start-client-core@1.167.21 + +## 1.166.43 + +### Patch Changes + +- Updated dependencies [[`493148b`](https://github.com/TanStack/router/commit/493148bc5378b7f9de1544d87f6aaa425c12eb34)]: + - @tanstack/router-core@1.168.17 + - @tanstack/react-router@1.168.25 + - @tanstack/start-client-core@1.167.20 + +## 1.166.42 + +### Patch Changes + +- Updated dependencies [[`8b97002`](https://github.com/TanStack/router/commit/8b97002af3f6d15204e60c55d3f5735b78bd7efe)]: + - @tanstack/start-client-core@1.167.19 + +## 1.166.41 + +### Patch Changes + +- Updated dependencies [[`4d864ee`](https://github.com/TanStack/router/commit/4d864eebbd184265eabb563d326ab409c93feb17)]: + - @tanstack/react-router@1.168.24 + - @tanstack/router-core@1.168.16 + - @tanstack/start-client-core@1.167.18 + +## 1.166.40 + +### Patch Changes + +- Updated dependencies [[`cd91cee`](https://github.com/TanStack/router/commit/cd91ceebb84b7b752b5ee09ac14e89ad2beb2259)]: + - @tanstack/react-router@1.168.23 + +## 1.166.39 + +### Patch Changes + +- Updated dependencies [[`e30814d`](https://github.com/TanStack/router/commit/e30814d949110ff25829de44d729ead47555940a)]: + - @tanstack/react-router@1.168.22 + +## 1.166.38 + +### Patch Changes + +- Updated dependencies [[`16f6892`](https://github.com/TanStack/router/commit/16f6892d6b7ceadf606677c5a40e743f29163aa6)]: + - @tanstack/router-core@1.168.15 + - @tanstack/react-router@1.168.21 + - @tanstack/start-client-core@1.167.17 + +## 1.166.37 + +### Patch Changes + +- Updated dependencies [[`c5ad329`](https://github.com/TanStack/router/commit/c5ad32936f6adcca0c56474677b73b212498443b)]: + - @tanstack/react-router@1.168.20 + +## 1.166.36 + +### Patch Changes + +- Updated dependencies [[`105d056`](https://github.com/TanStack/router/commit/105d05691a247779a63e7b688aa1207cce619339)]: + - @tanstack/react-router@1.168.19 + +## 1.166.35 + +### Patch Changes + +- Updated dependencies [[`0e2c900`](https://github.com/TanStack/router/commit/0e2c9003c18ae07c09969189c028f277ea562a7a)]: + - @tanstack/router-core@1.168.14 + - @tanstack/react-router@1.168.18 + - @tanstack/start-client-core@1.167.16 + +## 1.166.34 + +### Patch Changes + +- Updated dependencies [[`812792f`](https://github.com/TanStack/router/commit/812792fbda3caf97b300770855cf5641252f413b)]: + - @tanstack/router-core@1.168.13 + - @tanstack/react-router@1.168.17 + - @tanstack/start-client-core@1.167.15 + +## 1.166.33 + +### Patch Changes + +- Updated dependencies [[`8ec9ca9`](https://github.com/TanStack/router/commit/8ec9ca97b472779de878c2a6510f21deb24d386c)]: + - @tanstack/router-core@1.168.12 + - @tanstack/react-router@1.168.16 + - @tanstack/start-client-core@1.167.14 + +## 1.166.32 + +### Patch Changes + +- Updated dependencies [[`6355bb7`](https://github.com/TanStack/router/commit/6355bb75f7637ba77f06a923c18fdaf37720bb48)]: + - @tanstack/react-router@1.168.15 + - @tanstack/router-core@1.168.11 + - @tanstack/start-client-core@1.167.13 + +## 1.166.31 + +### Patch Changes + +- Updated dependencies [[`459057c`](https://github.com/TanStack/router/commit/459057cd2d90cff20d20e51d4964b0a8c950555e)]: + - @tanstack/start-client-core@1.167.12 + - @tanstack/react-router@1.168.14 + - @tanstack/router-core@1.168.10 + +## 1.166.30 + +### Patch Changes + +- fix publishing ([`f8ac427`](https://github.com/TanStack/router/commit/f8ac427000c3fec99225926e72f9f2fc7a37231f)) + +- Updated dependencies [[`f8ac427`](https://github.com/TanStack/router/commit/f8ac427000c3fec99225926e72f9f2fc7a37231f)]: + - @tanstack/start-client-core@1.167.11 + +## 1.166.29 + +### Patch Changes + +- Updated dependencies [[`540d221`](https://github.com/TanStack/router/commit/540d22100d33415a1ddc9eb193f6aeb8184da77f), [`70ec1da`](https://github.com/TanStack/router/commit/70ec1da1ed8aa252fae67716f69fe8520ecf91b0)]: + - @tanstack/react-router@1.168.13 + +## 1.166.28 + +### Patch Changes + +- Updated dependencies [[`b29d64d`](https://github.com/TanStack/router/commit/b29d64de0c400183114c12f82183f80e37d9ea5c)]: + - @tanstack/react-router@1.168.12 + +## 1.166.27 + +### Patch Changes + +- Updated dependencies [[`4b9ed6c`](https://github.com/TanStack/router/commit/4b9ed6c5cb5437df8607c605728c8338dd2eb02c)]: + - @tanstack/react-router@1.168.11 + +## 1.166.26 + +### Patch Changes + +- Updated dependencies [[`f7e9c5e`](https://github.com/TanStack/router/commit/f7e9c5e323793d1b28c96871819c265fd28ae397)]: + - @tanstack/start-client-core@1.167.10 + ## 1.166.25 ### Patch Changes diff --git a/packages/react-start-client/package.json b/packages/react-start-client/package.json index 4200496e91..41b7895302 100644 --- a/packages/react-start-client/package.json +++ b/packages/react-start-client/package.json @@ -1,6 +1,6 @@ { "name": "@tanstack/react-start-client", - "version": "1.166.25", + "version": "1.168.7", "description": "Modern and scalable routing for React applications", "author": "Tanner Linsley", "license": "MIT", @@ -48,6 +48,18 @@ "default": "./dist/esm/index.js" } }, + "./hydration": { + "import": { + "types": "./dist/esm/hydration.d.ts", + "default": "./dist/esm/hydration.js" + } + }, + "./Hydrate": { + "import": { + "types": "./dist/esm/Hydrate.d.ts", + "default": "./dist/esm/Hydrate.js" + } + }, "./package.json": "./package.json" }, "sideEffects": false, diff --git a/packages/react-start-client/src/GenericHydrate.tsx b/packages/react-start-client/src/GenericHydrate.tsx new file mode 100644 index 0000000000..e92042a0d7 --- /dev/null +++ b/packages/react-start-client/src/GenericHydrate.tsx @@ -0,0 +1,436 @@ +'use client' + +import * as React from 'react' + +import { reactUse, useHydrated, useLayoutEffect } from '@tanstack/react-router' +import { isServer } from '@tanstack/router-core/isServer' +import { + hydrateIdAttribute, + hydrateWhenAttribute, +} from '@tanstack/start-client-core/hydration/constants' +import { + createResolvedGate, + getFallbackHtml, + getOrCreateGate, + onGateResolve, + releaseGate, + runHydrationStrategyCleanup, + saveFallbackHtml, + waitForHydrationPrefetchStrategy, +} from '@tanstack/start-client-core/hydration/runtime' +import { listenForDelegatedHydrationIntent } from '@tanstack/start-client-core/hydration' +import type { + HydrationRuntimeContext, + HydrationStrategy, + HydrationWhen, +} from '@tanstack/start-client-core/hydration' +import type { HydrationGateRecord } from '@tanstack/start-client-core/hydration/runtime' +import type { HydrateProps, InternalHydrateProps } from './Hydrate' + +type Gate = HydrationGateRecord & { promise: Promise<void> } +type PrefetchController = { + abortController: AbortController + hydrationRequested: boolean + hydrationListeners: Set<() => void> + hydrationResolvePending: boolean + started: boolean + promise?: Promise<void> + cleanup?: () => void +} + +const dynamicType = 'dynamic' +const dynamicHydrateStrategy = { + _t: dynamicType, + _d: () => true, +} satisfies HydrationStrategy<typeof dynamicType, false> + +function shouldDeferHydration(strategy: HydrationStrategy) { + return strategy._d ? strategy._d() : strategy._t !== 'load' +} + +function useLatest<T>(value: T) { + const ref = React.useRef(value) + ref.current = value + return ref +} + +function useHydrationGate(props: InternalHydrateProps) { + const hydrated = useHydrated() + const reactId = React.useId() + const id = props.h ? `${props.h}${reactId}` : reactId + const when = props.when + const isDynamicHydrate = typeof when === 'function' + const dynamicHydrateStrategyRef = React.useRef<HydrationStrategy | undefined>( + undefined, + ) + if (isDynamicHydrate) { + dynamicHydrateStrategyRef.current ??= + // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition + (isServer ?? typeof window === 'undefined') + ? dynamicHydrateStrategy + : when() + } + const hydrateStrategy = isDynamicHydrate + ? dynamicHydrateStrategyRef.current! + : when + const markerHydrateType: HydrationWhen = isDynamicHydrate + ? dynamicType + : hydrateStrategy._t! + const [prefetchError, setPrefetchError] = React.useState<unknown>() + const latestRef = useLatest({ + prefetch: props.prefetch, + preload: props.p, + }) + const gateRef = React.useRef<HydrationGateRecord | undefined>(undefined) + const markerElementRef = React.useRef<HTMLDivElement | null>(null) + const shouldPreserveServerHTMLRef = React.useRef<boolean | undefined>( + undefined, + ) + const shouldDeferInitialHydrationRef = React.useRef<boolean | undefined>( + undefined, + ) + const didPrefetchRef = React.useRef(false) + const prefetchControllerRef = React.useRef<PrefetchController | undefined>( + undefined, + ) + + prefetchControllerRef.current ??= { + abortController: new AbortController(), + hydrationRequested: false, + hydrationListeners: new Set<() => void>(), + hydrationResolvePending: false, + started: false, + } + + shouldPreserveServerHTMLRef.current ??= + // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition + (isServer ?? typeof window === 'undefined') || !hydrated + shouldDeferInitialHydrationRef.current ??= + !hydrated && shouldDeferHydration(hydrateStrategy) + + if (!gateRef.current) { + gateRef.current = + // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition + (isServer ?? typeof window === 'undefined') + ? createResolvedGate(id, hydrateStrategy._t!) + : getOrCreateGate(id, hydrateStrategy._t!) + } + + gateRef.current.when = hydrateStrategy._t! + + if ( + // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition + !(isServer ?? typeof window === 'undefined') && + hydrateStrategy._t !== 'never' && + (!shouldDeferInitialHydrationRef.current || + !shouldDeferHydration(hydrateStrategy)) + ) { + gateRef.current.resolve() + } + + const markerRef = React.useCallback( + (element: HTMLDivElement | null) => { + markerElementRef.current = element + if (element) { + if ( + hydrateStrategy._t === 'never' && + !shouldPreserveServerHTMLRef.current + ) { + element.replaceChildren() + } + saveFallbackHtml(id, element) + } + }, + [hydrateStrategy._t, id], + ) + + React.useEffect(() => { + const gate = gateRef.current! + return () => { + const controller = prefetchControllerRef.current + controller?.abortController.abort() + controller?.cleanup?.() + controller?.hydrationListeners.clear() + releaseGate(gate) + } + }, []) + + React.useEffect(() => { + if ( + // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition + (isServer ?? typeof window === 'undefined') || + !latestRef.current.prefetch + ) { + return + } + + const controller = prefetchControllerRef.current! + if (controller.started) return + controller.started = true + + const onHydrate = (listener: () => void) => { + if (controller.hydrationRequested) { + listener() + return () => {} + } + + controller.hydrationListeners.add(listener) + return () => { + controller.hydrationListeners.delete(listener) + } + } + + const preload = () => latestRef.current.preload?.() ?? Promise.resolve() + const prefetchInput = latestRef.current.prefetch + + if (typeof prefetchInput === 'function') { + const promise = Promise.resolve() + .then(() => + prefetchInput({ + element: markerElementRef.current, + signal: controller.abortController.signal, + preload, + waitFor: (strategy) => + waitForHydrationPrefetchStrategy(strategy, { + element: markerElementRef.current, + signal: controller.abortController.signal, + onHydrate, + }), + }), + ) + .then(() => undefined) + + controller.promise = promise + promise.catch((error) => { + if (!controller.abortController.signal.aborted) { + setPrefetchError(error) + } + }) + return + } + + if (!latestRef.current.preload) return + + const prefetch = () => { + if (didPrefetchRef.current) return + didPrefetchRef.current = true + void preload() + } + + controller.cleanup = runHydrationStrategyCleanup( + prefetchInput._s?.({ + element: markerElementRef.current, + prefetch, + }), + ) + }, [hydrateStrategy, latestRef]) + + useLayoutEffect(() => { + const gate = gateRef.current! + if ( + !shouldDeferInitialHydrationRef.current || + hydrateStrategy._t === 'never' + ) { + return + } + + if (gate.resolved) { + return + } + + const cleanups: Array<() => void> = [] + let removeResolveListener = () => {} + let disposed = false + const resolveGate = gate.resolve + + const cleanup = () => { + if (disposed) return + disposed = true + if (gate.resolve === requestHydration) { + gate.resolve = resolveGate + } + removeResolveListener() + cleanups.forEach((fn) => fn()) + } + + const addCleanup = (fn: void | (() => void)) => { + if (!fn) return + if (disposed || gate.resolved) { + fn() + return + } + cleanups.push(fn) + } + + const requestHydration = () => { + const controller = prefetchControllerRef.current! + if (!controller.hydrationRequested) { + controller.hydrationRequested = true + controller.hydrationListeners.forEach((listener) => listener()) + controller.hydrationListeners.clear() + } + + if (!controller.promise) { + resolveGate() + return + } + if (controller.hydrationResolvePending) return + controller.hydrationResolvePending = true + + controller.promise.then( + () => resolveGate(), + (error) => { + if (!controller.abortController.signal.aborted) { + setPrefetchError(error) + } + }, + ) + } + + gate.resolve = requestHydration + removeResolveListener = onGateResolve(gate, cleanup) + + const context: HydrationRuntimeContext = { + element: markerElementRef.current, + gate, + } + addCleanup(runHydrationStrategyCleanup(hydrateStrategy._s?.(context))) + + if (hydrateStrategy._t !== 'interaction') { + addCleanup( + runHydrationStrategyCleanup( + markerElementRef.current + ? listenForDelegatedHydrationIntent( + markerElementRef.current, + context, + ) + : undefined, + ), + ) + } + + return cleanup + }, [hydrateStrategy, latestRef]) + + return { + gate: gateRef.current, + markerRef, + markerElementRef, + hydrateStrategy, + markerHydrateType, + prefetchError, + shouldPreserveServerHTML: shouldPreserveServerHTMLRef.current, + } +} + +function HydrationGate(props: { gate: Gate; children: React.ReactNode }) { + if ( + // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition + isServer ?? + typeof window === 'undefined' + ) { + return props.children as React.JSX.Element + } + + if (props.gate.resolved) { + return props.children as React.JSX.Element + } + + if (!reactUse) { + throw props.gate.promise + } + + reactUse(props.gate.promise) + + return props.children as React.JSX.Element +} + +function HydratedBoundary(props: { + id: string + onHydrated?: () => void + onStrategyHydrated?: (id: string) => void + children: React.ReactNode +}) { + const { id, onHydrated, onStrategyHydrated } = props + const didHydrateRef = React.useRef(false) + + React.useEffect(() => { + if (didHydrateRef.current) return + didHydrateRef.current = true + onHydrated?.() + onStrategyHydrated?.(id) + }, [id, onHydrated, onStrategyHydrated]) + + return props.children as React.JSX.Element +} + +export function GenericHydrate(props: HydrateProps): React.JSX.Element { + const internalProps = props as InternalHydrateProps + const { + gate, + hydrateStrategy, + markerHydrateType, + markerElementRef, + markerRef, + prefetchError, + shouldPreserveServerHTML, + } = useHydrationGate(internalProps) + if (prefetchError) throw prefetchError + + const fallback = shouldPreserveServerHTML + ? (() => { + const html = getFallbackHtml(gate.id) + return html ? ( + <div + style={{ display: 'contents' }} + dangerouslySetInnerHTML={{ __html: html }} + /> + ) : null + })() + : (props.fallback ?? null) + const markerAttributes = + markerHydrateType === dynamicType ? undefined : hydrateStrategy._a?.() + + const hydrateType = hydrateStrategy._t! + + if (hydrateType === 'never' && !shouldPreserveServerHTML) { + return ( + <div + ref={markerRef} + {...{ + [hydrateIdAttribute]: gate.id, + [hydrateWhenAttribute]: markerHydrateType, + ...markerAttributes, + }} + > + {props.fallback ?? null} + </div> + ) + } + + return ( + <div + ref={markerRef} + {...{ + [hydrateIdAttribute]: gate.id, + [hydrateWhenAttribute]: markerHydrateType, + ...markerAttributes, + }} + > + <React.Suspense fallback={fallback}> + <HydrationGate gate={gate}> + <HydratedBoundary + id={gate.id} + onHydrated={props.onHydrated} + onStrategyHydrated={(id) => { + markerElementRef.current?.removeAttribute(hydrateWhenAttribute) + hydrateStrategy._o?.(id) + }} + > + {props.children} + </HydratedBoundary> + </HydrationGate> + </React.Suspense> + </div> + ) +} diff --git a/packages/react-start-client/src/Hydrate.tsx b/packages/react-start-client/src/Hydrate.tsx new file mode 100644 index 0000000000..019730f3be --- /dev/null +++ b/packages/react-start-client/src/Hydrate.tsx @@ -0,0 +1,107 @@ +'use client' + +import * as React from 'react' + +import { isServer } from '@tanstack/router-core/isServer' +import type { + HydrationStrategy as CoreHydrationStrategy, + HydrationPrefetchFunction, + HydrationPrefetchStrategy, + HydrationWhen, +} from '@tanstack/start-client-core/hydration' + +export type { + HydrationInteractionEvent, + HydrationInteractionEvents, + HydrationPrefetchContext, + HydrationPrefetchFunction, + HydrationPrefetchStrategy, + HydrationPrefetchWaitReason, + HydrationWhen, +} from '@tanstack/start-client-core/hydration' + +export type ReactHydrationStrategy< + TWhen extends HydrationWhen = HydrationWhen, + TCanPrefetch extends boolean = boolean, +> = CoreHydrationStrategy<TWhen, TCanPrefetch> & { + _h: (this: ReactHydrationStrategy, props: HydrateProps) => React.JSX.Element +} + +export type HydrationStrategy< + TWhen extends HydrationWhen = HydrationWhen, + TCanPrefetch extends boolean = boolean, +> = ReactHydrationStrategy<TWhen, TCanPrefetch> + +export type HydrateWhen = + | ReactHydrationStrategy + | (() => ReactHydrationStrategy) + +type HydrateCommonOptions = { + when: HydrateWhen + fallback?: React.ReactNode + onHydrated?: () => void +} + +export type HydrateOptions = + | (HydrateCommonOptions & { + prefetch?: never + split?: boolean + }) + | (HydrateCommonOptions & { + prefetch: HydrationPrefetchStrategy + split?: true + }) + | (HydrateCommonOptions & { + prefetch: HydrationPrefetchFunction + split?: boolean + }) + +export type HydrateProps = HydrateOptions & { + children: React.ReactNode +} + +export type InternalHydrateProps = HydrateProps & { + h?: string + p?: () => Promise<void> +} + +const dynamicType = 'dynamic' +const hydrateIdAttribute = 'data-ts-hydrate-id' +const hydrateWhenAttribute = 'data-ts-hydrate-when' + +/* @__NO_SIDE_EFFECTS__ */ +function ServerDynamicHydrate(props: HydrateProps): React.JSX.Element { + const internalProps = props as InternalHydrateProps + const reactId = React.useId() + const id = internalProps.h ? `${internalProps.h}${reactId}` : reactId + + return ( + <div + {...{ + [hydrateIdAttribute]: id, + [hydrateWhenAttribute]: dynamicType, + }} + > + <React.Suspense fallback={props.fallback ?? null}> + {props.children} + </React.Suspense> + </div> + ) +} + +/* @__NO_SIDE_EFFECTS__ */ +export function Hydrate(props: HydrateProps): React.JSX.Element { + if (typeof props.when === 'function') { + if ( + // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition + isServer ?? + typeof window === 'undefined' + ) { + return <ServerDynamicHydrate {...props} /> + } + + return props.when()._h(props) + } + + return props.when._h(props) +} diff --git a/packages/react-start-client/src/hydration.ts b/packages/react-start-client/src/hydration.ts new file mode 100644 index 0000000000..fad458175c --- /dev/null +++ b/packages/react-start-client/src/hydration.ts @@ -0,0 +1,22 @@ +'use client' + +export { condition, interaction, media } from './hydration/generic' +export { idle } from './hydration/idle' +export { load } from './hydration/load' +export { never } from './hydration/never' +export { visible } from './hydration/visible' +export type { + HydrationCondition, + HydrationInteractionEvent, + HydrationInteractionEvents, + IdleHydrationOptions, + HydrationPrefetchContext, + HydrationPrefetchFunction, + HydrationPrefetchWhen, + HydrationPrefetchStrategy, + HydrationPrefetchWaitReason, + HydrationStrategyTypes, + HydrationWhen, + VisibleHydrationOptions, +} from '@tanstack/start-client-core/hydration' +export type { HydrationStrategy, ReactHydrationStrategy } from './Hydrate' diff --git a/packages/react-start-client/src/hydration/generic.ts b/packages/react-start-client/src/hydration/generic.ts new file mode 100644 index 0000000000..5ee6d3c3d6 --- /dev/null +++ b/packages/react-start-client/src/hydration/generic.ts @@ -0,0 +1,43 @@ +'use client' + +import { + condition as coreCondition, + interaction as coreInteraction, + media as coreMedia, + withHydrationRenderer, +} from '@tanstack/start-client-core/hydration' +import { GenericHydrate } from '../GenericHydrate' +import type { + HydrationCondition, + HydrationInteractionEvents, + HydrationPrefetchStrategy, +} from '@tanstack/start-client-core/hydration' +import type { ReactHydrationStrategy } from '../Hydrate' + +/* @__NO_SIDE_EFFECTS__ */ +export function media( + query: string, +): ReactHydrationStrategy<'media', true> & HydrationPrefetchStrategy<'media'> { + return /* @__PURE__ */ withHydrationRenderer(coreMedia(query), GenericHydrate) +} + +/* @__NO_SIDE_EFFECTS__ */ +export function condition( + condition: HydrationCondition, +): ReactHydrationStrategy<'condition', false> { + return /* @__PURE__ */ withHydrationRenderer( + coreCondition(condition), + GenericHydrate, + ) +} + +/* @__NO_SIDE_EFFECTS__ */ +export function interaction(options?: { + events?: HydrationInteractionEvents +}): ReactHydrationStrategy<'interaction', true> & + HydrationPrefetchStrategy<'interaction'> { + return /* @__PURE__ */ withHydrationRenderer( + coreInteraction(options), + GenericHydrate, + ) +} diff --git a/packages/react-start-client/src/hydration/idle.ts b/packages/react-start-client/src/hydration/idle.ts new file mode 100644 index 0000000000..58c7f265eb --- /dev/null +++ b/packages/react-start-client/src/hydration/idle.ts @@ -0,0 +1,22 @@ +'use client' + +import { + idle as coreIdle, + withHydrationRenderer, +} from '@tanstack/start-client-core/hydration' +import { GenericHydrate } from '../GenericHydrate' +import type { + HydrationPrefetchStrategy, + IdleHydrationOptions, +} from '@tanstack/start-client-core/hydration' +import type { ReactHydrationStrategy } from '../Hydrate' + +/* @__NO_SIDE_EFFECTS__ */ +export function idle( + options: IdleHydrationOptions = {}, +): ReactHydrationStrategy<'idle', true> & HydrationPrefetchStrategy<'idle'> { + return /* @__PURE__ */ withHydrationRenderer( + coreIdle(options), + GenericHydrate, + ) +} diff --git a/packages/react-start-client/src/hydration/load.tsx b/packages/react-start-client/src/hydration/load.tsx new file mode 100644 index 0000000000..006f4e6952 --- /dev/null +++ b/packages/react-start-client/src/hydration/load.tsx @@ -0,0 +1,49 @@ +'use client' + +import * as React from 'react' + +import { + load as coreLoad, + withHydrationRenderer, +} from '@tanstack/start-client-core/hydration' +import type { HydrationPrefetchStrategy } from '@tanstack/start-client-core/hydration' +import type { HydrateProps, ReactHydrationStrategy } from '../Hydrate' + +function HydratedBoundary(props: { + onHydrated?: () => void + children: React.ReactNode +}) { + const { onHydrated, children } = props + const didHydrateRef = React.useRef(false) + + React.useEffect(() => { + if (didHydrateRef.current) return + didHydrateRef.current = true + onHydrated?.() + }, [onHydrated]) + + return children as React.JSX.Element +} + +export function LoadHydrate(props: HydrateProps): React.JSX.Element { + return ( + <div> + <React.Suspense fallback={props.fallback ?? null}> + <HydratedBoundary onHydrated={props.onHydrated}> + {props.children} + </HydratedBoundary> + </React.Suspense> + </div> + ) +} + +const loadStrategy = /* @__PURE__ */ withHydrationRenderer( + coreLoad(), + LoadHydrate, +) as ReactHydrationStrategy<'load', true> & HydrationPrefetchStrategy<'load'> + +/* @__NO_SIDE_EFFECTS__ */ +export function load(): ReactHydrationStrategy<'load', true> & + HydrationPrefetchStrategy<'load'> { + return loadStrategy +} diff --git a/packages/react-start-client/src/hydration/never.tsx b/packages/react-start-client/src/hydration/never.tsx new file mode 100644 index 0000000000..250a8ed1ae --- /dev/null +++ b/packages/react-start-client/src/hydration/never.tsx @@ -0,0 +1,97 @@ +'use client' + +import * as React from 'react' + +import { reactUse, useHydrated } from '@tanstack/react-router' +import { isServer } from '@tanstack/router-core/isServer' +import { + never as coreNever, + withHydrationRenderer, +} from '@tanstack/start-client-core/hydration' +import { + hydrateIdAttribute, + hydrateWhenAttribute, +} from '@tanstack/start-client-core/hydration/constants' +import { + getFallbackHtml, + saveFallbackHtml, +} from '@tanstack/start-client-core/hydration/runtime' +import type { + HydrateProps, + InternalHydrateProps, + ReactHydrationStrategy, +} from '../Hydrate' + +const neverType = 'never' +const neverPromise = new Promise<void>(() => {}) + +function NeverGate(props: { children: React.ReactNode }) { + if ( + // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition + isServer ?? + typeof window === 'undefined' + ) { + return props.children as React.JSX.Element + } + + if (!reactUse) { + throw neverPromise + } + + reactUse(neverPromise) + + return props.children as React.JSX.Element +} + +export function NeverHydrate(props: HydrateProps): React.JSX.Element { + const internalProps = props as InternalHydrateProps + const hydrated = useHydrated() + const reactId = React.useId() + const id = internalProps.h ? `${internalProps.h}${reactId}` : reactId + const shouldPreserveServerHTMLRef = React.useRef<boolean | undefined>( + undefined, + ) + shouldPreserveServerHTMLRef.current ??= + // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition + (isServer ?? typeof window === 'undefined') || !hydrated + const markerRef = React.useCallback( + (element: HTMLDivElement | null) => { + if (!element) return + if (!shouldPreserveServerHTMLRef.current) { + element.replaceChildren() + } else { + saveFallbackHtml(id, element) + } + }, + [id], + ) + const markerProps = { + ref: markerRef, + [hydrateIdAttribute]: id, + [hydrateWhenAttribute]: neverType, + } + const fallback = (() => { + const html = getFallbackHtml(id) + return html ? ( + <div + style={{ display: 'contents' }} + dangerouslySetInnerHTML={{ __html: html }} + /> + ) : ( + (props.fallback ?? null) + ) + })() + + return ( + <div {...markerProps}> + <React.Suspense fallback={fallback}> + <NeverGate>{props.children}</NeverGate> + </React.Suspense> + </div> + ) +} + +/* @__NO_SIDE_EFFECTS__ */ +export function never(): ReactHydrationStrategy<'never', false> { + return /* @__PURE__ */ withHydrationRenderer(coreNever(), NeverHydrate) +} diff --git a/packages/react-start-client/src/hydration/visible.tsx b/packages/react-start-client/src/hydration/visible.tsx new file mode 100644 index 0000000000..e274285cb8 --- /dev/null +++ b/packages/react-start-client/src/hydration/visible.tsx @@ -0,0 +1,139 @@ +'use client' + +import * as React from 'react' + +import { reactUse } from '@tanstack/react-router' +import { isServer } from '@tanstack/router-core/isServer' +import type { + HydrationPrefetchStrategy, + VisibleHydrationOptions, +} from '@tanstack/start-client-core/hydration' +import type { + HydrateProps, + InternalHydrateProps, + ReactHydrationStrategy, +} from '../Hydrate' + +type VisibleGate = { + p: Promise<void> + r: boolean + s: () => void +} + +/* @__NO_SIDE_EFFECTS__ */ +function HydrationBoundary(props: { + g: VisibleGate + o?: () => void + children?: React.ReactNode +}) { + const { g, o } = props + + if (!g.r) { + if (!reactUse) { + throw g.p + } + + reactUse(g.p) + } + + React.useEffect(() => { + o?.() + }, [o]) + + return props.children as React.JSX.Element +} + +/* @__NO_SIDE_EFFECTS__ */ +export function VisibleHydrate( + this: ReactHydrationStrategy, + props: HydrateProps, +): React.JSX.Element { + const strategy = this as ReactHydrationStrategy<'visible', true> + const prefetchStrategy = props.prefetch + const preload = (props as InternalHydrateProps).p + const markerRef = React.useRef<HTMLDivElement | null>(null) + const [gate] = React.useState<VisibleGate>(() => { + let resolvePromise!: () => void + const nextGate: VisibleGate = { + p: new Promise<void>((resolve) => { + resolvePromise = resolve + }), + r: false, + s: () => { + nextGate.r = true + resolvePromise() + }, + } + if ( + // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition + isServer ?? + typeof window === 'undefined' + ) { + nextGate.s() + } + + return nextGate + }) + + React.useEffect(() => { + if (!preload || typeof prefetchStrategy === 'function') { + return + } + + return prefetchStrategy?._s?.({ + element: markerRef.current, + prefetch: preload, + }) + }, [prefetchStrategy, preload]) + + React.useEffect(() => { + if (gate.r) return + + return strategy._s?.({ + element: markerRef.current, + gate: gate as never, + }) + }, [gate, strategy]) + + return ( + <div ref={markerRef}> + <React.Suspense fallback={props.fallback}> + <HydrationBoundary g={gate} o={props.onHydrated}> + {props.children} + </HydrationBoundary> + </React.Suspense> + </div> + ) +} + +/* @__NO_SIDE_EFFECTS__ */ +export function visible( + options?: VisibleHydrationOptions, +): ReactHydrationStrategy<'visible', true> & + HydrationPrefetchStrategy<'visible'> { + const rootMargin = options?.rootMargin ?? '600px' + const threshold = options?.threshold ?? 0 + + return { + _s: ({ element, gate, prefetch }) => { + const callback = prefetch || (gate as never as VisibleGate).s + + if (!element) { + callback() + return + } + + const observer = new IntersectionObserver( + (entries) => { + if (!entries[0]!.isIntersecting) return + observer.disconnect() + callback() + }, + { rootMargin, threshold }, + ) + observer.observe(element) + return () => observer.disconnect() + }, + _h: VisibleHydrate, + } +} diff --git a/packages/react-start-client/src/index.tsx b/packages/react-start-client/src/index.tsx index 6c8a836f08..26e7195c39 100644 --- a/packages/react-start-client/src/index.tsx +++ b/packages/react-start-client/src/index.tsx @@ -1,3 +1,4 @@ +'use client' + export { StartClient } from './StartClient' -export { renderRsc } from './renderRSC' export { hydrateStart } from './hydrateStart' diff --git a/packages/react-start-client/src/renderRSC.tsx b/packages/react-start-client/src/renderRSC.tsx deleted file mode 100644 index bc8482fc53..0000000000 --- a/packages/react-start-client/src/renderRSC.tsx +++ /dev/null @@ -1,93 +0,0 @@ -// TODO: RSCs -import { isValidElement } from 'react' -import { invariant } from '@tanstack/router-core' -import type React from 'react' - -export function renderRsc(input: any): React.JSX.Element { - if (isValidElement(input)) { - return input - } - - if (typeof input === 'object' && !input.state) { - input.state = { - status: 'pending', - promise: Promise.resolve() - .then(() => { - let element - - // We're in node - // TODO: RSCs - // if (reactDom.createFromNodeStream) { - // const stream = await import('node:stream') - - // let body: any = input - - // // Unwrap the response - // if (input instanceof Response) { - // body = input.body - // } - - // // Convert ReadableStream to NodeJS stream.Readable - // if (body instanceof ReadableStream) { - // body = stream.Readable.fromWeb(body as any) - // } - - // if (stream.Readable.isReadable(body)) { - // // body = copyStreamToRaw(body) - // } else if (input.text) { - // // create a readable stream by awaiting the text method - // body = new stream.Readable({ - // async read() { - // input.text().then((value: any) => { - // this.push(value) - // this.push(null) - // }) - // }, - // }) - // } else { - // console.error('input', input) - // throw new Error('Unexpected rsc input type 👆') - // } - - // element = await reactDom.createFromNodeStream(body) - // } else { - // // We're in the browser - // if (input.body instanceof ReadableStream) { - // input = input.body - // } - - // if (input instanceof ReadableStream) { - // element = await reactDom.createFromReadableStream(input) - // } - - // if (input instanceof Response) { - // // copy to the response body to cache the raw data - // element = await reactDom.createFromFetch(input) - // } - // } - - // return element - - if (process.env.NODE_ENV !== 'production') { - throw new Error('Invariant failed: renderRSC() is coming soon!') - } - - invariant() - }) - .then((element) => { - input.state.value = element - input.state.status = 'success' - }) - .catch((err) => { - input.state.status = 'error' - input.state.error = err - }), - } - } - - if (input.state.status === 'pending') { - throw input.state.promise - } - - return input.state.value -} diff --git a/packages/react-start-client/src/tests/Hydrate.test-d.tsx b/packages/react-start-client/src/tests/Hydrate.test-d.tsx new file mode 100644 index 0000000000..2e3726edfa --- /dev/null +++ b/packages/react-start-client/src/tests/Hydrate.test-d.tsx @@ -0,0 +1,147 @@ +import { expectTypeOf, test } from 'vitest' +import { visible } from '../hydration' +import { Hydrate } from '../Hydrate' +import type { + HydrateOptions, + HydrateProps, + HydrationPrefetchFunction, + HydrationPrefetchStrategy, + HydrationStrategy, +} from '../Hydrate' +import type { HydrationStrategy as CoreHydrationStrategy } from '@tanstack/start-client-core/hydration' +import type { ReactNode } from 'react' + +type CommonHydrateProps = { + fallback?: ReactNode + onHydrated?: () => void + children: ReactNode +} + +type SplitHydrateProps = CommonHydrateProps & { + when: HydrationStrategy | (() => HydrationStrategy) + prefetch?: never + split?: boolean +} + +type PrefetchHydrateProps = CommonHydrateProps & { + when: HydrationStrategy | (() => HydrationStrategy) + prefetch: HydrationPrefetchStrategy + split?: true +} + +type FunctionPrefetchHydrateProps = CommonHydrateProps & { + when: HydrationStrategy | (() => HydrationStrategy) + prefetch: HydrationPrefetchFunction + split?: boolean +} + +test('Hydrate component accepts the public HydrateProps type', () => { + expectTypeOf(Hydrate).toBeFunction() + expectTypeOf(Hydrate).parameter(0).branded.toEqualTypeOf<HydrateProps>() +}) + +test('HydrateOptions supports reusable spread props', () => { + const belowFoldProps = { + when: () => visible({ rootMargin: '800px' }), + } satisfies HydrateOptions + + expectTypeOf(belowFoldProps).toMatchTypeOf<HydrateOptions>() + + const withFunctionPrefetch = { + when: visible(), + split: false, + prefetch: (ctx) => { + expectTypeOf(ctx.element).toEqualTypeOf<Element | null>() + expectTypeOf(ctx.signal).toEqualTypeOf<AbortSignal>() + expectTypeOf(ctx.preload).returns.toEqualTypeOf<Promise<void>>() + expectTypeOf(ctx.waitFor).returns.toEqualTypeOf< + Promise<'prefetch' | 'hydrate' | 'abort'> + >() + }, + } satisfies HydrateOptions + + expectTypeOf(withFunctionPrefetch).toMatchTypeOf<HydrateOptions>() +}) + +test('Hydrate props are exact for strategy and prefetch forms', () => { + expectTypeOf< + Extract<HydrateProps, { prefetch?: never }> + >().branded.toEqualTypeOf<SplitHydrateProps>() + expectTypeOf< + Extract<HydrateProps, { prefetch: HydrationPrefetchStrategy }> + >().branded.toEqualTypeOf<PrefetchHydrateProps>() + expectTypeOf< + Extract<HydrateProps, { prefetch: HydrationPrefetchFunction }> + >().branded.toEqualTypeOf<FunctionPrefetchHydrateProps>() +}) + +test('Hydrate requires a strategy', () => { + expectTypeOf<{ + when: HydrationStrategy + children: ReactNode + }>().toMatchTypeOf<HydrateProps>() + + expectTypeOf<{ + when: () => HydrationStrategy + children: ReactNode + }>().toMatchTypeOf<HydrateProps>() + + expectTypeOf<{ + children: ReactNode + }>().not.toMatchTypeOf<HydrateProps>() + + expectTypeOf<{ + when: () => true + children: ReactNode + }>().not.toMatchTypeOf<HydrateProps>() + + expectTypeOf<{ + when: false + children: ReactNode + }>().not.toMatchTypeOf<HydrateProps>() +}) + +test('Hydrate requires a framework-renderable strategy', () => { + expectTypeOf<CoreHydrationStrategy>().not.toMatchTypeOf<HydrationStrategy>() + expectTypeOf<ReturnType<typeof visible>>().toMatchTypeOf<HydrationStrategy>() + + expectTypeOf<{ + when: CoreHydrationStrategy + children: ReactNode + }>().not.toMatchTypeOf<HydrateProps>() +}) + +test('Hydrate enforces prefetch only with split boundaries', () => { + expectTypeOf<{ + when: HydrationStrategy + prefetch: HydrationPrefetchStrategy + children: ReactNode + }>().toMatchTypeOf<HydrateProps>() + + expectTypeOf<{ + when: HydrationStrategy + prefetch: HydrationPrefetchStrategy + split: true + children: ReactNode + }>().toMatchTypeOf<HydrateProps>() + + expectTypeOf<{ + when: HydrationStrategy + prefetch: HydrationPrefetchStrategy + split: false + children: ReactNode + }>().not.toMatchTypeOf<HydrateProps>() + + expectTypeOf<{ + when: HydrationStrategy + prefetch: HydrationPrefetchFunction + split: false + children: ReactNode + }>().toMatchTypeOf<HydrateProps>() + + expectTypeOf<{ + when: HydrationStrategy + prefetch: HydrationPrefetchFunction + children: ReactNode + }>().toMatchTypeOf<HydrateProps>() +}) diff --git a/packages/react-start-client/src/tests/Hydrate.test.tsx b/packages/react-start-client/src/tests/Hydrate.test.tsx new file mode 100644 index 0000000000..0d0ce1faad --- /dev/null +++ b/packages/react-start-client/src/tests/Hydrate.test.tsx @@ -0,0 +1,676 @@ +import * as React from 'react' +import { renderToString } from 'react-dom/server' +import { hydrateRoot } from 'react-dom/client' +import { + act, + cleanup, + fireEvent, + render, + screen, + waitFor, +} from '@testing-library/react' +import { afterEach, describe, expect, it, vi } from 'vitest' +import { hydrateIdAttribute } from '@tanstack/start-client-core/hydration/constants' +import { Hydrate } from '../Hydrate' +import { condition, idle, interaction, load, never } from '../hydration' +import type { HydrateProps, HydrationPrefetchStrategy } from '../Hydrate' + +const InternalHydrate = Hydrate as React.ComponentType< + HydrateProps & { p?: () => Promise<void>; h?: string } +> + +const hydrateIdSelector = `[${hydrateIdAttribute}]` + +function getMarker() { + const marker = document.querySelector(hydrateIdSelector) + + if (!marker) { + throw new Error('Expected Hydrate marker to exist') + } + + return marker +} + +function InteractiveChild() { + const [count, setCount] = React.useState(0) + const [hydrated, setHydrated] = React.useState(false) + + React.useEffect(() => { + setHydrated(true) + }, []) + + return ( + <button + data-testid="child" + data-hydrated={hydrated ? 'true' : 'false'} + onClick={() => setCount((prev) => prev + 1)} + > + {count} + </button> + ) +} + +function NamedInteractiveChild(props: { id: string }) { + const [hydrated, setHydrated] = React.useState(false) + + React.useEffect(() => { + setHydrated(true) + }, []) + + return ( + <button + data-testid={`child-${props.id}`} + data-hydrated={hydrated ? 'true' : 'false'} + > + {props.id} + </button> + ) +} + +function createSuspendingChild() { + let resolve!: () => void + let resolved = false + const promise = new Promise<void>((resolvePromise) => { + resolve = () => { + resolved = true + resolvePromise() + } + }) + + function SuspendingChild() { + if (!resolved) { + throw promise + } + + return <div data-testid="child">child</div> + } + + return { resolve, SuspendingChild } +} + +async function expectNoHydrationAfterDefaultIntentEvents() { + const marker = getMarker() + + expect(screen.getByTestId('child').getAttribute('data-hydrated')).toBe( + 'false', + ) + + await act(async () => { + fireEvent.pointerEnter(marker) + fireEvent.focusIn(marker) + fireEvent.pointerDown(marker) + fireEvent.click(marker) + await new Promise((resolve) => setTimeout(resolve, 20)) + }) + + expect(screen.getByTestId('child').getAttribute('data-hydrated')).toBe( + 'false', + ) +} + +async function fireIntent(event: () => void) { + await act(async () => { + event() + await Promise.resolve() + }) +} + +async function renderAsync(ui: React.ReactElement) { + await act(async () => { + render(ui) + await Promise.resolve() + }) +} + +async function hydrateFromServer(ui: React.ReactElement) { + vi.stubGlobal('window', undefined) + const html = renderToString(ui) + vi.unstubAllGlobals() + + const container = document.createElement('div') + document.body.append(container) + container.innerHTML = html + + let root!: ReturnType<typeof hydrateRoot> + await act(async () => { + root = hydrateRoot(container, ui) + await Promise.resolve() + }) + + return { container, html, root } +} + +async function unmountHydratedRoot( + root: ReturnType<typeof hydrateRoot>, + container: Element, +) { + await act(async () => { + root.unmount() + }) + container.remove() +} + +afterEach(() => { + cleanup() + vi.unstubAllGlobals() +}) + +describe('Hydrate', () => { + it('uses a single custom interaction event instead of the default intent events', async () => { + const { container, html, root } = await hydrateFromServer( + <Hydrate + when={interaction({ events: 'dblclick' })} + fallback={<div data-testid="fallback">fallback</div>} + > + <InteractiveChild /> + </Hydrate>, + ) + + try { + expect(html).toContain('data-testid="child"') + expect(html).not.toContain('data-testid="fallback"') + expect(screen.queryByTestId('fallback')).toBeNull() + await expectNoHydrationAfterDefaultIntentEvents() + + await fireIntent(() => + getMarker().dispatchEvent( + new MouseEvent('dblclick', { bubbles: true, cancelable: true }), + ), + ) + + await waitFor(() => + expect(screen.getByTestId('child').getAttribute('data-hydrated')).toBe( + 'true', + ), + ) + } finally { + await unmountHydratedRoot(root, container) + } + }) + + it('uses every event in a custom interaction event list', async () => { + const { container, root } = await hydrateFromServer( + <Hydrate + when={interaction({ events: ['contextmenu', 'dblclick'] })} + fallback={<div data-testid="fallback">fallback</div>} + > + <InteractiveChild /> + </Hydrate>, + ) + + try { + expect(screen.queryByTestId('fallback')).toBeNull() + await expectNoHydrationAfterDefaultIntentEvents() + + await fireIntent(() => + getMarker().dispatchEvent( + new MouseEvent('contextmenu', { bubbles: true, cancelable: true }), + ), + ) + + await waitFor(() => + expect(screen.getByTestId('child').getAttribute('data-hydrated')).toBe( + 'true', + ), + ) + } finally { + await unmountHydratedRoot(root, container) + } + }) + + it('omits never content when mounted after the app is already hydrated', async () => { + await renderAsync( + <Hydrate when={never()}> + <InteractiveChild /> + </Hydrate>, + ) + + expect(screen.queryByTestId('child')).toBeNull() + }) + + it('shows fallback for a client-only mount while children suspend', async () => { + const { resolve, SuspendingChild } = createSuspendingChild() + + await renderAsync( + <Hydrate + when={load()} + fallback={<div data-testid="fallback">fallback</div>} + > + <SuspendingChild /> + </Hydrate>, + ) + + expect(screen.getByTestId('fallback').textContent).toBe('fallback') + expect(screen.queryByTestId('child')).toBeNull() + + await act(async () => { + resolve() + await Promise.resolve() + }) + + await screen.findByTestId('child') + expect(screen.queryByTestId('fallback')).toBeNull() + }) + + it('does not use fallback for an initial never boundary', async () => { + const { container, html, root } = await hydrateFromServer( + <Hydrate + when={never()} + fallback={<div data-testid="fallback">fallback</div>} + > + <InteractiveChild /> + </Hydrate>, + ) + + try { + expect(html).toContain('data-testid="child"') + expect(html).not.toContain('data-testid="fallback"') + expect(screen.queryByTestId('fallback')).toBeNull() + + fireEvent.click(screen.getByTestId('child')) + await new Promise((resolve) => setTimeout(resolve, 20)) + expect(screen.getByTestId('child').getAttribute('data-hydrated')).toBe( + 'false', + ) + expect(screen.getByTestId('child').textContent).toBe('0') + } finally { + await unmountHydratedRoot(root, container) + } + }) + + it('keeps repeated split boundaries independently gated', async () => { + const { container, root } = await hydrateFromServer( + <> + <InternalHydrate when={interaction()} h="shared-boundary"> + <NamedInteractiveChild id="one" /> + </InternalHydrate> + <InternalHydrate when={interaction()} h="shared-boundary"> + <NamedInteractiveChild id="two" /> + </InternalHydrate> + </>, + ) + + try { + const markers = container.querySelectorAll(hydrateIdSelector) + + expect(markers).toHaveLength(2) + expect(markers[0]!.getAttribute(hydrateIdAttribute)).not.toBe( + markers[1]!.getAttribute(hydrateIdAttribute), + ) + expect( + screen.getByTestId('child-one').getAttribute('data-hydrated'), + ).toBe('false') + expect( + screen.getByTestId('child-two').getAttribute('data-hydrated'), + ).toBe('false') + + await fireIntent(() => + markers[0]!.dispatchEvent( + new MouseEvent('click', { bubbles: true, cancelable: true }), + ), + ) + + await waitFor(() => + expect( + screen.getByTestId('child-one').getAttribute('data-hydrated'), + ).toBe('true'), + ) + expect( + screen.getByTestId('child-two').getAttribute('data-hydrated'), + ).toBe('false') + } finally { + await unmountHydratedRoot(root, container) + } + }) + + it('fires onHydrated once after the client hydration commit', async () => { + const onHydrated = vi.fn() + const app = ( + <Hydrate when={load()} onHydrated={onHydrated}> + <div data-testid="child">child</div> + </Hydrate> + ) + + vi.stubGlobal('window', undefined) + const html = renderToString(app) + expect(html).toContain('child') + expect(onHydrated).not.toHaveBeenCalled() + vi.unstubAllGlobals() + + const container = document.createElement('div') + document.body.append(container) + container.innerHTML = html + + let root!: ReturnType<typeof hydrateRoot> + await act(async () => { + root = hydrateRoot(container, app) + }) + + await waitFor(() => expect(onHydrated).toHaveBeenCalledTimes(1)) + + fireEvent.click(screen.getByTestId('child')) + await new Promise((resolve) => setTimeout(resolve, 20)) + expect(onHydrated).toHaveBeenCalledTimes(1) + + await act(async () => { + root.unmount() + }) + container.remove() + }) + + it('prefetches split children without hydrating the boundary', async () => { + const preload = vi.fn(() => Promise.resolve()) + + const { container, root } = await hydrateFromServer( + <InternalHydrate + when={interaction()} + prefetch={idle({ timeout: 1 })} + p={preload} + > + <InteractiveChild /> + </InternalHydrate>, + ) + + try { + await waitFor(() => expect(preload).toHaveBeenCalledTimes(1)) + expect(screen.getByTestId('child').getAttribute('data-hydrated')).toBe( + 'false', + ) + + await fireIntent(() => + getMarker().dispatchEvent( + new MouseEvent('click', { bubbles: true, cancelable: true }), + ), + ) + + await waitFor(() => + expect(screen.getByTestId('child').getAttribute('data-hydrated')).toBe( + 'true', + ), + ) + expect(preload).toHaveBeenCalledTimes(1) + } finally { + await unmountHydratedRoot(root, container) + } + }) + + it('does not evaluate dynamic when callbacks on the server', async () => { + const when = vi.fn(() => interaction({ events: 'dblclick' })) + + vi.stubGlobal('window', undefined) + const html = renderToString( + <Hydrate when={when}> + <InteractiveChild /> + </Hydrate>, + ) + vi.unstubAllGlobals() + + expect(when).not.toHaveBeenCalled() + expect(html).toContain('data-ts-hydrate-when="dynamic"') + + const container = document.createElement('div') + document.body.append(container) + container.innerHTML = html + + let root!: ReturnType<typeof hydrateRoot> + try { + await act(async () => { + root = hydrateRoot( + container, + <Hydrate when={when}> + <InteractiveChild /> + </Hydrate>, + ) + await Promise.resolve() + }) + + expect(when).toHaveBeenCalled() + await expectNoHydrationAfterDefaultIntentEvents() + + await fireIntent(() => + getMarker().dispatchEvent( + new MouseEvent('dblclick', { bubbles: true, cancelable: true }), + ), + ) + + await waitFor(() => + expect(screen.getByTestId('child').getAttribute('data-hydrated')).toBe( + 'true', + ), + ) + } finally { + await unmountHydratedRoot(root, container) + } + }) + + it('replays an interaction captured before the Hydrate component hydrates', async () => { + const when = () => interaction({ events: 'click' }) + + vi.stubGlobal('window', undefined) + const html = renderToString( + <Hydrate when={when}> + <InteractiveChild /> + </Hydrate>, + ) + vi.unstubAllGlobals() + + const container = document.createElement('div') + document.body.append(container) + container.innerHTML = html + + const button = container.querySelector('[data-testid="child"]') + if (!button) { + throw new Error('Expected server-rendered child button') + } + + button.dispatchEvent( + new MouseEvent('click', { bubbles: true, cancelable: true }), + ) + + let root!: ReturnType<typeof hydrateRoot> + try { + await act(async () => { + root = hydrateRoot( + container, + <Hydrate when={when}> + <InteractiveChild /> + </Hydrate>, + ) + await Promise.resolve() + }) + + await waitFor(() => + expect(screen.getByTestId('child').getAttribute('data-hydrated')).toBe( + 'true', + ), + ) + await waitFor(() => + expect(screen.getByTestId('child').textContent).toBe('1'), + ) + } finally { + await unmountHydratedRoot(root, container) + } + }) + + it('blocks hydration on awaited procedural prefetch work', async () => { + const preload = vi.fn(() => Promise.resolve()) + let resolvePrefetch!: () => void + const prefetchBlocker = new Promise<void>((resolve) => { + resolvePrefetch = resolve + }) + const waitReasons: Array<string> = [] + const neverPrefetches = { + _t: 'idle', + _s: () => () => {}, + } as HydrationPrefetchStrategy<'idle'> + + const { container, root } = await hydrateFromServer( + <InternalHydrate + when={interaction()} + prefetch={async ({ waitFor, preload }) => { + waitReasons.push(await waitFor(neverPrefetches)) + await preload() + await prefetchBlocker + }} + p={preload} + > + <InteractiveChild /> + </InternalHydrate>, + ) + + try { + await fireIntent(() => + getMarker().dispatchEvent( + new MouseEvent('click', { bubbles: true, cancelable: true }), + ), + ) + + await waitFor(() => expect(waitReasons).toEqual(['hydrate'])) + expect(preload).toHaveBeenCalledTimes(1) + expect(screen.getByTestId('child').getAttribute('data-hydrated')).toBe( + 'false', + ) + + await act(async () => { + resolvePrefetch() + await prefetchBlocker + await Promise.resolve() + }) + + await waitFor(() => + expect(screen.getByTestId('child').getAttribute('data-hydrated')).toBe( + 'true', + ), + ) + } finally { + await unmountHydratedRoot(root, container) + } + }) + + it('hydrates when a condition strategy changes after the initial render', async () => { + function ConditionHarness() { + const [ready, setReady] = React.useState(false) + + return ( + <> + <button data-testid="ready" onClick={() => setReady(true)}> + ready + </button> + <Hydrate when={condition(ready)}> + <InteractiveChild /> + </Hydrate> + </> + ) + } + + const { container, root } = await hydrateFromServer(<ConditionHarness />) + + try { + expect(screen.getByTestId('child').getAttribute('data-hydrated')).toBe( + 'false', + ) + + await act(async () => { + fireEvent.click(screen.getByTestId('ready')) + await Promise.resolve() + }) + + await waitFor(() => + expect(screen.getByTestId('child').getAttribute('data-hydrated')).toBe( + 'true', + ), + ) + } finally { + await unmountHydratedRoot(root, container) + } + }) + + it('does not block hydration on fire-and-forget procedural prefetch work', async () => { + let resolvePrefetch!: () => void + const prefetchBlocker = new Promise<void>((resolve) => { + resolvePrefetch = resolve + }) + + const { container, root } = await hydrateFromServer( + <InternalHydrate + when={interaction()} + prefetch={() => { + void prefetchBlocker + }} + > + <InteractiveChild /> + </InternalHydrate>, + ) + + try { + await fireIntent(() => + getMarker().dispatchEvent( + new MouseEvent('click', { bubbles: true, cancelable: true }), + ), + ) + + await waitFor(() => + expect(screen.getByTestId('child').getAttribute('data-hydrated')).toBe( + 'true', + ), + ) + + await act(async () => { + resolvePrefetch() + await prefetchBlocker + }) + } finally { + await unmountHydratedRoot(root, container) + } + }) + + it('aborts procedural prefetch when the boundary unmounts', async () => { + const signals: Array<AbortSignal> = [] + + const { container, root } = await hydrateFromServer( + <InternalHydrate + when={interaction()} + prefetch={({ signal }) => { + signals.push(signal) + return new Promise<void>(() => {}) + }} + > + <InteractiveChild /> + </InternalHydrate>, + ) + + expect(signals).toHaveLength(1) + expect(signals[0]!.aborted).toBe(false) + + await unmountHydratedRoot(root, container) + expect(signals[0]!.aborted).toBe(true) + }) + + it('delegates nested interaction boundaries at runtime', async () => { + const { container, root } = await hydrateFromServer( + <Hydrate when={idle({ timeout: 1000 })}> + <Hydrate when={interaction()}> + <InteractiveChild /> + </Hydrate> + </Hydrate>, + ) + + try { + expect(screen.getByTestId('child').getAttribute('data-hydrated')).toBe( + 'false', + ) + + await fireIntent(() => { + fireEvent.click(screen.getByTestId('child')) + }) + + await waitFor(() => + expect(screen.getByTestId('child').getAttribute('data-hydrated')).toBe( + 'true', + ), + ) + } finally { + await unmountHydratedRoot(root, container) + } + }) +}) diff --git a/packages/react-start-client/src/tests/createServerFn.test-d.tsx b/packages/react-start-client/src/tests/createServerFn.test-d.tsx index e7d8c7be08..b020676956 100644 --- a/packages/react-start-client/src/tests/createServerFn.test-d.tsx +++ b/packages/react-start-client/src/tests/createServerFn.test-d.tsx @@ -24,7 +24,9 @@ test('createServerFn returns async array', () => { return result }) - expectTypeOf(serverFn()).toEqualTypeOf<Promise<Array<{ a: number }>>>() + expectTypeOf<ReturnType<typeof serverFn>>().toEqualTypeOf< + Promise<Array<{ a: number }>> + >() }) test('createServerFn returns sync array', () => { @@ -33,7 +35,9 @@ test('createServerFn returns sync array', () => { return result }) - expectTypeOf(serverFn()).toEqualTypeOf<Promise<Array<{ a: number }>>>() + expectTypeOf<ReturnType<typeof serverFn>>().toEqualTypeOf< + Promise<Array<{ a: number }>> + >() }) test('createServerFn returns async union', () => { @@ -42,7 +46,9 @@ test('createServerFn returns async union', () => { return result }) - expectTypeOf(serverFn()).toEqualTypeOf<Promise<string | number>>() + expectTypeOf<ReturnType<typeof serverFn>>().toEqualTypeOf< + Promise<string | number> + >() }) test('createServerFn returns sync union', () => { @@ -51,5 +57,7 @@ test('createServerFn returns sync union', () => { return result }) - expectTypeOf(serverFn()).toEqualTypeOf<Promise<string | number>>() + expectTypeOf<ReturnType<typeof serverFn>>().toEqualTypeOf< + Promise<string | number> + >() }) diff --git a/packages/react-start-client/vite.config.ts b/packages/react-start-client/vite.config.ts index 32119eee3a..19e0d79d19 100644 --- a/packages/react-start-client/vite.config.ts +++ b/packages/react-start-client/vite.config.ts @@ -20,7 +20,7 @@ export default mergeConfig( tanstackViteConfig({ tsconfigPath: './tsconfig.build.json', srcDir: './src', - entry: './src/index.tsx', + entry: ['./src/index.tsx', './src/Hydrate.tsx', './src/hydration.ts'], cjs: false, }), ) diff --git a/packages/react-start-rsc/CHANGELOG.md b/packages/react-start-rsc/CHANGELOG.md new file mode 100644 index 0000000000..51de6b22d8 --- /dev/null +++ b/packages/react-start-rsc/CHANGELOG.md @@ -0,0 +1,618 @@ +# @tanstack/react-start-rsc + +## 0.1.17 + +### Patch Changes + +- [#7509](https://github.com/TanStack/router/pull/7509) [`9cb7a00`](https://github.com/TanStack/router/commit/9cb7a003e6e5fa3706711870c7b10a5266356e3b) - feat(rsbuild): add RSC support + +- Updated dependencies [[`9cb7a00`](https://github.com/TanStack/router/commit/9cb7a003e6e5fa3706711870c7b10a5266356e3b)]: + - @tanstack/start-plugin-core@1.171.10 + - @tanstack/start-server-core@1.169.8 + - @tanstack/react-start-server@1.167.13 + +## 0.1.16 + +### Patch Changes + +- Updated dependencies [[`2f53749`](https://github.com/TanStack/router/commit/2f5374945e2138559a51464f45a5152eae67e1dd)]: + - @tanstack/router-core@1.171.8 + - @tanstack/react-router@1.170.10 + - @tanstack/react-start-server@1.167.12 + - @tanstack/start-client-core@1.170.6 + - @tanstack/start-plugin-core@1.171.9 + - @tanstack/start-server-core@1.169.7 + - @tanstack/start-storage-context@1.167.10 + +## 0.1.15 + +### Patch Changes + +- Updated dependencies [[`d1997b6`](https://github.com/TanStack/router/commit/d1997b66d7c24c1d64772bb8bab5caf9c6d9cc48)]: + - @tanstack/start-server-core@1.169.6 + - @tanstack/react-router@1.170.9 + - @tanstack/router-core@1.171.7 + - @tanstack/react-start-server@1.167.11 + - @tanstack/start-plugin-core@1.171.8 + - @tanstack/start-client-core@1.170.5 + - @tanstack/start-storage-context@1.167.9 + +## 0.1.14 + +### Patch Changes + +- Updated dependencies [[`9c09bca`](https://github.com/TanStack/router/commit/9c09bca59e9613e9a6fd9b7149b0737898e705d6)]: + - @tanstack/start-plugin-core@1.171.7 + - @tanstack/start-server-core@1.169.5 + - @tanstack/react-start-server@1.167.10 + +## 0.1.13 + +### Patch Changes + +- Updated dependencies [[`a82cec6`](https://github.com/TanStack/router/commit/a82cec69474c366b36efdb3f43c4efe8311c485a), [`d8be4f8`](https://github.com/TanStack/router/commit/d8be4f8adf912128c96b7f83e9a6c49fb24b5eed)]: + - @tanstack/start-plugin-core@1.171.6 + - @tanstack/start-client-core@1.170.4 + - @tanstack/start-server-core@1.169.4 + - @tanstack/react-start-server@1.167.9 + +## 0.1.12 + +### Patch Changes + +- Updated dependencies [[`90adda9`](https://github.com/TanStack/router/commit/90adda91aab7212cbcdb6159176b39d9ed01b827)]: + - @tanstack/start-plugin-core@1.171.5 + +## 0.1.11 + +### Patch Changes + +- Updated dependencies [[`51a97a1`](https://github.com/TanStack/router/commit/51a97a167fb3ef1b8ca70fbb63db635158f43509), [`51a97a1`](https://github.com/TanStack/router/commit/51a97a167fb3ef1b8ca70fbb63db635158f43509)]: + - @tanstack/router-core@1.171.6 + - @tanstack/react-router@1.170.8 + - @tanstack/start-plugin-core@1.171.4 + - @tanstack/start-server-core@1.169.3 + - @tanstack/react-start-server@1.167.8 + - @tanstack/start-client-core@1.170.3 + - @tanstack/start-storage-context@1.167.8 + +## 0.1.10 + +### Patch Changes + +- Updated dependencies [[`5268ba4`](https://github.com/TanStack/router/commit/5268ba4566233ea58880df85f167ad0401a93a46)]: + - @tanstack/router-core@1.171.5 + - @tanstack/react-router@1.170.7 + - @tanstack/react-start-server@1.167.7 + - @tanstack/start-client-core@1.170.2 + - @tanstack/start-plugin-core@1.171.3 + - @tanstack/start-server-core@1.169.2 + - @tanstack/start-storage-context@1.167.7 + +## 0.1.9 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.171.2 + +## 0.1.8 + +### Patch Changes + +- Updated dependencies [[`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960), [`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960)]: + - @tanstack/router-core@1.171.4 + - @tanstack/react-router@1.170.6 + - @tanstack/react-start-server@1.167.6 + - @tanstack/start-client-core@1.170.1 + - @tanstack/start-plugin-core@1.171.1 + - @tanstack/start-server-core@1.169.1 + - @tanstack/start-storage-context@1.167.6 + +## 0.1.7 + +### Patch Changes + +- Updated dependencies [[`5fa9e55`](https://github.com/TanStack/router/commit/5fa9e555f3a2edb5e45586623e6bcbfa7f7c7a6b)]: + - @tanstack/start-client-core@1.170.0 + - @tanstack/start-plugin-core@1.171.0 + - @tanstack/start-server-core@1.169.0 + - @tanstack/router-core@1.171.3 + - @tanstack/router-utils@1.162.1 + - @tanstack/react-start-server@1.167.5 + - @tanstack/react-router@1.170.5 + - @tanstack/start-storage-context@1.167.5 + +## 0.1.6 + +### Patch Changes + +- Updated dependencies [[`b60eb36`](https://github.com/TanStack/router/commit/b60eb36e59e8a468ee0742cbcf7f47aca1ff1c67)]: + - @tanstack/router-core@1.171.2 + - @tanstack/react-router@1.170.4 + - @tanstack/react-start-server@1.167.4 + - @tanstack/start-client-core@1.169.4 + - @tanstack/start-plugin-core@1.170.6 + - @tanstack/start-server-core@1.168.4 + - @tanstack/start-storage-context@1.167.4 + +## 0.1.5 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.170.5 + +## 0.1.4 + +### Patch Changes + +- Updated dependencies [[`d9cf933`](https://github.com/TanStack/router/commit/d9cf9331b83fcbd2abfee75d839d862f9bb18e6b)]: + - @tanstack/router-core@1.171.1 + - @tanstack/react-router@1.170.3 + - @tanstack/react-start-server@1.167.3 + - @tanstack/start-client-core@1.169.3 + - @tanstack/start-plugin-core@1.170.4 + - @tanstack/start-server-core@1.168.3 + - @tanstack/start-storage-context@1.167.3 + +## 0.1.3 + +### Patch Changes + +- Updated dependencies [[`d533f87`](https://github.com/TanStack/router/commit/d533f87976704098a40b48f160b37c28c8182806)]: + - @tanstack/router-core@1.171.0 + - @tanstack/react-router@1.170.2 + - @tanstack/react-start-server@1.167.2 + - @tanstack/start-client-core@1.169.2 + - @tanstack/start-plugin-core@1.170.3 + - @tanstack/start-server-core@1.168.2 + - @tanstack/start-storage-context@1.167.2 + +## 0.1.2 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.170.2 + +## 0.1.1 + +### Patch Changes + +- Updated dependencies [[`2387a2e`](https://github.com/TanStack/router/commit/2387a2eea0683004cc400b9f71bed5944eb60110)]: + - @tanstack/router-core@1.170.1 + - @tanstack/start-plugin-core@1.170.1 + - @tanstack/start-server-core@1.168.1 + - @tanstack/react-router@1.170.1 + - @tanstack/react-start-server@1.167.1 + - @tanstack/start-client-core@1.169.1 + - @tanstack/start-storage-context@1.167.1 + +## 0.1.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- Updated dependencies [[`b1c061a`](https://github.com/TanStack/router/commit/b1c061aff9185cdf5fdc08c0136382a9dce0302f), [`201e150`](https://github.com/TanStack/router/commit/201e150bd1412bae2faa9ce53f0fefcb7574ac14), [`5ae2ae5`](https://github.com/TanStack/router/commit/5ae2ae5e0f8ce32e02667a482ea9be52a6150240)]: + - @tanstack/router-core@1.170.0 + - @tanstack/react-router@1.170.0 + - @tanstack/react-start-server@1.167.0 + - @tanstack/router-utils@1.162.0 + - @tanstack/start-client-core@1.169.0 + - @tanstack/start-fn-stubs@1.162.0 + - @tanstack/start-plugin-core@1.170.0 + - @tanstack/start-server-core@1.168.0 + - @tanstack/start-storage-context@1.167.0 + +## 0.0.44 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.169.20 + +## 0.0.43 + +### Patch Changes + +- Updated dependencies [[`35e88f0`](https://github.com/TanStack/router/commit/35e88f04996d71019a1868b7b06ecb4ddbc9df9e)]: + - @tanstack/router-core@1.169.2 + - @tanstack/start-client-core@1.168.2 + - @tanstack/start-plugin-core@1.169.19 + - @tanstack/start-server-core@1.167.30 + - @tanstack/react-router@1.169.2 + - @tanstack/react-start-server@1.166.52 + - @tanstack/start-storage-context@1.166.35 + +## 0.0.42 + +### Patch Changes + +- Updated dependencies [[`056337e`](https://github.com/TanStack/router/commit/056337ef02ccbeaf45ec8533a227761be869e8f3)]: + - @tanstack/router-utils@1.161.8 + - @tanstack/start-plugin-core@1.169.18 + +## 0.0.41 + +### Patch Changes + +- Updated dependencies [[`afa40ef`](https://github.com/TanStack/router/commit/afa40ef46c273c53646ba33f607fc618a07ffede)]: + - @tanstack/start-server-core@1.167.29 + - @tanstack/react-start-server@1.166.51 + - @tanstack/start-plugin-core@1.169.17 + +## 0.0.40 + +### Patch Changes + +- Updated dependencies [[`709627f`](https://github.com/TanStack/router/commit/709627f3dbc6d97daa547a1401ef42a53bc4be32)]: + - @tanstack/start-server-core@1.167.28 + - @tanstack/react-start-server@1.166.50 + - @tanstack/start-plugin-core@1.169.16 + +## 0.0.39 + +### Patch Changes + +- Updated dependencies [[`238ea4a`](https://github.com/TanStack/router/commit/238ea4a4998ab3a7fd528b317e1935766ac65df8)]: + - @tanstack/start-server-core@1.167.27 + - @tanstack/react-start-server@1.166.49 + - @tanstack/start-plugin-core@1.169.15 + +## 0.0.38 + +### Patch Changes + +- Updated dependencies [[`96818b8`](https://github.com/TanStack/router/commit/96818b8ba5ead6f1f027094841330182aff415b2)]: + - @tanstack/start-plugin-core@1.169.14 + +## 0.0.37 + +### Patch Changes + +- Add compiler-driven RSC CSS auto-injection for Start RSC render APIs and wire it into the React Start Vite and Rsbuild adapters. This ensures same-file CSS module dependencies are discovered for `renderServerComponent`, `createCompositeComponent`, and JSX-based `renderToReadableStream` calls. ([#7310](https://github.com/TanStack/router/pull/7310)) + + Also add a configurable server function provider module directive hook used by the React Rsbuild RSC adapter to emit `"use server-entry"` only for extracted provider files. + +- Updated dependencies [[`ae453b7`](https://github.com/TanStack/router/commit/ae453b78624cac1b574f0d1efbfbf6ca03922c6c)]: + - @tanstack/start-plugin-core@1.169.13 + +## 0.0.36 + +### Patch Changes + +- Updated dependencies [[`4a1e63f`](https://github.com/TanStack/router/commit/4a1e63f1d1230b1ed8234609acad4639d8982c13)]: + - @tanstack/router-core@1.169.1 + - @tanstack/react-router@1.169.1 + - @tanstack/react-start-server@1.166.48 + - @tanstack/start-client-core@1.168.1 + - @tanstack/start-plugin-core@1.169.12 + - @tanstack/start-server-core@1.167.26 + - @tanstack/start-storage-context@1.166.34 + +## 0.0.35 + +### Patch Changes + +- Updated dependencies [[`82b0613`](https://github.com/TanStack/router/commit/82b06132af776f74603ab27977cc277d6219a845)]: + - @tanstack/start-client-core@1.168.0 + - @tanstack/react-start-server@1.166.47 + - @tanstack/start-plugin-core@1.169.11 + - @tanstack/start-server-core@1.167.25 + +## 0.0.34 + +### Patch Changes + +- Updated dependencies [[`c4256c2`](https://github.com/TanStack/router/commit/c4256c2c857f392d2031cf87821e4c36a92d0382)]: + - @tanstack/start-plugin-core@1.169.10 + +## 0.0.33 + +### Patch Changes + +- Updated dependencies [[`761fcc0`](https://github.com/TanStack/router/commit/761fcc0c96dd96721b533a1fd9e2c972f222ef94)]: + - @tanstack/start-plugin-core@1.169.9 + +## 0.0.32 + +### Patch Changes + +- Updated dependencies [[`c992495`](https://github.com/TanStack/router/commit/c992495bf4010ff4c3597bb1f3b1ba02594e857e)]: + - @tanstack/router-core@1.169.0 + - @tanstack/react-router@1.169.0 + - @tanstack/react-start-server@1.166.46 + - @tanstack/start-client-core@1.167.22 + - @tanstack/start-plugin-core@1.169.8 + - @tanstack/start-server-core@1.167.24 + - @tanstack/start-storage-context@1.166.33 + +## 0.0.31 + +### Patch Changes + +- Updated dependencies [[`b5c4183`](https://github.com/TanStack/router/commit/b5c4183ab8b44be8a75647b7f7b588ad7c146ece)]: + - @tanstack/router-core@1.168.18 + - @tanstack/react-router@1.168.26 + - @tanstack/react-start-server@1.166.45 + - @tanstack/start-client-core@1.167.21 + - @tanstack/start-plugin-core@1.169.7 + - @tanstack/start-server-core@1.167.23 + - @tanstack/start-storage-context@1.166.32 + +## 0.0.30 + +### Patch Changes + +- Re-export `RenderableServerComponent`, `RenderableServerComponentAttributes`, `RenderableServerComponentBuilder`, and `AnyRenderableServerComponent` from the package's public entries. Without these, consumers with `declaration: true` hit TS2742 on `renderServerComponent` calls and are forced to annotate handlers as `Promise<any>`. ([#7278](https://github.com/TanStack/router/pull/7278)) + +## 0.0.29 + +### Patch Changes + +- Updated dependencies [[`493148b`](https://github.com/TanStack/router/commit/493148bc5378b7f9de1544d87f6aaa425c12eb34)]: + - @tanstack/router-core@1.168.17 + - @tanstack/react-router@1.168.25 + - @tanstack/react-start-server@1.166.44 + - @tanstack/start-client-core@1.167.20 + - @tanstack/start-plugin-core@1.169.6 + - @tanstack/start-server-core@1.167.22 + - @tanstack/start-storage-context@1.166.31 + +## 0.0.28 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.169.5 + +## 0.0.27 + +### Patch Changes + +- Updated dependencies [[`8b97002`](https://github.com/TanStack/router/commit/8b97002af3f6d15204e60c55d3f5735b78bd7efe)]: + - @tanstack/start-client-core@1.167.19 + - @tanstack/react-start-server@1.166.43 + - @tanstack/start-plugin-core@1.169.4 + - @tanstack/start-server-core@1.167.21 + +## 0.0.26 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.169.3 + +## 0.0.25 + +### Patch Changes + +- Updated dependencies [[`4d864ee`](https://github.com/TanStack/router/commit/4d864eebbd184265eabb563d326ab409c93feb17)]: + - @tanstack/react-router@1.168.24 + - @tanstack/router-core@1.168.16 + - @tanstack/start-plugin-core@1.169.2 + - @tanstack/start-server-core@1.167.20 + - @tanstack/react-start-server@1.166.42 + - @tanstack/start-client-core@1.167.18 + - @tanstack/start-storage-context@1.166.30 + +## 0.0.24 + +### Patch Changes + +- Updated dependencies [[`9252206`](https://github.com/TanStack/router/commit/9252206e5aeafe53e31eb7baa491d07a597c4dc6)]: + - @tanstack/start-plugin-core@1.169.1 + +## 0.0.23 + +### Patch Changes + +- Split Start plugin core bundler APIs into explicit Vite and Rsbuild subpaths so projects only need the bundler they use. Mark both `vite` and `@rsbuild/core` peers as optional where Start exposes both integrations. ([#7249](https://github.com/TanStack/router/pull/7249)) + +- Updated dependencies [[`dda463c`](https://github.com/TanStack/router/commit/dda463c8b571519165d3adbc337db7a0b8be1072)]: + - @tanstack/start-plugin-core@1.169.0 + +## 0.0.22 + +### Patch Changes + +- rsbuild ([#7228](https://github.com/TanStack/router/pull/7228)) + +- Updated dependencies [[`91a7089`](https://github.com/TanStack/router/commit/91a708989d00537a21911e74ff60bbfec8266295)]: + - @tanstack/start-plugin-core@1.168.0 + - @tanstack/router-utils@1.161.7 + +## 0.0.21 + +### Patch Changes + +- Updated dependencies [[`cd91cee`](https://github.com/TanStack/router/commit/cd91ceebb84b7b752b5ee09ac14e89ad2beb2259)]: + - @tanstack/react-router@1.168.23 + - @tanstack/react-start-server@1.166.41 + +## 0.0.20 + +### Patch Changes + +- Updated dependencies [[`f7f0025`](https://github.com/TanStack/router/commit/f7f00250f39cf0276a984558e5d427e9270d9635)]: + - @tanstack/start-plugin-core@1.167.35 + +## 0.0.19 + +### Patch Changes + +- Updated dependencies [[`e30814d`](https://github.com/TanStack/router/commit/e30814d949110ff25829de44d729ead47555940a)]: + - @tanstack/react-router@1.168.22 + - @tanstack/react-start-server@1.166.40 + +## 0.0.18 + +### Patch Changes + +- Updated dependencies [[`16f6892`](https://github.com/TanStack/router/commit/16f6892d6b7ceadf606677c5a40e743f29163aa6)]: + - @tanstack/router-core@1.168.15 + - @tanstack/react-router@1.168.21 + - @tanstack/react-start-server@1.166.39 + - @tanstack/start-client-core@1.167.17 + - @tanstack/start-plugin-core@1.167.34 + - @tanstack/start-server-core@1.167.19 + - @tanstack/start-storage-context@1.166.29 + +## 0.0.17 + +### Patch Changes + +- Updated dependencies [[`c5ad329`](https://github.com/TanStack/router/commit/c5ad32936f6adcca0c56474677b73b212498443b)]: + - @tanstack/react-router@1.168.20 + - @tanstack/react-start-server@1.166.38 + +## 0.0.16 + +### Patch Changes + +- Fix Start virtual module resolution in pnpm workspaces by serving the client entry through a real Vite virtual module. ([#7178](https://github.com/TanStack/router/pull/7178)) + + Simplify Start virtual module handling by sharing a single `createVirtualModule` helper and collapsing internal `@tanstack/start-plugin-core` imports to the root export surface. + +- Updated dependencies [[`a581680`](https://github.com/TanStack/router/commit/a581680a27530469751b8ab419ada9ce66da4ffe)]: + - @tanstack/start-plugin-core@1.167.33 + +## 0.0.15 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.167.32 + +## 0.0.14 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.167.31 + +## 0.0.13 + +### Patch Changes + +- Updated dependencies [[`105d056`](https://github.com/TanStack/router/commit/105d05691a247779a63e7b688aa1207cce619339)]: + - @tanstack/react-router@1.168.19 + - @tanstack/start-plugin-core@1.167.30 + - @tanstack/react-start-server@1.166.37 + +## 0.0.12 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.167.29 + +## 0.0.11 + +### Patch Changes + +- Updated dependencies [[`0e2c900`](https://github.com/TanStack/router/commit/0e2c9003c18ae07c09969189c028f277ea562a7a)]: + - @tanstack/start-server-core@1.167.18 + - @tanstack/router-core@1.168.14 + - @tanstack/react-start-server@1.166.36 + - @tanstack/start-plugin-core@1.167.28 + - @tanstack/react-router@1.168.18 + - @tanstack/start-client-core@1.167.16 + - @tanstack/start-storage-context@1.166.28 + +## 0.0.10 + +### Patch Changes + +- Updated dependencies [[`812792f`](https://github.com/TanStack/router/commit/812792fbda3caf97b300770855cf5641252f413b)]: + - @tanstack/router-core@1.168.13 + - @tanstack/start-plugin-core@1.167.27 + - @tanstack/start-server-core@1.167.17 + - @tanstack/react-router@1.168.17 + - @tanstack/react-start-server@1.166.35 + - @tanstack/start-client-core@1.167.15 + - @tanstack/start-storage-context@1.166.27 + +## 0.0.9 + +### Patch Changes + +- Updated dependencies [[`8ec9ca9`](https://github.com/TanStack/router/commit/8ec9ca97b472779de878c2a6510f21deb24d386c)]: + - @tanstack/router-core@1.168.12 + - @tanstack/react-router@1.168.16 + - @tanstack/react-start-server@1.166.34 + - @tanstack/start-client-core@1.167.14 + - @tanstack/start-plugin-core@1.167.26 + - @tanstack/start-server-core@1.167.16 + - @tanstack/start-storage-context@1.166.26 + +## 0.0.8 + +### Patch Changes + +- Updated dependencies [[`d3f20fb`](https://github.com/TanStack/router/commit/d3f20fbe7acf69c3bd108c5ddc9748ad47690b04)]: + - @tanstack/start-plugin-core@1.167.25 + +## 0.0.7 + +### Patch Changes + +- Updated dependencies [[`6355bb7`](https://github.com/TanStack/router/commit/6355bb75f7637ba77f06a923c18fdaf37720bb48)]: + - @tanstack/start-server-core@1.167.15 + - @tanstack/react-router@1.168.15 + - @tanstack/router-core@1.168.11 + - @tanstack/react-start-server@1.166.33 + - @tanstack/start-plugin-core@1.167.24 + - @tanstack/start-client-core@1.167.13 + - @tanstack/start-storage-context@1.166.25 + +## 0.0.6 + +### Patch Changes + +- Updated dependencies [[`459057c`](https://github.com/TanStack/router/commit/459057cd2d90cff20d20e51d4964b0a8c950555e)]: + - @tanstack/start-client-core@1.167.12 + - @tanstack/start-server-core@1.167.14 + - @tanstack/react-router@1.168.14 + - @tanstack/router-core@1.168.10 + - @tanstack/react-start-server@1.166.32 + - @tanstack/start-plugin-core@1.167.23 + - @tanstack/start-storage-context@1.166.24 + +## 0.0.5 + +### Patch Changes + +- Updated dependencies [[`f8ac427`](https://github.com/TanStack/router/commit/f8ac427000c3fec99225926e72f9f2fc7a37231f)]: + - @tanstack/start-server-core@1.167.13 + - @tanstack/start-client-core@1.167.11 + - @tanstack/react-start-server@1.166.31 + - @tanstack/start-plugin-core@1.167.22 + +## 0.0.4 + +### Patch Changes + +- Updated dependencies [[`2d53c05`](https://github.com/TanStack/router/commit/2d53c056ef0b203de8a28bc92c24e8e604205d52)]: + - @tanstack/start-server-core@1.167.12 + - @tanstack/start-plugin-core@1.167.21 + - @tanstack/react-start-server@1.166.30 + +## 0.0.2 + +### Patch Changes + +- Republish the React Start RSC package chain so fresh installs resolve a `start-plugin-core` build that exports the subpaths used by `react-start-rsc`. ([`3384abc`](https://github.com/TanStack/router/commit/3384abcffd98a68eb254b11221834bcbcdebec31)) + +- Updated dependencies [[`3384abc`](https://github.com/TanStack/router/commit/3384abcffd98a68eb254b11221834bcbcdebec31)]: + - @tanstack/start-plugin-core@1.167.19 + +## 0.0.1 + +### Patch Changes + +- Bump the initial release line for `@tanstack/react-start-rsc` and `@tanstack/eslint-plugin-start` to `0.0.1` after the manual `0.0.0` publish. ([#7144](https://github.com/TanStack/router/pull/7144)) diff --git a/packages/react-start-rsc/eslint.config.js b/packages/react-start-rsc/eslint.config.js new file mode 100644 index 0000000000..931f0ec774 --- /dev/null +++ b/packages/react-start-rsc/eslint.config.js @@ -0,0 +1,31 @@ +// @ts-check + +import pluginReact from '@eslint-react/eslint-plugin' +import pluginReactHooks from 'eslint-plugin-react-hooks' +import rootConfig from '../../eslint.config.js' + +export default [ + ...rootConfig, + { + ...pluginReact.configs.recommended, + files: ['**/*.{ts,tsx}'], + }, + { + plugins: { + 'react-hooks': pluginReactHooks, + }, + rules: { + '@eslint-react/no-unstable-context-value': 'off', + '@eslint-react/no-unstable-default-props': 'off', + '@eslint-react/dom/no-missing-button-type': 'off', + 'react-hooks/exhaustive-deps': 'error', + 'react-hooks/rules-of-hooks': 'error', + }, + }, + { + files: ['**/__tests__/**'], + rules: { + '@typescript-eslint/no-unnecessary-condition': 'off', + }, + }, +] diff --git a/packages/react-start-rsc/package.json b/packages/react-start-rsc/package.json new file mode 100644 index 0000000000..d85f92168a --- /dev/null +++ b/packages/react-start-rsc/package.json @@ -0,0 +1,136 @@ +{ + "name": "@tanstack/react-start-rsc", + "version": "0.1.17", + "description": "React Server Components support for TanStack Start", + "author": "Tanner Linsley", + "license": "MIT", + "repository": { + "type": "git", + "url": "git+https://github.com/TanStack/router.git", + "directory": "packages/react-start-rsc" + }, + "homepage": "https://tanstack.com/start", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/tannerlinsley" + }, + "keywords": [ + "react", + "rsc", + "server components", + "router", + "routing", + "typescript" + ], + "scripts": { + "clean": "rimraf ./dist && rimraf ./coverage", + "test": "pnpm test:eslint && pnpm test:types && pnpm test:build && pnpm test:unit", + "test:unit": "vitest", + "test:unit:dev": "vitest --watch", + "test:eslint": "eslint ./src", + "test:types": "pnpm run \"/^test:types:ts[0-9]{2}$/\"", + "test:types:ts55": "node ../../node_modules/typescript55/lib/tsc.js", + "test:types:ts56": "node ../../node_modules/typescript56/lib/tsc.js", + "test:types:ts57": "node ../../node_modules/typescript57/lib/tsc.js", + "test:types:ts58": "node ../../node_modules/typescript58/lib/tsc.js", + "test:types:ts59": "node ../../node_modules/typescript59/lib/tsc.js", + "test:types:ts60": "tsc", + "test:build": "publint --strict && attw --ignore-rules no-resolution --pack .", + "build": "vite build" + }, + "type": "module", + "types": "dist/esm/src/index.d.ts", + "exports": { + ".": { + "react-server": { + "types": "./dist/esm/src/index.rsc.d.ts", + "default": "./dist/esm/index.rsc.js" + }, + "import": { + "types": "./dist/esm/src/index.d.ts", + "default": "./dist/esm/index.js" + } + }, + "./serialization.client": { + "import": { + "types": "./dist/esm/src/serialization.client.d.ts", + "default": "./dist/esm/serialization.client.js" + } + }, + "./serialization.server": { + "import": { + "types": "./dist/esm/src/serialization.server.d.ts", + "default": "./dist/esm/serialization.server.js" + } + }, + "./plugin/vite": { + "import": { + "types": "./dist/esm/src/plugin/vite.d.ts", + "default": "./dist/esm/plugin/vite.js" + } + }, + "./plugin/rscCssTransform": { + "import": { + "types": "./dist/esm/src/plugin/rscCssTransform.d.ts", + "default": "./dist/esm/plugin/rscCssTransform.js" + } + }, + "./rsbuild/ssr-decode": { + "import": { + "types": "./dist/esm/src/rsbuild/ssr-decode.d.ts", + "default": "./dist/esm/rsbuild/ssr-decode.js" + } + }, + "./rsbuild/browser-decode": { + "import": { + "types": "./dist/esm/src/rsbuild/browser-decode.d.ts", + "default": "./dist/esm/rsbuild/browser-decode.js" + } + }, + "./package.json": "./package.json" + }, + "files": [ + "dist", + "src" + ], + "engines": { + "node": ">=22.12.0" + }, + "dependencies": { + "@tanstack/react-router": "workspace:*", + "@tanstack/react-start-server": "workspace:*", + "@tanstack/router-core": "workspace:*", + "@tanstack/router-utils": "workspace:*", + "@tanstack/start-client-core": "workspace:*", + "@tanstack/start-fn-stubs": "workspace:*", + "@tanstack/start-plugin-core": "workspace:*", + "@tanstack/start-server-core": "workspace:*", + "@tanstack/start-storage-context": "workspace:*", + "pathe": "^2.0.3" + }, + "devDependencies": { + "@rspack/core": "2.0.0", + "@testing-library/react": "^16.2.0", + "@vitejs/plugin-react": "^4.3.4", + "@vitejs/plugin-rsc": "^0.5.20", + "react-server-dom-rspack": "^0.0.2" + }, + "peerDependencies": { + "@rspack/core": ">=2.0.0-0", + "@vitejs/plugin-rsc": ">=0.5.20", + "react": ">=18.0.0 || >=19.0.0", + "react-dom": ">=18.0.0 || >=19.0.0", + "react-server-dom-rspack": ">=0.0.2" + }, + "peerDependenciesMeta": { + "@rspack/core": { + "optional": true + }, + "@vitejs/plugin-rsc": { + "optional": true + }, + "react-server-dom-rspack": { + "optional": true + } + } +} diff --git a/packages/react-start-rsc/src/ClientSlot.tsx b/packages/react-start-rsc/src/ClientSlot.tsx new file mode 100644 index 0000000000..01e494049e --- /dev/null +++ b/packages/react-start-rsc/src/ClientSlot.tsx @@ -0,0 +1,34 @@ +'use client' + +import { useSlotContext } from './SlotContext' + +export interface ClientSlotProps { + slot: string + args: Array<unknown> +} + +export function ClientSlot({ slot, args }: ClientSlotProps) { + const ctx = useSlotContext() + + if (!ctx) { + throw new Error('ClientSlot must be rendered within SlotProvider') + } + + const impl = ctx.implementations[slot] + + // No implementation provided + if (impl === undefined) { + if (ctx.strict) { + throw new Error(`Missing slot implementation for "${slot}"`) + } + return null + } + + // For children slot or any non-function value, render directly + if (typeof impl !== 'function') { + return <>{impl}</> + } + + // Render function with args + return <>{impl(...args)}</> +} diff --git a/packages/react-start-rsc/src/CompositeComponent.tsx b/packages/react-start-rsc/src/CompositeComponent.tsx new file mode 100644 index 0000000000..e6c81aa69a --- /dev/null +++ b/packages/react-start-rsc/src/CompositeComponent.tsx @@ -0,0 +1,165 @@ +'use client' + +import { Suspense } from 'react' +import ReactDOM from 'react-dom' + +import { SlotProvider } from './SlotContext' +import { + RSC_PROXY_GET_TREE, + RSC_PROXY_PATH, + SERVER_COMPONENT_CSS_HREFS, + SERVER_COMPONENT_JS_PRELOADS, + SERVER_COMPONENT_STREAM, +} from './ServerComponentTypes' +import type { AnyCompositeComponent } from './ServerComponentTypes' +import type { SlotImplementations } from './types' + +function splitSlotProps(props?: Record<string, unknown>): { + implementations: SlotImplementations + strict: boolean +} { + const safeProps = props ?? {} + const { children, strict, ...slotProps } = safeProps as { + children?: unknown + strict?: unknown + [key: string]: unknown + } + + return { + implementations: { ...slotProps, children }, + strict: strict === true, + } +} + +function EmptyFallback() { + return null +} + +function CompositeRenderInner({ + getTree, + path, + slotProps, +}: { + getTree: () => unknown + path: Array<string> + slotProps?: Record<string, unknown> +}): React.ReactNode { + let tree: unknown = getTree() + + for (const key of path) { + if (tree === null || tree === undefined) return null + if (typeof tree !== 'object') return null + tree = (tree as Record<string, unknown>)[key] + } + + if (tree === null || tree === undefined) return null + + const { implementations, strict } = splitSlotProps(slotProps) + + return ( + <SlotProvider implementations={implementations} strict={strict}> + {tree as React.ReactNode} + </SlotProvider> + ) +} + +function CompositeRenderComponent({ + getTree, + path, + slotProps, + cssHrefs, + jsPreloads, +}: { + getTree: () => unknown + path: Array<string> + slotProps?: Record<string, unknown> + cssHrefs?: ReadonlySet<string> + jsPreloads?: ReadonlySet<string> +}): React.ReactNode { + for (const href of cssHrefs ?? []) { + ReactDOM.preinit(href, { as: 'style', precedence: 'high' }) + } + + if (jsPreloads) { + for (const href of jsPreloads) { + ReactDOM.preloadModule(href) + } + } + + return ( + <> + <Suspense fallback={<EmptyFallback />}> + <CompositeRenderInner + getTree={getTree} + path={path} + slotProps={slotProps} + /> + </Suspense> + </> + ) +} + +/** + * Renders composite RSC data with slot support. + * + * Use this component to render data from `createCompositeComponent`. + * Pass slot implementations as props to fill in ClientSlot placeholders. + * + * @example + * ```tsx + * const src = await createCompositeComponent((props) => ( + * <div> + * <header>{props.header('Dashboard')}</header> + * <main>{props.children}</main> + * </div> + * )) + * + * // In route component + * return ( + * <CompositeComponent src={src} header={(title) => <h1>{title}</h1>}> + * <p>Main content</p> + * </CompositeComponent> + * ) + * ``` + */ +export function CompositeComponent<TComp extends AnyCompositeComponent>( + props: CompositeComponentProps<TComp>, +): TComp['~types']['return'] { + const { src, ...slotProps } = props + + const stream = src[SERVER_COMPONENT_STREAM] + + if (!stream) { + throw new Error( + '[tanstack/start] <CompositeComponent> missing RSC stream on src', + ) + } + + const cssHrefs = src[SERVER_COMPONENT_CSS_HREFS] + const jsPreloads = src[SERVER_COMPONENT_JS_PRELOADS] + + const path = src[RSC_PROXY_PATH] ?? [] + + const getTree = src[RSC_PROXY_GET_TREE] + + if (!getTree) { + throw new Error( + '[tanstack/start] <CompositeComponent> missing getTree on RSC src. ' + + 'Make sure src comes from createCompositeComponent().', + ) + } + + return ( + <CompositeRenderComponent + getTree={getTree} + path={path} + slotProps={slotProps} + cssHrefs={cssHrefs} + jsPreloads={jsPreloads} + /> + ) +} + +export type CompositeComponentProps<TComp extends AnyCompositeComponent> = { + src: TComp +} & TComp['~types']['props'] diff --git a/packages/react-start-rsc/src/ReplayableStream.ts b/packages/react-start-rsc/src/ReplayableStream.ts new file mode 100644 index 0000000000..4c3e878c79 --- /dev/null +++ b/packages/react-start-rsc/src/ReplayableStream.ts @@ -0,0 +1,249 @@ +/** + * ReplayableStream is used for React Server Components (RSC) / Flight streams. + * + * In this package the same Flight payload may need to be: + * - decoded for SSR (render path), and/or + * - serialized for transport to the client for client-side decoding. + * + * Call sites: + * - `src/createServerComponent.ts`: wraps the produced Flight stream once. + * - `src/serialization.ts`: uses `createReplayStream()` to transport a fresh stream + * to the client via `RawStream`. + * + * Constraints: + * - Consumption order isn't fixed: SSR decode might start first or transport might + * start first depending on the request path. + * - Sometimes only one happens (e.g. when client calls server function directly). + * + * Why not just `ReadableStream.tee()`? + * - tee() must be called up-front before the stream is consumed/locked and only + * creates two live branches (no late "replay from byte 0"). + * - If one branch is slower or never consumed, the runtime may buffer internally + * to keep branches consistent, which can retain large Flight payloads longer + * than intended and makes cleanup less explicit. + * + * ReplayableStream reads once, buffers explicitly, can mint replay streams on + * demand, and centralizes cancellation so aborting can stop upstream work and + * free buffered data deterministically. + * + * Memory Management: + * - Memory is released when the abort signal fires (request cancelled) + * - Call `release()` to force immediate cleanup if no more replays are needed + * - No automatic release: replays can be created at unpredictable times (SSR decode + * finishes before serialization starts), so we can't safely auto-release + */ + +export interface ReplayableStreamOptions { + signal?: AbortSignal +} + +// Use Symbol.for to ensure the same symbol across different module instances +export const REPLAYABLE_STREAM_MARKER = Symbol.for( + 'tanstack.rsc.ReplayableStream', +) + +export class ReplayableStream<T = Uint8Array> { + // Marker for cross-environment instance checking + readonly [REPLAYABLE_STREAM_MARKER] = true + + private chunks: Array<T> = [] + private done = false + private error: unknown = null + private waiter: PromiseWithResolvers<void> | null = null + private aborted = false + private released = false + + private sourceReader: ReadableStreamDefaultReader<T> | null = null + private abortSignal: AbortSignal | undefined + private abortListener: (() => void) | null = null + + constructor( + private source: ReadableStream<T>, + private options: ReplayableStreamOptions = {}, + ) { + this.abortSignal = options.signal + this.start() + } + + private start(): void { + const signal = this.abortSignal + + if (signal?.aborted) { + this.handleAbort() + return + } + + const onAbort = () => this.handleAbort() + this.abortListener = onAbort + signal?.addEventListener('abort', onAbort, { once: true }) + + const reader = this.source.getReader() + this.sourceReader = reader + + const pump = async () => { + try { + // Keep reading until upstream ends or we are stopped. + while (!this.aborted && !this.released) { + const { done, value } = await reader.read() + if (done) break + // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition + if (this.aborted || this.released) break + this.chunks.push(value) + this.notify() + } + this.done = true + } catch (err) { + if (!this.aborted && !this.released) { + this.error = err + } + this.done = true + } finally { + this.detachAbortListener() + try { + reader.releaseLock() + } catch { + // Ignore + } + if (this.sourceReader === reader) { + this.sourceReader = null + } + this.notify() + } + } + + pump() + } + + private detachAbortListener(): void { + const signal = this.abortSignal + const listener = this.abortListener + if (signal && listener) { + signal.removeEventListener('abort', listener) + } + this.abortListener = null + } + + private cancelSource(reason: unknown): void { + const reader = this.sourceReader + this.sourceReader = null + + try { + reader?.cancel(reason).catch(() => {}) + } catch { + // Ignore + } + } + + private handleAbort(): void { + if (this.aborted) return + this.aborted = true + this.done = true + + // Try to stop upstream work immediately. + // Cancellation during an abort can throw synchronously in some runtimes + // (eg when the underlying cancel algorithm throws). Never let that escape + // an AbortSignal event handler. + const reason = + this.abortSignal?.reason ?? new Error('ReplayableStream aborted') + + this.detachAbortListener() + this.abortSignal = undefined + this.cancelSource(reason) + + this.chunks = [] // Free memory immediately on abort + this.released = true + this.notify() + } + + private notify(): void { + if (this.waiter) { + this.waiter.resolve() + this.waiter = null + } + } + + private wait(): Promise<void> { + if (this.done || this.released) return Promise.resolve() + if (!this.waiter) { + this.waiter = Promise.withResolvers<void>() + } + return this.waiter.promise + } + + /** + * Explicitly release buffered chunks. + * Call this when you know no more replay streams will be created. + * After calling release(), createReplayStream() will return empty streams. + */ + release(): void { + if (this.released) return + + this.released = true + this.chunks = [] + + // Release should also stop upstream work and wake any waiters. + // This is important when a Flight payload is never consumed again + // (eg. cached loader data that evicts) to avoid retaining upstream resources. + this.detachAbortListener() + this.abortSignal = undefined + this.cancelSource(new Error('ReplayableStream released')) + this.notify() + } + + /** + * Check if the stream data has been released + */ + isReleased(): boolean { + return this.released + } + + /** + * Create an independent replay stream. Each call returns a fresh reader + * that starts from the beginning of the buffered data. + * + * If the stream has been released, returns a stream that closes immediately. + */ + createReplayStream(): ReadableStream<T> { + if (this.released) { + return new ReadableStream<T>({ + start(controller) { + controller.close() + }, + }) + } + + let index = 0 + + return new ReadableStream<T>({ + pull: async (controller) => { + // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition + while (true) { + if (this.released) { + controller.close() + return + } + + if (index < this.chunks.length) { + controller.enqueue(this.chunks[index++] as T) + return + } + + if (this.done) { + if (this.error && !this.aborted) { + controller.error(this.error) + } else { + controller.close() + } + return + } + + await this.wait() + } + }, + cancel: () => { + // No-op: consumers canceling a replay should not cancel upstream. + // Upstream cancellation is controlled by abort/release. + }, + }) + } +} diff --git a/packages/react-start-rsc/src/RscNodeRenderer.tsx b/packages/react-start-rsc/src/RscNodeRenderer.tsx new file mode 100644 index 0000000000..430f24ad0f --- /dev/null +++ b/packages/react-start-rsc/src/RscNodeRenderer.tsx @@ -0,0 +1,76 @@ +'use client' + +import { Suspense } from 'react' +import ReactDOM from 'react-dom' + +import { + RSC_PROXY_GET_TREE, + RSC_PROXY_PATH, + SERVER_COMPONENT_CSS_HREFS, + SERVER_COMPONENT_JS_PRELOADS, +} from './ServerComponentTypes' + +function EmptyFallback() { + return null +} + +function RscNodeRenderInner({ + getTree, + path, +}: { + getTree: () => unknown + path: Array<string> +}): React.ReactNode { + let tree: unknown = getTree() + + for (const key of path) { + if (tree === null || tree === undefined) return null + if (typeof tree !== 'object') return null + tree = (tree as Record<string, unknown>)[key] + } + + if (tree === null || tree === undefined) return null + + // No SlotProvider - just return the tree directly + return tree as React.ReactNode +} + +/** + * Renders a renderable RSC proxy without slot support. + * Used internally by the renderable proxy's $$typeof/type masquerade. + */ +export function RscNodeRenderer({ data }: { data: any }): React.ReactNode { + const cssHrefs = data[SERVER_COMPONENT_CSS_HREFS] as + | ReadonlySet<string> + | undefined + const jsPreloads = data[SERVER_COMPONENT_JS_PRELOADS] as + | ReadonlySet<string> + | undefined + + const path = (data[RSC_PROXY_PATH] as Array<string> | undefined) ?? [] + + const getTree = data[RSC_PROXY_GET_TREE] as (() => unknown) | undefined + if (!getTree) { + throw new Error( + '[tanstack/start] RscNodeRenderer missing getTree on RSC data.', + ) + } + + for (const href of cssHrefs ?? []) { + ReactDOM.preinit(href, { as: 'style', precedence: 'high' }) + } + + if (jsPreloads) { + for (const href of jsPreloads) { + ReactDOM.preloadModule(href) + } + } + + return ( + <> + <Suspense fallback={<EmptyFallback />}> + <RscNodeRenderInner getTree={getTree} path={path} /> + </Suspense> + </> + ) +} diff --git a/packages/react-start-rsc/src/ServerComponentTypes.ts b/packages/react-start-rsc/src/ServerComponentTypes.ts new file mode 100644 index 0000000000..5e1fa32a52 --- /dev/null +++ b/packages/react-start-rsc/src/ServerComponentTypes.ts @@ -0,0 +1,216 @@ +import type { + Constrain, + LooseAsyncReturnType, + LooseReturnType, + ValidateSerializable, +} from '@tanstack/router-core' +import type { ComponentProps, ComponentType } from 'react' + +export interface ServerComponentStream { + createReplayStream: () => ReadableStream<Uint8Array> +} + +// Symbol to attach stream to component for serialization +export const SERVER_COMPONENT_STREAM = Symbol.for('tanstack.rsc.stream') + +// Symbol to attach collected CSS hrefs to component +export const SERVER_COMPONENT_CSS_HREFS = Symbol.for('tanstack.rsc.cssHrefs') + +// Symbol to attach collected JS modulepreload hrefs to component +export const SERVER_COMPONENT_JS_PRELOADS = Symbol.for( + 'tanstack.rsc.jsPreloads', +) + +// Symbol to attach a nested selection path to the RSC data proxy +export const RSC_PROXY_PATH = Symbol.for('tanstack.rsc.path') + +// Symbol to attach the root tree getter to every nested proxy +export const RSC_PROXY_GET_TREE = Symbol.for('tanstack.rsc.getTree') + +// Symbol to mark a proxy as "renderable" (for renderServerComponent output) +// When true: from renderServerComponent (directly renderable) +// When false/undefined: from createCompositeComponent (needs <CompositeComponent src={...} />) +export const RENDERABLE_RSC = Symbol.for('tanstack.rsc.renderable') + +// Dev-only: collected slot usage data for devtools (client-side cache) +export const RSC_SLOT_USAGES = Symbol.for('tanstack.rsc.slotUsages') + +// Dev-only: stream of slot usage preview events for devtools +export const RSC_SLOT_USAGES_STREAM = Symbol.for( + 'tanstack.rsc.slotUsages.stream', +) + +export type RscSlotUsageEvent = { + slot: string + // Raw args passed to the slot call (must be serializable by the transport) + args?: Array<any> +} + +/** + * Type guard to check if a value is a ServerComponent (Proxy with attached stream). + * The value can be either an object (proxy target) or a function (stub for server functions). + */ +export function isServerComponent( + value: unknown, +): value is AnyCompositeComponent { + if (value === null || value === undefined) return false + if (typeof value !== 'object' && typeof value !== 'function') return false + return ( + SERVER_COMPONENT_STREAM in value && + (value as any)[SERVER_COMPONENT_STREAM] !== undefined + ) +} + +export type ValidateCompositeComponent<TComp> = Constrain< + TComp, + ( + props: ValidateCompositeComponentProps<TComp>, + ) => ValidateCompositeComponentReturnType<TComp> +> + +export type ValidateCompositeComponentProps<TComp> = unknown extends TComp + ? TComp + : ValidateCompositeComponentPropsObject<CompositeComponentProps<TComp>> + +export type ValidateCompositeComponentPropsObject<TProps> = + unknown extends TProps + ? TProps + : { + [TKey in keyof TProps]: ValidateCompositeComponentProp<TProps[TKey]> + } + +export type CompositeComponentProps<TComp> = TComp extends ( + props: infer TProps, +) => any + ? TProps + : unknown + +export type ValidateCompositeComponentProp<TProp> = TProp extends ( + ...args: Array<any> +) => any + ? (...args: ValidateReactSerializable<Parameters<TProp>>) => React.ReactNode + : TProp extends ComponentType<any> + ? ComponentType<ValidateReactSerializable<ComponentProps<TProp>>> + : TProp extends React.ReactNode + ? TProp + : React.ReactNode + +export type ValidateReactSerializable<T> = ValidateSerializable< + T, + ReactSerializable +> + +export type ReactSerializable = + | number + | string + | bigint + | boolean + | null + | undefined + | React.ReactNode + +export type ValidateCompositeComponentReturnType<TComp> = unknown extends TComp + ? React.ReactNode + : ValidateCompositeComponentResult<LooseReturnType<TComp>> + +export type ValidateCompositeComponentResult<TNode> = + ValidateServerComponentResult<TNode> + +export type ValidateServerComponentResult<TNode> = + TNode extends Promise<any> + ? ValidateCompositeComponentPromiseResult<TNode> + : TNode extends React.ReactNode + ? TNode + : TNode extends (...args: Array<any>) => any + ? React.ReactNode + : TNode extends object + ? ValidateCompositeComponentObjectResult<TNode> + : React.ReactNode + +export type ValidateCompositeComponentPromiseResult<TPromise> = + TPromise extends Promise<infer T> + ? Promise<ValidateCompositeComponentResult<T>> + : never + +export type ValidateCompositeComponentObjectResult<TObject> = { + [TKey in keyof TObject]: ValidateCompositeComponentResult<TObject[TKey]> +} + +export type CompositeComponentResult<TComp> = CompositeComponentBuilder< + TComp, + LooseAsyncReturnType<TComp> +> + +export type CompositeComponentBuilder<TComp, TReturn> = + TReturn extends React.ReactNode + ? CompositeComponent<TComp, TReturn> + : { + [TKey in keyof TReturn]: CompositeComponentBuilder<TComp, TReturn[TKey]> + } + +export interface CompositeComponent<in out TComp, in out TReturn> { + '~types': { + props: CompositeComponentProps<TComp> + return: TReturn + } + + [SERVER_COMPONENT_STREAM]?: ServerComponentStream + + /** + * Root decoded tree getter. + */ + [RSC_PROXY_GET_TREE]?: () => unknown + /** + * Nested selection path (eg ['content','Stats']). + * Used by <CompositeComponent/> to render a sub-tree. + */ + [RSC_PROXY_PATH]?: Array<string> + /** + * CSS hrefs collected from the RSC stream. + * Can be used for preloading in <head> or emitting 103 Early Hints. + */ + [SERVER_COMPONENT_CSS_HREFS]?: ReadonlySet<string> + + /** + * JS hrefs collected from the RSC stream. + * Emitted as modulepreload links only if the decoded tree is rendered in SSR. + */ + [SERVER_COMPONENT_JS_PRELOADS]?: ReadonlySet<string> + + /** + * Dev-only: async stream of slot usage preview events. + * Used by devtools to show slot names and previewed call args without + * buffering/draining the Flight stream. + */ + [RSC_SLOT_USAGES_STREAM]?: ReadableStream<RscSlotUsageEvent> +} + +export type ValidateRenderableServerComponent<TNode> = + ValidateServerComponentResult<TNode> + +export type RenderableServerComponentBuilder<T> = T extends React.ReactNode + ? RenderableServerComponent<T> + : { [TKey in keyof T]: RenderableServerComponentBuilder<T[TKey]> } + +export type RenderableServerComponent<TNode extends React.ReactNode> = TNode & + RenderableServerComponentAttributes<TNode> + +export interface RenderableServerComponentAttributes<TNode> { + '~types': { + node: TNode + } + [SERVER_COMPONENT_STREAM]: ServerComponentStream + [RENDERABLE_RSC]: true +} + +declare module '@tanstack/router-core' { + export interface SerializableExtensions { + CompositeComponent: AnyCompositeComponent + RenderableServerComponent: AnyRenderableServerComponent + } +} + +export type AnyCompositeComponent = CompositeComponent<any, any> + +export type AnyRenderableServerComponent = + RenderableServerComponentAttributes<any> diff --git a/packages/react-start-rsc/src/SlotContext.tsx b/packages/react-start-rsc/src/SlotContext.tsx new file mode 100644 index 0000000000..a3d0f867a1 --- /dev/null +++ b/packages/react-start-rsc/src/SlotContext.tsx @@ -0,0 +1,42 @@ +'use client' + +import { createContext, use } from 'react' +import type { SlotImplementations } from './types' + +export interface SlotContextValue { + implementations: SlotImplementations + strict: boolean +} + +const SlotContext = createContext<SlotContextValue | null>(null) + +/** + * Hook to access slot implementations from within ClientSlot. + */ +export function useSlotContext(): SlotContextValue | null { + return use(SlotContext) +} + +export interface SlotProviderProps { + implementations: SlotImplementations + strict?: boolean + children?: React.ReactNode +} + +/** + * SlotProvider - makes slot implementations available to ClientSlot components. + * + * Must wrap the decoded RSC content so that ClientSlot components can + * access their slot implementations via React Context. + */ +export function SlotProvider({ + implementations, + strict, + children, +}: SlotProviderProps) { + return ( + <SlotContext value={{ implementations, strict: strict ?? false }}> + {children} + </SlotContext> + ) +} diff --git a/packages/react-start-rsc/src/awaitLazyElements.ts b/packages/react-start-rsc/src/awaitLazyElements.ts new file mode 100644 index 0000000000..a0d8c5774e --- /dev/null +++ b/packages/react-start-rsc/src/awaitLazyElements.ts @@ -0,0 +1,94 @@ +import { ReactElement, ReactLazy, ReactSuspense } from './reactSymbols' + +/** + * Optional callback for collecting CSS hrefs during tree traversal. + * Only called server-side when processing <link rel="stylesheet" data-rsc-css-href> + */ +export type CssHrefCollector = (href: string) => void + +/** + * Yields pending lazy element payloads from a tree, stopping at Suspense boundaries. + * Also collects CSS hrefs from <link rel="stylesheet" data-rsc-css-href> elements. + */ +function* findPendingLazyPayloads( + obj: unknown, + seen = new Set(), + cssCollector?: CssHrefCollector, +): Generator<PromiseLike<unknown>> { + if (!obj || typeof obj !== 'object') return + if (seen.has(obj)) return + seen.add(obj) + + const el = obj as any + + // Stop at Suspense boundaries - lazy elements inside are intentionally deferred + if (el.$$typeof === ReactElement && el.type === ReactSuspense) { + return + } + + // Collect CSS hrefs from <link rel="stylesheet" data-rsc-css-href> + // The active RSC bundler adapter injects these for CSS module imports + if ( + el.$$typeof === ReactElement && + el.type === 'link' && + el.props?.rel === 'stylesheet' + ) { + let cssHref: string | undefined + if ('data-rsc-css-href' in el.props) { + cssHref = el.props.href + } + if (cssHref && cssCollector) { + cssCollector(cssHref) + } + } + + // Yield pending lazy element payload + if (el.$$typeof === ReactLazy) { + const payload = el._payload + if ( + payload && + typeof payload === 'object' && + (payload.status === 'pending' || payload.status === 'blocked') && + typeof payload.then === 'function' + ) { + yield payload + } + } + + // Recurse into children + if (Array.isArray(obj)) { + for (const item of obj) { + yield* findPendingLazyPayloads(item, seen, cssCollector) + } + } else { + for (const key of Object.keys(obj)) { + if (key !== '_owner' && key !== '_store') { + yield* findPendingLazyPayloads(el[key], seen, cssCollector) + } + } + } +} + +/** + * Wait for all lazy elements in a tree to be resolved. + * This ensures client component chunks are fully loaded before rendering, + * preventing Suspense boundaries from flashing during SWR navigation. + * + * Also collects CSS hrefs from <link rel="stylesheet" data-rsc-css-href> + * elements for preloading in <head>. + * + * @param tree - The tree to process + * @param cssCollector - Optional callback to collect CSS hrefs (server-only) + */ +export async function awaitLazyElements( + tree: unknown, + cssCollector?: CssHrefCollector, +): Promise<void> { + for (const payload of findPendingLazyPayloads( + tree, + new Set(), + cssCollector, + )) { + await Promise.resolve(payload).catch(() => {}) + } +} diff --git a/packages/react-start-rsc/src/createCompositeComponent.stub.ts b/packages/react-start-rsc/src/createCompositeComponent.stub.ts new file mode 100644 index 0000000000..8dd058ae15 --- /dev/null +++ b/packages/react-start-rsc/src/createCompositeComponent.stub.ts @@ -0,0 +1,20 @@ +import type { + CompositeComponentResult, + ValidateCompositeComponent, +} from './ServerComponentTypes' + +/** + * Client stub for createCompositeComponent. + * + * This function should never be called at runtime on the client. + * It exists only to satisfy bundler imports in client bundles. + * The real implementation only runs inside server functions. + */ +export function createCompositeComponent<TComp>( + _component: ValidateCompositeComponent<TComp>, +): Promise<CompositeComponentResult<TComp>> { + throw new Error( + 'createCompositeComponent cannot be called on the client. ' + + 'This function should only be called inside a server function or route loader.', + ) +} diff --git a/packages/react-start-rsc/src/createCompositeComponent.ts b/packages/react-start-rsc/src/createCompositeComponent.ts new file mode 100644 index 0000000000..c6a43b0f9d --- /dev/null +++ b/packages/react-start-rsc/src/createCompositeComponent.ts @@ -0,0 +1,342 @@ +import { createElement } from 'react' +import { renderToReadableStream } from 'virtual:tanstack-rsc-runtime' +import { getRequest } from '@tanstack/start-server-core' +import { getStartContext } from '@tanstack/start-storage-context' +import { sanitizeSlotArgs } from './slotUsageSanitizer' +import { ReplayableStream } from './ReplayableStream' +import { ClientSlot } from './ClientSlot' +import { + RSC_SLOT_USAGES_STREAM, + SERVER_COMPONENT_STREAM, +} from './ServerComponentTypes' +import { createRscCssEnvelope } from './rscCssEnvelope' +import type { + AnyCompositeComponent, + CompositeComponentResult, + RscSlotUsageEvent, + ServerComponentStream, + ValidateCompositeComponent, +} from './ServerComponentTypes' +import type { RscCssEnvelopeOptions } from './rscCssEnvelope' + +import './rscSsrHandler' // Import for global declaration side effect + +/** + * Creates a composite server component with slot support. + * + * Supports returning: + * - A ReactNode directly + * - An object structure with ReactNodes: accessed as `src.Foo` + * - Nested structures: accessed as `src.x.Bar` + * + * Props that are functions become slots - they render as ClientSlot placeholders + * in the RSC output, filled in by the consumer with actual implementations. + * + * The returned value is NOT directly renderable. Use `<CompositeComponent src={...} />`. + * + * @example + * ```tsx + * const src = await createCompositeComponent((props) => ( + * <div> + * <header>{props.header('Dashboard')}</header> + * <main>{props.children}</main> + * </div> + * )) + * + * // In route component + * return ( + * <CompositeComponent src={src} header={(title) => <h1>{title}</h1>}> + * <p>Main content</p> + * </CompositeComponent> + * ) + * ``` + */ +export async function createCompositeComponent<TComp>( + component: ValidateCompositeComponent<TComp>, + options?: RscCssEnvelopeOptions, +): Promise<CompositeComponentResult<TComp>> { + const isDev = process.env.NODE_ENV === 'development' + + // Dev-only: stream slot usage events (slot + raw args) + const slotUsagesEmitter = isDev + ? createReadableStreamEmitter<RscSlotUsageEvent>() + : null + + // Create a wrapper component that will be rendered inside React's Flight context. + // This ensures React.cache works properly since the component is called during + // renderToReadableStream's render phase, not before it. + const { proxy: proxyProps } = createSlotProxy<{}>({ + onSlotCall: slotUsagesEmitter + ? (name, args) => { + const sanitizedArgs = sanitizeSlotArgs(args) + slotUsagesEmitter.emit({ + slot: name, + args: sanitizedArgs.length ? sanitizedArgs : undefined, + }) + } + : undefined, + }) + + // Wrapper that renders the user's component inside Flight render context + async function ServerComponentWrapper() { + return createRscCssEnvelope( + await (component as React.FC)(proxyProps), + options, + ) + } + + // Render using createElement so React calls our component during Flight rendering + // This is critical for React.cache to work - the component must be invoked + // during renderToReadableStream's execution, not before + const flightStream = renderToReadableStream( + createElement(ServerComponentWrapper as any), + ) + + // Check if this is an SSR request (router) or a direct server function call + const ctx = getStartContext({ throwIfNotFound: false }) + const isRouterRequest = ctx?.handlerType === 'router' + const ssrHandler = globalThis.__RSC_SSR__ + + // SSR path: buffer stream for replay, pre-decode for synchronous rendering + if (isRouterRequest && ssrHandler) { + const signal = getRequest().signal + const stream = new ReplayableStream(flightStream, { signal }) + + // Pre-decode during loader phase for synchronous SSR rendering + const decoded = await ssrHandler.decode(stream) + + // For SSR we know decode fully consumed the Flight stream. + slotUsagesEmitter?.close() + + return ssrHandler.createCompositeProxy( + stream, + decoded, + slotUsagesEmitter?.stream, + ) as CompositeComponentResult<TComp> + } + + // Server function call path: + // The serialization adapter will stream to the client. + const monitoredFlightStream = + isDev && slotUsagesEmitter + ? wrapReadableStream(flightStream, { + onDone: () => { + slotUsagesEmitter.close() + }, + onCancel: () => { + slotUsagesEmitter.close() + }, + onError: () => { + slotUsagesEmitter.close() + }, + }) + : flightStream + + return createCompositeHandle(monitoredFlightStream, { + slotUsagesStream: slotUsagesEmitter?.stream, + }) as CompositeComponentResult<TComp> +} + +/** + * Creates a composite handle for server function responses. + * No proxy needed - the client will decode and create its own proxy. + */ +function createCompositeHandle( + flightStream: ReadableStream<Uint8Array>, + options?: { + slotUsagesStream?: ReadableStream<RscSlotUsageEvent> + }, +): AnyCompositeComponent { + // Simple single-use stream wrapper. For server function calls, the stream + // is consumed exactly once by the serialization adapter for transport. + const streamWrapper: ServerComponentStream = { + createReplayStream: () => flightStream, + } + + // Create a stub function with the stream attached for serialization. + // This will never be rendered directly - it goes through serialization + // which extracts the stream and sends it to the client. + const stub = function CompositeComponentStub(): never { + throw new Error( + 'CompositeComponent from server function cannot be rendered on server. ' + + 'It should be serialized and sent to the client.', + ) + } + + ;(stub as any)[SERVER_COMPONENT_STREAM] = streamWrapper + // Note: RENDERABLE_RSC is not set (or implicitly false), indicating this is a composite component + + if (options?.slotUsagesStream) { + ;(stub as any)[RSC_SLOT_USAGES_STREAM] = options.slotUsagesStream + } + + return stub as unknown as AnyCompositeComponent +} + +/** + * Base slot props type - functions that become ClientSlot placeholders + */ +interface SlotPropsBase { + [key: string]: + | ((...args: Array<any>) => React.ReactNode) + | React.ReactNode + | undefined + children?: React.ReactNode +} + +interface SlotProxyResult<TSlotProps extends object> { + proxy: TSlotProps & SlotPropsBase +} + +/** + * Proxy that turns property access into ClientSlot renders. + * Also tracks accessed slot names for devtools. + */ +function createSlotProxy<TSlotProps extends object>(options?: { + onSlotCall?: (name: string, args: Array<any>) => void +}): SlotProxyResult<TSlotProps> { + const cache = new Map<string, (...args: Array<any>) => React.ReactNode>() + + const proxy = new Proxy({} as TSlotProps & SlotPropsBase, { + get(_target, prop) { + if (prop === 'then' || typeof prop !== 'string') return undefined + + if (prop === 'children') { + options?.onSlotCall?.('children', []) + return createElement(ClientSlot, { slot: 'children', args: [] }) + } + + let fn = cache.get(prop) + if (!fn) { + fn = (...args: Array<any>) => { + options?.onSlotCall?.(prop, args) + return createElement(ClientSlot, { slot: prop, args }) + } + cache.set(prop, fn) + } + return fn + }, + }) + + return { + proxy, + } +} + +function createReadableStreamEmitter<T>(): { + stream: ReadableStream<T> + emit: (value: T) => void + close: () => void +} { + let closed = false + const queue: Array<T> = [] + let controller: ReadableStreamDefaultController<T> | null = null + + const stream = new ReadableStream<T>({ + start(ctrl) { + controller = ctrl + for (const value of queue) { + try { + ctrl.enqueue(value) + } catch { + // Ignore + } + } + queue.length = 0 + if (closed) { + try { + ctrl.close() + } catch { + // Ignore + } + } + }, + cancel() { + closed = true + controller = null + queue.length = 0 + }, + }) + + const emit = (value: T) => { + if (closed) return + if (!controller) { + queue.push(value) + return + } + try { + controller.enqueue(value) + } catch { + // Ignore + } + } + + const close = () => { + if (closed) return + closed = true + if (controller) { + try { + controller.close() + } catch { + // Ignore + } + controller = null + } + } + + return { stream, emit, close } +} + +function wrapReadableStream<T>( + source: ReadableStream<T>, + handlers: { + onDone?: () => void + onCancel?: () => void + onError?: () => void + }, +): ReadableStream<T> { + const reader = source.getReader() + let finished = false + + const finish = () => { + if (finished) return + finished = true + handlers.onDone?.() + try { + reader.releaseLock() + } catch { + // Ignore + } + } + + return new ReadableStream<T>({ + async pull(controller) { + try { + const { value, done } = await reader.read() + if (done) { + controller.close() + finish() + return + } + controller.enqueue(value) + } catch (err) { + try { + controller.error(err) + } catch { + // Ignore + } + handlers.onError?.() + finish() + } + }, + async cancel(reason) { + handlers.onCancel?.() + try { + await reader.cancel(reason) + } catch { + // Ignore + } + finish() + }, + }) +} diff --git a/packages/react-start-rsc/src/createRscProxy.tsx b/packages/react-start-rsc/src/createRscProxy.tsx new file mode 100644 index 0000000000..e5e1481848 --- /dev/null +++ b/packages/react-start-rsc/src/createRscProxy.tsx @@ -0,0 +1,294 @@ +'use client' + +import { createElement } from 'react' +import { RscNodeRenderer } from './RscNodeRenderer' +import { + RENDERABLE_RSC, + RSC_PROXY_GET_TREE, + RSC_PROXY_PATH, + RSC_SLOT_USAGES, + RSC_SLOT_USAGES_STREAM, + SERVER_COMPONENT_CSS_HREFS, + SERVER_COMPONENT_JS_PRELOADS, + SERVER_COMPONENT_STREAM, +} from './ServerComponentTypes' +import type { RscSlotUsageEvent } from './ServerComponentTypes' + +export interface RscProxyOptions { + stream?: unknown // The stream to attach for serialization + cssHrefs?: ReadonlySet<string> // CSS hrefs collected from the RSC stream + jsPreloads?: ReadonlySet<string> // JS hrefs collected from the RSC stream + renderable?: boolean // If true, proxy masquerades as React element + slotUsagesStream?: ReadableStream<RscSlotUsageEvent> // Dev only: slot usage event stream +} + +/** + * Creates a recursive Proxy for RSC data. + * + * If `renderable: true`, returns a React element that can be rendered as `{data}`. + * The element also has proxy-like behavior for nested access like `data.foo.bar`. + * + * If `renderable: false` (default), the proxy is NOT directly renderable and + * must be used with `<CompositeComponent src={...} />`. + */ +export function createRscProxy<T>( + getTree: () => T, + options: RscProxyOptions = {}, +): any { + if (options.renderable) { + // For renderable mode, create a real React element with proxy access + return createRenderableElement( + getTree, + [], + options.stream, + options.cssHrefs, + options.jsPreloads, + ) + } + let slotUsages: Array<RscSlotUsageEvent> | undefined = undefined + + if ( + process.env.NODE_ENV === 'development' && + typeof window !== 'undefined' && + options.slotUsagesStream + ) { + slotUsages = [] + void consumeSlotUsages(options.slotUsagesStream, slotUsages) + } + + // Non-renderable mode: plain proxy + return createRscProxyWithPath( + getTree, + [], + options.stream, + options.cssHrefs, + options.jsPreloads, + slotUsages, + options.slotUsagesStream, + ) +} + +/** + * Creates a React element that's also a Proxy for nested access. + * This is used by renderable RSCs so they work as both {data} and {data.foo.bar}. + */ +type CreateProxyOptions = { + getTree: () => unknown + path: Array<string> + stream: unknown | undefined + cssHrefs: ReadonlySet<string> | undefined + jsPreloads: ReadonlySet<string> | undefined + renderable: boolean + slotUsages: Array<RscSlotUsageEvent> | undefined + slotUsagesStream: ReadableStream<RscSlotUsageEvent> | undefined +} + +const UNHANDLED = Symbol('tanstack.rsc.proxy.unhandled') + +function handleProxyTrap( + kind: 'get' | 'has', + prop: PropertyKey, + options: CreateProxyOptions, +): unknown | boolean | typeof UNHANDLED { + switch (prop) { + // Seroval (>=1.5) uses string sentinels and `in` checks for internal types. + // These proxies must never look like streams/sequences. + case '__SEROVAL_STREAM__': + case '__SEROVAL_SEQUENCE__': + return kind === 'get' ? undefined : false + + // Seroval >=1.5 also checks iterability via `Symbol.iterator in value`. + case Symbol.iterator: + case Symbol.asyncIterator: + return kind === 'get' ? undefined : false + + // Our proxy branding/properties + case SERVER_COMPONENT_STREAM: + return kind === 'get' ? options.stream : options.stream !== undefined + case SERVER_COMPONENT_CSS_HREFS: + return kind === 'get' ? options.cssHrefs : options.cssHrefs !== undefined + case SERVER_COMPONENT_JS_PRELOADS: + return kind === 'get' + ? options.jsPreloads + : options.jsPreloads !== undefined + case RSC_PROXY_GET_TREE: + return kind === 'get' ? options.getTree : true + case RSC_PROXY_PATH: + return kind === 'get' ? options.path : true + case RENDERABLE_RSC: + return kind === 'get' ? options.renderable : true + case RSC_SLOT_USAGES: + return kind === 'get' + ? options.slotUsages + : options.slotUsages !== undefined + + case RSC_SLOT_USAGES_STREAM: + return kind === 'get' + ? options.slotUsagesStream + : options.slotUsagesStream !== undefined + + // Avoid promise-like checks + case 'then': + return kind === 'get' ? undefined : UNHANDLED + + // Avoid breaking primitive coercion (eg String(proxy)). + // Without these, nested-selection proxies can shadow these keys and + // cause `Cannot convert object to primitive value` errors. + case 'toString': + return kind === 'get' ? Object.prototype.toString : UNHANDLED + case 'valueOf': + return kind === 'get' ? Object.prototype.valueOf : UNHANDLED + case 'constructor': + return kind === 'get' ? Object : UNHANDLED + } + + // Non-renderable proxies claim all string keys exist for nested selection, + // but symbol presence checks should be accurate. + if (typeof prop === 'symbol') { + return kind === 'get' ? undefined : false + } + + return UNHANDLED +} + +function createRscProxyInternal(options: CreateProxyOptions): any { + // Per-proxy cache so repeated property access is referentially stable. + const childCache = new Map<string, any>() + + const getChild = (key: string) => { + const cached = childCache.get(key) + if (cached) return cached + + const next = createRscProxyInternal({ + ...options, + path: [...options.path, key], + }) + childCache.set(key, next) + return next + } + + const dataProxy = options.renderable + ? createRscProxyInternal({ ...options, renderable: false }) + : undefined + + // Use a React element (renderable) or plain object (non-renderable) as Proxy target. + const proxyTarget = options.renderable + ? createElement(RscNodeRenderer, { data: dataProxy }) + : ({} as any) + + return new Proxy(proxyTarget, { + get(target, prop) { + const handled = handleProxyTrap('get', prop, options) + if (handled !== UNHANDLED) return handled + + if (options.renderable) { + // Proxy invariants: if target has a non-configurable, read-only property, + // we must return the *exact* value for that property. + if (prop === 'props') { + return target.props + } + + if (prop === 'data') { + return dataProxy + } + + if (prop in target) { + return target[prop] + } + } + + return getChild(String(prop)) + }, + + has(target, prop) { + const handled = handleProxyTrap('has', prop, options) + if (handled !== UNHANDLED) return handled as boolean + + if (options.renderable) { + if (prop in target) return true + if (typeof prop === 'string') return true + return false + } + + // Allow any property access for nested selection. + return true + }, + + getPrototypeOf(target) { + return options.renderable + ? Object.getPrototypeOf(target) + : Object.prototype + }, + + getOwnPropertyDescriptor(target, prop) { + return options.renderable + ? Object.getOwnPropertyDescriptor(target, prop) + : undefined + }, + + ownKeys(target) { + return options.renderable ? Reflect.ownKeys(target) : [] + }, + }) +} + +/** + * Creates a React element that's also a Proxy for nested access. + * This is used by renderable RSCs so they work as both {data} and {data.foo.bar}. + */ +function createRenderableElement( + getTree: () => unknown, + path: Array<string>, + stream: unknown | undefined, + cssHrefs: ReadonlySet<string> | undefined, + jsPreloads: ReadonlySet<string> | undefined, +): any { + return createRscProxyInternal({ + getTree, + path, + stream, + cssHrefs, + jsPreloads, + renderable: true, + slotUsages: undefined, + slotUsagesStream: undefined, + }) +} + +function createRscProxyWithPath( + getTree: () => unknown, + path: Array<string>, + stream: unknown | undefined, + cssHrefs: ReadonlySet<string> | undefined, + jsPreloads: ReadonlySet<string> | undefined, + slotUsages: Array<RscSlotUsageEvent> | undefined, + slotUsagesStream: ReadableStream<RscSlotUsageEvent> | undefined, +): any { + return createRscProxyInternal({ + getTree, + path, + stream, + cssHrefs, + jsPreloads, + renderable: false, + slotUsages, + slotUsagesStream, + }) +} + +async function consumeSlotUsages( + stream: ReadableStream<RscSlotUsageEvent>, + slotUsages: Array<RscSlotUsageEvent>, +): Promise<void> { + try { + const reader = stream.getReader() + for (;;) { + const { value, done } = await reader.read() + if (done) break + if (!value.slot) continue + slotUsages.push(value) + } + } catch { + // Ignore - dev-only best effort + } +} diff --git a/packages/react-start-rsc/src/createServerComponentFromStream.ts b/packages/react-start-rsc/src/createServerComponentFromStream.ts new file mode 100644 index 0000000000..2616b96f44 --- /dev/null +++ b/packages/react-start-rsc/src/createServerComponentFromStream.ts @@ -0,0 +1,138 @@ +'use client' + +import { use } from 'react' +import { trackPostProcessPromise } from '@tanstack/start-client-core' +import { createFromReadableStream as browserDecode } from 'virtual:tanstack-rsc-browser-decode' + +import { awaitLazyElements } from './awaitLazyElements' +import { createRscProxy } from './createRscProxy' +import { unwrapRscCssEnvelope } from './rscCssEnvelope' +import type { + AnyCompositeComponent, + RscSlotUsageEvent, + ServerComponentStream, +} from './ServerComponentTypes' + +type StreamDecodeOptions = { + cssHrefs?: Iterable<string> + jsPreloads?: Iterable<string> +} + +/** + * Creates a renderable RSC proxy from a raw Flight stream. + * Client-side only - used by the client serialization adapter for `renderServerComponent`. + * + * Returns a Proxy that: + * - Can be rendered directly as `{data}` in JSX + * - Supports nested access: `{data.foo.bar}` + * - Masquerades as a React element + */ +export function createRenderableFromStream( + stream: ReadableStream<Uint8Array>, + options?: StreamDecodeOptions, +): any { + const { getTree, streamWrapper, cssHrefs, jsPreloads } = setupStreamDecode( + stream, + options, + ) + + return createRscProxy(getTree, { + stream: streamWrapper, + cssHrefs, + jsPreloads, + renderable: true, + }) +} + +/** + * Creates a composite RSC proxy from a raw Flight stream. + * Client-side only - used by the client serialization adapter for `createCompositeComponent`. + * + * Returns a Proxy that: + * - NOT directly renderable + * - Supports nested access: `src.foo.bar` + * - Must be rendered via `<CompositeComponent src={...} />` + */ +export function createCompositeFromStream( + stream: ReadableStream<Uint8Array>, + options?: { + slotUsagesStream?: ReadableStream<RscSlotUsageEvent> + } & StreamDecodeOptions, +): AnyCompositeComponent { + const { getTree, streamWrapper, cssHrefs, jsPreloads } = setupStreamDecode( + stream, + options, + ) + + return createRscProxy(getTree, { + stream: streamWrapper, + cssHrefs, + jsPreloads, + renderable: false, + slotUsagesStream: options?.slotUsagesStream, + }) +} + +/** + * Shared stream decode setup for both renderable and composite. + */ +function setupStreamDecode( + stream: ReadableStream<Uint8Array>, + options?: StreamDecodeOptions, +): { + getTree: () => unknown + streamWrapper: ServerComponentStream + cssHrefs: Set<string> + jsPreloads: Set<string> | undefined +} { + const cssHrefs = new Set(options?.cssHrefs ?? []) + const jsPreloads = options?.jsPreloads + ? new Set(options.jsPreloads) + : undefined + const shouldDeferDecode = cssHrefs.size > 0 || !!jsPreloads?.size + + // Synchronous cache for the decoded tree. + let cachedTree: unknown = undefined + let cacheReady = false + let transformedTreePromise: Promise<unknown> | undefined + + const startDecode = () => { + if (!transformedTreePromise) { + // Promise for the tree with lazy elements awaited. + transformedTreePromise = Promise.resolve(browserDecode(stream)).then( + async (result) => { + await awaitLazyElements(result, (href) => { + cssHrefs.add(href) + }) + cachedTree = unwrapRscCssEnvelope(result) + cacheReady = true + return cachedTree + }, + ) + + // Track the lazy element loading - prevents flash for RPC/RSC fetches. + trackPostProcessPromise(transformedTreePromise) + } + + return transformedTreePromise + } + + if (!shouldDeferDecode) { + // Start decoding eagerly during deserialization for non-SSR streams. + startDecode() + } + + const streamWrapper: ServerComponentStream = { + createReplayStream: () => stream, + } + + const getTree = () => { + if (cacheReady) return cachedTree + // eslint-disable-next-line react-hooks/rules-of-hooks + return use(startDecode()) + } + + return { getTree, streamWrapper, cssHrefs, jsPreloads } +} +// Legacy export for backwards compatibility during migration +export const createServerComponentFromStream = createCompositeFromStream diff --git a/packages/react-start-rsc/src/entry/rsc.tsx b/packages/react-start-rsc/src/entry/rsc.tsx new file mode 100644 index 0000000000..be20ea26af --- /dev/null +++ b/packages/react-start-rsc/src/entry/rsc.tsx @@ -0,0 +1,23 @@ +/** + * Shared RSC (React Server Components) entry point. + * + * This file exports the functions needed for the active RSC environment: + * - getServerFnById: Resolves server functions by their encoded ID + * - render: Renders a React node to an RSC Flight stream + */ + +import { renderToReadableStream } from 'virtual:tanstack-rsc-runtime' +import type React from 'react' + +// Re-export getServerFnById from the virtual module which handles both dev and production +// In dev: dynamic import with base64url-decoded file path +// In production: manifest-based lookup with bundled chunks +export { getServerFnById } from '#tanstack-start-server-fn-resolver' + +/** + * Renders a React node to an RSC Flight stream. + * Used internally for streaming server component output. + */ +export function render(node: React.ReactNode): ReadableStream<Uint8Array> { + return renderToReadableStream(node) +} diff --git a/packages/react-start-rsc/src/entry/virtual-modules.d.ts b/packages/react-start-rsc/src/entry/virtual-modules.d.ts new file mode 100644 index 0000000000..00f2a2ee02 --- /dev/null +++ b/packages/react-start-rsc/src/entry/virtual-modules.d.ts @@ -0,0 +1,12 @@ +// Type declarations for virtual modules used in RSC entry +// These modules are provided by the active bundler adapter at runtime + +declare module '#tanstack-start-server-fn-resolver' { + export type ServerFnLookupAccess = { origin: 'client' } | { origin: 'server' } + + export type ServerFn = (...args: Array<any>) => Promise<any> + export function getServerFnById( + id: string, + access: ServerFnLookupAccess, + ): Promise<ServerFn> +} diff --git a/packages/react-start-rsc/src/flight.rsc.ts b/packages/react-start-rsc/src/flight.rsc.ts new file mode 100644 index 0000000000..8fabd523e2 --- /dev/null +++ b/packages/react-start-rsc/src/flight.rsc.ts @@ -0,0 +1,17 @@ +/** + * Low-level Flight stream API for RSC (React Server Components) environment. + * + * This exports renderToReadableStream which generates a Flight stream from + * React elements. Only available in RSC context (react-server condition). + * + * @example + * ```tsx + * import { renderToReadableStream } from '@tanstack/react-start/rsc' + * + * const stream = renderToReadableStream(<MyServerComponent />) + * return new Response(stream, { + * headers: { 'Content-Type': 'text/x-component' } + * }) + * ``` + */ +export { renderToReadableStream } from 'virtual:tanstack-rsc-runtime' diff --git a/packages/react-start-rsc/src/flight.stub.ts b/packages/react-start-rsc/src/flight.stub.ts new file mode 100644 index 0000000000..872eec6f10 --- /dev/null +++ b/packages/react-start-rsc/src/flight.stub.ts @@ -0,0 +1,15 @@ +/** + * Client stub for renderToReadableStream. + * + * This function should never be called at runtime on the client. + * It exists only to provide types for bundler imports in client bundles. + * The real implementation only runs inside RSC context (server functions). + */ +export function renderToReadableStream( + _node: React.ReactNode, +): ReadableStream<Uint8Array> { + throw new Error( + 'renderToReadableStream cannot be called on the client. ' + + 'This function should only be called inside RSC context (server functions).', + ) +} diff --git a/packages/react-start-rsc/src/flight.ts b/packages/react-start-rsc/src/flight.ts new file mode 100644 index 0000000000..1639120322 --- /dev/null +++ b/packages/react-start-rsc/src/flight.ts @@ -0,0 +1,68 @@ +/** + * Low-level Flight stream APIs for decoding RSC streams. + * + * These functions provide direct access to RSC Flight stream decoding, + * allowing advanced use cases like: + * - Server functions returning raw Flight Response + * - API routes streaming Flight payloads + * - Custom Flight stream handling via RawStream + * + * `createFromReadableStream` works in both SSR and browser contexts. + * `createFromFetch` is browser-only. + * + * NOTE: Dynamic imports keep decode initialisation runtime-specific. The + * concrete implementation comes from bundler-owned virtual modules. + */ + +import { + createClientOnlyFn, + createIsomorphicFn, +} from '@tanstack/start-fn-stubs' + +/** + * Decode a Flight stream into React elements. + * Works in both SSR and browser contexts. + * + * @example + * ```tsx + * const rawStream = await getRscRawStream() + * const tree = await createFromReadableStream(rawStream) + * return <>{tree}</> + * ``` + */ +export const createFromReadableStream = createIsomorphicFn() + .server( + async (stream: ReadableStream<Uint8Array>): Promise<React.ReactNode> => { + const { createFromReadableStream: decode } = + await import('virtual:tanstack-rsc-ssr-decode') + return decode(stream) as React.ReactNode + }, + ) + .client( + async (stream: ReadableStream<Uint8Array>): Promise<React.ReactNode> => { + const { createFromReadableStream: decode } = + await import('virtual:tanstack-rsc-browser-decode') + return decode(stream) + }, + ) + +/** + * Decode a Flight stream from a fetch Response. + * Browser only - will throw if called on the server. + * + * @example + * ```tsx + * // From server function returning raw Response + * const tree = await createFromFetch(getFlightResponse()) + * + * // From API route + * const tree = await createFromFetch(fetch('/api/rsc-flight')) + * ``` + */ +export const createFromFetch = createClientOnlyFn( + async (fetchPromise: Promise<Response>): Promise<React.ReactNode> => { + const { createFromFetch: decode } = + await import('virtual:tanstack-rsc-browser-decode') + return decode(fetchPromise) + }, +) diff --git a/packages/react-start-rsc/src/global.d.ts b/packages/react-start-rsc/src/global.d.ts new file mode 100644 index 0000000000..258d41eb5c --- /dev/null +++ b/packages/react-start-rsc/src/global.d.ts @@ -0,0 +1,99 @@ +/// <reference types="vite/client" /> + +declare module '@rspack/core/rsc/ssr' { + export function setOnClientReference( + callback: + | ((reference: { + id: string + deps: { js: Array<string>; css: Array<string> } + runtime: 'rsbuild' + }) => void) + | null + | undefined, + ): void + export function getManifest(): { + moduleCssFiles?: Record<string, Array<string>> + [key: string]: unknown + } +} + +declare module '@rspack/core/rsc/browser' { + export function getManifest(): { + moduleCssFiles?: Record<string, Array<string>> + [key: string]: unknown + } +} + +/** + * Type declarations for virtual:tanstack-rsc-runtime + * + * This virtual module is provided by the active Start bundler adapter + * and re-exports RSC runtime functions from that adapter's Flight runtime. + * + * Using a virtual module allows the imports to be resolved at runtime within + * the correct server environment context (react-server conditions). + */ +declare module 'virtual:tanstack-rsc-runtime' { + export function renderToReadableStream<T>( + data: T, + options?: object, + ): ReadableStream<Uint8Array> + export function createFromReadableStream<T = unknown>( + stream: ReadableStream<Uint8Array>, + options?: object, + ): Promise<T> + export function createTemporaryReferenceSet(): object + export function decodeReply<T = unknown>( + body: string | FormData, + options?: object, + ): Promise<T> + export function loadServerAction(id: string): Promise<(...args: any) => any> + export function decodeAction<T = unknown>( + body: FormData, + serverManifest?: unknown, + ): Promise<() => T> + export function decodeFormState<T = unknown>( + actionResult: T, + body: FormData, + serverManifest?: unknown, + ): Promise<unknown> +} + +declare module 'virtual:tanstack-rsc-browser-decode' { + export function createFromReadableStream<T = unknown>( + stream: ReadableStream<Uint8Array>, + options?: object, + ): Promise<T> + export function createFromFetch<T = unknown>( + response: Promise<Response>, + ): Promise<T> +} + +declare module 'virtual:tanstack-rsc-ssr-decode' { + export function setOnClientReference( + callback: + | ((reference: { + id: string + deps: { js: Array<string>; css: Array<string> } + runtime?: 'rsbuild' + }) => void) + | undefined, + ): void + export function createFromReadableStream<T = unknown>( + stream: ReadableStream<Uint8Array>, + options?: object, + ): Promise<T> +} + +/** + * Type declarations for virtual:tanstack-rsc-hmr + * + * This virtual module is provided by the active Start bundler adapter + * and sets up the RSC HMR listener in dev mode. It listens for 'rsc:update' + * events and invalidates the router to refetch server components. + * + * In production builds, this module is empty. + */ +declare module 'virtual:tanstack-rsc-hmr' { + export function setupRscHmr(): void +} diff --git a/packages/react-start-rsc/src/index.rsc.ts b/packages/react-start-rsc/src/index.rsc.ts new file mode 100644 index 0000000000..6873fc4a0e --- /dev/null +++ b/packages/react-start-rsc/src/index.rsc.ts @@ -0,0 +1,31 @@ +// Server-side exports (react-server condition) +// This file is used when importing from RSC (React Server Components) context + +// Types are always available +export type { + AnyCompositeComponent, + AnyRenderableServerComponent, + RenderableServerComponent, + RenderableServerComponentAttributes, + RenderableServerComponentBuilder, +} from './ServerComponentTypes' + +// New API: renderServerComponent - renders element to renderable proxy +export { renderServerComponent } from './renderServerComponent.js' + +// New API: createCompositeComponent - creates composite with slot support +export { createCompositeComponent } from './createCompositeComponent.js' + +// Renderer for composite RSC data (client/SSR) +export { CompositeComponent } from './CompositeComponent.js' + +// Low-level Flight stream API (RSC only) +export { renderToReadableStream } from './flight.rsc.js' + +// Low-level Flight stream APIs (also available in RSC for decode operations) +export { createFromReadableStream, createFromFetch } from './flight' + +// Note: rscSerializationAdapter is intentionally NOT exported here. +// It uses createSerializationAdapter from react-router which is marked as +// client-only in RSC environment. The adapter is only needed by SSR/client +// for serializing/deserializing server components, not by RSC itself. diff --git a/packages/react-start-rsc/src/index.ts b/packages/react-start-rsc/src/index.ts new file mode 100644 index 0000000000..f70e324082 --- /dev/null +++ b/packages/react-start-rsc/src/index.ts @@ -0,0 +1,32 @@ +// Default exports (used by client bundles and SSR) +// This file is used when importing outside of RSC (React Server Components) context + +// Types are always available +export type { + AnyCompositeComponent, + AnyRenderableServerComponent, + RenderableServerComponent, + RenderableServerComponentAttributes, + RenderableServerComponentBuilder, +} from './ServerComponentTypes' + +// CSS hrefs symbol for type-safe access +export { SERVER_COMPONENT_CSS_HREFS } from './ServerComponentTypes' + +// Stubs for RSC-only functions - throw if called outside RSC context +export { renderServerComponent } from './renderServerComponent.stub.js' +export { createCompositeComponent } from './createCompositeComponent.stub.js' + +// Renderer for composite RSC data (client/SSR) +export { CompositeComponent } from './CompositeComponent.js' + +// Low-level Flight stream APIs (client/SSR) +export { createFromReadableStream, createFromFetch } from './flight' + +// Stub for renderToReadableStream - throws if called outside RSC context +export { renderToReadableStream } from './flight.stub.js' + +// Note: rscSerializationAdapter is intentionally NOT exported here. +// It imports virtual:tanstack-rsc-hmr which is client-only (not available in SSR). +// Import directly from '@tanstack/react-start-rsc/serialization.client' or +// '@tanstack/react-start-rsc/serialization.server' as needed. diff --git a/packages/react-start-rsc/src/plugin/rscCssTransform.ts b/packages/react-start-rsc/src/plugin/rscCssTransform.ts new file mode 100644 index 0000000000..15b882ccd7 --- /dev/null +++ b/packages/react-start-rsc/src/plugin/rscCssTransform.ts @@ -0,0 +1,150 @@ +import type { + StartCompilerImportTransform, + StartCompilerTransformContext, +} from '@tanstack/start-plugin-core' + +const TSS_SERVERFN_SPLIT_PARAM = 'tss-serverfn-split' +const RSC_CSS_OPTIONS_KEY = '__tanstackStartRscCss' + +type BabelTypes = StartCompilerTransformContext['types'] +type BabelExpression = ReturnType< + StartCompilerTransformContext['parseExpression'] +> + +type RscCssTransformKind = + | 'renderServerComponent' + | 'createCompositeComponent' + | 'renderToReadableStream' + +export function createRscCssCompilerTransforms(opts: { + loadCssExpression: string + serverFnProviderOnly?: boolean | undefined +}): Array<StartCompilerImportTransform> { + let loadCssExpression: BabelExpression | undefined + + const getLoadCssExpression = (context: StartCompilerTransformContext) => { + loadCssExpression ??= context.parseExpression(opts.loadCssExpression) + return loadCssExpression + } + + return [ + createRscCssCompilerTransform({ + serverFnProviderOnly: opts.serverFnProviderOnly, + getLoadCssExpression, + kind: 'renderServerComponent', + name: 'react-rsc-render-server-component-css', + }), + createRscCssCompilerTransform({ + serverFnProviderOnly: opts.serverFnProviderOnly, + getLoadCssExpression, + kind: 'createCompositeComponent', + name: 'react-rsc-create-composite-component-css', + }), + createRscCssCompilerTransform({ + serverFnProviderOnly: opts.serverFnProviderOnly, + getLoadCssExpression, + kind: 'renderToReadableStream', + name: 'react-rsc-render-to-readable-stream-css', + }), + ] +} + +function createRscCssCompilerTransform(opts: { + name: string + kind: RscCssTransformKind + getLoadCssExpression: ( + context: StartCompilerTransformContext, + ) => BabelExpression + serverFnProviderOnly?: boolean | undefined +}): StartCompilerImportTransform { + return { + name: opts.name, + environment: 'server', + imports: [ + { + libName: '@tanstack/react-start/rsc', + rootExport: opts.kind, + }, + { + libName: '@tanstack/react-start-rsc', + rootExport: opts.kind, + }, + ], + detect: new RegExp(`\\b${opts.kind}\\b`), + transform: (candidates, context) => { + if ( + opts.serverFnProviderOnly && + !context.id.includes(TSS_SERVERFN_SPLIT_PARAM) + ) { + return + } + + const t = context.types + const loadCssExpression = opts.getLoadCssExpression(context) + const cloneLoadCssExpression = () => t.cloneNode(loadCssExpression) + + for (const candidate of candidates) { + const args = candidate.path.node.arguments + if (args.length !== 1) continue + + if (opts.kind === 'renderToReadableStream') { + const firstArg = args[0] + if (!firstArg || !t.isExpression(firstArg)) continue + if (!isTopLevelJsx(t, firstArg)) continue + + args[0] = createCssFragment( + t, + firstArg, + cloneLoadCssExpression(), + ) as typeof firstArg + continue + } + + args.push( + t.objectExpression([ + t.objectProperty( + t.identifier(RSC_CSS_OPTIONS_KEY), + cloneLoadCssExpression(), + ), + ]), + ) + } + }, + } +} + +function isTopLevelJsx(t: BabelTypes, expr: BabelExpression): boolean { + const unwrapped = unwrapTransparentExpression(t, expr) + return t.isJSXElement(unwrapped) || t.isJSXFragment(unwrapped) +} + +function unwrapTransparentExpression( + t: BabelTypes, + expr: BabelExpression, +): BabelExpression { + let current = expr + while ( + t.isParenthesizedExpression(current) || + t.isTSAsExpression(current) || + t.isTSSatisfiesExpression(current) || + t.isTSTypeAssertion(current) || + t.isTSNonNullExpression(current) + ) { + current = current.expression + } + return current +} + +function createCssFragment( + t: BabelTypes, + original: BabelExpression, + loadCssExpression: BabelExpression, +) { + const unwrapped = unwrapTransparentExpression(t, original) + return t.jsxFragment(t.jsxOpeningFragment(), t.jsxClosingFragment(), [ + t.jsxExpressionContainer(loadCssExpression), + t.isJSXElement(unwrapped) || t.isJSXFragment(unwrapped) + ? unwrapped + : t.jsxExpressionContainer(original), + ]) +} diff --git a/packages/react-start-rsc/src/plugin/vite.ts b/packages/react-start-rsc/src/plugin/vite.ts new file mode 100644 index 0000000000..90da9d8b96 --- /dev/null +++ b/packages/react-start-rsc/src/plugin/vite.ts @@ -0,0 +1,238 @@ +import { fileURLToPath } from 'node:url' +import path from 'pathe' +import { createVirtualModule } from '@tanstack/start-plugin-core/vite' +import { createRscCssCompilerTransforms } from './rscCssTransform' +import type { + TanStackStartVitePluginCoreOptions, + ViteRscForwardSsrResolverStrategy, +} from '@tanstack/start-plugin-core/vite' +import type { PluginOption, UserConfig } from 'vite' + +const isClientEnvironment = (env: { config: { consumer: string } }) => + env.config.consumer === 'client' + +// Virtual module ids used by the React Start RSC runtime. +const RSC_HMR_VIRTUAL_ID = 'virtual:tanstack-rsc-hmr' +const RSC_RUNTIME_VIRTUAL_ID = 'virtual:tanstack-rsc-runtime' +const RSC_BROWSER_DECODE_VIRTUAL_ID = 'virtual:tanstack-rsc-browser-decode' +const RSC_SSR_DECODE_VIRTUAL_ID = 'virtual:tanstack-rsc-ssr-decode' +const RSC_ENV_NAME = 'rsc' + +const currentDir = path.dirname(fileURLToPath(import.meta.url)) +const entryDir = path.resolve(currentDir, '..', '..', 'plugin', 'entry') +const rscEntryPath = path.resolve(entryDir, 'rsc.tsx') + +export function configureRsc(): { + envName: string + providerEnvironmentName: TanStackStartVitePluginCoreOptions['providerEnvironmentName'] + ssrResolverStrategy: TanStackStartVitePluginCoreOptions['ssrResolverStrategy'] + serializationAdapters: TanStackStartVitePluginCoreOptions['serializationAdapters'] + compilerTransforms: TanStackStartVitePluginCoreOptions['compilerTransforms'] +} { + const serializationAdapters: TanStackStartVitePluginCoreOptions['serializationAdapters'] = + [ + // IMPORTANT: plugin-adapters-plugin only calls the top-level factory once. + // That factory must return a flat array of adapters (not nested arrays), + // otherwise router-core ends up with non-adapter entries and Seroval crashes. + { + client: { + module: '@tanstack/react-start/rsc/serialization/client', + export: 'rscSerializationAdapter', + isFactory: true, + }, + server: { + module: '@tanstack/react-start/rsc/serialization/server', + export: 'rscSerializationAdapter', + isFactory: true, + }, + }, + ] + const ssrResolverStrategy = { + type: 'vite-rsc-forward', + sourceEnvironmentName: RSC_ENV_NAME, + sourceEntry: 'index', + exportName: 'getServerFnById', + } satisfies ViteRscForwardSsrResolverStrategy + return { + envName: RSC_ENV_NAME, + providerEnvironmentName: RSC_ENV_NAME, + ssrResolverStrategy, + serializationAdapters, + compilerTransforms: createRscCssCompilerTransforms({ + loadCssExpression: 'import.meta.viteRsc.loadCss()', + }), + } +} +export function reactStartRscVitePlugin(): PluginOption { + return [ + // When RSC is enabled, SSR needs noExternal: true to ensure single React instance. + // The RSC decoder's dynamic imports for client components can cause module duplication + // without this, leading to "Invalid hook call" errors. + // We use the top-level `ssr` config option as `environments.ssr.resolve.noExternal` + // doesn't have the same effect. + { + name: 'tanstack-react-start:rsc-ssr-config', + config() { + return { + ssr: { + noExternal: true, + }, + } + }, + }, + { + name: 'tanstack-react-start:rsc-env-config', + config() { + return { + rsc: { + // Disable @vitejs/plugin-rsc's built-in server handler middleware. + // TanStack Start has its own request handling via the SSR environment. + serverHandler: false, + // Disable CSS link precedence to prevent React 19 SSR suspension + // TanStack Start handles CSS preloading via manifest injection instead + cssLinkPrecedence: false, + }, + environments: { + [RSC_ENV_NAME]: { + consumer: 'server', + // Force @tanstack packages to be processed by Vite as source code + // rather than treated as external modules. This ensures: + // 1. createIsomorphicFn transforms are applied + // 2. Imports are resolved within the RSC environment context + // with proper react-server conditions and pre-bundled deps + resolve: { + noExternal: [ + '@tanstack/start**', + '@tanstack/react-start', + '@tanstack/react-start-rsc', + '@tanstack/react-router', + ], + }, + build: { + rollupOptions: { + input: { + index: rscEntryPath, + }, + }, + }, + }, + }, + } satisfies UserConfig & { + rsc: { + serverHandler: false + cssLinkPrecedence?: boolean + } + } + }, + }, + + { + name: 'tanstack-react-start:rsc-scan-virtual-fallback', + apply: 'build', + applyToEnvironment(env) { + return env.name === RSC_ENV_NAME + }, + load: { + filter: { + id: /^(virtual:tanstack-rsc-runtime|virtual:vite-rsc\/encryption-key)$/, + }, + handler(id) { + if (this.environment.config.build.write !== false) return + + if (id === RSC_RUNTIME_VIRTUAL_ID) { + return `export { renderToReadableStream, createFromReadableStream, createTemporaryReferenceSet, decodeReply, loadServerAction, decodeAction, decodeFormState } from '@vitejs/plugin-rsc/rsc'` + } + + if (id === 'virtual:vite-rsc/encryption-key') { + return `export default () => ''` + } + + return undefined + }, + }, + }, + + // Runtime bridge into the Vite RSC environment. + createVirtualModule({ + name: 'tanstack-react-start:rsc-runtime-virtual', + moduleId: RSC_RUNTIME_VIRTUAL_ID, + load() { + const envName = this.environment.name + if (envName === RSC_ENV_NAME) { + return `export { renderToReadableStream, createFromReadableStream, createTemporaryReferenceSet, decodeReply, loadServerAction, decodeAction, decodeFormState } from '@vitejs/plugin-rsc/rsc'` + } + return ` +export function renderToReadableStream() { throw new Error('renderToReadableStream can only be used in RSC environment'); } +export function createFromReadableStream() { throw new Error('createFromReadableStream can only be used in RSC environment'); } +export function createTemporaryReferenceSet() { throw new Error('createTemporaryReferenceSet can only be used in RSC environment'); } +export function decodeReply() { throw new Error('decodeReply can only be used in RSC environment'); } +export function loadServerAction() { throw new Error('loadServerAction can only be used in RSC environment'); } +export function decodeAction() { throw new Error('decodeAction can only be used in RSC environment'); } +export function decodeFormState() { throw new Error('decodeFormState can only be used in RSC environment'); } +` + }, + }), + createVirtualModule({ + name: 'tanstack-react-start:rsc-browser-decode-virtual', + moduleId: RSC_BROWSER_DECODE_VIRTUAL_ID, + load() { + return `export { createFromReadableStream, createFromFetch } from '@vitejs/plugin-rsc/browser'` + }, + }), + createVirtualModule({ + name: 'tanstack-react-start:rsc-ssr-decode-virtual', + moduleId: RSC_SSR_DECODE_VIRTUAL_ID, + load() { + return `export { setOnClientReference, createFromReadableStream } from '@vitejs/plugin-rsc/ssr'` + }, + }), + createVirtualModule({ + name: 'tanstack-react-start:rsc-hmr-virtual:dev', + moduleId: RSC_HMR_VIRTUAL_ID, + apply: 'serve', + applyToEnvironment: isClientEnvironment, + load() { + return ` +export function setupRscHmr() { +if (!import.meta.hot) { + return +} + + let __invalidateQueued = false + + function __queueInvalidate() { + if (__invalidateQueued) return + __invalidateQueued = true + queueMicrotask(async () => { + __invalidateQueued = false + try { + const router = window.__TSR_ROUTER__ + if (!router) { + console.warn('[rsc:hmr] No router found on window.__TSR_ROUTER__') + return + } + await router.invalidate() + } catch (e) { + console.warn('[rsc:hmr] Failed to invalidate router:', e) + } + }) + } + + import.meta.hot.on('rsc:update', () => { + __queueInvalidate() + }) +} +` + }, + }), + createVirtualModule({ + name: 'tanstack-react-start:rsc-hmr-virtual:prod', + moduleId: RSC_HMR_VIRTUAL_ID, + applyToEnvironment: isClientEnvironment, + apply: 'build', + load() { + return 'export function setupRscHmr() {} ' + }, + }), + ] +} diff --git a/packages/react-start-rsc/src/react-server-dom-rspack.d.ts b/packages/react-start-rsc/src/react-server-dom-rspack.d.ts new file mode 100644 index 0000000000..3507e6368f --- /dev/null +++ b/packages/react-start-rsc/src/react-server-dom-rspack.d.ts @@ -0,0 +1,57 @@ +/** + * Type declarations for react-server-dom-rspack. + * + * This package ships no .d.ts files. Declarations here cover only the + * subset of the API surface that TanStack Start uses. + */ + +declare module 'react-server-dom-rspack/client.node' { + export function createFromReadableStream<T = unknown>( + stream: ReadableStream<Uint8Array>, + options?: object, + ): Promise<T> +} + +declare module 'react-server-dom-rspack/client.browser' { + export function createFromReadableStream<T = unknown>( + stream: ReadableStream<Uint8Array>, + options?: object, + ): Promise<T> + + export function createFromFetch<T = unknown>( + fetchPromise: Promise<Response>, + options?: object, + ): Promise<T> +} + +declare module 'react-server-dom-rspack/server' { + export function renderToReadableStream<T>( + data: T, + options?: object, + ): ReadableStream<Uint8Array> + + export function createFromReadableStream<T = unknown>( + stream: ReadableStream<Uint8Array>, + options?: object, + ): Promise<T> + + export function createTemporaryReferenceSet(): object + + export function decodeReply<T = unknown>( + body: string | FormData, + options?: object, + ): Promise<T> + + export function loadServerAction(id: string): Promise<(...args: any) => any> + + export function decodeAction<T = unknown>( + body: FormData, + serverManifest?: unknown, + ): Promise<() => T> + + export function decodeFormState<T = unknown>( + actionResult: T, + body: FormData, + serverManifest?: unknown, + ): Promise<unknown> +} diff --git a/packages/react-start-rsc/src/reactSymbols.ts b/packages/react-start-rsc/src/reactSymbols.ts new file mode 100644 index 0000000000..c4349a6afc --- /dev/null +++ b/packages/react-start-rsc/src/reactSymbols.ts @@ -0,0 +1,6 @@ +// Inline React 19 internal $$typeof symbols to avoid depending on `react-is`. +// `react-is` is CJS-only, causing module resolution failures in strict pnpm +// setups where it can't be resolved from the consumer's node_modules. +export const ReactElement = Symbol.for('react.transitional.element') +export const ReactLazy = Symbol.for('react.lazy') +export const ReactSuspense = Symbol.for('react.suspense') diff --git a/packages/react-start-rsc/src/renderServerComponent.stub.ts b/packages/react-start-rsc/src/renderServerComponent.stub.ts new file mode 100644 index 0000000000..aefff84206 --- /dev/null +++ b/packages/react-start-rsc/src/renderServerComponent.stub.ts @@ -0,0 +1,26 @@ +import type { + RenderableServerComponentBuilder, + ValidateRenderableServerComponent, +} from './ServerComponentTypes' + +/** + * Client stub for renderServerComponent. + * + * This function should never be called at runtime on the client. + * It exists only to satisfy bundler imports in client bundles. + * The real implementation only runs inside server functions. + */ +export function renderServerComponent<TNode>( + _node: ValidateRenderableServerComponent<TNode>, +): Promise<RenderableServerComponentBuilder<TNode>> { + // Unit/type tests import this stub directly and call it. + // Avoid throwing in that environment while keeping a hard runtime guard elsewhere. + if (process.env.NODE_ENV === 'test') { + return Promise.resolve(null as any) + } + + throw new Error( + 'renderServerComponent cannot be called on the client. ' + + 'This function should only be called inside a server function or route loader.', + ) +} diff --git a/packages/react-start-rsc/src/renderServerComponent.ts b/packages/react-start-rsc/src/renderServerComponent.ts new file mode 100644 index 0000000000..d282d63111 --- /dev/null +++ b/packages/react-start-rsc/src/renderServerComponent.ts @@ -0,0 +1,113 @@ +import { renderToReadableStream } from 'virtual:tanstack-rsc-runtime' +import { getRequest } from '@tanstack/start-server-core' +import { getStartContext } from '@tanstack/start-storage-context' +import { ReplayableStream } from './ReplayableStream' +import { RENDERABLE_RSC, SERVER_COMPONENT_STREAM } from './ServerComponentTypes' +import { createRscCssEnvelope } from './rscCssEnvelope' +import type { + AnyRenderableServerComponent, + RenderableServerComponentBuilder, + ServerComponentStream, + ValidateRenderableServerComponent, +} from './ServerComponentTypes' +import type { RscCssEnvelopeOptions } from './rscCssEnvelope' + +import './rscSsrHandler' +// Import for global declaration side effect +export type { RscSsrHandler, RscDecodeResult } from './rscSsrHandler' + +/** + * Renderable RSC handle type - used for serialization detection. + */ + +/** + * Type guard for renderable RSC handle. + */ +export function isRenderableRscHandle( + value: unknown, +): value is AnyRenderableServerComponent { + return ( + typeof value === 'function' && + SERVER_COMPONENT_STREAM in value && + RENDERABLE_RSC in value && + (value as any)[RENDERABLE_RSC] === true + ) +} + +/** + * Renders a React element to an RSC Flight stream. + * + * Returns a "renderable proxy" that can be: + * - Rendered directly as `{data}` in JSX + * - Accessed for nested selections: `{data.foo.bar.Hello}` + * + * No slot support - for slots use `createCompositeComponent`. + * + * @example + * ```tsx + * // In a loader or server function + * const data = await renderServerComponent(<MyServerComponent foo="bar" />) + * + * // In the route component + * return ( + * <div> + * {data} + * {data.sidebar.Menu} + * </div> + * ) + * ``` + */ +export async function renderServerComponent<TNode>( + node: ValidateRenderableServerComponent<TNode>, + options?: RscCssEnvelopeOptions, +): Promise<RenderableServerComponentBuilder<TNode>> { + const flightStream = renderToReadableStream( + createRscCssEnvelope(node, options), + ) + + // Check if this is an SSR request (router) or a direct server function call + const ctx = getStartContext({ throwIfNotFound: false }) + const isRouterRequest = ctx?.handlerType === 'router' + const ssrHandler = globalThis.__RSC_SSR__ + + // SSR path: buffer stream for replay, pre-decode for synchronous rendering + if (isRouterRequest && ssrHandler) { + const signal = getRequest().signal + const stream = new ReplayableStream(flightStream, { signal }) + + // Pre-decode during loader phase for synchronous SSR rendering + const decoded = await ssrHandler.decode(stream) + return ssrHandler.createRenderableProxy( + stream, + decoded, + ) as RenderableServerComponentBuilder<TNode> + } + + // Server function call path: return a handle for serialization + return createRenderableHandle( + flightStream, + ) as unknown as RenderableServerComponentBuilder<TNode> +} + +/** + * Creates a renderable handle for server function responses. + * Tagged with RENDERABLE_RSC for the serialization adapter. + */ +function createRenderableHandle( + flightStream: ReadableStream<Uint8Array>, +): AnyRenderableServerComponent { + const streamWrapper: ServerComponentStream = { + createReplayStream: () => flightStream, + } + + const stub = function RenderableRscStub(): never { + throw new Error( + 'Renderable RSC from server function cannot be rendered on server. ' + + 'It should be serialized and sent to the client.', + ) + } + + ;(stub as any)[SERVER_COMPONENT_STREAM] = streamWrapper + ;(stub as any)[RENDERABLE_RSC] = true + return stub as unknown as AnyRenderableServerComponent +} diff --git a/packages/react-start-rsc/src/rsbuild/browser-decode.ts b/packages/react-start-rsc/src/rsbuild/browser-decode.ts new file mode 100644 index 0000000000..040e3e6bd9 --- /dev/null +++ b/packages/react-start-rsc/src/rsbuild/browser-decode.ts @@ -0,0 +1,11 @@ +/** + * Rsbuild browser decode implementation. + * + * Bundler-owned rsbuild virtual modules re-export this module for browser-side + * Flight decode. + */ + +export { + createFromReadableStream, + createFromFetch, +} from 'react-server-dom-rspack/client.browser' diff --git a/packages/react-start-rsc/src/rsbuild/ssr-decode.ts b/packages/react-start-rsc/src/rsbuild/ssr-decode.ts new file mode 100644 index 0000000000..30054d9144 --- /dev/null +++ b/packages/react-start-rsc/src/rsbuild/ssr-decode.ts @@ -0,0 +1,128 @@ +/** + * Rsbuild SSR decode implementation. + * + * Bundler-owned rsbuild virtual modules re-export this module for SSR-side + * Flight decode. + */ + +import { createFromReadableStream as decodeFlightStream } from 'react-server-dom-rspack/client.node' + +type ClientReferenceDeps = { + js: Array<string> + css: Array<string> +} + +type OnClientReference = (reference: { + id: string + deps: ClientReferenceDeps + runtime: 'rsbuild' +}) => void + +type ImportManifestEntry = { + id: string + chunks: Array<string> + cssFiles?: Array<string> + name: string + async?: boolean +} + +type ClientManifest = Record<string, ImportManifestEntry> +type ServerConsumerModuleMap = null | Record< + string, + Record<string, ImportManifestEntry> +> +type ModuleLoading = null | { + prefix: string + crossOrigin?: 'use-credentials' | '' +} + +declare const __rspack_rsc_manifest__: { + moduleLoading: ModuleLoading + serverConsumerModuleMap: ServerConsumerModuleMap + clientManifest: ClientManifest +} + +const CHUNK_FILENAME_INDEX = 1 +const CHUNK_PAIR_SIZE = 2 + +let onClientReference: OnClientReference | undefined +let clientReferenceDepsByModuleId: Map<string, ClientReferenceDeps> | undefined + +function getClientReferenceDepsByModuleId() { + if (clientReferenceDepsByModuleId) return clientReferenceDepsByModuleId + + clientReferenceDepsByModuleId = new Map() + const prefix = __rspack_rsc_manifest__.moduleLoading?.prefix ?? '' + + for (const entry of Object.values(__rspack_rsc_manifest__.clientManifest)) { + let deps = clientReferenceDepsByModuleId.get(entry.id) + if (!deps) { + deps = { js: [], css: [] } + clientReferenceDepsByModuleId.set(entry.id, deps) + } + + // React/Rspack stores JS chunks as chunk id/filename pairs. CSS files are + // separate manifest entries and are already emitted as public hrefs. + for ( + let i = CHUNK_FILENAME_INDEX; + i < entry.chunks.length; + i += CHUNK_PAIR_SIZE + ) { + deps.js.push(prefix + entry.chunks[i]) + } + + if (entry.cssFiles) { + deps.css.push(...entry.cssFiles) + } + } + + return clientReferenceDepsByModuleId +} + +function emitClientReferencePreloadsForModule(moduleId: string) { + const deps = getClientReferenceDepsByModuleId().get(moduleId) + if (!onClientReference || !deps) return + + if (deps.js.length === 0 && deps.css.length === 0) { + return + } + + onClientReference({ + id: moduleId, + deps, + runtime: 'rsbuild', + }) +} + +if (__rspack_rsc_manifest__.serverConsumerModuleMap) { + __rspack_rsc_manifest__.serverConsumerModuleMap = new Proxy( + __rspack_rsc_manifest__.serverConsumerModuleMap, + { + get(target, property, receiver) { + const moduleExports = Reflect.get(target, property, receiver) + + if (typeof property === 'string' && moduleExports !== undefined) { + emitClientReferencePreloadsForModule(property) + } + + return moduleExports + }, + }, + ) +} + +function setOnClientReference(callback: OnClientReference | undefined) { + onClientReference = callback +} + +async function createFromReadableStreamWithClientPreloads<T = unknown>( + stream: ReadableStream<Uint8Array>, + options?: object, +): Promise<T> { + return decodeFlightStream<T>(stream, options) +} + +export { + setOnClientReference, + createFromReadableStreamWithClientPreloads as createFromReadableStream, +} diff --git a/packages/react-start-rsc/src/rscCssEnvelope.ts b/packages/react-start-rsc/src/rscCssEnvelope.ts new file mode 100644 index 0000000000..54e1ac4932 --- /dev/null +++ b/packages/react-start-rsc/src/rscCssEnvelope.ts @@ -0,0 +1,38 @@ +import type React from 'react' + +const RSC_CSS_ENVELOPE_MARKER = '__tanstackStartRscCssEnvelope' +const RSC_CSS_ENVELOPE_RESOURCES = '__tanstackStartRscCss' +const RSC_CSS_ENVELOPE_VALUE = '__tanstackStartRscValue' + +export interface RscCssEnvelopeOptions { + [RSC_CSS_ENVELOPE_RESOURCES]?: React.ReactNode +} + +export function createRscCssEnvelope<TValue>( + value: TValue, + options?: RscCssEnvelopeOptions, +): TValue | Record<string, unknown> { + const resources = options?.[RSC_CSS_ENVELOPE_RESOURCES] + if (resources === undefined || resources === null || resources === false) { + return value + } + + return { + [RSC_CSS_ENVELOPE_MARKER]: true, + [RSC_CSS_ENVELOPE_RESOURCES]: resources, + [RSC_CSS_ENVELOPE_VALUE]: value, + } +} + +export function unwrapRscCssEnvelope(value: unknown): unknown { + if (!value || typeof value !== 'object') { + return value + } + + const maybeEnvelope = value as Record<string, unknown> + if (maybeEnvelope[RSC_CSS_ENVELOPE_MARKER] !== true) { + return value + } + + return maybeEnvelope[RSC_CSS_ENVELOPE_VALUE] +} diff --git a/packages/react-start-rsc/src/rscSsrHandler.ts b/packages/react-start-rsc/src/rscSsrHandler.ts new file mode 100644 index 0000000000..2969c926cf --- /dev/null +++ b/packages/react-start-rsc/src/rscSsrHandler.ts @@ -0,0 +1,39 @@ +import type { + RscSlotUsageEvent, + ServerComponentStream, +} from './ServerComponentTypes' + +/** + * Result from decoding an RSC stream for SSR. + */ +export interface RscDecodeResult { + tree: unknown + cssHrefs?: Set<string> + jsPreloads?: Set<string> +} + +/** + * SSR handler interface - registered by serialization.server.ts in SSR environment. + * Supports both renderable and composite proxy creation. + */ +export interface RscSsrHandler { + /** Pre-decode the stream for synchronous SSR rendering */ + decode: (stream: ServerComponentStream) => Promise<RscDecodeResult> + /** Create a renderable proxy (for renderServerComponent) */ + createRenderableProxy: ( + stream: ServerComponentStream, + decoded: RscDecodeResult, + ) => any + /** Create a composite proxy (for createCompositeComponent) */ + createCompositeProxy: ( + stream: ServerComponentStream, + decoded: RscDecodeResult, + slotUsagesStream?: ReadableStream<RscSlotUsageEvent>, + ) => any +} + +// Single global for SSR environment communication +declare global { + // eslint-disable-next-line no-var + var __RSC_SSR__: RscSsrHandler | undefined +} diff --git a/packages/react-start-rsc/src/serialization.client.ts b/packages/react-start-rsc/src/serialization.client.ts new file mode 100644 index 0000000000..5bf8fd7d79 --- /dev/null +++ b/packages/react-start-rsc/src/serialization.client.ts @@ -0,0 +1,54 @@ +import { createSerializationAdapter } from '@tanstack/react-router' +// RSC HMR setup (dev-only, provided by the active Start bundler adapter). +import { setupRscHmr } from 'virtual:tanstack-rsc-hmr' +import { + createCompositeFromStream, + createRenderableFromStream, +} from './createServerComponentFromStream' +import type { + AnyCompositeComponent, + RscSlotUsageEvent, +} from './ServerComponentTypes' + +if (process.env.NODE_ENV === 'development') { + setupRscHmr() +} + +/** + * Client-side serialization adapter for RSC (renderable + composite). + */ +type SerializedRsc = { + kind: 'renderable' | 'composite' + stream: ReadableStream<Uint8Array> + slotUsagesStream?: ReadableStream<RscSlotUsageEvent> + cssHrefs?: Array<string> + jsPreloads?: Array<string> +} + +const adapter = createSerializationAdapter({ + key: '$RSC', + test: (_value: unknown): _value is never => false, + toSerializable: (): never => { + throw new Error('RSC cannot be serialized on client') + }, + fromSerializable: (value: SerializedRsc): AnyCompositeComponent => { + // Rsbuild SSR sends asset deps with each serialized RSC so the client can + // preload only if that specific stream is rendered. When absent, decode + // starts eagerly and discovers assets from the Flight payload as before. + const options = { + cssHrefs: value.cssHrefs, + jsPreloads: value.jsPreloads, + } + + if (value.kind === 'renderable') { + return createRenderableFromStream(value.stream, options) + } + + return createCompositeFromStream(value.stream, { + slotUsagesStream: value.slotUsagesStream, + ...options, + }) + }, +}) + +export const rscSerializationAdapter = () => [adapter] diff --git a/packages/react-start-rsc/src/serialization.server.ts b/packages/react-start-rsc/src/serialization.server.ts new file mode 100644 index 0000000000..32a9c4bcbb --- /dev/null +++ b/packages/react-start-rsc/src/serialization.server.ts @@ -0,0 +1,230 @@ +import { AsyncLocalStorage } from 'node:async_hooks' +import { createSerializationAdapter } from '@tanstack/react-router' +import { RawStream } from '@tanstack/router-core' +import { getStartContext } from '@tanstack/start-storage-context' +import { + setOnClientReference, + createFromReadableStream as ssrDecode, +} from 'virtual:tanstack-rsc-ssr-decode' +import { + RENDERABLE_RSC, + RSC_SLOT_USAGES_STREAM, + SERVER_COMPONENT_CSS_HREFS, + SERVER_COMPONENT_JS_PRELOADS, + SERVER_COMPONENT_STREAM, + isServerComponent, +} from './ServerComponentTypes' +import { createRscProxy } from './createRscProxy' +import { awaitLazyElements } from './awaitLazyElements' +import { unwrapRscCssEnvelope } from './rscCssEnvelope' +import type { + AnyCompositeComponent, + ServerComponentStream, +} from './ServerComponentTypes' +import type { RscDecodeResult, RscSsrHandler } from './rscSsrHandler' + +// ===== SSR Handler Registration ===== +// This handler is registered on globalThis for the RSC environment to access. +// The RSC env calls these functions during loader execution to pre-decode streams +// and create renderable proxies. +// +// This MUST happen in a module without 'use client' directive. +// Modules with 'use client' may be transformed to client references in the +// SSR environment when RSC is enabled, preventing the side effect from running. + +// AsyncLocalStorage for decode-scoped proxy asset collectors. +// Client-reference deps stay on the decoded RSC proxy so unused streams don't +// emit global request assets. CSS marker links are collected for all adapters +// because the decoded envelope is unwrapped before SSR render. +const proxyCssCollectorStorage = new AsyncLocalStorage<Set<string>>() +const proxyJsCollectorStorage = new AsyncLocalStorage<Set<string>>() + +setOnClientReference( + ({ + deps, + runtime, + }: { + deps: { js: Array<string>; css: Array<string> } + runtime?: 'rsbuild' + }) => { + const cssCollector = proxyCssCollectorStorage.getStore() + if (cssCollector) { + for (const href of deps.css) { + cssCollector.add(href) + } + } + + const jsCollector = proxyJsCollectorStorage.getStore() + if (jsCollector) { + for (const href of deps.js) { + jsCollector.add(href) + } + } + + if (runtime === 'rsbuild' || cssCollector || jsCollector) { + return + } + + const ctx = getStartContext({ throwIfNotFound: false }) + + // Non-Rsbuild adapters emit decoded client-reference assets through the + // request manifest. + if (!ctx || (!deps.js.length && !deps.css.length)) { + return + } + + if (!ctx.requestAssets) ctx.requestAssets = {} + const seenHrefs = new Set<string>() + for (const preload of ctx.requestAssets.preloads ?? []) { + seenHrefs.add(typeof preload === 'string' ? preload : preload.href) + } + for (const stylesheet of ctx.requestAssets.css ?? []) { + seenHrefs.add( + typeof stylesheet === 'string' ? stylesheet : stylesheet.href, + ) + } + + let nextPreloads: typeof ctx.requestAssets.preloads | undefined + for (const href of deps.js) { + if (seenHrefs.has(href)) continue + seenHrefs.add(href) + if (!nextPreloads) { + nextPreloads = ctx.requestAssets.preloads + ? ctx.requestAssets.preloads.slice() + : [] + } + nextPreloads.push(href) + } + if (nextPreloads) { + ctx.requestAssets.preloads = nextPreloads + } + + let nextCss: typeof ctx.requestAssets.css | undefined + for (const href of deps.css) { + if (seenHrefs.has(href)) continue + seenHrefs.add(href) + if (!nextCss) { + nextCss = ctx.requestAssets.css ? ctx.requestAssets.css.slice() : [] + } + nextCss.push(href) + } + if (nextCss) { + ctx.requestAssets.css = nextCss + } + }, +) + +const ssrHandler: RscSsrHandler = { + async decode(stream: ServerComponentStream): Promise<RscDecodeResult> { + const readableStream = stream.createReplayStream() + + // Create a collector for this decode operation. + // Run the decode in an AsyncLocalStorage context so the onClientReference + // callback can write to this specific collector even with parallel decodes. + const proxyCssCollector = new Set<string>() + const proxyJsCollector = new Set<string>() + + return proxyCssCollectorStorage.run(proxyCssCollector, async () => { + return proxyJsCollectorStorage.run(proxyJsCollector, async () => { + const decodedTree = await ssrDecode(readableStream) + await awaitLazyElements(decodedTree, (href) => { + proxyCssCollector.add(href) + }) + + return { + tree: unwrapRscCssEnvelope(decodedTree), + cssHrefs: proxyCssCollector.size > 0 ? proxyCssCollector : undefined, + jsPreloads: proxyJsCollector.size > 0 ? proxyJsCollector : undefined, + } + }) + }) + }, + + createRenderableProxy(stream, decoded): any { + return createRscProxy(() => decoded.tree, { + stream, + cssHrefs: decoded.cssHrefs, + jsPreloads: decoded.jsPreloads, + renderable: true, + }) + }, + + createCompositeProxy( + stream, + decoded, + slotUsagesStream, + ): AnyCompositeComponent { + const proxy = createRscProxy(() => decoded.tree, { + stream, + cssHrefs: decoded.cssHrefs, + jsPreloads: decoded.jsPreloads, + renderable: false, + slotUsagesStream, + }) + return proxy + }, +} + +// Register SSR handler on globalThis for RSC environment to access. +globalThis.__RSC_SSR__ = ssrHandler + +// ===== End SSR Handler Registration ===== + +/** + * Helper to check if a value is a renderable RSC (from renderServerComponent). + * The value can be either an object (proxy target) or a function (stub for server functions). + */ +function isRenderableRsc(value: unknown): boolean { + if (value === null || value === undefined) return false + if (typeof value !== 'object' && typeof value !== 'function') return false + return RENDERABLE_RSC in value && (value as any)[RENDERABLE_RSC] === true +} + +/** + * Server-side serialization adapter for RSC (renderable + composite). + */ +const adapter = createSerializationAdapter({ + key: '$RSC', + test: (value: unknown): value is AnyCompositeComponent => { + return isServerComponent(value) + }, + toSerializable: (component: AnyCompositeComponent) => { + const stream = component[SERVER_COMPONENT_STREAM]!.createReplayStream() + + const kind = isRenderableRsc(component) ? 'renderable' : 'composite' + const jsPreloads = component[SERVER_COMPONENT_JS_PRELOADS] + const cssHrefs = component[SERVER_COMPONENT_CSS_HREFS] + // `cssHrefs` can also come from loadCss() marker links. Client-reference + // collection fills `jsPreloads`, so that gates per-stream serialization. + const serializedAssetDeps = jsPreloads?.size + ? { + ...(cssHrefs?.size ? { cssHrefs: Array.from(cssHrefs) } : {}), + jsPreloads: Array.from(jsPreloads), + } + : {} + + const slotUsagesStream = + kind === 'composite' && + process.env.NODE_ENV === 'development' && + RSC_SLOT_USAGES_STREAM in component + ? ((component as any)[RSC_SLOT_USAGES_STREAM] as unknown as + | ReadableStream<any> + | undefined) + : undefined + + return { + kind, + stream: new RawStream(stream, { hint: 'text' }), + slotUsagesStream, + ...serializedAssetDeps, + } + }, + fromSerializable: (): never => { + throw new Error('Server should never deserialize RSC data') + }, +}) + +/** + * Factory function for server-side RSC serialization adapter. + */ +export const rscSerializationAdapter = () => [adapter] diff --git a/packages/react-start-rsc/src/slotUsageSanitizer.ts b/packages/react-start-rsc/src/slotUsageSanitizer.ts new file mode 100644 index 0000000000..ad6d17491e --- /dev/null +++ b/packages/react-start-rsc/src/slotUsageSanitizer.ts @@ -0,0 +1,62 @@ +import { isValidElement } from 'react' + +const REACT_ELEMENT_TYPE = Symbol.for('react.element') +const REACT_TRANSITIONAL_ELEMENT_TYPE = Symbol.for('react.transitional.element') +const REACT_PORTAL_TYPE = Symbol.for('react.portal') + +function isReactElementLike(value: unknown): boolean { + if (!value || (typeof value !== 'object' && typeof value !== 'function')) { + return false + } + + // Prefer React's own check when available. + if (isValidElement(value)) return true + + // Fallback: direct $$typeof detection (covers React 19 transitional elements). + const t = (value as any).$$typeof + return ( + t === REACT_ELEMENT_TYPE || + t === REACT_TRANSITIONAL_ELEMENT_TYPE || + t === REACT_PORTAL_TYPE + ) +} + +const REACT_ELEMENT_PLACEHOLDER = 'React element' + +function sanitizeSlotArg( + value: unknown, + seen: WeakSet<object>, + depth: number, +): unknown { + if (isReactElementLike(value)) { + return REACT_ELEMENT_PLACEHOLDER + } + + if (value === null || value === undefined) { + return value + } + + if (typeof value !== 'object' && typeof value !== 'function') { + return value + } + + if (Array.isArray(value)) { + return value.map((d) => sanitizeSlotArg(d, seen, depth + 1)) + } + + const proto = Object.getPrototypeOf(value) + if (proto === Object.prototype || proto === null) { + const out: Record<string, unknown> = {} + for (const [k, v] of Object.entries(value as Record<string, unknown>)) { + out[k] = sanitizeSlotArg(v, seen, depth + 1) + } + return out + } + + return value +} + +export function sanitizeSlotArgs(args: Array<any>): Array<any> { + const seen = new WeakSet<object>() + return args.map((d) => sanitizeSlotArg(d, seen, 0)) +} diff --git a/packages/react-start-rsc/src/types.ts b/packages/react-start-rsc/src/types.ts new file mode 100644 index 0000000000..061a53edba --- /dev/null +++ b/packages/react-start-rsc/src/types.ts @@ -0,0 +1,15 @@ +import type { ServerComponentStream } from './ServerComponentTypes' + +/** + * Handle returned by RSC helpers. + * Contains the RSC Flight stream that can be consumed by SSR and/or Client. + */ +export interface ServerComponentHandle { + readonly stream: ServerComponentStream +} + +/** + * Slot implementations provided to ServerComponentRenderer. + * Keys are slot names, values are either React nodes (for children) or render functions. + */ +export type SlotImplementations = Record<string, unknown> diff --git a/packages/react-start-rsc/tests/ClientSlot.test.tsx b/packages/react-start-rsc/tests/ClientSlot.test.tsx new file mode 100644 index 0000000000..fa6fef2e9c --- /dev/null +++ b/packages/react-start-rsc/tests/ClientSlot.test.tsx @@ -0,0 +1,213 @@ +import { describe, expect, it, vi } from 'vitest' +import { render, screen } from '@testing-library/react' +import { ClientSlot } from '../src/ClientSlot' +import { SlotProvider } from '../src/SlotContext' + +describe('ClientSlot', () => { + describe('error handling', () => { + it('should throw when rendered outside SlotProvider', () => { + // Suppress React error boundary console output + const spy = vi.spyOn(console, 'error').mockImplementation(() => {}) + + expect(() => { + render(<ClientSlot slot="test" args={[]} />) + }).toThrow('ClientSlot must be rendered within SlotProvider') + + spy.mockRestore() + }) + }) + + describe('missing implementations', () => { + it('should return null for missing slot in non-strict mode', () => { + render( + <SlotProvider implementations={{}} strict={false}> + <div data-testid="container"> + <ClientSlot slot="missing" args={[]} /> + </div> + </SlotProvider>, + ) + + // Container should be empty (null rendered) + expect(screen.getByTestId('container').children).toHaveLength(0) + }) + + it('should throw for missing slot in strict mode', () => { + const spy = vi.spyOn(console, 'error').mockImplementation(() => {}) + + expect(() => { + render( + <SlotProvider implementations={{}} strict={true}> + <ClientSlot slot="missing" args={[]} /> + </SlotProvider>, + ) + }).toThrow('Missing slot implementation for "missing"') + + spy.mockRestore() + }) + }) + + describe('non-function implementations', () => { + it('should render string directly', () => { + render( + <SlotProvider implementations={{ greeting: 'Hello World' }}> + <div data-testid="slot"> + <ClientSlot slot="greeting" args={[]} /> + </div> + </SlotProvider>, + ) + + expect(screen.getByTestId('slot').textContent).toBe('Hello World') + }) + + it('should render number directly', () => { + render( + <SlotProvider implementations={{ count: 42 }}> + <div data-testid="slot"> + <ClientSlot slot="count" args={[]} /> + </div> + </SlotProvider>, + ) + + expect(screen.getByTestId('slot').textContent).toBe('42') + }) + + it('should render React element directly', () => { + render( + <SlotProvider implementations={{ element: <span>Element</span> }}> + <div data-testid="slot"> + <ClientSlot slot="element" args={[]} /> + </div> + </SlotProvider>, + ) + + expect(screen.getByTestId('slot').textContent).toBe('Element') + }) + + it('should render children slot', () => { + render( + <SlotProvider implementations={{ children: <div>Child content</div> }}> + <div data-testid="slot"> + <ClientSlot slot="children" args={[]} /> + </div> + </SlotProvider>, + ) + + expect(screen.getByTestId('slot').textContent).toBe('Child content') + }) + }) + + describe('function implementations', () => { + it('should call function with no args', () => { + render( + <SlotProvider implementations={{ render: () => 'No args result' }}> + <div data-testid="slot"> + <ClientSlot slot="render" args={[]} /> + </div> + </SlotProvider>, + ) + + expect(screen.getByTestId('slot').textContent).toBe('No args result') + }) + + it('should call function with single arg', () => { + render( + <SlotProvider + implementations={{ render: (name: string) => `Hello ${name}` }} + > + <div data-testid="slot"> + <ClientSlot slot="render" args={['World']} /> + </div> + </SlotProvider>, + ) + + expect(screen.getByTestId('slot').textContent).toBe('Hello World') + }) + + it('should call function with multiple args', () => { + render( + <SlotProvider + implementations={{ + render: (a: number, b: number, c: number) => `Sum: ${a + b + c}`, + }} + > + <div data-testid="slot"> + <ClientSlot slot="render" args={[1, 2, 3]} /> + </div> + </SlotProvider>, + ) + + expect(screen.getByTestId('slot').textContent).toBe('Sum: 6') + }) + + it('should call function returning React element', () => { + render( + <SlotProvider + implementations={{ + render: (item: { id: number; name: string }) => ( + <span key={item.id}>{item.name}</span> + ), + }} + > + <div data-testid="slot"> + <ClientSlot slot="render" args={[{ id: 1, name: 'Item One' }]} /> + </div> + </SlotProvider>, + ) + + expect(screen.getByTestId('slot').textContent).toBe('Item One') + }) + + it('should handle function returning null', () => { + render( + <SlotProvider implementations={{ render: () => null }}> + <div data-testid="slot"> + <ClientSlot slot="render" args={[]} /> + </div> + </SlotProvider>, + ) + + expect(screen.getByTestId('slot').children).toHaveLength(0) + }) + }) + + describe('edge cases', () => { + it('should handle undefined args gracefully', () => { + render( + <SlotProvider + implementations={{ + render: (...args: Array<unknown>) => `Args: ${args.length}`, + }} + > + <div data-testid="slot"> + <ClientSlot slot="render" args={[undefined, undefined]} /> + </div> + </SlotProvider>, + ) + + expect(screen.getByTestId('slot').textContent).toBe('Args: 2') + }) + + it('should handle complex object args', () => { + interface ComplexArg { + nested: { deep: { value: string } } + } + + render( + <SlotProvider + implementations={{ + render: (obj: ComplexArg) => obj.nested.deep.value, + }} + > + <div data-testid="slot"> + <ClientSlot + slot="render" + args={[{ nested: { deep: { value: 'Deep value' } } }]} + /> + </div> + </SlotProvider>, + ) + + expect(screen.getByTestId('slot').textContent).toBe('Deep value') + }) + }) +}) diff --git a/packages/react-start-rsc/tests/CompositeComponent.types.test-d.tsx b/packages/react-start-rsc/tests/CompositeComponent.types.test-d.tsx new file mode 100644 index 0000000000..b6493e75a8 --- /dev/null +++ b/packages/react-start-rsc/tests/CompositeComponent.types.test-d.tsx @@ -0,0 +1,29 @@ +import { expectTypeOf, test } from 'vitest' + +import type { ComponentProps } from 'react' +import { CompositeComponent } from '../src/CompositeComponent' +import type { CompositeComponentResult } from '../src/ServerComponentTypes' + +test('CompositeComponent infers slot props from src', () => { + type Post = (props: { + children?: React.ReactNode + header: (title: string) => React.ReactNode + footer: () => React.ReactNode + }) => React.ReactNode + + const src = null as unknown as CompositeComponentResult<Post> + + expectTypeOf(CompositeComponent).toBeFunction() + + type Props = ComponentProps<typeof CompositeComponent<typeof src>> + + // Type-level: ensure inferred props include slots + type Expected = { + src: typeof src + children?: React.ReactNode + header: (title: string) => React.ReactNode + footer: () => React.ReactNode + } + + expectTypeOf<Props>().branded.toEqualTypeOf<Expected>() +}) diff --git a/packages/react-start-rsc/tests/ReplayableStream.test.ts b/packages/react-start-rsc/tests/ReplayableStream.test.ts new file mode 100644 index 0000000000..4c4e40566e --- /dev/null +++ b/packages/react-start-rsc/tests/ReplayableStream.test.ts @@ -0,0 +1,536 @@ +import { describe, expect, it } from 'vitest' +import { + ReplayableStream, + REPLAYABLE_STREAM_MARKER, +} from '../src/ReplayableStream' + +describe('ReplayableStream', () => { + describe('basic functionality', () => { + it('should buffer and replay chunks to single consumer', async () => { + const source = new ReadableStream<Uint8Array>({ + start(controller) { + controller.enqueue(new Uint8Array([1, 2, 3])) + controller.enqueue(new Uint8Array([4, 5, 6])) + controller.close() + }, + }) + + const replayable = new ReplayableStream(source) + const replay = replayable.createReplayStream() + const reader = replay.getReader() + + const chunks: Array<Uint8Array> = [] + while (true) { + const { done, value } = await reader.read() + if (done) break + chunks.push(value) + } + + expect(chunks).toHaveLength(2) + expect(chunks[0]).toEqual(new Uint8Array([1, 2, 3])) + expect(chunks[1]).toEqual(new Uint8Array([4, 5, 6])) + }) + + it('should allow multiple independent consumers', async () => { + const source = new ReadableStream<Uint8Array>({ + start(controller) { + controller.enqueue(new Uint8Array([10, 20])) + controller.enqueue(new Uint8Array([30, 40])) + controller.close() + }, + }) + + const replayable = new ReplayableStream(source) + + // Create two independent replay streams + const replay1 = replayable.createReplayStream() + const replay2 = replayable.createReplayStream() + + const reader1 = replay1.getReader() + const reader2 = replay2.getReader() + + // Read from both independently + const chunks1: Array<Uint8Array> = [] + const chunks2: Array<Uint8Array> = [] + + // Read first chunk from both + const r1c1 = await reader1.read() + const r2c1 = await reader2.read() + if (!r1c1.done) chunks1.push(r1c1.value) + if (!r2c1.done) chunks2.push(r2c1.value) + + // Read remaining from both + while (true) { + const { done, value } = await reader1.read() + if (done) break + chunks1.push(value) + } + while (true) { + const { done, value } = await reader2.read() + if (done) break + chunks2.push(value) + } + + // Both should have same data + expect(chunks1).toHaveLength(2) + expect(chunks2).toHaveLength(2) + expect(chunks1[0]).toEqual(new Uint8Array([10, 20])) + expect(chunks2[0]).toEqual(new Uint8Array([10, 20])) + }) + + it('should support late subscribers (replay from beginning)', async () => { + let closeController: () => void = () => {} + const source = new ReadableStream<Uint8Array>({ + start(controller) { + controller.enqueue(new Uint8Array([1])) + controller.enqueue(new Uint8Array([2])) + closeController = () => controller.close() + }, + }) + + const replayable = new ReplayableStream(source) + + // First consumer reads immediately + const replay1 = replayable.createReplayStream() + const reader1 = replay1.getReader() + await reader1.read() // Read first chunk + + // Wait a bit for buffering + await new Promise((r) => setTimeout(r, 10)) + + // Close the source + closeController() + + // Late subscriber should still get all data from beginning + const replay2 = replayable.createReplayStream() + const reader2 = replay2.getReader() + + const chunks: Array<Uint8Array> = [] + while (true) { + const { done, value } = await reader2.read() + if (done) break + chunks.push(value) + } + + expect(chunks).toHaveLength(2) + expect(chunks[0]).toEqual(new Uint8Array([1])) + expect(chunks[1]).toEqual(new Uint8Array([2])) + }) + + it('should have REPLAYABLE_STREAM_MARKER', () => { + const source = new ReadableStream<Uint8Array>({ + start(controller) { + controller.close() + }, + }) + + const replayable = new ReplayableStream(source) + expect(replayable[REPLAYABLE_STREAM_MARKER]).toBe(true) + }) + }) + + describe('abort handling', () => { + it('should abort immediately if signal already aborted', async () => { + const controller = new AbortController() + controller.abort() + + const source = new ReadableStream<Uint8Array>({ + start(ctrl) { + ctrl.enqueue(new Uint8Array([1, 2, 3])) + ctrl.close() + }, + }) + + const replayable = new ReplayableStream(source, { + signal: controller.signal, + }) + const replay = replayable.createReplayStream() + const reader = replay.getReader() + + // Should close immediately due to abort + const { done } = await reader.read() + expect(done).toBe(true) + }) + + it('should close streams when abort signal fires', async () => { + const abortController = new AbortController() + + let enqueueFn: (chunk: Uint8Array) => void = () => {} + const source = new ReadableStream<Uint8Array>({ + start(controller) { + enqueueFn = (chunk) => controller.enqueue(chunk) + }, + }) + + const replayable = new ReplayableStream(source, { + signal: abortController.signal, + }) + const replay = replayable.createReplayStream() + const reader = replay.getReader() + + // Enqueue one chunk + enqueueFn(new Uint8Array([1])) + + // Read it + const { value, done } = await reader.read() + expect(done).toBe(false) + expect(value).toEqual(new Uint8Array([1])) + + // Abort + abortController.abort() + + // Next read should close (not error) + const result = await reader.read() + expect(result.done).toBe(true) + }) + + it('should free memory on abort', async () => { + const abortController = new AbortController() + + const source = new ReadableStream<Uint8Array>({ + start(controller) { + controller.enqueue(new Uint8Array(1000)) + controller.enqueue(new Uint8Array(1000)) + }, + }) + + const replayable = new ReplayableStream(source, { + signal: abortController.signal, + }) + + // Wait for buffering + await new Promise((r) => setTimeout(r, 10)) + + // Abort - should clear internal buffer + abortController.abort() + + // Creating new replay should return empty/closed stream + const replay = replayable.createReplayStream() + const reader = replay.getReader() + const { done } = await reader.read() + expect(done).toBe(true) + }) + }) + + describe('error handling', () => { + it('should propagate source stream errors to consumers', async () => { + let errorController: (err: Error) => void = () => {} + + const source = new ReadableStream<Uint8Array>({ + start(controller) { + controller.enqueue(new Uint8Array([1])) + // Store error function to call later + errorController = (err) => controller.error(err) + }, + }) + + const replayable = new ReplayableStream(source) + const replay = replayable.createReplayStream() + const reader = replay.getReader() + + // First read succeeds + const { value, done } = await reader.read() + expect(done).toBe(false) + expect(value).toEqual(new Uint8Array([1])) + + // Now trigger the error + errorController(new Error('Source stream failed')) + + // Wait for error to propagate + await new Promise((r) => setTimeout(r, 10)) + + // Next read should error + await expect(reader.read()).rejects.toThrow('Source stream failed') + }) + }) + + describe('async streaming', () => { + it('should handle slow source streams', async () => { + const source = new ReadableStream<Uint8Array>({ + async pull(controller) { + await new Promise((r) => setTimeout(r, 10)) + controller.enqueue(new Uint8Array([42])) + controller.close() + }, + }) + + const replayable = new ReplayableStream(source) + const replay = replayable.createReplayStream() + const reader = replay.getReader() + + const { value, done } = await reader.read() + expect(done).toBe(false) + expect(value).toEqual(new Uint8Array([42])) + + const { done: finalDone } = await reader.read() + expect(finalDone).toBe(true) + }) + + it('should allow consumer to read faster than producer', async () => { + let enqueueCount = 0 + const source = new ReadableStream<Uint8Array>({ + start(controller) { + // Enqueue chunks slowly + const interval = setInterval(() => { + if (enqueueCount < 3) { + controller.enqueue(new Uint8Array([enqueueCount])) + enqueueCount++ + } else { + clearInterval(interval) + controller.close() + } + }, 5) + }, + }) + + const replayable = new ReplayableStream(source) + const replay = replayable.createReplayStream() + const reader = replay.getReader() + + const chunks: Array<Uint8Array> = [] + while (true) { + const { done, value } = await reader.read() + if (done) break + chunks.push(value) + } + + expect(chunks).toHaveLength(3) + expect(chunks[0]).toEqual(new Uint8Array([0])) + expect(chunks[1]).toEqual(new Uint8Array([1])) + expect(chunks[2]).toEqual(new Uint8Array([2])) + }) + }) + + describe('edge cases', () => { + it('should handle empty source stream', async () => { + const source = new ReadableStream<Uint8Array>({ + start(controller) { + controller.close() + }, + }) + + const replayable = new ReplayableStream(source) + const replay = replayable.createReplayStream() + const reader = replay.getReader() + + const { done } = await reader.read() + expect(done).toBe(true) + }) + + it('should handle large number of chunks', async () => { + const numChunks = 100 + + const source = new ReadableStream<Uint8Array>({ + start(controller) { + for (let i = 0; i < numChunks; i++) { + controller.enqueue(new Uint8Array([i % 256])) + } + controller.close() + }, + }) + + const replayable = new ReplayableStream(source) + const replay = replayable.createReplayStream() + const reader = replay.getReader() + + const chunks: Array<Uint8Array> = [] + while (true) { + const { done, value } = await reader.read() + if (done) break + chunks.push(value) + } + + expect(chunks).toHaveLength(numChunks) + }) + + it('should create multiple replay streams from same source', async () => { + const source = new ReadableStream<Uint8Array>({ + start(controller) { + controller.enqueue(new Uint8Array([1, 2, 3])) + controller.close() + }, + }) + + const replayable = new ReplayableStream(source) + + // Create 5 replay streams + const replays = Array.from({ length: 5 }, () => + replayable.createReplayStream(), + ) + + // All should get same data + for (const replay of replays) { + const reader = replay.getReader() + const { value, done } = await reader.read() + expect(done).toBe(false) + expect(value).toEqual(new Uint8Array([1, 2, 3])) + + const { done: finalDone } = await reader.read() + expect(finalDone).toBe(true) + } + }) + }) + + describe('memory cleanup', () => { + it('should not auto-release (replays can come at unpredictable times)', async () => { + const source = new ReadableStream<Uint8Array>({ + start(controller) { + controller.enqueue(new Uint8Array([1, 2, 3])) + controller.close() + }, + }) + + const replayable = new ReplayableStream(source) + expect(replayable.isReleased()).toBe(false) + + // Create and fully consume a replay stream + const replay = replayable.createReplayStream() + const reader = replay.getReader() + await reader.read() // Read chunk + await reader.read() // Read close + + // Wait for async operations + await new Promise((r) => setTimeout(r, 10)) + + // Should NOT be auto-released (another replay might come later) + expect(replayable.isReleased()).toBe(false) + + // Can still create another replay + const replay2 = replayable.createReplayStream() + const reader2 = replay2.getReader() + const { value } = await reader2.read() + expect(value).toEqual(new Uint8Array([1, 2, 3])) + }) + + it('should allow explicit release()', async () => { + const source = new ReadableStream<Uint8Array>({ + start(controller) { + controller.enqueue(new Uint8Array([1, 2, 3])) + controller.close() + }, + }) + + const replayable = new ReplayableStream(source) + await new Promise((r) => setTimeout(r, 10)) // Wait for buffering + + expect(replayable.isReleased()).toBe(false) + + replayable.release() + + expect(replayable.isReleased()).toBe(true) + }) + + it('should return empty stream after release()', async () => { + const source = new ReadableStream<Uint8Array>({ + start(controller) { + controller.enqueue(new Uint8Array([1, 2, 3])) + controller.close() + }, + }) + + const replayable = new ReplayableStream(source) + await new Promise((r) => setTimeout(r, 10)) + + // Release explicitly + replayable.release() + + // New replay should return empty/closed stream + const replay = replayable.createReplayStream() + const reader = replay.getReader() + const { done } = await reader.read() + expect(done).toBe(true) + }) + + it('should cancel upstream when release() is called', async () => { + let canceledReason: unknown + let resolveCancel: () => void + const cancelCalled = new Promise<void>((resolve) => { + resolveCancel = resolve + }) + + const source = new ReadableStream<Uint8Array>({ + start(controller) { + controller.enqueue(new Uint8Array([1])) + }, + cancel(reason) { + canceledReason = reason + resolveCancel() + }, + }) + + const replayable = new ReplayableStream(source) + + // Ensure the pump reads at least one chunk. + const replay = replayable.createReplayStream() + const replayReader = replay.getReader() + await replayReader.read() + + replayable.release() + await cancelCalled + + expect(canceledReason).toBeInstanceOf(Error) + }) + + it('should close active replay stream when release() is called mid-stream', async () => { + const source = new ReadableStream<Uint8Array>({ + start(controller) { + controller.enqueue(new Uint8Array([1])) + controller.enqueue(new Uint8Array([2])) + controller.close() + }, + }) + + const replayable = new ReplayableStream(source) + await new Promise((r) => setTimeout(r, 10)) + + // Create replay and read first chunk + const replay = replayable.createReplayStream() + const reader = replay.getReader() + await reader.read() // Read first chunk + + // Release mid-stream + replayable.release() + + // Next read should get close (stream closed early) + const { done } = await reader.read() + expect(done).toBe(true) + + expect(replayable.isReleased()).toBe(true) + }) + + it('should support multiple sequential replays before release', async () => { + const source = new ReadableStream<Uint8Array>({ + start(controller) { + controller.enqueue(new Uint8Array([1])) + controller.close() + }, + }) + + const replayable = new ReplayableStream(source) + await new Promise((r) => setTimeout(r, 10)) + + // First replay - full read + const replay1 = replayable.createReplayStream() + const reader1 = replay1.getReader() + await reader1.read() + await reader1.read() + + // Should not be released + expect(replayable.isReleased()).toBe(false) + + // Second replay - full read + const replay2 = replayable.createReplayStream() + const reader2 = replay2.getReader() + const { value } = await reader2.read() + expect(value).toEqual(new Uint8Array([1])) + await reader2.read() + + // Still not released + expect(replayable.isReleased()).toBe(false) + + // Now release + replayable.release() + expect(replayable.isReleased()).toBe(true) + }) + }) +}) diff --git a/packages/react-start-rsc/tests/ServerComponent.test.tsx b/packages/react-start-rsc/tests/ServerComponent.test.tsx new file mode 100644 index 0000000000..8c39d1dfe8 --- /dev/null +++ b/packages/react-start-rsc/tests/ServerComponent.test.tsx @@ -0,0 +1,118 @@ +import React from 'react' +import { describe, expect, it, vi } from 'vitest' +import { act, render } from '@testing-library/react' + +// Force the client implementation to be used in tests. +vi.mock('@tanstack/start-client-core', () => { + return { + createIsomorphicFn: () => { + const chain: any = { + client(impl: any) { + chain._client = impl + return chain + }, + server(_impl: any) { + return chain._client + }, + } + return chain + }, + trackPostProcessPromise: vi.fn(), + } +}) + +// Mock the RSC decoder so we can control resolution. +vi.mock('@vitejs/plugin-rsc/browser', () => { + return { + createFromReadableStream: vi.fn(), + } +}) + +vi.mock('@vitejs/plugin-rsc/ssr', () => { + return { + createFromReadableStream: vi.fn(), + } +}) + +import { createFromReadableStream as browserDecode } from '@vitejs/plugin-rsc/browser' + +import { + createCompositeFromStream, + createServerComponentFromStream, +} from '../src/createServerComponentFromStream' +import { + SERVER_COMPONENT_CSS_HREFS, + SERVER_COMPONENT_JS_PRELOADS, +} from '../src/ServerComponentTypes' + +describe('ServerComponent (client)', () => { + it('decodes a stream only once', async () => { + const stream = new ReadableStream<Uint8Array>({ + start(controller) { + controller.enqueue(new Uint8Array([1, 2, 3])) + controller.close() + }, + }) + + let createdReadableStream: ReadableStream<Uint8Array> | undefined + let resolvePromise: (value: React.ReactNode) => void + + const decodePromise = new Promise<React.ReactNode>((resolve) => { + resolvePromise = resolve + }) + + const decodeMock = browserDecode as unknown as ReturnType<typeof vi.fn> + decodeMock.mockImplementation((rs: ReadableStream<Uint8Array>) => { + createdReadableStream = rs + return decodePromise + }) + + const Component = createServerComponentFromStream(stream) + + const { CompositeComponent } = await import('../src/CompositeComponent') + + await act(async () => { + render( + <React.Suspense fallback={<div>loading</div>}> + <CompositeComponent src={Component as any} /> + <CompositeComponent src={Component as any} /> + </React.Suspense>, + ) + + // Flush Suspense/use() microtasks + await Promise.resolve() + }) + + // Should only decode once even though we render twice + expect(decodeMock).toHaveBeenCalledTimes(1) + expect(createdReadableStream).toBeDefined() + + // Resolve the decode to complete the test cleanly + resolvePromise!(React.createElement('div', null, 'ok')) + }) + + it('defers decode when SSR asset deps are provided', async () => { + const stream = new ReadableStream<Uint8Array>({ + start(controller) { + controller.close() + }, + }) + + const decodeMock = browserDecode as unknown as ReturnType<typeof vi.fn> + decodeMock.mockClear() + decodeMock.mockResolvedValue(React.createElement('div', null, 'ok')) + + const Component = createCompositeFromStream(stream, { + cssHrefs: ['/assets/component.css'], + jsPreloads: ['/assets/component.js'], + }) + + expect(decodeMock).not.toHaveBeenCalled() + expect(Array.from(Component[SERVER_COMPONENT_CSS_HREFS]!)).toEqual([ + '/assets/component.css', + ]) + expect(Array.from(Component[SERVER_COMPONENT_JS_PRELOADS]!)).toEqual([ + '/assets/component.js', + ]) + }) +}) diff --git a/packages/react-start-rsc/tests/SlotContext.test.tsx b/packages/react-start-rsc/tests/SlotContext.test.tsx new file mode 100644 index 0000000000..9590e44f8c --- /dev/null +++ b/packages/react-start-rsc/tests/SlotContext.test.tsx @@ -0,0 +1,114 @@ +import { describe, expect, it } from 'vitest' +import { render, screen } from '@testing-library/react' +import { SlotProvider, useSlotContext } from '../src/SlotContext' + +describe('SlotContext', () => { + describe('SlotProvider', () => { + it('should provide implementations to children', () => { + function Consumer() { + const ctx = useSlotContext() + return <div data-testid="result">{JSON.stringify(ctx)}</div> + } + + render( + <SlotProvider implementations={{ foo: 'bar' }}> + <Consumer /> + </SlotProvider>, + ) + + const result = screen.getByTestId('result') + const ctx = JSON.parse(result.textContent!) + expect(ctx.implementations).toEqual({ foo: 'bar' }) + expect(ctx.strict).toBe(false) + }) + + it('should support strict mode', () => { + function Consumer() { + const ctx = useSlotContext() + return <div data-testid="strict">{String(ctx?.strict)}</div> + } + + render( + <SlotProvider implementations={{}} strict={true}> + <Consumer /> + </SlotProvider>, + ) + + expect(screen.getByTestId('strict').textContent).toBe('true') + }) + + it('should default strict to false', () => { + function Consumer() { + const ctx = useSlotContext() + return <div data-testid="strict">{String(ctx?.strict)}</div> + } + + render( + <SlotProvider implementations={{}}> + <Consumer /> + </SlotProvider>, + ) + + expect(screen.getByTestId('strict').textContent).toBe('false') + }) + + it('should render children', () => { + render( + <SlotProvider implementations={{}}> + <div data-testid="child">Child content</div> + </SlotProvider>, + ) + + expect(screen.getByTestId('child').textContent).toBe('Child content') + }) + }) + + describe('useSlotContext', () => { + it('should return null outside of SlotProvider', () => { + function Consumer() { + const ctx = useSlotContext() + return ( + <div data-testid="ctx">{ctx === null ? 'null' : 'has value'}</div> + ) + } + + render(<Consumer />) + + expect(screen.getByTestId('ctx').textContent).toBe('null') + }) + + it('should access nested implementations', () => { + function Consumer() { + const ctx = useSlotContext() + const nested = ctx?.implementations.nested as { deep: string } + return <div data-testid="deep">{nested?.deep}</div> + } + + render( + <SlotProvider implementations={{ nested: { deep: 'value' } }}> + <Consumer /> + </SlotProvider>, + ) + + expect(screen.getByTestId('deep').textContent).toBe('value') + }) + + it('should access function implementations', () => { + function Consumer() { + const ctx = useSlotContext() + const fn = ctx?.implementations.renderItem as (n: number) => string + return <div data-testid="fn-result">{fn?.(42)}</div> + } + + render( + <SlotProvider + implementations={{ renderItem: (n: number) => `Item ${n}` }} + > + <Consumer /> + </SlotProvider>, + ) + + expect(screen.getByTestId('fn-result').textContent).toBe('Item 42') + }) + }) +}) diff --git a/packages/react-start-rsc/tests/createRscProxy.test.tsx b/packages/react-start-rsc/tests/createRscProxy.test.tsx new file mode 100644 index 0000000000..3a17c54135 --- /dev/null +++ b/packages/react-start-rsc/tests/createRscProxy.test.tsx @@ -0,0 +1,252 @@ +import React from 'react' +import { describe, expect, it } from 'vitest' +import { render, screen } from '@testing-library/react' +import { ReactElement, ReactLazy } from '../src/reactSymbols' + +import { createRscProxy } from '../src/createRscProxy' +import { awaitLazyElements } from '../src/awaitLazyElements' + +describe('createRscProxy prop access', () => { + it('tracks which props React accesses during rendering', () => { + const accessedProps: Array<string | symbol> = [] + const tree = React.createElement('div', null, 'test content') + + // Create a proxy that tracks all property access + const trackingProxy = new Proxy(function RscProxy() {}, { + get(_target, prop) { + accessedProps.push(prop) + + // Return values that allow React to proceed + if (prop === 'then') return undefined + if (prop === 'constructor') return Function + if (prop === Symbol.toStringTag) return 'RscProxy' + if (prop === Symbol.toPrimitive) return () => 'RscProxy' + if (prop === 'toString') return () => 'RscProxy' + if (prop === 'valueOf') return () => _target + if (prop === 'displayName') return 'RscProxy' + if (prop === 'name') return 'RscProxy' + if (prop === 'length') return 0 + if (prop === 'contextTypes') return undefined + if (prop === 'childContextTypes') return undefined + if (prop === 'getDerivedStateFromProps') return undefined + if (prop === 'defaultProps') return undefined + if (prop === 'propTypes') return undefined + if (prop === 'getDefaultProps') return undefined + if (typeof prop === 'symbol') return undefined + + return undefined + }, + apply() { + // Return actual React element when called + return tree + }, + has() { + return true + }, + getPrototypeOf() { + return Function.prototype + }, + }) + + function Wrapper() { + const Component = trackingProxy as any + return <Component /> + } + + render(<Wrapper />) + + expect(screen.getByText('test content')).toBeDefined() + + const uniqueProps = [...new Set(accessedProps.map((p) => String(p)))] + + // Keep this strict: it proves what React probes in this env. + // This is NOT a contract for our proxy implementation. + expect(uniqueProps.sort()).toEqual( + [ + '$$typeof', + 'Symbol(Symbol.toStringTag)', + 'childContextTypes', + 'contextType', + 'contextTypes', + 'displayName', + 'getDerivedStateFromProps', + 'prototype', + ].sort(), + ) + }) + + it('renders correctly with minimal prop handling', () => { + const tree = React.createElement('div', null, 'minimal test') + + // Test with ONLY the critical props - no DevTools props + const minimalProxy = new Proxy(function RscProxy() {}, { + get(_target, prop) { + // Critical props only + if (prop === 'then') return undefined + if (prop === 'constructor') return Function + + // Legacy class component props + switch (prop) { + case 'contextTypes': + case 'childContextTypes': + case 'getDerivedStateFromProps': + case 'defaultProps': + case 'propTypes': + case 'getDefaultProps': + return undefined + } + + // Unknown symbols + if (typeof prop === 'symbol') return undefined + + return undefined + }, + apply() { + return tree + }, + has() { + return true + }, + getPrototypeOf() { + return Function.prototype + }, + }) + + function Wrapper() { + const Component = minimalProxy as any + return <Component /> + } + + // This should render without errors even with minimal props + render(<Wrapper />) + + expect(screen.getByText('minimal test')).toBeDefined() + }) +}) + +describe('awaitLazyElements', () => { + /** + * Creates a mock lazy element similar to what Flight decoder produces. + * The _payload has a status and is thenable. + */ + function createMockLazy(initialStatus: 'pending' | 'fulfilled' = 'pending') { + let status = initialStatus + const callbacks: Array<() => void> = [] + + const payload = { + get status() { + return status + }, + then(onFulfill: () => void) { + if (status === 'fulfilled') { + queueMicrotask(onFulfill) + } else { + callbacks.push(onFulfill) + } + }, + } + + return { + $$typeof: ReactLazy, + _payload: payload, + _resolve() { + status = 'fulfilled' + callbacks.forEach((cb) => cb()) + callbacks.length = 0 + }, + } + } + + it('awaits pending lazy elements', async () => { + const lazy = createMockLazy() + + // Resolve after a microtask + queueMicrotask(() => lazy._resolve()) + + await awaitLazyElements(lazy) + + expect(lazy._payload.status).toBe('fulfilled') + }) + + it('skips already fulfilled lazy elements', async () => { + const lazy = createMockLazy('fulfilled') + + // Should complete immediately without hanging + await awaitLazyElements(lazy) + + expect(lazy._payload.status).toBe('fulfilled') + }) + + it('handles multiple lazy elements at different depths', async () => { + const lazy1 = createMockLazy() + const lazy2 = createMockLazy() + const lazy3 = createMockLazy() + + const tree = { + $$typeof: ReactElement, + type: 'div', + props: { + children: [ + lazy1, + { + $$typeof: ReactElement, + type: 'div', + props: { + children: [ + lazy2, + { + $$typeof: ReactElement, + type: 'span', + props: { children: lazy3 }, + }, + ], + }, + }, + ], + }, + } + + // Resolve all after microtasks + queueMicrotask(() => { + lazy1._resolve() + lazy2._resolve() + lazy3._resolve() + }) + + await awaitLazyElements(tree) + + expect(lazy1._payload.status).toBe('fulfilled') + expect(lazy2._payload.status).toBe('fulfilled') + expect(lazy3._payload.status).toBe('fulfilled') + }) + + it('stops at Suspense boundaries', async () => { + const lazyInsideSuspense = createMockLazy() + const lazyOutsideSuspense = createMockLazy() + + const tree = { + $$typeof: ReactElement, + type: 'div', + props: { + children: [ + lazyOutsideSuspense, + { + $$typeof: ReactElement, + type: Symbol.for('react.suspense'), + props: { children: lazyInsideSuspense }, + }, + ], + }, + } + + // Only resolve the outside one + queueMicrotask(() => lazyOutsideSuspense._resolve()) + + await awaitLazyElements(tree) + + // Outside should be resolved + expect(lazyOutsideSuspense._payload.status).toBe('fulfilled') + // Inside Suspense should NOT be awaited (still pending) + expect(lazyInsideSuspense._payload.status).toBe('pending') + }) +}) diff --git a/packages/react-start-rsc/tests/createServerComponent.test-d.tsx b/packages/react-start-rsc/tests/createServerComponent.test-d.tsx new file mode 100644 index 0000000000..9a161e2345 --- /dev/null +++ b/packages/react-start-rsc/tests/createServerComponent.test-d.tsx @@ -0,0 +1,109 @@ +import { expectTypeOf, test, vi } from 'vitest' +import type { + CompositeComponentResult, + ValidateCompositeComponent, +} from '../src/ServerComponentTypes' +import { CompositeComponent } from '../src/CompositeComponent' + +vi.mock('@tanstack/start-server-core', () => { + return { + getRequest: () => undefined, + } +}) + +vi.mock('@tanstack/start-storage-context', () => { + return { + getStartContext: () => undefined, + } +}) +import { JSX } from 'react' + +test('when a server component is created with no props', () => { + type Post = () => React.ReactNode + type PostComponent = CompositeComponentResult<Post> + + const node = null as unknown as JSX.Element + expectTypeOf(node).toEqualTypeOf<JSX.Element>() +}) + +test('when a server component is created with props but no slots', () => { + type Post = (props: { num: number }) => React.ReactNode + type PostComponent = CompositeComponentResult<Post> + + const node = null as unknown as JSX.Element + expectTypeOf(node).toEqualTypeOf<JSX.Element>() + expectTypeOf(null as unknown as typeof CompositeComponent<PostComponent>) + .parameter(0) + .branded.toEqualTypeOf<{ src: PostComponent; num: number }>() +}) + +test('when a server component is created with child slots and props', () => { + type Post = (props: { + children: React.ReactNode + num: number + }) => React.ReactNode + type PostComponent = CompositeComponentResult<Post> + + const node = null as unknown as JSX.Element + expectTypeOf(node).toEqualTypeOf<JSX.Element>() + expectTypeOf(null as unknown as typeof CompositeComponent<PostComponent>) + .parameter(0) + .branded.toEqualTypeOf<{ + src: PostComponent + num: number + children: React.ReactNode + }>() +}) + +test('when a server component is created with slots with no props', () => { + type Post = (props: { render: () => React.ReactNode }) => React.ReactNode + type PostComponent = CompositeComponentResult<Post> + + const node = null as unknown as JSX.Element + expectTypeOf(node).toEqualTypeOf<JSX.Element>() + + expectTypeOf(null as unknown as typeof CompositeComponent<PostComponent>) + .parameter(0) + .branded.toEqualTypeOf<{ + src: PostComponent + render: () => React.ReactNode + }>() +}) + +test('when a server component is created with slots with serializable props', () => { + type Post = (props: { + render: (index: number) => React.ReactNode + }) => React.ReactNode + + type PostComponent = CompositeComponentResult<Post> + + const node = null as unknown as JSX.Element + expectTypeOf(node).toEqualTypeOf<JSX.Element>() + + expectTypeOf(null as unknown as typeof CompositeComponent<PostComponent>) + .parameter(0) + .branded.toEqualTypeOf<{ + src: PostComponent + render: (index: number) => React.ReactNode + }>() +}) + +test('when a server component is created with slots with not serializable props', () => { + type Post = (props: { + render: (props: { func: () => void }) => React.ReactNode + }) => React.ReactNode + + expectTypeOf<ValidateCompositeComponent<Post>>().toEqualTypeOf< + (props: { + render: (props: { + func: 'Function is not serializable' + }) => React.ReactNode + }) => React.ReactNode + >() +}) + +test('when server component type has incorrect return type', () => { + expectTypeOf<ValidateCompositeComponent<() => void>>().toEqualTypeOf< + (props: unknown) => React.ReactNode + >() +}) diff --git a/packages/react-start-rsc/tests/renderServerComponent.types.test-d.tsx b/packages/react-start-rsc/tests/renderServerComponent.types.test-d.tsx new file mode 100644 index 0000000000..5d9f6f59b4 --- /dev/null +++ b/packages/react-start-rsc/tests/renderServerComponent.types.test-d.tsx @@ -0,0 +1,30 @@ +import { expectTypeOf, test } from 'vitest' +import type { ReactElement } from 'react' + +import { renderServerComponent } from '../src/renderServerComponent.stub' +import type { + RenderServerComponentElement, + RenderServerComponentResult, +} from '../src/ServerComponentTypes' + +test('renderServerComponent infers nested access type', () => { + function MyServerComponent(_props: {}): any { + throw new Error('not executed') + } + + const element = null as unknown as RenderServerComponentElement<{ + foo: { bar: ReactElement } + }> + + const dataPromise = renderServerComponent(element) + + type Data = Awaited<typeof dataPromise> + + // nested selection + expectTypeOf<Data>().toHaveProperty('foo') + expectTypeOf<Data['foo']>().toHaveProperty('bar') + + // also: directly renderable at top-level + type MustBeRenderable = true + expectTypeOf<MustBeRenderable>().toEqualTypeOf<true>() +}) diff --git a/packages/react-start-rsc/tests/rscCssTransform.test.tsx b/packages/react-start-rsc/tests/rscCssTransform.test.tsx new file mode 100644 index 0000000000..0e2c2e45cf --- /dev/null +++ b/packages/react-start-rsc/tests/rscCssTransform.test.tsx @@ -0,0 +1,164 @@ +import { describe, expect, test } from 'vitest' +import { + StartCompiler, + detectKindsInCode, + getLookupKindsForEnv, +} from '../../start-plugin-core/src/start-compiler/compiler' +import { getLookupConfigurationsForEnv } from '../../start-plugin-core/src/start-compiler/config' +import { createRscCssCompilerTransforms } from '../src/plugin/rscCssTransform' +import type { StartCompilerImportTransform } from '../../start-plugin-core/src/types' + +const TSS_SERVERFN_SPLIT_PARAM = 'tss-serverfn-split' + +async function compileWithRscCssTransform(opts: { + code: string + id?: string | undefined + loadCssExpression?: string | undefined + serverFnProviderOnly?: boolean | undefined +}) { + const compilerTransforms = createRscCssCompilerTransforms({ + loadCssExpression: + opts.loadCssExpression ?? 'import.meta.viteRsc.loadCss()', + serverFnProviderOnly: opts.serverFnProviderOnly, + }) + + const compiler = new StartCompiler({ + env: 'server', + envName: 'rsc', + root: '/test', + framework: 'react', + providerEnvName: 'rsc', + mode: 'build', + lookupKinds: getLookupKindsForEnv('server', { compilerTransforms }), + lookupConfigurations: getLookupConfigurationsForEnv('server', 'react', { + compilerTransforms, + }), + compilerTransforms, + getKnownServerFns: () => ({}), + loadModule: async () => {}, + resolveId: async (id) => id, + }) + + const result = await compiler.compile({ + id: opts.id ?? '/test/src/route.tsx', + code: opts.code, + detectedKinds: detectKindsInCode(opts.code, 'server', { + compilerTransforms, + }), + }) + + return result?.code ?? null +} + +describe('RSC CSS compiler transforms', () => { + test('injects Vite CSS resources into all supported RSC render APIs', async () => { + const code = await compileWithRscCssTransform({ + code: ` + import { + createCompositeComponent, + renderServerComponent, + renderToReadableStream, + } from '@tanstack/react-start/rsc' + + export const renderable = renderServerComponent(<Card kind="renderable" />) + export const composite = createCompositeComponent(() => ({ + Card: <Card kind="composite" />, + })) + export const stream = renderToReadableStream(<Card kind="stream" />) + `, + }) + + expect(code).toMatchInlineSnapshot(` + "import { createCompositeComponent, renderServerComponent, renderToReadableStream } from '@tanstack/react-start/rsc'; + export const renderable = renderServerComponent(<Card kind="renderable" />, { + __tanstackStartRscCss: import.meta.viteRsc.loadCss() + }); + export const composite = createCompositeComponent(() => ({ + Card: <Card kind="composite" /> + }), { + __tanstackStartRscCss: import.meta.viteRsc.loadCss() + }); + export const stream = renderToReadableStream(<>{import.meta.viteRsc.loadCss()}<Card kind="stream" /></>);" + `) + }) + + test('does not rewrite calls outside the transform constraints', async () => { + const code = await compileWithRscCssTransform({ + code: ` + import { + renderServerComponent, + renderToReadableStream, + } from '@tanstack/react-start/rsc' + + const node = <Card /> + export const existingOptions = renderServerComponent(<Card />, { + alreadyConfigured: true, + }) + export const nonJsxStream = renderToReadableStream(node) + `, + }) + + expect(code).toMatchInlineSnapshot(` + "import { renderServerComponent, renderToReadableStream } from '@tanstack/react-start/rsc'; + const node = <Card />; + export const existingOptions = renderServerComponent(<Card />, { + alreadyConfigured: true + }); + export const nonJsxStream = renderToReadableStream(node);" + `) + }) + + test('honors provider-only transforms for Rsbuild', async () => { + const source = ` + import { renderServerComponent } from '@tanstack/react-start/rsc' + + export const renderable = renderServerComponent(<Card />) + ` + + const callerCode = await compileWithRscCssTransform({ + code: source, + loadCssExpression: 'import.meta.rspackRsc.loadCss()', + serverFnProviderOnly: true, + }) + + const providerCode = await compileWithRscCssTransform({ + code: source, + id: `/test/src/route.tsx?${TSS_SERVERFN_SPLIT_PARAM}`, + loadCssExpression: 'import.meta.rspackRsc.loadCss()', + serverFnProviderOnly: true, + }) + + expect({ callerCode, providerCode }).toMatchInlineSnapshot(` + { + "callerCode": "import { renderServerComponent } from '@tanstack/react-start/rsc'; + export const renderable = renderServerComponent(<Card />);", + "providerCode": "import { renderServerComponent } from '@tanstack/react-start/rsc'; + export const renderable = renderServerComponent(<Card />, { + __tanstackStartRscCss: import.meta.rspackRsc.loadCss() + });", + } + `) + }) + + test('detects transform imports without enabling them outside server builds', () => { + const compilerTransforms: Array<StartCompilerImportTransform> = + createRscCssCompilerTransforms({ + loadCssExpression: 'import.meta.viteRsc.loadCss()', + }) + + const code = ` + import { renderServerComponent } from '@tanstack/react-start/rsc' + export const renderable = renderServerComponent(<Card />) + ` + + expect(detectKindsInCode(code, 'server', { compilerTransforms })) + .toMatchInlineSnapshot(` + Set { + "External:react-rsc-render-server-component-css", + } + `) + expect( + detectKindsInCode(code, 'client', { compilerTransforms }), + ).toMatchInlineSnapshot(`Set {}`) + }) +}) diff --git a/packages/react-start-rsc/tests/setup.ts b/packages/react-start-rsc/tests/setup.ts new file mode 100644 index 0000000000..82055721d7 --- /dev/null +++ b/packages/react-start-rsc/tests/setup.ts @@ -0,0 +1,7 @@ +import { cleanup } from '@testing-library/react' +import { afterEach } from 'vitest' + +// Clean up after each test +afterEach(() => { + cleanup() +}) diff --git a/packages/react-start-rsc/tsconfig.json b/packages/react-start-rsc/tsconfig.json new file mode 100644 index 0000000000..8e611ace3b --- /dev/null +++ b/packages/react-start-rsc/tsconfig.json @@ -0,0 +1,9 @@ +{ + "extends": "../../tsconfig.json", + "compilerOptions": { + "jsx": "react-jsx", + "module": "esnext", + "lib": ["DOM", "DOM.Iterable", "ESNext"] + }, + "include": ["src", "vite.config.ts"] +} diff --git a/packages/react-start-rsc/vite.config.ts b/packages/react-start-rsc/vite.config.ts new file mode 100644 index 0000000000..c8dfcf917b --- /dev/null +++ b/packages/react-start-rsc/vite.config.ts @@ -0,0 +1,58 @@ +import { defineConfig, mergeConfig } from 'vitest/config' +import { tanstackViteConfig } from '@tanstack/vite-config' +import react from '@vitejs/plugin-react' +import { copyFilesPlugin } from '@tanstack/router-utils' +import packageJson from './package.json' + +const config = defineConfig({ + resolve: { + alias: { + 'virtual:tanstack-rsc-browser-decode': '@vitejs/plugin-rsc/browser', + }, + }, + plugins: [ + react(), + copyFilesPlugin({ + pattern: ['*.ts', '*.tsx', '!*.d.ts'], + fromDir: 'src/entry', + toDir: 'dist/plugin/entry', + }), + ], + test: { + include: ['**/*.{test-d,test,spec}.?(c|m)[jt]s?(x)'], + name: packageJson.name, + watch: false, + environment: 'jsdom', + setupFiles: ['./tests/setup.ts'], + }, +}) + +export default mergeConfig( + config, + tanstackViteConfig({ + srcDir: './src', + entry: [ + './src/index.ts', + './src/index.rsc.ts', + './src/serialization.client.ts', + './src/serialization.server.ts', + './src/plugin/rscCssTransform.ts', + './src/plugin/vite.ts', + './src/entry/rsc.tsx', + './src/rsbuild/ssr-decode.ts', + './src/rsbuild/browser-decode.ts', + ], + cjs: false, + // Externalize virtual modules and SSR-only imports - resolved at runtime by Vite plugins + externalDeps: [ + 'virtual:tanstack-rsc-runtime', + 'virtual:tanstack-rsc-browser-decode', + 'virtual:tanstack-rsc-ssr-decode', + 'virtual:tanstack-rsc-hmr', + '#tanstack-start-server-fn-resolver', + 'react-server-dom-rspack/client.node', + 'react-server-dom-rspack/client.browser', + 'react-server-dom-rspack/server', + ], + }), +) diff --git a/packages/react-start-server/CHANGELOG.md b/packages/react-start-server/CHANGELOG.md index aa853d26bc..4e9c25e32d 100644 --- a/packages/react-start-server/CHANGELOG.md +++ b/packages/react-start-server/CHANGELOG.md @@ -1,5 +1,379 @@ # @tanstack/react-start-server +## 1.167.13 + +### Patch Changes + +- Updated dependencies [[`9cb7a00`](https://github.com/TanStack/router/commit/9cb7a003e6e5fa3706711870c7b10a5266356e3b)]: + - @tanstack/start-server-core@1.169.8 + +## 1.167.12 + +### Patch Changes + +- Updated dependencies [[`2f53749`](https://github.com/TanStack/router/commit/2f5374945e2138559a51464f45a5152eae67e1dd)]: + - @tanstack/router-core@1.171.8 + - @tanstack/react-router@1.170.10 + - @tanstack/start-client-core@1.170.6 + - @tanstack/start-server-core@1.169.7 + +## 1.167.11 + +### Patch Changes + +- Updated dependencies [[`d1997b6`](https://github.com/TanStack/router/commit/d1997b66d7c24c1d64772bb8bab5caf9c6d9cc48)]: + - @tanstack/start-server-core@1.169.6 + - @tanstack/react-router@1.170.9 + - @tanstack/router-core@1.171.7 + - @tanstack/start-client-core@1.170.5 + +## 1.167.10 + +### Patch Changes + +- Updated dependencies [[`9c09bca`](https://github.com/TanStack/router/commit/9c09bca59e9613e9a6fd9b7149b0737898e705d6)]: + - @tanstack/start-server-core@1.169.5 + +## 1.167.9 + +### Patch Changes + +- Updated dependencies [[`a82cec6`](https://github.com/TanStack/router/commit/a82cec69474c366b36efdb3f43c4efe8311c485a), [`d8be4f8`](https://github.com/TanStack/router/commit/d8be4f8adf912128c96b7f83e9a6c49fb24b5eed)]: + - @tanstack/start-client-core@1.170.4 + - @tanstack/start-server-core@1.169.4 + +## 1.167.8 + +### Patch Changes + +- Updated dependencies [[`51a97a1`](https://github.com/TanStack/router/commit/51a97a167fb3ef1b8ca70fbb63db635158f43509)]: + - @tanstack/router-core@1.171.6 + - @tanstack/react-router@1.170.8 + - @tanstack/start-server-core@1.169.3 + - @tanstack/start-client-core@1.170.3 + +## 1.167.7 + +### Patch Changes + +- Updated dependencies [[`5268ba4`](https://github.com/TanStack/router/commit/5268ba4566233ea58880df85f167ad0401a93a46)]: + - @tanstack/router-core@1.171.5 + - @tanstack/react-router@1.170.7 + - @tanstack/start-client-core@1.170.2 + - @tanstack/start-server-core@1.169.2 + +## 1.167.6 + +### Patch Changes + +- Updated dependencies [[`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960), [`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960)]: + - @tanstack/router-core@1.171.4 + - @tanstack/react-router@1.170.6 + - @tanstack/start-client-core@1.170.1 + - @tanstack/start-server-core@1.169.1 + +## 1.167.5 + +### Patch Changes + +- Updated dependencies [[`5fa9e55`](https://github.com/TanStack/router/commit/5fa9e555f3a2edb5e45586623e6bcbfa7f7c7a6b)]: + - @tanstack/start-client-core@1.170.0 + - @tanstack/start-server-core@1.169.0 + - @tanstack/router-core@1.171.3 + - @tanstack/react-router@1.170.5 + +## 1.167.4 + +### Patch Changes + +- Updated dependencies [[`b60eb36`](https://github.com/TanStack/router/commit/b60eb36e59e8a468ee0742cbcf7f47aca1ff1c67)]: + - @tanstack/router-core@1.171.2 + - @tanstack/react-router@1.170.4 + - @tanstack/start-client-core@1.169.4 + - @tanstack/start-server-core@1.168.4 + +## 1.167.3 + +### Patch Changes + +- Updated dependencies [[`d9cf933`](https://github.com/TanStack/router/commit/d9cf9331b83fcbd2abfee75d839d862f9bb18e6b)]: + - @tanstack/router-core@1.171.1 + - @tanstack/react-router@1.170.3 + - @tanstack/start-client-core@1.169.3 + - @tanstack/start-server-core@1.168.3 + +## 1.167.2 + +### Patch Changes + +- Updated dependencies [[`d533f87`](https://github.com/TanStack/router/commit/d533f87976704098a40b48f160b37c28c8182806)]: + - @tanstack/router-core@1.171.0 + - @tanstack/react-router@1.170.2 + - @tanstack/start-client-core@1.169.2 + - @tanstack/start-server-core@1.168.2 + +## 1.167.1 + +### Patch Changes + +- Updated dependencies [[`2387a2e`](https://github.com/TanStack/router/commit/2387a2eea0683004cc400b9f71bed5944eb60110)]: + - @tanstack/router-core@1.170.1 + - @tanstack/start-server-core@1.168.1 + - @tanstack/react-router@1.170.1 + - @tanstack/start-client-core@1.169.1 + +## 1.167.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- Updated dependencies [[`b1c061a`](https://github.com/TanStack/router/commit/b1c061aff9185cdf5fdc08c0136382a9dce0302f), [`201e150`](https://github.com/TanStack/router/commit/201e150bd1412bae2faa9ce53f0fefcb7574ac14), [`5ae2ae5`](https://github.com/TanStack/router/commit/5ae2ae5e0f8ce32e02667a482ea9be52a6150240)]: + - @tanstack/router-core@1.170.0 + - @tanstack/history@1.162.0 + - @tanstack/react-router@1.170.0 + - @tanstack/start-client-core@1.169.0 + - @tanstack/start-server-core@1.168.0 + +## 1.166.52 + +### Patch Changes + +- Updated dependencies [[`35e88f0`](https://github.com/TanStack/router/commit/35e88f04996d71019a1868b7b06ecb4ddbc9df9e)]: + - @tanstack/router-core@1.169.2 + - @tanstack/start-client-core@1.168.2 + - @tanstack/start-server-core@1.167.30 + - @tanstack/react-router@1.169.2 + +## 1.166.51 + +### Patch Changes + +- Updated dependencies [[`afa40ef`](https://github.com/TanStack/router/commit/afa40ef46c273c53646ba33f607fc618a07ffede)]: + - @tanstack/start-server-core@1.167.29 + +## 1.166.50 + +### Patch Changes + +- Add opt-in Start response Link headers for collected Early Hints. ([#7327](https://github.com/TanStack/router/pull/7327)) + +- Updated dependencies [[`709627f`](https://github.com/TanStack/router/commit/709627f3dbc6d97daa547a1401ef42a53bc4be32)]: + - @tanstack/start-server-core@1.167.28 + +## 1.166.49 + +### Patch Changes + +- Add experimental HTTP 103 Early Hints support to Start server handlers. ([#7324](https://github.com/TanStack/router/pull/7324)) + +- Updated dependencies [[`238ea4a`](https://github.com/TanStack/router/commit/238ea4a4998ab3a7fd528b317e1935766ac65df8)]: + - @tanstack/start-server-core@1.167.27 + +## 1.166.48 + +### Patch Changes + +- Updated dependencies [[`4a1e63f`](https://github.com/TanStack/router/commit/4a1e63f1d1230b1ed8234609acad4639d8982c13)]: + - @tanstack/router-core@1.169.1 + - @tanstack/react-router@1.169.1 + - @tanstack/start-client-core@1.168.1 + - @tanstack/start-server-core@1.167.26 + +## 1.166.47 + +### Patch Changes + +- Updated dependencies [[`82b0613`](https://github.com/TanStack/router/commit/82b06132af776f74603ab27977cc277d6219a845)]: + - @tanstack/start-client-core@1.168.0 + - @tanstack/start-server-core@1.167.25 + +## 1.166.46 + +### Patch Changes + +- Updated dependencies [[`c992495`](https://github.com/TanStack/router/commit/c992495bf4010ff4c3597bb1f3b1ba02594e857e)]: + - @tanstack/router-core@1.169.0 + - @tanstack/react-router@1.169.0 + - @tanstack/start-client-core@1.167.22 + - @tanstack/start-server-core@1.167.24 + +## 1.166.45 + +### Patch Changes + +- Updated dependencies [[`b5c4183`](https://github.com/TanStack/router/commit/b5c4183ab8b44be8a75647b7f7b588ad7c146ece)]: + - @tanstack/router-core@1.168.18 + - @tanstack/react-router@1.168.26 + - @tanstack/start-client-core@1.167.21 + - @tanstack/start-server-core@1.167.23 + +## 1.166.44 + +### Patch Changes + +- Updated dependencies [[`493148b`](https://github.com/TanStack/router/commit/493148bc5378b7f9de1544d87f6aaa425c12eb34)]: + - @tanstack/router-core@1.168.17 + - @tanstack/react-router@1.168.25 + - @tanstack/start-client-core@1.167.20 + - @tanstack/start-server-core@1.167.22 + +## 1.166.43 + +### Patch Changes + +- Updated dependencies [[`8b97002`](https://github.com/TanStack/router/commit/8b97002af3f6d15204e60c55d3f5735b78bd7efe)]: + - @tanstack/start-client-core@1.167.19 + - @tanstack/start-server-core@1.167.21 + +## 1.166.42 + +### Patch Changes + +- Updated dependencies [[`4d864ee`](https://github.com/TanStack/router/commit/4d864eebbd184265eabb563d326ab409c93feb17)]: + - @tanstack/react-router@1.168.24 + - @tanstack/router-core@1.168.16 + - @tanstack/start-server-core@1.167.20 + - @tanstack/start-client-core@1.167.18 + +## 1.166.41 + +### Patch Changes + +- Updated dependencies [[`cd91cee`](https://github.com/TanStack/router/commit/cd91ceebb84b7b752b5ee09ac14e89ad2beb2259)]: + - @tanstack/react-router@1.168.23 + +## 1.166.40 + +### Patch Changes + +- Updated dependencies [[`e30814d`](https://github.com/TanStack/router/commit/e30814d949110ff25829de44d729ead47555940a)]: + - @tanstack/react-router@1.168.22 + +## 1.166.39 + +### Patch Changes + +- Updated dependencies [[`16f6892`](https://github.com/TanStack/router/commit/16f6892d6b7ceadf606677c5a40e743f29163aa6)]: + - @tanstack/router-core@1.168.15 + - @tanstack/react-router@1.168.21 + - @tanstack/start-client-core@1.167.17 + - @tanstack/start-server-core@1.167.19 + +## 1.166.38 + +### Patch Changes + +- Updated dependencies [[`c5ad329`](https://github.com/TanStack/router/commit/c5ad32936f6adcca0c56474677b73b212498443b)]: + - @tanstack/react-router@1.168.20 + +## 1.166.37 + +### Patch Changes + +- Updated dependencies [[`105d056`](https://github.com/TanStack/router/commit/105d05691a247779a63e7b688aa1207cce619339)]: + - @tanstack/react-router@1.168.19 + +## 1.166.36 + +### Patch Changes + +- Updated dependencies [[`0e2c900`](https://github.com/TanStack/router/commit/0e2c9003c18ae07c09969189c028f277ea562a7a)]: + - @tanstack/start-server-core@1.167.18 + - @tanstack/router-core@1.168.14 + - @tanstack/react-router@1.168.18 + - @tanstack/start-client-core@1.167.16 + +## 1.166.35 + +### Patch Changes + +- Updated dependencies [[`812792f`](https://github.com/TanStack/router/commit/812792fbda3caf97b300770855cf5641252f413b)]: + - @tanstack/router-core@1.168.13 + - @tanstack/start-server-core@1.167.17 + - @tanstack/react-router@1.168.17 + - @tanstack/start-client-core@1.167.15 + +## 1.166.34 + +### Patch Changes + +- Updated dependencies [[`8ec9ca9`](https://github.com/TanStack/router/commit/8ec9ca97b472779de878c2a6510f21deb24d386c)]: + - @tanstack/router-core@1.168.12 + - @tanstack/react-router@1.168.16 + - @tanstack/start-client-core@1.167.14 + - @tanstack/start-server-core@1.167.16 + +## 1.166.33 + +### Patch Changes + +- Updated dependencies [[`6355bb7`](https://github.com/TanStack/router/commit/6355bb75f7637ba77f06a923c18fdaf37720bb48)]: + - @tanstack/start-server-core@1.167.15 + - @tanstack/react-router@1.168.15 + - @tanstack/router-core@1.168.11 + - @tanstack/start-client-core@1.167.13 + +## 1.166.32 + +### Patch Changes + +- Updated dependencies [[`459057c`](https://github.com/TanStack/router/commit/459057cd2d90cff20d20e51d4964b0a8c950555e)]: + - @tanstack/start-client-core@1.167.12 + - @tanstack/start-server-core@1.167.14 + - @tanstack/react-router@1.168.14 + - @tanstack/router-core@1.168.10 + +## 1.166.31 + +### Patch Changes + +- fix publishing ([`f8ac427`](https://github.com/TanStack/router/commit/f8ac427000c3fec99225926e72f9f2fc7a37231f)) + +- Updated dependencies [[`f8ac427`](https://github.com/TanStack/router/commit/f8ac427000c3fec99225926e72f9f2fc7a37231f)]: + - @tanstack/start-server-core@1.167.13 + - @tanstack/start-client-core@1.167.11 + +## 1.166.30 + +### Patch Changes + +- fix publishing ([`2d53c05`](https://github.com/TanStack/router/commit/2d53c056ef0b203de8a28bc92c24e8e604205d52)) + +- Updated dependencies [[`2d53c05`](https://github.com/TanStack/router/commit/2d53c056ef0b203de8a28bc92c24e8e604205d52)]: + - @tanstack/start-server-core@1.167.12 + +## 1.166.29 + +### Patch Changes + +- Updated dependencies [[`540d221`](https://github.com/TanStack/router/commit/540d22100d33415a1ddc9eb193f6aeb8184da77f), [`70ec1da`](https://github.com/TanStack/router/commit/70ec1da1ed8aa252fae67716f69fe8520ecf91b0)]: + - @tanstack/react-router@1.168.13 + +## 1.166.28 + +### Patch Changes + +- Updated dependencies [[`b29d64d`](https://github.com/TanStack/router/commit/b29d64de0c400183114c12f82183f80e37d9ea5c)]: + - @tanstack/react-router@1.168.12 + +## 1.166.27 + +### Patch Changes + +- Updated dependencies [[`4b9ed6c`](https://github.com/TanStack/router/commit/4b9ed6c5cb5437df8607c605728c8338dd2eb02c)]: + - @tanstack/react-router@1.168.11 + +## 1.166.26 + +### Patch Changes + +- Updated dependencies [[`f7e9c5e`](https://github.com/TanStack/router/commit/f7e9c5e323793d1b28c96871819c265fd28ae397)]: + - @tanstack/start-client-core@1.167.10 + - @tanstack/start-server-core@1.167.10 + ## 1.166.25 ### Patch Changes diff --git a/packages/react-start-server/package.json b/packages/react-start-server/package.json index fc42d20850..b3bb21ec27 100644 --- a/packages/react-start-server/package.json +++ b/packages/react-start-server/package.json @@ -1,6 +1,6 @@ { "name": "@tanstack/react-start-server", - "version": "1.166.25", + "version": "1.167.13", "description": "Modern and scalable routing for React applications", "author": "Tanner Linsley", "license": "MIT", diff --git a/packages/react-start/CHANGELOG.md b/packages/react-start/CHANGELOG.md index 5f401544cc..1b625f4767 100644 --- a/packages/react-start/CHANGELOG.md +++ b/packages/react-start/CHANGELOG.md @@ -1,5 +1,746 @@ # @tanstack/react-start +## 1.168.18 + +### Patch Changes + +- [#7509](https://github.com/TanStack/router/pull/7509) [`9cb7a00`](https://github.com/TanStack/router/commit/9cb7a003e6e5fa3706711870c7b10a5266356e3b) - feat(rsbuild): add RSC support + +- Updated dependencies [[`9cb7a00`](https://github.com/TanStack/router/commit/9cb7a003e6e5fa3706711870c7b10a5266356e3b)]: + - @tanstack/start-plugin-core@1.171.10 + - @tanstack/start-server-core@1.169.8 + - @tanstack/react-start-rsc@0.1.17 + - @tanstack/react-start-server@1.167.13 + +## 1.168.17 + +### Patch Changes + +- [#7505](https://github.com/TanStack/router/pull/7505) [`2f53749`](https://github.com/TanStack/router/commit/2f5374945e2138559a51464f45a5152eae67e1dd) - Preserve primitive values thrown from beforeLoad error handling. + +- Updated dependencies [[`2f53749`](https://github.com/TanStack/router/commit/2f5374945e2138559a51464f45a5152eae67e1dd)]: + - @tanstack/react-router@1.170.10 + - @tanstack/react-start-client@1.168.7 + - @tanstack/react-start-rsc@0.1.16 + - @tanstack/react-start-server@1.167.12 + - @tanstack/start-client-core@1.170.6 + - @tanstack/start-plugin-core@1.171.9 + - @tanstack/start-server-core@1.169.7 + +## 1.168.16 + +### Patch Changes + +- Updated dependencies [[`d1997b6`](https://github.com/TanStack/router/commit/d1997b66d7c24c1d64772bb8bab5caf9c6d9cc48)]: + - @tanstack/start-server-core@1.169.6 + - @tanstack/react-router@1.170.9 + - @tanstack/react-start-rsc@0.1.15 + - @tanstack/react-start-server@1.167.11 + - @tanstack/start-plugin-core@1.171.8 + - @tanstack/react-start-client@1.168.6 + - @tanstack/start-client-core@1.170.5 + +## 1.168.15 + +### Patch Changes + +- Updated dependencies [[`9c09bca`](https://github.com/TanStack/router/commit/9c09bca59e9613e9a6fd9b7149b0737898e705d6)]: + - @tanstack/start-plugin-core@1.171.7 + - @tanstack/start-server-core@1.169.5 + - @tanstack/react-start-rsc@0.1.14 + - @tanstack/react-start-server@1.167.10 + +## 1.168.14 + +### Patch Changes + +- [#7492](https://github.com/TanStack/router/pull/7492) [`71fb329`](https://github.com/TanStack/router/commit/71fb3297e93a126e1bcfd9eeb0626cc4b8df8dd8) - Avoid pulling the client hydration entry into root `@tanstack/react-start` and `@tanstack/solid-start` imports by re-exporting `Hydrate` from framework client Hydrate-only subpaths. + +- Updated dependencies [[`71fb329`](https://github.com/TanStack/router/commit/71fb3297e93a126e1bcfd9eeb0626cc4b8df8dd8)]: + - @tanstack/react-start-client@1.168.5 + +## 1.168.13 + +### Patch Changes + +- Fix serialization adapter module resolution in TanStack Start. Vite dev now uses clean runtime-specific virtual module IDs instead of browser requests containing encoded null-byte virtual IDs, which avoids reverse proxy failures. When no serialization adapters are configured, Vite and Rsbuild now resolve `#tanstack-start-plugin-adapters` through the package empty-adapter fallback. ([#7484](https://github.com/TanStack/router/pull/7484)) + +- Publish matching TanStack Start dev server packages so fresh installs do not pair a Start plugin that no longer provides `tanstack-start-injected-head-scripts:v` with an older Start server runtime that still imports it. ([#7487](https://github.com/TanStack/router/pull/7487)) + +- Updated dependencies [[`a82cec6`](https://github.com/TanStack/router/commit/a82cec69474c366b36efdb3f43c4efe8311c485a), [`d8be4f8`](https://github.com/TanStack/router/commit/d8be4f8adf912128c96b7f83e9a6c49fb24b5eed)]: + - @tanstack/start-plugin-core@1.171.6 + - @tanstack/start-client-core@1.170.4 + - @tanstack/start-server-core@1.169.4 + - @tanstack/react-start-rsc@0.1.13 + - @tanstack/react-start-client@1.168.4 + - @tanstack/react-start-server@1.167.9 + +## 1.168.12 + +### Patch Changes + +- Add Vite bundled dev mode support for TanStack Start. Start now recognizes Vite's `experimental.bundledDev` opt-in, uses the bundled dev client entry in the dev manifest, keeps server requests pointed at the latest client build output, and preserves import-protection behavior for bundled client dev. ([#7482](https://github.com/TanStack/router/pull/7482)) + +- Updated dependencies [[`90adda9`](https://github.com/TanStack/router/commit/90adda91aab7212cbcdb6159176b39d9ed01b827)]: + - @tanstack/start-plugin-core@1.171.5 + - @tanstack/react-start-rsc@0.1.12 + +## 1.168.11 + +### Patch Changes + +- Add support for Rsbuild client output formats, including module output by default and IIFE output for classic script environments. ([#7477](https://github.com/TanStack/router/pull/7477)) + + Client entry scripts and preloads are now represented as root route manifest assets, script preloads follow the manifest script format, and script asset cross-origin configuration uses the `script` key. The `transformAssets` script callback context now exposes only `kind: 'script'` and `url`, keeping script format handling internal to manifest rendering. + +- Fix Rsbuild server function metadata replay when Rspack restores modules from its persistent cache. ([#7477](https://github.com/TanStack/router/pull/7477)) + + Server function metadata is now stored on Rspack module build info and replayed from cached modules before resolver modules are rebuilt, preventing warm restarts from losing server function registrations. + +- Updated dependencies [[`51a97a1`](https://github.com/TanStack/router/commit/51a97a167fb3ef1b8ca70fbb63db635158f43509), [`51a97a1`](https://github.com/TanStack/router/commit/51a97a167fb3ef1b8ca70fbb63db635158f43509)]: + - @tanstack/react-router@1.170.8 + - @tanstack/start-plugin-core@1.171.4 + - @tanstack/start-server-core@1.169.3 + - @tanstack/react-start-client@1.168.3 + - @tanstack/react-start-rsc@0.1.11 + - @tanstack/react-start-server@1.167.8 + - @tanstack/start-client-core@1.170.3 + +## 1.168.10 + +### Patch Changes + +- Explicitly re-export public API names from `@tanstack/start-client-core` (`createServerFn`, `createMiddleware`, `createStart`, `createCsrfMiddleware`, `createIsomorphicFn`, `createClientOnlyFn`, `createServerOnlyFn`) alongside the existing `export *`. The explicit named re-exports are registered at link time (via Vite SSR's `defineExport` at `fileStartIndex`), so the namespace has these getters before any import body runs — survives the cold-start SSR cycle through user middleware where `export *` would otherwise produce a partial facade (`createMiddleware is not a function`). Workaround for vitejs/vite#22491 / #22493. ([#7466](https://github.com/TanStack/router/pull/7466)) + +- Updated dependencies []: + - @tanstack/react-router@1.170.7 + - @tanstack/react-start-client@1.168.2 + - @tanstack/react-start-rsc@0.1.10 + - @tanstack/react-start-server@1.167.7 + - @tanstack/start-client-core@1.170.2 + - @tanstack/start-plugin-core@1.171.3 + - @tanstack/start-server-core@1.169.2 + +## 1.168.9 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.171.2 + - @tanstack/react-start-rsc@0.1.9 + +## 1.168.8 + +### Patch Changes + +- Updated dependencies [[`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960)]: + - @tanstack/react-router@1.170.6 + - @tanstack/react-start-client@1.168.1 + - @tanstack/react-start-rsc@0.1.8 + - @tanstack/react-start-server@1.167.6 + - @tanstack/start-client-core@1.170.1 + - @tanstack/start-plugin-core@1.171.1 + - @tanstack/start-server-core@1.169.1 + +## 1.168.7 + +### Patch Changes + +- Updated dependencies [[`5fa9e55`](https://github.com/TanStack/router/commit/5fa9e555f3a2edb5e45586623e6bcbfa7f7c7a6b)]: + - @tanstack/react-start-client@1.168.0 + - @tanstack/start-client-core@1.170.0 + - @tanstack/start-plugin-core@1.171.0 + - @tanstack/start-server-core@1.169.0 + - @tanstack/router-utils@1.162.1 + - @tanstack/react-start-rsc@0.1.7 + - @tanstack/react-start-server@1.167.5 + - @tanstack/react-router@1.170.5 + +## 1.168.6 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/react-router@1.170.4 + - @tanstack/react-start-client@1.167.4 + - @tanstack/react-start-rsc@0.1.6 + - @tanstack/react-start-server@1.167.4 + - @tanstack/start-client-core@1.169.4 + - @tanstack/start-plugin-core@1.170.6 + - @tanstack/start-server-core@1.168.4 + +## 1.168.5 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.170.5 + - @tanstack/react-start-rsc@0.1.5 + +## 1.168.4 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/react-router@1.170.3 + - @tanstack/react-start-client@1.167.3 + - @tanstack/react-start-rsc@0.1.4 + - @tanstack/react-start-server@1.167.3 + - @tanstack/start-client-core@1.169.3 + - @tanstack/start-plugin-core@1.170.4 + - @tanstack/start-server-core@1.168.3 + +## 1.168.3 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/react-router@1.170.2 + - @tanstack/react-start-client@1.167.2 + - @tanstack/react-start-rsc@0.1.3 + - @tanstack/react-start-server@1.167.2 + - @tanstack/start-client-core@1.169.2 + - @tanstack/start-plugin-core@1.170.3 + - @tanstack/start-server-core@1.168.2 + +## 1.168.2 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.170.2 + - @tanstack/react-start-rsc@0.1.2 + +## 1.168.1 + +### Patch Changes + +- Updated dependencies [[`2387a2e`](https://github.com/TanStack/router/commit/2387a2eea0683004cc400b9f71bed5944eb60110)]: + - @tanstack/start-plugin-core@1.170.1 + - @tanstack/start-server-core@1.168.1 + - @tanstack/react-router@1.170.1 + - @tanstack/react-start-client@1.167.1 + - @tanstack/react-start-rsc@0.1.1 + - @tanstack/react-start-server@1.167.1 + - @tanstack/start-client-core@1.169.1 + +## 1.168.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- Updated dependencies [[`201e150`](https://github.com/TanStack/router/commit/201e150bd1412bae2faa9ce53f0fefcb7574ac14), [`5ae2ae5`](https://github.com/TanStack/router/commit/5ae2ae5e0f8ce32e02667a482ea9be52a6150240)]: + - @tanstack/react-router@1.170.0 + - @tanstack/react-start-client@1.167.0 + - @tanstack/react-start-rsc@0.1.0 + - @tanstack/react-start-server@1.167.0 + - @tanstack/router-utils@1.162.0 + - @tanstack/start-client-core@1.169.0 + - @tanstack/start-plugin-core@1.170.0 + - @tanstack/start-server-core@1.168.0 + +## 1.167.65 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.169.20 + - @tanstack/react-start-rsc@0.0.44 + +## 1.167.64 + +### Patch Changes + +- Updated dependencies [[`35e88f0`](https://github.com/TanStack/router/commit/35e88f04996d71019a1868b7b06ecb4ddbc9df9e)]: + - @tanstack/start-client-core@1.168.2 + - @tanstack/start-plugin-core@1.169.19 + - @tanstack/start-server-core@1.167.30 + - @tanstack/react-router@1.169.2 + - @tanstack/react-start-client@1.166.48 + - @tanstack/react-start-rsc@0.0.43 + - @tanstack/react-start-server@1.166.52 + +## 1.167.63 + +### Patch Changes + +- Updated dependencies [[`056337e`](https://github.com/TanStack/router/commit/056337ef02ccbeaf45ec8533a227761be869e8f3)]: + - @tanstack/router-utils@1.161.8 + - @tanstack/start-plugin-core@1.169.18 + - @tanstack/react-start-rsc@0.0.42 + +## 1.167.62 + +### Patch Changes + +- Updated dependencies [[`afa40ef`](https://github.com/TanStack/router/commit/afa40ef46c273c53646ba33f607fc618a07ffede)]: + - @tanstack/start-server-core@1.167.29 + - @tanstack/react-start-rsc@0.0.41 + - @tanstack/react-start-server@1.166.51 + - @tanstack/start-plugin-core@1.169.17 + +## 1.167.61 + +### Patch Changes + +- Updated dependencies [[`709627f`](https://github.com/TanStack/router/commit/709627f3dbc6d97daa547a1401ef42a53bc4be32)]: + - @tanstack/start-server-core@1.167.28 + - @tanstack/react-start-server@1.166.50 + - @tanstack/react-start-rsc@0.0.40 + - @tanstack/start-plugin-core@1.169.16 + +## 1.167.60 + +### Patch Changes + +- Add experimental HTTP 103 Early Hints support to Start server handlers. ([#7324](https://github.com/TanStack/router/pull/7324)) + +- Updated dependencies [[`238ea4a`](https://github.com/TanStack/router/commit/238ea4a4998ab3a7fd528b317e1935766ac65df8)]: + - @tanstack/start-server-core@1.167.27 + - @tanstack/react-start-server@1.166.49 + - @tanstack/react-start-rsc@0.0.39 + - @tanstack/start-plugin-core@1.169.15 + +## 1.167.59 + +### Patch Changes + +- Updated dependencies [[`96818b8`](https://github.com/TanStack/router/commit/96818b8ba5ead6f1f027094841330182aff415b2)]: + - @tanstack/start-plugin-core@1.169.14 + - @tanstack/react-start-rsc@0.0.38 + +## 1.167.58 + +### Patch Changes + +- Add compiler-driven RSC CSS auto-injection for Start RSC render APIs and wire it into the React Start Vite and Rsbuild adapters. This ensures same-file CSS module dependencies are discovered for `renderServerComponent`, `createCompositeComponent`, and JSX-based `renderToReadableStream` calls. ([#7310](https://github.com/TanStack/router/pull/7310)) + + Also add a configurable server function provider module directive hook used by the React Rsbuild RSC adapter to emit `"use server-entry"` only for extracted provider files. + +- Updated dependencies [[`ae453b7`](https://github.com/TanStack/router/commit/ae453b78624cac1b574f0d1efbfbf6ca03922c6c)]: + - @tanstack/react-start-rsc@0.0.37 + - @tanstack/start-plugin-core@1.169.13 + +## 1.167.57 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/react-router@1.169.1 + - @tanstack/react-start-client@1.166.47 + - @tanstack/react-start-rsc@0.0.36 + - @tanstack/react-start-server@1.166.48 + - @tanstack/start-client-core@1.168.1 + - @tanstack/start-plugin-core@1.169.12 + - @tanstack/start-server-core@1.167.26 + +## 1.167.56 + +### Patch Changes + +- Updated dependencies [[`82b0613`](https://github.com/TanStack/router/commit/82b06132af776f74603ab27977cc277d6219a845)]: + - @tanstack/start-client-core@1.168.0 + - @tanstack/react-start-client@1.166.46 + - @tanstack/react-start-rsc@0.0.35 + - @tanstack/react-start-server@1.166.47 + - @tanstack/start-plugin-core@1.169.11 + - @tanstack/start-server-core@1.167.25 + +## 1.167.55 + +### Patch Changes + +- Updated dependencies [[`c4256c2`](https://github.com/TanStack/router/commit/c4256c2c857f392d2031cf87821e4c36a92d0382)]: + - @tanstack/start-plugin-core@1.169.10 + - @tanstack/react-start-rsc@0.0.34 + +## 1.167.54 + +### Patch Changes + +- Updated dependencies [[`761fcc0`](https://github.com/TanStack/router/commit/761fcc0c96dd96721b533a1fd9e2c972f222ef94)]: + - @tanstack/start-plugin-core@1.169.9 + - @tanstack/react-start-rsc@0.0.33 + +## 1.167.53 + +### Patch Changes + +- fix exports for react-start so useServerFn is available with RSC ([#7292](https://github.com/TanStack/router/pull/7292)) + +- Updated dependencies [[`c992495`](https://github.com/TanStack/router/commit/c992495bf4010ff4c3597bb1f3b1ba02594e857e)]: + - @tanstack/react-router@1.169.0 + - @tanstack/react-start-client@1.166.45 + - @tanstack/react-start-rsc@0.0.32 + - @tanstack/react-start-server@1.166.46 + - @tanstack/start-client-core@1.167.22 + - @tanstack/start-plugin-core@1.169.8 + - @tanstack/start-server-core@1.167.24 + +## 1.167.52 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/react-router@1.168.26 + - @tanstack/react-start-client@1.166.44 + - @tanstack/react-start-rsc@0.0.31 + - @tanstack/react-start-server@1.166.45 + - @tanstack/start-client-core@1.167.21 + - @tanstack/start-plugin-core@1.169.7 + - @tanstack/start-server-core@1.167.23 + +## 1.167.51 + +### Patch Changes + +- Updated dependencies [[`d6decca`](https://github.com/TanStack/router/commit/d6decca41807e9ca28279e2db6640e7a8bdc1229)]: + - @tanstack/react-start-rsc@0.0.30 + +## 1.167.50 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/react-router@1.168.25 + - @tanstack/react-start-client@1.166.43 + - @tanstack/react-start-rsc@0.0.29 + - @tanstack/react-start-server@1.166.44 + - @tanstack/start-client-core@1.167.20 + - @tanstack/start-plugin-core@1.169.6 + - @tanstack/start-server-core@1.167.22 + +## 1.167.49 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.169.5 + - @tanstack/react-start-rsc@0.0.28 + +## 1.167.48 + +### Patch Changes + +- Updated dependencies [[`8b97002`](https://github.com/TanStack/router/commit/8b97002af3f6d15204e60c55d3f5735b78bd7efe)]: + - @tanstack/start-client-core@1.167.19 + - @tanstack/react-start-client@1.166.42 + - @tanstack/react-start-rsc@0.0.27 + - @tanstack/react-start-server@1.166.43 + - @tanstack/start-plugin-core@1.169.4 + - @tanstack/start-server-core@1.167.21 + +## 1.167.47 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.169.3 + - @tanstack/react-start-rsc@0.0.26 + +## 1.167.46 + +### Patch Changes + +- Updated dependencies [[`4d864ee`](https://github.com/TanStack/router/commit/4d864eebbd184265eabb563d326ab409c93feb17)]: + - @tanstack/react-router@1.168.24 + - @tanstack/start-plugin-core@1.169.2 + - @tanstack/start-server-core@1.167.20 + - @tanstack/react-start-client@1.166.41 + - @tanstack/react-start-rsc@0.0.25 + - @tanstack/react-start-server@1.166.42 + - @tanstack/start-client-core@1.167.18 + +## 1.167.45 + +### Patch Changes + +- Updated dependencies [[`9252206`](https://github.com/TanStack/router/commit/9252206e5aeafe53e31eb7baa491d07a597c4dc6)]: + - @tanstack/start-plugin-core@1.169.1 + - @tanstack/react-start-rsc@0.0.24 + +## 1.167.44 + +### Patch Changes + +- Split Start plugin core bundler APIs into explicit Vite and Rsbuild subpaths so projects only need the bundler they use. Mark both `vite` and `@rsbuild/core` peers as optional where Start exposes both integrations. ([#7249](https://github.com/TanStack/router/pull/7249)) + +- Updated dependencies [[`dda463c`](https://github.com/TanStack/router/commit/dda463c8b571519165d3adbc337db7a0b8be1072)]: + - @tanstack/start-plugin-core@1.169.0 + - @tanstack/react-start-rsc@0.0.23 + +## 1.167.43 + +### Patch Changes + +- rsbuild ([#7228](https://github.com/TanStack/router/pull/7228)) + +- Updated dependencies [[`91a7089`](https://github.com/TanStack/router/commit/91a708989d00537a21911e74ff60bbfec8266295)]: + - @tanstack/start-plugin-core@1.168.0 + - @tanstack/react-start-rsc@0.0.22 + - @tanstack/router-utils@1.161.7 + +## 1.167.42 + +### Patch Changes + +- Updated dependencies [[`cd91cee`](https://github.com/TanStack/router/commit/cd91ceebb84b7b752b5ee09ac14e89ad2beb2259)]: + - @tanstack/react-router@1.168.23 + - @tanstack/react-start-client@1.166.40 + - @tanstack/react-start-rsc@0.0.21 + - @tanstack/react-start-server@1.166.41 + +## 1.167.41 + +### Patch Changes + +- Updated dependencies [[`f7f0025`](https://github.com/TanStack/router/commit/f7f00250f39cf0276a984558e5d427e9270d9635)]: + - @tanstack/start-plugin-core@1.167.35 + - @tanstack/react-start-rsc@0.0.20 + +## 1.167.40 + +### Patch Changes + +- Updated dependencies [[`e30814d`](https://github.com/TanStack/router/commit/e30814d949110ff25829de44d729ead47555940a)]: + - @tanstack/react-router@1.168.22 + - @tanstack/react-start-client@1.166.39 + - @tanstack/react-start-rsc@0.0.19 + - @tanstack/react-start-server@1.166.40 + +## 1.167.39 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/react-router@1.168.21 + - @tanstack/react-start-client@1.166.38 + - @tanstack/react-start-rsc@0.0.18 + - @tanstack/react-start-server@1.166.39 + - @tanstack/start-client-core@1.167.17 + - @tanstack/start-plugin-core@1.167.34 + - @tanstack/start-server-core@1.167.19 + +## 1.167.38 + +### Patch Changes + +- Updated dependencies [[`c5ad329`](https://github.com/TanStack/router/commit/c5ad32936f6adcca0c56474677b73b212498443b)]: + - @tanstack/react-router@1.168.20 + - @tanstack/react-start-client@1.166.37 + - @tanstack/react-start-rsc@0.0.17 + - @tanstack/react-start-server@1.166.38 + +## 1.167.37 + +### Patch Changes + +- Fix `@tanstack/react-start/server` imports inside React Server Components by adding a `react-server` export condition that resolves to the request/response APIs without pulling in the SSR renderer entrypoints. ([#7180](https://github.com/TanStack/router/pull/7180)) + + This fixes RSC routes that call `createServerFn` loaders and read request headers in dev with `@vitejs/plugin-rsc` enabled. + +## 1.167.36 + +### Patch Changes + +- Updated dependencies [[`a581680`](https://github.com/TanStack/router/commit/a581680a27530469751b8ab419ada9ce66da4ffe)]: + - @tanstack/start-plugin-core@1.167.33 + - @tanstack/react-start-rsc@0.0.16 + +## 1.167.35 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.167.32 + - @tanstack/react-start-rsc@0.0.15 + +## 1.167.34 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.167.31 + - @tanstack/react-start-rsc@0.0.14 + +## 1.167.33 + +### Patch Changes + +- Updated dependencies [[`105d056`](https://github.com/TanStack/router/commit/105d05691a247779a63e7b688aa1207cce619339)]: + - @tanstack/react-router@1.168.19 + - @tanstack/start-plugin-core@1.167.30 + - @tanstack/react-start-client@1.166.36 + - @tanstack/react-start-rsc@0.0.13 + - @tanstack/react-start-server@1.166.37 + +## 1.167.32 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.167.29 + - @tanstack/react-start-rsc@0.0.12 + +## 1.167.31 + +### Patch Changes + +- Updated dependencies [[`0e2c900`](https://github.com/TanStack/router/commit/0e2c9003c18ae07c09969189c028f277ea562a7a)]: + - @tanstack/start-server-core@1.167.18 + - @tanstack/react-start-rsc@0.0.11 + - @tanstack/react-start-server@1.166.36 + - @tanstack/start-plugin-core@1.167.28 + - @tanstack/react-router@1.168.18 + - @tanstack/react-start-client@1.166.35 + - @tanstack/start-client-core@1.167.16 + +## 1.167.30 + +### Patch Changes + +- Updated dependencies [[`812792f`](https://github.com/TanStack/router/commit/812792fbda3caf97b300770855cf5641252f413b)]: + - @tanstack/start-plugin-core@1.167.27 + - @tanstack/start-server-core@1.167.17 + - @tanstack/react-router@1.168.17 + - @tanstack/react-start-client@1.166.34 + - @tanstack/react-start-rsc@0.0.10 + - @tanstack/react-start-server@1.166.35 + - @tanstack/start-client-core@1.167.15 + +## 1.167.29 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/react-router@1.168.16 + - @tanstack/react-start-client@1.166.33 + - @tanstack/react-start-rsc@0.0.9 + - @tanstack/react-start-server@1.166.34 + - @tanstack/start-client-core@1.167.14 + - @tanstack/start-plugin-core@1.167.26 + - @tanstack/start-server-core@1.167.16 + +## 1.167.28 + +### Patch Changes + +- Updated dependencies [[`d3f20fb`](https://github.com/TanStack/router/commit/d3f20fbe7acf69c3bd108c5ddc9748ad47690b04)]: + - @tanstack/start-plugin-core@1.167.25 + - @tanstack/react-start-rsc@0.0.8 + +## 1.167.27 + +### Patch Changes + +- Updated dependencies [[`6355bb7`](https://github.com/TanStack/router/commit/6355bb75f7637ba77f06a923c18fdaf37720bb48)]: + - @tanstack/start-server-core@1.167.15 + - @tanstack/react-router@1.168.15 + - @tanstack/react-start-rsc@0.0.7 + - @tanstack/react-start-server@1.166.33 + - @tanstack/start-plugin-core@1.167.24 + - @tanstack/react-start-client@1.166.32 + - @tanstack/start-client-core@1.167.13 + +## 1.167.26 + +### Patch Changes + +- migrate createStore > createAtom for simpler API ([#7150](https://github.com/TanStack/router/pull/7150)) + +- Updated dependencies [[`459057c`](https://github.com/TanStack/router/commit/459057cd2d90cff20d20e51d4964b0a8c950555e)]: + - @tanstack/start-client-core@1.167.12 + - @tanstack/start-server-core@1.167.14 + - @tanstack/react-router@1.168.14 + - @tanstack/react-start-client@1.166.31 + - @tanstack/react-start-rsc@0.0.6 + - @tanstack/react-start-server@1.166.32 + - @tanstack/start-plugin-core@1.167.23 + +## 1.167.25 + +### Patch Changes + +- fix publishing ([`f8ac427`](https://github.com/TanStack/router/commit/f8ac427000c3fec99225926e72f9f2fc7a37231f)) + +- Updated dependencies [[`f8ac427`](https://github.com/TanStack/router/commit/f8ac427000c3fec99225926e72f9f2fc7a37231f)]: + - @tanstack/start-server-core@1.167.13 + - @tanstack/start-client-core@1.167.11 + - @tanstack/react-start-client@1.166.30 + - @tanstack/react-start-server@1.166.31 + - @tanstack/react-start-rsc@0.0.5 + - @tanstack/start-plugin-core@1.167.22 + +## 1.167.24 + +### Patch Changes + +- fix publishing ([`2d53c05`](https://github.com/TanStack/router/commit/2d53c056ef0b203de8a28bc92c24e8e604205d52)) + +- Updated dependencies [[`2d53c05`](https://github.com/TanStack/router/commit/2d53c056ef0b203de8a28bc92c24e8e604205d52)]: + - @tanstack/start-server-core@1.167.12 + - @tanstack/start-plugin-core@1.167.21 + - @tanstack/react-start-server@1.166.30 + - @tanstack/react-start-rsc@0.0.4 + +## 1.167.22 + +### Patch Changes + +- Republish the React Start RSC package chain so fresh installs resolve a `start-plugin-core` build that exports the subpaths used by `react-start-rsc`. ([`3384abc`](https://github.com/TanStack/router/commit/3384abcffd98a68eb254b11221834bcbcdebec31)) + +- Updated dependencies [[`3384abc`](https://github.com/TanStack/router/commit/3384abcffd98a68eb254b11221834bcbcdebec31)]: + - @tanstack/start-plugin-core@1.167.19 + - @tanstack/react-start-rsc@0.0.2 + +## 1.167.21 + +### Patch Changes + +- Updated dependencies [[`f920527`](https://github.com/TanStack/router/commit/f920527e8d5a2124f0c8a1b2c9889c9d1bf29d90)]: + - @tanstack/react-start-rsc@0.0.1 + +## 1.167.20 + +### Patch Changes + +- Updated dependencies [[`540d221`](https://github.com/TanStack/router/commit/540d22100d33415a1ddc9eb193f6aeb8184da77f), [`70ec1da`](https://github.com/TanStack/router/commit/70ec1da1ed8aa252fae67716f69fe8520ecf91b0)]: + - @tanstack/react-router@1.168.13 + - @tanstack/react-start-client@1.166.29 + - @tanstack/react-start-server@1.166.29 + +## 1.167.19 + +### Patch Changes + +- Updated dependencies [[`b29d64d`](https://github.com/TanStack/router/commit/b29d64de0c400183114c12f82183f80e37d9ea5c)]: + - @tanstack/react-router@1.168.12 + - @tanstack/react-start-client@1.166.28 + - @tanstack/react-start-server@1.166.28 + +## 1.167.18 + +### Patch Changes + +- Updated dependencies [[`4b9ed6c`](https://github.com/TanStack/router/commit/4b9ed6c5cb5437df8607c605728c8338dd2eb02c)]: + - @tanstack/react-router@1.168.11 + - @tanstack/react-start-client@1.166.27 + - @tanstack/react-start-server@1.166.27 + +## 1.167.17 + +### Patch Changes + +- Updated dependencies [[`f7e9c5e`](https://github.com/TanStack/router/commit/f7e9c5e323793d1b28c96871819c265fd28ae397)]: + - @tanstack/start-client-core@1.167.10 + - @tanstack/start-server-core@1.167.10 + - @tanstack/react-start-client@1.166.26 + - @tanstack/react-start-server@1.166.26 + - @tanstack/start-plugin-core@1.167.18 + ## 1.167.16 ### Patch Changes diff --git a/packages/react-start/bin/intent.js b/packages/react-start/bin/intent.js deleted file mode 100755 index 5b08532885..0000000000 --- a/packages/react-start/bin/intent.js +++ /dev/null @@ -1,25 +0,0 @@ -#!/usr/bin/env node -// Auto-generated by @tanstack/intent setup -// Exposes the intent end-user CLI for consumers of this library. -// Commit this file, then add to your package.json: -// "bin": { "intent": "./bin/intent.js" } -try { - await import('@tanstack/intent/intent-library') -} catch (e) { - const isModuleNotFound = - e?.code === 'ERR_MODULE_NOT_FOUND' || e?.code === 'MODULE_NOT_FOUND' - const missingIntentLibrary = - typeof e?.message === 'string' && e.message.includes('@tanstack/intent') - - if (isModuleNotFound && missingIntentLibrary) { - console.error('@tanstack/intent is not installed.') - console.error('') - console.error('Install it as a dev dependency:') - console.error(' npm add -D @tanstack/intent') - console.error('') - console.error('Or run directly:') - console.error(' npx @tanstack/intent@latest list') - process.exit(1) - } - throw e -} diff --git a/packages/react-start/package.json b/packages/react-start/package.json index 20c6ecbcb2..55e943520e 100644 --- a/packages/react-start/package.json +++ b/packages/react-start/package.json @@ -1,6 +1,6 @@ { "name": "@tanstack/react-start", - "version": "1.167.16", + "version": "1.168.18", "description": "Modern and scalable routing for React applications", "author": "Tanner Linsley", "license": "MIT", @@ -33,6 +33,10 @@ "types": "dist/esm/index.d.ts", "exports": { ".": { + "react-server": { + "types": "./dist/esm/index.d.ts", + "default": "./dist/esm/index.js" + }, "import": { "types": "./dist/esm/index.d.ts", "default": "./dist/esm/index.js" @@ -44,6 +48,12 @@ "default": "./dist/esm/client.js" } }, + "./hydration": { + "import": { + "types": "./dist/esm/hydration.d.ts", + "default": "./dist/esm/hydration.js" + } + }, "./client-rpc": { "import": { "types": "./dist/esm/client-rpc.d.ts", @@ -51,6 +61,10 @@ } }, "./server": { + "react-server": { + "types": "./dist/esm/server.rsc.d.ts", + "default": "./dist/esm/server.rsc.js" + }, "import": { "types": "./dist/esm/server.d.ts", "default": "./dist/esm/server.js" @@ -74,12 +88,52 @@ "default": "./dist/esm/plugin/vite.js" } }, + "./plugin/rsbuild": { + "import": { + "types": "./dist/esm/plugin/rsbuild.d.ts", + "default": "./dist/esm/plugin/rsbuild.js" + } + }, "./server-entry": { "import": { "types": "./dist/default-entry/esm/server.d.ts", "default": "./dist/default-entry/esm/server.js" } }, + "./rsc": { + "react-server": { + "types": "./dist/esm/rsc.rsc.d.ts", + "default": "./dist/esm/rsc.rsc.js" + }, + "import": { + "types": "./dist/esm/rsc.d.ts", + "default": "./dist/esm/rsc.js" + } + }, + "./rsc/serialization/server": { + "import": { + "types": "./dist/esm/rsc/serialization/server.d.ts", + "default": "./dist/esm/rsc/serialization/server.js" + } + }, + "./rsc/serialization/client": { + "import": { + "types": "./dist/esm/rsc/serialization/client.d.ts", + "default": "./dist/esm/rsc/serialization/client.js" + } + }, + "./rsbuild/browser-decode": { + "import": { + "types": "./dist/esm/rsbuild/browser-decode.d.ts", + "default": "./dist/esm/rsbuild/browser-decode.js" + } + }, + "./rsbuild/ssr-decode": { + "import": { + "types": "./dist/esm/rsbuild/ssr-decode.d.ts", + "default": "./dist/esm/rsbuild/ssr-decode.js" + } + }, "./server-only": { "import": { "types": "./dist/esm/server-only.d.ts", @@ -106,25 +160,35 @@ "node": ">=22.12.0" }, "dependencies": { - "@tanstack/react-start-client": "workspace:*", - "@tanstack/react-start-server": "workspace:*", - "@tanstack/router-utils": "workspace:^", - "@tanstack/start-plugin-core": "workspace:*", "@tanstack/react-router": "workspace:*", + "@tanstack/react-start-client": "workspace:*", + "@tanstack/react-start-rsc": "workspace:*", + "@tanstack/react-start-server": "workspace:*", + "@tanstack/router-utils": "workspace:*", "@tanstack/start-client-core": "workspace:*", + "@tanstack/start-plugin-core": "workspace:*", "@tanstack/start-server-core": "workspace:*", "pathe": "^2.0.3" }, "peerDependencies": { + "@rsbuild/core": "^2.0.0", "react": ">=18.0.0 || >=19.0.0", "react-dom": ">=18.0.0 || >=19.0.0", "vite": ">=7.0.0" }, - "devDependencies": { - "@tanstack/intent": "^0.0.14", - "@types/node": ">=20" + "peerDependenciesMeta": { + "@rsbuild/core": { + "optional": true + }, + "@vitejs/plugin-rsc": { + "optional": true + }, + "vite": { + "optional": true + } }, - "bin": { - "intent": "./bin/intent.js" + "devDependencies": { + "@rsbuild/core": "^2.0.8", + "@types/node": ">=20" } } diff --git a/packages/react-start/skills/_artifacts/domain_map.yaml b/packages/react-start/skills/_artifacts/domain_map.yaml index b5e84d4dfb..271b1fe746 100644 --- a/packages/react-start/skills/_artifacts/domain_map.yaml +++ b/packages/react-start/skills/_artifacts/domain_map.yaml @@ -444,6 +444,65 @@ skills: priority: MEDIUM status: active + - name: 'Server Components' + slug: 'server-components' + domain: 'deployment-and-rendering' + description: >- + Implement and debug TanStack Start React Server Components with + renderServerComponent, createCompositeComponent, low-level + Flight streaming APIs, Router vs Query cache ownership, refresh + paths, and selective SSR modes. + type: sub-skill + packages: + - '@tanstack/react-start' + - '@tanstack/react-start-rsc' + covers: + - renderServerComponent + - createCompositeComponent + - CompositeComponent + - renderToReadableStream + - createFromReadableStream + - createFromFetch + - Router-owned RSC caching + - Query-owned RSC caching + - Refresh ownership (router.invalidate, invalidateQueries, refetchQueries) + - "Selective SSR modes (ssr: 'data-only', ssr: false)" + - 'structuralSharing: false for Query-cached RSC values' + tasks: + - 'Implement route-owned React Server Components' + - 'Choose between renderServerComponent and createCompositeComponent' + - 'Debug stale RSC data and invalidation' + - 'Migrate Next App Router RSC patterns to TanStack Start' + failure_modes: + - mistake: 'Using renderServerComponent when the UI needs slots' + mechanism: >- + renderServerComponent returns a renderable value and does + not support client-provided children, render props, or + component props. Use createCompositeComponent and render it + with CompositeComponent when the server output must accept + slots. + source: 'docs/start/framework/react/guide/server-components.md' + priority: HIGH + status: active + + - mistake: 'Omitting structuralSharing: false for Query-cached RSC values' + mechanism: >- + Query-cached RSC values must disable structural sharing. + Otherwise the cache may try to merge Flight payloads across + fetches, which can cause errors. + source: 'docs/start/framework/react/guide/server-components.md' + priority: HIGH + status: active + + - mistake: 'Copying stale renderRsc or .validator examples into current code' + mechanism: >- + Older snippets may use renderRsc or .validator(...). + Normalize them to renderServerComponent and + .inputValidator(...) before using them in current code. + source: 'docs/start/framework/react/guide/server-functions.md' + priority: MEDIUM + status: active + tensions: - name: 'Isomorphic defaults vs server-only expectations' skills: ['execution-model', 'server-functions'] diff --git a/packages/react-start/skills/_artifacts/skill_spec.md b/packages/react-start/skills/_artifacts/skill_spec.md index 11b6843bb0..ce016f4e03 100644 --- a/packages/react-start/skills/_artifacts/skill_spec.md +++ b/packages/react-start/skills/_artifacts/skill_spec.md @@ -4,14 +4,14 @@ TanStack Start is a full-stack React framework built on TanStack Router and Vite ## Domains -| Domain | Description | Skills | -| ------------------------ | ------------------------------------------------------------- | ---------------- | -| Project Setup | Scaffolding, Vite plugin, router factory, root route, entries | start-setup | -| Server Functions | Type-safe RPCs with createServerFn, validation, streaming | server-functions | -| Middleware and Context | Request/function middleware, context, global middleware | middleware | -| Execution Model | Isomorphic defaults, environment boundaries, env vars | execution-model | -| Server Routes | API endpoints, HTTP handlers, handler middleware | server-routes | -| Deployment and Rendering | Hosting, selective SSR, prerendering, SEO | deployment | +| Domain | Description | Skills | +| ------------------------ | ------------------------------------------------------------- | ----------------------------- | +| Project Setup | Scaffolding, Vite plugin, router factory, root route, entries | start-setup | +| Server Functions | Type-safe RPCs with createServerFn, validation, streaming | server-functions | +| Middleware and Context | Request/function middleware, context, global middleware | middleware | +| Execution Model | Isomorphic defaults, environment boundaries, env vars | execution-model | +| Server Routes | API endpoints, HTTP handlers, handler middleware | server-routes | +| Deployment and Rendering | Hosting, selective SSR, prerendering, SEO | deployment, server-components | ## Skill Inventory @@ -23,6 +23,7 @@ TanStack Start is a full-stack React framework built on TanStack Router and Vite | execution-model | core | execution-model | Isomorphic defaults, environment functions, env vars | 4 | | server-routes | core | server-routes | server property, HTTP handlers, createHandlers | 2 | | deployment | core | deployment-and-rendering | Hosting, SSR modes, prerendering, SEO | 3 | +| server-components | sub-skill | deployment-and-rendering | React Server Components, cache ownership, selective SSR | 3 | | react-start | framework | project-setup | React bindings, useServerFn, full setup | 3 | | migrate-from-nextjs | lifecycle | project-setup | Next.js App Router migration checklist | 3 | @@ -77,6 +78,14 @@ TanStack Start is a full-stack React framework built on TanStack Router and Vite | 2 | Bun deployment with React 18 | MEDIUM | docs/guide/hosting | | 3 | Child route loosening parent SSR config | MEDIUM | docs/guide/selective-ssr | +### server-components (3 failure modes) + +| # | Mistake | Priority | Source | +| --- | ------------------------------------------------------------- | -------- | ---------------------------- | +| 1 | Using renderServerComponent when the UI needs slots | HIGH | docs/guide/server-components | +| 2 | Omitting structuralSharing: false for Query-cached RSC values | HIGH | docs/guide/server-components | +| 3 | Copying stale renderRsc or .validator examples | MEDIUM | docs/guide/server-functions | + ## Tensions | Tension | Skills | Agent implication | diff --git a/packages/react-start/skills/_artifacts/skill_tree.yaml b/packages/react-start/skills/_artifacts/skill_tree.yaml index cf743b067c..f896955132 100644 --- a/packages/react-start/skills/_artifacts/skill_tree.yaml +++ b/packages/react-start/skills/_artifacts/skill_tree.yaml @@ -137,6 +137,25 @@ skills: - 'TanStack/router:packages/react-start/src' - 'TanStack/router:docs/start/framework/react/build-from-scratch.md' + - name: 'Server Components' + slug: 'react-start/server-components' + type: 'sub-skill' + domain: 'deployment-and-rendering' + path: 'skills/react-start/server-components/SKILL.md' + package: 'packages/react-start' + description: >- + Implement, review, debug, and refactor TanStack Start React + Server Components in React 19 apps. + requires: + - 'react-start' + - 'start-core/server-functions' + - 'start-core/execution-model' + sources: + - 'TanStack/router:docs/start/framework/react/guide/server-components.md' + - 'TanStack/router:docs/start/framework/react/guide/server-functions.md' + - 'TanStack/router:docs/start/framework/react/guide/execution-model.md' + - 'TanStack/router:docs/router/guide/data-loading.md' + # ── Lifecycle Skills ──────────────────────────────────────────── - name: 'Migrate from Next.js' slug: 'lifecycle/migrate-from-nextjs' diff --git a/packages/react-start/skills/react-start/SKILL.md b/packages/react-start/skills/react-start/SKILL.md index e3067e9e05..2f3d569a55 100644 --- a/packages/react-start/skills/react-start/SKILL.md +++ b/packages/react-start/skills/react-start/SKILL.md @@ -22,6 +22,8 @@ This skill builds on start-core. Read [start-core](../../../start-client-core/sk This skill covers the React-specific bindings, setup, and patterns for TanStack Start. +For React Server Components patterns, see [react-start/server-components](./server-components/SKILL.md). + > **CRITICAL**: All code is ISOMORPHIC by default. Loaders run on BOTH server and client. Use `createServerFn` for server-only logic. > **CRITICAL**: Do not confuse `@tanstack/react-start` with Next.js or Remix. They are completely different frameworks with different APIs. diff --git a/packages/react-start/skills/react-start/server-components/SKILL.md b/packages/react-start/skills/react-start/server-components/SKILL.md new file mode 100644 index 0000000000..271113df3c --- /dev/null +++ b/packages/react-start/skills/react-start/server-components/SKILL.md @@ -0,0 +1,127 @@ +--- +name: react-start/server-components +description: >- + Implement, review, debug, and refactor TanStack Start React Server + Components in React 19 apps. Use when tasks mention + @tanstack/react-start/rsc, renderServerComponent, + createCompositeComponent, CompositeComponent, + renderToReadableStream, createFromReadableStream, createFromFetch, + Composite Components, React Flight streams, loader or query owned + RSC caching, router.invalidate, structuralSharing: false, + selective SSR, stale names like renderRsc or .validator, or + migration from Next App Router RSC patterns. Do not use for + generic SSR or non-TanStack RSC frameworks except brief + comparison. +type: sub-skill +library: tanstack-start +library_version: '1.166.2' +requires: + - react-start + - start-core/server-functions + - start-core/execution-model +sources: + - TanStack/router:docs/start/framework/react/guide/server-components.md + - TanStack/router:docs/start/framework/react/guide/server-functions.md + - TanStack/router:docs/start/framework/react/guide/execution-model.md + - TanStack/router:docs/router/guide/data-loading.md +--- + +# TanStack Start React Server Components + +Treat TanStack Start RSCs as fetchable React Flight payloads, not as a framework-owned server tree. Start from data ownership and cache ownership, then choose the smallest RSC primitive that fits. + +## When this skill is active + +1. Inspect `vite.config.*` for `tanstackStart({ rsc: { enabled: true } })`, `rsc()`, and `viteReact()`. +2. Inspect route files for `loader`, `loaderDeps`, `staleTime`, `ssr`, and `errorComponent`. +3. Inspect server boundaries: `createServerFn`, `createServerOnlyFn`, `.server.*`, and imports from `@tanstack/react-start/server`. +4. Identify the cache owner: Router loader cache, TanStack Query, or HTTP/server cache. +5. Identify the refresh path: `router.invalidate()`, `invalidateQueries`, `refetchQueries`, or GET cache headers. + +## Hard invariants + +- Route loaders are isomorphic. Do not put DB access, secrets, or Node-only APIs directly in a loader. If the loader itself must use browser APIs, make that route `ssr: false`. +- `renderServerComponent(...)` returns a renderable fragment. It does not support slots. +- `createCompositeComponent(...)` is for server-rendered UI that must accept client-provided `children`, render props, or component props. +- Query-cached RSC values require `structuralSharing: false`. +- Slot payloads are opaque on the server. Do not inspect, map, or clone `props.children`. +- Render-prop and component-slot arguments must stay Flight-serializable. +- Current server function validation API is `.inputValidator(...)`. Older snippets may still show `.validator(...)`; normalize them. +- TanStack custom serialization does not apply inside RSCs yet. Stay inside native Flight-supported values. + +## Decide three things immediately + +### 1) Transport / composition primitive + +- No client slots needed -> `renderServerComponent` +- Client interactivity must be inserted inside server-rendered markup -> `createCompositeComponent` + `<CompositeComponent src={...} />` +- Need custom Flight streaming, API routes, or non-standard transport -> `renderToReadableStream`, `createFromReadableStream`, `createFromFetch` + +### 2) Cache owner + +- Route-shaped data keyed by pathname, params, or search -> Router cache +- Independent key space, background refetch, or non-route ownership -> TanStack Query +- Cross-request reuse on server or CDN -> GET `createServerFn` + response cache headers and/or external server cache + +### 3) Refresh owner + +- Router-owned RSC -> `router.invalidate()` +- Query-owned RSC -> `queryClient.invalidateQueries(...)` or `refetchQueries(...)` +- Mixed Router + Query -> invalidate both deliberately; do not assume one refreshes the other + +## Pattern chooser + +- Simple server fragment in a route loader -> `renderServerComponent` +- Interactive slot inside server markup -> `createCompositeComponent` +- Route component needs browser APIs but loader can still prefetch on the server -> `ssr: 'data-only'` +- Loader itself needs browser APIs -> `ssr: false` +- Route cache key must include search params -> `loaderDeps` +- Query-managed RSC -> `useSuspenseQuery` + SSR `ensureQueryData` +- Multiple independent RSCs -> separate server functions + `Promise.all` +- Multiple RSCs sharing data or invalidating together -> one server function returning many renderables or sources +- Need isolated widget failures or staggered reveal -> return promises from the loader and resolve with `use()` inside Suspense + +## Slot choice + +- `children`: free-form composition, no server-to-client data flow +- render props: the server must pass serializable data into client-rendered UI +- component props: reusable client slot with a stable typed prop surface +- If you are about to use `Children.map`, `cloneElement`, or inspect `children` on the server, stop and convert it to a render prop + +## Review / refactor checklist + +- Is the chosen primitive the smallest one that fits? +- Does the loader own the RSC, or should Query own it? +- Are route cache keys complete (`params` + minimal `loaderDeps`)? +- Is invalidation hitting the real cache owner? +- Are query options using `structuralSharing: false` for any RSC value? +- Are mutations explicit `createServerFn({ method: 'POST' })` calls instead of hidden server actions? +- Are server-only imports kept inside server functions or server-only boundaries? +- Are examples using current names (`renderServerComponent`, `.inputValidator`) instead of stale ones? + +## Debug fast + +- Setup, exports, or stale docs mismatch -> `docs/current-api-notes.md` +- Composite Component design or slot bug -> `docs/composite-components.md` +- Stale data, refetching, loader keys, Query vs Router ownership, or SSR mode -> `docs/caching-refresh-ssr.md` +- Review, refactor, import leaks, error boundaries, or serialization bugs -> `docs/debugging-review.md` +- Architecture and Next/App Router translation -> `docs/architecture.md` + +## Copy-paste patterns + +- `examples/01-renderable-route-loader.tsx` +- `examples/02-composite-slots.tsx` +- `examples/03-query-owned-rsc.tsx` +- `examples/04-selective-ssr-data-only.tsx` +- `examples/05-ssr-false-browser-loader.tsx` +- `examples/06-low-level-flight-api-route.tsx` + +## Default implementation sequence + +1. Keep server-only work inside `createServerFn` or `createServerOnlyFn` +2. Return an RSC from the server function +3. Consume it through the route loader unless Query has a clear ownership advantage +4. Add the smallest cache policy that satisfies freshness requirements +5. Wire invalidation exactly once at the real cache owner +6. Escalate to Composite Components only when the client must fill slots +7. Escalate to low-level Flight APIs only when high-level helpers cannot express the transport diff --git a/packages/react-start/skills/react-start/server-components/docs/architecture.md b/packages/react-start/skills/react-start/server-components/docs/architecture.md new file mode 100644 index 0000000000..f416b832ad --- /dev/null +++ b/packages/react-start/skills/react-start/server-components/docs/architecture.md @@ -0,0 +1,84 @@ +# Architecture and mental model + +## Core model + +TanStack Start treats React Server Components as plain React Flight data: + +- create them on the server +- return them from a server function or API route +- decode and render them during SSR or on the client +- cache them with whatever already owns the data flow + +That matters because the framework is not asking you to move the whole UI tree to the server. RSCs are opt-in fragments that fit into existing Router and Query workflows. + +## Boundary model + +The fastest way to get TanStack Start RSC wrong is to think “loader = server”. + +Use these boundaries instead: + +- `createServerFn`: explicit RPC boundary; safe to call from client code because the client gets an RPC stub +- `createServerOnlyFn`: utility that must never run on the client +- route `loader`: orchestration layer that runs on the server for the initial SSR request and in the browser on client navigation unless the route is `ssr: false` + +Practical rule: loaders decide _when_ to fetch. Server functions decide _what_ must stay on the server. + +## What still works inside RSCs + +Do not over-correct and assume RSCs are a stripped-down universe. + +- TanStack Router `Link` works inside server components +- CSS Modules and global CSS imports work inside server components +- `React.cache` works for request-scoped memoization inside server components + +Use those directly when they simplify the tree. + +## When RSCs actually pay off + +Use TanStack Start RSCs when one or more of these are true: + +- a region is heavy to render but mostly static once delivered +- a server-only dependency should never enter the client bundle +- data fetching and render logic want to live together +- you want progressively streamed HTML for part of the route +- the result can be cached better as a fragment than as an entire page + +Do not force RSCs into highly interactive, state-dense client surfaces unless they materially reduce bundle size or remove awkward client/server sync. + +## Choosing tree ownership + +Think in terms of ownership: + +- client-owned UI: plain client components, Query, SPA patterns +- route-owned RSC: route loader fetches a fragment and Router cache owns freshness +- query-owned RSC: Query owns the fragment because its lifecycle is not route-shaped +- mixed ownership: the route owns coarse navigation state, Query owns sub-fragments + +The wrong smell is accidental double ownership: one RSC is fetched in a loader, then also separately cached in Query, then only one side is invalidated. + +## Composite Components in one sentence + +A Composite Component is a server-rendered fragment with placeholders the client fills later. + +That makes it the replacement for “I need server-rendered markup here, but I still need client interactivity in the middle of it.” + +The client can wrap, nest, reorder, and interleave those fragments instead of accepting a single framework-owned server tree. + +## Next App Router translation + +Use this mapping when someone is thinking in Next terms: + +- Next “server-first tree” -> Start “isomorphic-first app with opt-in RSC fragments” +- Next `'use client'` boundary -> Start Composite Component slot boundary +- Next server actions -> Start explicit `createServerFn({ method: 'POST' })` +- Next framework cache semantics -> Start Router cache, Query cache, and HTTP cache you control directly + +The useful mental shift is this: in TanStack Start, RSC is a transport and composition primitive, not the center of gravity for the whole app. + +## High-value heuristics + +- If the fragment never accepts client content, demote it to `renderServerComponent`. +- If a route-scoped RSC never needs independent refetching, keep it in the loader cache. +- If a fragment is reused across routes or refreshed independently, consider Query ownership. +- If several fragments always share data and invalidate together, bundle them in one server function. +- If one slow fragment blocks everything, stop awaiting it in the loader and defer it. diff --git a/packages/react-start/skills/react-start/server-components/docs/caching-refresh-ssr.md b/packages/react-start/skills/react-start/server-components/docs/caching-refresh-ssr.md new file mode 100644 index 0000000000..6619f78942 --- /dev/null +++ b/packages/react-start/skills/react-start/server-components/docs/caching-refresh-ssr.md @@ -0,0 +1,137 @@ +# Caching, refresh, SSR modes, and loading patterns + +## Pick one cache owner first + +### Router cache + +Use Router when the RSC is route-shaped and keyed by URL state. + +Relevant facts: + +- Router loader cache keys are based on pathname and params, plus anything you add through `loaderDeps` +- default navigation `staleTime` is `0` +- default preload freshness is `30s` +- default stale reload mode is background stale-while-revalidate +- `router.invalidate()` reloads active loaders immediately and marks cached routes stale + +Use Router ownership when the fragment naturally belongs to the route and should track navigation. + +### TanStack Query + +Use Query when the fragment has its own lifecycle. + +Typical reasons: + +- reuse across routes +- background refetching independent of navigation +- manual query invalidation +- non-route ownership + +Hard rule: + +```tsx +structuralSharing: false +``` + +Without that, Query may try to merge RSC values across fetches. + +### HTTP / server cache + +Use GET server functions and response headers when you want cross-request reuse: + +- CDN caching +- edge caching +- reverse proxies +- shared server caches + +Set headers in a GET `createServerFn` via `setResponseHeaders(...)`. + +## Router-owned RSC pattern + +Use a server function to return the RSC, then fetch it in the route loader. + +Tune Router with: + +- `staleTime` when revisits should stay fresh for a window +- `loaderDeps` when search params affect the fragment +- `staleReloadMode: 'blocking'` when showing stale data during reload is unacceptable + +`loaderDeps` rule: include only values the loader actually uses. Returning the whole search object causes noisy invalidation. + +## Query-owned RSC pattern + +Use Query when you want explicit cache keys and background fetch behavior. + +Recommended shape: + +```tsx +const postQueryOptions = (postId: string) => ({ + queryKey: ['post-rsc', postId], + structuralSharing: false, + queryFn: () => getPostRsc({ data: { postId } }), + staleTime: 5 * 60 * 1000, +}) +``` + +For SSR reuse, prefetch in the route loader: + +```tsx +await context.queryClient.ensureQueryData(postQueryOptions(params.postId)) +``` + +Then read it with `useSuspenseQuery` in the component. + +## Refresh rules + +- loader-owned fragment changed -> `router.invalidate()` +- query-owned fragment changed -> `queryClient.invalidateQueries(...)` +- shared route and query state -> refresh both if both are authoritative +- CDN or response-header cache involved -> make sure the mutation path also busts or bypasses server-side cache + +Do not “spray” invalidation everywhere. Decide who owns freshness, then target that owner. + +## Selective SSR modes + +### `ssr: 'data-only'` + +Use when: + +- the route component needs browser APIs +- the loader can still fetch the RSC on the server for first paint +- you want server-fetched fragment data ready before the client component mounts + +This is often the right shape for responsive charts, viewport-dependent layout wrappers, or widgets that need `window` but still benefit from server-rendered content. + +### `ssr: false` + +Use when the loader itself depends on browser APIs such as: + +- `localStorage` +- `window` +- browser-only client state + +In this mode, both the loader and component run in the browser. The loader can still call a server function that returns an RSC. + +## Loading patterns + +### Independent fragments -> parallel + +If the fragments do not share data, fetch them with separate server functions and `Promise.all`. + +### Shared data or shared invalidation -> bundle + +If several fragments always share a fetch or invalidate together, return them from one server function. This reduces round trips and keeps ownership aligned. + +### One slow fragment should not block everything -> defer + +Return promises from the loader instead of awaiting them. Resolve them with `use()` inside Suspense. This also lets you isolate failures with a local ErrorBoundary instead of the route error boundary. + +### Large or unbounded lists -> async generators + +Use async generators when items should arrive incrementally and total size or per-item latency is unpredictable. + +## Request-scoped memoization + +`React.cache` works inside server components. Use it when several async server components in one request need the same expensive fetch or computation. + +That is request-scoped deduplication, not a cross-request cache. diff --git a/packages/react-start/skills/react-start/server-components/docs/composite-components.md b/packages/react-start/skills/react-start/server-components/docs/composite-components.md new file mode 100644 index 0000000000..738e07c632 --- /dev/null +++ b/packages/react-start/skills/react-start/server-components/docs/composite-components.md @@ -0,0 +1,115 @@ +# Composite Components and slot composition + +## The real mechanism + +Inside `createCompositeComponent`, slot props are placeholders, not real client elements. + +Server-side behavior: + +- reading `props.children` records “there will be children here” +- calling `props.renderSomething(args)` records “call this slot with these args later” +- reading a component prop like `props.AddToCart` records “render this client component here with these props later” + +Client-side behavior: + +- `<CompositeComponent src={...} ... />` replaces those placeholders with the real props you passed at render time + +This is why slots are powerful and why some React habits stop working. + +## Choose the slot type by data flow + +### `children` + +Use when: + +- the server only needs a hole for client content +- no server data needs to flow into the slotted content +- free-form composition matters more than a rigid interface + +Do not use when the server must inject IDs, permissions, pricing, or derived data into the child content. + +### render props + +Use when: + +- the server must pass data into the client-rendered content +- the data is serializable +- you want the call site to stay flexible + +This is usually the best default when the server owns the data and the client owns the interactive control. + +### component props + +Use when: + +- you have a reusable client component +- the prop contract is stable +- you want the server to decide where it renders and which typed props it receives + +This is a good fit for buttons, menus, controls, widgets, and repeated productized patterns. + +## Rules that matter + +- `renderServerComponent` does not support slots +- do not use `React.Children.map`, `cloneElement`, or child inspection on the server +- render-prop arguments and component-slot props must be Flight-serializable +- keep slot contracts narrow; pass IDs and plain data, not giant objects by default + +## The most common anti-pattern + +Bad instinct: + +```tsx +createCompositeComponent((props: { children?: React.ReactNode }) => ( + <div> + {React.Children.map(props.children, (child) => + React.cloneElement(child, { extra: 'prop' }), + )} + </div> +)) +``` + +Correct rewrite: + +```tsx +createCompositeComponent<{ + renderItem?: (data: { extra: string }) => React.ReactNode +}>((props) => <div>{props.renderItem?.({ extra: 'prop' })}</div>) +``` + +Server-side slot content is opaque. If the server needs to add data, make the data explicit. + +## Good slot contracts + +Prefer contracts like: + +- `renderActions?: ({ postId, authorId }) => ReactNode` +- `AddToCart?: ComponentType<{ productId: string; price: number }>` +- `children?: ReactNode` + +Avoid contracts like: + +- `renderAnything?: (data: EntirePostRecordFromDB) => ReactNode` +- `children` plus child inspection and mutation +- opaque callbacks that expect non-serializable classes or functions from the server + +## Composition patterns that age well + +### Shell + actions + +The server renders an article, card, or panel and exposes one `renderActions` slot for buttons, menus, or controls. + +### Shell + body children + +The server renders stable framing UI and accepts `children` for optional interactive regions like comments, drawers, or editors. + +### Stable control slot + +The server accepts a component prop such as `AddToCart`, `UserMenu`, or `RowActions` and supplies clean typed props to it. + +## Refactor heuristics + +- No slot use anywhere -> replace the Composite Component with `renderServerComponent` +- Slot exists only to pass data -> prefer a render prop over `children` +- Repeated render-prop call sites with the same component -> promote to a component prop +- Giant slot arg object -> shrink it to the smallest serializable payload that the client really needs diff --git a/packages/react-start/skills/react-start/server-components/docs/current-api-notes.md b/packages/react-start/skills/react-start/server-components/docs/current-api-notes.md new file mode 100644 index 0000000000..a6ca6fee5e --- /dev/null +++ b/packages/react-start/skills/react-start/server-components/docs/current-api-notes.md @@ -0,0 +1,74 @@ +# Current API notes and stale example corrections + +Validated against official TanStack Start, TanStack Router, TanStack blog, and Vite docs on 2026-04-13. + +## Current setup shape + +Use the current RSC setup: + +- React 19+ +- Vite 7+ +- `@vitejs/plugin-rsc` +- `tanstackStart({ rsc: { enabled: true } })` +- `rsc()` +- `viteReact()` + +## Current high-level APIs + +Prefer: + +- `renderServerComponent` +- `createCompositeComponent` +- `CompositeComponent` + +Use low-level APIs only for custom transport: + +- `renderToReadableStream` +- `createFromReadableStream` +- `createFromFetch` + +## Current validation API + +Use `.inputValidator(...)` on `createServerFn`. + +Important because some current RSC docs snippets still show the older `.validator(...)` spelling. Normalize those examples before copying them into real code. + +## Current constraints + +- RSC support is still experimental +- TanStack custom serialization is not available inside RSCs yet +- slot args must stay Flight-serializable +- `structuralSharing: false` is mandatory for Query-cached RSC values + +## Stale example traps to avoid + +### Old `renderRsc` examples + +You may still find older official repo examples using `renderRsc` and older config shapes. Do not cargo-cult them into new code. Normalize to the current docs and current `@tanstack/react-start/rsc` APIs. + +### Old validation snippets + +If you see `.validator(z.object(...))` in an RSC example, rewrite it to `.inputValidator(z.object(...))` to match the current server function API. + +### Old Vite config shapes + +If an example enables Start but does not also install and register `@vitejs/plugin-rsc`, treat it as stale for current TanStack Start RSC setup. + +## Maintenance rule + +When docs, examples, and repo snippets disagree: + +1. prefer the current TanStack Start docs +2. prefer the current TanStack blog announcement over older repo samples +3. cross-check with current Server Functions and Execution Model docs +4. then normalize all local examples to one coherent modern API surface + +## Official source list + +- TanStack Start Server Components docs +- TanStack Start Server Functions docs +- TanStack Start Execution Model docs +- TanStack Start Import Protection docs +- TanStack Router Data Loading docs +- TanStack blog: React Server Components Your Way +- Vite docs for `@vitejs/plugin-rsc` diff --git a/packages/react-start/skills/react-start/server-components/docs/debugging-review.md b/packages/react-start/skills/react-start/server-components/docs/debugging-review.md new file mode 100644 index 0000000000..68580a9674 --- /dev/null +++ b/packages/react-start/skills/react-start/server-components/docs/debugging-review.md @@ -0,0 +1,141 @@ +# Debugging and review guide + +## Triage by failure stage + +### 1. Setup / build failure + +Likely causes: + +- `@vitejs/plugin-rsc` missing +- RSC not enabled in `tanstackStart({ rsc: { enabled: true } })` +- stale example using old exports +- wrong React or Vite baseline + +Checks: + +- inspect `vite.config.*` +- inspect imports from `@tanstack/react-start/rsc` +- normalize to `renderServerComponent`, `createCompositeComponent`, `CompositeComponent`, `.inputValidator(...)` + +### 2. Wrong environment failure + +Symptoms: + +- DB or secret access explodes on client navigation +- `window` or `localStorage` explodes during SSR +- import protection complaints about server-only code + +Likely causes: + +- server-only logic placed directly in an isomorphic loader +- browser-only logic used in SSR route/component +- helper referencing `.server` imports outside a recognized server boundary + +Fixes: + +- move server-only work into `createServerFn` or `createServerOnlyFn` +- use `ssr: 'data-only'` when only the component needs browser APIs +- use `ssr: false` when the loader itself needs browser APIs +- keep server-only imports inside server-only callbacks or files + +## Composition / slot bugs + +Symptoms: + +- child content disappears or cannot be modified +- `Children.map` or `cloneElement` does nothing useful +- component prop slot receives unusable data +- Composite Component seems heavier than necessary + +Likely causes: + +- trying to inspect server-side slot placeholders +- non-serializable slot args +- using a Composite Component for a fragment that has no slots + +Fixes: + +- replace child inspection with a render prop +- narrow slot args to serializable values +- demote slotless composites to `renderServerComponent` + +## Cache / staleness bugs + +Symptoms: + +- stale UI after mutation +- route revisits do not refresh when expected +- route refreshes too often +- Query errors or weird object merging on RSC values + +Likely causes: + +- invalidating the wrong cache owner +- missing or oversized `loaderDeps` +- missing `structuralSharing: false` +- `staleTime` / `staleReloadMode` mismatch with desired UX + +Checks: + +- decide whether Router or Query owns the fragment +- inspect `loaderDeps` for only the params actually used +- verify Query key includes all real inputs +- verify `structuralSharing: false` +- use `router.invalidate()` only when the loader owns freshness + +## Error boundary surprises + +Rule: + +- awaited loader failure -> route `errorComponent` +- deferred promise failure -> local ErrorBoundary around the deferred read + +If a single failing widget should not take down the route, stop awaiting it in the loader. + +## Serialization bugs + +Symptoms: + +- odd runtime decode failures +- slot args rejected or malformed +- custom serializer assumptions fail + +Likely causes: + +- passing classes, functions, Maps/Sets with custom serialization expectations, or other non-Flight-friendly values +- relying on TanStack custom serialization inside RSCs + +Fixes: + +- reduce payloads to primitives, Dates, plain objects, arrays, and React elements where appropriate +- pass IDs, not rich server objects, unless they are plain and intentionally serialized + +## Import protection and bundling gotchas + +- static imports of server functions are safe; the client build gets RPC stubs +- dynamic imports of server functions can cause bundler issues +- dev-mode import protection warnings can be informational because there is no tree-shaking; build output is the authoritative check + +## Code review checklist + +- correct primitive: renderable vs composite vs low-level stream +- loader is orchestration, not secret storage +- `loaderDeps` only covers actual inputs +- Query-owned RSC uses `structuralSharing: false` +- invalidation targets the real cache owner +- mutations are explicit `POST` server functions +- slot contracts are narrow and serializable +- stale examples normalized to current APIs +- route-level vs component-level error handling matches the UX requirement + +## Simplify-first recovery path + +When a bug is tangled across Query, Router, Composite Components, and SSR modes: + +1. collapse to one route-owned `renderServerComponent` +2. verify the server function and loader path +3. reintroduce Query only if you need independent ownership +4. reintroduce Composite Components only if you need slots +5. reintroduce deferred loading only if you need staggered reveal or isolated failures + +This sequence removes entire classes of bugs instead of trying to patch all of them at once. diff --git a/packages/react-start/skills/react-start/server-components/docs/sources.md b/packages/react-start/skills/react-start/server-components/docs/sources.md new file mode 100644 index 0000000000..fc1546ef84 --- /dev/null +++ b/packages/react-start/skills/react-start/server-components/docs/sources.md @@ -0,0 +1,39 @@ +# Official sources + +Validated on 2026-04-13. + +## TanStack Start + +- Server Components guide + https://tanstack.com/start/latest/docs/framework/react/guide/server-components + +- Server Functions guide + https://tanstack.com/start/latest/docs/framework/react/guide/server-functions + +- Execution Model guide + https://tanstack.com/start/latest/docs/framework/react/guide/execution-model + +- Import Protection guide + https://tanstack.com/start/latest/docs/framework/react/guide/import-protection + +## TanStack Router + +- Data Loading guide + https://tanstack.com/router/latest/docs/framework/react/guide/data-loading + +## TanStack blog + +- React Server Components Your Way + https://tanstack.com/blog/react-server-components + +## Vite + +- `@vitejs/plugin-rsc` documentation / discovery entry point + https://vite.dev/plugins/ + +## Notes on drift observed during validation + +- Current RSC docs and blog use `renderServerComponent`, `createCompositeComponent`, `CompositeComponent`, and low-level Flight APIs from `@tanstack/react-start/rsc`. +- Current Server Functions docs use `.inputValidator(...)`. +- Some current RSC docs snippets still show older `.validator(...)`. +- Older official repo examples may still show `renderRsc` and older config shapes. Prefer the current docs above. diff --git a/packages/react-start/skills/react-start/server-components/examples/01-renderable-route-loader.tsx b/packages/react-start/skills/react-start/server-components/examples/01-renderable-route-loader.tsx new file mode 100644 index 0000000000..eb4a308abb --- /dev/null +++ b/packages/react-start/skills/react-start/server-components/examples/01-renderable-route-loader.tsx @@ -0,0 +1,28 @@ +// Current TanStack Start RSC pattern. +// Replace route paths and data sources with your own app code. + +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { renderServerComponent } from '@tanstack/react-start/rsc' + +function Greeting() { + return <h1>Hello from TanStack Start RSC</h1> +} + +const getGreeting = createServerFn({ method: 'GET' }).handler(async () => { + const Renderable = await renderServerComponent(<Greeting />) + return { Renderable } +}) + +export const Route = createFileRoute('/hello')({ + loader: async () => { + const { Renderable } = await getGreeting() + return { Greeting: Renderable } + }, + component: HelloPage, +}) + +function HelloPage() { + const { Greeting } = Route.useLoaderData() + return <>{Greeting}</> +} diff --git a/packages/react-start/skills/react-start/server-components/examples/02-composite-slots.tsx b/packages/react-start/skills/react-start/server-components/examples/02-composite-slots.tsx new file mode 100644 index 0000000000..5bf1d77414 --- /dev/null +++ b/packages/react-start/skills/react-start/server-components/examples/02-composite-slots.tsx @@ -0,0 +1,124 @@ +// Composite Component patterns: +// - children slot for free-form composition +// - render-prop slot when the server must pass data into client UI +// - component prop slot for reusable typed interactive controls + +import type { ComponentType, ReactNode } from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { + CompositeComponent, + createCompositeComponent, +} from '@tanstack/react-start/rsc' +import { z } from 'zod' + +// Replace with your own server-only data layer +declare const db: { + posts: { + findById(postId: string): Promise<{ + id: string + authorId: string + title: string + body: string + }> + } + products: { + findById(productId: string): Promise<{ + id: string + name: string + price: number + }> + } +} + +const getPostCard = createServerFn({ method: 'GET' }) + .inputValidator(z.object({ postId: z.string() })) + .handler(async ({ data }) => { + const post = await db.posts.findById(data.postId) + + const src = await createCompositeComponent<{ + children?: ReactNode + renderActions?: (args: { postId: string; authorId: string }) => ReactNode + }>((props) => ( + <article className="card"> + <h1>{post.title}</h1> + <p>{post.body}</p> + + <footer> + {props.renderActions?.({ + postId: post.id, + authorId: post.authorId, + })} + </footer> + + <section>{props.children}</section> + </article> + )) + + return { src } + }) + +export const Route = createFileRoute('/posts/$postId')({ + loader: async ({ params }) => + getPostCard({ data: { postId: params.postId } }), + component: PostPage, +}) + +function PostPage() { + const { src } = Route.useLoaderData() + + return ( + <CompositeComponent + src={src} + renderActions={({ postId, authorId }) => ( + <PostActions postId={postId} authorId={authorId} /> + )} + > + <Comments /> + </CompositeComponent> + ) +} + +function Comments() { + return <div>Interactive comments go here</div> +} + +function PostActions(props: { postId: string; authorId: string }) { + return ( + <button type="button"> + Moderate {props.postId} / {props.authorId} + </button> + ) +} + +// Component-prop slot variant +const getProductCard = createServerFn({ method: 'GET' }) + .inputValidator(z.object({ productId: z.string() })) + .handler(async ({ data }) => { + const product = await db.products.findById(data.productId) + + const src = await createCompositeComponent<{ + AddToCart?: ComponentType<{ productId: string; price: number }> + }>((props) => ( + <section className="product-card"> + <h2>{product.name}</h2> + {props.AddToCart ? ( + <props.AddToCart productId={product.id} price={product.price} /> + ) : null} + </section> + )) + + return { src } + }) + +function AddToCartButton(props: { productId: string; price: number }) { + return ( + <button type="button"> + Add {props.productId} at {props.price} + </button> + ) +} + +// Example usage somewhere else: +// const { src } = await getProductCard({ data: { productId: 'p-1' } }) +// <CompositeComponent src={src} AddToCart={AddToCartButton} /> diff --git a/packages/react-start/skills/react-start/server-components/examples/03-query-owned-rsc.tsx b/packages/react-start/skills/react-start/server-components/examples/03-query-owned-rsc.tsx new file mode 100644 index 0000000000..0b5c7c895a --- /dev/null +++ b/packages/react-start/skills/react-start/server-components/examples/03-query-owned-rsc.tsx @@ -0,0 +1,97 @@ +// Query-owned RSC pattern. +// Assumes your router context provides a queryClient for SSR prefetch. + +import type { ReactNode } from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { + CompositeComponent, + createCompositeComponent, +} from '@tanstack/react-start/rsc' +import { useQueryClient, useSuspenseQuery } from '@tanstack/react-query' +import { z } from 'zod' + +// Replace with your own data layer +declare const db: { + posts: { + findById(postId: string): Promise<{ + id: string + title: string + body: string + }> + update( + postId: string, + patch: { title?: string; body?: string }, + ): Promise<void> + } +} + +const getPostRsc = createServerFn({ method: 'GET' }) + .inputValidator(z.object({ postId: z.string() })) + .handler(async ({ data }) => { + const post = await db.posts.findById(data.postId) + + const src = await createCompositeComponent<{ + renderActions?: (args: { postId: string }) => ReactNode + }>((props) => ( + <article> + <h1>{post.title}</h1> + <p>{post.body}</p> + <footer>{props.renderActions?.({ postId: post.id })}</footer> + </article> + )) + + return { src } + }) + +const updatePost = createServerFn({ method: 'POST' }) + .inputValidator( + z.object({ + postId: z.string(), + title: z.string().optional(), + body: z.string().optional(), + }), + ) + .handler(async ({ data }) => { + await db.posts.update(data.postId, { + title: data.title, + body: data.body, + }) + }) + +const postQueryOptions = (postId: string) => ({ + queryKey: ['post-rsc', postId], + structuralSharing: false, + queryFn: () => getPostRsc({ data: { postId } }), + staleTime: 5 * 60 * 1000, +}) + +export const Route = createFileRoute('/posts/$postId')({ + loader: async ({ context, params }) => { + await context.queryClient.ensureQueryData(postQueryOptions(params.postId)) + }, + component: PostPage, +}) + +function PostPage() { + const { postId } = Route.useParams() + const queryClient = useQueryClient() + + const { data } = useSuspenseQuery(postQueryOptions(postId)) + + const handleRename = async () => { + await updatePost({ data: { postId, title: 'Updated title' } }) + await queryClient.invalidateQueries({ queryKey: ['post-rsc', postId] }) + } + + return ( + <CompositeComponent + src={data.src} + renderActions={({ postId }) => ( + <button type="button" onClick={handleRename}> + Refresh {postId} + </button> + )} + /> + ) +} diff --git a/packages/react-start/skills/react-start/server-components/examples/04-selective-ssr-data-only.tsx b/packages/react-start/skills/react-start/server-components/examples/04-selective-ssr-data-only.tsx new file mode 100644 index 0000000000..a068c3c001 --- /dev/null +++ b/packages/react-start/skills/react-start/server-components/examples/04-selective-ssr-data-only.tsx @@ -0,0 +1,72 @@ +// Selective SSR: the loader fetches the RSC on the server, +// but the route component renders on the client because it needs browser APIs. + +import * as React from 'react' +import type { ReactNode } from 'react' +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { + CompositeComponent, + createCompositeComponent, +} from '@tanstack/react-start/rsc' + +// Replace with your own server-side data source +declare function getDashboardStats(): Promise<{ + series: Array<{ x: number; y: number }> + totalUsers: number +}> + +const getDashboard = createServerFn({ method: 'GET' }).handler(async () => { + const stats = await getDashboardStats() + + const src = await createCompositeComponent<{ + renderChart?: (args: { + series: Array<{ x: number; y: number }> + }) => ReactNode + }>((props) => ( + <section> + <h1>Users: {stats.totalUsers}</h1> + {props.renderChart?.({ series: stats.series })} + </section> + )) + + return { src } +}) + +export const Route = createFileRoute('/dashboard')({ + ssr: 'data-only', + loader: async () => ({ + Dashboard: await getDashboard(), + }), + component: DashboardPage, +}) + +function DashboardPage() { + const { Dashboard } = Route.useLoaderData() + const [width, setWidth] = React.useState(0) + + React.useEffect(() => { + setWidth(window.innerWidth) + }, []) + + return ( + <CompositeComponent + src={Dashboard.src} + renderChart={({ series }) => ( + <ResponsiveChart data={series} width={width} /> + )} + /> + ) +} + +// Replace with your real chart component +function ResponsiveChart(props: { + data: Array<{ x: number; y: number }> + width: number +}) { + return ( + <pre> + {JSON.stringify({ width: props.width, points: props.data.length })} + </pre> + ) +} diff --git a/packages/react-start/skills/react-start/server-components/examples/05-ssr-false-browser-loader.tsx b/packages/react-start/skills/react-start/server-components/examples/05-ssr-false-browser-loader.tsx new file mode 100644 index 0000000000..fa5b4aae55 --- /dev/null +++ b/packages/react-start/skills/react-start/server-components/examples/05-ssr-false-browser-loader.tsx @@ -0,0 +1,40 @@ +// Browser-owned loader pattern. +// Use when the loader itself needs browser APIs such as localStorage. + +import { createFileRoute } from '@tanstack/react-router' +import { createServerFn } from '@tanstack/react-start' +import { renderServerComponent } from '@tanstack/react-start/rsc' +import { z } from 'zod' + +const getDrawingTools = createServerFn({ method: 'POST' }) + .inputValidator(z.object({ savedState: z.string().nullable() })) + .handler(async ({ data }) => { + const Tools = await renderServerComponent( + <ToolPalette savedState={data.savedState} />, + ) + + return { Tools } + }) + +export const Route = createFileRoute('/canvas')({ + ssr: false, + loader: async () => { + const savedState = localStorage.getItem('canvas-state') + return getDrawingTools({ data: { savedState } }) + }, + component: CanvasPage, +}) + +function CanvasPage() { + const { Tools } = Route.useLoaderData() + return <>{Tools}</> +} + +function ToolPalette(props: { savedState: string | null }) { + return ( + <section> + <h1>Canvas tools</h1> + <pre>{props.savedState ?? 'no saved state'}</pre> + </section> + ) +} diff --git a/packages/react-start/skills/react-start/server-components/examples/06-low-level-flight-api-route.tsx b/packages/react-start/skills/react-start/server-components/examples/06-low-level-flight-api-route.tsx new file mode 100644 index 0000000000..17415d00a8 --- /dev/null +++ b/packages/react-start/skills/react-start/server-components/examples/06-low-level-flight-api-route.tsx @@ -0,0 +1,40 @@ +// Low-level Flight stream APIs. +// Prefer high-level helpers unless you need a custom transport. + +import { createAPIFileRoute } from '@tanstack/react-start/api' +import { createServerFn } from '@tanstack/react-start' +import { + createFromFetch, + renderToReadableStream, +} from '@tanstack/react-start/rsc' +import { useSuspenseQuery } from '@tanstack/react-query' + +const getFlightStream = createServerFn({ method: 'GET' }).handler(async () => { + return renderToReadableStream(<div>Server rendered content</div>) +}) + +export const APIRoute = createAPIFileRoute('/api/rsc')({ + GET: async () => { + const stream = await getFlightStream() + + return new Response(stream, { + headers: { + 'Content-Type': 'text/x-component', + }, + }) + }, +}) + +const rscQueryOptions = () => ({ + queryKey: ['api-rsc'], + structuralSharing: false, + queryFn: async () => { + const Renderable = await createFromFetch(fetch('/api/rsc')) + return { Renderable } + }, +}) + +export function ApiBackedRscWidget() { + const { data } = useSuspenseQuery(rscQueryOptions()) + return <>{data.Renderable}</> +} diff --git a/packages/react-start/src/hydration.ts b/packages/react-start/src/hydration.ts new file mode 100644 index 0000000000..e86169e71d --- /dev/null +++ b/packages/react-start/src/hydration.ts @@ -0,0 +1,18 @@ +export { + condition, + idle, + interaction, + load, + media, + never, + visible, +} from '@tanstack/react-start-client/hydration' +export type { + HydrationCondition, + HydrationInteractionEvent, + HydrationInteractionEvents, + HydrationPrefetchStrategy, + HydrationStrategy, + HydrationWhen, + VisibleHydrationOptions, +} from '@tanstack/react-start-client/hydration' diff --git a/packages/react-start/src/index.ts b/packages/react-start/src/index.ts index 8b51b6c783..6ea839a967 100644 --- a/packages/react-start/src/index.ts +++ b/packages/react-start/src/index.ts @@ -1,2 +1,34 @@ export { useServerFn } from './useServerFn' export * from '@tanstack/start-client-core' +// Explicit re-exports shadow `export *` above so these public-API names are +// registered on the namespace at link time (via Vite SSR's `defineExport` +// at fileStartIndex), surviving the cold-start SSR cycle through user +// middleware. See vitejs/vite#22491 / #22493. Trim list to genuine public +// API only; internals fall through `export *` and are safe because they +// aren't imported at top level in the cycle path. +export { + createClientOnlyFn, + createCsrfMiddleware, + createIsomorphicFn, + createMiddleware, + createServerFn, + createServerOnlyFn, + createStart, +} from '@tanstack/start-client-core' + +// Keep root `@tanstack/react-start` imports from evaluating the client barrel. +// The barrel also exports `hydrateStart`, which imports the virtual client +// entry. That virtual entry imports the user's router module, so route modules +// that import the root package can be pulled back into the same graph and +// create circular HMR updates. Re-exporting from the Hydrate-only subpath +// preserves the public API without introducing that import edge. +export { Hydrate } from '@tanstack/react-start-client/Hydrate' +export type { + HydrateOptions, + HydrateProps, + HydrationInteractionEvent, + HydrationInteractionEvents, + HydrationPrefetchStrategy, + HydrationStrategy, + HydrationWhen, +} from '@tanstack/react-start-client/Hydrate' diff --git a/packages/react-start/src/plugin/rsbuild.ts b/packages/react-start/src/plugin/rsbuild.ts new file mode 100644 index 0000000000..7e0fcbb6c2 --- /dev/null +++ b/packages/react-start/src/plugin/rsbuild.ts @@ -0,0 +1,79 @@ +import { + RSBUILD_ENVIRONMENT_NAMES, + tanStackStartRsbuild, +} from '@tanstack/start-plugin-core/rsbuild' +import { createRscCssCompilerTransforms } from '@tanstack/react-start-rsc/plugin/rscCssTransform' +import { reactStartDefaultEntryPaths } from './shared' +import type { + TanStackStartRsbuildInputConfig, + TanStackStartRsbuildPluginCoreOptions, +} from '@tanstack/start-plugin-core/rsbuild' +import type { RsbuildPlugin } from '@rsbuild/core' + +export function tanstackStart( + options?: TanStackStartRsbuildInputConfig & { rsc?: { enabled?: boolean } }, +): RsbuildPlugin { + const rscEnabled = options?.rsc?.enabled ?? false + + let corePluginOpts: TanStackStartRsbuildPluginCoreOptions = { + framework: 'react', + defaultEntryPaths: reactStartDefaultEntryPaths, + providerEnvironmentName: RSBUILD_ENVIRONMENT_NAMES.server, + ssrIsProvider: true, + } + + if (rscEnabled) { + const rscConfig = configureRscRsbuild() + corePluginOpts = { + ...corePluginOpts, + providerEnvironmentName: rscConfig.providerEnvironmentName, + ssrIsProvider: false, + serializationAdapters: rscConfig.serializationAdapters, + compilerTransforms: rscConfig.compilerTransforms, + serverFnProviderModuleDirectives: + rscConfig.serverFnProviderModuleDirectives, + rsc: true, + } + } + + return tanStackStartRsbuild(corePluginOpts, options) +} + +/** + * Configure RSC options for the rsbuild adapter. + * + * Returns provider env, serialization adapters, and core RSC options. + * + * The SSR resolver strategy is intentionally NOT changed from 'default' — + * in the rspack layered model, SSR and RSC live in the same + * compilation so they share the same resolver file. No forwarding needed. + */ +function configureRscRsbuild(): { + providerEnvironmentName: TanStackStartRsbuildPluginCoreOptions['providerEnvironmentName'] + serializationAdapters: TanStackStartRsbuildPluginCoreOptions['serializationAdapters'] + compilerTransforms: TanStackStartRsbuildPluginCoreOptions['compilerTransforms'] + serverFnProviderModuleDirectives: TanStackStartRsbuildPluginCoreOptions['serverFnProviderModuleDirectives'] +} { + return { + providerEnvironmentName: RSBUILD_ENVIRONMENT_NAMES.server, + serializationAdapters: [ + { + client: { + module: '@tanstack/react-start/rsc/serialization/client', + export: 'rscSerializationAdapter', + isFactory: true, + }, + server: { + module: '@tanstack/react-start/rsc/serialization/server', + export: 'rscSerializationAdapter', + isFactory: true, + }, + }, + ], + compilerTransforms: createRscCssCompilerTransforms({ + loadCssExpression: 'import.meta.rspackRsc.loadCss()', + serverFnProviderOnly: true, + }), + serverFnProviderModuleDirectives: ['use server-entry'], + } +} diff --git a/packages/react-start/src/plugin/shared.ts b/packages/react-start/src/plugin/shared.ts new file mode 100644 index 0000000000..aba8a7ba65 --- /dev/null +++ b/packages/react-start/src/plugin/shared.ts @@ -0,0 +1,22 @@ +import { fileURLToPath } from 'node:url' +import path from 'pathe' + +const currentDir = path.dirname(fileURLToPath(import.meta.url)) +export const reactStartPluginDir = currentDir +const defaultEntryDir = path.resolve( + currentDir, + '..', + '..', + 'plugin', + 'default-entry', +) + +export const reactStartDefaultEntryPaths = { + client: path.resolve(defaultEntryDir, 'client.tsx'), + server: path.resolve(defaultEntryDir, 'server.ts'), + start: path.resolve(defaultEntryDir, 'start.ts'), +} + +export function resolvePackageEntryPath(packageName: string): string { + return fileURLToPath(import.meta.resolve(packageName)) +} diff --git a/packages/react-start/src/plugin/vite.ts b/packages/react-start/src/plugin/vite.ts index 3d47aad887..8849f39ea6 100644 --- a/packages/react-start/src/plugin/vite.ts +++ b/packages/react-start/src/plugin/vite.ts @@ -1,36 +1,72 @@ -import { fileURLToPath } from 'node:url' import { - TanStackStartVitePluginCore, - VITE_ENVIRONMENT_NAMES, -} from '@tanstack/start-plugin-core' + START_ENVIRONMENT_NAMES, + tanStackStartVite, +} from '@tanstack/start-plugin-core/vite' +import type { + TanStackStartViteInputConfig, + TanStackStartVitePluginCoreOptions, +} from '@tanstack/start-plugin-core/vite' +import { + configureRsc, + reactStartRscVitePlugin, +} from '@tanstack/react-start-rsc/plugin/vite' import path from 'pathe' -import type { TanStackStartInputConfig } from '@tanstack/start-plugin-core' +import { reactStartDefaultEntryPaths, reactStartPluginDir } from './shared' import type { PluginOption } from 'vite' -const currentDir = path.dirname(fileURLToPath(import.meta.url)) -const defaultEntryDir = path.resolve( - currentDir, - '..', - '..', - 'plugin', - 'default-entry', -) -const defaultEntryPaths = { - client: path.resolve(defaultEntryDir, 'client.tsx'), - server: path.resolve(defaultEntryDir, 'server.ts'), - start: path.resolve(defaultEntryDir, 'start.ts'), -} - const isInsideRouterMonoRepo = - path.basename(path.resolve(currentDir, '../../../../')) === 'packages' + path.basename(path.resolve(reactStartPluginDir, '../../../../')) === + 'packages' export function tanstackStart( - options?: TanStackStartInputConfig, + options?: TanStackStartViteInputConfig & { rsc?: { enabled?: boolean } }, ): Array<PluginOption> { + const rscEnabled = options?.rsc?.enabled ?? false + const rscConfig = rscEnabled ? configureRsc() : undefined + let corePluginOpts: TanStackStartVitePluginCoreOptions = { + framework: 'react', + defaultEntryPaths: reactStartDefaultEntryPaths, + providerEnvironmentName: START_ENVIRONMENT_NAMES.server, + ssrIsProvider: true, + ssrResolverStrategy: { + type: 'default', + }, + } + + const serverEnvironments: Array<string> = [ + START_ENVIRONMENT_NAMES.server, + ...(rscConfig ? [rscConfig.envName] : []), + ] + + if (rscConfig) { + corePluginOpts = { + ...corePluginOpts, + providerEnvironmentName: rscConfig.providerEnvironmentName, + ssrIsProvider: false, + ssrResolverStrategy: rscConfig.ssrResolverStrategy, + serializationAdapters: rscConfig.serializationAdapters, + compilerTransforms: rscConfig.compilerTransforms, + } + } return [ { name: 'tanstack-react-start:config', configEnvironment(environmentName, options) { + const needsOptimizeDeps = + environmentName === START_ENVIRONMENT_NAMES.client || + (serverEnvironments.includes(environmentName) && + // This indicates that the server environment has opted in to dependency optimization + options.optimizeDeps?.noDiscovery === false) + + // Check if @tanstack/react-router is in noExternal (as array) + const reactRouterInNoExternal = + Array.isArray(options.resolve?.noExternal) && + options.resolve.noExternal.some( + (pattern) => + pattern === '@tanstack/react-router' || + (typeof pattern === 'string' && pattern.includes('react-router')), + ) + return { resolve: { dedupe: [ @@ -39,52 +75,49 @@ export function tanstackStart( '@tanstack/react-start', '@tanstack/react-router', ], + // Don't mark react-router as external if: + // 1. noExternal is true (bundle everything) + // 2. We're not in the router monorepo + // 3. react-router is explicitly in noExternal for this environment external: - options.resolve?.noExternal === true || !isInsideRouterMonoRepo + options.resolve?.noExternal === true || + !isInsideRouterMonoRepo || + reactRouterInNoExternal ? undefined : ['@tanstack/react-router', '@tanstack/react-router-devtools'], }, - optimizeDeps: - environmentName === VITE_ENVIRONMENT_NAMES.client || - (environmentName === VITE_ENVIRONMENT_NAMES.server && - // This indicates that the server environment has opted in to dependency optimization - options.optimizeDeps?.noDiscovery === false) - ? { - // As `@tanstack/react-start` depends on `@tanstack/react-router`, we should exclude both. - exclude: [ - '@tanstack/react-start', - '@tanstack/react-router', - '@tanstack/react-router-devtools', - '@tanstack/start-static-server-functions', - ], - include: [ - 'react', - 'react/jsx-runtime', - 'react/jsx-dev-runtime', - 'react-dom', - ...(environmentName === VITE_ENVIRONMENT_NAMES.client - ? ['react-dom/client'] - : ['react-dom/server']), - // `@tanstack/react-store` has a dependency on `use-sync-external-store`, which is CJS. - // It therefore needs to be included so that it is converted to ESM. - '@tanstack/react-router > @tanstack/react-store', - ...(options.optimizeDeps?.exclude?.find( - (x) => x === '@tanstack/react-form', - ) - ? ['@tanstack/react-form > @tanstack/react-store'] - : []), - ], - } - : undefined, + optimizeDeps: needsOptimizeDeps + ? { + // As `@tanstack/react-start` depends on `@tanstack/react-router`, we should exclude both. + exclude: [ + '@tanstack/react-start', + '@tanstack/react-router', + '@tanstack/react-router-devtools', + '@tanstack/start-static-server-functions', + ], + include: [ + 'react', + 'react/jsx-runtime', + 'react/jsx-dev-runtime', + 'react-dom', + ...(environmentName === START_ENVIRONMENT_NAMES.client + ? ['react-dom/client'] + : ['react-dom/server']), + // `@tanstack/react-store` has a dependency on `use-sync-external-store`, which is CJS. + // It therefore needs to be included so that it is converted to ESM. + '@tanstack/react-router > @tanstack/react-store', + ...(options.optimizeDeps?.exclude?.find( + (x) => x === '@tanstack/react-form', + ) + ? ['@tanstack/react-form > @tanstack/react-store'] + : []), + ], + } + : undefined, } }, }, - TanStackStartVitePluginCore( - { - framework: 'react', - defaultEntryPaths, - }, - options, - ), + rscConfig ? reactStartRscVitePlugin() : null, + tanStackStartVite(corePluginOpts, options), ] } diff --git a/packages/react-start/src/rsbuild/browser-decode.ts b/packages/react-start/src/rsbuild/browser-decode.ts new file mode 100644 index 0000000000..5232414e97 --- /dev/null +++ b/packages/react-start/src/rsbuild/browser-decode.ts @@ -0,0 +1 @@ +export * from '@tanstack/react-start-rsc/rsbuild/browser-decode' diff --git a/packages/react-start/src/rsbuild/ssr-decode.ts b/packages/react-start/src/rsbuild/ssr-decode.ts new file mode 100644 index 0000000000..aa56c87e13 --- /dev/null +++ b/packages/react-start/src/rsbuild/ssr-decode.ts @@ -0,0 +1 @@ +export * from '@tanstack/react-start-rsc/rsbuild/ssr-decode' diff --git a/packages/react-start/src/rsc.rsc.ts b/packages/react-start/src/rsc.rsc.ts new file mode 100644 index 0000000000..b6624de42a --- /dev/null +++ b/packages/react-start/src/rsc.rsc.ts @@ -0,0 +1,2 @@ +// Re-export from react-start-rsc for react-server condition +export * from '@tanstack/react-start-rsc' diff --git a/packages/react-start/src/rsc.tsx b/packages/react-start/src/rsc.tsx new file mode 100644 index 0000000000..481210a6ab --- /dev/null +++ b/packages/react-start/src/rsc.tsx @@ -0,0 +1,3 @@ +// Re-export from react-start-rsc +// The package's export conditions handle server vs client differentiation +export * from '@tanstack/react-start-rsc' diff --git a/packages/react-start/src/rsc/serialization/client.ts b/packages/react-start/src/rsc/serialization/client.ts new file mode 100644 index 0000000000..0b7890f4eb --- /dev/null +++ b/packages/react-start/src/rsc/serialization/client.ts @@ -0,0 +1 @@ +export { rscSerializationAdapter } from '@tanstack/react-start-rsc/serialization.client' diff --git a/packages/react-start/src/rsc/serialization/server.ts b/packages/react-start/src/rsc/serialization/server.ts new file mode 100644 index 0000000000..74edf24cb8 --- /dev/null +++ b/packages/react-start/src/rsc/serialization/server.ts @@ -0,0 +1 @@ +export { rscSerializationAdapter } from '@tanstack/react-start-rsc/serialization.server' diff --git a/packages/react-start/src/server.rsc.ts b/packages/react-start/src/server.rsc.ts new file mode 100644 index 0000000000..d1fd428186 --- /dev/null +++ b/packages/react-start/src/server.rsc.ts @@ -0,0 +1 @@ +export * from '@tanstack/start-server-core/request-response' diff --git a/packages/react-start/src/useServerFn.ts b/packages/react-start/src/useServerFn.ts index 37e2294be6..66f3525937 100644 --- a/packages/react-start/src/useServerFn.ts +++ b/packages/react-start/src/useServerFn.ts @@ -18,7 +18,7 @@ export function useServerFn<T extends (...deps: Array<any>) => Promise<any>>( return res } catch (err) { if (isRedirect(err)) { - err.options._fromLocation = router.stores.location.state + err.options._fromLocation = router.stores.location.get() return router.navigate(router.resolveRedirect(err).options) } diff --git a/packages/react-start/vite.config.ts b/packages/react-start/vite.config.ts index 61f5945a01..652e4ef842 100644 --- a/packages/react-start/vite.config.ts +++ b/packages/react-start/vite.config.ts @@ -27,10 +27,19 @@ export default mergeConfig( entry: [ './src/index.ts', './src/client.tsx', + './src/hydration.ts', './src/client-rpc.ts', './src/server.tsx', + './src/server.rsc.ts', './src/server-rpc.ts', './src/ssr-rpc.ts', + './src/rsc.tsx', + './src/rsc.rsc.ts', + './src/rsc/serialization/server.ts', + './src/rsc/serialization/client.ts', + './src/rsbuild/browser-decode.ts', + './src/rsbuild/ssr-decode.ts', + './src/plugin/rsbuild.ts', './src/plugin/vite.ts', './src/server-only.ts', './src/client-only.ts', diff --git a/packages/router-cli/CHANGELOG.md b/packages/router-cli/CHANGELOG.md index 0be701df15..18b42b6b5a 100644 --- a/packages/router-cli/CHANGELOG.md +++ b/packages/router-cli/CHANGELOG.md @@ -1,5 +1,228 @@ # @tanstack/router-cli +## 1.167.12 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-generator@1.167.12 + +## 1.167.11 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-generator@1.167.11 + +## 1.167.10 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-generator@1.167.10 + +## 1.167.9 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-generator@1.167.9 + +## 1.167.8 + +### Patch Changes + +- Updated dependencies [[`7df0d02`](https://github.com/TanStack/router/commit/7df0d02bfb1407b1f07731ef69af24e2f0e415d7)]: + - @tanstack/router-generator@1.167.8 + +## 1.167.7 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-generator@1.167.7 + +## 1.167.6 + +### Patch Changes + +- Update chokidar to v5. ([#7439](https://github.com/TanStack/router/pull/7439)) + +- Updated dependencies []: + - @tanstack/router-generator@1.167.6 + +## 1.167.5 + +### Patch Changes + +- Updated dependencies [[`b60eb36`](https://github.com/TanStack/router/commit/b60eb36e59e8a468ee0742cbcf7f47aca1ff1c67)]: + - @tanstack/router-generator@1.167.5 + +## 1.167.4 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-generator@1.167.4 + +## 1.167.3 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-generator@1.167.3 + +## 1.167.2 + +### Patch Changes + +- Updated dependencies [[`742941e`](https://github.com/TanStack/router/commit/742941e2f1bf069c950d0a4985b2cd733639509e)]: + - @tanstack/router-generator@1.167.2 + +## 1.167.1 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-generator@1.167.1 + +## 1.167.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- Updated dependencies [[`038cd12`](https://github.com/TanStack/router/commit/038cd123b70bc6154d75abb6404a744c376f8f6a), [`201e150`](https://github.com/TanStack/router/commit/201e150bd1412bae2faa9ce53f0fefcb7574ac14)]: + - @tanstack/router-generator@1.167.0 + +## 1.166.43 + +### Patch Changes + +- Updated dependencies [[`c5811aa`](https://github.com/TanStack/router/commit/c5811aacb59b69a8179f14cd9529a51b2206d504)]: + - @tanstack/router-generator@1.166.42 + +## 1.166.42 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-generator@1.166.41 + +## 1.166.41 + +### Patch Changes + +- Updated dependencies [[`056337e`](https://github.com/TanStack/router/commit/056337ef02ccbeaf45ec8533a227761be869e8f3)]: + - @tanstack/router-generator@1.166.40 + +## 1.166.40 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-generator@1.166.39 + +## 1.166.39 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-generator@1.166.38 + +## 1.166.38 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-generator@1.166.37 + +## 1.166.37 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-generator@1.166.36 + +## 1.166.36 + +### Patch Changes + +- Updated dependencies [[`a2ad394`](https://github.com/TanStack/router/commit/a2ad394598e2079ab4050ebb16bb03b31d69c32a)]: + - @tanstack/router-generator@1.166.35 + +## 1.166.35 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-generator@1.166.34 + +## 1.166.34 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-generator@1.166.33 + +## 1.166.33 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-generator@1.166.32 + +## 1.166.32 + +### Patch Changes + +- Updated dependencies [[`328d7e5`](https://github.com/TanStack/router/commit/328d7e5ebc6b8074242a07d68ccafafb83e37a0e)]: + - @tanstack/router-generator@1.166.31 + +## 1.166.31 + +### Patch Changes + +- Updated dependencies [[`105d056`](https://github.com/TanStack/router/commit/105d05691a247779a63e7b688aa1207cce619339)]: + - @tanstack/router-generator@1.166.30 + +## 1.166.30 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-generator@1.166.29 + +## 1.166.29 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-generator@1.166.28 + +## 1.166.28 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-generator@1.166.27 + +## 1.166.27 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-generator@1.166.26 + +## 1.166.26 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-generator@1.166.25 + ## 1.166.25 ### Patch Changes diff --git a/packages/router-cli/package.json b/packages/router-cli/package.json index 3bbe0a4c1a..c7ccc1f9e9 100644 --- a/packages/router-cli/package.json +++ b/packages/router-cli/package.json @@ -1,6 +1,6 @@ { "name": "@tanstack/router-cli", - "version": "1.166.25", + "version": "1.167.12", "description": "Modern and scalable routing for React applications", "author": "Tanner Linsley", "license": "MIT", @@ -67,10 +67,11 @@ }, "dependencies": { "@tanstack/router-generator": "workspace:*", - "chokidar": "^3.6.0", + "chokidar": "^5.0.0", "yargs": "^17.7.2" }, "devDependencies": { + "@types/node": ">=20", "@types/yargs": "^17.0.33", "vite": "*" } diff --git a/packages/router-cli/tsconfig.json b/packages/router-cli/tsconfig.json index b36d1bf924..09d7037393 100644 --- a/packages/router-cli/tsconfig.json +++ b/packages/router-cli/tsconfig.json @@ -1,4 +1,7 @@ { "extends": "../../tsconfig.json", - "include": ["src", "vite.config.ts"] + "include": ["src", "vite.config.ts"], + "compilerOptions": { + "types": ["node"] + } } diff --git a/packages/router-core/CHANGELOG.md b/packages/router-core/CHANGELOG.md index 31180413e1..0d4f3bef2b 100644 --- a/packages/router-core/CHANGELOG.md +++ b/packages/router-core/CHANGELOG.md @@ -1,5 +1,162 @@ # @tanstack/router-core +## 1.171.8 + +### Patch Changes + +- [#7505](https://github.com/TanStack/router/pull/7505) [`2f53749`](https://github.com/TanStack/router/commit/2f5374945e2138559a51464f45a5152eae67e1dd) - Preserve primitive values thrown from beforeLoad error handling. + +## 1.171.7 + +### Patch Changes + +- [#7497](https://github.com/TanStack/router/pull/7497) [`d1997b6`](https://github.com/TanStack/router/commit/d1997b66d7c24c1d64772bb8bab5caf9c6d9cc48) - fix streaming + +## 1.171.6 + +### Patch Changes + +- Add support for Rsbuild client output formats, including module output by default and IIFE output for classic script environments. ([#7477](https://github.com/TanStack/router/pull/7477)) + + Client entry scripts and preloads are now represented as root route manifest assets, script preloads follow the manifest script format, and script asset cross-origin configuration uses the `script` key. The `transformAssets` script callback context now exposes only `kind: 'script'` and `url`, keeping script format handling internal to manifest rendering. + +## 1.171.5 + +### Patch Changes + +- Fix hash scrolling with `resetScroll={false}` ([#7464](https://github.com/TanStack/router/pull/7464)) + +## 1.171.4 + +### Patch Changes + +- Fix hash navigation being overridden by stale scroll restoration entries. ([#7447](https://github.com/TanStack/router/pull/7447)) + +- Preserve carried scroll positions across SPA navigations that create new restoration keys. ([#7447](https://github.com/TanStack/router/pull/7447)) + +## 1.171.3 + +### Patch Changes + +- Add deferred Hydrate boundary support for TanStack Start. ([#7362](https://github.com/TanStack/router/pull/7362)) + + Hydrate boundaries can now be code-split by the Start compiler, preload their generated client chunks, preserve server-rendered fallback HTML, and replay interaction-triggered events after hydration. The compiler integration now uses a Start-owned compiler plugin for Hydrate virtual modules across Vite and Rsbuild, with dev invalidation for generated virtual modules. + + Shared AST utilities used by the router code-splitter and Hydrate virtual modules were moved into `@tanstack/router-utils` so both pipelines can retain referenced top-level declarations, unwrap local exports, and let dead-code elimination remove unused route module code. + +## 1.171.2 + +### Patch Changes + +- Fix route mismatch warnings, HMR route index refresh, and generated route type preferences for duplicate pathless/index routes. ([#7422](https://github.com/TanStack/router/pull/7422)) + +## 1.171.1 + +### Patch Changes + +- Run custom router hydration before the initial client route match so hydrated router configuration, such as request-specific URL rewrites, can be installed before SSR hydration compares matches. ([#7416](https://github.com/TanStack/router/pull/7416)) + +## 1.171.0 + +### Minor Changes + +- params.priority route option as tie breaker in route matching algorithm ([#7411](https://github.com/TanStack/router/pull/7411)) + +## 1.170.1 + +### Patch Changes + +- Add runtime-configurable inline CSS and opt-in CSS URL templates for transformAssets. ([#7380](https://github.com/TanStack/router/pull/7380)) + +## 1.170.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- fix(router-core): fix missing closing paren in CSS.supports check for view transition types ([#7369](https://github.com/TanStack/router/pull/7369)) + +- Updated dependencies [[`201e150`](https://github.com/TanStack/router/commit/201e150bd1412bae2faa9ce53f0fefcb7574ac14)]: + - @tanstack/history@1.162.0 + +## 1.169.2 + +### Patch Changes + +- Update seroval dependencies to version 1.5.4. ([#7340](https://github.com/TanStack/router/pull/7340)) + +## 1.169.1 + +### Patch Changes + +- Fix params.parse inference for discriminated union path params while preserving path key validation. ([#7306](https://github.com/TanStack/router/pull/7306)) + +## 1.169.0 + +### Minor Changes + +- Allow `params.parse` to experimentally return `false` to skip an incoming route candidate during path matching. Thrown parse errors still surface on the selected match instead of falling through, and outgoing typed route-template links continue to use exact route lookup followed by `params.stringify` for URL generation. ([#7263](https://github.com/TanStack/router/pull/7263)) + +## 1.168.18 + +### Patch Changes + +- prevent isServer exports from being transformed to top-level vars so rspack can dead-code eliminate them ([#7293](https://github.com/TanStack/router/pull/7293)) + +## 1.168.17 + +### Patch Changes + +- wildcard nodes have the same priority rules as other nodes in route matching ([#7273](https://github.com/TanStack/router/pull/7273)) + +## 1.168.16 + +### Patch Changes + +- Add TanStack Start inline CSS manifest support for SSR so route styles can be embedded in the HTML response and hydrated without duplicate stylesheet links. ([#7253](https://github.com/TanStack/router/pull/7253)) + +## 1.168.15 + +### Patch Changes + +- Fix async loaders that throw or return `notFound()` so they do not briefly mark the match as `success` before the final not-found boundary is resolved. ([#7184](https://github.com/TanStack/router/pull/7184)) + + This prevents route components from rendering with missing loader data during navigation when React observes the intermediate match state before not-found finalization completes. + +## 1.168.14 + +### Patch Changes + +- chore: bump to h3 v2-rc.20 ([#7140](https://github.com/TanStack/router/pull/7140)) + +## 1.168.13 + +### Patch Changes + +- Reduce React Start SSR manifest payload size by omitting unmatched route assets from dehydrated router state while keeping start-manifest asset serialization deduplicated by shared object identity. ([#7157](https://github.com/TanStack/router/pull/7157)) + + This improves SSR HTML size for apps with many routes that share the same CSS assets and adds regression coverage for CSS module hydration, navigation, and start-manifest asset reuse. + +## 1.168.12 + +### Patch Changes + +- avoid false notFound matches for proxied loader data ([#7156](https://github.com/TanStack/router/pull/7156)) + +## 1.168.11 + +### Patch Changes + +- shorten internal non-minifiable store names for byte shaving ([#7152](https://github.com/TanStack/router/pull/7152)) + +## 1.168.10 + +### Patch Changes + +- migrate createStore > createAtom for simpler API ([#7150](https://github.com/TanStack/router/pull/7150)) + ## 1.168.9 ### Patch Changes diff --git a/packages/router-core/bin/intent.js b/packages/router-core/bin/intent.js deleted file mode 100755 index 5b08532885..0000000000 --- a/packages/router-core/bin/intent.js +++ /dev/null @@ -1,25 +0,0 @@ -#!/usr/bin/env node -// Auto-generated by @tanstack/intent setup -// Exposes the intent end-user CLI for consumers of this library. -// Commit this file, then add to your package.json: -// "bin": { "intent": "./bin/intent.js" } -try { - await import('@tanstack/intent/intent-library') -} catch (e) { - const isModuleNotFound = - e?.code === 'ERR_MODULE_NOT_FOUND' || e?.code === 'MODULE_NOT_FOUND' - const missingIntentLibrary = - typeof e?.message === 'string' && e.message.includes('@tanstack/intent') - - if (isModuleNotFound && missingIntentLibrary) { - console.error('@tanstack/intent is not installed.') - console.error('') - console.error('Install it as a dev dependency:') - console.error(' npm add -D @tanstack/intent') - console.error('') - console.error('Or run directly:') - console.error(' npx @tanstack/intent@latest list') - process.exit(1) - } - throw e -} diff --git a/packages/router-core/package.json b/packages/router-core/package.json index a84d551633..d28915b34c 100644 --- a/packages/router-core/package.json +++ b/packages/router-core/package.json @@ -1,6 +1,6 @@ { "name": "@tanstack/router-core", - "version": "1.168.9", + "version": "1.171.8", "description": "Modern and scalable routing for React applications", "author": "Tanner Linsley", "license": "MIT", @@ -183,19 +183,14 @@ }, "dependencies": { "@tanstack/history": "workspace:*", - "cookie-es": "^2.0.0", - "seroval": "^1.4.2", - "seroval-plugins": "^1.4.2" + "cookie-es": "^3.0.0", + "seroval": "^1.5.4", + "seroval-plugins": "^1.5.4" }, "devDependencies": { - "@tanstack/store": "^0.9.2", - "@tanstack/intent": "^0.0.14", "@tanstack/store": "^0.9.3", "@types/node": "25.0.9", "esbuild": "^0.27.4", "vite": "*" - }, - "bin": { - "intent": "./bin/intent.js" } } diff --git a/packages/router-core/skills/router-core/auth-and-guards/SKILL.md b/packages/router-core/skills/router-core/auth-and-guards/SKILL.md index b11ab95fb3..c5d224ec1c 100644 --- a/packages/router-core/skills/router-core/auth-and-guards/SKILL.md +++ b/packages/router-core/skills/router-core/auth-and-guards/SKILL.md @@ -21,6 +21,10 @@ sources: # Auth and Guards +> **This skill covers the routing side of auth.** For the **server-side primitives** — session cookies (`HttpOnly`/`Secure`/`SameSite`), `useSession`-style helpers, OAuth `state` + PKCE, password-reset enumeration defense, CSRF, rate limiting — see [start-core/auth-server-primitives](../../../../start-client-core/skills/start-core/auth-server-primitives/SKILL.md). The two skills are designed to be used together. +> +> **CRITICAL**: A route guard (`beforeLoad`) does NOT protect a `createServerFn` declared on that route. Server functions are RPC endpoints reachable by direct POST regardless of which route renders them. See "Route guards do not protect server functions" below. + ## Setup Protect routes with `beforeLoad` + `redirect()` in a pathless layout route (`_authenticated`): @@ -371,6 +375,41 @@ export const Route = createFileRoute('/_authenticated')({ ## Common Mistakes +### CRITICAL: Route guards do not protect server functions + +A `beforeLoad` redirect protects the **route's UI**, not the **server functions** declared on it. `createServerFn` produces an RPC endpoint reachable by direct POST regardless of which route renders the calling UI. An attacker doesn't have to load `/_authenticated/orders` — they can curl the RPC endpoint directly. + +```tsx +// WRONG — handler has no auth check; the route guard doesn't help +import { createServerFn } from '@tanstack/react-start' +import { createFileRoute, redirect } from '@tanstack/react-router' + +const getMyOrders = createServerFn({ method: 'GET' }).handler(async () => { + return db.orders.findMany() // ← anyone can hit the RPC +}) + +export const Route = createFileRoute('/_authenticated/orders')({ + beforeLoad: ({ context }) => { + if (!context.auth.isAuthenticated) throw redirect({ to: '/login' }) + }, + loader: () => getMyOrders(), +}) +``` + +```tsx +// CORRECT — auth enforced on the handler itself, via middleware +import { createServerFn } from '@tanstack/react-start' +import { authMiddleware } from '~/server/auth-middleware' + +const getMyOrders = createServerFn({ method: 'GET' }) + .middleware([authMiddleware]) + .handler(async ({ context }) => { + return db.orders.findMany({ where: { userId: context.session.userId } }) + }) +``` + +Rule of thumb: every `createServerFn` that touches user data needs `authMiddleware` (or an equivalent in-handler check). The route guard is for the page experience; the RPC guard is for the data. See [start-core/auth-server-primitives](../../../../start-client-core/skills/start-core/auth-server-primitives/SKILL.md) for the full session/middleware pattern. + ### HIGH: Auth check in component instead of beforeLoad Component-level auth checks cause a **flash of protected content** before the redirect: @@ -456,3 +495,5 @@ Place protected routes as children of the `_authenticated` layout route. Public ## Cross-References - See also: **router-core/data-loading/SKILL.md** — `beforeLoad` runs before `loader`; auth context flows into loader via route context +- See also: **start-core/auth-server-primitives/SKILL.md** — server-side session cookies, OAuth state + PKCE, CSRF, password-reset hardening, rate limiting (the server half of authentication) +- See also: **start-core/middleware/SKILL.md** — `authMiddleware` factory pattern for protecting individual `createServerFn` calls diff --git a/packages/router-core/skills/router-core/ssr/SKILL.md b/packages/router-core/skills/router-core/ssr/SKILL.md index 1871c0f950..de3fc9a6d7 100644 --- a/packages/router-core/skills/router-core/ssr/SKILL.md +++ b/packages/router-core/skills/router-core/ssr/SKILL.md @@ -391,22 +391,74 @@ component: () => { } ``` -### 3. CRITICAL: Generating Next.js or Remix SSR patterns +### 3. CRITICAL: Generating Next.js, Remix, or React Router DOM patterns -TanStack Router does NOT use `getServerSideProps`, `getStaticProps`, App Router `page.tsx`, or Remix-style server-only `loader` exports. +TanStack Router does NOT use `getServerSideProps`, `getStaticProps`, App Router `page.tsx`, Remix-style server-only `loader` exports, or anything from `react-router-dom`. + +#### Wrong file structures + +```text +WRONG (Next.js Pages Router): + src/pages/index.tsx + src/pages/_app.tsx + src/pages/posts/[id].tsx + +WRONG (Next.js App Router): + app/layout.tsx + app/page.tsx + app/posts/[id]/page.tsx + +WRONG (Next.js custom App): + _app/index.tsx + pages/_app.tsx, pages/_document.tsx + +CORRECT (TanStack Router file-based routing): + src/routes/__root.tsx + src/routes/index.tsx + src/routes/posts/$postId.tsx +``` + +#### Wrong imports ```tsx -// WRONG — Next.js patterns +// WRONG — react-router-dom is a different library +import { + Link, + useNavigate, + BrowserRouter, + Route, + Routes, +} from 'react-router-dom' + +// WRONG — Next.js Link/router +import Link from 'next/link' +import { useRouter } from 'next/router' // Pages Router +import { useRouter } from 'next/navigation' // App Router + +// CORRECT — everything routing-related lives in @tanstack/react-router +import { + Link, + useNavigate, + useRouter, + useLocation, + redirect, +} from '@tanstack/react-router' +``` + +#### Wrong loader/data-fetching patterns + +```tsx +// WRONG — Next.js Pages Router export async function getServerSideProps() { return { props: { data: await fetchData() } } } -// WRONG — Remix patterns +// WRONG — Remix export async function loader({ request }: LoaderFunctionArgs) { return json({ data: await fetchData() }) } -// CORRECT — TanStack Router pattern +// CORRECT — TanStack Router export const Route = createFileRoute('/data')({ loader: async () => { const data = await fetchData() @@ -421,6 +473,8 @@ function DataPage() { } ``` +If you see `src/pages/`, `app/layout.tsx`, `react-router-dom`, or any of the above in agent output, the agent is generating for the wrong framework. The build will either fail or produce duplicate `/` routes that conflict at runtime. + ## Tension: Client-First Loaders vs SSR TanStack Router loaders are client-first by design. When SSR is enabled, they run in both environments. This means: diff --git a/packages/router-core/skills/router-core/type-safety/SKILL.md b/packages/router-core/skills/router-core/type-safety/SKILL.md index eb258a994f..7b7c53bfa8 100644 --- a/packages/router-core/skills/router-core/type-safety/SKILL.md +++ b/packages/router-core/skills/router-core/type-safety/SKILL.md @@ -313,7 +313,9 @@ export function NavItem(props: NavItemProps): React.ReactNode { <NavItem label="Post" linkOptions={{ to: '/posts/$postId', params: { postId: '1' } }} /> ``` -### `ValidateNavigateOptions` — Type-Safe Navigate in Utilities +### `ValidateNavigateOptions` and `ValidateRedirectOptions` + +Same pattern as `ValidateLinkOptions` above, for `useNavigate` and `redirect`. Declare a generic public overload plus a non-generic implementation signature so the call site stays narrowed and the body works without casts: ```tsx import { @@ -332,45 +334,15 @@ export function useDelayedNavigate< export function useDelayedNavigate( options: ValidateNavigateOptions, delayMs: number, -): () => void { +) { const navigate = useNavigate() return () => { setTimeout(() => navigate(options), delayMs) } } - -// Usage — type-safe -const go = useDelayedNavigate( - { to: '/posts/$postId', params: { postId: '1' } }, - 500, -) ``` -### `ValidateRedirectOptions` — Type-Safe Redirect in Utilities - -```tsx -import { - redirect, - type RegisteredRouter, - type ValidateRedirectOptions, -} from '@tanstack/react-router' - -export async function fetchOrRedirect< - TRouter extends RegisteredRouter = RegisteredRouter, - TOptions = unknown, ->( - url: string, - redirectOptions: ValidateRedirectOptions<TRouter, TOptions>, -): Promise<unknown> -export async function fetchOrRedirect( - url: string, - redirectOptions: ValidateRedirectOptions, -): Promise<unknown> { - const response = await fetch(url) - if (!response.ok && response.status === 401) throw redirect(redirectOptions) - return response.json() -} -``` +`ValidateRedirectOptions` works identically — declare a generic overload accepting `ValidateRedirectOptions<TRouter, TOptions>` and an impl signature accepting `ValidateRedirectOptions`, then call `redirect(options)` in the body. ### Render Props for Maximum Performance @@ -477,21 +449,44 @@ declare module '@tanstack/react-router' { } ``` -### 5. CRITICAL (cross-skill): Generating Next.js or Remix patterns +### 5. CRITICAL (cross-skill): Wrong-framework imports and file structure + +Wrong-framework code looks plausible (it's React) but breaks the build or produces conflicting `/` routes at runtime. ```tsx -// WRONG — these are NOT TanStack Router APIs -export async function getServerSideProps() { ... } -export async function loader({ request }) { ... } // Remix-style -const [searchParams, setSearchParams] = useSearchParams() // React Router +// WRONG — react-router-dom and next/* are different libraries +import { Link, useNavigate, useSearchParams } from 'react-router-dom' +import Link from 'next/link' +import { useRouter, useParams } from 'next/navigation' -// CORRECT — TanStack Router APIs -export const Route = createFileRoute('/posts')({ - loader: async () => { ... }, // TanStack loader - validateSearch: zodValidator(schema), // TanStack search validation - component: PostsComponent, -}) -const search = Route.useSearch() // TanStack hook +// CORRECT — all routing exports come from @tanstack/react-router +import { + Link, + Outlet, + useNavigate, + useRouter, + useLocation, + useParams, + redirect, +} from '@tanstack/react-router' ``` +```tsx +// WRONG file structures + APIs: +// src/pages/*.tsx with getServerSideProps / getStaticProps (Next.js Pages Router) +// app/layout.tsx + app/page.tsx (Next.js App Router) +// _app/index.tsx, pages/_app.tsx, pages/_document.tsx (Next.js custom App) +// loader/action exports (Remix) + +// CORRECT — TanStack file-based routing at src/routes/*.tsx +export const Route = createFileRoute('/posts')({ + loader: async () => { ... }, + validateSearch: zodValidator(schema), + component: PostsComponent, +}) +const search = Route.useSearch() +``` + +If a build error mentions `react-router-dom`, `next/`, `pages/_app`, or duplicate `/` routes, fix the import — don't paper over with type assertions. + See also: router-core (Register setup), router-core/navigation (from narrowing), router-core/code-splitting (getRouteApi). diff --git a/packages/router-core/src/hash-scroll.ts b/packages/router-core/src/hash-scroll.ts deleted file mode 100644 index a51ed01b2d..0000000000 --- a/packages/router-core/src/hash-scroll.ts +++ /dev/null @@ -1,21 +0,0 @@ -import type { AnyRouter } from './router' - -/** - * @private - * Handles hash-based scrolling after navigation completes. - * To be used in framework-specific <Transitioner> components during the onResolved event. - */ -export function handleHashScroll(router: AnyRouter) { - if (typeof document !== 'undefined' && (document as any).querySelector) { - const location = router.stores.location.state - const hashScrollIntoViewOptions = - location.state.__hashScrollIntoViewOptions ?? true - - if (hashScrollIntoViewOptions && location.hash !== '') { - const el = document.getElementById(location.hash) - if (el) { - el.scrollIntoView(hashScrollIntoViewOptions) - } - } - } -} diff --git a/packages/router-core/src/index.ts b/packages/router-core/src/index.ts index 86731b944f..fd673ca410 100644 --- a/packages/router-core/src/index.ts +++ b/packages/router-core/src/index.ts @@ -70,12 +70,38 @@ export type { export type { ParsedLocation } from './location' export type { Manifest, + ServerManifest, + ManifestRoute, + ManifestRouteAssets, + ServerManifestRoute, + ManifestCssLink, + ManifestInlineCss, + ServerManifestInlineCss, + InlineCssTemplate, + ManifestScript, RouterManagedTag, + RouterManagedTitleTag, + RouterManagedMetaTag, + RouterManagedInlineCssTag, + RouterManagedScriptTag, + RouterManagedLinkTag, + RouterManagedStyleTag, AssetCrossOrigin, AssetCrossOriginConfig, ManifestAssetLink, + ScriptFormat, +} from './manifest' +export { + DEV_STYLES_ATTR, + appendUniqueUserTags, + createInlineCssStyleAsset, + getAssetCrossOrigin, + getManifestScriptFormat, + getScriptPreloadAttrs, + getStylesheetHref, + resolveManifestAssetLink, + resolveManifestCssLink, } from './manifest' -export { getAssetCrossOrigin, resolveManifestAssetLink } from './manifest' export { isMatch } from './Matches' export type { AnyMatchAndValue, @@ -179,6 +205,7 @@ export type { RouteContextFn, ContextOptions, RouteContextOptions, + SsrContextOptions, BeforeLoadContextOptions, RootRouteOptions, RootRouteOptionsExtensions, @@ -283,6 +310,7 @@ export type { OptionalStructuralSharing } from './structuralSharing' export { functionalUpdate, + hasKeys, replaceEqualDeep, isPlainObject, isPlainArray, @@ -399,12 +427,9 @@ export { defaultGetScrollRestorationKey, getElementScrollRestorationEntry, storageKey, - scrollRestorationCache, setupScrollRestoration, } from './scroll-restoration' -export { handleHashScroll } from './hash-scroll' - export type { ScrollRestorationOptions, ScrollRestorationEntry, @@ -435,7 +460,6 @@ export type { AnySerializationAdapter, SerializationAdapter, ValidateSerializableInput, - ValidateSerializableInputResult, SerializerExtensions, ValidateSerializable, RegisteredSerializableInput, @@ -444,6 +468,7 @@ export type { Serializable, TSR_SERIALIZABLE, TsrSerializable, + SerializationError, } from './ssr/serializer/transformer' export { diff --git a/packages/router-core/src/load-matches.ts b/packages/router-core/src/load-matches.ts index 3e99c82893..f901a0c97d 100644 --- a/packages/router-core/src/load-matches.ts +++ b/packages/router-core/src/load-matches.ts @@ -45,15 +45,13 @@ const triggerOnReady = (inner: InnerLoadContext): void | Promise<void> => { } const hasForcePendingActiveMatch = (router: AnyRouter): boolean => { - return router.stores.matchesId.state.some((matchId) => { - return router.stores.activeMatchStoresById.get(matchId)?.state._forcePending + return router.stores.matchesId.get().some((matchId) => { + return router.stores.matchStores.get(matchId)?.get()._forcePending }) } const resolvePreload = (inner: InnerLoadContext, matchId: string): boolean => { - return !!( - inner.preload && !inner.router.stores.activeMatchStoresById.has(matchId) - ) + return !!(inner.preload && !inner.router.stores.matchStores.has(matchId)) } /** @@ -138,9 +136,11 @@ const handleRedirectAndNotFound = ( ...prev, status: isRedirect(err) ? 'redirected' - : prev.status === 'pending' - ? 'success' - : prev.status, + : isNotFound(err) + ? 'notFound' + : prev.status === 'pending' + ? 'success' + : prev.status, context: buildMatchContext(inner, match.index), isFetching: false, error: err, @@ -207,7 +207,6 @@ const handleSerialError = ( inner: InnerLoadContext, index: number, err: any, - routerCode: string, ): void => { const { id: matchId, routeId } = inner.matches[index]! const route = inner.router.looseRoutesById[routeId]! @@ -219,7 +218,6 @@ const handleSerialError = ( throw err } - err.routerCode = routerCode inner.firstBadMatchIndex ??= index handleRedirectAndNotFound(inner, inner.router.getMatch(matchId), err) @@ -405,11 +403,11 @@ const executeBeforeLoad = ( const { paramsError, searchError } = match if (paramsError) { - handleSerialError(inner, index, paramsError, 'PARSE_PARAMS') + handleSerialError(inner, index, paramsError) } if (searchError) { - handleSerialError(inner, index, searchError, 'VALIDATE_SEARCH') + handleSerialError(inner, index, searchError) } setupPendingTimeout(inner, matchId, route, match) @@ -499,7 +497,7 @@ const executeBeforeLoad = ( } if (isRedirect(beforeLoadContext) || isNotFound(beforeLoadContext)) { pending() - handleSerialError(inner, index, beforeLoadContext, 'BEFORE_LOAD') + handleSerialError(inner, index, beforeLoadContext) } inner.router.batch(() => { @@ -519,13 +517,13 @@ const executeBeforeLoad = ( pending() return beforeLoadContext .catch((err) => { - handleSerialError(inner, index, err, 'BEFORE_LOAD') + handleSerialError(inner, index, err) }) .then(updateContext) } } catch (err) { pending() - handleSerialError(inner, index, err, 'BEFORE_LOAD') + handleSerialError(inner, index, err) } updateContext(beforeLoadContext) @@ -713,7 +711,7 @@ const runLoader = async ( const pendingPromise = match._nonReactive.minPendingPromise if (pendingPromise) await pendingPromise - // Last but not least, wait for the the components + // Last but not least, wait for the components // to be preloaded before we resolve the match if (route._componentsPromise) await route._componentsPromise inner.updateMatch(matchId, (prev) => ({ @@ -879,17 +877,16 @@ const loadRouteMatch = async ( } } else { const prevMatch = inner.router.getMatch(matchId)! // This is where all of the stale-while-revalidate magic happens - const activeIdAtIndex = inner.router.stores.matchesId.state[index] + const activeIdAtIndex = inner.router.stores.matchesId.get()[index] const activeAtIndex = (activeIdAtIndex && - inner.router.stores.activeMatchStoresById.get(activeIdAtIndex)) || + inner.router.stores.matchStores.get(activeIdAtIndex)) || null const previousRouteMatchId = activeAtIndex?.routeId === routeId ? activeIdAtIndex - : inner.router.stores.activeMatchesSnapshot.state.find( - (d) => d.routeId === routeId, - )?.id + : inner.router.stores.matches.get().find((d) => d.routeId === routeId) + ?.id const preload = resolvePreload(inner, matchId) // there is a loaderPromise, so we are in the middle of a load @@ -923,7 +920,7 @@ const loadRouteMatch = async ( } } else { const nextPreload = - preload && !inner.router.stores.activeMatchStoresById.has(matchId) + preload && !inner.router.stores.matchStores.has(matchId) const match = inner.router.getMatch(matchId)! match._nonReactive.loaderPromise = createControlledPromise<void>() if (nextPreload !== match.preload) { diff --git a/packages/router-core/src/manifest.ts b/packages/router-core/src/manifest.ts index d7fa59f5dc..aca4b96eac 100644 --- a/packages/router-core/src/manifest.ts +++ b/packages/router-core/src/manifest.ts @@ -1,8 +1,11 @@ export type AssetCrossOrigin = 'anonymous' | 'use-credentials' +export type ScriptFormat = 'module' | 'iife' + +export const DEV_STYLES_ATTR = 'data-tanstack-router-dev-styles' export type AssetCrossOriginConfig = | AssetCrossOrigin - | Partial<Record<'modulepreload' | 'stylesheet', AssetCrossOrigin>> + | Partial<Record<'script' | 'stylesheet', AssetCrossOrigin>> export type ManifestAssetLink = | string @@ -13,7 +16,7 @@ export type ManifestAssetLink = export function getAssetCrossOrigin( assetCrossOrigin: AssetCrossOriginConfig | undefined, - kind: 'modulepreload' | 'stylesheet', + kind: 'script' | 'stylesheet', ): AssetCrossOrigin | undefined { if (!assetCrossOrigin) { return undefined @@ -26,6 +29,35 @@ export function getAssetCrossOrigin( return assetCrossOrigin[kind] } +export function getManifestScriptFormat( + manifest: { scriptFormat?: ScriptFormat } | undefined, +): ScriptFormat { + return manifest?.scriptFormat ?? 'module' +} + +export function getScriptPreloadAttrs( + manifest: { scriptFormat?: ScriptFormat } | undefined, + link: ManifestAssetLink, + assetCrossOrigin?: AssetCrossOriginConfig, +): { + rel: 'modulepreload' | 'preload' + as?: 'script' + href: string + crossOrigin?: AssetCrossOrigin +} { + const preloadLink = resolveManifestAssetLink(link) + const crossOrigin = + getAssetCrossOrigin(assetCrossOrigin, 'script') ?? preloadLink.crossOrigin + + return { + ...(getManifestScriptFormat(manifest) === 'iife' + ? { rel: 'preload', as: 'script' } + : { rel: 'modulepreload' }), + href: preloadLink.href, + ...(crossOrigin ? { crossOrigin } : {}), + } +} + export function resolveManifestAssetLink(link: ManifestAssetLink) { if (typeof link === 'string') { return { href: link, crossOrigin: undefined } @@ -35,34 +67,147 @@ export function resolveManifestAssetLink(link: ManifestAssetLink) { } export type Manifest = { - routes: Record< - string, - { - filePath?: string - preloads?: Array<ManifestAssetLink> - assets?: Array<RouterManagedTag> - } - > + scriptFormat?: ScriptFormat + inlineStyle?: ManifestInlineCss + routes: Record<string, ManifestRoute> +} + +export type ServerManifest = { + scriptFormat?: ScriptFormat + inlineCss?: ServerManifestInlineCss + routes: Record<string, ServerManifestRoute> +} + +export type ServerManifestInlineCss = { + styles: Record<string, string> + templates?: Record<string, InlineCssTemplate> +} + +export type InlineCssTemplate = { + strings: Array<string> + urls: Array<string> +} + +export type ManifestRoute = { + filePath?: string + preloads?: Array<ManifestAssetLink> + scripts?: Array<ManifestScript> + css?: Array<ManifestCssLink> +} + +export type ServerManifestRoute = ManifestRoute + +export type ManifestRouteAssets = Pick< + ManifestRoute, + 'preloads' | 'scripts' | 'css' +> + +export type RouterManagedTitleTag = { + tag: 'title' + attrs?: Record<string, any> + children: string +} + +export type RouterManagedMetaTag = { + tag: 'meta' + attrs?: Record<string, any> + children?: never +} + +export type RouterManagedLinkTag = { + tag: 'link' + attrs?: Record<string, any> + children?: never +} + +export type RouterManagedScriptTag = { + tag: 'script' + attrs?: Record<string, any> + children?: string +} + +export type ManifestScript = Omit<RouterManagedScriptTag, 'tag'> + +export type RouterManagedStyleTag = { + tag: 'style' + attrs?: Record<string, any> + children?: string + inlineCss?: true } export type RouterManagedTag = - | { - tag: 'title' - attrs?: Record<string, any> - children: string + | RouterManagedTitleTag + | RouterManagedMetaTag + | RouterManagedLinkTag + | RouterManagedScriptTag + | RouterManagedStyleTag + +export function appendUniqueUserTags( + target: Array<RouterManagedTag>, + tags: Array<RouterManagedTag>, +) { + if (tags.length === 0) { + return + } + + if (tags.length === 1) { + target.push(tags[0]!) + return + } + + const seen = new Set<string>() + for (const tag of tags) { + const key = JSON.stringify(tag) + if (seen.has(key)) { + continue } + seen.add(key) + target.push(tag) + } +} + +export type ManifestCssLink = + | string | { - tag: 'meta' | 'link' - attrs?: Record<string, any> - children?: never - } - | { - tag: 'script' - attrs?: Record<string, any> - children?: string - } - | { - tag: 'style' - attrs?: Record<string, any> - children?: string + href: string + crossOrigin?: AssetCrossOrigin + [DEV_STYLES_ATTR]?: true } + +export type ManifestInlineCss = { + attrs?: Record<string, any> + children?: string +} + +export type RouterManagedInlineCssTag = RouterManagedStyleTag & { + inlineCss: true +} + +export function getStylesheetHref(asset: ManifestCssLink) { + return resolveManifestCssLink(asset).href +} + +export function resolveManifestCssLink(link: ManifestCssLink) { + if (typeof link === 'string') { + return { href: link, crossOrigin: undefined } + } + + return link +} + +export function createInlineCssStyleAsset(css: string): ManifestInlineCss { + return { + attrs: { + suppressHydrationWarning: true, + }, + children: css, + } +} + +export function createInlineCssPlaceholderAsset(): ManifestInlineCss { + return { + attrs: { + suppressHydrationWarning: true, + }, + } +} diff --git a/packages/router-core/src/new-process-route-tree.ts b/packages/router-core/src/new-process-route-tree.ts index 6ba6a45c87..6978b071ce 100644 --- a/packages/router-core/src/new-process-route-tree.ts +++ b/packages/router-core/src/new-process-route-tree.ts @@ -207,10 +207,8 @@ function parseSegments<TRouteLike extends RouteLike>( const path = route.fullPath ?? route.from const length = path.length const caseSensitive = route.options?.caseSensitive ?? defaultCaseSensitive - const skipOnParamError = !!( - route.options?.params?.parse && - route.options?.skipRouteOnParseError?.params - ) + const parseParams = + route.options?.params?.parse ?? route.options?.parseParams while (cursor < length) { const segment = parseSegment(path, cursor, data) let nextNode: AnySegmentNode<TRouteLike> @@ -270,10 +268,10 @@ function parseSegments<TRouteLike extends RouteLike>( ? suffix_raw : suffix_raw.toLowerCase() const existingNode = - !skipOnParamError && + !parseParams && node.dynamic?.find( (s) => - !s.skipOnParamError && + !s.parse && s.caseSensitive === actuallyCaseSensitive && s.prefix === prefix && s.suffix === suffix, @@ -312,10 +310,10 @@ function parseSegments<TRouteLike extends RouteLike>( ? suffix_raw : suffix_raw.toLowerCase() const existingNode = - !skipOnParamError && + !parseParams && node.optional?.find( (s) => - !s.skipOnParamError && + !s.parse && s.caseSensitive === actuallyCaseSensitive && s.prefix === prefix && s.suffix === suffix, @@ -372,7 +370,7 @@ function parseSegments<TRouteLike extends RouteLike>( // create pathless node if ( - skipOnParamError && + parseParams && route.children && !route.isRoot && route.id && @@ -404,9 +402,8 @@ function parseSegments<TRouteLike extends RouteLike>( node = indexNode } - node.parse = route.options?.params?.parse ?? null - node.skipOnParamError = skipOnParamError - node.parsingPriority = route.options?.skipRouteOnParseError?.priority ?? 0 + node.parse = parseParams ?? null + node.priority = route.options?.params?.priority ?? 0 // make node "matchable" if (isLeaf && !node.route) { @@ -433,25 +430,21 @@ function sortDynamic( prefix?: string suffix?: string caseSensitive: boolean - skipOnParamError: boolean - parsingPriority: number + parse: null | ((params: Record<string, string>) => unknown) + priority: number }, b: { prefix?: string suffix?: string caseSensitive: boolean - skipOnParamError: boolean - parsingPriority: number + parse: null | ((params: Record<string, string>) => unknown) + priority: number }, ) { - if (a.skipOnParamError && !b.skipOnParamError) return -1 - if (!a.skipOnParamError && b.skipOnParamError) return 1 - if ( - a.skipOnParamError && - b.skipOnParamError && - (a.parsingPriority || b.parsingPriority) - ) - return b.parsingPriority - a.parsingPriority + if (a.parse && !b.parse) return -1 + if (!a.parse && b.parse) return 1 + if (a.parse && b.parse && (a.priority || b.priority)) + return b.priority - a.priority if (a.prefix && b.prefix && a.prefix !== b.prefix) { if (a.prefix.startsWith(b.prefix)) return -1 if (b.prefix.startsWith(a.prefix)) return 1 @@ -467,8 +460,7 @@ function sortDynamic( if (a.caseSensitive && !b.caseSensitive) return -1 if (!a.caseSensitive && b.caseSensitive) return 1 - // we don't need a tiebreaker here - // at this point the 2 nodes cannot conflict during matching + // Equal specificity preserves route declaration order through stable sort. return 0 } @@ -525,8 +517,7 @@ function createStaticNode<T extends RouteLike>( fullPath, parent: null, parse: null, - skipOnParamError: false, - parsingPriority: 0, + priority: 0, } } @@ -558,8 +549,7 @@ function createDynamicNode<T extends RouteLike>( fullPath, parent: null, parse: null, - skipOnParamError: false, - parsingPriority: 0, + priority: 0, caseSensitive, prefix, suffix, @@ -621,13 +611,10 @@ type SegmentNode<T extends RouteLike> = { depth: number /** route.options.params.parse function, set on the last node of the route */ - parse: null | ((params: Record<string, string>) => any) + parse: null | ((params: Record<string, string>) => unknown) - /** options.skipRouteOnParseError.params ?? false */ - skipOnParamError: boolean - - /** options.skipRouteOnParseError.priority ?? 0 */ - parsingPriority: number + /** route.options.params.priority ?? 0 */ + priority: number } type RouteLike = { @@ -637,13 +624,11 @@ type RouteLike = { parentRoute?: RouteLike // parent route, isRoot?: boolean options?: { - skipRouteOnParseError?: { - params?: boolean - priority?: number - } caseSensitive?: boolean + parseParams?: (params: Record<string, string>) => unknown params?: { - parse?: (params: Record<string, string>) => any + parse?: (params: Record<string, string>) => unknown + priority?: number } } } & @@ -734,7 +719,6 @@ export function findSingleMatch( type RouteMatch<T extends Extract<RouteLike, { fullPath: string }>> = { route: T rawParams: Record<string, string> - parsedParams?: Record<string, unknown> branch: ReadonlyArray<T> } @@ -858,11 +842,6 @@ function findMatch<T extends RouteLike>( * This will be the exhaustive list of all params defined in the route's path. */ rawParams: Record<string, string> - /** - * The accumlulated parsed params of each route in the branch that had `skipRouteOnParseError` enabled. - * Will not contain all params defined in the route's path. Those w/ a `params.parse` but no `skipRouteOnParseError` will need to be parsed separately. - */ - parsedParams?: Record<string, unknown> } | null { const parts = path.split('/') const leaf = getNodeMatch(path, parts, segmentTree, fuzzy) @@ -871,7 +850,6 @@ function findMatch<T extends RouteLike>( return { route: leaf.node.route!, rawParams, - parsedParams: leaf.parsedParams, } } @@ -991,7 +969,7 @@ function extractParams<T extends RouteLike>( ] } -function buildRouteBranch<T extends RouteLike>(route: T) { +export function buildRouteBranch<T extends RouteLike>(route: T) { const list = [route] while (route.parentRoute) { route = route.parentRoute as T @@ -1023,6 +1001,7 @@ type MatchStackFrame<T extends RouteLike> = { * If we really really need to support more than 32 segments we can switch to using a `BigInt` here. It's about 2x slower in worst case scenarios. */ skipped: number + /** Positional bitmasks tracking which consumed URL segments matched each segment kind. */ statics: number dynamics: number optionals: number @@ -1030,7 +1009,6 @@ type MatchStackFrame<T extends RouteLike> = { extract?: ParamExtractionState /** intermediary params from param extraction */ rawParams?: Record<string, string> - parsedParams?: Record<string, unknown> } function getNodeMatch<T extends RouteLike>( @@ -1044,7 +1022,7 @@ function getNodeMatch<T extends RouteLike>( if (path === '/' && segmentTree.index) return { node: segmentTree.index, skipped: 0 } as Pick< Frame, - 'node' | 'skipped' | 'parsedParams' + 'node' | 'skipped' > const trailingSlash = !last(parts) @@ -1066,27 +1044,37 @@ function getNodeMatch<T extends RouteLike>( index: 1, skipped: 0, depth: 1, - statics: 1, + statics: 0, dynamics: 0, optionals: 0, }, ] - let wildcardMatch: Frame | null = null let bestFuzzy: Frame | null = null let bestMatch: Frame | null = null while (stack.length) { const frame = stack.pop()! const { node, index, skipped, depth, statics, dynamics, optionals } = frame - let { extract, rawParams, parsedParams } = frame + let { extract, rawParams } = frame - if (node.skipOnParamError) { - const result = validateMatchParams(path, parts, frame) + // Wildcard candidates are pushed speculatively as fallbacks in case a + // higher-priority wildcard later fails params.parse. If a better wildcard + // has already validated and become bestMatch, lower-priority wildcard + // fallbacks cannot win anymore and should not run params.parse. + if ( + node.kind === SEGMENT_TYPE_WILDCARD && + node.route && + !isFrameMoreSpecific(bestMatch, frame) + ) { + continue + } + + if (node.parse) { + const result = validateParseParams(path, parts, frame) if (!result) continue rawParams = frame.rawParams extract = frame.extract - parsedParams = frame.parsedParams } // In fuzzy mode, track the best partial match we've found so far @@ -1101,7 +1089,13 @@ function getNodeMatch<T extends RouteLike>( const isBeyondPath = index === partsLength if (isBeyondPath) { - if (node.route && !pathIsIndex && isFrameMoreSpecific(bestMatch, frame)) { + if ( + node.route && + (!pathIsIndex || + node.kind === SEGMENT_TYPE_INDEX || + node.kind === SEGMENT_TYPE_WILDCARD) && + isFrameMoreSpecific(bestMatch, frame) + ) { bestMatch = frame } // beyond the length of the path parts, only some segment types can match @@ -1124,17 +1118,21 @@ function getNodeMatch<T extends RouteLike>( optionals, extract, rawParams, - parsedParams, } let indexValid = true - if (node.index.skipOnParamError) { - const result = validateMatchParams(path, parts, indexFrame) + if (node.index.parse) { + const result = validateParseParams(path, parts, indexFrame) if (!result) indexValid = false } if (indexValid) { // perfect match, no need to continue // this is an optimization, algorithm should work correctly without this block - if (statics === partsLength && !dynamics && !optionals && !skipped) { + if ( + !dynamics && + !optionals && + !skipped && + isPerfectStaticMatch(statics, partsLength) + ) { return indexFrame } if (isFrameMoreSpecific(bestMatch, indexFrame)) { @@ -1145,8 +1143,9 @@ function getNodeMatch<T extends RouteLike>( } // 5. Try wildcard match - if (node.wildcard && isFrameMoreSpecific(wildcardMatch, frame)) { - for (const segment of node.wildcard) { + if (node.wildcard) { + for (let i = node.wildcard.length - 1; i >= 0; i--) { + const segment = node.wildcard[i]! const { prefix, suffix } = segment if (prefix) { if (isBeyondPath) continue @@ -1161,26 +1160,18 @@ function getNodeMatch<T extends RouteLike>( const casePart = segment.caseSensitive ? end : end.toLowerCase() if (casePart !== suffix) continue } - // the first wildcard match is the highest priority one - // wildcard matches skip the stack because they cannot have children - const frame = { + // wildcard matches consume the rest of the URL and cannot have children + stack.push({ node: segment, index: partsLength, skipped, - depth, + depth: depth + 1, statics, dynamics, optionals, extract, rawParams, - parsedParams, - } - if (segment.skipOnParamError) { - const result = validateMatchParams(path, parts, frame) - if (!result) continue - } - wildcardMatch = frame - break + }) } } @@ -1201,7 +1192,6 @@ function getNodeMatch<T extends RouteLike>( optionals, extract, rawParams, - parsedParams, }) // enqueue skipping the optional } if (!isBeyondPath) { @@ -1222,10 +1212,9 @@ function getNodeMatch<T extends RouteLike>( depth: nextDepth, statics, dynamics, - optionals: optionals + 1, + optionals: optionals + segmentScore(partsLength, index), extract, rawParams, - parsedParams, }) } } @@ -1249,11 +1238,10 @@ function getNodeMatch<T extends RouteLike>( skipped, depth: depth + 1, statics, - dynamics: dynamics + 1, + dynamics: dynamics + segmentScore(partsLength, index), optionals, extract, rawParams, - parsedParams, }) } } @@ -1269,12 +1257,11 @@ function getNodeMatch<T extends RouteLike>( index: index + 1, skipped, depth: depth + 1, - statics: statics + 1, + statics: statics + segmentScore(partsLength, index), dynamics, optionals, extract, rawParams, - parsedParams, }) } } @@ -1288,12 +1275,11 @@ function getNodeMatch<T extends RouteLike>( index: index + 1, skipped, depth: depth + 1, - statics: statics + 1, + statics: statics + segmentScore(partsLength, index), dynamics, optionals, extract, rawParams, - parsedParams, }) } } @@ -1313,22 +1299,13 @@ function getNodeMatch<T extends RouteLike>( optionals, extract, rawParams, - parsedParams, }) } } } - if (bestMatch && wildcardMatch) { - return isFrameMoreSpecific(wildcardMatch, bestMatch) - ? bestMatch - : wildcardMatch - } - if (bestMatch) return bestMatch - if (wildcardMatch) return wildcardMatch - if (fuzzy && bestFuzzy) { let sliceIndex = bestFuzzy.index for (let i = 0; i < bestFuzzy.index; i++) { @@ -1343,25 +1320,46 @@ function getNodeMatch<T extends RouteLike>( return null } -function validateMatchParams<T extends RouteLike>( +function segmentScore(partsLength: number, index: number): number { + // The specificity scores are bitmasks over consumed URL segments. Earlier + // URL segments should dominate later ones when comparing scores, so the + // first real segment gets the highest bit and the last gets bit 0. Since + // `parts[0]` is the empty string before the leading slash, real URL segments + // are [1, partsLength), making this segment's bit `partsLength - index - 1`. + return 2 ** (partsLength - index - 1) +} + +function isPerfectStaticMatch(statics: number, partsLength: number): boolean { + return statics === 2 ** (partsLength - 1) - 1 +} + +function validateParseParams<T extends RouteLike>( path: string, parts: Array<string>, frame: MatchStackFrame<T>, ) { + let rawParams: Record<string, string> + let state: ParamExtractionState + try { - const [rawParams, state] = extractParams(path, parts, frame) - frame.rawParams = rawParams - frame.extract = state - const parsed = frame.node.parse!(rawParams) - frame.parsedParams = Object.assign( - Object.create(null), - frame.parsedParams, - parsed, - ) - return true + ;[rawParams, state] = extractParams(path, parts, frame) } catch { return null } + + frame.rawParams = rawParams + frame.extract = state + + if (!frame.node.parse) return true + + try { + if (frame.node.parse(rawParams) === false) return null + } catch { + // Thrown parse errors should be surfaced on the selected match by + // extractStrictParams, not used as fallback route selection. + } + + return true } function isFrameMoreSpecific( diff --git a/packages/router-core/src/not-found.ts b/packages/router-core/src/not-found.ts index 0681b82054..ddf8f0a259 100644 --- a/packages/router-core/src/not-found.ts +++ b/packages/router-core/src/not-found.ts @@ -37,5 +37,5 @@ export function notFound(options: NotFoundError = {}) { /** Determine if a value is a TanStack Router not-found error. */ export function isNotFound(obj: any): obj is NotFoundError { - return !!obj?.isNotFound + return obj?.isNotFound === true } diff --git a/packages/router-core/src/path.ts b/packages/router-core/src/path.ts index 70709e6045..577ce00ecf 100644 --- a/packages/router-core/src/path.ts +++ b/packages/router-core/src/path.ts @@ -167,33 +167,7 @@ export function resolvePath({ } } - let segment - let joined = '' - for (let i = 0; i < baseSegments.length; i++) { - if (i > 0) joined += '/' - const part = baseSegments[i]! - if (!part) continue - segment = parseSegment(part, 0, segment) - const kind = segment[0] - if (kind === SEGMENT_TYPE_PATHNAME) { - joined += part - continue - } - const end = segment[5] - const prefix = part.substring(0, segment[1]) - const suffix = part.substring(segment[4], end) - const value = part.substring(segment[2], segment[3]) - if (kind === SEGMENT_TYPE_PARAM) { - joined += prefix || suffix ? `${prefix}{$${value}}${suffix}` : `$${value}` - } else if (kind === SEGMENT_TYPE_WILDCARD) { - joined += prefix || suffix ? `${prefix}{$}${suffix}` : '$' - } else { - // SEGMENT_TYPE_OPTIONAL_PARAM - joined += `${prefix}{-$${value}}${suffix}` - } - } - joined = cleanPath(joined) - const result = joined || '/' + const result = cleanPath(baseSegments.join('/')) || '/' if (key && cache) cache.set(key, result) return result } diff --git a/packages/router-core/src/rewrite.ts b/packages/router-core/src/rewrite.ts index 0da50c5b62..5c82408c00 100644 --- a/packages/router-core/src/rewrite.ts +++ b/packages/router-core/src/rewrite.ts @@ -1,7 +1,6 @@ import { joinPaths, trimPath } from './path' import type { LocationRewrite } from './router' -/** Compose multiple rewrite pairs into a single in/out rewrite. */ /** Compose multiple rewrite pairs into a single in/out rewrite. */ export function composeRewrites(rewrites: Array<LocationRewrite>) { return { @@ -20,7 +19,6 @@ export function composeRewrites(rewrites: Array<LocationRewrite>) { } satisfies LocationRewrite } -/** Create a rewrite pair that strips/adds a basepath on input/output. */ /** Create a rewrite pair that strips/adds a basepath on input/output. */ export function rewriteBasepath(opts: { basepath: string @@ -28,13 +26,10 @@ export function rewriteBasepath(opts: { }) { const trimmedBasepath = trimPath(opts.basepath) const normalizedBasepath = `/${trimmedBasepath}` - const normalizedBasepathWithSlash = `${normalizedBasepath}/` const checkBasepath = opts.caseSensitive ? normalizedBasepath : normalizedBasepath.toLowerCase() - const checkBasepathWithSlash = opts.caseSensitive - ? normalizedBasepathWithSlash - : normalizedBasepathWithSlash.toLowerCase() + const checkBasepathWithSlash = `${checkBasepath}/` return { input: ({ url }) => { @@ -58,7 +53,6 @@ export function rewriteBasepath(opts: { } satisfies LocationRewrite } -/** Execute a location input rewrite if provided. */ /** Execute a location input rewrite if provided. */ export function executeRewriteInput( rewrite: LocationRewrite | undefined, @@ -75,7 +69,6 @@ export function executeRewriteInput( return url } -/** Execute a location output rewrite if provided. */ /** Execute a location output rewrite if provided. */ export function executeRewriteOutput( rewrite: LocationRewrite | undefined, diff --git a/packages/router-core/src/route.ts b/packages/router-core/src/route.ts index 7217f883ab..d7288e4104 100644 --- a/packages/router-core/src/route.ts +++ b/packages/router-core/src/route.ts @@ -173,9 +173,13 @@ export type ResolveParams< export type ParseParamsFn<in out TPath extends string, in out TParams> = ( rawParams: Expand<ResolveParams<TPath>>, -) => TParams extends ResolveParams<TPath, any> - ? TParams - : ResolveParams<TPath, any> +) => TParams | false + +type ValidateParsedParams<TPath extends string, TParams> = [TParams] extends [ + ResolveParams<TPath, any>, +] + ? unknown + : never export type StringifyParamsFn<in out TPath extends string, in out TParams> = ( params: TParams, @@ -183,14 +187,22 @@ export type StringifyParamsFn<in out TPath extends string, in out TParams> = ( export type ParamsOptions<in out TPath extends string, in out TParams> = { params?: { - parse?: ParseParamsFn<TPath, TParams> + parse?: ParseParamsFn<TPath, TParams> & ValidateParsedParams<TPath, TParams> + /** + * When multiple route candidates use `params.parse` during matching, + * higher priorities are tried first. + * + * @default 0 + */ + priority?: number stringify?: StringifyParamsFn<TPath, TParams> } /** @deprecated Use params.parse instead */ - parseParams?: ParseParamsFn<TPath, TParams> + parseParams?: ParseParamsFn<TPath, TParams> & + ValidateParsedParams<TPath, TParams> /** @deprecated Use params.stringify instead @@ -1248,37 +1260,6 @@ export interface UpdatableRouteOptions< in out TBeforeLoadFn, > extends UpdatableStaticRouteOption, UpdatableRouteOptionsExtensions { - /** - * Options to control route matching behavior with runtime code. - * - * @experimental 🚧 this feature is subject to change - * - * @link https://tanstack.com/router/latest/docs/framework/react/api/router/RouteOptionsType - */ - skipRouteOnParseError?: { - /** - * If `true`, skip this route during matching if `params.parse` fails. - * - * Without this option, a `/$param` route could match *any* value for `param`, - * and only later during the route lifecycle would `params.parse` run and potentially - * show the `errorComponent` if validation failed. - * - * With this option enabled, the route will only match if `params.parse` succeeds. - * If it fails, the router will continue trying to match other routes, potentially - * finding a different route that works, or ultimately showing the `notFoundComponent`. - * - * @default false - */ - params?: boolean - /** - * In cases where multiple routes would need to run `params.parse` during matching - * to determine which route to pick, this priority number can be used as a tie-breaker - * for which route to try first. Higher number = higher priority. - * - * @default 0 - */ - priority?: number - } /** * If true, this route will be matched as case-sensitive * diff --git a/packages/router-core/src/router.ts b/packages/router-core/src/router.ts index 301648a80e..2efb43cd42 100644 --- a/packages/router-core/src/router.ts +++ b/packages/router-core/src/router.ts @@ -8,12 +8,14 @@ import { encodePathLikeUrl, findLast, functionalUpdate, + hasKeys, isDangerousProtocol, last, nullReplaceEqualDeep, replaceEqualDeep, } from './utils' import { + buildRouteBranch, findFlatMatch, findRouteMatch, findSingleMatch, @@ -50,6 +52,7 @@ import type { import type { SearchParser, SearchSerializer } from './searchParams' import type { AnyRedirect, ResolvedRedirect } from './redirect' import type { + HistoryAction, HistoryLocation, HistoryState, ParsedHistoryState, @@ -95,7 +98,11 @@ import type { CommitLocationOptions, NavigateFn, } from './RouterProvider' -import type { Manifest, RouterManagedTag } from './manifest' +import type { + Manifest, + ManifestRouteAssets, + RouterManagedTag, +} from './manifest' import type { AnySchema, AnyValidator } from './validators' import type { NavigateOptions, ResolveRelativePath, ToOptions } from './link' import type { NotFoundError } from './not-found' @@ -338,9 +345,8 @@ export interface RouterOptions< * @link [API Docs](https://tanstack.com/router/latest/docs/framework/react/api/router/RouterOptionsType#dehydrate-method) * @link [Guide](https://tanstack.com/router/latest/docs/framework/react/guide/external-data-loading#critical-dehydrationhydration) */ - dehydrate?: () => Constrain< - TDehydrated, - ValidateSerializableInput<Register, TDehydrated> + dehydrate?: () => Awaitable< + Constrain<TDehydrated, ValidateSerializableInput<Register, TDehydrated>> > /** * A function that will be called when the router is hydrated. @@ -732,15 +738,16 @@ export type GetMatchRoutesFn = (pathname: string) => { matchedRoutes: ReadonlyArray<AnyRoute> /** exhaustive params, still in their string form */ routeParams: Record<string, string> - /** partial params, parsed from routeParams during matching */ - parsedParams: Record<string, unknown> | undefined foundRoute: AnyRoute | undefined parseError?: unknown } export type EmitFn = (routerEvent: RouterEvent) => void -export type LoadFn = (opts?: { sync?: boolean }) => Promise<void> +export type LoadFn = (opts?: { + sync?: boolean + action?: { type: HistoryAction } +}) => Promise<void> export type CommitLocationFn = ({ viewTransition, @@ -783,32 +790,47 @@ export type ClearCacheFn<TRouter extends AnyRouter> = (opts?: { }) => void export interface ServerSsr { - /** - * Injects HTML synchronously into the stream. - * Emits an onInjectedHtml event that listeners can handle. - * If no subscriber is listening, the HTML is buffered and can be retrieved via takeBufferedHtml(). - */ + /** Framework-only: injects router-owned HTML into the SSR stream. */ injectHtml: (html: string) => void - /** - * Injects a script tag synchronously into the stream. - */ + /** Framework-only: injects a router-owned script tag into the SSR stream. */ injectScript: (script: string) => void isDehydrated: () => boolean isSerializationFinished: () => boolean + /** Framework-only: atomically reserves the pass-through stream path if safe. */ + reserveStreamFastPath: () => boolean + /** Framework-only. */ + onInjectedHtml: (listener: () => void) => () => void + /** Framework-only. */ onRenderFinished: (listener: () => void) => void + /** Framework-only. */ setRenderFinished: () => void + /** Framework-only. */ cleanup: () => void - onSerializationFinished: (listener: () => void) => void - dehydrate: () => Promise<void> - takeBufferedScripts: () => RouterManagedTag | undefined /** - * Takes any buffered HTML that was injected. - * Returns the buffered HTML string (which may include multiple script tags) or undefined if empty. + * Register a listener invoked when the SSR request lifecycle ends (success, + * error, abort, or stream lifetime expiry). Use to tear down per-request + * resources whose references would otherwise pin the router (e.g. query + * cache subscriptions, gcTime timers, abort controllers). + * + * Listeners run synchronously and exactly once. Errors are caught and logged. */ + onCleanup: (listener: () => void) => void + /** Framework-only. */ + onSerializationFinished: (listener: () => void) => () => void + /** Framework-only. */ + dehydrate: (opts?: { requestAssets?: ManifestRouteAssets }) => Promise<void> + /** Framework-only. */ + takeBufferedScripts: () => RouterManagedTag | undefined + /** Framework-only: takes buffered router-owned HTML. */ takeBufferedHtml: () => string | undefined + /** Framework-only. */ liftScriptBarrier: () => void } +export interface RouterSsrLifecycle { + onServerSsrAttach?: Array<(serverSsr: ServerSsr) => void> +} + export type AnyRouterWithContext<TContext> = RouterCore< AnyRouteWithContext<TContext>, any, @@ -881,6 +903,11 @@ export function getLocationChangeInfo( return { fromLocation, toLocation, pathChanged, hrefChanged, hashChanged } } +export const locationHistoryActions = new WeakMap< + ParsedLocation, + HistoryAction +>() + export type CreateRouterFn = < TRouteTree extends AnyRoute, TTrailingSlashOption extends TrailingSlashOption = 'never', @@ -970,6 +997,7 @@ export class RouterCore< routesByPath!: RoutesByPath<TRouteTree> processedTree!: ProcessedTree<TRouteTree, any, any> resolvePathCache!: LRUCache<string, string> + private routeBranchCache = new WeakMap<AnyRoute, ReadonlyArray<AnyRoute>>() isServer!: boolean pathParamsDecoder?: (encoded: string) => string protocolAllowlist!: Set<string> @@ -1167,7 +1195,7 @@ export class RouterCore< } if (needsLocationUpdate && this.stores) { - this.stores.location.setState(() => this.latestLocation) + this.stores.location.set(this.latestLocation) } if ( @@ -1176,13 +1204,13 @@ export class RouterCore< typeof window.CSS?.supports === 'function' ) { this.isViewTransitionTypesSupported = window.CSS.supports( - 'selector(:active-view-transition-type(a)', + 'selector(:active-view-transition-type(a))', ) } } get state(): RouterState<TRouteTree> { - return this.stores.__store.state + return this.stores.__store.get() } updateLatestLocation = () => { @@ -1341,15 +1369,23 @@ export class RouterCore< return location } - /** Resolve a path against the router basepath and trailing-slash policy. */ + /** Resolve a path using the router's trailing-slash policy. */ resolvePathWithBase = (from: string, path: string) => { - const resolvedPath = resolvePath({ + return resolvePath({ base: from, - to: cleanPath(path), + to: path.includes('//') ? cleanPath(path) : path, trailingSlash: this.options.trailingSlash, cache: this.resolvePathCache, }) - return resolvedPath + } + + private getRouteBranch(route: AnyRoute) { + let branch = this.routeBranchCache.get(route) + if (!branch) { + branch = buildRouteBranch(route) + this.routeBranchCache.set(route, branch) + } + return branch } get looseRoutesById() { @@ -1389,7 +1425,7 @@ export class RouterCore< opts?: MatchRoutesOpts, ): Array<AnyRouteMatch> { const matchedRoutesResult = this.getMatchedRoutes(next.pathname) - const { foundRoute, routeParams, parsedParams } = matchedRoutesResult + const { foundRoute, routeParams } = matchedRoutesResult let { matchedRoutes } = matchedRoutesResult let isGlobalNotFound = false @@ -1418,9 +1454,9 @@ export class RouterCore< // Snapshot of active match state keyed by routeId, used to stabilise // params/search across navigations. const previousActiveMatchesByRouteId = new Map<string, AnyRouteMatch>() - for (const store of this.stores.activeMatchStoresById.values()) { + for (const store of this.stores.matchStores.values()) { if (store.routeId) { - previousActiveMatchesByRouteId.set(store.routeId, store.state) + previousActiveMatchesByRouteId.set(store.routeId, store.get()) } } @@ -1515,7 +1551,7 @@ export class RouterCore< if (!existingMatch) { try { - extractStrictParams(route, usedParams, parsedParams!, strictParams) + extractStrictParams(route, strictParams) } catch (err: any) { if (isNotFound(err) || isRedirect(err)) { paramsError = err @@ -1685,7 +1721,7 @@ export class RouterCore< search: Record<string, unknown> params: Record<string, unknown> } { - const { matchedRoutes, routeParams, parsedParams } = this.getMatchedRoutes( + const { matchedRoutes, routeParams } = this.getMatchedRoutes( location.pathname, ) const lastRoute = last(matchedRoutes)! @@ -1713,10 +1749,9 @@ export class RouterCore< } // Determine params: reuse from state if possible, otherwise parse - const lastStateMatchId = last(this.stores.matchesId.state) + const lastStateMatchId = last(this.stores.matchesId.get()) const lastStateMatch = - lastStateMatchId && - this.stores.activeMatchStoresById.get(lastStateMatchId)?.state + lastStateMatchId && this.stores.matchStores.get(lastStateMatchId)?.get() const canReuseParams = lastStateMatch && lastStateMatch.routeId === lastRoute.id && @@ -1733,12 +1768,7 @@ export class RouterCore< ) for (const route of matchedRoutes) { try { - extractStrictParams( - route, - routeParams, - parsedParams ?? {}, - strictParams, - ) + extractStrictParams(route, strictParams) } catch { // Ignore errors, we're not actually routing } @@ -1765,16 +1795,16 @@ export class RouterCore< } cancelMatches = () => { - this.stores.pendingMatchesId.state.forEach((matchId) => { + this.stores.pendingIds.get().forEach((matchId) => { this.cancelMatch(matchId) }) - this.stores.matchesId.state.forEach((matchId) => { - if (this.stores.pendingMatchStoresById.has(matchId)) { + this.stores.matchesId.get().forEach((matchId) => { + if (this.stores.pendingMatchStores.has(matchId)) { return } - const match = this.stores.activeMatchStoresById.get(matchId)?.state + const match = this.stores.matchStores.get(matchId)?.get() if (!match) { return } @@ -1834,9 +1864,7 @@ export class RouterCore< dest.unsafeRelative === 'path' ? currentLocation.pathname : (dest.from ?? lightweightResult.fullPath) - - // ensure this includes the basePath if set - const fromPath = this.resolvePathWithBase(defaultedFromPath, '.') + const destTo = dest.to ? `${dest.to}` : undefined // From search should always use the current location const fromSearch = lightweightResult.search @@ -1846,11 +1874,15 @@ export class RouterCore< lightweightResult.params, ) - // Resolve the next to - // ensure this includes the basePath if set - const nextTo = dest.to - ? this.resolvePathWithBase(fromPath, `${dest.to}`) - : this.resolvePathWithBase(fromPath, '.') + const isAbsoluteTo = destTo?.charCodeAt(0) === 47 + const sourcePath = isAbsoluteTo + ? '/' + : this.resolvePathWithBase(defaultedFromPath, '.') + + // Resolve the destination. Absolute destinations don't need the source path. + const nextTo = destTo + ? this.resolvePathWithBase(sourcePath, destTo) + : sourcePath // Resolve the next params const nextParams = @@ -1863,24 +1895,33 @@ export class RouterCore< functionalUpdate(dest.params as any, fromParams), ) - // Use lightweight getMatchedRoutes instead of matchRoutesInternal - // This avoids creating full match objects (AbortController, ControlledPromise, etc.) - // which are expensive and not needed for buildLocation - const destMatchResult = this.getMatchedRoutes(nextTo) - let destRoutes = destMatchResult.matchedRoutes + const destRoute = this.routesByPath[ + trimPathRight(nextTo) as keyof typeof this.routesByPath + ] as AnyRoute | undefined - // Compute globalNotFoundRouteId using the same logic as matchRoutesInternal - const isGlobalNotFound = - !destMatchResult.foundRoute || - (destMatchResult.foundRoute.path !== '/' && - destMatchResult.routeParams['**']) + let destRoutes: ReadonlyArray<AnyRoute> + if (destRoute) { + destRoutes = this.getRouteBranch(destRoute) + } else if (nextTo.includes('$')) { + // Route templates must match routesByPath exactly. A miss here is a + // typed destination mismatch, not a concrete URL to route-match. + destRoutes = [] + } else { + const destMatchResult = this.getMatchedRoutes(nextTo) + destRoutes = destMatchResult.matchedRoutes - if (isGlobalNotFound && this.options.notFoundRoute) { - destRoutes = [...destRoutes, this.options.notFoundRoute] + if ( + this.options.notFoundRoute && + (!destMatchResult.foundRoute || + (destMatchResult.foundRoute.path !== '/' && + destMatchResult.routeParams['**'])) + ) { + destRoutes = [...destRoutes, this.options.notFoundRoute] + } } // If there are any params, we need to stringify them - if (Object.keys(nextParams).length > 0) { + if (destRoutes.length && hasKeys(nextParams)) { for (const route of destRoutes) { const fn = route.options.params?.stringify ?? route.options.stringifyParams @@ -1899,8 +1940,7 @@ export class RouterCore< } const nextPathname = opts.leaveParams - ? // Use the original template path for interpolation - // This preserves the original parameter syntax including optional parameters + ? // Keep path params uninterpolated for matchRoute/template matching. nextTo : decodePath( interpolatePath({ @@ -1911,6 +1951,24 @@ export class RouterCore< }).interpolatedPath, ).path + if ( + process.env.NODE_ENV !== 'production' && + destRoute && + !opts.leaveParams + ) { + try { + const roundTrip = this.getMatchedRoutes(nextPathname) + if (roundTrip.foundRoute?.id !== destRoute.id) { + console.warn( + `Generated path "${nextPathname}" for route "${destRoute.id}" matched route "${roundTrip.foundRoute?.id}" instead. This can happen when multiple route templates resolve to the same URL. Use the route template that matches the intended route, or adjust params.stringify if it changed the target path.`, + ) + } + } catch { + // Ignore roundtrip validation errors. The generated location will be + // handled by the normal navigation flow. + } + } + // Resolve the next search let nextSearch = fromSearch if (opts._includeValidateSearch && this.options.search?.strict) { @@ -2083,6 +2141,7 @@ export class RouterCore< ignoreBlocker, ...next }) => { + let historyAction: HistoryAction | undefined const isSameState = () => { // the following props are ignored but may still be provided when navigating, // temporarily add the previous values to the next state so they don't affect @@ -2158,7 +2217,9 @@ export class RouterCore< this.shouldViewTransition = viewTransition - this.history[next.replace ? 'replace' : 'push']( + historyAction = next.replace ? 'REPLACE' : 'PUSH' + + this.history[historyAction === 'REPLACE' ? 'replace' : 'push']( nextHistory.publicHref, nextHistory.state, { ignoreBlocker }, @@ -2168,7 +2229,13 @@ export class RouterCore< this.resetNextScroll = next.resetScroll ?? true if (!this.history.subscribers.size) { - this.load() + this.load( + historyAction + ? { + action: { type: historyAction }, + } + : undefined, + ) } return this.commitLocationPromise @@ -2354,39 +2421,45 @@ export class RouterCore< // Match the routes const pendingMatches = this.matchRoutes(this.latestLocation) - const nextCachedMatches = this.stores.cachedMatchesSnapshot.state.filter( - (d) => !pendingMatches.some((e) => e.id === d.id), - ) + const nextCachedMatches = this.stores.cachedMatches + .get() + .filter((d) => !pendingMatches.some((e) => e.id === d.id)) // Ingest the new matches this.batch(() => { - this.stores.status.setState(() => 'pending') - this.stores.statusCode.setState(() => 200) - this.stores.isLoading.setState(() => true) - this.stores.location.setState(() => this.latestLocation) - this.stores.setPendingMatches(pendingMatches) + this.stores.status.set('pending') + this.stores.statusCode.set(200) + this.stores.isLoading.set(true) + this.stores.location.set(this.latestLocation) + this.stores.setPending(pendingMatches) // If a cached match moved to pending matches, remove it from cached matches - this.stores.setCachedMatches(nextCachedMatches) + this.stores.setCached(nextCachedMatches) }) } - load: LoadFn = async (opts?: { sync?: boolean }): Promise<void> => { + load: LoadFn = async (opts): Promise<void> => { + const historyAction = opts?.action?.type let redirect: AnyRedirect | undefined let notFound: NotFoundError | undefined let loadPromise: Promise<void> const previousLocation = - this.stores.resolvedLocation.state ?? this.stores.location.state + this.stores.resolvedLocation.get() ?? this.stores.location.get() // eslint-disable-next-line prefer-const loadPromise = new Promise<void>((resolve) => { this.startTransition(async () => { try { this.beforeLoad() + if (historyAction) { + locationHistoryActions.set(this.latestLocation, historyAction) + } else { + locationHistoryActions.delete(this.latestLocation) + } const next = this.latestLocation - const prevLocation = this.stores.resolvedLocation.state + const prevLocation = this.stores.resolvedLocation.get() const locationChangeInfo = getLocationChangeInfo(next, prevLocation) - if (!this.stores.redirect.state) { + if (!this.stores.redirect.get()) { this.emit({ type: 'onBeforeNavigate', ...locationChangeInfo, @@ -2402,7 +2475,7 @@ export class RouterCore< router: this, sync: opts?.sync, forceStaleReload: previousLocation.href === next.href, - matches: this.stores.pendingMatchesSnapshot.state, + matches: this.stores.pendingMatches.get(), location: next, updateMatch: this.updateMatch, // eslint-disable-next-line @typescript-eslint/require-await @@ -2426,27 +2499,25 @@ export class RouterCore< let hookStayingMatches: Array<AnyRouteMatch> | null = null this.batch(() => { - const pendingMatches = - this.stores.pendingMatchesSnapshot.state + const pendingMatches = this.stores.pendingMatches.get() const mountPending = pendingMatches.length - const currentMatches = - this.stores.activeMatchesSnapshot.state + const currentMatches = this.stores.matches.get() exitingMatches = mountPending ? currentMatches.filter( (match) => - !this.stores.pendingMatchStoresById.has(match.id), + !this.stores.pendingMatchStores.has(match.id), ) : null // Lifecycle-hook identity: routeId only (route presence in tree) // Build routeId sets from pools to avoid derived stores. const pendingRouteIds = new Set<string>() - for (const s of this.stores.pendingMatchStoresById.values()) { + for (const s of this.stores.pendingMatchStores.values()) { if (s.routeId) pendingRouteIds.add(s.routeId) } const activeRouteIds = new Set<string>() - for (const s of this.stores.activeMatchStoresById.values()) { + for (const s of this.stores.matchStores.values()) { if (s.routeId) activeRouteIds.add(s.routeId) } @@ -2466,8 +2537,8 @@ export class RouterCore< ) : currentMatches - this.stores.isLoading.setState(() => false) - this.stores.loadedAt.setState(() => Date.now()) + this.stores.isLoading.set(false) + this.stores.loadedAt.set(Date.now()) /** * When committing new matches, cache any exiting matches that are still usable. * Routes that resolved with `status: 'error'` or `status: 'notFound'` are @@ -2475,10 +2546,10 @@ export class RouterCore< * or reloads re-run their loaders instead of reusing the failed/not-found data. */ if (mountPending) { - this.stores.setActiveMatches(pendingMatches) - this.stores.setPendingMatches([]) - this.stores.setCachedMatches([ - ...this.stores.cachedMatchesSnapshot.state, + this.stores.setMatches(pendingMatches) + this.stores.setPending([]) + this.stores.setCached([ + ...this.stores.cachedMatches.get(), ...exitingMatches!.filter( (d) => d.status !== 'error' && @@ -2525,15 +2596,13 @@ export class RouterCore< ? redirect.status : notFound ? 404 - : this.stores.activeMatchesSnapshot.state.some( - (d) => d.status === 'error', - ) + : this.stores.matches.get().some((d) => d.status === 'error') ? 500 : 200 this.batch(() => { - this.stores.statusCode.setState(() => nextStatusCode) - this.stores.redirect.setState(() => redirect) + this.stores.statusCode.set(nextStatusCode) + this.stores.redirect.set(redirect) }) } @@ -2561,13 +2630,11 @@ export class RouterCore< let newStatusCode: number | undefined = undefined if (this.hasNotFoundMatch()) { newStatusCode = 404 - } else if ( - this.stores.activeMatchesSnapshot.state.some((d) => d.status === 'error') - ) { + } else if (this.stores.matches.get().some((d) => d.status === 'error')) { newStatusCode = 500 } if (newStatusCode !== undefined) { - this.stores.statusCode.setState(() => newStatusCode) + this.stores.statusCode.set(newStatusCode) } } @@ -2596,7 +2663,7 @@ export class RouterCore< this.isViewTransitionTypesSupported ) { const next = this.latestLocation - const prevLocation = this.stores.resolvedLocation.state + const prevLocation = this.stores.resolvedLocation.get() const resolvedViewTransitionTypes = typeof shouldViewTransition.types === 'function' @@ -2626,30 +2693,30 @@ export class RouterCore< updateMatch: UpdateMatchFn = (id, updater) => { this.startTransition(() => { - const pendingMatch = this.stores.pendingMatchStoresById.get(id) + const pendingMatch = this.stores.pendingMatchStores.get(id) if (pendingMatch) { - pendingMatch.setState(updater) + pendingMatch.set(updater) return } - const activeMatch = this.stores.activeMatchStoresById.get(id) + const activeMatch = this.stores.matchStores.get(id) if (activeMatch) { - activeMatch.setState(updater) + activeMatch.set(updater) return } - const cachedMatch = this.stores.cachedMatchStoresById.get(id) + const cachedMatch = this.stores.cachedMatchStores.get(id) if (cachedMatch) { - const next = updater(cachedMatch.state) + const next = updater(cachedMatch.get()) if (next.status === 'redirected') { - const deleted = this.stores.cachedMatchStoresById.delete(id) + const deleted = this.stores.cachedMatchStores.delete(id) if (deleted) { - this.stores.cachedMatchesId.setState((prev) => + this.stores.cachedIds.set((prev) => prev.filter((matchId) => matchId !== id), ) } } else { - cachedMatch.setState(() => next) + cachedMatch.set(next) } } }) @@ -2657,9 +2724,9 @@ export class RouterCore< getMatch: GetMatchFn = (matchId: string): AnyRouteMatch | undefined => { return ( - this.stores.cachedMatchStoresById.get(matchId)?.state ?? - this.stores.pendingMatchStoresById.get(matchId)?.state ?? - this.stores.activeMatchStoresById.get(matchId)?.state + this.stores.cachedMatchStores.get(matchId)?.get() ?? + this.stores.pendingMatchStores.get(matchId)?.get() ?? + this.stores.matchStores.get(matchId)?.get() ) } @@ -2696,15 +2763,9 @@ export class RouterCore< } this.batch(() => { - this.stores.setActiveMatches( - this.stores.activeMatchesSnapshot.state.map(invalidate), - ) - this.stores.setCachedMatches( - this.stores.cachedMatchesSnapshot.state.map(invalidate), - ) - this.stores.setPendingMatches( - this.stores.pendingMatchesSnapshot.state.map(invalidate), - ) + this.stores.setMatches(this.stores.matches.get().map(invalidate)) + this.stores.setCached(this.stores.cachedMatches.get().map(invalidate)) + this.stores.setPending(this.stores.pendingMatches.get().map(invalidate)) }) this.shouldViewTransition = false @@ -2762,13 +2823,13 @@ export class RouterCore< clearCache: ClearCacheFn<this> = (opts) => { const filter = opts?.filter if (filter !== undefined) { - this.stores.setCachedMatches( - this.stores.cachedMatchesSnapshot.state.filter( - (m) => !filter(m as MakeRouteMatchUnion<this>), - ), + this.stores.setCached( + this.stores.cachedMatches + .get() + .filter((m) => !filter(m as MakeRouteMatchUnion<this>)), ) } else { - this.stores.setCachedMatches([]) + this.stores.setCached([]) } } @@ -2816,13 +2877,13 @@ export class RouterCore< }) const activeMatchIds = new Set([ - ...this.stores.matchesId.state, - ...this.stores.pendingMatchesId.state, + ...this.stores.matchesId.get(), + ...this.stores.pendingIds.get(), ]) const loadedMatchIds = new Set([ ...activeMatchIds, - ...this.stores.cachedMatchesId.state, + ...this.stores.cachedIds.get(), ]) // If the matches are already loaded, we need to add them to the cached matches. @@ -2830,8 +2891,8 @@ export class RouterCore< (match) => !loadedMatchIds.has(match.id), ) if (matchesToCache.length) { - const cachedMatches = this.stores.cachedMatchesSnapshot.state - this.stores.setCachedMatches([...cachedMatches, ...matchesToCache]) + const cachedMatches = this.stores.cachedMatches.get() + this.stores.setCached([...cachedMatches, ...matchesToCache]) } try { @@ -2886,16 +2947,16 @@ export class RouterCore< } const next = this.buildLocation(matchLocation as any) - if (opts?.pending && this.stores.status.state !== 'pending') { + if (opts?.pending && this.stores.status.get() !== 'pending') { return false } const pending = - opts?.pending === undefined ? !this.stores.isLoading.state : opts.pending + opts?.pending === undefined ? !this.stores.isLoading.get() : opts.pending const baseLocation = pending ? this.latestLocation - : this.stores.resolvedLocation.state || this.stores.location.state + : this.stores.resolvedLocation.get() || this.stores.location.get() const match = findSingleMatch( next.pathname, @@ -2930,10 +2991,12 @@ export class RouterCore< serverSsr?: ServerSsr + serverSsrLifecycle?: RouterSsrLifecycle + hasNotFoundMatch = () => { - return this.stores.activeMatchesSnapshot.state.some( - (d) => d.status === 'notFound' || d.globalNotFound, - ) + return this.stores.matches + .get() + .some((d) => d.status === 'notFound' || d.globalNotFound) } } @@ -3026,17 +3089,15 @@ export function getMatchedRoutes<TRouteLike extends RouteLike>({ const trimmedPath = trimPathRight(pathname) let foundRoute: TRouteLike | undefined = undefined - let parsedParams: Record<string, unknown> | undefined = undefined const match = findRouteMatch<TRouteLike>(trimmedPath, processedTree, true) if (match) { foundRoute = match.route Object.assign(routeParams, match.rawParams) // Copy params, because they're cached - parsedParams = Object.assign(Object.create(null), match.parsedParams) } const matchedRoutes = match?.branch || [routesById[rootRouteId]!] - return { matchedRoutes, routeParams, foundRoute, parsedParams } + return { matchedRoutes, routeParams, foundRoute } } /** @@ -3188,22 +3249,14 @@ function findGlobalNotFoundRouteId( function extractStrictParams( route: AnyRoute, - referenceParams: Record<string, unknown>, - parsedParams: Record<string, unknown>, accumulatedParams: Record<string, unknown>, ) { const parseParams = route.options.params?.parse ?? route.options.parseParams if (parseParams) { - if (route.options.skipRouteOnParseError) { - // Use pre-parsed params from route matching for skipRouteOnParseError routes - for (const key in referenceParams) { - if (key in parsedParams) { - accumulatedParams[key] = parsedParams[key] - } - } - } else { - const result = parseParams(accumulatedParams as Record<string, string>) - Object.assign(accumulatedParams, result) + const result = parseParams(accumulatedParams as Record<string, string>) + if (result === false) { + throw new Error('Route params.parse returned false for a matched route') } + Object.assign(accumulatedParams, result) } } diff --git a/packages/router-core/src/scroll-restoration-inline.ts b/packages/router-core/src/scroll-restoration-inline.ts index b6c772fa69..76ab0027b3 100644 --- a/packages/router-core/src/scroll-restoration-inline.ts +++ b/packages/router-core/src/scroll-restoration-inline.ts @@ -1,71 +1,43 @@ -export default function (options: { - storageKey: string - key?: string - behavior?: ScrollToOptions['behavior'] - shouldScrollRestoration?: boolean -}) { +export default function (storageKey: string, key?: string) { let byKey try { - byKey = JSON.parse(sessionStorage.getItem(options.storageKey) || '{}') - } catch (error) { - console.error(error) + byKey = JSON.parse(sessionStorage.getItem(storageKey) || '{}') + } catch { return } - const resolvedKey = options.key || window.history.state?.__TSR_key - const elementEntries = resolvedKey ? byKey[resolvedKey] : undefined + const elementEntries = byKey?.[key || history.state?.__TSR_key] + let windowRestored = false - if ( - options.shouldScrollRestoration && - elementEntries && - typeof elementEntries === 'object' && - Object.keys(elementEntries).length > 0 - ) { - for (const elementSelector in elementEntries) { - const entry = elementEntries[elementSelector] - - if (!entry || typeof entry !== 'object') { - continue - } - - const scrollX = entry.scrollX - const scrollY = entry.scrollY - - if (!Number.isFinite(scrollX) || !Number.isFinite(scrollY)) { - continue - } + for (const elementSelector in elementEntries) { + const entry = elementEntries[elementSelector] + const scrollX = entry?.scrollX + const scrollY = entry?.scrollY + if (Number.isFinite(scrollX) && Number.isFinite(scrollY)) { if (elementSelector === 'window') { - window.scrollTo({ - top: scrollY, - left: scrollX, - behavior: options.behavior, - }) + scrollTo(scrollX, scrollY) + windowRestored = true } else if (elementSelector) { - let element - try { - element = document.querySelector(elementSelector) - } catch { - continue - } - - if (element) { - element.scrollLeft = scrollX - element.scrollTop = scrollY - } + const element = document.querySelector(elementSelector) + if (element) { + element.scrollLeft = scrollX + element.scrollTop = scrollY + } + } catch {} } } - - return } - const hash = window.location.hash.split('#', 2)[1] + if (windowRestored) return + + const hash = location.hash.slice(1) if (hash) { const hashScrollIntoViewOptions = - window.history.state?.__hashScrollIntoViewOptions ?? true + history.state?.__hashScrollIntoViewOptions ?? true if (hashScrollIntoViewOptions) { const el = document.getElementById(hash) @@ -77,5 +49,5 @@ export default function (options: { return } - window.scrollTo({ top: 0, left: 0, behavior: options.behavior }) + scrollTo(0, 0) } diff --git a/packages/router-core/src/scroll-restoration-script/server.ts b/packages/router-core/src/scroll-restoration-script/server.ts index cc7f0f38fb..5c5ce5e734 100644 --- a/packages/router-core/src/scroll-restoration-script/server.ts +++ b/packages/router-core/src/scroll-restoration-script/server.ts @@ -6,33 +6,16 @@ import { import { escapeHtml } from '../utils' import type { AnyRouter } from '../router' -type InlineScrollRestorationScriptOptions = { - storageKey: string - key?: string - behavior?: ScrollToOptions['behavior'] - shouldScrollRestoration?: boolean -} - const defaultInlineScrollRestorationScript = `(${minifiedScrollRestorationScript})(${escapeHtml( - JSON.stringify({ - storageKey, - shouldScrollRestoration: true, - } satisfies InlineScrollRestorationScriptOptions), + JSON.stringify(storageKey), )})` -function getScrollRestorationScript( - options: InlineScrollRestorationScriptOptions, -) { - if ( - options.storageKey === storageKey && - options.shouldScrollRestoration === true && - options.key === undefined && - options.behavior === undefined - ) { +function getScrollRestorationScript(key?: string) { + if (key === undefined) { return defaultInlineScrollRestorationScript } - return `(${minifiedScrollRestorationScript})(${escapeHtml(JSON.stringify(options))})` + return `(${minifiedScrollRestorationScript})(${escapeHtml(JSON.stringify(storageKey))},${escapeHtml(JSON.stringify(key))})` } export function getScrollRestorationScriptForRouter(router: AnyRouter) { @@ -56,9 +39,5 @@ export function getScrollRestorationScriptForRouter(router: AnyRouter) { return defaultInlineScrollRestorationScript } - return getScrollRestorationScript({ - storageKey, - shouldScrollRestoration: true, - key: userKey, - }) + return getScrollRestorationScript(userKey) } diff --git a/packages/router-core/src/scroll-restoration.ts b/packages/router-core/src/scroll-restoration.ts index 828fc8e868..f3c67802d5 100644 --- a/packages/router-core/src/scroll-restoration.ts +++ b/packages/router-core/src/scroll-restoration.ts @@ -1,8 +1,7 @@ import { isServer } from '@tanstack/router-core/isServer' -import { functionalUpdate, isPlainObject } from './utils' +import { locationHistoryActions } from './router' import type { AnyRouter } from './router' import type { ParsedLocation } from './location' -import type { NonNullableUpdater } from './utils' export type ScrollRestorationEntry = { scrollX: number; scrollY: number } @@ -10,12 +9,6 @@ type ScrollRestorationByElement = Record<string, ScrollRestorationEntry> type ScrollRestorationByKey = Record<string, ScrollRestorationByElement> -type ScrollRestorationCache = { - readonly state: ScrollRestorationByKey - set: (updater: NonNullableUpdater<ScrollRestorationByKey>) => void - persist: () => void -} - export type ScrollRestorationOptions = { getKey?: (location: ParsedLocation) => string scrollBehavior?: ScrollToOptions['behavior'] @@ -23,60 +16,46 @@ export type ScrollRestorationOptions = { function getSafeSessionStorage() { try { - return typeof window !== 'undefined' && - typeof window.sessionStorage === 'object' - ? window.sessionStorage - : undefined + // Accessing sessionStorage itself can throw SecurityError in locked-down + // contexts, e.g. sandboxed/opaque origins or blocked storage policies. + return sessionStorage } catch { - // silent - return undefined + return } } // SessionStorage key used to store scroll positions across navigations. export const storageKey = 'tsr-scroll-restoration-v1_3' +const safeSessionStorage = getSafeSessionStorage() -function createScrollRestorationCache(): ScrollRestorationCache | null { - const safeSessionStorage = getSafeSessionStorage() - if (!safeSessionStorage) { - return null - } - - let state: ScrollRestorationByKey = {} - +function createScrollRestorationCache() { try { - const parsed = JSON.parse(safeSessionStorage.getItem(storageKey) || '{}') - if (isPlainObject(parsed)) { - state = parsed as ScrollRestorationByKey - } + return JSON.parse( + safeSessionStorage?.getItem(storageKey) || '{}', + ) as ScrollRestorationByKey } catch { // ignore invalid session storage payloads - } - - const persist = () => { - try { - safeSessionStorage.setItem(storageKey, JSON.stringify(state)) - } catch { - if (process.env.NODE_ENV !== 'production') { - console.warn( - '[ts-router] Could not persist scroll restoration state to sessionStorage.', - ) - } - } - } - - return { - get state() { - return state - }, - set: (updater) => { - state = functionalUpdate(updater, state) || state - }, - persist, + return {} } } -export const scrollRestorationCache = createScrollRestorationCache() +function persistScrollRestorationCache() { + try { + safeSessionStorage?.setItem( + storageKey, + JSON.stringify(scrollRestorationCache), + ) + } catch { + if (process.env.NODE_ENV !== 'production') { + console.warn( + '[ts-router] Could not persist scroll restoration state to sessionStorage.', + ) + } + } +} + +const scrollRestorationCache = /* @__PURE__ */ createScrollRestorationCache() +const scrollRestorationIdAttribute = 'data-scroll-restoration-id' /** * The default `getKey` function for `useScrollRestoration`. @@ -88,16 +67,29 @@ export const defaultGetScrollRestorationKey = (location: ParsedLocation) => { return location.state.__TSR_key! || location.href } -function getCssSelector(el: any): string { - const path = [] +function getScrollRestorationSelector(element: Element): string { + const attrId = element.getAttribute(scrollRestorationIdAttribute) + if (attrId) { + return `[${scrollRestorationIdAttribute}="${attrId}"]` + } + + let selector = '' + let el: any = element let parent: HTMLElement + while ((parent = el.parentNode)) { - path.push( - `${el.tagName}:nth-child(${Array.prototype.indexOf.call(parent.children, el) + 1})`, - ) + let index = 1 + let sibling = el + while ((sibling = sibling.previousElementSibling)) { + index++ + } + + const part = `${el.localName}:nth-child(${index})` + selector = selector ? `${part} > ${selector}` : part el = parent } - return `${path.reverse().join(' > ')}`.toLowerCase() + + return selector } export function getElementScrollRestorationEntry( @@ -117,11 +109,14 @@ export function getElementScrollRestorationEntry( ): ScrollRestorationEntry | undefined { const getKey = options.getKey || defaultGetScrollRestorationKey const restoreKey = getKey(router.latestLocation) + const entries = scrollRestorationCache[restoreKey] + + if (!entries) { + return + } if (options.id) { - return scrollRestorationCache?.state[restoreKey]?.[ - `[${scrollRestorationIdAttribute}="${options.id}"]` - ] + return entries[`[${scrollRestorationIdAttribute}="${options.id}"]`] } const element = options.getElement?.() @@ -129,35 +124,55 @@ export function getElementScrollRestorationEntry( return } - return scrollRestorationCache?.state[restoreKey]?.[ - element instanceof Window ? windowScrollTarget : getCssSelector(element) + return entries[ + element === window + ? windowScrollTarget + : getScrollRestorationSelector(element as Element) ] } let ignoreScroll = false const windowScrollTarget = 'window' -const scrollRestorationIdAttribute = 'data-scroll-restoration-id' type ScrollTarget = typeof windowScrollTarget | Element -export function setupScrollRestoration(router: AnyRouter, force?: boolean) { - if (!scrollRestorationCache && !(isServer ?? router.isServer)) { - return +function getElement(selector: string | (() => Element | null | undefined)) { + try { + return typeof selector === 'function' + ? selector() + : document.querySelector(selector) + } catch {} + return +} + +function getScrollToTopElements( + scrollToTopSelectors: NonNullable< + AnyRouter['options']['scrollToTopSelectors'] + >, +): Array<Element> { + const elements: Array<Element> = [] + + for (const selector of scrollToTopSelectors) { + if (selector === windowScrollTarget) { + continue + } + + const element = getElement(selector) + if (element) { + elements.push(element) + } } - const cache = scrollRestorationCache + return elements +} - const shouldScrollRestoration = - force ?? router.options.scrollRestoration ?? false +export function setupScrollRestoration(router: AnyRouter, force?: boolean) { + // Keep hash/top scrolling active even when sessionStorage is unavailable. - if (shouldScrollRestoration) { + if (force ?? router.options.scrollRestoration) { router.isScrollRestoring = true } - if ( - (isServer ?? router.isServer) || - router.isScrollRestorationSetup || - !cache - ) { + if ((isServer ?? router.isServer) || router.isScrollRestorationSetup) { return } @@ -167,88 +182,77 @@ export function setupScrollRestoration(router: AnyRouter, force?: boolean) { const getKey = router.options.getScrollRestorationKey || defaultGetScrollRestorationKey const trackedScrollEntries = new Map<ScrollTarget, ScrollRestorationEntry>() + const setTrackedScrollEntry = ( + target: ScrollTarget, + scrollX: number, + scrollY: number, + ) => { + const entry = + trackedScrollEntries.get(target) || ({} as ScrollRestorationEntry) + entry.scrollX = scrollX + entry.scrollY = scrollY + trackedScrollEntries.set(target, entry) + } - window.history.scrollRestoration = 'manual' + history.scrollRestoration = 'manual' const onScroll = (event: Event) => { if (ignoreScroll || !router.isScrollRestoring) { return } - if (event.target === document || event.target === window) { - trackedScrollEntries.set(windowScrollTarget, { - scrollX: window.scrollX || 0, - scrollY: window.scrollY || 0, - }) + if (event.target === document) { + setTrackedScrollEntry(windowScrollTarget, scrollX, scrollY) } else { const target = event.target as Element - trackedScrollEntries.set(target, { - scrollX: target.scrollLeft || 0, - scrollY: target.scrollTop || 0, - }) + setTrackedScrollEntry(target, target.scrollLeft, target.scrollTop) } } // Snapshot the current page's tracked scroll targets before navigation or unload. - const snapshotCurrentScrollTargets = (restoreKey?: string) => { - if ( - !router.isScrollRestoring || - !restoreKey || - trackedScrollEntries.size === 0 || - !cache - ) { + const snapshotCurrentScrollTargets = (restoreKey: string) => { + if (!router.isScrollRestoring) { return } - const keyEntry = (cache.state[restoreKey] ||= + const keyEntry = (scrollRestorationCache[restoreKey] ||= {} as ScrollRestorationByElement) for (const [target, position] of trackedScrollEntries) { - let selector: string | undefined - if (target === windowScrollTarget) { - selector = windowScrollTarget + keyEntry[windowScrollTarget] = position } else if (target.isConnected) { - const attrId = target.getAttribute(scrollRestorationIdAttribute) - selector = attrId - ? `[${scrollRestorationIdAttribute}="${attrId}"]` - : getCssSelector(target) + keyEntry[getScrollRestorationSelector(target)] = position } - - if (!selector) { - continue - } - - keyEntry[selector] = position } } document.addEventListener('scroll', onScroll, true) router.subscribe('onBeforeLoad', (event) => { - snapshotCurrentScrollTargets( - event.fromLocation ? getKey(event.fromLocation) : undefined, - ) + if (event.fromLocation) { + snapshotCurrentScrollTargets(getKey(event.fromLocation)) + } trackedScrollEntries.clear() }) - window.addEventListener('pagehide', () => { + addEventListener('pagehide', () => { snapshotCurrentScrollTargets( getKey( - router.stores.resolvedLocation.state ?? router.stores.location.state, + router.stores.resolvedLocation.get() ?? router.stores.location.get(), ), ) - cache.persist() + persistScrollRestorationCache() }) // Restore destination scroll after the new route has rendered. router.subscribe('onRendered', (event) => { - const cacheKey = getKey(event.toLocation) const behavior = router.options.scrollRestorationBehavior const scrollToTopSelectors = router.options.scrollToTopSelectors + const shouldResetScroll = router.resetNextScroll + let scrollToTopElements: Array<Element> | undefined trackedScrollEntries.clear() - if (!router.resetNextScroll) { + if (!shouldResetScroll) { router.resetNextScroll = true - return } if ( @@ -258,100 +262,112 @@ export function setupScrollRestoration(router: AnyRouter, force?: boolean) { return } - ignoreScroll = true + const cacheKey = getKey(event.toLocation) + const fromCacheKey = event.fromLocation && getKey(event.fromLocation) - try { - const elementEntries = router.isScrollRestoring - ? cache.state[cacheKey] - : undefined - let restored = false + if (router.isScrollRestoring && fromCacheKey && fromCacheKey !== cacheKey) { + const fromElementEntries = scrollRestorationCache[fromCacheKey] - if (elementEntries) { - for (const elementSelector in elementEntries) { - const entry = elementEntries[elementSelector] - - if (!isPlainObject(entry)) { - continue - } - - const { scrollX, scrollY } = entry as { - scrollX?: unknown - scrollY?: unknown - } - - if (!Number.isFinite(scrollX) || !Number.isFinite(scrollY)) { - continue - } + if (fromElementEntries) { + let toElementEntries = scrollRestorationCache[cacheKey] + for (const elementSelector in fromElementEntries) { if (elementSelector === windowScrollTarget) { - window.scrollTo({ - top: scrollY as number, - left: scrollX as number, - behavior, - }) - restored = true - } else if (elementSelector) { - let element - - try { - element = document.querySelector(elementSelector) - } catch { + if (shouldResetScroll) { + continue + } + } else { + const element = getElement(elementSelector) + if (!element) { continue } - if (element) { - element.scrollLeft = scrollX as number - element.scrollTop = scrollY as number - restored = true + if (shouldResetScroll && scrollToTopSelectors) { + scrollToTopElements ??= + getScrollToTopElements(scrollToTopSelectors) + if (scrollToTopElements.includes(element)) { + continue + } + } + } + + if (!toElementEntries) { + toElementEntries = scrollRestorationCache[cacheKey] = + {} as ScrollRestorationByElement + } + + toElementEntries[elementSelector] ??= + fromElementEntries[elementSelector]! + } + } + } + + ignoreScroll = true + + try { + const hash = event.toLocation.hash + const hashScrollIntoViewOptions = + event.toLocation.state.__hashScrollIntoViewOptions ?? true + let windowRestored = false + + if (shouldResetScroll) { + const action = locationHistoryActions.get(event.toLocation) + const skipWindowRestore = + hash && + hashScrollIntoViewOptions && + (action === 'PUSH' || action === 'REPLACE') + + const elementEntries = router.isScrollRestoring + ? scrollRestorationCache[cacheKey] + : undefined + + if (elementEntries) { + for (const elementSelector in elementEntries) { + const { scrollX, scrollY } = elementEntries[elementSelector]! + + if (elementSelector === windowScrollTarget) { + if (skipWindowRestore) { + continue + } + + scrollTo({ + top: scrollY, + left: scrollX, + behavior, + }) + windowRestored = true + } else { + const element = getElement(elementSelector) + if (element) { + element.scrollLeft = scrollX + element.scrollTop = scrollY + } } } } - } - if (!restored) { - const hash = router.history.location.hash.slice(1) - - if (hash) { - const hashScrollIntoViewOptions = - window.history.state?.__hashScrollIntoViewOptions ?? true - - if (hashScrollIntoViewOptions) { - const el = document.getElementById(hash) - if (el) { - el.scrollIntoView(hashScrollIntoViewOptions) - } - } - } else { + if (!windowRestored && !hash) { const scrollOptions = { top: 0, left: 0, behavior, } - window.scrollTo(scrollOptions) + scrollTo(scrollOptions) if (scrollToTopSelectors) { - for (const selector of scrollToTopSelectors) { - if (selector === windowScrollTarget) continue - const element = - typeof selector === 'function' - ? selector() - : document.querySelector(selector) - if (element) { - element.scrollTo(scrollOptions) - } + scrollToTopElements ??= getScrollToTopElements(scrollToTopSelectors) + for (const element of scrollToTopElements) { + element.scrollTo(scrollOptions) } } } } + + if (!windowRestored && hash && hashScrollIntoViewOptions) { + document.getElementById(hash)?.scrollIntoView(hashScrollIntoViewOptions) + } } finally { ignoreScroll = false } - - if (router.isScrollRestoring) { - cache.set((state) => { - state[cacheKey] ||= {} as ScrollRestorationByElement - return state - }) - } }) } diff --git a/packages/router-core/src/ssr/createRequestHandler.ts b/packages/router-core/src/ssr/createRequestHandler.ts index 5f6dd0fd69..32377b2bea 100644 --- a/packages/router-core/src/ssr/createRequestHandler.ts +++ b/packages/router-core/src/ssr/createRequestHandler.ts @@ -5,10 +5,11 @@ import { getNormalizedURL, getOrigin, } from './ssr-server' +import { normalizeSsrResponse } from './handlerCallback' import type { HandlerCallback } from './handlerCallback' import type { AnyHeaders } from './headers' import type { AnyRouter } from '../router' -import type { Manifest } from '../manifest' +import type { ServerManifest } from '../manifest' export type RequestHandler<TRouter extends AnyRouter> = ( cb: HandlerCallback<TRouter>, @@ -21,12 +22,11 @@ export function createRequestHandler<TRouter extends AnyRouter>({ }: { createRouter: () => TRouter request: Request - getRouterManifest?: () => Manifest | Promise<Manifest> + getRouterManifest?: () => ServerManifest | Promise<ServerManifest> }): RequestHandler<TRouter> { return async (cb) => { const router = createRouter() - // Track whether the callback will handle cleanup - let cbWillCleanup = false + let responseOwnsCleanup = false try { attachRouterServerSsrUtils({ @@ -58,19 +58,19 @@ export function createRequestHandler<TRouter extends AnyRouter>({ router, }) - // Mark that the callback will handle cleanup - cbWillCleanup = true - return cb({ + const response = await cb({ request, router, responseHeaders, }) + const ssrResponse = normalizeSsrResponse(response) + responseOwnsCleanup = ssrResponse.serverSsrCleanup === 'stream' + return ssrResponse.response } finally { - if (!cbWillCleanup) { + if (!responseOwnsCleanup) { // Clean up router SSR state if the callback won't handle it // (e.g., if an error occurred before the callback was invoked). - // When the callback runs, it handles cleanup (either via transformStreamWithRouter - // for streaming, or directly in renderRouterToString for non-streaming). + // Transformed streaming response bodies clean up when consumed/cancelled. router.serverSsr?.cleanup() } } @@ -78,13 +78,13 @@ export function createRequestHandler<TRouter extends AnyRouter>({ } function getRequestHeaders(opts: { router: AnyRouter }): Headers { - const matchHeaders = - opts.router.stores.activeMatchesSnapshot.state.map<AnyHeaders>( - (match) => match.headers, - ) + const matchHeaders: Array<AnyHeaders> = [] + for (const match of opts.router.stores.matches.get()) { + matchHeaders.push(match.headers) + } // Handle Redirects - const redirect = opts.router.stores.redirect.state + const redirect = opts.router.stores.redirect.get() if (redirect) { matchHeaders.push(redirect.headers) } diff --git a/packages/router-core/src/ssr/handlerCallback.ts b/packages/router-core/src/ssr/handlerCallback.ts index e9ae2cd3ba..22aa843063 100644 --- a/packages/router-core/src/ssr/handlerCallback.ts +++ b/packages/router-core/src/ssr/handlerCallback.ts @@ -1,11 +1,94 @@ import type { AnyRouter } from '../router' +export type SsrResponse = + | { + response: Response + serverSsrCleanup: 'none' + } + | { + response: Response + serverSsrCleanup: 'stream' + dispose: (reason?: unknown) => Promise<void> + } + +export type HandlerCallbackResult = Response | SsrResponse + +export function isSsrResponse(value: unknown): value is SsrResponse { + return ( + typeof value === 'object' && + value !== null && + 'response' in value && + 'serverSsrCleanup' in value + ) +} + +export function normalizeSsrResponse( + result: HandlerCallbackResult, +): SsrResponse { + return isSsrResponse(result) + ? result + : { response: result, serverSsrCleanup: 'none' } +} + +export function createSsrStreamResponse<TRouter extends AnyRouter>( + router: TRouter, + response: Response, +): SsrResponse { + if (!response.body) { + throw new Error('Invariant failed: SSR stream response requires a body') + } + + let disposed = false + return { + response, + serverSsrCleanup: 'stream', + async dispose(reason?: unknown) { + if (disposed) return + disposed = true + + try { + await response.body!.cancel(reason) + } catch { + // ignore; fallback cleanup below still releases router SSR state + } + + router.serverSsr?.cleanup() + }, + } +} + +export async function replaceSsrResponse( + result: HandlerCallbackResult, + response: Response, + reason?: unknown, +): Promise<SsrResponse> { + const ssrResponse = normalizeSsrResponse(result) + if (ssrResponse.serverSsrCleanup === 'stream') { + await ssrResponse.dispose(reason) + } + return { response, serverSsrCleanup: 'none' } +} + +export async function stripSsrResponseBody( + result: HandlerCallbackResult, + reason?: unknown, +): Promise<SsrResponse> { + const ssrResponse = normalizeSsrResponse(result) + if (ssrResponse.serverSsrCleanup === 'stream') { + await ssrResponse.dispose(reason) + } + return { + response: new Response(null, ssrResponse.response), + serverSsrCleanup: 'none', + } +} + export interface HandlerCallback<TRouter extends AnyRouter> { (ctx: { request: Request router: TRouter responseHeaders: Headers - }): Response | Promise<Response> + }): HandlerCallbackResult | Promise<HandlerCallbackResult> } export function defineHandlerCallback<TRouter extends AnyRouter>( diff --git a/packages/router-core/src/ssr/serializer/RawStream.ts b/packages/router-core/src/ssr/serializer/RawStream.ts index b5cba6d1a5..cbfbcd9342 100644 --- a/packages/router-core/src/ssr/serializer/RawStream.ts +++ b/packages/router-core/src/ssr/serializer/RawStream.ts @@ -1,5 +1,5 @@ import { createPlugin, createStream } from 'seroval' -import type { Plugin } from 'seroval' +import type { PluginData, PluginInfo, SerovalNode } from 'seroval' /** * Hint for RawStream encoding strategy during SSR serialization. @@ -240,61 +240,71 @@ function toTextStream(readable: ReadableStream<Uint8Array>) { } // Factory plugin for binary mode -const RawStreamFactoryBinaryPlugin = createPlugin< +const RawStreamFactoryBinaryPlugin = /* @__PURE__ */ createPlugin< Record<string, never>, - undefined + PluginInfo >({ tag: 'tss/RawStreamFactory', test(value) { return value === RAW_STREAM_FACTORY_BINARY }, parse: { - sync() { - return undefined + sync(_value, _ctx, _data) { + return {} }, - async() { - return Promise.resolve(undefined) + async async(_value, _ctx, _data) { + return {} }, - stream() { - return undefined + stream(_value, _ctx, _data) { + return {} }, }, - serialize() { + serialize(_node, _ctx, _data) { return FACTORY_BINARY }, - deserialize() { + deserialize(_node, _ctx, _data) { return RAW_STREAM_FACTORY_BINARY }, }) // Factory plugin for text mode -const RawStreamFactoryTextPlugin = createPlugin< +const RawStreamFactoryTextPlugin = /* @__PURE__ */ createPlugin< Record<string, never>, - undefined + PluginInfo >({ tag: 'tss/RawStreamFactoryText', test(value) { return value === RAW_STREAM_FACTORY_TEXT }, parse: { - sync() { - return undefined + sync(_value, _ctx, _data) { + return {} }, - async() { - return Promise.resolve(undefined) + async async(_value, _ctx, _data) { + return {} }, - stream() { - return undefined + stream(_value, _ctx, _data) { + return {} }, }, - serialize() { + serialize(_node, _ctx, _data) { return FACTORY_TEXT }, - deserialize() { + deserialize(_node, _ctx, _data) { return RAW_STREAM_FACTORY_TEXT }, }) +export interface RawStreamSSRNode extends PluginInfo { + hint: SerovalNode + factory: SerovalNode + stream: SerovalNode +} + +export interface RawStreamRPCNode extends PluginInfo { + streamId: SerovalNode +} + /** * SSR Plugin - uses base64 or UTF-8+base64 encoding for chunks, delegates to seroval's stream mechanism. * Used during SSR when serializing to JavaScript code for HTML injection. @@ -303,7 +313,10 @@ const RawStreamFactoryTextPlugin = createPlugin< * - 'binary': Always base64 encode (default) * - 'text': Try UTF-8 first, fallback to base64 for invalid UTF-8 */ -export const RawStreamSSRPlugin: Plugin<any, any> = createPlugin({ +export const RawStreamSSRPlugin = /* @__PURE__ */ createPlugin< + RawStream, + RawStreamSSRNode +>({ tag: 'tss/RawStream', extends: [RawStreamFactoryBinaryPlugin, RawStreamFactoryTextPlugin], @@ -312,19 +325,19 @@ export const RawStreamSSRPlugin: Plugin<any, any> = createPlugin({ }, parse: { - sync(value: RawStream, ctx) { + sync(value: RawStream, ctx, _data) { // Sync parse not really supported for streams, return empty stream const factory = value.hint === 'text' ? RAW_STREAM_FACTORY_TEXT : RAW_STREAM_FACTORY_BINARY return { - hint: value.hint, + hint: ctx.parse(value.hint), factory: ctx.parse(factory), stream: ctx.parse(createStream()), } }, - async async(value: RawStream, ctx) { + async async(value: RawStream, ctx, _data) { const factory = value.hint === 'text' ? RAW_STREAM_FACTORY_TEXT @@ -334,12 +347,12 @@ export const RawStreamSSRPlugin: Plugin<any, any> = createPlugin({ ? toTextStream(value.stream) : toBinaryStream(value.stream) return { - hint: value.hint, + hint: await ctx.parse(value.hint), factory: await ctx.parse(factory), stream: await ctx.parse(encodedStream), } }, - stream(value: RawStream, ctx) { + stream(value: RawStream, ctx, _data) { const factory = value.hint === 'text' ? RAW_STREAM_FACTORY_TEXT @@ -349,14 +362,14 @@ export const RawStreamSSRPlugin: Plugin<any, any> = createPlugin({ ? toTextStream(value.stream) : toBinaryStream(value.stream) return { - hint: value.hint, + hint: ctx.parse(value.hint), factory: ctx.parse(factory), stream: ctx.parse(encodedStream), } }, }, - serialize(node: { hint: RawStreamHint; factory: any; stream: any }, ctx) { + serialize(node: RawStreamSSRNode, ctx, _data) { return ( '(' + ctx.serialize(node.factory) + @@ -366,23 +379,14 @@ export const RawStreamSSRPlugin: Plugin<any, any> = createPlugin({ ) }, - deserialize( - node: { hint: RawStreamHint; factory: any; stream: any }, - ctx, - ): any { + deserialize(node: RawStreamSSRNode, ctx, _data): any { const stream: ReturnType<typeof createStream> = ctx.deserialize(node.stream) - return node.hint === 'text' + const hint = ctx.deserialize(node.hint) + return hint === 'text' ? RAW_STREAM_FACTORY_CONSTRUCTOR_TEXT(stream) : RAW_STREAM_FACTORY_CONSTRUCTOR_BINARY(stream) }, -}) as Plugin<any, any> - -/** - * Node type for RPC plugin serialization - */ -interface RawStreamRPCNode { - streamId: number -} +}) /** * Creates an RPC plugin instance that registers raw streams with a multiplexer. @@ -391,13 +395,12 @@ interface RawStreamRPCNode { * * @param onRawStream Callback invoked when a RawStream is encountered during serialization */ -export function createRawStreamRPCPlugin( - onRawStream: OnRawStreamCallback, -): Plugin<any, any> { +/* @__NO_SIDE_EFFECTS__ */ +export function createRawStreamRPCPlugin(onRawStream: OnRawStreamCallback) { // Own stream counter - sequential IDs starting at 1, independent of seroval internals let nextStreamId = 1 - return createPlugin({ + return /* @__PURE__ */ createPlugin<RawStream, RawStreamRPCNode>({ tag: 'tss/RawStream', test(value: unknown) { @@ -405,15 +408,15 @@ export function createRawStreamRPCPlugin( }, parse: { - async(value: RawStream) { + async async(value: RawStream, ctx, _data: PluginData) { const streamId = nextStreamId++ onRawStream(streamId, value.stream) - return Promise.resolve({ streamId }) + return { streamId: await ctx.parse(streamId) } }, - stream(value: RawStream) { + stream(value: RawStream, ctx, _data: PluginData) { const streamId = nextStreamId++ onRawStream(streamId, value.stream) - return { streamId } + return { streamId: ctx.parse(streamId) } }, }, @@ -431,7 +434,7 @@ export function createRawStreamRPCPlugin( 'RawStreamRPCPlugin.deserialize should not be called. Use createRawStreamDeserializePlugin on client.', ) }, - }) as Plugin<any, any> + }) } /** @@ -442,8 +445,8 @@ export function createRawStreamRPCPlugin( */ export function createRawStreamDeserializePlugin( getOrCreateStream: (id: number) => ReadableStream<Uint8Array>, -): Plugin<any, any> { - return createPlugin({ +) { + return /* @__PURE__ */ createPlugin<any, RawStreamRPCNode>({ tag: 'tss/RawStream', test: () => false, // Client never serializes RawStream @@ -457,8 +460,14 @@ export function createRawStreamDeserializePlugin( ) }, - deserialize(node: RawStreamRPCNode) { - return getOrCreateStream(node.streamId) + deserialize(node, ctx, _data) { + // In normal seroval usage, ctx.deserialize exists. + // Some unit tests call plugin.deserialize directly with a minimal ctx. + const id = + typeof (ctx as any)?.deserialize === 'function' + ? (ctx as any).deserialize(node.streamId) + : (node as any).streamId + return getOrCreateStream(id as number) }, - }) as Plugin<any, any> + }) } diff --git a/packages/router-core/src/ssr/serializer/ShallowErrorPlugin.ts b/packages/router-core/src/ssr/serializer/ShallowErrorPlugin.ts index f3cc6290c8..e6b12983a5 100644 --- a/packages/router-core/src/ssr/serializer/ShallowErrorPlugin.ts +++ b/packages/router-core/src/ssr/serializer/ShallowErrorPlugin.ts @@ -1,7 +1,7 @@ import { createPlugin } from 'seroval' -import type { SerovalNode } from 'seroval' +import type { PluginInfo, SerovalNode } from 'seroval' -export interface ErrorNode { +export interface ErrorNode extends PluginInfo { message: SerovalNode } diff --git a/packages/router-core/src/ssr/serializer/seroval-plugins.ts b/packages/router-core/src/ssr/serializer/seroval-plugins.ts index de10d3bdc0..b180003c79 100644 --- a/packages/router-core/src/ssr/serializer/seroval-plugins.ts +++ b/packages/router-core/src/ssr/serializer/seroval-plugins.ts @@ -1,12 +1,13 @@ import { ReadableStreamPlugin } from 'seroval-plugins/web' import { ShallowErrorPlugin } from './ShallowErrorPlugin' import { RawStreamSSRPlugin } from './RawStream' +import type { RawStream } from './RawStream' import type { Plugin } from 'seroval' export const defaultSerovalPlugins = [ ShallowErrorPlugin as Plugin<Error, any>, // RawStreamSSRPlugin must come before ReadableStreamPlugin to match first - RawStreamSSRPlugin, + RawStreamSSRPlugin as Plugin<RawStream, any>, // ReadableStreamNode is not exported by seroval ReadableStreamPlugin as Plugin<ReadableStream, any>, ] diff --git a/packages/router-core/src/ssr/serializer/transformer.ts b/packages/router-core/src/ssr/serializer/transformer.ts index 85f55dd434..6eeed9b6e6 100644 --- a/packages/router-core/src/ssr/serializer/transformer.ts +++ b/packages/router-core/src/ssr/serializer/transformer.ts @@ -1,6 +1,6 @@ import { createPlugin } from 'seroval' import { GLOBAL_TSR } from '../constants' -import type { Plugin, SerovalNode } from 'seroval' +import type { Plugin, PluginInfo, SerovalNode } from 'seroval' import type { RegisteredConfigType, RegisteredSsr, @@ -14,6 +14,7 @@ declare const TSR_SERIALIZABLE: unique symbol export type TSR_SERIALIZABLE = typeof TSR_SERIALIZABLE export type TsrSerializable = { [TSR_SERIALIZABLE]: true } + export interface DefaultSerializable { number: number string: string @@ -25,6 +26,7 @@ export interface DefaultSerializable { Uint8Array: Uint8Array RawStream: RawStream TsrSerializable: TsrSerializable + void: void } export interface SerializableExtensions extends DefaultSerializable {} @@ -72,13 +74,14 @@ export interface CreateSerializationAdapterOptions< fromSerializable: (value: TOutput) => TInput } -export type ValidateSerializable<T, TSerializable> = - T extends ReadonlyArray<unknown> - ? ResolveArrayShape<T, TSerializable, 'input'> - : T extends TSerializable - ? T - : T extends (...args: Array<any>) => any - ? 'Function is not serializable' +export type ValidateSerializable<T, TSerializable> = T extends TSerializable + ? T + : T extends (...args: Array<any>) => any + ? SerializationError<'Function may not be serializable'> + : T extends RegisteredReadableStream + ? SerializationError<'JSX is not be serializable'> + : T extends ReadonlyArray<any> + ? ValidateSerializableArray<T, TSerializable> : T extends Promise<any> ? ValidateSerializablePromise<T, TSerializable> : T extends ReadableStream<any> @@ -89,9 +92,9 @@ export type ValidateSerializable<T, TSerializable> = ? ValidateSerializableMap<T, TSerializable> : T extends AsyncGenerator<any, any> ? ValidateSerializableAsyncGenerator<T, TSerializable> - : { - [K in keyof T]: ValidateSerializable<T[K], TSerializable> - } + : T extends object + ? ValidateSerializableMapped<T, TSerializable> + : SerializationError<'Type may not be serializable'> export type ValidateSerializableAsyncGenerator<T, TSerializable> = T extends AsyncGenerator<infer T, infer TReturn, infer TNext> @@ -125,16 +128,26 @@ export type ValidateSerializableMap<T, TSerializable> = > : never -export type RegisteredReadableStream = - unknown extends SerializerExtensions['ReadableStream'] - ? never - : SerializerExtensions['ReadableStream'] +export type ValidateSerializableArray<T, TSerializable> = T extends readonly [ + any, + ...Array<any>, +] + ? ValidateSerializableMapped<T, TSerializable> + : T extends Array<infer U> + ? Array<ValidateSerializable<U, TSerializable>> + : T extends ReadonlyArray<infer U> + ? ReadonlyArray<ValidateSerializable<U, TSerializable>> + : never -export interface DefaultSerializerExtensions { - ReadableStream: unknown +export type ValidateSerializableMapped<T, TSerializable> = { + [K in keyof T]: ValidateSerializable<T[K], TSerializable> } -export interface SerializerExtensions extends DefaultSerializerExtensions {} +const SERIALIZATION_ERROR = Symbol.for('TSR_SERIALIZATION_ERROR') + +export interface SerializationError<in out TMessage extends string> { + [SERIALIZATION_ERROR]: TMessage +} export interface SerializationAdapter< TInput, @@ -161,27 +174,34 @@ export interface SerializationAdapterTypes< export type AnySerializationAdapter = SerializationAdapter<any, any, any> +export interface AdapterNode extends PluginInfo { + v: SerovalNode +} + /** Create a Seroval plugin for server-side serialization only. */ +/* @__NO_SIDE_EFFECTS__ */ export function makeSsrSerovalPlugin( serializationAdapter: AnySerializationAdapter, options: { didRun: boolean }, -): Plugin<any, SerovalNode> { - return createPlugin<any, SerovalNode>({ +): Plugin<any, AdapterNode> { + return /* @__PURE__ */ createPlugin<any, AdapterNode>({ tag: '$TSR/t/' + serializationAdapter.key, test: serializationAdapter.test, parse: { - stream(value, ctx) { - return ctx.parse(serializationAdapter.toSerializable(value)) + stream(value, ctx, _data) { + return { + v: ctx.parse(serializationAdapter.toSerializable(value)), + } }, }, - serialize(node, ctx) { + serialize(node, ctx, _data) { options.didRun = true return ( GLOBAL_TSR + '.t.get("' + serializationAdapter.key + '")(' + - ctx.serialize(node) + + ctx.serialize(node.v) + ')' ) }, @@ -191,27 +211,34 @@ export function makeSsrSerovalPlugin( } /** Create a Seroval plugin for client/server symmetric (de)serialization. */ +/* @__NO_SIDE_EFFECTS__ */ export function makeSerovalPlugin( serializationAdapter: AnySerializationAdapter, -): Plugin<any, SerovalNode> { - return createPlugin<any, SerovalNode>({ +): Plugin<any, AdapterNode> { + return /* @__PURE__ */ createPlugin<any, AdapterNode>({ tag: '$TSR/t/' + serializationAdapter.key, test: serializationAdapter.test, parse: { - sync(value, ctx) { - return ctx.parse(serializationAdapter.toSerializable(value)) + sync(value, ctx, _data) { + return { + v: ctx.parse(serializationAdapter.toSerializable(value)), + } }, - async async(value, ctx) { - return await ctx.parse(serializationAdapter.toSerializable(value)) + async async(value, ctx, _data) { + return { + v: await ctx.parse(serializationAdapter.toSerializable(value)), + } }, - stream(value, ctx) { - return ctx.parse(serializationAdapter.toSerializable(value)) + stream(value, ctx, _data) { + return { + v: ctx.parse(serializationAdapter.toSerializable(value)), + } }, }, // we don't generate JS code outside of SSR (for now) serialize: undefined as never, - deserialize(node, ctx) { - return serializationAdapter.fromSerializable(ctx.deserialize(node)) + deserialize(node, ctx, _data) { + return serializationAdapter.fromSerializable(ctx.deserialize(node.v)) }, }) } @@ -234,20 +261,6 @@ export type RegisteredSerializationAdapters<TRegister> = RegisteredConfigType< 'serializationAdapters' > -export type ValidateSerializableInputResult<TRegister, T> = - ValidateSerializableResult<T, RegisteredSerializableInput<TRegister>> - -export type ValidateSerializableResult<T, TSerializable> = - T extends ReadonlyArray<unknown> - ? ResolveArrayShape<T, TSerializable, 'result'> - : T extends TSerializable - ? T - : unknown extends SerializerExtensions['ReadableStream'] - ? { [K in keyof T]: ValidateSerializableResult<T[K], TSerializable> } - : T extends SerializerExtensions['ReadableStream'] - ? ReadableStream - : { [K in keyof T]: ValidateSerializableResult<T[K], TSerializable> } - export type RegisteredSSROption<TRegister> = unknown extends RegisteredConfigType<TRegister, 'defaultSsr'> ? SSROption @@ -282,31 +295,13 @@ export type ValidateSerializableLifecycleResultSSR< ? any : ValidateSerializableInput<TRegister, LooseReturnType<TFn>> -type ResolveArrayShape< - T extends ReadonlyArray<unknown>, - TSerializable, - TMode extends 'input' | 'result', -> = number extends T['length'] - ? T extends Array<infer U> - ? Array<ArrayModeResult<TMode, U, TSerializable>> - : ReadonlyArray<ArrayModeResult<TMode, T[number], TSerializable>> - : ResolveTupleShape<T, TSerializable, TMode> +export type RegisteredReadableStream = + unknown extends SerializerExtensions['ReadableStream'] + ? never + : SerializerExtensions['ReadableStream'] -type ResolveTupleShape< - T extends ReadonlyArray<unknown>, - TSerializable, - TMode extends 'input' | 'result', -> = T extends readonly [infer THead, ...infer TTail] - ? readonly [ - ArrayModeResult<TMode, THead, TSerializable>, - ...ResolveTupleShape<Readonly<TTail>, TSerializable, TMode>, - ] - : T +export interface DefaultSerializerExtensions { + ReadableStream: unknown +} -type ArrayModeResult< - TMode extends 'input' | 'result', - TValue, - TSerializable, -> = TMode extends 'input' - ? ValidateSerializable<TValue, TSerializable> - : ValidateSerializableResult<TValue, TSerializable> +export interface SerializerExtensions extends DefaultSerializerExtensions {} diff --git a/packages/router-core/src/ssr/server.ts b/packages/router-core/src/ssr/server.ts index 89b6059e6d..df5b838676 100644 --- a/packages/router-core/src/ssr/server.ts +++ b/packages/router-core/src/ssr/server.ts @@ -1,12 +1,24 @@ export { createRequestHandler } from './createRequestHandler' export type { RequestHandler } from './createRequestHandler' -export { defineHandlerCallback } from './handlerCallback' -export type { HandlerCallback } from './handlerCallback' +export { + createSsrStreamResponse, + defineHandlerCallback, + isSsrResponse, + normalizeSsrResponse, + replaceSsrResponse, + stripSsrResponseBody, +} from './handlerCallback' +export type { + HandlerCallback, + HandlerCallbackResult, + SsrResponse, +} from './handlerCallback' export { transformPipeableStreamWithRouter, transformStreamWithRouter, transformReadableStreamWithRouter, } from './transformStreamWithRouter' +export type { TransformStreamWithRouterOptions } from './transformStreamWithRouter' export { attachRouterServerSsrUtils, getNormalizedURL, diff --git a/packages/router-core/src/ssr/ssr-client.ts b/packages/router-core/src/ssr/ssr-client.ts index 678aa869a9..2aa5358ac0 100644 --- a/packages/router-core/src/ssr/ssr-client.ts +++ b/packages/router-core/src/ssr/ssr-client.ts @@ -94,8 +94,12 @@ export async function hydrate(router: AnyRouter): Promise<any> { nonce, } + // Allow the user to handle custom hydration data before matching routes. + // This lets hydration install router config that affects matching, e.g. rewrites. + await router.options.hydrate?.(dehydratedData) + // Hydrate the router state - const matches = router.matchRoutes(router.stores.location.state) + const matches = router.matchRoutes(router.stores.location.get()) // kick off loading the route chunks const routeChunkPromise = Promise.all( @@ -162,16 +166,13 @@ export async function hydrate(router: AnyRouter): Promise<any> { } }) - router.stores.setActiveMatches(matches) - - // Allow the user to handle custom hydration data - await router.options.hydrate?.(dehydratedData) + router.stores.setMatches(matches) // now that all necessary data is hydrated: // 1) fully reconstruct the route context // 2) execute `head()` and `scripts()` for each match - const activeMatches = router.stores.activeMatchesSnapshot.state - const location = router.stores.location.state + const activeMatches = router.stores.matches.get() + const location = router.stores.location.get() await Promise.all( activeMatches.map(async (match) => { try { @@ -258,7 +259,7 @@ export async function hydrate(router: AnyRouter): Promise<any> { // (e.g. preloads, invalidations) don't mistakenly detect a href change // (resolvedLocation defaults to undefined and router.load() is skipped // in the normal SSR hydration path). - router.stores.resolvedLocation.setState(() => router.stores.location.state) + router.stores.resolvedLocation.set(router.stores.location.get()) return routeChunkPromise } @@ -292,13 +293,9 @@ export async function hydrate(router: AnyRouter): Promise<any> { // ensure router is not in status 'pending' anymore // this usually happens in Transitioner but if loading synchronously resolves, // Transitioner won't be rendered while loading so it cannot track the change from loading:true to loading:false - if (router.stores.status.state === 'pending') { - router.batch(() => { - router.stores.status.setState(() => 'idle') - router.stores.resolvedLocation.setState( - () => router.stores.location.state, - ) - }) + if (router.stores.status.get() === 'pending') { + router.stores.status.set('idle') + router.stores.resolvedLocation.set(router.stores.location.get()) } // hide the pending component once the load is finished router.updateMatch(match.id, (prev) => ({ diff --git a/packages/router-core/src/ssr/ssr-server.ts b/packages/router-core/src/ssr/ssr-server.ts index 3fdd8b24bc..31db2f5e41 100644 --- a/packages/router-core/src/ssr/ssr-server.ts +++ b/packages/router-core/src/ssr/ssr-server.ts @@ -1,7 +1,13 @@ import { crossSerializeStream, getCrossReferenceHeader } from 'seroval' import { invariant } from '../invariant' +import { + createInlineCssPlaceholderAsset, + createInlineCssStyleAsset, + getStylesheetHref, +} from '../manifest' import { decodePath } from '../utils' import { createLRUCache } from '../lru-cache' +import { rootRouteId } from '../root' import minifiedTsrBootStrapScript from './tsrScript?script-string' import { GLOBAL_TSR, TSR_SCRIPT_BARRIER_ID } from './constants' import { dehydrateSsrMatchId } from './ssr-match-id' @@ -10,24 +16,15 @@ import { makeSsrSerovalPlugin } from './serializer/transformer' import type { LRUCache } from '../lru-cache' import type { DehydratedMatch, DehydratedRouter } from './types' import type { AnySerializationAdapter } from './serializer/transformer' -import type { AnyRouter } from '../router' +import type { AnyRouter, ServerSsr } from '../router' import type { AnyRouteMatch } from '../Matches' -import type { Manifest, RouterManagedTag } from '../manifest' - -declare module '../router' { - interface ServerSsr { - setRenderFinished: () => void - cleanup: () => void - } - interface RouterEvents { - onInjectedHtml: { - type: 'onInjectedHtml' - } - onSerializationFinished: { - type: 'onSerializationFinished' - } - } -} +import type { + Manifest, + ManifestRoute, + ManifestRouteAssets, + RouterManagedTag, + ServerManifest, +} from '../manifest' const SCOPE_ID = 'tsr' @@ -66,14 +63,15 @@ const INITIAL_SCRIPTS = [ ] class ScriptBuffer { - private router: AnyRouter | undefined + private injectScript: ((script: string) => void) | undefined private _queue: Array<string> private _scriptBarrierLifted = false private _cleanedUp = false - private _pendingMicrotask = false + private _microtaskVersion = 0 + private _pendingMicrotaskVersion = 0 - constructor(router: AnyRouter) { - this.router = router + constructor(injectScript: (script: string) => void) { + this.injectScript = injectScript // Copy INITIAL_SCRIPTS to avoid mutating the shared array this._queue = INITIAL_SCRIPTS.slice() } @@ -81,31 +79,39 @@ class ScriptBuffer { enqueue(script: string) { if (this._cleanedUp) return this._queue.push(script) - // If barrier is lifted, schedule injection (if not already scheduled) - if (this._scriptBarrierLifted && !this._pendingMicrotask) { - this._pendingMicrotask = true - queueMicrotask(() => { - this._pendingMicrotask = false - this.injectBufferedScripts() - }) + if (this._scriptBarrierLifted) { + this.scheduleInjectBufferedScripts() } } liftBarrier() { if (this._scriptBarrierLifted || this._cleanedUp) return this._scriptBarrierLifted = true - if (this._queue.length > 0 && !this._pendingMicrotask) { - this._pendingMicrotask = true - queueMicrotask(() => { - this._pendingMicrotask = false - this.injectBufferedScripts() - }) + if (this._queue.length > 0) { + this.scheduleInjectBufferedScripts() } } + scheduleInjectBufferedScripts() { + if (this._pendingMicrotaskVersion !== 0) return + const pendingVersion = ++this._microtaskVersion + this._pendingMicrotaskVersion = pendingVersion + queueMicrotask(() => { + if (this._pendingMicrotaskVersion !== pendingVersion) return + this._pendingMicrotaskVersion = 0 + this.injectBufferedScripts() + }) + } + + clearPendingMicrotask() { + if (this._pendingMicrotaskVersion === 0) return + this._pendingMicrotaskVersion = 0 + this._microtaskVersion++ + } + /** * Flushes any pending scripts synchronously. - * Call this before emitting onSerializationFinished to ensure all scripts are injected. + * Call this before signaling serialization finished to ensure all scripts are injected. * * IMPORTANT: Only injects if the barrier has been lifted. Before the barrier is lifted, * scripts should remain in the queue so takeBufferedScripts() can retrieve them @@ -113,16 +119,17 @@ class ScriptBuffer { flush() { if (!this._scriptBarrierLifted) return if (this._cleanedUp) return - this._pendingMicrotask = false - const scriptsToInject = this.takeAll() - if (scriptsToInject && this.router?.serverSsr) { - this.router.serverSsr.injectScript(scriptsToInject) - } + this.clearPendingMicrotask() + this.injectBufferedScripts() } takeAll() { - const bufferedScripts = this._queue - this._queue = [] + return this.takeScripts(this._queue.length) + } + + takeScripts(count: number) { + if (count <= 0) return undefined + const bufferedScripts = this._queue.splice(0, count) if (bufferedScripts.length === 0) { return undefined } @@ -134,20 +141,25 @@ class ScriptBuffer { return bufferedScripts.join(';') + ';document.currentScript.remove()' } + hasPending() { + return this._queue.length > 0 + } + injectBufferedScripts() { if (this._cleanedUp) return // Early return if queue is empty (avoids unnecessary takeAll() call) if (this._queue.length === 0) return const scriptsToInject = this.takeAll() - if (scriptsToInject && this.router?.serverSsr) { - this.router.serverSsr.injectScript(scriptsToInject) + if (scriptsToInject) { + this.injectScript?.(scriptsToInject) } } cleanup() { this._cleanedUp = true + this.clearPendingMicrotask() this._queue = [] - this.router = undefined + this.injectScript = undefined } } @@ -155,52 +167,327 @@ const isProd = process.env.NODE_ENV === 'production' type FilteredRoutes = Manifest['routes'] -type ManifestLRU = LRUCache<string, FilteredRoutes> +type PreparedMatchedManifestRoutes = { + routes: FilteredRoutes + hasStrippedRoutes: boolean + inlineCssHrefs?: Array<string> + inlineCss?: string +} + +type ManifestLRU = LRUCache<string, PreparedMatchedManifestRoutes> const MANIFEST_CACHE_SIZE = 100 -const manifestCaches = new WeakMap<Manifest, ManifestLRU>() +const manifestCaches = new WeakMap<ServerManifest, ManifestLRU>() -function getManifestCache(manifest: Manifest): ManifestLRU { +function getManifestCache(manifest: ServerManifest): ManifestLRU { const cache = manifestCaches.get(manifest) if (cache) return cache - const newCache = createLRUCache<string, FilteredRoutes>(MANIFEST_CACHE_SIZE) + const newCache = createLRUCache<string, PreparedMatchedManifestRoutes>( + MANIFEST_CACHE_SIZE, + ) manifestCaches.set(manifest, newCache) return newCache } +function getInlineCssForPreparedRoutes( + manifest: ServerManifest, + preparedRoutes: PreparedMatchedManifestRoutes, +) { + if (preparedRoutes.inlineCss !== undefined) return preparedRoutes.inlineCss + + const styles = manifest.inlineCss?.styles + const hrefs = preparedRoutes.inlineCssHrefs + if (!styles || !hrefs?.length) return undefined + + let css = '' + for (const href of hrefs) { + css += styles[href]! + } + + preparedRoutes.inlineCss = css + return css +} + +function getInlineCssAssetForPreparedRoutes( + manifest: ServerManifest, + preparedRoutes: PreparedMatchedManifestRoutes, +) { + const css = getInlineCssForPreparedRoutes(manifest, preparedRoutes) + + return css === undefined ? undefined : createInlineCssStyleAsset(css) +} + +function getMatchedRoutesCacheKey(matches: Array<AnyRouteMatch>) { + let cacheKey = '' + for (let i = 0; i < matches.length; i++) { + cacheKey += (i === 0 ? '' : '\0') + matches[i]!.routeId + } + return cacheKey +} + +function getPreparedMatchedManifestRoutes( + manifest: ServerManifest, + matches: Array<AnyRouteMatch>, + cacheKey: string, +) { + if (isProd) { + const cached = getManifestCache(manifest).get(cacheKey) + if (cached) { + return cached + } + } + + const preparedRoutes = prepareMatchedManifestRoutes(manifest, matches) + + if (isProd) { + getManifestCache(manifest).set(cacheKey, preparedRoutes) + } + + return preparedRoutes +} + +function prepareMatchedManifestRoutes( + manifest: ServerManifest, + matches: Array<AnyRouteMatch>, +): PreparedMatchedManifestRoutes { + const inlineStyles = manifest.inlineCss?.styles + const routes: FilteredRoutes = {} + + if (!inlineStyles) { + for (const match of matches) { + const route = manifest.routes[match.routeId] + if (route) { + routes[match.routeId] = route + } + } + return { routes, hasStrippedRoutes: false } + } + + const inlineCssHrefs: Array<string> = [] + const seenInlineCssHrefs = new Set<string>() + let hasStrippedRoutes = false + + for (const match of matches) { + const routeId = match.routeId + const route = manifest.routes[routeId] + if (!route) { + continue + } + + const nextRoute = stripInlinedStylesheetAssetsFromRoute( + inlineStyles, + route, + inlineCssHrefs, + seenInlineCssHrefs, + ) + + if (nextRoute !== route) { + hasStrippedRoutes = true + } + routes[routeId] = nextRoute + } + + return { + routes, + hasStrippedRoutes, + ...(inlineCssHrefs.length ? { inlineCssHrefs } : {}), + } +} + +function stripInlinedStylesheetAssetsFromRoute( + inlineStyles: Record<string, string>, + route: ManifestRoute, + inlineCssHrefs: Array<string>, + seenInlineCssHrefs: Set<string>, +): ManifestRoute { + const css = route.css + if (!css) { + return route + } + + if (css.length === 0) { + const nextRoute = { ...route } + delete nextRoute.css + return nextRoute + } + + let cssLinks: typeof css | undefined + for (let i = 0; i < css.length; i++) { + const link = css[i]! + const href = getStylesheetHref(link) + if (inlineStyles[href] === undefined) { + if (cssLinks) { + cssLinks.push(link) + } + continue + } + + if (!seenInlineCssHrefs.has(href)) { + seenInlineCssHrefs.add(href) + inlineCssHrefs.push(href) + } + + if (!cssLinks) { + cssLinks = css.slice(0, i) + } + } + + if (!cssLinks) { + return route + } + + if (cssLinks.length > 0) { + return { ...route, css: cssLinks } + } + + const nextRoute = { ...route } + delete nextRoute.css + return nextRoute +} + +function hasRouteAssets(route: ManifestRoute) { + return !!route.scripts?.length || !!route.css?.length +} + +function hasRequestAssets(assets: ManifestRouteAssets | undefined) { + return !!assets && (!!assets.preloads?.length || hasRouteAssets(assets)) +} + +function mergeRequestAssetsIntoRootRoute( + rootRoute: ManifestRoute | undefined, + requestAssets: ManifestRouteAssets | undefined, +): ManifestRoute { + const preloads = requestAssets?.preloads?.length + ? [...requestAssets.preloads, ...(rootRoute?.preloads ?? [])] + : rootRoute?.preloads + const scripts = requestAssets?.scripts?.length + ? [...requestAssets.scripts, ...(rootRoute?.scripts ?? [])] + : rootRoute?.scripts + const cssLinks = requestAssets?.css?.length + ? [...requestAssets.css, ...(rootRoute?.css ?? [])] + : rootRoute?.css + + return { + ...(rootRoute ?? {}), + ...(preloads?.length ? { preloads } : {}), + ...(scripts?.length ? { scripts } : {}), + ...(cssLinks?.length ? { css: cssLinks } : {}), + } +} + export function attachRouterServerSsrUtils({ router, manifest, + getRequestAssets, }: { router: AnyRouter - manifest: Manifest | undefined + manifest: ServerManifest | undefined + getRequestAssets?: () => ManifestRouteAssets | undefined }) { router.ssr = { - manifest, + get manifest() { + if (!manifest) return manifest + + const requestAssets = getRequestAssets?.() + const matches = router.stores.matches.get() + const hasAssets = hasRequestAssets(requestAssets) + + if (!hasAssets && !manifest.inlineCss) { + return manifest + } + + let inlineCssAsset: Manifest['inlineStyle'] | undefined + let routes = manifest.routes + if (manifest.inlineCss) { + const cacheKey = getMatchedRoutesCacheKey(matches) + const preparedManifest = getPreparedMatchedManifestRoutes( + manifest, + matches, + cacheKey, + ) + inlineCssAsset = getInlineCssAssetForPreparedRoutes( + manifest, + preparedManifest, + ) + if (preparedManifest.hasStrippedRoutes) { + routes = { ...manifest.routes, ...preparedManifest.routes } + } + } + + if (!hasAssets) { + return { + ...(manifest.scriptFormat + ? { scriptFormat: manifest.scriptFormat } + : {}), + ...(inlineCssAsset ? { inlineStyle: inlineCssAsset } : {}), + routes, + } + } + + const rootRoute = routes[rootRouteId] + + // Merge request-scoped assets into root route without mutating cached manifest + return { + ...(manifest.scriptFormat + ? { scriptFormat: manifest.scriptFormat } + : {}), + ...(inlineCssAsset ? { inlineStyle: inlineCssAsset } : {}), + routes: { + ...routes, + [rootRouteId]: mergeRequestAssetsIntoRootRoute( + rootRoute, + requestAssets, + ), + }, + } + }, } let _dehydrated = false let _serializationFinished = false + let streamFastPathReserved = false const renderFinishedListeners: Array<() => void> = [] + const injectedHtmlListeners: Array<() => void> = [] const serializationFinishedListeners: Array<() => void> = [] - const scriptBuffer = new ScriptBuffer(router) + const cleanupListeners: Array<() => void> = [] + let cleanupStarted = false let injectedHtmlBuffer = '' - router.serverSsr = { + const callListeners = (listeners: Array<() => void>, errorPrefix: string) => { + const snapshot = listeners.slice() + for (const l of snapshot) { + try { + l() + } catch (err) { + console.error(`${errorPrefix}:`, err) + } + } + } + + const removeListener = ( + listeners: Array<() => void>, + listener: () => void, + ) => { + const index = listeners.indexOf(listener) + if (index >= 0) listeners.splice(index, 1) + } + + const scriptBuffer = new ScriptBuffer((script) => { + serverSsr.injectScript(script) + }) + + const serverSsr: ServerSsr = { injectHtml: (html: string) => { - if (!html) return + if (!html || cleanupStarted) return // Buffer the HTML so it can be retrieved via takeBufferedHtml() injectedHtmlBuffer += html - // Emit event to notify subscribers that new HTML is available - router.emit({ - type: 'onInjectedHtml', - }) + callListeners(injectedHtmlListeners, 'SSR injected HTML listener error') }, injectScript: (script: string) => { - if (!script) return + if (!script || cleanupStarted) return const html = `<script${router.options.ssr?.nonce ? ` nonce='${router.options.ssr.nonce}'` : ''}>${script}</script>` - router.serverSsr!.injectHtml(html) + serverSsr.injectHtml(html) }, - dehydrate: async () => { + dehydrate: async (opts?: { requestAssets?: ManifestRouteAssets }) => { if (_dehydrated) { if (process.env.NODE_ENV !== 'production') { throw new Error('Invariant failed: router is already dehydrated!') @@ -208,7 +495,7 @@ export function attachRouterServerSsrUtils({ invariant() } - let matchesToDehydrate = router.stores.activeMatchesSnapshot.state + let matchesToDehydrate = router.stores.matches.get() if (router.isShell()) { // In SPA mode we only want to dehydrate the root match matchesToDehydrate = matchesToDehydrate.slice(0, 1) @@ -216,46 +503,37 @@ export function attachRouterServerSsrUtils({ const matches = matchesToDehydrate.map(dehydrateMatch) let manifestToDehydrate: Manifest | undefined = undefined - // For currently matched routes, send full manifest (preloads + assets) - // For all other routes, only send assets (no preloads as they are handled via dynamic imports) + // Only currently matched routes are dehydrated. Other route assets are + // loaded through dynamic imports when those routes become active. if (manifest) { - // Prod-only caching; in dev manifests may be replaced/updated (HMR) - const currentRouteIdsList = matchesToDehydrate.map((m) => m.routeId) - const manifestCacheKey = currentRouteIdsList.join('\0') - - let filteredRoutes: FilteredRoutes | undefined - - if (isProd) { - filteredRoutes = getManifestCache(manifest).get(manifestCacheKey) - } - - if (!filteredRoutes) { - const currentRouteIds = new Set(currentRouteIdsList) - const nextFilteredRoutes: FilteredRoutes = {} - - for (const routeId in manifest.routes) { - const routeManifest = manifest.routes[routeId]! - if (currentRouteIds.has(routeId)) { - nextFilteredRoutes[routeId] = routeManifest - } else if ( - routeManifest.assets && - routeManifest.assets.length > 0 - ) { - nextFilteredRoutes[routeId] = { - assets: routeManifest.assets, - } - } - } - - if (isProd) { - getManifestCache(manifest).set(manifestCacheKey, nextFilteredRoutes) - } - - filteredRoutes = nextFilteredRoutes - } + const cacheKey = getMatchedRoutesCacheKey(matchesToDehydrate) + const preparedManifest = getPreparedMatchedManifestRoutes( + manifest, + matchesToDehydrate, + cacheKey, + ) manifestToDehydrate = { - routes: filteredRoutes, + ...(manifest.scriptFormat + ? { scriptFormat: manifest.scriptFormat } + : {}), + ...(preparedManifest.inlineCssHrefs + ? { inlineStyle: createInlineCssPlaceholderAsset() } + : {}), + routes: preparedManifest.routes, + } + + // Merge request-scoped assets into root route (without mutating cached manifest) + const requestAssets = opts?.requestAssets + if (hasRequestAssets(requestAssets)) { + const existingRoot = manifestToDehydrate.routes[rootRouteId] + manifestToDehydrate.routes = { + ...manifestToDehydrate.routes, + [rootRouteId]: mergeRequestAssetsIntoRootRoute( + existingRoot, + requestAssets, + ), + } } } const dehydratedRouter: DehydratedRouter = { @@ -282,19 +560,34 @@ export function attachRouterServerSsrUtils({ .concat(defaultSerovalPlugins) : defaultSerovalPlugins + let serializationCompleteSignaled = false const signalSerializationComplete = () => { + if (serializationCompleteSignaled || cleanupStarted) return + serializationCompleteSignaled = true _serializationFinished = true - try { - serializationFinishedListeners.forEach((l) => l()) - router.emit({ type: 'onSerializationFinished' }) - } catch (err) { - console.error('Serialization listener error:', err) - } finally { - serializationFinishedListeners.length = 0 - renderFinishedListeners.length = 0 + + const listeners = serializationFinishedListeners.slice() + serializationFinishedListeners.length = 0 + + for (const l of listeners) { + try { + l() + } catch (err) { + console.error('Serialization listener error:', err) + } } } + const finishScriptSerialization = () => { + if (serializationCompleteSignaled || cleanupStarted) return + scriptBuffer.enqueue(GLOBAL_TSR + '.e()') + // Must synchronously notify injected HTML listeners before signaling + // completion; otherwise the held </body> tail could flush ahead of the + // end script. + scriptBuffer.flush() + signalSerializationComplete() + } + crossSerializeStream(dehydratedRouter, { refs: new Map(), plugins, @@ -305,17 +598,16 @@ export function attachRouterServerSsrUtils({ } scriptBuffer.enqueue(serialized) }, + onError: (err: unknown) => { + console.error('Serialization error:', err) + if (err && (err as any).stack) { + console.error((err as any).stack) + } + finishScriptSerialization() + }, scopeId: SCOPE_ID, onDone: () => { - scriptBuffer.enqueue(GLOBAL_TSR + '.e()') - // Flush all pending scripts synchronously before signaling completion - // This ensures all scripts are injected before onSerializationFinished is emitted - scriptBuffer.flush() - signalSerializationComplete() - }, - onError: (err) => { - console.error('Serialization error:', err) - signalSerializationComplete() + finishScriptSerialization() }, }) }, @@ -325,23 +617,65 @@ export function attachRouterServerSsrUtils({ isSerializationFinished() { return _serializationFinished }, - onRenderFinished: (listener) => renderFinishedListeners.push(listener), - onSerializationFinished: (listener) => - serializationFinishedListeners.push(listener), - setRenderFinished: () => { - // Wrap in try-catch to ensure scriptBuffer.liftBarrier() is always called - try { - renderFinishedListeners.forEach((l) => l()) - } catch (err) { - console.error('Error in render finished listener:', err) - } finally { - // Clear listeners after calling them to prevent memory leaks - renderFinishedListeners.length = 0 + reserveStreamFastPath() { + if ( + !cleanupStarted && + _serializationFinished && + !streamFastPathReserved && + renderFinishedListeners.length === 0 && + !injectedHtmlBuffer && + !scriptBuffer.hasPending() + ) { + streamFastPathReserved = true + return true } + return false + }, + onInjectedHtml: (listener) => { + if (cleanupStarted) return () => {} + injectedHtmlListeners.push(listener) + return () => removeListener(injectedHtmlListeners, listener) + }, + onRenderFinished: (listener) => { + if (cleanupStarted || streamFastPathReserved) return + renderFinishedListeners.push(listener) + }, + onSerializationFinished: (listener) => { + if (cleanupStarted) return () => {} + if (_serializationFinished && !cleanupStarted) { + try { + listener() + } catch (err) { + console.error('Serialization listener error:', err) + } + return () => {} + } + serializationFinishedListeners.push(listener) + return () => removeListener(serializationFinishedListeners, listener) + }, + onCleanup: (listener) => { + if (cleanupStarted) return + cleanupListeners.push(listener) + }, + setRenderFinished: () => { + if (cleanupStarted) return scriptBuffer.liftBarrier() + const listeners = renderFinishedListeners.slice() + renderFinishedListeners.length = 0 + for (const l of listeners) { + try { + l() + } catch (err) { + console.error('Error in render finished listener:', err) + } + } + if (_serializationFinished) { + scriptBuffer.flush() + } }, takeBufferedScripts() { const scripts = scriptBuffer.takeAll() + if (!scripts) return undefined const serverBufferedScript: RouterManagedTag = { tag: 'script', attrs: { @@ -365,15 +699,37 @@ export function attachRouterServerSsrUtils({ return buffered }, cleanup() { - // Guard against multiple cleanup calls - if (!router.serverSsr) return + // Guard against multiple/reentrant cleanup calls. A listener could call + // cleanup() again indirectly; snapshot + clear before invoking so each + // listener runs exactly once and reentry is a no-op. + if (cleanupStarted) return + cleanupStarted = true + const listeners = cleanupListeners.slice() + cleanupListeners.length = 0 + for (const l of listeners) { + try { + l() + } catch (err) { + console.error('Error in SSR cleanup listener:', err) + } + } renderFinishedListeners.length = 0 + injectedHtmlListeners.length = 0 serializationFinishedListeners.length = 0 injectedHtmlBuffer = '' scriptBuffer.cleanup() router.serverSsr = undefined }, } + + router.serverSsr = serverSsr + for (const listener of router.serverSsrLifecycle?.onServerSsrAttach ?? []) { + try { + listener(serverSsr) + } catch (err) { + console.error('SSR attach listener error:', err) + } + } } /** diff --git a/packages/router-core/src/ssr/transformStreamWithRouter.ts b/packages/router-core/src/ssr/transformStreamWithRouter.ts index a96f2fa63d..4393f955b3 100644 --- a/packages/router-core/src/ssr/transformStreamWithRouter.ts +++ b/packages/router-core/src/ssr/transformStreamWithRouter.ts @@ -3,264 +3,492 @@ import { Readable } from 'node:stream' import { TSR_SCRIPT_BARRIER_ID } from './constants' import type { AnyRouter } from '../router' +export type TransformStreamWithRouterOptions = { + /** Timeout for serialization to complete after app render finishes (default: 60000ms) */ + timeoutMs?: number + /** Maximum lifetime of the stream transform (default: 120000ms). Safety net for cleanup. */ + lifetimeMs?: number + /** + * Called exactly once when the stream is torn down due to abort/error/ + * cancel/timeout — NOT on natural successful completion. Use this to + * abort a hidden producer upstream of any PassThrough you passed in + * (e.g. React `renderToPipeableStream`'s `abort()`). + * Errors thrown from this callback are swallowed. + */ + onAbort?: (reason?: unknown) => void +} + export function transformReadableStreamWithRouter( router: AnyRouter, routerStream: ReadableStream, + opts?: TransformStreamWithRouterOptions, ) { - return transformStreamWithRouter(router, routerStream) + return transformStreamWithRouter(router, routerStream, opts) } export function transformPipeableStreamWithRouter( router: AnyRouter, routerStream: Readable, + opts?: TransformStreamWithRouterOptions, ) { return Readable.fromWeb( - transformStreamWithRouter(router, Readable.toWeb(routerStream)), + transformStreamWithRouter(router, Readable.toWeb(routerStream), opts), ) } -// Use string constants for simple indexOf matching -const BODY_END_TAG = '</body>' -const HTML_END_TAG = '</html>' - // Minimum length of a valid closing tag: </a> = 4 characters const MIN_CLOSING_TAG_LENGTH = 4 // Default timeout values (in milliseconds) const DEFAULT_SERIALIZATION_TIMEOUT_MS = 60000 -const DEFAULT_LIFETIME_TIMEOUT_MS = 60000 +const DEFAULT_LIFETIME_TIMEOUT_MS = DEFAULT_SERIALIZATION_TIMEOUT_MS * 2 +const MAX_LEFTOVER_CHARS = 2048 +const MAX_TAIL_CHARS = 64 * 1024 +const MAX_ROUTER_HTML_CHARS = 16 * 1024 * 1024 +const MAX_PENDING_WRITE_CHARS = 16 * 1024 * 1024 + +// Merge lifecycle: body bytes can stream, router HTML must precede tail, +// terminal states own close/error/cleanup exactly once. +const MergeState = { + ReadingBody: 0, + HoldingTail: 1, + AppDone: 2, + Draining: 3, + Done: 4, +} as const + +type MergeState = (typeof MergeState)[keyof typeof MergeState] // Module-level encoder (stateless, safe to reuse) const textEncoder = new TextEncoder() -/** - * Finds the position just after the last valid HTML closing tag in the string. - * - * Valid closing tags match the pattern: </[a-zA-Z][\w:.-]*> - * Examples: </div>, </my-component>, </slot:name.nested> - * - * @returns Position after the last closing tag, or -1 if none found - */ -function findLastClosingTagEnd(str: string): number { - const len = str.length - if (len < MIN_CLOSING_TAG_LENGTH) return -1 +const noop = () => {} +const resolvedPromise = Promise.resolve() - let i = len - 1 +// Returns -bodyEndIndex - 2 when </body> is found; otherwise returns +// the position after the last valid closing tag, or -1 when none exists. +function findHtmlBoundary(str: string): number { + let lastClosingTagEnd = -1 + let searchFrom = str.length - MIN_CLOSING_TAG_LENGTH - while (i >= MIN_CLOSING_TAG_LENGTH - 1) { - // Look for > (charCode 62) - if (str.charCodeAt(i) === 62) { - // Look backwards for valid tag name characters - let j = i - 1 + while (searchFrom >= 0) { + const openSlash = str.lastIndexOf('</', searchFrom) + if (openSlash === -1) break - // Skip through valid tag name characters - while (j >= 1) { - const code = str.charCodeAt(j) - // Check if it's a valid tag name char: [a-zA-Z0-9_:.-] - if ( - (code >= 97 && code <= 122) || // a-z - (code >= 65 && code <= 90) || // A-Z - (code >= 48 && code <= 57) || // 0-9 - code === 95 || // _ - code === 58 || // : - code === 46 || // . - code === 45 // - - ) { - j-- - } else { - break - } - } + // Fast case-insensitive match for </body>. Negative return encodes the + // body start index without allocating a result object. + if ( + (str.charCodeAt(openSlash + 2) | 32) === 98 && + (str.charCodeAt(openSlash + 3) | 32) === 111 && + (str.charCodeAt(openSlash + 4) | 32) === 100 && + (str.charCodeAt(openSlash + 5) | 32) === 121 && + str.charCodeAt(openSlash + 6) === 62 + ) { + return -openSlash - 2 + } - // Check if the first char after </ is a valid start char (letter only) - const tagNameStart = j + 1 - if (tagNameStart < i) { - const startCode = str.charCodeAt(tagNameStart) - // Tag name must start with a letter (a-z or A-Z) - if ( - (startCode >= 97 && startCode <= 122) || - (startCode >= 65 && startCode <= 90) - ) { - // Check for </ (charCodes: < = 60, / = 47) + if (lastClosingTagEnd === -1) { + let i = openSlash + 2 + const startCode = str.charCodeAt(i) + if ( + (startCode >= 97 && startCode <= 122) || + (startCode >= 65 && startCode <= 90) + ) { + i++ + while (i < str.length) { + const code = str.charCodeAt(i) if ( - j >= 1 && - str.charCodeAt(j) === 47 && - str.charCodeAt(j - 1) === 60 + (code >= 97 && code <= 122) || // a-z + (code >= 65 && code <= 90) || // A-Z + (code >= 48 && code <= 57) || // 0-9 + code === 95 || // _ + code === 58 || // : + code === 46 || // . + code === 45 // - ) { - return i + 1 // Return position after the closing > + i++ + } else { + break } } + + if (str.charCodeAt(i) === 62) { + lastClosingTagEnd = i + 1 + } } } - i-- + + searchFrom = openSlash - 1 + } + + return lastClosingTagEnd +} + +/** + * Releasing the lock can throw if a pending read is still settling or if the + * lock was already released. + */ +type ReaderOps = { + cancel: (reason?: unknown) => Promise<unknown> + releaseLock: () => void +} + +function safeReleaseReader(reader: ReaderOps) { + try { + reader.releaseLock() + return true + } catch { + return false + } +} + +/** + * Cancel a reader without producing an unhandled rejection. `reader.cancel()` + * can reject (e.g. when the underlying source's cancel() throws), and + * downstream cancel() should still wait for upstream teardown when possible. + */ +function safeCancelReader(reader: ReaderOps, reason?: unknown): Promise<void> { + let cancelPromise: Promise<unknown> | undefined + try { + cancelPromise = reader.cancel(reason) + } catch { + // ignore + } + + if (!safeReleaseReader(reader) && cancelPromise) { + return cancelPromise.then(noop, noop).then(() => { + safeReleaseReader(reader) + }) + } + + return cancelPromise ? cancelPromise.then(noop, noop) : resolvedPromise +} + +function createReaderState<T>(appStream: ReadableStream<T>) { + const reader = appStream.getReader() + let released = false + + return { + reader, + cancel: (reason?: unknown) => { + if (released) return resolvedPromise + released = true + return safeCancelReader(reader, reason) + }, + release: () => { + if (released) return + released = true + safeReleaseReader(reader) + }, + } +} + +function createAbortNotifier(opts?: TransformStreamWithRouterOptions) { + let abortNotified = false + return (reason?: unknown) => { + if (abortNotified) return + abortNotified = true + try { + opts?.onAbort?.(reason) + } catch { + // swallow user errors + } } - return -1 } export function transformStreamWithRouter( router: AnyRouter, appStream: ReadableStream, - opts?: { - /** Timeout for serialization to complete after app render finishes (default: 60000ms) */ - timeoutMs?: number - /** Maximum lifetime of the stream transform (default: 60000ms). Safety net for cleanup. */ - lifetimeMs?: number - }, + opts?: TransformStreamWithRouterOptions, ) { - // Check upfront if serialization already finished synchronously - // This is the fast path for routes with no deferred data - const serializationAlreadyFinished = - router.serverSsr?.isSerializationFinished() ?? false + const serverSsr = router.serverSsr + if (!serverSsr) { + throw new Error('Invariant failed: router.serverSsr is required') + } + if (serverSsr.reserveStreamFastPath()) { + return makeFastPathStream(appStream, opts, serverSsr) + } - // Take any HTML that was buffered before we started listening - const initialBufferedHtml = router.serverSsr?.takeBufferedHtml() + return makeMainStream(serverSsr, appStream, opts) +} - // True passthrough: if serialization already finished and nothing buffered, - // we can avoid any decoding/scanning while still honoring cleanup + setRenderFinished. - if (serializationAlreadyFinished && !initialBufferedHtml) { - let cleanedUp = false - let controller: ReadableStreamDefaultController<Uint8Array> | undefined - let isStreamClosed = false - let lifetimeTimeoutHandle: ReturnType<typeof setTimeout> | undefined +// ===================================================================== +// Fast path: passthrough with cleanup + backpressure on app reads. +// ===================================================================== +function makeFastPathStream( + appStream: ReadableStream<Uint8Array>, + opts?: TransformStreamWithRouterOptions, + serverSsr?: NonNullable<AnyRouter['serverSsr']>, +) { + let cleanedUp = false + let controller: ReadableStreamDefaultController<Uint8Array> | undefined + let state: MergeState = MergeState.ReadingBody + let lifetimeTimeoutHandle: ReturnType<typeof setTimeout> | undefined + let stopListeningToInjectedHtml: (() => void) | undefined + const readerState = createReaderState(appStream) + const notifyAbort = createAbortNotifier(opts) + const isDone = () => state === MergeState.Done + let renderFinished = false - const cleanup = () => { - if (cleanedUp) return - cleanedUp = true - - if (lifetimeTimeoutHandle !== undefined) { - clearTimeout(lifetimeTimeoutHandle) - lifetimeTimeoutHandle = undefined - } - - router.serverSsr?.cleanup() + const finishSsrRendering = () => { + if (!serverSsr || renderFinished) return true + renderFinished = true + try { + serverSsr.setRenderFinished() + return true + } catch (error) { + safeError(error) + cleanup(error) + return false } + } - const safeClose = () => { - if (isStreamClosed) return - isStreamClosed = true + const cleanup = (reason?: unknown, cancelReader = true) => { + if (cleanedUp) return resolvedPromise + cleanedUp = true + + if (lifetimeTimeoutHandle !== undefined) { + clearTimeout(lifetimeTimeoutHandle) + lifetimeTimeoutHandle = undefined + } + try { + stopListeningToInjectedHtml?.() + } catch { + // ignore + } + stopListeningToInjectedHtml = undefined + + if (cancelReader) { + // Notify the producer immediately. Reader cancellation may take time to + // settle, and upstream renderers must tolerate abort + cancel overlap. + notifyAbort(reason) + } + const readerDone = cancelReader + ? readerState.cancel(reason) + : (readerState.release(), resolvedPromise) + if (serverSsr) { try { - controller?.close() - } catch { - // ignore + serverSsr.cleanup() + } catch (error) { + console.error('Error in SSR cleanup:', error) } } + return readerDone + } - const safeError = (error: unknown) => { - if (isStreamClosed) return - isStreamClosed = true - try { - controller?.error(error) - } catch { - // ignore - } + const safeClose = () => { + if (isDone()) return + state = MergeState.Done + try { + controller?.close() + } catch { + // ignore } + } - const lifetimeMs = opts?.lifetimeMs ?? DEFAULT_LIFETIME_TIMEOUT_MS - lifetimeTimeoutHandle = setTimeout(() => { - if (!cleanedUp && !isStreamClosed) { - console.warn( - `SSR stream transform exceeded maximum lifetime (${lifetimeMs}ms), forcing cleanup`, - ) - safeError(new Error('Stream lifetime exceeded')) - cleanup() - } - }, lifetimeMs) + const safeError = (error: unknown) => { + if (isDone()) return + state = MergeState.Done + try { + controller?.error(error) + } catch { + // ignore + } + } - const stream = new ReadableStream<Uint8Array>({ - start(c: ReadableStreamDefaultController<Uint8Array>) { - controller = c - }, - cancel() { - isStreamClosed = true - cleanup() - }, + if (serverSsr) { + stopListeningToInjectedHtml = serverSsr.onInjectedHtml(() => { + const err = new Error('SSR router HTML injected during fast path') + safeError(err) + cleanup(err) }) + } - ;(async () => { - const reader = appStream.getReader() + const lifetimeMs = opts?.lifetimeMs ?? DEFAULT_LIFETIME_TIMEOUT_MS + lifetimeTimeoutHandle = setTimeout(() => { + if (!cleanedUp && !isDone()) { + const err = new Error('Stream lifetime exceeded') + console.warn( + `SSR stream transform exceeded maximum lifetime (${lifetimeMs}ms), forcing cleanup`, + ) + safeError(err) + cleanup(err) + } + }, lifetimeMs) + + const stream = new ReadableStream<Uint8Array>({ + start(c) { + controller = c + }, + async pull(c) { + if (cleanedUp || isDone()) return try { - while (true) { - const { done, value } = await reader.read() - if (done) break - if (cleanedUp || isStreamClosed) return - controller?.enqueue(value as unknown as Uint8Array) + const { done, value } = await readerState.reader.read() + if (!done) { + if (!cleanedUp && !isDone()) { + c.enqueue(value) + } + return } - if (cleanedUp || isStreamClosed) return + if (cleanedUp || isDone()) return - router.serverSsr?.setRenderFinished() + if (!finishSsrRendering()) return safeClose() - cleanup() + return cleanup(undefined, false) } catch (error) { if (cleanedUp) return console.error('Error reading appStream:', error) - router.serverSsr?.setRenderFinished() + if (state < MergeState.AppDone) { + try { + serverSsr?.setRenderFinished() + } catch { + // ignore + } + } safeError(error) - cleanup() + return cleanup(error) } finally { - reader.releaseLock() + if (cleanedUp || isDone()) { + readerState.release() + } } - })().catch((error) => { - if (cleanedUp) return - console.error('Error in stream transform:', error) - safeError(error) - cleanup() - }) + }, + cancel(reason) { + state = MergeState.Done + return cleanup(reason) + }, + }) - return stream - } + return stream +} +// ===================================================================== +// Main path: scan + inject router HTML/scripts with full backpressure. +// +// ALL output (app chunks AND router-injected HTML/scripts) flows through a +// single pendingWrites queue and is only enqueued onto the downstream +// controller when desiredSize > 0. This prevents native-memory growth of +// queued Uint8Arrays under slow HTTP consumers. +// ===================================================================== +function makeMainStream( + serverSsr: NonNullable<AnyRouter['serverSsr']>, + appStream: ReadableStream, + opts?: TransformStreamWithRouterOptions, +) { let stopListeningToInjectedHtml: (() => void) | undefined let stopListeningToSerializationFinished: (() => void) | undefined let serializationTimeoutHandle: ReturnType<typeof setTimeout> | undefined let lifetimeTimeoutHandle: ReturnType<typeof setTimeout> | undefined let cleanedUp = false - let controller: ReadableStreamDefaultController<any> - let isStreamClosed = false + let controller: ReadableStreamDefaultController<Uint8Array> | undefined + let closeWhenDrained = false + let state: MergeState = MergeState.ReadingBody - const textDecoder = new TextDecoder() + const readerState = createReaderState(appStream) + const notifyAbort = createAbortNotifier(opts) - // concat'd router HTML; avoids array joins on each flush - let pendingRouterHtml = initialBufferedHtml ?? '' + // Single output queue: app chunks + router-injected HTML/scripts. + // Stored as STRINGS to avoid holding native-backed Uint8Arrays in our queue + // while waiting for downstream capacity. Encoding happens at enqueue time + // (drainPending) so the bytes live only inside the controller's internal + // queue, not in two places. + // + // Uses an index pointer instead of Array.prototype.shift() (which is O(n)) + // so many small router-injected script chunks stay O(1) per chunk. + const pendingWrites: Array<string> = [] + let pendingWriteHead = 0 + let pendingWriteChars = 0 - // between-chunk text buffer; keep bounded to avoid unbounded memory - let leftover = '' + function clearPending() { + pendingWrites.length = 0 + pendingWriteHead = 0 + pendingWriteChars = 0 + } - // captured closing tags from </body> onward - let pendingClosingTags = '' - - // conservative cap: enough to hold any partial closing tag + a bit - const MAX_LEFTOVER_CHARS = 2048 - - let isAppRendering = true - let streamBarrierLifted = false - let serializationFinished = serializationAlreadyFinished - - function safeEnqueue(chunk: string | Uint8Array) { - if (isStreamClosed) return - if (typeof chunk === 'string') { - controller.enqueue(textEncoder.encode(chunk)) - } else { - controller.enqueue(chunk) + // Backpressure: pull() resolves drainResolve to let the read loop advance. + let drainResolve: (() => void) | null = null + const waitForDrain = () => + new Promise<void>((r) => { + drainResolve = r + }) + const signalDrain = () => { + if (drainResolve) { + const r = drainResolve + drainResolve = null + r() } } + const isDone = () => state === MergeState.Done + + function drainPending() { + if (!controller || isDone()) return + while (pendingWriteHead < pendingWrites.length) { + const ds = controller.desiredSize + if (ds !== null && ds <= 0) return + const next = pendingWrites[pendingWriteHead]! + // Release reference for GC; compact when fully drained. + pendingWrites[pendingWriteHead] = '' + pendingWriteHead++ + pendingWriteChars -= next.length + try { + controller.enqueue(textEncoder.encode(next)) + } catch (error) { + safeError(error) + cleanup(error) + return + } + } + // Fully drained: reset array so it doesn't grow unbounded across SSR. + if (pendingWriteHead >= pendingWrites.length) { + pendingWrites.length = 0 + pendingWriteHead = 0 + } + // If we've flushed everything and tryFinish requested close, close now. + if (closeWhenDrained && pendingWriteHead >= pendingWrites.length) { + closeWhenDrained = false + safeClose() + cleanup(undefined, false) + } + } + + /** + * Enqueue a string chunk through the backpressure queue. Stored as a + * string and encoded only when the downstream actually accepts the chunk + * — keeps native-memory pressure inside the controller's queue (which + * honors desiredSize) rather than ours. + */ + function writeChunk(chunk: string) { + if (cleanedUp || isDone()) return + if (!chunk.length) return + if (pendingWriteChars + chunk.length > MAX_PENDING_WRITE_CHARS) { + const err = new Error('SSR stream pending output exceeded maximum buffer') + safeError(err) + cleanup(err) + return + } + pendingWrites.push(chunk) + pendingWriteChars += chunk.length + drainPending() + } + function safeClose() { - if (isStreamClosed) return - isStreamClosed = true + if (isDone()) return + state = MergeState.Done try { - controller.close() + controller?.close() } catch { // ignore } } function safeError(error: unknown) { - if (isStreamClosed) return - isStreamClosed = true + if (isDone()) return + state = MergeState.Done try { - controller.error(error) + controller?.error(error) } catch { // ignore } @@ -269,8 +497,8 @@ export function transformStreamWithRouter( /** * Cleanup with guards; must be idempotent. */ - function cleanup() { - if (cleanedUp) return + function cleanup(reason?: unknown, cancelReader = true) { + if (cleanedUp) return resolvedPromise cleanedUp = true try { @@ -291,152 +519,317 @@ export function transformStreamWithRouter( lifetimeTimeoutHandle = undefined } - pendingRouterHtml = '' + clearPendingRouterHtml() leftover = '' - pendingClosingTags = '' + pendingTail = '' + clearPending() - router.serverSsr?.cleanup() + if (cancelReader) { + // Notify the producer immediately. Reader cancellation may take time to + // settle, and upstream renderers must tolerate abort + cancel overlap. + notifyAbort(reason) + } + const readerDone = cancelReader + ? readerState.cancel(reason) + : (readerState.release(), resolvedPromise) + signalDrain() + try { + serverSsr.cleanup() + } catch (error) { + console.error('Error in SSR cleanup:', error) + } + return readerDone } - const stream = new ReadableStream({ - start(c: ReadableStreamDefaultController<any>) { + const textDecoder = new TextDecoder() + + // Router-injected scripts/HTML waiting for the next safe body boundary. + // Keep chunks separate so flushing does not flatten a large rope string. + const pendingRouterHtml: Array<string> = [] + let pendingRouterHtmlChars = 0 + + // between-chunk text buffer; keep bounded to avoid unbounded memory + let leftover = '' + + // captured bytes from </body> onward; must stay behind router scripts. + let pendingTail = '' + + let streamBarrierLifted = false + let streamBarrierMarkerSeen = false + let serializationFinished = false + + function noteBarrierMarker(chunk: string) { + if (streamBarrierMarkerSeen) return + if (chunk.includes(TSR_SCRIPT_BARRIER_ID)) { + streamBarrierMarkerSeen = true + } + } + + function liftBarrierAfterBoundary() { + if (streamBarrierLifted) return + if (!streamBarrierMarkerSeen) return + streamBarrierLifted = true + serverSsr.liftScriptBarrier() + } + + const stream = new ReadableStream<Uint8Array>({ + start(c) { controller = c + // If anything queued before start (shouldn't happen but be safe), drain. + drainPending() }, - cancel() { - isStreamClosed = true - cleanup() + pull() { + // Consumer has capacity; flush queue then unblock read loop. + drainPending() + signalDrain() + }, + cancel(reason) { + state = MergeState.Done + return cleanup(reason) }, }) - function flushPendingRouterHtml() { - if (!pendingRouterHtml) return - safeEnqueue(pendingRouterHtml) - pendingRouterHtml = '' + function drainRouterHtml() { + if (cleanedUp || isDone()) return + let html: string | undefined + try { + html = serverSsr.takeBufferedHtml() + } catch (error) { + safeError(error) + cleanup(error) + return + } + if (!html) return + if (state >= MergeState.Draining) { + // At this point final tail/close has already been queued. Emitting late + // router HTML would put scripts after </body> or drop them silently. + const err = new Error( + 'SSR router HTML injected after stream finalization', + ) + safeError(err) + cleanup(err) + return + } + if (state === MergeState.HoldingTail) { + flushPendingRouterHtml() + writeChunk(html) + } else { + if (pendingRouterHtmlChars + html.length > MAX_ROUTER_HTML_CHARS) { + const err = new Error('SSR router HTML exceeded maximum buffer') + safeError(err) + cleanup(err) + return + } + pendingRouterHtml.push(html) + pendingRouterHtmlChars += html.length + } } - function appendRouterHtml(html: string) { - if (!html) return - pendingRouterHtml += html + function flushPendingRouterHtml() { + if (!pendingRouterHtml.length) return + for (const html of pendingRouterHtml) { + writeChunk(html) + } + clearPendingRouterHtml() + } + + function clearPendingRouterHtml() { + pendingRouterHtml.length = 0 + pendingRouterHtmlChars = 0 + } + + function appendTail(chunk: string) { + pendingTail += chunk + if (pendingTail.length > MAX_TAIL_CHARS) { + throw new Error('SSR stream tail exceeded maximum buffer') + } + } + + function waitForBackpressure() { + return !!( + controller && + controller.desiredSize !== null && + controller.desiredSize <= 0 + ) + } + + function startSerializationTimeout() { + if (cleanedUp || isDone()) return + if (serializationTimeoutHandle !== undefined) return + const timeoutMs = opts?.timeoutMs ?? DEFAULT_SERIALIZATION_TIMEOUT_MS + serializationTimeoutHandle = setTimeout(() => { + if (!cleanedUp && !isDone()) { + const err = new Error('Serialization timeout after app render finished') + console.error('Serialization timeout after app render finished') + safeError(err) + cleanup(err) + } + }, timeoutMs) } /** - * Finish only when app done and serialization complete. + * Finish only when app done and serialization complete. Queues final + * output and requests close-when-drained so we don't close ahead of + * pending writes still waiting on downstream capacity. */ function tryFinish() { - if (isAppRendering || !serializationFinished) return - if (cleanedUp || isStreamClosed) return + if (state !== MergeState.AppDone || !serializationFinished) return + if (cleanedUp || isDone()) return if (serializationTimeoutHandle !== undefined) { clearTimeout(serializationTimeoutHandle) serializationTimeoutHandle = undefined } + drainRouterHtml() + if (cleanedUp || isDone()) return + // Flush any remaining bytes in the TextDecoder const decoderRemainder = textDecoder.decode() - if (leftover) safeEnqueue(leftover) - if (decoderRemainder) safeEnqueue(decoderRemainder) + if (leftover) writeChunk(leftover) + if (cleanedUp || isDone()) return + if (decoderRemainder) writeChunk(decoderRemainder) + if (cleanedUp || isDone()) return flushPendingRouterHtml() - if (pendingClosingTags) safeEnqueue(pendingClosingTags) + if (cleanedUp || isDone()) return + if (pendingTail) writeChunk(pendingTail) + if (cleanedUp || isDone()) return - safeClose() - cleanup() + leftover = '' + pendingTail = '' + + state = MergeState.Draining + closeWhenDrained = true + // Try immediately; if queue not drained yet, pull() will retry. + drainPending() + } + + function finishAppRendering() { + if (state >= MergeState.AppDone) return + state = MergeState.AppDone + try { + serverSsr.setRenderFinished() + } catch (error) { + safeError(error) + cleanup(error) + return + } + drainRouterHtml() + if (cleanedUp || isDone()) return + serializationFinished = + serializationFinished || serverSsr.isSerializationFinished() + if (serializationFinished) { + tryFinish() + } else { + startSerializationTimeout() + } } // Safety net: cleanup even if consumer never reads - const lifetimeMs = opts?.lifetimeMs ?? DEFAULT_LIFETIME_TIMEOUT_MS + const timeoutMs = opts?.timeoutMs ?? DEFAULT_SERIALIZATION_TIMEOUT_MS + const lifetimeMs = opts?.lifetimeMs ?? timeoutMs * 2 lifetimeTimeoutHandle = setTimeout(() => { - if (!cleanedUp && !isStreamClosed) { + if (!cleanedUp && !isDone()) { + const err = new Error('Stream lifetime exceeded') console.warn( `SSR stream transform exceeded maximum lifetime (${lifetimeMs}ms), forcing cleanup`, ) - safeError(new Error('Stream lifetime exceeded')) - cleanup() + safeError(err) + cleanup(err) } }, lifetimeMs) - if (!serializationAlreadyFinished) { - stopListeningToInjectedHtml = router.subscribe('onInjectedHtml', () => { - if (cleanedUp || isStreamClosed) return - const html = router.serverSsr?.takeBufferedHtml() - if (!html) return + stopListeningToInjectedHtml = serverSsr.onInjectedHtml(() => { + drainRouterHtml() + }) - // If we've already captured </body> (pendingClosingTags), we must keep appending - // so injection stays before the stored closing tags. - if (isAppRendering || leftover || pendingClosingTags) { - appendRouterHtml(html) - } else { - safeEnqueue(html) - } - }) + stopListeningToSerializationFinished = serverSsr.onSerializationFinished( + () => { + serializationFinished = true + drainRouterHtml() + tryFinish() + }, + ) - stopListeningToSerializationFinished = router.subscribe( - 'onSerializationFinished', - () => { - serializationFinished = true - tryFinish() - }, - ) + // Subscriptions are installed before snapshots, so missed events are + // recovered by these synchronous drains/rechecks. + drainRouterHtml() + if (cleanedUp || isDone()) return stream + serializationFinished = + serializationFinished || serverSsr.isSerializationFinished() + if (serializationFinished) { + drainRouterHtml() + if (cleanedUp || isDone()) return stream } // Transform the appStream ;(async () => { - const reader = appStream.getReader() try { while (true) { - const { done, value } = await reader.read() - if (done) break - - if (cleanedUp || isStreamClosed) return - - const text = - value instanceof Uint8Array - ? textDecoder.decode(value, { stream: true }) - : String(value) - - // Fast path: most chunks have no pending left-over. - const chunkString = leftover ? leftover + text : text - - if (!streamBarrierLifted) { - if (chunkString.includes(TSR_SCRIPT_BARRIER_ID)) { - streamBarrierLifted = true - router.serverSsr?.liftScriptBarrier() - } + // Backpressure: pause upstream reads while downstream is full. + if (waitForBackpressure()) { + await waitForDrain() + if (cleanedUp || isDone()) return } - // If we already saw </body>, everything else is part of tail; buffer it. - if (pendingClosingTags) { - pendingClosingTags += chunkString + const { done, value } = await readerState.reader.read() + if (done) break + + if (cleanedUp || isDone()) return + + const text = + typeof value === 'string' + ? value + : textDecoder.decode(value as ArrayBufferView, { stream: true }) + + const chunkString = leftover ? leftover + text : text + + // If we already saw </body>, everything else is tail. Keep it bounded + // and held until router scripts are ready so injection remains before </body>. + if (state >= MergeState.HoldingTail) { + appendTail(chunkString) leftover = '' continue } - const bodyEndIndex = chunkString.indexOf(BODY_END_TAG) - const htmlEndIndex = chunkString.indexOf(HTML_END_TAG) - - if ( - bodyEndIndex !== -1 && - htmlEndIndex !== -1 && - bodyEndIndex < htmlEndIndex - ) { - pendingClosingTags = chunkString.slice(bodyEndIndex) - safeEnqueue(chunkString.slice(0, bodyEndIndex)) + const boundary = findHtmlBoundary(chunkString) + if (boundary < -1) { + const bodyEndIndex = -boundary - 2 + state = MergeState.HoldingTail + appendTail(chunkString.slice(bodyEndIndex)) + const bodyChunk = chunkString.slice(0, bodyEndIndex) + writeChunk(bodyChunk) + if (cleanedUp || isDone()) return + noteBarrierMarker(bodyChunk) + liftBarrierAfterBoundary() + if (cleanedUp || isDone()) return flushPendingRouterHtml() leftover = '' continue } - const lastClosingTagEnd = findLastClosingTagEnd(chunkString) + const lastClosingTagEnd = boundary if (lastClosingTagEnd > 0) { - safeEnqueue(chunkString.slice(0, lastClosingTagEnd)) + const safeChunk = chunkString.slice(0, lastClosingTagEnd) + writeChunk(safeChunk) + if (cleanedUp || isDone()) return + noteBarrierMarker(safeChunk) + liftBarrierAfterBoundary() + if (cleanedUp || isDone()) return flushPendingRouterHtml() leftover = chunkString.slice(lastClosingTagEnd) if (leftover.length > MAX_LEFTOVER_CHARS) { // Ensure bounded memory even if a consumer streams long text sequences // without any closing tags. This may reduce injection granularity but is correct. - safeEnqueue(leftover.slice(0, leftover.length - MAX_LEFTOVER_CHARS)) + noteBarrierMarker(leftover) + const flushed = leftover.slice( + 0, + leftover.length - MAX_LEFTOVER_CHARS, + ) + writeChunk(flushed) leftover = leftover.slice(-MAX_LEFTOVER_CHARS) } } else { @@ -444,8 +837,10 @@ export function transformStreamWithRouter( // but stream older bytes to prevent unbounded buffering. const combined = chunkString if (combined.length > MAX_LEFTOVER_CHARS) { + noteBarrierMarker(combined) const flushUpto = combined.length - MAX_LEFTOVER_CHARS - safeEnqueue(combined.slice(0, flushUpto)) + const flushed = combined.slice(0, flushUpto) + writeChunk(flushed) leftover = combined.slice(flushUpto) } else { leftover = combined @@ -453,40 +848,29 @@ export function transformStreamWithRouter( } } - if (cleanedUp || isStreamClosed) return + if (cleanedUp || isDone()) return - isAppRendering = false - router.serverSsr?.setRenderFinished() - - if (serializationFinished) { - tryFinish() - } else { - const timeoutMs = opts?.timeoutMs ?? DEFAULT_SERIALIZATION_TIMEOUT_MS - serializationTimeoutHandle = setTimeout(() => { - if (!cleanedUp && !isStreamClosed) { - console.error('Serialization timeout after app render finished') - safeError( - new Error('Serialization timeout after app render finished'), - ) - cleanup() - } - }, timeoutMs) - } + finishAppRendering() } catch (error) { if (cleanedUp) return console.error('Error reading appStream:', error) - isAppRendering = false - router.serverSsr?.setRenderFinished() + if (state < MergeState.AppDone) { + try { + serverSsr.setRenderFinished() + } catch { + // ignore + } + } safeError(error) - cleanup() + cleanup(error) } finally { - reader.releaseLock() + readerState.release() } })().catch((error) => { if (cleanedUp) return console.error('Error in stream transform:', error) safeError(error) - cleanup() + cleanup(error) }) return stream diff --git a/packages/router-core/src/ssr/tsrScript.ts b/packages/router-core/src/ssr/tsrScript.ts index 69c9abe05d..0c4b8f703b 100644 --- a/packages/router-core/src/ssr/tsrScript.ts +++ b/packages/router-core/src/ssr/tsrScript.ts @@ -9,8 +9,17 @@ self.$_TSR = { }, c() { if (this.hydrated && this.streamEnded) { - delete self.$_TSR - delete self.$R['tsr'] + const cleanup = () => { + if (self.$_TSR?.hydrated && self.$_TSR?.streamEnded) { + delete self.$_TSR + delete self.$R['tsr'] + } + } + if (document.readyState === 'loading') { + document.addEventListener('DOMContentLoaded', cleanup, { once: true }) + } else { + cleanup() + } } }, p(script) { diff --git a/packages/router-core/src/stores.ts b/packages/router-core/src/stores.ts index c31bfb4ecb..c2ab8311c3 100644 --- a/packages/router-core/src/stores.ts +++ b/packages/router-core/src/stores.ts @@ -1,5 +1,5 @@ import { createLRUCache } from './lru-cache' -import { arraysEqual } from './utils' +import { arraysEqual, functionalUpdate } from './utils' import type { AnyRoute } from './route' import type { RouterState } from './router' @@ -9,13 +9,13 @@ import type { AnyRedirect } from './redirect' import type { AnyRouteMatch } from './Matches' export interface RouterReadableStore<TValue> { - readonly state: TValue + get: () => TValue } export interface RouterWritableStore< TValue, > extends RouterReadableStore<TValue> { - setState: (updater: (prev: TValue) => TValue) => void + set: ((updater: (prev: TValue) => TValue) => void) & ((value: TValue) => void) } export type RouterBatchFn = (fn: () => void) => void @@ -49,11 +49,11 @@ export function createNonReactiveMutableStore<TValue>( let value = initialValue return { - get state() { + get() { return value }, - setState(updater: (prev: TValue) => TValue) { - value = updater(value) + set(nextOrUpdater: TValue | ((prev: TValue) => TValue)) { + value = functionalUpdate(nextOrUpdater, value) }, } } @@ -63,7 +63,7 @@ export function createNonReactiveReadonlyStore<TValue>( read: () => TValue, ): RouterReadableStore<TValue> { return { - get state() { + get() { return read() }, } @@ -81,24 +81,24 @@ export interface RouterStores<in out TRouteTree extends AnyRoute> { statusCode: RouterWritableStore<number> redirect: RouterWritableStore<AnyRedirect | undefined> matchesId: RouterWritableStore<Array<string>> - pendingMatchesId: RouterWritableStore<Array<string>> + pendingIds: RouterWritableStore<Array<string>> /** @internal */ - cachedMatchesId: RouterWritableStore<Array<string>> - activeMatchesSnapshot: ReadableStore<Array<AnyRouteMatch>> - pendingMatchesSnapshot: ReadableStore<Array<AnyRouteMatch>> - cachedMatchesSnapshot: ReadableStore<Array<AnyRouteMatch>> - firstMatchId: ReadableStore<string | undefined> - hasPendingMatches: ReadableStore<boolean> - matchRouteReactivity: ReadableStore<{ + cachedIds: RouterWritableStore<Array<string>> + matches: ReadableStore<Array<AnyRouteMatch>> + pendingMatches: ReadableStore<Array<AnyRouteMatch>> + cachedMatches: ReadableStore<Array<AnyRouteMatch>> + firstId: ReadableStore<string | undefined> + hasPending: ReadableStore<boolean> + matchRouteDeps: ReadableStore<{ locationHref: string resolvedLocationHref: string | undefined status: RouterState<TRouteTree>['status'] }> __store: RouterReadableStore<RouterState<TRouteTree>> - activeMatchStoresById: Map<string, MatchStore> - pendingMatchStoresById: Map<string, MatchStore> - cachedMatchStoresById: Map<string, MatchStore> + matchStores: Map<string, MatchStore> + pendingMatchStores: Map<string, MatchStore> + cachedMatchStores: Map<string, MatchStore> /** * Get a computed store that resolves a routeId to its current match state. @@ -106,13 +106,13 @@ export interface RouterStores<in out TRouteTree extends AnyRoute> { * The computed depends on matchesId + the individual match store, so * subscribers are only notified when the resolved match state changes. */ - getMatchStoreByRouteId: ( + getRouteMatchStore: ( routeId: string, ) => RouterReadableStore<AnyRouteMatch | undefined> - setActiveMatches: (nextMatches: Array<AnyRouteMatch>) => void - setPendingMatches: (nextMatches: Array<AnyRouteMatch>) => void - setCachedMatches: (nextMatches: Array<AnyRouteMatch>) => void + setMatches: (nextMatches: Array<AnyRouteMatch>) => void + setPending: (nextMatches: Array<AnyRouteMatch>) => void + setCached: (nextMatches: Array<AnyRouteMatch>) => void } export function createRouterStores<TRouteTree extends AnyRoute>( @@ -122,9 +122,9 @@ export function createRouterStores<TRouteTree extends AnyRoute>( const { createMutableStore, createReadonlyStore, batch, init } = config // non reactive utilities - const activeMatchStoresById = new Map<string, MatchStore>() - const pendingMatchStoresById = new Map<string, MatchStore>() - const cachedMatchStoresById = new Map<string, MatchStore>() + const matchStores = new Map<string, MatchStore>() + const pendingMatchStores = new Map<string, MatchStore>() + const cachedMatchStores = new Map<string, MatchStore>() // atoms const status = createMutableStore(initialState.status) @@ -136,43 +136,43 @@ export function createRouterStores<TRouteTree extends AnyRoute>( const statusCode = createMutableStore(initialState.statusCode) const redirect = createMutableStore(initialState.redirect) const matchesId = createMutableStore<Array<string>>([]) - const pendingMatchesId = createMutableStore<Array<string>>([]) - const cachedMatchesId = createMutableStore<Array<string>>([]) + const pendingIds = createMutableStore<Array<string>>([]) + const cachedIds = createMutableStore<Array<string>>([]) // 1st order derived stores - const activeMatchesSnapshot = createReadonlyStore(() => - readPoolMatches(activeMatchStoresById, matchesId.state), + const matches = createReadonlyStore(() => + readPoolMatches(matchStores, matchesId.get()), ) - const pendingMatchesSnapshot = createReadonlyStore(() => - readPoolMatches(pendingMatchStoresById, pendingMatchesId.state), + const pendingMatches = createReadonlyStore(() => + readPoolMatches(pendingMatchStores, pendingIds.get()), ) - const cachedMatchesSnapshot = createReadonlyStore(() => - readPoolMatches(cachedMatchStoresById, cachedMatchesId.state), + const cachedMatches = createReadonlyStore(() => + readPoolMatches(cachedMatchStores, cachedIds.get()), ) - const firstMatchId = createReadonlyStore(() => matchesId.state[0]) - const hasPendingMatches = createReadonlyStore(() => - matchesId.state.some((matchId) => { - const store = activeMatchStoresById.get(matchId) - return store?.state.status === 'pending' + const firstId = createReadonlyStore(() => matchesId.get()[0]) + const hasPending = createReadonlyStore(() => + matchesId.get().some((matchId) => { + const store = matchStores.get(matchId) + return store?.get().status === 'pending' }), ) - const matchRouteReactivity = createReadonlyStore(() => ({ - locationHref: location.state.href, - resolvedLocationHref: resolvedLocation.state?.href, - status: status.state, + const matchRouteDeps = createReadonlyStore(() => ({ + locationHref: location.get().href, + resolvedLocationHref: resolvedLocation.get()?.href, + status: status.get(), })) // compatibility "big" state store const __store = createReadonlyStore(() => ({ - status: status.state, - loadedAt: loadedAt.state, - isLoading: isLoading.state, - isTransitioning: isTransitioning.state, - matches: activeMatchesSnapshot.state, - location: location.state, - resolvedLocation: resolvedLocation.state, - statusCode: statusCode.state, - redirect: redirect.state, + status: status.get(), + loadedAt: loadedAt.get(), + isLoading: isLoading.get(), + isTransitioning: isTransitioning.get(), + matches: matches.get(), + location: location.get(), + resolvedLocation: resolvedLocation.get(), + statusCode: statusCode.get(), + redirect: redirect.get(), })) // Per-routeId computed store cache. @@ -188,21 +188,21 @@ export function createRouterStores<TRouteTree extends AnyRoute>( RouterReadableStore<AnyRouteMatch | undefined> >(64) - function getMatchStoreByRouteId( + function getRouteMatchStore( routeId: string, ): RouterReadableStore<AnyRouteMatch | undefined> { let cached = matchStoreByRouteIdCache.get(routeId) if (!cached) { cached = createReadonlyStore(() => { - // Reading matchesId.state tracks it as a dependency. + // Reading matchesId.get() tracks it as a dependency. // When matchesId changes (navigation), this computed re-evaluates. - const ids = matchesId.state + const ids = matchesId.get() for (const id of ids) { - const matchStore = activeMatchStoresById.get(id) + const matchStore = matchStores.get(id) if (matchStore && matchStore.routeId === routeId) { - // Reading matchStore.state tracks it as a dependency. + // Reading matchStore.get() tracks it as a dependency. // When the match store's state changes, this re-evaluates. - return matchStore.state + return matchStore.get() } } return undefined @@ -223,64 +223,64 @@ export function createRouterStores<TRouteTree extends AnyRoute>( statusCode, redirect, matchesId, - pendingMatchesId, - cachedMatchesId, + pendingIds, + cachedIds, // derived - activeMatchesSnapshot, - pendingMatchesSnapshot, - cachedMatchesSnapshot, - firstMatchId, - hasPendingMatches, - matchRouteReactivity, + matches, + pendingMatches, + cachedMatches, + firstId, + hasPending, + matchRouteDeps, // non-reactive state - activeMatchStoresById, - pendingMatchStoresById, - cachedMatchStoresById, + matchStores, + pendingMatchStores, + cachedMatchStores, // compatibility "big" state __store, // per-key computed stores - getMatchStoreByRouteId, + getRouteMatchStore, // methods - setActiveMatches, - setPendingMatches, - setCachedMatches, + setMatches, + setPending, + setCached, } // initialize the active matches - setActiveMatches(initialState.matches as Array<AnyRouteMatch>) + setMatches(initialState.matches as Array<AnyRouteMatch>) init?.(store) // setters to update non-reactive utilities in sync with the reactive stores - function setActiveMatches(nextMatches: Array<AnyRouteMatch>) { + function setMatches(nextMatches: Array<AnyRouteMatch>) { reconcileMatchPool( nextMatches, - activeMatchStoresById, + matchStores, matchesId, createMutableStore, batch, ) } - function setPendingMatches(nextMatches: Array<AnyRouteMatch>) { + function setPending(nextMatches: Array<AnyRouteMatch>) { reconcileMatchPool( nextMatches, - pendingMatchStoresById, - pendingMatchesId, + pendingMatchStores, + pendingIds, createMutableStore, batch, ) } - function setCachedMatches(nextMatches: Array<AnyRouteMatch>) { + function setCached(nextMatches: Array<AnyRouteMatch>) { reconcileMatchPool( nextMatches, - cachedMatchStoresById, - cachedMatchesId, + cachedMatchStores, + cachedIds, createMutableStore, batch, ) @@ -297,7 +297,7 @@ function readPoolMatches( for (const id of ids) { const matchStore = pool.get(id) if (matchStore) { - matches.push(matchStore.state) + matches.push(matchStore.get()) } } return matches @@ -330,13 +330,13 @@ function reconcileMatchPool( } existing.routeId = nextMatch.routeId - if (existing.state !== nextMatch) { - existing.setState(() => nextMatch) + if (existing.get() !== nextMatch) { + existing.set(nextMatch) } } - if (!arraysEqual(idStore.state, nextIds)) { - idStore.setState(() => nextIds) + if (!arraysEqual(idStore.get(), nextIds)) { + idStore.set(nextIds) } }) } diff --git a/packages/router-core/src/utils.ts b/packages/router-core/src/utils.ts index 3a283e270c..81a3de6a8f 100644 --- a/packages/router-core/src/utils.ts +++ b/packages/router-core/src/utils.ts @@ -215,6 +215,13 @@ export function functionalUpdate<TPrevious, TResult = TPrevious>( const hasOwn = Object.prototype.hasOwnProperty const isEnumerable = Object.prototype.propertyIsEnumerable +export function hasKeys(obj: Record<string, unknown>) { + for (const key in obj) { + if (hasOwn.call(obj, key)) return true + } + return false +} + const createNull = () => Object.create(null) export const nullReplaceEqualDeep: typeof replaceEqualDeep = (prev, next) => replaceEqualDeep(prev, next, createNull) diff --git a/packages/router-core/tests/build-location.test.ts b/packages/router-core/tests/build-location.test.ts index 6aca9b3b6a..8a83e34faf 100644 --- a/packages/router-core/tests/build-location.test.ts +++ b/packages/router-core/tests/build-location.test.ts @@ -1103,6 +1103,211 @@ describe('buildLocation - params edge cases', () => { expect(location.pathname).toBe('/users/000042') }) + test('params.stringify should run for params.parse route templates', async () => { + const rootRoute = new BaseRootRoute({}) + const languageRoute = new BaseRoute({ + getParentRoute: () => rootRoute, + path: '/{$language}', + params: { + parse: ({ language }: { language: string }) => { + if (language === 'en') return { language: 'en-US' as const } + if (language === 'pl') return { language: 'pl-PL' as const } + return false + }, + stringify: ({ language }: { language: 'en-US' | 'pl-PL' }) => { + if (language === 'en-US') return { language: 'en' } + if (language === 'pl-PL') return { language: 'pl' } + return { language } + }, + }, + }) + + const routeTree = rootRoute.addChildren([languageRoute]) + + const router = createTestRouter({ + routeTree, + history: createMemoryHistory({ initialEntries: ['/en'] }), + }) + + await router.load() + + const location = router.buildLocation({ + to: '/{$language}', + params: { language: 'pl-PL' }, + }) + + expect(location.pathname).toBe('/pl') + + const currentRouteLocation = router.buildLocation({ + params: { language: 'pl-PL' }, + } as any) + + expect(currentRouteLocation.pathname).toBe('/pl') + }) + + test('params.stringify should use the exact route template over path matching priority', async () => { + const rootRoute = new BaseRootRoute({}) + const dollarRoute = new BaseRoute({ + getParentRoute: () => rootRoute, + path: '/$value', + params: { + parse: ({ value }: { value: string }) => { + if (value.startsWith('dollar-')) return { value } + return false + }, + stringify: ({ value }: { value: string }) => ({ + value: `dollar-${value}`, + }), + }, + }) + const curlyRoute = new BaseRoute({ + getParentRoute: () => rootRoute, + path: '/{$value}', + params: { + parse: ({ value }: { value: string }) => { + if (value.startsWith('curly-')) return { value } + return false + }, + stringify: ({ value }: { value: string }) => ({ + value: `curly-${value}`, + }), + }, + }) + + const routeTree = rootRoute.addChildren([dollarRoute, curlyRoute]) + + const router = createTestRouter({ + routeTree, + history: createMemoryHistory({ initialEntries: ['/dollar-home'] }), + }) + + await router.load() + + const curlyLocation = router.buildLocation({ + to: '/{$value}', + params: { value: 'alpha' }, + }) + const dollarLocation = router.buildLocation({ + to: '/$value', + params: { value: 'alpha' }, + }) + + expect(curlyLocation.pathname).toBe('/curly-alpha') + expect(dollarLocation.pathname).toBe('/dollar-alpha') + }) + + test('params.parse should gate path matching and provide typed params', async () => { + const rootRoute = new BaseRootRoute({}) + const userRoute = new BaseRoute({ + getParentRoute: () => rootRoute, + path: '/users/$userId', + params: { + parse: ({ userId }: { userId: string }) => { + const parsed = Number(userId) + if (!Number.isInteger(parsed)) return false + return { userId: parsed } + }, + stringify: ({ userId }: { userId: number }) => ({ + userId: String(userId), + }), + }, + }) + + const routeTree = rootRoute.addChildren([userRoute]) + + const router = createTestRouter({ + routeTree, + history: createMemoryHistory({ initialEntries: ['/users/123'] }), + }) + + await router.load() + + expect(router.state.matches.at(-1)?.params).toEqual({ userId: 123 }) + + const location = router.buildLocation({ + to: '/users/$userId', + params: { userId: 456 }, + }) + + expect(location.pathname).toBe('/users/456') + }) + + test('buildLocation should warn in development when stringified params do not match the target route', async () => { + const rootRoute = new BaseRootRoute({}) + const staticRoute = new BaseRoute({ + getParentRoute: () => rootRoute, + path: '/no', + }) + const dynamicRoute = new BaseRoute({ + getParentRoute: () => rootRoute, + path: '/$foo', + params: { + stringify: () => ({ foo: 'no' }), + }, + }) + + const routeTree = rootRoute.addChildren([staticRoute, dynamicRoute]) + + const router = createTestRouter({ + routeTree, + history: createMemoryHistory({ initialEntries: ['/yes'] }), + }) + + await router.load() + + const warn = vi.spyOn(console, 'warn').mockImplementation(() => {}) + + try { + const location = router.buildLocation({ + to: '/$foo', + params: { foo: 'yes' }, + }) + + expect(location.pathname).toBe('/no') + expect(warn).toHaveBeenCalledWith( + 'Generated path "/no" for route "/$foo" matched route "/no" instead. This can happen when multiple route templates resolve to the same URL. Use the route template that matches the intended route, or adjust params.stringify if it changed the target path.', + ) + } finally { + warn.mockRestore() + } + }) + + test('buildLocation should warn in development when a generated path matches an optional route template', async () => { + const rootRoute = new BaseRootRoute({}) + const timeRoute = new BaseRoute({ + getParentRoute: () => rootRoute, + path: '/time', + }) + const dayRoute = new BaseRoute({ + getParentRoute: () => timeRoute, + path: '{-$day}', + }) + + const routeTree = rootRoute.addChildren([timeRoute.addChildren([dayRoute])]) + + const router = createTestRouter({ + routeTree, + history: createMemoryHistory({ initialEntries: ['/'] }), + }) + + await router.load() + + const warn = vi.spyOn(console, 'warn').mockImplementation(() => {}) + + try { + const location = router.buildLocation({ + to: '/time', + }) + + expect(location.pathname).toBe('/time') + expect(warn).toHaveBeenCalledWith( + 'Generated path "/time" for route "/time" matched route "/time/{-$day}" instead. This can happen when multiple route templates resolve to the same URL. Use the route template that matches the intended route, or adjust params.stringify if it changed the target path.', + ) + } finally { + warn.mockRestore() + } + }) + test('params.stringify in nested routes should all be applied', async () => { const rootRoute = new BaseRootRoute({}) const orgRoute = new BaseRoute({ diff --git a/packages/router-core/tests/callbacks.test.ts b/packages/router-core/tests/callbacks.test.ts index 9016caced0..1673626f7e 100644 --- a/packages/router-core/tests/callbacks.test.ts +++ b/packages/router-core/tests/callbacks.test.ts @@ -201,7 +201,7 @@ describe('callbacks', () => { expect(page2MatchId).toBeDefined() expect(page2MatchId).not.toBe(page1MatchId) expect( - router.stores.cachedMatchesId.state.some((id) => id === page1MatchId), + router.stores.cachedIds.get().some((id) => id === page1MatchId), ).toBe(true) await router.navigate({ to: '/foo', search: { page: '1' } }) @@ -226,7 +226,7 @@ describe('callbacks', () => { expect(post2MatchId).toBeDefined() expect(post2MatchId).not.toBe(post1MatchId) expect( - router.stores.cachedMatchesId.state.some((id) => id === post1MatchId), + router.stores.cachedIds.get().some((id) => id === post1MatchId), ).toBe(true) await router.navigate({ to: '/posts/$postId', params: { postId: '1' } }) diff --git a/packages/router-core/tests/closing-tag-detection.bench.ts b/packages/router-core/tests/closing-tag-detection.bench.ts index a924256dc2..5a52f6c580 100644 --- a/packages/router-core/tests/closing-tag-detection.bench.ts +++ b/packages/router-core/tests/closing-tag-detection.bench.ts @@ -1,5 +1,8 @@ import { bench, describe } from 'vitest' +const BODY_END_TAG = '</body>' +const MIN_CLOSING_TAG_LENGTH = 4 + /** * Benchmark comparing different approaches for finding the last closing tag in HTML chunks. * @@ -200,6 +203,303 @@ function findLastClosingTagHybrid(str: string): number { return -1 } +// ============================================================================ +// Body end tag detection variants +// ============================================================================ +function findBodyEndTagForward(str: string): number { + for (let i = 0; i <= str.length - BODY_END_TAG.length; i++) { + if ( + str.charCodeAt(i) === 60 && + str.charCodeAt(i + 1) === 47 && + (str.charCodeAt(i + 2) | 32) === 98 && + (str.charCodeAt(i + 3) | 32) === 111 && + (str.charCodeAt(i + 4) | 32) === 100 && + (str.charCodeAt(i + 5) | 32) === 121 && + str.charCodeAt(i + 6) === 62 + ) { + return i + } + } + return -1 +} + +function findBodyEndTagBackward(str: string): number { + for (let i = str.length - BODY_END_TAG.length; i >= 0; i--) { + if ( + str.charCodeAt(i) === 60 && + str.charCodeAt(i + 1) === 47 && + (str.charCodeAt(i + 2) | 32) === 98 && + (str.charCodeAt(i + 3) | 32) === 111 && + (str.charCodeAt(i + 4) | 32) === 100 && + (str.charCodeAt(i + 5) | 32) === 121 && + str.charCodeAt(i + 6) === 62 + ) { + return i + } + } + return -1 +} + +function findBodyEndTagLastOpenSlash(str: string): number { + let searchFrom = str.length - BODY_END_TAG.length + + while (searchFrom >= 0) { + const start = str.lastIndexOf('</', searchFrom) + if (start === -1) return -1 + + if ( + (str.charCodeAt(start + 2) | 32) === 98 && + (str.charCodeAt(start + 3) | 32) === 111 && + (str.charCodeAt(start + 4) | 32) === 100 && + (str.charCodeAt(start + 5) | 32) === 121 && + str.charCodeAt(start + 6) === 62 + ) { + return start + } + + searchFrom = start - 1 + } + + return -1 +} + +function findBodyEndTagNativeLowerThenLastOpenSlash(str: string): number { + const index = str.lastIndexOf(BODY_END_TAG) + return index === -1 ? findBodyEndTagLastOpenSlash(str) : index +} + +type BoundaryScanResult = { + bodyEndIndex: number + lastClosingTagEnd: number +} + +function findHtmlBoundaryCombined(str: string): BoundaryScanResult { + const len = str.length + let lastClosingTagEnd = -1 + let searchFrom = len - 1 + + while (searchFrom >= MIN_CLOSING_TAG_LENGTH - 1) { + const closeIndex = str.lastIndexOf('>', searchFrom) + if (closeIndex < MIN_CLOSING_TAG_LENGTH - 1) break + + let j = closeIndex - 1 + while (j >= 1) { + const code = str.charCodeAt(j) + if ( + (code >= 97 && code <= 122) || + (code >= 65 && code <= 90) || + (code >= 48 && code <= 57) || + code === 95 || + code === 58 || + code === 46 || + code === 45 + ) { + j-- + } else { + break + } + } + + const tagNameStart = j + 1 + if (tagNameStart < closeIndex) { + const startCode = str.charCodeAt(tagNameStart) + if ( + ((startCode >= 97 && startCode <= 122) || + (startCode >= 65 && startCode <= 90)) && + j >= 1 && + str.charCodeAt(j) === 47 && + str.charCodeAt(j - 1) === 60 + ) { + if (lastClosingTagEnd === -1) { + lastClosingTagEnd = closeIndex + 1 + } + + if ( + closeIndex - tagNameStart === 4 && + (str.charCodeAt(tagNameStart) | 32) === 98 && + (str.charCodeAt(tagNameStart + 1) | 32) === 111 && + (str.charCodeAt(tagNameStart + 2) | 32) === 100 && + (str.charCodeAt(tagNameStart + 3) | 32) === 121 + ) { + return { bodyEndIndex: j - 1, lastClosingTagEnd } + } + } + } + + searchFrom = closeIndex - 1 + } + + return { bodyEndIndex: -1, lastClosingTagEnd } +} + +function findHtmlBoundaryLastOpenSlash(str: string): BoundaryScanResult { + let bodyEndIndex = -1 + let lastClosingTagEnd = -1 + let searchFrom = str.length - MIN_CLOSING_TAG_LENGTH + + while (searchFrom >= 0) { + const openSlash = str.lastIndexOf('</', searchFrom) + if (openSlash === -1) break + + let i = openSlash + 2 + const startCode = str.charCodeAt(i) + if ( + (startCode >= 97 && startCode <= 122) || + (startCode >= 65 && startCode <= 90) + ) { + i++ + while (i < str.length) { + const code = str.charCodeAt(i) + if ( + (code >= 97 && code <= 122) || + (code >= 65 && code <= 90) || + (code >= 48 && code <= 57) || + code === 95 || + code === 58 || + code === 46 || + code === 45 + ) { + i++ + } else { + break + } + } + + if (str.charCodeAt(i) === 62) { + if (lastClosingTagEnd === -1) { + lastClosingTagEnd = i + 1 + } + + if ( + i - openSlash === BODY_END_TAG.length - 1 && + (str.charCodeAt(openSlash + 2) | 32) === 98 && + (str.charCodeAt(openSlash + 3) | 32) === 111 && + (str.charCodeAt(openSlash + 4) | 32) === 100 && + (str.charCodeAt(openSlash + 5) | 32) === 121 + ) { + bodyEndIndex = openSlash + break + } + } + } + + searchFrom = openSlash - 1 + } + + return { bodyEndIndex, lastClosingTagEnd } +} + +function findHtmlBoundaryLastOpenSlashLazy(str: string): BoundaryScanResult { + let lastClosingTagEnd = -1 + let searchFrom = str.length - MIN_CLOSING_TAG_LENGTH + + while (searchFrom >= 0) { + const openSlash = str.lastIndexOf('</', searchFrom) + if (openSlash === -1) break + + if ( + (str.charCodeAt(openSlash + 2) | 32) === 98 && + (str.charCodeAt(openSlash + 3) | 32) === 111 && + (str.charCodeAt(openSlash + 4) | 32) === 100 && + (str.charCodeAt(openSlash + 5) | 32) === 121 && + str.charCodeAt(openSlash + 6) === 62 + ) { + return { bodyEndIndex: openSlash, lastClosingTagEnd } + } + + if (lastClosingTagEnd === -1) { + let i = openSlash + 2 + const startCode = str.charCodeAt(i) + if ( + (startCode >= 97 && startCode <= 122) || + (startCode >= 65 && startCode <= 90) + ) { + i++ + while (i < str.length) { + const code = str.charCodeAt(i) + if ( + (code >= 97 && code <= 122) || + (code >= 65 && code <= 90) || + (code >= 48 && code <= 57) || + code === 95 || + code === 58 || + code === 46 || + code === 45 + ) { + i++ + } else { + break + } + } + + if (str.charCodeAt(i) === 62) { + lastClosingTagEnd = i + 1 + } + } + } + + searchFrom = openSlash - 1 + } + + return { bodyEndIndex: -1, lastClosingTagEnd } +} + +// Encoded return avoids allocation: body index => -index - 2; otherwise last closing tag end. +function findHtmlBoundaryLastOpenSlashLazyEncoded(str: string): number { + let lastClosingTagEnd = -1 + let searchFrom = str.length - MIN_CLOSING_TAG_LENGTH + + while (searchFrom >= 0) { + const openSlash = str.lastIndexOf('</', searchFrom) + if (openSlash === -1) break + + if ( + (str.charCodeAt(openSlash + 2) | 32) === 98 && + (str.charCodeAt(openSlash + 3) | 32) === 111 && + (str.charCodeAt(openSlash + 4) | 32) === 100 && + (str.charCodeAt(openSlash + 5) | 32) === 121 && + str.charCodeAt(openSlash + 6) === 62 + ) { + return -openSlash - 2 + } + + if (lastClosingTagEnd === -1) { + let i = openSlash + 2 + const startCode = str.charCodeAt(i) + if ( + (startCode >= 97 && startCode <= 122) || + (startCode >= 65 && startCode <= 90) + ) { + i++ + while (i < str.length) { + const code = str.charCodeAt(i) + if ( + (code >= 97 && code <= 122) || + (code >= 65 && code <= 90) || + (code >= 48 && code <= 57) || + code === 95 || + code === 58 || + code === 46 || + code === 45 + ) { + i++ + } else { + break + } + } + + if (str.charCodeAt(i) === 62) { + lastClosingTagEnd = i + 1 + } + } + } + + searchFrom = openSlash - 1 + } + + return lastClosingTagEnd +} + // ============================================================================ // Test Data Generation // ============================================================================ @@ -229,6 +529,23 @@ function generateLargeChunk(): string { return html } +function generateLargeChunkNoBody(): string { + let html = '<div class="app">' + for (let i = 0; i < 100; i++) { + html += `<div class="item item-${i}"><span class="label">Label ${i}</span><input type="text" value="${i}"/><button>Click</button></div>` + } + html += '</div>' + return html +} + +function generateUppercaseBodyChunk(): string { + return generateLargeChunk().replace('</body></html>', '</BODY></HTML>') +} + +function generateLargePlainTextBodyChunk(): string { + return '<html><body>' + 'x'.repeat(16 * 1024) + '</body></html>' +} + // Chunk with custom elements (web components) function generateWebComponentChunk(): string { let html = '<div class="app">' @@ -293,8 +610,68 @@ function verifyImplementations() { console.log('All implementations verified to produce identical results') } +function verifyBodyImplementations() { + const testCases = [ + generateLargeChunk(), + generateUppercaseBodyChunk(), + generateLargePlainTextBodyChunk(), + generateLargeChunkNoBody(), + generateNoClosingTagChunk(), + generatePartialChunk(), + '<html><body>only body</body>', + '<html><body>split</bo', + '', + ] + + for (const testCase of testCases) { + const forwardResult = findBodyEndTagForward(testCase) + const backwardResult = findBodyEndTagBackward(testCase) + const lastOpenSlashResult = findBodyEndTagLastOpenSlash(testCase) + const nativeLowerResult = + findBodyEndTagNativeLowerThenLastOpenSlash(testCase) + const combinedResult = findHtmlBoundaryCombined(testCase) + const fusedOpenSlashResult = findHtmlBoundaryLastOpenSlash(testCase) + const lazyFusedResult = findHtmlBoundaryLastOpenSlashLazy(testCase) + const lazyEncodedResult = findHtmlBoundaryLastOpenSlashLazyEncoded(testCase) + const lazyEncodedBodyEndIndex = + lazyEncodedResult < -1 ? -lazyEncodedResult - 2 : -1 + const lazyEncodedLastClosingTagEnd = + lazyEncodedResult < -1 ? -1 : lazyEncodedResult + const lastClosingTagEnd = findLastClosingTagOptimized(testCase) + + if ( + forwardResult !== backwardResult || + forwardResult !== lastOpenSlashResult || + forwardResult !== nativeLowerResult || + forwardResult !== combinedResult.bodyEndIndex || + forwardResult !== fusedOpenSlashResult.bodyEndIndex || + forwardResult !== lazyFusedResult.bodyEndIndex || + forwardResult !== lazyEncodedBodyEndIndex || + lastClosingTagEnd !== combinedResult.lastClosingTagEnd || + lastClosingTagEnd !== fusedOpenSlashResult.lastClosingTagEnd || + (forwardResult === -1 && + (lastClosingTagEnd !== lazyFusedResult.lastClosingTagEnd || + lastClosingTagEnd !== lazyEncodedLastClosingTagEnd)) + ) { + console.error('Mismatch for:', testCase.slice(0, 50)) + console.error(' Forward:', forwardResult) + console.error(' Backward:', backwardResult) + console.error(' Last </:', lastOpenSlashResult) + console.error(' Native lower:', nativeLowerResult) + console.error(' Combined:', combinedResult) + console.error(' Fused </:', fusedOpenSlashResult) + console.error(' Lazy fused </:', lazyFusedResult) + console.error(' Lazy encoded </:', lazyEncodedResult) + console.error(' Last closing:', lastClosingTagEnd) + throw new Error('Body implementation mismatch!') + } + } + console.log('All body implementations verified to produce identical results') +} + // Run verification before benchmarks verifyImplementations() +verifyBodyImplementations() // ============================================================================ // Benchmarks @@ -439,3 +816,86 @@ describe('Closing Tag Detection - Partial Chunk (streaming edge case)', () => { findLastClosingTagHybrid(chunk) }) }) + +function benchBodyEndTagDetection(name: string, chunk: string) { + describe(`Body End Tag Detection - ${name}`, () => { + bench('forward charCodeAt', () => { + findBodyEndTagForward(chunk) + }) + + bench('backward charCodeAt', () => { + findBodyEndTagBackward(chunk) + }) + + bench('lastIndexOf(</) candidates', () => { + findBodyEndTagLastOpenSlash(chunk) + }) + + bench('native lowercase + lastIndexOf(</)', () => { + findBodyEndTagNativeLowerThenLastOpenSlash(chunk) + }) + + bench('combined boundary scan', () => { + findHtmlBoundaryCombined(chunk).bodyEndIndex + }) + }) +} + +function benchBoundaryDetection(name: string, chunk: string) { + describe(`HTML Boundary Detection - ${name}`, () => { + bench('current two-step forward body + last closing', () => { + const bodyEndIndex = findBodyEndTagForward(chunk) + if (bodyEndIndex === -1) { + findLastClosingTagOptimized(chunk) + } + }) + + bench('lastIndexOf(</) body + last closing', () => { + const bodyEndIndex = findBodyEndTagLastOpenSlash(chunk) + if (bodyEndIndex === -1) { + findLastClosingTagOptimized(chunk) + } + }) + + bench('native lowercase body + last closing', () => { + const bodyEndIndex = findBodyEndTagNativeLowerThenLastOpenSlash(chunk) + if (bodyEndIndex === -1) { + findLastClosingTagOptimized(chunk) + } + }) + + bench('fused lastIndexOf(</) boundary scan', () => { + findHtmlBoundaryLastOpenSlash(chunk) + }) + + bench('lazy fused lastIndexOf(</) boundary scan', () => { + findHtmlBoundaryLastOpenSlashLazy(chunk) + }) + + bench('lazy encoded lastIndexOf(</) boundary scan', () => { + findHtmlBoundaryLastOpenSlashLazyEncoded(chunk) + }) + + bench('combined boundary scan', () => { + findHtmlBoundaryCombined(chunk) + }) + }) +} + +benchBodyEndTagDetection('Large Final Chunk With </body>', generateLargeChunk()) +benchBodyEndTagDetection('Uppercase </BODY>', generateUppercaseBodyChunk()) +benchBodyEndTagDetection( + 'Plain Text Body Tail (~16KB)', + generateLargePlainTextBodyChunk(), +) +benchBodyEndTagDetection( + 'Large Chunk Without </body>', + generateLargeChunkNoBody(), +) + +benchBoundaryDetection('Large Final Chunk With </body>', generateLargeChunk()) +benchBoundaryDetection( + 'Large Chunk Without </body>', + generateLargeChunkNoBody(), +) +benchBoundaryDetection('Nested Chunk Without </body>', generateNestedChunk()) diff --git a/packages/router-core/tests/granular-stores.test.ts b/packages/router-core/tests/granular-stores.test.ts index f429510b35..54d2a4efab 100644 --- a/packages/router-core/tests/granular-stores.test.ts +++ b/packages/router-core/tests/granular-stores.test.ts @@ -91,16 +91,16 @@ describe('granular stores', () => { const activeMatches = router.state.matches // Active pool contains all active matches with correct routeIds - expect(router.stores.matchesId.state).toEqual( + expect(router.stores.matchesId.get()).toEqual( activeMatches.map((match) => match.id), ) activeMatches.forEach((match) => { - const store = router.stores.activeMatchStoresById.get(match.id) + const store = router.stores.matchStores.get(match.id) expect(store).toBeDefined() expect(store!.routeId).toBe(match.routeId) - // getMatchStoreByRouteId resolves to the same state - expect(router.stores.getMatchStoreByRouteId(match.routeId).state).toBe( - store!.state, + // getRouteMatchStore resolves to the same state + expect(router.stores.getRouteMatchStore(match.routeId).get()).toBe( + store!.get(), ) }) @@ -113,29 +113,29 @@ describe('granular stores', () => { id: `${match.id}__cached_${index}`, })) - router.stores.setPendingMatches(pendingMatches) - router.stores.setCachedMatches(cachedMatches) + router.stores.setPending(pendingMatches) + router.stores.setCached(cachedMatches) - expect(router.stores.matchesId.state).toEqual( + expect(router.stores.matchesId.get()).toEqual( activeMatches.map((match) => match.id), ) - expect(router.stores.pendingMatchesId.state).toEqual( + expect(router.stores.pendingIds.get()).toEqual( pendingMatches.map((match) => match.id), ) - expect(router.stores.cachedMatchesId.state).toEqual( + expect(router.stores.cachedIds.get()).toEqual( cachedMatches.map((match) => match.id), ) // Pending pool has correct routeIds pendingMatches.forEach((match) => { - const pendingStore = router.stores.pendingMatchStoresById.get(match.id) + const pendingStore = router.stores.pendingMatchStores.get(match.id) expect(pendingStore).toBeDefined() expect(pendingStore!.routeId).toBe(match.routeId) // Pending match is NOT in the active pool - expect(router.stores.activeMatchStoresById.get(match.id)).toBeUndefined() + expect(router.stores.matchStores.get(match.id)).toBeUndefined() // Active pool still has a match for this routeId expect( - router.stores.getMatchStoreByRouteId(match.routeId).state, + router.stores.getRouteMatchStore(match.routeId).get(), ).toBeDefined() }) @@ -143,17 +143,17 @@ describe('granular stores', () => { ...match, id: `${match.id}__active_next_${index}`, })) - router.stores.setActiveMatches(nextActiveMatches) + router.stores.setMatches(nextActiveMatches) - expect(router.stores.matchesId.state).toEqual( + expect(router.stores.matchesId.get()).toEqual( nextActiveMatches.map((match) => match.id), ) nextActiveMatches.forEach((match) => { - const store = router.stores.activeMatchStoresById.get(match.id) + const store = router.stores.matchStores.get(match.id) expect(store).toBeDefined() expect(store!.routeId).toBe(match.routeId) - expect(router.stores.getMatchStoreByRouteId(match.routeId).state).toBe( - store!.state, + expect(router.stores.getRouteMatchStore(match.routeId).get()).toBe( + store!.get(), ) }) }) @@ -172,8 +172,8 @@ describe('granular stores', () => { throw new Error('Expected root and leaf matches to exist') } - const rootStore = router.stores.activeMatchStoresById.get(rootMatch.id) - const leafStore = router.stores.activeMatchStoresById.get(leafMatch.id) + const rootStore = router.stores.matchStores.get(rootMatch.id) + const leafStore = router.stores.matchStores.get(leafMatch.id) expect(rootStore).toBeDefined() expect(leafStore).toBeDefined() @@ -182,36 +182,32 @@ describe('granular stores', () => { throw new Error('Expected root and leaf match stores to exist') } - const rootBefore = rootStore.state - const leafBefore = leafStore.state + const rootBefore = rootStore.get() + const leafBefore = leafStore.get() router.updateMatch(leafMatch.id, (prev) => ({ ...prev, status: 'pending', })) - expect(rootStore.state).toBe(rootBefore) - expect(leafStore.state).not.toBe(leafBefore) - expect(leafStore.state.status).toBe('pending') + expect(rootStore.get()).toBe(rootBefore) + expect(leafStore.get()).not.toBe(leafBefore) + expect(leafStore.get().status).toBe('pending') }) - test('getMatchStoreByRouteId caches store instances and clears when route is inactive', async () => { + test('getRouteMatchStore caches store instances and clears when route is inactive', async () => { const router = createRouter() await router.navigate({ to: '/posts/123' }) - const postsStore = router.stores.getMatchStoreByRouteId('/posts/$postId') + const postsStore = router.stores.getRouteMatchStore('/posts/$postId') - expect(router.stores.getMatchStoreByRouteId('/posts/$postId')).toBe( - postsStore, - ) - expect(postsStore.state?.routeId).toBe('/posts/$postId') + expect(router.stores.getRouteMatchStore('/posts/$postId')).toBe(postsStore) + expect(postsStore.get()?.routeId).toBe('/posts/$postId') await router.navigate({ to: '/about' }) - expect(router.stores.getMatchStoreByRouteId('/posts/$postId')).toBe( - postsStore, - ) - expect(postsStore.state).toBeUndefined() + expect(router.stores.getRouteMatchStore('/posts/$postId')).toBe(postsStore) + expect(postsStore.get()).toBeUndefined() }) test('no-op match pool reconciliation preserves ids and match state references', async () => { @@ -219,21 +215,21 @@ describe('granular stores', () => { await router.navigate({ to: '/posts/123' }) const activeMatches = router.state.matches - const activeIdsBefore = router.stores.matchesId.state + const activeIdsBefore = router.stores.matchesId.get() const activeStoresBefore = activeMatches.map((match) => - router.stores.activeMatchStoresById.get(match.id), + router.stores.matchStores.get(match.id), ) - const activeStatesBefore = activeStoresBefore.map((store) => store?.state) + const activeStatesBefore = activeStoresBefore.map((store) => store?.get()) - router.stores.setActiveMatches(activeMatches) + router.stores.setMatches(activeMatches) - expect(router.stores.matchesId.state).toBe(activeIdsBefore) - expect(router.stores.activeMatchesSnapshot.state).toBe(activeMatches) + expect(router.stores.matchesId.get()).toBe(activeIdsBefore) + expect(router.stores.matches.get()).toBe(activeMatches) for (let i = 0; i < activeMatches.length; i++) { const match = activeMatches[i]! - const store = router.stores.activeMatchStoresById.get(match.id) + const store = router.stores.matchStores.get(match.id) expect(store).toBe(activeStoresBefore[i]) - expect(store?.state).toBe(activeStatesBefore[i]) + expect(store?.get()).toBe(activeStatesBefore[i]) } const pendingMatches = activeMatches.map((match) => ({ @@ -242,22 +238,22 @@ describe('granular stores', () => { status: 'pending' as const, })) - router.stores.setPendingMatches(pendingMatches) + router.stores.setPending(pendingMatches) - const pendingIdsBefore = router.stores.pendingMatchesId.state + const pendingIdsBefore = router.stores.pendingIds.get() const pendingStoresBefore = pendingMatches.map((match) => - router.stores.pendingMatchStoresById.get(match.id), + router.stores.pendingMatchStores.get(match.id), ) - const pendingStatesBefore = pendingStoresBefore.map((store) => store?.state) + const pendingStatesBefore = pendingStoresBefore.map((store) => store?.get()) - router.stores.setPendingMatches(pendingMatches) + router.stores.setPending(pendingMatches) - expect(router.stores.pendingMatchesId.state).toBe(pendingIdsBefore) + expect(router.stores.pendingIds.get()).toBe(pendingIdsBefore) for (let i = 0; i < pendingMatches.length; i++) { const match = pendingMatches[i]! - const store = router.stores.pendingMatchStoresById.get(match.id) + const store = router.stores.pendingMatchStores.get(match.id) expect(store).toBe(pendingStoresBefore[i]) - expect(store?.state).toBe(pendingStatesBefore[i]) + expect(store?.get()).toBe(pendingStatesBefore[i]) } }) @@ -274,7 +270,7 @@ describe('granular stores', () => { throw new Error('Expected active leaf match to exist') } - const activeStore = router.stores.activeMatchStoresById.get(activeLeaf.id) + const activeStore = router.stores.matchStores.get(activeLeaf.id) expect(activeStore).toBeDefined() @@ -282,17 +278,15 @@ describe('granular stores', () => { throw new Error('Expected active leaf store to exist') } - const activeBefore = activeStore.state + const activeBefore = activeStore.get() const reloadPromise = router.load() await Promise.resolve() - const pendingStore = router.stores.pendingMatchStoresById.get(activeLeaf.id) + const pendingStore = router.stores.pendingMatchStores.get(activeLeaf.id) expect(pendingStore).toBeDefined() - expect(router.stores.activeMatchStoresById.get(activeLeaf.id)).toBe( - activeStore, - ) + expect(router.stores.matchStores.get(activeLeaf.id)).toBe(activeStore) if (!pendingStore) { throw new Error('Expected pending leaf store to exist') @@ -304,10 +298,10 @@ describe('granular stores', () => { error: new Error('pending-only-update'), })) - expect(activeStore.state).toBe(activeBefore) - expect(activeStore.state.status).toBe('success') - expect(pendingStore.state.status).toBe('error') - expect(pendingStore.state.error).toEqual(new Error('pending-only-update')) + expect(activeStore.get()).toBe(activeBefore) + expect(activeStore.get().status).toBe('success') + expect(pendingStore.get().status).toBe('error') + expect(pendingStore.get().error).toEqual(new Error('pending-only-update')) resolveLoader() await reloadPromise @@ -328,10 +322,10 @@ describe('granular stores', () => { status: 'success' as const, } - router.stores.setPendingMatches([pendingDuplicate]) - router.stores.setCachedMatches([cachedDuplicate]) + router.stores.setPending([pendingDuplicate]) + router.stores.setCached([cachedDuplicate]) - router.stores.setActiveMatches( + router.stores.setMatches( router.state.matches.map((match) => match.id === duplicatedId ? { @@ -343,20 +337,18 @@ describe('granular stores', () => { ), ) + expect(router.stores.matchStores.get(duplicatedId)?.get().status).toBe( + 'error', + ) expect( - router.stores.activeMatchStoresById.get(duplicatedId)?.state.status, - ).toBe('error') - expect( - router.stores.getMatchStoreByRouteId(activeLeaf.routeId).state?.status, + router.stores.getRouteMatchStore(activeLeaf.routeId).get()?.status, ).toBe('error') // Pending pool has its own store for this id expect( - router.stores.pendingMatchStoresById.get(duplicatedId)?.state.status, + router.stores.pendingMatchStores.get(duplicatedId)?.get().status, ).toBe('pending') - expect(router.stores.pendingMatchesSnapshot.state[0]?.status).toBe( - 'pending', - ) - expect(router.stores.cachedMatchesSnapshot.state[0]?.status).toBe('success') + expect(router.stores.pendingMatches.get()[0]?.status).toBe('pending') + expect(router.stores.cachedMatches.get()[0]?.status).toBe('success') expect(router.getMatch(duplicatedId)?.status).toBe('success') }) }) diff --git a/packages/router-core/tests/hydrate.test.ts b/packages/router-core/tests/hydrate.test.ts index e9bb82018a..efac230e49 100644 --- a/packages/router-core/tests/hydrate.test.ts +++ b/packages/router-core/tests/hydrate.test.ts @@ -4,8 +4,14 @@ import { BaseRootRoute, BaseRoute, notFound } from '../src' import { hydrate } from '../src/ssr/client' import { createTestRouter } from './routerTestUtils' import { dehydrateSsrMatchId } from '../src/ssr/ssr-match-id' +import type { LocationRewrite } from '../src' import type { TsrSsrGlobal } from '../src/ssr/types' import type { AnyRouteMatch } from '../src' +import type { Manifest } from '../src/manifest' + +const testManifest: Manifest = { + routes: {}, +} describe('hydrate', () => { let mockWindow: { $_TSR?: TsrSsrGlobal } @@ -92,7 +98,7 @@ describe('hydrate', () => { const mockBuffer = [vi.fn(), vi.fn()] mockWindow.$_TSR = { router: { - manifest: { routes: {} }, + manifest: testManifest, dehydratedData: {}, lastMatchId: '/', matches: [], @@ -121,7 +127,7 @@ describe('hydrate', () => { mockWindow.$_TSR = { router: { - manifest: { routes: {} }, + manifest: testManifest, dehydratedData: {}, lastMatchId: '/', matches: [], @@ -141,7 +147,6 @@ describe('hydrate', () => { }) it('should set manifest in router.ssr', async () => { - const testManifest = { routes: {} } mockWindow.$_TSR = { router: { manifest: testManifest, @@ -197,7 +202,7 @@ describe('hydrate', () => { mockWindow.$_TSR = { router: { - manifest: { routes: {} }, + manifest: testManifest, dehydratedData: {}, lastMatchId: '/', matches: dehydratedMatches, @@ -245,7 +250,7 @@ describe('hydrate', () => { mockWindow.$_TSR = { router: { - manifest: { routes: {} }, + manifest: testManifest, dehydratedData: {}, lastMatchId: '/', matches: dehydratedMatches, @@ -288,7 +293,7 @@ describe('hydrate', () => { mockWindow.$_TSR = { router: { - manifest: { routes: {} }, + manifest: testManifest, dehydratedData: {}, lastMatchId: '/', matches: dehydratedMatches, @@ -332,7 +337,7 @@ describe('hydrate', () => { mockWindow.$_TSR = { router: { - manifest: { routes: {} }, + manifest: testManifest, dehydratedData: {}, lastMatchId: '/', matches: dehydratedMatches, @@ -368,7 +373,7 @@ describe('hydrate', () => { mockWindow.$_TSR = { router: { - manifest: { routes: {} }, + manifest: testManifest, dehydratedData: {}, lastMatchId: dehydrateSsrMatchId('/'), matches: [ @@ -395,6 +400,73 @@ describe('hydrate', () => { expect((mockRouter.state.matches[0] as AnyRouteMatch).id).toBe('/') }) + it('should run custom hydration before matching routes', async () => { + const history = createMemoryHistory({ initialEntries: ['/public'] }) + + const rootRoute = new BaseRootRoute({}) + const internalRoute = new BaseRoute({ + getParentRoute: () => rootRoute, + path: '/internal', + component: () => 'Internal', + }) + + const rewrite: LocationRewrite = { + input: ({ url }) => { + if (url.pathname === '/public') { + url.pathname = '/internal' + } + return url + }, + } + + mockRouter = createTestRouter({ + routeTree: rootRoute.addChildren([internalRoute]), + history, + isServer: true, + hydrate: (dehydrated: { rewrite?: boolean }) => { + if (dehydrated.rewrite) { + mockRouter.update({ rewrite }) + } + }, + }) + + mockWindow.$_TSR = { + router: { + manifest: testManifest, + dehydratedData: { rewrite: true }, + lastMatchId: '/internal/internal', + matches: [ + { + i: '__root__/', + s: 'success', + ssr: true, + u: Date.now(), + }, + { + i: '/internal/internal', + s: 'success', + ssr: true, + u: Date.now(), + }, + ], + }, + h: vi.fn(), + e: vi.fn(), + c: vi.fn(), + p: vi.fn(), + buffer: [], + initialized: false, + } + + await hydrate(mockRouter) + + expect(mockRouter.state.location.pathname).toBe('/internal') + expect(mockRouter.state.location.publicHref).toBe('/public') + expect( + mockRouter.state.matches.map((match: AnyRouteMatch) => match.routeId), + ).toEqual(['__root__', '/internal']) + }) + it('should handle errors during route context hydration', async () => { const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => {}) mockHead.mockImplementation(() => { @@ -410,7 +482,7 @@ describe('hydrate', () => { mockWindow.$_TSR = { router: { - manifest: { routes: {} }, + manifest: testManifest, dehydratedData: {}, lastMatchId: '/', matches: [ diff --git a/packages/router-core/tests/load.test.ts b/packages/router-core/tests/load.test.ts index 925006b7a3..1ea6fca30e 100644 --- a/packages/router-core/tests/load.test.ts +++ b/packages/router-core/tests/load.test.ts @@ -82,6 +82,42 @@ describe('redirect resolution', () => { ) }) +describe('notFound detection', () => { + test('does not treat arbitrary proxy property access as notFound', async () => { + const rootRoute = new BaseRootRoute({}) + const fooRoute = new BaseRoute({ + getParentRoute: () => rootRoute, + path: '/foo', + loader: () => + new Proxy( + {}, + { + get(_target, prop) { + if (prop === 'isNotFound') return 'truthy-but-not-true' + return undefined + }, + has() { + return true + }, + }, + ), + }) + + const routeTree = rootRoute.addChildren([fooRoute]) + + const router = createTestRouter({ + routeTree, + history: createMemoryHistory({ initialEntries: ['/foo'] }), + isServer: true, + }) + + await router.load() + + expect(router.state.matches.at(-1)?.status).toBe('success') + expect(router.state.matches.at(-1)?.error).toBeUndefined() + }) +}) + describe('beforeLoad skip or exec', () => { const setup = ({ beforeLoad }: { beforeLoad?: BeforeLoad }) => { const rootRoute = new BaseRootRoute({}) @@ -119,7 +155,7 @@ describe('beforeLoad skip or exec', () => { const router = setup({ beforeLoad }) const navigation = router.navigate({ to: '/foo' }) expect(beforeLoad).toHaveBeenCalledTimes(1) - expect(router.stores.pendingMatchesSnapshot.state).toEqual( + expect(router.stores.pendingMatches.get()).toEqual( expect.arrayContaining([expect.objectContaining({ id: '/foo/foo' })]), ) await navigation @@ -137,11 +173,47 @@ describe('beforeLoad skip or exec', () => { expect(beforeLoad).toHaveBeenCalledTimes(1) }) + test('preserves primitive errors thrown from beforeLoad', async () => { + const beforeLoad = vi.fn<BeforeLoad>(() => { + throw 'primitive error' + }) + const router = setup({ beforeLoad }) + + await router.navigate({ to: '/foo' }) + + expect(router.state.statusCode).toBe(500) + expect(router.state.matches).toEqual( + expect.arrayContaining([ + expect.objectContaining({ + id: '/foo/foo', + status: 'error', + error: 'primitive error', + }), + ]), + ) + }) + + test('does not mutate object errors thrown from beforeLoad', async () => { + const thrown = { type: 'domain-error' } + const beforeLoad = vi.fn<BeforeLoad>(() => { + throw thrown + }) + const router = setup({ beforeLoad }) + + await router.navigate({ to: '/foo' }) + + expect(router.state.statusCode).toBe(500) + expect(router.state.matches.find((d) => d.id === '/foo/foo')?.error).toBe( + thrown, + ) + expect(thrown).toEqual({ type: 'domain-error' }) + }) + test('exec if resolved preload (success)', async () => { const beforeLoad = vi.fn() const router = setup({ beforeLoad }) await router.preloadRoute({ to: '/foo' }) - expect(router.stores.cachedMatchesSnapshot.state).toEqual( + expect(router.stores.cachedMatches.get()).toEqual( expect.arrayContaining([expect.objectContaining({ id: '/foo/foo' })]), ) await sleep(10) @@ -155,7 +227,7 @@ describe('beforeLoad skip or exec', () => { const router = setup({ beforeLoad }) router.preloadRoute({ to: '/foo' }) await Promise.resolve() - expect(router.stores.cachedMatchesSnapshot.state).toEqual( + expect(router.stores.cachedMatches.get()).toEqual( expect.arrayContaining([expect.objectContaining({ id: '/foo/foo' })]), ) await router.navigate({ to: '/foo' }) @@ -203,18 +275,14 @@ describe('beforeLoad skip or exec', () => { }) await router.preloadRoute({ to: '/foo' }) expect( - router.stores.cachedMatchesSnapshot.state.some( - (d) => d.status === 'redirected', - ), + router.stores.cachedMatches.get().some((d) => d.status === 'redirected'), ).toBe(false) await sleep(10) await router.navigate({ to: '/foo' }) expect(router.state.location.pathname).toBe('/foo') expect( - router.stores.cachedMatchesSnapshot.state.some( - (d) => d.status === 'redirected', - ), + router.stores.cachedMatches.get().some((d) => d.status === 'redirected'), ).toBe(false) expect(beforeLoad).toHaveBeenCalledTimes(2) }) @@ -230,17 +298,13 @@ describe('beforeLoad skip or exec', () => { router.preloadRoute({ to: '/foo' }) await Promise.resolve() expect( - router.stores.cachedMatchesSnapshot.state.some( - (d) => d.status === 'redirected', - ), + router.stores.cachedMatches.get().some((d) => d.status === 'redirected'), ).toBe(false) await router.navigate({ to: '/foo' }) expect(router.state.location.pathname).toBe('/foo') expect( - router.stores.cachedMatchesSnapshot.state.some( - (d) => d.status === 'redirected', - ), + router.stores.cachedMatches.get().some((d) => d.status === 'redirected'), ).toBe(false) expect(beforeLoad).toHaveBeenCalledTimes(2) }) @@ -359,7 +423,7 @@ describe('loader skip or exec', () => { const router = setup({ loader }) const navigation = router.navigate({ to: '/foo' }) expect(loader).toHaveBeenCalledTimes(1) - expect(router.stores.pendingMatchesSnapshot.state).toEqual( + expect(router.stores.pendingMatches.get()).toEqual( expect.arrayContaining([expect.objectContaining({ id: '/foo/foo' })]), ) await navigation @@ -381,7 +445,7 @@ describe('loader skip or exec', () => { const loader = vi.fn() const router = setup({ loader }) await router.preloadRoute({ to: '/foo' }) - expect(router.stores.cachedMatchesSnapshot.state).toEqual( + expect(router.stores.cachedMatches.get()).toEqual( expect.arrayContaining([expect.objectContaining({ id: '/foo/foo' })]), ) await sleep(10) @@ -394,7 +458,7 @@ describe('loader skip or exec', () => { const loader = vi.fn() const router = setup({ loader, staleTime: 1000 }) await router.preloadRoute({ to: '/foo' }) - expect(router.stores.cachedMatchesSnapshot.state).toEqual( + expect(router.stores.cachedMatches.get()).toEqual( expect.arrayContaining([expect.objectContaining({ id: '/foo/foo' })]), ) await sleep(10) @@ -408,7 +472,7 @@ describe('loader skip or exec', () => { const router = setup({ loader }) router.preloadRoute({ to: '/foo' }) await Promise.resolve() - expect(router.stores.cachedMatchesSnapshot.state).toEqual( + expect(router.stores.cachedMatches.get()).toEqual( expect.arrayContaining([expect.objectContaining({ id: '/foo/foo' })]), ) await router.navigate({ to: '/foo' }) @@ -456,18 +520,14 @@ describe('loader skip or exec', () => { }) await router.preloadRoute({ to: '/foo' }) expect( - router.stores.cachedMatchesSnapshot.state.some( - (d) => d.status === 'redirected', - ), + router.stores.cachedMatches.get().some((d) => d.status === 'redirected'), ).toBe(false) await sleep(10) await router.navigate({ to: '/foo' }) expect(router.state.location.pathname).toBe('/foo') expect( - router.stores.cachedMatchesSnapshot.state.some( - (d) => d.status === 'redirected', - ), + router.stores.cachedMatches.get().some((d) => d.status === 'redirected'), ).toBe(false) expect(loader).toHaveBeenCalledTimes(2) }) @@ -483,17 +543,13 @@ describe('loader skip or exec', () => { router.preloadRoute({ to: '/foo' }) await Promise.resolve() expect( - router.stores.cachedMatchesSnapshot.state.some( - (d) => d.status === 'redirected', - ), + router.stores.cachedMatches.get().some((d) => d.status === 'redirected'), ).toBe(false) await router.navigate({ to: '/foo' }) expect(router.state.location.pathname).toBe('/bar') expect( - router.stores.cachedMatchesSnapshot.state.some( - (d) => d.status === 'redirected', - ), + router.stores.cachedMatches.get().some((d) => d.status === 'redirected'), ).toBe(false) expect(loader).toHaveBeenCalledTimes(1) }) @@ -503,7 +559,7 @@ describe('loader skip or exec', () => { const router = setup({ loader }) await router.preloadRoute({ to: '/foo' }) - expect(router.stores.cachedMatchesSnapshot.state).toEqual( + expect(router.stores.cachedMatches.get()).toEqual( expect.arrayContaining([expect.objectContaining({ id: '/foo/foo' })]), ) @@ -513,14 +569,10 @@ describe('loader skip or exec', () => { })) expect( - router.stores.cachedMatchesSnapshot.state.some( - (d) => d.id === '/foo/foo', - ), + router.stores.cachedMatches.get().some((d) => d.id === '/foo/foo'), ).toBe(false) expect( - router.stores.cachedMatchesSnapshot.state.some( - (d) => d.status === 'redirected', - ), + router.stores.cachedMatches.get().some((d) => d.status === 'redirected'), ).toBe(false) }) @@ -648,10 +700,8 @@ describe('stale loader reload triggers', () => { id: string, ) => router.state.matches.find((match) => match.id === id) ?? - router.stores.pendingMatchesSnapshot.state.find( - (match) => match.id === id, - ) ?? - router.stores.cachedMatchesSnapshot.state.find((match) => match.id === id) + router.stores.pendingMatches.get().find((match) => match.id === id) ?? + router.stores.cachedMatches.get().find((match) => match.id === id) const hasActiveMatch = ( router: RouterCore<any, any, any, any, any>, @@ -662,9 +712,7 @@ describe('stale loader reload triggers', () => { router: RouterCore<any, any, any, any, any>, id: string, ) => - router.stores.pendingMatchesSnapshot.state.some( - (match) => match.id === id, - ) ?? false + router.stores.pendingMatches.get().some((match) => match.id === id) ?? false const setup = ({ loader, @@ -1350,7 +1398,7 @@ describe('head execution', () => { const location = router.latestLocation const matches = router.matchRoutes(location) - router.stores.setPendingMatches(matches) + router.stores.setPending(matches) await expect( loadMatches({ @@ -1401,7 +1449,7 @@ describe('head execution', () => { const location = router.latestLocation const matches = router.matchRoutes(location) - router.stores.setPendingMatches(matches) + router.stores.setPending(matches) await expect( loadMatches({ @@ -1548,7 +1596,7 @@ describe('head execution', () => { const runLoadMatchesAndCapture = async (router: AnyRouter) => { const location = router.latestLocation const matches = router.matchRoutes(location) - router.stores.setPendingMatches(matches) + router.stores.setPending(matches) try { await loadMatches({ @@ -1766,9 +1814,9 @@ describe('head execution', () => { }), ) - const rootMatch = router.stores.pendingMatchesSnapshot.state.find( - (m) => m.routeId === routes[0].id, - ) + const rootMatch = router.stores.pendingMatches + .get() + .find((m) => m.routeId === routes[0].id) expect(rootMatch?.globalNotFound).toBe(true) expect(rootMatch?.status).toBe('success') @@ -1795,9 +1843,9 @@ describe('head execution', () => { const second = await runLoadMatchesAndCapture(router) expect(second.error).toBeUndefined() - const rootMatch = router.stores.pendingMatchesSnapshot.state.find( - (m) => m.routeId === routes[0].id, - ) + const rootMatch = router.stores.pendingMatches + .get() + .find((m) => m.routeId === routes[0].id) expect(rootMatch?.globalNotFound).toBe(false) }) @@ -1831,10 +1879,9 @@ describe('head execution', () => { expect(rootLoader).toHaveBeenCalledTimes(1) const staleRootNotFound = notFound({ data: { source: 'stale-root' } }) - const currentRootMatchId = - router.stores.pendingMatchesSnapshot.state.find( - (m) => m.routeId === rootRoute.id, - )!.id + const currentRootMatchId = router.stores.pendingMatches + .get() + .find((m) => m.routeId === rootRoute.id)!.id router.updateMatch(currentRootMatchId, (prev) => ({ ...prev, @@ -1849,7 +1896,7 @@ describe('head execution', () => { pendingRootMatch.status = 'success' pendingRootMatch.globalNotFound = false pendingRootMatch.error = undefined - router.stores.setPendingMatches(matches) + router.stores.setPending(matches) await expect( loadMatches({ @@ -1862,9 +1909,9 @@ describe('head execution', () => { expect(rootLoader).toHaveBeenCalledTimes(1) - const rootMatch = router.stores.pendingMatchesSnapshot.state.find( - (m) => m.routeId === rootRoute.id, - ) + const rootMatch = router.stores.pendingMatches + .get() + .find((m) => m.routeId === rootRoute.id) expect(rootMatch?.globalNotFound).toBe(false) expect(rootMatch?.error).toBeUndefined() @@ -1896,9 +1943,9 @@ describe('params.parse notFound', () => { await router.load() - const match = router.stores.activeMatchesSnapshot.state.find( - (m) => m.routeId === testRoute.id, - ) + const match = router.stores.matches + .get() + .find((m) => m.routeId === testRoute.id) expect(match?.status).toBe('notFound') }) diff --git a/packages/router-core/tests/manifest.test.ts b/packages/router-core/tests/manifest.test.ts new file mode 100644 index 0000000000..f9d5d961df --- /dev/null +++ b/packages/router-core/tests/manifest.test.ts @@ -0,0 +1,117 @@ +import { describe, expect, it } from 'vitest' +import { appendUniqueUserTags } from '../src/manifest' +import type { RouterManagedTag } from '../src/manifest' + +describe('appendUniqueUserTags', () => { + it('does not modify the target for an empty category', () => { + const existing: RouterManagedTag = { + tag: 'meta', + attrs: { + name: 'description', + content: 'existing', + }, + } + const target = [existing] + + appendUniqueUserTags(target, []) + + expect(target).toEqual([existing]) + }) + + it('appends a single tag unchanged', () => { + const tag: RouterManagedTag = { + tag: 'title', + children: 'Home', + } + const target: Array<RouterManagedTag> = [] + + appendUniqueUserTags(target, [tag]) + + expect(target).toEqual([tag]) + expect(target[0]).toBe(tag) + }) + + it('dedupes equivalent tags within one appended category', () => { + const firstTag: RouterManagedTag = { + tag: 'link', + attrs: { + href: '/style.css', + rel: 'stylesheet', + }, + } + const duplicateTag: RouterManagedTag = { + tag: 'link', + attrs: { + href: '/style.css', + rel: 'stylesheet', + }, + } + const nextTag: RouterManagedTag = { + tag: 'link', + attrs: { + href: '/next.css', + rel: 'stylesheet', + }, + } + const target: Array<RouterManagedTag> = [] + + appendUniqueUserTags(target, [firstTag, duplicateTag, nextTag]) + + expect(target).toEqual([firstTag, nextTag]) + expect(target[0]).toBe(firstTag) + }) + + it('keeps tags that differ by attributes within one category', () => { + const target: Array<RouterManagedTag> = [] + + appendUniqueUserTags(target, [ + { + tag: 'meta', + attrs: { + name: 'description', + content: 'first', + }, + }, + { + tag: 'meta', + attrs: { + name: 'description', + content: 'second', + }, + }, + ]) + + expect(target).toEqual([ + { + tag: 'meta', + attrs: { + name: 'description', + content: 'first', + }, + }, + { + tag: 'meta', + attrs: { + name: 'description', + content: 'second', + }, + }, + ]) + }) + + it('dedupes only within the appended tag category', () => { + const tag: RouterManagedTag = { + tag: 'link', + attrs: { + href: '/style.css', + rel: 'stylesheet', + }, + } + const target: Array<RouterManagedTag> = [] + + appendUniqueUserTags(target, [tag, tag]) + appendUniqueUserTags(target, [tag]) + + expect(target).toEqual([tag, tag]) + }) +}) diff --git a/packages/router-core/tests/match-params.test.ts b/packages/router-core/tests/match-params.test.ts new file mode 100644 index 0000000000..fe05808bd4 --- /dev/null +++ b/packages/router-core/tests/match-params.test.ts @@ -0,0 +1,789 @@ +import { describe, expect, it, vi } from 'vitest' +import { createMemoryHistory } from '@tanstack/history' +import { findRouteMatch, processRouteTree } from '../src/new-process-route-tree' +import { BaseRootRoute, BaseRoute, PathParamError } from '../src' +import { createTestRouter } from './routerTestUtils' + +type TestRoute = { + id: string + fullPath: string + path?: string + isRoot?: boolean + options?: { + params?: { + parse?: (params: Record<string, string>) => unknown + priority?: number + } + } + children?: Array<TestRoute> +} + +const root = (children: Array<TestRoute>): TestRoute => ({ + id: '__root__', + isRoot: true, + fullPath: '/', + path: '/', + children, +}) + +const parseWhen = (predicate: (params: Record<string, string>) => boolean) => { + return (params: Record<string, string>) => + predicate(params) ? params : false +} + +const integerParse = (key: string) => + parseWhen((params) => { + const value = Number(params[key]) + return Number.isInteger(value) + }) + +describe('params.parse route selection', () => { + describe('basic matching', () => { + it('matches route when params.parse returns params', () => { + const { processedTree } = processRouteTree( + root([ + { + id: '/$id', + fullPath: '/$id', + path: '$id', + options: { + params: { + parse: integerParse('id'), + }, + }, + }, + ]), + ) + + const result = findRouteMatch('/123', processedTree) + expect(result?.route.id).toBe('/$id') + expect(result?.rawParams).toEqual({ id: '123' }) + }) + + it('skips route when params.parse returns false and finds no alternative', () => { + const { processedTree } = processRouteTree( + root([ + { + id: '/$id', + fullPath: '/$id', + path: '$id', + options: { + params: { + parse: integerParse('id'), + }, + }, + }, + ]), + ) + + const result = findRouteMatch('/abc', processedTree) + expect(result).toBeNull() + }) + + it('skips route when params.parse returns false and finds an alternative', () => { + const { processedTree } = processRouteTree( + root([ + { + id: '/$id', + fullPath: '/$id', + path: '$id', + options: { + params: { + parse: integerParse('id'), + }, + }, + }, + { + id: '/$slug', + fullPath: '/$slug', + path: '$slug', + }, + ]), + ) + + const result = findRouteMatch('/hello-world', processedTree) + expect(result?.route.id).toBe('/$slug') + expect(result?.rawParams).toEqual({ slug: 'hello-world' }) + }) + + it('does not skip route when params.parse throws', () => { + const { processedTree } = processRouteTree( + root([ + { + id: '/$id', + fullPath: '/$id', + path: '$id', + options: { + params: { + parse: () => { + throw 'invalid id' + }, + }, + }, + }, + { + id: '/$slug', + fullPath: '/$slug', + path: '$slug', + }, + ]), + ) + + const result = findRouteMatch('/hello-world', processedTree) + expect(result?.route.id).toBe('/$id') + }) + + it('skips only false returns, not thrown params.parse errors', () => { + const parse = vi.fn(({ id }: Record<string, string>) => { + if (id === 'skip') return false + if (id === 'boom') throw new Error('invalid id') + return { id } + }) + const { processedTree } = processRouteTree( + root([ + { + id: '/$id', + fullPath: '/$id', + path: '$id', + options: { + params: { + parse, + }, + }, + }, + { + id: '/$slug', + fullPath: '/$slug', + path: '$slug', + }, + ]), + ) + + expect(findRouteMatch('/ok', processedTree)?.route.id).toBe('/$id') + expect(findRouteMatch('/skip', processedTree)?.route.id).toBe('/$slug') + expect(findRouteMatch('/boom', processedTree)?.route.id).toBe('/$id') + }) + + it('surfaces thrown params.parse errors on the selected router match', () => { + const rootRoute = new BaseRootRoute({}) + const guardedRoute = new BaseRoute({ + getParentRoute: () => rootRoute, + path: '/$id', + params: { + parse: ({ id }: { id: string }) => { + if (id === 'skip') return false + if (id === 'boom') throw new Error('invalid id') + return { id } + }, + }, + }) + const fallbackRoute = new BaseRoute({ + getParentRoute: () => rootRoute, + path: '/$slug', + }) + const routeTree = rootRoute.addChildren([guardedRoute, fallbackRoute]) + const router = createTestRouter({ + routeTree, + history: createMemoryHistory({ initialEntries: ['/ok'] }), + }) + + expect(router.matchRoutes('/skip', {}).at(-1)?.routeId).toBe('/$slug') + + const matches = router.matchRoutes('/boom', {}) + const match = matches.at(-1)! + expect(match.routeId).toBe('/$id') + expect(match.paramsError).toBeInstanceOf(PathParamError) + expect((match.paramsError as Error).message).toBe('invalid id') + + expect(() => + router.matchRoutes('/boom', {}, { throwOnError: true }), + ).toThrow(PathParamError) + }) + + it('calls params.parse during matching', () => { + const parse = vi.fn((params: Record<string, string>) => params) + const { processedTree } = processRouteTree( + root([ + { + id: '/$id', + fullPath: '/$id', + path: '$id', + options: { + params: { + parse, + }, + }, + }, + ]), + ) + + const result = findRouteMatch('/123', processedTree) + expect(result?.route.id).toBe('/$id') + expect(result?.rawParams).toEqual({ id: '123' }) + expect(parse).toHaveBeenCalledWith({ id: '123' }) + }) + }) + + describe('priority', () => { + it('params.parse routes take precedence over unguarded dynamic routes', () => { + const { processedTree } = processRouteTree( + root([ + { + id: '/$slug', + fullPath: '/$slug', + path: '$slug', + }, + { + id: '/$id', + fullPath: '/$id', + path: '$id', + options: { + params: { + parse: integerParse('id'), + }, + }, + }, + ]), + ) + + expect(findRouteMatch('/123', processedTree)?.route.id).toBe('/$id') + expect(findRouteMatch('/hello-world', processedTree)?.route.id).toBe( + '/$slug', + ) + }) + + it('static routes still take precedence over params.parse dynamic routes', () => { + const { processedTree } = processRouteTree( + root([ + { + id: '/settings', + fullPath: '/settings', + path: 'settings', + }, + { + id: '/$id', + fullPath: '/$id', + path: '$id', + options: { + params: { + parse: (params) => params, + priority: 999, + }, + }, + }, + ]), + ) + + expect(findRouteMatch('/settings', processedTree)?.route.id).toBe( + '/settings', + ) + }) + + it('deep params.parse routes can fall back to a sibling route', () => { + const { processedTree } = processRouteTree( + root([ + { + id: '/$a/$b/$c', + fullPath: '/$a/$b/$c', + path: '$a/$b/$c', + options: { + params: { + parse: parseWhen(({ c }) => c === 'three'), + }, + }, + }, + { + id: '/$x/$y/$z', + fullPath: '/$x/$y/$z', + path: '$x/$y/$z', + }, + ]), + ) + + expect(findRouteMatch('/one/two/three', processedTree)?.route.id).toBe( + '/$a/$b/$c', + ) + expect(findRouteMatch('/one/two/wrong', processedTree)?.route.id).toBe( + '/$x/$y/$z', + ) + }) + + it('params.priority breaks ties between params.parse routes', () => { + const { processedTree } = processRouteTree( + root([ + { + id: '/$a', + fullPath: '/$a', + path: '$a', + options: { + params: { + parse: (params) => params, + priority: -1, + }, + }, + }, + { + id: '/$z', + fullPath: '/$z', + path: '$z', + options: { + params: { + parse: (params) => params, + priority: 1, + }, + }, + }, + ]), + ) + + expect(findRouteMatch('/123', processedTree)?.route.id).toBe('/$z') + }) + + it('treats missing params.priority as 0', () => { + const priorityOneParse = vi.fn(() => false) + const defaultPriorityParse = vi.fn((params: Record<string, string>) => { + return params + }) + const priorityNegativeOneParse = vi.fn( + (params: Record<string, string>) => { + return params + }, + ) + + const { processedTree } = processRouteTree( + root([ + { + id: '/$default', + fullPath: '/$default', + path: '$default', + options: { + params: { + parse: defaultPriorityParse, + }, + }, + }, + { + id: '/$low', + fullPath: '/$low', + path: '$low', + options: { + params: { + parse: priorityNegativeOneParse, + priority: -1, + }, + }, + }, + { + id: '/$high', + fullPath: '/$high', + path: '$high', + options: { + params: { + parse: priorityOneParse, + priority: 1, + }, + }, + }, + ]), + ) + + expect(findRouteMatch('/123', processedTree)?.route.id).toBe('/$default') + expect(priorityOneParse).toHaveBeenCalledWith({ high: '123' }) + expect(defaultPriorityParse).toHaveBeenCalledWith({ default: '123' }) + expect(priorityNegativeOneParse).toHaveBeenCalledWith({ low: '123' }) + expect(priorityOneParse.mock.invocationCallOrder[0]!).toBeLessThan( + defaultPriorityParse.mock.invocationCallOrder[0]!, + ) + expect(defaultPriorityParse.mock.invocationCallOrder[0]!).toBeLessThan( + priorityNegativeOneParse.mock.invocationCallOrder[0]!, + ) + }) + + it('falls through to the next params.parse route by params.priority', () => { + const lowerPriorityParse = vi.fn((params: Record<string, string>) => { + return params + }) + const higherPriorityParse = vi.fn(() => false) + + const { processedTree } = processRouteTree( + root([ + { + id: '/$number', + fullPath: '/$number', + path: '$number', + options: { + params: { + parse: lowerPriorityParse, + priority: 1, + }, + }, + }, + { + id: '/$uuid', + fullPath: '/$uuid', + path: '$uuid', + options: { + params: { + parse: higherPriorityParse, + priority: 10, + }, + }, + }, + ]), + ) + + expect(findRouteMatch('/42', processedTree)?.route.id).toBe('/$number') + expect(higherPriorityParse).toHaveBeenCalledWith({ uuid: '42' }) + expect(lowerPriorityParse).toHaveBeenCalledWith({ number: '42' }) + expect(higherPriorityParse.mock.invocationCallOrder[0]!).toBeLessThan( + lowerPriorityParse.mock.invocationCallOrder[0]!, + ) + }) + + it('declaration order breaks ties between params.parse routes', () => { + const routeTree = root([ + { + id: '/$a', + fullPath: '/$a', + path: '$a', + options: { + params: { + parse: (params) => params, + }, + }, + }, + { + id: '/$z', + fullPath: '/$z', + path: '$z', + options: { + params: { + parse: (params) => params, + }, + }, + }, + ]) + expect( + findRouteMatch('/123', processRouteTree(routeTree).processedTree)?.route + .id, + ).toBe('/$a') + }) + }) + + describe('regex-like match patterns', () => { + it('matches UUID values before falling back to a slug route', () => { + const uuidRegex = + /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i + const { processedTree } = processRouteTree( + root([ + { + id: '/$uuid', + fullPath: '/$uuid', + path: '$uuid', + options: { + params: { + parse: parseWhen(({ uuid }) => uuidRegex.test(uuid!)), + }, + }, + }, + { + id: '/$slug', + fullPath: '/$slug', + path: '$slug', + }, + ]), + ) + + expect( + findRouteMatch('/550e8400-e29b-41d4-a716-446655440000', processedTree) + ?.route.id, + ).toBe('/$uuid') + expect(findRouteMatch('/my-blog-post', processedTree)?.route.id).toBe( + '/$slug', + ) + }) + + it('matches dates before falling back to a slug route', () => { + const isDate = (date: string | undefined) => { + if (!date) return false + return !Number.isNaN(new Date(date).getTime()) + } + const { processedTree } = processRouteTree( + root([ + { + id: '/posts/$date', + fullPath: '/posts/$date', + path: 'posts/$date', + options: { + params: { + parse: parseWhen(({ date }) => isDate(date)), + }, + }, + }, + { + id: '/posts/$slug', + fullPath: '/posts/$slug', + path: 'posts/$slug', + }, + ]), + ) + + const dateResult = findRouteMatch('/posts/2024-01-15', processedTree) + expect(dateResult?.route.id).toBe('/posts/$date') + expect(dateResult?.rawParams.date).toBe('2024-01-15') + expect( + findRouteMatch('/posts/my-first-post', processedTree)?.route.id, + ).toBe('/posts/$slug') + }) + }) + + describe('nested routes', () => { + it('parent params.parse failure prevents child matching', () => { + const { processedTree } = processRouteTree( + root([ + { + id: '/$orgId', + fullPath: '/$orgId', + path: '$orgId', + options: { + params: { + parse: integerParse('orgId'), + }, + }, + children: [ + { + id: '/$orgId/settings', + fullPath: '/$orgId/settings', + path: 'settings', + }, + ], + }, + { + id: '/$slug/about', + fullPath: '/$slug/about', + path: '$slug/about', + }, + ]), + ) + + expect(findRouteMatch('/123/settings', processedTree)?.route.id).toBe( + '/$orgId/settings', + ) + expect(findRouteMatch('/my-org/about', processedTree)?.route.id).toBe( + '/$slug/about', + ) + expect(findRouteMatch('/my-org/settings', processedTree)).toBeNull() + }) + + it('child params.parse failure falls back to sibling route', () => { + const { processedTree } = processRouteTree( + root([ + { + id: '/users', + fullPath: '/users', + path: 'users', + children: [ + { + id: '/users/$userId', + fullPath: '/users/$userId', + path: '$userId', + options: { + params: { + parse: integerParse('userId'), + }, + }, + }, + { + id: '/users/$username', + fullPath: '/users/$username', + path: '$username', + }, + ], + }, + ]), + ) + + const numericResult = findRouteMatch('/users/42', processedTree) + expect(numericResult?.route.id).toBe('/users/$userId') + expect(numericResult?.rawParams).toEqual({ userId: '42' }) + + const usernameResult = findRouteMatch('/users/johndoe', processedTree) + expect(usernameResult?.route.id).toBe('/users/$username') + expect(usernameResult?.rawParams).toEqual({ username: 'johndoe' }) + }) + }) + + describe('pathless routes', () => { + it('pathless layout with params.parse gates children', () => { + const { processedTree } = processRouteTree( + root([ + { + id: '/', + fullPath: '/', + path: '/', + }, + { + id: '/$foo/_layout', + fullPath: '/$foo', + path: '$foo', + options: { + params: { + parse: integerParse('foo'), + }, + }, + children: [ + { + id: '/$foo/_layout/bar', + fullPath: '/$foo/bar', + path: 'bar', + }, + { + id: '/$foo/_layout/', + fullPath: '/$foo/', + path: '/', + }, + ], + }, + { + id: '/$foo/hello', + fullPath: '/$foo/hello', + path: '$foo/hello', + }, + ]), + ) + + expect(findRouteMatch('/123/bar', processedTree)?.route.id).toBe( + '/$foo/_layout/bar', + ) + const indexResult = findRouteMatch('/123', processedTree) + expect(indexResult?.route.id).toBe('/$foo/_layout/') + expect(indexResult?.rawParams).toEqual({ foo: '123' }) + + expect(findRouteMatch('/abc/hello', processedTree)?.route.id).toBe( + '/$foo/hello', + ) + expect(findRouteMatch('/abc/bar', processedTree)).toBeNull() + }) + }) + + describe('optional params', () => { + it('optional param with static fallback', () => { + const validLangs = ['en', 'es', 'fr', 'de'] + const { processedTree } = processRouteTree( + root([ + { + id: '/{-$lang}/home', + fullPath: '/{-$lang}/home', + path: '{-$lang}/home', + options: { + params: { + parse: parseWhen( + ({ lang }) => !lang || validLangs.includes(lang), + ), + }, + }, + }, + { + id: '/home', + fullPath: '/home', + path: 'home', + }, + ]), + ) + + expect(findRouteMatch('/en/home', processedTree)?.route.id).toBe( + '/{-$lang}/home', + ) + expect(findRouteMatch('/home', processedTree)?.route.id).toBe( + '/{-$lang}/home', + ) + expect(findRouteMatch('/it/home', processedTree)).toBeNull() + }) + + it('optional param at root can match or skip the optional segment', () => { + const validLangs = ['en', 'es', 'fr', 'de'] + const { processedTree } = processRouteTree( + root([ + { + id: '/{-$lang}', + fullPath: '/{-$lang}', + path: '{-$lang}', + options: { + params: { + parse: parseWhen( + ({ lang }) => !lang || validLangs.includes(lang), + ), + }, + }, + }, + ]), + ) + + expect(findRouteMatch('/en', processedTree)?.route.id).toBe('/{-$lang}') + expect(findRouteMatch('/', processedTree)?.route.id).toBe('/{-$lang}') + expect(findRouteMatch('/about', processedTree)).toBeNull() + }) + }) + + describe('wildcard routes', () => { + it('wildcard with params.parse falls back in fuzzy mode', () => { + const { processedTree } = processRouteTree( + root([ + { + id: '/files/$', + fullPath: '/files/$', + path: 'files/$', + options: { + params: { + parse: parseWhen(({ _splat }) => !_splat!.includes('..')), + }, + }, + }, + { + id: '/files', + fullPath: '/files', + path: 'files', + }, + ]), + ) + + expect( + findRouteMatch('/files/docs/readme.txt', processedTree)?.route.id, + ).toBe('/files/$') + + const result = findRouteMatch( + '/files/../../secret/photo.jpg', + processedTree, + true, + ) + expect(result?.route.id).toBe('/files') + expect(result?.rawParams['**']).toBe('../../secret/photo.jpg') + }) + + it('index params.parse failure does not block wildcard sibling', () => { + const { processedTree } = processRouteTree( + root([ + { + id: '/a/', + fullPath: '/a/', + path: 'a/', + options: { + params: { + parse: () => false, + }, + }, + }, + { + id: '/a/$', + fullPath: '/a/$', + path: 'a/$', + }, + ]), + ) + + const result = findRouteMatch('/a', processedTree) + expect(result?.route.id).toBe('/a/$') + expect(result?.rawParams).toEqual({ '*': '', _splat: '' }) + }) + }) +}) diff --git a/packages/router-core/tests/new-process-route-tree.test.ts b/packages/router-core/tests/new-process-route-tree.test.ts index 936df988c1..d93581355e 100644 --- a/packages/router-core/tests/new-process-route-tree.test.ts +++ b/packages/router-core/tests/new-process-route-tree.test.ts @@ -22,6 +22,44 @@ function makeTree(routes: Array<string>) { } describe('findRouteMatch', () => { + describe('routesByPath', () => { + it('uses exact route-template keys while matching duplicate bare aliases by insertion order', () => { + const routeTree = { + id: '__root__', + isRoot: true, + fullPath: '/', + path: '/', + children: [ + { + id: '/$id', + fullPath: '/$id', + path: '$id', + }, + { + id: '/{$id}', + fullPath: '/{$id}', + path: '{$id}', + }, + { + id: '/prefix{$id}', + fullPath: '/prefix{$id}', + path: 'prefix{$id}', + }, + ], + } + + const { processedTree, routesByPath } = processRouteTree(routeTree) + + expect(routesByPath['/$id']?.id).toBe('/$id') + expect(routesByPath['/{$id}']?.id).toBe('/{$id}') + expect(routesByPath['/prefix{$id}']?.id).toBe('/prefix{$id}') + expect(findRouteMatch('/value', processedTree)?.route.id).toBe('/$id') + expect(findRouteMatch('/prefixvalue', processedTree)?.route.id).toBe( + '/prefix{$id}', + ) + }) + }) + describe('priority', () => { describe('basic permutations priorities', () => { it('/static/static vs /static/dynamic', () => { @@ -233,6 +271,64 @@ describe('findRouteMatch', () => { const treeWithIndex = makeTree(['/a/', '/a/{-$b}']) expect(findRouteMatch('/a', treeWithIndex)?.route.id).toBe('/a/') }) + it('optional+static vs static+wildcard', () => { + const tree = makeTree(['/{-$a}/b', '/a/$']) + expect(findRouteMatch('/a/b', tree)?.route.id).toBe('/a/$') + }) + it('dynamic+static vs static+wildcard', () => { + const tree = makeTree(['/$a/b', '/a/$']) + expect(findRouteMatch('/a/b', tree)?.route.id).toBe('/a/$') + }) + it('dynamic+static+static vs static+wildcard', () => { + const tree = makeTree(['/$a/b/c', '/a/$']) + expect(findRouteMatch('/a/b/c', tree)?.route.id).toBe('/a/$') + }) + it('case-insensitive static+wildcard beats optional+static', () => { + const tree = makeTree(['/{-$a}/bar', '/foo/$']) + expect(findRouteMatch('/FOO/bar', tree)?.route.id).toBe('/foo/$') + }) + it('static+optional+static vs static+static+wildcard', () => { + const tree = makeTree(['/a/{-$b}/c', '/a/b/$']) + expect(findRouteMatch('/a/b/c', tree)?.route.id).toBe('/a/b/$') + }) + it('static+optional+static vs static+static+dynamic', () => { + const tree = makeTree(['/a/{-$b}/c/d', '/a/b/c/$d']) + expect(findRouteMatch('/a/b/c/d', tree)?.route.id).toBe('/a/b/c/$d') + }) + it('static+optional+static+static beats static+dynamic+static+optional', () => { + const tree = makeTree(['/a/$b/c/{-$d}', '/a/{-$b}/c/d']) + expect(findRouteMatch('/a/b/c/d', tree)?.route.id).toBe('/a/{-$b}/c/d') + }) + it('static+dynamic+wildcard vs static+optional+static', () => { + const tree = makeTree(['/a/$b/$', '/a/{-$b}/c']) + expect(findRouteMatch('/a/b/c', tree)?.route.id).toBe('/a/{-$b}/c') + }) + it('static+dynamic+static vs static+dynamic+wildcard', () => { + const tree = makeTree(['/a/$b/c', '/a/$b/$']) + expect(findRouteMatch('/a/b/c', tree)?.route.id).toBe('/a/$b/c') + }) + it('prefix+suffix wildcard wins over prefix wildcard and plain wildcard', () => { + const tree = makeTree(['/a/foo{$}bar', '/a/foo{$}', '/a/$']) + expect(findRouteMatch('/a/fooxbar', tree)?.route.id).toBe( + '/a/foo{$}bar', + ) + }) + it('skipped optional keeps later static priority over wildcard', () => { + const tree = makeTree(['/{-$a}/b/c', '/b/$']) + expect(findRouteMatch('/b/c', tree)?.route.id).toBe('/{-$a}/b/c') + }) + it('skipped optional aligns later static priority with wildcard siblings', () => { + const tree = makeTree(['/{-$a}/b/{-$c}/d', '/b/c/$']) + expect(findRouteMatch('/b/c/d', tree)?.route.id).toBe('/b/c/$') + }) + it('optional child wins over empty wildcard at the same node', () => { + const tree = makeTree(['/a/{-$b}', '/a/$']) + expect(findRouteMatch('/a', tree)?.route.id).toBe('/a/{-$b}') + }) + it('optional+static vs static+optional', () => { + const tree = makeTree(['/{-$a}/b', '/a/{-$b}']) + expect(findRouteMatch('/a/b', tree)?.route.id).toBe('/a/{-$b}') + }) }) }) @@ -776,6 +872,77 @@ describe('findRouteMatch', () => { const actualMatch = findRouteMatch('/dashboard', processed.processedTree) expect(actualMatch?.route.id).toBe('/dashboard/') }) + + it('uses an exact wildcard match instead of a fuzzy layout match', () => { + const tree = makeTree(['/a', '/a/$']) + const match = findRouteMatch('/a/b/c', tree, true) + expect(match?.route.id).toBe('/a/$') + expect(match?.rawParams).toEqual({ '*': 'b/c', _splat: 'b/c' }) + }) + + it('falls back to fuzzy layout matching when wildcard params.parse returns false', () => { + const tree = { + id: '__root__', + fullPath: '/', + path: '/', + isRoot: true, + options: {}, + children: [ + { + id: '/a', + fullPath: '/a', + path: 'a', + }, + { + id: '/a/$', + fullPath: '/a/$', + path: 'a/$', + options: { + params: { + parse: () => { + return false + }, + }, + }, + }, + ], + } + const { processedTree } = processRouteTree(tree) + const match = findRouteMatch('/a/b/c', processedTree, true) + expect(match?.route.id).toBe('/a') + expect(match?.rawParams).toEqual({ '**': 'b/c' }) + }) + + it('falls back to exact layout matching when empty wildcard params.parse returns false', () => { + const tree = { + id: '__root__', + fullPath: '/', + path: '/', + isRoot: true, + options: {}, + children: [ + { + id: '/a', + fullPath: '/a', + path: 'a', + }, + { + id: '/a/$', + fullPath: '/a/$', + path: 'a/$', + options: { + params: { + parse: () => { + return false + }, + }, + }, + }, + ], + } + const { processedTree } = processRouteTree(tree) + expect(findRouteMatch('/a', processedTree)?.route.id).toBe('/a') + }) }) describe('param extraction', () => { @@ -886,9 +1053,299 @@ describe('findRouteMatch', () => { expect(result?.route.id).toBe('/{-$foo}/bar/$') expect(result?.rawParams).toEqual({ '*': 'rest', _splat: 'rest' }) }) + it('validates a stacked wildcard route once', () => { + let calls = 0 + const tree = { + id: '__root__', + fullPath: '/', + path: '/', + isRoot: true, + options: {}, + children: [ + { + id: '/a/$', + fullPath: '/a/$', + path: 'a/$', + isRoot: false, + options: { + params: { + parse: (params: Record<string, string>) => { + calls++ + return params + }, + }, + }, + }, + ], + } + const { processedTree } = processRouteTree(tree) + const result = findRouteMatch('/a/rest', processedTree) + expect(result?.route.id).toBe('/a/$') + expect(result?.rawParams).toEqual({ '*': 'rest', _splat: 'rest' }) + expect(calls).toBe(1) + }) + it('can fall back to a lower-priority wildcard when wildcard params.parse returns false', () => { + const tree = { + id: '__root__', + fullPath: '/', + path: '/', + isRoot: true, + options: {}, + children: [ + { + id: '/a/foo{$}', + fullPath: '/a/foo{$}', + path: 'a/foo{$}', + isRoot: false, + options: { + params: { + parse: () => { + return false + }, + }, + }, + }, + { + id: '/a/$', + fullPath: '/a/$', + path: 'a/$', + isRoot: false, + options: {}, + }, + ], + } + const { processedTree } = processRouteTree(tree) + const result = findRouteMatch('/a/foobar', processedTree) + expect(result?.route.id).toBe('/a/$') + expect(result?.rawParams).toEqual({ '*': 'foobar', _splat: 'foobar' }) + }) + it('falls back to the next matching wildcard by priority when the best wildcard params.parse returns false', () => { + const tree = { + id: '__root__', + fullPath: '/', + path: '/', + isRoot: true, + options: {}, + children: [ + { + id: '/a/foo{$}bar', + fullPath: '/a/foo{$}bar', + path: 'a/foo{$}bar', + isRoot: false, + options: { + params: { + parse: () => { + return false + }, + }, + }, + }, + { + id: '/a/foo{$}', + fullPath: '/a/foo{$}', + path: 'a/foo{$}', + isRoot: false, + options: {}, + }, + { + id: '/a/$', + fullPath: '/a/$', + path: 'a/$', + isRoot: false, + options: {}, + }, + ], + } + const { processedTree } = processRouteTree(tree) + const result = findRouteMatch('/a/fooxbar', processedTree) + expect(result?.route.id).toBe('/a/foo{$}') + expect(result?.rawParams).toEqual({ '*': 'xbar', _splat: 'xbar' }) + }) + it('does not validate a lower-priority wildcard after a better wildcard matches', () => { + let higherPriorityCalls = 0 + let lowerPriorityCalls = 0 + const tree = { + id: '__root__', + fullPath: '/', + path: '/', + isRoot: true, + options: {}, + children: [ + { + id: '/a/foo{$}', + fullPath: '/a/foo{$}', + path: 'a/foo{$}', + isRoot: false, + options: { + params: { + parse: (params: Record<string, string>) => { + higherPriorityCalls++ + return params + }, + }, + }, + }, + { + id: '/a/$', + fullPath: '/a/$', + path: 'a/$', + isRoot: false, + options: { + params: { + parse: (params: Record<string, string>) => { + lowerPriorityCalls++ + return params + }, + }, + }, + }, + ], + } + const { processedTree } = processRouteTree(tree) + const result = findRouteMatch('/a/foobar', processedTree) + expect(result?.route.id).toBe('/a/foo{$}') + expect(result?.rawParams).toEqual({ '*': 'bar', _splat: 'bar' }) + expect(higherPriorityCalls).toBe(1) + expect(lowerPriorityCalls).toBe(0) + }) + it('does not validate wildcard fallback after a static sibling matches', () => { + let calls = 0 + const tree = { + id: '__root__', + fullPath: '/', + path: '/', + isRoot: true, + options: {}, + children: [ + { + id: '/a/b', + fullPath: '/a/b', + path: 'a/b', + isRoot: false, + options: {}, + }, + { + id: '/a/$', + fullPath: '/a/$', + path: 'a/$', + isRoot: false, + options: { + params: { + parse: (params: Record<string, string>) => { + calls++ + return params + }, + }, + }, + }, + ], + } + const { processedTree } = processRouteTree(tree) + const result = findRouteMatch('/a/b', processedTree) + expect(result?.route.id).toBe('/a/b') + expect(calls).toBe(0) + }) + it('does not validate empty wildcard fallback after an index sibling matches', () => { + let calls = 0 + const tree = { + id: '__root__', + fullPath: '/', + path: '/', + isRoot: true, + options: {}, + children: [ + { + id: '/a/', + fullPath: '/a/', + path: 'a/', + isRoot: false, + options: {}, + }, + { + id: '/a/$', + fullPath: '/a/$', + path: 'a/$', + isRoot: false, + options: { + params: { + parse: (params: Record<string, string>) => { + calls++ + return params + }, + }, + }, + }, + ], + } + const { processedTree } = processRouteTree(tree) + const result = findRouteMatch('/a', processedTree) + expect(result?.route.id).toBe('/a/') + expect(calls).toBe(0) + }) + it('passes wildcard raw params to params.parse', () => { + let parsedParams: Record<string, string> | undefined + const tree = { + id: '__root__', + fullPath: '/', + path: '/', + isRoot: true, + options: {}, + children: [ + { + id: '/a/$', + fullPath: '/a/$', + path: 'a/$', + isRoot: false, + options: { + params: { + parse: (params: Record<string, string>) => { + parsedParams = params + return { length: params._splat!.length } + }, + }, + }, + }, + ], + } + const { processedTree } = processRouteTree(tree) + const result = findRouteMatch('/a/foo/bar', processedTree) + expect(result?.route.id).toBe('/a/$') + expect(result?.rawParams).toEqual({ '*': 'foo/bar', _splat: 'foo/bar' }) + expect(parsedParams).toEqual({ '*': 'foo/bar', _splat: 'foo/bar' }) + }) }) }) describe('pathless routes', () => { + it('pathless nodes do not shift positional priority scores', () => { + const tree = { + id: '__root__', + fullPath: '/', + path: '/', + isRoot: true, + children: [ + { + id: '/_layout', + fullPath: '/', + children: [ + { + id: '/_layout/a/b', + fullPath: '/a/b', + path: 'a/b', + }, + ], + }, + { + id: '/a/$', + fullPath: '/a/$', + path: 'a/$', + }, + ], + } + const { processedTree } = processRouteTree(tree) + expect(findRouteMatch('/a/b', processedTree)?.route.id).toBe( + '/_layout/a/b', + ) + }) it('builds segment tree correctly', () => { const tree = { path: '/', @@ -907,10 +1364,7 @@ describe('findRouteMatch', () => { path: '$foo', fullPath: '/$foo', options: { - params: { parse: () => {} }, - skipRouteOnParseError: { - params: true, - }, + params: { parse: (params: Record<string, string>) => params }, }, children: [ { @@ -950,7 +1404,6 @@ describe('findRouteMatch', () => { "optional": null, "parent": [Circular], "parse": null, - "parsingPriority": 0, "pathless": [ { "depth": 2, @@ -965,15 +1418,14 @@ describe('findRouteMatch', () => { "optional": null, "parent": [Circular], "parse": null, - "parsingPriority": 0, "pathless": null, + "priority": 0, "route": { "fullPath": "/$foo/", "id": "/$foo/_layout/", "options": {}, "path": "/", }, - "skipOnParamError": false, "static": null, "staticInsensitive": null, "wildcard": null, @@ -982,8 +1434,8 @@ describe('findRouteMatch', () => { "optional": null, "parent": [Circular], "parse": [Function], - "parsingPriority": 0, "pathless": null, + "priority": 0, "route": { "children": [ { @@ -1005,13 +1457,9 @@ describe('findRouteMatch', () => { "params": { "parse": [Function], }, - "skipRouteOnParseError": { - "params": true, - }, }, "path": "$foo", }, - "skipOnParamError": true, "static": null, "staticInsensitive": Map { "bar" => { @@ -1023,15 +1471,14 @@ describe('findRouteMatch', () => { "optional": null, "parent": [Circular], "parse": null, - "parsingPriority": 0, "pathless": null, + "priority": 0, "route": { "fullPath": "/$foo/bar", "id": "/$foo/_layout/bar", "options": {}, "path": "bar", }, - "skipOnParamError": false, "static": null, "staticInsensitive": null, "wildcard": null, @@ -1041,8 +1488,8 @@ describe('findRouteMatch', () => { }, ], "prefix": undefined, + "priority": 0, "route": null, - "skipOnParamError": false, "static": null, "staticInsensitive": Map { "hello" => { @@ -1054,15 +1501,14 @@ describe('findRouteMatch', () => { "optional": null, "parent": [Circular], "parse": null, - "parsingPriority": 0, "pathless": null, + "priority": 0, "route": { "fullPath": "/$foo/hello", "id": "/$foo/hello", "options": {}, "path": "$foo/hello", }, - "skipOnParamError": false, "static": null, "staticInsensitive": null, "wildcard": null, @@ -1082,15 +1528,14 @@ describe('findRouteMatch', () => { "optional": null, "parent": [Circular], "parse": null, - "parsingPriority": 0, "pathless": null, + "priority": 0, "route": { "fullPath": "/", "id": "/", "options": {}, "path": "/", }, - "skipOnParamError": false, "static": null, "staticInsensitive": null, "wildcard": null, @@ -1099,10 +1544,9 @@ describe('findRouteMatch', () => { "optional": null, "parent": null, "parse": null, - "parsingPriority": 0, "pathless": null, + "priority": 0, "route": null, - "skipOnParamError": false, "static": null, "staticInsensitive": null, "wildcard": null, @@ -1125,7 +1569,6 @@ describe('findRouteMatch', () => { parse: (params: Record<string, string>) => params, }, // force the creation of a pathless node - skipRouteOnParseError: { params: true }, }, children: [ { @@ -1159,7 +1602,6 @@ describe('findRouteMatch', () => { parse: (params: Record<string, string>) => params, }, // force the creation of a pathless node - skipRouteOnParseError: { params: true }, }, children: [ { diff --git a/packages/router-core/tests/path.test.ts b/packages/router-core/tests/path.test.ts index 1eab00f04f..4e49412209 100644 --- a/packages/router-core/tests/path.test.ts +++ b/packages/router-core/tests/path.test.ts @@ -15,6 +15,7 @@ import { parseSegment, processRouteTree, } from '../src/new-process-route-tree' +import { createLRUCache } from '../src/lru-cache' import type { SegmentKind } from '../src/new-process-route-tree' describe.each([{ basepath: '/' }, { basepath: '/app' }, { basepath: '/app/' }])( @@ -240,6 +241,29 @@ describe('resolvePath', () => { }) }, ) + + it('preserves explicit route-template param syntax', () => { + expect( + resolvePath({ + base: '/{$language}', + to: '.', + }), + ).toBe('/{$language}') + + expect( + resolvePath({ + base: '/{$language}/posts', + to: '../{$language}', + }), + ).toBe('/{$language}/{$language}') + }) + + it('caches route-template paths without changing param syntax', () => { + const cache = createLRUCache<string, string>(10) + + expect(resolvePath({ base: '/', to: '/{$id}', cache })).toBe('/{$id}') + expect(resolvePath({ base: '/', to: '/$id', cache })).toBe('/$id') + }) }) describe.each([{ server: true }, { server: false }])( @@ -687,7 +711,7 @@ describe('matchPathname', () => { expectedMatchedParams: { id: '123' }, }, { - name: 'should match and return the the splat param', + name: 'should match and return the splat param', input: '/users/123', matchingOptions: { to: '/users/$', diff --git a/packages/router-core/tests/rewrite.test.ts b/packages/router-core/tests/rewrite.test.ts new file mode 100644 index 0000000000..c5ca2e9428 --- /dev/null +++ b/packages/router-core/tests/rewrite.test.ts @@ -0,0 +1,72 @@ +import { describe, expect, test } from 'vitest' +import { + composeRewrites, + executeRewriteInput, + executeRewriteOutput, + rewriteBasepath, +} from '../src/rewrite' +import type { LocationRewrite } from '../src' + +describe('rewrite helpers', () => { + test('basepath rewrite strips input and restores output', () => { + const rewrite = rewriteBasepath({ basepath: '/app/' }) + const inputUrl = new URL('https://example.com/app/posts') + + expect(executeRewriteInput(rewrite, inputUrl).pathname).toBe('/posts') + + const outputUrl = new URL('https://example.com/posts') + expect(executeRewriteOutput(rewrite, outputUrl).pathname).toBe('/app/posts') + }) + + test('basepath rewrite handles root output', () => { + const rewrite = rewriteBasepath({ basepath: '/app' }) + const url = new URL('https://example.com/') + + expect(executeRewriteOutput(rewrite, url).pathname).toBe('/app/') + }) + + test('case-insensitive basepath input preserves original suffix casing', () => { + const rewrite = rewriteBasepath({ basepath: '/App' }) + const url = new URL('https://example.com/app/Users') + + expect(executeRewriteInput(rewrite, url).pathname).toBe('/Users') + }) + + test('composeRewrites applies input forward and output backward', () => { + const calls: Array<string> = [] + const first: LocationRewrite = { + input: ({ url }) => { + calls.push('first-in') + url.pathname += 'a' + return url + }, + output: ({ url }) => { + calls.push('first-out') + url.pathname += 'd' + return url + }, + } + const second: LocationRewrite = { + input: ({ url }) => { + calls.push('second-in') + url.pathname += 'b' + return url + }, + output: ({ url }) => { + calls.push('second-out') + url.pathname += 'c' + return url + }, + } + + const rewrite = composeRewrites([first, second]) + + expect( + executeRewriteInput(rewrite, new URL('https://example.com/')).pathname, + ).toBe('/ab') + expect( + executeRewriteOutput(rewrite, new URL('https://example.com/')).pathname, + ).toBe('/cd') + expect(calls).toEqual(['first-in', 'second-in', 'second-out', 'first-out']) + }) +}) diff --git a/packages/router-core/tests/routerTestUtils.ts b/packages/router-core/tests/routerTestUtils.ts index f1c2ac40ad..b71c54e347 100644 --- a/packages/router-core/tests/routerTestUtils.ts +++ b/packages/router-core/tests/routerTestUtils.ts @@ -1,4 +1,4 @@ -import { batch, createStore } from '@tanstack/store' +import { batch, createAtom } from '@tanstack/store' import { isServer } from '@tanstack/router-core/isServer' import { RouterCore, @@ -23,8 +23,8 @@ const getStoreConfig: GetStoreConfig = (opts) => { } return { - createMutableStore: createStore, - createReadonlyStore: createStore, + createMutableStore: createAtom, + createReadonlyStore: createAtom, batch, } } diff --git a/packages/router-core/tests/scroll-restoration-script.test.ts b/packages/router-core/tests/scroll-restoration-script.test.ts new file mode 100644 index 0000000000..ed1f151562 --- /dev/null +++ b/packages/router-core/tests/scroll-restoration-script.test.ts @@ -0,0 +1,155 @@ +import { createMemoryHistory } from '@tanstack/history' +import { afterEach, describe, expect, test, vi } from 'vitest' +import { getScrollRestorationScriptForRouter } from '../src/scroll-restoration-script/server' +import { BaseRootRoute, BaseRoute, storageKey } from '../src' +import { createTestRouter } from './routerTestUtils' + +function createScrollRestorationRouter(getScrollRestorationKey?: () => string) { + const rootRoute = new BaseRootRoute({}) + const indexRoute = new BaseRoute({ + getParentRoute: () => rootRoute, + path: '/', + }) + + return createTestRouter({ + routeTree: rootRoute.addChildren([indexRoute]), + history: createMemoryHistory({ initialEntries: ['/'] }), + isServer: true, + scrollRestoration: true, + getScrollRestorationKey, + }) +} + +function runScrollRestorationScript(script: string | null) { + expect(script).toBeTruthy() + new Function(script!)() +} + +afterEach(() => { + window.sessionStorage.clear() + window.history.replaceState({}, '', '/') + vi.unstubAllGlobals() +}) + +describe('getScrollRestorationScriptForRouter', () => { + test('restores SSR scroll entries for a user supplied key', () => { + const router = createScrollRestorationRouter(() => 'custom-key') + const script = getScrollRestorationScriptForRouter(router) + const scrollTo = vi.fn() + + window.history.replaceState({ __TSR_key: 'history-key' }, '', '/') + window.sessionStorage.setItem( + storageKey, + JSON.stringify({ + 'custom-key': { + window: { scrollX: 11, scrollY: 22 }, + }, + 'history-key': { + window: { scrollX: 33, scrollY: 44 }, + }, + }), + ) + + vi.stubGlobal('scrollTo', scrollTo) + + runScrollRestorationScript(script) + + expect(scrollTo).toHaveBeenCalledWith(11, 22) + }) + + test('restores SSR scroll entries for the default history key', () => { + const router = createScrollRestorationRouter() + const script = getScrollRestorationScriptForRouter(router) + const scrollTo = vi.fn() + + window.history.replaceState({ __TSR_key: 'history-key' }, '', '/') + window.sessionStorage.setItem( + storageKey, + JSON.stringify({ + 'history-key': { + window: { scrollX: 33, scrollY: 44 }, + }, + '/': { + window: { scrollX: 11, scrollY: 22 }, + }, + }), + ) + + vi.stubGlobal('scrollTo', scrollTo) + + runScrollRestorationScript(script) + + expect(scrollTo).toHaveBeenCalledWith(33, 44) + }) + + test('ignores invalid serialized scroll storage', () => { + const router = createScrollRestorationRouter() + const script = getScrollRestorationScriptForRouter(router) + const scrollTo = vi.fn() + + window.history.replaceState({ __TSR_key: 'history-key' }, '', '/') + window.sessionStorage.setItem(storageKey, '{') + vi.stubGlobal('scrollTo', scrollTo) + + expect(() => runScrollRestorationScript(script)).not.toThrow() + expect(scrollTo).not.toHaveBeenCalled() + }) + + test('ignores malformed scroll entries and falls back to top', () => { + const router = createScrollRestorationRouter() + const script = getScrollRestorationScriptForRouter(router) + const scrollTo = vi.fn() + + window.history.replaceState({ __TSR_key: 'history-key' }, '', '/') + window.sessionStorage.setItem( + storageKey, + JSON.stringify({ + 'history-key': { + window: { scrollX: 'bad', scrollY: 44 }, + '[': { scrollX: 11, scrollY: 22 }, + empty: null, + }, + }), + ) + vi.stubGlobal('scrollTo', scrollTo) + + expect(() => runScrollRestorationScript(script)).not.toThrow() + expect(scrollTo).toHaveBeenCalledWith(0, 0) + }) + + test('ignores a malformed restoration key payload and falls back to top', () => { + const router = createScrollRestorationRouter() + const script = getScrollRestorationScriptForRouter(router) + const scrollTo = vi.fn() + + window.history.replaceState({ __TSR_key: 'history-key' }, '', '/') + window.sessionStorage.setItem( + storageKey, + JSON.stringify({ + 'history-key': 'not an entry object', + }), + ) + vi.stubGlobal('scrollTo', scrollTo) + + expect(() => runScrollRestorationScript(script)).not.toThrow() + expect(scrollTo).toHaveBeenCalledWith(0, 0) + }) + + test('falls back safely when restoration key is missing from storage', () => { + const router = createScrollRestorationRouter() + const script = getScrollRestorationScriptForRouter(router) + const scrollTo = vi.fn() + + window.history.replaceState({ __TSR_key: 'history-key' }, '', '/') + window.sessionStorage.setItem( + storageKey, + JSON.stringify({ + 'other-key': { window: { scrollX: 1, scrollY: 2 } }, + }), + ) + vi.stubGlobal('scrollTo', scrollTo) + + expect(() => runScrollRestorationScript(script)).not.toThrow() + expect(scrollTo).toHaveBeenCalledWith(0, 0) + }) +}) diff --git a/packages/router-core/tests/serializer-recursion.test-d.ts b/packages/router-core/tests/serializer-recursion.test-d.ts index 4df82d5b73..a688ed3b4a 100644 --- a/packages/router-core/tests/serializer-recursion.test-d.ts +++ b/packages/router-core/tests/serializer-recursion.test-d.ts @@ -3,7 +3,6 @@ import { describe, expectTypeOf, it } from 'vitest' import type { Serializable, ValidateSerializable, - ValidateSerializableResult, } from '../src/ssr/serializer/transformer' describe('ValidateSerializable array handling', () => { @@ -51,30 +50,4 @@ describe('ValidateSerializable array handling', () => { ValidateSerializable<InputStream, Serializable> >().branded.toEqualTypeOf<InputStream>() }) - - it('should preserve recursive payload without infinite expansion', () => { - type Result = Array<Result> | { [key: string]: Result } - expectTypeOf< - ValidateSerializableResult<Result, Serializable> - >().branded.toEqualTypeOf<Result>() - }) - - it('should preserve recursive tuples without infinite expansion', () => { - type ResultTuple = readonly [ - ReadonlyArray<ResultTuple>, - { [key: string]: ResultTuple }, - ] - expectTypeOf< - ValidateSerializableResult<ResultTuple, Serializable> - >().branded.toEqualTypeOf<ResultTuple>() - }) - - it('should preserve readonly recursive arrays without infinite expansion', () => { - type ResultReadonlyArray = ReadonlyArray< - ResultReadonlyArray | { [key: string]: ResultReadonlyArray } - > - expectTypeOf< - ValidateSerializableResult<ResultReadonlyArray, Serializable> - >().branded.toEqualTypeOf<ResultReadonlyArray>() - }) }) diff --git a/packages/router-core/tests/serializer.test-d.ts b/packages/router-core/tests/serializer.test-d.ts index 4fd2c69faa..5ef3e3964b 100644 --- a/packages/router-core/tests/serializer.test-d.ts +++ b/packages/router-core/tests/serializer.test-d.ts @@ -1,68 +1,18 @@ import { describe, expectTypeOf, it } from 'vitest' -import { +import type { Serializable, + SerializationError, TsrSerializable, ValidateSerializable, - ValidateSerializableResult, } from '../src/ssr/serializer/transformer' describe('Serializer', () => { - describe('Default types are serializable: $name', () => { - it('string', () => { - const value: string = 'hello' - expectTypeOf< - ValidateSerializableResult<typeof value, Serializable> - >().toBeString() - }) - it('number', () => { - const value: number = 123 - - expectTypeOf< - ValidateSerializableResult<typeof value, Serializable> - >().toBeNumber() - }) - it('boolean', () => { - const value: boolean = true - - expectTypeOf< - ValidateSerializableResult<typeof value, Serializable> - >().toBeBoolean() - }) - it('null', () => { - const value = null - - expectTypeOf< - ValidateSerializableResult<typeof value, Serializable> - >().toBeNull() - }) - it('undefined', () => { - const value = undefined - - expectTypeOf< - ValidateSerializableResult<typeof value, Serializable> - >().toBeUndefined() - }) - it('bigint', () => { - const value = BigInt(123) - - expectTypeOf< - ValidateSerializableResult<typeof value, Serializable> - >().toBeBigInt() - }) - it('Date', () => { - const value = new Date() - - expectTypeOf< - ValidateSerializableResult<typeof value, Serializable> - >().toEqualTypeOf<Date>() - }) - }) it('fails for non-serializable types', () => { const value = () => {} expectTypeOf< ValidateSerializable<typeof value, Serializable> - >().toEqualTypeOf<'Function is not serializable'>() + >().toEqualTypeOf<SerializationError<'Function may not be serializable'>>() }) it('works for types extending TsrSerializable', () => { diff --git a/packages/router-core/tests/skip-route-on-parse-error.test.ts b/packages/router-core/tests/skip-route-on-parse-error.test.ts deleted file mode 100644 index 433ecc6b9a..0000000000 --- a/packages/router-core/tests/skip-route-on-parse-error.test.ts +++ /dev/null @@ -1,890 +0,0 @@ -import { describe, expect, it, vi } from 'vitest' -import { findRouteMatch, processRouteTree } from '../src/new-process-route-tree' - -describe('skipRouteOnParseError', () => { - describe('basic matching with parse validation', () => { - it('matches route when parse succeeds', () => { - const tree = { - id: '__root__', - isRoot: true, - fullPath: '/', - path: '/', - children: [ - { - id: '/$id', - fullPath: '/$id', - path: '$id', - options: { - params: { - parse: (params: Record<string, string>) => ({ - id: parseInt(params.id!, 10), - }), - }, - skipRouteOnParseError: { params: true }, - }, - }, - ], - } - const { processedTree } = processRouteTree(tree) - const result = findRouteMatch('/123', processedTree) - expect(result?.route.id).toBe('/$id') - // params contains raw string values for interpolatePath - expect(result?.rawParams).toEqual({ id: '123' }) - // parsedParams contains the transformed values from parse - expect(result?.parsedParams).toEqual({ id: 123 }) - }) - - it('skips route when parse throws and finds no alternative', () => { - const tree = { - id: '__root__', - isRoot: true, - fullPath: '/', - path: '/', - children: [ - { - id: '/$id', - fullPath: '/$id', - path: '$id', - options: { - params: { - parse: (params: Record<string, string>) => { - const num = parseInt(params.id!, 10) - if (isNaN(num)) throw new Error('Not a number') - return { id: num } - }, - }, - skipRouteOnParseError: { params: true }, - }, - }, - ], - } - const { processedTree } = processRouteTree(tree) - const result = findRouteMatch('/abc', processedTree) - expect(result).toBeNull() - }) - - it('skips route when parse throws and finds alternative match', () => { - const tree = { - id: '__root__', - isRoot: true, - fullPath: '/', - path: '/', - children: [ - { - id: '/$id', - fullPath: '/$id', - path: '$id', - options: { - params: { - parse: (params: Record<string, string>) => { - const num = parseInt(params.id!, 10) - if (isNaN(num)) throw new Error('Not a number') - return { id: num } - }, - }, - skipRouteOnParseError: { params: true }, - }, - }, - { - id: '/$slug', - fullPath: '/$slug', - path: '$slug', - options: {}, - }, - ], - } - const { processedTree } = processRouteTree(tree) - // numeric should match the validated route - const numericResult = findRouteMatch('/123', processedTree) - expect(numericResult?.route.id).toBe('/$id') - // params contains raw string values for interpolatePath - expect(numericResult?.rawParams).toEqual({ id: '123' }) - // parsedParams contains the transformed values from parse - expect(numericResult?.parsedParams).toEqual({ id: 123 }) - - // non-numeric should fall through to the non-validated route - const slugResult = findRouteMatch('/hello-world', processedTree) - expect(slugResult?.route.id).toBe('/$slug') - expect(slugResult?.rawParams).toEqual({ slug: 'hello-world' }) - }) - }) - - describe('priority: validated routes take precedence', () => { - it('validated dynamic route has priority over non-validated dynamic route', () => { - const tree = { - id: '__root__', - isRoot: true, - fullPath: '/', - path: '/', - children: [ - { - id: '/$slug', - fullPath: '/$slug', - path: '$slug', - options: {}, - }, - { - id: '/$id', - fullPath: '/$id', - path: '$id', - options: { - params: { - parse: (params: Record<string, string>) => { - const num = parseInt(params.id!, 10) - if (isNaN(num)) throw new Error('Not a number') - return { id: num } - }, - }, - skipRouteOnParseError: { params: true }, - }, - }, - ], - } - const { processedTree } = processRouteTree(tree) - // validated route should be tried first - const numericResult = findRouteMatch('/123', processedTree) - expect(numericResult?.route.id).toBe('/$id') - }) - - it('static route still has priority over validated dynamic route', () => { - const tree = { - id: '__root__', - isRoot: true, - fullPath: '/', - path: '/', - children: [ - { - id: '/settings', - fullPath: '/settings', - path: 'settings', - options: {}, - }, - { - id: '/$id', - fullPath: '/$id', - path: '$id', - options: { - params: { - parse: (params: Record<string, string>) => { - const num = parseInt(params.id!, 10) - if (isNaN(num)) throw new Error('Not a number') - return { id: num } - }, - }, - skipRouteOnParseError: { params: true }, - }, - }, - ], - } - const { processedTree } = processRouteTree(tree) - const result = findRouteMatch('/settings', processedTree) - expect(result?.route.id).toBe('/settings') - }) - - it('deep validated route can still fallback to sibling', () => { - const tree = { - id: '__root__', - isRoot: true, - fullPath: '/', - children: [ - { - id: '/$a/$b/$c', - fullPath: '/$a/$b/$c', - path: '$a/$b/$c', - options: { - params: { - parse: (params: Record<string, string>) => { - // if (params.a !== 'one') throw new Error('Invalid a') - // if (params.b !== 'two') throw new Error('Invalid b') - if (params.c !== 'three') throw new Error('Invalid c') - return params - }, - }, - skipRouteOnParseError: { params: true }, - }, - }, - { - id: '/$x/$y/$z', - fullPath: '/$x/$y/$z', - path: '$x/$y/$z', - }, - ], - } - const { processedTree } = processRouteTree(tree) - { - const result = findRouteMatch('/one/two/three', processedTree) - expect(result?.route.id).toBe('/$a/$b/$c') - } - { - const result = findRouteMatch('/one/two/wrong', processedTree) - expect(result?.route.id).toBe('/$x/$y/$z') - } - }) - }) - - describe('regex-like validation patterns', () => { - it('uuid validation pattern', () => { - const uuidRegex = - /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i - const tree = { - id: '__root__', - isRoot: true, - fullPath: '/', - path: '/', - children: [ - { - id: '/$uuid', - fullPath: '/$uuid', - path: '$uuid', - options: { - params: { - parse: (params: Record<string, string>) => { - if (!uuidRegex.test(params.uuid!)) - throw new Error('Not a UUID') - return params - }, - }, - skipRouteOnParseError: { params: true }, - }, - }, - { - id: '/$slug', - fullPath: '/$slug', - path: '$slug', - options: {}, - }, - ], - } - const { processedTree } = processRouteTree(tree) - - const uuidResult = findRouteMatch( - '/550e8400-e29b-41d4-a716-446655440000', - processedTree, - ) - expect(uuidResult?.route.id).toBe('/$uuid') - - const slugResult = findRouteMatch('/my-blog-post', processedTree) - expect(slugResult?.route.id).toBe('/$slug') - }) - - it('date validation pattern (YYYY-MM-DD)', () => { - const tree = { - id: '__root__', - isRoot: true, - fullPath: '/', - path: '/', - children: [ - { - id: '/posts/$date', - fullPath: '/posts/$date', - path: 'posts/$date', - options: { - params: { - parse: (params: Record<string, string>) => { - const date = new Date(params.date!) - if (date.toString() === 'Invalid Date') - throw new Error('Not a date') - return { date } - }, - }, - skipRouteOnParseError: { params: true }, - }, - }, - { - id: '/posts/$slug', - fullPath: '/posts/$slug', - path: 'posts/$slug', - options: {}, - }, - ], - } - const { processedTree } = processRouteTree(tree) - - const dateResult = findRouteMatch('/posts/2024-01-15', processedTree) - expect(dateResult?.route.id).toBe('/posts/$date') - // params contains raw string values for interpolatePath - expect(dateResult?.rawParams.date).toBe('2024-01-15') - // parsedParams contains the transformed values from parse - expect(dateResult?.parsedParams?.date).toBeInstanceOf(Date) - - const slugResult = findRouteMatch('/posts/my-first-post', processedTree) - expect(slugResult?.route.id).toBe('/posts/$slug') - }) - }) - - describe('nested routes with skipRouteOnParseError', () => { - it('parent validation failure prevents child matching', () => { - const tree = { - id: '__root__', - isRoot: true, - fullPath: '/', - path: '/', - children: [ - { - id: '/$orgId', - fullPath: '/$orgId', - path: '$orgId', - options: { - params: { - parse: (params: Record<string, string>) => { - const num = parseInt(params.orgId!, 10) - if (isNaN(num)) throw new Error('Not a number') - return { orgId: num } - }, - }, - skipRouteOnParseError: { params: true }, - }, - children: [ - { - id: '/$orgId/settings', - fullPath: '/$orgId/settings', - path: 'settings', - options: {}, - }, - ], - }, - { - id: '/$slug/about', - fullPath: '/$slug/about', - path: '$slug/about', - options: {}, - }, - ], - } - const { processedTree } = processRouteTree(tree) - - // numeric org should match the validated route - const numericResult = findRouteMatch('/123/settings', processedTree) - expect(numericResult?.route.id).toBe('/$orgId/settings') - - // non-numeric should not match /$orgId/settings, should match /$slug/about - const slugResult = findRouteMatch('/my-org/about', processedTree) - expect(slugResult?.route.id).toBe('/$slug/about') - }) - - it('child validation failure falls back to sibling', () => { - const tree = { - id: '__root__', - isRoot: true, - fullPath: '/', - path: '/', - children: [ - { - id: '/users', - fullPath: '/users', - path: 'users', - options: {}, - children: [ - { - id: '/users/$userId', - fullPath: '/users/$userId', - path: '$userId', - options: { - params: { - parse: (params: Record<string, string>) => { - const num = parseInt(params.userId!, 10) - if (isNaN(num)) throw new Error('Not a number') - return { userId: num } - }, - }, - skipRouteOnParseError: { params: true }, - }, - }, - { - id: '/users/$username', - fullPath: '/users/$username', - path: '$username', - options: {}, - }, - ], - }, - ], - } - const { processedTree } = processRouteTree(tree) - - const numericResult = findRouteMatch('/users/42', processedTree) - expect(numericResult?.route.id).toBe('/users/$userId') - // params contains raw string values for interpolatePath - expect(numericResult?.rawParams).toEqual({ userId: '42' }) - // parsedParams contains the transformed values from parse - expect(numericResult?.parsedParams).toEqual({ userId: 42 }) - - const usernameResult = findRouteMatch('/users/johndoe', processedTree) - expect(usernameResult?.route.id).toBe('/users/$username') - // Non-validated route: params are raw strings, parsedParams is undefined - expect(usernameResult?.rawParams).toEqual({ username: 'johndoe' }) - expect(usernameResult?.parsedParams).toBeUndefined() - }) - }) - - describe('pathless routes with skipRouteOnParseError', () => { - // Pathless layouts with skipRouteOnParseError should gate their children - it('pathless layout with validation gates children', () => { - const tree = { - id: '__root__', - isRoot: true, - fullPath: '/', - path: '/', - children: [ - { - id: '/', - fullPath: '/', - path: '/', - options: {}, - }, - { - id: '/$foo/_layout', - fullPath: '/$foo', - path: '$foo', - options: { - params: { - parse: (params: Record<string, string>) => { - const num = parseInt(params.foo!, 10) - if (isNaN(num)) throw new Error('Not a number') - return { foo: num } - }, - }, - skipRouteOnParseError: { params: true }, - }, - children: [ - { - id: '/$foo/_layout/bar', - fullPath: '/$foo/bar', - path: 'bar', - options: {}, - }, - { - id: '/$foo/_layout/', - fullPath: '/$foo/', - path: '/', - options: {}, - }, - ], - }, - { - id: '/$foo/hello', - fullPath: '/$foo/hello', - path: '$foo/hello', - options: {}, - }, - ], - } - const { processedTree } = processRouteTree(tree) - - // numeric foo should match through the validated layout - const numericBarResult = findRouteMatch('/123/bar', processedTree) - expect(numericBarResult?.route.id).toBe('/$foo/_layout/bar') - - const numericIndexResult = findRouteMatch('/123', processedTree) - expect(numericIndexResult?.route.id).toBe('/$foo/_layout/') - expect(numericIndexResult?.rawParams).toEqual({ foo: '123' }) - expect(numericIndexResult?.parsedParams).toEqual({ foo: 123 }) - - // non-numeric foo should fall through to the non-validated route - const helloResult = findRouteMatch('/abc/hello', processedTree) - expect(helloResult?.route.id).toBe('/$foo/hello') - expect(helloResult?.rawParams).toEqual({ foo: 'abc' }) - - // non-numeric foo should NOT match the children of the validated layout - const barResult = findRouteMatch('/abc/bar', processedTree) - expect(barResult).toBeNull() - }) - }) - - describe('optional params with skipRouteOnParseError', () => { - it('optional param with static fallback', () => { - // Optional param with validation, with a static fallback - const tree = { - id: '__root__', - isRoot: true, - fullPath: '/', - path: '/', - children: [ - { - id: '/{-$lang}/home', - fullPath: '/{-$lang}/home', - path: '{-$lang}/home', - options: { - params: { - parse: (params: Record<string, string>) => { - const validLangs = ['en', 'es', 'fr', 'de'] - if (params.lang && !validLangs.includes(params.lang)) { - throw new Error('Invalid language') - } - return params - }, - }, - skipRouteOnParseError: { params: true }, - }, - }, - { - id: '/home', - fullPath: '/home', - path: 'home', - options: {}, - }, - ], - } - const { processedTree } = processRouteTree(tree) - - // valid language should match the validated route - const enResult = findRouteMatch('/en/home', processedTree) - expect(enResult?.route.id).toBe('/{-$lang}/home') - expect(enResult?.parsedParams).toEqual({ lang: 'en' }) - - // root path + home - both routes can match - // The optional route (with skipped param) has greater depth, so it wins - // This is the expected behavior per the priority system - const rootResult = findRouteMatch('/home', processedTree) - expect(rootResult?.route.id).toBe('/{-$lang}/home') - - // invalid language should NOT match the validated optional route - // and since there's no dynamic fallback, it should return null - const invalidResult = findRouteMatch('/it/home', processedTree) - expect(invalidResult).toBeNull() - }) - - it('optional param at root with validation', () => { - // Optional param that validates and allows skipping - const tree = { - id: '__root__', - isRoot: true, - fullPath: '/', - path: '/', - children: [ - { - id: '/{-$lang}', - fullPath: '/{-$lang}', - path: '{-$lang}', - options: { - params: { - parse: (params: Record<string, string>) => { - const validLangs = ['en', 'es', 'fr', 'de'] - if (params.lang && !validLangs.includes(params.lang)) { - throw new Error('Invalid language') - } - return params - }, - }, - skipRouteOnParseError: { params: true }, - }, - }, - ], - } - const { processedTree } = processRouteTree(tree) - - // valid language should match - const enResult = findRouteMatch('/en', processedTree) - expect(enResult?.route.id).toBe('/{-$lang}') - expect(enResult?.parsedParams).toEqual({ lang: 'en' }) - - // root path should match (optional skipped) - const rootResult = findRouteMatch('/', processedTree) - expect(rootResult?.route.id).toBe('/{-$lang}') - expect(rootResult?.parsedParams).toEqual({}) - - // invalid language should NOT match (no fallback route) - const invalidResult = findRouteMatch('/about', processedTree) - expect(invalidResult).toBeNull() - }) - }) - - describe('wildcard routes with skipRouteOnParseError', () => { - it('wildcard with validation', () => { - const tree = { - id: '__root__', - isRoot: true, - fullPath: '/', - path: '/', - children: [ - { - id: '/files/$', - fullPath: '/files/$', - path: 'files/$', - options: { - params: { - parse: (params: Record<string, string>) => { - if (params._splat!.includes('..')) { - throw new Error('Upward navigation not allowed') - } - return params - }, - }, - skipRouteOnParseError: { params: true }, - }, - }, - { - id: '/files', - fullPath: '/files', - path: 'files', - options: {}, - }, - ], - } - const { processedTree } = processRouteTree(tree) - - // path should match the validated wildcard route - const txtResult = findRouteMatch('/files/docs/readme.txt', processedTree) - expect(txtResult?.route.id).toBe('/files/$') - - // path with upward navigation should fall through to the static /files route - const otherResult = findRouteMatch( - '/files/../../secret/photo.jpg', - processedTree, - true, - ) - expect(otherResult?.route.id).toBe('/files') - expect(otherResult?.rawParams['**']).toBe('../../secret/photo.jpg') - }) - it('index parse failure does not block wildcard sibling', () => { - const tree = { - id: '__root__', - isRoot: true, - fullPath: '/', - path: '/', - children: [ - { - id: '/a/', - fullPath: '/a/', - path: 'a/', - options: { - params: { - parse: () => { - throw new Error('Invalid index') - }, - }, - skipRouteOnParseError: { params: true }, - }, - }, - { - id: '/a/$', - fullPath: '/a/$', - path: 'a/$', - options: {}, - }, - ], - } - const { processedTree } = processRouteTree(tree) - const result = findRouteMatch('/a', processedTree) - expect(result?.route.id).toBe('/a/$') - expect(result?.rawParams).toEqual({ '*': '', _splat: '' }) - }) - }) - - describe('multiple validated routes competing', () => { - it('first matching validated route wins', () => { - const tree = { - id: '__root__', - isRoot: true, - fullPath: '/', - path: '/', - children: [ - { - id: '/$uuid', - fullPath: '/$uuid', - path: '$uuid', - options: { - params: { - parse: (params: Record<string, string>) => { - const uuidRegex = - /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i - if (!uuidRegex.test(params.uuid!)) - throw new Error('Not a UUID') - return params - }, - }, - skipRouteOnParseError: { params: true }, - }, - }, - { - id: '/$number', - fullPath: '/$number', - path: '$number', - options: { - params: { - parse: (params: Record<string, string>) => { - const num = parseInt(params.number!, 10) - if (isNaN(num)) throw new Error('Not a number') - return { number: num } - }, - }, - skipRouteOnParseError: { params: true }, - }, - }, - { - id: '/$slug', - fullPath: '/$slug', - path: '$slug', - options: {}, - }, - ], - } - const { processedTree } = processRouteTree(tree) - - const uuidResult = findRouteMatch( - '/550e8400-e29b-41d4-a716-446655440000', - processedTree, - ) - expect(uuidResult?.route.id).toBe('/$uuid') - - const numberResult = findRouteMatch('/42', processedTree) - expect(numberResult?.route.id).toBe('/$number') - // params contains raw string values for interpolatePath - expect(numberResult?.rawParams).toEqual({ number: '42' }) - // parsedParams contains the transformed values from parse - expect(numberResult?.parsedParams).toEqual({ number: 42 }) - - const slugResult = findRouteMatch('/hello-world', processedTree) - expect(slugResult?.route.id).toBe('/$slug') - }) - it('priority option can be used to influence order', () => { - const alphabetical = { - id: '__root__', - isRoot: true, - fullPath: '/', - path: '/', - children: [ - { - id: '/$a', - fullPath: '/$a', - path: '$a', - options: { - params: { - parse: (params: Record<string, string>) => params, - }, - skipRouteOnParseError: { - params: true, - priority: 1, // higher priority than /$z - }, - }, - }, - { - id: '/$z', - fullPath: '/$z', - path: '$z', - options: { - params: { - parse: (params: Record<string, string>) => params, - }, - skipRouteOnParseError: { - params: true, - priority: -1, // lower priority than /$a - }, - }, - }, - ], - } - { - const { processedTree } = processRouteTree(alphabetical) - const result = findRouteMatch('/123', processedTree) - expect(result?.route.id).toBe('/$a') - } - const reverse = { - id: '__root__', - isRoot: true, - fullPath: '/', - path: '/', - children: [ - { - id: '/$a', - fullPath: '/$a', - path: '$a', - options: { - params: { - parse: (params: Record<string, string>) => params, - }, - skipRouteOnParseError: { - params: true, - priority: -1, // lower priority than /$z - }, - }, - }, - { - id: '/$z', - fullPath: '/$z', - path: '$z', - options: { - params: { - parse: (params: Record<string, string>) => params, - }, - skipRouteOnParseError: { - params: true, - priority: 1, // higher priority than /$a - }, - }, - }, - ], - } - { - const { processedTree } = processRouteTree(reverse) - const result = findRouteMatch('/123', processedTree) - expect(result?.route.id).toBe('/$z') - } - }) - }) - - describe('params.parse without skipRouteOnParseError', () => { - it('params.parse is NOT called during matching when skipRouteOnParseError is false', () => { - const parse = vi.fn() - const tree = { - id: '__root__', - isRoot: true, - fullPath: '/', - path: '/', - children: [ - { - id: '/$id', - fullPath: '/$id', - path: '$id', - options: { - params: { parse }, - // skipRouteOnParseError is NOT set - }, - }, - ], - } - const { processedTree } = processRouteTree(tree) - const result = findRouteMatch('/123', processedTree) - expect(result?.route.id).toBe('/$id') - // parse should NOT be called during matching - expect(parse).not.toHaveBeenCalled() - // params should be raw strings - expect(result?.rawParams).toEqual({ id: '123' }) - }) - }) - - describe('edge cases', () => { - it('validation error type does not matter', () => { - const tree = { - id: '__root__', - isRoot: true, - fullPath: '/', - path: '/', - children: [ - { - id: '/$id', - fullPath: '/$id', - path: '$id', - options: { - params: { - parse: () => { - throw 'string error' // not an Error object - }, - }, - skipRouteOnParseError: { params: true }, - }, - }, - { - id: '/$fallback', - fullPath: '/$fallback', - path: '$fallback', - options: {}, - }, - ], - } - const { processedTree } = processRouteTree(tree) - const result = findRouteMatch('/test', processedTree) - expect(result?.route.id).toBe('/$fallback') - }) - }) -}) diff --git a/packages/router-core/tests/ssr-server-cleanup.test.ts b/packages/router-core/tests/ssr-server-cleanup.test.ts new file mode 100644 index 0000000000..0cc8832abd --- /dev/null +++ b/packages/router-core/tests/ssr-server-cleanup.test.ts @@ -0,0 +1,380 @@ +import { createMemoryHistory } from '@tanstack/history' +import { describe, expect, test, vi } from 'vitest' +import { BaseRootRoute, BaseRoute } from '../src' +import { createRequestHandler } from '../src/ssr/createRequestHandler' +import { createSsrStreamResponse } from '../src/ssr/handlerCallback' +import { attachRouterServerSsrUtils } from '../src/ssr/ssr-server' +import { transformStreamWithRouter } from '../src/ssr/transformStreamWithRouter' +import { createTestRouter } from './routerTestUtils' + +/** + * CI-stable tests for the SSR cleanup contract. These do not rely on GC + * timing; they exercise the observable behavior: + * - onCleanup listeners run exactly once + * - cleanup is reentrancy-safe (listener calling cleanup again is a no-op) + * - cleanup is idempotent (second cleanup() call is a no-op) + */ + +function buildRouter(dehydratedData?: Record<string, any>) { + const rootRoute = new BaseRootRoute({}) + const indexRoute = new BaseRoute({ + getParentRoute: () => rootRoute, + path: '/', + component: () => null, + }) + return createTestRouter({ + routeTree: rootRoute.addChildren([indexRoute]), + history: createMemoryHistory({ initialEntries: ['/'] }), + isServer: true, + dehydrate: dehydratedData ? () => dehydratedData : undefined, + }) +} + +function deferred<T>() { + let resolve!: (value: T) => void + const promise = new Promise<T>((r) => { + resolve = r + }) + return { promise, resolve } +} + +describe('serverSsr.cleanup', () => { + test('onCleanup listeners run exactly once', () => { + const router = buildRouter() + attachRouterServerSsrUtils({ router, manifest: undefined }) + + let calls = 0 + router.serverSsr!.onCleanup(() => { + calls++ + }) + + router.serverSsr!.cleanup() + // Second call: serverSsr is undefined now, must short-circuit safely. + router.serverSsr?.cleanup() + expect(calls).toBe(1) + }) + + test('listener that re-enters cleanup() does not re-fire siblings', () => { + const router = buildRouter() + attachRouterServerSsrUtils({ router, manifest: undefined }) + + const order: Array<string> = [] + router.serverSsr!.onCleanup(() => { + order.push('a') + // Reentry: must be a no-op. + router.serverSsr?.cleanup() + }) + router.serverSsr!.onCleanup(() => { + order.push('b') + }) + + router.serverSsr!.cleanup() + expect(order).toEqual(['a', 'b']) + }) + + test('listener errors are swallowed and do not stop subsequent listeners', () => { + const router = buildRouter() + attachRouterServerSsrUtils({ router, manifest: undefined }) + + const order: Array<string> = [] + router.serverSsr!.onCleanup(() => { + order.push('a') + throw new Error('boom') + }) + router.serverSsr!.onCleanup(() => { + order.push('b') + }) + + // Should not throw. + router.serverSsr!.cleanup() + expect(order).toEqual(['a', 'b']) + }) + + test('cleanup before pending serialization resolves drops late scripts safely', async () => { + const value = deferred<string>() + const router = buildRouter({ value: value.promise }) + attachRouterServerSsrUtils({ router, manifest: undefined }) + + await router.load() + await router.serverSsr!.dehydrate() + router.serverSsr!.cleanup() + + value.resolve('done') + await Promise.resolve() + await Promise.resolve() + + expect(router.serverSsr).toBeUndefined() + }) + + test('serialization completion does not clear render-finished listeners', async () => { + const value = deferred<string>() + const router = buildRouter({ value: value.promise }) + attachRouterServerSsrUtils({ router, manifest: undefined }) + + await router.load() + await router.serverSsr!.dehydrate() + + let renderFinishedCalls = 0 + router.serverSsr!.onRenderFinished(() => { + renderFinishedCalls++ + }) + + const serializationDone = new Promise<void>((resolve) => { + router.serverSsr!.onSerializationFinished(resolve) + }) + + value.resolve('done') + await serializationDone + + expect(renderFinishedCalls).toBe(0) + router.serverSsr!.setRenderFinished() + expect(renderFinishedCalls).toBe(1) + + router.serverSsr?.cleanup() + }) + + test('render-finished listeners can synchronously finish serialization', async () => { + const value = deferred<string>() + const router = buildRouter({ value: value.promise }) + attachRouterServerSsrUtils({ router, manifest: undefined }) + + await router.load() + await router.serverSsr!.dehydrate() + router.serverSsr!.takeBufferedScripts() + + router.serverSsr!.onRenderFinished(() => { + value.resolve('done') + }) + + const serializationDone = new Promise<void>((resolve) => { + router.serverSsr!.onSerializationFinished(resolve) + }) + router.serverSsr!.setRenderFinished() + await serializationDone + + expect(router.serverSsr!.takeBufferedHtml()).toContain('$_TSR.e()') + + router.serverSsr?.cleanup() + }) + + test('late serialization listener runs safely and returns unsubscribe', async () => { + const router = buildRouter() + attachRouterServerSsrUtils({ router, manifest: undefined }) + + await router.load() + await router.serverSsr!.dehydrate() + + let calls = 0 + const unsubscribe = router.serverSsr!.onSerializationFinished(() => { + calls++ + }) + + expect(calls).toBe(1) + expect(() => unsubscribe()).not.toThrow() + router.serverSsr?.cleanup() + }) + + test('stream fast path only reserves when no SSR work is pending', async () => { + const router = buildRouter() + attachRouterServerSsrUtils({ router, manifest: undefined }) + + await router.load() + await router.serverSsr!.dehydrate() + const barrierScript = router.serverSsr!.takeBufferedScripts() + expect(barrierScript).toBeDefined() + + router.serverSsr!.setRenderFinished() + expect(router.serverSsr!.reserveStreamFastPath()).toBe(true) + expect(router.serverSsr!.reserveStreamFastPath()).toBe(false) + + router.serverSsr?.cleanup() + }) + + test('stream fast path rejects while SSR work is pending', async () => { + const value = deferred<string>() + const router = buildRouter({ value: value.promise }) + attachRouterServerSsrUtils({ router, manifest: undefined }) + + await router.load() + await router.serverSsr!.dehydrate() + + expect(router.serverSsr!.reserveStreamFastPath()).toBe(false) + const barrierScript = router.serverSsr!.takeBufferedScripts() + expect(barrierScript).toBeDefined() + expect(router.serverSsr!.reserveStreamFastPath()).toBe(false) + + const serializationDone = new Promise<void>((resolve) => { + router.serverSsr!.onSerializationFinished(resolve) + }) + value.resolve('done') + await serializationDone + + expect(router.serverSsr!.reserveStreamFastPath()).toBe(false) + router.serverSsr!.setRenderFinished() + expect(router.serverSsr!.reserveStreamFastPath()).toBe(false) + expect(router.serverSsr!.takeBufferedHtml()).toContain('<script') + + router.serverSsr?.cleanup() + }) + + test('throwing injected listener does not skip later listeners', () => { + const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {}) + const router = buildRouter() + try { + attachRouterServerSsrUtils({ router, manifest: undefined }) + + const calls: Array<string> = [] + router.serverSsr!.onInjectedHtml(() => { + calls.push('a') + throw new Error('boom') + }) + router.serverSsr!.onInjectedHtml(() => { + calls.push('b') + }) + + router.serverSsr!.injectHtml('<script>1</script>') + + expect(calls).toEqual(['a', 'b']) + } finally { + router.serverSsr?.cleanup() + errorSpy.mockRestore() + } + }) + + test('server SSR attach lifecycle runs listeners at attach time', () => { + const router = buildRouter() + const calls: Array<string> = [] + router.serverSsrLifecycle = { + onServerSsrAttach: [ + (serverSsr) => { + calls.push('attach') + serverSsr.onCleanup(() => calls.push('cleanup')) + }, + ], + } + + attachRouterServerSsrUtils({ router, manifest: undefined }) + expect(calls).toEqual(['attach']) + + router.serverSsr!.cleanup() + expect(calls).toEqual(['attach', 'cleanup']) + }) + + test('request handler cleans plain response body after drain', async () => { + const router = buildRouter() + let cleanupCalls = 0 + const handler = createRequestHandler({ + createRouter: () => router, + request: new Request('http://localhost/'), + }) + + const response = await handler(({ router: requestRouter }) => { + const serverSsr = requestRouter.serverSsr! + const cleanup = serverSsr.cleanup + serverSsr.cleanup = () => { + cleanupCalls++ + cleanup() + } + return Promise.resolve(new Response('plain')) + }) + + expect(cleanupCalls).toBe(1) + await response.text() + expect(cleanupCalls).toBe(1) + expect(router.serverSsr).toBeUndefined() + }) + + test('request handler cleans plain response body on cancel', async () => { + const router = buildRouter() + let cleanupCalls = 0 + const handler = createRequestHandler({ + createRouter: () => router, + request: new Request('http://localhost/'), + }) + + const response = await handler(({ router: requestRouter }) => { + const serverSsr = requestRouter.serverSsr! + const cleanup = serverSsr.cleanup + serverSsr.cleanup = () => { + cleanupCalls++ + cleanup() + } + return Promise.resolve( + new Response( + new ReadableStream<Uint8Array>({ + start(controller) { + controller.enqueue(new TextEncoder().encode('plain')) + }, + }), + ), + ) + }) + + expect(cleanupCalls).toBe(1) + await response.body!.cancel('done') + expect(cleanupCalls).toBe(1) + expect(router.serverSsr).toBeUndefined() + }) + + test('request handler cleans bodyless response immediately', async () => { + const router = buildRouter() + let cleanupCalls = 0 + const handler = createRequestHandler({ + createRouter: () => router, + request: new Request('http://localhost/'), + }) + + await handler(({ router: requestRouter }) => { + const serverSsr = requestRouter.serverSsr! + const cleanup = serverSsr.cleanup + serverSsr.cleanup = () => { + cleanupCalls++ + cleanup() + } + return Promise.resolve(new Response(null, { status: 204 })) + }) + + expect(cleanupCalls).toBe(1) + expect(router.serverSsr).toBeUndefined() + }) + + test('request handler defers cleanup for stream response metadata', async () => { + const router = buildRouter() + let cleanupCalls = 0 + let controller!: ReadableStreamDefaultController<Uint8Array> + const handler = createRequestHandler({ + createRouter: () => router, + request: new Request('http://localhost/'), + }) + + const response = await handler(({ router: requestRouter }) => { + const serverSsr = requestRouter.serverSsr! + const cleanup = serverSsr.cleanup + serverSsr.cleanup = () => { + cleanupCalls++ + cleanup() + } + const appStream = new ReadableStream<Uint8Array>({ + start(c) { + controller = c + }, + }) + const responseStream = transformStreamWithRouter( + requestRouter, + appStream as any, + ) + + return createSsrStreamResponse( + requestRouter, + new Response(responseStream as any), + ) + }) + + expect(cleanupCalls).toBe(0) + controller.enqueue(new TextEncoder().encode('<html><body>ok</body></html>')) + controller.close() + await response.text() + expect(cleanupCalls).toBe(1) + expect(router.serverSsr).toBeUndefined() + }) +}) diff --git a/packages/router-core/tests/ssr-server-manifest.test.ts b/packages/router-core/tests/ssr-server-manifest.test.ts new file mode 100644 index 0000000000..f76535622f --- /dev/null +++ b/packages/router-core/tests/ssr-server-manifest.test.ts @@ -0,0 +1,404 @@ +import { createMemoryHistory } from '@tanstack/history' +import { runInNewContext } from 'node:vm' +import { BaseRootRoute, BaseRoute } from '../src' +import { attachRouterServerSsrUtils } from '../src/ssr/ssr-server' +import { GLOBAL_TSR } from '../src/ssr/constants' +import { createTestRouter } from './routerTestUtils' +import { describe, expect, test } from 'vitest' +import type { + ManifestCssLink, + ManifestRouteAssets, + ServerManifest, +} from '../src/manifest' +import type { DehydratedRouter } from '../src/ssr/types' + +function buildRouter() { + const rootRoute = new BaseRootRoute({}) + const indexRoute = new BaseRoute({ + getParentRoute: () => rootRoute, + path: '/', + component: () => null, + }) + const postsRoute = new BaseRoute({ + getParentRoute: () => rootRoute, + path: '/posts', + component: () => null, + }) + + const routeTree = rootRoute.addChildren([indexRoute, postsRoute]) + + return createTestRouter({ + routeTree, + history: createMemoryHistory({ initialEntries: ['/'] }), + isServer: true, + }) +} + +function buildManifest(): ServerManifest { + const sharedAsset: ManifestCssLink = '/assets/shared.css' + + return { + routes: { + __root__: { + css: [sharedAsset], + preloads: ['/assets/root.js'], + }, + '/': { + css: [sharedAsset], + preloads: ['/assets/index.js'], + }, + '/posts': { + css: [sharedAsset], + preloads: ['/assets/posts.js'], + }, + }, + } +} + +function buildInlineManifest(): ServerManifest { + const manifest = buildManifest() + return { + ...manifest, + inlineCss: { + styles: { + '/assets/shared.css': '.shared{color:red}', + }, + }, + } +} + +async function dehydrateManifest() { + const router = buildRouter() + const manifest = buildManifest() + + attachRouterServerSsrUtils({ + router, + manifest, + }) + + await router.load() + await router.serverSsr!.dehydrate() + + const script = router.serverSsr!.takeBufferedScripts() + expect(script?.tag).toBe('script') + expect(script?.children).toBeTruthy() + + return parseSerializedRouter(script!.children!).manifest! +} + +function parseSerializedRouter(serialized: string): DehydratedRouter { + const context: Record<string, any> = { + document: { + currentScript: { + remove() {}, + }, + }, + } + context.self = context + + runInNewContext(serialized, context) + + const router = context[GLOBAL_TSR]?.router + expect(router).toBeDefined() + return router +} + +describe('attachRouterServerSsrUtils manifest dehydration', () => { + test('omits unmatched route assets by default', async () => { + const manifest = await dehydrateManifest() + + expect(manifest.routes['/posts']).toBeUndefined() + expect(manifest.routes['/']?.preloads).toEqual(['/assets/index.js']) + }) + + test('preserves script format when dehydrating the manifest', async () => { + const router = buildRouter() + const manifest: ServerManifest = { + ...buildManifest(), + scriptFormat: 'iife', + } + + attachRouterServerSsrUtils({ + router, + manifest, + }) + + await router.load() + await router.serverSsr!.dehydrate() + + const script = router.serverSsr!.takeBufferedScripts() + expect(script?.children).toBeTruthy() + const dehydratedManifest = parseSerializedRouter( + script!.children!, + ).manifest! + + expect(dehydratedManifest.scriptFormat).toBe('iife') + }) + + test('maps request-scoped preload links into SSR manifest data', async () => { + const router = buildRouter() + const manifest = buildManifest() + const requestAssets: ManifestRouteAssets = { + preloads: [{ href: '/assets/rsc-client.js', crossOrigin: 'anonymous' }], + scripts: [ + { + attrs: { + src: '/assets/request-script.js', + type: 'module', + }, + children: 'console.log("request")', + }, + ], + css: [{ href: '/assets/rsc-client.css', crossOrigin: 'use-credentials' }], + } + + attachRouterServerSsrUtils({ + router, + manifest, + getRequestAssets: () => requestAssets, + }) + + await router.load() + + expect(router.ssr!.manifest?.routes.__root__).toMatchObject({ + preloads: [ + { href: '/assets/rsc-client.js', crossOrigin: 'anonymous' }, + '/assets/root.js', + ], + scripts: [ + { + attrs: { + src: '/assets/request-script.js', + type: 'module', + }, + children: 'console.log("request")', + }, + ], + css: [ + { href: '/assets/rsc-client.css', crossOrigin: 'use-credentials' }, + '/assets/shared.css', + ], + }) + }) + + test('maps preloads-only request assets into SSR manifest data', async () => { + const router = buildRouter() + const manifest = buildManifest() + const requestAssets: ManifestRouteAssets = { + preloads: [{ href: '/assets/rsc-client.js', crossOrigin: 'anonymous' }], + } + + attachRouterServerSsrUtils({ + router, + manifest, + getRequestAssets: () => requestAssets, + }) + + await router.load() + + expect(router.ssr!.manifest?.routes.__root__?.preloads).toEqual([ + { href: '/assets/rsc-client.js', crossOrigin: 'anonymous' }, + '/assets/root.js', + ]) + }) + + test('dehydrates request-scoped preload links into manifest data', async () => { + const router = buildRouter() + const manifest = buildManifest() + + attachRouterServerSsrUtils({ + router, + manifest, + }) + + await router.load() + await router.serverSsr!.dehydrate({ + requestAssets: { + preloads: [{ href: '/assets/rsc-client.js', crossOrigin: 'anonymous' }], + scripts: [ + { + attrs: { + src: '/assets/request-script.js', + type: 'module', + }, + children: 'console.log("request")', + }, + ], + css: [ + { + href: '/assets/rsc-client.css', + crossOrigin: 'use-credentials', + }, + ], + }, + }) + + const script = router.serverSsr!.takeBufferedScripts() + expect(script?.children).toBeTruthy() + const dehydratedManifest = parseSerializedRouter( + script!.children!, + ).manifest! + + expect(dehydratedManifest.routes.__root__).toMatchObject({ + preloads: [ + { href: '/assets/rsc-client.js', crossOrigin: 'anonymous' }, + '/assets/root.js', + ], + scripts: [ + { + attrs: { + src: '/assets/request-script.js', + type: 'module', + }, + children: 'console.log("request")', + }, + ], + css: [ + { href: '/assets/rsc-client.css', crossOrigin: 'use-credentials' }, + '/assets/shared.css', + ], + }) + expect(Array.isArray(dehydratedManifest.routes.__root__?.css)).toBe(true) + expect((dehydratedManifest.routes.__root__?.css as any).links).toBe( + undefined, + ) + }) + + test('dehydrates preloads-only request assets into manifest data', async () => { + const router = buildRouter() + const manifest = buildManifest() + + attachRouterServerSsrUtils({ + router, + manifest, + }) + + await router.load() + await router.serverSsr!.dehydrate({ + requestAssets: { + preloads: [{ href: '/assets/rsc-client.js', crossOrigin: 'anonymous' }], + }, + }) + + const script = router.serverSsr!.takeBufferedScripts() + expect(script?.children).toBeTruthy() + const dehydratedManifest = parseSerializedRouter( + script!.children!, + ).manifest! + + expect(dehydratedManifest.routes.__root__?.preloads).toEqual([ + { href: '/assets/rsc-client.js', crossOrigin: 'anonymous' }, + '/assets/root.js', + ]) + }) + + test('inlines stylesheet assets for SSR and strips stylesheet links from dehydration', async () => { + const router = buildRouter() + const manifest = buildInlineManifest() + + attachRouterServerSsrUtils({ + router, + manifest, + }) + + await router.load() + + const ssrInlineCss = router.ssr!.manifest?.inlineStyle + expect(ssrInlineCss).toMatchObject({ + children: '.shared{color:red}', + }) + + await router.serverSsr!.dehydrate() + + const script = router.serverSsr!.takeBufferedScripts() + expect(script?.children).toBeTruthy() + const dehydratedRouter = parseSerializedRouter(script!.children!) + const dehydratedManifest = dehydratedRouter.manifest! + const rootInlineCss = dehydratedManifest.inlineStyle + const allLinks = Object.values(dehydratedManifest.routes).flatMap( + (route) => route.css ?? [], + ) + + expect(rootInlineCss).toEqual({ + attrs: { + suppressHydrationWarning: true, + }, + }) + expect('inlineCss' in dehydratedManifest).toBe(false) + expect( + allLinks.some((asset) => + typeof asset === 'string' + ? asset === '/assets/shared.css' + : asset.href === '/assets/shared.css', + ), + ).toBe(false) + expect(dehydratedManifest.routes['/']?.preloads).toEqual([ + '/assets/index.js', + ]) + }) + + test('strips only inlinable stylesheet links from dehydrated manifest data', async () => { + const router = buildRouter() + const manifest: ServerManifest = { + inlineCss: { + styles: { + '/assets/root-inline.css': '.root{color:red}', + '/assets/index-inline.css': '.index{color:blue}', + }, + }, + routes: { + __root__: { + css: [ + '/assets/root-inline.css', + { + href: '/assets/root-linked.css', + crossOrigin: 'anonymous', + }, + ], + }, + '/': { + css: [ + { + href: '/assets/index-inline.css', + crossOrigin: 'use-credentials', + }, + '/assets/index-linked.css', + ], + preloads: ['/assets/index.js'], + }, + }, + } + + attachRouterServerSsrUtils({ + router, + manifest, + }) + + await router.load() + + expect(router.ssr!.manifest?.inlineStyle).toMatchObject({ + children: '.root{color:red}.index{color:blue}', + }) + + await router.serverSsr!.dehydrate() + + const script = router.serverSsr!.takeBufferedScripts() + expect(script?.children).toBeTruthy() + const dehydratedManifest = parseSerializedRouter( + script!.children!, + ).manifest! + + expect(dehydratedManifest.routes.__root__?.css).toEqual([ + { + href: '/assets/root-linked.css', + crossOrigin: 'anonymous', + }, + ]) + expect(dehydratedManifest.routes['/']?.css).toEqual([ + '/assets/index-linked.css', + ]) + expect(dehydratedManifest.routes['/']?.preloads).toEqual([ + '/assets/index.js', + ]) + }) +}) diff --git a/packages/router-core/tests/transformStreamBackpressure.perf.test.ts b/packages/router-core/tests/transformStreamBackpressure.perf.test.ts new file mode 100644 index 0000000000..267241f416 --- /dev/null +++ b/packages/router-core/tests/transformStreamBackpressure.perf.test.ts @@ -0,0 +1,290 @@ +// On-demand backpressure test for transformStreamWithRouter. +// +// NOT run in CI by default. To execute: +// RUN_BACKPRESSURE_PERF=1 pnpm --filter @tanstack/router-core test:unit -- transformStreamBackpressure +// +// Validates fix for TanStack/router#7402 +// without a backpressure gate the read loop in +// transformStreamWithRouter calls controller.enqueue unconditionally, +// allowing controller.[[queue]] to accumulate Uint8Array chunks (external +// memory) when the consumer drains slower than the producer. +import { ReadableStream } from 'node:stream/web' +import { describe, expect, it } from 'vitest' +import { transformStreamWithRouter } from '../src/ssr/transformStreamWithRouter' + +const enabled = process.env.RUN_BACKPRESSURE_PERF === '1' +const requiresGc = typeof (globalThis as any).gc === 'function' + +function createFastProducer( + chunkCount: number, + chunkBytes: number, + opts: { freshChunks?: boolean } = {}, +) { + let pulls = 0 + let produced = 0 + const reusable = opts.freshChunks + ? null + : new Uint8Array(chunkBytes).fill(0x61) + const stream = new ReadableStream<Uint8Array>({ + pull(controller) { + pulls++ + if (produced >= chunkCount) { + controller.close() + return + } + produced++ + // Fresh allocation for external-memory tests: reusing one Uint8Array + // means the upstream queue never actually retains additional native + // memory even if our transform held arbitrarily many references. + controller.enqueue( + opts.freshChunks ? new Uint8Array(chunkBytes).fill(0x61) : reusable!, + ) + }, + }) + return { + stream, + getPulls: () => pulls, + getProduced: () => produced, + } +} + +function makeRouter() { + return { + serverSsr: { + isSerializationFinished: () => true, + reserveStreamFastPath: () => true, + onInjectedHtml: () => () => {}, + onSerializationFinished: () => () => {}, + takeBufferedHtml: () => undefined, + setRenderFinished: () => {}, + cleanup: () => {}, + }, + } as any +} + +// Main-path router fake: serialization NOT finished synchronously, so the +// transform runs the full scanner + pending HTML/scripts path. Exposes +// hooks to inject HTML and signal serialization finished. +function makeMainPathRouter(): { + router: any + injectHtml: (html: string) => void + finishSerialization: () => void +} { + let buffered = '' + const injectedListeners: Array<() => void> = [] + const serializationListeners: Array<() => void> = [] + const router: any = { + serverSsr: { + isSerializationFinished: () => false, + reserveStreamFastPath: () => false, + onInjectedHtml: (cb: () => void) => { + injectedListeners.push(cb) + return () => { + const i = injectedListeners.indexOf(cb) + if (i >= 0) injectedListeners.splice(i, 1) + } + }, + onSerializationFinished: (cb: () => void) => { + serializationListeners.push(cb) + return () => { + const i = serializationListeners.indexOf(cb) + if (i >= 0) serializationListeners.splice(i, 1) + } + }, + takeBufferedHtml: () => { + const v = buffered + buffered = '' + return v || undefined + }, + setRenderFinished: () => {}, + cleanup: () => {}, + liftScriptBarrier: () => {}, + }, + } + return { + router, + injectHtml: (html) => { + buffered += html + for (const l of injectedListeners) l() + }, + finishSerialization: () => { + for (const l of serializationListeners) l() + }, + } +} + +describe.runIf(enabled)('transformStreamWithRouter backpressure', () => { + it('does not run producer arbitrarily ahead of slow consumer', async () => { + const CHUNKS = 200 + const CHUNK_BYTES = 8 * 1024 // 8KB per chunk + const producer = createFastProducer(CHUNKS, CHUNK_BYTES) + const router = makeRouter() + + const out = transformStreamWithRouter(router, producer.stream) + + const reader = out.getReader() + let consumed = 0 + let maxLead = 0 + while (true) { + // Throttled consumer: ~5ms per chunk. + await new Promise((r) => setTimeout(r, 5)) + const { done } = await reader.read() + if (done) break + consumed++ + const lead = producer.getProduced() - consumed + if (lead > maxLead) maxLead = lead + } + + // Producer should never be more than a small constant number of chunks + // ahead of the consumer. ReadableStream default HWM is 1 for byte + // streams; allow generous slack for scheduling jitter. + expect(maxLead).toBeLessThanOrEqual(8) + expect(consumed).toBe(CHUNKS) + }) + + it('bounded external memory under sustained load', async () => { + expect(requiresGc, 'Run with node --expose-gc').toBe(true) + const CHUNKS = 1000 + const CHUNK_BYTES = 16 * 1024 + const producer = createFastProducer(CHUNKS, CHUNK_BYTES, { + freshChunks: true, + }) + const router = makeRouter() + + const out = transformStreamWithRouter(router, producer.stream) + const reader = out.getReader() + + let consumed = 0 + let peakExternal = 0 + const baseline = process.memoryUsage().external + while (true) { + await new Promise((r) => setTimeout(r, 2)) + const { done } = await reader.read() + if (done) break + consumed++ + if (consumed % 50 === 0) { + ;(globalThis as any).gc() + const ext = process.memoryUsage().external - baseline + if (ext > peakExternal) peakExternal = ext + } + } + + // Without backpressure, peak external memory scales w/ CHUNKS*CHUNK_BYTES + // (~16MB). With backpressure, only a few chunks worth. + expect(peakExternal).toBeLessThan(2 * 1024 * 1024) // 2MB ceiling + expect(consumed).toBe(CHUNKS) + }) + + it('main path: scanner+inject path also honors backpressure', async () => { + // Same shape as fast-path test but with a router that forces the + // scanner+inject code path. Producer emits valid HTML fragments + // (ending at closing tags) so the scanner can release them. + const CHUNKS = 200 + const CHUNK_BYTES = 8 * 1024 + const filler = 'a'.repeat(CHUNK_BYTES - '<p></p>'.length) + const chunkStr = `<p>${filler}</p>` + const encoded = new TextEncoder().encode(chunkStr) + + let produced = 0 + const stream = new ReadableStream<Uint8Array>({ + pull(controller) { + if (produced >= CHUNKS) { + controller.close() + return + } + produced++ + controller.enqueue(encoded) + }, + }) + + const { router, finishSerialization } = makeMainPathRouter() + const out = transformStreamWithRouter(router, stream) + // Mark serialization finished immediately so tryFinish() proceeds once + // upstream closes. + finishSerialization() + + const reader = out.getReader() + let consumed = 0 + let bytes = 0 + let maxLead = 0 + while (true) { + await new Promise((r) => setTimeout(r, 5)) + const { done, value } = await reader.read() + if (done) break + consumed++ + bytes += value.byteLength + const lead = produced - consumed + if (lead > maxLead) maxLead = lead + } + + expect(maxLead).toBeLessThanOrEqual(8) + expect(consumed).toBe(CHUNKS) + expect(bytes).toBe(CHUNKS * encoded.byteLength) + }) + + it('main path: injected scripts under slow consumer do not balloon memory', async () => { + expect(requiresGc, 'Run with node --expose-gc').toBe(true) + + // Producer emits a steady stream of app HTML. While that streams, the + // router injects many large <script> chunks. With backpressure these + // are stored as strings in pendingWrites and only encoded at enqueue + // time, so external memory should stay bounded. + const APP_CHUNKS = 200 + const APP_CHUNK_BYTES = 4 * 1024 + const INJECT_PER_APP_CHUNK = 5 + const SCRIPT_BYTES = 4 * 1024 + + const appFiller = 'a'.repeat(APP_CHUNK_BYTES - '<p></p>'.length) + const appChunkStr = `<p>${appFiller}</p>` + const appBytes = new TextEncoder().encode(appChunkStr) + const scriptFiller = 's'.repeat(SCRIPT_BYTES - '<script></script>'.length) + const scriptStr = `<script>${scriptFiller}</script>` + + const { router, injectHtml, finishSerialization } = makeMainPathRouter() + + let produced = 0 + const stream = new ReadableStream<Uint8Array>({ + pull(controller) { + if (produced >= APP_CHUNKS) { + controller.close() + return + } + produced++ + // Inject some scripts as part of producing this chunk to simulate + // a render that emits HTML AND injects head scripts concurrently. + for (let i = 0; i < INJECT_PER_APP_CHUNK; i++) injectHtml(scriptStr) + controller.enqueue(appBytes) + }, + }) + + const out = transformStreamWithRouter(router, stream) + finishSerialization() + const reader = out.getReader() + + const baseline = process.memoryUsage().external + let peakExternal = 0 + let consumed = 0 + let totalText = '' + while (true) { + await new Promise((r) => setTimeout(r, 2)) + const { done, value } = await reader.read() + if (done) break + consumed++ + totalText += Buffer.from(value).toString('utf8') + if (consumed % 25 === 0) { + ;(globalThis as any).gc() + const ext = process.memoryUsage().external - baseline + if (ext > peakExternal) peakExternal = ext + } + } + + // Total bytes produced ≈ APP_CHUNKS * (APP_CHUNK_BYTES + 5*SCRIPT_BYTES) + // ≈ 200 * (4KB + 20KB) ≈ 4.8MB + // With backpressure peak external should stay well below total. + expect(peakExternal).toBeLessThan(2 * 1024 * 1024) + expect(totalText.split(appChunkStr).length - 1).toBe(APP_CHUNKS) + expect(totalText.split(scriptStr).length - 1).toBe( + APP_CHUNKS * INJECT_PER_APP_CHUNK, + ) + }) +}) diff --git a/packages/router-core/tests/transformStreamWithRouter.test.ts b/packages/router-core/tests/transformStreamWithRouter.test.ts new file mode 100644 index 0000000000..13b0072e24 --- /dev/null +++ b/packages/router-core/tests/transformStreamWithRouter.test.ts @@ -0,0 +1,1135 @@ +// CI-stable tests for transformStreamWithRouter behavior. +// +// These exercise the deterministic side-effects of the SSR memory fix +// (TanStack/router#7402) without relying on GC, timing of real I/O, or +// process.memoryUsage(). On-demand backpressure/external-memory +// assertions live in transformStreamBackpressure.perf.test.ts. +import { ReadableStream } from 'node:stream/web' +import { PassThrough } from 'node:stream' +import { describe, expect, test, vi } from 'vitest' +import { createMemoryHistory } from '@tanstack/history' +import { BaseRootRoute, BaseRoute } from '../src' +import { GLOBAL_TSR, TSR_SCRIPT_BARRIER_ID } from '../src/ssr/constants' +import { createSsrStreamResponse } from '../src/ssr/handlerCallback' +import { attachRouterServerSsrUtils } from '../src/ssr/ssr-server' +import { + transformPipeableStreamWithRouter, + transformReadableStreamWithRouter, + transformStreamWithRouter, +} from '../src/ssr/transformStreamWithRouter' +import { createTestRouter } from './routerTestUtils' +import type { RouterManagedTag } from '../src/manifest' + +const MAX_LEFTOVER_CHARS = 2048 +const MAX_ROUTER_HTML_CHARS = 16 * 1024 * 1024 + +type FakeServerSsr = { + isSerializationFinished: () => boolean + reserveStreamFastPath: () => boolean + onInjectedHtml: (listener: () => void) => () => void + onSerializationFinished: (listener: () => void) => () => void + takeBufferedHtml: () => string | undefined + setRenderFinished: () => void + cleanup: () => void + liftScriptBarrier?: () => void +} + +type FakeRouter = { + serverSsr?: FakeServerSsr +} + +function makeRouter(opts: Partial<FakeServerSsr> = {}): { + router: FakeRouter + cleanupCalls: { count: number } + injectHtml: (html: string) => void + finishSerialization: () => void +} { + const cleanupCalls = { count: 0 } + let cleanedUp = false + let buffered = '' + const injectedListeners: Array<() => void> = [] + const serializationListeners: Array<() => void> = [] + + const router: FakeRouter = { + serverSsr: { + isSerializationFinished: () => false, + reserveStreamFastPath: () => false, + onInjectedHtml: (cb) => { + injectedListeners.push(cb) + return () => { + const i = injectedListeners.indexOf(cb) + if (i >= 0) injectedListeners.splice(i, 1) + } + }, + onSerializationFinished: (cb) => { + serializationListeners.push(cb) + return () => { + const i = serializationListeners.indexOf(cb) + if (i >= 0) serializationListeners.splice(i, 1) + } + }, + takeBufferedHtml: () => { + const v = buffered + buffered = '' + return v || undefined + }, + setRenderFinished: () => {}, + cleanup: () => { + if (cleanedUp) return + cleanedUp = true + cleanupCalls.count++ + router.serverSsr = undefined + }, + liftScriptBarrier: () => {}, + ...opts, + }, + } + + return { + router, + cleanupCalls, + injectHtml: (html: string) => { + buffered += html + for (const l of injectedListeners.slice()) { + try { + l() + } catch (err) { + console.error('SSR injected HTML listener error:', err) + } + } + }, + finishSerialization: () => { + for (const l of serializationListeners.slice()) { + try { + l() + } catch (err) { + console.error('Serialization listener error:', err) + } + } + }, + } +} + +function makeManualUpstream(): { + stream: ReadableStream<Uint8Array> + push: (s: string) => void + close: () => void + cancelled: { value: boolean; reason: unknown } +} { + let controllerRef: ReadableStreamDefaultController<Uint8Array> | undefined + const cancelled = { value: false, reason: undefined as unknown } + const encoder = new TextEncoder() + const stream = new ReadableStream<Uint8Array>({ + start(c) { + controllerRef = c + }, + cancel(reason) { + cancelled.value = true + cancelled.reason = reason + }, + }) + return { + stream, + push: (s) => controllerRef!.enqueue(encoder.encode(s)), + close: () => controllerRef!.close(), + cancelled, + } +} + +async function readAll(s: ReadableStream<Uint8Array>): Promise<string> { + const reader = s.getReader() + let out = '' + while (true) { + const { done, value } = await reader.read() + if (done) break + // Buffer.from accepts any ArrayBufferView regardless of realm (jsdom env). + out += Buffer.from( + value.buffer, + value.byteOffset, + value.byteLength, + ).toString('utf8') + } + return out +} + +// Yield to the microtask queue a few times so async stream operations can +// drain. Avoids reliance on real timers. +async function flush(n = 5) { + for (let i = 0; i < n; i++) await Promise.resolve() +} + +function createDeferred<T>() { + let resolve!: (value: T) => void + let reject!: (reason?: unknown) => void + const promise = new Promise<T>((res, rej) => { + resolve = res + reject = rej + }) + return { promise, resolve, reject } +} + +function createControlledStream<T>() { + let controller!: ReadableStreamDefaultController<T> + const stream = new ReadableStream<T>({ + start(c) { + controller = c + }, + }) + return { stream, controller } +} + +function renderManagedScript(tag: RouterManagedTag) { + const attrs = tag.attrs ?? {} + const id = attrs.id ? ` id="${attrs.id}"` : '' + const className = attrs.className ? ` class="${attrs.className}"` : '' + const nonce = attrs.nonce ? ` nonce="${attrs.nonce}"` : '' + return `<script${id}${className}${nonce}>${tag.children ?? ''}</script>` +} + +function createRealSsrRouter(dehydratedData: Record<string, any>) { + const rootRoute = new BaseRootRoute({}) + const indexRoute = new BaseRoute({ + getParentRoute: () => rootRoute, + path: '/', + component: () => null, + }) + + return createTestRouter({ + routeTree: rootRoute.addChildren([indexRoute]), + history: createMemoryHistory({ initialEntries: ['/'] }), + isServer: true, + dehydrate: () => dehydratedData, + }) +} + +describe('transformStreamWithRouter — real SSR scripts', () => { + test('flushes stream-end scripts before body close when serialization finishes before transform starts', async () => { + const streamed = createDeferred<string>() + const router = createRealSsrRouter({ streamed: streamed.promise }) + attachRouterServerSsrUtils({ router, manifest: undefined }) + + await router.load() + await router.serverSsr!.dehydrate() + + const barrierScript = router.serverSsr!.takeBufferedScripts() + expect(barrierScript).toBeDefined() + expect(barrierScript!.attrs?.id).toBe(TSR_SCRIPT_BARRIER_ID) + expect(barrierScript!.children).toContain(`${GLOBAL_TSR}.router=`) + expect(barrierScript!.children).not.toContain(`${GLOBAL_TSR}.e()`) + + const serializationDone = new Promise<void>((resolve) => { + router.serverSsr!.onSerializationFinished(resolve) + }) + streamed.resolve('done') + await serializationDone + + const upstream = makeManualUpstream() + const output = transformStreamWithRouter( + router as any, + upstream.stream as any, + ) + upstream.push( + `<html><body><main>app</main>${renderManagedScript( + barrierScript!, + )}</body></html>`, + ) + upstream.close() + + const html = await readAll(output as any) + + expect(html).toContain(`${GLOBAL_TSR}.router=`) + expect(html).toContain(`${GLOBAL_TSR}.e()`) + expect(html.indexOf(`${GLOBAL_TSR}.e()`)).toBeLessThan( + html.indexOf('</body>'), + ) + }) + + test('fuses the final resolver and stream-end scripts', async () => { + const streamed = createControlledStream<string>() + const router = createRealSsrRouter({ streamed: streamed.stream }) + attachRouterServerSsrUtils({ router, manifest: undefined }) + + await router.load() + await router.serverSsr!.dehydrate() + + const barrierScript = router.serverSsr!.takeBufferedScripts() + expect(barrierScript).toBeDefined() + + const upstream = makeManualUpstream() + const output = transformStreamWithRouter( + router as any, + upstream.stream as any, + ) + upstream.push( + `<html><body><main>app</main>${renderManagedScript( + barrierScript!, + )}</body></html>`, + ) + + const serializationDone = new Promise<void>((resolve) => { + router.serverSsr!.onSerializationFinished(resolve) + }) + streamed.controller.close() + await serializationDone + upstream.close() + + const html = await readAll(output as any) + const resolverIndex = html.indexOf('.return(void 0)') + const endIndex = html.indexOf(`${GLOBAL_TSR}.e()`) + + expect(resolverIndex).toBeGreaterThan(-1) + expect(endIndex).toBeGreaterThan(resolverIndex) + expect(html.slice(resolverIndex, endIndex)).not.toContain('</script>') + expect(endIndex).toBeLessThan(html.indexOf('</body>')) + }) + + test('flushes stream-end scripts even when no barrier marker was emitted', async () => { + const streamed = createDeferred<string>() + const router = createRealSsrRouter({ streamed: streamed.promise }) + attachRouterServerSsrUtils({ router, manifest: undefined }) + + await router.load() + await router.serverSsr!.dehydrate() + + const serializationDone = new Promise<void>((resolve) => { + router.serverSsr!.onSerializationFinished(resolve) + }) + streamed.resolve('done') + await serializationDone + + const upstream = makeManualUpstream() + const output = transformStreamWithRouter( + router as any, + upstream.stream as any, + ) + upstream.push('<html><body><main>app</main></body></html>') + upstream.close() + + const html = await readAll(output as any) + + expect(html).toContain(`${GLOBAL_TSR}.router=`) + expect(html).toContain(`${GLOBAL_TSR}.e()`) + expect(html.indexOf(`${GLOBAL_TSR}.e()`)).toBeLessThan( + html.indexOf('</body>'), + ) + }) + + test('keeps stream scripts before uppercase body close', async () => { + const streamed = createDeferred<string>() + const router = createRealSsrRouter({ streamed: streamed.promise }) + attachRouterServerSsrUtils({ router, manifest: undefined }) + + await router.load() + await router.serverSsr!.dehydrate() + const barrierScript = router.serverSsr!.takeBufferedScripts()! + + const upstream = makeManualUpstream() + const output = transformStreamWithRouter( + router as any, + upstream.stream as any, + ) + upstream.push( + `<html><body>${renderManagedScript(barrierScript)}<main>app</main></BODY></HTML>`, + ) + + const serializationDone = new Promise<void>((resolve) => { + router.serverSsr!.onSerializationFinished(resolve) + }) + streamed.resolve('done') + await serializationDone + upstream.close() + + const html = await readAll(output as any) + expect(html).toContain(`${GLOBAL_TSR}.e()`) + expect(html.indexOf(`${GLOBAL_TSR}.e()`)).toBeLessThan( + html.indexOf('</BODY>'), + ) + }) + + test('detects a barrier marker split across chunks', async () => { + let liftCalls = 0 + const { router, finishSerialization } = makeRouter({ + liftScriptBarrier: () => { + liftCalls++ + }, + }) + const upstream = makeManualUpstream() + const output = transformStreamWithRouter( + router as any, + upstream.stream as any, + ) + const splitAt = Math.floor(TSR_SCRIPT_BARRIER_ID.length / 2) + + upstream.push( + `<html><body><script id="${TSR_SCRIPT_BARRIER_ID.slice(0, splitAt)}`, + ) + upstream.push( + `${TSR_SCRIPT_BARRIER_ID.slice(splitAt)}"></script><main>app</main>`, + ) + upstream.push('</body></html>') + upstream.close() + finishSerialization() + + await readAll(output as any) + expect(liftCalls).toBe(1) + }) + + test('does not inject stream scripts inside a split barrier script', async () => { + const { router, injectHtml, finishSerialization } = makeRouter({ + liftScriptBarrier: () => { + injectHtml('<script>streamed()</script>') + }, + }) + const upstream = makeManualUpstream() + const output = transformStreamWithRouter( + router as any, + upstream.stream as any, + ) + + upstream.push( + `<html><body><main>app</main><script id="${TSR_SCRIPT_BARRIER_ID}`, + ) + upstream.push(`">initial()`) + upstream.push('</script><section>after</section>') + finishSerialization() + upstream.push('</body></html>') + upstream.close() + + const html = await readAll(output as any) + + expect(html.indexOf('<script>streamed()</script>')).toBeGreaterThan( + html.indexOf('</script><section>after</section>'), + ) + expect(html.indexOf('<script>streamed()</script>')).toBeLessThan( + html.indexOf('</body>'), + ) + }) + + test('remembers a flushed barrier marker until a later closing-tag boundary', async () => { + let liftCalls = 0 + const { router, finishSerialization } = makeRouter({ + liftScriptBarrier: () => { + liftCalls++ + }, + }) + const upstream = makeManualUpstream() + const output = transformStreamWithRouter( + router as any, + upstream.stream as any, + ) + const filler = 'x'.repeat(MAX_LEFTOVER_CHARS + 32) + + upstream.push( + `<html><body><main>app</main><script id="${TSR_SCRIPT_BARRIER_ID}${filler}`, + ) + await flush() + expect(liftCalls).toBe(0) + + upstream.push('initial()</script><section>after</section>') + upstream.push('</body></html>') + upstream.close() + finishSerialization() + + await readAll(output as any) + expect(liftCalls).toBe(1) + }) +}) + +describe('transformStreamWithRouter — cleanup side-effects', () => { + test('downstream cancel propagates upstream and calls serverSsr.cleanup once', async () => { + // Fast path: simpler, no scanner. Verifies cancel + cleanup contract. + const { router, cleanupCalls } = makeRouter({ + isSerializationFinished: () => true, + reserveStreamFastPath: () => true, + takeBufferedHtml: () => undefined, + }) + const upstream = makeManualUpstream() + + const out = transformStreamWithRouter(router as any, upstream.stream as any) + const reader = ( + out as any + ).getReader() as ReadableStreamDefaultReader<Uint8Array> + + // Cancel before any data flows. Should still trigger upstream cancel + // and exactly one cleanup invocation. + await reader.cancel('consumer-gone') + await flush() + + expect(upstream.cancelled.value).toBe(true) + expect(cleanupCalls.count).toBe(1) + }) + + test('downstream cancel waits for upstream cancellation to settle', async () => { + const { router, cleanupCalls } = makeRouter({ + isSerializationFinished: () => true, + reserveStreamFastPath: () => true, + takeBufferedHtml: () => undefined, + }) + + let resolveCancel!: () => void + const upstream = new ReadableStream<Uint8Array>({ + pull() { + // Keep the transform's upstream read pending until cancellation. + }, + cancel() { + return new Promise<void>((resolve) => { + resolveCancel = resolve + }) + }, + }) + + const out = transformStreamWithRouter(router as any, upstream as any) + const reader = ( + out as any + ).getReader() as ReadableStreamDefaultReader<Uint8Array> + + let cancelSettled = false + const cancelPromise = reader.cancel('consumer-gone').then(() => { + cancelSettled = true + }) + + await flush() + expect(cancelSettled).toBe(false) + expect(cleanupCalls.count).toBe(1) + + resolveCancel() + await cancelPromise + expect(cancelSettled).toBe(true) + }) + + test('natural close calls cleanup exactly once', async () => { + const { router, cleanupCalls } = makeRouter({ + isSerializationFinished: () => true, + reserveStreamFastPath: () => true, + takeBufferedHtml: () => undefined, + }) + const upstream = makeManualUpstream() + + const out = transformStreamWithRouter(router as any, upstream.stream as any) + + upstream.push('<html><body>done</body></html>') + upstream.close() + + const text = await readAll(out as any) + expect(text).toContain('done') + expect(cleanupCalls.count).toBe(1) + }) + + test('stream response metadata defers cleanup until body drains', async () => { + const { router, cleanupCalls } = makeRouter({ + isSerializationFinished: () => true, + reserveStreamFastPath: () => true, + takeBufferedHtml: () => undefined, + }) + const upstream = makeManualUpstream() + + const out = transformStreamWithRouter(router as any, upstream.stream as any) + const response = new Response(out as any) + const result = createSsrStreamResponse(router as any, response) + + expect(result.serverSsrCleanup).toBe('stream') + expect(cleanupCalls.count).toBe(0) + + upstream.push('<html><body>done</body></html>') + upstream.close() + + await result.response.text() + expect(cleanupCalls.count).toBe(1) + }) + + test('stream response dispose cancels body and cleans once', async () => { + const { router, cleanupCalls } = makeRouter({ + isSerializationFinished: () => true, + reserveStreamFastPath: () => true, + takeBufferedHtml: () => undefined, + }) + const upstream = makeManualUpstream() + + const out = transformStreamWithRouter(router as any, upstream.stream as any) + const result = createSsrStreamResponse( + router as any, + new Response(out as any), + ) + expect(result.serverSsrCleanup).toBe('stream') + if (result.serverSsrCleanup !== 'stream') return + + await result.dispose('dropped') + await result.dispose('dropped-again') + + expect(upstream.cancelled.value).toBe(true) + expect(cleanupCalls.count).toBe(1) + }) + + test('SSR fast path is used when explicitly safe', async () => { + let takeBufferedHtmlCalls = 0 + let setRenderFinishedCalls = 0 + const { router, cleanupCalls } = makeRouter({ + isSerializationFinished: () => true, + reserveStreamFastPath: () => true, + takeBufferedHtml: () => { + takeBufferedHtmlCalls++ + return undefined + }, + setRenderFinished: () => { + setRenderFinishedCalls++ + }, + }) + const upstream = makeManualUpstream() + + const out = transformStreamWithRouter(router as any, upstream.stream as any) + upstream.push('<html><body>done</body></html>') + upstream.close() + + const text = await readAll(out as any) + expect(text).toBe('<html><body>done</body></html>') + expect(takeBufferedHtmlCalls).toBe(0) + expect(setRenderFinishedCalls).toBe(1) + expect(cleanupCalls.count).toBe(1) + }) + + test('SSR fast path is bypassed when not explicitly safe', async () => { + let takeBufferedHtmlCalls = 0 + let pendingHtml: string | undefined = '<script>pending()</script>' + const { router, injectHtml, finishSerialization } = makeRouter({ + isSerializationFinished: () => true, + reserveStreamFastPath: () => false, + takeBufferedHtml: () => { + takeBufferedHtmlCalls++ + const html = pendingHtml + pendingHtml = undefined + return html + }, + }) + const upstream = makeManualUpstream() + + const out = transformStreamWithRouter(router as any, upstream.stream as any) + upstream.push('<html><body>done</body></html>') + upstream.close() + finishSerialization() + + const text = await readAll(out as any) + expect(text).toContain('<script>pending()</script>') + expect(text.indexOf('<script>pending()</script>')).toBeLessThan( + text.indexOf('</body>'), + ) + expect(takeBufferedHtmlCalls).toBeGreaterThan(0) + }) + + test('SSR fast path errors on unexpected late injection', async () => { + const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {}) + try { + const { router, injectHtml, cleanupCalls } = makeRouter({ + isSerializationFinished: () => true, + reserveStreamFastPath: () => true, + }) + const upstream = makeManualUpstream() + + const out = transformStreamWithRouter( + router as any, + upstream.stream as any, + ) + injectHtml('<script>late()</script>') + + await expect(readAll(out as any)).rejects.toThrow( + 'SSR router HTML injected during fast path', + ) + expect(cleanupCalls.count).toBe(1) + } finally { + errorSpy.mockRestore() + } + }) + + test('lifetime timeout cancels upstream and runs cleanup once', async () => { + vi.useFakeTimers() + try { + const { router, cleanupCalls } = makeRouter({ + isSerializationFinished: () => true, + takeBufferedHtml: () => undefined, + }) + const upstream = makeManualUpstream() + + const out = transformStreamWithRouter( + router as any, + upstream.stream as any, + { lifetimeMs: 10 }, + ) + + // Do NOT consume. Advance fake time past lifetimeMs deterministically. + await vi.advanceTimersByTimeAsync(15) + + expect(upstream.cancelled.value).toBe(true) + expect(cleanupCalls.count).toBe(1) + + // Drain (read errors silently) so vitest doesn't see an unhandled error. + const reader = ( + out as any + ).getReader() as ReadableStreamDefaultReader<Uint8Array> + reader.read().catch(() => {}) + reader.releaseLock() + } finally { + vi.useRealTimers() + } + }) + + test('upstream cancel() that rejects does not produce an unhandled rejection', async () => { + // Some upstream sources may reject when cancel() is called (e.g. their + // own underlying source.cancel throws). safeCancelReader must swallow. + const unhandled: Array<unknown> = [] + const onUnhandled = (e: PromiseRejectionEvent | any) => { + unhandled.push(e?.reason ?? e) + } + process.on('unhandledRejection', onUnhandled) + try { + const { router, cleanupCalls } = makeRouter({ + isSerializationFinished: () => true, + takeBufferedHtml: () => undefined, + }) + + const stream = new ReadableStream<Uint8Array>({ + start() {}, + cancel() { + // Simulate a misbehaving upstream whose cancel rejects. + throw new Error('boom-cancel') + }, + }) + + const out = transformStreamWithRouter(router as any, stream as any) + const reader = ( + out as any + ).getReader() as ReadableStreamDefaultReader<Uint8Array> + + // Consumer goes away → triggers cancelUpstream → upstream cancel throws. + await reader.cancel('consumer-gone').catch(() => {}) + // Allow microtasks for any rejection to surface. + await flush(10) + + expect(cleanupCalls.count).toBe(1) + expect( + unhandled.find( + (e: any) => e && String(e.message || e).includes('boom-cancel'), + ), + ).toBeUndefined() + } finally { + process.off('unhandledRejection', onUnhandled) + } + }) + + test('server cleanup throwing does not prevent terminal stream cleanup', async () => { + const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {}) + try { + const { router, finishSerialization } = makeRouter({ + cleanup: () => { + throw new Error('cleanup-boom') + }, + }) + const upstream = makeManualUpstream() + + const out = transformStreamWithRouter( + router as any, + upstream.stream as any, + ) + upstream.push('<html><body>done</body></html>') + upstream.close() + finishSerialization() + + await expect(readAll(out as any)).resolves.toContain('done') + expect(errorSpy).toHaveBeenCalled() + } finally { + errorSpy.mockRestore() + } + }) + + test('throwing injected listener does not skip transform drain', async () => { + const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {}) + try { + const { router, injectHtml, finishSerialization } = makeRouter() + router.serverSsr!.onInjectedHtml(() => { + throw new Error('external-listener-boom') + }) + const upstream = makeManualUpstream() + + const out = transformStreamWithRouter( + router as any, + upstream.stream as any, + ) + + upstream.push('<html><body><main>app</main>') + injectHtml('<script>drained()</script>') + upstream.push('</body></html>') + upstream.close() + finishSerialization() + + const text = await readAll(out as any) + expect(text).toContain('<script>drained()</script>') + expect(text.indexOf('<script>drained()</script>')).toBeLessThan( + text.indexOf('</body>'), + ) + } finally { + errorSpy.mockRestore() + } + }) + + test('tail overflow errors and runs cleanup', async () => { + const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {}) + try { + const { router, cleanupCalls, finishSerialization } = makeRouter() + const upstream = makeManualUpstream() + + const out = transformStreamWithRouter( + router as any, + upstream.stream as any, + ) + upstream.push(`<html><body>done</body>${'x'.repeat(64 * 1024 + 1)}`) + upstream.close() + finishSerialization() + + await expect(readAll(out as any)).rejects.toThrow( + 'SSR stream tail exceeded maximum buffer', + ) + expect(cleanupCalls.count).toBe(1) + } finally { + errorSpy.mockRestore() + } + }) + + test('router HTML overflow errors and runs cleanup', async () => { + const { router, injectHtml, cleanupCalls } = makeRouter() + const upstream = makeManualUpstream() + + const out = transformStreamWithRouter(router as any, upstream.stream as any) + injectHtml('x'.repeat(MAX_ROUTER_HTML_CHARS + 1)) + + await expect(readAll(out as any)).rejects.toThrow( + 'SSR router HTML exceeded maximum buffer', + ) + expect(cleanupCalls.count).toBe(1) + }) + + test('pending output overflow errors and runs cleanup', async () => { + const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {}) + try { + const { router, cleanupCalls, finishSerialization } = makeRouter() + const upstream = makeManualUpstream() + + const out = transformStreamWithRouter( + router as any, + upstream.stream as any, + ) + upstream.push(`${'x'.repeat(16 * 1024 * 1024 + 1)}</div>`) + upstream.close() + finishSerialization() + + await expect(readAll(out as any)).rejects.toThrow( + 'SSR stream pending output exceeded maximum buffer', + ) + expect(cleanupCalls.count).toBe(1) + } finally { + errorSpy.mockRestore() + } + }) + + test('long text without closing tags partially flushes and keeps bounded leftover', async () => { + const { router, finishSerialization } = makeRouter() + const upstream = makeManualUpstream() + const out = transformStreamWithRouter(router as any, upstream.stream as any) + const reader = (out as any).getReader() + const text = 'x'.repeat(MAX_LEFTOVER_CHARS + 32) + + upstream.push(text) + + const first = await reader.read() + expect(first.done).toBe(false) + const firstText = Buffer.from(first.value).toString('utf8') + expect(firstText).toBe('x'.repeat(32)) + + upstream.close() + finishSerialization() + + let rest = '' + for (;;) { + const { done, value } = await reader.read() + if (done) break + rest += Buffer.from(value).toString('utf8') + } + + expect(firstText + rest).toBe(text) + }) + + test('takeBufferedHtml throwing errors stream and runs cleanup once', async () => { + const { router, cleanupCalls } = makeRouter({ + takeBufferedHtml: () => { + throw new Error('take-buffered-html-boom') + }, + }) + const upstream = makeManualUpstream() + + const out = transformStreamWithRouter(router as any, upstream.stream as any) + + await expect(readAll(out as any)).rejects.toThrow('take-buffered-html-boom') + expect(cleanupCalls.count).toBe(1) + }) + + test('downstream backpressure delays close; no chunks are lost', async () => { + // Consumer reads slowly: we verify all router-injected scripts AND the + // tail closing tags arrive before the stream ends, even though + // tryFinish() requests close while writes are still queued. + const { router, injectHtml, finishSerialization } = makeRouter() + const upstream = makeManualUpstream() + + const out = transformStreamWithRouter(router as any, upstream.stream as any) + + upstream.push('<html><body><div>a</div>') + // Queue many injected chunks while app is still rendering. + for (let i = 0; i < 50; i++) injectHtml(`<script>S${i}</script>`) + upstream.push('</body></html>') + upstream.close() + finishSerialization() + + const full = await readAll(out as any) + + expect(full).toContain('<div>a</div>') + expect(full).toContain('</body></html>') + for (let i = 0; i < 50; i++) { + expect(full).toContain(`<script>S${i}</script>`) + } + // All scripts must appear before </body>. + expect(full.indexOf('<script>S49</script>')).toBeLessThan( + full.indexOf('</body>'), + ) + }) +}) + +describe('transformStreamWithRouter — injected HTML ordering', () => { + test('router-injected HTML interleaves at scanner safe points, not mid-tag', async () => { + const { router, injectHtml, finishSerialization } = makeRouter() + const upstream = makeManualUpstream() + + const out = transformStreamWithRouter(router as any, upstream.stream as any) + + // App emits a chunk ending in a complete closing tag so the scanner + // can release content + flush pending router HTML at a safe boundary. + upstream.push('<html><body><div>app</div>') + // Injected during render — must be buffered, not enqueued ahead of + // pending app content, and not split across closing tags. + injectHtml('<script>X</script>') + injectHtml('<script>Y</script>') + + // Tail chunk: end of body. Triggers pendingClosingTags capture and + // flushPendingRouterHtml before the tail is emitted on tryFinish. + upstream.push('</body></html>') + upstream.close() + finishSerialization() + + const full = await readAll(out as any) + + // Order: app div → scripts → body close. + expect(full).toContain('<div>app</div>') + expect(full).toContain('<script>X</script>') + expect(full).toContain('<script>Y</script>') + expect(full.indexOf('<div>app</div>')).toBeLessThan( + full.indexOf('<script>X</script>'), + ) + expect(full.indexOf('<script>Y</script>')).toBeLessThan( + full.indexOf('</body>'), + ) + }) + + test('onAbort: fires once when downstream cancels (readable wrapper)', async () => { + const { router, finishSerialization } = makeRouter() + finishSerialization() + + let produced = 0 + const upstream = new ReadableStream<Uint8Array>({ + pull(controller) { + produced++ + controller.enqueue(new TextEncoder().encode('<p>x</p>')) + }, + }) + + let aborts = 0 + const out = transformReadableStreamWithRouter( + router as any, + upstream as any, + { onAbort: () => aborts++ }, + ) + + const reader = (out as any).getReader() + await reader.read() + await reader.cancel(new Error('client disconnect')) + // Allow microtasks to flush. + await Promise.resolve() + await Promise.resolve() + + expect(aborts).toBe(1) + expect(produced).toBeGreaterThan(0) + }) + + test('onAbort: NOT called on natural successful completion', async () => { + const { router, finishSerialization } = makeRouter() + + const upstream = new ReadableStream<Uint8Array>({ + start(controller) { + controller.enqueue(new TextEncoder().encode('<p>done</p>')) + controller.close() + }, + }) + + let aborts = 0 + const out = transformReadableStreamWithRouter( + router as any, + upstream as any, + { onAbort: () => aborts++ }, + ) + + // tryFinish gates on serialization-finished; signal it AFTER transform + // has subscribed to the event. + finishSerialization() + + // Drain to completion. + const reader = (out as any).getReader() + while (true) { + const { done } = await reader.read() + if (done) break + } + + expect(aborts).toBe(0) + }) + + test('onAbort: fires when pipeable wrapper consumer destroys', async () => { + const { router, finishSerialization } = makeRouter() + finishSerialization() + + const pass = new PassThrough() + let aborts = 0 + const out = transformPipeableStreamWithRouter(router as any, pass, { + onAbort: () => aborts++, + }) + // Swallow expected error emission from destroy(). + out.on('error', () => {}) + + // Push something so the read loop is engaged. + pass.write('<p>x</p>') + // Wait a tick to let reader start. + await new Promise((r) => setImmediate(r)) + + // Destroy downstream — simulates Node response being closed by client. + out.destroy(new Error('client gone')) + // Allow microtasks + readable webstream cancel propagation. + await new Promise((r) => setImmediate(r)) + await Promise.resolve() + + expect(aborts).toBe(1) + + // Cleanup: destroy upstream so we don't leak. + if (!pass.destroyed) pass.destroy() + }) + + test('onAbort: lifetime timeout triggers abort exactly once', async () => { + vi.useFakeTimers() + const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {}) + const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {}) + try { + const { router, finishSerialization } = makeRouter() + finishSerialization() + + // Upstream that never produces or closes. + const upstream = new ReadableStream<Uint8Array>({ + pull() { + // never enqueue, never close + }, + }) + + let aborts = 0 + + const out = transformReadableStreamWithRouter( + router as any, + upstream as any, + { onAbort: () => aborts++, lifetimeMs: 1000 }, + ) + + // Start reading (which may reject when stream is errored) + const reader = (out as any).getReader() + const readP = reader.read().catch(() => undefined) + + await vi.advanceTimersByTimeAsync(1500) + await readP + + expect(aborts).toBe(1) + } finally { + errorSpy.mockRestore() + warnSpy.mockRestore() + vi.useRealTimers() + } + }) + + test('default lifetime is derived from timeoutMs', async () => { + vi.useFakeTimers() + const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {}) + const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {}) + try { + const { router, finishSerialization } = makeRouter() + finishSerialization() + const upstream = new ReadableStream<Uint8Array>({ + pull() { + // never enqueue, never close + }, + }) + + let aborts = 0 + const out = transformReadableStreamWithRouter( + router as any, + upstream as any, + { onAbort: () => aborts++, timeoutMs: 10 }, + ) + + const reader = (out as any).getReader() + const readP = reader.read().catch(() => undefined) + + await vi.advanceTimersByTimeAsync(15) + expect(aborts).toBe(0) + + await vi.advanceTimersByTimeAsync(6) + await readP + expect(aborts).toBe(1) + } finally { + errorSpy.mockRestore() + warnSpy.mockRestore() + vi.useRealTimers() + } + }) + + test('upstream writable abort surfaces; readable does not hang', async () => { + const { router, finishSerialization } = makeRouter() + finishSerialization() + + // Simulate the Vue sync-setup-throw recovery path: a TransformStream is + // handed to the router transform, and the producer never writes before + // aborting the writable side. The router transform's readable must + // resolve (with done or an error) rather than wait for lifetimeMs. + const ts = new TransformStream() + const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {}) + try { + let aborts = 0 + const out = transformReadableStreamWithRouter( + router as any, + ts.readable as any, + { onAbort: () => aborts++ }, + ) + + void ts.writable.abort(new Error('setup-throw')).catch(() => {}) + + const reader = (out as any).getReader() + // Either the read resolves with done, or it rejects with the abort + // reason. Both prove non-hang behavior; we just require it terminates. + const terminated = await reader + .read() + .then(() => true) + .catch(() => true) + + expect(terminated).toBe(true) + expect(aborts).toBe(1) + } finally { + errorSpy.mockRestore() + } + }) +}) diff --git a/packages/router-core/vite.config.ts b/packages/router-core/vite.config.ts index 816b0602b8..97859dda97 100644 --- a/packages/router-core/vite.config.ts +++ b/packages/router-core/vite.config.ts @@ -7,12 +7,25 @@ import type { ViteUserConfig } from 'vitest/config' const config = defineConfig({ plugins: [minifyScriptPlugin()] as ViteUserConfig['plugins'], + build: { + rolldownOptions: { + output: { + topLevelVar: false, + }, + }, + }, test: { name: packageJson.name, dir: './tests', watch: false, environment: 'jsdom', typecheck: { enabled: true }, + // Perf tests are gated by env var and excluded from default runs. + // To run: RUN_BACKPRESSURE_PERF=1 pnpm vitest run transformStreamBackpressure + exclude: + process.env.RUN_BACKPRESSURE_PERF === '1' + ? ['**/node_modules/**'] + : ['**/*.perf.test.ts', '**/node_modules/**'], alias: { // For tests only, resolve to development.ts which returns undefined // so that router.isServer fallback is used diff --git a/packages/router-devtools-core/CHANGELOG.md b/packages/router-devtools-core/CHANGELOG.md index 6bbe34f997..485adc437f 100644 --- a/packages/router-devtools-core/CHANGELOG.md +++ b/packages/router-devtools-core/CHANGELOG.md @@ -1,5 +1,34 @@ # @tanstack/router-devtools-core +## 1.168.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- Updated dependencies [[`b1c061a`](https://github.com/TanStack/router/commit/b1c061aff9185cdf5fdc08c0136382a9dce0302f), [`201e150`](https://github.com/TanStack/router/commit/201e150bd1412bae2faa9ce53f0fefcb7574ac14)]: + - @tanstack/router-core@1.170.0 + +## 1.167.3 + +### Patch Changes + +- shorten internal non-minifiable store names for byte shaving ([#7152](https://github.com/TanStack/router/pull/7152)) + +- Updated dependencies [[`6355bb7`](https://github.com/TanStack/router/commit/6355bb75f7637ba77f06a923c18fdaf37720bb48)]: + - @tanstack/router-core@1.168.11 + +## 1.167.2 + +### Patch Changes + +- migrate createStore > createAtom for simpler API ([#7150](https://github.com/TanStack/router/pull/7150)) + +- Updated dependencies [[`459057c`](https://github.com/TanStack/router/commit/459057cd2d90cff20d20e51d4964b0a8c950555e)]: + - @tanstack/router-core@1.168.10 + ## 1.167.1 ### Patch Changes diff --git a/packages/router-devtools-core/package.json b/packages/router-devtools-core/package.json index b93ae015d0..f6497adc2e 100644 --- a/packages/router-devtools-core/package.json +++ b/packages/router-devtools-core/package.json @@ -1,6 +1,6 @@ { "name": "@tanstack/router-devtools-core", - "version": "1.167.1", + "version": "1.168.0", "description": "Modern and scalable routing for Web applications", "author": "Tanner Linsley", "license": "MIT", @@ -66,7 +66,7 @@ "goober": "^2.1.16" }, "devDependencies": { - "solid-js": "^1.9.10", + "solid-js": "1.9.12", "vite": "*", "vite-plugin-solid": "^2.11.10" }, diff --git a/packages/router-devtools-core/src/BaseTanStackRouterDevtoolsPanel.tsx b/packages/router-devtools-core/src/BaseTanStackRouterDevtoolsPanel.tsx index 883d07f6a6..a9e804d517 100644 --- a/packages/router-devtools-core/src/BaseTanStackRouterDevtoolsPanel.tsx +++ b/packages/router-devtools-core/src/BaseTanStackRouterDevtoolsPanel.tsx @@ -1,5 +1,10 @@ import { clsx as cx } from 'clsx' -import { interpolatePath, rootRouteId, trimPath } from '@tanstack/router-core' +import { + hasKeys, + interpolatePath, + rootRouteId, + trimPath, +} from '@tanstack/router-core' import { For, Match, @@ -280,44 +285,42 @@ export const BaseTanStackRouterDevtoolsPanel = let pendingMatches: Accessor<Array<AnyRouteMatch>> let cachedMatches: Accessor<Array<AnyRouteMatch>> // subscribable implementation - if ('subscribe' in router().stores.pendingMatchesSnapshot) { - const [_pendingMatches, setPendingMatches] = createSignal< - Array<AnyRouteMatch> - >([]) + if ('subscribe' in router().stores.pendingMatches) { + const [_pendingMatches, setPending] = createSignal<Array<AnyRouteMatch>>( + [], + ) pendingMatches = _pendingMatches - const [_cachedMatches, setCachedMatches] = createSignal< - Array<AnyRouteMatch> - >([]) + const [_cachedMatches, setCached] = createSignal<Array<AnyRouteMatch>>([]) cachedMatches = _cachedMatches type Subscribe = (fn: () => void) => { unsubscribe: () => void } createEffect(() => { - const pendingMatchesStore = router().stores.pendingMatchesSnapshot - setPendingMatches(pendingMatchesStore.state) + const pendingMatchesStore = router().stores.pendingMatches + setPending(pendingMatchesStore.get()) const subscription = ( (pendingMatchesStore as any).subscribe as Subscribe )(() => { - setPendingMatches(pendingMatchesStore.state) + setPending(pendingMatchesStore.get()) }) onCleanup(() => subscription.unsubscribe()) }) createEffect(() => { - const cachedMatchesStore = router().stores.cachedMatchesSnapshot - setCachedMatches(cachedMatchesStore.state) + const cachedMatchesStore = router().stores.cachedMatches + setCached(cachedMatchesStore.get()) const subscription = ( (cachedMatchesStore as any).subscribe as Subscribe )(() => { - setCachedMatches(cachedMatchesStore.state) + setCached(cachedMatchesStore.get()) }) onCleanup(() => subscription.unsubscribe()) }) } // signal implementation else { - pendingMatches = () => router().stores.pendingMatchesSnapshot.state - cachedMatches = () => router().stores.cachedMatchesSnapshot.state + pendingMatches = () => router().stores.pendingMatches.get() + cachedMatches = () => router().stores.cachedMatches.get() } createEffect(() => { @@ -358,9 +361,7 @@ export const BaseTanStackRouterDevtoolsPanel = ) }) - const hasSearch = createMemo( - () => Object.keys(routerState().location.search).length, - ) + const hasSearch = createMemo(() => hasKeys(routerState().location.search)) const explorerState = createMemo(() => { return { diff --git a/packages/router-devtools-core/src/Explorer.tsx b/packages/router-devtools-core/src/Explorer.tsx index a43cb9c95c..1862ecbd16 100644 --- a/packages/router-devtools-core/src/Explorer.tsx +++ b/packages/router-devtools-core/src/Explorer.tsx @@ -3,7 +3,12 @@ import { clsx as cx } from 'clsx' import * as goober from 'goober' import { createMemo, createSignal, useContext } from 'solid-js' import { tokens } from './tokens' -import { displayValue } from './utils' +import { + displayValue, + getServerComponentSlotUsageSummary, + getServerComponentSlots, + getServerComponentType, +} from './utils' import { ShadowDomTargetContext } from './context' import type { Accessor, JSX } from 'solid-js' @@ -12,7 +17,7 @@ type ExpanderProps = { style?: JSX.CSSProperties } -export const Expander = ({ expanded, style = {} }: ExpanderProps) => { +export const Expander = ({ expanded, style: _style = {} }: ExpanderProps) => { const styles = useStyles() return ( <span class={styles().expander}> @@ -90,6 +95,12 @@ function isIterable(x: any): x is Iterable<unknown> { return Symbol.iterator in x } +function isPlainObject(value: unknown): value is Record<string, unknown> { + if (!value || typeof value !== 'object') return false + const proto = Object.getPrototypeOf(value) + return proto === Object.prototype || proto === null +} + export function Explorer({ value, defaultExpanded, @@ -116,7 +127,22 @@ export function Explorer({ } } - if (Array.isArray(value())) { + if ( + Array.isArray(value()) && + (value() as Array<any>).length === 2 && + (value() as Array<any>)[0] === 'React element' && + isPlainObject((value() as Array<any>)[1]) + ) { + // Special case: treat `["React element", { ...meta }]` as sibling entries + // to avoid the meta object being rendered as a deeper nested tree. + const v = value() as ['React element', Record<string, unknown>] + entries = [ + makeProperty({ label: '0', value: v[0] }), + ...Object.entries(v[1]).map(([key, val]) => + makeProperty({ label: key, value: val }), + ), + ] + } else if (Array.isArray(value())) { // any[] entries = (value() as Array<any>).map((d, i) => makeProperty({ @@ -169,9 +195,72 @@ export function Explorer({ /> ) + const serverComponentType = createMemo(() => getServerComponentType(value())) + const serverComponentSlots = createMemo(() => + getServerComponentSlots(value()), + ) + const serverComponentSlotUsageSummary = createMemo(() => + getServerComponentSlotUsageSummary(value()), + ) + + const isCompositeWithSlots = createMemo( + () => + serverComponentType() === 'compositeSource' && + serverComponentSlots().length > 0, + ) + return ( <div class={styles().entry}> - {subEntryPages().length ? ( + {serverComponentType() !== null ? ( + isCompositeWithSlots() ? ( + <> + <button + class={styles().expandButton} + onClick={() => toggleExpanded()} + > + <Expander expanded={expanded() ?? false} /> + <span>{rest.label}:</span> + <span class={styles().compositeComponent}> + {displayValue(value())} + </span> + </button> + {(expanded() ?? false) ? ( + <div class={styles().rscMetaRow}> + <span class={styles().rscMetaLabel}>slots</span> + <div class={styles().subEntries}> + {serverComponentSlots().map((name) => { + const usage = serverComponentSlotUsageSummary()[name] + if (!usage) return null + return ( + <Explorer + label={`${name}:`} + value={() => + usage.invocations.map((args) => + args.length === 1 ? args[0] : args, + ) + } + /> + ) + })} + </div> + </div> + ) : null} + </> + ) : ( + <> + <span>{rest.label}:</span>{' '} + <span + class={ + serverComponentType() === 'compositeSource' + ? styles().compositeComponent + : styles().renderableComponent + } + > + {displayValue(value())} + </span> + </> + ) + ) : subEntryPages().length ? ( <> <button class={styles().expandButton} @@ -250,7 +339,7 @@ export function Explorer({ } const stylesFactory = (shadowDOMTarget?: ShadowRoot) => { - const { colors, font, size, alpha, shadow, border } = tokens + const { colors, font, size, border } = tokens const { fontFamily, lineHeight, size: fontSize } = font const css = shadowDOMTarget ? goober.css.bind({ target: shadowDOMTarget }) @@ -309,6 +398,67 @@ const stylesFactory = (shadowDOMTarget?: ShadowRoot) => { value: css` color: ${colors.purple[400]}; `, + compositeComponent: css` + display: inline-flex; + align-items: center; + padding: 1px ${size[1]}; + border-radius: ${border.radius.full}; + border: 1px solid ${colors.darkGray[500]}; + background: ${colors.darkGray[700]}; + color: ${colors.cyan[300]}; + font-style: normal; + font-weight: ${font.weight.medium}; + `, + renderableComponent: css` + display: inline-flex; + align-items: center; + padding: 1px ${size[1]}; + border-radius: ${border.radius.full}; + border: 1px solid ${colors.darkGray[500]}; + background: ${colors.darkGray[700]}; + color: ${colors.teal[300]}; + font-style: normal; + font-weight: ${font.weight.medium}; + `, + rscMetaRow: css` + display: flex; + gap: ${size[1]}; + align-items: flex-start; + margin-left: calc(${size[3]} + ${size[1]}); + margin-top: ${size[0.5]}; + flex-wrap: wrap; + `, + rscMetaLabel: css` + color: ${colors.gray[500]}; + font-size: ${fontSize['2xs']}; + text-transform: uppercase; + letter-spacing: 0.06em; + padding-top: 2px; + `, + rscChipRow: css` + display: flex; + gap: ${size[1]}; + flex-wrap: wrap; + `, + rscChip: css` + display: inline-flex; + align-items: center; + gap: ${size[0.5]}; + padding: 1px ${size[1]}; + border-radius: ${border.radius.full}; + border: 1px solid ${colors.darkGray[500]}; + background: ${colors.darkGray[800]}; + color: ${colors.gray[200]}; + font-size: ${fontSize['2xs']}; + line-height: ${lineHeight.xs}; + `, + rscChipName: css` + color: ${colors.gray[100]}; + `, + rscChipMeta: css` + color: ${colors.gray[400]}; + font-size: ${fontSize['2xs']}; + `, subEntries: css` margin-left: ${size[2]}; padding-left: ${size[2]}; diff --git a/packages/router-devtools-core/src/utils.tsx b/packages/router-devtools-core/src/utils.tsx index 8e497a09e9..c14bfd80be 100644 --- a/packages/router-devtools-core/src/utils.tsx +++ b/packages/router-devtools-core/src/utils.tsx @@ -104,16 +104,144 @@ export function useIsMounted() { return isMounted } +// Symbols for RSC detection +const SERVER_COMPONENT_STREAM = Symbol.for('tanstack.rsc.stream') +const RENDERABLE_RSC = Symbol.for('tanstack.rsc.renderable') +const RSC_SLOT_USAGES = Symbol.for('tanstack.rsc.slotUsages') + +export type RscSlotUsageEvent = { + slot: string + args?: Array<any> +} + +function trimTrailingUndefined<T>(arr: Array<T>): Array<T> { + let end = arr.length + while (end > 0 && arr[end - 1] === undefined) end-- + if (end === 0) return arr + return end === arr.length ? arr : arr.slice(0, end) +} + +export type ServerComponentType = + | 'compositeSource' // createCompositeComponent result (render via <CompositeComponent src={...} />) + | 'renderableValue' // renderServerComponent result (inline renderable value) + | null // not a server component + +/** + * Checks if a value is any kind of server component + */ +export const isServerComponent = (value: unknown): boolean => { + return ( + (typeof value === 'object' || typeof value === 'function') && + value !== null && + SERVER_COMPONENT_STREAM in value + ) +} + +/** + * Gets the type of server component. + * - RENDERABLE_RSC === true → renderable (from renderServerComponent) + * - RENDERABLE_RSC === false or not present → composite (from createCompositeComponent) + */ +export const getServerComponentType = (value: unknown): ServerComponentType => { + if (!isServerComponent(value)) { + return null + } + const v = value as Record<symbol, unknown> + if (RENDERABLE_RSC in v && v[RENDERABLE_RSC] === true) { + return 'renderableValue' + } + // RENDERABLE_RSC is false or not present → composite + return 'compositeSource' +} + +/** + * Gets the slot names from a composite server component (dev only) + */ +export const getServerComponentSlots = (value: unknown): Array<string> => { + if (!isServerComponent(value)) { + return [] + } + + const v = value as Record<symbol, unknown> + const out: Array<string> = [] + // Include any slot names observed via dev-only slot usage events + if (RSC_SLOT_USAGES in v) { + const usages = v[RSC_SLOT_USAGES] + if (Array.isArray(usages)) { + for (const evt of usages) { + const name = evt?.slot + if (typeof name === 'string' && !out.includes(name)) { + out.push(name) + } + } + } + } + + return out +} + +export const getServerComponentSlotUsages = ( + value: unknown, +): Array<RscSlotUsageEvent> => { + if (!isServerComponent(value)) { + return [] + } + + const v = value as Record<symbol, unknown> + if (!(RSC_SLOT_USAGES in v)) return [] + const usages = v[RSC_SLOT_USAGES] + if (!Array.isArray(usages)) return [] + + return usages.filter((d): d is RscSlotUsageEvent => { + return ( + d && + typeof d === 'object' && + typeof d.slot === 'string' && + (d.args === undefined || Array.isArray(d.args)) + ) + }) +} + +export const getServerComponentSlotUsageSummary = ( + value: unknown, +): Record<string, { count: number; invocations: Array<Array<any>> }> => { + const usages = getServerComponentSlotUsages(value) + const out: Record<string, { count: number; invocations: Array<Array<any>> }> = + {} + for (const evt of usages) { + const args = trimTrailingUndefined(evt.args ?? []) + const prev = + out[evt.slot] ?? (out[evt.slot] = { count: 0, invocations: [] }) + prev.count++ + prev.invocations.push(args) + } + return out +} + /** * Displays a string regardless the type of the data * @param {unknown} value Value to be stringified */ export const displayValue = (value: unknown) => { + if (value === 'React element') return 'React element' + const componentType = getServerComponentType(value) + if (componentType === 'compositeSource') { + const slots = getServerComponentSlots(value) + if (slots.length > 0) { + return `RSC composite source (${slots.length} ${ + slots.length === 1 ? 'slot' : 'slots' + })` + } + return 'RSC composite source' + } + if (componentType === 'renderableValue') { + return 'RSC renderable value' + } const name = Object.getOwnPropertyNames(Object(value)) const newValue = typeof value === 'bigint' ? `${value.toString()}n` : value try { return JSON.stringify(newValue, name) - } catch (e) { + } catch { return `unable to stringify` } } diff --git a/packages/router-devtools/CHANGELOG.md b/packages/router-devtools/CHANGELOG.md index 7a4ad9b4d6..38a9a2be35 100644 --- a/packages/router-devtools/CHANGELOG.md +++ b/packages/router-devtools/CHANGELOG.md @@ -1,5 +1,33 @@ # @tanstack/router-devtools +## 1.167.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- Updated dependencies [[`201e150`](https://github.com/TanStack/router/commit/201e150bd1412bae2faa9ce53f0fefcb7574ac14)]: + - @tanstack/react-router@1.170.0 + - @tanstack/react-router-devtools@1.167.0 + +## 1.166.13 + +### Patch Changes + +- Updated dependencies [[`6355bb7`](https://github.com/TanStack/router/commit/6355bb75f7637ba77f06a923c18fdaf37720bb48)]: + - @tanstack/react-router@1.168.15 + - @tanstack/react-router-devtools@1.166.13 + +## 1.166.12 + +### Patch Changes + +- Updated dependencies [[`459057c`](https://github.com/TanStack/router/commit/459057cd2d90cff20d20e51d4964b0a8c950555e)]: + - @tanstack/react-router@1.168.14 + - @tanstack/react-router-devtools@1.166.12 + ## 1.166.11 ### Patch Changes diff --git a/packages/router-devtools/package.json b/packages/router-devtools/package.json index d4d23453f2..1fadf555a6 100644 --- a/packages/router-devtools/package.json +++ b/packages/router-devtools/package.json @@ -1,6 +1,6 @@ { "name": "@tanstack/router-devtools", - "version": "1.166.11", + "version": "1.167.0", "description": "Modern and scalable routing for React applications", "author": "Tanner Linsley", "license": "MIT", diff --git a/packages/router-generator/CHANGELOG.md b/packages/router-generator/CHANGELOG.md index 0a3cf3f86e..534f1e5d0d 100644 --- a/packages/router-generator/CHANGELOG.md +++ b/packages/router-generator/CHANGELOG.md @@ -1,5 +1,231 @@ # @tanstack/router-generator +## 1.167.12 + +### Patch Changes + +- Updated dependencies [[`2f53749`](https://github.com/TanStack/router/commit/2f5374945e2138559a51464f45a5152eae67e1dd)]: + - @tanstack/router-core@1.171.8 + +## 1.167.11 + +### Patch Changes + +- Updated dependencies [[`d1997b6`](https://github.com/TanStack/router/commit/d1997b66d7c24c1d64772bb8bab5caf9c6d9cc48)]: + - @tanstack/router-core@1.171.7 + +## 1.167.10 + +### Patch Changes + +- Updated dependencies [[`51a97a1`](https://github.com/TanStack/router/commit/51a97a167fb3ef1b8ca70fbb63db635158f43509)]: + - @tanstack/router-core@1.171.6 + +## 1.167.9 + +### Patch Changes + +- Updated dependencies [[`5268ba4`](https://github.com/TanStack/router/commit/5268ba4566233ea58880df85f167ad0401a93a46)]: + - @tanstack/router-core@1.171.5 + +## 1.167.8 + +### Patch Changes + +- Preserve escaped underscore segments when generating index routes across physical and virtual route trees, including pathless layouts, `physical()` prefixes, and `__virtual.ts` subtrees. ([#7453](https://github.com/TanStack/router/pull/7453)) + +## 1.167.7 + +### Patch Changes + +- Updated dependencies [[`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960), [`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960)]: + - @tanstack/router-core@1.171.4 + +## 1.167.6 + +### Patch Changes + +- Updated dependencies [[`5fa9e55`](https://github.com/TanStack/router/commit/5fa9e555f3a2edb5e45586623e6bcbfa7f7c7a6b)]: + - @tanstack/router-core@1.171.3 + - @tanstack/router-utils@1.162.1 + +## 1.167.5 + +### Patch Changes + +- Fix route mismatch warnings, HMR route index refresh, and generated route type preferences for duplicate pathless/index routes. ([#7422](https://github.com/TanStack/router/pull/7422)) + +- Updated dependencies [[`b60eb36`](https://github.com/TanStack/router/commit/b60eb36e59e8a468ee0742cbcf7f47aca1ff1c67)]: + - @tanstack/router-core@1.171.2 + +## 1.167.4 + +### Patch Changes + +- Updated dependencies [[`d9cf933`](https://github.com/TanStack/router/commit/d9cf9331b83fcbd2abfee75d839d862f9bb18e6b)]: + - @tanstack/router-core@1.171.1 + +## 1.167.3 + +### Patch Changes + +- Updated dependencies [[`d533f87`](https://github.com/TanStack/router/commit/d533f87976704098a40b48f160b37c28c8182806)]: + - @tanstack/router-core@1.171.0 + +## 1.167.2 + +### Patch Changes + +- Fix literal underscore route paths when they are nested under pathless layouts. Virtual `route()` paths now treat leading and trailing underscores as literal URL path characters, while physical file routes continue to use bracket escapes for literal underscore segments. ([#7408](https://github.com/TanStack/router/pull/7408)) + +## 1.167.1 + +### Patch Changes + +- Updated dependencies [[`2387a2e`](https://github.com/TanStack/router/commit/2387a2eea0683004cc400b9f71bed5944eb60110)]: + - @tanstack/router-core@1.170.1 + +## 1.167.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- Resolve tsconfig path aliases when loading virtual route config files. ([#7382](https://github.com/TanStack/router/pull/7382)) + +- Updated dependencies [[`b1c061a`](https://github.com/TanStack/router/commit/b1c061aff9185cdf5fdc08c0136382a9dce0302f), [`201e150`](https://github.com/TanStack/router/commit/201e150bd1412bae2faa9ce53f0fefcb7574ac14)]: + - @tanstack/router-core@1.170.0 + - @tanstack/router-utils@1.162.0 + - @tanstack/virtual-file-routes@1.162.0 + +## 1.166.42 + +### Patch Changes + +- Bump jiti dependency to 2.7.0. ([#7355](https://github.com/TanStack/router/pull/7355)) + +## 1.166.41 + +### Patch Changes + +- Updated dependencies [[`35e88f0`](https://github.com/TanStack/router/commit/35e88f04996d71019a1868b7b06ecb4ddbc9df9e)]: + - @tanstack/router-core@1.169.2 + +## 1.166.40 + +### Patch Changes + +- Parse plain TypeScript files without JSX when a filename is available, preventing angle-bracket type assertions from being interpreted as JSX during route and Start import-protection transforms. ([#7342](https://github.com/TanStack/router/pull/7342)) + +- Updated dependencies [[`056337e`](https://github.com/TanStack/router/commit/056337ef02ccbeaf45ec8533a227761be869e8f3)]: + - @tanstack/router-utils@1.161.8 + +## 1.166.39 + +### Patch Changes + +- Updated dependencies [[`4a1e63f`](https://github.com/TanStack/router/commit/4a1e63f1d1230b1ed8234609acad4639d8982c13)]: + - @tanstack/router-core@1.169.1 + +## 1.166.38 + +### Patch Changes + +- Updated dependencies [[`c992495`](https://github.com/TanStack/router/commit/c992495bf4010ff4c3597bb1f3b1ba02594e857e)]: + - @tanstack/router-core@1.169.0 + +## 1.166.37 + +### Patch Changes + +- Updated dependencies [[`b5c4183`](https://github.com/TanStack/router/commit/b5c4183ab8b44be8a75647b7f7b588ad7c146ece)]: + - @tanstack/router-core@1.168.18 + +## 1.166.36 + +### Patch Changes + +- Updated dependencies [[`493148b`](https://github.com/TanStack/router/commit/493148bc5378b7f9de1544d87f6aaa425c12eb34)]: + - @tanstack/router-core@1.168.17 + +## 1.166.35 + +### Patch Changes + +- Use jiti instead of tsx to load virtual route config files. ([#7261](https://github.com/TanStack/router/pull/7261)) + +## 1.166.34 + +### Patch Changes + +- Updated dependencies [[`4d864ee`](https://github.com/TanStack/router/commit/4d864eebbd184265eabb563d326ab409c93feb17)]: + - @tanstack/router-core@1.168.16 + +## 1.166.33 + +### Patch Changes + +- Updated dependencies [[`91a7089`](https://github.com/TanStack/router/commit/91a708989d00537a21911e74ff60bbfec8266295)]: + - @tanstack/router-utils@1.161.7 + +## 1.166.32 + +### Patch Changes + +- Updated dependencies [[`16f6892`](https://github.com/TanStack/router/commit/16f6892d6b7ceadf606677c5a40e743f29163aa6)]: + - @tanstack/router-core@1.168.15 + +## 1.166.31 + +### Patch Changes + +- Fix malformed generated paths when a `physical()` mount points at a subtree rooted by `__virtual.ts`, including nested virtual layouts that mount additional physical routes. ([#7169](https://github.com/TanStack/router/pull/7169)) + +## 1.166.30 + +### Patch Changes + +- Fix route file transforms to preserve route ID quoting, handle more exported `Route` patterns, and avoid incorrect import rewrites in edge cases. ([#7167](https://github.com/TanStack/router/pull/7167)) + + Improve transform robustness with clearer route-call detection, safer import removal, and expanded test coverage for quote preservation, constructor swaps, and unsupported route definitions. + +## 1.166.29 + +### Patch Changes + +- Updated dependencies [[`0e2c900`](https://github.com/TanStack/router/commit/0e2c9003c18ae07c09969189c028f277ea562a7a)]: + - @tanstack/router-core@1.168.14 + +## 1.166.28 + +### Patch Changes + +- Updated dependencies [[`812792f`](https://github.com/TanStack/router/commit/812792fbda3caf97b300770855cf5641252f413b)]: + - @tanstack/router-core@1.168.13 + +## 1.166.27 + +### Patch Changes + +- Updated dependencies [[`8ec9ca9`](https://github.com/TanStack/router/commit/8ec9ca97b472779de878c2a6510f21deb24d386c)]: + - @tanstack/router-core@1.168.12 + +## 1.166.26 + +### Patch Changes + +- Updated dependencies [[`6355bb7`](https://github.com/TanStack/router/commit/6355bb75f7637ba77f06a923c18fdaf37720bb48)]: + - @tanstack/router-core@1.168.11 + +## 1.166.25 + +### Patch Changes + +- Updated dependencies [[`459057c`](https://github.com/TanStack/router/commit/459057cd2d90cff20d20e51d4964b0a8c950555e)]: + - @tanstack/router-core@1.168.10 + ## 1.166.24 ### Patch Changes diff --git a/packages/router-generator/package.json b/packages/router-generator/package.json index 9a8b95134a..1e11a0fe49 100644 --- a/packages/router-generator/package.json +++ b/packages/router-generator/package.json @@ -1,6 +1,6 @@ { "name": "@tanstack/router-generator", - "version": "1.166.24", + "version": "1.167.12", "description": "Modern and scalable routing for React applications", "author": "Tanner Linsley", "license": "MIT", @@ -65,18 +65,18 @@ "node": ">=20.19" }, "dependencies": { + "@babel/types": "^7.28.5", "@tanstack/router-core": "workspace:*", "@tanstack/router-utils": "workspace:*", "@tanstack/virtual-file-routes": "workspace:*", + "jiti": "^2.7.0", + "magic-string": "^0.30.21", "prettier": "^3.5.0", - "recast": "^0.23.11", - "source-map": "^0.7.4", - "tsx": "^4.19.2", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { "@tanstack/react-router": "workspace:*", - "vite": "*", - "@types/node": ">=20" + "@types/node": ">=20", + "vite": "*" } } diff --git a/packages/router-generator/src/config.ts b/packages/router-generator/src/config.ts index f9680d9d36..5c719183db 100644 --- a/packages/router-generator/src/config.ts +++ b/packages/router-generator/src/config.ts @@ -49,7 +49,6 @@ export type BaseConfig = z.infer<typeof baseConfigSchema> export const configSchema = baseConfigSchema.extend({ generatedRouteTree: z.string().optional().default('./src/routeTree.gen.ts'), disableTypes: z.boolean().optional().default(false), - verboseFileRoutes: z.boolean().optional(), addExtensions: z .union([z.boolean(), z.string()]) .optional() @@ -61,7 +60,7 @@ export const configSchema = baseConfigSchema.extend({ routeTreeFileFooter: z .union([ z.array(z.string()).optional().default([]), - z.function().returns(z.array(z.string())), + z.custom<() => Array<string>>((value) => typeof value === 'function'), ]) .optional(), autoCodeSplitting: z.boolean().optional(), diff --git a/packages/router-generator/src/filesystem/physical/getRouteNodes.ts b/packages/router-generator/src/filesystem/physical/getRouteNodes.ts index 8d25e7b71a..09e7fc6c25 100644 --- a/packages/router-generator/src/filesystem/physical/getRouteNodes.ts +++ b/packages/router-generator/src/filesystem/physical/getRouteNodes.ts @@ -1,9 +1,12 @@ import path from 'node:path' import * as fsp from 'node:fs/promises' import { + cleanPath, + createRoutePathSegmentMetadata, determineInitialRoutePath, escapeRegExp, hasEscapedLeadingUnderscore, + joinRoutePathSegmentMetadata, removeExt, replaceBackslash, routePathToVariable, @@ -121,16 +124,31 @@ export async function getRouteNodes( ) allPhysicalDirectories.push(...physicalDirectories) virtualRouteNodes.forEach((node) => { - const filePath = replaceBackslash(path.join(dir, node.filePath)) - const routePath = `/${dir}${node.routePath}` + const normalizedDir = dir === './' ? '' : dir + const filePath = replaceBackslash( + path.join(normalizedDir, node.filePath), + ) + const { routePath: prefixPath, originalRoutePath: originalPrefixPath } = + normalizedDir + ? determineInitialRoutePath(normalizedDir) + : { routePath: '', originalRoutePath: '' } + const routePath = cleanPath(`${prefixPath}${node.routePath}`) node.variableName = routePathToVariable( - `${dir}/${removeExt(node.filePath)}`, + cleanPath(`${prefixPath}/${removeExt(node.filePath)}`), + ) + node._routePathSegmentMetadata = joinRoutePathSegmentMetadata( + routePath, + prefixPath, + createRoutePathSegmentMetadata(prefixPath, originalPrefixPath), + node._routePathSegmentMetadata, ) node.routePath = routePath // Keep originalRoutePath aligned with routePath for escape detection if (node.originalRoutePath) { - node.originalRoutePath = `/${dir}${node.originalRoutePath}` + node.originalRoutePath = cleanPath( + `${originalPrefixPath}${node.originalRoutePath}`, + ) } node.filePath = filePath // Virtual subtree nodes (from __virtual.ts) are embedded in a @@ -298,10 +316,6 @@ export async function getRouteNodes( routePath = '/' } - if (lastOriginalSegment === updatedLastRouteSegment) { - originalRoutePath = '/' - } - // For layout routes, don't use '/' fallback - an empty path means // "layout for the parent path" which is important for physical() mounts // where route.tsx at root should have empty path, not '/' @@ -328,6 +342,10 @@ export async function getRouteNodes( variableName, _fsRouteType: routeType, originalRoutePath, + _routePathSegmentMetadata: createRoutePathSegmentMetadata( + routePath, + originalRoutePath, + ), }) } }), diff --git a/packages/router-generator/src/filesystem/virtual/getRouteNodes.ts b/packages/router-generator/src/filesystem/virtual/getRouteNodes.ts index 3a603d5769..509b1be321 100644 --- a/packages/router-generator/src/filesystem/virtual/getRouteNodes.ts +++ b/packages/router-generator/src/filesystem/virtual/getRouteNodes.ts @@ -1,6 +1,10 @@ import path, { join, resolve } from 'node:path' import { + cleanPath, + createLiteralRoutePathSegmentMetadata, + createRoutePathSegmentMetadata, determineInitialRoutePath, + joinRoutePathSegmentMetadata, removeExt, removeLeadingSlash, removeTrailingSlash, @@ -148,6 +152,12 @@ export async function getRouteNodesRecursive( const children = await Promise.all( nodes.map(async (node) => { if (node.type === 'physical') { + const { + routePath: routePathPrefix, + originalRoutePath: originalRoutePathPrefix, + } = node.pathPrefix + ? determineInitialRoutePath(removeLeadingSlash(node.pathPrefix)) + : { routePath: '', originalRoutePath: '' } const { routeNodes, physicalDirectories } = await getRouteNodesPhysical( { ...tsrConfig, @@ -161,13 +171,30 @@ export async function getRouteNodesRecursive( ...physicalDirectories, ) routeNodes.forEach((subtreeNode) => { - subtreeNode.variableName = routePathToVariable( - `${node.pathPrefix}/${removeExt(subtreeNode.filePath)}`, + const pathPrefix = cleanPath( + `${parent?.routePath ?? ''}${routePathPrefix}`, ) - subtreeNode.routePath = `${parent?.routePath ?? ''}${node.pathPrefix}${subtreeNode.routePath}` + const originalPathPrefix = cleanPath( + `${parent?.originalRoutePath ?? parent?.routePath ?? ''}${originalRoutePathPrefix}`, + ) + const literalPathPrefixSegments = + createLiteralRoutePathSegmentMetadata(pathPrefix, parent, true) + const routePath = cleanPath(`${pathPrefix}${subtreeNode.routePath}`) + subtreeNode.variableName = routePathToVariable( + `${routePathPrefix}/${removeExt(subtreeNode.filePath)}`, + ) + subtreeNode._routePathSegmentMetadata = joinRoutePathSegmentMetadata( + routePath, + pathPrefix, + literalPathPrefixSegments, + subtreeNode._routePathSegmentMetadata, + ) + subtreeNode.routePath = routePath // Keep originalRoutePath aligned with routePath for escape detection if (subtreeNode.originalRoutePath) { - subtreeNode.originalRoutePath = `${parent?.routePath ?? ''}${node.pathPrefix}${subtreeNode.originalRoutePath}` + subtreeNode.originalRoutePath = cleanPath( + `${originalPathPrefix}${subtreeNode.originalRoutePath}`, + ) } subtreeNode.filePath = `${node.directory}/${subtreeNode.filePath}` }) @@ -181,17 +208,25 @@ export async function getRouteNodesRecursive( return { filePath, variableName, fullPath } } const parentRoutePath = removeTrailingSlash(parent?.routePath ?? '/') + const parentOriginalRoutePath = removeTrailingSlash( + parent?.originalRoutePath ?? parent?.routePath ?? '/', + ) const virtualParentRoutePath = parent?.routePath ?? `/${rootPathId}` switch (node.type) { case 'index': { const { filePath, variableName, fullPath } = getFile(node.file) const routePath = `${parentRoutePath}/` + const originalRoutePath = `${parentOriginalRoutePath}/` return { filePath, fullPath, variableName, routePath, + originalRoutePath, + _routePathSegmentMetadata: parent?._routePathSegmentMetadata + ? [...parent._routePathSegmentMetadata] + : undefined, _fsRouteType: 'static', _virtualParentRoutePath: virtualParentRoutePath, } satisfies RouteNode @@ -207,8 +242,9 @@ export async function getRouteNodesRecursive( originalRoutePath: originalSegment, } = determineInitialRoutePath(removeLeadingSlash(lastSegment)) const routePath = `${parentRoutePath}${escapedSegment}` - // Store the original path with brackets for escape detection - const originalRoutePath = `${parentRoutePath}${originalSegment}` + const originalRoutePath = `${parentOriginalRoutePath}${originalSegment}` + const routePathSegmentMetadata = + createLiteralRoutePathSegmentMetadata(routePath, parent, true) if (node.file) { const { filePath, variableName, fullPath } = getFile(node.file) @@ -218,6 +254,7 @@ export async function getRouteNodesRecursive( variableName, routePath, originalRoutePath, + _routePathSegmentMetadata: routePathSegmentMetadata, _fsRouteType: 'static', _virtualParentRoutePath: virtualParentRoutePath, } @@ -228,6 +265,7 @@ export async function getRouteNodesRecursive( variableName: routePathToVariable(routePath), routePath, originalRoutePath, + _routePathSegmentMetadata: routePathSegmentMetadata, isVirtual: true, _fsRouteType: 'static', _virtualParentRoutePath: virtualParentRoutePath, @@ -270,7 +308,13 @@ export async function getRouteNodesRecursive( } = determineInitialRoutePath(removeLeadingSlash(lastSegment)) const routePath = `${parentRoutePath}${escapedSegment}` // Store the original path with brackets for escape detection - const originalRoutePath = `${parentRoutePath}${originalSegment}` + const originalRoutePath = `${parentOriginalRoutePath}${originalSegment}` + const routePathSegmentMetadata = joinRoutePathSegmentMetadata( + routePath, + parentRoutePath, + parent?._routePathSegmentMetadata, + createRoutePathSegmentMetadata(escapedSegment, originalSegment), + ) const routeNode: RouteNode = { fullPath, @@ -278,6 +322,7 @@ export async function getRouteNodesRecursive( variableName, routePath, originalRoutePath, + _routePathSegmentMetadata: routePathSegmentMetadata, _fsRouteType: 'pathless_layout', _virtualParentRoutePath: virtualParentRoutePath, } diff --git a/packages/router-generator/src/filesystem/virtual/loadConfigFile.ts b/packages/router-generator/src/filesystem/virtual/loadConfigFile.ts index f49a79c492..a4606e4e19 100644 --- a/packages/router-generator/src/filesystem/virtual/loadConfigFile.ts +++ b/packages/router-generator/src/filesystem/virtual/loadConfigFile.ts @@ -1,8 +1,10 @@ -import { pathToFileURL } from 'node:url' -import { tsImport } from 'tsx/esm/api' +import { createJiti } from 'jiti' export async function loadConfigFile(filePath: string) { - const fileURL = pathToFileURL(filePath).href - const loaded = await tsImport(fileURL, './') + const jiti = createJiti(filePath, { + interopDefault: false, + tsconfigPaths: true, + }) + const loaded = await jiti.import<any>(filePath) return loaded } diff --git a/packages/router-generator/src/generator.ts b/packages/router-generator/src/generator.ts index 9de0c2b023..4203f2b44f 100644 --- a/packages/router-generator/src/generator.ts +++ b/packages/router-generator/src/generator.ts @@ -17,6 +17,8 @@ import { buildRouteTreeConfig, checkFileExists, checkRouteFullPathUniqueness, + countRoutePathSegments, + countSlashSeparatedParts, createRouteNodesByFullPath, createRouteNodesById, createRouteNodesByTo, @@ -25,19 +27,16 @@ import { findParent, format, getImportForRouteNode, - getImportPath, getResolvedRouteNodeVariableName, hasParentRoute, - isRouteNodeValidForAugmentation, isSegmentPathless, mergeImportDeclarations, multiSortBy, removeExt, removeGroups, removeLastSegmentFromPath, - removeLayoutSegmentsWithEscape, + removeLayoutSegmentsAndUnderscoresWithEscape, removeTrailingSlash, - removeUnderscoresWithEscape, replaceBackslash, trimPathLeft, } from './utils' @@ -53,6 +52,7 @@ import type { HandleNodeAccumulator, ImportDeclaration, RouteNode, + RoutePathSegmentMetadata, } from './types' import type { Config } from './config' import type { Logger } from './logger' @@ -72,6 +72,32 @@ interface fs { chown: (filePath: string, uid: number, gid: number) => Promise<void> } +function getRoutePathSegmentMetadataForPath( + node: RouteNode, + routePath: string, + parentRoutePath?: string, +): Array<RoutePathSegmentMetadata | undefined> | undefined { + if (!node._routePathSegmentMetadata) return undefined + + const segments = routePath.split('/') + const result = new Array<RoutePathSegmentMetadata | undefined>( + segments.length, + ) + const parentSegmentCount = countRoutePathSegments(parentRoutePath) + let hasMetadata = false + let segmentCount = 0 + + for (let i = 0; i < segments.length; i++) { + if (!segments[i]) continue + const sourceIndex = parentSegmentCount + segmentCount + 1 + result[i] = node._routePathSegmentMetadata[sourceIndex] + hasMetadata ||= !!result[i] + segmentCount++ + } + + return hasMetadata ? result : undefined +} + const DefaultFileSystem: fs = { stat: async (filePath) => { const res = await fsp.stat(filePath, { bigint: true }) @@ -272,7 +298,7 @@ export class Generator { return new Map( [...this.routeNodeCache.entries()].map(([filePath, cacheEntry]) => [ filePath, - { routePath: cacheEntry.routeId }, + { routeId: cacheEntry.routeId }, ]), ) } @@ -394,7 +420,10 @@ export class Generator { const preRouteNodes = multiSortBy(beforeRouteNodes, [ (d) => (d.routePath === '/' ? -1 : 1), - (d) => d.routePath?.split('/').length, + (d) => + d.routePath === undefined + ? undefined + : countSlashSeparatedParts(d.routePath), (d) => (d.filePath.match(this.indexTokenFilenameRegex) ? 1 : -1), (d) => (d.filePath.match(Generator.componentPieceRegex) ? 1 : -1), (d) => (d.filePath.match(this.routeTokenFilenameRegex) ? -1 : 1), @@ -589,7 +618,10 @@ export class Generator { const sortedRouteNodes = multiSortBy(acc.routeNodes, [ (d) => (d.routePath?.includes(`/${rootPathId}`) ? -1 : 1), - (d) => d.routePath?.split('/').length, + (d) => + d.routePath === undefined + ? undefined + : countSlashSeparatedParts(d.routePath), (d) => { const segments = d.routePath?.split('/').filter(Boolean) ?? [] const last = segments[segments.length - 1] ?? '' @@ -658,38 +690,6 @@ export class Generator { } imports.push(runtimeImport) } - if (config.verboseFileRoutes === false) { - const typeImport: ImportDeclaration = { - specifiers: [], - source: this.targetTemplate.fullPkg, - importKind: 'type', - } - let needsCreateFileRoute = false - let needsCreateLazyFileRoute = false - for (const node of sortedRouteNodes) { - if (isRouteNodeValidForAugmentation(node)) { - if (node._fsRouteType !== 'lazy') { - needsCreateFileRoute = true - } - if (acc.routePiecesByPath[node.routePath!]?.lazy) { - needsCreateLazyFileRoute = true - } - } - if (needsCreateFileRoute && needsCreateLazyFileRoute) break - } - if (needsCreateFileRoute) { - typeImport.specifiers.push({ imported: 'CreateFileRoute' }) - } - if (needsCreateLazyFileRoute) { - typeImport.specifiers.push({ imported: 'CreateLazyFileRoute' }) - } - - if (typeImport.specifiers.length > 0) { - typeImport.specifiers.push({ imported: 'FileRoutesByPath' }) - imports.push(typeImport) - } - } - const routeTreeConfig = buildRouteTreeConfig( acc.routeTree, config.disableTypes, @@ -963,36 +963,6 @@ ${acc.routeTree.map((child) => `${child.variableName}Route: typeof ${getResolved const importStatements = mergedImports.map(buildImportString) - let moduleAugmentation = '' - if (config.verboseFileRoutes === false && !config.disableTypes) { - moduleAugmentation = opts.routeFileResult - .map((node) => { - const getModuleDeclaration = (routeNode?: RouteNode) => { - if (!isRouteNodeValidForAugmentation(routeNode)) { - return '' - } - let moduleAugmentation = '' - if (routeNode._fsRouteType === 'lazy') { - moduleAugmentation = `const createLazyFileRoute: CreateLazyFileRoute<FileRoutesByPath['${routeNode.routePath}']['preLoaderRoute']>` - } else { - moduleAugmentation = `const createFileRoute: CreateFileRoute<'${routeNode.routePath}', - FileRoutesByPath['${routeNode.routePath}']['parentRoute'], - FileRoutesByPath['${routeNode.routePath}']['id'], - FileRoutesByPath['${routeNode.routePath}']['path'], - FileRoutesByPath['${routeNode.routePath}']['fullPath'] - > - ` - } - - return `declare module './${getImportPath(routeNode, config, this.generatedRouteTreePath)}' { - ${moduleAugmentation} - }` - } - return getModuleDeclaration(node) - }) - .join('\n') - } - const rootRouteImport = getImportForRouteNode( rootRouteNode, config, @@ -1020,7 +990,6 @@ ${acc.routeTree.map((child) => `${child.variableName}Route: typeof ${getResolved createUpdateRoutes.join('\n'), fileRoutesByFullPath, fileRoutesByPathInterface, - moduleAugmentation, routeTreeConfig.join('\n'), routeTree, ...footer, @@ -1134,11 +1103,11 @@ ${acc.routeTree.map((child) => `${child.variableName}Route: typeof ${getResolved // transform the file const transformResult = await transform({ source: updatedCacheEntry.fileContent, + filename: node.fullPath, ctx: { target: this.config.target, routeId: escapedRoutePath, lazy: node._fsRouteType === 'lazy', - verboseFileRoutes: !(this.config.verboseFileRoutes === false), }, node, }) @@ -1495,29 +1464,39 @@ ${acc.routeTree.map((child) => `${child.variableName}Route: typeof ${getResolved node.path = determineNodePath(node) const trimmedPath = trimPathLeft(node.path ?? '') - const trimmedOriginalPath = trimPathLeft( - node.originalRoutePath?.replace( - node.parent?.originalRoutePath ?? '', - '', - ) ?? '', + const originalPath = + node.originalRoutePath && node.parent?.originalRoutePath + ? node.originalRoutePath.replace(node.parent.originalRoutePath, '') || + '/' + : node.originalRoutePath + const routePathSegmentMetadata = getRoutePathSegmentMetadataForPath( + node, + node.path ?? '/', + node.parent?.routePath, ) + const trimmedOriginalPath = trimPathLeft(originalPath ?? '') const split = trimmedPath.split('/') + const pathSplit = (node.path ?? '').split('/') const originalSplit = trimmedOriginalPath.split('/') const lastRouteSegment = split[split.length - 1] ?? trimmedPath const lastOriginalSegment = originalSplit[originalSplit.length - 1] ?? trimmedOriginalPath + const lastRouteSegmentMetadata = + routePathSegmentMetadata?.[pathSplit.length - 1] // A segment is non-path if it starts with underscore AND the underscore is not escaped node.isNonPath = - isSegmentPathless(lastRouteSegment, lastOriginalSegment) || + (!lastRouteSegmentMetadata?.literalLeadingUnderscore && + isSegmentPathless(lastRouteSegment, lastOriginalSegment)) || split.every((part) => this.routeGroupPatternRegex.test(part)) - // Use escape-aware functions to compute cleanedPath + // Use a single pass so layout removal does not desync escaped underscore checks. node.cleanedPath = removeGroups( - removeUnderscoresWithEscape( - removeLayoutSegmentsWithEscape(node.path, node.originalRoutePath), - node.originalRoutePath, + removeLayoutSegmentsAndUnderscoresWithEscape( + node.path, + originalPath, + routePathSegmentMetadata, ), ) @@ -1595,13 +1574,17 @@ ${acc.routeTree.map((child) => `${child.variableName}Route: typeof ${getResolved candidate.originalRoutePath ?? '', '', ) || '/' + const routePathSegmentMetadataRelativeToParent = + getRoutePathSegmentMetadataForPath( + node, + pathRelativeToParent, + candidate.routePath, + ) node.cleanedPath = removeGroups( - removeUnderscoresWithEscape( - removeLayoutSegmentsWithEscape( - pathRelativeToParent, - originalPathRelativeToParent, - ), + removeLayoutSegmentsAndUnderscoresWithEscape( + pathRelativeToParent, originalPathRelativeToParent, + routePathSegmentMetadataRelativeToParent, ), ) break diff --git a/packages/router-generator/src/index.ts b/packages/router-generator/src/index.ts index de3df56d77..9a4f8a17ff 100644 --- a/packages/router-generator/src/index.ts +++ b/packages/router-generator/src/index.ts @@ -45,10 +45,4 @@ export { getRouteNodes as virtualGetRouteNodes } from './filesystem/virtual/getR export { rootPathId } from './filesystem/physical/rootPathId' -export { ensureStringArgument } from './transform/utils' - -export type { - TransformImportsConfig, - TransformContext, - TransformOptions, -} from './transform/types' +export type { TransformContext, TransformOptions } from './transform/types' diff --git a/packages/router-generator/src/template.ts b/packages/router-generator/src/template.ts index 69031f689c..11ca968933 100644 --- a/packages/router-generator/src/template.ts +++ b/packages/router-generator/src/template.ts @@ -44,6 +44,10 @@ export type TargetTemplate = { } } +function serializeRoutePath(routePath: string) { + return JSON.stringify(routePath) +} + export function getTargetTemplate(config: Config): TargetTemplate { const target = config.target switch (target) { @@ -77,13 +81,9 @@ export function getTargetTemplate(config: Config): TargetTemplate { ].join(''), imports: { tsrImports: () => - config.verboseFileRoutes === false - ? '' - : "import { createFileRoute } from '@tanstack/react-router';", + "import { createFileRoute } from '@tanstack/react-router';", tsrExportStart: (routePath) => - config.verboseFileRoutes === false - ? 'export const Route = createFileRoute(' - : `export const Route = createFileRoute('${routePath}')(`, + `export const Route = createFileRoute(${serializeRoutePath(routePath)})(`, tsrExportEnd: () => ');', }, }, @@ -97,13 +97,9 @@ export function getTargetTemplate(config: Config): TargetTemplate { ].join(''), imports: { tsrImports: () => - config.verboseFileRoutes === false - ? '' - : "import { createLazyFileRoute } from '@tanstack/react-router';", + "import { createLazyFileRoute } from '@tanstack/react-router';", tsrExportStart: (routePath) => - config.verboseFileRoutes === false - ? 'export const Route = createLazyFileRoute(' - : `export const Route = createLazyFileRoute('${routePath}')(`, + `export const Route = createLazyFileRoute(${serializeRoutePath(routePath)})(`, tsrExportEnd: () => ');', }, }, @@ -138,13 +134,9 @@ export function getTargetTemplate(config: Config): TargetTemplate { ].join(''), imports: { tsrImports: () => - config.verboseFileRoutes === false - ? '' - : "import { createFileRoute } from '@tanstack/solid-router';", + "import { createFileRoute } from '@tanstack/solid-router';", tsrExportStart: (routePath) => - config.verboseFileRoutes === false - ? 'export const Route = createFileRoute(' - : `export const Route = createFileRoute('${routePath}')(`, + `export const Route = createFileRoute(${serializeRoutePath(routePath)})(`, tsrExportEnd: () => ');', }, }, @@ -158,14 +150,10 @@ export function getTargetTemplate(config: Config): TargetTemplate { ].join(''), imports: { tsrImports: () => - config.verboseFileRoutes === false - ? '' - : "import { createLazyFileRoute } from '@tanstack/solid-router';", + "import { createLazyFileRoute } from '@tanstack/solid-router';", tsrExportStart: (routePath) => - config.verboseFileRoutes === false - ? 'export const Route = createLazyFileRoute(' - : `export const Route = createLazyFileRoute('${routePath}')(`, + `export const Route = createLazyFileRoute(${serializeRoutePath(routePath)})(`, tsrExportEnd: () => ');', }, @@ -202,13 +190,9 @@ export function getTargetTemplate(config: Config): TargetTemplate { ].join(''), imports: { tsrImports: () => - config.verboseFileRoutes === false - ? '' - : "import { createFileRoute } from '@tanstack/vue-router';", + "import { createFileRoute } from '@tanstack/vue-router';", tsrExportStart: (routePath) => - config.verboseFileRoutes === false - ? 'export const Route = createFileRoute(' - : `export const Route = createFileRoute('${routePath}')(`, + `export const Route = createFileRoute(${serializeRoutePath(routePath)})(`, tsrExportEnd: () => ');', }, }, @@ -223,14 +207,10 @@ export function getTargetTemplate(config: Config): TargetTemplate { ].join(''), imports: { tsrImports: () => - config.verboseFileRoutes === false - ? '' - : "import { createLazyFileRoute } from '@tanstack/vue-router';", + "import { createLazyFileRoute } from '@tanstack/vue-router';", tsrExportStart: (routePath) => - config.verboseFileRoutes === false - ? 'export const Route = createLazyFileRoute(' - : `export const Route = createLazyFileRoute('${routePath}')(`, + `export const Route = createLazyFileRoute(${serializeRoutePath(routePath)})(`, tsrExportEnd: () => ');', }, diff --git a/packages/router-generator/src/transform/transform.ts b/packages/router-generator/src/transform/transform.ts index 7b3fddb9f2..9fcad87948 100644 --- a/packages/router-generator/src/transform/transform.ts +++ b/packages/router-generator/src/transform/transform.ts @@ -1,529 +1,717 @@ +import MagicString from 'magic-string' +import * as t from '@babel/types' import { parseAst } from '@tanstack/router-utils' -import { parse, print, types, visit } from 'recast' -import { SourceMapConsumer } from 'source-map' -import { mergeImportDeclarations } from '../utils' -import { ensureStringArgument } from './utils' -import type { ImportDeclaration } from '../types' -import type { RawSourceMap } from 'source-map' import type { TransformOptions, TransformResult } from './types' -const b = types.builders +const routeConstructors = ['createFileRoute', 'createLazyFileRoute'] as const -export async function transform({ +type RouteConstructorName = (typeof routeConstructors)[number] +type SupportedRouteId = t.StringLiteral | t.TemplateLiteral +type NamedImport = { + imported: string + local: string + importKind?: 'type' | 'typeof' | 'value' +} + +type ParsedImportDeclaration = { + declaration: t.ImportDeclaration + defaultImport?: string + namespace?: string + named: Array<NamedImport> + moduleName: string + quote: '"' | "'" + semicolon: boolean +} + +type RouteImportAnalysis = + | { kind: 'ok' } + | { + kind: 'rename' + imported: t.Identifier + local: t.Identifier + next: RouteConstructorName + } + | { kind: 'normalize' } + +type RouteCall = { + callee: t.Identifier & { name: RouteConstructorName } + routeIdArg: SupportedRouteId + optionsArg: t.CallExpression['arguments'][number] | undefined +} + +type RouteCallAnalysis = { + calls: Array<RouteCall> + hasUnsupportedRouteId: boolean + hasMalformedRouteCall: boolean +} + +export function transform({ ctx, source, + filename, node, -}: TransformOptions): Promise<TransformResult> { - let appliedChanges = false as boolean - let ast: types.namedTypes.File +}: TransformOptions): TransformResult { + let ast: ReturnType<typeof parseAst> + try { - ast = parse(source, { - sourceFileName: 'output.ts', - parser: { - parse(code: string) { - return parseAst({ - code, - // we need to instruct babel to produce tokens, - // otherwise recast will try to generate the tokens via its own parser and will fail - tokens: true, - }) - }, - }, - }) - } catch (e) { - console.error('Error parsing code', ctx.routeId, source, e) + ast = parseAst({ code: source, filename }) + } catch (error) { return { result: 'error', - error: e, + error, } } - const preferredQuote = detectPreferredQuoteStyle(ast) + const exportedRouteNames = getExportedRouteNames(ast.program.body) - let routeExportHandled = false as boolean - function onExportFound(decl: types.namedTypes.VariableDeclarator) { - if (decl.init?.type === 'CallExpression') { - const callExpression = decl.init - const firstArgument = callExpression.arguments[0] - if (firstArgument) { - if (firstArgument.type === 'ObjectExpression') { - const staticProperties = firstArgument.properties.flatMap((p) => { - if (p.type === 'ObjectProperty' && p.key.type === 'Identifier') { - return p.key.name - } - return [] - }) - node.createFileRouteProps = new Set(staticProperties) - } - } - let identifier: types.namedTypes.Identifier | undefined - // `const Route = createFileRoute({ ... })` - if (callExpression.callee.type === 'Identifier') { - identifier = callExpression.callee - if (ctx.verboseFileRoutes) { - // we need to add the string literal via another CallExpression - callExpression.callee = b.callExpression(identifier, [ - b.stringLiteral(ctx.routeId), - ]) - appliedChanges = true - } - } - // `const Route = createFileRoute('/path')({ ... })` - else if ( - callExpression.callee.type === 'CallExpression' && - callExpression.callee.callee.type === 'Identifier' - ) { - identifier = callExpression.callee.callee - if (!ctx.verboseFileRoutes) { - // we need to remove the route id - callExpression.callee = identifier - appliedChanges = true - } else { - // check if the route id is correct - appliedChanges = ensureStringArgument( - callExpression.callee, - ctx.routeId, - ctx.preferredQuote, - ) - } - } - if (identifier === undefined) { - throw new Error( - `expected identifier to be present in ${ctx.routeId} for export "Route"`, - ) - } - if (identifier.name === 'createFileRoute' && ctx.lazy) { - identifier.name = 'createLazyFileRoute' - appliedChanges = true - } else if (identifier.name === 'createLazyFileRoute' && !ctx.lazy) { - identifier.name = 'createFileRoute' - appliedChanges = true - } - } else { - throw new Error( - `expected "Route" export to be initialized by a CallExpression`, - ) - } - routeExportHandled = true + if (exportedRouteNames.size === 0) { + return { result: 'no-route-export' } } - const program: types.namedTypes.Program = ast.program - // first pass: find Route export - for (const n of program.body) { - if (n.type === 'ExportNamedDeclaration') { - // direct export of a variable declaration, e.g. `export const Route = createFileRoute('/path')` - if (n.declaration?.type === 'VariableDeclaration') { - const decl = n.declaration.declarations[0] - if ( - decl && - decl.type === 'VariableDeclarator' && - decl.id.type === 'Identifier' - ) { - if (decl.id.name === 'Route') { - onExportFound(decl) - } - } - } - // this is an export without a declaration, e.g. `export { Route }` - else if (n.declaration === null && n.specifiers) { - for (const spec of n.specifiers) { - if (typeof spec.exported.name === 'string') { - if (spec.exported.name === 'Route') { - const variableName = spec.local?.name || spec.exported.name - // find the matching variable declaration by iterating over the top-level declarations - for (const decl of program.body) { - if ( - decl.type === 'VariableDeclaration' && - decl.declarations[0] - ) { - const variable = decl.declarations[0] - if ( - variable.type === 'VariableDeclarator' && - variable.id.type === 'Identifier' && - variable.id.name === variableName - ) { - onExportFound(variable) - break - } - } - } - } - } - } - } - } - if (routeExportHandled) { - break - } - } + const { + calls: routeCalls, + hasUnsupportedRouteId, + hasMalformedRouteCall, + } = findExportedRouteCalls(ast.program.body, exportedRouteNames) - if (!routeExportHandled) { + if (routeCalls.length === 0 && hasMalformedRouteCall) { return { - result: 'no-route-export', + result: 'error', + error: new Error( + `expected Route export in ${ctx.routeId} to use createFileRoute('/path')({...}) or createLazyFileRoute('/path')({...})`, + ), } } - const imports: { - required: Array<ImportDeclaration> - banned: Array<ImportDeclaration> - } = { - required: [], - banned: [], + if (routeCalls.length === 0 && hasUnsupportedRouteId) { + return { + result: 'error', + error: new Error( + `expected route id to be a string literal or plain template literal in ${ctx.routeId}`, + ), + } } + if (routeCalls.length === 0) { + return { result: 'not-modified' } + } + + if (routeCalls.length > 1) { + return { + result: 'error', + error: new Error( + `expected exactly one createFileRoute/createLazyFileRoute call in ${ctx.routeId}`, + ), + } + } + + const routeCall = routeCalls[0]! + const routeIdQuote = getRouteIdQuote(source, routeCall.routeIdArg) + + const createFileRouteProps = getCreateFileRouteProps(routeCall.optionsArg) + if (createFileRouteProps) { + node.createFileRouteProps = createFileRouteProps + } + + const expectedCallee = getExpectedRouteConstructor(ctx.lazy) + const expectedRouteId = `${routeIdQuote}${ctx.routeId}${routeIdQuote}` + const currentRouteId = source.slice( + routeCall.routeIdArg.start!, + routeCall.routeIdArg.end!, + ) const targetModule = `@tanstack/${ctx.target}-router` - if (ctx.verboseFileRoutes === false) { - imports.banned = [ - { - source: targetModule, - specifiers: [ - { imported: 'createLazyFileRoute' }, - { imported: 'createFileRoute' }, - ], - }, - ] - } else { - if (ctx.lazy) { - imports.required = [ - { - source: targetModule, - specifiers: [{ imported: 'createLazyFileRoute' }], - }, - ] - imports.banned = [ - { - source: targetModule, - specifiers: [{ imported: 'createFileRoute' }], - }, - ] - } else { - imports.required = [ - { - source: targetModule, - specifiers: [{ imported: 'createFileRoute' }], - }, - ] - imports.banned = [ - { - source: targetModule, - specifiers: [{ imported: 'createLazyFileRoute' }], - }, - ] - } + const imports = parseTargetImports(ast.program.body, source, targetModule) + + const s = new MagicString(source) + let modified = false + + if (routeCall.callee.name !== expectedCallee) { + s.update(routeCall.callee.start!, routeCall.callee.end!, expectedCallee) + modified = true } - imports.required = mergeImportDeclarations(imports.required) - imports.banned = mergeImportDeclarations(imports.banned) - - const importStatementCandidates: Array<types.namedTypes.ImportDeclaration> = - [] - const importDeclarationsToRemove: Array<types.namedTypes.ImportDeclaration> = - [] - - // second pass: apply import rules, but only if a matching export for the plugin was found - for (const n of program.body) { - const findImport = - (opts: { source: string; importKind?: 'type' | 'value' | 'typeof' }) => - (i: ImportDeclaration) => { - if (i.source === opts.source) { - const importKind = i.importKind || 'value' - const expectedImportKind = opts.importKind || 'value' - return expectedImportKind === importKind - } - return false - } - if (n.type === 'ImportDeclaration' && typeof n.source.value === 'string') { - const filterImport = findImport({ - source: n.source.value, - importKind: n.importKind, - }) - let requiredImports = imports.required.filter(filterImport)[0] - - const bannedImports = imports.banned.filter(filterImport)[0] - if (!requiredImports && !bannedImports) { - continue - } - const importSpecifiersToRemove: types.namedTypes.ImportDeclaration['specifiers'] = - [] - if (n.specifiers) { - for (const spec of n.specifiers) { - if (!requiredImports && !bannedImports) { - break - } - if ( - spec.type === 'ImportSpecifier' && - typeof spec.imported.name === 'string' - ) { - if (requiredImports) { - const requiredImportIndex = requiredImports.specifiers.findIndex( - (imp) => imp.imported === spec.imported.name, - ) - if (requiredImportIndex !== -1) { - // import is already present, remove it from requiredImports - requiredImports.specifiers.splice(requiredImportIndex, 1) - if (requiredImports.specifiers.length === 0) { - imports.required = imports.required.splice( - imports.required.indexOf(requiredImports), - 1, - ) - requiredImports = undefined - } - } else { - // add the import statement to the candidates - importStatementCandidates.push(n) - } - } - if (bannedImports) { - const bannedImportIndex = bannedImports.specifiers.findIndex( - (imp) => imp.imported === spec.imported.name, - ) - if (bannedImportIndex !== -1) { - importSpecifiersToRemove.push(spec) - } - } - } - } - if (importSpecifiersToRemove.length > 0) { - appliedChanges = true - n.specifiers = n.specifiers.filter( - (spec) => !importSpecifiersToRemove.includes(spec), - ) - - // mark the import statement as to be deleted if it is now empty - if (n.specifiers.length === 0) { - importDeclarationsToRemove.push(n) - } - } - } - } - } - imports.required.forEach((requiredImport) => { - if (requiredImport.specifiers.length > 0) { - appliedChanges = true - if (importStatementCandidates.length > 0) { - // find the first import statement that matches both the module and the import kind - const importStatement = importStatementCandidates.find( - (importStatement) => { - if (importStatement.source.value === requiredImport.source) { - const importKind = importStatement.importKind || 'value' - const requiredImportKind = requiredImport.importKind || 'value' - return importKind === requiredImportKind - } - return false - }, - ) - if (importStatement) { - if (importStatement.specifiers === undefined) { - importStatement.specifiers = [] - } - const importSpecifiersToAdd = requiredImport.specifiers.map((spec) => - b.importSpecifier( - b.identifier(spec.imported), - b.identifier(spec.imported), - ), - ) - importStatement.specifiers = [ - ...importStatement.specifiers, - ...importSpecifiersToAdd, - ] - return - } - } - const importStatement = b.importDeclaration( - requiredImport.specifiers.map((spec) => - b.importSpecifier( - b.identifier(spec.imported), - spec.local ? b.identifier(spec.local) : null, - ), - ), - b.stringLiteral(requiredImport.source), - ) - program.body.unshift(importStatement) - } - }) - if (importDeclarationsToRemove.length > 0) { - appliedChanges = true - for (const importDeclaration of importDeclarationsToRemove) { - // check if the import declaration is still empty - if (importDeclaration.specifiers?.length === 0) { - const index = program.body.indexOf(importDeclaration) - if (index !== -1) { - program.body.splice(index, 1) - } - } - } + if (currentRouteId !== expectedRouteId) { + s.update( + routeCall.routeIdArg.start!, + routeCall.routeIdArg.end!, + expectedRouteId, + ) + modified = true } - if (!appliedChanges) { - return { - result: 'not-modified', - } - } - - const printResult = print(ast, { - reuseWhitespace: true, - sourceMapName: 'output.map', - }) - let transformedCode = printResult.code - if (printResult.map) { - const fixedOutput = await fixTransformedOutputText({ - originalCode: source, - transformedCode, - sourceMap: printResult.map as RawSourceMap, - preferredQuote, + if ( + updateRouteImports({ + imports, + source, + s, + targetModule, + required: expectedCallee, + lineEnding: getLineEnding(source), }) - transformedCode = fixedOutput + ) { + modified = true } + + if (!modified) { + return { result: 'not-modified' } + } + return { result: 'modified', - output: transformedCode, + output: s.toString(), } } -async function fixTransformedOutputText({ - originalCode, - transformedCode, - sourceMap, - preferredQuote, -}: { - originalCode: string - transformedCode: string - sourceMap: RawSourceMap - preferredQuote: '"' | "'" -}) { - const originalLines = originalCode.split('\n') - const transformedLines = transformedCode.split('\n') +function getExportedRouteNames(body: Array<t.Statement>) { + const exportedRouteNames = new Set<string>() - const defaultUsesSemicolons = detectSemicolonUsage(originalCode) + for (const statement of body) { + if (!t.isExportNamedDeclaration(statement) || statement.source) { + continue + } - const consumer = await new SourceMapConsumer(sourceMap) - - const fixedLines = transformedLines.map((line, i) => { - const transformedLineNum = i + 1 - - let origLineText: string | undefined = undefined - - for (let col = 0; col < line.length; col++) { - const mapped = consumer.originalPositionFor({ - line: transformedLineNum, - column: col, - }) - if (mapped.line != null && mapped.line > 0) { - origLineText = originalLines[mapped.line - 1] - break + if (t.isVariableDeclaration(statement.declaration)) { + for (const declarator of statement.declaration.declarations) { + if (t.isIdentifier(declarator.id) && declarator.id.name === 'Route') { + exportedRouteNames.add('Route') + } } } - if (origLineText !== undefined) { - if (origLineText === line) { - return origLineText + for (const specifier of statement.specifiers) { + if ( + !t.isExportSpecifier(specifier) || + getExportedName(specifier.exported) !== 'Route' + ) { + continue } - return fixLine(line, { - originalLine: origLineText, - useOriginalSemicolon: true, - useOriginalQuotes: true, - fallbackQuote: preferredQuote, - }) - } else { - return fixLine(line, { - originalLine: null, - useOriginalSemicolon: false, - useOriginalQuotes: false, - fallbackQuote: preferredQuote, - fallbackSemicolon: defaultUsesSemicolons, - }) - } - }) - return fixedLines.join('\n') + const localName = getLocalBindingName(specifier.local) + if (localName) { + exportedRouteNames.add(localName) + } + } + } + + return exportedRouteNames } -function fixLine( - line: string, - { - originalLine, - useOriginalSemicolon, - useOriginalQuotes, - fallbackQuote, - fallbackSemicolon = true, - }: { - originalLine: string | null - useOriginalSemicolon: boolean - useOriginalQuotes: boolean - fallbackQuote: string - fallbackSemicolon?: boolean - }, +function findExportedRouteCalls( + body: Array<t.Statement>, + exportedRouteNames: Set<string>, +): RouteCallAnalysis { + const calls: Array<RouteCall> = [] + let hasUnsupportedRouteId = false + let hasMalformedRouteCall = false + + for (const statement of body) { + const declaration = getVariableDeclaration(statement) + if (!declaration) { + continue + } + + for (const declarator of declaration.declarations) { + if ( + !t.isIdentifier(declarator.id) || + !exportedRouteNames.has(declarator.id.name) + ) { + continue + } + + const init = getRouteConstructorInit(declarator.init) + if (!init) { + if (isDirectRouteConstructorCall(declarator.init)) { + hasMalformedRouteCall = true + } + continue + } + + const routeIdArg = init.innerCall.arguments[0] + if (isSupportedRouteId(routeIdArg)) { + calls.push({ + callee: init.callee, + routeIdArg, + optionsArg: init.outerCall.arguments[0], + }) + } else { + hasUnsupportedRouteId = true + } + } + } + + return { calls, hasUnsupportedRouteId, hasMalformedRouteCall } +} + +function getVariableDeclaration(statement: t.Statement) { + const declaration = t.isExportNamedDeclaration(statement) + ? statement.declaration + : statement + + return t.isVariableDeclaration(declaration) ? declaration : null +} + +function getExportedName(node: t.Identifier | t.StringLiteral) { + return t.isIdentifier(node) ? node.name : node.value +} + +function getLocalBindingName(node: t.Identifier | t.StringLiteral) { + return t.isIdentifier(node) ? node.name : null +} + +function getRouteConstructorInit(expression: t.Expression | null | undefined) { + if (!expression || !t.isCallExpression(expression)) { + return null + } + + if (!t.isCallExpression(expression.callee)) { + return null + } + + const innerCall = expression.callee + + if ( + !t.isIdentifier(innerCall.callee) || + !isRouteConstructor(innerCall.callee) + ) { + return null + } + + return { + callee: innerCall.callee, + outerCall: expression, + innerCall, + } +} + +function isDirectRouteConstructorCall( + expression: t.Expression | null | undefined, ) { - let result = line - - if (useOriginalQuotes && originalLine) { - result = fixQuotes(result, originalLine, fallbackQuote) - } else if (!useOriginalQuotes && fallbackQuote) { - result = fixQuotesToPreferred(result, fallbackQuote) - } - - if (useOriginalSemicolon && originalLine) { - const hadSemicolon = originalLine.trimEnd().endsWith(';') - const hasSemicolon = result.trimEnd().endsWith(';') - if (hadSemicolon && !hasSemicolon) result += ';' - if (!hadSemicolon && hasSemicolon) result = result.replace(/;\s*$/, '') - } else if (!useOriginalSemicolon) { - const hasSemicolon = result.trimEnd().endsWith(';') - if (!fallbackSemicolon && hasSemicolon) result = result.replace(/;\s*$/, '') - if (fallbackSemicolon && !hasSemicolon && result.trim()) result += ';' - } - - return result -} - -function fixQuotes(line: string, originalLine: string, fallbackQuote: string) { - let originalQuote = detectQuoteFromLine(originalLine) - if (!originalQuote) { - originalQuote = fallbackQuote - } - return fixQuotesToPreferred(line, originalQuote) -} - -function fixQuotesToPreferred(line: string, quote: string) { - // Replace existing quotes with preferred quote - return line.replace( - /(['"`])([^'"`\\]*(?:\\.[^'"`\\]*)*)\1/g, - (_, q, content) => { - const escaped = content.replaceAll(quote, `\\${quote}`) - return `${quote}${escaped}${quote}` - }, + return ( + !!expression && + t.isCallExpression(expression) && + t.isIdentifier(expression.callee) && + isRouteConstructor(expression.callee) ) } -function detectQuoteFromLine(line: string) { - const match = line.match(/(['"`])(?:\\.|[^\\])*?\1/) - return match ? match[1] : null +function isRouteConstructor(callee: t.Identifier): callee is t.Identifier & { + name: RouteConstructorName +} { + return routeConstructors.includes(callee.name as RouteConstructorName) } -function detectSemicolonUsage(code: string) { - const lines = code.split('\n').map((l) => l.trim()) - const total = lines.length - const withSemis = lines.filter((l) => l.endsWith(';')).length - return withSemis > total / 2 +function isSupportedRouteId( + arg: t.CallExpression['arguments'][number] | undefined, +): arg is SupportedRouteId { + return ( + !!arg && + (t.isStringLiteral(arg) || + (t.isTemplateLiteral(arg) && arg.expressions.length === 0)) + ) } -export function detectPreferredQuoteStyle(ast: types.ASTNode): "'" | '"' { - let single = 0 - let double = 0 +function getRouteIdQuote( + source: string, + arg: SupportedRouteId, +): '"' | "'" | '`' { + const raw = source.slice(arg.start!, arg.end!) - visit(ast, { - visitStringLiteral(path) { - if (path.parent.node.type !== 'JSXAttribute') { - const raw = path.node.extra?.raw - if (raw?.startsWith("'")) single++ - else if (raw?.startsWith('"')) double++ - } - return false - }, - }) + if (raw.startsWith("'")) return "'" + if (raw.startsWith('"')) return '"' + return '`' +} - if (single >= double) { - return "'" +function getCreateFileRouteProps( + arg: t.CallExpression['arguments'][number] | undefined, +) { + if (!arg || !t.isObjectExpression(arg)) { + return undefined } - return '"' + + const props = new Set<string>() + + for (const property of arg.properties) { + if (!t.isObjectProperty(property) || property.computed) { + continue + } + + if (t.isIdentifier(property.key)) { + props.add(property.key.name) + continue + } + + if (t.isStringLiteral(property.key)) { + props.add(property.key.value) + } + } + + return props +} + +function parseTargetImports( + body: Array<t.Statement>, + source: string, + targetModule: string, +) { + const imports: Array<ParsedImportDeclaration> = [] + + for (const statement of body) { + if ( + !t.isImportDeclaration(statement) || + statement.importKind === 'type' || + statement.source.value !== targetModule + ) { + continue + } + + const rawSource = source.slice( + statement.source.start!, + statement.source.end!, + ) + const importStatement = source.slice(statement.start!, statement.end!) + + imports.push({ + declaration: statement, + defaultImport: statement.specifiers.find((specifier) => + t.isImportDefaultSpecifier(specifier), + )?.local.name, + namespace: statement.specifiers.find((specifier) => + t.isImportNamespaceSpecifier(specifier), + )?.local.name, + named: statement.specifiers + .filter((specifier): specifier is t.ImportSpecifier => + t.isImportSpecifier(specifier), + ) + .map((specifier) => ({ + imported: t.isIdentifier(specifier.imported) + ? specifier.imported.name + : specifier.imported.value, + local: specifier.local.name, + importKind: specifier.importKind ?? undefined, + })), + moduleName: statement.source.value, + quote: rawSource[0] as '"' | "'", + semicolon: importStatement.trimEnd().endsWith(';'), + }) + } + + return imports +} + +function updateRouteImports({ + imports, + source, + s, + targetModule, + required, + lineEnding, +}: { + imports: Array<ParsedImportDeclaration> + source: string + s: MagicString + targetModule: string + required: RouteConstructorName + lineEnding: '\r\n' | '\n' | '\r' +}) { + const analysis = analyzeRouteImports(imports, required) + + if (analysis.kind === 'ok') { + return false + } + + if (analysis.kind === 'rename') { + s.update(analysis.imported.start!, analysis.imported.end!, analysis.next) + s.update(analysis.local.start!, analysis.local.end!, analysis.next) + return true + } + + return normalizeRouteImports({ + imports, + source, + s, + targetModule, + required, + lineEnding, + }) +} + +function analyzeRouteImports( + imports: Array<ParsedImportDeclaration>, + required: RouteConstructorName, +): RouteImportAnalysis { + const opposite = getOtherRouteConstructor(required) + let requiredCount = 0 + let oppositeCount = 0 + let renameCandidate: + | { + imported: t.Identifier + local: t.Identifier + next: RouteConstructorName + } + | undefined + + for (const declaration of imports) { + for (const specifier of declaration.declaration.specifiers) { + if (!t.isImportSpecifier(specifier)) { + continue + } + + const imported = specifier.imported + if (!t.isIdentifier(imported)) { + return { kind: 'normalize' } + } + + if (!isRouteConstructorName(imported.name)) { + continue + } + + if (specifier.local.name !== imported.name) { + return { kind: 'normalize' } + } + + if (imported.name === required) { + requiredCount++ + continue + } + + if (imported.name === opposite) { + oppositeCount++ + renameCandidate = { + imported, + local: specifier.local, + next: required, + } + } + } + } + + if (requiredCount === 1 && oppositeCount === 0) { + return { kind: 'ok' } + } + + if (requiredCount === 0 && oppositeCount === 1 && renameCandidate) { + return { + kind: 'rename', + ...renameCandidate, + } + } + + return { kind: 'normalize' } +} + +function normalizeRouteImports({ + imports, + source, + s, + targetModule, + required, + lineEnding, +}: { + imports: Array<ParsedImportDeclaration> + source: string + s: MagicString + targetModule: string + required: RouteConstructorName + lineEnding: '\r\n' | '\n' | '\r' +}) { + const owner = + imports.find((declaration) => + hasNamedImport(declaration.named, required), + ) ?? imports.find((declaration) => !declaration.namespace) + + let modified = false + + for (const declaration of imports) { + const named = normalizeNamedImports({ + named: declaration.named, + required, + isOwner: declaration === owner, + }) + + if (sameNamedImports(declaration.named, named)) { + continue + } + + const replacement = renderImportDeclaration({ + ...declaration, + named, + }) + + if (replacement === null) { + s.remove( + declaration.declaration.start!, + getRemovalEnd(source, declaration.declaration.end!), + ) + modified = true + continue + } + + s.update( + declaration.declaration.start!, + declaration.declaration.end!, + replacement, + ) + modified = true + } + + if (!owner) { + const quote = imports[0]?.quote ?? "'" + const semicolon = imports[0]?.semicolon ?? false + s.prepend( + `import { ${required} } from ${quote}${targetModule}${quote}${semicolon ? ';' : ''}${lineEnding}`, + ) + modified = true + } + + return modified +} + +function normalizeNamedImports({ + named, + required, + isOwner, +}: { + named: Array<NamedImport> + required: RouteConstructorName + isOwner: boolean +}) { + const banned = getOtherRouteConstructor(required) + const nextNamed: Array<NamedImport> = [] + const seen = new Set<string>() + + for (const specifier of named) { + if (specifier.imported === banned) { + continue + } + + if ( + specifier.local === required && + (specifier.imported !== required || !isOwner) + ) { + continue + } + + const key = `${specifier.importKind ?? 'value'}:${specifier.imported}:${specifier.local}` + if (seen.has(key)) { + continue + } + + seen.add(key) + nextNamed.push(specifier) + } + + if (isOwner && !hasNamedImport(nextNamed, required)) { + nextNamed.push({ imported: required, local: required }) + } + + return nextNamed +} + +function getExpectedRouteConstructor(lazy: boolean): RouteConstructorName { + return lazy ? 'createLazyFileRoute' : 'createFileRoute' +} + +function getOtherRouteConstructor( + constructor: RouteConstructorName, +): RouteConstructorName { + return constructor === 'createFileRoute' + ? 'createLazyFileRoute' + : 'createFileRoute' +} + +function hasNamedImport( + named: Array<NamedImport>, + required: RouteConstructorName, +) { + return named.some( + (specifier) => + specifier.imported === required && + specifier.local === required && + specifier.importKind !== 'type', + ) +} + +function sameNamedImports(left: Array<NamedImport>, right: Array<NamedImport>) { + return ( + left.length === right.length && + left.every( + (specifier, index) => + specifier.imported === right[index]!.imported && + specifier.local === right[index]!.local && + specifier.importKind === right[index]!.importKind, + ) + ) +} + +function isRouteConstructorName(value: string): value is RouteConstructorName { + return routeConstructors.includes(value as RouteConstructorName) +} + +function renderImportDeclaration(importDeclaration: { + defaultImport?: string + namespace?: string + named: Array<NamedImport> + moduleName: string + quote: '"' | "'" + semicolon: boolean +}) { + const parts: Array<string> = [] + + if (importDeclaration.defaultImport) { + parts.push(importDeclaration.defaultImport) + } + + if (importDeclaration.namespace) { + parts.push(`* as ${importDeclaration.namespace}`) + } + + if (importDeclaration.named.length > 0) { + parts.push( + `{ ${importDeclaration.named + .map( + (specifier) => + `${specifier.importKind === 'type' ? 'type ' : ''}${specifier.imported === specifier.local ? specifier.imported : `${specifier.imported} as ${specifier.local}`}`, + ) + .join(', ')} }`, + ) + } + + if (parts.length === 0) { + return null + } + + return `import ${parts.join(', ')} from ${importDeclaration.quote}${importDeclaration.moduleName}${importDeclaration.quote}${importDeclaration.semicolon ? ';' : ''}` +} + +function getLineEnding(source: string): '\r\n' | '\n' | '\r' { + if (source.includes('\r\n')) { + return '\r\n' + } + + if (source.includes('\n')) { + return '\n' + } + + if (source.includes('\r')) { + return '\r' + } + + return '\n' +} + +function getRemovalEnd(source: string, end: number) { + let pos = end + while (pos < source.length && (source[pos] === ' ' || source[pos] === '\t')) { + pos++ + } + + if (source[pos] === '\r' && source[pos + 1] === '\n') { + return pos + 2 + } + + if (source[pos] === '\n' || source[pos] === '\r') { + return pos + 1 + } + + return end } diff --git a/packages/router-generator/src/transform/types.ts b/packages/router-generator/src/transform/types.ts index f8b75f6003..4a8fecaada 100644 --- a/packages/router-generator/src/transform/types.ts +++ b/packages/router-generator/src/transform/types.ts @@ -1,8 +1,9 @@ -import type { ImportDeclaration, RouteNode } from '../types' +import type { RouteNode } from '../types' import type { Config } from '../config' export interface TransformOptions { source: string + filename?: string ctx: TransformContext node: RouteNode } @@ -23,15 +24,8 @@ export type TransformResult = error?: any } -export interface TransformImportsConfig { - banned?: Array<ImportDeclaration> - required?: Array<ImportDeclaration> -} - export interface TransformContext { target: Config['target'] routeId: string lazy: boolean - verboseFileRoutes: boolean - preferredQuote?: '"' | "'" } diff --git a/packages/router-generator/src/transform/utils.ts b/packages/router-generator/src/transform/utils.ts deleted file mode 100644 index 9fa9ac8fe2..0000000000 --- a/packages/router-generator/src/transform/utils.ts +++ /dev/null @@ -1,42 +0,0 @@ -import { types } from 'recast' - -const b = types.builders - -export function ensureStringArgument( - callExpression: types.namedTypes.CallExpression, - value: string, - preferredQuote?: "'" | '"', -) { - const argument = callExpression.arguments[0] - if (!argument) { - let stringLiteral: types.namedTypes.StringLiteral - if (!preferredQuote) { - stringLiteral = b.stringLiteral.from({ value }) - } else { - stringLiteral = b.stringLiteral.from({ - value, - extra: { - rawValue: value, - raw: `${preferredQuote}${value}${preferredQuote}`, - }, - }) - } - callExpression.arguments.push(stringLiteral) - return true - } else if (argument.type === 'StringLiteral') { - if (argument.value !== value) { - argument.value = value - return true - } - } else if (argument.type === 'TemplateLiteral') { - if ( - argument.quasis.length === 1 && - argument.quasis[0] && - argument.quasis[0].value.raw !== value - ) { - argument.quasis[0].value.raw = value - return true - } - } - return false -} diff --git a/packages/router-generator/src/types.ts b/packages/router-generator/src/types.ts index 2161e62c00..ec0aa226ce 100644 --- a/packages/router-generator/src/types.ts +++ b/packages/router-generator/src/types.ts @@ -1,3 +1,8 @@ +export type RoutePathSegmentMetadata = { + literalLeadingUnderscore?: boolean + literalTrailingUnderscore?: boolean +} + export type RouteNode = { filePath: string fullPath: string @@ -20,6 +25,8 @@ export type RouteNode = { * (e.g., when the parent is a virtual file-less route that gets filtered out). */ _virtualParentRoutePath?: string + /** Internal routePath segment metadata for escaped or explicit literal syntax. */ + _routePathSegmentMetadata?: Array<RoutePathSegmentMetadata | undefined> } export interface GetRouteNodesResult { @@ -67,7 +74,7 @@ export type HandleNodeAccumulator = { routeNodesByPath: Map<string, RouteNode> } -export type GetRoutesByFileMapResultValue = { routePath: string } +export type GetRoutesByFileMapResultValue = { routeId: string } export type GetRoutesByFileMapResult = Map< string, GetRoutesByFileMapResultValue diff --git a/packages/router-generator/src/utils.ts b/packages/router-generator/src/utils.ts index 251753a633..2354c5ed1c 100644 --- a/packages/router-generator/src/utils.ts +++ b/packages/router-generator/src/utils.ts @@ -4,7 +4,11 @@ import path from 'node:path' import * as prettier from 'prettier' import { rootPathId } from './filesystem/physical/rootPathId' import type { Config, TokenMatcher } from './config' -import type { ImportDeclaration, RouteNode } from './types' +import type { + ImportDeclaration, + RouteNode, + RoutePathSegmentMetadata, +} from './types' /** * Prefix map for O(1) parent route lookups. @@ -13,7 +17,6 @@ import type { ImportDeclaration, RouteNode } from './types' */ export class RoutePrefixMap { private prefixToRoute: Map<string, RouteNode> = new Map() - private layoutRoutes: Array<RouteNode> = [] constructor(routes: Array<RouteNode>) { for (const route of routes) { @@ -34,20 +37,7 @@ export class RoutePrefixMap { // Index by exact path for direct lookups this.prefixToRoute.set(route.routePath, route) - - if ( - route._fsRouteType === 'pathless_layout' || - route._fsRouteType === 'layout' || - route._fsRouteType === '__root' - ) { - this.layoutRoutes.push(route) - } } - - // Sort by path length descending for longest-match-first - this.layoutRoutes.sort( - (a, b) => (b.routePath?.length ?? 0) - (a.routePath?.length ?? 0), - ) } /** @@ -258,6 +248,169 @@ export function hasEscapedTrailingUnderscore(originalSegment: string): boolean { ) } +export function countRoutePathSegments(routePath?: string): number { + const path = routePath ?? '' + let count = 0 + let inSegment = false + + for (let i = 0; i < path.length; i++) { + if (path[i] === '/') { + inSegment = false + continue + } + + if (!inSegment) { + count++ + inSegment = true + } + } + + return count +} + +export function countSlashSeparatedParts(path: string): number { + let count = 1 + + for (let i = 0; i < path.length; i++) { + if (path[i] === '/') count++ + } + + return count +} + +export function hasRoutePathSegmentMetadata( + metadata: RoutePathSegmentMetadata | undefined, +): metadata is RoutePathSegmentMetadata { + return !!( + metadata?.literalLeadingUnderscore || metadata?.literalTrailingUnderscore + ) +} + +function mergeRoutePathSegmentMetadata( + current: RoutePathSegmentMetadata | undefined, + incoming: RoutePathSegmentMetadata | undefined, +): RoutePathSegmentMetadata | undefined { + const hasCurrent = hasRoutePathSegmentMetadata(current) + const hasIncoming = hasRoutePathSegmentMetadata(incoming) + + if (!hasCurrent) return hasIncoming ? incoming : undefined + if (!hasIncoming) return current + + return { + literalLeadingUnderscore: + current.literalLeadingUnderscore || incoming.literalLeadingUnderscore, + literalTrailingUnderscore: + current.literalTrailingUnderscore || incoming.literalTrailingUnderscore, + } +} + +export function createRoutePathSegmentMetadata( + routePath: string = '/', + originalPath?: string, +): Array<RoutePathSegmentMetadata | undefined> | undefined { + if (!originalPath) return undefined + + const routeSegments = routePath.split('/') + const originalSegments = originalPath.split('/') + const metadata = new Array<RoutePathSegmentMetadata | undefined>( + routeSegments.length, + ) + let hasMetadata = false + + for (let i = 0; i < routeSegments.length; i++) { + const segment = routeSegments[i]! + const originalSegment = originalSegments[i] || '' + const literalLeadingUnderscore = + segment.startsWith('_') && hasEscapedLeadingUnderscore(originalSegment) + const literalTrailingUnderscore = + segment.endsWith('_') && hasEscapedTrailingUnderscore(originalSegment) + + if (!literalLeadingUnderscore && !literalTrailingUnderscore) continue + + hasMetadata = true + metadata[i] = { + literalLeadingUnderscore: literalLeadingUnderscore || undefined, + literalTrailingUnderscore: literalTrailingUnderscore || undefined, + } + } + + return hasMetadata ? metadata : undefined +} + +export function createLiteralRoutePathSegmentMetadata( + routePath: string, + parent?: RouteNode, + literalNewSegments = false, +): Array<RoutePathSegmentMetadata | undefined> | undefined { + const routeSegments = routePath.split('/') + const metadata = new Array<RoutePathSegmentMetadata | undefined>( + routeSegments.length, + ) + const parentDepth = countRoutePathSegments(parent?.routePath) + let hasMetadata = false + let depth = 0 + + for (let i = 0; i < routeSegments.length; i++) { + const segment = routeSegments[i] + metadata[i] = parent?._routePathSegmentMetadata?.[i] + hasMetadata ||= hasRoutePathSegmentMetadata(metadata[i]) + + if (!segment) continue + + if (literalNewSegments && depth >= parentDepth) { + const literalLeadingUnderscore = segment.startsWith('_') + const literalTrailingUnderscore = segment.endsWith('_') + + if (literalLeadingUnderscore || literalTrailingUnderscore) { + metadata[i] = mergeRoutePathSegmentMetadata(metadata[i], { + literalLeadingUnderscore: literalLeadingUnderscore || undefined, + literalTrailingUnderscore: literalTrailingUnderscore || undefined, + }) + hasMetadata = true + } + } + + depth++ + } + + return hasMetadata ? metadata : undefined +} + +export function joinRoutePathSegmentMetadata( + routePath: string, + prefixPath: string, + prefixMetadata: Array<RoutePathSegmentMetadata | undefined> | undefined, + childMetadata: Array<RoutePathSegmentMetadata | undefined> | undefined, +): Array<RoutePathSegmentMetadata | undefined> | undefined { + const metadata = new Array<RoutePathSegmentMetadata | undefined>( + countSlashSeparatedParts(routePath), + ) + let hasMetadata = false + + if (prefixMetadata) { + for (let i = 0; i < prefixMetadata.length && i < metadata.length; i++) { + metadata[i] = prefixMetadata[i] + hasMetadata ||= hasRoutePathSegmentMetadata(metadata[i]) + } + } + + const offset = countRoutePathSegments(prefixPath) + if (childMetadata) { + for (let i = 1; i < childMetadata.length; i++) { + const targetIndex = offset + i + if (targetIndex >= metadata.length) break + + metadata[targetIndex] = mergeRoutePathSegmentMetadata( + metadata[targetIndex], + childMetadata[i], + ) + hasMetadata ||= hasRoutePathSegmentMetadata(metadata[targetIndex]) + } + } + + return hasMetadata ? metadata : undefined +} + const backslashRegex = /\\/g export function replaceBackslash(s: string) { @@ -328,6 +481,23 @@ export function removeUnderscores(s?: string) { .replace(underscoreSlashRegex, '/') } +function removeUnderscoresFromSegment( + segment: string, + metadata?: RoutePathSegmentMetadata, +): string { + let result = segment + + if (result.startsWith('_') && !metadata?.literalLeadingUnderscore) { + result = result.slice(1) + } + + if (result.endsWith('_') && !metadata?.literalTrailingUnderscore) { + result = result.slice(0, -1) + } + + return result +} + /** * Removes underscores from a path, but preserves underscores that were escaped * in the original path (indicated by [_] syntax). @@ -343,31 +513,51 @@ export function removeUnderscoresWithEscape( if (!routePath) return '' if (!originalPath) return removeUnderscores(routePath) ?? '' + const routeSegments = routePath.split('/') + const metadata = createRoutePathSegmentMetadata(routePath, originalPath) + const newSegments = new Array<string>(routeSegments.length) + + for (let i = 0; i < routeSegments.length; i++) { + newSegments[i] = removeUnderscoresFromSegment( + routeSegments[i]!, + metadata?.[i], + ) + } + + return newSegments.join('/') +} + +export function removeLayoutSegmentsAndUnderscoresWithEscape( + routePath: string = '/', + originalPath?: string, + routePathSegmentMetadata?: Array<RoutePathSegmentMetadata | undefined>, +): string { + if (!originalPath) { + return removeUnderscores(removeLayoutSegments(routePath)) ?? '' + } + + const metadata = + routePathSegmentMetadata ?? + createRoutePathSegmentMetadata(routePath, originalPath) + const routeSegments = routePath.split('/') const originalSegments = originalPath.split('/') + const newSegments: Array<string> = [] - const newSegments = routeSegments.map((segment, i) => { + for (let i = 0; i < routeSegments.length; i++) { + const segment = routeSegments[i]! const originalSegment = originalSegments[i] || '' + const segmentMetadata = metadata?.[i] - // Check if leading underscore is escaped - const leadingEscaped = hasEscapedLeadingUnderscore(originalSegment) - // Check if trailing underscore is escaped - const trailingEscaped = hasEscapedTrailingUnderscore(originalSegment) - - let result = segment - - // Remove leading underscore only if not escaped - if (result.startsWith('_') && !leadingEscaped) { - result = result.slice(1) + if ( + !segmentMetadata?.literalLeadingUnderscore && + isSegmentPathless(segment, originalSegment) + ) { + continue } - // Remove trailing underscore only if not escaped - if (result.endsWith('_') && !trailingEscaped) { - result = result.slice(0, -1) - } - - return result - }) + newSegments.push(removeUnderscoresFromSegment(segment, segmentMetadata)) + } return newSegments.join('/') } @@ -482,7 +672,7 @@ export function createTokenRegex( } } -export function isBracketWrappedSegment(segment: string): boolean { +function isBracketWrappedSegment(segment: string): boolean { return segment.startsWith('[') && segment.endsWith(']') } @@ -685,26 +875,10 @@ export const getResolvedRouteNodeVariableName = ( : `${routeNode.variableName}Route` } -/** - * Checks if a given RouteNode is valid for augmenting it with typing based on conditions. - * Also asserts that the RouteNode is defined. - * - * @param routeNode - The RouteNode to check. - * @returns A boolean indicating whether the RouteNode is defined. - */ -export function isRouteNodeValidForAugmentation( - routeNode?: RouteNode, -): routeNode is RouteNode { - if (!routeNode || routeNode.isVirtual) { - return false - } - return true -} - /** * Infers the path for use by TS */ -export const inferPath = (routeNode: RouteNode): string => { +const inferPath = (routeNode: RouteNode): string => { if (routeNode.cleanedPath === '/') { return routeNode.cleanedPath ?? '' } @@ -716,12 +890,10 @@ export const inferPath = (routeNode: RouteNode): string => { */ export const inferFullPath = (routeNode: RouteNode): string => { const fullPath = removeGroups( - removeUnderscoresWithEscape( - removeLayoutSegmentsWithEscape( - routeNode.routePath, - routeNode.originalRoutePath, - ), + removeLayoutSegmentsAndUnderscoresWithEscape( + routeNode.routePath, routeNode.originalRoutePath, + routeNode._routePathSegmentMetadata, ), ) @@ -746,6 +918,46 @@ const shouldPreferIndexRoute = ( return existing.cleanedPath === '/' && current.cleanedPath !== '/' } +const isIndexRouteNode = (routeNode: RouteNode): boolean => { + return routeNode.routePath?.endsWith('/') ?? false +} + +const isPathlessRouteNode = (routeNode: RouteNode): boolean => { + return routeNode._fsRouteType === 'pathless_layout' +} + +const shouldReplaceRouteNodeForTo = ( + current: RouteNode, + existing: RouteNode, +): boolean => { + const currentIsIndex = isIndexRouteNode(current) + const existingIsIndex = isIndexRouteNode(existing) + if (currentIsIndex !== existingIsIndex) { + return currentIsIndex + } + + const currentIsPathless = isPathlessRouteNode(current) + const existingIsPathless = isPathlessRouteNode(existing) + if (currentIsPathless !== existingIsPathless) { + return !currentIsPathless + } + + return true +} + +const shouldReplaceRouteNodeForFullPath = ( + current: RouteNode, + existing: RouteNode, +): boolean => { + const currentIsPathless = isPathlessRouteNode(current) + const existingIsPathless = isPathlessRouteNode(existing) + if (currentIsPathless !== existingIsPathless) { + return !currentIsPathless + } + + return true +} + /** * Creates a map from fullPath to routeNode */ @@ -764,6 +976,11 @@ export const createRouteNodesByFullPath = ( } } + const existing = map.get(fullPath) + if (existing && !shouldReplaceRouteNodeForFullPath(routeNode, existing)) { + continue + } + map.set(fullPath, routeNode) } @@ -781,11 +998,9 @@ export const createRouteNodesByTo = ( for (const routeNode of dedupeBranchesAndIndexRoutes(routeNodes)) { const to = inferTo(routeNode) - if (to === '/' && map.has('/')) { - const existing = map.get('/')! - if (shouldPreferIndexRoute(routeNode, existing)) { - continue - } + const existing = map.get(to) + if (existing && !shouldReplaceRouteNodeForTo(routeNode, existing)) { + continue } map.set(to, routeNode) @@ -811,7 +1026,7 @@ export const createRouteNodesById = ( /** * Infers to path */ -export const inferTo = (routeNode: RouteNode): string => { +const inferTo = (routeNode: RouteNode): string => { const fullPath = inferFullPath(routeNode) if (fullPath === '/') return fullPath @@ -822,7 +1037,7 @@ export const inferTo = (routeNode: RouteNode): string => { /** * Dedupes branches and index routes */ -export const dedupeBranchesAndIndexRoutes = ( +const dedupeBranchesAndIndexRoutes = ( routes: Array<RouteNode>, ): Array<RouteNode> => { return routes.filter((route) => { @@ -944,14 +1159,6 @@ export function buildImportString( : '' } -export function lowerCaseFirstChar(value: string) { - if (!value[0]) { - return value - } - - return value[0].toLowerCase() + value.slice(1) -} - export function mergeImportDeclarations( imports: Array<ImportDeclaration>, ): Array<ImportDeclaration> { @@ -1022,7 +1229,7 @@ export function buildFileRoutesByPathInterface(opts: { }` } -export function getImportPath( +function getImportPath( node: RouteNode, config: Config, generatedRouteTreePath: string, diff --git a/packages/router-generator/tests/generator.test.ts b/packages/router-generator/tests/generator.test.ts index c3199c378a..79f7d505b2 100644 --- a/packages/router-generator/tests/generator.test.ts +++ b/packages/router-generator/tests/generator.test.ts @@ -137,19 +137,6 @@ function rewriteConfigByFolderName(folderName: string, config: Config) { ].join(''), } break - case 'file-modification-verboseFileRoutes-true': - config.verboseFileRoutes = true - break - case 'file-modification-verboseFileRoutes-false': - config.verboseFileRoutes = false - break - // these two folders contain type tests which are executed separately - case 'nested-verboseFileRoutes-true': - config.verboseFileRoutes = true - break - case 'nested-verboseFileRoutes-false': - config.verboseFileRoutes = false - break case 'routeFileIgnore': config.routeFileIgnorePattern = 'ignoredPattern' config.routeFileIgnorePrefix = 'imIgnored' @@ -240,8 +227,49 @@ async function preprocess(folderName: string) { await fs.copyFile(templatePath, makeRoutePath('foo.tsx')) await fs.copyFile(lazyTemplatePath, makeRoutePath('initiallyLazy.tsx')) await fs.copyFile(templatePath, makeRoutePath('bar.lazy.tsx')) + await fs.copyFile(templatePath, makeRoutePath('double-quotes.tsx')) + await fs.copyFile(templatePath, makeRoutePath('template-literal.tsx')) + await fs.copyFile(templatePath, makeRoutePath('duplicate-import.tsx')) await makeEmptyFile('initiallyEmpty.tsx') await makeEmptyFile('initiallyEmpty.lazy.tsx') + + await fs.writeFile( + makeRoutePath('double-quotes.tsx'), + (await fs.readFile(makeRoutePath('double-quotes.tsx'), 'utf-8')).replace( + "createFileRoute('/foo/bar')", + 'createFileRoute("/foo/bar")', + ), + ) + + await fs.writeFile( + makeRoutePath('template-literal.tsx'), + ( + await fs.readFile(makeRoutePath('template-literal.tsx'), 'utf-8') + ).replace("createFileRoute('/foo/bar')", 'createFileRoute(`/foo/bar`)'), + ) + + await fs.writeFile( + makeRoutePath('duplicate-import.tsx'), + [ + "import { createFileRoute } from '@tanstack/react-router'", + "import * as React from 'react'", + "import { Link, Outlet } from '@tanstack/react-router'", + '', + "export const Route = createFileRoute('/foo/bar')({", + ' component: PostsLayoutComponent,', + '})', + '', + 'function PostsLayoutComponent() {', + ' return (', + ' <>', + ' <Link to="/">Home</Link>', + ' <Outlet />', + ' </>', + ' )', + '}', + '', + ].join('\n'), + ) } else if (folderName === 'custom-scaffolding') { const makeEmptyFile = async (...file: Array<string>) => { const filePath = join(makeFolderDir(folderName), 'routes', ...file) @@ -260,8 +288,7 @@ async function preprocess(folderName: string) { async function postprocess(folderName: string) { switch (folderName) { - case 'file-modification-verboseFileRoutes-false': - case 'file-modification-verboseFileRoutes-true': { + case 'file-modification': { const routeFiles = await readDir(folderName, 'routes', '(test)') await Promise.all( routeFiles diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/routeTree.snapshot.ts b/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/routeTree.snapshot.ts deleted file mode 100644 index 6cd0f9c68e..0000000000 --- a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/routeTree.snapshot.ts +++ /dev/null @@ -1,207 +0,0 @@ -/* eslint-disable */ - -// @ts-nocheck - -// noinspection JSUnusedGlobalSymbols - -// This file was automatically generated by TanStack Router. -// You should NOT make any changes in this file as it will be overwritten. -// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. - -import { createFileRoute } from '@tanstack/react-router' -import type { - CreateFileRoute, - CreateLazyFileRoute, - FileRoutesByPath, -} from '@tanstack/react-router' - -import { Route as rootRouteImport } from './routes/__root' -import { Route as testInitiallyLazyRouteImport } from './routes/(test)/initiallyLazy' -import { Route as testInitiallyEmptyRouteImport } from './routes/(test)/initiallyEmpty' -import { Route as testFooRouteImport } from './routes/(test)/foo' -import { Route as testFooBarRouteImport } from './routes/(test)/foo.bar' - -const testBarLazyRouteImport = createFileRoute('/(test)/bar')() - -const testBarLazyRoute = testBarLazyRouteImport - .update({ - id: '/(test)/bar', - path: '/bar', - getParentRoute: () => rootRouteImport, - } as any) - .lazy(() => import('./routes/(test)/bar.lazy').then((d) => d.Route)) -const testInitiallyLazyRoute = testInitiallyLazyRouteImport.update({ - id: '/(test)/initiallyLazy', - path: '/initiallyLazy', - getParentRoute: () => rootRouteImport, -} as any) -const testInitiallyEmptyRoute = testInitiallyEmptyRouteImport - .update({ - id: '/(test)/initiallyEmpty', - path: '/initiallyEmpty', - getParentRoute: () => rootRouteImport, - } as any) - .lazy(() => - import('./routes/(test)/initiallyEmpty.lazy').then((d) => d.Route), - ) -const testFooRoute = testFooRouteImport.update({ - id: '/(test)/foo', - path: '/foo', - getParentRoute: () => rootRouteImport, -} as any) -const testFooBarRoute = testFooBarRouteImport.update({ - id: '/bar', - path: '/bar', - getParentRoute: () => testFooRoute, -} as any) - -export interface FileRoutesByFullPath { - '/foo': typeof testFooRouteWithChildren - '/initiallyEmpty': typeof testInitiallyEmptyRoute - '/initiallyLazy': typeof testInitiallyLazyRoute - '/bar': typeof testBarLazyRoute - '/foo/bar': typeof testFooBarRoute -} -export interface FileRoutesByTo { - '/foo': typeof testFooRouteWithChildren - '/initiallyEmpty': typeof testInitiallyEmptyRoute - '/initiallyLazy': typeof testInitiallyLazyRoute - '/bar': typeof testBarLazyRoute - '/foo/bar': typeof testFooBarRoute -} -export interface FileRoutesById { - __root__: typeof rootRouteImport - '/(test)/foo': typeof testFooRouteWithChildren - '/(test)/initiallyEmpty': typeof testInitiallyEmptyRoute - '/(test)/initiallyLazy': typeof testInitiallyLazyRoute - '/(test)/bar': typeof testBarLazyRoute - '/(test)/foo/bar': typeof testFooBarRoute -} -export interface FileRouteTypes { - fileRoutesByFullPath: FileRoutesByFullPath - fullPaths: '/foo' | '/initiallyEmpty' | '/initiallyLazy' | '/bar' | '/foo/bar' - fileRoutesByTo: FileRoutesByTo - to: '/foo' | '/initiallyEmpty' | '/initiallyLazy' | '/bar' | '/foo/bar' - id: - | '__root__' - | '/(test)/foo' - | '/(test)/initiallyEmpty' - | '/(test)/initiallyLazy' - | '/(test)/bar' - | '/(test)/foo/bar' - fileRoutesById: FileRoutesById -} -export interface RootRouteChildren { - testFooRoute: typeof testFooRouteWithChildren - testInitiallyEmptyRoute: typeof testInitiallyEmptyRoute - testInitiallyLazyRoute: typeof testInitiallyLazyRoute - testBarLazyRoute: typeof testBarLazyRoute -} - -declare module '@tanstack/react-router' { - interface FileRoutesByPath { - '/(test)/bar': { - id: '/(test)/bar' - path: '/bar' - fullPath: '/bar' - preLoaderRoute: typeof testBarLazyRouteImport - parentRoute: typeof rootRouteImport - } - '/(test)/initiallyLazy': { - id: '/(test)/initiallyLazy' - path: '/initiallyLazy' - fullPath: '/initiallyLazy' - preLoaderRoute: typeof testInitiallyLazyRouteImport - parentRoute: typeof rootRouteImport - } - '/(test)/initiallyEmpty': { - id: '/(test)/initiallyEmpty' - path: '/initiallyEmpty' - fullPath: '/initiallyEmpty' - preLoaderRoute: typeof testInitiallyEmptyRouteImport - parentRoute: typeof rootRouteImport - } - '/(test)/foo': { - id: '/(test)/foo' - path: '/foo' - fullPath: '/foo' - preLoaderRoute: typeof testFooRouteImport - parentRoute: typeof rootRouteImport - } - '/(test)/foo/bar': { - id: '/(test)/foo/bar' - path: '/bar' - fullPath: '/foo/bar' - preLoaderRoute: typeof testFooBarRouteImport - parentRoute: typeof testFooRoute - } - } -} - -declare module './routes/(test)/foo' { - const createFileRoute: CreateFileRoute< - '/(test)/foo', - FileRoutesByPath['/(test)/foo']['parentRoute'], - FileRoutesByPath['/(test)/foo']['id'], - FileRoutesByPath['/(test)/foo']['path'], - FileRoutesByPath['/(test)/foo']['fullPath'] - > -} -declare module './routes/(test)/initiallyEmpty' { - const createFileRoute: CreateFileRoute< - '/(test)/initiallyEmpty', - FileRoutesByPath['/(test)/initiallyEmpty']['parentRoute'], - FileRoutesByPath['/(test)/initiallyEmpty']['id'], - FileRoutesByPath['/(test)/initiallyEmpty']['path'], - FileRoutesByPath['/(test)/initiallyEmpty']['fullPath'] - > -} -declare module './routes/(test)/initiallyLazy' { - const createFileRoute: CreateFileRoute< - '/(test)/initiallyLazy', - FileRoutesByPath['/(test)/initiallyLazy']['parentRoute'], - FileRoutesByPath['/(test)/initiallyLazy']['id'], - FileRoutesByPath['/(test)/initiallyLazy']['path'], - FileRoutesByPath['/(test)/initiallyLazy']['fullPath'] - > -} -declare module './routes/(test)/bar.lazy' { - const createLazyFileRoute: CreateLazyFileRoute< - FileRoutesByPath['/(test)/bar']['preLoaderRoute'] - > -} -declare module './routes/(test)/initiallyEmpty.lazy' { - const createLazyFileRoute: CreateLazyFileRoute< - FileRoutesByPath['/(test)/initiallyEmpty']['preLoaderRoute'] - > -} -declare module './routes/(test)/foo.bar' { - const createFileRoute: CreateFileRoute< - '/(test)/foo/bar', - FileRoutesByPath['/(test)/foo/bar']['parentRoute'], - FileRoutesByPath['/(test)/foo/bar']['id'], - FileRoutesByPath['/(test)/foo/bar']['path'], - FileRoutesByPath['/(test)/foo/bar']['fullPath'] - > -} - -interface testFooRouteChildren { - testFooBarRoute: typeof testFooBarRoute -} - -const testFooRouteChildren: testFooRouteChildren = { - testFooBarRoute: testFooBarRoute, -} - -const testFooRouteWithChildren = - testFooRoute._addFileChildren(testFooRouteChildren) - -const rootRouteChildren: RootRouteChildren = { - testFooRoute: testFooRouteWithChildren, - testInitiallyEmptyRoute: testInitiallyEmptyRoute, - testInitiallyLazyRoute: testInitiallyLazyRoute, - testBarLazyRoute: testBarLazyRoute, -} -export const routeTree = rootRouteImport - ._addFileChildren(rootRouteChildren) - ._addFileTypes<FileRouteTypes>() diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/routes/.gitignore b/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/routes/.gitignore deleted file mode 100644 index e0c201406d..0000000000 --- a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/routes/.gitignore +++ /dev/null @@ -1 +0,0 @@ -(test)/*.tsx \ No newline at end of file diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/snapshots/initiallyEmpty.lazy.tsx b/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/snapshots/initiallyEmpty.lazy.tsx deleted file mode 100644 index f8ab9154f9..0000000000 --- a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/snapshots/initiallyEmpty.lazy.tsx +++ /dev/null @@ -1,7 +0,0 @@ -export const Route = createLazyFileRoute({ - component: RouteComponent, -}) - -function RouteComponent() { - return <div>Hello "/(test)/initiallyEmpty"!</div> -} diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/snapshots/initiallyEmpty.tsx b/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/snapshots/initiallyEmpty.tsx deleted file mode 100644 index e8b24c1429..0000000000 --- a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/snapshots/initiallyEmpty.tsx +++ /dev/null @@ -1,7 +0,0 @@ -export const Route = createFileRoute({ - component: RouteComponent, -}) - -function RouteComponent() { - return <div>Hello "/(test)/initiallyEmpty"!</div> -} diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/snapshots/initiallyLazy.tsx b/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/snapshots/initiallyLazy.tsx deleted file mode 100644 index 0ce4dd43f7..0000000000 --- a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/snapshots/initiallyLazy.tsx +++ /dev/null @@ -1,26 +0,0 @@ -// @ts-nocheck - -import { Link } from '@tanstack/react-router' - -export const Route = createFileRoute({ - component: () => { - const post = Route.useLoaderData() - - return ( - <div className="space-y-2"> - <h4 className="text-xl font-bold underline">{post.title}</h4> - <div className="text-sm">{post.body}</div> - <Link - to="/posts/$postId/deep" - params={{ - postId: post.id, - }} - activeProps={{ className: 'text-black font-bold' }} - className="block py-1 text-blue-800 hover:text-blue-600" - > - Deep View - </Link> - </div> - ) - }, -}) diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/routes/(test)/-keep-directory b/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/routes/(test)/-keep-directory deleted file mode 100644 index e69de29bb2..0000000000 diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/routes/.gitignore b/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/routes/.gitignore deleted file mode 100644 index e0c201406d..0000000000 --- a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/routes/.gitignore +++ /dev/null @@ -1 +0,0 @@ -(test)/*.tsx \ No newline at end of file diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/snapshots/bar.lazy.tsx b/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/snapshots/bar.lazy.tsx deleted file mode 100644 index 11e597239d..0000000000 --- a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/snapshots/bar.lazy.tsx +++ /dev/null @@ -1,43 +0,0 @@ -// @ts-nocheck - -import * as React from 'react' -import { ErrorComponent, ErrorComponentProps, Link, createLazyFileRoute } from '@tanstack/react-router' - -export const Route = createLazyFileRoute('/(test)/bar')({ - loader: async ({ params: { postId } }) => ({ - postId, - title: 'title', - body: 'body', - id: 'id', - }), - errorComponent: PostErrorComponent as any, - notFoundComponent: () => { - return <p>Post not found</p> - }, - component: PostComponent, -}) - -export function PostErrorComponent({ error }: ErrorComponentProps) { - return <ErrorComponent error={error} /> -} - -function PostComponent() { - const post = Route.useLoaderData() - - return ( - <div className="space-y-2"> - <h4 className="text-xl font-bold underline">{post.title}</h4> - <div className="text-sm">{post.body}</div> - <Link - to="/posts/$postId/deep" - params={{ - postId: post.id, - }} - activeProps={{ className: 'text-black font-bold' }} - className="inline-block py-1 text-blue-800 hover:text-blue-600" - > - Deep View - </Link> - </div> - ) -} diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/snapshots/foo.tsx b/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/snapshots/foo.tsx deleted file mode 100644 index f6d4c9b072..0000000000 --- a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/snapshots/foo.tsx +++ /dev/null @@ -1,43 +0,0 @@ -// @ts-nocheck - -import * as React from 'react' -import { ErrorComponent, ErrorComponentProps, Link, createFileRoute } from '@tanstack/react-router' - -export const Route = createFileRoute('/(test)/foo')({ - loader: async ({ params: { postId } }) => ({ - postId, - title: 'title', - body: 'body', - id: 'id', - }), - errorComponent: PostErrorComponent as any, - notFoundComponent: () => { - return <p>Post not found</p> - }, - component: PostComponent, -}) - -export function PostErrorComponent({ error }: ErrorComponentProps) { - return <ErrorComponent error={error} /> -} - -function PostComponent() { - const post = Route.useLoaderData() - - return ( - <div className="space-y-2"> - <h4 className="text-xl font-bold underline">{post.title}</h4> - <div className="text-sm">{post.body}</div> - <Link - to="/posts/$postId/deep" - params={{ - postId: post.id, - }} - activeProps={{ className: 'text-black font-bold' }} - className="inline-block py-1 text-blue-800 hover:text-blue-600" - > - Deep View - </Link> - </div> - ) -} diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/template.lazy.tsx b/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/template.lazy.tsx deleted file mode 100644 index 45a3d5871f..0000000000 --- a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/template.lazy.tsx +++ /dev/null @@ -1,26 +0,0 @@ -// @ts-nocheck - -import { createLazyFileRoute, Link } from '@tanstack/react-router' - -export const Route = createLazyFileRoute({ - component: () => { - const post = Route.useLoaderData() - - return ( - <div className="space-y-2"> - <h4 className="text-xl font-bold underline">{post.title}</h4> - <div className="text-sm">{post.body}</div> - <Link - to="/posts/$postId/deep" - params={{ - postId: post.id, - }} - activeProps={{ className: 'text-black font-bold' }} - className="block py-1 text-blue-800 hover:text-blue-600" - > - Deep View - </Link> - </div> - ) - }, -}) diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/template.tsx b/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/template.tsx deleted file mode 100644 index cf174606e1..0000000000 --- a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/template.tsx +++ /dev/null @@ -1,47 +0,0 @@ -// @ts-nocheck - -import * as React from 'react' -import { - ErrorComponent, - ErrorComponentProps, - Link, -} from '@tanstack/react-router' - -export const Route = createFileRoute({ - loader: async ({ params: { postId } }) => ({ - postId, - title: 'title', - body: 'body', - id: 'id', - }), - errorComponent: PostErrorComponent as any, - notFoundComponent: () => { - return <p>Post not found</p> - }, - component: PostComponent, -}) - -export function PostErrorComponent({ error }: ErrorComponentProps) { - return <ErrorComponent error={error} /> -} - -function PostComponent() { - const post = Route.useLoaderData() - - return ( - <div className="space-y-2"> - <h4 className="text-xl font-bold underline">{post.title}</h4> - <div className="text-sm">{post.body}</div> - <Link - to="/posts/$postId/deep" - params={{ - postId: post.id, - }} - activeProps={{ className: 'text-black font-bold' }} - className="inline-block py-1 text-blue-800 hover:text-blue-600" - > - Deep View - </Link> - </div> - ) -} diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/routeTree.snapshot.ts b/packages/router-generator/tests/generator/file-modification/routeTree.snapshot.ts similarity index 63% rename from packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/routeTree.snapshot.ts rename to packages/router-generator/tests/generator/file-modification/routeTree.snapshot.ts index 816d3ddaa2..ddcc5ea6d6 100644 --- a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/routeTree.snapshot.ts +++ b/packages/router-generator/tests/generator/file-modification/routeTree.snapshot.ts @@ -11,9 +11,12 @@ import { createFileRoute } from '@tanstack/react-router' import { Route as rootRouteImport } from './routes/__root' +import { Route as testTemplateLiteralRouteImport } from './routes/(test)/template-literal' import { Route as testInitiallyLazyRouteImport } from './routes/(test)/initiallyLazy' import { Route as testInitiallyEmptyRouteImport } from './routes/(test)/initiallyEmpty' import { Route as testFooRouteImport } from './routes/(test)/foo' +import { Route as testDuplicateImportRouteImport } from './routes/(test)/duplicate-import' +import { Route as testDoubleQuotesRouteImport } from './routes/(test)/double-quotes' import { Route as testFooBarRouteImport } from './routes/(test)/foo.bar' const testBarLazyRouteImport = createFileRoute('/(test)/bar')() @@ -25,6 +28,11 @@ const testBarLazyRoute = testBarLazyRouteImport getParentRoute: () => rootRouteImport, } as any) .lazy(() => import('./routes/(test)/bar.lazy').then((d) => d.Route)) +const testTemplateLiteralRoute = testTemplateLiteralRouteImport.update({ + id: '/(test)/template-literal', + path: '/template-literal', + getParentRoute: () => rootRouteImport, +} as any) const testInitiallyLazyRoute = testInitiallyLazyRouteImport.update({ id: '/(test)/initiallyLazy', path: '/initiallyLazy', @@ -44,6 +52,16 @@ const testFooRoute = testFooRouteImport.update({ path: '/foo', getParentRoute: () => rootRouteImport, } as any) +const testDuplicateImportRoute = testDuplicateImportRouteImport.update({ + id: '/(test)/duplicate-import', + path: '/duplicate-import', + getParentRoute: () => rootRouteImport, +} as any) +const testDoubleQuotesRoute = testDoubleQuotesRouteImport.update({ + id: '/(test)/double-quotes', + path: '/double-quotes', + getParentRoute: () => rootRouteImport, +} as any) const testFooBarRoute = testFooBarRouteImport.update({ id: '/bar', path: '/bar', @@ -51,45 +69,76 @@ const testFooBarRoute = testFooBarRouteImport.update({ } as any) export interface FileRoutesByFullPath { + '/double-quotes': typeof testDoubleQuotesRoute + '/duplicate-import': typeof testDuplicateImportRoute '/foo': typeof testFooRouteWithChildren '/initiallyEmpty': typeof testInitiallyEmptyRoute '/initiallyLazy': typeof testInitiallyLazyRoute + '/template-literal': typeof testTemplateLiteralRoute '/bar': typeof testBarLazyRoute '/foo/bar': typeof testFooBarRoute } export interface FileRoutesByTo { + '/double-quotes': typeof testDoubleQuotesRoute + '/duplicate-import': typeof testDuplicateImportRoute '/foo': typeof testFooRouteWithChildren '/initiallyEmpty': typeof testInitiallyEmptyRoute '/initiallyLazy': typeof testInitiallyLazyRoute + '/template-literal': typeof testTemplateLiteralRoute '/bar': typeof testBarLazyRoute '/foo/bar': typeof testFooBarRoute } export interface FileRoutesById { __root__: typeof rootRouteImport + '/(test)/double-quotes': typeof testDoubleQuotesRoute + '/(test)/duplicate-import': typeof testDuplicateImportRoute '/(test)/foo': typeof testFooRouteWithChildren '/(test)/initiallyEmpty': typeof testInitiallyEmptyRoute '/(test)/initiallyLazy': typeof testInitiallyLazyRoute + '/(test)/template-literal': typeof testTemplateLiteralRoute '/(test)/bar': typeof testBarLazyRoute '/(test)/foo/bar': typeof testFooBarRoute } export interface FileRouteTypes { fileRoutesByFullPath: FileRoutesByFullPath - fullPaths: '/foo' | '/initiallyEmpty' | '/initiallyLazy' | '/bar' | '/foo/bar' + fullPaths: + | '/double-quotes' + | '/duplicate-import' + | '/foo' + | '/initiallyEmpty' + | '/initiallyLazy' + | '/template-literal' + | '/bar' + | '/foo/bar' fileRoutesByTo: FileRoutesByTo - to: '/foo' | '/initiallyEmpty' | '/initiallyLazy' | '/bar' | '/foo/bar' + to: + | '/double-quotes' + | '/duplicate-import' + | '/foo' + | '/initiallyEmpty' + | '/initiallyLazy' + | '/template-literal' + | '/bar' + | '/foo/bar' id: | '__root__' + | '/(test)/double-quotes' + | '/(test)/duplicate-import' | '/(test)/foo' | '/(test)/initiallyEmpty' | '/(test)/initiallyLazy' + | '/(test)/template-literal' | '/(test)/bar' | '/(test)/foo/bar' fileRoutesById: FileRoutesById } export interface RootRouteChildren { + testDoubleQuotesRoute: typeof testDoubleQuotesRoute + testDuplicateImportRoute: typeof testDuplicateImportRoute testFooRoute: typeof testFooRouteWithChildren testInitiallyEmptyRoute: typeof testInitiallyEmptyRoute testInitiallyLazyRoute: typeof testInitiallyLazyRoute + testTemplateLiteralRoute: typeof testTemplateLiteralRoute testBarLazyRoute: typeof testBarLazyRoute } @@ -102,6 +151,13 @@ declare module '@tanstack/react-router' { preLoaderRoute: typeof testBarLazyRouteImport parentRoute: typeof rootRouteImport } + '/(test)/template-literal': { + id: '/(test)/template-literal' + path: '/template-literal' + fullPath: '/template-literal' + preLoaderRoute: typeof testTemplateLiteralRouteImport + parentRoute: typeof rootRouteImport + } '/(test)/initiallyLazy': { id: '/(test)/initiallyLazy' path: '/initiallyLazy' @@ -123,6 +179,20 @@ declare module '@tanstack/react-router' { preLoaderRoute: typeof testFooRouteImport parentRoute: typeof rootRouteImport } + '/(test)/duplicate-import': { + id: '/(test)/duplicate-import' + path: '/duplicate-import' + fullPath: '/duplicate-import' + preLoaderRoute: typeof testDuplicateImportRouteImport + parentRoute: typeof rootRouteImport + } + '/(test)/double-quotes': { + id: '/(test)/double-quotes' + path: '/double-quotes' + fullPath: '/double-quotes' + preLoaderRoute: typeof testDoubleQuotesRouteImport + parentRoute: typeof rootRouteImport + } '/(test)/foo/bar': { id: '/(test)/foo/bar' path: '/bar' @@ -145,9 +215,12 @@ const testFooRouteWithChildren = testFooRoute._addFileChildren(testFooRouteChildren) const rootRouteChildren: RootRouteChildren = { + testDoubleQuotesRoute: testDoubleQuotesRoute, + testDuplicateImportRoute: testDuplicateImportRoute, testFooRoute: testFooRouteWithChildren, testInitiallyEmptyRoute: testInitiallyEmptyRoute, testInitiallyLazyRoute: testInitiallyLazyRoute, + testTemplateLiteralRoute: testTemplateLiteralRoute, testBarLazyRoute: testBarLazyRoute, } export const routeTree = rootRouteImport diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/routes/(test)/-keep-directory b/packages/router-generator/tests/generator/file-modification/routes/(test)/-keep-directory similarity index 100% rename from packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/routes/(test)/-keep-directory rename to packages/router-generator/tests/generator/file-modification/routes/(test)/-keep-directory diff --git a/packages/router-generator/tests/generator/file-modification/routes/.gitignore b/packages/router-generator/tests/generator/file-modification/routes/.gitignore new file mode 100644 index 0000000000..a7828561f2 --- /dev/null +++ b/packages/router-generator/tests/generator/file-modification/routes/.gitignore @@ -0,0 +1 @@ +(test)/*.tsx diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/routes/__root.tsx b/packages/router-generator/tests/generator/file-modification/routes/__root.tsx similarity index 100% rename from packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/routes/__root.tsx rename to packages/router-generator/tests/generator/file-modification/routes/__root.tsx diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/snapshots/bar.lazy.tsx b/packages/router-generator/tests/generator/file-modification/snapshots/bar.lazy.tsx similarity index 92% rename from packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/snapshots/bar.lazy.tsx rename to packages/router-generator/tests/generator/file-modification/snapshots/bar.lazy.tsx index da8052b46c..24db5929dd 100644 --- a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/snapshots/bar.lazy.tsx +++ b/packages/router-generator/tests/generator/file-modification/snapshots/bar.lazy.tsx @@ -5,9 +5,10 @@ import { ErrorComponent, ErrorComponentProps, Link, + createLazyFileRoute, } from '@tanstack/react-router' -export const Route = createLazyFileRoute({ +export const Route = createLazyFileRoute('/(test)/bar')({ loader: async ({ params: { postId } }) => ({ postId, title: 'title', diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/snapshots/foo.bar.tsx b/packages/router-generator/tests/generator/file-modification/snapshots/double-quotes.tsx similarity index 92% rename from packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/snapshots/foo.bar.tsx rename to packages/router-generator/tests/generator/file-modification/snapshots/double-quotes.tsx index cf174606e1..d03bf88405 100644 --- a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/snapshots/foo.bar.tsx +++ b/packages/router-generator/tests/generator/file-modification/snapshots/double-quotes.tsx @@ -5,9 +5,10 @@ import { ErrorComponent, ErrorComponentProps, Link, + createFileRoute, } from '@tanstack/react-router' -export const Route = createFileRoute({ +export const Route = createFileRoute("/(test)/double-quotes")({ loader: async ({ params: { postId } }) => ({ postId, title: 'title', diff --git a/packages/router-generator/tests/generator/file-modification/snapshots/duplicate-import.tsx b/packages/router-generator/tests/generator/file-modification/snapshots/duplicate-import.tsx new file mode 100644 index 0000000000..6a668f371f --- /dev/null +++ b/packages/router-generator/tests/generator/file-modification/snapshots/duplicate-import.tsx @@ -0,0 +1,16 @@ +import { createFileRoute } from '@tanstack/react-router' +import * as React from 'react' +import { Link, Outlet } from '@tanstack/react-router' + +export const Route = createFileRoute('/(test)/duplicate-import')({ + component: PostsLayoutComponent, +}) + +function PostsLayoutComponent() { + return ( + <> + <Link to="/">Home</Link> + <Outlet /> + </> + ) +} diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/snapshots/foo.bar.tsx b/packages/router-generator/tests/generator/file-modification/snapshots/foo.bar.tsx similarity index 100% rename from packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/snapshots/foo.bar.tsx rename to packages/router-generator/tests/generator/file-modification/snapshots/foo.bar.tsx diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/snapshots/foo.tsx b/packages/router-generator/tests/generator/file-modification/snapshots/foo.tsx similarity index 93% rename from packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/snapshots/foo.tsx rename to packages/router-generator/tests/generator/file-modification/snapshots/foo.tsx index cf174606e1..400df7e122 100644 --- a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/snapshots/foo.tsx +++ b/packages/router-generator/tests/generator/file-modification/snapshots/foo.tsx @@ -5,9 +5,10 @@ import { ErrorComponent, ErrorComponentProps, Link, + createFileRoute, } from '@tanstack/react-router' -export const Route = createFileRoute({ +export const Route = createFileRoute('/(test)/foo')({ loader: async ({ params: { postId } }) => ({ postId, title: 'title', diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/snapshots/initiallyEmpty.lazy.tsx b/packages/router-generator/tests/generator/file-modification/snapshots/initiallyEmpty.lazy.tsx similarity index 100% rename from packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/snapshots/initiallyEmpty.lazy.tsx rename to packages/router-generator/tests/generator/file-modification/snapshots/initiallyEmpty.lazy.tsx diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/snapshots/initiallyEmpty.tsx b/packages/router-generator/tests/generator/file-modification/snapshots/initiallyEmpty.tsx similarity index 100% rename from packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/snapshots/initiallyEmpty.tsx rename to packages/router-generator/tests/generator/file-modification/snapshots/initiallyEmpty.tsx diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/snapshots/initiallyLazy.tsx b/packages/router-generator/tests/generator/file-modification/snapshots/initiallyLazy.tsx similarity index 90% rename from packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/snapshots/initiallyLazy.tsx rename to packages/router-generator/tests/generator/file-modification/snapshots/initiallyLazy.tsx index 258a8f7619..b9d388acd0 100644 --- a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/snapshots/initiallyLazy.tsx +++ b/packages/router-generator/tests/generator/file-modification/snapshots/initiallyLazy.tsx @@ -1,6 +1,6 @@ // @ts-nocheck -import { Link, createFileRoute } from '@tanstack/react-router' +import { createFileRoute, Link } from '@tanstack/react-router' export const Route = createFileRoute('/(test)/initiallyLazy')({ component: () => { diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/template.tsx b/packages/router-generator/tests/generator/file-modification/snapshots/template-literal.tsx similarity index 92% rename from packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/template.tsx rename to packages/router-generator/tests/generator/file-modification/snapshots/template-literal.tsx index cf174606e1..1e31639331 100644 --- a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/template.tsx +++ b/packages/router-generator/tests/generator/file-modification/snapshots/template-literal.tsx @@ -5,9 +5,10 @@ import { ErrorComponent, ErrorComponentProps, Link, + createFileRoute, } from '@tanstack/react-router' -export const Route = createFileRoute({ +export const Route = createFileRoute(`/(test)/template-literal`)({ loader: async ({ params: { postId } }) => ({ postId, title: 'title', diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/template-verbose.tsx b/packages/router-generator/tests/generator/file-modification/template-verbose.tsx similarity index 100% rename from packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/template-verbose.tsx rename to packages/router-generator/tests/generator/file-modification/template-verbose.tsx diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/template.lazy.tsx b/packages/router-generator/tests/generator/file-modification/template.lazy.tsx similarity index 91% rename from packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/template.lazy.tsx rename to packages/router-generator/tests/generator/file-modification/template.lazy.tsx index 45a3d5871f..99604a5ccb 100644 --- a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-false/template.lazy.tsx +++ b/packages/router-generator/tests/generator/file-modification/template.lazy.tsx @@ -2,7 +2,7 @@ import { createLazyFileRoute, Link } from '@tanstack/react-router' -export const Route = createLazyFileRoute({ +export const Route = createLazyFileRoute('/foo/bar')({ component: () => { const post = Route.useLoaderData() diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/template-verbose.tsx b/packages/router-generator/tests/generator/file-modification/template.tsx similarity index 98% rename from packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/template-verbose.tsx rename to packages/router-generator/tests/generator/file-modification/template.tsx index 9756170d6e..1598aa3c9f 100644 --- a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/template-verbose.tsx +++ b/packages/router-generator/tests/generator/file-modification/template.tsx @@ -5,6 +5,7 @@ import { ErrorComponent, ErrorComponentProps, Link, + createFileRoute, } from '@tanstack/react-router' export const Route = createFileRoute('/foo/bar')({ diff --git a/packages/router-generator/tests/generator/nested-layouts/routeTree.snapshot.ts b/packages/router-generator/tests/generator/nested-layouts/routeTree.snapshot.ts index c38345a64b..d99745d928 100644 --- a/packages/router-generator/tests/generator/nested-layouts/routeTree.snapshot.ts +++ b/packages/router-generator/tests/generator/nested-layouts/routeTree.snapshot.ts @@ -147,7 +147,7 @@ const JestedLayoutB3LayoutC2BarRoute = export interface FileRoutesByFullPath { '/': typeof IndexRoute - '/jested': typeof JestedLayoutB3LayoutC2RouteWithChildren + '/jested': typeof JestedRouteRouteWithChildren '/foo': typeof LayoutA1FooRoute '/in-folder': typeof folderInFolderRoute '/bar': typeof LayoutA2BarRoute diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routeTree.snapshot.ts b/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routeTree.snapshot.ts deleted file mode 100644 index ce5d831534..0000000000 --- a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routeTree.snapshot.ts +++ /dev/null @@ -1,526 +0,0 @@ -/* eslint-disable */ - -// @ts-nocheck - -// noinspection JSUnusedGlobalSymbols - -// This file was automatically generated by TanStack Router. -// You should NOT make any changes in this file as it will be overwritten. -// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. - -import type { CreateFileRoute, FileRoutesByPath } from '@tanstack/react-router' - -import { Route as rootRouteImport } from './routes/__root' -import { Route as PathlessLayoutRouteImport } from './routes/_pathlessLayout' -import { Route as PostsRouteRouteImport } from './routes/posts/route' -import { Route as BlogRouteRouteImport } from './routes/blog/route' -import { Route as IndexRouteImport } from './routes/index' -import { Route as PostsIndexRouteImport } from './routes/posts/index' -import { Route as BlogIndexRouteImport } from './routes/blog/index' -import { Route as BlogStatsRouteImport } from './routes/blog_/stats' -import { Route as BlogSlugRouteImport } from './routes/blog/$slug' -import { Route as PathlessLayoutSettingsRouteImport } from './routes/_pathlessLayout/settings' -import { Route as BlogBlogIdRouteRouteImport } from './routes/blog_/$blogId/route' -import { Route as PostsPostIdIndexRouteImport } from './routes/posts/$postId/index' -import { Route as PostsPostIdDeepRouteImport } from './routes/posts/$postId/deep' -import { Route as BlogBlogIdEditRouteImport } from './routes/blog_/$blogId_/edit' -import { Route as BlogBlogIdSlugRouteRouteImport } from './routes/blog_/$blogId/$slug/route' -import { Route as BlogBlogIdSlugBarRouteImport } from './routes/blog_/$blogId/$slug_/bar' - -const PathlessLayoutRoute = PathlessLayoutRouteImport.update({ - id: '/_pathlessLayout', - getParentRoute: () => rootRouteImport, -} as any) -const PostsRouteRoute = PostsRouteRouteImport.update({ - id: '/posts', - path: '/posts', - getParentRoute: () => rootRouteImport, -} as any) -const BlogRouteRoute = BlogRouteRouteImport.update({ - id: '/blog', - path: '/blog', - getParentRoute: () => rootRouteImport, -} as any) -const IndexRoute = IndexRouteImport.update({ - id: '/', - path: '/', - getParentRoute: () => rootRouteImport, -} as any) -const PostsIndexRoute = PostsIndexRouteImport.update({ - id: '/', - path: '/', - getParentRoute: () => PostsRouteRoute, -} as any) -const BlogIndexRoute = BlogIndexRouteImport.update({ - id: '/', - path: '/', - getParentRoute: () => BlogRouteRoute, -} as any) -const BlogStatsRoute = BlogStatsRouteImport.update({ - id: '/blog_/stats', - path: '/blog/stats', - getParentRoute: () => rootRouteImport, -} as any) -const BlogSlugRoute = BlogSlugRouteImport.update({ - id: '/$slug', - path: '/$slug', - getParentRoute: () => BlogRouteRoute, -} as any) -const PathlessLayoutSettingsRoute = PathlessLayoutSettingsRouteImport.update({ - id: '/settings', - path: '/settings', - getParentRoute: () => PathlessLayoutRoute, -} as any) -const BlogBlogIdRouteRoute = BlogBlogIdRouteRouteImport.update({ - id: '/blog_/$blogId', - path: '/blog/$blogId', - getParentRoute: () => rootRouteImport, -} as any) -const PostsPostIdIndexRoute = PostsPostIdIndexRouteImport.update({ - id: '/$postId/', - path: '/$postId/', - getParentRoute: () => PostsRouteRoute, -} as any) -const PostsPostIdDeepRoute = PostsPostIdDeepRouteImport.update({ - id: '/$postId/deep', - path: '/$postId/deep', - getParentRoute: () => PostsRouteRoute, -} as any) -const BlogBlogIdEditRoute = BlogBlogIdEditRouteImport.update({ - id: '/blog_/$blogId_/edit', - path: '/blog/$blogId/edit', - getParentRoute: () => rootRouteImport, -} as any) -const BlogBlogIdSlugRouteRoute = BlogBlogIdSlugRouteRouteImport.update({ - id: '/$slug', - path: '/$slug', - getParentRoute: () => BlogBlogIdRouteRoute, -} as any) -const BlogBlogIdSlugBarRoute = BlogBlogIdSlugBarRouteImport.update({ - id: '/$slug_/bar', - path: '/$slug/bar', - getParentRoute: () => BlogBlogIdRouteRoute, -} as any) - -export interface FileRoutesByFullPath { - '/': typeof IndexRoute - '/blog': typeof BlogRouteRouteWithChildren - '/posts': typeof PostsRouteRouteWithChildren - '/blog/$blogId': typeof BlogBlogIdRouteRouteWithChildren - '/settings': typeof PathlessLayoutSettingsRoute - '/blog/$slug': typeof BlogSlugRoute - '/blog/stats': typeof BlogStatsRoute - '/blog/': typeof BlogIndexRoute - '/posts/': typeof PostsIndexRoute - '/blog/$blogId/$slug': typeof BlogBlogIdSlugRouteRoute - '/blog/$blogId/edit': typeof BlogBlogIdEditRoute - '/posts/$postId/deep': typeof PostsPostIdDeepRoute - '/posts/$postId/': typeof PostsPostIdIndexRoute - '/blog/$blogId/$slug/bar': typeof BlogBlogIdSlugBarRoute -} -export interface FileRoutesByTo { - '/': typeof IndexRoute - '/blog/$blogId': typeof BlogBlogIdRouteRouteWithChildren - '/settings': typeof PathlessLayoutSettingsRoute - '/blog/$slug': typeof BlogSlugRoute - '/blog/stats': typeof BlogStatsRoute - '/blog': typeof BlogIndexRoute - '/posts': typeof PostsIndexRoute - '/blog/$blogId/$slug': typeof BlogBlogIdSlugRouteRoute - '/blog/$blogId/edit': typeof BlogBlogIdEditRoute - '/posts/$postId/deep': typeof PostsPostIdDeepRoute - '/posts/$postId': typeof PostsPostIdIndexRoute - '/blog/$blogId/$slug/bar': typeof BlogBlogIdSlugBarRoute -} -export interface FileRoutesById { - __root__: typeof rootRouteImport - '/': typeof IndexRoute - '/blog': typeof BlogRouteRouteWithChildren - '/posts': typeof PostsRouteRouteWithChildren - '/_pathlessLayout': typeof PathlessLayoutRouteWithChildren - '/blog_/$blogId': typeof BlogBlogIdRouteRouteWithChildren - '/_pathlessLayout/settings': typeof PathlessLayoutSettingsRoute - '/blog/$slug': typeof BlogSlugRoute - '/blog_/stats': typeof BlogStatsRoute - '/blog/': typeof BlogIndexRoute - '/posts/': typeof PostsIndexRoute - '/blog_/$blogId/$slug': typeof BlogBlogIdSlugRouteRoute - '/blog_/$blogId_/edit': typeof BlogBlogIdEditRoute - '/posts/$postId/deep': typeof PostsPostIdDeepRoute - '/posts/$postId/': typeof PostsPostIdIndexRoute - '/blog_/$blogId/$slug_/bar': typeof BlogBlogIdSlugBarRoute -} -export interface FileRouteTypes { - fileRoutesByFullPath: FileRoutesByFullPath - fullPaths: - | '/' - | '/blog' - | '/posts' - | '/blog/$blogId' - | '/settings' - | '/blog/$slug' - | '/blog/stats' - | '/blog/' - | '/posts/' - | '/blog/$blogId/$slug' - | '/blog/$blogId/edit' - | '/posts/$postId/deep' - | '/posts/$postId/' - | '/blog/$blogId/$slug/bar' - fileRoutesByTo: FileRoutesByTo - to: - | '/' - | '/blog/$blogId' - | '/settings' - | '/blog/$slug' - | '/blog/stats' - | '/blog' - | '/posts' - | '/blog/$blogId/$slug' - | '/blog/$blogId/edit' - | '/posts/$postId/deep' - | '/posts/$postId' - | '/blog/$blogId/$slug/bar' - id: - | '__root__' - | '/' - | '/blog' - | '/posts' - | '/_pathlessLayout' - | '/blog_/$blogId' - | '/_pathlessLayout/settings' - | '/blog/$slug' - | '/blog_/stats' - | '/blog/' - | '/posts/' - | '/blog_/$blogId/$slug' - | '/blog_/$blogId_/edit' - | '/posts/$postId/deep' - | '/posts/$postId/' - | '/blog_/$blogId/$slug_/bar' - fileRoutesById: FileRoutesById -} -export interface RootRouteChildren { - IndexRoute: typeof IndexRoute - BlogRouteRoute: typeof BlogRouteRouteWithChildren - PostsRouteRoute: typeof PostsRouteRouteWithChildren - PathlessLayoutRoute: typeof PathlessLayoutRouteWithChildren - BlogBlogIdRouteRoute: typeof BlogBlogIdRouteRouteWithChildren - BlogStatsRoute: typeof BlogStatsRoute - BlogBlogIdEditRoute: typeof BlogBlogIdEditRoute -} - -declare module '@tanstack/react-router' { - interface FileRoutesByPath { - '/_pathlessLayout': { - id: '/_pathlessLayout' - path: '' - fullPath: '/' - preLoaderRoute: typeof PathlessLayoutRouteImport - parentRoute: typeof rootRouteImport - } - '/posts': { - id: '/posts' - path: '/posts' - fullPath: '/posts' - preLoaderRoute: typeof PostsRouteRouteImport - parentRoute: typeof rootRouteImport - } - '/blog': { - id: '/blog' - path: '/blog' - fullPath: '/blog' - preLoaderRoute: typeof BlogRouteRouteImport - parentRoute: typeof rootRouteImport - } - '/': { - id: '/' - path: '/' - fullPath: '/' - preLoaderRoute: typeof IndexRouteImport - parentRoute: typeof rootRouteImport - } - '/posts/': { - id: '/posts/' - path: '/' - fullPath: '/posts/' - preLoaderRoute: typeof PostsIndexRouteImport - parentRoute: typeof PostsRouteRoute - } - '/blog/': { - id: '/blog/' - path: '/' - fullPath: '/blog/' - preLoaderRoute: typeof BlogIndexRouteImport - parentRoute: typeof BlogRouteRoute - } - '/blog_/stats': { - id: '/blog_/stats' - path: '/blog/stats' - fullPath: '/blog/stats' - preLoaderRoute: typeof BlogStatsRouteImport - parentRoute: typeof rootRouteImport - } - '/blog/$slug': { - id: '/blog/$slug' - path: '/$slug' - fullPath: '/blog/$slug' - preLoaderRoute: typeof BlogSlugRouteImport - parentRoute: typeof BlogRouteRoute - } - '/_pathlessLayout/settings': { - id: '/_pathlessLayout/settings' - path: '/settings' - fullPath: '/settings' - preLoaderRoute: typeof PathlessLayoutSettingsRouteImport - parentRoute: typeof PathlessLayoutRoute - } - '/blog_/$blogId': { - id: '/blog_/$blogId' - path: '/blog/$blogId' - fullPath: '/blog/$blogId' - preLoaderRoute: typeof BlogBlogIdRouteRouteImport - parentRoute: typeof rootRouteImport - } - '/posts/$postId/': { - id: '/posts/$postId/' - path: '/$postId' - fullPath: '/posts/$postId/' - preLoaderRoute: typeof PostsPostIdIndexRouteImport - parentRoute: typeof PostsRouteRoute - } - '/posts/$postId/deep': { - id: '/posts/$postId/deep' - path: '/$postId/deep' - fullPath: '/posts/$postId/deep' - preLoaderRoute: typeof PostsPostIdDeepRouteImport - parentRoute: typeof PostsRouteRoute - } - '/blog_/$blogId_/edit': { - id: '/blog_/$blogId_/edit' - path: '/blog/$blogId/edit' - fullPath: '/blog/$blogId/edit' - preLoaderRoute: typeof BlogBlogIdEditRouteImport - parentRoute: typeof rootRouteImport - } - '/blog_/$blogId/$slug': { - id: '/blog_/$blogId/$slug' - path: '/$slug' - fullPath: '/blog/$blogId/$slug' - preLoaderRoute: typeof BlogBlogIdSlugRouteRouteImport - parentRoute: typeof BlogBlogIdRouteRoute - } - '/blog_/$blogId/$slug_/bar': { - id: '/blog_/$blogId/$slug_/bar' - path: '/$slug/bar' - fullPath: '/blog/$blogId/$slug/bar' - preLoaderRoute: typeof BlogBlogIdSlugBarRouteImport - parentRoute: typeof BlogBlogIdRouteRoute - } - } -} - -declare module './routes/index' { - const createFileRoute: CreateFileRoute< - '/', - FileRoutesByPath['/']['parentRoute'], - FileRoutesByPath['/']['id'], - FileRoutesByPath['/']['path'], - FileRoutesByPath['/']['fullPath'] - > -} -declare module './routes/blog/route' { - const createFileRoute: CreateFileRoute< - '/blog', - FileRoutesByPath['/blog']['parentRoute'], - FileRoutesByPath['/blog']['id'], - FileRoutesByPath['/blog']['path'], - FileRoutesByPath['/blog']['fullPath'] - > -} -declare module './routes/posts/route' { - const createFileRoute: CreateFileRoute< - '/posts', - FileRoutesByPath['/posts']['parentRoute'], - FileRoutesByPath['/posts']['id'], - FileRoutesByPath['/posts']['path'], - FileRoutesByPath['/posts']['fullPath'] - > -} -declare module './routes/_pathlessLayout' { - const createFileRoute: CreateFileRoute< - '/_pathlessLayout', - FileRoutesByPath['/_pathlessLayout']['parentRoute'], - FileRoutesByPath['/_pathlessLayout']['id'], - FileRoutesByPath['/_pathlessLayout']['path'], - FileRoutesByPath['/_pathlessLayout']['fullPath'] - > -} -declare module './routes/blog_/$blogId/route' { - const createFileRoute: CreateFileRoute< - '/blog_/$blogId', - FileRoutesByPath['/blog_/$blogId']['parentRoute'], - FileRoutesByPath['/blog_/$blogId']['id'], - FileRoutesByPath['/blog_/$blogId']['path'], - FileRoutesByPath['/blog_/$blogId']['fullPath'] - > -} -declare module './routes/_pathlessLayout/settings' { - const createFileRoute: CreateFileRoute< - '/_pathlessLayout/settings', - FileRoutesByPath['/_pathlessLayout/settings']['parentRoute'], - FileRoutesByPath['/_pathlessLayout/settings']['id'], - FileRoutesByPath['/_pathlessLayout/settings']['path'], - FileRoutesByPath['/_pathlessLayout/settings']['fullPath'] - > -} -declare module './routes/blog/$slug' { - const createFileRoute: CreateFileRoute< - '/blog/$slug', - FileRoutesByPath['/blog/$slug']['parentRoute'], - FileRoutesByPath['/blog/$slug']['id'], - FileRoutesByPath['/blog/$slug']['path'], - FileRoutesByPath['/blog/$slug']['fullPath'] - > -} -declare module './routes/blog_/stats' { - const createFileRoute: CreateFileRoute< - '/blog_/stats', - FileRoutesByPath['/blog_/stats']['parentRoute'], - FileRoutesByPath['/blog_/stats']['id'], - FileRoutesByPath['/blog_/stats']['path'], - FileRoutesByPath['/blog_/stats']['fullPath'] - > -} -declare module './routes/blog/index' { - const createFileRoute: CreateFileRoute< - '/blog/', - FileRoutesByPath['/blog/']['parentRoute'], - FileRoutesByPath['/blog/']['id'], - FileRoutesByPath['/blog/']['path'], - FileRoutesByPath['/blog/']['fullPath'] - > -} -declare module './routes/posts/index' { - const createFileRoute: CreateFileRoute< - '/posts/', - FileRoutesByPath['/posts/']['parentRoute'], - FileRoutesByPath['/posts/']['id'], - FileRoutesByPath['/posts/']['path'], - FileRoutesByPath['/posts/']['fullPath'] - > -} -declare module './routes/blog_/$blogId/$slug/route' { - const createFileRoute: CreateFileRoute< - '/blog_/$blogId/$slug', - FileRoutesByPath['/blog_/$blogId/$slug']['parentRoute'], - FileRoutesByPath['/blog_/$blogId/$slug']['id'], - FileRoutesByPath['/blog_/$blogId/$slug']['path'], - FileRoutesByPath['/blog_/$blogId/$slug']['fullPath'] - > -} -declare module './routes/blog_/$blogId_/edit' { - const createFileRoute: CreateFileRoute< - '/blog_/$blogId_/edit', - FileRoutesByPath['/blog_/$blogId_/edit']['parentRoute'], - FileRoutesByPath['/blog_/$blogId_/edit']['id'], - FileRoutesByPath['/blog_/$blogId_/edit']['path'], - FileRoutesByPath['/blog_/$blogId_/edit']['fullPath'] - > -} -declare module './routes/posts/$postId/deep' { - const createFileRoute: CreateFileRoute< - '/posts/$postId/deep', - FileRoutesByPath['/posts/$postId/deep']['parentRoute'], - FileRoutesByPath['/posts/$postId/deep']['id'], - FileRoutesByPath['/posts/$postId/deep']['path'], - FileRoutesByPath['/posts/$postId/deep']['fullPath'] - > -} -declare module './routes/posts/$postId/index' { - const createFileRoute: CreateFileRoute< - '/posts/$postId/', - FileRoutesByPath['/posts/$postId/']['parentRoute'], - FileRoutesByPath['/posts/$postId/']['id'], - FileRoutesByPath['/posts/$postId/']['path'], - FileRoutesByPath['/posts/$postId/']['fullPath'] - > -} -declare module './routes/blog_/$blogId/$slug_/bar' { - const createFileRoute: CreateFileRoute< - '/blog_/$blogId/$slug_/bar', - FileRoutesByPath['/blog_/$blogId/$slug_/bar']['parentRoute'], - FileRoutesByPath['/blog_/$blogId/$slug_/bar']['id'], - FileRoutesByPath['/blog_/$blogId/$slug_/bar']['path'], - FileRoutesByPath['/blog_/$blogId/$slug_/bar']['fullPath'] - > -} - -interface BlogRouteRouteChildren { - BlogSlugRoute: typeof BlogSlugRoute - BlogIndexRoute: typeof BlogIndexRoute -} - -const BlogRouteRouteChildren: BlogRouteRouteChildren = { - BlogSlugRoute: BlogSlugRoute, - BlogIndexRoute: BlogIndexRoute, -} - -const BlogRouteRouteWithChildren = BlogRouteRoute._addFileChildren( - BlogRouteRouteChildren, -) - -interface PostsRouteRouteChildren { - PostsIndexRoute: typeof PostsIndexRoute - PostsPostIdDeepRoute: typeof PostsPostIdDeepRoute - PostsPostIdIndexRoute: typeof PostsPostIdIndexRoute -} - -const PostsRouteRouteChildren: PostsRouteRouteChildren = { - PostsIndexRoute: PostsIndexRoute, - PostsPostIdDeepRoute: PostsPostIdDeepRoute, - PostsPostIdIndexRoute: PostsPostIdIndexRoute, -} - -const PostsRouteRouteWithChildren = PostsRouteRoute._addFileChildren( - PostsRouteRouteChildren, -) - -interface PathlessLayoutRouteChildren { - PathlessLayoutSettingsRoute: typeof PathlessLayoutSettingsRoute -} - -const PathlessLayoutRouteChildren: PathlessLayoutRouteChildren = { - PathlessLayoutSettingsRoute: PathlessLayoutSettingsRoute, -} - -const PathlessLayoutRouteWithChildren = PathlessLayoutRoute._addFileChildren( - PathlessLayoutRouteChildren, -) - -interface BlogBlogIdRouteRouteChildren { - BlogBlogIdSlugRouteRoute: typeof BlogBlogIdSlugRouteRoute - BlogBlogIdSlugBarRoute: typeof BlogBlogIdSlugBarRoute -} - -const BlogBlogIdRouteRouteChildren: BlogBlogIdRouteRouteChildren = { - BlogBlogIdSlugRouteRoute: BlogBlogIdSlugRouteRoute, - BlogBlogIdSlugBarRoute: BlogBlogIdSlugBarRoute, -} - -const BlogBlogIdRouteRouteWithChildren = BlogBlogIdRouteRoute._addFileChildren( - BlogBlogIdRouteRouteChildren, -) - -const rootRouteChildren: RootRouteChildren = { - IndexRoute: IndexRoute, - BlogRouteRoute: BlogRouteRouteWithChildren, - PostsRouteRoute: PostsRouteRouteWithChildren, - PathlessLayoutRoute: PathlessLayoutRouteWithChildren, - BlogBlogIdRouteRoute: BlogBlogIdRouteRouteWithChildren, - BlogStatsRoute: BlogStatsRoute, - BlogBlogIdEditRoute: BlogBlogIdEditRoute, -} -export const routeTree = rootRouteImport - ._addFileChildren(rootRouteChildren) - ._addFileTypes<FileRouteTypes>() diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/__root.tsx b/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/__root.tsx deleted file mode 100644 index f89644e82d..0000000000 --- a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/__root.tsx +++ /dev/null @@ -1,11 +0,0 @@ -import * as React from 'react' -import { Outlet, createRootRoute } from '@tanstack/react-router' - -export const Route = createRootRoute({ - component: () => ( - <React.Fragment> - <div>Hello "__root"!</div> - <Outlet /> - </React.Fragment> - ), -}) diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/_pathlessLayout.tsx b/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/_pathlessLayout.tsx deleted file mode 100644 index ae38370b80..0000000000 --- a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/_pathlessLayout.tsx +++ /dev/null @@ -1,4 +0,0 @@ -import { Outlet } from '@tanstack/react-router' -export const Route = createFileRoute({ - component: () => <Outlet />, -}) diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/_pathlessLayout/settings.tsx b/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/_pathlessLayout/settings.tsx deleted file mode 100644 index b2a1f1a950..0000000000 --- a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/_pathlessLayout/settings.tsx +++ /dev/null @@ -1,3 +0,0 @@ -export const Route = createFileRoute({ - component: () => <div>Settings</div>, -}) diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog/$slug.tsx b/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog/$slug.tsx deleted file mode 100644 index 784c2b78ae..0000000000 --- a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog/$slug.tsx +++ /dev/null @@ -1,3 +0,0 @@ -export const Route = createFileRoute({ - component: () => <div>Hello /blog/$slug!</div>, -}) diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog/index.tsx b/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog/index.tsx deleted file mode 100644 index 0754024ed7..0000000000 --- a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog/index.tsx +++ /dev/null @@ -1,3 +0,0 @@ -export const Route = createFileRoute({ - component: () => <div>Hello /blog/!</div>, -}) diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog/route.tsx b/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog/route.tsx deleted file mode 100644 index ea94edad49..0000000000 --- a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog/route.tsx +++ /dev/null @@ -1,3 +0,0 @@ -export const Route = createFileRoute({ - component: () => <div>Hello /blog!</div>, -}) diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog_/$blogId/$slug/route.tsx b/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog_/$blogId/$slug/route.tsx deleted file mode 100644 index 3411fd0b37..0000000000 --- a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog_/$blogId/$slug/route.tsx +++ /dev/null @@ -1,3 +0,0 @@ -export const Route = createFileRoute({ - component: () => <div>Hello /blog_/$blogId/$slug/route!</div>, -}) diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog_/$blogId/$slug_/bar.tsx b/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog_/$blogId/$slug_/bar.tsx deleted file mode 100644 index c39dd91dfe..0000000000 --- a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog_/$blogId/$slug_/bar.tsx +++ /dev/null @@ -1,3 +0,0 @@ -export const Route = createFileRoute({ - component: () => <div>Hello /blog_/$blogId/$slug_/bar!</div>, -}) diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog_/$blogId/route.tsx b/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog_/$blogId/route.tsx deleted file mode 100644 index e1d6f6524f..0000000000 --- a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog_/$blogId/route.tsx +++ /dev/null @@ -1,3 +0,0 @@ -export const Route = createFileRoute({ - component: () => <div>Hello /blog_/$blogId/route!</div>, -}) diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog_/$blogId_/edit.tsx b/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog_/$blogId_/edit.tsx deleted file mode 100644 index 1337ddd18b..0000000000 --- a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog_/$blogId_/edit.tsx +++ /dev/null @@ -1,3 +0,0 @@ -export const Route = createFileRoute({ - component: () => <div>Hello /blog_/$blogId_/edit!</div>, -}) diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog_/stats.tsx b/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog_/stats.tsx deleted file mode 100644 index 16cc7268df..0000000000 --- a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/blog_/stats.tsx +++ /dev/null @@ -1,3 +0,0 @@ -export const Route = createFileRoute({ - component: () => <div>Hello /blog/stats!</div>, -}) diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/index.tsx b/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/index.tsx deleted file mode 100644 index 22cab82307..0000000000 --- a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/index.tsx +++ /dev/null @@ -1,3 +0,0 @@ -export const Route = createFileRoute({ - component: () => <div>Hello /!</div>, -}) diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/posts/$postId/deep.tsx b/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/posts/$postId/deep.tsx deleted file mode 100644 index 6e634d9098..0000000000 --- a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/posts/$postId/deep.tsx +++ /dev/null @@ -1,6 +0,0 @@ -export const Route = createFileRoute({ - context: () => ({ someContext: 'context' }), - loaderDeps: () => ({ dep: 1 }), - loader: () => ({ data: 'data' }), - component: () => <div>Hello /posts/$postId/deep!</div>, -}) diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/posts/$postId/index.tsx b/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/posts/$postId/index.tsx deleted file mode 100644 index 6e8e65dae7..0000000000 --- a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/posts/$postId/index.tsx +++ /dev/null @@ -1,6 +0,0 @@ -export const Route = createFileRoute({ - validateSearch: () => ({ - indexSearch: 'search', - }), - component: () => <div>Hello /posts/$postId/!</div>, -}) diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/posts/index.tsx b/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/posts/index.tsx deleted file mode 100644 index 2e16af1ca1..0000000000 --- a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/posts/index.tsx +++ /dev/null @@ -1,3 +0,0 @@ -export const Route = createFileRoute({ - component: () => <div>Hello /posts/!</div>, -}) diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/posts/route.tsx b/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/posts/route.tsx deleted file mode 100644 index 3617558181..0000000000 --- a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/routes/posts/route.tsx +++ /dev/null @@ -1,3 +0,0 @@ -export const Route = createFileRoute({ - component: () => <div>Hello /posts!</div>, -}) diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/__root.tsx b/packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/__root.tsx deleted file mode 100644 index f89644e82d..0000000000 --- a/packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/__root.tsx +++ /dev/null @@ -1,11 +0,0 @@ -import * as React from 'react' -import { Outlet, createRootRoute } from '@tanstack/react-router' - -export const Route = createRootRoute({ - component: () => ( - <React.Fragment> - <div>Hello "__root"!</div> - <Outlet /> - </React.Fragment> - ), -}) diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-true/tests.test-d.ts b/packages/router-generator/tests/generator/nested-verboseFileRoutes-true/tests.test-d.ts deleted file mode 100644 index 47dcc0f5b1..0000000000 --- a/packages/router-generator/tests/generator/nested-verboseFileRoutes-true/tests.test-d.ts +++ /dev/null @@ -1,672 +0,0 @@ -import { - Link, - createRouter, - redirect, - useLoaderData, - useLoaderDeps, - useMatch, - useNavigate, - useParams, - useRouteContext, - useSearch, -} from '@tanstack/react-router' -import type { FileRoutesByPath, MakeRouteMatch } from '@tanstack/react-router' -import { expectTypeOf, test } from 'vitest' -import { routeTree } from './routeTree.gen' -import type { FileRouteTypes } from './routeTree.gen' - -const defaultRouter = createRouter({ - routeTree, -}) - -type DefaultRouter = typeof defaultRouter - -const alwaysTrailingSlashRouter = createRouter({ - routeTree, - trailingSlash: 'always', -}) - -const neverTrailingSlashRouter = createRouter({ - routeTree, - trailingSlash: 'never', -}) - -const preserveTrailingSlashRouter = createRouter({ - routeTree, - trailingSlash: 'preserve', -}) - -test('when navigating to the root', () => { - // Issue #4892: Pathless layout routes should have fullPath: '/' not '' - expectTypeOf<FileRoutesByPath['/']['fullPath']>().toEqualTypeOf<'/'>() - expectTypeOf< - FileRoutesByPath['/posts/']['fullPath'] - >().toEqualTypeOf<'/posts/'>() - // Issue #6403: Index routes should have trailing slash in fullPath to match runtime - expectTypeOf< - FileRoutesByPath['/posts/$postId/']['fullPath'] - >().toEqualTypeOf<'/posts/$postId/'>() - expectTypeOf< - FileRoutesByPath['/blog/']['fullPath'] - >().toEqualTypeOf<'/blog/'>() - // Verify empty string is not in fullPaths union - expectTypeOf<''>().not.toMatchTypeOf<FileRouteTypes['fullPaths']>() - // Verify pathless layout's fullPath is '/' (not '') - expectTypeOf< - FileRoutesByPath['/_pathlessLayout']['fullPath'] - >().toEqualTypeOf<'/'>() - // Child of pathless layout should have correct fullPath - expectTypeOf< - FileRoutesByPath['/_pathlessLayout/settings']['fullPath'] - >().toEqualTypeOf<'/settings'>() - - expectTypeOf(Link<typeof defaultRouter, '/', '/'>) - .parameter(0) - .toHaveProperty('to') - .toEqualTypeOf< - | '/' - | '/blog' - | '/posts' - | '/blog/$blogId' - | '/blog/$blogId/edit' - | '/blog/$blogId/$slug' - | '/blog/$blogId/$slug/bar' - | '/blog/$slug' - | '/blog/stats' - | '/posts/$postId/deep' - | '/posts/$postId' - | '/settings' - | undefined - >() - - expectTypeOf(Link<typeof alwaysTrailingSlashRouter, '/', '/'>) - .parameter(0) - .toHaveProperty('to') - .toEqualTypeOf< - | '/' - | '/blog/' - | '/posts/' - | '/blog/$blogId/' - | '/blog/$blogId/edit/' - | '/blog/$blogId/$slug/' - | '/blog/$blogId/$slug/bar/' - | '/blog/$slug/' - | '/blog/stats/' - | '/posts/$postId/deep/' - | '/posts/$postId/' - | '/settings/' - | undefined - >() - - expectTypeOf(Link<typeof neverTrailingSlashRouter, '/', '/'>) - .parameter(0) - .toHaveProperty('to') - .toEqualTypeOf< - | '/' - | '/blog' - | '/posts' - | '/blog/$blogId' - | '/blog/$blogId/edit' - | '/blog/$blogId/$slug' - | '/blog/$blogId/$slug/bar' - | '/blog/$slug' - | '/blog/stats' - | '/posts/$postId/deep' - | '/posts/$postId' - | '/settings' - | undefined - >() - - expectTypeOf(Link<typeof preserveTrailingSlashRouter, '/', '/'>) - .parameter(0) - .toHaveProperty('to') - .toEqualTypeOf< - | '/' - | '/blog' - | '/posts' - | '/blog/$blogId' - | '/blog/$blogId/edit' - | '/blog/$blogId/$slug' - | '/blog/$blogId/$slug/bar' - | '/blog/$slug' - | '/blog/stats' - | '/posts/$postId/deep' - | '/posts/$postId' - | '/blog/' - | '/posts/' - | '/blog/$blogId/' - | '/blog/$blogId/edit/' - | '/blog/$blogId/$slug/' - | '/blog/$blogId/$slug/bar/' - | '/blog/$slug/' - | '/blog/stats/' - | '/posts/$postId/deep/' - | '/posts/$postId/' - | '/settings/' - | '/settings' - | undefined - >() - - expectTypeOf(Link<typeof defaultRouter, '/', '/'>) - .parameter(0) - .toHaveProperty('from') - .toEqualTypeOf< - | '/' - | '/blog' - | '/posts' - | '/blog/$blogId' - | '/blog/$blogId/edit' - | '/blog/$blogId/$slug' - | '/blog/$blogId/$slug/bar' - | '/blog/$slug' - | '/blog/stats' - | '/blog/' - | '/posts/' - | '/posts/$postId/deep' - | '/posts/$postId/' - | '/settings' - | undefined - >() - - expectTypeOf(Link<typeof defaultRouter, '/', '/'>) - .parameter(0) - .toHaveProperty('search') - .exclude<(...args: any) => any>() - .toEqualTypeOf<true | {} | undefined>() - - expectTypeOf(Link<typeof alwaysTrailingSlashRouter, '/', '/'>) - .parameter(0) - .toHaveProperty('search') - .exclude<(...args: any) => any>() - .toEqualTypeOf<true | {} | undefined>() - - expectTypeOf(Link<typeof neverTrailingSlashRouter, '/', '/'>) - .parameter(0) - .toHaveProperty('search') - .exclude<(...args: any) => any>() - .toEqualTypeOf<true | {} | undefined>() - - expectTypeOf(Link<typeof preserveTrailingSlashRouter, '/', '/'>) - .parameter(0) - .toHaveProperty('search') - .exclude<(...args: any) => any>() - .toEqualTypeOf<true | {} | undefined>() -}) - -test('when navigating a index route with search and params', () => { - expectTypeOf(Link<typeof defaultRouter, string, '/posts/$postId'>) - .parameter(0) - .toHaveProperty('to') - .toEqualTypeOf< - | '.' - | '..' - | '/' - | '/blog' - | '/posts' - | '/blog/$blogId' - | '/blog/$blogId/edit' - | '/blog/$blogId/$slug' - | '/blog/$blogId/$slug/bar' - | '/blog/$slug' - | '/blog/stats' - | '/posts/$postId/deep' - | '/posts/$postId' - | '/settings' - >() - - expectTypeOf( - Link<typeof alwaysTrailingSlashRouter, string, '/posts/$postId/'>, - ) - .parameter(0) - .toHaveProperty('to') - .toEqualTypeOf< - | './' - | '../' - | '/' - | '/blog/' - | '/posts/' - | '/blog/$blogId/' - | '/blog/$blogId/edit/' - | '/blog/$blogId/$slug/' - | '/blog/$blogId/$slug/bar/' - | '/blog/$slug/' - | '/blog/stats/' - | '/posts/$postId/deep/' - | '/posts/$postId/' - | '/settings/' - >() - - expectTypeOf(Link<typeof neverTrailingSlashRouter, string, '/posts/$postId'>) - .parameter(0) - .toHaveProperty('to') - .toEqualTypeOf< - | '/' - | '/blog' - | '/posts' - | '/blog/$blogId' - | '/blog/$blogId/edit' - | '/blog/$blogId/$slug' - | '/blog/$blogId/$slug/bar' - | '/blog/$slug' - | '/blog/stats' - | '/posts/$postId/deep' - | '/posts/$postId' - | '/settings' - | '.' - | '..' - >() - - expectTypeOf( - Link<typeof preserveTrailingSlashRouter, string, '/posts/$postId'>, - ) - .parameter(0) - .toHaveProperty('to') - .toEqualTypeOf< - | '..' - | '../' - | '.' - | './' - | '/' - | '/blog' - | '/posts' - | '/blog/$blogId' - | '/blog/$blogId/edit' - | '/blog/$blogId/$slug' - | '/blog/$blogId/$slug/bar' - | '/blog/$slug' - | '/blog/stats' - | '/posts/$postId/deep' - | '/posts/$postId' - | '/blog/' - | '/posts/' - | '/blog/$blogId/' - | '/blog/$blogId/edit/' - | '/blog/$blogId/$slug/' - | '/blog/$blogId/$slug/bar/' - | '/blog/$slug/' - | '/blog/stats/' - | '/posts/$postId/deep/' - | '/posts/$postId/' - | '/settings' - | '/settings/' - >() - - expectTypeOf(Link<typeof defaultRouter, '/', '/posts/$postId'>) - .parameter(0) - .toHaveProperty('from') - .toEqualTypeOf< - | '/' - | '/posts/$postId/' - | '/blog' - | '/posts' - | '/blog/$blogId' - | '/blog/$blogId/edit' - | '/blog/$blogId/$slug' - | '/blog/$blogId/$slug/bar' - | '/blog/$slug' - | '/blog/stats' - | '/blog/' - | '/posts/' - | '/posts/$postId/deep' - | '/settings' - | undefined - >() - - expectTypeOf(Link<typeof defaultRouter, string, '/posts/$postId'>) - .parameter(0) - .toHaveProperty('search') - .exclude<(...args: any) => any>() - .toEqualTypeOf<{ indexSearch: string }>() - - expectTypeOf(Link<typeof defaultRouter, string, '/posts/$postId/'>) - .parameter(0) - .toHaveProperty('search') - .exclude<(...args: any) => any>() - .toEqualTypeOf<never>() - - expectTypeOf( - Link<typeof alwaysTrailingSlashRouter, string, '/posts/$postId/'>, - ) - .parameter(0) - .toHaveProperty('search') - .exclude<(...args: any) => any>() - .toEqualTypeOf<{ indexSearch: string }>() - - expectTypeOf(Link<typeof alwaysTrailingSlashRouter, string, '/posts/$postId'>) - .parameter(0) - .toHaveProperty('search') - .exclude<(...args: any) => any>() - .toEqualTypeOf<never>() - - expectTypeOf(Link<typeof neverTrailingSlashRouter, string, '/posts/$postId'>) - .parameter(0) - .toHaveProperty('search') - .exclude<(...args: any) => any>() - .toEqualTypeOf<{ indexSearch: string }>() - - expectTypeOf(Link<typeof preserveTrailingSlashRouter, '/', '/posts/$postId'>) - .parameter(0) - .toHaveProperty('search') - .exclude<(...args: any) => any>() - .toEqualTypeOf<{ indexSearch: string }>() - - expectTypeOf(Link<typeof preserveTrailingSlashRouter, '/', '/posts/$postId/'>) - .parameter(0) - .toHaveProperty('search') - .exclude<(...args: any) => any>() - .toEqualTypeOf<{ indexSearch: string }>() - - expectTypeOf(Link<typeof defaultRouter, string, '/posts/$postId'>) - .parameter(0) - .toHaveProperty('params') - .exclude<(...args: any) => any>() - .toEqualTypeOf<{ postId: string }>() - - expectTypeOf(Link<typeof defaultRouter, string, '/posts/$postId/'>) - .parameter(0) - .toHaveProperty('params') - .exclude<(...args: any) => any>() - .toEqualTypeOf<never>() - - expectTypeOf( - Link<typeof alwaysTrailingSlashRouter, string, '/posts/$postId/'>, - ) - .parameter(0) - .toHaveProperty('params') - .exclude<(...args: any) => any>() - .toEqualTypeOf<{ postId: string }>() - - expectTypeOf(Link<typeof alwaysTrailingSlashRouter, string, '/posts/$postId'>) - .parameter(0) - .toHaveProperty('params') - .exclude<(...args: any) => any>() - .toEqualTypeOf<never>() - - expectTypeOf(Link<typeof neverTrailingSlashRouter, string, '/posts/$postId'>) - .parameter(0) - .toHaveProperty('params') - .exclude<(...args: any) => any>() - .toEqualTypeOf<{ postId: string }>() - - expectTypeOf(Link<typeof preserveTrailingSlashRouter, '/', '/posts/$postId'>) - .parameter(0) - .toHaveProperty('params') - .exclude<(...args: any) => any>() - .toEqualTypeOf<{ postId: string }>() - - expectTypeOf(Link<typeof preserveTrailingSlashRouter, '/', '/posts/$postId/'>) - .parameter(0) - .toHaveProperty('params') - .exclude<(...args: any) => any>() - .toEqualTypeOf<{ postId: string }>() -}) - -test('when navigating from a index route with search and params', () => { - expectTypeOf(Link<typeof defaultRouter, '/posts/$postId/', undefined>) - .parameter(0) - .toHaveProperty('from') - .toEqualTypeOf< - | '/' - | '/posts/$postId/' - | '/blog' - | '/posts' - | '/blog/$blogId' - | '/blog/$blogId/edit' - | '/blog/$blogId/$slug' - | '/blog/$blogId/$slug/bar' - | '/blog/$slug' - | '/blog/stats' - | '/blog/' - | '/posts/' - | '/posts/$postId/deep' - | '/settings' - | undefined - >() - - expectTypeOf(Link<typeof defaultRouter, '/posts/$postId/', undefined>) - .parameter(0) - .toHaveProperty('search') - .parameter(0) - .toEqualTypeOf<{ indexSearch: string }>() -}) - -test('when using useNavigate', () => { - const navigate = useNavigate() - - expectTypeOf(navigate<DefaultRouter, '/'>) - .parameter(0) - .toHaveProperty('to') - .toEqualTypeOf< - | '/' - | '.' - | '..' - | '/blog' - | '/posts' - | '/blog/$blogId' - | '/blog/$blogId/edit' - | '/blog/$blogId/$slug' - | '/blog/$blogId/$slug/bar' - | '/blog/$slug' - | '/blog/stats' - | '/posts/$postId/deep' - | '/posts/$postId' - | '/settings' - >() -}) - -test('when using redirect', () => { - expectTypeOf(redirect<DefaultRouter, '/', '/'>) - .parameter(0) - .toHaveProperty('to') - .toEqualTypeOf< - | '/' - | '/posts/$postId' - | '/blog' - | '/posts' - | '/blog/$blogId' - | '/blog/$blogId/edit' - | '/blog/$blogId/$slug' - | '/blog/$blogId/$slug/bar' - | '/blog/$slug' - | '/blog/stats' - | '/posts/$postId/deep' - | '/settings' - | undefined - >() -}) - -test('when using useSearch from a route with no search', () => { - expectTypeOf(useSearch<DefaultRouter, '/blog'>) - .parameter(0) - .toHaveProperty('from') - .toEqualTypeOf< - | '__root__' - | '/' - | '/blog' - | '/posts' - | '/blog/$slug' - | '/blog_/$blogId' - | '/blog_/$blogId_/edit' - | '/blog_/$blogId/$slug' - | '/blog_/$blogId/$slug_/bar' - | '/blog_/stats' - | '/blog/' - | '/posts/' - | '/posts/$postId/deep' - | '/posts/$postId/' - | '/_pathlessLayout' - | '/_pathlessLayout/settings' - >() - - expectTypeOf(useSearch<DefaultRouter, '/blog'>).returns.toEqualTypeOf<{}>() -}) - -test('when using useSearch from a route with search', () => { - expectTypeOf(useSearch<DefaultRouter, '/blog'>) - .parameter(0) - .toHaveProperty('from') - .toEqualTypeOf< - | '__root__' - | '/' - | '/blog' - | '/posts' - | '/blog/$slug' - | '/blog_/$blogId' - | '/blog_/$blogId_/edit' - | '/blog_/$blogId/$slug' - | '/blog_/$blogId/$slug_/bar' - | '/blog_/stats' - | '/blog/' - | '/posts/' - | '/posts/$postId/deep' - | '/posts/$postId/' - | '/_pathlessLayout' - | '/_pathlessLayout/settings' - >() - - expectTypeOf( - useSearch<DefaultRouter, '/posts/$postId/'>, - ).returns.toEqualTypeOf<{ indexSearch: string }>() -}) - -test('when using useLoaderData from a route with loaderData', () => { - expectTypeOf(useLoaderData<DefaultRouter, '/posts/$postId/deep'>) - .parameter(0) - .toHaveProperty('from') - .toEqualTypeOf< - | '__root__' - | '/' - | '/blog' - | '/posts' - | '/blog/$slug' - | '/blog_/$blogId' - | '/blog_/$blogId_/edit' - | '/blog_/$blogId/$slug' - | '/blog_/$blogId/$slug_/bar' - | '/blog_/stats' - | '/blog/' - | '/posts/' - | '/posts/$postId/deep' - | '/posts/$postId/' - | '/_pathlessLayout' - | '/_pathlessLayout/settings' - >() - - expectTypeOf( - useLoaderData<DefaultRouter, '/posts/$postId/deep'>, - ).returns.toEqualTypeOf<{ data: string }>() -}) - -test('when using useLoaderDeps from a route with loaderDeps', () => { - expectTypeOf(useLoaderDeps<DefaultRouter, '/posts/$postId/deep'>) - .parameter(0) - .toHaveProperty('from') - .toEqualTypeOf< - | '__root__' - | '/' - | '/blog' - | '/posts' - | '/blog/$slug' - | '/blog_/$blogId' - | '/blog_/$blogId_/edit' - | '/blog_/$blogId/$slug' - | '/blog_/$blogId/$slug_/bar' - | '/blog_/stats' - | '/blog/' - | '/posts/' - | '/posts/$postId/deep' - | '/posts/$postId/' - | '/_pathlessLayout' - | '/_pathlessLayout/settings' - >() - - expectTypeOf( - useLoaderDeps<DefaultRouter, '/posts/$postId/deep'>, - ).returns.toEqualTypeOf<{ dep: number }>() -}) - -test('when using useMatch from a route', () => { - expectTypeOf(useMatch<DefaultRouter, '/posts/$postId/deep'>) - .parameter(0) - .toHaveProperty('from') - .toEqualTypeOf< - | '__root__' - | '/' - | '/blog' - | '/posts' - | '/blog/$slug' - | '/blog_/$blogId' - | '/blog_/$blogId_/edit' - | '/blog_/$blogId/$slug' - | '/blog_/$blogId/$slug_/bar' - | '/blog_/stats' - | '/blog/' - | '/posts/' - | '/posts/$postId/deep' - | '/posts/$postId/' - | '/_pathlessLayout' - | '/_pathlessLayout/settings' - >() - - expectTypeOf( - useMatch<DefaultRouter, '/posts/$postId/deep'>, - ).returns.toEqualTypeOf< - MakeRouteMatch<DefaultRouter['routeTree'], '/posts/$postId/deep', true> - >() -}) - -test('when using useParams from a route', () => { - expectTypeOf(useParams<DefaultRouter, '/posts/$postId/deep'>) - .parameter(0) - .toHaveProperty('from') - .toEqualTypeOf< - | '__root__' - | '/' - | '/blog' - | '/posts' - | '/blog/$slug' - | '/blog_/$blogId' - | '/blog_/$blogId_/edit' - | '/blog_/$blogId/$slug' - | '/blog_/$blogId/$slug_/bar' - | '/blog_/stats' - | '/blog/' - | '/posts/' - | '/posts/$postId/deep' - | '/posts/$postId/' - | '/_pathlessLayout' - | '/_pathlessLayout/settings' - >() - - expectTypeOf( - useParams<DefaultRouter, '/posts/$postId/deep'>, - ).returns.toEqualTypeOf<{ postId: string }>() -}) - -test('when using useRouteContext from a route', () => { - expectTypeOf(useRouteContext<DefaultRouter, '/posts/$postId/deep'>) - .parameter(0) - .toHaveProperty('from') - .toEqualTypeOf< - | '__root__' - | '/' - | '/blog' - | '/posts' - | '/blog/$slug' - | '/blog_/$blogId' - | '/blog_/$blogId_/edit' - | '/blog_/$blogId/$slug' - | '/blog_/$blogId/$slug_/bar' - | '/blog_/stats' - | '/blog/' - | '/posts/' - | '/posts/$postId/deep' - | '/posts/$postId/' - | '/_pathlessLayout' - | '/_pathlessLayout/settings' - >() - - expectTypeOf( - useRouteContext<DefaultRouter, '/posts/$postId/deep'>, - ).returns.toEqualTypeOf<{ someContext: string }>() -}) diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routeTree.snapshot.ts b/packages/router-generator/tests/generator/nested/routeTree.snapshot.ts similarity index 100% rename from packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routeTree.snapshot.ts rename to packages/router-generator/tests/generator/nested/routeTree.snapshot.ts diff --git a/packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/routes/__root.tsx b/packages/router-generator/tests/generator/nested/routes/__root.tsx similarity index 100% rename from packages/router-generator/tests/generator/file-modification-verboseFileRoutes-true/routes/__root.tsx rename to packages/router-generator/tests/generator/nested/routes/__root.tsx diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/_pathlessLayout.tsx b/packages/router-generator/tests/generator/nested/routes/_pathlessLayout.tsx similarity index 100% rename from packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/_pathlessLayout.tsx rename to packages/router-generator/tests/generator/nested/routes/_pathlessLayout.tsx diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/_pathlessLayout/settings.tsx b/packages/router-generator/tests/generator/nested/routes/_pathlessLayout/settings.tsx similarity index 100% rename from packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/_pathlessLayout/settings.tsx rename to packages/router-generator/tests/generator/nested/routes/_pathlessLayout/settings.tsx diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/blog/$slug.tsx b/packages/router-generator/tests/generator/nested/routes/blog/$slug.tsx similarity index 100% rename from packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/blog/$slug.tsx rename to packages/router-generator/tests/generator/nested/routes/blog/$slug.tsx diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/blog/index.tsx b/packages/router-generator/tests/generator/nested/routes/blog/index.tsx similarity index 100% rename from packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/blog/index.tsx rename to packages/router-generator/tests/generator/nested/routes/blog/index.tsx diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/blog/route.tsx b/packages/router-generator/tests/generator/nested/routes/blog/route.tsx similarity index 100% rename from packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/blog/route.tsx rename to packages/router-generator/tests/generator/nested/routes/blog/route.tsx diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/blog_/$blogId/$slug/route.tsx b/packages/router-generator/tests/generator/nested/routes/blog_/$blogId/$slug/route.tsx similarity index 100% rename from packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/blog_/$blogId/$slug/route.tsx rename to packages/router-generator/tests/generator/nested/routes/blog_/$blogId/$slug/route.tsx diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/blog_/$blogId/$slug_/bar.tsx b/packages/router-generator/tests/generator/nested/routes/blog_/$blogId/$slug_/bar.tsx similarity index 100% rename from packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/blog_/$blogId/$slug_/bar.tsx rename to packages/router-generator/tests/generator/nested/routes/blog_/$blogId/$slug_/bar.tsx diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/blog_/$blogId/route.tsx b/packages/router-generator/tests/generator/nested/routes/blog_/$blogId/route.tsx similarity index 100% rename from packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/blog_/$blogId/route.tsx rename to packages/router-generator/tests/generator/nested/routes/blog_/$blogId/route.tsx diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/blog_/$blogId_/edit.tsx b/packages/router-generator/tests/generator/nested/routes/blog_/$blogId_/edit.tsx similarity index 100% rename from packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/blog_/$blogId_/edit.tsx rename to packages/router-generator/tests/generator/nested/routes/blog_/$blogId_/edit.tsx diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/blog_/stats.tsx b/packages/router-generator/tests/generator/nested/routes/blog_/stats.tsx similarity index 100% rename from packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/blog_/stats.tsx rename to packages/router-generator/tests/generator/nested/routes/blog_/stats.tsx diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/index.tsx b/packages/router-generator/tests/generator/nested/routes/index.tsx similarity index 100% rename from packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/index.tsx rename to packages/router-generator/tests/generator/nested/routes/index.tsx diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/posts/$postId/deep.tsx b/packages/router-generator/tests/generator/nested/routes/posts/$postId/deep.tsx similarity index 100% rename from packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/posts/$postId/deep.tsx rename to packages/router-generator/tests/generator/nested/routes/posts/$postId/deep.tsx diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/posts/$postId/index.tsx b/packages/router-generator/tests/generator/nested/routes/posts/$postId/index.tsx similarity index 100% rename from packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/posts/$postId/index.tsx rename to packages/router-generator/tests/generator/nested/routes/posts/$postId/index.tsx diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/posts/index.tsx b/packages/router-generator/tests/generator/nested/routes/posts/index.tsx similarity index 100% rename from packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/posts/index.tsx rename to packages/router-generator/tests/generator/nested/routes/posts/index.tsx diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/posts/route.tsx b/packages/router-generator/tests/generator/nested/routes/posts/route.tsx similarity index 100% rename from packages/router-generator/tests/generator/nested-verboseFileRoutes-true/routes/posts/route.tsx rename to packages/router-generator/tests/generator/nested/routes/posts/route.tsx diff --git a/packages/router-generator/tests/generator/nested-verboseFileRoutes-false/tests.test-d.ts b/packages/router-generator/tests/generator/nested/tests.test-d.ts similarity index 100% rename from packages/router-generator/tests/generator/nested-verboseFileRoutes-false/tests.test-d.ts rename to packages/router-generator/tests/generator/nested/tests.test-d.ts diff --git a/packages/router-generator/tests/generator/pathless-to-index-preference/routeTree.snapshot.ts b/packages/router-generator/tests/generator/pathless-to-index-preference/routeTree.snapshot.ts new file mode 100644 index 0000000000..e9c9d6fac6 --- /dev/null +++ b/packages/router-generator/tests/generator/pathless-to-index-preference/routeTree.snapshot.ts @@ -0,0 +1,147 @@ +/* eslint-disable */ + +// @ts-nocheck + +// noinspection JSUnusedGlobalSymbols + +// This file was automatically generated by TanStack Router. +// You should NOT make any changes in this file as it will be overwritten. +// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. + +import { Route as rootRouteImport } from './routes/__root' +import { Route as LivestockFarmIdMedicineRouteRouteImport } from './routes/livestock/$farmId/medicine/route' +import { Route as LivestockFarmIdMedicineIndexRouteImport } from './routes/livestock/$farmId/medicine/index' +import { Route as LivestockFarmIdMedicineFormRouteImport } from './routes/livestock/$farmId/medicine/_form' +import { Route as LivestockFarmIdMedicineFormNewRouteImport } from './routes/livestock/$farmId/medicine/_form.new' + +const LivestockFarmIdMedicineRouteRoute = + LivestockFarmIdMedicineRouteRouteImport.update({ + id: '/livestock/$farmId/medicine', + path: '/livestock/$farmId/medicine', + getParentRoute: () => rootRouteImport, + } as any) +const LivestockFarmIdMedicineIndexRoute = + LivestockFarmIdMedicineIndexRouteImport.update({ + id: '/', + path: '/', + getParentRoute: () => LivestockFarmIdMedicineRouteRoute, + } as any) +const LivestockFarmIdMedicineFormRoute = + LivestockFarmIdMedicineFormRouteImport.update({ + id: '/_form', + getParentRoute: () => LivestockFarmIdMedicineRouteRoute, + } as any) +const LivestockFarmIdMedicineFormNewRoute = + LivestockFarmIdMedicineFormNewRouteImport.update({ + id: '/new', + path: '/new', + getParentRoute: () => LivestockFarmIdMedicineFormRoute, + } as any) + +export interface FileRoutesByFullPath { + '/livestock/$farmId/medicine': typeof LivestockFarmIdMedicineRouteRouteWithChildren + '/livestock/$farmId/medicine/': typeof LivestockFarmIdMedicineIndexRoute + '/livestock/$farmId/medicine/new': typeof LivestockFarmIdMedicineFormNewRoute +} +export interface FileRoutesByTo { + '/livestock/$farmId/medicine': typeof LivestockFarmIdMedicineIndexRoute + '/livestock/$farmId/medicine/new': typeof LivestockFarmIdMedicineFormNewRoute +} +export interface FileRoutesById { + __root__: typeof rootRouteImport + '/livestock/$farmId/medicine': typeof LivestockFarmIdMedicineRouteRouteWithChildren + '/livestock/$farmId/medicine/_form': typeof LivestockFarmIdMedicineFormRouteWithChildren + '/livestock/$farmId/medicine/': typeof LivestockFarmIdMedicineIndexRoute + '/livestock/$farmId/medicine/_form/new': typeof LivestockFarmIdMedicineFormNewRoute +} +export interface FileRouteTypes { + fileRoutesByFullPath: FileRoutesByFullPath + fullPaths: + | '/livestock/$farmId/medicine' + | '/livestock/$farmId/medicine/' + | '/livestock/$farmId/medicine/new' + fileRoutesByTo: FileRoutesByTo + to: '/livestock/$farmId/medicine' | '/livestock/$farmId/medicine/new' + id: + | '__root__' + | '/livestock/$farmId/medicine' + | '/livestock/$farmId/medicine/_form' + | '/livestock/$farmId/medicine/' + | '/livestock/$farmId/medicine/_form/new' + fileRoutesById: FileRoutesById +} +export interface RootRouteChildren { + LivestockFarmIdMedicineRouteRoute: typeof LivestockFarmIdMedicineRouteRouteWithChildren +} + +declare module '@tanstack/react-router' { + interface FileRoutesByPath { + '/livestock/$farmId/medicine': { + id: '/livestock/$farmId/medicine' + path: '/livestock/$farmId/medicine' + fullPath: '/livestock/$farmId/medicine' + preLoaderRoute: typeof LivestockFarmIdMedicineRouteRouteImport + parentRoute: typeof rootRouteImport + } + '/livestock/$farmId/medicine/': { + id: '/livestock/$farmId/medicine/' + path: '/' + fullPath: '/livestock/$farmId/medicine/' + preLoaderRoute: typeof LivestockFarmIdMedicineIndexRouteImport + parentRoute: typeof LivestockFarmIdMedicineRouteRoute + } + '/livestock/$farmId/medicine/_form': { + id: '/livestock/$farmId/medicine/_form' + path: '' + fullPath: '/livestock/$farmId/medicine' + preLoaderRoute: typeof LivestockFarmIdMedicineFormRouteImport + parentRoute: typeof LivestockFarmIdMedicineRouteRoute + } + '/livestock/$farmId/medicine/_form/new': { + id: '/livestock/$farmId/medicine/_form/new' + path: '/new' + fullPath: '/livestock/$farmId/medicine/new' + preLoaderRoute: typeof LivestockFarmIdMedicineFormNewRouteImport + parentRoute: typeof LivestockFarmIdMedicineFormRoute + } + } +} + +interface LivestockFarmIdMedicineFormRouteChildren { + LivestockFarmIdMedicineFormNewRoute: typeof LivestockFarmIdMedicineFormNewRoute +} + +const LivestockFarmIdMedicineFormRouteChildren: LivestockFarmIdMedicineFormRouteChildren = + { + LivestockFarmIdMedicineFormNewRoute: LivestockFarmIdMedicineFormNewRoute, + } + +const LivestockFarmIdMedicineFormRouteWithChildren = + LivestockFarmIdMedicineFormRoute._addFileChildren( + LivestockFarmIdMedicineFormRouteChildren, + ) + +interface LivestockFarmIdMedicineRouteRouteChildren { + LivestockFarmIdMedicineFormRoute: typeof LivestockFarmIdMedicineFormRouteWithChildren + LivestockFarmIdMedicineIndexRoute: typeof LivestockFarmIdMedicineIndexRoute +} + +const LivestockFarmIdMedicineRouteRouteChildren: LivestockFarmIdMedicineRouteRouteChildren = + { + LivestockFarmIdMedicineFormRoute: + LivestockFarmIdMedicineFormRouteWithChildren, + LivestockFarmIdMedicineIndexRoute: LivestockFarmIdMedicineIndexRoute, + } + +const LivestockFarmIdMedicineRouteRouteWithChildren = + LivestockFarmIdMedicineRouteRoute._addFileChildren( + LivestockFarmIdMedicineRouteRouteChildren, + ) + +const rootRouteChildren: RootRouteChildren = { + LivestockFarmIdMedicineRouteRoute: + LivestockFarmIdMedicineRouteRouteWithChildren, +} +export const routeTree = rootRouteImport + ._addFileChildren(rootRouteChildren) + ._addFileTypes<FileRouteTypes>() diff --git a/packages/router-generator/tests/generator/pathless-to-index-preference/routes/__root.tsx b/packages/router-generator/tests/generator/pathless-to-index-preference/routes/__root.tsx new file mode 100644 index 0000000000..742d24a4ea --- /dev/null +++ b/packages/router-generator/tests/generator/pathless-to-index-preference/routes/__root.tsx @@ -0,0 +1,5 @@ +import { Outlet, createRootRoute } from '@tanstack/react-router' + +export const Route = createRootRoute({ + component: () => <Outlet />, +}) diff --git a/packages/router-generator/tests/generator/pathless-to-index-preference/routes/livestock/$farmId/medicine/_form.new.tsx b/packages/router-generator/tests/generator/pathless-to-index-preference/routes/livestock/$farmId/medicine/_form.new.tsx new file mode 100644 index 0000000000..0a7a240962 --- /dev/null +++ b/packages/router-generator/tests/generator/pathless-to-index-preference/routes/livestock/$farmId/medicine/_form.new.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/livestock/$farmId/medicine/_form/new')({ + component: () => <div>New medicine</div>, +}) diff --git a/packages/router-generator/tests/generator/pathless-to-index-preference/routes/livestock/$farmId/medicine/_form.tsx b/packages/router-generator/tests/generator/pathless-to-index-preference/routes/livestock/$farmId/medicine/_form.tsx new file mode 100644 index 0000000000..2fe794b8b3 --- /dev/null +++ b/packages/router-generator/tests/generator/pathless-to-index-preference/routes/livestock/$farmId/medicine/_form.tsx @@ -0,0 +1,5 @@ +import { Outlet, createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/livestock/$farmId/medicine/_form')({ + component: () => <Outlet />, +}) diff --git a/packages/router-generator/tests/generator/pathless-to-index-preference/routes/livestock/$farmId/medicine/index.tsx b/packages/router-generator/tests/generator/pathless-to-index-preference/routes/livestock/$farmId/medicine/index.tsx new file mode 100644 index 0000000000..13b4c3fb13 --- /dev/null +++ b/packages/router-generator/tests/generator/pathless-to-index-preference/routes/livestock/$farmId/medicine/index.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/livestock/$farmId/medicine/')({ + component: () => <div>Medicine index</div>, +}) diff --git a/packages/router-generator/tests/generator/pathless-to-index-preference/routes/livestock/$farmId/medicine/route.tsx b/packages/router-generator/tests/generator/pathless-to-index-preference/routes/livestock/$farmId/medicine/route.tsx new file mode 100644 index 0000000000..e1ef4d5afc --- /dev/null +++ b/packages/router-generator/tests/generator/pathless-to-index-preference/routes/livestock/$farmId/medicine/route.tsx @@ -0,0 +1,5 @@ +import { Outlet, createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/livestock/$farmId/medicine')({ + component: () => <Outlet />, +}) diff --git a/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routeTree.snapshot.ts b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routeTree.snapshot.ts new file mode 100644 index 0000000000..53a35bf149 --- /dev/null +++ b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routeTree.snapshot.ts @@ -0,0 +1,471 @@ +/* eslint-disable */ + +// @ts-nocheck + +// noinspection JSUnusedGlobalSymbols + +// This file was automatically generated by TanStack Router. +// You should NOT make any changes in this file as it will be overwritten. +// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. + +import { Route as rootRouteImport } from './routes/__root' +import { Route as Char91__rootIndexChar93IndexRouteImport } from './routes/[__root-index]/index' +import { Route as LayoutRouteImport } from './routes/_layout' +import { Route as FooRouteImport } from './routes/[_]foo' +import { Route as Char91__literalChar93RouteImport } from './routes/[__literal]' +import { Route as _layoutRouteImport } from './routes/__layout' +import { Route as RootIndexIndexRouteImport } from './routes/[_]root-index/index' +import { Route as LayoutNestedRouteImport } from './routes/_layout/_nested' +import { Route as LayoutBarRouteImport } from './routes/_layout/[_]bar' +import { Route as Layout_nested2RouteImport } from './routes/_layout/__nested2' +import { Route as LayoutChar91__doubleChar93RouteImport } from './routes/_layout/[__double]' +import { Route as _layoutQuxRouteImport } from './routes/__layout/[_]qux' +import { Route as LayoutNestedTrailingIndexRouteImport } from './routes/_layout/nested-trailing[_]/index' +import { Route as LayoutNestedIndexIndexRouteImport } from './routes/_layout/[_]nested-index/index' +import { Route as LayoutChar91__doubleIndexChar93IndexRouteImport } from './routes/_layout/[__double-index]/index' +import { Route as LayoutNestedBazRouteImport } from './routes/_layout/_nested/[_]baz' +import { Route as LayoutNestedIndexIdRouteImport } from './routes/_layout/[_]nested-index/$id' +import { Route as Layout_nested2DeepRouteImport } from './routes/_layout/__nested2/[_]deep' +import { Route as LayoutChar91__doubleIndexChar93IdRouteImport } from './routes/_layout/[__double-index]/$id' +import { Route as LayoutNestedDeepIndexIndexRouteImport } from './routes/_layout/_nested/[_]deep-index/index' + +const Char91__rootIndexChar93IndexRoute = + Char91__rootIndexChar93IndexRouteImport.update({ + id: '/__root-index/', + path: '/__root-index/', + getParentRoute: () => rootRouteImport, + } as any) +const LayoutRoute = LayoutRouteImport.update({ + id: '/_layout', + getParentRoute: () => rootRouteImport, +} as any) +const FooRoute = FooRouteImport.update({ + id: '/_foo', + path: '/_foo', + getParentRoute: () => rootRouteImport, +} as any) +const Char91__literalChar93Route = Char91__literalChar93RouteImport.update({ + id: '/__literal', + path: '/__literal', + getParentRoute: () => rootRouteImport, +} as any) +const _layoutRoute = _layoutRouteImport.update({ + id: '/__layout', + getParentRoute: () => rootRouteImport, +} as any) +const RootIndexIndexRoute = RootIndexIndexRouteImport.update({ + id: '/_root-index/', + path: '/_root-index/', + getParentRoute: () => rootRouteImport, +} as any) +const LayoutNestedRoute = LayoutNestedRouteImport.update({ + id: '/_nested', + getParentRoute: () => LayoutRoute, +} as any) +const LayoutBarRoute = LayoutBarRouteImport.update({ + id: '/_bar', + path: '/_bar', + getParentRoute: () => LayoutRoute, +} as any) +const Layout_nested2Route = Layout_nested2RouteImport.update({ + id: '/__nested2', + getParentRoute: () => LayoutRoute, +} as any) +const LayoutChar91__doubleChar93Route = + LayoutChar91__doubleChar93RouteImport.update({ + id: '/__double', + path: '/__double', + getParentRoute: () => LayoutRoute, + } as any) +const _layoutQuxRoute = _layoutQuxRouteImport.update({ + id: '/_qux', + path: '/_qux', + getParentRoute: () => _layoutRoute, +} as any) +const LayoutNestedTrailingIndexRoute = + LayoutNestedTrailingIndexRouteImport.update({ + id: '/nested-trailing_/', + path: '/nested-trailing_/', + getParentRoute: () => LayoutRoute, + } as any) +const LayoutNestedIndexIndexRoute = LayoutNestedIndexIndexRouteImport.update({ + id: '/_nested-index/', + path: '/_nested-index/', + getParentRoute: () => LayoutRoute, +} as any) +const LayoutChar91__doubleIndexChar93IndexRoute = + LayoutChar91__doubleIndexChar93IndexRouteImport.update({ + id: '/__double-index/', + path: '/__double-index/', + getParentRoute: () => LayoutRoute, + } as any) +const LayoutNestedBazRoute = LayoutNestedBazRouteImport.update({ + id: '/_baz', + path: '/_baz', + getParentRoute: () => LayoutNestedRoute, +} as any) +const LayoutNestedIndexIdRoute = LayoutNestedIndexIdRouteImport.update({ + id: '/_nested-index/$id', + path: '/_nested-index/$id', + getParentRoute: () => LayoutRoute, +} as any) +const Layout_nested2DeepRoute = Layout_nested2DeepRouteImport.update({ + id: '/_deep', + path: '/_deep', + getParentRoute: () => Layout_nested2Route, +} as any) +const LayoutChar91__doubleIndexChar93IdRoute = + LayoutChar91__doubleIndexChar93IdRouteImport.update({ + id: '/__double-index/$id', + path: '/__double-index/$id', + getParentRoute: () => LayoutRoute, + } as any) +const LayoutNestedDeepIndexIndexRoute = + LayoutNestedDeepIndexIndexRouteImport.update({ + id: '/_deep-index/', + path: '/_deep-index/', + getParentRoute: () => LayoutNestedRoute, + } as any) + +export interface FileRoutesByFullPath { + '/': typeof LayoutNestedRouteWithChildren + '/__literal': typeof Char91__literalChar93Route + '/_foo': typeof FooRoute + '/_qux': typeof _layoutQuxRoute + '/__double': typeof LayoutChar91__doubleChar93Route + '/_bar': typeof LayoutBarRoute + '/__root-index/': typeof Char91__rootIndexChar93IndexRoute + '/_root-index/': typeof RootIndexIndexRoute + '/__double-index/$id': typeof LayoutChar91__doubleIndexChar93IdRoute + '/_deep': typeof Layout_nested2DeepRoute + '/_nested-index/$id': typeof LayoutNestedIndexIdRoute + '/_baz': typeof LayoutNestedBazRoute + '/__double-index/': typeof LayoutChar91__doubleIndexChar93IndexRoute + '/_nested-index/': typeof LayoutNestedIndexIndexRoute + '/nested-trailing_/': typeof LayoutNestedTrailingIndexRoute + '/_deep-index/': typeof LayoutNestedDeepIndexIndexRoute +} +export interface FileRoutesByTo { + '/': typeof LayoutNestedRouteWithChildren + '/__literal': typeof Char91__literalChar93Route + '/_foo': typeof FooRoute + '/_qux': typeof _layoutQuxRoute + '/__double': typeof LayoutChar91__doubleChar93Route + '/_bar': typeof LayoutBarRoute + '/__root-index': typeof Char91__rootIndexChar93IndexRoute + '/_root-index': typeof RootIndexIndexRoute + '/__double-index/$id': typeof LayoutChar91__doubleIndexChar93IdRoute + '/_deep': typeof Layout_nested2DeepRoute + '/_nested-index/$id': typeof LayoutNestedIndexIdRoute + '/_baz': typeof LayoutNestedBazRoute + '/__double-index': typeof LayoutChar91__doubleIndexChar93IndexRoute + '/_nested-index': typeof LayoutNestedIndexIndexRoute + '/nested-trailing_': typeof LayoutNestedTrailingIndexRoute + '/_deep-index': typeof LayoutNestedDeepIndexIndexRoute +} +export interface FileRoutesById { + __root__: typeof rootRouteImport + '/__layout': typeof _layoutRouteWithChildren + '/__literal': typeof Char91__literalChar93Route + '/_foo': typeof FooRoute + '/_layout': typeof LayoutRouteWithChildren + '/__layout/_qux': typeof _layoutQuxRoute + '/_layout/__double': typeof LayoutChar91__doubleChar93Route + '/_layout/__nested2': typeof Layout_nested2RouteWithChildren + '/_layout/_bar': typeof LayoutBarRoute + '/_layout/_nested': typeof LayoutNestedRouteWithChildren + '/__root-index/': typeof Char91__rootIndexChar93IndexRoute + '/_root-index/': typeof RootIndexIndexRoute + '/_layout/__double-index/$id': typeof LayoutChar91__doubleIndexChar93IdRoute + '/_layout/__nested2/_deep': typeof Layout_nested2DeepRoute + '/_layout/_nested-index/$id': typeof LayoutNestedIndexIdRoute + '/_layout/_nested/_baz': typeof LayoutNestedBazRoute + '/_layout/__double-index/': typeof LayoutChar91__doubleIndexChar93IndexRoute + '/_layout/_nested-index/': typeof LayoutNestedIndexIndexRoute + '/_layout/nested-trailing_/': typeof LayoutNestedTrailingIndexRoute + '/_layout/_nested/_deep-index/': typeof LayoutNestedDeepIndexIndexRoute +} +export interface FileRouteTypes { + fileRoutesByFullPath: FileRoutesByFullPath + fullPaths: + | '/' + | '/__literal' + | '/_foo' + | '/_qux' + | '/__double' + | '/_bar' + | '/__root-index/' + | '/_root-index/' + | '/__double-index/$id' + | '/_deep' + | '/_nested-index/$id' + | '/_baz' + | '/__double-index/' + | '/_nested-index/' + | '/nested-trailing_/' + | '/_deep-index/' + fileRoutesByTo: FileRoutesByTo + to: + | '/' + | '/__literal' + | '/_foo' + | '/_qux' + | '/__double' + | '/_bar' + | '/__root-index' + | '/_root-index' + | '/__double-index/$id' + | '/_deep' + | '/_nested-index/$id' + | '/_baz' + | '/__double-index' + | '/_nested-index' + | '/nested-trailing_' + | '/_deep-index' + id: + | '__root__' + | '/__layout' + | '/__literal' + | '/_foo' + | '/_layout' + | '/__layout/_qux' + | '/_layout/__double' + | '/_layout/__nested2' + | '/_layout/_bar' + | '/_layout/_nested' + | '/__root-index/' + | '/_root-index/' + | '/_layout/__double-index/$id' + | '/_layout/__nested2/_deep' + | '/_layout/_nested-index/$id' + | '/_layout/_nested/_baz' + | '/_layout/__double-index/' + | '/_layout/_nested-index/' + | '/_layout/nested-trailing_/' + | '/_layout/_nested/_deep-index/' + fileRoutesById: FileRoutesById +} +export interface RootRouteChildren { + _layoutRoute: typeof _layoutRouteWithChildren + Char91__literalChar93Route: typeof Char91__literalChar93Route + FooRoute: typeof FooRoute + LayoutRoute: typeof LayoutRouteWithChildren + Char91__rootIndexChar93IndexRoute: typeof Char91__rootIndexChar93IndexRoute + RootIndexIndexRoute: typeof RootIndexIndexRoute +} + +declare module '@tanstack/react-router' { + interface FileRoutesByPath { + '/__root-index/': { + id: '/__root-index/' + path: '/__root-index' + fullPath: '/__root-index/' + preLoaderRoute: typeof Char91__rootIndexChar93IndexRouteImport + parentRoute: typeof rootRouteImport + } + '/_layout': { + id: '/_layout' + path: '' + fullPath: '/' + preLoaderRoute: typeof LayoutRouteImport + parentRoute: typeof rootRouteImport + } + '/_foo': { + id: '/_foo' + path: '/_foo' + fullPath: '/_foo' + preLoaderRoute: typeof FooRouteImport + parentRoute: typeof rootRouteImport + } + '/__literal': { + id: '/__literal' + path: '/__literal' + fullPath: '/__literal' + preLoaderRoute: typeof Char91__literalChar93RouteImport + parentRoute: typeof rootRouteImport + } + '/__layout': { + id: '/__layout' + path: '' + fullPath: '/' + preLoaderRoute: typeof _layoutRouteImport + parentRoute: typeof rootRouteImport + } + '/_root-index/': { + id: '/_root-index/' + path: '/_root-index' + fullPath: '/_root-index/' + preLoaderRoute: typeof RootIndexIndexRouteImport + parentRoute: typeof rootRouteImport + } + '/_layout/_nested': { + id: '/_layout/_nested' + path: '' + fullPath: '/' + preLoaderRoute: typeof LayoutNestedRouteImport + parentRoute: typeof LayoutRoute + } + '/_layout/_bar': { + id: '/_layout/_bar' + path: '/_bar' + fullPath: '/_bar' + preLoaderRoute: typeof LayoutBarRouteImport + parentRoute: typeof LayoutRoute + } + '/_layout/__nested2': { + id: '/_layout/__nested2' + path: '' + fullPath: '/' + preLoaderRoute: typeof Layout_nested2RouteImport + parentRoute: typeof LayoutRoute + } + '/_layout/__double': { + id: '/_layout/__double' + path: '/__double' + fullPath: '/__double' + preLoaderRoute: typeof LayoutChar91__doubleChar93RouteImport + parentRoute: typeof LayoutRoute + } + '/__layout/_qux': { + id: '/__layout/_qux' + path: '/_qux' + fullPath: '/_qux' + preLoaderRoute: typeof _layoutQuxRouteImport + parentRoute: typeof _layoutRoute + } + '/_layout/nested-trailing_/': { + id: '/_layout/nested-trailing_/' + path: '/nested-trailing_' + fullPath: '/nested-trailing_/' + preLoaderRoute: typeof LayoutNestedTrailingIndexRouteImport + parentRoute: typeof LayoutRoute + } + '/_layout/_nested-index/': { + id: '/_layout/_nested-index/' + path: '/_nested-index' + fullPath: '/_nested-index/' + preLoaderRoute: typeof LayoutNestedIndexIndexRouteImport + parentRoute: typeof LayoutRoute + } + '/_layout/__double-index/': { + id: '/_layout/__double-index/' + path: '/__double-index' + fullPath: '/__double-index/' + preLoaderRoute: typeof LayoutChar91__doubleIndexChar93IndexRouteImport + parentRoute: typeof LayoutRoute + } + '/_layout/_nested/_baz': { + id: '/_layout/_nested/_baz' + path: '/_baz' + fullPath: '/_baz' + preLoaderRoute: typeof LayoutNestedBazRouteImport + parentRoute: typeof LayoutNestedRoute + } + '/_layout/_nested-index/$id': { + id: '/_layout/_nested-index/$id' + path: '/_nested-index/$id' + fullPath: '/_nested-index/$id' + preLoaderRoute: typeof LayoutNestedIndexIdRouteImport + parentRoute: typeof LayoutRoute + } + '/_layout/__nested2/_deep': { + id: '/_layout/__nested2/_deep' + path: '/_deep' + fullPath: '/_deep' + preLoaderRoute: typeof Layout_nested2DeepRouteImport + parentRoute: typeof Layout_nested2Route + } + '/_layout/__double-index/$id': { + id: '/_layout/__double-index/$id' + path: '/__double-index/$id' + fullPath: '/__double-index/$id' + preLoaderRoute: typeof LayoutChar91__doubleIndexChar93IdRouteImport + parentRoute: typeof LayoutRoute + } + '/_layout/_nested/_deep-index/': { + id: '/_layout/_nested/_deep-index/' + path: '/_deep-index' + fullPath: '/_deep-index/' + preLoaderRoute: typeof LayoutNestedDeepIndexIndexRouteImport + parentRoute: typeof LayoutNestedRoute + } + } +} + +interface _layoutRouteChildren { + _layoutQuxRoute: typeof _layoutQuxRoute +} + +const _layoutRouteChildren: _layoutRouteChildren = { + _layoutQuxRoute: _layoutQuxRoute, +} + +const _layoutRouteWithChildren = + _layoutRoute._addFileChildren(_layoutRouteChildren) + +interface Layout_nested2RouteChildren { + Layout_nested2DeepRoute: typeof Layout_nested2DeepRoute +} + +const Layout_nested2RouteChildren: Layout_nested2RouteChildren = { + Layout_nested2DeepRoute: Layout_nested2DeepRoute, +} + +const Layout_nested2RouteWithChildren = Layout_nested2Route._addFileChildren( + Layout_nested2RouteChildren, +) + +interface LayoutNestedRouteChildren { + LayoutNestedBazRoute: typeof LayoutNestedBazRoute + LayoutNestedDeepIndexIndexRoute: typeof LayoutNestedDeepIndexIndexRoute +} + +const LayoutNestedRouteChildren: LayoutNestedRouteChildren = { + LayoutNestedBazRoute: LayoutNestedBazRoute, + LayoutNestedDeepIndexIndexRoute: LayoutNestedDeepIndexIndexRoute, +} + +const LayoutNestedRouteWithChildren = LayoutNestedRoute._addFileChildren( + LayoutNestedRouteChildren, +) + +interface LayoutRouteChildren { + LayoutChar91__doubleChar93Route: typeof LayoutChar91__doubleChar93Route + Layout_nested2Route: typeof Layout_nested2RouteWithChildren + LayoutBarRoute: typeof LayoutBarRoute + LayoutNestedRoute: typeof LayoutNestedRouteWithChildren + LayoutChar91__doubleIndexChar93IdRoute: typeof LayoutChar91__doubleIndexChar93IdRoute + LayoutNestedIndexIdRoute: typeof LayoutNestedIndexIdRoute + LayoutChar91__doubleIndexChar93IndexRoute: typeof LayoutChar91__doubleIndexChar93IndexRoute + LayoutNestedIndexIndexRoute: typeof LayoutNestedIndexIndexRoute + LayoutNestedTrailingIndexRoute: typeof LayoutNestedTrailingIndexRoute +} + +const LayoutRouteChildren: LayoutRouteChildren = { + LayoutChar91__doubleChar93Route: LayoutChar91__doubleChar93Route, + Layout_nested2Route: Layout_nested2RouteWithChildren, + LayoutBarRoute: LayoutBarRoute, + LayoutNestedRoute: LayoutNestedRouteWithChildren, + LayoutChar91__doubleIndexChar93IdRoute: + LayoutChar91__doubleIndexChar93IdRoute, + LayoutNestedIndexIdRoute: LayoutNestedIndexIdRoute, + LayoutChar91__doubleIndexChar93IndexRoute: + LayoutChar91__doubleIndexChar93IndexRoute, + LayoutNestedIndexIndexRoute: LayoutNestedIndexIndexRoute, + LayoutNestedTrailingIndexRoute: LayoutNestedTrailingIndexRoute, +} + +const LayoutRouteWithChildren = + LayoutRoute._addFileChildren(LayoutRouteChildren) + +const rootRouteChildren: RootRouteChildren = { + _layoutRoute: _layoutRouteWithChildren, + Char91__literalChar93Route: Char91__literalChar93Route, + FooRoute: FooRoute, + LayoutRoute: LayoutRouteWithChildren, + Char91__rootIndexChar93IndexRoute: Char91__rootIndexChar93IndexRoute, + RootIndexIndexRoute: RootIndexIndexRoute, +} +export const routeTree = rootRouteImport + ._addFileChildren(rootRouteChildren) + ._addFileTypes<FileRouteTypes>() diff --git a/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/[_]foo.tsx b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/[_]foo.tsx new file mode 100644 index 0000000000..e081df4ce5 --- /dev/null +++ b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/[_]foo.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_foo')({ + component: () => 'Foo', +}) diff --git a/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/[_]root-index/index.tsx b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/[_]root-index/index.tsx new file mode 100644 index 0000000000..39387c7250 --- /dev/null +++ b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/[_]root-index/index.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_root-index/')({ + component: () => 'Root Index', +}) diff --git a/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/[__literal].tsx b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/[__literal].tsx new file mode 100644 index 0000000000..3e2dece810 --- /dev/null +++ b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/[__literal].tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/__literal')({ + component: () => 'Literal Double Underscore', +}) diff --git a/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/[__root-index]/index.tsx b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/[__root-index]/index.tsx new file mode 100644 index 0000000000..9945c7d300 --- /dev/null +++ b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/[__root-index]/index.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/__root-index/')({ + component: () => 'Double Root Index', +}) diff --git a/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/__layout.tsx b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/__layout.tsx new file mode 100644 index 0000000000..82f96a7448 --- /dev/null +++ b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/__layout.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/__layout')({ + component: () => 'Double Underscore Layout', +}) diff --git a/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/__layout/[_]qux.tsx b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/__layout/[_]qux.tsx new file mode 100644 index 0000000000..a75019e05a --- /dev/null +++ b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/__layout/[_]qux.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/__layout/_qux')({ + component: () => 'Qux', +}) diff --git a/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/__root.tsx b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/__root.tsx new file mode 100644 index 0000000000..9c657c7d5b --- /dev/null +++ b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/__root.tsx @@ -0,0 +1,3 @@ +import { createRootRoute } from '@tanstack/react-router' + +export const Route = createRootRoute() diff --git a/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout.tsx b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout.tsx new file mode 100644 index 0000000000..9c1673dafd --- /dev/null +++ b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout')({ + component: () => 'Layout', +}) diff --git a/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/[_]bar.tsx b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/[_]bar.tsx new file mode 100644 index 0000000000..c1c8b28c28 --- /dev/null +++ b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/[_]bar.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/_bar')({ + component: () => 'Bar', +}) diff --git a/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/[_]nested-index/$id.tsx b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/[_]nested-index/$id.tsx new file mode 100644 index 0000000000..e09396020b --- /dev/null +++ b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/[_]nested-index/$id.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/_nested-index/$id')({ + component: () => 'Nested Id', +}) diff --git a/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/[_]nested-index/index.tsx b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/[_]nested-index/index.tsx new file mode 100644 index 0000000000..a5f8f95497 --- /dev/null +++ b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/[_]nested-index/index.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/_nested-index/')({ + component: () => 'Nested Index', +}) diff --git a/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/[__double-index]/$id.tsx b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/[__double-index]/$id.tsx new file mode 100644 index 0000000000..2a31adf60c --- /dev/null +++ b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/[__double-index]/$id.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/__double-index/$id')({ + component: () => 'Double Id', +}) diff --git a/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/[__double-index]/index.tsx b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/[__double-index]/index.tsx new file mode 100644 index 0000000000..231e787df0 --- /dev/null +++ b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/[__double-index]/index.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/__double-index/')({ + component: () => 'Double Index', +}) diff --git a/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/[__double].tsx b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/[__double].tsx new file mode 100644 index 0000000000..2cb4336d37 --- /dev/null +++ b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/[__double].tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/__double')({ + component: () => 'Double Escaped', +}) diff --git a/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/__nested2.tsx b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/__nested2.tsx new file mode 100644 index 0000000000..802b1fc765 --- /dev/null +++ b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/__nested2.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/__nested2')({ + component: () => 'Nested Double Underscore Layout', +}) diff --git a/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/__nested2/[_]deep.tsx b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/__nested2/[_]deep.tsx new file mode 100644 index 0000000000..e36965ef42 --- /dev/null +++ b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/__nested2/[_]deep.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/__nested2/_deep')({ + component: () => 'Deep', +}) diff --git a/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/_nested.tsx b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/_nested.tsx new file mode 100644 index 0000000000..b2985c3c2e --- /dev/null +++ b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/_nested.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/_nested')({ + component: () => 'Nested Layout', +}) diff --git a/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/_nested/[_]baz.tsx b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/_nested/[_]baz.tsx new file mode 100644 index 0000000000..9bec9e82d4 --- /dev/null +++ b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/_nested/[_]baz.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/_nested/_baz')({ + component: () => 'Baz', +}) diff --git a/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/_nested/[_]deep-index/index.tsx b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/_nested/[_]deep-index/index.tsx new file mode 100644 index 0000000000..4113450ea1 --- /dev/null +++ b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/_nested/[_]deep-index/index.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/_nested/_deep-index/')({ + component: () => 'Deep Index', +}) diff --git a/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/nested-trailing[_]/index.tsx b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/nested-trailing[_]/index.tsx new file mode 100644 index 0000000000..786604a503 --- /dev/null +++ b/packages/router-generator/tests/generator/physical-pathless-layout-escaped-underscore/routes/_layout/nested-trailing[_]/index.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/nested-trailing_/')({ + component: () => 'Nested Trailing Index', +}) diff --git a/packages/router-generator/tests/generator/root-export-specifier/routeTree.snapshot.ts b/packages/router-generator/tests/generator/root-export-specifier/routeTree.snapshot.ts new file mode 100644 index 0000000000..59499d9fbf --- /dev/null +++ b/packages/router-generator/tests/generator/root-export-specifier/routeTree.snapshot.ts @@ -0,0 +1,77 @@ +/* eslint-disable */ + +// @ts-nocheck + +// noinspection JSUnusedGlobalSymbols + +// This file was automatically generated by TanStack Router. +// You should NOT make any changes in this file as it will be overwritten. +// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. + +import { Route as rootRouteImport } from './routes/__root' +import { Route as AboutRouteImport } from './routes/about' +import { Route as IndexRouteImport } from './routes/index' + +const AboutRoute = AboutRouteImport.update({ + id: '/about', + path: '/about', + getParentRoute: () => rootRouteImport, +} as any) +const IndexRoute = IndexRouteImport.update({ + id: '/', + path: '/', + getParentRoute: () => rootRouteImport, +} as any) + +export interface FileRoutesByFullPath { + '/': typeof IndexRoute + '/about': typeof AboutRoute +} +export interface FileRoutesByTo { + '/': typeof IndexRoute + '/about': typeof AboutRoute +} +export interface FileRoutesById { + __root__: typeof rootRouteImport + '/': typeof IndexRoute + '/about': typeof AboutRoute +} +export interface FileRouteTypes { + fileRoutesByFullPath: FileRoutesByFullPath + fullPaths: '/' | '/about' + fileRoutesByTo: FileRoutesByTo + to: '/' | '/about' + id: '__root__' | '/' | '/about' + fileRoutesById: FileRoutesById +} +export interface RootRouteChildren { + IndexRoute: typeof IndexRoute + AboutRoute: typeof AboutRoute +} + +declare module '@tanstack/react-router' { + interface FileRoutesByPath { + '/about': { + id: '/about' + path: '/about' + fullPath: '/about' + preLoaderRoute: typeof AboutRouteImport + parentRoute: typeof rootRouteImport + } + '/': { + id: '/' + path: '/' + fullPath: '/' + preLoaderRoute: typeof IndexRouteImport + parentRoute: typeof rootRouteImport + } + } +} + +const rootRouteChildren: RootRouteChildren = { + IndexRoute: IndexRoute, + AboutRoute: AboutRoute, +} +export const routeTree = rootRouteImport + ._addFileChildren(rootRouteChildren) + ._addFileTypes<FileRouteTypes>() diff --git a/packages/router-generator/tests/generator/root-export-specifier/routes/__root.tsx b/packages/router-generator/tests/generator/root-export-specifier/routes/__root.tsx new file mode 100644 index 0000000000..6fb0358524 --- /dev/null +++ b/packages/router-generator/tests/generator/root-export-specifier/routes/__root.tsx @@ -0,0 +1,11 @@ +import { createRootRoute } from '@tanstack/react-router' + +const Route = createRootRoute({ + component: RootComponent, +}) + +export { Route } + +function RootComponent() { + return null +} diff --git a/packages/router-generator/tests/generator/root-export-specifier/routes/about.tsx b/packages/router-generator/tests/generator/root-export-specifier/routes/about.tsx new file mode 100644 index 0000000000..2ee06f6d0f --- /dev/null +++ b/packages/router-generator/tests/generator/root-export-specifier/routes/about.tsx @@ -0,0 +1,3 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/about')() diff --git a/packages/router-generator/tests/generator/root-export-specifier/routes/index.tsx b/packages/router-generator/tests/generator/root-export-specifier/routes/index.tsx new file mode 100644 index 0000000000..fbf3caabfb --- /dev/null +++ b/packages/router-generator/tests/generator/root-export-specifier/routes/index.tsx @@ -0,0 +1,3 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/')() diff --git a/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/aliased/virtual-routes.ts b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/aliased/virtual-routes.ts new file mode 100644 index 0000000000..ed71a051e8 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/aliased/virtual-routes.ts @@ -0,0 +1,3 @@ +import { physical } from '@tanstack/virtual-file-routes' + +export const helloSubtree = physical('/hello', 'subtree') diff --git a/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routeTree.snapshot.ts b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routeTree.snapshot.ts new file mode 100644 index 0000000000..3d3c2de9d5 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routeTree.snapshot.ts @@ -0,0 +1,292 @@ +/* eslint-disable */ + +// @ts-nocheck + +// noinspection JSUnusedGlobalSymbols + +// This file was automatically generated by TanStack Router. +// You should NOT make any changes in this file as it will be overwritten. +// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. + +import { Route as rootRouteImport } from './routes/root' +import { Route as layoutRouteImport } from './routes/layout' +import { Route as indexRouteImport } from './routes/index' +import { Route as dbDashboardRouteImport } from './routes/db/dashboard' +import { Route as pagesRouteImport } from './routes/pages' +import { Route as HelloIndexRouteImport } from './routes/subtree/index' +import { Route as dbDashboardInvoicesRouteImport } from './routes/db/dashboard-invoices' +import { Route as dbDashboardIndexRouteImport } from './routes/db/dashboard-index' +import { Route as HelloFooIndexRouteImport } from './routes/subtree/foo/index' +import { Route as HelloFooIdRouteImport } from './routes/subtree/foo/$id' +import { Route as dbInvoiceDetailRouteImport } from './routes/db/invoice-detail' +import { Route as dbInvoicesIndexRouteImport } from './routes/db/invoices-index' + +const layoutRoute = layoutRouteImport.update({ + id: '/_layout', + getParentRoute: () => rootRouteImport, +} as any) +const indexRoute = indexRouteImport.update({ + id: '/', + path: '/', + getParentRoute: () => rootRouteImport, +} as any) +const dbDashboardRoute = dbDashboardRouteImport.update({ + id: '/dashboard', + path: '/dashboard', + getParentRoute: () => layoutRoute, +} as any) +const pagesRoute = pagesRouteImport.update({ + id: '/$lang/', + path: '/$lang/', + getParentRoute: () => rootRouteImport, +} as any) +const HelloIndexRoute = HelloIndexRouteImport.update({ + id: '/hello/', + path: '/hello/', + getParentRoute: () => layoutRoute, +} as any) +const dbDashboardInvoicesRoute = dbDashboardInvoicesRouteImport.update({ + id: '/invoices', + path: '/invoices', + getParentRoute: () => dbDashboardRoute, +} as any) +const dbDashboardIndexRoute = dbDashboardIndexRouteImport.update({ + id: '/', + path: '/', + getParentRoute: () => dbDashboardRoute, +} as any) +const HelloFooIndexRoute = HelloFooIndexRouteImport.update({ + id: '/hello/foo/', + path: '/hello/foo/', + getParentRoute: () => layoutRoute, +} as any) +const HelloFooIdRoute = HelloFooIdRouteImport.update({ + id: '/hello/foo/$id', + path: '/hello/foo/$id', + getParentRoute: () => layoutRoute, +} as any) +const dbInvoiceDetailRoute = dbInvoiceDetailRouteImport.update({ + id: '/$id', + path: '/$id', + getParentRoute: () => dbDashboardInvoicesRoute, +} as any) +const dbInvoicesIndexRoute = dbInvoicesIndexRouteImport.update({ + id: '/', + path: '/', + getParentRoute: () => dbDashboardInvoicesRoute, +} as any) + +export interface FileRoutesByFullPath { + '/': typeof indexRoute + '/$lang/': typeof pagesRoute + '/dashboard': typeof dbDashboardRouteWithChildren + '/dashboard/': typeof dbDashboardIndexRoute + '/dashboard/invoices': typeof dbDashboardInvoicesRouteWithChildren + '/hello/': typeof HelloIndexRoute + '/dashboard/invoices/': typeof dbInvoicesIndexRoute + '/dashboard/invoices/$id': typeof dbInvoiceDetailRoute + '/hello/foo/$id': typeof HelloFooIdRoute + '/hello/foo/': typeof HelloFooIndexRoute +} +export interface FileRoutesByTo { + '/': typeof indexRoute + '/$lang': typeof pagesRoute + '/dashboard': typeof dbDashboardIndexRoute + '/hello': typeof HelloIndexRoute + '/dashboard/invoices': typeof dbInvoicesIndexRoute + '/dashboard/invoices/$id': typeof dbInvoiceDetailRoute + '/hello/foo/$id': typeof HelloFooIdRoute + '/hello/foo': typeof HelloFooIndexRoute +} +export interface FileRoutesById { + __root__: typeof rootRouteImport + '/': typeof indexRoute + '/_layout': typeof layoutRouteWithChildren + '/$lang/': typeof pagesRoute + '/_layout/dashboard': typeof dbDashboardRouteWithChildren + '/_layout/dashboard/': typeof dbDashboardIndexRoute + '/_layout/dashboard/invoices': typeof dbDashboardInvoicesRouteWithChildren + '/_layout/hello/': typeof HelloIndexRoute + '/_layout/dashboard/invoices/': typeof dbInvoicesIndexRoute + '/_layout/dashboard/invoices/$id': typeof dbInvoiceDetailRoute + '/_layout/hello/foo/$id': typeof HelloFooIdRoute + '/_layout/hello/foo/': typeof HelloFooIndexRoute +} +export interface FileRouteTypes { + fileRoutesByFullPath: FileRoutesByFullPath + fullPaths: + | '/' + | '/$lang/' + | '/dashboard' + | '/dashboard/' + | '/dashboard/invoices' + | '/hello/' + | '/dashboard/invoices/' + | '/dashboard/invoices/$id' + | '/hello/foo/$id' + | '/hello/foo/' + fileRoutesByTo: FileRoutesByTo + to: + | '/' + | '/$lang' + | '/dashboard' + | '/hello' + | '/dashboard/invoices' + | '/dashboard/invoices/$id' + | '/hello/foo/$id' + | '/hello/foo' + id: + | '__root__' + | '/' + | '/_layout' + | '/$lang/' + | '/_layout/dashboard' + | '/_layout/dashboard/' + | '/_layout/dashboard/invoices' + | '/_layout/hello/' + | '/_layout/dashboard/invoices/' + | '/_layout/dashboard/invoices/$id' + | '/_layout/hello/foo/$id' + | '/_layout/hello/foo/' + fileRoutesById: FileRoutesById +} +export interface RootRouteChildren { + indexRoute: typeof indexRoute + layoutRoute: typeof layoutRouteWithChildren + pagesRoute: typeof pagesRoute +} + +declare module '@tanstack/react-router' { + interface FileRoutesByPath { + '/_layout': { + id: '/_layout' + path: '' + fullPath: '/' + preLoaderRoute: typeof layoutRouteImport + parentRoute: typeof rootRouteImport + } + '/': { + id: '/' + path: '/' + fullPath: '/' + preLoaderRoute: typeof indexRouteImport + parentRoute: typeof rootRouteImport + } + '/_layout/dashboard': { + id: '/_layout/dashboard' + path: '/dashboard' + fullPath: '/dashboard' + preLoaderRoute: typeof dbDashboardRouteImport + parentRoute: typeof layoutRoute + } + '/$lang/': { + id: '/$lang/' + path: '/$lang' + fullPath: '/$lang/' + preLoaderRoute: typeof pagesRouteImport + parentRoute: typeof rootRouteImport + } + '/_layout/hello/': { + id: '/_layout/hello/' + path: '/hello' + fullPath: '/hello/' + preLoaderRoute: typeof HelloIndexRouteImport + parentRoute: typeof layoutRoute + } + '/_layout/dashboard/invoices': { + id: '/_layout/dashboard/invoices' + path: '/invoices' + fullPath: '/dashboard/invoices' + preLoaderRoute: typeof dbDashboardInvoicesRouteImport + parentRoute: typeof dbDashboardRoute + } + '/_layout/dashboard/': { + id: '/_layout/dashboard/' + path: '/' + fullPath: '/dashboard/' + preLoaderRoute: typeof dbDashboardIndexRouteImport + parentRoute: typeof dbDashboardRoute + } + '/_layout/hello/foo/': { + id: '/_layout/hello/foo/' + path: '/hello/foo' + fullPath: '/hello/foo/' + preLoaderRoute: typeof HelloFooIndexRouteImport + parentRoute: typeof layoutRoute + } + '/_layout/hello/foo/$id': { + id: '/_layout/hello/foo/$id' + path: '/hello/foo/$id' + fullPath: '/hello/foo/$id' + preLoaderRoute: typeof HelloFooIdRouteImport + parentRoute: typeof layoutRoute + } + '/_layout/dashboard/invoices/$id': { + id: '/_layout/dashboard/invoices/$id' + path: '/$id' + fullPath: '/dashboard/invoices/$id' + preLoaderRoute: typeof dbInvoiceDetailRouteImport + parentRoute: typeof dbDashboardInvoicesRoute + } + '/_layout/dashboard/invoices/': { + id: '/_layout/dashboard/invoices/' + path: '/' + fullPath: '/dashboard/invoices/' + preLoaderRoute: typeof dbInvoicesIndexRouteImport + parentRoute: typeof dbDashboardInvoicesRoute + } + } +} + +interface dbDashboardInvoicesRouteChildren { + dbInvoicesIndexRoute: typeof dbInvoicesIndexRoute + dbInvoiceDetailRoute: typeof dbInvoiceDetailRoute +} + +const dbDashboardInvoicesRouteChildren: dbDashboardInvoicesRouteChildren = { + dbInvoicesIndexRoute: dbInvoicesIndexRoute, + dbInvoiceDetailRoute: dbInvoiceDetailRoute, +} + +const dbDashboardInvoicesRouteWithChildren = + dbDashboardInvoicesRoute._addFileChildren(dbDashboardInvoicesRouteChildren) + +interface dbDashboardRouteChildren { + dbDashboardIndexRoute: typeof dbDashboardIndexRoute + dbDashboardInvoicesRoute: typeof dbDashboardInvoicesRouteWithChildren +} + +const dbDashboardRouteChildren: dbDashboardRouteChildren = { + dbDashboardIndexRoute: dbDashboardIndexRoute, + dbDashboardInvoicesRoute: dbDashboardInvoicesRouteWithChildren, +} + +const dbDashboardRouteWithChildren = dbDashboardRoute._addFileChildren( + dbDashboardRouteChildren, +) + +interface layoutRouteChildren { + dbDashboardRoute: typeof dbDashboardRouteWithChildren + HelloIndexRoute: typeof HelloIndexRoute + HelloFooIdRoute: typeof HelloFooIdRoute + HelloFooIndexRoute: typeof HelloFooIndexRoute +} + +const layoutRouteChildren: layoutRouteChildren = { + dbDashboardRoute: dbDashboardRouteWithChildren, + HelloIndexRoute: HelloIndexRoute, + HelloFooIdRoute: HelloFooIdRoute, + HelloFooIndexRoute: HelloFooIndexRoute, +} + +const layoutRouteWithChildren = + layoutRoute._addFileChildren(layoutRouteChildren) + +const rootRouteChildren: RootRouteChildren = { + indexRoute: indexRoute, + layoutRoute: layoutRouteWithChildren, + pagesRoute: pagesRoute, +} +export const routeTree = rootRouteImport + ._addFileChildren(rootRouteChildren) + ._addFileTypes<FileRouteTypes>() diff --git a/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes.ts b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes.ts new file mode 100644 index 0000000000..149e6ae4c1 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes.ts @@ -0,0 +1,19 @@ +// @ts-nocheck + +import { index, layout, rootRoute, route } from '@tanstack/virtual-file-routes' +import { helloSubtree } from '@/virtual-routes' + +export default rootRoute('root.tsx', [ + index('index.tsx'), + route('$lang', [index('pages.tsx')]), + layout('layout.tsx', [ + route('/dashboard', 'db/dashboard.tsx', [ + index('db/dashboard-index.tsx'), + route('/invoices', 'db/dashboard-invoices.tsx', [ + index('db/invoices-index.tsx'), + route('$id', 'db/invoice-detail.tsx'), + ]), + ]), + helloSubtree, + ]), +]) diff --git a/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/db/dashboard-index.tsx b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/db/dashboard-index.tsx new file mode 100644 index 0000000000..ecd8cce943 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/db/dashboard-index.tsx @@ -0,0 +1,4 @@ +import { createFileRoute } from '@tanstack/react-router' +export const Route = createFileRoute('/_layout/dashboard/')({ + component: () => <div>Hello !</div>, +}) diff --git a/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/db/dashboard-invoices.tsx b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/db/dashboard-invoices.tsx new file mode 100644 index 0000000000..0997d6d9f5 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/db/dashboard-invoices.tsx @@ -0,0 +1,4 @@ +import { createFileRoute } from '@tanstack/react-router' +export const Route = createFileRoute('/_layout/dashboard/invoices')({ + component: () => <div>Hello !</div>, +}) diff --git a/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/db/dashboard.tsx b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/db/dashboard.tsx new file mode 100644 index 0000000000..5963d884c6 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/db/dashboard.tsx @@ -0,0 +1,4 @@ +import { createFileRoute } from '@tanstack/react-router' +export const Route = createFileRoute('/_layout/dashboard')({ + component: () => <div>Hello !</div>, +}) diff --git a/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/db/invoice-detail.tsx b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/db/invoice-detail.tsx new file mode 100644 index 0000000000..5226e399a4 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/db/invoice-detail.tsx @@ -0,0 +1,4 @@ +import { createFileRoute } from '@tanstack/react-router' +export const Route = createFileRoute('/_layout/dashboard/invoices/$id')({ + component: () => <div>Hello /_layout/dashboard/invoices/$id!</div>, +}) diff --git a/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/db/invoices-index.tsx b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/db/invoices-index.tsx new file mode 100644 index 0000000000..c2024685a8 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/db/invoices-index.tsx @@ -0,0 +1,4 @@ +import { createFileRoute } from '@tanstack/react-router' +export const Route = createFileRoute('/_layout/dashboard/invoices/')({ + component: () => <div>Hello /_layout/dashboard/invoices/!</div>, +}) diff --git a/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/index.tsx b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/index.tsx new file mode 100644 index 0000000000..2f80221276 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/index.tsx @@ -0,0 +1,4 @@ +import { createFileRoute } from '@tanstack/react-router' +export const Route = createFileRoute('/')({ + component: () => <div>Hello !</div>, +}) diff --git a/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/layout.tsx b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/layout.tsx new file mode 100644 index 0000000000..268d6c5c7d --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/layout.tsx @@ -0,0 +1,4 @@ +import { createFileRoute } from '@tanstack/react-router' +export const Route = createFileRoute('/_layout')({ + component: () => <div>Hello !</div>, +}) diff --git a/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/pages.tsx b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/pages.tsx new file mode 100644 index 0000000000..5e4d543b3e --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/pages.tsx @@ -0,0 +1,10 @@ +import { createFileRoute } from '@tanstack/react-router' +import * as React from 'react' + +export const Route = createFileRoute('/$lang/')({ + component: RouteComponent, +}) + +function RouteComponent() { + return <div>Hello "/$lang/"!</div> +} diff --git a/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/root.tsx b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/root.tsx new file mode 100644 index 0000000000..a294139860 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/root.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/')({ + component: () => <div>Hello !</div>, +}) diff --git a/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/subtree/foo/$id.tsx b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/subtree/foo/$id.tsx new file mode 100644 index 0000000000..62bf75cc7f --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/subtree/foo/$id.tsx @@ -0,0 +1,4 @@ +import { createFileRoute } from '@tanstack/react-router' +export const Route = createFileRoute('/_layout/hello/foo/$id')({ + component: () => <div>Hello /foo/$id!</div>, +}) diff --git a/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/subtree/foo/index.tsx b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/subtree/foo/index.tsx new file mode 100644 index 0000000000..b2355f12fd --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/subtree/foo/index.tsx @@ -0,0 +1,4 @@ +import { createFileRoute } from '@tanstack/react-router' +export const Route = createFileRoute('/_layout/hello/foo/')({ + component: () => <div>Hello /foo/!</div>, +}) diff --git a/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/subtree/index.tsx b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/subtree/index.tsx new file mode 100644 index 0000000000..c85f0fb295 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/routes/subtree/index.tsx @@ -0,0 +1,4 @@ +import { createFileRoute } from '@tanstack/react-router' +export const Route = createFileRoute('/_layout/hello/')({ + component: () => <div>Hello /!</div>, +}) diff --git a/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/tsconfig.json b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/tsconfig.json new file mode 100644 index 0000000000..7426947cc5 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/tsconfig.json @@ -0,0 +1,7 @@ +{ + "compilerOptions": { + "paths": { + "@/*": ["./aliased/*"] + } + } +} diff --git a/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/tsr.config.json b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/tsr.config.json new file mode 100644 index 0000000000..4d587108e3 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-config-file-tsconfig-paths/tsr.config.json @@ -0,0 +1,5 @@ +{ + "routesDirectory": "./routes", + "generatedRouteTree": "./routeTree.gen.ts", + "virtualRouteConfig": "./routes.ts" +} diff --git a/packages/router-generator/tests/generator/virtual-inside-nested/routeTree.snapshot.ts b/packages/router-generator/tests/generator/virtual-inside-nested/routeTree.snapshot.ts index 174f18465b..9f60b82e06 100644 --- a/packages/router-generator/tests/generator/virtual-inside-nested/routeTree.snapshot.ts +++ b/packages/router-generator/tests/generator/virtual-inside-nested/routeTree.snapshot.ts @@ -11,8 +11,8 @@ import { Route as rootRouteImport } from './routes/__root' import { Route as IndexRouteImport } from './routes/index' import { Route as FooBarRouteImport } from './routes/foo/bar' -import { Route as fooBarDetailsRouteImport } from './routes/foo/bar/details' -import { Route as fooBarHomeRouteImport } from './routes/foo/bar/home' +import { Route as FooBarDetailsRouteImport } from './routes/foo/bar/details' +import { Route as FooBarHomeRouteImport } from './routes/foo/bar/home' const IndexRoute = IndexRouteImport.update({ id: '/', @@ -24,12 +24,12 @@ const FooBarRoute = FooBarRouteImport.update({ path: '/foo/bar', getParentRoute: () => rootRouteImport, } as any) -const fooBarDetailsRoute = fooBarDetailsRouteImport.update({ +const FooBarDetailsRoute = FooBarDetailsRouteImport.update({ id: '/$id', path: '/$id', getParentRoute: () => FooBarRoute, } as any) -const fooBarHomeRoute = fooBarHomeRouteImport.update({ +const FooBarHomeRoute = FooBarHomeRouteImport.update({ id: '/', path: '/', getParentRoute: () => FooBarRoute, @@ -38,20 +38,20 @@ const fooBarHomeRoute = fooBarHomeRouteImport.update({ export interface FileRoutesByFullPath { '/': typeof IndexRoute '/foo/bar': typeof FooBarRouteWithChildren - '/foo/bar/': typeof fooBarHomeRoute - '/foo/bar/$id': typeof fooBarDetailsRoute + '/foo/bar/': typeof FooBarHomeRoute + '/foo/bar/$id': typeof FooBarDetailsRoute } export interface FileRoutesByTo { '/': typeof IndexRoute - '/foo/bar': typeof fooBarHomeRoute - '/foo/bar/$id': typeof fooBarDetailsRoute + '/foo/bar': typeof FooBarHomeRoute + '/foo/bar/$id': typeof FooBarDetailsRoute } export interface FileRoutesById { __root__: typeof rootRouteImport '/': typeof IndexRoute '/foo/bar': typeof FooBarRouteWithChildren - '/foo/bar/': typeof fooBarHomeRoute - '/foo/bar/$id': typeof fooBarDetailsRoute + '/foo/bar/': typeof FooBarHomeRoute + '/foo/bar/$id': typeof FooBarDetailsRoute } export interface FileRouteTypes { fileRoutesByFullPath: FileRoutesByFullPath @@ -86,27 +86,27 @@ declare module '@tanstack/react-router' { id: '/foo/bar/$id' path: '/$id' fullPath: '/foo/bar/$id' - preLoaderRoute: typeof fooBarDetailsRouteImport + preLoaderRoute: typeof FooBarDetailsRouteImport parentRoute: typeof FooBarRoute } '/foo/bar/': { id: '/foo/bar/' path: '/' fullPath: '/foo/bar/' - preLoaderRoute: typeof fooBarHomeRouteImport + preLoaderRoute: typeof FooBarHomeRouteImport parentRoute: typeof FooBarRoute } } } interface FooBarRouteChildren { - fooBarHomeRoute: typeof fooBarHomeRoute - fooBarDetailsRoute: typeof fooBarDetailsRoute + FooBarHomeRoute: typeof FooBarHomeRoute + FooBarDetailsRoute: typeof FooBarDetailsRoute } const FooBarRouteChildren: FooBarRouteChildren = { - fooBarHomeRoute: fooBarHomeRoute, - fooBarDetailsRoute: fooBarDetailsRoute, + FooBarHomeRoute: FooBarHomeRoute, + FooBarDetailsRoute: FooBarDetailsRoute, } const FooBarRouteWithChildren = diff --git a/packages/router-generator/tests/generator/virtual-inside-with-escaped-underscore/routeTree.snapshot.ts b/packages/router-generator/tests/generator/virtual-inside-with-escaped-underscore/routeTree.snapshot.ts index 28aebc0aad..664cea729c 100644 --- a/packages/router-generator/tests/generator/virtual-inside-with-escaped-underscore/routeTree.snapshot.ts +++ b/packages/router-generator/tests/generator/virtual-inside-with-escaped-underscore/routeTree.snapshot.ts @@ -10,26 +10,26 @@ import { Route as rootRouteImport } from './routes/__root' import { Route as IndexRouteImport } from './routes/index' -import { Route as nestedCallbackRouteImport } from './routes/nested/callback' -import { Route as nestedAuthRouteImport } from './routes/nested/auth' -import { Route as nestedHomeRouteImport } from './routes/nested/home' +import { Route as NestedCallbackRouteImport } from './routes/nested/callback' +import { Route as NestedAuthRouteImport } from './routes/nested/auth' +import { Route as NestedHomeRouteImport } from './routes/nested/home' const IndexRoute = IndexRouteImport.update({ id: '/', path: '/', getParentRoute: () => rootRouteImport, } as any) -const nestedCallbackRoute = nestedCallbackRouteImport.update({ +const NestedCallbackRoute = NestedCallbackRouteImport.update({ id: '/nested/_callback', path: '/nested/_callback', getParentRoute: () => rootRouteImport, } as any) -const nestedAuthRoute = nestedAuthRouteImport.update({ +const NestedAuthRoute = NestedAuthRouteImport.update({ id: '/nested/_auth', path: '/nested/_auth', getParentRoute: () => rootRouteImport, } as any) -const nestedHomeRoute = nestedHomeRouteImport.update({ +const NestedHomeRoute = NestedHomeRouteImport.update({ id: '/nested/', path: '/nested/', getParentRoute: () => rootRouteImport, @@ -37,22 +37,22 @@ const nestedHomeRoute = nestedHomeRouteImport.update({ export interface FileRoutesByFullPath { '/': typeof IndexRoute - '/nested/': typeof nestedHomeRoute - '/nested/_auth': typeof nestedAuthRoute - '/nested/_callback': typeof nestedCallbackRoute + '/nested/': typeof NestedHomeRoute + '/nested/_auth': typeof NestedAuthRoute + '/nested/_callback': typeof NestedCallbackRoute } export interface FileRoutesByTo { '/': typeof IndexRoute - '/nested': typeof nestedHomeRoute - '/nested/_auth': typeof nestedAuthRoute - '/nested/_callback': typeof nestedCallbackRoute + '/nested': typeof NestedHomeRoute + '/nested/_auth': typeof NestedAuthRoute + '/nested/_callback': typeof NestedCallbackRoute } export interface FileRoutesById { __root__: typeof rootRouteImport '/': typeof IndexRoute - '/nested/': typeof nestedHomeRoute - '/nested/_auth': typeof nestedAuthRoute - '/nested/_callback': typeof nestedCallbackRoute + '/nested/': typeof NestedHomeRoute + '/nested/_auth': typeof NestedAuthRoute + '/nested/_callback': typeof NestedCallbackRoute } export interface FileRouteTypes { fileRoutesByFullPath: FileRoutesByFullPath @@ -64,9 +64,9 @@ export interface FileRouteTypes { } export interface RootRouteChildren { IndexRoute: typeof IndexRoute - nestedHomeRoute: typeof nestedHomeRoute - nestedAuthRoute: typeof nestedAuthRoute - nestedCallbackRoute: typeof nestedCallbackRoute + NestedHomeRoute: typeof NestedHomeRoute + NestedAuthRoute: typeof NestedAuthRoute + NestedCallbackRoute: typeof NestedCallbackRoute } declare module '@tanstack/react-router' { @@ -82,21 +82,21 @@ declare module '@tanstack/react-router' { id: '/nested/_callback' path: '/nested/_callback' fullPath: '/nested/_callback' - preLoaderRoute: typeof nestedCallbackRouteImport + preLoaderRoute: typeof NestedCallbackRouteImport parentRoute: typeof rootRouteImport } '/nested/_auth': { id: '/nested/_auth' path: '/nested/_auth' fullPath: '/nested/_auth' - preLoaderRoute: typeof nestedAuthRouteImport + preLoaderRoute: typeof NestedAuthRouteImport parentRoute: typeof rootRouteImport } '/nested/': { id: '/nested/' path: '/nested' fullPath: '/nested/' - preLoaderRoute: typeof nestedHomeRouteImport + preLoaderRoute: typeof NestedHomeRouteImport parentRoute: typeof rootRouteImport } } @@ -104,9 +104,9 @@ declare module '@tanstack/react-router' { const rootRouteChildren: RootRouteChildren = { IndexRoute: IndexRoute, - nestedHomeRoute: nestedHomeRoute, - nestedAuthRoute: nestedAuthRoute, - nestedCallbackRoute: nestedCallbackRoute, + NestedHomeRoute: NestedHomeRoute, + NestedAuthRoute: NestedAuthRoute, + NestedCallbackRoute: NestedCallbackRoute, } export const routeTree = rootRouteImport ._addFileChildren(rootRouteChildren) diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routeTree.snapshot.ts b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routeTree.snapshot.ts new file mode 100644 index 0000000000..70d06b2004 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routeTree.snapshot.ts @@ -0,0 +1,480 @@ +/* eslint-disable */ + +// @ts-nocheck + +// noinspection JSUnusedGlobalSymbols + +// This file was automatically generated by TanStack Router. +// You should NOT make any changes in this file as it will be overwritten. +// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. + +import { Route as rootRouteImport } from './routes/__root' +import { Route as layoutRouteImport } from './routes/layout' +import { Route as fooRouteImport } from './routes/foo' +import { Route as escapedRouteImport } from './routes/escaped' +import { Route as doubleRouteImport } from './routes/double' +import { Route as rootIdRouteImport } from './routes/root-id' +import { Route as nestedLayoutRouteImport } from './routes/nested-layout' +import { Route as innerLayoutRouteImport } from './routes/inner-layout' +import { Route as escapedBarRouteImport } from './routes/escaped-bar' +import { Route as barRouteImport } from './routes/bar' +import { Route as doubleBarRouteImport } from './routes/double-bar' +import { Route as rootIndexRouteImport } from './routes/root-index' +import { Route as bazRouteImport } from './routes/baz' +import { Route as nestedIdRouteImport } from './routes/nested-id' +import { Route as escapedIdRouteImport } from './routes/escaped-id' +import { Route as doubleIdRouteImport } from './routes/double-id' +import { Route as trailIndexRouteImport } from './routes/trail-index' +import { Route as nestedIndexRouteImport } from './routes/nested-index' +import { Route as escapedIndexRouteImport } from './routes/escaped-index' +import { Route as doubleIndexRouteImport } from './routes/double-index' +import { Route as deepIndexRouteImport } from './routes/deep-index' + +const layoutRoute = layoutRouteImport.update({ + id: '/_layout', + getParentRoute: () => rootRouteImport, +} as any) +const fooRoute = fooRouteImport.update({ + id: '/_foo', + path: '/_foo', + getParentRoute: () => rootRouteImport, +} as any) +const escapedRoute = escapedRouteImport.update({ + id: '/_escaped', + path: '/_escaped', + getParentRoute: () => rootRouteImport, +} as any) +const doubleRoute = doubleRouteImport.update({ + id: '/__double', + path: '/__double', + getParentRoute: () => rootRouteImport, +} as any) +const rootIdRoute = rootIdRouteImport.update({ + id: '/_root-index/$id', + path: '/_root-index/$id', + getParentRoute: () => rootRouteImport, +} as any) +const nestedLayoutRoute = nestedLayoutRouteImport.update({ + id: '/_nested', + getParentRoute: () => layoutRoute, +} as any) +const innerLayoutRoute = innerLayoutRouteImport.update({ + id: '/_inner', + getParentRoute: () => layoutRoute, +} as any) +const escapedBarRoute = escapedBarRouteImport.update({ + id: '/_escaped-bar', + path: '/_escaped-bar', + getParentRoute: () => layoutRoute, +} as any) +const barRoute = barRouteImport.update({ + id: '/_bar', + path: '/_bar', + getParentRoute: () => layoutRoute, +} as any) +const doubleBarRoute = doubleBarRouteImport.update({ + id: '/__double-bar', + path: '/__double-bar', + getParentRoute: () => layoutRoute, +} as any) +const rootIndexRoute = rootIndexRouteImport.update({ + id: '/_root-index/', + path: '/_root-index/', + getParentRoute: () => rootRouteImport, +} as any) +const bazRoute = bazRouteImport.update({ + id: '/_baz', + path: '/_baz', + getParentRoute: () => nestedLayoutRoute, +} as any) +const nestedIdRoute = nestedIdRouteImport.update({ + id: '/_nested-index/$id', + path: '/_nested-index/$id', + getParentRoute: () => layoutRoute, +} as any) +const escapedIdRoute = escapedIdRouteImport.update({ + id: '/_escaped-index/$id', + path: '/_escaped-index/$id', + getParentRoute: () => layoutRoute, +} as any) +const doubleIdRoute = doubleIdRouteImport.update({ + id: '/__double-index/$id', + path: '/__double-index/$id', + getParentRoute: () => layoutRoute, +} as any) +const trailIndexRoute = trailIndexRouteImport.update({ + id: '/trail_/', + path: '/trail_/', + getParentRoute: () => layoutRoute, +} as any) +const nestedIndexRoute = nestedIndexRouteImport.update({ + id: '/_nested-index/', + path: '/_nested-index/', + getParentRoute: () => layoutRoute, +} as any) +const escapedIndexRoute = escapedIndexRouteImport.update({ + id: '/_escaped-index/', + path: '/_escaped-index/', + getParentRoute: () => layoutRoute, +} as any) +const doubleIndexRoute = doubleIndexRouteImport.update({ + id: '/__double-index/', + path: '/__double-index/', + getParentRoute: () => layoutRoute, +} as any) +const deepIndexRoute = deepIndexRouteImport.update({ + id: '/_deep-index/', + path: '/_deep-index/', + getParentRoute: () => innerLayoutRoute, +} as any) + +export interface FileRoutesByFullPath { + '/__double': typeof doubleRoute + '/_escaped': typeof escapedRoute + '/_foo': typeof fooRoute + '/': typeof nestedLayoutRouteWithChildren + '/_root-index/': typeof rootIndexRoute + '/__double-bar': typeof doubleBarRoute + '/_bar': typeof barRoute + '/_escaped-bar': typeof escapedBarRoute + '/_root-index/$id': typeof rootIdRoute + '/__double-index/': typeof doubleIndexRoute + '/_escaped-index/': typeof escapedIndexRoute + '/_nested-index/': typeof nestedIndexRoute + '/trail_/': typeof trailIndexRoute + '/__double-index/$id': typeof doubleIdRoute + '/_escaped-index/$id': typeof escapedIdRoute + '/_nested-index/$id': typeof nestedIdRoute + '/_baz': typeof bazRoute + '/_deep-index/': typeof deepIndexRoute +} +export interface FileRoutesByTo { + '/__double': typeof doubleRoute + '/_escaped': typeof escapedRoute + '/_foo': typeof fooRoute + '/': typeof nestedLayoutRouteWithChildren + '/_root-index': typeof rootIndexRoute + '/__double-bar': typeof doubleBarRoute + '/_bar': typeof barRoute + '/_escaped-bar': typeof escapedBarRoute + '/_root-index/$id': typeof rootIdRoute + '/__double-index': typeof doubleIndexRoute + '/_escaped-index': typeof escapedIndexRoute + '/_nested-index': typeof nestedIndexRoute + '/trail_': typeof trailIndexRoute + '/__double-index/$id': typeof doubleIdRoute + '/_escaped-index/$id': typeof escapedIdRoute + '/_nested-index/$id': typeof nestedIdRoute + '/_baz': typeof bazRoute + '/_deep-index': typeof deepIndexRoute +} +export interface FileRoutesById { + __root__: typeof rootRouteImport + '/__double': typeof doubleRoute + '/_escaped': typeof escapedRoute + '/_foo': typeof fooRoute + '/_layout': typeof layoutRouteWithChildren + '/_root-index/': typeof rootIndexRoute + '/_layout/__double-bar': typeof doubleBarRoute + '/_layout/_bar': typeof barRoute + '/_layout/_escaped-bar': typeof escapedBarRoute + '/_layout/_inner': typeof innerLayoutRouteWithChildren + '/_layout/_nested': typeof nestedLayoutRouteWithChildren + '/_root-index/$id': typeof rootIdRoute + '/_layout/__double-index/': typeof doubleIndexRoute + '/_layout/_escaped-index/': typeof escapedIndexRoute + '/_layout/_nested-index/': typeof nestedIndexRoute + '/_layout/trail_/': typeof trailIndexRoute + '/_layout/__double-index/$id': typeof doubleIdRoute + '/_layout/_escaped-index/$id': typeof escapedIdRoute + '/_layout/_nested-index/$id': typeof nestedIdRoute + '/_layout/_nested/_baz': typeof bazRoute + '/_layout/_inner/_deep-index/': typeof deepIndexRoute +} +export interface FileRouteTypes { + fileRoutesByFullPath: FileRoutesByFullPath + fullPaths: + | '/__double' + | '/_escaped' + | '/_foo' + | '/' + | '/_root-index/' + | '/__double-bar' + | '/_bar' + | '/_escaped-bar' + | '/_root-index/$id' + | '/__double-index/' + | '/_escaped-index/' + | '/_nested-index/' + | '/trail_/' + | '/__double-index/$id' + | '/_escaped-index/$id' + | '/_nested-index/$id' + | '/_baz' + | '/_deep-index/' + fileRoutesByTo: FileRoutesByTo + to: + | '/__double' + | '/_escaped' + | '/_foo' + | '/' + | '/_root-index' + | '/__double-bar' + | '/_bar' + | '/_escaped-bar' + | '/_root-index/$id' + | '/__double-index' + | '/_escaped-index' + | '/_nested-index' + | '/trail_' + | '/__double-index/$id' + | '/_escaped-index/$id' + | '/_nested-index/$id' + | '/_baz' + | '/_deep-index' + id: + | '__root__' + | '/__double' + | '/_escaped' + | '/_foo' + | '/_layout' + | '/_root-index/' + | '/_layout/__double-bar' + | '/_layout/_bar' + | '/_layout/_escaped-bar' + | '/_layout/_inner' + | '/_layout/_nested' + | '/_root-index/$id' + | '/_layout/__double-index/' + | '/_layout/_escaped-index/' + | '/_layout/_nested-index/' + | '/_layout/trail_/' + | '/_layout/__double-index/$id' + | '/_layout/_escaped-index/$id' + | '/_layout/_nested-index/$id' + | '/_layout/_nested/_baz' + | '/_layout/_inner/_deep-index/' + fileRoutesById: FileRoutesById +} +export interface RootRouteChildren { + doubleRoute: typeof doubleRoute + escapedRoute: typeof escapedRoute + fooRoute: typeof fooRoute + layoutRoute: typeof layoutRouteWithChildren + rootIndexRoute: typeof rootIndexRoute + rootIdRoute: typeof rootIdRoute +} + +declare module '@tanstack/react-router' { + interface FileRoutesByPath { + '/_layout': { + id: '/_layout' + path: '' + fullPath: '/' + preLoaderRoute: typeof layoutRouteImport + parentRoute: typeof rootRouteImport + } + '/_foo': { + id: '/_foo' + path: '/_foo' + fullPath: '/_foo' + preLoaderRoute: typeof fooRouteImport + parentRoute: typeof rootRouteImport + } + '/_escaped': { + id: '/_escaped' + path: '/_escaped' + fullPath: '/_escaped' + preLoaderRoute: typeof escapedRouteImport + parentRoute: typeof rootRouteImport + } + '/__double': { + id: '/__double' + path: '/__double' + fullPath: '/__double' + preLoaderRoute: typeof doubleRouteImport + parentRoute: typeof rootRouteImport + } + '/_root-index/$id': { + id: '/_root-index/$id' + path: '/_root-index/$id' + fullPath: '/_root-index/$id' + preLoaderRoute: typeof rootIdRouteImport + parentRoute: typeof rootRouteImport + } + '/_layout/_nested': { + id: '/_layout/_nested' + path: '' + fullPath: '/' + preLoaderRoute: typeof nestedLayoutRouteImport + parentRoute: typeof layoutRoute + } + '/_layout/_inner': { + id: '/_layout/_inner' + path: '' + fullPath: '/' + preLoaderRoute: typeof innerLayoutRouteImport + parentRoute: typeof layoutRoute + } + '/_layout/_escaped-bar': { + id: '/_layout/_escaped-bar' + path: '/_escaped-bar' + fullPath: '/_escaped-bar' + preLoaderRoute: typeof escapedBarRouteImport + parentRoute: typeof layoutRoute + } + '/_layout/_bar': { + id: '/_layout/_bar' + path: '/_bar' + fullPath: '/_bar' + preLoaderRoute: typeof barRouteImport + parentRoute: typeof layoutRoute + } + '/_layout/__double-bar': { + id: '/_layout/__double-bar' + path: '/__double-bar' + fullPath: '/__double-bar' + preLoaderRoute: typeof doubleBarRouteImport + parentRoute: typeof layoutRoute + } + '/_root-index/': { + id: '/_root-index/' + path: '/_root-index' + fullPath: '/_root-index/' + preLoaderRoute: typeof rootIndexRouteImport + parentRoute: typeof rootRouteImport + } + '/_layout/_nested/_baz': { + id: '/_layout/_nested/_baz' + path: '/_baz' + fullPath: '/_baz' + preLoaderRoute: typeof bazRouteImport + parentRoute: typeof nestedLayoutRoute + } + '/_layout/_nested-index/$id': { + id: '/_layout/_nested-index/$id' + path: '/_nested-index/$id' + fullPath: '/_nested-index/$id' + preLoaderRoute: typeof nestedIdRouteImport + parentRoute: typeof layoutRoute + } + '/_layout/_escaped-index/$id': { + id: '/_layout/_escaped-index/$id' + path: '/_escaped-index/$id' + fullPath: '/_escaped-index/$id' + preLoaderRoute: typeof escapedIdRouteImport + parentRoute: typeof layoutRoute + } + '/_layout/__double-index/$id': { + id: '/_layout/__double-index/$id' + path: '/__double-index/$id' + fullPath: '/__double-index/$id' + preLoaderRoute: typeof doubleIdRouteImport + parentRoute: typeof layoutRoute + } + '/_layout/trail_/': { + id: '/_layout/trail_/' + path: '/trail_' + fullPath: '/trail_/' + preLoaderRoute: typeof trailIndexRouteImport + parentRoute: typeof layoutRoute + } + '/_layout/_nested-index/': { + id: '/_layout/_nested-index/' + path: '/_nested-index' + fullPath: '/_nested-index/' + preLoaderRoute: typeof nestedIndexRouteImport + parentRoute: typeof layoutRoute + } + '/_layout/_escaped-index/': { + id: '/_layout/_escaped-index/' + path: '/_escaped-index' + fullPath: '/_escaped-index/' + preLoaderRoute: typeof escapedIndexRouteImport + parentRoute: typeof layoutRoute + } + '/_layout/__double-index/': { + id: '/_layout/__double-index/' + path: '/__double-index' + fullPath: '/__double-index/' + preLoaderRoute: typeof doubleIndexRouteImport + parentRoute: typeof layoutRoute + } + '/_layout/_inner/_deep-index/': { + id: '/_layout/_inner/_deep-index/' + path: '/_deep-index' + fullPath: '/_deep-index/' + preLoaderRoute: typeof deepIndexRouteImport + parentRoute: typeof innerLayoutRoute + } + } +} + +interface innerLayoutRouteChildren { + deepIndexRoute: typeof deepIndexRoute +} + +const innerLayoutRouteChildren: innerLayoutRouteChildren = { + deepIndexRoute: deepIndexRoute, +} + +const innerLayoutRouteWithChildren = innerLayoutRoute._addFileChildren( + innerLayoutRouteChildren, +) + +interface nestedLayoutRouteChildren { + bazRoute: typeof bazRoute +} + +const nestedLayoutRouteChildren: nestedLayoutRouteChildren = { + bazRoute: bazRoute, +} + +const nestedLayoutRouteWithChildren = nestedLayoutRoute._addFileChildren( + nestedLayoutRouteChildren, +) + +interface layoutRouteChildren { + doubleBarRoute: typeof doubleBarRoute + barRoute: typeof barRoute + escapedBarRoute: typeof escapedBarRoute + innerLayoutRoute: typeof innerLayoutRouteWithChildren + nestedLayoutRoute: typeof nestedLayoutRouteWithChildren + doubleIndexRoute: typeof doubleIndexRoute + escapedIndexRoute: typeof escapedIndexRoute + nestedIndexRoute: typeof nestedIndexRoute + trailIndexRoute: typeof trailIndexRoute + doubleIdRoute: typeof doubleIdRoute + escapedIdRoute: typeof escapedIdRoute + nestedIdRoute: typeof nestedIdRoute +} + +const layoutRouteChildren: layoutRouteChildren = { + doubleBarRoute: doubleBarRoute, + barRoute: barRoute, + escapedBarRoute: escapedBarRoute, + innerLayoutRoute: innerLayoutRouteWithChildren, + nestedLayoutRoute: nestedLayoutRouteWithChildren, + doubleIndexRoute: doubleIndexRoute, + escapedIndexRoute: escapedIndexRoute, + nestedIndexRoute: nestedIndexRoute, + trailIndexRoute: trailIndexRoute, + doubleIdRoute: doubleIdRoute, + escapedIdRoute: escapedIdRoute, + nestedIdRoute: nestedIdRoute, +} + +const layoutRouteWithChildren = + layoutRoute._addFileChildren(layoutRouteChildren) + +const rootRouteChildren: RootRouteChildren = { + doubleRoute: doubleRoute, + escapedRoute: escapedRoute, + fooRoute: fooRoute, + layoutRoute: layoutRouteWithChildren, + rootIndexRoute: rootIndexRoute, + rootIdRoute: rootIdRoute, +} +export const routeTree = rootRouteImport + ._addFileChildren(rootRouteChildren) + ._addFileTypes<FileRouteTypes>() diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes.ts b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes.ts new file mode 100644 index 0000000000..34ebbc111e --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes.ts @@ -0,0 +1,30 @@ +import { index, layout, rootRoute, route } from '@tanstack/virtual-file-routes' + +export const routes = rootRoute('__root.tsx', [ + route('/_foo', 'foo.tsx'), + route('/[_]escaped', 'escaped.tsx'), + route('/__double', 'double.tsx'), + route('/_root-index', [index('root-index.tsx'), route('$id', 'root-id.tsx')]), + layout('_layout', 'layout.tsx', [ + route('/_bar', 'bar.tsx'), + route('/[_]escaped-bar', 'escaped-bar.tsx'), + route('/__double-bar', 'double-bar.tsx'), + route('/_nested-index', [ + index('nested-index.tsx'), + route('$id', 'nested-id.tsx'), + ]), + route('/[_]escaped-index', [ + index('escaped-index.tsx'), + route('$id', 'escaped-id.tsx'), + ]), + route('/__double-index', [ + index('double-index.tsx'), + route('$id', 'double-id.tsx'), + ]), + route('/trail_', [index('trail-index.tsx')]), + layout('_nested', 'nested-layout.tsx', [route('/_baz', 'baz.tsx')]), + layout('_inner', 'inner-layout.tsx', [ + route('/_deep-index', [index('deep-index.tsx')]), + ]), + ]), +]) diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/__root.tsx b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/__root.tsx new file mode 100644 index 0000000000..9c657c7d5b --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/__root.tsx @@ -0,0 +1,3 @@ +import { createRootRoute } from '@tanstack/react-router' + +export const Route = createRootRoute() diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/bar.tsx b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/bar.tsx new file mode 100644 index 0000000000..c1c8b28c28 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/bar.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/_bar')({ + component: () => 'Bar', +}) diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/baz.tsx b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/baz.tsx new file mode 100644 index 0000000000..9bec9e82d4 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/baz.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/_nested/_baz')({ + component: () => 'Baz', +}) diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/deep-index.tsx b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/deep-index.tsx new file mode 100644 index 0000000000..1952b00184 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/deep-index.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/_inner/_deep-index/')({ + component: () => 'Deep Index', +}) diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/double-bar.tsx b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/double-bar.tsx new file mode 100644 index 0000000000..fcda37434e --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/double-bar.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/__double-bar')({ + component: () => 'Double Bar', +}) diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/double-id.tsx b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/double-id.tsx new file mode 100644 index 0000000000..2a31adf60c --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/double-id.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/__double-index/$id')({ + component: () => 'Double Id', +}) diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/double-index.tsx b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/double-index.tsx new file mode 100644 index 0000000000..231e787df0 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/double-index.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/__double-index/')({ + component: () => 'Double Index', +}) diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/double.tsx b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/double.tsx new file mode 100644 index 0000000000..041f035a8b --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/double.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/__double')({ + component: () => 'Double', +}) diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/escaped-bar.tsx b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/escaped-bar.tsx new file mode 100644 index 0000000000..f3f5afce8d --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/escaped-bar.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/_escaped-bar')({ + component: () => 'Escaped Bar', +}) diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/escaped-id.tsx b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/escaped-id.tsx new file mode 100644 index 0000000000..a9fad62448 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/escaped-id.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/_escaped-index/$id')({ + component: () => 'Escaped Id', +}) diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/escaped-index.tsx b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/escaped-index.tsx new file mode 100644 index 0000000000..9b81fcbadd --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/escaped-index.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/_escaped-index/')({ + component: () => 'Escaped Index', +}) diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/escaped.tsx b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/escaped.tsx new file mode 100644 index 0000000000..efe4c1fbef --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/escaped.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_escaped')({ + component: () => 'Escaped', +}) diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/foo.tsx b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/foo.tsx new file mode 100644 index 0000000000..e081df4ce5 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/foo.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_foo')({ + component: () => 'Foo', +}) diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/inner-layout.tsx b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/inner-layout.tsx new file mode 100644 index 0000000000..5266c32a7c --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/inner-layout.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/_inner')({ + component: () => 'Inner Layout', +}) diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/layout.tsx b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/layout.tsx new file mode 100644 index 0000000000..9c1673dafd --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/layout.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout')({ + component: () => 'Layout', +}) diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/nested-id.tsx b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/nested-id.tsx new file mode 100644 index 0000000000..e09396020b --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/nested-id.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/_nested-index/$id')({ + component: () => 'Nested Id', +}) diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/nested-index.tsx b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/nested-index.tsx new file mode 100644 index 0000000000..a5f8f95497 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/nested-index.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/_nested-index/')({ + component: () => 'Nested Index', +}) diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/nested-layout.tsx b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/nested-layout.tsx new file mode 100644 index 0000000000..b2985c3c2e --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/nested-layout.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/_nested')({ + component: () => 'Nested Layout', +}) diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/root-id.tsx b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/root-id.tsx new file mode 100644 index 0000000000..ec329adfd3 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/root-id.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_root-index/$id')({ + component: () => 'Root Id', +}) diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/root-index.tsx b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/root-index.tsx new file mode 100644 index 0000000000..39387c7250 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/root-index.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_root-index/')({ + component: () => 'Root Index', +}) diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/trail-index.tsx b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/trail-index.tsx new file mode 100644 index 0000000000..7794e8f0b3 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/routes/trail-index.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/trail_/')({ + component: () => 'Trail Index', +}) diff --git a/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/tsr.config.json b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/tsr.config.json new file mode 100644 index 0000000000..4d587108e3 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-pathless-layout-escaped-underscore/tsr.config.json @@ -0,0 +1,5 @@ +{ + "routesDirectory": "./routes", + "generatedRouteTree": "./routeTree.gen.ts", + "virtualRouteConfig": "./routes.ts" +} diff --git a/packages/router-generator/tests/generator/virtual-physical-inside-nested/routeTree.snapshot.ts b/packages/router-generator/tests/generator/virtual-physical-inside-nested/routeTree.snapshot.ts new file mode 100644 index 0000000000..94d84fb790 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-physical-inside-nested/routeTree.snapshot.ts @@ -0,0 +1,134 @@ +/* eslint-disable */ + +// @ts-nocheck + +// noinspection JSUnusedGlobalSymbols + +// This file was automatically generated by TanStack Router. +// You should NOT make any changes in this file as it will be overwritten. +// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. + +import { Route as rootRouteImport } from './routes/__root' +import { Route as indexRouteImport } from './routes/index' +import { Route as S1LayoutRouteImport } from './subtree/routes/_layout' +import { Route as S1DotDotFooRoutesRouteRouteImport } from './subtree/foo/routes/route' +import { Route as S1DotDotFooRoutesIndexRouteImport } from './subtree/foo/routes/index' + +const indexRoute = indexRouteImport.update({ + id: '/', + path: '/', + getParentRoute: () => rootRouteImport, +} as any) +const S1LayoutRoute = S1LayoutRouteImport.update({ + id: '/s1/_layout', + path: '/s1', + getParentRoute: () => rootRouteImport, +} as any) +const S1DotDotFooRoutesRouteRoute = S1DotDotFooRoutesRouteRouteImport.update({ + id: '/foo', + path: '/foo', + getParentRoute: () => S1LayoutRoute, +} as any) +const S1DotDotFooRoutesIndexRoute = S1DotDotFooRoutesIndexRouteImport.update({ + id: '/', + path: '/', + getParentRoute: () => S1DotDotFooRoutesRouteRoute, +} as any) + +export interface FileRoutesByFullPath { + '/': typeof indexRoute + '/s1': typeof S1LayoutRouteWithChildren + '/s1/foo': typeof S1DotDotFooRoutesRouteRouteWithChildren + '/s1/foo/': typeof S1DotDotFooRoutesIndexRoute +} +export interface FileRoutesByTo { + '/': typeof indexRoute + '/s1': typeof S1LayoutRouteWithChildren + '/s1/foo': typeof S1DotDotFooRoutesIndexRoute +} +export interface FileRoutesById { + __root__: typeof rootRouteImport + '/': typeof indexRoute + '/s1/_layout': typeof S1LayoutRouteWithChildren + '/s1/_layout/foo': typeof S1DotDotFooRoutesRouteRouteWithChildren + '/s1/_layout/foo/': typeof S1DotDotFooRoutesIndexRoute +} +export interface FileRouteTypes { + fileRoutesByFullPath: FileRoutesByFullPath + fullPaths: '/' | '/s1' | '/s1/foo' | '/s1/foo/' + fileRoutesByTo: FileRoutesByTo + to: '/' | '/s1' | '/s1/foo' + id: '__root__' | '/' | '/s1/_layout' | '/s1/_layout/foo' | '/s1/_layout/foo/' + fileRoutesById: FileRoutesById +} +export interface RootRouteChildren { + indexRoute: typeof indexRoute + S1LayoutRoute: typeof S1LayoutRouteWithChildren +} + +declare module '@tanstack/react-router' { + interface FileRoutesByPath { + '/': { + id: '/' + path: '/' + fullPath: '/' + preLoaderRoute: typeof indexRouteImport + parentRoute: typeof rootRouteImport + } + '/s1/_layout': { + id: '/s1/_layout' + path: '/s1' + fullPath: '/s1' + preLoaderRoute: typeof S1LayoutRouteImport + parentRoute: typeof rootRouteImport + } + '/s1/_layout/foo': { + id: '/s1/_layout/foo' + path: '/foo' + fullPath: '/s1/foo' + preLoaderRoute: typeof S1DotDotFooRoutesRouteRouteImport + parentRoute: typeof S1LayoutRoute + } + '/s1/_layout/foo/': { + id: '/s1/_layout/foo/' + path: '/' + fullPath: '/s1/foo/' + preLoaderRoute: typeof S1DotDotFooRoutesIndexRouteImport + parentRoute: typeof S1DotDotFooRoutesRouteRoute + } + } +} + +interface S1DotDotFooRoutesRouteRouteChildren { + S1DotDotFooRoutesIndexRoute: typeof S1DotDotFooRoutesIndexRoute +} + +const S1DotDotFooRoutesRouteRouteChildren: S1DotDotFooRoutesRouteRouteChildren = + { + S1DotDotFooRoutesIndexRoute: S1DotDotFooRoutesIndexRoute, + } + +const S1DotDotFooRoutesRouteRouteWithChildren = + S1DotDotFooRoutesRouteRoute._addFileChildren( + S1DotDotFooRoutesRouteRouteChildren, + ) + +interface S1LayoutRouteChildren { + S1DotDotFooRoutesRouteRoute: typeof S1DotDotFooRoutesRouteRouteWithChildren +} + +const S1LayoutRouteChildren: S1LayoutRouteChildren = { + S1DotDotFooRoutesRouteRoute: S1DotDotFooRoutesRouteRouteWithChildren, +} + +const S1LayoutRouteWithChildren = S1LayoutRoute._addFileChildren( + S1LayoutRouteChildren, +) + +const rootRouteChildren: RootRouteChildren = { + indexRoute: indexRoute, + S1LayoutRoute: S1LayoutRouteWithChildren, +} +export const routeTree = rootRouteImport + ._addFileChildren(rootRouteChildren) + ._addFileTypes<FileRouteTypes>() diff --git a/packages/router-generator/tests/generator/virtual-physical-inside-nested/routes.ts b/packages/router-generator/tests/generator/virtual-physical-inside-nested/routes.ts new file mode 100644 index 0000000000..c12b588011 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-physical-inside-nested/routes.ts @@ -0,0 +1,6 @@ +import { index, physical, rootRoute } from '@tanstack/virtual-file-routes' + +export const routes = rootRoute('__root.tsx', [ + index('index.tsx'), + physical('/s1', '../subtree/routes'), +]) diff --git a/packages/router-generator/tests/generator/virtual-physical-inside-nested/routes/__root.tsx b/packages/router-generator/tests/generator/virtual-physical-inside-nested/routes/__root.tsx new file mode 100644 index 0000000000..f463b796b4 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-physical-inside-nested/routes/__root.tsx @@ -0,0 +1,5 @@ +import { createRootRoute, Outlet } from '@tanstack/react-router' + +export const Route = createRootRoute({ + component: () => <Outlet />, +}) diff --git a/packages/router-generator/tests/generator/virtual-physical-inside-nested/routes/index.tsx b/packages/router-generator/tests/generator/virtual-physical-inside-nested/routes/index.tsx new file mode 100644 index 0000000000..fa6ed84966 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-physical-inside-nested/routes/index.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/')({ + component: () => <div>Home</div>, +}) diff --git a/packages/router-generator/tests/generator/virtual-physical-inside-nested/subtree/foo/routes/index.tsx b/packages/router-generator/tests/generator/virtual-physical-inside-nested/subtree/foo/routes/index.tsx new file mode 100644 index 0000000000..0afeadc25e --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-physical-inside-nested/subtree/foo/routes/index.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/s1/_layout/foo/')({ + component: () => <div>Nested home</div>, +}) diff --git a/packages/router-generator/tests/generator/virtual-physical-inside-nested/subtree/foo/routes/route.tsx b/packages/router-generator/tests/generator/virtual-physical-inside-nested/subtree/foo/routes/route.tsx new file mode 100644 index 0000000000..31746ba258 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-physical-inside-nested/subtree/foo/routes/route.tsx @@ -0,0 +1,5 @@ +import { Outlet, createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/s1/_layout/foo')({ + component: () => <Outlet />, +}) diff --git a/packages/router-generator/tests/generator/virtual-physical-inside-nested/subtree/routes/__virtual.ts b/packages/router-generator/tests/generator/virtual-physical-inside-nested/subtree/routes/__virtual.ts new file mode 100644 index 0000000000..28ca02884c --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-physical-inside-nested/subtree/routes/__virtual.ts @@ -0,0 +1,9 @@ +import { + defineVirtualSubtreeConfig, + layout, + physical, +} from '@tanstack/virtual-file-routes' + +export default defineVirtualSubtreeConfig([ + layout('./_layout.tsx', [physical('/foo', '../foo/routes')]), +]) diff --git a/packages/router-generator/tests/generator/virtual-physical-inside-nested/subtree/routes/_layout.tsx b/packages/router-generator/tests/generator/virtual-physical-inside-nested/subtree/routes/_layout.tsx new file mode 100644 index 0000000000..4740cb1263 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-physical-inside-nested/subtree/routes/_layout.tsx @@ -0,0 +1,5 @@ +import { Outlet, createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/s1/_layout')({ + component: () => <Outlet />, +}) diff --git a/packages/router-generator/tests/generator/virtual-physical-inside-nested/tsr.config.json b/packages/router-generator/tests/generator/virtual-physical-inside-nested/tsr.config.json new file mode 100644 index 0000000000..4d587108e3 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-physical-inside-nested/tsr.config.json @@ -0,0 +1,5 @@ +{ + "routesDirectory": "./routes", + "generatedRouteTree": "./routeTree.gen.ts", + "virtualRouteConfig": "./routes.ts" +} diff --git a/packages/router-generator/tests/generator/virtual-physical-pathless-layout-literal-index/routeTree.snapshot.ts b/packages/router-generator/tests/generator/virtual-physical-pathless-layout-literal-index/routeTree.snapshot.ts new file mode 100644 index 0000000000..b0fd76d1ef --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-physical-pathless-layout-literal-index/routeTree.snapshot.ts @@ -0,0 +1,104 @@ +/* eslint-disable */ + +// @ts-nocheck + +// noinspection JSUnusedGlobalSymbols + +// This file was automatically generated by TanStack Router. +// You should NOT make any changes in this file as it will be overwritten. +// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. + +import { Route as rootRouteImport } from './routes/__root' +import { Route as layoutRouteImport } from './routes/layout' +import { Route as Char91_Char93nestedIndexRouteImport } from './routes/physical-routes/[_]nested/index' +import { Route as Char91_Char93nestedIdRouteImport } from './routes/physical-routes/[_]nested/$id' + +const layoutRoute = layoutRouteImport.update({ + id: '/_layout', + getParentRoute: () => rootRouteImport, +} as any) +const Char91_Char93nestedIndexRoute = + Char91_Char93nestedIndexRouteImport.update({ + id: '/_nested/', + path: '/_nested/', + getParentRoute: () => layoutRoute, + } as any) +const Char91_Char93nestedIdRoute = Char91_Char93nestedIdRouteImport.update({ + id: '/_nested/$id', + path: '/_nested/$id', + getParentRoute: () => layoutRoute, +} as any) + +export interface FileRoutesByFullPath { + '/': typeof layoutRouteWithChildren + '/_nested/$id': typeof Char91_Char93nestedIdRoute + '/_nested/': typeof Char91_Char93nestedIndexRoute +} +export interface FileRoutesByTo { + '/': typeof layoutRouteWithChildren + '/_nested/$id': typeof Char91_Char93nestedIdRoute + '/_nested': typeof Char91_Char93nestedIndexRoute +} +export interface FileRoutesById { + __root__: typeof rootRouteImport + '/_layout': typeof layoutRouteWithChildren + '/_layout/_nested/$id': typeof Char91_Char93nestedIdRoute + '/_layout/_nested/': typeof Char91_Char93nestedIndexRoute +} +export interface FileRouteTypes { + fileRoutesByFullPath: FileRoutesByFullPath + fullPaths: '/' | '/_nested/$id' | '/_nested/' + fileRoutesByTo: FileRoutesByTo + to: '/' | '/_nested/$id' | '/_nested' + id: '__root__' | '/_layout' | '/_layout/_nested/$id' | '/_layout/_nested/' + fileRoutesById: FileRoutesById +} +export interface RootRouteChildren { + layoutRoute: typeof layoutRouteWithChildren +} + +declare module '@tanstack/react-router' { + interface FileRoutesByPath { + '/_layout': { + id: '/_layout' + path: '' + fullPath: '/' + preLoaderRoute: typeof layoutRouteImport + parentRoute: typeof rootRouteImport + } + '/_layout/_nested/': { + id: '/_layout/_nested/' + path: '/_nested' + fullPath: '/_nested/' + preLoaderRoute: typeof Char91_Char93nestedIndexRouteImport + parentRoute: typeof layoutRoute + } + '/_layout/_nested/$id': { + id: '/_layout/_nested/$id' + path: '/_nested/$id' + fullPath: '/_nested/$id' + preLoaderRoute: typeof Char91_Char93nestedIdRouteImport + parentRoute: typeof layoutRoute + } + } +} + +interface layoutRouteChildren { + Char91_Char93nestedIdRoute: typeof Char91_Char93nestedIdRoute + Char91_Char93nestedIndexRoute: typeof Char91_Char93nestedIndexRoute +} + +const layoutRouteChildren: layoutRouteChildren = { + Char91_Char93nestedIdRoute: Char91_Char93nestedIdRoute, + Char91_Char93nestedIndexRoute: Char91_Char93nestedIndexRoute, +} + +const layoutRouteWithChildren = + layoutRoute._addFileChildren(layoutRouteChildren) + +const rootRouteChildren: RootRouteChildren = { + layoutRoute: layoutRouteWithChildren, +} +export const routeTree = rootRouteImport + ._addFileChildren(rootRouteChildren) + ._addFileTypes<FileRouteTypes>() diff --git a/packages/router-generator/tests/generator/virtual-physical-pathless-layout-literal-index/routes.ts b/packages/router-generator/tests/generator/virtual-physical-pathless-layout-literal-index/routes.ts new file mode 100644 index 0000000000..8cd9a3a353 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-physical-pathless-layout-literal-index/routes.ts @@ -0,0 +1,5 @@ +import { layout, physical, rootRoute } from '@tanstack/virtual-file-routes' + +export const routes = rootRoute('__root.tsx', [ + layout('_layout', 'layout.tsx', [physical('', 'physical-routes')]), +]) diff --git a/packages/router-generator/tests/generator/virtual-physical-pathless-layout-literal-index/routes/__root.tsx b/packages/router-generator/tests/generator/virtual-physical-pathless-layout-literal-index/routes/__root.tsx new file mode 100644 index 0000000000..9c657c7d5b --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-physical-pathless-layout-literal-index/routes/__root.tsx @@ -0,0 +1,3 @@ +import { createRootRoute } from '@tanstack/react-router' + +export const Route = createRootRoute() diff --git a/packages/router-generator/tests/generator/virtual-physical-pathless-layout-literal-index/routes/layout.tsx b/packages/router-generator/tests/generator/virtual-physical-pathless-layout-literal-index/routes/layout.tsx new file mode 100644 index 0000000000..9c1673dafd --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-physical-pathless-layout-literal-index/routes/layout.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout')({ + component: () => 'Layout', +}) diff --git a/packages/router-generator/tests/generator/virtual-physical-pathless-layout-literal-index/routes/physical-routes/[_]nested/$id.tsx b/packages/router-generator/tests/generator/virtual-physical-pathless-layout-literal-index/routes/physical-routes/[_]nested/$id.tsx new file mode 100644 index 0000000000..4b06b8799e --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-physical-pathless-layout-literal-index/routes/physical-routes/[_]nested/$id.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/_nested/$id')({ + component: () => 'Nested Id', +}) diff --git a/packages/router-generator/tests/generator/virtual-physical-pathless-layout-literal-index/routes/physical-routes/[_]nested/index.tsx b/packages/router-generator/tests/generator/virtual-physical-pathless-layout-literal-index/routes/physical-routes/[_]nested/index.tsx new file mode 100644 index 0000000000..b8eca0e427 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-physical-pathless-layout-literal-index/routes/physical-routes/[_]nested/index.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_layout/_nested/')({ + component: () => 'Nested Index', +}) diff --git a/packages/router-generator/tests/generator/virtual-physical-pathless-layout-literal-index/tsr.config.json b/packages/router-generator/tests/generator/virtual-physical-pathless-layout-literal-index/tsr.config.json new file mode 100644 index 0000000000..4d587108e3 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-physical-pathless-layout-literal-index/tsr.config.json @@ -0,0 +1,5 @@ +{ + "routesDirectory": "./routes", + "generatedRouteTree": "./routeTree.gen.ts", + "virtualRouteConfig": "./routes.ts" +} diff --git a/packages/router-generator/tests/generator/virtual-physical-prefix-escaped-underscore/routeTree.snapshot.ts b/packages/router-generator/tests/generator/virtual-physical-prefix-escaped-underscore/routeTree.snapshot.ts new file mode 100644 index 0000000000..63b1df0f40 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-physical-prefix-escaped-underscore/routeTree.snapshot.ts @@ -0,0 +1,77 @@ +/* eslint-disable */ + +// @ts-nocheck + +// noinspection JSUnusedGlobalSymbols + +// This file was automatically generated by TanStack Router. +// You should NOT make any changes in this file as it will be overwritten. +// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. + +import { Route as rootRouteImport } from './routes/__root' +import { Route as ApiIndexRouteImport } from './routes/physical-routes/index' +import { Route as ApiIdRouteImport } from './routes/physical-routes/$id' + +const ApiIndexRoute = ApiIndexRouteImport.update({ + id: '/_api/', + path: '/_api/', + getParentRoute: () => rootRouteImport, +} as any) +const ApiIdRoute = ApiIdRouteImport.update({ + id: '/_api/$id', + path: '/_api/$id', + getParentRoute: () => rootRouteImport, +} as any) + +export interface FileRoutesByFullPath { + '/_api/$id': typeof ApiIdRoute + '/_api/': typeof ApiIndexRoute +} +export interface FileRoutesByTo { + '/_api/$id': typeof ApiIdRoute + '/_api': typeof ApiIndexRoute +} +export interface FileRoutesById { + __root__: typeof rootRouteImport + '/_api/$id': typeof ApiIdRoute + '/_api/': typeof ApiIndexRoute +} +export interface FileRouteTypes { + fileRoutesByFullPath: FileRoutesByFullPath + fullPaths: '/_api/$id' | '/_api/' + fileRoutesByTo: FileRoutesByTo + to: '/_api/$id' | '/_api' + id: '__root__' | '/_api/$id' | '/_api/' + fileRoutesById: FileRoutesById +} +export interface RootRouteChildren { + ApiIdRoute: typeof ApiIdRoute + ApiIndexRoute: typeof ApiIndexRoute +} + +declare module '@tanstack/react-router' { + interface FileRoutesByPath { + '/_api/': { + id: '/_api/' + path: '/_api' + fullPath: '/_api/' + preLoaderRoute: typeof ApiIndexRouteImport + parentRoute: typeof rootRouteImport + } + '/_api/$id': { + id: '/_api/$id' + path: '/_api/$id' + fullPath: '/_api/$id' + preLoaderRoute: typeof ApiIdRouteImport + parentRoute: typeof rootRouteImport + } + } +} + +const rootRouteChildren: RootRouteChildren = { + ApiIdRoute: ApiIdRoute, + ApiIndexRoute: ApiIndexRoute, +} +export const routeTree = rootRouteImport + ._addFileChildren(rootRouteChildren) + ._addFileTypes<FileRouteTypes>() diff --git a/packages/router-generator/tests/generator/virtual-physical-prefix-escaped-underscore/routes.ts b/packages/router-generator/tests/generator/virtual-physical-prefix-escaped-underscore/routes.ts new file mode 100644 index 0000000000..8e3883cec6 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-physical-prefix-escaped-underscore/routes.ts @@ -0,0 +1,5 @@ +import { physical, rootRoute } from '@tanstack/virtual-file-routes' + +export const routes = rootRoute('__root.tsx', [ + physical('/[_]api', 'physical-routes'), +]) diff --git a/packages/router-generator/tests/generator/virtual-physical-prefix-escaped-underscore/routes/__root.tsx b/packages/router-generator/tests/generator/virtual-physical-prefix-escaped-underscore/routes/__root.tsx new file mode 100644 index 0000000000..9c657c7d5b --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-physical-prefix-escaped-underscore/routes/__root.tsx @@ -0,0 +1,3 @@ +import { createRootRoute } from '@tanstack/react-router' + +export const Route = createRootRoute() diff --git a/packages/router-generator/tests/generator/virtual-physical-prefix-escaped-underscore/routes/physical-routes/$id.tsx b/packages/router-generator/tests/generator/virtual-physical-prefix-escaped-underscore/routes/physical-routes/$id.tsx new file mode 100644 index 0000000000..e45ad32d5d --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-physical-prefix-escaped-underscore/routes/physical-routes/$id.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_api/$id')({ + component: () => 'API Id', +}) diff --git a/packages/router-generator/tests/generator/virtual-physical-prefix-escaped-underscore/routes/physical-routes/index.tsx b/packages/router-generator/tests/generator/virtual-physical-prefix-escaped-underscore/routes/physical-routes/index.tsx new file mode 100644 index 0000000000..ac44aee10d --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-physical-prefix-escaped-underscore/routes/physical-routes/index.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_api/')({ + component: () => 'API Index', +}) diff --git a/packages/router-generator/tests/generator/virtual-physical-prefix-escaped-underscore/tsr.config.json b/packages/router-generator/tests/generator/virtual-physical-prefix-escaped-underscore/tsr.config.json new file mode 100644 index 0000000000..4d587108e3 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-physical-prefix-escaped-underscore/tsr.config.json @@ -0,0 +1,5 @@ +{ + "routesDirectory": "./routes", + "generatedRouteTree": "./routeTree.gen.ts", + "virtualRouteConfig": "./routes.ts" +} diff --git a/packages/router-generator/tests/generator/virtual-subtree-in-escaped-physical-directory/routeTree.snapshot.ts b/packages/router-generator/tests/generator/virtual-subtree-in-escaped-physical-directory/routeTree.snapshot.ts new file mode 100644 index 0000000000..bb8b39ad4a --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-subtree-in-escaped-physical-directory/routeTree.snapshot.ts @@ -0,0 +1,77 @@ +/* eslint-disable */ + +// @ts-nocheck + +// noinspection JSUnusedGlobalSymbols + +// This file was automatically generated by TanStack Router. +// You should NOT make any changes in this file as it will be overwritten. +// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified. + +import { Route as rootRouteImport } from './routes/__root' +import { Route as AreaIndexRouteImport } from './routes/[_]area/index' +import { Route as AreaChildRouteImport } from './routes/[_]area/child' + +const AreaIndexRoute = AreaIndexRouteImport.update({ + id: '/_area/', + path: '/_area/', + getParentRoute: () => rootRouteImport, +} as any) +const AreaChildRoute = AreaChildRouteImport.update({ + id: '/_area/child', + path: '/_area/child', + getParentRoute: () => rootRouteImport, +} as any) + +export interface FileRoutesByFullPath { + '/_area/child': typeof AreaChildRoute + '/_area/': typeof AreaIndexRoute +} +export interface FileRoutesByTo { + '/_area/child': typeof AreaChildRoute + '/_area': typeof AreaIndexRoute +} +export interface FileRoutesById { + __root__: typeof rootRouteImport + '/_area/child': typeof AreaChildRoute + '/_area/': typeof AreaIndexRoute +} +export interface FileRouteTypes { + fileRoutesByFullPath: FileRoutesByFullPath + fullPaths: '/_area/child' | '/_area/' + fileRoutesByTo: FileRoutesByTo + to: '/_area/child' | '/_area' + id: '__root__' | '/_area/child' | '/_area/' + fileRoutesById: FileRoutesById +} +export interface RootRouteChildren { + AreaChildRoute: typeof AreaChildRoute + AreaIndexRoute: typeof AreaIndexRoute +} + +declare module '@tanstack/react-router' { + interface FileRoutesByPath { + '/_area/': { + id: '/_area/' + path: '/_area' + fullPath: '/_area/' + preLoaderRoute: typeof AreaIndexRouteImport + parentRoute: typeof rootRouteImport + } + '/_area/child': { + id: '/_area/child' + path: '/_area/child' + fullPath: '/_area/child' + preLoaderRoute: typeof AreaChildRouteImport + parentRoute: typeof rootRouteImport + } + } +} + +const rootRouteChildren: RootRouteChildren = { + AreaChildRoute: AreaChildRoute, + AreaIndexRoute: AreaIndexRoute, +} +export const routeTree = rootRouteImport + ._addFileChildren(rootRouteChildren) + ._addFileTypes<FileRouteTypes>() diff --git a/packages/router-generator/tests/generator/virtual-subtree-in-escaped-physical-directory/routes/[_]area/__virtual.ts b/packages/router-generator/tests/generator/virtual-subtree-in-escaped-physical-directory/routes/[_]area/__virtual.ts new file mode 100644 index 0000000000..fd1baf16be --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-subtree-in-escaped-physical-directory/routes/[_]area/__virtual.ts @@ -0,0 +1,10 @@ +import { + defineVirtualSubtreeConfig, + index, + route, +} from '@tanstack/virtual-file-routes' + +export default defineVirtualSubtreeConfig([ + index('index.tsx'), + route('/child', 'child.tsx'), +]) diff --git a/packages/router-generator/tests/generator/virtual-subtree-in-escaped-physical-directory/routes/[_]area/child.tsx b/packages/router-generator/tests/generator/virtual-subtree-in-escaped-physical-directory/routes/[_]area/child.tsx new file mode 100644 index 0000000000..f3af7057cb --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-subtree-in-escaped-physical-directory/routes/[_]area/child.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_area/child')({ + component: () => 'Area Child', +}) diff --git a/packages/router-generator/tests/generator/virtual-subtree-in-escaped-physical-directory/routes/[_]area/index.tsx b/packages/router-generator/tests/generator/virtual-subtree-in-escaped-physical-directory/routes/[_]area/index.tsx new file mode 100644 index 0000000000..90b81675e6 --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-subtree-in-escaped-physical-directory/routes/[_]area/index.tsx @@ -0,0 +1,5 @@ +import { createFileRoute } from '@tanstack/react-router' + +export const Route = createFileRoute('/_area/')({ + component: () => 'Area Index', +}) diff --git a/packages/router-generator/tests/generator/virtual-subtree-in-escaped-physical-directory/routes/__root.tsx b/packages/router-generator/tests/generator/virtual-subtree-in-escaped-physical-directory/routes/__root.tsx new file mode 100644 index 0000000000..9c657c7d5b --- /dev/null +++ b/packages/router-generator/tests/generator/virtual-subtree-in-escaped-physical-directory/routes/__root.tsx @@ -0,0 +1,3 @@ +import { createRootRoute } from '@tanstack/react-router' + +export const Route = createRootRoute() diff --git a/packages/router-generator/tests/template.test.ts b/packages/router-generator/tests/template.test.ts new file mode 100644 index 0000000000..745604b4ec --- /dev/null +++ b/packages/router-generator/tests/template.test.ts @@ -0,0 +1,37 @@ +import { describe, expect, it } from 'vitest' +import { getTargetTemplate } from '../src/template' + +describe('template', () => { + it('escapes quoted route paths in React route templates', () => { + const template = getTargetTemplate({ target: 'react' } as never) + + expect(template.route.imports.tsrExportStart(`/say-"hi"`)).toBe( + `export const Route = createFileRoute(${JSON.stringify('/say-"hi"')})(`, + ) + expect(template.lazyRoute.imports.tsrExportStart(`/say-"hi"`)).toBe( + `export const Route = createLazyFileRoute(${JSON.stringify('/say-"hi"')})(`, + ) + }) + + it('escapes quoted route paths in Solid route templates', () => { + const template = getTargetTemplate({ target: 'solid' } as never) + + expect(template.route.imports.tsrExportStart(`/say-"hi"`)).toBe( + `export const Route = createFileRoute(${JSON.stringify('/say-"hi"')})(`, + ) + expect(template.lazyRoute.imports.tsrExportStart(`/say-"hi"`)).toBe( + `export const Route = createLazyFileRoute(${JSON.stringify('/say-"hi"')})(`, + ) + }) + + it('escapes quoted route paths in Vue route templates', () => { + const template = getTargetTemplate({ target: 'vue' } as never) + + expect(template.route.imports.tsrExportStart(`/say-"hi"`)).toBe( + `export const Route = createFileRoute(${JSON.stringify('/say-"hi"')})(`, + ) + expect(template.lazyRoute.imports.tsrExportStart(`/say-"hi"`)).toBe( + `export const Route = createLazyFileRoute(${JSON.stringify('/say-"hi"')})(`, + ) + }) +}) diff --git a/packages/router-generator/tests/transform.test.ts b/packages/router-generator/tests/transform.test.ts new file mode 100644 index 0000000000..8a53f3278e --- /dev/null +++ b/packages/router-generator/tests/transform.test.ts @@ -0,0 +1,525 @@ +import { describe, expect, it } from 'vitest' +import { transform } from '../src/transform/transform' +import type { RouteNode } from '../src/types' + +function makeNode( + fsRouteType: RouteNode['_fsRouteType'] = 'static', +): RouteNode { + return { + filePath: '/test.tsx', + fullPath: '/test.tsx', + variableName: 'TestRoute', + _fsRouteType: fsRouteType, + } +} + +describe('transform', () => { + it('does not treat root route exports as missing Route exports', async () => { + const result = await transform({ + source: [ + "import { createRootRoute } from '@tanstack/react-router'", + '', + 'export const Route = createRootRoute()({})', + ].join('\n'), + ctx: { + target: 'react', + routeId: '/', + lazy: false, + }, + node: makeNode('__root'), + }) + + expect(result.result).toBe('not-modified') + }) + + it('does not treat createRootRouteWithContext exports as missing Route exports', async () => { + const result = await transform({ + source: [ + "import { createRootRouteWithContext } from '@tanstack/react-router'", + '', + 'interface RouterContext {}', + '', + 'export const Route = createRootRouteWithContext<RouterContext>()({})', + ].join('\n'), + ctx: { + target: 'react', + routeId: '/', + lazy: false, + }, + node: makeNode('__root'), + }) + + expect(result.result).toBe('not-modified') + }) + + it('does not treat createRootRoute exported via export { Route } as missing Route exports', async () => { + const result = await transform({ + source: [ + "import { createRootRoute } from '@tanstack/react-router'", + '', + 'const Route = createRootRoute()({})', + '', + 'export { Route }', + ].join('\n'), + ctx: { + target: 'react', + routeId: '/', + lazy: false, + }, + node: makeNode('__root'), + }) + + expect(result.result).toBe('not-modified') + }) + + it('returns an error result for parse failures', async () => { + const result = await transform({ + source: "export const Route = createFileRoute('/broken')(", + ctx: { + target: 'react', + routeId: '/broken', + lazy: false, + }, + node: makeNode(), + }) + + expect(result.result).toBe('error') + }) + + it('rewrites an aliased exported Route binding', async () => { + const node = makeNode() + const result = await transform({ + source: [ + "import { createFileRoute } from '@tanstack/react-router'", + '', + "const MyRoute = createFileRoute('/old')({ component: Component })", + '', + 'export { MyRoute as Route }', + '', + 'function Component() {', + ' return null', + '}', + ].join('\n'), + ctx: { + target: 'react', + routeId: '/new', + lazy: false, + }, + node, + }) + + expect(result.result).toBe('modified') + if (result.result !== 'modified') { + throw new Error(`expected modified result, got ${result.result}`) + } + expect(result.output).toContain("createFileRoute('/new')") + expect(node.createFileRouteProps).toEqual(new Set(['component'])) + }) + + it('removes imports cleanly with CRLF line endings', async () => { + const result = await transform({ + source: [ + "import { createFileRoute } from '@tanstack/react-router'", + "import { createLazyFileRoute } from '@tanstack/react-router'", + '', + "export const Route = createFileRoute('/old')({})", + ].join('\r\n'), + ctx: { + target: 'react', + routeId: '/new', + lazy: false, + }, + node: makeNode(), + }) + + expect(result.result).toBe('modified') + if (result.result !== 'modified') { + throw new Error(`expected modified result, got ${result.result}`) + } + expect(result.output).toBe( + [ + "import { createFileRoute } from '@tanstack/react-router'", + '', + "export const Route = createFileRoute('/new')({})", + ].join('\r\n'), + ) + }) + + it('preserves import formatting when only renaming the route constructor', async () => { + const result = await transform({ + source: [ + 'import {', + ' Link,', + ' createFileRoute,', + `} from '@tanstack/react-router'`, + '', + "export const Route = createFileRoute('/old')({})", + ].join('\n'), + ctx: { + target: 'react', + routeId: '/new', + lazy: true, + }, + node: makeNode('lazy'), + }) + + expect(result.result).toBe('modified') + if (result.result !== 'modified') { + throw new Error(`expected modified result, got ${result.result}`) + } + expect(result.output).toBe( + [ + 'import {', + ' Link,', + ' createLazyFileRoute,', + `} from '@tanstack/react-router'`, + '', + "export const Route = createLazyFileRoute('/new')({})", + ].join('\n'), + ) + }) + + it('adds the missing constructor import with the file line ending', async () => { + const result = await transform({ + source: [ + "import { Link } from '@tanstack/react-router'", + '', + "export const Route = createFileRoute('/old')({})", + ].join('\r\n'), + ctx: { + target: 'react', + routeId: '/new', + lazy: false, + }, + node: makeNode(), + }) + + expect(result.result).toBe('modified') + if (result.result !== 'modified') { + throw new Error(`expected modified result, got ${result.result}`) + } + expect(result.output).toBe( + [ + "import { Link, createFileRoute } from '@tanstack/react-router'", + '', + "export const Route = createFileRoute('/new')({})", + ].join('\r\n'), + ) + }) + + it('ignores non-exported route constructor calls in the same file', async () => { + const result = await transform({ + source: [ + "import { createFileRoute } from '@tanstack/react-router'", + '', + "const OtherRoute = createFileRoute('/other')({})", + "export const Route = createFileRoute('/old')({})", + ].join('\n'), + ctx: { + target: 'react', + routeId: '/new', + lazy: false, + }, + node: makeNode(), + }) + + expect(result.result).toBe('modified') + if (result.result !== 'modified') { + throw new Error(`expected modified result, got ${result.result}`) + } + expect(result.output).toContain( + "const OtherRoute = createFileRoute('/other')({})", + ) + expect(result.output).toContain( + "export const Route = createFileRoute('/new')({})", + ) + }) + + it('returns an error for unsupported route id expressions', async () => { + const result = await transform({ + source: [ + "import { createFileRoute } from '@tanstack/react-router'", + '', + 'const routeId = getRouteId()', + 'export const Route = createFileRoute(routeId)({})', + ].join('\n'), + ctx: { + target: 'react', + routeId: '/new', + lazy: false, + }, + node: makeNode(), + }) + + expect(result.result).toBe('error') + if (result.result !== 'error') { + throw new Error(`expected error result, got ${result.result}`) + } + expect(String(result.error)).toContain( + 'expected route id to be a string literal or plain template literal', + ) + }) + + it('returns a distinct error for malformed direct createFileRoute calls', async () => { + const result = await transform({ + source: [ + "import { createFileRoute } from '@tanstack/react-router'", + '', + 'export const Route = createFileRoute({ component: Home })', + ].join('\n'), + ctx: { + target: 'react', + routeId: '/new', + lazy: false, + }, + node: makeNode(), + }) + + expect(result.result).toBe('error') + if (result.result !== 'error') { + throw new Error(`expected error result, got ${result.result}`) + } + expect(String(result.error)).toContain( + "expected Route export in /new to use createFileRoute('/path')({...}) or createLazyFileRoute('/path')({...})", + ) + }) + + it('returns a distinct error for malformed direct createLazyFileRoute calls', async () => { + const result = await transform({ + source: [ + "import { createLazyFileRoute } from '@tanstack/react-router'", + '', + 'export const Route = createLazyFileRoute({ component: Home })', + ].join('\n'), + ctx: { + target: 'react', + routeId: '/new', + lazy: true, + }, + node: makeNode('lazy'), + }) + + expect(result.result).toBe('error') + if (result.result !== 'error') { + throw new Error(`expected error result, got ${result.result}`) + } + expect(String(result.error)).toContain( + "expected Route export in /new to use createFileRoute('/path')({...}) or createLazyFileRoute('/path')({...})", + ) + }) + + it('preserves double-quote route IDs', async () => { + const result = await transform({ + source: [ + "import { createFileRoute } from '@tanstack/react-router'", + '', + 'export const Route = createFileRoute("/old")({})', + ].join('\n'), + ctx: { + target: 'react', + routeId: '/new', + lazy: false, + }, + node: makeNode(), + }) + + expect(result.result).toBe('modified') + if (result.result !== 'modified') { + throw new Error(`expected modified result, got ${result.result}`) + } + expect(result.output).toContain('createFileRoute("/new")') + }) + + it('preserves template-literal route IDs', async () => { + const result = await transform({ + source: [ + "import { createFileRoute } from '@tanstack/react-router'", + '', + 'export const Route = createFileRoute(`/old`)({})', + ].join('\n'), + ctx: { + target: 'react', + routeId: '/new', + lazy: false, + }, + node: makeNode(), + }) + + expect(result.result).toBe('modified') + if (result.result !== 'modified') { + throw new Error(`expected modified result, got ${result.result}`) + } + expect(result.output).toContain('createFileRoute(`/new`)') + }) + + it('rewrites createLazyFileRoute to createFileRoute when lazy changes', async () => { + const result = await transform({ + source: [ + "import { createLazyFileRoute } from '@tanstack/react-router'", + '', + "export const Route = createLazyFileRoute('/test')({})", + ].join('\n'), + ctx: { + target: 'react', + routeId: '/test', + lazy: false, + }, + node: makeNode(), + }) + + expect(result.result).toBe('modified') + if (result.result !== 'modified') { + throw new Error(`expected modified result, got ${result.result}`) + } + expect(result.output).toContain("createFileRoute('/test')") + expect(result.output).not.toContain('createLazyFileRoute') + }) + + it('handles export { Route } with a separate const declaration', async () => { + const result = await transform({ + source: [ + "import { createFileRoute } from '@tanstack/react-router'", + '', + "const Route = createFileRoute('/old')({})", + '', + 'export { Route }', + ].join('\n'), + ctx: { + target: 'react', + routeId: '/new', + lazy: false, + }, + node: makeNode(), + }) + + expect(result.result).toBe('modified') + if (result.result !== 'modified') { + throw new Error(`expected modified result, got ${result.result}`) + } + expect(result.output).toContain("createFileRoute('/new')") + }) + + it('returns an error for multiple exported route calls', async () => { + const result = await transform({ + source: [ + "import { createFileRoute } from '@tanstack/react-router'", + '', + "export const Route = createFileRoute('/a')({})", + '', + "const AltRoute = createFileRoute('/b')({})", + 'export { AltRoute as Route }', + ].join('\n'), + ctx: { + target: 'react', + routeId: '/new', + lazy: false, + }, + node: makeNode(), + }) + + expect(result.result).toBe('error') + if (result.result !== 'error') { + throw new Error(`expected error result, got ${result.result}`) + } + expect(String(result.error)).toContain( + 'expected exactly one createFileRoute/createLazyFileRoute call', + ) + }) + + it('prepends a new import when no target-module import exists', async () => { + const result = await transform({ + source: [ + "import { useState } from 'react'", + '', + "export const Route = createFileRoute('/old')({})", + ].join('\n'), + ctx: { + target: 'react', + routeId: '/new', + lazy: false, + }, + node: makeNode(), + }) + + expect(result.result).toBe('modified') + if (result.result !== 'modified') { + throw new Error(`expected modified result, got ${result.result}`) + } + expect(result.output).toBe( + [ + "import { createFileRoute } from '@tanstack/react-router'", + "import { useState } from 'react'", + '', + "export const Route = createFileRoute('/new')({})", + ].join('\n'), + ) + }) + + it('returns not-modified for a non-route-constructor call', async () => { + const result = await transform({ + source: [ + "import { createFileRoute } from '@tanstack/react-router'", + '', + 'export const Route = someOtherFactory()({})', + ].join('\n'), + ctx: { + target: 'react', + routeId: '/test', + lazy: false, + }, + node: makeNode(), + }) + + expect(result.result).toBe('not-modified') + }) + + it('preserves semicolons in normalized imports', async () => { + const result = await transform({ + source: [ + "import { createLazyFileRoute } from '@tanstack/react-router';", + '', + "export const Route = createLazyFileRoute('/old')({});", + ].join('\n'), + ctx: { + target: 'react', + routeId: '/new', + lazy: false, + }, + node: makeNode(), + }) + + expect(result.result).toBe('modified') + if (result.result !== 'modified') { + throw new Error(`expected modified result, got ${result.result}`) + } + expect(result.output).toContain( + "import { createFileRoute } from '@tanstack/react-router';", + ) + expect(result.output).not.toContain('createLazyFileRoute') + }) + + it('preserves type import specifiers when normalizing route imports', async () => { + const result = await transform({ + source: [ + "import { type LinkProps, createLazyFileRoute } from '@tanstack/react-router'", + '', + "export const Route = createLazyFileRoute('/old')({})", + ].join('\n'), + ctx: { + target: 'react', + routeId: '/new', + lazy: false, + }, + node: makeNode(), + }) + + expect(result.result).toBe('modified') + if (result.result !== 'modified') { + throw new Error(`expected modified result, got ${result.result}`) + } + expect(result.output).toContain( + "import { type LinkProps, createFileRoute } from '@tanstack/react-router'", + ) + expect(result.output).not.toContain('createLazyFileRoute') + }) +}) diff --git a/packages/router-generator/tests/utils.test.ts b/packages/router-generator/tests/utils.test.ts index b52bcbba31..0cdce3cfae 100644 --- a/packages/router-generator/tests/utils.test.ts +++ b/packages/router-generator/tests/utils.test.ts @@ -2,6 +2,10 @@ import { describe, expect, it, vi } from 'vitest' import { RoutePrefixMap, cleanPath, + createLiteralRoutePathSegmentMetadata, + createRoutePathSegmentMetadata, + createRouteNodesByFullPath, + createRouteNodesByTo, determineInitialRoutePath, hasEscapedLeadingUnderscore, hasEscapedTrailingUnderscore, @@ -10,6 +14,7 @@ import { mergeImportDeclarations, multiSortBy, removeExt, + removeLayoutSegmentsAndUnderscoresWithEscape, removeLayoutSegmentsWithEscape, removeLeadingUnderscores, removeTrailingUnderscores, @@ -37,6 +42,169 @@ describe('inferFullPath', () => { // This avoids inferred fullPath "" which breaks match.fullPath unions expect(inferFullPath(node)).toBe('/') }) + + it('preserves escaped leading underscores after removing pathless ancestors', () => { + const node = { + routePath: '/_layout/_foo', + originalRoutePath: '/_layout/[_]foo', + } as unknown as RouteNode + + expect(inferFullPath(node)).toBe('/_foo') + }) + + it('preserves multiple escaped leading underscores after removing pathless ancestors', () => { + const node = { + routePath: '/_layout/__foo', + originalRoutePath: '/_layout/[__foo]', + } as unknown as RouteNode + + expect(inferFullPath(node)).toBe('/__foo') + }) + + it('preserves explicit literal leading underscores on index routes after removing pathless ancestors', () => { + const parent = { + routePath: '/_layout', + } as unknown as RouteNode + const node = { + routePath: '/_layout/_nested/', + originalRoutePath: '/_layout/_nested/', + _routePathSegmentMetadata: createLiteralRoutePathSegmentMetadata( + '/_layout/_nested', + parent, + true, + ), + } as unknown as RouteNode + + expect(inferFullPath(node)).toBe('/_nested/') + }) + + it('removes pathless index route segments when they are not marked literal', () => { + const node = { + routePath: '/_layout/_nested/', + originalRoutePath: '/_layout/_nested/', + } as unknown as RouteNode + + expect(inferFullPath(node)).toBe('/') + }) + + it('preserves escaped trailing underscores on index routes', () => { + const node = { + routePath: '/_layout/foo_/', + originalRoutePath: '/_layout/foo[_]/', + _routePathSegmentMetadata: createRoutePathSegmentMetadata( + '/_layout/foo_/', + '/_layout/foo[_]/', + ), + } as unknown as RouteNode + + expect(inferFullPath(node)).toBe('/foo_/') + }) + + it('removes unescaped trailing underscores on index routes', () => { + const node = { + routePath: '/_layout/foo_/', + originalRoutePath: '/_layout/foo_/', + } as unknown as RouteNode + + expect(inferFullPath(node)).toBe('/foo/') + }) +}) + +describe('createRoutePathSegmentMetadata', () => { + it('preserves escaped trailing underscores on index routes', () => { + const metadata = createRoutePathSegmentMetadata('/foo_/', '/foo[_]/') + + expect(metadata).toHaveLength(3) + expect(metadata?.[1]).toEqual({ literalTrailingUnderscore: true }) + }) + + it('preserves mixed escaped leading and trailing underscores', () => { + const metadata = createRoutePathSegmentMetadata('/_foo_/', '/[_]foo[_]/') + + expect(metadata).toHaveLength(3) + expect(metadata?.[1]).toEqual({ + literalLeadingUnderscore: true, + literalTrailingUnderscore: true, + }) + }) + + it('tracks multiple literal underscore segments independently', () => { + const metadata = createRoutePathSegmentMetadata( + '/_foo/bar_/_baz_/', + '/[_]foo/bar[_]/[_baz_]/', + ) + + expect(metadata).toHaveLength(5) + expect(metadata?.[1]).toEqual({ literalLeadingUnderscore: true }) + expect(metadata?.[2]).toEqual({ literalTrailingUnderscore: true }) + expect(metadata?.[3]).toEqual({ + literalLeadingUnderscore: true, + literalTrailingUnderscore: true, + }) + }) +}) + +describe('createRouteNodesByTo', () => { + const createRoute = ( + overrides: Partial<RouteNode> & { routePath: string }, + ): RouteNode => ({ + filePath: 'test.tsx', + fullPath: overrides.routePath, + variableName: 'Test', + _fsRouteType: 'static', + cleanedPath: overrides.routePath.endsWith('/') + ? '/' + : overrides.routePath.split('/').at(-1), + ...overrides, + }) + + it('prefers index routes over pathless layouts for duplicate public to paths', () => { + const pathlessRoute = createRoute({ + routePath: '/livestock/$farmId/medicine/_form', + _fsRouteType: 'pathless_layout', + variableName: 'Pathless', + }) + const indexRoute = createRoute({ + routePath: '/livestock/$farmId/medicine/', + cleanedPath: '/', + variableName: 'Index', + }) + + const map = createRouteNodesByTo([pathlessRoute, indexRoute]) + + expect(map.get('/livestock/$farmId/medicine')).toBe(indexRoute) + }) +}) + +describe('createRouteNodesByFullPath', () => { + const createRoute = ( + overrides: Partial<RouteNode> & { routePath: string }, + ): RouteNode => ({ + filePath: 'test.tsx', + fullPath: overrides.routePath, + variableName: 'Test', + _fsRouteType: 'static', + cleanedPath: overrides.routePath.endsWith('/') + ? '/' + : overrides.routePath.split('/').at(-1), + ...overrides, + }) + + it('prefers concrete routes over pathless layouts for duplicate full paths', () => { + const concreteRoute = createRoute({ + routePath: '/livestock/$farmId/medicine', + variableName: 'Concrete', + }) + const pathlessRoute = createRoute({ + routePath: '/livestock/$farmId/medicine/_form', + _fsRouteType: 'pathless_layout', + variableName: 'Pathless', + }) + + const map = createRouteNodesByFullPath([concreteRoute, pathlessRoute]) + + expect(map.get('/livestock/$farmId/medicine')).toBe(concreteRoute) + }) }) describe('determineInitialRoutePath', () => { @@ -350,6 +518,7 @@ describe('hasEscapedLeadingUnderscore', () => { it('returns true for fully escaped segment starting with underscore', () => { expect(hasEscapedLeadingUnderscore('[_layout]')).toBe(true) expect(hasEscapedLeadingUnderscore('[_foo]')).toBe(true) + expect(hasEscapedLeadingUnderscore('[__foo]')).toBe(true) expect(hasEscapedLeadingUnderscore('[_1nd3x]')).toBe(true) expect(hasEscapedLeadingUnderscore('[_]')).toBe(true) }) @@ -381,6 +550,7 @@ describe('hasEscapedTrailingUnderscore', () => { it('returns true for fully escaped segment ending with underscore', () => { expect(hasEscapedTrailingUnderscore('[blog_]')).toBe(true) expect(hasEscapedTrailingUnderscore('[foo_]')).toBe(true) + expect(hasEscapedTrailingUnderscore('[foo__]')).toBe(true) expect(hasEscapedTrailingUnderscore('[_r0ut3_]')).toBe(true) expect(hasEscapedTrailingUnderscore('[_]')).toBe(true) }) @@ -415,6 +585,7 @@ describe('isSegmentPathless', () => { it('returns false for fully escaped segment', () => { expect(isSegmentPathless('_layout', '[_layout]')).toBe(false) + expect(isSegmentPathless('__layout', '[__layout]')).toBe(false) expect(isSegmentPathless('_1nd3x', '[_1nd3x]')).toBe(false) }) @@ -533,6 +704,69 @@ describe('removeLayoutSegmentsWithEscape', () => { }) }) +describe('removeLayoutSegmentsAndUnderscoresWithEscape', () => { + it('removes layout segments and preserves escaped underscores in remaining segments', () => { + expect( + removeLayoutSegmentsAndUnderscoresWithEscape( + '/_layout/_foo', + '/_layout/[_]foo', + ), + ).toBe('/_foo') + }) + + it('removes multiple layout segments before escaped underscores', () => { + expect( + removeLayoutSegmentsAndUnderscoresWithEscape( + '/_layout/_nested/_foo', + '/_layout/_nested/[_]foo', + ), + ).toBe('/_foo') + }) + + it('preserves multiple escaped leading underscores in remaining segments', () => { + expect( + removeLayoutSegmentsAndUnderscoresWithEscape( + '/_layout/__foo', + '/_layout/[__foo]', + ), + ).toBe('/__foo') + + expect( + removeLayoutSegmentsAndUnderscoresWithEscape( + '/_layout/__foo', + '/_layout/[_][_]foo', + ), + ).toBe('/__foo') + }) + + it('removes non-escaped underscores from remaining segments', () => { + expect( + removeLayoutSegmentsAndUnderscoresWithEscape( + '/_layout/foo_/bar_', + '/_layout/foo_/bar_', + ), + ).toBe('/foo/bar') + }) + + it('preserves escaped trailing underscores after removing pathless ancestors', () => { + expect( + removeLayoutSegmentsAndUnderscoresWithEscape( + '/_layout/foo_/', + '/_layout/foo[_]/', + ), + ).toBe('/foo_/') + }) + + it('preserves mixed escaped leading and trailing underscores after removing pathless ancestors', () => { + expect( + removeLayoutSegmentsAndUnderscoresWithEscape( + '/_layout/_foo_/', + '/_layout/[_]foo[_]/', + ), + ).toBe('/_foo_/') + }) +}) + describe('routePathToVariable', () => { it.each([ ['/test/$/index', 'TestSplatIndex'], diff --git a/packages/router-plugin/CHANGELOG.md b/packages/router-plugin/CHANGELOG.md index 623c484af2..bc60cae7b2 100644 --- a/packages/router-plugin/CHANGELOG.md +++ b/packages/router-plugin/CHANGELOG.md @@ -1,5 +1,332 @@ # @tanstack/router-plugin +## 1.168.13 + +### Patch Changes + +- Updated dependencies [[`2f53749`](https://github.com/TanStack/router/commit/2f5374945e2138559a51464f45a5152eae67e1dd)]: + - @tanstack/router-core@1.171.8 + - @tanstack/react-router@1.170.10 + - @tanstack/router-generator@1.167.12 + +## 1.168.12 + +### Patch Changes + +- Updated dependencies [[`d1997b6`](https://github.com/TanStack/router/commit/d1997b66d7c24c1d64772bb8bab5caf9c6d9cc48)]: + - @tanstack/react-router@1.170.9 + - @tanstack/router-core@1.171.7 + - @tanstack/router-generator@1.167.11 + +## 1.168.11 + +### Patch Changes + +- Updated dependencies [[`51a97a1`](https://github.com/TanStack/router/commit/51a97a167fb3ef1b8ca70fbb63db635158f43509)]: + - @tanstack/router-core@1.171.6 + - @tanstack/react-router@1.170.8 + - @tanstack/router-generator@1.167.10 + +## 1.168.10 + +### Patch Changes + +- Updated dependencies [[`5268ba4`](https://github.com/TanStack/router/commit/5268ba4566233ea58880df85f167ad0401a93a46)]: + - @tanstack/router-core@1.171.5 + - @tanstack/react-router@1.170.7 + - @tanstack/router-generator@1.167.9 + +## 1.168.9 + +### Patch Changes + +- Updated dependencies [[`7df0d02`](https://github.com/TanStack/router/commit/7df0d02bfb1407b1f07731ef69af24e2f0e415d7)]: + - @tanstack/router-generator@1.167.8 + +## 1.168.8 + +### Patch Changes + +- Updated dependencies [[`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960), [`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960)]: + - @tanstack/router-core@1.171.4 + - @tanstack/react-router@1.170.6 + - @tanstack/router-generator@1.167.7 + +## 1.168.7 + +### Patch Changes + +- Update chokidar to v5. ([#7439](https://github.com/TanStack/router/pull/7439)) + +- Add deferred Hydrate boundary support for TanStack Start. ([#7362](https://github.com/TanStack/router/pull/7362)) + + Hydrate boundaries can now be code-split by the Start compiler, preload their generated client chunks, preserve server-rendered fallback HTML, and replay interaction-triggered events after hydration. The compiler integration now uses a Start-owned compiler plugin for Hydrate virtual modules across Vite and Rsbuild, with dev invalidation for generated virtual modules. + + Shared AST utilities used by the router code-splitter and Hydrate virtual modules were moved into `@tanstack/router-utils` so both pipelines can retain referenced top-level declarations, unwrap local exports, and let dead-code elimination remove unused route module code. + +- Updated dependencies [[`5fa9e55`](https://github.com/TanStack/router/commit/5fa9e555f3a2edb5e45586623e6bcbfa7f7c7a6b)]: + - @tanstack/router-core@1.171.3 + - @tanstack/router-utils@1.162.1 + - @tanstack/react-router@1.170.5 + - @tanstack/router-generator@1.167.6 + +## 1.168.6 + +### Patch Changes + +- Fix route mismatch warnings, HMR route index refresh, and generated route type preferences for duplicate pathless/index routes. ([#7422](https://github.com/TanStack/router/pull/7422)) + +- Updated dependencies [[`b60eb36`](https://github.com/TanStack/router/commit/b60eb36e59e8a468ee0742cbcf7f47aca1ff1c67)]: + - @tanstack/router-core@1.171.2 + - @tanstack/router-generator@1.167.5 + - @tanstack/react-router@1.170.4 + +## 1.168.5 + +### Patch Changes + +- Fix Vite Fast Refresh detection for root routes created with `createRootRouteWithContext` type arguments. ([#7420](https://github.com/TanStack/router/pull/7420)) + +## 1.168.4 + +### Patch Changes + +- Updated dependencies [[`d9cf933`](https://github.com/TanStack/router/commit/d9cf9331b83fcbd2abfee75d839d862f9bb18e6b)]: + - @tanstack/router-core@1.171.1 + - @tanstack/react-router@1.170.3 + - @tanstack/router-generator@1.167.4 + +## 1.168.3 + +### Patch Changes + +- Updated dependencies [[`d533f87`](https://github.com/TanStack/router/commit/d533f87976704098a40b48f160b37c28c8182806)]: + - @tanstack/router-core@1.171.0 + - @tanstack/react-router@1.170.2 + - @tanstack/router-generator@1.167.3 + +## 1.168.2 + +### Patch Changes + +- Updated dependencies [[`742941e`](https://github.com/TanStack/router/commit/742941e2f1bf069c950d0a4985b2cd733639509e)]: + - @tanstack/router-generator@1.167.2 + +## 1.168.1 + +### Patch Changes + +- Updated dependencies [[`2387a2e`](https://github.com/TanStack/router/commit/2387a2eea0683004cc400b9f71bed5944eb60110)]: + - @tanstack/router-core@1.170.1 + - @tanstack/react-router@1.170.1 + - @tanstack/router-generator@1.167.1 + +## 1.168.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- Updated dependencies [[`b1c061a`](https://github.com/TanStack/router/commit/b1c061aff9185cdf5fdc08c0136382a9dce0302f), [`038cd12`](https://github.com/TanStack/router/commit/038cd123b70bc6154d75abb6404a744c376f8f6a), [`201e150`](https://github.com/TanStack/router/commit/201e150bd1412bae2faa9ce53f0fefcb7574ac14)]: + - @tanstack/router-core@1.170.0 + - @tanstack/router-generator@1.167.0 + - @tanstack/react-router@1.170.0 + - @tanstack/router-utils@1.162.0 + - @tanstack/virtual-file-routes@1.162.0 + +## 1.167.35 + +### Patch Changes + +- Updated dependencies [[`c5811aa`](https://github.com/TanStack/router/commit/c5811aacb59b69a8179f14cd9529a51b2206d504)]: + - @tanstack/router-generator@1.166.42 + +## 1.167.34 + +### Patch Changes + +- Updated dependencies [[`35e88f0`](https://github.com/TanStack/router/commit/35e88f04996d71019a1868b7b06ecb4ddbc9df9e)]: + - @tanstack/router-core@1.169.2 + - @tanstack/react-router@1.169.2 + - @tanstack/router-generator@1.166.41 + +## 1.167.33 + +### Patch Changes + +- Parse plain TypeScript files without JSX when a filename is available, preventing angle-bracket type assertions from being interpreted as JSX during route and Start import-protection transforms. ([#7342](https://github.com/TanStack/router/pull/7342)) + +- Updated dependencies [[`056337e`](https://github.com/TanStack/router/commit/056337ef02ccbeaf45ec8533a227761be869e8f3)]: + - @tanstack/router-generator@1.166.40 + - @tanstack/router-utils@1.161.8 + +## 1.167.32 + +### Patch Changes + +- Replace global route metadata with explicit router plugin contexts so multiple router plugin instances cannot cross-transform route files. ([#7313](https://github.com/TanStack/router/pull/7313)) + +## 1.167.31 + +### Patch Changes + +- Updated dependencies [[`4a1e63f`](https://github.com/TanStack/router/commit/4a1e63f1d1230b1ed8234609acad4639d8982c13)]: + - @tanstack/router-core@1.169.1 + - @tanstack/react-router@1.169.1 + - @tanstack/router-generator@1.166.39 + +## 1.167.30 + +### Patch Changes + +- Updated dependencies [[`c992495`](https://github.com/TanStack/router/commit/c992495bf4010ff4c3597bb1f3b1ba02594e857e)]: + - @tanstack/router-core@1.169.0 + - @tanstack/react-router@1.169.0 + - @tanstack/router-generator@1.166.38 + +## 1.167.29 + +### Patch Changes + +- Updated dependencies [[`b5c4183`](https://github.com/TanStack/router/commit/b5c4183ab8b44be8a75647b7f7b588ad7c146ece)]: + - @tanstack/router-core@1.168.18 + - @tanstack/react-router@1.168.26 + - @tanstack/router-generator@1.166.37 + +## 1.167.28 + +### Patch Changes + +- Updated dependencies [[`493148b`](https://github.com/TanStack/router/commit/493148bc5378b7f9de1544d87f6aaa425c12eb34)]: + - @tanstack/router-core@1.168.17 + - @tanstack/react-router@1.168.25 + - @tanstack/router-generator@1.166.36 + +## 1.167.27 + +### Patch Changes + +- Updated dependencies [[`a2ad394`](https://github.com/TanStack/router/commit/a2ad394598e2079ab4050ebb16bb03b31d69c32a)]: + - @tanstack/router-generator@1.166.35 + +## 1.167.26 + +### Patch Changes + +- refactor(router-plugin): upgrade unplugin to `v3` ([#7258](https://github.com/TanStack/router/pull/7258)) + +## 1.167.25 + +### Patch Changes + +- Fix React route HMR for webpack and rspack so it no longer imports `react-refresh/runtime`, avoiding failures when that optional dependency is not installed. ([#7255](https://github.com/TanStack/router/pull/7255)) + +## 1.167.24 + +### Patch Changes + +- Updated dependencies [[`4d864ee`](https://github.com/TanStack/router/commit/4d864eebbd184265eabb563d326ab409c93feb17)]: + - @tanstack/react-router@1.168.24 + - @tanstack/router-core@1.168.16 + - @tanstack/router-generator@1.166.34 + +## 1.167.23 + +### Patch Changes + +- rsbuild ([#7228](https://github.com/TanStack/router/pull/7228)) + +- Updated dependencies [[`91a7089`](https://github.com/TanStack/router/commit/91a708989d00537a21911e74ff60bbfec8266295)]: + - @tanstack/router-utils@1.161.7 + - @tanstack/router-generator@1.166.33 + +## 1.167.22 + +### Patch Changes + +- Updated dependencies [[`16f6892`](https://github.com/TanStack/router/commit/16f6892d6b7ceadf606677c5a40e743f29163aa6)]: + - @tanstack/router-core@1.168.15 + - @tanstack/react-router@1.168.21 + - @tanstack/router-generator@1.166.32 + +## 1.167.21 + +### Patch Changes + +- Updated dependencies [[`328d7e5`](https://github.com/TanStack/router/commit/328d7e5ebc6b8074242a07d68ccafafb83e37a0e)]: + - @tanstack/router-generator@1.166.31 + +## 1.167.20 + +### Patch Changes + +- fix: update vite-plugin-solid peer dependency to support version 3.0.0-0 ([#7170](https://github.com/TanStack/router/pull/7170)) + +## 1.167.19 + +### Patch Changes + +- Updated dependencies [[`105d056`](https://github.com/TanStack/router/commit/105d05691a247779a63e7b688aa1207cce619339)]: + - @tanstack/router-generator@1.166.30 + - @tanstack/react-router@1.168.19 + +## 1.167.18 + +### Patch Changes + +- add vite 8 to peer deps ([#7160](https://github.com/TanStack/router/pull/7160)) + +## 1.167.17 + +### Patch Changes + +- Updated dependencies [[`0e2c900`](https://github.com/TanStack/router/commit/0e2c9003c18ae07c09969189c028f277ea562a7a)]: + - @tanstack/router-core@1.168.14 + - @tanstack/react-router@1.168.18 + - @tanstack/router-generator@1.166.29 + +## 1.167.16 + +### Patch Changes + +- Updated dependencies [[`812792f`](https://github.com/TanStack/router/commit/812792fbda3caf97b300770855cf5641252f413b)]: + - @tanstack/router-core@1.168.13 + - @tanstack/react-router@1.168.17 + - @tanstack/router-generator@1.166.28 + +## 1.167.15 + +### Patch Changes + +- Updated dependencies [[`8ec9ca9`](https://github.com/TanStack/router/commit/8ec9ca97b472779de878c2a6510f21deb24d386c)]: + - @tanstack/router-core@1.168.12 + - @tanstack/react-router@1.168.16 + - @tanstack/router-generator@1.166.27 + +## 1.167.14 + +### Patch Changes + +- shorten internal non-minifiable store names for byte shaving ([#7152](https://github.com/TanStack/router/pull/7152)) + +- Updated dependencies [[`6355bb7`](https://github.com/TanStack/router/commit/6355bb75f7637ba77f06a923c18fdaf37720bb48)]: + - @tanstack/react-router@1.168.15 + - @tanstack/router-core@1.168.11 + - @tanstack/router-generator@1.166.26 + +## 1.167.13 + +### Patch Changes + +- migrate createStore > createAtom for simpler API ([#7150](https://github.com/TanStack/router/pull/7150)) + +- Updated dependencies [[`459057c`](https://github.com/TanStack/router/commit/459057cd2d90cff20d20e51d4964b0a8c950555e)]: + - @tanstack/react-router@1.168.14 + - @tanstack/router-core@1.168.10 + - @tanstack/router-generator@1.166.25 + ## 1.167.12 ### Patch Changes diff --git a/packages/router-plugin/bin/intent.js b/packages/router-plugin/bin/intent.js deleted file mode 100755 index 5b08532885..0000000000 --- a/packages/router-plugin/bin/intent.js +++ /dev/null @@ -1,25 +0,0 @@ -#!/usr/bin/env node -// Auto-generated by @tanstack/intent setup -// Exposes the intent end-user CLI for consumers of this library. -// Commit this file, then add to your package.json: -// "bin": { "intent": "./bin/intent.js" } -try { - await import('@tanstack/intent/intent-library') -} catch (e) { - const isModuleNotFound = - e?.code === 'ERR_MODULE_NOT_FOUND' || e?.code === 'MODULE_NOT_FOUND' - const missingIntentLibrary = - typeof e?.message === 'string' && e.message.includes('@tanstack/intent') - - if (isModuleNotFound && missingIntentLibrary) { - console.error('@tanstack/intent is not installed.') - console.error('') - console.error('Install it as a dev dependency:') - console.error(' npm add -D @tanstack/intent') - console.error('') - console.error('Or run directly:') - console.error(' npx @tanstack/intent@latest list') - process.exit(1) - } - throw e -} diff --git a/packages/router-plugin/package.json b/packages/router-plugin/package.json index 0da0b5928b..b92fb3c9a8 100644 --- a/packages/router-plugin/package.json +++ b/packages/router-plugin/package.json @@ -1,6 +1,6 @@ { "name": "@tanstack/router-plugin", - "version": "1.167.12", + "version": "1.168.13", "description": "Modern and scalable routing for React applications", "author": "Tanner Linsley", "license": "MIT", @@ -93,7 +93,17 @@ "default": "./dist/cjs/esbuild.cjs" } }, - "./package.json": "./package.json" + "./package.json": "./package.json", + "./context": { + "import": { + "types": "./dist/esm/context.d.ts", + "default": "./dist/esm/context.js" + }, + "require": { + "types": "./dist/cjs/context.d.cts", + "default": "./dist/cjs/context.cjs" + } + } }, "sideEffects": false, "files": [ @@ -117,21 +127,20 @@ "@tanstack/router-generator": "workspace:*", "@tanstack/router-utils": "workspace:*", "@tanstack/virtual-file-routes": "workspace:*", - "chokidar": "^3.6.0", - "unplugin": "^2.1.2", - "zod": "^3.24.2" + "chokidar": "^5.0.0", + "unplugin": "^3.0.0", + "zod": "^4.4.3" }, "devDependencies": { - "@tanstack/intent": "^0.0.14", "@types/babel__core": "^7.20.5", "@types/babel__template": "^7.4.4", "@types/babel__traverse": "^7.28.0", "@types/node": ">=20" }, "peerDependencies": { - "@rsbuild/core": ">=1.0.2", + "@rsbuild/core": ">=1.0.2 || ^2.0.0", "@tanstack/react-router": "workspace:^", - "vite": ">=5.0.0 || >=6.0.0 || >=7.0.0", + "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" }, @@ -151,8 +160,5 @@ "webpack": { "optional": true } - }, - "bin": { - "intent": "./bin/intent.js" } } diff --git a/packages/router-plugin/skills/router-plugin/SKILL.md b/packages/router-plugin/skills/router-plugin/SKILL.md index 3196bbc4a6..b3ba5db5a3 100644 --- a/packages/router-plugin/skills/router-plugin/SKILL.md +++ b/packages/router-plugin/skills/router-plugin/SKILL.md @@ -142,15 +142,14 @@ tanstackRouter({ ### Output Options -| Option | Type | Default | Description | -| --------------------------- | ---------------------- | ----------- | -------------------------------------------- | -| `quoteStyle` | `'single' \| 'double'` | `'single'` | Quote style in generated code | -| `semicolons` | `boolean` | `false` | Use semicolons in generated code | -| `disableTypes` | `boolean` | `false` | Disable TypeScript types | -| `disableLogging` | `boolean` | `false` | Suppress plugin logs | -| `addExtensions` | `boolean \| string` | `false` | Add file extensions to imports | -| `enableRouteTreeFormatting` | `boolean` | `true` | Format generated route tree | -| `verboseFileRoutes` | `boolean` | `undefined` | When `false`, auto-imports `createFileRoute` | +| Option | Type | Default | Description | +| --------------------------- | ---------------------- | ---------- | -------------------------------- | +| `quoteStyle` | `'single' \| 'double'` | `'single'` | Quote style in generated code | +| `semicolons` | `boolean` | `false` | Use semicolons in generated code | +| `disableTypes` | `boolean` | `false` | Disable TypeScript types | +| `disableLogging` | `boolean` | `false` | Suppress plugin logs | +| `addExtensions` | `boolean \| string` | `false` | Add file extensions to imports | +| `enableRouteTreeFormatting` | `boolean` | `true` | Format generated route tree | ### Virtual Route Config @@ -165,12 +164,11 @@ tanstackRouter({ ## How It Works -The composed plugin assembles up to 4 sub-plugins: +The composed plugin assembles up to 3 sub-plugins: 1. **Route Generator** (always) — Watches route files and generates `routeTree.gen.ts` 2. **Code Splitter** (when `autoCodeSplitting: true`) — Splits route files into lazy-loaded chunks using virtual modules -3. **Auto-Import** (when `verboseFileRoutes: false`) — Auto-injects `createFileRoute` imports -4. **HMR** (dev mode, when code splitter is off) — Hot-reloads route changes without full refresh +3. **HMR** (dev mode, when code splitter is off) — Hot-reloads route changes without full refresh ## Individual Plugin Exports @@ -181,7 +179,6 @@ import { tanstackRouter, // Composed (default) tanstackRouterGenerator, // Generator only tanStackRouterCodeSplitter, // Code splitter only - tanstackRouterAutoImport, // Auto-import only } from '@tanstack/router-plugin/vite' ``` diff --git a/packages/router-plugin/src/context.ts b/packages/router-plugin/src/context.ts new file mode 100644 index 0000000000..fdf97fe94d --- /dev/null +++ b/packages/router-plugin/src/context.ts @@ -0,0 +1,2 @@ +export { createRouterPluginContext } from './core/router-plugin-context' +export type { RouterPluginContext } from './core/router-plugin-context' diff --git a/packages/router-plugin/src/core/code-splitter/compilers.ts b/packages/router-plugin/src/core/code-splitter/compilers.ts index 5d5053b12f..32eade99af 100644 --- a/packages/router-plugin/src/core/code-splitter/compilers.ts +++ b/packages/router-plugin/src/core/code-splitter/compilers.ts @@ -2,15 +2,27 @@ import * as t from '@babel/types' import * as babel from '@babel/core' import * as template from '@babel/template' import { + buildDeclarationMap, + buildDependencyGraph, + collectIdentifiersFromPattern, + collectLocalBindingsFromStatement, + collectModuleLevelRefsFromNode, + createIdentifier, deadCodeElimination, + expandDestructuredDeclarations, + expandSharedDestructuredDeclarators, + expandTransitively, findReferencedIdentifiers, generateFromAst, parseAst, + removeBindingsTransitivelyDependingOn, + retainModuleLevelDeclarations, + stripUnreferencedTopLevelExpressionStatements, + unwrapExportedDeclarations, } from '@tanstack/router-utils' import { tsrShared, tsrSplit } from '../constants' -import { createRouteHmrStatement } from '../route-hmr-statement' +import { createRouteHmrStatement } from '../hmr' import { getObjectPropertyKeyName } from '../utils' -import { createIdentifier } from './path-ids' import { getFrameworkOptions } from './framework-options' import type { CompileCodeSplitReferenceRouteOptions, @@ -18,9 +30,27 @@ import type { } from './plugins' import type { GeneratorResult, ParseAstOptions } from '@tanstack/router-utils' import type { CodeSplitGroupings, SplitRouteIdentNodes } from '../constants' -import type { Config, DeletableNodes } from '../config' import type { SplitNodeMeta } from './types' +export { + buildDeclarationMap, + buildDependencyGraph, + collectIdentifiersFromNode, + collectLocalBindingsFromStatement, + collectModuleLevelRefsFromNode, + expandDestructuredDeclarations, + expandSharedDestructuredDeclarators, + expandTransitively, + removeBindingsTransitivelyDependingOn, +} from '@tanstack/router-utils' + +export function removeBindingsDependingOnRoute( + bindings: Set<string>, + dependencyGraph: Map<string, Set<string>>, +) { + removeBindingsTransitivelyDependingOn(bindings, dependencyGraph, ['Route']) +} + const SPLIT_NODES_CONFIG = new Map<SplitRouteIdentNodes, SplitNodeMeta>([ [ 'loader', @@ -109,124 +139,6 @@ const allCreateRouteFns = [ ...unsplittableCreateRouteFns, ] -/** - * Recursively walk an AST node and collect referenced identifier-like names. - * Much cheaper than babel.traverse — no path/scope overhead. - * - * Notes: - * - Uses @babel/types `isReferenced` to avoid collecting non-references like - * object keys, member expression properties, or binding identifiers. - * - Also handles JSX identifiers for component references. - */ -export function collectIdentifiersFromNode(node: t.Node): Set<string> { - const ids = new Set<string>() - - ;(function walk( - n: t.Node | null | undefined, - parent?: t.Node, - grandparent?: t.Node, - parentKey?: string, - ) { - if (!n) return - - if (t.isIdentifier(n)) { - // When we don't have parent info (node passed in isolation), treat as referenced. - if (!parent || t.isReferenced(n, parent, grandparent)) { - ids.add(n.name) - } - return - } - - if (t.isJSXIdentifier(n)) { - // Skip attribute names: <div data-testid="x" /> - if (parent && t.isJSXAttribute(parent) && parentKey === 'name') { - return - } - - // Skip member properties: <Foo.Bar /> should count Foo, not Bar - if ( - parent && - t.isJSXMemberExpression(parent) && - parentKey === 'property' - ) { - return - } - - // Intrinsic elements (lowercase) are not identifiers - const first = n.name[0] - if (first && first === first.toLowerCase()) { - return - } - - ids.add(n.name) - return - } - - for (const key of t.VISITOR_KEYS[n.type] || []) { - const child = (n as any)[key] - if (Array.isArray(child)) { - for (const c of child) { - if (c && typeof c.type === 'string') { - walk(c, n, parent, key) - } - } - } else if (child && typeof child.type === 'string') { - walk(child, n, parent, key) - } - } - })(node) - - return ids -} - -/** - * Build a map from binding name → declaration AST node for all - * locally-declared module-level bindings. Built once, O(1) lookup. - */ -export function buildDeclarationMap(ast: t.File): Map<string, t.Node> { - const map = new Map<string, t.Node>() - for (const stmt of ast.program.body) { - const decl = - t.isExportNamedDeclaration(stmt) && stmt.declaration - ? stmt.declaration - : stmt - - if (t.isVariableDeclaration(decl)) { - for (const declarator of decl.declarations) { - for (const name of collectIdentifiersFromPattern(declarator.id)) { - map.set(name, declarator) - } - } - } else if (t.isFunctionDeclaration(decl) && decl.id) { - map.set(decl.id.name, decl) - } else if (t.isClassDeclaration(decl) && decl.id) { - map.set(decl.id.name, decl) - } - } - return map -} - -/** - * Build a dependency graph: for each local binding, the set of other local - * bindings its declaration references. Built once via simple node walking. - */ -export function buildDependencyGraph( - declMap: Map<string, t.Node>, - localBindings: Set<string>, -): Map<string, Set<string>> { - const graph = new Map<string, Set<string>>() - for (const [name, declNode] of declMap) { - if (!localBindings.has(name)) continue - const allIds = collectIdentifiersFromNode(declNode) - const deps = new Set<string>() - for (const id of allIds) { - if (id !== name && localBindings.has(id)) deps.add(id) - } - graph.set(name, deps) - } - return graph -} - /** * Computes module-level bindings that are shared between split and non-split * route properties. These bindings need to be extracted into a shared virtual @@ -238,6 +150,7 @@ export function buildDependencyGraph( */ export function computeSharedBindings(opts: { code: string + filename?: string codeSplitGroupings: CodeSplitGroupings }): Set<string> { const ast = parseAst(opts) @@ -381,199 +294,11 @@ export function computeSharedBindings(opts: { // Remove shared bindings that transitively depend on `Route`. // The Route singleton must stay in the reference file; extracting a // binding that references it would duplicate Route in the shared module. - removeBindingsDependingOnRoute(shared, fullDepGraph) + removeBindingsTransitivelyDependingOn(shared, fullDepGraph, ['Route']) return shared } -/** - * If bindings from the same destructured declarator are referenced by - * different groups, mark all bindings from that declarator as shared. - */ -export function expandSharedDestructuredDeclarators( - ast: t.File, - refsByGroup: Map<string, Set<number>>, - shared: Set<string>, -) { - for (const stmt of ast.program.body) { - const decl = - t.isExportNamedDeclaration(stmt) && stmt.declaration - ? stmt.declaration - : stmt - - if (!t.isVariableDeclaration(decl)) continue - - for (const declarator of decl.declarations) { - if (!t.isObjectPattern(declarator.id) && !t.isArrayPattern(declarator.id)) - continue - - const names = collectIdentifiersFromPattern(declarator.id) - - const usedGroups = new Set<number>() - for (const name of names) { - const groups = refsByGroup.get(name) - if (!groups) continue - for (const g of groups) usedGroups.add(g) - } - - if (usedGroups.size >= 2) { - for (const name of names) { - shared.add(name) - } - } - } - } -} - -/** - * Collect locally-declared module-level binding names from a statement. - * Pure node inspection, no traversal. - */ -export function collectLocalBindingsFromStatement( - node: t.Statement | t.ModuleDeclaration, - bindings: Set<string>, -) { - const decl = - t.isExportNamedDeclaration(node) && node.declaration - ? node.declaration - : node - - if (t.isVariableDeclaration(decl)) { - for (const declarator of decl.declarations) { - for (const name of collectIdentifiersFromPattern(declarator.id)) { - bindings.add(name) - } - } - } else if (t.isFunctionDeclaration(decl) && decl.id) { - bindings.add(decl.id.name) - } else if (t.isClassDeclaration(decl) && decl.id) { - bindings.add(decl.id.name) - } -} - -/** - * Collect direct module-level binding names referenced from a given AST node. - * Uses a simple recursive walk instead of babel.traverse. - */ -export function collectModuleLevelRefsFromNode( - node: t.Node, - localModuleLevelBindings: Set<string>, -): Set<string> { - const allIds = collectIdentifiersFromNode(node) - const refs = new Set<string>() - for (const name of allIds) { - if (localModuleLevelBindings.has(name)) refs.add(name) - } - return refs -} - -/** - * Expand the shared set transitively using a prebuilt dependency graph. - * No AST traversals — pure graph BFS. - */ -export function expandTransitively( - shared: Set<string>, - depGraph: Map<string, Set<string>>, -) { - const queue = [...shared] - const visited = new Set<string>() - - while (queue.length > 0) { - const name = queue.pop()! - if (visited.has(name)) continue - visited.add(name) - - const deps = depGraph.get(name) - if (!deps) continue - - for (const dep of deps) { - if (!shared.has(dep)) { - shared.add(dep) - queue.push(dep) - } - } - } -} - -/** - * Remove any bindings from `shared` that transitively depend on `Route`. - * The Route singleton must remain in the reference file; if a shared binding - * references it (directly or transitively), extracting that binding would - * duplicate Route in the shared module. - * - * Uses `depGraph` which must include `Route` as a node so the dependency - * chain is visible. - */ -export function removeBindingsDependingOnRoute( - shared: Set<string>, - depGraph: Map<string, Set<string>>, -) { - const reverseGraph = new Map<string, Set<string>>() - for (const [name, deps] of depGraph) { - for (const dep of deps) { - let parents = reverseGraph.get(dep) - if (!parents) { - parents = new Set<string>() - reverseGraph.set(dep, parents) - } - parents.add(name) - } - } - - // Walk backwards from Route to find all bindings that can reach it. - const visited = new Set<string>() - const queue = ['Route'] - while (queue.length > 0) { - const cur = queue.pop()! - if (visited.has(cur)) continue - visited.add(cur) - - const parents = reverseGraph.get(cur) - if (!parents) continue - for (const parent of parents) { - if (!visited.has(parent)) queue.push(parent) - } - } - - for (const name of [...shared]) { - if (visited.has(name)) { - shared.delete(name) - } - } -} - -/** - * If any binding from a destructured declaration is shared, - * ensure all bindings from that same declaration are also shared. - * Pure node inspection of program.body, no traversal. - */ -export function expandDestructuredDeclarations( - ast: t.File, - shared: Set<string>, -) { - for (const stmt of ast.program.body) { - const decl = - t.isExportNamedDeclaration(stmt) && stmt.declaration - ? stmt.declaration - : stmt - - if (!t.isVariableDeclaration(decl)) continue - - for (const declarator of decl.declarations) { - if (!t.isObjectPattern(declarator.id) && !t.isArrayPattern(declarator.id)) - continue - - const names = collectIdentifiersFromPattern(declarator.id) - const hasShared = names.some((n) => shared.has(n)) - if (hasShared) { - for (const n of names) { - shared.add(n) - } - } - } - } -} - /** * Find which shared bindings are user-exported in the original source. * These need to be re-exported from the shared module. @@ -637,16 +362,10 @@ function removeSharedDeclarations(ast: t.File, sharedBindings: Set<string>) { } export function compileCodeSplitReferenceRoute( - opts: ParseAstOptions & { - codeSplitGroupings: CodeSplitGroupings - deleteNodes?: Set<DeletableNodes> - targetFramework: Config['target'] - filename: string - id: string - addHmr?: boolean - sharedBindings?: Set<string> - compilerPlugins?: Array<ReferenceRouteCompilerPlugin> - }, + opts: ParseAstOptions & + CompileCodeSplitReferenceRouteOptions & { + compilerPlugins?: Array<ReferenceRouteCompilerPlugin> + }, ): GeneratorResult | null { const ast = parseAst(opts) @@ -733,7 +452,11 @@ export function compileCodeSplitReferenceRoute( programPath.pushContainer( 'body', - createRouteHmrStatement(stableRouteOptionKeys), + createRouteHmrStatement(stableRouteOptionKeys, { + hmrStyle: opts.hmrStyle ?? 'vite', + targetFramework: opts.targetFramework, + routeId: opts.hmrRouteId, + }), ) modified = true hmrAdded = true @@ -742,6 +465,21 @@ export function compileCodeSplitReferenceRoute( if (t.isObjectExpression(routeOptions)) { const insertionPath = path.getStatementParent() ?? path + opts.compilerPlugins?.forEach((plugin) => { + const pluginResult = plugin.onRouteOptions?.({ + programPath, + callExpressionPath: path, + insertionPath, + routeOptions, + createRouteFn, + opts: opts as CompileCodeSplitReferenceRouteOptions, + }) + + if (pluginResult?.modified) { + modified = true + } + }) + if (opts.deleteNodes && opts.deleteNodes.size > 0) { routeOptions.properties = routeOptions.properties.filter( (prop) => { @@ -904,6 +642,7 @@ export function compileCodeSplitReferenceRoute( splitNodeMeta, lazyRouteComponentIdent: LAZY_ROUTE_COMPONENT_IDENT, + opts, }, ) @@ -1526,22 +1265,7 @@ export function compileCodeSplitVirtualRoute( }) deadCodeElimination(ast, refIdents) - - // Strip top-level expression statements that reference no locally-bound names. - // DCE only removes unused declarations; bare side-effect statements like - // `console.log(...)` survive even when the virtual file has no exports. - { - const locallyBound = new Set<string>() - for (const stmt of ast.program.body) { - collectLocalBindingsFromStatement(stmt, locallyBound) - } - ast.program.body = ast.program.body.filter((stmt) => { - if (!t.isExpressionStatement(stmt)) return true - const refs = collectIdentifiersFromNode(stmt) - // Keep if it references at least one locally-bound identifier - return [...refs].some((name) => locallyBound.has(name)) - }) - } + stripUnreferencedTopLevelExpressionStatements(ast) // If the body is empty after DCE, strip directive prologues too. // A file containing only `'use client'` with no real code is useless. @@ -1596,49 +1320,8 @@ export function compileCodeSplitSharedRoute( keepBindings.delete('Route') expandTransitively(keepBindings, depGraph) - // Remove all statements except: - // - Import declarations (needed for deps; DCE will clean unused ones) - // - Declarations of bindings in keepBindings - ast.program.body = ast.program.body.filter((stmt) => { - // Always keep imports — DCE will remove unused ones - if (t.isImportDeclaration(stmt)) return true - - const decl = - t.isExportNamedDeclaration(stmt) && stmt.declaration - ? stmt.declaration - : stmt - - if (t.isVariableDeclaration(decl)) { - // Keep declarators where at least one binding is in keepBindings - decl.declarations = decl.declarations.filter((declarator) => { - const names = collectIdentifiersFromPattern(declarator.id) - return names.some((n) => keepBindings.has(n)) - }) - if (decl.declarations.length === 0) return false - - // Strip the `export` wrapper — shared module controls its own exports - if (t.isExportNamedDeclaration(stmt) && stmt.declaration) { - return true // keep for now, we'll convert below - } - return true - } else if (t.isFunctionDeclaration(decl) && decl.id) { - return keepBindings.has(decl.id.name) - } else if (t.isClassDeclaration(decl) && decl.id) { - return keepBindings.has(decl.id.name) - } - - // Remove everything else (expression statements, other exports, etc.) - return false - }) - - // Convert `export const/function/class` to plain declarations - // (we'll add our own export statement at the end) - ast.program.body = ast.program.body.map((stmt) => { - if (t.isExportNamedDeclaration(stmt) && stmt.declaration) { - return stmt.declaration - } - return stmt - }) + retainModuleLevelDeclarations(ast, keepBindings) + unwrapExportedDeclarations(ast) // Export all shared bindings (sorted for deterministic output) const exportNames = [...opts.sharedBindings].sort((a, b) => @@ -1838,50 +1521,6 @@ function getImportSpecifierAndPathFromLocalName( return { specifier, path } } -/** - * Recursively collects all identifier names from a destructuring pattern - * (ObjectPattern, ArrayPattern, AssignmentPattern, RestElement). - */ -function collectIdentifiersFromPattern( - node: t.LVal | t.Node | null | undefined, -): Array<string> { - if (!node) { - return [] - } - - if (t.isIdentifier(node)) { - return [node.name] - } - - if (t.isAssignmentPattern(node)) { - return collectIdentifiersFromPattern(node.left) - } - - if (t.isRestElement(node)) { - return collectIdentifiersFromPattern(node.argument) - } - - if (t.isObjectPattern(node)) { - return node.properties.flatMap((prop) => { - if (t.isObjectProperty(prop)) { - return collectIdentifiersFromPattern(prop.value as t.LVal) - } - if (t.isRestElement(prop)) { - return collectIdentifiersFromPattern(prop.argument) - } - return [] - }) - } - - if (t.isArrayPattern(node)) { - return node.elements.flatMap((element) => - collectIdentifiersFromPattern(element), - ) - } - - return [] -} - // Reusable function to get literal value or resolve variable to literal function resolveIdentifier(path: any, node: any): t.Node | undefined { if (t.isIdentifier(node)) { diff --git a/packages/router-plugin/src/core/code-splitter/plugins.ts b/packages/router-plugin/src/core/code-splitter/plugins.ts index 841b20aea8..ebf1f4aa30 100644 --- a/packages/router-plugin/src/core/code-splitter/plugins.ts +++ b/packages/router-plugin/src/core/code-splitter/plugins.ts @@ -1,6 +1,6 @@ import type babel from '@babel/core' import type * as t from '@babel/types' -import type { Config, DeletableNodes } from '../config' +import type { Config, DeletableNodes, HmrStyle } from '../config' import type { CodeSplitGroupings } from '../constants' import type { SplitNodeMeta } from './types' @@ -11,6 +11,8 @@ export type CompileCodeSplitReferenceRouteOptions = { filename: string id: string addHmr?: boolean + hmrStyle?: HmrStyle + hmrRouteId?: string sharedBindings?: Set<string> } @@ -31,6 +33,7 @@ export type ReferenceRouteSplitPropertyCompilerPluginContext = { prop: t.ObjectProperty splitNodeMeta: SplitNodeMeta lazyRouteComponentIdent: string + opts: CompileCodeSplitReferenceRouteOptions } export type ReferenceRouteCompilerPluginResult = { @@ -40,6 +43,9 @@ export type ReferenceRouteCompilerPluginResult = { export type ReferenceRouteCompilerPlugin = { name: string getStableRouteOptionKeys?: () => Array<string> + onRouteOptions?: ( + ctx: ReferenceRouteCompilerPluginContext, + ) => void | ReferenceRouteCompilerPluginResult onAddHmr?: ( ctx: ReferenceRouteCompilerPluginContext, ) => void | ReferenceRouteCompilerPluginResult diff --git a/packages/router-plugin/src/core/code-splitter/plugins/framework-plugins.ts b/packages/router-plugin/src/core/code-splitter/plugins/framework-plugins.ts index 1ea299302f..de8195853a 100644 --- a/packages/router-plugin/src/core/code-splitter/plugins/framework-plugins.ts +++ b/packages/router-plugin/src/core/code-splitter/plugins/framework-plugins.ts @@ -2,19 +2,23 @@ import { createReactRefreshIgnoredRouteExportsPlugin } from './react-refresh-ign import { createReactRefreshRouteComponentsPlugin } from './react-refresh-route-components' import { createReactStableHmrSplitRouteComponentsPlugin } from './react-stable-hmr-split-route-components' import type { ReferenceRouteCompilerPlugin } from '../plugins' -import type { Config } from '../../config' +import type { Config, HmrStyle } from '../../config' export function getReferenceRouteCompilerPlugins(opts: { targetFramework: Config['target'] addHmr?: boolean + hmrStyle?: HmrStyle }): Array<ReferenceRouteCompilerPlugin> | undefined { switch (opts.targetFramework) { case 'react': { if (opts.addHmr) { + const hmrStyle = opts.hmrStyle ?? 'vite' return [ - createReactRefreshIgnoredRouteExportsPlugin(), + ...(hmrStyle === 'vite' + ? [createReactRefreshIgnoredRouteExportsPlugin()] + : []), createReactRefreshRouteComponentsPlugin(), - createReactStableHmrSplitRouteComponentsPlugin(), + createReactStableHmrSplitRouteComponentsPlugin({ hmrStyle }), ] } return undefined diff --git a/packages/router-plugin/src/core/code-splitter/plugins/react-refresh-ignored-route-exports.ts b/packages/router-plugin/src/core/code-splitter/plugins/react-refresh-ignored-route-exports.ts index 1bcfc00bbc..cc2be62034 100644 --- a/packages/router-plugin/src/core/code-splitter/plugins/react-refresh-ignored-route-exports.ts +++ b/packages/router-plugin/src/core/code-splitter/plugins/react-refresh-ignored-route-exports.ts @@ -3,9 +3,11 @@ import * as t from '@babel/types' import { getUniqueProgramIdentifier } from '../../utils' import type { ReferenceRouteCompilerPlugin } from '../plugins' -const buildReactRefreshIgnoredRouteExportsStatement = template.statement( +const buildReactRefreshIgnoredRouteExportsStatements = template.statements( ` -if (import.meta.hot && typeof window !== 'undefined') { +const hot = import.meta.hot +if (hot && typeof window !== 'undefined') { + hot.data ??= {} const tsrReactRefresh = window.__TSR_REACT_REFRESH__ ??= (() => { const ignoredExportsById = new Map() const previousGetIgnoredExports = window.__getReactRefreshIgnoredExports @@ -49,7 +51,7 @@ export function createReactRefreshIgnoredRouteExportsPlugin(): ReferenceRouteCom ctx.programPath.pushContainer( 'body', - buildReactRefreshIgnoredRouteExportsStatement({ + buildReactRefreshIgnoredRouteExportsStatements({ moduleId: t.stringLiteral(ctx.opts.id), }), ) diff --git a/packages/router-plugin/src/core/code-splitter/plugins/react-stable-hmr-split-route-components.ts b/packages/router-plugin/src/core/code-splitter/plugins/react-stable-hmr-split-route-components.ts index af05d48b31..99448f452a 100644 --- a/packages/router-plugin/src/core/code-splitter/plugins/react-stable-hmr-split-route-components.ts +++ b/packages/router-plugin/src/core/code-splitter/plugins/react-stable-hmr-split-route-components.ts @@ -1,6 +1,7 @@ import * as template from '@babel/template' import * as t from '@babel/types' import { getUniqueProgramIdentifier } from '../../utils' +import type { HmrStyle } from '../../config' import type { ReferenceRouteCompilerPlugin } from '../plugins' function capitalizeIdentifier(str: string) { @@ -13,10 +14,13 @@ function createHotDataKey(exportName: string) { const buildStableSplitComponentStatements = template.statements( ` - const %%stableComponentIdent%% = import.meta.hot?.data?.[%%hotDataKey%%] ?? %%lazyRouteComponentIdent%%(%%localImporterIdent%%, %%exporterIdent%%) - if (import.meta.hot) { - import.meta.hot.data ??= {} - import.meta.hot.data[%%hotDataKey%%] = %%stableComponentIdent%% + const %%stableComponentIdent%% = (() => { + const hot = %%hotExpression%% + const hotData = hot ? (hot.data ??= {}) : undefined + return hotData?.[%%hotDataKey%%] ?? %%lazyRouteComponentIdent%%(%%localImporterIdent%%, %%exporterIdent%%) + })() + if (%%hotExpression%%) { + ((%%hotExpression%%).data ??= {})[%%hotDataKey%%] = %%stableComponentIdent%% } `, { @@ -24,7 +28,15 @@ const buildStableSplitComponentStatements = template.statements( }, ) -export function createReactStableHmrSplitRouteComponentsPlugin(): ReferenceRouteCompilerPlugin { +function hotExpressionAstFor(hmrStyle: HmrStyle): t.Expression { + return template.expression.ast( + hmrStyle === 'webpack' ? 'import.meta.webpackHot' : 'import.meta.hot', + ) +} + +export function createReactStableHmrSplitRouteComponentsPlugin(opts: { + hmrStyle: HmrStyle +}): ReferenceRouteCompilerPlugin { return { name: 'react-stable-hmr-split-route-components', onSplitRouteProperty(ctx) { @@ -43,6 +55,7 @@ export function createReactStableHmrSplitRouteComponentsPlugin(): ReferenceRoute buildStableSplitComponentStatements({ stableComponentIdent, hotDataKey: t.stringLiteral(hotDataKey), + hotExpression: hotExpressionAstFor(opts.hmrStyle), lazyRouteComponentIdent: t.identifier(ctx.lazyRouteComponentIdent), localImporterIdent: t.identifier( ctx.splitNodeMeta.localImporterIdent, diff --git a/packages/router-plugin/src/core/config.ts b/packages/router-plugin/src/core/config.ts index f93166d392..c0b47b9ef5 100644 --- a/packages/router-plugin/src/core/config.ts +++ b/packages/router-plugin/src/core/config.ts @@ -9,6 +9,7 @@ import type { RouteIds, } from '@tanstack/router-core' import type { CodeSplitGroupings } from './constants' +import type { ReferenceRouteCompilerPlugin } from './code-splitter/plugins' export const splitGroupingsSchema = z .array( @@ -70,10 +71,33 @@ export type CodeSplittingOptions = { * @default true */ addHmr?: boolean + + /** + * Internal compiler plugins used by framework integrations. + * @internal + */ + compilerPlugins?: Array<ReferenceRouteCompilerPlugin> +} + +export type HmrStyle = 'vite' | 'webpack' + +export type HmrOptions = { + /** + * Selects the HMR runtime style to emit code for. + * - `'vite'` (default): ESM `import.meta.hot` with Vite accept-callback semantics. + * - `'webpack'`: `import.meta.webpackHot` with webpack / Rspack `module.hot` re-execution semantics. + * + * Bundler-specific plugin entries (e.g. `rspack.ts`, `webpack.ts`) set this explicitly. + */ + style?: HmrStyle } const codeSplittingOptionsSchema = z.object({ - splitBehavior: z.function().optional(), + splitBehavior: z + .custom< + CodeSplittingOptions['splitBehavior'] + >((value) => typeof value === 'function') + .optional(), defaultBehavior: splitGroupingsSchema.optional(), deleteNodes: z.array(z.string()).optional(), addHmr: z.boolean().optional().default(true), @@ -93,6 +117,11 @@ export const configSchema = generatorConfigSchema.extend({ .optional(), plugin: z .object({ + hmr: z + .object({ + style: z.enum(['vite', 'webpack']).optional(), + }) + .optional(), vite: z .object({ environmentName: z.string().optional(), diff --git a/packages/router-plugin/src/core/hmr/handle-route-update.ts b/packages/router-plugin/src/core/hmr/handle-route-update.ts new file mode 100644 index 0000000000..7ca534c31c --- /dev/null +++ b/packages/router-plugin/src/core/hmr/handle-route-update.ts @@ -0,0 +1,230 @@ +import type { + AnyRoute, + AnyRouteMatch, + AnyRouter, + RouterWritableStore, +} from '@tanstack/router-core' + +type AnyRouteWithPrivateProps = AnyRoute & { + options: Record<string, unknown> + _componentsPromise?: Promise<void> + _lazyPromise?: Promise<void> + update: (options: Record<string, unknown>) => unknown + _path: string + _id: string + _fullPath: string + _to: string +} + +type AnyRouterWithPrivateMaps = AnyRouter & { + routesById: Record<string, AnyRoute> + buildRouteTree: () => Parameters<AnyRouter['setRoutes']>[0] + setRoutes: AnyRouter['setRoutes'] + stores: AnyRouter['stores'] & { + cachedMatchStores: Map< + string, + Pick<RouterWritableStore<AnyRouteMatch>, 'get' | 'set'> + > + pendingMatchStores: Map< + string, + Pick<RouterWritableStore<AnyRouteMatch>, 'get' | 'set'> + > + matchStores: Map< + string, + Pick<RouterWritableStore<AnyRouteMatch>, 'get' | 'set'> + > + } +} + +type AnyRouteMatchWithPrivateProps = AnyRouteMatch & { + __beforeLoadContext?: unknown + __routeContext?: Record<string, unknown> + context?: Record<string, unknown> +} + +function handleRouteUpdate( + routeId: string, + newRoute: AnyRouteWithPrivateProps, +) { + const router = window.__TSR_ROUTER__ as AnyRouterWithPrivateMaps + const oldRoute = router.routesById[routeId] as + | AnyRouteWithPrivateProps + | undefined + + if (!oldRoute) { + return + } + + // Generated route-tree options are not present on the freshly imported route + // module, but they must stay on the live route before rebuilding indexes. + const generatedRouteOptionKeys = new Set(['id', 'path', 'getParentRoute']) + const generatedRouteOptions: Record<string, unknown> = {} + generatedRouteOptionKeys.forEach((key) => { + if (key in oldRoute.options) { + generatedRouteOptions[key] = oldRoute.options[key] + } + }) + + const removedKeys = new Set<string>() + Object.keys(oldRoute.options).forEach((key) => { + if (!generatedRouteOptionKeys.has(key) && !(key in newRoute.options)) { + removedKeys.add(key) + delete oldRoute.options[key] + } + }) + + const oldHasShellComponent = 'shellComponent' in oldRoute.options + const newHasShellComponent = 'shellComponent' in newRoute.options + const preserveComponentIdentity = + oldHasShellComponent === newHasShellComponent + + // Keys whose identity must remain stable to prevent React from + // unmounting/remounting the component tree. React Fast Refresh already + // handles hot-updating the function bodies of these components — our job + // is only to update non-component route options (loader, head, etc.). + // For code-split (splittable) routes, the lazyRouteComponent wrapper is + // already cached in the bundler hot data so its identity is stable. + // For unsplittable routes (e.g. root routes), the component is a plain + // function reference that gets recreated on every module re-execution, + // so we must explicitly preserve the old reference. + // Preserve component identity so React doesn't remount. + // React Fast Refresh patches the function bodies in-place. + const componentKeys = '__TSR_COMPONENT_TYPES__' as unknown as Array<string> + if (preserveComponentIdentity) { + componentKeys.forEach((key) => { + if (key in oldRoute.options && key in newRoute.options) { + newRoute.options[key] = oldRoute.options[key] + } + }) + } + + const nextOptions = { + ...newRoute.options, + ...generatedRouteOptions, + } + + oldRoute.options = nextOptions + oldRoute.update(nextOptions) + oldRoute._componentsPromise = undefined + oldRoute._lazyPromise = undefined + + router.setRoutes(router.buildRouteTree()) + router.resolvePathCache.clear() + + const filter = (m: AnyRouteMatch) => m.routeId === oldRoute.id + const activeMatch = router.stores.matches.get().find(filter) + const pendingMatch = router.stores.pendingMatches.get().find(filter) + const cachedMatches = router.stores.cachedMatches.get().filter(filter) + + if (activeMatch || pendingMatch || cachedMatches.length > 0) { + // Clear stale match data for removed route options BEFORE invalidating. + // Without this, router.invalidate() -> matchRoutes() reuses the existing + // match from the store (via ...existingMatch spread) and the stale + // loaderData / __beforeLoadContext survives the reload cycle. + // + // We must update the store directly (not via router.updateMatch) because + // updateMatch wraps in startTransition which may defer the state update, + // and we need the clear to be visible before invalidate reads the store. + if (removedKeys.has('loader') || removedKeys.has('beforeLoad')) { + const matchIds = [ + activeMatch?.id, + pendingMatch?.id, + ...cachedMatches.map((match) => match.id), + ].filter(Boolean) as Array<string> + router.batch(() => { + for (const matchId of matchIds) { + const store = + router.stores.pendingMatchStores.get(matchId) || + router.stores.matchStores.get(matchId) || + router.stores.cachedMatchStores.get(matchId) + if (store) { + store.set((prev) => { + const next: AnyRouteMatchWithPrivateProps = { ...prev } + + if (removedKeys.has('loader')) { + next.loaderData = undefined + } + if (removedKeys.has('beforeLoad')) { + next.__beforeLoadContext = undefined + next.context = rebuildMatchContextWithoutBeforeLoad(next) + } + + return next + }) + } + } + }) + } + + router.invalidate({ filter, sync: true }) + } + + function getStoreMatch(matchId: string) { + return ( + router.stores.pendingMatchStores.get(matchId)?.get() || + router.stores.matchStores.get(matchId)?.get() || + router.stores.cachedMatchStores.get(matchId)?.get() + ) + } + + function getMatchList(matchId: string) { + const pendingMatches = router.stores.pendingMatches.get() + if (pendingMatches.some((match) => match.id === matchId)) { + return pendingMatches + } + + const activeMatches = router.stores.matches.get() + if (activeMatches.some((match) => match.id === matchId)) { + return activeMatches + } + + const cachedMatches = router.stores.cachedMatches.get() + if (cachedMatches.some((match) => match.id === matchId)) { + return cachedMatches + } + + return [] + } + + function getParentMatch(match: AnyRouteMatch) { + const matchList = getMatchList(match.id) + const matchIndex = matchList.findIndex((item) => item.id === match.id) + + if (matchIndex <= 0) { + return undefined + } + + const parentMatch = matchList[matchIndex - 1]! + return getStoreMatch(parentMatch.id) || parentMatch + } + + function rebuildMatchContextWithoutBeforeLoad( + match: AnyRouteMatchWithPrivateProps, + ) { + const parentMatch = getParentMatch(match) + const getParentContext = ( + router as unknown as { + getParentContext?: ( + parentMatch?: AnyRouteMatch, + ) => Record<string, unknown> | undefined + } + ).getParentContext + const parentContext = getParentContext + ? getParentContext.call(router, parentMatch) + : (parentMatch?.context ?? router.options.context) + + return { + ...(parentContext ?? {}), + ...(match.__routeContext ?? {}), + } + } +} + +const handleRouteUpdateStr = handleRouteUpdate.toString() + +export function getHandleRouteUpdateCode(stableRouteOptionKeys: Array<string>) { + return handleRouteUpdateStr.replace( + /['"]__TSR_COMPONENT_TYPES__['"]/, + JSON.stringify(stableRouteOptionKeys), + ) +} diff --git a/packages/router-plugin/src/core/hmr/index.ts b/packages/router-plugin/src/core/hmr/index.ts new file mode 100644 index 0000000000..4e60f015a1 --- /dev/null +++ b/packages/router-plugin/src/core/hmr/index.ts @@ -0,0 +1,5 @@ +export { createRouteHmrStatement } from './select-adapter' +export type { CreateRouteHmrStatementOpts } from './select-adapter' +export { createViteHmrStatement } from './vite-adapter' +export { createWebpackHmrStatement } from './webpack-adapter' +export { getHandleRouteUpdateCode } from './handle-route-update' diff --git a/packages/router-plugin/src/core/hmr/select-adapter.ts b/packages/router-plugin/src/core/hmr/select-adapter.ts new file mode 100644 index 0000000000..60395a1534 --- /dev/null +++ b/packages/router-plugin/src/core/hmr/select-adapter.ts @@ -0,0 +1,32 @@ +import { createViteHmrStatement } from './vite-adapter' +import { createWebpackHmrStatement } from './webpack-adapter' +import type { Config, HmrStyle } from '../config' +import type * as t from '@babel/types' + +export type CreateRouteHmrStatementOpts = { + hmrStyle: HmrStyle + targetFramework: Config['target'] + routeId?: string +} + +/** + * Dispatches to the configured HMR adapter. `hmrStyle` is set explicitly by + * the bundler-specific plugin entry (e.g. `rspack.ts` → `'webpack'`), so there + * is no runtime inference based on config string shapes. + */ +export function createRouteHmrStatement( + stableRouteOptionKeys: Array<string>, + opts: CreateRouteHmrStatementOpts, +): Array<t.Statement> { + const routeId = opts.routeId === '/__root' ? '__root__' : opts.routeId + + if (opts.hmrStyle === 'webpack') { + return createWebpackHmrStatement(stableRouteOptionKeys, { + targetFramework: opts.targetFramework, + routeId, + }) + } + return createViteHmrStatement(stableRouteOptionKeys, { + routeId, + }) +} diff --git a/packages/router-plugin/src/core/hmr/vite-adapter.ts b/packages/router-plugin/src/core/hmr/vite-adapter.ts new file mode 100644 index 0000000000..4519682dbb --- /dev/null +++ b/packages/router-plugin/src/core/hmr/vite-adapter.ts @@ -0,0 +1,47 @@ +import * as template from '@babel/template' +import { getHandleRouteUpdateCode } from './handle-route-update' +import type * as t from '@babel/types' + +/** + * Emits HMR accept code for Vite / native ESM HMR: `import.meta.hot.accept` + * with a callback that receives the freshly re-imported module. + * + * `targetFramework` is currently unused — Vite's framework-specific fast-refresh + * plugins handle component body patching via their own accept boundaries — but + * we take it for API symmetry with `createWebpackHmrStatement`. + */ +export function createViteHmrStatement( + stableRouteOptionKeys: Array<string>, + opts: { + routeId?: string + } = {}, +): Array<t.Statement> { + const handleRouteUpdateCode = getHandleRouteUpdateCode(stableRouteOptionKeys) + // The replacement Route object can be uninitialized; keep a generated id as + // fallback for the existing router route we need to patch. + const routeIdFallback = + typeof opts.routeId === 'string' ? JSON.stringify(opts.routeId) : 'Route.id' + + return [ + template.statement( + ` +if (import.meta.hot) { + const hot = import.meta.hot + const hotData = hot.data ??= {} + hot.accept((newModule) => { + if (Route && newModule && newModule.Route) { + const routeId = hotData['tsr-route-id'] ?? ${routeIdFallback} + if (routeId) { + hotData['tsr-route-id'] = routeId + } + (${handleRouteUpdateCode})(routeId, newModule.Route) + } + }) +} +`, + { + syntacticPlaceholders: true, + }, + )(), + ] +} diff --git a/packages/router-plugin/src/core/hmr/webpack-adapter.ts b/packages/router-plugin/src/core/hmr/webpack-adapter.ts new file mode 100644 index 0000000000..eaf34ccfb1 --- /dev/null +++ b/packages/router-plugin/src/core/hmr/webpack-adapter.ts @@ -0,0 +1,96 @@ +import * as template from '@babel/template' +import { getHandleRouteUpdateCode } from './handle-route-update' +import type { Config } from '../config' +import type * as t from '@babel/types' + +/** + * Emits HMR accept code for bundlers with webpack-compatible `module.hot` + * semantics (classic webpack via `import.meta.webpackHot`, and Rspack). + * + * Unlike Vite's `hot.accept((newModule) => {...})` — where the callback receives + * the freshly re-imported module — webpack re-executes the module factory on + * accept, so our HMR logic must live at module top level and read the previous + * `routeId` out of `hot.data`. `hot.dispose` stashes it for the next run, and + * `hot.accept()` (no callback) enrolls us as a self-accepting boundary. + * + * Returns an array of statements that patches route definitions during HMR. + */ +export function createWebpackHmrStatement( + stableRouteOptionKeys: Array<string>, + opts: { + targetFramework: Config['target'] + routeId?: string + }, +): Array<t.Statement> { + const handleRouteUpdateCode = getHandleRouteUpdateCode(stableRouteOptionKeys) + const staticRouteIdLiteral = + typeof opts.routeId === 'string' + ? JSON.stringify(opts.routeId) + : 'undefined' + + // React-only: route modules aren't React Refresh "boundaries" (they export + // a non-component `Route`), so the bundler's react-refresh runtime won't + // call `performReactRefresh` for us. We kick it manually after swapping + // route options so newly-registered component bodies get patched into live + // fibers. + // + // Webpack and Rspack refresh plugins inject `__react_refresh_utils__` via + // ProvidePlugin. Use it when present instead of importing + // `react-refresh/runtime`, because Rsbuild apps may use React without the + // React plugin and therefore may not have that optional dependency installed. + // + // Use the same delayed refresh style as Rspack's React Refresh runtime. + // Route modules and their split component chunks can arrive in separate HMR + // steps under CI load; a microtask can run before the split chunk registers + // its new component family, causing the refresh to no-op or remount. + // + // For non-React frameworks we skip this entirely. + const reactRefreshCall = + opts.targetFramework === 'react' + ? ` + try { + const tsrReactRefreshUtils = + typeof __react_refresh_utils__ !== 'undefined' + ? __react_refresh_utils__ + : undefined + const tsrEnqueueUpdate = + tsrReactRefreshUtils && typeof tsrReactRefreshUtils.enqueueUpdate === 'function' + ? tsrReactRefreshUtils.enqueueUpdate + : undefined + if (tsrEnqueueUpdate) { + tsrEnqueueUpdate(() => {}) + } + } catch (_err) { /* noop */ }` + : '' + + return [ + template.statement( + ` +if (import.meta.webpackHot) { + const hot = import.meta.webpackHot + const hotData = hot.data ??= {} + const routeId = hotData['tsr-route-id'] ?? Route.id ?? (Route.isRoot ? '__root__' : ${staticRouteIdLiteral}) + if (routeId) { + hotData['tsr-route-id'] = routeId + } + const existingRoute = + typeof window !== 'undefined' && routeId + ? window.__TSR_ROUTER__?.routesById?.[routeId] + : undefined + if (routeId && existingRoute && existingRoute !== Route) { + (${handleRouteUpdateCode})(routeId, Route)${reactRefreshCall} + } + hot.dispose((data) => { + if (routeId) { + data['tsr-route-id'] = routeId + } + }) + hot.accept() +} +`, + { + syntacticPlaceholders: true, + }, + )(), + ] +} diff --git a/packages/router-plugin/src/core/route-autoimport-plugin.ts b/packages/router-plugin/src/core/route-autoimport-plugin.ts deleted file mode 100644 index 742f80b343..0000000000 --- a/packages/router-plugin/src/core/route-autoimport-plugin.ts +++ /dev/null @@ -1,120 +0,0 @@ -import { generateFromAst, logDiff, parseAst } from '@tanstack/router-utils' -import * as babel from '@babel/core' -import * as template from '@babel/template' -import { getConfig } from './config' -import { debug, normalizePath } from './utils' -import type { Config } from './config' -import type { UnpluginFactory } from 'unplugin' - -/** - * This plugin adds imports for createFileRoute and createLazyFileRoute to the file route. - */ -export const unpluginRouteAutoImportFactory: UnpluginFactory< - Partial<Config | (() => Config)> | undefined -> = (options = {}) => { - let ROOT: string = process.cwd() - let userConfig: Config - - function initUserConfig() { - if (typeof options === 'function') { - userConfig = options() - } else { - userConfig = getConfig(options, ROOT) - } - } - return { - name: 'tanstack-router:autoimport', - enforce: 'pre', - - transform: { - filter: { - // this is necessary for webpack / rspack to avoid matching .html files - id: /\.(m|c)?(j|t)sx?$/, - code: /createFileRoute\(|createLazyFileRoute\(/, - }, - handler(code, id) { - const normalizedId = normalizePath(id) - if (!globalThis.TSR_ROUTES_BY_ID_MAP?.has(normalizedId)) { - return null - } - let routeType: 'createFileRoute' | 'createLazyFileRoute' - if (code.includes('createFileRoute(')) { - routeType = 'createFileRoute' - } else if (code.includes('createLazyFileRoute(')) { - routeType = 'createLazyFileRoute' - } else { - return null - } - - const routerImportPath = `@tanstack/${userConfig.target}-router` - - const ast = parseAst({ code }) - - let isCreateRouteFunctionImported = false as boolean - - babel.traverse(ast, { - Program: { - enter(programPath) { - programPath.traverse({ - ImportDeclaration(path) { - const importedSpecifiers = path.node.specifiers.map( - (specifier) => specifier.local.name, - ) - if ( - importedSpecifiers.includes(routeType) && - path.node.source.value === routerImportPath - ) { - isCreateRouteFunctionImported = true - } - }, - }) - }, - }, - }) - - if (!isCreateRouteFunctionImported) { - if (debug) console.info('Adding autoimports to route ', normalizedId) - - const autoImportStatement = template.statement( - `import { ${routeType} } from '${routerImportPath}'`, - )() - ast.program.body.unshift(autoImportStatement) - - const result = generateFromAst(ast, { - sourceMaps: true, - filename: normalizedId, - sourceFileName: normalizedId, - }) - if (debug) { - logDiff(code, result.code) - console.log('Output:\n', result.code + '\n\n') - } - return result - } - - return null - }, - }, - - vite: { - configResolved(config) { - ROOT = config.root - initUserConfig() - }, - // this check may only happen after config is resolved, so we use applyToEnvironment (apply is too early) - applyToEnvironment() { - return userConfig.verboseFileRoutes === false - }, - }, - - rspack() { - ROOT = process.cwd() - initUserConfig() - }, - - webpack() { - ROOT = process.cwd() - initUserConfig() - }, - } -} diff --git a/packages/router-plugin/src/core/route-hmr-statement.ts b/packages/router-plugin/src/core/route-hmr-statement.ts deleted file mode 100644 index c0b4c2def0..0000000000 --- a/packages/router-plugin/src/core/route-hmr-statement.ts +++ /dev/null @@ -1,182 +0,0 @@ -import * as template from '@babel/template' -import type { AnyRoute, AnyRouteMatch, AnyRouter } from '@tanstack/router-core' - -type AnyRouteWithPrivateProps = AnyRoute & { - options: Record<string, unknown> - _componentsPromise?: Promise<void> - _lazyPromise?: Promise<void> - update: (options: Record<string, unknown>) => unknown - _path: string - _id: string - _fullPath: string - _to: string -} - -type AnyRouterWithPrivateMaps = AnyRouter & { - routesById: Record<string, AnyRoute> - routesByPath: Record<string, AnyRoute> - stores: AnyRouter['stores'] & { - cachedMatchStoresById: Map< - string, - { - setState: (updater: (prev: AnyRouteMatch) => AnyRouteMatch) => void - } - > - pendingMatchStoresById: Map< - string, - { - setState: (updater: (prev: AnyRouteMatch) => AnyRouteMatch) => void - } - > - activeMatchStoresById: Map< - string, - { - setState: (updater: (prev: AnyRouteMatch) => AnyRouteMatch) => void - } - > - } -} - -type AnyRouteMatchWithPrivateProps = AnyRouteMatch & { - __beforeLoadContext?: unknown -} - -function handleRouteUpdate( - routeId: string, - newRoute: AnyRouteWithPrivateProps, -) { - const router = window.__TSR_ROUTER__ as AnyRouterWithPrivateMaps - const oldRoute = router.routesById[routeId] as - | AnyRouteWithPrivateProps - | undefined - - if (!oldRoute) { - return - } - - // Keys whose identity must remain stable to prevent React from - // unmounting/remounting the component tree. React Fast Refresh already - // handles hot-updating the function bodies of these components — our job - // is only to update non-component route options (loader, head, etc.). - // For code-split (splittable) routes, the lazyRouteComponent wrapper is - // already cached in import.meta.hot.data so its identity is stable. - // For unsplittable routes (e.g. root routes), the component is a plain - // function reference that gets recreated on every module re-execution, - // so we must explicitly preserve the old reference. - const removedKeys = new Set<string>() - Object.keys(oldRoute.options).forEach((key) => { - if (!(key in newRoute.options)) { - removedKeys.add(key) - delete oldRoute.options[key] - } - }) - - // Preserve component identity so React doesn't remount. - // React Fast Refresh patches the function bodies in-place. - const componentKeys = '__TSR_COMPONENT_TYPES__' as unknown as Array<string> - componentKeys.forEach((key) => { - if (key in oldRoute.options && key in newRoute.options) { - newRoute.options[key] = oldRoute.options[key] - } - }) - - oldRoute.options = newRoute.options - oldRoute.update(newRoute.options) - oldRoute._componentsPromise = undefined - oldRoute._lazyPromise = undefined - - router.routesById[oldRoute.id] = oldRoute - router.routesByPath[oldRoute.fullPath] = oldRoute - - router.processedTree.matchCache.clear() - router.processedTree.flatCache?.clear() - router.processedTree.singleCache.clear() - router.resolvePathCache.clear() - walkReplaceSegmentTree(oldRoute, router.processedTree.segmentTree) - - const filter = (m: AnyRouteMatch) => m.routeId === oldRoute.id - const activeMatch = router.stores.activeMatchesSnapshot.state.find(filter) - const pendingMatch = router.stores.pendingMatchesSnapshot.state.find(filter) - const cachedMatches = router.stores.cachedMatchesSnapshot.state.filter(filter) - - if (activeMatch || pendingMatch || cachedMatches.length > 0) { - // Clear stale match data for removed route options BEFORE invalidating. - // Without this, router.invalidate() -> matchRoutes() reuses the existing - // match from the store (via ...existingMatch spread) and the stale - // loaderData / __beforeLoadContext survives the reload cycle. - // - // We must update the store directly (not via router.updateMatch) because - // updateMatch wraps in startTransition which may defer the state update, - // and we need the clear to be visible before invalidate reads the store. - if (removedKeys.has('loader') || removedKeys.has('beforeLoad')) { - const matchIds = [ - activeMatch?.id, - pendingMatch?.id, - ...cachedMatches.map((match) => match.id), - ].filter(Boolean) as Array<string> - router.batch(() => { - for (const matchId of matchIds) { - const store = - router.stores.pendingMatchStoresById.get(matchId) || - router.stores.activeMatchStoresById.get(matchId) || - router.stores.cachedMatchStoresById.get(matchId) - if (store) { - store.setState((prev) => { - const next: AnyRouteMatchWithPrivateProps = { ...prev } - - if (removedKeys.has('loader')) { - next.loaderData = undefined - } - if (removedKeys.has('beforeLoad')) { - next.__beforeLoadContext = undefined - } - - return next - }) - } - } - }) - } - - router.invalidate({ filter, sync: true }) - } - - function walkReplaceSegmentTree( - route: AnyRouteWithPrivateProps, - node: AnyRouter['processedTree']['segmentTree'], - ) { - if (node.route?.id === route.id) node.route = route - if (node.index) walkReplaceSegmentTree(route, node.index) - node.static?.forEach((child) => walkReplaceSegmentTree(route, child)) - node.staticInsensitive?.forEach((child) => - walkReplaceSegmentTree(route, child), - ) - node.dynamic?.forEach((child) => walkReplaceSegmentTree(route, child)) - node.optional?.forEach((child) => walkReplaceSegmentTree(route, child)) - node.wildcard?.forEach((child) => walkReplaceSegmentTree(route, child)) - } -} - -const handleRouteUpdateStr = handleRouteUpdate.toString() - -export function createRouteHmrStatement(stableRouteOptionKeys: Array<string>) { - return template.statement( - ` -if (import.meta.hot) { - import.meta.hot.accept((newModule) => { - if (Route && newModule && newModule.Route) { - const routeId = import.meta.hot.data['tsr-route-id'] ?? Route.id - if (routeId) { - import.meta.hot.data['tsr-route-id'] = routeId - } - (${handleRouteUpdateStr.replace( - /['"]__TSR_COMPONENT_TYPES__['"]/, - JSON.stringify(stableRouteOptionKeys), - )})(routeId, newModule.Route) - } - }) -} -`, - { placeholderPattern: false }, - )() -} diff --git a/packages/router-plugin/src/core/router-code-splitter-plugin.ts b/packages/router-plugin/src/core/router-code-splitter-plugin.ts index 22a22e2af4..4b6af091cc 100644 --- a/packages/router-plugin/src/core/router-code-splitter-plugin.ts +++ b/packages/router-plugin/src/core/router-code-splitter-plugin.ts @@ -4,7 +4,7 @@ */ import { fileURLToPath, pathToFileURL } from 'node:url' -import { logDiff } from '@tanstack/router-utils' +import { decodeIdentifier, logDiff } from '@tanstack/router-utils' import { getConfig, splitGroupingsSchema } from './config' import { compileCodeSplitReferenceRoute, @@ -20,17 +20,17 @@ import { tsrShared, tsrSplit, } from './constants' -import { decodeIdentifier } from './code-splitter/path-ids' -import { debug, normalizePath } from './utils' +import { debug, normalizePath, routeFactoryCallCodeFilter } from './utils' +import { createRouterPluginContext } from './router-plugin-context' import type { CodeSplitGroupings, SplitRouteIdentNodes } from './constants' import type { GetRoutesByFileMapResultValue } from '@tanstack/router-generator' import type { Config } from './config' +import type { RouterPluginContext } from './router-plugin-context' import type { UnpluginFactory, TransformResult as UnpluginTransformResult, } from 'unplugin' -const PLUGIN_NAME = 'unplugin:router-code-splitter' const CODE_SPLITTER_PLUGIN_NAME = 'tanstack-router:code-splitter:compile-reference-file' @@ -77,9 +77,10 @@ const TRANSFORMATION_PLUGINS_BY_FRAMEWORK: Record< ], } -export const unpluginRouterCodeSplitterFactory: UnpluginFactory< - Partial<Config | (() => Config)> | undefined -> = (options = {}, { framework: _framework }) => { +export function createRouterCodeSplitterPlugin( + options: Partial<Config | (() => Config)> | undefined = {}, + routerPluginContext: RouterPluginContext, +): ReturnType<UnpluginFactory<Partial<Config | (() => Config)> | undefined>> { let ROOT: string = process.cwd() let userConfig: Config @@ -114,12 +115,13 @@ export const unpluginRouterCodeSplitterFactory: UnpluginFactory< const fromCode = detectCodeSplitGroupingsFromRoute({ code, + filename: id, }) if (fromCode.groupings !== undefined) { const res = splitGroupingsSchema.safeParse(fromCode.groupings) if (!res.success) { - const message = res.error.errors.map((e) => e.message).join('. ') + const message = res.error.issues.map((e) => e.message).join('. ') throw new Error( `The groupings for the route "${id}" are invalid.\n${message}`, ) @@ -129,13 +131,13 @@ export const unpluginRouterCodeSplitterFactory: UnpluginFactory< const userShouldSplitFn = getShouldSplitFn() const pluginSplitBehavior = userShouldSplitFn?.({ - routeId: generatorNodeInfo.routePath, + routeId: generatorNodeInfo.routeId, }) as CodeSplitGroupings | undefined if (pluginSplitBehavior) { const res = splitGroupingsSchema.safeParse(pluginSplitBehavior) if (!res.success) { - const message = res.error.errors.map((e) => e.message).join('. ') + const message = res.error.issues.map((e) => e.message).join('. ') throw new Error( `The groupings returned when using \`splitBehavior\` for the route "${id}" are invalid.\n${message}`, ) @@ -148,6 +150,7 @@ export const unpluginRouterCodeSplitterFactory: UnpluginFactory< // Compute shared bindings before compiling the reference route const sharedBindings = computeSharedBindings({ code, + filename: id, codeSplitGroupings: splitGroupings, }) if (sharedBindings.size > 0) { @@ -158,6 +161,7 @@ export const unpluginRouterCodeSplitterFactory: UnpluginFactory< const addHmr = (userConfig.codeSplittingOptions?.addHmr ?? true) && !isProduction + const hmrStyle = userConfig.plugin?.hmr?.style ?? 'vite' const compiledReferenceRoute = compileCodeSplitReferenceRoute({ code, @@ -169,11 +173,17 @@ export const unpluginRouterCodeSplitterFactory: UnpluginFactory< ? new Set(userConfig.codeSplittingOptions.deleteNodes) : undefined, addHmr, + hmrStyle, + hmrRouteId: generatorNodeInfo.routeId, sharedBindings: sharedBindings.size > 0 ? sharedBindings : undefined, - compilerPlugins: getReferenceRouteCompilerPlugins({ - targetFramework: userConfig.target, - addHmr, - }), + compilerPlugins: [ + ...(getReferenceRouteCompilerPlugins({ + targetFramework: userConfig.target, + addHmr, + hmrStyle, + }) ?? []), + ...(userConfig.codeSplittingOptions?.compilerPlugins ?? []), + ], }) if (compiledReferenceRoute === null) { @@ -232,11 +242,6 @@ export const unpluginRouterCodeSplitterFactory: UnpluginFactory< return result } - const includedCode = [ - 'createFileRoute(', - 'createRootRoute(', - 'createRootRouteWithContext(', - ] return [ { name: 'tanstack-router:code-splitter:compile-reference-file', @@ -250,17 +255,14 @@ export const unpluginRouterCodeSplitterFactory: UnpluginFactory< include: /\.(m|c)?(j|t)sx?$/, }, code: { - include: includedCode, + include: routeFactoryCallCodeFilter, }, }, handler(code, id) { const normalizedId = normalizePath(id) const generatorFileInfo = - globalThis.TSR_ROUTES_BY_ID_MAP?.get(normalizedId) - if ( - generatorFileInfo && - includedCode.some((included) => code.includes(included)) - ) { + routerPluginContext.routesByFile.get(normalizedId) + if (generatorFileInfo) { return handleCompilingReferenceFile( code, normalizedId, @@ -317,26 +319,14 @@ export const unpluginRouterCodeSplitterFactory: UnpluginFactory< }, }, - rspack(compiler) { + rspack() { ROOT = process.cwd() initUserConfig() - - if (compiler.options.mode === 'production') { - compiler.hooks.done.tap(PLUGIN_NAME, () => { - console.info('✅ ' + PLUGIN_NAME + ': code-splitting done!') - }) - } }, - webpack(compiler) { + webpack() { ROOT = process.cwd() initUserConfig() - - if (compiler.options.mode === 'production') { - compiler.hooks.done.tap(PLUGIN_NAME, () => { - console.info('✅ ' + PLUGIN_NAME + ': code-splitting done!') - }) - } }, }, { @@ -411,3 +401,9 @@ export const unpluginRouterCodeSplitterFactory: UnpluginFactory< }, ] } + +export const unpluginRouterCodeSplitterFactory: UnpluginFactory< + Partial<Config | (() => Config)> | undefined +> = (options = {}) => { + return createRouterCodeSplitterPlugin(options, createRouterPluginContext()) +} diff --git a/packages/router-plugin/src/core/router-composed-plugin.ts b/packages/router-plugin/src/core/router-composed-plugin.ts index e7b6f10821..c778e4e8d4 100644 --- a/packages/router-plugin/src/core/router-composed-plugin.ts +++ b/packages/router-plugin/src/core/router-composed-plugin.ts @@ -1,41 +1,96 @@ import { getConfig } from '@tanstack/router-generator' -import { unpluginRouterGeneratorFactory } from './router-generator-plugin' -import { unpluginRouterCodeSplitterFactory } from './router-code-splitter-plugin' -import { unpluginRouterHmrFactory } from './router-hmr-plugin' -import { unpluginRouteAutoImportFactory } from './route-autoimport-plugin' +import { createRouterGeneratorPlugin } from './router-generator-plugin' +import { createRouterCodeSplitterPlugin } from './router-code-splitter-plugin' +import { createRouterHmrPlugin } from './router-hmr-plugin' +import { createRouterPluginContext } from './router-plugin-context' import type { Config } from './config' -import type { UnpluginFactory } from 'unplugin' +import type { + RspackCompiler, + UnpluginFactory, + UnpluginOptions, + WebpackCompiler, +} from 'unplugin' + +const INLINE_CSS_DEFAULT_DEFINES = { + 'process.env.TSS_INLINE_CSS_ENABLED': JSON.stringify('false'), + 'import.meta.env.TSS_INLINE_CSS_ENABLED': JSON.stringify('false'), +} + +type EsbuildOptionsWithDefine = Parameters< + NonNullable<NonNullable<UnpluginOptions['esbuild']>['config']> +>[0] + +function applyWebpackInlineCssDefaultDefinePlugin(compiler: WebpackCompiler) { + new compiler.webpack.DefinePlugin(INLINE_CSS_DEFAULT_DEFINES).apply(compiler) +} + +function applyRspackInlineCssDefaultDefinePlugin(compiler: RspackCompiler) { + new compiler.webpack.DefinePlugin(INLINE_CSS_DEFAULT_DEFINES).apply(compiler) +} export const unpluginRouterComposedFactory: UnpluginFactory< - Partial<Config> | undefined -> = (options = {}, meta) => { + Partial<Config | (() => Config)> | undefined +> = (options = {}, _meta) => { const ROOT: string = process.cwd() - const userConfig = getConfig(options, ROOT) + const userConfig = getConfig( + (typeof options === 'function' ? options() : options) as Partial<Config>, + ROOT, + ) + const routerPluginContext = createRouterPluginContext() - const getPlugin = (pluginFactory: UnpluginFactory<Partial<Config>>) => { - const plugin = pluginFactory(options, meta) + const getPlugin = (plugin: ReturnType<UnpluginFactory<any>>) => { if (!Array.isArray(plugin)) { return [plugin] } return plugin } - const routerGenerator = getPlugin(unpluginRouterGeneratorFactory) - const routerCodeSplitter = getPlugin(unpluginRouterCodeSplitterFactory) - const routeAutoImport = getPlugin(unpluginRouteAutoImportFactory) + const routerGenerator = getPlugin( + createRouterGeneratorPlugin(options, routerPluginContext), + ) + const routerCodeSplitter = getPlugin( + createRouterCodeSplitterPlugin(options, routerPluginContext), + ) - const result = [...routerGenerator] + const result = [ + { + name: 'tanstack:router-inline-css-defaults', + vite: { + config() { + return { + define: { + ...INLINE_CSS_DEFAULT_DEFINES, + }, + } + }, + }, + webpack(compiler: WebpackCompiler) { + applyWebpackInlineCssDefaultDefinePlugin(compiler) + }, + rspack(compiler: RspackCompiler) { + applyRspackInlineCssDefaultDefinePlugin(compiler) + }, + esbuild: { + config(options: EsbuildOptionsWithDefine) { + options.define = { + ...INLINE_CSS_DEFAULT_DEFINES, + ...options.define, + } + }, + }, + }, + ...routerGenerator, + ] if (userConfig.autoCodeSplitting) { result.push(...routerCodeSplitter) } - if (userConfig.verboseFileRoutes === false) { - result.push(...routeAutoImport) - } const isProduction = process.env.NODE_ENV === 'production' if (!isProduction && !userConfig.autoCodeSplitting) { - const routerHmr = getPlugin(unpluginRouterHmrFactory) + const routerHmr = getPlugin( + createRouterHmrPlugin(options, routerPluginContext), + ) result.push(...routerHmr) } return result diff --git a/packages/router-plugin/src/core/router-generator-plugin.ts b/packages/router-plugin/src/core/router-generator-plugin.ts index 055a1bc3c5..46dda8c581 100644 --- a/packages/router-plugin/src/core/router-generator-plugin.ts +++ b/packages/router-plugin/src/core/router-generator-plugin.ts @@ -1,17 +1,20 @@ import { isAbsolute, join, normalize } from 'node:path' import { Generator, resolveConfigPath } from '@tanstack/router-generator' import { getConfig } from './config' +import { createRouterPluginContext } from './router-plugin-context' import type { GeneratorEvent } from '@tanstack/router-generator' import type { FSWatcher } from 'chokidar' import type { UnpluginFactory } from 'unplugin' import type { Config } from './config' +import type { RouterPluginContext } from './router-plugin-context' const PLUGIN_NAME = 'unplugin:router-generator' -export const unpluginRouterGeneratorFactory: UnpluginFactory< - Partial<Config | (() => Config)> | undefined -> = (options = {}) => { +export function createRouterGeneratorPlugin( + options: Partial<Config | (() => Config)> | undefined = {}, + routerPluginContext: RouterPluginContext, +): ReturnType<UnpluginFactory<Partial<Config | (() => Config)> | undefined>> { let ROOT: string = process.cwd() let userConfig: Config let generator: Generator @@ -58,7 +61,7 @@ export const unpluginRouterGeneratorFactory: UnpluginFactory< try { await generator.run(generatorEvent) - globalThis.TSR_ROUTES_BY_ID_MAP = generator.getRoutesByFileMap() + routerPluginContext.routesByFile = generator.getRoutesByFileMap() } catch (e) { console.error(e) } @@ -146,3 +149,9 @@ export const unpluginRouterGeneratorFactory: UnpluginFactory< }, } } + +export const unpluginRouterGeneratorFactory: UnpluginFactory< + Partial<Config | (() => Config)> | undefined +> = (options = {}) => { + return createRouterGeneratorPlugin(options, createRouterPluginContext()) +} diff --git a/packages/router-plugin/src/core/router-hmr-plugin.ts b/packages/router-plugin/src/core/router-hmr-plugin.ts index 9ebb745772..75dfde11f8 100644 --- a/packages/router-plugin/src/core/router-hmr-plugin.ts +++ b/packages/router-plugin/src/core/router-hmr-plugin.ts @@ -1,11 +1,13 @@ import { generateFromAst, logDiff, parseAst } from '@tanstack/router-utils' import { compileCodeSplitReferenceRoute } from './code-splitter/compilers' import { getReferenceRouteCompilerPlugins } from './code-splitter/plugins/framework-plugins' -import { createRouteHmrStatement } from './route-hmr-statement' -import { debug, normalizePath } from './utils' +import { createRouteHmrStatement } from './hmr' +import { debug, normalizePath, routeFactoryCallCodeFilter } from './utils' import { getConfig } from './config' +import { createRouterPluginContext } from './router-plugin-context' import type { UnpluginFactory } from 'unplugin' import type { Config } from './config' +import type { RouterPluginContext } from './router-plugin-context' /** * This plugin adds HMR support for file routes. @@ -13,16 +15,17 @@ import type { Config } from './config' * handles HMR for code-split routes itself. */ -const includeCode = [ - 'createFileRoute(', - 'createRootRoute(', - 'createRootRouteWithContext(', -] -export const unpluginRouterHmrFactory: UnpluginFactory< - Partial<Config> | undefined -> = (options = {}) => { +export function createRouterHmrPlugin( + options: Partial<Config | (() => Config)> | undefined = {}, + routerPluginContext: RouterPluginContext, +): ReturnType<UnpluginFactory<Partial<Config> | undefined>> { let ROOT: string = process.cwd() - let userConfig = options as Config + + const resolveUserConfig = () => { + return getConfig(typeof options === 'function' ? options() : options, ROOT) + } + + let userConfig = resolveUserConfig() return { name: 'tanstack-router:hmr', @@ -32,27 +35,33 @@ export const unpluginRouterHmrFactory: UnpluginFactory< // this is necessary for webpack / rspack to avoid matching .html files id: /\.(m|c)?(j|t)sx?$/, code: { - include: includeCode, + include: routeFactoryCallCodeFilter, }, }, handler(code, id) { const normalizedId = normalizePath(id) - if (!globalThis.TSR_ROUTES_BY_ID_MAP?.has(normalizedId)) { + const routeEntry = routerPluginContext.routesByFile.get(normalizedId) + if (!routeEntry) { return null } if (debug) console.info('Adding HMR handling to route ', normalizedId) + const hmrStyle = userConfig.plugin?.hmr?.style ?? 'vite' + if (userConfig.target === 'react') { const compilerPlugins = getReferenceRouteCompilerPlugins({ targetFramework: 'react', addHmr: true, + hmrStyle, }) const compiled = compileCodeSplitReferenceRoute({ code, filename: normalizedId, id: normalizedId, addHmr: true, + hmrStyle, + hmrRouteId: routeEntry.routeId, codeSplitGroupings: [], targetFramework: 'react', compilerPlugins, @@ -68,8 +77,14 @@ export const unpluginRouterHmrFactory: UnpluginFactory< } } - const ast = parseAst({ code }) - ast.program.body.push(createRouteHmrStatement([])) + const ast = parseAst({ code, filename: normalizedId }) + ast.program.body.push( + ...createRouteHmrStatement([], { + hmrStyle, + targetFramework: userConfig.target, + routeId: routeEntry.routeId, + }), + ) const result = generateFromAst(ast, { sourceMaps: true, filename: normalizedId, @@ -85,7 +100,7 @@ export const unpluginRouterHmrFactory: UnpluginFactory< vite: { configResolved(config) { ROOT = config.root - userConfig = getConfig(options, ROOT) + userConfig = resolveUserConfig() }, applyToEnvironment(environment) { if (userConfig.plugin?.vite?.environmentName) { @@ -96,3 +111,9 @@ export const unpluginRouterHmrFactory: UnpluginFactory< }, } } + +export const unpluginRouterHmrFactory: UnpluginFactory< + Partial<Config> | undefined +> = (options = {}) => { + return createRouterHmrPlugin(options, createRouterPluginContext()) +} diff --git a/packages/router-plugin/src/core/router-plugin-context.ts b/packages/router-plugin/src/core/router-plugin-context.ts new file mode 100644 index 0000000000..fad9fbe038 --- /dev/null +++ b/packages/router-plugin/src/core/router-plugin-context.ts @@ -0,0 +1,11 @@ +import type { GetRoutesByFileMapResult } from '@tanstack/router-generator' + +export type RouterPluginContext = { + routesByFile: GetRoutesByFileMapResult +} + +export function createRouterPluginContext(): RouterPluginContext { + return { + routesByFile: new Map(), + } +} diff --git a/packages/router-plugin/src/core/utils.ts b/packages/router-plugin/src/core/utils.ts index 267582d6ec..61ab1ca278 100644 --- a/packages/router-plugin/src/core/utils.ts +++ b/packages/router-plugin/src/core/utils.ts @@ -16,6 +16,12 @@ export function normalizePath(path: string): string { return path.replace(/\\/g, '/') } +export const routeFactoryCallCodeFilter = [ + /\bcreateFileRoute\s*\(/, + /\bcreateRootRoute\s*\(/, + /\bcreateRootRouteWithContext\s*(?:<|\()/, +] + export function getObjectPropertyKeyName( prop: t.ObjectProperty, ): string | undefined { diff --git a/packages/router-plugin/src/esbuild.ts b/packages/router-plugin/src/esbuild.ts index c2caaf2cef..650082964d 100644 --- a/packages/router-plugin/src/esbuild.ts +++ b/packages/router-plugin/src/esbuild.ts @@ -1,11 +1,17 @@ import { createEsbuildPlugin } from 'unplugin' import { configSchema } from './core/config' -import { unpluginRouterCodeSplitterFactory } from './core/router-code-splitter-plugin' -import { unpluginRouterGeneratorFactory } from './core/router-generator-plugin' +import { createRouterCodeSplitterPlugin } from './core/router-code-splitter-plugin' +import { createRouterGeneratorPlugin } from './core/router-generator-plugin' import { unpluginRouterComposedFactory } from './core/router-composed-plugin' +import { createRouterPluginContext } from './core/router-plugin-context' import type { CodeSplittingOptions, Config } from './core/config' +import type { RouterPluginContext } from './core/router-plugin-context' + +type RouterPluginOptions = Partial<Config | (() => Config)> | undefined + +const defaultRouterPluginContext = createRouterPluginContext() /** * @example @@ -16,9 +22,15 @@ import type { CodeSplittingOptions, Config } from './core/config' * } * ``` */ -const TanStackRouterGeneratorEsbuild = createEsbuildPlugin( - unpluginRouterGeneratorFactory, -) +const TanStackRouterGeneratorEsbuild = ( + options?: RouterPluginOptions, + routerPluginContext?: RouterPluginContext, +) => { + const pluginContext = routerPluginContext ?? defaultRouterPluginContext + return createEsbuildPlugin((pluginOptions: RouterPluginOptions) => + createRouterGeneratorPlugin(pluginOptions, pluginContext), + )(options) +} /** * @example @@ -29,9 +41,15 @@ const TanStackRouterGeneratorEsbuild = createEsbuildPlugin( * } * ``` */ -const TanStackRouterCodeSplitterEsbuild = createEsbuildPlugin( - unpluginRouterCodeSplitterFactory, -) +const TanStackRouterCodeSplitterEsbuild = ( + options?: RouterPluginOptions, + routerPluginContext?: RouterPluginContext, +) => { + const pluginContext = routerPluginContext ?? defaultRouterPluginContext + return createEsbuildPlugin((pluginOptions: RouterPluginOptions) => + createRouterCodeSplitterPlugin(pluginOptions, pluginContext), + )(options) +} /** * @example @@ -54,4 +72,4 @@ export { tanstackRouter, } -export type { Config, CodeSplittingOptions } +export type { Config, CodeSplittingOptions, RouterPluginContext } diff --git a/packages/router-plugin/src/global.d.ts b/packages/router-plugin/src/global.d.ts deleted file mode 100644 index c08dc57529..0000000000 --- a/packages/router-plugin/src/global.d.ts +++ /dev/null @@ -1,7 +0,0 @@ -/* eslint-disable no-var */ -import type { GetRoutesByFileMapResult } from '@tanstack/router-generator' - -declare global { - var TSR_ROUTES_BY_ID_MAP: GetRoutesByFileMapResult | undefined -} -export {} diff --git a/packages/router-plugin/src/index.ts b/packages/router-plugin/src/index.ts index a89dbf5656..e390c046a2 100644 --- a/packages/router-plugin/src/index.ts +++ b/packages/router-plugin/src/index.ts @@ -1,13 +1,21 @@ export { configSchema, getConfig } from './core/config' export { unpluginRouterCodeSplitterFactory } from './core/router-code-splitter-plugin' export { unpluginRouterGeneratorFactory } from './core/router-generator-plugin' +export { createRouterPluginContext } from './core/router-plugin-context' export type { Config, ConfigInput, ConfigOutput, CodeSplittingOptions, DeletableNodes, + HmrOptions, } from './core/config' +export type { RouterPluginContext } from './core/router-plugin-context' +export { getObjectPropertyKeyName } from './core/utils' +export type { + ReferenceRouteCompilerPlugin, + ReferenceRouteCompilerPluginContext, +} from './core/code-splitter/plugins' export { tsrSplit, splitRouteIdentNodes, diff --git a/packages/router-plugin/src/rspack.ts b/packages/router-plugin/src/rspack.ts index 9eef9f2221..a31bde74af 100644 --- a/packages/router-plugin/src/rspack.ts +++ b/packages/router-plugin/src/rspack.ts @@ -1,10 +1,45 @@ import { createRspackPlugin } from 'unplugin' import { configSchema } from './core/config' -import { unpluginRouterCodeSplitterFactory } from './core/router-code-splitter-plugin' -import { unpluginRouterGeneratorFactory } from './core/router-generator-plugin' +import { createRouterCodeSplitterPlugin } from './core/router-code-splitter-plugin' +import { createRouterGeneratorPlugin } from './core/router-generator-plugin' import { unpluginRouterComposedFactory } from './core/router-composed-plugin' +import { createRouterPluginContext } from './core/router-plugin-context' import type { CodeSplittingOptions, Config } from './core/config' +import type { RouterPluginContext } from './core/router-plugin-context' + +type RspackRouterPluginOptions = Partial<Config> | (() => Partial<Config>) + +const defaultRouterPluginContext = createRouterPluginContext() + +/** + * Rspack uses webpack-compatible `module.hot` / `import.meta.webpackHot` HMR. + * Force `plugin.hmr.style = 'webpack'` so the router HMR adapter emits + * `module.hot`-style accept/dispose code instead of Vite's callback-receive + * variant, regardless of what the user passes (or doesn't pass). + */ +function withWebpackHmrStyle( + options: RspackRouterPluginOptions | undefined, +): RspackRouterPluginOptions { + const mergeHmrStyle = ( + config: Partial<Config> | undefined, + ): Partial<Config> => ({ + ...config, + plugin: { + ...config?.plugin, + hmr: { + ...config?.plugin?.hmr, + style: 'webpack', + }, + }, + }) + + if (typeof options === 'function') { + return () => mergeHmrStyle(options()) + } + + return mergeHmrStyle(options) +} /** * @example @@ -19,9 +54,18 @@ import type { CodeSplittingOptions, Config } from './core/config' * }) * ``` */ -const TanStackRouterGeneratorRspack = /* #__PURE__ */ createRspackPlugin( - unpluginRouterGeneratorFactory, -) +const TanStackRouterGeneratorRspack = ( + options?: RspackRouterPluginOptions, + routerPluginContext?: RouterPluginContext, +) => { + const pluginContext = routerPluginContext ?? defaultRouterPluginContext + return createRspackPlugin((pluginOptions) => + createRouterGeneratorPlugin( + pluginOptions as Partial<Config | (() => Config)> | undefined, + pluginContext, + ), + )(options) +} /** * @example @@ -36,9 +80,20 @@ const TanStackRouterGeneratorRspack = /* #__PURE__ */ createRspackPlugin( * }) * ``` */ -const TanStackRouterCodeSplitterRspack = /* #__PURE__ */ createRspackPlugin( - unpluginRouterCodeSplitterFactory, -) +const TanStackRouterCodeSplitterRspack = ( + options?: RspackRouterPluginOptions, + routerPluginContext?: RouterPluginContext, +) => { + const pluginContext = routerPluginContext ?? defaultRouterPluginContext + return createRspackPlugin((pluginOptions) => + createRouterCodeSplitterPlugin( + withWebpackHmrStyle( + pluginOptions as RspackRouterPluginOptions | undefined, + ) as Partial<Config | (() => Config)>, + pluginContext, + ), + )(options) +} /** * @example @@ -54,7 +109,13 @@ const TanStackRouterCodeSplitterRspack = /* #__PURE__ */ createRspackPlugin( * ``` */ const TanStackRouterRspack = /* #__PURE__ */ createRspackPlugin( - unpluginRouterComposedFactory, + (options, meta) => + unpluginRouterComposedFactory( + withWebpackHmrStyle( + options as RspackRouterPluginOptions | undefined, + ) as Partial<Config | (() => Config)>, + meta, + ), ) const tanstackRouter = TanStackRouterRspack export default TanStackRouterRspack @@ -65,4 +126,4 @@ export { TanStackRouterCodeSplitterRspack, tanstackRouter, } -export type { Config, CodeSplittingOptions } +export type { Config, CodeSplittingOptions, RouterPluginContext } diff --git a/packages/router-plugin/src/vite.ts b/packages/router-plugin/src/vite.ts index 75b66f31aa..3608887f33 100644 --- a/packages/router-plugin/src/vite.ts +++ b/packages/router-plugin/src/vite.ts @@ -1,15 +1,16 @@ import { createVitePlugin } from 'unplugin' -import { configSchema } from './core/config' -import { unpluginRouterCodeSplitterFactory } from './core/router-code-splitter-plugin' -import { unpluginRouterGeneratorFactory } from './core/router-generator-plugin' +import { configSchema, getConfig } from './core/config' +import { createRouterCodeSplitterPlugin } from './core/router-code-splitter-plugin' +import { createRouterGeneratorPlugin } from './core/router-generator-plugin' import { unpluginRouterComposedFactory } from './core/router-composed-plugin' -import { unpluginRouteAutoImportFactory } from './core/route-autoimport-plugin' -import type { CodeSplittingOptions, Config, getConfig } from './core/config' +import { createRouterPluginContext } from './core/router-plugin-context' +import type { CodeSplittingOptions, Config } from './core/config' +import type { RouterPluginContext } from './core/router-plugin-context' -const tanstackRouterAutoImport = createVitePlugin( - unpluginRouteAutoImportFactory, -) +type RouterPluginOptions = Partial<Config | (() => Config)> | undefined + +const defaultRouterPluginContext = createRouterPluginContext() /** * @example @@ -20,7 +21,15 @@ const tanstackRouterAutoImport = createVitePlugin( * }) * ``` */ -const tanstackRouterGenerator = createVitePlugin(unpluginRouterGeneratorFactory) +const tanstackRouterGenerator = ( + options?: RouterPluginOptions, + routerPluginContext?: RouterPluginContext, +) => { + const pluginContext = routerPluginContext ?? defaultRouterPluginContext + return createVitePlugin((pluginOptions: RouterPluginOptions) => + createRouterGeneratorPlugin(pluginOptions, pluginContext), + )(options) +} /** * @example @@ -31,9 +40,15 @@ const tanstackRouterGenerator = createVitePlugin(unpluginRouterGeneratorFactory) * }) * ``` */ -const tanStackRouterCodeSplitter = createVitePlugin( - unpluginRouterCodeSplitterFactory, -) +const tanStackRouterCodeSplitter = ( + options?: RouterPluginOptions, + routerPluginContext?: RouterPluginContext, +) => { + const pluginContext = routerPluginContext ?? defaultRouterPluginContext + return createVitePlugin((pluginOptions: RouterPluginOptions) => + createRouterCodeSplitterPlugin(pluginOptions, pluginContext), + )(options) +} /** * @example @@ -55,11 +70,10 @@ export default tanstackRouter export { configSchema, getConfig, - tanstackRouterAutoImport, tanStackRouterCodeSplitter, tanstackRouterGenerator, TanStackRouterVite, tanstackRouter, } -export type { Config, CodeSplittingOptions } +export type { Config, CodeSplittingOptions, RouterPluginContext } diff --git a/packages/router-plugin/src/webpack.ts b/packages/router-plugin/src/webpack.ts index a718e6056a..712372565e 100644 --- a/packages/router-plugin/src/webpack.ts +++ b/packages/router-plugin/src/webpack.ts @@ -1,10 +1,34 @@ import { createWebpackPlugin } from 'unplugin' import { configSchema } from './core/config' -import { unpluginRouterCodeSplitterFactory } from './core/router-code-splitter-plugin' -import { unpluginRouterGeneratorFactory } from './core/router-generator-plugin' +import { createRouterCodeSplitterPlugin } from './core/router-code-splitter-plugin' +import { createRouterGeneratorPlugin } from './core/router-generator-plugin' import { unpluginRouterComposedFactory } from './core/router-composed-plugin' +import { createRouterPluginContext } from './core/router-plugin-context' import type { CodeSplittingOptions, Config } from './core/config' +import type { RouterPluginContext } from './core/router-plugin-context' + +const defaultRouterPluginContext = createRouterPluginContext() + +/** + * Webpack uses `module.hot` / `import.meta.webpackHot` HMR. Force + * `plugin.hmr.style = 'webpack'` so the router HMR adapter emits the correct + * accept/dispose shape regardless of user config. + */ +function withWebpackHmrStyle( + options: Partial<Config> | undefined, +): Partial<Config> { + return { + ...options, + plugin: { + ...options?.plugin, + hmr: { + ...options?.plugin?.hmr, + style: 'webpack', + }, + }, + } +} /** * @example @@ -15,9 +39,15 @@ import type { CodeSplittingOptions, Config } from './core/config' * } * ``` */ -const TanStackRouterGeneratorWebpack = /* #__PURE__ */ createWebpackPlugin( - unpluginRouterGeneratorFactory, -) +const TanStackRouterGeneratorWebpack = ( + options?: Partial<Config>, + routerPluginContext?: RouterPluginContext, +) => { + const pluginContext = routerPluginContext ?? defaultRouterPluginContext + return createWebpackPlugin((pluginOptions: Partial<Config> | undefined) => + createRouterGeneratorPlugin(pluginOptions, pluginContext), + )(options) +} /** * @example @@ -28,9 +58,18 @@ const TanStackRouterGeneratorWebpack = /* #__PURE__ */ createWebpackPlugin( * } * ``` */ -const TanStackRouterCodeSplitterWebpack = /* #__PURE__ */ createWebpackPlugin( - unpluginRouterCodeSplitterFactory, -) +const TanStackRouterCodeSplitterWebpack = ( + options?: Partial<Config>, + routerPluginContext?: RouterPluginContext, +) => { + const pluginContext = routerPluginContext ?? defaultRouterPluginContext + return createWebpackPlugin((pluginOptions: Partial<Config> | undefined) => + createRouterCodeSplitterPlugin( + withWebpackHmrStyle(pluginOptions), + pluginContext, + ), + )(options) +} /** * @example @@ -42,7 +81,11 @@ const TanStackRouterCodeSplitterWebpack = /* #__PURE__ */ createWebpackPlugin( * ``` */ const TanStackRouterWebpack = /* #__PURE__ */ createWebpackPlugin( - unpluginRouterComposedFactory, + (options, meta) => + unpluginRouterComposedFactory( + withWebpackHmrStyle(options as Partial<Config> | undefined), + meta, + ), ) const tanstackRouter = TanStackRouterWebpack @@ -54,4 +97,4 @@ export { TanStackRouterCodeSplitterWebpack, tanstackRouter, } -export type { Config, CodeSplittingOptions } +export type { Config, CodeSplittingOptions, RouterPluginContext } diff --git a/packages/router-plugin/tests/add-hmr.test.ts b/packages/router-plugin/tests/add-hmr.test.ts index 8a350dcd89..7cfcd800d0 100644 --- a/packages/router-plugin/tests/add-hmr.test.ts +++ b/packages/router-plugin/tests/add-hmr.test.ts @@ -5,6 +5,7 @@ import { describe, expect, it } from 'vitest' import { compileCodeSplitReferenceRoute } from '../src/core/code-splitter/compilers' import { defaultCodeSplitGroupings } from '../src/core/constants' import { getReferenceRouteCompilerPlugins } from '../src/core/code-splitter/plugins/framework-plugins' +import { createRouteHmrStatement } from '../src/core/hmr' import { frameworks } from './constants' function getFrameworkDir(framework: string) { @@ -69,36 +70,84 @@ describe('add-hmr works', () => { ) }) - it('initializes import.meta.hot.data before storing stable split components', () => { - const code = ` -import * as React from 'react' -import { createFileRoute } from '@tanstack/react-router' - -export const Route = createFileRoute('/posts')({ - component: component, -}) - -function component() { - return <div>posts</div> -} -` + it('supports configurable webpackHot HMR code generation', async () => { + const filename = 'arrow-function.tsx' + const framework = 'react' + const file = await readFile( + path.join(getFrameworkDir(framework).files, filename), + ) + const code = file.toString() const compileResult = compileCodeSplitReferenceRoute({ code, - filename: 'posts.tsx', - id: 'posts.tsx', + filename, + id: filename, addHmr: true, + hmrStyle: 'webpack', codeSplitGroupings: defaultCodeSplitGroupings, - targetFramework: 'react', + targetFramework: framework, compilerPlugins: getReferenceRouteCompilerPlugins({ - targetFramework: 'react', + targetFramework: framework, addHmr: true, + hmrStyle: 'webpack', }), }) - expect(compileResult?.code).toContain('import.meta.hot.data ??= {}') - expect(compileResult?.code).toContain( - 'import.meta.hot.data["tsr-split-component:component"] = TSRSplitComponent', + await expect(compileResult?.code || code).toMatchFileSnapshot( + path.join( + getFrameworkDir(framework).snapshots, + filename.replace('.tsx', '@webpack-hot.tsx'), + ), ) }) + + it('supports configurable webpackHot unsplittable HMR generation', async () => { + const statement = createRouteHmrStatement([], { + hmrStyle: 'webpack', + targetFramework: 'react', + }) + const output = JSON.stringify(statement) + + expect(output).toContain('webpackHot') + expect(output).not.toContain('import.meta.hot') + expect(output).toContain('oldHasShellComponent') + expect(output).toContain('__routeContext') + }) + + it('supports configurable Vite unsplittable HMR generation', async () => { + const statement = createRouteHmrStatement([], { + hmrStyle: 'vite', + targetFramework: 'react', + }) + const output = JSON.stringify(statement) + + expect(output).toContain('MetaProperty') + expect(output).toContain('hot') + expect(output).not.toContain('webpackHot') + expect(output).toContain('newModule') + }) + + it('uses a generated route id fallback for Vite HMR', async () => { + const statement = createRouteHmrStatement([], { + hmrStyle: 'vite', + targetFramework: 'react', + routeId: '/posts', + }) + const output = JSON.stringify(statement) + + expect(output).toContain('tsr-route-id') + expect(output).toContain('/posts') + }) + + it('normalizes the generated root route id for Vite HMR', async () => { + const statement = createRouteHmrStatement([], { + hmrStyle: 'vite', + targetFramework: 'react', + routeId: '/__root', + }) + const output = JSON.stringify(statement) + + expect(output).toContain('__root__') + expect(output).not.toContain('/__root') + }) }) diff --git a/packages/router-plugin/tests/add-hmr/snapshots/react/arrow-function@true.tsx b/packages/router-plugin/tests/add-hmr/snapshots/react/arrow-function@true.tsx index eb4d0cde41..87b7af6c67 100644 --- a/packages/router-plugin/tests/add-hmr/snapshots/react/arrow-function@true.tsx +++ b/packages/router-plugin/tests/add-hmr/snapshots/react/arrow-function@true.tsx @@ -3,16 +3,21 @@ import { lazyRouteComponent } from '@tanstack/react-router'; import * as React from 'react'; import { createFileRoute } from '@tanstack/react-router'; import { fetchPosts } from '../posts'; -const TSRSplitComponent = import.meta.hot?.data?.["tsr-split-component:component"] ?? lazyRouteComponent($$splitComponentImporter, "component"); +const TSRSplitComponent = (() => { + const hot = import.meta.hot; + const hotData = hot ? hot.data ??= {} : undefined; + return hotData?.["tsr-split-component:component"] ?? lazyRouteComponent($$splitComponentImporter, "component"); +})(); if (import.meta.hot) { - import.meta.hot.data ??= {}; - import.meta.hot.data["tsr-split-component:component"] = TSRSplitComponent; + (import.meta.hot.data ??= {})["tsr-split-component:component"] = TSRSplitComponent; } export const Route = createFileRoute('/posts')({ loader: fetchPosts, component: TSRSplitComponent }); -if (import.meta.hot && typeof window !== 'undefined') { +const hot = import.meta.hot; +if (hot && typeof window !== 'undefined') { + hot.data ??= {}; const tsrReactRefresh = window.__TSR_REACT_REFRESH__ ??= (() => { const ignoredExportsById = new Map(); const previousGetIgnoredExports = window.__getReactRefreshIgnoredExports; @@ -31,11 +36,13 @@ export function TSRFastRefreshAnchor() { return null; } if (import.meta.hot) { - import.meta.hot.accept(newModule => { + const hot = import.meta.hot; + const hotData = hot.data ??= {}; + hot.accept(newModule => { if (Route && newModule && newModule.Route) { - const routeId = import.meta.hot.data['tsr-route-id'] ?? Route.id; + const routeId = hotData['tsr-route-id'] ?? Route.id; if (routeId) { - import.meta.hot.data['tsr-route-id'] = routeId; + hotData['tsr-route-id'] = routeId; } (function handleRouteUpdate(routeId, newRoute) { const router = window.__TSR_ROUTER__; @@ -44,42 +51,54 @@ if (import.meta.hot) { return; } ; + const generatedRouteOptionKeys = new Set(["id", "path", "getParentRoute"]); + const generatedRouteOptions = {}; + generatedRouteOptionKeys.forEach(key => { + if (key in oldRoute.options) { + generatedRouteOptions[key] = oldRoute.options[key]; + } + }); const removedKeys = new Set(); Object.keys(oldRoute.options).forEach(key => { - if (!(key in newRoute.options)) { + if (!generatedRouteOptionKeys.has(key) && !(key in newRoute.options)) { removedKeys.add(key); delete oldRoute.options[key]; } }); + const oldHasShellComponent = "shellComponent" in oldRoute.options; + const newHasShellComponent = "shellComponent" in newRoute.options; + const preserveComponentIdentity = oldHasShellComponent === newHasShellComponent; const componentKeys = ["component", "shellComponent", "pendingComponent", "errorComponent", "notFoundComponent"]; - componentKeys.forEach(key => { - if (key in oldRoute.options && key in newRoute.options) { - newRoute.options[key] = oldRoute.options[key]; - } - }); - oldRoute.options = newRoute.options; - oldRoute.update(newRoute.options); + if (preserveComponentIdentity) { + componentKeys.forEach(key => { + if (key in oldRoute.options && key in newRoute.options) { + newRoute.options[key] = oldRoute.options[key]; + } + }); + } + ; + const nextOptions = { + ...newRoute.options, + ...generatedRouteOptions + }; + oldRoute.options = nextOptions; + oldRoute.update(nextOptions); oldRoute._componentsPromise = undefined; oldRoute._lazyPromise = undefined; - router.routesById[oldRoute.id] = oldRoute; - router.routesByPath[oldRoute.fullPath] = oldRoute; - router.processedTree.matchCache.clear(); - router.processedTree.flatCache?.clear(); - router.processedTree.singleCache.clear(); + router.setRoutes(router.buildRouteTree()); router.resolvePathCache.clear(); - walkReplaceSegmentTree(oldRoute, router.processedTree.segmentTree); const filter = m => m.routeId === oldRoute.id; - const activeMatch = router.stores.activeMatchesSnapshot.state.find(filter); - const pendingMatch = router.stores.pendingMatchesSnapshot.state.find(filter); - const cachedMatches = router.stores.cachedMatchesSnapshot.state.filter(filter); + const activeMatch = router.stores.matches.get().find(filter); + const pendingMatch = router.stores.pendingMatches.get().find(filter); + const cachedMatches = router.stores.cachedMatches.get().filter(filter); if (activeMatch || pendingMatch || cachedMatches.length > 0) { if (removedKeys.has("loader") || removedKeys.has("beforeLoad")) { const matchIds = [activeMatch?.id, pendingMatch?.id, ...cachedMatches.map(match => match.id)].filter(Boolean); router.batch(() => { for (const matchId of matchIds) { - const store = router.stores.pendingMatchStoresById.get(matchId) || router.stores.activeMatchStoresById.get(matchId) || router.stores.cachedMatchStoresById.get(matchId); + const store = router.stores.pendingMatchStores.get(matchId) || router.stores.matchStores.get(matchId) || router.stores.cachedMatchStores.get(matchId); if (store) { - store.setState(prev => { + store.set(prev => { const next = { ...prev }; @@ -89,6 +108,7 @@ if (import.meta.hot) { ; if (removedKeys.has("beforeLoad")) { next.__beforeLoadContext = undefined; + next.context = rebuildMatchContextWithoutBeforeLoad(next); } ; return next; @@ -104,14 +124,45 @@ if (import.meta.hot) { }); } ; - function walkReplaceSegmentTree(route, node) { - if (node.route?.id === route.id) node.route = route; - if (node.index) walkReplaceSegmentTree(route, node.index); - node.static?.forEach(child => walkReplaceSegmentTree(route, child)); - node.staticInsensitive?.forEach(child => walkReplaceSegmentTree(route, child)); - node.dynamic?.forEach(child => walkReplaceSegmentTree(route, child)); - node.optional?.forEach(child => walkReplaceSegmentTree(route, child)); - node.wildcard?.forEach(child => walkReplaceSegmentTree(route, child)); + function getStoreMatch(matchId) { + return router.stores.pendingMatchStores.get(matchId)?.get() || router.stores.matchStores.get(matchId)?.get() || router.stores.cachedMatchStores.get(matchId)?.get(); + } + function getMatchList(matchId) { + const pendingMatches = router.stores.pendingMatches.get(); + if (pendingMatches.some(match => match.id === matchId)) { + return pendingMatches; + } + ; + const activeMatches = router.stores.matches.get(); + if (activeMatches.some(match => match.id === matchId)) { + return activeMatches; + } + ; + const cachedMatches = router.stores.cachedMatches.get(); + if (cachedMatches.some(match => match.id === matchId)) { + return cachedMatches; + } + ; + return []; + } + function getParentMatch(match) { + const matchList = getMatchList(match.id); + const matchIndex = matchList.findIndex(item => item.id === match.id); + if (matchIndex <= 0) { + return undefined; + } + ; + const parentMatch = matchList[matchIndex - 1]; + return getStoreMatch(parentMatch.id) || parentMatch; + } + function rebuildMatchContextWithoutBeforeLoad(match) { + const parentMatch = getParentMatch(match); + const getParentContext = router.getParentContext; + const parentContext = getParentContext ? getParentContext.call(router, parentMatch) : parentMatch?.context ?? router.options.context; + return { + ...(parentContext ?? {}), + ...(match.__routeContext ?? {}) + }; } })(routeId, newModule.Route); } diff --git a/packages/router-plugin/tests/add-hmr/snapshots/react/arrow-function@webpack-hot.tsx b/packages/router-plugin/tests/add-hmr/snapshots/react/arrow-function@webpack-hot.tsx new file mode 100644 index 0000000000..6466a24285 --- /dev/null +++ b/packages/router-plugin/tests/add-hmr/snapshots/react/arrow-function@webpack-hot.tsx @@ -0,0 +1,162 @@ +const $$splitComponentImporter = () => import('arrow-function.tsx?tsr-split=component'); +import { lazyRouteComponent } from '@tanstack/react-router'; +import * as React from 'react'; +import { createFileRoute } from '@tanstack/react-router'; +import { fetchPosts } from '../posts'; +const TSRSplitComponent = (() => { + const hot = import.meta.webpackHot; + const hotData = hot ? hot.data ??= {} : undefined; + return hotData?.["tsr-split-component:component"] ?? lazyRouteComponent($$splitComponentImporter, "component"); +})(); +if (import.meta.webpackHot) { + (import.meta.webpackHot.data ??= {})["tsr-split-component:component"] = TSRSplitComponent; +} +export const Route = createFileRoute('/posts')({ + loader: fetchPosts, + component: TSRSplitComponent +}); +if (import.meta.webpackHot) { + const hot = import.meta.webpackHot; + const hotData = hot.data ??= {}; + const routeId = hotData['tsr-route-id'] ?? Route.id ?? (Route.isRoot ? '__root__' : undefined); + if (routeId) { + hotData['tsr-route-id'] = routeId; + } + const existingRoute = typeof window !== 'undefined' && routeId ? window.__TSR_ROUTER__?.routesById?.[routeId] : undefined; + if (routeId && existingRoute && existingRoute !== Route) { + (function handleRouteUpdate(routeId, newRoute) { + const router = window.__TSR_ROUTER__; + const oldRoute = router.routesById[routeId]; + if (!oldRoute) { + return; + } + ; + const generatedRouteOptionKeys = new Set(["id", "path", "getParentRoute"]); + const generatedRouteOptions = {}; + generatedRouteOptionKeys.forEach(key => { + if (key in oldRoute.options) { + generatedRouteOptions[key] = oldRoute.options[key]; + } + }); + const removedKeys = new Set(); + Object.keys(oldRoute.options).forEach(key => { + if (!generatedRouteOptionKeys.has(key) && !(key in newRoute.options)) { + removedKeys.add(key); + delete oldRoute.options[key]; + } + }); + const oldHasShellComponent = "shellComponent" in oldRoute.options; + const newHasShellComponent = "shellComponent" in newRoute.options; + const preserveComponentIdentity = oldHasShellComponent === newHasShellComponent; + const componentKeys = ["component", "shellComponent", "pendingComponent", "errorComponent", "notFoundComponent"]; + if (preserveComponentIdentity) { + componentKeys.forEach(key => { + if (key in oldRoute.options && key in newRoute.options) { + newRoute.options[key] = oldRoute.options[key]; + } + }); + } + ; + const nextOptions = { + ...newRoute.options, + ...generatedRouteOptions + }; + oldRoute.options = nextOptions; + oldRoute.update(nextOptions); + oldRoute._componentsPromise = undefined; + oldRoute._lazyPromise = undefined; + router.setRoutes(router.buildRouteTree()); + router.resolvePathCache.clear(); + const filter = m => m.routeId === oldRoute.id; + const activeMatch = router.stores.matches.get().find(filter); + const pendingMatch = router.stores.pendingMatches.get().find(filter); + const cachedMatches = router.stores.cachedMatches.get().filter(filter); + if (activeMatch || pendingMatch || cachedMatches.length > 0) { + if (removedKeys.has("loader") || removedKeys.has("beforeLoad")) { + const matchIds = [activeMatch?.id, pendingMatch?.id, ...cachedMatches.map(match => match.id)].filter(Boolean); + router.batch(() => { + for (const matchId of matchIds) { + const store = router.stores.pendingMatchStores.get(matchId) || router.stores.matchStores.get(matchId) || router.stores.cachedMatchStores.get(matchId); + if (store) { + store.set(prev => { + const next = { + ...prev + }; + if (removedKeys.has("loader")) { + next.loaderData = undefined; + } + ; + if (removedKeys.has("beforeLoad")) { + next.__beforeLoadContext = undefined; + next.context = rebuildMatchContextWithoutBeforeLoad(next); + } + ; + return next; + }); + } + } + }); + } + ; + router.invalidate({ + filter, + sync: true + }); + } + ; + function getStoreMatch(matchId) { + return router.stores.pendingMatchStores.get(matchId)?.get() || router.stores.matchStores.get(matchId)?.get() || router.stores.cachedMatchStores.get(matchId)?.get(); + } + function getMatchList(matchId) { + const pendingMatches = router.stores.pendingMatches.get(); + if (pendingMatches.some(match => match.id === matchId)) { + return pendingMatches; + } + ; + const activeMatches = router.stores.matches.get(); + if (activeMatches.some(match => match.id === matchId)) { + return activeMatches; + } + ; + const cachedMatches = router.stores.cachedMatches.get(); + if (cachedMatches.some(match => match.id === matchId)) { + return cachedMatches; + } + ; + return []; + } + function getParentMatch(match) { + const matchList = getMatchList(match.id); + const matchIndex = matchList.findIndex(item => item.id === match.id); + if (matchIndex <= 0) { + return undefined; + } + ; + const parentMatch = matchList[matchIndex - 1]; + return getStoreMatch(parentMatch.id) || parentMatch; + } + function rebuildMatchContextWithoutBeforeLoad(match) { + const parentMatch = getParentMatch(match); + const getParentContext = router.getParentContext; + const parentContext = getParentContext ? getParentContext.call(router, parentMatch) : parentMatch?.context ?? router.options.context; + return { + ...(parentContext ?? {}), + ...(match.__routeContext ?? {}) + }; + } + })(routeId, Route); + try { + const tsrReactRefreshUtils = typeof __react_refresh_utils__ !== 'undefined' ? __react_refresh_utils__ : undefined; + const tsrEnqueueUpdate = tsrReactRefreshUtils && typeof tsrReactRefreshUtils.enqueueUpdate === 'function' ? tsrReactRefreshUtils.enqueueUpdate : undefined; + if (tsrEnqueueUpdate) { + tsrEnqueueUpdate(() => {}); + } + } catch (_err) {} + } + hot.dispose(data => { + if (routeId) { + data['tsr-route-id'] = routeId; + } + }); + hot.accept(); +} \ No newline at end of file diff --git a/packages/router-plugin/tests/add-hmr/snapshots/react/createRootRoute-inline-component@true.tsx b/packages/router-plugin/tests/add-hmr/snapshots/react/createRootRoute-inline-component@true.tsx index 7ccb71595c..146ad344b4 100644 --- a/packages/router-plugin/tests/add-hmr/snapshots/react/createRootRoute-inline-component@true.tsx +++ b/packages/router-plugin/tests/add-hmr/snapshots/react/createRootRoute-inline-component@true.tsx @@ -4,7 +4,9 @@ const TSRComponent = () => <div>root hmr</div>; export const Route = createRootRoute({ component: TSRComponent }); -if (import.meta.hot && typeof window !== 'undefined') { +const hot = import.meta.hot; +if (hot && typeof window !== 'undefined') { + hot.data ??= {}; const tsrReactRefresh = window.__TSR_REACT_REFRESH__ ??= (() => { const ignoredExportsById = new Map(); const previousGetIgnoredExports = window.__getReactRefreshIgnoredExports; @@ -23,11 +25,13 @@ export function TSRFastRefreshAnchor() { return null; } if (import.meta.hot) { - import.meta.hot.accept(newModule => { + const hot = import.meta.hot; + const hotData = hot.data ??= {}; + hot.accept(newModule => { if (Route && newModule && newModule.Route) { - const routeId = import.meta.hot.data['tsr-route-id'] ?? Route.id; + const routeId = hotData['tsr-route-id'] ?? Route.id; if (routeId) { - import.meta.hot.data['tsr-route-id'] = routeId; + hotData['tsr-route-id'] = routeId; } (function handleRouteUpdate(routeId, newRoute) { const router = window.__TSR_ROUTER__; @@ -36,42 +40,54 @@ if (import.meta.hot) { return; } ; + const generatedRouteOptionKeys = new Set(["id", "path", "getParentRoute"]); + const generatedRouteOptions = {}; + generatedRouteOptionKeys.forEach(key => { + if (key in oldRoute.options) { + generatedRouteOptions[key] = oldRoute.options[key]; + } + }); const removedKeys = new Set(); Object.keys(oldRoute.options).forEach(key => { - if (!(key in newRoute.options)) { + if (!generatedRouteOptionKeys.has(key) && !(key in newRoute.options)) { removedKeys.add(key); delete oldRoute.options[key]; } }); + const oldHasShellComponent = "shellComponent" in oldRoute.options; + const newHasShellComponent = "shellComponent" in newRoute.options; + const preserveComponentIdentity = oldHasShellComponent === newHasShellComponent; const componentKeys = ["component", "shellComponent", "pendingComponent", "errorComponent", "notFoundComponent"]; - componentKeys.forEach(key => { - if (key in oldRoute.options && key in newRoute.options) { - newRoute.options[key] = oldRoute.options[key]; - } - }); - oldRoute.options = newRoute.options; - oldRoute.update(newRoute.options); + if (preserveComponentIdentity) { + componentKeys.forEach(key => { + if (key in oldRoute.options && key in newRoute.options) { + newRoute.options[key] = oldRoute.options[key]; + } + }); + } + ; + const nextOptions = { + ...newRoute.options, + ...generatedRouteOptions + }; + oldRoute.options = nextOptions; + oldRoute.update(nextOptions); oldRoute._componentsPromise = undefined; oldRoute._lazyPromise = undefined; - router.routesById[oldRoute.id] = oldRoute; - router.routesByPath[oldRoute.fullPath] = oldRoute; - router.processedTree.matchCache.clear(); - router.processedTree.flatCache?.clear(); - router.processedTree.singleCache.clear(); + router.setRoutes(router.buildRouteTree()); router.resolvePathCache.clear(); - walkReplaceSegmentTree(oldRoute, router.processedTree.segmentTree); const filter = m => m.routeId === oldRoute.id; - const activeMatch = router.stores.activeMatchesSnapshot.state.find(filter); - const pendingMatch = router.stores.pendingMatchesSnapshot.state.find(filter); - const cachedMatches = router.stores.cachedMatchesSnapshot.state.filter(filter); + const activeMatch = router.stores.matches.get().find(filter); + const pendingMatch = router.stores.pendingMatches.get().find(filter); + const cachedMatches = router.stores.cachedMatches.get().filter(filter); if (activeMatch || pendingMatch || cachedMatches.length > 0) { if (removedKeys.has("loader") || removedKeys.has("beforeLoad")) { const matchIds = [activeMatch?.id, pendingMatch?.id, ...cachedMatches.map(match => match.id)].filter(Boolean); router.batch(() => { for (const matchId of matchIds) { - const store = router.stores.pendingMatchStoresById.get(matchId) || router.stores.activeMatchStoresById.get(matchId) || router.stores.cachedMatchStoresById.get(matchId); + const store = router.stores.pendingMatchStores.get(matchId) || router.stores.matchStores.get(matchId) || router.stores.cachedMatchStores.get(matchId); if (store) { - store.setState(prev => { + store.set(prev => { const next = { ...prev }; @@ -81,6 +97,7 @@ if (import.meta.hot) { ; if (removedKeys.has("beforeLoad")) { next.__beforeLoadContext = undefined; + next.context = rebuildMatchContextWithoutBeforeLoad(next); } ; return next; @@ -96,14 +113,45 @@ if (import.meta.hot) { }); } ; - function walkReplaceSegmentTree(route, node) { - if (node.route?.id === route.id) node.route = route; - if (node.index) walkReplaceSegmentTree(route, node.index); - node.static?.forEach(child => walkReplaceSegmentTree(route, child)); - node.staticInsensitive?.forEach(child => walkReplaceSegmentTree(route, child)); - node.dynamic?.forEach(child => walkReplaceSegmentTree(route, child)); - node.optional?.forEach(child => walkReplaceSegmentTree(route, child)); - node.wildcard?.forEach(child => walkReplaceSegmentTree(route, child)); + function getStoreMatch(matchId) { + return router.stores.pendingMatchStores.get(matchId)?.get() || router.stores.matchStores.get(matchId)?.get() || router.stores.cachedMatchStores.get(matchId)?.get(); + } + function getMatchList(matchId) { + const pendingMatches = router.stores.pendingMatches.get(); + if (pendingMatches.some(match => match.id === matchId)) { + return pendingMatches; + } + ; + const activeMatches = router.stores.matches.get(); + if (activeMatches.some(match => match.id === matchId)) { + return activeMatches; + } + ; + const cachedMatches = router.stores.cachedMatches.get(); + if (cachedMatches.some(match => match.id === matchId)) { + return cachedMatches; + } + ; + return []; + } + function getParentMatch(match) { + const matchList = getMatchList(match.id); + const matchIndex = matchList.findIndex(item => item.id === match.id); + if (matchIndex <= 0) { + return undefined; + } + ; + const parentMatch = matchList[matchIndex - 1]; + return getStoreMatch(parentMatch.id) || parentMatch; + } + function rebuildMatchContextWithoutBeforeLoad(match) { + const parentMatch = getParentMatch(match); + const getParentContext = router.getParentContext; + const parentContext = getParentContext ? getParentContext.call(router, parentMatch) : parentMatch?.context ?? router.options.context; + return { + ...(parentContext ?? {}), + ...(match.__routeContext ?? {}) + }; } })(routeId, newModule.Route); } diff --git a/packages/router-plugin/tests/add-hmr/snapshots/react/createRootRoute@false.tsx b/packages/router-plugin/tests/add-hmr/snapshots/react/createRootRoute@false.tsx new file mode 100644 index 0000000000..e967791f8d --- /dev/null +++ b/packages/router-plugin/tests/add-hmr/snapshots/react/createRootRoute@false.tsx @@ -0,0 +1,10 @@ +import * as React from 'react' +import { createRootRoute } from '@tanstack/react-router' + +export const Route = createRootRoute({ + component: RootComponent, +}) + +function RootComponent() { + return <div>Hello</div> +} diff --git a/packages/router-plugin/tests/add-hmr/snapshots/react/createRootRoute@true.tsx b/packages/router-plugin/tests/add-hmr/snapshots/react/createRootRoute@true.tsx new file mode 100644 index 0000000000..098bc0d7dc --- /dev/null +++ b/packages/router-plugin/tests/add-hmr/snapshots/react/createRootRoute@true.tsx @@ -0,0 +1,161 @@ +import * as React from 'react'; +import { createRootRoute } from '@tanstack/react-router'; +export const Route = createRootRoute({ + component: RootComponent +}); +function RootComponent() { + return <div>Hello</div>; +} +const hot = import.meta.hot; +if (hot && typeof window !== 'undefined') { + hot.data ??= {}; + const tsrReactRefresh = window.__TSR_REACT_REFRESH__ ??= (() => { + const ignoredExportsById = new Map(); + const previousGetIgnoredExports = window.__getReactRefreshIgnoredExports; + window.__getReactRefreshIgnoredExports = ctx => { + const ignoredExports = previousGetIgnoredExports?.(ctx) ?? []; + const moduleIgnored = ignoredExportsById.get(ctx.id) ?? []; + return [...ignoredExports, ...moduleIgnored]; + }; + return { + ignoredExportsById + }; + })(); + tsrReactRefresh.ignoredExportsById.set("createRootRoute.tsx", ['Route']); +} +export function TSRFastRefreshAnchor() { + return null; +} +if (import.meta.hot) { + const hot = import.meta.hot; + const hotData = hot.data ??= {}; + hot.accept(newModule => { + if (Route && newModule && newModule.Route) { + const routeId = hotData['tsr-route-id'] ?? Route.id; + if (routeId) { + hotData['tsr-route-id'] = routeId; + } + (function handleRouteUpdate(routeId, newRoute) { + const router = window.__TSR_ROUTER__; + const oldRoute = router.routesById[routeId]; + if (!oldRoute) { + return; + } + ; + const generatedRouteOptionKeys = new Set(["id", "path", "getParentRoute"]); + const generatedRouteOptions = {}; + generatedRouteOptionKeys.forEach(key => { + if (key in oldRoute.options) { + generatedRouteOptions[key] = oldRoute.options[key]; + } + }); + const removedKeys = new Set(); + Object.keys(oldRoute.options).forEach(key => { + if (!generatedRouteOptionKeys.has(key) && !(key in newRoute.options)) { + removedKeys.add(key); + delete oldRoute.options[key]; + } + }); + const oldHasShellComponent = "shellComponent" in oldRoute.options; + const newHasShellComponent = "shellComponent" in newRoute.options; + const preserveComponentIdentity = oldHasShellComponent === newHasShellComponent; + const componentKeys = ["component", "shellComponent", "pendingComponent", "errorComponent", "notFoundComponent"]; + if (preserveComponentIdentity) { + componentKeys.forEach(key => { + if (key in oldRoute.options && key in newRoute.options) { + newRoute.options[key] = oldRoute.options[key]; + } + }); + } + ; + const nextOptions = { + ...newRoute.options, + ...generatedRouteOptions + }; + oldRoute.options = nextOptions; + oldRoute.update(nextOptions); + oldRoute._componentsPromise = undefined; + oldRoute._lazyPromise = undefined; + router.setRoutes(router.buildRouteTree()); + router.resolvePathCache.clear(); + const filter = m => m.routeId === oldRoute.id; + const activeMatch = router.stores.matches.get().find(filter); + const pendingMatch = router.stores.pendingMatches.get().find(filter); + const cachedMatches = router.stores.cachedMatches.get().filter(filter); + if (activeMatch || pendingMatch || cachedMatches.length > 0) { + if (removedKeys.has("loader") || removedKeys.has("beforeLoad")) { + const matchIds = [activeMatch?.id, pendingMatch?.id, ...cachedMatches.map(match => match.id)].filter(Boolean); + router.batch(() => { + for (const matchId of matchIds) { + const store = router.stores.pendingMatchStores.get(matchId) || router.stores.matchStores.get(matchId) || router.stores.cachedMatchStores.get(matchId); + if (store) { + store.set(prev => { + const next = { + ...prev + }; + if (removedKeys.has("loader")) { + next.loaderData = undefined; + } + ; + if (removedKeys.has("beforeLoad")) { + next.__beforeLoadContext = undefined; + next.context = rebuildMatchContextWithoutBeforeLoad(next); + } + ; + return next; + }); + } + } + }); + } + ; + router.invalidate({ + filter, + sync: true + }); + } + ; + function getStoreMatch(matchId) { + return router.stores.pendingMatchStores.get(matchId)?.get() || router.stores.matchStores.get(matchId)?.get() || router.stores.cachedMatchStores.get(matchId)?.get(); + } + function getMatchList(matchId) { + const pendingMatches = router.stores.pendingMatches.get(); + if (pendingMatches.some(match => match.id === matchId)) { + return pendingMatches; + } + ; + const activeMatches = router.stores.matches.get(); + if (activeMatches.some(match => match.id === matchId)) { + return activeMatches; + } + ; + const cachedMatches = router.stores.cachedMatches.get(); + if (cachedMatches.some(match => match.id === matchId)) { + return cachedMatches; + } + ; + return []; + } + function getParentMatch(match) { + const matchList = getMatchList(match.id); + const matchIndex = matchList.findIndex(item => item.id === match.id); + if (matchIndex <= 0) { + return undefined; + } + ; + const parentMatch = matchList[matchIndex - 1]; + return getStoreMatch(parentMatch.id) || parentMatch; + } + function rebuildMatchContextWithoutBeforeLoad(match) { + const parentMatch = getParentMatch(match); + const getParentContext = router.getParentContext; + const parentContext = getParentContext ? getParentContext.call(router, parentMatch) : parentMatch?.context ?? router.options.context; + return { + ...(parentContext ?? {}), + ...(match.__routeContext ?? {}) + }; + } + })(routeId, newModule.Route); + } + }); +} \ No newline at end of file diff --git a/packages/router-plugin/tests/add-hmr/snapshots/react/createRootRouteWithContext-type-args@false.tsx b/packages/router-plugin/tests/add-hmr/snapshots/react/createRootRouteWithContext-type-args@false.tsx new file mode 100644 index 0000000000..0feadacab5 --- /dev/null +++ b/packages/router-plugin/tests/add-hmr/snapshots/react/createRootRouteWithContext-type-args@false.tsx @@ -0,0 +1,14 @@ +import * as React from 'react' +import { createRootRouteWithContext } from '@tanstack/react-router' + +interface MyRouterContext { + auth: boolean +} + +export const Route = createRootRouteWithContext<MyRouterContext>()({ + component: RootComponent, +}) + +function RootComponent() { + return <div>Hello</div> +} diff --git a/packages/router-plugin/tests/add-hmr/snapshots/react/createRootRouteWithContext-type-args@true.tsx b/packages/router-plugin/tests/add-hmr/snapshots/react/createRootRouteWithContext-type-args@true.tsx new file mode 100644 index 0000000000..877680a18b --- /dev/null +++ b/packages/router-plugin/tests/add-hmr/snapshots/react/createRootRouteWithContext-type-args@true.tsx @@ -0,0 +1,164 @@ +import * as React from 'react'; +import { createRootRouteWithContext } from '@tanstack/react-router'; +interface MyRouterContext { + auth: boolean; +} +export const Route = createRootRouteWithContext<MyRouterContext>()({ + component: RootComponent +}); +function RootComponent() { + return <div>Hello</div>; +} +const hot = import.meta.hot; +if (hot && typeof window !== 'undefined') { + hot.data ??= {}; + const tsrReactRefresh = window.__TSR_REACT_REFRESH__ ??= (() => { + const ignoredExportsById = new Map(); + const previousGetIgnoredExports = window.__getReactRefreshIgnoredExports; + window.__getReactRefreshIgnoredExports = ctx => { + const ignoredExports = previousGetIgnoredExports?.(ctx) ?? []; + const moduleIgnored = ignoredExportsById.get(ctx.id) ?? []; + return [...ignoredExports, ...moduleIgnored]; + }; + return { + ignoredExportsById + }; + })(); + tsrReactRefresh.ignoredExportsById.set("createRootRouteWithContext-type-args.tsx", ['Route']); +} +export function TSRFastRefreshAnchor() { + return null; +} +if (import.meta.hot) { + const hot = import.meta.hot; + const hotData = hot.data ??= {}; + hot.accept(newModule => { + if (Route && newModule && newModule.Route) { + const routeId = hotData['tsr-route-id'] ?? Route.id; + if (routeId) { + hotData['tsr-route-id'] = routeId; + } + (function handleRouteUpdate(routeId, newRoute) { + const router = window.__TSR_ROUTER__; + const oldRoute = router.routesById[routeId]; + if (!oldRoute) { + return; + } + ; + const generatedRouteOptionKeys = new Set(["id", "path", "getParentRoute"]); + const generatedRouteOptions = {}; + generatedRouteOptionKeys.forEach(key => { + if (key in oldRoute.options) { + generatedRouteOptions[key] = oldRoute.options[key]; + } + }); + const removedKeys = new Set(); + Object.keys(oldRoute.options).forEach(key => { + if (!generatedRouteOptionKeys.has(key) && !(key in newRoute.options)) { + removedKeys.add(key); + delete oldRoute.options[key]; + } + }); + const oldHasShellComponent = "shellComponent" in oldRoute.options; + const newHasShellComponent = "shellComponent" in newRoute.options; + const preserveComponentIdentity = oldHasShellComponent === newHasShellComponent; + const componentKeys = ["component", "shellComponent", "pendingComponent", "errorComponent", "notFoundComponent"]; + if (preserveComponentIdentity) { + componentKeys.forEach(key => { + if (key in oldRoute.options && key in newRoute.options) { + newRoute.options[key] = oldRoute.options[key]; + } + }); + } + ; + const nextOptions = { + ...newRoute.options, + ...generatedRouteOptions + }; + oldRoute.options = nextOptions; + oldRoute.update(nextOptions); + oldRoute._componentsPromise = undefined; + oldRoute._lazyPromise = undefined; + router.setRoutes(router.buildRouteTree()); + router.resolvePathCache.clear(); + const filter = m => m.routeId === oldRoute.id; + const activeMatch = router.stores.matches.get().find(filter); + const pendingMatch = router.stores.pendingMatches.get().find(filter); + const cachedMatches = router.stores.cachedMatches.get().filter(filter); + if (activeMatch || pendingMatch || cachedMatches.length > 0) { + if (removedKeys.has("loader") || removedKeys.has("beforeLoad")) { + const matchIds = [activeMatch?.id, pendingMatch?.id, ...cachedMatches.map(match => match.id)].filter(Boolean); + router.batch(() => { + for (const matchId of matchIds) { + const store = router.stores.pendingMatchStores.get(matchId) || router.stores.matchStores.get(matchId) || router.stores.cachedMatchStores.get(matchId); + if (store) { + store.set(prev => { + const next = { + ...prev + }; + if (removedKeys.has("loader")) { + next.loaderData = undefined; + } + ; + if (removedKeys.has("beforeLoad")) { + next.__beforeLoadContext = undefined; + next.context = rebuildMatchContextWithoutBeforeLoad(next); + } + ; + return next; + }); + } + } + }); + } + ; + router.invalidate({ + filter, + sync: true + }); + } + ; + function getStoreMatch(matchId) { + return router.stores.pendingMatchStores.get(matchId)?.get() || router.stores.matchStores.get(matchId)?.get() || router.stores.cachedMatchStores.get(matchId)?.get(); + } + function getMatchList(matchId) { + const pendingMatches = router.stores.pendingMatches.get(); + if (pendingMatches.some(match => match.id === matchId)) { + return pendingMatches; + } + ; + const activeMatches = router.stores.matches.get(); + if (activeMatches.some(match => match.id === matchId)) { + return activeMatches; + } + ; + const cachedMatches = router.stores.cachedMatches.get(); + if (cachedMatches.some(match => match.id === matchId)) { + return cachedMatches; + } + ; + return []; + } + function getParentMatch(match) { + const matchList = getMatchList(match.id); + const matchIndex = matchList.findIndex(item => item.id === match.id); + if (matchIndex <= 0) { + return undefined; + } + ; + const parentMatch = matchList[matchIndex - 1]; + return getStoreMatch(parentMatch.id) || parentMatch; + } + function rebuildMatchContextWithoutBeforeLoad(match) { + const parentMatch = getParentMatch(match); + const getParentContext = router.getParentContext; + const parentContext = getParentContext ? getParentContext.call(router, parentMatch) : parentMatch?.context ?? router.options.context; + return { + ...(parentContext ?? {}), + ...(match.__routeContext ?? {}) + }; + } + })(routeId, newModule.Route); + } + }); +} \ No newline at end of file diff --git a/packages/router-plugin/tests/add-hmr/snapshots/react/explicit-undefined-component@true.tsx b/packages/router-plugin/tests/add-hmr/snapshots/react/explicit-undefined-component@true.tsx index 4c24fe967c..ba595db5bb 100644 --- a/packages/router-plugin/tests/add-hmr/snapshots/react/explicit-undefined-component@true.tsx +++ b/packages/router-plugin/tests/add-hmr/snapshots/react/explicit-undefined-component@true.tsx @@ -3,7 +3,9 @@ import { createFileRoute } from '@tanstack/react-router'; export const Route = createFileRoute('/')({ component: undefined }); -if (import.meta.hot && typeof window !== 'undefined') { +const hot = import.meta.hot; +if (hot && typeof window !== 'undefined') { + hot.data ??= {}; const tsrReactRefresh = window.__TSR_REACT_REFRESH__ ??= (() => { const ignoredExportsById = new Map(); const previousGetIgnoredExports = window.__getReactRefreshIgnoredExports; @@ -22,11 +24,13 @@ export function TSRFastRefreshAnchor() { return null; } if (import.meta.hot) { - import.meta.hot.accept(newModule => { + const hot = import.meta.hot; + const hotData = hot.data ??= {}; + hot.accept(newModule => { if (Route && newModule && newModule.Route) { - const routeId = import.meta.hot.data['tsr-route-id'] ?? Route.id; + const routeId = hotData['tsr-route-id'] ?? Route.id; if (routeId) { - import.meta.hot.data['tsr-route-id'] = routeId; + hotData['tsr-route-id'] = routeId; } (function handleRouteUpdate(routeId, newRoute) { const router = window.__TSR_ROUTER__; @@ -35,42 +39,54 @@ if (import.meta.hot) { return; } ; + const generatedRouteOptionKeys = new Set(["id", "path", "getParentRoute"]); + const generatedRouteOptions = {}; + generatedRouteOptionKeys.forEach(key => { + if (key in oldRoute.options) { + generatedRouteOptions[key] = oldRoute.options[key]; + } + }); const removedKeys = new Set(); Object.keys(oldRoute.options).forEach(key => { - if (!(key in newRoute.options)) { + if (!generatedRouteOptionKeys.has(key) && !(key in newRoute.options)) { removedKeys.add(key); delete oldRoute.options[key]; } }); + const oldHasShellComponent = "shellComponent" in oldRoute.options; + const newHasShellComponent = "shellComponent" in newRoute.options; + const preserveComponentIdentity = oldHasShellComponent === newHasShellComponent; const componentKeys = ["component", "shellComponent", "pendingComponent", "errorComponent", "notFoundComponent"]; - componentKeys.forEach(key => { - if (key in oldRoute.options && key in newRoute.options) { - newRoute.options[key] = oldRoute.options[key]; - } - }); - oldRoute.options = newRoute.options; - oldRoute.update(newRoute.options); + if (preserveComponentIdentity) { + componentKeys.forEach(key => { + if (key in oldRoute.options && key in newRoute.options) { + newRoute.options[key] = oldRoute.options[key]; + } + }); + } + ; + const nextOptions = { + ...newRoute.options, + ...generatedRouteOptions + }; + oldRoute.options = nextOptions; + oldRoute.update(nextOptions); oldRoute._componentsPromise = undefined; oldRoute._lazyPromise = undefined; - router.routesById[oldRoute.id] = oldRoute; - router.routesByPath[oldRoute.fullPath] = oldRoute; - router.processedTree.matchCache.clear(); - router.processedTree.flatCache?.clear(); - router.processedTree.singleCache.clear(); + router.setRoutes(router.buildRouteTree()); router.resolvePathCache.clear(); - walkReplaceSegmentTree(oldRoute, router.processedTree.segmentTree); const filter = m => m.routeId === oldRoute.id; - const activeMatch = router.stores.activeMatchesSnapshot.state.find(filter); - const pendingMatch = router.stores.pendingMatchesSnapshot.state.find(filter); - const cachedMatches = router.stores.cachedMatchesSnapshot.state.filter(filter); + const activeMatch = router.stores.matches.get().find(filter); + const pendingMatch = router.stores.pendingMatches.get().find(filter); + const cachedMatches = router.stores.cachedMatches.get().filter(filter); if (activeMatch || pendingMatch || cachedMatches.length > 0) { if (removedKeys.has("loader") || removedKeys.has("beforeLoad")) { const matchIds = [activeMatch?.id, pendingMatch?.id, ...cachedMatches.map(match => match.id)].filter(Boolean); router.batch(() => { for (const matchId of matchIds) { - const store = router.stores.pendingMatchStoresById.get(matchId) || router.stores.activeMatchStoresById.get(matchId) || router.stores.cachedMatchStoresById.get(matchId); + const store = router.stores.pendingMatchStores.get(matchId) || router.stores.matchStores.get(matchId) || router.stores.cachedMatchStores.get(matchId); if (store) { - store.setState(prev => { + store.set(prev => { const next = { ...prev }; @@ -80,6 +96,7 @@ if (import.meta.hot) { ; if (removedKeys.has("beforeLoad")) { next.__beforeLoadContext = undefined; + next.context = rebuildMatchContextWithoutBeforeLoad(next); } ; return next; @@ -95,14 +112,45 @@ if (import.meta.hot) { }); } ; - function walkReplaceSegmentTree(route, node) { - if (node.route?.id === route.id) node.route = route; - if (node.index) walkReplaceSegmentTree(route, node.index); - node.static?.forEach(child => walkReplaceSegmentTree(route, child)); - node.staticInsensitive?.forEach(child => walkReplaceSegmentTree(route, child)); - node.dynamic?.forEach(child => walkReplaceSegmentTree(route, child)); - node.optional?.forEach(child => walkReplaceSegmentTree(route, child)); - node.wildcard?.forEach(child => walkReplaceSegmentTree(route, child)); + function getStoreMatch(matchId) { + return router.stores.pendingMatchStores.get(matchId)?.get() || router.stores.matchStores.get(matchId)?.get() || router.stores.cachedMatchStores.get(matchId)?.get(); + } + function getMatchList(matchId) { + const pendingMatches = router.stores.pendingMatches.get(); + if (pendingMatches.some(match => match.id === matchId)) { + return pendingMatches; + } + ; + const activeMatches = router.stores.matches.get(); + if (activeMatches.some(match => match.id === matchId)) { + return activeMatches; + } + ; + const cachedMatches = router.stores.cachedMatches.get(); + if (cachedMatches.some(match => match.id === matchId)) { + return cachedMatches; + } + ; + return []; + } + function getParentMatch(match) { + const matchList = getMatchList(match.id); + const matchIndex = matchList.findIndex(item => item.id === match.id); + if (matchIndex <= 0) { + return undefined; + } + ; + const parentMatch = matchList[matchIndex - 1]; + return getStoreMatch(parentMatch.id) || parentMatch; + } + function rebuildMatchContextWithoutBeforeLoad(match) { + const parentMatch = getParentMatch(match); + const getParentContext = router.getParentContext; + const parentContext = getParentContext ? getParentContext.call(router, parentMatch) : parentMatch?.context ?? router.options.context; + return { + ...(parentContext ?? {}), + ...(match.__routeContext ?? {}) + }; } })(routeId, newModule.Route); } diff --git a/packages/router-plugin/tests/add-hmr/snapshots/react/function-declaration@true.tsx b/packages/router-plugin/tests/add-hmr/snapshots/react/function-declaration@true.tsx index f8199dcd85..1506201d77 100644 --- a/packages/router-plugin/tests/add-hmr/snapshots/react/function-declaration@true.tsx +++ b/packages/router-plugin/tests/add-hmr/snapshots/react/function-declaration@true.tsx @@ -3,16 +3,21 @@ import { lazyRouteComponent } from '@tanstack/react-router'; import * as React from 'react'; import { createFileRoute } from '@tanstack/react-router'; import { fetchPosts } from '../posts'; -const TSRSplitComponent = import.meta.hot?.data?.["tsr-split-component:component"] ?? lazyRouteComponent($$splitComponentImporter, "component"); +const TSRSplitComponent = (() => { + const hot = import.meta.hot; + const hotData = hot ? hot.data ??= {} : undefined; + return hotData?.["tsr-split-component:component"] ?? lazyRouteComponent($$splitComponentImporter, "component"); +})(); if (import.meta.hot) { - import.meta.hot.data ??= {}; - import.meta.hot.data["tsr-split-component:component"] = TSRSplitComponent; + (import.meta.hot.data ??= {})["tsr-split-component:component"] = TSRSplitComponent; } export const Route = createFileRoute('/posts')({ loader: fetchPosts, component: TSRSplitComponent }); -if (import.meta.hot && typeof window !== 'undefined') { +const hot = import.meta.hot; +if (hot && typeof window !== 'undefined') { + hot.data ??= {}; const tsrReactRefresh = window.__TSR_REACT_REFRESH__ ??= (() => { const ignoredExportsById = new Map(); const previousGetIgnoredExports = window.__getReactRefreshIgnoredExports; @@ -31,11 +36,13 @@ export function TSRFastRefreshAnchor() { return null; } if (import.meta.hot) { - import.meta.hot.accept(newModule => { + const hot = import.meta.hot; + const hotData = hot.data ??= {}; + hot.accept(newModule => { if (Route && newModule && newModule.Route) { - const routeId = import.meta.hot.data['tsr-route-id'] ?? Route.id; + const routeId = hotData['tsr-route-id'] ?? Route.id; if (routeId) { - import.meta.hot.data['tsr-route-id'] = routeId; + hotData['tsr-route-id'] = routeId; } (function handleRouteUpdate(routeId, newRoute) { const router = window.__TSR_ROUTER__; @@ -44,42 +51,54 @@ if (import.meta.hot) { return; } ; + const generatedRouteOptionKeys = new Set(["id", "path", "getParentRoute"]); + const generatedRouteOptions = {}; + generatedRouteOptionKeys.forEach(key => { + if (key in oldRoute.options) { + generatedRouteOptions[key] = oldRoute.options[key]; + } + }); const removedKeys = new Set(); Object.keys(oldRoute.options).forEach(key => { - if (!(key in newRoute.options)) { + if (!generatedRouteOptionKeys.has(key) && !(key in newRoute.options)) { removedKeys.add(key); delete oldRoute.options[key]; } }); + const oldHasShellComponent = "shellComponent" in oldRoute.options; + const newHasShellComponent = "shellComponent" in newRoute.options; + const preserveComponentIdentity = oldHasShellComponent === newHasShellComponent; const componentKeys = ["component", "shellComponent", "pendingComponent", "errorComponent", "notFoundComponent"]; - componentKeys.forEach(key => { - if (key in oldRoute.options && key in newRoute.options) { - newRoute.options[key] = oldRoute.options[key]; - } - }); - oldRoute.options = newRoute.options; - oldRoute.update(newRoute.options); + if (preserveComponentIdentity) { + componentKeys.forEach(key => { + if (key in oldRoute.options && key in newRoute.options) { + newRoute.options[key] = oldRoute.options[key]; + } + }); + } + ; + const nextOptions = { + ...newRoute.options, + ...generatedRouteOptions + }; + oldRoute.options = nextOptions; + oldRoute.update(nextOptions); oldRoute._componentsPromise = undefined; oldRoute._lazyPromise = undefined; - router.routesById[oldRoute.id] = oldRoute; - router.routesByPath[oldRoute.fullPath] = oldRoute; - router.processedTree.matchCache.clear(); - router.processedTree.flatCache?.clear(); - router.processedTree.singleCache.clear(); + router.setRoutes(router.buildRouteTree()); router.resolvePathCache.clear(); - walkReplaceSegmentTree(oldRoute, router.processedTree.segmentTree); const filter = m => m.routeId === oldRoute.id; - const activeMatch = router.stores.activeMatchesSnapshot.state.find(filter); - const pendingMatch = router.stores.pendingMatchesSnapshot.state.find(filter); - const cachedMatches = router.stores.cachedMatchesSnapshot.state.filter(filter); + const activeMatch = router.stores.matches.get().find(filter); + const pendingMatch = router.stores.pendingMatches.get().find(filter); + const cachedMatches = router.stores.cachedMatches.get().filter(filter); if (activeMatch || pendingMatch || cachedMatches.length > 0) { if (removedKeys.has("loader") || removedKeys.has("beforeLoad")) { const matchIds = [activeMatch?.id, pendingMatch?.id, ...cachedMatches.map(match => match.id)].filter(Boolean); router.batch(() => { for (const matchId of matchIds) { - const store = router.stores.pendingMatchStoresById.get(matchId) || router.stores.activeMatchStoresById.get(matchId) || router.stores.cachedMatchStoresById.get(matchId); + const store = router.stores.pendingMatchStores.get(matchId) || router.stores.matchStores.get(matchId) || router.stores.cachedMatchStores.get(matchId); if (store) { - store.setState(prev => { + store.set(prev => { const next = { ...prev }; @@ -89,6 +108,7 @@ if (import.meta.hot) { ; if (removedKeys.has("beforeLoad")) { next.__beforeLoadContext = undefined; + next.context = rebuildMatchContextWithoutBeforeLoad(next); } ; return next; @@ -104,14 +124,45 @@ if (import.meta.hot) { }); } ; - function walkReplaceSegmentTree(route, node) { - if (node.route?.id === route.id) node.route = route; - if (node.index) walkReplaceSegmentTree(route, node.index); - node.static?.forEach(child => walkReplaceSegmentTree(route, child)); - node.staticInsensitive?.forEach(child => walkReplaceSegmentTree(route, child)); - node.dynamic?.forEach(child => walkReplaceSegmentTree(route, child)); - node.optional?.forEach(child => walkReplaceSegmentTree(route, child)); - node.wildcard?.forEach(child => walkReplaceSegmentTree(route, child)); + function getStoreMatch(matchId) { + return router.stores.pendingMatchStores.get(matchId)?.get() || router.stores.matchStores.get(matchId)?.get() || router.stores.cachedMatchStores.get(matchId)?.get(); + } + function getMatchList(matchId) { + const pendingMatches = router.stores.pendingMatches.get(); + if (pendingMatches.some(match => match.id === matchId)) { + return pendingMatches; + } + ; + const activeMatches = router.stores.matches.get(); + if (activeMatches.some(match => match.id === matchId)) { + return activeMatches; + } + ; + const cachedMatches = router.stores.cachedMatches.get(); + if (cachedMatches.some(match => match.id === matchId)) { + return cachedMatches; + } + ; + return []; + } + function getParentMatch(match) { + const matchList = getMatchList(match.id); + const matchIndex = matchList.findIndex(item => item.id === match.id); + if (matchIndex <= 0) { + return undefined; + } + ; + const parentMatch = matchList[matchIndex - 1]; + return getStoreMatch(parentMatch.id) || parentMatch; + } + function rebuildMatchContextWithoutBeforeLoad(match) { + const parentMatch = getParentMatch(match); + const getParentContext = router.getParentContext; + const parentContext = getParentContext ? getParentContext.call(router, parentMatch) : parentMatch?.context ?? router.options.context; + return { + ...(parentContext ?? {}), + ...(match.__routeContext ?? {}) + }; } })(routeId, newModule.Route); } diff --git a/packages/router-plugin/tests/add-hmr/snapshots/react/multi-component@true.tsx b/packages/router-plugin/tests/add-hmr/snapshots/react/multi-component@true.tsx index 06d6d35379..46f08ed686 100644 --- a/packages/router-plugin/tests/add-hmr/snapshots/react/multi-component@true.tsx +++ b/packages/router-plugin/tests/add-hmr/snapshots/react/multi-component@true.tsx @@ -4,22 +4,30 @@ import { lazyRouteComponent } from '@tanstack/react-router'; import * as React from 'react'; import { createFileRoute } from '@tanstack/react-router'; import { fetchPosts } from '../posts'; -const TSRSplitComponent = import.meta.hot?.data?.["tsr-split-component:component"] ?? lazyRouteComponent($$splitComponentImporter, "component"); +const TSRSplitComponent = (() => { + const hot = import.meta.hot; + const hotData = hot ? hot.data ??= {} : undefined; + return hotData?.["tsr-split-component:component"] ?? lazyRouteComponent($$splitComponentImporter, "component"); +})(); if (import.meta.hot) { - import.meta.hot.data ??= {}; - import.meta.hot.data["tsr-split-component:component"] = TSRSplitComponent; + (import.meta.hot.data ??= {})["tsr-split-component:component"] = TSRSplitComponent; } -const TSRSplitErrorComponent = import.meta.hot?.data?.["tsr-split-component:errorComponent"] ?? lazyRouteComponent($$splitErrorComponentImporter, "errorComponent"); +const TSRSplitErrorComponent = (() => { + const hot = import.meta.hot; + const hotData = hot ? hot.data ??= {} : undefined; + return hotData?.["tsr-split-component:errorComponent"] ?? lazyRouteComponent($$splitErrorComponentImporter, "errorComponent"); +})(); if (import.meta.hot) { - import.meta.hot.data ??= {}; - import.meta.hot.data["tsr-split-component:errorComponent"] = TSRSplitErrorComponent; + (import.meta.hot.data ??= {})["tsr-split-component:errorComponent"] = TSRSplitErrorComponent; } export const Route = createFileRoute('/posts')({ loader: fetchPosts, component: TSRSplitComponent, errorComponent: TSRSplitErrorComponent }); -if (import.meta.hot && typeof window !== 'undefined') { +const hot = import.meta.hot; +if (hot && typeof window !== 'undefined') { + hot.data ??= {}; const tsrReactRefresh = window.__TSR_REACT_REFRESH__ ??= (() => { const ignoredExportsById = new Map(); const previousGetIgnoredExports = window.__getReactRefreshIgnoredExports; @@ -38,11 +46,13 @@ export function TSRFastRefreshAnchor() { return null; } if (import.meta.hot) { - import.meta.hot.accept(newModule => { + const hot = import.meta.hot; + const hotData = hot.data ??= {}; + hot.accept(newModule => { if (Route && newModule && newModule.Route) { - const routeId = import.meta.hot.data['tsr-route-id'] ?? Route.id; + const routeId = hotData['tsr-route-id'] ?? Route.id; if (routeId) { - import.meta.hot.data['tsr-route-id'] = routeId; + hotData['tsr-route-id'] = routeId; } (function handleRouteUpdate(routeId, newRoute) { const router = window.__TSR_ROUTER__; @@ -51,42 +61,54 @@ if (import.meta.hot) { return; } ; + const generatedRouteOptionKeys = new Set(["id", "path", "getParentRoute"]); + const generatedRouteOptions = {}; + generatedRouteOptionKeys.forEach(key => { + if (key in oldRoute.options) { + generatedRouteOptions[key] = oldRoute.options[key]; + } + }); const removedKeys = new Set(); Object.keys(oldRoute.options).forEach(key => { - if (!(key in newRoute.options)) { + if (!generatedRouteOptionKeys.has(key) && !(key in newRoute.options)) { removedKeys.add(key); delete oldRoute.options[key]; } }); + const oldHasShellComponent = "shellComponent" in oldRoute.options; + const newHasShellComponent = "shellComponent" in newRoute.options; + const preserveComponentIdentity = oldHasShellComponent === newHasShellComponent; const componentKeys = ["component", "shellComponent", "pendingComponent", "errorComponent", "notFoundComponent"]; - componentKeys.forEach(key => { - if (key in oldRoute.options && key in newRoute.options) { - newRoute.options[key] = oldRoute.options[key]; - } - }); - oldRoute.options = newRoute.options; - oldRoute.update(newRoute.options); + if (preserveComponentIdentity) { + componentKeys.forEach(key => { + if (key in oldRoute.options && key in newRoute.options) { + newRoute.options[key] = oldRoute.options[key]; + } + }); + } + ; + const nextOptions = { + ...newRoute.options, + ...generatedRouteOptions + }; + oldRoute.options = nextOptions; + oldRoute.update(nextOptions); oldRoute._componentsPromise = undefined; oldRoute._lazyPromise = undefined; - router.routesById[oldRoute.id] = oldRoute; - router.routesByPath[oldRoute.fullPath] = oldRoute; - router.processedTree.matchCache.clear(); - router.processedTree.flatCache?.clear(); - router.processedTree.singleCache.clear(); + router.setRoutes(router.buildRouteTree()); router.resolvePathCache.clear(); - walkReplaceSegmentTree(oldRoute, router.processedTree.segmentTree); const filter = m => m.routeId === oldRoute.id; - const activeMatch = router.stores.activeMatchesSnapshot.state.find(filter); - const pendingMatch = router.stores.pendingMatchesSnapshot.state.find(filter); - const cachedMatches = router.stores.cachedMatchesSnapshot.state.filter(filter); + const activeMatch = router.stores.matches.get().find(filter); + const pendingMatch = router.stores.pendingMatches.get().find(filter); + const cachedMatches = router.stores.cachedMatches.get().filter(filter); if (activeMatch || pendingMatch || cachedMatches.length > 0) { if (removedKeys.has("loader") || removedKeys.has("beforeLoad")) { const matchIds = [activeMatch?.id, pendingMatch?.id, ...cachedMatches.map(match => match.id)].filter(Boolean); router.batch(() => { for (const matchId of matchIds) { - const store = router.stores.pendingMatchStoresById.get(matchId) || router.stores.activeMatchStoresById.get(matchId) || router.stores.cachedMatchStoresById.get(matchId); + const store = router.stores.pendingMatchStores.get(matchId) || router.stores.matchStores.get(matchId) || router.stores.cachedMatchStores.get(matchId); if (store) { - store.setState(prev => { + store.set(prev => { const next = { ...prev }; @@ -96,6 +118,7 @@ if (import.meta.hot) { ; if (removedKeys.has("beforeLoad")) { next.__beforeLoadContext = undefined; + next.context = rebuildMatchContextWithoutBeforeLoad(next); } ; return next; @@ -111,14 +134,45 @@ if (import.meta.hot) { }); } ; - function walkReplaceSegmentTree(route, node) { - if (node.route?.id === route.id) node.route = route; - if (node.index) walkReplaceSegmentTree(route, node.index); - node.static?.forEach(child => walkReplaceSegmentTree(route, child)); - node.staticInsensitive?.forEach(child => walkReplaceSegmentTree(route, child)); - node.dynamic?.forEach(child => walkReplaceSegmentTree(route, child)); - node.optional?.forEach(child => walkReplaceSegmentTree(route, child)); - node.wildcard?.forEach(child => walkReplaceSegmentTree(route, child)); + function getStoreMatch(matchId) { + return router.stores.pendingMatchStores.get(matchId)?.get() || router.stores.matchStores.get(matchId)?.get() || router.stores.cachedMatchStores.get(matchId)?.get(); + } + function getMatchList(matchId) { + const pendingMatches = router.stores.pendingMatches.get(); + if (pendingMatches.some(match => match.id === matchId)) { + return pendingMatches; + } + ; + const activeMatches = router.stores.matches.get(); + if (activeMatches.some(match => match.id === matchId)) { + return activeMatches; + } + ; + const cachedMatches = router.stores.cachedMatches.get(); + if (cachedMatches.some(match => match.id === matchId)) { + return cachedMatches; + } + ; + return []; + } + function getParentMatch(match) { + const matchList = getMatchList(match.id); + const matchIndex = matchList.findIndex(item => item.id === match.id); + if (matchIndex <= 0) { + return undefined; + } + ; + const parentMatch = matchList[matchIndex - 1]; + return getStoreMatch(parentMatch.id) || parentMatch; + } + function rebuildMatchContextWithoutBeforeLoad(match) { + const parentMatch = getParentMatch(match); + const getParentContext = router.getParentContext; + const parentContext = getParentContext ? getParentContext.call(router, parentMatch) : parentMatch?.context ?? router.options.context; + return { + ...(parentContext ?? {}), + ...(match.__routeContext ?? {}) + }; } })(routeId, newModule.Route); } diff --git a/packages/router-plugin/tests/add-hmr/snapshots/react/string-literal-keys@true.tsx b/packages/router-plugin/tests/add-hmr/snapshots/react/string-literal-keys@true.tsx index f62d1a2831..ca91b0a8f2 100644 --- a/packages/router-plugin/tests/add-hmr/snapshots/react/string-literal-keys@true.tsx +++ b/packages/router-plugin/tests/add-hmr/snapshots/react/string-literal-keys@true.tsx @@ -4,22 +4,30 @@ import { lazyRouteComponent } from '@tanstack/react-router'; import * as React from 'react'; import { createFileRoute } from '@tanstack/react-router'; import { fetchPosts } from '../posts'; -const TSRSplitComponent = import.meta.hot?.data?.["tsr-split-component:component"] ?? lazyRouteComponent($$splitComponentImporter, "component"); +const TSRSplitComponent = (() => { + const hot = import.meta.hot; + const hotData = hot ? hot.data ??= {} : undefined; + return hotData?.["tsr-split-component:component"] ?? lazyRouteComponent($$splitComponentImporter, "component"); +})(); if (import.meta.hot) { - import.meta.hot.data ??= {}; - import.meta.hot.data["tsr-split-component:component"] = TSRSplitComponent; + (import.meta.hot.data ??= {})["tsr-split-component:component"] = TSRSplitComponent; } -const TSRSplitErrorComponent = import.meta.hot?.data?.["tsr-split-component:errorComponent"] ?? lazyRouteComponent($$splitErrorComponentImporter, "errorComponent"); +const TSRSplitErrorComponent = (() => { + const hot = import.meta.hot; + const hotData = hot ? hot.data ??= {} : undefined; + return hotData?.["tsr-split-component:errorComponent"] ?? lazyRouteComponent($$splitErrorComponentImporter, "errorComponent"); +})(); if (import.meta.hot) { - import.meta.hot.data ??= {}; - import.meta.hot.data["tsr-split-component:errorComponent"] = TSRSplitErrorComponent; + (import.meta.hot.data ??= {})["tsr-split-component:errorComponent"] = TSRSplitErrorComponent; } export const Route = createFileRoute('/posts')({ loader: fetchPosts, 'component': TSRSplitComponent, 'errorComponent': TSRSplitErrorComponent }); -if (import.meta.hot && typeof window !== 'undefined') { +const hot = import.meta.hot; +if (hot && typeof window !== 'undefined') { + hot.data ??= {}; const tsrReactRefresh = window.__TSR_REACT_REFRESH__ ??= (() => { const ignoredExportsById = new Map(); const previousGetIgnoredExports = window.__getReactRefreshIgnoredExports; @@ -38,11 +46,13 @@ export function TSRFastRefreshAnchor() { return null; } if (import.meta.hot) { - import.meta.hot.accept(newModule => { + const hot = import.meta.hot; + const hotData = hot.data ??= {}; + hot.accept(newModule => { if (Route && newModule && newModule.Route) { - const routeId = import.meta.hot.data['tsr-route-id'] ?? Route.id; + const routeId = hotData['tsr-route-id'] ?? Route.id; if (routeId) { - import.meta.hot.data['tsr-route-id'] = routeId; + hotData['tsr-route-id'] = routeId; } (function handleRouteUpdate(routeId, newRoute) { const router = window.__TSR_ROUTER__; @@ -51,42 +61,54 @@ if (import.meta.hot) { return; } ; + const generatedRouteOptionKeys = new Set(["id", "path", "getParentRoute"]); + const generatedRouteOptions = {}; + generatedRouteOptionKeys.forEach(key => { + if (key in oldRoute.options) { + generatedRouteOptions[key] = oldRoute.options[key]; + } + }); const removedKeys = new Set(); Object.keys(oldRoute.options).forEach(key => { - if (!(key in newRoute.options)) { + if (!generatedRouteOptionKeys.has(key) && !(key in newRoute.options)) { removedKeys.add(key); delete oldRoute.options[key]; } }); + const oldHasShellComponent = "shellComponent" in oldRoute.options; + const newHasShellComponent = "shellComponent" in newRoute.options; + const preserveComponentIdentity = oldHasShellComponent === newHasShellComponent; const componentKeys = ["component", "shellComponent", "pendingComponent", "errorComponent", "notFoundComponent"]; - componentKeys.forEach(key => { - if (key in oldRoute.options && key in newRoute.options) { - newRoute.options[key] = oldRoute.options[key]; - } - }); - oldRoute.options = newRoute.options; - oldRoute.update(newRoute.options); + if (preserveComponentIdentity) { + componentKeys.forEach(key => { + if (key in oldRoute.options && key in newRoute.options) { + newRoute.options[key] = oldRoute.options[key]; + } + }); + } + ; + const nextOptions = { + ...newRoute.options, + ...generatedRouteOptions + }; + oldRoute.options = nextOptions; + oldRoute.update(nextOptions); oldRoute._componentsPromise = undefined; oldRoute._lazyPromise = undefined; - router.routesById[oldRoute.id] = oldRoute; - router.routesByPath[oldRoute.fullPath] = oldRoute; - router.processedTree.matchCache.clear(); - router.processedTree.flatCache?.clear(); - router.processedTree.singleCache.clear(); + router.setRoutes(router.buildRouteTree()); router.resolvePathCache.clear(); - walkReplaceSegmentTree(oldRoute, router.processedTree.segmentTree); const filter = m => m.routeId === oldRoute.id; - const activeMatch = router.stores.activeMatchesSnapshot.state.find(filter); - const pendingMatch = router.stores.pendingMatchesSnapshot.state.find(filter); - const cachedMatches = router.stores.cachedMatchesSnapshot.state.filter(filter); + const activeMatch = router.stores.matches.get().find(filter); + const pendingMatch = router.stores.pendingMatches.get().find(filter); + const cachedMatches = router.stores.cachedMatches.get().filter(filter); if (activeMatch || pendingMatch || cachedMatches.length > 0) { if (removedKeys.has("loader") || removedKeys.has("beforeLoad")) { const matchIds = [activeMatch?.id, pendingMatch?.id, ...cachedMatches.map(match => match.id)].filter(Boolean); router.batch(() => { for (const matchId of matchIds) { - const store = router.stores.pendingMatchStoresById.get(matchId) || router.stores.activeMatchStoresById.get(matchId) || router.stores.cachedMatchStoresById.get(matchId); + const store = router.stores.pendingMatchStores.get(matchId) || router.stores.matchStores.get(matchId) || router.stores.cachedMatchStores.get(matchId); if (store) { - store.setState(prev => { + store.set(prev => { const next = { ...prev }; @@ -96,6 +118,7 @@ if (import.meta.hot) { ; if (removedKeys.has("beforeLoad")) { next.__beforeLoadContext = undefined; + next.context = rebuildMatchContextWithoutBeforeLoad(next); } ; return next; @@ -111,14 +134,45 @@ if (import.meta.hot) { }); } ; - function walkReplaceSegmentTree(route, node) { - if (node.route?.id === route.id) node.route = route; - if (node.index) walkReplaceSegmentTree(route, node.index); - node.static?.forEach(child => walkReplaceSegmentTree(route, child)); - node.staticInsensitive?.forEach(child => walkReplaceSegmentTree(route, child)); - node.dynamic?.forEach(child => walkReplaceSegmentTree(route, child)); - node.optional?.forEach(child => walkReplaceSegmentTree(route, child)); - node.wildcard?.forEach(child => walkReplaceSegmentTree(route, child)); + function getStoreMatch(matchId) { + return router.stores.pendingMatchStores.get(matchId)?.get() || router.stores.matchStores.get(matchId)?.get() || router.stores.cachedMatchStores.get(matchId)?.get(); + } + function getMatchList(matchId) { + const pendingMatches = router.stores.pendingMatches.get(); + if (pendingMatches.some(match => match.id === matchId)) { + return pendingMatches; + } + ; + const activeMatches = router.stores.matches.get(); + if (activeMatches.some(match => match.id === matchId)) { + return activeMatches; + } + ; + const cachedMatches = router.stores.cachedMatches.get(); + if (cachedMatches.some(match => match.id === matchId)) { + return cachedMatches; + } + ; + return []; + } + function getParentMatch(match) { + const matchList = getMatchList(match.id); + const matchIndex = matchList.findIndex(item => item.id === match.id); + if (matchIndex <= 0) { + return undefined; + } + ; + const parentMatch = matchList[matchIndex - 1]; + return getStoreMatch(parentMatch.id) || parentMatch; + } + function rebuildMatchContextWithoutBeforeLoad(match) { + const parentMatch = getParentMatch(match); + const getParentContext = router.getParentContext; + const parentContext = getParentContext ? getParentContext.call(router, parentMatch) : parentMatch?.context ?? router.options.context; + return { + ...(parentContext ?? {}), + ...(match.__routeContext ?? {}) + }; } })(routeId, newModule.Route); } diff --git a/packages/router-plugin/tests/add-hmr/snapshots/solid/arrow-function@true.tsx b/packages/router-plugin/tests/add-hmr/snapshots/solid/arrow-function@true.tsx index b084d4c71b..ea83b4812f 100644 --- a/packages/router-plugin/tests/add-hmr/snapshots/solid/arrow-function@true.tsx +++ b/packages/router-plugin/tests/add-hmr/snapshots/solid/arrow-function@true.tsx @@ -7,11 +7,13 @@ export const Route = createFileRoute('/posts')({ component: lazyRouteComponent($$splitComponentImporter, 'component') }); if (import.meta.hot) { - import.meta.hot.accept(newModule => { + const hot = import.meta.hot; + const hotData = hot.data ??= {}; + hot.accept(newModule => { if (Route && newModule && newModule.Route) { - const routeId = import.meta.hot.data['tsr-route-id'] ?? Route.id; + const routeId = hotData['tsr-route-id'] ?? Route.id; if (routeId) { - import.meta.hot.data['tsr-route-id'] = routeId; + hotData['tsr-route-id'] = routeId; } (function handleRouteUpdate(routeId, newRoute) { const router = window.__TSR_ROUTER__; @@ -20,42 +22,54 @@ if (import.meta.hot) { return; } ; + const generatedRouteOptionKeys = new Set(["id", "path", "getParentRoute"]); + const generatedRouteOptions = {}; + generatedRouteOptionKeys.forEach(key => { + if (key in oldRoute.options) { + generatedRouteOptions[key] = oldRoute.options[key]; + } + }); const removedKeys = new Set(); Object.keys(oldRoute.options).forEach(key => { - if (!(key in newRoute.options)) { + if (!generatedRouteOptionKeys.has(key) && !(key in newRoute.options)) { removedKeys.add(key); delete oldRoute.options[key]; } }); + const oldHasShellComponent = "shellComponent" in oldRoute.options; + const newHasShellComponent = "shellComponent" in newRoute.options; + const preserveComponentIdentity = oldHasShellComponent === newHasShellComponent; const componentKeys = []; - componentKeys.forEach(key => { - if (key in oldRoute.options && key in newRoute.options) { - newRoute.options[key] = oldRoute.options[key]; - } - }); - oldRoute.options = newRoute.options; - oldRoute.update(newRoute.options); + if (preserveComponentIdentity) { + componentKeys.forEach(key => { + if (key in oldRoute.options && key in newRoute.options) { + newRoute.options[key] = oldRoute.options[key]; + } + }); + } + ; + const nextOptions = { + ...newRoute.options, + ...generatedRouteOptions + }; + oldRoute.options = nextOptions; + oldRoute.update(nextOptions); oldRoute._componentsPromise = undefined; oldRoute._lazyPromise = undefined; - router.routesById[oldRoute.id] = oldRoute; - router.routesByPath[oldRoute.fullPath] = oldRoute; - router.processedTree.matchCache.clear(); - router.processedTree.flatCache?.clear(); - router.processedTree.singleCache.clear(); + router.setRoutes(router.buildRouteTree()); router.resolvePathCache.clear(); - walkReplaceSegmentTree(oldRoute, router.processedTree.segmentTree); const filter = m => m.routeId === oldRoute.id; - const activeMatch = router.stores.activeMatchesSnapshot.state.find(filter); - const pendingMatch = router.stores.pendingMatchesSnapshot.state.find(filter); - const cachedMatches = router.stores.cachedMatchesSnapshot.state.filter(filter); + const activeMatch = router.stores.matches.get().find(filter); + const pendingMatch = router.stores.pendingMatches.get().find(filter); + const cachedMatches = router.stores.cachedMatches.get().filter(filter); if (activeMatch || pendingMatch || cachedMatches.length > 0) { if (removedKeys.has("loader") || removedKeys.has("beforeLoad")) { const matchIds = [activeMatch?.id, pendingMatch?.id, ...cachedMatches.map(match => match.id)].filter(Boolean); router.batch(() => { for (const matchId of matchIds) { - const store = router.stores.pendingMatchStoresById.get(matchId) || router.stores.activeMatchStoresById.get(matchId) || router.stores.cachedMatchStoresById.get(matchId); + const store = router.stores.pendingMatchStores.get(matchId) || router.stores.matchStores.get(matchId) || router.stores.cachedMatchStores.get(matchId); if (store) { - store.setState(prev => { + store.set(prev => { const next = { ...prev }; @@ -65,6 +79,7 @@ if (import.meta.hot) { ; if (removedKeys.has("beforeLoad")) { next.__beforeLoadContext = undefined; + next.context = rebuildMatchContextWithoutBeforeLoad(next); } ; return next; @@ -80,14 +95,45 @@ if (import.meta.hot) { }); } ; - function walkReplaceSegmentTree(route, node) { - if (node.route?.id === route.id) node.route = route; - if (node.index) walkReplaceSegmentTree(route, node.index); - node.static?.forEach(child => walkReplaceSegmentTree(route, child)); - node.staticInsensitive?.forEach(child => walkReplaceSegmentTree(route, child)); - node.dynamic?.forEach(child => walkReplaceSegmentTree(route, child)); - node.optional?.forEach(child => walkReplaceSegmentTree(route, child)); - node.wildcard?.forEach(child => walkReplaceSegmentTree(route, child)); + function getStoreMatch(matchId) { + return router.stores.pendingMatchStores.get(matchId)?.get() || router.stores.matchStores.get(matchId)?.get() || router.stores.cachedMatchStores.get(matchId)?.get(); + } + function getMatchList(matchId) { + const pendingMatches = router.stores.pendingMatches.get(); + if (pendingMatches.some(match => match.id === matchId)) { + return pendingMatches; + } + ; + const activeMatches = router.stores.matches.get(); + if (activeMatches.some(match => match.id === matchId)) { + return activeMatches; + } + ; + const cachedMatches = router.stores.cachedMatches.get(); + if (cachedMatches.some(match => match.id === matchId)) { + return cachedMatches; + } + ; + return []; + } + function getParentMatch(match) { + const matchList = getMatchList(match.id); + const matchIndex = matchList.findIndex(item => item.id === match.id); + if (matchIndex <= 0) { + return undefined; + } + ; + const parentMatch = matchList[matchIndex - 1]; + return getStoreMatch(parentMatch.id) || parentMatch; + } + function rebuildMatchContextWithoutBeforeLoad(match) { + const parentMatch = getParentMatch(match); + const getParentContext = router.getParentContext; + const parentContext = getParentContext ? getParentContext.call(router, parentMatch) : parentMatch?.context ?? router.options.context; + return { + ...(parentContext ?? {}), + ...(match.__routeContext ?? {}) + }; } })(routeId, newModule.Route); } diff --git a/packages/router-plugin/tests/add-hmr/test-files/react/createRootRoute.tsx b/packages/router-plugin/tests/add-hmr/test-files/react/createRootRoute.tsx new file mode 100644 index 0000000000..e967791f8d --- /dev/null +++ b/packages/router-plugin/tests/add-hmr/test-files/react/createRootRoute.tsx @@ -0,0 +1,10 @@ +import * as React from 'react' +import { createRootRoute } from '@tanstack/react-router' + +export const Route = createRootRoute({ + component: RootComponent, +}) + +function RootComponent() { + return <div>Hello</div> +} diff --git a/packages/router-plugin/tests/add-hmr/test-files/react/createRootRouteWithContext-type-args.tsx b/packages/router-plugin/tests/add-hmr/test-files/react/createRootRouteWithContext-type-args.tsx new file mode 100644 index 0000000000..0feadacab5 --- /dev/null +++ b/packages/router-plugin/tests/add-hmr/test-files/react/createRootRouteWithContext-type-args.tsx @@ -0,0 +1,14 @@ +import * as React from 'react' +import { createRootRouteWithContext } from '@tanstack/react-router' + +interface MyRouterContext { + auth: boolean +} + +export const Route = createRootRouteWithContext<MyRouterContext>()({ + component: RootComponent, +}) + +function RootComponent() { + return <div>Hello</div> +} diff --git a/packages/router-plugin/tests/code-splitter.test.ts b/packages/router-plugin/tests/code-splitter.test.ts index 5a68f9453f..ae64e2778b 100644 --- a/packages/router-plugin/tests/code-splitter.test.ts +++ b/packages/router-plugin/tests/code-splitter.test.ts @@ -18,7 +18,7 @@ import { expandTransitively, removeBindingsDependingOnRoute, } from '../src/core/code-splitter/compilers' -import { createIdentifier } from '../src/core/code-splitter/path-ids' +import { createIdentifier } from '@tanstack/router-utils' import { defaultCodeSplitGroupings } from '../src/core/constants' import { frameworks } from './constants' import type { CodeSplitGroupings } from '../src/core/constants' diff --git a/packages/router-plugin/tests/handle-route-update.test.ts b/packages/router-plugin/tests/handle-route-update.test.ts new file mode 100644 index 0000000000..8f1b28cdb6 --- /dev/null +++ b/packages/router-plugin/tests/handle-route-update.test.ts @@ -0,0 +1,193 @@ +import { + BaseRootRoute, + BaseRoute, + RouterCore, + createNonReactiveMutableStore, + createNonReactiveReadonlyStore, + trimPathRight, +} from '@tanstack/router-core' +import { describe, expect, it } from 'vitest' +import { getHandleRouteUpdateCode } from '../src/core/hmr' +import type { AnyRoute, GetStoreConfig } from '@tanstack/router-core' + +const getStoreConfig: GetStoreConfig = () => ({ + createMutableStore: createNonReactiveMutableStore, + createReadonlyStore: createNonReactiveReadonlyStore, + batch: (fn) => fn(), +}) + +const getHandleRouteUpdate = () => { + return new Function(`return ${getHandleRouteUpdateCode([])}`)() as ( + routeId: string, + newRoute: AnyRoute, + ) => void +} + +function createTestHistory() { + const location = { + href: '/', + pathname: '/', + search: '', + hash: '', + state: { __TSR_index: 0 }, + } + + return { + location, + length: 1, + subscribers: new Set(), + subscribe: () => () => {}, + push: () => {}, + replace: () => {}, + go: () => {}, + back: () => {}, + forward: () => {}, + canGoBack: () => false, + createHref: (href: string) => href, + block: () => () => {}, + flush: () => {}, + destroy: () => {}, + notify: () => {}, + } +} + +function createTestRouter(routeTree: AnyRoute) { + return new RouterCore( + { + routeTree, + history: createTestHistory() as any, + isServer: true, + }, + getStoreConfig, + ) +} + +function withWindowRouter(router: RouterCore<any, any, any, any, any>) { + const previousWindow = (globalThis as any).window + ;(globalThis as any).window = { __TSR_ROUTER__: router } + + return () => { + if (previousWindow) { + ;(globalThis as any).window = previousWindow + } else { + delete (globalThis as any).window + } + } +} + +function getProcessedTreeRouteForPath( + router: RouterCore<any, any, any, any, any>, + path: string, +) { + return router.buildRouteTree().routesByPath[path]?.id +} + +describe('handleRouteUpdate', () => { + it('keeps routesByPath pointed at an index route when a pathless layout updates', () => { + const rootRoute = new BaseRootRoute({}) + const parentRoute = new BaseRoute({ + getParentRoute: () => rootRoute, + path: '/livestock/$farmId/medicine', + }) + const pathlessRoute = new BaseRoute({ + getParentRoute: () => parentRoute, + id: '_form', + }) + const newRoute = new BaseRoute({ + getParentRoute: () => pathlessRoute, + path: 'new', + }) + const indexRoute = new BaseRoute({ + getParentRoute: () => parentRoute, + path: '/', + }) + const routeTree = rootRoute.addChildren([ + parentRoute.addChildren([ + pathlessRoute.addChildren([newRoute]), + indexRoute, + ]), + ]) + const router = createTestRouter(routeTree) + const key = trimPathRight(indexRoute.fullPath) + + expect(router.routesByPath[key]?.id).toBe(indexRoute.id) + + const restoreWindow = withWindowRouter(router) + try { + getHandleRouteUpdate()(pathlessRoute.id, new BaseRoute({} as any)) + } finally { + restoreWindow() + } + + expect(router.routesByPath[key]?.id).toBe(indexRoute.id) + expect(router.routesByPath[key]?.id).toBe( + getProcessedTreeRouteForPath(router, key), + ) + }) + + it('keeps an index route winning the trimmed path key when its parent updates', () => { + const rootRoute = new BaseRootRoute({}) + const parentRoute = new BaseRoute({ + getParentRoute: () => rootRoute, + path: '/path', + }) + const indexRoute = new BaseRoute({ + getParentRoute: () => parentRoute, + path: '/', + }) + const routeTree = rootRoute.addChildren([ + parentRoute.addChildren([indexRoute]), + ]) + const router = createTestRouter(routeTree) + const key = trimPathRight(indexRoute.fullPath) + + expect(router.routesByPath[key]?.id).toBe(indexRoute.id) + + const restoreWindow = withWindowRouter(router) + try { + getHandleRouteUpdate()(parentRoute.id, new BaseRoute({} as any)) + } finally { + restoreWindow() + } + + expect(router.routesByPath[key]?.id).toBe(indexRoute.id) + expect(router.routesByPath[key]?.id).toBe( + getProcessedTreeRouteForPath(router, key), + ) + }) + + it('refreshes matching data when params.parse changes', () => { + const rootRoute = new BaseRootRoute({}) + const itemRoute = new BaseRoute({ + getParentRoute: () => rootRoute, + path: '/items/$itemId', + params: { + parse: ({ itemId }: { itemId: string }) => { + return /^\d+$/.test(itemId) ? { itemId } : false + }, + }, + }) + const routeTree = rootRoute.addChildren([itemRoute]) + const router = createTestRouter(routeTree) + + expect(router.getMatchedRoutes('/items/abc').foundRoute?.id).toBeUndefined() + + const restoreWindow = withWindowRouter(router) + try { + getHandleRouteUpdate()( + itemRoute.id, + new BaseRoute({ + params: { + parse: ({ itemId }: { itemId: string }) => ({ itemId }), + }, + } as any), + ) + } finally { + restoreWindow() + } + + expect(router.getMatchedRoutes('/items/abc').foundRoute?.id).toBe( + itemRoute.id, + ) + }) +}) diff --git a/packages/router-plugin/tests/router-plugin-context.test.ts b/packages/router-plugin/tests/router-plugin-context.test.ts new file mode 100644 index 0000000000..40664c50a8 --- /dev/null +++ b/packages/router-plugin/tests/router-plugin-context.test.ts @@ -0,0 +1,181 @@ +import path from 'node:path' +import * as t from '@babel/types' +import { describe, expect, it } from 'vitest' +import { parseAst } from '@tanstack/router-utils' +import { createRouterCodeSplitterPlugin } from '../src/core/router-code-splitter-plugin' +import { createRouterHmrPlugin } from '../src/core/router-hmr-plugin' +import { createRouterPluginContext } from '../src/core/router-plugin-context' +import { normalizePath } from '../src/core/utils' +import type { Config } from '../src/core/config' +import type { UnpluginOptions, TransformResult } from 'unplugin' + +const referencePluginName = + 'tanstack-router:code-splitter:compile-reference-file' + +function getReferencePlugin( + plugins: ReturnType<typeof createRouterCodeSplitterPlugin>, +): UnpluginOptions { + const pluginArray = Array.isArray(plugins) ? plugins : [plugins] + const plugin = pluginArray.find((item) => item.name === referencePluginName) + if (!plugin) { + throw new Error('Reference code-splitter plugin not found') + } + return plugin +} + +async function configurePlugin(plugin: UnpluginOptions) { + const hook = plugin.vite?.configResolved + if (!hook) { + return + } + + const config = { + root: process.cwd(), + plugins: [{ name: referencePluginName }], + } as never + + if (typeof hook === 'function') { + await hook.call({} as never, config) + return + } + + await hook.handler.call({} as never, config) +} + +async function transformReferenceRoute( + plugin: UnpluginOptions, + code: string, + id: string, +): Promise<TransformResult | null | undefined> { + const transform = plugin.transform + if (!transform || typeof transform === 'function') { + throw new Error('Expected object transform') + } + return transform.handler.call({} as never, code, id) +} + +function getCode(result: TransformResult | null | undefined) { + if (!result) { + return null + } + if (typeof result === 'string') { + return result + } + return result.code +} + +function countProgramHotDeclarations(code: string) { + const ast = parseAst({ code }) + return ast.program.body.filter((statement) => { + return ( + t.isVariableDeclaration(statement) && + statement.declarations.some((declaration) => { + return t.isIdentifier(declaration.id) && declaration.id.name === 'hot' + }) + ) + }).length +} + +describe('router plugin context', () => { + it('keeps multiple code-splitter instances isolated by explicit context', async () => { + const routeFile = normalizePath( + path.join(process.cwd(), 'src/routes-a/owned.tsx'), + ) + const otherRouteFile = normalizePath( + path.join(process.cwd(), 'src/routes-b/other.tsx'), + ) + + const routeCode = ` +import { createFileRoute } from '@tanstack/react-router' + +function Component() { + return <div>Hello</div> +} + +export const Route = createFileRoute('/owned')({ + component: Component, +}) +` + + const contextA = createRouterPluginContext() + contextA.routesByFile.set(routeFile, { routeId: '/owned' }) + + const contextB = createRouterPluginContext() + contextB.routesByFile.set(otherRouteFile, { routeId: '/other' }) + + const configA = { + target: 'react', + routesDirectory: './src/routes-a', + generatedRouteTree: './src/routeTree-a.gen.ts', + autoCodeSplitting: true, + } satisfies Partial<Config> + + const configB = { + target: 'react', + routesDirectory: './src/routes-b', + generatedRouteTree: './src/routeTree-b.gen.ts', + autoCodeSplitting: true, + } satisfies Partial<Config> + + const splitterA = getReferencePlugin( + createRouterCodeSplitterPlugin(configA, contextA), + ) + const splitterB = getReferencePlugin( + createRouterCodeSplitterPlugin(configB, contextB), + ) + + await configurePlugin(splitterA) + await configurePlugin(splitterB) + + const firstResult = await transformReferenceRoute( + splitterA, + routeCode, + routeFile, + ) + const firstCode = getCode(firstResult) + + expect(firstCode).not.toBeNull() + expect(countProgramHotDeclarations(firstCode!)).toBe(1) + + const secondResult = await transformReferenceRoute( + splitterB, + firstCode!, + routeFile, + ) + + expect(secondResult).toBeNull() + }) + + it('normalizes HMR options before the first transform', async () => { + const routeFile = normalizePath( + path.join(process.cwd(), 'src/routes/owned.tsx'), + ) + + const routeCode = ` +import { createFileRoute } from '@tanstack/react-router' + +function Component() { + return <div>Hello</div> +} + +export const Route = createFileRoute('/owned')({ + component: Component, +}) +` + + const context = createRouterPluginContext() + context.routesByFile.set(routeFile, { routeId: '/owned' }) + + const hmrPlugin = createRouterHmrPlugin({}, context) + const hmrResult = await transformReferenceRoute( + Array.isArray(hmrPlugin) ? hmrPlugin[0]! : hmrPlugin, + routeCode, + routeFile, + ) + + const hmrCode = getCode(hmrResult) + + expect(hmrCode).not.toBeNull() + expect(hmrCode).toContain('TSRFastRefreshAnchor') + }) +}) diff --git a/packages/router-plugin/tests/utils.test.ts b/packages/router-plugin/tests/utils.test.ts index c19ab27e6a..6812b59bc3 100644 --- a/packages/router-plugin/tests/utils.test.ts +++ b/packages/router-plugin/tests/utils.test.ts @@ -6,9 +6,18 @@ import { getObjectPropertyKeyName, getUniqueProgramIdentifier, normalizePath, + routeFactoryCallCodeFilter, } from '../src/core/utils' import type { NodePath } from '@babel/core' +function matchesRouteFactoryCallCodeFilter(code: string) { + return routeFactoryCallCodeFilter.some((pattern) => { + const result = pattern.test(code) + pattern.lastIndex = 0 + return result + }) +} + function getProgramPath(code: string): NodePath<t.Program> { const ast = parseAst({ code }) let programPath: NodePath<t.Program> | undefined @@ -100,6 +109,38 @@ describe('getUniqueProgramIdentifier', () => { }) }) +describe('routeFactoryCallCodeFilter', () => { + it('matches route factory calls with TypeScript type arguments', () => { + expect( + matchesRouteFactoryCallCodeFilter( + 'createRootRouteWithContext<MyContext>()({})', + ), + ).toBe(true) + }) + + it('matches route factory calls without TypeScript type arguments', () => { + expect( + matchesRouteFactoryCallCodeFilter('createRootRouteWithContext()({})'), + ).toBe(true) + expect(matchesRouteFactoryCallCodeFilter('createRootRoute({})')).toBe(true) + expect( + matchesRouteFactoryCallCodeFilter("createFileRoute('/posts')({})"), + ).toBe(true) + }) + + it('matches route factory calls with whitespace before invocation', () => { + expect( + matchesRouteFactoryCallCodeFilter( + 'createRootRouteWithContext <MyContext>()({})', + ), + ).toBe(true) + expect(matchesRouteFactoryCallCodeFilter('createRootRoute ({})')).toBe(true) + expect( + matchesRouteFactoryCallCodeFilter("createFileRoute ('/posts')({})"), + ).toBe(true) + }) +}) + describe('getObjectPropertyKeyName', () => { it('returns identifier keys', () => { const prop = t.objectProperty(t.identifier('component'), t.identifier('x')) diff --git a/packages/router-plugin/vite.config.ts b/packages/router-plugin/vite.config.ts index 3f46bd3408..e80f073d21 100644 --- a/packages/router-plugin/vite.config.ts +++ b/packages/router-plugin/vite.config.ts @@ -17,6 +17,7 @@ export default mergeConfig( tsconfigPath: './tsconfig.build.json', entry: [ './src/index.ts', + './src/context.ts', './src/vite.ts', './src/rspack.ts', './src/webpack.ts', diff --git a/packages/router-ssr-query-core/CHANGELOG.md b/packages/router-ssr-query-core/CHANGELOG.md index 6e45255763..4b74a6ddc7 100644 --- a/packages/router-ssr-query-core/CHANGELOG.md +++ b/packages/router-ssr-query-core/CHANGELOG.md @@ -1,5 +1,29 @@ # @tanstack/router-ssr-query-core +## 1.169.1 + +### Patch Changes + +- [#7497](https://github.com/TanStack/router/pull/7497) [`d1997b6`](https://github.com/TanStack/router/commit/d1997b66d7c24c1d64772bb8bab5caf9c6d9cc48) - fix streaming + +## 1.169.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +## 1.168.0 + +### Minor Changes + +- Add support for custom `dehydrateOptions` and `hydrateOptions` in the SSR query integration ([#7246](https://github.com/TanStack/router/pull/7246)) + +## 1.167.1 + +### Patch Changes + +- migrate createStore > createAtom for simpler API ([#7150](https://github.com/TanStack/router/pull/7150)) + ## 1.167.0 ### Minor Changes diff --git a/packages/router-ssr-query-core/package.json b/packages/router-ssr-query-core/package.json index 2e10bc44e0..bb0ee71c70 100644 --- a/packages/router-ssr-query-core/package.json +++ b/packages/router-ssr-query-core/package.json @@ -1,6 +1,6 @@ { "name": "@tanstack/router-ssr-query-core", - "version": "1.167.0", + "version": "1.169.1", "description": "Modern and scalable routing for React applications", "author": "Tanner Linsley", "license": "MIT", @@ -33,7 +33,7 @@ "test:types:ts58": "node ../../node_modules/typescript58/lib/tsc.js", "test:types:ts59": "node ../../node_modules/typescript59/lib/tsc.js", "test:types:ts60": "tsc", - "test:unit": "exit 0; vitest", + "test:unit": "vitest", "test:unit:dev": "pnpm run test:unit --watch", "test:build": "publint --strict && attw --ignore-rules no-resolution --pack .", "build": "vite build" @@ -64,7 +64,7 @@ "node": ">=20.19" }, "devDependencies": { - "@tanstack/router-core": ">=1.168.0", + "@tanstack/router-core": ">=1.171.7", "@tanstack/query-core": ">=5.90.0", "vite": "*" }, diff --git a/packages/router-ssr-query-core/src/index.ts b/packages/router-ssr-query-core/src/index.ts index 4549804660..685653dea0 100644 --- a/packages/router-ssr-query-core/src/index.ts +++ b/packages/router-ssr-query-core/src/index.ts @@ -6,6 +6,8 @@ import { isRedirect } from '@tanstack/router-core' import { isServer } from '@tanstack/router-core/isServer' import type { AnyRouter } from '@tanstack/router-core' import type { + DehydrateOptions, + HydrateOptions, QueryClient, DehydratedState as QueryDehydratedState, } from '@tanstack/query-core' @@ -13,6 +15,8 @@ import type { export type RouterSsrQueryOptions<TRouter extends AnyRouter> = { router: TRouter queryClient: QueryClient + dehydrateOptions?: DehydrateOptions + hydrateOptions?: HydrateOptions /** * If `true`, the QueryClient will handle errors thrown by `redirect()` inside of mutations and queries. @@ -31,6 +35,8 @@ type DehydratedRouterQueryState = { export function setupCoreRouterSsrQueryIntegration<TRouter extends AnyRouter>({ router, queryClient, + dehydrateOptions, + hydrateOptions, handleRedirects = true, }: RouterSsrQueryOptions<TRouter>) { const ogHydrate = router.options.hydrate @@ -40,10 +46,61 @@ export function setupCoreRouterSsrQueryIntegration<TRouter extends AnyRouter>({ const sentQueries = new Set<string>() const queryStream = createPushableStream() let unsubscribe: (() => void) | undefined = undefined + let cleanupRegistered = false + let tornDown = false + + const teardown = () => { + if (tornDown) return + tornDown = true + try { + unsubscribe?.() + } catch { + // ignore + } + unsubscribe = undefined + try { + if (!queryStream.isClosed()) queryStream.close() + } catch { + // ignore + } + // Cancel any in-flight queries and clear the cache. Removing queries + // cancels their gcTime setTimeout handles which would otherwise pin + // the queryClient (and transitively the router via router.context) + // alive for the full gcTime window (default 5min) per SSR request. + try { + queryClient.cancelQueries() + } catch { + // ignore + } + try { + queryClient.clear() + } catch { + // ignore + } + sentQueries.clear() + } + + // Register teardown as soon as SSR attaches. attachRouterServerSsrUtils() + // runs before router.load(), so this covers redirects/errors thrown before + // router.options.dehydrate() can run. + const registerCleanup = (serverSsr = router.serverSsr) => { + if (cleanupRegistered) return + if (!serverSsr) return + serverSsr.onCleanup(teardown) + cleanupRegistered = true + } + router.serverSsrLifecycle = { + ...router.serverSsrLifecycle, + onServerSsrAttach: [ + ...(router.serverSsrLifecycle?.onServerSsrAttach ?? []), + registerCleanup, + ], + } + router.options.dehydrate = async (): Promise<DehydratedRouterQueryState> => { router.serverSsr!.onRenderFinished(() => { - queryStream.close() + if (!queryStream.isClosed()) queryStream.close() unsubscribe?.() unsubscribe = undefined }) @@ -55,7 +112,10 @@ export function setupCoreRouterSsrQueryIntegration<TRouter extends AnyRouter>({ queryStream: queryStream.stream, } - const dehydratedQueryClient = queryDehydrate(queryClient) + const dehydratedQueryClient = queryDehydrate( + queryClient, + dehydrateOptions, + ) if (dehydratedQueryClient.queries.length > 0) { dehydratedQueryClient.queries.forEach((query) => { sentQueries.add(query.queryHash) @@ -95,19 +155,27 @@ export function setupCoreRouterSsrQueryIntegration<TRouter extends AnyRouter>({ ) return } - sentQueries.add(event.query.queryHash) - queryStream.enqueue( - queryDehydrate(queryClient, { - shouldDehydrateQuery: (query) => { - if (query.queryHash === event.query.queryHash) { - return ( - ogClientOptions.dehydrate?.shouldDehydrateQuery?.(query) ?? true - ) - } + const dehydratedQuery = queryDehydrate(queryClient, { + ...dehydrateOptions, + shouldDehydrateQuery: (query) => { + if (query.queryHash !== event.query.queryHash) { return false - }, - }), - ) + } + + return ( + (ogClientOptions.dehydrate?.shouldDehydrateQuery?.(query) ?? + true) && + (dehydrateOptions?.shouldDehydrateQuery?.(query) ?? true) + ) + }, + }) + + if (dehydratedQuery.queries.length === 0) { + return + } + + sentQueries.add(event.query.queryHash) + queryStream.enqueue(dehydratedQuery) }) // on the client } else { @@ -115,7 +183,11 @@ export function setupCoreRouterSsrQueryIntegration<TRouter extends AnyRouter>({ await ogHydrate?.(dehydrated) // hydrate the query client with the dehydrated data (if it was dehydrated on the server) if (dehydrated.dehydratedQueryClient) { - queryHydrate(queryClient, dehydrated.dehydratedQueryClient) + queryHydrate( + queryClient, + dehydrated.dehydratedQueryClient, + hydrateOptions, + ) } // read the query stream and hydrate the queries as they come in @@ -123,7 +195,7 @@ export function setupCoreRouterSsrQueryIntegration<TRouter extends AnyRouter>({ reader .read() .then(async function handle({ done, value }) { - queryHydrate(queryClient, value) + queryHydrate(queryClient, value, hydrateOptions) if (done) { return } @@ -140,7 +212,7 @@ export function setupCoreRouterSsrQueryIntegration<TRouter extends AnyRouter>({ ...ogMutationCacheConfig, onError: (error, ...rest) => { if (isRedirect(error)) { - error.options._fromLocation = router.stores.location.state + error.options._fromLocation = router.stores.location.get() return router.navigate(router.resolveRedirect(error).options) } @@ -153,7 +225,7 @@ export function setupCoreRouterSsrQueryIntegration<TRouter extends AnyRouter>({ ...ogQueryCacheConfig, onError: (error, ...rest) => { if (isRedirect(error)) { - error.options._fromLocation = router.stores.location.state + error.options._fromLocation = router.stores.location.get() return router.navigate(router.resolveRedirect(error).options) } @@ -183,12 +255,19 @@ function createPushableStream(): PushableStream { return { stream, - enqueue: (chunk) => controllerRef.enqueue(chunk), + enqueue: (chunk) => { + if (!_isClosed) controllerRef.enqueue(chunk) + }, close: () => { + if (_isClosed) return controllerRef.close() _isClosed = true }, isClosed: () => _isClosed, - error: (err: unknown) => controllerRef.error(err), + error: (err: unknown) => { + if (_isClosed) return + _isClosed = true + controllerRef.error(err) + }, } } diff --git a/packages/router-ssr-query-core/tests/index.test.ts b/packages/router-ssr-query-core/tests/index.test.ts new file mode 100644 index 0000000000..a167dbd03e --- /dev/null +++ b/packages/router-ssr-query-core/tests/index.test.ts @@ -0,0 +1,516 @@ +import { QueryClient } from '@tanstack/query-core' +import { afterEach, describe, expect, it, vi } from 'vitest' +import { setupCoreRouterSsrQueryIntegration } from '../src' + +type TestRouter = { + isServer: boolean + options: { + dehydrate?: () => unknown | Promise<unknown> + hydrate?: (dehydrated: any) => unknown | Promise<unknown> + } + serverSsr?: { + isDehydrated: () => boolean + onRenderFinished: (listener: () => void) => void + onCleanup: (listener: () => void) => void + } + serverSsrLifecycle?: { + onServerSsrAttach: Array< + (serverSsr: NonNullable<TestRouter['serverSsr']>) => void + > + } +} + +type ServerRouterFixture = { + router: TestRouter + finishRender: () => void + triggerCleanup: () => void + attachServerSsr: () => void + setDehydrated: (value: boolean) => void + cleanupListenerCount: () => number +} + +function createServerRouter(): ServerRouterFixture { + const renderFinishedListeners = new Array<() => void>() + const cleanupListeners = new Array<() => void>() + let dehydrated = false + const serverSsr = { + isDehydrated: () => dehydrated, + onRenderFinished: (listener: () => void) => { + renderFinishedListeners.push(listener) + }, + onCleanup: (listener: () => void) => { + cleanupListeners.push(listener) + }, + } + + const result: ServerRouterFixture = { + router: { + isServer: true, + options: {}, + serverSsr, + }, + finishRender: () => { + renderFinishedListeners.splice(0).forEach((listener) => listener()) + }, + triggerCleanup: () => { + cleanupListeners.splice(0).forEach((listener) => listener()) + }, + attachServerSsr: () => { + result.router.serverSsr = serverSsr + result.router.serverSsrLifecycle?.onServerSsrAttach.forEach( + (listener) => { + listener(serverSsr) + }, + ) + }, + setDehydrated: (value: boolean) => { + dehydrated = value + }, + cleanupListenerCount: () => cleanupListeners.length, + } + + return result +} + +async function readStream<T>(stream: ReadableStream<T>): Promise<Array<T>> { + const reader = stream.getReader() + const chunks = new Array<T>() + + while (true) { + const result = await reader.read() + + if (result.done) { + return chunks + } + + chunks.push(result.value) + } +} + +function createDeferred<T>() { + let resolve!: (value: T) => void + const promise = new Promise<T>((res) => { + resolve = res + }) + + return { + promise, + resolve, + } +} + +function createDehydratedQueryState(data: string) { + return { + data, + dataUpdateCount: 1, + dataUpdatedAt: 1, + error: null, + errorUpdateCount: 0, + errorUpdatedAt: 0, + fetchFailureCount: 0, + fetchFailureReason: null, + fetchMeta: null, + fetchStatus: 'idle' as const, + isInvalidated: false, + status: 'success' as const, + } +} + +// Track QueryClients per-test and clear them in afterEach. Without this, +// queries created in tests keep their gcTime setTimeout handles open (5min +// default in jsdom), pinning QueryClient + QueryCache + this test's router +// alive across the whole suite. cancelQueries() + clear() drops them. +const trackedQueryClients = new Set<QueryClient>() +function track<T extends QueryClient>(client: T): T { + trackedQueryClients.add(client) + return client +} + +afterEach(() => { + vi.clearAllMocks() + for (const client of trackedQueryClients) { + try { + client.cancelQueries() + } catch { + // ignore + } + try { + client.clear() + } catch { + // ignore + } + } + trackedQueryClients.clear() +}) + +describe('setupCoreRouterSsrQueryIntegration', () => { + it('uses custom dehydrate options for the initial payload and streamed queries', async () => { + const queryClient = track(new QueryClient()) + const { router, finishRender, attachServerSsr, setDehydrated } = + createServerRouter() + + router.serverSsr = undefined + setupCoreRouterSsrQueryIntegration({ + router: router as any, + queryClient, + dehydrateOptions: { + serializeData: (data) => `${data}-serialized`, + shouldDehydrateQuery: (query) => query.queryKey[0] !== 'skip', + }, + }) + attachServerSsr() + + queryClient.setQueryData(['include'], 'initial') + queryClient.setQueryData(['skip'], 'ignored') + + const dehydrated = (await router.options.dehydrate?.()) as { + dehydratedQueryClient?: { + queries: Array<{ queryKey: Array<unknown>; state: { data: unknown } }> + } + queryStream: ReadableStream<{ + queries: Array<{ queryKey: Array<unknown>; state: { data: unknown } }> + }> + } + + expect(dehydrated.dehydratedQueryClient?.queries).toHaveLength(1) + expect(dehydrated.dehydratedQueryClient?.queries[0]?.queryKey).toEqual([ + 'include', + ]) + expect(dehydrated.dehydratedQueryClient?.queries[0]?.state.data).toBe( + 'initial-serialized', + ) + + const streamedQueriesPromise = readStream(dehydrated.queryStream) + const includedDeferred = createDeferred<string>() + const skippedDeferred = createDeferred<string>() + + setDehydrated(true) + const includedPromise = queryClient.fetchQuery({ + queryKey: ['streamed'], + queryFn: () => includedDeferred.promise, + }) + const skippedPromise = queryClient.fetchQuery({ + queryKey: ['skip'], + queryFn: () => skippedDeferred.promise, + }) + + await Promise.resolve() + includedDeferred.resolve('next') + skippedDeferred.resolve('still-ignored') + await Promise.all([includedPromise, skippedPromise]) + finishRender() + + const streamedQueries = await streamedQueriesPromise + + expect(streamedQueries).toHaveLength(1) + expect(streamedQueries[0]?.queries).toHaveLength(1) + expect(streamedQueries[0]?.queries[0]?.queryKey).toEqual(['streamed']) + expect(streamedQueries[0]?.queries[0]?.state.data).toBe('next-serialized') + }) + + it('uses custom hydrate options for the initial payload and streamed queries', async () => { + const queryClient = track(new QueryClient()) + const router: TestRouter = { + isServer: false, + options: {}, + } + + setupCoreRouterSsrQueryIntegration({ + router: router as any, + queryClient, + hydrateOptions: { + defaultOptions: { + deserializeData: (data) => `${String(data)}-hydrated`, + }, + }, + }) + + const stream = new ReadableStream({ + start(controller) { + controller.enqueue({ + mutations: [], + queries: [ + { + queryHash: '["streamed"]', + queryKey: ['streamed'], + state: createDehydratedQueryState('stream'), + }, + ], + }) + controller.close() + }, + }) + + await router.options.hydrate?.({ + dehydratedQueryClient: { + mutations: [], + queries: [ + { + queryHash: '["initial"]', + queryKey: ['initial'], + state: createDehydratedQueryState('initial'), + }, + ], + }, + queryStream: stream, + }) + + await Promise.resolve() + await Promise.resolve() + + expect(queryClient.getQueryData(['initial'])).toBe('initial-hydrated') + expect(queryClient.getQueryData(['streamed'])).toBe('stream-hydrated') + }) +}) + +// GC reclamation tests are non-deterministic by nature (V8 makes no +// guarantee about WeakRef collection timing). Run them on demand only: +// RUN_SSR_GC_TESTS=1 pnpm vitest +// The vite config gates --expose-gc on the same env var; outside of that +// gc() is unavailable and the describe is skipped. +const gcAvailable = typeof (globalThis as any).gc === 'function' +const gcTestsEnabled = process.env.RUN_SSR_GC_TESTS === '1' && gcAvailable + +async function forceGc() { + // Multiple passes; V8 may need several GC cycles to collect WeakRef + // targets, especially with closure chains. + for (let i = 0; i < 6; i++) { + ;(globalThis as any).gc() + await new Promise((r) => setTimeout(r, 0)) + } +} + +// Reproduces TanStack/router#7402: per-request Router + QueryClient must be +// reclaimable by GC after SSR cleanup. Without the onCleanup teardown, the +// queryCache subscriber closure + gcTime setTimeout handles pin the +// QueryClient (and transitively the Router via router.context) for the full +// gcTime window (default 5min) per request. +describe.runIf(gcTestsEnabled)('SSR memory: GC reclamation', () => { + it('queryClient + router are reclaimable after cleanup', async () => { + let queryClient: QueryClient | null = new QueryClient({ + defaultOptions: { queries: { gcTime: 5 * 60 * 1000 } }, + }) + let serverRouter: ReturnType<typeof createServerRouter> | null = + createServerRouter() + + serverRouter.router.serverSsr = undefined + setupCoreRouterSsrQueryIntegration({ + router: serverRouter.router as any, + queryClient, + }) + serverRouter.attachServerSsr() + + // Populate cache w/ active gcTime timers (the leak anchor). + queryClient.setQueryData(['a'], 'data-a') + queryClient.setQueryData(['b'], 'data-b') + + // Run a full SSR cycle: dehydrate (registers onCleanup) -> finishRender. + await serverRouter.router.options.dehydrate?.() + serverRouter.setDehydrated(true) + serverRouter.finishRender() + + const qcRef = new WeakRef(queryClient) + const routerRef = new WeakRef(serverRouter.router) + const cacheRef = new WeakRef(queryClient.getQueryCache()) + + // Simulate full request teardown. + serverRouter.triggerCleanup() + + // Drop all strong refs. + queryClient = null + serverRouter = null + + await forceGc() + + expect(qcRef.deref(), 'QueryClient should be GCd').toBeUndefined() + expect(routerRef.deref(), 'Router should be GCd').toBeUndefined() + expect(cacheRef.deref(), 'QueryCache should be GCd').toBeUndefined() + }) + + it('without cleanup, queryClient is retained (control)', async () => { + let queryClient: QueryClient | null = new QueryClient({ + defaultOptions: { queries: { gcTime: 5 * 60 * 1000 } }, + }) + let serverRouter: ReturnType<typeof createServerRouter> | null = + createServerRouter() + + serverRouter.router.serverSsr = undefined + setupCoreRouterSsrQueryIntegration({ + router: serverRouter.router as any, + queryClient, + }) + serverRouter.attachServerSsr() + + queryClient.setQueryData(['a'], 'data-a') + await serverRouter.router.options.dehydrate?.() + + const qcRef = new WeakRef(queryClient) + + // Drop strong refs WITHOUT triggering cleanup. + queryClient = null + serverRouter = null + + try { + await forceGc() + + // Subscriber closure + gcTime timers keep it alive. This is the bug + // we are guarding against; if this ever passes (returns undefined) the + // production retention chain has changed and the cleanup-based test + // above may also need re-validation. + expect(qcRef.deref()).toBeDefined() + } finally { + // Avoid leaving the retained client + gcTime timers alive for up to + // 5 minutes after the test finishes. + qcRef.deref()?.clear() + } + }) +}) + +// ===================================================================== +// CI-stable cleanup behavior tests. These do not rely on GC timing; they +// assert the observable side-effects that make GC reclamation possible. +// ===================================================================== +describe('SSR cleanup: deterministic behavior', () => { + it('teardown runs when cleanup fires before dehydrate (loader redirect/error case)', async () => { + const queryClient = track(new QueryClient()) + const { router, triggerCleanup, attachServerSsr, setDehydrated } = + createServerRouter() + + router.serverSsr = undefined + setupCoreRouterSsrQueryIntegration({ + router: router as any, + queryClient, + }) + attachServerSsr() + + // Cleanup registration happens when server SSR attaches, before loaders. + setDehydrated(true) + await queryClient.fetchQuery({ + queryKey: ['early'], + queryFn: () => 'data', + }) + + expect(queryClient.getQueryData(['early'])).toBe('data') + + // Trigger cleanup as createRequestHandler's finally block would. + triggerCleanup() + + // After cleanup the cache must be cleared (gcTime timers gone). + expect(queryClient.getQueryData(['early'])).toBeUndefined() + }) + + it('cancels in-flight queries on cleanup (signal aborted)', async () => { + const queryClient = track(new QueryClient()) + const { router, triggerCleanup, attachServerSsr, setDehydrated } = + createServerRouter() + + router.serverSsr = undefined + setupCoreRouterSsrQueryIntegration({ + router: router as any, + queryClient, + }) + attachServerSsr() + setDehydrated(true) + + let observedAborted = false + const queryStarted = createDeferred<void>() + const inflight = queryClient.fetchQuery({ + queryKey: ['slow'], + queryFn: ({ signal }) => + new Promise<string>((_resolve, reject) => { + signal.addEventListener('abort', () => { + observedAborted = true + reject(new Error('aborted')) + }) + // Signal the test once the queryFn has actually started and the + // abort listener is wired up. No real timers required. + queryStarted.resolve() + }), + }) + // Swallow the rejection from fetchQuery + inflight.catch(() => {}) + + await queryStarted.promise + + triggerCleanup() + // Flush microtasks so the abort event handler runs. + await Promise.resolve() + await Promise.resolve() + + expect(observedAborted).toBe(true) + }) + + it('cleanup is idempotent: listener runs exactly once even with repeated triggers', async () => { + const queryClient = track(new QueryClient()) + const { + router, + triggerCleanup, + attachServerSsr, + setDehydrated, + cleanupListenerCount, + } = createServerRouter() + + router.serverSsr = undefined + setupCoreRouterSsrQueryIntegration({ + router: router as any, + queryClient, + }) + attachServerSsr() + setDehydrated(true) + + // Cleanup was registered at setup because serverSsr was already attached. + await queryClient.fetchQuery({ + queryKey: ['x'], + queryFn: () => 'data', + }) + expect(cleanupListenerCount()).toBe(1) + expect(queryClient.getQueryData(['x'])).toBe('data') + + triggerCleanup() + // Cache cleared by teardown. + expect(queryClient.getQueryData(['x'])).toBeUndefined() + + // Second trigger after listeners already drained: no throw, no + // re-registration (cleanupRegistered flag prevents re-subscribe). + expect(() => triggerCleanup()).not.toThrow() + expect(cleanupListenerCount()).toBe(0) + }) + + it('registers cleanup when serverSsr attaches after subscriber setup', async () => { + // Simulate user code prepopulating the cache inside getRouter() BEFORE + // attachRouterServerSsrUtils() runs. queryCache subscriber fires while + // serverSsr is undefined; cleanup still registers at attach time, before + // router.load() can throw in beforeLoad. + const queryClient = track(new QueryClient()) + const { + router, + triggerCleanup, + attachServerSsr, + setDehydrated, + cleanupListenerCount, + } = createServerRouter() + // Detach to simulate pre-attach state. + router.serverSsr = undefined + + setupCoreRouterSsrQueryIntegration({ + router: router as any, + queryClient, + }) + + // Prepopulate before attach; queryCache event fires while serverSsr is + // undefined. This must not be the registration point. + await queryClient.fetchQuery({ + queryKey: ['pre'], + queryFn: () => 'early', + }) + expect(cleanupListenerCount()).toBe(0) + + // attachRouterServerSsrUtils equivalent. No onBeforeLoad/dehydrate needed. + attachServerSsr() + setDehydrated(true) + expect(cleanupListenerCount()).toBe(1) + + triggerCleanup() + expect(queryClient.getQueryData(['pre'])).toBeUndefined() + }) +}) diff --git a/packages/router-ssr-query-core/vite.config.ts b/packages/router-ssr-query-core/vite.config.ts index 6a1940e56e..811b179d2d 100644 --- a/packages/router-ssr-query-core/vite.config.ts +++ b/packages/router-ssr-query-core/vite.config.ts @@ -1,8 +1,15 @@ +import path from 'node:path' import { defineConfig, mergeConfig } from 'vitest/config' import { tanstackViteConfig } from '@tanstack/vite-config' import packageJson from './package.json' import type { ViteUserConfig } from 'vitest/config' +// GC/WeakRef tests are flaky in CI because V8 does not guarantee reclamation +// timing. They are env-gated and only run with RUN_SSR_GC_TESTS=1. When the +// flag is set we additionally enable --expose-gc and use the forks pool so +// globalThis.gc() is available. +const runGcTests = process.env.RUN_SSR_GC_TESTS === '1' + const config = defineConfig({ test: { name: packageJson.name, @@ -10,6 +17,17 @@ const config = defineConfig({ watch: false, environment: 'jsdom', typecheck: { enabled: true }, + alias: { + // For tests only, resolve to development.ts which returns undefined + // so that router.isServer fallback is used (mirrors router-core). + '@tanstack/router-core/isServer': path.resolve( + __dirname, + '../router-core/src/isServer/development.ts', + ), + }, + ...(runGcTests + ? { pool: 'forks' as const, execArgv: ['--expose-gc'] } + : {}), }, }) diff --git a/packages/router-utils/CHANGELOG.md b/packages/router-utils/CHANGELOG.md index 6e8c68408e..3ddb72188a 100644 --- a/packages/router-utils/CHANGELOG.md +++ b/packages/router-utils/CHANGELOG.md @@ -1,5 +1,33 @@ # @tanstack/router-utils +## 1.162.1 + +### Patch Changes + +- Add deferred Hydrate boundary support for TanStack Start. ([#7362](https://github.com/TanStack/router/pull/7362)) + + Hydrate boundaries can now be code-split by the Start compiler, preload their generated client chunks, preserve server-rendered fallback HTML, and replay interaction-triggered events after hydration. The compiler integration now uses a Start-owned compiler plugin for Hydrate virtual modules across Vite and Rsbuild, with dev invalidation for generated virtual modules. + + Shared AST utilities used by the router code-splitter and Hydrate virtual modules were moved into `@tanstack/router-utils` so both pipelines can retain referenced top-level declarations, unwrap local exports, and let dead-code elimination remove unused route module code. + +## 1.162.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +## 1.161.8 + +### Patch Changes + +- Parse plain TypeScript files without JSX when a filename is available, preventing angle-bracket type assertions from being interpreted as JSX during route and Start import-protection transforms. ([#7342](https://github.com/TanStack/router/pull/7342)) + +## 1.161.7 + +### Patch Changes + +- rsbuild ([#7228](https://github.com/TanStack/router/pull/7228)) + ## 1.161.6 ### Patch Changes diff --git a/packages/router-utils/package.json b/packages/router-utils/package.json index b28e893d40..c07a329914 100644 --- a/packages/router-utils/package.json +++ b/packages/router-utils/package.json @@ -1,6 +1,6 @@ { "name": "@tanstack/router-utils", - "version": "1.161.6", + "version": "1.162.1", "description": "Modern and scalable routing for React applications", "author": "Tanner Linsley", "license": "MIT", diff --git a/packages/router-utils/src/ast.ts b/packages/router-utils/src/ast.ts index 72525b8b8d..46e319c2c4 100644 --- a/packages/router-utils/src/ast.ts +++ b/packages/router-utils/src/ast.ts @@ -11,17 +11,53 @@ import type * as _babel_types from '@babel/types' export type ParseAstOptions = ParserOptions & { code: string + filename?: string } export type ParseAstResult = ParseResult<_babel_types.File> -export function parseAst({ code, ...opts }: ParseAstOptions): ParseAstResult { +export function parseAst({ + code, + filename, + sourceFilename, + plugins, + ...opts +}: ParseAstOptions): ParseAstResult { + const inferredFilename = filename ?? sourceFilename return parse(code, { - plugins: ['jsx', 'typescript', 'explicitResourceManagement'], + plugins: plugins ?? getDefaultParserPluginsForFilename(inferredFilename), sourceType: 'module', + sourceFilename, ...opts, }) } +function getDefaultParserPluginsForFilename( + filename: string | undefined, +): NonNullable<ParserOptions['plugins']> { + const plugins: NonNullable<ParserOptions['plugins']> = [ + 'typescript', + 'explicitResourceManagement', + 'importAttributes', + 'deprecatedImportAssert', + ['decorators', { decoratorsBeforeExport: true }], + 'decoratorAutoAccessors', + ] + + if (!isPlainTypeScriptFile(filename)) { + plugins.unshift('jsx') + } + + return plugins +} + +function isPlainTypeScriptFile(filename: string | undefined): boolean { + if (!filename) { + return false + } + + return /\.[cm]?ts(?:$|[?#])/.test(filename) +} + let generate = _generate if ('default' in generate) { diff --git a/packages/router-utils/src/compiler-helpers.ts b/packages/router-utils/src/compiler-helpers.ts new file mode 100644 index 0000000000..78d6cd9b86 --- /dev/null +++ b/packages/router-utils/src/compiler-helpers.ts @@ -0,0 +1,843 @@ +import * as t from '@babel/types' + +type IdentifierScopeFrame = { + kind: 'program' | 'function' | 'block' + bindings: Set<string> +} +type IdentifierScopeStack = Array<IdentifierScopeFrame> + +export type ModuleInfoBinding = + | { + type: 'import' + source: string + importedName: string + } + | { + type: 'var' + init: t.Expression | null + } + +export interface ExtractedModuleInfo { + bindings: Map<string, ModuleInfoBinding> + exports: Map<string, string> + reExportAllSources: Array<string> +} + +function getModuleExportName(node: t.Identifier | t.StringLiteral) { + return t.isIdentifier(node) ? node.name : node.value +} + +function addVariableDeclarationModuleInfo( + declaration: t.VariableDeclaration, + bindings: Map<string, ModuleInfoBinding>, + exportMap?: Map<string, string>, +) { + for (const declarator of declaration.declarations) { + for (const name of collectIdentifiersFromPattern(declarator.id)) { + bindings.set(name, { + type: 'var', + init: declarator.init ?? null, + }) + exportMap?.set(name, name) + } + } +} + +function addDeclarationModuleInfo( + declaration: t.Declaration, + bindings: Map<string, ModuleInfoBinding>, + exportMap?: Map<string, string>, +) { + if (t.isVariableDeclaration(declaration)) { + addVariableDeclarationModuleInfo(declaration, bindings, exportMap) + return + } + + if ( + (t.isFunctionDeclaration(declaration) || + t.isClassDeclaration(declaration)) && + declaration.id + ) { + bindings.set(declaration.id.name, { + type: 'var', + init: null, + }) + exportMap?.set(declaration.id.name, declaration.id.name) + } +} + +function hasIdentifierBinding(scopes: IdentifierScopeStack, name: string) { + for (let i = scopes.length - 1; i >= 0; i--) { + if (scopes[i]!.bindings.has(name)) { + return true + } + } + return false +} + +function currentIdentifierScope(scopes: IdentifierScopeStack) { + return scopes[scopes.length - 1]! +} + +function nearestFunctionIdentifierScope(scopes: IdentifierScopeStack) { + for (let i = scopes.length - 1; i >= 0; i--) { + const scope = scopes[i]! + if (scope.kind === 'function' || scope.kind === 'program') { + return scope + } + } + return currentIdentifierScope(scopes) +} + +function addIdentifierPatternBindings( + pattern: t.LVal | t.Node | null | undefined, + scope: IdentifierScopeFrame, +) { + for (const name of collectIdentifiersFromPattern(pattern)) { + scope.bindings.add(name) + } +} + +function addIdentifierDeclarationBindings( + declaration: t.Node, + scopes: IdentifierScopeStack, +) { + if (t.isVariableDeclaration(declaration)) { + const scope = + declaration.kind === 'var' + ? nearestFunctionIdentifierScope(scopes) + : currentIdentifierScope(scopes) + for (const declarator of declaration.declarations) { + addIdentifierPatternBindings(declarator.id, scope) + } + return + } + + if ( + (t.isFunctionDeclaration(declaration) || + t.isClassDeclaration(declaration) || + t.isTSTypeAliasDeclaration(declaration) || + t.isTSInterfaceDeclaration(declaration) || + t.isTSEnumDeclaration(declaration)) && + declaration.id + ) { + currentIdentifierScope(scopes).bindings.add(declaration.id.name) + } +} + +function addIdentifierImportBindings( + node: t.ImportDeclaration, + scope: IdentifierScopeFrame, +) { + for (const specifier of node.specifiers) { + scope.bindings.add(specifier.local.name) + } +} + +function createNestedIdentifierScope( + kind: IdentifierScopeFrame['kind'], + scopes: IdentifierScopeStack, +): IdentifierScopeStack { + return [...scopes, { kind, bindings: new Set() }] +} + +function addIdentifierBlockBindings( + body: Array<t.Node>, + scopes: IdentifierScopeStack, +) { + for (const statement of body) { + if (t.isImportDeclaration(statement)) { + addIdentifierImportBindings(statement, currentIdentifierScope(scopes)) + } else if (t.isExportNamedDeclaration(statement) && statement.declaration) { + addIdentifierDeclarationBindings(statement.declaration, scopes) + } else { + addIdentifierDeclarationBindings(statement, scopes) + } + } +} + +function walkIdentifierChildren( + current: t.Node, + parent: t.Node | undefined, + scopes: IdentifierScopeStack, + ids: Set<string>, +) { + for (const key of t.VISITOR_KEYS[current.type] ?? []) { + const child = (current as any)[key] + if (Array.isArray(child)) { + for (const item of child) { + if (item && typeof item.type === 'string') { + walkIdentifierNode(item, current, parent, key, scopes, ids) + } + } + } else if (child && typeof child.type === 'string') { + walkIdentifierNode(child, current, parent, key, scopes, ids) + } + } +} + +function walkIdentifierNode( + current: t.Node | null | undefined, + parent: t.Node | undefined, + grandparent: t.Node | undefined, + parentKey: string | undefined, + scopes: IdentifierScopeStack, + ids: Set<string>, +) { + if (!current) return + + if (t.isIdentifier(current)) { + if ( + (!parent || t.isReferenced(current, parent, grandparent)) && + !hasIdentifierBinding(scopes, current.name) + ) { + ids.add(current.name) + } + return + } + + if (t.isJSXIdentifier(current)) { + if (parent && t.isJSXAttribute(parent) && parentKey === 'name') { + return + } + + if (parent && t.isJSXMemberExpression(parent) && parentKey === 'property') { + return + } + + const first = current.name[0] + if (first && first === first.toLowerCase()) { + return + } + + if (!hasIdentifierBinding(scopes, current.name)) { + ids.add(current.name) + } + return + } + + if (t.isProgram(current)) { + const nestedScopes = createNestedIdentifierScope('program', scopes) + addIdentifierBlockBindings(current.body, nestedScopes) + for (const child of current.body) { + walkIdentifierNode(child, current, parent, 'body', nestedScopes, ids) + } + return + } + + if (t.isBlockStatement(current)) { + const nestedScopes = createNestedIdentifierScope('block', scopes) + addIdentifierBlockBindings(current.body, nestedScopes) + for (const child of current.body) { + walkIdentifierNode(child, current, parent, 'body', nestedScopes, ids) + } + return + } + + if ( + t.isFunctionDeclaration(current) || + t.isFunctionExpression(current) || + t.isArrowFunctionExpression(current) || + t.isObjectMethod(current) || + t.isClassMethod(current) || + t.isClassPrivateMethod(current) + ) { + if (t.isFunctionDeclaration(current) && current.id) { + currentIdentifierScope(scopes).bindings.add(current.id.name) + } + + const nestedScopes = createNestedIdentifierScope('function', scopes) + if ( + (t.isFunctionDeclaration(current) || t.isFunctionExpression(current)) && + current.id + ) { + currentIdentifierScope(nestedScopes).bindings.add(current.id.name) + } + for (const param of current.params) { + addIdentifierPatternBindings(param, currentIdentifierScope(nestedScopes)) + } + + walkIdentifierChildren(current, parent, nestedScopes, ids) + return + } + + if (t.isCatchClause(current)) { + const nestedScopes = createNestedIdentifierScope('block', scopes) + addIdentifierPatternBindings( + current.param, + currentIdentifierScope(nestedScopes), + ) + walkIdentifierNode( + current.param, + current, + parent, + 'param', + nestedScopes, + ids, + ) + walkIdentifierNode(current.body, current, parent, 'body', nestedScopes, ids) + return + } + + if (t.isImportDeclaration(current)) { + addIdentifierImportBindings(current, currentIdentifierScope(scopes)) + return + } + + if (t.isClassDeclaration(current) || t.isClassExpression(current)) { + if (t.isClassDeclaration(current) && current.id) { + currentIdentifierScope(scopes).bindings.add(current.id.name) + } + + const nestedScopes = current.id + ? createNestedIdentifierScope('block', scopes) + : scopes + if (current.id) { + currentIdentifierScope(nestedScopes).bindings.add(current.id.name) + } + + walkIdentifierChildren(current, parent, nestedScopes, ids) + return + } + + if (t.isVariableDeclaration(current)) { + addIdentifierDeclarationBindings(current, scopes) + } else if (t.isVariableDeclarator(current)) { + const scope = + parent && t.isVariableDeclaration(parent) && parent.kind === 'var' + ? nearestFunctionIdentifierScope(scopes) + : currentIdentifierScope(scopes) + addIdentifierPatternBindings(current.id, scope) + } else if ( + t.isTSTypeAliasDeclaration(current) || + t.isTSInterfaceDeclaration(current) || + t.isTSEnumDeclaration(current) + ) { + currentIdentifierScope(scopes).bindings.add(current.id.name) + } + + walkIdentifierChildren(current, parent, scopes, ids) +} + +/** + * Recursively walk an AST node and collect referenced identifier-like names. + * This avoids Babel path/scope allocation for module-level dependency scans. + */ +export function collectIdentifiersFromNode(node: t.Node): Set<string> { + const ids = new Set<string>() + walkIdentifierNode( + node, + undefined, + undefined, + undefined, + [{ kind: 'program', bindings: new Set() }], + ids, + ) + return ids +} + +export function collectIdentifiersFromPattern( + node: t.LVal | t.Node | null | undefined, +): Array<string> { + if (!node) { + return [] + } + + if (t.isIdentifier(node)) { + return [node.name] + } + + if (t.isAssignmentPattern(node)) { + return collectIdentifiersFromPattern(node.left) + } + + if (t.isRestElement(node)) { + return collectIdentifiersFromPattern(node.argument) + } + + if (t.isObjectPattern(node)) { + return node.properties.flatMap((prop) => { + if (t.isObjectProperty(prop)) { + return collectIdentifiersFromPattern(prop.value as t.LVal) + } + if (t.isRestElement(prop)) { + return collectIdentifiersFromPattern(prop.argument) + } + return [] + }) + } + + if (t.isArrayPattern(node)) { + return node.elements.flatMap((element) => + collectIdentifiersFromPattern(element), + ) + } + + return [] +} + +export function collectLocalBindingsFromStatement( + node: t.Statement | t.ModuleDeclaration, + bindings: Set<string>, +) { + const declaration = + t.isExportNamedDeclaration(node) && node.declaration + ? node.declaration + : t.isExportDefaultDeclaration(node) + ? node.declaration + : node + + if (t.isVariableDeclaration(declaration)) { + for (const declarator of declaration.declarations) { + for (const name of collectIdentifiersFromPattern(declarator.id)) { + bindings.add(name) + } + } + } else if (t.isFunctionDeclaration(declaration) && declaration.id) { + bindings.add(declaration.id.name) + } else if (t.isClassDeclaration(declaration) && declaration.id) { + bindings.add(declaration.id.name) + } +} + +export function extractModuleInfoFromAst(ast: t.File): ExtractedModuleInfo { + const bindings = new Map<string, ModuleInfoBinding>() + const exportMap = new Map<string, string>() + const reExportAllSources: Array<string> = [] + + for (const node of ast.program.body) { + if (t.isImportDeclaration(node)) { + const source = node.source.value + for (const specifier of node.specifiers) { + if (t.isImportSpecifier(specifier)) { + bindings.set(specifier.local.name, { + type: 'import', + source, + importedName: getModuleExportName(specifier.imported), + }) + } else if (t.isImportDefaultSpecifier(specifier)) { + bindings.set(specifier.local.name, { + type: 'import', + source, + importedName: 'default', + }) + } else if (t.isImportNamespaceSpecifier(specifier)) { + bindings.set(specifier.local.name, { + type: 'import', + source, + importedName: '*', + }) + } + } + continue + } + + if (t.isVariableDeclaration(node)) { + addVariableDeclarationModuleInfo(node, bindings) + continue + } + + if (t.isFunctionDeclaration(node) || t.isClassDeclaration(node)) { + addDeclarationModuleInfo(node, bindings) + continue + } + + if (t.isExportNamedDeclaration(node)) { + if (node.declaration) { + addDeclarationModuleInfo(node.declaration, bindings, exportMap) + } + + for (const specifier of node.specifiers) { + if (t.isExportNamespaceSpecifier(specifier)) { + const exported = getModuleExportName(specifier.exported) + exportMap.set(exported, exported) + if (node.source) { + bindings.set(exported, { + type: 'import', + source: node.source.value, + importedName: '*', + }) + } + } else if (t.isExportSpecifier(specifier)) { + const local = getModuleExportName(specifier.local) + const exported = getModuleExportName(specifier.exported) + exportMap.set(exported, local) + + if (node.source) { + bindings.set(local, { + type: 'import', + source: node.source.value, + importedName: local, + }) + } + } + } + continue + } + + if (t.isExportDefaultDeclaration(node)) { + const declaration = node.declaration + if (t.isIdentifier(declaration)) { + exportMap.set('default', declaration.name) + } else if ( + (t.isFunctionDeclaration(declaration) || + t.isClassDeclaration(declaration)) && + declaration.id + ) { + bindings.set(declaration.id.name, { + type: 'var', + init: null, + }) + exportMap.set('default', declaration.id.name) + } else { + const synth = '__default_export__' + bindings.set(synth, { + type: 'var', + init: t.isExpression(declaration) ? declaration : null, + }) + exportMap.set('default', synth) + } + continue + } + + if (t.isExportAllDeclaration(node)) { + reExportAllSources.push(node.source.value) + } + } + + return { + bindings, + exports: exportMap, + reExportAllSources, + } +} + +export function buildDeclarationMap(ast: t.File): Map<string, t.Node> { + const map = new Map<string, t.Node>() + + for (const statement of ast.program.body) { + const declaration = + t.isExportNamedDeclaration(statement) && statement.declaration + ? statement.declaration + : t.isExportDefaultDeclaration(statement) + ? statement.declaration + : statement + + if (t.isVariableDeclaration(declaration)) { + for (const declarator of declaration.declarations) { + for (const name of collectIdentifiersFromPattern(declarator.id)) { + map.set(name, declarator) + } + } + } else if (t.isFunctionDeclaration(declaration) && declaration.id) { + map.set(declaration.id.name, declaration) + } else if (t.isClassDeclaration(declaration) && declaration.id) { + map.set(declaration.id.name, declaration) + } + } + + return map +} + +export function buildDependencyGraph( + declarationMap: Map<string, t.Node>, + localBindings: Set<string>, +): Map<string, Set<string>> { + const graph = new Map<string, Set<string>>() + + for (const [name, declarationNode] of declarationMap) { + if (!localBindings.has(name)) continue + + const dependencies = new Set<string>() + for (const id of collectIdentifiersFromNode(declarationNode)) { + if (id !== name && localBindings.has(id)) { + dependencies.add(id) + } + } + graph.set(name, dependencies) + } + + return graph +} + +export function collectModuleLevelRefsFromNode( + node: t.Node, + localModuleLevelBindings: Set<string>, +): Set<string> { + const refs = new Set<string>() + + for (const name of collectIdentifiersFromNode(node)) { + if (localModuleLevelBindings.has(name)) { + refs.add(name) + } + } + + return refs +} + +export function expandTransitively( + bindings: Set<string>, + dependencyGraph: Map<string, Set<string>>, +) { + const queue = [...bindings] + const visited = new Set<string>() + + while (queue.length > 0) { + const name = queue.pop()! + if (visited.has(name)) continue + visited.add(name) + + const dependencies = dependencyGraph.get(name) + if (!dependencies) continue + + for (const dependency of dependencies) { + if (!bindings.has(dependency)) { + bindings.add(dependency) + queue.push(dependency) + } + } + } +} + +export function expandSharedDestructuredDeclarators( + ast: t.File, + refsByGroup: Map<string, Set<number>>, + sharedBindings: Set<string>, +) { + for (const statement of ast.program.body) { + const declaration = + t.isExportNamedDeclaration(statement) && statement.declaration + ? statement.declaration + : statement + + if (!t.isVariableDeclaration(declaration)) continue + + for (const declarator of declaration.declarations) { + if ( + !t.isObjectPattern(declarator.id) && + !t.isArrayPattern(declarator.id) + ) { + continue + } + + const names = collectIdentifiersFromPattern(declarator.id) + const usedGroups = new Set<number>() + + for (const name of names) { + const groups = refsByGroup.get(name) + if (!groups) continue + for (const group of groups) { + usedGroups.add(group) + } + } + + if (usedGroups.size >= 2) { + for (const name of names) { + sharedBindings.add(name) + } + } + } + } +} + +export function expandDestructuredDeclarations( + ast: t.File, + bindings: Set<string>, +) { + for (const statement of ast.program.body) { + const declaration = + t.isExportNamedDeclaration(statement) && statement.declaration + ? statement.declaration + : statement + + if (!t.isVariableDeclaration(declaration)) continue + + for (const declarator of declaration.declarations) { + if ( + !t.isObjectPattern(declarator.id) && + !t.isArrayPattern(declarator.id) + ) { + continue + } + + const names = collectIdentifiersFromPattern(declarator.id) + if (names.some((name) => bindings.has(name))) { + for (const name of names) { + bindings.add(name) + } + } + } + } +} + +export function removeBindingsTransitivelyDependingOn( + bindings: Set<string>, + dependencyGraph: Map<string, Set<string>>, + roots: Iterable<string>, +) { + const reverseGraph = new Map<string, Set<string>>() + + for (const [name, dependencies] of dependencyGraph) { + for (const dependency of dependencies) { + let parents = reverseGraph.get(dependency) + if (!parents) { + parents = new Set() + reverseGraph.set(dependency, parents) + } + parents.add(name) + } + } + + const visited = new Set<string>() + const queue = [...roots] + + while (queue.length > 0) { + const current = queue.pop()! + if (visited.has(current)) continue + visited.add(current) + + const parents = reverseGraph.get(current) + if (!parents) continue + + for (const parent of parents) { + if (!visited.has(parent)) { + queue.push(parent) + } + } + } + + for (const name of [...bindings]) { + if (visited.has(name)) { + bindings.delete(name) + } + } +} + +export function removeModuleLevelBindings( + ast: t.File, + namesToRemove: Set<string>, +) { + ast.program.body = ast.program.body.filter((statement) => { + const declaration = + t.isExportNamedDeclaration(statement) && statement.declaration + ? statement.declaration + : statement + + if (t.isVariableDeclaration(declaration)) { + declaration.declarations = declaration.declarations.filter( + (declarator) => + !collectIdentifiersFromPattern(declarator.id).some((name) => + namesToRemove.has(name), + ), + ) + return declaration.declarations.length > 0 + } + + if (t.isFunctionDeclaration(declaration) && declaration.id) { + return !namesToRemove.has(declaration.id.name) + } + + if (t.isClassDeclaration(declaration) && declaration.id) { + return !namesToRemove.has(declaration.id.name) + } + + if (t.isExportDefaultDeclaration(statement)) { + const defaultDeclaration = statement.declaration + if ( + (t.isFunctionDeclaration(defaultDeclaration) || + t.isClassDeclaration(defaultDeclaration)) && + defaultDeclaration.id + ) { + return !namesToRemove.has(defaultDeclaration.id.name) + } + } + + return true + }) +} + +export function retainModuleLevelDeclarations( + ast: t.File, + bindingsToKeep: Set<string>, +) { + ast.program.body = ast.program.body.filter((statement) => { + if (t.isImportDeclaration(statement)) return true + + const declaration = + t.isExportNamedDeclaration(statement) && statement.declaration + ? statement.declaration + : statement + + if (t.isVariableDeclaration(declaration)) { + declaration.declarations = declaration.declarations.filter((declarator) => + collectIdentifiersFromPattern(declarator.id).some((name) => + bindingsToKeep.has(name), + ), + ) + return declaration.declarations.length > 0 + } + + if (t.isFunctionDeclaration(declaration) && declaration.id) { + return bindingsToKeep.has(declaration.id.name) + } + + if (t.isClassDeclaration(declaration) && declaration.id) { + return bindingsToKeep.has(declaration.id.name) + } + + return false + }) +} + +export function unwrapExportedDeclarations(ast: t.File) { + const body: Array<t.Statement | t.ModuleDeclaration> = [] + + for (const statement of ast.program.body) { + if (t.isExportNamedDeclaration(statement)) { + if (statement.declaration) { + body.push(statement.declaration) + } + continue + } + + if (t.isExportDefaultDeclaration(statement)) { + const declaration = statement.declaration + if ( + (t.isFunctionDeclaration(declaration) || + t.isClassDeclaration(declaration)) && + declaration.id + ) { + body.push(declaration) + } + continue + } + + if (t.isExportAllDeclaration(statement)) { + continue + } + + body.push(statement) + } + + ast.program.body = body +} + +export function stripUnreferencedTopLevelExpressionStatements(ast: t.File) { + const locallyBound = new Set<string>() + + for (const statement of ast.program.body) { + collectLocalBindingsFromStatement(statement, locallyBound) + } + + ast.program.body = ast.program.body.filter((statement) => { + if (!t.isExpressionStatement(statement)) return true + + for (const name of collectIdentifiersFromNode(statement)) { + if (locallyBound.has(name)) { + return true + } + } + + return false + }) +} diff --git a/packages/router-utils/src/index.ts b/packages/router-utils/src/index.ts index 3b072ae419..ce0de90824 100644 --- a/packages/router-utils/src/index.ts +++ b/packages/router-utils/src/index.ts @@ -9,3 +9,24 @@ export type { ParseAstOptions, ParseAstResult, GeneratorResult } from './ast' export { logDiff } from './logger' export { copyFilesPlugin } from './copy-files-plugin' + +export { createIdentifier, decodeIdentifier } from './path-ids' + +export { + buildDeclarationMap, + buildDependencyGraph, + collectIdentifiersFromNode, + collectIdentifiersFromPattern, + collectLocalBindingsFromStatement, + collectModuleLevelRefsFromNode, + expandDestructuredDeclarations, + expandSharedDestructuredDeclarators, + expandTransitively, + extractModuleInfoFromAst, + removeBindingsTransitivelyDependingOn, + removeModuleLevelBindings, + retainModuleLevelDeclarations, + stripUnreferencedTopLevelExpressionStatements, + unwrapExportedDeclarations, +} from './compiler-helpers' +export type { ExtractedModuleInfo, ModuleInfoBinding } from './compiler-helpers' diff --git a/packages/router-plugin/src/core/code-splitter/path-ids.ts b/packages/router-utils/src/path-ids.ts similarity index 100% rename from packages/router-plugin/src/core/code-splitter/path-ids.ts rename to packages/router-utils/src/path-ids.ts diff --git a/packages/router-utils/tests/compiler-helpers.test.ts b/packages/router-utils/tests/compiler-helpers.test.ts new file mode 100644 index 0000000000..00b75d67e5 --- /dev/null +++ b/packages/router-utils/tests/compiler-helpers.test.ts @@ -0,0 +1,249 @@ +import * as t from '@babel/types' +import { describe, expect, test } from 'vitest' +import { + buildDeclarationMap, + collectIdentifiersFromNode, + collectLocalBindingsFromStatement, + extractModuleInfoFromAst, +} from '../src/compiler-helpers' +import { parseAst } from '../src/ast' + +function getVariableInit(code: string) { + const ast = parseAst({ code, filename: 'test.tsx' }) + const declaration = ast.program.body.find((node) => + t.isVariableDeclaration(node), + ) as t.VariableDeclaration + return declaration.declarations[0]!.init! +} + +function collectSortedIdentifiers(node: t.Node) { + return [...collectIdentifiersFromNode(node)].sort() +} + +function collectSortedStatementBindings(code: string) { + const ast = parseAst({ code, filename: 'test.tsx' }) + const bindings = new Set<string>() + for (const statement of ast.program.body) { + collectLocalBindingsFromStatement(statement, bindings) + } + return [...bindings].sort() +} + +function collectSortedDeclarationMapEntries(code: string) { + const ast = parseAst({ code, filename: 'test.tsx' }) + return [...buildDeclarationMap(ast)] + .map(([name, node]): [string, string] => [name, node.type]) + .sort((left, right) => (left[0] < right[0] ? -1 : 1)) +} + +function collectModuleInfoSnapshot(code: string) { + const ast = parseAst({ code, filename: 'test.tsx' }) + const info = extractModuleInfoFromAst(ast) + return { + bindings: [...info.bindings] + .map(([name, binding]) => [ + name, + binding.type === 'import' + ? `${binding.source}:${binding.importedName}` + : (binding.init?.type ?? null), + ]) + .sort((left, right) => (left[0]! < right[0]! ? -1 : 1)), + exports: [...info.exports].sort((left, right) => + left[0] < right[0] ? -1 : 1, + ), + reExportAllSources: info.reExportAllSources, + } +} + +describe('collectIdentifiersFromNode', () => { + test('collects free identifiers without reporting nested local bindings', () => { + const init = getVariableInit(` +const value = outer + (() => { + const local = dep + + function nested(param = fallback) { + const Inner = () => <LocalComponent value={param} /> + const LocalExpr = class NamedLocal { + method() { + return NamedLocal + local + param + } + } + + class LocalComponent {} + + return local + param + imported + Inner + LocalExpr + } + + return nested() +})() +`) + + expect(collectSortedIdentifiers(init)).toMatchInlineSnapshot(` + [ + "dep", + "fallback", + "imported", + "outer", + ] + `) + }) + + test('respects nested variable, parameter, catch, and import shadowing', () => { + const ast = parseAst({ + code: ` +import { external as localImport } from 'pkg' + +const value = (localParam = defaultValue) => { + const localShadow = factory(localImport) + + try { + throw thrown + } catch (thrown) { + const factory = () => localShadow + localParam + thrown + return factory() + } +} +`, + filename: 'test.ts', + }) + + expect(collectSortedIdentifiers(ast.program)).toMatchInlineSnapshot(` + [ + "defaultValue", + "factory", + "thrown", + ] + `) + }) +}) + +describe('collectLocalBindingsFromStatement', () => { + test('collects ids from named default function and class declarations', () => { + expect({ + class: collectSortedStatementBindings( + `export default class DefaultComponent {}`, + ), + function: collectSortedStatementBindings( + `export default function DefaultRoute() {}`, + ), + anonymous: collectSortedStatementBindings( + `export default function () {}`, + ), + }).toMatchInlineSnapshot(` + { + "anonymous": [], + "class": [ + "DefaultComponent", + ], + "function": [ + "DefaultRoute", + ], + } + `) + }) +}) + +describe('buildDeclarationMap', () => { + test('maps named default function and class declarations', () => { + expect({ + class: collectSortedDeclarationMapEntries( + `export default class DefaultComponent {}`, + ), + function: collectSortedDeclarationMapEntries( + `export default function DefaultRoute() {}`, + ), + anonymous: collectSortedDeclarationMapEntries(`export default class {}`), + }).toMatchInlineSnapshot(` + { + "anonymous": [], + "class": [ + [ + "DefaultComponent", + "ClassDeclaration", + ], + ], + "function": [ + [ + "DefaultRoute", + "FunctionDeclaration", + ], + ], + } + `) + }) +}) + +describe('extractModuleInfoFromAst', () => { + test('extracts imports, local exports, default exports, and re-export sources', () => { + expect( + collectModuleInfoSnapshot(` + import defaultImport, { named as localNamed } from 'pkg' + import * as ns from 'pkg-ns' + const local = localNamed + export const exported = local + export function loader() {} + export default class DefaultRoute {} + export { remote as renamed } from './remote' + export * from './all' + `), + ).toMatchInlineSnapshot(` + { + "bindings": [ + [ + "DefaultRoute", + null, + ], + [ + "defaultImport", + "pkg:default", + ], + [ + "exported", + "Identifier", + ], + [ + "loader", + null, + ], + [ + "local", + "Identifier", + ], + [ + "localNamed", + "pkg:named", + ], + [ + "ns", + "pkg-ns:*", + ], + [ + "remote", + "./remote:remote", + ], + ], + "exports": [ + [ + "default", + "DefaultRoute", + ], + [ + "exported", + "exported", + ], + [ + "loader", + "loader", + ], + [ + "renamed", + "remote", + ], + ], + "reExportAllSources": [ + "./all", + ], + } + `) + }) +}) diff --git a/packages/router-utils/tests/stripTypeExports.test.ts b/packages/router-utils/tests/stripTypeExports.test.ts index 4a8f82ac3f..32d25f1cbe 100644 --- a/packages/router-utils/tests/stripTypeExports.test.ts +++ b/packages/router-utils/tests/stripTypeExports.test.ts @@ -11,6 +11,30 @@ function transform(code: string): string { } describe('stripTypeExports', () => { + describe('import attributes parsing', () => { + test('parses import attributes with with syntax', () => { + const code = `import data from './data.json' with { type: 'json' } +export const value = data` + + expect(() => parseAst({ code })).not.toThrow() + }) + + test('parses import attributes with deprecated assert syntax', () => { + const code = `import data from './data.json' assert { type: 'json' } +export const value = data` + + expect(() => parseAst({ code })).not.toThrow() + }) + + test('parses angle-bracket type assertions in .ts files without JSX', () => { + const code = `export function cast<T>(value: any): T { + return <T>value +}` + + expect(() => parseAst({ code, filename: 'cast.ts' })).not.toThrow() + }) + }) + describe('type alias declarations', () => { test('preserves top-level type alias declaration (non-exported)', () => { const code = `type Foo = string; @@ -99,7 +123,7 @@ type TypeOnly = string; export { value, type TypeOnly };` const result = transform(code) expect(result).toContain('export { value }') - expect(result).not.toContain('TypeOnly') + expect(result).toContain('type TypeOnly = string') }) test('removes entire export if all specifiers are type-only', () => { @@ -109,8 +133,8 @@ export { type Foo, type Bar }; export const value = 1;` const result = transform(code) expect(result).not.toContain('export { type Foo') - expect(result).not.toContain('Foo') - expect(result).not.toContain('Bar') + expect(result).toContain('type Foo = string') + expect(result).toContain('type Bar = number') expect(result).toContain('export const value = 1') }) }) @@ -209,9 +233,11 @@ export { helper, type HelperType };` expect(result).not.toContain('./types') expect(result).not.toContain('HelperType') - // Should remove type declarations - expect(result).not.toContain('type LocalType') - expect(result).not.toContain('interface LocalInterface') + // Should preserve local type declarations + expect(result).toContain('type LocalType = string') + expect(result).toContain('interface LocalInterface') + + // Should remove exported type declarations expect(result).not.toContain('type ExportedType') expect(result).not.toContain('interface ExportedInterface') diff --git a/packages/router-vite-plugin/CHANGELOG.md b/packages/router-vite-plugin/CHANGELOG.md index 652ff7d47b..f3206ed73a 100644 --- a/packages/router-vite-plugin/CHANGELOG.md +++ b/packages/router-vite-plugin/CHANGELOG.md @@ -1,5 +1,268 @@ # @tanstack/router-vite-plugin +## 1.167.13 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.168.13 + +## 1.167.12 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.168.12 + +## 1.167.11 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.168.11 + +## 1.167.10 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.168.10 + +## 1.167.9 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.168.9 + +## 1.167.8 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.168.8 + +## 1.167.7 + +### Patch Changes + +- Updated dependencies [[`c0f439c`](https://github.com/TanStack/router/commit/c0f439c59b04b7e49a0ab3aa2a0c550f522949e5), [`5fa9e55`](https://github.com/TanStack/router/commit/5fa9e555f3a2edb5e45586623e6bcbfa7f7c7a6b)]: + - @tanstack/router-plugin@1.168.7 + +## 1.167.6 + +### Patch Changes + +- Updated dependencies [[`b60eb36`](https://github.com/TanStack/router/commit/b60eb36e59e8a468ee0742cbcf7f47aca1ff1c67)]: + - @tanstack/router-plugin@1.168.6 + +## 1.167.5 + +### Patch Changes + +- Updated dependencies [[`8146db7`](https://github.com/TanStack/router/commit/8146db7e54f5d508f1fb7d3927edd0a2f71dc930)]: + - @tanstack/router-plugin@1.168.5 + +## 1.167.4 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.168.4 + +## 1.167.3 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.168.3 + +## 1.167.2 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.168.2 + +## 1.167.1 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.168.1 + +## 1.167.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- Updated dependencies [[`201e150`](https://github.com/TanStack/router/commit/201e150bd1412bae2faa9ce53f0fefcb7574ac14)]: + - @tanstack/router-plugin@1.168.0 + +## 1.166.50 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.167.35 + +## 1.166.49 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.167.34 + +## 1.166.48 + +### Patch Changes + +- Updated dependencies [[`056337e`](https://github.com/TanStack/router/commit/056337ef02ccbeaf45ec8533a227761be869e8f3)]: + - @tanstack/router-plugin@1.167.33 + +## 1.166.47 + +### Patch Changes + +- Updated dependencies [[`96818b8`](https://github.com/TanStack/router/commit/96818b8ba5ead6f1f027094841330182aff415b2)]: + - @tanstack/router-plugin@1.167.32 + +## 1.166.46 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.167.31 + +## 1.166.45 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.167.30 + +## 1.166.44 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.167.29 + +## 1.166.43 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.167.28 + +## 1.166.42 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.167.27 + +## 1.166.41 + +### Patch Changes + +- Updated dependencies [[`8b97002`](https://github.com/TanStack/router/commit/8b97002af3f6d15204e60c55d3f5735b78bd7efe)]: + - @tanstack/router-plugin@1.167.26 + +## 1.166.40 + +### Patch Changes + +- Updated dependencies [[`1e371b6`](https://github.com/TanStack/router/commit/1e371b60f1832c158ff4953a4ae6c5ccfe8460b3)]: + - @tanstack/router-plugin@1.167.25 + +## 1.166.39 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.167.24 + +## 1.166.38 + +### Patch Changes + +- Updated dependencies [[`91a7089`](https://github.com/TanStack/router/commit/91a708989d00537a21911e74ff60bbfec8266295)]: + - @tanstack/router-plugin@1.167.23 + +## 1.166.37 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.167.22 + +## 1.166.36 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.167.21 + +## 1.166.35 + +### Patch Changes + +- Updated dependencies [[`96ac2d8`](https://github.com/TanStack/router/commit/96ac2d8ed378340d63b88afeec3633e56e29b5f8)]: + - @tanstack/router-plugin@1.167.20 + +## 1.166.34 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.167.19 + +## 1.166.33 + +### Patch Changes + +- Updated dependencies [[`656a2a0`](https://github.com/TanStack/router/commit/656a2a040e79df7721d776e3751c8d634666570b)]: + - @tanstack/router-plugin@1.167.18 + +## 1.166.32 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.167.17 + +## 1.166.31 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.167.16 + +## 1.166.30 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/router-plugin@1.167.15 + +## 1.166.29 + +### Patch Changes + +- Updated dependencies [[`6355bb7`](https://github.com/TanStack/router/commit/6355bb75f7637ba77f06a923c18fdaf37720bb48)]: + - @tanstack/router-plugin@1.167.14 + +## 1.166.28 + +### Patch Changes + +- Updated dependencies [[`459057c`](https://github.com/TanStack/router/commit/459057cd2d90cff20d20e51d4964b0a8c950555e)]: + - @tanstack/router-plugin@1.167.13 + ## 1.166.27 ### Patch Changes diff --git a/packages/router-vite-plugin/package.json b/packages/router-vite-plugin/package.json index 6dcc4b986a..94e35f8a95 100644 --- a/packages/router-vite-plugin/package.json +++ b/packages/router-vite-plugin/package.json @@ -1,6 +1,6 @@ { "name": "@tanstack/router-vite-plugin", - "version": "1.166.27", + "version": "1.167.13", "description": "Modern and scalable routing for React applications", "author": "Tanner Linsley", "license": "MIT", diff --git a/packages/solid-router-devtools/CHANGELOG.md b/packages/solid-router-devtools/CHANGELOG.md index 454c0cf1dc..94bd6d05b5 100644 --- a/packages/solid-router-devtools/CHANGELOG.md +++ b/packages/solid-router-devtools/CHANGELOG.md @@ -185,3 +185,74 @@ - @tanstack/router-devtools-core@1.166.8 - @tanstack/solid-router@1.167.1 - @tanstack/router-core@1.167.1 + +## 1.167.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- Updated dependencies [[`b1c061a`](https://github.com/TanStack/router/commit/b1c061aff9185cdf5fdc08c0136382a9dce0302f), [`201e150`](https://github.com/TanStack/router/commit/201e150bd1412bae2faa9ce53f0fefcb7574ac14)]: + - @tanstack/router-core@1.170.0 + - @tanstack/router-devtools-core@1.168.0 + - @tanstack/solid-router@1.170.0 + +## 1.166.13 + +### Patch Changes + +- Updated dependencies [[`6355bb7`](https://github.com/TanStack/router/commit/6355bb75f7637ba77f06a923c18fdaf37720bb48)]: + - @tanstack/router-devtools-core@1.167.3 + - @tanstack/solid-router@1.168.14 + - @tanstack/router-core@1.168.11 + +## 1.166.12 + +### Patch Changes + +- Updated dependencies [[`459057c`](https://github.com/TanStack/router/commit/459057cd2d90cff20d20e51d4964b0a8c950555e)]: + - @tanstack/router-devtools-core@1.167.2 + - @tanstack/solid-router@1.168.13 + - @tanstack/router-core@1.168.10 + +## 1.166.11 + +### Patch Changes + +- Updated dependencies [[`c9e1855`](https://github.com/TanStack/router/commit/c9e18555f3a5531e96de8f574cfca9edcdb18e5c)]: + - @tanstack/router-devtools-core@1.167.1 + - @tanstack/solid-router@1.168.2 + - @tanstack/router-core@1.168.2 + +## 1.166.10 + +### Patch Changes + +- Updated dependencies [[`0545239`](https://github.com/TanStack/router/commit/054523900b2ee19308e5a88417dadfc6923afe30)]: + - @tanstack/router-devtools-core@1.167.0 + - @tanstack/solid-router@1.168.0 + - @tanstack/router-core@1.168.0 + +## 1.166.9 + +### Patch Changes + +- build: update to vite-config 5.x (rolldown) ([#6926](https://github.com/TanStack/router/pull/6926)) + +- Updated dependencies [[`838b0eb`](https://github.com/TanStack/router/commit/838b0eb9a8bbbb987a0a6972c1446e01423bbd7b)]: + - @tanstack/router-devtools-core@1.166.9 + - @tanstack/router-core@1.167.2 + - @tanstack/solid-router@1.167.2 + +## 1.166.8 + +### Patch Changes + +- fix: build with @tanstack/vite-config 0.4.3 ([#6923](https://github.com/TanStack/router/pull/6923)) + +- Updated dependencies [[`ef9b241`](https://github.com/TanStack/router/commit/ef9b241f3cfe95cee40daa96da669f0ffd4a971a)]: + - @tanstack/router-devtools-core@1.166.8 + - @tanstack/solid-router@1.167.1 + - @tanstack/router-core@1.167.1 diff --git a/packages/solid-router-ssr-query/CHANGELOG.md b/packages/solid-router-ssr-query/CHANGELOG.md index ef1e3c6a30..7ccecfea4c 100644 --- a/packages/solid-router-ssr-query/CHANGELOG.md +++ b/packages/solid-router-ssr-query/CHANGELOG.md @@ -158,3 +158,60 @@ - Updated dependencies [[`ef9b241`](https://github.com/TanStack/router/commit/ef9b241f3cfe95cee40daa96da669f0ffd4a971a)]: - @tanstack/router-ssr-query-core@1.166.8 + +## 1.167.1 + +### Patch Changes + +- Updated dependencies [[`d1997b6`](https://github.com/TanStack/router/commit/d1997b66d7c24c1d64772bb8bab5caf9c6d9cc48)]: + - @tanstack/router-ssr-query-core@1.169.1 + +## 1.167.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- Updated dependencies [[`201e150`](https://github.com/TanStack/router/commit/201e150bd1412bae2faa9ce53f0fefcb7574ac14)]: + - @tanstack/router-ssr-query-core@1.169.0 + +## 1.166.12 + +### Patch Changes + +- Updated dependencies [[`b12f57b`](https://github.com/TanStack/router/commit/b12f57bbb44e47d5452d46e9e67ea4d63cdb5b55)]: + - @tanstack/router-ssr-query-core@1.168.0 + +## 1.166.11 + +### Patch Changes + +- Updated dependencies [[`459057c`](https://github.com/TanStack/router/commit/459057cd2d90cff20d20e51d4964b0a8c950555e)]: + - @tanstack/router-ssr-query-core@1.167.1 + +## 1.166.10 + +### Patch Changes + +- Updated dependencies [[`0545239`](https://github.com/TanStack/router/commit/054523900b2ee19308e5a88417dadfc6923afe30)]: + - @tanstack/router-ssr-query-core@1.167.0 + +## 1.166.9 + +### Patch Changes + +- build: update to vite-config 5.x (rolldown) ([#6926](https://github.com/TanStack/router/pull/6926)) + +- Updated dependencies [[`838b0eb`](https://github.com/TanStack/router/commit/838b0eb9a8bbbb987a0a6972c1446e01423bbd7b)]: + - @tanstack/router-ssr-query-core@1.166.9 + +## 1.166.8 + +### Patch Changes + +- fix: build with @tanstack/vite-config 0.4.3 ([#6923](https://github.com/TanStack/router/pull/6923)) + +- Updated dependencies [[`ef9b241`](https://github.com/TanStack/router/commit/ef9b241f3cfe95cee40daa96da669f0ffd4a971a)]: + - @tanstack/router-ssr-query-core@1.166.8 diff --git a/packages/solid-router/CHANGELOG.md b/packages/solid-router/CHANGELOG.md index 8c35b29911..995988312d 100644 --- a/packages/solid-router/CHANGELOG.md +++ b/packages/solid-router/CHANGELOG.md @@ -257,3 +257,379 @@ - Updated dependencies [[`6f297a2`](https://github.com/TanStack/router/commit/6f297a249424c0fd1c1a56aa4fc12c8217be7b6a)]: - @tanstack/router-core@1.167.0 + +## 1.170.10 + +### Patch Changes + +- Updated dependencies [[`2f53749`](https://github.com/TanStack/router/commit/2f5374945e2138559a51464f45a5152eae67e1dd)]: + - @tanstack/router-core@1.171.8 + +## 1.170.9 + +### Patch Changes + +- [#7497](https://github.com/TanStack/router/pull/7497) [`d1997b6`](https://github.com/TanStack/router/commit/d1997b66d7c24c1d64772bb8bab5caf9c6d9cc48) - fix streaming + +- Updated dependencies [[`d1997b6`](https://github.com/TanStack/router/commit/d1997b66d7c24c1d64772bb8bab5caf9c6d9cc48)]: + - @tanstack/router-core@1.171.7 + +## 1.170.8 + +### Patch Changes + +- Add support for Rsbuild client output formats, including module output by default and IIFE output for classic script environments. ([#7477](https://github.com/TanStack/router/pull/7477)) + + Client entry scripts and preloads are now represented as root route manifest assets, script preloads follow the manifest script format, and script asset cross-origin configuration uses the `script` key. The `transformAssets` script callback context now exposes only `kind: 'script'` and `url`, keeping script format handling internal to manifest rendering. + +- Updated dependencies [[`51a97a1`](https://github.com/TanStack/router/commit/51a97a167fb3ef1b8ca70fbb63db635158f43509)]: + - @tanstack/router-core@1.171.6 + +## 1.170.7 + +### Patch Changes + +- Updated dependencies [[`5268ba4`](https://github.com/TanStack/router/commit/5268ba4566233ea58880df85f167ad0401a93a46)]: + - @tanstack/router-core@1.171.5 + +## 1.170.6 + +### Patch Changes + +- Fix hash navigation being overridden by stale scroll restoration entries. ([#7447](https://github.com/TanStack/router/pull/7447)) + +- Updated dependencies [[`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960), [`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960)]: + - @tanstack/router-core@1.171.4 + +## 1.170.5 + +### Patch Changes + +- Updated dependencies [[`5fa9e55`](https://github.com/TanStack/router/commit/5fa9e555f3a2edb5e45586623e6bcbfa7f7c7a6b)]: + - @tanstack/router-core@1.171.3 + +## 1.170.4 + +### Patch Changes + +- Updated dependencies [[`b60eb36`](https://github.com/TanStack/router/commit/b60eb36e59e8a468ee0742cbcf7f47aca1ff1c67)]: + - @tanstack/router-core@1.171.2 + +## 1.170.3 + +### Patch Changes + +- Updated dependencies [[`d9cf933`](https://github.com/TanStack/router/commit/d9cf9331b83fcbd2abfee75d839d862f9bb18e6b)]: + - @tanstack/router-core@1.171.1 + +## 1.170.2 + +### Patch Changes + +- Updated dependencies [[`d533f87`](https://github.com/TanStack/router/commit/d533f87976704098a40b48f160b37c28c8182806)]: + - @tanstack/router-core@1.171.0 + +## 1.170.1 + +### Patch Changes + +- Updated dependencies [[`2387a2e`](https://github.com/TanStack/router/commit/2387a2eea0683004cc400b9f71bed5944eb60110)]: + - @tanstack/router-core@1.170.1 + +## 1.170.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- Updated dependencies [[`b1c061a`](https://github.com/TanStack/router/commit/b1c061aff9185cdf5fdc08c0136382a9dce0302f), [`201e150`](https://github.com/TanStack/router/commit/201e150bd1412bae2faa9ce53f0fefcb7574ac14)]: + - @tanstack/router-core@1.170.0 + - @tanstack/history@1.162.0 + +## 1.169.2 + +### Patch Changes + +- Updated dependencies [[`35e88f0`](https://github.com/TanStack/router/commit/35e88f04996d71019a1868b7b06ecb4ddbc9df9e)]: + - @tanstack/router-core@1.169.2 + +## 1.169.1 + +### Patch Changes + +- Updated dependencies [[`4a1e63f`](https://github.com/TanStack/router/commit/4a1e63f1d1230b1ed8234609acad4639d8982c13)]: + - @tanstack/router-core@1.169.1 + +## 1.169.0 + +### Minor Changes + +- Allow `params.parse` to experimentally return `false` to skip an incoming route candidate during path matching. Thrown parse errors still surface on the selected match instead of falling through, and outgoing typed route-template links continue to use exact route lookup followed by `params.stringify` for URL generation. ([#7263](https://github.com/TanStack/router/pull/7263)) + +### Patch Changes + +- Updated dependencies [[`c992495`](https://github.com/TanStack/router/commit/c992495bf4010ff4c3597bb1f3b1ba02594e857e)]: + - @tanstack/router-core@1.169.0 + +## 1.168.26 + +### Patch Changes + +- Updated dependencies [[`b5c4183`](https://github.com/TanStack/router/commit/b5c4183ab8b44be8a75647b7f7b588ad7c146ece)]: + - @tanstack/router-core@1.168.18 + +## 1.168.25 + +### Patch Changes + +- Updated dependencies [[`493148b`](https://github.com/TanStack/router/commit/493148bc5378b7f9de1544d87f6aaa425c12eb34)]: + - @tanstack/router-core@1.168.17 + +## 1.168.24 + +### Patch Changes + +- Fix hydration mismatch for ssr='data-only' with pendingComponent ([#7266](https://github.com/TanStack/router/pull/7266)) + +## 1.168.23 + +### Patch Changes + +- Fix for useLoaderData sometimes going undefined ([#7265](https://github.com/TanStack/router/pull/7265)) + +- Fix streaming when using Await component ([#7264](https://github.com/TanStack/router/pull/7264)) + +## 1.168.22 + +### Patch Changes + +- fix server middleware type in solid-router ([#7260](https://github.com/TanStack/router/pull/7260)) + +- Enhanced internal tag comparison logic to optimize stylesheet persistence during route navigation. ([#7250](https://github.com/TanStack/router/pull/7250)) + +## 1.168.21 + +### Patch Changes + +- Add TanStack Start inline CSS manifest support for SSR so route styles can be embedded in the HTML response and hydrated without duplicate stylesheet links. ([#7253](https://github.com/TanStack/router/pull/7253)) + +- Updated dependencies [[`4d864ee`](https://github.com/TanStack/router/commit/4d864eebbd184265eabb563d326ab409c93feb17)]: + - @tanstack/router-core@1.168.16 + +## 1.168.20 + +### Patch Changes + +- fix: use keyed Show in Outlet to fix child route rendering with useQuery ([#7204](https://github.com/TanStack/router/pull/7204)) + +## 1.168.19 + +### Patch Changes + +- Updated dependencies [[`16f6892`](https://github.com/TanStack/router/commit/16f6892d6b7ceadf606677c5a40e743f29163aa6)]: + - @tanstack/router-core@1.168.15 + +## 1.168.18 + +### Patch Changes + +- Fix route file transforms to preserve route ID quoting, handle more exported `Route` patterns, and avoid incorrect import rewrites in edge cases. ([#7167](https://github.com/TanStack/router/pull/7167)) + + Improve transform robustness with clearer route-call detection, safer import removal, and expanded test coverage for quote preservation, constructor swaps, and unsupported route definitions. + +## 1.168.17 + +### Patch Changes + +- Updated dependencies [[`0e2c900`](https://github.com/TanStack/router/commit/0e2c9003c18ae07c09969189c028f277ea562a7a)]: + - @tanstack/router-core@1.168.14 + +## 1.168.16 + +### Patch Changes + +- Updated dependencies [[`812792f`](https://github.com/TanStack/router/commit/812792fbda3caf97b300770855cf5641252f413b)]: + - @tanstack/router-core@1.168.13 + +## 1.168.15 + +### Patch Changes + +- Updated dependencies [[`8ec9ca9`](https://github.com/TanStack/router/commit/8ec9ca97b472779de878c2a6510f21deb24d386c)]: + - @tanstack/router-core@1.168.12 + +## 1.168.14 + +### Patch Changes + +- shorten internal non-minifiable store names for byte shaving ([#7152](https://github.com/TanStack/router/pull/7152)) + +- Updated dependencies [[`6355bb7`](https://github.com/TanStack/router/commit/6355bb75f7637ba77f06a923c18fdaf37720bb48)]: + - @tanstack/router-core@1.168.11 + +## 1.168.13 + +### Patch Changes + +- migrate createStore > createAtom for simpler API ([#7150](https://github.com/TanStack/router/pull/7150)) + +- Updated dependencies [[`459057c`](https://github.com/TanStack/router/commit/459057cd2d90cff20d20e51d4964b0a8c950555e)]: + - @tanstack/router-core@1.168.10 + +## 1.168.12 + +### Patch Changes + +- Fix `MatchRoute` child callback param inference to resolve params from the target `to` route instead of the route path key across React, Solid, and Vue adapters. ([#7139](https://github.com/TanStack/router/pull/7139)) + +## 1.168.11 + +### Patch Changes + +- Fix redirected pending route transitions so lazy target routes can finish loading without stale redirected matches causing render errors. ([#7137](https://github.com/TanStack/router/pull/7137)) + +## 1.168.10 + +### Patch Changes + +- Fix `Link` to keep internal routing props like `preloadIntentProximity`, `from`, and `unsafeRelative` from leaking to rendered DOM elements across React, Solid, and Vue. ([#7138](https://github.com/TanStack/router/pull/7138)) + +## 1.168.9 + +### Patch Changes + +- Preserve component-thrown `notFound()` errors through framework error boundaries so route `notFoundComponent` handlers render without requiring an explicit `routeId`. ([#7077](https://github.com/TanStack/router/pull/7077)) + +- Updated dependencies [[`796406d`](https://github.com/TanStack/router/commit/796406da66cfb12b518bb3ca326c9d541368fb06)]: + - @tanstack/router-core@1.168.9 + +## 1.168.8 + +### Patch Changes + +- Updated dependencies [[`2d1ec86`](https://github.com/TanStack/router/commit/2d1ec865a446926f7db6e29dbbde82d265de6d36)]: + - @tanstack/router-core@1.168.8 + +## 1.168.7 + +### Patch Changes + +- Updated dependencies [[`6ee0e79`](https://github.com/TanStack/router/commit/6ee0e795b085651beb2f1ac6503cdbd7eaffedd1)]: + - @tanstack/router-core@1.168.7 + +## 1.168.6 + +### Patch Changes + +- Updated dependencies [[`42c3f3b`](https://github.com/TanStack/router/commit/42c3f3b3a3a478fd6d6894310ef94b2d23794b8e)]: + - @tanstack/router-core@1.168.6 + +## 1.168.5 + +### Patch Changes + +- fix: scroll restoration without throttling ([#7042](https://github.com/TanStack/router/pull/7042)) + +- Updated dependencies [[`cf5f554`](https://github.com/TanStack/router/commit/cf5f5542476137a81515099ad740747e84512f9a)]: + - @tanstack/router-core@1.168.5 + +## 1.168.4 + +### Patch Changes + +- Updated dependencies [[`71a8b68`](https://github.com/TanStack/router/commit/71a8b684c87c37fd4a033d99f5ba4a05c7a179f5)]: + - @tanstack/router-core@1.168.4 + +## 1.168.3 + +### Patch Changes + +- feat: transformAssets ([#7023](https://github.com/TanStack/router/pull/7023)) + +- Updated dependencies [[`d81d21a`](https://github.com/TanStack/router/commit/d81d21ad05c9401bf54b24acd29401e1e4fd624c)]: + - @tanstack/router-core@1.168.3 + +## 1.168.2 + +### Patch Changes + +- Replace tiny-invariant and tiny-warning with in-house solution for bundle-size ([#7007](https://github.com/TanStack/router/pull/7007)) + +- Updated dependencies [[`c9e1855`](https://github.com/TanStack/router/commit/c9e18555f3a5531e96de8f574cfca9edcdb18e5c)]: + - @tanstack/router-core@1.168.2 + +## 1.168.1 + +### Patch Changes + +- Updated dependencies [[`91cc628`](https://github.com/TanStack/router/commit/91cc62899b75ca920fe83c5ee7f3dbb5c71a523f)]: + - @tanstack/router-core@1.168.1 + +## 1.168.0 + +### Minor Changes + +- remove pendingMatches, cachedMatches ([#6704](https://github.com/TanStack/router/pull/6704)) + move to signal-based reactivity + solid uses its own native signals + +### Patch Changes + +- Updated dependencies [[`0545239`](https://github.com/TanStack/router/commit/054523900b2ee19308e5a88417dadfc6923afe30)]: + - @tanstack/router-core@1.168.0 + +## 1.167.5 + +### Patch Changes + +- Updated dependencies [[`5ff4f0b`](https://github.com/TanStack/router/commit/5ff4f0b8dce1fac2bb0b0bfe2684fc677a8ee505)]: + - @tanstack/router-core@1.167.5 + +## 1.167.4 + +### Patch Changes + +- Add @tanstack/intent AI agent skills and CLI entry points for Router and Start packages ([#6866](https://github.com/TanStack/router/pull/6866)) + +- Updated dependencies [[`940151c`](https://github.com/TanStack/router/commit/940151cbed0c76c92a5cf196c0905b17a956ca7e)]: + - @tanstack/router-core@1.167.4 + +## 1.167.3 + +### Patch Changes + +- Updated dependencies [[`32fcba7`](https://github.com/TanStack/router/commit/32fcba7b044b03f5901308b870f70b0b4910c220)]: + - @tanstack/router-core@1.167.3 + +## 1.167.2 + +### Patch Changes + +- build: update to vite-config 5.x (rolldown) ([#6926](https://github.com/TanStack/router/pull/6926)) + +- Updated dependencies [[`838b0eb`](https://github.com/TanStack/router/commit/838b0eb9a8bbbb987a0a6972c1446e01423bbd7b)]: + - @tanstack/history@1.161.6 + - @tanstack/router-core@1.167.2 + +## 1.167.1 + +### Patch Changes + +- fix: build with @tanstack/vite-config 0.4.3 ([#6923](https://github.com/TanStack/router/pull/6923)) + +- Updated dependencies [[`ef9b241`](https://github.com/TanStack/router/commit/ef9b241f3cfe95cee40daa96da669f0ffd4a971a)]: + - @tanstack/router-core@1.167.1 + - @tanstack/history@1.161.5 + +## 1.167.0 + +### Minor Changes + +- feat: add staleReloadMode ([#6921](https://github.com/TanStack/router/pull/6921)) + +### Patch Changes + +- Updated dependencies [[`6f297a2`](https://github.com/TanStack/router/commit/6f297a249424c0fd1c1a56aa4fc12c8217be7b6a)]: + - @tanstack/router-core@1.167.0 diff --git a/packages/solid-router/bin/intent.js b/packages/solid-router/bin/intent.js deleted file mode 100755 index 5b08532885..0000000000 --- a/packages/solid-router/bin/intent.js +++ /dev/null @@ -1,25 +0,0 @@ -#!/usr/bin/env node -// Auto-generated by @tanstack/intent setup -// Exposes the intent end-user CLI for consumers of this library. -// Commit this file, then add to your package.json: -// "bin": { "intent": "./bin/intent.js" } -try { - await import('@tanstack/intent/intent-library') -} catch (e) { - const isModuleNotFound = - e?.code === 'ERR_MODULE_NOT_FOUND' || e?.code === 'MODULE_NOT_FOUND' - const missingIntentLibrary = - typeof e?.message === 'string' && e.message.includes('@tanstack/intent') - - if (isModuleNotFound && missingIntentLibrary) { - console.error('@tanstack/intent is not installed.') - console.error('') - console.error('Install it as a dev dependency:') - console.error(' npm add -D @tanstack/intent') - console.error('') - console.error('Or run directly:') - console.error(' npx @tanstack/intent@latest list') - process.exit(1) - } - throw e -} diff --git a/packages/solid-router/package.json b/packages/solid-router/package.json index 3284009eab..f29c2777ad 100644 --- a/packages/solid-router/package.json +++ b/packages/solid-router/package.json @@ -109,12 +109,12 @@ "@solidjs/web": "2.0.0-beta.14", "@tanstack/history": "workspace:*", "@tanstack/router-core": "workspace:*", - "isbot": "^5.1.22" + "isbot": "^5.1.22", + "@solid-primitives/refs": "^1.0.8" }, "devDependencies": { "@solidjs/testing-library": "^0.8.10", "@solidjs/web": "2.0.0-beta.14", - "@tanstack/intent": "^0.0.14", "@testing-library/jest-dom": "^6.6.3", "@types/node": ">=20", "combinate": "^1.1.11", @@ -122,13 +122,10 @@ "solid-js": "2.0.0-beta.14", "vite": "*", "vite-plugin-solid": "^3.0.0-next.5", - "zod": "^3.23.8" + "zod": "^4.4.3" }, "peerDependencies": { "@solidjs/web": ">=2.0.0-0 <3.0.0", "solid-js": ">=2.0.0-0 <3.0.0" - }, - "bin": { - "intent": "./bin/intent.js" } } diff --git a/packages/solid-router/src/Asset.tsx b/packages/solid-router/src/Asset.tsx index 34d531e367..bd63c8d75e 100644 --- a/packages/solid-router/src/Asset.tsx +++ b/packages/solid-router/src/Asset.tsx @@ -4,11 +4,11 @@ import { useRouter } from './useRouter' import type { RouterManagedTag } from '@tanstack/router-core' import type { JSX } from '@solidjs/web' -export function Asset({ - tag, - attrs, - children, -}: RouterManagedTag): JSX.Element | null { +const INLINE_CSS_HYDRATION_ATTR = 'data-tsr-inline-css' + +export function Asset(asset: RouterManagedTag): JSX.Element | null { + const { tag, attrs, children } = asset + switch (tag) { case 'title': return <Title attrs={attrs} children={children} /> @@ -17,6 +17,14 @@ export function Asset({ case 'link': return <HeadElement tag="link" attrs={attrs} /> case 'style': + if ( + asset.inlineCss && + (process.env.TSS_INLINE_CSS_ENABLED === 'true' || + (process.env.TSS_INLINE_CSS_ENABLED === undefined && isServer)) + ) { + return <InlineCssStyle attrs={attrs}>{children}</InlineCssStyle> + } + return <HeadElement tag="style" attrs={attrs} children={children} /> case 'script': return <Script attrs={attrs} children={children} /> @@ -50,6 +58,36 @@ function useRelocateToHead(getEl: () => Node | undefined) { }) } +function InlineCssStyle({ + attrs, + children, +}: { + attrs?: Record<string, any> + children?: RouterManagedTag['children'] +}) { + const isInlineCssPlaceholder = children === undefined + const html = isInlineCssPlaceholder + ? typeof document === 'undefined' + ? '' + : (document.querySelector<HTMLStyleElement>( + `style[${INLINE_CSS_HYDRATION_ATTR}]`, + )?.textContent ?? '') + : (children ?? '') + + return ( + <HeadElement + tag="style" + attrs={{ ...attrs, [INLINE_CSS_HYDRATION_ATTR]: '' }} + children={html} + /> + ) +} + +interface ScriptAttrs { + [key: string]: string | boolean | undefined + src?: string +} + function HeadElement(props: { tag: 'meta' | 'link' | 'style' attrs?: Record<string, any> diff --git a/packages/solid-router/src/ClientOnly.tsx b/packages/solid-router/src/ClientOnly.tsx index ea0284cd1f..8de6d3709b 100644 --- a/packages/solid-router/src/ClientOnly.tsx +++ b/packages/solid-router/src/ClientOnly.tsx @@ -57,12 +57,15 @@ export function ClientOnly(props: ClientOnlyProps) { * ``` * @returns True if the JS has been hydrated already, false otherwise. */ +let globalHydrated = false + export function useHydrated(): Solid.Accessor<boolean> { - const [hydrated, setHydrated] = Solid.createSignal(false) + const [hydrated, setHydrated] = Solid.createSignal(globalHydrated) Solid.createEffect( () => true, () => { + globalHydrated = true setHydrated(true) }, ) diff --git a/packages/solid-router/src/HeadContent.dev.tsx b/packages/solid-router/src/HeadContent.dev.tsx index 1df63c24dc..7c002fd20f 100644 --- a/packages/solid-router/src/HeadContent.dev.tsx +++ b/packages/solid-router/src/HeadContent.dev.tsx @@ -1,12 +1,11 @@ import { For, createEffect, createMemo } from 'solid-js' import { HydrationScript } from '@solidjs/web' +import { DEV_STYLES_ATTR } from '@tanstack/router-core' import { Asset } from './Asset' import { useHydrated } from './ClientOnly' import { useTags } from './headContentUtils' import type { HeadContentProps } from './HeadContent' -const DEV_STYLES_ATTR = 'data-tanstack-router-dev-styles' - /** * @description The `HeadContent` component is used to render meta tags, links, and scripts for the current route. * @@ -33,7 +32,9 @@ export function HeadContent(props: HeadContentProps) { // Filter out dev styles after hydration const filteredTags = createMemo(() => { if (hydrated()) { - return tags().filter((tag) => !tag.attrs?.[DEV_STYLES_ATTR]) + return tags().filter( + (tag) => tag.tag !== 'link' || tag.attrs?.[DEV_STYLES_ATTR] !== true, + ) } return tags() }) diff --git a/packages/solid-router/src/Match.tsx b/packages/solid-router/src/Match.tsx index a66a775411..c0b8dcc658 100644 --- a/packages/solid-router/src/Match.tsx +++ b/packages/solid-router/src/Match.tsx @@ -29,7 +29,7 @@ export const Match = (props: { matchId: string }) => { const match = Solid.createMemo(() => { const id = props.matchId if (!id) return undefined - return router.stores.activeMatchStoresById.get(id)?.state + return router.stores.matchStores.get(id)?.get() }) const rawMatchState = Solid.createMemo(() => { @@ -54,7 +54,7 @@ export const Match = (props: { matchId: string }) => { const hasPendingMatch = Solid.createMemo(() => { const currentRouteId = rawMatchState()?.routeId return currentRouteId - ? Boolean(router.stores.pendingRouteIds.state[currentRouteId]) + ? Boolean(router.stores.pendingRouteIds.get()[currentRouteId]) : false }) const nearestMatch = { @@ -104,6 +104,11 @@ export const Match = (props: { matchId: string }) => { const ResolvedSuspenseBoundary = Solid.createMemo(() => resolvedNoSsr() ? SafeFragment : Solid.Loading, ) + const shouldSkipSuspenseFallback = Solid.createMemo(() => + (isServer ?? router.isServer) + ? resolvedNoSsr() + : currentMatchState().ssr === 'data-only', + ) const ResolvedCatchBoundary = Solid.createMemo(() => routeErrorComponent() ? CatchBoundary : SafeFragment, @@ -126,16 +131,16 @@ export const Match = (props: { matchId: string }) => { <Dynamic component={ResolvedSuspenseBoundary()} fallback={ - // Don't show fallback on server when using no-ssr mode to avoid hydration mismatch - (isServer ?? router.isServer) && - resolvedNoSsr() ? undefined : ( + // Data-only SSR renders the inner fallback on the server, so + // avoid adding an extra suspense fallback on the client. + shouldSkipSuspenseFallback() ? undefined : ( <Dynamic component={resolvePendingComponent()} /> ) } > <Dynamic component={ResolvedCatchBoundary()} - getResetKey={() => router.stores.loadedAt.state} + getResetKey={() => router.stores.loadedAt.get()} errorComponent={routeErrorComponent() || ErrorComponent} onCatch={(error: Error) => { // Forward not found errors (we don't want to show the error component for these) @@ -235,14 +240,15 @@ function OnRendered() { const router = useRouter() const location = Solid.createMemo( - () => router.stores.resolvedLocation.state?.state.__TSR_key, - ) - const locationState = Solid.createMemo(() => router.stores.location.state) - const resolvedLocationState = Solid.createMemo( - () => router.stores.resolvedLocation.state, + () => router.stores.resolvedLocation.get()?.state.__TSR_key, ) Solid.createEffect( - () => [location(), locationState(), resolvedLocationState()] as const, + () => + [ + location(), + router.stores.location.get(), + router.stores.resolvedLocation.get(), + ] as const, ([location, currentLocationState, currentResolvedLocationState]) => { if (!location) return if (lastOnRenderedKey.get(router) === location) return @@ -319,6 +325,22 @@ export const MatchInner = (): any => { const RenderOut = () => <Dynamic component={OutComponent()} /> + const getLoadPromise = ( + matchId: string, + fallbackMatch: + | { + _nonReactive: { + loadPromise?: Promise<void> + } + } + | undefined, + ) => { + return ( + router.getMatch(matchId)?._nonReactive.loadPromise ?? + fallbackMatch?._nonReactive.loadPromise + ) + } + const keyedOut = () => ( <Solid.Show when={componentKey()} keyed> {(_key) => <RenderOut />} @@ -429,8 +451,7 @@ export const MatchInner = (): any => { </Solid.Match> <Solid.Match when={currentMatch().status === 'redirected'}> {(_) => { - const matchError = Solid.untrack(() => currentMatch().error) - if (!isRedirect(matchError)) { + if (!isRedirect(currentMatch().error)) { if (process.env.NODE_ENV !== 'production') { throw new Error( 'Invariant failed: Expected a redirect error', @@ -490,14 +511,14 @@ export const Outlet = () => { const childMatchId = Solid.createMemo(() => { const currentRouteId = routeId() return currentRouteId - ? router.stores.childMatchIdByRouteId.state[currentRouteId] + ? router.stores.childMatchIdByRouteId.get()[currentRouteId] : undefined }) const childRouteId = Solid.createMemo(() => { const id = childMatchId() if (!id) return undefined - return router.stores.activeMatchStoresById.get(id)?.state.routeId + return router.stores.matchStores.get(id)?.routeId }) const childRoute = Solid.createMemo(() => { @@ -514,16 +535,23 @@ export const Outlet = () => { const childMatchStatus = Solid.createMemo(() => { const id = childMatchId() if (!id) return undefined - return router.stores.activeMatchStoresById.get(id)?.state.status + return router.stores.matchStores.get(id)?.get().status }) - // Only show not-found if we're not in a redirected state const shouldShowNotFound = () => childMatchStatus() !== 'redirected' && parentGlobalNotFound() + const childRouteKey = Solid.createMemo(() => { + if (shouldShowNotFound()) return undefined + const cid = childMatchId() + if (!cid) return undefined + return router.stores.matchStores.get(cid)?.routeId ?? cid + }) + return ( <Solid.Show - when={!shouldShowNotFound() && childMatchId()} + when={childRouteKey()} + keyed fallback={ <Solid.Show when={shouldShowNotFound() && route()}> {(resolvedRoute) => @@ -534,13 +562,13 @@ export const Outlet = () => { </Solid.Show> } > - {(childMatchIdAccessor) => { - const currentMatchId = Solid.createMemo(() => childMatchIdAccessor()) + {(_routeKey) => { + const currentMatchId = Solid.createMemo(() => childMatchId()) return ( <Solid.Show when={routeId() === rootRouteId} - fallback={<Match matchId={currentMatchId()} />} + fallback={<Match matchId={currentMatchId()!} />} > <Solid.Show when={childRouteId()} keyed> {(_routeId) => ( @@ -551,7 +579,7 @@ export const Outlet = () => { ) : null } > - <Match matchId={currentMatchId()} /> + <Match matchId={currentMatchId()!} /> </Solid.Loading> )} </Solid.Show> diff --git a/packages/solid-router/src/Matches.tsx b/packages/solid-router/src/Matches.tsx index 5fee298375..0becb206ab 100644 --- a/packages/solid-router/src/Matches.tsx +++ b/packages/solid-router/src/Matches.tsx @@ -17,11 +17,8 @@ import type { MakeRouteMatchUnion, MaskOptions, MatchRouteOptions, - NoInfer, RegisteredRouter, - ResolveRelativePath, ResolveRoute, - RouteByPath, ToSubOptionsProps, } from '@tanstack/router-core' import type { JSX } from '@solidjs/web' @@ -75,17 +72,15 @@ export function Matches() { function MatchesInner() { const router = useRouter() - const matchId = () => router.stores.firstMatchId.state + const matchId = () => router.stores.firstId.get() const routeId = () => (matchId() ? rootRouteId : undefined) const match = () => - routeId() - ? router.stores.getMatchStoreByRouteId(rootRouteId).state - : undefined + routeId() ? router.stores.getRouteMatchStore(rootRouteId).get() : undefined const hasPendingMatch = () => routeId() - ? Boolean(router.stores.pendingRouteIds.state[rootRouteId]) + ? Boolean(router.stores.pendingRouteIds.get()[rootRouteId]) : false - const resetKey = () => router.stores.loadedAt.state + const resetKey = () => router.stores.loadedAt.get() const nearestMatch = { matchId, routeId, @@ -159,7 +154,7 @@ export function useMatchRoute<TRouter extends AnyRouter = RegisteredRouter>() { return Solid.createMemo(() => { const { pending, caseSensitive, fuzzy, includeSearch, ...rest } = opts - router.stores.matchRouteReactivity.state + router.stores.matchRouteDeps.get() return router.matchRoute(rest as any, { pending, caseSensitive, @@ -180,10 +175,9 @@ export type MakeMatchRouteOptions< // If a function is passed as a child, it will be given the `isActive` boolean to aid in further styling on the element it returns children?: | (( - params?: RouteByPath< - TRouter['routeTree'], - ResolveRelativePath<TFrom, NoInfer<TTo>> - >['types']['allParams'], + params?: Expand< + ResolveRoute<TRouter, TFrom, TTo>['types']['allParams'] + >, ) => JSX.Element) | JSX.Element } @@ -229,7 +223,7 @@ export function useMatches< ): Solid.Accessor<UseMatchesResult<TRouter, TSelected>> { const router = useRouter<TRouter>() return Solid.createMemo((prev: TSelected | undefined) => { - const matches = router.stores.activeMatchesSnapshot.state as Array< + const matches = router.stores.matches.get() as Array< MakeRouteMatchUnion<TRouter> > const res = opts?.select ? opts.select(matches) : matches diff --git a/packages/solid-router/src/Scripts.tsx b/packages/solid-router/src/Scripts.tsx index d646f3f167..126fb313e4 100644 --- a/packages/solid-router/src/Scripts.tsx +++ b/packages/solid-router/src/Scripts.tsx @@ -1,16 +1,15 @@ -import { NoHydration } from '@solidjs/web' import * as Solid from 'solid-js' +import { NoHydration } from '@solidjs/web' +import { isServer } from '@tanstack/router-core/isServer' import { Asset } from './Asset' import { useRouter } from './useRouter' -import type { RouterManagedTag } from '@tanstack/router-core' +import type { AnyRouteMatch, RouterManagedTag } from '@tanstack/router-core' export const Scripts = () => { const router = useRouter() const nonce = router.options.ssr?.nonce - const activeMatches = Solid.createMemo( - () => router.stores.activeMatchesSnapshot.state, - ) - const assetScripts = Solid.createMemo(() => { + + const getAssetScripts = (matches: Array<AnyRouteMatch>) => { const assetScripts: Array<RouterManagedTag> = [] const manifest = router.ssr?.manifest @@ -18,60 +17,69 @@ export const Scripts = () => { return [] } - activeMatches() - .map((match) => router.looseRoutesById[match.routeId]!) - .forEach((route) => - manifest.routes[route.id]?.assets - ?.filter((d) => d.tag === 'script') - .forEach((asset) => { - assetScripts.push({ - tag: 'script', - attrs: { ...asset.attrs, nonce }, - children: asset.children, - } as any) - }), - ) + for (const match of matches) { + const scripts = manifest.routes[match.routeId]?.scripts + + if (!scripts) { + continue + } + + for (const asset of scripts) { + assetScripts.push({ + tag: 'script', + attrs: { ...asset.attrs, nonce }, + children: asset.children, + }) + } + } return assetScripts - }) + } - const scripts = Solid.createMemo(() => + const getScripts = (matches: Array<AnyRouteMatch>): Array<RouterManagedTag> => ( - activeMatches() + matches .map((match) => match.scripts!) .flat(1) .filter(Boolean) as Array<RouterManagedTag> - ).map(({ children, ...script }) => ({ - tag: 'script', - attrs: { - ...script, - nonce, - }, - children, - })), - ) + ).map( + ({ children, ...script }) => + ({ + tag: 'script', + attrs: { + ...script, + nonce, + }, + children, + }) satisfies RouterManagedTag, + ) - const serverBufferedScript: RouterManagedTag | undefined = router.serverSsr - ? router.serverSsr.takeBufferedScripts() - : undefined + const activeMatches = Solid.createMemo(() => router.stores.matches.get()) + const assetScripts = Solid.createMemo(() => getAssetScripts(activeMatches())) + const scripts = Solid.createMemo(() => getScripts(activeMatches())) - const allScripts = Solid.createMemo(() => { - const result = [...scripts(), ...assetScripts()] as Array<RouterManagedTag> + return renderScripts(router, scripts(), assetScripts()) +} +function renderScripts( + router: ReturnType<typeof useRouter>, + scripts: Array<RouterManagedTag>, + assetScripts: Array<RouterManagedTag>, +) { + const allScripts = [...scripts, ...assetScripts] as Array<RouterManagedTag> + + if ((isServer ?? router.isServer) && router.serverSsr) { + const serverBufferedScript = router.serverSsr.takeBufferedScripts() if (serverBufferedScript) { - result.unshift(serverBufferedScript) + allScripts.unshift(serverBufferedScript) } - - return result - }) + } return ( <NoHydration> - <Solid.For each={allScripts()}> - {(asset) => { - return <Asset {...asset} /> - }} - </Solid.For> + {allScripts.map((asset) => ( + <Asset {...asset} /> + ))} </NoHydration> ) } diff --git a/packages/solid-router/src/Transitioner.tsx b/packages/solid-router/src/Transitioner.tsx index cb91fa5ad1..bbb78d514b 100644 --- a/packages/solid-router/src/Transitioner.tsx +++ b/packages/solid-router/src/Transitioner.tsx @@ -25,22 +25,18 @@ function handleHashScrollWithLocation(_router: any, location: ParsedLocation) { export function Transitioner() { const router = useRouter() let mountLoadForRouter = { router, mounted: false } - const isLoading = Solid.createMemo(() => router.stores.isLoading.state) + const isLoading = Solid.createMemo(() => router.stores.isLoading.get()) const [isSolidTransitioning] = [() => false] // Track pending state changes - const hasPendingMatches = Solid.createMemo( - () => router.stores.hasPendingMatches.state, - ) + const hasPending = Solid.createMemo(() => router.stores.hasPending.get()) const isAnyPending = Solid.createMemo( - () => isLoading() || isSolidTransitioning() || hasPendingMatches(), + () => isLoading() || isSolidTransitioning() || hasPending(), ) - const isPagePending = Solid.createMemo( - () => isLoading() || hasPendingMatches(), - ) + const isPagePending = Solid.createMemo(() => isLoading() || hasPending()) router.startTransition = (fn: () => void | Promise<void>) => { Solid.runWithOwner(null, fn) @@ -114,14 +110,15 @@ export function Transitioner() { tryLoad() }) }) + Solid.createRenderEffect( () => [ isLoading(), isPagePending(), isAnyPending(), - router.stores.location.state, - router.stores.resolvedLocation.state, + router.stores.location.get(), + router.stores.resolvedLocation.get(), ] as const, ( [ @@ -166,17 +163,17 @@ export function Transitioner() { Solid.runWithOwner(null, () => { router.batch(() => { - router.stores.status.setState(() => 'idle') + router.stores.status.set('idle') // Use `loc` from the source tuple to avoid reading - // router.stores.location.state inside the effect callback - router.stores.resolvedLocation.setState(() => loc) + // router.stores.location.get() inside the effect callback + router.stores.resolvedLocation.set(loc) }) }) if (changeInfo.hrefChanged) { // Pass the already-captured location to avoid a reactive read // inside the effect callback (handleHashScroll would otherwise - // read router.stores.location.state which triggers a warning) + // read router.stores.location.get() which triggers a warning) handleHashScrollWithLocation(router, loc) } } diff --git a/packages/solid-router/src/awaited.tsx b/packages/solid-router/src/awaited.tsx index 0154cc39e3..41bc74fa20 100644 --- a/packages/solid-router/src/awaited.tsx +++ b/packages/solid-router/src/awaited.tsx @@ -1,6 +1,6 @@ import * as Solid from 'solid-js' -import { TSR_DEFERRED_PROMISE, defer } from '@tanstack/router-core' +import { defer } from '@tanstack/router-core' import type { DeferredPromise } from '@tanstack/router-core' import type { SolidNode } from './route' @@ -12,24 +12,16 @@ export function useAwaited<T>({ promise: _promise, }: AwaitOptions<T>): [T, DeferredPromise<T>] { const promise = defer(_promise) + const data = Solid.createMemo(async () => await promise) - if (promise[TSR_DEFERRED_PROMISE].status === 'pending') { - throw promise - } - - if (promise[TSR_DEFERRED_PROMISE].status === 'error') { - throw promise[TSR_DEFERRED_PROMISE].error - } - - return [promise[TSR_DEFERRED_PROMISE].data, promise] + return [data(), promise] } function InnerAwait<T>(props: { - promise: Promise<T> + data: Solid.Accessor<T> children: (res: T) => SolidNode }) { - const [data] = useAwaited({ promise: props.promise }) - return props.children(data) as any + return props.children(props.data()) as any } export function Await<T>( @@ -38,9 +30,11 @@ export function Await<T>( children: (result: T) => SolidNode }, ) { + const data = Solid.createMemo(async () => await defer(props.promise)) + return ( <Solid.Loading fallback={props.fallback as any}> - <InnerAwait promise={props.promise}>{props.children}</InnerAwait> + <InnerAwait data={data}>{props.children}</InnerAwait> </Solid.Loading> ) } diff --git a/packages/solid-router/src/fileRoute.ts b/packages/solid-router/src/fileRoute.ts index 5fbdc73d5f..afed9eae9b 100644 --- a/packages/solid-router/src/fileRoute.ts +++ b/packages/solid-router/src/fileRoute.ts @@ -45,11 +45,6 @@ export function createFileRoute< >( path?: TFilePath, ): FileRoute<TFilePath, TParentRoute, TId, TPath, TFullPath>['createRoute'] { - if (typeof path === 'object') { - return new FileRoute<TFilePath, TParentRoute, TId, TPath, TFullPath>(path, { - silent: true, - }).createRoute(path) as any - } return new FileRoute<TFilePath, TParentRoute, TId, TPath, TFullPath>(path, { silent: true, }).createRoute @@ -86,7 +81,7 @@ export class FileRoute< TLoaderFn = undefined, TChildren = unknown, TSSR = unknown, - TMiddlewares = unknown, + const TMiddlewares = unknown, THandlers = undefined, >( options?: FileBaseRouteOptions< @@ -153,7 +148,7 @@ export class FileRoute< /** @deprecated It's recommended not to split loaders into separate files. - Instead, place the loader function in the the main route file, inside the + Instead, place the loader function in the main route file, inside the `createFileRoute('/path/to/file)(options)` options. */ export function FileRouteLoader< @@ -178,7 +173,7 @@ export function FileRouteLoader< ) => TLoaderFn { if (process.env.NODE_ENV !== 'production') { console.warn( - `Warning: FileRouteLoader is deprecated and will be removed in the next major version. Please place the loader function in the the main route file, inside the \`createFileRoute('/path/to/file')(options)\` options`, + `Warning: FileRouteLoader is deprecated and will be removed in the next major version. Please place the loader function in the main route file, inside the \`createFileRoute('/path/to/file')(options)\` options`, ) } return (loaderFn) => loaderFn as any diff --git a/packages/solid-router/src/headContentUtils.tsx b/packages/solid-router/src/headContentUtils.tsx index beddfe3da3..687b7f18f4 100644 --- a/packages/solid-router/src/headContentUtils.tsx +++ b/packages/solid-router/src/headContentUtils.tsx @@ -1,8 +1,10 @@ import * as Solid from 'solid-js' import { + appendUniqueUserTags, escapeHtml, getAssetCrossOrigin, - resolveManifestAssetLink, + getScriptPreloadAttrs, + resolveManifestCssLink, } from '@tanstack/router-core' import { useRouter } from './useRouter' import type { @@ -17,14 +19,11 @@ import type { export const useTags = (assetCrossOrigin?: AssetCrossOriginConfig) => { const router = useRouter() const nonce = router.options.ssr?.nonce - const getTagKey = (tag: RouterManagedTag) => JSON.stringify(tag) - const activeMatches = Solid.createMemo( - () => router.stores.activeMatchesSnapshot.state, - ) + const activeMatches = Solid.createMemo(() => router.stores.matches.get()) const routeMeta = Solid.createMemo(() => activeMatches() - .map((match) => match.meta!) - .filter(Boolean), + .map((match) => match.meta) + .filter((meta) => meta !== undefined), ) const meta: Solid.Accessor<Array<RouterManagedTag>> = Solid.createMemo(() => { @@ -102,9 +101,8 @@ export const useTags = (assetCrossOrigin?: AssetCrossOriginConfig) => { const links = Solid.createMemo(() => { const matches = activeMatches() const constructed = matches - .map((match) => match.links!) - .filter(Boolean) - .flat(1) + .flatMap((match) => match.links ?? []) + .filter((link) => link !== undefined) .map((link) => ({ tag: 'link', attrs: { @@ -113,138 +111,145 @@ export const useTags = (assetCrossOrigin?: AssetCrossOriginConfig) => { }, })) satisfies Array<RouterManagedTag> + return constructed + }) + + const manifestCssTags = Solid.createMemo(() => { const manifest = router.ssr?.manifest + const tags: Array<RouterManagedTag> = [] - const assets = matches - .map((match) => manifest?.routes[match.routeId]?.assets ?? []) - .filter(Boolean) - .flat(1) - .filter((asset) => asset.tag === 'link') - .map( - (asset) => - ({ - tag: 'link', - attrs: { - ...asset.attrs, - crossOrigin: - getAssetCrossOrigin(assetCrossOrigin, 'stylesheet') ?? - asset.attrs?.crossOrigin, - nonce, - }, - }) satisfies RouterManagedTag, - ) + if (!manifest) { + return tags + } - return [...constructed, ...assets] + for (const match of activeMatches()) { + manifest.routes[match.routeId]?.css?.forEach((link) => { + const resolvedLink = resolveManifestCssLink(link) + tags.push({ + tag: 'link', + attrs: { + rel: 'stylesheet', + ...resolvedLink, + crossOrigin: + getAssetCrossOrigin(assetCrossOrigin, 'stylesheet') ?? + resolvedLink.crossOrigin, + nonce, + }, + }) + }) + } + + if (manifest.inlineStyle) { + tags.push({ + tag: 'style', + attrs: { + ...manifest.inlineStyle.attrs, + nonce, + }, + children: manifest.inlineStyle.children, + inlineCss: true, + }) + } + + return tags }) const preloadLinks = Solid.createMemo(() => { const matches = activeMatches() const preloadLinks: Array<RouterManagedTag> = [] - matches - .map((match) => router.looseRoutesById[match.routeId]!) - .forEach((route) => - router.ssr?.manifest?.routes[route.id]?.preloads - ?.filter(Boolean) - .forEach((preload) => { - const preloadLink = resolveManifestAssetLink(preload) - preloadLinks.push({ - tag: 'link', - attrs: { - rel: 'modulepreload', - href: preloadLink.href, - crossOrigin: - getAssetCrossOrigin(assetCrossOrigin, 'modulepreload') ?? - preloadLink.crossOrigin, - nonce, - }, - }) - }), - ) + matches.forEach((match) => + router.ssr?.manifest?.routes[match.routeId]?.preloads + ?.filter(Boolean) + .forEach((preload) => { + preloadLinks.push({ + tag: 'link', + attrs: { + ...getScriptPreloadAttrs( + router.ssr?.manifest, + preload, + assetCrossOrigin, + ), + nonce, + }, + }) + }), + ) return preloadLinks }) - const styles = Solid.createMemo(() => - ( - activeMatches() - .map((match) => match.styles!) - .flat(1) - .filter(Boolean) as Array<RouterManagedTag> - ).map(({ children, ...style }) => ({ - tag: 'style', - attrs: { - ...style, - nonce, - }, - children, - })), - ) + const styles = Solid.createMemo(() => { + return activeMatches() + .flatMap((match) => match.styles ?? []) + .filter((style) => style !== undefined) + .map(({ children, ...style }) => ({ + tag: 'style', + attrs: { + ...style, + nonce, + }, + children: children as string | undefined, + })) satisfies Array<RouterManagedTag> + }) - const headScripts = Solid.createMemo(() => - ( - activeMatches() - .map((match) => match.headScripts!) - .flat(1) - .filter(Boolean) as Array<RouterManagedTag> - ).map(({ children, ...script }) => ({ - tag: 'script', - attrs: { - ...script, - nonce, - }, - children, - })), - ) + const headScripts = Solid.createMemo(() => { + return activeMatches() + .flatMap((match) => match.headScripts ?? []) + .filter((script) => script !== undefined) + .map(({ children, ...script }) => ({ + tag: 'script', + attrs: { + ...script, + nonce, + }, + children: children as string | undefined, + })) satisfies Array<RouterManagedTag> + }) // Cache tag objects by key across renders so that unchanged tags keep a // stable object identity. `<For>` keys by reference, so reusing the previous // object for an unchanged tag lets it reconcile the existing DOM node in // place instead of remounting it. Remounting head nodes on navigation // detaches/re-fetches stylesheets (e.g. the app stylesheet), causing a FOUC. - let tagsByKey = new Map<string, RouterManagedTag>() - return Solid.createMemo((prev: Array<RouterManagedTag> | undefined) => { - const next = uniqBy( - [ - ...meta(), - ...preloadLinks(), - ...links(), - ...styles(), - ...headScripts(), - ] as Array<RouterManagedTag>, - getTagKey, - ) + const next: Array<RouterManagedTag> = [] + appendUniqueUserTags(next, meta()) + appendUniqueUserTags(next, links()) + next.push(...manifestCssTags()) + next.push(...preloadLinks()) + appendUniqueUserTags(next, styles()) + appendUniqueUserTags(next, headScripts()) - const nextTagsByKey = new Map<string, RouterManagedTag>() - const stable = next.map((tag) => { - const key = getTagKey(tag) - const reused = tagsByKey.get(key) ?? tag - nextTagsByKey.set(key, reused) - return reused - }) - tagsByKey = nextTagsByKey - - if ( - prev && - prev.length === stable.length && - prev.every((tag, index) => tag === stable[index]) - ) { - return prev + if (prev === undefined) { + return next } - - return stable + return replaceEqualTags(prev, next) }) } -export function uniqBy<T>(arr: Array<T>, fn: (item: T) => string) { - const seen = new Set<string>() - return arr.filter((item) => { - const key = fn(item) - if (seen.has(key)) { - return false +function replaceEqualTags( + prev: Array<RouterManagedTag>, + next: Array<RouterManagedTag>, +) { + const prevByKey = new Map<string, RouterManagedTag>() + for (const tag of prev) { + prevByKey.set(JSON.stringify(tag), tag) + } + + let isEqual = prev.length === next.length + const result = next.map((tag, index) => { + const existing = prevByKey.get(JSON.stringify(tag)) + if (existing) { + if (existing !== prev[index]) { + isEqual = false + } + return existing } - seen.add(key) - return true + + isEqual = false + return tag }) + + return isEqual ? prev : result } diff --git a/packages/solid-router/src/link.tsx b/packages/solid-router/src/link.tsx index 63ad2a738a..7c4f5032c0 100644 --- a/packages/solid-router/src/link.tsx +++ b/packages/solid-router/src/link.tsx @@ -4,6 +4,7 @@ import { deepEqual, exactPathTest, functionalUpdate, + hasKeys, isDangerousProtocol, preloadWarning, removeTrailingSlash, @@ -87,6 +88,7 @@ export function useLinkProps< 'to', 'preload', 'preloadDelay', + 'preloadIntentProximity', 'hashScrollIntoView', 'replace', 'startTransition', @@ -116,11 +118,11 @@ export function useLinkProps< 'mask', 'reloadDocument', 'unsafeRelative', + 'from', ] as any) - const currentLocation = Solid.createMemo(() => router.stores.location.state, { - lazy: true, - equals: (prev, next) => prev?.href === next?.href, + const currentLocation = Solid.createMemo(() => router.stores.location.get(), { + equals: (prev, next) => prev.href === next.href, }) const _options = () => options @@ -489,7 +491,7 @@ export function useLinkProps< ...activeProps, ...inactiveProps, ...base, - ...(Object.keys(style).length ? { style } : undefined), + ...(hasKeys(style) ? { style } : undefined), ...(className ? { class: className } : undefined), ...(active && STATIC_ACTIVE_ATTRIBUTES), } as ResolvedLinkStateProps diff --git a/packages/solid-router/src/not-found.tsx b/packages/solid-router/src/not-found.tsx index 010076d37a..f344179c9e 100644 --- a/packages/solid-router/src/not-found.tsx +++ b/packages/solid-router/src/not-found.tsx @@ -28,8 +28,8 @@ export function CatchNotFound(props: { }) { const router = useRouter() // TODO: Some way for the user to programmatically reset the not-found boundary? - const pathname = Solid.createMemo(() => router.stores.location.state.pathname) - const status = Solid.createMemo(() => router.stores.status.state) + const pathname = Solid.createMemo(() => router.stores.location.get().pathname) + const status = Solid.createMemo(() => router.stores.status.get()) return ( <CatchBoundary diff --git a/packages/solid-router/src/routerStores.ts b/packages/solid-router/src/routerStores.ts index a0d5dac81a..724abc85f1 100644 --- a/packages/solid-router/src/routerStores.ts +++ b/packages/solid-router/src/routerStores.ts @@ -28,10 +28,10 @@ function initRouterStores( ) => RouterReadableStore<TValue>, ) { stores.childMatchIdByRouteId = createReadonlyStore(() => { - const ids = stores.matchesId.state + const ids = stores.matchesId.get() const obj: Record<string, string> = {} for (let i = 0; i < ids.length - 1; i++) { - const parentStore = stores.activeMatchStoresById.get(ids[i]!) + const parentStore = stores.matchStores.get(ids[i]!) if (parentStore?.routeId) { obj[parentStore.routeId] = ids[i + 1]! } @@ -40,10 +40,10 @@ function initRouterStores( }) stores.pendingRouteIds = createReadonlyStore(() => { - const ids = stores.pendingMatchesId.state + const ids = stores.pendingIds.get() const obj: Record<string, boolean> = {} for (const id of ids) { - const store = stores.pendingMatchStoresById.get(id) + const store = stores.pendingMatchStores.get(id) if (store?.routeId) { obj[store.routeId] = true } @@ -57,12 +57,7 @@ function createSolidMutableStore<TValue>( ): RouterWritableStore<TValue> { const [signal, setSignal] = Solid.createSignal(initialValue as any) - return { - get state() { - return signal() - }, - setState: setSignal, - } + return { get: signal, set: setSignal } } let finalizationRegistry: FinalizationRegistry<() => void> | null = null @@ -78,11 +73,7 @@ function createSolidReadonlyStore<TValue>( dispose = d return Solid.createMemo(read) }) - const store = { - get state() { - return memo() - }, - } + const store = { get: memo } finalizationRegistry?.register(store, dispose) return store } diff --git a/packages/solid-router/src/ssr/RouterClient.tsx b/packages/solid-router/src/ssr/RouterClient.tsx index 7c1cc491df..3271dcd63f 100644 --- a/packages/solid-router/src/ssr/RouterClient.tsx +++ b/packages/solid-router/src/ssr/RouterClient.tsx @@ -7,7 +7,7 @@ let hydrationPromise: Promise<void | Array<Array<void>>> | undefined export function RouterClient(props: { router: AnyRouter }) { if (!hydrationPromise) { - if (!props.router.stores.matchesId.state.length) { + if (!props.router.stores.matchesId.get().length) { hydrationPromise = hydrate(props.router) } else { hydrationPromise = Promise.resolve() diff --git a/packages/solid-router/src/ssr/renderRouterToStream.tsx b/packages/solid-router/src/ssr/renderRouterToStream.tsx index 92a9d6d718..779a23af93 100644 --- a/packages/solid-router/src/ssr/renderRouterToStream.tsx +++ b/packages/solid-router/src/ssr/renderRouterToStream.tsx @@ -1,21 +1,50 @@ import * as Solid from '@solidjs/web' import { isbot } from 'isbot' -import { transformReadableStreamWithRouter } from '@tanstack/router-core/ssr/server' +import { + createSsrStreamResponse, + transformReadableStreamWithRouter, +} from '@tanstack/router-core/ssr/server' import { makeSsrSerovalPlugin } from '@tanstack/router-core' import type { ReadableStream } from 'node:stream/web' import type { AnyRouter } from '@tanstack/router-core' import type { JSX } from '@solidjs/web' +const noop = () => {} + +// Bot responses wait for the server renderer before streaming. If the request +// disconnects during that wait, unblock so the pipe can abort and clean up. +async function waitForReadyOrAbort( + ready: Promise<unknown>, + signal: AbortSignal, +) { + let cleanup = noop + try { + await Promise.race([ + ready, + new Promise<void>((resolve) => { + const onAbort = () => resolve() + cleanup = () => signal.removeEventListener('abort', onAbort) + signal.addEventListener('abort', onAbort, { once: true }) + if (signal.aborted) resolve() + }), + ]) + } finally { + cleanup() + } +} + export const renderRouterToStream = async ({ request, router, responseHeaders, children, + manifest, }: { request: Request router: AnyRouter responseHeaders: Headers children: () => JSX.Element + manifest?: unknown }) => { const { writable, readable } = new TransformStream() @@ -30,19 +59,127 @@ export const renderRouterToStream = async ({ const stream = Solid.renderToStream(() => children, { nonce: router.options.ssr?.nonce, plugins: serovalPlugins, + manifest: manifest ?? router.ssr?.manifest, } as any) + // Solid's `pipeTo(w)` takes a single arg (no signal overload) and locks + // `w` via `w.getWriter()`. To still own the lifecycle we hand Solid a + // proxy WritableStream that forwards into an inner writer we control on + // the real TransformStream writable. Aborting the inner writer errors + // the underlying readable (which our router transform reads from), + // surfacing the cancel through the response pipeline. + // + // RESIDUAL RISK: solid-js@1.x does NOT expose a disposal hook on + // `renderToStream`, and its internal write loop swallows writer + // rejections (`writer.write(...).catch(() => {})` in + // solid-js/web/dist/server.js). So aborting the inner writer stops + // outbound bytes but does not terminate Solid's render continuation + // if a Suspense/resource never resolves — those pending promise + // continuations remain scheduled and can retain children/context/ + // request references via captured closures until natural completion + // or process exit. The request-scoped router graph itself is released + // by ServerSsr.cleanup() through the router stream lifecycle, so the leak + // is bounded to whatever the user's Suspense/resource closures capture. + // A hard upstream-abort guarantee would require a disposal API in solid-js. + const innerWriter = writable.getWriter() + let writerDone = false + const releaseWriter = () => { + try { + innerWriter.releaseLock() + } catch { + // already released / errored + } + } + const abortSolidPipe = (reason?: unknown) => { + if (writerDone) return + writerDone = true + void innerWriter + .abort(reason) + .catch(() => {}) + .finally(releaseWriter) + } + + const onRequestAbort = () => { + abortSolidPipe(request.signal.reason) + } + + // Wire request abort before the bot all-ready wait. Otherwise a disconnect + // during `await stream` can leave this callback pending forever. + if (request.signal.aborted) { + onRequestAbort() + } else { + request.signal.addEventListener('abort', onRequestAbort, { once: true }) + router.serverSsr?.onCleanup(() => { + request.signal.removeEventListener('abort', onRequestAbort) + }) + } + if (isbot(request.headers.get('User-Agent'))) { - await stream + await waitForReadyOrAbort( + Promise.resolve(stream as unknown), + request.signal, + ) + } + + const doctype = new TextEncoder().encode('<!DOCTYPE html>') + let doctypeWritten = false + + const solidWritable = new WritableStream({ + write(chunk) { + if (!doctypeWritten) { + doctypeWritten = true + if (ArrayBuffer.isView(chunk)) { + const bytes = chunk as Uint8Array + const out = new Uint8Array(doctype.length + bytes.length) + out.set(doctype, 0) + out.set(bytes, doctype.length) + return innerWriter.write(out) + } + } + return innerWriter.write(chunk) + }, + close() { + writerDone = true + return innerWriter.close().finally(releaseWriter) + }, + abort(reason) { + writerDone = true + return innerWriter.abort(reason).finally(releaseWriter) + }, + }) + + if (!request.signal.aborted) { + try { + void Promise.resolve(stream.pipeTo(solidWritable) as unknown).catch( + (err: any) => { + if ( + writerDone || + err?.name === 'AbortError' || + err?.code === 'ABORT_ERR' + ) + return + console.error('Error in Solid render stream:', err) + abortSolidPipe(err) + }, + ) + } catch (err: any) { + if (err?.name !== 'AbortError' && err?.code !== 'ABORT_ERR') { + console.error('Error in Solid render stream:', err) + } + abortSolidPipe(err) + } } - stream.pipeTo(writable) const responseStream = transformReadableStreamWithRouter( router, readable as unknown as ReadableStream, + { onAbort: abortSolidPipe }, + ) + return createSsrStreamResponse( + router, + new Response(responseStream as any, { + status: router.stores.statusCode.get(), + headers: responseHeaders, + }), ) - return new Response(responseStream as any, { - status: router.stores.statusCode.state, - headers: responseHeaders, - }) } diff --git a/packages/solid-router/src/ssr/renderRouterToString.tsx b/packages/solid-router/src/ssr/renderRouterToString.tsx index c89589a93e..70d9a4de87 100644 --- a/packages/solid-router/src/ssr/renderRouterToString.tsx +++ b/packages/solid-router/src/ssr/renderRouterToString.tsx @@ -7,10 +7,12 @@ export const renderRouterToString = ({ router, responseHeaders, children, + manifest, }: { router: AnyRouter responseHeaders: Headers children: () => JSX.Element + manifest?: unknown }) => { try { const serializationAdapters = @@ -24,6 +26,7 @@ export const renderRouterToString = ({ let html = Solid.renderToString(children, { nonce: router.options.ssr?.nonce, plugins: serovalPlugins, + manifest: manifest ?? router.ssr?.manifest, } as any) router.serverSsr!.setRenderFinished() @@ -32,7 +35,7 @@ export const renderRouterToString = ({ html = html.replace(`</body>`, () => `${injectedHtml}</body>`) } return new Response(`<!DOCTYPE html>${html}`, { - status: router.stores.statusCode.state, + status: router.stores.statusCode.get(), headers: responseHeaders, }) } catch (error) { diff --git a/packages/solid-router/src/useCanGoBack.ts b/packages/solid-router/src/useCanGoBack.ts index 06bf19c918..2f17a78843 100644 --- a/packages/solid-router/src/useCanGoBack.ts +++ b/packages/solid-router/src/useCanGoBack.ts @@ -4,6 +4,6 @@ import { useRouter } from './useRouter' export function useCanGoBack() { const router = useRouter() return Solid.createMemo( - () => router.stores.location.state.state.__TSR_index !== 0, + () => router.stores.location.get().state.__TSR_index !== 0, ) } diff --git a/packages/solid-router/src/useLocation.tsx b/packages/solid-router/src/useLocation.tsx index f5308929b3..5c968443bb 100644 --- a/packages/solid-router/src/useLocation.tsx +++ b/packages/solid-router/src/useLocation.tsx @@ -28,7 +28,7 @@ export function useLocation< const router = useRouter<TRouter>() if (!opts?.select) { - return (() => router.stores.location.state) as Accessor< + return (() => router.stores.location.get()) as Accessor< UseLocationResult<TRouter, TSelected> > } @@ -36,7 +36,7 @@ export function useLocation< const select = opts.select return Solid.createMemo((prev: TSelected | undefined) => { - const res = select(router.stores.location.state) + const res = select(router.stores.location.get()) if (prev === undefined) return res return replaceEqualDeep(prev, res) }) as Accessor<UseLocationResult<TRouter, TSelected>> diff --git a/packages/solid-router/src/useMatch.tsx b/packages/solid-router/src/useMatch.tsx index 94d2666915..a4d6bdf6ab 100644 --- a/packages/solid-router/src/useMatch.tsx +++ b/packages/solid-router/src/useMatch.tsx @@ -76,15 +76,9 @@ export function useMatch< const match = () => { if (opts.from) { - const ids = router.stores.matchesId.state - for (const id of ids) { - const matchStore = router.stores.activeMatchStoresById.get(id) - if (matchStore?.routeId === opts.from) { - return matchStore.state - } - } - - return undefined + return router.stores.matches + .get() + .find((match) => match.routeId === opts.from) } return nearestMatch?.match() @@ -95,18 +89,26 @@ export function useMatch< if (selectedMatch === undefined) { const hasPendingMatch = opts.from - ? Boolean(router.stores.pendingRouteIds.state[opts.from!]) + ? Boolean(router.stores.pendingRouteIds.get()[opts.from!]) : (nearestMatch?.hasPending() ?? false) - const isTransitioning = router.stores.isTransitioning.state - if (!hasPendingMatch && !isTransitioning && (opts.shouldThrow ?? true)) { + if ( + prev !== undefined && + (hasPendingMatch || router.stores.isTransitioning.get()) + ) { + return prev + } + + if (!hasPendingMatch && (opts.shouldThrow ?? true)) { if (process.env.NODE_ENV !== 'production') { throw new Error( `Invariant failed: Could not find ${opts.from ? `an active match from "${opts.from}"` : 'a nearest match!'}`, ) } + invariant() } + return undefined } diff --git a/packages/solid-router/src/useRouterState.tsx b/packages/solid-router/src/useRouterState.tsx index 0efa65073d..ecc16a7c25 100644 --- a/packages/solid-router/src/useRouterState.tsx +++ b/packages/solid-router/src/useRouterState.tsx @@ -1,4 +1,3 @@ -import { isServer } from '@tanstack/router-core/isServer' import * as Solid from 'solid-js' import { replaceEqualDeep } from '@tanstack/router-core' import { useRouter } from './useRouter' @@ -30,24 +29,8 @@ export function useRouterState< }) const router = opts?.router || contextRouter - // During SSR we render exactly once and do not need reactivity. - // Avoid subscribing to the store on the server since the server store - // implementation does not provide subscribe() semantics. - const _isServer = isServer ?? router.isServer - if (_isServer) { - const state = router.stores.__store.state as RouterState< - TRouter['routeTree'] - > - const selected = ( - opts?.select ? opts.select(state) : state - ) as UseRouterStateResult<TRouter, TSelected> - return (() => selected) as Accessor< - UseRouterStateResult<TRouter, TSelected> - > - } - if (!opts?.select) { - return (() => router.stores.__store.state) as Accessor< + return (() => router.stores.__store.get()) as Accessor< UseRouterStateResult<TRouter, TSelected> > } @@ -55,8 +38,12 @@ export function useRouterState< const select = opts.select return Solid.createMemo((prev: TSelected | undefined) => { - const res = select(router.stores.__store.state) + const res = select(router.stores.__store.get()) if (prev === undefined) return res return replaceEqualDeep(prev, res) - }) as Accessor<UseRouterStateResult<TRouter, TSelected>> + }, { transparent: true } as Solid.MemoOptions<TSelected> & { + ssrSource?: 'server' | 'hybrid' + }) as Accessor< + UseRouterStateResult<TRouter, TSelected> + > } diff --git a/packages/solid-router/tests/Matches.test-d.tsx b/packages/solid-router/tests/Matches.test-d.tsx index 671450c219..9c4ab7f49f 100644 --- a/packages/solid-router/tests/Matches.test-d.tsx +++ b/packages/solid-router/tests/Matches.test-d.tsx @@ -9,7 +9,9 @@ import { useMatches, } from '../src' import type { AnyRouteMatch, RouteMatch } from '@tanstack/router-core' +import type { JSX } from '@solidjs/web' import type * as Solid from 'solid-js' +import type { MakeMatchRouteOptions } from '../src' const rootRoute = createRootRoute() @@ -234,3 +236,19 @@ test('when filtering useMatches by loaderData with an array', () => { matches.filter((match) => isMatch(match, 'loaderData.0.comment')), ).toEqualTypeOf<Array<CommentsMatch>>() }) + +test('MatchRoute children are typed from resolved params under pathless layouts', () => { + type CommentsMatchRouteChildren = MakeMatchRouteOptions< + DefaultRouter, + string, + '/comments/$id' + >['children'] + type CommentsMatchRouteRenderFn = Extract< + CommentsMatchRouteChildren, + (...args: Array<any>) => any + > + + expectTypeOf<CommentsMatchRouteRenderFn>().toEqualTypeOf< + (params?: { id: string } | undefined) => JSX.Element + >() +}) diff --git a/packages/solid-router/tests/Matches.test.tsx b/packages/solid-router/tests/Matches.test.tsx index 4e6cdc7a3d..00e63b4ffa 100644 --- a/packages/solid-router/tests/Matches.test.tsx +++ b/packages/solid-router/tests/Matches.test.tsx @@ -239,6 +239,57 @@ test('MatchRoute updates for navigation and reactive params changes', async () = }) }) +test('Outlet disposes index content when passed through wrapper children', async () => { + function RootDocument(props: { children: any }) { + return ( + <div> + <Link to="/posts">Posts</Link> + {props.children} + </div> + ) + } + + const rootRoute = createRootRoute({ + component: () => ( + <RootDocument> + <Outlet /> + </RootDocument> + ), + }) + + const indexRoute = createRoute({ + getParentRoute: () => rootRoute, + path: '/', + component: () => <h1>Home</h1>, + }) + + const postsRoute = createRoute({ + getParentRoute: () => rootRoute, + path: 'posts', + component: () => <h1>Posts</h1>, + }) + + const router = createRouter({ + routeTree: rootRoute.addChildren([indexRoute, postsRoute]), + history: createMemoryHistory({ initialEntries: ['/'] }), + }) + + render(() => <RouterProvider router={router} />) + + expect( + await screen.findByRole('heading', { name: 'Home' }), + ).toBeInTheDocument() + + fireEvent.click(screen.getByRole('link', { name: 'Posts' })) + + await waitFor(() => { + expect(screen.getByRole('heading', { name: 'Posts' })).toBeInTheDocument() + expect( + screen.queryByRole('heading', { name: 'Home' }), + ).not.toBeInTheDocument() + }) +}) + describe('matching on different param types', () => { const testCases = [ { diff --git a/packages/solid-router/tests/Scripts.test.tsx b/packages/solid-router/tests/Scripts.test.tsx index 0153965de6..b15faaef19 100644 --- a/packages/solid-router/tests/Scripts.test.tsx +++ b/packages/solid-router/tests/Scripts.test.tsx @@ -21,20 +21,16 @@ import { import { Scripts } from '../src/Scripts' import type { Manifest } from '@tanstack/router-core' -const createTestManifest = (routeId: string) => +const createTestManifest = ( + routeId: string, + options?: { scriptFormat?: Manifest['scriptFormat'] }, +) => ({ + ...(options?.scriptFormat ? { scriptFormat: options.scriptFormat } : {}), routes: { [routeId]: { preloads: ['/main.js'], - assets: [ - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/main.css', - }, - }, - ], + css: ['/main.css'], }, }, }) satisfies Manifest @@ -223,7 +219,88 @@ describe('ssr scripts', () => { ).toHaveLength(1) }) - test('applies assetCrossOrigin to manifest assets and preloads', async () => { + test('keeps manifest stylesheet links mounted when preload counts change', async () => { + const history = createTestBrowserHistory() + + const rootRoute = createRootRoute({ + component: () => { + return ( + <> + <HeadContent /> + <Outlet /> + </> + ) + }, + }) + + const aRoute = createRoute({ + path: '/a', + getParentRoute: () => rootRoute, + component: () => <Link to="/b">Go to B</Link>, + }) + + const bRoute = createRoute({ + path: '/b', + getParentRoute: () => rootRoute, + component: () => <Link to="/a">Go to A</Link>, + }) + + const router = createRouter({ + history, + routeTree: rootRoute.addChildren([aRoute, bRoute]), + }) + + router.ssr = { + manifest: { + routes: { + [rootRoute.id]: { + preloads: ['/root.js'], + css: ['/main.css'], + }, + [aRoute.id]: { + preloads: ['/a.js'], + }, + [bRoute.id]: { + preloads: ['/b.js', '/b-child.js'], + }, + }, + }, + } + + await router.navigate({ to: '/a' }) + await router.load() + + render(() => <RouterProvider router={router} />) + + const getStylesheetLink = () => + Array.from(document.head.querySelectorAll('link[rel="stylesheet"]')).find( + (link) => link.getAttribute('href') === '/main.css', + ) + + await waitFor(() => { + expect(getStylesheetLink()).toBeInstanceOf(HTMLLinkElement) + }) + + const initialLink = getStylesheetLink() + expect(initialLink).toBeInstanceOf(HTMLLinkElement) + + fireEvent.click(screen.getByRole('link', { name: 'Go to B' })) + + await waitFor(() => { + expect(router.state.location.pathname).toBe('/b') + }) + + await screen.findByRole('link', { name: 'Go to A' }) + + expect(getStylesheetLink()).toBe(initialLink) + expect( + Array.from( + document.head.querySelectorAll('link[rel="stylesheet"]'), + ).filter((link) => link.getAttribute('href') === '/main.css'), + ).toHaveLength(1) + }) + + test('applies assetCrossOrigin to manifest stylesheets and preloads', async () => { const history = createTestBrowserHistory() const rootRoute = createRootRoute({ @@ -232,7 +309,7 @@ describe('ssr scripts', () => { <> <HeadContent assetCrossOrigin={{ - modulepreload: 'anonymous', + script: 'anonymous', stylesheet: 'use-credentials', }} /> @@ -279,6 +356,100 @@ describe('ssr scripts', () => { ?.getAttribute('crossorigin'), ).toBe('anonymous') }) + + test('renders runtime manifest inlineStyle', async () => { + const history = createTestBrowserHistory() + + const rootRoute = createRootRoute({ + component: () => { + return ( + <> + <HeadContent /> + <Outlet /> + </> + ) + }, + }) + + const indexRoute = createRoute({ + path: '/', + getParentRoute: () => rootRoute, + component: () => <div>Index</div>, + }) + + const router = createRouter({ + history, + routeTree: rootRoute.addChildren([indexRoute]), + }) + + router.ssr = { + manifest: { + inlineStyle: { + attrs: { id: 'runtime-inline-style' }, + children: '.runtime{color:red}', + }, + routes: { + [rootRoute.id]: {}, + }, + }, + } + + await router.load() + + render(() => <RouterProvider router={router} />) + + await waitFor(() => { + expect( + document.head.querySelector('style#runtime-inline-style'), + ).toBeTruthy() + }) + + expect( + document.head.querySelector('style#runtime-inline-style')?.textContent, + ).toBe('.runtime{color:red}') + }) + + test('renders preload as script links for iife manifest preloads', async () => { + const history = createTestBrowserHistory() + + const rootRoute = createRootRoute({ + component: () => { + return ( + <> + <HeadContent /> + <Outlet /> + </> + ) + }, + }) + + const indexRoute = createRoute({ + path: '/', + getParentRoute: () => rootRoute, + component: () => <div>Index</div>, + }) + + const router = createRouter({ + history, + routeTree: rootRoute.addChildren([indexRoute]), + }) + + router.ssr = { + manifest: createTestManifest(rootRoute.id, { scriptFormat: 'iife' }), + } + + await router.load() + + render(() => <RouterProvider router={router} />) + + await waitFor(() => { + expect( + document.head.querySelector('link[rel="preload"][as="script"]'), + ).toBeTruthy() + }) + + expect(document.head.querySelector('link[rel="modulepreload"]')).toBeFalsy() + }) }) describe('ssr HeadContent', () => { diff --git a/packages/solid-router/tests/fileRoute.test-d.tsx b/packages/solid-router/tests/fileRoute.test-d.tsx index 402751c115..c173095d62 100644 --- a/packages/solid-router/tests/fileRoute.test-d.tsx +++ b/packages/solid-router/tests/fileRoute.test-d.tsx @@ -1,5 +1,53 @@ import { expectTypeOf, test } from 'vitest' import { createFileRoute, createRootRoute } from '../src' +import type { Route } from '@tanstack/router-core' + +declare module '@tanstack/router-core' { + interface FilebaseRouteOptionsInterface< + TRegister, + TParentRoute, + TId, + TPath, + TSearchValidator, + TParams, + TLoaderDeps, + TLoaderFn, + TRouterContext, + TRouteContextFn, + TBeforeLoadFn, + TRemountDepsFn, + TSSR, + TServerMiddlewares, + THandlers, + > { + server?: { + middleware?: TServerMiddlewares + } + } + + interface RouteTypes< + TRegister, + TParentRoute, + TPath, + TFullPath, + TCustomId, + TId, + TSearchValidator, + TParams, + TRouterContext, + TRouteContextFn, + TBeforeLoadFn, + TLoaderDeps, + TLoaderFn, + TChildren, + TFileRouteTypes, + TSSR, + TServerMiddlewares, + THandlers, + > { + middleware: TServerMiddlewares + } +} const _rootRoute = createRootRoute() @@ -100,3 +148,42 @@ test('when creating a folder group', () => { expectTypeOf<'(auth)/protected'>(protectedRoute.path) expectTypeOf<'/protected'>(protectedRoute.id) }) + +test('when creating a file route with middleware options', () => { + type Middleware = { readonly middleware: 'middleware' } + const middleware = { middleware: 'middleware' } as const + + const route = createFileRoute('/invoices')({ + server: { + middleware: [middleware], + }, + }) + + type ExtractMiddlewares<TRoute> = + TRoute extends Route< + any, + any, + any, + any, + any, + any, + any, + any, + any, + any, + any, + any, + any, + any, + any, + any, + infer TMiddlewares, + any + > + ? TMiddlewares + : never + + expectTypeOf<ExtractMiddlewares<typeof route>>().toEqualTypeOf< + readonly [Middleware] + >() +}) diff --git a/packages/solid-router/tests/lazy/normal.tsx b/packages/solid-router/tests/lazy/normal.tsx index 5b0f169da4..61eba8ab02 100644 --- a/packages/solid-router/tests/lazy/normal.tsx +++ b/packages/solid-router/tests/lazy/normal.tsx @@ -2,7 +2,7 @@ import { createLazyFileRoute, createLazyRoute } from '../../src' export function Route(id: string) { return createLazyRoute(id)({ - component: () => <h1>I'm a normal route</h1>, + component: () => <h1 data-testid="lazy-route-page">I'm a normal route</h1>, }) } diff --git a/packages/solid-router/tests/link.test.tsx b/packages/solid-router/tests/link.test.tsx index 5aff4a52e1..42e3a07284 100644 --- a/packages/solid-router/tests/link.test.tsx +++ b/packages/solid-router/tests/link.test.tsx @@ -175,6 +175,90 @@ describe('Link', () => { ).rejects.toThrow() }) + test('does not forward internal Link props to the DOM', async () => { + const internalPropNames = [ + 'activeProps', + 'inactiveProps', + 'activeOptions', + 'to', + 'from', + 'preload', + 'preloadDelay', + 'preloadIntentProximity', + 'hashScrollIntoView', + 'replace', + 'startTransition', + 'resetScroll', + 'viewTransition', + 'ignoreBlocker', + 'params', + 'search', + 'hash', + 'state', + 'mask', + 'reloadDocument', + 'unsafeRelative', + ].map((propName) => propName.toLowerCase()) + + const rootRoute = createRootRoute() + const indexRoute = createRoute({ + getParentRoute: () => rootRoute, + path: '/', + component: () => ( + <Link + to="/posts" + from="/" + activeProps={{ class: 'active' }} + inactiveProps={{ class: 'inactive' }} + activeOptions={{ + exact: true, + includeHash: true, + includeSearch: true, + }} + preload="intent" + preloadDelay={50} + preloadIntentProximity={123} + hashScrollIntoView={true} + replace={true} + startTransition={true} + resetScroll={true} + viewTransition={true} + ignoreBlocker={true} + params={{}} + search={{ foo: 'bar' }} + hash="details" + state={{}} + mask={{ to: '/posts', hash: 'masked' }} + reloadDocument={true} + unsafeRelative="path" + > + Posts + </Link> + ), + }) + + const postsRoute = createRoute({ + getParentRoute: () => rootRoute, + path: '/posts', + component: () => <h1>Posts</h1>, + }) + + const router = createRouter({ + routeTree: rootRoute.addChildren([indexRoute, postsRoute]), + }) + + render(() => <RouterProvider router={router} />) + + const postsLink = await screen.findByRole('link', { name: 'Posts' }) + const renderedAttributeNames = postsLink + .getAttributeNames() + .map((attributeName) => attributeName.toLowerCase()) + + for (const propName of internalPropNames) { + expect(renderedAttributeNames).not.toContain(propName) + } + }) + test('when a Link has children', async () => { const ChildComponent = vi.fn().mockReturnValue(<button>Posts</button>) const rootRoute = createRootRoute() diff --git a/packages/solid-router/tests/loaders.test.tsx b/packages/solid-router/tests/loaders.test.tsx index 900ba66d73..ad341a861c 100644 --- a/packages/solid-router/tests/loaders.test.tsx +++ b/packages/solid-router/tests/loaders.test.tsx @@ -11,6 +11,7 @@ import { createRootRoute, createRoute, createRouter, + useLoaderData, useRouter, } from '../src' @@ -722,6 +723,51 @@ test('clears pendingTimeout when match resolves', async () => { expect(fooPendingComponentOnMountMock).not.toHaveBeenCalled() }) +test('useLoaderData retains previous data while route match is pending', async () => { + const history = createMemoryHistory({ initialEntries: ['/app'] }) + const rootRoute = createRootRoute({ + component: () => { + const loaderData = useLoaderData({ from: '/app' }) + + return ( + <> + <div data-testid="combined">{`${loaderData().length}:0`}</div> + <Outlet /> + </> + ) + }, + }) + const appRoute = createRoute({ + getParentRoute: () => rootRoute, + path: '/app', + loader: () => 'loaded', + component: () => <div>App route</div>, + }) + const routeTree = rootRoute.addChildren([appRoute]) + const router = createRouter({ routeTree, history }) + + render(() => <RouterProvider router={router} />) + + expect(await screen.findByTestId('combined')).toHaveTextContent('6:0') + + const appMatch = router.state.matches.find( + (match) => match.routeId === '/app', + ) + + expect(appMatch).toBeDefined() + + if (!appMatch) { + throw new Error('Expected /app match to be active') + } + + router.stores.setPending([{ ...appMatch, id: `${appMatch.id}__pending` }]) + router.stores.setMatches( + router.state.matches.filter((match) => match.routeId !== '/app'), + ) + + expect(screen.getByTestId('combined')).toHaveTextContent('6:0') +}) + test('cancelMatches after pending timeout', async () => { function getPendingComponent(onMount: () => void) { const PendingComponent = () => { diff --git a/packages/solid-router/tests/redirect.test.tsx b/packages/solid-router/tests/redirect.test.tsx index 5d3ecc898a..81bd1f6bc6 100644 --- a/packages/solid-router/tests/redirect.test.tsx +++ b/packages/solid-router/tests/redirect.test.tsx @@ -4,6 +4,7 @@ import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest' import { Link, + Outlet, RouterProvider, createBrowserHistory, createMemoryHistory, @@ -104,6 +105,52 @@ describe('redirect', () => { expect(nestedFooLoaderMock).toHaveBeenCalled() }) + test('when root `beforeLoad` redirects while root pendingComponent is showing and the target route is lazy', async () => { + let hasRedirected = false + const consoleError = vi + .spyOn(console, 'error') + .mockImplementation(() => {}) + + const rootRoute = createRootRoute({ + component: () => <Outlet />, + pendingMs: 0, + pendingComponent: () => <div data-testid="pending">loading</div>, + beforeLoad: async () => { + await sleep(WAIT_TIME) + if (!hasRedirected) { + hasRedirected = true + throw redirect({ to: '/posts' }) + } + }, + }) + + const indexRoute = createRoute({ + getParentRoute: () => rootRoute, + path: '/', + component: () => <div data-testid="index-page">Index page</div>, + }) + + const postsRoute = createRoute({ + getParentRoute: () => rootRoute, + path: '/posts', + }).lazy(() => import('./lazy/normal').then((d) => d.Route('/posts'))) + + const router = createRouter({ + routeTree: rootRoute.addChildren([indexRoute, postsRoute]), + history, + }) + + render(() => <RouterProvider router={router} />) + + // The lazy target route adds the async boundary that exposes the stale + // redirected-match render path this regression is guarding. + expect(await screen.findByTestId('lazy-route-page')).toBeInTheDocument() + expect(screen.queryByTestId('pending')).not.toBeInTheDocument() + expect(router.state.location.href).toBe('/posts') + expect(router.state.status).toBe('idle') + expect(consoleError).not.toHaveBeenCalled() + }) + test('when `redirect` is thrown in `loader`', async () => { const nestedLoaderMock = vi.fn() const nestedFooLoaderMock = vi.fn() diff --git a/packages/solid-router/tests/renderRouterToStream.test.tsx b/packages/solid-router/tests/renderRouterToStream.test.tsx new file mode 100644 index 0000000000..ba5ee51ca0 --- /dev/null +++ b/packages/solid-router/tests/renderRouterToStream.test.tsx @@ -0,0 +1,147 @@ +import { afterEach, describe, expect, test, vi } from 'vitest' +import { attachRouterServerSsrUtils } from '@tanstack/router-core/ssr/server' +import { createMemoryHistory, createRootRoute, createRouter } from '../src' +import type * as SolidWeb from 'solid-js/web' + +const solidMocks = vi.hoisted(() => ({ + renderToStream: vi.fn(), + pipeTo: vi.fn(), +})) + +vi.mock('solid-js/web', async () => { + const actual = await vi.importActual<typeof SolidWeb>('solid-js/web') + return { + ...actual, + renderToStream: solidMocks.renderToStream, + } +}) + +// Imported after mock so the wrapper picks up the mocked binding. +const { renderRouterToStream } = await import('../src/ssr/renderRouterToStream') + +function unwrapResponse( + result: Awaited<ReturnType<typeof renderRouterToStream>>, +) { + return result.response +} + +afterEach(() => { + solidMocks.renderToStream.mockReset() + solidMocks.pipeTo.mockReset() + vi.restoreAllMocks() +}) + +async function buildRouter() { + const rootRoute = createRootRoute({ + component: () => null, + }) + const router = createRouter({ + history: createMemoryHistory({ initialEntries: ['/'] }), + routeTree: rootRoute, + }) + router.isServer = true + attachRouterServerSsrUtils({ router, manifest: undefined }) + await router.load() + return router +} + +function drainBody(response: Response) { + const reader = response.body!.getReader() + return (async () => { + for (;;) { + const { done } = await reader.read() + if (done) return true + } + })().catch(() => true) +} + +describe('renderRouterToStream - bot abort', () => { + test('request abort during bot wait returns and terminates response stream', async () => { + const neverReady = new Promise<void>(() => {}) + solidMocks.pipeTo.mockImplementationOnce( + (writable: WritableStream<Uint8Array>) => { + const writer = writable.getWriter() + return writer + .write(new TextEncoder().encode('<html><body>solid</body></html>')) + .catch(() => {}) + }, + ) + solidMocks.renderToStream.mockImplementationOnce( + () => + ({ + then: neverReady.then.bind(neverReady), + pipeTo: solidMocks.pipeTo, + }) as any, + ) + + const router = await buildRouter() + const abortController = new AbortController() + const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {}) + try { + const responsePromise = renderRouterToStream({ + request: new Request('http://localhost/', { + headers: { 'User-Agent': 'Googlebot' }, + signal: abortController.signal, + }), + router, + responseHeaders: new Headers(), + children: () => null, + }) + + await Promise.resolve() + abortController.abort(new Error('client-gone')) + + const result = await Promise.race([ + responsePromise, + new Promise<false>((resolve) => setTimeout(() => resolve(false), 2000)), + ]) + + expect(result).not.toBe(false) + expect(solidMocks.pipeTo).not.toHaveBeenCalled() + const response = unwrapResponse(result as Exclude<typeof result, false>) + + const terminated = await Promise.race([ + drainBody(response), + new Promise<false>((resolve) => setTimeout(() => resolve(false), 2000)), + ]) + + expect(terminated).toBe(true) + } finally { + errorSpy.mockRestore() + router.serverSsr?.cleanup() + } + }) + + test('pipeTo rejection aborts writer and terminates response stream', async () => { + solidMocks.renderToStream.mockImplementationOnce( + () => + ({ + pipeTo: () => Promise.reject(new Error('solid-pipe-failed')), + }) as any, + ) + + const router = await buildRouter() + const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {}) + try { + const response = unwrapResponse( + await renderRouterToStream({ + request: new Request('http://localhost/'), + router, + responseHeaders: new Headers(), + children: () => null, + }), + ) + + const terminated = await Promise.race([ + drainBody(response), + new Promise<false>((resolve) => setTimeout(() => resolve(false), 2000)), + ]) + + expect(terminated).toBe(true) + expect(errorSpy).toHaveBeenCalled() + } finally { + errorSpy.mockRestore() + router.serverSsr?.cleanup() + } + }) +}) diff --git a/packages/solid-router/tests/store-updates-during-navigation.test.tsx b/packages/solid-router/tests/store-updates-during-navigation.test.tsx index e8d4d8e81f..30575014aa 100644 --- a/packages/solid-router/tests/store-updates-during-navigation.test.tsx +++ b/packages/solid-router/tests/store-updates-during-navigation.test.tsx @@ -172,7 +172,7 @@ describe("Store doesn't update *too many* times during navigation", () => { // that needs to be done during a navigation. // Any change that increases this number should be investigated. // Note: Solid has different update counts than React due to different reactivity - expect(updates).toBe(4) + expect(updates).toBe(5) }) test('nothing', async () => { diff --git a/packages/solid-router/tests/useParams.test.tsx b/packages/solid-router/tests/useParams.test.tsx index 2b56134a22..601297b095 100644 --- a/packages/solid-router/tests/useParams.test.tsx +++ b/packages/solid-router/tests/useParams.test.tsx @@ -200,7 +200,8 @@ test('useParams must return parsed result if applicable.', async () => { expect(window.location.pathname).toBe('/posts/category_first') expect(router.state.location.pathname).toBe('/posts/category_first') expect(await screen.findByTestId('post-category-heading')).toBeInTheDocument() - expect(mockedfn).not.toHaveBeenCalled() + // Dev-only buildLocation roundtrip validation uses normal matching for links. + expect(mockedfn).toHaveBeenCalled() mockedfn.mockClear() await router.navigate({ diff --git a/packages/solid-start-client/CHANGELOG.md b/packages/solid-start-client/CHANGELOG.md index b0d99efe87..e5143a6df0 100644 --- a/packages/solid-start-client/CHANGELOG.md +++ b/packages/solid-start-client/CHANGELOG.md @@ -323,3 +323,469 @@ - @tanstack/router-core@1.167.0 - @tanstack/solid-router@1.167.0 - @tanstack/start-client-core@1.166.8 + +## 1.168.7 + +### Patch Changes + +- Updated dependencies [[`2f53749`](https://github.com/TanStack/router/commit/2f5374945e2138559a51464f45a5152eae67e1dd)]: + - @tanstack/router-core@1.171.8 + - @tanstack/solid-router@1.170.10 + - @tanstack/start-client-core@1.170.6 + +## 1.168.6 + +### Patch Changes + +- Updated dependencies [[`d1997b6`](https://github.com/TanStack/router/commit/d1997b66d7c24c1d64772bb8bab5caf9c6d9cc48)]: + - @tanstack/solid-router@1.170.9 + - @tanstack/router-core@1.171.7 + - @tanstack/start-client-core@1.170.5 + +## 1.168.5 + +### Patch Changes + +- [#7492](https://github.com/TanStack/router/pull/7492) [`71fb329`](https://github.com/TanStack/router/commit/71fb3297e93a126e1bcfd9eeb0626cc4b8df8dd8) - Avoid pulling the client hydration entry into root `@tanstack/react-start` and `@tanstack/solid-start` imports by re-exporting `Hydrate` from framework client Hydrate-only subpaths. + +## 1.168.4 + +### Patch Changes + +- Updated dependencies [[`a82cec6`](https://github.com/TanStack/router/commit/a82cec69474c366b36efdb3f43c4efe8311c485a)]: + - @tanstack/start-client-core@1.170.4 + +## 1.168.3 + +### Patch Changes + +- Updated dependencies [[`51a97a1`](https://github.com/TanStack/router/commit/51a97a167fb3ef1b8ca70fbb63db635158f43509)]: + - @tanstack/router-core@1.171.6 + - @tanstack/solid-router@1.170.8 + - @tanstack/start-client-core@1.170.3 + +## 1.168.2 + +### Patch Changes + +- Updated dependencies [[`5268ba4`](https://github.com/TanStack/router/commit/5268ba4566233ea58880df85f167ad0401a93a46)]: + - @tanstack/router-core@1.171.5 + - @tanstack/solid-router@1.170.7 + - @tanstack/start-client-core@1.170.2 + +## 1.168.1 + +### Patch Changes + +- Updated dependencies [[`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960), [`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960)]: + - @tanstack/router-core@1.171.4 + - @tanstack/solid-router@1.170.6 + - @tanstack/start-client-core@1.170.1 + +## 1.168.0 + +### Minor Changes + +- Add deferred Hydrate boundary support for TanStack Start. ([#7362](https://github.com/TanStack/router/pull/7362)) + + Hydrate boundaries can now be code-split by the Start compiler, preload their generated client chunks, preserve server-rendered fallback HTML, and replay interaction-triggered events after hydration. The compiler integration now uses a Start-owned compiler plugin for Hydrate virtual modules across Vite and Rsbuild, with dev invalidation for generated virtual modules. + + Shared AST utilities used by the router code-splitter and Hydrate virtual modules were moved into `@tanstack/router-utils` so both pipelines can retain referenced top-level declarations, unwrap local exports, and let dead-code elimination remove unused route module code. + +### Patch Changes + +- Updated dependencies [[`5fa9e55`](https://github.com/TanStack/router/commit/5fa9e555f3a2edb5e45586623e6bcbfa7f7c7a6b)]: + - @tanstack/start-client-core@1.170.0 + - @tanstack/router-core@1.171.3 + - @tanstack/solid-router@1.170.5 + +## 1.167.4 + +### Patch Changes + +- Updated dependencies [[`b60eb36`](https://github.com/TanStack/router/commit/b60eb36e59e8a468ee0742cbcf7f47aca1ff1c67)]: + - @tanstack/router-core@1.171.2 + - @tanstack/solid-router@1.170.4 + - @tanstack/start-client-core@1.169.4 + +## 1.167.3 + +### Patch Changes + +- Updated dependencies [[`d9cf933`](https://github.com/TanStack/router/commit/d9cf9331b83fcbd2abfee75d839d862f9bb18e6b)]: + - @tanstack/router-core@1.171.1 + - @tanstack/solid-router@1.170.3 + - @tanstack/start-client-core@1.169.3 + +## 1.167.2 + +### Patch Changes + +- Updated dependencies [[`d533f87`](https://github.com/TanStack/router/commit/d533f87976704098a40b48f160b37c28c8182806)]: + - @tanstack/router-core@1.171.0 + - @tanstack/solid-router@1.170.2 + - @tanstack/start-client-core@1.169.2 + +## 1.167.1 + +### Patch Changes + +- Updated dependencies [[`2387a2e`](https://github.com/TanStack/router/commit/2387a2eea0683004cc400b9f71bed5944eb60110)]: + - @tanstack/router-core@1.170.1 + - @tanstack/solid-router@1.170.1 + - @tanstack/start-client-core@1.169.1 + +## 1.167.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- Updated dependencies [[`b1c061a`](https://github.com/TanStack/router/commit/b1c061aff9185cdf5fdc08c0136382a9dce0302f), [`201e150`](https://github.com/TanStack/router/commit/201e150bd1412bae2faa9ce53f0fefcb7574ac14)]: + - @tanstack/router-core@1.170.0 + - @tanstack/solid-router@1.170.0 + - @tanstack/start-client-core@1.169.0 + +## 1.166.47 + +### Patch Changes + +- Updated dependencies [[`35e88f0`](https://github.com/TanStack/router/commit/35e88f04996d71019a1868b7b06ecb4ddbc9df9e)]: + - @tanstack/router-core@1.169.2 + - @tanstack/start-client-core@1.168.2 + - @tanstack/solid-router@1.169.2 + +## 1.166.46 + +### Patch Changes + +- Updated dependencies [[`4a1e63f`](https://github.com/TanStack/router/commit/4a1e63f1d1230b1ed8234609acad4639d8982c13)]: + - @tanstack/router-core@1.169.1 + - @tanstack/solid-router@1.169.1 + - @tanstack/start-client-core@1.168.1 + +## 1.166.45 + +### Patch Changes + +- Updated dependencies [[`82b0613`](https://github.com/TanStack/router/commit/82b06132af776f74603ab27977cc277d6219a845)]: + - @tanstack/start-client-core@1.168.0 + +## 1.166.44 + +### Patch Changes + +- Updated dependencies [[`c992495`](https://github.com/TanStack/router/commit/c992495bf4010ff4c3597bb1f3b1ba02594e857e)]: + - @tanstack/router-core@1.169.0 + - @tanstack/solid-router@1.169.0 + - @tanstack/start-client-core@1.167.22 + +## 1.166.43 + +### Patch Changes + +- Updated dependencies [[`b5c4183`](https://github.com/TanStack/router/commit/b5c4183ab8b44be8a75647b7f7b588ad7c146ece)]: + - @tanstack/router-core@1.168.18 + - @tanstack/solid-router@1.168.26 + - @tanstack/start-client-core@1.167.21 + +## 1.166.42 + +### Patch Changes + +- Updated dependencies [[`493148b`](https://github.com/TanStack/router/commit/493148bc5378b7f9de1544d87f6aaa425c12eb34)]: + - @tanstack/router-core@1.168.17 + - @tanstack/solid-router@1.168.25 + - @tanstack/start-client-core@1.167.20 + +## 1.166.41 + +### Patch Changes + +- Updated dependencies [[`944b155`](https://github.com/TanStack/router/commit/944b1558965bf038eaf3c0dfb9e1ac3800d6fd3a)]: + - @tanstack/solid-router@1.168.24 + +## 1.166.40 + +### Patch Changes + +- Updated dependencies [[`41e37f8`](https://github.com/TanStack/router/commit/41e37f8a9c3d2a6e00e4ca6faabb6a596bc36a98), [`e054474`](https://github.com/TanStack/router/commit/e054474cd1df6f93cd69dd5d255013840441438e)]: + - @tanstack/solid-router@1.168.23 + +## 1.166.39 + +### Patch Changes + +- Updated dependencies [[`b732c8a`](https://github.com/TanStack/router/commit/b732c8ac26bd3b316e95b026ca2fc7c2c78a1ddd), [`d20c878`](https://github.com/TanStack/router/commit/d20c87813559ff00d0b4810c4b600d47b47eff2f)]: + - @tanstack/solid-router@1.168.22 + +## 1.166.38 + +### Patch Changes + +- Updated dependencies [[`8b97002`](https://github.com/TanStack/router/commit/8b97002af3f6d15204e60c55d3f5735b78bd7efe)]: + - @tanstack/start-client-core@1.167.19 + +## 1.166.37 + +### Patch Changes + +- Updated dependencies [[`4d864ee`](https://github.com/TanStack/router/commit/4d864eebbd184265eabb563d326ab409c93feb17)]: + - @tanstack/router-core@1.168.16 + - @tanstack/solid-router@1.168.21 + - @tanstack/start-client-core@1.167.18 + +## 1.166.36 + +### Patch Changes + +- Updated dependencies [[`22dc152`](https://github.com/TanStack/router/commit/22dc15203379da15e6eaa225e61696039380aedd)]: + - @tanstack/solid-router@1.168.20 + +## 1.166.35 + +### Patch Changes + +- Updated dependencies [[`16f6892`](https://github.com/TanStack/router/commit/16f6892d6b7ceadf606677c5a40e743f29163aa6)]: + - @tanstack/router-core@1.168.15 + - @tanstack/solid-router@1.168.19 + - @tanstack/start-client-core@1.167.17 + +## 1.166.34 + +### Patch Changes + +- Updated dependencies [[`105d056`](https://github.com/TanStack/router/commit/105d05691a247779a63e7b688aa1207cce619339)]: + - @tanstack/solid-router@1.168.18 + +## 1.166.33 + +### Patch Changes + +- Updated dependencies [[`0e2c900`](https://github.com/TanStack/router/commit/0e2c9003c18ae07c09969189c028f277ea562a7a)]: + - @tanstack/router-core@1.168.14 + - @tanstack/solid-router@1.168.17 + - @tanstack/start-client-core@1.167.16 + +## 1.166.32 + +### Patch Changes + +- Updated dependencies [[`812792f`](https://github.com/TanStack/router/commit/812792fbda3caf97b300770855cf5641252f413b)]: + - @tanstack/router-core@1.168.13 + - @tanstack/solid-router@1.168.16 + - @tanstack/start-client-core@1.167.15 + +## 1.166.31 + +### Patch Changes + +- Updated dependencies [[`8ec9ca9`](https://github.com/TanStack/router/commit/8ec9ca97b472779de878c2a6510f21deb24d386c)]: + - @tanstack/router-core@1.168.12 + - @tanstack/solid-router@1.168.15 + - @tanstack/start-client-core@1.167.14 + +## 1.166.30 + +### Patch Changes + +- Updated dependencies [[`6355bb7`](https://github.com/TanStack/router/commit/6355bb75f7637ba77f06a923c18fdaf37720bb48)]: + - @tanstack/solid-router@1.168.14 + - @tanstack/router-core@1.168.11 + - @tanstack/start-client-core@1.167.13 + +## 1.166.29 + +### Patch Changes + +- Updated dependencies [[`459057c`](https://github.com/TanStack/router/commit/459057cd2d90cff20d20e51d4964b0a8c950555e)]: + - @tanstack/start-client-core@1.167.12 + - @tanstack/solid-router@1.168.13 + - @tanstack/router-core@1.168.10 + +## 1.166.28 + +### Patch Changes + +- Updated dependencies [[`f8ac427`](https://github.com/TanStack/router/commit/f8ac427000c3fec99225926e72f9f2fc7a37231f)]: + - @tanstack/start-client-core@1.167.11 + +## 1.166.27 + +### Patch Changes + +- Updated dependencies [[`540d221`](https://github.com/TanStack/router/commit/540d22100d33415a1ddc9eb193f6aeb8184da77f)]: + - @tanstack/solid-router@1.168.12 + +## 1.166.26 + +### Patch Changes + +- Updated dependencies [[`b29d64d`](https://github.com/TanStack/router/commit/b29d64de0c400183114c12f82183f80e37d9ea5c)]: + - @tanstack/solid-router@1.168.11 + +## 1.166.25 + +### Patch Changes + +- Updated dependencies [[`4b9ed6c`](https://github.com/TanStack/router/commit/4b9ed6c5cb5437df8607c605728c8338dd2eb02c)]: + - @tanstack/solid-router@1.168.10 + +## 1.166.24 + +### Patch Changes + +- Updated dependencies [[`f7e9c5e`](https://github.com/TanStack/router/commit/f7e9c5e323793d1b28c96871819c265fd28ae397)]: + - @tanstack/start-client-core@1.167.10 + +## 1.166.23 + +### Patch Changes + +- Updated dependencies [[`796406d`](https://github.com/TanStack/router/commit/796406da66cfb12b518bb3ca326c9d541368fb06)]: + - @tanstack/router-core@1.168.9 + - @tanstack/solid-router@1.168.9 + - @tanstack/start-client-core@1.167.9 + +## 1.166.22 + +### Patch Changes + +- Updated dependencies [[`2d1ec86`](https://github.com/TanStack/router/commit/2d1ec865a446926f7db6e29dbbde82d265de6d36)]: + - @tanstack/router-core@1.168.8 + - @tanstack/solid-router@1.168.8 + - @tanstack/start-client-core@1.167.8 + +## 1.166.21 + +### Patch Changes + +- Updated dependencies [[`6ee0e79`](https://github.com/TanStack/router/commit/6ee0e795b085651beb2f1ac6503cdbd7eaffedd1)]: + - @tanstack/router-core@1.168.7 + - @tanstack/solid-router@1.168.7 + - @tanstack/start-client-core@1.167.7 + +## 1.166.20 + +### Patch Changes + +- Updated dependencies [[`42c3f3b`](https://github.com/TanStack/router/commit/42c3f3b3a3a478fd6d6894310ef94b2d23794b8e)]: + - @tanstack/router-core@1.168.6 + - @tanstack/solid-router@1.168.6 + - @tanstack/start-client-core@1.167.6 + +## 1.166.19 + +### Patch Changes + +- Updated dependencies [[`cf5f554`](https://github.com/TanStack/router/commit/cf5f5542476137a81515099ad740747e84512f9a)]: + - @tanstack/router-core@1.168.5 + - @tanstack/solid-router@1.168.5 + - @tanstack/start-client-core@1.167.5 + +## 1.166.18 + +### Patch Changes + +- Updated dependencies [[`71a8b68`](https://github.com/TanStack/router/commit/71a8b684c87c37fd4a033d99f5ba4a05c7a179f5)]: + - @tanstack/router-core@1.168.4 + - @tanstack/solid-router@1.168.4 + - @tanstack/start-client-core@1.167.4 + +## 1.166.17 + +### Patch Changes + +- Updated dependencies [[`d81d21a`](https://github.com/TanStack/router/commit/d81d21ad05c9401bf54b24acd29401e1e4fd624c)]: + - @tanstack/router-core@1.168.3 + - @tanstack/solid-router@1.168.3 + - @tanstack/start-client-core@1.167.3 + +## 1.166.16 + +### Patch Changes + +- Replace tiny-invariant and tiny-warning with in-house solution for bundle-size ([#7007](https://github.com/TanStack/router/pull/7007)) + +- Updated dependencies [[`c9e1855`](https://github.com/TanStack/router/commit/c9e18555f3a5531e96de8f574cfca9edcdb18e5c)]: + - @tanstack/start-client-core@1.167.2 + - @tanstack/solid-router@1.168.2 + - @tanstack/router-core@1.168.2 + +## 1.166.15 + +### Patch Changes + +- Updated dependencies [[`91cc628`](https://github.com/TanStack/router/commit/91cc62899b75ca920fe83c5ee7f3dbb5c71a523f)]: + - @tanstack/router-core@1.168.1 + - @tanstack/solid-router@1.168.1 + - @tanstack/start-client-core@1.167.1 + +## 1.166.14 + +### Patch Changes + +- Updated dependencies [[`0545239`](https://github.com/TanStack/router/commit/054523900b2ee19308e5a88417dadfc6923afe30)]: + - @tanstack/start-client-core@1.167.0 + - @tanstack/solid-router@1.168.0 + - @tanstack/router-core@1.168.0 + +## 1.166.13 + +### Patch Changes + +- Updated dependencies [[`5ff4f0b`](https://github.com/TanStack/router/commit/5ff4f0b8dce1fac2bb0b0bfe2684fc677a8ee505)]: + - @tanstack/router-core@1.167.5 + - @tanstack/solid-router@1.167.5 + - @tanstack/start-client-core@1.166.13 + +## 1.166.12 + +### Patch Changes + +- Updated dependencies [[`940151c`](https://github.com/TanStack/router/commit/940151cbed0c76c92a5cf196c0905b17a956ca7e)]: + - @tanstack/router-core@1.167.4 + - @tanstack/solid-router@1.167.4 + - @tanstack/start-client-core@1.166.12 + +## 1.166.11 + +### Patch Changes + +- Updated dependencies [[`32fcba7`](https://github.com/TanStack/router/commit/32fcba7b044b03f5901308b870f70b0b4910c220)]: + - @tanstack/router-core@1.167.3 + - @tanstack/solid-router@1.167.3 + - @tanstack/start-client-core@1.166.11 + +## 1.166.10 + +### Patch Changes + +- build: update to vite-config 5.x (rolldown) ([#6926](https://github.com/TanStack/router/pull/6926)) + +- Updated dependencies [[`838b0eb`](https://github.com/TanStack/router/commit/838b0eb9a8bbbb987a0a6972c1446e01423bbd7b)]: + - @tanstack/router-core@1.167.2 + - @tanstack/solid-router@1.167.2 + - @tanstack/start-client-core@1.166.10 + +## 1.166.9 + +### Patch Changes + +- fix: build with @tanstack/vite-config 0.4.3 ([#6923](https://github.com/TanStack/router/pull/6923)) + +- Updated dependencies [[`ef9b241`](https://github.com/TanStack/router/commit/ef9b241f3cfe95cee40daa96da669f0ffd4a971a)]: + - @tanstack/start-client-core@1.166.9 + - @tanstack/solid-router@1.167.1 + - @tanstack/router-core@1.167.1 + +## 1.166.8 + +### Patch Changes + +- Updated dependencies [[`6f297a2`](https://github.com/TanStack/router/commit/6f297a249424c0fd1c1a56aa4fc12c8217be7b6a)]: + - @tanstack/router-core@1.167.0 + - @tanstack/solid-router@1.167.0 + - @tanstack/start-client-core@1.166.8 diff --git a/packages/solid-start-client/package.json b/packages/solid-start-client/package.json index 197a972d29..70a3a00b0a 100644 --- a/packages/solid-start-client/package.json +++ b/packages/solid-start-client/package.json @@ -48,7 +48,19 @@ "default": "./dist/esm/index.js" } }, - "./package.json": "./package.json" + "./package.json": "./package.json", + "./hydration": { + "import": { + "types": "./dist/esm/hydration.d.ts", + "default": "./dist/esm/hydration.js" + } + }, + "./Hydrate": { + "import": { + "types": "./dist/esm/Hydrate.d.ts", + "default": "./dist/esm/Hydrate.js" + } + } }, "sideEffects": false, "files": [ diff --git a/packages/solid-start-client/src/GenericHydrate.tsx b/packages/solid-start-client/src/GenericHydrate.tsx new file mode 100644 index 0000000000..3e6bb08b45 --- /dev/null +++ b/packages/solid-start-client/src/GenericHydrate.tsx @@ -0,0 +1,433 @@ +import * as Solid from 'solid-js' +import { Dynamic } from '@solidjs/web' + +import { useHydrated } from '@tanstack/solid-router' +import { isServer } from '@tanstack/router-core/isServer' +import { + hydrateIdAttribute, + hydrateWhenAttribute, +} from '@tanstack/start-client-core/hydration/constants' +import { + createResolvedGate, + getFallbackHtml, + getOrCreateGate, + onGateResolve, + releaseGate, + runHydrationStrategyCleanup, + saveFallbackHtml, + waitForHydrationPrefetchStrategy, +} from '@tanstack/start-client-core/hydration/runtime' +import { listenForDelegatedHydrationIntent } from '@tanstack/start-client-core/hydration' +import type { + HydrationRuntimeContext, + HydrationStrategy, + HydrationWhen, +} from '@tanstack/start-client-core/hydration' +import type { HydrationGateRecord } from '@tanstack/start-client-core/hydration/runtime' +import type { InternalHydrateProps } from './Hydrate' +import type { DynamicProps, JSX } from '@solidjs/web' + +type HydrationFallbackDynamicProps = DynamicProps<'div'> +type HydrationMarkerDynamicProps = DynamicProps<'div'> & { + [hydrateIdAttribute]: string + [hydrateWhenAttribute]: HydrationWhen + [key: `data-${string}`]: string | undefined +} +type PrefetchController = { + abortController: AbortController + hydrationRequested: boolean + hydrationListeners: Set<() => void> + hydrationResolvePending: boolean + started: boolean + promise?: Promise<void> +} + +const hydrateIdSelector = `[${hydrateIdAttribute}]` +const dynamicType = 'dynamic' +const dynamicHydrateStrategy = { + _t: dynamicType, + _d: () => true, +} satisfies HydrationStrategy<typeof dynamicType, false> + +function shouldDeferHydration(strategy: HydrationStrategy) { + return strategy._d ? strategy._d() : strategy._t !== 'load' +} + +/* @__NO_SIDE_EFFECTS__ */ +function HydratedBoundary(props: { + id: string + onHydrated?: () => void + onStrategyHydrated?: (id: string) => void + children: JSX.Element +}) { + let didHydrate = false + + Solid.createEffect( + () => true, + () => { + if (didHydrate) return + didHydrate = true + props.onHydrated?.() + props.onStrategyHydrated?.(props.id) + }, + ) + + return props.children +} + +/* @__NO_SIDE_EFFECTS__ */ +export function GenericHydrate(props: InternalHydrateProps) { + const when = props.when + const dynamicHydrate = typeof when === 'function' + const initialHydrateStrategy: HydrationStrategy = dynamicHydrate + ? // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition + (isServer ?? typeof window === 'undefined') + ? dynamicHydrateStrategy + : when() + : when + const markerHydrateType: HydrationWhen = dynamicHydrate + ? dynamicType + : initialHydrateStrategy._t! + const prefetchStrategy = () => props.prefetch + const hydrated = useHydrated() + const uniqueId = Solid.createUniqueId() + const id = props.h ? `${props.h}${uniqueId}` : uniqueId + const initialHydrateType = initialHydrateStrategy._t! + const shouldPreserveServerHTML = + // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition + (isServer ?? typeof window === 'undefined') || !hydrated() + const shouldDeferInitialHydration = + !hydrated() && shouldDeferHydration(initialHydrateStrategy) + const gate: HydrationGateRecord = + // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition + (isServer ?? typeof window === 'undefined') + ? createResolvedGate(id, initialHydrateType) + : getOrCreateGate(id, initialHydrateType) + const [ready, setReady] = Solid.createSignal( + // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition + (isServer ?? typeof window === 'undefined') || + (!shouldDeferInitialHydration && initialHydrateType !== 'never'), + ) + const [prefetchError, setPrefetchError] = Solid.createSignal<unknown>() + const controller: PrefetchController = { + abortController: new AbortController(), + hydrationRequested: false, + hydrationListeners: new Set<() => void>(), + hydrationResolvePending: false, + started: false, + } + let didPrefetch = false + let didClearPreservedServerHTML = false + let markerElement: HTMLDivElement | undefined + let preservedServerChildNodes: Array<ChildNode> | undefined + let cleanupHydrationRuntime = () => {} + let didReleaseGate = false + + const clearPreservedServerHTML = () => { + if ( + !shouldPreserveServerHTML || + !shouldDeferInitialHydration || + !markerElement || + !preservedServerChildNodes || + didClearPreservedServerHTML + ) { + return + } + + didClearPreservedServerHTML = true + for (const child of preservedServerChildNodes) { + child.remove() + } + } + + if ( + // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition + !(isServer ?? typeof window === 'undefined') && + initialHydrateType !== 'never' && + (!shouldDeferInitialHydration || + !shouldDeferHydration(initialHydrateStrategy)) + ) { + gate.resolve() + } + + const onHydrate = (listener: () => void) => { + if (controller.hydrationRequested) { + listener() + return () => {} + } + + controller.hydrationListeners.add(listener) + return () => { + controller.hydrationListeners.delete(listener) + } + } + + const requestHydration = () => { + if (!controller.hydrationRequested) { + controller.hydrationRequested = true + controller.hydrationListeners.forEach((listener) => listener()) + controller.hydrationListeners.clear() + } + + if (!controller.promise) { + resolveGate() + return + } + if (controller.hydrationResolvePending) return + controller.hydrationResolvePending = true + + controller.promise.then( + () => resolveGate(), + (error) => { + if (!controller.abortController.signal.aborted) { + setPrefetchError(() => error) + } + }, + ) + } + const resolveGate = gate.resolve + + Solid.onCleanup(() => { + controller.abortController.abort() + controller.hydrationListeners.clear() + cleanupHydrationRuntime() + if (!didReleaseGate) { + didReleaseGate = true + releaseGate(gate) + } + }) + + Solid.createEffect( + () => { + const currentHydrateStrategy = initialHydrateStrategy + const currentPrefetchStrategy = prefetchStrategy() + const currentHydrateType = currentHydrateStrategy._t! + + return { + currentHydrateStrategy, + currentPrefetchStrategy, + currentHydrateType, + } + }, + ({ + currentHydrateStrategy, + currentPrefetchStrategy, + currentHydrateType, + }) => { + gate.when = currentHydrateType + for (const element of document.querySelectorAll<HTMLDivElement>( + hydrateIdSelector, + )) { + if (element.getAttribute(hydrateIdAttribute) === id) { + markerElement = element + preservedServerChildNodes ??= Array.from(element.childNodes) + saveFallbackHtml(id, element) + break + } + } + + if ( + currentHydrateType === 'never' && + !shouldPreserveServerHTML && + markerElement + ) { + markerElement.replaceChildren() + } + + if (currentPrefetchStrategy && !controller.started) { + controller.started = true + const preload = () => props.p?.() ?? Promise.resolve() + + if (typeof currentPrefetchStrategy === 'function') { + const promise = Promise.resolve() + .then(() => + currentPrefetchStrategy({ + element: markerElement ?? null, + signal: controller.abortController.signal, + preload, + waitFor: (strategy) => + waitForHydrationPrefetchStrategy(strategy, { + element: markerElement ?? null, + signal: controller.abortController.signal, + onHydrate, + }), + }), + ) + .then(() => undefined) + + controller.promise = promise + promise.catch((error) => { + if (!controller.abortController.signal.aborted) { + setPrefetchError(() => error) + } + }) + } else if (props.p) { + const currentStrategy = currentPrefetchStrategy + const prefetch = () => { + if (didPrefetch) return + didPrefetch = true + void preload() + } + const cleanupPrefetch = runHydrationStrategyCleanup( + currentStrategy._s?.({ + element: markerElement ?? null, + prefetch, + }), + ) + if (cleanupPrefetch) Solid.onCleanup(cleanupPrefetch) + } + } + + if ( + currentHydrateType !== 'never' && + (!shouldDeferInitialHydration || + !shouldDeferHydration(currentHydrateStrategy)) + ) { + gate.resolve() + setReady(true) + } + + const cleanups: Array<() => void> = [] + let removeResolveListener = () => {} + let disposed = false + + const resolveBoundary = () => { + setReady(true) + } + + const cleanup = () => { + if (disposed) return + disposed = true + if (gate.resolve === requestHydration) { + gate.resolve = resolveGate + } + removeResolveListener() + cleanups.forEach((fn) => fn()) + } + cleanupHydrationRuntime = cleanup + + const addCleanup = (fn: void | (() => void)) => { + if (!fn) return + if (disposed || gate.resolved) { + fn() + return + } + cleanups.push(fn) + } + + Solid.onCleanup(cleanup) + + removeResolveListener = onGateResolve(gate, () => { + cleanup() + resolveBoundary() + }) + + if ( + gate.resolved || + !shouldDeferInitialHydration || + currentHydrateType === 'never' + ) { + if (gate.resolved) resolveBoundary() + return + } + + gate.resolve = requestHydration + const context: HydrationRuntimeContext = { + element: markerElement ?? null, + gate, + } + addCleanup( + runHydrationStrategyCleanup(currentHydrateStrategy._s?.(context)), + ) + + if (currentHydrateStrategy._t !== 'interaction') { + addCleanup( + runHydrationStrategyCleanup( + markerElement + ? listenForDelegatedHydrationIntent(markerElement, context) + : undefined, + ), + ) + } + }, + ) + + Solid.createRenderEffect( + () => + !( + ( + // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition + (isServer ?? typeof window === 'undefined') || + gate.resolved || + initialHydrateStrategy._t === 'never' || + shouldDeferHydration(initialHydrateStrategy) + ) + ), + (shouldResolve) => { + if (shouldResolve) { + gate.resolve() + } + }, + ) + + const markerAttributes = + markerHydrateType === dynamicType + ? undefined + : initialHydrateStrategy._a?.() + const markerProps: HydrationMarkerDynamicProps = { + component: 'div', + [hydrateIdAttribute]: id, + [hydrateWhenAttribute]: markerHydrateType, + ...markerAttributes, + } + const fallback = () => { + if (!shouldPreserveServerHTML) return props.fallback ?? null + + const html = getFallbackHtml(id) + if (!html) return null + + const fallbackProps: HydrationFallbackDynamicProps = { + component: 'div', + style: { display: 'contents' }, + innerHTML: html, + } + + return <Dynamic {...fallbackProps} /> + } + const hydratedChildren = () => { + const children = ( + <HydratedBoundary + id={id} + onHydrated={props.onHydrated} + onStrategyHydrated={(id) => { + clearPreservedServerHTML() + markerElement?.removeAttribute(hydrateWhenAttribute) + initialHydrateStrategy._o?.(id) + }} + > + {props.children} + </HydratedBoundary> + ) + + return children + } + + return ( + <Dynamic {...markerProps}> + {(() => { + const error = prefetchError() + if (error) throw error + return null + })()} + {initialHydrateType === 'never' && !shouldPreserveServerHTML ? ( + (props.fallback ?? null) + ) : ( + <Solid.Loading fallback={fallback()}> + <Solid.Show when={ready()} fallback={fallback()}> + {hydratedChildren()} + </Solid.Show> + </Solid.Loading> + )} + </Dynamic> + ) +} diff --git a/packages/solid-start-client/src/Hydrate.tsx b/packages/solid-start-client/src/Hydrate.tsx new file mode 100644 index 0000000000..1dccb9bc9c --- /dev/null +++ b/packages/solid-start-client/src/Hydrate.tsx @@ -0,0 +1,75 @@ +import { GenericHydrate } from './GenericHydrate' +import type { + HydrationStrategy as CoreHydrationStrategy, + HydrationPrefetchFunction, + HydrationPrefetchStrategy, + HydrationWhen, +} from '@tanstack/start-client-core/hydration' +import type { JSX } from '@solidjs/web' + +export type { + HydrationInteractionEvent, + HydrationInteractionEvents, + HydrationPrefetchContext, + HydrationPrefetchFunction, + HydrationPrefetchStrategy, + HydrationPrefetchWaitReason, + HydrationWhen, +} from '@tanstack/start-client-core/hydration' + +export type SolidHydrationStrategy< + TWhen extends HydrationWhen = HydrationWhen, + TCanPrefetch extends boolean = boolean, +> = CoreHydrationStrategy<TWhen, TCanPrefetch> & { + _h: (props: HydrateProps) => JSX.Element +} + +export type HydrationStrategy< + TWhen extends HydrationWhen = HydrationWhen, + TCanPrefetch extends boolean = boolean, +> = SolidHydrationStrategy<TWhen, TCanPrefetch> + +export type HydrateWhen = + | SolidHydrationStrategy + | (() => SolidHydrationStrategy) + +type HydrateCommonOptions = { + when: HydrateWhen + fallback?: JSX.Element + onHydrated?: () => void +} + +export type HydrateOptions = + | (HydrateCommonOptions & { + prefetch?: never + split?: boolean + }) + | (HydrateCommonOptions & { + prefetch: HydrationPrefetchStrategy + split?: true + }) + | (HydrateCommonOptions & { + prefetch: HydrationPrefetchFunction + split?: boolean + }) + +export type HydrateProps = HydrateOptions & { + children: JSX.Element +} + +export type InternalHydrateProps = HydrateProps & { + h?: string + p?: () => Promise<void> +} + +/* @__NO_SIDE_EFFECTS__ */ +export function Hydrate(props: HydrateProps) { + if ( + typeof props.when === 'function' || + typeof props.prefetch === 'function' + ) { + return <GenericHydrate {...(props as InternalHydrateProps)} /> + } + + return props.when._h(props) +} diff --git a/packages/solid-start-client/src/hydration.ts b/packages/solid-start-client/src/hydration.ts new file mode 100644 index 0000000000..bd875dcb0a --- /dev/null +++ b/packages/solid-start-client/src/hydration.ts @@ -0,0 +1,20 @@ +export { condition, interaction, media } from './hydration/generic' +export { idle } from './hydration/idle' +export { load } from './hydration/load' +export { never } from './hydration/never' +export { visible } from './hydration/visible' +export type { + HydrationCondition, + HydrationInteractionEvent, + HydrationInteractionEvents, + IdleHydrationOptions, + HydrationPrefetchContext, + HydrationPrefetchFunction, + HydrationPrefetchWhen, + HydrationPrefetchStrategy, + HydrationPrefetchWaitReason, + HydrationStrategyTypes, + HydrationWhen, + VisibleHydrationOptions, +} from '@tanstack/start-client-core/hydration' +export type { HydrationStrategy, SolidHydrationStrategy } from './Hydrate' diff --git a/packages/solid-start-client/src/hydration/generic.ts b/packages/solid-start-client/src/hydration/generic.ts new file mode 100644 index 0000000000..bfc1e8db9f --- /dev/null +++ b/packages/solid-start-client/src/hydration/generic.ts @@ -0,0 +1,41 @@ +import { + condition as coreCondition, + interaction as coreInteraction, + media as coreMedia, + withHydrationRenderer, +} from '@tanstack/start-client-core/hydration' +import { GenericHydrate } from '../GenericHydrate' +import type { + HydrationCondition, + HydrationInteractionEvents, + HydrationPrefetchStrategy, +} from '@tanstack/start-client-core/hydration' +import type { SolidHydrationStrategy } from '../Hydrate' + +/* @__NO_SIDE_EFFECTS__ */ +export function media( + query: string, +): SolidHydrationStrategy<'media', true> & HydrationPrefetchStrategy<'media'> { + return /* @__PURE__ */ withHydrationRenderer(coreMedia(query), GenericHydrate) +} + +/* @__NO_SIDE_EFFECTS__ */ +export function condition( + condition: HydrationCondition, +): SolidHydrationStrategy<'condition', false> { + return /* @__PURE__ */ withHydrationRenderer( + coreCondition(condition), + GenericHydrate, + ) +} + +/* @__NO_SIDE_EFFECTS__ */ +export function interaction(options?: { + events?: HydrationInteractionEvents +}): SolidHydrationStrategy<'interaction', true> & + HydrationPrefetchStrategy<'interaction'> { + return /* @__PURE__ */ withHydrationRenderer( + coreInteraction(options), + GenericHydrate, + ) +} diff --git a/packages/solid-start-client/src/hydration/idle.ts b/packages/solid-start-client/src/hydration/idle.ts new file mode 100644 index 0000000000..89282b0a95 --- /dev/null +++ b/packages/solid-start-client/src/hydration/idle.ts @@ -0,0 +1,20 @@ +import { + idle as coreIdle, + withHydrationRenderer, +} from '@tanstack/start-client-core/hydration' +import { GenericHydrate } from '../GenericHydrate' +import type { + HydrationPrefetchStrategy, + IdleHydrationOptions, +} from '@tanstack/start-client-core/hydration' +import type { SolidHydrationStrategy } from '../Hydrate' + +/* @__NO_SIDE_EFFECTS__ */ +export function idle( + options: IdleHydrationOptions = {}, +): SolidHydrationStrategy<'idle', true> & HydrationPrefetchStrategy<'idle'> { + return /* @__PURE__ */ withHydrationRenderer( + coreIdle(options), + GenericHydrate, + ) +} diff --git a/packages/solid-start-client/src/hydration/load.tsx b/packages/solid-start-client/src/hydration/load.tsx new file mode 100644 index 0000000000..a2836231e8 --- /dev/null +++ b/packages/solid-start-client/src/hydration/load.tsx @@ -0,0 +1,13 @@ +import { + load as coreLoad, + withHydrationRenderer, +} from '@tanstack/start-client-core/hydration' +import { GenericHydrate } from '../GenericHydrate' +import type { HydrationPrefetchStrategy } from '@tanstack/start-client-core/hydration' +import type { SolidHydrationStrategy } from '../Hydrate' + +/* @__NO_SIDE_EFFECTS__ */ +export function load(): SolidHydrationStrategy<'load', true> & + HydrationPrefetchStrategy<'load'> { + return /* @__PURE__ */ withHydrationRenderer(coreLoad(), GenericHydrate) +} diff --git a/packages/solid-start-client/src/hydration/never.ts b/packages/solid-start-client/src/hydration/never.ts new file mode 100644 index 0000000000..36513b95d4 --- /dev/null +++ b/packages/solid-start-client/src/hydration/never.ts @@ -0,0 +1,11 @@ +import { + never as coreNever, + withHydrationRenderer, +} from '@tanstack/start-client-core/hydration' +import { GenericHydrate } from '../GenericHydrate' +import type { SolidHydrationStrategy } from '../Hydrate' + +/* @__NO_SIDE_EFFECTS__ */ +export function never(): SolidHydrationStrategy<'never', false> { + return /* @__PURE__ */ withHydrationRenderer(coreNever(), GenericHydrate) +} diff --git a/packages/solid-start-client/src/hydration/visible.tsx b/packages/solid-start-client/src/hydration/visible.tsx new file mode 100644 index 0000000000..c747c236ec --- /dev/null +++ b/packages/solid-start-client/src/hydration/visible.tsx @@ -0,0 +1,21 @@ +import { + visible as coreVisible, + withHydrationRenderer, +} from '@tanstack/start-client-core/hydration' +import { GenericHydrate } from '../GenericHydrate' +import type { + HydrationPrefetchStrategy, + VisibleHydrationOptions, +} from '@tanstack/start-client-core/hydration' +import type { SolidHydrationStrategy } from '../Hydrate' + +/* @__NO_SIDE_EFFECTS__ */ +export function visible( + options?: VisibleHydrationOptions, +): SolidHydrationStrategy<'visible', true> & + HydrationPrefetchStrategy<'visible'> { + return /* @__PURE__ */ withHydrationRenderer( + coreVisible(options), + GenericHydrate, + ) +} diff --git a/packages/solid-start-client/src/tests/Hydrate.test-d.tsx b/packages/solid-start-client/src/tests/Hydrate.test-d.tsx new file mode 100644 index 0000000000..4dd2df597b --- /dev/null +++ b/packages/solid-start-client/src/tests/Hydrate.test-d.tsx @@ -0,0 +1,147 @@ +import { expectTypeOf, test } from 'vitest' +import { visible } from '../hydration' +import { Hydrate } from '../Hydrate' +import type { + HydrateOptions, + HydrateProps, + HydrationPrefetchFunction, + HydrationPrefetchStrategy, + HydrationStrategy, +} from '../Hydrate' +import type { HydrationStrategy as CoreHydrationStrategy } from '@tanstack/start-client-core/hydration' +import type { JSX } from '@solidjs/web' + +type CommonHydrateProps = { + fallback?: JSX.Element + onHydrated?: () => void + children: JSX.Element +} + +type SplitHydrateProps = CommonHydrateProps & { + when: HydrationStrategy | (() => HydrationStrategy) + prefetch?: never + split?: boolean +} + +type PrefetchHydrateProps = CommonHydrateProps & { + when: HydrationStrategy | (() => HydrationStrategy) + prefetch: HydrationPrefetchStrategy + split?: true +} + +type FunctionPrefetchHydrateProps = CommonHydrateProps & { + when: HydrationStrategy | (() => HydrationStrategy) + prefetch: HydrationPrefetchFunction + split?: boolean +} + +test('Hydrate component accepts the public HydrateProps type', () => { + expectTypeOf(Hydrate).toBeFunction() + expectTypeOf(Hydrate).parameter(0).branded.toEqualTypeOf<HydrateProps>() +}) + +test('HydrateOptions supports reusable spread props', () => { + const belowFoldProps = { + when: () => visible({ rootMargin: '800px' }), + } satisfies HydrateOptions + + expectTypeOf(belowFoldProps).toMatchTypeOf<HydrateOptions>() + + const withFunctionPrefetch = { + when: visible(), + split: false, + prefetch: (ctx) => { + expectTypeOf(ctx.element).toEqualTypeOf<Element | null>() + expectTypeOf(ctx.signal).toEqualTypeOf<AbortSignal>() + expectTypeOf(ctx.preload).returns.toEqualTypeOf<Promise<void>>() + expectTypeOf(ctx.waitFor).returns.toEqualTypeOf< + Promise<'prefetch' | 'hydrate' | 'abort'> + >() + }, + } satisfies HydrateOptions + + expectTypeOf(withFunctionPrefetch).toMatchTypeOf<HydrateOptions>() +}) + +test('Hydrate props are exact for strategy and prefetch forms', () => { + expectTypeOf< + Extract<HydrateProps, { prefetch?: never }> + >().branded.toEqualTypeOf<SplitHydrateProps>() + expectTypeOf< + Extract<HydrateProps, { prefetch: HydrationPrefetchStrategy }> + >().branded.toEqualTypeOf<PrefetchHydrateProps>() + expectTypeOf< + Extract<HydrateProps, { prefetch: HydrationPrefetchFunction }> + >().branded.toEqualTypeOf<FunctionPrefetchHydrateProps>() +}) + +test('Hydrate requires a strategy', () => { + expectTypeOf<{ + when: HydrationStrategy + children: JSX.Element + }>().toMatchTypeOf<HydrateProps>() + + expectTypeOf<{ + when: () => HydrationStrategy + children: JSX.Element + }>().toMatchTypeOf<HydrateProps>() + + expectTypeOf<{ + children: JSX.Element + }>().not.toMatchTypeOf<HydrateProps>() + + expectTypeOf<{ + when: () => true + children: JSX.Element + }>().not.toMatchTypeOf<HydrateProps>() + + expectTypeOf<{ + when: false + children: JSX.Element + }>().not.toMatchTypeOf<HydrateProps>() +}) + +test('Hydrate requires a framework-renderable strategy', () => { + expectTypeOf<CoreHydrationStrategy>().not.toMatchTypeOf<HydrationStrategy>() + expectTypeOf<ReturnType<typeof visible>>().toMatchTypeOf<HydrationStrategy>() + + expectTypeOf<{ + when: CoreHydrationStrategy + children: JSX.Element + }>().not.toMatchTypeOf<HydrateProps>() +}) + +test('Hydrate enforces prefetch only with split boundaries', () => { + expectTypeOf<{ + when: HydrationStrategy + prefetch: HydrationPrefetchStrategy + children: JSX.Element + }>().toMatchTypeOf<HydrateProps>() + + expectTypeOf<{ + when: HydrationStrategy + prefetch: HydrationPrefetchStrategy + split: true + children: JSX.Element + }>().toMatchTypeOf<HydrateProps>() + + expectTypeOf<{ + when: HydrationStrategy + prefetch: HydrationPrefetchStrategy + split: false + children: JSX.Element + }>().not.toMatchTypeOf<HydrateProps>() + + expectTypeOf<{ + when: HydrationStrategy + prefetch: HydrationPrefetchFunction + split: false + children: JSX.Element + }>().toMatchTypeOf<HydrateProps>() + + expectTypeOf<{ + when: HydrationStrategy + prefetch: HydrationPrefetchFunction + children: JSX.Element + }>().toMatchTypeOf<HydrateProps>() +}) diff --git a/packages/solid-start-client/vite.config.ts b/packages/solid-start-client/vite.config.ts index be71bab518..dbfb60ea03 100644 --- a/packages/solid-start-client/vite.config.ts +++ b/packages/solid-start-client/vite.config.ts @@ -20,7 +20,7 @@ export default mergeConfig( tanstackViteConfig({ tsconfigPath: './tsconfig.build.json', srcDir: './src', - entry: './src/index.tsx', + entry: ['./src/index.tsx', './src/Hydrate.tsx', './src/hydration.ts'], cjs: false, }), ) diff --git a/packages/solid-start-server/CHANGELOG.md b/packages/solid-start-server/CHANGELOG.md index 3b7264b4fb..838e3f35b1 100644 --- a/packages/solid-start-server/CHANGELOG.md +++ b/packages/solid-start-server/CHANGELOG.md @@ -339,3 +339,546 @@ - @tanstack/solid-router@1.167.0 - @tanstack/start-client-core@1.166.8 - @tanstack/start-server-core@1.166.8 + +## 1.167.13 + +### Patch Changes + +- Updated dependencies [[`9cb7a00`](https://github.com/TanStack/router/commit/9cb7a003e6e5fa3706711870c7b10a5266356e3b)]: + - @tanstack/start-server-core@1.169.8 + +## 1.167.12 + +### Patch Changes + +- Updated dependencies [[`2f53749`](https://github.com/TanStack/router/commit/2f5374945e2138559a51464f45a5152eae67e1dd)]: + - @tanstack/router-core@1.171.8 + - @tanstack/solid-router@1.170.10 + - @tanstack/start-client-core@1.170.6 + - @tanstack/start-server-core@1.169.7 + +## 1.167.11 + +### Patch Changes + +- Updated dependencies [[`d1997b6`](https://github.com/TanStack/router/commit/d1997b66d7c24c1d64772bb8bab5caf9c6d9cc48)]: + - @tanstack/start-server-core@1.169.6 + - @tanstack/solid-router@1.170.9 + - @tanstack/router-core@1.171.7 + - @tanstack/start-client-core@1.170.5 + +## 1.167.10 + +### Patch Changes + +- Updated dependencies [[`9c09bca`](https://github.com/TanStack/router/commit/9c09bca59e9613e9a6fd9b7149b0737898e705d6)]: + - @tanstack/start-server-core@1.169.5 + +## 1.167.9 + +### Patch Changes + +- Updated dependencies [[`a82cec6`](https://github.com/TanStack/router/commit/a82cec69474c366b36efdb3f43c4efe8311c485a), [`d8be4f8`](https://github.com/TanStack/router/commit/d8be4f8adf912128c96b7f83e9a6c49fb24b5eed)]: + - @tanstack/start-client-core@1.170.4 + - @tanstack/start-server-core@1.169.4 + +## 1.167.8 + +### Patch Changes + +- Updated dependencies [[`51a97a1`](https://github.com/TanStack/router/commit/51a97a167fb3ef1b8ca70fbb63db635158f43509)]: + - @tanstack/router-core@1.171.6 + - @tanstack/solid-router@1.170.8 + - @tanstack/start-server-core@1.169.3 + - @tanstack/start-client-core@1.170.3 + +## 1.167.7 + +### Patch Changes + +- Updated dependencies [[`5268ba4`](https://github.com/TanStack/router/commit/5268ba4566233ea58880df85f167ad0401a93a46)]: + - @tanstack/router-core@1.171.5 + - @tanstack/solid-router@1.170.7 + - @tanstack/start-client-core@1.170.2 + - @tanstack/start-server-core@1.169.2 + +## 1.167.6 + +### Patch Changes + +- Updated dependencies [[`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960), [`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960)]: + - @tanstack/router-core@1.171.4 + - @tanstack/solid-router@1.170.6 + - @tanstack/start-client-core@1.170.1 + - @tanstack/start-server-core@1.169.1 + +## 1.167.5 + +### Patch Changes + +- Updated dependencies [[`5fa9e55`](https://github.com/TanStack/router/commit/5fa9e555f3a2edb5e45586623e6bcbfa7f7c7a6b)]: + - @tanstack/start-client-core@1.170.0 + - @tanstack/start-server-core@1.169.0 + - @tanstack/router-core@1.171.3 + - @tanstack/solid-router@1.170.5 + +## 1.167.4 + +### Patch Changes + +- Updated dependencies [[`b60eb36`](https://github.com/TanStack/router/commit/b60eb36e59e8a468ee0742cbcf7f47aca1ff1c67)]: + - @tanstack/router-core@1.171.2 + - @tanstack/solid-router@1.170.4 + - @tanstack/start-client-core@1.169.4 + - @tanstack/start-server-core@1.168.4 + +## 1.167.3 + +### Patch Changes + +- Updated dependencies [[`d9cf933`](https://github.com/TanStack/router/commit/d9cf9331b83fcbd2abfee75d839d862f9bb18e6b)]: + - @tanstack/router-core@1.171.1 + - @tanstack/solid-router@1.170.3 + - @tanstack/start-client-core@1.169.3 + - @tanstack/start-server-core@1.168.3 + +## 1.167.2 + +### Patch Changes + +- Updated dependencies [[`d533f87`](https://github.com/TanStack/router/commit/d533f87976704098a40b48f160b37c28c8182806)]: + - @tanstack/router-core@1.171.0 + - @tanstack/solid-router@1.170.2 + - @tanstack/start-client-core@1.169.2 + - @tanstack/start-server-core@1.168.2 + +## 1.167.1 + +### Patch Changes + +- Updated dependencies [[`2387a2e`](https://github.com/TanStack/router/commit/2387a2eea0683004cc400b9f71bed5944eb60110)]: + - @tanstack/router-core@1.170.1 + - @tanstack/start-server-core@1.168.1 + - @tanstack/solid-router@1.170.1 + - @tanstack/start-client-core@1.169.1 + +## 1.167.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- Updated dependencies [[`b1c061a`](https://github.com/TanStack/router/commit/b1c061aff9185cdf5fdc08c0136382a9dce0302f), [`201e150`](https://github.com/TanStack/router/commit/201e150bd1412bae2faa9ce53f0fefcb7574ac14), [`5ae2ae5`](https://github.com/TanStack/router/commit/5ae2ae5e0f8ce32e02667a482ea9be52a6150240)]: + - @tanstack/router-core@1.170.0 + - @tanstack/history@1.162.0 + - @tanstack/solid-router@1.170.0 + - @tanstack/start-client-core@1.169.0 + - @tanstack/start-server-core@1.168.0 + +## 1.166.51 + +### Patch Changes + +- Updated dependencies [[`35e88f0`](https://github.com/TanStack/router/commit/35e88f04996d71019a1868b7b06ecb4ddbc9df9e)]: + - @tanstack/router-core@1.169.2 + - @tanstack/start-client-core@1.168.2 + - @tanstack/start-server-core@1.167.30 + - @tanstack/solid-router@1.169.2 + +## 1.166.50 + +### Patch Changes + +- Updated dependencies [[`afa40ef`](https://github.com/TanStack/router/commit/afa40ef46c273c53646ba33f607fc618a07ffede)]: + - @tanstack/start-server-core@1.167.29 + +## 1.166.49 + +### Patch Changes + +- Add opt-in Start response Link headers for collected Early Hints. ([#7327](https://github.com/TanStack/router/pull/7327)) + +- Updated dependencies [[`709627f`](https://github.com/TanStack/router/commit/709627f3dbc6d97daa547a1401ef42a53bc4be32)]: + - @tanstack/start-server-core@1.167.28 + +## 1.166.48 + +### Patch Changes + +- Add experimental HTTP 103 Early Hints support to Start server handlers. ([#7324](https://github.com/TanStack/router/pull/7324)) + +- Updated dependencies [[`238ea4a`](https://github.com/TanStack/router/commit/238ea4a4998ab3a7fd528b317e1935766ac65df8)]: + - @tanstack/start-server-core@1.167.27 + +## 1.166.47 + +### Patch Changes + +- Updated dependencies [[`4a1e63f`](https://github.com/TanStack/router/commit/4a1e63f1d1230b1ed8234609acad4639d8982c13)]: + - @tanstack/router-core@1.169.1 + - @tanstack/solid-router@1.169.1 + - @tanstack/start-client-core@1.168.1 + - @tanstack/start-server-core@1.167.26 + +## 1.166.46 + +### Patch Changes + +- Updated dependencies [[`82b0613`](https://github.com/TanStack/router/commit/82b06132af776f74603ab27977cc277d6219a845)]: + - @tanstack/start-client-core@1.168.0 + - @tanstack/start-server-core@1.167.25 + +## 1.166.45 + +### Patch Changes + +- Updated dependencies [[`c992495`](https://github.com/TanStack/router/commit/c992495bf4010ff4c3597bb1f3b1ba02594e857e)]: + - @tanstack/router-core@1.169.0 + - @tanstack/solid-router@1.169.0 + - @tanstack/start-client-core@1.167.22 + - @tanstack/start-server-core@1.167.24 + +## 1.166.44 + +### Patch Changes + +- Updated dependencies [[`b5c4183`](https://github.com/TanStack/router/commit/b5c4183ab8b44be8a75647b7f7b588ad7c146ece)]: + - @tanstack/router-core@1.168.18 + - @tanstack/solid-router@1.168.26 + - @tanstack/start-client-core@1.167.21 + - @tanstack/start-server-core@1.167.23 + +## 1.166.43 + +### Patch Changes + +- Updated dependencies [[`493148b`](https://github.com/TanStack/router/commit/493148bc5378b7f9de1544d87f6aaa425c12eb34)]: + - @tanstack/router-core@1.168.17 + - @tanstack/solid-router@1.168.25 + - @tanstack/start-client-core@1.167.20 + - @tanstack/start-server-core@1.167.22 + +## 1.166.42 + +### Patch Changes + +- Updated dependencies [[`944b155`](https://github.com/TanStack/router/commit/944b1558965bf038eaf3c0dfb9e1ac3800d6fd3a)]: + - @tanstack/solid-router@1.168.24 + +## 1.166.41 + +### Patch Changes + +- Updated dependencies [[`41e37f8`](https://github.com/TanStack/router/commit/41e37f8a9c3d2a6e00e4ca6faabb6a596bc36a98), [`e054474`](https://github.com/TanStack/router/commit/e054474cd1df6f93cd69dd5d255013840441438e)]: + - @tanstack/solid-router@1.168.23 + +## 1.166.40 + +### Patch Changes + +- Updated dependencies [[`b732c8a`](https://github.com/TanStack/router/commit/b732c8ac26bd3b316e95b026ca2fc7c2c78a1ddd), [`d20c878`](https://github.com/TanStack/router/commit/d20c87813559ff00d0b4810c4b600d47b47eff2f)]: + - @tanstack/solid-router@1.168.22 + +## 1.166.39 + +### Patch Changes + +- Updated dependencies [[`8b97002`](https://github.com/TanStack/router/commit/8b97002af3f6d15204e60c55d3f5735b78bd7efe)]: + - @tanstack/start-client-core@1.167.19 + - @tanstack/start-server-core@1.167.21 + +## 1.166.38 + +### Patch Changes + +- Updated dependencies [[`4d864ee`](https://github.com/TanStack/router/commit/4d864eebbd184265eabb563d326ab409c93feb17)]: + - @tanstack/router-core@1.168.16 + - @tanstack/solid-router@1.168.21 + - @tanstack/start-server-core@1.167.20 + - @tanstack/start-client-core@1.167.18 + +## 1.166.37 + +### Patch Changes + +- Updated dependencies [[`22dc152`](https://github.com/TanStack/router/commit/22dc15203379da15e6eaa225e61696039380aedd)]: + - @tanstack/solid-router@1.168.20 + +## 1.166.36 + +### Patch Changes + +- Updated dependencies [[`16f6892`](https://github.com/TanStack/router/commit/16f6892d6b7ceadf606677c5a40e743f29163aa6)]: + - @tanstack/router-core@1.168.15 + - @tanstack/solid-router@1.168.19 + - @tanstack/start-client-core@1.167.17 + - @tanstack/start-server-core@1.167.19 + +## 1.166.35 + +### Patch Changes + +- Updated dependencies [[`105d056`](https://github.com/TanStack/router/commit/105d05691a247779a63e7b688aa1207cce619339)]: + - @tanstack/solid-router@1.168.18 + +## 1.166.34 + +### Patch Changes + +- Updated dependencies [[`0e2c900`](https://github.com/TanStack/router/commit/0e2c9003c18ae07c09969189c028f277ea562a7a)]: + - @tanstack/start-server-core@1.167.18 + - @tanstack/router-core@1.168.14 + - @tanstack/solid-router@1.168.17 + - @tanstack/start-client-core@1.167.16 + +## 1.166.33 + +### Patch Changes + +- Updated dependencies [[`812792f`](https://github.com/TanStack/router/commit/812792fbda3caf97b300770855cf5641252f413b)]: + - @tanstack/router-core@1.168.13 + - @tanstack/start-server-core@1.167.17 + - @tanstack/solid-router@1.168.16 + - @tanstack/start-client-core@1.167.15 + +## 1.166.32 + +### Patch Changes + +- Updated dependencies [[`8ec9ca9`](https://github.com/TanStack/router/commit/8ec9ca97b472779de878c2a6510f21deb24d386c)]: + - @tanstack/router-core@1.168.12 + - @tanstack/solid-router@1.168.15 + - @tanstack/start-client-core@1.167.14 + - @tanstack/start-server-core@1.167.16 + +## 1.166.31 + +### Patch Changes + +- Updated dependencies [[`6355bb7`](https://github.com/TanStack/router/commit/6355bb75f7637ba77f06a923c18fdaf37720bb48)]: + - @tanstack/start-server-core@1.167.15 + - @tanstack/solid-router@1.168.14 + - @tanstack/router-core@1.168.11 + - @tanstack/start-client-core@1.167.13 + +## 1.166.30 + +### Patch Changes + +- Updated dependencies [[`459057c`](https://github.com/TanStack/router/commit/459057cd2d90cff20d20e51d4964b0a8c950555e)]: + - @tanstack/start-client-core@1.167.12 + - @tanstack/start-server-core@1.167.14 + - @tanstack/solid-router@1.168.13 + - @tanstack/router-core@1.168.10 + +## 1.166.29 + +### Patch Changes + +- Updated dependencies [[`f8ac427`](https://github.com/TanStack/router/commit/f8ac427000c3fec99225926e72f9f2fc7a37231f)]: + - @tanstack/start-server-core@1.167.13 + - @tanstack/start-client-core@1.167.11 + +## 1.166.28 + +### Patch Changes + +- Updated dependencies [[`2d53c05`](https://github.com/TanStack/router/commit/2d53c056ef0b203de8a28bc92c24e8e604205d52)]: + - @tanstack/start-server-core@1.167.12 + +## 1.166.27 + +### Patch Changes + +- Updated dependencies [[`540d221`](https://github.com/TanStack/router/commit/540d22100d33415a1ddc9eb193f6aeb8184da77f)]: + - @tanstack/solid-router@1.168.12 + +## 1.166.26 + +### Patch Changes + +- Updated dependencies [[`b29d64d`](https://github.com/TanStack/router/commit/b29d64de0c400183114c12f82183f80e37d9ea5c)]: + - @tanstack/solid-router@1.168.11 + +## 1.166.25 + +### Patch Changes + +- Updated dependencies [[`4b9ed6c`](https://github.com/TanStack/router/commit/4b9ed6c5cb5437df8607c605728c8338dd2eb02c)]: + - @tanstack/solid-router@1.168.10 + +## 1.166.24 + +### Patch Changes + +- Updated dependencies [[`f7e9c5e`](https://github.com/TanStack/router/commit/f7e9c5e323793d1b28c96871819c265fd28ae397)]: + - @tanstack/start-client-core@1.167.10 + - @tanstack/start-server-core@1.167.10 + +## 1.166.23 + +### Patch Changes + +- Updated dependencies [[`796406d`](https://github.com/TanStack/router/commit/796406da66cfb12b518bb3ca326c9d541368fb06)]: + - @tanstack/router-core@1.168.9 + - @tanstack/solid-router@1.168.9 + - @tanstack/start-client-core@1.167.9 + - @tanstack/start-server-core@1.167.9 + +## 1.166.22 + +### Patch Changes + +- Updated dependencies [[`2d1ec86`](https://github.com/TanStack/router/commit/2d1ec865a446926f7db6e29dbbde82d265de6d36)]: + - @tanstack/router-core@1.168.8 + - @tanstack/solid-router@1.168.8 + - @tanstack/start-client-core@1.167.8 + - @tanstack/start-server-core@1.167.8 + +## 1.166.21 + +### Patch Changes + +- Updated dependencies [[`6ee0e79`](https://github.com/TanStack/router/commit/6ee0e795b085651beb2f1ac6503cdbd7eaffedd1)]: + - @tanstack/router-core@1.168.7 + - @tanstack/solid-router@1.168.7 + - @tanstack/start-client-core@1.167.7 + - @tanstack/start-server-core@1.167.7 + +## 1.166.20 + +### Patch Changes + +- Updated dependencies [[`42c3f3b`](https://github.com/TanStack/router/commit/42c3f3b3a3a478fd6d6894310ef94b2d23794b8e)]: + - @tanstack/router-core@1.168.6 + - @tanstack/solid-router@1.168.6 + - @tanstack/start-client-core@1.167.6 + - @tanstack/start-server-core@1.167.6 + +## 1.166.19 + +### Patch Changes + +- Updated dependencies [[`cf5f554`](https://github.com/TanStack/router/commit/cf5f5542476137a81515099ad740747e84512f9a)]: + - @tanstack/router-core@1.168.5 + - @tanstack/solid-router@1.168.5 + - @tanstack/start-client-core@1.167.5 + - @tanstack/start-server-core@1.167.5 + +## 1.166.18 + +### Patch Changes + +- Updated dependencies [[`71a8b68`](https://github.com/TanStack/router/commit/71a8b684c87c37fd4a033d99f5ba4a05c7a179f5)]: + - @tanstack/router-core@1.168.4 + - @tanstack/solid-router@1.168.4 + - @tanstack/start-client-core@1.167.4 + - @tanstack/start-server-core@1.167.4 + +## 1.166.17 + +### Patch Changes + +- Updated dependencies [[`d81d21a`](https://github.com/TanStack/router/commit/d81d21ad05c9401bf54b24acd29401e1e4fd624c)]: + - @tanstack/router-core@1.168.3 + - @tanstack/solid-router@1.168.3 + - @tanstack/start-server-core@1.167.3 + - @tanstack/start-client-core@1.167.3 + +## 1.166.16 + +### Patch Changes + +- Updated dependencies [[`c9e1855`](https://github.com/TanStack/router/commit/c9e18555f3a5531e96de8f574cfca9edcdb18e5c)]: + - @tanstack/start-client-core@1.167.2 + - @tanstack/start-server-core@1.167.2 + - @tanstack/solid-router@1.168.2 + - @tanstack/router-core@1.168.2 + +## 1.166.15 + +### Patch Changes + +- Updated dependencies [[`91cc628`](https://github.com/TanStack/router/commit/91cc62899b75ca920fe83c5ee7f3dbb5c71a523f)]: + - @tanstack/router-core@1.168.1 + - @tanstack/solid-router@1.168.1 + - @tanstack/start-client-core@1.167.1 + - @tanstack/start-server-core@1.167.1 + +## 1.166.14 + +### Patch Changes + +- Updated dependencies [[`0545239`](https://github.com/TanStack/router/commit/054523900b2ee19308e5a88417dadfc6923afe30)]: + - @tanstack/start-client-core@1.167.0 + - @tanstack/start-server-core@1.167.0 + - @tanstack/solid-router@1.168.0 + - @tanstack/router-core@1.168.0 + +## 1.166.13 + +### Patch Changes + +- Updated dependencies [[`5ff4f0b`](https://github.com/TanStack/router/commit/5ff4f0b8dce1fac2bb0b0bfe2684fc677a8ee505)]: + - @tanstack/router-core@1.167.5 + - @tanstack/solid-router@1.167.5 + - @tanstack/start-client-core@1.166.13 + - @tanstack/start-server-core@1.166.13 + +## 1.166.12 + +### Patch Changes + +- Updated dependencies [[`940151c`](https://github.com/TanStack/router/commit/940151cbed0c76c92a5cf196c0905b17a956ca7e)]: + - @tanstack/router-core@1.167.4 + - @tanstack/solid-router@1.167.4 + - @tanstack/start-client-core@1.166.12 + - @tanstack/start-server-core@1.166.12 + +## 1.166.11 + +### Patch Changes + +- Updated dependencies [[`32fcba7`](https://github.com/TanStack/router/commit/32fcba7b044b03f5901308b870f70b0b4910c220)]: + - @tanstack/router-core@1.167.3 + - @tanstack/solid-router@1.167.3 + - @tanstack/start-client-core@1.166.11 + - @tanstack/start-server-core@1.166.11 + +## 1.166.10 + +### Patch Changes + +- build: update to vite-config 5.x (rolldown) ([#6926](https://github.com/TanStack/router/pull/6926)) + +- Updated dependencies [[`838b0eb`](https://github.com/TanStack/router/commit/838b0eb9a8bbbb987a0a6972c1446e01423bbd7b)]: + - @tanstack/history@1.161.6 + - @tanstack/router-core@1.167.2 + - @tanstack/solid-router@1.167.2 + - @tanstack/start-client-core@1.166.10 + - @tanstack/start-server-core@1.166.10 + +## 1.166.9 + +### Patch Changes + +- fix: build with @tanstack/vite-config 0.4.3 ([#6923](https://github.com/TanStack/router/pull/6923)) + +- Updated dependencies [[`ef9b241`](https://github.com/TanStack/router/commit/ef9b241f3cfe95cee40daa96da669f0ffd4a971a)]: + - @tanstack/start-client-core@1.166.9 + - @tanstack/start-server-core@1.166.9 + - @tanstack/solid-router@1.167.1 + - @tanstack/router-core@1.167.1 + - @tanstack/history@1.161.5 + +## 1.166.8 + +### Patch Changes + +- Updated dependencies [[`6f297a2`](https://github.com/TanStack/router/commit/6f297a249424c0fd1c1a56aa4fc12c8217be7b6a)]: + - @tanstack/router-core@1.167.0 + - @tanstack/solid-router@1.167.0 + - @tanstack/start-client-core@1.166.8 + - @tanstack/start-server-core@1.166.8 diff --git a/packages/solid-start/CHANGELOG.md b/packages/solid-start/CHANGELOG.md index 6f54580e7c..a2bf9cbd7b 100644 --- a/packages/solid-start/CHANGELOG.md +++ b/packages/solid-start/CHANGELOG.md @@ -505,3 +505,936 @@ - Updated dependencies [[`9a4d924`](https://github.com/TanStack/router/commit/9a4d924d2b60ffb0f7f3f8f11c95195222929870)]: - @tanstack/start-plugin-core@1.166.8 + +## 1.168.18 + +### Patch Changes + +- [#7509](https://github.com/TanStack/router/pull/7509) [`9cb7a00`](https://github.com/TanStack/router/commit/9cb7a003e6e5fa3706711870c7b10a5266356e3b) - feat(rsbuild): add RSC support + +- Updated dependencies [[`9cb7a00`](https://github.com/TanStack/router/commit/9cb7a003e6e5fa3706711870c7b10a5266356e3b)]: + - @tanstack/start-plugin-core@1.171.10 + - @tanstack/start-server-core@1.169.8 + - @tanstack/solid-start-server@1.167.13 + +## 1.168.17 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/solid-router@1.170.10 + - @tanstack/solid-start-client@1.168.7 + - @tanstack/solid-start-server@1.167.12 + - @tanstack/start-client-core@1.170.6 + - @tanstack/start-plugin-core@1.171.9 + - @tanstack/start-server-core@1.169.7 + +## 1.168.16 + +### Patch Changes + +- Updated dependencies [[`d1997b6`](https://github.com/TanStack/router/commit/d1997b66d7c24c1d64772bb8bab5caf9c6d9cc48)]: + - @tanstack/start-server-core@1.169.6 + - @tanstack/solid-router@1.170.9 + - @tanstack/solid-start-server@1.167.11 + - @tanstack/start-plugin-core@1.171.8 + - @tanstack/solid-start-client@1.168.6 + - @tanstack/start-client-core@1.170.5 + +## 1.168.15 + +### Patch Changes + +- Updated dependencies [[`9c09bca`](https://github.com/TanStack/router/commit/9c09bca59e9613e9a6fd9b7149b0737898e705d6)]: + - @tanstack/start-plugin-core@1.171.7 + - @tanstack/start-server-core@1.169.5 + - @tanstack/solid-start-server@1.167.10 + +## 1.168.14 + +### Patch Changes + +- [#7492](https://github.com/TanStack/router/pull/7492) [`71fb329`](https://github.com/TanStack/router/commit/71fb3297e93a126e1bcfd9eeb0626cc4b8df8dd8) - Avoid pulling the client hydration entry into root `@tanstack/react-start` and `@tanstack/solid-start` imports by re-exporting `Hydrate` from framework client Hydrate-only subpaths. + +- Updated dependencies [[`71fb329`](https://github.com/TanStack/router/commit/71fb3297e93a126e1bcfd9eeb0626cc4b8df8dd8)]: + - @tanstack/solid-start-client@1.168.5 + +## 1.168.13 + +### Patch Changes + +- Fix serialization adapter module resolution in TanStack Start. Vite dev now uses clean runtime-specific virtual module IDs instead of browser requests containing encoded null-byte virtual IDs, which avoids reverse proxy failures. When no serialization adapters are configured, Vite and Rsbuild now resolve `#tanstack-start-plugin-adapters` through the package empty-adapter fallback. ([#7484](https://github.com/TanStack/router/pull/7484)) + +- Publish matching TanStack Start dev server packages so fresh installs do not pair a Start plugin that no longer provides `tanstack-start-injected-head-scripts:v` with an older Start server runtime that still imports it. ([#7487](https://github.com/TanStack/router/pull/7487)) + +- Updated dependencies [[`a82cec6`](https://github.com/TanStack/router/commit/a82cec69474c366b36efdb3f43c4efe8311c485a), [`d8be4f8`](https://github.com/TanStack/router/commit/d8be4f8adf912128c96b7f83e9a6c49fb24b5eed)]: + - @tanstack/start-plugin-core@1.171.6 + - @tanstack/start-client-core@1.170.4 + - @tanstack/start-server-core@1.169.4 + - @tanstack/solid-start-client@1.168.4 + - @tanstack/solid-start-server@1.167.9 + +## 1.168.12 + +### Patch Changes + +- Add Vite bundled dev mode support for TanStack Start. Start now recognizes Vite's `experimental.bundledDev` opt-in, uses the bundled dev client entry in the dev manifest, keeps server requests pointed at the latest client build output, and preserves import-protection behavior for bundled client dev. ([#7482](https://github.com/TanStack/router/pull/7482)) + +- Updated dependencies [[`90adda9`](https://github.com/TanStack/router/commit/90adda91aab7212cbcdb6159176b39d9ed01b827)]: + - @tanstack/start-plugin-core@1.171.5 + +## 1.168.11 + +### Patch Changes + +- Add support for Rsbuild client output formats, including module output by default and IIFE output for classic script environments. ([#7477](https://github.com/TanStack/router/pull/7477)) + + Client entry scripts and preloads are now represented as root route manifest assets, script preloads follow the manifest script format, and script asset cross-origin configuration uses the `script` key. The `transformAssets` script callback context now exposes only `kind: 'script'` and `url`, keeping script format handling internal to manifest rendering. + +- Fix Rsbuild server function metadata replay when Rspack restores modules from its persistent cache. ([#7477](https://github.com/TanStack/router/pull/7477)) + + Server function metadata is now stored on Rspack module build info and replayed from cached modules before resolver modules are rebuilt, preventing warm restarts from losing server function registrations. + +- Updated dependencies [[`51a97a1`](https://github.com/TanStack/router/commit/51a97a167fb3ef1b8ca70fbb63db635158f43509), [`51a97a1`](https://github.com/TanStack/router/commit/51a97a167fb3ef1b8ca70fbb63db635158f43509)]: + - @tanstack/solid-router@1.170.8 + - @tanstack/start-plugin-core@1.171.4 + - @tanstack/start-server-core@1.169.3 + - @tanstack/solid-start-client@1.168.3 + - @tanstack/solid-start-server@1.167.8 + - @tanstack/start-client-core@1.170.3 + +## 1.168.10 + +### Patch Changes + +- Explicitly re-export public API names from `@tanstack/start-client-core` (`createServerFn`, `createMiddleware`, `createStart`, `createCsrfMiddleware`, `createIsomorphicFn`, `createClientOnlyFn`, `createServerOnlyFn`) alongside the existing `export *`. The explicit named re-exports are registered at link time (via Vite SSR's `defineExport` at `fileStartIndex`), so the namespace has these getters before any import body runs — survives the cold-start SSR cycle through user middleware where `export *` would otherwise produce a partial facade (`createMiddleware is not a function`). Workaround for vitejs/vite#22491 / #22493. ([#7466](https://github.com/TanStack/router/pull/7466)) + +- Updated dependencies []: + - @tanstack/solid-router@1.170.7 + - @tanstack/solid-start-client@1.168.2 + - @tanstack/solid-start-server@1.167.7 + - @tanstack/start-client-core@1.170.2 + - @tanstack/start-plugin-core@1.171.3 + - @tanstack/start-server-core@1.169.2 + +## 1.168.9 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.171.2 + +## 1.168.8 + +### Patch Changes + +- Updated dependencies [[`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960)]: + - @tanstack/solid-router@1.170.6 + - @tanstack/solid-start-client@1.168.1 + - @tanstack/solid-start-server@1.167.6 + - @tanstack/start-client-core@1.170.1 + - @tanstack/start-plugin-core@1.171.1 + - @tanstack/start-server-core@1.169.1 + +## 1.168.7 + +### Patch Changes + +- Updated dependencies [[`5fa9e55`](https://github.com/TanStack/router/commit/5fa9e555f3a2edb5e45586623e6bcbfa7f7c7a6b)]: + - @tanstack/solid-start-client@1.168.0 + - @tanstack/start-client-core@1.170.0 + - @tanstack/start-plugin-core@1.171.0 + - @tanstack/start-server-core@1.169.0 + - @tanstack/solid-start-server@1.167.5 + - @tanstack/solid-router@1.170.5 + +## 1.168.6 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/solid-router@1.170.4 + - @tanstack/solid-start-client@1.167.4 + - @tanstack/solid-start-server@1.167.4 + - @tanstack/start-client-core@1.169.4 + - @tanstack/start-plugin-core@1.170.6 + - @tanstack/start-server-core@1.168.4 + +## 1.168.5 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.170.5 + +## 1.168.4 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/solid-router@1.170.3 + - @tanstack/solid-start-client@1.167.3 + - @tanstack/solid-start-server@1.167.3 + - @tanstack/start-client-core@1.169.3 + - @tanstack/start-plugin-core@1.170.4 + - @tanstack/start-server-core@1.168.3 + +## 1.168.3 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/solid-router@1.170.2 + - @tanstack/solid-start-client@1.167.2 + - @tanstack/solid-start-server@1.167.2 + - @tanstack/start-client-core@1.169.2 + - @tanstack/start-plugin-core@1.170.3 + - @tanstack/start-server-core@1.168.2 + +## 1.168.2 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.170.2 + +## 1.168.1 + +### Patch Changes + +- Updated dependencies [[`2387a2e`](https://github.com/TanStack/router/commit/2387a2eea0683004cc400b9f71bed5944eb60110)]: + - @tanstack/start-plugin-core@1.170.1 + - @tanstack/start-server-core@1.168.1 + - @tanstack/solid-router@1.170.1 + - @tanstack/solid-start-client@1.167.1 + - @tanstack/solid-start-server@1.167.1 + - @tanstack/start-client-core@1.169.1 + +## 1.168.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- Updated dependencies [[`201e150`](https://github.com/TanStack/router/commit/201e150bd1412bae2faa9ce53f0fefcb7574ac14), [`5ae2ae5`](https://github.com/TanStack/router/commit/5ae2ae5e0f8ce32e02667a482ea9be52a6150240)]: + - @tanstack/solid-router@1.170.0 + - @tanstack/solid-start-client@1.167.0 + - @tanstack/solid-start-server@1.167.0 + - @tanstack/start-client-core@1.169.0 + - @tanstack/start-plugin-core@1.170.0 + - @tanstack/start-server-core@1.168.0 + +## 1.167.62 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.169.20 + +## 1.167.61 + +### Patch Changes + +- Updated dependencies [[`35e88f0`](https://github.com/TanStack/router/commit/35e88f04996d71019a1868b7b06ecb4ddbc9df9e)]: + - @tanstack/start-client-core@1.168.2 + - @tanstack/start-plugin-core@1.169.19 + - @tanstack/start-server-core@1.167.30 + - @tanstack/solid-router@1.169.2 + - @tanstack/solid-start-client@1.166.47 + - @tanstack/solid-start-server@1.166.51 + +## 1.167.60 + +### Patch Changes + +- Updated dependencies [[`056337e`](https://github.com/TanStack/router/commit/056337ef02ccbeaf45ec8533a227761be869e8f3)]: + - @tanstack/start-plugin-core@1.169.18 + +## 1.167.59 + +### Patch Changes + +- Updated dependencies [[`afa40ef`](https://github.com/TanStack/router/commit/afa40ef46c273c53646ba33f607fc618a07ffede)]: + - @tanstack/start-server-core@1.167.29 + - @tanstack/solid-start-server@1.166.50 + - @tanstack/start-plugin-core@1.169.17 + +## 1.167.58 + +### Patch Changes + +- Updated dependencies [[`709627f`](https://github.com/TanStack/router/commit/709627f3dbc6d97daa547a1401ef42a53bc4be32)]: + - @tanstack/start-server-core@1.167.28 + - @tanstack/solid-start-server@1.166.49 + - @tanstack/start-plugin-core@1.169.16 + +## 1.167.57 + +### Patch Changes + +- Add experimental HTTP 103 Early Hints support to Start server handlers. ([#7324](https://github.com/TanStack/router/pull/7324)) + +- Updated dependencies [[`238ea4a`](https://github.com/TanStack/router/commit/238ea4a4998ab3a7fd528b317e1935766ac65df8)]: + - @tanstack/start-server-core@1.167.27 + - @tanstack/solid-start-server@1.166.48 + - @tanstack/start-plugin-core@1.169.15 + +## 1.167.56 + +### Patch Changes + +- Updated dependencies [[`96818b8`](https://github.com/TanStack/router/commit/96818b8ba5ead6f1f027094841330182aff415b2)]: + - @tanstack/start-plugin-core@1.169.14 + +## 1.167.55 + +### Patch Changes + +- Updated dependencies [[`ae453b7`](https://github.com/TanStack/router/commit/ae453b78624cac1b574f0d1efbfbf6ca03922c6c)]: + - @tanstack/start-plugin-core@1.169.13 + +## 1.167.54 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/solid-router@1.169.1 + - @tanstack/solid-start-client@1.166.46 + - @tanstack/solid-start-server@1.166.47 + - @tanstack/start-client-core@1.168.1 + - @tanstack/start-plugin-core@1.169.12 + - @tanstack/start-server-core@1.167.26 + +## 1.167.53 + +### Patch Changes + +- Updated dependencies [[`82b0613`](https://github.com/TanStack/router/commit/82b06132af776f74603ab27977cc277d6219a845)]: + - @tanstack/start-client-core@1.168.0 + - @tanstack/solid-start-client@1.166.45 + - @tanstack/solid-start-server@1.166.46 + - @tanstack/start-plugin-core@1.169.11 + - @tanstack/start-server-core@1.167.25 + +## 1.167.52 + +### Patch Changes + +- Updated dependencies [[`c4256c2`](https://github.com/TanStack/router/commit/c4256c2c857f392d2031cf87821e4c36a92d0382)]: + - @tanstack/start-plugin-core@1.169.10 + +## 1.167.51 + +### Patch Changes + +- Updated dependencies [[`761fcc0`](https://github.com/TanStack/router/commit/761fcc0c96dd96721b533a1fd9e2c972f222ef94)]: + - @tanstack/start-plugin-core@1.169.9 + +## 1.167.50 + +### Patch Changes + +- Updated dependencies [[`c992495`](https://github.com/TanStack/router/commit/c992495bf4010ff4c3597bb1f3b1ba02594e857e)]: + - @tanstack/solid-router@1.169.0 + - @tanstack/solid-start-client@1.166.44 + - @tanstack/solid-start-server@1.166.45 + - @tanstack/start-client-core@1.167.22 + - @tanstack/start-plugin-core@1.169.8 + - @tanstack/start-server-core@1.167.24 + +## 1.167.49 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/solid-router@1.168.26 + - @tanstack/solid-start-client@1.166.43 + - @tanstack/solid-start-server@1.166.44 + - @tanstack/start-client-core@1.167.21 + - @tanstack/start-plugin-core@1.169.7 + - @tanstack/start-server-core@1.167.23 + +## 1.167.48 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/solid-router@1.168.25 + - @tanstack/solid-start-client@1.166.42 + - @tanstack/solid-start-server@1.166.43 + - @tanstack/start-client-core@1.167.20 + - @tanstack/start-plugin-core@1.169.6 + - @tanstack/start-server-core@1.167.22 + +## 1.167.47 + +### Patch Changes + +- Updated dependencies [[`944b155`](https://github.com/TanStack/router/commit/944b1558965bf038eaf3c0dfb9e1ac3800d6fd3a)]: + - @tanstack/solid-router@1.168.24 + - @tanstack/solid-start-client@1.166.41 + - @tanstack/solid-start-server@1.166.42 + +## 1.167.46 + +### Patch Changes + +- Don't externalize `@tanstack/solid-query` during SSR to avoid duplicate `QueryClientContext` instances ([#7267](https://github.com/TanStack/router/pull/7267)) + +## 1.167.45 + +### Patch Changes + +- Updated dependencies [[`41e37f8`](https://github.com/TanStack/router/commit/41e37f8a9c3d2a6e00e4ca6faabb6a596bc36a98), [`e054474`](https://github.com/TanStack/router/commit/e054474cd1df6f93cd69dd5d255013840441438e)]: + - @tanstack/solid-router@1.168.23 + - @tanstack/solid-start-client@1.166.40 + - @tanstack/solid-start-server@1.166.41 + +## 1.167.44 + +### Patch Changes + +- Updated dependencies [[`b732c8a`](https://github.com/TanStack/router/commit/b732c8ac26bd3b316e95b026ca2fc7c2c78a1ddd), [`d20c878`](https://github.com/TanStack/router/commit/d20c87813559ff00d0b4810c4b600d47b47eff2f)]: + - @tanstack/solid-router@1.168.22 + - @tanstack/start-plugin-core@1.169.5 + - @tanstack/solid-start-client@1.166.39 + - @tanstack/solid-start-server@1.166.40 + +## 1.167.43 + +### Patch Changes + +- Updated dependencies [[`8b97002`](https://github.com/TanStack/router/commit/8b97002af3f6d15204e60c55d3f5735b78bd7efe)]: + - @tanstack/start-client-core@1.167.19 + - @tanstack/solid-start-client@1.166.38 + - @tanstack/solid-start-server@1.166.39 + - @tanstack/start-plugin-core@1.169.4 + - @tanstack/start-server-core@1.167.21 + +## 1.167.42 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.169.3 + +## 1.167.41 + +### Patch Changes + +- Updated dependencies [[`4d864ee`](https://github.com/TanStack/router/commit/4d864eebbd184265eabb563d326ab409c93feb17)]: + - @tanstack/solid-router@1.168.21 + - @tanstack/start-plugin-core@1.169.2 + - @tanstack/start-server-core@1.167.20 + - @tanstack/solid-start-client@1.166.37 + - @tanstack/solid-start-server@1.166.38 + - @tanstack/start-client-core@1.167.18 + +## 1.167.40 + +### Patch Changes + +- Updated dependencies [[`9252206`](https://github.com/TanStack/router/commit/9252206e5aeafe53e31eb7baa491d07a597c4dc6)]: + - @tanstack/start-plugin-core@1.169.1 + +## 1.167.39 + +### Patch Changes + +- Split Start plugin core bundler APIs into explicit Vite and Rsbuild subpaths so projects only need the bundler they use. Mark both `vite` and `@rsbuild/core` peers as optional where Start exposes both integrations. ([#7249](https://github.com/TanStack/router/pull/7249)) + +- Updated dependencies [[`dda463c`](https://github.com/TanStack/router/commit/dda463c8b571519165d3adbc337db7a0b8be1072)]: + - @tanstack/start-plugin-core@1.169.0 + +## 1.167.38 + +### Patch Changes + +- rsbuild ([#7228](https://github.com/TanStack/router/pull/7228)) + +- Updated dependencies [[`91a7089`](https://github.com/TanStack/router/commit/91a708989d00537a21911e74ff60bbfec8266295)]: + - @tanstack/start-plugin-core@1.168.0 + +## 1.167.37 + +### Patch Changes + +- Updated dependencies [[`22dc152`](https://github.com/TanStack/router/commit/22dc15203379da15e6eaa225e61696039380aedd)]: + - @tanstack/solid-router@1.168.20 + - @tanstack/solid-start-client@1.166.36 + - @tanstack/solid-start-server@1.166.37 + +## 1.167.36 + +### Patch Changes + +- Updated dependencies [[`f7f0025`](https://github.com/TanStack/router/commit/f7f00250f39cf0276a984558e5d427e9270d9635)]: + - @tanstack/start-plugin-core@1.167.35 + +## 1.167.35 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/solid-router@1.168.19 + - @tanstack/solid-start-client@1.166.35 + - @tanstack/solid-start-server@1.166.36 + - @tanstack/start-client-core@1.167.17 + - @tanstack/start-plugin-core@1.167.34 + - @tanstack/start-server-core@1.167.19 + +## 1.167.34 + +### Patch Changes + +- Updated dependencies [[`a581680`](https://github.com/TanStack/router/commit/a581680a27530469751b8ab419ada9ce66da4ffe)]: + - @tanstack/start-plugin-core@1.167.33 + +## 1.167.33 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.167.32 + +## 1.167.32 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.167.31 + +## 1.167.31 + +### Patch Changes + +- Updated dependencies [[`105d056`](https://github.com/TanStack/router/commit/105d05691a247779a63e7b688aa1207cce619339)]: + - @tanstack/solid-router@1.168.18 + - @tanstack/start-plugin-core@1.167.30 + - @tanstack/solid-start-client@1.166.34 + - @tanstack/solid-start-server@1.166.35 + +## 1.167.30 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.167.29 + +## 1.167.29 + +### Patch Changes + +- Updated dependencies [[`0e2c900`](https://github.com/TanStack/router/commit/0e2c9003c18ae07c09969189c028f277ea562a7a)]: + - @tanstack/start-server-core@1.167.18 + - @tanstack/solid-start-server@1.166.34 + - @tanstack/start-plugin-core@1.167.28 + - @tanstack/solid-router@1.168.17 + - @tanstack/solid-start-client@1.166.33 + - @tanstack/start-client-core@1.167.16 + +## 1.167.28 + +### Patch Changes + +- Updated dependencies [[`812792f`](https://github.com/TanStack/router/commit/812792fbda3caf97b300770855cf5641252f413b)]: + - @tanstack/start-plugin-core@1.167.27 + - @tanstack/start-server-core@1.167.17 + - @tanstack/solid-router@1.168.16 + - @tanstack/solid-start-client@1.166.32 + - @tanstack/solid-start-server@1.166.33 + - @tanstack/start-client-core@1.167.15 + +## 1.167.27 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/solid-router@1.168.15 + - @tanstack/solid-start-client@1.166.31 + - @tanstack/solid-start-server@1.166.32 + - @tanstack/start-client-core@1.167.14 + - @tanstack/start-plugin-core@1.167.26 + - @tanstack/start-server-core@1.167.16 + +## 1.167.26 + +### Patch Changes + +- Updated dependencies [[`d3f20fb`](https://github.com/TanStack/router/commit/d3f20fbe7acf69c3bd108c5ddc9748ad47690b04)]: + - @tanstack/start-plugin-core@1.167.25 + +## 1.167.25 + +### Patch Changes + +- Updated dependencies [[`6355bb7`](https://github.com/TanStack/router/commit/6355bb75f7637ba77f06a923c18fdaf37720bb48)]: + - @tanstack/start-server-core@1.167.15 + - @tanstack/solid-router@1.168.14 + - @tanstack/solid-start-server@1.166.31 + - @tanstack/start-plugin-core@1.167.24 + - @tanstack/solid-start-client@1.166.30 + - @tanstack/start-client-core@1.167.13 + +## 1.167.24 + +### Patch Changes + +- migrate createStore > createAtom for simpler API ([#7150](https://github.com/TanStack/router/pull/7150)) + +- Updated dependencies [[`459057c`](https://github.com/TanStack/router/commit/459057cd2d90cff20d20e51d4964b0a8c950555e)]: + - @tanstack/start-client-core@1.167.12 + - @tanstack/start-server-core@1.167.14 + - @tanstack/solid-router@1.168.13 + - @tanstack/solid-start-client@1.166.29 + - @tanstack/solid-start-server@1.166.30 + - @tanstack/start-plugin-core@1.167.23 + +## 1.167.23 + +### Patch Changes + +- Updated dependencies [[`f8ac427`](https://github.com/TanStack/router/commit/f8ac427000c3fec99225926e72f9f2fc7a37231f)]: + - @tanstack/start-server-core@1.167.13 + - @tanstack/start-client-core@1.167.11 + - @tanstack/solid-start-server@1.166.29 + - @tanstack/start-plugin-core@1.167.22 + - @tanstack/solid-start-client@1.166.28 + +## 1.167.22 + +### Patch Changes + +- Updated dependencies [[`2d53c05`](https://github.com/TanStack/router/commit/2d53c056ef0b203de8a28bc92c24e8e604205d52)]: + - @tanstack/start-server-core@1.167.12 + - @tanstack/start-plugin-core@1.167.21 + - @tanstack/solid-start-server@1.166.28 + +## 1.167.20 + +### Patch Changes + +- Updated dependencies [[`3384abc`](https://github.com/TanStack/router/commit/3384abcffd98a68eb254b11221834bcbcdebec31)]: + - @tanstack/start-plugin-core@1.167.19 + +## 1.167.19 + +### Patch Changes + +- Updated dependencies [[`540d221`](https://github.com/TanStack/router/commit/540d22100d33415a1ddc9eb193f6aeb8184da77f)]: + - @tanstack/solid-router@1.168.12 + - @tanstack/solid-start-client@1.166.27 + - @tanstack/solid-start-server@1.166.27 + +## 1.167.18 + +### Patch Changes + +- Updated dependencies [[`b29d64d`](https://github.com/TanStack/router/commit/b29d64de0c400183114c12f82183f80e37d9ea5c)]: + - @tanstack/solid-router@1.168.11 + - @tanstack/solid-start-client@1.166.26 + - @tanstack/solid-start-server@1.166.26 + +## 1.167.17 + +### Patch Changes + +- Updated dependencies [[`4b9ed6c`](https://github.com/TanStack/router/commit/4b9ed6c5cb5437df8607c605728c8338dd2eb02c)]: + - @tanstack/solid-router@1.168.10 + - @tanstack/solid-start-client@1.166.25 + - @tanstack/solid-start-server@1.166.25 + +## 1.167.16 + +### Patch Changes + +- Updated dependencies [[`f7e9c5e`](https://github.com/TanStack/router/commit/f7e9c5e323793d1b28c96871819c265fd28ae397)]: + - @tanstack/start-client-core@1.167.10 + - @tanstack/start-server-core@1.167.10 + - @tanstack/solid-start-client@1.166.24 + - @tanstack/solid-start-server@1.166.24 + - @tanstack/start-plugin-core@1.167.18 + +## 1.167.15 + +### Patch Changes + +- Updated dependencies [[`796406d`](https://github.com/TanStack/router/commit/796406da66cfb12b518bb3ca326c9d541368fb06)]: + - @tanstack/solid-router@1.168.9 + - @tanstack/solid-start-client@1.166.23 + - @tanstack/solid-start-server@1.166.23 + - @tanstack/start-client-core@1.167.9 + - @tanstack/start-plugin-core@1.167.17 + - @tanstack/start-server-core@1.167.9 + +## 1.167.14 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/solid-router@1.168.8 + - @tanstack/solid-start-client@1.166.22 + - @tanstack/solid-start-server@1.166.22 + - @tanstack/start-client-core@1.167.8 + - @tanstack/start-plugin-core@1.167.16 + - @tanstack/start-server-core@1.167.8 + +## 1.167.13 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.167.15 + +## 1.167.12 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/solid-router@1.168.7 + - @tanstack/solid-start-client@1.166.21 + - @tanstack/solid-start-server@1.166.21 + - @tanstack/start-client-core@1.167.7 + - @tanstack/start-plugin-core@1.167.14 + - @tanstack/start-server-core@1.167.7 + +## 1.167.11 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/solid-router@1.168.6 + - @tanstack/solid-start-client@1.166.20 + - @tanstack/solid-start-server@1.166.20 + - @tanstack/start-client-core@1.167.6 + - @tanstack/start-plugin-core@1.167.13 + - @tanstack/start-server-core@1.167.6 + +## 1.167.10 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.167.12 + +## 1.167.9 + +### Patch Changes + +- Updated dependencies [[`cf5f554`](https://github.com/TanStack/router/commit/cf5f5542476137a81515099ad740747e84512f9a)]: + - @tanstack/solid-router@1.168.5 + - @tanstack/solid-start-client@1.166.19 + - @tanstack/solid-start-server@1.166.19 + - @tanstack/start-client-core@1.167.5 + - @tanstack/start-plugin-core@1.167.11 + - @tanstack/start-server-core@1.167.5 + +## 1.167.8 + +### Patch Changes + +- Fix the `server-entry` package export types path so published packages include the expected declaration files, and add build-time package validation to catch similar export issues during CI. ([#7035](https://github.com/TanStack/router/pull/7035)) + +## 1.167.7 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/solid-router@1.168.4 + - @tanstack/solid-start-client@1.166.18 + - @tanstack/solid-start-server@1.166.18 + - @tanstack/start-client-core@1.167.4 + - @tanstack/start-plugin-core@1.167.10 + - @tanstack/start-server-core@1.167.4 + +## 1.167.6 + +### Patch Changes + +- Updated dependencies [[`ed9c43d`](https://github.com/TanStack/router/commit/ed9c43df7ab8c679f6e6833d94651a0a091b9880)]: + - @tanstack/start-plugin-core@1.167.9 + +## 1.167.5 + +### Patch Changes + +- Updated dependencies [[`d81d21a`](https://github.com/TanStack/router/commit/d81d21ad05c9401bf54b24acd29401e1e4fd624c)]: + - @tanstack/solid-router@1.168.3 + - @tanstack/start-plugin-core@1.167.8 + - @tanstack/start-server-core@1.167.3 + - @tanstack/solid-start-client@1.166.17 + - @tanstack/solid-start-server@1.166.17 + - @tanstack/start-client-core@1.167.3 + +## 1.167.4 + +### Patch Changes + +- Updated dependencies [[`6077120`](https://github.com/TanStack/router/commit/6077120efa59125ab79a6aff7cdb54ddae986d25)]: + - @tanstack/start-plugin-core@1.167.7 + +## 1.167.3 + +### Patch Changes + +- Updated dependencies [[`c9e1855`](https://github.com/TanStack/router/commit/c9e18555f3a5531e96de8f574cfca9edcdb18e5c)]: + - @tanstack/solid-start-client@1.166.16 + - @tanstack/start-client-core@1.167.2 + - @tanstack/start-server-core@1.167.2 + - @tanstack/solid-router@1.168.2 + - @tanstack/solid-start-server@1.166.16 + - @tanstack/start-plugin-core@1.167.6 + +## 1.167.2 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.167.5 + +## 1.167.1 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/solid-router@1.168.1 + - @tanstack/solid-start-client@1.166.15 + - @tanstack/solid-start-server@1.166.15 + - @tanstack/start-client-core@1.167.1 + - @tanstack/start-plugin-core@1.167.4 + - @tanstack/start-server-core@1.167.1 + +## 1.167.0 + +### Minor Changes + +- remove pendingMatches, cachedMatches ([#6704](https://github.com/TanStack/router/pull/6704)) + move to signal-based reactivity + solid uses its own native signals + +### Patch Changes + +- Updated dependencies [[`0545239`](https://github.com/TanStack/router/commit/054523900b2ee19308e5a88417dadfc6923afe30)]: + - @tanstack/start-client-core@1.167.0 + - @tanstack/start-server-core@1.167.0 + - @tanstack/solid-router@1.168.0 + - @tanstack/solid-start-client@1.166.14 + - @tanstack/solid-start-server@1.166.14 + - @tanstack/start-plugin-core@1.167.3 + +## 1.166.18 + +### Patch Changes + +- Updated dependencies [[`0f585d5`](https://github.com/TanStack/router/commit/0f585d5289c8a3b11697caa9b2aa3015d37d776e)]: + - @tanstack/start-plugin-core@1.167.2 + +## 1.166.17 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/solid-router@1.167.5 + - @tanstack/solid-start-client@1.166.13 + - @tanstack/solid-start-server@1.166.13 + - @tanstack/start-client-core@1.166.13 + - @tanstack/start-plugin-core@1.167.1 + - @tanstack/start-server-core@1.166.13 + +## 1.166.16 + +### Patch Changes + +- Updated dependencies [[`6651473`](https://github.com/TanStack/router/commit/6651473d028a55c70f3f54af37a12b4379b46813)]: + - @tanstack/start-plugin-core@1.167.0 + +## 1.166.15 + +### Patch Changes + +- Add @tanstack/intent AI agent skills and CLI entry points for Router and Start packages ([#6866](https://github.com/TanStack/router/pull/6866)) + +- Updated dependencies [[`940151c`](https://github.com/TanStack/router/commit/940151cbed0c76c92a5cf196c0905b17a956ca7e), [`d637152`](https://github.com/TanStack/router/commit/d6371529b5ab09af7d81463a6c4082b092411967)]: + - @tanstack/solid-router@1.167.4 + - @tanstack/start-client-core@1.166.12 + - @tanstack/start-server-core@1.166.12 + - @tanstack/start-plugin-core@1.166.15 + - @tanstack/solid-start-client@1.166.12 + - @tanstack/solid-start-server@1.166.12 + +## 1.166.14 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/solid-router@1.167.3 + - @tanstack/solid-start-client@1.166.11 + - @tanstack/solid-start-server@1.166.11 + - @tanstack/start-client-core@1.166.11 + - @tanstack/start-plugin-core@1.166.14 + - @tanstack/start-server-core@1.166.11 + +## 1.166.13 + +### Patch Changes + +- build: update to vite-config 5.x (rolldown) ([#6926](https://github.com/TanStack/router/pull/6926)) + +- Updated dependencies [[`838b0eb`](https://github.com/TanStack/router/commit/838b0eb9a8bbbb987a0a6972c1446e01423bbd7b)]: + - @tanstack/solid-router@1.167.2 + - @tanstack/solid-start-client@1.166.10 + - @tanstack/solid-start-server@1.166.10 + - @tanstack/start-client-core@1.166.10 + - @tanstack/start-plugin-core@1.166.13 + - @tanstack/start-server-core@1.166.10 + +## 1.166.12 + +### Patch Changes + +- fix: build with @tanstack/vite-config 0.4.3 ([#6923](https://github.com/TanStack/router/pull/6923)) + +- Updated dependencies [[`ef9b241`](https://github.com/TanStack/router/commit/ef9b241f3cfe95cee40daa96da669f0ffd4a971a)]: + - @tanstack/solid-start-client@1.166.9 + - @tanstack/solid-start-server@1.166.9 + - @tanstack/start-client-core@1.166.9 + - @tanstack/start-plugin-core@1.166.12 + - @tanstack/start-server-core@1.166.9 + - @tanstack/solid-router@1.167.1 + +## 1.166.11 + +### Patch Changes + +- fix: add `xmlns:xhtml` to generated sitemap ([#6920](https://github.com/TanStack/router/pull/6920)) + +- Updated dependencies [[`bfd6e62`](https://github.com/TanStack/router/commit/bfd6e62780f1cb96c210ae405723c5ebc22b10b0)]: + - @tanstack/start-plugin-core@1.166.11 + +## 1.166.10 + +### Patch Changes + +- Updated dependencies [[`6f297a2`](https://github.com/TanStack/router/commit/6f297a249424c0fd1c1a56aa4fc12c8217be7b6a)]: + - @tanstack/solid-router@1.167.0 + - @tanstack/solid-start-client@1.166.8 + - @tanstack/solid-start-server@1.166.8 + - @tanstack/start-client-core@1.166.8 + - @tanstack/start-plugin-core@1.166.10 + - @tanstack/start-server-core@1.166.8 + +## 1.166.9 + +### Patch Changes + +- Updated dependencies []: + - @tanstack/start-plugin-core@1.166.9 + +## 1.166.8 + +### Patch Changes + +- Updated dependencies [[`9a4d924`](https://github.com/TanStack/router/commit/9a4d924d2b60ffb0f7f3f8f11c95195222929870)]: + - @tanstack/start-plugin-core@1.166.8 diff --git a/packages/solid-start/bin/intent.js b/packages/solid-start/bin/intent.js deleted file mode 100755 index 5b08532885..0000000000 --- a/packages/solid-start/bin/intent.js +++ /dev/null @@ -1,25 +0,0 @@ -#!/usr/bin/env node -// Auto-generated by @tanstack/intent setup -// Exposes the intent end-user CLI for consumers of this library. -// Commit this file, then add to your package.json: -// "bin": { "intent": "./bin/intent.js" } -try { - await import('@tanstack/intent/intent-library') -} catch (e) { - const isModuleNotFound = - e?.code === 'ERR_MODULE_NOT_FOUND' || e?.code === 'MODULE_NOT_FOUND' - const missingIntentLibrary = - typeof e?.message === 'string' && e.message.includes('@tanstack/intent') - - if (isModuleNotFound && missingIntentLibrary) { - console.error('@tanstack/intent is not installed.') - console.error('') - console.error('Install it as a dev dependency:') - console.error(' npm add -D @tanstack/intent') - console.error('') - console.error('Or run directly:') - console.error(' npx @tanstack/intent@latest list') - process.exit(1) - } - throw e -} diff --git a/packages/solid-start/package.json b/packages/solid-start/package.json index 2f7faa8b46..a586538508 100644 --- a/packages/solid-start/package.json +++ b/packages/solid-start/package.json @@ -92,7 +92,19 @@ "default": "./dist/esm/client-only.js" } }, - "./package.json": "./package.json" + "./package.json": "./package.json", + "./hydration": { + "import": { + "types": "./dist/esm/hydration.d.ts", + "default": "./dist/esm/hydration.js" + } + }, + "./plugin/rsbuild": { + "import": { + "types": "./dist/esm/plugin/rsbuild.d.ts", + "default": "./dist/esm/plugin/rsbuild.js" + } + } }, "sideEffects": false, "files": [ @@ -116,18 +128,24 @@ }, "devDependencies": { "@solidjs/web": "2.0.0-beta.14", - "@tanstack/intent": "^0.0.14", "@tanstack/router-utils": "workspace:*", "@types/node": ">=20", "solid-js": "2.0.0-beta.14", - "vite": "*" + "vite": "*", + "@rsbuild/core": "^2.0.8" }, "peerDependencies": { "@solidjs/web": ">=2.0.0-0 <3.0.0", "solid-js": ">=2.0.0-0 <3.0.0", - "vite": ">=7.0.0" + "vite": ">=7.0.0", + "@rsbuild/core": "^2.0.0" }, - "bin": { - "intent": "./bin/intent.js" + "peerDependenciesMeta": { + "@rsbuild/core": { + "optional": true + }, + "vite": { + "optional": true + } } } diff --git a/packages/solid-start/src/hydration.ts b/packages/solid-start/src/hydration.ts new file mode 100644 index 0000000000..fc660e9dc5 --- /dev/null +++ b/packages/solid-start/src/hydration.ts @@ -0,0 +1,18 @@ +export { + condition, + idle, + interaction, + load, + media, + never, + visible, +} from '@tanstack/solid-start-client/hydration' +export type { + HydrationCondition, + HydrationInteractionEvent, + HydrationInteractionEvents, + HydrationPrefetchStrategy, + HydrationStrategy, + HydrationWhen, + VisibleHydrationOptions, +} from '@tanstack/solid-start-client/hydration' diff --git a/packages/solid-start/src/index.ts b/packages/solid-start/src/index.ts index 8b51b6c783..bc5560978d 100644 --- a/packages/solid-start/src/index.ts +++ b/packages/solid-start/src/index.ts @@ -1,2 +1,34 @@ export { useServerFn } from './useServerFn' export * from '@tanstack/start-client-core' +// Explicit re-exports shadow `export *` above so these public-API names are +// registered on the namespace at link time (via Vite SSR's `defineExport` +// at fileStartIndex), surviving the cold-start SSR cycle through user +// middleware. See vitejs/vite#22491 / #22493. Trim list to genuine public +// API only; internals fall through `export *` and are safe because they +// aren't imported at top level in the cycle path. +export { + createClientOnlyFn, + createCsrfMiddleware, + createIsomorphicFn, + createMiddleware, + createServerFn, + createServerOnlyFn, + createStart, +} from '@tanstack/start-client-core' + +// Keep root `@tanstack/solid-start` imports from evaluating the client barrel. +// The barrel also exports `hydrateStart`, which imports the virtual client +// entry. That virtual entry imports the user's router module, so route modules +// that import the root package can be pulled back into the same graph and +// create circular HMR updates. Re-exporting from the Hydrate-only subpath +// preserves the public API without introducing that import edge. +export { Hydrate } from '@tanstack/solid-start-client/Hydrate' +export type { + HydrateOptions, + HydrateProps, + HydrationInteractionEvent, + HydrationInteractionEvents, + HydrationPrefetchStrategy, + HydrationStrategy, + HydrationWhen, +} from '@tanstack/solid-start-client/Hydrate' diff --git a/packages/solid-start/src/plugin/rsbuild.ts b/packages/solid-start/src/plugin/rsbuild.ts new file mode 100644 index 0000000000..b1f2532264 --- /dev/null +++ b/packages/solid-start/src/plugin/rsbuild.ts @@ -0,0 +1,81 @@ +import { + RSBUILD_ENVIRONMENT_NAMES, + tanStackStartRsbuild, +} from '@tanstack/start-plugin-core/rsbuild' +import { solidStartDefaultEntryPaths } from './shared' +import type { + TanStackStartRsbuildInputConfig, + TanStackStartRsbuildPluginCoreOptions, +} from '@tanstack/start-plugin-core/rsbuild' +import type { RsbuildPlugin } from '@rsbuild/core' + +export function tanstackStart( + options?: TanStackStartRsbuildInputConfig, +): RsbuildPlugin { + const corePluginOpts: TanStackStartRsbuildPluginCoreOptions = { + framework: 'solid', + defaultEntryPaths: solidStartDefaultEntryPaths, + providerEnvironmentName: RSBUILD_ENVIRONMENT_NAMES.server, + ssrIsProvider: true, + rsbuild: { + environments: { + all: { + resolve: { + conditionNames: ['solid', '...'], + }, + }, + }, + }, + } + + const basePlugin = tanStackStartRsbuild(corePluginOpts, options) + + return { + name: 'tanstack-solid-start-rsbuild', + setup(api) { + basePlugin.setup(api) + + api.modifyBundlerChain(async (chain, { CHAIN_ID, target }) => { + for (const ruleId of [ + CHAIN_ID.RULE.JS, + CHAIN_ID.RULE.JS_DATA_URI, + 'babel-js', + ]) { + if (!chain.module.rules.has(ruleId)) { + continue + } + + const rule = chain.module.rule(ruleId) + if (!rule.uses.has(CHAIN_ID.USE.BABEL)) { + continue + } + + rule.use(CHAIN_ID.USE.BABEL).tap((babelOptions) => { + babelOptions.presets = (babelOptions.presets ?? []).map( + (preset: unknown) => { + if ( + Array.isArray(preset) && + typeof preset[0] === 'string' && + preset[0].includes('babel-preset-solid') + ) { + return [ + preset[0], + { + ...(preset[1] ?? {}), + hydratable: true, + generate: target === 'node' ? 'ssr' : 'dom', + }, + ] + } + + return preset + }, + ) + + return babelOptions + }) + } + }) + }, + } +} diff --git a/packages/solid-start/src/plugin/shared.ts b/packages/solid-start/src/plugin/shared.ts new file mode 100644 index 0000000000..f3e09591f4 --- /dev/null +++ b/packages/solid-start/src/plugin/shared.ts @@ -0,0 +1,17 @@ +import { fileURLToPath } from 'node:url' +import path from 'pathe' + +const currentDir = path.dirname(fileURLToPath(import.meta.url)) +const defaultEntryDir = path.resolve( + currentDir, + '..', + '..', + 'plugin', + 'default-entry', +) + +export const solidStartDefaultEntryPaths = { + client: path.resolve(defaultEntryDir, 'client.tsx'), + server: path.resolve(defaultEntryDir, 'server.ts'), + start: path.resolve(defaultEntryDir, 'start.ts'), +} diff --git a/packages/solid-start/src/plugin/vite.ts b/packages/solid-start/src/plugin/vite.ts index b8c82f6628..cb3f57f703 100644 --- a/packages/solid-start/src/plugin/vite.ts +++ b/packages/solid-start/src/plugin/vite.ts @@ -1,29 +1,27 @@ -import { fileURLToPath } from 'node:url' import { - TanStackStartVitePluginCore, - VITE_ENVIRONMENT_NAMES, -} from '@tanstack/start-plugin-core' -import path from 'pathe' -import type { TanStackStartInputConfig } from '@tanstack/start-plugin-core' + START_ENVIRONMENT_NAMES, + tanStackStartVite, +} from '@tanstack/start-plugin-core/vite' +import type { + TanStackStartViteInputConfig, + TanStackStartVitePluginCoreOptions, +} from '@tanstack/start-plugin-core/vite' +import { solidStartDefaultEntryPaths } from './shared' import type { PluginOption } from 'vite' -const currentDir = path.dirname(fileURLToPath(import.meta.url)) -const defaultEntryDir = path.resolve( - currentDir, - '..', - '..', - 'plugin', - 'default-entry', -) -const defaultEntryPaths = { - client: path.resolve(defaultEntryDir, 'client.tsx'), - server: path.resolve(defaultEntryDir, 'server.ts'), - start: path.resolve(defaultEntryDir, 'start.ts'), -} - export function tanstackStart( - options?: TanStackStartInputConfig, + options?: TanStackStartViteInputConfig, ): Array<PluginOption> { + const corePluginOpts: TanStackStartVitePluginCoreOptions = { + framework: 'solid', + defaultEntryPaths: solidStartDefaultEntryPaths, + providerEnvironmentName: START_ENVIRONMENT_NAMES.server, + ssrIsProvider: true, + ssrResolverStrategy: { + type: 'default', + }, + } + return [ { name: 'tanstack-solid-start:config', @@ -39,13 +37,20 @@ export function tanstackStart( resolve: { dedupe: ['solid-js', '@solidjs/web', '@solidjs/signals'], }, + ssr: { + noExternal: [ + '@tanstack/solid-router-ssr-query', + '@tanstack/solid-query', + '@tanstack/solid-query-devtools', + ], + }, } }, configEnvironment(environmentName, options) { return { optimizeDeps: - environmentName === VITE_ENVIRONMENT_NAMES.client || - (environmentName === VITE_ENVIRONMENT_NAMES.server && + environmentName === START_ENVIRONMENT_NAMES.client || + (environmentName === START_ENVIRONMENT_NAMES.server && // This indicates that the server environment has opted in to dependency optimization options.optimizeDeps?.noDiscovery === false) ? { @@ -60,12 +65,6 @@ export function tanstackStart( } }, }, - TanStackStartVitePluginCore( - { - framework: 'solid', - defaultEntryPaths, - }, - options, - ), + tanStackStartVite(corePluginOpts, options), ] } diff --git a/packages/solid-start/src/useServerFn.ts b/packages/solid-start/src/useServerFn.ts index b5144bbc93..c91c643a33 100644 --- a/packages/solid-start/src/useServerFn.ts +++ b/packages/solid-start/src/useServerFn.ts @@ -16,7 +16,7 @@ export function useServerFn<T extends (...deps: Array<any>) => Promise<any>>( return res } catch (err) { if (isRedirect(err)) { - err.options._fromLocation = router.stores.location.state + err.options._fromLocation = router.stores.location.get() return router.navigate(router.resolveRedirect(err).options) } diff --git a/packages/solid-start/vite.config.ts b/packages/solid-start/vite.config.ts index aa3eded1f4..2c1a42d0e4 100644 --- a/packages/solid-start/vite.config.ts +++ b/packages/solid-start/vite.config.ts @@ -27,10 +27,12 @@ export default mergeConfig( entry: [ './src/index.ts', './src/client.tsx', + './src/hydration.ts', './src/client-rpc.ts', './src/ssr-rpc.ts', './src/server-rpc.ts', './src/server.tsx', + './src/plugin/rsbuild.ts', './src/plugin/vite.ts', './src/server-only.ts', './src/client-only.ts', diff --git a/packages/start-client-core/CHANGELOG.md b/packages/start-client-core/CHANGELOG.md index 5b0acfab91..f6e95e9849 100644 --- a/packages/start-client-core/CHANGELOG.md +++ b/packages/start-client-core/CHANGELOG.md @@ -1,5 +1,236 @@ # @tanstack/start-client-core +## 1.170.6 + +### Patch Changes + +- Updated dependencies [[`2f53749`](https://github.com/TanStack/router/commit/2f5374945e2138559a51464f45a5152eae67e1dd)]: + - @tanstack/router-core@1.171.8 + - @tanstack/start-storage-context@1.167.10 + +## 1.170.5 + +### Patch Changes + +- Updated dependencies [[`d1997b6`](https://github.com/TanStack/router/commit/d1997b66d7c24c1d64772bb8bab5caf9c6d9cc48)]: + - @tanstack/router-core@1.171.7 + - @tanstack/start-storage-context@1.167.9 + +## 1.170.4 + +### Patch Changes + +- Fix serialization adapter module resolution in TanStack Start. Vite dev now uses clean runtime-specific virtual module IDs instead of browser requests containing encoded null-byte virtual IDs, which avoids reverse proxy failures. When no serialization adapters are configured, Vite and Rsbuild now resolve `#tanstack-start-plugin-adapters` through the package empty-adapter fallback. ([#7484](https://github.com/TanStack/router/pull/7484)) + +## 1.170.3 + +### Patch Changes + +- Updated dependencies [[`51a97a1`](https://github.com/TanStack/router/commit/51a97a167fb3ef1b8ca70fbb63db635158f43509)]: + - @tanstack/router-core@1.171.6 + - @tanstack/start-storage-context@1.167.8 + +## 1.170.2 + +### Patch Changes + +- Updated dependencies [[`5268ba4`](https://github.com/TanStack/router/commit/5268ba4566233ea58880df85f167ad0401a93a46)]: + - @tanstack/router-core@1.171.5 + - @tanstack/start-storage-context@1.167.7 + +## 1.170.1 + +### Patch Changes + +- Updated dependencies [[`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960), [`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960)]: + - @tanstack/router-core@1.171.4 + - @tanstack/start-storage-context@1.167.6 + +## 1.170.0 + +### Minor Changes + +- Add deferred Hydrate boundary support for TanStack Start. ([#7362](https://github.com/TanStack/router/pull/7362)) + + Hydrate boundaries can now be code-split by the Start compiler, preload their generated client chunks, preserve server-rendered fallback HTML, and replay interaction-triggered events after hydration. The compiler integration now uses a Start-owned compiler plugin for Hydrate virtual modules across Vite and Rsbuild, with dev invalidation for generated virtual modules. + + Shared AST utilities used by the router code-splitter and Hydrate virtual modules were moved into `@tanstack/router-utils` so both pipelines can retain referenced top-level declarations, unwrap local exports, and let dead-code elimination remove unused route module code. + +### Patch Changes + +- Updated dependencies [[`5fa9e55`](https://github.com/TanStack/router/commit/5fa9e555f3a2edb5e45586623e6bcbfa7f7c7a6b)]: + - @tanstack/router-core@1.171.3 + - @tanstack/start-storage-context@1.167.5 + +## 1.169.4 + +### Patch Changes + +- Updated dependencies [[`b60eb36`](https://github.com/TanStack/router/commit/b60eb36e59e8a468ee0742cbcf7f47aca1ff1c67)]: + - @tanstack/router-core@1.171.2 + - @tanstack/start-storage-context@1.167.4 + +## 1.169.3 + +### Patch Changes + +- Updated dependencies [[`d9cf933`](https://github.com/TanStack/router/commit/d9cf9331b83fcbd2abfee75d839d862f9bb18e6b)]: + - @tanstack/router-core@1.171.1 + - @tanstack/start-storage-context@1.167.3 + +## 1.169.2 + +### Patch Changes + +- Updated dependencies [[`d533f87`](https://github.com/TanStack/router/commit/d533f87976704098a40b48f160b37c28c8182806)]: + - @tanstack/router-core@1.171.0 + - @tanstack/start-storage-context@1.167.2 + +## 1.169.1 + +### Patch Changes + +- Updated dependencies [[`2387a2e`](https://github.com/TanStack/router/commit/2387a2eea0683004cc400b9f71bed5944eb60110)]: + - @tanstack/router-core@1.170.1 + - @tanstack/start-storage-context@1.167.1 + +## 1.169.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- Updated dependencies [[`b1c061a`](https://github.com/TanStack/router/commit/b1c061aff9185cdf5fdc08c0136382a9dce0302f), [`201e150`](https://github.com/TanStack/router/commit/201e150bd1412bae2faa9ce53f0fefcb7574ac14), [`5ae2ae5`](https://github.com/TanStack/router/commit/5ae2ae5e0f8ce32e02667a482ea9be52a6150240)]: + - @tanstack/router-core@1.170.0 + - @tanstack/start-fn-stubs@1.162.0 + - @tanstack/start-storage-context@1.167.0 + +## 1.168.2 + +### Patch Changes + +- Update seroval dependencies to version 1.5.4. ([#7340](https://github.com/TanStack/router/pull/7340)) + +- Updated dependencies [[`35e88f0`](https://github.com/TanStack/router/commit/35e88f04996d71019a1868b7b06ecb4ddbc9df9e)]: + - @tanstack/router-core@1.169.2 + - @tanstack/start-storage-context@1.166.35 + +## 1.168.1 + +### Patch Changes + +- Updated dependencies [[`4a1e63f`](https://github.com/TanStack/router/commit/4a1e63f1d1230b1ed8234609acad4639d8982c13)]: + - @tanstack/router-core@1.169.1 + - @tanstack/start-storage-context@1.166.34 + +## 1.168.0 + +### Minor Changes + +- Add a `strict` option to `createServerFn` for type-level server function serialization checks. Use `strict: false` to opt out for input and output values, or `strict: { output: false }` to opt out for return values only. ([#7277](https://github.com/TanStack/router/pull/7277)) + +## 1.167.22 + +### Patch Changes + +- Updated dependencies [[`c992495`](https://github.com/TanStack/router/commit/c992495bf4010ff4c3597bb1f3b1ba02594e857e)]: + - @tanstack/router-core@1.169.0 + - @tanstack/start-storage-context@1.166.33 + +## 1.167.21 + +### Patch Changes + +- Updated dependencies [[`b5c4183`](https://github.com/TanStack/router/commit/b5c4183ab8b44be8a75647b7f7b588ad7c146ece)]: + - @tanstack/router-core@1.168.18 + - @tanstack/start-storage-context@1.166.32 + +## 1.167.20 + +### Patch Changes + +- Updated dependencies [[`493148b`](https://github.com/TanStack/router/commit/493148bc5378b7f9de1544d87f6aaa425c12eb34)]: + - @tanstack/router-core@1.168.17 + - @tanstack/start-storage-context@1.166.31 + +## 1.167.19 + +### Patch Changes + +- refactor(start-client-core): use a more explicit typing to `CustomFetch` type ([#7258](https://github.com/TanStack/router/pull/7258)) + +## 1.167.18 + +### Patch Changes + +- Updated dependencies [[`4d864ee`](https://github.com/TanStack/router/commit/4d864eebbd184265eabb563d326ab409c93feb17)]: + - @tanstack/router-core@1.168.16 + - @tanstack/start-storage-context@1.166.30 + +## 1.167.17 + +### Patch Changes + +- Updated dependencies [[`16f6892`](https://github.com/TanStack/router/commit/16f6892d6b7ceadf606677c5a40e743f29163aa6)]: + - @tanstack/router-core@1.168.15 + - @tanstack/start-storage-context@1.166.29 + +## 1.167.16 + +### Patch Changes + +- Updated dependencies [[`0e2c900`](https://github.com/TanStack/router/commit/0e2c9003c18ae07c09969189c028f277ea562a7a)]: + - @tanstack/router-core@1.168.14 + - @tanstack/start-storage-context@1.166.28 + +## 1.167.15 + +### Patch Changes + +- Updated dependencies [[`812792f`](https://github.com/TanStack/router/commit/812792fbda3caf97b300770855cf5641252f413b)]: + - @tanstack/router-core@1.168.13 + - @tanstack/start-storage-context@1.166.27 + +## 1.167.14 + +### Patch Changes + +- Updated dependencies [[`8ec9ca9`](https://github.com/TanStack/router/commit/8ec9ca97b472779de878c2a6510f21deb24d386c)]: + - @tanstack/router-core@1.168.12 + - @tanstack/start-storage-context@1.166.26 + +## 1.167.13 + +### Patch Changes + +- Updated dependencies [[`6355bb7`](https://github.com/TanStack/router/commit/6355bb75f7637ba77f06a923c18fdaf37720bb48)]: + - @tanstack/router-core@1.168.11 + - @tanstack/start-storage-context@1.166.25 + +## 1.167.12 + +### Patch Changes + +- migrate createStore > createAtom for simpler API ([#7150](https://github.com/TanStack/router/pull/7150)) + +- Updated dependencies [[`459057c`](https://github.com/TanStack/router/commit/459057cd2d90cff20d20e51d4964b0a8c950555e)]: + - @tanstack/router-core@1.168.10 + - @tanstack/start-storage-context@1.166.24 + +## 1.167.11 + +### Patch Changes + +- fix publishing ([`f8ac427`](https://github.com/TanStack/router/commit/f8ac427000c3fec99225926e72f9f2fc7a37231f)) + +## 1.167.10 + +### Patch Changes + +- Ensure request middleware context wins over colliding client-provided context in server function execution paths, including SSR, GET, and FormData requests. ([#7135](https://github.com/TanStack/router/pull/7135)) + ## 1.167.9 ### Patch Changes diff --git a/packages/start-client-core/bin/intent.js b/packages/start-client-core/bin/intent.js deleted file mode 100755 index 5b08532885..0000000000 --- a/packages/start-client-core/bin/intent.js +++ /dev/null @@ -1,25 +0,0 @@ -#!/usr/bin/env node -// Auto-generated by @tanstack/intent setup -// Exposes the intent end-user CLI for consumers of this library. -// Commit this file, then add to your package.json: -// "bin": { "intent": "./bin/intent.js" } -try { - await import('@tanstack/intent/intent-library') -} catch (e) { - const isModuleNotFound = - e?.code === 'ERR_MODULE_NOT_FOUND' || e?.code === 'MODULE_NOT_FOUND' - const missingIntentLibrary = - typeof e?.message === 'string' && e.message.includes('@tanstack/intent') - - if (isModuleNotFound && missingIntentLibrary) { - console.error('@tanstack/intent is not installed.') - console.error('') - console.error('Install it as a dev dependency:') - console.error(' npm add -D @tanstack/intent') - console.error('') - console.error('Or run directly:') - console.error(' npx @tanstack/intent@latest list') - process.exit(1) - } - throw e -} diff --git a/packages/start-client-core/package.json b/packages/start-client-core/package.json index 88f8855ba7..a607ff9bd1 100644 --- a/packages/start-client-core/package.json +++ b/packages/start-client-core/package.json @@ -1,6 +1,6 @@ { "name": "@tanstack/start-client-core", - "version": "1.167.9", + "version": "1.170.6", "description": "Modern and scalable routing for React applications", "author": "Tanner Linsley", "license": "MIT", @@ -60,14 +60,38 @@ "default": "./dist/esm/client-rpc/index.js" } }, + "./hydration": { + "import": { + "types": "./dist/esm/hydration.d.ts", + "default": "./dist/esm/hydration.js" + } + }, + "./hydration/constants": { + "import": { + "types": "./dist/esm/hydration/constants.d.ts", + "default": "./dist/esm/hydration/constants.js" + } + }, + "./hydration/runtime": { + "import": { + "types": "./dist/esm/hydration/runtime.d.ts", + "default": "./dist/esm/hydration/runtime.js" + } + }, "./package.json": "./package.json" }, "imports": { "#tanstack-start-entry": { - "default": "./dist/esm/fake-start-entry.js" + "types": "./src/start-entry.d.ts", + "default": "./dist/esm/fake-entries/start.js" }, "#tanstack-router-entry": { - "default": "./dist/esm/fake-start-entry.js" + "types": "./src/start-entry.d.ts", + "default": "./dist/esm/fake-entries/router.js" + }, + "#tanstack-start-plugin-adapters": { + "types": "./src/start-entry.d.ts", + "default": "./dist/esm/empty-plugin-adapters.js" } }, "sideEffects": false, @@ -85,14 +109,10 @@ "@tanstack/router-core": "workspace:*", "@tanstack/start-fn-stubs": "workspace:*", "@tanstack/start-storage-context": "workspace:*", - "seroval": "^1.4.2" + "seroval": "^1.5.4" }, "devDependencies": { - "@tanstack/intent": "^0.0.14", "vite": "*", "@types/node": ">=20" - }, - "bin": { - "intent": "./bin/intent.js" } } diff --git a/packages/start-client-core/skills/start-core/SKILL.md b/packages/start-client-core/skills/start-core/SKILL.md index 1dd98450e7..82481417bc 100644 --- a/packages/start-client-core/skills/start-core/SKILL.md +++ b/packages/start-client-core/skills/start-core/SKILL.md @@ -24,13 +24,14 @@ TanStack Start is a full-stack React framework built on TanStack Router and Vite ## Sub-Skills -| Task | Sub-Skill | -| -------------------------------------------- | ------------------------------------------------------------------- | -| Type-safe RPCs, data fetching, mutations | [start-core/server-functions/SKILL.md](./server-functions/SKILL.md) | -| Request/function middleware, context, auth | [start-core/middleware/SKILL.md](./middleware/SKILL.md) | -| Isomorphic execution, environment boundaries | [start-core/execution-model/SKILL.md](./execution-model/SKILL.md) | -| REST API endpoints alongside app routes | [start-core/server-routes/SKILL.md](./server-routes/SKILL.md) | -| Hosting, SSR modes, prerendering, SEO | [start-core/deployment/SKILL.md](./deployment/SKILL.md) | +| Task | Sub-Skill | +| ------------------------------------------------ | ------------------------------------------------------------------------------- | +| Type-safe RPCs, data fetching, mutations | [start-core/server-functions/SKILL.md](./server-functions/SKILL.md) | +| Request/function middleware, context, auth | [start-core/middleware/SKILL.md](./middleware/SKILL.md) | +| Server-side auth: sessions, cookies, OAuth, CSRF | [start-core/auth-server-primitives/SKILL.md](./auth-server-primitives/SKILL.md) | +| Isomorphic execution, environment boundaries | [start-core/execution-model/SKILL.md](./execution-model/SKILL.md) | +| REST API endpoints alongside app routes | [start-core/server-routes/SKILL.md](./server-routes/SKILL.md) | +| Hosting, SSR modes, prerendering, SEO | [start-core/deployment/SKILL.md](./deployment/SKILL.md) | ## Quick Decision Tree @@ -41,6 +42,9 @@ Need to run code exclusively on the server (DB, secrets)? Need auth checks, logging, or shared logic across server functions? → start-core/middleware +Need to add login, sessions, OAuth, CSRF, password reset? + → start-core/auth-server-primitives + Need to understand where code runs (server vs client)? → start-core/execution-model diff --git a/packages/start-client-core/skills/start-core/auth-server-primitives/SKILL.md b/packages/start-client-core/skills/start-core/auth-server-primitives/SKILL.md new file mode 100644 index 0000000000..ff696f631e --- /dev/null +++ b/packages/start-client-core/skills/start-core/auth-server-primitives/SKILL.md @@ -0,0 +1,410 @@ +--- +name: start-core/auth-server-primitives +description: >- + Server-side authentication primitives for TanStack Start: session + cookies (HttpOnly, Secure, SameSite, __Host- prefix), session + read/issue/destroy via createServerFn and middleware, OAuth + authorization-code flow with state and PKCE, password-reset + enumeration defense, CSRF for non-GET RPCs, rate limiting auth + endpoints, session rotation on privilege change. Pairs with + router-core/auth-and-guards for the routing side. +type: sub-skill +library: tanstack-start +library_version: '1.166.2' +requires: + - start-core + - start-core/server-functions + - start-core/middleware +sources: + - TanStack/router:docs/start/framework/react/guide/authentication-overview.md + - TanStack/router:docs/start/framework/react/guide/authentication-server-primitives.md +--- + +# Auth Server Primitives + +This skill covers the **server half** of authentication: session storage, cookie issuance, OAuth flow, password-reset hardening, CSRF, rate limiting. For the **routing half** (`_authenticated` layout, `beforeLoad` redirects, RBAC checks), see [router-core/auth-and-guards](../../../../router-core/skills/router-core/auth-and-guards/SKILL.md). + +> **CRITICAL**: A route guard does NOT protect a `createServerFn` on that route. Server functions are RPC endpoints reachable by direct POST regardless of which route renders them. Auth must be enforced **inside the handler** (or via middleware), not on the calling route. +> **CRITICAL**: Validating the _shape_ of a client-supplied identifier (`z.string().uuid().parse(...)`) is not authorization. A parsed UUID is still _some_ tenant — re-check membership against the session principal before using it. +> **CRITICAL**: Read session/cookies inside `.handler()` or middleware `.server()`, not at module scope. Module-level reads run before requests exist (and are also undefined on Cloudflare Workers). + +## Session Cookies + +The recommended session storage is an HTTP-only cookie holding either an opaque session ID (with server-side lookup) or a signed/encrypted token. The cookie flags matter — set them all. + +```tsx +// src/server/session.ts +import { + getRequestHeader, + setResponseHeader, +} from '@tanstack/react-start/server' + +const SESSION_COOKIE = '__Host-session' // __Host- prefix binds to the exact origin + path '/' +const ONE_DAY = 60 * 60 * 24 + +export function setSessionCookie(token: string) { + setResponseHeader( + 'Set-Cookie', + [ + `${SESSION_COOKIE}=${token}`, + `HttpOnly`, // not readable from JS — defeats XSS exfiltration + `Secure`, // HTTPS only (required for __Host- prefix) + `SameSite=Lax`, // sent on top-level navigations, blocks most CSRF + `Path=/`, // required for __Host- prefix + `Max-Age=${ONE_DAY}`, + ].join('; '), + ) +} + +export function clearSessionCookie() { + setResponseHeader( + 'Set-Cookie', + `${SESSION_COOKIE}=; HttpOnly; Secure; SameSite=Lax; Path=/; Max-Age=0`, + ) +} + +export function readSessionToken(): string | null { + const header = getRequestHeader('cookie') + if (!header) return null + for (const part of header.split(/;\s*/)) { + // Split only on the FIRST '=' — signed/base64 values often contain '='. + const eq = part.indexOf('=') + if (eq === -1) continue + if (part.slice(0, eq) === SESSION_COOKIE) return part.slice(eq + 1) + } + return null +} +``` + +Flag rationale: + +- `HttpOnly` — JavaScript can't read the cookie, so an XSS bug can't steal the session. +- `Secure` — HTTPS only. Required when using `__Host-` prefix. +- `SameSite=Lax` — blocks CSRF on most cross-origin POST/PUT/DELETE. Use `Strict` for highest-security flows where loss of cross-site GET navigation is acceptable. +- `__Host-` prefix — binds the cookie to the exact origin (no Domain attribute, Path must be `/`, Secure must be set). Prevents subdomain takeover from forging a session cookie. +- `Path=/` — required by `__Host-`. +- `Max-Age` — finite lifetime so a stolen cookie isn't useful forever. Pair with server-side session rotation. + +## Session Lookup as Middleware + +Use middleware to centralize session loading so every protected handler sees a typed session: + +```tsx +// src/server/auth-middleware.ts +import { createMiddleware } from '@tanstack/react-start' +import { readSessionToken } from './session' + +export const authMiddleware = createMiddleware({ type: 'function' }).server( + async ({ next }) => { + const token = readSessionToken() + const session = token ? await db.sessions.findValid(token) : null + if (!session) throw new Error('Unauthorized') + return next({ context: { session } }) + }, +) +``` + +Attach it to every server function that needs a logged-in user: + +```tsx +import { createServerFn } from '@tanstack/react-start' +import { authMiddleware } from '~/server/auth-middleware' + +export const getMyOrders = createServerFn({ method: 'GET' }) + .middleware([authMiddleware]) + .handler(async ({ context }) => { + return db.orders.findMany({ where: { userId: context.session.userId } }) + }) +``` + +> **Route guards do not cover this.** A `createFileRoute('/_authenticated/orders')` with a `beforeLoad` redirect does NOT protect `getMyOrders` — the RPC is reachable via direct POST whether or not the user ever hits the route. Apply `authMiddleware` (or re-check inside `.handler()`) on every server function that needs auth. + +## Issuing a Session on Login + +```tsx +// src/server/login.functions.ts +import { createServerFn } from '@tanstack/react-start' +import { z } from 'zod' +import { setSessionCookie } from './session' + +export const login = createServerFn({ method: 'POST' }) + .inputValidator(z.object({ email: z.string().email(), password: z.string() })) + .handler(async ({ data }) => { + const user = await db.users.findByEmail(data.email) + // Always run verifyPasswordHash — even when the user doesn't exist — + // so the user-not-found branch takes the same time as wrong-password. + // DUMMY_PASSWORD_HASH is a hash of any throwaway password computed once + // at startup with the same algorithm/cost as real password hashes. + const hashToCheck = user?.passwordHash ?? DUMMY_PASSWORD_HASH + const passwordMatches = await verifyPasswordHash(hashToCheck, data.password) + const ok = user != null && passwordMatches + if (!ok) throw new Error('Invalid email or password') + + // ROTATE on privilege change: destroy any existing session, then issue fresh. + await db.sessions.revokeAllForUser(user.id) + const token = await db.sessions.create({ userId: user.id }) + setSessionCookie(token) + return { ok: true } + }) +``` + +## Logout + +```tsx +import { createServerFn } from '@tanstack/react-start' +import { authMiddleware } from '~/server/auth-middleware' +import { clearSessionCookie } from '~/server/session' + +export const logout = createServerFn({ method: 'POST' }) + .middleware([authMiddleware]) + .handler(async ({ context }) => { + await db.sessions.revoke(context.session.id) + clearSessionCookie() + return { ok: true } + }) +``` + +## OAuth: state + PKCE + +For OAuth authorization-code flow, generate a one-time `state` (CSRF defense) and a PKCE verifier (defense against authorization-code interception). Store both in a short-lived signed cookie keyed to this exact login attempt. + +```tsx +// src/server/oauth.functions.ts +import { createServerFn } from '@tanstack/react-start' +import { redirect } from '@tanstack/react-router' +import { + getRequestHeader, + setResponseHeader, +} from '@tanstack/react-start/server' +import crypto from 'node:crypto' + +const OAUTH_STATE_COOKIE = '__Host-oauth' // expires fast; one-shot + +function base64url(buf: Buffer) { + return buf + .toString('base64') + .replace(/=/g, '') + .replace(/\+/g, '-') + .replace(/\//g, '_') +} + +export const startOAuth = createServerFn({ method: 'GET' }).handler( + async () => { + const state = base64url(crypto.randomBytes(32)) + const verifier = base64url(crypto.randomBytes(32)) + const challenge = base64url( + crypto.createHash('sha256').update(verifier).digest(), + ) + + setResponseHeader( + 'Set-Cookie', + `${OAUTH_STATE_COOKIE}=${signed({ state, verifier })}; HttpOnly; Secure; SameSite=Lax; Path=/; Max-Age=600`, + ) + + throw redirect({ + href: + `https://provider.example/authorize` + + `?response_type=code` + + `&client_id=${process.env.OAUTH_CLIENT_ID}` + + `&redirect_uri=${encodeURIComponent(process.env.OAUTH_REDIRECT_URI!)}` + + `&state=${state}` + + `&code_challenge=${challenge}` + + `&code_challenge_method=S256`, + }) + }, +) +``` + +In the callback handler, **verify the cookie state matches the returned state** and exchange the code with the verifier. If state is missing or doesn't match, abort — the request did not originate from your `startOAuth`. + +## Password Reset: defeat user enumeration + +When a user requests a reset, do not let the response shape or timing reveal whether the email is registered. + +```tsx +import { createServerFn } from '@tanstack/react-start' +import { z } from 'zod' + +export const requestPasswordReset = createServerFn({ method: 'POST' }) + .inputValidator(z.object({ email: z.string().email() })) + .handler(async ({ data }) => { + const user = await db.users.findByEmail(data.email) + if (user) { + const token = await db.passwordResets.issue(user.id) + await sendResetEmail(user.email, token) + } + // Always 200, always the same body, regardless of whether the user exists. + // The user is told to check their inbox; no confirmation either way. + return { ok: true } + }) +``` + +Do NOT: + +- Return 200 if exists, 404 if not. +- Use a different message ("we sent you a link" vs "no account found"). +- Skip the work when the user doesn't exist (timing leak — measurable from the wire). + +## CSRF for non-GET RPCs + +`SameSite=Lax` on the session cookie blocks most cross-site CSRF for POST/PUT/DELETE. Two cases need extra defense: + +1. **Top-level GET navigation that mutates** — never do this. Always use POST/PUT/DELETE for mutations. +2. **POST from a page on a sibling subdomain** — `SameSite=Lax` does NOT block this; verify the `Origin` header matches your app's origin in middleware. + +```tsx +import { createMiddleware } from '@tanstack/react-start' +import { getRequest } from '@tanstack/react-start/server' + +export const csrfMiddleware = createMiddleware().server(async ({ next }) => { + const request = getRequest() + if (request.method !== 'GET' && request.method !== 'HEAD') { + const origin = request.headers.get('origin') + // Compare the FULL origin (scheme + host + port) — host alone lets + // http://example.com pass a check meant for https://example.com. + if (!origin || new URL(origin).origin !== process.env.APP_ORIGIN) { + throw new Error('Origin check failed') + } + } + return next() +}) +``` + +Attach this to global request middleware in `src/start.ts` so it covers every non-GET request, including server routes and SSR. + +## Rate Limiting Auth Endpoints + +A login endpoint without rate limiting is a credential-stuffing target. Limit per-IP (and ideally per-account) with a sliding window. + +```tsx +import { createMiddleware } from '@tanstack/react-start' +import { getRequest } from '@tanstack/react-start/server' + +function rateLimitMiddleware(opts: { + key: string + max: number + windowMs: number +}) { + return createMiddleware().server(async ({ next }) => { + const request = getRequest() + const ip = + request.headers.get('cf-connecting-ip') ?? + request.headers.get('x-forwarded-for')?.split(',')[0] ?? + 'unknown' + const bucketKey = `rl:${opts.key}:${ip}` + const allowed = await rateLimiter.consume( + bucketKey, + opts.max, + opts.windowMs, + ) + if (!allowed) throw new Error('Too many requests') + return next() + }) +} + +// On the login server function: +export const login = createServerFn({ method: 'POST' }).middleware([ + rateLimitMiddleware({ key: 'login', max: 5, windowMs: 60_000 }), +]) +// ... +``` + +## Session Rotation on Privilege Change + +Whenever the user's privileges change — login, logout, role change, password change — **destroy the old session and issue a new one**. This neutralizes session-fixation attacks where an attacker plants their own session ID in the victim's browser before login. + +```tsx +// In the login handler (already shown above): destroy any pre-login session, then create a fresh one. +await db.sessions.revokeAllForUser(user.id) +const token = await db.sessions.create({ userId: user.id }) +setSessionCookie(token) +``` + +```tsx +// On password change / role grant: +await db.sessions.revokeAllForUser(user.id) // destroy existing +const token = await db.sessions.create({ userId: user.id }) // issue fresh +setSessionCookie(token) +``` + +## Common Mistakes + +### CRITICAL: Trusting the route guard for server-function auth + +```tsx +// WRONG — the RPC is callable directly via POST regardless of the route +export const Route = createFileRoute('/_authenticated/orders')({ + beforeLoad: ({ context }) => { + if (!context.auth.isAuthenticated) throw redirect({ to: '/login' }) + }, +}) +const getMyOrders = createServerFn({ method: 'GET' }).handler(async () => { + return db.orders.findMany() // ← anyone can hit the RPC and get all orders +}) + +// CORRECT — auth enforced on the handler itself +const getMyOrders = createServerFn({ method: 'GET' }) + .middleware([authMiddleware]) + .handler(async ({ context }) => { + return db.orders.findMany({ where: { userId: context.session.userId } }) + }) +``` + +### CRITICAL: Treating shape validation as authorization + +A parsed UUID is _some_ workspace, not an _authorized_ workspace. + +```tsx +// WRONG — UUID is well-formed but the user may not be a member +const getWorkspaceData = createServerFn({ method: 'GET' }) + .middleware([authMiddleware]) + .inputValidator(z.object({ workspaceId: z.string().uuid() })) + .handler(async ({ context, data }) => { + return db.workspaces.findById(data.workspaceId) // missing membership check! + }) + +// CORRECT — verify the session principal has access to that workspace +const getWorkspaceData = createServerFn({ method: 'GET' }) + .middleware([authMiddleware]) + .inputValidator(z.object({ workspaceId: z.string().uuid() })) + .handler(async ({ context, data }) => { + const member = await db.memberships.find({ + userId: context.session.userId, + workspaceId: data.workspaceId, + }) + if (!member) throw new Error('Not a member of this workspace') + return db.workspaces.findById(data.workspaceId) + }) +``` + +### HIGH: Returning different responses based on email existence + +Already covered above — `requestPasswordReset` must return the same body regardless of whether the email matches a user. + +### HIGH: Reading cookies/env at module scope + +```tsx +// WRONG — module-load time, before any request exists +const SESSION_SECRET = process.env.SESSION_SECRET +export function signSession(payload) { + return sign(payload, SESSION_SECRET) +} + +// CORRECT — read inside per-request callback +export function signSession(payload) { + return sign(payload, process.env.SESSION_SECRET) +} +``` + +On Cloudflare Workers and other edge runtimes, the module-level read evaluates to `undefined` even on the server because env is injected per-request. See [start-core/execution-model](../execution-model/SKILL.md). + +### MEDIUM: Long-lived sessions with no rotation + +A session token that never rotates is functionally a long-lived credential. Rotate on login, logout, password change, and role/permission change. + +## Cross-References + +- [router-core/auth-and-guards](../../../../router-core/skills/router-core/auth-and-guards/SKILL.md) — the routing side: `_authenticated` layout, `beforeLoad`, `redirect`, RBAC checks. +- [start-core/server-functions](../server-functions/SKILL.md) — how to expose RPCs (and how the route guard does NOT cover them). +- [start-core/middleware](../middleware/SKILL.md) — composing `authMiddleware` and others. +- [start-core/execution-model](../execution-model/SKILL.md) — why module-level env/secret reads are wrong. diff --git a/packages/start-client-core/skills/start-core/deployment/SKILL.md b/packages/start-client-core/skills/start-core/deployment/SKILL.md index e37607fb16..62111f9edd 100644 --- a/packages/start-client-core/skills/start-core/deployment/SKILL.md +++ b/packages/start-client-core/skills/start-core/deployment/SKILL.md @@ -57,6 +57,15 @@ export default defineConfig({ Deploy: `npx wrangler login && pnpm run deploy` +> **Worker env is per-request.** Cloudflare Workers inject env vars at request time. `process.env.X` at module scope evaluates to `undefined` even on the server. The Cloudflare-canonical way to read env (including from module scope) is the `cloudflare:workers` env binding: +> +> ```ts +> import { env } from 'cloudflare:workers' +> const apiHost = env.API_HOST +> ``` +> +> Or read `process.env.X` per-request inside `.handler()` / middleware `.server()`. See [Cloudflare's environment-variables docs](https://developers.cloudflare.com/workers/configuration/environment-variables/) and [start-core/execution-model](../execution-model/SKILL.md). + ### Netlify ```bash diff --git a/packages/start-client-core/skills/start-core/execution-model/SKILL.md b/packages/start-client-core/skills/start-core/execution-model/SKILL.md index 9567d93d07..ffed9211dc 100644 --- a/packages/start-client-core/skills/start-core/execution-model/SKILL.md +++ b/packages/start-client-core/skills/start-core/execution-model/SKILL.md @@ -14,6 +14,7 @@ requires: sources: - TanStack/router:docs/start/framework/react/guide/execution-model.md - TanStack/router:docs/start/framework/react/guide/environment-variables.md + - TanStack/router:docs/start/framework/react/guide/import-protection.md --- # Execution Model @@ -21,19 +22,21 @@ sources: Understanding where code runs is fundamental to TanStack Start. This skill covers the isomorphic execution model and how to control environment boundaries. > **CRITICAL**: ALL code in TanStack Start is isomorphic by default — it runs in BOTH server and client bundles. Route loaders run on BOTH server (during SSR) AND client (during navigation). Server-only operations MUST use `createServerFn`. -> **CRITICAL**: Module-level `process.env` access runs in both environments. Secret values leak into the client bundle. Access secrets ONLY inside `createServerFn` or `createServerOnlyFn`. +> **CRITICAL**: Module-level `process.env` access is wrong on **two** axes — security (values leak into the client bundle) AND runtime correctness (on Cloudflare Workers and other edge runtimes, env is injected per-request, so module-level reads evaluate to `undefined` even on the server). Read env inside `.handler()` or another per-request function, never at module scope. > **CRITICAL**: `VITE_` prefixed environment variables are exposed to the client bundle. Server secrets must NOT have the `VITE_` prefix. ## Execution Control APIs -| API | Use Case | Client Behavior | Server Behavior | -| ------------------------ | ------------------------- | ------------------------- | --------------------- | -| `createServerFn()` | RPC calls, data mutations | Network request to server | Direct execution | -| `createServerOnlyFn(fn)` | Utility functions | Throws error | Direct execution | -| `createClientOnlyFn(fn)` | Browser utilities | Direct execution | Throws error | -| `createIsomorphicFn()` | Different impl per env | Uses `.client()` impl | Uses `.server()` impl | -| `<ClientOnly>` | Browser-only components | Renders children | Renders fallback | -| `useHydrated()` | Hydration-dependent logic | `true` after hydration | `false` | +| API | Use Case | Client Behavior | Server Behavior | +| ------------------------------------------- | --------------------------- | ------------------------- | --------------------- | +| `createServerFn()` | RPC calls, data mutations | Network request to server | Direct execution | +| `createServerOnlyFn(fn)` | Utility functions | Throws error | Direct execution | +| `createClientOnlyFn(fn)` | Browser utilities | Direct execution | Throws error | +| `createIsomorphicFn()` | Different impl per env | Uses `.client()` impl | Uses `.server()` impl | +| `<ClientOnly>` | Browser-only components | Renders children | Renders fallback | +| `useHydrated()` | Hydration-dependent logic | `true` after hydration | `false` | +| `import '@tanstack/<fw>-start/server-only'` | Mark whole file server-only | Import denied | Allowed | +| `import '@tanstack/<fw>-start/client-only'` | Mark whole file client-only | Allowed | Import denied | ## Server-Only Execution @@ -125,6 +128,45 @@ const getDeviceInfo = createIsomorphicFn() .client(() => ({ type: 'client', userAgent: navigator.userAgent })) ``` +## Import Protection: File Markers + +> Experimental. + +The `.server.*` and `.client.*` filename suffixes (e.g. `db.server.ts`) opt a file into Start's import protection — it can't be imported from the wrong environment. When you can't or don't want to rename the file, add a side-effect import at the top of the file to apply the same protection by marker: + +```ts +// src/lib/secrets.ts (filename can't be *.server.ts) +import '@tanstack/react-start/server-only' +// (or @tanstack/solid-start/server-only, @tanstack/vue-start/server-only) + +export function getApiKey() { + return process.env.API_KEY +} +``` + +```ts +// src/lib/storage.ts +import '@tanstack/react-start/client-only' +// (or @tanstack/solid-start/client-only, @tanstack/vue-start/client-only) + +export function savePreferences(prefs: Record<string, string>) { + localStorage.setItem('prefs', JSON.stringify(prefs)) +} +``` + +Rules: + +- Both markers in the same file is an error. +- Type-only imports are ignored (they erase to nothing at runtime). +- Default behavior is `error` in production builds and `mock` in dev. The mock returns a recursive Proxy so dev keeps running while you fix the import graph. + +Pick the right tool: + +- File should never run on the wrong side **and** has no client API → `*.server.ts` filename or `import '@tanstack/<fw>-start/server-only'`. +- One symbol needs to behave differently per environment → `createIsomorphicFn().client(...).server(...)`. +- One function should error if called from the wrong side → `createServerOnlyFn` / `createClientOnlyFn`. +- Component renders only after hydration → `<ClientOnly>` or `useHydrated()`. + ## Environment Variables ### Server-Side (inside createServerFn) @@ -229,22 +271,29 @@ export const Route = createFileRoute('/dashboard')({ }) ``` -### 2. CRITICAL: Exposing secrets via module-level process.env +### 2. CRITICAL: Reading process.env at module scope + +Module-level `process.env` reads are wrong for **two** reasons, not one: + +1. **Security:** the value can be inlined into the client bundle, leaking secrets. +2. **Runtime correctness (edge runtimes):** Cloudflare Workers and other edge SSR runtimes inject env at request time. Module-level code runs at module load, before the env exists, so the read evaluates to `undefined` even on the server. The bug only surfaces at deploy time. ```tsx -// WRONG — runs in both environments, value in client bundle +// WRONG — leaks to client AND is undefined on Workers const apiKey = process.env.SECRET_KEY export function fetchData() { - /* uses apiKey */ + /* uses apiKey, which is undefined under Worker SSR */ } -// CORRECT — access inside server function only +// CORRECT — read per-request, inside the handler const fetchData = createServerFn({ method: 'GET' }).handler(async () => { const apiKey = process.env.SECRET_KEY return fetch(url, { headers: { Authorization: apiKey } }) }) ``` +The same rule applies to middleware `.server()` callbacks, server-route handlers, and any function that runs per request — read env there, not at the top of the file. + ### 3. CRITICAL: Using VITE\_ prefix for server secrets ```bash diff --git a/packages/start-client-core/skills/start-core/middleware/SKILL.md b/packages/start-client-core/skills/start-core/middleware/SKILL.md index a1c5b81b7f..7ab9109ebb 100644 --- a/packages/start-client-core/skills/start-core/middleware/SKILL.md +++ b/packages/start-client-core/skills/start-core/middleware/SKILL.md @@ -21,7 +21,7 @@ sources: Middleware customizes the behavior of server functions and server routes. It is composable — middleware can depend on other middleware to form a chain. > **CRITICAL**: TypeScript enforces method order: `middleware()` → `inputValidator()` → `client()` → `server()`. Wrong order causes type errors. -> **CRITICAL**: Client context sent via `sendContext` is NOT validated by default. If you send dynamic user-generated data, validate it in server-side middleware before use. +> **CRITICAL**: Validating the _shape_ of `sendContext` (e.g. `z.string().uuid().parse(...)`) is NOT authorization. A parsed identifier is a well-formed identifier, not an authorized one. Always re-check access against the session principal before using a client-sent ID as a query key, filter, or path parameter. ## Two Types of Middleware @@ -241,7 +241,11 @@ const authMiddleware = createMiddleware().server(async ({ next, request }) => { if (!session) throw new Error('Unauthorized') return next({ context: { session } }) }) +``` +> **Attach `authMiddleware` to every `createServerFn` that needs auth.** Server functions are RPC endpoints — a route `beforeLoad` does NOT protect the RPC, only the route's UI. Pair every protected route with handler-level enforcement here. See [router-core/auth-and-guards](../../../../router-core/skills/router-core/auth-and-guards/SKILL.md) and [start-core/auth-server-primitives](../auth-server-primitives/SKILL.md). + +```tsx type Permissions = Record<string, string[]> function authorizationMiddleware(permissions: Permissions) { @@ -299,23 +303,50 @@ Fetch precedence (highest to lowest): call site → later middleware → earlier ## Common Mistakes -### 1. HIGH: Trusting client sendContext without validation +### 1. CRITICAL: Trusting client sendContext — shape check is not access check + +`sendContext` from a client middleware arrives on the server as untrusted client input. Most agents stop after parsing the shape with Zod and assume the value is safe. It isn't: a parsed UUID is _some_ workspace, not the requesting user's workspace. Without a membership check against the session principal, you've built a tenant-walking endpoint. + +**Layer 1 — WRONG (no validation):** ```tsx -// WRONG — client can send arbitrary data .server(async ({ next, context }) => { + // SQL-injectable AND tenant-walkable await db.query(`SELECT * FROM workspace_${context.workspaceId}`) return next() }) +``` -// CORRECT — validate before use +**Layer 2 — STILL WRONG (shape only):** + +```tsx .server(async ({ next, context }) => { + // Looks safe, isn't. UUID is well-formed but the user may not be a member. const workspaceId = z.string().uuid().parse(context.workspaceId) await db.query('SELECT * FROM workspaces WHERE id = $1', [workspaceId]) return next() }) ``` +**Layer 3 — CORRECT (shape AND access):** + +```tsx +.middleware([authMiddleware]) // session loaded from cookie, NOT from sendContext +.server(async ({ next, context }) => { + const workspaceId = z.string().uuid().parse(context.workspaceId) + // Verify the session principal can access this workspace. + const member = await db.memberships.find({ + userId: context.session.userId, + workspaceId, + }) + if (!member) throw new Error('Not a member of this workspace') + await db.query('SELECT * FROM workspaces WHERE id = $1', [workspaceId]) + return next({ context: { workspaceId } }) +}) +``` + +The session itself must come from a server-trusted source (the cookie + DB lookup in `authMiddleware`), never from `sendContext` — anything the client can send, the client can lie about. See [start-core/auth-server-primitives](../auth-server-primitives/SKILL.md). + ### 2. MEDIUM: Confusing request vs server function middleware Request middleware runs on ALL requests (SSR, routes, functions). Server function middleware runs only for `createServerFn` calls and has `.client()` method. @@ -363,3 +394,5 @@ createMiddleware({ type: 'function' }) - [start-core/server-functions](../server-functions/SKILL.md) — what middleware wraps - [start-core/server-routes](../server-routes/SKILL.md) — middleware on API endpoints +- [start-core/auth-server-primitives](../auth-server-primitives/SKILL.md) — building the `authMiddleware` factory itself: session cookie reads, OAuth state, CSRF +- [router-core/auth-and-guards](../../../../router-core/skills/router-core/auth-and-guards/SKILL.md) — routing-side guards (route `beforeLoad` does NOT protect server functions; pair guards with `authMiddleware` on every protected RPC) diff --git a/packages/start-client-core/skills/start-core/server-functions/SKILL.md b/packages/start-client-core/skills/start-core/server-functions/SKILL.md index 513065da23..b52c1490de 100644 --- a/packages/start-client-core/skills/start-core/server-functions/SKILL.md +++ b/packages/start-client-core/skills/start-core/server-functions/SKILL.md @@ -19,6 +19,7 @@ sources: Server functions are type-safe RPCs created with `createServerFn`. They run exclusively on the server but can be called from anywhere — loaders, components, hooks, event handlers, or other server functions. +> **CRITICAL**: Server functions are RPC endpoints. They are reachable by direct POST regardless of which route renders the calling UI. **Auth must be enforced inside the handler (or via middleware) — a route `beforeLoad` does NOT protect the RPC.** See [start-core/auth-server-primitives](../auth-server-primitives/SKILL.md) for the session/middleware pattern. > **CRITICAL**: Loaders are ISOMORPHIC — they run on BOTH client and server. Database queries, file system access, and secret API keys MUST go inside `createServerFn`, NOT in loaders directly. > **CRITICAL**: Do not use `"use server"` directives, `getServerSideProps`, or any Next.js/Remix server patterns. TanStack Start uses `createServerFn` exclusively. @@ -199,16 +200,29 @@ import { setResponseStatus, } from '@tanstack/react-start/server' -const getCachedData = createServerFn({ method: 'GET' }).handler(async () => { - const request = getRequest() - const authHeader = getRequestHeader('Authorization') - +// Public, non-personalized data — safe to cache shared across users. +const getPublicData = createServerFn({ method: 'GET' }).handler(async () => { setResponseHeaders({ + // 'public' is correct ONLY when the response does not depend on identity. + // For anything tied to a session/user/tenant, use 'private' or 'no-store'. 'Cache-Control': 'public, max-age=300', }) setResponseStatus(200) + return fetchPublicData() +}) - return fetchData() +// Authenticated data — must NOT be 'public'. +const getMyData = createServerFn({ method: 'GET' }).handler(async () => { + const authHeader = getRequestHeader('Authorization') + // ... auth check ... + + setResponseHeaders({ + // 'private' = only the user-agent may cache. Vary by Cookie/Authorization + // so any intermediary that does cache keys by identity, not URL alone. + 'Cache-Control': 'private, max-age=60', + Vary: 'Cookie, Authorization', + }) + return fetchPersonalizedData() }) ``` @@ -254,7 +268,33 @@ Static imports of server functions are safe — the build replaces implementatio ## Common Mistakes -### 1. CRITICAL: Putting server-only code in loaders +### 1. CRITICAL: Relying on a route guard to protect a server function + +A `beforeLoad` redirect protects the **route's UI**, not the **RPC**. `createServerFn` exposes a callable endpoint that an attacker can hit directly — no need to load the route at all. Auth on the route is necessary but not sufficient. + +```tsx +// WRONG — the route guard doesn't reach the handler +const getMyOrders = createServerFn({ method: 'GET' }).handler(async () => { + return db.orders.findMany() // ← anyone can call the RPC +}) +export const Route = createFileRoute('/_authenticated/orders')({ + beforeLoad: ({ context }) => { + if (!context.auth.isAuthenticated) throw redirect({ to: '/login' }) + }, + loader: () => getMyOrders(), +}) + +// CORRECT — auth enforced on the handler itself +const getMyOrders = createServerFn({ method: 'GET' }) + .middleware([authMiddleware]) + .handler(async ({ context }) => { + return db.orders.findMany({ where: { userId: context.session.userId } }) + }) +``` + +Apply `authMiddleware` (or an equivalent in-handler check) to **every** `createServerFn` that needs auth. See [start-core/auth-server-primitives](../auth-server-primitives/SKILL.md) for the full session/middleware pattern and [start-core/middleware](../middleware/SKILL.md) for composing the factory. + +### 2. CRITICAL: Putting server-only code in loaders ```tsx // WRONG — loader is ISOMORPHIC, runs on BOTH client and server @@ -276,22 +316,47 @@ export const Route = createFileRoute('/posts')({ }) ``` -### 2. CRITICAL: Using Next.js/Remix server patterns +### 3. CRITICAL: Using Next.js / Remix / React Router DOM patterns + +If the file lives at `src/pages/`, `app/layout.tsx`, `_app/`, or imports anything from `react-router-dom` or `next/`, it is wrong-framework code. TanStack Start uses `src/routes/` + `createFileRoute` + `createServerFn`. ```tsx // WRONG — "use server" is a React directive, not used in TanStack Start 'use server' export async function getUser() { ... } -// WRONG — getServerSideProps is Next.js +// WRONG — getServerSideProps is Next.js Pages Router export async function getServerSideProps() { ... } -// CORRECT — TanStack Start uses createServerFn +// WRONG — Next.js App Router server component data fetching +export default async function Page() { + const data = await fetch(...).then(r => r.json()) + return <div>{data}</div> +} + +// WRONG — Remix +export async function loader({ request }) { ... } +export async function action({ request }) { ... } + +// WRONG — react-router-dom (a different library) +import { Link, useNavigate } from 'react-router-dom' + +// CORRECT — TanStack Start +import { createServerFn } from '@tanstack/react-start' +import { Link, useNavigate, createFileRoute } from '@tanstack/react-router' + const getUser = createServerFn({ method: 'GET' }) .handler(async () => { ... }) + +export const Route = createFileRoute('/users/$id')({ + loader: ({ params }) => getUser({ data: { id: params.id } }), + component: UserPage, +}) ``` -### 3. HIGH: Dynamic imports for server functions +If you see `src/pages/`, `app/layout.tsx`, or `react-router-dom` in agent output, the agent is generating for the wrong framework. Build will fail or routes will conflict at runtime. + +### 4. HIGH: Dynamic imports for server functions ```tsx // WRONG — can cause bundler issues @@ -301,7 +366,7 @@ const { getUser } = await import('~/utils/users.functions') import { getUser } from '~/utils/users.functions' ``` -### 4. HIGH: Awaiting server function without calling it +### 5. HIGH: Awaiting server function without calling it `createServerFn` returns a function — it must be invoked with `()`: @@ -316,20 +381,53 @@ const data = await getItems() const data = await getItems({ data: { id: '1' } }) ``` -### 5. MEDIUM: Not using useServerFn for component calls +### 6. CRITICAL: Caching authenticated responses with `Cache-Control: public` -When calling server functions from event handlers in components, use `useServerFn` to get proper React integration: +`Cache-Control: public, max-age=N` tells every CDN, proxy, and shared cache between you and the user that this response can be served to anyone. If the response depends on the session (user, tenant, role), the first user's response gets cached and replayed to the next user — a cross-tenant data leak. ```tsx -// WRONG — direct call doesn't integrate with React lifecycle -<button onClick={() => deletePost({ data: { id } })}>Delete</button> +// WRONG — auth'd response, public cache, leaks to next user via CDN +const getMyOrders = createServerFn({ method: 'GET' }).handler(async () => { + const session = await requireSession() // identity-dependent + setResponseHeaders({ 'Cache-Control': 'public, max-age=300' }) + return db.orders.findMany({ where: { userId: session.userId } }) +}) -// CORRECT — useServerFn integrates with React -const deletePostFn = useServerFn(deletePost) -<button onClick={() => deletePostFn({ data: { id } })}>Delete</button> +// CORRECT — private + Vary so any cache that does store it keys by identity +const getMyOrders = createServerFn({ method: 'GET' }).handler(async () => { + const session = await requireSession() + setResponseHeaders({ + 'Cache-Control': 'private, max-age=60', + Vary: 'Cookie, Authorization', + }) + return db.orders.findMany({ where: { userId: session.userId } }) +}) + +// ALSO CORRECT — opt out entirely for sensitive data +setResponseHeaders({ 'Cache-Control': 'no-store' }) ``` +Rule of thumb: if the handler reads a session/cookie/auth header or branches on identity, the response is **not** `public`. Default to `private` (or `no-store` for sensitive data); reach for `public` only on responses that are byte-for-byte identical regardless of who asks. See also [start-core/deployment](../deployment/SKILL.md) for ISR/Cache-Control on full pages. + +### 7. MEDIUM: When to wrap with `useServerFn` + +`useServerFn` is **required** when the server function uses `throw redirect()` or `throw notFound()` — the hook wires the throw into the router so the redirect actually navigates. For server functions that just return data (call them directly or via `useMutation`/`useQuery`), the hook is optional. + +```tsx +// Plain data — direct call is fine (also fine to pass to useMutation/useQuery) +<button onClick={() => deletePost({ data: { id } })}>Delete</button> +useMutation({ mutationFn: deletePost }) + +// Throws redirect/notFound — MUST wrap with useServerFn so the router handles the throw +const signupFn = useServerFn(signup) // signup throws redirect on success +<button onClick={() => signupFn({ data: form })}>Sign up</button> +``` + +If in doubt: wrap with `useServerFn`. It's a no-op for plain-data functions and the safe default when a function might later add a redirect. + ## Cross-References - [start-core/execution-model](../execution-model/SKILL.md) — understanding where code runs - [start-core/middleware](../middleware/SKILL.md) — composing server functions with middleware +- [start-core/auth-server-primitives](../auth-server-primitives/SKILL.md) — sessions, cookies, OAuth, CSRF, rate limiting (the server-side half of auth; `getCurrentUser`/`useSession`-style helpers belong here, not at module scope) +- [router-core/auth-and-guards](../../../../router-core/skills/router-core/auth-and-guards/SKILL.md) — the routing side: route guards do NOT protect server functions, so always re-check auth in the handler or via middleware diff --git a/packages/start-client-core/src/client-rpc/serverFnFetcher.ts b/packages/start-client-core/src/client-rpc/serverFnFetcher.ts index a260928a11..2e993205bc 100644 --- a/packages/start-client-core/src/client-rpc/serverFnFetcher.ts +++ b/packages/start-client-core/src/client-rpc/serverFnFetcher.ts @@ -20,6 +20,70 @@ import type { Plugin as SerovalPlugin } from 'seroval' let serovalPlugins: Array<SerovalPlugin<any, any>> | null = null +/** + * Current async post-processing context for deserialization. + * + * Some deserializers need to perform async work after synchronous deserialization + * (e.g., decoding RSC payloads, fetching remote data). This context allows them + * to register promises that must complete before the deserialized value is used. + * + * This uses a synchronous execution context pattern: + * - Each call to `fromCrossJSON` is synchronous + * - Within that synchronous execution, all `fromSerializable` calls happen + * - We set the context before `fromCrossJSON`, clear it after + * - For streaming chunks, we set/clear context around each `onMessage` call + * + * Even with concurrent server function calls, each individual deserialization + * is atomic (synchronous), so promises are correctly scoped to their call. + */ +let currentPostProcessContext: Array<Promise<unknown>> | null = null + +/** + * Set the current post-processing context for async deserialization work. + * Called before deserialization starts. + * + * @param ctx - Array to collect async work promises, or null to clear + */ +export function setPostProcessContext( + ctx: Array<Promise<unknown>> | null, +): void { + currentPostProcessContext = ctx +} + +/** + * Get the current post-processing context. + * Returns null if no deserialization is in progress. + */ +export function getPostProcessContext(): Array<Promise<unknown>> | null { + return currentPostProcessContext +} + +/** + * Track an async post-processing promise in the current deserialization context. + * Called by deserializers that need to perform async work after sync deserialization. + * + * If no context is active (e.g., on server), this is a no-op. + * + * @param promise - The async work promise to track + */ +export function trackPostProcessPromise(promise: Promise<unknown>): void { + if (currentPostProcessContext) { + currentPostProcessContext.push(promise) + } +} + +/** + * Helper to await all post-processing promises. + * Uses Promise.allSettled to ensure all promises complete even if some reject. + */ +async function awaitPostProcessPromises( + promises: Array<Promise<unknown>>, +): Promise<void> { + if (promises.length > 0) { + await Promise.allSettled(promises) + } +} + /** * Checks if an object has at least one own enumerable property. * More efficient than Object.keys(obj).length > 0 as it short-circuits on first property. @@ -228,23 +292,19 @@ async function getResponse(fn: () => Promise<Response>) { }, }) } - // If it's a stream from the start serializer, process it as such - else if (contentType.includes('application/x-ndjson')) { - const refs = new Map() - result = await processServerFnResponse({ - response, - onMessage: (msg) => - fromCrossJSON(msg, { refs, plugins: serovalPlugins! }), - onError(msg, error) { - // TODO how could we notify consumer that an error occurred? - console.error(msg, error) - }, - }) - } // If it's a JSON response, it can be simpler else if (contentType.includes('application/json')) { const jsonPayload = await response.json() - result = fromCrossJSON(jsonPayload, { plugins: serovalPlugins! }) + // Track async post-processing work for this deserialization + const postProcessPromises: Array<Promise<unknown>> = [] + setPostProcessContext(postProcessPromises) + try { + result = fromCrossJSON(jsonPayload, { plugins: serovalPlugins! }) + } finally { + setPostProcessContext(null) + } + // Await any async post-processing before returning + await awaitPostProcessPromises(postProcessPromises) } if (!result) { @@ -284,93 +344,13 @@ async function getResponse(fn: () => Promise<Response>) { return response } -async function processServerFnResponse({ - response, - onMessage, - onError, -}: { - response: Response - onMessage: (msg: any) => any - onError?: (msg: string, error?: any) => void -}) { - if (!response.body) { - throw new Error('No response body') - } - - const reader = response.body.pipeThrough(new TextDecoderStream()).getReader() - - let buffer = '' - let firstRead = false - let firstObject - - while (!firstRead) { - const { value, done } = await reader.read() - if (value) buffer += value - - if (buffer.length === 0 && done) { - throw new Error('Stream ended before first object') - } - - // common case: buffer ends with newline - if (buffer.endsWith('\n')) { - const lines = buffer.split('\n').filter(Boolean) - const firstLine = lines[0] - if (!firstLine) throw new Error('No JSON line in the first chunk') - firstObject = JSON.parse(firstLine) - firstRead = true - buffer = lines.slice(1).join('\n') - } else { - // fallback: wait for a newline to parse first object safely - const newlineIndex = buffer.indexOf('\n') - if (newlineIndex >= 0) { - const line = buffer.slice(0, newlineIndex).trim() - buffer = buffer.slice(newlineIndex + 1) - if (line.length > 0) { - firstObject = JSON.parse(line) - firstRead = true - } - } - } - } - - // process rest of the stream asynchronously - ;(async () => { - try { - // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition - while (true) { - const { value, done } = await reader.read() - if (value) buffer += value - - const lastNewline = buffer.lastIndexOf('\n') - if (lastNewline >= 0) { - const chunk = buffer.slice(0, lastNewline) - buffer = buffer.slice(lastNewline + 1) - const lines = chunk.split('\n').filter(Boolean) - - for (const line of lines) { - try { - onMessage(JSON.parse(line)) - } catch (e) { - onError?.(`Invalid JSON line: ${line}`, e) - } - } - } - - if (done) { - break - } - } - } catch (err) { - onError?.('Stream processing error:', err) - } - })() - - return onMessage(firstObject) -} - /** * Processes a framed response where each JSON chunk is a complete JSON string * (already decoded by frame decoder). + * + * Uses per-chunk post-processing context to ensure async deserialization work + * completes before the next chunk is processed. This prevents issues when + * streaming values require async post-processing (e.g., RSC decoding). */ async function processFramedResponse({ jsonStream, @@ -392,8 +372,11 @@ async function processFramedResponse({ // Each frame is a complete JSON string const firstObject = JSON.parse(firstValue) - // Process remaining frames asynchronously (for streaming refs like RawStream) - ;(async () => { + // Process remaining frames for streaming refs like RawStream. + // Keep draining until the server closes the stream. + // Each chunk gets its own post-processing context to properly scope async work. + let drainCancelled = false as boolean + const drain = (async () => { try { // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition while (true) { @@ -401,16 +384,62 @@ async function processFramedResponse({ if (done) break if (value) { try { - onMessage(JSON.parse(value)) + // Set up post-processing context for this chunk + const chunkPostProcessPromises: Array<Promise<unknown>> = [] + setPostProcessContext(chunkPostProcessPromises) + try { + onMessage(JSON.parse(value)) + } finally { + setPostProcessContext(null) + } + // Await any async post-processing from this chunk before processing next. + // This ensures values requiring async work are ready before their + // containing Promise/Stream resolves/emits to consumers. + await awaitPostProcessPromises(chunkPostProcessPromises) } catch (e) { onError?.(`Invalid JSON: ${value}`, e) } } } } catch (err) { - onError?.('Stream processing error:', err) + if (!drainCancelled) { + onError?.('Stream processing error:', err) + } } })() - return onMessage(firstObject) + // Process first object with its own post-processing context + let result: any + const initialPostProcessPromises: Array<Promise<unknown>> = [] + setPostProcessContext(initialPostProcessPromises) + try { + result = onMessage(firstObject) + } catch (err) { + setPostProcessContext(null) + drainCancelled = true + reader.cancel().catch(() => {}) + throw err + } + setPostProcessContext(null) + + // Await initial post-processing promises before returning result + await awaitPostProcessPromises(initialPostProcessPromises) + + // If the initial decode fails async, stop draining to avoid holding + // onto the response body and raw stream buffers unnecessarily. + Promise.resolve(result).catch(() => { + drainCancelled = true + reader.cancel().catch(() => {}) + }) + + // Detach reader once draining completes. + drain.finally(() => { + try { + reader.releaseLock() + } catch { + // Ignore + } + }) + + return result } diff --git a/packages/start-client-core/src/client/hydrateStart.ts b/packages/start-client-core/src/client/hydrateStart.ts index 15295a5b22..83b9c468af 100644 --- a/packages/start-client-core/src/client/hydrateStart.ts +++ b/packages/start-client-core/src/client/hydrateStart.ts @@ -1,14 +1,27 @@ import { hydrate } from '@tanstack/router-core/ssr/client' - -import { ServerFunctionSerializationAdapter } from './ServerFunctionSerializationAdapter' -import type { AnyStartInstanceOptions } from '../createStart' -import type { AnyRouter, AnySerializationAdapter } from '@tanstack/router-core' -// eslint-disable-next-line import/no-duplicates,import/order -import { getRouter } from '#tanstack-router-entry' -// eslint-disable-next-line import/no-duplicates,import/order import { startInstance } from '#tanstack-start-entry' +import { + hasPluginAdapters, + pluginSerializationAdapters, +} from '#tanstack-start-plugin-adapters' +import { getRouter } from '#tanstack-router-entry' +import { ServerFunctionSerializationAdapter } from './ServerFunctionSerializationAdapter' +import type { AnyRouter, AnySerializationAdapter } from '@tanstack/router-core' +import type { AnyStartInstanceOptions } from '../createStart' -export async function hydrateStart(): Promise<AnyRouter> { +type HotContext = { + data?: Record<string, unknown> + dispose?: (cb: (data: Record<string, unknown>) => void) => void +} + +declare global { + interface ImportMeta { + hot?: HotContext + webpackHot?: HotContext + } +} + +async function hydrateStart(): Promise<AnyRouter> { const router = await getRouter() let serializationAdapters: Array<AnySerializationAdapter> @@ -26,6 +39,10 @@ export async function hydrateStart(): Promise<AnyRouter> { } as AnyStartInstanceOptions } + // Only spread plugin adapters if any are configured (this will tree-shake away otherwise) + if (hasPluginAdapters) { + serializationAdapters.push(...pluginSerializationAdapters) + } serializationAdapters.push(ServerFunctionSerializationAdapter) if (router.options.serializationAdapters) { serializationAdapters.push(...router.options.serializationAdapters) @@ -35,9 +52,44 @@ export async function hydrateStart(): Promise<AnyRouter> { basepath: process.env.TSS_ROUTER_BASEPATH, ...{ serializationAdapters }, }) - if (!router.stores.matchesId.state.length) { + if (!router.stores.matchesId.get().length) { await hydrate(router) } return router } + +function hydrateStartWithHmr(): Promise<AnyRouter> { + const hot = import.meta.hot ?? import.meta.webpackHot + + if (!hot) { + return hydrateStart() + } + + const key = 'tss-hydrate-start-promise' + const hotData = (hot.data ??= {}) + let hydrationPromise = hotData[key] as Promise<AnyRouter> | undefined + + if (!hydrationPromise) { + hydrationPromise = hydrateStart().catch((error) => { + if (hotData[key] === hydrationPromise) { + hotData[key] = undefined + } + + throw error + }) + + hotData[key] = hydrationPromise + } + + hot.dispose?.((data) => { + data[key] = hotData[key] + }) + + return hydrationPromise +} + +const exportedHydrateStart = + process.env.NODE_ENV !== 'production' ? hydrateStartWithHmr : hydrateStart + +export { exportedHydrateStart as hydrateStart } diff --git a/packages/start-client-core/src/createCsrfMiddleware.ts b/packages/start-client-core/src/createCsrfMiddleware.ts new file mode 100644 index 0000000000..0715dd7e63 --- /dev/null +++ b/packages/start-client-core/src/createCsrfMiddleware.ts @@ -0,0 +1,197 @@ +import { createIsomorphicFn } from '@tanstack/start-fn-stubs' +import { createMiddleware } from './createMiddleware' +import type { + RequestMiddlewareAfterServer, + RequestServerOptions, +} from './createMiddleware' +import type { Register } from '@tanstack/router-core' + +export const csrfSymbol = Symbol.for('tanstack-start:csrf-middleware') + +export type CsrfSecFetchSite = + | 'same-origin' + | 'same-site' + | 'cross-site' + | 'none' + +export type CsrfMatcher<TValue, TRegister = Register, TMiddlewares = unknown> = + | TValue + | Array<TValue> + | (( + value: TValue | (string & {}), + ctx: RequestServerOptions<TRegister, TMiddlewares>, + ) => boolean | Promise<boolean>) + +export interface CsrfMiddlewareOptions< + TRegister = Register, + TMiddlewares = unknown, +> { + /** + * Return `true` to validate this request, or `false` to skip validation. + * + * @default undefined, which validates every request handled by this middleware. + */ + filter?: ( + ctx: RequestServerOptions<TRegister, TMiddlewares>, + ) => boolean | Promise<boolean> + /** + * Allowed Origin values. Defaults to the trusted request origin. + */ + origin?: CsrfMatcher<string, TRegister, TMiddlewares> + /** + * Allowed Sec-Fetch-Site values. + * + * @default 'same-origin' + */ + secFetchSite?: CsrfMatcher<CsrfSecFetchSite, TRegister, TMiddlewares> + /** + * Whether to use Referer as a fallback when Sec-Fetch-Site and Origin are absent. + * + * @default true + */ + referer?: + | boolean + | (( + referer: string, + ctx: RequestServerOptions<TRegister, TMiddlewares>, + ) => boolean | Promise<boolean>) + /** + * Allow requests when Sec-Fetch-Site, Origin, and Referer are all missing. + * + * @default false + */ + allowRequestsWithoutOriginCheck?: boolean + /** + * Optional response returned when CSRF validation fails. + * + * @default new Response('Forbidden', { status: 403 }) + */ + failureResponse?: + | Response + | (( + ctx: RequestServerOptions<TRegister, TMiddlewares>, + ) => Response | Promise<Response>) +} + +type CreateCsrfMiddleware = <TRegister, TMiddlewares>( + opts?: CsrfMiddlewareOptions<TRegister, TMiddlewares>, +) => RequestMiddlewareAfterServer<{}, undefined, undefined> + +const innerCreateCsrfMiddleware: CreateCsrfMiddleware = (opts = {}) => { + const middleware = createMiddleware().server(async (ctx) => { + const csrfCtx = ctx as RequestServerOptions<any, any> + + if (opts.filter && !(await opts.filter(csrfCtx))) { + return ctx.next() + } + + if (await isCsrfRequestAllowed(opts, csrfCtx)) { + return ctx.next() + } + + return getFailureResponse(opts, csrfCtx) + }) + + if (process.env.NODE_ENV !== 'production') { + Object.defineProperty(middleware, csrfSymbol, { value: true }) + } + + return middleware +} + +export const createCsrfMiddleware: CreateCsrfMiddleware = + createIsomorphicFn().server(innerCreateCsrfMiddleware) as CreateCsrfMiddleware + +export async function isCsrfRequestAllowed<TRegister, TMiddlewares>( + opts: CsrfMiddlewareOptions<TRegister, TMiddlewares>, + ctx: RequestServerOptions<TRegister, TMiddlewares>, +): Promise<boolean> { + const result = await getCsrfRequestValidationResult(opts, ctx) + return ( + result === true || + (result === undefined && opts.allowRequestsWithoutOriginCheck === true) + ) +} + +export async function getCsrfRequestValidationResult<TRegister, TMiddlewares>( + opts: CsrfMiddlewareOptions<TRegister, TMiddlewares>, + ctx: RequestServerOptions<TRegister, TMiddlewares>, +): Promise<boolean | undefined> { + const fetchSite = ctx.request.headers.get('Sec-Fetch-Site') + if (fetchSite !== null) { + return matchValue(opts.secFetchSite ?? 'same-origin', fetchSite, ctx) + } + + const origin = ctx.request.headers.get('Origin') + if (origin !== null) { + if (opts.origin) { + return matchValue(opts.origin, origin, ctx) + } + + return origin === new URL(ctx.request.url).origin + } + + const referer = ctx.request.headers.get('Referer') + if (referer === null || opts.referer === false) { + return undefined + } + + if (typeof opts.referer === 'function') { + return opts.referer(referer, ctx) + } + + if (opts.origin) { + const refererOrigin = getOriginFromUrl(referer) + return ( + refererOrigin !== undefined && matchValue(opts.origin, refererOrigin, ctx) + ) + } + + return isRefererSameOrigin(referer, new URL(ctx.request.url).origin) +} + +async function matchValue<TValue extends string, TRegister, TMiddlewares>( + matcher: CsrfMatcher<TValue, TRegister, TMiddlewares>, + value: string, + ctx: RequestServerOptions<TRegister, TMiddlewares>, +): Promise<boolean> { + if (typeof matcher === 'function') { + return matcher(value, ctx) + } + + if (Array.isArray(matcher)) { + // typescript is dumb for array.includes() + return matcher.includes(value as TValue) + } + + return value === matcher +} + +function getOriginFromUrl(url: string): string | undefined { + try { + return new URL(url).origin + } catch { + return undefined + } +} + +function isRefererSameOrigin(referer: string, requestOrigin: string): boolean { + if (referer === requestOrigin) return true + if (!referer.startsWith(requestOrigin)) return false + if (referer.length === requestOrigin.length) return true + const code = referer.charCodeAt(requestOrigin.length) + return code === 47 /* '/' */ || code === 63 /* '?' */ || code === 35 /* '#' */ +} + +async function getFailureResponse<TRegister, TMiddlewares>( + opts: CsrfMiddlewareOptions<TRegister, TMiddlewares>, + ctx: RequestServerOptions<TRegister, TMiddlewares>, +): Promise<Response> { + if (typeof opts.failureResponse === 'function') { + return opts.failureResponse(ctx) + } + + return ( + opts.failureResponse?.clone() ?? new Response('Forbidden', { status: 403 }) + ) +} diff --git a/packages/start-client-core/src/createMiddleware.ts b/packages/start-client-core/src/createMiddleware.ts index 9e0a435791..8f4ff474fc 100644 --- a/packages/start-client-core/src/createMiddleware.ts +++ b/packages/start-client-core/src/createMiddleware.ts @@ -770,6 +770,10 @@ export interface RequestServerOptions<TRegister, TMiddlewares> { pathname: string context: Expand<AssignAllServerRequestContext<TRegister, TMiddlewares>> next: RequestServerNextFn<TRegister, TMiddlewares> + /** + * Type of Start handler currently processing this request. + */ + handlerType: 'serverFn' | 'router' /** * Metadata about the server function being invoked. * This is only present when the request is handling a server function call. diff --git a/packages/start-client-core/src/createServerFn.ts b/packages/start-client-core/src/createServerFn.ts index 42eef35aec..37d4ead122 100644 --- a/packages/start-client-core/src/createServerFn.ts +++ b/packages/start-client-core/src/createServerFn.ts @@ -32,23 +32,47 @@ import type { type TODO = any +export type ServerFnStrict = boolean | { input?: boolean; output?: boolean } + +export interface ServerFnOptions< + TMethod extends Method = Method, + TStrict extends ServerFnStrict = true, +> { + method?: TMethod + strict?: TStrict +} + +export type ServerFnStrictInput<TStrict extends ServerFnStrict> = + TStrict extends false + ? false + : TStrict extends { input: infer TInput extends boolean } + ? TInput + : true + +export type ServerFnStrictOutput<TStrict extends ServerFnStrict> = + TStrict extends false + ? false + : TStrict extends { output: infer TOutput extends boolean } + ? TOutput + : true + export type CreateServerFn<TRegister> = < TMethod extends Method, + TStrict extends ServerFnStrict = true, TResponse = unknown, TMiddlewares = undefined, TInputValidator = undefined, >( - options?: { - method?: TMethod - }, + options?: ServerFnOptions<TMethod, TStrict>, __opts?: ServerFnBaseOptions< TRegister, TMethod, TResponse, TMiddlewares, - TInputValidator + TInputValidator, + TStrict >, -) => ServerFnBuilder<TRegister, TMethod> +) => ServerFnBuilder<TRegister, TMethod, TStrict> export const createServerFn: CreateServerFn<Register> = (options, __opts) => { const resolvedOptions = (__opts || options || {}) as ServerFnBaseOptions< @@ -56,6 +80,7 @@ export const createServerFn: CreateServerFn<Register> = (options, __opts) => { any, any, any, + any, any > @@ -63,7 +88,7 @@ export const createServerFn: CreateServerFn<Register> = (options, __opts) => { resolvedOptions.method = 'GET' as Method } - const res: ServerFnBuilder<Register, Method> = { + const res: ServerFnBuilder<Register, Method, ServerFnStrict> = { options: resolvedOptions, middleware: (middleware) => { // multiple calls to `middleware()` merge the middlewares with the previously supplied ones @@ -152,7 +177,6 @@ export const createServerFn: CreateServerFn<Register> = (options, __opts) => { const startContext = getStartContextServerOnly() const serverContextAfterGlobalMiddlewares = startContext.contextAfterGlobalMiddlewares - // Use safeObjectMerge for opts.context which comes from client const ctx = { ...extractedFn, ...opts, @@ -160,10 +184,10 @@ export const createServerFn: CreateServerFn<Register> = (options, __opts) => { // (which has id, name, filename) rather than the partial one from SSR/client // callers (which only has id) serverFnMeta: extractedFn.serverFnMeta, - // Use safeObjectMerge for opts.context which comes from client + // Merge client context first so trusted server middleware context wins. context: safeObjectMerge( - serverContextAfterGlobalMiddlewares, opts.context, + serverContextAfterGlobalMiddlewares, ), request: startContext.request, } @@ -184,8 +208,8 @@ export const createServerFn: CreateServerFn<Register> = (options, __opts) => { }, ) as any }, - } as ServerFnBuilder<Register, Method> - const fun = (options?: { method?: Method }) => { + } as ServerFnBuilder<Register, Method, ServerFnStrict> + const fun = (options?: ServerFnOptions<Method, ServerFnStrict>) => { const newOptions = { ...resolvedOptions, ...options, @@ -381,7 +405,13 @@ export interface RequiredFetcher< ): Promise<Awaited<TResponse>> } -export type CustomFetch = typeof globalThis.fetch +// Ideally, this type should just be `export type CustomFetch = typeof globalThis.fetch`, but that conflicts with the type overrides the `bun-types` package - a dependency of unplugin. +// Relevant bun issues: +// - https://github.com/oven-sh/bun/issues/23500 +// - https://github.com/oven-sh/bun/issues/23741 +export type CustomFetch = typeof fetch extends (...args: infer A) => infer R + ? (...args: A) => R + : never export type FetcherBaseOptions = { headers?: HeadersInit @@ -409,12 +439,18 @@ export type RscStream<T> = { export type Method = 'GET' | 'POST' -export type ServerFnReturnType<TRegister, TResponse> = - TResponse extends PromiseLike<infer U> - ? Promise<ServerFnReturnType<TRegister, U>> - : TResponse extends Response - ? TResponse - : ValidateSerializableInput<TRegister, TResponse> +export type ServerFnReturnType< + TRegister, + TResponse, + TStrict extends ServerFnStrict = true, +> = + ServerFnStrictOutput<TStrict> extends false + ? TResponse + : TResponse extends PromiseLike<infer U> + ? Promise<ServerFnReturnType<TRegister, U, TStrict>> + : TResponse extends Response + ? TResponse + : ValidateSerializableInput<TRegister, TResponse> export type ServerFn< TRegister, @@ -422,9 +458,10 @@ export type ServerFn< TMiddlewares, TInputValidator, TResponse, + TStrict extends ServerFnStrict = true, > = ( ctx: ServerFnCtx<TRegister, TMethod, TMiddlewares, TInputValidator>, -) => ServerFnReturnType<TRegister, TResponse> +) => ServerFnReturnType<TRegister, TResponse, TStrict> export interface ServerFnCtx< TRegister, @@ -452,20 +489,28 @@ export type ServerFnBaseOptions< TResponse = unknown, TMiddlewares = unknown, TInputValidator = unknown, + TStrict extends ServerFnStrict = true, > = { method: TMethod + strict?: TStrict middleware?: Constrain< TMiddlewares, ReadonlyArray<AnyFunctionMiddleware | AnyRequestMiddleware> > - inputValidator?: ConstrainValidator<TRegister, TMethod, TInputValidator> + inputValidator?: ConstrainValidator< + TRegister, + TMethod, + TInputValidator, + TStrict + > extractedFn?: CompiledFetcherFn<TRegister, TResponse> serverFn?: ServerFn< TRegister, TMethod, TMiddlewares, TInputValidator, - TResponse + TResponse, + TStrict > } @@ -473,27 +518,33 @@ export type ValidateValidatorInput< TRegister, TMethod extends Method, TInputValidator, -> = TMethod extends 'POST' - ? ResolveValidatorInput<TInputValidator> extends FormData + TStrict extends ServerFnStrict = true, +> = + ServerFnStrictInput<TStrict> extends false ? ResolveValidatorInput<TInputValidator> - : ValidateSerializable< - ResolveValidatorInput<TInputValidator>, - RegisteredSerializableInput<TRegister> - > - : ValidateSerializable< - ResolveValidatorInput<TInputValidator>, - RegisteredSerializableInput<TRegister> - > + : TMethod extends 'POST' + ? ResolveValidatorInput<TInputValidator> extends FormData + ? ResolveValidatorInput<TInputValidator> + : ValidateSerializable< + ResolveValidatorInput<TInputValidator>, + RegisteredSerializableInput<TRegister> + > + : ValidateSerializable< + ResolveValidatorInput<TInputValidator>, + RegisteredSerializableInput<TRegister> + > export type ValidateValidator< TRegister, TMethod extends Method, TInputValidator, + TStrict extends ServerFnStrict = true, > = ValidateValidatorInput< TRegister, TMethod, - TInputValidator + TInputValidator, + TStrict > extends infer TInput ? Validator<TInput, any> : never @@ -502,17 +553,19 @@ export type ConstrainValidator< TRegister, TMethod extends Method, TInputValidator, + TStrict extends ServerFnStrict = true, > = | (unknown extends TInputValidator ? TInputValidator : ResolveValidatorInput<TInputValidator> extends ValidateValidator< TRegister, TMethod, - TInputValidator + TInputValidator, + TStrict > ? TInputValidator : never) - | ValidateValidator<TRegister, TMethod, TInputValidator> + | ValidateValidator<TRegister, TMethod, TInputValidator, TStrict> export type AppendMiddlewares<TMiddlewares, TNewMiddlewares> = TMiddlewares extends ReadonlyArray<any> @@ -526,6 +579,7 @@ export interface ServerFnMiddleware< TMethod extends Method, TMiddlewares, TInputValidator, + TStrict extends ServerFnStrict, > { middleware: <const TNewMiddlewares>( middlewares: Constrain< @@ -536,7 +590,8 @@ export interface ServerFnMiddleware< TRegister, TMethod, AppendMiddlewares<TMiddlewares, TNewMiddlewares>, - TInputValidator + TInputValidator, + TStrict > } @@ -545,6 +600,7 @@ export interface ServerFnAfterMiddleware< TMethod extends Method, TMiddlewares, TInputValidator, + TStrict extends ServerFnStrict, > extends ServerFnWithTypes< @@ -552,33 +608,59 @@ export interface ServerFnAfterMiddleware< TMethod, TMiddlewares, TInputValidator, - undefined + undefined, + TStrict >, - ServerFnMiddleware<TRegister, TMethod, TMiddlewares, undefined>, - ServerFnValidator<TRegister, TMethod, TMiddlewares>, - ServerFnHandler<TRegister, TMethod, TMiddlewares, TInputValidator> { - <TNewMethod extends Method = TMethod>(options?: { - method?: TNewMethod - }): ServerFnAfterMiddleware< + ServerFnMiddleware<TRegister, TMethod, TMiddlewares, undefined, TStrict>, + ServerFnValidator<TRegister, TMethod, TMiddlewares, TStrict>, + ServerFnHandler< + TRegister, + TMethod, + TMiddlewares, + TInputValidator, + TStrict + > { + < + TNewMethod extends Method = TMethod, + TNewStrict extends ServerFnStrict = TStrict, + >( + options?: ServerFnOptions<TNewMethod, TNewStrict>, + ): ServerFnAfterMiddleware< TRegister, TNewMethod, TMiddlewares, - TInputValidator + TInputValidator, + TNewStrict > } -export type ValidatorFn<TRegister, TMethod extends Method, TMiddlewares> = < +export type ValidatorFn< + TRegister, + TMethod extends Method, + TMiddlewares, + TStrict extends ServerFnStrict, +> = <TInputValidator>( + inputValidator: ConstrainValidator< + TRegister, + TMethod, + TInputValidator, + TStrict + >, +) => ServerFnAfterValidator< + TRegister, + TMethod, + TMiddlewares, TInputValidator, ->( - inputValidator: ConstrainValidator<TRegister, TMethod, TInputValidator>, -) => ServerFnAfterValidator<TRegister, TMethod, TMiddlewares, TInputValidator> + TStrict +> export interface ServerFnValidator< TRegister, TMethod extends Method, TMiddlewares, + TStrict extends ServerFnStrict, > { - inputValidator: ValidatorFn<TRegister, TMethod, TMiddlewares> + inputValidator: ValidatorFn<TRegister, TMethod, TMiddlewares, TStrict> } export interface ServerFnAfterValidator< @@ -586,6 +668,7 @@ export interface ServerFnAfterValidator< TMethod extends Method, TMiddlewares, TInputValidator, + TStrict extends ServerFnStrict, > extends ServerFnWithTypes< @@ -593,16 +676,30 @@ export interface ServerFnAfterValidator< TMethod, TMiddlewares, TInputValidator, - undefined + undefined, + TStrict >, - ServerFnMiddleware<TRegister, TMethod, TMiddlewares, TInputValidator>, - ServerFnHandler<TRegister, TMethod, TMiddlewares, TInputValidator> {} + ServerFnMiddleware< + TRegister, + TMethod, + TMiddlewares, + TInputValidator, + TStrict + >, + ServerFnHandler< + TRegister, + TMethod, + TMiddlewares, + TInputValidator, + TStrict + > {} export interface ServerFnAfterTyper< TRegister, TMethod extends Method, TMiddlewares, TInputValidator, + TStrict extends ServerFnStrict, > extends ServerFnWithTypes< @@ -610,9 +707,16 @@ export interface ServerFnAfterTyper< TMethod, TMiddlewares, TInputValidator, - undefined + undefined, + TStrict >, - ServerFnHandler<TRegister, TMethod, TMiddlewares, TInputValidator> {} + ServerFnHandler< + TRegister, + TMethod, + TMiddlewares, + TInputValidator, + TStrict + > {} // Handler export interface ServerFnHandler< @@ -620,6 +724,7 @@ export interface ServerFnHandler< TMethod extends Method, TMiddlewares, TInputValidator, + TStrict extends ServerFnStrict, > { handler: <TNewResponse>( fn?: ServerFn< @@ -627,23 +732,42 @@ export interface ServerFnHandler< TMethod, TMiddlewares, TInputValidator, - TNewResponse + TNewResponse, + TStrict >, ) => Fetcher<TMiddlewares, TInputValidator, TNewResponse> } -export interface ServerFnBuilder<TRegister, TMethod extends Method = 'GET'> +export interface ServerFnBuilder< + TRegister, + TMethod extends Method = 'GET', + TStrict extends ServerFnStrict = true, +> extends - ServerFnWithTypes<TRegister, TMethod, undefined, undefined, undefined>, - ServerFnMiddleware<TRegister, TMethod, undefined, undefined>, - ServerFnValidator<TRegister, TMethod, undefined>, - ServerFnHandler<TRegister, TMethod, undefined, undefined> { + ServerFnWithTypes< + TRegister, + TMethod, + undefined, + undefined, + undefined, + TStrict + >, + ServerFnMiddleware<TRegister, TMethod, undefined, undefined, TStrict>, + ServerFnValidator<TRegister, TMethod, undefined, TStrict>, + ServerFnHandler<TRegister, TMethod, undefined, undefined, TStrict> { + < + TNewMethod extends Method = TMethod, + TNewStrict extends ServerFnStrict = TStrict, + >( + options?: ServerFnOptions<TNewMethod, TNewStrict>, + ): ServerFnBuilder<TRegister, TNewMethod, TNewStrict> options: ServerFnBaseOptions< TRegister, TMethod, unknown, undefined, - undefined + undefined, + TStrict > } @@ -653,25 +777,28 @@ export interface ServerFnWithTypes< in out TMiddlewares, in out TInputValidator, in out TResponse, + in out TStrict extends ServerFnStrict, > { '~types': ServerFnTypes< TRegister, TMethod, TMiddlewares, TInputValidator, - TResponse + TResponse, + TStrict > options: ServerFnBaseOptions< TRegister, TMethod, unknown, undefined, - undefined + undefined, + TStrict > [TSS_SERVER_FUNCTION_FACTORY]: true } -export type AnyServerFn = ServerFnWithTypes<any, any, any, any, any> +export type AnyServerFn = ServerFnWithTypes<any, any, any, any, any, any> export interface ServerFnTypes< in out TRegister, @@ -679,8 +806,10 @@ export interface ServerFnTypes< in out TMiddlewares, in out TInputValidator, in out TResponse, + in out TStrict extends ServerFnStrict, > { method: TMethod + strict: TStrict middlewares: TMiddlewares inputValidator: TInputValidator response: TResponse diff --git a/packages/start-client-core/src/empty-plugin-adapters.ts b/packages/start-client-core/src/empty-plugin-adapters.ts new file mode 100644 index 0000000000..579643cb86 --- /dev/null +++ b/packages/start-client-core/src/empty-plugin-adapters.ts @@ -0,0 +1,4 @@ +import type { AnySerializationAdapter } from '@tanstack/router-core' + +export const pluginSerializationAdapters: Array<AnySerializationAdapter> = [] +export const hasPluginAdapters = false diff --git a/packages/start-client-core/src/fake-entries/router.ts b/packages/start-client-core/src/fake-entries/router.ts new file mode 100644 index 0000000000..4fea94521d --- /dev/null +++ b/packages/start-client-core/src/fake-entries/router.ts @@ -0,0 +1 @@ +export function getRouter() {} diff --git a/packages/start-client-core/src/fake-start-entry.ts b/packages/start-client-core/src/fake-entries/start.ts similarity index 53% rename from packages/start-client-core/src/fake-start-entry.ts rename to packages/start-client-core/src/fake-entries/start.ts index cb81fb0df0..087859454d 100644 --- a/packages/start-client-core/src/fake-start-entry.ts +++ b/packages/start-client-core/src/fake-entries/start.ts @@ -1,2 +1 @@ export const startInstance = undefined -export const getRouter = () => {} diff --git a/packages/start-client-core/src/getDefaultSerovalPlugins.ts b/packages/start-client-core/src/getDefaultSerovalPlugins.ts index 61e48b9d89..8070137c20 100644 --- a/packages/start-client-core/src/getDefaultSerovalPlugins.ts +++ b/packages/start-client-core/src/getDefaultSerovalPlugins.ts @@ -4,8 +4,9 @@ import { } from '@tanstack/router-core' import { getStartOptions } from './getStartOptions' import type { AnySerializationAdapter } from '@tanstack/router-core' +import type { Plugin } from 'seroval' -export function getDefaultSerovalPlugins() { +export function getDefaultSerovalPlugins(): Array<Plugin<any, any>> { const start = getStartOptions() const adapters = start?.serializationAdapters as | Array<AnySerializationAdapter> diff --git a/packages/start-client-core/src/hydration.ts b/packages/start-client-core/src/hydration.ts new file mode 100644 index 0000000000..934b73116f --- /dev/null +++ b/packages/start-client-core/src/hydration.ts @@ -0,0 +1,50 @@ +import { hydrateIdAttribute } from './hydration/constants' + +export { condition } from './hydration/condition' +export type { HydrationCondition } from './hydration/condition' +export { + hydrateIdAttribute, + hydrateInteractionEventsAttribute, + hydrateWhenAttribute, +} from './hydration/constants' +export const hydrateIdSelector = `[${hydrateIdAttribute}]` +export { idle } from './hydration/idle' +export type { IdleHydrationOptions } from './hydration/idle' +export { interaction } from './hydration/interaction' +export { load } from './hydration/load' +export { media } from './hydration/media' +export { never } from './hydration/never' +export { + clearResolvedGateIdsInMarker, + createResolvedGate, + getFallbackHtml, + getMarkerGate, + getOrCreateGate, + onGateResolve, + releaseGate, + resolveHydrationMarker, + runHydrationStrategyCleanup, + saveFallbackHtml, + waitForHydrationPrefetchStrategy, +} from './hydration/runtime' +export { withHydrationRenderer } from './hydration/renderer' +export { visible } from './hydration/visible' +export { listenForDelegatedHydrationIntent } from './hydration/interaction' +export type { VisibleHydrationOptions } from './hydration/visible' +export type { HydrationGateRecord } from './hydration/runtime' +export type { HydrationStrategyWithRenderer } from './hydration/renderer' +export type { + HydrationInteractionEvent, + HydrationInteractionEvents, + HydrationMarkerAttributes, + HydrationPrefetchContext, + HydrationPrefetchFunction, + HydrationPrefetchWhen, + HydrationPrefetchStrategy, + HydrationPrefetchWaitReason, + HydrationRuntimeContext, + HydrationRuntimeGate, + HydrationStrategy, + HydrationStrategyTypes, + HydrationWhen, +} from './hydration/types' diff --git a/packages/start-client-core/src/hydration/condition.ts b/packages/start-client-core/src/hydration/condition.ts new file mode 100644 index 0000000000..6e640cc3ae --- /dev/null +++ b/packages/start-client-core/src/hydration/condition.ts @@ -0,0 +1,20 @@ +import type { HydrationStrategy } from './types' + +const conditionType = 'condition' + +export type HydrationCondition = boolean | (() => boolean) + +/* @__NO_SIDE_EFFECTS__ */ +export function condition( + condition: HydrationCondition, +): HydrationStrategy<typeof conditionType, false> { + return { + _t: conditionType, + _d: () => !(typeof condition === 'function' ? condition() : condition), + _s: ({ gate }) => { + if (typeof condition === 'function' ? condition() : condition) { + gate!.resolve() + } + }, + } +} diff --git a/packages/start-client-core/src/hydration/constants.ts b/packages/start-client-core/src/hydration/constants.ts new file mode 100644 index 0000000000..4b7a29313d --- /dev/null +++ b/packages/start-client-core/src/hydration/constants.ts @@ -0,0 +1,4 @@ +export const hydrateIdAttribute = 'data-ts-hydrate-id' +export const hydrateWhenAttribute = 'data-ts-hydrate-when' +export const hydrateInteractionEventsAttribute = + 'data-ts-hydrate-interaction-events' diff --git a/packages/start-client-core/src/hydration/idle.ts b/packages/start-client-core/src/hydration/idle.ts new file mode 100644 index 0000000000..bf0dc71131 --- /dev/null +++ b/packages/start-client-core/src/hydration/idle.ts @@ -0,0 +1,35 @@ +import type { HydrationPrefetchStrategy } from './types' + +const idleType = 'idle' + +export type IdleHydrationOptions = { + timeout?: number +} + +export function idle( + options: IdleHydrationOptions = {}, +): HydrationPrefetchStrategy<typeof idleType> { + const timeout = options.timeout ?? 2000 + + return { + _t: idleType, + _s: ({ gate, prefetch }) => { + const schedule = globalThis as unknown as { + requestIdleCallback?: ( + callback: IdleRequestCallback, + options?: IdleRequestOptions, + ) => number + cancelIdleCallback?: (handle: number) => void + } + const callback = prefetch ?? gate!.resolve + + if (schedule.requestIdleCallback) { + const handle = schedule.requestIdleCallback(callback, { timeout }) + return () => schedule.cancelIdleCallback?.(handle) + } + + const timeoutId = globalThis.setTimeout(callback, timeout) + return () => globalThis.clearTimeout(timeoutId) + }, + } +} diff --git a/packages/start-client-core/src/hydration/interaction.ts b/packages/start-client-core/src/hydration/interaction.ts new file mode 100644 index 0000000000..d5d6886d36 --- /dev/null +++ b/packages/start-client-core/src/hydration/interaction.ts @@ -0,0 +1,342 @@ +import { + hydrateIdAttribute, + hydrateInteractionEventsAttribute, + hydrateWhenAttribute, +} from './constants' +import { + clearResolvedGateIdsInMarker, + getMarkerGate, + resolveHydrationMarker, +} from './runtime' +import type { + HydrationInteractionEvents, + HydrationPrefetchStrategy, + HydrationRuntimeContext, +} from './types' + +export type InteractionHydrationOptions = { + events?: HydrationInteractionEvents +} + +const hydrateIdSelector = `[${hydrateIdAttribute}]` + +type PendingReplayEvent = { + marker: Element + targetPath: Array<number> + type: string + event: Event +} + +const defaultInteractionEvents = [ + 'pointerenter', + 'focusin', + 'pointerdown', + 'click', +] as const +const supportedInteractionEvents = [ + 'auxclick', + 'click', + 'contextmenu', + 'dblclick', + 'focusin', + 'keydown', + 'keyup', + 'mousedown', + 'mouseenter', + 'mouseover', + 'mouseup', + 'pointerdown', + 'pointerenter', + 'pointerover', + 'pointerup', +] as const +const interactionType = 'interaction' +const dynamicType = 'dynamic' +const interactionHydrateSelector = `[${hydrateWhenAttribute}="${interactionType}"]` +const delegatedHydrateSelector = `${interactionHydrateSelector},[${hydrateWhenAttribute}="${dynamicType}"]` +const replayEventsByGateId = /* @__PURE__ */ new Map< + string, + Array<PendingReplayEvent> +>() + +function getIntentListenerEvents( + marker: Element, + events: ReadonlyArray<string>, +) { + const listenerEvents = new Set(events) + + marker.querySelectorAll(delegatedHydrateSelector).forEach((childMarker) => { + if (childMarker.getAttribute(hydrateWhenAttribute) === dynamicType) { + supportedInteractionEvents.forEach((eventName) => { + listenerEvents.add(eventName) + }) + return + } + + const attr = childMarker.getAttribute(hydrateInteractionEventsAttribute) + for (const eventName of attr === null + ? defaultInteractionEvents + : attr.split(/\s+/).filter(Boolean)) { + listenerEvents.add(eventName) + } + }) + + return [...listenerEvents] +} + +function queueHydrationReplayEvent(marker: Element, event: Event) { + if (!event.bubbles) return + + const id = marker.getAttribute(hydrateIdAttribute) + const when = marker.getAttribute(hydrateWhenAttribute) + if (!id || !when || when === 'never') return + + const target = event.target + if (!target) return + + const gate = getMarkerGate(marker) + if (gate?.resolved) return + + event.preventDefault() + event.stopPropagation() + event.stopImmediatePropagation() + + let targetPath: Array<number> = [] + if (target instanceof Node && marker.contains(target)) { + let node: Element | null = + target instanceof Element ? target : target.parentElement + + while (node && node !== marker) { + const parent = node.parentElement + if (!parent) { + targetPath = [] + break + } + targetPath.push(Array.prototype.indexOf.call(parent.children, node)) + node = parent + } + targetPath.reverse() + } + + const pendingEvents = replayEventsByGateId.get(id) ?? [] + pendingEvents.push({ + marker, + targetPath, + type: event.type, + event, + }) + replayEventsByGateId.set(id, pendingEvents) +} + +if (typeof document !== 'undefined') { + const onIntent = (event: Event) => { + const target = event.target + if (!(target instanceof Element)) return + + let marker: Element | null = target.closest(hydrateIdSelector) + const markers: Array<Element> = [] + let shouldHandle = false + + while (marker) { + markers.push(marker) + + const when = marker.getAttribute(hydrateWhenAttribute) + if (when === dynamicType) { + shouldHandle ||= event.type === 'click' + } else if (when === interactionType) { + const attr = marker.getAttribute(hydrateInteractionEventsAttribute) + const events: ReadonlyArray<string> = + attr === null + ? defaultInteractionEvents + : attr.split(/\s+/).filter(Boolean) + shouldHandle ||= events.includes(event.type) + } + + marker = marker.parentElement?.closest(hydrateIdSelector) ?? null + } + + if (!shouldHandle) return + + markers.reverse() + if (markers.every((marker) => getMarkerGate(marker))) return + + markers.forEach((marker) => { + queueHydrationReplayEvent(marker, event) + resolveHydrationMarker(marker) + }) + } + + supportedInteractionEvents.forEach((eventName) => { + document.addEventListener(eventName, onIntent, true) + }) +} + +function listenForIntent( + element: Element, + events: ReadonlyArray<string>, + context: HydrationRuntimeContext, +) { + const onIntent = (event: Event) => { + const target = event.target + let marker: Element | null + if (target instanceof Element) { + const closestMarker = target.closest(hydrateIdSelector) + marker = + closestMarker && element.contains(closestMarker) + ? closestMarker + : element + } else { + marker = element + } + + const markers: Array<Element> = [] + while (marker) { + if (marker.hasAttribute(hydrateIdAttribute)) { + markers.push(marker) + } + if (marker === element) break + marker = marker.parentElement + } + + if (!markers.includes(element)) { + markers.push(element) + } + + markers.reverse() + + if ( + context.delegated && + !markers.some( + (marker) => + marker.getAttribute(hydrateWhenAttribute) === interactionType || + marker.getAttribute(hydrateWhenAttribute) === dynamicType, + ) + ) { + return + } + + markers.forEach((marker) => { + queueHydrationReplayEvent(marker, event) + resolveHydrationMarker(marker) + }) + } + let disposed = false + + events.forEach((eventName) => { + element.addEventListener(eventName, onIntent, true) + }) + + return () => { + if (disposed) return + disposed = true + events.forEach((eventName) => { + element.removeEventListener(eventName, onIntent, true) + }) + } +} + +export function listenForDelegatedHydrationIntent( + element: Element, + context: HydrationRuntimeContext, +) { + const listenerEvents = getIntentListenerEvents(element, []) + if (!listenerEvents.length) return + + const cleanupIntent = listenForIntent(element, listenerEvents, { + ...context, + delegated: true, + }) + return () => { + cleanupIntent() + clearResolvedGateIdsInMarker(element) + } +} + +/* @__NO_SIDE_EFFECTS__ */ +export function interaction( + options: InteractionHydrationOptions = {}, +): HydrationPrefetchStrategy<typeof interactionType> { + let events: ReadonlyArray<string> = defaultInteractionEvents + if (options.events !== undefined) { + const eventList: ReadonlyArray<string> = + typeof options.events === 'string' ? [options.events] : options.events + const normalizedEvents: Array<string> = [] + const seen = new Set<string>() + + for (const eventName of eventList) { + if (!eventName || seen.has(eventName)) continue + seen.add(eventName) + normalizedEvents.push(eventName) + } + + events = normalizedEvents + } + + const eventKey = events.join(' ') + + return { + _t: interactionType, + _s: (context) => { + const element = context.element + if (!element) return + const prefetch = context.prefetch + if (prefetch) { + if (!events.length) return + let disposed = false + + events.forEach((eventName) => { + element.addEventListener(eventName, prefetch, true) + }) + + return () => { + if (disposed) return + disposed = true + events.forEach((eventName) => { + element.removeEventListener(eventName, prefetch, true) + }) + } + } + + const listenerEvents = getIntentListenerEvents(element, events) + const cleanupIntent = listenerEvents.length + ? listenForIntent(element, listenerEvents, context) + : undefined + return () => { + cleanupIntent?.() + clearResolvedGateIdsInMarker(element) + } + }, + _o: (id) => { + globalThis.requestAnimationFrame(() => { + const pendingEvents = replayEventsByGateId.get(id) + if (!pendingEvents?.length) return + + replayEventsByGateId.delete(id) + + for (const pendingEvent of pendingEvents) { + let replayTarget: Element | null = pendingEvent.marker + for (const index of pendingEvent.targetPath) { + replayTarget = replayTarget.children[index] ?? null + if (!replayTarget) break + } + + const event = pendingEvent.event + replayTarget ??= pendingEvent.marker + replayTarget.dispatchEvent( + event instanceof MouseEvent + ? new MouseEvent(event.type, event) + : event instanceof FocusEvent + ? new FocusEvent(event.type, event) + : new Event(event.type, event), + ) + } + }) + }, + _a: () => + options.events === undefined + ? undefined + : { + [hydrateInteractionEventsAttribute]: eventKey, + }, + } +} diff --git a/packages/start-client-core/src/hydration/load.ts b/packages/start-client-core/src/hydration/load.ts new file mode 100644 index 0000000000..b78d6d6a42 --- /dev/null +++ b/packages/start-client-core/src/hydration/load.ts @@ -0,0 +1,16 @@ +import type { HydrationPrefetchStrategy } from './types' + +const loadType = 'load' + +const loadStrategy: HydrationPrefetchStrategy<typeof loadType> = { + _t: loadType, + _d: () => false, + _s: ({ gate, prefetch }) => { + ;(prefetch ?? gate!.resolve)() + }, +} + +/* @__NO_SIDE_EFFECTS__ */ +export function load(): HydrationPrefetchStrategy<typeof loadType> { + return loadStrategy +} diff --git a/packages/start-client-core/src/hydration/media.ts b/packages/start-client-core/src/hydration/media.ts new file mode 100644 index 0000000000..c2335b7e2f --- /dev/null +++ b/packages/start-client-core/src/hydration/media.ts @@ -0,0 +1,25 @@ +import type { HydrationPrefetchStrategy } from './types' + +const mediaType = 'media' + +/* @__NO_SIDE_EFFECTS__ */ +export function media( + query: string, +): HydrationPrefetchStrategy<typeof mediaType> { + return { + _t: mediaType, + _s: ({ gate, prefetch }) => { + if (!query) return + + const callback = prefetch ?? gate!.resolve + const mediaQuery = window.matchMedia(query) + const onChange = () => { + if (mediaQuery.matches) callback() + } + mediaQuery.addEventListener('change', onChange) + onChange() + + return () => mediaQuery.removeEventListener('change', onChange) + }, + } +} diff --git a/packages/start-client-core/src/hydration/never.ts b/packages/start-client-core/src/hydration/never.ts new file mode 100644 index 0000000000..8ace129b5e --- /dev/null +++ b/packages/start-client-core/src/hydration/never.ts @@ -0,0 +1,13 @@ +import type { HydrationStrategy } from './types' + +const neverType = 'never' + +const neverStrategy: HydrationStrategy<typeof neverType, false> = { + _t: neverType, + _d: () => true, +} + +/* @__NO_SIDE_EFFECTS__ */ +export function never(): HydrationStrategy<typeof neverType, false> { + return neverStrategy +} diff --git a/packages/start-client-core/src/hydration/renderer.ts b/packages/start-client-core/src/hydration/renderer.ts new file mode 100644 index 0000000000..1a14ef9b46 --- /dev/null +++ b/packages/start-client-core/src/hydration/renderer.ts @@ -0,0 +1,21 @@ +import type { HydrationStrategy } from './types' + +export type HydrationStrategyWithRenderer< + TStrategy extends HydrationStrategy, + TRenderer, +> = TStrategy & { + _h: TRenderer +} + +/* @__NO_SIDE_EFFECTS__ */ +export function withHydrationRenderer< + TStrategy extends HydrationStrategy, + TRenderer, +>( + strategy: TStrategy, + renderer: TRenderer, +): HydrationStrategyWithRenderer<TStrategy, TRenderer> { + return /* @__PURE__ */ Object.assign(strategy, { + _h: renderer, + }) +} diff --git a/packages/start-client-core/src/hydration/runtime.ts b/packages/start-client-core/src/hydration/runtime.ts new file mode 100644 index 0000000000..b1da55195d --- /dev/null +++ b/packages/start-client-core/src/hydration/runtime.ts @@ -0,0 +1,191 @@ +import { hydrateIdAttribute, hydrateWhenAttribute } from './constants' +import type { + HydrationPrefetchStrategy, + HydrationPrefetchWaitReason, + HydrationRuntimeGate, + HydrationWhen, +} from './types' + +const hydrateIdSelector = `[${hydrateIdAttribute}]` + +export type HydrationGateRecord = HydrationRuntimeGate & { + id: string + when: HydrationWhen + promise: Promise<void> + consumers: number + resolveListeners: Set<() => void> +} + +const gateRegistry = /* @__PURE__ */ new Map<string, HydrationGateRecord>() +const resolvedGateIds = /* @__PURE__ */ new Set<string>() +const fallbackHtmlByGateId = /* @__PURE__ */ new Map<string, string>() + +export function createResolvedGate( + id: string, + when: HydrationWhen, +): HydrationGateRecord { + return { + id, + when, + promise: Promise.resolve(), + resolve: () => {}, + resolved: true, + consumers: 0, + resolveListeners: new Set<() => void>(), + } +} + +export function getOrCreateGate( + id: string, + when: HydrationWhen, +): HydrationGateRecord { + const existing = gateRegistry.get(id) + if (existing?.when === when) { + existing.consumers++ + return existing + } + + let resolvePromise!: () => void + const promise = new Promise<void>((resolve) => { + resolvePromise = resolve + }) + + const gate: HydrationGateRecord = { + id, + promise, + resolved: false, + consumers: 1, + when, + resolveListeners: new Set(), + resolve: () => { + if (gate.resolved) return + gate.resolved = true + resolvePromise() + gate.resolveListeners.forEach((listener) => listener()) + gate.resolveListeners.clear() + }, + } + + gateRegistry.set(id, gate) + if (when !== 'never' && resolvedGateIds.has(id)) { + resolvedGateIds.delete(id) + gate.resolve() + } + return gate +} + +export function releaseGate(gate: HydrationGateRecord) { + resolvedGateIds.delete(gate.id) + gate.consumers-- + if (gate.consumers > 0) return + if (gateRegistry.get(gate.id) === gate) { + gateRegistry.delete(gate.id) + fallbackHtmlByGateId.delete(gate.id) + gate.resolveListeners.clear() + } +} + +export function onGateResolve(gate: HydrationGateRecord, listener: () => void) { + if (gate.resolved) { + listener() + return () => {} + } + + gate.resolveListeners.add(listener) + return () => { + gate.resolveListeners.delete(listener) + } +} + +export function runHydrationStrategyCleanup(cleanup: void | (() => void)) { + if (typeof cleanup === 'function') return cleanup + return undefined +} + +export function waitForHydrationPrefetchStrategy( + strategy: HydrationPrefetchStrategy, + options: { + element: Element | null + signal: AbortSignal + onHydrate: (listener: () => void) => () => void + }, +): Promise<HydrationPrefetchWaitReason> { + if (options.signal.aborted) { + return Promise.resolve('abort') + } + + return new Promise((resolve) => { + const state = { disposed: false } + const cleanupStrategyRef: { current: void | (() => void) } = { + current: undefined, + } + let cleanupHydrate = () => {} + + const finish = (reason: HydrationPrefetchWaitReason) => { + if (state.disposed) return + state.disposed = true + options.signal.removeEventListener('abort', onAbort) + cleanupHydrate() + runHydrationStrategyCleanup(cleanupStrategyRef.current)?.() + resolve(reason) + } + + const onAbort = () => finish('abort') + + options.signal.addEventListener('abort', onAbort, { once: true }) + cleanupHydrate = options.onHydrate(() => finish('hydrate')) + const cleanupStrategy = strategy._s?.({ + element: options.element, + prefetch: () => finish('prefetch'), + }) + cleanupStrategyRef.current = cleanupStrategy + if (state.disposed) { + runHydrationStrategyCleanup(cleanupStrategy)?.() + } + }) +} + +export function getMarkerGate(marker: Element) { + const id = marker.getAttribute(hydrateIdAttribute) + return id ? gateRegistry.get(id) : undefined +} + +export function resolveHydrationMarker(marker: Element) { + const id = marker.getAttribute(hydrateIdAttribute) + const when = marker.getAttribute(hydrateWhenAttribute) + if (!id || !when || when === 'never') { + return + } + + const gate = gateRegistry.get(id) + if (gate) { + if (gate.when !== 'never') gate.resolve() + return + } + + resolvedGateIds.add(id) +} + +export function clearResolvedGateIdsInMarker(marker: Element) { + const ownId = marker.getAttribute(hydrateIdAttribute) + if (ownId) { + resolvedGateIds.delete(ownId) + } + + marker.querySelectorAll(hydrateIdSelector).forEach((childMarker) => { + const childId = childMarker.getAttribute(hydrateIdAttribute) + if (childId) { + resolvedGateIds.delete(childId) + } + }) +} + +export function saveFallbackHtml(id: string, element: Element) { + if (!fallbackHtmlByGateId.has(id)) { + fallbackHtmlByGateId.set(id, element.innerHTML) + } +} + +export function getFallbackHtml(id: string) { + return fallbackHtmlByGateId.get(id) +} diff --git a/packages/start-client-core/src/hydration/types.ts b/packages/start-client-core/src/hydration/types.ts new file mode 100644 index 0000000000..f4250067d6 --- /dev/null +++ b/packages/start-client-core/src/hydration/types.ts @@ -0,0 +1,90 @@ +export type HydrationWhen = + | 'load' + | 'idle' + | 'visible' + | 'media' + | 'interaction' + | 'condition' + | 'never' + | 'dynamic' + +export type HydrationInteractionEvent = + | 'auxclick' + | 'click' + | 'contextmenu' + | 'dblclick' + | 'focusin' + | 'keydown' + | 'keyup' + | 'mousedown' + | 'mouseenter' + | 'mouseover' + | 'mouseup' + | 'pointerdown' + | 'pointerenter' + | 'pointerover' + | 'pointerup' + +export type HydrationInteractionEvents = + | HydrationInteractionEvent + | ReadonlyArray<HydrationInteractionEvent> + +export type HydrationMarkerAttributes = Record<string, string | undefined> + +export type HydrationRuntimeGate = { + id?: string + when?: HydrationWhen + resolved: boolean + resolve: () => void +} + +export type HydrationRuntimeContext = { + element: Element | null + gate?: HydrationRuntimeGate + prefetch?: () => void + delegated?: boolean +} + +export type HydrationStrategyTypes< + TWhen extends HydrationWhen = HydrationWhen, + TCanPrefetch extends boolean = boolean, +> = { + when: TWhen + canPrefetch: TCanPrefetch +} + +export type HydrationStrategy< + TWhen extends HydrationWhen = HydrationWhen, + TCanPrefetch extends boolean = boolean, +> = { + _t?: TWhen + readonly '~types'?: HydrationStrategyTypes<TWhen, TCanPrefetch> + _d?: () => boolean + _s?: (context: HydrationRuntimeContext) => void | (() => void) + _o?: (id: string) => void + _a?: () => HydrationMarkerAttributes | undefined +} + +export type HydrationPrefetchWhen = Exclude< + HydrationWhen, + 'condition' | 'never' | 'dynamic' +> + +export type HydrationPrefetchStrategy< + TWhen extends HydrationPrefetchWhen = HydrationPrefetchWhen, +> = HydrationStrategy<TWhen, true> + +export type HydrationPrefetchWaitReason = 'prefetch' | 'hydrate' | 'abort' + +export type HydrationPrefetchContext = { + element: Element | null + signal: AbortSignal + preload: () => Promise<void> + waitFor: ( + strategy: HydrationPrefetchStrategy, + ) => Promise<HydrationPrefetchWaitReason> +} + +export type HydrationPrefetchFunction = ( + context: HydrationPrefetchContext, +) => void | Promise<void> diff --git a/packages/start-client-core/src/hydration/visible.ts b/packages/start-client-core/src/hydration/visible.ts new file mode 100644 index 0000000000..3c3391b1de --- /dev/null +++ b/packages/start-client-core/src/hydration/visible.ts @@ -0,0 +1,90 @@ +import type { HydrationPrefetchStrategy } from './types' + +const visibleType = 'visible' + +export type VisibleHydrationOptions = { + rootMargin?: string + threshold?: number | Array<number> +} + +type VisibleObserverEntry = { + key: string + observer: IntersectionObserver + elements: Map<Element, Set<() => void>> +} + +const observerRegistry = /* @__PURE__ */ new Map<string, VisibleObserverEntry>() + +function cleanupVisibleObserverEntry(observerEntry: VisibleObserverEntry) { + if (observerEntry.elements.size > 0) return + observerEntry.observer.disconnect() + observerRegistry.delete(observerEntry.key) +} + +/* @__NO_SIDE_EFFECTS__ */ +export function visible( + options: VisibleHydrationOptions = {}, +): HydrationPrefetchStrategy<typeof visibleType> { + const rootMargin = options.rootMargin ?? '600px' + const threshold = options.threshold ?? 0 + + return { + _t: visibleType, + _s: ({ element, gate, prefetch }) => { + const callback = prefetch ?? gate!.resolve + + if (!element) { + callback() + return + } + + const key = `${rootMargin}|${ + Array.isArray(threshold) ? threshold.join(',') : String(threshold) + }` + let observerEntry = observerRegistry.get(key) + + if (!observerEntry) { + const entry: VisibleObserverEntry = { + key, + elements: new Map<Element, Set<() => void>>(), + observer: new IntersectionObserver( + (entries) => { + for (const intersectingEntry of entries) { + if (!intersectingEntry.isIntersecting) continue + + const callbacks = entry.elements.get(intersectingEntry.target) + if (!callbacks) continue + + callbacks.forEach((callback) => callback()) + entry.elements.delete(intersectingEntry.target) + entry.observer.unobserve(intersectingEntry.target) + cleanupVisibleObserverEntry(entry) + } + }, + { rootMargin, threshold }, + ), + } + observerRegistry.set(key, entry) + observerEntry = entry + } + + let callbacks = observerEntry.elements.get(element) + if (!callbacks) { + callbacks = new Set() + observerEntry.elements.set(element, callbacks) + observerEntry.observer.observe(element) + } + callbacks.add(callback) + + return () => { + const currentCallbacks = observerEntry.elements.get(element) + currentCallbacks?.delete(callback) + if (currentCallbacks?.size === 0) { + observerEntry.elements.delete(element) + observerEntry.observer.unobserve(element) + } + cleanupVisibleObserverEntry(observerEntry) + } + }, + } +} diff --git a/packages/start-client-core/src/index.tsx b/packages/start-client-core/src/index.tsx index 218c984d60..5bf09c4440 100644 --- a/packages/start-client-core/src/index.tsx +++ b/packages/start-client-core/src/index.tsx @@ -65,6 +65,10 @@ export type { FetcherBaseOptions, ServerFn, ServerFnCtx, + ServerFnOptions, + ServerFnStrict, + ServerFnStrictInput, + ServerFnStrictOutput, MiddlewareFn, ServerFnMiddlewareOptions, ServerFnMiddlewareResult, @@ -80,6 +84,17 @@ export { flattenMiddlewares, executeMiddleware, } from './createServerFn' +export { + createCsrfMiddleware, + csrfSymbol, + getCsrfRequestValidationResult, + isCsrfRequestAllowed, +} from './createCsrfMiddleware' +export type { + CsrfMatcher, + CsrfMiddlewareOptions, + CsrfSecFetchSite, +} from './createCsrfMiddleware' export { TSS_FORMDATA_CONTEXT, @@ -117,3 +132,4 @@ export { getRouterInstance } from './getRouterInstance' export { getDefaultSerovalPlugins } from './getDefaultSerovalPlugins' export { getGlobalStartContext } from './getGlobalStartContext' export { safeObjectMerge, createNullProtoObject } from './safeObjectMerge' +export { trackPostProcessPromise } from './client-rpc/serverFnFetcher' diff --git a/packages/start-client-core/src/start-entry.d.ts b/packages/start-client-core/src/start-entry.d.ts index ceb8c96aa7..9fb8e08638 100644 --- a/packages/start-client-core/src/start-entry.d.ts +++ b/packages/start-client-core/src/start-entry.d.ts @@ -1,11 +1,18 @@ declare module '#tanstack-start-entry' { - import type { StartEntry } from '@tanstack/start-client-core' + import type { StartEntry } from './startEntry' export const startInstance: StartEntry['startInstance'] } declare module '#tanstack-router-entry' { - import type { RouterEntry } from '@tanstack/start-client-core' + import type { RouterEntry } from './startEntry' export const getRouter: RouterEntry['getRouter'] } + +declare module '#tanstack-start-plugin-adapters' { + import type { AnySerializationAdapter } from '@tanstack/router-core' + + export const pluginSerializationAdapters: Array<AnySerializationAdapter> + export const hasPluginAdapters: boolean +} diff --git a/packages/start-client-core/src/tests/createServerFn.test-d.ts b/packages/start-client-core/src/tests/createServerFn.test-d.ts index f96e8e9de2..eabaca198b 100644 --- a/packages/start-client-core/src/tests/createServerFn.test-d.ts +++ b/packages/start-client-core/src/tests/createServerFn.test-d.ts @@ -6,6 +6,7 @@ import type { ServerFnMeta } from '../constants' import type { Constrain, Register, + SerializationError, TsrSerializable, ValidateSerializableInput, Validator, @@ -512,7 +513,134 @@ test('createServerFn returns undefined', () => { test('createServerFn cannot return function', () => { expectTypeOf(createServerFn().handler<{ func: () => 'func' }>) .parameter(0) - .returns.toEqualTypeOf<{ func: 'Function is not serializable' }>() + .returns.toEqualTypeOf<{ + func: SerializationError<'Function may not be serializable'> + }>() +}) + +test('createServerFn strict false can validate and return function', () => { + const fn = createServerFn({ method: 'GET', strict: false }) + .inputValidator((input: { func: () => 'input' }) => ({ + output: input.func(), + })) + .handler(({ data }) => { + expectTypeOf(data).toEqualTypeOf<{ output: 'input' }>() + + return { + func: () => 'func' as const, + } + }) + + expectTypeOf(fn).parameter(0).toEqualTypeOf<{ + data: { func: () => 'input' } + headers?: HeadersInit + signal?: AbortSignal + fetch?: CustomFetch + }>() + + expectTypeOf(fn({ data: { func: () => 'input' } })).toEqualTypeOf< + Promise<{ + func: () => 'func' + }> + >() +}) + +test('createServerFn strict false factory preserves strictness', () => { + const createServerFnWithoutSerializationCheck = createServerFn({ + strict: false, + }) + + const myServerFn = createServerFnWithoutSerializationCheck() + .inputValidator((input: { func: () => 'input' }) => ({ + output: input.func(), + })) + .handler(({ data }) => { + expectTypeOf(data).toEqualTypeOf<{ output: 'input' }>() + + return { + func: () => 'func' as const, + } + }) + + expectTypeOf(myServerFn).parameter(0).toEqualTypeOf<{ + data: { func: () => 'input' } + headers?: HeadersInit + signal?: AbortSignal + fetch?: CustomFetch + }>() + + expectTypeOf(myServerFn({ data: { func: () => 'input' } })).toEqualTypeOf< + Promise<{ + func: () => 'func' + }> + >() +}) + +test('createServerFn strict input false can validate function', () => { + const fn = createServerFn({ strict: { input: false } }) + .inputValidator((input: { func: () => 'input' }) => ({ + output: input.func(), + })) + .handler(({ data }) => { + expectTypeOf(data).toEqualTypeOf<{ output: 'input' }>() + + return { + value: 'serializable' as const, + } + }) + + expectTypeOf(fn).parameter(0).toEqualTypeOf<{ + data: { func: () => 'input' } + headers?: HeadersInit + signal?: AbortSignal + fetch?: CustomFetch + }>() + + expectTypeOf(fn({ data: { func: () => 'input' } })).toEqualTypeOf< + Promise<{ + value: 'serializable' + }> + >() +}) + +test('createServerFn strict output false can return function', () => { + const fn = createServerFn({ strict: { output: false } }).handler(() => ({ + func: () => 'func' as const, + })) + + expectTypeOf(fn()).toEqualTypeOf< + Promise<{ + func: () => 'func' + }> + >() + + const promiseFn = createServerFn({ strict: { output: false } }).handler(() => + Promise.resolve({ + func: () => 'func' as const, + }), + ) + + expectTypeOf(promiseFn()).toEqualTypeOf< + Promise<{ + func: () => 'func' + }> + >() +}) + +test('ServerFnReturnType skips serialization when strict is false', () => { + expectTypeOf< + ServerFnReturnType<Register, { func: () => 'func' }, false> + >().toEqualTypeOf<{ + func: () => 'func' + }>() +}) + +test('ServerFnReturnType skips serialization when strict output is false', () => { + expectTypeOf< + ServerFnReturnType<Register, { func: () => 'func' }, { output: false }> + >().toEqualTypeOf<{ + func: () => 'func' + }>() }) test('createServerFn cannot validate function', () => { @@ -525,7 +653,29 @@ test('createServerFn cannot validate function', () => { .toEqualTypeOf< Constrain< (input: { func: () => 'string' }) => { output: 'string' }, - Validator<{ func: 'Function is not serializable' }, any> + Validator< + { func: SerializationError<'Function may not be serializable'> }, + any + > + > + >() +}) + +test('createServerFn strict output false still checks input', () => { + const validator = createServerFn({ + method: 'GET', + strict: { output: false }, + }).inputValidator<(input: { func: () => 'string' }) => { output: 'string' }> + + expectTypeOf(validator) + .parameter(0) + .toEqualTypeOf< + Constrain< + (input: { func: () => 'string' }) => { output: 'string' }, + Validator< + { func: SerializationError<'Function may not be serializable'> }, + any + > > >() }) diff --git a/packages/start-client-core/src/tests/createServerMiddleware.test-d.ts b/packages/start-client-core/src/tests/createServerMiddleware.test-d.ts index b5f84b7022..27c9753073 100644 --- a/packages/start-client-core/src/tests/createServerMiddleware.test-d.ts +++ b/packages/start-client-core/src/tests/createServerMiddleware.test-d.ts @@ -2,7 +2,7 @@ import { expectTypeOf, test } from 'vitest' import { createMiddleware } from '../createMiddleware' import type { RequestServerNextFn } from '../createMiddleware' import type { ConstrainValidator, CustomFetch } from '../createServerFn' -import type { Register } from '@tanstack/router-core' +import type { Register, SerializationError } from '@tanstack/router-core' import type { ServerFnMeta } from '../constants' test('createServeMiddleware removes middleware after middleware,', () => { @@ -573,7 +573,10 @@ test('createMiddleware sendContext cannot send a function', () => { .parameter(0) .exclude<undefined>() .toHaveProperty('sendContext') - .toEqualTypeOf<{ func: 'Function is not serializable' } | undefined>() + .toEqualTypeOf< + | { func: SerializationError<'Function may not be serializable'> } + | undefined + >() return next() }) @@ -582,7 +585,10 @@ test('createMiddleware sendContext cannot send a function', () => { .parameter(0) .exclude<undefined>() .toHaveProperty('sendContext') - .toEqualTypeOf<{ func: 'Function is not serializable' } | undefined>() + .toEqualTypeOf< + | { func: SerializationError<'Function may not be serializable'> } + | undefined + >() return next() }) @@ -669,6 +675,7 @@ test('createMiddleware with type request, no middleware or context', () => { next: RequestServerNextFn<{}, undefined> pathname: string context: undefined + handlerType: 'serverFn' | 'router' serverFnMeta?: ServerFnMeta }>() @@ -692,6 +699,7 @@ test('createMiddleware with type request, no middleware with context', () => { next: RequestServerNextFn<{}, undefined> pathname: string context: undefined + handlerType: 'serverFn' | 'router' serverFnMeta?: ServerFnMeta }>() @@ -716,6 +724,7 @@ test('createMiddleware with type request, middleware and context', () => { next: RequestServerNextFn<{}, undefined> pathname: string context: undefined + handlerType: 'serverFn' | 'router' serverFnMeta?: ServerFnMeta }>() @@ -740,6 +749,7 @@ test('createMiddleware with type request, middleware and context', () => { next: RequestServerNextFn<{}, undefined> pathname: string context: { a: string } + handlerType: 'serverFn' | 'router' serverFnMeta?: ServerFnMeta }>() @@ -763,6 +773,7 @@ test('createMiddleware with type request can return Response directly', () => { next: RequestServerNextFn<{}, undefined> pathname: string context: undefined + handlerType: 'serverFn' | 'router' serverFnMeta?: ServerFnMeta }>() @@ -783,6 +794,7 @@ test('createMiddleware with type request can return Promise<Response>', () => { next: RequestServerNextFn<{}, undefined> pathname: string context: undefined + handlerType: 'serverFn' | 'router' serverFnMeta?: ServerFnMeta }>() @@ -798,6 +810,7 @@ test('createMiddleware with type request can return sync Response', () => { next: RequestServerNextFn<{}, undefined> pathname: string context: undefined + handlerType: 'serverFn' | 'router' serverFnMeta?: ServerFnMeta }>() diff --git a/packages/start-client-core/vite.config.ts b/packages/start-client-core/vite.config.ts index 470d686a45..71e163a1ed 100644 --- a/packages/start-client-core/vite.config.ts +++ b/packages/start-client-core/vite.config.ts @@ -2,27 +2,42 @@ import { defineConfig, mergeConfig } from 'vitest/config' import { tanstackViteConfig } from '@tanstack/vite-config' import packageJson from './package.json' -const config = defineConfig({ - test: { - typecheck: { enabled: true }, - name: packageJson.name, - watch: false, - environment: 'jsdom', - }, -}) - -export default mergeConfig( - config, - tanstackViteConfig({ - tsconfigPath: './tsconfig.build.json', - srcDir: './src', - entry: [ - './src/index.tsx', - './src/fake-start-entry.ts', - './src/client/index.ts', - './src/client-rpc/index.ts', - ], - cjs: false, - externalDeps: ['#tanstack-start-entry', '#tanstack-router-entry'], - }), +export default defineConfig(({ command }) => + mergeConfig( + { + define: + command === 'build' + ? { + 'import.meta.hot': 'import.meta.hot', + } + : undefined, + test: { + typecheck: { enabled: true }, + name: packageJson.name, + watch: false, + environment: 'jsdom', + }, + }, + tanstackViteConfig({ + tsconfigPath: './tsconfig.build.json', + srcDir: './src', + entry: [ + './src/index.tsx', + './src/client/index.ts', + './src/client-rpc/index.ts', + './src/hydration/constants.ts', + './src/hydration.ts', + './src/hydration/runtime.ts', + './src/fake-entries/start.ts', + './src/fake-entries/router.ts', + './src/empty-plugin-adapters.ts', + ], + cjs: false, + externalDeps: [ + '#tanstack-start-entry', + '#tanstack-router-entry', + '#tanstack-start-plugin-adapters', + ], + }), + ), ) diff --git a/packages/start-fn-stubs/CHANGELOG.md b/packages/start-fn-stubs/CHANGELOG.md index 2662080e29..e364ae973e 100644 --- a/packages/start-fn-stubs/CHANGELOG.md +++ b/packages/start-fn-stubs/CHANGELOG.md @@ -1,5 +1,15 @@ # @tanstack/start-fn-stubs +## 1.162.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- add createCsrfMiddleware based on Sec-Fetch-Site header, auto-apply to unconfigured servers, warn for others ([#7373](https://github.com/TanStack/router/pull/7373)) + ## 1.161.6 ### Patch Changes diff --git a/packages/start-fn-stubs/package.json b/packages/start-fn-stubs/package.json index 55ba9dbdae..5a5c84a3d9 100644 --- a/packages/start-fn-stubs/package.json +++ b/packages/start-fn-stubs/package.json @@ -1,6 +1,6 @@ { "name": "@tanstack/start-fn-stubs", - "version": "1.161.6", + "version": "1.162.0", "description": "Stub functions for TanStack Start isomorphic and environment-specific functions", "author": "Tanner Linsley", "license": "MIT", diff --git a/packages/start-fn-stubs/src/createIsomorphicFn.ts b/packages/start-fn-stubs/src/createIsomorphicFn.ts index 55258bf5a3..695da54453 100644 --- a/packages/start-fn-stubs/src/createIsomorphicFn.ts +++ b/packages/start-fn-stubs/src/createIsomorphicFn.ts @@ -34,13 +34,34 @@ export interface IsomorphicFnBase { ) => ClientOnlyFn<TArgs, TClient> } -// this is a dummy function, it will be replaced by the transformer -// if we use `createIsomorphicFn` in this library itself, vite tries to execute it before the transformer runs -// therefore we must return a dummy function that allows calling `server` and `client` method chains. +// The Start compiler normally rewrites createIsomorphicFn() chains before they +// run. Some package tests/build steps execute this stub uncompiled though, for +// example while Vite loads server-side modules during a build. +// +// In those uncompiled contexts we need a real callable fallback, not just a +// chain-shaped object. These contexts are server-side, so once a .server() +// implementation is registered we keep using it even if .client() is chained +// later. Client bundles still get the correct client/no-op implementation +// because the compiler rewrites the original call chain before runtime. export function createIsomorphicFn(): IsomorphicFnBase { - const fn = () => undefined + return createRuntimeFn(() => undefined) as any +} + +type RuntimeFallbackFn = (() => any) & { + server: (serverImpl: () => any) => RuntimeFallbackFn + client: (clientImpl: () => any) => RuntimeFallbackFn +} + +function createRuntimeFn( + fn: () => any, + serverImpl?: () => any, +): RuntimeFallbackFn { return Object.assign(fn, { - server: () => ({ client: () => () => {} }), - client: () => ({ server: () => () => {} }), - }) as any + server: (nextServerImpl: () => any) => { + return createRuntimeFn(nextServerImpl, nextServerImpl) + }, + client: (clientImpl: () => any) => { + return createRuntimeFn(serverImpl ?? clientImpl, serverImpl) + }, + }) } diff --git a/packages/start-fn-stubs/tests/createIsomorphicFn.test.ts b/packages/start-fn-stubs/tests/createIsomorphicFn.test.ts new file mode 100644 index 0000000000..23e97908e6 --- /dev/null +++ b/packages/start-fn-stubs/tests/createIsomorphicFn.test.ts @@ -0,0 +1,24 @@ +import { describe, expect, it } from 'vitest' +import { createIsomorphicFn } from '../src/createIsomorphicFn' + +describe('createIsomorphicFn runtime fallback', () => { + it('returns a callable server implementation', () => { + const fn = createIsomorphicFn().server(() => 'server') + + expect(fn()).toBe('server') + }) + + it('prefers the server implementation when both implementations are registered', () => { + const fn = createIsomorphicFn() + .server(() => 'server') + .client(() => 'client') + + expect(fn()).toBe('server') + }) + + it('returns a callable client-only implementation', () => { + const fn = createIsomorphicFn().client(() => 'client') + + expect(fn()).toBe('client') + }) +}) diff --git a/packages/start-plugin-core/CHANGELOG.md b/packages/start-plugin-core/CHANGELOG.md index ba7fcbe0d5..e0e2c9ae3a 100644 --- a/packages/start-plugin-core/CHANGELOG.md +++ b/packages/start-plugin-core/CHANGELOG.md @@ -1,5 +1,560 @@ # @tanstack/start-plugin-core +## 1.171.10 + +### Patch Changes + +- [#7509](https://github.com/TanStack/router/pull/7509) [`9cb7a00`](https://github.com/TanStack/router/commit/9cb7a003e6e5fa3706711870c7b10a5266356e3b) - feat(rsbuild): add RSC support + +- Updated dependencies [[`9cb7a00`](https://github.com/TanStack/router/commit/9cb7a003e6e5fa3706711870c7b10a5266356e3b)]: + - @tanstack/start-server-core@1.169.8 + +## 1.171.9 + +### Patch Changes + +- Updated dependencies [[`2f53749`](https://github.com/TanStack/router/commit/2f5374945e2138559a51464f45a5152eae67e1dd)]: + - @tanstack/router-core@1.171.8 + - @tanstack/router-generator@1.167.12 + - @tanstack/router-plugin@1.168.13 + - @tanstack/start-client-core@1.170.6 + - @tanstack/start-server-core@1.169.7 + +## 1.171.8 + +### Patch Changes + +- Updated dependencies [[`d1997b6`](https://github.com/TanStack/router/commit/d1997b66d7c24c1d64772bb8bab5caf9c6d9cc48)]: + - @tanstack/start-server-core@1.169.6 + - @tanstack/router-core@1.171.7 + - @tanstack/router-generator@1.167.11 + - @tanstack/router-plugin@1.168.12 + - @tanstack/start-client-core@1.170.5 + +## 1.171.7 + +### Patch Changes + +- [#7501](https://github.com/TanStack/router/pull/7501) [`9c09bca`](https://github.com/TanStack/router/commit/9c09bca59e9613e9a6fd9b7149b0737898e705d6) - fix(start): emit client entry scripts from the root route manifest. When `scriptFormat: 'iife'` and the entry chunk has static-import siblings (e.g. an extracted runtime via `optimization.runtimeChunk: 'single'`), the manifest now includes those async siblings before the async client entry in root route scripts, fixing hydration for IIFE bundles with extracted runtimes. + +- Updated dependencies [[`9c09bca`](https://github.com/TanStack/router/commit/9c09bca59e9613e9a6fd9b7149b0737898e705d6)]: + - @tanstack/start-server-core@1.169.5 + +## 1.171.6 + +### Patch Changes + +- Fix serialization adapter module resolution in TanStack Start. Vite dev now uses clean runtime-specific virtual module IDs instead of browser requests containing encoded null-byte virtual IDs, which avoids reverse proxy failures. When no serialization adapters are configured, Vite and Rsbuild now resolve `#tanstack-start-plugin-adapters` through the package empty-adapter fallback. ([#7484](https://github.com/TanStack/router/pull/7484)) + +- Publish matching TanStack Start dev server packages so fresh installs do not pair a Start plugin that no longer provides `tanstack-start-injected-head-scripts:v` with an older Start server runtime that still imports it. ([#7487](https://github.com/TanStack/router/pull/7487)) + +- Updated dependencies [[`a82cec6`](https://github.com/TanStack/router/commit/a82cec69474c366b36efdb3f43c4efe8311c485a), [`d8be4f8`](https://github.com/TanStack/router/commit/d8be4f8adf912128c96b7f83e9a6c49fb24b5eed)]: + - @tanstack/start-client-core@1.170.4 + - @tanstack/start-server-core@1.169.4 + +## 1.171.5 + +### Patch Changes + +- Add Vite bundled dev mode support for TanStack Start. Start now recognizes Vite's `experimental.bundledDev` opt-in, uses the bundled dev client entry in the dev manifest, keeps server requests pointed at the latest client build output, and preserves import-protection behavior for bundled client dev. ([#7482](https://github.com/TanStack/router/pull/7482)) + +## 1.171.4 + +### Patch Changes + +- Add support for Rsbuild client output formats, including module output by default and IIFE output for classic script environments. ([#7477](https://github.com/TanStack/router/pull/7477)) + + Client entry scripts and preloads are now represented as root route manifest assets, script preloads follow the manifest script format, and script asset cross-origin configuration uses the `script` key. The `transformAssets` script callback context now exposes only `kind: 'script'` and `url`, keeping script format handling internal to manifest rendering. + +- Fix Rsbuild server function metadata replay when Rspack restores modules from its persistent cache. ([#7477](https://github.com/TanStack/router/pull/7477)) + + Server function metadata is now stored on Rspack module build info and replayed from cached modules before resolver modules are rebuilt, preventing warm restarts from losing server function registrations. + +- Updated dependencies [[`51a97a1`](https://github.com/TanStack/router/commit/51a97a167fb3ef1b8ca70fbb63db635158f43509)]: + - @tanstack/router-core@1.171.6 + - @tanstack/start-server-core@1.169.3 + - @tanstack/router-generator@1.167.10 + - @tanstack/router-plugin@1.168.11 + - @tanstack/start-client-core@1.170.3 + +## 1.171.3 + +### Patch Changes + +- Updated dependencies [[`5268ba4`](https://github.com/TanStack/router/commit/5268ba4566233ea58880df85f167ad0401a93a46)]: + - @tanstack/router-core@1.171.5 + - @tanstack/router-generator@1.167.9 + - @tanstack/router-plugin@1.168.10 + - @tanstack/start-client-core@1.170.2 + - @tanstack/start-server-core@1.169.2 + +## 1.171.2 + +### Patch Changes + +- Updated dependencies [[`7df0d02`](https://github.com/TanStack/router/commit/7df0d02bfb1407b1f07731ef69af24e2f0e415d7)]: + - @tanstack/router-generator@1.167.8 + - @tanstack/router-plugin@1.168.9 + +## 1.171.1 + +### Patch Changes + +- Updated dependencies [[`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960), [`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960)]: + - @tanstack/router-core@1.171.4 + - @tanstack/router-generator@1.167.7 + - @tanstack/router-plugin@1.168.8 + - @tanstack/start-client-core@1.170.1 + - @tanstack/start-server-core@1.169.1 + +## 1.171.0 + +### Minor Changes + +- Add deferred Hydrate boundary support for TanStack Start. ([#7362](https://github.com/TanStack/router/pull/7362)) + + Hydrate boundaries can now be code-split by the Start compiler, preload their generated client chunks, preserve server-rendered fallback HTML, and replay interaction-triggered events after hydration. The compiler integration now uses a Start-owned compiler plugin for Hydrate virtual modules across Vite and Rsbuild, with dev invalidation for generated virtual modules. + + Shared AST utilities used by the router code-splitter and Hydrate virtual modules were moved into `@tanstack/router-utils` so both pipelines can retain referenced top-level declarations, unwrap local exports, and let dead-code elimination remove unused route module code. + +### Patch Changes + +- Updated dependencies [[`c0f439c`](https://github.com/TanStack/router/commit/c0f439c59b04b7e49a0ab3aa2a0c550f522949e5), [`5fa9e55`](https://github.com/TanStack/router/commit/5fa9e555f3a2edb5e45586623e6bcbfa7f7c7a6b)]: + - @tanstack/router-plugin@1.168.7 + - @tanstack/start-client-core@1.170.0 + - @tanstack/start-server-core@1.169.0 + - @tanstack/router-core@1.171.3 + - @tanstack/router-utils@1.162.1 + - @tanstack/router-generator@1.167.6 + +## 1.170.6 + +### Patch Changes + +- Updated dependencies [[`b60eb36`](https://github.com/TanStack/router/commit/b60eb36e59e8a468ee0742cbcf7f47aca1ff1c67)]: + - @tanstack/router-core@1.171.2 + - @tanstack/router-generator@1.167.5 + - @tanstack/router-plugin@1.168.6 + - @tanstack/start-client-core@1.169.4 + - @tanstack/start-server-core@1.168.4 + +## 1.170.5 + +### Patch Changes + +- Updated dependencies [[`8146db7`](https://github.com/TanStack/router/commit/8146db7e54f5d508f1fb7d3927edd0a2f71dc930)]: + - @tanstack/router-plugin@1.168.5 + +## 1.170.4 + +### Patch Changes + +- Updated dependencies [[`d9cf933`](https://github.com/TanStack/router/commit/d9cf9331b83fcbd2abfee75d839d862f9bb18e6b)]: + - @tanstack/router-core@1.171.1 + - @tanstack/router-generator@1.167.4 + - @tanstack/router-plugin@1.168.4 + - @tanstack/start-client-core@1.169.3 + - @tanstack/start-server-core@1.168.3 + +## 1.170.3 + +### Patch Changes + +- Updated dependencies [[`d533f87`](https://github.com/TanStack/router/commit/d533f87976704098a40b48f160b37c28c8182806)]: + - @tanstack/router-core@1.171.0 + - @tanstack/router-generator@1.167.3 + - @tanstack/router-plugin@1.168.3 + - @tanstack/start-client-core@1.169.2 + - @tanstack/start-server-core@1.168.2 + +## 1.170.2 + +### Patch Changes + +- Updated dependencies [[`742941e`](https://github.com/TanStack/router/commit/742941e2f1bf069c950d0a4985b2cd733639509e)]: + - @tanstack/router-generator@1.167.2 + - @tanstack/router-plugin@1.168.2 + +## 1.170.1 + +### Patch Changes + +- Add runtime-configurable inline CSS and opt-in CSS URL templates for transformAssets. ([#7380](https://github.com/TanStack/router/pull/7380)) + +- Updated dependencies [[`2387a2e`](https://github.com/TanStack/router/commit/2387a2eea0683004cc400b9f71bed5944eb60110)]: + - @tanstack/router-core@1.170.1 + - @tanstack/start-server-core@1.168.1 + - @tanstack/router-generator@1.167.1 + - @tanstack/router-plugin@1.168.1 + - @tanstack/start-client-core@1.169.1 + +## 1.170.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- add createCsrfMiddleware based on Sec-Fetch-Site header, auto-apply to unconfigured servers, warn for others ([#7373](https://github.com/TanStack/router/pull/7373)) + +- Updated dependencies [[`b1c061a`](https://github.com/TanStack/router/commit/b1c061aff9185cdf5fdc08c0136382a9dce0302f), [`038cd12`](https://github.com/TanStack/router/commit/038cd123b70bc6154d75abb6404a744c376f8f6a), [`201e150`](https://github.com/TanStack/router/commit/201e150bd1412bae2faa9ce53f0fefcb7574ac14), [`5ae2ae5`](https://github.com/TanStack/router/commit/5ae2ae5e0f8ce32e02667a482ea9be52a6150240)]: + - @tanstack/router-core@1.170.0 + - @tanstack/router-generator@1.167.0 + - @tanstack/router-plugin@1.168.0 + - @tanstack/router-utils@1.162.0 + - @tanstack/start-client-core@1.169.0 + - @tanstack/start-server-core@1.168.0 + +## 1.169.20 + +### Patch Changes + +- Updated dependencies [[`c5811aa`](https://github.com/TanStack/router/commit/c5811aacb59b69a8179f14cd9529a51b2206d504)]: + - @tanstack/router-generator@1.166.42 + - @tanstack/router-plugin@1.167.35 + +## 1.169.19 + +### Patch Changes + +- Update seroval dependencies to version 1.5.4. ([#7340](https://github.com/TanStack/router/pull/7340)) + +- Updated dependencies [[`35e88f0`](https://github.com/TanStack/router/commit/35e88f04996d71019a1868b7b06ecb4ddbc9df9e)]: + - @tanstack/router-core@1.169.2 + - @tanstack/start-client-core@1.168.2 + - @tanstack/start-server-core@1.167.30 + - @tanstack/router-generator@1.166.41 + - @tanstack/router-plugin@1.167.34 + +## 1.169.18 + +### Patch Changes + +- Parse plain TypeScript files without JSX when a filename is available, preventing angle-bracket type assertions from being interpreted as JSX during route and Start import-protection transforms. ([#7342](https://github.com/TanStack/router/pull/7342)) + +- Updated dependencies [[`056337e`](https://github.com/TanStack/router/commit/056337ef02ccbeaf45ec8533a227761be869e8f3)]: + - @tanstack/router-generator@1.166.40 + - @tanstack/router-plugin@1.167.33 + - @tanstack/router-utils@1.161.8 + +## 1.169.17 + +### Patch Changes + +- Updated dependencies [[`afa40ef`](https://github.com/TanStack/router/commit/afa40ef46c273c53646ba33f607fc618a07ffede)]: + - @tanstack/start-server-core@1.167.29 + +## 1.169.16 + +### Patch Changes + +- Updated dependencies [[`709627f`](https://github.com/TanStack/router/commit/709627f3dbc6d97daa547a1401ef42a53bc4be32)]: + - @tanstack/start-server-core@1.167.28 + +## 1.169.15 + +### Patch Changes + +- Updated dependencies [[`238ea4a`](https://github.com/TanStack/router/commit/238ea4a4998ab3a7fd528b317e1935766ac65df8)]: + - @tanstack/start-server-core@1.167.27 + +## 1.169.14 + +### Patch Changes + +- Replace global route metadata with explicit router plugin contexts so multiple router plugin instances cannot cross-transform route files. ([#7313](https://github.com/TanStack/router/pull/7313)) + +- Updated dependencies [[`96818b8`](https://github.com/TanStack/router/commit/96818b8ba5ead6f1f027094841330182aff415b2)]: + - @tanstack/router-plugin@1.167.32 + +## 1.169.13 + +### Patch Changes + +- Add compiler-driven RSC CSS auto-injection for Start RSC render APIs and wire it into the React Start Vite and Rsbuild adapters. This ensures same-file CSS module dependencies are discovered for `renderServerComponent`, `createCompositeComponent`, and JSX-based `renderToReadableStream` calls. ([#7310](https://github.com/TanStack/router/pull/7310)) + + Also add a configurable server function provider module directive hook used by the React Rsbuild RSC adapter to emit `"use server-entry"` only for extracted provider files. + +## 1.169.12 + +### Patch Changes + +- Updated dependencies [[`4a1e63f`](https://github.com/TanStack/router/commit/4a1e63f1d1230b1ed8234609acad4639d8982c13)]: + - @tanstack/router-core@1.169.1 + - @tanstack/router-generator@1.166.39 + - @tanstack/router-plugin@1.167.31 + - @tanstack/start-client-core@1.168.1 + - @tanstack/start-server-core@1.167.26 + +## 1.169.11 + +### Patch Changes + +- Updated dependencies [[`82b0613`](https://github.com/TanStack/router/commit/82b06132af776f74603ab27977cc277d6219a845)]: + - @tanstack/start-client-core@1.168.0 + - @tanstack/start-server-core@1.167.25 + +## 1.169.10 + +### Patch Changes + +- Ignore fully type-only imports and re-exports when collecting import-protection sources so type-only references to protected modules do not trigger violations. ([#7305](https://github.com/TanStack/router/pull/7305)) + +## 1.169.9 + +### Patch Changes + +- Sort server function manifest entries by ID before emitting the resolver module. The `serverFnsById` map is populated in source-file scan order, which varies across machines and incremental builds, producing non-deterministic key ordering in the emitted `__tanstack-start-server-fn-resolver-*.mjs` artifact. Stable alphabetic sorting ensures reproducible builds, consistent content hashes, and clean `git diff` on committed artifacts. ([#7287](https://github.com/TanStack/router/pull/7287)) + +## 1.169.8 + +### Patch Changes + +- Updated dependencies [[`c992495`](https://github.com/TanStack/router/commit/c992495bf4010ff4c3597bb1f3b1ba02594e857e)]: + - @tanstack/router-core@1.169.0 + - @tanstack/router-generator@1.166.38 + - @tanstack/router-plugin@1.167.30 + - @tanstack/start-client-core@1.167.22 + - @tanstack/start-server-core@1.167.24 + +## 1.169.7 + +### Patch Changes + +- Updated dependencies [[`b5c4183`](https://github.com/TanStack/router/commit/b5c4183ab8b44be8a75647b7f7b588ad7c146ece)]: + - @tanstack/router-core@1.168.18 + - @tanstack/router-generator@1.166.37 + - @tanstack/router-plugin@1.167.29 + - @tanstack/start-client-core@1.167.21 + - @tanstack/start-server-core@1.167.23 + +## 1.169.6 + +### Patch Changes + +- Updated dependencies [[`493148b`](https://github.com/TanStack/router/commit/493148bc5378b7f9de1544d87f6aaa425c12eb34)]: + - @tanstack/router-core@1.168.17 + - @tanstack/router-generator@1.166.36 + - @tanstack/router-plugin@1.167.28 + - @tanstack/start-client-core@1.167.20 + - @tanstack/start-server-core@1.167.22 + +## 1.169.5 + +### Patch Changes + +- Updated dependencies [[`a2ad394`](https://github.com/TanStack/router/commit/a2ad394598e2079ab4050ebb16bb03b31d69c32a)]: + - @tanstack/router-generator@1.166.35 + - @tanstack/router-plugin@1.167.27 + +## 1.169.4 + +### Patch Changes + +- Updated dependencies [[`8b97002`](https://github.com/TanStack/router/commit/8b97002af3f6d15204e60c55d3f5735b78bd7efe), [`8b97002`](https://github.com/TanStack/router/commit/8b97002af3f6d15204e60c55d3f5735b78bd7efe)]: + - @tanstack/start-client-core@1.167.19 + - @tanstack/router-plugin@1.167.26 + - @tanstack/start-server-core@1.167.21 + +## 1.169.3 + +### Patch Changes + +- Updated dependencies [[`1e371b6`](https://github.com/TanStack/router/commit/1e371b60f1832c158ff4953a4ae6c5ccfe8460b3)]: + - @tanstack/router-plugin@1.167.25 + +## 1.169.2 + +### Patch Changes + +- Add TanStack Start inline CSS manifest support for SSR so route styles can be embedded in the HTML response and hydrated without duplicate stylesheet links. ([#7253](https://github.com/TanStack/router/pull/7253)) + +- Updated dependencies [[`4d864ee`](https://github.com/TanStack/router/commit/4d864eebbd184265eabb563d326ab409c93feb17)]: + - @tanstack/router-core@1.168.16 + - @tanstack/start-server-core@1.167.20 + - @tanstack/router-generator@1.166.34 + - @tanstack/router-plugin@1.167.24 + - @tanstack/start-client-core@1.167.18 + +## 1.169.1 + +### Patch Changes + +- Fix CSS asset ordering so styles from imported chunks are emitted before route chunk styles. ([#7251](https://github.com/TanStack/router/pull/7251)) + +## 1.169.0 + +### Minor Changes + +- Split Start plugin core bundler APIs into explicit Vite and Rsbuild subpaths so projects only need the bundler they use. Mark both `vite` and `@rsbuild/core` peers as optional where Start exposes both integrations. ([#7249](https://github.com/TanStack/router/pull/7249)) + +## 1.168.0 + +### Minor Changes + +- rsbuild ([#7228](https://github.com/TanStack/router/pull/7228)) + +### Patch Changes + +- Updated dependencies [[`91a7089`](https://github.com/TanStack/router/commit/91a708989d00537a21911e74ff60bbfec8266295)]: + - @tanstack/router-plugin@1.167.23 + - @tanstack/router-utils@1.161.7 + - @tanstack/router-generator@1.166.33 + +## 1.167.35 + +### Patch Changes + +- Fix missing CSS module assets in TanStack Start production manifests when Vite `build.cssCodeSplit` is disabled. ([#7191](https://github.com/TanStack/router/pull/7191)) + +## 1.167.34 + +### Patch Changes + +- Updated dependencies [[`16f6892`](https://github.com/TanStack/router/commit/16f6892d6b7ceadf606677c5a40e743f29163aa6)]: + - @tanstack/router-core@1.168.15 + - @tanstack/router-generator@1.166.32 + - @tanstack/router-plugin@1.167.22 + - @tanstack/start-client-core@1.167.17 + - @tanstack/start-server-core@1.167.19 + +## 1.167.33 + +### Patch Changes + +- Fix Start virtual module resolution in pnpm workspaces by serving the client entry through a real Vite virtual module. ([#7178](https://github.com/TanStack/router/pull/7178)) + + Simplify Start virtual module handling by sharing a single `createVirtualModule` helper and collapsing internal `@tanstack/start-plugin-core` imports to the root export surface. + +## 1.167.32 + +### Patch Changes + +- Updated dependencies [[`328d7e5`](https://github.com/TanStack/router/commit/328d7e5ebc6b8074242a07d68ccafafb83e37a0e)]: + - @tanstack/router-generator@1.166.31 + - @tanstack/router-plugin@1.167.21 + +## 1.167.31 + +### Patch Changes + +- Updated dependencies [[`96ac2d8`](https://github.com/TanStack/router/commit/96ac2d8ed378340d63b88afeec3633e56e29b5f8)]: + - @tanstack/router-plugin@1.167.20 + +## 1.167.30 + +### Patch Changes + +- Updated dependencies [[`105d056`](https://github.com/TanStack/router/commit/105d05691a247779a63e7b688aa1207cce619339)]: + - @tanstack/router-generator@1.166.30 + - @tanstack/router-plugin@1.167.19 + +## 1.167.29 + +### Patch Changes + +- Updated dependencies [[`656a2a0`](https://github.com/TanStack/router/commit/656a2a040e79df7721d776e3751c8d634666570b)]: + - @tanstack/router-plugin@1.167.18 + +## 1.167.28 + +### Patch Changes + +- Updated dependencies [[`0e2c900`](https://github.com/TanStack/router/commit/0e2c9003c18ae07c09969189c028f277ea562a7a)]: + - @tanstack/start-server-core@1.167.18 + - @tanstack/router-core@1.168.14 + - @tanstack/router-generator@1.166.29 + - @tanstack/router-plugin@1.167.17 + - @tanstack/start-client-core@1.167.16 + +## 1.167.27 + +### Patch Changes + +- Reduce React Start SSR manifest payload size by omitting unmatched route assets from dehydrated router state while keeping start-manifest asset serialization deduplicated by shared object identity. ([#7157](https://github.com/TanStack/router/pull/7157)) + + This improves SSR HTML size for apps with many routes that share the same CSS assets and adds regression coverage for CSS module hydration, navigation, and start-manifest asset reuse. + +- Updated dependencies [[`812792f`](https://github.com/TanStack/router/commit/812792fbda3caf97b300770855cf5641252f413b)]: + - @tanstack/router-core@1.168.13 + - @tanstack/start-server-core@1.167.17 + - @tanstack/router-generator@1.166.28 + - @tanstack/router-plugin@1.167.16 + - @tanstack/start-client-core@1.167.15 + +## 1.167.26 + +### Patch Changes + +- Updated dependencies [[`8ec9ca9`](https://github.com/TanStack/router/commit/8ec9ca97b472779de878c2a6510f21deb24d386c)]: + - @tanstack/router-core@1.168.12 + - @tanstack/router-generator@1.166.27 + - @tanstack/router-plugin@1.167.15 + - @tanstack/start-client-core@1.167.14 + - @tanstack/start-server-core@1.167.16 + +## 1.167.25 + +### Patch Changes + +- Reuse previously discovered server function IDs across compiler instances so custom `generateFunctionId` values stay stable when duplicate IDs are deduplicated during build. ([#7153](https://github.com/TanStack/router/pull/7153)) + + This fixes cases where different build environments could assign different deduped IDs to the same server functions, which could cause requests to resolve to the wrong handler. + +## 1.167.24 + +### Patch Changes + +- Updated dependencies [[`6355bb7`](https://github.com/TanStack/router/commit/6355bb75f7637ba77f06a923c18fdaf37720bb48)]: + - @tanstack/start-server-core@1.167.15 + - @tanstack/router-plugin@1.167.14 + - @tanstack/router-core@1.168.11 + - @tanstack/router-generator@1.166.26 + - @tanstack/start-client-core@1.167.13 + +## 1.167.23 + +### Patch Changes + +- Updated dependencies [[`459057c`](https://github.com/TanStack/router/commit/459057cd2d90cff20d20e51d4964b0a8c950555e)]: + - @tanstack/start-client-core@1.167.12 + - @tanstack/start-server-core@1.167.14 + - @tanstack/router-plugin@1.167.13 + - @tanstack/router-core@1.168.10 + - @tanstack/router-generator@1.166.25 + +## 1.167.22 + +### Patch Changes + +- Updated dependencies [[`f8ac427`](https://github.com/TanStack/router/commit/f8ac427000c3fec99225926e72f9f2fc7a37231f)]: + - @tanstack/start-server-core@1.167.13 + - @tanstack/start-client-core@1.167.11 + +## 1.167.21 + +### Patch Changes + +- fix publishing ([`2d53c05`](https://github.com/TanStack/router/commit/2d53c056ef0b203de8a28bc92c24e8e604205d52)) + +- Updated dependencies [[`2d53c05`](https://github.com/TanStack/router/commit/2d53c056ef0b203de8a28bc92c24e8e604205d52)]: + - @tanstack/start-server-core@1.167.12 + +## 1.167.19 + +### Patch Changes + +- Republish the React Start RSC package chain so fresh installs resolve a `start-plugin-core` build that exports the subpaths used by `react-start-rsc`. ([`3384abc`](https://github.com/TanStack/router/commit/3384abcffd98a68eb254b11221834bcbcdebec31)) + +## 1.167.18 + +### Patch Changes + +- Updated dependencies [[`f7e9c5e`](https://github.com/TanStack/router/commit/f7e9c5e323793d1b28c96871819c265fd28ae397)]: + - @tanstack/start-client-core@1.167.10 + - @tanstack/start-server-core@1.167.10 + ## 1.167.17 ### Patch Changes diff --git a/packages/start-plugin-core/package.json b/packages/start-plugin-core/package.json index 43a0dac500..c63971500a 100644 --- a/packages/start-plugin-core/package.json +++ b/packages/start-plugin-core/package.json @@ -1,6 +1,6 @@ { "name": "@tanstack/start-plugin-core", - "version": "1.167.17", + "version": "1.171.10", "description": "Modern and scalable routing for React applications", "author": "Tanner Linsley", "license": "MIT", @@ -50,6 +50,30 @@ "default": "./dist/esm/index.js" } }, + "./utils": { + "import": { + "types": "./dist/esm/utils.d.ts", + "default": "./dist/esm/utils.js" + } + }, + "./vite": { + "import": { + "types": "./dist/esm/vite/index.d.ts", + "default": "./dist/esm/vite/index.js" + } + }, + "./rsbuild": { + "import": { + "types": "./dist/esm/rsbuild/index.d.ts", + "default": "./dist/esm/rsbuild/index.js" + } + }, + "./rsbuild/types": { + "import": { + "types": "./dist/esm/rsbuild/types.d.ts", + "default": "./dist/esm/rsbuild/types.js" + } + }, "./package.json": "./package.json" }, "sideEffects": false, @@ -64,33 +88,44 @@ "@babel/code-frame": "7.27.1", "@babel/core": "^7.28.5", "@babel/types": "^7.28.5", - "@rolldown/pluginutils": "1.0.0-beta.40", + "@rolldown/pluginutils": "1.0.1", "@tanstack/router-core": "workspace:*", "@tanstack/router-generator": "workspace:*", "@tanstack/router-plugin": "workspace:*", "@tanstack/router-utils": "workspace:*", "@tanstack/start-client-core": "workspace:*", "@tanstack/start-server-core": "workspace:*", - "cheerio": "^1.0.0", "exsolve": "^1.0.7", + "lightningcss": "^1.32.0", "pathe": "^2.0.3", "picomatch": "^4.0.3", - "srvx": "^0.11.9", + "seroval": "^1.5.4", "source-map": "^0.7.6", + "srvx": "^0.11.9", "tinyglobby": "^0.2.15", "ufo": "^1.5.4", "vitefu": "^1.1.1", "xmlbuilder2": "^4.0.3", - "zod": "^3.24.2" + "zod": "^4.4.3" }, "devDependencies": { + "@rsbuild/core": "^2.0.8", "@types/babel__code-frame": "^7.0.6", "@types/babel__core": "^7.20.5", + "@types/node": ">=20", "@types/picomatch": "^4.0.2", - "vite": "*", - "@types/node": ">=20" + "vite": "*" }, "peerDependencies": { + "@rsbuild/core": "^2.0.0", "vite": ">=7.0.0" + }, + "peerDependenciesMeta": { + "@rsbuild/core": { + "optional": true + }, + "vite": { + "optional": true + } } } diff --git a/packages/start-plugin-core/src/config-context.ts b/packages/start-plugin-core/src/config-context.ts new file mode 100644 index 0000000000..825860a595 --- /dev/null +++ b/packages/start-plugin-core/src/config-context.ts @@ -0,0 +1,138 @@ +import { + createNormalizedBasePaths, + createNormalizedOutputDirectories, + deriveRouterBasepath, + resolveStartEntryPlan, +} from './planning' +import type { TanStackStartOutputConfig } from './schema' +import type { + GetConfigFn, + ResolvedStartConfig, + TanStackStartCoreOptions, +} from './types' + +export interface StartConfigContext { + resolvedStartConfig: ResolvedStartConfig + getConfig: GetConfigFn + resolveEntries: () => ReturnType<typeof resolveStartEntryPlan> +} + +export function createStartConfigContext<TInputConfig>(opts: { + corePluginOpts: TanStackStartCoreOptions + startPluginOpts: TInputConfig | undefined + parseConfig: ( + opts: TInputConfig | undefined, + core: { framework: TanStackStartCoreOptions['framework'] }, + root: string, + ) => TanStackStartOutputConfig +}): StartConfigContext { + const resolvedStartConfig: ResolvedStartConfig = { + root: '', + startFilePath: undefined, + routerFilePath: '', + srcDirectory: '', + basePaths: { + publicBase: '', + assetBase: { + dev: '', + build: '', + }, + }, + outputDirectories: { + client: '', + server: '', + }, + } + + let startConfig: TanStackStartOutputConfig | null = null + let resolvedEntryPlanCache: + | ReturnType<typeof resolveStartEntryPlan> + | undefined + + function requireRoot(): string { + if (!resolvedStartConfig.root) { + throw new Error(`Cannot get config before root is resolved`) + } + + return resolvedStartConfig.root + } + + function getStartConfig(): TanStackStartOutputConfig { + if (!startConfig) { + startConfig = opts.parseConfig( + opts.startPluginOpts, + { framework: opts.corePluginOpts.framework }, + requireRoot(), + ) + } + + return startConfig + } + + function getResolvedEntryPlan() { + if (resolvedEntryPlanCache) { + return resolvedEntryPlanCache + } + + resolvedEntryPlanCache = resolveStartEntryPlan({ + root: requireRoot(), + startConfig: getStartConfig(), + defaultEntryPaths: opts.corePluginOpts.defaultEntryPaths, + }) + + Object.assign(resolvedStartConfig, { + srcDirectory: resolvedEntryPlanCache.srcDirectory, + startFilePath: resolvedEntryPlanCache.startFilePath, + routerFilePath: resolvedEntryPlanCache.routerFilePath, + }) + + return resolvedEntryPlanCache + } + + const getConfig: GetConfigFn = () => { + const startConfig = getStartConfig() + getResolvedEntryPlan() + + return { startConfig, resolvedStartConfig } + } + + function resolveEntries() { + return getResolvedEntryPlan() + } + + return { + resolvedStartConfig, + getConfig, + resolveEntries, + } +} + +export function applyResolvedBaseAndOutput(opts: { + resolvedStartConfig: ResolvedStartConfig + root: string + publicBase: string + clientOutputDirectory: string + serverOutputDirectory: string +}): void { + opts.resolvedStartConfig.root = opts.root + opts.resolvedStartConfig.basePaths = createNormalizedBasePaths({ + publicBase: opts.publicBase, + }) + opts.resolvedStartConfig.outputDirectories = + createNormalizedOutputDirectories({ + client: opts.clientOutputDirectory, + server: opts.serverOutputDirectory, + }) +} + +export function applyResolvedRouterBasepath(opts: { + resolvedStartConfig: ResolvedStartConfig + startConfig: TanStackStartOutputConfig +}): string { + const routerBasepath = deriveRouterBasepath({ + configuredBasepath: opts.startConfig.router.basepath, + publicBase: opts.resolvedStartConfig.basePaths.publicBase, + }) + opts.startConfig.router.basepath = routerBasepath + return routerBasepath +} diff --git a/packages/start-plugin-core/src/constants.ts b/packages/start-plugin-core/src/constants.ts index 9159cc1482..d31c9e8246 100644 --- a/packages/start-plugin-core/src/constants.ts +++ b/packages/start-plugin-core/src/constants.ts @@ -1,12 +1,16 @@ -export const VITE_ENVIRONMENT_NAMES = { +export const START_ENVIRONMENT_NAMES = { // 'ssr' is chosen as the name for the server environment to ensure backwards compatibility // with vite plugins that are not compatible with the new vite environment API (e.g. tailwindcss) server: 'ssr', client: 'client', } as const -export type ViteEnvironmentNames = - (typeof VITE_ENVIRONMENT_NAMES)[keyof typeof VITE_ENVIRONMENT_NAMES] +export type StartEnvironmentName = + (typeof START_ENVIRONMENT_NAMES)[keyof typeof START_ENVIRONMENT_NAMES] + +export const VITE_ENVIRONMENT_NAMES = START_ENVIRONMENT_NAMES + +export type ViteEnvironmentNames = StartEnvironmentName // for client and router: // if a user has a custom server/client entry point file, resolve.alias will point to this @@ -19,6 +23,8 @@ export const ENTRY_POINTS = { router: '#tanstack-router-entry', } as const +export const DEV_CLIENT_ENTRY = 'virtual:tanstack-start-dev-client-entry' + export const SERVER_FN_LOOKUP = 'server-fn-module-lookup' // matches diff --git a/packages/start-plugin-core/src/dev-server-plugin/extract-html-scripts.ts b/packages/start-plugin-core/src/dev-server-plugin/extract-html-scripts.ts deleted file mode 100644 index 41e3ac44a9..0000000000 --- a/packages/start-plugin-core/src/dev-server-plugin/extract-html-scripts.ts +++ /dev/null @@ -1,19 +0,0 @@ -import * as cheerio from 'cheerio' - -export function extractHtmlScripts( - html: string, -): Array<{ content?: string; src?: string }> { - const $ = cheerio.load(html) - const scripts: Array<{ content?: string; src?: string }> = [] - - $('script').each((_, element) => { - const src = $(element).attr('src') - const content = $(element).html() ?? undefined - scripts.push({ - src, - content, - }) - }) - - return scripts -} diff --git a/packages/start-plugin-core/src/hydrate-when-transform.ts b/packages/start-plugin-core/src/hydrate-when-transform.ts new file mode 100644 index 0000000000..d88ddb60d0 --- /dev/null +++ b/packages/start-plugin-core/src/hydrate-when-transform.ts @@ -0,0 +1,1004 @@ +import { relative } from 'node:path' +import crypto from 'node:crypto' +import babel from '@babel/core' +import * as t from '@babel/types' +import { + buildDeclarationMap, + buildDependencyGraph, + collectIdentifiersFromNode, + collectIdentifiersFromPattern, + collectLocalBindingsFromStatement, + deadCodeElimination, + expandTransitively, + findReferencedIdentifiers, + generateFromAst, + parseAst, + removeModuleLevelBindings, + retainModuleLevelDeclarations, + stripUnreferencedTopLevelExpressionStatements, + unwrapExportedDeclarations, +} from '@tanstack/router-utils' +import { tssHydrate } from './hydration-constants' +import { cleanId, codeFrameError } from './start-compiler/utils' +import type { + CompileStartFrameworkOptions, + StartCompilerPlugin, + StartCompilerTransformResult, +} from './types' + +export class MissingHydrateSourceError extends Error { + constructor(id: string) { + super( + `Missing Hydrate source for virtual module ${id}. The parent module must be transformed before its Hydrate child chunk is loaded.`, + ) + } +} + +/** + * Detection pattern used by the transform code filter to pre-scan files for + * `<Hydrate>` JSX before any AST parsing happens. + */ +const HYDRATE_DETECTION_PATTERN = /\bHydrate\b/ + +function createBoundaryId(root: string, sourceId: string) { + const normalized = relative(root, sourceId).replaceAll('\\', '/') + const sourceHash = crypto + .createHash('sha1') + .update(normalized) + .digest('hex') + .slice(0, 10) + + return (index: number) => { + return `${index.toString(36)}_${sourceHash}` + } +} + +function getJSXElementName(node: t.JSXElement) { + const name = node.openingElement.name + return t.isJSXIdentifier(name) ? name.name : undefined +} + +function getJSXAttribute(node: t.JSXOpeningElement, name: string) { + for (const item of node.attributes) { + if (t.isJSXAttribute(item) && t.isJSXIdentifier(item.name, { name })) { + return item + } + } + + return undefined +} + +function getBooleanProp(node: t.JSXOpeningElement, name: string) { + const attr = getJSXAttribute(node, name) + if (!attr) return undefined + if (!attr.value) return true + if (t.isStringLiteral(attr.value)) return attr.value.value !== 'false' + if (t.isJSXExpressionContainer(attr.value)) { + if (t.isBooleanLiteral(attr.value.expression)) { + return attr.value.expression.value + } + } + return undefined +} + +function parseHydrateVirtualId(id: string) { + const queryIndex = id.indexOf('?') + const sourceId = cleanId(queryIndex === -1 ? id : id.slice(0, queryIndex)) + if (queryIndex === -1) { + return { sourceId, splitId: null, boundaryIndex: -1 } + } + + const rawQuery = id.slice(queryIndex + 1) + const params = new URLSearchParams(rawQuery) + const splitId = params.get(tssHydrate) + let boundaryIndex = -1 + if (splitId) { + const separatorIndex = splitId.indexOf('_') + if (separatorIndex > 0) { + const parsedIndex = Number.parseInt(splitId.slice(0, separatorIndex), 36) + if (Number.isInteger(parsedIndex)) { + boundaryIndex = parsedIndex + } + } + } + + return { + sourceId, + splitId, + boundaryIndex, + } +} + +function isObjectPropertyName( + property: t.ObjectMethod | t.ObjectProperty, + name: string, +) { + if (t.isIdentifier(property.key) && !property.computed) { + return property.key.name === name + } + + return t.isStringLiteral(property.key) && property.key.value === name +} + +function isReferenceInsideAnyNode( + referencePath: babel.NodePath, + nodes: ReadonlySet<t.Node>, +) { + if (nodes.has(referencePath.node)) return true + return Boolean(referencePath.findParent((parent) => nodes.has(parent.node))) +} + +function stripBindingsOnlyReferencedBy( + path: babel.NodePath<t.JSXElement>, + node: t.Node, + seen = new Set<string>(), + preserve = new Set<string>(), +) { + stripBindingsOnlyReferencedByNodes(path.scope, [node], seen, preserve) +} + +function stripBindingsOnlyReferencedByNodes( + scope: babel.NodePath['scope'], + nodes: ReadonlyArray<t.Node>, + seen = new Set<string>(), + preserve = new Set<string>(), +) { + const nodeSet = new Set(nodes) + const names = new Set<string>() + nodes.forEach((node) => { + collectIdentifiersFromNode(node).forEach((name) => names.add(name)) + }) + + for (const name of names) { + if (seen.has(name)) continue + if (preserve.has(name)) continue + const binding = scope.getBinding(name) + if (!binding?.constant) continue + if ( + binding.path.findParent( + (parentPath) => + parentPath.isExportNamedDeclaration() || + parentPath.isExportDefaultDeclaration(), + ) + ) { + continue + } + if (binding.referencePaths.length === 0) continue + if ( + !binding.referencePaths.every((referencePath) => + isReferenceInsideAnyNode(referencePath, nodeSet), + ) + ) { + continue + } + + seen.add(name) + + const declarationPath = binding.path.isVariableDeclarator() + ? binding.path + : binding.path.findParent((parentPath) => + parentPath.isVariableDeclarator(), + ) + const patternHasExternalReferences = + declarationPath?.isVariableDeclarator() && + !t.isIdentifier(declarationPath.node.id) && + collectIdentifiersFromPattern(declarationPath.node.id).some( + (bindingName) => { + if (bindingName === binding.identifier.name) return false + + const siblingBinding = binding.scope.getBinding(bindingName) + return siblingBinding?.referencePaths.some( + (referencePath) => + !isReferenceInsideAnyNode(referencePath, nodeSet), + ) + }, + ) + + if (patternHasExternalReferences) { + continue + } + + const bindingNode = binding.path.node + if (t.isVariableDeclarator(bindingNode) && bindingNode.init) { + stripBindingsOnlyReferencedByNodes( + binding.scope, + [bindingNode.init], + seen, + preserve, + ) + } else if ( + t.isFunctionDeclaration(bindingNode) || + t.isClassDeclaration(bindingNode) + ) { + stripBindingsOnlyReferencedByNodes( + binding.scope, + [bindingNode], + seen, + preserve, + ) + } + + if (binding.path.isVariableDeclarator()) { + const declarationPath = binding.path.parentPath + if ( + declarationPath.isVariableDeclaration() && + declarationPath.node.declarations.length === 1 + ) { + declarationPath.remove() + continue + } + + binding.path.remove() + continue + } + + if ( + binding.path.isImportSpecifier() || + binding.path.isImportDefaultSpecifier() || + binding.path.isImportNamespaceSpecifier() + ) { + const importPath = binding.path.parentPath + if ( + importPath.isImportDeclaration() && + importPath.node.specifiers.length === 1 + ) { + importPath.remove() + continue + } + + binding.path.remove() + continue + } + + binding.path.remove() + } +} + +function getSingleUseObjectExpressionBinding( + path: babel.NodePath<t.JSXElement>, + identifier: t.Identifier, +) { + const binding = path.scope.getBinding(identifier.name) + if (!binding?.constant) return undefined + if (binding.referencePaths.length !== 1) return undefined + if (binding.referencePaths[0]?.node !== identifier) return undefined + if (!binding.path.isVariableDeclarator()) return undefined + const init = binding.path.node.init + return t.isObjectExpression(init) ? init : undefined +} + +function objectExpressionMayHaveProperty( + node: t.ObjectExpression, + name: string, +) { + return node.properties.some((property) => { + if (t.isSpreadElement(property)) return true + if (!t.isObjectMethod(property) && !t.isObjectProperty(property)) { + return true + } + if (property.computed) return true + return isObjectPropertyName(property, name) + }) +} + +function stripObjectExpressionProperty( + path: babel.NodePath<t.JSXElement>, + node: t.ObjectExpression, + name: string, +) { + let modified = false + + node.properties = node.properties.filter((property) => { + if ( + (t.isObjectMethod(property) || t.isObjectProperty(property)) && + isObjectPropertyName(property, name) + ) { + stripBindingsOnlyReferencedBy( + path, + t.isObjectProperty(property) ? property.value : property.body, + ) + modified = true + return false + } + + return true + }) + + return modified +} + +function throwBoundaryError( + code: string, + path: babel.NodePath<t.JSXElement>, + message: string, +): never { + if (path.node.loc) { + throw codeFrameError(code, path.node.loc, message) + } + throw new Error(message) +} + +function inspectSplitBoundary(options: { + code: string + path: babel.NodePath<t.JSXElement> + validate?: boolean + collectCaptured?: boolean + nestedHydrate?: { + localName: string + } +}) { + const { path } = options + const capturedNames = options.collectCaptured ? new Set<string>() : undefined + const nestedHydrate = options.nestedHydrate + let nestedBoundaryCount = 0 + + if (options.validate) { + for (const child of path.node.children) { + if ( + t.isJSXExpressionContainer(child) && + (t.isFunctionExpression(child.expression) || + t.isArrowFunctionExpression(child.expression)) + ) { + throwBoundaryError( + options.code, + path, + 'Hydrate cannot code-split function-as-children. Use split={false} for this boundary.', + ) + } + } + } + + const rootVisitors = { + JSXOpeningElement(openingPath: babel.NodePath<t.JSXOpeningElement>) { + if (openingPath.node === path.node.openingElement) { + openingPath.skip() + } + }, + JSXClosingElement(closingPath: babel.NodePath<t.JSXClosingElement>) { + closingPath.skip() + }, + } + + const validateVisitors = options.validate + ? { + CallExpression(callPath: babel.NodePath<t.CallExpression>) { + if (!t.isIdentifier(callPath.node.callee)) return + if (!/^use[A-Z0-9]/.test(callPath.node.callee.name)) return + + throwBoundaryError( + options.code, + path, + 'Hydrate cannot code-split JSX that calls hooks during render. Move the hook call into a child component or use split={false}.', + ) + }, + ThisExpression(thisPath: babel.NodePath<t.ThisExpression>) { + void thisPath + throwBoundaryError( + options.code, + path, + 'Hydrate cannot code-split JSX that captures this.', + ) + }, + Super(superPath: babel.NodePath<t.Super>) { + void superPath + throwBoundaryError( + options.code, + path, + 'Hydrate cannot code-split JSX that captures super.', + ) + }, + } + : {} + + const nestedHydrateVisitors = nestedHydrate + ? { + JSXElement(nestedPath: babel.NodePath<t.JSXElement>) { + if (getJSXElementName(nestedPath.node) !== nestedHydrate.localName) { + return + } + + const split = getBooleanProp(nestedPath.node.openingElement, 'split') + if (split === false) return + + nestedBoundaryCount++ + }, + } + : {} + + const captureVisitors = capturedNames + ? { + Identifier(identifierPath: babel.NodePath<t.Identifier>) { + const parent = identifierPath.parent + if ( + t.isJSXOpeningElement(parent) || + t.isJSXClosingElement(parent) || + (t.isObjectProperty(parent, { key: identifierPath.node }) && + !parent.computed && + !parent.shorthand) || + (t.isMemberExpression(parent, { + property: identifierPath.node, + }) && + !parent.computed) + ) { + return + } + + const binding = identifierPath.scope.getBinding( + identifierPath.node.name, + ) + if (!binding) return + if (t.isProgram(binding.scope.block)) return + if ( + path.node === binding.scope.block || + path.isAncestor(binding.path) + ) + return + + capturedNames.add(identifierPath.node.name) + }, + JSXIdentifier(identifierPath: babel.NodePath<t.JSXIdentifier>) { + if (identifierPath.parentKey !== 'name') return + const name = identifierPath.node.name + if (!/^[A-Z]/.test(name)) return + const binding = identifierPath.scope.getBinding(name) + if (!binding) return + if (t.isProgram(binding.scope.block)) return + + capturedNames.add(name) + }, + } + : {} + + path.traverse({ + ...rootVisitors, + ...validateVisitors, + ...nestedHydrateVisitors, + ...captureVisitors, + }) + + return { + captured: capturedNames ? [...capturedNames].sort() : [], + nestedBoundaryCount, + } +} + +function getHydrateImport( + ast: t.File, + framework: CompileStartFrameworkOptions, +) { + const hydrateImportSource = `@tanstack/${framework}-start` + + for (const node of ast.program.body) { + if (!t.isImportDeclaration(node)) continue + if (node.source.value !== hydrateImportSource) continue + + for (const specifier of node.specifiers) { + if ( + t.isImportSpecifier(specifier) && + t.isIdentifier(specifier.imported, { name: 'Hydrate' }) + ) { + return { + hydrateLocalName: specifier.local.name, + } + } + } + } + + return undefined +} + +function getMeaningfulChildren( + children: Array<t.JSXElement['children'][number]>, +) { + return children.filter( + (child) => !(t.isJSXText(child) && child.value.trim() === ''), + ) +} + +function transformHydrateAst(options: { + ast: t.File + code: string + id: string + root: string + env: 'client' | 'server' + framework: CompileStartFrameworkOptions + indexOffset?: number +}) { + if (!options.code.includes('Hydrate')) return null + + const hydrateImport = getHydrateImport(options.ast, options.framework) + if (!hydrateImport) return null + const { hydrateLocalName: localName } = hydrateImport + const sourceId = cleanId(options.id) + const getBoundaryId = createBoundaryId(options.root, sourceId) + + let nextBoundaryIndex = options.indexOffset ?? 0 + const state = { + modified: false, + extractedChildNodes: [] as Array<t.Node>, + capturedNames: new Set<string>(), + } + let lazyIdent: t.Identifier | undefined + + babel.traverse(options.ast, { + Program(programPath) { + programPath.traverse({ + JSXElement(path) { + if (getJSXElementName(path.node) !== localName) return + + if (options.env === 'server') { + path.node.openingElement.attributes = + path.node.openingElement.attributes.filter((item) => { + if ( + t.isJSXAttribute(item) && + t.isJSXIdentifier(item.name, { name: 'fallback' }) + ) { + if (item.value) { + stripBindingsOnlyReferencedBy(path, item.value) + } + state.modified = true + return false + } + + if ( + t.isJSXSpreadAttribute(item) && + t.isObjectExpression(item.argument) + ) { + if ( + stripObjectExpressionProperty( + path, + item.argument, + 'fallback', + ) + ) { + state.modified = true + } + return item.argument.properties.length > 0 + } + + if ( + t.isJSXSpreadAttribute(item) && + t.isIdentifier(item.argument) + ) { + const init = getSingleUseObjectExpressionBinding( + path, + item.argument, + ) + if ( + init && + stripObjectExpressionProperty(path, init, 'fallback') + ) { + state.modified = true + } + } + + return true + }) + } + + const split = getBooleanProp(path.node.openingElement, 'split') + if (split === false) return + + const boundaryInspection = inspectSplitBoundary({ + code: options.code, + path, + validate: true, + collectCaptured: options.env === 'client', + ...(options.env === 'client' + ? { + nestedHydrate: { + localName, + }, + } + : {}), + }) + + const index = nextBoundaryIndex + nextBoundaryIndex += 1 + boundaryInspection.nestedBoundaryCount + const id = getBoundaryId(index) + const exportName = `H${index}` + + const existingHydrateId = getJSXAttribute( + path.node.openingElement, + 'h', + ) + if (existingHydrateId) { + existingHydrateId.value = t.stringLiteral(id) + } else { + path.node.openingElement.attributes.push( + t.jsxAttribute(t.jsxIdentifier('h'), t.stringLiteral(id)), + ) + } + state.modified = true + + if (options.env === 'server') return + + const needsPreloadProp = path.node.openingElement.attributes.some( + (attribute) => { + if (t.isJSXAttribute(attribute)) { + return t.isJSXIdentifier(attribute.name, { name: 'prefetch' }) + } + + if (t.isJSXSpreadAttribute(attribute)) { + if (t.isObjectExpression(attribute.argument)) { + return objectExpressionMayHaveProperty( + attribute.argument, + 'prefetch', + ) + } + + if (t.isIdentifier(attribute.argument)) { + const init = getSingleUseObjectExpressionBinding( + path, + attribute.argument, + ) + return init + ? objectExpressionMayHaveProperty(init, 'prefetch') + : true + } + + return true + } + + return false + }, + ) + const childReferenceNodes = getMeaningfulChildren(path.node.children) + + state.extractedChildNodes.push(...childReferenceNodes) + boundaryInspection.captured.forEach((name) => { + state.capturedNames.add(name) + }) + + if (!lazyIdent) { + lazyIdent = + programPath.scope.generateUidIdentifier('lazyRouteComponent') + programPath.unshiftContainer('body', [ + t.importDeclaration( + [ + t.importSpecifier( + lazyIdent, + t.identifier('lazyRouteComponent'), + ), + ], + t.stringLiteral(`@tanstack/${options.framework}-router`), + ), + ]) + } + + const importIdParams = new URLSearchParams() + importIdParams.set(tssHydrate, id) + const componentIdent = + programPath.scope.generateUidIdentifier(exportName) + const declarations = [ + t.variableDeclarator( + componentIdent, + t.callExpression(lazyIdent, [ + t.arrowFunctionExpression( + [], + t.callExpression(t.import(), [ + t.stringLiteral(`${sourceId}?${importIdParams.toString()}`), + ]), + ), + t.stringLiteral(exportName), + ]), + ), + ] + + let preloadIdent: t.Identifier | undefined + if (needsPreloadProp) { + preloadIdent = programPath.scope.generateUidIdentifier( + `${exportName}_preload`, + ) + declarations.push( + t.variableDeclarator( + preloadIdent, + t.memberExpression(componentIdent, t.identifier('preload')), + ), + ) + } + + programPath.unshiftContainer('body', [ + t.variableDeclaration('const', declarations), + ]) + if (preloadIdent) { + path.node.openingElement.attributes.push( + t.jsxAttribute( + t.jsxIdentifier('p'), + t.jsxExpressionContainer(preloadIdent), + ), + ) + } + + path.node.children = [ + t.jsxText('\n'), + t.jsxExpressionContainer( + t.jsxElement( + t.jsxOpeningElement( + t.jsxIdentifier(componentIdent.name), + boundaryInspection.captured.map((name) => + t.jsxAttribute( + t.jsxIdentifier(name), + t.jsxExpressionContainer(t.identifier(name)), + ), + ), + true, + ), + null, + [], + true, + ), + ), + t.jsxText('\n'), + ] + path.skip() + }, + }) + + if (state.extractedChildNodes.length > 0) { + stripBindingsOnlyReferencedByNodes( + programPath.scope, + state.extractedChildNodes, + new Set<string>(), + state.capturedNames, + ) + } + + programPath.skip() + }, + }) + + if (!state.modified) return null + + return true +} + +function loadHydrateVirtualModule(options: { + id: string + root: string + code: string + framework: CompileStartFrameworkOptions +}) { + const { sourceId, splitId, boundaryIndex } = parseHydrateVirtualId(options.id) + if (!splitId || boundaryIndex < 0) return null + const getBoundaryId = createBoundaryId(options.root, sourceId) + + const ast = parseAst({ code: options.code, sourceFilename: sourceId }) + const hydrateImport = getHydrateImport(ast, options.framework) + if (!hydrateImport) return null + const { hydrateLocalName: localName } = hydrateImport + + let target: t.JSXElement | undefined + let targetIndex = -1 + let targetCaptured: Array<string> = [] + let index = 0 + + babel.traverse(ast, { + JSXElement(path) { + if (getJSXElementName(path.node) !== localName) return + const split = getBooleanProp(path.node.openingElement, 'split') + if (split === false) return + + if (index === boundaryIndex) { + const id = getBoundaryId(index) + if (id !== splitId) { + path.stop() + return + } + targetCaptured = inspectSplitBoundary({ + code: options.code, + path, + collectCaptured: true, + }).captured + target = t.cloneNode(path.node, true) + targetIndex = index + path.stop() + return + } + index++ + }, + }) + + if (!target || targetIndex < 0) return null + + const children = target.children + const exportName = `H${targetIndex}` + const refIdents = findReferencedIdentifiers(ast) + + removeModuleLevelBindings(ast, new Set(['Route'])) + const localBindings = new Set<string>() + for (const node of ast.program.body) { + collectLocalBindingsFromStatement(node, localBindings) + } + + const keepBindings = new Set<string>() + const meaningfulChildren = getMeaningfulChildren(children) + let returnExpression: t.Expression | t.JSXElement | t.JSXFragment = + t.nullLiteral() + + if (meaningfulChildren.length === 1) { + const child = meaningfulChildren[0]! + if (t.isJSXExpressionContainer(child)) { + returnExpression = t.isJSXEmptyExpression(child.expression) + ? t.nullLiteral() + : child.expression + } else if (t.isJSXElement(child) || t.isJSXFragment(child)) { + returnExpression = child + } else if (t.isJSXText(child)) { + returnExpression = t.stringLiteral(child.value) + } + } else if (meaningfulChildren.length > 1) { + returnExpression = t.jsxFragment( + t.jsxOpeningFragment(), + t.jsxClosingFragment(), + children, + ) + } + for (const name of collectIdentifiersFromNode(returnExpression)) { + if (localBindings.has(name)) { + keepBindings.add(name) + } + } + + if (keepBindings.size > 0) { + expandTransitively( + keepBindings, + buildDependencyGraph(buildDeclarationMap(ast), localBindings), + ) + } + + retainModuleLevelDeclarations(ast, keepBindings) + unwrapExportedDeclarations(ast) + + ast.program.body.push( + t.exportNamedDeclaration( + t.functionDeclaration( + t.identifier(exportName), + targetCaptured.length > 0 + ? [ + t.objectPattern( + targetCaptured.map((name) => + t.objectProperty( + t.identifier(name), + t.identifier(name), + false, + true, + ), + ), + ), + ] + : [], + t.blockStatement([t.returnStatement(returnExpression)]), + ), + ), + ) + + deadCodeElimination(ast, refIdents) + stripUnreferencedTopLevelExpressionStatements(ast) + + const result = generateFromAst(ast, { + sourceMaps: true, + sourceFileName: options.id, + filename: options.id, + }) + return result +} + +export function createHydrateCompilerPlugin(): StartCompilerPlugin { + type SourceEntry = { + code: string + framework: CompileStartFrameworkOptions + virtualModules: Map<string, StartCompilerTransformResult | null> + } + + const sourcesByEnvironment = new Map<string, Map<string, SourceEntry>>() + + const getEnvironmentSources = (envName: string) => { + let sources = sourcesByEnvironment.get(envName) + if (!sources) { + sources = new Map() + sourcesByEnvironment.set(envName, sources) + } + return sources + } + + const setSource = ( + envName: string, + id: string, + code: string, + framework: CompileStartFrameworkOptions, + ) => { + const sourceId = cleanId(id) + const sources = getEnvironmentSources(envName) + const existing = sources.get(sourceId) + if (existing?.code === code && existing.framework === framework) { + return existing + } + + const entry = { + code, + framework, + virtualModules: new Map<string, StartCompilerTransformResult | null>(), + } + sources.set(sourceId, entry) + return entry + } + + const getSourceEntry = (envName: string, id: string) => + sourcesByEnvironment.get(envName)?.get(cleanId(id)) + + const deleteSource = (envName: string, id: string) => { + sourcesByEnvironment.get(envName)?.delete(cleanId(id)) + } + + return { + name: 'tanstack-start-core:hydrate', + detect: HYDRATE_DETECTION_PATTERN, + virtualModuleIdPattern: new RegExp(`[?&]${tssHydrate}=`), + transformAst(context) { + const virtualModule = parseHydrateVirtualId(context.id) + const indexOffset = + virtualModule.boundaryIndex < 0 + ? undefined + : virtualModule.boundaryIndex + 1 + const result = transformHydrateAst({ + ast: context.ast, + code: context.code, + id: context.id, + root: context.root, + env: context.env, + framework: context.framework, + indexOffset, + }) + + if (result && virtualModule.boundaryIndex < 0) { + setSource(context.envName, context.id, context.code, context.framework) + } + + return !!result + }, + loadVirtualModule(context) { + const virtualModule = parseHydrateVirtualId(context.id) + if (!virtualModule.splitId || virtualModule.boundaryIndex < 0) { + return null + } + + const existingSourceEntry = getSourceEntry( + context.envName, + virtualModule.sourceId, + ) + const sourceEntry = + context.code === undefined + ? existingSourceEntry + : setSource( + context.envName, + virtualModule.sourceId, + context.code, + existingSourceEntry?.framework ?? + (context.code.includes('@tanstack/solid-start') + ? 'solid' + : 'react'), + ) + + if (!sourceEntry) { + throw new MissingHydrateSourceError(context.id) + } + + if (sourceEntry.virtualModules.has(context.id)) { + return sourceEntry.virtualModules.get(context.id)! + } + + const result = loadHydrateVirtualModule({ + code: sourceEntry.code, + id: context.id, + root: context.root, + framework: sourceEntry.framework, + }) + sourceEntry.virtualModules.set(context.id, result) + return result + }, + invalidateModule(context) { + deleteSource(context.envName, context.id) + }, + } +} diff --git a/packages/start-plugin-core/src/hydration-constants.ts b/packages/start-plugin-core/src/hydration-constants.ts new file mode 100644 index 0000000000..b79c20ffd3 --- /dev/null +++ b/packages/start-plugin-core/src/hydration-constants.ts @@ -0,0 +1 @@ +export const tssHydrate = 'tss-hydrate' diff --git a/packages/start-plugin-core/src/import-protection-plugin/INTERNALS.md b/packages/start-plugin-core/src/import-protection-plugin/INTERNALS.md deleted file mode 100644 index 0143b11161..0000000000 --- a/packages/start-plugin-core/src/import-protection-plugin/INTERNALS.md +++ /dev/null @@ -1,700 +0,0 @@ -# Import Protection Plugin — Internal Technical Documentation - -## Overview - -The import protection plugin prevents server-only code from leaking into client -bundles (and vice versa). It operates as a Vite plugin that intercepts module -resolution, detects violations, and either errors or replaces the offending -module with a safe mock. - -The plugin must handle **two axes of configuration**: - -| | **Dev** (`vite dev`) | **Build** (`vite build`) | -| --------- | -------------------------------------------------------------------- | -------------------------------------------------------------- | -| **Error** | `ctx.error()` immediately in `resolveId` | Defer to `generateBundle`; error if mock survived tree-shaking | -| **Mock** | Defer to transform-cache; warn if reachable via post-transform graph | Defer to `generateBundle`; warn if mock survived tree-shaking | - -## Plugin Architecture - -`importProtectionPlugin()` returns **two** Vite plugins: - -### 1. `tanstack-start-core:import-protection` (enforce: `'pre'`) - -The main enforcement plugin. Hooks: `applyToEnvironment`, `configResolved`, -`configureServer`, `buildStart`, `hotUpdate`, `resolveId`, `load`, and -`generateBundle`. All violation detection starts in `resolveId`. - -### 2. `tanstack-start-core:import-protection-transform-cache` - -Runs after all `enforce: 'pre'` hooks (including the Start compiler). Caches -transformed code and composed sourcemaps for accurate source-location mapping -in violation messages. Also resolves post-transform imports and triggers -`processPendingViolations()` for the dev mock deferral path. - -In both build and dev modes, this plugin performs **self-denial**: when a file -matches a deny pattern in the current environment (e.g. a `.server.ts` file -transformed in the client environment), its entire content is replaced with a -mock module. This is the core mechanism for preventing cross-environment cache -contamination — `resolveId` never returns virtual module IDs for file-based -violations, so there is nothing for third-party resolver caches -(e.g. `vite-tsconfig-paths`) to leak across environments. In dev mode, the -mock imports a `mock-runtime` module for runtime diagnostics; in build mode, -the mock is fully self-contained. - -See the [Self-Denial Transform](#self-denial-transform-in-detail) section below -for a detailed walkthrough with code examples. - -## Violation Types - -| Type | Trigger | Example | -| ----------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------- | -| `file` | Resolved path matches a deny glob (e.g. `**/*.server.*`) | `import './db.server'` in client env | -| `specifier` | Import specifier matches a deny pattern | `import '@tanstack/react-start/server'` in client env | -| `marker` | File imports `'server-only'` or `'client-only'` marker, then is loaded in the wrong env | File with `import 'server-only'` resolved in client env | - -## The False-Positive Problem - -### Barrel re-exports - -A common pattern: - -```text -db/index.ts → export { getUsers } from './db.server' - export { userColumns } from './shared' - -route.tsx → import { getUsers, userColumns } from '../db' - // getUsers used only in createServerFn().handler() - // userColumns used in JSX -``` - -At `resolveId` time, `db/index.ts` imports `./db.server` — the plugin sees a -`.server` file imported in the client environment. But the Start compiler strips -the `getUsers` usage from the client bundle (it's inside a server fn handler), -and Rollup's tree-shaking then eliminates the `./db.server` dependency entirely. - -**No server code actually leaks.** But without deferral, the plugin fires at -`resolveId` time — before tree-shaking — producing a false positive. - -### Pre-transform resolves (server-fn-lookup) - -During dev, Vite's `fetchModule(?SERVER_FN_LOOKUP)` call triggers resolves for -analysing a module's exports. These are tracked via `serverFnLookupModules` and -`isPreTransformResolve`. In dev mock mode, pre-transform violations are -deferred like all other violations (verified via edge-survival and graph -reachability). In dev error mode, they are silenced because no deferred -verification path exists. - -## Violation Handling Flow - -### Central functions - -- **`handleViolation()`**: Formats + reports (or silences) the violation. Returns - a resolve result so `resolveId` can substitute the offending import: for - file-based violations, returns the physical file path (self-denial handles - the rest in transform); for specifier/marker violations, returns a mock-edge - module ID. May also return `undefined` (suppressed by `onViolation` or - silent+error in dev) or throw via `ctx.error()` (dev+error). -- **`reportOrDeferViolation()`**: Dispatch layer. Either defers (stores for later - verification) or reports immediately, depending on `shouldDefer`. - -### `shouldDefer` logic - -```ts -shouldDefer = isBuild || isDevMock -``` - -- **Dev mock**: ALL violations (including pre-transform resolves) are deferred - to `pendingViolations` → verified via edge-survival and post-transform graph - reachability in `processPendingViolations()`. Pre-transform violations are - tagged with `fromPreTransformResolve` so the pending-violation processor - knows to wait for post-transform data before emitting. -- **Build (both mock and error)**: Defer to `deferredBuildViolations` → verify - via tree-shaking survival in `generateBundle`. - -All three violation types (file, specifier, AND marker) are deferred in build -mode. Marker violations through barrels can also be false positives — e.g., if -`foo.ts` has `import 'server-only'` and is re-exported through a barrel but -never used in client code, tree-shaking eliminates `foo.ts` entirely. To enable -`generateBundle` tracking for markers, `resolveId` returns the unique build -mock ID instead of the marker module. This is transparent because marker imports -are bare (`import 'server-only'` — no bindings), and the mock module is equally -side-effect-free. - -## Dev Mode Strategy - -### Dev + Error - -Violations fire immediately via `ctx.error()` in `resolveId`. No tree-shaking -is available, so false positives for barrel patterns are expected and accepted. -(Dev + error is typically used only during explicit validation.) - -Pre-transform resolves (e.g. server-fn-lookup) are silenced in error mode -because they fire before the Start compiler runs — imports inside `.server()` -callbacks haven't been stripped yet, and error mode has no deferred verification -path. - -### Dev + Mock - -1. `resolveId` detects the violation and calls `reportOrDeferViolation()`. -2. For **file-based violations**: `handleViolation()` returns the **physical - file path** (same as build mode). The self-denial transform in the - transform-cache plugin will replace the file's content with a dev mock - module that imports `mock-runtime` for runtime diagnostics. -3. For **specifier/marker violations**: `handleViolation()` returns a mock-edge - module ID so the dev server can serve a Proxy-based mock. -4. The violation is stored in `pendingViolations` keyed by the importer's file - path. -5. The transform-cache plugin, after resolving post-transform imports, calls - `processPendingViolations()`. -6. `processPendingViolations()` first applies **edge-survival**: if - post-transform import data is available for the importer, it checks whether - the denied import survived the Start compiler transform. Imports stripped - by the compiler (e.g. inside `.server()` callbacks) are discarded. For - pre-transform violations (`fromPreTransformResolve`), the function waits - until post-transform data is available before proceeding. -7. After edge-survival, `processPendingViolations()` checks graph reachability - from entry points using only post-transform edges. If the violating - importer is reachable → confirm (warn). If unreachable → discard. If - unknown → keep pending or emit conservatively (warm-start fallback). - -Warm-start stability guardrails: - -- Resolve-time edges discovered through pre-transform paths - (`isPreTransformResolve`, especially `SERVER_FN_LOOKUP`) are **not** recorded - into the reachability graph. -- In `'unknown'` reachability status, pre-transform pending violations are - kept pending (not fallback-emitted) until non-lookup transform evidence is - available. - -This approach can't fully eliminate barrel false-positives in dev because -there's no tree-shaking. The barrel's import of `.server` always resolves, -and the barrel is reachable. This is a known and accepted limitation. - -### Dev mock modules - -Dev violations are handled differently depending on their type: - -- **File-based violations** use **self-denial** (same mechanism as build mode): - the denied file's content is replaced by the transform-cache plugin with a - mock that imports `mock-runtime` for runtime diagnostics. The export list - comes from the **denied file's AST** (what it exports), generated by - `generateDevSelfDenialModule()`. This approach avoids the cold-start problem - where the importer's AST is unavailable at `resolveId` time, and prevents - cross-environment cache contamination from third-party resolver plugins. - -- **Specifier/marker violations** use **mock-edge modules**: each violation - gets a per-importer mock edge module that explicitly exports the names the - importer expects (extracted lazily by `resolveExportsForDeniedSpecifier()` - which parses the importer's AST) and delegates to a **runtime mock module** - that contains a recursive Proxy and optional runtime diagnostics. - -### Mock edge modules (in detail) - -A **mock edge module** is a lightweight, auto-generated virtual module that sits -between an importing file and a base mock module. Its purpose is to provide -**explicit ESM named exports** so that bundlers (Rollup, Rolldown) and Vite's dev -server can correctly resolve `import { foo } from './denied.server'` — even -though the real module has been replaced by a mock. - -#### Why they exist - -The base mock module (`\0tanstack-start-import-protection:mock`) exports only a -`default` export — a recursive Proxy. But consumers of the denied module may use -named imports: - -```typescript -import { getSecret, initDb } from './credentials.server' -``` - -Without explicit named exports, this would fail: the bundler would complain that -`getSecret` and `initDb` don't exist on the mock module. Using -`syntheticNamedExports: true` in Rollup could solve this, but Rolldown (which -Vite can now use) doesn't support it. Mock edge modules solve the problem -portably by generating real ESM export statements. - -#### Structure - -Each mock edge module is identified by a virtual ID: - -```text -\0tanstack-start-import-protection:mock-edge:<BASE64_PAYLOAD> -``` - -The Base64URL payload encodes two fields: - -- `exports` — the list of named export identifiers the importer needs -- `runtimeId` — the module ID of the backing mock to import from - -When Vite's `load` hook encounters this virtual ID, `loadMockEdgeModule()` -decodes the payload and generates code like this: - -```typescript -// Generated mock edge module for exports: ["getSecret", "initDb"] -import mock from '\0tanstack-start-import-protection:mock' -export const getSecret = mock.getSecret -export const initDb = mock.initDb -export default mock -``` - -Each `mock.getSecret` access returns the Proxy itself (the Proxy's `get` trap -returns `mock` for any property), so the named exports are valid callable/ -constructable values that won't crash at runtime. - -#### How exports are determined - -The export list comes from **parsing the importer's AST** — not the denied -file's AST. The function `resolveExportsForDeniedSpecifier()` performs this: - -1. Gets the importer's code from the transform cache or `getModuleInfo`. -2. Calls `collectMockExportNamesBySource()` to extract which names the - importer uses from each import source (parses the AST internally): - - **Named imports**: `import { getSecret, initDb } from './creds.server'` - → `['getSecret', 'initDb']` - - **Namespace member access**: `import * as creds from './creds.server'` then - `creds.getSecret()` → `['getSecret']` - - **Default import member access**: `import creds from './creds.server'` then - `creds.getSecret` → `['getSecret']` - - **Re-exports**: `export { getSecret } from './creds.server'` - → `['getSecret']` -3. Caches the result per importer so multiple violations from the same file - don't re-parse. - -This "importer-driven" approach means the mock edge module only exports the -names the consumer actually references — not all exports from the denied file. - -#### Dev vs build mock edge modules - -| Aspect | Dev mock edge | Build mock edge | -| ---------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------- | -| **Backing mock** | `mock-runtime:BASE64` (runtime diagnostics) or `mock` (silent) | `mock:build:N` (per-violation unique, silent) | -| **Purpose** | Serve mocks in dev server + runtime warnings | Track tree-shaking survival in `generateBundle` | -| **Created for** | Specifier/marker violations only (file uses self-denial instead) | Specifier/marker violations only (file uses self-denial instead) | -| **Uniqueness** | Per-importer per-specifier | Per-violation (unique counter) | - -In **dev**, the backing `runtimeId` is a `mock-runtime:BASE64` module that -includes diagnostic metadata (environment, import path, trace). When the mock -is accessed in the browser, it logs a console warning or error. For SSR or -when `mockAccess` is `'off'`, the backing mock is the shared silent -`MOCK_MODULE_ID`. - -In **build**, the backing mock uses a unique counter ID -(`mock:build:0`, `mock:build:1`, ...) so `generateBundle` can check whether -each specific violation's mock survived tree-shaking. - -#### Handling non-identifier export names - -ES2022 allows string-keyed exports like `export { x as "foo-bar" }`. Mock edge -modules handle these via an intermediate variable: - -```typescript -import mock from '\0tanstack-start-import-protection:mock' -export const validName = mock.validName -const __tss_str_0 = mock['foo-bar'] -export { __tss_str_0 as 'foo-bar' } -``` - -The `default` export name is always filtered out (handled separately as -`export default mock`). - -### File-based violations: self-denial (dev and build) - -File-based violations (e.g. `import './db.server'` in client env) use -self-denial in **both** dev and build modes. `handleViolation()` returns the -physical file path, and the transform-cache plugin replaces the file's -contents with a mock module. - -- **Build mode**: Uses `generateSelfContainedMockModule()` — a fully - self-contained mock with an inlined Proxy factory (no `import` statements). - This is important because build-mode mocks must be tree-shakeable. - -- **Dev mode**: Uses `generateDevSelfDenialModule()` — a mock that imports - `mock-runtime` for runtime diagnostics (console warnings/errors when the - mock is accessed in the browser). The `mock-runtime` module ID encodes - violation metadata (environment, import path, trace). - -Self-denial avoids creating virtual mock-edge module IDs that could -contaminate third-party resolver caches across Vite environments. - -### Non-file violations: mock-edge modules (dev and build) - -Specifier and marker violations use **mock-edge modules** because the denied -specifier doesn't resolve to a physical file that could be "self-denied." - -- **Build mode**: Each violation gets a **per-violation mock edge module** - wrapping a unique base mock module - (`\0tanstack-start-import-protection:mock:build:N`). The edge module - re-exports the named exports the importer expects, ensuring compatibility - with both Rollup and Rolldown (which doesn't support - `syntheticNamedExports`). - -- **Dev mode**: Each violation gets a **per-importer mock edge module** - wrapping a `mock-runtime` module for runtime diagnostics. - -## Build Mode Strategy - -### The "mock first, verify later" pattern - -Both mock and error build modes follow the same pattern: - -1. **`resolveId`**: Call `handleViolation({ silent: true })`. - - For **file-based violations**: Returns the physical file path. The - self-denial transform will replace its content. - - For **specifier/marker violations**: Generates a **unique per-violation - mock-edge module** wrapping a base mock module - (`\0tanstack-start-import-protection:mock:build:N`). Stores the violation + - mock-edge ID in `env.deferredBuildViolations`. Returns the mock-edge ID. - -2. **`transform`** (self-denial): For file-based violations, the transform-cache - plugin detects that the current file is denied in this environment and - replaces its content with a self-contained mock module - (`generateSelfContainedMockModule()`). - -3. **`load`**: For base mock modules, returns a silent Proxy-based mock. For - mock-edge modules, returns code that imports from the base mock and - re-exports the expected named bindings (e.g. `export const Foo = mock.Foo`). - -4. **Tree-shaking**: The bundler processes the bundle normally. If no binding from - the mock module is actually used at runtime, the modules are eliminated. - -5. **`generateBundle`**: Inspect the output chunks. For each deferred violation, - check whether its unique mock module ID appears in any chunk's `modules`. - - **Survived** → real violation (the import wasn't tree-shaken away). - - Error mode: `ctx.error()` — fail the build. - - Mock mode: `ctx.warn()` — emit a warning. - - **Eliminated** → false positive (tree-shaking removed it). Suppress - silently. - -### Why unique mock IDs per violation? - -The original `RESOLVED_MOCK_MODULE_ID` is a single shared virtual module used -for all mock-mode violations. If multiple violations are deferred, we need to -know _which specific ones_ survived tree-shaking. A shared ID would tell us -"something survived" but not which violation it corresponds to. Each violation -gets a unique mock-edge module (wrapping a unique base mock -`...mock:build:0`, `...mock:build:1`, etc.) to provide this granularity. - -### Why mocking doesn't affect tree-shaking - -From the consumer's perspective, the import bindings are identical whether they -point to the real module or the mock. The bundler tree-shakes based on binding -usage, not module content. If a binding from the barrel's re-export of `.server` -is unused after the Start compiler strips server fn handlers, tree-shaking -eliminates it regardless of whether it points to real DB code or a Proxy mock. - -### Per-environment operation - -`generateBundle` runs once per Vite environment (client, SSR, etc.). Each -environment has its own `EnvState` with its own `deferredBuildViolations` array. -The check only inspects chunks from THAT environment's bundle, ensuring correct -per-environment verification. - -## Marker violations vs. file/specifier violations - -| | Marker | Specifier | File | -| ----------------------------- | --------------------------------------------------- | -------------------------------------------- | --------------------------------------------- | -| **What triggers it** | The _importer_ has a conflicting directive | The _import specifier_ matches a deny rule | The _resolved path_ matches a deny glob | -| **resolveId returns (dev)** | Marker module ID (`RESOLVED_MARKER_*`) \* | Mock edge module ID (per-importer) | Physical file path (self-denial in transform) | -| **resolveId returns (build)** | Unique build mock ID | Unique build mock ID | Physical file path (self-denial in transform) | -| **Can be tree-shaken away?** | Yes — if the importer is eliminated by tree-shaking | Yes — if no binding from the target survives | Yes — if no binding from the target survives | -| **Deferred in build?** | Yes — deferred to `generateBundle` | Yes — deferred to `generateBundle` | Yes — deferred to `generateBundle` | -| **Deferred in dev mock?** | Yes — deferred to pending graph | Yes — deferred to pending graph | Yes — deferred to pending graph | - -\* In dev mock, `handleViolation` internally returns the physical file path -(stored as the deferred result in `pendingViolations`), but `resolveId` ignores -it for markers and falls through to return the marker module ID. The file path -is only used for deferral bookkeeping, not for module resolution. - -## State Management - -### `EnvState` (per Vite environment) - -Key fields for violation handling: - -- `seenViolations: Set<string>` — deduplication of logged violations. -- `pendingViolations: Map<string, Array<PendingViolation>>` — dev mock - deferral. Keyed by importer file path. -- `deferredBuildViolations: Array<DeferredBuildViolation>` — build mode - deferral. Each entry has `{ info, mockModuleId }`. - -Per-build/watch iteration, `buildStart` clears `pendingViolations` and resets -`deferredBuildViolations` so deferred entries don't leak across rebuilds. - -- `graph: ImportGraph` — import dependency graph for reachability checks. -- `serverFnLookupModules: Set<string>` — modules transitively loaded during - server-fn analysis (false-positive suppression). - -### `SharedState` (cross-environment) - -- `fileMarkerKind: Map<string, 'server' | 'client'>` — cached per-file marker - detection. A file's directive is inherent to the file, not the environment. - -## Virtual Module IDs - -| ID Pattern | Usage | -| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | -| `\0tanstack-start-import-protection:mock` | Shared silent mock (dev mock only) | -| `\0tanstack-start-import-protection:mock:build:N` | Per-violation build mock (unique counter) | -| `\0tanstack-start-import-protection:mock-edge:BASE64` | Per-importer mock with explicit named exports (specifier/marker violations, dev + build) | -| `\0tanstack-start-import-protection:mock-runtime:BASE64` | Runtime diagnostic mock (dev client, console warnings) | -| `\0tanstack-start-import-protection:marker:*` | Marker module (empty `export {}`). Suffixed `server-only` or `client-only`; derived from `MARKER_PREFIX` in `virtualModules.ts` | - -## Key Design Decisions - -### Why not just skip `.server` resolves in barrels? - -The plugin doesn't know at `resolveId` time whether the barrel's re-export will -survive tree-shaking. It can't inspect the consumer's usage — it only sees the -barrel importing `.server`. Skipping it would miss real violations where the -barrel's `.server` re-export IS used in client code. - -### How marker violations are deferred in build - -Marker violations normally resolve to `RESOLVED_MARKER_*` (empty `export {}`), -not a mock. To enable `generateBundle` tracking, in build mode `resolveId` -returns the unique build mock ID instead of the marker module. This works -because: - -1. The marker import is bare (`import 'server-only'` — no bindings), so - swapping the resolution to a mock module is transparent. -2. The mock module is side-effect-free, just like the marker module. -3. If the importer file survives tree-shaking, the mock module survives → - `generateBundle` fires the violation. If the importer is tree-shaken away - (e.g., barrel re-export of a marker-protected file that's never used), the - mock is eliminated → violation suppressed. - -### Why accept false positives in dev? - -Dev mode uses Vite's ESM dev server — no bundling, no tree-shaking. The barrel -file's import of `.server` always resolves and is always reachable from entry -points. The graph-reachability check in `processPendingViolations` can only -eliminate violations where the _importer_ becomes unreachable after the Start -compiler transforms it, not where individual bindings are unused. - -This is an accepted trade-off: dev mock mode warns about potential issues, -build mode provides definitive answers via tree-shaking. - -## E2E Test Structure - -Tests live in `e2e/react-start/import-protection/` and -`e2e/react-start/import-protection-custom-config/`: - -### Main test suite (`import-protection/`) - -- **Mock mode** (default): `globalSetup` builds the app, captures build warnings - to `violations.build.json`, starts a dev server capturing to - `violations.dev.json`. Tests read these JSON files and assert. -- **Error mode** (`BEHAVIOR=error`): `globalSetup` runs the build expecting - failure, captures exit code + output. Tests assert the build failed with the - expected violation. -- **False-positive test**: The `barrel-reexport` test case verifies that a barrel - re-exporting from both a `.server` file and a marker-protected file (`foo.ts` - with `import 'server-only'`), where all server-only bindings are tree-shaken - away, produces **zero** violations in the build log. - -### Custom-config test suite (`import-protection-custom-config/`) - -Uses non-default deny patterns (`**/*.backend.*` / `**/*.frontend.*`) to verify -that import protection works with user-configured file patterns. This ensures -the plugin doesn't hardcode any assumption about `.server`/`.client` naming -conventions. The `vite.config.ts` provides custom `client.files` and -`server.files` arrays; no `vite-tsconfig-paths` is used. - -## Self-Denial Transform (In Detail) - -The self-denial transform is the mechanism by which the plugin prevents cross- -environment contamination without creating virtual module IDs that could leak -through third-party resolver caches. It applies to **file-based violations in -both dev and build modes**. - -### The problem it solves - -In Vite 7+, client and SSR environments run within the same Vite process. Some -plugins (e.g. `vite-tsconfig-paths`) maintain a global resolution cache shared -across environments. If the import-protection plugin resolves a specifier to a -virtual mock module ID (e.g. -`\0tanstack-start-import-protection:mock-edge:...`) in the client environment, -that virtual ID can leak into the SSR environment's cache. When the SSR -environment later resolves the same specifier, it finds the cached virtual ID -instead of the real file — breaking the server. - -In dev mode, self-denial also solves a **cold-start problem**: on cold start -(no `.vite` cache), the importer's AST is unavailable when `resolveId` runs -(neither the transform cache nor `getModuleInfo` have content yet). If mock-edge -module IDs were generated at `resolveId` time, the export list would be empty -(since it's derived from parsing the importer), producing a mock with no named -exports — causing runtime errors like -`does not provide an export named: 'getSecret'`. - -### How it works - -Instead of returning a virtual module ID from `resolveId`, the self-denial -transform works at the **transform** stage: - -1. **`resolveId`**: For file-based violations, `handleViolation()` returns the - **physical file path**. The import resolves normally. No virtual ID is - created. - -2. **transform-cache plugin**: When the transform-cache hook processes a file, - it checks whether the file matches any deny pattern for the current - environment using `checkFileDenial()`. If the file is denied, the plugin: - - a. Extracts the file's named exports using `collectNamedExports()` (parses - the AST internally). - b. **Build mode**: Generates a self-contained mock module via - `generateSelfContainedMockModule()` — no imports, inlined Proxy factory. - c. **Dev mode**: Generates a dev mock module via - `generateDevSelfDenialModule()` — imports `mock-runtime` for runtime - diagnostics (console warnings/errors when the mock is accessed). - d. Returns the mock code as the transform result, completely replacing the - original file content. - -3. **Fallback**: If AST parsing fails (e.g. due to syntax errors in the denied - file), `exportNames` defaults to `[]` (empty) and the mock module has no - named exports: - - Build: `generateSelfContainedMockModule([])`. - - Dev: `generateDevSelfDenialModule([], runtimeId)` where `runtimeId` is - computed via `mockRuntimeModuleIdFromViolation()` (which may internally - fall back to the shared silent `MOCK_MODULE_ID` for SSR or when - `mockAccess` is `'off'`). - -### Code transformation example - -**Original file** (`src/lib/credentials.server.ts`): - -```typescript -import { db } from './database' - -export function getSecret(): string { - return db.query('SELECT secret FROM config LIMIT 1') -} - -export const API_KEY = process.env.API_KEY! - -export default { getSecret, API_KEY } -``` - -**After self-denial transform in build mode** (client environment): - -```typescript -/* @__NO_SIDE_EFFECTS__ */ -function createMock() { - const handler = { - get: (_, prop) => { - if (prop === Symbol.toPrimitive) return () => 'MOCK' - if (typeof prop === 'symbol') return undefined - return mock - }, - apply: () => mock, - construct: () => mock, - } - const mock = /* @__PURE__ */ new Proxy(function () {}, handler) - return mock -} -const mock = /* @__PURE__ */ createMock() -export const getSecret = mock.getSecret -export const API_KEY = mock.API_KEY -export default mock -``` - -**After self-denial transform in dev mode** (client environment): - -```typescript -import mock from '\0tanstack-start-import-protection:mock-runtime:eyJ...' -export const getSecret = mock.getSecret -export const API_KEY = mock.API_KEY -export default mock -``` - -The `mock-runtime` module ID encodes violation metadata (environment, importer, -specifier, trace) as a Base64URL payload. When the mock is accessed in the -browser, it logs a console warning or error with this metadata. - -### Key properties - -**Build-mode mock** (`generateSelfContainedMockModule`): - -- **Self-contained**: No `import` statements — the Proxy factory is inlined. -- **Tree-shakeable**: All exports are marked pure (`@__NO_SIDE_EFFECTS__`, - `@__PURE__`), so the bundler can eliminate unused exports. - -**Dev-mode mock** (`generateDevSelfDenialModule`): - -- **Runtime diagnostics**: Imports `mock-runtime` which provides console - warnings/errors when the mock is accessed in the browser. -- **Lightweight**: No inlined Proxy factory — delegates to the mock-runtime - virtual module. - -**Both modes**: - -- **Same export interface**: Named exports match the original file's exports, - so consumers' import bindings remain valid. -- **Safe at runtime**: Every access returns the same Proxy, which is callable, - constructable, and returns "MOCK" when coerced to a string. -- **Export accuracy from denied file**: Unlike mock-edge modules (which parse - the importer's AST), self-denial parses the **denied file's own AST**. - This provides a safe over-approximation — all exports the file offers — and - avoids the cold-start problem where the importer hasn't been transformed yet. - -### Why self-denial instead of virtual modules for file-based violations - -| Approach | Virtual mock ID | Self-denial | -| ------------------ | -------------------------------------------------------------- | -------------------------------------------------------------- | -| `resolveId` return | `\0mock-edge:BASE64` (virtual) | Physical file path (resolves normally) | -| Cache risk | Virtual ID stored in shared resolver cache → leaks to SSR | Physical path cached → correct in both environments | -| Module identity | New virtual module per violation | Same physical file, different content per environment | -| Export accuracy | From importer's AST (what it imports) | From denied file's AST (what it exports) | -| Cold-start safety | Fails — importer AST unavailable on cold start → empty exports | Safe — denied file's source code always available in transform | - -### When self-denial is NOT used - -Self-denial only applies to **file-based** violations. - -- **Specifier violations** (e.g. `import '@tanstack/react-start/server'`): - These are bare specifiers, not file paths. They use virtual mock-edge module - IDs because the specifier doesn't resolve to a physical file that could be - "self-denied." -- **Marker violations**: Use virtual mock IDs in build mode for - `generateBundle` tracking (see marker section above). In dev mode, markers - resolve to the marker module ID directly. - -## Module Dependency Architecture - -The import-protection plugin is structured to avoid heavy transitive -dependencies in its utility modules: - -```text -constants.ts ← lightweight (no heavy imports) -├── IMPORT_PROTECTION_DEBUG -├── KNOWN_SOURCE_EXTENSIONS -├── SERVER_FN_LOOKUP_QUERY ← imports SERVER_FN_LOOKUP from parent constants.ts -└── VITE_BROWSER_VIRTUAL_PREFIX - -defaults.ts ← lightweight (type-only imports) -├── getDefaultImportProtectionRules -└── getMarkerSpecifiers - -matchers.ts ← picomatch only -├── compileMatcher -├── compileMatchers -└── matchesAny - -utils.ts ← vite + node:path + local constants -├── normalizeFilePath, stripViteQuery, ... -└── extractImportSources, dedupePatterns, ... - -trace.ts ← imports from utils only -├── ImportGraph -├── buildTrace -└── formatViolation - -virtualModules.ts ← imports ../utils (parent), ../constants (parent) -├── generateSelfContainedMockModule, generateDevSelfDenialModule -├── loadMockEdgeModule, loadMockRuntimeModule -└── MOCK_MODULE_ID, MOCK_EDGE_PREFIX, ... - -plugin.ts ← main plugin, imports everything above -``` - -The `SERVER_FN_LOOKUP` constant lives in the shared parent `constants.ts` -(not in `start-compiler-plugin/plugin.ts`) to avoid pulling in -`@tanstack/start-server-core` when unit-testing import-protection modules. diff --git a/packages/start-plugin-core/src/import-protection-plugin/ast.ts b/packages/start-plugin-core/src/import-protection-plugin/ast.ts deleted file mode 100644 index 2c8a4b73ed..0000000000 --- a/packages/start-plugin-core/src/import-protection-plugin/ast.ts +++ /dev/null @@ -1,7 +0,0 @@ -import { parseAst } from '@tanstack/router-utils' - -export type ParsedAst = ReturnType<typeof parseAst> - -export function parseImportProtectionAst(code: string): ParsedAst { - return parseAst({ code }) -} diff --git a/packages/start-plugin-core/src/import-protection-plugin/postCompileUsage.ts b/packages/start-plugin-core/src/import-protection-plugin/postCompileUsage.ts deleted file mode 100644 index adc4a98e29..0000000000 --- a/packages/start-plugin-core/src/import-protection-plugin/postCompileUsage.ts +++ /dev/null @@ -1,100 +0,0 @@ -import babel from '@babel/core' -import * as t from '@babel/types' -import { parseImportProtectionAst } from './ast' -import type { ParsedAst } from './ast' - -type UsagePos = { line: number; column0: number } - -/** - * Given transformed code, returns the first "meaningful" usage position for an - * import from `source` that survives compilation. - * - * "Preferred" positions (call, new, member-access) take priority over bare - * identifier references. The returned column is 0-based (Babel loc semantics). - */ -export function findPostCompileUsagePos( - code: string, - source: string, -): UsagePos | undefined { - return findPostCompileUsagePosFromAst(parseImportProtectionAst(code), source) -} - -function findPostCompileUsagePosFromAst( - ast: ParsedAst, - source: string, -): UsagePos | undefined { - // Collect local names bound from this specifier - const imported = new Set<string>() - for (const node of ast.program.body) { - if (t.isImportDeclaration(node) && node.source.value === source) { - if (node.importKind === 'type') continue - for (const s of node.specifiers) { - if (t.isImportSpecifier(s) && s.importKind === 'type') continue - imported.add(s.local.name) - } - } - } - if (imported.size === 0) return undefined - - let preferred: UsagePos | undefined - let anyUsage: UsagePos | undefined - - // babel.traverse can throw on malformed scopes (e.g. duplicate bindings from - // import + const re-declaration) because parseAst doesn't attach a hub - try { - babel.traverse(ast, { - ImportDeclaration(path) { - path.skip() - }, - - Identifier(path: babel.NodePath<t.Identifier>) { - if (preferred && anyUsage) { - path.stop() - return - } - - const { node, parent, scope } = path - if (!imported.has(node.name)) return - - // Skip binding positions (declarations, import specifiers, etc.) - if (path.isBindingIdentifier()) return - - // Skip non-shorthand object property keys — they don't reference the import - if ( - t.isObjectProperty(parent) && - parent.key === node && - !parent.computed && - !parent.shorthand - ) - return - if (t.isObjectMethod(parent) && parent.key === node && !parent.computed) - return - if (t.isExportSpecifier(parent) && parent.exported === node) return - - // Skip if shadowed by a closer binding - const binding = scope.getBinding(node.name) - if (binding && binding.kind !== 'module') return - - const loc = node.loc?.start - if (!loc) return - const pos: UsagePos = { line: loc.line, column0: loc.column } - - const isPreferred = - (t.isCallExpression(parent) && parent.callee === node) || - (t.isNewExpression(parent) && parent.callee === node) || - (t.isMemberExpression(parent) && parent.object === node) - - if (isPreferred) { - preferred ||= pos - } else { - anyUsage ||= pos - } - }, - }) - } catch { - // Scope analysis failed — cannot determine usage positions reliably - return undefined - } - - return preferred ?? anyUsage -} diff --git a/packages/start-plugin-core/src/import-protection-plugin/rewriteDeniedImports.ts b/packages/start-plugin-core/src/import-protection-plugin/rewriteDeniedImports.ts deleted file mode 100644 index c9739396a3..0000000000 --- a/packages/start-plugin-core/src/import-protection-plugin/rewriteDeniedImports.ts +++ /dev/null @@ -1,379 +0,0 @@ -import * as t from '@babel/types' -import { generateFromAst } from '@tanstack/router-utils' - -import { MOCK_MODULE_ID } from './virtualModules' -import { getOrCreate } from './utils' -import { parseImportProtectionAst } from './ast' -import type { SourceMapLike } from './sourceLocation' -import type { ParsedAst } from './ast' - -export function isValidExportName(name: string): boolean { - if (name === 'default' || name.length === 0) return false - const first = name.charCodeAt(0) - // First char: A-Z (65-90), a-z (97-122), _ (95), $ (36) - if ( - !( - (first >= 65 && first <= 90) || - (first >= 97 && first <= 122) || - first === 95 || - first === 36 - ) - ) - return false - for (let i = 1; i < name.length; i++) { - const ch = name.charCodeAt(i) - // Subsequent: A-Z, a-z, 0-9 (48-57), _, $ - if ( - !( - (ch >= 65 && ch <= 90) || - (ch >= 97 && ch <= 122) || - (ch >= 48 && ch <= 57) || - ch === 95 || - ch === 36 - ) - ) - return false - } - return true -} - -export function collectMockExportNamesBySource( - code: string, -): Map<string, Array<string>> { - return collectMockExportNamesBySourceFromAst(parseImportProtectionAst(code)) -} - -function collectMockExportNamesBySourceFromAst( - ast: ParsedAst, -): Map<string, Array<string>> { - const namesBySource = new Map<string, Set<string>>() - const memberBindingToSource = new Map<string, string>() - const add = (source: string, name: string) => { - if (name === 'default' || name.length === 0) return - getOrCreate(namesBySource, source, () => new Set<string>()).add(name) - } - - for (const node of ast.program.body) { - if (t.isImportDeclaration(node)) { - if (node.importKind === 'type') continue - const source = node.source.value - for (const s of node.specifiers) { - if (t.isImportNamespaceSpecifier(s)) { - memberBindingToSource.set(s.local.name, source) - continue - } - if (t.isImportDefaultSpecifier(s)) { - memberBindingToSource.set(s.local.name, source) - continue - } - if (!t.isImportSpecifier(s)) continue - if (s.importKind === 'type') continue - const importedName = t.isIdentifier(s.imported) - ? s.imported.name - : s.imported.value - // `import { default as x } from 'm'` only requires a default export. - if (importedName === 'default') continue - add(source, importedName) - } - } - - if (t.isExportNamedDeclaration(node) && node.source?.value) { - if (node.exportKind === 'type') continue - const source = node.source.value - for (const s of node.specifiers) { - if (!t.isExportSpecifier(s)) continue - if (s.exportKind === 'type') continue - add(source, s.local.name) - } - } - } - - // For namespace/default imports, collect property names used as - // `binding.foo`/`binding?.foo` so mock-edge modules can expose explicit ESM - // named exports required by Rolldown/native ESM. - if (memberBindingToSource.size > 0) { - const visit = (node: t.Node): void => { - if (t.isMemberExpression(node)) { - const object = node.object - if (t.isIdentifier(object)) { - const source = memberBindingToSource.get(object.name) - if (source) { - const property = node.property - if (!node.computed && t.isIdentifier(property)) { - add(source, property.name) - } else if (node.computed && t.isStringLiteral(property)) { - add(source, property.value) - } - } - } - } - - const keys = t.VISITOR_KEYS[node.type] - if (!keys) return - for (const key of keys) { - const child = (node as unknown as Record<string, unknown>)[key] - if (Array.isArray(child)) { - for (const item of child) { - if (item && typeof item === 'object' && 'type' in item) { - visit(item as t.Node) - } - } - } else if (child && typeof child === 'object' && 'type' in child) { - visit(child as t.Node) - } - } - } - - visit(ast.program) - } - - const out = new Map<string, Array<string>>() - for (const [source, set] of namesBySource) { - out.set(source, Array.from(set).sort()) - } - return out -} - -/** Collect all valid named export identifiers from the given code. */ -export function collectNamedExports(code: string): Array<string> { - return collectNamedExportsFromAst(parseImportProtectionAst(code)) -} - -function collectIdentifiersFromPattern( - pattern: t.LVal, - add: (name: string) => void, -): void { - if (t.isIdentifier(pattern)) { - add(pattern.name) - } else if (t.isObjectPattern(pattern)) { - for (const prop of pattern.properties) { - if (t.isRestElement(prop)) { - collectIdentifiersFromPattern(prop.argument as t.LVal, add) - } else { - collectIdentifiersFromPattern(prop.value as t.LVal, add) - } - } - } else if (t.isArrayPattern(pattern)) { - for (const elem of pattern.elements) { - if (elem) collectIdentifiersFromPattern(elem as t.LVal, add) - } - } else if (t.isAssignmentPattern(pattern)) { - collectIdentifiersFromPattern(pattern.left, add) - } else if (t.isRestElement(pattern)) { - collectIdentifiersFromPattern(pattern.argument as t.LVal, add) - } -} - -function collectNamedExportsFromAst(ast: ParsedAst): Array<string> { - const names = new Set<string>() - const add = (name: string) => { - if (isValidExportName(name)) names.add(name) - } - - for (const node of ast.program.body) { - if (t.isExportNamedDeclaration(node)) { - if (node.exportKind === 'type') continue - - if (node.declaration) { - const decl = node.declaration - if (t.isFunctionDeclaration(decl) || t.isClassDeclaration(decl)) { - if (decl.id?.name) add(decl.id.name) - } else if (t.isVariableDeclaration(decl)) { - for (const d of decl.declarations) { - collectIdentifiersFromPattern(d.id as t.LVal, add) - } - } - } - - for (const s of node.specifiers) { - if (!t.isExportSpecifier(s)) continue - if (s.exportKind === 'type') continue - const exportedName = t.isIdentifier(s.exported) - ? s.exported.name - : s.exported.value - add(exportedName) - } - } - } - - return Array.from(names).sort() -} - -/** - * Rewrite static imports/re-exports from denied sources using Babel AST transforms. - * - * Transforms: - * import { a as b, c } from 'denied' - * Into: - * import __tss_deny_0 from 'tanstack-start-import-protection:mock' - * const b = __tss_deny_0.a - * const c = __tss_deny_0.c - * - * Also handles: - * import def from 'denied' -> import def from mock - * import * as ns from 'denied' -> import ns from mock - * export { x } from 'denied' -> export const x = mock.x - * export * from 'denied' -> removed - * export { x as y } from 'denied' -> export const y = mock.x - */ -export function rewriteDeniedImports( - code: string, - id: string, - deniedSources: Set<string>, - getMockModuleId: (source: string) => string = () => MOCK_MODULE_ID, -): { code: string; map?: SourceMapLike } | undefined { - return rewriteDeniedImportsFromAst( - parseImportProtectionAst(code), - id, - deniedSources, - getMockModuleId, - ) -} - -function rewriteDeniedImportsFromAst( - ast: ParsedAst, - id: string, - deniedSources: Set<string>, - getMockModuleId: (source: string) => string = () => MOCK_MODULE_ID, -): { code: string; map?: SourceMapLike } | undefined { - let modified = false - let mockCounter = 0 - - // Walk program body in reverse so splice indices stay valid - for (let i = ast.program.body.length - 1; i >= 0; i--) { - const node = ast.program.body[i]! - - if (t.isImportDeclaration(node)) { - if (node.importKind === 'type') continue - if (!deniedSources.has(node.source.value)) continue - - const mockVar = `__tss_deny_${mockCounter++}` - const replacements: Array<t.Statement> = [] - - replacements.push( - t.importDeclaration( - [t.importDefaultSpecifier(t.identifier(mockVar))], - t.stringLiteral(getMockModuleId(node.source.value)), - ), - ) - - for (const specifier of node.specifiers) { - if ( - t.isImportDefaultSpecifier(specifier) || - t.isImportNamespaceSpecifier(specifier) - ) { - replacements.push( - t.variableDeclaration('const', [ - t.variableDeclarator( - t.identifier(specifier.local.name), - t.identifier(mockVar), - ), - ]), - ) - } else if (t.isImportSpecifier(specifier)) { - if (specifier.importKind === 'type') continue - const importedName = t.isIdentifier(specifier.imported) - ? specifier.imported.name - : specifier.imported.value - replacements.push( - t.variableDeclaration('const', [ - t.variableDeclarator( - t.identifier(specifier.local.name), - t.memberExpression( - t.identifier(mockVar), - t.identifier(importedName), - ), - ), - ]), - ) - } - } - - ast.program.body.splice(i, 1, ...replacements) - modified = true - continue - } - - if (t.isExportNamedDeclaration(node) && node.source) { - if (node.exportKind === 'type') continue - if (!deniedSources.has(node.source.value)) continue - - const mockVar = `__tss_deny_${mockCounter++}` - const replacements: Array<t.Statement> = [] - - replacements.push( - t.importDeclaration( - [t.importDefaultSpecifier(t.identifier(mockVar))], - t.stringLiteral(getMockModuleId(node.source.value)), - ), - ) - const exportSpecifiers: Array<{ - localName: string - exportedName: string - }> = [] - for (const specifier of node.specifiers) { - if (t.isExportSpecifier(specifier)) { - if (specifier.exportKind === 'type') continue - const localName = specifier.local.name - const exportedName = t.isIdentifier(specifier.exported) - ? specifier.exported.name - : specifier.exported.value - - const internalVar = `__tss_reexport_${localName}` - replacements.push( - t.variableDeclaration('const', [ - t.variableDeclarator( - t.identifier(internalVar), - t.memberExpression( - t.identifier(mockVar), - t.identifier(localName), - ), - ), - ]), - ) - exportSpecifiers.push({ localName: internalVar, exportedName }) - } - } - - if (exportSpecifiers.length > 0) { - replacements.push( - t.exportNamedDeclaration( - null, - exportSpecifiers.map((s) => - t.exportSpecifier( - t.identifier(s.localName), - t.identifier(s.exportedName), - ), - ), - ), - ) - } - - ast.program.body.splice(i, 1, ...replacements) - modified = true - continue - } - - if (t.isExportAllDeclaration(node)) { - if (node.exportKind === 'type') continue - if (!deniedSources.has(node.source.value)) continue - - ast.program.body.splice(i, 1) - modified = true - continue - } - } - - if (!modified) return undefined - - const result = generateFromAst(ast, { - sourceMaps: true, - sourceFileName: id, - filename: id, - }) - - return { - code: result.code, - ...(result.map ? { map: result.map as SourceMapLike } : {}), - } -} diff --git a/packages/start-plugin-core/src/import-protection/INTERNALS.md b/packages/start-plugin-core/src/import-protection/INTERNALS.md new file mode 100644 index 0000000000..4f19e4bd7e --- /dev/null +++ b/packages/start-plugin-core/src/import-protection/INTERNALS.md @@ -0,0 +1,266 @@ +# Import Protection - Shared Internals + +## Overview + +`src/import-protection/` contains the adapter-independent core for TanStack +Start import protection. + +Its current structure is: + +- parse module code once per `TransformResult` +- derive a read-only `ImportAnalysis` object from that AST +- reuse that analysis for source extraction, import-specifier locations, mock + export discovery, named export discovery, and usage lookup +- keep AST mutation in a separate rewrite pass +- keep adapter lifecycle/state-machine behavior outside this directory + +The shared layer is responsible for correctness-sensitive logic that must stay +aligned between Vite and Rsbuild. + +## Shared Module Layout + +### `analysis.ts` + +The central shared analysis module. + +It builds and caches `ImportAnalysis` on `TransformResult.analysis`. + +`ImportAnalysis` contains: + +- parsed AST +- line index +- import sources in source order +- import specifier literal locations +- imported bindings by source +- mock export names by source +- named exports +- usage-position cache + +It exposes both result-based and code-based helpers: + +- `getOrCreateImportAnalysis(result)` +- `getImportSourcesFromResult(result)` +- `getImportSources(code)` +- `getImportSpecifierLocationFromResult(result, source)` +- `getMockExportNamesBySourceFromResult(result)` +- `getMockExportNamesBySource(code)` +- `getNamedExportsFromResult(result)` +- `getNamedExports(code)` +- `findPostCompileUsagePosFromResult(result, source)` +- `findPostCompileUsagePos(code, source)` +- `findOriginalUnsafeUsagePosFromResult(result, source, envType)` +- `findOriginalUnsafeUsagePos(code, source, envType)` +- `isValidExportName(name)` + +### `adapterUtils.ts` + +Contains small adapter-facing shared helpers for decisions that are identical in +Vite and Rsbuild. + +It currently owns: + +- environment type selection from `envTypeMap` +- environment rule selection from `compiledRules` +- normalized root-relative path calculation +- importer filtering via include/exclude/ignore/srcDirectory rules + +This keeps the adapters from duplicating the same targeting logic while still +leaving lifecycle-specific behavior in the adapter implementations. + +### `rewrite.ts` + +Contains the actual AST mutation pass for denied static imports and re-exports. + +It is intentionally separate from `analysis.ts`. + +Why: + +- analysis is read-only and cacheable +- rewrite mutates AST structure and generates code/maps +- keeping them separate prevents adapter code from depending on mutation when it + only needs inspection + +`rewriteDeniedImports()` rewrites denied static import/re-export edges to mock +module imports while preserving explicit bindings expected by the importer. + +### `sourceLocation.ts` + +Builds source locations and snippets from transformed code plus sourcemaps. + +It reuses shared analysis for two important lookups: + +- import-specifier positions in transformed code +- post-compile and original-source usage locations + +It also owns: + +- line-index helpers +- sourcemap normalization +- `sourcesContent` original-source selection +- import-location caching for traces +- code snippet formatting + +### `virtualModules.ts` + +Owns the shared mock module generators and payload encoding. + +This includes: + +- silent mock module code +- runtime diagnostic mock module code +- mock-edge module code with explicit named exports +- self-denial module generation for denied files +- marker module loading + +The adapter-specific transport of these modules is not handled here. + +### `defaults.ts`, `matchers.ts`, `utils.ts`, `trace.ts` + +These remain shared support layers: + +- `defaults.ts`: default deny/marker rules +- `matchers.ts`: compiled glob/regex matcher utilities +- `utils.ts`: path normalization, candidate generation, messages, defer logic, + generic helpers +- `trace.ts`: import graph, traces, snippet-aware message formatting + +## Analysis Lifetime And Cache Model + +The key cache decision is: analysis is cached per `TransformResult`, not +globally by source text. + +That means: + +- Vite can attach analysis to transform-cache results for the current module + version +- Rsbuild can attach analysis to transform results rebuilt from compilation or + preloaded during transform +- cache invalidation follows the host tool's normal module invalidation model +- long dev/HMR sessions do not accumulate an unbounded process-global AST cache + +The analysis object is read-only after creation, except for the internal +`usageByKey` memoization map. + +## Import Source Extraction + +`getImportSources()` is now AST-driven and returns sources in encountered order. + +It includes: + +- `import ... from 'x'` +- `export ... from 'x'` +- `export * from 'x'` +- `import('x')` +- dynamic import call forms supported by Babel's AST shape + +Adapter code that needs source extraction should call into `analysis.ts` +directly. + +## Mock Export Discovery + +Mock-edge modules need to know which named exports the importer expects. + +`analysis.ts` derives that from the importer AST by recording: + +- named import specifiers +- namespace member access +- default-import member access +- re-export specifiers + +This produces `mockExportNamesBySource`, which is a safe over-approximation of +the named exports the adapter should expose on a mock-edge module. + +## Named Export Discovery + +Self-denial needs the denied file's export surface. + +`getNamedExports()` and `getNamedExportsFromResult()` collect valid named +exports from: + +- function/class declarations +- variable declarations, including destructuring patterns +- export specifiers and aliases + +`default` is excluded from the named export list because the mock generators +handle default export separately. + +## Usage Lookup And Safe Boundaries + +Usage lookup is shared across adapters through `analysis.ts`. + +The walker: + +- tracks lexical/program/block/function bindings manually +- respects shadowing across nested scopes, block bindings, function params, and + `catch` params +- treats certain compiler-recognized boundaries as safe when looking for + original unsafe usage + +Safe boundary recognition is environment-specific: + +- client env safe boundaries: + - `createServerFn().handler(...)` + - `createMiddleware(...).server(...)` + - `createIsomorphicFn().server(...)` + - `createServerOnlyFn(...)` +- server env safe boundaries: + - `createClientOnlyFn(...)` + - `createIsomorphicFn().client(...)` + +This is the core shared logic that keeps both adapters aligned on cases like +`boundary-safe`, `factory-safe`, and `compiler-leak`. + +## Rewriting Versus Analysis + +Analysis and rewrite are intentionally separate. + +Reasons: + +- adapters frequently need inspection without mutation +- mutation wants a fresh, isolated AST/codegen pass +- read-only analysis is much easier to cache safely +- source-location helpers and usage lookup should not depend on whether a module + was rewritten + +The intended flow is: + +1. build or reuse `ImportAnalysis` +2. inspect/import-locate/trace as needed +3. if a denied-specifier rewrite is needed, run `rewriteDeniedImports()` + +## Adapter Contract + +The shared layer deliberately does not decide: + +- when a violation is discovered +- when it is reported versus deferred +- how dev/build lifecycle hooks work +- how virtual module ids/files are transported by the bundler +- how final compilation truth is obtained + +Those are adapter responsibilities. + +The shared layer does provide the primitives both adapters rely on: + +- rule helpers +- AST parsing +- analysis +- rewrite +- virtual module code generation +- source locations/snippets +- trace formatting + +## Maintainer Guidance + +When making future import-protection changes: + +1. If the behavior is about parsing, source extraction, export discovery, usage + lookup, source locations, rewrite mechanics, or mock codegen, it probably + belongs in `src/import-protection/`. +2. If the behavior is about hook timing, deferral, compilation truth, pending + queues, or environment-specific virtual-module transport, it probably belongs + in the adapter docs/code. +3. Prefer extending `ImportAnalysis` over adding new one-off parsers or wrapper + helpers. +4. Avoid reintroducing global source-text caches; cache on `TransformResult` + instead. diff --git a/packages/start-plugin-core/src/import-protection/adapterUtils.ts b/packages/start-plugin-core/src/import-protection/adapterUtils.ts new file mode 100644 index 0000000000..4893c504e4 --- /dev/null +++ b/packages/start-plugin-core/src/import-protection/adapterUtils.ts @@ -0,0 +1,94 @@ +import { matchesAny } from './matchers' +import { isInsideDirectory, normalizeFilePath, relativizePath } from './utils' +import type { CompiledMatcher } from './matchers' + +export type ImportProtectionEnvType = 'client' | 'server' + +export interface ImportProtectionEnvRules { + specifiers: Array<CompiledMatcher> + files: Array<CompiledMatcher> + excludeFiles: Array<CompiledMatcher> +} + +/** + * Shared subset of adapter config used to decide which environment rules apply + * and whether an importer should be checked at all. + */ +export interface ImportProtectionAdapterConfig { + root: string + srcDirectory: string + compiledRules: { + client: ImportProtectionEnvRules + server: ImportProtectionEnvRules + } + includeMatchers: Array<CompiledMatcher> + excludeMatchers: Array<CompiledMatcher> + ignoreImporterMatchers: Array<CompiledMatcher> + envTypeMap: Map<string, ImportProtectionEnvType> +} + +export function getImportProtectionRelativePath( + root: string, + absolutePath: string, +): string { + return relativizePath(normalizeFilePath(absolutePath), root) +} + +export function getImportProtectionEnvType( + config: Pick<ImportProtectionAdapterConfig, 'envTypeMap'>, + envName: string, +): ImportProtectionEnvType { + return config.envTypeMap.get(envName) ?? 'server' +} + +export function getImportProtectionRulesForEnvironment( + config: Pick<ImportProtectionAdapterConfig, 'compiledRules' | 'envTypeMap'>, + envName: string, +): ImportProtectionEnvRules { + return getImportProtectionEnvType(config, envName) === 'client' + ? config.compiledRules.client + : config.compiledRules.server +} + +export function shouldCheckImportProtectionImporter( + config: Pick< + ImportProtectionAdapterConfig, + | 'root' + | 'srcDirectory' + | 'includeMatchers' + | 'excludeMatchers' + | 'ignoreImporterMatchers' + >, + importer: string, + cache?: Map<string, boolean>, +): boolean { + const normalizedImporter = normalizeFilePath(importer) + + if (cache) { + const cached = cache.get(normalizedImporter) + if (cached !== undefined) { + return cached + } + } + + const relativePath = relativizePath(normalizedImporter, config.root) + + let result: boolean + if ( + (config.excludeMatchers.length > 0 && + matchesAny(relativePath, config.excludeMatchers)) || + (config.ignoreImporterMatchers.length > 0 && + matchesAny(relativePath, config.ignoreImporterMatchers)) + ) { + result = false + } else if (config.includeMatchers.length > 0) { + result = !!matchesAny(relativePath, config.includeMatchers) + } else if (config.srcDirectory) { + result = isInsideDirectory(normalizedImporter, config.srcDirectory) + } else { + result = true + } + + cache?.set(normalizedImporter, result) + return result +} diff --git a/packages/start-plugin-core/src/import-protection/analysis.ts b/packages/start-plugin-core/src/import-protection/analysis.ts new file mode 100644 index 0000000000..85f90b0a87 --- /dev/null +++ b/packages/start-plugin-core/src/import-protection/analysis.ts @@ -0,0 +1,935 @@ +import * as t from '@babel/types' +import { parseAst } from '@tanstack/router-utils' + +import { buildLineIndex } from './sourceLocation' +import { getOrCreate } from './utils' +import type { LineIndex, TransformResult } from './sourceLocation' +import type { ParseAstResult } from '@tanstack/router-utils' + +export type UsagePos = { line: number; column0: number } + +type BoundaryEnv = 'client' | 'server' + +type ImportBindingInfo = { + importedLocalNames: Set<string> +} + +type UsageCacheKey = `${BoundaryEnv | 'post'}::${string}` + +function mayContainImportOrExport(code: string): boolean { + return code.includes('import') || code.includes('export') +} + +export type ImportAnalysis = { + ast: ParseAstResult + lineIndex: LineIndex + importSourcesInOrder: Array<string> + importSpecifierLocationIndex: Map<string, number> + importBindingsBySource: Map<string, ImportBindingInfo> + mockExportNamesBySource: Map<string, Array<string>> + namedExports: Array<string> + usageByKey: Map<UsageCacheKey, UsagePos | null> +} + +function makeTransientResult( + code: string, + filename?: string, + perf?: TransformResult['perf'], +): TransformResult { + const result: TransformResult = { + code, + filename, + map: undefined, + originalCode: undefined, + } + + if (perf) { + result.perf = perf + } + + return result +} + +function getOrParseAst(result: TransformResult): ParseAstResult { + if (result.parsedAst) { + result.perf?.count('analysis.parseAst.cached') + return result.parsedAst + } + + const startedAt = result.perf ? performance.now() : 0 + result.perf?.count('analysis.parseAst.calls') + + try { + const ast = parseAst({ code: result.code, filename: result.filename }) + result.parsedAst = ast + return ast + } finally { + if (result.perf) { + result.perf.time('analysis.parseAst', startedAt) + } + } +} + +function getModuleExportName(node: t.Identifier | t.StringLiteral): string { + return t.isIdentifier(node) ? node.name : node.value +} + +function getStringLiteralValueStart(node: t.StringLiteral): number { + if (node.start == null) { + return -1 + } + + const raw = node.extra?.raw + if (typeof raw === 'string' && (raw.startsWith("'") || raw.startsWith('"'))) { + return node.start + 1 + } + + return node.start +} + +function isTypeOnlyImportDeclaration(node: t.ImportDeclaration): boolean { + if (node.importKind === 'type') return true + if (node.specifiers.length === 0) return false + + return node.specifiers.every( + (specifier) => + t.isImportSpecifier(specifier) && specifier.importKind === 'type', + ) +} + +function isTypeOnlyExportNamedDeclaration( + node: t.ExportNamedDeclaration, +): boolean { + if (node.exportKind === 'type') return true + if (!node.source || node.declaration || node.specifiers.length === 0) { + return false + } + + return node.specifiers.every( + (specifier) => + t.isExportSpecifier(specifier) && specifier.exportKind === 'type', + ) +} + +function collectIdentifiersFromPattern( + pattern: t.LVal, + add: (name: string) => void, +): void { + if (t.isIdentifier(pattern)) { + add(pattern.name) + } else if (t.isObjectPattern(pattern)) { + for (const prop of pattern.properties) { + if (t.isRestElement(prop)) { + collectIdentifiersFromPattern(prop.argument as t.LVal, add) + } else { + collectIdentifiersFromPattern(prop.value as t.LVal, add) + } + } + } else if (t.isArrayPattern(pattern)) { + for (const elem of pattern.elements) { + if (elem) collectIdentifiersFromPattern(elem as t.LVal, add) + } + } else if (t.isAssignmentPattern(pattern)) { + collectIdentifiersFromPattern(pattern.left, add) + } else if (t.isRestElement(pattern)) { + collectIdentifiersFromPattern(pattern.argument as t.LVal, add) + } +} + +export function isValidExportName(name: string): boolean { + if (name === 'default' || name.length === 0) return false + const first = name.charCodeAt(0) + if ( + !( + (first >= 65 && first <= 90) || + (first >= 97 && first <= 122) || + first === 95 || + first === 36 + ) + ) + return false + for (let i = 1; i < name.length; i++) { + const ch = name.charCodeAt(i) + if ( + !( + (ch >= 65 && ch <= 90) || + (ch >= 97 && ch <= 122) || + (ch >= 48 && ch <= 57) || + ch === 95 || + ch === 36 + ) + ) + return false + } + return true +} + +function buildImportAnalysis(result: TransformResult): ImportAnalysis { + const ast = getOrParseAst(result) + + const importSourcesInOrder: Array<string> = [] + const importSpecifierLocationIndex = new Map<string, number>() + const importBindingsBySource = new Map<string, ImportBindingInfo>() + const memberBindingSources = new Map<string, Set<string>>() + const mockNamesBySource = new Map<string, Set<string>>() + const namedExports = new Set<string>() + + const getBindingInfo = (source: string): ImportBindingInfo => + getOrCreate(importBindingsBySource, source, () => ({ + importedLocalNames: new Set<string>(), + })) + + const addSpecifierLocation = (node: t.StringLiteral) => { + importSourcesInOrder.push(node.value) + + const index = getStringLiteralValueStart(node) + if (index === -1) { + return + } + + const prev = importSpecifierLocationIndex.get(node.value) + if (prev == null || index < prev) { + importSpecifierLocationIndex.set(node.value, index) + } + } + + const addMockName = (source: string, name: string) => { + if (name === 'default' || name.length === 0) return + getOrCreate(mockNamesBySource, source, () => new Set<string>()).add(name) + } + + const addMemberBinding = (localName: string, source: string) => { + getOrCreate(memberBindingSources, localName, () => new Set<string>()).add( + source, + ) + } + + const addNamedExport = (name: string) => { + if (name !== 'default' && name.length > 0) { + namedExports.add(name) + } + } + + const visit = (node: t.Node): void => { + if (t.isImportDeclaration(node)) { + const isTypeOnly = isTypeOnlyImportDeclaration(node) + if (!isTypeOnly) { + addSpecifierLocation(node.source) + const source = node.source.value + const bindingInfo = getBindingInfo(source) + for (const specifier of node.specifiers) { + if (t.isImportNamespaceSpecifier(specifier)) { + bindingInfo.importedLocalNames.add(specifier.local.name) + addMemberBinding(specifier.local.name, source) + continue + } + + if (t.isImportDefaultSpecifier(specifier)) { + bindingInfo.importedLocalNames.add(specifier.local.name) + addMemberBinding(specifier.local.name, source) + continue + } + + if (!t.isImportSpecifier(specifier)) continue + if (specifier.importKind === 'type') continue + + bindingInfo.importedLocalNames.add(specifier.local.name) + const importedName = getModuleExportName(specifier.imported) + if (importedName !== 'default') { + addMockName(source, importedName) + } + } + } + } else if (t.isExportNamedDeclaration(node)) { + const isTypeOnly = isTypeOnlyExportNamedDeclaration(node) + if (!isTypeOnly && node.source && t.isStringLiteral(node.source)) { + addSpecifierLocation(node.source) + } + + if (!isTypeOnly && node.source?.value) { + const source = node.source.value + for (const specifier of node.specifiers) { + if (!t.isExportSpecifier(specifier)) continue + if (specifier.exportKind === 'type') continue + addMockName(source, getModuleExportName(specifier.local)) + } + } + + if (!isTypeOnly) { + if (node.declaration) { + const decl = node.declaration + if (t.isFunctionDeclaration(decl) || t.isClassDeclaration(decl)) { + if (decl.id?.name) addNamedExport(decl.id.name) + } else if (t.isVariableDeclaration(decl)) { + for (const d of decl.declarations) { + collectIdentifiersFromPattern(d.id as t.LVal, addNamedExport) + } + } + } + + for (const specifier of node.specifiers) { + if (!t.isExportSpecifier(specifier)) continue + if (specifier.exportKind === 'type') continue + const exportedName = getModuleExportName(specifier.exported) + addNamedExport(exportedName) + } + } + } else if (t.isExportAllDeclaration(node)) { + if (node.exportKind !== 'type') { + addSpecifierLocation(node.source) + } + } else if (t.isImportExpression(node)) { + if (t.isStringLiteral(node.source)) { + addSpecifierLocation(node.source) + } + } else if (t.isCallExpression(node) && t.isImport(node.callee)) { + const sourceNode = node.arguments[0] + if (t.isStringLiteral(sourceNode)) { + addSpecifierLocation(sourceNode) + } + } else if ( + t.isMemberExpression(node) || + t.isOptionalMemberExpression(node) + ) { + const object = node.object + if (t.isIdentifier(object)) { + const sources = memberBindingSources.get(object.name) + if (sources) { + const property = node.property + for (const source of sources) { + if (!node.computed && t.isIdentifier(property)) { + addMockName(source, property.name) + } else if (node.computed && t.isStringLiteral(property)) { + addMockName(source, property.value) + } + } + } + } + } + + const keys = t.VISITOR_KEYS[node.type] + if (!keys) return + for (const key of keys) { + const child = (node as unknown as Record<string, unknown>)[key] + if (Array.isArray(child)) { + for (const item of child) { + if (item && typeof item === 'object' && 'type' in item) { + visit(item as t.Node) + } + } + } else if (child && typeof child === 'object' && 'type' in child) { + visit(child as t.Node) + } + } + } + + visit(ast.program) + + const mockExportNamesBySource = new Map<string, Array<string>>() + for (const [source, names] of mockNamesBySource) { + mockExportNamesBySource.set(source, Array.from(names).sort()) + } + + const lineIndex = result.lineIndex ?? buildLineIndex(result.code) + result.lineIndex = lineIndex + + const analysis = { + ast, + lineIndex, + importSourcesInOrder, + importSpecifierLocationIndex, + importBindingsBySource, + mockExportNamesBySource, + namedExports: Array.from(namedExports).sort(), + usageByKey: new Map(), + } + + return analysis +} + +export function getOrCreateImportAnalysis( + result: TransformResult, +): ImportAnalysis { + if (!result.analysis) { + result.analysis = buildImportAnalysis(result) + } + + return result.analysis +} + +export function getImportSourcesFromResult( + result: TransformResult, +): Array<string> { + if (!mayContainImportOrExport(result.code)) { + return [] + } + + return getOrCreateImportAnalysis(result).importSourcesInOrder +} + +export function getImportSources( + code: string, + filename?: string, + perf?: TransformResult['perf'], +): Array<string> { + return getImportSourcesFromResult(makeTransientResult(code, filename, perf)) +} + +export function getImportSpecifierLocationFromResult( + result: TransformResult, + source: string, +): number { + return ( + getOrCreateImportAnalysis(result).importSpecifierLocationIndex.get( + source, + ) ?? -1 + ) +} + +export function getMockExportNamesBySourceFromResult( + result: TransformResult, +): Map<string, Array<string>> { + return getOrCreateImportAnalysis(result).mockExportNamesBySource +} + +export function getMockExportNamesBySource( + code: string, + filename?: string, + perf?: TransformResult['perf'], +): Map<string, Array<string>> { + return getMockExportNamesBySourceFromResult( + makeTransientResult(code, filename, perf), + ) +} + +export function getNamedExportsFromResult( + result: TransformResult, +): Array<string> { + return getOrCreateImportAnalysis(result).namedExports +} + +export function getNamedExports( + code: string, + filename?: string, + perf?: TransformResult['perf'], +): Array<string> { + return getNamedExportsFromResult(makeTransientResult(code, filename, perf)) +} + +function isCompilerSafeBoundaryCall( + call: t.CallExpression, + fnNode: t.Function, + envType: BoundaryEnv, +): boolean { + const directArgument = call.arguments.some((arg) => arg === fnNode) + if (!directArgument) { + return false + } + + const callee = call.callee + + if (t.isIdentifier(callee)) { + return envType === 'client' + ? callee.name === 'createServerOnlyFn' + : callee.name === 'createClientOnlyFn' + } + + if (!t.isMemberExpression(callee) || callee.computed) { + return false + } + + if (!t.isIdentifier(callee.property)) { + return false + } + + const prop = callee.property.name + const rootName = getCalleeRootName(callee.object) + + if (envType === 'client') { + if (prop === 'handler') { + return rootName === 'createServerFn' || /ServerFn$/.test(rootName ?? '') + } + + if (prop === 'server') { + return ( + rootName === 'createMiddleware' || + rootName === 'createIsomorphicFn' || + /Middleware$/.test(rootName ?? '') + ) + } + + return false + } + + if (prop === 'client') { + return rootName === 'createIsomorphicFn' + } + + return false +} + +function getCalleeRootName( + node: t.Expression | t.Super | t.V8IntrinsicIdentifier, +): string | undefined { + if (t.isIdentifier(node)) { + return node.name + } + + if (t.isCallExpression(node)) { + return getCalleeRootName(node.callee) + } + + if (t.isMemberExpression(node)) { + return getCalleeRootName(node.object) + } + + return undefined +} + +function getBoundNamesFromPattern(pattern: t.LVal, out: Set<string>): void { + if (t.isIdentifier(pattern)) { + out.add(pattern.name) + } else if (t.isObjectPattern(pattern)) { + for (const prop of pattern.properties) { + if (t.isRestElement(prop)) { + getBoundNamesFromPattern(prop.argument as t.LVal, out) + } else { + getBoundNamesFromPattern(prop.value as t.LVal, out) + } + } + } else if (t.isArrayPattern(pattern)) { + for (const elem of pattern.elements) { + if (elem) getBoundNamesFromPattern(elem as t.LVal, out) + } + } else if (t.isAssignmentPattern(pattern)) { + getBoundNamesFromPattern(pattern.left, out) + } else if (t.isRestElement(pattern)) { + getBoundNamesFromPattern(pattern.argument as t.LVal, out) + } +} + +function addPatternBindingsIfTracked( + pattern: t.LVal, + tracked: Set<string>, + out: Set<string>, +): void { + const names = new Set<string>() + getBoundNamesFromPattern(pattern, names) + for (const name of names) { + if (tracked.has(name)) { + out.add(name) + } + } +} + +function collectHoistedVarBindings( + node: t.Node, + tracked: Set<string>, + out: Set<string>, + isRoot = true, +): void { + if (!isRoot && t.isFunction(node)) { + return + } + + if (t.isVariableDeclaration(node) && node.kind === 'var') { + for (const decl of node.declarations) { + addPatternBindingsIfTracked(decl.id as t.LVal, tracked, out) + } + } + + const keys = t.VISITOR_KEYS[node.type] + if (!keys) return + for (const key of keys) { + const child = (node as unknown as Record<string, unknown>)[key] + if (Array.isArray(child)) { + for (const item of child) { + if (item && typeof item === 'object' && 'type' in item) { + collectHoistedVarBindings(item as t.Node, tracked, out, false) + } + } + } else if (child && typeof child === 'object' && 'type' in child) { + collectHoistedVarBindings(child as t.Node, tracked, out, false) + } + } +} + +function collectProgramBindings( + program: t.Program, + tracked: Set<string>, +): Set<string> { + const bindings = new Set<string>() + + for (const node of program.body) { + if (t.isVariableDeclaration(node)) { + for (const decl of node.declarations) { + addPatternBindingsIfTracked(decl.id as t.LVal, tracked, bindings) + } + continue + } + + if (t.isFunctionDeclaration(node) || t.isClassDeclaration(node)) { + if (node.id && tracked.has(node.id.name)) { + bindings.add(node.id.name) + } + } + } + + return bindings +} + +function collectBlockBindings( + block: t.BlockStatement, + tracked: Set<string>, +): Set<string> { + const bindings = new Set<string>() + + for (const node of block.body) { + if (t.isVariableDeclaration(node) && node.kind !== 'var') { + for (const decl of node.declarations) { + addPatternBindingsIfTracked(decl.id as t.LVal, tracked, bindings) + } + continue + } + + if (t.isFunctionDeclaration(node) || t.isClassDeclaration(node)) { + if (node.id && tracked.has(node.id.name)) { + bindings.add(node.id.name) + } + } + } + + return bindings +} + +function collectFunctionBindings( + fn: t.Function, + tracked: Set<string>, +): Set<string> { + const bindings = new Set<string>() + + if ( + (t.isFunctionDeclaration(fn) || t.isFunctionExpression(fn)) && + fn.id && + tracked.has(fn.id.name) + ) { + bindings.add(fn.id.name) + } + + for (const param of fn.params) { + addPatternBindingsIfTracked(param as t.LVal, tracked, bindings) + } + + if (t.isBlockStatement(fn.body)) { + collectHoistedVarBindings(fn.body, tracked, bindings) + } + + return bindings +} + +type UsageWalkContext = { + parents: Array<t.Node> + scopeStack: Array<Set<string>> +} + +function isShadowedByScope( + name: string, + scopeStack: Array<Set<string>>, +): boolean { + for (let i = scopeStack.length - 1; i >= 0; i--) { + if (scopeStack[i]?.has(name)) { + return true + } + } + return false +} + +function isBindingIdentifierInParent( + node: t.Identifier, + parent: t.Node | undefined, +): boolean { + if (!parent) return false + + if (t.isImportSpecifier(parent) || t.isImportDefaultSpecifier(parent)) { + return parent.local === node + } + if (t.isImportNamespaceSpecifier(parent)) { + return parent.local === node + } + if (t.isFunctionDeclaration(parent) || t.isFunctionExpression(parent)) { + return ( + parent.id === node || parent.params.includes(node as unknown as t.Pattern) + ) + } + if (t.isArrowFunctionExpression(parent)) { + return parent.params.includes(node as unknown as t.Pattern) + } + if (t.isClassDeclaration(parent) || t.isClassExpression(parent)) { + return parent.id === node + } + if (t.isVariableDeclarator(parent)) { + return parent.id === node + } + if (t.isCatchClause(parent)) { + return parent.param === node + } + + return false +} + +function isInsideCompilerSafeBoundaryNodes( + parents: Array<t.Node>, + envType: BoundaryEnv, +): boolean { + for (let i = parents.length - 1; i >= 0; i--) { + const node = parents[i]! + if (!t.isFunction(node)) { + continue + } + + const call = parents[i - 1] + if ( + call && + t.isCallExpression(call) && + isCompilerSafeBoundaryCall(call, node, envType) + ) { + return true + } + } + + return false +} + +function findUsagePosInAnalysis( + result: TransformResult, + source: string, + envType?: BoundaryEnv, +): UsagePos | undefined { + const analysis = getOrCreateImportAnalysis(result) + const cacheKey: UsageCacheKey = `${envType ?? 'post'}::${source}` + if (analysis.usageByKey.has(cacheKey)) { + return analysis.usageByKey.get(cacheKey) ?? undefined + } + + const imported = + analysis.importBindingsBySource.get(source)?.importedLocalNames + if (!imported || imported.size === 0) { + analysis.usageByKey.set(cacheKey, null) + return undefined + } + + let preferred: UsagePos | undefined + let anyUsage: UsagePos | undefined + + const visit = (node: t.Node, ctx: UsageWalkContext): void => { + if (preferred && anyUsage) { + return + } + + if (t.isProgram(node)) { + const nextCtx = { + parents: [...ctx.parents, node], + scopeStack: [...ctx.scopeStack, collectProgramBindings(node, imported)], + } + for (const child of node.body) { + visit(child, nextCtx) + } + return + } + + if (t.isFunction(node)) { + const functionCtx = { + parents: [...ctx.parents, node], + scopeStack: [ + ...ctx.scopeStack, + collectFunctionBindings(node, imported), + ], + } + + visit(node.body, functionCtx) + return + } + + if (t.isBlockStatement(node)) { + const nextCtx = { + parents: [...ctx.parents, node], + scopeStack: [...ctx.scopeStack, collectBlockBindings(node, imported)], + } + for (const child of node.body) { + visit(child, nextCtx) + } + return + } + + if (t.isCatchClause(node)) { + const bindings = new Set<string>() + if (node.param) { + addPatternBindingsIfTracked(node.param as t.LVal, imported, bindings) + } + const nextCtx = { + parents: [...ctx.parents, node], + scopeStack: bindings.size + ? [...ctx.scopeStack, bindings] + : ctx.scopeStack, + } + visit(node.body, nextCtx) + return + } + + if ( + t.isForStatement(node) && + t.isVariableDeclaration(node.init) && + node.init.kind !== 'var' + ) { + const bindings = new Set<string>() + for (const decl of node.init.declarations) { + addPatternBindingsIfTracked(decl.id as t.LVal, imported, bindings) + } + const nextCtx = { + parents: [...ctx.parents, node], + scopeStack: bindings.size + ? [...ctx.scopeStack, bindings] + : ctx.scopeStack, + } + visit(node.init, nextCtx) + if (node.test) visit(node.test, nextCtx) + if (node.update) visit(node.update, nextCtx) + visit(node.body, nextCtx) + return + } + + if ( + (t.isForInStatement(node) || t.isForOfStatement(node)) && + t.isVariableDeclaration(node.left) && + node.left.kind !== 'var' + ) { + const bindings = new Set<string>() + for (const decl of node.left.declarations) { + addPatternBindingsIfTracked(decl.id as t.LVal, imported, bindings) + } + const nextCtx = { + parents: [...ctx.parents, node], + scopeStack: bindings.size + ? [...ctx.scopeStack, bindings] + : ctx.scopeStack, + } + visit(node.left, nextCtx) + visit(node.right, nextCtx) + visit(node.body, nextCtx) + return + } + + const nextParents = [...ctx.parents, node] + + if (t.isIdentifier(node)) { + const parent = ctx.parents[ctx.parents.length - 1] + if (imported.has(node.name)) { + if (!isBindingIdentifierInParent(node, parent)) { + if ( + !( + t.isObjectProperty(parent) && + parent.key === node && + !parent.computed && + !parent.shorthand + ) && + !( + t.isObjectMethod(parent) && + parent.key === node && + !parent.computed + ) && + !(t.isExportSpecifier(parent) && parent.exported === node) && + !isShadowedByScope(node.name, ctx.scopeStack) && + !( + envType && isInsideCompilerSafeBoundaryNodes(ctx.parents, envType) + ) + ) { + const loc = node.loc?.start + if (loc) { + const pos: UsagePos = { line: loc.line, column0: loc.column } + const isPreferred = + (t.isCallExpression(parent) && parent.callee === node) || + (t.isNewExpression(parent) && parent.callee === node) || + ((t.isMemberExpression(parent) || + t.isOptionalMemberExpression(parent)) && + parent.object === node) + + if (isPreferred) { + preferred ||= pos + } else { + anyUsage ||= pos + } + } + } + } + } + } + + if (t.isImportDeclaration(node)) { + return + } + + const keys = t.VISITOR_KEYS[node.type] + if (!keys) return + for (const key of keys) { + const child = (node as unknown as Record<string, unknown>)[key] + if (Array.isArray(child)) { + for (const item of child) { + if (item && typeof item === 'object' && 'type' in item) { + visit(item as t.Node, { + parents: nextParents, + scopeStack: ctx.scopeStack, + }) + } + } + } else if (child && typeof child === 'object' && 'type' in child) { + visit(child as t.Node, { + parents: nextParents, + scopeStack: ctx.scopeStack, + }) + } + } + } + + visit(analysis.ast.program, { + parents: [], + scopeStack: [], + }) + + const pos = preferred ?? anyUsage ?? null + analysis.usageByKey.set(cacheKey, pos) + return pos ?? undefined +} + +export function findPostCompileUsagePosFromResult( + result: TransformResult, + source: string, +): UsagePos | undefined { + return findUsagePosInAnalysis(result, source) +} + +export function findPostCompileUsagePos( + code: string, + source: string, +): UsagePos | undefined { + return findPostCompileUsagePosFromResult(makeTransientResult(code), source) +} + +export function findOriginalUnsafeUsagePosFromResult( + result: TransformResult, + source: string, + envType: BoundaryEnv, +): UsagePos | undefined { + return findUsagePosInAnalysis(result, source, envType) +} + +export function findOriginalUnsafeUsagePos( + code: string, + source: string, + envType: BoundaryEnv, +): UsagePos | undefined { + return findOriginalUnsafeUsagePosFromResult( + makeTransientResult(code), + source, + envType, + ) +} diff --git a/packages/start-plugin-core/src/import-protection-plugin/constants.ts b/packages/start-plugin-core/src/import-protection/constants.ts similarity index 61% rename from packages/start-plugin-core/src/import-protection-plugin/constants.ts rename to packages/start-plugin-core/src/import-protection/constants.ts index 9c3b596550..54bb55fdab 100644 --- a/packages/start-plugin-core/src/import-protection-plugin/constants.ts +++ b/packages/start-plugin-core/src/import-protection/constants.ts @@ -2,6 +2,13 @@ import { SERVER_FN_LOOKUP } from '../constants' export const SERVER_FN_LOOKUP_QUERY = `?${SERVER_FN_LOOKUP}` +export const MOCK_MODULE_ID = 'tanstack-start-import-protection:mock' +export const MOCK_BUILD_PREFIX = 'tanstack-start-import-protection:mock:build:' +export const MOCK_EDGE_PREFIX = 'tanstack-start-import-protection:mock-edge:' +export const MOCK_RUNTIME_PREFIX = + 'tanstack-start-import-protection:mock-runtime:' +export const MARKER_PREFIX = 'tanstack-start-import-protection:marker:' + export const IMPORT_PROTECTION_DEBUG = process.env.TSR_IMPORT_PROTECTION_DEBUG === '1' || process.env.TSR_IMPORT_PROTECTION_DEBUG === 'true' diff --git a/packages/start-plugin-core/src/import-protection-plugin/defaults.ts b/packages/start-plugin-core/src/import-protection/defaults.ts similarity index 100% rename from packages/start-plugin-core/src/import-protection-plugin/defaults.ts rename to packages/start-plugin-core/src/import-protection/defaults.ts diff --git a/packages/start-plugin-core/src/import-protection-plugin/extensionlessAbsoluteIdResolver.ts b/packages/start-plugin-core/src/import-protection/extensionlessAbsoluteIdResolver.ts similarity index 100% rename from packages/start-plugin-core/src/import-protection-plugin/extensionlessAbsoluteIdResolver.ts rename to packages/start-plugin-core/src/import-protection/extensionlessAbsoluteIdResolver.ts diff --git a/packages/start-plugin-core/src/import-protection-plugin/matchers.ts b/packages/start-plugin-core/src/import-protection/matchers.ts similarity index 78% rename from packages/start-plugin-core/src/import-protection-plugin/matchers.ts rename to packages/start-plugin-core/src/import-protection/matchers.ts index 65a33078e4..a5dc23a957 100644 --- a/packages/start-plugin-core/src/import-protection-plugin/matchers.ts +++ b/packages/start-plugin-core/src/import-protection/matchers.ts @@ -4,9 +4,16 @@ import type { Pattern } from './utils' export interface CompiledMatcher { pattern: Pattern + literal?: string test: (value: string) => boolean } +const globLikePatternRE = /[*?![\]{}()]/ + +export function isLiteralMatcherPattern(pattern: string): boolean { + return !globLikePatternRE.test(pattern) +} + /** * Compile a Pattern (string glob or RegExp) into a fast test function. * String patterns use picomatch for full glob support (**, *, ?, braces, etc.). @@ -25,6 +32,14 @@ export function compileMatcher(pattern: Pattern): CompiledMatcher { } } + if (isLiteralMatcherPattern(pattern)) { + return { + pattern, + literal: pattern, + test: (value: string) => value === pattern, + } + } + const isMatch = picomatch(pattern, { dot: true }) return { pattern, test: isMatch } } diff --git a/packages/start-plugin-core/src/import-protection/rewrite.ts b/packages/start-plugin-core/src/import-protection/rewrite.ts new file mode 100644 index 0000000000..fb7e190476 --- /dev/null +++ b/packages/start-plugin-core/src/import-protection/rewrite.ts @@ -0,0 +1,228 @@ +import * as t from '@babel/types' +import { generateFromAst, parseAst } from '@tanstack/router-utils' + +import { MOCK_MODULE_ID } from './constants' +import type { SourceMapLike } from './sourceLocation' +import type { ParseAstResult } from '@tanstack/router-utils' + +function getModuleExportName(node: t.Identifier | t.StringLiteral): string { + return t.isIdentifier(node) ? node.name : node.value +} + +function toMemberExpressionProperty(name: string): { + property: t.Identifier | t.StringLiteral + computed: boolean +} { + return t.isValidIdentifier(name) + ? { property: t.identifier(name), computed: false } + : { property: t.stringLiteral(name), computed: true } +} + +function toModuleExportNameNode(name: string): t.Identifier | t.StringLiteral { + return t.isValidIdentifier(name) ? t.identifier(name) : t.stringLiteral(name) +} + +function createInternalReexportVarName( + localName: string, + mockIndex: number, + usedNames: Set<string>, +): string { + const baseName = t.isValidIdentifier(localName) + ? `__tss_reexport_${localName}` + : `__tss_reexport_${mockIndex}` + + let candidate = baseName + let suffix = 0 + while (usedNames.has(candidate)) { + suffix++ + candidate = `${baseName}_${suffix}` + } + + usedNames.add(candidate) + return candidate +} + +/** + * Rewrite static imports/re-exports from denied sources using Babel AST transforms. + * + * Transforms: + * import { a as b, c } from 'denied' + * Into: + * import __tss_deny_0 from 'tanstack-start-import-protection:mock' + * const b = __tss_deny_0.a + * const c = __tss_deny_0.c + * + * Also handles: + * import def from 'denied' -> import def from mock + * import * as ns from 'denied' -> import ns from mock + * export { x } from 'denied' -> export const x = mock.x + * export * from 'denied' -> removed + * export { x as y } from 'denied' -> export const y = mock.x + */ +export function rewriteDeniedImports( + code: string, + id: string, + deniedSources: Set<string>, + getMockModuleId: (source: string) => string = () => MOCK_MODULE_ID, +): { code: string; map?: SourceMapLike } | undefined { + return rewriteDeniedImportsFromAst( + parseAst({ code, filename: id }), + id, + deniedSources, + getMockModuleId, + ) +} + +function rewriteDeniedImportsFromAst( + ast: ParseAstResult, + id: string, + deniedSources: Set<string>, + getMockModuleId: (source: string) => string = () => MOCK_MODULE_ID, +): { code: string; map?: SourceMapLike } | undefined { + let modified = false + let mockCounter = 0 + + // Walk program body in reverse so splice indices stay valid + for (let i = ast.program.body.length - 1; i >= 0; i--) { + const node = ast.program.body[i]! + + if (t.isImportDeclaration(node)) { + if (node.importKind === 'type') continue + if (!deniedSources.has(node.source.value)) continue + + const mockVar = `__tss_deny_${mockCounter++}` + const replacements: Array<t.Statement> = [] + + replacements.push( + t.importDeclaration( + [t.importDefaultSpecifier(t.identifier(mockVar))], + t.stringLiteral(getMockModuleId(node.source.value)), + ), + ) + + for (const specifier of node.specifiers) { + if ( + t.isImportDefaultSpecifier(specifier) || + t.isImportNamespaceSpecifier(specifier) + ) { + replacements.push( + t.variableDeclaration('const', [ + t.variableDeclarator( + t.identifier(specifier.local.name), + t.identifier(mockVar), + ), + ]), + ) + } else if (t.isImportSpecifier(specifier)) { + if (specifier.importKind === 'type') continue + const importedName = getModuleExportName(specifier.imported) + const memberProperty = toMemberExpressionProperty(importedName) + replacements.push( + t.variableDeclaration('const', [ + t.variableDeclarator( + t.identifier(specifier.local.name), + t.memberExpression( + t.identifier(mockVar), + memberProperty.property, + memberProperty.computed, + ), + ), + ]), + ) + } + } + + ast.program.body.splice(i, 1, ...replacements) + modified = true + continue + } + + if (t.isExportNamedDeclaration(node) && node.source) { + if (node.exportKind === 'type') continue + if (!deniedSources.has(node.source.value)) continue + + const mockIndex = mockCounter++ + const mockVar = `__tss_deny_${mockIndex}` + const replacements: Array<t.Statement> = [] + + replacements.push( + t.importDeclaration( + [t.importDefaultSpecifier(t.identifier(mockVar))], + t.stringLiteral(getMockModuleId(node.source.value)), + ), + ) + const usedInternalVars = new Set<string>() + const exportSpecifiers: Array<{ + localName: string + exportedName: string + }> = [] + for (const specifier of node.specifiers) { + if (t.isExportSpecifier(specifier)) { + if (specifier.exportKind === 'type') continue + const localName = getModuleExportName(specifier.local) + const exportedName = getModuleExportName(specifier.exported) + const memberProperty = toMemberExpressionProperty(localName) + + const internalVar = createInternalReexportVarName( + localName, + mockIndex, + usedInternalVars, + ) + replacements.push( + t.variableDeclaration('const', [ + t.variableDeclarator( + t.identifier(internalVar), + t.memberExpression( + t.identifier(mockVar), + memberProperty.property, + memberProperty.computed, + ), + ), + ]), + ) + exportSpecifiers.push({ localName: internalVar, exportedName }) + } + } + + if (exportSpecifiers.length > 0) { + replacements.push( + t.exportNamedDeclaration( + null, + exportSpecifiers.map((s) => + t.exportSpecifier( + t.identifier(s.localName), + toModuleExportNameNode(s.exportedName), + ), + ), + ), + ) + } + + ast.program.body.splice(i, 1, ...replacements) + modified = true + continue + } + + if (t.isExportAllDeclaration(node)) { + if (node.exportKind === 'type') continue + if (!deniedSources.has(node.source.value)) continue + + ast.program.body.splice(i, 1) + modified = true + continue + } + } + + if (!modified) return undefined + + const result = generateFromAst(ast, { + sourceMaps: true, + sourceFileName: id, + filename: id, + }) + + return { + code: result.code, + ...(result.map ? { map: result.map as SourceMapLike } : {}), + } +} diff --git a/packages/start-plugin-core/src/import-protection-plugin/sourceLocation.ts b/packages/start-plugin-core/src/import-protection/sourceLocation.ts similarity index 72% rename from packages/start-plugin-core/src/import-protection-plugin/sourceLocation.ts rename to packages/start-plugin-core/src/import-protection/sourceLocation.ts index 5a0bef5350..ee346b327b 100644 --- a/packages/start-plugin-core/src/import-protection-plugin/sourceLocation.ts +++ b/packages/start-plugin-core/src/import-protection/sourceLocation.ts @@ -1,9 +1,15 @@ import { SourceMapConsumer } from 'source-map' import * as path from 'pathe' -import { findPostCompileUsagePos } from './postCompileUsage' +import { + findOriginalUnsafeUsagePosFromResult, + findPostCompileUsagePosFromResult, + getImportSpecifierLocationFromResult, +} from './analysis' import { getOrCreate, normalizeFilePath } from './utils' +import type { ImportAnalysis } from './analysis' import type { Loc } from './trace' +import type { ParseAstResult } from '@tanstack/router-utils' import type { RawSourceMap } from 'source-map' // Source-map type compatible with both Rollup's SourceMap and source-map's @@ -22,13 +28,23 @@ export interface SourceMapLike { mappings: string } +export interface ImportProtectionPerfRecorder { + count: (name: string, value?: number) => void + time: (name: string, startedAt: number) => void +} + // Transform result provider (replaces ctx.load() which doesn't work in dev) export interface TransformResult { code: string + filename?: string map: SourceMapLike | undefined originalCode: string | undefined + originalResult?: TransformResult /** Precomputed line index for `code` (index → line/col). */ lineIndex?: LineIndex + parsedAst?: ParseAstResult + analysis?: ImportAnalysis + perf?: ImportProtectionPerfRecorder } /** @@ -41,6 +57,10 @@ export interface TransformResultProvider { getTransformResult: (id: string) => TransformResult | undefined } +export interface ImportSpecifierLocationIndex { + find: FindImportSpecifierLocationIndex +} + // Index → line/column conversion export type LineIndex = { @@ -81,6 +101,42 @@ function indexToLineColWithIndex( return { line, column0: Math.max(0, idx - lineStart) } } +export function indexToLineColumn( + lineIndex: LineIndex, + idx: number, +): { line: number; column: number } { + const { line, column0 } = indexToLineColWithIndex(lineIndex, idx) + return { + line, + column: column0 + 1, + } +} + +export function normalizeSourceMap(map: SourceMapLike | null | undefined): + | { + version: number + file: string + sourceRoot?: string + sources: Array<string> + names: Array<string> + sourcesContent?: Array<string> + mappings: string + } + | undefined { + if (!map) { + return undefined + } + + return { + ...map, + version: Number(map.version), + file: map.file ?? '', + names: Array.isArray(map.names) ? map.names : [], + sourcesContent: + map.sourcesContent?.map((value) => value ?? '') ?? undefined, + } +} + /** * Pick the most-likely original source text for `importerFile` from * a sourcemap that may contain multiple sources. @@ -203,6 +259,25 @@ async function mapGeneratedToOriginal( const consumerCache = new WeakMap<object, Promise<SourceMapConsumer | null>>() +function getOriginalCode( + result: TransformResult, + importerFile: string | undefined, + root: string | undefined, +): string | undefined { + if (result.originalCode === undefined && importerFile && root) { + const map = result.map + if (map?.sourcesContent) { + result.originalCode = pickOriginalCodeFromSourcesContent( + map, + importerFile, + root, + ) + } + } + + return result.originalCode +} + function toRawSourceMap(map: SourceMapLike): RawSourceMap { return { ...map, @@ -271,7 +346,49 @@ export class ImportLocCache { } } -export type FindImportSpecifierIndex = (code: string, source: string) => number +export type FindImportSpecifierLocationIndex = ( + result: TransformResult, + source: string, +) => number + +export function getOrCreateOriginalTransformResult( + result: TransformResult, + importerFile?: string, + root?: string, +): TransformResult | undefined { + getOriginalCode(result, importerFile, root) + + if (!result.originalCode) { + return undefined + } + + if (!result.originalResult) { + result.originalResult = { + code: result.originalCode, + filename: result.filename, + map: undefined, + originalCode: result.originalCode, + } + + if (result.perf) { + result.originalResult.perf = result.perf + } + } + + return result.originalResult +} + +export function createImportSpecifierLocationIndex(): ImportSpecifierLocationIndex { + return { + find(result: TransformResult, source: string): number { + if (!result.code.includes(source)) { + return -1 + } + + return getImportSpecifierLocationFromResult(result, source) + }, + } +} /** * Find the location of an import statement in a transformed module @@ -283,7 +400,7 @@ export async function findImportStatementLocationFromTransformed( importerId: string, source: string, importLocCache: ImportLocCache, - findImportSpecifierIndex: FindImportSpecifierIndex, + findImportSpecifierLocationIndex: FindImportSpecifierLocationIndex, ): Promise<Loc | undefined> { const importerFile = normalizeFilePath(importerId) const cacheKey = `${importerFile}::${source}` @@ -298,11 +415,12 @@ export async function findImportStatementLocationFromTransformed( return undefined } - const { code, map } = res + const { map } = res - const lineIndex = res.lineIndex ?? buildLineIndex(code) + const lineIndex = + res.lineIndex ?? (res.lineIndex = buildLineIndex(res.code)) - const idx = findImportSpecifierIndex(code, source) + const idx = findImportSpecifierLocationIndex(res, source) if (idx === -1) { importLocCache.set(cacheKey, null) return undefined @@ -338,7 +456,7 @@ export async function findPostCompileUsageLocation( res.lineIndex = buildLineIndex(code) } - const pos = findPostCompileUsagePos(code, source) + const pos = findPostCompileUsagePosFromResult(res, source) if (!pos) return undefined return await mapGeneratedToOriginal(map, pos, importerFile) @@ -347,6 +465,44 @@ export async function findPostCompileUsageLocation( } } +/** + * Best-effort original-source usage lookup for cases where a later transform + * removes or rewrites the import from emitted code but preserves the original + * source in `sourcesContent`. + */ +export function findOriginalUsageLocation( + provider: TransformResultProvider, + importerId: string, + source: string, + envType?: 'client' | 'server', + root?: string, +): Loc | undefined { + try { + const importerFile = normalizeFilePath(importerId) + const res = provider.getTransformResult(importerId) + if (!res) return undefined + const originalResult = getOrCreateOriginalTransformResult( + res, + importerFile, + root, + ) + if (!originalResult) return undefined + + const pos = envType + ? findOriginalUnsafeUsagePosFromResult(originalResult, source, envType) + : findPostCompileUsagePosFromResult(originalResult, source) + if (!pos) return undefined + + return { + file: importerFile, + line: pos.line, + column: pos.column0 + 1, + } + } catch { + return undefined + } +} + /** * Annotate each trace hop with the location of the import that created the * edge (file:line:col). Skips steps that already have a location. @@ -360,7 +516,7 @@ export async function addTraceImportLocations( column?: number }>, importLocCache: ImportLocCache, - findImportSpecifierIndex: FindImportSpecifierIndex, + findImportSpecifierLocationIndex: FindImportSpecifierLocationIndex, ): Promise<void> { for (const step of trace) { if (!step.specifier) continue @@ -370,7 +526,7 @@ export async function addTraceImportLocations( step.file, step.specifier, importLocCache, - findImportSpecifierIndex, + findImportSpecifierLocationIndex, ) if (!loc) continue step.line = loc.line @@ -400,13 +556,14 @@ export function buildCodeSnippet( moduleId: string, loc: Loc, contextLines: number = 2, + root?: string, ): CodeSnippet | undefined { try { const importerFile = normalizeFilePath(moduleId) const res = provider.getTransformResult(moduleId) if (!res) return undefined - const sourceCode = res.originalCode ?? res.code + const sourceCode = getOriginalCode(res, importerFile, root) ?? res.code const targetLine = loc.line // 1-indexed const targetCol = loc.column // 1-indexed diff --git a/packages/start-plugin-core/src/import-protection-plugin/trace.ts b/packages/start-plugin-core/src/import-protection/trace.ts similarity index 99% rename from packages/start-plugin-core/src/import-protection-plugin/trace.ts rename to packages/start-plugin-core/src/import-protection/trace.ts index 053b98d2e0..d0c807ea03 100644 --- a/packages/start-plugin-core/src/import-protection-plugin/trace.ts +++ b/packages/start-plugin-core/src/import-protection/trace.ts @@ -166,7 +166,6 @@ export interface ViolationInfo { importerLoc?: Loc resolved?: string trace: Array<TraceStep> - message: string /** Vitest-style code snippet showing the offending usage in the leaf module. */ snippet?: { lines: Array<string> diff --git a/packages/start-plugin-core/src/import-protection-plugin/utils.ts b/packages/start-plugin-core/src/import-protection/utils.ts similarity index 85% rename from packages/start-plugin-core/src/import-protection-plugin/utils.ts rename to packages/start-plugin-core/src/import-protection/utils.ts index ee9f9acdaa..811539bd78 100644 --- a/packages/start-plugin-core/src/import-protection-plugin/utils.ts +++ b/packages/start-plugin-core/src/import-protection/utils.ts @@ -4,7 +4,7 @@ import { relative, resolve as resolvePath, } from 'node:path' -import { normalizePath } from 'vite' +import { normalizePath } from '../utils' import { IMPORT_PROTECTION_DEBUG, @@ -26,6 +26,41 @@ export function dedupePatterns(patterns: Array<Pattern>): Array<Pattern> { return out } +export interface FileMatchers { + files: Array<{ pattern: Pattern; test: (value: string) => boolean }> + excludeFiles: Array<{ pattern: Pattern; test: (value: string) => boolean }> +} + +export function isFileExcluded( + relativePath: string, + matchers: Pick<FileMatchers, 'excludeFiles'>, +): boolean { + return ( + matchers.excludeFiles.length > 0 && + matchers.excludeFiles.some((matcher) => matcher.test(relativePath)) + ) +} + +export function checkFileDenial( + relativePath: string, + matchers: FileMatchers, +): FileMatchers['files'][number] | undefined { + if (isFileExcluded(relativePath, matchers)) { + return undefined + } + + return matchers.files.find((matcher) => matcher.test(relativePath)) +} + +export function dedupeViolationKey(info: { + type: string + importer: string + specifier: string + resolved?: string +}): string { + return `${info.type}:${info.importer}:${info.specifier}:${info.resolved ?? ''}` +} + /** Strip both `?query` and `#hash` from a module ID. */ export function stripQueryAndHash(id: string): string { const q = id.indexOf('?') @@ -57,19 +92,6 @@ export function clearNormalizeFilePathCache(): void { normalizeFilePathCache.clear() } -/** - * Lightweight regex to extract all import/re-export source strings from - * post-transform code. Matches: - * - `from "..."` / `from '...'` (static import/export) - * - `import("...")` / `import('...')` (dynamic import) - */ -const importSourceRe = - /\bfrom\s+(?:"([^"]+)"|'([^']+)')|import\s*\(\s*(?:"([^"]+)"|'([^']+)')\s*\)/g - -export function escapeRegExp(s: string): string { - return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') -} - /** Get a value from a Map, creating it with `factory` if absent. */ export function getOrCreate<TKey, TValue>( map: Map<TKey, TValue>, @@ -93,17 +115,6 @@ export function relativizePath(p: string, root: string): string { return ch === 47 ? p.slice(root.length + 1) : p.slice(root.length) } -export function extractImportSources(code: string): Array<string> { - const sources: Array<string> = [] - let m: RegExpExecArray | null - importSourceRe.lastIndex = 0 - while ((m = importSourceRe.exec(code)) !== null) { - const src = m[1] ?? m[2] ?? m[3] ?? m[4] - if (src) sources.push(src) - } - return sources -} - /** Log import-protection debug output when debug mode is enabled. */ export function debugLog(...args: Array<unknown>): void { if (!IMPORT_PROTECTION_DEBUG) return diff --git a/packages/start-plugin-core/src/import-protection-plugin/virtualModules.ts b/packages/start-plugin-core/src/import-protection/virtualModules.ts similarity index 52% rename from packages/start-plugin-core/src/import-protection-plugin/virtualModules.ts rename to packages/start-plugin-core/src/import-protection/virtualModules.ts index de2e407a81..29b6878927 100644 --- a/packages/start-plugin-core/src/import-protection-plugin/virtualModules.ts +++ b/packages/start-plugin-core/src/import-protection/virtualModules.ts @@ -1,100 +1,15 @@ -import { resolveViteId } from '../utils' -import { VITE_ENVIRONMENT_NAMES } from '../constants' -import { isValidExportName } from './rewriteDeniedImports' +import { + MARKER_PREFIX, + MOCK_BUILD_PREFIX, + MOCK_EDGE_PREFIX, + MOCK_MODULE_ID, + MOCK_RUNTIME_PREFIX, +} from './constants' +import { isValidExportName } from './analysis' import { CLIENT_ENV_SUGGESTIONS } from './trace' -import { VITE_BROWSER_VIRTUAL_PREFIX } from './constants' import { relativizePath } from './utils' import type { ViolationInfo } from './trace' -export const MOCK_MODULE_ID = 'tanstack-start-import-protection:mock' -const RESOLVED_MOCK_MODULE_ID = resolveViteId(MOCK_MODULE_ID) - -/** - * Per-violation mock prefix used in build+error mode. - * Each deferred violation gets a unique ID so we can check which ones - * survived tree-shaking in `generateBundle`. - */ -export const MOCK_BUILD_PREFIX = 'tanstack-start-import-protection:mock:build:' -const RESOLVED_MOCK_BUILD_PREFIX = resolveViteId(MOCK_BUILD_PREFIX) - -export const MOCK_EDGE_PREFIX = 'tanstack-start-import-protection:mock-edge:' -const RESOLVED_MOCK_EDGE_PREFIX = resolveViteId(MOCK_EDGE_PREFIX) - -export const MOCK_RUNTIME_PREFIX = - 'tanstack-start-import-protection:mock-runtime:' -const RESOLVED_MOCK_RUNTIME_PREFIX = resolveViteId(MOCK_RUNTIME_PREFIX) - -const MARKER_PREFIX = 'tanstack-start-import-protection:marker:' -const RESOLVED_MARKER_PREFIX = resolveViteId(MARKER_PREFIX) - -const RESOLVED_MARKER_SERVER_ONLY = resolveViteId(`${MARKER_PREFIX}server-only`) -const RESOLVED_MARKER_CLIENT_ONLY = resolveViteId(`${MARKER_PREFIX}client-only`) - -export function resolvedMarkerVirtualModuleId( - kind: 'server' | 'client', -): string { - return kind === 'server' - ? RESOLVED_MARKER_SERVER_ONLY - : RESOLVED_MARKER_CLIENT_ONLY -} - -/** - * Convenience list for plugin `load` filters/handlers. - * - * Vite/Rollup call `load(id)` with the *resolved* virtual id (prefixed by `\0`). - * `resolveId(source)` sees the *unresolved* id/prefix (without `\0`). - */ -export function getResolvedVirtualModuleMatchers(): ReadonlyArray<string> { - return RESOLVED_VIRTUAL_MODULE_MATCHERS -} - -const RESOLVED_VIRTUAL_MODULE_MATCHERS = [ - RESOLVED_MOCK_MODULE_ID, - RESOLVED_MOCK_BUILD_PREFIX, - RESOLVED_MOCK_EDGE_PREFIX, - RESOLVED_MOCK_RUNTIME_PREFIX, - RESOLVED_MARKER_PREFIX, -] as const - -const RESOLVE_PREFIX_PAIRS = [ - [MOCK_EDGE_PREFIX, RESOLVED_MOCK_EDGE_PREFIX], - [MOCK_RUNTIME_PREFIX, RESOLVED_MOCK_RUNTIME_PREFIX], - [MOCK_BUILD_PREFIX, RESOLVED_MOCK_BUILD_PREFIX], - [MARKER_PREFIX, RESOLVED_MARKER_PREFIX], -] as const - -/** - * Resolve import-protection's internal virtual module IDs. - * - * `resolveId(source)` sees *unresolved* ids/prefixes (no `\0`). - * Returning a resolved id (with `\0`) ensures Vite/Rollup route it to `load`. - */ -export function resolveInternalVirtualModuleId( - source: string, -): string | undefined { - if (source.startsWith(VITE_BROWSER_VIRTUAL_PREFIX)) { - return resolveInternalVirtualModuleId( - `\0${source.slice(VITE_BROWSER_VIRTUAL_PREFIX.length)}`, - ) - } - - if (source === MOCK_MODULE_ID || source === RESOLVED_MOCK_MODULE_ID) { - return RESOLVED_MOCK_MODULE_ID - } - - for (const [unresolvedPrefix, resolvedPrefix] of RESOLVE_PREFIX_PAIRS) { - if (source.startsWith(unresolvedPrefix)) { - return resolveViteId(source) - } - - if (source.startsWith(resolvedPrefix)) { - return source - } - } - - return undefined -} - function toBase64Url(input: string): string { return Buffer.from(input, 'utf8').toString('base64url') } @@ -105,10 +20,6 @@ function fromBase64Url(input: string): string { type MockAccessMode = 'error' | 'warn' | 'off' -/** - * Compact runtime suggestion text for browser console, derived from - * {@link CLIENT_ENV_SUGGESTIONS} so there's a single source of truth. - */ export const RUNTIME_SUGGESTION_TEXT = 'Fix: ' + CLIENT_ENV_SUGGESTIONS.join('. ') + @@ -120,7 +31,7 @@ export function mockRuntimeModuleIdFromViolation( root: string, ): string { if (mode === 'off') return MOCK_MODULE_ID - if (info.env !== VITE_ENVIRONMENT_NAMES.client) return MOCK_MODULE_ID + if (info.env !== 'client') return MOCK_MODULE_ID const rel = (p: string) => relativizePath(p, root) const trace = info.trace.map((s) => { @@ -136,6 +47,7 @@ export function mockRuntimeModuleIdFromViolation( trace, mode, } + return `${MOCK_RUNTIME_PREFIX}${toBase64Url(JSON.stringify(payload))}` } @@ -147,17 +59,6 @@ export function makeMockEdgeModuleId( return `${MOCK_EDGE_PREFIX}${toBase64Url(JSON.stringify(payload))}` } -/** - * Generate a recursive Proxy-based mock module. - * - * When `diagnostics` is provided, the generated code includes a `__report` - * function that logs runtime warnings/errors when the mock is actually used - * (property access for primitive coercion, calls, construction, sets). - * - * When `diagnostics` is omitted, the mock is completely silent — suitable - * for base mock modules (e.g. `MOCK_MODULE_ID` or per-violation build mocks) - * that are consumed by mock-edge modules providing explicit named exports. - */ function generateMockCode(diagnostics?: { meta: { env: string @@ -203,22 +104,19 @@ function __report(action, accessPath) { ` : '' - // Diagnostic-only traps for primitive coercion, set - const diagGetTraps = hasDiag - ? ` + const primitiveGetTraps = ` if (prop === Symbol.toPrimitive) { return () => { - __report('toPrimitive', name); + ${hasDiag ? `__report('toPrimitive', name);` : ''} return '[import-protection mock]'; }; } if (prop === 'toString' || prop === 'valueOf' || prop === 'toJSON') { return () => { - __report(String(prop), name); + ${hasDiag ? `__report(String(prop), name);` : ''} return '[import-protection mock]'; }; }` - : '' const applyBody = hasDiag ? `__report('call', name + '()'); @@ -251,7 +149,7 @@ function ${fnName}(name) { if (prop === 'caller') return null; if (prop === 'then') return (f) => Promise.resolve(f(proxy)); if (prop === 'catch') return () => Promise.resolve(proxy); - if (prop === 'finally') return (f) => { f(); return Promise.resolve(proxy); };${diagGetTraps} + if (prop === 'finally') return (f) => { f(); return Promise.resolve(proxy); };${primitiveGetTraps} if (typeof prop === 'symbol') return undefined; if (!(prop in children)) { children[prop] = ${fnName}(name + '.' + prop); @@ -276,19 +174,10 @@ export function loadSilentMockModule(): { code: string } { return { code: generateMockCode() } } -/** - * Filter export names to valid, non-default names. - */ function filterExportNames(exports: ReadonlyArray<string>): Array<string> { return exports.filter((n) => n.length > 0 && n !== 'default') } -/** - * Generate ESM export lines that re-export named properties from `mock`. - * - * Produces `export const foo = mock.foo;` for valid identifiers and - * string-keyed re-exports for non-identifier names. - */ function generateExportLines(names: ReadonlyArray<string>): Array<string> { const lines: Array<string> = [] const stringExports: Array<{ alias: string; name: string }> = [] @@ -314,17 +203,6 @@ function generateExportLines(names: ReadonlyArray<string>): Array<string> { return lines } -/** - * Generate a self-contained mock module with explicit named exports. - * - * Used by the transform hook's "self-denial" check: when a denied file - * (e.g. `.server.ts` in the client environment) is transformed, its entire - * content is replaced with this mock module. This avoids returning virtual - * module IDs from `resolveId`, which prevents cross-environment cache - * contamination from third-party resolver plugins. - * - * The generated code is side-effect-free and tree-shakeable. - */ export function generateSelfContainedMockModule(exportNames: Array<string>): { code: string } { @@ -338,18 +216,6 @@ ${exportLines.join('\n')} } } -/** - * Generate a dev-mode mock module for self-denial transforms. - * - * Similar to `loadMockEdgeModule` but takes export names and a runtime ID - * directly (instead of parsing them from a base64url-encoded payload). - * Used by the transform hook when a denied file (e.g. `.server.ts` in - * the client environment) is replaced in dev mode. - * - * The generated module imports mock-runtime for runtime diagnostics - * (error/warn on property access) and re-exports explicit named exports - * so that `import { foo } from './denied.server'` works. - */ export function generateDevSelfDenialModule( exportNames: Array<string>, runtimeId: string, @@ -367,18 +233,18 @@ export default mock; export function loadMockEdgeModule(encodedPayload: string): { code: string } { let payload: { exports?: Array<string>; runtimeId?: string } + try { payload = JSON.parse(fromBase64Url(encodedPayload)) as typeof payload } catch { payload = { exports: [] } } - const names = filterExportNames(payload.exports ?? []) - const runtimeId: string = + const names = filterExportNames(payload.exports ?? []) + const runtimeId = typeof payload.runtimeId === 'string' && payload.runtimeId.length > 0 ? payload.runtimeId : MOCK_MODULE_ID - const exportLines = generateExportLines(names) return { @@ -399,6 +265,7 @@ export function loadMockRuntimeModule(encodedPayload: string): { specifier?: string trace?: Array<unknown> } + try { payload = JSON.parse(fromBase64Url(encodedPayload)) as typeof payload } catch { @@ -408,14 +275,17 @@ export function loadMockRuntimeModule(encodedPayload: string): { const mode: 'error' | 'warn' | 'off' = payload.mode === 'warn' || payload.mode === 'off' ? payload.mode : 'error' - const meta = { - env: String(payload.env ?? ''), - importer: String(payload.importer ?? ''), - specifier: String(payload.specifier ?? ''), - trace: Array.isArray(payload.trace) ? payload.trace : [], + return { + code: generateMockCode({ + meta: { + env: String(payload.env ?? ''), + importer: String(payload.importer ?? ''), + specifier: String(payload.specifier ?? ''), + trace: Array.isArray(payload.trace) ? payload.trace : [], + }, + mode, + }), } - - return { code: generateMockCode({ meta, mode }) } } const MARKER_MODULE_RESULT = { code: 'export {}' } as const @@ -424,29 +294,10 @@ export function loadMarkerModule(): { code: string } { return MARKER_MODULE_RESULT } -export function loadResolvedVirtualModule( - id: string, -): { code: string } | undefined { - if (id === RESOLVED_MOCK_MODULE_ID) { - return loadSilentMockModule() - } - - // Per-violation build mock modules — same silent mock code - if (id.startsWith(RESOLVED_MOCK_BUILD_PREFIX)) { - return loadSilentMockModule() - } - - if (id.startsWith(RESOLVED_MOCK_EDGE_PREFIX)) { - return loadMockEdgeModule(id.slice(RESOLVED_MOCK_EDGE_PREFIX.length)) - } - - if (id.startsWith(RESOLVED_MOCK_RUNTIME_PREFIX)) { - return loadMockRuntimeModule(id.slice(RESOLVED_MOCK_RUNTIME_PREFIX.length)) - } - - if (id.startsWith(RESOLVED_MARKER_PREFIX)) { - return loadMarkerModule() - } - - return undefined +export { + MARKER_PREFIX, + MOCK_BUILD_PREFIX, + MOCK_EDGE_PREFIX, + MOCK_MODULE_ID, + MOCK_RUNTIME_PREFIX, } diff --git a/packages/start-plugin-core/src/index.ts b/packages/start-plugin-core/src/index.ts index df946192ae..a6ee23a345 100644 --- a/packages/start-plugin-core/src/index.ts +++ b/packages/start-plugin-core/src/index.ts @@ -1,6 +1,8 @@ export type { TanStackStartInputConfig } from './schema' - -export { TanStackStartVitePluginCore } from './plugin' -export { resolveViteId } from './utils' - -export { VITE_ENVIRONMENT_NAMES } from './constants' +export type { + StartCompilerImportTransform, + StartCompilerTransformCandidate, + StartCompilerTransformContext, + TanStackStartCoreOptions, +} from './types' +export { START_ENVIRONMENT_NAMES } from './constants' diff --git a/packages/start-plugin-core/src/planning.ts b/packages/start-plugin-core/src/planning.ts new file mode 100644 index 0000000000..102a6df93c --- /dev/null +++ b/packages/start-plugin-core/src/planning.ts @@ -0,0 +1,151 @@ +import { joinPaths } from '@tanstack/router-core' +import { join } from 'pathe' +import { resolveEntry } from './resolve-entries' +import type { TanStackStartOutputConfig } from './schema' +import type { + NormalizedBasePaths, + NormalizedOutputDirectories, + TanStackStartCoreOptions, +} from './types' + +export interface ResolvedStartEntryPlan { + srcDirectory: string + startFilePath: string | undefined + routerFilePath: string + entryPaths: { + client: string + server: string + start: string + router: string + } +} + +export function normalizePublicBase(base: string | undefined): string { + const resolvedBase = base ?? '/' + + if (isFullUrl(resolvedBase)) { + return resolvedBase + } + + return joinPaths(['/', resolvedBase, '/']) +} + +export function deriveRouterBasepath(opts: { + configuredBasepath: string | undefined + publicBase: string +}): string { + if (opts.configuredBasepath !== undefined) { + return opts.configuredBasepath + } + + if (isFullUrl(opts.publicBase)) { + return '/' + } + + return opts.publicBase.replace(/^\/|\/$/g, '') +} + +export function shouldRewriteDevBasepath(opts: { + command: 'serve' | 'build' + middlewareMode: boolean | undefined + routerBasepath: string + publicBase: string +}): boolean { + if (opts.command !== 'serve' || opts.middlewareMode) { + return false + } + + return !joinPaths(['/', opts.routerBasepath, '/']).startsWith( + joinPaths(['/', opts.publicBase, '/']), + ) +} + +export function createNormalizedBasePaths(opts: { + publicBase: string +}): NormalizedBasePaths { + return { + publicBase: opts.publicBase, + assetBase: { + dev: opts.publicBase, + build: opts.publicBase, + }, + } +} + +export function createNormalizedOutputDirectories(opts: { + client: string + server: string +}): NormalizedOutputDirectories { + return { + client: opts.client, + server: opts.server, + } +} + +export function createServerFnBasePath(opts: { + routerBasepath: string + serverFnBase: string +}): string { + return joinPaths(['/', opts.routerBasepath, opts.serverFnBase, '/']) +} + +export function resolveStartEntryPlan(opts: { + root: string + startConfig: TanStackStartOutputConfig + defaultEntryPaths: TanStackStartCoreOptions['defaultEntryPaths'] +}): ResolvedStartEntryPlan { + const srcDirectory = join(opts.root, opts.startConfig.srcDirectory) + + const startFilePath = resolveEntry({ + type: 'start entry', + configuredEntry: opts.startConfig.start.entry, + defaultEntry: 'start', + resolvedSrcDirectory: srcDirectory, + required: false, + }) + + const routerFilePath = resolveEntry({ + type: 'router entry', + configuredEntry: opts.startConfig.router.entry, + defaultEntry: 'router', + resolvedSrcDirectory: srcDirectory, + required: true, + }) + + const clientEntryPath = resolveEntry({ + type: 'client entry', + configuredEntry: opts.startConfig.client.entry, + defaultEntry: 'client', + resolvedSrcDirectory: srcDirectory, + required: false, + }) + + const serverEntryPath = resolveEntry({ + type: 'server entry', + configuredEntry: opts.startConfig.server.entry, + defaultEntry: 'server', + resolvedSrcDirectory: srcDirectory, + required: false, + }) + + return { + srcDirectory, + startFilePath, + routerFilePath, + entryPaths: { + client: clientEntryPath ?? opts.defaultEntryPaths.client, + server: serverEntryPath ?? opts.defaultEntryPaths.server, + start: startFilePath ?? opts.defaultEntryPaths.start, + router: routerFilePath, + }, + } +} + +function isFullUrl(str: string): boolean { + try { + new URL(str) + return true + } catch { + return false + } +} diff --git a/packages/start-plugin-core/src/plugin.ts b/packages/start-plugin-core/src/plugin.ts deleted file mode 100644 index deec1ab199..0000000000 --- a/packages/start-plugin-core/src/plugin.ts +++ /dev/null @@ -1,471 +0,0 @@ -import { joinPaths } from '@tanstack/router-core' -import * as vite from 'vite' -import { crawlFrameworkPkgs } from 'vitefu' -import { join } from 'pathe' -import { escapePath } from 'tinyglobby' -import { startManifestPlugin } from './start-manifest-plugin/plugin' -import { ENTRY_POINTS, VITE_ENVIRONMENT_NAMES } from './constants' -import { getBundlerOptions } from './utils' -import { tanStackStartRouter } from './start-router-plugin/plugin' -import { loadEnvPlugin } from './load-env-plugin/plugin' -import { devServerPlugin } from './dev-server-plugin/plugin' -import { previewServerPlugin } from './preview-server-plugin/plugin' -import { parseStartConfig } from './schema' -import { resolveEntry } from './resolve-entries' -import { - getClientOutputDirectory, - getServerOutputDirectory, -} from './output-directory' -import { postServerBuild } from './post-server-build' -import { startCompilerPlugin } from './start-compiler-plugin/plugin' -import { importProtectionPlugin } from './import-protection-plugin/plugin' -import type { - GetConfigFn, - ResolvedStartConfig, - TanStackStartVitePluginCoreOptions, -} from './types' -import type { ViteEnvironmentNames } from './constants' -import type { - TanStackStartInputConfig, - TanStackStartOutputConfig, -} from './schema' -import type { PluginOption } from 'vite' - -function isFullUrl(str: string): boolean { - try { - new URL(str) - return true - } catch { - return false - } -} - -export function TanStackStartVitePluginCore( - corePluginOpts: TanStackStartVitePluginCoreOptions, - startPluginOpts: TanStackStartInputConfig, -): Array<PluginOption> { - // Determine the provider environment for server functions - // If providerEnv is set, use that; otherwise default to SSR as the provider - const serverFnProviderEnv = - corePluginOpts.serverFn?.providerEnv || VITE_ENVIRONMENT_NAMES.server - const ssrIsProvider = serverFnProviderEnv === VITE_ENVIRONMENT_NAMES.server - - const resolvedStartConfig: ResolvedStartConfig = { - root: '', - startFilePath: undefined, - routerFilePath: '', - srcDirectory: '', - viteAppBase: '', - serverFnProviderEnv, - } - - let startConfig: TanStackStartOutputConfig | null - const getConfig: GetConfigFn = () => { - if (!resolvedStartConfig.root) { - throw new Error(`Cannot get config before root is resolved`) - } - if (!startConfig) { - startConfig = parseStartConfig( - startPluginOpts, - corePluginOpts, - resolvedStartConfig.root, - ) - } - return { startConfig, resolvedStartConfig, corePluginOpts } - } - - // When the router basepath and vite base are misaligned during dev, - // we install a URL rewrite middleware instead of erroring. - let needsDevBaseRewrite = false - - const capturedBundle: Partial< - Record<ViteEnvironmentNames, vite.Rollup.OutputBundle> - > = {} - - function getBundle(envName: ViteEnvironmentNames): vite.Rollup.OutputBundle { - const bundle = capturedBundle[envName] - if (!bundle) { - throw new Error(`No bundle captured for environment: ${envName}`) - } - return bundle - } - - const environments: Array<{ name: string; type: 'client' | 'server' }> = [ - { name: VITE_ENVIRONMENT_NAMES.client, type: 'client' }, - { name: VITE_ENVIRONMENT_NAMES.server, type: 'server' }, - ] - if ( - corePluginOpts.serverFn?.providerEnv && - !environments.find((e) => e.name === corePluginOpts.serverFn?.providerEnv) - ) { - environments.push({ - name: corePluginOpts.serverFn.providerEnv, - type: 'server', - }) - } - return [ - { - name: 'tanstack-start-core:config', - enforce: 'pre', - async config(viteConfig, { command }) { - resolvedStartConfig.viteAppBase = viteConfig.base ?? '/' - if (!isFullUrl(resolvedStartConfig.viteAppBase)) { - resolvedStartConfig.viteAppBase = joinPaths([ - '/', - viteConfig.base, - '/', - ]) - } - const root = viteConfig.root || process.cwd() - resolvedStartConfig.root = root - - const { startConfig } = getConfig() - if (startConfig.router.basepath === undefined) { - if (!isFullUrl(resolvedStartConfig.viteAppBase)) { - startConfig.router.basepath = - resolvedStartConfig.viteAppBase.replace(/^\/|\/$/g, '') - } else { - startConfig.router.basepath = '/' - } - } else { - if (command === 'serve' && !viteConfig.server?.middlewareMode) { - // when serving, we must ensure that router basepath and viteAppBase are aligned - if ( - !joinPaths(['/', startConfig.router.basepath, '/']).startsWith( - joinPaths(['/', resolvedStartConfig.viteAppBase, '/']), - ) - ) { - // The router basepath and vite base are misaligned. - // Instead of erroring, we install a dev-server middleware that - // rewrites incoming request URLs to prepend the vite base prefix. - // This allows users to have e.g. base: '/_ui/' for asset URLs - // while keeping router basepath at '/' for page navigation. - needsDevBaseRewrite = true - } - } - } - - const TSS_SERVER_FN_BASE = joinPaths([ - '/', - startConfig.router.basepath, - startConfig.serverFns.base, - '/', - ]) - const resolvedSrcDirectory = join(root, startConfig.srcDirectory) - resolvedStartConfig.srcDirectory = resolvedSrcDirectory - - const startFilePath = resolveEntry({ - type: 'start entry', - configuredEntry: startConfig.start.entry, - defaultEntry: 'start', - resolvedSrcDirectory, - required: false, - }) - resolvedStartConfig.startFilePath = startFilePath - - const routerFilePath = resolveEntry({ - type: 'router entry', - configuredEntry: startConfig.router.entry, - defaultEntry: 'router', - resolvedSrcDirectory, - required: true, - }) - resolvedStartConfig.routerFilePath = routerFilePath - - const clientEntryPath = resolveEntry({ - type: 'client entry', - configuredEntry: startConfig.client.entry, - defaultEntry: 'client', - resolvedSrcDirectory, - required: false, - }) - - const serverEntryPath = resolveEntry({ - type: 'server entry', - configuredEntry: startConfig.server.entry, - defaultEntry: 'server', - resolvedSrcDirectory, - required: false, - }) - - const clientAlias = vite.normalizePath( - clientEntryPath ?? corePluginOpts.defaultEntryPaths.client, - ) - const serverAlias = vite.normalizePath( - serverEntryPath ?? corePluginOpts.defaultEntryPaths.server, - ) - const startAlias = vite.normalizePath( - startFilePath ?? corePluginOpts.defaultEntryPaths.start, - ) - const routerAlias = vite.normalizePath(routerFilePath) - - const entryAliasConfiguration: Record< - (typeof ENTRY_POINTS)[keyof typeof ENTRY_POINTS], - string - > = { - [ENTRY_POINTS.client]: clientAlias, - [ENTRY_POINTS.server]: serverAlias, - [ENTRY_POINTS.start]: startAlias, - [ENTRY_POINTS.router]: routerAlias, - } - - const startPackageName = - `@tanstack/${corePluginOpts.framework}-start` as const - - // crawl packages that have start in "peerDependencies" - // see https://github.com/svitejs/vitefu/blob/d8d82fa121e3b2215ba437107093c77bde51b63b/src/index.js#L95-L101 - - // this is currently uncached; could be implemented similarly as vite handles lock file changes - // see https://github.com/vitejs/vite/blob/557f797d29422027e8c451ca50dd84bf8c41b5f0/packages/vite/src/node/optimizer/index.ts#L1282 - - const crawlFrameworkPkgsResult = await crawlFrameworkPkgs({ - root: process.cwd(), - isBuild: command === 'build', - isFrameworkPkgByJson(pkgJson) { - const peerDependencies = pkgJson['peerDependencies'] - - if (peerDependencies) { - if ( - startPackageName in peerDependencies || - '@tanstack/start-client-core' in peerDependencies - ) { - return true - } - } - - return false - }, - }) - - return { - // see https://vite.dev/config/shared-options.html#apptype - // this will prevent vite from injecting middlewares that we don't want - appType: viteConfig.appType ?? 'custom', - environments: { - [VITE_ENVIRONMENT_NAMES.client]: { - consumer: 'client', - build: (() => { - // Use the same object reference for both keys to avoid - // Vite 8's deprecation warning when both are present. - // Vite 7 reads rollupOptions, Vite 8 reads rolldownOptions. - const bundlerOptions = { - input: { - main: ENTRY_POINTS.client, - }, - } - return { - rollupOptions: bundlerOptions, - rolldownOptions: bundlerOptions, - outDir: getClientOutputDirectory(viteConfig), - } - })(), - optimizeDeps: { - exclude: crawlFrameworkPkgsResult.optimizeDeps.exclude, - // Ensure user code can be crawled for dependencies - entries: [clientAlias, routerAlias].map((entry) => - // Entries are treated as `tinyglobby` patterns so need to be escaped - escapePath(entry), - ), - }, - }, - [VITE_ENVIRONMENT_NAMES.server]: { - consumer: 'server', - build: { - ssr: true, - ...(() => { - const bundlerOptions = { - input: - getBundlerOptions( - viteConfig.environments?.[VITE_ENVIRONMENT_NAMES.server] - ?.build, - )?.input ?? serverAlias, - } - return { - rollupOptions: bundlerOptions, - rolldownOptions: bundlerOptions, - } - })(), - outDir: getServerOutputDirectory(viteConfig), - commonjsOptions: { - include: [/node_modules/], - }, - copyPublicDir: - viteConfig.environments?.[VITE_ENVIRONMENT_NAMES.server] - ?.build?.copyPublicDir ?? false, - }, - optimizeDeps: { - // Ensure user code can be crawled for dependencies - entries: [serverAlias, startAlias, routerAlias].map((entry) => - // Entries are treated as `tinyglobby` patterns so need to be escaped - escapePath(entry), - ), - }, - }, - }, - - resolve: { - noExternal: [ - // ENTRY_POINTS.start, - '@tanstack/start**', - `@tanstack/${corePluginOpts.framework}-start**`, - ...crawlFrameworkPkgsResult.ssr.noExternal.sort(), - ], - alias: { - ...entryAliasConfiguration, - }, - }, - /* prettier-ignore */ - define: { - // define is an esbuild function that replaces the any instances of given keys with the given values - // i.e: __FRAMEWORK_NAME__ can be replaced with JSON.stringify("TanStack Start") - // This is not the same as injecting environment variables. - - ...defineReplaceEnv('TSS_SERVER_FN_BASE', TSS_SERVER_FN_BASE), - ...defineReplaceEnv('TSS_ROUTER_BASEPATH', startConfig.router.basepath), - ...(command === 'serve' ? defineReplaceEnv('TSS_SHELL', startConfig.spa?.enabled ? 'true' : 'false') : {}), - ...defineReplaceEnv('TSS_DEV_SERVER', command === 'serve' ? 'true' : 'false'), - // Dev SSR styles: enabled flag and basepath (defaults to vite base for asset URL alignment) - ...defineReplaceEnv('TSS_DEV_SSR_STYLES_ENABLED', startConfig.dev.ssrStyles.enabled ? 'true' : 'false'), - ...defineReplaceEnv('TSS_DEV_SSR_STYLES_BASEPATH', startConfig.dev.ssrStyles.basepath ?? resolvedStartConfig.viteAppBase), - // Replace NODE_ENV during build (unless opted out) for dead code elimination in server bundles - ...(command === 'build' && startConfig.server.build.staticNodeEnv ? { - 'process.env.NODE_ENV': JSON.stringify(process.env.NODE_ENV || viteConfig.mode || 'production'), - } : {}), - }, - builder: { - sharedPlugins: true, - async buildApp(builder) { - const client = builder.environments[VITE_ENVIRONMENT_NAMES.client] - const server = builder.environments[VITE_ENVIRONMENT_NAMES.server] - - if (!client) { - throw new Error('Client environment not found') - } - - if (!server) { - throw new Error('SSR environment not found') - } - - if (!client.isBuilt) { - // Build the client bundle first - await builder.build(client) - } - if (!server.isBuilt) { - // Build the SSR bundle - await builder.build(server) - } - - // If a custom provider environment is configured (not SSR), - // build it last so the manifest includes functions from all environments - if (!ssrIsProvider) { - const providerEnv = builder.environments[serverFnProviderEnv] - if (!providerEnv) { - throw new Error( - `Provider environment "${serverFnProviderEnv}" not found`, - ) - } - if (!providerEnv.isBuilt) { - // Build the provider environment last - // This ensures all server functions are discovered from client/ssr builds - await builder.build(providerEnv) - } - } - }, - }, - } - }, - }, - // Separate plugin for buildApp hook with enforce: 'post' - // This ensures proper ordering with other plugins that also have - // buildApp hooks with order: 'post'. The enforce: 'post' ensures this - // runs after other plugins (like Nitro) complete their builds. - { - name: 'tanstack-start-core:post-build', - enforce: 'post', - buildApp: { - order: 'post', - async handler(builder) { - const { startConfig } = getConfig() - await postServerBuild({ builder, startConfig }) - }, - }, - }, - // Server function plugin handles: - // 1. Identifying createServerFn().handler() calls - // 2. Extracting server functions to separate modules - // 3. Replacing call sites with RPC stubs - // 4. Generating the server function manifest - // Also handles createIsomorphicFn, createServerOnlyFn, createClientOnlyFn, createMiddleware - startCompilerPlugin({ - framework: corePluginOpts.framework, - environments, - generateFunctionId: startPluginOpts?.serverFns?.generateFunctionId, - providerEnvName: serverFnProviderEnv, - }), - importProtectionPlugin({ - getConfig, - framework: corePluginOpts.framework, - environments, - providerEnvName: serverFnProviderEnv, - }), - tanStackStartRouter(startPluginOpts, getConfig, corePluginOpts), - loadEnvPlugin(), - startManifestPlugin({ - getClientBundle: () => getBundle(VITE_ENVIRONMENT_NAMES.client), - getConfig, - }), - // When the vite base and router basepath are misaligned (e.g. base: '/_ui/', basepath: '/'), - // install a middleware that rewrites incoming request URLs to prepend the vite base prefix. - // This allows Vite's internal base middleware to accept the requests, then strips the prefix - // before passing to the SSR handler. - // Registered BEFORE devServerPlugin so this middleware is added to the Connect stack first, - // ensuring all subsequent middlewares (CSS, SSR, etc.) see the rewritten URL. - { - name: 'tanstack-start-core:dev-base-rewrite', - configureServer(server) { - if (!needsDevBaseRewrite) { - return - } - const basePrefix = resolvedStartConfig.viteAppBase.replace(/\/$/, '') - server.middlewares.use((req, _res, next) => { - if (req.url && !req.url.startsWith(basePrefix)) { - req.url = basePrefix + req.url - } - next() - }) - }, - }, - devServerPlugin({ - getConfig, - devSsrStylesEnabled: startPluginOpts?.dev?.ssrStyles?.enabled ?? true, - }), - previewServerPlugin(), - { - name: 'tanstack-start:core:capture-bundle', - applyToEnvironment(e) { - return ( - e.name === VITE_ENVIRONMENT_NAMES.client || - e.name === VITE_ENVIRONMENT_NAMES.server - ) - }, - enforce: 'post', - generateBundle(_options, bundle) { - const environment = this.environment.name as ViteEnvironmentNames - if (!Object.values(VITE_ENVIRONMENT_NAMES).includes(environment)) { - throw new Error(`Unknown environment: ${environment}`) - } - capturedBundle[environment] = bundle - }, - }, - ] -} - -function defineReplaceEnv<TKey extends string, TValue extends string>( - key: TKey, - value: TValue, -): { [P in `process.env.${TKey}` | `import.meta.env.${TKey}`]: TValue } { - return { - [`process.env.${key}`]: JSON.stringify(value), - [`import.meta.env.${key}`]: JSON.stringify(value), - } as { [P in `process.env.${TKey}` | `import.meta.env.${TKey}`]: TValue } -} diff --git a/packages/start-plugin-core/src/post-server-build.ts b/packages/start-plugin-core/src/post-build.ts similarity index 62% rename from packages/start-plugin-core/src/post-server-build.ts rename to packages/start-plugin-core/src/post-build.ts index 478b2ef210..966cdd38cc 100644 --- a/packages/start-plugin-core/src/post-server-build.ts +++ b/packages/start-plugin-core/src/post-build.ts @@ -1,20 +1,19 @@ import { HEADERS } from '@tanstack/start-server-core' import { buildSitemap } from './build-sitemap' -import { VITE_ENVIRONMENT_NAMES } from './constants' -import { prerender } from './prerender' import type { TanStackStartOutputConfig } from './schema' -import type { ViteBuilder } from 'vite' -export async function postServerBuild({ - builder, +export interface StartPostBuildAdapter { + getClientOutputDirectory: () => string + prerender: (startConfig: TanStackStartOutputConfig) => Promise<void> +} + +export async function postBuild({ startConfig, + adapter, }: { - builder: ViteBuilder startConfig: TanStackStartOutputConfig + adapter: StartPostBuildAdapter }) { - // If the user has not set a prerender option, we need to set it to true - // if the pages array is not empty and has sub options requiring for prerendering - // If the user has explicitly set prerender.enabled, this should be respected if (startConfig.prerender?.enabled !== false) { startConfig.prerender = { ...startConfig.prerender, @@ -26,7 +25,6 @@ export async function postServerBuild({ } } - // Setup the options for prerendering the SPA shell (i.e `src/routes/__root.tsx`) if (startConfig.spa?.enabled) { startConfig.prerender = { ...startConfig.prerender, @@ -53,21 +51,14 @@ export async function postServerBuild({ }) } - // Run the prerendering process if (startConfig.prerender.enabled) { - await prerender({ - startConfig, - builder, - }) + await adapter.prerender(startConfig) } - // Run the sitemap build process if (startConfig.sitemap?.enabled) { buildSitemap({ startConfig, - publicDir: - builder.environments[VITE_ENVIRONMENT_NAMES.client]?.config.build - .outDir ?? builder.config.build.outDir, + publicDir: adapter.getClientOutputDirectory(), }) } } diff --git a/packages/start-plugin-core/src/prerender.ts b/packages/start-plugin-core/src/prerender.ts index af68e5167a..2fbd9e74b9 100644 --- a/packages/start-plugin-core/src/prerender.ts +++ b/packages/start-plugin-core/src/prerender.ts @@ -2,29 +2,32 @@ import { promises as fsp } from 'node:fs' import os from 'node:os' import path from 'pathe' import { joinURL, withBase, withTrailingSlash, withoutBase } from 'ufo' -import { VITE_ENVIRONMENT_NAMES } from './constants' import { createLogger } from './utils' import { Queue } from './queue' -import type { PreviewServer, ResolvedConfig, ViteBuilder } from 'vite' import type { Page, TanStackStartOutputConfig } from './schema' +const DEFAULT_RETRY_DELAY = 500 + +export interface PrerenderHandler { + getClientOutputDirectory: () => string + request: (path: string, options?: RequestInit) => Promise<Response> + close?: () => Promise<void> +} + export async function prerender({ startConfig, - builder, + handler, }: { startConfig: TanStackStartOutputConfig - builder: ViteBuilder + handler: PrerenderHandler }) { const logger = createLogger('prerender') logger.info('Prerendering pages...') - // If prerender is enabled if (startConfig.prerender?.enabled) { - // default to root page if no pages are defined let pages = startConfig.pages.length ? startConfig.pages : [{ path: '/' }] if (startConfig.prerender.autoStaticPathsDiscovery ?? true) { - // merge discovered static pages with user-defined pages const pagesMap = new Map(pages.map((item) => [item.path, item])) const discoveredPages = globalThis.TSS_PRERENDABLE_PATHS || [] @@ -43,64 +46,15 @@ export async function prerender({ const routerBasePath = joinURL('/', startConfig.router.basepath ?? '') const routerBaseUrl = new URL(routerBasePath, 'http://localhost') - // Enforce that prerender page paths are relative/path-based (no protocol/host) startConfig.pages = validateAndNormalizePrerenderPages( startConfig.pages, routerBaseUrl, ) - const serverEnv = builder.environments[VITE_ENVIRONMENT_NAMES.server] - - if (!serverEnv) { - throw new Error( - `Vite's "${VITE_ENVIRONMENT_NAMES.server}" environment not found`, - ) - } - - const clientEnv = builder.environments[VITE_ENVIRONMENT_NAMES.client] - if (!clientEnv) { - throw new Error( - `Vite's "${VITE_ENVIRONMENT_NAMES.client}" environment not found`, - ) - } - - const outputDir = clientEnv.config.build.outDir - - process.env.TSS_PRERENDERING = 'true' - process.env.TSS_CLIENT_OUTPUT_DIR = outputDir - - // Start Vite preview server instead of importing module - const previewServer = await startPreviewServer(serverEnv.config) - const baseUrl = getResolvedUrl(previewServer) - - const isRedirectResponse = (res: Response) => { - return res.status >= 300 && res.status < 400 && res.headers.get('location') - } - async function localFetch( - path: string, - options?: RequestInit, - maxRedirects: number = 5, - ): Promise<Response> { - const url = new URL(path, baseUrl) - const request = new Request(url, options) - const response = await fetch(request) - - if (isRedirectResponse(response) && maxRedirects > 0) { - const location = response.headers.get('location')! - if (location.startsWith('http://localhost') || location.startsWith('/')) { - const newUrl = location.replace('http://localhost', '') - return localFetch(newUrl, options, maxRedirects - 1) - } else { - logger.warn(`Skipping redirect to external location: ${location}`) - } - } - - return response - } - try { - // Crawl all pages - const pages = await prerenderPages({ outputDir }) + const pages = await prerenderPages({ + outputDir: handler.getClientOutputDirectory(), + }) logger.info(`Prerendered ${pages.length} pages:`) pages.forEach((page) => { @@ -108,14 +62,15 @@ export async function prerender({ }) } catch (error) { logger.error(error) + throw error } finally { - await previewServer.close() + await handler.close?.() } function extractLinks(html: string): Array<string> { const linkRegex = /<a[^>]+href=["']([^"']+)["'][^>]*>/g const links: Array<string> = [] - let match + let match: RegExpExecArray | null while ((match = linkRegex.exec(html)) !== null) { const href = match[1] @@ -135,9 +90,8 @@ export async function prerender({ logger.info(`Concurrency: ${concurrency}`) const queue = new Queue({ concurrency }) const routerBasePath = joinURL('/', startConfig.router.basepath ?? '') - - // Normalize discovered pages and enforce path-only entries const routerBaseUrl = new URL(routerBasePath, 'http://localhost') + startConfig.pages = validateAndNormalizePrerenderPages( startConfig.pages, routerBaseUrl, @@ -155,37 +109,34 @@ export async function prerender({ return Array.from(prerendered) function addCrawlPageTask(page: Page) { - // Was the page already seen? if (seen.has(page.path)) return - // Add the page to the seen set seen.add(page.path) if (page.fromCrawl) { startConfig.pages.push(page) } - // If not enabled, skip if (!(page.prerender?.enabled ?? true)) return - // If there is a filter link, check if the page should be prerendered - if (startConfig.prerender?.filter && !startConfig.prerender.filter(page)) + if ( + startConfig.prerender?.filter && + !startConfig.prerender.filter(page) + ) { return + } - // Resolve the merged default and page-specific prerender options const prerenderOptions = { ...startConfig.prerender, ...page.prerender, } - // Add the task queue.add(async () => { logger.info(`Crawling: ${page.path}`) const retries = retriesByPath.get(page.path) || 0 - try { - // Fetch the route - const res = await localFetch( + try { + const res = await requestWithRedirects( withTrailingSlash(withBase(page.path, routerBasePath)), { headers: { @@ -199,6 +150,7 @@ export async function prerender({ if (isRedirectResponse(res)) { logger.warn(`Max redirects reached for ${page.path}`) } + throw new Error(`Failed to fetch ${page.path}: ${res.statusText}`, { cause: res, }) @@ -208,7 +160,6 @@ export async function prerender({ prerenderOptions.outputPath || page.path ).split(/[?#]/)[0]! - // Guess route type and populate fileName const contentType = res.headers.get('content-type') || '' const isImplicitHTML = !cleanPagePath.endsWith('.html') && contentType.includes('html') @@ -222,17 +173,14 @@ export async function prerender({ let htmlPath: string if (isSpaShell) { - // For SPA shell, ignore autoSubfolderIndex option htmlPath = cleanPagePath + '.html' + } else if ( + cleanPagePath.endsWith('/') || + (prerenderOptions.autoSubfolderIndex ?? true) + ) { + htmlPath = joinURL(cleanPagePath, 'index.html') } else { - if ( - cleanPagePath.endsWith('/') || - (prerenderOptions.autoSubfolderIndex ?? true) - ) { - htmlPath = joinURL(cleanPagePath, 'index.html') - } else { - htmlPath = cleanPagePath + '.html' - } + htmlPath = cleanPagePath + '.html' } const filename = withoutBase( @@ -241,7 +189,6 @@ export async function prerender({ ) const html = await res.text() - const filepath = path.join(outputDir, filename) await fsp.mkdir(path.dirname(filepath), { @@ -258,7 +205,6 @@ export async function prerender({ Object.assign(page, newPage) } - // Find new links if (prerenderOptions.crawlLinks ?? true) { const links = extractLinks(html) for (const link of links) { @@ -267,62 +213,58 @@ export async function prerender({ } } catch (error) { if (retries < (prerenderOptions.retryCount ?? 0)) { - logger.warn(`Encountered error, retrying: ${page.path} in 500ms`) - await new Promise((resolve) => - setTimeout(resolve, prerenderOptions.retryDelay), + const retryDelay = normalizeRetryDelay(prerenderOptions.retryDelay) + logger.warn( + `Encountered error, retrying: ${page.path} in ${retryDelay}ms`, ) + await new Promise((resolve) => setTimeout(resolve, retryDelay)) retriesByPath.set(page.path, retries + 1) addCrawlPageTask(page) - } else { - if (prerenderOptions.failOnError ?? true) { - throw error - } + } else if (prerenderOptions.failOnError ?? true) { + throw error } } }) } } -} -async function startPreviewServer( - viteConfig: ResolvedConfig, -): Promise<PreviewServer> { - const vite = await import('vite') + function normalizeRetryDelay(value: number | undefined): number { + const retryDelay = Number(value) - try { - return await vite.preview({ - configFile: viteConfig.configFile, - preview: { - port: 0, - open: false, - }, - }) - } catch (error) { - throw new Error( - 'Failed to start the Vite preview server for prerendering', - { - cause: error, - }, - ) + if (!Number.isFinite(retryDelay) || retryDelay < 0) { + return DEFAULT_RETRY_DELAY + } + + return Math.trunc(retryDelay) + } + + async function requestWithRedirects( + path: string, + options?: RequestInit, + maxRedirects: number = 5, + ): Promise<Response> { + const response = await handler.request(path, options) + + if (isRedirectResponse(response) && maxRedirects > 0) { + const location = response.headers.get('location')! + + if (location.startsWith('http://localhost') || location.startsWith('/')) { + const nextPath = location.replace('http://localhost', '') + return requestWithRedirects(nextPath, options, maxRedirects - 1) + } + + logger.warn(`Skipping redirect to external location: ${location}`) + } + + return response } } -function getResolvedUrl(previewServer: PreviewServer): URL { - const baseUrl = previewServer.resolvedUrls?.local[0] - - if (!baseUrl) { - throw new Error('No resolved URL is available from the Vite preview server') - } - - return new URL(baseUrl) +function isRedirectResponse(res: Response) { + return res.status >= 300 && res.status < 400 && res.headers.get('location') } -/** - * Validates and normalizes prerender page paths to ensure they are relative - * (no protocol/host) and returns normalized Page objects with cleaned paths. - * Preserves unicode characters by decoding the pathname after URL validation. - */ -function validateAndNormalizePrerenderPages( +export function validateAndNormalizePrerenderPages( pages: Array<Page>, routerBaseUrl: URL, ): Array<Page> { @@ -340,9 +282,6 @@ function validateAndNormalizePrerenderPages( throw new Error(`prerender page path must be relative: ${page.path}`) } - // Decode the pathname to preserve unicode characters (e.g., /대한민국) - // The URL constructor encodes non-ASCII characters, but we want to keep - // the original unicode form for filesystem paths const decodedPathname = decodeURIComponent(url.pathname) return { diff --git a/packages/start-plugin-core/src/rsbuild/COMPILER_ARCHITECTURE.md b/packages/start-plugin-core/src/rsbuild/COMPILER_ARCHITECTURE.md new file mode 100644 index 0000000000..a97c500b0d --- /dev/null +++ b/packages/start-plugin-core/src/rsbuild/COMPILER_ARCHITECTURE.md @@ -0,0 +1,199 @@ +# Rsbuild Compiler Architecture + +This document explains the TanStack Start compiler integration for Rsbuild and Rspack. It focuses on server-function discovery, Rspack cache interaction, and the resolver virtual module. + +## Goals + +The Rsbuild integration has to do three things at the same time: + +- Compile Start-specific source patterns such as server functions, isomorphic functions, middleware, and compiler virtual modules. +- Keep server-function metadata available when Rspack restores modules from its persistent cache and skips transforms. +- Generate the `#tanstack-start-server-fn-resolver` virtual module after the server-function registry is complete for the current compilation. + +The important point is that server-function discovery is a side effect of compilation. If Rspack restores a transformed module from persistent cache, the transform side effect does not run. We therefore store the discovered metadata on the Rspack module itself and replay it from `module.buildInfo`. + +## Main Files + +- `plugin.ts` wires the Rsbuild plugin phases, virtual modules, RSC hooks, compiler ordering, and resolver rebuild hooks. +- `start-compiler-host.ts` registers the Start compiler transforms, captures server-function metadata, writes metadata to Rspack `buildInfo`, and replays cached metadata. +- `start-compiler-metadata.ts` defines the string keys and types used by the metadata loader. +- `start-compiler-metadata-loader.ts` is the real Rspack loader that writes server-function metadata to the current module's `buildInfo`. +- `virtual-modules.ts` owns the resolver virtual module and writes updated virtual module content per Rsbuild environment. +- `../start-compiler/handleCreateServerFn.ts` discovers server functions while compiling caller modules. +- `../start-compiler/server-fn-resolver-module.ts` generates the resolver module from the current server-function registry. + +## Environments + +Start registers compiler work for each Rsbuild environment that can affect server-function metadata: + +- `client` discovers functions referenced from browser code and marks them client-accessible. +- `ssr` discovers functions reachable from the server-rendered route graph. +- A separate provider environment is included when server-function providers are not compiled in `ssr` and RSC is not enabled. + +The shared registry is `serverFnsById`. It is passed to `virtual-modules.ts`, which uses it to generate resolver module content. + +## Cold Transform Path + +`registerStartCompilerTransforms()` registers an `api.transform({ order: 'pre' })` transform for each Start compiler environment. + +When a matching module is compiled normally: + +1. Rsbuild runs the Start transform in the pre-loader phase. +2. The transform checks compiler virtual modules first. +3. It runs cheap code filters to skip files that cannot contain Start compiler patterns. +4. It lazily creates one `StartCompiler` per environment. +5. It detects which compiler features are present in the current code. +6. It serializes access to the per-environment `StartCompiler` through `runCompilerTask()`. +7. It calls `compiler.compile({ id, code, detectedKinds })`. +8. During compile, `handleCreateServerFn()` reports discovered server functions through `onServerFnsById`. +9. The transform stores the discovered server functions for this module in the environment's pending metadata map. + +The module ID used for transform metadata is `ctx.resource`. The metadata loader later reads `this.resource`. Using the same Rspack resource string keeps the handoff stable across resource queries. + +## Server-Function Discovery + +Server functions are discovered in caller modules, not in provider modules. In `handleCreateServerFn()`, each discovered function records: + +- `functionName`, the generated handler export name. +- `functionId`, the stable server-function ID. +- `filename`, the caller module ID. +- `extractedFilename`, the provider module ID with the server-function split query. +- `isClientReferenced`, whether client-origin calls are allowed. + +`onServerFnsById` merges discoveries into the shared `serverFnsById` registry. While a compile task is active, it also merges the same discoveries into that module's `activeServerFnMetadata` object. After compile finishes, that object becomes the metadata payload for the module. + +Per-environment compiler tasks are serialized because `StartCompiler` owns mutable module caches and because `activeServerFnMetadata` must only describe the module currently being compiled in that environment. + +## Loading And Resolving Modules + +The compiler sometimes needs to read or resolve imported modules while compiling a source file. + +`start-compiler-host.ts` uses two native Rsbuild/Rspack surfaces for this: + +- `ctx.resolve()` from the active Rsbuild transform context resolves module IDs. +- `compiler.inputFileSystem` reads source through Rspack's input filesystem. + +An `AsyncLocalStorage` value binds `loadModule` and `resolveId` back to the active transform context. That lets the compiler add dependencies to the current Rspack module without reaching into Rspack private resolver internals. + +## Why A Real Loader Is Used + +Rsbuild `api.transform()` is implemented as a loader, but its callback only exposes the transform context. It does not expose the current `NormalModule` or `module.buildInfo`. + +Rspack persists custom `module.buildInfo` fields. To write metadata there, Start installs a small real loader after the transform: + +1. `start-compiler-host.ts` adds a rule with `enforce: 'post'` for Start transformable modules. +2. The rule points to the emitted `start-compiler-metadata-loader.js` file. +3. The loader receives the environment's pending metadata map through loader options. +4. A public `NormalModule.getCompilationHooks(compilation).loader` hook adds a setter to the loader context. +5. The loader reads metadata for `this.resource` and calls the setter. +6. The setter writes to `module.buildInfo['tanstack.start.serverFns']`. + +Only string-keyed, JSON-serializable `buildInfo` fields are used. Rspack persists those fields with the module cache. Symbol keys and private cache internals are intentionally avoided. + +## Cache-Enabled And Cache-Disabled Behavior + +The metadata loader is installed regardless of `performance.buildCache`. + +When persistent cache is enabled, Rspack may later restore a module without rerunning the Start transform or the metadata loader. The `buildInfo` payload is then replayed from the cached module. + +When persistent cache is disabled, the same loader path still runs during normal compilation and writes in-memory `buildInfo`. Keeping one path avoids conditional behavior and keeps cold, watch, cache-disabled, and cache-enabled builds aligned. The overhead is one small post loader for modules that already match the Start transform test. + +The cache-specific part is not the loader itself. The cache-specific part is that Rspack can persist and later restore the `buildInfo` field. + +## Stale Metadata Clearing + +If a module previously contained server functions and then no longer produces metadata, the metadata loader writes an empty payload: + +```ts +{ version: 1, serverFnsById: {} } +``` + +This prevents stale server-function entries from surviving on a cached module's `buildInfo` after a file edit removes or renames server functions. + +## Warm Cache Replay + +Each relevant compiler installs a `finishMake` hook at stage `-20`. + +At that point Rspack has built or restored the module graph for the environment, and module `buildInfo` is available. The hook: + +1. Iterates over `compilation.modules`. +2. Reads `module.buildInfo['tanstack.start.serverFns']`. +3. Validates the payload with the versioned schema. +4. Merges valid module metadata into an environment snapshot. +5. Stores the snapshot in `serverFnsByEnvironment`. +6. Rebuilds the shared `serverFnsById` registry from all environment snapshots. +7. Notifies virtual modules that resolver content may have changed. + +The shared registry is rebuilt from snapshots instead of being append-only. This is what lets deleted or renamed server functions disappear after watch rebuilds or warm-cache restores. + +The pending transform-to-loader metadata maps are cleared on each Rspack `compile` hook. That prevents metadata discovered in an earlier compilation from being written to a later module when the transform no longer runs or no longer discovers server functions. + +## Why Snapshots Are Per Environment + +Each Rsbuild environment can see different information for the same file. For example, client and SSR caller environments can mark functions as client-accessible, while server and provider environments own server execution details. The merged registry preserves the broadest known access information. + +A single global replay pass would either drop another environment's metadata or keep stale metadata too long. The model is therefore: + +- Build one current snapshot per environment. +- Replace the shared registry with the union of all available snapshots. +- Regenerate resolver content from that shared registry. + +This keeps the global registry convergent while allowing Rspack environments to finish independently. + +## Resolver Rebuild Ordering + +The resolver virtual module must be rebuilt after cached metadata has been replayed. + +The ordering is: + +1. `finishMake` stage `-20`: replay `buildInfo` into environment snapshots and rebuild `serverFnsById`. +2. `finishMake` stage `-10`: write resolver virtual module content and rebuild modules that import the resolver. + +For non-RSC builds, each server-like environment that needs the resolver installs the stage `-10` rebuild hook. + +For RSC builds, the server environment installs the RSC resolver rebuild hook at stage `-10`. It generates provider-style resolver content because RSC server actions run inside the server/RSC environment and do not need the client-reference check in that resolver layer. + +## Compiler Ordering + +Non-RSC Rsbuild uses Rspack `MultiCompiler.setDependencies()` to make resolver-owning environments wait for metadata-producing environments. + +The intended order is: + +- `client` runs before every server-like environment. +- If a separate provider environment exists, the provider runs after `client`. +- If a separate provider environment exists, `ssr` runs after both `client` and the provider. + +That ordering prevents the `ssr` resolver module from being finalized before provider metadata is available. + +RSC builds intentionally do not add these dependencies. Rspack's native RSC coordinator interleaves server and client compilation phases. Adding MultiCompiler dependencies on top of it can deadlock the build. + +## Native APIs Used + +The implementation uses Rsbuild/Rspack integration points instead of cache internals: + +- Rsbuild `api.transform()` for source transforms. +- Rsbuild transform `ctx.resolve()` for module resolution. +- Rspack `compiler.inputFileSystem` for source reads. +- Rspack loaders for access to the loader pipeline. +- Rspack `NormalModule.getCompilationHooks(compilation).loader` to extend loader context. +- Rspack `module.buildInfo` for module-scoped persisted metadata. +- Rspack `compiler.hooks.finishMake` for module graph replay and resolver rebuild ordering. +- Rspack `compilation.rebuildModule()` through the local `rebuildModulesContaining()` helper. +- Rspack `MultiCompiler.setDependencies()` for non-RSC compiler ordering. +- Rspack `experiments.VirtualModulesPlugin` for virtual module content. + +The implementation avoids private persistent-cache files, direct cache mutation, direct `_module` access from loaders, global handoff state, and disabling module caching with `this.cacheable(false)`. + +## When A New Server Function Is Compiled + +For a new server function in a normal cold compile: + +1. Rsbuild sends the source module through the Start pre transform. +2. `StartCompiler.compile()` rewrites the caller module and discovers the server function. +3. `onServerFnsById` merges the function into `serverFnsById` and the active module metadata object. +4. The transform stores `{ version: 1, serverFnsById: discoveredServerFnsById }` in the environment metadata map under the module resource. +5. The post metadata loader runs for the same resource. +6. The loader writes that payload into `module.buildInfo['tanstack.start.serverFns']`. +7. Rspack owns the module from there. If persistent cache is enabled, Rspack persists the module and its string-keyed `buildInfo` with its normal cache machinery. +8. At `finishMake -20`, Start reads current module `buildInfo` and rebuilds the environment snapshot. +9. At `finishMake -10`, Start rewrites and rebuilds the resolver virtual module so runtime lookups can find the new function. diff --git a/packages/start-plugin-core/src/rsbuild/INTERNALS-import-protection.md b/packages/start-plugin-core/src/rsbuild/INTERNALS-import-protection.md new file mode 100644 index 0000000000..d3cc8c4017 --- /dev/null +++ b/packages/start-plugin-core/src/rsbuild/INTERNALS-import-protection.md @@ -0,0 +1,169 @@ +# Rsbuild Import Protection - Adapter Internals + +## Scope + +This document covers the Rsbuild-specific orchestration around the shared +import-protection core in `src/import-protection/INTERNALS.md`. + +Rsbuild owns: + +- post-transform enforcement through `api.transform({ order: 'post' })` +- virtual-module transport through `VirtualModulesPlugin` +- compilation-truth reporting in `processAssets` +- final graph reconstruction from Rspack compilation data +- the small build-only deferred queue for file violations that can disappear + from the compiled graph + +Shared AST analysis, rewrite logic, source extraction, usage lookup, source +locations, trace formatting, and mock code generation are described in the +shared internals doc. + +## Mental Model + +Vite is primarily `resolveId`-driven. Rsbuild is primarily `transform` + +`processAssets`-driven. + +That difference explains most of the adapter divergence. + +Rsbuild does not emulate the Vite pending-queue state machine. It relies more +directly on post-transform code and final compilation truth. + +## Native Hook Shape + +Import protection is attached through Rsbuild hooks, not a dedicated mini-plugin +object: + +1. `onBeforeBuild` +2. `onBeforeDevCompile` +3. `modifyRspackConfig` +4. `transform(..., { order: 'post' })` +5. `processAssets(..., { stage: 'report' })` + +## State Model + +Per environment, Rsbuild keeps a smaller runtime state than Vite: + +- `resolveCache` +- `seenViolations` +- `buildTransformResults` +- `deferredFileViolations` +- `deferredFileViolationKeys` + +Shared state is for virtual module transport and compiler fs access: + +- `virtualModules` +- `vmPlugins` +- `readyVmPlugins` +- `inputFileSystems` +- `pendingWrites` + +Notably absent compared to Vite: + +- no `pendingViolations` +- no `postTransformImports` +- no broad `deferredBuildViolations` +- no resolve-time dev reachability pipeline + +## Transform Phase + +Rsbuild enforcement runs after the Start compiler in a `post` transform. + +That matters because many compiler-safe imports are already stripped by the time +import protection runs. This naturally suppresses a large class of false +positives without a Vite-style pending verification pass. + +The transform phase is responsible for: + +- self-denial for forbidden files +- self-denial for marker-protected files in the wrong environment +- direct specifier rewrites to mock-edge modules +- build-time transformed/original source preloading for later diagnostics +- recording build-only deferred file violations when original unsafe usage may + outlive a direct compiled graph edge + +## Virtual Module Transport + +Rsbuild reuses the shared mock generators, but not the Vite id transport. + +Instead it writes environment-scoped virtual files under: + +```text +<root>/node_modules/.virtual/import-protection/<env>/ +``` + +The important forms are: + +- `mock-silent.mjs` +- `mock-runtime-<base64>.mjs` +- `mock-edge-<base64>.mjs` + +Writes may happen before the `VirtualModulesPlugin` instance is ready, so the +adapter queues them and flushes during compilation setup. + +## Reporting Phase + +`processAssets({ stage: 'report' })` is the authoritative reporting step. + +It reconstructs the final view of the compilation from Rspack data by: + +1. building a `TransformResultProvider` from `compilation.modules` +2. rebuilding the active compilation graph from outgoing connections +3. reconstructing surviving specifier violations from compiled mock-edge files +4. reporting live file violations from active edges +5. reporting live marker violations from active edges plus original source +6. reporting deferred file violations only when both importer and target truly + survived compilation + +This is the core Rsbuild-native replacement for Vite's `generateBundle` +verification plus dev pending-violation flow. + +## Why The Deferred Queue Is Narrow + +Rsbuild only needs explicit build deferral for file violations whose direct edge +may disappear after compilation. + +Specifier violations are rediscovered from surviving mock-edge virtual files. +Marker violations are rediscovered from live compiled edges. + +Only file violations need extra bookkeeping when the final compiled graph can no +longer show the original denied edge directly. + +## Source And Compilation APIs + +The Rsbuild adapter intentionally prefers native Rspack APIs where possible. + +Transform-time: + +- `ctx.resource` +- `ctx.context` +- `ctx.resolve(...)` +- captured `compiler.inputFileSystem.readFile(...)` + +Compilation-time: + +- `module.nameForCondition?.()` +- `module.resourceResolveData?.resource` +- `module.originalSource().sourceAndMap()` +- sourcemap `sourcesContent` +- `compilation.inputFileSystem.readFile(...)` + +This keeps the adapter closer to Rsbuild/Rspack truth and avoids falling back to +Node fs when the compilation already has the needed data. + +## Marker Handling + +Unlike Vite, Rsbuild does not introduce plugin-owned virtual marker modules for +normal operation. + +The real package marker files are used as source-level markers, and the adapter +later infers marker kind from original source while reporting compiled edges. + +## Practical Maintainer Rule + +When changing Rsbuild import protection, ask: + +1. Can the change be expressed in shared analysis/rewrite/mock codegen instead? +2. If it is adapter-specific, is it really about post-transform enforcement, + virtual-file transport, or compilation-time reporting? +3. Can final compilation truth answer the question more simply than adding a new + pending state machine? diff --git a/packages/start-plugin-core/src/rsbuild/dev-server.ts b/packages/start-plugin-core/src/rsbuild/dev-server.ts new file mode 100644 index 0000000000..c83ec71448 --- /dev/null +++ b/packages/start-plugin-core/src/rsbuild/dev-server.ts @@ -0,0 +1,129 @@ +import { NodeRequest, sendNodeResponse } from 'srvx/node' +import { RSBUILD_ENVIRONMENT_NAMES } from './planning' +import type { IncomingMessage, ServerResponse } from 'node:http' +import type { RsbuildConfig } from '@rsbuild/core' + +type ServerSetupFn = Extract< + NonNullable<NonNullable<RsbuildConfig['server']>['setup']>, + (...args: Array<any>) => any +> +type SSRMiddleware = ( + req: IncomingMessage & { originalUrl?: string }, + res: ServerResponse, + next: () => void, +) => Promise<void> + +/** + * Returns a `server.setup` function for rsbuild v2. + * + * Two middleware positions are used: + * + * 1. **Setup body** (BEFORE built-ins): Intercepts `/_serverFn/` URLs so + * they never reach rsbuild's htmlFallback/htmlCompletion middleware, + * which can swallow long base64 function IDs. + * + * 2. **Returned callback** (AFTER built-ins, BEFORE fallback): Handles + * all remaining SSR requests (page navigations). This position lets + * rsbuild's asset middleware serve compiled JS/CSS first. + * + * See rsbuild source: devMiddlewares.ts `applyDefaultMiddlewares()`. + */ +export function createServerSetup(opts: { + serverFnBasePath: string +}): ServerSetupFn { + return (context) => { + // Only install SSR middleware in dev mode + if (context.action !== 'dev') { + return () => {} + } + + const serverFnBase = opts.serverFnBasePath + + const handleSSR: SSRMiddleware = async (req, res, next) => { + const ssrEnv = + context.server.environments[RSBUILD_ENVIRONMENT_NAMES.server] + + if (!ssrEnv) { + console.error( + `[tanstack-start] SSR environment "${RSBUILD_ENVIRONMENT_NAMES.server}" not found`, + ) + return next() + } + + try { + const serverEntry = await ssrEnv.loadBundle<{ + default: { fetch: (req: Request) => Promise<Response> } + }>('index') + + // Restore the original URL (rsbuild may rewrite to /index.html) + if (req.originalUrl) { + req.url = req.originalUrl + } + + const webReq = new NodeRequest({ req, res }) + const webRes = await serverEntry.default.fetch(webReq) + return sendNodeResponse(res, webRes) + } catch (e) { + console.error('[tanstack-start] SSR error:', e) + + const webReq = new NodeRequest({ req, res }) + if (webReq.headers.get('content-type')?.includes('application/json')) { + return sendNodeResponse( + res, + new Response( + JSON.stringify( + { + status: 500, + error: 'Internal Server Error', + message: + 'An unexpected error occurred. Please try again later.', + timestamp: new Date().toISOString(), + }, + null, + 2, + ), + { + status: 500, + headers: { 'Content-Type': 'application/json' }, + }, + ), + ) + } + + return sendNodeResponse( + res, + new Response( + `<!DOCTYPE html> +<html lang="en"> + <head><meta charset="UTF-8" /><title>Error + +

    Internal Server Error

    +
    ${e instanceof Error ? e.message : String(e)}
    + +`, + { + status: 500, + headers: { 'Content-Type': 'text/html' }, + }, + ), + ) + } + } + + // Position 1: BEFORE built-ins — intercept server function calls + // early so they are not swallowed by htmlFallback or assetsMiddleware. + context.server.middlewares.use(async (req, res, next) => { + const url = req.url || '/' + if (url.startsWith(serverFnBase)) { + return handleSSR(req, res, next) + } + return next() + }) + + // Position 2: AFTER built-ins, before fallback — SSR catch-all for + // page navigations. Assets are already handled by rsbuild middleware. + return () => { + context.server.middlewares.use(handleSSR) + } + } +} diff --git a/packages/start-plugin-core/src/rsbuild/import-protection.ts b/packages/start-plugin-core/src/rsbuild/import-protection.ts new file mode 100644 index 0000000000..e3d63ba04d --- /dev/null +++ b/packages/start-plugin-core/src/rsbuild/import-protection.ts @@ -0,0 +1,1914 @@ +import { writeFileSync } from 'node:fs' +import { extname, resolve as resolvePath } from 'node:path' + +import { + getDefaultImportProtectionRules, + getMarkerSpecifiers, +} from '../import-protection/defaults' +import { normalizePath } from '../utils' +import { ExtensionlessAbsoluteIdResolver } from '../import-protection/extensionlessAbsoluteIdResolver' +import { compileMatchers, matchesAny } from '../import-protection/matchers' +import { + getImportProtectionEnvType, + getImportProtectionRelativePath, + getImportProtectionRulesForEnvironment, + shouldCheckImportProtectionImporter, +} from '../import-protection/adapterUtils' +import { + findOriginalUnsafeUsagePosFromResult, + getImportSources, + getImportSourcesFromResult, + getMockExportNamesBySourceFromResult, + getNamedExportsFromResult, +} from '../import-protection/analysis' +import { rewriteDeniedImports } from '../import-protection/rewrite' +import { + ImportLocCache, + addTraceImportLocations, + buildCodeSnippet, + buildLineIndex, + createImportSpecifierLocationIndex, + findImportStatementLocationFromTransformed, + findOriginalUsageLocation, + findPostCompileUsageLocation, + getOrCreateOriginalTransformResult, + indexToLineColumn, + normalizeSourceMap, + pickOriginalCodeFromSourcesContent, +} from '../import-protection/sourceLocation' +import { + ImportGraph, + buildTrace, + formatViolation, +} from '../import-protection/trace' +import { + generateDevSelfDenialModule, + generateSelfContainedMockModule, + loadMockEdgeModule, + loadMockRuntimeModule, + loadSilentMockModule, +} from '../import-protection/virtualModules' +import { + buildResolutionCandidates, + buildSourceCandidates, + canonicalizeResolvedId, + checkFileDenial, + clearNormalizeFilePathCache, + dedupePatterns, + dedupeViolationKey, + isFileExcluded, + normalizeFilePath, +} from '../import-protection/utils' + +import type { + ImportProtectionBehavior, + ImportProtectionOptions, +} from '../schema' +import type { CompiledMatcher } from '../import-protection/matchers' +import type { FileMatchers } from '../import-protection/utils' +import type { + SourceMapLike, + TransformResult, + TransformResultProvider, +} from '../import-protection/sourceLocation' +import type { Loc, TraceStep, ViolationInfo } from '../import-protection/trace' +import type { CompileStartFrameworkOptions, GetConfigFn } from '../types' +import type { + RsbuildPluginAPI, + Rspack, + rspack as rspackNamespaceType, +} from '@rsbuild/core' + +type RspackNamespace = typeof rspackNamespaceType +type RspackVirtualModulesPlugin = InstanceType< + RspackNamespace['experiments']['VirtualModulesPlugin'] +> +type ProcessAssetsContext = Parameters< + Parameters[1] +>[0] +type TransformContext = Parameters< + Parameters[1] +>[0] +type RspackCompilation = Rspack.Compilation +type RspackModule = Rspack.Module +type RspackModuleGraphConnection = { + module?: RspackModule | null + dependency?: unknown + getActiveState?: (runtime: string | Array | undefined) => unknown +} +type OriginalCodeLoader = (file: string) => Promise +const importSpecifierLocationIndex = createImportSpecifierLocationIndex() + +type PerfTiming = { + count: number + totalMs: number + maxMs: number +} + +type PerfCollector = { + count: (name: string, value?: number) => void + time: (name: string, startedAt: number) => void + flush: (root: string, envName: string, phase: string) => void +} + +function isPerfEnabled(): boolean { + return ( + process.env.TSR_IMPORT_PROTECTION_PERF === '1' || + process.env.TSR_IMPORT_PROTECTION_PERF === 'true' + ) +} + +function createPerfCollector(): PerfCollector { + const counters = new Map() + const timings = new Map() + const flushEnvironments = new Set() + let flushCount = 0 + + return { + count(name, value = 1) { + counters.set(name, (counters.get(name) ?? 0) + value) + }, + time(name, startedAt) { + const duration = performance.now() - startedAt + const timing = timings.get(name) + if (timing) { + timing.count++ + timing.totalMs += duration + timing.maxMs = Math.max(timing.maxMs, duration) + } else { + timings.set(name, { count: 1, totalMs: duration, maxMs: duration }) + } + }, + flush(root, envName, phase) { + flushCount++ + flushEnvironments.add(envName) + + const payload = { + adapter: 'rsbuild', + root, + phase, + flushCount, + flushEnvironments: Array.from(flushEnvironments).sort(), + counters: Object.fromEntries(counters), + timings: Object.fromEntries( + Array.from(timings, ([name, timing]) => [ + name, + { + count: timing.count, + totalMs: Number(timing.totalMs.toFixed(3)), + avgMs: Number((timing.totalMs / timing.count).toFixed(3)), + maxMs: Number(timing.maxMs.toFixed(3)), + }, + ]), + ), + } + + const file = process.env.TSR_IMPORT_PROTECTION_PERF_FILE + if (file) { + writeFileSync(file, `${JSON.stringify(payload, null, 2)}\n`) + } else { + console.warn( + `[import-protection:perf] ${JSON.stringify(payload, null, 2)}`, + ) + } + }, + } +} + +interface EnvRules { + specifiers: Array + files: Array + excludeFiles: Array +} + +interface PluginConfig { + enabled: boolean + root: string + command: 'build' | 'serve' + srcDirectory: string + framework: CompileStartFrameworkOptions + effectiveBehavior: ImportProtectionBehavior + mockAccess: 'error' | 'warn' | 'off' + logMode: 'once' | 'always' + maxTraceDepth: number + compiledRules: { + client: EnvRules + server: EnvRules + } + includeMatchers: Array + excludeMatchers: Array + ignoreImporterMatchers: Array + markerSpecifiers: { + serverOnly: Set + clientOnly: Set + } + envTypeMap: Map + onViolation?: ( + info: ViolationInfo, + ) => boolean | void | Promise +} + +interface EnvRuntimeState { + resolveCache: Map + seenViolations: Set + buildTransformResults: Map + deferredFileViolations: Array + deferredFileViolationKeys: Set +} + +interface DeferredFileViolation { + importer: string + specifier: string + resolved: string + relativeResolved: string + pattern: string | RegExp + useOriginalLocation: boolean +} + +interface SharedState { + root: string + virtualModules: Map + vmPlugins: Record + readyVmPlugins: Record + inputFileSystems: Record + pendingWrites: Map> +} + +interface CompilationEdge { + importer: string + specifier?: string + resolved: string +} + +interface MockEdgePayload { + exports: Array + runtimeId: string + violation: { + env: string + envType: 'client' | 'server' + importer: string + specifier: string + resolved?: string + patternText: string + } +} + +type ResolvedImportProtectionCheck = + | { type: 'file'; fileMatch: FileMatchers['files'][number] } + | { type: 'marker' } + +const IMPORT_PROTECTION_VIRTUAL_DIR = 'node_modules/.virtual/import-protection' +const MOCK_EDGE_FILE_PREFIX = 'mock-edge-' +const MOCK_RUNTIME_FILE_PREFIX = 'mock-runtime-' +const MOCK_SILENT_FILE = 'mock-silent.mjs' + +function toBase64Url(input: unknown): string { + return Buffer.from(JSON.stringify(input), 'utf8').toString('base64url') +} + +function fromBase64Url(input: string): T { + return JSON.parse(Buffer.from(input, 'base64url').toString('utf8')) as T +} + +function getRulesForEnvironment( + config: PluginConfig, + envName: string, +): EnvRules { + return getImportProtectionRulesForEnvironment(config, envName) as EnvRules +} + +function serializePattern(pattern: string | RegExp): string { + return typeof pattern === 'string' ? pattern : pattern.toString() +} + +function dedupeKey(info: ViolationInfo): string { + return dedupeViolationKey(info) +} + +export function getRsbuildResolvedImportProtectionCheck( + relativeResolved: string, + matchers: FileMatchers, +): ResolvedImportProtectionCheck | undefined { + if (isFileExcluded(relativeResolved, matchers)) { + return undefined + } + + const fileMatch = matchers.files.find((matcher) => + matcher.test(relativeResolved), + ) + if (fileMatch) { + return { type: 'file', fileMatch } + } + + return { type: 'marker' } +} + +function getOrCreateEnvState( + envStates: Map, + envName: string, +): EnvRuntimeState { + let env = envStates.get(envName) + + if (!env) { + env = { + resolveCache: new Map(), + seenViolations: new Set(), + buildTransformResults: new Map(), + deferredFileViolations: [], + deferredFileViolationKeys: new Set(), + } + envStates.set(envName, env) + } + + return env +} + +function getVirtualModulePath( + root: string, + envName: string, + filename: string, +): string { + return normalizePath( + resolvePath(root, IMPORT_PROTECTION_VIRTUAL_DIR, envName, filename), + ) +} + +function queuePendingWrite( + shared: SharedState, + envName: string, + filePath: string, + code: string, +): void { + let writes = shared.pendingWrites.get(envName) + if (!writes) { + writes = new Map() + shared.pendingWrites.set(envName, writes) + } + + writes.set(filePath, code) +} + +function tryWriteVirtualModule( + shared: SharedState, + envName: string, + filePath: string, + code: string, +): string { + const current = shared.virtualModules.get(filePath) + if (current === code) { + return filePath + } + + shared.virtualModules.set(filePath, code) + + const vmPlugin = shared.vmPlugins[envName] + if (!vmPlugin || !shared.readyVmPlugins[envName]) { + queuePendingWrite(shared, envName, filePath, code) + return filePath + } + + vmPlugin.writeModule(filePath, code) + return filePath +} + +function flushPendingWrites(shared: SharedState, envName: string): void { + const writes = shared.pendingWrites.get(envName) + if (!writes?.size || !shared.readyVmPlugins[envName]) { + return + } + + for (const [filePath, code] of writes) { + shared.vmPlugins[envName]?.writeModule(filePath, code) + writes.delete(filePath) + } + + if (writes.size === 0) { + shared.pendingWrites.delete(envName) + } +} + +function ensureSilentMockModule(shared: SharedState, envName: string): string { + return tryWriteVirtualModule( + shared, + envName, + getVirtualModulePath(shared.root, envName, MOCK_SILENT_FILE), + loadSilentMockModule().code, + ) +} + +function ensureRuntimeMockModule(opts: { + shared: SharedState + envName: string + mode: 'error' | 'warn' | 'off' + env: string + importer: string + specifier: string +}): string { + const encoded = toBase64Url({ + mode: opts.mode, + env: opts.env, + importer: opts.importer, + specifier: opts.specifier, + trace: [], + }) + + return tryWriteVirtualModule( + opts.shared, + opts.envName, + getVirtualModulePath( + opts.shared.root, + opts.envName, + `${MOCK_RUNTIME_FILE_PREFIX}${encoded}.mjs`, + ), + loadMockRuntimeModule(encoded).code, + ) +} + +function ensureMockEdgeModule(opts: { + shared: SharedState + envName: string + payload: MockEdgePayload +}): string { + const encoded = toBase64Url(opts.payload) + + return tryWriteVirtualModule( + opts.shared, + opts.envName, + getVirtualModulePath( + opts.shared.root, + opts.envName, + `${MOCK_EDGE_FILE_PREFIX}${encoded}.mjs`, + ), + loadMockEdgeModule(encoded).code, + ) +} + +function getMockEdgePayloadFromFile( + filePath: string, +): MockEdgePayload | undefined { + const match = /(?:^|[\\/])mock-edge-([^/\\]+)\.mjs$/.exec(filePath) + if (!match) { + return undefined + } + + try { + return fromBase64Url(match[1]!) + } catch { + return undefined + } +} + +async function loadOriginalCode( + cache: Map>, + file: string, + loader: OriginalCodeLoader, +): Promise { + let result = cache.get(file) + if (!result) { + result = loader(file) + cache.set(file, result) + } + + return result +} + +async function loadOriginalCodeFromInputFileSystem( + inputFileSystem: NonNullable, + file: string, +): Promise { + return new Promise((resolve) => { + inputFileSystem.readFile(file, (error, data) => { + if (error || data == null) { + resolve(undefined) + return + } + + resolve(typeof data === 'string' ? data : data.toString('utf8')) + }) + }) +} + +async function resolveAgainstImporter(opts: { + envState: EnvRuntimeState + config: PluginConfig + ctx: TransformContext + importerId: string + source: string + extensionlessResolver: ExtensionlessAbsoluteIdResolver + perf?: PerfCollector +}): Promise { + const importerDir = + opts.ctx.context ?? opts.importerId.replace(/[/\\][^/\\]*$/, '') + const normalizedImporterDir = normalizeFilePath(importerDir) + const cacheKey = `${normalizedImporterDir}:${opts.source}` + + if (opts.envState.resolveCache.has(cacheKey)) { + opts.perf?.count('resolve.cached') + return opts.envState.resolveCache.get(cacheKey) ?? null + } + + const startedAt = opts.perf ? performance.now() : 0 + opts.perf?.count('resolve.calls') + const resolved = await new Promise((resolve, reject) => { + opts.ctx.resolve(importerDir, opts.source, (error, result) => { + if (error) { + reject(error) + return + } + + resolve(typeof result === 'string' ? result : null) + }) + }) + .catch(() => null) + .finally(() => { + if (opts.perf) { + opts.perf.time('resolve', startedAt) + } + }) + + if (!resolved) { + opts.envState.resolveCache.set(cacheKey, null) + return null + } + + const canonical = canonicalizeResolvedId( + resolved, + opts.config.root, + (value) => opts.extensionlessResolver.resolve(value), + ) + + opts.envState.resolveCache.set(cacheKey, canonical) + return canonical +} + +function getModuleResource(module: RspackModule): string | undefined { + const candidate = module as RspackModule & { + nameForCondition?: () => string | undefined + resourceResolveData?: { resource?: string } + resource?: string + userRequest?: string + request?: string + } + + return ( + candidate.nameForCondition() ?? + candidate.resourceResolveData?.resource ?? + candidate.resource ?? + candidate.userRequest ?? + candidate.request + ) +} + +function getModuleFile(module: RspackModule): string { + return normalizeFilePath(getModuleResource(module) ?? module.identifier()) +} + +const IMPORT_PROTECTION_PARSEABLE_EXTENSIONS = new Set([ + '.ts', + '.tsx', + '.mts', + '.cts', + '.js', + '.jsx', + '.mjs', + '.cjs', +]) + +function isImportProtectionSourceFile(file: string | undefined): boolean { + if (!file) { + return false + } + + const extension = extname(normalizeFilePath(file)) + return ( + extension.length > 0 && + IMPORT_PROTECTION_PARSEABLE_EXTENSIONS.has(extension) + ) +} + +function isImportProtectionSourceModule(module: RspackModule): boolean { + return isImportProtectionSourceFile(getModuleResource(module)) +} + +function addTransformResult( + cache: Map, + key: string, + result: TransformResult, +): void { + cache.set(normalizePath(key), result) + cache.set(normalizeFilePath(key), result) +} + +function hasTransformResult( + cache: Map, + key: string, +): boolean { + return cache.has(normalizePath(key)) || cache.has(normalizeFilePath(key)) +} + +function deferFileViolation( + envState: EnvRuntimeState, + violation: DeferredFileViolation, +): void { + const key = `${violation.importer}:${violation.specifier}:${violation.resolved}:${String(violation.pattern)}` + if (envState.deferredFileViolationKeys.has(key)) { + return + } + + envState.deferredFileViolationKeys.add(key) + envState.deferredFileViolations.push(violation) +} + +function hasOriginalUnsafeUsage( + result: TransformResult | undefined, + source: string, + envType: 'client' | 'server', +): boolean { + if (!result) { + return false + } + + const originalResult = getOrCreateOriginalTransformResult(result) + if (!originalResult) { + return false + } + + return !!findOriginalUnsafeUsagePosFromResult(originalResult, source, envType) +} + +async function buildTransformResultProvider(opts: { + modules: Array + root: string + loadOriginalCode: OriginalCodeLoader + preloaded?: Map + perf?: PerfCollector +}): Promise { + const cache = new Map() + + if (opts.preloaded) { + for (const [key, result] of opts.preloaded) { + cache.set(key, result) + } + } + + opts.perf?.count('processAssets.provider.modules', opts.modules.length) + + for (const module of opts.modules) { + const source = module.originalSource() + if (!source) continue + + const sourceAndMapStartedAt = opts.perf ? performance.now() : 0 + const sourceAndMap = source.sourceAndMap() + if (opts.perf) { + opts.perf.time( + 'processAssets.provider.sourceAndMap', + sourceAndMapStartedAt, + ) + } + const code = String(sourceAndMap.source) + const map = normalizeSourceMap(sourceAndMap.map as SourceMapLike | null) + const file = getModuleFile(module) + const resource = getModuleResource(module) + + const originalCodeStartedAt = opts.perf ? performance.now() : 0 + const originalCode = map?.sourcesContent + ? (pickOriginalCodeFromSourcesContent(map, resource ?? file, opts.root) ?? + (resource ? await opts.loadOriginalCode(resource) : undefined)) + : resource + ? await opts.loadOriginalCode(resource) + : undefined + if (opts.perf) { + opts.perf.time( + 'processAssets.provider.originalCode', + originalCodeStartedAt, + ) + } + + const result: TransformResult = { + code, + filename: resource ?? file, + map, + originalCode, + perf: opts.perf, + } + + if (!hasTransformResult(cache, file)) { + addTransformResult(cache, file, result) + } + + if (resource && !hasTransformResult(cache, resource)) { + addTransformResult(cache, resource, result) + } + } + + return { + getTransformResult(id: string) { + return cache.get(normalizePath(id)) ?? cache.get(normalizeFilePath(id)) + }, + } +} + +function getConnectionRequest(dependency: unknown): string | undefined { + const candidate = dependency as { request?: unknown } + return typeof candidate.request === 'string' ? candidate.request : undefined +} + +function addEntryModulesToGraph(opts: { + compilation: RspackCompilation + graph: ImportGraph +}): void { + for (const entry of opts.compilation.entries.values()) { + for (const dependency of entry.dependencies) { + const connection = opts.compilation.moduleGraph.getConnection(dependency) + const module = connection?.module + if (!module) continue + opts.graph.addEntry(getModuleFile(module)) + } + } +} + +function buildCompilationGraph(opts: { + compilation: RspackCompilation + modules: Array +}): { + graph: ImportGraph + edges: Array + inactiveEdges: Array +} { + const graph = new ImportGraph() + const edges: Array = [] + const inactiveEdges: Array = [] + + addEntryModulesToGraph({ + compilation: opts.compilation, + graph, + }) + + for (const module of opts.modules) { + const importer = getModuleFile(module) + const connections = + opts.compilation.moduleGraph.getOutgoingConnectionsInOrder(module) + + for (const connection of connections) { + if (!connection.module) continue + + const resolved = getModuleFile(connection.module) + const specifier = getConnectionRequest(connection.dependency) + + if (isActiveConnection(connection)) { + graph.addEdge(resolved, importer, specifier) + edges.push({ importer, specifier, resolved }) + } else { + inactiveEdges.push({ importer, specifier, resolved }) + } + } + } + + return { graph, edges, inactiveEdges } +} + +function isActiveConnection(connection: RspackModuleGraphConnection): boolean { + if (typeof connection.getActiveState !== 'function') { + return true + } + + return connection.getActiveState(undefined) === true +} + +function findImportLocationInOriginalCode( + provider: TransformResultProvider, + importer: string, + source: string, +): Loc | undefined { + const result = provider.getTransformResult(importer) + if (!result) { + return undefined + } + + const originalResult = getOrCreateOriginalTransformResult(result) + if (!originalResult) { + return undefined + } + + const index = importSpecifierLocationIndex.find(originalResult, source) + if (index === -1) { + return undefined + } + + const lineIndex = + originalResult.lineIndex ?? + (originalResult.lineIndex = buildLineIndex(originalResult.code)) + const loc = indexToLineColumn(lineIndex, index) + + return { + file: normalizeFilePath(importer), + line: loc.line, + column: loc.column, + } +} + +async function resolveImporterLocation(opts: { + provider: TransformResultProvider + importLocCache: ImportLocCache + importer: string + sourceCandidates: Iterable + preferOriginalCode?: boolean + envType?: 'client' | 'server' +}): Promise { + if (opts.preferOriginalCode) { + for (const candidate of opts.sourceCandidates) { + const loc = + findOriginalUsageLocation( + opts.provider, + opts.importer, + candidate, + opts.envType, + ) ?? + findImportLocationInOriginalCode( + opts.provider, + opts.importer, + candidate, + ) + if (loc) { + return loc + } + } + } + + for (const candidate of opts.sourceCandidates) { + const loc = + (await findPostCompileUsageLocation( + opts.provider, + opts.importer, + candidate, + )) || + (await findImportStatementLocationFromTransformed( + opts.provider, + opts.importer, + candidate, + opts.importLocCache, + importSpecifierLocationIndex.find, + )) + + if (loc) { + return loc + } + } + + if (!opts.preferOriginalCode) { + for (const candidate of opts.sourceCandidates) { + const loc = findImportLocationInOriginalCode( + opts.provider, + opts.importer, + candidate, + ) + if (loc) { + return loc + } + } + } + + return undefined +} + +async function rebuildAndAnnotateTrace(opts: { + provider: TransformResultProvider + graph: ImportGraph + importLocCache: ImportLocCache + importer: string + specifier: string + importerLoc?: Loc + maxTraceDepth: number +}): Promise> { + const trace = buildTrace(opts.graph, opts.importer, opts.maxTraceDepth) + + await addTraceImportLocations( + opts.provider, + trace, + opts.importLocCache, + importSpecifierLocationIndex.find, + ) + + if (trace.length > 0) { + const last = trace[trace.length - 1]! + if (!last.specifier) { + last.specifier = opts.specifier + } + if (opts.importerLoc && last.line == null) { + last.line = opts.importerLoc.line + last.column = opts.importerLoc.column + } + } + + return trace +} + +async function buildViolationInfo(opts: { + config: PluginConfig + provider: TransformResultProvider + graph: ImportGraph + importLocCache: ImportLocCache + perf?: PerfCollector + envName: string + envType: 'client' | 'server' + importer: string + source: string + resolved?: string + type: 'specifier' | 'file' | 'marker' + pattern?: string | RegExp + preferOriginalCode?: boolean +}): Promise { + const startedAt = opts.perf ? performance.now() : 0 + opts.perf?.count('violations.enriched') + + const importerLocStartedAt = opts.perf ? performance.now() : 0 + const importerLoc = await resolveImporterLocation({ + provider: opts.provider, + importLocCache: opts.importLocCache, + importer: opts.importer, + sourceCandidates: buildSourceCandidates( + opts.source, + opts.resolved, + opts.config.root, + ), + preferOriginalCode: opts.preferOriginalCode, + envType: opts.envType, + }) + if (opts.perf) { + opts.perf.time('violations.resolveImporterLocation', importerLocStartedAt) + } + + const traceStartedAt = opts.perf ? performance.now() : 0 + const trace = await rebuildAndAnnotateTrace({ + provider: opts.provider, + graph: opts.graph, + importLocCache: opts.importLocCache, + importer: opts.importer, + specifier: opts.source, + importerLoc, + maxTraceDepth: opts.config.maxTraceDepth, + }) + if (opts.perf) { + opts.perf.time('violations.trace', traceStartedAt) + } + + const snippetStartedAt = opts.perf ? performance.now() : 0 + const snippet = importerLoc + ? buildCodeSnippet(opts.provider, opts.importer, importerLoc) + : undefined + if (opts.perf && importerLoc) { + opts.perf.time('violations.snippet', snippetStartedAt) + } + + const info = { + env: opts.envName, + envType: opts.envType, + behavior: opts.config.effectiveBehavior, + type: opts.type, + pattern: opts.pattern, + specifier: opts.source, + importer: opts.importer, + ...(opts.resolved ? { resolved: opts.resolved } : {}), + ...(importerLoc ? { importerLoc } : {}), + trace, + snippet, + } + + if (opts.perf) { + opts.perf.time('violations.enrich', startedAt) + } + + return info +} + +async function getMarkerKindForFile(opts: { + config: PluginConfig + provider: TransformResultProvider + loadOriginalCode: OriginalCodeLoader + markerKindCache: Map> + file: string +}): Promise<'server' | 'client' | undefined> { + if (!isImportProtectionSourceFile(opts.file)) { + return undefined + } + + let cached = opts.markerKindCache.get(opts.file) + if (!cached) { + cached = (async () => { + const code = + opts.provider.getTransformResult(opts.file)?.originalCode ?? + (await opts.loadOriginalCode(opts.file)) + + if (!code) { + return undefined + } + + const imports = getImportSources(code, opts.file) + const hasServerOnly = imports.some((source) => + opts.config.markerSpecifiers.serverOnly.has(source), + ) + const hasClientOnly = imports.some((source) => + opts.config.markerSpecifiers.clientOnly.has(source), + ) + + if (hasServerOnly && !hasClientOnly) { + return 'server' + } + + if (hasClientOnly && !hasServerOnly) { + return 'client' + } + + return undefined + })() + opts.markerKindCache.set(opts.file, cached) + } + + return cached +} + +async function reportViolation(opts: { + config: PluginConfig + envState: EnvRuntimeState + compilation: RspackCompilation + rspack: RspackNamespace + perf?: PerfCollector + info: ViolationInfo +}): Promise { + const key = dedupeKey(opts.info) + if ( + opts.config.logMode !== 'always' && + opts.envState.seenViolations.has(key) + ) { + opts.perf?.count('violations.deduped') + return + } + + opts.envState.seenViolations.add(key) + opts.perf?.count('violations.reported') + + if (opts.config.onViolation) { + const startedAt = opts.perf ? performance.now() : 0 + const result = await opts.config.onViolation(opts.info) + if (opts.perf) { + opts.perf.time('violations.onViolation', startedAt) + } + if (result === false) { + opts.perf?.count('violations.suppressed') + return + } + } + + const message = formatViolation(opts.info, opts.config.root) + const error = new opts.rspack.WebpackError(message) + + if (opts.config.effectiveBehavior === 'error') { + opts.compilation.errors.push(error) + } else { + opts.compilation.warnings.push(error) + } +} + +export function registerImportProtection( + api: RsbuildPluginAPI, + opts: { + getConfig: GetConfigFn + framework: CompileStartFrameworkOptions + environments: Array<{ name: string; type: 'client' | 'server' }> + }, +): void { + const perf = isPerfEnabled() ? createPerfCollector() : undefined + const extensionlessResolver = new ExtensionlessAbsoluteIdResolver() + const envStates = new Map() + const fileReadCache = new Map>() + const shouldCheckImporterCache = new Map() + + const config: PluginConfig = { + enabled: true, + root: '', + command: api.context.action === 'dev' ? 'serve' : 'build', + srcDirectory: '', + framework: opts.framework, + effectiveBehavior: 'error', + mockAccess: 'error', + logMode: 'once', + maxTraceDepth: 20, + compiledRules: { + client: { + specifiers: [], + files: [], + excludeFiles: [], + }, + server: { + specifiers: [], + files: [], + excludeFiles: [], + }, + }, + includeMatchers: [], + excludeMatchers: [], + ignoreImporterMatchers: [], + markerSpecifiers: { + serverOnly: new Set(), + clientOnly: new Set(), + }, + envTypeMap: new Map(opts.environments.map((env) => [env.name, env.type])), + onViolation: undefined, + } + + const shared: SharedState = { + root: '', + virtualModules: new Map(), + vmPlugins: {}, + readyVmPlugins: {}, + inputFileSystems: {}, + pendingWrites: new Map(), + } + + function applyUserConfig(): void { + const { startConfig, resolvedStartConfig } = opts.getConfig() + + config.root = resolvedStartConfig.root + config.srcDirectory = resolvedStartConfig.srcDirectory + shared.root = resolvedStartConfig.root + + const userOpts: ImportProtectionOptions | undefined = + startConfig.importProtection + + if (userOpts?.enabled === false) { + config.enabled = false + return + } + + config.enabled = true + + const behavior = userOpts?.behavior + if (typeof behavior === 'string') { + config.effectiveBehavior = behavior + } else { + config.effectiveBehavior = + config.command === 'serve' + ? (behavior?.dev ?? 'mock') + : (behavior?.build ?? 'error') + } + + config.logMode = userOpts?.log ?? 'once' + config.mockAccess = userOpts?.mockAccess ?? 'error' + config.maxTraceDepth = userOpts?.maxTraceDepth ?? 20 + config.onViolation = userOpts?.onViolation + ? (info) => userOpts.onViolation?.(info) + : undefined + + const defaults = getDefaultImportProtectionRules() + const pick = (user: Array | undefined, fallback: Array) => + user ? [...user] : [...fallback] + + const clientSpecifiers = dedupePatterns([ + ...defaults.client.specifiers, + ...(userOpts?.client?.specifiers ?? []), + ]) + + config.compiledRules.client = { + specifiers: compileMatchers(clientSpecifiers), + files: compileMatchers( + pick(userOpts?.client?.files, defaults.client.files), + ), + excludeFiles: compileMatchers( + pick(userOpts?.client?.excludeFiles, defaults.client.excludeFiles), + ), + } + + config.compiledRules.server = { + specifiers: compileMatchers( + dedupePatterns( + pick(userOpts?.server?.specifiers, defaults.server.specifiers), + ), + ), + files: compileMatchers( + pick(userOpts?.server?.files, defaults.server.files), + ), + excludeFiles: compileMatchers( + pick(userOpts?.server?.excludeFiles, defaults.server.excludeFiles), + ), + } + + config.includeMatchers = compileMatchers(userOpts?.include ?? []) + config.excludeMatchers = compileMatchers(userOpts?.exclude ?? []) + config.ignoreImporterMatchers = compileMatchers( + userOpts?.ignoreImporters ?? [], + ) + + const markers = getMarkerSpecifiers() + config.markerSpecifiers = { + serverOnly: new Set(markers.serverOnly), + clientOnly: new Set(markers.clientOnly), + } + } + + function shouldCheckImporter(file: string): boolean { + const normalizedFile = normalizeFilePath(file) + const cached = shouldCheckImporterCache.get(normalizedFile) + if (cached !== undefined) { + perf?.count('shouldCheckImporter.cached') + return cached + } + + const result = shouldCheckImportProtectionImporter(config, normalizedFile) + shouldCheckImporterCache.set(normalizedFile, result) + return result + } + + api.onBeforeBuild(() => { + const startedAt = perf ? performance.now() : 0 + applyUserConfig() + clearNormalizeFilePathCache() + extensionlessResolver.clear() + fileReadCache.clear() + shouldCheckImporterCache.clear() + envStates.clear() + if (perf) { + perf.time('onBeforeBuild', startedAt) + } + }) + + api.onBeforeDevCompile(() => { + const startedAt = perf ? performance.now() : 0 + applyUserConfig() + clearNormalizeFilePathCache() + extensionlessResolver.clear() + fileReadCache.clear() + shouldCheckImporterCache.clear() + + for (const envState of envStates.values()) { + envState.resolveCache.clear() + envState.buildTransformResults.clear() + envState.deferredFileViolations.length = 0 + envState.deferredFileViolationKeys.clear() + } + if (perf) { + perf.time('onBeforeDevCompile', startedAt) + } + }) + + api.modifyRspackConfig((rspackConfig, utils) => { + const startedAt = perf ? performance.now() : 0 + applyUserConfig() + + const envName = utils.environment.name + const VMP = utils.rspack.experiments.VirtualModulesPlugin + const vmPlugin = new VMP({}) + + shared.vmPlugins[envName] = vmPlugin + shared.readyVmPlugins[envName] = false + + rspackConfig.plugins.push(vmPlugin) + rspackConfig.plugins.push({ + apply(compiler: Rspack.Compiler) { + shared.inputFileSystems[envName] = compiler.inputFileSystem + compiler.hooks.thisCompilation.tap( + 'TanStackStartImportProtectionVirtualModulesReady', + () => { + shared.readyVmPlugins[envName] = true + flushPendingWrites(shared, envName) + }, + ) + }, + }) + if (perf) { + perf.time('modifyRspackConfig', startedAt) + } + }) + + for (const environment of opts.environments) { + api.transform( + { + test: /\.[cm]?[tj]sx?$/, + environments: [environment.name], + order: 'post', + }, + async (ctx) => { + const startedAt = perf ? performance.now() : 0 + perf?.count('transform.calls') + perf?.count(`transform.env.${environment.name}`) + + try { + if (!config.enabled) { + return ctx.code + } + + const envName = environment.name + const envType = getImportProtectionEnvType(config, envName) + const envState = getOrCreateEnvState(envStates, envName) + const id = ctx.resource + const file = normalizeFilePath(ctx.resourcePath) + + if (!shouldCheckImporter(file)) { + perf?.count('transform.skippedImporter') + return ctx.code + } + + const matchers = getRulesForEnvironment(config, envName) + const relativeFile = getImportProtectionRelativePath( + config.root, + file, + ) + const transformResult: TransformResult = { + code: ctx.code, + filename: file, + map: undefined, + originalCode: undefined, + perf, + } + const importSources = getImportSourcesFromResult(transformResult) + perf?.count('transform.importSources', importSources.length) + const transformedImportSources = new Set(importSources) + const transformInputFileSystem = shared.inputFileSystems[envName] + const loadOriginalCodeForTransform: OriginalCodeLoader = + transformInputFileSystem + ? (target) => + loadOriginalCodeFromInputFileSystem( + transformInputFileSystem, + target, + ) + : () => Promise.resolve(undefined) + const originalCodeStartedAt = perf ? performance.now() : 0 + const originalCode = + config.command === 'build' + ? await loadOriginalCode( + fileReadCache, + file, + loadOriginalCodeForTransform, + ) + : undefined + if (perf && config.command === 'build') { + perf.time('transform.originalCode.load', originalCodeStartedAt) + } + transformResult.originalCode = originalCode + const originalTransformResult = originalCode + ? getOrCreateOriginalTransformResult(transformResult) + : undefined + const buildImportSourcesStartedAt = perf ? performance.now() : 0 + const buildImportSources = originalTransformResult + ? getImportSourcesFromResult(originalTransformResult) + : [] + if (perf && originalCode) { + perf.time( + 'transform.originalImportAnalysis', + buildImportSourcesStartedAt, + ) + perf.count( + 'transform.originalImportSources', + buildImportSources.length, + ) + } + const buildTransformResult: TransformResult | undefined = + config.command === 'build' ? transformResult : undefined + + if (config.command === 'build') { + const relativeBuildFile = getImportProtectionRelativePath( + config.root, + file, + ) + addTransformResult( + envState.buildTransformResults, + file, + buildTransformResult!, + ) + addTransformResult( + envState.buildTransformResults, + relativeBuildFile, + buildTransformResult!, + ) + if (id !== file) { + addTransformResult( + envState.buildTransformResults, + id, + buildTransformResult!, + ) + } + } + + const hasServerOnlyMarker = importSources.some((source) => + config.markerSpecifiers.serverOnly.has(source), + ) + const hasClientOnlyMarker = importSources.some((source) => + config.markerSpecifiers.clientOnly.has(source), + ) + + if (hasServerOnlyMarker && hasClientOnlyMarker) { + throw new Error( + `[import-protection] File "${relativeFile}" has both server-only and client-only markers. This is not allowed.`, + ) + } + + const markerKind = hasServerOnlyMarker + ? ('server' as const) + : hasClientOnlyMarker + ? ('client' as const) + : undefined + + const fileMatch = checkFileDenial(relativeFile, matchers) + const markerViolation = + (envType === 'client' && markerKind === 'server') || + (envType === 'server' && markerKind === 'client') + + if (fileMatch || markerViolation) { + let exportNames: Array = [] + + try { + exportNames = getNamedExportsFromResult(transformResult) + } catch { + exportNames = [] + } + + if (config.command === 'build') { + return generateSelfContainedMockModule(exportNames) + } + + const runtimeId = ensureRuntimeMockModule({ + shared, + envName, + mode: config.mockAccess, + env: envName, + importer: file, + specifier: relativeFile, + }) + + return generateDevSelfDenialModule(exportNames, runtimeId) + } + + const deniedSpecifierReplacements = new Map() + let exportsBySource: Map> | undefined + const getExportsBySource = () => { + if (exportsBySource) { + return exportsBySource + } + + try { + exportsBySource = + getMockExportNamesBySourceFromResult(transformResult) + } catch { + exportsBySource = new Map>() + } + return exportsBySource + } + + for (const source of importSources) { + const specifierMatch = matchesAny(source, matchers.specifiers) + if (!specifierMatch) { + continue + } + + const resolved = await resolveAgainstImporter({ + envState, + config, + ctx, + importerId: id, + source, + extensionlessResolver, + perf, + }) + + const runtimeId = + config.command === 'build' + ? ensureSilentMockModule(shared, envName) + : ensureRuntimeMockModule({ + shared, + envName, + mode: config.mockAccess, + env: envName, + importer: file, + specifier: source, + }) + + const replacement = ensureMockEdgeModule({ + shared, + envName, + payload: { + exports: getExportsBySource().get(source) ?? [], + runtimeId, + violation: { + env: envName, + envType, + importer: file, + specifier: source, + ...(resolved ? { resolved } : {}), + patternText: serializePattern(specifierMatch.pattern), + }, + }, + }) + + deniedSpecifierReplacements.set(source, replacement) + } + + if (config.command === 'build') { + for (const source of buildImportSources) { + if (transformedImportSources.has(source)) { + continue + } + + if (matchesAny(source, matchers.specifiers)) { + continue + } + + if ( + !hasOriginalUnsafeUsage(buildTransformResult, source, envType) + ) { + continue + } + + const resolved = await resolveAgainstImporter({ + envState, + config, + ctx, + importerId: id, + source, + extensionlessResolver, + perf, + }) + + if (!resolved) { + continue + } + + const relativeResolved = getImportProtectionRelativePath( + config.root, + resolved, + ) + const buildFileMatch = checkFileDenial(relativeResolved, matchers) + if (!buildFileMatch) { + continue + } + + deferFileViolation(envState, { + importer: file, + specifier: source, + resolved, + relativeResolved, + pattern: buildFileMatch.pattern, + useOriginalLocation: true, + }) + } + } + + if (deniedSpecifierReplacements.size === 0) { + return ctx.code + } + + const rewritten = rewriteDeniedImports( + ctx.code, + id, + new Set(deniedSpecifierReplacements.keys()), + (source) => deniedSpecifierReplacements.get(source) ?? source, + ) + + if (!rewritten) { + return ctx.code + } + + return { + code: rewritten.code, + map: normalizeSourceMap(rewritten.map) ?? null, + } + } finally { + if (perf) { + perf.time('transform', startedAt) + } + } + }, + ) + } + + api.processAssets( + { + stage: 'report', + environments: opts.environments.map((environment) => environment.name), + }, + async (context: ProcessAssetsContext) => { + const envName = context.environment.name + const startedAt = perf ? performance.now() : 0 + perf?.count('processAssets.calls') + perf?.count(`processAssets.env.${envName}`) + + try { + if (!config.enabled) { + return + } + + const envType = getImportProtectionEnvType(config, envName) + const envState = getOrCreateEnvState(envStates, envName) + const matchers = getRulesForEnvironment(config, envName) + const processFileReadCache = new Map< + string, + Promise + >() + const loadOriginalCodeFromCompilation: OriginalCodeLoader = (file) => + loadOriginalCode( + processFileReadCache, + file, + context.compilation.inputFileSystem + ? (target) => + loadOriginalCodeFromInputFileSystem( + context.compilation.inputFileSystem!, + target, + ) + : () => Promise.resolve(undefined), + ) + const allModules = Array.from(context.compilation.modules) + const relevantModules = allModules.filter( + isImportProtectionSourceModule, + ) + perf?.count('processAssets.modules.total', allModules.length) + perf?.count('processAssets.modules.relevant', relevantModules.length) + + const providerStartedAt = perf ? performance.now() : 0 + const provider = await buildTransformResultProvider({ + modules: relevantModules, + root: config.root, + loadOriginalCode: loadOriginalCodeFromCompilation, + preloaded: envState.buildTransformResults, + perf, + }) + if (perf) { + perf.time('processAssets.provider.build', providerStartedAt) + } + const importLocCache = new ImportLocCache() + const markerKindCache = new Map< + string, + Promise<'server' | 'client' | undefined> + >() + const graphStartedAt = perf ? performance.now() : 0 + const { graph, edges, inactiveEdges } = buildCompilationGraph({ + compilation: context.compilation, + modules: relevantModules, + }) + if (perf) { + perf.time('processAssets.graph.build', graphStartedAt) + perf.count('processAssets.graph.edges', edges.length) + perf.count('processAssets.graph.inactiveEdges', inactiveEdges.length) + } + const liveFileEdgeKeys = new Set( + edges + .filter((edge) => !!edge.specifier) + .map( + (edge) => + `${normalizeFilePath(edge.importer)}::${edge.specifier!}::${normalizeFilePath(edge.resolved)}`, + ), + ) + const candidateCache = new Map>() + const getCandidates = (id: string) => { + const normalized = normalizeFilePath(id) + let candidates = candidateCache.get(normalized) + if (!candidates) { + candidates = buildResolutionCandidates(normalized) + candidateCache.set(normalized, candidates) + } + return candidates + } + const survivingModules = new Set() + for (const module of relevantModules) { + for (const candidate of getCandidates(getModuleFile(module))) { + survivingModules.add(candidate) + } + } + + const didModuleSurvive = (id: string): boolean => + getCandidates(id).some((candidate) => survivingModules.has(candidate)) + + for (const module of relevantModules) { + const payload = getMockEdgePayloadFromFile(getModuleFile(module)) + if (!payload) { + continue + } + if (!shouldCheckImporter(payload.violation.importer)) { + continue + } + + const info = await buildViolationInfo({ + config, + provider, + graph, + importLocCache, + perf, + envName, + envType, + importer: payload.violation.importer, + source: payload.violation.specifier, + resolved: payload.violation.resolved, + type: 'specifier', + pattern: payload.violation.patternText, + preferOriginalCode: true, + }) + + await reportViolation({ + config, + envState, + compilation: context.compilation, + rspack: context.compiler.rspack, + perf, + info, + }) + } + + for (const edge of edges) { + if (!edge.specifier) { + continue + } + if (!shouldCheckImporter(edge.importer)) { + continue + } + + const relativeResolved = getImportProtectionRelativePath( + config.root, + edge.resolved, + ) + + const importProtectionCheck = getRsbuildResolvedImportProtectionCheck( + relativeResolved, + matchers, + ) + if (!importProtectionCheck) { + continue + } + + if (importProtectionCheck.type === 'file') { + const info = await buildViolationInfo({ + config, + provider, + graph, + importLocCache, + perf, + envName, + envType, + importer: edge.importer, + source: edge.specifier, + resolved: edge.resolved, + type: 'file', + pattern: importProtectionCheck.fileMatch.pattern, + }) + + await reportViolation({ + config, + envState, + compilation: context.compilation, + rspack: context.compiler.rspack, + perf, + info, + }) + continue + } + + const markerKind = await getMarkerKindForFile({ + config, + provider, + loadOriginalCode: loadOriginalCodeFromCompilation, + markerKindCache, + file: edge.resolved, + }) + const violatesMarker = + (envType === 'client' && markerKind === 'server') || + (envType === 'server' && markerKind === 'client') + + if (!violatesMarker) { + continue + } + + const info = await buildViolationInfo({ + config, + provider, + graph, + importLocCache, + perf, + envName, + envType, + importer: edge.importer, + source: edge.specifier, + resolved: edge.resolved, + type: 'marker', + }) + + await reportViolation({ + config, + envState, + compilation: context.compilation, + rspack: context.compiler.rspack, + perf, + info, + }) + } + + if (config.command === 'build') { + const seenInactiveFileEdgeKeys = new Set() + for (const edge of inactiveEdges) { + if (!edge.specifier) { + continue + } + if (!shouldCheckImporter(edge.importer)) { + continue + } + const liveEdgeKey = `${normalizeFilePath(edge.importer)}::${edge.specifier}::${normalizeFilePath(edge.resolved)}` + if (liveFileEdgeKeys.has(liveEdgeKey)) { + continue + } + if (seenInactiveFileEdgeKeys.has(liveEdgeKey)) { + continue + } + seenInactiveFileEdgeKeys.add(liveEdgeKey) + if (!didModuleSurvive(edge.resolved)) { + continue + } + if (!didModuleSurvive(edge.importer)) { + continue + } + + const transformResult = provider.getTransformResult(edge.importer) + if ( + !hasOriginalUnsafeUsage(transformResult, edge.specifier, envType) + ) { + continue + } + + const relativeResolved = getImportProtectionRelativePath( + config.root, + edge.resolved, + ) + const fileMatch = checkFileDenial(relativeResolved, matchers) + if (!fileMatch) { + continue + } + + const info = await buildViolationInfo({ + config, + provider, + graph, + importLocCache, + perf, + envName, + envType, + importer: edge.importer, + source: edge.specifier, + resolved: edge.resolved, + type: 'file', + pattern: fileMatch.pattern, + preferOriginalCode: true, + }) + + await reportViolation({ + config, + envState, + compilation: context.compilation, + rspack: context.compiler.rspack, + perf, + info, + }) + } + } + + for (const violation of envState.deferredFileViolations) { + const liveEdgeKey = `${normalizeFilePath(violation.importer)}::${violation.specifier}::${normalizeFilePath(violation.resolved)}` + if (liveFileEdgeKeys.has(liveEdgeKey)) { + continue + } + + if (!didModuleSurvive(violation.resolved)) { + continue + } + + if (!didModuleSurvive(violation.importer)) { + continue + } + + const info = await buildViolationInfo({ + config, + provider, + graph, + importLocCache, + perf, + envName, + envType, + importer: violation.importer, + source: violation.specifier, + resolved: violation.resolved, + type: 'file', + pattern: violation.pattern, + preferOriginalCode: violation.useOriginalLocation, + }) + + await reportViolation({ + config, + envState, + compilation: context.compilation, + rspack: context.compiler.rspack, + perf, + info, + }) + } + } finally { + if (perf) { + perf.time('processAssets', startedAt) + perf.flush(config.root, envName, 'processAssets') + } + } + }, + ) +} diff --git a/packages/start-plugin-core/src/rsbuild/index.ts b/packages/start-plugin-core/src/rsbuild/index.ts new file mode 100644 index 0000000000..46d1f1b58b --- /dev/null +++ b/packages/start-plugin-core/src/rsbuild/index.ts @@ -0,0 +1,9 @@ +export { RSBUILD_ENVIRONMENT_NAMES } from './planning' +export type { TanStackStartRsbuildPluginCoreOptions } from './types' +export type { TanStackStartRsbuildInputConfig } from './schema' +export type { + StartCompilerImportTransform, + StartCompilerTransformCandidate, + StartCompilerTransformContext, +} from '../types' +export { tanStackStartRsbuild } from './plugin' diff --git a/packages/start-plugin-core/src/rsbuild/normalized-client-build.ts b/packages/start-plugin-core/src/rsbuild/normalized-client-build.ts new file mode 100644 index 0000000000..60244fdca9 --- /dev/null +++ b/packages/start-plugin-core/src/rsbuild/normalized-client-build.ts @@ -0,0 +1,396 @@ +import { tsrSplit } from '@tanstack/router-plugin' +import { tssHydrate } from '../hydration-constants' +import { getCssAssetSource } from '../start-manifest-plugin/inlineCss' +import { RSBUILD_ENVIRONMENT_NAMES } from './planning' +import type { RsbuildPluginAPI, Rspack } from '@rsbuild/core' +import type { NormalizedClientBuild, NormalizedClientChunk } from '../types' + +type ProcessAssetsContext = Parameters< + Parameters[1] +>[0] +type RspackCompilation = Rspack.Compilation +type RspackCompilationChunk = Rspack.Chunk +type RspackModule = Rspack.Module + +/** + * Extract route file paths from rspack module identifiers. + * + * In rspack, module identifiers contain query params similar to Vite's moduleIds. + * We look for the `tsr-split` query to identify route-split chunks. + */ +function getRouteFilePathsFromModules( + modules: Array, +): Array { + let routeFilePaths: Array | undefined + let seen: Set | undefined + + for (const mod of modules) { + const identifier = mod.identifier() + + // rspack module identifiers include loader prefixes separated by '!'. + // The actual file path (with query string) is after the last '!'. + // Example: "builtin:swc-loader??ruleSet[...]!.../transform.js??...!.../rsc-basic.tsx?tsr-split=component" + const lastBangIndex = identifier.lastIndexOf('!') + const resourcePart = + lastBangIndex >= 0 ? identifier.slice(lastBangIndex + 1) : identifier + + const queryIndex = resourcePart.indexOf('?') + if (queryIndex < 0) continue + + const query = resourcePart.slice(queryIndex + 1) + if (!query.includes(tsrSplit)) continue + if (!new URLSearchParams(query).has(tsrSplit)) continue + + const nameForCondition = mod.nameForCondition() + const routeFilePath = nameForCondition ?? resourcePart.slice(0, queryIndex) + + if (seen?.has(routeFilePath)) continue + + if (!routeFilePaths || !seen) { + routeFilePaths = [] + seen = new Set() + } + + routeFilePaths.push(routeFilePath) + seen.add(routeFilePath) + } + + return routeFilePaths ?? [] +} + +function getHydrationIdsFromModules( + modules: Array, +): Array { + let hydrationIds: Array | undefined + let seen: Set | undefined + + for (const mod of modules) { + const identifier = mod.identifier() + const lastBangIndex = identifier.lastIndexOf('!') + const resourcePart = + lastBangIndex >= 0 ? identifier.slice(lastBangIndex + 1) : identifier + + const queryIndex = resourcePart.indexOf('?') + if (queryIndex < 0) continue + + const query = resourcePart.slice(queryIndex + 1) + if (!query.includes(tssHydrate)) continue + + const hydrationId = new URLSearchParams(query).get(tssHydrate) + if (!hydrationId || seen?.has(hydrationId)) continue + + if (!hydrationIds || !seen) { + hydrationIds = [] + seen = new Set() + } + + hydrationIds.push(hydrationId) + seen.add(hydrationId) + } + + return hydrationIds ?? [] +} + +/** + * Returns true for Rspack/webpack HMR runtime chunks that should never be + * surfaced to the Start manifest. These files are emitted on every rebuild + * (e.g. `index..hot-update.mjs`) and must not be treated as the entry + * chunk, route preloads, or sibling imports. + */ +function isHotUpdateAsset(file: string): boolean { + return file.includes('.hot-update.') +} + +/** + * True for any JS/MJS asset that should be included in the manifest. + * Excludes HMR runtime patches. + */ +function isManifestJsAsset(file: string): boolean { + if (!file.endsWith('.js') && !file.endsWith('.mjs')) return false + return !isHotUpdateAsset(file) +} + +/** + * Get all JS file names from a chunk. + */ +function getChunkJsFiles(chunk: RspackCompilationChunk): Array { + const jsFiles: Array = [] + for (const file of chunk.files) { + if (isManifestJsAsset(file)) { + jsFiles.push(file) + } + } + return jsFiles +} + +/** + * Compute dynamicImports for a chunk by traversing its chunk groups' + * childrenIterable (async/dynamic import edges). + * + * In rspack, a chunk belongs to one or more ChunkGroups. Each ChunkGroup + * has childrenIterable — child ChunkGroups representing dynamic import() + * points. The JS files from those child groups' chunks are the + * dynamicImports (analogous to Rollup's OutputChunk.dynamicImports). + */ +function computeDynamicImports(chunk: RspackCompilationChunk): Array { + const dynamicImportFiles: Array = [] + const seen = new Set() + + for (const group of chunk.groupsIterable) { + for (const childGroup of group.childrenIterable) { + for (const childChunk of childGroup.chunks) { + for (const file of childChunk.files) { + if (isManifestJsAsset(file) && !seen.has(file)) { + seen.add(file) + dynamicImportFiles.push(file) + } + } + } + } + } + + return dynamicImportFiles +} + +/** + * Compute static imports (sibling chunks) for an async chunk. + * + * In rspack/webpack, an async chunk's ChunkGroup contains ALL chunks needed to + * satisfy that dynamic import — the async chunk itself plus any shared/vendor + * chunks it statically imports. This is analogous to Rollup's + * `OutputChunk.imports` for async chunks. + * + * We collect JS files from all sibling chunks in the group (excluding the + * current chunk's own file) to populate the `imports` field. + */ +function computeAsyncChunkImports( + chunk: RspackCompilationChunk, + currentFile: string, +): Array { + const imports: Array = [] + const seen = new Set() + seen.add(currentFile) + + for (const group of chunk.groupsIterable) { + for (const siblingChunk of group.chunks) { + for (const file of siblingChunk.files) { + if (isManifestJsAsset(file) && !seen.has(file)) { + seen.add(file) + imports.push(file) + } + } + } + } + + return imports +} + +/** + * Normalize an rspack compilation into a NormalizedClientBuild. + * + * Iterates ALL chunks in the compilation (initial + async), not just + * entrypoint chunks, to ensure route-split async chunks are included. + */ +export function normalizeRspackClientBuild( + compilation: RspackCompilation, +): NormalizedClientBuild { + const chunksByFileName = new Map() + const chunkFileNamesByRouteFilePath = new Map>() + const cssFilesBySourcePath = new Map>() + const cssContentByFileName = new Map() + let entryChunkFileName: string | undefined + + // Collect all initial JS file names from the main entry for computing + // the entry chunk's `imports` (vendor/shared sibling chunks). + const entrypoint = compilation.entrypoints.get('index') + const initialJsFileNames: Array = [] + const entryChunkSet = new Set() + if (entrypoint) { + for (const chunk of entrypoint.chunks) { + entryChunkSet.add(chunk) + for (const file of chunk.files) { + if (isManifestJsAsset(file)) { + initialJsFileNames.push(file) + } + } + } + } + + // Iterate ALL chunks (initial + async) to capture route-split chunks + for (const chunk of compilation.chunks) { + const modules = compilation.chunkGraph.getChunkModules(chunk) + const routeFilePaths = getRouteFilePathsFromModules(modules) + const hydrationIds = getHydrationIdsFromModules(modules) + const cssFiles: Array = [] + const seenCssFiles = new Set() + + for (const auxFile of chunk.auxiliaryFiles) { + if (auxFile.endsWith('.css') && !seenCssFiles.has(auxFile)) { + seenCssFiles.add(auxFile) + cssFiles.push(auxFile) + } + } + + for (const mainFile of chunk.files) { + if (mainFile.endsWith('.css') && !seenCssFiles.has(mainFile)) { + seenCssFiles.add(mainFile) + cssFiles.push(mainFile) + } + } + + if (cssFiles.length > 0) { + for (const mod of modules) { + const sourcePath = mod.nameForCondition() + if (!sourcePath) continue + + const existing = cssFilesBySourcePath.get(sourcePath) + cssFilesBySourcePath.set( + sourcePath, + existing ? appendUniqueStrings(existing, cssFiles) : cssFiles.slice(), + ) + } + } + + // The entry chunk is the one named 'index' in the 'index' entrypoint + const isEntryChunk = chunk.name === 'index' && entryChunkSet.has(chunk) + + const jsFiles = getChunkJsFiles(chunk) + if (jsFiles.length === 0) continue + + // Compute dynamicImports from chunk group children + const dynamicImports = computeDynamicImports(chunk) + + for (const file of jsFiles) { + // For the entry chunk, `imports` contains all sibling initial chunks + // (vendor/shared). For async chunks, `imports` contains all sibling + // chunks from the ChunkGroup (shared dependencies the browser must + // load alongside this chunk). This mirrors Rollup's + // OutputChunk.imports which lists statically imported chunks. + const imports = isEntryChunk + ? initialJsFileNames.filter((f) => f !== file) + : computeAsyncChunkImports(chunk, file) + + const normalizedChunk: NormalizedClientChunk = { + fileName: file, + isEntry: isEntryChunk, + imports, + dynamicImports, + css: [], + routeFilePaths, + hydrationIds, + } + + chunksByFileName.set(file, normalizedChunk) + + if (isEntryChunk && !entryChunkFileName) { + entryChunkFileName = file + } + + for (const routeFilePath of routeFilePaths) { + let chunkFileNames = chunkFileNamesByRouteFilePath.get(routeFilePath) + if (!chunkFileNames) { + chunkFileNames = [] + chunkFileNamesByRouteFilePath.set(routeFilePath, chunkFileNames) + } + chunkFileNames.push(file) + } + } + + for (const cssFile of cssFiles) { + for (const file of jsFiles) { + const existing = chunksByFileName.get(file) + if (existing && !existing.css.includes(cssFile)) { + existing.css.push(cssFile) + } + } + } + } + + if (!entryChunkFileName) { + throw new Error('No entry file found in rspack client build') + } + + for (const asset of compilation.getAssets()) { + if (!asset.name.endsWith('.css')) { + continue + } + + const css = getCssAssetSource(asset.source.source()) + if (css !== undefined) { + cssContentByFileName.set(asset.name, css) + } + } + + // In RSC mode, CSS from server components is associated with the 'rsc' + // client entry chunk (not the main 'index' entry). The manifest builder + // merges the entry chunk's CSS into __root__, so by appending RSC CSS + // to the entry chunk, those stylesheets get loaded on all pages. + // CSS may appear in either `files` or `auxiliaryFiles` depending on + // rspack's CSS extraction strategy. + const rscEntrypoint = compilation.entrypoints.get('rsc') + + if (rscEntrypoint && entryChunkFileName) { + const mainEntryChunk = chunksByFileName.get(entryChunkFileName) + if (mainEntryChunk) { + for (const rscChunk of rscEntrypoint.chunks) { + const allFiles = [...rscChunk.files, ...rscChunk.auxiliaryFiles] + for (const file of allFiles) { + if (file.endsWith('.css') && !mainEntryChunk.css.includes(file)) { + mainEntryChunk.css.push(file) + } + } + } + } + } + + return { + entryChunkFileName, + chunksByFileName, + chunkFileNamesByRouteFilePath, + cssFilesBySourcePath, + cssContentByFileName, + } +} + +function appendUniqueStrings( + target: Array, + source: Array, +): Array { + const seen = new Set(target) + let result: Array | undefined + + for (const value of source) { + if (seen.has(value)) continue + seen.add(value) + if (!result) { + result = target.slice() + } + result.push(value) + } + + return result ?? target +} + +/** + * Registers a processAssets hook to capture the client build stats + * after compilation. Returns a getter for the captured build. + */ +export function registerClientBuildCapture(api: RsbuildPluginAPI): { + getClientBuild: () => NormalizedClientBuild | undefined +} { + let clientBuild: NormalizedClientBuild | undefined + + api.processAssets( + { + stage: 'report', + environments: [RSBUILD_ENVIRONMENT_NAMES.client], + }, + (context: ProcessAssetsContext) => { + clientBuild = normalizeRspackClientBuild(context.compilation) + }, + ) + + return { + getClientBuild: () => clientBuild, + } +} diff --git a/packages/start-plugin-core/src/rsbuild/planning.ts b/packages/start-plugin-core/src/rsbuild/planning.ts new file mode 100644 index 0000000000..e6518ad2e6 --- /dev/null +++ b/packages/start-plugin-core/src/rsbuild/planning.ts @@ -0,0 +1,262 @@ +import { createRequire } from 'node:module' +import { join } from 'pathe' +import { mergeRsbuildConfig } from '@rsbuild/core' +import { ENTRY_POINTS } from '../constants' +import type { EnvironmentConfig } from '@rsbuild/core' +import type { ResolvedStartEntryPlan } from '../planning' +import type { RsbuildEnvironmentOverrides } from './types' +import type { ScriptFormat } from '@tanstack/router-core' + +const require = createRequire(import.meta.url) + +export const RSBUILD_ENVIRONMENT_NAMES = { + client: 'client', + server: 'ssr', +} as const + +/** + * Rspack layer names for the rsbuild RSC layered model. + * These match the canonical names from `rspack.experiments.rsc.Layers`. + */ +export const RSBUILD_RSC_LAYERS = { + /** React Server Components layer — uses `react-server` resolve condition */ + rsc: 'react-server-components', + /** Server-Side Rendering layer — standard Node resolve */ + ssr: 'server-side-rendering', +} as const + +export const RSBUILD_CLIENT_ASSETS_DIR = 'assets' + +export type RsbuildEnvironmentName = + (typeof RSBUILD_ENVIRONMENT_NAMES)[keyof typeof RSBUILD_ENVIRONMENT_NAMES] + +type RsbuildDistPath = NonNullable['distPath'] + +export interface RsbuildResolvedEntryAliases { + client: string + server: string + start: string + router: string + alias: Record<(typeof ENTRY_POINTS)[keyof typeof ENTRY_POINTS], string> +} + +export function createRsbuildResolvedEntryAliases(opts: { + entryPaths: ResolvedStartEntryPlan['entryPaths'] +}): RsbuildResolvedEntryAliases { + const client = normalizeEntryPath(opts.entryPaths.client) + const server = normalizeEntryPath(opts.entryPaths.server) + const start = normalizeEntryPath(opts.entryPaths.start) + const router = normalizeEntryPath(opts.entryPaths.router) + + return { + client, + server, + start, + router, + alias: { + [ENTRY_POINTS.client]: client, + [ENTRY_POINTS.server]: server, + [ENTRY_POINTS.start]: start, + [ENTRY_POINTS.router]: router, + }, + } +} + +export interface RsbuildEnvironmentPlanResult { + environments: Record + alias: Record +} + +export function createRsbuildEnvironmentPlan(opts: { + root: string + entryAliases: RsbuildResolvedEntryAliases + clientOutputDirectory: string + serverOutputDirectory: string + publicBase: string + serverFnProviderEnv: string + environmentOverrides?: RsbuildEnvironmentOverrides + scriptFormat?: ScriptFormat + rsc?: boolean | undefined + dev?: boolean | undefined +}): RsbuildEnvironmentPlanResult { + const alias = { + ...opts.entryAliases.alias, + ...(opts.rsc + ? { + 'react-server-dom-rspack/server$': resolveFromRoot( + 'react-server-dom-rspack/server.node', + opts.root, + ), + } + : {}), + } + const environmentOverrides = opts.environmentOverrides ?? {} + const scriptFormat = opts.scriptFormat ?? 'module' + const clientOutputModule = scriptFormat === 'module' + const userClientOutputModule = + environmentOverrides.client?.output?.module ?? + environmentOverrides.all?.output?.module + + if ( + typeof userClientOutputModule === 'boolean' && + userClientOutputModule !== clientOutputModule + ) { + throw new Error( + 'TanStack Start rsbuild.client.output controls environments.client.output.module. Remove environments.client.output.module or set rsbuild.client.output to match it.', + ) + } + + return { + environments: { + [RSBUILD_ENVIRONMENT_NAMES.client]: mergeRsbuildConfig( + { + source: { + entry: { + index: { + import: opts.entryAliases.client, + html: false, + }, + }, + }, + output: { + target: 'web', + module: clientOutputModule, + distPath: { + root: opts.clientOutputDirectory, + js: `${RSBUILD_CLIENT_ASSETS_DIR}/js`, + jsAsync: `${RSBUILD_CLIENT_ASSETS_DIR}/js/async`, + css: `${RSBUILD_CLIENT_ASSETS_DIR}/css`, + cssAsync: `${RSBUILD_CLIENT_ASSETS_DIR}/css/async`, + svg: `${RSBUILD_CLIENT_ASSETS_DIR}/svg`, + font: `${RSBUILD_CLIENT_ASSETS_DIR}/font`, + wasm: `${RSBUILD_CLIENT_ASSETS_DIR}/wasm`, + image: `${RSBUILD_CLIENT_ASSETS_DIR}/image`, + media: `${RSBUILD_CLIENT_ASSETS_DIR}/media`, + assets: `${RSBUILD_CLIENT_ASSETS_DIR}/assets`, + }, + assetPrefix: opts.publicBase, + }, + resolve: { + alias, + }, + // Only split async chunks (route code-splitting). Keep all initial + // vendor/shared code inlined in the entry chunk so the SSR HTML only + // needs the single client entry bootstrap. + performance: { + chunkSplit: { + strategy: 'custom', + override: { + chunks: 'async', + }, + }, + }, + }, + environmentOverrides.all, + environmentOverrides.client, + ), + [RSBUILD_ENVIRONMENT_NAMES.server]: mergeRsbuildConfig( + { + source: { + entry: { + index: { + import: opts.entryAliases.server, + html: false, + ...(opts.rsc ? { layer: RSBUILD_RSC_LAYERS.ssr } : {}), + }, + }, + }, + output: { + target: 'node', + // Rsbuild's dev `loadBundle()` path evaluates ESM via vm.SourceTextModule, + // which requires `--experimental-vm-modules`. Emit CJS for the dev + // server bundle so SSR works without extra Node flags. + ...(opts.dev ? { module: false } : {}), + distPath: { + root: opts.serverOutputDirectory, + }, + }, + resolve: { + alias, + }, + ...(opts.rsc + ? { + splitChunks: { + preset: 'single-vendor', + }, + } + : {}), + }, + environmentOverrides.all, + environmentOverrides.server, + ), + // When provider is a separate environment (not layered RSC), + // create a third environment. With the layered RSC setup this branch + // is not taken because provider maps to the same `ssr` environment. + ...(opts.serverFnProviderEnv !== RSBUILD_ENVIRONMENT_NAMES.server && + !opts.rsc + ? { + [opts.serverFnProviderEnv]: mergeRsbuildConfig( + { + source: { + entry: { + index: { + import: opts.entryAliases.server, + html: false, + }, + }, + }, + output: { + target: 'node', + ...(opts.dev ? { module: false } : {}), + distPath: { + root: `${opts.serverOutputDirectory}/${opts.serverFnProviderEnv}`, + }, + }, + resolve: { + alias, + }, + }, + environmentOverrides.all, + environmentOverrides.provider, + ), + } + : {}), + }, + alias, + } +} + +export function resolveRsbuildOutputDirectory(opts: { + distPath: RsbuildDistPath | undefined + rootDistPath: RsbuildDistPath | undefined + fallback: string + subdirectory: string +}): string { + if (typeof opts.distPath === 'string') { + return opts.distPath + } + + if (typeof opts.distPath?.root === 'string') { + return opts.distPath.root + } + + if (typeof opts.rootDistPath === 'string') { + return join(opts.rootDistPath, opts.subdirectory) + } + + if (typeof opts.rootDistPath?.root === 'string') { + return join(opts.rootDistPath.root, opts.subdirectory) + } + + return opts.fallback +} + +function normalizeEntryPath(path: string) { + return path.includes('\\') ? path.replaceAll('\\', '/') : path +} + +function resolveFromRoot(specifier: string, root: string): string { + return require.resolve(specifier, { + paths: [root], + }) +} diff --git a/packages/start-plugin-core/src/rsbuild/plugin.ts b/packages/start-plugin-core/src/rsbuild/plugin.ts new file mode 100644 index 0000000000..c18222f426 --- /dev/null +++ b/packages/start-plugin-core/src/rsbuild/plugin.ts @@ -0,0 +1,843 @@ +import { existsSync, readdirSync, realpathSync, statSync } from 'node:fs' +import { dirname, join, resolve } from 'node:path' +import { fileURLToPath } from 'node:url' +import { joinURL } from 'ufo' +import { + applyResolvedBaseAndOutput, + applyResolvedRouterBasepath, + createStartConfigContext, +} from '../config-context' +import { escapeRegExp, normalizePath } from '../utils' +import { createServerFnBasePath, normalizePublicBase } from '../planning' +import { parseStartConfig, rsbuildClientOutputSchema } from './schema' +import { + RSBUILD_CLIENT_ASSETS_DIR, + RSBUILD_ENVIRONMENT_NAMES, + RSBUILD_RSC_LAYERS, + createRsbuildEnvironmentPlan, + createRsbuildResolvedEntryAliases, + resolveRsbuildOutputDirectory, +} from './planning' +import { registerStartCompilerTransforms } from './start-compiler-host' +import { registerImportProtection } from './import-protection' +import { + START_MANIFEST_PLACEHOLDER, + registerVirtualModules, +} from './virtual-modules' +import { createServerSetup } from './dev-server' +import { registerClientBuildCapture } from './normalized-client-build' +import { registerRouterPlugins } from './start-router-plugin' +import { postBuildWithRsbuild } from './post-build' +import { enableSwcReactServerComponents } from './swc-rsc' +import type { ServerFn } from '../start-compiler/types' +import type { TanStackStartRsbuildPluginCoreOptions } from './types' +import type { + ModifyRspackConfigFn, + RsbuildDevServer, + RsbuildPlugin, + RsbuildPluginAPI, + Rspack, + rspack as rspackNamespaceType, +} from '@rsbuild/core' +import type { TanStackStartRsbuildInputConfig } from './schema' +import type { ScriptFormat } from '@tanstack/router-core' + +// Detect whether this plugin source is running from inside the TanStack +// Router monorepo (packages/start-plugin-core/src/rsbuild/plugin.ts). When +// installed from npm in a user app, the path structure is different and +// this evaluates to false. Used to gate dev-only workarounds that only +// matter when workspace package dists are symlinked into node_modules. +const currentDir = dirname(fileURLToPath(import.meta.url)) +const isInsideRouterMonoRepo = (() => { + // src layout: /packages/start-plugin-core/src/rsbuild → 4 levels up + // dist layout (CJS/ESM): /packages/start-plugin-core/dist//rsbuild + // → also 4 levels up + const candidate = resolve(currentDir, '../../../../') + return candidate.endsWith('/packages') || candidate.endsWith('\\packages') +})() + +type RspackNamespace = typeof rspackNamespaceType +type RscPluginPair = ReturnType< + NonNullable['createPlugins'] +> +type RspackConfig = Parameters[0] +type RspackCompiler = Rspack.Compiler +type RspackCompilationExtended = Rspack.Compilation +type RspackAsset = ReturnType[number] + +export function tanStackStartRsbuild( + corePluginOpts: TanStackStartRsbuildPluginCoreOptions, + startPluginOpts: TanStackStartRsbuildInputConfig = {}, +): RsbuildPlugin { + const rscOpts = corePluginOpts.rsc + const rscEnabled = Boolean(rscOpts) + + const configContext = createStartConfigContext({ + corePluginOpts, + startPluginOpts, + parseConfig: parseStartConfig, + }) + const { getConfig, resolvedStartConfig } = configContext + const serverFnProviderEnv = corePluginOpts.providerEnvironmentName + const ssrIsProvider = corePluginOpts.ssrIsProvider + const scriptFormat = rsbuildClientOutputSchema.parse( + startPluginOpts.rsbuild?.client?.output ?? 'module', + ) satisfies ScriptFormat + + // RSC plugin instances — created lazily when rspack namespace is available + let rscPlugins: RscPluginPair | undefined + + // Reference to the dev server for RSC HMR socket writes + let devServerRef: Pick | null = null + const serverFnsById: Record = {} + let updateServerFnResolver: (() => void) | undefined + + return { + name: 'tanstack-start-rsbuild', + setup(api: RsbuildPluginAPI) { + const startCompilerEnvironments = [ + { name: RSBUILD_ENVIRONMENT_NAMES.client, type: 'client' as const }, + { name: RSBUILD_ENVIRONMENT_NAMES.server, type: 'server' as const }, + ...(serverFnProviderEnv !== RSBUILD_ENVIRONMENT_NAMES.server && + !rscEnabled + ? [{ name: serverFnProviderEnv, type: 'server' as const }] + : []), + ] + const startCompilerServerEnvironmentNames = startCompilerEnvironments + .filter((env) => env.type === 'server') + .map((env) => env.name) + + // --------------------------------------------------------------- + // 1. modifyRsbuildConfig — resolve config, set up environments + // --------------------------------------------------------------- + api.modifyRsbuildConfig((rsbuildConfig, { mergeRsbuildConfig }) => { + const root = + typeof rsbuildConfig.root === 'string' + ? rsbuildConfig.root + : process.cwd() + + const serverBase = rsbuildConfig.server?.base + const assetPrefix = rsbuildConfig.output?.assetPrefix + const publicBase = normalizePublicBase( + typeof serverBase === 'string' + ? serverBase + : typeof assetPrefix === 'string' && assetPrefix !== 'auto' + ? assetPrefix + : undefined, + ) + const rootDistPath = rsbuildConfig.output?.distPath + const clientDistPath = + rsbuildConfig.environments?.[RSBUILD_ENVIRONMENT_NAMES.client]?.output + ?.distPath + const serverDistPath = + rsbuildConfig.environments?.[RSBUILD_ENVIRONMENT_NAMES.server]?.output + ?.distPath + + applyResolvedBaseAndOutput({ + resolvedStartConfig, + root, + publicBase, + clientOutputDirectory: resolveRsbuildOutputDirectory({ + distPath: clientDistPath, + rootDistPath, + fallback: 'dist/client', + subdirectory: 'client', + }), + serverOutputDirectory: resolveRsbuildOutputDirectory({ + distPath: serverDistPath, + rootDistPath, + fallback: 'dist/server', + subdirectory: 'server', + }), + }) + + const { startConfig } = getConfig() + const routerBasepath = applyResolvedRouterBasepath({ + resolvedStartConfig, + startConfig, + }) + + const resolvedEntryPlan = configContext.resolveEntries() + const isDev = api.context.action === 'dev' + + const entryAliases = createRsbuildResolvedEntryAliases({ + entryPaths: resolvedEntryPlan.entryPaths, + }) + + const environmentPlan = createRsbuildEnvironmentPlan({ + root, + entryAliases, + clientOutputDirectory: resolvedStartConfig.outputDirectories.client, + serverOutputDirectory: resolvedStartConfig.outputDirectories.server, + publicBase: resolvedStartConfig.basePaths.publicBase, + serverFnProviderEnv, + environmentOverrides: corePluginOpts.rsbuild?.environments, + scriptFormat, + rsc: rscOpts, + dev: isDev, + }) + const serverFnBase = createServerFnBasePath({ + routerBasepath, + serverFnBase: startConfig.serverFns.base, + }) + const inlineCssEnabled = + !isDev && startConfig.server.build.inlineCss.enabled + + return mergeRsbuildConfig(rsbuildConfig, { + source: { + define: { + 'process.env.TSS_SERVER_FN_BASE': JSON.stringify(serverFnBase), + 'import.meta.env.TSS_SERVER_FN_BASE': + JSON.stringify(serverFnBase), + 'process.env.TSS_ROUTER_BASEPATH': JSON.stringify(routerBasepath), + 'import.meta.env.TSS_ROUTER_BASEPATH': + JSON.stringify(routerBasepath), + 'process.env.TSS_DEV_SERVER': JSON.stringify( + isDev ? 'true' : 'false', + ), + 'import.meta.env.TSS_DEV_SERVER': JSON.stringify( + isDev ? 'true' : 'false', + ), + // Rsbuild dev already injects emitted CSS asset hrefs, so keep + // Start's synthetic `/@tanstack-start/styles.css` path disabled. + 'process.env.TSS_DEV_SSR_STYLES_ENABLED': JSON.stringify('false'), + 'import.meta.env.TSS_DEV_SSR_STYLES_ENABLED': + JSON.stringify('false'), + 'process.env.TSS_DEV_SSR_STYLES_BASEPATH': JSON.stringify( + resolvedStartConfig.basePaths.publicBase, + ), + 'import.meta.env.TSS_DEV_SSR_STYLES_BASEPATH': JSON.stringify( + resolvedStartConfig.basePaths.publicBase, + ), + 'process.env.TSS_INLINE_CSS_ENABLED': JSON.stringify( + inlineCssEnabled ? 'true' : 'false', + ), + 'import.meta.env.TSS_INLINE_CSS_ENABLED': JSON.stringify( + inlineCssEnabled ? 'true' : 'false', + ), + 'process.env.TSS_DISABLE_CSRF_MIDDLEWARE_WARNING': JSON.stringify( + startConfig.serverFns.disableCsrfMiddlewareWarning + ? 'true' + : 'false', + ), + 'import.meta.env.TSS_DISABLE_CSRF_MIDDLEWARE_WARNING': + JSON.stringify( + startConfig.serverFns.disableCsrfMiddlewareWarning + ? 'true' + : 'false', + ), + }, + }, + server: { + // Rsbuild compression currently treats Node's raw header array + // writeHead form as an object, which corrupts SSR response headers. + compress: false, + // SSR apps render every route on the server — disable HTML + // fallback so rsbuild doesn't intercept /_serverFn/ URLs. + htmlFallback: false, + // server.setup returned callback runs after built-in middleware + // but BEFORE fallback middleware — the ideal slot for SSR. + ...(isDev && + startPluginOpts.rsbuild?.installDevServerMiddleware !== false + ? { + setup: createServerSetup({ + serverFnBasePath: serverFnBase, + }), + } + : {}), + }, + ...(isDev + ? { + dev: { + lazyCompilation: false, + ...(rscEnabled ? { liveReload: false } : {}), + }, + } + : {}), + environments: environmentPlan.environments, + resolve: { + alias: environmentPlan.alias, + }, + }) + }) + + // --------------------------------------------------------------- + // 2. StartCompiler transforms — server fns, isomorphic fns, etc. + // --------------------------------------------------------------- + registerStartCompilerTransforms(api, { + framework: corePluginOpts.framework, + // modifyRsbuildConfig copies rsbuildConfig.root into resolvedStartConfig.root, + // so defer this read until transform time instead of falling back to + // process.cwd() during plugin setup. + root: () => resolvedStartConfig.root || process.cwd(), + environments: startCompilerEnvironments, + providerEnvName: serverFnProviderEnv, + generateFunctionId: startPluginOpts.serverFns?.generateFunctionId, + compilerTransforms: corePluginOpts.compilerTransforms, + serverFnProviderModuleDirectives: + corePluginOpts.serverFnProviderModuleDirectives, + serverFnsById, + onServerFnsByIdChange: () => { + updateServerFnResolver?.() + }, + }) + + registerImportProtection(api, { + getConfig, + framework: corePluginOpts.framework, + environments: startCompilerEnvironments, + }) + + // --------------------------------------------------------------- + // 3. Virtual modules — manifest, server fn resolver, adapters, + // RSC runtime, RSC HMR + // --------------------------------------------------------------- + const virtualModuleState = registerVirtualModules(api, { + root: resolvedStartConfig.root || process.cwd(), + getConfig, + serverFnsById, + providerEnvName: serverFnProviderEnv, + ssrIsProvider, + serializationAdapters: corePluginOpts.serializationAdapters, + getDevClientEntryUrl: (publicBase: string) => + joinURL(publicBase, RSBUILD_CLIENT_ASSETS_DIR, 'js/index.js'), + rscEnabled, + scriptFormat, + }) + updateServerFnResolver = virtualModuleState.updateServerFnResolver + + if (!rscEnabled) { + api.modifyRspackConfig((config, utils) => { + if ( + !startCompilerServerEnvironmentNames.includes( + utils.environment.name, + ) + ) { + return + } + + config.plugins.push({ + apply(compiler: RspackCompiler) { + compiler.hooks.finishMake.tapPromise( + { + name: 'TanStackStartServerFnResolverRebuild', + stage: -10, + }, + async (compilation: RspackCompilationExtended) => { + virtualModuleState.updateServerFnResolver() + + await rebuildModulesContaining( + compilation, + virtualModuleState.serverFnResolverPath, + ) + }, + ) + }, + }) + }) + } + + // --------------------------------------------------------------- + // 4. Client build stats capture via processAssets + // --------------------------------------------------------------- + const { getClientBuild } = registerClientBuildCapture(api) + + // --------------------------------------------------------------- + // 4b. Server manifest module generation (build only) + // For ordinary multi-environment builds, Rsbuild can compile the + // server environment after the client environment finishes. Generate + // the final manifest as module source in that phase instead of + // patching emitted server assets afterwards. + // --------------------------------------------------------------- + if (api.context.action !== 'dev') { + const normalizedManifestPath = normalizePath( + virtualModuleState.manifestPath, + ) + const matchesManifestPath = (id: string) => + normalizePath(id) === normalizedManifestPath + + api.transform( + { + test: (id: string) => matchesManifestPath(id), + environments: [RSBUILD_ENVIRONMENT_NAMES.server], + }, + ({ code }) => { + const clientBuild = getClientBuild() + + if (clientBuild) { + return virtualModuleState.generateManifestContent(clientBuild) + } + + if (!rscEnabled) { + throw new Error( + 'TanStack Start could not generate the rsbuild server manifest before the client build completed', + ) + } + + // RSC builds cannot express the required client -> server ordering + // through MultiCompiler dependencies, so keep the placeholder for + // the RSC-only asset-patching fallback below. + return code + }, + ) + } + + // --------------------------------------------------------------- + // 5. Router plugin wiring (generator + code splitter) + // --------------------------------------------------------------- + registerRouterPlugins(api, { + getConfig, + corePluginOpts, + startPluginOpts, + }) + + // --------------------------------------------------------------- + // 6. Dev SSR middleware — registered via server.setup in + // modifyRsbuildConfig above (returned callback runs after + // built-ins but before fallback middleware) + // --------------------------------------------------------------- + + // --------------------------------------------------------------- + // 6b. Dev watcher: ignore workspace package `dist/**` directories. + // + // In a real user app, `@tanstack/react-router` and friends live + // inside `node_modules/` and are ignored by Rspack's default + // watcher. In this monorepo, pnpm symlinks them to + // `packages/*/dist` (realpath outside node_modules), so the + // watcher follows them and treats their dist files as live + // sources. If anything rewrites those files during dev, Rspack + // sees transient half-written modules and fails to resolve + // relative imports between them. + // + // Only apply this in monorepo development. In user apps this + // is a no-op — their `node_modules/@tanstack/*/dist/**` is + // already ignored by Rspack's default watchOptions. + // --------------------------------------------------------------- + if (isInsideRouterMonoRepo && api.context.action === 'dev') { + api.modifyRspackConfig((config) => { + const workspaceDistRealpaths = resolveWorkspacePackageDistRealpaths() + if (workspaceDistRealpaths.length === 0) return + + const workspaceDistIgnored = new RegExp( + workspaceDistRealpaths + .map((path) => `^${escapeRegExp(path)}(?:[\\\\/]|$)`) + .join('|'), + ) + const ignored = config.watchOptions?.ignored + + config.watchOptions = { + ...(config.watchOptions ?? {}), + ignored: + ignored == null + ? new RegExp( + `${defaultRspackWatchIgnored.source}|${workspaceDistIgnored.source}`, + ) + : typeof ignored === 'string' + ? [ignored, ...workspaceDistRealpaths] + : Array.isArray(ignored) + ? [...ignored, ...workspaceDistRealpaths] + : new RegExp( + `${ignored.source}|${workspaceDistIgnored.source}`, + ), + } + }) + } + + // --------------------------------------------------------------- + // 7. RSC: rspack layer rules + native RSC plugins + // When RSC is enabled, we add: + // - issuerLayer rule for react-server condition propagation + // - SWC reactServerComponents: true + // - rspack ServerPlugin (server env) / ClientPlugin (client env) + // The Coordinator inside createPlugins() handles compilation + // ordering (server→client→server-actions) automatically. + // --------------------------------------------------------------- + if (rscEnabled) { + api.modifyRspackConfig((config, utils) => { + const envName = utils.environment.name + const isServerEnv = envName === RSBUILD_ENVIRONMENT_NAMES.server + const isClientEnv = envName === RSBUILD_ENVIRONMENT_NAMES.client + + // Create RSC plugin pair lazily (once per build) + if (!rscPlugins) { + rscPlugins = utils.rspack.experiments.rsc.createPlugins() + } + + if (isServerEnv) { + // --- issuerLayer rule: modules imported from RSC layer + // get react-server resolve condition --- + const moduleRules = (config.module.rules ??= []) + const root = resolvedStartConfig.root || process.cwd() + + // Split server-fn provider modules are the actual RSC execution + // boundary in Start's layered model. They must compile in the + // RSC layer so React and react-server-dom-rspack resolve their + // react-server exports without forcing the whole SSR graph into + // react-server conditions. + moduleRules.push({ + resourceQuery: /(?:^|[?&])tss-serverfn-split(?:&|$)/, + layer: RSBUILD_RSC_LAYERS.rsc, + resolve: { + conditionNames: ['react-server', '...'], + }, + }) + + // All modules imported from the RSC layer inherit + // the react-server condition (transitive propagation), except + // route split virtual modules. Those remain ordinary SSR/client + // route code; only `?tsr-shared=1` modules may be shared with the + // provider subtree. + moduleRules.push({ + issuerLayer: RSBUILD_RSC_LAYERS.rsc, + resourceQuery: { + not: [/(?:^|[?&])tsr-split(?:=|&|$)/], + }, + resolve: { + conditionNames: ['react-server', '...'], + }, + }) + + // The RSC ServerPlugin injects imports like + // `react-server-dom-rspack/server` into transformed modules. + // Some modules in the server graph resolve from real package paths + // outside the app root, so relying on the default relative + // `node_modules` lookup is not enough. Seed resolve.modules with the + // app root explicitly, without package-manager-specific heuristics. + seedResolveModules(config, [`${root}/node_modules`, 'node_modules']) + + // Add ServerPlugin with HMR callback + config.plugins.push( + new rscPlugins.ServerPlugin({ + cssLink: { + precedence: false, + props: { + 'data-rsc-css-href': '', + }, + }, + onServerComponentChanges: () => { + // Send rsc:update to connected clients for HMR + devServerRef?.sockWrite('custom', { + event: 'rsc:update', + }) + }, + }), + ) + + config.plugins.push({ + apply(compiler: RspackCompiler) { + compiler.hooks.finishMake.tapPromise( + { + name: 'TanStackStartRscServerFnResolverRebuild', + stage: -10, + }, + async (compilation: RspackCompilationExtended) => { + const resolverContent = + virtualModuleState.generateCurrentResolverContent(true) + virtualModuleState.tryUpdateServerFnResolver( + resolverContent, + ) + + await rebuildModulesContaining( + compilation, + virtualModuleState.serverFnResolverPath, + ) + }, + ) + }, + }) + + if (api.context.action !== 'dev') { + config.plugins.push({ + apply(compiler: RspackCompiler) { + compiler.hooks.finishMake.tapPromise( + { + name: 'TanStackStartRscManifestRebuild', + // The native RSC ServerPlugin completes the client-entry + // handoff during its finishMake hook. Rebuild the manifest + // after that point so the transform hook can emit the final + // manifest source instead of the placeholder. + stage: 10, + }, + async (compilation: RspackCompilationExtended) => { + const clientBuild = getClientBuild() + + if (!clientBuild) { + return + } + + virtualModuleState.updateManifest(clientBuild) + + await rebuildModulesContaining( + compilation, + virtualModuleState.manifestPath, + ) + }, + ) + }, + }) + } + } + + if (isClientEnv) { + // Add ClientPlugin — the Coordinator links it to the + // ServerPlugin's compilation state + config.plugins.push(new rscPlugins.ClientPlugin()) + } + + // --- SWC reactServerComponents --- + // Enable RSC directive detection where the native RSC plugins need it. + // In the server build, scope it to the actual RSC provider subtree so + // ordinary route-split modules (e.g. ?tsr-split=component) stay out of + // RSC validation unless they are really imported by a provider module. + if (isServerEnv) { + enableSwcReactServerComponents(config, 'rsc-subtree') + } else if (isClientEnv) { + enableSwcReactServerComponents(config, 'all') + } + }) + + // Capture dev server reference for RSC HMR socket writes + if (api.context.action === 'dev') { + api.onBeforeStartDevServer(({ server }) => { + devServerRef = server + }) + } + } + + // --------------------------------------------------------------- + // 8. Build ordering — client must complete before server starts + // so that the manifest virtual module has real client build stats. + // Uses rspack MultiCompiler.setDependencies() under the hood. + // + // IMPORTANT: When RSC is enabled we must NOT set dependencies. + // The RSC Coordinator already orchestrates server↔client + // compilation ordering by interleaving phases within compiler + // hooks. Adding setDependencies(server, [client]) on top of + // the Coordinator creates a deadlock: MultiCompiler blocks + // the server compiler until client is `done`, but the + // Coordinator blocks the client's `make` hook until the + // server's entries phase completes — neither can start. + // --------------------------------------------------------------- + if (!rscEnabled) { + api.onAfterCreateCompiler(({ compiler }) => { + // MultiCompiler has a `compilers` array; single compiler does not + if ('compilers' in compiler) { + for (const environmentName of startCompilerServerEnvironmentNames) { + const serverCompiler = compiler.compilers.find( + (c) => c.name === environmentName, + ) + if (serverCompiler) { + const dependencies: Array = [ + RSBUILD_ENVIRONMENT_NAMES.client, + ] + if ( + environmentName === RSBUILD_ENVIRONMENT_NAMES.server && + serverFnProviderEnv !== RSBUILD_ENVIRONMENT_NAMES.server + ) { + dependencies.push(serverFnProviderEnv) + } + + compiler.setDependencies(serverCompiler, dependencies) + } + } + } + }) + } + + // --------------------------------------------------------------- + // 8b. Manifest asset replacement fallback (RSC build only) + // Rsbuild's native RSC coordinator interleaves server and client + // compilers, so the server manifest module can compile before Start's + // normalized client build stats exist. Keep final replacement in the + // server asset pipeline, after the client processAssets capture has a + // chance to run. + // --------------------------------------------------------------- + if (api.context.action !== 'dev' && rscEnabled) { + const manifestPlaceholderLiteral = JSON.stringify( + START_MANIFEST_PLACEHOLDER, + ) + api.modifyRspackConfig((config, utils) => { + if (utils.environment.name !== RSBUILD_ENVIRONMENT_NAMES.server) + return + + config.plugins.push({ + apply(compiler: RspackCompiler) { + compiler.hooks.compilation.tap( + 'TanStackStartManifestReplace', + (compilation: RspackCompilationExtended) => { + compilation.hooks.processAssets.tap( + { + name: 'TanStackStartManifestReplace', + stage: + utils.rspack.Compilation + .PROCESS_ASSETS_STAGE_OPTIMIZE_SIZE, + }, + () => { + let assetsWithPlaceholder: + | Array<{ asset: RspackAsset; sourceStr: string }> + | undefined + + for (const asset of compilation.getAssets()) { + if (!asset.name.endsWith('.js')) { + continue + } + + const sourceStr = String(asset.source.source()) + if (!sourceStr.includes(manifestPlaceholderLiteral)) { + continue + } + + if (!assetsWithPlaceholder) { + assetsWithPlaceholder = [] + } + assetsWithPlaceholder.push({ + asset, + sourceStr, + }) + } + + if (!assetsWithPlaceholder) { + return + } + + const clientBuild = getClientBuild() + if (!clientBuild) { + throw new Error( + 'TanStack Start could not replace the rsbuild RSC server manifest placeholder because the client build was unavailable', + ) + } + + const manifestValueLiteral = + virtualModuleState.generateManifestValueLiteral( + clientBuild, + ) + + for (const { + asset, + sourceStr, + } of assetsWithPlaceholder) { + compilation.updateAsset( + asset.name, + new utils.rspack.sources.RawSource( + sourceStr.replace( + manifestPlaceholderLiteral, + manifestValueLiteral, + ), + ), + ) + } + }, + ) + }, + ) + }, + }) + }) + } + + // --------------------------------------------------------------- + // 9. After client env compiles — refresh resolver + manifest + // --------------------------------------------------------------- + api.onAfterEnvironmentCompile(({ environment }) => { + if (environment.name !== RSBUILD_ENVIRONMENT_NAMES.client) return + + virtualModuleState.updateServerFnResolver() + + const clientBuild = getClientBuild() + if (clientBuild) { + virtualModuleState.updateManifest(clientBuild) + } + }) + + if (api.context.action === 'build') { + api.onAfterBuild(async () => { + const { startConfig } = getConfig() + + await postBuildWithRsbuild({ + startConfig, + clientOutputDirectory: resolvedStartConfig.outputDirectories.client, + serverOutputDirectory: resolvedStartConfig.outputDirectories.server, + }) + }) + } + }, + } +} + +const defaultRspackWatchIgnored = /[\\/](?:\.git|node_modules)[\\/]/ + +function seedResolveModules( + config: RspackConfig, + entries: Array, +): void { + const resolveModules = (config.resolve.modules ??= []) + + for (const entry of entries) { + if (!resolveModules.includes(entry)) { + resolveModules.push(entry) + } + } +} + +function rebuildModulesContaining( + compilation: RspackCompilationExtended, + identifierFragment: string, +): Promise { + const rebuilds: Array> = [] + for (const mod of compilation.modules) { + if (!mod.identifier().includes(identifierFragment)) { + continue + } + + rebuilds.push( + new Promise((resolve, reject) => { + compilation.rebuildModule(mod, (err: Error | null) => { + if (err) reject(err) + else resolve() + }) + }), + ) + } + + return rebuilds.length === 0 + ? Promise.resolve() + : Promise.all(rebuilds).then(() => undefined) +} + +/** + * Return the realpath of every packages//dist directory in the + * TanStack Router monorepo. Only meaningful when called from inside the + * monorepo — in user apps, callers should guard with + * `isInsideRouterMonoRepo` before invoking this. + */ +function resolveWorkspacePackageDistRealpaths(): Array { + // currentDir points at either /packages/start-plugin-core/src/rsbuild + // or /packages/start-plugin-core/dist//rsbuild. Four levels up + // lands on /packages in both layouts. + const packagesDir = resolve(currentDir, '../../../../') + if (!existsSync(packagesDir)) return [] + + let entries: Array + try { + entries = readdirSync(packagesDir) + } catch { + return [] + } + + const dists: Array = [] + for (const entry of entries) { + const distPath = join(packagesDir, entry, 'dist') + try { + if (!statSync(distPath).isDirectory()) continue + } catch { + continue + } + try { + dists.push(realpathSync(distPath)) + } catch { + dists.push(distPath) + } + } + + return dists +} diff --git a/packages/start-plugin-core/src/rsbuild/post-build.ts b/packages/start-plugin-core/src/rsbuild/post-build.ts new file mode 100644 index 0000000000..2590ec9931 --- /dev/null +++ b/packages/start-plugin-core/src/rsbuild/post-build.ts @@ -0,0 +1,96 @@ +import { join } from 'pathe' +import { postBuild } from '../post-build' +import { prerender } from '../prerender' +import type { PrerenderHandler } from '../prerender' +import type { TanStackStartOutputConfig } from '../schema' + +export async function postBuildWithRsbuild({ + startConfig, + clientOutputDirectory, + serverOutputDirectory, +}: { + startConfig: TanStackStartOutputConfig + clientOutputDirectory: string + serverOutputDirectory: string +}) { + await postBuild({ + startConfig, + adapter: { + getClientOutputDirectory() { + return clientOutputDirectory + }, + prerender(startConfig) { + return prerender({ + startConfig, + handler: createRsbuildPrerenderHandler({ + clientOutputDirectory, + serverOutputDirectory, + }), + }) + }, + }, + }) +} + +function createRsbuildPrerenderHandler({ + clientOutputDirectory, + serverOutputDirectory, +}: { + clientOutputDirectory: string + serverOutputDirectory: string +}): PrerenderHandler { + process.env.TSS_PRERENDERING = 'true' + process.env.TSS_CLIENT_OUTPUT_DIR = clientOutputDirectory + + let requestHandlerPromise: + | Promise< + (request: Request, opts?: unknown) => Promise | Response + > + | undefined + + return { + getClientOutputDirectory() { + return clientOutputDirectory + }, + async request(path, options) { + const requestHandler = await getRequestHandler() + const url = new URL(path, 'http://localhost') + + return requestHandler( + new Request(url, { + ...options, + redirect: 'manual', + }), + ) + }, + } + + function getRequestHandler() { + if (!requestHandlerPromise) { + requestHandlerPromise = loadRequestHandler(serverOutputDirectory) + } + + return requestHandlerPromise + } +} + +async function loadRequestHandler(serverOutputDirectory: string) { + const { pathToFileURL } = await import('node:url') + const serverEntryUrl = pathToFileURL( + join(serverOutputDirectory, 'index.js'), + ).toString() + const serverModule = await import(serverEntryUrl) + const handler = serverModule.default + + if (typeof handler === 'function') { + return handler as (request: Request) => Promise | Response + } + + if (handler && typeof handler.fetch === 'function') { + return (request: Request) => handler.fetch(request) + } + + throw new Error( + `Unable to resolve a request handler from Rsbuild server bundle at ${serverEntryUrl}`, + ) +} diff --git a/packages/start-plugin-core/src/rsbuild/schema.ts b/packages/start-plugin-core/src/rsbuild/schema.ts new file mode 100644 index 0000000000..86194e309c --- /dev/null +++ b/packages/start-plugin-core/src/rsbuild/schema.ts @@ -0,0 +1,54 @@ +import { z } from 'zod' +import { + parseStartConfig as parseCoreStartConfig, + tanstackStartOptionsObjectSchema, +} from '../schema' +import type { CompileStartFrameworkOptions } from '../types' +import type { InlineCssInputOptions } from '../schema' + +export const rsbuildClientOutputSchema = z.enum(['module', 'iife']) + +export const tanstackStartRsbuildOptionsSchema = + tanstackStartOptionsObjectSchema + .extend({ + rsbuild: z + .object({ + installDevServerMiddleware: z.boolean().optional(), + client: z + .object({ + output: rsbuildClientOutputSchema.optional().default('module'), + }) + .optional() + .prefault({}), + }) + .optional(), + }) + .optional() + .prefault({}) + +export function parseStartConfig( + opts: z.input, + corePluginOpts: { framework: CompileStartFrameworkOptions }, + root: string, +) { + tanstackStartRsbuildOptionsSchema.parse(opts) + const { rsbuild: _rsbuild, ...coreOptions } = opts ?? {} + + return parseCoreStartConfig(coreOptions, corePluginOpts, root) +} + +export type TanStackStartRsbuildInputConfig = z.input< + typeof tanstackStartRsbuildOptionsSchema +> & { + rsbuild?: { + installDevServerMiddleware?: boolean + client?: { + output?: z.input + } + } + server?: { + build?: { + inlineCss?: InlineCssInputOptions + } + } +} diff --git a/packages/start-plugin-core/src/rsbuild/start-compiler-host.ts b/packages/start-plugin-core/src/rsbuild/start-compiler-host.ts new file mode 100644 index 0000000000..5cf9319238 --- /dev/null +++ b/packages/start-plugin-core/src/rsbuild/start-compiler-host.ts @@ -0,0 +1,491 @@ +import { AsyncLocalStorage } from 'node:async_hooks' +import { dirname, resolve } from 'node:path' +import { fileURLToPath, pathToFileURL } from 'node:url' +import { z } from 'zod' +import { TRANSFORM_ID_REGEX } from '../constants' +import { detectKindsInCode } from '../start-compiler/compiler' +import { getTransformCodeFilterForEnv } from '../start-compiler/config' +import { + createStartCompiler, + loadCompilerVirtualModule, + matchesCodeFilters, + mergeServerFnsById, +} from '../start-compiler/host' +import { cleanId } from '../start-compiler/utils' +import { createHydrateCompilerPlugin } from '../hydrate-when-transform' +import { + SERVER_FN_BUILD_INFO_CONTEXT_KEY, + SERVER_FN_BUILD_INFO_FIELD, +} from './start-compiler-metadata' +import type { RsbuildPluginAPI, Rspack } from '@rsbuild/core' +import type { + ServerFnBuildInfo, + ServerFnBuildInfoLoaderContext, +} from './start-compiler-metadata' +import type { + CompileStartFrameworkOptions, + StartCompilerImportTransform, + StartCompilerPlugin, + StartCompilerTransformResult, +} from '../types' +import type { + DevServerFnModuleSpecifierEncoder, + GenerateFunctionIdFnOptional, + ServerFn, +} from '../start-compiler/types' + +type RsbuildTransformContext = Parameters< + Parameters[1] +>[0] +type RsbuildInputFileSystem = NonNullable +type ServerFnMetadataById = Map +type StartCompilerEnvironment = { + name: string + type: 'client' | 'server' +} + +const serverFnSchema = z.object({ + functionName: z.string(), + functionId: z.string(), + extractedFilename: z.string(), + filename: z.string(), + isClientReferenced: z.boolean().optional(), +}) + +const serverFnBuildInfoSchema = z.object({ + version: z.literal(1), + serverFnsById: z.record(z.string(), serverFnSchema), +}) + +/** + * In Rsbuild dev, use file:// URLs for absolute server function paths. + * These are directly importable by Node's ESM VM runner without any bundler + * path conventions (unlike Vite's /@id/ prefix). + */ +const rsbuildDevServerFnModuleSpecifierEncoder: DevServerFnModuleSpecifierEncoder = + ({ extractedFilename }) => pathToFileURL(extractedFilename).href + +const currentDir = dirname(fileURLToPath(import.meta.url)) +const metadataLoaderFilename = 'start-compiler-metadata-loader.js' +const EMPTY_SERVER_FN_BUILD_INFO: ServerFnBuildInfo = { + version: 1, + serverFnsById: {}, +} + +function resolveMetadataLoader(): string { + return resolve(currentDir, metadataLoaderFilename) +} + +function readServerFnBuildInfo( + module: Rspack.Module, +): Record | null { + const result = serverFnBuildInfoSchema.safeParse( + module.buildInfo[SERVER_FN_BUILD_INFO_FIELD], + ) + if (!result.success) { + return null + } + + return result.data.serverFnsById +} + +function setServerFnBuildInfoLoaderContext( + loaderContext: Rspack.LoaderContext & ServerFnBuildInfoLoaderContext, + module: Rspack.Module, +) { + loaderContext[SERVER_FN_BUILD_INFO_CONTEXT_KEY] = (metadata) => { + if (metadata) { + module.buildInfo[SERVER_FN_BUILD_INFO_FIELD] = metadata + } else if (module.buildInfo[SERVER_FN_BUILD_INFO_FIELD]) { + module.buildInfo[SERVER_FN_BUILD_INFO_FIELD] = EMPTY_SERVER_FN_BUILD_INFO + } + } +} + +export interface StartCompilerHostOptions { + framework: CompileStartFrameworkOptions + root: string | (() => string) + environments: Array + providerEnvName: string + generateFunctionId?: GenerateFunctionIdFnOptional + compilerTransforms?: Array | undefined + compilerPlugins?: Array | undefined + serverFnProviderModuleDirectives?: ReadonlyArray | undefined + serverFnsById?: Record + onServerFnsByIdChange?: () => void +} + +/** + * Registers the shared StartCompiler as rsbuild transforms for client + ssr environments. + * + * Uses `api.transform()` to hook into the rsbuild loader pipeline, and the + * transform context's native `resolve()` for module resolution. + */ +export function registerStartCompilerTransforms( + api: RsbuildPluginAPI, + opts: StartCompilerHostOptions, +): { + serverFnsById: Record +} { + const compilers = new Map>() + // Serialize access to each StartCompiler's mutable per-environment caches. + const compilerQueues = new Map>() + const inputFileSystems = new Map() + const transformContextStorage = + new AsyncLocalStorage() + const serverFnMetadataByEnvironment = new Map() + const serverFnsByEnvironment = new Map>() + const serverFnsById = opts.serverFnsById ?? {} + const getRoot = () => + typeof opts.root === 'function' ? opts.root() : opts.root + const getServerFnMetadata = (environmentName: string) => { + let metadataById = serverFnMetadataByEnvironment.get(environmentName) + + if (!metadataById) { + metadataById = new Map() + serverFnMetadataByEnvironment.set(environmentName, metadataById) + } + + return metadataById + } + const runCompilerTask = async ( + environmentName: string, + task: () => Promise, + ): Promise => { + const previous = compilerQueues.get(environmentName) ?? Promise.resolve() + const next = previous.catch(() => undefined).then(task) + + compilerQueues.set( + environmentName, + next.then( + () => undefined, + () => undefined, + ), + ) + + return next + } + + const replaceServerFnsByIdFromEnvironmentSnapshots = () => { + const nextServerFnsById: Record = {} + + for (const snapshot of serverFnsByEnvironment.values()) { + mergeServerFnsById(nextServerFnsById, snapshot) + } + + for (const key of Object.keys(serverFnsById)) { + delete serverFnsById[key] + } + + Object.assign(serverFnsById, nextServerFnsById) + opts.onServerFnsByIdChange?.() + } + const compilerPlugins = [ + createHydrateCompilerPlugin(), + ...(opts.compilerPlugins ?? []), + ] + + const isDev = api.context.action === 'dev' + const mode = isDev ? 'dev' : 'build' + const metadataLoader = resolveMetadataLoader() + + const environments = opts.environments + + // Rspack persistent cache restores modules without re-running api.transform. + // Keep server function modules cacheable by writing discovered metadata into + // buildInfo from a real loader, then replaying it from cached modules. + api.modifyRspackConfig((config, utils) => { + if (!environments.some((env) => env.name === utils.environment.name)) { + return + } + + const rules = config.module.rules ?? [] + rules.push({ + test: TRANSFORM_ID_REGEX[0], + enforce: 'post', + use: [ + { + loader: metadataLoader, + options: { + metadataById: getServerFnMetadata(utils.environment.name), + }, + }, + ], + }) + config.module.rules = rules + }) + + for (const env of environments) { + const compilerTransforms = + env.name === opts.providerEnvName ? opts.compilerTransforms : undefined + const envCodeFilters = getTransformCodeFilterForEnv(env.type, { + compilerTransforms, + compilerPlugins, + }) + const serverFnProviderModuleDirectives = + env.name === opts.providerEnvName + ? opts.serverFnProviderModuleDirectives + : undefined + let activeServerFnMetadata: Record | undefined + const onServerFnsById = (d: Record) => { + mergeServerFnsById(serverFnsById, d) + + if (activeServerFnMetadata) { + mergeServerFnsById(activeServerFnMetadata, d) + } + + opts.onServerFnsByIdChange?.() + } + + api.transform( + { + test: TRANSFORM_ID_REGEX[0], + environments: [env.name], + order: 'pre', + }, + async (ctx: RsbuildTransformContext) => { + return transformContextStorage.run(ctx, async () => { + const code = ctx.code + let nextCode = code + let previousResult: { + code: string + map: StartCompilerTransformResult['map'] + } | null = null + const id = ctx.resource + const root = getRoot() + + const virtualResult = loadCompilerVirtualModule(compilerPlugins, { + code, + id, + root, + env: env.type, + envName: env.name, + }) + if (virtualResult) { + nextCode = virtualResult.code + previousResult = { + code: virtualResult.code, + map: virtualResult.map ?? null, + } + } + + // Quick string-level check: does this file contain any patterns for this env? + if (!matchesCodeFilters(nextCode, envCodeFilters)) { + return previousResult ?? nextCode + } + + let compiler = compilers.get(env.name) + if (!compiler) { + compiler = createStartCompiler({ + env: env.type, + envName: env.name, + root, + mode, + framework: opts.framework, + providerEnvName: opts.providerEnvName, + generateFunctionId: opts.generateFunctionId, + compilerTransforms, + compilerPlugins, + serverFnProviderModuleDirectives, + onServerFnsById, + getKnownServerFns: () => serverFnsById, + encodeModuleSpecifierInDev: isDev + ? rsbuildDevServerFnModuleSpecifierEncoder + : undefined, + loadModule: async (moduleId: string) => { + const activeCtx = transformContextStorage.getStore() + if (!activeCtx) { + throw new Error( + `could not load module ${moduleId}: missing active rsbuild transform context for ${env.name}`, + ) + } + + const inputFileSystem = inputFileSystems.get(env.name) + if (!inputFileSystem) { + throw new Error( + `could not load module ${moduleId}: missing rspack input filesystem for ${env.name}`, + ) + } + + const cleanedId = cleanId(moduleId) + activeCtx.addDependency(cleanedId) + const loaded = await readFileFromInputFileSystem( + inputFileSystem, + cleanedId, + ) + const moduleCode = Buffer.isBuffer(loaded) + ? loaded.toString('utf8') + : loaded + + compiler!.ingestModule({ code: moduleCode, id: cleanedId }) + }, + resolveId: async ( + source: string, + importer?: string, + ): Promise => { + const activeCtx = transformContextStorage.getStore() + if (!activeCtx) { + throw new Error( + `could not resolve ${source}: missing active rsbuild transform context for ${env.name}`, + ) + } + + const context = importer + ? importer.replace(/[/\\][^/\\]*$/, '') + : getRoot() + + return await new Promise((resolve, reject) => { + activeCtx.resolve(context, source, (error, resolved) => { + if (error) { + reject(error) + return + } + + if (!resolved) { + resolve(null) + return + } + + resolve(cleanId(resolved)) + }) + }) + }, + }) + compilers.set(env.name, compiler) + } + + const detectedKinds = detectKindsInCode(nextCode, env.type, { + compilerTransforms, + }) + const discoveredServerFnsById: Record = {} + const result = await runCompilerTask(env.name, async () => { + activeServerFnMetadata = discoveredServerFnsById + + try { + return await compiler.compile({ + id, + code: nextCode, + detectedKinds, + }) + } finally { + activeServerFnMetadata = undefined + } + }) + + getServerFnMetadata(env.name).set(id, { + version: 1, + serverFnsById: discoveredServerFnsById, + }) + + if (result) { + return { + code: result.code, + map: result.map ?? null, + } + } + + return previousResult ?? nextCode + }) + }, + ) + } + + api.modifyRspackConfig((config, utils) => { + if (!environments.some((env) => env.name === utils.environment.name)) { + return + } + + config.plugins.push({ + apply(compiler: Rspack.Compiler) { + if (compiler.inputFileSystem) { + inputFileSystems.set(utils.environment.name, compiler.inputFileSystem) + } + + compiler.hooks.compilation.tap( + 'TanStackStartCompilerMetadataLoaderContext', + (compilation) => { + utils.rspack.NormalModule.getCompilationHooks( + compilation, + ).loader.tap( + 'TanStackStartCompilerMetadataLoaderContext', + (loaderContext, module) => { + setServerFnBuildInfoLoaderContext(loaderContext, module) + }, + ) + }, + ) + + compiler.hooks.compile.tap('TanStackStartCompilerMetadataCleanup', () => + getServerFnMetadata(utils.environment.name).clear(), + ) + + compiler.hooks.finishMake.tap( + { + name: 'TanStackStartCompilerCachedServerFnMetadata', + stage: -20, + }, + (compilation) => { + const restoredServerFnsById: Record = {} + + for (const module of compilation.modules) { + const metadata = readServerFnBuildInfo(module) + if (!metadata) { + continue + } + + mergeServerFnsById(restoredServerFnsById, metadata) + } + + serverFnsByEnvironment.set( + utils.environment.name, + restoredServerFnsById, + ) + replaceServerFnsByIdFromEnvironmentSnapshots() + }, + ) + + compiler.hooks.watchRun.tap( + 'TanStackStartCompilerModuleInvalidation', + (watchCompiler) => { + const startCompiler = compilers.get(utils.environment.name) + + if (!startCompiler) { + return + } + + for (const file of watchCompiler.modifiedFiles ?? []) { + startCompiler.invalidateModule(file) + } + + for (const file of watchCompiler.removedFiles ?? []) { + startCompiler.invalidateModule(file) + } + }, + ) + }, + }) + }) + + return { serverFnsById } +} + +function readFileFromInputFileSystem( + inputFileSystem: RsbuildInputFileSystem, + file: string, +): Promise { + return new Promise((resolve, reject) => { + inputFileSystem.readFile(file, (error, data) => { + if (error) { + reject(error) + return + } + + if (data == null) { + reject(new Error(`could not read module source for ${file}`)) + return + } + + resolve(data) + }) + }) +} diff --git a/packages/start-plugin-core/src/rsbuild/start-compiler-metadata-loader.ts b/packages/start-plugin-core/src/rsbuild/start-compiler-metadata-loader.ts new file mode 100644 index 0000000000..89a22d82cd --- /dev/null +++ b/packages/start-plugin-core/src/rsbuild/start-compiler-metadata-loader.ts @@ -0,0 +1,22 @@ +import { SERVER_FN_BUILD_INFO_CONTEXT_KEY } from './start-compiler-metadata' +import type { Rspack } from '@rsbuild/core' +import type { + ServerFnBuildInfoLoaderContext, + ServerFnMetadataLoaderOptions, +} from './start-compiler-metadata' + +const tanStackStartCompilerMetadataLoader: Rspack.LoaderDefinition< + ServerFnMetadataLoaderOptions, + ServerFnBuildInfoLoaderContext +> = function (source, map): void { + const { metadataById } = this.getOptions() + const id = this.resource + const metadata = metadataById.get(id) + const setBuildInfo = this[SERVER_FN_BUILD_INFO_CONTEXT_KEY] + + setBuildInfo?.(metadata ?? null) + + this.callback(null, source, map) +} + +export default tanStackStartCompilerMetadataLoader diff --git a/packages/start-plugin-core/src/rsbuild/start-compiler-metadata.ts b/packages/start-plugin-core/src/rsbuild/start-compiler-metadata.ts new file mode 100644 index 0000000000..dfa6119246 --- /dev/null +++ b/packages/start-plugin-core/src/rsbuild/start-compiler-metadata.ts @@ -0,0 +1,20 @@ +import type { ServerFn } from '../start-compiler/types' + +export const SERVER_FN_BUILD_INFO_FIELD = 'tanstack.start.serverFns' +export const SERVER_FN_BUILD_INFO_CONTEXT_KEY = + 'tanstack.start.setServerFnBuildInfo' + +export type ServerFnBuildInfo = { + version: 1 + serverFnsById: Record +} + +export type SetServerFnBuildInfo = (metadata: ServerFnBuildInfo | null) => void + +export type ServerFnBuildInfoLoaderContext = { + [SERVER_FN_BUILD_INFO_CONTEXT_KEY]?: SetServerFnBuildInfo +} + +export type ServerFnMetadataLoaderOptions = { + metadataById: Map +} diff --git a/packages/start-plugin-core/src/rsbuild/start-router-plugin.ts b/packages/start-plugin-core/src/rsbuild/start-router-plugin.ts new file mode 100644 index 0000000000..438c01bad7 --- /dev/null +++ b/packages/start-plugin-core/src/rsbuild/start-router-plugin.ts @@ -0,0 +1,85 @@ +import path from 'pathe' +import { createRouterPluginContext } from '@tanstack/router-plugin/context' +import { + TanStackRouterCodeSplitterRspack, + TanStackRouterGeneratorRspack, +} from '@tanstack/router-plugin/rspack' +import { routesManifestPlugin } from '../start-router-plugin/generator-plugins/routes-manifest-plugin' +import { prerenderRoutesPlugin } from '../start-router-plugin/generator-plugins/prerender-routes-plugin' +import { buildRouteTreeFileFooterFromConfig } from '../start-router-plugin/route-tree-footer' +import { RSBUILD_ENVIRONMENT_NAMES } from './planning' +import type { RsbuildPluginAPI } from '@rsbuild/core' +import type { GetConfigFn, TanStackStartCoreOptions } from '../types' +import type { TanStackStartRsbuildInputConfig } from './schema' + +/** + * Registers the TanStack Router generator and code-splitter plugins + * as rspack plugins via `modifyRspackConfig`. + * + * The router-plugin package exports rspack-compatible unplugin wrappers: + * - TanStackRouterGeneratorRspack: file-based route generation + * - TanStackRouterCodeSplitterRspack: route code splitting + */ +export function registerRouterPlugins( + api: RsbuildPluginAPI, + opts: { + getConfig: GetConfigFn + corePluginOpts: TanStackStartCoreOptions + startPluginOpts: TanStackStartRsbuildInputConfig + }, +): void { + const routerPluginContext = createRouterPluginContext() + + api.modifyRspackConfig((config, utils) => { + const envName = utils.environment.name + const { startConfig } = opts.getConfig() + const routerConfig = startConfig.router + + // Generator only runs once — register for the client environment + if (envName === RSBUILD_ENVIRONMENT_NAMES.client) { + const generatorPlugin = TanStackRouterGeneratorRspack( + { + ...routerConfig, + target: opts.corePluginOpts.framework, + routeTreeFileFooter: () => { + return buildRouteTreeFileFooterFromConfig({ + generatedRouteTreePath: path.resolve( + routerConfig.generatedRouteTree, + ), + getConfig: opts.getConfig, + corePluginOpts: opts.corePluginOpts, + }) + }, + plugins: [ + routesManifestPlugin(), + ...(opts.startPluginOpts.prerender?.enabled === true + ? [prerenderRoutesPlugin()] + : []), + ], + }, + routerPluginContext, + ) + utils.appendPlugins(generatorPlugin as any) + } + + if ( + envName === RSBUILD_ENVIRONMENT_NAMES.client || + envName === RSBUILD_ENVIRONMENT_NAMES.server + ) { + const isClient = envName === RSBUILD_ENVIRONMENT_NAMES.client + const splitterPlugin = TanStackRouterCodeSplitterRspack( + { + ...routerConfig, + target: opts.corePluginOpts.framework, + codeSplittingOptions: { + ...routerConfig.codeSplittingOptions, + deleteNodes: isClient ? ['ssr', 'server', 'headers'] : undefined, + addHmr: isClient, + }, + }, + routerPluginContext, + ) + utils.appendPlugins(splitterPlugin as any) + } + }) +} diff --git a/packages/start-plugin-core/src/rsbuild/swc-rsc.ts b/packages/start-plugin-core/src/rsbuild/swc-rsc.ts new file mode 100644 index 0000000000..16e21145b5 --- /dev/null +++ b/packages/start-plugin-core/src/rsbuild/swc-rsc.ts @@ -0,0 +1,166 @@ +import { RSBUILD_RSC_LAYERS } from './planning' +import type { ModifyRspackConfigFn, Rspack } from '@rsbuild/core' + +type RspackConfig = Parameters[0] +type RspackRule = Rspack.RuleSetRule + +/** + * Walk the rspack config's module.rules and inject + * `rspackExperiments.reactServerComponents: true` into SWC loaders. + * + * Recurses into `oneOf` arrays because rsbuild nests the main SWC loader + * inside a `oneOf` rule (e.g. separate branches for asset/source vs + * javascript/auto). Without recursion, only the mimetype-based fallback + * SWC rule gets the flag, leaving most .js/.ts files without RSC + * directive detection. + */ +export function enableSwcReactServerComponents( + config: RspackConfig, + scope: 'all' | 'rsc-subtree', +): void { + const isRspackRule = ( + rule: NonNullable[number], + ): rule is RspackRule => !!rule && rule !== '...' + const getRuleLoaders = (rule: RspackRule) => { + const { use } = rule + if (!use) { + return [] + } + + return typeof use === 'function' ? [] : Array.isArray(use) ? use : [use] + } + const getLoaderPath = ( + loader: ReturnType[number], + ): string | undefined => (typeof loader === 'string' ? loader : loader.loader) + const cloneLoader = ( + loader: ReturnType[number], + ): ReturnType[number] => { + if (typeof loader === 'string') { + return loader + } + + const options = loader.options + return { + ...loader, + ...(options && typeof options === 'object' && !Array.isArray(options) + ? { + options: { + ...options, + ...(options.rspackExperiments && + typeof options.rspackExperiments === 'object' && + !Array.isArray(options.rspackExperiments) + ? { + rspackExperiments: { + ...options.rspackExperiments, + }, + } + : {}), + }, + } + : {}), + } + } + const cloneRuleUse = (use: RspackRule['use']): RspackRule['use'] => { + if (!use || typeof use === 'function') { + return use + } + + if (Array.isArray(use)) { + return use.map((loader) => cloneLoader(loader)) as RspackRule['use'] + } + + return cloneLoader(use) as RspackRule['use'] + } + const cloneRspackRule = (rule: RspackRule): RspackRule => { + return { + ...rule, + use: cloneRuleUse(rule.use), + resolve: rule.resolve ? { ...rule.resolve } : rule.resolve, + oneOf: Array.isArray(rule.oneOf) + ? rule.oneOf.map((childRule) => + isRspackRule(childRule) ? cloneRspackRule(childRule) : childRule, + ) + : rule.oneOf, + } as unknown as RspackRule + } + const rootRules = (config.module.rules ??= []).filter(isRspackRule) + + function processRules(rules = rootRules): void { + for (const rule of rules) { + processRules( + Array.isArray(rule.oneOf) ? rule.oneOf.filter(isRspackRule) : [], + ) + + const hasSwcLoader = getRuleLoaders(rule).some((loader) => + Boolean(getLoaderPath(loader)?.includes('swc-loader')), + ) + if (!hasSwcLoader) continue + + const enableReactServerComponentsOnRule = (nextRule: RspackRule) => { + for (const loader of getRuleLoaders(nextRule)) { + if (typeof loader === 'string') { + continue + } + + const loaderPath = getLoaderPath(loader) + if (!loaderPath || !loaderPath.includes('swc-loader')) { + continue + } + + const options = + loader.options && typeof loader.options === 'object' + ? loader.options + : (loader.options = {}) + const experiments = + options.rspackExperiments && + typeof options.rspackExperiments === 'object' + ? options.rspackExperiments + : (options.rspackExperiments = {}) + const current = experiments.reactServerComponents + + experiments.reactServerComponents = + current === true || current == null + ? {} + : typeof current === 'object' && + current !== null && + !Array.isArray(current) + ? { ...current } + : {} + } + } + + if (scope === 'all') { + enableReactServerComponentsOnRule(rule) + continue + } + + const originalRule = cloneRspackRule(rule) + const providerRule = cloneRspackRule(originalRule) + providerRule.resourceQuery = /(?:^|[?&])tss-serverfn-split(?:&|$)/ + enableReactServerComponentsOnRule(providerRule) + + const routeSplitRule = cloneRspackRule(originalRule) + routeSplitRule.resourceQuery = /(?:^|[?&])tsr-split(?:=|&|$)/ + const routeSplitConditionNames = originalRule.resolve?.conditionNames + routeSplitRule.resolve = { + ...originalRule.resolve, + conditionNames: Array.isArray(routeSplitConditionNames) + ? routeSplitConditionNames.includes('...') + ? [...routeSplitConditionNames] + : ['...', ...routeSplitConditionNames] + : ['...'], + } + + const subtreeRule = cloneRspackRule(originalRule) + subtreeRule.issuerLayer = RSBUILD_RSC_LAYERS.rsc + enableReactServerComponentsOnRule(subtreeRule) + + for (const key of Object.keys(rule) as Array) { + delete rule[key] + } + rule.oneOf = [providerRule, routeSplitRule, subtreeRule, originalRule] + } + } + + processRules() +} diff --git a/packages/start-plugin-core/src/rsbuild/types.ts b/packages/start-plugin-core/src/rsbuild/types.ts new file mode 100644 index 0000000000..fa10d65f64 --- /dev/null +++ b/packages/start-plugin-core/src/rsbuild/types.ts @@ -0,0 +1,20 @@ +import type { EnvironmentConfig } from '@rsbuild/core' +import type { TanStackStartCoreOptions } from '../types' + +export interface RsbuildEnvironmentOverrides { + all?: EnvironmentConfig | undefined + client?: EnvironmentConfig | undefined + server?: EnvironmentConfig | undefined + provider?: EnvironmentConfig | undefined +} + +export interface RsbuildCoreOptions { + environments?: RsbuildEnvironmentOverrides | undefined +} + +export type TanStackStartRsbuildPluginCoreOptions = TanStackStartCoreOptions & { + providerEnvironmentName: string + ssrIsProvider: boolean + rsbuild?: RsbuildCoreOptions | undefined + rsc?: boolean | undefined +} diff --git a/packages/start-plugin-core/src/rsbuild/virtual-modules.ts b/packages/start-plugin-core/src/rsbuild/virtual-modules.ts new file mode 100644 index 0000000000..9e4c0bc4df --- /dev/null +++ b/packages/start-plugin-core/src/rsbuild/virtual-modules.ts @@ -0,0 +1,606 @@ +import { VIRTUAL_MODULES } from '@tanstack/start-server-core' +import { generateSerializationAdaptersModule } from '../serialization-adapters-module' +import { generateServerFnResolverModule } from '../start-compiler/server-fn-resolver-module' +import { buildStartManifest } from '../start-manifest-plugin/manifestBuilder' +import { escapeRegExp } from '../utils' +import { RSBUILD_ENVIRONMENT_NAMES } from './planning' +import type { + RsbuildPluginAPI, + rspack as rspackNamespaceType, +} from '@rsbuild/core' +import type { + GetConfigFn, + NormalizedClientBuild, + SerializationAdapterConfig, +} from '../types' +import type { InlineCssOptions } from '../start-manifest-plugin/manifestBuilder' +import type { ServerFn } from '../start-compiler/types' +import type { ScriptFormat } from '@tanstack/router-core' + +type RspackNamespace = typeof rspackNamespaceType +type RspackVirtualModulesPlugin = InstanceType< + RspackNamespace['experiments']['VirtualModulesPlugin'] +> + +// Virtual module IDs for RSC (must match what react-start-rsc imports) +const RSC_RUNTIME_VIRTUAL_ID = 'virtual:tanstack-rsc-runtime' +const RSC_HMR_VIRTUAL_ID = 'virtual:tanstack-rsc-hmr' +const RSC_BROWSER_DECODE_VIRTUAL_ID = 'virtual:tanstack-rsc-browser-decode' +const RSC_SSR_DECODE_VIRTUAL_ID = 'virtual:tanstack-rsc-ssr-decode' +export const START_MANIFEST_PLACEHOLDER = '__TSS_START_MANIFEST_PLACEHOLDER__' +const DEV_START_MANIFEST_GLOBAL = '__TSS_DEV_START_MANIFEST__' +/** + * VirtualModulesPlugin resolves module paths relative to compiler.context. + * Prefix them under the app root so they are unique and watcher-friendly. + */ +function virtualPath(root: string, moduleId: string): string { + // VirtualModulesPlugin resolves paths relative to compiler.context (root). + // Use a recognizable prefix to avoid collisions with real files. + const sanitized = moduleId.replace(/[:#]/g, '_') + return `${root}/node_modules/.virtual/${sanitized}.js` +} + +export interface VirtualModuleState { + /** Call to update manifest content after client build completes */ + updateManifest: (clientBuild: NormalizedClientBuild) => void + /** Call to update server fn resolver content after compilation discovers fns */ + updateServerFnResolver: () => void + /** Try to write explicit resolver content now; queues if env not ready */ + tryUpdateServerFnResolver: (content: string) => void + /** Get the virtual path for a given module ID */ + getVirtualPath: (moduleId: string) => string + /** Generate resolver module content from current serverFnsById state. + * When forProvider=true, generates without isClientReferenced checks (RSC layer). */ + generateCurrentResolverContent: (forProvider?: boolean) => string + /** The absolute virtual path of the server fn resolver module */ + serverFnResolverPath: string + /** The absolute virtual path of the manifest module */ + manifestPath: string + /** Generate manifest module content from a given client build */ + generateManifestContent: (clientBuild: NormalizedClientBuild) => string + /** Generate the serialized manifest value literal for asset patching */ + generateManifestValueLiteral: (clientBuild: NormalizedClientBuild) => string + /** VirtualModulesPlugin instances keyed by environment name */ + vmPlugins: Record +} + +// --------------------------------------------------------------------------- +// Manifest module codegen +// --------------------------------------------------------------------------- + +function getScriptFormatProperty(scriptFormat: ScriptFormat): string { + return scriptFormat === 'iife' ? ` scriptFormat: 'iife',\n` : '' +} + +function getEntryScriptAttrs( + entryUrl: string, + scriptFormat: ScriptFormat, +): string { + return scriptFormat === 'module' + ? `{ type: 'module', async: true, src: '${entryUrl}' }` + : `{ async: true, src: '${entryUrl}' }` +} + +function generateManifestModuleDev( + devClientEntryUrl: string, + scriptFormat: ScriptFormat, +): string { + const scriptFormatProperty = getScriptFormatProperty(scriptFormat) + return `const fallbackManifest = { +${scriptFormatProperty} routes: { + __root__: { + preloads: ['${devClientEntryUrl}'], + scripts: [{ attrs: ${getEntryScriptAttrs(devClientEntryUrl, scriptFormat)} }], + }, + }, +} +export const tsrStartManifest = () => globalThis[${JSON.stringify(DEV_START_MANIFEST_GLOBAL)}] ?? fallbackManifest` +} + +function buildStartManifestData( + clientBuild: NormalizedClientBuild, + publicBase: string, + inlineCss: InlineCssOptions, + scriptFormat: ScriptFormat, +) { + const routeTreeRoutes = globalThis.TSS_ROUTES_MANIFEST + return buildStartManifest({ + clientBuild, + routeTreeRoutes, + basePath: publicBase, + inlineCss, + scriptFormat, + }) +} + +function serializeStartManifestData( + clientBuild: NormalizedClientBuild, + publicBase: string, + inlineCss: InlineCssOptions, + scriptFormat: ScriptFormat, +): string { + return JSON.stringify( + buildStartManifestData(clientBuild, publicBase, inlineCss, scriptFormat), + ) +} + +function generateManifestModuleBuild( + clientBuild: NormalizedClientBuild | undefined, + publicBase: string, + _devClientEntryUrl: string, + inlineCss: InlineCssOptions, + scriptFormat: ScriptFormat, +): string { + if (!clientBuild) { + return `const tsrStartManifestData = ${JSON.stringify(START_MANIFEST_PLACEHOLDER)} +export const tsrStartManifest = () => tsrStartManifestData` + } + + return `export const tsrStartManifest = () => (${serializeStartManifestData(clientBuild, publicBase, inlineCss, scriptFormat)})` +} + +/** + * Generate virtual:tanstack-rsc-runtime content. + * In the RSC layer this re-exports from react-server-dom-rspack/server. + * In other layers it provides stubs that throw. + */ +function generateRscRuntimeModule(isRscLayer: boolean): string { + if (isRscLayer) { + // Re-export the RSC runtime functions from react-server-dom-rspack/server. + // NOTE: `createFromReadableStream` is a CLIENT-side API — it's NOT exported + // by react-server-dom-rspack/server. The RSC layer never needs it (RSC + // renders TO streams, doesn't decode FROM them). We provide a stub that + // throws so the export surface stays consistent across bundlers. + return `export { renderToReadableStream, createTemporaryReferenceSet, decodeReply, decodeAction, decodeFormState } from 'react-server-dom-rspack/server' +export function createFromReadableStream() { throw new Error('createFromReadableStream is not available in RSC environment (use SSR or browser decode instead)'); } +// loadServerAction is provided by the RSC entry, not react-server-dom-rspack +import { getServerFnById } from '#tanstack-start-server-fn-resolver' +export const loadServerAction = async (id) => getServerFnById(id, { origin: 'server' })` + } + + // In other layers, provide stubs that throw + return ` +export function renderToReadableStream() { throw new Error('renderToReadableStream can only be used in RSC environment'); } +export function createFromReadableStream() { throw new Error('createFromReadableStream can only be used in RSC environment'); } +export function createTemporaryReferenceSet() { throw new Error('createTemporaryReferenceSet can only be used in RSC environment'); } +export function decodeReply() { throw new Error('decodeReply can only be used in RSC environment'); } +export function loadServerAction() { throw new Error('loadServerAction can only be used in RSC environment'); } +export function decodeAction() { throw new Error('decodeAction can only be used in RSC environment'); } +export function decodeFormState() { throw new Error('decodeFormState can only be used in RSC environment'); } +` +} + +/** + * Generate virtual:tanstack-rsc-hmr content. + * In the client env during dev, listens for rsc:update WebSocket events + * and invalidates the router. In all other contexts, exports nothing. + */ +function generateRscHmrModule(isClientEnv: boolean, isDev: boolean): string { + if (!isClientEnv || !isDev) { + return 'export function setupRscHmr() {}' + } + + // Rsbuild dev server delivers custom WebSocket events through + // import.meta.webpackHot.on(event, cb). The server-side + // sockWrite('custom', { event: 'rsc:update' }) maps directly to that. + return ` +// RSC HMR listener for rsbuild dev server +// Listens for 'rsc:update' custom events sent via sockWrite +export function setupRscHmr() { + let __invalidateQueued = false + + function __queueInvalidate() { + if (__invalidateQueued) return + __invalidateQueued = true + queueMicrotask(async () => { + __invalidateQueued = false + try { + const router = window.__TSR_ROUTER__ + if (!router) { + console.warn('[rsc:hmr] No router found on window.__TSR_ROUTER__') + return + } + await router.invalidate() + } catch (e) { + console.warn('[rsc:hmr] Failed to invalidate router:', e) + } + }) + } + + if (import.meta.webpackHot) { + import.meta.webpackHot.on('rsc:update', () => { + __queueInvalidate() + }) + } +} +` +} + +// --------------------------------------------------------------------------- +// Main registration +// --------------------------------------------------------------------------- + +export interface RegisterVirtualModulesOptions { + root: string + getConfig: GetConfigFn + serverFnsById: Record + providerEnvName: string + ssrIsProvider: boolean + serializationAdapters: Array | undefined + /** + * Get the URL at which the rsbuild dev server serves the client entry JS. + * Called lazily inside modifyRspackConfig when getConfig() is available. + * Example return: '/assets/js/index.js' + */ + getDevClientEntryUrl: (publicBase: string) => string + /** Whether RSC virtual modules should be registered. */ + rscEnabled?: boolean | undefined + scriptFormat: ScriptFormat +} + +/** + * Registers virtual modules for the rsbuild adapter using VirtualModulesPlugin. + * + * Creates one VirtualModulesPlugin per environment and registers them via + * `modifyBundlerChain`. Provides update functions to refresh content dynamically. + */ +export function registerVirtualModules( + api: RsbuildPluginAPI, + opts: RegisterVirtualModulesOptions, +): VirtualModuleState { + const isDev = api.context.action === 'dev' + const root = opts.root + + // Virtual module paths keyed by module ID + const paths = { + manifest: virtualPath(root, VIRTUAL_MODULES.startManifest), + serverFnResolver: virtualPath(root, VIRTUAL_MODULES.serverFnResolver), + pluginAdapters: virtualPath(root, VIRTUAL_MODULES.pluginAdapters), + } + + // RSC virtual module paths (only defined when RSC is enabled) + const rscPaths = opts.rscEnabled + ? { + rscRuntime: virtualPath(root, RSC_RUNTIME_VIRTUAL_ID), + rscHmr: virtualPath(root, RSC_HMR_VIRTUAL_ID), + rscBrowserDecode: virtualPath(root, RSC_BROWSER_DECODE_VIRTUAL_ID), + rscSsrDecode: virtualPath(root, RSC_SSR_DECODE_VIRTUAL_ID), + } + : null + + // Track VirtualModulesPlugin instances per environment for dynamic updates + const vmPlugins: Record = {} + const readyVmPlugins: Record = {} + const pendingWrites = new Map>() + + let clientBuild: NormalizedClientBuild | undefined + const lastResolverContentByEnvironment: Record = + {} + const hasSeparateProviderEnvironment = + !opts.rscEnabled && + opts.providerEnvName !== RSBUILD_ENVIRONMENT_NAMES.server + const hasSerializationAdapters = Boolean(opts.serializationAdapters?.length) + + function isProviderEnvironment(environmentName: string): boolean { + return environmentName === opts.providerEnvName + } + + function needsServerFnResolver(environmentName: string): boolean { + return ( + environmentName === RSBUILD_ENVIRONMENT_NAMES.server || + (hasSeparateProviderEnvironment && isProviderEnvironment(environmentName)) + ) + } + + function generateResolverContent(environmentName: string): string { + return generateServerFnResolverModule({ + serverFnsById: opts.serverFnsById, + includeClientReferencedCheck: !isProviderEnvironment(environmentName), + useStaticImports: Boolean(opts.rscEnabled && isDev), + }) + } + + function writeResolverContent(environmentName: string, content: string) { + if ( + !isDev || + content !== lastResolverContentByEnvironment[environmentName] + ) { + lastResolverContentByEnvironment[environmentName] = content + tryWriteModule(environmentName, paths.serverFnResolver, content) + } + } + + function queuePendingWrite( + environmentName: string, + filePath: string, + content: string, + ) { + let writes = pendingWrites.get(environmentName) + if (!writes) { + writes = new Map() + pendingWrites.set(environmentName, writes) + } + writes.set(filePath, content) + } + + function tryWriteModule( + environmentName: string, + filePath: string, + content: string, + ) { + const vmPlugin = vmPlugins[environmentName] + if (!vmPlugin || !readyVmPlugins[environmentName]) { + queuePendingWrite(environmentName, filePath, content) + return false + } + + vmPlugin.writeModule(filePath, content) + return true + } + + function flushPendingWrites(environmentName: string) { + if (!readyVmPlugins[environmentName]) { + return + } + + const writes = pendingWrites.get(environmentName) + if (!writes?.size) { + return + } + + for (const [filePath, content] of writes) { + if (!tryWriteModule(environmentName, filePath, content)) { + return + } + writes.delete(filePath) + } + + if (writes.size === 0) { + pendingWrites.delete(environmentName) + } + } + + // NOTE: getConfig() is deferred — it must NOT be called until modifyRsbuildConfig + // has resolved (which sets resolvedStartConfig.root). All access to resolvedStartConfig + // happens inside modifyRspackConfig (which runs after modifyRsbuildConfig) or + // inside update callbacks (which run even later during/after compilation). + + // Generate initial content for each virtual module per environment + function getInitialContent(environmentName: string): Record { + // Safe to call getConfig() here — this runs inside modifyRspackConfig + const { resolvedStartConfig, startConfig } = opts.getConfig() + const isServerEnv = environmentName === RSBUILD_ENVIRONMENT_NAMES.server + const isClientEnv = environmentName === RSBUILD_ENVIRONMENT_NAMES.client + const content: Record = {} + + // Manifest — only meaningful for server env + if (isServerEnv) { + const devClientEntryUrl = opts.getDevClientEntryUrl( + resolvedStartConfig.basePaths.publicBase, + ) + content[paths.manifest] = isDev + ? generateManifestModuleDev(devClientEntryUrl, opts.scriptFormat) + : generateManifestModuleBuild( + clientBuild, + resolvedStartConfig.basePaths.publicBase, + devClientEntryUrl, + startConfig.server.build.inlineCss, + opts.scriptFormat, + ) + } else { + content[paths.manifest] = 'export default {}' + } + + // Server fn resolver — SSR and provider environments + if (needsServerFnResolver(environmentName)) { + content[paths.serverFnResolver] = generateResolverContent(environmentName) + } else { + // Client doesn't need the resolver but needs a valid module + content[paths.serverFnResolver] = 'export {}' + } + + if (hasSerializationAdapters) { + // Plugin adapters — both environments get environment-specific content + content[paths.pluginAdapters] = generateSerializationAdaptersModule({ + adapters: opts.serializationAdapters, + runtime: + environmentName === RSBUILD_ENVIRONMENT_NAMES.client + ? 'client' + : 'server', + }) + } + + // --- RSC virtual modules --- + if (rscPaths) { + // virtual:tanstack-rsc-runtime + // In the server env, this provides the RSC runtime for the RSC layer. + // The virtual module content is the same regardless of layer since + // rspack layers handle module isolation. The RSC entry imports this + // and the react-server condition on the RSC layer resolves + // react-server-dom-rspack/server correctly. + if (isServerEnv) { + // Server env gets the real RSC runtime (used by RSC layer) + content[rscPaths.rscRuntime] = generateRscRuntimeModule(true) + } else { + // Client env gets stubs + content[rscPaths.rscRuntime] = generateRscRuntimeModule(false) + } + + // virtual:tanstack-rsc-hmr + content[rscPaths.rscHmr] = generateRscHmrModule(isClientEnv, isDev) + content[rscPaths.rscBrowserDecode] = isClientEnv + ? `export * from '@tanstack/react-start/rsbuild/browser-decode'` + : `export function createFromReadableStream() { throw new Error('RSC browser decode is only available in the client environment') } +export function createFromFetch() { throw new Error('RSC browser decode is only available in the client environment') }` + content[rscPaths.rscSsrDecode] = isServerEnv + ? `export { setOnClientReference, createFromReadableStream } from '@tanstack/react-start/rsbuild/ssr-decode'` + : `export function setOnClientReference() {} +export function createFromReadableStream() { throw new Error('RSC SSR decode is only available in the server environment') }` + } + + return content + } + + // Build a map from virtual module IDs to their virtual file paths. + // Scheme-like IDs are rewritten with NormalModuleReplacementPlugin because + // rspack validates request schemes before normal alias resolution. + const aliasMap: Record = { + [VIRTUAL_MODULES.startManifest]: paths.manifest, + [VIRTUAL_MODULES.serverFnResolver]: paths.serverFnResolver, + } + + if (hasSerializationAdapters) { + aliasMap[VIRTUAL_MODULES.pluginAdapters] = paths.pluginAdapters + } + + // Add RSC virtual module aliases + if (rscPaths) { + aliasMap[RSC_RUNTIME_VIRTUAL_ID] = rscPaths.rscRuntime + aliasMap[RSC_HMR_VIRTUAL_ID] = rscPaths.rscHmr + aliasMap[RSC_BROWSER_DECODE_VIRTUAL_ID] = rscPaths.rscBrowserDecode + aliasMap[RSC_SSR_DECODE_VIRTUAL_ID] = rscPaths.rscSsrDecode + } + + // Register VirtualModulesPlugin per environment via modifyRspackConfig + api.modifyRspackConfig((config, utils) => { + const envName = utils.environment.name + const initialContent = getInitialContent(envName) + + // Create VirtualModulesPlugin instance + const VMP = utils.rspack.experiments.VirtualModulesPlugin + const vmPlugin = new VMP(initialContent) + vmPlugins[envName] = vmPlugin + readyVmPlugins[envName] = false + config.plugins.push(vmPlugin) + config.plugins.push({ + apply(compiler: { + hooks: { + thisCompilation: { tap: (name: string, handler: () => void) => void } + } + }) { + compiler.hooks.thisCompilation.tap( + 'TanStackStartFlushPendingVirtualModules', + () => { + readyVmPlugins[envName] = true + flushPendingWrites(envName) + }, + ) + }, + }) + + // Rewrite scheme-like IDs to the VirtualModulesPlugin-backed file paths. + for (const [moduleId, virtualFilePath] of Object.entries(aliasMap)) { + const NMR = utils.rspack.NormalModuleReplacementPlugin + config.plugins.push( + new NMR(new RegExp(`^${escapeRegExp(moduleId)}$`), virtualFilePath), + ) + } + + const resolve = config.resolve + const resolveAlias = (resolve.alias ??= {}) as Record + resolveAlias[VIRTUAL_MODULES.serverFnResolver] = paths.serverFnResolver + if (hasSerializationAdapters) { + resolveAlias[VIRTUAL_MODULES.pluginAdapters] = paths.pluginAdapters + } + + // Add RSC-specific resolve aliases + if (rscPaths) { + resolveAlias[RSC_RUNTIME_VIRTUAL_ID] = rscPaths.rscRuntime + resolveAlias[RSC_HMR_VIRTUAL_ID] = rscPaths.rscHmr + resolveAlias[RSC_BROWSER_DECODE_VIRTUAL_ID] = rscPaths.rscBrowserDecode + resolveAlias[RSC_SSR_DECODE_VIRTUAL_ID] = rscPaths.rscSsrDecode + } + }) + + return { + serverFnResolverPath: paths.serverFnResolver, + manifestPath: paths.manifest, + vmPlugins, + + generateCurrentResolverContent(forProvider?: boolean): string { + return generateResolverContent( + forProvider ? opts.providerEnvName : RSBUILD_ENVIRONMENT_NAMES.server, + ) + }, + + generateManifestContent(newClientBuild: NormalizedClientBuild): string { + const { resolvedStartConfig, startConfig } = opts.getConfig() + const devClientEntryUrl = opts.getDevClientEntryUrl( + resolvedStartConfig.basePaths.publicBase, + ) + return generateManifestModuleBuild( + newClientBuild, + resolvedStartConfig.basePaths.publicBase, + devClientEntryUrl, + !isDev + ? startConfig.server.build.inlineCss + : { enabled: false, transformAssets: false }, + opts.scriptFormat, + ) + }, + + generateManifestValueLiteral( + newClientBuild: NormalizedClientBuild, + ): string { + const { resolvedStartConfig, startConfig } = opts.getConfig() + return serializeStartManifestData( + newClientBuild, + resolvedStartConfig.basePaths.publicBase, + !isDev + ? startConfig.server.build.inlineCss + : { enabled: false, transformAssets: false }, + opts.scriptFormat, + ) + }, + + updateManifest(newClientBuild: NormalizedClientBuild) { + clientBuild = newClientBuild + // Safe to call getConfig() here — runs after client build + const { resolvedStartConfig } = opts.getConfig() + if (isDev) { + ;( + globalThis as typeof globalThis & { + [DEV_START_MANIFEST_GLOBAL]?: ReturnType + } + )[DEV_START_MANIFEST_GLOBAL] = buildStartManifestData( + clientBuild, + resolvedStartConfig.basePaths.publicBase, + { enabled: false, transformAssets: false }, + opts.scriptFormat, + ) + } + }, + + updateServerFnResolver() { + const updateEnvironment = (environmentName: string) => { + if (!needsServerFnResolver(environmentName)) { + return + } + + writeResolverContent( + environmentName, + generateResolverContent(environmentName), + ) + } + + updateEnvironment(RSBUILD_ENVIRONMENT_NAMES.server) + if (hasSeparateProviderEnvironment) { + updateEnvironment(opts.providerEnvName) + } + }, + + tryUpdateServerFnResolver(content: string) { + lastResolverContentByEnvironment[RSBUILD_ENVIRONMENT_NAMES.server] = + content + tryWriteModule( + RSBUILD_ENVIRONMENT_NAMES.server, + paths.serverFnResolver, + content, + ) + }, + + getVirtualPath(moduleId: string): string { + return virtualPath(root, moduleId) + }, + } +} diff --git a/packages/start-plugin-core/src/schema.ts b/packages/start-plugin-core/src/schema.ts index 53b671b477..ab0bb9660a 100644 --- a/packages/start-plugin-core/src/schema.ts +++ b/packages/start-plugin-core/src/schema.ts @@ -1,10 +1,10 @@ import path from 'node:path' import { z } from 'zod' import { configSchema, getConfig } from '@tanstack/router-plugin' -import type { TanStackStartVitePluginCoreOptions } from './types' +import type { CompileStartFrameworkOptions } from './types' const tsrConfig = configSchema - .omit({ autoCodeSplitting: true, target: true, verboseFileRoutes: true }) + .omit({ autoCodeSplitting: true, target: true }) .partial() // --- Import Protection Schema --- @@ -41,15 +41,9 @@ const importProtectionOptionsSchema = z */ mockAccess: z.enum(['error', 'warn', 'off']).optional(), onViolation: z - .function() - .args(z.any()) - .returns( - z.union([ - z.boolean(), - z.void(), - z.promise(z.union([z.boolean(), z.void()])), - ]), - ) + .custom< + (violation: unknown) => boolean | void | Promise + >((value) => typeof value === 'function') .optional(), include: z.array(patternSchema).optional(), exclude: z.array(patternSchema).optional(), @@ -63,9 +57,11 @@ const importProtectionOptionsSchema = z export function parseStartConfig( opts: z.input, - corePluginOpts: TanStackStartVitePluginCoreOptions, + corePluginOpts: { framework: CompileStartFrameworkOptions }, root: string, ) { + const rawOptions = opts ?? {} + const rawRouterOptions = rawOptions.router ?? {} const options = tanstackStartOptionsSchema.parse(opts) const srcDirectory = options.srcDirectory @@ -73,13 +69,13 @@ export function parseStartConfig( const routesDirectory = path.resolve( root, srcDirectory, - options.router.routesDirectory ?? 'routes', + rawRouterOptions.routesDirectory ?? 'routes', ) const generatedRouteTree = path.resolve( root, srcDirectory, - options.router.generatedRouteTree ?? 'routeTree.gen.ts', + rawRouterOptions.generatedRouteTree ?? 'routeTree.gen.ts', ) return { @@ -149,14 +145,12 @@ const pagePrerenderOptionsSchema = z.object({ retryCount: z.number().optional(), retryDelay: z.number().optional(), onSuccess: z - .function() - .args( - z.object({ - page: pageBaseSchema, - html: z.string(), - }), - ) - .returns(z.any()) + .custom< + (result: { + page: z.infer + html: string + }) => unknown + >((value) => typeof value === 'function') .optional(), headers: z.record(z.string(), z.string()).optional(), }) @@ -166,7 +160,7 @@ const spaSchema = z.object({ maskPath: z.string().optional().default('/'), prerender: pagePrerenderOptionsSchema .optional() - .default({}) + .prefault({}) .transform((opts) => ({ outputPath: opts.outputPath ?? '/_shell', crawlLinks: false, @@ -176,107 +170,145 @@ const spaSchema = z.object({ })), }) +const inlineCssSchema = z + .union([ + z.boolean(), + z.object({ + /** + * Inline route CSS into the server-rendered HTML response. + * + * @experimental This option is experimental! + */ + enabled: z.boolean().optional().default(true), + /** + * Emit build-time templates that allow `transformAssets` to rewrite + * `url(...)` references inside inlined CSS at runtime. + */ + transformAssets: z.boolean().optional().default(false), + }), + ]) + .optional() + .default(false) + .transform((value) => { + if (typeof value === 'boolean') { + return { enabled: value, transformAssets: false } + } + + return value + }) + +export type InlineCssInputOptions = z.input + const pageSchema = pageBaseSchema.extend({ prerender: pagePrerenderOptionsSchema.optional(), }) -const tanstackStartOptionsSchema = z - .object({ - srcDirectory: z.string().optional().default('src'), - start: z - .object({ - entry: z.string().optional(), - }) - .optional() - .default({}), - router: z - .object({ - entry: z.string().optional(), - basepath: z.string().optional(), - }) - .and(tsrConfig.optional().default({})) - .optional() - .default({}), - client: z - .object({ - entry: z.string().optional(), - base: z.string().optional().default('/_build'), - }) - .optional() - .default({}), - server: z - .object({ - entry: z.string().optional(), - build: z - .object({ - staticNodeEnv: z.boolean().optional().default(true), - }) - .optional() - .default({}), - }) - .optional() - .default({}), - serverFns: z - .object({ - base: z.string().optional().default('/_serverFn'), - generateFunctionId: z - .function() - .args( - z.object({ - filename: z.string(), - functionName: z.string(), - }), - ) - .returns(z.string().optional()) - .optional(), - }) - .optional() - .default({}), - pages: z.array(pageSchema).optional().default([]), - sitemap: z - .object({ - enabled: z.boolean().optional().default(true), - host: z.string().optional(), - outputPath: z.string().optional().default('sitemap.xml'), - }) - .optional(), - prerender: z - .object({ - enabled: z.boolean().optional(), - concurrency: z.number().optional(), - filter: z.function().args(pageSchema).returns(z.any()).optional(), - failOnError: z.boolean().optional(), - autoStaticPathsDiscovery: z.boolean().optional(), - maxRedirects: z.number().min(0).optional(), - }) - .and(pagePrerenderOptionsSchema.optional()) - .optional(), - dev: z - .object({ - ssrStyles: z - .object({ - enabled: z.boolean().optional().default(true), - basepath: z.string().optional(), - }) - .optional() - .default({}), - }) - .optional() - .default({}), - spa: spaSchema.optional(), - vite: z - .object({ installDevServerMiddleware: z.boolean().optional() }) - .optional(), - importProtection: importProtectionOptionsSchema, - }) +export const tanstackStartOptionsObjectSchema = z.object({ + srcDirectory: z.string().optional().default('src'), + start: z + .object({ + entry: z.string().optional(), + }) + .optional() + .prefault({}), + router: z + .object({ + entry: z.string().optional(), + basepath: z.string().optional(), + }) + .and(tsrConfig.optional().prefault({})) + .optional() + .prefault({}), + client: z + .object({ + entry: z.string().optional(), + base: z.string().optional().default('/_build'), + }) + .optional() + .prefault({}), + server: z + .object({ + entry: z.string().optional(), + build: z + .object({ + staticNodeEnv: z.boolean().optional().default(true), + /** + * Inline route CSS into the server-rendered HTML response. + * + * @experimental This option is experimental! + */ + inlineCss: inlineCssSchema, + }) + .optional() + .prefault({}), + }) + .optional() + .prefault({}), + serverFns: z + .object({ + base: z.string().optional().default('/_serverFn'), + disableCsrfMiddlewareWarning: z.boolean().optional().default(false), + generateFunctionId: z + .custom< + (opts: { + filename: string + functionName: string + }) => string | undefined + >((value) => typeof value === 'function') + .optional(), + }) + .optional() + .prefault({}), + pages: z.array(pageSchema).optional().default([]), + sitemap: z + .object({ + enabled: z.boolean().optional().default(true), + host: z.string().optional(), + outputPath: z.string().optional().default('sitemap.xml'), + }) + .optional(), + prerender: z + .object({ + enabled: z.boolean().optional(), + concurrency: z.number().optional(), + filter: z + .custom< + (page: z.infer) => unknown + >((value) => typeof value === 'function') + .optional(), + failOnError: z.boolean().optional(), + autoStaticPathsDiscovery: z.boolean().optional(), + maxRedirects: z.number().min(0).optional(), + }) + .and(pagePrerenderOptionsSchema.optional()) + .optional(), + dev: z + .object({ + ssrStyles: z + .object({ + enabled: z.boolean().optional().default(true), + basepath: z.string().optional(), + }) + .optional() + .prefault({}), + }) + .optional() + .prefault({}), + spa: spaSchema.optional(), + importProtection: importProtectionOptionsSchema, +}) + +export const tanstackStartOptionsSchema = tanstackStartOptionsObjectSchema .optional() - .default({}) + .prefault({}) export type Page = z.infer -export type TanStackStartInputConfig = z.input< - typeof tanstackStartOptionsSchema +type TanStackStartOptionsInput = NonNullable< + z.input > + +export type TanStackStartInputConfig = TanStackStartOptionsInput export type TanStackStartOutputConfig = ReturnType export type ImportProtectionBehavior = z.infer< diff --git a/packages/start-plugin-core/src/serialization-adapters-module.ts b/packages/start-plugin-core/src/serialization-adapters-module.ts new file mode 100644 index 0000000000..39813b3e02 --- /dev/null +++ b/packages/start-plugin-core/src/serialization-adapters-module.ts @@ -0,0 +1,82 @@ +import type { SerializationAdapterConfig } from './types' + +export const EMPTY_SERIALIZATION_ADAPTERS_MODULE = `export const pluginSerializationAdapters = [] +export const hasPluginAdapters = false` + +interface ResolvedAdapterModule { + module: string + export: string + isFactory: boolean + index: number +} + +export function resolveSerializationAdaptersForRuntime(opts: { + adapters: Array | undefined + runtime: 'client' | 'server' +}): Array { + if (!opts.adapters?.length) { + return [] + } + + const resolvedAdapters: Array = [] + + for (let i = 0; i < opts.adapters.length; i++) { + const adapter = opts.adapters[i]! + + if ('module' in adapter) { + resolvedAdapters.push({ + module: adapter.module, + export: adapter.export, + isFactory: adapter.isFactory ?? true, + index: i, + }) + continue + } + + const runtimeAdapter = + opts.runtime === 'client' ? adapter.client : adapter.server + + if (!runtimeAdapter) { + continue + } + + resolvedAdapters.push({ + module: runtimeAdapter.module, + export: runtimeAdapter.export, + isFactory: runtimeAdapter.isFactory ?? true, + index: i, + }) + } + + return resolvedAdapters +} + +export function generateSerializationAdaptersModule(opts: { + adapters: Array | undefined + runtime: 'client' | 'server' +}): string { + const resolvedAdapters = resolveSerializationAdaptersForRuntime(opts) + + if (resolvedAdapters.length === 0) { + return EMPTY_SERIALIZATION_ADAPTERS_MODULE + } + + const imports = resolvedAdapters + .map( + (adapter) => + `import { ${adapter.export} as adapter${adapter.index} } from '${adapter.module}'`, + ) + .join('\n') + + const items = resolvedAdapters + .map((adapter) => + adapter.isFactory + ? `...(Array.isArray(adapter${adapter.index}()) ? adapter${adapter.index}() : [adapter${adapter.index}()])` + : `adapter${adapter.index}`, + ) + .join(', ') + + return `${imports} +export const pluginSerializationAdapters = [${items}] +export const hasPluginAdapters = true` +} diff --git a/packages/start-plugin-core/src/start-compiler-plugin/compiler.ts b/packages/start-plugin-core/src/start-compiler-plugin/compiler.ts deleted file mode 100644 index 62f530d510..0000000000 --- a/packages/start-plugin-core/src/start-compiler-plugin/compiler.ts +++ /dev/null @@ -1,1348 +0,0 @@ -/* eslint-disable import/no-commonjs */ -import crypto from 'node:crypto' -import * as t from '@babel/types' -import { - deadCodeElimination, - findReferencedIdentifiers, - generateFromAst, - parseAst, -} from '@tanstack/router-utils' -import babel from '@babel/core' -import { handleCreateServerFn } from './handleCreateServerFn' -import { handleCreateMiddleware } from './handleCreateMiddleware' -import { handleCreateIsomorphicFn } from './handleCreateIsomorphicFn' -import { handleEnvOnlyFn } from './handleEnvOnly' -import { handleClientOnlyJSX } from './handleClientOnlyJSX' -import type { - CompilationContext, - MethodChainPaths, - RewriteCandidate, - ServerFn, -} from './types' -import type { CompileStartFrameworkOptions } from '../types' - -type Binding = - | { - type: 'import' - source: string - importedName: string - resolvedKind?: Kind - } - | { - type: 'var' - init: t.Expression | null - resolvedKind?: Kind - } - -type Kind = 'None' | `Root` | `Builder` | LookupKind - -export type LookupKind = - | 'ServerFn' - | 'Middleware' - | 'IsomorphicFn' - | 'ServerOnlyFn' - | 'ClientOnlyFn' - | 'ClientOnlyJSX' - -// Detection strategy for each kind -type MethodChainSetup = { - type: 'methodChain' - candidateCallIdentifier: Set -} -type DirectCallSetup = { - type: 'directCall' - // The factory function name used to create this kind (e.g., 'createServerOnlyFn') - factoryName: string -} -type JSXSetup = { type: 'jsx'; componentName: string } - -function isLookupKind(kind: Kind): kind is LookupKind { - return kind in LookupSetup -} - -const LookupSetup: Record< - LookupKind, - MethodChainSetup | DirectCallSetup | JSXSetup -> = { - ServerFn: { - type: 'methodChain', - candidateCallIdentifier: new Set(['handler']), - }, - Middleware: { - type: 'methodChain', - candidateCallIdentifier: new Set(['server', 'client', 'createMiddlewares']), - }, - IsomorphicFn: { - type: 'methodChain', - candidateCallIdentifier: new Set(['server', 'client']), - }, - ServerOnlyFn: { type: 'directCall', factoryName: 'createServerOnlyFn' }, - ClientOnlyFn: { type: 'directCall', factoryName: 'createClientOnlyFn' }, - ClientOnlyJSX: { type: 'jsx', componentName: 'ClientOnly' }, -} - -// Single source of truth for detecting which kinds are present in code -// These patterns are used for: -// 1. Pre-scanning code to determine which kinds to look for (before AST parsing) -// 2. Deriving the plugin's transform code filter -export const KindDetectionPatterns: Record = { - ServerFn: /\bcreateServerFn\b|\.\s*handler\s*\(/, - Middleware: /createMiddleware/, - IsomorphicFn: /createIsomorphicFn/, - ServerOnlyFn: /createServerOnlyFn/, - ClientOnlyFn: /createClientOnlyFn/, - ClientOnlyJSX: /> = { - client: new Set([ - 'Middleware', - 'ServerFn', - 'IsomorphicFn', - 'ServerOnlyFn', - 'ClientOnlyFn', - ] as const), - server: new Set([ - 'ServerFn', - 'IsomorphicFn', - 'ServerOnlyFn', - 'ClientOnlyFn', - 'ClientOnlyJSX', // Only transform on server to remove children - ] as const), -} - -/** - * Handler type for processing candidates of a specific kind. - * The kind is passed as the third argument to allow shared handlers (like handleEnvOnlyFn). - */ -type KindHandler = ( - candidates: Array, - context: CompilationContext, - kind: LookupKind, -) => void - -/** - * Registry mapping each LookupKind to its handler function. - * When adding a new kind, add its handler here. - */ -const KindHandlers: Record< - Exclude, - KindHandler -> = { - ServerFn: handleCreateServerFn, - Middleware: handleCreateMiddleware, - IsomorphicFn: handleCreateIsomorphicFn, - ServerOnlyFn: handleEnvOnlyFn, - ClientOnlyFn: handleEnvOnlyFn, - // ClientOnlyJSX is handled separately via JSX traversal, not here -} - -// All lookup kinds as an array for iteration with proper typing -const AllLookupKinds = Object.keys(LookupSetup) as Array - -/** - * Detects which LookupKinds are present in the code using string matching. - * This is a fast pre-scan before AST parsing to limit the work done during compilation. - */ -export function detectKindsInCode( - code: string, - env: 'client' | 'server', -): Set { - const detected = new Set() - const validForEnv = LookupKindsPerEnv[env] - - for (const kind of AllLookupKinds) { - if (validForEnv.has(kind) && KindDetectionPatterns[kind].test(code)) { - detected.add(kind) - } - } - - return detected -} - -// Pre-computed map: identifier name -> Set for fast candidate detection (method chain only) -// Multiple kinds can share the same identifier (e.g., 'server' and 'client' are used by both Middleware and IsomorphicFn) -const IdentifierToKinds = new Map>() -for (const kind of AllLookupKinds) { - const setup = LookupSetup[kind] - if (setup.type === 'methodChain') { - for (const id of setup.candidateCallIdentifier) { - let kinds = IdentifierToKinds.get(id) - if (!kinds) { - kinds = new Set() - IdentifierToKinds.set(id, kinds) - } - kinds.add(kind) - } - } -} - -// Factory function names for direct call patterns. -// Used to filter nested candidates - we only want to include actual factory calls, -// not invocations of already-created functions (e.g., `myServerFn()` should NOT be a candidate) -const DirectCallFactoryNames = new Set() -for (const kind of AllLookupKinds) { - const setup = LookupSetup[kind] - if (setup.type === 'directCall') { - DirectCallFactoryNames.add(setup.factoryName) - } -} - -export type LookupConfig = { - libName: string - rootExport: string - kind: LookupKind | 'Root' // 'Root' for builder pattern, LookupKind for direct call -} - -interface ModuleInfo { - id: string - bindings: Map - // Maps exported name → local binding name - exports: Map - // Track `export * from './module'` declarations for re-export resolution - reExportAllSources: Array -} - -/** - * Computes whether any file kinds need direct-call candidate detection. - * This applies to directCall types (ServerOnlyFn, ClientOnlyFn). - */ -function needsDirectCallDetection(kinds: Set): boolean { - for (const kind of kinds) { - if (LookupSetup[kind].type === 'directCall') { - return true - } - } - return false -} - -/** - * Checks if all kinds in the set are guaranteed to be top-level only. - * Only ServerFn is always declared at module level (must be assigned to a variable). - * Middleware, IsomorphicFn, ServerOnlyFn, ClientOnlyFn can be nested inside functions. - * When all kinds are top-level-only, we can use a fast scan instead of full traversal. - */ -function areAllKindsTopLevelOnly(kinds: Set): boolean { - return kinds.size === 1 && kinds.has('ServerFn') -} - -/** - * Checks if we need to detect JSX elements (e.g., ). - */ -function needsJSXDetection(kinds: Set): boolean { - for (const kind of kinds) { - if (LookupSetup[kind].type === 'jsx') { - return true - } - } - return false -} - -/** - * Checks if a CallExpression is a direct-call candidate for NESTED detection. - * Returns true if the callee is a known factory function name. - * This is stricter than top-level detection because we need to filter out - * invocations of existing server functions (e.g., `myServerFn()`). - */ -function isNestedDirectCallCandidate(node: t.CallExpression): boolean { - let calleeName: string | undefined - if (t.isIdentifier(node.callee)) { - calleeName = node.callee.name - } else if ( - t.isMemberExpression(node.callee) && - t.isIdentifier(node.callee.property) - ) { - calleeName = node.callee.property.name - } - return calleeName !== undefined && DirectCallFactoryNames.has(calleeName) -} - -/** - * Checks if a CallExpression path is a top-level direct-call candidate. - * Top-level means the call is the init of a VariableDeclarator at program level. - * We accept any simple identifier call or namespace call at top level - * (e.g., `createServerOnlyFn()`, `TanStackStart.createServerOnlyFn()`) and let - * resolution verify it. This handles renamed imports. - */ -function isTopLevelDirectCallCandidate( - path: babel.NodePath, -): boolean { - const node = path.node - - // Must be a simple identifier call or namespace call - const isSimpleCall = - t.isIdentifier(node.callee) || - (t.isMemberExpression(node.callee) && - t.isIdentifier(node.callee.object) && - t.isIdentifier(node.callee.property)) - - if (!isSimpleCall) { - return false - } - - // Must be top-level: VariableDeclarator -> VariableDeclaration -> Program - const parent = path.parent - if (!t.isVariableDeclarator(parent) || parent.init !== node) { - return false - } - const grandParent = path.parentPath.parent - if (!t.isVariableDeclaration(grandParent)) { - return false - } - return t.isProgram(path.parentPath.parentPath?.parent) -} - -export class StartCompiler { - private moduleCache = new Map() - private initialized = false - private validLookupKinds: Set - private resolveIdCache = new Map() - private exportResolutionCache = new Map< - string, - Map - >() - // Fast lookup for direct imports from known libraries (e.g., '@tanstack/react-start') - // Maps: libName → (exportName → Kind) - // This allows O(1) resolution for the common case without async resolveId calls - private knownRootImports = new Map>() - - // For generating unique function IDs in production builds - private entryIdToFunctionId = new Map() - private functionIds = new Set() - - // Cached root path with trailing slash for dev mode function ID generation - private _rootWithTrailingSlash: string | undefined - - constructor( - private options: { - env: 'client' | 'server' - envName: string - root: string - lookupConfigurations: Array - lookupKinds: Set - loadModule: (id: string) => Promise - resolveId: (id: string, importer?: string) => Promise - /** - * In 'build' mode, resolution results are cached for performance. - * In 'dev' mode (default), caching is disabled to avoid invalidation complexity with HMR. - */ - mode?: 'dev' | 'build' - /** - * The framework being used (e.g., 'react', 'solid'). - */ - framework: CompileStartFrameworkOptions - /** - * The Vite environment name for the server function provider. - */ - providerEnvName: string - /** - * Custom function ID generator (optional, defaults to hash-based). - */ - generateFunctionId?: (opts: { - filename: string - functionName: string - }) => string | undefined - /** - * Callback when server functions are discovered. - * Called after each file is compiled with its new functions. - */ - onServerFnsById?: (d: Record) => void - /** - * Returns the currently known server functions from previous builds. - * Used by server callers to look up canonical extracted filenames. - */ - getKnownServerFns?: () => Record - }, - ) { - this.validLookupKinds = options.lookupKinds - } - - /** - * Generates a unique function ID for a server function. - * In dev mode, uses a base64-encoded JSON with file path and export name. - * In build mode, uses SHA256 hash or custom generator. - */ - private generateFunctionId(opts: { - filename: string - functionName: string - extractedFilename: string - }): string { - if (this.mode === 'dev') { - // In dev, encode the file path and export name for direct lookup - let file = opts.extractedFilename - if (opts.extractedFilename.startsWith(this.rootWithTrailingSlash)) { - file = opts.extractedFilename.slice(this.rootWithTrailingSlash.length) - } - file = `/@id/${file}` - - const serverFn = { - file, - export: opts.functionName, - } - return Buffer.from(JSON.stringify(serverFn), 'utf8').toString('base64url') - } - - // Production build: use custom generator or hash - const entryId = `${opts.filename}--${opts.functionName}` - let functionId = this.entryIdToFunctionId.get(entryId) - if (functionId === undefined) { - if (this.options.generateFunctionId) { - functionId = this.options.generateFunctionId({ - filename: opts.filename, - functionName: opts.functionName, - }) - } - if (!functionId) { - functionId = crypto.createHash('sha256').update(entryId).digest('hex') - } - // Deduplicate in case the generated id conflicts with an existing id - if (this.functionIds.has(functionId)) { - let deduplicatedId - let iteration = 0 - do { - deduplicatedId = `${functionId}_${++iteration}` - } while (this.functionIds.has(deduplicatedId)) - functionId = deduplicatedId - } - this.entryIdToFunctionId.set(entryId, functionId) - this.functionIds.add(functionId) - } - return functionId - } - - private get mode(): 'dev' | 'build' { - return this.options.mode ?? 'dev' - } - - private get rootWithTrailingSlash(): string { - if (this._rootWithTrailingSlash === undefined) { - this._rootWithTrailingSlash = this.options.root.endsWith('/') - ? this.options.root - : `${this.options.root}/` - } - return this._rootWithTrailingSlash - } - - private async resolveIdCached(id: string, importer?: string) { - if (this.mode === 'dev') { - return this.options.resolveId(id, importer) - } - - const cacheKey = importer ? `${importer}::${id}` : id - const cached = this.resolveIdCache.get(cacheKey) - if (cached !== undefined) { - return cached - } - const resolved = await this.options.resolveId(id, importer) - this.resolveIdCache.set(cacheKey, resolved) - return resolved - } - - private getExportResolutionCache(moduleId: string) { - let cache = this.exportResolutionCache.get(moduleId) - if (!cache) { - cache = new Map() - this.exportResolutionCache.set(moduleId, cache) - } - return cache - } - - private async init() { - // Register internal stub package exports for recognition. - // These don't need module resolution - only the knownRootImports fast path. - this.knownRootImports.set( - '@tanstack/start-fn-stubs', - new Map([ - ['createIsomorphicFn', 'IsomorphicFn'], - ['createServerOnlyFn', 'ServerOnlyFn'], - ['createClientOnlyFn', 'ClientOnlyFn'], - ]), - ) - - await Promise.all( - this.options.lookupConfigurations.map(async (config) => { - // Populate the fast lookup map for direct imports (by package name) - // This allows O(1) recognition of imports from known packages. - let libExports = this.knownRootImports.get(config.libName) - if (!libExports) { - libExports = new Map() - this.knownRootImports.set(config.libName, libExports) - } - libExports.set(config.rootExport, config.kind) - - // For JSX lookups (e.g., ClientOnlyJSX), we only need the knownRootImports - // fast path to verify imports. Skip module resolution which may fail if - // the package isn't a direct dependency (e.g., @tanstack/react-router from - // within start-plugin-core). - if (config.kind !== 'Root') { - const setup = LookupSetup[config.kind] - if (setup.type === 'jsx') { - return - } - } - - const libId = await this.resolveIdCached(config.libName) - if (!libId) { - throw new Error(`could not resolve "${config.libName}"`) - } - let rootModule = this.moduleCache.get(libId) - if (!rootModule) { - // insert root binding - rootModule = { - bindings: new Map(), - exports: new Map(), - id: libId, - reExportAllSources: [], - } - this.moduleCache.set(libId, rootModule) - } - - rootModule.exports.set(config.rootExport, config.rootExport) - rootModule.exports.set('*', config.rootExport) - rootModule.bindings.set(config.rootExport, { - type: 'var', - init: null, // Not needed since resolvedKind is set - resolvedKind: config.kind satisfies Kind, - }) - this.moduleCache.set(libId, rootModule) - }), - ) - - this.initialized = true - } - - /** - * Extracts bindings and exports from an already-parsed AST. - * This is the core logic shared by ingestModule and ingestModuleFromAst. - */ - private extractModuleInfo( - ast: ReturnType, - id: string, - ): ModuleInfo { - const bindings = new Map() - const exports = new Map() - const reExportAllSources: Array = [] - - // we are only interested in top-level bindings, hence we don't traverse the AST - // instead we only iterate over the program body - for (const node of ast.program.body) { - if (t.isImportDeclaration(node)) { - const source = node.source.value - for (const s of node.specifiers) { - if (t.isImportSpecifier(s)) { - const importedName = t.isIdentifier(s.imported) - ? s.imported.name - : s.imported.value - bindings.set(s.local.name, { type: 'import', source, importedName }) - } else if (t.isImportDefaultSpecifier(s)) { - bindings.set(s.local.name, { - type: 'import', - source, - importedName: 'default', - }) - } else if (t.isImportNamespaceSpecifier(s)) { - bindings.set(s.local.name, { - type: 'import', - source, - importedName: '*', - }) - } - } - } else if (t.isVariableDeclaration(node)) { - for (const decl of node.declarations) { - if (t.isIdentifier(decl.id)) { - bindings.set(decl.id.name, { - type: 'var', - init: decl.init ?? null, - }) - } - } - } else if (t.isExportNamedDeclaration(node)) { - // export const foo = ... - if (node.declaration) { - if (t.isVariableDeclaration(node.declaration)) { - for (const d of node.declaration.declarations) { - if (t.isIdentifier(d.id)) { - exports.set(d.id.name, d.id.name) - bindings.set(d.id.name, { type: 'var', init: d.init ?? null }) - } - } - } - } - for (const sp of node.specifiers) { - if (t.isExportNamespaceSpecifier(sp)) { - exports.set(sp.exported.name, sp.exported.name) - } - // export { local as exported } - else if (t.isExportSpecifier(sp)) { - const local = sp.local.name - const exported = t.isIdentifier(sp.exported) - ? sp.exported.name - : sp.exported.value - exports.set(exported, local) - - // When re-exporting from another module (export { foo } from './module'), - // create an import binding so the server function can be resolved - if (node.source) { - bindings.set(local, { - type: 'import', - source: node.source.value, - importedName: local, - }) - } - } - } - } else if (t.isExportDefaultDeclaration(node)) { - const d = node.declaration - if (t.isIdentifier(d)) { - exports.set('default', d.name) - } else { - const synth = '__default_export__' - bindings.set(synth, { type: 'var', init: d as t.Expression }) - exports.set('default', synth) - } - } else if (t.isExportAllDeclaration(node)) { - // Handle `export * from './module'` syntax - // Track the source so we can look up exports from it when needed - reExportAllSources.push(node.source.value) - } - } - - const info: ModuleInfo = { - id, - bindings, - exports, - reExportAllSources, - } - this.moduleCache.set(id, info) - return info - } - - public ingestModule({ code, id }: { code: string; id: string }) { - const ast = parseAst({ code }) - const info = this.extractModuleInfo(ast, id) - return { info, ast } - } - - public invalidateModule(id: string) { - // Note: Resolution caches (resolveIdCache, exportResolutionCache) are only - // used in build mode where there's no HMR. In dev mode, caching is disabled, - // so we only need to invalidate the moduleCache here. - return this.moduleCache.delete(id) - } - - public async compile({ - code, - id, - detectedKinds, - }: { - code: string - id: string - /** Pre-detected kinds present in this file. If not provided, all valid kinds are checked. */ - detectedKinds?: Set - }) { - if (!this.initialized) { - await this.init() - } - - // Use detected kinds if provided, otherwise fall back to all valid kinds for this env - const fileKinds = detectedKinds - ? new Set([...detectedKinds].filter((k) => this.validLookupKinds.has(k))) - : this.validLookupKinds - - // Early exit if no kinds to process - if (fileKinds.size === 0) { - return null - } - - const checkDirectCalls = needsDirectCallDetection(fileKinds) - // Optimization: ServerFn is always a top-level declaration (must be assigned to a variable). - // If the file only has ServerFn, we can skip full AST traversal and only visit - // the specific top-level declarations that have candidates. - const canUseFastPath = areAllKindsTopLevelOnly(fileKinds) - - // Always parse and extract module info upfront. - // This ensures the module is cached for import resolution even if no candidates are found. - const { ast } = this.ingestModule({ code, id }) - - // Single-pass traversal to: - // 1. Collect candidate paths (only candidates, not all CallExpressions) - // 2. Build a map for looking up paths of nested calls in method chains - const candidatePaths: Array> = [] - // Map for nested chain lookup - only populated for CallExpressions that are - // part of a method chain (callee.object is a CallExpression) - const chainCallPaths = new Map< - t.CallExpression, - babel.NodePath - >() - - // JSX candidates (e.g., ) - const jsxCandidatePaths: Array> = [] - const checkJSX = needsJSXDetection(fileKinds) - // Get module info that was just cached by ingestModule - const moduleInfo = this.moduleCache.get(id)! - - if (canUseFastPath) { - // Fast path: only visit top-level statements that have potential candidates - - // Collect indices of top-level statements that contain candidates - const candidateIndices: Array = [] - for (let i = 0; i < ast.program.body.length; i++) { - const node = ast.program.body[i]! - let declarations: Array | undefined - - if (t.isVariableDeclaration(node)) { - declarations = node.declarations - } else if (t.isExportNamedDeclaration(node) && node.declaration) { - if (t.isVariableDeclaration(node.declaration)) { - declarations = node.declaration.declarations - } - } - - if (declarations) { - for (const decl of declarations) { - if (decl.init && t.isCallExpression(decl.init)) { - if (isMethodChainCandidate(decl.init, fileKinds)) { - candidateIndices.push(i) - break // Only need to mark this statement once - } - } - } - } - } - - // Early exit: no potential candidates found at top level - if (candidateIndices.length === 0) { - return null - } - - // Targeted traversal: only visit the specific statements that have candidates - // This is much faster than traversing the entire AST - babel.traverse(ast, { - Program(programPath) { - const bodyPaths = programPath.get('body') - for (const idx of candidateIndices) { - const stmtPath = bodyPaths[idx] - if (!stmtPath) continue - - // Traverse only this statement's subtree - stmtPath.traverse({ - CallExpression(path) { - const node = path.node - const parent = path.parent - - // Check if this call is part of a larger chain (inner call) - if ( - t.isMemberExpression(parent) && - t.isCallExpression(path.parentPath.parent) - ) { - chainCallPaths.set(node, path) - return - } - - // Method chain pattern - if (isMethodChainCandidate(node, fileKinds)) { - candidatePaths.push(path) - } - }, - }) - } - // Stop traversal after processing Program - programPath.stop() - }, - }) - } else { - // Normal path: full traversal for non-fast-path kinds - babel.traverse(ast, { - CallExpression: (path) => { - const node = path.node - const parent = path.parent - - // Check if this call is part of a larger chain (inner call) - // If so, store it for method chain lookup but don't treat as candidate - if ( - t.isMemberExpression(parent) && - t.isCallExpression(path.parentPath.parent) - ) { - // This is an inner call in a chain - store for later lookup - chainCallPaths.set(node, path) - return - } - - // Pattern 1: Method chain pattern (.handler(), .server(), .client(), etc.) - if (isMethodChainCandidate(node, fileKinds)) { - candidatePaths.push(path) - return - } - - // Pattern 2: Direct call pattern - if (checkDirectCalls) { - if (isTopLevelDirectCallCandidate(path)) { - candidatePaths.push(path) - } else if (isNestedDirectCallCandidate(node)) { - candidatePaths.push(path) - } - } - }, - // Pattern 3: JSX element pattern (e.g., ) - // Collect JSX elements where the component is imported from a known package - // and resolves to a JSX kind (e.g., ClientOnly from @tanstack/react-router) - JSXElement: (path) => { - if (!checkJSX) return - - const openingElement = path.node.openingElement - const nameNode = openingElement.name - - // Only handle simple identifier names (not namespaced or member expressions) - if (!t.isJSXIdentifier(nameNode)) return - - const componentName = nameNode.name - const binding = moduleInfo.bindings.get(componentName) - - // Must be an import binding from a known package - if (!binding || binding.type !== 'import') return - - // Verify the import source is a known TanStack router package - const knownExports = this.knownRootImports.get(binding.source) - if (!knownExports) return - - // Verify the imported name resolves to a JSX kind (e.g., ClientOnlyJSX) - const kind = knownExports.get(binding.importedName) - if (kind !== 'ClientOnlyJSX') return - - jsxCandidatePaths.push(path) - }, - }) - } - - if (candidatePaths.length === 0 && jsxCandidatePaths.length === 0) { - return null - } - - // Resolve all candidates in parallel to determine their kinds - const resolvedCandidates = await Promise.all( - candidatePaths.map(async (path) => ({ - path, - kind: await this.resolveExprKind(path.node, id), - })), - ) - - // Filter to valid candidates - const validCandidates = resolvedCandidates.filter(({ kind }) => - this.validLookupKinds.has(kind as Exclude), - ) as Array<{ - path: babel.NodePath - kind: Exclude - }> - - if (validCandidates.length === 0 && jsxCandidatePaths.length === 0) { - return null - } - - // Process valid candidates to collect method chains - const pathsToRewrite: Array<{ - path: babel.NodePath - kind: Exclude - methodChain: MethodChainPaths - }> = [] - - for (const { path, kind } of validCandidates) { - const node = path.node - - // Collect method chain paths by walking DOWN from root through the chain - const methodChain: MethodChainPaths = { - middleware: null, - inputValidator: null, - handler: null, - server: null, - client: null, - } - - // Walk down the call chain using nodes, look up paths from map - let currentNode: t.CallExpression = node - let currentPath: babel.NodePath = path - - // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition - while (true) { - const callee = currentNode.callee - if (!t.isMemberExpression(callee)) { - break - } - - // Record method chain path if it's a known method - if (t.isIdentifier(callee.property)) { - const name = callee.property.name as keyof MethodChainPaths - if (name in methodChain) { - // Get first argument path - const args = currentPath.get('arguments') - const firstArgPath = - Array.isArray(args) && args.length > 0 ? (args[0] ?? null) : null - methodChain[name] = { - callPath: currentPath, - firstArgPath, - } - } - } - - // Move to the inner call (the object of the member expression) - if (!t.isCallExpression(callee.object)) { - break - } - currentNode = callee.object - // Look up path from chain map, or use candidate path if not found - const nextPath = chainCallPaths.get(currentNode) - if (!nextPath) { - break - } - currentPath = nextPath - } - - pathsToRewrite.push({ path, kind, methodChain }) - } - - const refIdents = findReferencedIdentifiers(ast) - - const context: CompilationContext = { - ast, - id, - code, - env: this.options.env, - envName: this.options.envName, - root: this.options.root, - framework: this.options.framework, - providerEnvName: this.options.providerEnvName, - - generateFunctionId: (opts) => this.generateFunctionId(opts), - getKnownServerFns: () => this.options.getKnownServerFns?.() ?? {}, - onServerFnsById: this.options.onServerFnsById, - } - - // Group candidates by kind for batch processing - const candidatesByKind = new Map< - Exclude, - Array - >() - - for (const { path: candidatePath, kind, methodChain } of pathsToRewrite) { - const candidate: RewriteCandidate = { path: candidatePath, methodChain } - const existing = candidatesByKind.get(kind) - if (existing) { - existing.push(candidate) - } else { - candidatesByKind.set(kind, [candidate]) - } - } - - // Process each kind using its registered handler - for (const [kind, candidates] of candidatesByKind) { - const handler = KindHandlers[kind] - handler(candidates, context, kind) - } - - // Handle JSX candidates (e.g., ) - // Validation was already done during traversal - just call the handler - for (const jsxPath of jsxCandidatePaths) { - handleClientOnlyJSX(jsxPath, { env: 'server' }) - } - - deadCodeElimination(ast, refIdents) - - const result = generateFromAst(ast, { - sourceMaps: true, - sourceFileName: id, - filename: id, - }) - - // @babel/generator does not populate sourcesContent because it only has - // the AST, not the original text. Without this, Vite's composed - // sourcemap omits the original source, causing downstream consumers - // (e.g. import-protection snippet display) to fall back to the shorter - // compiled output and fail to resolve original line numbers. - if (result.map) { - result.map.sourcesContent = [code] - } - - return result - } - - private async resolveIdentifierKind( - ident: string, - id: string, - visited = new Set(), - ): Promise { - const info = await this.getModuleInfo(id) - - const binding = info.bindings.get(ident) - if (!binding) { - return 'None' - } - if (binding.resolvedKind) { - return binding.resolvedKind - } - - // TODO improve cycle detection? should we throw here instead of returning 'None'? - // prevent cycles - const vKey = `${id}:${ident}` - if (visited.has(vKey)) { - return 'None' - } - visited.add(vKey) - - const resolvedKind = await this.resolveBindingKind(binding, id, visited) - binding.resolvedKind = resolvedKind - return resolvedKind - } - - /** - * Recursively find an export in a module, following `export * from` chains. - * Returns the module info and binding if found, or undefined if not found. - */ - private async findExportInModule( - moduleInfo: ModuleInfo, - exportName: string, - visitedModules = new Set(), - ): Promise<{ moduleInfo: ModuleInfo; binding: Binding } | undefined> { - const isBuildMode = this.mode === 'build' - - // Check cache first (only for top-level calls in build mode) - if (isBuildMode && visitedModules.size === 0) { - const moduleCache = this.exportResolutionCache.get(moduleInfo.id) - if (moduleCache) { - const cached = moduleCache.get(exportName) - if (cached !== undefined) { - return cached ?? undefined - } - } - } - - // Prevent infinite loops in circular re-exports - if (visitedModules.has(moduleInfo.id)) { - return undefined - } - visitedModules.add(moduleInfo.id) - - // First check direct exports - const localBindingName = moduleInfo.exports.get(exportName) - if (localBindingName) { - const binding = moduleInfo.bindings.get(localBindingName) - if (binding) { - const result = { moduleInfo, binding } - // Cache the result (build mode only) - if (isBuildMode) { - this.getExportResolutionCache(moduleInfo.id).set(exportName, result) - } - return result - } - } - - // If not found, recursively check re-export-all sources in parallel - // Valid code won't have duplicate exports across chains, so first match wins - if (moduleInfo.reExportAllSources.length > 0) { - const results = await Promise.all( - moduleInfo.reExportAllSources.map(async (reExportSource) => { - const reExportTarget = await this.resolveIdCached( - reExportSource, - moduleInfo.id, - ) - - if (reExportTarget) { - const reExportModule = await this.getModuleInfo(reExportTarget) - return this.findExportInModule( - reExportModule, - exportName, - visitedModules, - ) - } - return undefined - }), - ) - // Return the first valid result - for (const result of results) { - if (result) { - // Cache the result (build mode only) - if (isBuildMode) { - this.getExportResolutionCache(moduleInfo.id).set(exportName, result) - } - return result - } - } - } - - // Cache negative result (build mode only) - if (isBuildMode) { - this.getExportResolutionCache(moduleInfo.id).set(exportName, null) - } - return undefined - } - - private async resolveBindingKind( - binding: Binding, - fileId: string, - visited = new Set(), - ): Promise { - if (binding.resolvedKind) { - return binding.resolvedKind - } - if (binding.type === 'import') { - // Fast path: check if this is a direct import from a known library - // (e.g., import { createServerFn } from '@tanstack/react-start') - // This avoids async resolveId calls for the common case - const knownExports = this.knownRootImports.get(binding.source) - if (knownExports) { - const kind = knownExports.get(binding.importedName) - if (kind) { - binding.resolvedKind = kind - return kind - } - } - - // Slow path: resolve through the module graph - const target = await this.resolveIdCached(binding.source, fileId) - if (!target) { - return 'None' - } - - const importedModule = await this.getModuleInfo(target) - - // Find the export, recursively searching through export * from chains - const found = await this.findExportInModule( - importedModule, - binding.importedName, - ) - - if (!found) { - return 'None' - } - - const { moduleInfo: foundModule, binding: foundBinding } = found - - if (foundBinding.resolvedKind) { - return foundBinding.resolvedKind - } - - const resolvedKind = await this.resolveBindingKind( - foundBinding, - foundModule.id, - visited, - ) - foundBinding.resolvedKind = resolvedKind - return resolvedKind - } - - const resolvedKind = await this.resolveExprKind( - binding.init, - fileId, - visited, - ) - // When a var binding's init is a call to a directCall factory - // (e.g., `const myFn = createServerOnlyFn(() => ...)`), the binding holds - // the RESULT of the factory, not the factory itself. Clear the kind so - // `myFn()` isn't incorrectly matched as a directCall candidate. - // We only clear when the init is a CallExpression — an alias like - // `const createSO = createServerOnlyFn` should still propagate the kind. - if ( - isLookupKind(resolvedKind) && - LookupSetup[resolvedKind].type === 'directCall' && - binding.init && - t.isCallExpression(binding.init) - ) { - binding.resolvedKind = 'None' - return 'None' - } - binding.resolvedKind = resolvedKind - return resolvedKind - } - - private async resolveExprKind( - expr: t.Expression | null, - fileId: string, - visited = new Set(), - ): Promise { - if (!expr) { - return 'None' - } - - // Unwrap common TypeScript/parenthesized wrappers first for efficiency - while ( - t.isTSAsExpression(expr) || - t.isTSNonNullExpression(expr) || - t.isParenthesizedExpression(expr) - ) { - expr = expr.expression - } - - let result: Kind = 'None' - - if (t.isCallExpression(expr)) { - if (!t.isExpression(expr.callee)) { - return 'None' - } - const calleeKind = await this.resolveCalleeKind( - expr.callee, - fileId, - visited, - ) - if (calleeKind === 'Root' || calleeKind === 'Builder') { - return 'Builder' - } - // For method chain patterns (callee is MemberExpression like .server() or .client()), - // return the resolved kind if valid - if (t.isMemberExpression(expr.callee)) { - if (this.validLookupKinds.has(calleeKind as LookupKind)) { - return calleeKind - } - } - // For direct calls (callee is Identifier like createServerOnlyFn()), - // trust calleeKind if it resolved to a valid LookupKind. This means - // resolveBindingKind successfully traced the import back to - // @tanstack/start-fn-stubs (via fast path or slow path through re-exports). - // This handles both direct imports from @tanstack/react-start and imports - // from intermediate packages that re-export from @tanstack/start-client-core. - if (t.isIdentifier(expr.callee)) { - if (this.validLookupKinds.has(calleeKind as LookupKind)) { - return calleeKind - } - } - } else if (t.isMemberExpression(expr) && t.isIdentifier(expr.property)) { - result = await this.resolveCalleeKind(expr.object, fileId, visited) - } - - if (result === 'None' && t.isIdentifier(expr)) { - result = await this.resolveIdentifierKind(expr.name, fileId, visited) - } - - return result - } - - private async resolveCalleeKind( - callee: t.Expression, - fileId: string, - visited = new Set(), - ): Promise { - if (t.isIdentifier(callee)) { - return this.resolveIdentifierKind(callee.name, fileId, visited) - } - - if (t.isMemberExpression(callee) && t.isIdentifier(callee.property)) { - const prop = callee.property.name - - // Check if this property matches any method chain pattern - const possibleKinds = IdentifierToKinds.get(prop) - if (possibleKinds) { - // Resolve base expression ONCE and reuse for all pattern checks - const base = await this.resolveExprKind(callee.object, fileId, visited) - - // Check each possible kind that uses this identifier - for (const kind of possibleKinds) { - if (!this.validLookupKinds.has(kind)) continue - - if (kind === 'ServerFn') { - if (base === 'Root' || base === 'Builder') { - return 'ServerFn' - } - } else if (kind === 'Middleware') { - if ( - base === 'Root' || - base === 'Builder' || - base === 'Middleware' - ) { - return 'Middleware' - } - } else if (kind === 'IsomorphicFn') { - if ( - base === 'Root' || - base === 'Builder' || - base === 'IsomorphicFn' - ) { - return 'IsomorphicFn' - } - } - } - } - - // Check if the object is a namespace import - if (t.isIdentifier(callee.object)) { - const info = await this.getModuleInfo(fileId) - const binding = info.bindings.get(callee.object.name) - if ( - binding && - binding.type === 'import' && - binding.importedName === '*' - ) { - // resolve the property from the target module - const targetModuleId = await this.resolveIdCached( - binding.source, - fileId, - ) - if (targetModuleId) { - const targetModule = await this.getModuleInfo(targetModuleId) - const localBindingName = targetModule.exports.get( - callee.property.name, - ) - if (localBindingName) { - const exportedBinding = - targetModule.bindings.get(localBindingName) - if (exportedBinding) { - return await this.resolveBindingKind( - exportedBinding, - targetModule.id, - visited, - ) - } - } - } else { - return 'None' - } - } - } - return this.resolveExprKind(callee.object, fileId, visited) - } - - // handle nested expressions - return this.resolveExprKind(callee, fileId, visited) - } - - private async getModuleInfo(id: string) { - let cached = this.moduleCache.get(id) - if (cached) { - return cached - } - - await this.options.loadModule(id) - - cached = this.moduleCache.get(id) - if (!cached) { - throw new Error(`could not load module info for ${id}`) - } - return cached - } -} - -/** - * Checks if a CallExpression has a method chain pattern that matches any of the lookup kinds. - * E.g., `.handler()`, `.server()`, `.client()`, `.createMiddlewares()` - */ -function isMethodChainCandidate( - node: t.CallExpression, - lookupKinds: Set, -): boolean { - const callee = node.callee - if (!t.isMemberExpression(callee) || !t.isIdentifier(callee.property)) { - return false - } - - // Use pre-computed map for O(1) lookup - // IdentifierToKinds maps identifier -> Set to handle shared identifiers - const possibleKinds = IdentifierToKinds.get(callee.property.name) - if (possibleKinds) { - // Check if any of the possible kinds are in the valid lookup kinds - for (const kind of possibleKinds) { - if (lookupKinds.has(kind)) { - return true - } - } - } - - return false -} diff --git a/packages/start-plugin-core/src/start-compiler-plugin/plugin.ts b/packages/start-plugin-core/src/start-compiler-plugin/plugin.ts deleted file mode 100644 index ef53af07e5..0000000000 --- a/packages/start-plugin-core/src/start-compiler-plugin/plugin.ts +++ /dev/null @@ -1,478 +0,0 @@ -import assert from 'node:assert' -import { VIRTUAL_MODULES } from '@tanstack/start-server-core' -import { resolve as resolvePath } from 'pathe' -import { - SERVER_FN_LOOKUP, - TRANSFORM_ID_REGEX, - VITE_ENVIRONMENT_NAMES, -} from '../constants' -import { - KindDetectionPatterns, - LookupKindsPerEnv, - StartCompiler, - detectKindsInCode, -} from './compiler' -import { cleanId } from './utils' -import type { CompileStartFrameworkOptions } from '../types' -import type { LookupConfig, LookupKind } from './compiler' -import type { GenerateFunctionIdFnOptional, ServerFn } from './types' -import type { PluginOption } from 'vite' - -// Derive transform code filter from KindDetectionPatterns (single source of truth) -function getTransformCodeFilterForEnv(env: 'client' | 'server'): Array { - const validKinds = LookupKindsPerEnv[env] - const patterns: Array = [] - for (const [kind, pattern] of Object.entries(KindDetectionPatterns) as Array< - [LookupKind, RegExp] - >) { - if (validKinds.has(kind)) { - patterns.push(pattern) - } - } - return patterns -} - -const getLookupConfigurationsForEnv = ( - env: 'client' | 'server', - framework: CompileStartFrameworkOptions, -): Array => { - // Common configs for all environments - const commonConfigs: Array = [ - { - libName: `@tanstack/${framework}-start`, - rootExport: 'createServerFn', - kind: 'Root', - }, - { - libName: `@tanstack/${framework}-start`, - rootExport: 'createIsomorphicFn', - kind: 'IsomorphicFn', - }, - { - libName: `@tanstack/${framework}-start`, - rootExport: 'createServerOnlyFn', - kind: 'ServerOnlyFn', - }, - { - libName: `@tanstack/${framework}-start`, - rootExport: 'createClientOnlyFn', - kind: 'ClientOnlyFn', - }, - ] - - if (env === 'client') { - return [ - { - libName: `@tanstack/${framework}-start`, - rootExport: 'createMiddleware', - kind: 'Root', - }, - { - libName: `@tanstack/${framework}-start`, - rootExport: 'createStart', - kind: 'Root', - }, - ...commonConfigs, - ] - } else { - // Server-only: add ClientOnly JSX component lookup - return [ - ...commonConfigs, - { - libName: `@tanstack/${framework}-router`, - rootExport: 'ClientOnly', - kind: 'ClientOnlyJSX', - }, - ] - } -} -// Re-export from shared constants for backwards compatibility -export { SERVER_FN_LOOKUP } - -function resolveViteId(id: string) { - return `\0${id}` -} - -const validateServerFnIdVirtualModule = `virtual:tanstack-start-validate-server-fn-id` - -function parseIdQuery(id: string): { - filename: string - query: { - [k: string]: string - } -} { - if (!id.includes('?')) return { filename: id, query: {} } - const [filename, rawQuery] = id.split(`?`, 2) as [string, string] - const query = Object.fromEntries(new URLSearchParams(rawQuery)) - return { filename, query } -} - -/** - * Generates the manifest module code for server functions. - * @param serverFnsById - Map of function IDs to their server function info - * @param includeClientReferencedCheck - Whether to include isClientReferenced flag and runtime check. - * This is needed when SSR is NOT the provider, so server-only-referenced functions in the manifest - * can be blocked from client HTTP requests. - */ -function generateManifestModule( - serverFnsById: Record, - includeClientReferencedCheck: boolean, -): string { - const manifestEntries = Object.entries(serverFnsById) - .map(([id, fn]) => { - const baseEntry = `'${id}': { - functionName: '${fn.functionName}', - importer: () => import(${JSON.stringify(fn.extractedFilename)})${ - includeClientReferencedCheck - ? `, - isClientReferenced: ${fn.isClientReferenced ?? true}` - : '' - } - }` - return baseEntry - }) - .join(',') - - const getServerFnByIdParams = includeClientReferencedCheck ? 'id, opts' : 'id' - const clientReferencedCheck = includeClientReferencedCheck - ? ` - // If called from client, only allow client-referenced functions - if (opts?.fromClient && !serverFnInfo.isClientReferenced) { - throw new Error('Server function not accessible from client: ' + id) - } -` - : '' - - return ` - const manifest = {${manifestEntries}} - - export async function getServerFnById(${getServerFnByIdParams}) { - const serverFnInfo = manifest[id] - if (!serverFnInfo) { - throw new Error('Server function info not found for ' + id) - } -${clientReferencedCheck} - const fnModule = await serverFnInfo.importer() - - if (!fnModule) { - console.info('serverFnInfo', serverFnInfo) - throw new Error('Server function module not resolved for ' + id) - } - - const action = fnModule[serverFnInfo.functionName] - - if (!action) { - console.info('serverFnInfo', serverFnInfo) - console.info('fnModule', fnModule) - - throw new Error( - \`Server function module export not resolved for serverFn ID: \${id}\`, - ) - } - return action - } - ` -} - -export interface StartCompilerPluginOptions { - framework: CompileStartFrameworkOptions - environments: Array<{ name: string; type: 'client' | 'server' }> - /** - * Custom function ID generator (optional). - */ - generateFunctionId?: GenerateFunctionIdFnOptional - /** - * The Vite environment name for the server function provider. - */ - providerEnvName: string -} - -export function startCompilerPlugin( - opts: StartCompilerPluginOptions, -): PluginOption { - const compilers: Record = {} - - // Shared registry of server functions across all environments - const serverFnsById: Record = {} - - const onServerFnsById = (d: Record) => { - Object.assign(serverFnsById, d) - } - - let root = process.cwd() - let _command: 'build' | 'serve' = 'build' - - const resolvedResolverVirtualImportId = resolveViteId( - VIRTUAL_MODULES.serverFnResolver, - ) - - // Determine which environments need the resolver (getServerFnById) - // SSR environment always needs the resolver for server-side calls - // Provider environment needs it for the actual implementation - const ssrEnvName = VITE_ENVIRONMENT_NAMES.server - - // SSR is the provider when the provider environment is the default server environment - const ssrIsProvider = opts.providerEnvName === ssrEnvName - - // Environments that need the resolver: SSR (for server calls) and provider (for implementation) - const appliedResolverEnvironments = new Set( - ssrIsProvider ? [opts.providerEnvName] : [ssrEnvName, opts.providerEnvName], - ) - - function perEnvServerFnPlugin(environment: { - name: string - type: 'client' | 'server' - }): PluginOption { - // Derive transform code filter from KindDetectionPatterns (single source of truth) - const transformCodeFilter = getTransformCodeFilterForEnv(environment.type) - - return { - name: `tanstack-start-core::server-fn:${environment.name}`, - enforce: 'pre', - applyToEnvironment(env) { - return env.name === environment.name - }, - configResolved(config) { - root = config.root - _command = config.command - }, - transform: { - filter: { - id: { - exclude: new RegExp(`${SERVER_FN_LOOKUP}$`), - include: TRANSFORM_ID_REGEX, - }, - code: { - include: transformCodeFilter, - }, - }, - async handler(code, id) { - let compiler = compilers[this.environment.name] - if (!compiler) { - // Default to 'dev' mode for unknown environments (conservative: no caching) - const mode = this.environment.mode === 'build' ? 'build' : 'dev' - compiler = new StartCompiler({ - env: environment.type, - envName: environment.name, - root, - lookupKinds: LookupKindsPerEnv[environment.type], - lookupConfigurations: getLookupConfigurationsForEnv( - environment.type, - opts.framework, - ), - mode, - framework: opts.framework, - providerEnvName: opts.providerEnvName, - generateFunctionId: opts.generateFunctionId, - onServerFnsById, - getKnownServerFns: () => serverFnsById, - loadModule: async (id: string) => { - if (this.environment.mode === 'build') { - const loaded = await this.load({ id }) - // Handle modules with no runtime code (e.g., type-only exports). - // After TypeScript compilation, these become empty modules. - // Create an empty module info instead of throwing. - const code = loaded.code ?? '' - compiler!.ingestModule({ code, id }) - } else if (this.environment.mode === 'dev') { - /** - * in dev, vite does not return code from `ctx.load()` - * so instead, we need to take a different approach - * we must force vite to load the module and run it through the vite plugin pipeline - * we can do this by using the `fetchModule` method - * the `captureServerFnModuleLookupPlugin` captures the module code via its transform hook and invokes analyzeModuleAST - */ - await this.environment.fetchModule( - id + '?' + SERVER_FN_LOOKUP, - ) - } else { - throw new Error( - `could not load module ${id}: unknown environment mode ${this.environment.mode}`, - ) - } - }, - resolveId: async (source: string, importer?: string) => { - const r = await this.resolve(source, importer) - if (r) { - if (!r.external) { - return cleanId(r.id) - } - } - return null - }, - }) - compilers[this.environment.name] = compiler - } - - // Detect which kinds are present in this file before parsing - const detectedKinds = detectKindsInCode(code, environment.type) - - const result = await compiler.compile({ - id, - code, - detectedKinds, - }) - return result - }, - }, - - hotUpdate(ctx) { - const compiler = compilers[this.environment.name] - - ctx.modules.forEach((m) => { - if (m.id) { - const deleted = compiler?.invalidateModule(m.id) - if (deleted) { - m.importers.forEach((importer) => { - if (importer.id) { - compiler?.invalidateModule(importer.id) - } - }) - } - } - }) - }, - } - } - - return [ - ...opts.environments.map(perEnvServerFnPlugin), - { - name: 'tanstack-start-core:capture-server-fn-module-lookup', - // we only need this plugin in dev mode - apply: 'serve', - applyToEnvironment(env) { - return !!opts.environments.find((e) => e.name === env.name) - }, - transform: { - filter: { - id: new RegExp(`${SERVER_FN_LOOKUP}$`), - }, - handler(code, id) { - const compiler = compilers[this.environment.name] - compiler?.ingestModule({ code, id: cleanId(id) }) - }, - }, - }, - // Validate server function ID in dev mode - { - name: 'tanstack-start-core:validate-server-fn-id', - apply: 'serve', - load: { - filter: { - id: new RegExp(resolveViteId(validateServerFnIdVirtualModule)), - }, - async handler(id) { - const parsed = parseIdQuery(id) - const fnId = parsed.query.id - if (fnId && serverFnsById[fnId]) { - return `export {}` - } - - // ID not yet registered — the source file may not have been - // transformed in this dev session yet (e.g. cold restart with - // cached client). Try to decode the ID, discover the source - // file, trigger its compilation, and re-check. - if (fnId) { - try { - const decoded = JSON.parse( - Buffer.from(fnId, 'base64url').toString('utf8'), - ) - if ( - typeof decoded.file === 'string' && - typeof decoded.export === 'string' - ) { - // decoded.file looks like "/@id/src/foo.ts?tss-serverfn-split" - // Strip the /@id/ prefix and ?tss-serverfn-split suffix to - // get the original source file path that needs transforming. - let sourceFile = decoded.file - if (sourceFile.startsWith('/@id/')) { - sourceFile = sourceFile.slice('/@id/'.length) - } - const qIdx = sourceFile.indexOf('?') - if (qIdx !== -1) { - sourceFile = sourceFile.slice(0, qIdx) - } - - // Resolve to absolute path - const absPath = resolvePath(root, sourceFile) - - // Trigger transform of the source file in this environment, - // which will compile createServerFn calls and populate - // serverFnsById as a side effect. - // This plugin only runs in dev (apply: 'serve'), so mode - // must be 'dev' — assert to narrow to DevEnvironment. - assert(this.environment.mode === 'dev') - await this.environment.fetchModule(absPath) - - // Re-check after lazy compilation - if (serverFnsById[fnId]) { - return `export {}` - } - } - } catch { - // Decoding or fetching failed — fall through to error - } - } - - this.error(`Invalid server function ID: ${fnId}`) - }, - }, - }, - // Manifest plugin for server environments - { - name: 'tanstack-start-core:server-fn-resolver', - enforce: 'pre', - applyToEnvironment: (env) => { - return appliedResolverEnvironments.has(env.name) - }, - configResolved(config) { - root = config.root - _command = config.command - }, - resolveId: { - filter: { id: new RegExp(VIRTUAL_MODULES.serverFnResolver) }, - handler() { - return resolvedResolverVirtualImportId - }, - }, - load: { - filter: { id: new RegExp(resolvedResolverVirtualImportId) }, - handler() { - // When SSR is not the provider, SSR callers need to use HTTP to call server functions - // since they can't directly import from the provider environment - if (this.environment.name !== opts.providerEnvName) { - // SSR caller: use HTTP-based getServerFnById - // This re-exports from the start-server-core package which handles HTTP calls - return `export { getServerFnById } from '@tanstack/start-server-core/server-fn-ssr-caller'` - } - - if (this.environment.mode !== 'build') { - const mod = ` - export async function getServerFnById(id) { - const validateIdImport = ${JSON.stringify(validateServerFnIdVirtualModule)} + '?id=' + id - await import(/* @vite-ignore */ '/@id/__x00__' + validateIdImport) - const decoded = Buffer.from(id, 'base64url').toString('utf8') - const devServerFn = JSON.parse(decoded) - const mod = await import(/* @vite-ignore */ devServerFn.file) - return mod[devServerFn.export] - } - ` - return mod - } - - // When SSR is the provider, server-only-referenced functions aren't in the manifest, - // so no isClientReferenced check is needed. - // When SSR is NOT the provider (custom provider env), server-only-referenced - // functions ARE in the manifest and need the isClientReferenced check to - // block direct client HTTP requests to server-only-referenced functions. - const includeClientReferencedCheck = !ssrIsProvider - return generateManifestModule( - serverFnsById, - includeClientReferencedCheck, - ) - }, - }, - }, - ] -} diff --git a/packages/start-plugin-core/src/start-compiler/compiler.ts b/packages/start-plugin-core/src/start-compiler/compiler.ts new file mode 100644 index 0000000000..458c467e4d --- /dev/null +++ b/packages/start-plugin-core/src/start-compiler/compiler.ts @@ -0,0 +1,1962 @@ +import crypto from 'node:crypto' +import * as t from '@babel/types' +import { + deadCodeElimination, + extractModuleInfoFromAst, + findReferencedIdentifiers, + generateFromAst, + parseAst, +} from '@tanstack/router-utils' +import babel from '@babel/core' +import { handleCreateServerFn } from './handleCreateServerFn' +import { handleCreateMiddleware } from './handleCreateMiddleware' +import { handleCreateIsomorphicFn } from './handleCreateIsomorphicFn' +import { handleEnvOnlyFn } from './handleEnvOnly' +import { handleClientOnlyJSX } from './handleClientOnlyJSX' +import { cleanId } from './utils' +import type { + CompilationContext, + DevServerFnModuleSpecifierEncoder, + MethodChainPaths, + RewriteCandidate, + ServerFn, +} from './types' +import type { ModuleInfoBinding } from '@tanstack/router-utils' +import type { + CompileStartFrameworkOptions, + StartCompilerEnvironment, + StartCompilerImportTransform, + StartCompilerPlugin, + StartCompilerTransformResult, +} from '../types' + +type Binding = ModuleInfoBinding & { + resolvedKind?: Kind +} + +type ImportBinding = Extract + +type Kind = 'None' | `Root` | `Builder` | LookupKind +type ParsedAst = ReturnType +type StartCompilerAstPlugin = StartCompilerPlugin & { + transformAst: NonNullable +} + +export type BuiltInLookupKind = + | 'ServerFn' + | 'Middleware' + | 'IsomorphicFn' + | 'ServerOnlyFn' + | 'ClientOnlyFn' + | 'ClientOnlyJSX' + +export type ExternalLookupKind = `External:${string}` + +export type LookupKind = BuiltInLookupKind | ExternalLookupKind + +// Detection strategy for each kind +type MethodChainSetup = { + type: 'methodChain' + candidateCallIdentifier: Set +} +type DirectCallSetup = { + type: 'directCall' + // The factory function name used to create this kind (e.g., 'createServerOnlyFn') + factoryNames: Set +} +type JSXSetup = { type: 'jsx'; componentName: string } + +function isLookupKind(kind: Kind): kind is LookupKind { + return kind in BuiltInLookupSetup || isExternalLookupKind(kind) +} + +export function getExternalLookupKind( + transform: StartCompilerImportTransform, +): ExternalLookupKind { + return `External:${transform.name}` +} + +function isExternalLookupKind(kind: Kind): kind is ExternalLookupKind { + return typeof kind === 'string' && kind.startsWith('External:') +} + +export function isCompilerTransformEnabledForEnv( + transform: StartCompilerImportTransform, + env: StartCompilerEnvironment, +): boolean { + return isStartCompilerEnvironmentEnabled(transform.environment, env) +} + +export function isStartCompilerPluginEnabledForEnv( + plugin: StartCompilerPlugin, + env: StartCompilerEnvironment, +): boolean { + return isStartCompilerEnvironmentEnabled(plugin.environment, env) +} + +function isStartCompilerEnvironmentEnabled( + environment: + | StartCompilerEnvironment + | Array + | undefined, + env: StartCompilerEnvironment, +): boolean { + if (!environment) return true + if (Array.isArray(environment)) { + return environment.includes(env) + } + return environment === env +} + +const BuiltInLookupSetup: Record< + BuiltInLookupKind, + MethodChainSetup | DirectCallSetup | JSXSetup +> = { + ServerFn: { + type: 'methodChain', + candidateCallIdentifier: new Set(['handler']), + }, + Middleware: { + type: 'methodChain', + candidateCallIdentifier: new Set(['server', 'client', 'createMiddlewares']), + }, + IsomorphicFn: { + type: 'methodChain', + candidateCallIdentifier: new Set(['server', 'client']), + }, + ServerOnlyFn: { + type: 'directCall', + factoryNames: new Set(['createServerOnlyFn']), + }, + ClientOnlyFn: { + type: 'directCall', + factoryNames: new Set(['createClientOnlyFn']), + }, + ClientOnlyJSX: { type: 'jsx', componentName: 'ClientOnly' }, +} + +// Single source of truth for detecting which kinds are present in code +// These patterns are used for: +// 1. Pre-scanning code to determine which kinds to look for (before AST parsing) +// 2. Deriving the plugin's transform code filter +export const KindDetectionPatterns: Record = { + ServerFn: /\bcreateServerFn\b|\.\s*handler\s*\(/, + Middleware: /createMiddleware/, + IsomorphicFn: /createIsomorphicFn/, + ServerOnlyFn: /createServerOnlyFn/, + ClientOnlyFn: /createClientOnlyFn/, + ClientOnlyJSX: / +> = { + client: new Set([ + 'Middleware', + 'ServerFn', + 'IsomorphicFn', + 'ServerOnlyFn', + 'ClientOnlyFn', + ] as const), + server: new Set([ + 'ServerFn', + 'IsomorphicFn', + 'ServerOnlyFn', + 'ClientOnlyFn', + 'ClientOnlyJSX', // Only transform on server to remove children + ] as const), +} + +export function getLookupKindsForEnv( + env: 'client' | 'server', + opts?: { + compilerTransforms?: Array | undefined + }, +): Set { + const kinds: Set = new Set(LookupKindsPerEnv[env]) + for (const transform of opts?.compilerTransforms ?? []) { + if (isCompilerTransformEnabledForEnv(transform, env)) { + kinds.add(getExternalLookupKind(transform)) + } + } + return kinds +} + +/** + * Handler type for processing candidates of a specific kind. + * The kind is passed as the third argument to allow shared handlers (like handleEnvOnlyFn). + */ +type KindHandler = ( + candidates: Array, + context: CompilationContext, + kind: BuiltInLookupKind, +) => void + +/** + * Registry mapping each LookupKind to its handler function. + * When adding a new kind, add its handler here. + */ +const BuiltInKindHandlers: Record< + Exclude, + KindHandler +> = { + ServerFn: handleCreateServerFn, + Middleware: handleCreateMiddleware, + IsomorphicFn: handleCreateIsomorphicFn, + ServerOnlyFn: handleEnvOnlyFn, + ClientOnlyFn: handleEnvOnlyFn, + // ClientOnlyJSX is handled separately via JSX traversal, not here +} + +const BuiltInKindHandlerOrder: Array< + Exclude +> = ['ServerFn', 'Middleware', 'IsomorphicFn', 'ServerOnlyFn', 'ClientOnlyFn'] + +// All lookup kinds as an array for iteration with proper typing +const AllBuiltInLookupKinds = Object.keys( + BuiltInLookupSetup, +) as Array + +/** + * Detects which LookupKinds are present in the code using string matching. + * This is a fast pre-scan before AST parsing to limit the work done during compilation. + */ +export function detectKindsInCode( + code: string, + env: 'client' | 'server', + opts?: { + compilerTransforms?: Array | undefined + }, +): Set { + const detected = new Set() + const validForEnv = getLookupKindsForEnv(env, opts) + + for (const kind of AllBuiltInLookupKinds) { + const pattern = KindDetectionPatterns[kind] + pattern.lastIndex = 0 + if (validForEnv.has(kind) && pattern.test(code)) { + detected.add(kind) + } + } + + for (const transform of opts?.compilerTransforms ?? []) { + if (!isCompilerTransformEnabledForEnv(transform, env)) continue + transform.detect.lastIndex = 0 + if (transform.detect.test(code)) { + detected.add(getExternalLookupKind(transform)) + } + } + + return detected +} + +// Pre-computed map: identifier name -> Set for fast candidate detection (method chain only) +// Multiple kinds can share the same identifier (e.g., 'server' and 'client' are used by both Middleware and IsomorphicFn) +const IdentifierToKinds = new Map>() +for (const kind of AllBuiltInLookupKinds) { + const setup = BuiltInLookupSetup[kind] + if (setup.type === 'methodChain') { + for (const id of setup.candidateCallIdentifier) { + let kinds = IdentifierToKinds.get(id) + if (!kinds) { + kinds = new Set() + IdentifierToKinds.set(id, kinds) + } + kinds.add(kind) + } + } +} + +function getLookupSetup( + kind: LookupKind, + externalLookupSetup?: Map, +): MethodChainSetup | DirectCallSetup | JSXSetup | undefined { + if (kind in BuiltInLookupSetup) { + return BuiltInLookupSetup[kind as BuiltInLookupKind] + } + + if (isExternalLookupKind(kind)) { + return externalLookupSetup?.get(kind) + } + + return undefined +} + +export type LookupConfig = { + libName: string + rootExport: string + kind: LookupKind | 'Root' // 'Root' for builder pattern, LookupKind for direct call +} + +interface ExportResolution { + moduleInfo: ModuleInfo + localName: string + binding: Binding +} + +interface ModuleInfo { + id: string + bindings: Map + // Maps exported name → local binding name + exports: Map + // Track `export * from './module'` declarations for re-export resolution + reExportAllSources: Array +} + +/** + * Checks if all kinds in the set are guaranteed to be top-level only. + * Only ServerFn is always declared at module level (must be assigned to a variable). + * Middleware, IsomorphicFn, ServerOnlyFn, ClientOnlyFn can be nested inside functions. + * When all kinds are top-level-only, we can use a fast scan instead of full traversal. + */ +function areAllKindsTopLevelOnly(kinds: Set): boolean { + return kinds.size === 1 && kinds.has('ServerFn') +} + +/** + * Checks if we need to detect JSX elements (e.g., ). + */ +function needsJSXDetection( + kinds: Set, + externalLookupSetup?: Map, +): boolean { + for (const kind of kinds) { + if (getLookupSetup(kind, externalLookupSetup)?.type === 'jsx') { + return true + } + } + return false +} + +/** + * Checks if a CallExpression is a direct-call candidate for NESTED detection. + * Returns true if the callee is a known factory function name. + * This is stricter than top-level detection because we need to filter out + * invocations of existing server functions (e.g., `myServerFn()`). + */ +function isNestedDirectCallCandidate( + node: t.CallExpression, + lookupKinds: Set, + externalLookupSetup?: Map, +): boolean { + let calleeName: string | undefined + if (t.isIdentifier(node.callee)) { + calleeName = node.callee.name + } else if ( + t.isMemberExpression(node.callee) && + t.isIdentifier(node.callee.property) + ) { + calleeName = node.callee.property.name + } + if (!calleeName) return false + for (const kind of lookupKinds) { + if (isExternalLookupKind(kind)) continue + const setup = getLookupSetup(kind, externalLookupSetup) + if (setup?.type === 'directCall' && setup.factoryNames.has(calleeName)) { + return true + } + } + return false +} + +function isSimpleDirectCallExpression(node: t.CallExpression): boolean { + return ( + t.isIdentifier(node.callee) || + (t.isMemberExpression(node.callee) && + t.isIdentifier(node.callee.object) && + t.isIdentifier(node.callee.property)) + ) +} + +function isTopLevelDirectCallCandidateNode(node: t.CallExpression): boolean { + return isSimpleDirectCallExpression(node) +} + +/** + * Checks if a CallExpression path is a top-level direct-call candidate. + * Top-level means the call is the init of a VariableDeclarator at program level. + * We accept any simple identifier call or namespace call at top level + * (e.g., `createServerOnlyFn()`, `TanStackStart.createServerOnlyFn()`) and let + * resolution verify it. This handles renamed imports. + */ +function isTopLevelDirectCallCandidate( + path: babel.NodePath, +): boolean { + const node = path.node + + // Must be a simple identifier call or namespace call + if (!isSimpleDirectCallExpression(node)) { + return false + } + + // Must be top-level: VariableDeclarator -> VariableDeclaration -> Program + const parent = path.parent + if (!t.isVariableDeclarator(parent) || parent.init !== node) { + return false + } + const grandParent = path.parentPath.parent + if (!t.isVariableDeclaration(grandParent)) { + return false + } + return t.isProgram(path.parentPath.parentPath?.parent) +} + +function isDirectCallCandidateForKind( + kind: Exclude, + externalLookupSetup?: Map, +): boolean { + return getLookupSetup(kind, externalLookupSetup)?.type === 'directCall' +} + +function hasBuiltInDirectCallKinds(kinds: Set): boolean { + for (const kind of kinds) { + if (isExternalLookupKind(kind)) continue + if (BuiltInLookupSetup[kind].type === 'directCall') return true + } + return false +} + +function hasExternalLookupKinds(kinds: Set): boolean { + for (const kind of kinds) { + if (isExternalLookupKind(kind)) return true + } + return false +} + +interface ExternalDirectCallCandidates { + identifiers: Map + namespaces: Map> +} + +interface CallExpressionCandidate { + path: babel.NodePath + /** Set when import scanning already proved the call's lookup kind. */ + kind?: Exclude +} + +function hasExternalDirectCallCandidates( + candidates: ExternalDirectCallCandidates, +): boolean { + return candidates.identifiers.size > 0 || candidates.namespaces.size > 0 +} + +function getExternalDirectCallCandidateKind( + path: babel.NodePath, + candidates: ExternalDirectCallCandidates, +): ExternalLookupKind | undefined { + const node = path.node + + if (t.isIdentifier(node.callee)) { + const kind = candidates.identifiers.get(node.callee.name) + if (!kind) return undefined + + const binding = path.scope.getBinding(node.callee.name) + return binding?.path.isImportSpecifier() ? kind : undefined + } + + if ( + t.isMemberExpression(node.callee) && + t.isIdentifier(node.callee.object) && + t.isIdentifier(node.callee.property) + ) { + const kind = candidates.namespaces + .get(node.callee.object.name) + ?.get(node.callee.property.name) + if (!kind) return undefined + + const binding = path.scope.getBinding(node.callee.object.name) + return binding?.path.isImportNamespaceSpecifier() ? kind : undefined + } + + return undefined +} + +export class StartCompiler { + private moduleCache = new Map() + private initialized = false + private validLookupKinds: Set + private externalTransformsByKind = new Map< + ExternalLookupKind, + StartCompilerImportTransform + >() + private externalLookupSetup = new Map() + private compilerPlugins: Array + private externalDirectCallKindsBySource = new Map< + string, + Map + >() + private resolveIdCache = new Map() + private exportResolutionCache = new Map< + string, + Map + >() + // Fast lookup for direct imports from known libraries (e.g., '@tanstack/react-start') + // Maps: libName → (exportName → Kind) + // This allows O(1) resolution for the common case without async resolveId calls + private knownRootImports = new Map>() + + // For generating unique function IDs in production builds + private entryIdToFunctionId = new Map() + private functionIds = new Set() + + constructor( + private options: { + env: 'client' | 'server' + envName: string + root: string + lookupConfigurations: Array + lookupKinds: Set + loadModule: (id: string) => Promise + resolveId: (id: string, importer?: string) => Promise + /** + * In 'build' mode, resolution results are cached for performance. + * In 'dev' mode (default), caching is disabled to avoid invalidation complexity with HMR. + */ + mode?: 'dev' | 'build' + /** + * The framework being used (e.g., 'react', 'solid'). + */ + framework: CompileStartFrameworkOptions + /** + * The Vite environment name for the server function provider. + */ + providerEnvName: string + /** + * Custom function ID generator (optional, defaults to hash-based). + */ + generateFunctionId?: (opts: { + filename: string + functionName: string + }) => string | undefined + /** + * Callback when server functions are discovered. + * Called after each file is compiled with its new functions. + */ + onServerFnsById?: (d: Record) => void + compilerTransforms?: Array | undefined + compilerPlugins?: Array | undefined + serverFnProviderModuleDirectives?: ReadonlyArray | undefined + /** + * Returns the currently known server functions from previous builds. + * Used by server callers to look up canonical extracted filenames. + */ + getKnownServerFns: () => Record + devServerFnModuleSpecifierEncoder?: DevServerFnModuleSpecifierEncoder + }, + ) { + this.validLookupKinds = options.lookupKinds + this.compilerPlugins = (options.compilerPlugins ?? []).filter((plugin) => + isStartCompilerPluginEnabledForEnv(plugin, options.env), + ) + + for (const transform of options.compilerTransforms ?? []) { + const kind = getExternalLookupKind(transform) + if (!this.validLookupKinds.has(kind)) continue + + this.externalTransformsByKind.set(kind, transform) + + const factoryNames = new Set() + for (const entry of transform.imports) { + factoryNames.add(entry.rootExport) + + let rootExports = this.externalDirectCallKindsBySource.get( + entry.libName, + ) + if (!rootExports) { + rootExports = new Map() + this.externalDirectCallKindsBySource.set(entry.libName, rootExports) + } + rootExports.set(entry.rootExport, kind) + } + + this.externalLookupSetup.set(kind, { + type: 'directCall', + factoryNames, + }) + } + } + + /** + * Generates a unique function ID for a server function. + * In dev mode, uses a base64-encoded JSON with file path and export name. + * In build mode, uses SHA256 hash or custom generator. + */ + private generateFunctionId(opts: { + filename: string + functionName: string + extractedFilename: string + }): string { + if (this.mode === 'dev') { + // In dev, encode the file path and export name for direct lookup. + // Each bundler adapter supplies its own strategy for encoding + // module specifiers that work with its dev server runtime. + const encodeModuleSpecifier = + this.options.devServerFnModuleSpecifierEncoder + if (!encodeModuleSpecifier) { + throw new Error( + 'devServerFnModuleSpecifierEncoder is required in dev mode.', + ) + } + const file = encodeModuleSpecifier({ + extractedFilename: opts.extractedFilename, + root: this.options.root, + }) + + const serverFn = { + file, + export: opts.functionName, + } + return Buffer.from(JSON.stringify(serverFn), 'utf8').toString('base64url') + } + + // Production build: use custom generator or hash + const entryId = `${opts.filename}--${opts.functionName}` + let functionId = this.entryIdToFunctionId.get(entryId) + if (functionId === undefined) { + const knownFn = Object.values(this.options.getKnownServerFns()).find( + (serverFn) => + serverFn.functionName === opts.functionName && + serverFn.extractedFilename === opts.extractedFilename, + ) + + if (knownFn) { + functionId = knownFn.functionId + } + + if (this.options.generateFunctionId) { + functionId ??= this.options.generateFunctionId({ + filename: opts.filename, + functionName: opts.functionName, + }) + } + if (!functionId) { + functionId = crypto.createHash('sha256').update(entryId).digest('hex') + } + // Deduplicate in case the generated id conflicts with an existing id + if (this.functionIds.has(functionId)) { + let deduplicatedId + let iteration = 0 + do { + deduplicatedId = `${functionId}_${++iteration}` + } while (this.functionIds.has(deduplicatedId)) + functionId = deduplicatedId + } + this.entryIdToFunctionId.set(entryId, functionId) + this.functionIds.add(functionId) + } + return functionId + } + + private get mode(): 'dev' | 'build' { + return this.options.mode ?? 'dev' + } + + private getExternalDirectCallCandidates( + kinds: Set, + moduleInfo: ModuleInfo, + ): ExternalDirectCallCandidates { + const identifiers = new Map() + const namespaces = new Map>() + + if (this.externalDirectCallKindsBySource.size === 0) { + return { identifiers, namespaces } + } + + for (const [localName, binding] of moduleInfo.bindings) { + if (binding.type !== 'import') continue + + const rootExports = this.externalDirectCallKindsBySource.get( + binding.source, + ) + if (!rootExports) continue + + if (binding.importedName === '*') { + const namespaceExports = new Map() + for (const [rootExport, kind] of rootExports) { + if (kinds.has(kind)) { + namespaceExports.set(rootExport, kind) + } + } + if (namespaceExports.size > 0) { + namespaces.set(localName, namespaceExports) + } + } else { + const kind = rootExports.get(binding.importedName) + if (kind && kinds.has(kind)) { + identifiers.set(localName, kind) + } + } + } + + return { identifiers, namespaces } + } + + private async resolveIdCached(id: string, importer?: string) { + if (this.mode === 'dev') { + return this.options.resolveId(id, importer) + } + + const cacheKey = importer ? `${importer}::${id}` : id + const cached = this.resolveIdCache.get(cacheKey) + if (cached !== undefined) { + return cached + } + const resolved = await this.options.resolveId(id, importer) + this.resolveIdCache.set(cacheKey, resolved) + return resolved + } + + private getExportResolutionCache(moduleId: string) { + let cache = this.exportResolutionCache.get(moduleId) + if (!cache) { + cache = new Map() + this.exportResolutionCache.set(moduleId, cache) + } + return cache + } + + private init() { + // Register internal stub package exports for recognition. + // These don't need module resolution - only the knownRootImports fast path. + this.knownRootImports.set( + '@tanstack/start-fn-stubs', + new Map([ + ['createIsomorphicFn', 'IsomorphicFn'], + ['createServerOnlyFn', 'ServerOnlyFn'], + ['createClientOnlyFn', 'ClientOnlyFn'], + ]), + ) + + // Register start-client-core exports for internal package usage. + // These don't need module resolution - only the knownRootImports fast path. + this.knownRootImports.set( + '@tanstack/start-client-core', + new Map([ + ['createServerFn', 'Root'], + ['createIsomorphicFn', 'IsomorphicFn'], + ['createServerOnlyFn', 'ServerOnlyFn'], + ['createClientOnlyFn', 'ClientOnlyFn'], + ['createMiddleware', 'Middleware'], + ['createStart', 'Root'], + ]), + ) + + for (const config of this.options.lookupConfigurations) { + // Populate the fast lookup map for direct imports (by package name) + // This allows O(1) recognition of imports from known packages. + let libExports = this.knownRootImports.get(config.libName) + if (!libExports) { + libExports = new Map() + this.knownRootImports.set(config.libName, libExports) + } + libExports.set(config.rootExport, config.kind) + + // For JSX lookups (e.g., ClientOnlyJSX), we only need the knownRootImports + // fast path to verify imports. Skip synthetic root module setup. + if (config.kind !== 'Root') { + const setup = getLookupSetup(config.kind, this.externalLookupSetup) + if (setup?.type === 'jsx') { + continue + } + } + + // Root lookup metadata is synthetic package-level state, not a real + // resolved module. Keep the ID stable across bundlers and export-map + // behavior by always keying it to the package specifier itself. + const libId = config.libName + + let rootModule = this.moduleCache.get(libId) + if (!rootModule) { + // insert root binding + rootModule = { + bindings: new Map(), + exports: new Map(), + id: libId, + reExportAllSources: [], + } + this.moduleCache.set(libId, rootModule) + } + + rootModule.exports.set(config.rootExport, config.rootExport) + rootModule.exports.set('*', config.rootExport) + rootModule.bindings.set(config.rootExport, { + type: 'var', + init: null, // Not needed since resolvedKind is set + resolvedKind: config.kind satisfies Kind, + }) + this.moduleCache.set(libId, rootModule) + } + + this.initialized = true + } + + /** + * Extracts bindings and exports from an already-parsed AST. + */ + private extractModuleInfo( + ast: ReturnType, + id: string, + ): ModuleInfo { + const extracted = extractModuleInfoFromAst(ast) + + const info: ModuleInfo = { + id, + bindings: new Map(extracted.bindings), + exports: extracted.exports, + reExportAllSources: extracted.reExportAllSources, + } + this.moduleCache.set(id, info) + return info + } + + public ingestModule({ + code, + id, + parserFilename, + }: { + code: string + id: string + parserFilename?: string + }) { + const ast = parseAst({ code, filename: parserFilename ?? cleanId(id) }) + const info = this.extractModuleInfo(ast, id) + return { info, ast } + } + + public invalidateModule(id: string) { + return this.invalidateModules([id]).size > 0 + } + + public invalidateModules(ids: Iterable): Set { + const normalizedIds = new Set() + + for (const id of ids) { + normalizedIds.add(cleanId(id)) + + for (const plugin of this.compilerPlugins) { + plugin.invalidateModule?.({ id, envName: this.options.envName }) + } + } + + const deletedModuleIds = new Set() + if (normalizedIds.size === 0) { + return deletedModuleIds + } + + for (const moduleId of Array.from(this.moduleCache.keys())) { + const normalizedModuleId = cleanId(moduleId) + if (normalizedIds.has(normalizedModuleId)) { + this.moduleCache.delete(moduleId) + deletedModuleIds.add(normalizedModuleId) + } + } + + // Root import metadata is synthetic compiler state and should survive HMR. + // The stale dev state lives in per-module resolvedKind memoization. + for (const [moduleId, moduleInfo] of this.moduleCache) { + if (this.knownRootImports.has(moduleId)) { + continue + } + + for (const binding of moduleInfo.bindings.values()) { + binding.resolvedKind = undefined + } + } + + // Build-mode caches are cheap to rebuild and may point at removed entries. + this.resolveIdCache.clear() + this.exportResolutionCache.clear() + + return deletedModuleIds + } + + public async getTransitiveImporters( + ids: string | Iterable, + ): Promise> { + const discoveredImporters = new Set() + const pendingTargets = + typeof ids === 'string' + ? [cleanId(ids)] + : Array.from(ids, (id) => cleanId(id)) + const visitedTargets = new Set() + const resolveCache = new Map>() + const importersByTarget = new Map>() + + const resolveSource = (source: string, importer: string) => { + const cacheKey = `${importer}::${source}` + let resolved = resolveCache.get(cacheKey) + + if (!resolved) { + resolved = this.resolveIdCached(source, importer) + resolveCache.set(cacheKey, resolved) + } + + return resolved + } + + await Promise.all( + Array.from(this.moduleCache.values()).map(async (moduleInfo) => { + if (this.knownRootImports.has(moduleInfo.id)) { + return + } + + const moduleId = cleanId(moduleInfo.id) + const importSources = new Set(moduleInfo.reExportAllSources) + + for (const binding of moduleInfo.bindings.values()) { + if (binding.type === 'import') { + importSources.add(binding.source) + } + } + + await Promise.all( + Array.from(importSources, async (source) => { + const resolved = await resolveSource(source, moduleInfo.id) + if (!resolved) return + + const targetId = cleanId(resolved) + if (targetId === moduleId) return + + let importers = importersByTarget.get(targetId) + if (!importers) { + importers = new Set() + importersByTarget.set(targetId, importers) + } + importers.add(moduleId) + }), + ) + }), + ) + + while (pendingTargets.length > 0) { + const targetId = pendingTargets.pop()! + + if (visitedTargets.has(targetId)) { + continue + } + + visitedTargets.add(targetId) + + for (const importerId of importersByTarget.get(targetId) ?? []) { + if (discoveredImporters.has(importerId)) { + continue + } + + discoveredImporters.add(importerId) + pendingTargets.push(importerId) + } + } + + return discoveredImporters + } + + public async compile({ + code, + id, + parserFilename, + detectedKinds, + }: { + code: string + id: string + parserFilename?: string + /** Pre-detected kinds present in this file. If not provided, all valid kinds are checked. */ + detectedKinds?: Set + }) { + if (!this.initialized) { + await this.init() + } + + // Use detected kinds if provided, otherwise fall back to all valid kinds for this env + const fileKinds = detectedKinds + ? new Set([...detectedKinds].filter((k) => this.validLookupKinds.has(k))) + : this.validLookupKinds + + const astTransformPlugins = this.getAstTransformPluginsForCode(code) + // Always parse and extract module info upfront. + // This ensures the module is cached for import resolution even if no candidates are found. + const ast = this.ingestModule({ code, id, parserFilename }).ast + let astHasChanges = false + + builtInTransforms: { + // Early exit if no built-in or import transforms need this file. + if (fileKinds.size === 0) { + break builtInTransforms + } + + const hasExternalKinds = hasExternalLookupKinds(fileKinds) + const checkDirectCalls = + hasBuiltInDirectCallKinds(fileKinds) || + (fileKinds.has('ServerFn') && + !hasExternalKinds && + hasBuiltInDirectCallKinds(this.validLookupKinds)) + // Optimization: ServerFn is always a top-level declaration (must be assigned to a variable). + // If the file only has ServerFn, we can skip full AST traversal and only visit + // the specific top-level declarations that have candidates. + const canUseFastPath = areAllKindsTopLevelOnly(fileKinds) + + // Single-pass traversal to: + // 1. Collect candidate paths (only candidates, not all CallExpressions) + // 2. Build a map for looking up paths of nested calls in method chains + const candidatePaths: Array = [] + // Map for nested chain lookup - only populated for CallExpressions that are + // part of a method chain (callee.object is a CallExpression) + const chainCallPaths = new Map< + t.CallExpression, + babel.NodePath + >() + + // JSX candidates (e.g., ) + const jsxCandidatePaths: Array> = [] + const checkJSX = needsJSXDetection(fileKinds, this.externalLookupSetup) + // Get module info that was just cached by ingestModule + const moduleInfo = this.moduleCache.get(id)! + const externalDirectCallCandidates = this.getExternalDirectCallCandidates( + fileKinds, + moduleInfo, + ) + const checkExternalDirectCalls = hasExternalDirectCallCandidates( + externalDirectCallCandidates, + ) + + if (canUseFastPath) { + // Fast path: only visit top-level statements that have potential candidates + + // Collect indices of top-level statements that contain candidates + const candidateIndices: Array = [] + for (let i = 0; i < ast.program.body.length; i++) { + const node = ast.program.body[i]! + let declarations: Array | undefined + + if (t.isVariableDeclaration(node)) { + declarations = node.declarations + } else if (t.isExportNamedDeclaration(node) && node.declaration) { + if (t.isVariableDeclaration(node.declaration)) { + declarations = node.declaration.declarations + } + } + + if (declarations) { + for (const decl of declarations) { + if (decl.init && t.isCallExpression(decl.init)) { + if ( + isMethodChainCandidate(decl.init, fileKinds) || + (checkDirectCalls && + isTopLevelDirectCallCandidateNode(decl.init)) + ) { + candidateIndices.push(i) + break // Only need to mark this statement once + } + } + } + } + } + + // Early exit: no potential candidates found at top level + if (candidateIndices.length === 0) { + break builtInTransforms + } + + // Targeted traversal: only visit the specific statements that have candidates + // This is much faster than traversing the entire AST + babel.traverse(ast, { + Program(programPath) { + const bodyPaths = programPath.get('body') + for (const idx of candidateIndices) { + const stmtPath = bodyPaths[idx] + if (!stmtPath) continue + + // Traverse only this statement's subtree + stmtPath.traverse({ + CallExpression(path) { + const node = path.node + const parent = path.parent + + // Check if this call is part of a larger chain (inner call) + if ( + t.isMemberExpression(parent) && + t.isCallExpression(path.parentPath.parent) + ) { + chainCallPaths.set(node, path) + return + } + + // Method chain pattern + if (isMethodChainCandidate(node, fileKinds)) { + candidatePaths.push({ path }) + return + } + + if (checkExternalDirectCalls) { + const kind = getExternalDirectCallCandidateKind( + path, + externalDirectCallCandidates, + ) + if (kind) { + candidatePaths.push({ path, kind }) + return + } + } + + if (isTopLevelDirectCallCandidate(path)) { + candidatePaths.push({ path }) + } + }, + }) + } + // Stop traversal after processing Program + programPath.stop() + }, + }) + } else { + // Normal path: full traversal for non-fast-path kinds + babel.traverse(ast, { + CallExpression: (path) => { + const node = path.node + const parent = path.parent + + // Check if this call is part of a larger chain (inner call) + // If so, store it for method chain lookup but don't treat as candidate + if ( + t.isMemberExpression(parent) && + t.isCallExpression(path.parentPath.parent) + ) { + // This is an inner call in a chain - store for later lookup + chainCallPaths.set(node, path) + return + } + + // Pattern 1: Method chain pattern (.handler(), .server(), .client(), etc.) + if (isMethodChainCandidate(node, fileKinds)) { + candidatePaths.push({ path }) + return + } + + // External direct-call transforms are import-bound. Direct imports + // already identify the transform kind, so skip async import tracing. + if (checkExternalDirectCalls) { + const kind = getExternalDirectCallCandidateKind( + path, + externalDirectCallCandidates, + ) + if (kind) { + candidatePaths.push({ path, kind }) + return + } + } + + if (checkDirectCalls && isTopLevelDirectCallCandidate(path)) { + candidatePaths.push({ path }) + return + } + + // Pattern 2: Direct call pattern + if (checkDirectCalls) { + if ( + isNestedDirectCallCandidate( + node, + fileKinds, + this.externalLookupSetup, + ) + ) { + candidatePaths.push({ path }) + return + } + } + }, + // Pattern 3: JSX element pattern (e.g., ) + // Collect JSX elements where the component is imported from a known package + // and resolves to a JSX kind (e.g., ClientOnly from @tanstack/react-router) + JSXElement: (path) => { + if (!checkJSX) return + + const openingElement = path.node.openingElement + const nameNode = openingElement.name + + // Only handle simple identifier names (not namespaced or member expressions) + if (!t.isJSXIdentifier(nameNode)) return + + const componentName = nameNode.name + const binding = moduleInfo.bindings.get(componentName) + + // Must be an import binding from a known package + if (!binding || binding.type !== 'import') return + + // Verify the import source is a known TanStack router package + const knownExports = this.knownRootImports.get(binding.source) + if (!knownExports) return + + // Verify the imported name resolves to a JSX kind (e.g., ClientOnlyJSX) + const kind = knownExports.get(binding.importedName) + if (kind !== 'ClientOnlyJSX') return + + jsxCandidatePaths.push(path) + }, + }) + } + + if (candidatePaths.length === 0 && jsxCandidatePaths.length === 0) { + break builtInTransforms + } + + // Resolve only candidates whose import scan did not already prove the kind. + const resolvedCandidates: Array<{ + path: babel.NodePath + kind: Kind + }> = [] + const unresolvedCandidates: Array = [] + + for (const candidate of candidatePaths) { + if (candidate.kind) { + resolvedCandidates.push({ + path: candidate.path, + kind: candidate.kind, + }) + } else { + unresolvedCandidates.push(candidate) + } + } + + if (unresolvedCandidates.length > 0) { + resolvedCandidates.push( + ...(await Promise.all( + unresolvedCandidates.map(async (candidate) => ({ + path: candidate.path, + kind: await this.resolveExprKind(candidate.path.node, id), + })), + )), + ) + } + + // Filter to valid candidates + const validCandidates = resolvedCandidates.filter(({ path, kind }) => { + if ( + !this.validLookupKinds.has( + kind as Exclude, + ) + ) { + return false + } + + if ( + isLookupKind(kind) && + kind !== 'ClientOnlyJSX' && + !isMethodChainCandidate(path.node, fileKinds) + ) { + return isDirectCallCandidateForKind(kind, this.externalLookupSetup) + } + + return true + }) as Array<{ + path: babel.NodePath + kind: Exclude + }> + + if (validCandidates.length === 0 && jsxCandidatePaths.length === 0) { + break builtInTransforms + } + + // Process valid candidates to collect method chains + const pathsToRewrite: Array<{ + path: babel.NodePath + kind: Exclude + methodChain: MethodChainPaths + }> = [] + + for (const { path, kind } of validCandidates) { + const node = path.node + + // Collect method chain paths by walking DOWN from root through the chain + const methodChain: MethodChainPaths = { + middleware: null, + inputValidator: null, + handler: null, + server: null, + client: null, + } + + // Walk down the call chain using nodes, look up paths from map + let currentNode: t.CallExpression = node + let currentPath: babel.NodePath = path + + // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition + while (true) { + const callee = currentNode.callee + if (!t.isMemberExpression(callee)) { + break + } + + // Record method chain path if it's a known method + if (t.isIdentifier(callee.property)) { + const name = callee.property.name as keyof MethodChainPaths + if (name in methodChain) { + // Get first argument path + const args = currentPath.get('arguments') + const firstArgPath = + Array.isArray(args) && args.length > 0 + ? (args[0] ?? null) + : null + methodChain[name] = { + callPath: currentPath, + firstArgPath, + } + } + } + + // Move to the inner call (the object of the member expression) + if (!t.isCallExpression(callee.object)) { + break + } + currentNode = callee.object + // Look up path from chain map, or use candidate path if not found + const nextPath = chainCallPaths.get(currentNode) + if (!nextPath) { + break + } + currentPath = nextPath + } + + pathsToRewrite.push({ path, kind, methodChain }) + } + + const refIdents = findReferencedIdentifiers(ast) + + const context: CompilationContext = { + ast, + id, + code, + env: this.options.env, + envName: this.options.envName, + mode: this.mode, + root: this.options.root, + framework: this.options.framework, + providerEnvName: this.options.providerEnvName, + types: t, + parseExpression: (expressionCode) => + babel.template.expression(expressionCode, { + placeholderPattern: false, + })() as t.Expression, + + generateFunctionId: (opts) => this.generateFunctionId(opts), + getKnownServerFns: this.options.getKnownServerFns, + serverFnProviderModuleDirectives: + this.options.serverFnProviderModuleDirectives, + onServerFnsById: this.options.onServerFnsById, + } + + // Group candidates by kind for batch processing + const candidatesByKind = new Map< + Exclude, + Array + >() + + for (const { path: candidatePath, kind, methodChain } of pathsToRewrite) { + const candidate: RewriteCandidate = { path: candidatePath, methodChain } + const existing = candidatesByKind.get(kind) + if (existing) { + existing.push(candidate) + } else { + candidatesByKind.set(kind, [candidate]) + } + } + + // External transforms run before built-ins by default so they can augment + // user handlers before server function extraction clones provider bodies. + this.runExternalTransforms('pre', candidatesByKind, context) + + for (const kind of BuiltInKindHandlerOrder) { + const candidates = candidatesByKind.get(kind) + if (!candidates) continue + const handler = BuiltInKindHandlers[kind] + handler(candidates, context, kind) + } + + this.runExternalTransforms('post', candidatesByKind, context) + + // Handle JSX candidates (e.g., ) + // Validation was already done during traversal - just call the handler + for (const jsxPath of jsxCandidatePaths) { + handleClientOnlyJSX(jsxPath, { env: 'server' }) + } + + deadCodeElimination(ast, refIdents) + astHasChanges = true + } + + if (astTransformPlugins.length > 0) { + astHasChanges = + this.runAstTransforms({ + ast, + code, + id, + transforms: astTransformPlugins, + }) || astHasChanges + } + + return astHasChanges ? this.generateResultFromAst(ast, code, id) : null + } + + private generateResultFromAst( + ast: ParsedAst, + sourceCode: string, + id: string, + ): StartCompilerTransformResult { + const result = generateFromAst(ast, { + sourceMaps: true, + sourceFileName: id, + filename: id, + }) + + // @babel/generator does not populate sourcesContent because it only has + // the AST, not the original text. Without this, Vite's composed sourcemap + // omits the original source, causing downstream consumers to fall back to + // the compiled output and fail to resolve original line numbers. + if (result.map) { + result.map.sourcesContent = [sourceCode] + } + + return result + } + + private getAstTransformPluginsForCode( + code: string, + ): Array { + return this.compilerPlugins.filter( + (plugin): plugin is StartCompilerAstPlugin => { + if (!plugin.transformAst) return false + if (!plugin.detect) return true + plugin.detect.lastIndex = 0 + return plugin.detect.test(code) + }, + ) + } + + private runAstTransforms({ + ast, + code, + id, + transforms, + }: { + ast: ParsedAst + code: string + id: string + transforms: Array + }): boolean { + let modified = false + + for (const plugin of transforms) { + const context = { + ast, + code, + id, + env: this.options.env, + envName: this.options.envName, + mode: this.mode, + root: this.options.root, + framework: this.options.framework, + providerEnvName: this.options.providerEnvName, + types: t, + parseExpression: (expressionCode: string) => + babel.template.expression(expressionCode, { + placeholderPattern: false, + })() as t.Expression, + } + + modified = plugin.transformAst(context) || modified + } + + return modified + } + + private runExternalTransforms( + order: 'pre' | 'post', + candidatesByKind: Map< + Exclude, + Array + >, + context: CompilationContext, + ) { + for (const [kind, transform] of this.externalTransformsByKind) { + if ((transform.order ?? 'pre') !== order) continue + + const candidates = candidatesByKind.get(kind) + if (!candidates) continue + + transform.transform(candidates, context) + } + } + + private async resolveIdentifierKind( + ident: string, + id: string, + visited = new Set(), + ): Promise { + const info = await this.getModuleInfo(id) + + const binding = info.bindings.get(ident) + if (!binding) { + return 'None' + } + if (binding.resolvedKind) { + return binding.resolvedKind + } + + // TODO improve cycle detection? should we throw here instead of returning 'None'? + // prevent cycles + const vKey = `${cleanId(id)}:${ident}` + if (visited.has(vKey)) { + return 'None' + } + visited.add(vKey) + + const resolvedKind = await this.resolveBindingKind(binding, id, visited) + binding.resolvedKind = resolvedKind + return resolvedKind + } + + /** + * Recursively find an export in a module, following `export * from` chains. + * Returns the module info and binding if found, or undefined if not found. + */ + private async findExportInModule( + moduleInfo: ModuleInfo, + exportName: string, + visitedModules = new Set(), + ): Promise { + const isBuildMode = this.mode === 'build' + + // Check cache first (only for top-level calls in build mode) + if (isBuildMode && visitedModules.size === 0) { + const moduleCache = this.exportResolutionCache.get(moduleInfo.id) + if (moduleCache) { + const cached = moduleCache.get(exportName) + if (cached !== undefined) { + return cached ?? undefined + } + } + } + + // Prevent infinite loops in circular re-exports + if (visitedModules.has(moduleInfo.id)) { + return undefined + } + visitedModules.add(moduleInfo.id) + + // First check direct exports + const localBindingName = moduleInfo.exports.get(exportName) + if (localBindingName) { + const binding = moduleInfo.bindings.get(localBindingName) + if (binding) { + const result = { moduleInfo, localName: localBindingName, binding } + // Cache the result (build mode only) + if (isBuildMode) { + this.getExportResolutionCache(moduleInfo.id).set(exportName, result) + } + return result + } + } + + // If not found, recursively check re-export-all sources in parallel + // Valid code won't have duplicate exports across chains, so first match wins + if (moduleInfo.reExportAllSources.length > 0) { + const results = await Promise.all( + moduleInfo.reExportAllSources.map(async (reExportSource) => { + const reExportTarget = await this.resolveIdCached( + reExportSource, + moduleInfo.id, + ) + + if (reExportTarget) { + const reExportModule = await this.getModuleInfo(reExportTarget) + return this.findExportInModule( + reExportModule, + exportName, + visitedModules, + ) + } + return undefined + }), + ) + // Return the first valid result + for (const result of results) { + if (result) { + // Cache the result (build mode only) + if (isBuildMode) { + this.getExportResolutionCache(moduleInfo.id).set(exportName, result) + } + return result + } + } + } + + // Cache negative result (build mode only) + if (isBuildMode) { + this.getExportResolutionCache(moduleInfo.id).set(exportName, null) + } + return undefined + } + + private async resolveBindingTarget( + resolution: ExportResolution, + visited = new Set(), + ): Promise { + const key = `${cleanId(resolution.moduleInfo.id)}:${resolution.localName}` + if (visited.has(key)) { + return undefined + } + visited.add(key) + + if (resolution.binding.type !== 'import') { + return resolution + } + + const target = await this.resolveIdCached( + resolution.binding.source, + resolution.moduleInfo.id, + ) + if (!target) { + return undefined + } + + const importedModule = await this.getModuleInfo(target) + const found = await this.findExportInModule( + importedModule, + resolution.binding.importedName, + ) + if (!found) { + return undefined + } + + return this.resolveBindingTarget(found, visited) + } + + private async resolveKnownImportKind( + binding: ImportBinding, + resolved?: ExportResolution, + ): Promise { + const directKind = + this.knownRootImports.get(binding.source)?.get(binding.importedName) ?? + 'None' + if (directKind !== 'None') { + return directKind + } + + if (!resolved) { + return 'None' + } + + for (const [source, rootExports] of this.knownRootImports) { + const kind = rootExports.get(binding.importedName) + if (!kind) { + continue + } + + let targetId: string | null + try { + targetId = await this.resolveIdCached(source, resolved.moduleInfo.id) + } catch { + continue + } + + if (!targetId) { + continue + } + + try { + const rootModule = await this.getModuleInfo(targetId) + const found = await this.findExportInModule( + rootModule, + binding.importedName, + ) + const target = found + ? ((await this.resolveBindingTarget(found)) ?? found) + : undefined + + // Match by resolved binding identity, not by export name alone. + if ( + target && + cleanId(resolved.moduleInfo.id) === cleanId(target.moduleInfo.id) && + resolved.localName === target.localName + ) { + return kind + } + } catch { + continue + } + } + + return 'None' + } + + private async resolveImportKind( + binding: ImportBinding, + fileId: string, + visited: Set, + ): Promise { + const directKnownKind = await this.resolveKnownImportKind(binding) + if (directKnownKind !== 'None') { + binding.resolvedKind = directKnownKind + return directKnownKind + } + + if (binding.importedName === '*') { + return 'None' + } + + const target = await this.resolveIdCached(binding.source, fileId) + if (!target) { + return 'None' + } + + const importedModule = await this.getModuleInfo(target) + const found = await this.findExportInModule( + importedModule, + binding.importedName, + ) + if (!found) { + return 'None' + } + + const knownKind = await this.resolveKnownImportKind(binding, found) + if (knownKind !== 'None') { + found.binding.resolvedKind = knownKind + binding.resolvedKind = knownKind + return knownKind + } + + if (found.binding.resolvedKind) { + return found.binding.resolvedKind + } + + // Import aliases can form cycles, e.g. A re-exports from B while B + // re-exports from A. Track the exported binding before following it. + const vKey = `${cleanId(found.moduleInfo.id)}:${found.localName}` + if (visited.has(vKey)) { + return 'None' + } + visited.add(vKey) + + const resolvedKind = await this.resolveBindingKind( + found.binding, + found.moduleInfo.id, + visited, + ) + found.binding.resolvedKind = resolvedKind + return resolvedKind + } + + private async resolveBindingKind( + binding: Binding, + fileId: string, + visited = new Set(), + ): Promise { + if (binding.resolvedKind) { + return binding.resolvedKind + } + if (binding.type === 'import') { + return this.resolveImportKind(binding, fileId, visited) + } + + const resolvedKind = await this.resolveExprKind( + binding.init, + fileId, + visited, + ) + // When a var binding's init is a call to a directCall factory + // (e.g., `const myFn = createServerOnlyFn(() => ...)`), the binding holds + // the RESULT of the factory, not the factory itself. Clear the kind so + // `myFn()` isn't incorrectly matched as a directCall candidate. + // We only clear when the init is a CallExpression — an alias like + // `const createSO = createServerOnlyFn` should still propagate the kind. + if ( + isLookupKind(resolvedKind) && + getLookupSetup(resolvedKind, this.externalLookupSetup)?.type === + 'directCall' && + binding.init && + t.isCallExpression(binding.init) + ) { + binding.resolvedKind = 'None' + return 'None' + } + binding.resolvedKind = resolvedKind + return resolvedKind + } + + private async resolveExprKind( + expr: t.Expression | null, + fileId: string, + visited = new Set(), + ): Promise { + if (!expr) { + return 'None' + } + + // Unwrap common TypeScript/parenthesized wrappers first for efficiency + while ( + t.isTSAsExpression(expr) || + t.isTSNonNullExpression(expr) || + t.isParenthesizedExpression(expr) + ) { + expr = expr.expression + } + + let result: Kind = 'None' + + if (t.isCallExpression(expr)) { + if (!t.isExpression(expr.callee)) { + return 'None' + } + const calleeKind = await this.resolveCalleeKind( + expr.callee, + fileId, + visited, + ) + if (calleeKind === 'Root' || calleeKind === 'Builder') { + return 'Builder' + } + // For method chain patterns (callee is MemberExpression like .server() or .client()), + // return the resolved kind if valid + if (t.isMemberExpression(expr.callee)) { + if (this.validLookupKinds.has(calleeKind as LookupKind)) { + return calleeKind + } + } + // For direct calls (callee is Identifier like createServerOnlyFn()), + // trust calleeKind if it resolved to a valid LookupKind. This means + // resolveBindingKind successfully traced the import back to + // @tanstack/start-fn-stubs (via fast path or slow path through re-exports). + // This handles both direct imports from @tanstack/react-start and imports + // from intermediate packages that re-export from @tanstack/start-client-core. + if (t.isIdentifier(expr.callee)) { + if (this.validLookupKinds.has(calleeKind as LookupKind)) { + return calleeKind + } + } + } else if (t.isMemberExpression(expr) && t.isIdentifier(expr.property)) { + result = await this.resolveCalleeKind(expr.object, fileId, visited) + } + + if (result === 'None' && t.isIdentifier(expr)) { + result = await this.resolveIdentifierKind(expr.name, fileId, visited) + } + + return result + } + + private async resolveCalleeKind( + callee: t.Expression, + fileId: string, + visited = new Set(), + ): Promise { + if (t.isIdentifier(callee)) { + return this.resolveIdentifierKind(callee.name, fileId, visited) + } + + if (t.isMemberExpression(callee) && t.isIdentifier(callee.property)) { + const prop = callee.property.name + + // Check if this property matches any method chain pattern + const possibleKinds = IdentifierToKinds.get(prop) + if (possibleKinds) { + // Resolve base expression ONCE and reuse for all pattern checks + const base = await this.resolveExprKind(callee.object, fileId, visited) + + // Check each possible kind that uses this identifier + for (const kind of possibleKinds) { + if (!this.validLookupKinds.has(kind)) continue + + if (kind === 'ServerFn') { + if (base === 'Root' || base === 'Builder') { + return 'ServerFn' + } + } else if (kind === 'Middleware') { + if ( + base === 'Root' || + base === 'Builder' || + base === 'Middleware' + ) { + return 'Middleware' + } + } else if (kind === 'IsomorphicFn') { + if ( + base === 'Root' || + base === 'Builder' || + base === 'IsomorphicFn' + ) { + return 'IsomorphicFn' + } + } + } + } + + // Check if the object is a namespace import + if (t.isIdentifier(callee.object)) { + const info = await this.getModuleInfo(fileId) + const binding = info.bindings.get(callee.object.name) + if ( + binding && + binding.type === 'import' && + binding.importedName === '*' + ) { + return this.resolveImportKind( + { + type: 'import', + source: binding.source, + importedName: callee.property.name, + }, + fileId, + visited, + ) + } + } + return this.resolveExprKind(callee.object, fileId, visited) + } + + // handle nested expressions + return this.resolveExprKind(callee, fileId, visited) + } + + private async getModuleInfo(id: string) { + let cached = this.moduleCache.get(id) + if (cached) { + return cached + } + + await this.options.loadModule(id) + + cached = this.moduleCache.get(id) + if (!cached) { + throw new Error(`could not load module info for ${id}`) + } + return cached + } +} + +/** + * Checks if a CallExpression has a method chain pattern that matches any of the lookup kinds. + * E.g., `.handler()`, `.server()`, `.client()`, `.createMiddlewares()` + */ +function isMethodChainCandidate( + node: t.CallExpression, + lookupKinds: Set, +): boolean { + const callee = node.callee + if (!t.isMemberExpression(callee) || !t.isIdentifier(callee.property)) { + return false + } + + // Use pre-computed map for O(1) lookup + // IdentifierToKinds maps identifier -> Set to handle shared identifiers + const possibleKinds = IdentifierToKinds.get(callee.property.name) + if (possibleKinds) { + // Check if any of the possible kinds are in the valid lookup kinds + for (const kind of possibleKinds) { + if (lookupKinds.has(kind)) { + return true + } + } + } + + return false +} diff --git a/packages/start-plugin-core/src/start-compiler/config.ts b/packages/start-plugin-core/src/start-compiler/config.ts new file mode 100644 index 0000000000..387343bad9 --- /dev/null +++ b/packages/start-plugin-core/src/start-compiler/config.ts @@ -0,0 +1,119 @@ +import { + KindDetectionPatterns, + getExternalLookupKind, + getLookupKindsForEnv, + isCompilerTransformEnabledForEnv, + isStartCompilerPluginEnabledForEnv, +} from './compiler' +import type { BuiltInLookupKind, LookupConfig } from './compiler' +import type { + CompileStartFrameworkOptions, + StartCompilerImportTransform, + StartCompilerPlugin, +} from '../types' + +export function getTransformCodeFilterForEnv( + env: 'client' | 'server', + opts?: { + compilerTransforms?: Array | undefined + compilerPlugins?: Array | undefined + }, +): Array { + const validKinds = getLookupKindsForEnv(env, opts) + const patterns: Array = [] + + for (const [kind, pattern] of Object.entries(KindDetectionPatterns) as Array< + [BuiltInLookupKind, RegExp] + >) { + if (validKinds.has(kind)) { + patterns.push(pattern) + } + } + + for (const transform of opts?.compilerTransforms ?? []) { + if (isCompilerTransformEnabledForEnv(transform, env)) { + patterns.push(transform.detect) + } + } + + for (const plugin of opts?.compilerPlugins ?? []) { + if (plugin.detect && isStartCompilerPluginEnabledForEnv(plugin, env)) { + patterns.push(plugin.detect) + } + } + + return patterns +} + +export function getLookupConfigurationsForEnv( + env: 'client' | 'server', + framework: CompileStartFrameworkOptions, + opts?: { + compilerTransforms?: Array | undefined + }, +): Array { + const commonConfigs: Array = [ + { + libName: `@tanstack/${framework}-start`, + rootExport: 'createServerFn', + kind: 'Root', + }, + { + libName: `@tanstack/${framework}-start`, + rootExport: 'createIsomorphicFn', + kind: 'IsomorphicFn', + }, + { + libName: `@tanstack/${framework}-start`, + rootExport: 'createServerOnlyFn', + kind: 'ServerOnlyFn', + }, + { + libName: `@tanstack/${framework}-start`, + rootExport: 'createClientOnlyFn', + kind: 'ClientOnlyFn', + }, + ] + + const externalConfigs: Array = [] + for (const transform of opts?.compilerTransforms ?? []) { + if (!isCompilerTransformEnabledForEnv(transform, env)) continue + + const kind = getExternalLookupKind(transform) + for (const imported of transform.imports) { + externalConfigs.push({ + libName: imported.libName, + rootExport: imported.rootExport, + kind, + }) + } + } + + if (env === 'client') { + return [ + { + libName: `@tanstack/${framework}-start`, + rootExport: 'createMiddleware', + kind: 'Root', + }, + { + libName: `@tanstack/${framework}-start`, + rootExport: 'createStart', + kind: 'Root', + }, + ...commonConfigs, + ...externalConfigs, + ] + } + + const serverConfigs: Array = [ + ...commonConfigs, + { + libName: `@tanstack/${framework}-router`, + rootExport: 'ClientOnly', + kind: 'ClientOnlyJSX', + }, + ] + + return [...serverConfigs, ...externalConfigs] +} diff --git a/packages/start-plugin-core/src/start-compiler-plugin/handleClientOnlyJSX.ts b/packages/start-plugin-core/src/start-compiler/handleClientOnlyJSX.ts similarity index 100% rename from packages/start-plugin-core/src/start-compiler-plugin/handleClientOnlyJSX.ts rename to packages/start-plugin-core/src/start-compiler/handleClientOnlyJSX.ts diff --git a/packages/start-plugin-core/src/start-compiler-plugin/handleCreateIsomorphicFn.ts b/packages/start-plugin-core/src/start-compiler/handleCreateIsomorphicFn.ts similarity index 100% rename from packages/start-plugin-core/src/start-compiler-plugin/handleCreateIsomorphicFn.ts rename to packages/start-plugin-core/src/start-compiler/handleCreateIsomorphicFn.ts diff --git a/packages/start-plugin-core/src/start-compiler-plugin/handleCreateMiddleware.ts b/packages/start-plugin-core/src/start-compiler/handleCreateMiddleware.ts similarity index 100% rename from packages/start-plugin-core/src/start-compiler-plugin/handleCreateMiddleware.ts rename to packages/start-plugin-core/src/start-compiler/handleCreateMiddleware.ts diff --git a/packages/start-plugin-core/src/start-compiler-plugin/handleCreateServerFn.ts b/packages/start-plugin-core/src/start-compiler/handleCreateServerFn.ts similarity index 89% rename from packages/start-plugin-core/src/start-compiler-plugin/handleCreateServerFn.ts rename to packages/start-plugin-core/src/start-compiler/handleCreateServerFn.ts index ddad1cf061..ed2728a20d 100644 --- a/packages/start-plugin-core/src/start-compiler-plugin/handleCreateServerFn.ts +++ b/packages/start-plugin-core/src/start-compiler/handleCreateServerFn.ts @@ -1,13 +1,27 @@ import * as t from '@babel/types' import babel from '@babel/core' +import { hasKeys } from '@tanstack/router-core' import path from 'pathe' -import { VITE_ENVIRONMENT_NAMES } from '../constants' import { cleanId, codeFrameError, stripMethodCall } from './utils' import type { CompilationContext, RewriteCandidate, ServerFn } from './types' import type { CompileStartFrameworkOptions } from '../types' const TSS_SERVERFN_SPLIT_PARAM = 'tss-serverfn-split' +const providerHmrAcceptTemplate = babel.template.statements( + ` +if (import.meta.hot) { + import.meta.hot.accept(() => {}) +} +if (import.meta.webpackHot) { + import.meta.webpackHot.accept(() => {}) +} +`, + { + placeholderPattern: false, + }, +) + // ============================================================================ // Pre-compiled babel templates (compiled once at module load time) // ============================================================================ @@ -22,16 +36,11 @@ const clientRpcTemplate = babel.template.expression( `createClientRpc(%%functionId%%)`, ) -// Template for SSR caller files (manifest lookup): createSsrRpc(functionId) +// Template for SSR caller files: createSsrRpc(functionId) const ssrRpcManifestTemplate = babel.template.expression( `createSsrRpc(%%functionId%%)`, ) -// Template for SSR caller files (with importer): createSsrRpc(functionId, () => import(...).then(m => m['name'])) -const ssrRpcImporterTemplate = babel.template.expression( - `createSsrRpc(%%functionId%%, () => import(%%extractedFilename%%).then(m => m[%%functionName%%]))`, -) - // ============================================================================ // Runtime code cache (cached per framework to avoid repeated AST generation) // ============================================================================ @@ -75,8 +84,6 @@ function getCachedRuntimeCode( interface EnvConfig { /** Whether this environment is a client environment */ isClientEnvironment: boolean - /** Whether SSR is the provider environment */ - ssrIsProvider: boolean /** The runtime code type to use for imports */ runtimeCodeType: RuntimeCodeType } @@ -88,15 +95,11 @@ function getEnvConfig( context: CompilationContext, isProviderFile: boolean, ): EnvConfig { - const { providerEnvName, env } = context - - // SSR is the provider when the provider environment is the default server environment - const ssrIsProvider = providerEnvName === VITE_ENVIRONMENT_NAMES.server + const { env } = context if (isProviderFile) { return { isClientEnvironment: false, - ssrIsProvider, runtimeCodeType: 'provider', } } @@ -104,7 +107,6 @@ function getEnvConfig( if (env === 'client') { return { isClientEnvironment: true, - ssrIsProvider, runtimeCodeType: 'client', } } @@ -112,7 +114,6 @@ function getEnvConfig( // Server caller (SSR) return { isClientEnvironment: false, - ssrIsProvider, runtimeCodeType: 'ssr', } } @@ -154,9 +155,6 @@ function generateProviderRpcStub( */ function generateCallerRpcStub( functionId: string, - functionName: string, - extractedFilename: string, - isClientReferenced: boolean, envConfig: EnvConfig, ): t.Expression { const functionIdLiteral = t.stringLiteral(functionId) @@ -167,20 +165,8 @@ function generateCallerRpcStub( }) } - // SSR caller - // When the function is client-referenced, it's in the manifest - use manifest lookup - // When SSR is NOT the provider, always use manifest lookup (no import() for different env) - // Otherwise, use the importer for functions only referenced on the server when SSR is the provider - if (isClientReferenced || !envConfig.ssrIsProvider) { - return ssrRpcManifestTemplate({ - functionId: functionIdLiteral, - }) - } - - return ssrRpcImporterTemplate({ + return ssrRpcManifestTemplate({ functionId: functionIdLiteral, - extractedFilename: t.stringLiteral(extractedFilename), - functionName: t.stringLiteral(functionName), }) } @@ -210,6 +196,13 @@ export function handleCreateServerFn( } const isProviderFile = context.id.includes(TSS_SERVERFN_SPLIT_PARAM) + if (isProviderFile && context.serverFnProviderModuleDirectives) { + ensureDirectivePrologue( + context.ast, + context.serverFnProviderModuleDirectives, + ) + } + // Get environment-specific configuration const envConfig = getEnvConfig(context, isProviderFile) @@ -262,7 +255,15 @@ export function handleCreateServerFn( // Check if this function was already discovered by the client build const knownFn = knownFns[functionId] - const isClientReferenced = envConfig.isClientEnvironment || !!knownFn + // A server function is client-referenced when: + // 1. We're in the client (browser) environment, OR + // 2. It was already discovered by another environment (knownFn), OR + // 3. We're in an SSR caller environment — any server function reachable from + // SSR module graph is callable via client navigation HTTP requests + const isClientReferenced = + envConfig.isClientEnvironment || + !!knownFn || + envConfig.runtimeCodeType === 'ssr' // Use canonical extracted filename from known functions if available const canonicalExtractedFilename = @@ -395,7 +396,7 @@ export function handleCreateServerFn( // Expected output format: // const myFn = createServerFn().handler(createClientRpc("id")) // or - // const myFn = createServerFn().handler(createSsrRpc("id", () => import(...))) + // const myFn = createServerFn().handler(createSsrRpc("id")) // If the handler function is an identifier, we need to remove the bound function // from the file since it won't be needed @@ -408,13 +409,7 @@ export function handleCreateServerFn( // Generate the RPC stub using pre-compiled templates // Note: Caller files only pass functionId, not the full serverFnMeta - const rpcStub = generateCallerRpcStub( - functionId, - functionName, - canonicalExtractedFilename, - isClientReferenced, - envConfig, - ) + const rpcStub = generateCallerRpcStub(functionId, envConfig) // Replace ONLY the handler argument with the RPC stub // Keep the createServerFn().handler() wrapper intact for client middleware @@ -441,14 +436,14 @@ export function handleCreateServerFn( ), ) } + + if (context.mode === 'dev') { + context.ast.program.body.push(...providerHmrAcceptTemplate()) + } } // Notify about discovered functions (only for non-provider files) - if ( - !isProviderFile && - Object.keys(serverFnsById).length > 0 && - context.onServerFnsById - ) { + if (!isProviderFile && hasKeys(serverFnsById) && context.onServerFnsById) { context.onServerFnsById(serverFnsById) } @@ -516,3 +511,25 @@ function safeRemoveExports(ast: t.File): void { return node }) } + +function ensureDirectivePrologue( + ast: t.File, + directiveValues: ReadonlyArray, +): void { + const directives = ast.program.directives + const existingDirectives = new Set( + directives.map((directive) => directive.value.value), + ) + const missingDirectives: Array = [] + + for (const directiveValue of directiveValues) { + if (!directiveValue || existingDirectives.has(directiveValue)) continue + + existingDirectives.add(directiveValue) + missingDirectives.push(directiveValue) + } + + for (let i = missingDirectives.length - 1; i >= 0; i--) { + directives.unshift(t.directive(t.directiveLiteral(missingDirectives[i]!))) + } +} diff --git a/packages/start-plugin-core/src/start-compiler-plugin/handleEnvOnly.ts b/packages/start-plugin-core/src/start-compiler/handleEnvOnly.ts similarity index 100% rename from packages/start-plugin-core/src/start-compiler-plugin/handleEnvOnly.ts rename to packages/start-plugin-core/src/start-compiler/handleEnvOnly.ts diff --git a/packages/start-plugin-core/src/start-compiler/host.ts b/packages/start-plugin-core/src/start-compiler/host.ts new file mode 100644 index 0000000000..c225347dea --- /dev/null +++ b/packages/start-plugin-core/src/start-compiler/host.ts @@ -0,0 +1,136 @@ +import { StartCompiler, getLookupKindsForEnv } from './compiler' +import { getLookupConfigurationsForEnv } from './config' +import type { + CompileStartFrameworkOptions, + StartCompilerImportTransform, + StartCompilerPlugin, + StartCompilerTransformResult, + StartCompilerVirtualModuleContext, +} from '../types' +import type { + DevServerFnModuleSpecifierEncoder, + GenerateFunctionIdFnOptional, + ServerFn, +} from './types' + +export interface CreateStartCompilerOptions { + env: 'client' | 'server' + envName: string + root: string + framework: CompileStartFrameworkOptions + providerEnvName: string + mode: 'dev' | 'build' + generateFunctionId?: GenerateFunctionIdFnOptional + compilerTransforms?: Array | undefined + compilerPlugins?: Array | undefined + serverFnProviderModuleDirectives?: ReadonlyArray | undefined + onServerFnsById?: (d: Record) => void + getKnownServerFns: () => Record + encodeModuleSpecifierInDev?: DevServerFnModuleSpecifierEncoder + loadModule: (id: string) => Promise + resolveId: (id: string, importer?: string) => Promise +} + +export function createStartCompiler( + options: CreateStartCompilerOptions, +): StartCompiler { + return new StartCompiler({ + env: options.env, + envName: options.envName, + root: options.root, + lookupKinds: getLookupKindsForEnv(options.env, { + compilerTransforms: options.compilerTransforms, + }), + lookupConfigurations: getLookupConfigurationsForEnv( + options.env, + options.framework, + { compilerTransforms: options.compilerTransforms }, + ), + mode: options.mode, + framework: options.framework, + providerEnvName: options.providerEnvName, + generateFunctionId: options.generateFunctionId, + onServerFnsById: options.onServerFnsById, + compilerTransforms: options.compilerTransforms, + compilerPlugins: options.compilerPlugins, + serverFnProviderModuleDirectives: options.serverFnProviderModuleDirectives, + getKnownServerFns: options.getKnownServerFns, + devServerFnModuleSpecifierEncoder: options.encodeModuleSpecifierInDev, + loadModule: options.loadModule, + resolveId: options.resolveId, + }) +} + +export function mergeServerFnsById( + current: Record, + next: Record, +): void { + for (const [id, fn] of Object.entries(next)) { + const existing = current[id] + + if (existing) { + current[id] = { + ...fn, + isClientReferenced: + existing.isClientReferenced || fn.isClientReferenced, + } + continue + } + + current[id] = fn + } +} + +export function matchesCodeFilters( + code: string, + filters: ReadonlyArray, +): boolean { + for (const pattern of filters) { + pattern.lastIndex = 0 + if (pattern.test(code)) { + return true + } + } + + return false +} + +export function createCompilerVirtualModuleIdPattern( + compilerPlugins: ReadonlyArray, +) { + const patterns = compilerPlugins + .map((plugin) => plugin.virtualModuleIdPattern) + .filter((pattern): pattern is RegExp => !!pattern) + + if (patterns.length === 0) { + return undefined + } + + return new RegExp( + patterns.map((pattern) => `(?:${pattern.source})`).join('|'), + ) +} + +export function loadCompilerVirtualModule( + compilerPlugins: ReadonlyArray, + context: StartCompilerVirtualModuleContext, +): StartCompilerTransformResult | null { + for (const compilerPlugin of compilerPlugins) { + const pattern = compilerPlugin.virtualModuleIdPattern + if (!pattern) { + continue + } + + pattern.lastIndex = 0 + if (!pattern.test(context.id)) { + continue + } + + const result = compilerPlugin.loadVirtualModule?.(context) + if (result) { + return result + } + } + + return null +} diff --git a/packages/start-plugin-core/src/start-compiler/server-fn-resolver-module.ts b/packages/start-plugin-core/src/start-compiler/server-fn-resolver-module.ts new file mode 100644 index 0000000000..8f872a48c1 --- /dev/null +++ b/packages/start-plugin-core/src/start-compiler/server-fn-resolver-module.ts @@ -0,0 +1,136 @@ +import type { ServerFn } from './types' + +interface ResolverManifestEntry { + id: string + functionName: string + extractedFilename: string + isClientReferenced: boolean +} + +interface GenerateServerFnResolverModuleOptions { + serverFnsById: Record + includeClientReferencedCheck: boolean + useStaticImports?: boolean +} + +function getResolverManifestEntries( + serverFnsById: Record, +): Array { + return ( + Object.entries(serverFnsById) + // Sort entries by ID so that the generated manifest has a stable, deterministic order. + // Non-deterministic ordering causes the compiled hash of the same source file to change + // between builds, breaking content-addressed caching and reproducible deployments. + .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)) + .map(([id, fn]) => ({ + id, + functionName: fn.functionName, + extractedFilename: fn.extractedFilename, + isClientReferenced: fn.isClientReferenced ?? true, + })) + ) +} + +function getClientReferencedCheck( + includeClientReferencedCheck: boolean, +): string { + if (!includeClientReferencedCheck) { + return '' + } + + return ` + if (access.origin === 'client' && !serverFnInfo.isClientReferenced) { + throw new Error('Server function not accessible from client: ' + id) + } +` +} + +function getResolverBody(): string { + return ` +export async function getServerFnById(id, access) { + const serverFnInfo = manifest[id] + if (!serverFnInfo) { + throw new Error('Server function info not found for ' + id) + } +__CLIENT_REFERENCED_CHECK__ + const fnModule = serverFnInfo.module ?? (await serverFnInfo.importer()) + if (!fnModule) { + throw new Error('Server function module not resolved for ' + id) + } + const action = fnModule[serverFnInfo.functionName] + if (!action) { + throw new Error('Server function module export not resolved for serverFn ID: ' + id) + } + return action +} +` +} + +function getResolverManifestModuleAccess(opts: { + useStaticImports?: boolean + extractedFilename: string + moduleRef: string +}): string { + if (opts.useStaticImports) { + return `module: ${opts.moduleRef}` + } + + return `importer: () => import(${JSON.stringify(opts.extractedFilename)})` +} + +function getResolverManifestEntry(opts: { + entry: ResolverManifestEntry + moduleAccess: string + includeClientReferencedCheck: boolean +}): string { + const clientReferenced = opts.includeClientReferencedCheck + ? `,\n isClientReferenced: ${opts.entry.isClientReferenced}` + : '' + + return `'${opts.entry.id}': { + functionName: '${opts.entry.functionName}', + ${opts.moduleAccess}${clientReferenced} + }` +} + +export function generateServerFnResolverModule( + opts: GenerateServerFnResolverModuleOptions, +): string { + const manifestEntries = getResolverManifestEntries(opts.serverFnsById) + const staticImports: Array = [] + + const manifest = manifestEntries + .map((entry, index) => { + const moduleRef = `serverFnModule${index}` + + if (opts.useStaticImports) { + staticImports.push( + `import * as ${moduleRef} from ${JSON.stringify(entry.extractedFilename)}`, + ) + } + + return getResolverManifestEntry({ + entry, + moduleAccess: getResolverManifestModuleAccess({ + useStaticImports: opts.useStaticImports, + extractedFilename: entry.extractedFilename, + moduleRef, + }), + includeClientReferencedCheck: opts.includeClientReferencedCheck, + }) + }) + .join(',\n ') + + const body = getResolverBody().replace( + '__CLIENT_REFERENCED_CHECK__', + getClientReferencedCheck(opts.includeClientReferencedCheck), + ) + + return ` +${staticImports.join('\n')} +const manifest = { + ${manifest} +} +${body} +` +} diff --git a/packages/start-plugin-core/src/start-compiler-plugin/types.ts b/packages/start-plugin-core/src/start-compiler/types.ts similarity index 88% rename from packages/start-plugin-core/src/start-compiler-plugin/types.ts rename to packages/start-plugin-core/src/start-compiler/types.ts index 141cb4e28f..725ac26f0f 100644 --- a/packages/start-plugin-core/src/start-compiler-plugin/types.ts +++ b/packages/start-plugin-core/src/start-compiler/types.ts @@ -1,27 +1,18 @@ import type * as babel from '@babel/core' import type * as t from '@babel/types' -import type { CompileStartFrameworkOptions } from '../types' +import type { StartCompilerTransformContext } from '../types' /** * Context passed to all plugin handlers during compilation. * Contains both read-only input data and mutable state that handlers update. */ -export interface CompilationContext { - readonly ast: t.File - readonly code: string - readonly id: string - readonly env: 'client' | 'server' - readonly envName: string - readonly root: string - /** The framework being used (e.g., 'react', 'solid') */ - readonly framework: CompileStartFrameworkOptions - /** The Vite environment name for the server function provider */ - readonly providerEnvName: string - +export interface CompilationContext extends StartCompilerTransformContext { /** Generate a unique function ID */ generateFunctionId: GenerateFunctionIdFn /** Get known server functions from previous builds (e.g., client build) */ getKnownServerFns: () => Record + /** Module-level directives to add to extracted server function provider files. */ + serverFnProviderModuleDirectives: ReadonlyArray | undefined /** * Callback when server functions are discovered. @@ -29,6 +20,7 @@ export interface CompilationContext { */ onServerFnsById: ((d: Record) => void) | undefined } + /** * Batched plugin handler signature. * Receives ALL candidates of a specific kind in one call. @@ -112,6 +104,11 @@ export type GenerateFunctionIdFnOptional = ( * Function type for generating replacement code for server functions. * Used internally by handleCreateServerFn. */ +export type DevServerFnModuleSpecifierEncoder = (opts: { + extractedFilename: string + root: string +}) => string + export type ReplacerFn = (opts: { /** Placeholder for the original function expression */ fn: string diff --git a/packages/start-plugin-core/src/start-compiler-plugin/utils.ts b/packages/start-plugin-core/src/start-compiler/utils.ts similarity index 100% rename from packages/start-plugin-core/src/start-compiler-plugin/utils.ts rename to packages/start-plugin-core/src/start-compiler/utils.ts diff --git a/packages/start-plugin-core/src/start-manifest-plugin/inlineCss.ts b/packages/start-plugin-core/src/start-manifest-plugin/inlineCss.ts new file mode 100644 index 0000000000..bf87de9bfe --- /dev/null +++ b/packages/start-plugin-core/src/start-manifest-plugin/inlineCss.ts @@ -0,0 +1,203 @@ +import { transform } from 'lightningcss' + +export interface InlineCssTemplate { + strings: Array + urls: Array +} + +export interface InlineCssResult { + css: string + template?: InlineCssTemplate +} + +const cssUrlPattern = + /url\(\s*(?:"([^"]*)"|'([^']*)'|([^)"']*?))\s*\)|@import\s+(?:url\(\s*(?:"([^"]*)"|'([^']*)'|([^)"']*?))\s*\)|"([^"]*)"|'([^']*)')/gi + +function createInlineCssUrlPlaceholder(index: number) { + return `__TSS INLINE CSS URL ${index}__` +} + +function isRelativeCssUrl(url: string) { + if (!url) return false + if (url.startsWith('#')) return false + if (url.startsWith('/')) return false + if (/^[a-z][a-z\d+.-]*:/i.test(url)) return false + return true +} + +export function shouldRebaseInlineCssUrls(css: string) { + return shouldProcessInlineCssUrls(css, false) +} + +function shouldTransformInlineCssUrl(url: string) { + if (!url) return false + if (url.startsWith('#')) return false + if (url.startsWith('//')) return false + if (/^[a-z][a-z\d+.-]*:/i.test(url)) return false + return true +} + +function shouldProcessInlineCssUrls(css: string, templates: boolean) { + cssUrlPattern.lastIndex = 0 + + for (const match of css.matchAll(cssUrlPattern)) { + const url = ( + match[1] ?? + match[2] ?? + match[3] ?? + match[4] ?? + match[5] ?? + match[6] ?? + match[7] ?? + match[8] ?? + '' + ).trim() + + if (templates ? shouldTransformInlineCssUrl(url) : isRelativeCssUrl(url)) { + return true + } + } + + return false +} + +function rebaseCssUrl(url: string, cssHref: string) { + if (!isRelativeCssUrl(url)) { + return url + } + + const fakeOrigin = 'http://tanstack.local' + const resolved = new URL(url, new URL(cssHref, fakeOrigin)) + + if (resolved.origin === fakeOrigin) { + return `${resolved.pathname}${resolved.search}${resolved.hash}` + } + + return resolved.href +} + +export function rebaseInlineCssUrls(options: { css: string; cssHref: string }) { + return processInlineCssUrls(options).css +} + +export function processInlineCssUrls(options: { + css: string + cssHref: string + templates?: boolean +}): InlineCssResult { + const css = options.css.trim() + const templates = options.templates === true + + if (!shouldProcessInlineCssUrls(css, templates)) { + return { css } + } + + const urls: Array = [] + + const result = transform({ + filename: options.cssHref, + code: Buffer.from(css), + minify: true, + visitor: { + Url(url) { + if (!shouldTransformInlineCssUrl(url.url)) { + return url + } + + const rebasedUrl = rebaseCssUrl(url.url, options.cssHref) + + if (templates) { + urls.push(rebasedUrl) + return { + ...url, + url: createInlineCssUrlPlaceholder(urls.length - 1), + } + } + + return { + ...url, + url: rebasedUrl, + } + }, + Rule: { + import(rule: any) { + if (!shouldTransformInlineCssUrl(rule.value.url)) { + return rule + } + + const rebasedUrl = rebaseCssUrl(rule.value.url, options.cssHref) + if (templates) { + urls.push(rebasedUrl) + } + + const value = { + url: templates + ? createInlineCssUrlPlaceholder(urls.length - 1) + : rebasedUrl, + loc: rule.value.loc, + ...(rule.value.media ? { media: rule.value.media } : {}), + ...(rule.value.layer ? { layer: rule.value.layer } : {}), + ...(rule.value.supports ? { supports: rule.value.supports } : {}), + } + + return { + ...rule, + value, + } + }, + }, + }, + }) + + const transformedCss = Buffer.from(result.code).toString('utf8') + + if (!templates || urls.length === 0) { + return { css: transformedCss } + } + + return createInlineCssTemplate(transformedCss, urls) +} + +function createInlineCssTemplate( + cssWithPlaceholders: string, + urls: Array, +): InlineCssResult { + const strings: Array = [] + let css = '' + let cursor = 0 + + for (let index = 0; index < urls.length; index++) { + const placeholder = createInlineCssUrlPlaceholder(index) + const placeholderIndex = cssWithPlaceholders.indexOf(placeholder, cursor) + + if (placeholderIndex === -1) { + throw new Error( + `TanStack Start inlineCss could not find CSS URL placeholder: ${placeholder}`, + ) + } + + const staticPart = cssWithPlaceholders.slice(cursor, placeholderIndex) + strings.push(staticPart) + css += staticPart + urls[index] + cursor = placeholderIndex + placeholder.length + } + + const finalStaticPart = cssWithPlaceholders.slice(cursor) + strings.push(finalStaticPart) + css += finalStaticPart + + return { + css, + template: { + strings, + urls, + }, + } +} + +export function getCssAssetSource(source: unknown) { + if (typeof source === 'string') return source + if (source instanceof Uint8Array) return Buffer.from(source).toString('utf8') + if (source == null) return undefined + return String(source) +} diff --git a/packages/start-plugin-core/src/start-manifest-plugin/manifestBuilder.ts b/packages/start-plugin-core/src/start-manifest-plugin/manifestBuilder.ts index c08ae4ce3f..02a8586592 100644 --- a/packages/start-plugin-core/src/start-manifest-plugin/manifestBuilder.ts +++ b/packages/start-plugin-core/src/start-manifest-plugin/manifestBuilder.ts @@ -1,42 +1,69 @@ /* eslint-disable @typescript-eslint/prefer-for-of */ +import { serialize } from 'seroval' import { joinURL } from 'ufo' -import { resolveManifestAssetLink, rootRouteId } from '@tanstack/router-core' -import { tsrSplit } from '@tanstack/router-plugin' -import type { ManifestAssetLink, RouterManagedTag } from '@tanstack/router-core' -import type { Rollup } from 'vite' +import { + getStylesheetHref, + resolveManifestAssetLink, + resolveManifestCssLink, + rootRouteId, +} from '@tanstack/router-core' +import { processInlineCssUrls } from './inlineCss' +import type { + ManifestAssetLink, + ManifestCssLink, + ManifestScript, + ScriptFormat, +} from '@tanstack/router-core' +import type { InlineCssTemplate } from './inlineCss' +import type { NormalizedClientBuild, NormalizedClientChunk } from '../types' -const ROUTER_MANAGED_MODE = 1 -const NON_ROUTE_DYNAMIC_MODE = 2 const VISITING_CHUNK = 1 type RouteTreeRoute = { filePath?: string preloads?: Array - assets?: Array + scripts?: Array + css?: Array children?: Array } type RouteTreeRoutes = Record +type AdditionalRouteManifestEntry = ManifestCssLink | ManifestScript + interface ScannedClientChunks { - entryChunk: Rollup.OutputChunk - chunksByFileName: Map - routeChunksByFilePath: Map> - routeEntryChunks: Set + entryChunk: NormalizedClientChunk + chunksByFileName: ReadonlyMap + routeChunksByFilePath: ReadonlyMap> } interface ManifestAssetResolvers { getAssetPath: (fileName: string) => string - getChunkPreloads: (chunk: Rollup.OutputChunk) => Array - getStylesheetAsset: (cssFile: string) => RouterManagedTag + getChunkPreloads: (chunk: NormalizedClientChunk) => Array + getStylesheetLink: (cssFile: string) => ManifestCssLink } type DedupeRoute = { preloads?: Array - assets?: Array + scripts?: Array + css?: Array children?: Array } +export interface StartManifest { + scriptFormat?: ScriptFormat + routes: Record + inlineCss?: { + styles: Record + templates?: Record + } +} + +export interface InlineCssOptions { + enabled: boolean + transformAssets: boolean +} + export function appendUniqueStrings( target: Array | undefined, source: Array, @@ -70,12 +97,10 @@ export function appendUniqueStrings( return result ?? target } -export function appendUniqueAssets( - target: Array | undefined, - source: Array, +function appendUniqueStylesheets( + target: Array | undefined, + source: Array, ) { - // Same semantics as appendUniqueStrings, but uniqueness is based on the - // serialized asset identity instead of object reference. if (source.length === 0) { return target } @@ -84,11 +109,11 @@ export function appendUniqueAssets( return source } - const seen = new Set(target.map(getAssetIdentity)) - let result: Array | undefined + const seen = new Set(target.map(getStylesheetIdentity)) + let result: Array | undefined - for (const asset of source) { - const identity = getAssetIdentity(asset) + for (const stylesheet of source) { + const identity = getStylesheetIdentity(stylesheet) if (seen.has(identity)) { continue } @@ -97,59 +122,150 @@ export function appendUniqueAssets( if (!result) { result = target.slice() } - result.push(asset) + result.push(stylesheet) } return result ?? target } -function getAssetIdentity(asset: RouterManagedTag) { - if (asset.tag === 'link' || asset.tag === 'script') { - const attrs = asset.attrs ?? {} - return [ - asset.tag, - 'href' in attrs ? String(attrs.href) : '', - 'src' in attrs ? String(attrs.src) : '', - 'rel' in attrs ? String(attrs.rel) : '', - 'type' in attrs ? String(attrs.type) : '', - asset.children ?? '', - ].join('|') +function getStylesheetIdentity(attrs: ManifestCssLink) { + const resolved = resolveManifestCssLink(attrs) + return `${resolved.href}\0${resolved.crossOrigin ?? ''}` +} + +function getScriptIdentity(script: ManifestScript) { + return JSON.stringify({ + attrs: normalizeAttrs(script.attrs), + children: script.children ?? null, + }) +} + +function normalizeAttrs(attrs: Record | undefined) { + if (!attrs) { + return null } - return JSON.stringify(asset) + const entries = Object.entries(attrs) + if (entries.length === 0) { + return null + } + + entries.sort(([left], [right]) => left.localeCompare(right)) + return Object.fromEntries(entries) } function mergeRouteChunkData(options: { route: RouteTreeRoute - chunk: Rollup.OutputChunk - getChunkCssAssets: (chunk: Rollup.OutputChunk) => Array - getChunkPreloads: (chunk: Rollup.OutputChunk) => Array + chunk: NormalizedClientChunk + getChunkCssAssets: (chunk: NormalizedClientChunk) => Array + getChunkPreloads: (chunk: NormalizedClientChunk) => Array }) { - const chunkAssets = options.getChunkCssAssets(options.chunk) + const stylesheets = options.getChunkCssAssets(options.chunk) const chunkPreloads = options.getChunkPreloads(options.chunk) - options.route.assets = appendUniqueAssets(options.route.assets, chunkAssets) + appendRouteStylesheets(options.route, stylesheets) options.route.preloads = appendUniqueStrings( options.route.preloads, chunkPreloads, ) } +function appendRouteStylesheets( + route: RouteTreeRoute, + stylesheets: Array, +) { + if (stylesheets.length === 0) { + return + } + + route.css = appendUniqueStylesheets(route.css, stylesheets) +} + +function appendRouteScripts( + route: RouteTreeRoute, + scripts: Array, +) { + if (scripts.length === 0) { + return + } + + route.scripts = [...(route.scripts ?? []), ...scripts] +} + +function buildScript(src: string, scriptFormat: ScriptFormat): ManifestScript { + return { + attrs: { + ...(scriptFormat === 'module' ? { type: 'module' } : {}), + async: true, + src, + }, + } +} + +function appendEntryChunkScripts(options: { + route: RouteTreeRoute + chunk: NormalizedClientChunk + scriptFormat: ScriptFormat + getAssetPath: (fileName: string) => string +}) { + const scripts: Array = [] + + if (options.scriptFormat === 'iife') { + for (let i = 0; i < options.chunk.imports.length; i++) { + scripts.push( + buildScript( + options.getAssetPath(options.chunk.imports[i]!), + options.scriptFormat, + ), + ) + } + } + + scripts.push( + buildScript( + options.getAssetPath(options.chunk.fileName), + options.scriptFormat, + ), + ) + + appendRouteScripts(options.route, scripts) +} + +function appendAdditionalRouteEntries( + route: RouteTreeRoute, + entries: ReadonlyArray, +) { + if (entries.length === 0) { + return + } + + const stylesheets: Array = [] + const scripts: Array = [] + + for (const entry of entries) { + if (typeof entry === 'string' || 'href' in entry) { + stylesheets.push(entry) + } else { + scripts.push(entry) + } + } + + appendRouteStylesheets(route, stylesheets) + appendRouteScripts(route, scripts) +} + export function buildStartManifest(options: { - clientBundle: Rollup.OutputBundle + clientBuild: NormalizedClientBuild routeTreeRoutes: RouteTreeRoutes basePath: string -}) { - const scannedChunks = scanClientChunks(options.clientBundle) - const hashedCssFiles = collectDynamicImportCss( - scannedChunks.routeEntryChunks, - scannedChunks.chunksByFileName, - scannedChunks.entryChunk, - ) - const assetResolvers = createManifestAssetResolvers({ - basePath: options.basePath, - hashedCssFiles, - }) + inlineCss?: InlineCssOptions + scriptFormat?: ScriptFormat + additionalRouteAssets?: Partial< + Record> + > +}): StartManifest { + const scannedChunks = scanClientChunks(options.clientBuild) + const assetResolvers = createManifestAssetResolvers(options.basePath) const routes = buildRouteManifestRoutes({ routeTreeRoutes: options.routeTreeRoutes, @@ -157,206 +273,92 @@ export function buildStartManifest(options: { chunksByFileName: scannedChunks.chunksByFileName, entryChunk: scannedChunks.entryChunk, assetResolvers, + additionalRouteAssets: options.additionalRouteAssets, + }) + + appendEntryChunkScripts({ + route: routes[rootRouteId]!, + chunk: scannedChunks.entryChunk, + scriptFormat: options.scriptFormat ?? 'module', + getAssetPath: assetResolvers.getAssetPath, }) dedupeNestedRouteManifestEntries(rootRouteId, routes[rootRouteId]!, routes) - // Prune routes with no assets or preloads from the manifest - for (const routeId of Object.keys(routes)) { + // Prune routes with no manifest data + for (const routeId in routes) { const route = routes[routeId]! - const hasAssets = route.assets && route.assets.length > 0 + const hasScripts = route.scripts && route.scripts.length > 0 + const hasCssLinks = route.css && route.css.length > 0 const hasPreloads = route.preloads && route.preloads.length > 0 - if (!hasAssets && !hasPreloads) { + if (!hasScripts && !hasCssLinks && !hasPreloads) { delete routes[routeId] } } - return { + const result: StartManifest = { routes, - clientEntry: assetResolvers.getAssetPath(scannedChunks.entryChunk.fileName), } + + if (options.scriptFormat === 'iife') { + result.scriptFormat = 'iife' + } + + if (options.inlineCss?.enabled) { + result.inlineCss = buildInlineCssManifestData({ + routes, + basePath: options.basePath, + cssContentByFileName: options.clientBuild.cssContentByFileName, + transformAssets: options.inlineCss.transformAssets, + }) + } + + return result +} + +export function serializeStartManifest(startManifest: StartManifest) { + return serialize(startManifest) } export function scanClientChunks( - clientBundle: Rollup.OutputBundle, + clientBuild: NormalizedClientBuild, ): ScannedClientChunks { - let entryChunk: Rollup.OutputChunk | undefined - const chunksByFileName = new Map() - const routeChunksByFilePath = new Map>() - const routeEntryChunks = new Set() - - for (const fileName in clientBundle) { - const bundleEntry = clientBundle[fileName]! - if (bundleEntry.type !== 'chunk') { - continue - } - - chunksByFileName.set(bundleEntry.fileName, bundleEntry) - - if (bundleEntry.isEntry) { - if (entryChunk) { - throw new Error( - `multiple entries detected: ${entryChunk.fileName} ${bundleEntry.fileName}`, - ) - } - entryChunk = bundleEntry - } - - const routeFilePaths = getRouteFilePathsFromModuleIds(bundleEntry.moduleIds) - if (routeFilePaths.length === 0) { - continue - } - - routeEntryChunks.add(bundleEntry) - - for (let i = 0; i < routeFilePaths.length; i++) { - const routeFilePath = routeFilePaths[i]! - let chunks = routeChunksByFilePath.get(routeFilePath) - if (chunks === undefined) { - chunks = [] - routeChunksByFilePath.set(routeFilePath, chunks) - } - chunks.push(bundleEntry) - } - } + const entryChunk = clientBuild.chunksByFileName.get( + clientBuild.entryChunkFileName, + ) if (!entryChunk) { - throw new Error('No entry file found') + throw new Error(`Missing entry chunk: ${clientBuild.entryChunkFileName}`) + } + + const routeChunksByFilePath = new Map>() + + for (const chunk of clientBuild.chunksByFileName.values()) { + if (chunk.routeFilePaths.length > 0) { + for (const routeFilePath of chunk.routeFilePaths) { + let chunks = routeChunksByFilePath.get(routeFilePath) + if (chunks === undefined) { + chunks = [] + routeChunksByFilePath.set(routeFilePath, chunks) + } + chunks.push(chunk) + } + } } return { entryChunk, - chunksByFileName, + chunksByFileName: clientBuild.chunksByFileName, routeChunksByFilePath, - routeEntryChunks, } } -export function getRouteFilePathsFromModuleIds(moduleIds: Array) { - let routeFilePaths: Array | undefined - let seenRouteFilePaths: Set | undefined - - for (const moduleId of moduleIds) { - const queryIndex = moduleId.indexOf('?') - - if (queryIndex < 0) { - continue - } - - const query = moduleId.slice(queryIndex + 1) - - // Fast check before allocating URLSearchParams - if (!query.includes(tsrSplit)) { - continue - } - - if (!new URLSearchParams(query).has(tsrSplit)) { - continue - } - - const routeFilePath = moduleId.slice(0, queryIndex) - - if (seenRouteFilePaths?.has(routeFilePath)) { - continue - } - - if (routeFilePaths === undefined) { - routeFilePaths = [] - seenRouteFilePaths = new Set() - } - - routeFilePaths.push(routeFilePath) - seenRouteFilePaths!.add(routeFilePath) - } - - return routeFilePaths ?? [] -} - -export function collectDynamicImportCss( - routeEntryChunks: Set, - chunksByFileName: Map, - entryChunk?: Rollup.OutputChunk, -) { - const routerManagedCssFiles = new Set() - const nonRouteDynamicCssFiles = new Set() - const hashedCssFiles = new Set() - const visitedByChunk = new Map() - const chunkStack: Array = [] - const modeStack: Array = [] - - for (const routeEntryChunk of routeEntryChunks) { - chunkStack.push(routeEntryChunk) - modeStack.push(ROUTER_MANAGED_MODE) - } - - if (entryChunk) { - chunkStack.push(entryChunk) - modeStack.push(ROUTER_MANAGED_MODE) - } - - while (chunkStack.length > 0) { - const chunk = chunkStack.pop()! - const mode = modeStack.pop()! - const previousMode = visitedByChunk.get(chunk) ?? 0 - - if ((previousMode & mode) === mode) { - continue - } - - visitedByChunk.set(chunk, previousMode | mode) - - if ((mode & ROUTER_MANAGED_MODE) !== 0) { - for (const cssFile of chunk.viteMetadata?.importedCss ?? []) { - routerManagedCssFiles.add(cssFile) - } - } - - if ((mode & NON_ROUTE_DYNAMIC_MODE) !== 0) { - for (const cssFile of chunk.viteMetadata?.importedCss ?? []) { - nonRouteDynamicCssFiles.add(cssFile) - } - } - - for (let i = 0; i < chunk.imports.length; i++) { - const importedChunk = chunksByFileName.get(chunk.imports[i]!) - if (importedChunk) { - chunkStack.push(importedChunk) - modeStack.push(mode) - } - } - - for (let i = 0; i < chunk.dynamicImports.length; i++) { - const dynamicImportedChunk = chunksByFileName.get( - chunk.dynamicImports[i]!, - ) - if (dynamicImportedChunk) { - chunkStack.push(dynamicImportedChunk) - modeStack.push( - (mode & NON_ROUTE_DYNAMIC_MODE) !== 0 || - !routeEntryChunks.has(dynamicImportedChunk) - ? NON_ROUTE_DYNAMIC_MODE - : ROUTER_MANAGED_MODE, - ) - } - } - } - - for (const cssFile of routerManagedCssFiles) { - if (nonRouteDynamicCssFiles.has(cssFile)) { - hashedCssFiles.add(cssFile) - } - } - - return hashedCssFiles -} - -export function createManifestAssetResolvers(options: { - basePath: string - hashedCssFiles?: Set -}): ManifestAssetResolvers { +export function createManifestAssetResolvers( + basePath: string, +): ManifestAssetResolvers { const assetPathByFileName = new Map() - const stylesheetAssetByFileName = new Map() - const preloadsByChunk = new Map>() + const stylesheetLinkByFileName = new Map() + const preloadsByChunk = new Map>() const getAssetPath = (fileName: string) => { const cachedPath = assetPathByFileName.get(fileName) @@ -364,32 +366,25 @@ export function createManifestAssetResolvers(options: { return cachedPath } - const assetPath = joinURL(options.basePath, fileName) + const assetPath = joinURL(basePath, fileName) assetPathByFileName.set(fileName, assetPath) return assetPath } - const getStylesheetAsset = (cssFile: string) => { - const cachedAsset = stylesheetAssetByFileName.get(cssFile) - if (cachedAsset) { - return cachedAsset + const getStylesheetLink = (cssFile: string) => { + const cachedLink = stylesheetLinkByFileName.get(cssFile) + if (cachedLink) { + return cachedLink } const href = getAssetPath(cssFile) - const asset = { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: options.hashedCssFiles?.has(cssFile) ? `${href}#` : href, - type: 'text/css', - }, - } satisfies RouterManagedTag + const link = href satisfies ManifestCssLink - stylesheetAssetByFileName.set(cssFile, asset) - return asset + stylesheetLinkByFileName.set(cssFile, link) + return link } - const getChunkPreloads = (chunk: Rollup.OutputChunk) => { + const getChunkPreloads = (chunk: NormalizedClientChunk) => { const cachedPreloads = preloadsByChunk.get(chunk) if (cachedPreloads) { return cachedPreloads @@ -408,37 +403,36 @@ export function createManifestAssetResolvers(options: { return { getAssetPath, getChunkPreloads, - getStylesheetAsset, + getStylesheetLink, } } export function createChunkCssAssetCollector(options: { - chunksByFileName: Map - getStylesheetAsset: (cssFile: string) => RouterManagedTag + chunksByFileName: ReadonlyMap + getStylesheetLink: (cssFile: string) => ManifestCssLink }) { - const assetsByChunk = new Map>() - const stateByChunk = new Map() + const linksByChunk = new Map>() + const stateByChunk = new Map() const appendAsset = ( - assets: Array, - seenAssets: Set, - asset: RouterManagedTag, + links: Array, + seenLinks: Set, + link: ManifestCssLink, ) => { - const identity = getAssetIdentity(asset) - if (seenAssets.has(identity)) { + if (seenLinks.has(link)) { return } - seenAssets.add(identity) - assets.push(asset) + seenLinks.add(link) + links.push(link) } const getChunkCssAssets = ( - chunk: Rollup.OutputChunk, - ): Array => { - const cachedAssets = assetsByChunk.get(chunk) - if (cachedAssets) { - return cachedAssets + chunk: NormalizedClientChunk, + ): Array => { + const cachedLinks = linksByChunk.get(chunk) + if (cachedLinks) { + return cachedLinks } if (stateByChunk.get(chunk) === VISITING_CHUNK) { @@ -446,12 +440,8 @@ export function createChunkCssAssetCollector(options: { } stateByChunk.set(chunk, VISITING_CHUNK) - const assets: Array = [] - const seenAssets = new Set() - - for (const cssFile of chunk.viteMetadata?.importedCss ?? []) { - appendAsset(assets, seenAssets, options.getStylesheetAsset(cssFile)) - } + const links: Array = [] + const seenLinks = new Set() for (let i = 0; i < chunk.imports.length; i++) { const importedChunk = options.chunksByFileName.get(chunk.imports[i]!) @@ -459,37 +449,110 @@ export function createChunkCssAssetCollector(options: { continue } - const importedAssets = getChunkCssAssets(importedChunk) - for (let j = 0; j < importedAssets.length; j++) { - appendAsset(assets, seenAssets, importedAssets[j]!) + const importedLinks = getChunkCssAssets(importedChunk) + for (let j = 0; j < importedLinks.length; j++) { + appendAsset(links, seenLinks, importedLinks[j]!) } } + for (const cssFile of chunk.css) { + appendAsset(links, seenLinks, options.getStylesheetLink(cssFile)) + } + stateByChunk.delete(chunk) - assetsByChunk.set(chunk, assets) - return assets + linksByChunk.set(chunk, links) + return links } return { getChunkCssAssets } } +function buildInlineCssManifestData(options: { + routes: Record + basePath: string + cssContentByFileName: ReadonlyMap | undefined + transformAssets: boolean +}): StartManifest['inlineCss'] { + const stylesheetHrefs = new Set() + + for (const route of Object.values(options.routes)) { + for (const link of route.css ?? []) { + stylesheetHrefs.add(getStylesheetHref(link)) + } + } + + if (stylesheetHrefs.size === 0) { + return { styles: {} } + } + + if (!options.cssContentByFileName) { + throw new Error( + 'TanStack Start inlineCss is enabled, but the client build did not provide CSS content', + ) + } + + const { getAssetPath } = createManifestAssetResolvers(options.basePath) + const styles: Record = {} + let templates: Record | undefined + const missingHrefs = new Set(stylesheetHrefs) + + for (const [cssFile, css] of options.cssContentByFileName) { + const cssHref = getAssetPath(cssFile) + if (!stylesheetHrefs.has(cssHref)) { + continue + } + + const result = processInlineCssUrls({ + css, + cssHref, + templates: options.transformAssets, + }) + + styles[cssHref] = result.css + if (result.template) { + templates ||= {} + templates[cssHref] = result.template + } + missingHrefs.delete(cssHref) + } + + if (missingHrefs.size > 0) { + throw new Error( + `TanStack Start inlineCss could not find CSS content for: ${Array.from( + missingHrefs, + ).join(', ')}`, + ) + } + + return { + styles, + ...(templates ? { templates } : {}), + } +} + export function buildRouteManifestRoutes(options: { routeTreeRoutes: RouteTreeRoutes - routeChunksByFilePath: Map> - chunksByFileName: Map - entryChunk: Rollup.OutputChunk + routeChunksByFilePath: ReadonlyMap< + string, + ReadonlyArray + > + chunksByFileName: ReadonlyMap + entryChunk: NormalizedClientChunk assetResolvers: ManifestAssetResolvers + additionalRouteAssets?: Partial< + Record> + > }) { const routes: Record = {} const getChunkCssAssets = createChunkCssAssetCollector({ chunksByFileName: options.chunksByFileName, - getStylesheetAsset: options.assetResolvers.getStylesheetAsset, + getStylesheetLink: options.assetResolvers.getStylesheetLink, }).getChunkCssAssets for (const [routeId, route] of Object.entries(options.routeTreeRoutes)) { if (!route.filePath) { if (routeId === rootRouteId) { - routes[routeId] = route + routes[routeId] = { ...route } continue } @@ -498,7 +561,7 @@ export function buildRouteManifestRoutes(options: { const chunks = options.routeChunksByFilePath.get(route.filePath) if (!chunks) { - routes[routeId] = route + routes[routeId] = { ...route } continue } @@ -512,10 +575,35 @@ export function buildRouteManifestRoutes(options: { getChunkCssAssets, getChunkPreloads: options.assetResolvers.getChunkPreloads, }) + + if (routeId !== rootRouteId) { + mergeReachableHydrationChunkData({ + route: targetRoute, + chunk, + chunksByFileName: options.chunksByFileName, + getChunkCssAssets, + }) + } } } const rootRoute = (routes[rootRouteId] = routes[rootRouteId] || {}) + const rootRouteTreeRoute = options.routeTreeRoutes[rootRouteId] + const rootRouteChunks = rootRouteTreeRoute?.filePath + ? options.routeChunksByFilePath.get(rootRouteTreeRoute.filePath) + : undefined + + if (rootRouteChunks) { + for (const chunk of rootRouteChunks) { + mergeReachableHydrationChunkData({ + route: rootRoute, + chunk, + chunksByFileName: options.chunksByFileName, + getChunkCssAssets, + }) + } + } + mergeRouteChunkData({ route: rootRoute, chunk: options.entryChunk, @@ -523,18 +611,88 @@ export function buildRouteManifestRoutes(options: { getChunkPreloads: options.assetResolvers.getChunkPreloads, }) + if (options.additionalRouteAssets) { + for (const [routeId, assets] of Object.entries( + options.additionalRouteAssets, + )) { + if (!assets || assets.length === 0) { + continue + } + + if (!(routeId in options.routeTreeRoutes)) { + throw new Error( + `expected additionalRouteAssets routeId to exist in routeTreeRoutes: ${routeId}`, + ) + } + + const route = (routes[routeId] = routes[routeId] || {}) + appendAdditionalRouteEntries(route, assets) + } + } + return routes } +function mergeReachableHydrationChunkData(options: { + route: RouteTreeRoute + chunk: NormalizedClientChunk + chunksByFileName: ReadonlyMap + getChunkCssAssets: (chunk: NormalizedClientChunk) => Array +}) { + const visitedStaticChunks = new Set() + const mergedHydrationChunks = new Set() + + const mergeHydrationChunk = (chunk: NormalizedClientChunk) => { + if (mergedHydrationChunks.has(chunk.fileName)) { + return + } + mergedHydrationChunks.add(chunk.fileName) + + appendRouteStylesheets(options.route, options.getChunkCssAssets(chunk)) + + for (const dynamicImport of chunk.dynamicImports) { + const dynamicChunk = options.chunksByFileName.get(dynamicImport) + if (dynamicChunk?.hydrationIds.length) { + mergeHydrationChunk(dynamicChunk) + } + } + } + + const visitStaticChunk = (chunk: NormalizedClientChunk) => { + if (visitedStaticChunks.has(chunk.fileName)) { + return + } + visitedStaticChunks.add(chunk.fileName) + + for (const importedFileName of chunk.imports) { + const importedChunk = options.chunksByFileName.get(importedFileName) + if (importedChunk) { + visitStaticChunk(importedChunk) + } + } + + for (const dynamicImport of chunk.dynamicImports) { + const dynamicChunk = options.chunksByFileName.get(dynamicImport) + if (dynamicChunk?.hydrationIds.length) { + mergeHydrationChunk(dynamicChunk) + } + } + } + + visitStaticChunk(options.chunk) +} + function dedupeNestedRouteManifestEntries( routeId: string, route: DedupeRoute, routesById: Record, seenPreloads = new Set(), - seenAssets = new Set(), + seenScripts = new Set(), + seenStylesheets = new Set(), ) { let routePreloads = route.preloads - let routeAssets = route.assets + let routeScripts = route.scripts + let routeStylesheets = route.css if (routePreloads && routePreloads.length > 0) { let dedupedPreloads: Array | undefined @@ -563,30 +721,65 @@ function dedupeNestedRouteManifestEntries( } } - if (routeAssets && routeAssets.length > 0) { - let dedupedAssets: Array | undefined + if (routeScripts && routeScripts.length > 0) { + let dedupedScripts: Array | undefined - for (let i = 0; i < routeAssets.length; i++) { - const asset = routeAssets[i]! - const identity = getAssetIdentity(asset) + for (let i = 0; i < routeScripts.length; i++) { + const script = routeScripts[i]! + const identity = getScriptIdentity(script) - if (seenAssets.has(identity)) { - if (dedupedAssets === undefined) { - dedupedAssets = routeAssets.slice(0, i) + if (seenScripts.has(identity)) { + if (dedupedScripts === undefined) { + dedupedScripts = routeScripts.slice(0, i) } continue } - seenAssets.add(identity) + seenScripts.add(identity) - if (dedupedAssets) { - dedupedAssets.push(asset) + if (dedupedScripts) { + dedupedScripts.push(script) } } - if (dedupedAssets) { - routeAssets = dedupedAssets - route.assets = dedupedAssets + if (dedupedScripts) { + routeScripts = dedupedScripts + if (dedupedScripts.length > 0) { + route.scripts = dedupedScripts + } else { + delete route.scripts + } + } + } + + if (routeStylesheets && routeStylesheets.length > 0) { + let dedupedStylesheets: Array | undefined + + for (let i = 0; i < routeStylesheets.length; i++) { + const stylesheet = routeStylesheets[i]! + const identity = getStylesheetIdentity(stylesheet) + + if (seenStylesheets.has(identity)) { + if (dedupedStylesheets === undefined) { + dedupedStylesheets = routeStylesheets.slice(0, i) + } + continue + } + + seenStylesheets.add(identity) + + if (dedupedStylesheets) { + dedupedStylesheets.push(stylesheet) + } + } + + if (dedupedStylesheets) { + routeStylesheets = dedupedStylesheets + if (dedupedStylesheets.length > 0) { + route.css = dedupedStylesheets + } else { + delete route.css + } } } @@ -605,7 +798,8 @@ function dedupeNestedRouteManifestEntries( childRoute, routesById, seenPreloads, - seenAssets, + seenScripts, + seenStylesheets, ) } } @@ -616,9 +810,15 @@ function dedupeNestedRouteManifestEntries( } } - if (routeAssets) { - for (let i = routeAssets.length - 1; i >= 0; i--) { - seenAssets.delete(getAssetIdentity(routeAssets[i]!)) + if (routeScripts) { + for (let i = routeScripts.length - 1; i >= 0; i--) { + seenScripts.delete(getScriptIdentity(routeScripts[i]!)) + } + } + + if (routeStylesheets) { + for (let i = routeStylesheets.length - 1; i >= 0; i--) { + seenStylesheets.delete(getStylesheetIdentity(routeStylesheets[i]!)) } } } diff --git a/packages/start-plugin-core/src/start-manifest-plugin/plugin.ts b/packages/start-plugin-core/src/start-manifest-plugin/plugin.ts deleted file mode 100644 index 97adf931fe..0000000000 --- a/packages/start-plugin-core/src/start-manifest-plugin/plugin.ts +++ /dev/null @@ -1,61 +0,0 @@ -import { joinURL } from 'ufo' -import { VIRTUAL_MODULES } from '@tanstack/start-server-core' -import { resolveViteId } from '../utils' -import { ENTRY_POINTS } from '../constants' -import { buildStartManifest } from './manifestBuilder' -import type { GetConfigFn } from '../types' -import type { PluginOption, Rollup } from 'vite' - -const resolvedModuleId = resolveViteId(VIRTUAL_MODULES.startManifest) - -export function startManifestPlugin(opts: { - getClientBundle: () => Rollup.OutputBundle - getConfig: GetConfigFn -}): PluginOption { - return { - name: 'tanstack-start:start-manifest-plugin', - enforce: 'pre', - resolveId: { - filter: { id: new RegExp(VIRTUAL_MODULES.startManifest) }, - handler(id) { - if (id === VIRTUAL_MODULES.startManifest) { - return resolvedModuleId - } - return undefined - }, - }, - load: { - filter: { - id: new RegExp(resolvedModuleId), - }, - handler(id) { - const { resolvedStartConfig } = opts.getConfig() - if (id === resolvedModuleId) { - if ( - this.environment.name !== resolvedStartConfig.serverFnProviderEnv - ) { - return `export default {}` - } - - if (this.environment.config.command === 'serve') { - return `export const tsrStartManifest = () => ({ - routes: {}, - clientEntry: '${joinURL(resolvedStartConfig.viteAppBase, '@id', ENTRY_POINTS.client)}', - })` - } - - const routeTreeRoutes = globalThis.TSS_ROUTES_MANIFEST - const startManifest = buildStartManifest({ - clientBundle: opts.getClientBundle(), - routeTreeRoutes, - basePath: resolvedStartConfig.viteAppBase, - }) - - return `export const tsrStartManifest = () => (${JSON.stringify(startManifest)})` - } - - return undefined - }, - }, - } -} diff --git a/packages/start-plugin-core/src/start-router-plugin/route-tree-footer.ts b/packages/start-plugin-core/src/start-router-plugin/route-tree-footer.ts new file mode 100644 index 0000000000..c56ffbf90d --- /dev/null +++ b/packages/start-plugin-core/src/start-router-plugin/route-tree-footer.ts @@ -0,0 +1,99 @@ +import path from 'pathe' +import type { GetConfigFn, TanStackStartCoreOptions } from '../types' + +function buildRouteTreeFileFooter(opts: { + generatedRouteTreePath: string + startFilePath: string | undefined + routerFilePath: string + framework: TanStackStartCoreOptions['framework'] + userFooter?: Array | (() => Array) +}): Array { + function getImportPath(absolutePath: string) { + let relativePath = path.relative( + path.dirname(opts.generatedRouteTreePath), + absolutePath, + ) + + if (!relativePath.startsWith('.')) { + relativePath = './' + relativePath + } + + return relativePath.split(path.sep).join('/') + } + + function appendFooterBlock(lines: Array, block: string) { + if (!block) { + return + } + + if (lines.length > 0) { + lines[lines.length - 1] += `\n${block}` + return + } + + lines.push(block) + } + + const footer: Array = [] + + appendFooterBlock( + footer, + `import type { getRouter } from '${getImportPath(opts.routerFilePath)}'`, + ) + + if (opts.startFilePath) { + appendFooterBlock( + footer, + `import type { startInstance } from '${getImportPath(opts.startFilePath)}'`, + ) + } else { + appendFooterBlock( + footer, + `import type { createStart } from '@tanstack/${opts.framework}-start'`, + ) + } + + appendFooterBlock( + footer, + `declare module '@tanstack/${opts.framework}-start' { + interface Register { + ssr: true + router: Awaited>`, + ) + + if (opts.startFilePath) { + appendFooterBlock( + footer, + ` config: Awaited>`, + ) + } + + appendFooterBlock( + footer, + ` } +}`, + ) + + if (opts.userFooter) { + footer.push( + ...(Array.isArray(opts.userFooter) ? opts.userFooter : opts.userFooter()), + ) + } + + return footer +} + +export function buildRouteTreeFileFooterFromConfig(opts: { + generatedRouteTreePath: string + getConfig: GetConfigFn + corePluginOpts: TanStackStartCoreOptions +}): Array { + const { startConfig, resolvedStartConfig } = opts.getConfig() + return buildRouteTreeFileFooter({ + generatedRouteTreePath: opts.generatedRouteTreePath, + startFilePath: resolvedStartConfig.startFilePath, + routerFilePath: resolvedStartConfig.routerFilePath, + framework: opts.corePluginOpts.framework, + userFooter: startConfig.router.routeTreeFileFooter, + }) +} diff --git a/packages/start-plugin-core/src/types.ts b/packages/start-plugin-core/src/types.ts index e2273d1a12..f0acdbfe35 100644 --- a/packages/start-plugin-core/src/types.ts +++ b/packages/start-plugin-core/src/types.ts @@ -1,20 +1,141 @@ +import type * as babel from '@babel/core' +import type * as t from '@babel/types' +import type { GeneratorResult } from '@tanstack/router-utils' import type { TanStackStartOutputConfig } from './schema' export type CompileStartFrameworkOptions = 'react' | 'solid' | 'vue' -export interface TanStackStartVitePluginCoreOptions { +export type ServerFnLookupAccess = { origin: 'client' } | { origin: 'server' } + +export type SerializationRuntime = 'client' | 'server' + +export interface SerializationAdapterModuleRef { + module: string + export: string + isFactory?: boolean +} + +export type SerializationAdapterByRuntime = Partial< + Record +> + +export type SerializationAdapterConfig = + | SerializationAdapterModuleRef + | SerializationAdapterByRuntime + +export type StartCompilerEnvironment = 'client' | 'server' + +export interface StartCompilerImportTransformImport { + libName: string + rootExport: string +} + +export interface StartCompilerTransformCandidate { + path: babel.NodePath +} + +export interface StartCompilerTransformContext { + readonly ast: t.File + readonly code: string + readonly id: string + readonly env: StartCompilerEnvironment + readonly envName: string + readonly mode: 'dev' | 'build' + readonly root: string + readonly framework: CompileStartFrameworkOptions + readonly providerEnvName: string + readonly types: typeof t + parseExpression: (code: string) => t.Expression +} + +export interface StartCompilerImportTransform { + name: string + environment?: + | StartCompilerEnvironment + | Array + | undefined + imports: Array + detect: RegExp + order?: 'pre' | 'post' | undefined + transform: ( + candidates: Array, + context: StartCompilerTransformContext, + ) => void +} + +export interface StartCompilerTransformResult { + code: string + map?: GeneratorResult['map'] | null +} + +export interface StartCompilerVirtualModuleContext { + readonly id: string + readonly root: string + readonly env: StartCompilerEnvironment + readonly envName: string + readonly code?: string +} + +export interface StartCompilerPlugin { + name: string + environment?: + | StartCompilerEnvironment + | Array + | undefined + detect?: RegExp | undefined + virtualModuleIdPattern?: RegExp | undefined + transformAst?: ( + context: StartCompilerTransformContext, + ) => boolean | null | undefined + loadVirtualModule?: ( + context: StartCompilerVirtualModuleContext, + ) => StartCompilerTransformResult | null + invalidateModule?: (context: { id: string; envName: string }) => void +} + +export interface NormalizedBasePaths { + publicBase: string + assetBase: { + dev: string + build: string + } +} + +export interface NormalizedOutputDirectories { + client: string + server: string +} + +export interface NormalizedClientChunk { + fileName: string + isEntry: boolean + imports: Array + dynamicImports: Array + css: Array + routeFilePaths: Array + hydrationIds: Array +} + +export interface NormalizedClientBuild { + entryChunkFileName: string + chunksByFileName: ReadonlyMap + chunkFileNamesByRouteFilePath: ReadonlyMap> + cssFilesBySourcePath: ReadonlyMap> + cssContentByFileName?: ReadonlyMap +} + +export interface TanStackStartCoreOptions { framework: CompileStartFrameworkOptions defaultEntryPaths: { client: string server: string start: string } - serverFn?: { - ssr?: { - getServerFnById?: string - } - providerEnv?: string - } + providerEnvironmentName: string + ssrIsProvider: boolean + serializationAdapters?: Array | undefined + compilerTransforms?: Array | undefined + serverFnProviderModuleDirectives?: ReadonlyArray | undefined } export interface ResolvedStartConfig { @@ -22,12 +143,11 @@ export interface ResolvedStartConfig { startFilePath: string | undefined routerFilePath: string srcDirectory: string - viteAppBase: string - serverFnProviderEnv: string + basePaths: NormalizedBasePaths + outputDirectories: NormalizedOutputDirectories } export type GetConfigFn = () => { startConfig: TanStackStartOutputConfig resolvedStartConfig: ResolvedStartConfig - corePluginOpts: TanStackStartVitePluginCoreOptions } diff --git a/packages/start-plugin-core/src/utils.ts b/packages/start-plugin-core/src/utils.ts index 5b0950604b..0569bf2efa 100644 --- a/packages/start-plugin-core/src/utils.ts +++ b/packages/start-plugin-core/src/utils.ts @@ -1,3 +1,9 @@ +import path from 'node:path' + +const isWindows: boolean = + typeof process !== 'undefined' && process.platform === 'win32' +const windowsSlashRE = /\\/g + /** Read `build.rollupOptions` or `build.rolldownOptions` from a build config. */ export function getBundlerOptions(build: any): any { return build?.rolldownOptions ?? build?.rollupOptions @@ -7,6 +13,14 @@ export function resolveViteId(id: string) { return `\0${id}` } +export function createIdFilter(ids: Array): RegExp { + return new RegExp(`^(?:${ids.map(escapeRegExp).join('|')})$`) +} + +export function escapeRegExp(value: string): string { + return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') +} + export function createLogger(prefix: string) { const label = `[${prefix}]` return { @@ -17,3 +31,11 @@ export function createLogger(prefix: string) { error: (...args: any) => console.error(label, ...args), } } + +function slash(path: string): string { + return path.replace(windowsSlashRE, '/') +} + +export function normalizePath(id: string): string { + return path.posix.normalize(isWindows ? slash(id) : id) +} diff --git a/packages/start-plugin-core/src/vite/createVirtualModule.ts b/packages/start-plugin-core/src/vite/createVirtualModule.ts new file mode 100644 index 0000000000..1c076a3c7c --- /dev/null +++ b/packages/start-plugin-core/src/vite/createVirtualModule.ts @@ -0,0 +1,50 @@ +import { createIdFilter, resolveViteId } from '../utils' +import type { Plugin } from 'vite' + +type VirtualModuleLoadHandler = ( + this: any, + id: string, +) => string | null | undefined | Promise + +export function createVirtualModule(opts: { + name: string + moduleId: string + load: VirtualModuleLoadHandler + apply?: Plugin['apply'] + applyToEnvironment?: Plugin['applyToEnvironment'] + enforce?: Plugin['enforce'] + sharedDuringBuild?: boolean +}): Plugin { + // Encode '#' as '%23' in the resolved ID to avoid browser treating it as URL fragment. + // The browser requests /@id/__x00__%23tanstack-start-plugin-adapters instead of + // /@id/__x00__#tanstack-start-plugin-adapters (which would truncate at #). + const resolvedId = resolveViteId(opts.moduleId.replaceAll('#', '%23')) + + return { + name: opts.name, + apply: opts.apply, + applyToEnvironment: opts.applyToEnvironment, + enforce: opts.enforce, + sharedDuringBuild: opts.sharedDuringBuild, + resolveId: { + filter: { id: createIdFilter([opts.moduleId]) }, + handler(id) { + if (id === opts.moduleId) { + return resolvedId + } + + return undefined + }, + }, + load: { + filter: { id: createIdFilter([resolvedId]) }, + handler(id) { + if (id !== resolvedId) { + return undefined + } + + return opts.load.call(this, id) + }, + }, + } +} diff --git a/packages/start-plugin-core/src/dev-server-plugin/dev-styles.ts b/packages/start-plugin-core/src/vite/dev-server-plugin/dev-styles.ts similarity index 100% rename from packages/start-plugin-core/src/dev-server-plugin/dev-styles.ts rename to packages/start-plugin-core/src/vite/dev-server-plugin/dev-styles.ts diff --git a/packages/start-plugin-core/src/dev-server-plugin/plugin.ts b/packages/start-plugin-core/src/vite/dev-server-plugin/plugin.ts similarity index 82% rename from packages/start-plugin-core/src/dev-server-plugin/plugin.ts rename to packages/start-plugin-core/src/vite/dev-server-plugin/plugin.ts index d507998109..18d3e54e2e 100644 --- a/packages/start-plugin-core/src/dev-server-plugin/plugin.ts +++ b/packages/start-plugin-core/src/vite/dev-server-plugin/plugin.ts @@ -1,28 +1,25 @@ import { isRunnableDevEnvironment } from 'vite' -import { VIRTUAL_MODULES } from '@tanstack/start-server-core' import { NodeRequest, sendNodeResponse } from 'srvx/node' -import { ENTRY_POINTS, VITE_ENVIRONMENT_NAMES } from '../constants' -import { resolveViteId } from '../utils' -import { extractHtmlScripts } from './extract-html-scripts' +import { ENTRY_POINTS, VITE_ENVIRONMENT_NAMES } from '../../constants' import { CSS_MODULES_REGEX, collectDevStyles, normalizeCssModuleCacheKey, } from './dev-styles' import type { Connect, DevEnvironment, PluginOption } from 'vite' -import type { GetConfigFn } from '../types' +import type { GetConfigFn } from '../../types' export function devServerPlugin({ - getConfig, + getConfig: _getConfig, devSsrStylesEnabled, + installDevServerMiddleware, }: { getConfig: GetConfigFn devSsrStylesEnabled: boolean + installDevServerMiddleware: boolean | undefined }): PluginOption { let isTest = false - let injectedHeadScripts: string | undefined - // Cache CSS modules content during transform hook. // For CSS modules, the transform hook receives the raw CSS content before // Vite wraps it in JS. We capture this to use during SSR style collection. @@ -43,22 +40,11 @@ export function devServerPlugin({ cssModulesCache[normalizeCssModuleCacheKey(id)] = code }, }, - async configureServer(viteDevServer) { + configureServer(viteDevServer) { if (isTest) { return } - // Extract the scripts that Vite plugins would inject into the initial HTML - const templateHtml = `` - const transformedHtml = await viteDevServer.transformIndexHtml( - '/', - templateHtml, - ) - const scripts = extractHtmlScripts(transformedHtml) - injectedHeadScripts = scripts - .flatMap((script) => script.content ?? []) - .join(';') - // CSS middleware registered in PRE-PHASE (before Vite's internal middlewares) // This ensures it handles /@tanstack-start/styles.css before any catch-all middleware // from other plugins (like nitro) that may be registered in the post-phase. @@ -121,6 +107,12 @@ export function devServerPlugin({ }) } + if (viteDevServer.config.experimental.bundledDev) { + // Vite's bundled dev client watches sources separately, but Start still + // needs the SSR environment's module graph to see route/server edits. + viteDevServer.watcher.add(viteDevServer.config.root) + } + return () => { const serverEnv = viteDevServer.environments[ VITE_ENVIRONMENT_NAMES.server @@ -131,9 +123,17 @@ export function devServerPlugin({ `Server environment ${VITE_ENVIRONMENT_NAMES.server} not found`, ) } + const clientEnv = viteDevServer.environments[ + VITE_ENVIRONMENT_NAMES.client + ] as + | { + devEngine?: { + ensureLatestBuildOutput?: () => Promise + } + } + | undefined - const { startConfig } = getConfig() - const installMiddleware = startConfig.vite?.installDevServerMiddleware + const installMiddleware = installDevServerMiddleware if (installMiddleware === false) { return } @@ -158,7 +158,6 @@ export function devServerPlugin({ 'cannot install vite dev server middleware for TanStack Start since the SSR environment is not a RunnableDevEnvironment', ) } - viteDevServer.middlewares.use(async (req, res) => { // fix the request URL to match the original URL // otherwise, the request URL will '/index.html' @@ -168,6 +167,8 @@ export function devServerPlugin({ const webReq = new NodeRequest({ req, res }) try { + const serverRunner = serverEnv.runner + // Import and resolve the request by running the server request entry point // this request entry point must implement the `fetch` API as follows: /** @@ -175,9 +176,13 @@ export function devServerPlugin({ * fetch(req: Request): Promise * } */ - const serverEntry = await serverEnv.runner.import( - ENTRY_POINTS.server, - ) + if (viteDevServer.config.experimental.bundledDev) { + await clientEnv?.devEngine?.ensureLatestBuildOutput?.() + serverEnv.moduleGraph.invalidateAll() + serverRunner.clearCache() + } + + const serverEntry = await serverRunner.import(ENTRY_POINTS.server) const webRes = await serverEntry['default'].fetch(webReq) return sendNodeResponse(res, webRes) @@ -247,27 +252,6 @@ export function devServerPlugin({ } }, }, - { - name: 'tanstack-start-core:dev-server:injected-head-scripts', - sharedDuringBuild: true, - applyToEnvironment: (env) => env.config.consumer === 'server', - resolveId: { - filter: { id: new RegExp(VIRTUAL_MODULES.injectedHeadScripts) }, - handler(_id) { - return resolveViteId(VIRTUAL_MODULES.injectedHeadScripts) - }, - }, - load: { - filter: { - id: new RegExp(resolveViteId(VIRTUAL_MODULES.injectedHeadScripts)), - }, - handler() { - const mod = ` - export const injectedHeadScripts = ${JSON.stringify(injectedHeadScripts) || 'undefined'}` - return mod - }, - }, - }, ] } diff --git a/packages/start-plugin-core/src/vite/import-protection-plugin/INTERNALS.md b/packages/start-plugin-core/src/vite/import-protection-plugin/INTERNALS.md new file mode 100644 index 0000000000..cd3beb7a4d --- /dev/null +++ b/packages/start-plugin-core/src/vite/import-protection-plugin/INTERNALS.md @@ -0,0 +1,578 @@ +# Vite Import Protection - Adapter Internals + +## Scope + +This document covers the Vite-specific orchestration around the shared +import-protection core in `src/import-protection/INTERNALS.md`. + +Vite owns: + +- `resolveId`-first violation discovery. +- Dev and build deferral decisions tied to Vite lifecycle hooks. +- Per-environment state that bridges resolve-time data with transform-time data. +- The transform-cache plugin and post-transform graph bookkeeping. +- Selective diagnostic sourcemap capture while transformed code is in plugin scope. +- Vite virtual-module id resolution and loading. +- Bundle-time survival checks in `generateBundle`. +- Opt-in perf counters and timings for this adapter. + +Shared AST analysis, rewrite logic, source extraction, mock export discovery, +usage lookup, source locations, and mock code generation live under +`src/import-protection`. + +## Plugin Shape + +`importProtectionPlugin()` returns two Vite plugins: + +1. `tanstack-start-core:import-protection` +2. `tanstack-start-core:import-protection-transform-cache` + +The first plugin owns resolve-time detection, virtual-module resolution, +reporting decisions, build survival checks, dev-server capture, HMR invalidation, +and perf flushing. + +The second plugin owns transformed-result caching, selective diagnostic sourcemap +capture, self-denial transforms, post-transform import graph updates, dev +pending-violation verification, and dev import rewrites. + +Both plugins use `applyToEnvironment()` and only run for Start environments: + +- `client` +- `ssr` +- the optional provider environment when it differs from `ssr` + +The adapter resolves client/server semantics from `config.envTypeMap`; Vite's +server environment is named `ssr`, but import protection reports it as the +`server` boundary. + +## Hook Filters + +The Vite adapter uses hook filters to reduce avoidable JS hook calls: + +- `resolveId.filter.id.exclude` skips most `\0` and `virtual:` ids, while still + allowing import-protection virtual ids through. +- `load.filter.id` only handles resolved import-protection virtual-module ids. +- `transform.filter.id.include` limits transform-cache work to JS/TS module ids + matching `/\.[cm]?[tj]sx?($|\?)/`. + +The runtime checks still keep defensive early returns for internal virtual ids +and out-of-scope importers. + +## Why Vite Uses Two Plugins + +Vite discovers many violations in `resolveId`, but accurate source locations and +post-transform graph truth require code that only exists later. + +The adapter splits responsibilities: + +- `resolveId` detects, classifies, defers or reports, records graph edges, and + substitutes mock ids where needed. +- The later transform hook caches plugin-input code, selectively captures + diagnostic sourcemaps, self-denies files, computes post-transform imports, and + processes pending violations. + +The transform-cache plugin runs after `enforce: 'pre'` hooks, including the Start +compiler. This means it sees the code as it enters this plugin after upstream +transforms, not the file read from disk. + +## State Model + +Per environment, Vite keeps `EnvState` with: + +- `graph`: an `ImportGraph` of source and post-transform edges. +- `mockExportsByImporter`: parsed export names for denied specifier mock modules. +- `resolveCache`: successful `this.resolve()` results keyed by importer/source. +- `resolveCacheByFile`: reverse index for invalidating resolve-cache keys. +- `importLocCache`: cached import-statement locations. +- `seenViolations`: dedupe state and retroactive-marker guard keys. +- `serverFnLookupModules`: modules known to be pre-transform lookup variants. +- `transformResultCache`: transformed code plus optional diagnostic sourcemap. +- `transformResultKeysByFile`: all cached ids for a physical file, including split variants. +- `transformResultProvider`: lookup facade used by diagnostic helpers. +- `postTransformImports`: resolved imports found after the Start compiler ran. +- `pendingViolations`: dev mock violations awaiting edge/reachability verification. +- `deferredBuildViolations`: build violations awaiting tree-shaking survival checks. + +Cross-environment shared state is intentionally small: + +- `fileMarkerKind`: normalized file path to `server` or `client` marker kind. + +This state model is larger than the Rsbuild adapter because Vite must bridge +resolve-time detection with later transform and bundle verification. + +## Lifecycle Hooks + +`configResolved` initializes adapter config from Vite and Start config: + +- root, command, bundled dev mode, and source directory. +- behavior, log mode, mock access mode, max trace depth, and `onViolation`. +- default and user import-protection rules compiled into matchers. +- marker specifiers for server-only and client-only modules. +- include, exclude, and ignored-importer matchers. + +`configureServer` stores the dev server so traces can fall back to Vite's +per-environment module graph on warm starts. + +`buildStart` clears bounded and unbounded caches, clears shared marker state, +and registers known Start entries for every configured environment. + +`hotUpdate` invalidates every file-scoped cache for changed modules: + +- extensionless absolute-id resolution. +- shared marker state for the file. +- import-location cache entries. +- resolve cache entries indexed by that file. +- import graph edges where the file is importer or resolved target. +- mock export cache for the file. +- server-fn lookup state for the file. +- pending violations for the file. +- transform-result cache entries and post-transform imports for all variants. + +`closeBundle` flushes cumulative opt-in perf output when perf collection is +enabled. + +## Detection Flow + +The Vite adapter is `resolveId`-driven. + +That means it may see violations before: + +- the Start compiler removes safe-boundary imports. +- tree-shaking removes false-positive edges. +- transformed importer code is available. + +For `resolveId` calls with no importer, the adapter records entry roots and then +flushes pending violations because reachability may now have new roots. In +bundled client dev, source entries inside `srcDirectory` are not added as entry +roots because that would make every source module appear reachable. + +For imported modules, `resolveId` does this in order: + +- Resolve import-protection virtual ids via `resolveInternalVirtualModuleId()`. +- Ignore unrelated `\0` and `virtual:` sources. +- Normalize the importer and classify direct `SERVER_FN_LOOKUP` resolves. +- In bundled client dev, add route modules under `src/routes` as source roots. +- Treat direct lookup modules, transitive lookup modules, and Vite scan resolves + as pre-transform resolves. +- Avoid recording source graph edges for server-fn lookup modules because those + variants contain uncompiled code. +- Detect marker imports before importer-scope checks so marker files can set + shared `fileMarkerKind`. +- Skip importers outside import-protection scope after marker handling. +- Check denied specifiers before resolving the import. +- Resolve imports through `this.resolve()` when needed, cache successful results, + and canonicalize resolved ids. +- Add graph edges for authoritative resolves when the importer is not a + server-fn lookup module. +- Check resolved file-denial rules and resolved marker-file conflicts. +- Dispatch violations through `reportOrDeferViolation()`. + +`this.resolve()` calls are counted and timed when perf collection is enabled. +Only successful resolves are cached; `null` results are not cached because they +can be order-dependent across importer variants such as split route ids. + +## Marker Handling + +Marker imports are imports of framework marker modules such as +`@tanstack/react-start/server-only` and `@tanstack/react-start/client-only`. + +When `resolveId` sees a marker import, it: + +- Records the normalized importer file in `shared.fileMarkerKind`. +- Throws immediately if a file has both server-only and client-only markers. +- Builds a marker violation if the current environment is the opposite boundary. +- Returns a marker virtual module for normal marker imports. +- In build mode, returns a unique build mock id for a deferred marker violation + so `generateBundle` can check whether the importer survived. + +Marker conflicts can also be discovered after resolving a normal import. If the +resolved target file was previously marked for the opposite environment, +`buildMarkerViolationFromResolvedImport()` creates the marker violation. + +Cold-start ordering can resolve module A importing module B before module B's +marker import has run. When B's marker is later recorded, the adapter +retroactively checks known importers in the graph, creates deferred marker +violations for matching importers, and immediately runs pending-violation +processing. + +## Deferral Policy + +The shared helper reduces to: + +```ts +shouldDefer = isBuild || isDevMock +``` + +Adapter meaning: + +- Dev plus error reports immediately for non-pre-transform resolves. +- Dev plus error silences pre-transform resolves because imports inside compiler + safe boundaries may not have been stripped yet, and there is no deferred + verification path in this mode. +- Dev plus mock stores `pendingViolations`, then verifies later with + post-transform edge survival and reachability. +- Build plus mock and build plus error store `deferredBuildViolations`, then + verify in `generateBundle` after tree-shaking. + +This is the main Vite-specific state machine difference from Rsbuild. + +## Lightweight Violations + +`buildViolationInfo()` creates a lightweight `ViolationInfo` record. + +The lightweight record contains: + +- environment name and boundary type. +- effective behavior. +- importer and specifier. +- violation type, pattern, and resolved path when known. +- an optional trace override. + +It intentionally does not compute expensive diagnostic data. + +Deferred work includes: + +- trace reconstruction. +- source-location lookup. +- code snippets. +- source-map mapping. +- AST usage analysis for the reported location. + +This work runs in `enrichViolationInfo()` only when a violation is about to be +emitted or passed to `onViolation`. Violations suppressed by edge survival, +reachability, or tree-shaking are never enriched. + +## Diagnostic Candidates + +A diagnostic candidate is a transformed module that is likely to need original +source diagnostics later. + +This is not a confirmed violation. It is only a cheap transform-time decision +about whether to capture the composed sourcemap while Vite/Rolldown still makes +`this.getCombinedSourcemap()` safely available. + +`shouldCaptureDiagnosticSourceMap()` returns `true` when the transformed code +contains import/export syntax and appears to reference import-protection inputs: + +- The code contains the opposite-boundary filename token, `.server` for client + environments or `.client` for server environments. +- The code contains any configured marker specifier. +- The code contains a literal denied specifier pattern. +- A custom non-literal specifier matcher is configured. +- A file matcher is a `RegExp` or does not contain the simple boundary token. + +The predicate intentionally does not parse import source literals with regexes. +For default rules, the fast path is substring checks for `import`/`export`, +`.server`, `.client`, marker specifiers, and default framework specifier strings. +For custom non-literal rules, it captures more broadly for modules with +import/export syntax rather than attempting a second import parser. + +`captureDiagnosticSourceMap()` is best effort: + +- It does nothing if the transform result already has a map. +- It calls `this.getCombinedSourcemap()` only for diagnostic candidates or a + confirmed dev mock file violation found during the transform import-resolution loop. +- It stores the map on the cached `TransformResult` when capture succeeds. +- It ignores capture failures; diagnostics then fall back to transformed-code + locations and snippets when possible. +- It records perf counters by reason, currently `candidate` and `devViolation`. + +The adapter does not read original files from disk for diagnostics. Original +source text comes only from the code and sourcemaps that reach this plugin. + +## Original Code And Snippets + +The transform cache stores transformed code for every in-scope transformed module +that is not self-denied. It stores a composed sourcemap only when selective +diagnostic capture succeeds. + +`sourceLocation` derives original code lazily: + +- `getOriginalCode()` reads `map.sourcesContent` only on demand. +- `pickOriginalCodeFromSourcesContent()` picks the best source by exact file, + resolved source path, suffix segment score, and finally the first source. +- `getOrCreateOriginalTransformResult()` creates an original-source transform + result only when original code exists. +- The derived original result is cached on the transform result. + +Importer locations prefer the most useful usage site rather than the import +statement. The lookup order is: + +1. First post-compile usage of the denied binding, mapped through the sourcemap. +2. Original-source unsafe usage from `sourcesContent`, excluding compiler-safe boundary callbacks. +3. Transformed import-statement location, mapped through the sourcemap. + +Before lookup, enrichment builds multiple source candidates from the original +specifier, resolved paths, root-relative paths, extensionless paths, and +importer-relative paths. + +When a location is found, diagnostics include a vitest-style `Code:` snippet +around that line. Snippets prefer original source from `sourcesContent` when it +is available. If original source is unavailable, snippets use transformed code. +If no location is found, the violation still reports without a snippet. + +## Trace Construction + +Trace construction is lazy and runs during enrichment. + +The adapter normally rebuilds traces from its own `ImportGraph`. In dev serve, +it may prefer Vite's per-environment `moduleGraph` when that graph produces a +longer trace. This helps warm-start cases where Vite skipped some `resolveId` +calls. + +Trace steps are annotated with import-statement locations from transformed-code +data when available. The leaf step falls back to the resolved importer location +if the trace did not already have a location. + +## Runtime Mock Diagnostics + +Dev client mocks can embed a runtime diagnostic payload in the virtual module +id. The payload includes: + +- environment name. +- importer. +- specifier. +- runtime mock access mode. +- the trace currently present on `ViolationInfo`. + +Because dev mock violations are substituted during silent deferral, the runtime +mock id is often created before lazy enrichment. Browser runtime diagnostics are +therefore access diagnostics, not the canonical source trace. The authoritative +trace and snippet are produced later when a pending violation is confirmed and +emitted to terminal output. + +Self-denial runtime mocks currently carry an empty trace payload because they are +created directly from the denied file's own transform. + +## Dev Strategy + +### Dev Plus Error + +Vite throws immediately for non-pre-transform violations in `resolveId`. + +This mode can still produce known false positives because there is no dev-server +tree-shaking phase. Pre-transform resolve paths like `SERVER_FN_LOOKUP` are +silenced because they fire before compiler stripping and have no later deferred +verification path in error mode. + +### Dev Plus Mock + +Vite defers all violations into `pendingViolations`. + +Later, the transform-cache plugin: + +1. Self-denies files when the transformed file itself violates file rules. +2. Caches transformed code and any selectively captured diagnostic sourcemap. +3. Resolves import sources from the transformed code. +4. Records `postTransformImports` for the normalized Vite id and physical file path. +5. Adds import graph edges from transformed-code imports for warm-start traces. +6. Maps import-protection mock-edge ids back to physical paths for edge survival. +7. Detects file violations missed by warm-start `resolveId` cache hits. +8. Rewrites denied imports to mock replacements in dev mock mode. +9. Runs `processPendingViolations()` after each transform-cache update. + +Pending verification uses edge survival and reachability. + +`filterEdgeSurvival()` returns: + +- `all-stripped` when post-transform imports prove every pending violation was removed. +- `await-transform` when pre-transform violations need transform data first. +- active violations plus whether edge-survival data was applied. + +`checkPostTransformReachability()` returns: + +- `reachable` when a live path reaches a registered entry. +- `unreachable` when all known live paths are cut off. +- `unknown` when some graph edges still lack transform data. + +In dev serve with `unknown` reachability, the adapter can conservatively emit +confirmed-surviving violations or in-scope file violations when pre-transform +data is not involved. + +Bundled client dev has a special case. After edge survival has proved an import +survived, the adapter uses source-graph reachability because child transforms can +run before their route/importer source edges are known. If bundled client dev +finds a surviving violation currently unreachable, it keeps the violation pending +instead of dropping it. + +## Build Strategy + +Vite build uses mock-first, verify-later behavior. + +At resolve time, `reportOrDeferViolation()` calls `handleViolation()` silently to +obtain the replacement id and stores a `DeferredBuildViolation`. + +Build replacements differ by violation type: + +- File violations return the physical resolved path; self-denial later replaces + that file's content. +- Specifier violations return a mock-edge virtual module whose payload references + a unique build mock runtime id. +- Marker violations return a mock-edge virtual module whose payload references a + unique build mock runtime id when the direct marker import violates the current + environment. + +At `generateBundle`, the adapter builds a set of module ids that survived +tree-shaking. It normalizes multiple forms for comparison: + +- raw bundle module id. +- normalized id with query/hash stripped. +- root-relative path. +- internal `\0` virtual id. +- browser `__x00__` virtual id. + +Survival checks differ by violation type: + +- File violations check whether the physical resolved path survived after + self-denial replaced that module's content. +- Specifier violations check whether the mock-edge module id survived. +- Marker violations check whether the importer survived, including all + transform-result variant ids for that importer. + +Only surviving violations are enriched. After `onViolation` allows them: + +- Build plus error fails on the first real surviving violation. +- Build plus mock warns once per dedupe key. +- Non-surviving violations are suppressed as tree-shaken false positives. + +## Self-Denial In Vite + +For file-based violations, `resolveId` does not return a virtual mock id. +Instead it returns the physical file path, and the transform-cache plugin +independently decides whether that file is denied in the current environment. + +This Vite-specific choice exists for two reasons: + +- It avoids cross-environment cache contamination in shared resolver caches. +- It avoids cold-start export-resolution issues when importer AST data is not + yet available. + +Self-denial runs before normal transform-result caching. + +Build self-denial returns a self-contained mock module generated from exports +parsed from the denied file's code. + +Dev self-denial returns a mock module generated from the denied file's exports. +For client-env self-denial with runtime mock access enabled, that mock references +a runtime diagnostic module. For server-env self-denial, or when mock access is +off, `mockRuntimeModuleIdFromViolation()` resolves to the silent mock module. +The runtime diagnostic id is built from the denied file itself and currently has +an empty trace payload. + +Because self-denial exits the transform hook early, self-denied files do not go +through the normal transform-result cache path for that environment. + +## Mock Export Resolution + +Specifier and marker mocks need explicit named exports so ESM imports continue +to link. + +`resolveExportsForDeniedSpecifier()` runs only while handling a violation. It +tries, in order: + +- cached export maps for the importer. +- transformed importer code from `transformResultProvider`. +- `ctx.getModuleInfo(importerIdHint)?.code` as a fallback. +- AST parsing through `getMockExportNamesBySource()`. +- resolver-based aliases that index source keys by resolved physical ids. + +The result is cached in `mockExportsByImporter` and used by `makeMockEdgeModuleId()`. + +## Virtual Modules + +The shared mock generators use abstract ids without Vite's resolved `\0` prefix, +such as: + +- `tanstack-start-import-protection:mock` +- `tanstack-start-import-protection:mock:build:` +- `tanstack-start-import-protection:mock-edge:` +- `tanstack-start-import-protection:mock-runtime:` +- `tanstack-start-import-protection:marker:` + +The Vite adapter adds: + +- a resolved `\0` prefix via `resolveViteId(...)`. +- browser-prefixed ids via `__x00__` for virtual ids that pass through browser import paths. +- `resolveInternalVirtualModuleId()` for normalizing import-protection virtual ids in `resolveId`. +- `loadResolvedVirtualModule()` for serving generated virtual module code in `load`. + +The generated module contents are shared. The id transport is Vite-specific. + +## Warm-Start Considerations + +Vite can skip `resolveId` on warm cache hits. + +The adapter compensates by: + +- caching transformed code under both normalized Vite id and physical file path. +- tracking all transform-result keys per physical file. +- resolving transformed import sources in the transform-cache plugin. +- recording post-transform imports for edge-survival checks. +- adding graph edges from transformed imports for trace accuracy. +- detecting dev mock file violations that `resolveId` missed on warm starts. +- falling back to Vite's module graph for longer dev traces. + +Pre-transform lookup variants are explicitly excluded from post-transform +liveness data because they contain uncompiled code. + +## Perf Instrumentation + +Perf collection is opt-in: + +```sh +TSR_IMPORT_PROTECTION_PERF=1 +TSR_IMPORT_PROTECTION_PERF=true +``` + +When enabled, the adapter records counters and timings for: + +- `resolveId` calls. +- transform-cache calls. +- `this.resolve()` calls from resolve and transform paths. +- transform import analysis. +- shared AST parsing performed by import analysis and diagnostic lookup. +- number of import sources found in transform-cache. +- violations detected. +- violations enriched. +- diagnostic sourcemap capture by reason. +- diagnostic sourcemap capture timing. + +Output is written as cumulative JSON to `TSR_IMPORT_PROTECTION_PERF_FILE` when +set. Without that file, output is logged on each `closeBundle()`. The payload +includes `flushCount` and `flushEnvironments` so multi-environment builds can be +checked for full coverage. + +When perf is disabled, the adapter only keeps a single `perf` variable that is +`undefined`; hot paths use optional chaining and do not allocate counters or +timers. + +## Diagnostic Visibility Tests + +The import-protection e2e suite parses terminal and build output to verify +violations, traces, and snippets. + +The suite checks: + +- Violations are parseable from logs. +- Build error output contains a trace. +- Warm dev traces include line numbers. +- Offending usage snippets are present for representative violations. +- Compiler-processed modules can still report original-source snippets when + sourcemap `sourcesContent` is captured. + +Browser runtime mock access diagnostics are separate from terminal diagnostics. +They should not be treated as carrying the enriched canonical trace or snippet +unless a test explicitly asserts that behavior. + +## Maintainer Rules + +When changing Vite import protection, ask: + +1. Is this really about Vite lifecycle timing or state? +2. If not, should it move into the shared import-protection core? +3. If yes, does it belong in resolve-time detection, transform-cache handling, + diagnostic enrichment, or bundle-time verification? +4. Does the change do avoidable source-map, AST, trace, or snippet work before a + violation is confirmed? +5. Does the change preserve the distinction between source graph evidence, + post-transform evidence, and bundle survival evidence? diff --git a/packages/start-plugin-core/src/import-protection-plugin/plugin.ts b/packages/start-plugin-core/src/vite/import-protection-plugin/plugin.ts similarity index 66% rename from packages/start-plugin-core/src/import-protection-plugin/plugin.ts rename to packages/start-plugin-core/src/vite/import-protection-plugin/plugin.ts index ed3bad7e73..55b98bec73 100644 --- a/packages/start-plugin-core/src/import-protection-plugin/plugin.ts +++ b/packages/start-plugin-core/src/vite/import-protection-plugin/plugin.ts @@ -1,34 +1,64 @@ +import { writeFileSync } from 'node:fs' import { normalizePath } from 'vite' +import { dirname, relative } from 'pathe' -import { resolveViteId } from '../utils' -import { VITE_ENVIRONMENT_NAMES } from '../constants' -import { ImportGraph, buildTrace, formatViolation } from './trace' +import { escapeRegExp, resolveViteId } from '../../utils' +import { VITE_ENVIRONMENT_NAMES } from '../../constants' +import { + ImportGraph, + buildTrace, + formatViolation, +} from '../../import-protection/trace' import { getDefaultImportProtectionRules, getMarkerSpecifiers, -} from './defaults' -import { compileMatchers, matchesAny } from './matchers' +} from '../../import-protection/defaults' +import { compileMatchers, matchesAny } from '../../import-protection/matchers' +import { + getImportProtectionEnvType, + getImportProtectionRelativePath, + getImportProtectionRulesForEnvironment, + shouldCheckImportProtectionImporter, +} from '../../import-protection/adapterUtils' import { buildResolutionCandidates, buildSourceCandidates, canonicalizeResolvedId, + checkFileDenial, clearNormalizeFilePathCache, debugLog, dedupePatterns, - escapeRegExp, - extractImportSources, + dedupeViolationKey, getOrCreate, + isFileExcluded, isInsideDirectory, matchesDebugFilter, normalizeFilePath, relativizePath, shouldDeferViolation, -} from './utils' +} from '../../import-protection/utils' import { - collectMockExportNamesBySource, - collectNamedExports, - rewriteDeniedImports, -} from './rewriteDeniedImports' + getImportSourcesFromResult, + getMockExportNamesBySource, + getNamedExports, +} from '../../import-protection/analysis' +import { rewriteDeniedImports } from '../../import-protection/rewrite' +import { ExtensionlessAbsoluteIdResolver } from '../../import-protection/extensionlessAbsoluteIdResolver' +import { + IMPORT_PROTECTION_DEBUG, + SERVER_FN_LOOKUP_QUERY, + VITE_BROWSER_VIRTUAL_PREFIX, +} from '../../import-protection/constants' +import { + ImportLocCache, + addTraceImportLocations, + buildCodeSnippet, + createImportSpecifierLocationIndex, + findImportStatementLocationFromTransformed, + findOriginalUsageLocation, + findPostCompileUsageLocation, + normalizeSourceMap, +} from '../../import-protection/sourceLocation' import { MOCK_BUILD_PREFIX, generateDevSelfDenialModule, @@ -40,30 +70,18 @@ import { resolveInternalVirtualModuleId, resolvedMarkerVirtualModuleId, } from './virtualModules' -import { ExtensionlessAbsoluteIdResolver } from './extensionlessAbsoluteIdResolver' -import { - IMPORT_PROTECTION_DEBUG, - SERVER_FN_LOOKUP_QUERY, - VITE_BROWSER_VIRTUAL_PREFIX, -} from './constants' -import { - ImportLocCache, - addTraceImportLocations, - buildCodeSnippet, - buildLineIndex, - findImportStatementLocationFromTransformed, - findPostCompileUsageLocation, - pickOriginalCodeFromSourcesContent, -} from './sourceLocation' import type { PluginOption, ViteDevServer } from 'vite' -import type { CompiledMatcher } from './matchers' -import type { Loc, TraceStep, ViolationInfo } from './trace' +import type { + Loc, + TraceStep, + ViolationInfo, +} from '../../import-protection/trace' import type { SourceMapLike, TransformResult, TransformResultProvider, -} from './sourceLocation' -import type { ImportProtectionOptions } from '../schema' +} from '../../import-protection/sourceLocation' +import type { ImportProtectionOptions } from '../../schema' import type { EnvRules, EnvState, @@ -78,38 +96,89 @@ import type { export type { ImportProtectionPluginOptions } from './types' +type PerfTiming = { + count: number + totalMs: number + maxMs: number +} + +type PerfCollector = { + count: (name: string, value?: number) => void + time: (name: string, startedAt: number) => void + flush: (root: string, envName: string) => void +} + +function isPerfEnabled(): boolean { + return ( + process.env.TSR_IMPORT_PROTECTION_PERF === '1' || + process.env.TSR_IMPORT_PROTECTION_PERF === 'true' + ) +} + +function createPerfCollector(): PerfCollector { + const counters = new Map() + const timings = new Map() + const flushEnvironments = new Set() + let flushCount = 0 + + return { + count(name, value = 1) { + counters.set(name, (counters.get(name) ?? 0) + value) + }, + time(name, startedAt) { + const duration = performance.now() - startedAt + const timing = timings.get(name) + if (timing) { + timing.count++ + timing.totalMs += duration + timing.maxMs = Math.max(timing.maxMs, duration) + } else { + timings.set(name, { count: 1, totalMs: duration, maxMs: duration }) + } + }, + flush(root, envName) { + flushCount++ + flushEnvironments.add(envName) + + const payload = { + root, + flushCount, + flushEnvironments: Array.from(flushEnvironments).sort(), + counters: Object.fromEntries(counters), + timings: Object.fromEntries( + Array.from(timings, ([name, timing]) => [ + name, + { + count: timing.count, + totalMs: Number(timing.totalMs.toFixed(3)), + avgMs: Number((timing.totalMs / timing.count).toFixed(3)), + maxMs: Number(timing.maxMs.toFixed(3)), + }, + ]), + ), + } + + const file = process.env.TSR_IMPORT_PROTECTION_PERF_FILE + if (file) { + writeFileSync(file, `${JSON.stringify(payload, null, 2)}\n`) + } else { + console.warn( + `[import-protection:perf] ${JSON.stringify(payload, null, 2)}`, + ) + } + }, + } +} + export function importProtectionPlugin( opts: ImportProtectionPluginOptions, ): PluginOption { let devServer: ViteDevServer | null = null + const perf = isPerfEnabled() ? createPerfCollector() : undefined const extensionlessIdResolver = new ExtensionlessAbsoluteIdResolver() const resolveExtensionlessAbsoluteId = (id: string) => extensionlessIdResolver.resolve(id) - - const importPatternCache = new Map>() - - function findFirstImportSpecifierIndex(code: string, source: string): number { - let patterns = importPatternCache.get(source) - if (!patterns) { - const escaped = escapeRegExp(source) - patterns = [ - new RegExp(`\\bimport\\s+(['"])${escaped}\\1`), - new RegExp(`\\bfrom\\s+(['"])${escaped}\\1`), - new RegExp(`\\bimport\\s*\\(\\s*(['"])${escaped}\\1\\s*\\)`), - ] - importPatternCache.set(source, patterns) - } - - let best = -1 - for (const re of patterns) { - const m = re.exec(code) - if (!m) continue - const idx = m.index + m[0].indexOf(source) - if (idx === -1) continue - if (best === -1 || idx < best) best = idx - } - return best - } + const importSpecifierLocationIndex = createImportSpecifierLocationIndex() /** * Build an import trace using Vite's per-environment module graph, which @@ -209,6 +278,7 @@ export function importProtectionPlugin( enabled: true, root: '', command: 'build', + bundledDev: false, srcDirectory: '', framework: opts.framework, effectiveBehavior: 'error', @@ -230,11 +300,90 @@ export function importProtectionPlugin( const envStates = new Map() const shared: SharedState = { fileMarkerKind: new Map() } + function shouldCaptureDiagnosticSourceMap( + code: string, + envType: 'client' | 'server', + matchers: EnvRules, + ): boolean { + const hasImportOrExport = code.includes('import') || code.includes('export') + if (!hasImportOrExport) { + return false + } + + const boundaryToken = envType === 'client' ? '.server' : '.client' + if (code.includes(boundaryToken)) { + return true + } + + for (const marker of config.markerSpecifiers.serverOnly) { + if (code.includes(marker)) { + return true + } + } + for (const marker of config.markerSpecifiers.clientOnly) { + if (code.includes(marker)) { + return true + } + } + + let needsSourceScan = false + for (const matcher of matchers.specifiers) { + if (matcher.literal !== undefined) { + if (code.includes(matcher.literal)) { + return true + } + continue + } + + needsSourceScan = true + } + + for (const matcher of matchers.files) { + if ( + matcher.pattern instanceof RegExp || + !matcher.pattern.includes(boundaryToken) + ) { + needsSourceScan = true + break + } + } + + // Custom non-literal rules cannot be checked with safe substring tests. + // Capture broadly for modules with import/export syntax rather than trying + // to parse import source literals with a regex. + return needsSourceScan + } + + function captureDiagnosticSourceMap( + result: TransformResult, + getCombinedSourcemap: () => SourceMapLike | null | undefined, + reason: string, + ): void { + if (result.map) { + return + } + + const startedAt = perf ? performance.now() : 0 + try { + const map = getCombinedSourcemap() + if (map) { + result.map = map + perf?.count(`sourcemap.captured.${reason}`) + } + } catch { + perf?.count(`sourcemap.captureFailed.${reason}`) + } finally { + if (perf) { + perf.time('sourcemap.capture', startedAt) + } + } + } + /** - * Build the best available trace for a module and enrich each step with - * line/column locations. Tries the plugin's own ImportGraph first, then - * Vite's moduleGraph (authoritative on warm start), keeping whichever is - * longer. Annotates the last step with the denied specifier + location. + * Build the best available source trace for a module and enrich each step + * with line/column locations. The plugin's own ImportGraph is preferred; + * Vite's moduleGraph is only a dev fallback for warm starts where Vite may + * skip resolveId for cached modules. * * Shared by {@link buildViolationInfo} and {@link processPendingViolations}. */ @@ -265,7 +414,7 @@ export function importProtectionPlugin( provider, trace, env.importLocCache, - findFirstImportSpecifierIndex, + importSpecifierLocationIndex.find, ) if (trace.length > 0) { @@ -281,17 +430,15 @@ export function importProtectionPlugin( } /** - * Build a complete {@link ViolationInfo} with trace, location, and snippet. + * Build a lightweight {@link ViolationInfo} record. * - * This is the single path that all violation types go through: specifier, - * file, and marker. + * Diagnostic-only work (trace, source-map lookup, snippets, AST usage + * analysis) is intentionally deferred until the violation is about to be + * reported. */ - async function buildViolationInfo( - provider: TransformResultProvider, - env: EnvState, + function buildViolationInfo( envName: string, envType: 'client' | 'server', - importer: string, normalizedImporter: string, source: string, overrides: Omit< @@ -306,68 +453,145 @@ export function importProtectionPlugin( | 'importerLoc' >, traceOverride?: Array, - ): Promise { - const sourceCandidates = buildSourceCandidates( - source, - 'resolved' in overrides && typeof overrides.resolved === 'string' - ? overrides.resolved - : undefined, - config.root, - ) - - const loc = await resolveImporterLocation( - provider, - env, - importer, - sourceCandidates, - ) - - const trace = await rebuildAndAnnotateTrace( - provider, - env, - envName, - normalizedImporter, - source, - loc, - traceOverride, - ) - - const snippet = loc ? buildCodeSnippet(provider, importer, loc) : undefined - + ): ViolationInfo { + perf?.count('violations.detected') return { env: envName, envType, behavior: config.effectiveBehavior, specifier: source, importer: normalizedImporter, - ...(loc ? { importerLoc: loc } : {}), - trace, - snippet, + trace: traceOverride ?? [], ...overrides, } } + async function enrichViolationInfo( + provider: TransformResultProvider, + env: EnvState, + envName: string, + envType: 'client' | 'server', + importer: string, + info: ViolationInfo, + traceOverride?: Array, + ): Promise { + const startedAt = perf ? performance.now() : 0 + perf?.count('violations.enriched') + + const resolved = info.resolved + const sourceCandidates = buildSourceCandidates( + info.specifier, + resolved, + config.root, + ) + addImporterRelativeSourceCandidates(sourceCandidates, importer, resolved) + + if (!info.importerLoc) { + const loc = await resolveImporterLocation( + provider, + env, + envType, + importer, + sourceCandidates, + ) + if (loc) { + info.importerLoc = loc + info.snippet = buildCodeSnippet( + provider, + importer, + loc, + undefined, + config.root, + ) + } + } else if (!info.snippet) { + info.snippet = buildCodeSnippet( + provider, + importer, + info.importerLoc, + undefined, + config.root, + ) + } + + if (traceOverride || info.trace.length === 0) { + info.trace = await rebuildAndAnnotateTrace( + provider, + env, + envName, + info.importer, + info.specifier, + info.importerLoc, + traceOverride, + ) + } + + if (perf) { + perf.time('violation.enrich', startedAt) + } + } + async function resolveImporterLocation( provider: TransformResultProvider, env: EnvState, + envType: 'client' | 'server', importer: string, sourceCandidates: Iterable, ): Promise { for (const candidate of sourceCandidates) { const loc = (await findPostCompileUsageLocation(provider, importer, candidate)) || + findOriginalUsageLocation( + provider, + importer, + candidate, + envType, + config.root, + ) || (await findImportStatementLocationFromTransformed( provider, importer, candidate, env.importLocCache, - findFirstImportSpecifierIndex, + importSpecifierLocationIndex.find, )) if (loc) return loc } return undefined } + function addImporterRelativeSourceCandidates( + candidates: Set, + importer: string, + resolved: string | undefined, + ): void { + if (!resolved) { + return + } + + const importerFile = normalizeFilePath(importer) + const resolvedFile = normalizeFilePath(resolved) + const relativeSource = normalizePath( + relative(dirname(importerFile), resolvedFile), + ) + + if (!relativeSource) { + return + } + + const importSource = relativeSource.startsWith('.') + ? relativeSource + : `./${relativeSource}` + + for (const candidate of buildSourceCandidates( + importSource, + undefined, + config.root, + )) { + candidates.add(candidate) + } + } + /** * Check if a resolved import violates marker restrictions (e.g. importing * a server-only module in the client env). If so, build and return the @@ -375,17 +599,14 @@ export function importProtectionPlugin( * * Returns `undefined` when the resolved import has no marker conflict. */ - async function buildMarkerViolationFromResolvedImport( - provider: TransformResultProvider, - env: EnvState, + function buildMarkerViolationFromResolvedImport( envName: string, envType: 'client' | 'server', importer: string, source: string, resolvedId: string, - relativePath: string, traceOverride?: Array, - ): Promise { + ): ViolationInfo | undefined { const normalizedResolvedId = normalizeFilePath(resolvedId) const markerKind = shared.fileMarkerKind.get(normalizedResolvedId) const violates = @@ -396,95 +617,43 @@ export function importProtectionPlugin( const normalizedImporter = normalizeFilePath(importer) return buildViolationInfo( - provider, - env, envName, envType, - importer, normalizedImporter, source, { type: 'marker', resolved: normalizedResolvedId, - message: buildMarkerViolationMessage(relativePath, markerKind), }, traceOverride, ) } - function buildMarkerViolationMessage( - relativePath: string, - markerKind: 'server' | 'client' | undefined, - ): string { - return markerKind === 'server' - ? `Module "${relativePath}" is marked server-only but is imported in the client environment` - : `Module "${relativePath}" is marked client-only but is imported in the server environment` - } - - async function buildFileViolationInfo( - provider: TransformResultProvider, - env: EnvState, + function buildFileViolationInfo( envName: string, envType: 'client' | 'server', - importer: string, normalizedImporter: string, source: string, resolvedPath: string, pattern: string | RegExp, traceOverride?: Array, - ): Promise { - const relativePath = getRelativePath(resolvedPath) - + ): ViolationInfo { return buildViolationInfo( - provider, - env, envName, envType, - importer, normalizedImporter, source, { type: 'file', pattern, resolved: resolvedPath, - message: `Import "${source}" (resolved to "${relativePath}") is denied in the ${envType} environment`, }, traceOverride, ) } - function getEnvType(envName: string): 'client' | 'server' { - return config.envTypeMap.get(envName) ?? 'server' - } - function getRulesForEnvironment(envName: string): EnvRules { - const type = getEnvType(envName) - return type === 'client' - ? config.compiledRules.client - : config.compiledRules.server - } - - /** - * Check if a relative path matches any denied file pattern for the given - * environment, respecting `excludeFiles`. Returns the matching pattern - * or `undefined` if the file is not denied. - */ - function checkFileDenial( - relativePath: string, - matchers: { - files: Array - excludeFiles: Array - }, - ): CompiledMatcher | undefined { - if ( - matchers.excludeFiles.length > 0 && - matchesAny(relativePath, matchers.excludeFiles) - ) { - return undefined - } - return matchers.files.length > 0 - ? matchesAny(relativePath, matchers.files) - : undefined + return getImportProtectionRulesForEnvironment(config, envName) as EnvRules } const environmentNames = new Set([ @@ -589,7 +758,11 @@ export function importProtectionPlugin( return [] try { - parsedBySource = collectMockExportNamesBySource(importerCode) + parsedBySource = getMockExportNamesBySource( + importerCode, + importerFile, + perf, + ) // Also index by resolved physical IDs so later lookups match. await recordMockExportsForImporter( @@ -680,18 +853,23 @@ export function importProtectionPlugin( if (namesBySource.size === 0) return + const resolvedAliases = new Map>() for (const [source, names] of namesBySource) { try { const resolvedId = await resolveSource(source) if (!resolvedId) continue - namesBySource.set(normalizeFilePath(resolvedId), names) - namesBySource.set(resolveExtensionlessAbsoluteId(resolvedId), names) + resolvedAliases.set(normalizeFilePath(resolvedId), names) + resolvedAliases.set(resolveExtensionlessAbsoluteId(resolvedId), names) } catch { // Best-effort only } } + for (const [source, names] of resolvedAliases) { + namesBySource.set(source, names) + } + const existing = env.mockExportsByImporter.get(importerFile) if (!existing) { env.mockExportsByImporter.set(importerFile, namesBySource) @@ -712,34 +890,15 @@ export function importProtectionPlugin( const shouldCheckImporterCache = new Map() function shouldCheckImporter(importer: string): boolean { - let result = shouldCheckImporterCache.get(importer) - if (result !== undefined) return result - - const relativePath = relativizePath(importer, config.root) - - // Excluded or ignored importers are never checked. - const excluded = - (config.excludeMatchers.length > 0 && - matchesAny(relativePath, config.excludeMatchers)) || - (config.ignoreImporterMatchers.length > 0 && - matchesAny(relativePath, config.ignoreImporterMatchers)) - - if (excluded) { - result = false - } else if (config.includeMatchers.length > 0) { - result = !!matchesAny(relativePath, config.includeMatchers) - } else if (config.srcDirectory) { - result = isInsideDirectory(importer, config.srcDirectory) - } else { - result = true - } - - shouldCheckImporterCache.set(importer, result) - return result + return shouldCheckImportProtectionImporter( + config, + importer, + shouldCheckImporterCache, + ) } function dedupeKey(info: ViolationInfo): string { - return `${info.type}:${info.importer}:${info.specifier}:${info.resolved ?? ''}` + return dedupeViolationKey(info) } function hasSeen(env: EnvState, key: string): boolean { @@ -750,7 +909,7 @@ export function importProtectionPlugin( } function getRelativePath(absolutePath: string): string { - return relativizePath(normalizePath(absolutePath), config.root) + return getImportProtectionRelativePath(config.root, absolutePath) } /** Reset all caches on an EnvState (called from buildStart). */ @@ -924,7 +1083,9 @@ export function importProtectionPlugin( while (qi < queue.length) { const current = queue[qi++]! - if (visited.has(current)) continue + if (visited.has(current)) { + continue + } visited.add(current) if (env.graph.entries.has(current)) { @@ -950,6 +1111,48 @@ export function importProtectionPlugin( return hasUnknownEdge ? 'unknown' : 'unreachable' } + function checkSourceGraphReachability( + env: EnvState, + file: string, + ): 'reachable' | 'unreachable' { + const visited = new Set() + const queue: Array = [file] + let qi = 0 + + while (qi < queue.length) { + const current = queue[qi++]! + if (visited.has(current)) { + continue + } + visited.add(current) + + if (env.graph.entries.has(current)) { + return 'reachable' + } + + const importers = env.graph.reverseEdges.get(current) + if (!importers) { + continue + } + + if (importers.size === 0) { + const routesDirectory = normalizePath(`${config.srcDirectory}/routes`) + if (current === file || isInsideDirectory(current, routesDirectory)) { + return 'reachable' + } + continue + } + + for (const [parent] of importers) { + if (!visited.has(parent)) { + queue.push(parent) + } + } + } + + return 'unreachable' + } + /** * Filter pending violations using edge-survival data. Returns the subset * of violations whose resolved import survived the Start compiler (or all @@ -1010,13 +1213,20 @@ export function importProtectionPlugin( if (filtered === 'await-transform') continue const { active, edgeSurvivalApplied } = filtered - + const isBundledClientDev = + config.command === 'serve' && + config.bundledDev && + active.some((pv) => pv.info.envType === 'client') // Wait for entries before running reachability. registerEntries() // populates entries at buildStart; resolveId(!importer) may add more. - const status = - env.graph.entries.size > 0 - ? checkPostTransformReachability(env, file) - : 'unknown' + let status: 'reachable' | 'unreachable' | 'unknown' + if (isBundledClientDev && edgeSurvivalApplied) { + status = checkSourceGraphReachability(env, file) + } else if (env.graph.entries.size > 0) { + status = checkPostTransformReachability(env, file) + } else { + status = 'unknown' + } if (status === 'reachable') { for (const pv of active) { @@ -1024,6 +1234,12 @@ export function importProtectionPlugin( } toDelete.push(file) } else if (status === 'unreachable') { + if (isBundledClientDev) { + // Bundled dev can transform a child before its route/importer has + // recorded the source edge. Keep confirmed-surviving violations + // pending until a real source importer makes them reachable. + continue + } toDelete.push(file) } else if (config.command === 'serve') { // 'unknown' reachability — some graph edges lack transform data. @@ -1062,44 +1278,18 @@ export function importProtectionPlugin( warnFn: (msg: string) => void, pv: PendingViolation, ): Promise { - if (!pv.info.importerLoc) { - const sourceCandidates = buildSourceCandidates( - pv.info.specifier, - pv.info.resolved, - config.root, - ) - const loc = await resolveImporterLocation( - env.transformResultProvider, - env, - pv.info.importer, - sourceCandidates, - ) - - if (loc) { - pv.info.importerLoc = loc - pv.info.snippet = buildCodeSnippet( - env.transformResultProvider, - pv.info.importer, - loc, - ) - } - } - if (hasSeen(env, dedupeKey(pv.info))) { return false } - const freshTrace = await rebuildAndAnnotateTrace( + await enrichViolationInfo( env.transformResultProvider, env, pv.info.env, + pv.info.envType, pv.info.importer, - pv.info.specifier, - pv.info.importerLoc, + pv.info, ) - if (freshTrace.length > pv.info.trace.length) { - pv.info.trace = freshTrace - } if (config.onViolation) { const result = await config.onViolation(pv.info) @@ -1137,6 +1327,15 @@ export function importProtectionPlugin( violationOpts?: { silent?: boolean }, ): Promise { if (!violationOpts?.silent) { + await enrichViolationInfo( + env.transformResultProvider, + env, + info.env, + info.envType, + importerIdHint ?? info.importer, + info, + ) + if (config.onViolation) { const result = await config.onViolation(info) if (result === false) return undefined @@ -1264,6 +1463,7 @@ export function importProtectionPlugin( configResolved(viteConfig) { config.root = viteConfig.root config.command = viteConfig.command + config.bundledDev = !!viteConfig.experimental.bundledDev const { startConfig, resolvedStartConfig } = opts.getConfig() config.srcDirectory = resolvedStartConfig.srcDirectory @@ -1354,7 +1554,6 @@ export function importProtectionPlugin( // Clear memoization caches that grow unboundedly across builds clearNormalizeFilePathCache() extensionlessIdResolver.clear() - importPatternCache.clear() shouldCheckImporterCache.clear() // Clear per-env caches @@ -1388,319 +1587,179 @@ export function importProtectionPlugin( } }, - async resolveId(source, importer, _options) { - const envName = this.environment.name - const env = getEnv(envName) - const envType = getEnvType(envName) - const provider = env.transformResultProvider - const isScanResolve = !!(_options as Record).scan + resolveId: { + filter: { + id: { + exclude: [ + /^\0(?!tanstack-start-import-protection:)/, + /^virtual:(?!tanstack-start-import-protection:)/, + ], + }, + }, + async handler(source, importer, _options) { + perf?.count('resolveId.calls') + const envName = this.environment.name + const env = getEnv(envName) + const envType = getImportProtectionEnvType(config, envName) + const isScanResolve = !!(_options as Record).scan - if (IMPORT_PROTECTION_DEBUG) { - const importerPath = importer - ? normalizeFilePath(importer) - : '(entry)' - const isEntryResolve = !importer - const filtered = - process.env.TSR_IMPORT_PROTECTION_DEBUG_FILTER === 'entry' - ? isEntryResolve - : matchesDebugFilter(source, importerPath) - if (filtered) { - debugLog('resolveId', { - env: envName, - envType, - source, - importer: importerPath, - isEntryResolve, - command: config.command, - }) - } - } - - // Internal virtual modules (mock:build:N, mock-edge, mock-runtime, marker) - const internalVirtualId = resolveInternalVirtualModuleId(source) - if (internalVirtualId) return internalVirtualId - - if (!importer) { - env.graph.addEntry(source) - // Flush pending violations now that an additional entry is known - // and reachability analysis may have new roots. - await processPendingViolations(env, this.warn.bind(this)) - return undefined - } - - if (source.startsWith('\0') || source.startsWith('virtual:')) { - return undefined - } - - const normalizedImporter = normalizeFilePath(importer) - const isDirectLookup = importer.includes(SERVER_FN_LOOKUP_QUERY) - - if (isDirectLookup) { - env.serverFnLookupModules.add(normalizedImporter) - } - - const isPreTransformResolve = - isDirectLookup || - env.serverFnLookupModules.has(normalizedImporter) || - isScanResolve - - // Dev mock mode: defer all violations (including pre-transform - // resolves) until post-transform data is available, then - // confirm/discard via graph reachability. - // Build mode (both mock and error): defer violations until - // generateBundle so tree-shaking can eliminate false positives. - const isDevMock = - config.command === 'serve' && config.effectiveBehavior === 'mock' - const isBuild = config.command === 'build' - const shouldDefer = shouldDeferViolation({ isBuild, isDevMock }) - - const resolveAgainstImporter = async (): Promise => { - const primary = await this.resolve(source, importer, { - skipSelf: true, - }) - if (primary) { - return canonicalizeResolvedId( - primary.id, - config.root, - resolveExtensionlessAbsoluteId, - ) - } - - return null - } - - // Check if this is a marker import - const markerKind = config.markerSpecifiers.serverOnly.has(source) - ? ('server' as const) - : config.markerSpecifiers.clientOnly.has(source) - ? ('client' as const) - : undefined - - if (markerKind) { - const existing = shared.fileMarkerKind.get(normalizedImporter) - if (existing && existing !== markerKind) { - this.error( - `[import-protection] File "${getRelativePath(normalizedImporter)}" has both server-only and client-only markers. This is not allowed.`, - ) - } - shared.fileMarkerKind.set(normalizedImporter, markerKind) - - const violatesEnv = - (envType === 'client' && markerKind === 'server') || - (envType === 'server' && markerKind === 'client') - - if (violatesEnv) { - const info = await buildViolationInfo( - provider, - env, - envName, - envType, - importer, - normalizedImporter, - source, - { - type: 'marker', - message: buildMarkerViolationMessage( - getRelativePath(normalizedImporter), - markerKind, - ), - }, - ) - const markerResult = await reportOrDeferViolation( - this, - env, - normalizedImporter, - importer, - info, - shouldDefer, - isPreTransformResolve, - ) - - // In build mode, if the violation was deferred, return the unique - // build mock ID instead of the marker module. This lets - // generateBundle check whether the importer (and thus its marker - // import) survived tree-shaking. The mock is side-effect-free just - // like the marker module, and the bare import has no bindings, so - // replacing it is transparent. - if (isBuild && markerResult != null) { - return markerResult + if (IMPORT_PROTECTION_DEBUG) { + const importerPath = importer + ? normalizeFilePath(importer) + : '(entry)' + const isEntryResolve = !importer + const filtered = + process.env.TSR_IMPORT_PROTECTION_DEBUG_FILTER === 'entry' + ? isEntryResolve + : matchesDebugFilter(source, importerPath) + if (filtered) { + debugLog('resolveId', { + env: envName, + envType, + source, + importer: importerPath, + isEntryResolve, + command: config.command, + }) } } - // Retroactive marker violation detection: on cold starts, module - // A may import module B before B's marker is set (because B hasn't - // been processed yet). When B's marker is set (here), - // retroactively check all known importers of B in the graph and - // create deferred marker violations for them. Without this, - // cold-start ordering can miss marker violations that warm starts - // detect (warm starts see markers early from cached transforms). - // - // Uses lightweight `deferViolation` to avoid heavy side effects - // (mock module creation, export resolution). Immediately calls - // `processPendingViolations` to flush the deferred violations, - // because the marker resolveId fires during Vite's import - // analysis (after our transform hook) — there may be no - // subsequent transform invocation to flush them. - // - // Guarded by `violatesEnv` (per-environment) plus a per-env - // seen-set. The marker is shared across environments but each - // env's graph has its own edges; this ensures the check runs - // at most once per (env, module) pair. - const envRetroKey = `retro-marker:${normalizedImporter}` - if (violatesEnv && !env.seenViolations.has(envRetroKey)) { - env.seenViolations.add(envRetroKey) - let retroDeferred = false - const importersMap = env.graph.reverseEdges.get(normalizedImporter) - if (importersMap && importersMap.size > 0) { - for (const [importerFile, specifier] of importersMap) { - if (!specifier) continue - if (!shouldCheckImporter(importerFile)) continue - const markerInfo = await buildMarkerViolationFromResolvedImport( - provider, - env, - envName, - envType, - importerFile, - specifier, - normalizedImporter, - getRelativePath(normalizedImporter), - ) - if (markerInfo) { - deferViolation( - env, - importerFile, - markerInfo, - isPreTransformResolve, - ) - retroDeferred = true - } + // Internal virtual modules (mock:build:N, mock-edge, mock-runtime, marker) + const internalVirtualId = resolveInternalVirtualModuleId(source) + if (internalVirtualId) return internalVirtualId + + if (!importer) { + const normalizedSource = normalizeFilePath(source) + const isBundledClientSourceEntry = + config.command === 'serve' && + config.bundledDev && + envType === 'client' && + isInsideDirectory(normalizedSource, config.srcDirectory) + + if (!isBundledClientSourceEntry) { + env.graph.addEntry(source) + } + // Flush pending violations now that an additional entry is known + // and reachability analysis may have new roots. + await processPendingViolations(env, this.warn.bind(this)) + return undefined + } + + if (source.startsWith('\0') || source.startsWith('virtual:')) { + return undefined + } + + const normalizedImporter = normalizeFilePath(importer) + const isDirectLookup = importer.includes(SERVER_FN_LOOKUP_QUERY) + const isBundledClientDev = + config.command === 'serve' && + config.bundledDev && + envType === 'client' + + if (isBundledClientDev) { + const routesDirectory = normalizePath( + `${config.srcDirectory}/routes`, + ) + if (isInsideDirectory(normalizedImporter, routesDirectory)) { + env.graph.addEntry(normalizedImporter) + } + } + + if (isDirectLookup) { + env.serverFnLookupModules.add(normalizedImporter) + } + + const isServerFnPreTransformResolve = + isDirectLookup || env.serverFnLookupModules.has(normalizedImporter) + const isPreTransformResolve = + isServerFnPreTransformResolve || isScanResolve + const shouldRecordGraphEdge = !isServerFnPreTransformResolve + + // Dev mock mode: defer all violations (including pre-transform + // resolves) until post-transform data is available, then + // confirm/discard via graph reachability. + // Build mode (both mock and error): defer violations until + // generateBundle so tree-shaking can eliminate false positives. + const isDevMock = + config.command === 'serve' && config.effectiveBehavior === 'mock' + const isBuild = config.command === 'build' + const shouldDefer = shouldDeferViolation({ isBuild, isDevMock }) + + type PluginResolveResult = NonNullable< + Awaited> + > + + const resolveAgainstImporter = async (): Promise<{ + id: string + result: PluginResolveResult + } | null> => { + const startedAt = perf ? performance.now() : 0 + perf?.count('thisResolve.calls') + let primary: PluginResolveResult | null = null + try { + const resolveOptions: Parameters[2] = { + custom: _options.custom, + isEntry: _options.isEntry, + skipSelf: true, + } + if ('attributes' in _options) { + const resolveOptionsWithAttributes = + resolveOptions as typeof resolveOptions & { + attributes?: unknown + } + resolveOptionsWithAttributes.attributes = _options.attributes + } + primary = await this.resolve(source, importer, resolveOptions) + } finally { + if (perf) { + perf.time('thisResolve', startedAt) } } - if (retroDeferred) { - await processPendingViolations(env, this.warn.bind(this)) + if (primary) { + return { + id: canonicalizeResolvedId( + primary.id, + config.root, + resolveExtensionlessAbsoluteId, + ), + result: primary, + } } + + return null } - return markerKind === 'server' - ? resolvedMarkerVirtualModuleId('server') - : resolvedMarkerVirtualModuleId('client') - } + // Check if this is a marker import + const markerKind = config.markerSpecifiers.serverOnly.has(source) + ? ('server' as const) + : config.markerSpecifiers.clientOnly.has(source) + ? ('client' as const) + : undefined - // Check if the importer is within our scope - if (!shouldCheckImporter(normalizedImporter)) { - return undefined - } - - const matchers = getRulesForEnvironment(envName) - - // 1. Specifier-based denial - const specifierMatch = matchesAny(source, matchers.specifiers) - if (specifierMatch) { - if (!isPreTransformResolve) { - env.graph.addEdge(source, normalizedImporter, source) - } - const info = await buildViolationInfo( - provider, - env, - envName, - envType, - importer, - normalizedImporter, - source, - { - type: 'specifier', - pattern: specifierMatch.pattern, - message: `Import "${source}" is denied in the ${envType} environment`, - }, - ) - - // Resolve the specifier so edge-survival can verify whether - // the import survives the Start compiler transform (e.g. - // factory-safe pattern strips imports inside .server() callbacks). - if (shouldDefer && !info.resolved) { - try { - const resolvedForInfo = await resolveAgainstImporter() - if (resolvedForInfo) info.resolved = resolvedForInfo - } catch { - // Non-fatal: edge-survival will skip unresolved specifiers + if (markerKind) { + const existing = shared.fileMarkerKind.get(normalizedImporter) + if (existing && existing !== markerKind) { + this.error( + `[import-protection] File "${getRelativePath(normalizedImporter)}" has both server-only and client-only markers. This is not allowed.`, + ) } - } + shared.fileMarkerKind.set(normalizedImporter, markerKind) - return reportOrDeferViolation( - this, - env, - normalizedImporter, - importer, - info, - shouldDefer, - isPreTransformResolve, - ) - } + const violatesEnv = + (envType === 'client' && markerKind === 'server') || + (envType === 'server' && markerKind === 'client') - // 2. Resolve the import (cached) - const cacheKey = `${normalizedImporter}:${source}` - let resolved: string | null - - if (env.resolveCache.has(cacheKey)) { - resolved = env.resolveCache.get(cacheKey) ?? null - } else { - resolved = await resolveAgainstImporter() - - // Only cache successful resolves. Null resolves can be - // order-dependent across importer variants (e.g. code-split - // `?tsr-split=...` ids) and may poison later lookups. - if (resolved !== null) { - env.resolveCache.set(cacheKey, resolved) - getOrCreate( - env.resolveCacheByFile, - normalizedImporter, - () => new Set(), - ).add(cacheKey) - } - } - - if (resolved) { - const relativePath = getRelativePath(resolved) - - // Propagate pre-transform status transitively - if (isPreTransformResolve && !isScanResolve) { - env.serverFnLookupModules.add(resolved) - } - - if (!isPreTransformResolve) { - env.graph.addEdge(resolved, normalizedImporter, source) - } - - // Skip file-based and marker-based denial for resolved paths that - // match the per-environment `excludeFiles` patterns. By default - // this includes `**/node_modules/**` so that third-party packages - // using `.client.` / `.server.` in their filenames (e.g. react-tweet - // exports `index.client.js`) are not treated as user-authored - // environment boundaries. Users can override `excludeFiles` per - // environment to narrow or widen this exclusion. - const isExcludedFile = - matchers.excludeFiles.length > 0 && - matchesAny(relativePath, matchers.excludeFiles) - - if (!isExcludedFile) { - const fileMatch = - matchers.files.length > 0 - ? matchesAny(relativePath, matchers.files) - : undefined - - if (fileMatch) { - const info = await buildFileViolationInfo( - provider, - env, + if (violatesEnv) { + const info = buildViolationInfo( envName, envType, - importer, normalizedImporter, source, - resolved, - fileMatch.pattern, + { + type: 'marker', + }, ) - return reportOrDeferViolation( + const markerResult = await reportOrDeferViolation( this, env, normalizedImporter, @@ -1709,33 +1768,222 @@ export function importProtectionPlugin( shouldDefer, isPreTransformResolve, ) + + // In build mode, if the violation was deferred, return the unique + // build mock ID instead of the marker module. This lets + // generateBundle check whether the importer (and thus its marker + // import) survived tree-shaking. The mock is side-effect-free just + // like the marker module, and the bare import has no bindings, so + // replacing it is transparent. + if (isBuild && markerResult != null) { + return markerResult + } } - const markerInfo = await buildMarkerViolationFromResolvedImport( - provider, - env, + // Retroactive marker violation detection: on cold starts, module + // A may import module B before B's marker is set (because B hasn't + // been processed yet). When B's marker is set (here), + // retroactively check all known importers of B in the graph and + // create deferred marker violations for them. Without this, + // cold-start ordering can miss marker violations that warm starts + // detect (warm starts see markers early from cached transforms). + // + // Uses lightweight `deferViolation` to avoid heavy side effects + // (mock module creation, export resolution). Immediately calls + // `processPendingViolations` to flush the deferred violations, + // because the marker resolveId fires during Vite's import + // analysis (after our transform hook) — there may be no + // subsequent transform invocation to flush them. + // + // Guarded by `violatesEnv` (per-environment) plus a per-env + // seen-set. The marker is shared across environments but each + // env's graph has its own edges; this ensures the check runs + // at most once per (env, module) pair. + const envRetroKey = `retro-marker:${normalizedImporter}` + if (violatesEnv && !env.seenViolations.has(envRetroKey)) { + env.seenViolations.add(envRetroKey) + let retroDeferred = false + const importersMap = + env.graph.reverseEdges.get(normalizedImporter) + if (importersMap && importersMap.size > 0) { + for (const [importerFile, specifier] of importersMap) { + if (!specifier) continue + if (!shouldCheckImporter(importerFile)) continue + const markerInfo = buildMarkerViolationFromResolvedImport( + envName, + envType, + importerFile, + specifier, + normalizedImporter, + ) + if (markerInfo) { + deferViolation( + env, + importerFile, + markerInfo, + isPreTransformResolve, + ) + retroDeferred = true + } + } + } + if (retroDeferred) { + await processPendingViolations(env, this.warn.bind(this)) + } + } + + return markerKind === 'server' + ? resolvedMarkerVirtualModuleId('server') + : resolvedMarkerVirtualModuleId('client') + } + + // Check if the importer is within our scope + if (!shouldCheckImporter(normalizedImporter)) { + return undefined + } + + const matchers = getRulesForEnvironment(envName) + + // 1. Specifier-based denial + const specifierMatch = matchesAny(source, matchers.specifiers) + if (specifierMatch) { + if (shouldRecordGraphEdge) { + env.graph.addEdge(source, normalizedImporter, source) + } + const info = buildViolationInfo( envName, envType, - importer, + normalizedImporter, source, - resolved, - relativePath, + { + type: 'specifier', + pattern: specifierMatch.pattern, + }, ) - if (markerInfo) { - return reportOrDeferViolation( - this, - env, + + // Resolve the specifier so edge-survival can verify whether + // the import survives the Start compiler transform (e.g. + // factory-safe pattern strips imports inside .server() callbacks). + if (shouldDefer && !info.resolved) { + try { + const resolvedForInfo = await resolveAgainstImporter() + if (resolvedForInfo) { + info.resolved = resolvedForInfo.id + } + } catch { + // Non-fatal: edge-survival will skip unresolved specifiers + } + } + + return reportOrDeferViolation( + this, + env, + normalizedImporter, + importer, + info, + shouldDefer, + isPreTransformResolve, + ) + } + + // 2. Resolve the import (cached) + const cacheKey = `${normalizedImporter}:${source}` + let resolved: string | null + let passThroughResult: PluginResolveResult | null = null + + if (env.resolveCache.has(cacheKey)) { + resolved = env.resolveCache.get(cacheKey) ?? null + } else { + const resolution = await resolveAgainstImporter() + resolved = resolution?.id ?? null + passThroughResult = resolution?.result ?? null + + // Only cache successful resolves. Null resolves can be + // order-dependent across importer variants (e.g. code-split + // `?tsr-split=...` ids) and may poison later lookups. + if (resolved !== null) { + env.resolveCache.set(cacheKey, resolved) + getOrCreate( + env.resolveCacheByFile, normalizedImporter, - importer, - markerInfo, - shouldDefer, - isPreTransformResolve, - ) + () => new Set(), + ).add(cacheKey) } } - } - return undefined + if (resolved) { + const relativePath = getRelativePath(resolved) + + // Propagate pre-transform status transitively + if (isServerFnPreTransformResolve) { + env.serverFnLookupModules.add(resolved) + } + + if (shouldRecordGraphEdge) { + env.graph.addEdge(resolved, normalizedImporter, source) + } + + // Skip file-based and marker-based denial for resolved paths that + // match the per-environment `excludeFiles` patterns. By default + // this includes `**/node_modules/**` so that third-party packages + // using `.client.` / `.server.` in their filenames (e.g. react-tweet + // exports `index.client.js`) are not treated as user-authored + // environment boundaries. Users can override `excludeFiles` per + // environment to narrow or widen this exclusion. + const isExcludedFile = isFileExcluded(relativePath, matchers) + + if (!isExcludedFile) { + const fileMatch = matchers.files.find((matcher) => + matcher.test(relativePath), + ) + + if (fileMatch) { + const info = buildFileViolationInfo( + envName, + envType, + normalizedImporter, + source, + resolved, + fileMatch.pattern, + ) + return reportOrDeferViolation( + this, + env, + normalizedImporter, + importer, + info, + shouldDefer, + isPreTransformResolve, + ) + } + + const markerInfo = buildMarkerViolationFromResolvedImport( + envName, + envType, + importer, + source, + resolved, + ) + if (markerInfo) { + return reportOrDeferViolation( + this, + env, + normalizedImporter, + importer, + markerInfo, + shouldDefer, + isPreTransformResolve, + ) + } + } + + if (passThroughResult) { + return passThroughResult + } + } + + return undefined + }, }, load: { @@ -1845,6 +2093,15 @@ export function importProtectionPlugin( if (!survived) continue + await enrichViolationInfo( + env.transformResultProvider, + env, + info.env, + info.envType, + info.importer, + info, + ) + if (config.onViolation) { const result = await config.onViolation(info) if (result === false) continue @@ -1870,6 +2127,13 @@ export function importProtectionPlugin( } } }, + + closeBundle() { + const envName = this.environment.name + perf?.count('closeBundle.calls') + perf?.count(`closeBundle.env.${envName}`) + perf?.flush(config.root, envName) + }, }, { // Captures transformed code + composed sourcemap for location mapping. @@ -1889,9 +2153,10 @@ export function importProtectionPlugin( }, }, async handler(code, id) { + perf?.count('transform.calls') const envName = this.environment.name const file = normalizeFilePath(id) - const envType = getEnvType(envName) + const envType = getImportProtectionEnvType(config, envName) const matchers = getRulesForEnvironment(envName) const isBuild = config.command === 'build' @@ -1930,7 +2195,7 @@ export function importProtectionPlugin( // Falls back to empty list on non-standard syntax. let exportNames: Array = [] try { - exportNames = collectNamedExports(code) + exportNames = getNamedExports(code, file, perf) } catch { // Parsing may fail on non-standard syntax } @@ -1952,7 +2217,6 @@ export function importProtectionPlugin( specifier: relativizePath(file, config.root), resolved: file, pattern: selfFileMatch.pattern, - message: `File "${relativizePath(file, config.root)}" is denied in the ${envType} environment`, trace: [], }, config.mockAccess, @@ -1961,24 +2225,6 @@ export function importProtectionPlugin( return generateDevSelfDenialModule(exportNames, runtimeId) } - // getCombinedSourcemap() returns the composed sourcemap - let map: SourceMapLike | undefined - try { - map = this.getCombinedSourcemap() - } catch { - map = undefined - } - - let originalCode: string | undefined - if (map?.sourcesContent) { - originalCode = pickOriginalCodeFromSourcesContent( - map, - file, - config.root, - ) - } - - const lineIndex = buildLineIndex(code) const cacheKey = normalizePath(id) const envState = getEnv(envName) @@ -1991,10 +2237,23 @@ export function importProtectionPlugin( const result: TransformResult = { code, - map, - originalCode, - lineIndex, + filename: file, + map: undefined, + originalCode: undefined, } + + if (perf) { + result.perf = perf + } + + if (shouldCaptureDiagnosticSourceMap(code, envType, matchers)) { + captureDiagnosticSourceMap( + result, + () => this.getCombinedSourcemap(), + 'candidate', + ) + } + cacheTransformResult(envState, file, cacheKey, result) // Build mode: only self-denial (above) and transform caching are @@ -2009,12 +2268,22 @@ export function importProtectionPlugin( // Dev mode: resolve imports, populate graph, detect violations, // and rewrite denied imports. const isDevMock = config.effectiveBehavior === 'mock' - const importSources = extractImportSources(code) + const importAnalysisStartedAt = perf ? performance.now() : 0 + const importSources = getImportSourcesFromResult(result) + if (perf) { + perf.time('transform.importAnalysis', importAnalysisStartedAt) + } + perf?.count('transform.importSources', importSources.length) const resolvedChildren = new Set() const deniedSourceReplacements = new Map() for (const src of importSources) { try { + const startedAt = perf ? performance.now() : 0 + perf?.count('transform.thisResolve.calls') const resolved = await this.resolve(src, id, { skipSelf: true }) + if (perf) { + perf.time('transform.thisResolve', startedAt) + } if (resolved && !resolved.external) { const resolvedPath = canonicalizeResolvedId( resolved.id, @@ -2057,12 +2326,15 @@ export function importProtectionPlugin( const fileMatch = checkFileDenial(relativePath, matchers) if (fileMatch) { - const info = await buildFileViolationInfo( - envState.transformResultProvider, - envState, + captureDiagnosticSourceMap( + result, + () => this.getCombinedSourcemap(), + 'devViolation', + ) + + const info = buildFileViolationInfo( envName, envType, - id, file, src, resolvedPath, @@ -2116,14 +2388,7 @@ export function importProtectionPlugin( } const normalizedMap = rewritten.map - ? { - ...rewritten.map, - version: Number(rewritten.map.version), - sourcesContent: - rewritten.map.sourcesContent?.map( - (s: string | null) => s ?? '', - ) ?? [], - } + ? normalizeSourceMap(rewritten.map) : { version: 3, file: id, diff --git a/packages/start-plugin-core/src/import-protection-plugin/types.ts b/packages/start-plugin-core/src/vite/import-protection-plugin/types.ts similarity index 90% rename from packages/start-plugin-core/src/import-protection-plugin/types.ts rename to packages/start-plugin-core/src/vite/import-protection-plugin/types.ts index e5058c9e00..21691783ea 100644 --- a/packages/start-plugin-core/src/import-protection-plugin/types.ts +++ b/packages/start-plugin-core/src/vite/import-protection-plugin/types.ts @@ -1,12 +1,12 @@ -import type { CompileStartFrameworkOptions, GetConfigFn } from '../types' -import type { ImportProtectionBehavior } from '../schema' -import type { CompiledMatcher } from './matchers' -import type { ImportGraph, ViolationInfo } from './trace' +import type { CompileStartFrameworkOptions, GetConfigFn } from '../../types' +import type { ImportProtectionBehavior } from '../../schema' +import type { CompiledMatcher } from '../../import-protection/matchers' +import type { ImportGraph, ViolationInfo } from '../../import-protection/trace' import type { ImportLocCache, TransformResult, TransformResultProvider, -} from './sourceLocation' +} from '../../import-protection/sourceLocation' /** Compiled deny/exclude patterns for one environment (client or server). */ export interface EnvRules { @@ -19,6 +19,7 @@ export interface PluginConfig { enabled: boolean root: string command: 'build' | 'serve' + bundledDev: boolean srcDirectory: string framework: CompileStartFrameworkOptions effectiveBehavior: ImportProtectionBehavior diff --git a/packages/start-plugin-core/src/vite/import-protection-plugin/virtualModules.ts b/packages/start-plugin-core/src/vite/import-protection-plugin/virtualModules.ts new file mode 100644 index 0000000000..d27612c38b --- /dev/null +++ b/packages/start-plugin-core/src/vite/import-protection-plugin/virtualModules.ts @@ -0,0 +1,122 @@ +import { resolveViteId } from '../../utils' +import { + MARKER_PREFIX, + MOCK_BUILD_PREFIX, + MOCK_EDGE_PREFIX, + MOCK_MODULE_ID, + MOCK_RUNTIME_PREFIX, + RUNTIME_SUGGESTION_TEXT, + generateDevSelfDenialModule, + generateSelfContainedMockModule, + loadMarkerModule, + loadMockEdgeModule, + loadMockRuntimeModule, + loadSilentMockModule, + makeMockEdgeModuleId, + mockRuntimeModuleIdFromViolation, +} from '../../import-protection/virtualModules' +import { VITE_BROWSER_VIRTUAL_PREFIX } from '../../import-protection/constants' + +const RESOLVED_MOCK_MODULE_ID = resolveViteId(MOCK_MODULE_ID) +const RESOLVED_MOCK_BUILD_PREFIX = resolveViteId(MOCK_BUILD_PREFIX) +const RESOLVED_MOCK_EDGE_PREFIX = resolveViteId(MOCK_EDGE_PREFIX) +const RESOLVED_MOCK_RUNTIME_PREFIX = resolveViteId(MOCK_RUNTIME_PREFIX) +const RESOLVED_MARKER_PREFIX = resolveViteId(MARKER_PREFIX) +const RESOLVED_MARKER_SERVER_ONLY = resolveViteId(`${MARKER_PREFIX}server-only`) +const RESOLVED_MARKER_CLIENT_ONLY = resolveViteId(`${MARKER_PREFIX}client-only`) + +export function resolvedMarkerVirtualModuleId( + kind: 'server' | 'client', +): string { + return kind === 'server' + ? RESOLVED_MARKER_SERVER_ONLY + : RESOLVED_MARKER_CLIENT_ONLY +} + +export function getResolvedVirtualModuleMatchers(): ReadonlyArray { + return RESOLVED_VIRTUAL_MODULE_MATCHERS +} + +const RESOLVED_VIRTUAL_MODULE_MATCHERS = [ + RESOLVED_MOCK_MODULE_ID, + RESOLVED_MOCK_BUILD_PREFIX, + RESOLVED_MOCK_EDGE_PREFIX, + RESOLVED_MOCK_RUNTIME_PREFIX, + RESOLVED_MARKER_PREFIX, +] as const + +const RESOLVE_PREFIX_PAIRS = [ + [MOCK_EDGE_PREFIX, RESOLVED_MOCK_EDGE_PREFIX], + [MOCK_RUNTIME_PREFIX, RESOLVED_MOCK_RUNTIME_PREFIX], + [MOCK_BUILD_PREFIX, RESOLVED_MOCK_BUILD_PREFIX], + [MARKER_PREFIX, RESOLVED_MARKER_PREFIX], +] as const + +export function resolveInternalVirtualModuleId( + source: string, +): string | undefined { + if (source.startsWith(VITE_BROWSER_VIRTUAL_PREFIX)) { + return resolveInternalVirtualModuleId( + `\0${source.slice(VITE_BROWSER_VIRTUAL_PREFIX.length)}`, + ) + } + + if (source === MOCK_MODULE_ID || source === RESOLVED_MOCK_MODULE_ID) { + return RESOLVED_MOCK_MODULE_ID + } + + for (const [unresolvedPrefix, resolvedPrefix] of RESOLVE_PREFIX_PAIRS) { + if (source.startsWith(unresolvedPrefix)) { + return resolveViteId(source) + } + + if (source.startsWith(resolvedPrefix)) { + return source + } + } + + return undefined +} + +export function loadResolvedVirtualModule( + id: string, +): { code: string } | undefined { + if (id === RESOLVED_MOCK_MODULE_ID) { + return loadSilentMockModule() + } + + if (id.startsWith(RESOLVED_MOCK_BUILD_PREFIX)) { + return loadSilentMockModule() + } + + if (id.startsWith(RESOLVED_MOCK_EDGE_PREFIX)) { + return loadMockEdgeModule(id.slice(RESOLVED_MOCK_EDGE_PREFIX.length)) + } + + if (id.startsWith(RESOLVED_MOCK_RUNTIME_PREFIX)) { + return loadMockRuntimeModule(id.slice(RESOLVED_MOCK_RUNTIME_PREFIX.length)) + } + + if (id.startsWith(RESOLVED_MARKER_PREFIX)) { + return loadMarkerModule() + } + + return undefined +} + +export { + MARKER_PREFIX, + MOCK_BUILD_PREFIX, + MOCK_EDGE_PREFIX, + MOCK_MODULE_ID, + MOCK_RUNTIME_PREFIX, + RUNTIME_SUGGESTION_TEXT, + generateDevSelfDenialModule, + generateSelfContainedMockModule, + loadMarkerModule, + loadMockEdgeModule, + loadMockRuntimeModule, + loadSilentMockModule, + makeMockEdgeModuleId, + mockRuntimeModuleIdFromViolation, +} diff --git a/packages/start-plugin-core/src/vite/index.ts b/packages/start-plugin-core/src/vite/index.ts new file mode 100644 index 0000000000..d50bb40981 --- /dev/null +++ b/packages/start-plugin-core/src/vite/index.ts @@ -0,0 +1,13 @@ +export type { + TanStackStartVitePluginCoreOptions, + ViteRscForwardSsrResolverStrategy, +} from './types' +export type { TanStackStartViteInputConfig } from './schema' +export type { + StartCompilerImportTransform, + StartCompilerTransformCandidate, + StartCompilerTransformContext, +} from '../types' +export { START_ENVIRONMENT_NAMES, VITE_ENVIRONMENT_NAMES } from '../constants' +export { createVirtualModule } from './createVirtualModule' +export { tanStackStartVite } from './plugin' diff --git a/packages/start-plugin-core/src/load-env-plugin/plugin.ts b/packages/start-plugin-core/src/vite/load-env-plugin/plugin.ts similarity index 100% rename from packages/start-plugin-core/src/load-env-plugin/plugin.ts rename to packages/start-plugin-core/src/vite/load-env-plugin/plugin.ts diff --git a/packages/start-plugin-core/src/output-directory.ts b/packages/start-plugin-core/src/vite/output-directory.ts similarity index 87% rename from packages/start-plugin-core/src/output-directory.ts rename to packages/start-plugin-core/src/vite/output-directory.ts index aa1655433f..ea215d4841 100644 --- a/packages/start-plugin-core/src/output-directory.ts +++ b/packages/start-plugin-core/src/vite/output-directory.ts @@ -1,6 +1,6 @@ import { join } from 'pathe' -import { VITE_ENVIRONMENT_NAMES } from './constants' -import type { ViteEnvironmentNames } from './constants' +import { VITE_ENVIRONMENT_NAMES } from '../constants' +import type { ViteEnvironmentNames } from '../constants' import type * as vite from 'vite' export function getClientOutputDirectory( diff --git a/packages/start-plugin-core/src/vite/planning.ts b/packages/start-plugin-core/src/vite/planning.ts new file mode 100644 index 0000000000..258fd2dbd2 --- /dev/null +++ b/packages/start-plugin-core/src/vite/planning.ts @@ -0,0 +1,252 @@ +import { normalizePath } from 'vite' +import { join } from 'pathe' +import { escapePath } from 'tinyglobby' +import { + DEV_CLIENT_ENTRY, + ENTRY_POINTS, + START_ENVIRONMENT_NAMES, +} from '../constants' +import { getBundlerOptions } from '../utils' +import type { CompileStartFrameworkOptions } from '../types' +import type { ResolvedStartEntryPlan } from '../planning' +import type * as vite from 'vite' + +export interface ViteResolvedEntryAliases { + client: string + server: string + start: string + router: string + alias: Record<(typeof ENTRY_POINTS)[keyof typeof ENTRY_POINTS], string> +} + +export function createViteResolvedEntryAliases(opts: { + entryPaths: ResolvedStartEntryPlan['entryPaths'] +}): ViteResolvedEntryAliases { + const client = normalizePath(opts.entryPaths.client) + const server = normalizePath(opts.entryPaths.server) + const start = normalizePath(opts.entryPaths.start) + const router = normalizePath(opts.entryPaths.router) + + return { + client, + server, + start, + router, + alias: { + [ENTRY_POINTS.client]: client, + [ENTRY_POINTS.server]: server, + [ENTRY_POINTS.start]: start, + [ENTRY_POINTS.router]: router, + }, + } +} + +export function createViteConfigPlan(opts: { + viteConfig: vite.UserConfig + command: 'serve' | 'build' + framework: CompileStartFrameworkOptions + entryAliases: ViteResolvedEntryAliases + clientOutputDirectory: string + serverOutputDirectory: string + serverFnProviderEnv: string + optimizeDepsExclude: Array + noExternal: Array +}) { + return { + environments: { + [START_ENVIRONMENT_NAMES.client]: { + consumer: 'client', + build: (() => { + const input = + opts.command === 'serve' ? DEV_CLIENT_ENTRY : ENTRY_POINTS.client + + const bundlerOptions = { + input: { + index: input, + }, + } + return { + rollupOptions: bundlerOptions, + rolldownOptions: bundlerOptions, + outDir: opts.clientOutputDirectory, + } + })(), + optimizeDeps: { + exclude: opts.optimizeDepsExclude, + entries: escapeEntries([ + opts.entryAliases.client, + opts.entryAliases.router, + ]), + }, + }, + [START_ENVIRONMENT_NAMES.server]: { + consumer: 'server', + build: { + ssr: true, + ...(() => { + const bundlerOptions = { + input: + getBundlerOptions( + opts.viteConfig.environments?.[START_ENVIRONMENT_NAMES.server] + ?.build, + )?.input ?? opts.entryAliases.server, + } + return { + rollupOptions: bundlerOptions, + rolldownOptions: bundlerOptions, + } + })(), + outDir: opts.serverOutputDirectory, + commonjsOptions: { + include: [/node_modules/], + }, + copyPublicDir: + opts.viteConfig.environments?.[START_ENVIRONMENT_NAMES.server] + ?.build?.copyPublicDir ?? false, + }, + optimizeDeps: { + entries: escapeEntries([ + opts.entryAliases.server, + opts.entryAliases.start, + opts.entryAliases.router, + ]), + }, + }, + ...(opts.serverFnProviderEnv !== START_ENVIRONMENT_NAMES.server && { + [opts.serverFnProviderEnv]: { + build: { + outDir: join(opts.serverOutputDirectory, opts.serverFnProviderEnv), + }, + optimizeDeps: { + entries: escapeEntries([opts.entryAliases.router]), + }, + }, + }), + }, + resolve: { + noExternal: [ + '@tanstack/start**', + `@tanstack/${opts.framework}-start**`, + ...opts.noExternal, + ], + alias: { + ...opts.entryAliases.alias, + }, + }, + } satisfies Pick +} + +export function createViteDefineConfig(opts: { + command: 'serve' | 'build' + mode: string | undefined + serverFnBase: string + routerBasepath: string + spaEnabled: boolean | undefined + devSsrStylesEnabled: boolean + devSsrStylesBasepath: string + inlineCssEnabled: boolean + staticNodeEnv: boolean + disableCsrfMiddlewareWarning: boolean +}) { + return { + ...defineReplaceEnv('TSS_SERVER_FN_BASE', opts.serverFnBase), + ...defineReplaceEnv('TSS_ROUTER_BASEPATH', opts.routerBasepath), + ...(opts.command === 'serve' + ? defineReplaceEnv('TSS_SHELL', opts.spaEnabled ? 'true' : 'false') + : {}), + ...defineReplaceEnv( + 'TSS_DEV_SERVER', + opts.command === 'serve' ? 'true' : 'false', + ), + ...defineReplaceEnv( + 'TSS_DEV_SSR_STYLES_ENABLED', + opts.devSsrStylesEnabled ? 'true' : 'false', + ), + ...defineReplaceEnv( + 'TSS_DEV_SSR_STYLES_BASEPATH', + opts.devSsrStylesBasepath, + ), + ...defineReplaceEnv( + 'TSS_INLINE_CSS_ENABLED', + opts.inlineCssEnabled ? 'true' : 'false', + ), + ...defineReplaceEnv( + 'TSS_DISABLE_CSRF_MIDDLEWARE_WARNING', + opts.disableCsrfMiddlewareWarning ? 'true' : 'false', + ), + ...(opts.command === 'build' && opts.staticNodeEnv + ? { + 'process.env.NODE_ENV': JSON.stringify( + process.env.NODE_ENV || opts.mode || 'production', + ), + } + : {}), + } satisfies NonNullable +} + +export async function buildStartViteEnvironments(opts: { + builder: vite.ViteBuilder + providerEnvironmentName: string + ssrIsProvider: boolean +}) { + const client = getRequiredBuilderEnvironment( + opts.builder, + START_ENVIRONMENT_NAMES.client, + 'Client environment not found', + ) + const server = getRequiredBuilderEnvironment( + opts.builder, + START_ENVIRONMENT_NAMES.server, + 'SSR environment not found', + ) + + if (!client.isBuilt) { + await opts.builder.build(client) + } + + if (!server.isBuilt) { + await opts.builder.build(server) + } + + if (opts.ssrIsProvider) { + return + } + + const providerEnv = getRequiredBuilderEnvironment( + opts.builder, + opts.providerEnvironmentName, + `Provider environment "${opts.providerEnvironmentName}" not found`, + ) + + if (!providerEnv.isBuilt) { + await opts.builder.build(providerEnv) + } +} + +function escapeEntries(entries: Array) { + return entries.map((entry) => escapePath(entry)) +} + +function defineReplaceEnv( + key: TKey, + value: TValue, +): { [P in `process.env.${TKey}` | `import.meta.env.${TKey}`]: TValue } { + return { + [`process.env.${key}`]: JSON.stringify(value), + [`import.meta.env.${key}`]: JSON.stringify(value), + } as { [P in `process.env.${TKey}` | `import.meta.env.${TKey}`]: TValue } +} + +function getRequiredBuilderEnvironment( + builder: vite.ViteBuilder, + environmentName: string, + errorMessage: string, +) { + const environment = builder.environments[environmentName] + + if (!environment) { + throw new Error(errorMessage) + } + + return environment +} diff --git a/packages/start-plugin-core/src/vite/plugin.ts b/packages/start-plugin-core/src/vite/plugin.ts new file mode 100644 index 0000000000..5fd9356f1f --- /dev/null +++ b/packages/start-plugin-core/src/vite/plugin.ts @@ -0,0 +1,276 @@ +import { crawlFrameworkPkgs } from 'vitefu' +import { + applyResolvedBaseAndOutput, + applyResolvedRouterBasepath, + createStartConfigContext, +} from '../config-context' +import { START_ENVIRONMENT_NAMES } from '../constants' +import { + createServerFnBasePath, + normalizePublicBase, + shouldRewriteDevBasepath, +} from '../planning' +import { importProtectionPlugin } from './import-protection-plugin/plugin' +import { startCompilerPlugin } from './start-compiler-plugin/plugin' +import { loadEnvPlugin } from './load-env-plugin/plugin' +import { + buildStartViteEnvironments, + createViteConfigPlan, + createViteDefineConfig, + createViteResolvedEntryAliases, +} from './planning' +import { devServerPlugin } from './dev-server-plugin/plugin' +import { previewServerPlugin } from './preview-server-plugin/plugin' +import { + createDevBaseRewritePlugin, + createDevClientEntryPlugin, + createPostBuildPlugin, +} from './plugins' +import { parseStartConfig } from './schema' +import { startManifestPlugin } from './start-manifest-plugin/plugin' +import { tanStackStartRouter } from './start-router-plugin/plugin' +import { + getClientOutputDirectory, + getServerOutputDirectory, +} from './output-directory' +import { postServerBuild } from './post-server-build' +import { serializationAdaptersPlugin } from './serialization-adapters-plugin' +import type { + TanStackStartVitePluginCoreOptions, + ViteRscForwardSsrResolverStrategy, +} from './types' +import type { TanStackStartViteInputConfig } from './schema' +import type { PluginOption } from 'vite' + +export function tanStackStartVite( + corePluginOpts: TanStackStartVitePluginCoreOptions, + startPluginOpts: TanStackStartViteInputConfig | undefined, +): Array { + const normalizedStartPluginOpts = startPluginOpts ?? {} + + const configContext = createStartConfigContext({ + corePluginOpts, + startPluginOpts: normalizedStartPluginOpts, + parseConfig: parseStartConfig, + }) + const { getConfig, resolvedStartConfig } = configContext + const serverFnProviderEnv = corePluginOpts.providerEnvironmentName + const ssrIsProvider = corePluginOpts.ssrIsProvider + + // When the router basepath and vite base are misaligned during dev, + // we install a URL rewrite middleware instead of erroring. + let needsDevBaseRewrite = false + + const environments: Array<{ + name: string + type: 'client' | 'server' + getServerFnById?: string + }> = [ + { name: START_ENVIRONMENT_NAMES.client, type: 'client' }, + { + name: START_ENVIRONMENT_NAMES.server, + type: 'server', + getServerFnById: + corePluginOpts.ssrResolverStrategy.type === 'vite-rsc-forward' + ? createViteRscForwarder(corePluginOpts.ssrResolverStrategy) + : undefined, + }, + ] + if ( + serverFnProviderEnv !== START_ENVIRONMENT_NAMES.server && + !environments.find((e) => e.name === serverFnProviderEnv) + ) { + environments.push({ + name: serverFnProviderEnv, + type: 'server', + }) + } + return [ + { + name: 'tanstack-start-core:config', + enforce: 'pre', + async config(viteConfig, { command }) { + const publicBase = normalizePublicBase(viteConfig.base) + applyResolvedBaseAndOutput({ + resolvedStartConfig, + root: viteConfig.root || process.cwd(), + publicBase, + clientOutputDirectory: getClientOutputDirectory(viteConfig), + serverOutputDirectory: getServerOutputDirectory(viteConfig), + }) + const { startConfig } = getConfig() + const routerBasepath = applyResolvedRouterBasepath({ + resolvedStartConfig, + startConfig, + }) + + if ( + shouldRewriteDevBasepath({ + command, + middlewareMode: Boolean(viteConfig.server?.middlewareMode), + routerBasepath, + publicBase: resolvedStartConfig.basePaths.publicBase, + }) + ) { + // The router basepath and vite base are misaligned. + // Instead of erroring, we install a dev-server middleware that + // rewrites incoming request URLs to prepend the vite base prefix. + // This allows users to have e.g. base: '/_ui/' for asset URLs + // while keeping router basepath at '/' for page navigation. + needsDevBaseRewrite = true + } + + const TSS_SERVER_FN_BASE = createServerFnBasePath({ + routerBasepath, + serverFnBase: startConfig.serverFns.base, + }) + const resolvedEntryPlan = configContext.resolveEntries() + + const entryAliases = createViteResolvedEntryAliases({ + entryPaths: resolvedEntryPlan.entryPaths, + }) + + const startPackageName = + `@tanstack/${corePluginOpts.framework}-start` as const + + // crawl packages that have start in "peerDependencies" + // see https://github.com/svitejs/vitefu/blob/d8d82fa121e3b2215ba437107093c77bde51b63b/src/index.js#L95-L101 + + // this is currently uncached; could be implemented similarly as vite handles lock file changes + // see https://github.com/vitejs/vite/blob/557f797d29422027e8c451ca50dd84bf8c41b5f0/packages/vite/src/node/optimizer/index.ts#L1282 + + const crawlFrameworkPkgsResult = await crawlFrameworkPkgs({ + root: process.cwd(), + isBuild: command === 'build', + isFrameworkPkgByJson(pkgJson) { + const peerDependencies = pkgJson['peerDependencies'] + + if (peerDependencies) { + if ( + startPackageName in peerDependencies || + '@tanstack/start-client-core' in peerDependencies + ) { + return true + } + } + + return false + }, + }) + + const viteConfigPlan = createViteConfigPlan({ + viteConfig, + command, + framework: corePluginOpts.framework, + entryAliases, + clientOutputDirectory: resolvedStartConfig.outputDirectories.client, + serverOutputDirectory: resolvedStartConfig.outputDirectories.server, + serverFnProviderEnv, + optimizeDepsExclude: crawlFrameworkPkgsResult.optimizeDeps.exclude, + noExternal: crawlFrameworkPkgsResult.ssr.noExternal.sort(), + }) + + return { + // see https://vite.dev/config/shared-options.html#apptype + // this will prevent vite from injecting middlewares that we don't want + appType: viteConfig.appType ?? 'custom', + environments: viteConfigPlan.environments, + resolve: viteConfigPlan.resolve, + define: createViteDefineConfig({ + command, + mode: viteConfig.mode, + serverFnBase: TSS_SERVER_FN_BASE, + routerBasepath, + spaEnabled: startConfig.spa?.enabled, + devSsrStylesEnabled: startConfig.dev.ssrStyles.enabled, + devSsrStylesBasepath: + startConfig.dev.ssrStyles.basepath ?? + resolvedStartConfig.basePaths.publicBase, + inlineCssEnabled: + command === 'build' && startConfig.server.build.inlineCss.enabled, + staticNodeEnv: startConfig.server.build.staticNodeEnv, + disableCsrfMiddlewareWarning: + startConfig.serverFns.disableCsrfMiddlewareWarning, + }), + builder: { + sharedPlugins: true, + async buildApp(builder) { + await buildStartViteEnvironments({ + builder, + providerEnvironmentName: serverFnProviderEnv, + ssrIsProvider, + }) + }, + }, + } + }, + }, + createPostBuildPlugin({ + getConfig, + postServerBuild, + }), + // Server function plugin handles: + // 1. Identifying createServerFn().handler() calls + // 2. Extracting server functions to separate modules + // 3. Replacing call sites with RPC stubs + // 4. Generating the server function manifest + // Also handles createIsomorphicFn, createServerOnlyFn, createClientOnlyFn, createMiddleware + startCompilerPlugin({ + framework: corePluginOpts.framework, + environments, + generateFunctionId: + normalizedStartPluginOpts.serverFns?.generateFunctionId, + compilerTransforms: corePluginOpts.compilerTransforms, + serverFnProviderModuleDirectives: + corePluginOpts.serverFnProviderModuleDirectives, + providerEnvName: serverFnProviderEnv, + }), + importProtectionPlugin({ + getConfig, + framework: corePluginOpts.framework, + environments, + providerEnvName: serverFnProviderEnv, + }), + tanStackStartRouter(normalizedStartPluginOpts, getConfig, corePluginOpts), + loadEnvPlugin(), + createDevClientEntryPlugin({ + framework: corePluginOpts.framework, + getClientEntry: () => configContext.resolveEntries().entryPaths.client, + }), + startManifestPlugin({ + getConfig, + }), + // When the vite base and router basepath are misaligned (e.g. base: '/_ui/', basepath: '/'), + // install a middleware that rewrites incoming request URLs to prepend the vite base prefix. + // This allows Vite's internal base middleware to accept the requests, then strips the prefix + // before passing to the SSR handler. + // Registered BEFORE devServerPlugin so this middleware is added to the Connect stack first, + // ensuring all subsequent middlewares (CSS, SSR, etc.) see the rewritten URL. + createDevBaseRewritePlugin({ + shouldRewriteDevBase: () => needsDevBaseRewrite, + resolvedStartConfig, + }), + devServerPlugin({ + getConfig, + devSsrStylesEnabled: + normalizedStartPluginOpts.dev?.ssrStyles?.enabled ?? true, + installDevServerMiddleware: + normalizedStartPluginOpts.vite?.installDevServerMiddleware, + }), + previewServerPlugin(), + ...(corePluginOpts.serializationAdapters?.length + ? [ + serializationAdaptersPlugin({ + adapters: corePluginOpts.serializationAdapters, + }), + ] + : []), + ] +} + +function createViteRscForwarder(strategy: ViteRscForwardSsrResolverStrategy) { + return `export async function getServerFnById(id, access) { + const m = await import.meta.viteRsc.loadModule(${JSON.stringify(strategy.sourceEnvironmentName)}, ${JSON.stringify(strategy.sourceEntry)}) + return m[${JSON.stringify(strategy.exportName)}](id, access) +}` +} diff --git a/packages/start-plugin-core/src/vite/plugins.ts b/packages/start-plugin-core/src/vite/plugins.ts new file mode 100644 index 0000000000..0da90cf5c1 --- /dev/null +++ b/packages/start-plugin-core/src/vite/plugins.ts @@ -0,0 +1,121 @@ +import { normalizePath } from 'vite' +import { DEV_CLIENT_ENTRY } from '../constants' +import { createVirtualModule } from './createVirtualModule' +import type { + CompileStartFrameworkOptions, + GetConfigFn, + ResolvedStartConfig, +} from '../types' +import type { PluginOption, ViteBuilder } from 'vite' + +export function createDevClientEntryPlugin(opts: { + framework: CompileStartFrameworkOptions + getClientEntry: () => string +}): PluginOption { + return createVirtualModule({ + name: 'tanstack-start-core:dev-client-entry', + moduleId: DEV_CLIENT_ENTRY, + enforce: 'pre', + async load() { + const clientEntry = JSON.stringify( + normalizePath(opts.getClientEntry()).replaceAll('\\', '/'), + ) + + if (shouldInjectReactRefreshPreamble(this.environment, opts.framework)) { + const reactRefresh = await this.resolve?.('/@react-refresh') + + if (!reactRefresh) { + throw new Error( + 'TanStack Start React dev mode requires the React Refresh runtime, but /@react-refresh could not be resolved. Add @vitejs/plugin-react or another compatible React Refresh Vite plugin to your Vite config.', + ) + } + + return ( + getReactRefreshPreambleCode(reactRefresh.id) + + `\nawait import(${clientEntry})` + ) + } + + return `import ${clientEntry}` + }, + }) +} + +function shouldInjectReactRefreshPreamble( + environment: ReactRefreshEnvironment | undefined, + framework: CompileStartFrameworkOptions, +) { + const config = environment?.config + + return ( + framework === 'react' && + config?.command === 'serve' && + config.consumer === 'client' && + config.server?.hmr !== false + ) +} + +interface ReactRefreshEnvironment { + config?: { + command?: string + consumer?: string + server?: { + hmr?: boolean + } + } +} + +function getReactRefreshPreambleCode(reactRefreshId: string) { + return `import { injectIntoGlobalHook } from ${JSON.stringify(reactRefreshId)}; +injectIntoGlobalHook(window); +window.$RefreshReg$ = () => {}; +window.$RefreshSig$ = () => (type) => type; +window.__vite_plugin_react_preamble_installed__ = true;` +} + +export function createPostBuildPlugin(opts: { + getConfig: GetConfigFn + postServerBuild: (opts: { + startConfig: ReturnType['startConfig'] + builder: ViteBuilder + }) => Promise +}): PluginOption { + return { + name: 'tanstack-start-core:post-build', + enforce: 'post', + buildApp: { + order: 'post', + async handler(builder) { + const { startConfig } = opts.getConfig() + await opts.postServerBuild({ builder, startConfig }) + }, + }, + } +} + +export function createDevBaseRewritePlugin(opts: { + shouldRewriteDevBase: () => boolean + resolvedStartConfig: ResolvedStartConfig +}): PluginOption { + return { + name: 'tanstack-start-core:dev-base-rewrite', + configureServer(server) { + if (!opts.shouldRewriteDevBase()) { + return + } + + const basePrefix = opts.resolvedStartConfig.basePaths.publicBase.replace( + /\/$/, + '', + ) + + server.middlewares.use((req, _res, next) => { + if (req.url && !req.url.startsWith(basePrefix)) { + req.url = basePrefix + req.url + } + + next() + }) + }, + } +} diff --git a/packages/start-plugin-core/src/vite/post-server-build.ts b/packages/start-plugin-core/src/vite/post-server-build.ts new file mode 100644 index 0000000000..2e74b7635d --- /dev/null +++ b/packages/start-plugin-core/src/vite/post-server-build.ts @@ -0,0 +1,28 @@ +import { postBuild } from '../post-build' +import { getClientOutputDirectory } from './output-directory' +import { prerenderWithVite } from './prerender' +import type { TanStackStartOutputConfig } from '../schema' +import type { ViteBuilder } from 'vite' + +export async function postServerBuild({ + builder, + startConfig, +}: { + builder: ViteBuilder + startConfig: TanStackStartOutputConfig +}) { + await postBuild({ + startConfig, + adapter: { + getClientOutputDirectory() { + return getClientOutputDirectory(builder.config) + }, + prerender(startConfig) { + return prerenderWithVite({ + startConfig, + builder, + }) + }, + }, + }) +} diff --git a/packages/start-plugin-core/src/vite/prerender.ts b/packages/start-plugin-core/src/vite/prerender.ts new file mode 100644 index 0000000000..5eeb76e8d5 --- /dev/null +++ b/packages/start-plugin-core/src/vite/prerender.ts @@ -0,0 +1,87 @@ +import { VITE_ENVIRONMENT_NAMES } from '../constants' +import { prerender } from '../prerender' +import type { PrerenderHandler } from '../prerender' +import type { TanStackStartOutputConfig } from '../schema' +import type { PreviewServer, ResolvedConfig, ViteBuilder } from 'vite' + +export async function prerenderWithVite({ + startConfig, + builder, +}: { + startConfig: TanStackStartOutputConfig + builder: ViteBuilder +}) { + const serverEnv = builder.environments[VITE_ENVIRONMENT_NAMES.server] + + if (!serverEnv) { + throw new Error( + `Vite's "${VITE_ENVIRONMENT_NAMES.server}" environment not found`, + ) + } + + const clientEnv = builder.environments[VITE_ENVIRONMENT_NAMES.client] + if (!clientEnv) { + throw new Error( + `Vite's "${VITE_ENVIRONMENT_NAMES.client}" environment not found`, + ) + } + + const outputDir = clientEnv.config.build.outDir + + process.env.TSS_PRERENDERING = 'true' + process.env.TSS_CLIENT_OUTPUT_DIR = outputDir + + const previewServer = await startPreviewServer(serverEnv.config) + const baseUrl = getResolvedUrl(previewServer) + + const handler: PrerenderHandler = { + getClientOutputDirectory() { + return outputDir + }, + request(path, options) { + const url = new URL(path, baseUrl) + return fetch(new Request(url, options)) + }, + close() { + return previewServer.close() + }, + } + + return prerender({ + startConfig, + handler, + }) +} + +async function startPreviewServer( + viteConfig: ResolvedConfig, +): Promise { + const vite = await import('vite') + + try { + return await vite.preview({ + configFile: viteConfig.configFile, + preview: { + port: 0, + open: false, + }, + }) + } catch (error) { + throw new Error( + 'Failed to start the Vite preview server for prerendering', + { + cause: error, + }, + ) + } +} + +function getResolvedUrl(previewServer: PreviewServer): URL { + const baseUrl = previewServer.resolvedUrls?.local[0] + + if (!baseUrl) { + throw new Error('No resolved URL is available from the Vite preview server') + } + + return new URL(baseUrl) +} diff --git a/packages/start-plugin-core/src/preview-server-plugin/plugin.ts b/packages/start-plugin-core/src/vite/preview-server-plugin/plugin.ts similarity index 96% rename from packages/start-plugin-core/src/preview-server-plugin/plugin.ts rename to packages/start-plugin-core/src/vite/preview-server-plugin/plugin.ts index 78ef4033c5..1541d9edfb 100644 --- a/packages/start-plugin-core/src/preview-server-plugin/plugin.ts +++ b/packages/start-plugin-core/src/vite/preview-server-plugin/plugin.ts @@ -2,9 +2,9 @@ import { pathToFileURL } from 'node:url' import { basename, extname, join } from 'pathe' import { NodeRequest, sendNodeResponse } from 'srvx/node' import { joinURL } from 'ufo' -import { VITE_ENVIRONMENT_NAMES } from '../constants' +import { VITE_ENVIRONMENT_NAMES } from '../../constants' import { getServerOutputDirectory } from '../output-directory' -import { getBundlerOptions } from '../utils' +import { getBundlerOptions } from '../../utils' import type { Plugin } from 'vite' export function previewServerPlugin(): Plugin { diff --git a/packages/start-plugin-core/src/vite/schema.ts b/packages/start-plugin-core/src/vite/schema.ts new file mode 100644 index 0000000000..c142245fc0 --- /dev/null +++ b/packages/start-plugin-core/src/vite/schema.ts @@ -0,0 +1,37 @@ +import { z } from 'zod' +import { + parseStartConfig as parseCoreStartConfig, + tanstackStartOptionsObjectSchema, +} from '../schema' +import type { CompileStartFrameworkOptions } from '../types' +import type { InlineCssInputOptions } from '../schema' + +export const tanstackStartViteOptionsSchema = tanstackStartOptionsObjectSchema + .extend({ + vite: z + .object({ installDevServerMiddleware: z.boolean().optional() }) + .optional(), + }) + .optional() + .prefault({}) + +export function parseStartConfig( + opts: z.input, + corePluginOpts: { framework: CompileStartFrameworkOptions }, + root: string, +) { + tanstackStartViteOptionsSchema.parse(opts) + const { vite: _vite, ...coreOptions } = opts ?? {} + + return parseCoreStartConfig(coreOptions, corePluginOpts, root) +} + +export type TanStackStartViteInputConfig = z.input< + typeof tanstackStartViteOptionsSchema +> & { + server?: { + build?: { + inlineCss?: InlineCssInputOptions + } + } +} diff --git a/packages/start-plugin-core/src/vite/serialization-adapters-plugin.ts b/packages/start-plugin-core/src/vite/serialization-adapters-plugin.ts new file mode 100644 index 0000000000..3cf12ad97c --- /dev/null +++ b/packages/start-plugin-core/src/vite/serialization-adapters-plugin.ts @@ -0,0 +1,86 @@ +import { VIRTUAL_MODULES } from '@tanstack/start-server-core' +import { generateSerializationAdaptersModule } from '../serialization-adapters-module' +import { START_ENVIRONMENT_NAMES } from '../constants' +import { createIdFilter } from '../utils' +import type { SerializationAdapterConfig } from '../types' +import type { PluginOption } from 'vite' + +const CLIENT_MODULE_ID = 'virtual:tanstack-start-plugin-adapters/client' +const SERVER_MODULE_ID = 'virtual:tanstack-start-plugin-adapters/server' +const BUILD_CLIENT_MODULE_ID = `\0${CLIENT_MODULE_ID}` +const BUILD_SERVER_MODULE_ID = `\0${SERVER_MODULE_ID}` +const MODULE_IDS = [ + CLIENT_MODULE_ID, + SERVER_MODULE_ID, + BUILD_CLIENT_MODULE_ID, + BUILD_SERVER_MODULE_ID, +] + +const moduleIdFilter = createIdFilter(MODULE_IDS) +const resolveIdFilter = createIdFilter([ + VIRTUAL_MODULES.pluginAdapters, + ...MODULE_IDS, +]) + +export function serializationAdaptersPlugin(opts: { + adapters: Array | undefined +}): PluginOption { + return { + name: 'tanstack-start:plugin-adapters', + enforce: 'pre', + resolveId: { + filter: { id: resolveIdFilter }, + handler(id) { + if (getRuntime(id)) { + return id + } + + if (id !== VIRTUAL_MODULES.pluginAdapters) { + return undefined + } + + const runtime = + this.environment.name === START_ENVIRONMENT_NAMES.client + ? 'client' + : 'server' + + return getModuleId(runtime, this.environment.config.command) + }, + }, + load: { + filter: { id: moduleIdFilter }, + handler(id) { + const runtime = getRuntime(id) + if (!runtime) { + return undefined + } + + return generateSerializationAdaptersModule({ + adapters: opts.adapters, + runtime, + }) + }, + }, + } +} + +function getModuleId(runtime: 'client' | 'server', command: string) { + if (runtime === 'client') { + return command === 'serve' ? CLIENT_MODULE_ID : BUILD_CLIENT_MODULE_ID + } + + return command === 'serve' ? SERVER_MODULE_ID : BUILD_SERVER_MODULE_ID +} + +function getRuntime(id: string): 'client' | 'server' | undefined { + switch (id) { + case CLIENT_MODULE_ID: + case BUILD_CLIENT_MODULE_ID: + return 'client' + case SERVER_MODULE_ID: + case BUILD_SERVER_MODULE_ID: + return 'server' + default: + return undefined + } +} diff --git a/packages/start-plugin-core/src/vite/start-compiler-plugin/hot-update.ts b/packages/start-plugin-core/src/vite/start-compiler-plugin/hot-update.ts new file mode 100644 index 0000000000..5ff7e04773 --- /dev/null +++ b/packages/start-plugin-core/src/vite/start-compiler-plugin/hot-update.ts @@ -0,0 +1,24 @@ +import type { EnvironmentModuleNode } from 'vite' + +export function mergeHotUpdateModules( + currentModules: Array, + additionalModules: Array, +): Array | undefined { + if (additionalModules.length === 0) { + return undefined + } + + const mergedModules = currentModules.slice() + const seenModules = new Set(currentModules) + + for (const mod of additionalModules) { + if (seenModules.has(mod)) { + continue + } + + seenModules.add(mod) + mergedModules.push(mod) + } + + return mergedModules +} diff --git a/packages/start-plugin-core/src/vite/start-compiler-plugin/module-specifier.ts b/packages/start-plugin-core/src/vite/start-compiler-plugin/module-specifier.ts new file mode 100644 index 0000000000..1324894f68 --- /dev/null +++ b/packages/start-plugin-core/src/vite/start-compiler-plugin/module-specifier.ts @@ -0,0 +1,41 @@ +import type { DevServerFnModuleSpecifierEncoder } from '../../start-compiler/types' + +export function createViteDevServerFnModuleSpecifierEncoder( + root: string, +): DevServerFnModuleSpecifierEncoder { + const normalizedRoot = root.replace(/\\/g, '/') + const rootWithTrailingSlash = normalizedRoot.endsWith('/') + ? normalizedRoot + : `${normalizedRoot}/` + + return ({ extractedFilename }) => { + const normalizedFile = extractedFilename.replace(/\\/g, '/') + + if (normalizedFile.startsWith(rootWithTrailingSlash)) { + return `/${normalizedFile.slice(rootWithTrailingSlash.length)}` + } + + return normalizedFile.startsWith('/') + ? `/@fs${normalizedFile}` + : `/@fs/${normalizedFile}` + } +} + +export function decodeViteDevServerModuleSpecifier( + moduleSpecifier: string, +): string { + let sourceFile = moduleSpecifier + + if (sourceFile.startsWith('/@id/')) { + sourceFile = sourceFile.slice('/@id/'.length) + } else if (sourceFile.startsWith('/@fs/')) { + sourceFile = sourceFile.slice('/@fs'.length) + sourceFile = sourceFile.replace(/^\/([A-Za-z]:\/)/, '$1') + } else if (sourceFile.startsWith('/')) { + sourceFile = sourceFile.slice(1) + } + + const queryIndex = sourceFile.indexOf('?') + + return queryIndex === -1 ? sourceFile : sourceFile.slice(0, queryIndex) +} diff --git a/packages/start-plugin-core/src/vite/start-compiler-plugin/plugin.ts b/packages/start-plugin-core/src/vite/start-compiler-plugin/plugin.ts new file mode 100644 index 0000000000..74bf9acfd5 --- /dev/null +++ b/packages/start-plugin-core/src/vite/start-compiler-plugin/plugin.ts @@ -0,0 +1,645 @@ +import { VIRTUAL_MODULES } from '@tanstack/start-server-core' +import { resolve as resolvePath } from 'pathe' +import { + SERVER_FN_LOOKUP, + TRANSFORM_ID_REGEX, + VITE_ENVIRONMENT_NAMES, +} from '../../constants' +import { detectKindsInCode } from '../../start-compiler/compiler' +import { getTransformCodeFilterForEnv } from '../../start-compiler/config' +import { + createCompilerVirtualModuleIdPattern, + createStartCompiler, + loadCompilerVirtualModule, + mergeServerFnsById, +} from '../../start-compiler/host' +import { generateServerFnResolverModule } from '../../start-compiler/server-fn-resolver-module' +import { cleanId } from '../../start-compiler/utils' +import { createVirtualModule } from '../createVirtualModule' +import { + MissingHydrateSourceError, + createHydrateCompilerPlugin, +} from '../../hydrate-when-transform' +import { resolveViteId } from '../../utils' +import { + createViteDevServerFnModuleSpecifierEncoder, + decodeViteDevServerModuleSpecifier, +} from './module-specifier' +import { mergeHotUpdateModules } from './hot-update' +import type { + CompileStartFrameworkOptions, + StartCompilerImportTransform, + StartCompilerPlugin, +} from '../../types' +import type { + GenerateFunctionIdFnOptional, + ServerFn, +} from '../../start-compiler/types' +import type { Environment, EnvironmentModuleNode, PluginOption } from 'vite' + +// Re-export from shared constants for backwards compatibility +export { SERVER_FN_LOOKUP } + +const validateServerFnIdVirtualModule = `virtual:tanstack-start-validate-server-fn-id` +const TSS_SERVERFN_SPLIT_PARAM = 'tss-serverfn-split' + +type ModuleInvalidationEnvironment = { + moduleGraph: { + getModulesByFile: (file: string) => Set | undefined + invalidateModule: ( + mod: EnvironmentModuleNode, + seen?: Set, + ) => void + } +} + +type ViteModuleLoadOptions = { + devId?: string + load: (options: { id: string }) => Promise<{ code?: string | null } | null> + error: (message: string) => never +} + +async function loadViteModuleFromEnvironment( + environment: Environment, + id: string, + opts: ViteModuleLoadOptions, +): Promise { + if (environment.mode === 'build') { + const loaded = await opts.load({ id }) + return loaded?.code ?? '' + } + + if (environment.mode === 'dev') { + await environment.transformRequest(opts.devId ?? id) + return undefined + } + + opts.error( + `could not load module ${id}: unknown environment mode ${environment.mode}`, + ) +} + +function invalidateMatchingFileModules( + environment: ModuleInvalidationEnvironment, + ids: Iterable, + shouldInvalidate: (mod: EnvironmentModuleNode) => boolean, +) { + const seen = new Set() + const invalidatedModules: Array = [] + + for (const id of ids) { + const fileModules = environment.moduleGraph.getModulesByFile(cleanId(id)) + + if (!fileModules) { + continue + } + + for (const fileModule of fileModules) { + if (!shouldInvalidate(fileModule)) { + continue + } + + environment.moduleGraph.invalidateModule(fileModule, seen) + invalidatedModules.push(fileModule) + } + } + + return invalidatedModules +} + +function invalidateServerFnProviderModules( + environment: { + moduleGraph: { + getModulesByFile: (file: string) => Set | undefined + invalidateModule: ( + mod: EnvironmentModuleNode, + seen?: Set, + ) => void + } + }, + ids: Iterable, +) { + return invalidateMatchingFileModules( + environment, + ids, + (fileModule) => fileModule.id?.includes(TSS_SERVERFN_SPLIT_PARAM) ?? false, + ) +} + +function invalidateServerFnLookupModules( + environment: ModuleInvalidationEnvironment, + ids: Iterable, +) { + invalidateMatchingFileModules( + environment, + ids, + (fileModule) => fileModule.id?.includes(SERVER_FN_LOOKUP) ?? false, + ) +} + +function invalidateCompilerVirtualModules( + environment: ModuleInvalidationEnvironment, + ids: Iterable, + pattern: RegExp | undefined, +) { + if (!pattern) { + return [] + } + + return invalidateMatchingFileModules(environment, ids, (fileModule) => { + if (!fileModule.id) { + return false + } + + pattern.lastIndex = 0 + return pattern.test(fileModule.id) + }) +} + +function getServerFnProviderIds(ids: Iterable) { + const providerIds = new Set() + + for (const id of ids) { + const cleanedId = cleanId(id) + providerIds.add(`${cleanedId}?${TSS_SERVERFN_SPLIT_PARAM}`) + } + + return providerIds +} + +function invalidateModuleNodes( + environment: { + moduleGraph: { + invalidateModule: ( + mod: EnvironmentModuleNode, + seen?: Set, + ) => void + } + }, + modules: Iterable, +) { + const seen = new Set() + + for (const mod of modules) { + environment.moduleGraph.invalidateModule(mod, seen) + } +} + +function getDevServerFnValidatorModule(): string { + return ` +export async function getServerFnById(id, _access) { + const validateIdImport = ${JSON.stringify(validateServerFnIdVirtualModule)} + '?id=' + id + await import(/* @vite-ignore */ '/@id/__x00__' + validateIdImport) + const decoded = Buffer.from(id, 'base64url').toString('utf8') + const devServerFn = JSON.parse(decoded) + const mod = await import(/* @vite-ignore */ devServerFn.file) + return mod[devServerFn.export] +} +` +} + +function parseIdQuery(id: string): { + filename: string + query: { + [k: string]: string + } +} { + if (!id.includes('?')) return { filename: id, query: {} } + const [filename, rawQuery] = id.split(`?`, 2) as [string, string] + const query = Object.fromEntries(new URLSearchParams(rawQuery)) + return { filename, query } +} + +export interface StartCompilerPluginOptions { + framework: CompileStartFrameworkOptions + environments: Array<{ + name: string + type: 'client' | 'server' + getServerFnById?: string + }> + /** + * Custom function ID generator (optional). + */ + generateFunctionId?: GenerateFunctionIdFnOptional + compilerTransforms?: Array | undefined + compilerPlugins?: Array | undefined + serverFnProviderModuleDirectives?: ReadonlyArray | undefined + /** + * The Vite environment name for the server function provider. + */ + providerEnvName: string +} + +export function startCompilerPlugin( + opts: StartCompilerPluginOptions, +): PluginOption { + const compilers = new Map>() + const compilerPlugins = [ + createHydrateCompilerPlugin(), + ...(opts.compilerPlugins ?? []), + ] + const compilerVirtualModuleIdPattern = + createCompilerVirtualModuleIdPattern(compilerPlugins) + const environmentByName = new Map( + opts.environments.map((environment) => [environment.name, environment]), + ) + + // Shared registry of server functions across all environments + const serverFnsById: Record = {} + + const onServerFnsById = (d: Record) => { + mergeServerFnsById(serverFnsById, d) + } + + let root = process.cwd() + let bundledDev = false + // Determine which environments need the resolver (getServerFnById) + // SSR environment always needs the resolver for server-side calls + // Provider environment needs it for the actual implementation + const ssrEnvName = VITE_ENVIRONMENT_NAMES.server + + // SSR is the provider when the provider environment is the default server environment + const ssrIsProvider = opts.providerEnvName === ssrEnvName + + // Environments that need the resolver: SSR (for server calls) and provider (for implementation) + const appliedResolverEnvironments = new Set( + ssrIsProvider ? [opts.providerEnvName] : [ssrEnvName, opts.providerEnvName], + ) + + function perEnvServerFnPlugin(environment: { + name: string + type: 'client' | 'server' + }): PluginOption { + const compilerTransforms = + environment.name === opts.providerEnvName + ? opts.compilerTransforms + : undefined + const serverFnProviderModuleDirectives = + environment.name === opts.providerEnvName + ? opts.serverFnProviderModuleDirectives + : undefined + // Derive transform code filter from KindDetectionPatterns (single source of truth) + const transformCodeFilter = getTransformCodeFilterForEnv(environment.type, { + compilerTransforms, + compilerPlugins, + }) + return { + name: `tanstack-start-core::server-fn:${environment.name}`, + enforce: 'pre', + applyToEnvironment(env) { + return env.name === environment.name + }, + configResolved(config) { + root = config.root + bundledDev = !!config.experimental.bundledDev + }, + buildStart() { + if ( + this.environment.mode === 'build' || + (bundledDev && + this.environment.name === VITE_ENVIRONMENT_NAMES.client) + ) { + // Vite app builds can run multiple Rolldown build phases with fresh + // plugin drivers. The compiler host closes over this hook context for + // load/resolve, so do not reuse it after a previous driver was closed. + compilers.delete(this.environment.name) + } + }, + watchChange(id) { + if (bundledDev && this.environment.mode === 'dev') { + compilers.get(this.environment.name)?.invalidateModule(id) + } + }, + transform: { + filter: { + id: { + exclude: new RegExp(`${SERVER_FN_LOOKUP}$`), + include: TRANSFORM_ID_REGEX, + }, + code: { + include: transformCodeFilter, + }, + }, + async handler(code, id) { + let compiler = compilers.get(this.environment.name) + + if (!compiler) { + // Default to 'dev' mode for unknown environments (conservative: no caching) + const mode = this.environment.mode === 'build' ? 'build' : 'dev' + + compiler = createStartCompiler({ + env: environment.type, + envName: environment.name, + root, + mode, + framework: opts.framework, + providerEnvName: opts.providerEnvName, + generateFunctionId: opts.generateFunctionId, + compilerTransforms, + compilerPlugins, + serverFnProviderModuleDirectives, + onServerFnsById, + getKnownServerFns: () => serverFnsById, + encodeModuleSpecifierInDev: + mode === 'dev' + ? createViteDevServerFnModuleSpecifierEncoder(root) + : undefined, + loadModule: async (id: string) => { + const code = await loadViteModuleFromEnvironment( + this.environment, + id, + { + load: (options) => this.load(options), + error: (message) => this.error(message), + devId: `${id}?${SERVER_FN_LOOKUP}`, + }, + ) + if (code !== undefined) { + compiler!.ingestModule({ code, id }) + } + }, + + resolveId: async (source: string, importer?: string) => { + const r = await this.resolve(source, importer) + + if (r) { + if (!r.external) { + return cleanId(r.id) + } + } + + return null + }, + }) + + compilers.set(this.environment.name, compiler) + } + + // Detect which kinds are present in this file before parsing + const detectedKinds = detectKindsInCode(code, environment.type, { + compilerTransforms, + }) + + const result = await compiler.compile({ + id, + code, + detectedKinds, + }) + + return result + }, + }, + + hotUpdate(ctx) { + const compiler = compilers.get(this.environment.name) + const idsToInvalidate = new Set() + const transitiveCompilerImportersToInvalidate = new Set() + const importerModulesToInvalidate = new Set() + const changedIds: Array = [] + + ctx.modules.forEach((m) => { + if (m.id) { + idsToInvalidate.add(m.id) + changedIds.push(m.id) + } + }) + + const deletedIds = compiler?.invalidateModules(changedIds) ?? new Set() + + ctx.modules.forEach((m) => { + if (m.id) { + if (deletedIds.has(cleanId(m.id))) { + transitiveCompilerImportersToInvalidate.add(cleanId(m.id)) + + m.importers.forEach((importer) => { + if (importer.id) { + idsToInvalidate.add(importer.id) + importerModulesToInvalidate.add(importer) + transitiveCompilerImportersToInvalidate.add( + cleanId(importer.id), + ) + } + }) + } + } + }) + + const finishHotUpdate = async () => { + if ( + environment.type === 'server' && + compiler && + transitiveCompilerImportersToInvalidate.size > 0 + ) { + const seenImporters = new Set( + transitiveCompilerImportersToInvalidate, + ) + const nestedImporters = + await compiler.getTransitiveImporters(seenImporters) + + for (const nestedImporterId of nestedImporters) { + seenImporters.add(nestedImporterId) + } + + for (const importerId of seenImporters) { + idsToInvalidate.add(importerId) + } + compiler.invalidateModules(seenImporters) + } + + invalidateModuleNodes(this.environment, importerModulesToInvalidate) + invalidateServerFnLookupModules(this.environment, idsToInvalidate) + const compilerVirtualModules = invalidateCompilerVirtualModules( + this.environment, + idsToInvalidate, + compilerVirtualModuleIdPattern, + ) + + if (environment.type !== 'server') { + return mergeHotUpdateModules(ctx.modules, compilerVirtualModules) + } + + invalidateModuleNodes(this.environment, ctx.modules) + + const providerIdsToInvalidate = + getServerFnProviderIds(idsToInvalidate) + compiler?.invalidateModules(providerIdsToInvalidate) + + const providerModules = invalidateServerFnProviderModules( + this.environment, + [...idsToInvalidate, ...providerIdsToInvalidate], + ) + + return mergeHotUpdateModules(ctx.modules, [ + ...compilerVirtualModules, + ...providerModules, + ]) + } + + return finishHotUpdate() + }, + } + } + + return [ + ...opts.environments.map(perEnvServerFnPlugin), + { + name: 'tanstack-start-core:capture-server-fn-module-lookup', + // we only need this plugin in dev mode + apply: 'serve', + applyToEnvironment(env) { + return !!opts.environments.find((e) => e.name === env.name) + }, + transform: { + filter: { + id: new RegExp(`${SERVER_FN_LOOKUP}$`), + }, + handler(code, id) { + const compiler = compilers.get(this.environment.name) + compiler?.ingestModule({ code, id: cleanId(id) }) + }, + }, + }, + { + name: 'tanstack-start-core:compiler-virtual-module', + enforce: 'pre', + load: { + filter: { + id: compilerVirtualModuleIdPattern ?? /$^/, + }, + async handler(id) { + const environment = environmentByName.get(this.environment.name) + if (!environment || !compilerVirtualModuleIdPattern) { + return null + } + + const loadVirtualModule = () => + loadCompilerVirtualModule(compilerPlugins, { + id, + root, + env: environment.type, + envName: this.environment.name, + }) + + try { + return loadVirtualModule() + } catch (error) { + if (!(error instanceof MissingHydrateSourceError)) { + throw error + } + } + + const sourceId = cleanId(id) + await loadViteModuleFromEnvironment(this.environment, sourceId, { + load: (options) => this.load(options), + error: (message) => this.error(message), + }) + + return loadVirtualModule() + }, + }, + }, + // Validate server function ID in dev mode + { + name: 'tanstack-start-core:validate-server-fn-id', + apply: 'serve', + load: { + filter: { + id: new RegExp(resolveViteId(validateServerFnIdVirtualModule)), + }, + async handler(id) { + const parsed = parseIdQuery(id) + const fnId = parsed.query.id + if (fnId && serverFnsById[fnId]) { + return `export {}` + } + + // ID not yet registered — the source file may not have been + // transformed in this dev session yet (e.g. cold restart with + // cached client). Try to decode the ID, discover the source + // file, trigger its compilation, and re-check. + if (fnId) { + try { + const decoded = JSON.parse( + Buffer.from(fnId, 'base64url').toString('utf8'), + ) + if ( + typeof decoded.file === 'string' && + typeof decoded.export === 'string' + ) { + // Use the Vite when to decode the module specifier + // back to the original source file path. + const sourceFile = decodeViteDevServerModuleSpecifier( + decoded.file, + ) + + if (sourceFile) { + // Resolve to absolute path + const absPath = resolvePath(root, sourceFile) + + // Trigger transform of the source file in this environment, + // which will compile createServerFn calls and populate + // serverFnsById as a side effect. + if (this.environment.mode !== 'dev') { + this.error( + `could not validate server function ID ${fnId}: unknown environment mode ${this.environment.mode}`, + ) + } + + await this.environment.transformRequest( + `${absPath}?${SERVER_FN_LOOKUP}`, + ) + + // Re-check after lazy compilation + if (serverFnsById[fnId]) { + return `export {}` + } + } + } + } catch { + // Decoding or fetching failed — fall through to error + } + } + + this.error(`Invalid server function ID: ${fnId}`) + }, + }, + }, + // Manifest plugin for server environments + createVirtualModule({ + name: 'tanstack-start-core:server-fn-resolver', + moduleId: VIRTUAL_MODULES.serverFnResolver, + enforce: 'pre', + applyToEnvironment: (env) => { + return appliedResolverEnvironments.has(env.name) + }, + load() { + if (this.environment.name !== opts.providerEnvName) { + const mod = opts.environments.find( + (e) => e.name === this.environment.name, + )?.getServerFnById + if (mod) { + return mod + } + + this.error( + `No getServerFnById implementation found for caller environment: ${this.environment.name}`, + ) + } + + if (this.environment.mode !== 'build') { + return getDevServerFnValidatorModule() + } + + // When SSR is the provider, server-only-referenced functions aren't in the manifest, + // so no isClientReferenced check is needed. + // When SSR is NOT the provider (custom provider env), server-only-referenced + // functions ARE in the manifest and need the isClientReferenced check to + // block direct client HTTP requests to server-only-referenced functions. + return generateServerFnResolverModule({ + serverFnsById, + includeClientReferencedCheck: !ssrIsProvider, + }) + }, + }), + ] +} diff --git a/packages/start-plugin-core/src/vite/start-manifest-plugin/normalized-client-build.ts b/packages/start-plugin-core/src/vite/start-manifest-plugin/normalized-client-build.ts new file mode 100644 index 0000000000..c14609bc6a --- /dev/null +++ b/packages/start-plugin-core/src/vite/start-manifest-plugin/normalized-client-build.ts @@ -0,0 +1,186 @@ +import { tsrSplit } from '@tanstack/router-plugin' +import { tssHydrate } from '../../hydration-constants' +import { getCssAssetSource } from '../../start-manifest-plugin/inlineCss' +import type { Rollup } from 'vite' +import type { NormalizedClientBuild, NormalizedClientChunk } from '../../types' + +export function normalizeViteClientChunk( + chunk: Rollup.OutputChunk, +): NormalizedClientChunk { + return { + fileName: chunk.fileName, + isEntry: chunk.isEntry, + imports: chunk.imports, + dynamicImports: chunk.dynamicImports, + css: Array.from(chunk.viteMetadata?.importedCss ?? []), + routeFilePaths: getRouteFilePathsFromModuleIds(chunk.moduleIds), + hydrationIds: getHydrationIdsFromModuleIds(chunk.moduleIds), + } +} + +export function normalizeViteClientChunks( + clientBundle: Rollup.OutputBundle, +): ReadonlyMap { + const chunksByFileName = new Map() + + for (const fileName in clientBundle) { + const bundleEntry = clientBundle[fileName]! + if (bundleEntry.type !== 'chunk') { + continue + } + + const normalizedChunk = normalizeViteClientChunk(bundleEntry) + chunksByFileName.set(normalizedChunk.fileName, normalizedChunk) + } + + return chunksByFileName +} + +export function normalizeViteClientBuild( + clientBundle: Rollup.OutputBundle, +): NormalizedClientBuild { + let entryChunkFileName: string | undefined + const chunksByFileName = normalizeViteClientChunks(clientBundle) + const chunkFileNamesByRouteFilePath = new Map>() + const cssFilesBySourcePath = new Map>() + const cssContentByFileName = new Map() + + for (const chunk of chunksByFileName.values()) { + const bundleEntry = clientBundle[chunk.fileName] as Rollup.OutputChunk + + if (chunk.isEntry) { + if (entryChunkFileName) { + throw new Error( + `multiple entries detected: ${entryChunkFileName} ${chunk.fileName}`, + ) + } + entryChunkFileName = chunk.fileName + } + + for (const routeFilePath of chunk.routeFilePaths) { + let chunkFileNames = chunkFileNamesByRouteFilePath.get(routeFilePath) + if (chunkFileNames === undefined) { + chunkFileNames = [] + chunkFileNamesByRouteFilePath.set(routeFilePath, chunkFileNames) + } + chunkFileNames.push(chunk.fileName) + } + + for (const moduleId of bundleEntry.moduleIds) { + const queryIndex = moduleId.indexOf('?') + const sourcePath = + queryIndex >= 0 ? moduleId.slice(0, queryIndex) : moduleId + if (!sourcePath) continue + + const existing = cssFilesBySourcePath.get(sourcePath) + cssFilesBySourcePath.set( + sourcePath, + existing + ? Array.from(new Set([...existing, ...chunk.css])) + : chunk.css.slice(), + ) + } + } + + for (const fileName in clientBundle) { + if (!fileName.endsWith('.css')) { + continue + } + + const bundleEntry = clientBundle[fileName]! + if (bundleEntry.type !== 'asset') { + continue + } + + const css = getCssAssetSource(bundleEntry.source) + if (css !== undefined) { + cssContentByFileName.set(fileName, css) + } + } + + if (!entryChunkFileName) { + throw new Error('No entry file found') + } + + return { + entryChunkFileName, + chunksByFileName, + chunkFileNamesByRouteFilePath, + cssFilesBySourcePath, + cssContentByFileName, + } +} + +export function getRouteFilePathsFromModuleIds(moduleIds: Array) { + let routeFilePaths: Array | undefined + let seenRouteFilePaths: Set | undefined + + for (const moduleId of moduleIds) { + const queryIndex = moduleId.indexOf('?') + + if (queryIndex < 0) { + continue + } + + const query = moduleId.slice(queryIndex + 1) + + if (!query.includes(tsrSplit)) { + continue + } + + if (!new URLSearchParams(query).has(tsrSplit)) { + continue + } + + const routeFilePath = moduleId.slice(0, queryIndex) + + if (seenRouteFilePaths?.has(routeFilePath)) { + continue + } + + if (routeFilePaths === undefined || seenRouteFilePaths === undefined) { + routeFilePaths = [] + seenRouteFilePaths = new Set() + } + + routeFilePaths.push(routeFilePath) + seenRouteFilePaths.add(routeFilePath) + } + + return routeFilePaths ?? [] +} + +export function getHydrationIdsFromModuleIds(moduleIds: Array) { + let hydrationIds: Array | undefined + let seen: Set | undefined + + for (const moduleId of moduleIds) { + const queryIndex = moduleId.indexOf('?') + + if (queryIndex < 0) { + continue + } + + const query = moduleId.slice(queryIndex + 1) + + if (!query.includes(tssHydrate)) { + continue + } + + const hydrationId = new URLSearchParams(query).get(tssHydrate) + + if (!hydrationId || seen?.has(hydrationId)) { + continue + } + + if (hydrationIds === undefined || seen === undefined) { + hydrationIds = [] + seen = new Set() + } + + hydrationIds.push(hydrationId) + seen.add(hydrationId) + } + + return hydrationIds ?? [] +} diff --git a/packages/start-plugin-core/src/vite/start-manifest-plugin/plugin.ts b/packages/start-plugin-core/src/vite/start-manifest-plugin/plugin.ts new file mode 100644 index 0000000000..9b9c274520 --- /dev/null +++ b/packages/start-plugin-core/src/vite/start-manifest-plugin/plugin.ts @@ -0,0 +1,163 @@ +import { joinURL } from 'ufo' +import { VIRTUAL_MODULES } from '@tanstack/start-server-core' +import { rootRouteId } from '@tanstack/router-core' +import { DEV_CLIENT_ENTRY, START_ENVIRONMENT_NAMES } from '../../constants' +import { + buildStartManifest, + createManifestAssetResolvers, + serializeStartManifest, +} from '../../start-manifest-plugin/manifestBuilder' +import { createVirtualModule } from '../createVirtualModule' +import { normalizeViteClientBuild } from './normalized-client-build' +import type { GetConfigFn, NormalizedClientBuild } from '../../types' +import type { PluginOption, Rollup } from 'vite' + +type StartManifestEnvironment = { + config: { + command: string + environments?: Record + } +} + +export function startManifestPlugin(opts: { + getConfig: GetConfigFn +}): PluginOption { + let clientBuild: NormalizedClientBuild | undefined + let cssCodeSplitDisabledFileName: string | undefined + + return [ + { + name: 'tanstack-start:start-manifest-capture-client-build', + applyToEnvironment(environment) { + return environment.name === START_ENVIRONMENT_NAMES.client + }, + enforce: 'post', + generateBundle(_options, bundle) { + if (this.environment.name !== START_ENVIRONMENT_NAMES.client) { + throw new Error( + `Unexpected environment for client build capture: ${this.environment.name}`, + ) + } + + clientBuild = normalizeViteClientBuild(bundle) + cssCodeSplitDisabledFileName = getAssetFileNameByName( + bundle, + 'style.css', + ) + }, + }, + createVirtualModule({ + name: 'tanstack-start:start-manifest-plugin', + moduleId: VIRTUAL_MODULES.startManifest, + enforce: 'pre', + load() { + const { resolvedStartConfig, startConfig } = opts.getConfig() + const clientEntry = getDevClientEntry({ + basePath: resolvedStartConfig.basePaths.publicBase, + bundledDev: isClientBundledDev(this.environment), + }) + + if (this.environment.name !== START_ENVIRONMENT_NAMES.server) { + return getEmptyStartManifestModule(clientEntry) + } + + if (this.environment.config.command === 'serve') { + return getEmptyStartManifestModule(clientEntry) + } + + const routeTreeRoutes = globalThis.TSS_ROUTES_MANIFEST + // TODO this needs further discussion with vite-rsc, this is a temporary workaround + // If the client bundle isn't available yet (e.g., during RSC scan builds), + // return a dummy manifest. The real manifest will be generated in the actual build. + if (!clientBuild) { + return getEmptyStartManifestModule(clientEntry) + } + const startManifest = buildStartManifest({ + clientBuild, + routeTreeRoutes, + basePath: resolvedStartConfig.basePaths.publicBase, + inlineCss: startConfig.server.build.inlineCss, + additionalRouteAssets: getViteAdditionalRouteAssets({ + cssCodeSplitDisabledFileName, + basePath: resolvedStartConfig.basePaths.publicBase, + cssCodeSplit: this.environment.config.build.cssCodeSplit, + }), + }) + + return `export const tsrStartManifest = () => (${serializeStartManifest(startManifest)})` + }, + }), + ] +} + +function getViteAdditionalRouteAssets(options: { + cssCodeSplitDisabledFileName: string | undefined + basePath: string + cssCodeSplit: boolean | undefined +}) { + if (options.cssCodeSplit !== false) { + return undefined + } + + if (!options.cssCodeSplitDisabledFileName) { + throw new Error( + "TanStack Start could not find Vite's generated `style.css` manifest entry while `build.cssCodeSplit` is disabled", + ) + } + + const { getStylesheetLink } = createManifestAssetResolvers(options.basePath) + + return { + [rootRouteId]: [getStylesheetLink(options.cssCodeSplitDisabledFileName)], + } +} + +function getAssetFileNameByName( + bundle: Rollup.OutputBundle, + assetName: string, +) { + for (const fileName in bundle) { + const bundleEntry = bundle[fileName]! + + if (bundleEntry.type !== 'asset') { + continue + } + + if (bundleEntry.name === assetName) { + return fileName + } + + if ('names' in bundleEntry && bundleEntry.names.includes(assetName)) { + return fileName + } + } + + return undefined +} + +function getEmptyStartManifestModule(clientEntry: string) { + return `export const tsrStartManifest = () => ({ + routes: { + __root__: { + preloads: ['${clientEntry}'], + scripts: [{ attrs: { type: 'module', async: true, src: '${clientEntry}' } }], + }, + }, + })` +} + +function getDevClientEntry(opts: { basePath: string; bundledDev: boolean }) { + if (opts.bundledDev) { + return joinURL(opts.basePath, 'assets', 'index.js') + } + + return joinURL(opts.basePath, '@id', DEV_CLIENT_ENTRY) +} + +function isClientBundledDev(environment: StartManifestEnvironment) { + return ( + environment.config.command === 'serve' && + environment.config.environments?.[START_ENVIRONMENT_NAMES.client] + ?.isBundled === true + ) +} diff --git a/packages/start-plugin-core/src/start-router-plugin/plugin.ts b/packages/start-plugin-core/src/vite/start-router-plugin/plugin.ts similarity index 65% rename from packages/start-plugin-core/src/start-router-plugin/plugin.ts rename to packages/start-plugin-core/src/vite/start-router-plugin/plugin.ts index 1536d19c91..e4f06893a7 100644 --- a/packages/start-plugin-core/src/start-router-plugin/plugin.ts +++ b/packages/start-plugin-core/src/vite/start-router-plugin/plugin.ts @@ -1,23 +1,25 @@ +import { createRouterPluginContext } from '@tanstack/router-plugin/context' import { tanStackRouterCodeSplitter, - tanstackRouterAutoImport, tanstackRouterGenerator, } from '@tanstack/router-plugin/vite' -import { normalizePath } from 'vite' import path from 'pathe' -import { VITE_ENVIRONMENT_NAMES } from '../constants' -import { routesManifestPlugin } from './generator-plugins/routes-manifest-plugin' -import { prerenderRoutesPlugin } from './generator-plugins/prerender-routes-plugin' -import { pruneServerOnlySubtrees } from './pruneServerOnlySubtrees' -import { SERVER_PROP } from './constants' -import type { GetConfigFn, TanStackStartVitePluginCoreOptions } from '../types' +import { normalizePath } from 'vite' +import { VITE_ENVIRONMENT_NAMES } from '../../constants' +import { routesManifestPlugin } from '../../start-router-plugin/generator-plugins/routes-manifest-plugin' +import { prerenderRoutesPlugin } from '../../start-router-plugin/generator-plugins/prerender-routes-plugin' +import { buildRouteTreeFileFooterFromConfig } from '../../start-router-plugin/route-tree-footer' +import { pruneServerOnlySubtrees } from '../../start-router-plugin/pruneServerOnlySubtrees' +import { SERVER_PROP } from '../../start-router-plugin/constants' +import type { GetConfigFn } from '../../types' +import type { TanStackStartVitePluginCoreOptions } from '../types' import type { Generator, GeneratorPlugin, RouteNode, } from '@tanstack/router-generator' import type { DevEnvironment, Plugin, PluginOption } from 'vite' -import type { TanStackStartInputConfig } from '../schema' +import type { TanStackStartInputConfig } from '../../schema' function isServerOnlyNode(node: RouteNode | undefined) { if (!node?.createFileRouteProps) { @@ -29,68 +31,13 @@ function isServerOnlyNode(node: RouteNode | undefined) { ) } -function moduleDeclaration({ - startFilePath, - routerFilePath, - corePluginOpts, - generatedRouteTreePath, -}: { - startFilePath: string | undefined - routerFilePath: string - corePluginOpts: TanStackStartVitePluginCoreOptions - generatedRouteTreePath: string -}): string { - function getImportPath(absolutePath: string) { - let relativePath = path.relative( - path.dirname(generatedRouteTreePath), - absolutePath, - ) - - if (!relativePath.startsWith('.')) { - relativePath = './' + relativePath - } - - // convert to POSIX-style for ESM imports (important on Windows) - relativePath = relativePath.split(path.sep).join('/') - return relativePath - } - - const result: Array = [ - `import type { getRouter } from '${getImportPath(routerFilePath)}'`, - ] - if (startFilePath) { - result.push( - `import type { startInstance } from '${getImportPath(startFilePath)}'`, - ) - } - // make sure we import something from start to get the server route declaration merge - else { - result.push( - `import type { createStart } from '@tanstack/${corePluginOpts.framework}-start'`, - ) - } - result.push( - `declare module '@tanstack/${corePluginOpts.framework}-start' { - interface Register { - ssr: true - router: Awaited>`, - ) - if (startFilePath) { - result.push( - ` config: Awaited>`, - ) - } - result.push(` } -}`) - - return result.join('\n') -} - export function tanStackStartRouter( startPluginOpts: TanStackStartInputConfig, getConfig: GetConfigFn, corePluginOpts: TanStackStartVitePluginCoreOptions, ): Array { + const routerPluginContext = createRouterPluginContext() + const getGeneratedRouteTreePath = () => { const { startConfig } = getConfig() return path.resolve(startConfig.router.generatedRouteTree) @@ -131,23 +78,12 @@ export function tanStackStartRouter( if (routeTreeFileFooter) { return routeTreeFileFooter } - const { startConfig, resolvedStartConfig } = getConfig() - const ogRouteTreeFileFooter = startConfig.router.routeTreeFileFooter - if (ogRouteTreeFileFooter) { - if (Array.isArray(ogRouteTreeFileFooter)) { - routeTreeFileFooter = ogRouteTreeFileFooter - } else { - routeTreeFileFooter = ogRouteTreeFileFooter() - } - } routeTreeFileFooter = [ - moduleDeclaration({ + ...buildRouteTreeFileFooterFromConfig({ generatedRouteTreePath: getGeneratedRouteTreePath(), + getConfig, corePluginOpts, - startFilePath: resolvedStartConfig.startFilePath, - routerFilePath: resolvedStartConfig.routerFilePath, }), - ...(routeTreeFileFooter ?? []), ] return routeTreeFileFooter } @@ -211,7 +147,7 @@ export function tanStackStartRouter( tanstackRouterGenerator(() => { const routerConfig = getConfig().startConfig.router const plugins = [clientTreeGeneratorPlugin, routesManifestPlugin()] - if (startPluginOpts?.prerender?.enabled === true) { + if (startPluginOpts.prerender?.enabled === true) { plugins.push(prerenderRoutesPlugin()) } return { @@ -220,7 +156,7 @@ export function tanStackStartRouter( routeTreeFileFooter: getRouteTreeFileFooter, plugins, } - }), + }, routerPluginContext), tanStackRouterCodeSplitter(() => { const routerConfig = getConfig().startConfig.router return { @@ -234,7 +170,7 @@ export function tanStackStartRouter( vite: { environmentName: VITE_ENVIRONMENT_NAMES.client }, }, } - }), + }, routerPluginContext), tanStackRouterCodeSplitter(() => { const routerConfig = getConfig().startConfig.router return { @@ -247,7 +183,6 @@ export function tanStackStartRouter( vite: { environmentName: VITE_ENVIRONMENT_NAMES.server }, }, } - }), - tanstackRouterAutoImport(startPluginOpts?.router), + }, routerPluginContext), ] } diff --git a/packages/start-plugin-core/src/vite/types.ts b/packages/start-plugin-core/src/vite/types.ts new file mode 100644 index 0000000000..4b98551268 --- /dev/null +++ b/packages/start-plugin-core/src/vite/types.ts @@ -0,0 +1,18 @@ +import type { TanStackStartCoreOptions } from '../types' + +export interface ViteRscForwardSsrResolverStrategy { + type: 'vite-rsc-forward' + sourceEnvironmentName: string + sourceEntry: string + exportName: 'getServerFnById' +} + +export type SsrResolverStrategy = + | { type: 'default' } + | ViteRscForwardSsrResolverStrategy + +export type TanStackStartVitePluginCoreOptions = TanStackStartCoreOptions & { + providerEnvironmentName: string + ssrIsProvider: boolean + ssrResolverStrategy: SsrResolverStrategy +} diff --git a/packages/start-plugin-core/tests/clientOnlyJSX/clientOnlyJSX.test.ts b/packages/start-plugin-core/tests/clientOnlyJSX/clientOnlyJSX.test.ts index fedb3851f0..4f645d73db 100644 --- a/packages/start-plugin-core/tests/clientOnlyJSX/clientOnlyJSX.test.ts +++ b/packages/start-plugin-core/tests/clientOnlyJSX/clientOnlyJSX.test.ts @@ -5,7 +5,7 @@ import { describe, expect, test } from 'vitest' import { detectKindsInCode, StartCompiler, -} from '../../src/start-compiler-plugin/compiler' +} from '../../src/start-compiler/compiler' // Default test options for StartCompiler function getDefaultTestOptions(env: 'client' | 'server') { @@ -38,6 +38,7 @@ async function compile(opts: { kind: 'ClientOnlyJSX', }, ], + getKnownServerFns: () => ({}), resolveId: async (id) => { return id }, diff --git a/packages/start-plugin-core/tests/compiler.test.ts b/packages/start-plugin-core/tests/compiler.test.ts index a063ea3ffe..94780d140b 100644 --- a/packages/start-plugin-core/tests/compiler.test.ts +++ b/packages/start-plugin-core/tests/compiler.test.ts @@ -2,11 +2,11 @@ import { describe, expect, test } from 'vitest' import { StartCompiler, detectKindsInCode, -} from '../src/start-compiler-plugin/compiler' -import type { - LookupConfig, - LookupKind, -} from '../src/start-compiler-plugin/compiler' + getLookupKindsForEnv, +} from '../src/start-compiler/compiler' +import { getLookupConfigurationsForEnv } from '../src/start-compiler/config' +import type { LookupConfig, LookupKind } from '../src/start-compiler/compiler' +import type { StartCompilerImportTransform } from '../src/types' // Default test options for StartCompiler function getDefaultTestOptions(env: 'client' | 'server') { @@ -20,7 +20,12 @@ function getDefaultTestOptions(env: 'client' | 'server') { } // Helper to create a compiler with all kinds enabled -function createFullCompiler(env: 'client' | 'server') { +function createFullCompiler( + env: 'client' | 'server', + opts?: { + serverFnProviderModuleDirectives?: ReadonlyArray | undefined + }, +) { const lookupKinds: Set = env === 'client' ? new Set([ @@ -65,8 +70,59 @@ function createFullCompiler(env: 'client' | 'server') { ...getDefaultTestOptions(env), lookupKinds, lookupConfigurations, + getKnownServerFns: () => ({}), loadModule: async () => {}, resolveId: async (id) => id, + mode: 'build', + serverFnProviderModuleDirectives: opts?.serverFnProviderModuleDirectives, + }) +} + +function createExternalTransformCompiler() { + const compilerTransforms: Array = [ + { + name: 'test-render-option-injection', + environment: 'server', + imports: [ + { + libName: '@example/runtime', + rootExport: 'renderThing', + }, + ], + detect: /\brenderThing\b/, + transform: (candidates, context) => { + const t = context.types + for (const candidate of candidates) { + const args = candidate.path.node.arguments + if (args.length !== 1) continue + args.push( + t.objectExpression([ + t.objectProperty( + t.identifier('injected'), + context.parseExpression('loadThing()'), + ), + ]), + ) + } + }, + }, + ] + + return new StartCompiler({ + env: 'server', + envName: 'server', + root: '/test', + framework: 'react', + providerEnvName: 'server', + lookupKinds: getLookupKindsForEnv('server', { compilerTransforms }), + lookupConfigurations: getLookupConfigurationsForEnv('server', 'react', { + compilerTransforms, + }), + getKnownServerFns: () => ({}), + loadModule: async () => {}, + resolveId: async (id) => id, + mode: 'build', + compilerTransforms, }) } @@ -129,6 +185,29 @@ describe('detectKindsInCode', () => { new Set(['ClientOnlyFn']), ) }) + + test('resets external transform regex state between detections', () => { + const compilerTransforms: Array = [ + { + name: 'global-detect', + environment: 'server', + imports: [{ libName: '@example/runtime', rootExport: 'renderThing' }], + detect: /\brenderThing\b/g, + transform: () => {}, + }, + ] + const code = ` + import { renderThing } from '@example/runtime' + renderThing() + ` + + expect(detectKindsInCode(code, 'server', { compilerTransforms })).toEqual( + new Set(['External:global-detect']), + ) + expect(detectKindsInCode(code, 'server', { compilerTransforms })).toEqual( + new Set(['External:global-detect']), + ) + }) }) describe('detects multiple kinds in same file', () => { @@ -378,6 +457,105 @@ describe('compiler handles multiple files with different kinds', () => { }) }) +describe('compiler handles external import transforms', () => { + test('runs configured direct-call transforms before server function extraction', async () => { + const compiler = createExternalTransformCompiler() + + const result = await compiler.compile({ + code: ` + import { createServerFn } from '@tanstack/react-start' + import { renderThing as renderAlias } from '@example/runtime' + + export const getComponent = createServerFn({ method: 'GET' }).handler(async () => { + return renderAlias() + }) + `, + id: '/test/src/routes/card.tsx?tss-serverfn-split', + }) + + expect(result).not.toBeNull() + expect(result!.code).toContain('injected: loadThing()') + expect(result!.code).toContain('renderAlias(,') + }) + + test('runs configured direct-call transforms for namespace imports', async () => { + const compiler = createExternalTransformCompiler() + + const result = await compiler.compile({ + code: ` + import * as runtime from '@example/runtime' + + export const component = runtime.renderThing() + `, + id: '/test/src/routes/card.tsx', + }) + + expect(result).not.toBeNull() + expect(result!.code).toContain('injected: loadThing()') + expect(result!.code).toContain('runtime.renderThing(,') + }) + + test('does not run external transforms for shadowed import names', async () => { + const compiler = createExternalTransformCompiler() + + const result = await compiler.compile({ + code: ` + import { renderThing } from '@example/runtime' + + export function component() { + const renderThing = (node: React.ReactNode) => node + return renderThing() + } + `, + id: '/test/src/routes/card.tsx', + }) + + expect(result).toBeNull() + }) +}) + +describe('server function provider module directives', () => { + const code = ` + import { createServerFn } from '@tanstack/react-start' + + export const getMessage = createServerFn({ method: 'GET' }).handler(() => { + return 'hello' + }) + ` + + test('does not add module directives without compiler configuration', async () => { + const compiler = createFullCompiler('server') + + const result = await compiler.compile({ + code, + id: '/test/src/routes/message.tsx?tss-serverfn-split', + }) + + expect(result).not.toBeNull() + expect(result!.code).not.toContain('"use server-entry"') + }) + + test('adds configured module directives to provider files only', async () => { + const compiler = createFullCompiler('server', { + serverFnProviderModuleDirectives: ['use server-entry'], + }) + + const providerResult = await compiler.compile({ + code, + id: '/test/src/routes/message.tsx?tss-serverfn-split', + }) + const callerResult = await compiler.compile({ + code, + id: '/test/src/routes/message.tsx', + }) + + expect(providerResult).not.toBeNull() + expect(providerResult!.code).toContain('"use server-entry";') + expect(callerResult).not.toBeNull() + expect(callerResult!.code).not.toContain('"use server-entry"') + }) +}) + describe('edge cases for detectedKinds', () => { test('empty detectedKinds returns null (no candidates to process)', async () => { const compiler = createFullCompiler('client') @@ -440,6 +618,7 @@ test('ingestModule handles empty code gracefully', () => { ...getDefaultTestOptions('client'), lookupKinds: new Set(['ServerFn']), lookupConfigurations: [], + getKnownServerFns: () => ({}), loadModule: async () => {}, resolveId: async (id) => id, }) @@ -455,6 +634,53 @@ test('ingestModule handles empty code gracefully', () => { }).not.toThrow() }) +test('compile caches modules without detected candidates for transitive importer traversal', async () => { + const compiler = new StartCompiler({ + env: 'client', + ...getDefaultTestOptions('client'), + lookupKinds: new Set(['ServerFn']), + lookupConfigurations: [], + getKnownServerFns: () => ({}), + loadModule: async () => {}, + resolveId: async (source, importer) => { + if (source === './leaf' && importer === '/src/plain.ts') { + return '/src/leaf.ts' + } + + if (source === './plain' && importer === '/src/parent.ts') { + return '/src/plain.ts' + } + + return null + }, + }) + + await compiler.compile({ + id: '/src/plain.ts', + code: ` + import { value } from './leaf' + export const plain = value + `, + detectedKinds: new Set(), + }) + + await compiler.compile({ + id: '/src/parent.ts', + code: ` + import { plain } from './plain' + export const parent = plain + `, + detectedKinds: new Set(), + }) + + expect(await compiler.getTransitiveImporters('/src/leaf.ts')).toEqual( + new Set(['/src/plain.ts', '/src/parent.ts']), + ) + expect(await compiler.getTransitiveImporters(['/src/leaf.ts'])).toEqual( + new Set(['/src/plain.ts', '/src/parent.ts']), + ) +}) + describe('calling result of createServerOnlyFn/createClientOnlyFn', () => { // This tests the fix for https://github.com/TanStack/router/issues/6643 // When a file has both createServerFn and createServerOnlyFn, and the result @@ -523,6 +749,7 @@ describe('calling result of createServerOnlyFn/createClientOnlyFn', () => { providerEnvName: 'ssr', lookupKinds: new Set(['ServerOnlyFn', 'ClientOnlyFn']), lookupConfigurations: [], + getKnownServerFns: () => ({}), loadModule: async (id) => { const code = virtualModules[id] if (code) { @@ -615,6 +842,7 @@ describe('re-export chain resolution', () => { providerEnvName: 'ssr', lookupKinds, lookupConfigurations: [], + getKnownServerFns: () => ({}), loadModule: async (id) => { const code = virtualModules[id] if (code) { @@ -706,6 +934,7 @@ describe('re-export chain resolution', () => { providerEnvName: 'ssr', lookupKinds: new Set(['IsomorphicFn', 'ServerOnlyFn', 'ClientOnlyFn']), lookupConfigurations: [], + getKnownServerFns: () => ({}), loadModule: async (id) => { const code = deeperVirtualModules[id] if (code) { @@ -726,4 +955,314 @@ describe('re-export chain resolution', () => { expect(result!.code).toContain('deep-client') expect(result!.code).not.toContain('deep-server') }) + + test.each([ + { + name: 'named re-export cycle', + virtualModules: { + './factory-a': ` + export { createServerOnlyFn } from './factory-b' + `, + './factory-b': ` + export { createServerOnlyFn } from './factory-a' + `, + }, + }, + { + name: 'import alias cycle', + virtualModules: { + './factory-a': ` + import { createServerOnlyFn } from './factory-b' + export { createServerOnlyFn } + `, + './factory-b': ` + import { createServerOnlyFn } from './factory-a' + export { createServerOnlyFn } + `, + }, + }, + { + name: 'export-star cycle', + virtualModules: { + './factory-a': ` + export * from './factory-b' + `, + './factory-b': ` + export * from './factory-a' + `, + }, + }, + ])('handles circular import chain: $name', async ({ virtualModules }) => { + const compiler: StartCompiler = new StartCompiler({ + env: 'server', + envName: 'ssr', + root: '/test', + framework: 'react' as const, + providerEnvName: 'ssr', + lookupKinds: new Set(['ServerOnlyFn']), + lookupConfigurations: [], + getKnownServerFns: () => ({}), + loadModule: async (id) => { + const code = virtualModules[id as keyof typeof virtualModules] + if (code) { + compiler.ingestModule({ code, id }) + } + }, + resolveId: async (id) => { + return id in virtualModules ? id : null + }, + mode: 'build', + }) + + const result = await compiler.compile({ + id: 'circular-import-test.ts', + code: ` + import { createServerOnlyFn } from './factory-a' + const myFn = createServerOnlyFn(() => 'server-only-value') + `, + }) + + expect(result).toBeNull() + }) + + test('ingestModule populates module metadata for later resolution', async () => { + const compiler: StartCompiler = new StartCompiler({ + env: 'server', + envName: 'ssr', + root: '/test', + framework: 'react' as const, + providerEnvName: 'ssr', + lookupKinds: new Set(['ServerOnlyFn']), + lookupConfigurations: [], + getKnownServerFns: () => ({}), + loadModule: async () => {}, + resolveId: async (id) => { + return id === '@tanstack/start-client-core' ? id : null + }, + mode: 'build', + }) + + compiler.ingestModule({ + id: '@tanstack/start-client-core', + code: ` + export { createServerOnlyFn } from '@tanstack/start-fn-stubs' + `, + }) + + const result = await compiler.compile({ + id: 'cached-module-test.ts', + code: ` + import { createServerOnlyFn } from '@tanstack/start-client-core' + const myFn = createServerOnlyFn(() => 'cached-server-only-value') + `, + }) + + expect(result).not.toBeNull() + expect(result!.code).toContain('cached-server-only-value') + }) + + test('invalidateModule clears cached module resolution state', async () => { + const virtualModules: Record = { + './factory': ` + export { createServerOnlyFn } from './factory-inner' + `, + './factory-inner': ` + export { createServerOnlyFn } from '@tanstack/start-fn-stubs' + `, + } + + const compiler: StartCompiler = new StartCompiler({ + env: 'server', + envName: 'ssr', + root: '/test', + framework: 'react' as const, + providerEnvName: 'ssr', + lookupKinds: new Set(['ServerOnlyFn', 'ClientOnlyFn']), + lookupConfigurations: [], + getKnownServerFns: () => ({}), + loadModule: async (id) => { + const code = virtualModules[id] + if (code) { + compiler.ingestModule({ code, id }) + } + }, + resolveId: async (id) => { + return virtualModules[id] ? id : null + }, + mode: 'build', + }) + + const source = ` + import { createServerOnlyFn } from './factory' + const myFn = createServerOnlyFn(() => 'server-only-value') + ` + + const initialResult = await compiler.compile({ + id: 'transitive-invalidation-test.ts', + code: source, + }) + + expect(initialResult).not.toBeNull() + expect(initialResult!.code).toContain('server-only-value') + expect(initialResult!.code).not.toContain('throw new Error') + + virtualModules['./factory-inner'] = ` + export { createClientOnlyFn as createServerOnlyFn } from '@tanstack/start-fn-stubs' + ` + + expect(compiler.invalidateModule('./factory-inner')).toBe(true) + + const updatedResult = await compiler.compile({ + id: 'transitive-invalidation-test.ts', + code: source, + }) + + expect(updatedResult).not.toBeNull() + expect(updatedResult!.code).toContain('throw new Error') + expect(updatedResult!.code).not.toContain('server-only-value') + }) + + test('invalidateModule preserves root lookup metadata while clearing importer memoization', async () => { + const virtualModules: Record = { + './factory': ` + export { createServerOnlyFn } from './factory-inner' + `, + './factory-inner': ` + export { createServerOnlyFn } from '@tanstack/start-fn-stubs' + `, + } + + const compiler: StartCompiler = new StartCompiler({ + env: 'server', + envName: 'ssr', + root: '/test', + framework: 'react' as const, + providerEnvName: 'ssr', + lookupKinds: new Set(['ServerOnlyFn', 'ClientOnlyFn']), + lookupConfigurations: [ + { + libName: '@tanstack/react-start', + rootExport: 'createServerOnlyFn', + kind: 'ServerOnlyFn', + }, + { + libName: '@tanstack/react-start', + rootExport: 'createClientOnlyFn', + kind: 'ClientOnlyFn', + }, + ], + getKnownServerFns: () => ({}), + loadModule: async (id) => { + const code = virtualModules[id] + if (code) { + compiler.ingestModule({ code, id }) + } + }, + resolveId: async (id) => { + return virtualModules[id] ? id : null + }, + }) + + const source = ` + import { createServerOnlyFn } from './factory' + const myFn = createServerOnlyFn(() => 'server-only-value') + ` + + const initialResult = await compiler.compile({ + id: 'memoized-invalidation-test.ts', + code: source, + }) + + expect(initialResult).not.toBeNull() + expect(initialResult!.code).toContain('server-only-value') + + virtualModules['./factory-inner'] = ` + export { createClientOnlyFn as createServerOnlyFn } from '@tanstack/start-fn-stubs' + ` + + expect(compiler.invalidateModule('./factory-inner')).toBe(true) + + const updatedResult = await compiler.compile({ + id: 'memoized-invalidation-test.ts', + code: source, + }) + + expect(updatedResult).not.toBeNull() + expect(updatedResult!.code).toContain('throw new Error') + expect(updatedResult!.code).not.toContain('server-only-value') + }) + + test('recompiles aliased env-only direct calls when only server function syntax is detected', async () => { + const virtualModules: Record = { + './factory': ` + export { createServerOnlyFn } from '@tanstack/start-fn-stubs' + `, + } + + const compiler: StartCompiler = new StartCompiler({ + env: 'server', + envName: 'ssr', + root: '/test', + framework: 'react' as const, + providerEnvName: 'ssr', + mode: 'build', + lookupKinds: new Set(['ServerFn', 'ServerOnlyFn', 'ClientOnlyFn']), + lookupConfigurations: [ + { + libName: '@tanstack/react-start', + rootExport: 'createServerFn', + kind: 'Root', + }, + ], + getKnownServerFns: () => ({}), + loadModule: async (id) => { + const code = virtualModules[id] + if (code) { + compiler.ingestModule({ code, id }) + } + }, + resolveId: async (id) => { + return virtualModules[id] ? id : null + }, + }) + + const source = ` + import { createServerFn } from '@tanstack/react-start' + import { createServerOnlyFn as createServerFnHmrFactory } from './factory' + + const serverOnlyImpl = createServerFnHmrFactory(() => 'server-only-value') + + export const serverFn = createServerFn().handler(async () => { + return serverOnlyImpl() + }) + ` + + const providerId = 'aliased-env-only-server-fn.ts?tss-serverfn-split' + + const initialResult = await compiler.compile({ + id: providerId, + code: source, + detectedKinds: new Set(['ServerFn']), + }) + + expect(initialResult).not.toBeNull() + expect(initialResult!.code).toContain('server-only-value') + expect(initialResult!.code).not.toContain('throw new Error') + + virtualModules['./factory'] = ` + export { createClientOnlyFn as createServerOnlyFn } from '@tanstack/start-fn-stubs' + ` + + expect(compiler.invalidateModule('./factory')).toBe(true) + + const updatedResult = await compiler.compile({ + id: providerId, + code: source, + detectedKinds: new Set(['ServerFn']), + }) + + expect(updatedResult).not.toBeNull() + expect(updatedResult!.code).toContain('throw new Error') + expect(updatedResult!.code).not.toContain('server-only-value') + }) }) diff --git a/packages/start-plugin-core/tests/createIsomorphicFn/createIsomorphicFn.test.ts b/packages/start-plugin-core/tests/createIsomorphicFn/createIsomorphicFn.test.ts index ca29207145..c36c117692 100644 --- a/packages/start-plugin-core/tests/createIsomorphicFn/createIsomorphicFn.test.ts +++ b/packages/start-plugin-core/tests/createIsomorphicFn/createIsomorphicFn.test.ts @@ -2,7 +2,7 @@ import { readFile, readdir } from 'node:fs/promises' import path from 'node:path' import { describe, expect, test } from 'vitest' -import { StartCompiler } from '../../src/start-compiler-plugin/compiler' +import { StartCompiler } from '../../src/start-compiler/compiler' // Default test options for StartCompiler function getDefaultTestOptions(env: 'client' | 'server') { @@ -34,6 +34,7 @@ async function compile(opts: { kind: 'IsomorphicFn', }, ], + getKnownServerFns: () => ({}), resolveId: async (id) => { return id }, diff --git a/packages/start-plugin-core/tests/createMiddleware/createMiddleware.test.ts b/packages/start-plugin-core/tests/createMiddleware/createMiddleware.test.ts index 04e6d0d219..e300baf6a9 100644 --- a/packages/start-plugin-core/tests/createMiddleware/createMiddleware.test.ts +++ b/packages/start-plugin-core/tests/createMiddleware/createMiddleware.test.ts @@ -1,7 +1,7 @@ import { readFile, readdir } from 'node:fs/promises' import path from 'node:path' import { describe, expect, test, vi } from 'vitest' -import { StartCompiler } from '../../src/start-compiler-plugin/compiler' +import { StartCompiler } from '../../src/start-compiler/compiler' // Default test options for StartCompiler function getDefaultTestOptions(env: 'client' | 'server') { @@ -42,6 +42,7 @@ async function compile(opts: { kind: 'Root', }, ], + getKnownServerFns: () => ({}), resolveId: async (id) => { return id }, @@ -93,6 +94,7 @@ describe('createMiddleware compiles correctly', async () => { kind: 'Root', }, ], + getKnownServerFns: () => ({}), resolveId: resolveIdMock, }) @@ -101,15 +103,9 @@ describe('createMiddleware compiles correctly', async () => { id: 'test.ts', }) - // resolveId should only be called once during init() for the library itself - // It should NOT be called again to resolve the import binding because - // the fast path uses knownRootImports map for O(1) lookup - // Note: init() now resolves from project root, not from a specific file - expect(resolveIdMock).toHaveBeenCalledTimes(1) - expect(resolveIdMock).toHaveBeenCalledWith( - '@tanstack/react-start', - undefined, - ) + // Direct known-library imports use the knownRootImports fast path, so they + // do not need resolveId. + expect(resolveIdMock).not.toHaveBeenCalled() }) test('should use slow path for factory pattern (resolveId called for import resolution)', async () => { @@ -145,6 +141,7 @@ describe('createMiddleware compiles correctly', async () => { kind: 'Root', }, ], + getKnownServerFns: () => ({}), resolveId: resolveIdMock, }) @@ -153,18 +150,122 @@ describe('createMiddleware compiles correctly', async () => { id: 'test.ts', }) - // resolveId should be called exactly twice: - // 1. Once during init() for '@tanstack/react-start' (no importer - resolved from project root) - // 2. Once to resolve './factory' import (slow path - not in knownRootImports) + // resolveId should only be called for './factory'. Direct known-library + // imports use the knownRootImports fast path. // // Note: The factory module's import from '@tanstack/react-start' ALSO uses // the fast path (knownRootImports), so no additional resolveId call is needed there. - expect(resolveIdMock).toHaveBeenCalledTimes(2) - expect(resolveIdMock).toHaveBeenNthCalledWith( - 1, - '@tanstack/react-start', - undefined, - ) - expect(resolveIdMock).toHaveBeenNthCalledWith(2, './factory', 'test.ts') + expect(resolveIdMock).toHaveBeenCalledTimes(1) + expect(resolveIdMock).toHaveBeenNthCalledWith(1, './factory', 'test.ts') + }) + + test('should resolve createMiddleware from start-client-core implementation file', async () => { + const virtualModules: Record = { + '@tanstack/start-client-core': ` + export { createMiddleware } from './createMiddleware' + export { createIsomorphicFn } from '@tanstack/start-fn-stubs' + `, + '/virtual/compiler-known/middleware-factory.ts': ` + export const createMiddleware = () => ({ + server: () => createMiddleware(), + }) + `, + } + + const compiler = new StartCompiler({ + env: 'client', + ...getDefaultTestOptions('client'), + loadModule: async (id) => { + const code = virtualModules[id] + if (code) { + compiler.ingestModule({ code, id }) + } + }, + lookupKinds: new Set(['Middleware', 'IsomorphicFn']), + lookupConfigurations: [], + getKnownServerFns: () => ({}), + resolveId: async (source) => { + if (source === '@tanstack/start-client-core') { + return '@tanstack/start-client-core' + } + + if (source === './createMiddleware') { + return '/virtual/compiler-known/middleware-factory.ts' + } + + return null + }, + }) + + const result = await compiler.compile({ + id: '/repo/packages/start-client-core/src/createCsrfMiddleware.ts', + code: ` + import { createIsomorphicFn } from '@tanstack/start-fn-stubs' + import { createMiddleware } from './createMiddleware' + + const innerCreateCsrfMiddleware = () => { + return createMiddleware().server(() => 'server-only-middleware') + } + + export const createCsrfMiddleware = createIsomorphicFn() + .server(innerCreateCsrfMiddleware) + `, + }) + + expect(result).not.toBeNull() + expect(result!.code).not.toContain('server-only-middleware') + expect(result!.code).not.toContain('createIsomorphicFn') + }) + + test('should resolve namespace createMiddleware from start-client-core implementation file', async () => { + const virtualModules: Record = { + '@tanstack/start-client-core': ` + export { createMiddleware } from './createMiddleware' + `, + '/virtual/compiler-known/middleware-factory.ts': ` + export const createMiddleware = () => ({ + server: () => createMiddleware(), + }) + `, + } + + const compiler = new StartCompiler({ + env: 'client', + ...getDefaultTestOptions('client'), + loadModule: async (id) => { + const code = virtualModules[id] + if (code) { + compiler.ingestModule({ code, id }) + } + }, + lookupKinds: new Set(['Middleware']), + lookupConfigurations: [], + getKnownServerFns: () => ({}), + resolveId: async (source) => { + if (source === '@tanstack/start-client-core') { + return '@tanstack/start-client-core' + } + + if (source === './createMiddleware') { + return '/virtual/compiler-known/middleware-factory.ts' + } + + return null + }, + }) + + const result = await compiler.compile({ + id: '/repo/packages/start-client-core/src/internal.ts', + code: ` + import * as middlewareModule from './createMiddleware' + + export const middleware = middlewareModule.createMiddleware().server(() => { + return 'server-only-middleware' + }) + `, + }) + + expect(result).not.toBeNull() + expect(result!.code).not.toContain('server-only-middleware') }) }) diff --git a/packages/start-plugin-core/tests/createServerFn/createServerFn.test.ts b/packages/start-plugin-core/tests/createServerFn/createServerFn.test.ts index a99eed371f..8b2716db77 100644 --- a/packages/start-plugin-core/tests/createServerFn/createServerFn.test.ts +++ b/packages/start-plugin-core/tests/createServerFn/createServerFn.test.ts @@ -1,7 +1,7 @@ import { readFile, readdir } from 'node:fs/promises' import path from 'node:path' import { describe, expect, test, vi } from 'vitest' -import { StartCompiler } from '../../src/start-compiler-plugin/compiler' +import { StartCompiler } from '../../src/start-compiler/compiler' // Default test options for StartCompiler function getDefaultTestOptions(env: 'client' | 'server') { @@ -23,7 +23,9 @@ const TSS_SERVERFN_SPLIT_PARAM = 'tss-serverfn-split' async function compile(opts: { env: 'client' | 'server' code: string + parserFilename?: string isProviderFile: boolean + mode: 'dev' | 'build' }) { // Use an absolute path inside the test root to ensure consistent filename output let id = '/test/src/test.ts' @@ -46,6 +48,7 @@ async function compile(opts: { kind: 'Root', }, ], + getKnownServerFns: () => ({}), resolveId: async (id) => { return id }, @@ -53,6 +56,7 @@ async function compile(opts: { const result = await compiler.compile({ code: opts.code, id, + parserFilename: opts.parserFilename, }) return result } @@ -75,6 +79,8 @@ describe('createServerFn compiles correctly', async () => { env: env.type, isProviderFile: env.isProviderFile, code, + parserFilename: `/test/src/${filename}`, + mode: 'build', }) const folder = @@ -101,6 +107,7 @@ describe('createServerFn compiles correctly', async () => { code, env: 'client', isProviderFile: false, + mode: 'build', }) // Server caller (route file - no split param) @@ -109,6 +116,7 @@ describe('createServerFn compiles correctly', async () => { code, env: 'server', isProviderFile: false, + mode: 'build', }) // Server provider (extracted file - has split param) @@ -117,19 +125,20 @@ describe('createServerFn compiles correctly', async () => { code, env: 'server', isProviderFile: true, + mode: 'build', }) expect(compiledResultClient!.code).toMatchInlineSnapshot(` "import { createClientRpc } from '@tanstack/react-start/client-rpc'; import { createServerFn } from '@tanstack/react-start'; - const myServerFn = createServerFn().handler(createClientRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJteVNlcnZlckZuX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ"));" + const myServerFn = createServerFn().handler(createClientRpc("2c205add8e6755de551521133ddff3d48859b1631add5f1bbe5c48a5664f319b"));" `) // Server caller: no second argument (implementation from extracted chunk) expect(compiledResultServerCaller!.code).toMatchInlineSnapshot(` "import { createSsrRpc } from '@tanstack/react-start/ssr-rpc'; import { createServerFn } from '@tanstack/react-start'; - const myServerFn = createServerFn().handler(createSsrRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJteVNlcnZlckZuX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", () => import("/test/src/test.ts?tss-serverfn-split").then(m => m["myServerFn_createServerFn_handler"])));" + const myServerFn = createServerFn().handler(createSsrRpc("2c205add8e6755de551521133ddff3d48859b1631add5f1bbe5c48a5664f319b"));" `) // Server provider: has second argument (this is the implementation file) @@ -140,7 +149,7 @@ describe('createServerFn compiles correctly', async () => { return 'hello from the server'; }; const myServerFn_createServerFn_handler = createServerRpc({ - id: "eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJteVNlcnZlckZuX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", + id: "2c205add8e6755de551521133ddff3d48859b1631add5f1bbe5c48a5664f319b", name: "myServerFn", filename: "src/test.ts" }, opts => myServerFn.__executeServer(opts)); @@ -166,13 +175,14 @@ describe('createServerFn compiles correctly', async () => { code, env: 'client', isProviderFile: false, + mode: 'build', }) expect(compiledResult!.code).toMatchInlineSnapshot(` "import { createClientRpc } from '@tanstack/react-start/client-rpc'; import { createServerFn } from '@tanstack/react-start'; - export const exportedFn = createServerFn().handler(createClientRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJleHBvcnRlZEZuX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ")); - const nonExportedFn = createServerFn().handler(createClientRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJub25FeHBvcnRlZEZuX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ"));" + export const exportedFn = createServerFn().handler(createClientRpc("c306c96e9256c7604f2a6022c4c94eb89f863274c022bc45b03970f067ea9864")); + const nonExportedFn = createServerFn().handler(createClientRpc("f4403dc0b18e216dfe0a9711cab028bc1b9768175daa9236d7115e29c99d76c2"));" `) // Server caller (route file) - no second argument @@ -180,13 +190,14 @@ describe('createServerFn compiles correctly', async () => { code, env: 'server', isProviderFile: false, + mode: 'build', }) expect(compiledResultServerCaller!.code).toMatchInlineSnapshot(` "import { createSsrRpc } from '@tanstack/react-start/ssr-rpc'; import { createServerFn } from '@tanstack/react-start'; - export const exportedFn = createServerFn().handler(createSsrRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJleHBvcnRlZEZuX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", () => import("/test/src/test.ts?tss-serverfn-split").then(m => m["exportedFn_createServerFn_handler"]))); - const nonExportedFn = createServerFn().handler(createSsrRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJub25FeHBvcnRlZEZuX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", () => import("/test/src/test.ts?tss-serverfn-split").then(m => m["nonExportedFn_createServerFn_handler"])));" + export const exportedFn = createServerFn().handler(createSsrRpc("c306c96e9256c7604f2a6022c4c94eb89f863274c022bc45b03970f067ea9864")); + const nonExportedFn = createServerFn().handler(createSsrRpc("f4403dc0b18e216dfe0a9711cab028bc1b9768175daa9236d7115e29c99d76c2"));" `) // Server provider (extracted file) - has second argument @@ -194,6 +205,7 @@ describe('createServerFn compiles correctly', async () => { code, env: 'server', isProviderFile: true, + mode: 'build', }) expect(compiledResultServerProvider!.code).toMatchInlineSnapshot(` @@ -201,7 +213,7 @@ describe('createServerFn compiles correctly', async () => { import { createServerFn } from '@tanstack/react-start'; const exportedVar = 'exported'; const exportedFn_createServerFn_handler = createServerRpc({ - id: "eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJleHBvcnRlZEZuX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", + id: "c306c96e9256c7604f2a6022c4c94eb89f863274c022bc45b03970f067ea9864", name: "exportedFn", filename: "src/test.ts" }, opts => exportedFn.__executeServer(opts)); @@ -210,7 +222,7 @@ describe('createServerFn compiles correctly', async () => { }); const nonExportedVar = 'non-exported'; const nonExportedFn_createServerFn_handler = createServerRpc({ - id: "eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJub25FeHBvcnRlZEZuX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", + id: "f4403dc0b18e216dfe0a9711cab028bc1b9768175daa9236d7115e29c99d76c2", name: "nonExportedFn", filename: "src/test.ts" }, opts => nonExportedFn.__executeServer(opts)); @@ -242,7 +254,9 @@ describe('createServerFn compiles correctly', async () => { kind: 'Root', }, ], + getKnownServerFns: () => ({}), resolveId: resolveIdMock, + mode: 'build', }) await compiler.compile({ @@ -250,14 +264,9 @@ describe('createServerFn compiles correctly', async () => { id: '/test/src/test.ts', }) - // resolveId should only be called once during init() for the library itself - // It should NOT be called again to resolve the import binding because - // the fast path uses knownRootImports map for O(1) lookup - expect(resolveIdMock).toHaveBeenCalledTimes(1) - expect(resolveIdMock).toHaveBeenCalledWith( - '@tanstack/react-start', - undefined, - ) + // Direct known-library imports use the knownRootImports fast path, so they + // do not need resolveId. + expect(resolveIdMock).not.toHaveBeenCalled() }) test('should use slow path for factory pattern (resolveId called for import resolution)', async () => { @@ -293,7 +302,9 @@ describe('createServerFn compiles correctly', async () => { kind: 'Root', }, ], + getKnownServerFns: () => ({}), resolveId: resolveIdMock, + mode: 'build', }) await compiler.compile({ @@ -301,22 +312,267 @@ describe('createServerFn compiles correctly', async () => { id: '/test/src/test.ts', }) - // resolveId should be called exactly twice: - // 1. Once during init() for '@tanstack/react-start' - // 2. Once to resolve './factory' import (slow path - not in knownRootImports) + // resolveId should only be called for './factory'. Direct known-library + // imports use the knownRootImports fast path. // // Note: The factory module's import from '@tanstack/react-start' ALSO uses // the fast path (knownRootImports), so no additional resolveId call is needed there. - expect(resolveIdMock).toHaveBeenCalledTimes(2) + expect(resolveIdMock).toHaveBeenCalledTimes(1) expect(resolveIdMock).toHaveBeenNthCalledWith( 1, - '@tanstack/react-start', - undefined, - ) - expect(resolveIdMock).toHaveBeenNthCalledWith( - 2, './factory', '/test/src/test.ts', ) }) + + test('should resolve local named re-exports of createServerFn', async () => { + const code = ` + import { createFooServerFn } from './factory' + const myServerFn = createFooServerFn().handler(async () => { + return 'hello' + })` + + const resolveIdMock = vi.fn(async (id: string) => id) + + const compiler = new StartCompiler({ + env: 'client', + ...getDefaultTestOptions('client'), + loadModule: async (id) => { + if (id === './factory') { + compiler.ingestModule({ + code: ` + export { createServerFn as createFooServerFn } from '@tanstack/react-start' + `, + id: './factory', + }) + } + }, + lookupKinds: new Set(['ServerFn']), + lookupConfigurations: [ + { + libName: '@tanstack/react-start', + rootExport: 'createServerFn', + kind: 'Root', + }, + ], + getKnownServerFns: () => ({}), + resolveId: resolveIdMock, + mode: 'build', + }) + + const result = await compiler.compile({ + code, + id: '/test/src/test.ts', + }) + + expect(result).not.toBeNull() + expect(result!.code).toContain('createClientRpc') + expect(resolveIdMock).toHaveBeenCalledTimes(1) + expect(resolveIdMock).toHaveBeenNthCalledWith( + 1, + './factory', + '/test/src/test.ts', + ) + }) + + test('should resolve export-star re-export chains of createServerFn', async () => { + const code = ` + import { createFooServerFn } from './factory' + const myServerFn = createFooServerFn().handler(async () => { + return 'hello' + })` + + const resolveIdMock = vi.fn(async (id: string) => id) + + const compiler = new StartCompiler({ + env: 'client', + ...getDefaultTestOptions('client'), + loadModule: async (id) => { + if (id === './factory') { + compiler.ingestModule({ + code: ` + export * from './factory-inner' + `, + id: './factory', + }) + } + + if (id === './factory-inner') { + compiler.ingestModule({ + code: ` + export { createServerFn as createFooServerFn } from '@tanstack/react-start' + `, + id: './factory-inner', + }) + } + }, + lookupKinds: new Set(['ServerFn']), + lookupConfigurations: [ + { + libName: '@tanstack/react-start', + rootExport: 'createServerFn', + kind: 'Root', + }, + ], + getKnownServerFns: () => ({}), + resolveId: resolveIdMock, + mode: 'build', + }) + + const result = await compiler.compile({ + code, + id: '/test/src/test.ts', + }) + + expect(result).not.toBeNull() + expect(result!.code).toContain('createClientRpc') + expect(resolveIdMock).toHaveBeenCalledTimes(2) + expect(resolveIdMock).toHaveBeenNthCalledWith( + 1, + './factory', + '/test/src/test.ts', + ) + expect(resolveIdMock).toHaveBeenNthCalledWith( + 2, + './factory-inner', + './factory', + ) + }) + + test('reuses deduped custom IDs across compiler instances', async () => { + const serverFnsById: Record< + string, + { + functionName: string + functionId: string + extractedFilename: string + filename: string + isClientReferenced?: boolean + } + > = {} + + function createCompiler() { + return new StartCompiler({ + env: 'server', + ...getDefaultTestOptions('server'), + mode: 'build', + loadModule: async () => {}, + lookupKinds: new Set(['ServerFn']), + lookupConfigurations: [ + { + libName: '@tanstack/react-start', + rootExport: 'createServerFn', + kind: 'Root', + }, + ], + resolveId: async (id) => id, + generateFunctionId: ({ functionName }) => + functionName === 'greetUser_createServerFn_handler' + ? 'constant_id' + : undefined, + getKnownServerFns: () => serverFnsById, + onServerFnsById: (discovered) => { + Object.assign(serverFnsById, discovered) + }, + }) + } + + const firstCompiler = createCompiler() + await firstCompiler.compile({ + code: ` + import { createServerFn } from '@tanstack/react-start' + export const greetUser = createServerFn().handler(async () => 'first') + `, + id: '/test/src/submit-post-formdata.tsx', + }) + + await firstCompiler.compile({ + code: ` + import { createServerFn } from '@tanstack/react-start' + export const greetUser = createServerFn().handler(async () => 'second') + `, + id: '/test/src/formdata-redirect/index.tsx', + }) + + expect( + Object.values(serverFnsById) + .map((serverFn) => serverFn.functionId) + .sort(), + ).toEqual(['constant_id', 'constant_id_1']) + + const secondCompiler = createCompiler() + const firstResult = await secondCompiler.compile({ + code: ` + import { createServerFn } from '@tanstack/react-start' + export const greetUser = createServerFn().handler(async () => 'first') + `, + id: '/test/src/submit-post-formdata.tsx', + }) + + const secondResult = await secondCompiler.compile({ + code: ` + import { createServerFn } from '@tanstack/react-start' + export const greetUser = createServerFn().handler(async () => 'second') + `, + id: '/test/src/formdata-redirect/index.tsx', + }) + + expect(firstResult!.code).toContain('createSsrRpc("constant_id"') + expect(secondResult!.code).toContain('createSsrRpc("constant_id_1"') + }) + + test('should resolve createServerFn from the same binding as a known root export', async () => { + const virtualModules: Record = { + '@tanstack/start-client-core': ` + export { createServerFn } from './createServerFn' + `, + '/virtual/compiler-known/server-fn-factory.ts': ` + export const createServerFn = () => ({ + handler: () => createServerFn(), + }) + `, + } + + const compiler = new StartCompiler({ + env: 'client', + ...getDefaultTestOptions('client'), + root: '/test', + mode: 'build', + loadModule: async (id) => { + const code = virtualModules[id] + if (code) { + compiler.ingestModule({ code, id }) + } + }, + lookupKinds: new Set(['ServerFn']), + lookupConfigurations: [], + getKnownServerFns: () => ({}), + resolveId: async (source) => { + if (source === '@tanstack/start-client-core') { + return '@tanstack/start-client-core' + } + + if (source === './createServerFn') { + return '/virtual/compiler-known/server-fn-factory.ts' + } + + return null + }, + }) + + const result = await compiler.compile({ + id: '/test/src/internal-server-fn.ts', + code: ` + import { createServerFn } from './createServerFn' + + export const getMessage = createServerFn().handler(() => { + return 'server-only-value' + }) + `, + }) + + expect(result).not.toBeNull() + expect(result!.code).toContain('createClientRpc') + expect(result!.code).not.toContain('server-only-value') + }) }) diff --git a/packages/start-plugin-core/tests/createServerFn/snapshots/client/createServerFnDestructured.tsx b/packages/start-plugin-core/tests/createServerFn/snapshots/client/createServerFnDestructured.tsx index 51f40ea4f7..2c0e54f9c9 100644 --- a/packages/start-plugin-core/tests/createServerFn/snapshots/client/createServerFnDestructured.tsx +++ b/packages/start-plugin-core/tests/createServerFn/snapshots/client/createServerFnDestructured.tsx @@ -2,22 +2,22 @@ import { createClientRpc } from '@tanstack/react-start/client-rpc'; import { createServerFn } from '@tanstack/react-start'; export const withUseServer = createServerFn({ method: 'GET' -}).handler(createClientRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVXNlU2VydmVyX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ")); +}).handler(createClientRpc("b6fe31e85836ae6c65d8ab262dd1af6a68620aeef609029d50127f4cceaaf320")); export const withArrowFunction = createServerFn({ method: 'GET' -}).handler(createClientRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoQXJyb3dGdW5jdGlvbl9jcmVhdGVTZXJ2ZXJGbl9oYW5kbGVyIn0")); +}).handler(createClientRpc("a311dfd9a6554bc0bb9371ef4fbc72c852d0b5532829a2613a29157b8595a793")); export const withArrowFunctionAndFunction = createServerFn({ method: 'GET' -}).handler(createClientRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoQXJyb3dGdW5jdGlvbkFuZEZ1bmN0aW9uX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ")); +}).handler(createClientRpc("dbe1f77c6ea7590bce3212a75b06d3cee83b425bcf493014cb47462ef725e36e")); export const withoutUseServer = createServerFn({ method: 'GET' -}).handler(createClientRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRob3V0VXNlU2VydmVyX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ")); +}).handler(createClientRpc("c0d9fdeb2b01aafecc782f439416b86f666cb5334ac9a934546b177e5698bbb2")); export const withVariable = createServerFn({ method: 'GET' -}).handler(createClientRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVmFyaWFibGVfY3JlYXRlU2VydmVyRm5faGFuZGxlciJ9")); +}).handler(createClientRpc("7d36cb30c30bd688b9773bd7f85a0d51d83f868255e127605e4f236615fefe70")); export const withZodValidator = createServerFn({ method: 'GET' -}).handler(createClientRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoWm9kVmFsaWRhdG9yX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ")); +}).handler(createClientRpc("43606a369c85444a332f701d6399564b6a3691aabab63dfc9a0b7c341fb798f3")); export const withValidatorFn = createServerFn({ method: 'GET' -}).handler(createClientRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVmFsaWRhdG9yRm5fY3JlYXRlU2VydmVyRm5faGFuZGxlciJ9")); \ No newline at end of file +}).handler(createClientRpc("5cf922ac733d835fee496964cbf0b4b4067cb43d51f2efa484d072e6bb7dae44")); \ No newline at end of file diff --git a/packages/start-plugin-core/tests/createServerFn/snapshots/client/createServerFnDestructuredRename.tsx b/packages/start-plugin-core/tests/createServerFn/snapshots/client/createServerFnDestructuredRename.tsx index 2d2dfaf15a..e55318337d 100644 --- a/packages/start-plugin-core/tests/createServerFn/snapshots/client/createServerFnDestructuredRename.tsx +++ b/packages/start-plugin-core/tests/createServerFn/snapshots/client/createServerFnDestructuredRename.tsx @@ -2,13 +2,13 @@ import { createClientRpc } from '@tanstack/react-start/client-rpc'; import { createServerFn as serverFn } from '@tanstack/react-start'; export const withUseServer = serverFn({ method: 'GET' -}).handler(createClientRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVXNlU2VydmVyX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ")); +}).handler(createClientRpc("b6fe31e85836ae6c65d8ab262dd1af6a68620aeef609029d50127f4cceaaf320")); export const withoutUseServer = serverFn({ method: 'GET' -}).handler(createClientRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRob3V0VXNlU2VydmVyX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ")); +}).handler(createClientRpc("c0d9fdeb2b01aafecc782f439416b86f666cb5334ac9a934546b177e5698bbb2")); export const withVariable = serverFn({ method: 'GET' -}).handler(createClientRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVmFyaWFibGVfY3JlYXRlU2VydmVyRm5faGFuZGxlciJ9")); +}).handler(createClientRpc("7d36cb30c30bd688b9773bd7f85a0d51d83f868255e127605e4f236615fefe70")); export const withZodValidator = serverFn({ method: 'GET' -}).handler(createClientRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoWm9kVmFsaWRhdG9yX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ")); \ No newline at end of file +}).handler(createClientRpc("43606a369c85444a332f701d6399564b6a3691aabab63dfc9a0b7c341fb798f3")); \ No newline at end of file diff --git a/packages/start-plugin-core/tests/createServerFn/snapshots/client/createServerFnStarImport.tsx b/packages/start-plugin-core/tests/createServerFn/snapshots/client/createServerFnStarImport.tsx index 16a447fa01..5b33829a38 100644 --- a/packages/start-plugin-core/tests/createServerFn/snapshots/client/createServerFnStarImport.tsx +++ b/packages/start-plugin-core/tests/createServerFn/snapshots/client/createServerFnStarImport.tsx @@ -2,13 +2,13 @@ import { createClientRpc } from '@tanstack/react-start/client-rpc'; import * as TanStackStart from '@tanstack/react-start'; export const withUseServer = TanStackStart.createServerFn({ method: 'GET' -}).handler(createClientRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVXNlU2VydmVyX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ")); +}).handler(createClientRpc("b6fe31e85836ae6c65d8ab262dd1af6a68620aeef609029d50127f4cceaaf320")); export const withoutUseServer = TanStackStart.createServerFn({ method: 'GET' -}).handler(createClientRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRob3V0VXNlU2VydmVyX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ")); +}).handler(createClientRpc("c0d9fdeb2b01aafecc782f439416b86f666cb5334ac9a934546b177e5698bbb2")); export const withVariable = TanStackStart.createServerFn({ method: 'GET' -}).handler(createClientRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVmFyaWFibGVfY3JlYXRlU2VydmVyRm5faGFuZGxlciJ9")); +}).handler(createClientRpc("7d36cb30c30bd688b9773bd7f85a0d51d83f868255e127605e4f236615fefe70")); export const withZodValidator = TanStackStart.createServerFn({ method: 'GET' -}).handler(createClientRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoWm9kVmFsaWRhdG9yX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ")); \ No newline at end of file +}).handler(createClientRpc("43606a369c85444a332f701d6399564b6a3691aabab63dfc9a0b7c341fb798f3")); \ No newline at end of file diff --git a/packages/start-plugin-core/tests/createServerFn/snapshots/client/createServerFnValidator.tsx b/packages/start-plugin-core/tests/createServerFn/snapshots/client/createServerFnValidator.tsx index 5e1b05659e..056535d0bc 100644 --- a/packages/start-plugin-core/tests/createServerFn/snapshots/client/createServerFnValidator.tsx +++ b/packages/start-plugin-core/tests/createServerFn/snapshots/client/createServerFnValidator.tsx @@ -2,4 +2,4 @@ import { createClientRpc } from '@tanstack/react-start/client-rpc'; import { createServerFn } from '@tanstack/react-start'; export const withUseServer = createServerFn({ method: 'GET' -}).handler(createClientRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVXNlU2VydmVyX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ")); \ No newline at end of file +}).handler(createClientRpc("b6fe31e85836ae6c65d8ab262dd1af6a68620aeef609029d50127f4cceaaf320")); \ No newline at end of file diff --git a/packages/start-plugin-core/tests/createServerFn/snapshots/client/factory.tsx b/packages/start-plugin-core/tests/createServerFn/snapshots/client/factory.tsx index ded08d457c..436b8ab4cb 100644 --- a/packages/start-plugin-core/tests/createServerFn/snapshots/client/factory.tsx +++ b/packages/start-plugin-core/tests/createServerFn/snapshots/client/factory.tsx @@ -24,8 +24,8 @@ const adminMiddleware = createMiddleware({ }); export const createAuthServerFn = createServerFn().middleware([authMiddleware]); const createAdminServerFn = createAuthServerFn().middleware([adminMiddleware]); -export const myAuthedFn = createAuthServerFn().handler(createClientRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJteUF1dGhlZEZuX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ")); -export const deleteUserFn = createAdminServerFn().handler(createClientRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJkZWxldGVVc2VyRm5fY3JlYXRlU2VydmVyRm5faGFuZGxlciJ9")); +export const myAuthedFn = createAuthServerFn().handler(createClientRpc("3bb88b23926fa224cea3dcfb877026757733d95b42e3b66cf7f06bb89dab06a3")); +export const deleteUserFn = createAdminServerFn().handler(createClientRpc("44d9483a9412daaacaa5a8aee6b02294333a0e61b5d3b17ba6bcb34fd2bdce31")); function createFakeFn() { return { handler: cb => { diff --git a/packages/start-plugin-core/tests/createServerFn/snapshots/client/isomorphic-fns.tsx b/packages/start-plugin-core/tests/createServerFn/snapshots/client/isomorphic-fns.tsx index 0a013b8db1..020d1346e4 100644 --- a/packages/start-plugin-core/tests/createServerFn/snapshots/client/isomorphic-fns.tsx +++ b/packages/start-plugin-core/tests/createServerFn/snapshots/client/isomorphic-fns.tsx @@ -3,9 +3,9 @@ import { createFileRoute } from '@tanstack/react-router'; import { createIsomorphicFn, createServerFn } from '@tanstack/react-start'; import { useState } from 'react'; const getEnv = createIsomorphicFn().server(() => 'server').client(() => 'client'); -const getServerEnv = createServerFn().handler(createClientRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJnZXRTZXJ2ZXJFbnZfY3JlYXRlU2VydmVyRm5faGFuZGxlciJ9")); +const getServerEnv = createServerFn().handler(createClientRpc("6049dd46bc00e0980e387f3e74924b40e92f37634a3fe74a1a1facda9e9207c2")); const getEcho = createIsomorphicFn().server((input: string) => 'server received ' + input).client(input => 'client received ' + input); -const getServerEcho = createServerFn().handler(createClientRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJnZXRTZXJ2ZXJFY2hvX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ")); +const getServerEcho = createServerFn().handler(createClientRpc("ebb82e0293952b7b1dde3f664dec4c139471c046d06d4dc4ca172f4f45e386d1")); export const Route = createFileRoute('/isomorphic-fns')({ component: RouteComponent, loader() { diff --git a/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/createServerFnDestructured.tsx b/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/createServerFnDestructured.tsx index b8dbdcaae5..77fa2caa7b 100644 --- a/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/createServerFnDestructured.tsx +++ b/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/createServerFnDestructured.tsx @@ -3,22 +3,22 @@ import { createServerFn } from '@tanstack/react-start'; import { z } from 'zod'; export const withUseServer = createServerFn({ method: 'GET' -}).handler(createSsrRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVXNlU2VydmVyX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", () => import("/test/src/test.ts?tss-serverfn-split").then(m => m["withUseServer_createServerFn_handler"]))); +}).handler(createSsrRpc("b6fe31e85836ae6c65d8ab262dd1af6a68620aeef609029d50127f4cceaaf320")); export const withArrowFunction = createServerFn({ method: 'GET' -}).handler(createSsrRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoQXJyb3dGdW5jdGlvbl9jcmVhdGVTZXJ2ZXJGbl9oYW5kbGVyIn0", () => import("/test/src/test.ts?tss-serverfn-split").then(m => m["withArrowFunction_createServerFn_handler"]))); +}).handler(createSsrRpc("a311dfd9a6554bc0bb9371ef4fbc72c852d0b5532829a2613a29157b8595a793")); export const withArrowFunctionAndFunction = createServerFn({ method: 'GET' -}).handler(createSsrRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoQXJyb3dGdW5jdGlvbkFuZEZ1bmN0aW9uX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", () => import("/test/src/test.ts?tss-serverfn-split").then(m => m["withArrowFunctionAndFunction_createServerFn_handler"]))); +}).handler(createSsrRpc("dbe1f77c6ea7590bce3212a75b06d3cee83b425bcf493014cb47462ef725e36e")); export const withoutUseServer = createServerFn({ method: 'GET' -}).handler(createSsrRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRob3V0VXNlU2VydmVyX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", () => import("/test/src/test.ts?tss-serverfn-split").then(m => m["withoutUseServer_createServerFn_handler"]))); +}).handler(createSsrRpc("c0d9fdeb2b01aafecc782f439416b86f666cb5334ac9a934546b177e5698bbb2")); export const withVariable = createServerFn({ method: 'GET' -}).handler(createSsrRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVmFyaWFibGVfY3JlYXRlU2VydmVyRm5faGFuZGxlciJ9", () => import("/test/src/test.ts?tss-serverfn-split").then(m => m["withVariable_createServerFn_handler"]))); +}).handler(createSsrRpc("7d36cb30c30bd688b9773bd7f85a0d51d83f868255e127605e4f236615fefe70")); export const withZodValidator = createServerFn({ method: 'GET' -}).handler(createSsrRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoWm9kVmFsaWRhdG9yX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", () => import("/test/src/test.ts?tss-serverfn-split").then(m => m["withZodValidator_createServerFn_handler"]))); +}).handler(createSsrRpc("43606a369c85444a332f701d6399564b6a3691aabab63dfc9a0b7c341fb798f3")); export const withValidatorFn = createServerFn({ method: 'GET' -}).inputValidator(z.number()).handler(createSsrRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVmFsaWRhdG9yRm5fY3JlYXRlU2VydmVyRm5faGFuZGxlciJ9", () => import("/test/src/test.ts?tss-serverfn-split").then(m => m["withValidatorFn_createServerFn_handler"]))); \ No newline at end of file +}).inputValidator(z.number()).handler(createSsrRpc("5cf922ac733d835fee496964cbf0b4b4067cb43d51f2efa484d072e6bb7dae44")); \ No newline at end of file diff --git a/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/createServerFnDestructuredRename.tsx b/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/createServerFnDestructuredRename.tsx index 815702d5d8..94a351ffa9 100644 --- a/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/createServerFnDestructuredRename.tsx +++ b/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/createServerFnDestructuredRename.tsx @@ -2,13 +2,13 @@ import { createSsrRpc } from '@tanstack/react-start/ssr-rpc'; import { createServerFn as serverFn } from '@tanstack/react-start'; export const withUseServer = serverFn({ method: 'GET' -}).handler(createSsrRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVXNlU2VydmVyX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", () => import("/test/src/test.ts?tss-serverfn-split").then(m => m["withUseServer_createServerFn_handler"]))); +}).handler(createSsrRpc("b6fe31e85836ae6c65d8ab262dd1af6a68620aeef609029d50127f4cceaaf320")); export const withoutUseServer = serverFn({ method: 'GET' -}).handler(createSsrRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRob3V0VXNlU2VydmVyX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", () => import("/test/src/test.ts?tss-serverfn-split").then(m => m["withoutUseServer_createServerFn_handler"]))); +}).handler(createSsrRpc("c0d9fdeb2b01aafecc782f439416b86f666cb5334ac9a934546b177e5698bbb2")); export const withVariable = serverFn({ method: 'GET' -}).handler(createSsrRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVmFyaWFibGVfY3JlYXRlU2VydmVyRm5faGFuZGxlciJ9", () => import("/test/src/test.ts?tss-serverfn-split").then(m => m["withVariable_createServerFn_handler"]))); +}).handler(createSsrRpc("7d36cb30c30bd688b9773bd7f85a0d51d83f868255e127605e4f236615fefe70")); export const withZodValidator = serverFn({ method: 'GET' -}).handler(createSsrRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoWm9kVmFsaWRhdG9yX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", () => import("/test/src/test.ts?tss-serverfn-split").then(m => m["withZodValidator_createServerFn_handler"]))); \ No newline at end of file +}).handler(createSsrRpc("43606a369c85444a332f701d6399564b6a3691aabab63dfc9a0b7c341fb798f3")); \ No newline at end of file diff --git a/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/createServerFnStarImport.tsx b/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/createServerFnStarImport.tsx index 2f68c8c276..74d22a2fc4 100644 --- a/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/createServerFnStarImport.tsx +++ b/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/createServerFnStarImport.tsx @@ -2,13 +2,13 @@ import { createSsrRpc } from '@tanstack/react-start/ssr-rpc'; import * as TanStackStart from '@tanstack/react-start'; export const withUseServer = TanStackStart.createServerFn({ method: 'GET' -}).handler(createSsrRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVXNlU2VydmVyX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", () => import("/test/src/test.ts?tss-serverfn-split").then(m => m["withUseServer_createServerFn_handler"]))); +}).handler(createSsrRpc("b6fe31e85836ae6c65d8ab262dd1af6a68620aeef609029d50127f4cceaaf320")); export const withoutUseServer = TanStackStart.createServerFn({ method: 'GET' -}).handler(createSsrRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRob3V0VXNlU2VydmVyX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", () => import("/test/src/test.ts?tss-serverfn-split").then(m => m["withoutUseServer_createServerFn_handler"]))); +}).handler(createSsrRpc("c0d9fdeb2b01aafecc782f439416b86f666cb5334ac9a934546b177e5698bbb2")); export const withVariable = TanStackStart.createServerFn({ method: 'GET' -}).handler(createSsrRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVmFyaWFibGVfY3JlYXRlU2VydmVyRm5faGFuZGxlciJ9", () => import("/test/src/test.ts?tss-serverfn-split").then(m => m["withVariable_createServerFn_handler"]))); +}).handler(createSsrRpc("7d36cb30c30bd688b9773bd7f85a0d51d83f868255e127605e4f236615fefe70")); export const withZodValidator = TanStackStart.createServerFn({ method: 'GET' -}).handler(createSsrRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoWm9kVmFsaWRhdG9yX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", () => import("/test/src/test.ts?tss-serverfn-split").then(m => m["withZodValidator_createServerFn_handler"]))); \ No newline at end of file +}).handler(createSsrRpc("43606a369c85444a332f701d6399564b6a3691aabab63dfc9a0b7c341fb798f3")); \ No newline at end of file diff --git a/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/createServerFnValidator.tsx b/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/createServerFnValidator.tsx index ba0b4b577e..17df72b688 100644 --- a/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/createServerFnValidator.tsx +++ b/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/createServerFnValidator.tsx @@ -3,4 +3,4 @@ import { createServerFn } from '@tanstack/react-start'; import { z } from 'zod'; export const withUseServer = createServerFn({ method: 'GET' -}).inputValidator(z.number()).handler(createSsrRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVXNlU2VydmVyX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", () => import("/test/src/test.ts?tss-serverfn-split").then(m => m["withUseServer_createServerFn_handler"]))); \ No newline at end of file +}).inputValidator(z.number()).handler(createSsrRpc("b6fe31e85836ae6c65d8ab262dd1af6a68620aeef609029d50127f4cceaaf320")); \ No newline at end of file diff --git a/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/factory.tsx b/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/factory.tsx index dbc4e764d9..e82ca932e8 100644 --- a/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/factory.tsx +++ b/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/factory.tsx @@ -24,8 +24,8 @@ const adminMiddleware = createMiddleware({ }); export const createAuthServerFn = createServerFn().middleware([authMiddleware]); const createAdminServerFn = createAuthServerFn().middleware([adminMiddleware]); -export const myAuthedFn = createAuthServerFn().handler(createSsrRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJteUF1dGhlZEZuX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", () => import("/test/src/test.ts?tss-serverfn-split").then(m => m["myAuthedFn_createServerFn_handler"]))); -export const deleteUserFn = createAdminServerFn().handler(createSsrRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJkZWxldGVVc2VyRm5fY3JlYXRlU2VydmVyRm5faGFuZGxlciJ9", () => import("/test/src/test.ts?tss-serverfn-split").then(m => m["deleteUserFn_createServerFn_handler"]))); +export const myAuthedFn = createAuthServerFn().handler(createSsrRpc("3bb88b23926fa224cea3dcfb877026757733d95b42e3b66cf7f06bb89dab06a3")); +export const deleteUserFn = createAdminServerFn().handler(createSsrRpc("44d9483a9412daaacaa5a8aee6b02294333a0e61b5d3b17ba6bcb34fd2bdce31")); function createFakeFn() { return { handler: cb => { diff --git a/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/isomorphic-fns.tsx b/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/isomorphic-fns.tsx index 02675e9e95..05c671ccfa 100644 --- a/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/isomorphic-fns.tsx +++ b/packages/start-plugin-core/tests/createServerFn/snapshots/server-caller/isomorphic-fns.tsx @@ -3,9 +3,9 @@ import { createFileRoute } from '@tanstack/react-router'; import { createIsomorphicFn, createServerFn } from '@tanstack/react-start'; import { useState } from 'react'; const getEnv = createIsomorphicFn().server(() => 'server').client(() => 'client'); -const getServerEnv = createServerFn().handler(createSsrRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJnZXRTZXJ2ZXJFbnZfY3JlYXRlU2VydmVyRm5faGFuZGxlciJ9", () => import("/test/src/test.ts?tss-serverfn-split").then(m => m["getServerEnv_createServerFn_handler"]))); +const getServerEnv = createServerFn().handler(createSsrRpc("6049dd46bc00e0980e387f3e74924b40e92f37634a3fe74a1a1facda9e9207c2")); const getEcho = createIsomorphicFn().server((input: string) => 'server received ' + input).client(input => 'client received ' + input); -const getServerEcho = createServerFn().inputValidator((input: string) => input).handler(createSsrRpc("eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJnZXRTZXJ2ZXJFY2hvX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", () => import("/test/src/test.ts?tss-serverfn-split").then(m => m["getServerEcho_createServerFn_handler"]))); +const getServerEcho = createServerFn().inputValidator((input: string) => input).handler(createSsrRpc("ebb82e0293952b7b1dde3f664dec4c139471c046d06d4dc4ca172f4f45e386d1")); export const Route = createFileRoute('/isomorphic-fns')({ component: RouteComponent, loader() { diff --git a/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/createServerFnDestructured.tsx b/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/createServerFnDestructured.tsx index 113c86dc5c..44fb6036e1 100644 --- a/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/createServerFnDestructured.tsx +++ b/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/createServerFnDestructured.tsx @@ -2,7 +2,7 @@ import { createServerRpc } from '@tanstack/react-start/server-rpc'; import { createServerFn } from '@tanstack/react-start'; import { z } from 'zod'; const withUseServer_createServerFn_handler = createServerRpc({ - id: "eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVXNlU2VydmVyX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", + id: "b6fe31e85836ae6c65d8ab262dd1af6a68620aeef609029d50127f4cceaaf320", name: "withUseServer", filename: "src/test.ts" }, opts => withUseServer.__executeServer(opts)); @@ -14,7 +14,7 @@ const withUseServer = createServerFn({ return axios.get>('https://jsonplaceholder.typicode.com/posts').then(r => r.data.slice(0, 10)); }); const withArrowFunction_createServerFn_handler = createServerRpc({ - id: "eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoQXJyb3dGdW5jdGlvbl9jcmVhdGVTZXJ2ZXJGbl9oYW5kbGVyIn0", + id: "a311dfd9a6554bc0bb9371ef4fbc72c852d0b5532829a2613a29157b8595a793", name: "withArrowFunction", filename: "src/test.ts" }, opts => withArrowFunction.__executeServer(opts)); @@ -22,7 +22,7 @@ const withArrowFunction = createServerFn({ method: 'GET' }).handler(withArrowFunction_createServerFn_handler, async () => null); const withArrowFunctionAndFunction_createServerFn_handler = createServerRpc({ - id: "eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoQXJyb3dGdW5jdGlvbkFuZEZ1bmN0aW9uX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", + id: "dbe1f77c6ea7590bce3212a75b06d3cee83b425bcf493014cb47462ef725e36e", name: "withArrowFunctionAndFunction", filename: "src/test.ts" }, opts => withArrowFunctionAndFunction.__executeServer(opts)); @@ -30,7 +30,7 @@ const withArrowFunctionAndFunction = createServerFn({ method: 'GET' }).handler(withArrowFunctionAndFunction_createServerFn_handler, async () => test()); const withoutUseServer_createServerFn_handler = createServerRpc({ - id: "eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRob3V0VXNlU2VydmVyX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", + id: "c0d9fdeb2b01aafecc782f439416b86f666cb5334ac9a934546b177e5698bbb2", name: "withoutUseServer", filename: "src/test.ts" }, opts => withoutUseServer.__executeServer(opts)); @@ -42,7 +42,7 @@ const withoutUseServer = createServerFn({ return axios.get>('https://jsonplaceholder.typicode.com/posts').then(r => r.data.slice(0, 10)); }); const withVariable_createServerFn_handler = createServerRpc({ - id: "eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVmFyaWFibGVfY3JlYXRlU2VydmVyRm5faGFuZGxlciJ9", + id: "7d36cb30c30bd688b9773bd7f85a0d51d83f868255e127605e4f236615fefe70", name: "withVariable", filename: "src/test.ts" }, opts => withVariable.__executeServer(opts)); @@ -60,7 +60,7 @@ function zodValidator(schema: TSchema, fn: }; } const withZodValidator_createServerFn_handler = createServerRpc({ - id: "eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoWm9kVmFsaWRhdG9yX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", + id: "43606a369c85444a332f701d6399564b6a3691aabab63dfc9a0b7c341fb798f3", name: "withZodValidator", filename: "src/test.ts" }, opts => withZodValidator.__executeServer(opts)); @@ -72,7 +72,7 @@ const withZodValidator = createServerFn({ }; })); const withValidatorFn_createServerFn_handler = createServerRpc({ - id: "eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVmFsaWRhdG9yRm5fY3JlYXRlU2VydmVyRm5faGFuZGxlciJ9", + id: "5cf922ac733d835fee496964cbf0b4b4067cb43d51f2efa484d072e6bb7dae44", name: "withValidatorFn", filename: "src/test.ts" }, opts => withValidatorFn.__executeServer(opts)); diff --git a/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/createServerFnDestructuredRename.tsx b/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/createServerFnDestructuredRename.tsx index 69acc54cca..fd5a36351b 100644 --- a/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/createServerFnDestructuredRename.tsx +++ b/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/createServerFnDestructuredRename.tsx @@ -2,7 +2,7 @@ import { createServerRpc } from '@tanstack/react-start/server-rpc'; import { createServerFn as serverFn } from '@tanstack/react-start'; import { z } from 'zod'; const withUseServer_createServerFn_handler = createServerRpc({ - id: "eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVXNlU2VydmVyX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", + id: "b6fe31e85836ae6c65d8ab262dd1af6a68620aeef609029d50127f4cceaaf320", name: "withUseServer", filename: "src/test.ts" }, opts => withUseServer.__executeServer(opts)); @@ -14,7 +14,7 @@ const withUseServer = serverFn({ return axios.get>('https://jsonplaceholder.typicode.com/posts').then(r => r.data.slice(0, 10)); }); const withoutUseServer_createServerFn_handler = createServerRpc({ - id: "eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRob3V0VXNlU2VydmVyX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", + id: "c0d9fdeb2b01aafecc782f439416b86f666cb5334ac9a934546b177e5698bbb2", name: "withoutUseServer", filename: "src/test.ts" }, opts => withoutUseServer.__executeServer(opts)); @@ -26,7 +26,7 @@ const withoutUseServer = serverFn({ return axios.get>('https://jsonplaceholder.typicode.com/posts').then(r => r.data.slice(0, 10)); }); const withVariable_createServerFn_handler = createServerRpc({ - id: "eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVmFyaWFibGVfY3JlYXRlU2VydmVyRm5faGFuZGxlciJ9", + id: "7d36cb30c30bd688b9773bd7f85a0d51d83f868255e127605e4f236615fefe70", name: "withVariable", filename: "src/test.ts" }, opts => withVariable.__executeServer(opts)); @@ -44,7 +44,7 @@ function zodValidator(schema: TSchema, fn: }; } const withZodValidator_createServerFn_handler = createServerRpc({ - id: "eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoWm9kVmFsaWRhdG9yX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", + id: "43606a369c85444a332f701d6399564b6a3691aabab63dfc9a0b7c341fb798f3", name: "withZodValidator", filename: "src/test.ts" }, opts => withZodValidator.__executeServer(opts)); diff --git a/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/createServerFnStarImport.tsx b/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/createServerFnStarImport.tsx index b404a17c72..e759e35f42 100644 --- a/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/createServerFnStarImport.tsx +++ b/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/createServerFnStarImport.tsx @@ -2,7 +2,7 @@ import { createServerRpc } from '@tanstack/react-start/server-rpc'; import * as TanStackStart from '@tanstack/react-start'; import { z } from 'zod'; const withUseServer_createServerFn_handler = createServerRpc({ - id: "eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVXNlU2VydmVyX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", + id: "b6fe31e85836ae6c65d8ab262dd1af6a68620aeef609029d50127f4cceaaf320", name: "withUseServer", filename: "src/test.ts" }, opts => withUseServer.__executeServer(opts)); @@ -16,7 +16,7 @@ const withUseServer = TanStackStart.createServerFn({ return axios.get>('https://jsonplaceholder.typicode.com/posts').then(r => r.data.slice(0, 10)); }); const withoutUseServer_createServerFn_handler = createServerRpc({ - id: "eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRob3V0VXNlU2VydmVyX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", + id: "c0d9fdeb2b01aafecc782f439416b86f666cb5334ac9a934546b177e5698bbb2", name: "withoutUseServer", filename: "src/test.ts" }, opts => withoutUseServer.__executeServer(opts)); @@ -28,7 +28,7 @@ const withoutUseServer = TanStackStart.createServerFn({ return axios.get>('https://jsonplaceholder.typicode.com/posts').then(r => r.data.slice(0, 10)); }); const withVariable_createServerFn_handler = createServerRpc({ - id: "eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVmFyaWFibGVfY3JlYXRlU2VydmVyRm5faGFuZGxlciJ9", + id: "7d36cb30c30bd688b9773bd7f85a0d51d83f868255e127605e4f236615fefe70", name: "withVariable", filename: "src/test.ts" }, opts => withVariable.__executeServer(opts)); @@ -46,7 +46,7 @@ function zodValidator(schema: TSchema, fn: }; } const withZodValidator_createServerFn_handler = createServerRpc({ - id: "eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoWm9kVmFsaWRhdG9yX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", + id: "43606a369c85444a332f701d6399564b6a3691aabab63dfc9a0b7c341fb798f3", name: "withZodValidator", filename: "src/test.ts" }, opts => withZodValidator.__executeServer(opts)); diff --git a/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/createServerFnValidator.tsx b/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/createServerFnValidator.tsx index 4cd2ee74f2..4904d0edfa 100644 --- a/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/createServerFnValidator.tsx +++ b/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/createServerFnValidator.tsx @@ -2,7 +2,7 @@ import { createServerRpc } from '@tanstack/react-start/server-rpc'; import { createServerFn } from '@tanstack/react-start'; import { z } from 'zod'; const withUseServer_createServerFn_handler = createServerRpc({ - id: "eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJ3aXRoVXNlU2VydmVyX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", + id: "b6fe31e85836ae6c65d8ab262dd1af6a68620aeef609029d50127f4cceaaf320", name: "withUseServer", filename: "src/test.ts" }, opts => withUseServer.__executeServer(opts)); diff --git a/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/factory.tsx b/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/factory.tsx index 6041459061..5a2c26fe0b 100644 --- a/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/factory.tsx +++ b/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/factory.tsx @@ -25,7 +25,7 @@ const adminMiddleware = createMiddleware({ const createAuthServerFn = createServerFn().middleware([authMiddleware]); const createAdminServerFn = createAuthServerFn().middleware([adminMiddleware]); const myAuthedFn_createServerFn_handler = createServerRpc({ - id: "eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJteUF1dGhlZEZuX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", + id: "3bb88b23926fa224cea3dcfb877026757733d95b42e3b66cf7f06bb89dab06a3", name: "myAuthedFn", filename: "src/test.ts" }, opts => myAuthedFn.__executeServer(opts)); @@ -33,7 +33,7 @@ const myAuthedFn = createAuthServerFn().handler(myAuthedFn_createServerFn_handle return 'myAuthedFn'; }); const deleteUserFn_createServerFn_handler = createServerRpc({ - id: "eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJkZWxldGVVc2VyRm5fY3JlYXRlU2VydmVyRm5faGFuZGxlciJ9", + id: "44d9483a9412daaacaa5a8aee6b02294333a0e61b5d3b17ba6bcb34fd2bdce31", name: "deleteUserFn", filename: "src/test.ts" }, opts => deleteUserFn.__executeServer(opts)); diff --git a/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/isomorphic-fns.tsx b/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/isomorphic-fns.tsx index 6ea0f20711..38119fd089 100644 --- a/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/isomorphic-fns.tsx +++ b/packages/start-plugin-core/tests/createServerFn/snapshots/server-provider/isomorphic-fns.tsx @@ -2,14 +2,14 @@ import { createServerRpc } from '@tanstack/react-start/server-rpc'; import { createIsomorphicFn, createServerFn } from '@tanstack/react-start'; const getEnv = createIsomorphicFn().server(() => 'server').client(() => 'client'); const getServerEnv_createServerFn_handler = createServerRpc({ - id: "eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJnZXRTZXJ2ZXJFbnZfY3JlYXRlU2VydmVyRm5faGFuZGxlciJ9", + id: "6049dd46bc00e0980e387f3e74924b40e92f37634a3fe74a1a1facda9e9207c2", name: "getServerEnv", filename: "src/test.ts" }, opts => getServerEnv.__executeServer(opts)); const getServerEnv = createServerFn().handler(getServerEnv_createServerFn_handler, () => getEnv()); const getEcho = createIsomorphicFn().server((input: string) => 'server received ' + input).client(input => 'client received ' + input); const getServerEcho_createServerFn_handler = createServerRpc({ - id: "eyJmaWxlIjoiL0BpZC9zcmMvdGVzdC50cz90c3Mtc2VydmVyZm4tc3BsaXQiLCJleHBvcnQiOiJnZXRTZXJ2ZXJFY2hvX2NyZWF0ZVNlcnZlckZuX2hhbmRsZXIifQ", + id: "ebb82e0293952b7b1dde3f664dec4c139471c046d06d4dc4ca172f4f45e386d1", name: "getServerEcho", filename: "src/test.ts" }, opts => getServerEcho.__executeServer(opts)); diff --git a/packages/start-plugin-core/tests/createVirtualModule.test.ts b/packages/start-plugin-core/tests/createVirtualModule.test.ts new file mode 100644 index 0000000000..bca42afd36 --- /dev/null +++ b/packages/start-plugin-core/tests/createVirtualModule.test.ts @@ -0,0 +1,38 @@ +import { describe, expect, test } from 'vitest' +import { createVirtualModule } from '../src/vite/createVirtualModule' + +describe('createVirtualModule', () => { + test('resolves and loads the default vite virtual id', () => { + const plugin = createVirtualModule({ + name: 'test-virtual', + moduleId: 'virtual:test-module', + load() { + return 'export const ok = true' + }, + }) + + expect((plugin as any).resolveId.handler('virtual:test-module')).toBe( + '\0virtual:test-module', + ) + expect((plugin as any).load.handler('\0virtual:test-module')).toBe( + 'export const ok = true', + ) + }) + + test('encodes hashes in resolved vite ids', () => { + const plugin = createVirtualModule({ + name: 'test-hash-module-id', + moduleId: '#virtual:test-module', + load() { + return 'export {}' + }, + }) + + expect((plugin as any).resolveId.handler('#virtual:test-module')).toBe( + '\0%23virtual:test-module', + ) + expect((plugin as any).load.handler('\0%23virtual:test-module')).toBe( + 'export {}', + ) + }) +}) diff --git a/packages/start-plugin-core/tests/csrf-warning-config.test.ts b/packages/start-plugin-core/tests/csrf-warning-config.test.ts new file mode 100644 index 0000000000..abe28087d0 --- /dev/null +++ b/packages/start-plugin-core/tests/csrf-warning-config.test.ts @@ -0,0 +1,65 @@ +import { describe, expect, test } from 'vitest' +import { parseStartConfig as parseViteStartConfig } from '../src/vite/schema' +import { parseStartConfig as parseRsbuildStartConfig } from '../src/rsbuild/schema' +import { createViteDefineConfig } from '../src/vite/planning' + +const root = process.cwd() +const corePluginOpts = { framework: 'react' as const } + +describe('disableCsrfMiddlewareWarning plugin config', () => { + test('is accepted by the vite plugin config', () => { + const config = parseViteStartConfig( + { + serverFns: { + disableCsrfMiddlewareWarning: true, + }, + }, + corePluginOpts, + root, + ) + + expect(config.serverFns.disableCsrfMiddlewareWarning).toBe(true) + }) + + test('is accepted by the rsbuild plugin config', () => { + const config = parseRsbuildStartConfig( + { + serverFns: { + disableCsrfMiddlewareWarning: true, + }, + }, + corePluginOpts, + root, + ) + + expect(config.serverFns.disableCsrfMiddlewareWarning).toBe(true) + }) + + test('defaults to false', () => { + const config = parseViteStartConfig({}, corePluginOpts, root) + + expect(config.serverFns.disableCsrfMiddlewareWarning).toBe(false) + }) + + test('emits the vite define used by the server runtime', () => { + const define = createViteDefineConfig({ + command: 'serve', + mode: 'development', + serverFnBase: '/_serverFn', + routerBasepath: '/', + spaEnabled: true, + devSsrStylesEnabled: true, + devSsrStylesBasepath: '/', + inlineCssEnabled: false, + staticNodeEnv: true, + disableCsrfMiddlewareWarning: true, + }) + + expect(define['process.env.TSS_DISABLE_CSRF_MIDDLEWARE_WARNING']).toBe( + JSON.stringify('true'), + ) + expect(define['import.meta.env.TSS_DISABLE_CSRF_MIDDLEWARE_WARNING']).toBe( + JSON.stringify('true'), + ) + }) +}) diff --git a/packages/start-plugin-core/tests/envOnly/envOnly.test.ts b/packages/start-plugin-core/tests/envOnly/envOnly.test.ts index 67650b83e8..128e4f4162 100644 --- a/packages/start-plugin-core/tests/envOnly/envOnly.test.ts +++ b/packages/start-plugin-core/tests/envOnly/envOnly.test.ts @@ -2,7 +2,7 @@ import { readFile, readdir } from 'node:fs/promises' import path from 'node:path' import { describe, expect, test } from 'vitest' -import { StartCompiler } from '../../src/start-compiler-plugin/compiler' +import { StartCompiler } from '../../src/start-compiler/compiler' // Default test options for StartCompiler function getDefaultTestOptions(env: 'client' | 'server') { @@ -39,6 +39,7 @@ async function compile(opts: { kind: 'ClientOnlyFn', }, ], + getKnownServerFns: () => ({}), resolveId: async (id) => { return id }, diff --git a/packages/start-plugin-core/tests/hydrate-when-transform.test.ts b/packages/start-plugin-core/tests/hydrate-when-transform.test.ts new file mode 100644 index 0000000000..13e1d909bd --- /dev/null +++ b/packages/start-plugin-core/tests/hydrate-when-transform.test.ts @@ -0,0 +1,618 @@ +import { mkdtempSync } from 'node:fs' +import { tmpdir } from 'node:os' +import { join } from 'node:path' +import * as t from '@babel/types' +import { generateFromAst, parseAst } from '@tanstack/router-utils' +import { describe, expect, test } from 'vitest' +import { createHydrateCompilerPlugin } from '../src/hydrate-when-transform' +import type { CompileStartFrameworkOptions } from '../src/types' + +const root = '/repo' +const id = '/repo/src/routes/about.tsx' + +type HydrateBoundary = { + id: string + exportName: string + index: number +} + +function getHydrateBoundariesFromCode(code: string): Array { + const boundaries: Array = [] + const hydrateImportPattern = + /import\("([^"]*[?&]tss-hydrate=[^"]*)"\),\s*"([^"]+)"/g + let match: RegExpExecArray | null + + while ((match = hydrateImportPattern.exec(code))) { + const importId = match[1]! + const queryIndex = importId.indexOf('?') + const params = new URLSearchParams(importId.slice(queryIndex + 1)) + const boundaryId = params.get('tss-hydrate') + const separatorIndex = boundaryId?.indexOf('_') ?? -1 + const index = + boundaryId && separatorIndex > 0 + ? Number.parseInt(boundaryId.slice(0, separatorIndex), 36) + : Number.NaN + + if (boundaryId && Number.isInteger(index)) { + boundaries.push({ + id: boundaryId, + exportName: match[2]!, + index, + }) + } + } + + return boundaries.sort((a, b) => a.index - b.index) +} + +function virtualHydrateId( + file: string, + boundary: Pick, +) { + const params = new URLSearchParams() + params.set('tss-hydrate', boundary.id) + return `${file}?${params.toString()}` +} + +function withSourceHash(id: string, sourceHash: string) { + const separatorIndex = id.indexOf('_') + return `${id.slice(0, separatorIndex + 1)}${sourceHash}` +} + +function compileHydrate(options: { + code: string + id: string + root: string + env: 'client' | 'server' + envName?: string + framework?: CompileStartFrameworkOptions + plugin?: ReturnType +}) { + const plugin = options.plugin ?? createHydrateCompilerPlugin() + const envName = options.envName ?? options.env + const ast = parseAst({ code: options.code, sourceFilename: options.id }) + const result = plugin.transformAst?.({ + ast, + code: options.code, + id: options.id, + root: options.root, + env: options.env, + envName, + mode: 'dev', + framework: options.framework ?? 'react', + providerEnvName: 'ssr', + types: t, + parseExpression: (expressionCode) => t.identifier(expressionCode), + }) + if (!result) return null + + const generated = generateFromAst(ast, { + sourceMaps: true, + sourceFileName: options.id, + filename: options.id, + }) + + return { + code: generated.code, + map: generated.map, + boundaries: getHydrateBoundariesFromCode(generated.code), + plugin, + } +} + +function loadVirtualHydrateModule(options: { + code: string + id: string + root: string + envName?: string +}) { + const plugin = createHydrateCompilerPlugin() + return plugin.loadVirtualModule?.({ + code: options.code, + id: options.id, + root: options.root, + env: 'client', + envName: options.envName ?? 'client', + }) +} + +describe('Hydrate compiler transform', () => { + test('splits Hydrate children behind a lazy import', () => { + const result = compileHydrate({ + code: ` + import { Hydrate } from '@tanstack/react-start' + import { visible } from '@tanstack/react-start/hydration' + + export function Page() { + return ( + + + + ) + } + + function Widget(props: { title: string }) { + return

    {props.title}

    + } + `, + id, + root, + env: 'client', + }) + + expect(result?.code).toContain('lazyRouteComponent') + expect(result?.code).toContain('tss-hydrate=') + expect(result?.code).not.toContain('tss-hydrate-index') + expect(result?.code).not.toContain('createElement') + expect(result?.code).toContain('h=') + expect(result?.code).not.toContain('p=') + }) + + test('uses the Solid Router import source for Solid Hydrate boundaries', () => { + const result = compileHydrate({ + code: ` + import { Hydrate } from '@tanstack/solid-start' + import { visible } from '@tanstack/solid-start/hydration' + + export function Page() { + return ( + + + + ) + } + + function Widget(props: { title: string }) { + return

    {props.title}

    + } + `, + id, + root, + env: 'client', + framework: 'solid', + }) + + expect(result?.code).toContain( + 'lazyRouteComponent } from "@tanstack/solid-router"', + ) + expect(result?.code).toContain('tss-hydrate=') + expect(result?.code).toContain('h=') + expect(result?.code).not.toContain('p=') + }) + + test('rejects function-as-children unless the boundary opts out of splitting', () => { + expect(() => + compileHydrate({ + code: ` + import { Hydrate } from '@tanstack/react-start' + import { idle } from '@tanstack/react-start/hydration' + + export function Page() { + return ( + + {() =>

    child

    } +
    + ) + } + `, + id, + root, + env: 'client', + }), + ).toThrow(/function-as-children/) + }) + + test('rejects hook calls that would be moved into an extracted component', () => { + expect(() => + compileHydrate({ + code: ` + import { Hydrate } from '@tanstack/react-start' + import { idle } from '@tanstack/react-start/hydration' + + function useThing() { + return 'thing' + } + + export function Page() { + return ( + +

    {useThing()}

    +
    + ) + } + `, + id, + root, + env: 'client', + }), + ).toThrow(/hooks/) + }) + + test('strips Hydrate fallback from the server transform', () => { + const result = compileHydrate({ + code: ` + import { Hydrate } from '@tanstack/react-start' + import { idle, visible } from '@tanstack/react-start/hydration' + + const spreadProps = { + when: visible(), + fallback:
    bound
    , + } + + export function Page() { + return ( + <> + fallback
    } + > + + + inline
    } + > + + + spread
    , + }} + > + + + + + + + ) + } + + function Widget(props: { title: string }) { + return

    {props.title}

    + } + `, + id, + root, + env: 'server', + }) + + expect(result?.code).not.toContain('fallback=') + expect(result?.code).not.toContain('fallback:') + expect(result?.code).not.toContain('server-fallback') + expect(result?.code).not.toContain('server-inline') + expect(result?.code).not.toContain('server-spread') + expect(result?.code).not.toContain('server-bound-spread') + expect(result?.code).toContain('h=') + expect(result?.code).toContain('') + expect(result?.code).toContain('') + expect(result?.code).toContain('') + expect(result?.code).toContain('') + }) + + test('supports nested Hydrate boundaries in extracted virtual modules', () => { + const dir = mkdtempSync(join(tmpdir(), 'hydrate-when-')) + const file = join(dir, 'route.tsx') + const code = ` + import { Hydrate } from '@tanstack/react-start' + import { interaction, visible } from '@tanstack/react-start/hydration' + + const unused = 'remove me' + + export function Page() { + return ( + +
    + + + +
    +
    + ) + } + ` + const firstPass = compileHydrate({ + code, + id: file, + root: dir, + env: 'client', + }) + expect(firstPass?.boundaries).toHaveLength(1) + + const virtualId = virtualHydrateId(file, firstPass!.boundaries[0]!) + const virtualModule = loadVirtualHydrateModule({ + code, + id: virtualId, + root: dir, + }) + expect(virtualModule?.code).not.toContain('remove me') + + const boundaryIndex = firstPass!.boundaries[0]!.index + const nestedPass = compileHydrate({ + code: virtualModule!.code, + id: virtualId, + root: dir, + env: 'client', + }) + + expect(boundaryIndex).toBe(0) + expect(nestedPass?.code).toContain('H1') + expect(nestedPass?.code).toContain('tss-hydrate=') + }) + + test('keeps sibling boundary ids stable after nested boundaries', () => { + const dir = mkdtempSync(join(tmpdir(), 'hydrate-when-')) + const file = join(dir, 'route.tsx') + const code = ` + import { Hydrate } from '@tanstack/react-start' + import { idle, interaction, visible } from '@tanstack/react-start/hydration' + + export function Page() { + return ( + <> + +
    + + + +
    +
    + +

    Sibling

    +
    + + ) + } + ` + const firstPass = compileHydrate({ + code, + id: file, + root: dir, + env: 'client', + }) + expect( + firstPass?.boundaries.map((boundary) => boundary.exportName), + ).toEqual(['H0', 'H2']) + + const siblingBoundary = firstPass!.boundaries[1]! + const virtualId = virtualHydrateId(file, siblingBoundary) + const boundaryIndex = siblingBoundary.index + const virtualModule = loadVirtualHydrateModule({ + code, + id: virtualId, + root: dir, + }) + const parentVirtualId = virtualHydrateId(file, firstPass!.boundaries[0]!) + const parentVirtualModule = loadVirtualHydrateModule({ + code, + id: parentVirtualId, + root: dir, + }) + const nestedPass = compileHydrate({ + code: parentVirtualModule!.code, + id: parentVirtualId, + root: dir, + env: 'client', + }) + const serverPass = compileHydrate({ + code, + id: file, + root: dir, + env: 'server', + }) + + expect(boundaryIndex).toBe(2) + expect(virtualModule?.code).toContain('Sibling') + expect(virtualModule?.code).not.toContain('Nested') + expect(nestedPass?.boundaries[0]?.exportName).toBe('H1') + expect(serverPass?.code).toContain(firstPass!.boundaries[0]!.id) + expect(serverPass?.code).toContain(nestedPass!.boundaries[0]!.id) + expect(serverPass?.code).toContain(siblingBoundary.id) + }) + + test('loads virtual modules from supplied bundler code instead of the filesystem', () => { + const dir = mkdtempSync(join(tmpdir(), 'hydrate-when-')) + const file = join(dir, 'route.tsx') + const oldCode = ` + import { Hydrate } from '@tanstack/react-start' + import { visible } from '@tanstack/react-start/hydration' + + export function Page() { + return

    Old

    + } + ` + const nextCode = oldCode.replace('Old', 'New') + const firstPass = compileHydrate({ + code: oldCode, + id: file, + root: dir, + env: 'client', + }) + const virtualModule = loadVirtualHydrateModule({ + code: nextCode, + id: virtualHydrateId(file, firstPass!.boundaries[0]!), + root: dir, + }) + + expect(virtualModule?.code).toContain('New') + expect(virtualModule?.code).not.toContain('Old') + }) + + test('captures identifiers used by shorthand objects and computed members', () => { + const dir = mkdtempSync(join(tmpdir(), 'hydrate-when-')) + const file = join(dir, 'route.tsx') + const code = ` + import { Hydrate } from '@tanstack/react-start' + import { visible } from '@tanstack/react-start/hydration' + + export function Page() { + const key = 'name' + const items = { name: 'Ada' } + return ( + + + + ) + } + + function Widget(props: { data: { key: string; value: string } }) { + return

    {props.data.value}

    + } + ` + const firstPass = compileHydrate({ + code, + id: file, + root: dir, + env: 'client', + }) + const virtualModule = loadVirtualHydrateModule({ + code, + id: virtualHydrateId(file, firstPass!.boundaries[0]!), + root: dir, + }) + + expect(virtualModule?.code).toContain('export function H0({') + expect(virtualModule?.code).toContain('items') + expect(virtualModule?.code).toContain('key') + expect(virtualModule?.code).toContain('items[key]') + }) + + test('unwraps exported declarations needed by extracted virtual modules', () => { + const dir = mkdtempSync(join(tmpdir(), 'hydrate-when-')) + const file = join(dir, 'route.tsx') + const code = ` + import { createFileRoute } from '@tanstack/react-router' + import { Hydrate } from '@tanstack/react-start' + import { visible } from '@tanstack/react-start/hydration' + + export const Route = createFileRoute('/test')({ + component: Page, + }) + + export const label = 'Ada' + + export const Widget = () => { + return

    {label}

    + } + + function Page() { + return + } + ` + const firstPass = compileHydrate({ + code, + id: file, + root: dir, + env: 'client', + }) + const virtualModule = loadVirtualHydrateModule({ + code, + id: virtualHydrateId(file, firstPass!.boundaries[0]!), + root: dir, + }) + + expect(virtualModule?.code).toContain('const Widget') + expect(virtualModule?.code).toContain('const label') + expect(virtualModule?.code).toContain('') + expect(virtualModule?.code).not.toContain('export const Widget') + expect(virtualModule?.code).not.toContain('createFileRoute') + expect(virtualModule?.code).not.toContain('const Route') + }) + + test('invalidates cached Hydrate source for virtual module loads', () => { + const dir = mkdtempSync(join(tmpdir(), 'hydrate-when-')) + const file = join(dir, 'route.tsx') + const oldCode = ` + import { Hydrate } from '@tanstack/react-start' + import { visible } from '@tanstack/react-start/hydration' + + export function Page() { + return

    Old

    + } + ` + const nextCode = oldCode.replace('Old', 'New') + const envName = 'client' + const plugin = createHydrateCompilerPlugin() + const transformed = compileHydrate({ + code: oldCode, + id: file, + root: dir, + env: 'client', + envName, + plugin, + }) + const virtualId = virtualHydrateId(file, transformed!.boundaries[0]!) + + expect( + transformed!.plugin.loadVirtualModule?.({ + id: virtualId, + root: dir, + env: 'client', + envName, + })?.code, + ).toContain('Old') + + transformed!.plugin.invalidateModule?.({ id: file, envName }) + expect(() => + transformed!.plugin.loadVirtualModule?.({ + id: virtualId, + root: dir, + env: 'client', + envName, + }), + ).toThrow(/Missing Hydrate source/) + + const updated = compileHydrate({ + code: nextCode, + id: file, + root: dir, + env: 'client', + envName, + plugin, + }) + + expect( + updated!.plugin.loadVirtualModule?.({ + id: virtualId, + root: dir, + env: 'client', + envName, + })?.code, + ).toContain('New') + }) + + test('rejects virtual module ids whose source hash does not match', () => { + const code = ` + import { Hydrate } from '@tanstack/react-start' + import { idle, visible } from '@tanstack/react-start/hydration' + + export function Page() { + return ( + <> +

    First

    +

    Second

    + + ) + } + ` + const firstPass = compileHydrate({ + code, + id, + root, + env: 'client', + }) + const mismatchedId = virtualHydrateId(id, { + id: withSourceHash(firstPass!.boundaries[0]!.id, 'mismatch'), + index: firstPass!.boundaries[0]!.index, + }) + + expect( + new URLSearchParams(mismatchedId.split('?')[1]).get('tss-hydrate'), + ).toMatch(/_mismatch$/) + expect( + loadVirtualHydrateModule({ code, id: mismatchedId, root }), + ).toBeNull() + }) +}) diff --git a/packages/start-plugin-core/tests/hydrateWhen/error-files/hydrateWhenFunctionChild.tsx b/packages/start-plugin-core/tests/hydrateWhen/error-files/hydrateWhenFunctionChild.tsx new file mode 100644 index 0000000000..a2560a6197 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/error-files/hydrateWhenFunctionChild.tsx @@ -0,0 +1,6 @@ +import { Hydrate } from '@tanstack/react-start' +import { idle } from '@tanstack/react-start/hydration' + +export function Page() { + return {() =>

    child

    }
    +} diff --git a/packages/start-plugin-core/tests/hydrateWhen/error-files/hydrateWhenHookCall.tsx b/packages/start-plugin-core/tests/hydrateWhen/error-files/hydrateWhenHookCall.tsx new file mode 100644 index 0000000000..1e89bb7303 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/error-files/hydrateWhenHookCall.tsx @@ -0,0 +1,14 @@ +import { Hydrate } from '@tanstack/react-start' +import { idle } from '@tanstack/react-start/hydration' + +function useThing() { + return 'thing' +} + +export function Page() { + return ( + +

    {useThing()}

    +
    + ) +} diff --git a/packages/start-plugin-core/tests/hydrateWhen/error-files/hydrateWhenSuperCapture.tsx b/packages/start-plugin-core/tests/hydrateWhen/error-files/hydrateWhenSuperCapture.tsx new file mode 100644 index 0000000000..63b91b0239 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/error-files/hydrateWhenSuperCapture.tsx @@ -0,0 +1,16 @@ +import { Hydrate } from '@tanstack/react-start' +import { idle } from '@tanstack/react-start/hydration' + +class Base { + title = 'super' +} + +export class Page extends Base { + render() { + return ( + +

    {super.title}

    +
    + ) + } +} diff --git a/packages/start-plugin-core/tests/hydrateWhen/error-files/hydrateWhenThisCapture.tsx b/packages/start-plugin-core/tests/hydrateWhen/error-files/hydrateWhenThisCapture.tsx new file mode 100644 index 0000000000..5f7b3df606 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/error-files/hydrateWhenThisCapture.tsx @@ -0,0 +1,14 @@ +import { Hydrate } from '@tanstack/react-start' +import { idle } from '@tanstack/react-start/hydration' + +export class Page { + title = 'this' + + render() { + return ( + +

    {this.title}

    +
    + ) + } +} diff --git a/packages/start-plugin-core/tests/hydrateWhen/hydrateWhen.test.ts b/packages/start-plugin-core/tests/hydrateWhen/hydrateWhen.test.ts new file mode 100644 index 0000000000..2d121539fe --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/hydrateWhen.test.ts @@ -0,0 +1,241 @@ +import { readFile, readdir } from 'node:fs/promises' +import path from 'node:path' +import * as t from '@babel/types' +import { generateFromAst, parseAst } from '@tanstack/router-utils' +import { describe, expect, test } from 'vitest' +import { createHydrateCompilerPlugin } from '../../src/hydrate-when-transform' + +const fixtureRoot = path.resolve(import.meta.dirname, './test-files') +const errorRoot = path.resolve(import.meta.dirname, './error-files') + +function fixtureId(filename: string) { + return path.join(fixtureRoot, filename) +} + +function normalizeSnapshotCode(code: string) { + return code.split(fixtureRoot).join('') +} + +async function readFixture(filename: string) { + return await readFile(fixtureId(filename), 'utf8') +} + +async function getFilenames(dirname: string) { + return (await readdir(dirname)) + .filter((filename) => filename.endsWith('.tsx')) + .sort() +} + +type HydrateBoundary = { + id: string + exportName: string + index: number +} + +function getHydrateBoundariesFromCode(code: string): Array { + const boundaries: Array = [] + const hydrateImportPattern = + /import\("([^"]*[?&]tss-hydrate=[^"]*)"\),\s*"([^"]+)"/g + let match: RegExpExecArray | null + + while ((match = hydrateImportPattern.exec(code))) { + const importId = match[1]! + const queryIndex = importId.indexOf('?') + const params = new URLSearchParams(importId.slice(queryIndex + 1)) + const boundaryId = params.get('tss-hydrate') + const separatorIndex = boundaryId?.indexOf('_') ?? -1 + const index = + boundaryId && separatorIndex > 0 + ? Number.parseInt(boundaryId.slice(0, separatorIndex), 36) + : Number.NaN + + if (boundaryId && Number.isInteger(index)) { + boundaries.push({ + id: boundaryId, + exportName: match[2]!, + index, + }) + } + } + + return boundaries.sort((a, b) => a.index - b.index) +} + +function compile(opts: { + env: 'client' | 'server' + code: string + id: string + root?: string +}) { + const options = { + ...opts, + root: opts.root ?? fixtureRoot, + } + const plugin = createHydrateCompilerPlugin() + const ast = parseAst({ code: options.code, sourceFilename: options.id }) + const result = plugin.transformAst?.({ + ast, + code: options.code, + id: options.id, + root: options.root, + env: options.env, + envName: options.env, + mode: 'dev', + framework: 'react', + providerEnvName: 'ssr', + types: t, + parseExpression: (expressionCode) => t.identifier(expressionCode), + }) + if (!result) return null + + const generated = generateFromAst(ast, { + sourceMaps: true, + sourceFileName: options.id, + filename: options.id, + }) + + return { + code: generated.code, + map: generated.map, + boundaries: getHydrateBoundariesFromCode(generated.code), + } +} + +function loadVirtualHydrateModule(options: { + code: string + id: string + root: string +}) { + return createHydrateCompilerPlugin().loadVirtualModule?.({ + code: options.code, + id: options.id, + root: options.root, + env: 'client', + envName: 'client', + }) +} + +function virtualHydrateId( + file: string, + boundary: Pick, +) { + const params = new URLSearchParams() + params.set('tss-hydrate', boundary.id) + return `${file}?${params.toString()}` +} + +describe('Hydrate compiler transform fixtures', async () => { + const filenames = await getFilenames(fixtureRoot) + + describe.each(filenames)('should handle "%s"', async (filename) => { + const code = await readFixture(filename) + const id = fixtureId(filename) + + test(`should compile ${filename} for client`, async () => { + const result = compile({ env: 'client', code, id }) + + await expect( + normalizeSnapshotCode(result?.code ?? 'no-transform'), + ).toMatchFileSnapshot(`./snapshots/client/${filename}`) + }) + + test(`should compile ${filename} for server`, async () => { + const result = compile({ env: 'server', code, id }) + + await expect( + normalizeSnapshotCode(result?.code ?? 'no-transform'), + ).toMatchFileSnapshot(`./snapshots/server/${filename}`) + }) + }) + + test('should extract virtual modules and keep nested ids stable', async () => { + const filename = 'hydrateWhenNested.tsx' + const code = await readFixture(filename) + const id = fixtureId(filename) + const firstPass = compile({ env: 'client', code, id }) + + expect( + firstPass?.boundaries.map((boundary) => boundary.exportName), + ).toEqual(['H0', 'H2']) + + for (const boundary of firstPass!.boundaries) { + const virtualId = virtualHydrateId(id, boundary) + const loaded = loadVirtualHydrateModule({ + code, + id: virtualId, + root: fixtureRoot, + }) + + await expect( + normalizeSnapshotCode(loaded?.code ?? 'no-virtual-module'), + ).toMatchFileSnapshot( + `./snapshots/virtual/${filename}.${boundary.exportName}.tsx`, + ) + } + + const parentBoundary = firstPass!.boundaries[0]! + const parentVirtualId = virtualHydrateId(id, parentBoundary) + const parentVirtualModule = loadVirtualHydrateModule({ + code, + id: parentVirtualId, + root: fixtureRoot, + }) + const nestedPass = compile({ + code: parentVirtualModule!.code, + id: parentVirtualId, + env: 'client', + }) + + await expect( + normalizeSnapshotCode(nestedPass?.code ?? 'no-transform'), + ).toMatchFileSnapshot(`./snapshots/virtual/${filename}.H0.client.tsx`) + }) +}) + +describe('Hydrate compiler extraction errors', async () => { + const errorCases = [ + { + filename: 'hydrateWhenFunctionChild.tsx', + message: /function-as-children/, + }, + { + filename: 'hydrateWhenHookCall.tsx', + message: /hooks/, + }, + { + filename: 'hydrateWhenThisCapture.tsx', + message: /captures this/, + }, + { + filename: 'hydrateWhenSuperCapture.tsx', + message: /captures super/, + }, + ] as const + + describe.each(errorCases)('$filename', async ({ filename, message }) => { + const code = await readFile(path.join(errorRoot, filename), 'utf8') + const id = path.join(errorRoot, filename) + + test('should reject unsafe client extraction', () => { + expect(() => + compile({ + code, + id, + root: errorRoot, + env: 'client', + }), + ).toThrow(message) + }) + + test('should reject unsafe server extraction', () => { + expect(() => + compile({ + code, + id, + root: errorRoot, + env: 'server', + }), + ).toThrow(message) + }) + }) +}) diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenBasic.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenBasic.tsx new file mode 100644 index 0000000000..c977cd70a2 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenBasic.tsx @@ -0,0 +1,18 @@ +const _H = _lazyRouteComponent(() => import("/hydrateWhenBasic.tsx?tss-hydrate=0_3cf0187f82"), "H0"), + _H0_preload = _H.preload; +import { lazyRouteComponent as _lazyRouteComponent } from "@tanstack/react-router"; +import { Hydrate } from '@tanstack/react-start'; +import { idle, visible } from '@tanstack/react-start/hydration'; +import { FallbackPane } from './widgets'; +export function Page() { + return
    + } h="0_3cf0187f82" p={_H0_preload}> + {<_H />} + +
    ; +} \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenMultiple.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenMultiple.tsx new file mode 100644 index 0000000000..8a68575d69 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenMultiple.tsx @@ -0,0 +1,19 @@ +const _H3 = _lazyRouteComponent(() => import("/hydrateWhenMultiple.tsx?tss-hydrate=2_21aa371e0f"), "H2"); +const _H2 = _lazyRouteComponent(() => import("/hydrateWhenMultiple.tsx?tss-hydrate=1_21aa371e0f"), "H1"); +const _H = _lazyRouteComponent(() => import("/hydrateWhenMultiple.tsx?tss-hydrate=0_21aa371e0f"), "H0"); +import { lazyRouteComponent as _lazyRouteComponent } from "@tanstack/react-router"; +import { Hydrate } from '@tanstack/react-start'; +import { load, media, visible } from '@tanstack/react-start/hydration'; +export function Page() { + return <> + + {<_H />} + + + {<_H2 />} + + + {<_H3 />} + + ; +} \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenNested.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenNested.tsx new file mode 100644 index 0000000000..97c3dba1a4 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenNested.tsx @@ -0,0 +1,16 @@ +const _H2 = _lazyRouteComponent(() => import("/hydrateWhenNested.tsx?tss-hydrate=2_466696e41d"), "H2"); +const _H = _lazyRouteComponent(() => import("/hydrateWhenNested.tsx?tss-hydrate=0_466696e41d"), "H0"); +import { lazyRouteComponent as _lazyRouteComponent } from "@tanstack/react-router"; +import { Hydrate } from '@tanstack/react-start'; +import { idle, visible } from '@tanstack/react-start/hydration'; +const unused = 'remove me from virtual modules'; +export function Page() { + return <> + + {<_H />} + + + {<_H2 />} + + ; +} \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenNever.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenNever.tsx new file mode 100644 index 0000000000..426e83fa73 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenNever.tsx @@ -0,0 +1,9 @@ +const _H = _lazyRouteComponent(() => import("/hydrateWhenNever.tsx?tss-hydrate=0_b752509d76"), "H0"); +import { lazyRouteComponent as _lazyRouteComponent } from "@tanstack/react-router"; +import { Hydrate } from '@tanstack/react-start'; +import { never } from '@tanstack/react-start/hydration'; +export function Page() { + return + {<_H />} + ; +} \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenNoImport.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenNoImport.tsx new file mode 100644 index 0000000000..b35c36ab1b --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenNoImport.tsx @@ -0,0 +1 @@ +no-transform \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenNotFromTanstack.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenNotFromTanstack.tsx new file mode 100644 index 0000000000..b35c36ab1b --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenNotFromTanstack.tsx @@ -0,0 +1 @@ +no-transform \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenObjectFallback.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenObjectFallback.tsx new file mode 100644 index 0000000000..1bbe2337d6 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenObjectFallback.tsx @@ -0,0 +1,26 @@ +const _H3 = _lazyRouteComponent(() => import("/hydrateWhenObjectFallback.tsx?tss-hydrate=2_7f4dc3aa80"), "H2"); +const _H2 = _lazyRouteComponent(() => import("/hydrateWhenObjectFallback.tsx?tss-hydrate=1_7f4dc3aa80"), "H1"); +const _H = _lazyRouteComponent(() => import("/hydrateWhenObjectFallback.tsx?tss-hydrate=0_7f4dc3aa80"), "H0"); +import { lazyRouteComponent as _lazyRouteComponent } from "@tanstack/react-router"; +import { Hydrate } from '@tanstack/react-start'; +import { idle, visible } from '@tanstack/react-start/hydration'; +const spreadProps = { + when: visible(), + fallback:
    Bound
    +}; +export function Page() { + return <> + Direct
    } h="0_7f4dc3aa80"> + {<_H />} + + Inline
    + }} h="1_7f4dc3aa80"> + {<_H2 />} + + + {<_H3 />} + + ; +} \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenPrefetchState.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenPrefetchState.tsx new file mode 100644 index 0000000000..9961cdc3c9 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenPrefetchState.tsx @@ -0,0 +1,19 @@ +const _H = _lazyRouteComponent(() => import("/hydrateWhenPrefetchState.tsx?tss-hydrate=0_24b5f958eb"), "H0"), + _H0_preload = _H.preload; +import { lazyRouteComponent as _lazyRouteComponent } from "@tanstack/react-router"; +import { useState } from 'react'; +import { Hydrate } from '@tanstack/react-start'; +import { interaction } from '@tanstack/react-start/hydration'; +export function Page() { + const [status, setStatus] = useState('idle'); + const [, setUnusedStatus] = useState('idle'); + return
    +

    {status}

    + { + setStatus('prefetched'); + setUnusedStatus('prefetched'); + }} h="0_24b5f958eb" p={_H0_preload}> + {<_H />} + +
    ; +} \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenRenamed.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenRenamed.tsx new file mode 100644 index 0000000000..9c24d8cbd3 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenRenamed.tsx @@ -0,0 +1,11 @@ +const _H = _lazyRouteComponent(() => import("/hydrateWhenRenamed.tsx?tss-hydrate=0_f555ef3ac2"), "H0"); +import { lazyRouteComponent as _lazyRouteComponent } from "@tanstack/react-router"; +import { Hydrate as HW } from '@tanstack/react-start'; +import { interaction } from '@tanstack/react-start/hydration'; +export function Page() { + return + {<_H />} + ; +} \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenSplitFalse.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenSplitFalse.tsx new file mode 100644 index 0000000000..b35c36ab1b --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenSplitFalse.tsx @@ -0,0 +1 @@ +no-transform \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenSplitFalseFunctionChild.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenSplitFalseFunctionChild.tsx new file mode 100644 index 0000000000..b35c36ab1b --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenSplitFalseFunctionChild.tsx @@ -0,0 +1 @@ +no-transform \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenWrongImportName.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenWrongImportName.tsx new file mode 100644 index 0000000000..b35c36ab1b --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/client/hydrateWhenWrongImportName.tsx @@ -0,0 +1 @@ +no-transform \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenBasic.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenBasic.tsx new file mode 100644 index 0000000000..8bcf4099ca --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenBasic.tsx @@ -0,0 +1,17 @@ +import { Hydrate } from '@tanstack/react-start'; +import { idle, visible } from '@tanstack/react-start/hydration'; +import { Chart } from './widgets'; +import { formatValue } from './format'; +const chartTitle = formatValue('Revenue'); +export function Page() { + return
    + + + +
    ; +} \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenMultiple.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenMultiple.tsx new file mode 100644 index 0000000000..6959b25b3e --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenMultiple.tsx @@ -0,0 +1,24 @@ +import { Hydrate } from '@tanstack/react-start'; +import { load, media, visible } from '@tanstack/react-start/hydration'; +function Summary() { + return
    Summary
    ; +} +function Comments() { + return
    Comments
    ; +} +function Footer() { + return
    Footer
    ; +} +export function Page() { + return <> + + + + + + + +
    + + ; +} \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenNested.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenNested.tsx new file mode 100644 index 0000000000..691f703477 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenNested.tsx @@ -0,0 +1,25 @@ +import { Hydrate } from '@tanstack/react-start'; +import { idle, interaction, visible } from '@tanstack/react-start/hydration'; +const unused = 'remove me from virtual modules'; +function Outer() { + return
    Outer
    ; +} +function NestedButton() { + return ; +} +function Sibling() { + return ; +} +export function Page() { + return <> + + + + + + + + + + ; +} \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenNever.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenNever.tsx new file mode 100644 index 0000000000..cb819eae6a --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenNever.tsx @@ -0,0 +1,10 @@ +import { Hydrate } from '@tanstack/react-start'; +import { never } from '@tanstack/react-start/hydration'; +function StaticMarketingBlock() { + return
    Static marketing
    ; +} +export function Page() { + return + + ; +} \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenNoImport.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenNoImport.tsx new file mode 100644 index 0000000000..b35c36ab1b --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenNoImport.tsx @@ -0,0 +1 @@ +no-transform \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenNotFromTanstack.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenNotFromTanstack.tsx new file mode 100644 index 0000000000..b35c36ab1b --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenNotFromTanstack.tsx @@ -0,0 +1 @@ +no-transform \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenObjectFallback.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenObjectFallback.tsx new file mode 100644 index 0000000000..b166525662 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenObjectFallback.tsx @@ -0,0 +1,25 @@ +import { Hydrate } from '@tanstack/react-start'; +import { idle, visible } from '@tanstack/react-start/hydration'; +const spreadProps = { + when: visible() +}; +function Widget(props: { + title: string; +}) { + return

    {props.title}

    ; +} +export function Page() { + return <> + + + + + + + + + + ; +} \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenPrefetchState.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenPrefetchState.tsx new file mode 100644 index 0000000000..e5079bd984 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenPrefetchState.tsx @@ -0,0 +1,19 @@ +import { useState } from 'react'; +import { Hydrate } from '@tanstack/react-start'; +import { interaction } from '@tanstack/react-start/hydration'; +function Widget() { + return ; +} +export function Page() { + const [status, setStatus] = useState('idle'); + const [, setUnusedStatus] = useState('idle'); + return
    +

    {status}

    + { + setStatus('prefetched'); + setUnusedStatus('prefetched'); + }} h="0_24b5f958eb"> + + +
    ; +} \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenRenamed.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenRenamed.tsx new file mode 100644 index 0000000000..0ba438e6a8 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenRenamed.tsx @@ -0,0 +1,12 @@ +import { Hydrate as HW } from '@tanstack/react-start'; +import { interaction } from '@tanstack/react-start/hydration'; +function SearchBox() { + return ; +} +export function Page() { + return + + ; +} \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenSplitFalse.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenSplitFalse.tsx new file mode 100644 index 0000000000..747e330128 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenSplitFalse.tsx @@ -0,0 +1,10 @@ +import { Hydrate } from '@tanstack/react-start'; +import { idle } from '@tanstack/react-start/hydration'; +function Counter() { + return ; +} +export function Page() { + return + + ; +} \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenSplitFalseFunctionChild.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenSplitFalseFunctionChild.tsx new file mode 100644 index 0000000000..b35c36ab1b --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenSplitFalseFunctionChild.tsx @@ -0,0 +1 @@ +no-transform \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenWrongImportName.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenWrongImportName.tsx new file mode 100644 index 0000000000..b35c36ab1b --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/server/hydrateWhenWrongImportName.tsx @@ -0,0 +1 @@ +no-transform \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/virtual/hydrateWhenNested.tsx.H0.client.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/virtual/hydrateWhenNested.tsx.H0.client.tsx new file mode 100644 index 0000000000..56e0f92a41 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/virtual/hydrateWhenNested.tsx.H0.client.tsx @@ -0,0 +1,15 @@ +const _H = _lazyRouteComponent(() => import("/hydrateWhenNested.tsx?tss-hydrate=1_466696e41d"), "H1"); +import { lazyRouteComponent as _lazyRouteComponent } from "@tanstack/react-router"; +import { Hydrate } from '@tanstack/react-start'; +import { interaction } from '@tanstack/react-start/hydration'; +function Outer() { + return
    Outer
    ; +} +export function H0() { + return <> + + + {<_H />} + + ; +} \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/virtual/hydrateWhenNested.tsx.H0.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/virtual/hydrateWhenNested.tsx.H0.tsx new file mode 100644 index 0000000000..ac87aca459 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/virtual/hydrateWhenNested.tsx.H0.tsx @@ -0,0 +1,16 @@ +import { Hydrate } from '@tanstack/react-start'; +import { interaction } from '@tanstack/react-start/hydration'; +function Outer() { + return
    Outer
    ; +} +function NestedButton() { + return ; +} +export function H0() { + return <> + + + + + ; +} \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/snapshots/virtual/hydrateWhenNested.tsx.H2.tsx b/packages/start-plugin-core/tests/hydrateWhen/snapshots/virtual/hydrateWhenNested.tsx.H2.tsx new file mode 100644 index 0000000000..7a576e5eae --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/snapshots/virtual/hydrateWhenNested.tsx.H2.tsx @@ -0,0 +1,6 @@ +function Sibling() { + return ; +} +export function H2() { + return ; +} \ No newline at end of file diff --git a/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenBasic.tsx b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenBasic.tsx new file mode 100644 index 0000000000..29795147b6 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenBasic.tsx @@ -0,0 +1,20 @@ +import { Hydrate } from '@tanstack/react-start' +import { idle, visible } from '@tanstack/react-start/hydration' +import { Chart, FallbackPane } from './widgets' +import { formatValue } from './format' + +const chartTitle = formatValue('Revenue') + +export function Page() { + return ( +
    + } + > + + +
    + ) +} diff --git a/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenMultiple.tsx b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenMultiple.tsx new file mode 100644 index 0000000000..451ea3058b --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenMultiple.tsx @@ -0,0 +1,30 @@ +import { Hydrate } from '@tanstack/react-start' +import { load, media, visible } from '@tanstack/react-start/hydration' + +function Summary() { + return
    Summary
    +} + +function Comments() { + return
    Comments
    +} + +function Footer() { + return
    Footer
    +} + +export function Page() { + return ( + <> + + + + + + + +
    + + + ) +} diff --git a/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenNested.tsx b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenNested.tsx new file mode 100644 index 0000000000..b7363aa0f9 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenNested.tsx @@ -0,0 +1,32 @@ +import { Hydrate } from '@tanstack/react-start' +import { idle, interaction, visible } from '@tanstack/react-start/hydration' + +const unused = 'remove me from virtual modules' + +function Outer() { + return
    Outer
    +} + +function NestedButton() { + return +} + +function Sibling() { + return +} + +export function Page() { + return ( + <> + + + + + + + + + + + ) +} diff --git a/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenNever.tsx b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenNever.tsx new file mode 100644 index 0000000000..97805825cf --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenNever.tsx @@ -0,0 +1,14 @@ +import { Hydrate } from '@tanstack/react-start' +import { never } from '@tanstack/react-start/hydration' + +function StaticMarketingBlock() { + return
    Static marketing
    +} + +export function Page() { + return ( + + + + ) +} diff --git a/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenNoImport.tsx b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenNoImport.tsx new file mode 100644 index 0000000000..a05ae67fef --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenNoImport.tsx @@ -0,0 +1,7 @@ +export function Page() { + return ( + +

    No transform

    +
    + ) +} diff --git a/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenNotFromTanstack.tsx b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenNotFromTanstack.tsx new file mode 100644 index 0000000000..d69d102475 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenNotFromTanstack.tsx @@ -0,0 +1,10 @@ +import { Hydrate } from 'not-tanstack-start' +import { visible } from '@tanstack/react-start/hydration' + +export function Page() { + return ( + +

    No transform

    +
    + ) +} diff --git a/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenObjectFallback.tsx b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenObjectFallback.tsx new file mode 100644 index 0000000000..b0c2bfd498 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenObjectFallback.tsx @@ -0,0 +1,35 @@ +import { Hydrate } from '@tanstack/react-start' +import { idle, visible } from '@tanstack/react-start/hydration' + +const spreadProps = { + when: visible(), + fallback:
    Bound
    , +} + +function Widget(props: { title: string }) { + return

    {props.title}

    +} + +export function Page() { + return ( + <> + Direct
    } + > + + + Inline
    , + }} + > + + + + + + + ) +} diff --git a/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenPrefetchState.tsx b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenPrefetchState.tsx new file mode 100644 index 0000000000..d5d41ae3b9 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenPrefetchState.tsx @@ -0,0 +1,27 @@ +import { useState } from 'react' +import { Hydrate } from '@tanstack/react-start' +import { interaction } from '@tanstack/react-start/hydration' + +function Widget() { + return +} + +export function Page() { + const [status, setStatus] = useState('idle') + const [, setUnusedStatus] = useState('idle') + + return ( +
    +

    {status}

    + { + setStatus('prefetched') + setUnusedStatus('prefetched') + }} + > + + +
    + ) +} diff --git a/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenRenamed.tsx b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenRenamed.tsx new file mode 100644 index 0000000000..b10aafe742 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenRenamed.tsx @@ -0,0 +1,14 @@ +import { Hydrate as HW } from '@tanstack/react-start' +import { interaction } from '@tanstack/react-start/hydration' + +function SearchBox() { + return +} + +export function Page() { + return ( + + + + ) +} diff --git a/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenSplitFalse.tsx b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenSplitFalse.tsx new file mode 100644 index 0000000000..93ea432c20 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenSplitFalse.tsx @@ -0,0 +1,16 @@ +import { Hydrate } from '@tanstack/react-start' +import { idle } from '@tanstack/react-start/hydration' + +const fallback =
    Loading
    + +function Counter() { + return +} + +export function Page() { + return ( + + + + ) +} diff --git a/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenSplitFalseFunctionChild.tsx b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenSplitFalseFunctionChild.tsx new file mode 100644 index 0000000000..461a3b5758 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenSplitFalseFunctionChild.tsx @@ -0,0 +1,10 @@ +import { Hydrate } from '@tanstack/react-start' +import { idle } from '@tanstack/react-start/hydration' + +export function Page() { + return ( + + {() =>

    render prop stays inline

    } +
    + ) +} diff --git a/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenWrongImportName.tsx b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenWrongImportName.tsx new file mode 100644 index 0000000000..4e0693db83 --- /dev/null +++ b/packages/start-plugin-core/tests/hydrateWhen/test-files/hydrateWhenWrongImportName.tsx @@ -0,0 +1,9 @@ +import { Link as Hydrate } from '@tanstack/react-start' + +export function Page() { + return ( + +

    No transform

    +
    + ) +} diff --git a/packages/start-plugin-core/tests/importProtection/rewriteDeniedImports.test.ts b/packages/start-plugin-core/tests/importProtection/analysis.exports.test.ts similarity index 74% rename from packages/start-plugin-core/tests/importProtection/rewriteDeniedImports.test.ts rename to packages/start-plugin-core/tests/importProtection/analysis.exports.test.ts index 49b9e61f7e..dbb0830af7 100644 --- a/packages/start-plugin-core/tests/importProtection/rewriteDeniedImports.test.ts +++ b/packages/start-plugin-core/tests/importProtection/analysis.exports.test.ts @@ -1,10 +1,10 @@ import { describe, expect, test } from 'vitest' import { - collectNamedExports, - collectMockExportNamesBySource, isValidExportName, -} from '../../src/import-protection-plugin/rewriteDeniedImports' + getMockExportNamesBySource, + getNamedExports, +} from '../../src/import-protection/analysis' describe('isValidExportName', () => { test('rejects "default"', () => { @@ -37,13 +37,13 @@ describe('isValidExportName', () => { describe('collectMockExportNamesBySource', () => { test('collects named imports', () => { const code = `import { alpha, beta } from 'mod-a'` - const result = collectMockExportNamesBySource(code) + const result = getMockExportNamesBySource(code) expect(result.get('mod-a')).toEqual(['alpha', 'beta']) }) test('ignores default imports', () => { const code = `import def from 'mod-a'` - const result = collectMockExportNamesBySource(code) + const result = getMockExportNamesBySource(code) expect(result.has('mod-a')).toBe(false) }) @@ -53,7 +53,7 @@ describe('collectMockExportNamesBySource', () => { `const a = ns.alpha`, `const b = ns.beta`, ].join('\n') - const result = collectMockExportNamesBySource(code) + const result = getMockExportNamesBySource(code) expect(result.get('mod-a')).toEqual(['alpha', 'beta']) }) @@ -62,7 +62,7 @@ describe('collectMockExportNamesBySource', () => { `import * as ns from 'mod-a'`, `const maybe = ns.gamma?.()`, ].join('\n') - const result = collectMockExportNamesBySource(code) + const result = getMockExportNamesBySource(code) expect(result.get('mod-a')).toEqual(['gamma']) }) @@ -71,7 +71,7 @@ describe('collectMockExportNamesBySource', () => { `import * as ns from 'mod-a'`, `const val = ns['delta']`, ].join('\n') - const result = collectMockExportNamesBySource(code) + const result = getMockExportNamesBySource(code) expect(result.get('mod-a')).toEqual(['delta']) }) @@ -81,7 +81,7 @@ describe('collectMockExportNamesBySource', () => { `const a = mock.getSecret`, `const b = mock['foo-bar']`, ].join('\n') - const result = collectMockExportNamesBySource(code) + const result = getMockExportNamesBySource(code) expect(result.get('mod-a')).toEqual(['foo-bar', 'getSecret']) }) @@ -91,37 +91,37 @@ describe('collectMockExportNamesBySource', () => { `const key = 'epsilon'`, `const val = ns[key]`, ].join('\n') - const result = collectMockExportNamesBySource(code) + const result = getMockExportNamesBySource(code) expect(result.has('mod-a')).toBe(false) }) test('ignores type-only imports', () => { const code = `import type { Foo } from 'mod-a'` - const result = collectMockExportNamesBySource(code) + const result = getMockExportNamesBySource(code) expect(result.has('mod-a')).toBe(false) }) test('ignores type-only specifiers in value imports', () => { const code = `import { type Foo, bar } from 'mod-a'` - const result = collectMockExportNamesBySource(code) + const result = getMockExportNamesBySource(code) expect(result.get('mod-a')).toEqual(['bar']) }) test('ignores "import { default as x }" specifiers', () => { const code = `import { default as myDefault } from 'mod-a'` - const result = collectMockExportNamesBySource(code) + const result = getMockExportNamesBySource(code) expect(result.has('mod-a')).toBe(false) }) test('collects from re-exports', () => { const code = `export { alpha, beta } from 'mod-a'` - const result = collectMockExportNamesBySource(code) + const result = getMockExportNamesBySource(code) expect(result.get('mod-a')).toEqual(['alpha', 'beta']) }) test('ignores type-only re-exports', () => { const code = `export type { Foo } from 'mod-a'` - const result = collectMockExportNamesBySource(code) + const result = getMockExportNamesBySource(code) expect(result.has('mod-a')).toBe(false) }) @@ -130,7 +130,7 @@ describe('collectMockExportNamesBySource', () => { `import { alpha } from 'mod-a'`, `import { beta } from 'mod-a'`, ].join('\n') - const result = collectMockExportNamesBySource(code) + const result = getMockExportNamesBySource(code) expect(result.get('mod-a')).toEqual(['alpha', 'beta']) }) @@ -139,13 +139,13 @@ describe('collectMockExportNamesBySource', () => { `import { alpha } from 'mod-a'`, `export { alpha } from 'mod-a'`, ].join('\n') - const result = collectMockExportNamesBySource(code) + const result = getMockExportNamesBySource(code) expect(result.get('mod-a')).toEqual(['alpha']) }) test('sorts output alphabetically', () => { const code = `import { zeta, alpha, mu } from 'mod-a'` - const result = collectMockExportNamesBySource(code) + const result = getMockExportNamesBySource(code) expect(result.get('mod-a')).toEqual(['alpha', 'mu', 'zeta']) }) @@ -154,20 +154,26 @@ describe('collectMockExportNamesBySource', () => { `import { a } from 'mod-a'`, `import { b } from 'mod-b'`, ].join('\n') - const result = collectMockExportNamesBySource(code) + const result = getMockExportNamesBySource(code) expect(result.get('mod-a')).toEqual(['a']) expect(result.get('mod-b')).toEqual(['b']) }) test('returns empty map for code with no relevant imports', () => { const code = `const x = 1` - const result = collectMockExportNamesBySource(code) + const result = getMockExportNamesBySource(code) expect(result.size).toBe(0) }) test('collects ES2022 string-keyed import specifiers', () => { const code = `import { "foo-bar" as x } from 'mod-a'` - const result = collectMockExportNamesBySource(code) + const result = getMockExportNamesBySource(code) + expect(result.get('mod-a')).toEqual(['foo-bar']) + }) + + test('collects string-literal re-export specifiers', () => { + const code = `export { "foo-bar" as baz } from 'mod-a'` + const result = getMockExportNamesBySource(code) expect(result.get('mod-a')).toEqual(['foo-bar']) }) }) @@ -179,7 +185,7 @@ describe('collectNamedExports', () => { `export const beta = 1`, `export class Gamma {}`, ].join('\n') - expect(collectNamedExports(code)).toEqual(['Gamma', 'alpha', 'beta']) + expect(getNamedExports(code)).toEqual(['Gamma', 'alpha', 'beta']) }) test('collects named export specifiers and aliases', () => { @@ -188,7 +194,7 @@ describe('collectNamedExports', () => { `const x = 2`, `export { local as renamed, x }`, ].join('\n') - expect(collectNamedExports(code)).toEqual(['renamed', 'x']) + expect(getNamedExports(code)).toEqual(['renamed', 'x']) }) test('ignores default and type-only exports', () => { @@ -196,41 +202,46 @@ describe('collectNamedExports', () => { `export default function main() {}`, `export type { Foo } from 'mod-a'`, ].join('\n') - expect(collectNamedExports(code)).toEqual([]) + expect(getNamedExports(code)).toEqual([]) }) test('collects destructured object pattern exports', () => { const code = `export const { a, b } = obj` - expect(collectNamedExports(code)).toEqual(['a', 'b']) + expect(getNamedExports(code)).toEqual(['a', 'b']) }) test('collects destructured array pattern exports', () => { const code = `export const [x, y] = arr` - expect(collectNamedExports(code)).toEqual(['x', 'y']) + expect(getNamedExports(code)).toEqual(['x', 'y']) }) test('collects renamed destructured exports', () => { const code = `export const { a: renamed } = obj` - expect(collectNamedExports(code)).toEqual(['renamed']) + expect(getNamedExports(code)).toEqual(['renamed']) }) test('collects nested destructured exports', () => { const code = `export const { a: { b, c } } = obj` - expect(collectNamedExports(code)).toEqual(['b', 'c']) + expect(getNamedExports(code)).toEqual(['b', 'c']) }) test('collects destructured exports with defaults', () => { const code = `export const { a = 1, b = 2 } = obj` - expect(collectNamedExports(code)).toEqual(['a', 'b']) + expect(getNamedExports(code)).toEqual(['a', 'b']) }) test('collects rest element in destructured exports', () => { const code = `export const { a, ...rest } = obj` - expect(collectNamedExports(code)).toEqual(['a', 'rest']) + expect(getNamedExports(code)).toEqual(['a', 'rest']) }) test('collects re-exports with aliases', () => { const code = `export { default as hello } from './foo'` - expect(collectNamedExports(code)).toEqual(['hello']) + expect(getNamedExports(code)).toEqual(['hello']) + }) + + test('collects string-literal exported names', () => { + const code = [`const local = 1`, `export { local as "foo-bar" }`].join('\n') + expect(getNamedExports(code)).toEqual(['foo-bar']) }) }) diff --git a/packages/start-plugin-core/tests/importProtection/postCompileUsage.test.ts b/packages/start-plugin-core/tests/importProtection/analysis.usage.test.ts similarity index 61% rename from packages/start-plugin-core/tests/importProtection/postCompileUsage.test.ts rename to packages/start-plugin-core/tests/importProtection/analysis.usage.test.ts index 3de3273bbf..69642e890a 100644 --- a/packages/start-plugin-core/tests/importProtection/postCompileUsage.test.ts +++ b/packages/start-plugin-core/tests/importProtection/analysis.usage.test.ts @@ -1,10 +1,21 @@ import { describe, expect, test } from 'vitest' -import { findPostCompileUsagePos } from '../../src/import-protection-plugin/postCompileUsage' +import { + findOriginalUnsafeUsagePos, + findPostCompileUsagePos, +} from '../../src/import-protection/analysis' function pos(code: string, source: string) { return findPostCompileUsagePos(code, source) } +function originalPos( + code: string, + source: string, + envType: 'client' | 'server', +) { + return findOriginalUnsafeUsagePos(code, source, envType) +} + describe('findPostCompileUsagePos', () => { test('returns undefined when there is no import from the source', () => { expect(pos(`const x = 1`, 'denied')).toBeUndefined() @@ -181,3 +192,90 @@ describe('findPostCompileUsagePos', () => { expect(p!.line).toBe(6) }) }) + +describe('findOriginalUnsafeUsagePos', () => { + test('skips createServerFn handler usage in client env and finds later unsafe usage', () => { + const p = originalPos( + [ + `import { createServerFn } from '@tanstack/react-start';`, + `import { getSecret } from './secret.server';`, + `export const safeServerFn = createServerFn().handler(async () => {`, + ` return getSecret();`, + `});`, + `export function leakyReference() {`, + ` return getSecret();`, + `}`, + ].join('\n'), + './secret.server', + 'client', + ) + + expect(p).toBeDefined() + expect(p!.line).toBe(7) + }) + + test('returns undefined when usage is only inside createServerOnlyFn in client env', () => { + const p = originalPos( + [ + `import { createServerOnlyFn } from '@tanstack/react-start';`, + `import { getSecret } from './secret.server';`, + `export const safeServerOnly = createServerOnlyFn(() => {`, + ` return getSecret();`, + `});`, + ].join('\n'), + './secret.server', + 'client', + ) + + expect(p).toBeUndefined() + }) + + test('returns undefined when usage is only inside createMiddleware.server in client env', () => { + const p = originalPos( + [ + `import { createMiddleware } from '@tanstack/react-start';`, + `import { getSecret } from './secret.server';`, + `const middleware = createMiddleware({ type: 'function' }).server(({ next }) => {`, + ` const secret = getSecret();`, + ` return next({ context: { secret } });`, + `});`, + ].join('\n'), + './secret.server', + 'client', + ) + + expect(p).toBeUndefined() + }) + + test('returns undefined when usage is only inside createIsomorphicFn.server in client env', () => { + const p = originalPos( + [ + `import { createIsomorphicFn } from '@tanstack/react-start';`, + `import { getSecret } from './secret.server';`, + `export const safeIsomorphic = createIsomorphicFn().server(() => {`, + ` return getSecret();`, + `});`, + ].join('\n'), + './secret.server', + 'client', + ) + + expect(p).toBeUndefined() + }) + + test('returns undefined when usage is only inside createClientOnlyFn in server env', () => { + const p = originalPos( + [ + `import { createClientOnlyFn } from '@tanstack/react-start';`, + `import { readWindow } from './browser.client';`, + `export const safeClientOnly = createClientOnlyFn(() => {`, + ` return readWindow();`, + `});`, + ].join('\n'), + './browser.client', + 'server', + ) + + expect(p).toBeUndefined() + }) +}) diff --git a/packages/start-plugin-core/tests/importProtection/defaults.test.ts b/packages/start-plugin-core/tests/importProtection/defaults.test.ts index 9632402ff3..53e33ea902 100644 --- a/packages/start-plugin-core/tests/importProtection/defaults.test.ts +++ b/packages/start-plugin-core/tests/importProtection/defaults.test.ts @@ -2,7 +2,7 @@ import { describe, expect, test } from 'vitest' import { getDefaultImportProtectionRules, getMarkerSpecifiers, -} from '../../src/import-protection-plugin/defaults' +} from '../../src/import-protection/defaults' describe('getDefaultImportProtectionRules', () => { test('returns client rules with all framework specifiers', () => { diff --git a/packages/start-plugin-core/tests/importProtection/matchers.test.ts b/packages/start-plugin-core/tests/importProtection/matchers.test.ts index 06579b9538..2cfb0acd9f 100644 --- a/packages/start-plugin-core/tests/importProtection/matchers.test.ts +++ b/packages/start-plugin-core/tests/importProtection/matchers.test.ts @@ -2,18 +2,21 @@ import { describe, expect, test } from 'vitest' import { compileMatcher, compileMatchers, + isLiteralMatcherPattern, matchesAny, -} from '../../src/import-protection-plugin/matchers' +} from '../../src/import-protection/matchers' describe('compileMatcher', () => { test('matches exact strings', () => { const m = compileMatcher('@tanstack/react-start/server') + expect(m.literal).toBe('@tanstack/react-start/server') expect(m.test('@tanstack/react-start/server')).toBe(true) expect(m.test('@tanstack/react-start/client')).toBe(false) }) test('matches glob with *', () => { const m = compileMatcher('**/*.server.*') + expect(m.literal).toBeUndefined() expect(m.test('src/utils/db.server.ts')).toBe(true) expect(m.test('src/utils/db.client.ts')).toBe(false) expect(m.test('secret.server.js')).toBe(true) @@ -39,6 +42,18 @@ describe('compileMatcher', () => { }) }) +describe('isLiteralMatcherPattern', () => { + test('classifies exact strings as literals', () => { + expect(isLiteralMatcherPattern('@tanstack/react-start/server')).toBe(true) + expect(isLiteralMatcherPattern('node:fs')).toBe(true) + }) + + test('classifies glob syntax as non-literal', () => { + expect(isLiteralMatcherPattern('**/*.server.*')).toBe(false) + expect(isLiteralMatcherPattern('{pg,postgres}')).toBe(false) + }) +}) + describe('compileMatchers', () => { test('compiles an array of patterns', () => { const matchers = compileMatchers([ diff --git a/packages/start-plugin-core/tests/importProtection/transform.test.ts b/packages/start-plugin-core/tests/importProtection/rewrite.test.ts similarity index 89% rename from packages/start-plugin-core/tests/importProtection/transform.test.ts rename to packages/start-plugin-core/tests/importProtection/rewrite.test.ts index 399c7e4ed4..cf0040fc95 100644 --- a/packages/start-plugin-core/tests/importProtection/transform.test.ts +++ b/packages/start-plugin-core/tests/importProtection/rewrite.test.ts @@ -1,5 +1,5 @@ import { describe, expect, test } from 'vitest' -import { rewriteDeniedImports } from '../../src/import-protection-plugin/rewriteDeniedImports' +import { rewriteDeniedImports } from '../../src/import-protection/rewrite' const MOCK_SUBSTR = 'tanstack-start-import-protection:mock' @@ -97,6 +97,23 @@ describe('rewriteDeniedImports', () => { expect(out).toContain('__tss_reexport_foo as myFoo') }) + test('rewrites string-literal import names with computed access', () => { + const out = rewrite( + `import { "foo-bar" as fooBar } from './secret.server';`, + ['./secret.server'], + ) + expect(out).toContain('const fooBar = __tss_deny_0["foo-bar"]') + }) + + test('rewrites string-literal re-export names with computed access', () => { + const out = rewrite( + `export { "foo-bar" as exposed } from './secret.server';`, + ['./secret.server'], + ) + expect(out).toContain('const __tss_reexport_0 = __tss_deny_0["foo-bar"]') + expect(out).toContain('__tss_reexport_0 as exposed') + }) + test('removes export * from "denied"', () => { const out = rewrite( `export * from './secret.server';\nexport const x = 1;`, diff --git a/packages/start-plugin-core/tests/importProtection/sourceLocation.test.ts b/packages/start-plugin-core/tests/importProtection/sourceLocation.test.ts index ea42a4c879..2586aa1889 100644 --- a/packages/start-plugin-core/tests/importProtection/sourceLocation.test.ts +++ b/packages/start-plugin-core/tests/importProtection/sourceLocation.test.ts @@ -1,14 +1,19 @@ import { describe, expect, test } from 'vitest' import { + createImportSpecifierLocationIndex, ImportLocCache, buildCodeSnippet, buildLineIndex, + findOriginalUsageLocation, + getOrCreateOriginalTransformResult, + normalizeSourceMap, pickOriginalCodeFromSourcesContent, -} from '../../src/import-protection-plugin/sourceLocation' +} from '../../src/import-protection/sourceLocation' import type { SourceMapLike, + TransformResult, TransformResultProvider, -} from '../../src/import-protection-plugin/sourceLocation' +} from '../../src/import-protection/sourceLocation' describe('pickOriginalCodeFromSourcesContent', () => { test('picks exact matching source by path', () => { @@ -140,6 +145,137 @@ describe('buildLineIndex', () => { }) }) +function makeTransformResult(code: string): TransformResult { + return { + code, + map: undefined, + originalCode: undefined, + } +} + +describe('createImportSpecifierLocationIndex', () => { + test('finds first matching import location across static and dynamic forms', () => { + const finder = createImportSpecifierLocationIndex() + const code = [ + `const later = import('./secret.server')`, + `import { getSecret } from './secret.server'`, + ].join('\n') + + expect( + finder.find(makeTransformResult(code), './secret.server'), + ).toBeGreaterThanOrEqual(0) + }) + + test('reuses cached per-result index without changing results', () => { + const finder = createImportSpecifierLocationIndex() + const result = makeTransformResult( + `import { getSecret } from './secret.server'`, + ) + + const first = finder.find(result, './secret.server') + const second = finder.find(result, './secret.server') + + expect(second).toBe(first) + expect(result.analysis?.importSpecifierLocationIndex).toBeDefined() + }) + + test('returns -1 when source is absent', () => { + const finder = createImportSpecifierLocationIndex() + expect( + finder.find(makeTransformResult('const x = 1'), './secret.server'), + ).toBe(-1) + }) + + test('finds dynamic imports with options', () => { + const finder = createImportSpecifierLocationIndex() + const code = + "const data = import('./secret.server', { with: { type: 'json' } })" + + expect( + finder.find(makeTransformResult(code), './secret.server'), + ).toBeGreaterThanOrEqual(0) + }) + + test('finds specifier locations in decorated modules', () => { + const finder = createImportSpecifierLocationIndex() + const code = [ + `@sealed class Example {}`, + `import { value } from './secret.server'`, + ].join('\n') + + expect(finder.find(makeTransformResult(code), './secret.server')).toBe( + code.indexOf('./secret.server'), + ) + }) + + test('finds import attributes syntax', () => { + const finder = createImportSpecifierLocationIndex() + const code = "import data from './secret.server' with { type: 'json' }" + + expect( + finder.find(makeTransformResult(code), './secret.server'), + ).toBeGreaterThanOrEqual(0) + }) + + test('finds export-all declarations', () => { + const finder = createImportSpecifierLocationIndex() + const code = "export * from './secret.server'" + + expect( + finder.find(makeTransformResult(code), './secret.server'), + ).toBeGreaterThanOrEqual(0) + }) + + test('returns earliest occurrence when the same specifier appears multiple times', () => { + const finder = createImportSpecifierLocationIndex() + const code = [ + `export * from './secret.server'`, + `import { getSecret } from './secret.server'`, + `const later = import('./secret.server')`, + ].join('\n') + + const idx = finder.find(makeTransformResult(code), './secret.server') + expect(idx).toBe(code.indexOf('./secret.server')) + }) + + test('reuses a lazily created original transform result', () => { + const result = makeTransformResult(`import { x } from './safe'`) + result.originalCode = `import { y } from './secret.server'` + + const first = getOrCreateOriginalTransformResult(result) + const second = getOrCreateOriginalTransformResult(result) + + expect(first).toBe(second) + expect(first?.code).toBe(result.originalCode) + }) +}) + +describe('normalizeSourceMap', () => { + test('normalizes sourcemap version, file, names, and sourcesContent', () => { + const normalized = normalizeSourceMap({ + version: '3', + sources: ['src/a.ts'], + names: undefined as unknown as Array, + sourcesContent: [null, 'A'], + mappings: '', + }) + + expect(normalized).toEqual({ + version: 3, + file: '', + sources: ['src/a.ts'], + names: [], + sourcesContent: ['', 'A'], + mappings: '', + }) + }) + + test('returns undefined for missing map', () => { + expect(normalizeSourceMap(undefined)).toBeUndefined() + expect(normalizeSourceMap(null)).toBeUndefined() + }) +}) + describe('buildCodeSnippet', () => { function makeProvider( code: string, @@ -235,6 +371,75 @@ describe('buildCodeSnippet', () => { }) }) +describe('findOriginalUsageLocation', () => { + function makeProvider( + code: string, + originalCode?: string, + ): TransformResultProvider { + return { + getTransformResult: () => ({ + code, + map: undefined, + originalCode, + }), + } + } + + test('prefers original usage site over import site when original code is available', () => { + const provider = makeProvider( + 'const secretServerFn = createServerFn().handler(rpc())\n', + [ + "import { createServerFn } from '@tanstack/react-start'", + "import { getSecret } from './secret.server'", + '', + 'export const secretServerFn = createServerFn().handler(async () => {', + ' return getSecret()', + '})', + '', + 'export function leakyReference() {', + ' return getSecret()', + '}', + ].join('\n'), + ) + + expect( + findOriginalUsageLocation( + provider, + '/test/compiler-leak.ts', + './secret.server', + 'client', + ), + ).toEqual({ + file: '/test/compiler-leak.ts', + line: 9, + column: 10, + }) + }) + + test('returns undefined when original usage only exists inside compiler-safe boundary', () => { + const provider = makeProvider( + 'export const safe = noop\n', + [ + "import { createServerOnlyFn } from '@tanstack/react-start'", + "import { getSecret } from './secret.server'", + '', + 'export const safe = createServerOnlyFn(() => {', + ' return getSecret()', + '})', + ].join('\n'), + ) + + expect( + findOriginalUsageLocation( + provider, + '/test/boundary-safe.ts', + './secret.server', + 'client', + ), + ).toBeUndefined() + }) +}) + describe('ImportLocCache', () => { test('stores and retrieves values', () => { const cache = new ImportLocCache() diff --git a/packages/start-plugin-core/tests/importProtection/trace.test.ts b/packages/start-plugin-core/tests/importProtection/trace.test.ts index d901d5fa2d..874adc0fab 100644 --- a/packages/start-plugin-core/tests/importProtection/trace.test.ts +++ b/packages/start-plugin-core/tests/importProtection/trace.test.ts @@ -3,8 +3,8 @@ import { ImportGraph, buildTrace, formatViolation, -} from '../../src/import-protection-plugin/trace' -import type { ViolationInfo } from '../../src/import-protection-plugin/trace' +} from '../../src/import-protection/trace' +import type { ViolationInfo } from '../../src/import-protection/trace' describe('ImportGraph', () => { test('addEdge and reverse lookup', () => { @@ -207,7 +207,6 @@ describe('formatViolation', () => { { file: '/project/src/main.tsx' }, { file: '/project/src/routes/index.tsx', specifier: './routes/index' }, ], - message: 'Import denied', } const formatted = formatViolation(info, '/project') @@ -231,7 +230,6 @@ describe('formatViolation', () => { importer: '/project/src/edge-a.ts', resolved: '/project/src/secret.server.ts', trace: [], - message: 'Import denied', } const formatted = formatViolation(info, '/project') @@ -255,7 +253,6 @@ describe('formatViolation', () => { specifier: '@tanstack/react-start/server-only', importer: '/project/src/routes/index.tsx', trace: [], - message: 'Module is server-only', } const formatted = formatViolation(info, '/project') @@ -277,7 +274,6 @@ describe('formatViolation', () => { importer: '/project/src/routes/page.tsx', resolved: '/project/src/browser-api.client.ts', trace: [], - message: 'Import denied', } const formatted = formatViolation(info, '/project') @@ -299,7 +295,6 @@ describe('formatViolation', () => { specifier: 'node:fs', importer: '/project/src/routes/page.tsx', trace: [], - message: 'Import denied', } const formatted = formatViolation(info, '/project') @@ -317,7 +312,6 @@ describe('formatViolation', () => { importer: '/project/src/routes/page.tsx', resolved: '/project/src/browser-api.client.ts', trace: [], - message: 'Import denied', snippet: { lines: [ ' 15 |
    ', @@ -351,7 +345,6 @@ describe('formatViolation', () => { specifier: '@tanstack/react-start/server', importer: '/project/src/routes/index.tsx', trace: [], - message: 'Import denied', } const formatted = formatViolation(info, '/project') @@ -371,7 +364,6 @@ describe('formatViolation', () => { specifier: '@tanstack/react-start/client-only', importer: '/project/src/routes/page.tsx', trace: [], - message: 'Module is client-only', } const formatted = formatViolation(info, '/project') @@ -401,7 +393,6 @@ describe('formatViolation', () => { specifier: '/project/src/utils/prisma', }, ], - message: 'Import denied', } const formatted = formatViolation(info, '/project') @@ -428,7 +419,6 @@ describe('formatViolation', () => { specifier: './secret.server', }, ], - message: 'Import denied', } const formatted = formatViolation(info, '/project') diff --git a/packages/start-plugin-core/tests/importProtection/utils.test.ts b/packages/start-plugin-core/tests/importProtection/utils.test.ts index 19833b26fc..459601036f 100644 --- a/packages/start-plugin-core/tests/importProtection/utils.test.ts +++ b/packages/start-plugin-core/tests/importProtection/utils.test.ts @@ -1,21 +1,26 @@ import { describe, expect, test } from 'vitest' +import { getImportSources } from '../../src/import-protection/analysis' +import { escapeRegExp } from '../../src/utils' import { buildResolutionCandidates, buildSourceCandidates, canonicalizeResolvedId, + checkFileDenial, + dedupeViolationKey, dedupePatterns, - escapeRegExp, - extractImportSources, getOrCreate, isInsideDirectory, + isFileExcluded, normalizeFilePath, relativizePath, shouldDeferViolation, stripQuery, stripQueryAndHash, withoutKnownExtension, -} from '../../src/import-protection-plugin/utils' +} from '../../src/import-protection/utils' +import { compileMatchers } from '../../src/import-protection/matchers' +import { formatViolation } from '../../src/import-protection/trace' describe('dedupePatterns', () => { test('dedupes strings and preserves first occurrence order', () => { @@ -90,6 +95,50 @@ describe('buildSourceCandidates', () => { }) }) +describe('checkFileDenial', () => { + test('returns matching file matcher when file is denied', () => { + const matchers = { + files: compileMatchers(['**/*.server.*']), + excludeFiles: compileMatchers([]), + } + + const result = checkFileDenial('src/secret.server.ts', matchers) + + expect(result?.pattern).toBe('**/*.server.*') + }) + + test('returns undefined when file is excluded', () => { + const matchers = { + files: compileMatchers(['**/*.server.*']), + excludeFiles: compileMatchers(['**/node_modules/**']), + } + + expect( + checkFileDenial('node_modules/pkg/index.server.js', matchers), + ).toBeUndefined() + }) +}) + +describe('isFileExcluded', () => { + test('returns true when exclude matcher matches', () => { + const matchers = { + excludeFiles: compileMatchers(['**/node_modules/**']), + } + + expect(isFileExcluded('node_modules/pkg/index.server.js', matchers)).toBe( + true, + ) + }) + + test('returns false when exclude matcher does not match', () => { + const matchers = { + excludeFiles: compileMatchers(['**/node_modules/**']), + } + + expect(isFileExcluded('src/secret.server.ts', matchers)).toBe(false) + }) +}) + describe('buildResolutionCandidates', () => { test('returns deduped id variants', () => { expect(buildResolutionCandidates('/a/b.ts?x=1')).toEqual([ @@ -133,6 +182,29 @@ describe('shouldDeferViolation', () => { }) }) +describe('dedupeViolationKey', () => { + test('includes resolved path when present', () => { + expect( + dedupeViolationKey({ + type: 'file', + importer: '/app/src/a.ts', + specifier: './secret.server', + resolved: '/app/src/secret.server.ts', + }), + ).toBe('file:/app/src/a.ts:./secret.server:/app/src/secret.server.ts') + }) + + test('uses empty resolved segment when resolved is absent', () => { + expect( + dedupeViolationKey({ + type: 'specifier', + importer: '/app/src/a.ts', + specifier: '@tanstack/react-start/server', + }), + ).toBe('specifier:/app/src/a.ts:@tanstack/react-start/server:') + }) +}) + describe('isInsideDirectory', () => { test('returns true for file inside directory', () => { expect(isInsideDirectory('/app/src/foo.ts', '/app/src')).toBe(true) @@ -179,20 +251,52 @@ describe('normalizeFilePath', () => { }) }) -describe('extractImportSources', () => { +describe('getImportSources', () => { test('extracts static import sources', () => { const code = `import { foo } from 'bar'\nimport baz from "qux"` - expect(extractImportSources(code)).toEqual(['bar', 'qux']) + expect(getImportSources(code)).toEqual(['bar', 'qux']) + }) + + test('skips type-only static import sources', () => { + const code = [ + `import type { Foo } from './foo.server'`, + `import { type Bar } from './bar.server'`, + ].join('\n') + expect(getImportSources(code)).toEqual([]) + }) + + test('keeps mixed type and value static import sources', () => { + const code = `import { type Foo, bar } from './mixed.server'` + expect(getImportSources(code)).toEqual(['./mixed.server']) + }) + + test('keeps side-effect import sources', () => { + const code = `import './setup.server'` + expect(getImportSources(code)).toEqual(['./setup.server']) }) test('extracts re-export sources', () => { const code = `export { a } from './mod'\nexport * from "./other"` - expect(extractImportSources(code)).toEqual(['./mod', './other']) + expect(getImportSources(code)).toEqual(['./mod', './other']) + }) + + test('skips type-only re-export sources', () => { + const code = [ + `export type { Foo } from './foo.server'`, + `export { type Bar } from './bar.server'`, + `export type * from './baz.server'`, + ].join('\n') + expect(getImportSources(code)).toEqual([]) + }) + + test('keeps mixed type and value re-export sources', () => { + const code = `export { type Foo, bar } from './mixed.server'` + expect(getImportSources(code)).toEqual(['./mixed.server']) }) test('extracts dynamic import sources', () => { const code = `const m = import('./lazy')\nconst n = import("./lazy2")` - expect(extractImportSources(code)).toEqual(['./lazy', './lazy2']) + expect(getImportSources(code)).toEqual(['./lazy', './lazy2']) }) test('handles mixed import styles', () => { @@ -201,26 +305,37 @@ describe('extractImportSources', () => { `export { b } from './reexport'`, `const c = import('./dynamic')`, ].join('\n') - expect(extractImportSources(code)).toEqual([ + expect(getImportSources(code)).toEqual([ 'static', './reexport', './dynamic', ]) }) + test('extracts imports from decorated modules', () => { + const code = [ + `@sealed class Example {}`, + `import { value } from 'broken'`, + ].join('\n') + expect(getImportSources(code)).toEqual(['broken']) + }) + test('returns empty array for code with no imports', () => { - expect(extractImportSources('const x = 1')).toEqual([]) + expect(getImportSources('const x = 1')).toEqual([]) }) test('handles empty string', () => { - expect(extractImportSources('')).toEqual([]) + expect(getImportSources('')).toEqual([]) }) test('does not match import in comments or strings', () => { - // The regex is intentionally lightweight and will match inside strings/comments. - // This test documents the actual behavior. const code = `// import { x } from 'commented'` - expect(extractImportSources(code)).toEqual(['commented']) + expect(getImportSources(code)).toEqual([]) + }) + + test('extracts import attributes syntax', () => { + const code = `import data from './data.json' with { type: 'json' }` + expect(getImportSources(code)).toEqual(['./data.json']) }) }) diff --git a/packages/start-plugin-core/tests/importProtection/virtualModules.test.ts b/packages/start-plugin-core/tests/importProtection/virtualModules.test.ts index 29f925aed5..70f174650c 100644 --- a/packages/start-plugin-core/tests/importProtection/virtualModules.test.ts +++ b/packages/start-plugin-core/tests/importProtection/virtualModules.test.ts @@ -11,8 +11,28 @@ import { loadSilentMockModule, makeMockEdgeModuleId, mockRuntimeModuleIdFromViolation, -} from '../../src/import-protection-plugin/virtualModules' -import type { ViolationInfo } from '../../src/import-protection-plugin/trace' +} from '../../src/vite/import-protection-plugin/virtualModules' +import type { ViolationInfo } from '../../src/import-protection/trace' + +type MockValue = { + toString: () => string + valueOf: () => string + toJSON: () => string +} + +type MockFunction = { + (): MockValue +} + +function evaluateGeneratedModule(code: string): T { + const exports: Record = {} + const runnableCode = code + .replace(/export default mock;?/g, 'exports.default = mock;') + .replace(/export const ([A-Za-z_$][\w$]*) = ([^;]+);/g, 'exports.$1 = $2;') + + new Function('exports', runnableCode)(exports) + return exports as T +} describe('loadSilentMockModule', () => { test('returns mock code', () => { @@ -23,6 +43,17 @@ describe('loadSilentMockModule', () => { expect(result.code).toContain('@__NO_SIDE_EFFECTS__') expect(result.code).toContain('@__PURE__') }) + + test('supports primitive conversion for called mocks', () => { + const result = loadSilentMockModule() + const mod = evaluateGeneratedModule<{ default: MockFunction }>(result.code) + const value = mod.default() + + expect(String(value)).toBe('[import-protection mock]') + expect(value.toString()).toBe('[import-protection mock]') + expect(value.valueOf()).toBe('[import-protection mock]') + expect(JSON.stringify(value)).toBe('"[import-protection mock]"') + }) }) describe('loadMarkerModule', () => { @@ -137,7 +168,6 @@ describe('mockRuntimeModuleIdFromViolation', () => { { file: '/project/src/main.tsx' }, { file: '/project/src/routes/index.tsx', specifier: './secret.server' }, ], - message: 'Import denied', } test('returns MOCK_MODULE_ID when mode is off', () => { @@ -269,7 +299,16 @@ describe('generateSelfContainedMockModule', () => { test('is self-contained (no imports)', () => { const result = generateSelfContainedMockModule(['foo']) // Should not import from any other module - expect(result.code).not.toMatch(/\bimport\b/) + expect(result.code).not.toMatch(/^\s*import\s/m) + }) + + test('supports primitive conversion for named export calls', () => { + const result = generateSelfContainedMockModule(['getSecret']) + const mod = evaluateGeneratedModule<{ getSecret: MockFunction }>( + result.code, + ) + + expect(String(mod.getSecret())).toBe('[import-protection mock]') }) }) diff --git a/packages/start-plugin-core/tests/post-server-build.test.ts b/packages/start-plugin-core/tests/post-server-build.test.ts index 6e4db4289d..763f5e5d05 100644 --- a/packages/start-plugin-core/tests/post-server-build.test.ts +++ b/packages/start-plugin-core/tests/post-server-build.test.ts @@ -1,5 +1,4 @@ import { describe, expect, it, vi } from 'vitest' -import { VITE_ENVIRONMENT_NAMES } from '../src/constants' vi.mock('@tanstack/start-server-core', () => ({ HEADERS: { @@ -7,32 +6,14 @@ vi.mock('@tanstack/start-server-core', () => ({ }, })) -vi.mock('../src/prerender', () => ({ - prerender: vi.fn(async () => {}), -})) - vi.mock('../src/build-sitemap', () => ({ buildSitemap: vi.fn(), })) describe('postServerBuild', () => { - const builder = { - environments: { - [VITE_ENVIRONMENT_NAMES.client]: { - config: { build: { outDir: '/client' } }, - }, - [VITE_ENVIRONMENT_NAMES.server]: { - config: { build: { outDir: '/server' } }, - }, - }, - config: { - build: { outDir: '/root' }, - }, - } as any - it('rejects absolute SPA maskPath URLs to avoid external prerendering', async () => { - // Import after mocks are set up - const { postServerBuild } = await import('../src/post-server-build') + const prerender = vi.fn(async () => {}) + const { postBuild } = await import('../src/post-build') const startConfig = { spa: { @@ -47,8 +28,16 @@ describe('postServerBuild', () => { sitemap: { enabled: false }, } as any - await expect(postServerBuild({ builder, startConfig })).rejects.toThrow( - /maskPath/i, - ) + await expect( + postBuild({ + startConfig, + adapter: { + getClientOutputDirectory: () => '/client', + prerender, + }, + }), + ).rejects.toThrow(/maskPath/i) + + expect(prerender).not.toHaveBeenCalled() }) }) diff --git a/packages/start-plugin-core/tests/prerender-ssrf.test.ts b/packages/start-plugin-core/tests/prerender-ssrf.test.ts index 397229f0f8..e245a13249 100644 --- a/packages/start-plugin-core/tests/prerender-ssrf.test.ts +++ b/packages/start-plugin-core/tests/prerender-ssrf.test.ts @@ -1,6 +1,5 @@ import { describe, expect, it, vi } from 'vitest' import { prerender } from '../src/prerender' -import { VITE_ENVIRONMENT_NAMES } from '../src/constants' vi.mock('../src/utils', async () => { const actual = await vi.importActual('../src/utils') @@ -10,21 +9,6 @@ vi.mock('../src/utils', async () => { } }) -vi.mock('../src/prerender', async () => { - const actual = await vi.importActual('../src/prerender') - return { - ...actual, - } -}) - -// Mock vite to prevent actual server from starting -vi.mock('vite', () => ({ - preview: vi.fn().mockResolvedValue({ - resolvedUrls: { local: ['http://localhost:5173/'] }, - close: vi.fn().mockResolvedValue(undefined), - }), -})) - // Mock fs to prevent actual file system operations vi.mock('node:fs', async () => { const actual = await vi.importActual('node:fs') @@ -38,17 +22,6 @@ vi.mock('node:fs', async () => { } }) -const builder = { - environments: { - [VITE_ENVIRONMENT_NAMES.client]: { - config: { build: { outDir: '/client' } }, - }, - [VITE_ENVIRONMENT_NAMES.server]: { - config: { build: { outDir: '/server' } }, - }, - }, -} as any - const fetchMock = vi.fn( async () => new Response('', { @@ -59,6 +32,11 @@ const fetchMock = vi.fn( vi.stubGlobal('fetch', fetchMock) +const handler = { + getClientOutputDirectory: () => '/client', + request: fetchMock, +} + function resetFetch() { fetchMock.mockClear() } @@ -89,7 +67,7 @@ describe('prerender pages validation', () => { resetFetch() const startConfig = makeStartConfig('https://attacker.test/leak') - await expect(prerender({ startConfig, builder })).rejects.toThrow( + await expect(prerender({ startConfig, handler })).rejects.toThrow( /prerender page path must be relative/i, ) expect(fetchMock).not.toHaveBeenCalled() @@ -99,7 +77,7 @@ describe('prerender pages validation', () => { resetFetch() const startConfig = makeStartConfig('/about') - await expect(prerender({ startConfig, builder })).resolves.not.toThrow() + await expect(prerender({ startConfig, handler })).resolves.not.toThrow() }) it('resolves when prerender filter matches no pages', async () => { @@ -107,7 +85,7 @@ describe('prerender pages validation', () => { const startConfig = makeStartConfig('/about') startConfig.prerender.filter = () => false - await expect(prerender({ startConfig, builder })).resolves.not.toThrow() + await expect(prerender({ startConfig, handler })).resolves.not.toThrow() expect(fetchMock).not.toHaveBeenCalled() }) }) diff --git a/packages/start-plugin-core/tests/rsbuild/import-protection.test.ts b/packages/start-plugin-core/tests/rsbuild/import-protection.test.ts new file mode 100644 index 0000000000..5048d39549 --- /dev/null +++ b/packages/start-plugin-core/tests/rsbuild/import-protection.test.ts @@ -0,0 +1,51 @@ +import { describe, expect, test } from 'vitest' +import { compileMatchers } from '../../src/import-protection/matchers' +import { getRsbuildResolvedImportProtectionCheck } from '../../src/rsbuild/import-protection' + +describe('getRsbuildResolvedImportProtectionCheck', () => { + test('skips file and marker checks for excluded resolved files', () => { + const matchers = { + files: compileMatchers(['**/*.server.*']), + excludeFiles: compileMatchers(['**/node_modules/**']), + } + + expect( + getRsbuildResolvedImportProtectionCheck( + 'node_modules/pkg/marked-server-only.ts', + matchers, + ), + ).toBeUndefined() + }) + + test('classifies non-excluded denied files as file checks', () => { + const matchers = { + files: compileMatchers(['**/*.server.*']), + excludeFiles: compileMatchers(['**/node_modules/**']), + } + + const result = getRsbuildResolvedImportProtectionCheck( + 'src/secret.server.ts', + matchers, + ) + + expect(result?.type).toBe('file') + if (result?.type !== 'file') { + throw new Error('Expected file import-protection check') + } + expect(result.fileMatch.pattern).toBe('**/*.server.*') + }) + + test('classifies non-excluded non-denied files as marker candidates', () => { + const matchers = { + files: compileMatchers(['**/*.server.*']), + excludeFiles: compileMatchers(['**/node_modules/**']), + } + + expect( + getRsbuildResolvedImportProtectionCheck( + 'src/marked-server-only.ts', + matchers, + ), + ).toEqual({ type: 'marker' }) + }) +}) diff --git a/packages/start-plugin-core/tests/rsbuild/output-directory.test.ts b/packages/start-plugin-core/tests/rsbuild/output-directory.test.ts new file mode 100644 index 0000000000..c0185a74eb --- /dev/null +++ b/packages/start-plugin-core/tests/rsbuild/output-directory.test.ts @@ -0,0 +1,136 @@ +import { describe, expect, test } from 'vitest' +import { + createRsbuildEnvironmentPlan, + resolveRsbuildOutputDirectory, +} from '../../src/rsbuild/planning' + +describe('resolveRsbuildOutputDirectory', () => { + test('uses explicit environment distPath string', () => { + expect( + resolveRsbuildOutputDirectory({ + distPath: 'custom/client', + rootDistPath: 'build', + fallback: 'dist/client', + subdirectory: 'client', + }), + ).toBe('custom/client') + }) + + test('uses explicit environment distPath root object', () => { + expect( + resolveRsbuildOutputDirectory({ + distPath: { root: 'custom/server' }, + rootDistPath: { root: 'build' }, + fallback: 'dist/server', + subdirectory: 'server', + }), + ).toBe('custom/server') + }) + + test('derives environment directory from top-level string distPath', () => { + expect( + resolveRsbuildOutputDirectory({ + distPath: undefined, + rootDistPath: 'build', + fallback: 'dist/client', + subdirectory: 'client', + }), + ).toBe('build/client') + }) + + test('derives environment directory from top-level root distPath object', () => { + expect( + resolveRsbuildOutputDirectory({ + distPath: undefined, + rootDistPath: { root: 'build' }, + fallback: 'dist/server', + subdirectory: 'server', + }), + ).toBe('build/server') + }) + + test('falls back to default directory when no distPath is configured', () => { + expect( + resolveRsbuildOutputDirectory({ + distPath: undefined, + rootDistPath: undefined, + fallback: 'dist/client', + subdirectory: 'client', + }), + ).toBe('dist/client') + }) +}) + +describe('createRsbuildEnvironmentPlan client output', () => { + const baseOptions = { + root: '/app', + entryAliases: { + client: '/app/src/client.tsx', + server: '/app/src/server.ts', + start: '/app/src/start.ts', + router: '/app/src/router.tsx', + alias: { + 'virtual:tanstack-start-client-entry': '/app/src/client.tsx', + 'virtual:tanstack-start-server-entry': '/app/src/server.ts', + '#tanstack-start-entry': '/app/src/start.ts', + '#tanstack-router-entry': '/app/src/router.tsx', + }, + }, + clientOutputDirectory: 'dist/client', + serverOutputDirectory: 'dist/server', + publicBase: '/_build/', + serverFnProviderEnv: 'ssr', + } + + test('sets client output.module from scriptFormat', () => { + expect( + createRsbuildEnvironmentPlan({ + ...baseOptions, + scriptFormat: 'iife', + }).environments.client!.output?.module, + ).toBe(false) + + expect( + createRsbuildEnvironmentPlan({ + ...baseOptions, + scriptFormat: 'module', + }).environments.client!.output?.module, + ).toBe(true) + }) + + test('throws when client output.module conflicts with scriptFormat', () => { + expect(() => + createRsbuildEnvironmentPlan({ + ...baseOptions, + scriptFormat: 'iife', + environmentOverrides: { + client: { + output: { + module: true, + }, + }, + }, + }), + ).toThrow( + 'TanStack Start rsbuild.client.output controls environments.client.output.module', + ) + }) + + test('throws when shared output.module conflicts with scriptFormat', () => { + expect(() => + createRsbuildEnvironmentPlan({ + ...baseOptions, + scriptFormat: 'iife', + environmentOverrides: { + all: { + output: { + module: true, + }, + }, + }, + }), + ).toThrow( + 'TanStack Start rsbuild.client.output controls environments.client.output.module', + ) + }) +}) diff --git a/packages/start-plugin-core/tests/rsbuild/plugin.test.ts b/packages/start-plugin-core/tests/rsbuild/plugin.test.ts new file mode 100644 index 0000000000..b57aebade1 --- /dev/null +++ b/packages/start-plugin-core/tests/rsbuild/plugin.test.ts @@ -0,0 +1,41 @@ +import { describe, expect, test } from 'vitest' +import { enableSwcReactServerComponents } from '../../src/rsbuild/swc-rsc' + +describe('enableSwcReactServerComponents', () => { + test('clones rspack rules without structuredClone so function fields survive', () => { + const optionFn = () => 'kept' + const ruleFn = () => true + const config = { + module: { + rules: [ + { + test: /\.[jt]sx?$/, + issuer: ruleFn, + use: [ + { + loader: 'builtin:swc-loader', + options: { + optionFn, + }, + }, + ], + }, + ], + }, + resolve: {}, + } as any + + expect(() => { + enableSwcReactServerComponents(config, 'rsc-subtree') + }).not.toThrow() + + const oneOf = config.module.rules[0].oneOf + expect(oneOf).toHaveLength(4) + expect(oneOf[0].issuer).toBe(ruleFn) + expect(oneOf[0].use[0].options.optionFn).toBe(optionFn) + expect( + oneOf[0].use[0].options.rspackExperiments.reactServerComponents, + ).toEqual({}) + expect(oneOf[3].use[0].options.rspackExperiments).toBeUndefined() + }) +}) diff --git a/packages/start-plugin-core/tests/rsbuild/post-build.test.ts b/packages/start-plugin-core/tests/rsbuild/post-build.test.ts new file mode 100644 index 0000000000..9f302d5c8e --- /dev/null +++ b/packages/start-plugin-core/tests/rsbuild/post-build.test.ts @@ -0,0 +1,60 @@ +import { describe, expect, it, vi } from 'vitest' +import { mkdtemp, rm, writeFile } from 'node:fs/promises' +import { tmpdir } from 'node:os' +import { join } from 'pathe' + +vi.mock('@tanstack/start-server-core', () => ({ + HEADERS: { + TSS_SHELL: 'x-tss-shell', + }, +})) + +describe('postBuildWithRsbuild', () => { + it('imports server/index.js and accepts object fetch handlers', async () => { + const serverOutputDirectory = await mkdtemp(join(tmpdir(), 'tss-rsbuild-')) + const prerenderSpy = vi.fn(async ({ handler }: any) => { + const response = await handler.request('/posts') + expect(await response.text()).toBe('ok') + }) + + vi.doMock('../../src/prerender', async () => { + const actual = await vi.importActual('../../src/prerender') + return { + ...actual, + prerender: prerenderSpy, + } + }) + + await writeFile( + join(serverOutputDirectory, 'index.js'), + [ + 'export default {', + ' fetch() {', + " return new Response('ok')", + ' },', + '}', + ].join('\n'), + ) + + const { postBuildWithRsbuild } = + await import('../../src/rsbuild/post-build') + + try { + await postBuildWithRsbuild({ + startConfig: { + prerender: { enabled: true, autoStaticPathsDiscovery: false }, + pages: [{ path: '/posts' }], + router: { basepath: '' }, + spa: { enabled: false, prerender: { outputPath: '/_shell' } }, + sitemap: { enabled: false }, + } as any, + clientOutputDirectory: '/client', + serverOutputDirectory, + }) + + expect(prerenderSpy).toHaveBeenCalledOnce() + } finally { + await rm(serverOutputDirectory, { recursive: true, force: true }) + } + }) +}) diff --git a/packages/start-plugin-core/tests/schema.test.ts b/packages/start-plugin-core/tests/schema.test.ts new file mode 100644 index 0000000000..41509e249c --- /dev/null +++ b/packages/start-plugin-core/tests/schema.test.ts @@ -0,0 +1,41 @@ +import path from 'node:path' +import { describe, expect, test } from 'vitest' +import { parseStartConfig as parseViteStartConfig } from '../src/vite/schema' +import { parseStartConfig as parseRsbuildStartConfig } from '../src/rsbuild/schema' + +const root = process.cwd() +const corePluginOpts = { framework: 'react' as const } + +describe('start config schema', () => { + test('uses Start route defaults relative to srcDirectory', () => { + const config = parseViteStartConfig({}, corePluginOpts, root) + + expect(config.router.routesDirectory).toBe( + path.resolve(root, 'src', 'routes'), + ) + expect(config.router.generatedRouteTree).toBe( + path.resolve(root, 'src', 'routeTree.gen.ts'), + ) + }) + + test('uses router path overrides relative to srcDirectory', () => { + const config = parseRsbuildStartConfig( + { + srcDirectory: 'app', + router: { + routesDirectory: 'pages', + generatedRouteTree: 'routes.gen.ts', + }, + }, + corePluginOpts, + root, + ) + + expect(config.router.routesDirectory).toBe( + path.resolve(root, 'app', 'pages'), + ) + expect(config.router.generatedRouteTree).toBe( + path.resolve(root, 'app', 'routes.gen.ts'), + ) + }) +}) diff --git a/packages/start-plugin-core/tests/start-manifest-plugin.test.ts b/packages/start-plugin-core/tests/start-manifest-plugin.test.ts new file mode 100644 index 0000000000..68270fb6d7 --- /dev/null +++ b/packages/start-plugin-core/tests/start-manifest-plugin.test.ts @@ -0,0 +1,58 @@ +import { VIRTUAL_MODULES } from '@tanstack/start-server-core' +import { describe, expect, test, vi } from 'vitest' +import { DEV_CLIENT_ENTRY, START_ENVIRONMENT_NAMES } from '../src/constants' +import { startManifestPlugin } from '../src/vite/start-manifest-plugin/plugin' + +vi.mock('@tanstack/start-server-core', () => ({ + VIRTUAL_MODULES: { + startManifest: 'tanstack-start-manifest:v', + }, +})) + +describe('startManifestPlugin', () => { + test('uses the virtual client entry during unbundled dev', () => { + expect(loadDevManifest({ bundledDev: false })).toContain( + `src: '/@id/${DEV_CLIENT_ENTRY}'`, + ) + }) + + test('uses the bundled client entry during bundled dev', () => { + expect(loadDevManifest({ bundledDev: true })).toContain( + `src: '/assets/index.js'`, + ) + }) +}) + +function loadDevManifest(opts: { bundledDev: boolean }) { + const plugins = startManifestPlugin({ + getConfig: () => + ({ + resolvedStartConfig: { + basePaths: { + publicBase: '/', + }, + }, + }) as any, + }) as Array + const plugin = plugins.find( + (item) => item.name === 'tanstack-start:start-manifest-plugin', + )! + const resolvedId = plugin.resolveId.handler(VIRTUAL_MODULES.startManifest) + + return plugin.load.handler.call( + { + environment: { + name: START_ENVIRONMENT_NAMES.server, + config: { + command: 'serve', + environments: { + [START_ENVIRONMENT_NAMES.client]: { + isBundled: opts.bundledDev, + }, + }, + }, + }, + }, + resolvedId, + ) +} diff --git a/packages/start-plugin-core/tests/start-manifest-plugin/manifestBuilder.test.ts b/packages/start-plugin-core/tests/start-manifest-plugin/manifestBuilder.test.ts index 40eddb745e..652f5451a1 100644 --- a/packages/start-plugin-core/tests/start-manifest-plugin/manifestBuilder.test.ts +++ b/packages/start-plugin-core/tests/start-manifest-plugin/manifestBuilder.test.ts @@ -1,16 +1,34 @@ import { describe, expect, test } from 'vitest' +import { deserialize } from 'seroval' +import { shouldRebaseInlineCssUrls } from '../../src/start-manifest-plugin/inlineCss' import { - appendUniqueAssets, appendUniqueStrings, buildStartManifest, - collectDynamicImportCss, createChunkCssAssetCollector, createManifestAssetResolvers, - getRouteFilePathsFromModuleIds, + serializeStartManifest, scanClientChunks, + type StartManifest, } from '../../src/start-manifest-plugin/manifestBuilder' -import type { Manifest } from '@tanstack/router-core' +import type { ManifestCssLink } from '@tanstack/router-core' import type { Rollup } from 'vite' +import { + getRouteFilePathsFromModuleIds, + normalizeViteClientBuild, + normalizeViteClientChunk, +} from '../../src/vite/start-manifest-plugin/normalized-client-build' + +function normalizeTestBuild(bundle: Rollup.OutputBundle) { + return normalizeViteClientBuild(bundle) +} + +function normalizeTestChunk(chunk: Rollup.OutputChunk) { + return normalizeViteClientChunk(chunk) +} + +function deserializeSerializedManifest(serialized: string): StartManifest { + return deserialize(serialized) as StartManifest +} function makeChunk(options: { fileName: string @@ -45,6 +63,26 @@ function makeChunk(options: { } as unknown as Rollup.OutputChunk } +function makeCssAsset(fileName: string, source: string): Rollup.OutputAsset { + return { + type: 'asset', + fileName, + name: fileName, + names: [fileName], + source, + needsCodeReference: false, + originalFileNames: [], + } as unknown as Rollup.OutputAsset +} + +function makeStylesheetLink(href: string): ManifestCssLink { + return href +} + +function getManifestCssHref(link: ManifestCssLink) { + return typeof link === 'string' ? link : link.href +} + describe('getRouteFilePathsFromModuleIds', () => { test('returns unique route file paths only for tsr split modules', () => { expect( @@ -103,65 +141,6 @@ describe('appendUniqueStrings', () => { }) }) -describe('appendUniqueAssets', () => { - test('dedupes by asset identity while preserving order', () => { - const baseAsset = { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/a.css', - type: 'text/css', - }, - } as const - const duplicateAsset = { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/a.css', - type: 'text/css', - }, - } as const - const newAsset = { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/b.css', - type: 'text/css', - }, - } as const - - expect(appendUniqueAssets([baseAsset], [duplicateAsset, newAsset])).toEqual( - [baseAsset, newAsset], - ) - }) - - test('returns original target array when nothing new is appended', () => { - const target = [ - { - tag: 'link' as const, - attrs: { - rel: 'stylesheet', - href: '/assets/a.css', - type: 'text/css', - }, - }, - ] - - expect( - appendUniqueAssets(target, [ - { - tag: 'link' as const, - attrs: { - rel: 'stylesheet', - href: '/assets/a.css', - type: 'text/css', - }, - }, - ]), - ).toBe(target) - }) -}) - describe('scanClientChunks', () => { test('collects entry chunk and route chunk mappings', () => { const entryChunk = makeChunk({ fileName: 'entry.js', isEntry: true }) @@ -170,124 +149,45 @@ describe('scanClientChunks', () => { moduleIds: ['/routes/posts.tsx?tsr-split=component'], }) - const scanned = scanClientChunks({ + const normalizedBuild = normalizeTestBuild({ 'entry.js': entryChunk, 'posts.js': routeChunk, }) + const scanned = scanClientChunks(normalizedBuild) - expect(scanned.entryChunk).toBe(entryChunk) - expect(scanned.routeEntryChunks.has(routeChunk)).toBe(true) + expect(scanned.entryChunk).toBe( + normalizedBuild.chunksByFileName.get('entry.js'), + ) expect(scanned.routeChunksByFilePath.get('/routes/posts.tsx')).toEqual([ - routeChunk, + normalizedBuild.chunksByFileName.get('posts.js')!, ]) }) + test('detects Hydrate metadata from chunk module ids', () => { + const chunk = normalizeTestChunk( + makeChunk({ + fileName: 'widget.js', + moduleIds: ['/routes/posts.tsx?tss-hydrate=posts_widget'], + }), + ) + + expect(chunk.hydrationIds).toEqual(['posts_widget']) + }) + test('throws when no entry chunk exists', () => { const routeChunk = makeChunk({ fileName: 'posts.js', moduleIds: ['/routes/posts.tsx?tsr-split=component'], }) - expect(() => scanClientChunks({ 'posts.js': routeChunk })).toThrow( - 'No entry file found', - ) - }) -}) - -describe('collectDynamicImportCss', () => { - test('collects css reachable through dynamic imports only', () => { - const routeChunk = makeChunk({ - fileName: 'route.js', - dynamicImports: ['lazy.js'], - importedCss: ['route.css'], - }) - const lazyChunk = makeChunk({ - fileName: 'lazy.js', - imports: ['shared.js'], - importedCss: ['lazy.css'], - }) - const sharedChunk = makeChunk({ - fileName: 'shared.js', - importedCss: ['shared.css'], - }) - - const dynamicCss = collectDynamicImportCss( - new Set([routeChunk]), - new Map([ - ['route.js', routeChunk], - ['lazy.js', lazyChunk], - ['shared.js', sharedChunk], - ]), - ) - - expect(Array.from(dynamicCss)).toEqual([]) - }) - - test('ignores CSS shared only across router-managed routes', () => { - const routeA = makeChunk({ - fileName: 'routeA.js', - imports: ['shared.js'], - moduleIds: ['/routes/a.tsx?tsr-split=component'], - }) - const routeB = makeChunk({ - fileName: 'routeB.js', - imports: ['shared.js'], - moduleIds: ['/routes/b.tsx?tsr-split=component'], - }) - const sharedChunk = makeChunk({ - fileName: 'shared.js', - importedCss: ['shared.css'], - }) - - const dynamicCss = collectDynamicImportCss( - new Set([routeA, routeB]), - new Map([ - ['routeA.js', routeA], - ['routeB.js', routeB], - ['shared.js', sharedChunk], - ]), - ) - - expect(dynamicCss.has('shared.css')).toBe(false) - }) - - test('collects css reachable through both router-managed and non-route dynamic imports', () => { - const entryChunk = makeChunk({ - fileName: 'entry.js', - isEntry: true, - dynamicImports: ['lazy.js'], - }) - const routeChunk = makeChunk({ - fileName: 'route.js', - imports: ['shared.js'], - moduleIds: ['/routes/home.tsx?tsr-split=component'], - }) - const lazyChunk = makeChunk({ - fileName: 'lazy.js', - imports: ['shared.js'], - }) - const sharedChunk = makeChunk({ - fileName: 'shared.js', - importedCss: ['shared.css'], - }) - - const dynamicCss = collectDynamicImportCss( - new Set([routeChunk]), - new Map([ - ['entry.js', entryChunk], - ['route.js', routeChunk], - ['lazy.js', lazyChunk], - ['shared.js', sharedChunk], - ]), - entryChunk, - ) - - expect(dynamicCss.has('shared.css')).toBe(true) + expect(() => + scanClientChunks(normalizeTestBuild({ 'posts.js': routeChunk })), + ).toThrow('No entry file found') }) }) describe('createManifestAssetResolvers + createChunkCssAssetCollector', () => { - test('reuses cached stylesheet assets and appends hash for dynamic css', () => { + test('reuses cached stylesheet links', () => { const entryChunk = makeChunk({ fileName: 'entry.js', imports: ['shared.js'], @@ -298,42 +198,24 @@ describe('createManifestAssetResolvers + createChunkCssAssetCollector', () => { importedCss: ['shared.css'], }) const chunksByFileName = new Map([ - ['entry.js', entryChunk], - ['shared.js', sharedChunk], + ['entry.js', normalizeTestChunk(entryChunk)], + ['shared.js', normalizeTestChunk(sharedChunk)], ]) - const resolvers = createManifestAssetResolvers({ - basePath: '/assets', - hashedCssFiles: new Set(['shared.css']), - }) - const cssAssetCollector = createChunkCssAssetCollector({ + const linkResolvers = createManifestAssetResolvers('/assets') + const cssLinkCollector = createChunkCssAssetCollector({ chunksByFileName, - getStylesheetAsset: resolvers.getStylesheetAsset, + getStylesheetLink: linkResolvers.getStylesheetLink, }) - const assets = cssAssetCollector.getChunkCssAssets(entryChunk) + const links = cssLinkCollector.getChunkCssAssets( + chunksByFileName.get('entry.js')!, + ) - expect(assets).toEqual([ - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/entry.css', - type: 'text/css', - }, - }, - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/shared.css#', - type: 'text/css', - }, - }, - ]) + expect(links).toEqual(['/assets/shared.css', '/assets/entry.css']) - expect(resolvers.getStylesheetAsset('shared.css')).toBe( - resolvers.getStylesheetAsset('shared.css'), + expect(linkResolvers.getStylesheetLink('shared.css')).toBe( + linkResolvers.getStylesheetLink('shared.css'), ) }) }) @@ -360,27 +242,26 @@ describe('createChunkCssAssetCollector', () => { importedCss: ['shared.css'], }) const chunksByFileName = new Map([ - ['a.js', chunkA], - ['b.js', chunkB], - ['c.js', chunkC], - ['shared.js', sharedChunk], + ['a.js', normalizeTestChunk(chunkA)], + ['b.js', normalizeTestChunk(chunkB)], + ['c.js', normalizeTestChunk(chunkC)], + ['shared.js', normalizeTestChunk(sharedChunk)], ]) const { getChunkCssAssets } = createChunkCssAssetCollector({ chunksByFileName, - getStylesheetAsset: (cssFile) => ({ - tag: 'link', - attrs: { rel: 'stylesheet', href: `/${cssFile}`, type: 'text/css' }, + getStylesheetLink: (cssFile) => ({ + href: `/${cssFile}`, }), }) - const assets = getChunkCssAssets(chunkA) + const links = getChunkCssAssets(chunksByFileName.get('a.js')!) - expect(assets.map((asset: any) => asset.attrs.href)).toEqual([ - '/a.css', - '/b.css', + expect(links.map(getManifestCssHref)).toEqual([ '/shared.css', + '/b.css', '/c.css', + '/a.css', ]) }) @@ -396,20 +277,19 @@ describe('createChunkCssAssetCollector', () => { importedCss: ['b.css'], }) const chunksByFileName = new Map([ - ['a.js', chunkA], - ['b.js', chunkB], + ['a.js', normalizeTestChunk(chunkA)], + ['b.js', normalizeTestChunk(chunkB)], ]) const { getChunkCssAssets } = createChunkCssAssetCollector({ chunksByFileName, - getStylesheetAsset: (cssFile) => ({ - tag: 'link', - attrs: { rel: 'stylesheet', href: `/${cssFile}`, type: 'text/css' }, + getStylesheetLink: (cssFile) => ({ + href: `/${cssFile}`, }), }) - const assets = getChunkCssAssets(chunkA) - const hrefs = assets.map((a: any) => a.attrs.href) + const links = getChunkCssAssets(chunksByFileName.get('a.js')!) + const hrefs = links.map(getManifestCssHref) expect(hrefs).toContain('/a.css') expect(hrefs).toContain('/b.css') @@ -418,7 +298,253 @@ describe('createChunkCssAssetCollector', () => { }) describe('buildStartManifest', () => { - test('dedupes route css gathered through overlapping chunk imports', () => { + test('skips inline CSS transforms when no relative URLs need rebasing', () => { + expect(shouldRebaseInlineCssUrls('.root {\n color: red;\n}')).toBe(false) + expect(shouldRebaseInlineCssUrls('.root{background:url(/dot.svg)}')).toBe( + false, + ) + expect( + shouldRebaseInlineCssUrls( + '.root{background:url(data:image/svg+xml,foo)}', + ), + ).toBe(false) + expect(shouldRebaseInlineCssUrls('.card{background:url(./dot.svg)}')).toBe( + true, + ) + expect(shouldRebaseInlineCssUrls('@import "../theme.css";')).toBe(true) + }) + + test('embeds rebased inline CSS content when enabled', () => { + const entryChunk = makeChunk({ + fileName: 'entry.js', + isEntry: true, + importedCss: ['root.css'], + }) + const routeChunk = makeChunk({ + fileName: 'dashboard.js', + importedCss: ['dashboard.css'], + moduleIds: ['/routes/dashboard.tsx?tsr-split=component'], + }) + + const manifest = buildStartManifest({ + clientBuild: normalizeTestBuild({ + 'entry.js': entryChunk, + 'dashboard.js': routeChunk, + 'root.css': makeCssAsset('root.css', '.root{color:red}'), + 'dashboard.css': makeCssAsset( + 'dashboard.css', + '.card{background:url("./dot.svg")}', + ), + }), + routeTreeRoutes: { + __root__: {}, + '/dashboard': { filePath: '/routes/dashboard.tsx' }, + }, + basePath: '/assets', + inlineCss: { enabled: true, transformAssets: false }, + }) + + expect(manifest.inlineCss?.styles['/assets/root.css']).toBe( + '.root{color:red}', + ) + expect(manifest.inlineCss?.styles['/assets/dashboard.css']).toBe( + '.card{background:url(/assets/dot.svg)}', + ) + }) + + test('emits inline CSS URL templates when transformAssets is enabled', () => { + const entryChunk = makeChunk({ + fileName: 'entry.js', + isEntry: true, + importedCss: ['root.css'], + }) + + const manifest = buildStartManifest({ + clientBuild: normalizeTestBuild({ + 'entry.js': entryChunk, + 'root.css': makeCssAsset( + 'root.css', + '@import "./theme.css" screen;.card{background:url("./dot.svg")} .skip{background:url(data:image/svg+xml,foo)}', + ), + }), + routeTreeRoutes: { + __root__: {}, + }, + basePath: '/assets', + inlineCss: { enabled: true, transformAssets: true }, + }) + + expect(manifest.inlineCss?.styles['/assets/root.css']).toBe( + '@import "/assets/theme.css" screen;.card{background:url("/assets/dot.svg")}.skip{background:url(data:image/svg+xml,foo)}', + ) + expect(manifest.inlineCss?.templates?.['/assets/root.css']).toEqual({ + strings: [ + '@import "', + '" screen;.card{background:url("', + '")}.skip{background:url(data:image/svg+xml,foo)}', + ], + urls: ['/assets/theme.css', '/assets/dot.svg'], + }) + }) + + test('throws when inline CSS content is missing for a stylesheet link', () => { + const entryChunk = makeChunk({ + fileName: 'entry.js', + isEntry: true, + importedCss: ['root.css'], + }) + + expect(() => + buildStartManifest({ + clientBuild: normalizeTestBuild({ + 'entry.js': entryChunk, + }), + routeTreeRoutes: { + __root__: {}, + }, + basePath: '/assets', + inlineCss: { enabled: true, transformAssets: false }, + }), + ).toThrow('could not find CSS content') + }) + + test('allows callers to attach additional route stylesheet links', () => { + const entryChunk = makeChunk({ + fileName: 'entry.js', + isEntry: true, + moduleIds: ['/src/entry.tsx'], + }) + + const linkResolvers = createManifestAssetResolvers('/assets') + + const manifest = buildStartManifest({ + clientBuild: normalizeViteClientBuild({ + 'entry.js': entryChunk, + }), + routeTreeRoutes: { + __root__: { children: ['/about'] } as any, + '/about': { filePath: '/routes/about.tsx' }, + }, + basePath: '/assets', + additionalRouteAssets: { + __root__: [linkResolvers.getStylesheetLink('style.css')], + }, + }) + + expect(manifest.routes.__root__!.css).toEqual([ + makeStylesheetLink('/assets/style.css'), + ]) + }) + + test('dedupes duplicate additional route scripts on the same route', () => { + const entryChunk = makeChunk({ + fileName: 'entry.js', + isEntry: true, + moduleIds: ['/src/entry.tsx'], + }) + const script = { + attrs: { + src: '/assets/custom.js', + type: 'module', + }, + } as const + + const manifest = buildStartManifest({ + clientBuild: normalizeViteClientBuild({ + 'entry.js': entryChunk, + }), + routeTreeRoutes: { + __root__: { children: ['/about'] } as any, + '/about': { filePath: '/routes/about.tsx' }, + }, + basePath: '/assets', + additionalRouteAssets: { + __root__: [script, script], + }, + }) + + expect(manifest.routes.__root__!.scripts).toEqual([ + script, + { + attrs: { + type: 'module', + async: true, + src: '/assets/entry.js', + }, + }, + ]) + }) + + test('dedupes additional route scripts already owned by ancestor routes', () => { + const entryChunk = makeChunk({ + fileName: 'entry.js', + isEntry: true, + moduleIds: ['/src/entry.tsx'], + }) + const script = { + attrs: { + src: '/assets/custom.js', + type: 'module', + }, + } as const + + const manifest = buildStartManifest({ + clientBuild: normalizeViteClientBuild({ + 'entry.js': entryChunk, + }), + routeTreeRoutes: { + __root__: { children: ['/about'] } as any, + '/about': { filePath: '/routes/about.tsx' }, + }, + basePath: '/assets', + additionalRouteAssets: { + __root__: [script], + '/about': [script], + }, + }) + + expect(manifest.routes.__root__!.scripts).toEqual([ + script, + { + attrs: { + type: 'module', + async: true, + src: '/assets/entry.js', + }, + }, + ]) + expect(manifest.routes['/about']?.scripts).toBeUndefined() + }) + + test('rejects additional route entries for unknown route ids', () => { + const entryChunk = makeChunk({ + fileName: 'entry.js', + isEntry: true, + moduleIds: ['/src/entry.tsx'], + }) + + const linkResolvers = createManifestAssetResolvers('/assets') + + expect(() => + buildStartManifest({ + clientBuild: normalizeViteClientBuild({ + 'entry.js': entryChunk, + }), + routeTreeRoutes: { + __root__: { children: ['/about'] } as any, + '/about': { filePath: '/routes/about.tsx' }, + }, + basePath: '/assets', + additionalRouteAssets: { + '/missing': [linkResolvers.getStylesheetLink('style.css')], + }, + }), + ).toThrow( + 'expected additionalRouteAssets routeId to exist in routeTreeRoutes: /missing', + ) + }) + + test('dedupes route CSS gathered through overlapping chunk imports', () => { const entryChunk = makeChunk({ fileName: 'entry.js', isEntry: true, @@ -444,13 +570,13 @@ describe('buildStartManifest', () => { }) const manifest = buildStartManifest({ - clientBundle: { + clientBuild: normalizeViteClientBuild({ 'entry.js': entryChunk, 'route.js': routeChunk, 'branch-a.js': branchAChunk, 'branch-b.js': branchBChunk, 'shared.js': sharedChunk, - }, + }), routeTreeRoutes: { __root__: { children: ['/about'] } as any, '/about': { filePath: '/routes/about.tsx' }, @@ -458,103 +584,272 @@ describe('buildStartManifest', () => { basePath: '/assets', }) - expect(manifest.routes['/about']!.assets).toEqual([ - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/branch-a.css', - type: 'text/css', - }, - }, - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/shared.css', - type: 'text/css', - }, - }, - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/branch-b.css', - type: 'text/css', - }, - }, + expect(manifest.routes['/about']!.css).toEqual([ + makeStylesheetLink('/assets/shared.css'), + makeStylesheetLink('/assets/branch-a.css'), + makeStylesheetLink('/assets/branch-b.css'), ]) }) - test('hashes css shared by route chunks and nested non-route dynamic imports', () => { + test('adds Hydrate chunk CSS without preloading deferred component JS by default', () => { const entryChunk = makeChunk({ fileName: 'entry.js', isEntry: true, - dynamicImports: ['route-lazy.js'], - importedCss: ['entry.css'], }) - const routeStaticChunk = makeChunk({ - fileName: 'route-static.js', - imports: ['widget.js'], - moduleIds: ['/routes/static.tsx?tsr-split=component'], - }) - const routeLazyChunk = makeChunk({ - fileName: 'route-lazy.js', - dynamicImports: ['widget-lazy.js'], - moduleIds: ['/routes/lazy.tsx?tsr-split=component'], + const routeChunk = makeChunk({ + fileName: 'about.js', + dynamicImports: ['about-widget.js'], + moduleIds: ['/routes/about.tsx?tsr-split=component'], }) const widgetChunk = makeChunk({ - fileName: 'widget.js', - importedCss: ['widget.css'], - }) - const widgetLazyChunk = makeChunk({ - fileName: 'widget-lazy.js', - imports: ['widget.js'], + fileName: 'about-widget.js', + importedCss: ['about-widget.css'], + moduleIds: ['/routes/about.tsx?tss-hydrate=about_widget'], }) const manifest = buildStartManifest({ - clientBundle: { + clientBuild: normalizeViteClientBuild({ 'entry.js': entryChunk, - 'route-static.js': routeStaticChunk, - 'route-lazy.js': routeLazyChunk, - 'widget.js': widgetChunk, - 'widget-lazy.js': widgetLazyChunk, - }, + 'about.js': routeChunk, + 'about-widget.js': widgetChunk, + }), routeTreeRoutes: { - __root__: { children: ['/static', '/lazy'] } as any, - '/static': { filePath: '/routes/static.tsx' }, - '/lazy': { filePath: '/routes/lazy.tsx' }, + __root__: { children: ['/about'] } as any, + '/about': { filePath: '/routes/about.tsx' }, }, basePath: '/assets', }) - expect(manifest.clientEntry).toBe('/assets/entry.js') - expect(manifest.routes.__root__!.assets).toEqual([ - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/entry.css', - type: 'text/css', - }, - }, + expect(manifest.routes['/about']!.css).toEqual([ + makeStylesheetLink('/assets/about-widget.css'), ]) - expect(manifest.routes['/static']!.assets).toEqual([ - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/widget.css#', - type: 'text/css', - }, + expect(manifest.routes['/about']!.preloads).toEqual(['/assets/about.js']) + }) + + test('adds nested Hydrate chunk CSS without preloading deferred component JS by default', () => { + const entryChunk = makeChunk({ + fileName: 'entry.js', + isEntry: true, + }) + const routeChunk = makeChunk({ + fileName: 'about.js', + dynamicImports: ['parent-widget.js'], + moduleIds: ['/routes/about.tsx?tsr-split=component'], + }) + const parentWidgetChunk = makeChunk({ + fileName: 'parent-widget.js', + dynamicImports: ['child-widget.js'], + importedCss: ['parent-widget.css'], + moduleIds: ['/routes/about.tsx?tss-hydrate=parent_widget'], + }) + const childWidgetChunk = makeChunk({ + fileName: 'child-widget.js', + importedCss: ['child-widget.css'], + moduleIds: ['/routes/about.tsx?tss-hydrate=child_widget'], + }) + + const manifest = buildStartManifest({ + clientBuild: normalizeViteClientBuild({ + 'entry.js': entryChunk, + 'about.js': routeChunk, + 'parent-widget.js': parentWidgetChunk, + 'child-widget.js': childWidgetChunk, + }), + routeTreeRoutes: { + __root__: { children: ['/about'] } as any, + '/about': { filePath: '/routes/about.tsx' }, }, + basePath: '/assets', + }) + + expect(manifest.routes['/about']!.css).toEqual([ + makeStylesheetLink('/assets/parent-widget.css'), + makeStylesheetLink('/assets/child-widget.css'), ]) - expect(manifest.routes['/lazy']!.preloads).toEqual([ - '/assets/route-lazy.js', + expect(manifest.routes['/about']!.preloads).toEqual(['/assets/about.js']) + }) + + test('adds shared component Hydrate CSS to every statically importing route', () => { + const entryChunk = makeChunk({ + fileName: 'entry.js', + isEntry: true, + }) + const aboutRouteChunk = makeChunk({ + fileName: 'about.js', + imports: ['shared-widget.js'], + moduleIds: ['/routes/about.tsx?tsr-split=component'], + }) + const postsRouteChunk = makeChunk({ + fileName: 'posts.js', + imports: ['shared-widget.js'], + moduleIds: ['/routes/posts.tsx?tsr-split=component'], + }) + const sharedWidgetChunk = makeChunk({ + fileName: 'shared-widget.js', + dynamicImports: ['shared-hydrate.js'], + }) + const sharedHydrateChunk = makeChunk({ + fileName: 'shared-hydrate.js', + importedCss: ['shared-hydrate.css'], + moduleIds: ['/components/Shared.tsx?tss-hydrate=shared_widget'], + }) + + const manifest = buildStartManifest({ + clientBuild: normalizeViteClientBuild({ + 'entry.js': entryChunk, + 'about.js': aboutRouteChunk, + 'posts.js': postsRouteChunk, + 'shared-widget.js': sharedWidgetChunk, + 'shared-hydrate.js': sharedHydrateChunk, + }), + routeTreeRoutes: { + __root__: { children: ['/about', '/posts'] } as any, + '/about': { filePath: '/routes/about.tsx' }, + '/posts': { filePath: '/routes/posts.tsx' }, + }, + basePath: '/assets', + }) + + const expectedLink = makeStylesheetLink('/assets/shared-hydrate.css') + expect(manifest.routes['/about']!.css).toEqual([expectedLink]) + expect(manifest.routes['/posts']!.css).toEqual([expectedLink]) + expect(manifest.routes['/about']!.preloads).toEqual([ + '/assets/about.js', + '/assets/shared-widget.js', + ]) + expect(manifest.routes['/posts']!.preloads).toEqual([ + '/assets/posts.js', + '/assets/shared-widget.js', ]) }) - test('dedupes route css already owned by ancestor routes', () => { + test('does not add unrelated Hydrate CSS from the global entry graph to root', () => { + const entryChunk = makeChunk({ + fileName: 'entry.js', + isEntry: true, + imports: ['app-shell.js'], + }) + const appShellChunk = makeChunk({ + fileName: 'app-shell.js', + dynamicImports: ['about-widget.js'], + }) + const aboutWidgetChunk = makeChunk({ + fileName: 'about-widget.js', + importedCss: ['about-widget.css'], + moduleIds: ['/routes/about.tsx?tss-hydrate=about_widget'], + }) + + const manifest = buildStartManifest({ + clientBuild: normalizeViteClientBuild({ + 'entry.js': entryChunk, + 'app-shell.js': appShellChunk, + 'about-widget.js': aboutWidgetChunk, + }), + routeTreeRoutes: { + __root__: { children: ['/about'] } as any, + '/about': { filePath: '/routes/about.tsx' }, + }, + basePath: '/assets', + }) + + expect(manifest.routes.__root__!.css).toBeUndefined() + expect(manifest.routes.__root__!.preloads).toEqual([ + '/assets/entry.js', + '/assets/app-shell.js', + ]) + }) + + test('adds root-owned Hydrate CSS without walking unrelated entry graph hydration', () => { + const entryChunk = makeChunk({ + fileName: 'entry.js', + isEntry: true, + imports: ['app-shell.js'], + }) + const rootChunk = makeChunk({ + fileName: 'root.js', + dynamicImports: ['root-widget.js'], + moduleIds: ['/routes/__root.tsx?tsr-split=component'], + }) + const rootWidgetChunk = makeChunk({ + fileName: 'root-widget.js', + importedCss: ['root-widget.css'], + moduleIds: ['/routes/__root.tsx?tss-hydrate=root_widget'], + }) + const appShellChunk = makeChunk({ + fileName: 'app-shell.js', + dynamicImports: ['about-widget.js'], + }) + const aboutWidgetChunk = makeChunk({ + fileName: 'about-widget.js', + importedCss: ['about-widget.css'], + moduleIds: ['/routes/about.tsx?tss-hydrate=about_widget'], + }) + + const manifest = buildStartManifest({ + clientBuild: normalizeViteClientBuild({ + 'entry.js': entryChunk, + 'root.js': rootChunk, + 'root-widget.js': rootWidgetChunk, + 'app-shell.js': appShellChunk, + 'about-widget.js': aboutWidgetChunk, + }), + routeTreeRoutes: { + __root__: { + filePath: '/routes/__root.tsx', + children: ['/about'], + } as any, + '/about': { filePath: '/routes/about.tsx' }, + }, + basePath: '/assets', + }) + + expect(manifest.routes.__root__!.css).toEqual([ + makeStylesheetLink('/assets/root-widget.css'), + ]) + expect(manifest.routes.__root__!.preloads).toEqual([ + '/assets/root.js', + '/assets/entry.js', + '/assets/app-shell.js', + ]) + }) + + test('orders imported chunk css before route chunk css', () => { + const entryChunk = makeChunk({ + fileName: 'entry.js', + isEntry: true, + }) + const routeChunk = makeChunk({ + fileName: 'field-detail-panel.js', + imports: ['tabs.js'], + importedCss: ['field-detail-panel.css'], + moduleIds: ['/routes/field-detail-panel.tsx?tsr-split=component'], + }) + const tabsChunk = makeChunk({ + fileName: 'tabs.js', + importedCss: ['tabs.css'], + }) + + const manifest = buildStartManifest({ + clientBuild: normalizeViteClientBuild({ + 'entry.js': entryChunk, + 'field-detail-panel.js': routeChunk, + 'tabs.js': tabsChunk, + }), + routeTreeRoutes: { + __root__: { children: ['/field-detail-panel'] } as any, + '/field-detail-panel': { + filePath: '/routes/field-detail-panel.tsx', + }, + }, + basePath: '/assets', + }) + + expect( + manifest.routes['/field-detail-panel']!.css!.map(getManifestCssHref), + ).toEqual(['/assets/tabs.css', '/assets/field-detail-panel.css']) + }) + + test('dedupes route CSS already owned by ancestor routes', () => { const entryChunk = makeChunk({ fileName: 'entry.js', isEntry: true, @@ -573,11 +868,11 @@ describe('buildStartManifest', () => { }) const manifest = buildStartManifest({ - clientBundle: { + clientBuild: normalizeViteClientBuild({ 'entry.js': entryChunk, 'shared.js': sharedChunk, 'about.js': aboutChunk, - }, + }), routeTreeRoutes: { __root__: { children: ['/about'] } as any, '/about': { filePath: '/routes/about.tsx' }, @@ -585,78 +880,192 @@ describe('buildStartManifest', () => { basePath: '/assets', }) - expect(manifest.routes.__root__!.assets).toEqual([ - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/main.css', - type: 'text/css', - }, - }, + expect(manifest.routes.__root__!.css).toEqual([ + makeStylesheetLink('/assets/main.css'), ]) - expect(manifest.routes['/about']!.assets).toEqual([ - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/about.css', - type: 'text/css', - }, - }, + expect(manifest.routes['/about']!.css).toEqual([ + makeStylesheetLink('/assets/about.css'), ]) }) - test('adds hash only when css is shared by router-managed and non-route dynamic imports', () => { + test('serializeStartManifest preserves shared link identity across routes', () => { + const sharedLink = { + href: '/assets/shared.css', + crossOrigin: 'anonymous', + } satisfies ManifestCssLink + const manifest: StartManifest = { + routes: { + __root__: { + children: ['/a', '/b', '/c'], + }, + '/a': { + css: [sharedLink], + preloads: ['/assets/a.js'], + }, + '/b': { + css: [sharedLink], + preloads: ['/assets/b.js'], + }, + '/c': { + css: [sharedLink], + preloads: ['/assets/c.js'], + }, + }, + } + + const evaluated = deserializeSerializedManifest( + serializeStartManifest(manifest), + ) + + const aLink = evaluated.routes['/a']?.css?.[0] + const bLink = evaluated.routes['/b']?.css?.[0] + const cLink = evaluated.routes['/c']?.css?.[0] + + expect(aLink).toBeDefined() + expect(aLink).toBe(bLink) + expect(bLink).toBe(cLink) + }) + + test('serializeStartManifest preserves non-link fields unchanged', () => { + const manifest: StartManifest = { + routes: { + __root__: { + children: ['/posts'], + preloads: ['/assets/root.js'], + }, + '/posts': { + filePath: '/routes/posts.tsx', + children: ['/posts/$postId'], + preloads: ['/assets/posts.js'], + scripts: [ + { + attrs: { + src: '/assets/posts.js', + type: 'module', + }, + children: 'console.log("posts")', + }, + ], + }, + }, + } + + expect( + deserializeSerializedManifest(serializeStartManifest(manifest)), + ).toEqual(manifest) + }) + + test('serializeStartManifest handles manifests without route links', () => { + const manifest: StartManifest = { + routes: { + __root__: { + children: ['/posts'], + preloads: ['/assets/root.js'], + }, + '/posts': { + filePath: '/routes/posts.tsx', + preloads: ['/assets/posts.js'], + }, + }, + } + + expect( + deserializeSerializedManifest(serializeStartManifest(manifest)), + ).toEqual(manifest) + }) + + test('buildStartManifest includes scriptFormat only for iife output', () => { const entryChunk = makeChunk({ fileName: 'entry.js', isEntry: true, - dynamicImports: ['global-lazy.js'], - }) - const routeChunk = makeChunk({ - fileName: 'route.js', - imports: ['shared.js'], - moduleIds: ['/routes/about.tsx?tsr-split=component'], - }) - const sharedChunk = makeChunk({ - fileName: 'shared.js', - importedCss: ['shared.css'], - }) - const globalLazyChunk = makeChunk({ - fileName: 'global-lazy.js', - imports: ['shared.js'], }) + const routeTreeRoutes = { + __root__: { + filePath: '/routes/__root.tsx', + }, + } - const manifest = buildStartManifest({ - clientBundle: { + expect( + buildStartManifest({ + clientBuild: normalizeTestBuild({ 'entry.js': entryChunk }), + routeTreeRoutes, + basePath: '/assets', + scriptFormat: 'module', + }).scriptFormat, + ).toBeUndefined() + + expect( + buildStartManifest({ + clientBuild: normalizeTestBuild({ 'entry.js': entryChunk }), + routeTreeRoutes, + basePath: '/assets', + scriptFormat: 'iife', + }).scriptFormat, + ).toBe('iife') + }) + + test('buildStartManifest emits client entry assets as root route scripts', () => { + const entryChunk = makeChunk({ + fileName: 'entry.js', + isEntry: true, + imports: ['runtime.js', 'vendor.js'], + }) + const runtimeChunk = makeChunk({ fileName: 'runtime.js' }) + const vendorChunk = makeChunk({ fileName: 'vendor.js' }) + const routeTreeRoutes = { + __root__: { + filePath: '/routes/__root.tsx', + }, + } + + const moduleManifest = buildStartManifest({ + clientBuild: normalizeTestBuild({ 'entry.js': entryChunk, - 'route.js': routeChunk, - 'shared.js': sharedChunk, - 'global-lazy.js': globalLazyChunk, - }, - routeTreeRoutes: { - __root__: { children: ['/about'] } as any, - '/about': { filePath: '/routes/about.tsx' }, - }, + 'runtime.js': runtimeChunk, + 'vendor.js': vendorChunk, + }), + routeTreeRoutes, basePath: '/assets', + scriptFormat: 'module', }) - expect(manifest.routes['/about']!.assets).toEqual([ + expect(moduleManifest.routes.__root__?.scripts).toEqual([ { - tag: 'link', attrs: { - rel: 'stylesheet', - href: '/assets/shared.css#', - type: 'text/css', + type: 'module', + async: true, + src: '/assets/entry.js', }, }, ]) + + const iifeManifest = buildStartManifest({ + clientBuild: normalizeTestBuild({ + 'entry.js': entryChunk, + 'runtime.js': runtimeChunk, + 'vendor.js': vendorChunk, + }), + routeTreeRoutes, + basePath: '/assets', + scriptFormat: 'iife', + }) + + expect(iifeManifest.routes.__root__?.preloads).toEqual([ + '/assets/entry.js', + '/assets/runtime.js', + '/assets/vendor.js', + ]) + expect(iifeManifest.routes.__root__?.scripts).toEqual([ + { attrs: { async: true, src: '/assets/runtime.js' } }, + { attrs: { async: true, src: '/assets/vendor.js' } }, + { attrs: { async: true, src: '/assets/entry.js' } }, + ]) }) }) describe('route tree dedupe in buildStartManifest', () => { - test('dedupes assets and preloads only along the active ancestor path', () => { + test('dedupes stylesheet links and preloads only along the active ancestor path', () => { const entryChunk = makeChunk({ fileName: 'entry.js', isEntry: true, @@ -696,7 +1105,7 @@ describe('route tree dedupe in buildStartManifest', () => { }) const manifest = buildStartManifest({ - clientBundle: { + clientBuild: normalizeViteClientBuild({ 'entry.js': entryChunk, 'root-shared.js': rootSharedChunk, 'parent.js': parentChunk, @@ -705,7 +1114,7 @@ describe('route tree dedupe in buildStartManifest', () => { 'child-only.js': childOnlyChunk, 'sibling.js': siblingChunk, 'sibling-only.js': siblingOnlyChunk, - }, + }), routeTreeRoutes: { __root__: { children: ['/parent', '/sibling'] } as any, '/parent': { filePath: '/routes/parent.tsx', children: ['/child'] }, @@ -715,65 +1124,30 @@ describe('route tree dedupe in buildStartManifest', () => { basePath: '/assets', }) - expect(manifest.routes.__root__!.assets).toEqual([ - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/root.css', - type: 'text/css', - }, - }, - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/shared.css', - type: 'text/css', - }, - }, + expect(manifest.routes.__root__!.css).toEqual([ + makeStylesheetLink('/assets/shared.css'), + makeStylesheetLink('/assets/root.css'), ]) expect(manifest.routes.__root__!.preloads).toEqual([ '/assets/entry.js', '/assets/root-shared.js', ]) - expect(manifest.routes['/parent']!.assets).toEqual([ - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/parent.css', - type: 'text/css', - }, - }, + expect(manifest.routes['/parent']!.css).toEqual([ + makeStylesheetLink('/assets/parent.css'), ]) expect(manifest.routes['/parent']!.preloads).toEqual([ '/assets/parent.js', '/assets/parent-only.js', ]) - expect(manifest.routes['/child']!.assets).toEqual([ - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/child.css', - type: 'text/css', - }, - }, + expect(manifest.routes['/child']!.css).toEqual([ + makeStylesheetLink('/assets/child.css'), ]) expect(manifest.routes['/child']!.preloads).toEqual([ '/assets/child.js', '/assets/child-only.js', ]) - expect(manifest.routes['/sibling']!.assets).toEqual([ - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/sibling.css', - type: 'text/css', - }, - }, + expect(manifest.routes['/sibling']!.css).toEqual([ + makeStylesheetLink('/assets/sibling.css'), ]) expect(manifest.routes['/sibling']!.preloads).toEqual([ '/assets/sibling.js', @@ -814,7 +1188,7 @@ describe('route tree dedupe in buildStartManifest', () => { }) const manifest = buildStartManifest({ - clientBundle: { + clientBuild: normalizeViteClientBuild({ 'entry.js': entryChunk, 'deep.js': deepChunk, 'a.js': aChunk, @@ -822,7 +1196,7 @@ describe('route tree dedupe in buildStartManifest', () => { 'b.js': bChunk, 'b-child.js': bChildChunk, 'b-child-only.js': bChildOnlyChunk, - }, + }), routeTreeRoutes: { __root__: { children: ['/a', '/b'] } as any, '/a': { filePath: '/routes/a.tsx', children: ['/a-child'] }, @@ -833,37 +1207,16 @@ describe('route tree dedupe in buildStartManifest', () => { basePath: '/assets', }) - expect(manifest.routes['/a-child']!.assets).toEqual([ - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/deep.css', - type: 'text/css', - }, - }, + expect(manifest.routes['/a-child']!.css).toEqual([ + makeStylesheetLink('/assets/deep.css'), ]) expect(manifest.routes['/a-child']!.preloads).toEqual([ '/assets/a-child.js', '/assets/deep.js', ]) - expect(manifest.routes['/b-child']!.assets).toEqual([ - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/deep.css', - type: 'text/css', - }, - }, - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/b-child.css', - type: 'text/css', - }, - }, + expect(manifest.routes['/b-child']!.css).toEqual([ + makeStylesheetLink('/assets/deep.css'), + makeStylesheetLink('/assets/b-child.css'), ]) expect(manifest.routes['/b-child']!.preloads).toEqual([ '/assets/b-child.js', @@ -917,7 +1270,7 @@ describe('route tree dedupe in buildStartManifest', () => { }) const manifest = buildStartManifest({ - clientBundle: { + clientBuild: normalizeViteClientBuild({ 'entry.js': entryChunk, 'shared-root.js': sharedRootChunk, 'level-one.js': levelOneChunk, @@ -926,7 +1279,7 @@ describe('route tree dedupe in buildStartManifest', () => { 'level-two-only.js': levelTwoOnlyChunk, 'level-three.js': levelThreeChunk, 'level-three-only.js': levelThreeOnlyChunk, - }, + }), routeTreeRoutes: { __root__: { children: ['/level-one'] } as any, '/level-one': { @@ -942,65 +1295,30 @@ describe('route tree dedupe in buildStartManifest', () => { basePath: '/assets', }) - expect(manifest.routes.__root__!.assets).toEqual([ - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/root.css', - type: 'text/css', - }, - }, - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/shared-root.css', - type: 'text/css', - }, - }, + expect(manifest.routes.__root__!.css).toEqual([ + makeStylesheetLink('/assets/shared-root.css'), + makeStylesheetLink('/assets/root.css'), ]) expect(manifest.routes.__root__!.preloads).toEqual([ '/assets/entry.js', '/assets/shared-root.js', ]) - expect(manifest.routes['/level-one']!.assets).toEqual([ - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/level-one.css', - type: 'text/css', - }, - }, + expect(manifest.routes['/level-one']!.css).toEqual([ + makeStylesheetLink('/assets/level-one.css'), ]) expect(manifest.routes['/level-one']!.preloads).toEqual([ '/assets/level-one.js', '/assets/level-one-only.js', ]) - expect(manifest.routes['/level-two']!.assets).toEqual([ - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/level-two.css', - type: 'text/css', - }, - }, + expect(manifest.routes['/level-two']!.css).toEqual([ + makeStylesheetLink('/assets/level-two.css'), ]) expect(manifest.routes['/level-two']!.preloads).toEqual([ '/assets/level-two.js', '/assets/level-two-only.js', ]) - expect(manifest.routes['/level-three']!.assets).toEqual([ - { - tag: 'link', - attrs: { - rel: 'stylesheet', - href: '/assets/level-three.css', - type: 'text/css', - }, - }, + expect(manifest.routes['/level-three']!.css).toEqual([ + makeStylesheetLink('/assets/level-three.css'), ]) expect(manifest.routes['/level-three']!.preloads).toEqual([ '/assets/level-three.js', @@ -1016,7 +1334,7 @@ describe('route tree dedupe in buildStartManifest', () => { expect(() => buildStartManifest({ - clientBundle: { 'entry.js': entryChunk }, + clientBuild: normalizeViteClientBuild({ 'entry.js': entryChunk }), routeTreeRoutes: { __root__: { filePath: '/routes/__root.tsx', children: ['/about'] }, '/about': {} as any, @@ -1035,7 +1353,7 @@ describe('route tree dedupe in buildStartManifest', () => { expect(() => buildStartManifest({ - clientBundle: { 'entry.js': entryChunk }, + clientBuild: normalizeViteClientBuild({ 'entry.js': entryChunk }), routeTreeRoutes: { __root__: { children: ['/about'] } as any, }, @@ -1075,13 +1393,13 @@ describe('multi-chunk routes must merge assets and preloads', () => { }) const manifest = buildStartManifest({ - clientBundle: { + clientBuild: normalizeViteClientBuild({ 'entry.js': entryChunk, 'posts-component.js': componentChunk, 'posts-loader.js': loaderChunk, 'component-styles.js': componentStylesChunk, 'loader-dep.js': loaderDepChunk, - }, + }), routeTreeRoutes: { __root__: { children: ['/posts'] } as any, '/posts': { filePath: '/routes/posts.tsx' }, @@ -1092,7 +1410,7 @@ describe('multi-chunk routes must merge assets and preloads', () => { const postsRoute = manifest.routes['/posts']! // Both chunks' CSS should be present - const cssHrefs = postsRoute.assets!.map((a: any) => a.attrs.href) + const cssHrefs = postsRoute.css!.map(getManifestCssHref) expect(cssHrefs).toContain('/assets/component.css') expect(cssHrefs).toContain('/assets/loader.css') @@ -1125,12 +1443,12 @@ describe('multi-chunk routes must merge assets and preloads', () => { }) const manifest = buildStartManifest({ - clientBundle: { + clientBuild: normalizeViteClientBuild({ 'entry.js': entryChunk, 'shared-dep.js': sharedDep, 'posts-component.js': componentChunk, 'posts-loader.js': loaderChunk, - }, + }), routeTreeRoutes: { __root__: { children: ['/posts'] } as any, '/posts': { filePath: '/routes/posts.tsx' }, @@ -1139,7 +1457,7 @@ describe('multi-chunk routes must merge assets and preloads', () => { }) const postsRoute = manifest.routes['/posts']! - const cssHrefs = postsRoute.assets!.map((a: any) => a.attrs.href) + const cssHrefs = postsRoute.css!.map(getManifestCssHref) const preloadHrefs = postsRoute.preloads! expect( @@ -1151,53 +1469,8 @@ describe('multi-chunk routes must merge assets and preloads', () => { }) }) -describe('entry chunk dynamic imports must be scanned for dynamic CSS', () => { - test('CSS behind entry chunk dynamic import gets # suffix', () => { - // Entry chunk dynamically imports a chunk with CSS, - // but no route entry chunk references that dynamic import - const entryChunk = makeChunk({ - fileName: 'entry.js', - isEntry: true, - dynamicImports: ['global-lazy.js'], - importedCss: ['entry.css'], - }) - const globalLazyChunk = makeChunk({ - fileName: 'global-lazy.js', - importedCss: ['global-lazy.css'], - }) - // A route that statically imports the same CSS chunk - const routeChunk = makeChunk({ - fileName: 'route.js', - imports: ['global-lazy.js'], - moduleIds: ['/routes/home.tsx?tsr-split=component'], - }) - - const manifest = buildStartManifest({ - clientBundle: { - 'entry.js': entryChunk, - 'global-lazy.js': globalLazyChunk, - 'route.js': routeChunk, - }, - routeTreeRoutes: { - __root__: { children: ['/home'] } as any, - '/home': { filePath: '/routes/home.tsx' }, - }, - basePath: '/assets', - }) - - // global-lazy.css is reachable through both the router-managed route - // and the entry chunk's non-route dynamic import, so it should have # - const homeAssets = manifest.routes['/home']!.assets! - const globalLazyCss = homeAssets.find((a: any) => - a.attrs.href.includes('global-lazy.css'), - ) as any - expect(globalLazyCss).toBeDefined() - expect(globalLazyCss.attrs.href).toBe('/assets/global-lazy.css#') - }) -}) - describe('buildStartManifest route pruning', () => { - test('routes with no assets or preloads are pruned from returned manifest', () => { + test('routes with no manifest data are pruned from returned manifest', () => { const entryChunk = makeChunk({ fileName: 'entry.js', isEntry: true, @@ -1205,9 +1478,9 @@ describe('buildStartManifest route pruning', () => { }) const manifest = buildStartManifest({ - clientBundle: { + clientBuild: normalizeViteClientBuild({ 'entry.js': entryChunk, - }, + }), routeTreeRoutes: { __root__: { children: ['/about'] } as any, '/about': { filePath: '/routes/about.tsx' }, @@ -1215,7 +1488,7 @@ describe('buildStartManifest route pruning', () => { basePath: '/assets', }) - // /about has no matching chunks, so no assets or preloads. + // /about has no matching chunks, so no manifest data. // It should be pruned from the manifest. expect(manifest.routes['/about']).toBeUndefined() }) diff --git a/packages/start-plugin-core/tests/utils.test.ts b/packages/start-plugin-core/tests/utils.test.ts new file mode 100644 index 0000000000..0b05da53a6 --- /dev/null +++ b/packages/start-plugin-core/tests/utils.test.ts @@ -0,0 +1,51 @@ +import { afterEach, describe, expect, test, vi } from 'vitest' + +const originalPlatform = Object.getOwnPropertyDescriptor(process, 'platform') + +async function importUtilsWithPlatform(platform: NodeJS.Platform) { + vi.resetModules() + Object.defineProperty(process, 'platform', { + ...originalPlatform, + value: platform, + }) + + return await import('../src/utils') +} + +afterEach(() => { + vi.resetModules() + if (originalPlatform) { + Object.defineProperty(process, 'platform', originalPlatform) + } +}) + +describe('normalizePath', () => { + test('normalizes POSIX path segments on POSIX platforms', async () => { + const { normalizePath } = await importUtilsWithPlatform('linux') + + expect(normalizePath('/app//src/../routes/index.tsx')).toBe( + '/app/routes/index.tsx', + ) + }) + + test('normalizes empty paths like path.posix.normalize', async () => { + const { normalizePath } = await importUtilsWithPlatform('linux') + + expect(normalizePath('')).toBe('.') + }) + + test('keeps Windows separators as normal characters on POSIX platforms', async () => { + const { normalizePath } = await importUtilsWithPlatform('linux') + const input = String.raw`C:\app\src\..\routes\index.tsx` + + expect(normalizePath(input)).toBe(input) + }) + + test('converts Windows separators before POSIX normalization on Windows', async () => { + const { normalizePath } = await importUtilsWithPlatform('win32') + + expect(normalizePath(String.raw`C:\app\src\..\routes\index.tsx`)).toBe( + 'C:/app/routes/index.tsx', + ) + }) +}) diff --git a/packages/start-plugin-core/tests/vite/start-compiler-utils.test.ts b/packages/start-plugin-core/tests/vite/start-compiler-utils.test.ts new file mode 100644 index 0000000000..bf028a483e --- /dev/null +++ b/packages/start-plugin-core/tests/vite/start-compiler-utils.test.ts @@ -0,0 +1,71 @@ +import { describe, expect, test } from 'vitest' +import { + createViteDevServerFnModuleSpecifierEncoder, + decodeViteDevServerModuleSpecifier, +} from '../../src/vite/start-compiler-plugin/module-specifier' +import { mergeHotUpdateModules } from '../../src/vite/start-compiler-plugin/hot-update' +import type { EnvironmentModuleNode } from 'vite' + +describe('Vite dev server module specifiers', () => { + test('encodes app files as root-relative dev server paths', () => { + const encode = createViteDevServerFnModuleSpecifierEncoder('/repo/app') + + const specifier = encode({ + extractedFilename: '/repo/app/src/routes/index.tsx', + root: '/repo/app', + }) + + expect(specifier).toBe('/src/routes/index.tsx') + expect(decodeViteDevServerModuleSpecifier(specifier)).toBe( + 'src/routes/index.tsx', + ) + }) + + test('preserves POSIX absolute /@fs paths outside the app root', () => { + const encode = createViteDevServerFnModuleSpecifierEncoder('/repo/app') + + const specifier = encode({ + extractedFilename: '/repo/shared/server-fn.ts', + root: '/repo/app', + }) + + expect(specifier).toBe('/@fs/repo/shared/server-fn.ts') + expect(decodeViteDevServerModuleSpecifier(`${specifier}?x=1`)).toBe( + '/repo/shared/server-fn.ts', + ) + }) + + test('preserves Windows drive-letter /@fs paths', () => { + const encode = createViteDevServerFnModuleSpecifierEncoder('C:/repo/app') + + const specifier = encode({ + extractedFilename: 'D:/repo/shared/server-fn.ts', + root: 'C:/repo/app', + }) + + expect(specifier).toBe('/@fs/D:/repo/shared/server-fn.ts') + expect(decodeViteDevServerModuleSpecifier(`${specifier}?x=1`)).toBe( + 'D:/repo/shared/server-fn.ts', + ) + }) +}) + +describe('mergeHotUpdateModules', () => { + test('returns undefined when no extra modules were added', () => { + const current = [{ id: '/src/route.tsx' }] as Array + + expect(mergeHotUpdateModules(current, [])).toBeUndefined() + }) + + test('keeps native Vite modules and appends extra modules without duplicates', () => { + const route = { id: '/src/route.tsx' } as EnvironmentModuleNode + const provider = { + id: '/src/route.tsx?tss-serverfn-split', + } as EnvironmentModuleNode + + expect(mergeHotUpdateModules([route], [route, provider])).toEqual([ + route, + provider, + ]) + }) +}) diff --git a/packages/start-plugin-core/tsconfig.json b/packages/start-plugin-core/tsconfig.json index 208df9326c..1656d691d4 100644 --- a/packages/start-plugin-core/tsconfig.json +++ b/packages/start-plugin-core/tsconfig.json @@ -1,7 +1,11 @@ { "extends": "../../tsconfig.json", "include": ["src", "vite.config.ts", "tests"], - "exclude": ["tests/**/test-files/**", "tests/**/snapshots/**"], + "exclude": [ + "tests/**/error-files/**", + "tests/**/test-files/**", + "tests/**/snapshots/**" + ], "compilerOptions": { "target": "esnext", "noEmit": true, diff --git a/packages/start-plugin-core/vite.config.ts b/packages/start-plugin-core/vite.config.ts index aca8907af4..fc76204069 100644 --- a/packages/start-plugin-core/vite.config.ts +++ b/packages/start-plugin-core/vite.config.ts @@ -15,7 +15,14 @@ export default mergeConfig( config, tanstackViteConfig({ tsconfigPath: './tsconfig.build.json', - entry: './src/index.ts', + entry: [ + './src/index.ts', + './src/utils.ts', + './src/vite/index.ts', + './src/rsbuild/index.ts', + './src/rsbuild/types.ts', + './src/rsbuild/start-compiler-metadata-loader.ts', + ], srcDir: './src', outDir: './dist', cjs: false, diff --git a/packages/start-server-core/CHANGELOG.md b/packages/start-server-core/CHANGELOG.md index a4d2f07ff4..75c50137c8 100644 --- a/packages/start-server-core/CHANGELOG.md +++ b/packages/start-server-core/CHANGELOG.md @@ -1,5 +1,328 @@ # @tanstack/start-server-core +## 1.169.8 + +### Patch Changes + +- [#7509](https://github.com/TanStack/router/pull/7509) [`9cb7a00`](https://github.com/TanStack/router/commit/9cb7a003e6e5fa3706711870c7b10a5266356e3b) - feat(rsbuild): add RSC support + +## 1.169.7 + +### Patch Changes + +- Updated dependencies [[`2f53749`](https://github.com/TanStack/router/commit/2f5374945e2138559a51464f45a5152eae67e1dd)]: + - @tanstack/router-core@1.171.8 + - @tanstack/start-client-core@1.170.6 + - @tanstack/start-storage-context@1.167.10 + +## 1.169.6 + +### Patch Changes + +- [#7497](https://github.com/TanStack/router/pull/7497) [`d1997b6`](https://github.com/TanStack/router/commit/d1997b66d7c24c1d64772bb8bab5caf9c6d9cc48) - fix streaming + +- Updated dependencies [[`d1997b6`](https://github.com/TanStack/router/commit/d1997b66d7c24c1d64772bb8bab5caf9c6d9cc48)]: + - @tanstack/router-core@1.171.7 + - @tanstack/start-client-core@1.170.5 + - @tanstack/start-storage-context@1.167.9 + +## 1.169.5 + +### Patch Changes + +- [#7501](https://github.com/TanStack/router/pull/7501) [`9c09bca`](https://github.com/TanStack/router/commit/9c09bca59e9613e9a6fd9b7149b0737898e705d6) - fix(start): emit client entry scripts from the root route manifest. When `scriptFormat: 'iife'` and the entry chunk has static-import siblings (e.g. an extracted runtime via `optimization.runtimeChunk: 'single'`), the manifest now includes those async siblings before the async client entry in root route scripts, fixing hydration for IIFE bundles with extracted runtimes. + +## 1.169.4 + +### Patch Changes + +- Fix serialization adapter module resolution in TanStack Start. Vite dev now uses clean runtime-specific virtual module IDs instead of browser requests containing encoded null-byte virtual IDs, which avoids reverse proxy failures. When no serialization adapters are configured, Vite and Rsbuild now resolve `#tanstack-start-plugin-adapters` through the package empty-adapter fallback. ([#7484](https://github.com/TanStack/router/pull/7484)) + +- Publish matching TanStack Start dev server packages so fresh installs do not pair a Start plugin that no longer provides `tanstack-start-injected-head-scripts:v` with an older Start server runtime that still imports it. ([#7487](https://github.com/TanStack/router/pull/7487)) + +- Updated dependencies [[`a82cec6`](https://github.com/TanStack/router/commit/a82cec69474c366b36efdb3f43c4efe8311c485a)]: + - @tanstack/start-client-core@1.170.4 + +## 1.169.3 + +### Patch Changes + +- Add support for Rsbuild client output formats, including module output by default and IIFE output for classic script environments. ([#7477](https://github.com/TanStack/router/pull/7477)) + + Client entry scripts and preloads are now represented as root route manifest assets, script preloads follow the manifest script format, and script asset cross-origin configuration uses the `script` key. The `transformAssets` script callback context now exposes only `kind: 'script'` and `url`, keeping script format handling internal to manifest rendering. + +- Updated dependencies [[`51a97a1`](https://github.com/TanStack/router/commit/51a97a167fb3ef1b8ca70fbb63db635158f43509)]: + - @tanstack/router-core@1.171.6 + - @tanstack/start-client-core@1.170.3 + - @tanstack/start-storage-context@1.167.8 + +## 1.169.2 + +### Patch Changes + +- Updated dependencies [[`5268ba4`](https://github.com/TanStack/router/commit/5268ba4566233ea58880df85f167ad0401a93a46)]: + - @tanstack/router-core@1.171.5 + - @tanstack/start-client-core@1.170.2 + - @tanstack/start-storage-context@1.167.7 + +## 1.169.1 + +### Patch Changes + +- Updated dependencies [[`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960), [`0300f87`](https://github.com/TanStack/router/commit/0300f87ec5a7f878ffbe0b181acf84cba9139960)]: + - @tanstack/router-core@1.171.4 + - @tanstack/start-client-core@1.170.1 + - @tanstack/start-storage-context@1.167.6 + +## 1.169.0 + +### Minor Changes + +- Add deferred Hydrate boundary support for TanStack Start. ([#7362](https://github.com/TanStack/router/pull/7362)) + + Hydrate boundaries can now be code-split by the Start compiler, preload their generated client chunks, preserve server-rendered fallback HTML, and replay interaction-triggered events after hydration. The compiler integration now uses a Start-owned compiler plugin for Hydrate virtual modules across Vite and Rsbuild, with dev invalidation for generated virtual modules. + + Shared AST utilities used by the router code-splitter and Hydrate virtual modules were moved into `@tanstack/router-utils` so both pipelines can retain referenced top-level declarations, unwrap local exports, and let dead-code elimination remove unused route module code. + +### Patch Changes + +- Updated dependencies [[`5fa9e55`](https://github.com/TanStack/router/commit/5fa9e555f3a2edb5e45586623e6bcbfa7f7c7a6b)]: + - @tanstack/start-client-core@1.170.0 + - @tanstack/router-core@1.171.3 + - @tanstack/start-storage-context@1.167.5 + +## 1.168.4 + +### Patch Changes + +- Updated dependencies [[`b60eb36`](https://github.com/TanStack/router/commit/b60eb36e59e8a468ee0742cbcf7f47aca1ff1c67)]: + - @tanstack/router-core@1.171.2 + - @tanstack/start-client-core@1.169.4 + - @tanstack/start-storage-context@1.167.4 + +## 1.168.3 + +### Patch Changes + +- Updated dependencies [[`d9cf933`](https://github.com/TanStack/router/commit/d9cf9331b83fcbd2abfee75d839d862f9bb18e6b)]: + - @tanstack/router-core@1.171.1 + - @tanstack/start-client-core@1.169.3 + - @tanstack/start-storage-context@1.167.3 + +## 1.168.2 + +### Patch Changes + +- Updated dependencies [[`d533f87`](https://github.com/TanStack/router/commit/d533f87976704098a40b48f160b37c28c8182806)]: + - @tanstack/router-core@1.171.0 + - @tanstack/start-client-core@1.169.2 + - @tanstack/start-storage-context@1.167.2 + +## 1.168.1 + +### Patch Changes + +- Add runtime-configurable inline CSS and opt-in CSS URL templates for transformAssets. ([#7380](https://github.com/TanStack/router/pull/7380)) + +- Updated dependencies [[`2387a2e`](https://github.com/TanStack/router/commit/2387a2eea0683004cc400b9f71bed5944eb60110)]: + - @tanstack/router-core@1.170.1 + - @tanstack/start-client-core@1.169.1 + - @tanstack/start-storage-context@1.167.1 + +## 1.168.0 + +### Minor Changes + +- Clean minor bump, fresh start ([#7395](https://github.com/TanStack/router/pull/7395)) + +### Patch Changes + +- add createCsrfMiddleware based on Sec-Fetch-Site header, auto-apply to unconfigured servers, warn for others ([#7373](https://github.com/TanStack/router/pull/7373)) + +- Updated dependencies [[`b1c061a`](https://github.com/TanStack/router/commit/b1c061aff9185cdf5fdc08c0136382a9dce0302f), [`201e150`](https://github.com/TanStack/router/commit/201e150bd1412bae2faa9ce53f0fefcb7574ac14)]: + - @tanstack/router-core@1.170.0 + - @tanstack/history@1.162.0 + - @tanstack/start-client-core@1.169.0 + - @tanstack/start-storage-context@1.167.0 + +## 1.167.30 + +### Patch Changes + +- Update seroval dependencies to version 1.5.4. ([#7340](https://github.com/TanStack/router/pull/7340)) + +- Updated dependencies [[`35e88f0`](https://github.com/TanStack/router/commit/35e88f04996d71019a1868b7b06ecb4ddbc9df9e)]: + - @tanstack/router-core@1.169.2 + - @tanstack/start-client-core@1.168.2 + - @tanstack/start-storage-context@1.166.35 + +## 1.167.29 + +### Patch Changes + +- fix(start-server-core): fall back HEAD requests to GET then ANY per RFC 9110 §9.3.2 ([#7325](https://github.com/TanStack/router/pull/7325)) + +## 1.167.28 + +### Patch Changes + +- Add opt-in Start response Link headers for collected Early Hints. ([#7327](https://github.com/TanStack/router/pull/7327)) + +## 1.167.27 + +### Patch Changes + +- Add experimental HTTP 103 Early Hints support to Start server handlers. ([#7324](https://github.com/TanStack/router/pull/7324)) + +## 1.167.26 + +### Patch Changes + +- Updated dependencies [[`4a1e63f`](https://github.com/TanStack/router/commit/4a1e63f1d1230b1ed8234609acad4639d8982c13)]: + - @tanstack/router-core@1.169.1 + - @tanstack/start-client-core@1.168.1 + - @tanstack/start-storage-context@1.166.34 + +## 1.167.25 + +### Patch Changes + +- Updated dependencies [[`82b0613`](https://github.com/TanStack/router/commit/82b06132af776f74603ab27977cc277d6219a845)]: + - @tanstack/start-client-core@1.168.0 + +## 1.167.24 + +### Patch Changes + +- Updated dependencies [[`c992495`](https://github.com/TanStack/router/commit/c992495bf4010ff4c3597bb1f3b1ba02594e857e)]: + - @tanstack/router-core@1.169.0 + - @tanstack/start-client-core@1.167.22 + - @tanstack/start-storage-context@1.166.33 + +## 1.167.23 + +### Patch Changes + +- Updated dependencies [[`b5c4183`](https://github.com/TanStack/router/commit/b5c4183ab8b44be8a75647b7f7b588ad7c146ece)]: + - @tanstack/router-core@1.168.18 + - @tanstack/start-client-core@1.167.21 + - @tanstack/start-storage-context@1.166.32 + +## 1.167.22 + +### Patch Changes + +- Updated dependencies [[`493148b`](https://github.com/TanStack/router/commit/493148bc5378b7f9de1544d87f6aaa425c12eb34)]: + - @tanstack/router-core@1.168.17 + - @tanstack/start-client-core@1.167.20 + - @tanstack/start-storage-context@1.166.31 + +## 1.167.21 + +### Patch Changes + +- Updated dependencies [[`8b97002`](https://github.com/TanStack/router/commit/8b97002af3f6d15204e60c55d3f5735b78bd7efe)]: + - @tanstack/start-client-core@1.167.19 + +## 1.167.20 + +### Patch Changes + +- Add TanStack Start inline CSS manifest support for SSR so route styles can be embedded in the HTML response and hydrated without duplicate stylesheet links. ([#7253](https://github.com/TanStack/router/pull/7253)) + +- Updated dependencies [[`4d864ee`](https://github.com/TanStack/router/commit/4d864eebbd184265eabb563d326ab409c93feb17)]: + - @tanstack/router-core@1.168.16 + - @tanstack/start-client-core@1.167.18 + - @tanstack/start-storage-context@1.166.30 + +## 1.167.19 + +### Patch Changes + +- Updated dependencies [[`16f6892`](https://github.com/TanStack/router/commit/16f6892d6b7ceadf606677c5a40e743f29163aa6)]: + - @tanstack/router-core@1.168.15 + - @tanstack/start-client-core@1.167.17 + - @tanstack/start-storage-context@1.166.29 + +## 1.167.18 + +### Patch Changes + +- chore: bump to h3 v2-rc.20 ([#7140](https://github.com/TanStack/router/pull/7140)) + +- Updated dependencies [[`0e2c900`](https://github.com/TanStack/router/commit/0e2c9003c18ae07c09969189c028f277ea562a7a)]: + - @tanstack/router-core@1.168.14 + - @tanstack/start-client-core@1.167.16 + - @tanstack/start-storage-context@1.166.28 + +## 1.167.17 + +### Patch Changes + +- Reduce React Start SSR manifest payload size by omitting unmatched route assets from dehydrated router state while keeping start-manifest asset serialization deduplicated by shared object identity. ([#7157](https://github.com/TanStack/router/pull/7157)) + + This improves SSR HTML size for apps with many routes that share the same CSS assets and adds regression coverage for CSS module hydration, navigation, and start-manifest asset reuse. + +- Updated dependencies [[`812792f`](https://github.com/TanStack/router/commit/812792fbda3caf97b300770855cf5641252f413b)]: + - @tanstack/router-core@1.168.13 + - @tanstack/start-client-core@1.167.15 + - @tanstack/start-storage-context@1.166.27 + +## 1.167.16 + +### Patch Changes + +- Updated dependencies [[`8ec9ca9`](https://github.com/TanStack/router/commit/8ec9ca97b472779de878c2a6510f21deb24d386c)]: + - @tanstack/router-core@1.168.12 + - @tanstack/start-client-core@1.167.14 + - @tanstack/start-storage-context@1.166.26 + +## 1.167.15 + +### Patch Changes + +- shorten internal non-minifiable store names for byte shaving ([#7152](https://github.com/TanStack/router/pull/7152)) + +- Updated dependencies [[`6355bb7`](https://github.com/TanStack/router/commit/6355bb75f7637ba77f06a923c18fdaf37720bb48)]: + - @tanstack/router-core@1.168.11 + - @tanstack/start-client-core@1.167.13 + - @tanstack/start-storage-context@1.166.25 + +## 1.167.14 + +### Patch Changes + +- migrate createStore > createAtom for simpler API ([#7150](https://github.com/TanStack/router/pull/7150)) + +- Updated dependencies [[`459057c`](https://github.com/TanStack/router/commit/459057cd2d90cff20d20e51d4964b0a8c950555e)]: + - @tanstack/start-client-core@1.167.12 + - @tanstack/router-core@1.168.10 + - @tanstack/start-storage-context@1.166.24 + +## 1.167.13 + +### Patch Changes + +- fix publishing ([`f8ac427`](https://github.com/TanStack/router/commit/f8ac427000c3fec99225926e72f9f2fc7a37231f)) + +- Updated dependencies [[`f8ac427`](https://github.com/TanStack/router/commit/f8ac427000c3fec99225926e72f9f2fc7a37231f)]: + - @tanstack/start-client-core@1.167.11 + +## 1.167.12 + +### Patch Changes + +- fix publishing ([`2d53c05`](https://github.com/TanStack/router/commit/2d53c056ef0b203de8a28bc92c24e8e604205d52)) + +## 1.167.10 + +### Patch Changes + +- Ensure request middleware context wins over colliding client-provided context in server function execution paths, including SSR, GET, and FormData requests. ([#7135](https://github.com/TanStack/router/pull/7135)) + +- Updated dependencies [[`f7e9c5e`](https://github.com/TanStack/router/commit/f7e9c5e323793d1b28c96871819c265fd28ae397)]: + - @tanstack/start-client-core@1.167.10 + ## 1.167.9 ### Patch Changes diff --git a/packages/start-server-core/bin/intent.js b/packages/start-server-core/bin/intent.js deleted file mode 100755 index 5b08532885..0000000000 --- a/packages/start-server-core/bin/intent.js +++ /dev/null @@ -1,25 +0,0 @@ -#!/usr/bin/env node -// Auto-generated by @tanstack/intent setup -// Exposes the intent end-user CLI for consumers of this library. -// Commit this file, then add to your package.json: -// "bin": { "intent": "./bin/intent.js" } -try { - await import('@tanstack/intent/intent-library') -} catch (e) { - const isModuleNotFound = - e?.code === 'ERR_MODULE_NOT_FOUND' || e?.code === 'MODULE_NOT_FOUND' - const missingIntentLibrary = - typeof e?.message === 'string' && e.message.includes('@tanstack/intent') - - if (isModuleNotFound && missingIntentLibrary) { - console.error('@tanstack/intent is not installed.') - console.error('') - console.error('Install it as a dev dependency:') - console.error(' npm add -D @tanstack/intent') - console.error('') - console.error('Or run directly:') - console.error(' npx @tanstack/intent@latest list') - process.exit(1) - } - throw e -} diff --git a/packages/start-server-core/package.json b/packages/start-server-core/package.json index 2ae1b7f561..dada40a325 100644 --- a/packages/start-server-core/package.json +++ b/packages/start-server-core/package.json @@ -1,6 +1,6 @@ { "name": "@tanstack/start-server-core", - "version": "1.167.9", + "version": "1.169.8", "description": "Modern and scalable routing for React applications", "author": "Tanner Linsley", "license": "MIT", @@ -59,11 +59,20 @@ "default": "./dist/esm/createSsrRpc.js" } }, + "./request-response": { + "import": { + "types": "./dist/esm/request-response.d.ts", + "default": "./dist/esm/request-response.js" + } + }, "./package.json": "./package.json" }, "imports": { "#tanstack-start-server-fn-resolver": { "default": "./dist/esm/fake-start-server-fn-resolver.js" + }, + "#tanstack-start-plugin-adapters": { + "default": "./dist/esm/empty-plugin-adapters.js" } }, "sideEffects": false, @@ -82,18 +91,14 @@ "@tanstack/router-core": "workspace:*", "@tanstack/start-client-core": "workspace:*", "@tanstack/start-storage-context": "workspace:*", - "h3-v2": "npm:h3@2.0.1-rc.16", - "seroval": "^1.4.2" + "fetchdts": "^0.1.6", + "h3-v2": "npm:h3@2.0.1-rc.20", + "seroval": "^1.5.4" }, "devDependencies": { "@standard-schema/spec": "^1.0.0", - "@tanstack/intent": "^0.0.14", - "cookie-es": "^2.0.0", - "fetchdts": "^0.1.6", + "cookie-es": "^3.0.0", "vite": "*", "@types/node": ">=20" - }, - "bin": { - "intent": "./bin/intent.js" } } diff --git a/packages/start-server-core/skills/start-server-core/SKILL.md b/packages/start-server-core/skills/start-server-core/SKILL.md index 4767576b48..e3eadf2851 100644 --- a/packages/start-server-core/skills/start-server-core/SKILL.md +++ b/packages/start-server-core/skills/start-server-core/SKILL.md @@ -41,7 +41,7 @@ With asset URL transforms (CDN): ```ts export default createStartHandler({ handler: defaultStreamHandler, - transformAssetUrls: 'https://cdn.example.com', + transformAssets: 'https://cdn.example.com', }) ``` diff --git a/packages/start-server-core/src/createSsrRpc.ts b/packages/start-server-core/src/createSsrRpc.ts index b44a1a1969..d38e6085da 100644 --- a/packages/start-server-core/src/createSsrRpc.ts +++ b/packages/start-server-core/src/createSsrRpc.ts @@ -1,20 +1,13 @@ import { TSS_SERVER_FUNCTION } from '@tanstack/start-client-core' import { getServerFnById } from './getServerFnById' import type { ClientFnMeta } from '@tanstack/start-client-core' -import type { ServerFn } from '#tanstack-start-server-fn-resolver' -export type SsrRpcImporter = () => Promise - -export const createSsrRpc = (functionId: string, importer?: SsrRpcImporter) => { +export const createSsrRpc = (functionId: string) => { const url = process.env.TSS_SERVER_FN_BASE + functionId const serverFnMeta: ClientFnMeta = { id: functionId } const fn = async (...args: Array): Promise => { - // If an importer is provided, use it directly (server-to-server call within the SSR environment) - // Otherwise, fall back to manifest lookup (client-to-server call, server functions that are only referenced on the server or if the provider environment is not SSR) - const serverFn = importer - ? await importer() - : await getServerFnById(functionId) + const serverFn = await getServerFnById(functionId, { origin: 'server' }) return serverFn(...args) } diff --git a/packages/start-server-core/src/createStartHandler.ts b/packages/start-server-core/src/createStartHandler.ts index 903c87d0f7..378ed50d2d 100644 --- a/packages/start-server-core/src/createStartHandler.ts +++ b/packages/start-server-core/src/createStartHandler.ts @@ -1,6 +1,8 @@ import { createMemoryHistory } from '@tanstack/history' import { + createCsrfMiddleware, createNullProtoObject, + csrfSymbol, flattenMiddlewares, mergeHeaders, safeObjectMerge, @@ -14,17 +16,23 @@ import { attachRouterServerSsrUtils, getNormalizedURL, getOrigin, + isSsrResponse, + normalizeSsrResponse, + replaceSsrResponse, + stripSsrResponseBody, } from '@tanstack/router-core/ssr/server' -import { runWithStartContext } from '@tanstack/start-storage-context' +import { + getStartContext, + runWithStartContext, +} from '@tanstack/start-storage-context' import { requestHandler } from './request-response' import { getStartManifest } from './router-manifest' import { handleServerAction } from './server-functions-handler' +import { createEarlyHintsCollector } from './early-hints' import { - adaptTransformAssetUrlsConfigToTransformAssets, - buildManifestWithClientEntry, - resolveTransformAssetsConfig, - transformManifestAssets, -} from './transformAssetUrls' + createCachedBaseManifestLoader, + createFinalManifestResolver, +} from './finalManifest' import { HEADERS } from './constants' import { ServerFunctionSerializationAdapter } from './serializer/ServerFunctionSerializationAdapter' @@ -41,16 +49,15 @@ import type { RequestHandler } from './request-handler' import type { AnyRoute, AnyRouter, - Manifest, + AnySerializationAdapter, Register, } from '@tanstack/router-core' -import type { HandlerCallback } from '@tanstack/router-core/ssr/server' import type { - StartManifestWithClientEntry, - TransformAssetUrls, - TransformAssets, - TransformAssetsFn, -} from './transformAssetUrls' + HandlerCallback, + HandlerCallbackResult, + SsrResponse, +} from '@tanstack/router-core/ssr/server' +import type { FinalManifestOptions } from './finalManifest' type TODO = any @@ -58,139 +65,8 @@ type AnyMiddlewareServerFn = | AnyRequestMiddleware['options']['server'] | AnyFunctionMiddleware['options']['server'] -export interface CreateStartHandlerOptions { +export interface CreateStartHandlerOptions extends FinalManifestOptions { handler: HandlerCallback - /** - * Transform asset URLs and attributes at runtime, e.g. to prepend a CDN prefix. - * - * **String** — a URL prefix prepended to every asset URL (cached by default): - * ```ts - * createStartHandler({ - * handler: defaultStreamHandler, - * transformAssets: 'https://cdn.example.com', - * }) - * ``` - * - * **Object shorthand** — a URL prefix with optional `crossOrigin`: - * ```ts - * createStartHandler({ - * handler: defaultStreamHandler, - * transformAssets: { - * prefix: 'https://cdn.example.com', - * crossOrigin: 'anonymous', - * }, - * }) - * ``` - * - * `crossOrigin` accepts a single value or a per-kind record: - * ```ts - * transformAssets: { - * prefix: 'https://cdn.example.com', - * crossOrigin: { - * modulepreload: 'anonymous', - * stylesheet: 'use-credentials', - * }, - * } - * ``` - * - * **Callback** — receives `{ kind, url }` and returns either a string URL or - * `{ href, crossOrigin? }` (cached by default — runs once on first request): - * ```ts - * createStartHandler({ - * handler: defaultStreamHandler, - * transformAssets: ({ kind, url }) => { - * const href = `https://cdn.example.com${url}` - * - * if (kind === 'modulepreload') { - * return { href, crossOrigin: 'anonymous' } - * } - * - * return { href } - * }, - * }) - * ``` - * - * **Object** — for explicit cache control: - * ```ts - * createStartHandler({ - * handler: defaultStreamHandler, - * transformAssets: { - * transform: ({ url }) => { - * const region = getRequest().headers.get('x-region') || 'us' - * return { href: `https://cdn-${region}.example.com${url}` } - * }, - * cache: false, - * }, - * }) - * ``` - * - * `kind` is one of `'modulepreload' | 'stylesheet' | 'clientEntry'`. - * `crossOrigin` applies to manifest-managed `` assets. - * - * By default, the transformed manifest is cached after the first request - * (`cache: true`). Set `cache: false` for per-request transforms. - * - * If you're using a cached transform, you can optionally set `warmup: true` - * (object form only) to compute the transformed manifest in the background at - * server startup. - * - * Note: This only transforms URLs managed by TanStack Start's manifest - * (JS preloads, CSS links, and the client entry script). For asset imports - * used directly in components (e.g. `import logo from './logo.svg'`), - * configure Vite's `experimental.renderBuiltUrl` in your vite.config.ts. - */ - transformAssets?: TransformAssets - /** - * @deprecated Use `transformAssets` instead. - * - * **String** — a URL prefix prepended to every asset URL (cached by default): - * ```ts - * createStartHandler({ - * handler: defaultStreamHandler, - * transformAssetUrls: 'https://cdn.example.com', - * }) - * ``` - * - * **Callback** — receives `{ url, type }` and returns a new URL - * (cached by default — runs once on first request): - * ```ts - * createStartHandler({ - * handler: defaultStreamHandler, - * transformAssetUrls: ({ url, type }) => { - * return `https://cdn.example.com${url}` - * }, - * }) - * ``` - * - * **Object** — for explicit cache control: - * ```ts - * createStartHandler({ - * handler: defaultStreamHandler, - * transformAssetUrls: { - * transform: ({ url }) => { - * const region = getRequest().headers.get('x-region') || 'us' - * return `https://cdn-${region}.example.com${url}` - * }, - * cache: false, // transform per-request - * }, - * }) - * ``` - * - * `type` is one of `'modulepreload' | 'stylesheet' | 'clientEntry'`. - * - * By default, the transformed manifest is cached after the first request - * (`cache: true`). Set `cache: false` for per-request transforms. - * - * If you're using a cached transform, you can optionally set `warmup: true` - * (object form only) to compute the transformed manifest in the background at - * server startup. - * - * Note: This only transforms URLs managed by TanStack Start's manifest - * (JS preloads, CSS links, and the client entry script). For asset imports - * used directly in components (e.g. `import logo from './logo.svg'`), - * configure Vite's `experimental.renderBuiltUrl` in your vite.config.ts. - */ - transformAssetUrls?: TransformAssetUrls } function getStartResponseHeaders(opts: { router: AnyRouter }) { @@ -198,35 +74,57 @@ function getStartResponseHeaders(opts: { router: AnyRouter }) { { 'Content-Type': 'text/html; charset=utf-8', }, - ...opts.router.stores.activeMatchesSnapshot.state.map((match) => { + ...opts.router.stores.matches.get().map((match) => { return match.headers }), ) return headers } +interface PluginAdaptersEntry { + hasPluginAdapters: boolean + pluginSerializationAdapters: Array +} + +interface Entries { + startEntry: StartEntry + routerEntry: RouterEntry + pluginAdapters: PluginAdaptersEntry +} + // Cached entries - promises stored immediately to prevent concurrent imports // that can cause race conditions during module initialization -let entriesPromise: - | Promise<{ - startEntry: StartEntry - routerEntry: RouterEntry - }> - | undefined -let baseManifestPromise: Promise | undefined +let entriesPromise: Promise | undefined +let hasWarnedMissingCsrfMiddleware = false +const defaultCsrfMiddleware = createCsrfMiddleware({ + filter: (ctx) => ctx.handlerType === 'serverFn', +}) +const getCachedBaseManifest = createCachedBaseManifestLoader(() => + getStartManifest(), +) +const getProdBaseManifest: typeof getStartManifest = () => + getCachedBaseManifest() +const getBaseManifest = + process.env.TSS_DEV_SERVER === 'true' ? getStartManifest : getProdBaseManifest +const createEarlyHintsForRequest: typeof createEarlyHintsCollector = + process.env.TSS_DEV_SERVER === 'true' + ? () => undefined + : createEarlyHintsCollector -/** - * Cached final manifest (with client entry script tag). In production, - * this is computed once and reused for every request when caching is enabled. - */ -let cachedFinalManifestPromise: Promise | undefined - -async function loadEntries() { - // @ts-ignore when building, we currently don't respect tsconfig.ts' `include` so we are not picking up the .d.ts from start-client-core - const routerEntry = (await import('#tanstack-router-entry')) as RouterEntry - // @ts-ignore when building, we currently don't respect tsconfig.ts' `include` so we are not picking up the .d.ts from start-client-core - const startEntry = (await import('#tanstack-start-entry')) as StartEntry - return { startEntry, routerEntry } +async function loadEntries(): Promise { + const [routerEntry, startEntry, pluginAdapters] = await Promise.all([ + // @ts-ignore When building, we currently don't respect tsconfig.ts' `include` so we are not picking up the .d.ts from start-client-core + import('#tanstack-router-entry'), + // @ts-ignore When building, we currently don't respect tsconfig.ts' `include` so we are not picking up the .d.ts from start-client-core + import('#tanstack-start-entry'), + // @ts-ignore When building, we currently don't respect tsconfig.ts' `include` so we are not picking up the .d.ts from start-client-core + import('#tanstack-start-plugin-adapters'), + ]) + return { + routerEntry: routerEntry as unknown as RouterEntry, + startEntry: startEntry as unknown as StartEntry, + pluginAdapters: pluginAdapters as unknown as PluginAdaptersEntry, + } } function getEntries() { @@ -236,59 +134,37 @@ function getEntries() { return entriesPromise } -/** - * Returns the raw manifest data (without client entry script tag baked in). - * In dev mode, always returns fresh data. In prod, cached. - */ -function getBaseManifest( - matchedRoutes?: ReadonlyArray, -): Promise { - // In dev mode, always get fresh manifest (no caching) to include route-specific dev styles - if (process.env.TSS_DEV_SERVER === 'true') { - return getStartManifest(matchedRoutes) - } - // In prod, cache the base manifest - if (!baseManifestPromise) { - baseManifestPromise = getStartManifest() - } - return baseManifestPromise +function hasCsrfMiddleware( + middlewares: Array, +): boolean { + return middlewares.some((middleware) => csrfSymbol in middleware) } -/** - * Resolves a final Manifest for a given request. - * - * - No transform: builds client entry script tag and returns (cached in prod). - * - Cached transform: transforms all URLs + builds script tag, caches result. - * - Per-request transform: deep-clones base manifest, transforms per-request. - */ -async function resolveManifest( - matchedRoutes: ReadonlyArray | undefined, - transformFn: TransformAssetsFn | undefined, - cache: boolean, -): Promise { - const base = await getBaseManifest(matchedRoutes) +function warnMissingCsrfMiddlewareOnce() { + if (hasWarnedMissingCsrfMiddleware) return + hasWarnedMissingCsrfMiddleware = true - const computeFinalManifest = async () => { - return transformFn - ? await transformManifestAssets(base, transformFn, { clone: !cache }) - : buildManifestWithClientEntry(base) - } + console.warn(`TanStack Start server functions are not protected by the CSRF middleware. - // In dev, always compute fresh to include route-specific dev styles. - if (process.env.TSS_DEV_SERVER === 'true') { - return computeFinalManifest() - } +Server functions are same-origin RPC endpoints and should be protected from cross-site requests. - // In prod, cache unless we're explicitly doing per-request transforms. - if (!transformFn || cache) { - if (!cachedFinalManifestPromise) { - cachedFinalManifestPromise = computeFinalManifest() - } - return cachedFinalManifestPromise - } +Add the CSRF middleware in src/start.ts: - // Per-request transform — deep-clone and transform every time. - return computeFinalManifest() + const csrfMiddleware = createCsrfMiddleware({ + filter: (ctx) => ctx.handlerType === 'serverFn', + }) + + export const startInstance = createStart(() => ({ + requestMiddleware: [csrfMiddleware], + })) + +If you intentionally handle CSRF another way, disable this warning: + + tanstackStart({ + serverFns: { + disableCsrfMiddlewareWarning: true, + }, + })`) } // Pre-computed constants @@ -326,7 +202,7 @@ function isSpecialResponse(value: unknown): value is Response { * Normalize middleware result to context shape */ function handleCtxResult(result: TODO) { - if (isSpecialResponse(result)) { + if (isSsrResponse(result) || isSpecialResponse(result)) { return { response: result } } return result @@ -335,8 +211,70 @@ function handleCtxResult(result: TODO) { /** * Execute a middleware chain */ -function executeMiddleware(middlewares: Array, ctx: TODO): Promise { +async function executeMiddleware( + middlewares: Array, + ctx: TODO, +): Promise<{ ctx: TODO; response: HandlerCallbackResult }> { let index = -1 + let streamResponse: + | Extract + | undefined + + const setResponse = (response: TODO) => { + if (isSsrResponse(response)) { + if (response.serverSsrCleanup === 'stream') { + streamResponse = response + } + ctx.response = response.response + return + } + + ctx.response = response + } + + const disposeStreamResponse = async (reason: string) => { + const response = streamResponse + if (!response) { + return + } + + streamResponse = undefined + const currentResponse = ctx.response + if ( + currentResponse === response.response || + (currentResponse instanceof Response && + response.response.body !== null && + currentResponse.body === response.response.body) + ) { + ctx.response = undefined + } + await response.dispose(reason) + } + + const getFinalResponse = async (): Promise => { + const response = ctx.response + if (!response) { + throwRouteHandlerError() + } + + if (!streamResponse) { + return response + } + + if (response === streamResponse.response) { + return streamResponse + } + + if ( + streamResponse.response.body !== null && + response.body === streamResponse.response.body + ) { + return { ...streamResponse, response } + } + + await disposeStreamResponse('middleware response replaced') + return response + } const next = async (nextCtx?: TODO): Promise => { // Merge context if provided using safeObjectMerge for prototype pollution prevention @@ -346,7 +284,9 @@ function executeMiddleware(middlewares: Array, ctx: TODO): Promise { } // Copy own properties except context (Object.keys returns only own enumerable properties) for (const key of Object.keys(nextCtx)) { - if (key !== 'context') { + if (key === 'response') { + setResponse(nextCtx.response) + } else if (key !== 'context') { ctx[key] = nextCtx[key] } } @@ -361,16 +301,17 @@ function executeMiddleware(middlewares: Array, ctx: TODO): Promise { result = await middleware({ ...ctx, next }) } catch (err) { if (isSpecialResponse(err)) { - ctx.response = err + setResponse(err) return ctx } + await disposeStreamResponse('middleware error') throw err } const normalized = handleCtxResult(result) if (normalized) { if (normalized.response !== undefined) { - ctx.response = normalized.response + setResponse(normalized.response) } if (normalized.context) { ctx.context = safeObjectMerge(ctx.context, normalized.context) @@ -380,7 +321,8 @@ function executeMiddleware(middlewares: Array, ctx: TODO): Promise { return ctx } - return next() + await next() + return { ctx, response: await getFinalResponse() } } /** @@ -435,96 +377,22 @@ function handlerToMiddleware( export function createStartHandler( cbOrOptions: HandlerCallback | CreateStartHandlerOptions, ): RequestHandler { - // Normalize the overloaded argument + const handlerOptions: FinalManifestOptions = + typeof cbOrOptions === 'function' ? {} : cbOrOptions const cb: HandlerCallback = typeof cbOrOptions === 'function' ? cbOrOptions : cbOrOptions.handler - const transformAssetsOption: TransformAssets | undefined = - typeof cbOrOptions === 'function' ? undefined : cbOrOptions.transformAssets - const transformAssetUrlsOption: TransformAssetUrls | undefined = - typeof cbOrOptions === 'function' - ? undefined - : cbOrOptions.transformAssetUrls + const finalManifestResolver = createFinalManifestResolver({ + ...handlerOptions, + cacheCreateTransform: process.env.TSS_DEV_SERVER !== 'true', + }) + const resolveManifestForRequest = + process.env.TSS_DEV_SERVER === 'true' + ? finalManifestResolver.resolveUncached + : finalManifestResolver.resolveCached - const transformOption = - transformAssetsOption !== undefined - ? resolveTransformAssetsConfig(transformAssetsOption) - : transformAssetUrlsOption !== undefined - ? resolveTransformAssetsConfig( - adaptTransformAssetUrlsConfigToTransformAssets( - transformAssetUrlsOption, - ), - ) - : undefined - - const warmupTransformManifest = - (!!transformAssetsOption && - typeof transformAssetsOption === 'object' && - 'warmup' in transformAssetsOption && - transformAssetsOption.warmup === true) || - (!!transformAssetUrlsOption && - typeof transformAssetUrlsOption === 'object' && - transformAssetUrlsOption.warmup === true) - - // Pre-resolve the transform function and cache flag - const resolvedTransformConfig = transformOption - const cache = resolvedTransformConfig ? resolvedTransformConfig.cache : true - const shouldCacheCreateTransform = - cache && process.env.TSS_DEV_SERVER !== 'true' - - // Memoize a single createTransform() result when caching is enabled outside - // of the dev server. - let cachedCreateTransformPromise: Promise | undefined - - const getTransformFn = async ( - opts: { warmup: true } | { warmup: false; request: Request }, - ): Promise => { - if (!resolvedTransformConfig) return undefined - - if (resolvedTransformConfig.type === 'createTransform') { - if (shouldCacheCreateTransform) { - if (!cachedCreateTransformPromise) { - cachedCreateTransformPromise = Promise.resolve( - resolvedTransformConfig.createTransform(opts), - ).catch((error) => { - cachedCreateTransformPromise = undefined - throw error - }) - } - - return cachedCreateTransformPromise - } - - return resolvedTransformConfig.createTransform(opts) - } - - return resolvedTransformConfig.transformFn - } - - // Background warmup for cached transforms (production only) - if ( - warmupTransformManifest && - cache && - process.env.TSS_DEV_SERVER !== 'true' && - !cachedFinalManifestPromise - ) { - // NOTE: Do not call resolveManifest() here. - // resolveManifest() reads from cachedFinalManifestPromise, and since we set - // cachedFinalManifestPromise to this warmup promise, that would create a - // self-referential promise and hang forever. - const warmupPromise = (async () => { - const base = await getBaseManifest(undefined) - const transformFn = await getTransformFn({ warmup: true }) - return transformFn - ? await transformManifestAssets(base, transformFn, { clone: false }) - : buildManifestWithClientEntry(base) - })() - cachedFinalManifestPromise = warmupPromise - warmupPromise.catch(() => { - // If warmup fails, allow the next request to retry. - if (cachedFinalManifestPromise === warmupPromise) { - cachedFinalManifestPromise = undefined - } - cachedCreateTransformPromise = undefined + if (process.env.TSS_DEV_SERVER !== 'true') { + finalManifestResolver.warmup({ + getBaseManifest: () => getBaseManifest(undefined), }) } @@ -533,7 +401,7 @@ export function createStartHandler( requestOpts, ) => { let router: AnyRouter | null = null as AnyRouter | null - let cbWillCleanup = false as boolean + let responseOwnsCleanup = false as boolean try { // normalizing and sanitizing the pathname here for server, so we always deal with the same format during SSR. @@ -548,23 +416,31 @@ export function createStartHandler( } const entries = await getEntries() + const hasStartInstance = !!entries.startEntry.startInstance const startOptions: AnyStartInstanceOptions = (await entries.startEntry.startInstance?.getOptions()) || ({} as AnyStartInstanceOptions) + const { hasPluginAdapters, pluginSerializationAdapters } = + entries.pluginAdapters + const serializationAdapters = [ ...(startOptions.serializationAdapters || []), + ...(hasPluginAdapters ? pluginSerializationAdapters : []), ServerFunctionSerializationAdapter, ] const requestStartOptions = { ...startOptions, + requestMiddleware: hasStartInstance + ? startOptions.requestMiddleware + : [defaultCsrfMiddleware], serializationAdapters, } // Flatten request middlewares once - const flattenedRequestMiddlewares = startOptions.requestMiddleware - ? flattenMiddlewares(startOptions.requestMiddleware) + const flattenedRequestMiddlewares = requestStartOptions.requestMiddleware + ? flattenMiddlewares(requestStartOptions.requestMiddleware) : [] // Create set for deduplication @@ -607,6 +483,14 @@ export function createStartHandler( // Check for server function requests first (early exit) if (SERVER_FN_BASE && url.pathname.startsWith(SERVER_FN_BASE)) { + if ( + process.env.NODE_ENV !== 'production' && + process.env.TSS_DISABLE_CSRF_MIDDLEWARE_WARNING !== 'true' && + !hasCsrfMiddleware(flattenedRequestMiddlewares) + ) { + warnMissingCsrfMiddlewareOnce() + } + const serverFnId = url.pathname .slice(SERVER_FN_BASE.length) .split('/')[0] @@ -623,6 +507,7 @@ export function createStartHandler( contextAfterGlobalMiddlewares: context, request, executedRequestMiddlewares, + handlerType: 'serverFn', }, () => handleServerAction({ @@ -636,20 +521,30 @@ export function createStartHandler( const middlewares = flattenedRequestMiddlewares.map( (d) => d.options.server, ) - const ctx = await executeMiddleware([...middlewares, serverFnHandler], { - request, - pathname: url.pathname, - context: createNullProtoObject(requestOpts?.context), - }) + const { response: middlewareResponse } = await executeMiddleware( + [...middlewares, serverFnHandler], + { + request, + pathname: url.pathname, + handlerType: 'serverFn', + context: createNullProtoObject(requestOpts?.context), + }, + ) - return handleRedirectResponse(ctx.response, request, getRouter) + const result = await handleRedirectResponse( + middlewareResponse, + request, + getRouter, + ) + responseOwnsCleanup = result.serverSsrCleanup === 'stream' + return result.response } // Router execution function const executeRouter = async ( serverContext: TODO, matchedRoutes?: ReadonlyArray, - ): Promise => { + ): Promise => { const acceptHeader = request.headers.get('Accept') || '*/*' const acceptParts = acceptHeader.split(',') const supportedMimeTypes = ['*/*', 'text/html'] @@ -659,43 +554,61 @@ export function createStartHandler( ) if (!isSupported) { - return Response.json( - { error: 'Only HTML requests are supported here' }, - { status: 500 }, + return normalizeSsrResponse( + Response.json( + { error: 'Only HTML requests are supported here' }, + { status: 500 }, + ), ) } - const manifest = await resolveManifest( - matchedRoutes, - await getTransformFn({ warmup: false, request }), - cache, - ) + const manifest = await resolveManifestForRequest({ + request, + requestInlineCss: requestOpts?.inlineCss, + getBaseManifest: () => getBaseManifest(matchedRoutes), + }) + + const earlyHints = createEarlyHintsForRequest({ + onEarlyHints: requestOpts?.onEarlyHints, + responseLinkHeader: requestOpts?.responseLinkHeader, + }) + + earlyHints?.collectStatic({ manifest, matchedRoutes }) + const routerInstance = await getRouter() attachRouterServerSsrUtils({ router: routerInstance, manifest, + getRequestAssets: () => + getStartContext({ throwIfNotFound: false })?.requestAssets, }) routerInstance.update({ additionalContext: { serverContext } }) await routerInstance.load() if (routerInstance.state.redirect) { - return routerInstance.state.redirect + return normalizeSsrResponse(routerInstance.state.redirect) } - await routerInstance.serverSsr!.dehydrate() + earlyHints?.collectDynamic(routerInstance.stores.matches.get()) + + // Pass request-scoped assets to dehydrate for manifest injection + const ctx = getStartContext({ throwIfNotFound: false }) + await routerInstance.serverSsr!.dehydrate({ + requestAssets: ctx?.requestAssets, + }) const responseHeaders = getStartResponseHeaders({ router: routerInstance, }) - cbWillCleanup = true - - return cb({ + earlyHints?.appendResponseHeaders(responseHeaders) + const response = await cb({ request, router: routerInstance, responseHeaders, }) + return normalizeSsrResponse(response) } // Main request handler @@ -707,6 +620,7 @@ export function createStartHandler( contextAfterGlobalMiddlewares: context, request, executedRequestMiddlewares, + handlerType: 'router', }, async () => { try { @@ -731,23 +645,29 @@ export function createStartHandler( const middlewares = flattenedRequestMiddlewares.map( (d) => d.options.server, ) - const ctx = await executeMiddleware( + const { response: middlewareResponse } = await executeMiddleware( [...middlewares, requestHandlerMiddleware], { request, pathname: url.pathname, + handlerType: 'router', context: createNullProtoObject(requestOpts?.context), }, ) - return handleRedirectResponse(ctx.response, request, getRouter) + const response = await handleRedirectResponse( + middlewareResponse, + request, + getRouter, + ) + responseOwnsCleanup = response.serverSsrCleanup === 'stream' + return response.response } finally { - if (router && !cbWillCleanup) { + if (router?.serverSsr && !responseOwnsCleanup) { // Clean up router SSR state if it was set up but won't be cleaned up by the callback // (e.g., in redirect cases or early returns before the callback is invoked). - // When the callback runs, it handles cleanup (either via transformStreamWithRouter - // for streaming, or directly in renderRouterToString for non-streaming). - router.serverSsr?.cleanup() + // Transformed streaming response bodies clean up when consumed/cancelled. + router.serverSsr.cleanup() } router = null } @@ -757,25 +677,30 @@ export function createStartHandler( } async function handleRedirectResponse( - response: Response, + response: HandlerCallbackResult, request: Request, getRouter: () => Promise, -): Promise { - if (!isRedirect(response)) { - return response +): Promise { + const ssrResponse = normalizeSsrResponse(response) + if (!isRedirect(ssrResponse.response)) { + return ssrResponse } - if (isResolvedRedirect(response)) { + if (isResolvedRedirect(ssrResponse.response)) { if (request.headers.get('x-tsr-serverFn') === 'true') { - return Response.json( - { ...response.options, isSerializedRedirect: true }, - { headers: response.headers }, + return replaceSsrResponse( + ssrResponse, + Response.json( + { ...ssrResponse.response.options, isSerializedRedirect: true }, + { headers: ssrResponse.response.headers }, + ), + 'redirect response replaced', ) } - return response + return ssrResponse } - const opts = response.options + const opts = ssrResponse.response.options if (opts.to && typeof opts.to === 'string' && !opts.to.startsWith('/')) { throw new Error( `Server side redirects must use absolute paths via the 'href' or 'to' options. The redirect() method's "to" property accepts an internal path only. Use the "href" property to provide an external URL. Received: ${JSON.stringify(opts)}`, @@ -798,16 +723,20 @@ async function handleRedirectResponse( } const router = await getRouter() - const redirect = router.resolveRedirect(response) + const redirect = router.resolveRedirect(ssrResponse.response) if (request.headers.get('x-tsr-serverFn') === 'true') { - return Response.json( - { ...response.options, isSerializedRedirect: true }, - { headers: response.headers }, + return replaceSsrResponse( + ssrResponse, + Response.json( + { ...ssrResponse.response.options, isSerializedRedirect: true }, + { headers: ssrResponse.response.headers }, + ), + 'redirect response replaced', ) } - return redirect + return replaceSsrResponse(ssrResponse, redirect, 'redirect response replaced') } async function handleServerRoutes({ @@ -824,10 +753,10 @@ async function handleServerRoutes({ executeRouter: ( serverContext: any, matchedRoutes?: ReadonlyArray, - ) => Promise + ) => Promise context: any executedRequestMiddlewares: Set -}): Promise { +}): Promise { const router = await getRouter() const rewrittenUrl = executeRewriteInput(router.rewrite, url) const pathname = rewrittenUrl.pathname @@ -860,6 +789,7 @@ async function handleServerRoutes({ // Add handler middleware if exact match const server = foundRoute?.options.server + let isHeadFallback = false if (server?.handlers && isExactMatch) { const handlers = typeof server.handlers === 'function' @@ -867,7 +797,14 @@ async function handleServerRoutes({ : server.handlers const requestMethod = request.method.toUpperCase() as RouteMethod - const handler = handlers[requestMethod] ?? handlers['ANY'] + // Per RFC 9110 §9.3.2, HEAD must return the same header fields as GET. + // Priority for HEAD: explicit HEAD handler → GET → ANY (last resort). + const handler = + requestMethod === 'HEAD' + ? (handlers['HEAD'] ?? handlers['GET'] ?? handlers['ANY']) + : (handlers[requestMethod] ?? handlers['ANY']) + isHeadFallback = + requestMethod === 'HEAD' && handler !== undefined && !handlers['HEAD'] if (handler) { const mayDefer = !!foundRoute.options.component @@ -889,16 +826,27 @@ async function handleServerRoutes({ } // Final middleware: execute router with matched routes for dev styles - routeMiddlewares.push((ctx: TODO) => - executeRouter(ctx.context, matchedRoutes), - ) + routeMiddlewares.push(((ctx: TODO) => + executeRouter(ctx.context, matchedRoutes)) as TODO) - const ctx = await executeMiddleware(routeMiddlewares, { + const { ctx, response } = await executeMiddleware(routeMiddlewares, { request, context, params: routeParams, pathname, + handlerType: 'router', }) - return ctx.response + // RFC 9110 §9.3.2: HEAD must carry the same header fields as GET but no body. + // Resolve any redirect before stripping so the Location header survives. + if (isHeadFallback) { + if (!ctx.response) { + throwRouteHandlerError() + } + + const resolved = await handleRedirectResponse(response, request, getRouter) + return stripSsrResponseBody(resolved, 'HEAD body stripped') + } + + return normalizeSsrResponse(response) } diff --git a/packages/start-server-core/src/early-hints.ts b/packages/start-server-core/src/early-hints.ts new file mode 100644 index 0000000000..f46cf5f587 --- /dev/null +++ b/packages/start-server-core/src/early-hints.ts @@ -0,0 +1,454 @@ +import { + getScriptPreloadAttrs, + getStylesheetHref, + resolveManifestCssLink, +} from '@tanstack/router-core' +import type { + AnyRoute, + AnyRouteMatch, + AssetCrossOrigin, + RouterManagedTag, + ServerManifest, +} from '@tanstack/router-core' + +export type EarlyHint = { + href: string + rel: 'preload' | 'modulepreload' | 'preconnect' | 'dns-prefetch' + as?: 'fetch' | 'font' | 'image' | 'script' | 'style' | 'track' + crossOrigin?: AssetCrossOrigin | '' + type?: string + integrity?: string + referrerPolicy?: string + fetchPriority?: string +} + +export type EarlyHintsPhase = 'static' | 'dynamic' + +export type EarlyHintsEvent = { + phase: EarlyHintsPhase + hints: ReadonlyArray + links: Array + allHints: ReadonlyArray + allLinks: Array +} + +export type OnEarlyHints = (event: EarlyHintsEvent) => void | Promise + +export type ResponseLinkHeaderEntry = { + phase: EarlyHintsPhase + hint: EarlyHint + link: string +} + +export type ResponseLinkHeaderFilter = ( + entry: ResponseLinkHeaderEntry, +) => boolean + +export type ResponseLinkHeaderOptions = { + filter?: ResponseLinkHeaderFilter +} + +export interface EarlyHintsCollector { + collectStatic: (opts: { + manifest: ServerManifest + matchedRoutes?: ReadonlyArray + }) => void + collectDynamic: (matches: ReadonlyArray) => void + appendResponseHeaders: (headers: Headers) => void +} + +const LINK_PARAM_TOKEN_RE = /^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/ +const PRELOAD_AS_VALUES = new Set([ + 'fetch', + 'font', + 'image', + 'script', + 'style', + 'track', +]) + +function buildLinkParam(name: string, value: string | undefined): string { + if (value === undefined) return name + if (LINK_PARAM_TOKEN_RE.test(value)) return `${name}=${value}` + return `${name}=${JSON.stringify(value)}` +} + +export function serializeEarlyHint(hint: EarlyHint): string { + const parts = [`<${hint.href}>`, buildLinkParam('rel', hint.rel)] + if (hint.as) parts.push(buildLinkParam('as', hint.as)) + if (hint.crossOrigin !== undefined) { + parts.push(buildLinkParam('crossorigin', hint.crossOrigin || undefined)) + } + if (hint.type) parts.push(buildLinkParam('type', hint.type)) + if (hint.integrity) parts.push(buildLinkParam('integrity', hint.integrity)) + if (hint.referrerPolicy) { + parts.push(buildLinkParam('referrerpolicy', hint.referrerPolicy)) + } + if (hint.fetchPriority) { + parts.push(buildLinkParam('fetchpriority', hint.fetchPriority)) + } + return parts.join('; ') +} + +function getStringAttr( + attrs: Record | undefined, + name: string, + fallbackName?: string, +): string | undefined { + const value = + attrs?.[name] ?? (fallbackName ? attrs?.[fallbackName] : undefined) + return typeof value === 'string' ? value : undefined +} + +function getPreloadAs( + attrs: Record | undefined, +): EarlyHint['as'] | undefined { + const as = getStringAttr(attrs, 'as') + return as && PRELOAD_AS_VALUES.has(as as EarlyHint['as']) + ? (as as EarlyHint['as']) + : undefined +} + +function addEarlyHintFetchAttrs( + hint: EarlyHint, + attrs: Record | undefined, +) { + const crossOrigin = getStringAttr(attrs, 'crossOrigin', 'crossorigin') as + | EarlyHint['crossOrigin'] + | undefined + const type = getStringAttr(attrs, 'type') + const integrity = getStringAttr(attrs, 'integrity') + const referrerPolicy = getStringAttr( + attrs, + 'referrerPolicy', + 'referrerpolicy', + ) + const fetchPriority = getStringAttr(attrs, 'fetchPriority', 'fetchpriority') + + if (crossOrigin !== undefined) hint.crossOrigin = crossOrigin + if (type) hint.type = type + if (integrity) hint.integrity = integrity + if (referrerPolicy) hint.referrerPolicy = referrerPolicy + if (fetchPriority) hint.fetchPriority = fetchPriority +} + +function linkAttrsToEarlyHint( + attrs: Record | undefined, +): EarlyHint | undefined { + const href = getStringAttr(attrs, 'href') + const rel = getStringAttr(attrs, 'rel') + if (!href || !rel) return undefined + + const relTokens = rel.split(/\s+/) + let hintRel: EarlyHint['rel'] | undefined + let hintAs: EarlyHint['as'] | undefined + + if (relTokens.includes('modulepreload')) { + hintRel = 'modulepreload' + hintAs = 'script' + } else if (relTokens.includes('stylesheet')) { + hintRel = 'preload' + hintAs = 'style' + } else if (relTokens.includes('preload')) { + hintAs = getPreloadAs(attrs) + if (!hintAs) return undefined + hintRel = 'preload' + } else if (relTokens.includes('preconnect')) { + hintRel = 'preconnect' + hintAs = undefined + } else if (relTokens.includes('dns-prefetch')) { + hintRel = 'dns-prefetch' + hintAs = undefined + } + + if (!hintRel) return undefined + + const hint: EarlyHint = { + href, + rel: hintRel, + } + + if (hintAs) hint.as = hintAs + addEarlyHintFetchAttrs(hint, attrs) + + return hint +} + +export function collectStaticHintsFromManifest( + manifest: ServerManifest, + matchedRoutes: ReadonlyArray, +): Array { + const hints: Array = [] + + for (const route of matchedRoutes) { + const routeManifest = manifest.routes[route.id] + if (!routeManifest) continue + + for (const link of routeManifest.preloads ?? []) { + const attrs = getScriptPreloadAttrs(manifest, link) + const hint: EarlyHint = { + href: attrs.href, + rel: attrs.rel, + as: 'script', + } + if (attrs.crossOrigin !== undefined) hint.crossOrigin = attrs.crossOrigin + hints.push(hint) + } + + for (const link of routeManifest.css ?? []) { + const stylesheetHref = getStylesheetHref(link) + if (manifest.inlineCss?.styles[stylesheetHref] !== undefined) { + continue + } + const resolvedLink = resolveManifestCssLink(link) + + const hint: EarlyHint = { + href: stylesheetHref, + rel: 'preload', + as: 'style', + } + if (resolvedLink.crossOrigin !== undefined) { + hint.crossOrigin = resolvedLink.crossOrigin + } + hints.push(hint) + } + } + + return hints +} + +export function collectDynamicHintsFromMatches( + matches: ReadonlyArray, +): Array { + const hints: Array = [] + + for (const match of matches) { + const links = match.links + if (!Array.isArray(links)) continue + + for (const link of links as Array) { + const hint = linkAttrsToEarlyHint(link) + if (hint) hints.push(hint) + } + } + + return hints +} + +export function createEarlyHintsEvent(opts: { + phase: EarlyHintsPhase + hints: ReadonlyArray + sentLinks: Set + sentHints: Array +}): EarlyHintsEvent | undefined { + const nextHints: Array = [] + const nextLinks: Array = [] + + for (const hint of opts.hints) { + const link = serializeEarlyHint(hint) + if (opts.sentLinks.has(link)) continue + opts.sentLinks.add(link) + opts.sentHints.push(hint) + nextHints.push(hint) + nextLinks.push(link) + } + + if (!nextHints.length && opts.phase !== 'dynamic') return undefined + + return { + phase: opts.phase, + hints: nextHints, + links: nextLinks, + allHints: opts.sentHints.slice(), + allLinks: Array.from(opts.sentLinks), + } +} + +export function createResponseLinkHeaderEntries(opts: { + phase: EarlyHintsPhase + hints: ReadonlyArray + sentLinks: Set + entries: Array +}) { + for (const hint of opts.hints) { + const link = serializeEarlyHint(hint) + if (opts.sentLinks.has(link)) continue + + opts.sentLinks.add(link) + opts.entries.push({ phase: opts.phase, hint, link }) + } +} + +export function getResponseLinkHeaderEntries(opts: { + entries: ReadonlyArray + filter?: ResponseLinkHeaderFilter +}): Array { + if (!opts.filter) { + return opts.entries.map((entry) => entry.link) + } + + try { + const links: Array = [] + + for (const entry of opts.entries) { + if (opts.filter(entry)) { + links.push(entry.link) + } + } + + return links + } catch (err) { + console.error('Error filtering response Link headers:', err) + return [] + } +} + +function notifyEarlyHints( + phase: EarlyHintsPhase, + event: EarlyHintsEvent, + onEarlyHints: OnEarlyHints, +) { + try { + const result = onEarlyHints(event) + if (result) { + void Promise.resolve(result).catch((err) => { + console.error(`Error sending ${phase} early hints:`, err) + }) + } + } catch (err) { + console.error(`Error sending ${phase} early hints:`, err) + } +} + +function getResponseLinkHeaderFilter( + responseLinkHeader: boolean | ResponseLinkHeaderOptions | undefined, +): ResponseLinkHeaderFilter | undefined { + if (typeof responseLinkHeader !== 'object') { + return undefined + } + + return responseLinkHeader.filter +} + +function appendResponseLinkHeaders(opts: { + responseHeaders: Headers + entries: ReadonlyArray + filter?: ResponseLinkHeaderFilter +}) { + for (const link of getResponseLinkHeaderEntries(opts)) { + opts.responseHeaders.append('Link', link) + } +} + +function collectResponseLinkHeaderEntries(opts: { + phase: EarlyHintsPhase + event: EarlyHintsEvent + entries: Array +}) { + for (let index = 0; index < opts.event.hints.length; index++) { + opts.entries.push({ + phase: opts.phase, + hint: opts.event.hints[index]!, + link: opts.event.links[index]!, + }) + } +} + +function collectEarlyHintsPhase(opts: { + phase: EarlyHintsPhase + hints: ReadonlyArray + sentLinks: Set + sentHints?: Array + onEarlyHints?: OnEarlyHints + responseLinkHeaderEntries?: Array +}) { + const event = opts.onEarlyHints + ? createEarlyHintsEvent({ + phase: opts.phase, + hints: opts.hints, + sentLinks: opts.sentLinks, + sentHints: opts.sentHints!, + }) + : undefined + + if (event) { + notifyEarlyHints(opts.phase, event, opts.onEarlyHints!) + } + + if (!opts.responseLinkHeaderEntries) return + + if (event) { + collectResponseLinkHeaderEntries({ + phase: opts.phase, + event, + entries: opts.responseLinkHeaderEntries, + }) + return + } + + createResponseLinkHeaderEntries({ + phase: opts.phase, + hints: opts.hints, + sentLinks: opts.sentLinks, + entries: opts.responseLinkHeaderEntries, + }) +} + +export function createEarlyHintsCollector( + opts: + | { + onEarlyHints?: OnEarlyHints + responseLinkHeader?: boolean | ResponseLinkHeaderOptions + } + | undefined, +): EarlyHintsCollector | undefined { + if ( + process.env.TSS_DEV_SERVER === 'true' || + (!opts?.onEarlyHints && !opts?.responseLinkHeader) + ) { + return undefined + } + + const sentLinks = new Set() + const sentHints = opts.onEarlyHints ? new Array() : undefined + const responseLinkHeaderEntries = opts.responseLinkHeader + ? new Array() + : undefined + const responseLinkHeaderFilter = getResponseLinkHeaderFilter( + opts.responseLinkHeader, + ) + + return { + collectStatic: ({ manifest, matchedRoutes }) => { + if (!matchedRoutes?.length) return + + collectEarlyHintsPhase({ + phase: 'static', + hints: collectStaticHintsFromManifest(manifest, matchedRoutes), + sentLinks, + sentHints, + onEarlyHints: opts.onEarlyHints, + responseLinkHeaderEntries, + }) + }, + collectDynamic: (matches) => { + collectEarlyHintsPhase({ + phase: 'dynamic', + hints: collectDynamicHintsFromMatches(matches), + sentLinks, + sentHints, + onEarlyHints: opts.onEarlyHints, + responseLinkHeaderEntries, + }) + }, + appendResponseHeaders: (headers) => { + if (!responseLinkHeaderEntries?.length) return + + appendResponseLinkHeaders({ + responseHeaders: headers, + entries: responseLinkHeaderEntries, + filter: responseLinkHeaderFilter, + }) + }, + } +} diff --git a/packages/start-server-core/src/empty-plugin-adapters.ts b/packages/start-server-core/src/empty-plugin-adapters.ts new file mode 100644 index 0000000000..579643cb86 --- /dev/null +++ b/packages/start-server-core/src/empty-plugin-adapters.ts @@ -0,0 +1,4 @@ +import type { AnySerializationAdapter } from '@tanstack/router-core' + +export const pluginSerializationAdapters: Array = [] +export const hasPluginAdapters = false diff --git a/packages/start-server-core/src/fake-start-server-fn-resolver.ts b/packages/start-server-core/src/fake-start-server-fn-resolver.ts index d1b5a0aeaf..31ad8a7368 100644 --- a/packages/start-server-core/src/fake-start-server-fn-resolver.ts +++ b/packages/start-server-core/src/fake-start-server-fn-resolver.ts @@ -1 +1,4 @@ -export async function getServerFnById(): Promise {} +export async function getServerFnById( + _id: string, + _access: { origin: 'client' | 'server' }, +): Promise {} diff --git a/packages/start-server-core/src/finalManifest.ts b/packages/start-server-core/src/finalManifest.ts new file mode 100644 index 0000000000..274e6cb000 --- /dev/null +++ b/packages/start-server-core/src/finalManifest.ts @@ -0,0 +1,316 @@ +import { + buildManifest, + resolveTransformAssetsConfig, + transformManifestAssets, +} from './transformAssetUrls' +import { + getStaticHandlerInlineCssDefault, + resolveInlineCssForRequest, +} from './inlineCss' +import type { ServerManifest } from '@tanstack/router-core' +import type { HandlerInlineCssOption } from './inlineCss' +import type { + CreateTransformAssetsContext, + TransformAssets, + TransformAssetsFn, +} from './transformAssetUrls' + +export type { HandlerInlineCssOption, TransformAssets } + +export interface FinalManifestOptions { + /** + * Controls whether Start inlines build-collected CSS by default at runtime. + * + * This only has an effect when the build was created with + * `server.build.inlineCss` enabled. Pass a callback to decide per request. + * `handler(request, { inlineCss })` overrides this value for that request. + * + * @default true + */ + inlineCss?: HandlerInlineCssOption + /** + * Transform manifest-managed asset URLs and attributes at runtime, e.g. to + * prepend a CDN prefix. + * + * This covers JS preloads, manifest script tags, CSS links, and URLs inside + * build-collected inline CSS. Asset imports used directly in + * components should be handled by the bundler instead. + */ + transformAssets?: TransformAssets +} + +type FinalManifestCacheKey = 'inline-css' | 'linked-css' +type FinalManifestCache = Map> +export type GetBaseManifest = () => Promise + +export interface FinalManifestRequestOptions { + request: Request + requestInlineCss: boolean | undefined + getBaseManifest: GetBaseManifest +} + +interface FinalManifestTransformResolver { + cache: boolean + warmup: boolean + getTransformFn: ( + ctx: CreateTransformAssetsContext, + ) => Promise + clearCachedCreateTransform: () => void +} + +export interface FinalManifestResolver { + warmup: (opts: { + getBaseManifest: GetBaseManifest + }) => Promise | undefined + resolveCached: (opts: FinalManifestRequestOptions) => Promise + resolveUncached: ( + opts: FinalManifestRequestOptions, + ) => Promise +} + +export function createCachedBaseManifestLoader( + loadBaseManifest: GetBaseManifest, +): GetBaseManifest { + let baseManifestPromise: Promise | undefined + + return () => { + if (!baseManifestPromise) { + baseManifestPromise = loadBaseManifest().catch((error) => { + baseManifestPromise = undefined + throw error + }) + } + + return baseManifestPromise + } +} + +function createFinalManifestTransformResolver( + transformAssets: TransformAssets | undefined, + opts: { cacheCreateTransform: boolean }, +): FinalManifestTransformResolver { + const transformConfig = + transformAssets !== undefined + ? resolveTransformAssetsConfig(transformAssets) + : undefined + const cache = transformConfig ? transformConfig.cache : true + const warmup = + !!transformAssets && + typeof transformAssets === 'object' && + 'warmup' in transformAssets && + transformAssets.warmup === true + + let cachedCreateTransformPromise: Promise | undefined + + const clearCachedCreateTransform = () => { + cachedCreateTransformPromise = undefined + } + + return { + cache, + warmup, + clearCachedCreateTransform, + getTransformFn: async (ctx) => { + if (!transformConfig) return undefined + + if (transformConfig.type !== 'createTransform') { + return transformConfig.transformFn + } + + if (!cache || !opts.cacheCreateTransform) { + return transformConfig.createTransform(ctx) + } + + if (!cachedCreateTransformPromise) { + cachedCreateTransformPromise = Promise.resolve( + transformConfig.createTransform(ctx), + ).catch((error) => { + clearCachedCreateTransform() + throw error + }) + } + + return cachedCreateTransformPromise + }, + } +} + +export function createFinalManifestResolver( + opts: FinalManifestOptions & { cacheCreateTransform: boolean }, +): FinalManifestResolver { + const finalManifestCache: FinalManifestCache = new Map() + const transformResolver = createFinalManifestTransformResolver( + opts.transformAssets, + { cacheCreateTransform: opts.cacheCreateTransform }, + ) + const handlerDefaultInlineCss = getStaticHandlerInlineCssDefault( + opts.inlineCss, + ) + + const getRequestManifestOptions = async ( + requestOpts: FinalManifestRequestOptions, + ) => { + const transformFn = await transformResolver.getTransformFn({ + warmup: false, + request: requestOpts.request, + }) + const inlineCss = await resolveInlineCssForRequest({ + request: requestOpts.request, + handlerInlineCss: opts.inlineCss, + requestInlineCss: requestOpts.requestInlineCss, + }) + + return { + getBaseManifest: requestOpts.getBaseManifest, + transformFn, + cache: transformResolver.cache, + inlineCss, + } + } + + const resolveRequest = async ( + requestOpts: FinalManifestRequestOptions, + cache: FinalManifestCache | undefined, + ) => { + return resolveFinalManifest({ + ...(await getRequestManifestOptions(requestOpts)), + finalManifestCache: cache, + }) + } + + return { + warmup: ({ getBaseManifest }) => + warmupFinalManifest({ + enabled: transformResolver.warmup, + handlerDefaultInlineCss, + cache: transformResolver.cache, + finalManifestCache, + getBaseManifest, + getTransformFn: () => + transformResolver.getTransformFn({ warmup: true }), + onError: transformResolver.clearCachedCreateTransform, + }), + resolveCached: (requestOpts) => + resolveRequest(requestOpts, finalManifestCache), + resolveUncached: (requestOpts) => resolveRequest(requestOpts, undefined), + } +} + +function getFinalManifestCacheKey(inlineCss: boolean): FinalManifestCacheKey { + return inlineCss ? 'inline-css' : 'linked-css' +} + +function cacheFinalManifestPromise( + cachedFinalManifestPromises: FinalManifestCache, + cacheKey: FinalManifestCacheKey, + promise: Promise, +): Promise { + const cachedFinalManifestPromise = promise.catch((error) => { + if ( + cachedFinalManifestPromises.get(cacheKey) === cachedFinalManifestPromise + ) { + cachedFinalManifestPromises.delete(cacheKey) + } + throw error + }) + + cachedFinalManifestPromises.set(cacheKey, cachedFinalManifestPromise) + return cachedFinalManifestPromise +} + +function getOrCreateCachedFinalManifestPromise( + cachedFinalManifestPromises: FinalManifestCache, + cacheKey: FinalManifestCacheKey, + computeFinalManifest: () => Promise, +): Promise { + const cachedFinalManifestPromise = cachedFinalManifestPromises.get(cacheKey) + if (cachedFinalManifestPromise) { + return cachedFinalManifestPromise + } + + return cacheFinalManifestPromise( + cachedFinalManifestPromises, + cacheKey, + Promise.resolve().then(computeFinalManifest), + ) +} + +async function buildFinalManifest(opts: { + base: ServerManifest + transformFn: TransformAssetsFn | undefined + inlineCss: boolean +}): Promise { + return opts.transformFn + ? await transformManifestAssets(opts.base, opts.transformFn, { + inlineCss: opts.inlineCss, + }) + : buildManifest(opts.base, { inlineCss: opts.inlineCss }) +} + +async function resolveFinalManifest(opts: { + getBaseManifest: () => Promise + transformFn: TransformAssetsFn | undefined + cache: boolean + inlineCss: boolean + finalManifestCache?: FinalManifestCache +}): Promise { + const computeFinalManifest = async () => { + return buildFinalManifest({ + base: await opts.getBaseManifest(), + transformFn: opts.transformFn, + inlineCss: opts.inlineCss, + }) + } + + if (opts.finalManifestCache && (!opts.transformFn || opts.cache)) { + return getOrCreateCachedFinalManifestPromise( + opts.finalManifestCache, + getFinalManifestCacheKey(opts.inlineCss), + computeFinalManifest, + ) + } + + return computeFinalManifest() +} + +function warmupFinalManifest(opts: { + enabled: boolean + handlerDefaultInlineCss: boolean | undefined + cache: boolean + finalManifestCache: FinalManifestCache + getBaseManifest: () => Promise + getTransformFn: () => Promise + onError?: () => void +}): Promise | undefined { + if ( + !opts.enabled || + opts.handlerDefaultInlineCss === undefined || + !opts.cache + ) { + return undefined + } + + const inlineCss = opts.handlerDefaultInlineCss + const warmupPromise = getOrCreateCachedFinalManifestPromise( + opts.finalManifestCache, + getFinalManifestCacheKey(inlineCss), + async () => { + const [base, transformFn] = await Promise.all([ + opts.getBaseManifest(), + opts.getTransformFn(), + ]) + + return buildFinalManifest({ + base, + transformFn, + inlineCss, + }) + }, + ) + + if (opts.onError) { + void warmupPromise.catch(opts.onError) + } + + return warmupPromise +} diff --git a/packages/start-server-core/src/frame-protocol.ts b/packages/start-server-core/src/frame-protocol.ts index 50929ce65a..e96275c0bb 100644 --- a/packages/start-server-core/src/frame-protocol.ts +++ b/packages/start-server-core/src/frame-protocol.ts @@ -82,135 +82,177 @@ export function encodeErrorFrame(streamId: number, error: unknown): Uint8Array { return encodeFrame(FrameType.ERROR, streamId, textEncoder.encode(message)) } +/** + * Late stream registration for RawStreams discovered after serialization starts. + * Used when Promise resolves after the initial synchronous pass. + */ +export interface LateStreamRegistration { + id: number + stream: ReadableStream +} + /** * Creates a multiplexed ReadableStream from JSON stream and raw streams. * * The JSON stream emits NDJSON lines (from seroval's toCrossJSONStream). * Raw streams are pumped concurrently, interleaved with JSON frames. * + * Supports late stream registration for RawStreams discovered after initial + * serialization (e.g., from resolved Promises). + * * @param jsonStream Stream of JSON strings (each string is one NDJSON line) - * @param rawStreams Map of stream IDs to raw binary streams + * @param rawStreams Map of stream IDs to raw binary streams (known at start) + * @param lateStreamSource Optional stream of late registrations for streams discovered later */ export function createMultiplexedStream( jsonStream: ReadableStream, rawStreams: Map>, + lateStreamSource?: ReadableStream, ): ReadableStream { - // Track active pumps for completion - let activePumps = 1 + rawStreams.size // 1 for JSON + raw streams - let controllerRef: ReadableStreamDefaultController | null = null - let cancelled = false as boolean - const cancelReaders: Array<() => void> = [] + // Shared state for the multiplexed stream + let controller: ReadableStreamDefaultController + let cancelled = false + const readers: Array> = [] - const safeEnqueue = (chunk: Uint8Array) => { - if (cancelled || !controllerRef) return + // Helper to enqueue a frame, ignoring errors if stream is closed/cancelled + const enqueue = (frame: Uint8Array): boolean => { + if (cancelled) return false try { - controllerRef.enqueue(chunk) + controller.enqueue(frame) + return true } catch { - // Ignore enqueue after close/cancel + return false } } - const safeError = (err: unknown) => { - if (cancelled || !controllerRef) return + // Helper to error the output stream (for fatal errors like JSON stream failure) + const errorOutput = (error: unknown): void => { + if (cancelled) return + cancelled = true try { - controllerRef.error(err) + controller.error(error) } catch { - // Ignore + // Already errored + } + // Cancel all readers to stop other pumps + for (const reader of readers) { + reader.cancel().catch(() => {}) } } - const safeClose = () => { - if (cancelled || !controllerRef) return + // Pumps a raw stream, sending CHUNK frames and END/ERROR on completion + async function pumpRawStream( + streamId: number, + stream: ReadableStream, + ): Promise { + const reader = stream.getReader() + readers.push(reader) try { - controllerRef.close() - } catch { - // Ignore + while (!cancelled) { + const { done, value } = await reader.read() + if (done) { + enqueue(encodeEndFrame(streamId)) + return + } + if (!enqueue(encodeChunkFrame(streamId, value))) return + } + } catch (error) { + // Raw stream error - send ERROR frame, don't fail entire response + enqueue(encodeErrorFrame(streamId, error)) + } finally { + reader.releaseLock() } } - const checkComplete = () => { - activePumps-- - if (activePumps === 0) { - safeClose() + // Pumps the JSON stream, sending JSON frames + // JSON stream errors are fatal - they error the entire output + async function pumpJSON(): Promise { + const reader = jsonStream.getReader() + readers.push(reader) + try { + while (!cancelled) { + const { done, value } = await reader.read() + if (done) return + if (!enqueue(encodeJSONFrame(value))) return + } + } catch (error) { + // JSON stream error is fatal - error the entire output + errorOutput(error) + throw error // Re-throw to signal failure to Promise.all + } finally { + reader.releaseLock() } } + // Pumps late stream registrations, spawning raw stream pumps as they arrive + async function pumpLateStreams(): Promise>> { + if (!lateStreamSource) return [] + + const lateStreamPumps: Array> = [] + const reader = lateStreamSource.getReader() + readers.push(reader) + try { + while (!cancelled) { + const { done, value } = await reader.read() + if (done) break + // Start pumping this late stream and track it + lateStreamPumps.push(pumpRawStream(value.id, value.stream)) + } + } finally { + reader.releaseLock() + } + return lateStreamPumps + } + return new ReadableStream({ - start(controller) { - controllerRef = controller - cancelReaders.length = 0 + async start(ctrl) { + controller = ctrl - // Pump JSON stream (streamId 0) - const pumpJSON = async () => { - const reader = jsonStream.getReader() - cancelReaders.push(() => { - // Catch async rejection - reader may already be released - reader.cancel().catch(() => {}) - }) - try { - // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition - while (true) { - const { done, value } = await reader.read() - // Check cancelled after await - flag may have changed while waiting - if (cancelled) break - if (done) break - safeEnqueue(encodeJSONFrame(value)) - } - } catch (error) { - // JSON stream error - fatal, error the whole response - safeError(error) - } finally { - reader.releaseLock() - checkComplete() - } - } + // Collect all pump promises + const pumps: Array>>> = [pumpJSON()] - // Pump a single raw stream with its streamId - const pumpRawStream = async ( - streamId: number, - stream: ReadableStream, - ) => { - const reader = stream.getReader() - cancelReaders.push(() => { - // Catch async rejection - reader may already be released - reader.cancel().catch(() => {}) - }) - try { - // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition - while (true) { - const { done, value } = await reader.read() - // Check cancelled after await - flag may have changed while waiting - if (cancelled) break - if (done) { - safeEnqueue(encodeEndFrame(streamId)) - break - } - safeEnqueue(encodeChunkFrame(streamId, value)) - } - } catch (error) { - // Stream error - send ERROR frame (non-fatal, other streams continue) - safeEnqueue(encodeErrorFrame(streamId, error)) - } finally { - reader.releaseLock() - checkComplete() - } - } - - // Start all pumps concurrently - pumpJSON() for (const [streamId, stream] of rawStreams) { - pumpRawStream(streamId, stream) + pumps.push(pumpRawStream(streamId, stream)) + } + + // Add late stream pump (returns array of spawned pump promises) + if (lateStreamSource) { + pumps.push(pumpLateStreams()) + } + + try { + // Wait for initial pumps to complete + const results = await Promise.all(pumps) + + // Wait for any late stream pumps that were spawned + const latePumps = results.find(Array.isArray) as + | Array> + | undefined + if (latePumps && latePumps.length > 0) { + await Promise.all(latePumps) + } + + // All pumps done - close the output stream + if (!cancelled) { + try { + controller.close() + } catch { + // Already closed + } + } + } catch { + // Error already handled by errorOutput in pumpJSON + // or was a raw stream error (non-fatal, already sent ERROR frame) } }, cancel() { cancelled = true - controllerRef = null - // Proactively cancel all underlying readers to stop work quickly. - for (const cancelReader of cancelReaders) { - cancelReader() + // Cancel all readers to stop pumps quickly + for (const reader of readers) { + reader.cancel().catch(() => {}) } - cancelReaders.length = 0 + readers.length = 0 }, }) } diff --git a/packages/start-server-core/src/global.d.ts b/packages/start-server-core/src/global.d.ts index dd9048293e..8d15f8c211 100644 --- a/packages/start-server-core/src/global.d.ts +++ b/packages/start-server-core/src/global.d.ts @@ -7,6 +7,7 @@ declare global { TSS_SHELL?: 'true' | 'false' TSS_PRERENDERING?: 'true' | 'false' TSS_DEV_SERVER?: 'true' | 'false' + TSS_DISABLE_CSRF_MIDDLEWARE_WARNING?: 'true' | 'false' } } } diff --git a/packages/start-server-core/src/index.tsx b/packages/start-server-core/src/index.tsx index ca875c8a57..ee818e0cf1 100644 --- a/packages/start-server-core/src/index.tsx +++ b/packages/start-server-core/src/index.tsx @@ -9,12 +9,8 @@ export type { TransformAssetsObjectShorthand, TransformAssetsCrossOriginConfig, TransformAssetResult, - TransformAssetUrls, - TransformAssetUrlsFn, - TransformAssetUrlsContext, - TransformAssetUrlsOptions, - AssetUrlType, TransformAssetKind, + CreateTransformAssetsContext, } from './transformAssetUrls' export { @@ -35,3 +31,13 @@ export { HEADERS } from './constants' export type { RequestHandler, RequestOptions } from './request-handler' export type { SessionConfig } from './session' + +export type { + EarlyHint, + EarlyHintsEvent, + EarlyHintsPhase, + OnEarlyHints, + ResponseLinkHeaderEntry, + ResponseLinkHeaderFilter, + ResponseLinkHeaderOptions, +} from './early-hints' diff --git a/packages/start-server-core/src/inlineCss.ts b/packages/start-server-core/src/inlineCss.ts new file mode 100644 index 0000000000..249b7f40c8 --- /dev/null +++ b/packages/start-server-core/src/inlineCss.ts @@ -0,0 +1,31 @@ +import type { Awaitable } from '@tanstack/router-core' + +export type HandlerInlineCssOption = + | boolean + | ((ctx: { request: Request }) => Awaitable) + +export function getStaticHandlerInlineCssDefault( + handlerInlineCss: HandlerInlineCssOption | undefined, +) { + if (typeof handlerInlineCss === 'function') { + return undefined + } + + return handlerInlineCss ?? true +} + +export async function resolveInlineCssForRequest(opts: { + request: Request + handlerInlineCss: HandlerInlineCssOption | undefined + requestInlineCss: boolean | undefined +}) { + if (opts.requestInlineCss !== undefined) { + return opts.requestInlineCss + } + + if (typeof opts.handlerInlineCss === 'function') { + return await opts.handlerInlineCss({ request: opts.request }) + } + + return opts.handlerInlineCss ?? true +} diff --git a/packages/start-server-core/src/request-handler.ts b/packages/start-server-core/src/request-handler.ts index 58d0682073..0c491e00c9 100644 --- a/packages/start-server-core/src/request-handler.ts +++ b/packages/start-server-core/src/request-handler.ts @@ -1,14 +1,71 @@ +import type { OnEarlyHints, ResponseLinkHeaderOptions } from './early-hints' + type BaseContext = { nonce?: string } -export type RequestOptions = TRegister extends { - server: { requestContext: infer TRequestContext } +type EarlyHintsOptions = { + /** + * Fire-and-forget callback for HTTP 103 Early Hints. + * Only invoked in production (when TSS_DEV_SERVER !== 'true'). + * + * The `static` phase contains transformed manifest preloads and stylesheets + * for matched routes. + * The `dynamic` phase runs after route load, is skipped for redirects, and + * can contain route `head().links` or empty `hints` and `links` arrays. + * `hints` and `links` contain only values not emitted in earlier phases. + * `allHints` and `allLinks` contain all values collected so far for the + * request. Browsers generally process only the first 103 response for a + * navigation, so runtimes should usually write at most one Early Hints + * response. + * + * @example + * ```ts + * export default { + * async fetch(request) { + * return handler.fetch(request, { + * onEarlyHints: ({ links }) => { + * // Send 103 Early Hints via runtime-specific API + * } + * }) + * } + * } + * ``` + */ + onEarlyHints?: OnEarlyHints + /** + * Append collected Early Hints `Link` values to the final HTML response's + * `Link` header. This is useful as a fallback when the runtime cannot write + * `103` responses, or for CDNs that generate Early Hints from response + * `Link` headers. + * + * `true` appends all collected static and dynamic links after Start confirms + * the request is not a redirect. Use `filter` to remove links that are not + * public and cache-safe for your deployment. + */ + responseLinkHeader?: boolean | ResponseLinkHeaderOptions } - ? TRequestContext extends undefined - ? { context?: TRequestContext & BaseContext } - : { context: TRequestContext & BaseContext } - : { context?: BaseContext } + +type InlineCssOptions = { + /** + * Controls whether Start inlines build-collected CSS for this request. + * + * This only has an effect when the build was created with + * `server.build.inlineCss` enabled. Defaults to `true` so builds with inline + * CSS enabled continue to inline CSS unless a request opts out. + */ + inlineCss?: boolean +} + +export type RequestOptions = EarlyHintsOptions & + InlineCssOptions & + (TRegister extends { + server: { requestContext: infer TRequestContext } + } + ? TRequestContext extends undefined + ? { context?: TRequestContext & BaseContext } + : { context: TRequestContext & BaseContext } + : { context?: BaseContext }) // Utility type: true if T has any required keys, else false type HasRequired = keyof T extends never diff --git a/packages/start-server-core/src/request-response.ts b/packages/start-server-core/src/request-response.ts index f8de03aa56..e0ad8a336a 100644 --- a/packages/start-server-core/src/request-response.ts +++ b/packages/start-server-core/src/request-response.ts @@ -122,7 +122,18 @@ export function requestHandler( handler: RequestHandler, ) { return (request: Request, requestOpts: any): Promise | Response => { - const h3Event = new H3Event(request) + let h3Event: H3Event + try { + h3Event = new H3Event(request) + } catch (error) { + if (error instanceof URIError) { + return new Response(null, { + status: 400, + statusText: 'Bad Request', + }) + } + throw error + } const response = eventStorage.run({ h3Event }, () => handler(request, requestOpts), @@ -147,8 +158,7 @@ export function getRequest(): Request { } export function getRequestHeaders(): TypedHeaders { - // TODO `as any` not needed when fetchdts is updated - return getH3Event().req.headers as any + return getH3Event().req.headers } export function getRequestHeader(name: RequestHeaderName): string | undefined { @@ -284,7 +294,16 @@ export function setResponseStatus(code?: number, text?: string): void { */ export function getCookies(): Record { const event = getH3Event() - return h3_parseCookies(event) + const cookies = h3_parseCookies(event) + const definedCookies: Record = Object.create(null) + + for (const [name, value] of Object.entries(cookies)) { + if (value !== undefined) { + definedCookies[name] = value + } + } + + return definedCookies } /** @@ -296,7 +315,7 @@ export function getCookies(): Record { * ``` */ export function getCookie(name: string): string | undefined { - return getCookies()[name] || undefined + return getCookies()[name] } /** diff --git a/packages/start-server-core/src/router-manifest.ts b/packages/start-server-core/src/router-manifest.ts index d20be26942..5431b4ec58 100644 --- a/packages/start-server-core/src/router-manifest.ts +++ b/packages/start-server-core/src/router-manifest.ts @@ -1,38 +1,42 @@ -import { buildDevStylesUrl, rootRouteId } from '@tanstack/router-core' +import { + DEV_STYLES_ATTR, + buildDevStylesUrl, + rootRouteId, +} from '@tanstack/router-core' import type { AnyRoute, - ManifestAssetLink, - RouterManagedTag, + ServerManifest, + ServerManifestRoute, } from '@tanstack/router-core' -import type { StartManifestWithClientEntry } from './transformAssetUrls' // Pre-computed constant for dev styles URL basepath. // Defaults to vite `base` (set via TSS_DEV_SSR_STYLES_BASEPATH in the plugin), // aligning dev styles with how other CSS/JS assets are served. const DEV_SSR_STYLES_BASEPATH = process.env.TSS_DEV_SSR_STYLES_BASEPATH || '/' - /** * @description Returns the router manifest data that should be sent to the client. * This includes only the assets and preloads for the current route and any * special assets that are needed for the client. It does not include relationships * between routes or any other data that is not needed for the client. * - * The client entry URL is returned separately so that it can be transformed - * (e.g. for CDN rewriting) before being embedded into the `

    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%0D2u!T(r-B!7~WNJ?-O`WOE8yaPg?pw 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 literal 0 HcmV?d00001 diff --git a/examples/react/start-rscs/public/example-guitar-superhero.jpg b/examples/react/start-rscs/public/example-guitar-superhero.jpg new file mode 100644 index 0000000000000000000000000000000000000000..3bbea2743d954514db5deb0f86e0f04bb66a8890 GIT binary patch literal 789823 zcmbrFX;_k3`0yW=Sj?2AMGKV#AzNlxS|ClZNWn`2R8#QIrG%ZuyO~u#u`oACE@BhOGF0SW!?sIYAoacV--|tL*nzRC_ zpa5O~00IF3XzB$_HUMj;KK<|7{|)lLi!gQdq!B0`dgFXb=Pqnlu3(006)s zQ-`PC|EEEq(_nA}2#f?Arca%)5e0xC|F3}|Fc2^g1csoY)8@l4Q~>Uez- zo3&a>(990I>M(~$4=;=_d)w>cwNyr0qy5k3${{b?D7-dzMazQa3HQsVg1Sw02mk*& zof<9h|8$I;I?P7{U=Vm37z%++gFwJgz!?NaL*@fe4Ap+d`0%)NK;9wagKo5?yw6<{Z-Lst6}gSfpM zcMt zHm1QLHM{oRE7=9_hj%0(40}UkNMoSOLRQkL9TQ=nlY7Nlfq|lplt6V_z}}eRaV%iH zlOZR{J9yjS|5yvWzpSN7*wo_Q2rBM#>7lOJbEaS5-2iISbqtJz5qby>^;`b@?cmIk zAfD&MrRVlByWvl-gIjO4N4FvBk8W#>a-XoFnlH}IZNtRs@s(vV{OYGQkkS7x<~LU) z;7wH&rn~c~M;rL-Q$t)RKT!iDJr9I2iMUu&!o~Yl4jL<(Iq!Kte1y=4bnTdL5VjP4 zXZyV^b(hk7HR~_U|0uymcOh7EBzfI$|mN=%E*SDB6{Ji67H}&*zPmQm0UBgr1C(|gz zA|E!lJCVoDzl}{i^{7$yvc@L%r;=EsNh39%Fiyd+kZoEjWd))o&g@PJq@_}!ykdG( zo|wonQ;X5x#mhgrwD#M>K_*vt&$#Z*)irc;BXZPn;&~qrXmNyOJ_rU-bXgWAfRX@} zL$RAo_0+DM416aDmA3O<^+N5LSrGBw_ zt1oy9*vjBI!jPVP02ZIGlZd77ZVL7;*l}=SdP4NOS1GUX)ld_HYH||hcfEPFGa1r$ zGiLDTvk5t`0+5X5zV{j%*2+ zl2X62eI{oQckeue;cSXq+JgON1&Lb%O^8D`s{)H*A97<1(_LX8`8>871{1iF@s*ty zwq2VA)uIr-ZjAsN8XVZ)@g4H>YggDNS(u}&;O3U)Qdy#@kFF(D2|tqKFP+N)2gLG` zV6F{{W@dJ=bBZLJIe$lcf~tbxp6y7a$y3-eb# zYvY?^j1991d)-ct)h}-`3OpS>%H*sT|1rVnHxMCKby{GC3D{-SG8&w$UlpBHLDXnm z(D)IwbrQ(DuhGKE8KW>yPGo;Y_{#m!tIQqpsUN-8FYAq@Ry#WPlhMVj7ALN5 zh^e2brMn~gKc>rx!3-=D-p6GL@ce{YVm<$C;}8F{&7~fGFaSNKz&n-Ky>4xa`-)XV zLmHSkqXL)M-*!};sIf#Dt?5QnK%#l<=v}|~q$&uBjbWHZ#zNep^t4#VNq_?4k*h4R zk=?6i@HuHKq~D3-rArFJ&;7Lo*FE=GH*43ER;YNS3hPPn3_GiCK8uXW;M0|X-=@<=|VvBaCESvDKM52x7TyI zdd3Y-Of<`%eoku2^5_|lfQpcrj)N+b^0U&Vm)p*QPXd3g9P-!TL;~?7z)A^e(616^ zSlFh_aL>45SC169Hu+A3Cy=$|E`4MtzuG2kYH8bZvVO@oVa3on+dYCAoC?vmlW`dV ziHcQ%2^A)gU@xtY7b;8wn~N-vio*$jNKYprBkQMG3C3Gmm2?u1P6M^VX|NOCqib7+ zVMI=IseLOMNKT!nXzXVF)gUAiN5F_Nkua+wFpJfChdq{nMg>A~CPbUrUiX3D!JK$u zuBRGmum*F-9h|BrGYKcMAZt9d{+VgRb9|1M;HOJC+xw2UsSux%dD@7#*b@Df=i3IH z9EH{NvN1>hw2;wn^bBbcMdVI4x(hst{6@avAmoWcS1C9t5Irpacq4TXL1$!40t`vY z3y+qWD3~#` zt9N+C#xF7j~;ze^gN#!-Eau>vOD^1dU6`s)ojl)DYJgI zQ{DAO8G$7Trm?M&dUNKp%=oE$T^uI0BybW~npx;^SfDYX!ec`)B4| zG$p0tovE;d@d{6%1|vW*bQKW@NKK|PXI|9)(VeL~QZB;JDu?H(r{(p1kBp`MSL2FT z7%60%MF@?9j<{M9jTSqg<|IN#S>pvFciL1kBn6yZ4Vm;-($44+ImZjt|to?H;Ib6qPAF_6}p9v0O}SYSYR-0gq~LNfIjUT+I;tu15vJ zwIjn|AaN=LsUPpe8Qd9@K)q8El9jaz(Ue@nDi}64cdZ!pXxyG6PWUZD3EJa5qUD4W z#*)%YeT8ldw&qm$g~598f|_on!3ti<{oD0O&N<_vAyYTWZ%vJFoGIr1vQse`j z@wY!f@JyCp++(Je>B=&~853`f8SzdlX`d>=ba_@0k3p^Qw?}4&BKjN?n0Re)pbSP# z!B2I8Kb_;hNl%pRT}$L;`LcCw1L18aRgl6VR_Uh~MfCtw;s;66Lcz`z_!*6^dTW(+ z_}jqMN#KctGdJs|SL>6Z%+{?#?ff36Da+Vgf2D008*b0Pa^>Rz8WpZkNF7Jumar#)*B zs2@nlzOh?Z_tEF*B*6de$Ft}8&+0GVyUVnvr?r&sJhY41u-%QC{ODMb^jpH?lrQnm zb}gH?dBw_uXLJ87Y8+8uX} zED6nh5&GvJ+lueid;hk1{TgNTm7;pCe?ZfnKVrOp%zQ3S4mh}d`umDoy_X~N9v?ja zZTqE@XK$PvOv!$tJe>Gy7xUJhTledK%={VulD~h^<(%YANB5cyd281nNPS|$9kmSA1=>*KlGz^W8Ltv4_EvTKi+X< z&%V^ZKJGcRv?k_ocNgp1()?oI*TSrwmroYet1s3sn}2as@j5tv$DE+^U97!_8#0pR zYx0)nBBFC|9sRL-)omK9cJ;g3SI-R>a@44xu*|!ktvhi8@`&4xn`h?jYOcRqa5G$U zq`Ij2@UxZgSKbOguyx&`qhnVN;^G?iMt+6$R67=6lY$zB%;! z(vfvLL5psO=cQ8SlpS>#n5|vLu~6!UZ*I-GbLoc5#lsI*t^N&qYVl!*mo_Jl4XM{( z?_1(<@T5mq-^Ke^avyFiel$0zJ38(mw)e{*Pj zc>SR8Fn?yq!yUZn?7Y2yuC2RYaJDd;%MZIqEqxuk0ZTz#Kk#ZGvvAP zC568G`n_&W0@#J1eYJo5y7@t8;QdAIuOytx5;>5d_=9<=Hv6xG2X1swB(wZNkvsFj z7N>kYbZIrN^GD=Y)|T5*+Y6c=)fR0z|MA*m-QUBruLzqx<_f-?{k-P++py3}7jtrX zoFe^p{_WTwAHOcT*}Zb#=Od+CUhm33-1D|{b7Xg3bU|N#ed%wXU1tq^IQ=9hzWww4 z)`K}mZQLUFgXgBNJM1$E$zQsm;CHvYn|ptu{WIsm)phF-hf8j~ERvk>{_OsuGHA=} z6^j=g48#86mK&YC@dwxx6E%a`oUfGnnUh1r{#4phlcEANr(Q7`CVM zd-s+t^;hOzf8XsByrp4t?40V4ogZquryuQ}etOlcfQ!2>wlvg)&6$^XG*23loy)MAKeiQxJomo({V`j(0h}`hMUdI2GdviS| zY+B&p^l9Z^LT76)pL4hzHfK}j<4v2cUfg{oJ^XU;Q@5WdymDuyeuz4>Zr!%>*{AZC zOuM$V1j@*E4veXOyYR`joBSQkQCofL&dpiyb#^u`uYP8ZPf*aD()|me;D=X(LVm%H zL4F?_-LhO!H4=N*Shv%k!gJq73h022)^BDLBfabLxuTt27c|p{_mKW^-=_t%+0;W_ zPcN+8Xs;&Szb5$i*@ofcA-B6~ThAYF=t%7z$n|=d3;p>1>+5y<53GN8^TG2Q-w{W` z7}x%^wtzEQJ-YsD*u!}|x4ZsvGiR4&&ygchZ3m$TFE@Oycyj3R#b0J#Q#5QZdDC<< zrs39W?`^ld?o2FFHBAEf55h|C1|85oKD+<@{hEzO{@(b$Gx^s|Nxt2_wBXk|2lJ~{D$fog>9QDo3(wjuMOXS&mu6GeWkwW zw)_g=Xh%VCOT;Gls5N{h9%0Q4Xd-IfX!JlnemkjBufA zRlg*o)kTDfm{wB_ln%K4!Kj~y{+>LHOA-GPK?@efK+7Oy$ZDF{9Nvudu!rN-lt-XE|(E*eICr&?IiSboJBS$+{ zr+ToZI3_j^l+2w`q;esrpqt#SCRi`wK#0NjHha(!JjN@!O9h{BvHVO6Hvsu7bw`}jcgRhA_Ogm1^UN>Yhc6^;WT zIvot8Y-M#`uft-KM}BhE*ERb z@DcsEV3fjUR-xe@S~#;^BuJbDuAbTNygYKA&OLH;Ofd;Gkgx4BmyGw$C`&hE9%3Xp zoPID{PD}KVd-6xd_`vCPdB>nyq)BA7LTIcCQ6KEO_s>oGD(-nbl5Zro#XCWD_|{C_ zF!cGgnSwi~(J-2)KNFL(rhB}7LbYVcb#8Oq{KTIrKNg)&yaggEW`pFGkiu#cJ4t~yc4UY+t=SEO(b%^{FlmrcCncWWQc=AG7LpmoMd0utX6(icL={V7E7 z$gygQ$XZ#|BF0ut0;^W|OMk@R{Flpr{&Z0-vF0mU7=_)%Jq_@%0IPF11`|g-mmQAp zAW>T)@T<>%2aDKS$ZZQ^Er8-kiT&CXBj?DO zuHb*CF0fQM0U24OBn~= zqs{zH+b&x`;vfD!Ma_A)-b}>wmAE~cV8CLx8&W>6`2{q#i)W+F#Fu68k(J|_D=%qn zC(h!dhRUX9hnhe+mgCWqlzFw59qPL}&!w8BVX_W)=-&N(c9`Pbq$R=>9Xnjj;p!i~sqVRAM?57xV8ep6QPO5gQaw3Sd<# zx&p56?&6>q28HSHkpQl;)iXGLg{X$Vu0N&W8`T5PWdO232vb^RU>&%$K6j8A6Y%cz zy4ZaBRHY|^i|6Sp+xY_-g}vWCY%9d#wn^PvT0hm?aJmP(vYb#z`UoQ*GNn{yFc$2| zio2kB5|_>(f;28;RoEKhk)!7q6!1cAk1cf10TIoj1n;*Up3n%i>x38ZtT2wG^_nLDCnii*bO9&n6`rE-P;Gn-dlc; zwIhzWmvqnHQ()ym7*hB6SR{ZGh)JJ-X(kX9B*&_=1C>?QK%LvXJG`)*AM-XL>v=Gq z8Bk>Uw}`z~VHZMxctZ;t6{&@4$)i>9G=2PZSG@)XSa<&1%}@X6jPJ{y1THrAc-)QZ zwb$L6zHj{kevT}_zlEO;jk1+KXszz3B$Q zu_(#B%YlddS;1}pU5~qPRlp;}qByP)8pqDD*qCUS&!6fGOs-jKmvrU0ql?W5^ZOih zq2K~uIeM6=^k|I(`~fXU!p1T?PoEIYj7GMABnf7!3t)h1VJW8f9ol_QfRiAx-|xp; zCVH@a=gjs!b?W7w$0vcsUH}7e@)WX^whsB*pPPBeakL)DNK`^&nHh0!S70A* zkha#~dG2^SSFX$~-nWA6(-&2W!-|2&0n3f&TZ5(zJL**1Rx zREsxxv|*)K8rh}A8E^?;lbn%d(*nE8`FuIlHcWpj2z$WKG0vwTLM1nGGN?Y21;bw! zMRO?|T@8e(>CO_Lva{RaVKYbnjKHT*_diTuF}gROi2VjHO>OqEF{+?W5rjB*fWk*> z9nmmW=E~3PD2kwuFm~V9l?J1+wGqs33#}-M16SftAS$7$L~&V-TSP!P-&JD^PDmq$ zV6Km3eF-}@Vegh1r?K)>-5V>7o%sK+Kp%yFnqe>7sm2M z!WM*`Xzg#43A^7&1OO7}QsXIf4?y-Nxl6f_Dbf_uh`KZWy9kVTC8Kcz0ztSF1(rI9 zv<8ViQd@HsC7P6&{psgpQqACsRgQsn&n4gbJ%{F0RGk);vt>vl9#N^nBtcx#i&tlR zu`M(5z6V$V7$H_SqHxtikGQ{O;A6QH_n~Z$w$Z7jU;gH`EG(qkQo+xd2E+z%G=QMY z_Et&y6@5d{6YVJV?e0ER@lh-8uJOz0mVM)JztGg16%~ATO`l+)W5fyacKAcixso6g(6SDHpfu`QT5-P@oy$p%I>w2WR6bf4HZal;qPS$z-w z2s7i(Dzg50|Nb&3=bCpZxV1BP+USE-TuBv z`XMT*rh(rmPMthd(0wN^)MzqAcp?D=X=ciRQi**~GuwdishFBYE+wV-mo-%IvF@gm zeCuA^LKp}OQMjU+)Q<1Ys}5`WWK<$gEv8EFVwIMw5*(Fi*`f9GnSAvofN9bVxoF@d zq6p$LpN^t!u4GcJH4PR_;-)CE+Z7 zsMQ(^qH*2ajuPBO>8@#xXd(hdqE}Pj()6E;m|1>wKwm{nlImNp(fE-4*yzLDEFrGu zuuEhA-sG{}>n8%N(MujV@@%?lPoxc&BnYQdYrhl$e)trtAlR8nG<#G8tPCKxU3F;` ziK=}49q>ARrgN6p?s{hnUrIt&nKeusP8P_!?v976gOFCJx#3Z~Y6S5vRp2Gu=*#Z}4~=02yu zCT@QnCqDcapL6CR<3`hW7R9fyIj*or6?uLXoMK{2K!z%oj+I$d+3pz|0`Ud7V<--o znYq#^OF}R+JaB!E9WI$kgRL%-5ENZL9^tPJkG$I5n38!ty*Ku$xWfdhqK^lQQqx4Z znr+Y)o(hdO`-&OLbo=mbbqG{VRg)FWjC54WC*!$CjTGNLI@Z#!rA#3NH+TExlpYsP zVHf;e#Zo&k9_dMt@H)oZ!;=Y6ur1Uy;t@?>hm?@!+ySP9 z!(k!hOC8ajr?=$XSjgLYUv|}#qlHR|kRcQ=<3?m&UsX%Qg1qrt*`;=CDu3Co@(s7z zj5F))IqcF$FK@+70yl~`)*-X@G7JWun!`W!qpF_R|87_Q(9Qe)NZ4K%9%wcGhGTg; z8Rd*Rp8_9)`Tk!^_USQajbnPm(1D^DXUx+n;`0 zt!Q9)q!!{s-_M8N0eSF?J+DoaU%KJr{8}$*kp4DMx#QN4(SkED>1c{yG}kX z5RXj)sxseJ`e^5thx>wW`D@w(FCRF*IACIAJX0=}rXeUCxg^1r4tF)vgawtFEL37UgO%v9 zw}m5K=~03gGL;6v;$a(iOkA80lXD^;uPk~YZsW}VG-rHDf~%^UX&cds1_+Uq#IXc&zb8T#iNnPc*+d9F3TJVeVsO)n zpaOvrw1(n0+SZ0N*yGX?hCeefG_eBeM2htdG}koKKiqT|2`mW|Uj%+sQ%M~r6ttuS z0&Q}-hZ+f&+65!BuTT)__=J5Tma6eX@Gt_l3(a4tjSy3WqhDVLu*06qt-{K!KPok9 zx>j@qBV@K=c=qojR)eY6GaL?g<&iP-*AOt`&ouv0v0URJ5ys7KN$!^Uum>bd4tRvr zInP)TwCC1-r`3Pp0j}rrO6GhvmSN%y3K#4cTA*Dn3DuNC0gPz;yqJt{cZwIRS?PDh zYkdK`%tsphmf=EVFLZ$5oCsByuY5Yg4Q>JNC3<|;)tImk5?^r}L);FX*hM+-s>I)$ zZP0_^3EdU+D{BWgueG|c?CH3lsY$57pQlByjKo>QsX>osqrv+&4v(R0S0xUi3aZKg z8RvGnKoCT7>eRD3axcfmMHd8dkq&gZ*562!f+?J8Arx~tY2%JFpbJC`Td5U|py1tA zvVea{5u0ea?Op+GGEcbsNBW%lPYS?xfujbxPs)YBv5p3G^4o=r!rtYmgA`nRw1->) zIowJwLb!HncK?SY95DS@2-FN|7GLW+KDDo^iKhA zA*2~lDaW-*X(E^OiN9?4S6NIOnQ=T*RH zL`!fy(LG7ThNP_=#-&Q_b#~tx=2*X;p!a#oCG=Zj3E)I6`EDZKwSN+LtzyG#8r#X& zNkjC+0W{k0%Io5$xANUh7ims!5XHjc(xii_<_1rsONKT?XUq&-CHw&=CVJ@G_J)ax z0r81&p+(5j49T1g)(J}=d|L<3KNGI^K(3KDJbhWev4^=n=$}x_p!;`E^Y3?v@BUX*3B$^vl zk-dZp(g_>AomEB8B4@a=#*JB#1mBQWKaqyy>(XZR?+ic!L(+LRY&Y?B#jG)VR%vIt zu-6Gt7$8&pQE-(Vj3uz(7UuqVVuU z1H;U7AdR7;Iut%p-v;G}XC@6bf0-aRyJR?%m87H*Tn9F73go9bg^bDR&;aJSryRnL2X?2*ux!$olFuhVwRv|^Ti|4m3PBzM=E%=b8U_RG6 zFg$&_0E3?i+=*DOQ}|*6BDj7@mVXR6FErEv_r_yw!{u{9vx~{4^Lk=Be}7Tsle|BtXHbjmbYfvq7Wb{=NXG&$n{ot$Wf)XIQpKQG;SbplY5LFA~a}$g8~W>Vfw7 zU?=$ajm;K!VJ5{@*k0PRzq>g)ve^NE5FR8IOcXweBomQVX`hagWTqfgHLceRk}j%) zy|y)Ah^yn1M#piL6Mz(7j;_Dd6fen-^UHHA+4Z2oK)=%qc1BzIA zuLIWLAspS?9J2*0iB;mcs99>Lp@J6*AT=_d;;#qKGk@+skuJCzH23Vs;p;w_(&)kY zw_y)%hO&RdcmI-8@gCS})cKOKp}F@Ekd~_z{tmv^%~rKD>_pGqt1D?!0^>jVUx${Y zew+k0l?Gj`t>1!ux?%s>%hy(1d4=4(^Tl5B7f`Ij`k~+-GN(#>%(V0I$FUgUm*@24 zEy24a>Gb@ky8|jjC*&}D;qNPMcT9z;x!slQwf^B?^5~CU#HYF52M)@*7QC5z+WWyw z2a$5!ABR?Nx!OIWSYGRN>ExCZ9)nTWJHO7!|7-Z%2LAgQkIrme)RmbUcntphO2fk& z??e7>+#I%S+36JvHwI_LEn8X*`x1HLtNHe^ut}i6dBX)S|J=LpQpM*_GgkP9UO5oA zfAN@d`@5h}-J?U>SA$LyCD-4j*E#)OG}_?T^Xco1J%c+w9=V+RkWo{c`|8BoPS(3W zpSAz<*L@=|aRBcXbMqJ4uKf@0#$Jv7a4c8TwOK{|NA$PhUP07)?S@Q119O&uD4z$i z9v|E_>+%iah4+7U4k$y9rp_(!HQ>Rg%HNau5+TnsfMM7WJh*JyB(QHfZ`UgA^Q-e0 z*N})qLRbvDs^< z(V~8`>OgykFLOtidVkv(e9C(vI}BVji-zmG-IaR3`dIqbu6f^%rQ07Yt8*S(6n!B& z^uRwOVnWz~6+3n)lmGVL_GSI%4A{b~TYo>T1z$O)9G-Q2BJjkaAMisHi*Nrn39P;I z{)*x8@bNvn3*27Z`{i{~?ZCxzdm7UDMW0C%_OYCUidRE+Ku1V{I&h$$t}4zKF9(8>=8TEYkE=uITk=`)^#L=PyA4<>cU4J{4 zgu!&>{=K>6<-z9iK z$k^Ef@R*W$K`UubqShTbK5J!OR@B&+4>C>h?EafM>n?B?U92i$l_HAb+aGbjloTi;vU*^@Xy$}+#pPD{o$A> ze>OKPY_As^*j$3r68^ecyn1lStA@34oA=S*pUD0AIrp|#-nMIY`OekPE*YHXrypJ5 zv*nbYvVw3RWZ6VqZAoV10q9fQaMZK1JJ;|fr+Dvx#; zF#xU`_Q``382jiIT%sdC-R_PLM~k1%Ocr)iwdf@ATdeAR0u^B!ubf*sCq#-2-=m`?2JQDksEa}7Z#aL>`=~PWera`P_Jb*lCXdaGPEqpYd9Nw7F zkRUVnItod!NY^RnAFXdS`_~YSu9QG)1p*T{#XF048!d5PcuZH_!1l5fpx^z+^iY#Dn>JvG$`cnjz z5Cb}$`Rx^msk8wpBnl_Qel67{?I|UE3L4k2x|LcE$k2&bb9RoUxJ|GY&r0tYNbi=q zLvL`Yct@-iZLEB#i$kS zA)jj4BbI~;9_o&v0>+YBdZ!5|fn|?${UIu6O__U~6({vI^JWto1-8Ytyy6_REKRWJ zl%=1_sur}zrsZfKs?s&u*pNyb+H7MPA-S(`4GoM5Nn{(IOeeZii&gE3olAJ2m*AP$ z9~ft=>qNFlfcA9<hhaY*Mt*UEt(6g=uko`;YP#gsdbyekYF@UQW1-)C(eRh{%kFr+5Wkg38 z9e~i%f)n07j5!dzL8jGSAf=Xc0~~NXF&zgo32#2a7P!tf#YC@obj}j|>5nV5uE-T? z5&PL)--MDLG!X9nl(z0{J;gy~w4^dMj17H`;!fozIWY=l@RtMy>XjK-tgD@TGi;=6 zU03iMuR!>)i%+&|nWckeHE(!dR`@KG&ScWb<;7f8|2VSi@0IFp<`q9>ya{+z!CBnj zvfC$Tp)2vmbY64+U^H+%o^r>(*OQ<$kH3lhkx=`^v$_^9Ej|`bpL&+^6tgPRV4)wD z-=deH0GH2_l-~&MvGgiP?g`fC8naObC9m z4Ph@H?kG+2&Wn?g9Cf-rcYHeh)gO|nqU*i|D7I$^B>*vs+T_>P=KOTRygMos*5pjZ zqi!10X})Dv@z=Fp(;4^${Zp=;+=4EGqM`lJnvKAsN^sj09sbl^Gx%adq4I2kW!nVd zgN+d)u9OJW2?W|*1=L?*ZSj|SuH@Z}*rI(ge>dJ^B*Qz#Wnqgc5TX~@3W^>9U@NT-(=j$2Xfy)ce)#P-0;v0wj zKCSaam}KlqHI>Nk^-WY6Vf?%sJAZjolmV#21gV`WnLpIdU{-Zews|wBiZh>y6(l^* zsOU?I%o{p)EVO7?jrp5sBRSiU%)Tknn|4RHHks8I_Ppbj|M=-%)hCkDS250or*^Ko zj;OzopIA=TM(`GrILLOt&^VcI)xx>Iz4t8 zq=EC=Kol)UNyd0W*+ksHu_D~o@xK?!aX20c+MD{B+{bpE0#Eqc#{!#W2|oPR7XP+^ z8)Fvayt9Ggp;3RTZvzPNmVd6r-a;uAZg0pB3fL&o2eXNoK&XqaNdAaDku`^yyWY!q z-6q9r<0(iOPpQ&DGeY=_wzNIhCK|T>pn*I&6`oM})J}*wgZzb8!1(jTSil22FAquR z#(=DrqdtrMuXP!B6xDs9Cbl#j{{fpHf!sb&C8Z!&tSFiUJ}iF`mJ`I*hEcB3Nn{4O z63ol0%>48Ca)>cw+RYs0iNH%g%G42CVM zJ$?#E%)~M`X@yYLlwIzDodo`=SvQ9iWpO) zvF0>Rf#JJ5H)sAH>cI9XPN@|w8j?fs@lFAJId1S8oQc+Xa*P^3p<-*+&w+2i@~o^k zah)$qam!bEp7h}UtbUvN5&9k^(nA=POa&PgPXbH{zGvOzykUYH+%j}~U}JJR(`{c_ zW^hZk!}WC5l2?^b9ne9o*^UexM&c#MF@QF~s#C=W{FiY=Eoev&`6ky!ee%!ZKKu)6 z#ASvYE<@!@!u(o$(&8g!c%7yqaCI44msRg?tq$zy&WJ>vfW;DBXwD5+KFJlj8rz4l zsgSTuj={11%$jtgk|@^AOZ&C7rwBSk3SZ^aq%-YF3;yJWcN{;%)6$4jRo;ML8n?nx zc$J7D;H8h9UA54TzCgu@;ah-J-~vs)2Xbww(ZS`Jac|nDIpGyFKqBy`qdgw`(_zq# zT(ICkH+DJ6+)p7@2oKNPVH?KIHm(cqz6ILj!k6$e33M6%hqX-Kx1|vCPOXE0NR%)p zELLF4;OjeA9~VTaub8gm9G#}}8BRvKGw=OEA5T6P?cwQ3pHBl(%c`A&@Ic^Iosg&j z_oY5KY5m=r-l&coKKb80&MzcSo*GfEV@u@>}5B;H%sS?zek(c*6Nwpy8`tI2} zEZtr1a0`R1PXIW^stj>ud4x#caZTU~c6tNj$QV^sP!*ds=AMqMcY4E-;>BS92Bsw< z&Xb*{Trjgh1h5x2a@+-MAS3-z163M;c84@J4f}Ht4g{a^dsZdkRkf9fJ&J+;4 za33j7%?8JU)Cn#v+_c~jw<%Wo;lrqXw(;J*<@020T{Ourb=Rq`>qT@L?Hch0nRv^W z+z)M!IDrChoXWLIG92FQ;U z=nN;n@{~rYp(encZfN_$ukd$h% z`6A0H_+%vwFn2(~*y>bT+y~PnFu2A=Q?(VHUd5aQ#Ds$50kg7t{Y(OOdYh#W7Fl3a z2a9FYbeGITHK%{rynYzXQsd>{23;smyZ6Sf9~wX{>FKM;sz|EvYgI=ch7^yB)1J9h zHCTB4QsRW&h9Zde5_KMp)_ifM#*Zi<^$55LZ@OYt?hK9v7h!vX5i%`D5jp&LIR{Bl?o;0T0w&$;D7xTMroxhOu!3s;t1ELL~70mI$$l6f96X#9D zM;(WzCr$i%nBBGhzqT%O|A9S;c(c#x^phvLG8_5!*uRF2%B-l*VZk?1mV{vR7t27hr1 zV-u!q86<#(0*(fy@8w2&#V?F2+5Wn&hz}2rx!kOrnlEbrvSB&I_Tc2%aJK^Ob?xd1 zM>IaG!;gucr|4a|Zf9jx4Vl6nYtxvjI?$vOVFi@EKdNOX{O2IkLiMJjh&F_*5?@XMEBgN7w038;nN>y_s zjWVjjWs1L&98LZ3g8sHqjPOc%NP`)YUTQF!J zKY9soY8Tw`sPP0a_~P=$aZB>CpNM-alrA)c8m@&_5sqNd7Cqco?jE>9f}a?`N4JCpj^Ec*R!2~&3Zm`9IGbF#P%-662?A)KQL!gyzzQ^Rl@Ivc9_e?# z$w;;X#Vx6Mt!@=7Li{#D(W)%>DJhU7KoiqehUIWd4DeyH$^*y%8SnxZGLw95#*A{L zQ4VONMWBUaBPNJ_W$gBUot{eA4bSkm_fw&+#3_8185Qn-o;POZL0=sw|t>W`b%c2pLC%CAt%CQf@}w*IJc9YzHW^eriiR zXd{T>xtUt$_cHim!{IV&v6za&8t5v8s?Q(3%CBqgj&~!cq)d7rngM~2B}^$`+;98N z-`M!;e#*59enZUey4TMN^{@RN|04k5>uvX%^(xQg{fA5DZJieRU1OT51o~3S{dLOD zzY~sjtouI{orzyk>Ho#AKq8JQOEoy65ZolKW(1l-Lj^MhBQ>>sGc{>*&r)-RYG8&$ zAPX8?D$8uQOl_AU#l9wHW{z5tlBQEI`Hrb|5j`L`3nzPKK5tuYdWY>?Z`ZU$Nw<-U98-R&N19A{k;Y1a`U!;F zD(0=l@-sOiEIZSttKT!*aVaUzZiEpvTPn1U4WJ%<^kVWnMo4O zk6w*dSL1<{yE?|zj5I2yzy0yxN#?VL3@IpP;9z8AQOZBlGo{AxNingTAq66c&&Wyr za2H3WHs5zReFTW>VfIr&j_Y(lJ6;VqWMqlEZp1p$DcDF_rj=5SH>J%u3BN_8SItrY zJp6doWA3WbmZ^dMa++KQn*9Xy5~`dcW>$D#@moT#yRr6OsRxx7#*agIw4w*_@NV}haUGR}O%EHW9$ zk6E+(jlB^HZr|>m?r?C)$VYZFtN8|%Nb4D6|6qp5RJr2ndOY}vgDlLLhf9Q7OE#yc zkGMy8i%cU#Q#Z8+mSEdegvoG1p1v}@^P_1bG z48C5c3TBDkv4fGeae4Gg}j6!wxkwJp=`=Gs6_A2u#-a=t6zJBh}3847Et= zYk#OV+lHbbGvTs2iN5P1UVaRYT7LOP6Q88J5tRe*2#@MqTC~va-6=P~LtBj3nxEKZFjqB~@{&d2};*eY^l8>EBz6q(Ne5H7OR^F;F)e zs_tmyr)2PEVrjRbFG?0GKukg*6%6xK!&Y=;STcqTAchEhzCbyimu;n_r*>s~TX~xz zB6=V?wNA%1!fCZ&4|Uc63NF(S?5>Wt(Oqe?-*+CJQcZRAk5mVn1(|a+{7~WuWf+^` z@Jsc{=bxDfk$Cn|aThH8d9sL<>C3NzTI5}3hbFTqpO@Yb6{*R3C878 zAb=7>#kjkk+aLDWMYektb-bc-z0DsIwC_=RbZPgalzU!|p z&NfC<)1H;j=aPJ(fP2R8Ehxk{yg5qrX`8KxCSv7~Dc_Rwz1Zy`MLdQh@*}jrH9?Lo z0HM%UnaGZ>Vet$P(7W2-Wyt}qdKng!i%IJ4SWh4yiQ3pb5F4FVK3QjlxBr%L8{Yf+ z`*`_9+?o1MLv#zfpop*~YiZ>0!J0j59fZB>(}l-_Ufe9%`)YR_=Wef9@%!D}lPi+8?4r(kJSyR|{I2b@{;_8T_u+qscb6W? z%^!*kUcPFe^+m$yy$;iswl8^`{^SQEq`MmSeEg>aqgBMEzLvo5lP4$E0l!lC}>o;`w?jIbJRD5~u zRZeL7EqqtSmdlU+x_t1LO`Bj>3IcZZHq1766(1xV;62=$|LEcg#|wXMifQ|hSbu4* zAtk4>&!Mef#w{PCku-Q&i8XW zz8=})xFz$*MMS-X(3qc{7FrNs|Jc5J;}9G|zU$oX^hKARkL|Ls=dt~Yo7!kjzj zzwc1o`ryB>dug_>URfOT(xdXd{oilq#K%kitJwKA<+-SIs(C!-R#S89vJW?3z8mj) zcAgltu`#gSHs#dQ#@VM&AD5pypV*e>mAB&eyzc+TK1Dorxcv4@x6?jG^0ohtEm&uj zA9-;$|KvgEeESryJQtt6XAAO6ni}vrzfUvGao3+%=6-pzeI$5uSgvR1eP{8PQR23J zDWs-=Pb+24?VR)EfBrpq`$6;FPVDO)W-*AebJsT87jN#&EN?8Lw{9+P?u*UCC^ zTEpXvPj>F^k=_3$Z0U15I&b~|636q3%D?=!Z{7em=71A>tywvH-~PV{A!kSzrM0vSsPB!Ppy&N-v8pC z17Vjd^i@_ghWEz7`C>>A&@e}SnOhW6G}^a# z_)czAT};Kn;~S^;Z~sw!#_beT$-wDrq4Z~wCYzs5xO zSJCgUEk6fqMX&R?-1zJIUCsBeT*FVT@@twL$ha`~rg7|#z+Jc9hX2ExByl{EP3u#60-loIv={Wy8wzsbD+GS^5-hXQI+Y?Vi ziWe;moLzRU>EM};8*Y>@7A3j=({DRxbf8;Rjt})6dRs65_HybO_h`?3hf6o+Dp{b;-Yts|Hz z4ir56kCv_Ej( z^}lb`UtV_h`LX4j4<9MFXt{DGC#Mj{n~jf7D0>xqdGY*ldVa*f@%H#r1C@$guZ9J} zGkOxllOY~XIwyPNp1*QC=+bYNw>RJSJ(^+lyEy3MLeiqWPD@r2EEXMKqDnP{)IJJc z2P-+bE)aI_oCF@MjRZ=m+>Li?z$zu#8X;rF3NRk5bhlPkHO(2%FwZzZDVPgy#yF!H z(-9aY=A;9l>5>tAy~3!&NFc|rl4^^TRa0+x+F2i;O0O~4%@&Ft+gyd0z0PV~Q4zba znkv?5tH_|Z#!-MGIk_LI=;Yzm2uj`QDU0 zE9uJMFT=x~0UJh7Eet^5B`PSd!Q|D#Gm~2>V61Pu0_AB;EH!qa3;DJ)7)2zNf##|E zLniPA6*R)6si5pTOK>G4Z)A=j!b4J ze-SnY-H%2TDRNvv5pB4uo-LvK1o$5AGykZZW_yQ^ZuuOUNB;fD&6{g}*}1zz8urBN@7zeTpowpDT%P%6F>fOxDvA{)2yM?*F2rFxEGm@3EJJcwgTlaSpIn>UseITZP(0<6y?OIdrg={5^*+Q(Vdp-Fr z?`qqUMlPV&^GHS&fUt1Y{h9Ji8`aaw==SvgKG4R2BuCx|jS7x_JYvsxb@X`y{$e5f!esqQmzlVyGk<+j z7&ZJceQUVKf(2%fWv2r8I-xJ77Oyr>SOla5?3TB;9SMT!? z#6rdx!f2RH+_yFsa;9wUyz|;~l79j>Y7K}+r?-LjlJe>HjQyB+>*ZfL|H6+SPs=bn zMw0O8{93I>_LMVQNsMdU#X%gN_p+ij<{2sVwwUPZR$wx>hjGiXl5K5nJrwhn@nPRcv4psM{cT^+rOpl8wG}tGihTI_odq$ z#-gqA8WtRlB$?nE<)i^&a@cX*h&)zW3v=xy4-7AUNYx!{~%5-{yy1z#MywYrEmA;m0 za>c!^E-Br3s2$ii_WXoIbeHZzDoT@d(G<_yw_kOz{?38A%K|*OCU0riP~$z|^7fb) z2k5`AhWBGme10ZjUyyxL6zz;cHmFv+%kYVh)1E_tl1#R_^(TrvGrWK_E7?_e9qX|c zf6_tFRf{ua7J7KN*?kyCOEo73fCVN2HSZ~V*pZ|A!Vc*+YmKzXq3Uht0&L|Pr^5do z=G#hI+J`!NKf3tsUH7!NJB`}>qTA&{bl}vfuJ2y4u&3-ya|YSppHx68nJ;KB!g{!n zxH=(X8C6*c10;^TKIY}k?*VcsAAoUlyhHU+_CyS?PRTj&?prV+hHvcyy=+7AOr2U@ z@GLm~^yj^cBw5wfD_#$X)fa3wNV<85p&|^pC;h_{m%lHcSQb(1$kqBc#PcX*Dv)tR z$1mPgLFb%t4ndmGKBNRo6*|a;2Zb5eX6Be#G8dC_adO_z66&6QzfifCDv93&818XNfs=$nY^Gw31XE8&1P%J!7eZ zl-xWxnv?s;@Ij#K>e-tBZvPQbgzW*gLOe zhWIonKoNsvOHyzk6WCX6zvL~)Ip>C2uJ;Ecs#|o)J-Q>e>b$uy>re+CIh?L?@ol$` zYbdrdqeiE*?T&T+;n22J@f(m2745kvWwm{Nx*+J7Bi{_?B=;l`=~hIkRaU3lI}}AF zSxiOK5uIk5NEA|2_w@}>0!CxQ7DN;&0(57p+AXRhv>tBXktrtz)Sw!+u(}b2P9;v+ z%1L=*=ym$b>C=^~Mmyc%hZv#rPs?6GAGqk)T}@Yf&AjUrWUmuS+YvksZ3YDFmPxPj zbJ*sjTKsp;us}aE$|yu5^oWS$cB@G55v@5Z{ZH=15E>;zP}Ph&S=ETi%R&VE38*!T zVCLY0TBDf3&}qEl@&Tvd+SX+QgVU)qFX@=6jrc>E(9Qx)*!Q3a_cnRxW!bRyuEPK`T~`sKD7K5(-RvxVaE(+8%+yVJHtO zCY1Qa^UjsR|NZFL(ee4z^ov<9(g32{lcWiNWgP380FFx9HQ&>9)T7@r=zOiv*Y?Y= z;${Ip9 zHEfhC2o=fxj*yv#Bi%qR;aC-&pWp-(4Z*?(B`%JrC7hGkydv8(LM|ze3fIy}M)k~* z%@-CgvlK?C6rRZd+jCf(g-5Vm`_}iJZ1qUc)py+PKlQ#0{@}+Q`E-w2X0T_wl^QYO z3MRO?&{6P#=C%`P3s)7(1b5+zfLT)~+3bD%(Qa!HW-0y3=&AP1@y)-J6K3HmdgS5x z(84p6tpGf0c(a}v&*HL5q5HN2=W%%v*&-U;`w^BZ-3j*&sSB0!kgQY8aW` zw%RWxT%=v3AOJ8RedO z9AVf$Sytg!e$oA1sD&=en1J=CR%f^`aXq6P3y$s2^02@W zvRpl^OzH6{2c;7i#~f|!vh)KTrii^85@~}O0WY$bA9J`m6S>4y8j7z|4@v00(}@r8 zbf!`T85hr3km149{V36PQza5OY0@L!tfp;9o&^+O&{l+>05MrIk0N`>C3QTVNjH># zxOvj1w|^C(L)r0ODP_wG?l4I(Ce>9hEvTV*fSK_gP%}$_W~3Y86PHhuWOdCL)plV_ zQ(cV&=fT8)`TTTJEkVkLv1=$7wOu+zoDA#Q&FHDe844=4b|)}tbt7HJ;NK$Tgda-y z2*{5x;25MTj8dZQCx(+F%p3$BzVvv3NN$u`g+``ttQFM|)tcElaehkquDcc23f7n3 zT~*TjYK{ysj+U;Zcnb$EP5Y;-lk@gq#KIL$7}TuJVum22&P+Z^;hkvgeYJ9a)mb!Y zDW-C@r;}bKOd6&KYx7I($ZJ4dLesq?TaTsu8x%3GKzu@x1IQNd zsmzYhj5Mvjx^we8gD@mjnMGXa(_lj?$POp`Cpdg-1#D!EVejDTxwC&MN8J9c&0P0n z)u{N%AYRhf^C8ey$X8FoZZisO4Z~D-$7P6GJ&D*uaiD&U!;iQxeV2OnDtSrp1IJiz z9-ST$P9t$mf8Tq=tPe#o$j2N!F=&30eRv;a9Y5;>#(#89G%l|ifDaQpzE`Ch+W9DB z+C2)PYd9|Z4qt%wocw>anljjR5zxXaFGtsSEHy)^}F zPeOlh_!y9$EN^BTCDd;`S0tl4-eQQ5kK9HqoBb@PLOvZ;?3R89O<|CcrrDa1I%O%b>RsP z0k(jA^^$;Hn`j5N*=_fhKlur)T|@A$TXiP97O+l|RI1xz*No{dAGrK?Y{*Fft0I#I z03K*xye5u_=IDEMWj9U7=OZLpl~!gIlzcFuqRNqHPj1`!v0%UOY?WUG7wNbl(wncx z@{3f$lw)mn?4WZ?ch{oRH=0LanPNZ!rM@Gn34Dn75lQi+JG%mQQV( z{3WmES@Dk!?A3$&=AAez_GE+UN&`OpW1IEDGkNV@nQC~xcX|T}5BaZu|H!k3W}d4OzfpaD5+H=5Cop%o7Lmmb<;XBKqX-^&{U*D zhHHOfKv!o5IrO^#`Y3dAJ=4o(!V+-S7IRZZ)A9DorQX0GCg_}#IMfoT=lf$Tyv+5Z9x|VBGGMJ7^GUIO6Z*^mdl2@Z7!iuEp2Ez^~PLe z9F#X>S&2MYlg1yt&^6FxXTuW6RuNX=2A(o31`|{K6f#Pk;PdvDLFjS$pB~;uZ!E`z zfgHAhvAV=wPlFn9HGxLVG!OquW4xEOaz`kHDka*J9DpI!5i$laRA_n1@%S#%q`U26 zacS4bp*u5=^i^5Yqiwcr1r=}^(}QW8%x8H|S+LL~PQH&1*C@&a;c!-B4o?mfcpgrB zCdKCmWZw;))xy|vDCf?r`%VVU98v;Z$Zz*Qx&14xPcU3=^IHwGGt`^!jZ=Dr+t%rR zh;=e!HU#IWsY-l~Yj*jxgEb>Zpsj|QoRi$6dSn$ub&m(NrX8;t%>nF`aiwk1Yi1;^ z&s#`Q15gk**f6L$=;@J!(+rb-0$6`=cE|%Vw}ccCRj1UO!n4i#nY1}y`2nii#yB(E`o-UjPrskl3(Qr5^0yRt<$Fgf|rG$hzNK#C-)v%x*FxDkxBcMZ1HlTC?rW5o1 z%?hSM;h9O`gxpi;hUT{H$kW1*gms2`@&x{Qm@6wR%!gYet8vK4WN5@VL^s!i2@w*^ zd~1P=4Vmd6P$@NaRh?y6PHiJy$Ev6)+ zevV5FH@8kroh_X0$udx8tLo!Z>foY$PlYd*^4TS0(mo6fKm&SBxJE_5>mvOHg{V7r zZPCa1tsU=^wZ4O2GHB9Re;-~p3Za4G9Fn1#9};KJ{VJkbT4x<=vm-e(xd&=aVQJw) zb~c#M2_PA@r0}X9wa7d`q#j0rF~d*BCR3(swO!lHlgSy%9tc^mPW83zkDDM&7zMV| zIxE>T+xp6U+9YB&cebM^i$*nUgYGv$c4v;vtCfo7J=vN0)ksq6VEOx}GyKCeRgb=w zRYRIX8Z}ZIeg9g$$t~t$^#nb^FBTCtrq#xwzM<@sHK==`$6>>AP_gE=WYNgeYXybX|^YT95@^$JMCRwMd6_A5OJf zz*WDNdqx3{EUX#M!`wV?3&jmyXV`j2khf9HV5_s!(Swu(IOBiOAa2j3Jr1)jHG zpOBt^Yk2tT7aV`EHt*7ki>tW-wNNP!9mX{Xtw~s#VbA6{>A?RSBtHSJA9dB`)iF)P zhpl<@e|@faHW9U@_00R<5+9$udjM)@VPfsP&Ig?u2Y!#*{7>=9H9K~`*&3{CF65cE zMTm(hHu3Rk(WAY||1IcFT#02pi@XKolEm>+cIn%qR|=ZnpR4=eKFzn@y}tLQ|Lr>M z%R{HrbK8F#on4z=x!L(s$?Y}QzdaOf`nap)LC5vpf~aGD58p2(9_VqfIH+v(v-|f? z&)aD`4veZVe0Y??{kmk8^y!r7-DtpA%I&wO%imtP_NRINz+Z zlz;Hubmi);`I|Ox^bD(XYgx}P_3Ll{{N%%?Z5z|CB`SsqkNYhDA|$T&+I93||F)2# zqT`<~U+-ow!G`3nUc7{BkNdGMWO&-FxB7C~!<_uCV_)Gx{ofX@E?#MK<@D+&)fvNQ z%hyrL#3fE^PnHW86#K1~lJ^trsr>*3}~wvD7HH<0_AP43_4n|k`_-|sRGZz+^**xlwawP+;2V0q8S z^^$9r+s}S}qYe3Vu#miKomzknO*V`+5ihlxr+aEyT*^in(-+4TK z>)slFj`yHt&H6=8n|o(*A9tM1FM4}E?(DMtJ1^evdsuPp&sBx%cJ11Ft10oA^O?sj zHxey+rky%C5h$-0x7$nJKSqb--n!p39YKnU`55FEjGCn1B_BQW;bZT-Y~9rMD=XY` zZrXjc)UE8(?uc5`2j5J;U-=g=P>|@>RNeqvR93>y1<_-Bet&ni@L-enH@|{=`xacc z6H52@E%&46A_d{4^!kIB=UqRucij&nx?uY8P|!tn;EhX+qFdLlbp=(NS1l{L*tu#? z--C>+SEif|Z;6dtPdPh@*pC^eki#j3`-4~`^xh4Ex+r@8JONc|m>z6ex-EoBf=YT7BWOHHh zB88&(>Z1+i{n2*|o3*^1ka^Dz&gG#vACF!Byz;*J=98zda`~x$1-(uSepTAr(-wEh zZG8J(SuCW0m#gphF53LRYf%nu7naPcKKp5Vpd|K!GjQZu@)q&JkLFsZH(W(g*<~k& z`D;?`ziMsMO};zb2~)~Y)m7$zu;0pjs(l&|3+4YTjF}C(B?%rNHm+?9)7*&qyQeK6 z`cF>E%|(|VeqelwI5c(iQoYZF7t$Fam@zXM*24nCQ`KJ00Axl_x!Wt&s( zUi<5)Fs;w6F(>o>i$dlx*xjwk`?%{j+}^(=H!v-aI&d+s`s0<#pn`-?=a!8xB5+85 zZCiU`#fgeii<0#Rwrg@;)w7jU#*VDLT=ZgZ-sSL&&!jEM?Sy}5sF-?cC(*th7%=U+zq{c@J>UTAfUzvOb0dBa;& zYhmBz`^%R&d*z+&c(G$@lg9R6Q!u#QW?g==ya#Nc2KI>o6t1D{@wk}M1dMoce z;Rr7__j-Eg<{+<c2K}c}-uDiU z{`iKx^kK`vZ;pA7`krh|Xx@^x{&LLOy4Wgo&SwMuHhkOT>`n->WPkwC z&G&TzmBR4C@R)#J&+K+1JgNNsV>y%zV|*NO|DOM45}(PK#IkG2)Stk$d|!tB0+Lu5 z@0*!g9}C4NqKT3(Baic;VIH`0Qk>KlA=72LIfj~1RM4JaJYvq<+S?e{bWrrVGSkPz zXX6HXJD%LRaRB+9OOWV*jKd@PITktv>a#V&vP|{67qV?}b8jgW z@JC@0=MuNQcN37(*3dbRz4@MPW^?OssBHaU+|vpFR4$zjgX}SpS7q{2D z-MJmL70OZ9DS{C?E`p1QU9!!v;T$$psbII$1LWmlM|J9ga+GbzohM&IPN)?Zh5|GF zztHryGea{5|2MxagMURvWl=vnu9{N6SorI%MS=5f2^vuJ6*Z;Z{tjDo=jp@)Vm21kF@CG0FvJiuO1 z!N+-ECV$u;Y4o>Q*P2sS3|*I5m3exQImIR5CqNoKdVlfn%WOC5voIud#7_V-3{{ZX zg4mna7*(6iEf}37fSn&esY}e;Yi-tI|7c{*Sj*OLN0E#A%P^HwEpc|c9Y^p9!TXAY zbUGq>4J0k;YJg#mwszBAFz2e++&n%!lZE!T0mLq$XMXeb8v~M2RhHOL-H@|_hCvqF zu@RU3JcVZUW>A3^OH*LZ?TZKA+ie~DL5>dn34E?-#>XEmcpT8goUrX)q_Yz<`a7`fJFON^E@tpIjP|eFPzfsh{^P>6Cvw^58Rk5# zxR3IqEjeZ%)!fdCnxrd zWkXggLU?gF%t;&nZ?!@o5fSU zhJOaqZr*J{>o|kSYFb6toB&Q=%odU`6muU}W<4VZ*~;skj@dJXB*4fZmv0*q%Ohc3 zR9WKQ%-ki;Z1|8G;NhqMzcZd%We7OF{ckmaJvr|^m74vauVG|XvvuFUugpAOtuA$}`m`#~dwJ}t{7nE)DMkBu52u10_Z8ss)Iy<8 z2ynVciy{o8W{Y6HLyg#d&~aN~4LjB1IU`21hHCu%yzJRLl3b2uOhRpw5ToH6_+_%l zVVGKpX_-G8)hDnivmpJ_(Gk;e$k@gs#fCs+jii1yY${Ti z0mBgVt!%DEaVaJ%pJY&vry}B1J+AWROL$hN;DGA$RuY=bVL%CwzMW}ra3hsslTY(_ zc6V$?Bh+bH^BWTfq>X?@nW@U`a1yGMlvt>eh>?SiK1}nFFu*9+DuDl4N;7YWNOH$e zP1q_i%ZC+j84_tR=St#8^C^z5odNDks*vf(^cB-%V^xrM#Ghw(4{bJ$*YRa6jhV5QHWurVPNxLM8%WT;hJ5N2J&q@jib!gvzQ z$M+*tp_VdTn&e;Lk7teGN*?qb~{u20YqYWyk@@aWF>@?Y`JX+--i-v8RqQ4WEM4bvSMa5JRe!0iNjpSVtMNf~c@wdAV zTLeaF&3#*R94eik@r~A8XRiai_|@&gaDC4ag_T1X)jevf%>xag4qpS>pk3wY@WO3* zjaDdR7ukkR61XhPPabL7(|!L$%V6}-)ZT&SaWL*zkLe7)Yj07x|9?4@I-HZj3hh;i zlz;#~&)(m7Rm%lMU@i=`CKZy|XNM^loT`FDp?5N(D2I$fnp?^o%oyT+>jcsa_^qJw zq<=;wks^pCssvj;Fi1GdI<3%pp;ma zdk^WN)9(#GwX*y82TQ&m{*T$6!LZdp_z`h{=#i^uf+Boww=0;5Y`fqS=i+Sv)JSb= z+R+TDbkuTz70Z`3~l7VTldaacUnLYq z{TGRP#5`1F6cD3xZ~O!%Ay|UUCYgE$Y2yWWygSt$eG#xr4kS*+!%hHZJvds8?*KS$ z6e6yzQureTu14`p#2kjdZX;##$(5?1vevf4Nzdz>7jzx_m=fP`EJ(P?tL_?dV0M2N;2rnFtp92Ra-~0N1E??yrJS=RRDZ}CIe0o+`JND zM%;@TGcXC^w&uv~KLNRtlvZ39fx@fk+-@ZAd8xdrnq&Hc{7OZq zT4*#zQ{u5N=htpNYa7^h|BOs*=C{OBTN1pjr^o9bXg zPNKTFB&~M1cv{z3ezt0(7nV<;b{2B~W6GUeXcS%I)i0<82@AtMj|ww73yHe}4&c^E z1t~9HA6%(Dz3kRB&t*-zVE!6~N1i39K)nKHOM5i23Hc= z&z2_qLJ|f*Q$(K&3h)2LWGT=a&vTae8{sZyqmPH9^ctW0%#E35lh&YFmSIjUR`#mTtGv%M9v(lQX~^_bCDhstgPk@6~d@w zm-!~tvuDLmSHkxWWY*0}9KEC>OtzIu$JNbVv^Ur|^FJzc zrh9tEB4v;Jm7Uh9I5pEVI+=ktu=j)?N~6TI$BnoT$#DRbP^6BajNb)=%sKvQrbDQ~ znP;%2c;fVAFd+M%?66cxk7unkwUkB)_jt%(*8H#SPL)v$_$N3Xoz3>}j!o`?h57D7R%dupbbP!?oQ3F-I!I%1tOMH_=$n)?Hm`%wY9iX3SC2>g$G(4wiRUM2Y($`9V*l$<+HJ?yB<=pTE z(V@v)+Kej8oqu-oS|0y08^t7BEOtS3c^(d(l)vlPP~2@5&LwTP*N2s3R$Wo?YM({njW805U{uCw!PTyu)ySzbo$%1-S56}B~T95E}@n% zp{A$yTnX1<18Ve{0b{xhjW?U6we5X>wB&bZ0Chs6s)uG`KtlsSeV6;nW=APsHqYqzRQ zI{OC&=P;A)d%qqw=insrIN83!-P{qwlPgkOmSn2_MZ9%8U zf1a~5((qc#0tRSvCt&(}=vpSVg(guns%qM#)G(W19*P5H z$T>wM-Ap8chJ2zyG145NXOJ);2C!jbDf!u<76Xpf?{TEsQDoK^mtZuwCw%nB1A6jQ zSG83@yHDzznfAM9ZI^ozIvElx(4=fDk-9UY>-(R=RNtQ2QY2Cu2~EwdkidLc$pv*n zPLGEVk8**rDkuX!9@R3NG^NhYI7Yk?POKx0K*KiKwOMuX&?GFeoPamU$pA~G)w@^= zB>l8W%#4l$s_?YT^q%}X$y6}i(T7^|-P19n9nC)s@{gOfcl@(;$Nlda#b15j%icOL z>pH__h7N=`JDWt%+9!pD3nL@gEH$OBnl(Eq&F9p#P2ea{GsR2+)I^c$-~oBW3a&lI zynDX*X*Go8Vn#al3Ok1ebm_A+8BL0Ua-W|2U6M@IJagY|9s=rY=>%lg#%ZDHk~L6I z7kpej=L@gG6Y|U9gt(tTJ9Gq}{4(0^E&3SN;EucsJ@w@PX5^V+eDL%pA|%5&C#{K$ zsPD=I<7&1cnRDqAuJwpXd`@zGik2AWDnt+_J@vYTo_sgM_k^CgE8x(K0BM_jW;46; z$D+|u3_NV!%ST4`!2R3l9dGknYTyPBP%k$Szk(g?23Vk^5!3>?<7?@un4g%r5?v*B`|t! zb3_cv><}@TAhrdGjO=n$E!F}_vTulxQ)r$NmsmD54_Mg)qvpqRML4ZTat*tr+?cX8 z4*sO)S+~n(Ps*&#==hlQpetfxj$>r2CTq%&KzOb=sWd-i?&fe{qKNFOy#&AoH^P3}D7NaSM)^qc%aJDG19^N1!Nni_Q%B-mxo-qSt70DEp z609pI?5i~3d?tz5mf;isVcw@fmQpS9}+nxM0s|d;n>A5@-@%Y zhDI5W8d`rQ6o=f)(bE+-Iwt8;7)Uw+o$tA@&7z4`SIaO|cv3h-)oXP|fVr2n z4pLrsIM|yl&m4V5_z;gGDRQxa(v2p>l*W45QwEMu5{uve`C~%OV_fvs#;&LUQU6Sr zA45eTfX#v}f1>$#1swh9Z7<9BpC4PSi&8+hKbJPI9#=`Mr8ZNUi9&{_w<3Wxka62r zif#}rNm236yniHxDG`BSe%S^R;+9ukTN+T??m%tzWsb^a!{w`JOfC_Nq~92QRvJK= zymOEmm$L((b`=>{bFpwSv+d4l@wVU=sVd=d$Ok)!MgcV$CNO~itMoj)e?t)&$fM+#2)Mcw1XqF z96S8tK72hhP}TmbBJArc&8?x6bHCN4 zjAKC#w4k{|SRj4i?&&B*_!j913wfwV1zZ-J8!|iiT`u&Xas%s}cIYs}u z{mp6HbkH})`xOaAFYddX@`u*H9-tCy@QfJS!wB+8mUZDR12ddo5Jq-0Y${02+Z(l*x z!wo5W=tig6-7sO0jtl#g#rME_nUMPeTZr{u`EgzDr27RYlGD+*(A`0L4hOOxb?Wh^ zOR4q{>;Aw!Qa?DUCBf#OJ-=hBz*X>?yCQ0ow)We74xowDTc+&jb@nRbZn)*`L5|#*U)2hFrwg0N6-o7mE zzbC9de?6w`W)XEyk6U)I=UUO8QTfTYDY}rYLD`n63|q~;g$3DduOuV3z5N&yWgYcK zCCb--k4V?5$l(43KdCEePZ&QHk_vAMc_&>CE$+T4T4xgPl){ApY3LuTE1> zovi08N@9WBlu&jhRrLLcsS!j_@wfGouS>=JL}xOw(qFifqnZIcy-|Q z&;1^InzIi0Nt@g%`|mhjC`*qLjg(1#9pq;o13rB;e4D`z^}c5S`Gl^Y0x zkUS!yemmM9xc7VihEbfA@#B}L92|L5aK{%tHnv%QdbYz^R}QA`b}aSJ39`I%hiav} z_{O&L($&MLe~KfHcRudmj{gYiJUQFXS+*YdzSYjLWbj>)rE9BIsFIO%TYcuhp}RJ{ zt5#FjV%+toPsL|8DI9qM|8d}#(|0|`F|=fyK< ziLfQ(TuNq*D!@V_>Hu#(G}vs!12??UaGWWIPvSTxX-IanIYp_JjyOL$@m&2Zv*lZZ z`AbCs+;0KBY5H!dK0;2@P*6`9@RCiO$JJvVe@ihlN`?bQJi?#n@{P>T**Exucodw( zU$sEFooz9Xjvj=@CwYpsOoH9LOq6~p`1Az0$e7((O27m0 zgy7&f_>7H`fmNNNHh;~=L?}%+aTO9UJ$$XHvYSi2k`{CFQ zDpI5}C!09T*T$*KixVUE2o;qO(<#`-2Ch+ydvLUQ(za*nHPf(fFlFp4OkqHU5goHB za+hB43CwTGk%QD};j!kF^_5{ywiZO_DwdE%2q9Wp+7em_Q#C}0m#6H!K+X$k76{a7 zX9%ep2Wx&2j2=Zz)58cg6RRqidUtS0rXt8()`oAqZ9Qi*r5^B><^d>XNH)&?1uh6_ zx+g@u2C#E7Qv^+vGurlcR#UUZ7dD}k4O0+*^vfs`4(xV<^u^ya~ z0Z-B<47B{GM`&KyFaO=1fiiGAE-TssLt>;P%;6yorV%3_PCJ0ZS$zl>p9E*MV&gHe zZ1JUv!5y0VRo&JaBy=%NwtBdkOI}#*P(ltYcZmnl&C$1%6PWUvRMrmNJXW%eKb`)HT7oow_y9BBlKi6MAE#GSR+Ci`KEiz-SpgrJ&tIEF5 zI$M}rCk=|&urWdQeuzkWGigcK+l8z*aMQwqI~l+A}ceZ_nY;qwjK9RqHYOdxN=_ zbnOHbuE`rKyLtmA4^z}Ek$s&;KT;nasGTaJ?jeh6ahd;}leBCDgg`KWrh8{f;7!=Z zU@h7BXSwb2RnIV3oqSgy_{K2VlZOsPv(8G~P@$zf$DZ9hvYP$z=G`W-anR0%-!=hu zxBQ&G*~WLePG|qBVBSYnu}w#@-r}| zn)^r%f;IAxg1A2R`%rN=v&HMikC87Mgo0>Gn>TNN5T3<)M^j$oe(Jt@`5M4pwv`mc z)b_Np*Vq%gix@Bd>xR$^kxHB_L%qboTqZ!tJ)Lh0uqR_cy`V9vWKn9U=gSfBK0{v-SOaJXovnOd0lbbMp-Fo&4= zB#w6I&`Fz@L4^feX!~1jeVRys(^f86X?Sp}IDfCDD!fn!$cD!QX_9O49F$2$5bk5? zKPRK}98>d7Ej7nuY1%x6Szr{y(mKZX|GoQ>yQ74C{49cvfP0{Dh-5AAJkQ&AQ%h;n zG%nnVF7d(Cz5o1Cf!WTmG-|xjomM=nd#SPkf?6B%4GU?l8qY`udQA7d?n=31a zP)MQ)nJ5q2qk7>y*sGiOO8eIbtz7q94A7^VPy~Nsq=Q1PaI!EA6jFSKjm~6qB%3qe zF3h|%tU~Hx!TR9tB0G$n0S+c^7=9@RQDIVI1vU$r(9B zHqybCR_%K~q?@bnlqg_f*jWwZ`HI>MZ~4894mgtW9M+Uh7QuV^0+sl1Rxk1lCK{!a~W!;X!y~-x>v*qTzn|@HwhJ zaVU_huSEg|z!OXgw!zf$%9-R#&CaG_{K{78B71g8`B|}i)jiP0-H|3j$YrCTY@p>o zoFRM#o)KpjmXTxplB~n8Yfj|riM13=V(MTZNBEI_sn}Lu0%?n$XUXx|jfBPd_T4jI z?45*Za+1(s(yCGuNkq3ckBk>?;XFE-^O<|FeA6z1#}?d>+a~JivM3dWkE~p_?gWTt zNDVTx*1)qCiwasD^NPP@DB)lXc2kM9>kyfsTQ@EvrI%(1D5VxQlX-l3c|i)nBO~n! zeJeG!4g)?)@%50=X~Fo@v~;g+%SnHMo3k6Uhd7=AHUBAF>@;2CCHy3_;5z^s37-DZ zzzOl2xJES0D2w$lOfu7udOL_7iN$Y16h42V+LH%rhsg!n%On8~s7nS?J_l2*k2~Fr z2NWdC95mo6Ger#}E>N#Qviy%PQMCDwYc0D+yZi6|$b43Dh@NFgrO6NJ!%6TW&H`W>Uun5Hh)0yA0qUz6P_UegC&ESb zXto&~OkwlQEH;QQ`C9gIR{(m5{!uwF2{Dj(9ZHojVR#DgXf@d(R3N2xEfGrW_Ke5! z>k{cC@cOdx*;Nl)omKUpQ;}4ojFmqxq|#oRd!9V%oP}H$2A&qJTQ0-%CFbF z0ZuIGxH}TZ3DJ4q}mMX-GKSg<^FBs;L|1C0wRQ`0L9@Au@-65;^aevT#mPq z!jcA26mN2Kb}8xJ8Tw8XNd?JcrDw~|E3UI=sFk4UB?*~~;44WGS{0UA_2)`=B~RbZ zCM)xCM~)}%yHK1BXQDKfq4?TWCVmK&C$WXNTII|-{>%d449|Kp_9Nx;u-vpYX$=NAwkDWC) zsvrHBZv?^g#&9_z4o)|SI5VluZ-(#;6(4UGgUTUPauB@Ft>E~TU#r;`E0UA4#_D`X z?r)__idd#925<%vfp#a$Q30r@WTNH!@0vmQx3WY^&!d3F{{AgE3D2H3jn6TdxRwTZ zpZOFmJzophY_BwA^VikqznC;OtiKIGh!q5L0M}@Y^pOY+SAi^3HrmMQ0LO%##5U%- zVS)?-L!cxc_`)$-t5y8PhJ6cY-u6yg>b`+wHOed}YHfPHPP1THG%%$>zA+$5;o<9q z@?UzuV=s-FGJOW65BIM{#aAyV z%Z^8_&l;_&z+gP}YrLOYA+RaZs2$;&nzc>uOkAcovwFgCJsB8KUv;$^6-kaFGO2id zJWBgR6+$JxcDVIqf``0H5+%uGr8@`=lQ%E^rg8ujUP-_*8E%HCx5A!zwn#IT(9*F; z5lR1s!0cEZCK*drk%wAzd$bN>OqlWPOXWwVOFJ}udu=~M4Hb+Fg6Pr~@H(T}&hl!b z1)46fMU#pqW+2twqzL=F2y%R;cJan{Db)S(t6*?Wj}c3pRCZuUtJgJ-7CjyG)ys5< zy49iDwUI~Ukm?6W#w4ab$LVWNE;_H>XZpaY^butbQ5UJZXGpt4@$|UN!R>VADI)a8 zvPsvYyDApp6b8PZvp@k~# zXkL+IP9FbX*DO|`q#e8t?d70lW~YnbfSA7@ZwgU6h6Fy7 zxV2q>2E$G@chq&s?Yat)2RV2V-9f6RX`V{0;+e~2mT*>}rD2Y}j!1?j&RE~boO5-* zF>*}l15&VFs{jqcF{n`QMwa|%6m<^H#w*kgp@mJ}Jf1LAp!FBX{R>=dpYN$S_kETb&k==FBLOp!y9u{gjl^o6EC`U zu)YmMOPVr5_RM&hPHLQ$_NUoE_k$%k;UAYsyR2|nxicwM48(%*^n1n5k~F1_YOF9R z4x7sWz;@ZWVtAz9z5~STh&N zTVbzTo6LT-e9pb$Zr%`kvQqtk$8OE8i|#+ZqKrnrwI^eX5X9jnNwxBs-ZtFGZmvke_8EX z!DuoH881j&$sD!Dx>MA-UhoDwZX`HzE(wpR>MBtm%LuEpaCM8ks(dTOB3Am#P9 z&C2~8M(oS6UP<{?*TMNClQrm#@Z?m##5o+`Wg*Y8V5@oa5J~Sq1j!Oi0fqGfl{K2! zs5KuwB6X8w!Zl1`$%E~x^Gu;qqq@-CVnfTzJ4Gu}e<$K0^7%$wW6DBV((=7zzjt17 zW{TdaMNzb_Cz7=8l{)jtdG7TALh8RvBf%X_*`6)*{Tj@J8Upg0#T(=3jlYE;Y%C zONwUUka`nIg(UDoH|ou;JvVME;1ytKF!}c|V~(mJ9pxOeve50vfWpIi)U<^j&8_h( z@`RvFwy5=NA`}UTB$)%!Eg@*7&A?+bVDYWZtdO1gHr6EOPm5=*p?v1-%3!pRiD@;5 zpTFozo%Ab>*krzkUjh-!rgA|ItFr=7ejEtFE~aQj&w>i>?!*@0w_S&mu16wd0@pG=)hQOfs(q?Kf!g|xn|Wf$KxY(m`AK@yPC zq`bUSgTf$WY8Sz*$BJVPUMdJZeBm^=)7tJr;l#vsr>47h1SLB4li4~i!r_=P|)ZV>NN}naim4%kmvdF5K{gD?*FWDklTcRU(y^H}F$?_Qs{=o?3Qhg5 ztv-(HBK4X^jGcOO;h#4>>Q%2!Jc$Y^y=U53f?o==EA(~9SM>$UyGyMdoqRvNswhry z+(E$IEAQr(J7V{3dAv8+HP3uITho|h-DXco#`DKNg`Il8(L0H{TKv1BA?n`udxYTJ z_sbsTue0|3h>DARJ|5}Z@}sY~c=EySt2}4>jT|U>O}`WxkPRGalxX3pzZ6K z=h2fkp?<%@xJCckSAoT0?}y9HhkjM6M~>N|4Vi-vxd zT-LjhDn28T=6HNhu5ZE9yLG|DVSMa6* zD0nQ~1Bjbr53mMFqfbcKzkq~0yjF1~Q8>C8pdZN~4kDsp#*uyjpDMIHY@YuG`u_rt zOlFspUSavn(K#(`^@Y|HHSf}7);cK5XKvgcLcoWnqQMMy*{Em`VTx(*9@!tNoYV(` zfMM~8L^B+?SL)l89TKeZzJ?5C!dkUOl$2!LI@?Sxq?Ir_xhWB$1lFLR19yO+9$$wA z-7sb$Ls>PYr8T)zU{#zOB2c=^!vVfg0|FL+I*xR*`n8SM%S-}hg^9o~VNjTry7^xU z>%(mEe1jI++{V<4#Bp^^WMi(&1mZ?<65g1{R`~~iEE`C&-xAHf1lX_6uc^PAErWC6 z>YJwt8M69u^)}|p^NBKM1lK|>FV|*RX7w+)7U&f>*Y}bhUPZuF8s@*;guRBqNg9Om zB&wl_r_xBUOr$=Le6;~Y#$YDqO|Y_v6A8^j@?)q0+#{a6aRv773>!Z-@~Ig=$2U?7XT`{d#6BAr8YB zb(>yO%e*f|RO;3zVc@N65DAPKUg?)t?h{K=9h=CjKFg3IVwIGJR}7Ew^$ft4a76s5 z0YN`bP&*NJ>o`@*5iKcH!m5a|fCW~Kb(Y!H0_mErR9=433 zTAE>wTMF%p*&w#t7G@O(7Of3>t}opG^X7ryT7!H0@7{w>2XH66 z3p*ZsnpEXB-A%VTeAusk=oGoB-Ek;rHo0KuiOF2;unw?%bcD3$#E^txT?zv^`aAPw ze|(V&w~yCzO_VTR(hOX4>$={@gR?pf_ou z^OSGpeS-Yb$Ri-`XL`?e$5ojAQ`vt-`Ez7VZ+j$TcHH>QnI6CV|17M$f}i#W#aTJDT`JPm6Zq7O zjl1sO|9V_$BJJ3b$%zxEFZOw#k1U@`$nUY&_4VKRDIhR3;o~UpLd>M!u$-ZPFj6AXr^FVmMQ!owYxa@r4@XHJd0s~C65yiywKTGou7 z@1kGun|J-rCqg@|<3xMI=5IJjo;0lbX7ba48qnplUw;sI(^Pgj{94}S(BP9h3-2^o z8XOYuK2?I-n?)nz%A8d;juhD695twu+%ukc>f#StIa!V~zR3kv+x@cW zEIAV1@fUD=!?W%*%}6!;uonKTcw(>RVb!1~d3gnS?ayv!cnJ^vm!_%t_~MV@52eZB zrnu$j86P6gUhuxW_RJ!xGVD}!$8^uR$*+}#RW1i?B9p&`c2M7a$!=1w>^SYB=i^`A zvAF-0os(b8o!VNrk(d_EZk=~04u^Dp+qgX5|0ezU@A~8#C+CBvt%XzJK_$M^yCTCJ z><=Bha@|SoX-;*xclGA#p{r$GdSm539z-l1NdNeCH{RxLXXlw`m8V-fE59v0ZhQA; z!(?xan`!rE)7Yu7n(&+@nJ2n`r^Ls zm@5TemL&E?T7J0}mh|sp=aT~aYj3U^S&|@Dmfvr6E=#J}(r-aJ@9uD7gK(_MF+ZnY zFT55H6VLi&PZd9bjd2GU<3QWz#wR!lTio_A<+rIj$5T%)eXA&R{ z^XmW9DYD#}^g{V!`&K`zywWVPIHvWtdd$1s;c+Lzc#GRM!lM$tTMzUf=suSo)7@`v z+PG*m?ostFyUce-p5^OsgCVQJ@_c5S#4R?>=^gpsA=_~b$@$}t&isR6i-#)TGY*aB zTx#odcJ2%X&)DUq8p8|SIcW6G!BO-*d=Wc%B9J#E@=Fg@%l@?6{70?-3R8MdlI(j zg-!=V=;+#9dv_|V;d6m^6t4H*pl{8QTdEsYGvwx?By*7R~YU2`WdNp)+Mt;*qo51PFserG2dr=e6`}ckt zytsWObe2yS9PUs=>3Jzi$_K5>VIkG7M>{Mu&t$&>wtC&ZeMK+#)6RH;2%uhhbLf%C zdf$#X@3s7&hp#SdR8JYRf{WAhch)C$M4cYGKk6%`=yLksgv0w1-twxp?Cdm#oQiLE z=r$W|>kl25^?j2fGYdYi|S=1^?9j8E-oFTEVCA*{gO(-I66vQ1}Ms z;-ae6&Vmd0g(KsCYD)8#^Gmd!O?Sp#412J6bef-2yes^QRVdTK7ol*%!eO%Kl(^(^ z!HHKp5~E}sAG$ViUzBH+wrFZJJC6J1jd>bOl}YEvD8llg6?r!L(wB+*NYJnRgZCTl zQ;Qyz()ujlJ3sC?EYXp73Sq9Jq^FgKJ}ba%d-Nb6^yh($4y%&N?h*E(`+u}krhNLy zg2-Za`ID*#e#O`#wJsUWz0?aQPJX5zPe3ky^r-1EzEGGj*c$dqH}cZSujL1Jj(-Yv zZ0zvqQdmr^7<%)mWxvi=%^E*9oo*?MGrDnh2Rk>v9KV~cJ#JJ2vgI!p*dM$g{2Y3j z)~>t%^{J-@72}ukW41lF9lX_gtuX7O-|-!1{{nWGE^O9BO^@L(h2?Zi$6VKrSRhnp zO(#76zD+wP^xpe1tHQBMFFSh{P5CdKD1cx6M30kkl9NLRfi}od?R6iS2*uogn)YJ* znEjzlQDOCC%Y!$=94)pT%c1IN%;ie*QgS%w|CPvl6q&ZgGr=fKs=1loSMI|~GdMYj z>>s%Rr2c<03K_+i&`pHo#-xfNhBRA&zvsAi3Uk0BQM6c2q%i+s*b-%{Yo9NVL>7kTSOmelh z(yuMK0;R^}ZfU5wyX+4Q6PS{!#>Z>$yVtJy8P8W18N0ffJf`O;wnQXeCexVmi0Mr1 zbqEYS65WXA^VB@+l9$(+B^)UV4;!S*6}>QstQ| zqYe5+YO#aXMmky%Mn+K2kd=9;yN%+Qd8veT8+DjLfz%>M>%*=+BK&%f~CE_QWujEQxZ?6x<_0F|c20Ir$m&MIJA ztGr6kyN}CVd_k7Z45fP`+jQ+OkX}~f0y4xl+tE5uK5{?~2{lK7F6LhbF3ECf#iZ0i zraTnO8-eJ{5MZpa+0X)Kxd$Y)tIqK|H#7)8@#>Xq1n-kp?(un)mJ^#N1`%P+d=31F z|7EFk?O?y|Venjb_BQDsz4Ti7-?VVBujgLtQy%6p{3{a!xcs|?oT|f*uDcjlS?(?6!92f zg4<7+5g8_UsO8Zlc?5Cw?o33NpP9I5?^!t-F8SHQ-H&U*(m~MyvsHl<*d*3HWPN3z zc|jbcU&uWo&g^OA;MRxh)GXNz_Nrert+*7hf1b$$yj7xu!G5avc8Mb6GXv^kq>zD~ zuQMSJ2f>PI-JkencnQz--uK$_~!6123uN+V3o zU52(WoENBje0%m$6+eN}XxNyPfuumf3)g-+?ZgcP7)BqOOqr`|&K09MUSSI(`N@HD zNM=>~oD{7jvu_ZXA0iw`ir0U6gbhVoC`W}X);Ym~4RPZU8$u)J8OvY?z?C+{(MP!( zc=AMQjAB12<%&YZM93;UAxJogovdwMymjAEz7lgSjo}SfM9aeKT}u+Zb4n-#uhKf>IjqtBkm?Xl!H zvQ#+Mv2Ag<5wB4)@C{HxbE7$BUEr8bV3_tLd)Y>rlFc-!2zPXN8=`?W{T zEdOywS8Ff+{`f`Z9x=J?b|E@?iI9X|YvIx?bjwrtO3gdxnO!BnHO8uRT{i zu{;6|mjmeL@PzHW%qk7DQQ@pArCZ{OqYJ8OxTy4BNhyw}mJIkPQs!H**Qc$`)VxYj zva`GVhl%_ta&&IJ^7z)`1ifspM@)h~xnZY7|HZ)iH|?or<#b6+S67sWCYFUXgo^}? z>M^AU3X}aQtA6SVVmgf$Y=)g@VF#X#M;@-UA0hR=C=#ntA(nDCwwOix$G2N1eCVT6 z7*e@>rWk==QP2j@n2T!JD^6m<+`Xz4c&vIsZt*oeTSQ3ip?mqedLB*A-|MrJLML;W zET%R+X9>@17A?H;2}E#&P@1bG0qsh}gYl8(W=YjOEL#bq9`p#7FNXvz^$&wqe{G6SMA+z$IYjz`4sTooiJ%`Fl9gGNZ{w)EOZ;>no!q;Q3DQTnV*5;wumBPb@(&);}? zXRUvQnQiF@PiPiL0!t=KqGf_TK6#A`{Jb!=b$TKg#~W_~8YWbYcWtF$>DW>FV+*}{ zs=n6_HX{FLAEF0)yetJs5!Pi+sf&lztH)JsEf0yIp2``LZ;2ZR5Z5eo-NwY-kX>(Q z0vcDXU=57n$SHCIgYa6y-W@J^lR@e|DnprV1aivNdGDMLTHQs@1GxO}rHmSdyy+8u_Y1!eVjtPl{;;NWC2X(=*Y6ME0Qo6*m)x zBn^bsCO2d-Z5b4e?NTos-D5SdK|HLA^6X~U`#%PB+7V&-VQ|Q z8yX0(6oHaqy^|ptuq2j2&AFySA?WadOZ`Di6@``Pf+)pB^^C1_S&j))J;)He^L%+D zfbz?6mTPuSsh0|8fB}OB94k@fx>UT4gaX4AFsny`>58>LqlxSLEHs?vY#Pv9^UJny zHPU*$caF5yfo;o~HvOx0{4T%#>UcuUdABwitWgEoI>|xOAt~}$wY$~G_IahHTRy?tE*5 zR~>bi_@?}4pvGo$0i@PhJOz$tIaH%(ELIKl4cFy@5ZM1$Z4WbKq?=P(^sQ|&Rj%hb zo1uvOI%`7tY%`0knAj3=N=MRO$^PEH>9AUWfN zBZyLMB(s~FCvzf&H1xzLz)g)CGb^Y%|0Kr>Uu^-?31+gL2pQ zd7i&!Rxmc<$JioZ zXw?^JfmA~m#AJX*-RCL4b{SVen?>)Cvw>T~g$v)S@paGNDz6D@;-;CfiIz3Rnx=L3 zqVn&1J=KlF(R7NOC!m2{8L-xfG{yMDGf`LtJrr38g&?@$iXkgMomul&epeApN!{_<|J`A z`6?wgz+wqo$&Nxn-xe~}n4|=-=Wg_+&L^_X<}BY^q`)QXH1vrE?lcY()Sq|gKpn7~ zV}Lvi&&95@I7m4Mkqy~>KvBEBJmy+p)~lz|5~y%&$Xiap&S_)Umpo-+>SPnEkM2s( z;jtP=;7Sb^eqbS?h~Xec@>|o?N1@=Gysq_R1%nIphG=1fff?!9Q3Xb%kssiQ^@bM11i1&BQin&YP~i(FD4%!ly-=Ms^YA(<1uG^J_HY@JwJfHD=k)+P0}pgz zswhXp+hnr~>~s;S8BS!i=M4;xJy!F~v+_f%T6hG(e`{g*i6TEx+;%Z>t1u`y@qog;f(cBq|cH_yh{jx<#tC&YvNG4%d}}4deF6Mh_#bIr`GQ_iTys&FgaQW57r_u(F{zpb>tFl1kc3ilVL6HG_pE{B+Ru9Nb#-Ke|Fw2;b_TN z+9U1RDJdc0aVcMm_!^u(H{2EtfJ%b@zlrCA?0#$ za6bU*4lYU(CHpBa^=h^6Lp4khQOGH+uGTY!fOnbM$Vd;YXZaef?{(##{Eent45}Tv zP|MNc6Uf+7x;X-3wq=7(i!He~S==JLdoNb&UOG)CX}H77Rxbj3W>^xI695FkZv#9Ur$y${ofiPKfDk4#ZmvKxZXxYT_ z#_Uk7NLDRc?ZuM=)F1OVxD>TVY<1GzFO@Ob4Xn+2Lwv|RS8EFifTf`oXpQF*{{qpl zG6nSzI+?~Ypz;)&;s>!bwKDG+YcdTL>|vbCMTk9CP{;bzD4YK+&0|(Ja=j!Zkh7m* zqibqwDTaoB)+Q_JO|^^+A%k!TY*11TEjyfoRs!qvjea55Yn5~xl zJ3br+!zrxld#F&gZv5J(g&ZMgP=q%65{8=?FbqxA{xm)L=l98tK#%3MQ8gTPbbTnv zJ$Bd|t#*Um$c^)tBrF&iYT-C&Nt2;x*2MKX`G%ehiWXX3!~2P}z|d%TULO!AdCo5} z1v(h&uA{$Ws+P6d=W91WyHs3;0YNN?$AJ|Mv^iqySq+kU=0@U1%_;(fA&)kjn~;Vk z8;6k%!l5USWx-mkVP=JgiA7HaOA)$1<}a}3{dJwL{T1u#p|FBkM=HfLrKa|vMzE;bh z#9Wj17S}152%!eVq!3}fJ~o7(qL>7%ZM+nZg1~UY36zPDH#E;~T@??wsv%nlm9u6M z_@R2w8wzdUjDFrA%BKqUGuE^Wm)Y9$7vO<*kj()b7x*eP0_yq~m@}s)1}U|kwWhGJ z%%vnkb7FJcbVpW}@r9z$dj)pBBc-9gK6mf?jB)Y}Zuwg_SI({8_@H`YAoq6`>o$Do1XO*0X+;Qn52)d%@P;>tMd#TT9 zTr*v^-9Txl`OhZ|$5N3z0IAG5Y*Ue%cPFgfhH6dk#OqQZ`8DNgX1?Y_U0(jltCc>-hu)O@qPhjD~5#KEFNT^nIqef82MMp6_9h_pSP<9l)GT z#)n*mxjnCEdxa%<%7xW2n~6Od!4M#jic7jDQ9<9%4Ts2ikAV9^Mj9aFq#pznOwWr^=)i91Htv6!xaG*bZfQY4sajZRIm(G|RzIkq+^@s4Z za!J9vg1hDi=iaH_!(A-fOG7d}0I1~qf0C@bwro>vqFdgff^~fqf+trCU7!MKu{j-H z7W?RFOmFNCuO|Y61_FxKttY>=2XY=K94ijFD5k^KYr~) z-+7aFavOU2&T_%iI+w$bcEt`YA9($e7Uprn)cW3uu>4cUS4$SRobq?iaeQ%Zsp-l1X#si+eb$?zNAr^f((2XtShyuQCm4SDI5 zWlQS%c{qv{ga|&(&E2o5r{C$DdwSO7kds!y%ood|Ggv9#$KRo4C(+|{B)0jD&4JiY z_L+C>?z9v29wzV|3#_!Vya_ir=SD>LwIB*jRuwQ>4VhdZve} z_!Ix9`Nj8NDW_at{7IV9+;L3Va<{+W)4y$%wry<{?LOA^j(twYyDTNXw!vHrl}x5C zlF2QXaV-=@oUVWnHyrAcd6M?gt?cVa`iSj!I8T4evnb@~&Q+=W_x1@6xi1~8oQYB@ z#SegOHw94RXkMC1JfJv~VZzpm3yUVLU*9e#t1{0G3}PAKnM*@Crz|O%4Jiz=H^km- zKzKtb<8GlB#Xuj!HJY)}aAh?R9mZTftG$2|x0=f`sS~U#@RoixD_gHC zr-V-8CXZsxC5})sEacqDieiC*wiyxs`Ij{bCg({>uL%U-zx<(fNc?9V#QM6c8eAPq z8V=#&R)4i&T~%wvEEZQL7;|l4j#_KFn}Gy7E=IdD{zuVy#wFRdaTpN+&50w;MS_r) zG#+EpfR-bs#XLeF<86P3 zf^}Pzqp8oJtc(r|X(03hlE((*r;}B*$bf_Bg^2yV4%7_pgkyCZCJ%N9I!E8kx|`!ka*p$2HB^9Oi=W-%tQQ5(rWW^%Ij4Mr6N zKDzHqz1a;t?~ASJU6-GG{<6s26%%yq-ovVs1=W>(5mKdAoixlD*+KFoGhiNxISZKuCIb_tH)F+*(34`E41GMi}vF@m*f%rB23edI##3^q|*5+0evU z8-cIlqrCTQpJIu{#L=sZt#X){^xgu@h?F(bxCBv_U3{B9Hu*V%2fHm>B0hZoGh1c2 zpv>}FMgPX9&GOQ>SJi5t#47ZkuCM=b?b$0si?T~eCeGy-YX-+^r9Tqv$GLS)g??p6 z?(~^xO-+>WjL{3urPP_ci|Q}4s}!teWJ3Z$Ko`mr6YN{;SqArWfLe;Mn?eSJ() z)~*hoEp;~O@AFD|zE5z%yI*#Ecm@`+{(wJLG^1hQNfXE6FGST-A-q` zK$0cKw#TmmZXmO}?`8a>7=}qpAH0b8jsqQ6JN{BL>_j+NScs-&kIlX>9dB)h**rD) zU|pnXg>7xF6jt7xP#&|9jB+7!>uB}%Za(U- zTz=X(JBvt~54#<_xbtB=mimff44-Cg?NJUlD^Y`3c{)^L;GeEjBm za_MK8{lhOm%p~`2KC)CDuAMJ@_08EC;&&z>#fR!#{3iTPw8o1!**RtEHGY0aUzXLp zK3B?^xZ?d|Vh49n=V~@|y*kEg-Ec0M>s?-|s1f+ib);%MBbrvAT;w z>ADk>Im;IJ#={Q>`0~55Y)t(eZ7ugTnpW`FyVixAU0#C+*3xPBNjR3eY*LrK5a%rA zc>eu!ec#plPN(`j3>(RZ+dUJfIOn;8nHbMT3k>o;Xm9Srj&WS>`&4ezlc5Jcmw(Nv5;W88Q8v@9=*CBZJpNKAbn?e$Q8}jd$RFC~;-hRHxOXm#YmgYd)_*YFL9B zzNzw7N9rlhJ`CxsX{`ObL-mo~WZ6cvKObHUtQ~dPn_~sm4rgnO2`#NV_Kjti)tq+R@jck~Wk{3tIh z34W4YwTXJ;aw&J@Is4hb5xu^_gMWj3%(W+OhR?ezR2YCv`D89e@ z%e3$>;FtGM!$;AW!0NB^4$P^6tGg15__;5+le+`y^@jKErsqB$zQ8{XC&v|-*^1$n z3x)&MY#t0OFMRoWwasTjZ8BD+@8!ernT7bZgDE<_p}Rn8znLdK2EG{vl=Y!5t?~0b< z$hz1e-*?s%ADXydU*QG~iSPc6HGT2LF!Ivn^3e@Pocv!p|Zrx1^uQT}NGbaUc4=T}{FwjT z{rBHPRn^=ErI#y#gT#B)Pa|BtGH#vqkq>+zUo7of`w4Z$=Pszkr4)cIgexN9ZbM-M z|2$lDpS(QfwyV4w*5x~irok7b{(W3>A>2#oTfT!ZFq8beJ*csy&Cc2MbCA7IErU$1 zQ(IW{VL4nnTYMgWMJu{qNb0^Eq zTahR^yWoHV&+J$FGeS5=AHm9$)BR0hwaX2wrT^826IF@2YJx9b`7$(ndT$*4Xg7K# zG}_()064bCyXLw0p0m3CrXj6Z!Zt6AW9@KHw^IJSt77`S0_$UH4vK>6LjHkbqv<8; zZ+ofR1P%(2XZP#YIX$?jz`n>`pnhSe&dERx{+P9j{}#W{)sl^L5Yu84|*^waLwY2TMVL2rZpmJjFP?lFW#k1!@NaNO)ORZnIg!vo^AKFl$Q_ zIU5p9p+dBVPwyWbG%TE@!f^_5?}wCM=}NSixkC}#^BLqj@j5xLwQ(6d5->JJ4uEeL zRWSqK(bWB8Mn^2YXwi~OVE+W0b?V5f=%hRWBm%Svoj=~idk3})R7Q3EQL*}MzST*+ zBkpe6Z?Fn%R)O<(f$?*2R(nu1LY7TICvx~zoQ%I=uv~N8i7Wu z({p>VRV~}DQ*e-6me}z80#&`mj_;brIJ*Vt1gAa&xeLolC`w&4mXoLS`^2R|%-7nDKrU02+% zSOndv(5edV5!@BWMx)@I-}=44P?m^y8{iJbEC2`hyv_^vDjA-9!9r4~kqB zH4+Fw5#wdG_)}J6Tzxu&)s;m`K@1g~qzucVHcQ{iw9ebUvfxmI1%eCwyxnkdH-4P!L?yE4QlohVR59d>Aj|5DM8H z6iJmB#%ZprdU=Wbjq7hEg+}_#>OfpCSWZAECp62_FhYAJJXHt?=I}AD ziwn*ILsP^BAv&UWKPEJ0m~iV&D&otNmAm=BBl=^xpgkJ;_s6S^B@;+I3ecjSQeF89 z+r@z{nv@6n4nQv~p()*M@u|w4d#r(6Cmyaz&H#j`nVsP4QnG?T+QM3!YMxC$V~Tyk zYvSM-YP14OAJNT%oYqA(}3ToMJB)iD&Ci|MSFZbL5Amu8!7jFwG zDQ7lcq>3O*uw^0qG^FzO`z>Qz_}W)ImDSvfGC=7l90UPUr-cTOGhn1!_Cy$v4ELu( z<$yX!5;auO>R(d-*|u7LFI`@d)e)TV`kzNNiBX zyor+KXWdj#2$ES$+iQcx0|~2!_!sII<#5X5j1cGjw>16kME>k5M8WBkg5wyvM7nS@ zT*=ES`$M39<&}HSB;L1rDn94LtjJFzM3CdG=FOzLitoHv8hL8swNgoVI&SOkY*Jw` z`!}g;+R)pj#@rrw7=`K8(iV32SaR2a6iuAP6r9JgP}<(km5VrNK!ABsM_lIL&f?%^2o&oVp` z+L$^69}2HIt_fnO5&JD;v}R+;ZjV(IO4ZeZfT5}2A^aH!ng;A##Hop+4h~YC=qw^& z8VSI^Ju;G}OS_Y|TMRz_-FOw;qI9Fyp{u%gi4LIn4wMMY!q^&02+v=Xhf7=TsV&ega+%zS|=lL>W*bJT6_4n`1asqt_so-(@eg!Uw9y9E3tWZ|Ak~u=E=$$ z)4D-cqt7-JVLT5bCCX+T7@8C;A~oJ^Q30BgU~Ef=ig%aJEUq3@B7M^Q!oNrbst~}teAGXcYke5 zWVDI25&J=G2{Nb`e;5>4bpqufoZ`n}5_ z5^^xI3|qW9{`@@yP%@68i3-7DB{GohI=UxC)8J6J+$_v|=~PtCE0vLSS2&6e}K3yU~uKPPC0f}vwTtQ;mB<1Mr*-$dEjjy4NKl>TJhlBYJ zkL^T%-+&WKjA#j*88&aV%7AyIcFo$_bNGwuR=7RwyWDn}Y92HCszv6Zz2Bk(C1%;x zDo9x%l$TVLq$9<&K9l%R+MZs<%`=j0TDveT`12xu0x=DiR)axx&}MgH@ADx$TuW~t z@e@2sh6=vp9~EH*oTjBau7;^MvJVQ~iEH3VjppJ#j@%Lw!ZV|g9vyJXF2P(!2?e$; z7kDjUCP5LRAeDQQbr?~dsM$j3QAa?2Ld&PbV+nMHP=I&EF#(hylCuo~J2!xM_0R-3 zHi!0d{NkgOtB7HKpSjypas51;#3fa8&1gY2uppZPfKnjn=6U|-5Ao?hW>zr@i$_!O zGw3DZt>h#%K2R~)oWnnjWN0MY6p`I99_^Szm!r!yXZ&fy;veqj`WYj4L^{x866dTL&%+X0KYQPz{p+p@*1T}+Ef*j5a3SDqmvR)8L zq3e^ONFE`6RaU3hL^=pr?Cy!129vsY>rLW#G9kq9d>}j-g>@C^*h*<7TpTA*0`p|% z*UgM?rlrckm*gNwm}gcGdN&wE4E_Aw4!{QMLy+D&kZt-s&kV^SIsqz|n)NA>v(l1) z-fBmR^nuOg6p&@eZXgl^RtZ9Y1%FiDZb5ydO>$&2B+Sf#;E_R06fY%Bn1OG>?l3&P zJMg_J>KF&mg-VqWMCiA$T&AI6d{Qssa|3E4RykmxrFo zL56d@_?i<5p0a@1TseyJ@=zNLuP`qTwlvq#4(;4Mh#5j5ZYCuWd-{D)+{h4?8hP^Xy9>E5S#D!bUx{B9B7V2(Z-IT=ZbmJ4X zzGSisn@(e0e=8d7KUx_5&@16)+UZgAOQ3wILU(;}oO&(|Xg(X36k6hJVH%QMBBv#e za`Em${%LMwYwtD~PpC?G>eWa5K-vC#iveKbRE$A1q~N0FE7!W0Y?mc8Aiw~Hk)R1B zcEEF*z+Mt0If_=>!C4RP8e01C(`1EWh!fN(b<8i=W83xQfV!(wm1g!Qp{@*~w=qx< zy#(z5Swuci9Tb+;Pe?w>QAgk&d3eC}7sx!sJCm&vuNnNZ6DUJSsL8=3|B3oAg!?8Egl9lT;`CE~ zd%*uF-`YX)U}w|%@cFFR*Q_BNM7bWo-t8rO9)#$3{`{D*-}jP@)=z~P2O$Xu=+ZcM zeZ3vG&4UwFd8WqZ@YDvYNt~p($NqN5MI~=G&u5XJDA(NXZS0-L`&00EO9sFBOrymG z_tuL$_37GTzmY_2N`n%Ho|u0qInGV?sz!7695R?faZASR@)mfAW_ovm{%l-~F2gnf zkT12OsU6+fiAQ>%aGfVcSejUgO%SzW9^h_CBFuwke2~oDf$ zINx*TkV$+k$`5+KKS+AYKB*xX`UEN{DGQFY;!mw%HF$|G6=iGO^zV3j-sY}2BR}0- zz2`bIZd&jHmB4Re=^8Nlb7oP&!fu48*mA&u#4S?fDS~ojC_i^#|5?eXv)w5G_*e1E z0EZS?JWWvBK^g(Z^t$D+pTH8Efu95PU_2U?$tf8&M0V-LWuI7ipr>Msgyh?pYd>i zW2*^88zklPQ6zF6g&Op-CAxtgNE-6e6~i z&=v&Nk%Qy+x+zLlZrz9_V@wYp1l`7A>8Bubsz85csVX7v=34M5bb?Nc?ZqGlRfR7Z zKZl?e19;v#hGmS>i1MlUDWiisoa)5foo@f%!ts=jeRMf5B6*7j{|gw>^zIl*Ftxfw z#j6knf1~$^A%-2M7$7M`tF4!J2QtysN9|(U=X5{#ARcv}LZ`^>3Tk`rO#>)AWJY)N zPcS}_%)@2Kb^%Ztzd5$!5*<5p}+4>5RamO~lR%+bd8PAzBrQJ!7H_HaaKid|Iv z=3Hz&i;|R*IL)UpPXSwP&9|iVCP%k~J?ZGVcAb9w}Y&!;!(7nHE93?9YDd<4^`PZ+Go`fo~G{GyB6ftdxEX077 zia;v|!&%xfqxjiwdJiJmSggh~7u5U{k-I~qfvt2Xxs^%~i7!vR6iZ_3F5VcPh`#Cb zSkC(KpI-gSyQe?;q?ZSrxLbFZT2PM1$Sqv=g3H07kWs)R))-440mN(SAv48(X!-Ap z#hh7s@G8a5(6LJK_0I9@4LWYc>vQivyzILsz^m+dRGkcfORR8_Z&9T?RLgiWup?wYgE{$=ie8r;gi@?lVb^+5n+#MpAF;Y%}2Rv)|qJk z6E*%?7aUy&{d!FtOU|hK$L;tUrM}F59=BZFXYIRCeCb7f^?xQg6BZ-n;~F+!cjHT6 zT{xoW`sT_h*LbWO|If4GBCi?-e6ub7@LImUnI%PaU%4{#pN6?rw#ABt!D4C~HfR2+ z-I#Ix@nl^lYheB0zv$0;|IQV>>Q~w?%=zv=Q12CHQuxTOVAOfse>k}KL{lIK9oImVX^6-8rYGS&h6jL^M72nepg4`=)d{o zazM#itV629`uWo1vDkp0-*c)5N-r)tTZerHz%qu?WSFRQA)5TZ;%{qPa;~Lym)0Wr zUGWtTul-PUsWSt`J>HIkD!w|pZ2%}qKy2xedw*g1<8|G>%M}&ZZ5}tDFL-JgsT@Sc z9kf9UG-)BlaY6YpN+KKZx*t^{)i_sosn zyKG^qo>W*CQ&Fdrznf50Q+8-FGcNV@b z4|Mssc40~2QEhHXWD$|O80mBKS8Pe`=1h~G(8IJe$J0}RCI*p_7xSB*+1ZVzd!4^w zegl6z?OA(&Mt8~Of4_JgDIT!4Jbz3S$|}1q@Zw$4a_kN8iuP4~u)0IcGwfprVQ3YS zqSf7T2YyiE`tZvu6Pp;$@X)4PnTP$(z_85Eb0Ojtdp4p^yb4EGnE6L-ROjo2?w(P< zt7@%wImhZHaa`OKPV2meg>CBZ=R2SqV}JFh0vpiYH=2yEDTG=EM_V4eQ+Mu>{bWz9~3J+D>nzm2_co~ba=)#(b`}( zYYt&V*!Xh33`?PlLr$d8mxGARSXN6Itbp@Am6} zUv6%PQWE**q7Sgavb(GL^S=y7cz5krV!sg*ItILM6JY*jP>?9ETPUFvw->+Jh`!!C zlA;{i+>V{)G)qv$uwPXABKFL;tb(El9p^aeTO7=)E-eFa_@QT z#D{jUi9Q3M!lzYdX{v<=8>H?9#f)T;jrk$F!Ajl{=yrX|=j)dk2sQaTDU}IkOq{+_ z6vfgzh{G^##R5^_k%Yudk}K6o#BRv4pvi=t`z{&efTH#KV&Z=V3mm7l$naB^RGwu#}OF3^?k@)yJc3h1e2EE3K4T?v-)kWW=L-#eo>^=wVXlr@ZzgO{jS4xhD&9Y8*h3Gv5tjZcWTGtrwb2>YH`4 zdT1!)oZRC~hbJdYG=6?L6z_PcCURlnTs<)+x+m0 ztEv6^#bs%5pu#ybp=Qw9_kD@2bKYam6vwNTgM}xqW`;d~r}QJ|o5SV(lM$hpMlucu zaO@p7O1~7B8&ZE>7%e{&T6e8{JXEnbi*cYE!+|>_v_Am?s>Eu@(^?Gq;AP)YYE3RS@v>{diq* z>F9H*Cz;_qHASti&d&?y$2DqX7JK`>vAQ=G#+_~a>#uD-yx&w?_)5$vu-JP2hJ)1f z6#`~Z^`;p z*w5U)mfhN(Z;p``fyYY+Xzzw)vcrG&r#VqvHq@LR{18r$D4SNbP!u`rTcaZcf2VAC zEdTsj9KziHl%Z9owfa!+jXkL^NGEB@j}@r{`KmVOJ}jlCS^x`e{^dLIxnVheL6R5y zW~NFRI`(faI+kUW)&B*o8QJ`>brW^#_sNTC4A47gUSQ(9uxJ)-$nSD0^n^pC3)$&r z5+S4P?U4QZiJrCj(eT#}KD+N;eT{uR>Hp;RnYo8K^IlDt%6yh0c%N3?b#fT@cTN*^ z>K`vwzZ717u{}s&Q7?3Xhzl1zITn|9wZQ1q^L0HBBcB)V2tF0Krf>6d zgE@~`Q%m3aZdzRPt@d|4d)e)Tlw!}9r!k9z4mlqdG>nQDPVD4W6nSku{p5LTF-7l7 z3F3Z1WkUeNq;?pAtu7^b}_rC-`l;@xTf z;=|H5AI6KU(-?QK7iD*C_bU3wLs=Ir(7YtEOc z>x8HN_EA*>2^Hbt<-eUBUxXEOz41T9J(+8_nCXATXsF&)@^=4tp#4GJoAQu#k)P+A zVjjGW{imtw%B6Ge4Z|hbI{E%KPLPGQ3Ff~R6DBD(3p)-)m-G9c5}!`pyj5`MRm``` z>+VgNw-sOA_IqBQ9yu!3cdc%;@6}FV_`rp7??uTsw-_KK0$%B0w^QjIqH>)GWEbEeQr>Y8V_PSf~n~Wds%09e8`%8Kij%ywXx6!PHwBcTr1->d8WY77t@z` z9?-MY7}yIG~TgWQ1Y_3TR2L4uYQnLtMYX6ek=d!?uEH)1^%Ts zsvpZ24h;Nf@=LRo@e$Kxp<9<|(8#m?T{J?RkEp(fcdE?fepQR)@o#A$T0Brg5> z@{_}67V z4V_H{aCsSULP^tOr?e~kwf5IT8e6eYSF!dSw{vNWMs3H0NSy_~;l3vS!HF+W?_{)m zJPKdPccw;VX3}5k$@Du~e*D+xM5RWJwT~2G_gJ))SV4NzB|dcrrys}9-fL?pI2zRN zj-$S_*Da0fjI3kq(yYU58W_N+$x!77XIl?B2BPJB)e zU}>uA;c69Gr=GkjQp+m5nq*(HaLl~)(f;(+ql7L!J)lhj`&Jd8isX~O{_jyN42q%DoNsC6)#O&Q*iK*<_&uthG^U+ag0PN6$wB#Bl4s& z0HQ!LXtrC9@1laG6&r~+fz-(H%ju^I&18t%8b$Yr#xzg%zZKk03_Dg6BNpGhUL6j%Tu>m+Z zk8!=wojN;}HH~d6=IiB^-OdBm)WC((2jpPE%F&|9(Aq2zw*=PY}UBL&a;FtAvt;Dut|A2t+>k;3U5m1f|s-H75w_9befivmqcB)mYg4p8X#+2q_|a!{oi&=uj&GRx~tr&0~reYzfv*e(=(vzW);wqc+>Z zfPgHa23oYv)epr#oEVphKTHARsmKHt9N+~yhGXDzUi^3J!dg9;VkTg&;!dDx7K_J! z&)8!jN|>{5WiN!RX`^XOCLcc&pv4fy!pz2dSV)&wHYJ(bBYfzak3{Dy4>Ah=dt8ud z#s6ugBoWJ7r$y9tJaQA?##wV_1*8LLNSunPS(C?-&K#&g4XS4C3F5-p$fb!kvP#^T zS11g+fNIRITWAqf*9PU6SZB1g1xqG-PRA&v4#J5)eiNl$F7+aza-d>n!ds|BdAXcTLaw0Gk5bF2hPGP755Q0^o0(foOP% zYm)dT&(-B#tEdT;y?W_|4OcTV(`s}5LrGhRgGI6w6m=(MTpQjqo?{DxXDkrY%n`{L zC(0@VD`-Yi(V5pYJmoZ1H%-+#)))mqu`I`fhi(WZrRPHt zyiFramqTykkTtE)iu!$(b)6tti3S*!%R;Qo>tqpQY$LK7kx1EQBX1R5y2LE6Cw5CI z-9G%KDC7fTY$f-O9=_*=rdUt=m%#KTu$;3914_fefd;f~a~zA;WEC?}TlmEICkp=w z&%l{Aq|p>|-zFqbnu3Rp%Z(K9Q5aaM#AMR6f&2rB*^no=Z(bz@iJ%fSczdKJpQJWX zkcq;WU>&~=Ste!R6%z?#v%)(avMgYMo@3A=At{lv(~@%e{AQTyqRY6Q5evj8&bO74 z_zk^cb`xEk({RLfW6~BHE~F0X+?Eu#gl0%4w)JZ7nr&tJFceJtg0L-QK20pmDBs&G z?m5?DKs|z&MZ;u_ThV0yH8isXLP+;is;4$$KkVshaPjxGj$Gc}^Z&&CC zJ<|a)SVs9jVGCK}-kx`!Q5~XnPy`b8pC_d@$@9#z@YKsn7L4*7t^4ns>_z-I zOc0kPJewsfu}jKgxBPS8(cloRju8*Y^OJFdUY`6Q1-c{OP0W)2fnr+OwePZKB2&{Ul+ z=R1_G_OEntM3?qULburL?-G@&Y2lf)Ex2O*US8Ld+e-QC3s{XiZ`BPbA!IZc9$q@ZG?1(pH8Xj^{ISr0TS! zGVsZnVGG)h68mqDE$t@2_{bjUSwhOYb2s`gHvb<3(Q$pb=5io?VAO))4v_Q!_b;sN z6~P3`Z!bKfsKP)D9*Ke)q_3~VYMxDUaFB7pkg=rz1_{~;g09RNlejl7!I)4$GbADe zM8*T5OksCH#EWqMy)L`$5Hla;hE_6rtZf$N6_aiFqeK?~h-83pGW!RzDVu(0{%ijj z4Obp9OH4#C021ATnyeNk!BQ-l56Q2SZ5>fY<}+yS$N=DHp`clQ05(j;{2obxaUD+8 zM<+_~Yh#*`R#)ZmoeT^Zi+7^$e}<|V{1%1SbN=I@td(YVzO4k@^2{6~pW@%$;hZ7E zM5R1|`eP%3SaRv}7j+)J$1Gl!u8f+6GJ$M@bP2@F}(wlSl0i(h&P2nhNDp*qx z)QOypb2l8I*+aEiI-2I%Xt0VofjzB)$TKJ7FCctcoD>U55-C8_ei))0nyXncDompB z1NfSo5fG|ym?!&R zmYxbsm0+Z#xbcl}A5|nW#1_%p4%j9&qk&?|0jV-atq$BtU2Q#B{0u0R2QapbZDG%> znpMcOeiq9OylIxZd`I0aji2lH%(phZ#himbTh=g?YA*Kb4-{-_%c*@{i0!uQ+0VX*`%`p>{a(9OmJKUU>f z;KI+lP5@~=6VLk>ticLKDf&@g`YT`I8ApAKTvXcU*+vy`r`MNkH+Dy*9^I9^KSTUlB2^t_7 zu-mrlIyP0mK<<-fM9?~QRunQMX*4)BM8Cr#Di>gJpHD?g4k4#+dZ*)}yc3BAn9;n0 z?Sdy5r!=m5ly7A4zM7445AhNuf`A4*-aH+fJq_B2HnZM6kJw1L#5Frb05$G6BbA_( z3|=Y&g>RYfF@&$;sTd(1nuH^f#R-97c~$7*m*Q}MBOnNKcU4R-OA^qdlT3fFOU)`J z0l_#p)ybn>f6i(uUo+hUthZ;C@9KR^9UF{p&=D7VNj4hkQ1N^&2=M_eL4cN|09FDz zP%g)OzCit~fVH?_vpms5Eup3pXuHvFHR>p_f>vJc0`WXaWoeeO4+OP$kLF&XrsI5_7xefr$SWT1>n?U;VTE?rx|0B{lgpCq6bBlmPc$>012rZSgAF-UTjU zovByFTgQ)$jVL&VkKWThad_FNnE&(TQQgsqwtMm6O<}w4GAwPl8fMlLN^{Znq#%BI z9RJ6nuaEivOr&`y4#$KECQc*iFgSe?`?m7C$0s*sR4Su*D}x1qjz5>u47rmW^Jw|w z<`NuWyZ2(8m$t=>A-!pmWW&LE{QbHN3KBaOWNvhgK9lIJ9fPx(>l2h{84(*;j?VnJ zLvPkA3Pu*U@DArG{P51%96qhojGS-s)1+C?{XeS??~zL@lD&|UBRh@Z9s=6sZLn2Ln z(v)tdK$^SS`Tk@qR{sSIPxbGK^-5}$&|!QG++RR3GFjhPtf5`(Duy4DMFd%8&7eT@ z%Atq~31tOI7(6Vam1^hIL zM;Ir1iB*ngx${XT3j_4+R_6C?;TddD4o=B@S6Pl65v2%Cdb#V+pHpR@t0MM);p=iA^$HO0{i$@?S zEs2Va-HCkNVym(;U{!eBL~96%O$B-LWMH=Fk|O+PRAKGoaYDWta*5xUY?oa!2H1O@ zKt`bq``1QKoI9f&{Y=cGaBQV(lPmkYchK%i2F}hLzM0gm6d3sPLAk2)Stk+QK?B?| zxiJ7zRm&h*J9`BEJxi%jblh&x>CKXU?XLA@@vPj5bQqqB;I*z-zstpMNf#eGM(-JDM#bU@=`bLFpTe&lO z=~9>v{3J02$=>`PErad}#JSeu3%;qy?Qp`g?nak>`jw(-Z_h_Nw{(s7Uc?#75Ht(#H2~yhUH!G;E4QzUd~79gh~@w!yP@z}`b0lQY3_uf7|tE=7i5`g{()I6u6KW?x) zuS`N$V7K6jo$ORj>~==V2gTb;+I$Axe^Pmd(fB??A#q_kw5_;o7-U2%()KuEfZyk(KTZ-p^6!YUc5&cw z_so|=#m5}G>_XCCuNy1+3i@6OKl0}cB%SQf|IuL-a|VeQk47v;e%NnbKQ|TkGlsHs zuO(6>d?MRBYUpt9x>J*1P{V+vU;jqiNs~vGSvAiecKBScxxc_&JH23S⋘+s;lTy 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

    }_ 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菊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