@pracht/vite-plugin 0.3.2 → 0.4.1

package/README.md

@@ -27,6 +27,28 @@ export default defineConfig({
 - Pre-renders SSG and ISG routes at build time (`prerenderConcurrency` controls parallelism)
 - Provides HMR during development
 
+## TSRX (`.tsrx`) Support
+
+`.tsrx` modules — TSRX/Ripple-flavoured Preact components — are supported out
+of the box. Bring your own
+[`@tsrx/vite-plugin-preact`](https://github.com/Ripple-TS/ripple) and add it to
+your `plugins` array alongside `pracht()`:
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { pracht } from "@pracht/vite-plugin";
+import { tsrxPreact } from "@tsrx/vite-plugin-preact";
+
+export default defineConfig({
+  plugins: [tsrxPreact(), pracht()],
+});
+```
+
+The pracht plugin globs `.tsrx` files alongside `.tsx` for routes and shells
+(both manifest- and pages-router modes), and its server-only export stripping
+pass treats them the same way — no separate pracht option is required.
+
 ## Peer Dependencies
 
 - `vite@^8.0.0`

package/dist/index.d.mts

@@ -30,7 +30,7 @@ interface PrachtAdapter {
    * Additional Vite plugins the adapter needs (e.g. `@cloudflare/vite-plugin`).
    * Returned plugins are appended to the plugin array returned by `pracht()`.
    */
-  vitePlugins?(): Plugin[] | Promise<Plugin[]>;
+  vitePlugins?(): Plugin[];
   /**
    * If true, the adapter owns dev-server request handling and the vite-plugin
    * will not install its own SSR middleware. Used when the adapter contributes
@@ -62,6 +62,8 @@ interface PrachtPluginOptions {
   pagesDefaultRender?: RenderMode$1;
   /** Maximum number of SSG/ISG pages rendered concurrently during `pracht build`. */
   prerenderConcurrency?: number;
+  /** Maximum request body size (bytes) accepted by the dev SSR middleware. Defaults to 1 MiB. */
+  maxBodySize?: number;
 }
 //#endregion
 //#region src/plugin-codegen.d.ts
@@ -75,6 +77,6 @@ declare function createPrachtServerModuleSource(options?: PrachtPluginOptions, b
 declare function createPrachtRegistryModuleSource(options?: PrachtPluginOptions): string;
 //#endregion
 //#region src/index.d.ts
-declare function pracht(options?: PrachtPluginOptions): Promise<Plugin[]>;
+declare function pracht(options?: PrachtPluginOptions): Plugin[];
 //#endregion
 export { PRACHT_CLIENT_MODULE_ID, PRACHT_SERVER_MODULE_ID, type PrachtAdapter, type PrachtPluginOptions, type RenderMode, createPrachtClientModuleSource, createPrachtRegistryModuleSource, createPrachtServerModuleSource, pracht };

package/dist/index.mjs

@@ -3,6 +3,7 @@ import preact from "@preact/preset-vite";
 import { resolve } from "node:path";
 import { parseAst } from "vite";
 import { existsSync, readFileSync } from "node:fs";
+import { createNodeServerEntryModule } from "@pracht/adapter-node";
 //#region src/client-module-query.ts
 const CLIENT_MODULE_QUERY = "pracht-client";
 const PRACHT_CLIENT_MODULE_QUERY = `?${CLIENT_MODULE_QUERY}`;
@@ -21,6 +22,7 @@ function stripPrachtClientModuleQuery(id) {
 function getRolldownLang(id) {
 	const path = stripPrachtClientModuleQuery(id).split("?")[0];
 	if (/\.(c|m)?tsx$/i.test(path)) return "tsx";
+	if (/\.tsrx$/i.test(path)) return "tsx";
 	if (/\.(c|m)?ts$/i.test(path)) return "ts";
 	if (/\.(c|m)?jsx$/i.test(path)) return "jsx";
 	if (/\.mdx?$/i.test(path)) return "jsx";
@@ -945,41 +947,7 @@ function createDefaultNodeAdapter() {
 		id: "node",
 		serverImports: "import { resolveApp, resolveApiRoutes } from \"@pracht/core\";",
 		createServerEntryModule() {
-			return [
-				"import { existsSync, readFileSync } from \"node:fs\";",
-				"import { createServer } from \"node:http\";",
-				"import { dirname, resolve } from \"node:path\";",
-				"import { fileURLToPath, pathToFileURL } from \"node:url\";",
-				"import { createNodeRequestHandler } from \"@pracht/adapter-node\";",
-				"",
-				"const serverDir = dirname(fileURLToPath(import.meta.url));",
-				"const staticDir = resolve(serverDir, \"../client\");",
-				"const isgManifestPath = resolve(serverDir, \"isg-manifest.json\");",
-				"const isgManifest = existsSync(isgManifestPath)",
-				"  ? JSON.parse(readFileSync(isgManifestPath, \"utf-8\"))",
-				"  : {};",
-				"",
-				"export const handler = createNodeRequestHandler({",
-				"  app: resolvedApp,",
-				"  registry,",
-				"  staticDir,",
-				"  isgManifest,",
-				"  apiRoutes,",
-				"  clientEntryUrl: clientEntryUrl ?? undefined,",
-				"  cssManifest,",
-				"  jsManifest,",
-				"});",
-				"",
-				"const entryHref = process.argv[1] ? pathToFileURL(process.argv[1]).href : null;",
-				"if (entryHref && import.meta.url === entryHref) {",
-				"  const server = createServer(handler);",
-				"  const port = Number(process.env.PORT ?? 3000);",
-				"  server.listen(port, () => {",
-				"    console.log(`pracht node server listening on http://localhost:${port}`);",
-				"  });",
-				"}",
-				""
-			].join("\n");
+			return createNodeServerEntryModule();
 		}
 	};
 }
