@pracht/vite-plugin 0.0.0 → 0.1.0

package/README.md

@@ -0,0 +1,34 @@
+# @pracht/vite-plugin
+
+Vite integration for pracht. Handles virtual module generation, multi-environment builds, and SSG prerendering.
+
+## Install
+
+```bash
+npm install @pracht/vite-plugin
+```
+
+## Usage
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import pracht from "@pracht/vite-plugin";
+
+export default defineConfig({
+  plugins: [pracht()],
+});
+```
+
+## What It Does
+
+- Generates virtual modules (`virtual:pracht/client`, `virtual:pracht/server`) from your route manifest
+- Builds client and SSR bundles via Vite's multi-environment mode
+- Pre-renders SSG and ISG routes at build time
+- Provides HMR during development
+
+## Peer Dependencies
+
+- `vite@^8.0.0`
+- `@cloudflare/vite-plugin@^1.0.0` (optional, for Cloudflare targets)
+- `wrangler@^4.81.0` (optional, for Cloudflare targets)

package/dist/index.d.mts

@@ -44,6 +44,7 @@ declare function createPrachtClientModuleSource(options?: PrachtPluginOptions, b
 }): string;
 declare function createPrachtServerModuleSource(options?: PrachtPluginOptions, buildOptions?: {
   root?: string;
+  isBuild?: boolean;
 }): string;
 declare function createPrachtRegistryModuleSource(options?: PrachtPluginOptions): string;
 //#endregion

package/dist/index.mjs

@@ -71,6 +71,7 @@ async function pracht(options = {}) {
 	const isPagesMode = !!resolved.pagesDir;
 	let root = process.cwd();
 	if (isPagesMode && options.appFile) console.warn("[pracht] Both `pagesDir` and `appFile` are set. `pagesDir` takes precedence — `appFile` will be ignored.");
+	let isBuild = false;
 	const prachtPlugin = {
 		name: "pracht",
 		enforce: "pre",
@@ -84,6 +85,7 @@ async function pracht(options = {}) {
 		},
 		configResolved(config) {
 			root = config.root;
+			isBuild = config.command === "build";
 		},
 		resolveId(id) {
 			if (isClientModule(id)) return PRACHT_CLIENT_MODULE_ID;
@@ -92,9 +94,21 @@ async function pracht(options = {}) {
 		},
 		load(id) {
 			if (isClientModule(id)) return createPrachtClientModuleSource(resolved, { root });
-			if (isServerModule(id)) return createPrachtServerModuleSource(resolved, { root });
+			if (isServerModule(id)) return createPrachtServerModuleSource(resolved, {
+				root,
+				isBuild
+			});
 			return null;
 		},
+		transform(code, id) {
+			if (id !== resolve(root, resolved.appFile.slice(1))) return null;
+			const transformed = code.replace(/\(\)\s*=>\s*import\(\s*(['"])([^'"]+)\1\s*\)/g, "$1$2$1");
+			if (transformed === code) return null;
+			return {
+				code: transformed,
+				map: null
+			};
+		},
 		configureServer(server) {
 			if (isPagesMode) {
 				const abs = resolve(root, resolved.pagesDir.slice(1));
@@ -186,10 +200,14 @@ function createPrachtServerModuleSource(options = {}, buildOptions = {}) {
 	const resolved = resolveOptions(options);
 	const isPagesMode = !!resolved.pagesDir;
 	const registrySource = createPrachtRegistryModuleSource(resolved);
-	const clientBuild = readClientBuildAssets(buildOptions.root);
+	const clientBuild = buildOptions.isBuild ? readClientBuildAssets(buildOptions.root) : {
+		clientEntryUrl: null,
+		cssManifest: {},
+		jsManifest: {}
+	};
 	const adapter = resolved.adapter;
 	const source = [
-		adapter?.serverImports ? adapter.serverImports : "import { resolveApp, resolveApiRoutes } from \"@pracht/core\";",
+		adapter?.serverImports ? adapter.serverImports + "\nimport { prerenderApp } from \"@pracht/core\";" : "import { resolveApp, resolveApiRoutes, prerenderApp } from \"@pracht/core\";",
 		isPagesMode ? generatePagesAppInlineSource(resolved, buildOptions.root) : `import { app } from ${JSON.stringify(resolved.appFile)};`,
 		"",
 		registrySource,
@@ -200,6 +218,7 @@ function createPrachtServerModuleSource(options = {}, buildOptions = {}) {
 		`export const clientEntryUrl = ${JSON.stringify(clientBuild.clientEntryUrl ?? CLIENT_BROWSER_PATH)};`,
 		`export const cssManifest = ${JSON.stringify(clientBuild.cssManifest)};`,
 		`export const jsManifest = ${JSON.stringify(clientBuild.jsManifest)};`,
+		"export { prerenderApp };",
 		""
 	];
 	if (adapter) source.push(adapter.createServerEntryModule());
@@ -255,6 +274,7 @@ function createDevSSRMiddleware(server, _pluginOptions) {
 				app: serverMod.resolvedApp,
 				registry: serverMod.registry,
 				request: webRequest,
+				debugErrors: true,
 				clientEntryUrl: CLIENT_BROWSER_PATH,
 				apiRoutes: serverMod.apiRoutes
 			});
@@ -297,7 +317,7 @@ function createDevSSRMiddleware(server, _pluginOptions) {
 }
 const BODYLESS_METHODS = new Set(["GET", "HEAD"]);
 async function nodeToWebRequest(req) {
-	const protocol = (Array.isArray(req.headers["x-forwarded-proto"]) ? req.headers["x-forwarded-proto"][0] : req.headers["x-forwarded-proto"]) ?? "http";
+	const protocol = "http";
 	const host = req.headers.host ?? "localhost";
 	const url = new URL(req.url ?? "/", `${protocol}://${host}`);
 	const method = req.method ?? "GET";

