blumenjs 0.2.1 → 0.2.3

package/dist/templates/scripts/generate-routes.ts

@@ -55,6 +55,14 @@ interface RouteEntry {
 	loadingImportPath?: string;
 	/** Whether this page exports dynamic = 'force-static' for SSG */
 	isStatic: boolean;
+	/** Whether this page exports a getStaticProps function */
+	hasGetStaticProps: boolean;
+	/** Whether this page exports a getStaticPaths function */
+	hasGetStaticPaths: boolean;
+	/** Whether this page starts with 'use client' directive */
+	isClientComponent: boolean;
+	/** Whether this page exports runtime = 'edge' */
+	isEdge: boolean;
 }
 
 interface LayoutEntry {
@@ -162,10 +170,20 @@ function scanDir(dir: string, baseDir: string = dir): RouteEntry[] {
 			// Check if the page exports getServerProps, metadata, or generateMetadata
 			const fileContent = fs.readFileSync(fullPath, "utf-8");
 			const hasGetServerProps = hasNamedExport(fullPath, fileContent, "getServerProps");
+			const hasGetStaticProps = hasNamedExport(fullPath, fileContent, "getStaticProps");
+			const hasGetStaticPaths = hasNamedExport(fullPath, fileContent, "getStaticPaths");
 			const hasMetadata = hasNamedExport(fullPath, fileContent, "metadata");
 			const hasGenerateMetadata = hasNamedExport(fullPath, fileContent, "generateMetadata");
 			const hasDynamic = hasNamedExport(fullPath, fileContent, "dynamic");
-			const isStatic = hasDynamic && fileContent.includes("force-static");
+			// Pages with getStaticProps are automatically static
+			const isStatic = hasGetStaticProps || (hasDynamic && fileContent.includes("force-static"));
+
+			// Detect 'use client' directive at the top of the file
+			const isClientComponent = /^\s*['"]use client['"]/.test(fileContent);
+
+			// Detect runtime = 'edge' for edge functions
+			const hasRuntime = hasNamedExport(fullPath, fileContent, "runtime");
+			const isEdge = hasRuntime && fileContent.includes("edge");
 
 			// Check for a loading.tsx file in the same directory
 			const pageDir = path.dirname(fullPath);
@@ -187,6 +205,10 @@ function scanDir(dir: string, baseDir: string = dir): RouteEntry[] {
 				hasLoading,
 				loadingImportPath,
 				isStatic,
+				hasGetStaticProps,
+				hasGetStaticPaths,
+				isClientComponent,
+				isEdge,
 			});
 		}
 	}
@@ -257,6 +279,18 @@ function discoverPages(): RouteEntry[] {
 	return routes;
 }
 
+/**
+ * Generate a webpack chunk name for a route entry.
+ * Produces clean names like "page-home", "page-docs", "page-users-id".
+ */
+function getChunkName(r: RouteEntry): string {
+	return "page-" + r.importPath
+		.replace(/\/index$/, "")           // "docs/index" → "docs"
+		.replace(/\[([^\]]+)\]/g, "$1")    // "[id]" → "id"
+		.replace(/\//g, "-")               // "dashboard/settings" → "dashboard-settings"
+		.toLowerCase();
+}
+
 function generateRouteFile(
 	routes: RouteEntry[],
 	layouts: LayoutEntry[],
@@ -273,11 +307,18 @@ function generateRouteFile(
 		"",
 	];
 
-	// Import default exports!
-	const imports = routes.map(
-		(r) =>
-			`import ${r.componentId} from "${importPathPrefix}/${r.importPath}";`,
-	);
+	// Import page components
+	// Server: static imports (SSR needs all components loaded)
+	// Client: React.lazy() dynamic imports for code splitting
+	const imports = isServer
+		? routes.map(
+				(r) =>
+					`import ${r.componentId} from "${importPathPrefix}/${r.importPath}";`,
+			)
+		: routes.map((r) => {
+				const chunkName = getChunkName(r);
+				return `const ${r.componentId} = React.lazy(() => import(/* webpackChunkName: "${chunkName}" */ "${importPathPrefix}/${r.importPath}"));`;
+			});
 
 	// For SSR: import getServerProps from pages that export it
 	const gspImports: string[] = [];
@@ -291,6 +332,31 @@ function generateRouteFile(
 		}
 	}
 
