@datamoc/mw_games 0.7.1 → 0.7.3

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@datamoc/mw_games",
-	"version": "0.7.1",
+	"version": "0.7.3",
 	"description": "A local-file game framework: renderer-free game logic, drawn through PixiJS in 2D or Babylon.js in 3D, with mobile and desktop packaging.",
 	"license": "MPL-2.0",
 	"repository": {
@@ -45,6 +45,7 @@
 		"tools/compress-dist.d.mts",
 		"tools/mwl.mjs",
 		"LICENSE",
+		"CHANGELOG.md",
 		"README.md"
 	],
 	"exports": {
@@ -112,6 +113,18 @@
 			"types": "./dist/mwl/index.d.ts",
 			"import": "./dist/mwl/index.js"
 		},
+		"./mwl/fengari": {
+			"types": "./dist/mwl/fengari.d.ts",
+			"import": "./dist/mwl/fengari.js"
+		},
+		"./ai": {
+			"types": "./dist/ai/index.d.ts",
+			"import": "./dist/ai/index.js"
+		},
+		"./ai/lua": {
+			"types": "./dist/ai/lua.d.ts",
+			"import": "./dist/ai/lua.js"
+		},
 		"./tools/compile-resources": "./tools/compile-resources.mjs",
 		"./tools/compress-dist": "./tools/compress-dist.mjs",
 		"./two-d": {
@@ -151,7 +164,7 @@
 		"mwl": "npm run build:pkg && node tools/mwl.mjs",
 		"size:check": "node tools/bundle-size.mjs",
 		"size:update": "node tools/bundle-size.mjs --update",
-		"audit": "npm audit --audit-level=high",
+		"audit": "node tools/npm-audit.mjs",
 		"example": "vite --config examples/colour-transform/vite.config.ts",
 		"example:build": "vite build --config examples/colour-transform/vite.config.ts && node tools/emit-page.mjs examples/colour-transform",
 		"test": "node --test \"tests/**/*.test.ts\"",
@@ -175,6 +188,8 @@
 		"example:battle:build": "npm run mwl -- build examples/battle/content -o examples/battle/generated && vite build --config examples/battle/vite.config.ts && node tools/emit-page.mjs examples/battle",
 		"example:minigame": "vite --config examples/minigame/vite.config.ts",
 		"example:minigame:build": "vite build --config examples/minigame/vite.config.ts && node tools/emit-page.mjs examples/minigame",
+		"example:multi-turn-beam": "vite --config examples/multi-turn-beam/vite.config.ts",
+		"example:multi-turn-beam:build": "vite build --config examples/multi-turn-beam/vite.config.ts && node tools/emit-page.mjs examples/multi-turn-beam",
 		"example:chess": "vite --config examples/chess/vite.config.ts",
 		"example:chess:build": "vite build --config examples/chess/vite.config.ts && node tools/emit-page.mjs examples/chess",
 		"example:tower-defense": "vite --config examples/tower-defense/vite.config.ts",
@@ -267,5 +282,8 @@
 	},
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",
-	"unpkg": "./dist/mw_games.global.js"
+	"unpkg": "./dist/mw_games.global.js",
+	"optionalDependencies": {
+		"fengari": "^0.1.5"
+	}
 }

package/tools/mwl.mjs

@@ -6,7 +6,9 @@ import { pathToFileURL } from 'node:url';
 import {
 	collectHookReferences,
 	compile,
+	compileAndEmitSources,
 	compileSources,
+	contentReport,
 	emitHooksDeclaration,
 	emitModule,
 	extractCatalog,
@@ -26,16 +28,18 @@ 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]',
+		'Usage: mwl <validate|compile|extract-i18n|assets|report|hooks|build> input.mwl [-o output] [--manifest hooks.json] [--asset-root directory]',
 	);
 	process.exitCode = 2;
 } else {
@@ -69,7 +73,8 @@ if (!command || !input || !commands.includes(command)) {
 		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);
@@ -109,14 +114,35 @@ function sourceLabel(file) {
 /** One deterministic build step for the three files every MWL game consumes. */
 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