@solidjs/start 2.0.0-beta.0 → 2.0.0-beta.2

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @solidjs/start
 
+## 2.0.0-beta.2
+
+### Patch Changes
+
+- 3e961e0: Require Vite 8
+- 11907a2: Fix published package missing `dist/`: pnpm 11 respects `.gitignore` when packing a package without a `files` field, so `2.0.0-beta.1` was published without its build output. Add an explicit `files` field.
+
+## 2.0.0-beta.1
+
+### Patch Changes
+
+- ee1193a: Update srvx to maintain response compatibility with Nitro v3.
+- e263338: Fix `ERR_UNSUPPORTED_ESM_URL_SCHEME` when running `vite preview` on Windows
+
 ## 2.0.0-beta.0
 
 ### Minor Changes

package/dist/config/dev-server.js

@@ -6,6 +6,8 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
     }
     return path;
 };
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
 import { NodeRequest, sendNodeResponse } from "srvx/node";
 import { isRunnableDevEnvironment, } from "vite";
 import { VITE_ENVIRONMENTS } from "./constants.js";
@@ -18,7 +20,7 @@ export function devServer() {
                     server.middlewares.use(async (req, res) => {
                         res.setHeader("content-encoding", "identity");
                         const webReq = new NodeRequest({ req, res });
-                        const def = await import(__rewriteRelativeImportExtension(process.cwd() + "/dist/server/entry-server.js", true));
+                        const def = await import(__rewriteRelativeImportExtension(pathToFileURL(join(process.cwd(), "dist/server/entry-server.js")).href, true));
                         sendNodeResponse(res, await def.default.fetch(webReq));
                     });
                 };

package/dist/config/fs-router.d.ts

@@ -23,7 +23,6 @@ export declare class SolidStartServerFileRouter extends BaseFileSystemRouter {
     });
     toPath(src: string): string;
     toRoute(src: string): {
-        path: string;
         page: boolean;
         $component: {
             src: string;
@@ -33,5 +32,6 @@ export declare class SolidStartServerFileRouter extends BaseFileSystemRouter {
             src: string;
             pick: string[];
         } | undefined;
+        path: string;
     } | undefined;
 }

package/dist/http/index.d.ts

@@ -63,10 +63,10 @@ export declare const handleCacheHeaders: WrapFunction<typeof h3.handleCacheHeade
 export declare const handleCors: WrapFunction<typeof h3.handleCors>;
 export declare const appendCorsHeaders: WrapFunction<typeof h3.appendCorsHeaders>;
 export declare const appendCorsPreflightHeaders: WrapFunction<typeof h3.appendCorsPreflightHeaders>;
-export declare const appendHeader: (name: string, value: string | string[]) => void;
-export declare const appendHeaders: (values: Record<string, string>) => void;
-export declare const setHeader: (name: string, value: string | string[]) => void;
-export declare const setHeaders: (values: Record<string, string>) => void;
+export declare const appendHeader: typeof appendResponseHeader;
+export declare const appendHeaders: typeof appendResponseHeaders;
+export declare const setHeader: typeof setResponseHeader;
+export declare const setHeaders: typeof setResponseHeaders;
 export declare const getHeader: WrapFunction<typeof h3.getRequestHeader>;
 export declare const getHeaders: WrapFunction<typeof h3.getRequestHeaders>;
 export declare const getRequestFingerprint: WrapFunction<typeof h3.getRequestFingerprint>;

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "@solidjs/start",
-  "version": "2.0.0-beta.0",
+  "version": "2.0.0-beta.2",
   "type": "module",
+  "files": [
+    "dist",
+    "env.d.ts",
+    "CHANGELOG.md"
+  ],
   "repository": {
     "type": "git",
     "url": "git+https://github.com/solidjs/solid-start.git",
@@ -48,27 +53,28 @@
     "shiki": "^1.29.2",
     "solid-js": "^1.9.11",
     "source-map-js": "^1.2.1",
-    "srvx": "^0.11.9",
+    "srvx": "^0.11.22",
     "terracotta": "^1.1.0",
     "vite-plugin-solid": "^2.11.11"
   },
   "engines": {
-    "node": ">=22"
+    "node": ">=24"
   },
   "devDependencies": {
     "@types/babel__core": "^7.20.5",
     "@types/node": "^25.5.0",
-    "vite": "^7.3.1",
+    "vite": "^8.0.0",
     "vitest": "^4.1.0"
   },
   "peerDependencies": {
-    "vite": "^7 || ^8"
+    "vite": "^8"
   },
   "scripts": {
     "build": "pnpm validate-imports && tsc && node scripts/build.js",
     "dev": "tsc --watch",
     "test": "vitest",
     "test:ci": "vitest run",
+    "typecheck:dist": "pnpm build && pnpx @arethetypeswrong/cli --pack . --profile esm-only",
     "validate-imports": "node scripts/validate-imports.js"
   }
 }

