@datamoc/mw_games 0.5.4 → 0.7.0

package/tools/mwl.mjs

@@ -0,0 +1,153 @@
+import fs from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import process from 'node:process';
+import { pathToFileURL } from 'node:url';
+import {
+	collectHookReferences,
+	compile,
+	emitHooksDeclaration,
+	emitModule,
+	extractCatalog,
+	parse,
+	preprocess,
+	validate,
+	validateHookReferences,
+} from '../dist/mwl/index.js';
+
+/**
+ * Command line for MWL: validate, compile, extract-i18n, assets, hooks, build.
+ *
+ * Reading files happens here, not in the published module, so the library
+ * itself stays free of node builtins. `hooks` needs esbuild and says so
+ * clearly when it is not installed; the framework does not depend on it, so a
+ * project without hooks pays nothing for the feature.
+ */
+
+const args = process.argv.slice(2);
+const commands = ['validate', 'compile', 'extract-i18n', 'assets', '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];
+
+if (!command || !input || !commands.includes(command)) {
+	console.error('Usage: mwl <validate|compile|extract-i18n|assets|hooks|build> input.mwl [-o output] [--manifest hooks.json]');
+	process.exitCode = 2;
+} else {
+	const source = fs.readFileSync(input, 'utf8');
+	if (command === 'validate') {
+		const diagnostics = validate(parse(preprocess(source, { file: input }), input));
+		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 if (command === 'hooks') {
+		await hooks(source);
+	} else if (command === 'build') {
+		build(source);
+	} else {
+		const result = compile(source, { file: input });
+		const values =
+			command === 'extract-i18n' ? extractCatalog(result) : command === 'assets' ? result.assets : result;
+		const text = command === 'compile' ? emitModule(result) : `${JSON.stringify(values, null, '\t')}\n`;
+		if (output) {
+			fs.mkdirSync(path.dirname(path.resolve(output)), { recursive: true });
+			fs.writeFileSync(output, text);
+		} else process.stdout.write(text);
+	}
+}
+
+/** One deterministic build step for the three files every MWL game consumes. */
+function build(source) {
+	const game = compile(source, { file: input });
+	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`);
+	console.log(`built MWL into ${directory}`);
+}
+
+/**
+ * `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 });
+	const references = collectHookReferences(game);
+	if (!output) {
+		process.stdout.write(
+			`${JSON.stringify(
+				references.map((reference) => `${reference.type}:${reference.name}`),
+				null,
+				'\t',
+			)}\n`,
+		);
+		return;
+	}
+	const manifest = manifestPath ? JSON.parse(fs.readFileSync(manifestPath, 'utf8')) : {};
+	const diagnostics = validateHookReferences(references, Object.keys(manifest));
+	if (diagnostics.length) {
+		for (const diagnostic of diagnostics)
+			console.error(`${diagnostic.location.file}:${diagnostic.location.line}: ${diagnostic.message}`);
+		console.error(`${diagnostics.length} hook reference(s) have no manifest entry; nothing was bundled`);
+		process.exitCode = 1;
+		return;
+	}
+
+	// Resolve esbuild from the game project (the working directory), not from
+	// the framework package: the framework does not depend on esbuild, and the
+	// project that writes hooks is the one that installs the bundler.
+	const requireFromProject = createRequire(pathToFileURL(path.join(process.cwd(), 'package.json')));
+	let esbuild = null;
+	try {
+		esbuild = requireFromProject('esbuild');
+	} catch {
+		esbuild = null;
+	}
+	if (!esbuild) {
+		console.error('mwl hooks needs esbuild. Install it in the game project: npm install --save-dev esbuild');
+		process.exitCode = 2;
+		return;
+	}
+
+	const manifestDir = manifestPath ? path.dirname(path.resolve(manifestPath)) : process.cwd();
+	// The entry file lives beside the hooks so its imports stay relative;
+	// esbuild does not resolve `file://` import specifiers.
+	const entryFile = path.join(manifestDir, `.mwl-hooks-${process.pid}-${Date.now()}.ts`);
+	const imports = [];
+	const exports = [];
+	references.forEach((reference, index) => {
+		const id = `${reference.type}:${reference.name}`;
+		const [file, exportName = reference.name] = String(manifest[id]).split('#');
+		const relative = path.relative(manifestDir, path.resolve(manifestDir, file)).split(path.sep).join('/');
+		const specifier = relative.startsWith('.') ? relative : `./${relative}`;
+		imports.push(`import { ${exportName} as hook${index} } from ${JSON.stringify(specifier)};`);
+		exports.push(`\t${JSON.stringify(id)}: hook${index},`);
+	});
+	const entry = `${imports.join('\n')}\n\nexport const hooks = {\n${exports.join('\n')}\n};\n`;
+	fs.writeFileSync(entryFile, entry);
+	try {
+		fs.mkdirSync(path.dirname(path.resolve(output)), { recursive: true });
+		await esbuild.build({
+			entryPoints: [entryFile],
+			bundle: true,
+			format: 'esm',
+			platform: 'neutral',
+			target: 'es2022',
+			outfile: output,
+			logLevel: 'silent',
+		});
+		fs.writeFileSync(`${output}.d.ts`, emitHooksDeclaration(references));
+		console.log(`bundled ${references.length} hook(s) into ${output}`);
+	} finally {
+		fs.rmSync(entryFile, { force: true });
+	}
+}

package/dist/roguelike/Blob.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Blob.d.ts","sourceRoot":"","sources":["../../src/roguelike/Blob.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,qBAAa,IAAI;IAChB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,OAAO,CAAC,MAAM,CAAe;IAE7B,YAAY,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAIxC;IAED,4DAA4D;IAC5D,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGrC;IAED,iFAAiF;IACjF,KAAK,IAAI,MAAM,CAId;IAED,2EAA2E;IAC3E,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAG/C;IAED;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,EAAE,MAAM,SAAO,EAAE,KAAK,SAAM,GAAG,IAAI,CAgCpF;IAED,qFAAqF;IACrF,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAS3E;IAED,MAAM,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAE5D;IAED,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAI/E;CACD"}

package/dist/roguelike/Blob.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Blob.js","sourceRoot":"","sources":["../../src/roguelike/Blob.ts"],"names":[],"mappings":"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"}