package/dist/pages-router.d.mts

@@ -17,6 +17,7 @@ declare function filePathToRoutePath(relativePath: string): string;
 declare function sortRoutes(pages: ScannedPage[]): ScannedPage[];
 declare function generatePagesManifestSource(pages: ScannedPage[], options: PagesRouterOptions & {
   pagesDirPrefix?: string;
+  useImportSyntax?: boolean;
 }): string;
 declare function generateRoutesFile(pagesDir: string, outputPath: string, options: PagesRouterOptions): void;
 //#endregion

package/dist/pages-router.mjs

@@ -71,19 +71,22 @@ function generatePagesManifestSource(pages, options) {
 	const pagesDir = options.pagesDir;
 	const defaultRender = options.pagesDefaultRender ?? "ssr";
 	const prefix = options.pagesDirPrefix;
+	const useImport = options.useImportSyntax ?? false;
 	const appFile = scanAllFiles(pagesDir).find((f) => basename(f, extname(f)) === "_app" && PAGE_EXTENSIONS.has(extname(f)));
 	const lines = ["import { defineApp, group, route } from \"@pracht/core\";", ""];
 	const routeEntries = [];
 	for (const page of pages) {
 		const render = page.renderMode ?? defaultRender;
 		const filePath = prefix ? `${prefix}/${page.relativePath.replace(/\\/g, "/")}` : `./${page.relativePath.replace(/\\/g, "/")}`;
-		routeEntries.push(`    route(${JSON.stringify(page.routePath)}, ${JSON.stringify(filePath)}, { render: ${JSON.stringify(render)} })`);
+		const fileRef = useImport ? `() => import(${JSON.stringify(filePath)})` : JSON.stringify(filePath);
+		routeEntries.push(`    route(${JSON.stringify(page.routePath)}, ${fileRef}, { render: ${JSON.stringify(render)} })`);
 	}
 	if (appFile) {
 		const appPath = prefix ? `${prefix}/_app.${extname(appFile).slice(1)}` : `./${relative(join(pagesDir, ".."), appFile).replace(/\\/g, "/")}`;
+		const shellRef = useImport ? `() => import(${JSON.stringify(appPath)})` : JSON.stringify(appPath);
 		lines.push("const app = defineApp({");
 		lines.push("  shells: {");
-		lines.push(`    pages: ${JSON.stringify(appPath)},`);
+		lines.push(`    pages: ${shellRef},`);
 		lines.push("  },");
 		lines.push("  routes: [");
 		lines.push(`    group({ shell: "pages" }, [`);
@@ -121,7 +124,10 @@ function generateRoutesFile(pagesDir, outputPath, options) {
 		"// Auto-generated from pages/ directory by @pracht/vite-plugin.",
 		"// Customize this file and remove `pagesDir` from pracht config to use it directly.",
 		"",
-		generatePagesManifestSource(scanPagesDirectory(pagesDir), options).replace("const app = defineApp(", "export const app = defineApp(")
+		generatePagesManifestSource(scanPagesDirectory(pagesDir), {
+			...options,
+			useImportSyntax: true
+		}).replace("const app = defineApp(", "export const app = defineApp(")
 	].join("\n"), "utf-8");
 }
 //#endregion

package/package.json

@@ -1,6 +1,15 @@
 {
   "name": "@pracht/vite-plugin",
-  "version": "0.0.0",
+  "version": "0.1.0",
+  "homepage": "https://github.com/JoviDeCroock/pracht/tree/main/packages/vite-plugin",
+  "bugs": {
+    "url": "https://github.com/JoviDeCroock/pracht/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JoviDeCroock/pracht",
+    "directory": "packages/vite-plugin"
+  },
   "files": [
     "dist"
   ],
@@ -15,11 +24,14 @@
       "default": "./dist/pages-router.mjs"
     }
   },
+  "publishConfig": {
+    "provenance": true
+  },
   "dependencies": {
     "@preact/preset-vite": "^2.10.5",
-    "@pracht/adapter-cloudflare": "0.0.0",
-    "@pracht/core": "0.0.0",
-    "@pracht/adapter-vercel": "0.0.0"
+    "@pracht/adapter-cloudflare": "0.0.2",
+    "@pracht/adapter-vercel": "0.0.2",
+    "@pracht/core": "0.1.0"
   },
   "peerDependencies": {
     "@cloudflare/vite-plugin": "^1.0.0",