@buenojs/bueno 0.8.4 → 0.8.6

package/src/frontend/dev-server.ts

@@ -10,33 +10,37 @@
  * - Graceful shutdown handling
  */
 
-import { Router, type RouteMatch } from "../router/index.js";
-import { Logger, createLogger } from "../logger/index.js";
+import { type Logger, createLogger } from "../logger/index.js";
+import type { RouteMatch, Router } from "../router/index.js";
 import type { HTTPMethod } from "../types/index.js";
+import {
+	type ConsoleStreamManager,
+	createConsoleStreamManager,
+	injectConsoleScript,
+} from "./console-stream.js";
+import { injectHMRScript } from "./hmr-client.js";
+import { type HMRManager, createHMRManager } from "./hmr.js";
+import { type SSRRenderer, createSSRRenderer } from "./ssr.js";
 import type {
+	BuildManifest,
+	ConsoleStreamConfig,
 	DevServerConfig,
-	PartialDevServerConfig,
+	DevServerEvent,
+	DevServerEventListener,
+	DevServerMiddleware,
 	DevServerState,
-	FrontendFramework,
-	FrameworkDetectionResult,
-	PackageDependencies,
 	FileResolution,
-	DevServerMiddleware,
-	DevServerEventListener,
-	DevServerEvent,
-	TransformResult,
-	TransformOptions,
+	FrameworkDetectionResult,
+	FrontendFramework,
 	HMRConfig,
-	ConsoleStreamConfig,
+	PackageDependencies,
 	PartialConsoleStreamConfig,
-	SSRConfig,
+	PartialDevServerConfig,
 	PartialSSRConfig,
-	BuildManifest,
+	SSRConfig,
+	TransformOptions,
+	TransformResult,
 } from "./types.js";
-import { HMRManager, createHMRManager } from "./hmr.js";
-import { injectHMRScript } from "./hmr-client.js";
-import { ConsoleStreamManager, createConsoleStreamManager, injectConsoleScript } from "./console-stream.js";
-import { SSRRenderer, createSSRRenderer } from "./ssr.js";
 
 // ============= Constants =============
 
@@ -101,7 +105,9 @@ function detectFramework(rootDir: string): FrameworkDetectionResult {
 		}
 
 		// Read package.json synchronously using Bun's sync read
