alepha 0.14.2 → 0.14.4

package/dist/vite/index.js

@@ -1,12 +1,13 @@
 import m, { createRequire } from "node:module";
-import { access, cp, mkdir, readFile, stat, unlink, writeFile } from "node:fs/promises";
-import path, { basename, dirname, join, resolve } from "node:path";
-import { AlephaError, OPTIONS } from "alepha";
-import { analyzer } from "vite-bundle-analyzer";
-import { promises } from "node:fs";
+import { access, cp, mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
+import path, { basename, dirname, join, relative, resolve } from "node:path";
+import { AlephaError } from "alepha";
+import { pathToFileURL } from "node:url";
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, promises, writeFileSync } from "node:fs";
 import { promisify } from "node:util";
 import { brotliCompress, gzip } from "node:zlib";
-import { pathToFileURL } from "node:url";
+import { analyzer } from "vite-bundle-analyzer";
 
 //#region ../../src/vite/helpers/boot.ts
 /**
@@ -159,12 +160,6 @@ function createBufferedLogger() {
 	};
 }
 
-//#endregion
-//#region ../../src/vite/helpers/fileExists.ts
-const fileExists = async (path$1) => {
-	return await access(join(process.cwd(), path$1)).then(() => true).catch(() => false);
-};
-
 //#endregion
 //#region ../../src/vite/helpers/importVite.ts
 const importVite = async () => {
@@ -180,102 +175,519 @@ const importVite = async () => {
 };
 
 //#endregion
-//#region ../../src/vite/plugins/viteCompress.ts
-const gzipCompress = promisify(gzip);
-const brotliCompress$1 = promisify(brotliCompress);
-function viteCompress(options = {}) {
-	const { disabled = false, filter = /\.(js|mjs|cjs|css|wasm|svg)$/ } = options;
-	return {
-		name: "compress",
-		apply: "build",
-		async writeBundle(outputOptions, bundle) {
-			if (disabled) return;
+//#region ../../src/vite/tasks/runAlepha.ts
+/**
+* Create an Alepha runner for development.
+*
+* The runner manages the lifecycle of an Alepha application during
+* Vite dev server operation, handling start/stop/restart and HMR.
+*/
+function createAlephaRunner(opts) {
+	return new AlephaRunner({
+		root: process.cwd().replace(/\\/g, "/"),
+		started: false,
+		log: opts.debug ? (...msg) => console.log(...msg) : () => {},
+		entry: opts.entry,
+		onReload: () => {}
+	});
+}
+var AlephaRunner = class {
+	state;
+	constructor(state) {
+		this.state = state;
+	}
+	/**
+	* Set resolved Vite config.
+	*/
+	setConfig(config) {
+		this.state.config = config;
+	}
+	/**
+	* Check if SSR is enabled for the running app.
+	*/
+	isSsrEnabled() {
+		if (!this.state.app) return false;
+		return this.state.app.store.get("alepha.react.server.ssr") ?? false;
+	}
+	/**
+	* Check if app is started.
+	*/
+	get isStarted() {
+		return this.state.started;
+	}
+	/**
+	* Get the running Alepha app instance.
+	*/
+	get app() {
+		return this.state.app;
+	}
+	/**
+	* Start the Alepha application.
+	*/
+	async start(server) {
+		const { loadEnv } = await importVite();
+		global.ssrFixStacktrace = (e) => {
+			server.ssrFixStacktrace(e);
+			let it = e;
+			do {
+				server.ssrFixStacktrace(it);
+				it = it.cause;
+			} while (it instanceof Error);
+		};
+		if (this.state.started) {
+			await this.restart(server, true);
+			return;
+		}
+		if (!this.state.config) {
+			this.state.log("[DEBUG] No config - skip starting");
+			return;
+		}
+		this.state.onReload?.();
+		this.state.log("[DEBUG] Starting Alepha app...");
+		this.state.started = false;
+		this.state.app = void 0;
+		const fileUrl = pathToFileURL(`${path.resolve(this.state.config.root, this.state.entry)}`).href;
+		const env = loadEnv("development", this.state.config.root, "");
+		const before = { ...process.env };
+		for (const key in env) process.env[key] = env[key];
+		let port = 5173;
+		const address = server.httpServer?.address();
+		if (typeof address === "object" && address?.port) port = address.port;
+		process.env.NODE_ENV ??= "development";
+		process.env.VITE_ALEPHA_DEV = "true";
+		process.env.SERVER_HOST ??= typeof server.config.server.host === "string" ? server.config.server.host : "localhost";
+		process.env.SERVER_PORT ??= String(port);
+		try {
 			const now = Date.now();
-			const outputDir = outputOptions.dir || resolve(process.cwd(), "dist");
-			const files = Object.keys(bundle).filter((fileName) => {
-				if (typeof filter === "function") return filter(fileName);
-				return filter.test(fileName);
-			}).map((fileName) => ({
-				fileName,
-				filePath: join(outputDir, fileName)
-			}));
-			const compressionTasks = [];
-			for (const { filePath } of files) compressionTasks.push(compressFile(options, filePath));
-			await Promise.all(compressionTasks);
-			this.info(`Compressed ${files.length} file${files.length > 1 ? "s" : ""} in ${Date.now() - now}ms.`);
+			await server.ssrLoadModule(fileUrl, { fixStacktrace: true });
+			this.state.log(`[DEBUG] Alepha app loaded in ${Date.now() - now}ms`);
+			await new Promise((r) => setTimeout(r, 10));
+			this.state.app = globalThis.__alepha;
+			if (!this.state.app) {
+				this.state.log("[DEBUG] No app found - skip starting");
+				return;
+			}
+			this.state.app.store.set("alepha.node.server", server.httpServer);
+			console.log("");
+			await this.state.app.start();
+			this.state.started = true;
+			process.env = { ...before };
+			this.state.log("[DEBUG] Starting Done!");
+		} catch (e) {
+			if (e instanceof Error) {
+				let it = e;
+				do {
+					server.ssrFixStacktrace(it);
+					it = it.cause;
+				} while (it instanceof Error);
+				server.ssrFixStacktrace(e);
+				if (e.cause instanceof Error) server.ssrFixStacktrace(e.cause);
+				this.state.app?.log?.error("App failed to start:", e);
+				this.state.app?.log?.info("Waiting for changes to restart...");
+			}
+			this.state.log("[DEBUG] Alepha app start error");
+			this.state.started = false;
 		}
-	};
-}
-async function compressFile(options = {}, filePath) {
-	const { brotli = true, gzip: gzip$1 = true } = options;
-	const compressionTasks = [];
-	const fileContentPromise = promises.readFile(filePath);
-	if (gzip$1) {
-		const gzipOptions = typeof gzip$1 === "object" ? gzip$1 : { level: 9 };
-		compressionTasks.push(fileContentPromise.then(async (content) => {
-			const compressed = await gzipCompress(content, gzipOptions);
-			await promises.writeFile(`${filePath}.gz`, compressed);
-		}));
 	}
-	if (brotli) {
-		const brotliOptions = typeof brotli === "object" ? brotli : {};
-		compressionTasks.push(fileContentPromise.then(async (content) => {
-			const compressed = await brotliCompress$1(content, brotliOptions);
-			await promises.writeFile(`${filePath}.br`, compressed);
-		}));
+	/**
+	* Stop the Alepha application.
+	*/
+	async stop() {
+		if (this.state.app?.stop && this.state.started) {
+			this.state.log("[DEBUG] Stopping Alepha app...");
+			await this.state.app.stop();
+			this.state.started = false;
+			this.state.log("[DEBUG] Stopping Done!");
+		} else this.state.log("[DEBUG] Alepha app not started - skip stop");
 	}
-	await Promise.all(compressionTasks);
-}
-
-//#endregion
-//#region ../../src/vite/tasks/buildClient.ts
+	/**
+	* Restart the Alepha application.
+	*
+	* @returns true if the restart was skipped due to locking
+	*/
+	async restart(server, invalidate) {
+		if (this.state.lock) {
+			this.state.log("[DEBUG] STILL LOCKING");
+			return true;
+		}
+		this.state.log("[DEBUG] LOCK RESTART");
+		this.state.lock = Promise.withResolvers();
+		const now = Date.now();
+		this.state.log("[DEBUG] RESTART");
+		await this.stop();
+		this.state.log(`[DEBUG] RESTART (stop) in ${Date.now() - now}ms`);
+		if (invalidate) server.moduleGraph.invalidateAll();
+		await this.start(server);
+		this.state.log(`[DEBUG] RESTART OK in ${Date.now() - now}ms`);
+		setTimeout(() => {
+			this.state.log("[DEBUG] UNLOCK RESTART");
+			this.state.lock?.resolve();
+			this.state.lock = void 0;
+		}, 500);
+		return false;
+	}
+	/**
+	* Send reload event to client.
+	*/
+	sendReload(server) {
+		server.ws.send({
+			type: "custom",
+			event: "alepha:reload",
+			data: {}
+		});
+	}
+};
 /**
-* Build client-side bundle with Vite.
-*
-* This task compiles the browser/client code for production,
-* including code splitting, minification, and optional compression.
+* Check if a URL path is a Vite internal file.
 */
