feat(cli): use biome js api to format all generated templates (#571)

apps/cli/src/constants.ts

@@ -92,7 +92,7 @@ export const dependencyVersionMap = {
 
 	"@elysiajs/cors": "^1.3.3",
 	"@elysiajs/trpc": "^1.1.0",
-	"elysia": "^1.3.21",
+	elysia: "^1.3.21",
 
 	"@hono/node-server": "^1.14.4",
 	"@hono/trpc-server": "^0.4.0",
@@ -108,7 +108,7 @@ export const dependencyVersionMap = {
 
 	turbo: "^2.5.4",
 
-	"ai": "^5.0.39",
+	ai: "^5.0.39",
 	"@ai-sdk/google": "^2.0.13",
 	"@ai-sdk/vue": "^2.0.39",
 	"@ai-sdk/svelte": "^3.0.39",

apps/cli/src/helpers/core/template-manager.ts

@@ -47,11 +47,7 @@ export async function processAndCopyFiles(
 			continue;
 		}
 
-		if (srcPath.endsWith(".hbs")) {
-			await processTemplate(srcPath, destPath, context);
-		} else {
-			await fs.copy(srcPath, destPath, { overwrite: true });
-		}
+		await processTemplate(srcPath, destPath, context);
 	}
 }
 

apps/cli/src/helpers/deployment/alchemy/alchemy-next-setup.ts

@@ -13,7 +13,12 @@ export async function setupNextAlchemyDeploy(
 
 	await addPackageDependency({
 		dependencies: ["@opennextjs/cloudflare"],
-		devDependencies: ["alchemy", "dotenv", "wrangler", "@cloudflare/workers-types"],
+		devDependencies: [
+			"alchemy",
+			"dotenv",
+			"wrangler",
+			"@cloudflare/workers-types",
+		],
 		projectDir: webAppDir,
 	});
 

apps/cli/src/utils/biome-formatter.ts

@@ -0,0 +1,95 @@
+import path from "node:path";
+import { Biome } from "@biomejs/js-api/nodejs";
+import consola from "consola";
+
+let biome: Biome | null = null;
+let projectKey: number | null = null;
+
+async function initializeBiome(): Promise<{
+	biome: Biome;
+	projectKey: number;
+}> {
+	if (biome && projectKey !== null) return { biome, projectKey };
+
+	try {
+		biome = new Biome();
+		const result = biome.openProject("./");
+		projectKey = result.projectKey;
+
+		biome.applyConfiguration(projectKey, {
+			formatter: {
+				enabled: true,
+				indentStyle: "tab",
+				indentWidth: 2,
+				lineWidth: 80,
+			},
+			linter: {
+				enabled: false,
+			},
+			javascript: {
+				formatter: {
+					enabled: true,
+				},
+			},
+			json: {
+				formatter: {
+					enabled: true,
+				},
+			},
+		});
+
+		return { biome, projectKey };
+	} catch (error) {
+		consola.error("Failed to initialize Biome:", error);
+		throw error;
+	}
+}
+
+function isSupportedFile(filePath: string): boolean {
+	const ext = path.extname(filePath).toLowerCase();
+	const supportedExtensions = [".js", ".jsx", ".ts", ".tsx", ".json", ".jsonc"];
+	return supportedExtensions.includes(ext);
+}
+
+function shouldSkipFile(filePath: string): boolean {
+	const basename = path.basename(filePath);
+	const skipPatterns = [
+		".hbs",
+		"package-lock.json",
+		"yarn.lock",
+		"pnpm-lock.yaml",
+		"bun.lock",
+		".d.ts",
+	];
+
+	return skipPatterns.some((pattern) => basename.includes(pattern));
+}
+
+export async function formatFileWithBiome(
+	filePath: string,
+	content: string,
+): Promise<string | null> {
+	if (!isSupportedFile(filePath) || shouldSkipFile(filePath)) {
+		return null;
+	}
+
+	try {
+		const { biome: biomeInstance, projectKey: key } = await initializeBiome();
+
+		const result = biomeInstance.formatContent(key, content, {
+			filePath: path.basename(filePath),
+		});
+
+		if (result.diagnostics && result.diagnostics.length > 0) {
+			consola.debug(
+				`Biome formatting diagnostics for ${filePath}:`,
+				result.diagnostics,
+			);
+		}
+
+		return result.content;
+	} catch (error) {
+		consola.warn(`Failed to format ${filePath} with Biome:`, error);
+		return null;
+	}
+}

apps/cli/src/utils/template-processor.ts

@@ -3,25 +3,36 @@ import consola from "consola";
 import fs from "fs-extra";
 import handlebars from "handlebars";
 import type { ProjectConfig } from "../types";
+import { formatFileWithBiome } from "./biome-formatter";
 
-/**
- * Processes a Handlebars template file and writes the output to the destination.
- * @param srcPath Path to the source .hbs template file.
- * @param destPath Path to write the processed file.
- * @param context Data to be passed to the Handlebars template.
- */
 export async function processTemplate(
 	srcPath: string,
 	destPath: string,
 	context: ProjectConfig,
 ) {
 	try {
-		const templateContent = await fs.readFile(srcPath, "utf-8");
-		const template = handlebars.compile(templateContent);
-		const processedContent = template(context);
-
 		await fs.ensureDir(path.dirname(destPath));
-		await fs.writeFile(destPath, processedContent);
+
+		let content: string;
+
+		if (srcPath.endsWith(".hbs")) {
+			const templateContent = await fs.readFile(srcPath, "utf-8");
+			const template = handlebars.compile(templateContent);
+			content = template(context);
+		} else {
+			content = await fs.readFile(srcPath, "utf-8");
+		}
+
+		try {
+			const formattedContent = await formatFileWithBiome(destPath, content);
+			if (formattedContent) {
+				content = formattedContent;
+			}
+		} catch (formatError) {
+			consola.debug(`Failed to format ${destPath}:`, formatError);
+		}
+
+		await fs.writeFile(destPath, content);
 	} catch (error) {
 		consola.error(`Error processing template ${srcPath}:`, error);
 		throw new Error(`Failed to process template ${srcPath}`);