gofront 1.7.0 → 1.9.0

package/src/{cli-core.js → cli/cli-core.js}

@@ -1,5 +1,5 @@
 // CLI compilation core — extracted for direct import in tests.
-// index.js retains only arg parsing, file I/O, watch mode, and process.exit.
+// index.js retains only arg parsing, dispatch, and process.exit.
 
 import {
 	copyFileSync,
@@ -22,10 +22,10 @@ import {
 	resolve,
 	sep,
 } from "node:path";
+import { isGoFrontWasm } from "../backend/wasm/index.js";
+import { compileDir, compileSingleFile } from "../compiler.js";
 import { copyAssets } from "./asset-manager.js";
-import { isGoFrontWasm } from "./backend/wasm/index.js";
-import { colors, log } from "./colors.js";
-import { compileDir, compileSingleFile } from "./compiler.js";
+import { colors, formatDiagnostic, log, ms, stamp } from "./colors.js";
 import { createDevServer } from "./dev-server.js";
 import { minify } from "./minifier.js";
 import { loadProjectConfig } from "./project-config.js";
@@ -34,7 +34,7 @@ import { runTests } from "./test-runner.js";
 import { bundleVendor } from "./vendor.js";
 
 export const GOFRONT_VERSION = JSON.parse(
-	readFileSync(new URL("../package.json", import.meta.url), "utf8"),
+	readFileSync(new URL("../../package.json", import.meta.url), "utf8"),
 ).version;
 
 export function runCompile(inputPath, isDir, options) {
@@ -45,11 +45,12 @@ export function runCompile(inputPath, isDir, options) {
 		dumpAst = false,
 		emitWat = false,
 		wasmOpt = false,
+		natives = true,
 		forceTarget = null,
 		targetOverrides = null,
 		rootDir = null,
 	} = options ?? {};
-	const targetOpts = {};
+	const targetOpts = { natives };
 	if (forceTarget) targetOpts.forceTarget = forceTarget;
 	if (targetOverrides) targetOpts.targetOverrides = targetOverrides;
 	if (rootDir) targetOpts.rootDir = rootDir;
@@ -133,13 +134,29 @@ function stripTargetFlag(argv) {
 	return out;
 }
 
+// Creates `dir` and any missing parents.  `mkdirSync(dir, { recursive: true })`
+// retries forever when mkdir fails with ENOENT under an existing parent (as it
+// does below /proc), so each missing segment is created on its own and the
+// first failure is thrown.
+export function ensureDir(dir) {
+	const missing = [];
+	let cur = resolve(dir);
+	while (!existsSync(cur)) {
+		missing.push(cur);
+		const parent = dirname(cur);
+		if (parent === cur) break;
+		cur = parent;
+	}
+	for (const d of missing.reverse()) mkdirSync(d);
+}
+
 // Writes the JS bundle plus, when the project links wasm packages, the
 // sibling `app.wasm` (and `app.wat` when requested).  Stale wasm artifacts
 // are removed so a project that drops its wasm packages serves clean output —
 // but only when the existing file is one GoFront produced (recognised by its
 // `gofront` custom section), so a hand-placed `app.wasm` is left alone.
 export function writeCompileOutput(outputFile, result, js = result.js) {
-	mkdirSync(dirname(outputFile), { recursive: true });
+	ensureDir(dirname(outputFile));
 	writeFileSync(outputFile, `${js}\n`);
 	const wasmFile = join(dirname(outputFile), "app.wasm");
 	const watFile = join(dirname(outputFile), "app.wat");
@@ -273,7 +290,7 @@ node_modules/
 
 export function handleInit(targetDir) {
 	try {
-		mkdirSync(targetDir, { recursive: true });
+		ensureDir(targetDir);
 	} catch (e) {
 		throw new Error(`cannot create '${targetDir}': ${e.message}`);
 	}
@@ -286,7 +303,7 @@ export function handleInit(targetDir) {
 
 	for (const { path: filePath, content } of templates) {
 		try {
-			mkdirSync(dirname(filePath), { recursive: true });
+			ensureDir(dirname(filePath));
 			writeFileSync(filePath, content);
 		} catch (e) {
 			throw new Error(`cannot write '${filePath}': ${e.message}`);
@@ -334,6 +351,7 @@ export function formatPrepSummary({ assets, vendor }) {
 
 export function parseTestArgs(argv) {
 	let run = null;
+	let bench = null;
 	const positional = [];
 	const rest = stripTargetFlag(argv);
 	for (let i = 0; i < rest.length; i++) {
@@ -342,6 +360,15 @@ export function parseTestArgs(argv) {
 			run = rest[++i] ?? null;
 		} else if (arg.startsWith("-run=") || arg.startsWith("--run=")) {
 			run = arg.slice(arg.indexOf("=") + 1);
+		} else if (arg === "-bench" || arg === "--bench") {
+			const next = rest[i + 1];
+			if (next !== undefined && !next.startsWith("-")) {
+				bench = rest[++i];
+			} else {
+				bench = true;
+			}
+		} else if (arg.startsWith("-bench=") || arg.startsWith("--bench=")) {
+			bench = arg.slice(arg.indexOf("=") + 1);
 		} else if (!arg.startsWith("-")) {
 			positional.push(arg);
 		}
@@ -351,6 +378,7 @@ export function parseTestArgs(argv) {
 		verbose: argv.includes("-v"),
 		dom: argv.includes("--dom"),
 		run,
+		bench,
 		forceTarget: parseTargetFlag(argv),
 	};
 }
@@ -605,6 +633,7 @@ export function parseBuildArgs(argv) {
 	const noWasmOpt = argv.includes("--no-wasm-opt");
 	const wasmOpt = !noWasmOpt && (argv.includes("--wasm-opt") || release);
 	const forceTarget = parseTargetFlag(argv);
+	const natives = !argv.includes("--no-natives");
 
 	for (let i = 0; i < argv.length; i++) {
 		const arg = argv[i];
@@ -629,6 +658,7 @@ export function parseBuildArgs(argv) {
 		mangle: !noMangle && !noMinify,
 		release,
 		wasmOpt,
+		natives,
 		forceTarget,
 	};
 }
@@ -662,7 +692,11 @@ function cleanOutputDir(outDir, project, srcDir) {
 	if (isSafe && existsSync(resolvedOut)) {
 		rmSync(resolvedOut, { recursive: true, force: true });
 	}
-	mkdirSync(resolvedOut, { recursive: true });
+	try {
+		ensureDir(resolvedOut);
+	} catch (e) {
+		throw new Error(`cannot write '${outDir}': ${e.message}`);
+	}
 }
 
 const STATIC_ASSET_EXTS = new Set([
@@ -734,7 +768,7 @@ function copyServeDirAssets(project, outDir, srcDir) {
 	const copyFile = (full) => {
 		const dest = join(out, relative(serveDir, full));
 		if (existsSync(dest)) return;
-		mkdirSync(dirname(dest), { recursive: true });
+		ensureDir(dirname(dest));
 		copyFileSync(full, dest);
 		copied++;
 	};
@@ -827,6 +861,7 @@ export async function handleBuild(targetDir = ".", options = {}) {
 		sourceMap: options.sourceMap ?? false,
 		emitWat: options.emitWat ?? false,
 		wasmOpt: options.wasmOpt ?? false,
+		natives: options.natives ?? true,
 		forceTarget: options.forceTarget ?? null,
 		...projectTargetOptions(project, options),
 	});
@@ -908,6 +943,201 @@ export function parseLegacyArgs(argv) {
 	};
 }
 
+// `gofront --help` text.
+export const HELP_TEXT = `
+GoFront — a Go-inspired language that compiles to JavaScript and WebAssembly
+
+Usage:
+  gofront dev [dir] [options]    Start dev server with live reload (default port 3000)
+  gofront build [dir] [options]  Build production bundle (-o <dir>, --pwa, --minify, --emit-wat, --release, --wasm-opt, --js-only)
+  gofront check [dir|dir/...]    Type-check only (dir/... recurses into every package)
+  gofront test [dir|dir/...] [--dom]  Run unit tests (-v verbose, -run <regex>, -bench <regex>)
+  gofront prep [dir] [--minify]  Copy static assets and bundle vendor dependencies
+  gofront init [dir]             Scaffold a new GoFront project
+  gofront <file.go>              Compile single file and print to stdout
+  gofront <dir>  (or gofront .)  Compile all *.go in directory as one bundle
+  gofront <input> -o out.js      Compile and write to file (wasm packages also emit app.wasm)
+  gofront <input> --release      Production build with minification and Binaryen wasm optimization
+  gofront <input> --wasm-opt     Optimize wasm output with Binaryen (-O3 + GUFA)
+  gofront <input> --check        Type-check only
+  gofront <input> --watch        Watch for changes and recompile
+  gofront <input> -o out.js --serve          Watch + serve with live reload (default port 3000)
+  gofront <input> -o out.js --serve --port 8080  Use a custom port
+  gofront <input> -o out.js --copy-assets    Compile and synchronize static assets
+  gofront <input> --source-map   Append inline source map to output
+  gofront <input> --minify       Minify output
+  gofront <input> --minify --mangle  Minify and mangle identifiers
+  gofront <file.go> --ast        Dump AST (debug)
+  gofront <file.go> --tokens     Dump tokens (debug)
+  gofront --version              Print version
+`.trim();
+
+// Print the `gofront check` result: one OK line per package, then a total.
+export function reportCheck({ elapsedMs, packages }, targetDir) {
+	const okLine = (label, t) =>
+		log.info(`${colors.cyan(label)} — ${colors.green("OK")} ${ms(t)}`);
+	if (packages) {
+		for (const pkg of packages) {
+			okLine(relative(process.cwd(), pkg.dir) || ".", pkg.elapsedMs);
+		}
+		log.info(
+			`${colors.bold(`${packages.length} packages`)} — ${colors.bold(colors.green("OK"))} ${ms(elapsedMs)}`,
+		);
+	} else {
+		okLine(targetDir, elapsedMs);
+	}
+}
+
+// Print the `gofront build` summary lines.
+export function reportBuild(result) {
+	for (const line of formatBuildSummary(result)) {
+		log.info(
+			line
+				.replace(/^build complete/, colors.green("build complete"))
+				.replace(/\(([\d.]+ kB)\)$/, (_, s) => colors.dim(`(${s})`)),
+		);
+	}
+}
+
+// Copy the project's static assets into place; failures only warn.
+export function copyProjectAssets(verbose, projectDir = ".") {
+	try {
+		const { copied, skipped } = copyAssets(resolve(projectDir));
+		if (verbose && (copied > 0 || skipped > 0)) {
+			log.info(`copied ${copied} assets (${skipped} skipped)`);
+		}
+	} catch (e) {
+		log.warn(`asset copy failed: ${e.message}`);
+	}
+}
+
+// Legacy `gofront <input> [flags]` single-shot flow. `flags` is the result of
+// parseLegacyArgs. Returns the process exit code.
+export function runSingleShot(inputPath, isDir, flags) {
+	const {
+		inputArg,
+		outputFile,
+		checkOnly,
+		dumpAst,
+		dumpTokens,
+		sourceMap,
+		copyAssets: copyAssetsFlag,
+		wasmOpt,
+		minify: minifyOutput,
+		mangle: mangleOutput,
+		forceTarget,
+	} = flags;
+
+	let result;
+	const startMs = performance.now();
+	try {
+		result = runCompile(inputPath, isDir, {
+			sourceMap,
+			outputFile,
+			dumpTokens,
+			dumpAst,
+			wasmOpt,
+			forceTarget,
+		});
+	} catch (e) {
+		log.fail(e.message);
+		return 1;
+	}
+
+	if (result.tokens) {
+		for (const tok of result.tokens) console.log(tok.toString());
+		return 0;
+	}
+	if (result.ast) {
+		console.log(JSON.stringify(result.ast, null, 2));
+		return 0;
+	}
+
+	if (checkOnly) {
+		const elapsedMs = (performance.now() - startMs).toFixed(0);
+		log.info(
+			`${colors.cyan(inputArg)} — ${colors.green("OK")} ${ms(elapsedMs)}`,
+		);
+		return 0;
+	}
+
+	let js;
+	try {
+		js = maybeMinify(result.js, {
+			minify: minifyOutput,
+			mangle: mangleOutput,
+			sourceMap,
+		});
+	} catch (e) {
+		log.fail(`minify failed: ${e.message}`);
+		return 1;
+	}
+
+	const elapsedMs = (performance.now() - startMs).toFixed(0);
+
+	if (outputFile) {
+		try {
+			const written = writeCompileOutput(resolve(outputFile), result, js);
+			log.info(
+				`wrote ${formatWrittenDesc(written, outputFile)} ${ms(elapsedMs)}`,
+			);
+			if (result.wasmOptInfo && result.wasmOptInfo.originalSize > 0) {
+				const origKb = (result.wasmOptInfo.originalSize / 1024).toFixed(1);
+				const optKb = (result.wasmOptInfo.optimizedSize / 1024).toFixed(1);
+				log.info(
+					`wasm-opt: app.wasm ${origKb} kB → ${optKb} kB (-${result.wasmOptInfo.percentSaved}%) [${result.wasmOptInfo.engine}]`,
+				);
+			}
+		} catch (e) {
+			log.fail(`cannot write '${outputFile}': ${e.message}`);
+			return 1;
+		}
+	} else {
+		console.log(js);
+		if (result.wasm) {
+			log.warn(
+				"wasm packages were linked but app.wasm needs -o <file> to be written",
+			);
+		}
+	}
+
+	if (copyAssetsFlag) copyProjectAssets(true);
+
+	return 0;
+}
+
+// Reporters for the legacy `--watch` mode: build and error lines on stderr
+// (the compiled JS goes to stdout when there is no output file).
+export function devReporters({
+	outputFile = null,
+	copyAssets = false,
+	projectDir = ".",
+} = {}) {
+	const prefix = () => `${stamp()} ${colors.bold("gofront:")}`;
+	return {
+		onBuild: ({ js, written, elapsedMs, changedFile }) => {
+			const changeNote = changedFile ? ` — ${changedFile} changed` : "";
+			const timing = colors.dim(`(${elapsedMs}ms${changeNote})`);
+			if (outputFile) {
+				console.error(
+					`${prefix()} ${colors.green("OK")} — wrote ${formatWrittenDesc(written, outputFile)} ${timing}`,
+				);
+			} else {
+				// Clear screen then print
+				process.stdout.write("\x1Bc");
+				console.log(js);
+				console.error(`${prefix()} ${colors.green("OK")} ${timing}`);
+			}
+			if (copyAssets) copyProjectAssets(false, projectDir);
+		},
+		onError: (e) => {
+			console.error(`${prefix()} ${colors.bold(colors.red("ERROR"))}`);
+			for (const line of formatDiagnostic(e.message).split("\n"))
+				console.error(`  ${line}`);
+		},
+	};
+}
+
 // ── dev command ───────────────────────────────────────────────
 
 export function parseDevArgs(argv) {