@datamoc/mw_games 0.7.0 → 0.7.2

package/tools/mwl.mjs

@@ -6,6 +6,9 @@ import { pathToFileURL } from 'node:url';
 import {
 	collectHookReferences,
 	compile,
+	compileAndEmitSources,
+	compileSources,
+	contentReport,
 	emitHooksDeclaration,
 	emitModule,
 	extractCatalog,
@@ -25,36 +28,53 @@ import {
  */
 
 const args = process.argv.slice(2);
-const commands = ['validate', 'compile', 'extract-i18n', 'assets', 'hooks', 'build'];
+const commands = ['validate', 'compile', 'extract-i18n', 'assets', 'report', 'hooks', 'build'];
 const [command, input] = args;
 const outputFlag = args.indexOf('-o');
 const output = outputFlag === -1 ? undefined : args[outputFlag + 1];
 const manifestFlag = args.indexOf('--manifest');
 const manifestPath = manifestFlag === -1 ? undefined : args[manifestFlag + 1];
+const assetRootFlag = args.indexOf('--asset-root');
+const assetRoot = assetRootFlag === -1 ? undefined : args[assetRootFlag + 1];
 
 if (!command || !input || !commands.includes(command)) {
-	console.error('Usage: mwl <validate|compile|extract-i18n|assets|hooks|build> input.mwl [-o output] [--manifest hooks.json]');
+	console.error(
+		'Usage: mwl <validate|compile|extract-i18n|assets|report|hooks|build> input.mwl [-o output] [--manifest hooks.json] [--asset-root directory]',
+	);
 	process.exitCode = 2;
 } else {
-	const source = fs.readFileSync(input, 'utf8');
+	const files = fs.statSync(input).isDirectory()
+		? collectSources(input)
+		: [{ file: sourceLabel(input), source: fs.readFileSync(input, 'utf8') }];
 	if (command === 'validate') {
-		const diagnostics = validate(parse(preprocess(source, { file: input }), input));
+		const diagnostics = files.flatMap((file) =>
+			validate(parse(preprocess(file.source, { file: file.file }), file.file)),
+		);
 		if (diagnostics.length) {
 			for (const diagnostic of diagnostics)
 				console.error(
 					`${diagnostic.location.file}:${diagnostic.location.line}:${diagnostic.location.column}: ${diagnostic.message}`,
 				);
 			process.exitCode = 1;
-		} else console.log(`${input}: valid MWL`);
+		} else {
+			try {
+				compileSources(files);
+				console.log(`${input}: valid MWL`);
+			} catch (error) {
+				console.error(error instanceof Error ? error.message : String(error));
+				process.exitCode = 1;
+			}
+		}
 	} else if (command === 'hooks') {
-		await hooks(source);
+		await hooks(files);
 	} else if (command === 'build') {
-		build(source);
+		build(files);
 	} else {
-		const result = compile(source, { file: input });
+		const result = compileSources(files);
 		const values =
 			command === 'extract-i18n' ? extractCatalog(result) : command === 'assets' ? result.assets : result;
-		const text = command === 'compile' ? emitModule(result) : `${JSON.stringify(values, null, '\t')}\n`;
+		const report = command === 'report' ? contentReport(result) : values;
+		const text = command === 'compile' ? emitModule(result) : `${JSON.stringify(report, null, '\t')}\n`;
 		if (output) {
 			fs.mkdirSync(path.dirname(path.resolve(output)), { recursive: true });
 			fs.writeFileSync(output, text);
@@ -62,25 +82,75 @@ if (!command || !input || !commands.includes(command)) {
 	}
 }
 
+function collectSources(directory) {
+	const files = [];
+	const root = path.resolve(directory);
+	const label = sourceLabel(root);
+	const visit = (current) => {
+		for (const entry of fs
+			.readdirSync(current, { withFileTypes: true })
+			.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0))) {
+			const full = path.join(current, entry.name);
+			if (entry.isDirectory()) visit(full);
+			else if (/\.mwl$/i.test(entry.name)) {
+				const relative = path.relative(root, full);
+				files.push({
+					file: path.join(label, relative).split(path.sep).join('/'),
+					source: fs.readFileSync(full, 'utf8'),
+				});
+			}
+		}
+	};
+	visit(root);
+	if (!files.length) throw new Error(`no .mwl files found in ${directory}`);
+	return files;
+}
+
+function sourceLabel(file) {
+	const relative = path.relative(process.cwd(), path.resolve(file));
+	return (relative || path.basename(path.resolve(file))).split(path.sep).join('/');
+}
+
 /** One deterministic build step for the three files every MWL game consumes. */
-function build(source) {
-	const game = compile(source, { file: input });
+function build(files) {
+	const game = compileSources(files);
+	if (assetRoot) validateAssets(game, path.resolve(assetRoot));
 	const directory = path.resolve(output ?? 'generated');
 	fs.mkdirSync(directory, { recursive: true });
-	fs.writeFileSync(path.join(directory, 'game-data.ts'), emitModule(game));
-	fs.writeFileSync(path.join(directory, 'i18n.json'), `${JSON.stringify(extractCatalog(game), null, '\t')}\n`);
-	fs.writeFileSync(path.join(directory, 'assets.json'), `${JSON.stringify({ assets: game.assets }, null, '\t')}\n`);
+	const artifacts = compileAndEmitSources(files);
+	for (const artifact of artifacts) fs.writeFileSync(path.join(directory, artifact.name), artifact.content);
 	console.log(`built MWL into ${directory}`);
 }
 
+function validateAssets(game, root) {
+	const missing = game.assets.filter(
+		(asset) => !asset.startsWith('data:') && !fs.existsSync(path.resolve(root, asset)),
+	);
+	if (!missing.length) return;
+	const locations = new Map();
+	const visit = (node) => {
+		for (const value of Object.values(node.attributes))
+			for (const asset of missing)
+				if (value.includes(asset) && !locations.has(asset)) locations.set(asset, node.location);
+		node.children.forEach(visit);
+	};
+	game.roots.forEach(visit);
+	for (const asset of missing) {
+		const location = locations.get(asset);
+		const prefix = location ? `${location.file}:${location.line}:${location.column}: ` : '';
+		console.error(`${prefix}missing MWL asset "${asset}" under ${root}`);
+	}
+	throw new Error(`${missing.length} MWL asset(s) not found`);
+}
+
 /**
  * `mwl hooks game.mwl` prints the hook references content needs.
  * `mwl hooks game.mwl --manifest hooks.json -o generated/hooks.mjs` resolves
  * each reference against the manifest, bundles the hook sources with esbuild,
  * and writes the matching declaration next to the bundle.
  */
-async function hooks(source) {
-	const game = compile(source, { file: input });
+async function hooks(files) {
+	const game = compileSources(files);
 	const references = collectHookReferences(game);
 	if (!output) {
 		process.stdout.write(