-		const packageJson = JSON.parse(require("fs").readFileSync(packageJsonPath, "utf-8"));
+		const packageJson = JSON.parse(
+			require("fs").readFileSync(packageJsonPath, "utf-8"),
+		);
 		const dependencies: PackageDependencies = {
 			...packageJson.dependencies,
 			...packageJson.devDependencies,
@@ -109,7 +115,12 @@ function detectFramework(rootDir: string): FrameworkDetectionResult {
 
 		// Check for each framework in order of specificity
 		// Solid and Svelte are more specific than React/Vue
-		const frameworkOrder: FrontendFramework[] = ["solid", "svelte", "vue", "react"];
+		const frameworkOrder: FrontendFramework[] = [
+			"solid",
+			"svelte",
+			"vue",
+			"react",
+		];
 
 		for (const framework of frameworkOrder) {
 			const indicators = FRAMEWORK_INDICATORS[framework];
@@ -192,7 +203,7 @@ export class DevServer {
 		if (this.config.hmr) {
 			this.hmrManager = createHMRManager(
 				frameworkResult.framework,
-				this.config.port
+				this.config.port,
 			);
 			this.logger.info("HMR enabled");
 		}
@@ -201,7 +212,7 @@ export class DevServer {
 		if (this.config.consoleStream?.enabled !== false) {
 			this.consoleStreamManager = createConsoleStreamManager(
 				this.config.port,
-				this.config.consoleStream
+				this.config.consoleStream,
 			);
 			this.logger.info("Console streaming enabled");
 		}
@@ -341,7 +352,9 @@ export class DevServer {
 	/**
 	 * Transform a file based on its type
 	 */
-	private async transformFile(options: TransformOptions): Promise<TransformResult> {
+	private async transformFile(
+		options: TransformOptions,
+	): Promise<TransformResult> {
 		const { filePath, content, framework } = options;
 
 		// For JSX/TSX files, Bun handles transpilation automatically
@@ -387,17 +400,17 @@ export class DevServer {
 		// Inject HMR and Console scripts for HTML files
 		if (resolution.contentType === "text/html; charset=utf-8") {
 			let html = await file.text();
-			
+
 			// Inject HMR script
 			if (this.hmrManager) {
 				html = injectHMRScript(html, this.hmrManager.getPort());
 			}
-			
+
 			// Inject Console Stream script
 			if (this.consoleStreamManager) {
 				html = injectConsoleScript(html, this.consoleStreamManager.getPort());
 			}
-			
+
 			return new Response(html, {
 				headers: {
 					"Content-Type": "text/html; charset=utf-8",
@@ -407,7 +420,8 @@ export class DevServer {
 
 		return new Response(file, {
 			headers: {
-				"Content-Type": resolution.contentType || this.getContentType(resolution.filePath),
+				"Content-Type":
+					resolution.contentType || this.getContentType(resolution.filePath),
 			},
 		});
 	}
@@ -461,7 +475,7 @@ export class DevServer {
 					error: "Internal Server Error",
 					statusCode: 500,
 				},
-				{ status: 500 }
+				{ status: 500 },
 			);
 		}
 	}
@@ -544,7 +558,7 @@ export class DevServer {
 					error: "Not Found",
 					statusCode: 404,
 				},
-				{ status: 404 }
+				{ status: 404 },
 			);
 		} catch (error) {
 			this.logger.error(`Request error: ${pathname}`, error);
@@ -552,9 +566,12 @@ export class DevServer {
 				{
 					error: "Internal Server Error",
 					statusCode: 500,
-					stack: process.env.NODE_ENV !== "production" && error instanceof Error ? error.stack : undefined,
+					stack:
+						process.env.NODE_ENV !== "production" && error instanceof Error
+							? error.stack
+							: undefined,
 				},
-				{ status: 500 }
+				{ status: 500 },
 			);
 		} finally {
 			this.state.activeConnections--;
@@ -607,7 +624,7 @@ export class DevServer {
 				}
 
 				this.logger.info(
-					`Development server started at http://${this.config.hostname}:${this.config.port}`
+					`Development server started at http://${this.config.hostname}:${this.config.port}`,
 				);
 
 				this.emitEvent({
@@ -650,7 +667,9 @@ export class DevServer {
 				this.state.running = false;
 				this.state.startTime = null;
 
-				this.logger.info(`Development server stopped${reason ? `: ${reason}` : ""}`);
+				this.logger.info(
+					`Development server stopped${reason ? `: ${reason}` : ""}`,
+				);
 
 				this.emitEvent({
 					type: "stop",
@@ -720,14 +739,19 @@ export class DevServer {
 	 * Check if console streaming is enabled
 	 */
 	isConsoleStreamEnabled(): boolean {
-		return this.consoleStreamManager !== null && this.consoleStreamManager.isEnabled();
+		return (
+			this.consoleStreamManager !== null &&
+			this.consoleStreamManager.isEnabled()
+		);
 	}
 
 	/**
 	 * Get Console Stream WebSocket URL
 	 */
 	getConsoleStreamUrl(): string | null {
-		return this.consoleStreamManager ? this.consoleStreamManager.getWebSocketUrl() : null;
+		return this.consoleStreamManager
+			? this.consoleStreamManager.getWebSocketUrl()
+			: null;
 	}
 
 	// ============= SSR Methods =============
@@ -741,7 +765,9 @@ export class DevServer {
 			framework: config.framework || this.state.framework,
 		});
 		this.ssrEnabled = true;
-		this.logger.info("SSR enabled", { framework: config.framework || this.state.framework });
+		this.logger.info("SSR enabled", {
+			framework: config.framework || this.state.framework,
+		});
 	}
 
 	/**
@@ -826,21 +852,43 @@ export class DevServer {
 	 */
 	private isStaticAsset(pathname: string): boolean {
 		const staticExtensions = [
-			".js", ".mjs", ".css", ".json",
-			".png", ".jpg", ".jpeg", ".gif", ".svg", ".ico", ".webp", ".avif",
-			".woff", ".woff2", ".ttf", ".eot",
-			".mp4", ".webm", ".mp3", ".wav",
-			".pdf", ".zip", ".wasm",
+			".js",
+			".mjs",
+			".css",
+			".json",
+			".png",
+			".jpg",
+			".jpeg",
+			".gif",
+			".svg",
+			".ico",
+			".webp",
+			".avif",
+			".woff",
+			".woff2",
+			".ttf",
+			".eot",
+			".mp4",
+			".webm",
+			".mp3",
+			".wav",
+			".pdf",
+			".zip",
+			".wasm",
 		];
-		return staticExtensions.some(ext => pathname.endsWith(ext));
+		return staticExtensions.some((ext) => pathname.endsWith(ext));
 	}
 }
 
 // ============= Factory Function =============
 
 /**
-	* Create a development server
-	*/
-export function createDevServer(config: PartialDevServerConfig & { consoleStream?: PartialConsoleStreamConfig }): DevServer {
+ * Create a development server
+ */
+export function createDevServer(
+	config: PartialDevServerConfig & {
+		consoleStream?: PartialConsoleStreamConfig;
+	},
+): DevServer {
 	return new DevServer(config);
-}
+}

package/src/frontend/file-router.ts

@@ -8,17 +8,17 @@
  * - Integration with existing Router
  */
 
-import { createLogger, type Logger } from "../logger/index.js";
+import { type Logger, createLogger } from "../logger/index.js";
 import { Router } from "../router/index.js";
 import type {
+	DynamicRoute,
+	FileRouteOptions,
 	FileRouterConfig,
 	PartialFileRouterConfig,
 	RouteDefinition,
-	RouteMatch,
-	DynamicRoute,
 	RouteHandler,
+	RouteMatch,
 	RouteMiddleware,
-	FileRouteOptions,
 	RouteType,
 } from "./types.js";
 import type { SSRPage } from "./types.js";
@@ -103,7 +103,10 @@ export class FileRouter {
 	/**
 	 * Process a single route file
 	 */
-	private async processRouteFile(filePath: string, basePath: string): Promise<void> {
+	private async processRouteFile(
+		filePath: string,
+		basePath: string,
+	): Promise<void> {
 		const fullPath = `${basePath}/${filePath}`;
 		const routePath = this.filePathToRoute(filePath);
 
@@ -167,7 +170,10 @@ export class FileRouter {
 	 * Determine route type from file path
 	 */
 	private getRouteType(filePath: string): RouteType {
-		if (filePath.startsWith(`${this.config.apiDir}/`) || filePath.startsWith("api/")) {
+		if (
+			filePath.startsWith(`${this.config.apiDir}/`) ||
+			filePath.startsWith("api/")
+		) {
 			return "api";
 		}
 		return "page";
@@ -176,9 +182,12 @@ export class FileRouter {
 	/**
 	 * Parse route pattern and extract parameters
 	 */
-	private parseRoutePattern(routePath: string): { pattern: string; params: string[] } {
+	private parseRoutePattern(routePath: string): {
+		pattern: string;
+		params: string[];
+	} {
 		const params: string[] = [];
-		let pattern = routePath;
+		const pattern = routePath;
 
 		// Match [param] - single parameter
 		const singleParamRegex = /\[([^\]]+)\]/g;
@@ -235,7 +244,10 @@ export class FileRouter {
 
 		for (const route of sortedRoutes) {
 			if (route.type === "page") {
-				this.router.get(route.path, this.createPageHandler(route) as import("../types").RouteHandler);
+				this.router.get(
+					route.path,
+					this.createPageHandler(route) as import("../types").RouteHandler,
+				);
 			} else if (route.type === "api") {
 				this.registerApiRoute(route);
 			}
@@ -298,7 +310,10 @@ export class FileRouter {
 		if (!module) return;
 
 		const handlers: Record<string, RouteHandler> = {};
-		const methodMap: Record<string, (pattern: string, handler: import("../types").RouteHandler) => void> = {
+		const methodMap: Record<
+			string,
+			(pattern: string, handler: import("../types").RouteHandler) => void
+		> = {
 			GET: this.router.get.bind(this.router),
 			POST: this.router.post.bind(this.router),
 			PUT: this.router.put.bind(this.router),
@@ -308,10 +323,21 @@ export class FileRouter {
 			OPTIONS: this.router.options.bind(this.router),
 		};
 
-		for (const method of ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"] as const) {
+		for (const method of [
+			"GET",
+			"POST",
+			"PUT",
+			"PATCH",
+			"DELETE",
+			"HEAD",
+			"OPTIONS",
+		] as const) {
 			if (module[method]) {
 				handlers[method] = module[method];
-				methodMap[method](route.path, this.createApiHandler(route, method) as import("../types").RouteHandler);
+				methodMap[method](
+					route.path,
+					this.createApiHandler(route, method) as RouteHandler,
+				);
 			}
 		}
 
@@ -321,7 +347,10 @@ export class FileRouter {
 	/**
 	 * Create API handler for a route and method
 	 */
-	private createApiHandler(route: RouteDefinition, method: string): RouteHandler {
+	private createApiHandler(
+		route: RouteDefinition,
+		method: string,
+	): RouteHandler {
 		return async (request: Request) => {
 			const module = await this.loadApiModule(route.filePath);
 			if (!module || !module[method]) {
@@ -357,7 +386,9 @@ export class FileRouter {
 	/**
 	 * Load API module dynamically
 	 */
-	private async loadApiModule(filePath: string): Promise<Record<string, RouteHandler> | null> {
+	private async loadApiModule(
+		filePath: string,
+	): Promise<Record<string, RouteHandler> | null> {
 		try {
 			const module = await import(filePath);
 			return module;
@@ -370,7 +401,10 @@ export class FileRouter {
 	/**
 	 * Extract params from URL using route definition
 	 */
-	private extractParams(pathname: string, route: RouteDefinition): Record<string, string> {
+	private extractParams(
+		pathname: string,
+		route: RouteDefinition,
+	): Record<string, string> {
 		const params: Record<string, string> = {};
 		const match = pathname.match(route.regex);
 
@@ -386,7 +420,10 @@ export class FileRouter {
 	/**
 	 * Create context for request
 	 */
-	private createContext(request: Request, params: Record<string, string> = {}): import("./types").SSRContext {
+	private createContext(
+		request: Request,
+		params: Record<string, string> = {},
+	): import("./types").SSRContext {
 		const url = new URL(request.url);
 		return {
 			request,
@@ -483,7 +520,10 @@ export class FileRouter {
 	/**
 	 * Generate URL for a route
 	 */
-	generateUrl(routeId: string, params: Record<string, string> = {}): string | null {
+	generateUrl(
+		routeId: string,
+		params: Record<string, string> = {},
+	): string | null {
 		for (const route of this.routes.values()) {
 			if (route.id === routeId) {
 				let url = route.path;
@@ -530,7 +570,9 @@ export class FileRouter {
 /**
  * Create a file router
  */
-export function createFileRouter(config: PartialFileRouterConfig = {}): FileRouter {
+export function createFileRouter(
+	config: PartialFileRouterConfig = {},
+): FileRouter {
 	return new FileRouter(config);
 }
 
@@ -608,4 +650,4 @@ export function compareRouteSpecificity(a: string, b: string): number {
 
 	// Alphabetical comparison
 	return a.localeCompare(b);
-}
+}

package/src/frontend/frameworks/index.ts

@@ -5,19 +5,42 @@
  * Each framework module provides configuration for JSX runtime, plugins, and defines.
  */
 
-import type { FrontendFramework, FrameworkBuildConfig } from "../types.js";
+import type { FrameworkBuildConfig, FrontendFramework } from "../types.js";
 
 // Import framework configurations for internal use
 import { getReactBuildConfig, reactFrameworkMeta } from "./react.js";
-import { getVueBuildConfig, vueFrameworkMeta } from "./vue.js";
-import { getSvelteBuildConfig, svelteFrameworkMeta } from "./svelte.js";
 import { getSolidBuildConfig, solidFrameworkMeta } from "./solid.js";
+import { getSvelteBuildConfig, svelteFrameworkMeta } from "./svelte.js";
+import { getVueBuildConfig, vueFrameworkMeta } from "./vue.js";
 
 // Re-export framework configurations
-export { getReactBuildConfig, isReactComponent, getReactRefreshPreamble, reactFrameworkMeta } from "./react.js";
-export { getVueBuildConfig, isVueComponent, isVueJsx, getVueBlockTypes, vueFrameworkMeta } from "./vue.js";
-export { getSvelteBuildConfig, isSvelteComponent, getSveltePreprocessConfig, getSvelteCompilerOptions, svelteFrameworkMeta } from "./svelte.js";
-export { getSolidBuildConfig, isSolidComponent, getSolidRefreshPreamble, getSolidTransformOptions, solidFrameworkMeta } from "./solid.js";
+export {
+	getReactBuildConfig,
+	isReactComponent,
+	getReactRefreshPreamble,
+	reactFrameworkMeta,
+} from "./react.js";
+export {
+	getVueBuildConfig,
+	isVueComponent,
+	isVueJsx,
+	getVueBlockTypes,
+	vueFrameworkMeta,
+} from "./vue.js";
+export {
+	getSvelteBuildConfig,
+	isSvelteComponent,
+	getSveltePreprocessConfig,
+	getSvelteCompilerOptions,
+	svelteFrameworkMeta,
+} from "./svelte.js";
+export {
+	getSolidBuildConfig,
+	isSolidComponent,
+	getSolidRefreshPreamble,
+	getSolidTransformOptions,
+	solidFrameworkMeta,
+} from "./solid.js";
 
 // Framework metadata types
 export interface FrameworkMeta {
@@ -33,7 +56,9 @@ export interface FrameworkMeta {
 /**
  * Get framework build configuration by framework name
  */
-export function getFrameworkConfig(framework: FrontendFramework): FrameworkBuildConfig {
+export function getFrameworkConfig(
+	framework: FrontendFramework,
+): FrameworkBuildConfig {
 	switch (framework) {
 		case "react":
 			return getReactBuildConfig();
@@ -70,7 +95,9 @@ export function getFrameworkMeta(framework: FrontendFramework): FrameworkMeta {
 /**
  * Detect framework from file extension
  */
-export function detectFrameworkFromExtension(filePath: string): FrontendFramework | null {
+export function detectFrameworkFromExtension(
+	filePath: string,
+): FrontendFramework | null {
 	if (filePath.endsWith(".vue")) {
 		return "vue";
 	}
@@ -103,4 +130,4 @@ export function getAllSupportedExtensions(): string[] {
 export function isSupportedExtension(filePath: string): boolean {
 	const extensions = getAllSupportedExtensions();
 	return extensions.some((ext) => filePath.endsWith(ext));
-}
+}

package/src/frontend/frameworks/react.ts

@@ -5,7 +5,7 @@
  * including JSX runtime, automatic import handling, and React-specific defines.
  */
 
-import type { FrameworkBuildConfig, BuildPlugin } from "../types.js";
+import type { BuildPlugin, FrameworkBuildConfig } from "../types.js";
 
 /**
  * React-specific build plugins
@@ -20,22 +20,24 @@ export function getReactBuildConfig(): FrameworkBuildConfig {
 		// React 17+ automatic JSX runtime
 		jsxRuntime: "automatic",
 		jsxImportSource: "react",
-		
+
 		// React-specific file extensions
 		extensions: [".jsx", ".tsx", ".js", ".ts"],
-		
+
 		// React-specific plugins
 		plugins: reactPlugins,
-		
+
 		// React-specific global defines
 		define: {
 			// Enable React production mode in production builds
-			"process.env.NODE_ENV": JSON.stringify(process.env.NODE_ENV || "development"),
+			"process.env.NODE_ENV": JSON.stringify(
+				process.env.NODE_ENV || "development",
+			),
 		},
-		
+
 		// External dependencies (should not be bundled in library mode)
 		external: [],
-		
+
 		// Loader configurations for React files
 		loaders: {
 			".jsx": "jsx",
@@ -82,4 +84,4 @@ export const reactFrameworkMeta: {
 	needsRefreshRuntime: true,
 	supportsHMR: true,
 	supportsSSR: true,
-};
+};

package/src/frontend/frameworks/solid.ts

@@ -5,7 +5,7 @@
  * including Solid JSX transforms and Solid-specific optimizations.
  */
 
-import type { FrameworkBuildConfig, BuildPlugin } from "../types.js";
+import type { BuildPlugin, FrameworkBuildConfig } from "../types.js";
 
 /**
  * Solid-specific build plugins
@@ -20,24 +20,26 @@ export function getSolidBuildConfig(): FrameworkBuildConfig {
 		// Solid uses automatic JSX runtime with solid-js
 		jsxRuntime: "automatic",
 		jsxImportSource: "solid-js",
-		
+
 		// Solid-specific file extensions
 		extensions: [".jsx", ".tsx", ".js", ".ts"],
-		
+
 		// Solid-specific plugins
 		plugins: solidPlugins,
-		
+
 		// Solid-specific global defines
 		define: {
 			// Solid production mode
-			"process.env.NODE_ENV": JSON.stringify(process.env.NODE_ENV || "development"),
+			"process.env.NODE_ENV": JSON.stringify(
+				process.env.NODE_ENV || "development",
+			),
 			// Solid-specific flags
-			"DEV": JSON.stringify(process.env.NODE_ENV !== "production"),
+			DEV: JSON.stringify(process.env.NODE_ENV !== "production"),
 		},
-		
+
 		// External dependencies
 		external: [],
-		
+
 		// Loader configurations for Solid files
 		loaders: {
 			".jsx": "jsx",
@@ -101,4 +103,4 @@ export const solidFrameworkMeta: {
 	needsRefreshRuntime: true,
 	supportsHMR: true,
 	supportsSSR: true,
-};
+};

package/src/frontend/frameworks/svelte.ts

@@ -5,7 +5,7 @@
  * including Svelte SFC support and Svelte-specific preprocessing.
  */
 
-import type { FrameworkBuildConfig, BuildPlugin } from "../types.js";
+import type { BuildPlugin, FrameworkBuildConfig } from "../types.js";
 
 /**
  * Svelte-specific build plugins
@@ -20,22 +20,24 @@ export function getSvelteBuildConfig(): FrameworkBuildConfig {
 	return {
 		// Svelte doesn't use JSX runtime in the traditional sense
 		jsxRuntime: "classic",
-		
+
 		// Svelte-specific file extensions
 		extensions: [".svelte", ".js", ".ts"],
-		
+
 		// Svelte-specific plugins
 		plugins: sveltePlugins,
-		
+
 		// Svelte-specific global defines
 		define: {
 			// Svelte production mode
-			"process.env.NODE_ENV": JSON.stringify(process.env.NODE_ENV || "development"),
+			"process.env.NODE_ENV": JSON.stringify(
+				process.env.NODE_ENV || "development",
+			),
 		},
-		
+
 		// External dependencies
 		external: [],
-		
+
 		// Loader configurations for Svelte files
 		loaders: {
 			".svelte": "js", // Svelte SFCs are compiled to JS
@@ -76,7 +78,11 @@ export function getSveltePreprocessConfig() {
 export function getSvelteCompilerOptions() {
 	return {
 		// Enable CSS hashing for scoped styles
-		cssHash: ({ hash, css, name }: { hash: (s: string) => string; css: string; name: string }) => {
+		cssHash: ({
+			hash,
+			css,
+			name,
+		}: { hash: (s: string) => string; css: string; name: string }) => {
 			return `svelte-${hash(css)}-${name}`;
 		},
 		// Generate SSR-friendly code
@@ -107,4 +113,4 @@ export const svelteFrameworkMeta: {
 	needsRefreshRuntime: false, // Svelte has built-in HMR
 	supportsHMR: true,
 	supportsSSR: true,
-};
+};