feat: require Vite 8 or newer (#320)

* feat: require Vite 8 or newer

* test: keep Vite coverage in a matrix

Author: birkskyum

.changeset/vite-8-minimum.md

@@ -0,0 +1,5 @@
+---
+'@solidjs/vite-plugin': patch
+---
+
+Require Vite 8 or newer and remove the Vite 6 and 7 compatibility paths.

.github/workflows/vitest.yml

@@ -12,7 +12,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        example: [vite-6, vite-7, vite-8]
+        example: [vite-8]
 
     runs-on: ubuntu-22.04
     steps:

README.md

@@ -27,13 +27,13 @@ Join [solid discord](https://discord.com/invite/solidjs) and check the [troubles
 
 ## Requirements
 
-This module is 100% ESM compatible and requires NodeJS `14.18.0` or later.
+This module is 100% ESM compatible and requires Node.js `^20.19.0 || >=22.12.0`.
 
-You can check your current version of NodeJS by typing `node -v` in your terminal. If your version is below that one version I'd encourage you to either do an update globally or use a NodeJS version management tool such as [Volta](https://volta.sh/) or [nvm](https://github.com/nvm-sh/nvm).
+You can check your current Node.js version by running `node -v`. Use a version
+manager such as [Volta](https://volta.sh/) or [nvm](https://github.com/nvm-sh/nvm)
+to update it.
 
-Supported Vite versions: **Vite 6, 7 and 8**. Support for Vite 3–5 was
-dropped; if you are on an older Vite, stay on an earlier release of this
-plugin (2.x) or upgrade Vite.
+Supported Vite versions: **Vite 8 and 9**.
 
 ## Quickstart
 
@@ -230,7 +230,7 @@ With `ssr: true` — **SSR start mode**:
   classic `vite build` + `vite build --ssr` two-step, work too.)
 - **Build ordering**: server builds read the client manifest, so with `ssr`
   enabled the plugin also orders builder-mode (environments API) app builds
-  client-first via a `buildApp` hook (Vite 7.1+). That covers composed
+  client-first via a `buildApp` hook. That covers composed
   setups whose own orchestrator builds server environments before the
   client — e.g. @cloudflare/vite-plugin — with no hand-written ordering
   plugin; setups without another orchestrator keep Vite's stock

examples/css-matrix/server.js

@@ -59,7 +59,7 @@ async function start() {
 
       let render;
       if (!isProduction) {
-        ({ render } = await vite.ssrLoadModule('/src/entry-server.tsx'));
+        ({ render } = await vite.environments.ssr.runner.import('/src/entry-server.tsx'));
       } else {
         ({ render } = await import('./dist/server/entry-server.js'));
       }
@@ -86,7 +86,6 @@ async function start() {
         },
       });
     } catch (e) {
-      if (!isProduction) vite.ssrFixStacktrace(e);
       console.error(e);
       res.statusCode = 500;
       res.end(e.message);

examples/css-matrix/test/bridge.mjs

@@ -71,7 +71,7 @@ try {
   const loadManifestModule = async () => {
     const node = ssrEnv.moduleGraph.getModuleById('\0virtual:solid-manifest');
     if (node) ssrEnv.moduleGraph.invalidateModule(node);
-    return (await server.ssrLoadModule('virtual:solid-manifest')).default;
+    return (await ssrEnv.runner.import('virtual:solid-manifest')).default;
   };
 
   // ---- Protocol over plain HTTP ------------------------------------------

examples/ssr/server.js

@@ -58,7 +58,7 @@ async function start() {
 
       let render;
       if (!isProduction) {
-        ({ render } = await vite.ssrLoadModule('/src/entry-server.tsx'));
+        ({ render } = await vite.environments.ssr.runner.import('/src/entry-server.tsx'));
       } else {
         ({ render } = await import('./dist/server/entry-server.js'));
       }
@@ -90,7 +90,6 @@ async function start() {
         },
       });
     } catch (e) {
-      if (!isProduction) vite.ssrFixStacktrace(e);
       console.error(e);
       res.statusCode = 500;
       res.end(e.message);

examples/start-env/vite.config.ts

@@ -20,6 +20,11 @@ import solidPlugin from '@solidjs/vite-plugin';
 //   server key (config-time error — boot validation is synchronous so the
 //   server chunk carries no top-level await).
 export default defineConfig({
+  future: {
+    removePluginHookHandleHotUpdate: 'warn',
+    removePluginHookSsrArgument: 'warn',
+    removeSsrLoadModule: 'warn',
+  },
   plugins: [
     solidPlugin({
       start: {

examples/start-ssr/test/host-dispatch.mjs

@@ -26,8 +26,9 @@ try {
   const match = /createServerReference\w*\("([^"]*-getServerMessage)"/.exec(transformed?.code || '');
   if (!match) throw new Error('could not extract function id from transformed module');
 
-  await server.ssrLoadModule('virtual:solid-server-function-manifest');
-  const handler = await server.ssrLoadModule('virtual:solid-server-function-handler');
+  const runner = server.environments.ssr.runner;
+  await runner.import('virtual:solid-server-function-manifest');
+  const handler = await runner.import('virtual:solid-server-function-handler');
   const response = await handler.handleServerFunctionRequest(
     new Request(
       `http://localhost${handler.endpoint}?id=${encodeURIComponent(match[1])}&args=${encodeURIComponent('["host"]')}`,

examples/start-ssr/test/http-bridge.mjs

@@ -193,8 +193,7 @@ try {
   );
 
   // ---- Abort propagation ----------------------------------------------------
-  // The middleware runs in-process (ssrLoadModule), so the probe global it
-  // records on is this very globalThis.
+  // The middleware shares this process, including the probe global.
   const probe = () => globalThis.__solidBridgeProbe ?? { aborts: 0, cancels: 0 };
   {
     const abortsBefore = probe().aborts;

examples/start-ssr/test/run.mjs

@@ -40,7 +40,7 @@
 //   - `serverFunctions.devMiddleware: false` keeps compilation on while the
 //     middleware no longer intercepts `/_server` (a dev POST 404s), and a
 //     host emulation (test/host-dispatch.mjs) proves the manifest + handler
-//     virtual modules still dispatch through `ssrLoadModule`,
+//     virtual modules still dispatch through the SSR module runner,
 //   - builder-order: with an adversarial `builder.buildApp` that builds the
 //     ssr environment first (mimicking e.g. @cloudflare/vite-plugin), the
 //     plugin's client-build-first hook still gets the client manifest baked
@@ -1791,7 +1791,7 @@ async function runConfigureMode() {
 // 404. Then test/host-dispatch.mjs emulates the host that owns dispatch
 // instead (a metaframework or an environment plugin like
 // @cloudflare/vite-plugin): manifest + handler virtual modules loaded
-// through `ssrLoadModule`, request dispatched like production.
+// through the SSR module runner, request dispatched like production.
 async function runNoMiddlewareMode() {
   const mode = 'no-middleware';
   console.log(`\n=== ${mode.toUpperCase()} ===`);
@@ -2721,7 +2721,9 @@ async function runMiddlewareMode() {
       // middleware route reading getRequestEvent()) carries exactly those
       // fields — createRequestEvent(request, options.event) spreads them
       // over the event defaults.
-      const handlerModule = await probe.ssrLoadModule('virtual:solid-ssr-handler');
+      const handlerModule = await probe.environments.ssr.runner.import(
+        'virtual:solid-ssr-handler',
+      );
       const seamResponse = await handlerModule.handleRequest(
         new Request('http://localhost/api/native', { headers: { accept: 'application/json' } }),
         { event: { nativeEvent: { socket: { remoteAddress: '203.0.113.7' } } } },
@@ -3193,7 +3195,7 @@ async function runExternalMode() {
     server = await createServer({ root: exampleDir, server: { middlewareMode: true } });
     const clientModule = await server.environments.client.transformRequest('/src/api.ts');
     const functionId = extractFunctionId(clientModule?.code || '', 'getServerMessage');
-    const handler = await server.ssrLoadModule('virtual:solid-ssr-handler');
+    const handler = await server.environments.ssr.runner.import('virtual:solid-ssr-handler');
     const response = await handler.handleRequest(new Request('http://localhost/'));
     const html = await response.text();
     record(