package/scripts/build.js

@@ -1,15 +0,0 @@
-import * as fs from "node:fs/promises";
-import * as path from "node:path";
-import glob from "fast-glob";
-
-const files = await glob("**/*.{js,css}", { cwd: `${process.cwd()}/src` });
-
-await Promise.all(
-  files.map(file =>
-    fs.cp(
-      path.join(import.meta.dirname, "../src", file),
-      path.join(import.meta.dirname, "../dist", file),
-      { recursive: true },
-    ),
-  ),
-);

package/scripts/validate-imports.js

@@ -1,316 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Import Extension Validation Script for SolidStart
- *
- * This script validates that all relative imports in the src/ directory have
- * explicit file extensions, which is mandated by Node.js ESM (ES Modules).
- *
- * Node.js requires explicit file extensions for relative imports when using
- * ES modules to avoid ambiguity and improve performance. This script ensures
- * compliance with this requirement.
- *
- * Features:
- * - Scans all .ts and .tsx files in the src/ directory recursively
- * - Detects relative imports (starting with ./ or ../) without extensions
- * - Prevents .js/.jsx imports in TypeScript files (should use .ts/.tsx)
- * - Ignores commented code, CSS imports, and dynamic imports (handled by bundlers)
- * - Provides detailed error reporting with line numbers and suggestions
- * - Exits with appropriate status codes for CI/CD integration
- *
- * Usage:
- *   npm run validate-imports
- *
- * Exit codes:
- *   0 - All relative imports have valid extensions
- *   1 - Found relative imports without extensions
- *
- * Valid extensions for TypeScript files: .ts, .tsx, .json
- * Invalid extensions for TypeScript files: .js, .jsx (use .ts/.tsx instead)
- *
- * @example
- * // ❌ Invalid - missing extension
- * import { config } from "./config/index";
- *
- * // ❌ Invalid - .js extension in TypeScript file
- * import { config } from "./config/index.js";
- *
- * // ✅ Valid - has .ts extension
- * import { config } from "./config/index.ts";
- *
- * // ✅ Valid - external package import (no extension needed)
- * import { something } from "external-package";
- */
-
-import { readFileSync, readdirSync, statSync } from "node:fs";
-import { join, dirname, extname } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-// Configuration
-const SRC_DIR = join(__dirname, "..", "src");
-const VALID_EXTENSIONS = [".ts", ".tsx", ".json"];
-const INVALID_EXTENSIONS = [".js", ".jsx"];
-const FILE_EXTENSIONS = [".ts", ".tsx"];
-
-/**
- * Recursively find all files with specified extensions
- */
-function findFiles(dir, extensions, files = []) {
-  try {
-    const entries = readdirSync(dir);
-
-    for (const entry of entries) {
-      const fullPath = join(dir, entry);
-      const stat = statSync(fullPath);
-
-      if (stat.isDirectory()) {
-        findFiles(fullPath, extensions, files);
-      } else if (extensions.includes(extname(entry))) {
-        files.push(fullPath);
-      }
-    }
-  } catch (error) {
-    console.error(`Error reading directory ${dir}: ${error.message}`);
-  }
-
-  return files;
-}
-
-/**
- * Check if a path is a relative import (starts with . or ..)
- */
-function isRelativeImport(path) {
-  return path.startsWith("./") || path.startsWith("../");
-}
-
-/**
- * Check if an import path has a valid file extension
- */
-function hasValidExtension(path) {
-  return VALID_EXTENSIONS.some(ext => path.endsWith(ext));
-}
-
-/**
- * Check if an import path has an invalid extension for TypeScript files
- */
-function hasInvalidExtension(path) {
-  return INVALID_EXTENSIONS.some(ext => path.endsWith(ext));
-}
-
-/**
- * Extract import/export statements from file content
- * Matches both import and export statements with from clauses
- */
-function extractImportExportStatements(content, filePath) {
-  const statements = [];
-  const lines = content.split("\n");
-
-  // Regex patterns for different import/export statements
-  const patterns = [
-    // Standard imports: import { ... } from '...'
-    /import\s+(?:(?:\{[^}]*\}|\*\s+as\s+\w+|\w+)\s+from\s+)?['"`]([^'"`]+)['"`]/g,
-    // Export from: export { ... } from '...'
-    /export\s+(?:\{[^}]*\}|\*)\s+from\s+['"`]([^'"`]+)['"`]/g,
-    // Export default from: export { default } from '...'
-    /export\s+\{\s*default\s*\}\s+from\s+['"`]([^'"`]+)['"`]/g,
-    // Note: Dynamic imports are excluded as they're handled by bundlers
-  ];
-
-  lines.forEach((line, lineNumber) => {
-    const trimmedLine = line.trim();
-
-    // Skip commented lines, dynamic imports, and TypeScript type-only imports in d.ts files
-    if (
-      trimmedLine.startsWith("//") ||
-      trimmedLine.startsWith("/*") ||
-      trimmedLine.startsWith("*") ||
-      (filePath.endsWith(".d.ts") && trimmedLine.includes("import(")) ||
-      // Skip CSS imports as they're handled by bundlers
-      /import\s+['"`][^'"`]*\.css['"`]/.test(trimmedLine) ||
-      // Skip dynamic imports as they're handled by bundlers
-      /import\s*\(\s*['"`]/.test(trimmedLine)
-    ) {
-      return;
-    }
-
-    patterns.forEach(pattern => {
-      let match;
-      // Reset regex lastIndex to avoid issues with global flag
-      pattern.lastIndex = 0;
-      while ((match = pattern.exec(line)) !== null) {
-        const importPath = match[1];
-        if (importPath) {
-          statements.push({
-            path: importPath,
-            line: lineNumber + 1,
-            fullLine: line.trim(),
-            filePath,
-          });
-        }
-      }
-    });
-  });
-
-  return statements;
-}
-
-/**
- * Validate a single file for relative imports without extensions
- */
-function validateFile(filePath) {
-  const errors = [];
-
-  try {
-    const content = readFileSync(filePath, "utf8");
-    const statements = extractImportExportStatements(content, filePath);
-
-    statements.forEach(statement => {
-      if (isRelativeImport(statement.path)) {
-        if (hasInvalidExtension(statement.path)) {
-          errors.push({
-            file: filePath,
-            line: statement.line,
-            importPath: statement.path,
-            fullLine: statement.fullLine,
-            type: "invalid-extension",
-          });
-        } else if (!hasValidExtension(statement.path)) {
-          errors.push({
-            file: filePath,
-            line: statement.line,
-            importPath: statement.path,
-            fullLine: statement.fullLine,
-            type: "missing-extension",
-          });
-        }
-      }
-    });
-  } catch (error) {
-    console.error(`Error reading file ${filePath}: ${error.message}`);
-  }
-
-  return errors;
-}
-
-/**
- * Main validation function
- */
-function validateImports() {
-  console.log("🔍 Validating relative imports in src/ directory...\n");
-
-  // Find all TypeScript/TSX files in src directory
-  const files = findFiles(SRC_DIR, FILE_EXTENSIONS);
-
-  if (files.length === 0) {
-    console.log("⚠️  No TypeScript files found in src/ directory");
-    process.exit(0);
-  }
-
-  console.log(`📁 Scanning ${files.length} files...\n`);
-
-  let totalErrors = 0;
-  const errorsByFile = new Map();
-
-  // Validate each file
-  files.forEach(file => {
-    const errors = validateFile(file);
-    if (errors.length > 0) {
-      errorsByFile.set(file, errors);
-      totalErrors += errors.length;
-    }
-  });
-
-  // Report results
-  if (totalErrors === 0) {
-    console.log("✅ All relative imports have valid extensions!");
-    process.exit(0);
-  } else {
-    const missingExtensionErrors = [];
-    const invalidExtensionErrors = [];
-
-    errorsByFile.forEach(errors => {
-      errors.forEach(error => {
-        if (error.type === "missing-extension") {
-          missingExtensionErrors.push(error);
-        } else if (error.type === "invalid-extension") {
-          invalidExtensionErrors.push(error);
-        }
-      });
-    });
-
-    if (missingExtensionErrors.length > 0) {
-      console.log(
-        `❌ Found ${missingExtensionErrors.length} relative import(s) without extensions:\n`,
-      );
-
-      const missingByFile = new Map();
-      missingExtensionErrors.forEach(error => {
-        if (!missingByFile.has(error.file)) {
-          missingByFile.set(error.file, []);
-        }
-        missingByFile.get(error.file).push(error);
-      });
-
-      missingByFile.forEach((errors, file) => {
-        const relativePath = file.replace(process.cwd(), "").replace(/^\//, "");
-        console.log(`📄 ${relativePath}:`);
-
-        errors.forEach(error => {
-          console.log(`  Line ${error.line}: ${error.importPath}`);
-          console.log(`    ${error.fullLine}`);
-          console.log(
-            `    ${"".padStart(error.fullLine.indexOf(error.importPath), " ")}${"".padStart(error.importPath.length, "^")}`,
-          );
-        });
-        console.log("");
-      });
-    }
-
-    if (invalidExtensionErrors.length > 0) {
-      console.log(
-        `❌ Found ${invalidExtensionErrors.length} relative import(s) with invalid extensions:\n`,
-      );
-
-      const invalidByFile = new Map();
-      invalidExtensionErrors.forEach(error => {
-        if (!invalidByFile.has(error.file)) {
-          invalidByFile.set(error.file, []);
-        }
-        invalidByFile.get(error.file).push(error);
-      });
-
-      invalidByFile.forEach((errors, file) => {
-        const relativePath = file.replace(process.cwd(), "").replace(/^\//, "");
-        console.log(`📄 ${relativePath}:`);
-
-        errors.forEach(error => {
-          console.log(`  Line ${error.line}: ${error.importPath}`);
-          console.log(`    ${error.fullLine}`);
-          console.log(
-            `    ${"".padStart(error.fullLine.indexOf(error.importPath), " ")}${"".padStart(error.importPath.length, "^")}`,
-          );
-        });
-        console.log("");
-      });
-    }
-
-    console.log("💡 Tips:");
-    if (missingExtensionErrors.length > 0) {
-      console.log('  - Add file extensions to relative imports (e.g., "./file" → "./file.ts")');
-    }
-    if (invalidExtensionErrors.length > 0) {
-      console.log("  - Replace .js/.jsx with .ts/.tsx in TypeScript files");
-    }
-    console.log("  - This is required by Node.js ESM modules");
-    console.log("  - Valid extensions for TypeScript files: " + VALID_EXTENSIONS.join(", "));
-    console.log("  - Invalid extensions for TypeScript files: " + INVALID_EXTENSIONS.join(", "));
-
-    process.exit(1);
-  }
-}
-
-// Run the validation
-validateImports();

package/src/client/StartClient.tsx

@@ -1,34 +0,0 @@
-// @refresh skip
-import App from "solid-start:app";
-import type { JSX } from "solid-js";
-import { ErrorBoundary } from "../shared/ErrorBoundary.tsx";
-
-function Dummy(props: { children: JSX.Element }) {
-  return props.children;
-}
-
-/**
- *
- * Read more: https://docs.solidjs.com/solid-start/reference/client/start-client
- */
-export function StartClient() {
-  return (
-    <Dummy>
-      <Dummy>
-        <ErrorBoundary>
-          <App />
-        </ErrorBoundary>
-      </Dummy>
-    </Dummy>
-  );
-}
-
-export function StartClientTanstack() {
-  return (
-    <Dummy>
-      <ErrorBoundary>
-        <App />
-      </ErrorBoundary>
-    </Dummy>
-  );
-}

package/src/client/index.tsx

@@ -1,2 +0,0 @@
-export { mount } from "./mount.ts";
-export { StartClient, StartClientTanstack } from "./StartClient.tsx";

package/src/client/mount.ts

@@ -1 +0,0 @@
-export { hydrate as mount } from "solid-js/web"

package/src/client/spa/index.tsx

@@ -1,9 +0,0 @@
-// @refresh skip
-import type { JSX } from "solid-js";
-import { render, type MountableElement } from "solid-js/web";
-
-export function mount(fn: () => JSX.Element, el: MountableElement) {
-  render(fn, el);
-}
-
-export { StartClient } from "../StartClient.tsx";

package/src/config/constants.ts

@@ -1,19 +0,0 @@
-export const DEFAULT_EXTENSIONS = ["js", "jsx", "ts", "tsx"];
-
-export const CLIENT_BASE_PATH = "_build";
-
-export const VIRTUAL_MODULES = {
-  clientViteManifest: "solid-start:client-vite-manifest",
-  getClientManifest: "solid-start:get-client-manifest",
-  getManifest: "solid-start:get-manifest",
-  middleware: "solid-start:middleware",
-  serverFnManifest: "solid-start:server-fn-manifest",
-  clientEntry: "solid-start:client-entry",
-  serverEntry: "solid-start:server-entry",
-  app: "solid-start:app",
-} as const;
-
-export const VITE_ENVIRONMENTS = {
-  client: "client" as const,
-  server: "ssr" as const,
-};

package/src/config/dev-server.ts

@@ -1,157 +0,0 @@
-import { NodeRequest, sendNodeResponse } from "srvx/node";
-import {
-  type Connect,
-  isRunnableDevEnvironment,
-  type PluginOption,
-  type ViteDevServer,
-} from "vite";
-import { VITE_ENVIRONMENTS } from "./constants.ts";
-
-export function devServer(): Array<PluginOption> {
-  return [
-    {
-      name: "solid-start-dev-server",
-      configurePreviewServer(server) {
-        return () => {
-          server.middlewares.use(async (req, res) => {
-            res.setHeader("content-encoding", "identity");
-            const webReq = new NodeRequest({ req, res });
-            const def: {
-              default: { fetch: (req: Request) => Promise<Response> };
-            } = await import(process.cwd() + "/dist/server/entry-server.js");
-            sendNodeResponse(res, await def.default.fetch(webReq));
-          });
-        };
-      },
-      configureServer(viteDevServer) {
-        (globalThis as any).VITE_DEV_SERVER = viteDevServer;
-        return async () => {
-          if (viteDevServer.config.server.middlewareMode) return;
-
-          const serverEnv = viteDevServer.environments[VITE_ENVIRONMENTS.server];
-
-          if (!serverEnv) throw new Error("Server environment not found");
-          if (
-            // do not check via `isFetchableDevEnvironment` since nitro does implement the `FetchableDevEnvironment` interface but not via inheritance (which this helper checks)
-            "dispatchFetch" in serverEnv
-          )
-            return;
-          // another plugin is controlling the dev server
-          if (!isRunnableDevEnvironment(serverEnv)) {
-            return;
-          }
-
-          globalThis.USING_SOLID_START_DEV_SERVER = true;
-
-          removeHtmlMiddlewares(viteDevServer);
-
-          viteDevServer.middlewares.use(async (req, res) => {
-            if (req.originalUrl) {
-              req.url = req.originalUrl;
-            }
-            const webReq = new NodeRequest({ req, res });
-
-            try {
-              const serverEntry: {
-                default: { fetch: (req: Request) => Promise<Response> };
-              } = await serverEnv.runner.import("./src/entry-server.tsx");
-
-              const webRes = await serverEntry.default.fetch(webReq);
-
-              return sendNodeResponse(res, webRes);
-            } catch (e: unknown) {
-              console.error(e);
-              viteDevServer.ssrFixStacktrace(e as Error);
-
-              if (webReq.headers.get("content-type")?.includes("application/json")) {
-                return sendNodeResponse(
-                  res,
-                  Response.json(
-                    {
-                      status: 500,
-                      error: "Internal Server Error",
-                      message: "An unexpected error occurred. Please try again later.",
-                      timestamp: new Date().toISOString(),
-                    },
-                    {
-                      status: 500,
-                      headers: {
-                        "Content-Type": "application/json",
-                      },
-                    },
-                  ),
-                );
-              }
-
-              return sendNodeResponse(
-                res,
-                new Response(
-                  `
-                    <!DOCTYPE html>
-                    <html lang="en">
-                      <head>
-                        <meta charset="UTF-8" />
-                        <title>Error</title>
-                        <script type="module">
-                          import { ErrorOverlay } from '/@vite/client'
-                          document.body.appendChild(new ErrorOverlay(${JSON.stringify(
-                            prepareError(req, e),
-                          ).replace(/</g, "\\u003c")}))
-                        </script>
-                      </head>
-                      <body>
-                      </body>
-                    </html>
-                  `,
-                  {
-                    status: 500,
-                    headers: { "Content-Type": "text/html" },
-                  },
-                ),
-              );
-            }
-          });
-        };
-      },
-    },
-  ];
-}
-
-/**
- * Removes Vite internal middleware
- *
- * @param server
- */
-function removeHtmlMiddlewares(server: ViteDevServer) {
-  const html_middlewares = [
-    "viteIndexHtmlMiddleware",
-    "vite404Middleware",
-    "viteSpaFallbackMiddleware",
-  ];
-  for (let i = server.middlewares.stack.length - 1; i > 0; i--) {
-    if (
-      html_middlewares.includes(
-        // @ts-expect-error
-        server.middlewares.stack[i].handle.name,
-      )
-    ) {
-      server.middlewares.stack.splice(i, 1);
-    }
-  }
-}
-
-/**
- * Formats error for SSR message in error overlay
- * @param req
- * @param error
- * @returns
- */
-function prepareError(req: Connect.IncomingMessage, error: unknown) {
-  const e = error as Error;
-  return {
-    message: `An error occured while server rendering ${req.url}:\n\n\t${
-      typeof e === "string" ? e : e.message
-    } `,
-    stack: typeof e === "string" ? "" : e.stack,
-  };
-}