+	// For SSR: import getStaticProps from pages that export it
+	// getStaticProps works like getServerProps but the page is pre-rendered at build time
+	const staticPropsImports: string[] = [];
+	const staticPropsRoutes = routes.filter(r => r.hasGetStaticProps);
+	if (isServer && staticPropsRoutes.length > 0) {
+		for (const r of staticPropsRoutes) {
+			const spId = "staticProps_" + r.componentId.replace("Page_", "");
+			staticPropsImports.push(
+				`import { getStaticProps as ${spId} } from "${importPathPrefix}/${r.importPath}";`,
+			);
+		}
+	}
+
+	// For SSR: import getStaticPaths from pages that export it (dynamic SSG)
+	const staticPathsImports: string[] = [];
+	const staticPathsRoutes = routes.filter(r => r.hasGetStaticPaths);
+	if (isServer && staticPathsRoutes.length > 0) {
+		for (const r of staticPathsRoutes) {
+			const pathsId = "staticPaths_" + r.componentId.replace("Page_", "");
+			staticPathsImports.push(
+				`import { getStaticPaths as ${pathsId} } from "${importPathPrefix}/${r.importPath}";`,
+			);
+		}
+	}
+
 	// For SSR: import metadata and generateMetadata from pages that export them
 	const metaImports: string[] = [];
 	const metaRoutes = routes.filter(r => r.hasMetadata);