-async function buildClient(opts) {
-	const { build: viteBuild, mergeConfig } = await importVite();
-	const plugins = [];
-	const compress = opts.precompress ? typeof opts.precompress === "object" ? opts.precompress : {} : void 0;
-	if (opts.stats) plugins.push(analyzer({ analyzerMode: "static" }));
-	if (opts.precompress && compress) plugins.push(viteCompress(compress));
-	const logger = opts.silent ? createBufferedLogger() : void 0;
-	const viteBuildClientConfig = {
-		mode: "production",
-		logLevel: opts.silent ? "silent" : void 0,
-		define: { "process.env.NODE_ENV": "\"production\"" },
-		publicDir: "public",
-		build: {
-			chunkSizeWarningLimit: 1e3,
-			outDir: opts.dist,
-			rollupOptions: { output: {
-				entryFileNames: "entry.[hash].js",
-				chunkFileNames: "chunk.[hash].js",
-				assetFileNames: "asset.[hash][extname]"
-			} }
-		},
-		esbuild: { legalComments: "none" },
-		customLogger: logger,
-		plugins
-	};
-	try {
-		await viteBuild(mergeConfig(viteBuildClientConfig, opts.config ?? {}));
-	} catch (error) {
-		logger?.flush();
-		throw error;
-	}
+function isViteInternalPath(pathname) {
+	const [path$1] = pathname.split("?");
+	if (path$1.startsWith("/@") || path$1.startsWith("/src") || path$1.includes("/node_modules/")) return true;
+	return false;
 }
 
 //#endregion
-//#region ../../src/vite/tasks/generateExternals.ts
+//#region ../../src/vite/plugins/viteAlephaDev.ts
 /**
-* Generate minimal package.json with pinned external dependencies.
+* Plug Alepha into Vite development server.
 *
-* This task creates a package.json in the dist directory containing
-* only the external dependencies needed at runtime, with their versions
-* pinned to the currently installed versions.
+* This plugin manages the Alepha application lifecycle during development,
+* handling hot module replacement and request forwarding.
+*/
+async function viteAlephaDev(options = {}) {
+	let entry = options.serverEntry;
+	if (!entry) {
+		entry = await boot.getServerEntry();
+		if (!entry) return {
+			name: "alepha-dev",
+			apply: "serve",
+			config() {}
+		};
+	}
+	const runner = createAlephaRunner({
+		entry,
+		debug: options.debug
+	});
+	const { loadEnv } = await importVite();
+	const env = loadEnv("development", process.cwd(), "SERVER");
+	const config = {};
+	if (env.SERVER_PORT) config.server = { port: parseInt(env.SERVER_PORT, 10) };
+	return {
+		name: "alepha-dev",
+		apply: "serve",
+		config: () => config,
+		configResolved(resolvedConfig) {
+			runner.setConfig(resolvedConfig);
+		},
+		async handleHotUpdate(ctx) {
+			if (options.debug) console.log("[DEBUG] HMR", ctx.file);
+			if (ctx.file.includes("/.idea/")) return [];
+			const isServerOnly = !ctx.modules[0]?._clientModule;
+			const isBrowserOnly = !ctx.modules[0]?._ssrModule;
+			const isSsrEnabled = runner.isSsrEnabled();
+			if (isBrowserOnly) {
+				if (options.debug) console.log("[DEBUG] HMR - browser only - no reason to reload server");
+				return;
+			}
+			const root = process.cwd().replace(/\\/g, "/");
+			const invalidate = !ctx.file.startsWith(root);
+			if (invalidate && options.debug) console.log("[DEBUG] HMR - outside root - invalidate all");
+			if (!isSsrEnabled && isServerOnly) {
+				await runner.restart(ctx.server, invalidate);
+				return [];
+			}
+			if (isSsrEnabled && ctx.modules[0]) {
+				if (await runner.restart(ctx.server, invalidate)) return [];
+				if (!runner.isStarted) {
+					if (options.debug) console.log("[DEBUG] HMR - abort due to app not started");
+					return [];
+				}
+				if (isServerOnly && runner.isStarted) {
+					runner.sendReload(ctx.server);
+					return [];
+				}
+			}
+		},
+		async configureServer(server) {
+			if (env.SERVER_PORT) server.config.server.port = parseInt(env.SERVER_PORT, 10);
+			const middleware = (req, res, next) => {
+				if (runner.isStarted && runner.app && req.url && !isViteInternalPath(req.url)) {
+					let ended = false;
+					const writeHead = res.writeHead.bind(res);
+					res.writeHead = (...args) => {
+						ended = true;
+						return writeHead(args[0], args[1], args[2]);
+					};
+					return runner.app.events.emit("node:request", {
+						req,
+						res
+					}).then(() => {
+						if (!ended) next();
+					});
+				}
+				next();
+			};
+			server.middlewares.use((req, res, next) => {
+				middleware(req, res, next);
+			});
+			server.config.logger.info = (msg) => {
+				console.log(msg);
+			};
+			server.config.logger.clearScreen = () => {};
+			return () => {
+				server.httpServer?.once("listening", () => {
+					runner.start(server);
+				});
+			};
+		},
+		async closeBundle() {}
+	};
+}
+
+//#endregion
+//#region ../../src/vite/plugins/viteAlephaSsrPreload.ts
+/**
+* Vite plugin that generates a preload manifest for SSR module preloading.
+*
+* Instead of injecting source paths directly into $page definitions (which would
+* leak component paths in the browser bundle), this plugin:
+*
+* 1. Collects all lazy import paths from $page definitions during transform
+* 2. Generates a manifest file mapping short keys to resolved source paths
+* 3. Injects only the short key into $page definitions
+*
+* The manifest is written to `.vite/preload-manifest.json` alongside Vite's
+* other manifests. The CLI build command moves all manifests to
+* `dist/server/.ssr/` where SSRManifestProvider loads them at runtime.
+*
+* Before:
+* ```typescript
+* $page({
+*   path: '/users/:id',
+*   lazy: () => import('./UserDetail.tsx'),
+* })
+* ```
+*
+* After:
+* ```typescript
+* $page({
+*   path: '/users/:id',
+*   lazy: () => import('./UserDetail.tsx'),
+*   [Symbol.for("alepha.page.preload")]: "a1b2c3",
+* })
+* ```
+*
+* Manifest (.alepha/preload-manifest.json):
+* ```json
+* {
+*   "a1b2c3": "src/pages/UserDetail.tsx"
+* }
+* ```
+*/
+function viteAlephaSsrPreload() {
+	let root = "";
+	const preloadMap = /* @__PURE__ */ new Map();
+	/**
+	* Generate a short hash key for a source path.
+	* Uses first 8 chars of MD5 hash for brevity while avoiding collisions.
+	*/
+	function generateKey(sourcePath) {
+		return createHash("md5").update(sourcePath).digest("hex").slice(0, 8);
+	}
+	return {
+		name: "alepha-preload",
+		configResolved(config) {
+			root = config.root;
+		},
+		transform(code, id) {
+			if (!id.match(/\.[tj]sx?$/)) return null;
+			if (id.includes("node_modules")) return null;
+			if (!code.includes("$page") || !code.includes("lazy")) return null;
+			const insertions = [];
+			const pageStartRegex = /\$page\s*\(\s*\{/g;
+			let pageMatch = pageStartRegex.exec(code);
+			while (pageMatch !== null) {
+				const objectStartIndex = pageMatch.index + pageMatch[0].length - 1;
+				let braceCount = 1;
+				let i = objectStartIndex + 1;
+				while (i < code.length && braceCount > 0) {
+					if (code[i] === "{") braceCount++;
+					else if (code[i] === "}") braceCount--;
+					i++;
+				}
+				if (braceCount !== 0) {
+					pageMatch = pageStartRegex.exec(code);
+					continue;
+				}
+				const objectEndIndex = i - 1;
+				const pageContent = code.slice(objectStartIndex, objectEndIndex + 1);
+				if (pageContent.includes("alepha.page.preload")) {
+					pageMatch = pageStartRegex.exec(code);
+					continue;
+				}
+				const lazyMatch = /lazy\s*:\s*\(\s*\)\s*=>\s*import\s*\(\s*['"]([^'"]+)['"]\s*\)/.exec(pageContent);
+				if (!lazyMatch) {
+					pageMatch = pageStartRegex.exec(code);
+					continue;
+				}
+				const importPath = lazyMatch[1];
+				const currentDir = dirname(id);
+				let resolvedPath;
+				if (importPath.startsWith(".")) resolvedPath = resolve(currentDir, importPath);
+				else if (importPath.startsWith("/")) resolvedPath = resolve(root, importPath.slice(1));
+				else {
+					pageMatch = pageStartRegex.exec(code);
+					continue;
+				}
+				let relativePath = relative(root, resolvedPath);
+				relativePath = relativePath.replace(/\\/g, "/");
+				if (!relativePath.match(/\.[tj]sx?$/)) relativePath = `${relativePath}.tsx`;
+				else if (relativePath.endsWith(".jsx")) relativePath = relativePath.replace(/\.jsx$/, ".tsx");
+				else if (relativePath.endsWith(".js")) relativePath = relativePath.replace(/\.js$/, ".ts");
+				const key = generateKey(relativePath);
+				preloadMap.set(key, relativePath);
+				const preloadProperty = `${!code.slice(0, objectEndIndex).trimEnd().endsWith(",") ? "," : ""} [Symbol.for("alepha.page.preload")]: "${key}"`;
+				insertions.push({
+					position: objectEndIndex,
+					text: preloadProperty
+				});
+				pageMatch = pageStartRegex.exec(code);
+			}
+			if (insertions.length === 0) return null;
+			let result = code;
+			for (let j = insertions.length - 1; j >= 0; j--) {
+				const { position, text } = insertions[j];
+				result = result.slice(0, position) + text + result.slice(position);
+			}
+			return {
+				code: result,
+				map: null
+			};
+		},
+		writeBundle(options) {
+			const outDir = options.dir || "";
+			if (outDir.includes("server")) return;
+			if (preloadMap.size > 0) {
+				const viteDir = join(outDir, ".vite");
+				if (!existsSync(viteDir)) mkdirSync(viteDir, { recursive: true });
+				const manifest = Object.fromEntries(preloadMap);
+				writeFileSync(join(viteDir, "preload-manifest.json"), JSON.stringify(manifest, null, 2));
+			}
+		}
+	};
+}
+
+//#endregion
+//#region ../../src/vite/plugins/viteCompress.ts
+const gzipCompress = promisify(gzip);
+const brotliCompress$1 = promisify(brotliCompress);
+function viteCompress(options = {}) {
+	const { disabled = false, filter = /\.(js|mjs|cjs|css|wasm|svg)$/ } = options;
+	return {
+		name: "compress",
+		apply: "build",
+		async writeBundle(outputOptions, bundle) {
+			if (disabled) return;
+			const now = Date.now();
+			const outputDir = outputOptions.dir || resolve(process.cwd(), "dist");
+			const files = Object.keys(bundle).filter((fileName) => {
+				if (typeof filter === "function") return filter(fileName);
+				return filter.test(fileName);
+			}).map((fileName) => ({
+				fileName,
+				filePath: join(outputDir, fileName)
+			}));
+			const compressionTasks = [];
+			for (const { filePath } of files) compressionTasks.push(compressFile(options, filePath));
+			await Promise.all(compressionTasks);
+			this.info(`Compressed ${files.length} file${files.length > 1 ? "s" : ""} in ${Date.now() - now}ms.`);
+		}
+	};
+}
+async function compressFile(options = {}, filePath) {
+	const { brotli = true, gzip: gzip$1 = true } = options;
+	const compressionTasks = [];
+	const fileContentPromise = promises.readFile(filePath);
+	if (gzip$1) {
+		const gzipOptions = typeof gzip$1 === "object" ? gzip$1 : { level: 9 };
+		compressionTasks.push(fileContentPromise.then(async (content) => {
+			const compressed = await gzipCompress(content, gzipOptions);
+			await promises.writeFile(`${filePath}.gz`, compressed);
+		}));
+	}
+	if (brotli) {
+		const brotliOptions = typeof brotli === "object" ? brotli : {};
+		compressionTasks.push(fileContentPromise.then(async (content) => {
+			const compressed = await brotliCompress$1(content, brotliOptions);
+			await promises.writeFile(`${filePath}.br`, compressed);
+		}));
+	}
+	await Promise.all(compressionTasks);
+}
+
+//#endregion
+//#region ../../src/vite/helpers/importViteReact.ts
+const importViteReact = async () => {
+	try {
+		const { default: viteReact } = createRequire(import.meta.url)("@vitejs/plugin-react");
+		return viteReact;
+	} catch {}
+};
+
+//#endregion
+//#region ../../src/vite/tasks/buildClient.ts
+/**
+* Build client-side bundle with Vite.
+*
+* This task compiles the browser/client code for production,
+* including code splitting, minification, and optional compression.
+*/
+async function buildClient(opts) {
+	const { build: viteBuild, mergeConfig } = await importVite();
+	const plugins = [];
+	const viteReact = await importViteReact();
+	if (viteReact) plugins.push(viteReact());
+	plugins.push(viteAlephaSsrPreload());
+	const compress = opts.precompress ? typeof opts.precompress === "object" ? opts.precompress : {} : void 0;
+	if (opts.stats) plugins.push(analyzer({ analyzerMode: "static" }));
+	if (opts.precompress && compress) plugins.push(viteCompress(compress));
+	const logger = opts.silent ? createBufferedLogger() : void 0;
+	const viteBuildClientConfig = {
+		mode: "production",
+		logLevel: opts.silent ? "silent" : void 0,
+		define: { "process.env.NODE_ENV": "\"production\"" },
+		publicDir: "public",
+		build: {
+			chunkSizeWarningLimit: 1e3,
+			outDir: opts.dist,
+			manifest: true,
+			ssrManifest: true,
+			rollupOptions: { output: {
+				entryFileNames: "entry.[hash].js",
+				chunkFileNames: "chunk.[hash].js",
+				assetFileNames: "asset.[hash][extname]"
+			} }
+		},
+		esbuild: { legalComments: "none" },
+		customLogger: logger,
+		plugins
+	};
+	try {
+		await viteBuild(mergeConfig(viteBuildClientConfig, opts.config ?? {}));
+	} catch (error) {
+		logger?.flush();
+		throw error;
+	}
+}
+
+//#endregion
+//#region ../../src/vite/tasks/generateExternals.ts
+/**
+* Generate minimal package.json with pinned external dependencies.
+*
+* This task creates a package.json in the dist directory containing
+* only the external dependencies needed at runtime, with their versions
+* pinned to the currently installed versions.
 */
 async function generateExternals(opts) {
 	const require = m.createRequire(import.meta.filename);
@@ -307,6 +719,9 @@ async function generateExternals(opts) {
 async function buildServer(opts) {
 	const { build: viteBuild, mergeConfig } = await importVite();
 	const plugins = [];
+	const viteReact = await importViteReact();
+	if (viteReact && opts.clientDir) plugins.push(viteReact());
+	plugins.push(viteAlephaSsrPreload());
 	if (opts.stats) plugins.push(analyzer({ analyzerMode: "static" }));
 	const logger = opts.silent ? createBufferedLogger() : void 0;
 	const viteBuildServerConfig = {
@@ -353,12 +768,37 @@ async function buildServer(opts) {
 	const entryFile = extractEntryFromBundle(opts.entry, result);
 	let template = "";
 	if (opts.clientDir) template = `__alepha.set("alepha.react.server.template", \`${(await readFile(`${opts.distDir}/${opts.clientDir}/index.html`, "utf-8")).replace(/>\s*</g, "><").trim()}\`);\n`;
+	let manifest = "";
+	if (opts.clientDir) {
+		const viteDir = `${opts.distDir}/${opts.clientDir}/.vite`;
+		const combined = {
+			ssr: await loadJsonFile(`${viteDir}/ssr-manifest.json`),
+			client: await loadJsonFile(`${viteDir}/manifest.json`),
+			preload: await loadJsonFile(`${viteDir}/preload-manifest.json`)
+		};
+		manifest = `__alepha.set("alepha.react.ssr.manifest", ${JSON.stringify(combined)});\n`;
+		await rm(viteDir, {
+			recursive: true,
+			force: true
+		});
+	}
 	await writeFile(`${opts.distDir}/index.js`, `// This file was automatically generated. DO NOT MODIFY.
 // Changes to this file will be lost when the code is regenerated.
-\nimport './server/${entryFile}';\n\n${template}`.trim());
+\n${template}${manifest}import './server/${entryFile}';\n`.trim());
 	return { entryFile };
 }
 /**
+* Load a JSON file, returning undefined if it doesn't exist.
+*/
+async function loadJsonFile(path$1) {
+	try {
+		const content = await readFile(path$1, "utf-8");
+		return JSON.parse(content);
+	} catch {
+		return;
+	}
+}
+/**
 * Extract entry filename from Vite build result.
 */
 function extractEntryFromBundle(entry, result) {
@@ -418,6 +858,35 @@ async function copyAssets(opts) {
 	else await fn();
 }
 
+//#endregion
+//#region ../../src/vite/tasks/devServer.ts
+/**
+* Start Vite development server with Alepha plugins.
+*
+* This task starts the Vite dev server with all required plugins:
+* - @vitejs/plugin-react (JSX/TSX compilation)
+* - viteAlephaDev (Alepha server integration)
+* - viteAlephaSsrPreload (SSR module preloading)
+*/
+async function devServer(opts = {}) {
+	const { createServer, mergeConfig } = await importVite();
+	const plugins = [];
+	const viteReact = await importViteReact();
+	if (viteReact) plugins.push(viteReact());
+	plugins.push(viteAlephaSsrPreload());
+	plugins.push(await viteAlephaDev({
+		serverEntry: opts.entry,
+		debug: opts.debug
+	}));
+	await (await createServer(mergeConfig({
+		plugins,
+		server: {
+			port: opts.port,
+			host: opts.host
+		}
+	}, {}))).listen();
+}
+
 //#endregion
 //#region ../../src/vite/tasks/generateCloudflare.ts
 const WARNING_COMMENT$1 = "// This file was automatically generated. DO NOT MODIFY.\n// Changes to this file will be lost when the code is regenerated.\n";
@@ -482,6 +951,12 @@ export default {
 	await writeFile(join(root, distDir, "main.cloudflare.js"), `${WARNING_COMMENT$1}\n${workerCode}`.trim());
 }
 
+//#endregion
+//#region ../../src/vite/helpers/fileExists.ts
+const fileExists = async (path$1) => {
+	return await access(join(process.cwd(), path$1)).then(() => true).catch(() => false);
+};
+
 //#endregion
 //#region ../../src/vite/tasks/generateDocker.ts
 /**
@@ -704,409 +1179,5 @@ async function renderFile(page, options, dist, compress) {
 }
 
 //#endregion
-//#region ../../src/vite/tasks/runAlepha.ts
-/**
-* Create an Alepha runner for development.
-*
-* The runner manages the lifecycle of an Alepha application during
-* Vite dev server operation, handling start/stop/restart and HMR.
-*/
-function createAlephaRunner(opts) {
-	return new AlephaRunner({
-		root: process.cwd().replace(/\\/g, "/"),
-		started: false,
-		log: opts.debug ? (...msg) => console.log(...msg) : () => {},
-		entry: opts.entry,
-		onReload: () => {}
-	});
-}
-var AlephaRunner = class {
-	state;
-	constructor(state) {
-		this.state = state;
-	}
-	/**
-	* Set resolved Vite config.
-	*/
-	setConfig(config) {
-		this.state.config = config;
-	}
-	/**
-	* Check if SSR is enabled for the running app.
-	*/
-	isSsrEnabled() {
-		if (!this.state.app) return false;
-		return this.state.app.store.get("alepha.react.server.ssr") ?? false;
-	}
-	/**
-	* Check if app is started.
-	*/
-	get isStarted() {
-		return this.state.started;
-	}
-	/**
-	* Get the running Alepha app instance.
-	*/
-	get app() {
-		return this.state.app;
-	}
-	/**
-	* Start the Alepha application.
-	*/
-	async start(server) {
-		const { loadEnv } = await importVite();
-		global.ssrFixStacktrace = (e) => {
-			server.ssrFixStacktrace(e);
-			let it = e;
-			do {
-				server.ssrFixStacktrace(it);
-				it = it.cause;
-			} while (it instanceof Error);
-		};
-		if (this.state.started) {
-			await this.restart(server, true);
-			return;
-		}
-		if (!this.state.config) {
-			this.state.log("[DEBUG] No config - skip starting");
-			return;
-		}
-		this.state.onReload?.();
-		this.state.log("[DEBUG] Starting Alepha app...");
-		this.state.started = false;
-		this.state.app = void 0;
-		const fileUrl = pathToFileURL(`${path.resolve(this.state.config.root, this.state.entry)}`).href;
-		const env = loadEnv("development", this.state.config.root, "");
-		const before = { ...process.env };
-		for (const key in env) process.env[key] = env[key];
-		process.env.NODE_ENV ??= "development";
-		process.env.VITE_ALEPHA_DEV = "true";
-		process.env.SERVER_HOST ??= typeof server.config.server.host === "string" ? server.config.server.host : "localhost";
-		process.env.SERVER_PORT ??= String(server.config.server.port || "5173");
-		try {
-			const now = Date.now();
-			await server.ssrLoadModule(fileUrl, { fixStacktrace: true });
-			this.state.log(`[DEBUG] Alepha app loaded in ${Date.now() - now}ms`);
-			await new Promise((r) => setTimeout(r, 10));
-			this.state.app = globalThis.__alepha;
-			if (!this.state.app) {
-				this.state.log("[DEBUG] No app found - skip starting");
-				return;
-			}
-			this.state.app.store.set("alepha.node.server", server.httpServer);
-			console.log("");
-			await this.state.app.start();
-			this.state.started = true;
-			process.env = { ...before };
-			this.state.log("[DEBUG] Starting Done!");
-		} catch (e) {
-			if (e instanceof Error) {
-				let it = e;
-				do {
-					server.ssrFixStacktrace(it);
-					it = it.cause;
-				} while (it instanceof Error);
-				server.ssrFixStacktrace(e);
-				if (e.cause instanceof Error) server.ssrFixStacktrace(e.cause);
-				this.state.app?.log?.error("App failed to start:", e);
-				this.state.app?.log?.info("Waiting for changes to restart...");
-			}
-			this.state.log("[DEBUG] Alepha app start error");
-			this.state.started = false;
-		}
-	}
-	/**
-	* Stop the Alepha application.
-	*/
-	async stop() {
-		if (this.state.app?.stop && this.state.started) {
-			this.state.log("[DEBUG] Stopping Alepha app...");
-			await this.state.app.stop();
-			this.state.started = false;
-			this.state.log("[DEBUG] Stopping Done!");
-		} else this.state.log("[DEBUG] Alepha app not started - skip stop");
-	}
-	/**
-	* Restart the Alepha application.
-	*
-	* @returns true if the restart was skipped due to locking
-	*/
-	async restart(server, invalidate) {
-		if (this.state.lock) {
-			this.state.log("[DEBUG] STILL LOCKING");
-			return true;
-		}
-		this.state.log("[DEBUG] LOCK RESTART");
-		this.state.lock = Promise.withResolvers();
-		const now = Date.now();
-		this.state.log("[DEBUG] RESTART");
-		await this.stop();
-		this.state.log(`[DEBUG] RESTART (stop) in ${Date.now() - now}ms`);
-		if (invalidate) server.moduleGraph.invalidateAll();
-		await this.start(server);
-		this.state.log(`[DEBUG] RESTART OK in ${Date.now() - now}ms`);
-		setTimeout(() => {
-			this.state.log("[DEBUG] UNLOCK RESTART");
-			this.state.lock?.resolve();
-			this.state.lock = void 0;
-		}, 500);
-		return false;
-	}
-	/**
-	* Send reload event to client.
-	*/
-	sendReload(server) {
-		server.ws.send({
-			type: "custom",
-			event: "alepha:reload",
-			data: {}
-		});
-	}
-};
-/**
-* Check if a URL path is a Vite internal file.
-*/
-function isViteInternalPath(pathname) {
-	const [path$1] = pathname.split("?");
-	if (path$1.startsWith("/@") || path$1.startsWith("/src") || path$1.includes("/node_modules/")) return true;
-	return false;
-}
-
-//#endregion
-//#region ../../src/vite/plugins/viteAlephaBuild.ts
-/**
-* Alepha build plugin for Vite.
-*
-* This plugin orchestrates the complete build process:
-* 1. Build client (if index.html exists)
-* 2. Build server (SSR)
-* 3. Copy assets from packages
-* 4. Pre-render static pages (if enabled)
-* 5. Generate sitemap (if enabled)
-* 6. Generate deployment config (Vercel/Cloudflare/Docker)
-*
-* Build mode can be controlled via ALEPHA_BUILD_MODE env var for CLI integration.
-*/
-async function viteAlephaBuild(options = {}) {
-	const entry = options.serverEntry ?? await boot.getServerEntry();
-	const distDir = "dist";
-	const clientDir = "public";
-	let rootConfig = {};
-	return {
-		name: "alepha:build",
-		apply: "build",
-		[OPTIONS]: options,
-		config(config, ctx) {
-			if (process.env.ALEPHA_BUILD_MODE === "cli") return;
-			if (!process.env.VITE_DOUBLE_BUILD_DONE) rootConfig = config;
-			if (ctx.isSsrBuild || !process.env.VITE_DOUBLE_BUILD_DONE) config.publicDir = false;
-			else config.publicDir = "public";
-		},
-		async buildStart() {
-			const buildMode = process.env.ALEPHA_BUILD_MODE;
-			if (buildMode === "cli") return;
-			if (process.env.VITE_DOUBLE_BUILD_DONE === "true") return;
-			process.env.VITE_DOUBLE_BUILD_DONE = "true";
-			const hasClient = options.client !== false && await fileExists("index.html");
-			const buildClientOptions = typeof options.client === "object" ? options.client : {};
-			const stats = options.stats ?? process.env.ALEPHA_BUILD_STATS === "true";
-			if (buildMode === "client") {
-				if (hasClient) await buildClient({
-					...buildClientOptions,
-					config: rootConfig,
-					dist: `${distDir}/${clientDir}`,
-					stats
-				});
-				process.exit(0);
-			}
-			if (buildMode === "server") {
-				if (entry) {
-					let clientBuilt = false;
-					try {
-						await readFile(`${distDir}/${clientDir}/index.html`, "utf-8");
-						clientBuilt = true;
-					} catch {}
-					await buildServer({
-						config: { base: rootConfig.base || "" },
-						entry,
-						distDir,
-						clientDir: clientBuilt ? clientDir : void 0,
-						stats
-					});
-				}
-				process.exit(0);
-			}
-			if (hasClient) await buildClient({
-				...buildClientOptions,
-				config: rootConfig,
-				dist: `${distDir}/${clientDir}`,
-				stats
-			});
-			let template = "";
-			if (hasClient) template = await readFile(`${distDir}/${clientDir}/index.html`, "utf-8");
-			if (entry) {
-				await buildServer({
-					config: { base: rootConfig.base || "" },
-					entry,
-					distDir,
-					clientDir: hasClient ? clientDir : void 0,
-					stats
-				});
-				if (hasClient && options.serverEntry !== false) await unlink(`${distDir}/${clientDir}/index.html`);
-				await copyAssets({
-					entry: `${distDir}/index.js`,
-					distDir
-				});
-			}
-			if (buildClientOptions.sitemap && entry) await writeFile(`${distDir}/${clientDir}/sitemap.xml`, await generateSitemap({
-				entry: `${distDir}/index.js`,
-				baseUrl: buildClientOptions.sitemap.hostname
-			}));
-			if (buildClientOptions.prerender && template) await prerenderPages({
-				dist: `${distDir}/${clientDir}`,
-				entry: `${distDir}/index.js`,
-				compress: buildClientOptions.precompress
-			});
-			if (options.vercel) await generateVercel({
-				distDir,
-				clientDir,
-				config: typeof options.vercel === "boolean" ? {} : options.vercel
-			});
-			if (options.cloudflare) await generateCloudflare({
-				distDir,
-				config: typeof options.cloudflare === "boolean" ? {} : options.cloudflare
-			});
-			if (options.docker) await generateDocker({
-				distDir,
-				...typeof options.docker === "boolean" ? {} : options.docker
-			});
-			process.exit(0);
-		}
-	};
-}
-
-//#endregion
-//#region ../../src/vite/plugins/viteAlephaDev.ts
-/**
-* Plug Alepha into Vite development server.
-*
-* This plugin manages the Alepha application lifecycle during development,
-* handling hot module replacement and request forwarding.
-*/
-async function viteAlephaDev(options = {}) {
-	let entry = options.serverEntry;
-	if (!entry) {
-		entry = await boot.getServerEntry();
-		if (!entry) return {
-			name: "alepha-dev",
-			apply: "serve",
-			config() {}
-		};
-	}
-	const runner = createAlephaRunner({
-		entry,
-		debug: options.debug
-	});
-	return {
-		name: "alepha-dev",
-		apply: "serve",
-		configResolved(resolvedConfig) {
-			runner.setConfig(resolvedConfig);
-		},
-		async handleHotUpdate(ctx) {
-			if (options.debug) console.log("[DEBUG] HMR", ctx.file);
-			if (ctx.file.includes("/.idea/")) return [];
-			const isServerOnly = !ctx.modules[0]?._clientModule;
-			const isBrowserOnly = !ctx.modules[0]?._ssrModule;
-			const isSsrEnabled = runner.isSsrEnabled();
-			if (isBrowserOnly) {
-				if (options.debug) console.log("[DEBUG] HMR - browser only - no reason to reload server");
-				return;
-			}
-			const root = process.cwd().replace(/\\/g, "/");
-			const invalidate = !ctx.file.startsWith(root);
-			if (invalidate && options.debug) console.log("[DEBUG] HMR - outside root - invalidate all");
-			if (!isSsrEnabled && isServerOnly) {
-				await runner.restart(ctx.server, invalidate);
-				return [];
-			}
-			if (isSsrEnabled && ctx.modules[0]) {
-				if (await runner.restart(ctx.server, invalidate)) return [];
-				if (!runner.isStarted) {
-					if (options.debug) console.log("[DEBUG] HMR - abort due to app not started");
-					return [];
-				}
-				if (isServerOnly && runner.isStarted) {
-					runner.sendReload(ctx.server);
-					return [];
-				}
-			}
-		},
-		async configureServer(server) {
-			server.middlewares.use((req, res, next) => {
-				if (runner.isStarted && runner.app && req.url && !isViteInternalPath(req.url)) {
-					let ended = false;
-					const writeHead = res.writeHead.bind(res);
-					res.writeHead = (...args) => {
-						ended = true;
-						return writeHead(args[0], args[1], args[2]);
-					};
-					return runner.app.events.emit("node:request", {
-						req,
-						res
-					}).then(() => {
-						if (!ended) next();
-					});
-				}
-				next();
-			});
-			server.config.logger.info = (msg) => {
-				console.log(msg);
-			};
-			server.config.logger.clearScreen = () => {};
-			return async () => {
-				await runner.start(server);
-			};
-		},
-		async closeBundle() {}
-	};
-}
-
-//#endregion
-//#region ../../src/vite/plugins/viteAlepha.ts
-function viteAlepha(options = {}) {
-	if (process.env.NODE_ENV === "test") return [];
-	const plugins = [];
-	if (options.react !== false) try {
-		const { default: viteReact } = createRequire(import.meta.url)("@vitejs/plugin-react");
-		plugins.push(viteReact());
-	} catch (e) {}
-	plugins.push(viteAlephaDev(options), viteAlephaBuild(options));
-	plugins[OPTIONS] = options;
-	return plugins;
-}
-
-//#endregion
-//#region ../../src/vite/index.ts
-/**
-* Plugin vite for Alepha framework.
-*
-* This module provides Vite plugins and configurations to integrate Alepha applications with Vite's build and development processes.
-*
-* @example
-* ```ts
-* import { defineConfig } from "vite";
-* import { viteAlepha } from "alepha/vite";
-*
-* export default defineConfig({
-*   plugins: [viteAlepha()],
-*   // other Vite configurations...
-* });
-* ```
-*
-* @module alepha.vite
-*/
-
-//#endregion
-export { AlephaRunner, boot, buildClient, buildServer, compressFile, copyAssets, createAlephaRunner, createBufferedLogger, generateCloudflare, generateDocker, generateExternals, generateSitemap, generateVercel, isViteInternalPath, prerenderPages, viteAlepha, viteAlephaBuild, viteAlephaDev, viteCompress };
+export { AlephaRunner, boot, buildClient, buildServer, compressFile, copyAssets, createAlephaRunner, createBufferedLogger, devServer, generateCloudflare, generateDocker, generateExternals, generateSitemap, generateVercel, isViteInternalPath, prerenderPages, viteAlephaDev, viteAlephaSsrPreload, viteCompress };
 //# sourceMappingURL=index.js.map