@@ -995,7 +963,8 @@ const DEFAULTS = {
 	adapter: createDefaultNodeAdapter(),
 	pagesDir: "",
 	pagesDefaultRender: "ssr",
-	prerenderConcurrency: 10
+	prerenderConcurrency: 10,
+	maxBodySize: 1024 * 1024
 };
 function resolveOptions(options) {
 	const resolved = {
@@ -1003,6 +972,7 @@ function resolveOptions(options) {
 		...options
 	};
 	if (!Number.isInteger(resolved.prerenderConcurrency) || resolved.prerenderConcurrency <= 0) throw new Error("pracht({ prerenderConcurrency }) expects a positive integer.");
+	if (!Number.isInteger(resolved.maxBodySize) || resolved.maxBodySize <= 0) throw new Error("pracht({ maxBodySize }) expects a positive integer number of bytes.");
 	return resolved;
 }
 //#endregion
@@ -1011,14 +981,23 @@ function createPrachtClientModuleSource(options = {}, buildOptions = {}) {
 	const resolved = resolveOptions(options);
 	const isPagesMode = !!resolved.pagesDir;
 	const appImport = isPagesMode ? generatePagesAppInlineSource(resolved, buildOptions.root) : `import { app } from ${JSON.stringify(resolved.appFile)};`;
-	const routeGlob = isPagesMode ? `${resolved.pagesDir}/**/*.{ts,tsx,js,jsx,md,mdx}` : `${resolved.routesDir}/**/*.{ts,tsx,js,jsx,md,mdx}`;
+	const dirPrefix = isPagesMode ? resolved.pagesDir : resolved.routesDir;
+	const routeGlob = `${dirPrefix}/**/*.{ts,tsx,js,jsx,md,mdx}`;
+	const routeTsrxGlob = `${dirPrefix}/**/*.tsrx`;
 	const shellGlob = isPagesMode ? `${resolved.pagesDir}/**/_app.{ts,tsx,js,jsx}` : `${resolved.shellsDir}/**/*.{ts,tsx,js,jsx,md,mdx}`;
+	const shellTsrxGlob = isPagesMode ? `${resolved.pagesDir}/**/_app.tsrx` : `${resolved.shellsDir}/**/*.tsrx`;
 	return [
 		"import { resolveApp, initClientRouter, readHydrationState } from \"@pracht/core\";",
 		appImport,
 		"",
-		`const routeModules = import.meta.glob(${JSON.stringify(routeGlob)}, { query: ${JSON.stringify(PRACHT_CLIENT_MODULE_QUERY)} });`,
-		`const shellModules = import.meta.glob(${JSON.stringify(shellGlob)}, { query: ${JSON.stringify(PRACHT_CLIENT_MODULE_QUERY)} });`,
+		`const routeModules = {`,
+		`  ...import.meta.glob(${JSON.stringify(routeGlob)}, { query: ${JSON.stringify(PRACHT_CLIENT_MODULE_QUERY)} }),`,
+		`  ...import.meta.glob(${JSON.stringify(routeTsrxGlob)}),`,
+		`};`,
+		`const shellModules = {`,
+		`  ...import.meta.glob(${JSON.stringify(shellGlob)}, { query: ${JSON.stringify(PRACHT_CLIENT_MODULE_QUERY)} }),`,
+		`  ...import.meta.glob(${JSON.stringify(shellTsrxGlob)}),`,
+		`};`,
 		"",
 		"const resolvedApp = resolveApp(app);",
 		"",
@@ -1097,10 +1076,18 @@ function createPrachtRegistryModuleSource(options = {}) {
 	const resolved = resolveOptions(options);
 	const isPagesMode = !!resolved.pagesDir;
 	const routeGlob = isPagesMode ? `${resolved.pagesDir}/**/*.{ts,tsx,js,jsx,md,mdx}` : `${resolved.routesDir}/**/*.{ts,tsx,js,jsx,md,mdx}`;
+	const routeTsrxGlob = isPagesMode ? `${resolved.pagesDir}/**/*.tsrx` : `${resolved.routesDir}/**/*.tsrx`;
 	const shellGlob = isPagesMode ? `${resolved.pagesDir}/**/_app.{ts,tsx,js,jsx}` : `${resolved.shellsDir}/**/*.{ts,tsx,js,jsx,md,mdx}`;
+	const shellTsrxGlob = isPagesMode ? `${resolved.pagesDir}/**/_app.tsrx` : `${resolved.shellsDir}/**/*.tsrx`;
 	return [
-		`export const routeModules = import.meta.glob(${JSON.stringify(routeGlob)});`,
-		`export const shellModules = import.meta.glob(${JSON.stringify(shellGlob)});`,
+		`export const routeModules = {`,
+		`  ...import.meta.glob(${JSON.stringify(routeGlob)}),`,
+		`  ...import.meta.glob(${JSON.stringify(routeTsrxGlob)}),`,
+		`};`,
+		`export const shellModules = {`,
+		`  ...import.meta.glob(${JSON.stringify(shellGlob)}),`,
+		`  ...import.meta.glob(${JSON.stringify(shellTsrxGlob)}),`,
+		`};`,
 		`export const middlewareModules = import.meta.glob(${JSON.stringify(`${resolved.middlewareDir}/**/*.{ts,tsx,js,jsx}`)});`,
 		`export const apiModules = import.meta.glob(${JSON.stringify(`${resolved.apiDir}/**/*.{ts,js,tsx,jsx}`)});`,
 		`export const dataModules = import.meta.glob(${JSON.stringify(`${resolved.serverDir}/**/*.{ts,js,tsx,jsx}`)});`,
@@ -1138,8 +1125,9 @@ function generatePagesAppInlineSource(options, root = process.cwd()) {
 //#endregion
 //#region src/plugin-dev-ssr.ts
 const BODYLESS_METHODS = new Set(["GET", "HEAD"]);
-const MAX_BODY_SIZE = 1024 * 1024;
-function createDevSSRMiddleware(server) {
+const DEFAULT_MAX_BODY_SIZE = 1024 * 1024;
+function createDevSSRMiddleware(server, options = {}) {
+	const maxBodySize = options.maxBodySize ?? DEFAULT_MAX_BODY_SIZE;
 	return async (req, res, next) => {
 		const url = req.url ?? "/";
 		const pathname = new URL(url, "http://localhost").pathname;
@@ -1148,7 +1136,7 @@ function createDevSSRMiddleware(server) {
 			const [framework, serverMod] = await Promise.all([server.ssrLoadModule("@pracht/core"), server.ssrLoadModule(PRACHT_SERVER_MODULE_ID)]);
 			let webRequest;
 			try {
-				webRequest = await nodeToWebRequest(req);
+				webRequest = await nodeToWebRequest(req, maxBodySize);
 			} catch (err) {
 				if (err instanceof Error && err.message === "Request body too large") {
 					res.statusCode = 413;
@@ -1192,7 +1180,7 @@ async function handleDevError(server, req, res, next, url, error) {
 		return;
 	}
 	try {
-		const { buildErrorOverlayHtml } = await server.ssrLoadModule("pracht/error-overlay");
+		const { buildErrorOverlayHtml } = await server.ssrLoadModule("@pracht/core/error-overlay");
 		let html = buildErrorOverlayHtml({
 			message: error instanceof Error ? error.message : String(error),
 			stack: error instanceof Error ? error.stack : void 0
@@ -1205,7 +1193,7 @@ async function handleDevError(server, req, res, next, url, error) {
 		next(error);
 	}
 }
-async function nodeToWebRequest(req) {
+async function nodeToWebRequest(req, maxBodySize) {
 	const protocol = "http";
 	const host = req.headers.host ?? "localhost";
 	const url = new URL(req.url ?? "/", `${protocol}://${host}`);
@@ -1226,10 +1214,7 @@ async function nodeToWebRequest(req) {
 		for await (const chunk of req) {
 			const buf = typeof chunk === "string" ? Buffer.from(chunk) : chunk;
 			totalSize += buf.byteLength;
-			if (totalSize > MAX_BODY_SIZE) {
-				req.destroy();
-				throw new Error("Request body too large");
-			}
+			if (totalSize > maxBodySize) throw new Error("Request body too large");
 			chunks.push(buf);
 		}
 		const body = Buffer.concat(chunks);
@@ -1239,7 +1224,7 @@ async function nodeToWebRequest(req) {
 }
 //#endregion
 //#region src/index.ts
-async function pracht(options = {}) {
+function pracht(options = {}) {
 	const resolved = resolveOptions(options);
 	const isPagesMode = !!resolved.pagesDir;
 	let root = process.cwd();
@@ -1292,7 +1277,7 @@ async function pracht(options = {}) {
 			if (isPagesMode) watchPagesDirectory(server, resolved, root);
 			if (resolved.adapter.ownsDevServer) return;
 			return () => {
-				server.middlewares.use(createDevSSRMiddleware(server));
+				server.middlewares.use(createDevSSRMiddleware(server, { maxBodySize: resolved.maxBodySize }));
 			};
 		},
 		handleHotUpdate({ file, server }) {
@@ -1333,15 +1318,54 @@ async function pracht(options = {}) {
 			};
 		}
 	};
+	const optimizeDepsEntriesPlugin = {
+		name: "pracht:optimize-deps-entries",
+		enforce: "post",
+		config(config) {
+			return withPrachtOptimizeDepsEntries(config, createPrachtOptimizeDepsEntries(resolved));
+		}
+	};
 	const plugins = [
 		...preact(),
 		prachtPlugin,
 		clientModuleTransformPlugin
 	];
-	const adapterPlugins = await resolved.adapter.vitePlugins?.();
+	const adapterPlugins = resolved.adapter.vitePlugins?.();
 	if (adapterPlugins?.length) plugins.push(...adapterPlugins);
+	plugins.push(optimizeDepsEntriesPlugin);
 	return plugins;
 }
+function withPrachtOptimizeDepsEntries(config, prachtEntries) {
+	const environments = Object.fromEntries(Object.entries(config.environments ?? {}).map(([name, environment]) => [name, { optimizeDeps: { entries: mergeOptimizeDepsEntries(environment.optimizeDeps?.entries, prachtEntries) } }]));
+	return {
+		optimizeDeps: { entries: mergeOptimizeDepsEntries(config.optimizeDeps?.entries, prachtEntries) },
+		...Object.keys(environments).length > 0 ? { environments } : {}
+	};
+}
+function createPrachtOptimizeDepsEntries(resolved) {
+	const scriptExtensions = "{ts,tsx,js,jsx}";
+	const routeExtensions = "{ts,tsx,js,jsx,md,mdx,tsrx}";
+	const entries = resolved.pagesDir ? [
+		`${toOptimizeDepsEntry(resolved.pagesDir)}/**/*.${routeExtensions}`,
+		`${toOptimizeDepsEntry(resolved.middlewareDir)}/**/*.${scriptExtensions}`,
+		`${toOptimizeDepsEntry(resolved.apiDir)}/**/*.{ts,js,tsx,jsx}`,
+		`${toOptimizeDepsEntry(resolved.serverDir)}/**/*.{ts,js,tsx,jsx}`
+	] : [
+		toOptimizeDepsEntry(resolved.appFile),
+		`${toOptimizeDepsEntry(resolved.routesDir)}/**/*.${routeExtensions}`,
+		`${toOptimizeDepsEntry(resolved.shellsDir)}/**/*.${routeExtensions}`,
+		`${toOptimizeDepsEntry(resolved.middlewareDir)}/**/*.${scriptExtensions}`,
+		`${toOptimizeDepsEntry(resolved.apiDir)}/**/*.{ts,js,tsx,jsx}`,
+		`${toOptimizeDepsEntry(resolved.serverDir)}/**/*.{ts,js,tsx,jsx}`
+	];
+	return [...new Set(entries.filter(Boolean))];
+}
+function mergeOptimizeDepsEntries(userEntries, prachtEntries) {
+	return [...new Set([...Array.isArray(userEntries) ? userEntries : userEntries ? [userEntries] : [], ...prachtEntries])];
+}
+function toOptimizeDepsEntry(path) {
+	return toPosixPath(path).replace(/^\.\//, "").replace(/^\//, "").replace(/\/$/, "");
+}
 function watchPagesDirectory(server, resolved, root) {
 	const abs = resolveConfigPath(root, resolved.pagesDir);
 	server.watcher.on("add", (f) => {
@@ -1369,7 +1393,8 @@ const ROUTE_FILE_EXTENSIONS = new Set([
 	".js",
 	".jsx",
 	".md",
-	".mdx"
+	".mdx",
+	".tsrx"
 ]);
 function computeRouteFileDirs(root, resolved) {
 	return (resolved.pagesDir ? [resolved.pagesDir] : [resolved.routesDir, resolved.shellsDir]).map((dir) => resolveConfigPath(root, dir)).map(withTrailingSep);

package/dist/pages-router.mjs

@@ -3,6 +3,7 @@ import { readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 //#region src/pages-router.ts
 const PAGE_EXTENSIONS = new Set([
 	".tsx",
+	".tsrx",
 	".ts",
 	".jsx",
 	".js",
@@ -11,6 +12,7 @@ const PAGE_EXTENSIONS = new Set([
 ]);
 const SHELL_EXTENSIONS = new Set([
 	".tsx",
+	".tsrx",
 	".ts",
 	".jsx",
 	".js"
@@ -45,14 +47,14 @@ function scan(dir, root, pages) {
 			relativePath: rel,
 			routePath,
 			isIndex: name === "index",
-			isCatchAll: name.startsWith("[..."),
-			isDynamic: name.startsWith("[") && !name.startsWith("[..."),
+			isCatchAll: routePath.split("/").includes("*"),
+			isDynamic: routePath.split("/").some((segment) => segment.startsWith(":")),
 			renderMode
 		});
 	}
 }
 function filePathToRoutePath(relativePath) {
-	let route = relativePath.replace(/\.(tsx?|jsx?|mdx?)$/, "");
+	let route = relativePath.replace(/\.(tsx?|tsrx|jsx?|mdx?)$/, "");
 	route = route.replace(/\\/g, "/");
 	if (route === "_app" || route.endsWith("/_app")) return "__shell__";
 	if (route === "index") return "/";
@@ -62,13 +64,31 @@ function filePathToRoutePath(relativePath) {
 	return `/${route}`;
 }
 function sortRoutes(pages) {
-	return [...pages].filter((p) => p.routePath !== "__shell__").sort((a, b) => {
-		if (a.isCatchAll && !b.isCatchAll) return 1;
-		if (!a.isCatchAll && b.isCatchAll) return -1;
-		if (a.isDynamic && !b.isDynamic) return 1;
-		if (!a.isDynamic && b.isDynamic) return -1;
-		return a.routePath.localeCompare(b.routePath);
-	});
+	return [...pages].filter((p) => p.routePath !== "__shell__").sort(comparePagesBySpecificity);
+}
+function comparePagesBySpecificity(left, right) {
+	const leftSegments = splitRoutePath(left.routePath);
+	const rightSegments = splitRoutePath(right.routePath);
+	const length = Math.max(leftSegments.length, rightSegments.length);
+	for (let index = 0; index < length; index += 1) {
+		const leftSegment = leftSegments[index];
+		const rightSegment = rightSegments[index];
+		if (!leftSegment) return -1;
+		if (!rightSegment) return 1;
+		const leftScore = getRouteSegmentSpecificity(leftSegment);
+		const rightScore = getRouteSegmentSpecificity(rightSegment);
+		if (leftScore !== rightScore) return rightScore - leftScore;
+		if (leftScore === 3 && leftSegment !== rightSegment) return leftSegment.localeCompare(rightSegment);
+	}
+	return left.routePath.localeCompare(right.routePath);
+}
+function splitRoutePath(routePath) {
+	return routePath.split("/").filter(Boolean);
+}
+function getRouteSegmentSpecificity(segment) {
+	if (segment === "*") return 1;
+	if (segment.startsWith(":")) return 2;
+	return 3;
 }
 const RENDER_MODE_RE = /export\s+const\s+RENDER_MODE\s*=\s*["'](\w+)["']/;
 function extractRenderMode(source) {

package/package.json

@@ -1,6 +1,19 @@
 {
   "name": "@pracht/vite-plugin",
-  "version": "0.3.2",
+  "version": "0.4.1",
+  "description": "Vite plugin for Pracht apps with virtual modules, dev SSR, prerendering, route inspection, and multi-adapter builds.",
+  "keywords": [
+    "pracht",
+    "preact",
+    "vite",
+    "vite-plugin",
+    "ssr",
+    "ssg",
+    "prerender",
+    "routing",
+    "cloudflare",
+    "vercel"
+  ],
   "license": "MIT",
   "homepage": "https://github.com/JoviDeCroock/pracht/tree/main/packages/vite-plugin",
   "bugs": {
@@ -31,8 +44,8 @@
   "dependencies": {
     "@preact/preset-vite": "^2.10.5",
     "@prefresh/vite": "^2.0.0",
-    "@pracht/adapter-node": "0.1.11",
-    "@pracht/core": "0.5.0"
+    "@pracht/adapter-node": "0.2.1",
+    "@pracht/core": "0.6.1"
   },
   "peerDependencies": {
     "vite": "^8.0.0"