@@ -369,23 +435,66 @@ function generateRouteFile(
 
 	// Generate serverPropsMap for SSR routes
 	let serverPropsMapStr = "";
-	if (isServer && gspRoutes.length > 0) {
+	if (isServer && (gspRoutes.length > 0 || staticPropsRoutes.length > 0)) {
+		// Merge getServerProps + getStaticProps into one map
+		// getStaticProps pages are treated identically at render time
 		const entries = gspRoutes.map(r => {
 			const gspId = "gsp_" + r.componentId.replace("Page_", "");
 			return `\t"${r.route}": ${gspId},`;
 		});
+		const staticEntries = staticPropsRoutes.map(r => {
+			const spId = "staticProps_" + r.componentId.replace("Page_", "");
+			return `\t"${r.route}": ${spId},`;
+		});
 		serverPropsMapStr = [
 			"",
-			"// Map of routes that export getServerProps",
+			"// Map of routes that export getServerProps or getStaticProps",
 			"// Used by the SSR server to run data fetching before rendering",
 			"export const serverPropsMap: Record<string, Function> = {",
 			...entries,
+			...staticEntries,
 			"};",
 		].join("\n");
 	} else if (isServer) {
 		serverPropsMapStr = "\nexport const serverPropsMap: Record<string, Function> = {};";
 	}
 
+	// Generate staticPropsMap (for ISR — tracks which pages use getStaticProps)
+	let staticMapsStr = "";
+	if (isServer) {
+		if (staticPropsRoutes.length > 0) {
+			const entries = staticPropsRoutes.map(r => {
+				const spId = "staticProps_" + r.componentId.replace("Page_", "");
+				return `\t"${r.route}": ${spId},`;
+			});
+			staticMapsStr += [
+				"",
+				"// Map of routes with getStaticProps (for ISR revalidation)",
+				"export const staticPropsMap: Record<string, Function> = {",
+				...entries,
+				"};",
+			].join("\n");
+		} else {
+			staticMapsStr += "\nexport const staticPropsMap: Record<string, Function> = {};";
+		}
+
+		if (staticPathsRoutes.length > 0) {
+			const entries = staticPathsRoutes.map(r => {
+				const pathsId = "staticPaths_" + r.componentId.replace("Page_", "");
+				return `\t"${r.route}": ${pathsId},`;
+			});
+			staticMapsStr += [
+				"",
+				"// Map of routes with getStaticPaths (for dynamic SSG)",
+				"export const staticPathsMap: Record<string, Function> = {",
+				...entries,
+				"};",
+			].join("\n");
+		} else {
+			staticMapsStr += "\nexport const staticPathsMap: Record<string, Function> = {};";
+		}
+	}
+
 	// Generate metadataMap and generateMetadataMap for SSR routes
 	let metadataMapStr = "";
 	if (isServer) {
@@ -460,6 +569,22 @@ function generateRouteFile(
 		}
 	}
 
+	// Generate route-to-chunk name map (client-side only, for prefetching)
+	let routeChunkMapStr = "";
+	if (!isServer) {
+		const entries = routes.map(r => {
+			const chunkName = getChunkName(r);
+			return `\t"${r.route}": "${chunkName}",`;
+		});
+		routeChunkMapStr = [
+			"",
+			"// Map of route paths to their webpack chunk names (for prefetching)",
+			"export const routeChunkMap: Record<string, string> = {",
+			...entries,
+			"};",
+		].join("\n");
+	}
+
 	const map = [
 		"",
 		"export interface RouteDef {",
@@ -477,11 +602,13 @@ function generateRouteFile(
 		appImport,
 		docImport,
 		serverPropsMapStr,
+		staticMapsStr,
 		metadataMapStr,
+		routeChunkMapStr,
 		"",
 	];
 
-	return [...header, ...imports, ...gspImports, ...metaImports, ...layoutImports, ...loadingImports, ...map].join("\n");
+	return [...header, ...imports, ...gspImports, ...staticPropsImports, ...staticPathsImports, ...metaImports, ...layoutImports, ...loadingImports, ...map].join("\n");
 }
 
 function main() {
@@ -512,10 +639,13 @@ function main() {
 	for (const r of routes) {
 		const tags: string[] = [];
 		if (r.hasGetServerProps) tags.push("getServerProps");
+		if (r.hasGetStaticProps) tags.push("getStaticProps");
 		if (r.hasMetadata) tags.push("metadata");
 		if (r.hasGenerateMetadata) tags.push("generateMetadata");
 		if (r.hasLoading) tags.push("loading");
 		if (r.isStatic) tags.push("ssg");
+		if (r.isClientComponent) tags.push("use client");
+		if (r.isEdge) tags.push("edge");
 		const tagStr = tags.length > 0 ? ` [${tags.join(", ")}]` : "";
 		console.log(`     ${r.route.padEnd(25)} → ${r.importPath}.tsx${tagStr}`);
 	}
@@ -555,6 +685,8 @@ function main() {
 				route: r.route,
 				componentId: r.componentId,
 				hasGetServerProps: r.hasGetServerProps,
+				hasGetStaticProps: r.hasGetStaticProps,
+				hasGetStaticPaths: r.hasGetStaticPaths,
 			}))
 		};
 		fs.mkdirSync("dist", { recursive: true });

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "blumenjs",
-	"version": "0.2.1",
+	"version": "0.2.3",
 	"description": "The React framework powered by Go. Lightning-fast SSR with the DX you deserve.",
 	"type": "module",
 	"bin": {
@@ -29,7 +29,10 @@
 		"dev:go": "go run go-server/main.go go-server/image.go go-server/cache.go",
 		"build:client": "webpack --mode production",
 		"build:ssr": "esbuild node-ssr/server.ts --bundle --platform=node --format=esm --outfile=dist/ssr-server.js --packages=external",
-		"clean": "rm -rf dist static/js/bundle.js"
+		"clean": "rm -rf dist static/js/bundle.js",
+		"test": "tsx cli/blumen.ts test",
+		"test:coverage": "tsx cli/blumen.ts test --coverage",
+		"bench": "tsx cli/blumen.ts bench"
 	},
 	"keywords": [
 		"react",
@@ -61,19 +64,28 @@
 		"@babel/preset-react": "^7.28.5",
 		"@babel/preset-typescript": "^7.28.5",
 		"@pmmmwh/react-refresh-webpack-plugin": "^0.6.2",
+		"@testing-library/dom": "^10.4.1",
+		"@testing-library/jest-dom": "^6.9.1",
+		"@testing-library/react": "^16.3.2",
 		"@types/node": "^20.10.0",
-		"@types/react": "^18.2.0",
-		"@types/react-dom": "^18.2.0",
+		"@types/react": "^18.3.29",
+		"@types/react-dom": "^18.3.7",
+		"@vitejs/plugin-react": "^6.0.2",
+		"@vitest/coverage-v8": "^4.1.7",
 		"babel-loader": "^10.1.1",
 		"concurrently": "^8.2.2",
 		"css-loader": "^7.1.4",
 		"esbuild": "^0.19.0",
+		"jsdom": "^29.1.1",
 		"mini-css-extract-plugin": "^2.10.2",
+		"react": "^19.2.6",
+		"react-dom": "^19.2.6",
 		"react-refresh": "^0.18.0",
 		"style-loader": "^4.0.0",
 		"ts-loader": "^9.5.1",
 		"tsx": "^4.6.0",
 		"typescript": "^5.3.0",
+		"vitest": "^4.1.7",
 		"webpack": "^5.89.0",
 		"webpack-bundle-analyzer": "^5.3.0",
 		"webpack-cli": "^5.1.4",