@datamoc/mw_games 0.37.0 → 0.39.1

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@datamoc/mw_games",
-	"version": "0.37.0",
+	"version": "0.39.1",
 	"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": {
@@ -35,6 +35,7 @@
 	],
 	"bin": {
 		"mwg-bench": "tools/benchmark-browser.mjs",
+		"mwg-assets": "tools/asset-report.mjs",
 		"mwg-audit-adoptions": "tools/audit-adoptions.mjs",
 		"mwg-emit": "tools/emit-page.mjs",
 		"mwg-extract-rgssad": "tools/extract-rgssad.mjs",
@@ -45,6 +46,7 @@
 		"mwg-openings": "tools/compile-openings.mjs",
 		"mwg-placeholder-assets": "tools/make-example-assets.mjs",
 		"mwg-sbom": "tools/sbom.mjs",
+		"mwg-scenarios": "tools/verify-scenarios.mjs",
 		"mwg-size": "tools/bundle-size.mjs",
 		"mwg-smoke": "tools/browser-smoke.mjs",
 		"mwg-tablebases": "tools/build-tablebases.mjs",
@@ -57,6 +59,8 @@
 		"dist",
 		"tools/compile-resources.mjs",
 		"tools/compile-resources.d.mts",
+		"tools/asset-report.mjs",
+		"tools/asset-report.d.mts",
 		"tools/webp-convert.mjs",
 		"tools/webp-convert.d.mts",
 		"tools/extract-html.mjs",
@@ -71,6 +75,8 @@
 		"tools/play-uci.d.mts",
 		"tools/init.mjs",
 		"tools/init.d.mts",
+		"tools/verify-scenarios.mjs",
+		"tools/verify-scenarios.d.mts",
 		"tools/classic-html.mjs",
 		"tools/classic-html.d.mts",
 		"tools/sbom.mjs",
@@ -116,6 +122,14 @@
 		"MWG - Best Practices.md"
 	],
 	"exports": {
+		"./mwl/presentation": {
+			"types": "./dist/mwl/presentation.d.ts",
+			"import": "./dist/mwl/presentation.js"
+		},
+		"./two-d/presentation": {
+			"types": "./dist/two-d/presentation/index.d.ts",
+			"import": "./dist/two-d/presentation/index.js"
+		},
 		".": {
 			"types": "./dist/index.d.ts",
 			"import": "./dist/index.js"
@@ -214,6 +228,7 @@
 		},
 		"./tools/benchmark-browser": "./tools/benchmark-browser.mjs",
 		"./tools/audit-adoptions": "./tools/audit-adoptions.mjs",
+		"./tools/asset-report": "./tools/asset-report.mjs",
 		"./tools/browser-driver": "./tools/browser-driver.mjs",
 		"./tools/benchmark-history": "./tools/benchmark-history.mjs",
 		"./tools/browser-smoke": "./tools/browser-smoke.mjs",
@@ -223,6 +238,7 @@
 		"./tools/compile-openings": "./tools/compile-openings.mjs",
 		"./tools/build-tablebases": "./tools/build-tablebases.mjs",
 		"./tools/init": "./tools/init.mjs",
+		"./tools/verify-scenarios": "./tools/verify-scenarios.mjs",
 		"./tools/play-uci": "./tools/play-uci.mjs",
 		"./tools/compress-dist": "./tools/compress-dist.mjs",
 		"./tools/csp": "./tools/csp.mjs",
@@ -298,6 +314,9 @@
 		"i18n:edit": "node tools/i18n-edit.mjs",
 		"i18n:check": "node tools/i18n-edit.mjs --check",
 		"example:ui": "vite --config examples/interface/vite.config.ts",
+		"example:mwl-presentation": "npm run build:pkg && node examples/mwl-presentation/generate.mjs && vite --config examples/mwl-presentation/vite.config.ts",
+		"example:mwl-presentation:build": "npm run build:pkg && node examples/mwl-presentation/generate.mjs && vite build --config examples/mwl-presentation/vite.config.ts && node tools/emit-page.mjs examples/mwl-presentation --assets=examples/mwl-presentation/assets",
+		"visual:smoke:presentation": "npm run example:mwl-presentation:build && node tools/presentation-smoke.mjs",
 		"example:ui:build": "vite build --config examples/interface/vite.config.ts && node tools/emit-page.mjs examples/interface --assets=examples/assets",
 		"example:dialogue": "vite --config examples/dialogue/vite.config.ts",
 		"example:dialogue:build": "vite build --config examples/dialogue/vite.config.ts && node tools/emit-page.mjs examples/dialogue --assets=examples/assets",
@@ -313,6 +332,10 @@
 		"example:multi-turn-beam:build": "vite build --config examples/multi-turn-beam/vite.config.ts && node tools/emit-page.mjs examples/multi-turn-beam --assets=examples/assets",
 		"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 --assets=examples/assets",
+		"example:cloth": "vite --config examples/cloth/vite.config.ts",
+		"example:cloth:build": "vite build --config examples/cloth/vite.config.ts && node tools/emit-page.mjs examples/cloth --assets=examples/assets",
+		"example:spring": "vite --config examples/spring/vite.config.ts",
+		"example:spring:build": "vite build --config examples/spring/vite.config.ts && node tools/emit-page.mjs examples/spring --assets=examples/assets",
 		"example:tower-defense": "vite --config examples/tower-defense/vite.config.ts",
 		"example:tower-defense:build": "vite build --config examples/tower-defense/vite.config.ts && node tools/emit-page.mjs examples/tower-defense --assets=examples/assets",
 		"example:3d": "vite --config examples/three-d/vite.config.ts",
@@ -384,7 +407,6 @@
 		"@babylonjs/core": "^9.25.0",
 		"@babylonjs/loaders": "^9.25.0",
 		"@capacitor/core": "^8.5.2",
-		"matter-js": "^0.20.0",
 		"pixi.js": "^8.20.1",
 		"playwright-core": "^1.62.1",
 		"ws": "^8.21.3"
@@ -407,9 +429,6 @@
 		},
 		"ws": {
 			"optional": true
-		},
-		"matter-js": {
-			"optional": true
 		}
 	},
 	"devDependencies": {
@@ -419,10 +438,8 @@
 		"@capacitor/cli": "^8.5.2",
 		"@capacitor/core": "^8.5.2",
 		"@capacitor/ios": "^8.5.2",
-		"@types/matter-js": "^0.20.2",
 		"@types/node": "^26.4.1",
 		"@types/ws": "^8.18.1",
-		"matter-js": "^0.20.0",
 		"multithreading": "^0.3.52",
 		"pixi.js": "^8.20.1",
 		"playwright-core": "^1.62.1",

package/sbom.cdx.json

@@ -1,7 +1,7 @@
 {
   "bomFormat": "CycloneDX",
   "specVersion": "1.6",
-  "serialNumber": "urn:uuid:fc255c4f-4827-5c1a-9b7d-2851ddb9d40e",
+  "serialNumber": "urn:uuid:87d5da55-61f5-526f-9055-cdcdd6680517",
   "version": 1,
   "metadata": {
     "tools": {
@@ -10,16 +10,16 @@
           "type": "application",
           "group": "datamoc",
           "name": "tools/sbom.mjs",
-          "version": "0.37.0"
+          "version": "0.39.1"
         }
       ]
     },
     "component": {
       "type": "library",
-      "bom-ref": "pkg:npm/%40datamoc/mw_games@0.37.0",
+      "bom-ref": "pkg:npm/%40datamoc/mw_games@0.39.1",
       "name": "@datamoc/mw_games",
-      "version": "0.37.0",
-      "purl": "pkg:npm/%40datamoc/mw_games@0.37.0",
+      "version": "0.39.1",
+      "purl": "pkg:npm/%40datamoc/mw_games@0.39.1",
       "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.",
       "licenses": [
         {
@@ -1375,27 +1375,6 @@
         }
       ]
     },
-    {
-      "type": "library",
-      "bom-ref": "pkg:npm/%40types/matter-js@0.20.2",
-      "name": "@types/matter-js",
-      "version": "0.20.2",
-      "purl": "pkg:npm/%40types/matter-js@0.20.2",
-      "scope": "excluded",
-      "hashes": [
-        {
-          "alg": "SHA-512",
-          "content": "dcf3cacb7431bd9f3d87dfb0741576e3cf08d492d5b3b0c4a4890fbe03bc242d6651d89548edfb648bd572d3930fb848abc3802f6809dee8064ae522a7a0e10b"
-        }
-      ],
-      "licenses": [
-        {
-          "license": {
-            "id": "MIT"
-          }
-        }
-      ]
-    },
     {
       "type": "library",
       "bom-ref": "pkg:npm/%40types/node@26.6.5",
@@ -3181,27 +3160,6 @@
         }
       ]
     },
-    {
-      "type": "library",
-      "bom-ref": "pkg:npm/matter-js@0.20.0",
-      "name": "matter-js",
-      "version": "0.20.0",
-      "purl": "pkg:npm/matter-js@0.20.0",
-      "scope": "excluded",
-      "hashes": [
-        {
-          "alg": "SHA-512",
-          "content": "882f5f611ef3553dc7a69367b05b29f573a841d40ddad5327da2a0e021cb1fc6cdfa3e864f81b0ec81f6acfd2d7e501e6eb1c5c3bdf4451dc3915499457f21c0"
-        }
-      ],
-      "licenses": [
-        {
-          "license": {
-            "id": "MIT"
-          }
-        }
-      ]
-    },
     {
       "type": "library",
       "bom-ref": "pkg:npm/minimatch@10.2.6",
@@ -4643,7 +4601,7 @@
       ]
     },
     {
-      "ref": "pkg:npm/%40datamoc/mw_games@0.37.0",
+      "ref": "pkg:npm/%40datamoc/mw_games@0.39.1",
       "dependsOn": [
         "pkg:npm/%40babylonjs/core@9.30.0",
         "pkg:npm/%40babylonjs/loaders@9.30.0",
@@ -4652,11 +4610,9 @@
         "pkg:npm/%40capacitor/core@8.5.3",
         "pkg:npm/%40capacitor/ios@8.5.3",
         "pkg:npm/%40datamoc/pyroeis@0.9.0",
-        "pkg:npm/%40types/matter-js@0.20.2",
         "pkg:npm/%40types/node@26.6.5",
         "pkg:npm/%40types/ws@8.18.2",
         "pkg:npm/json5@2.2.3",
-        "pkg:npm/matter-js@0.20.0",
         "pkg:npm/multithreading@0.3.52",
         "pkg:npm/pixi.js@8.22.0",
         "pkg:npm/playwright-core@1.64.0",
@@ -4980,10 +4936,6 @@
         "pkg:npm/%40types/node@26.6.5"
       ]
     },
-    {
-      "ref": "pkg:npm/%40types/matter-js@0.20.2",
-      "dependsOn": []
-    },
     {
       "ref": "pkg:npm/%40types/node@26.6.5",
       "dependsOn": [
@@ -5385,10 +5337,6 @@
       "ref": "pkg:npm/lru-cache@11.5.3",
       "dependsOn": []
     },
-    {
-      "ref": "pkg:npm/matter-js@0.20.0",
-      "dependsOn": []
-    },
     {
       "ref": "pkg:npm/minimatch@10.2.6",
       "dependsOn": [

package/tools/asset-report.d.mts

@@ -0,0 +1,37 @@
+export interface AssetReportFile {
+	path: string;
+	raw: number;
+	gzip: number;
+	brotli: number;
+	sha256: string;
+	/** This file's gzip bytes over the page's total gzip bytes, 0 when the page is empty. */
+	share: number;
+}
+export interface AssetReportSource {
+	path: string;
+	raw: number;
+	sha256: string;
+}
+export interface AssetReportTotals {
+	files: number;
+	raw: number;
+	gzip: number;
+	brotli: number;
+	assetFiles: number;
+	assetRaw: number;
+}
+export interface AssetReport {
+	dist: string;
+	files: AssetReportFile[];
+	assets: AssetReportSource[];
+	/** Groups of source paths with byte-identical content, sorted; empty when none exist. */
+	duplicates: string[][];
+	totals: AssetReportTotals;
+}
+export function fingerprint(data: Uint8Array): string;
+export function compressedSizes(data: Uint8Array): { gzip: number; brotli: number };
+export function assetReport(options: {
+	dist: string;
+	assets?: string;
+	mime?: Record<string, string>;
+}): Promise<AssetReport>;

package/tools/asset-report.mjs

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+import { createHash } from 'node:crypto';
+import { gzipSync, brotliCompressSync, constants } from 'node:zlib';
+import { realpathSync, statSync } from 'node:fs';
+import { readFile, writeFile } from 'node:fs/promises';
+import { join, relative, sep, extname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { walk, DEFAULT_MIME } from './compile-resources.mjs';
+
+/**
+ * Reports what a built page actually ships, so a game can see where its bytes go.
+ *
+ * Two halves, both deterministic (sorted paths, fixed compression settings, hashes):
+ *
+ *   - `files`: every file under `dist` (precompressed `.gz`/`.br`/`.xz` siblings
+ *     excluded - they are derived artifacts, and the gzip/brotli columns already count
+ *     them) with raw, gzip (level 9) and brotli (quality 11) weights plus its share of
+ *     the compressed page, the same settings `tools/compress-dist.mjs` writes with;
+ *   - `assets`: every source file the asset folder embeds (the root `credits.json`
+ *     and unknown extensions excluded, exactly the files `compileResources` skips),
+ *     with duplicates grouped by SHA-256 so an asset embedded twice is visible.
+ *
+ * Shipped as `@datamoc/mw_games/tools/asset-report` (`assetReport(options)`, what the
+ * flags below map onto) and as the `mwg-assets` command.
+ *
+ * usage: mwg-assets <dist folder> [--assets=<dir>] [--json=<report file>]
+ */
+
+const DERIVED_SIBLINGS = new Set(['.gz', '.br', '.xz']);
+
+export function fingerprint(data) {
+	return createHash('sha256').update(data).digest('hex');
+}
+
+export function compressedSizes(data) {
+	return {
+		gzip: gzipSync(data, { level: 9 }).length,
+		brotli: brotliCompressSync(data, { params: { [constants.BROTLI_PARAM_QUALITY]: 11 } }).length,
+	};
+}
+
+function isDirectory(path) {
+	try {
+		return statSync(path).isDirectory();
+	} catch {
+		return false;
+	}
+}
+
+/**
+ * @param options.dist the built page folder to measure
+ * @param options.assets the asset source folder to inventory (skipped when absent)
+ * @param options.mime extension to MIME type, merged over the compile defaults, so a
+ *   game embedding extra types reports the same set the build embeds
+ * @returns the sorted files, sources, duplicate groups and totals described above
+ */
+export async function assetReport({ dist, assets, mime = {} } = {}) {
+	if (!dist || !isDirectory(dist))
+		throw new Error(`assetReport needs the dist folder of a built page, got "${dist}"`);
+	if (assets !== undefined && !isDirectory(assets))
+		throw new Error(`assetReport needs a readable assets folder, got "${assets}"`);
+
+	const files = [];
+	for await (const file of walk(dist)) {
+		if (DERIVED_SIBLINGS.has(extname(file).toLowerCase())) continue;
+		const data = await readFile(file);
+		const { gzip, brotli } = compressedSizes(data);
+		files.push({
+			path: relative(dist, file).split(sep).join('/'),
+			raw: data.length,
+			gzip,
+			brotli,
+			sha256: fingerprint(data),
+			share: 0,
+		});
+	}
+	files.sort((a, b) => (a.path < b.path ? -1 : 1));
+	const totalGzip = files.reduce((sum, file) => sum + file.gzip, 0);
+	for (const file of files) file.share = totalGzip ? file.gzip / totalGzip : 0;
+
+	const sources = [];
+	const duplicates = [];
+	if (assets !== undefined) {
+		const types = { ...DEFAULT_MIME, ...mime };
+		const creditsFile = join(assets, 'credits.json');
+		const byHash = new Map();
+		for await (const file of walk(assets)) {
+			if (file === creditsFile) continue;
+			if (!types[extname(file).toLowerCase()]) continue;
+			const data = await readFile(file);
+			const sha256 = fingerprint(data);
+			const key = relative(assets, file).split(sep).join('/');
+			sources.push({ path: key, raw: data.length, sha256 });
+			const group = byHash.get(sha256) ?? [];
+			group.push(key);
+			byHash.set(sha256, group);
+		}
+		sources.sort((a, b) => (a.path < b.path ? -1 : 1));
+		for (const group of byHash.values()) if (group.length > 1) duplicates.push([...group].sort());
+		duplicates.sort((a, b) => (a[0] < b[0] ? -1 : 1));
+	}
+
+	return {
+		dist,
+		files,
+		assets: sources,
+		duplicates,
+		totals: {
+			files: files.length,
+			raw: files.reduce((sum, file) => sum + file.raw, 0),
+			gzip: totalGzip,
+			brotli: files.reduce((sum, file) => sum + file.brotli, 0),
+			assetFiles: sources.length,
+			assetRaw: sources.reduce((sum, source) => sum + source.raw, 0),
+		},
+	};
+}
+
+const kb = (n) => (n / 1024).toFixed(1) + ' KB';
+const percent = (share) => (share * 100).toFixed(1) + '%';
+
+async function main(argv) {
+	const folder = argv.find((arg) => !arg.startsWith('--'));
+	if (!folder) {
+		console.error('usage: mwg-assets <dist folder> [--assets=<dir>] [--json=<report file>]');
+		process.exit(1);
+	}
+	const value = (name) => argv.find((a) => a.startsWith(`--${name}=`))?.slice(name.length + 3);
+	const report = await assetReport({ dist: folder, assets: value('assets') });
+
+	console.log(`\n  ${report.dist}`);
+	for (const file of report.files) {
+		console.log(
+			`  ${file.path.padEnd(40)}${kb(file.raw).padStart(10)}  gz ${kb(file.gzip).padStart(10)}  br ${kb(file.brotli).padStart(10)}  ${percent(file.share).padStart(6)}`,
+		);
+	}
+	console.log(
+		`  ${report.totals.files} file(s), ${kb(report.totals.raw)} raw -> ${kb(report.totals.gzip)} gz / ${kb(report.totals.brotli)} br`,
+	);
+	if (report.assets.length) {
+		console.log(`  ${report.totals.assetFiles} embedded asset(s), ${kb(report.totals.assetRaw)} raw`);
+		for (const group of report.duplicates) console.log(`  duplicate: ${group.join(' == ')}`);
+	}
+	const json = value('json');
+	if (json) {
+		await writeFile(json, JSON.stringify(report, null, 2) + '\n', 'utf8');
+		console.log(`  report written to ${json}`);
+	}
+}
+
+//realpath, since an npm `bin` shim reaches this file through a symlink
+//no top-level await: a vite config loaded as CommonJS has to be able to require() this module
+if (process.argv[1] && realpathSync(process.argv[1]) === fileURLToPath(import.meta.url))
+	main(process.argv.slice(2)).catch((error) => {
+		console.error(error);
+		process.exitCode = 1;
+	});

package/tools/compile-resources.d.mts

@@ -7,6 +7,8 @@ export interface CompileResourcesOptions {
 	to: string;
 	mime?: Record<string, string>;
 	groupBy?: (key: string) => string;
+	/** Exact paths relative to the asset folder to embed. Omit to include all; [] includes none. Unknown entries fail by name. */
+	assetFiles?: readonly string[];
 	toWebp?: boolean;
 	webpLossless?: boolean;
 	webpQuality?: number;

package/tools/compile-resources.mjs

@@ -58,6 +58,9 @@ export async function* walk(dir) {
  * @param options.from folder holding the assets
  * @param options.to folder to write the generated scripts into
  * @param options.mime extension to MIME type, merged over the defaults
+ * @param options.assetFiles exact paths relative to `from` to embed; omit for all, [] for none.
+ *   Unknown paths and explicitly selected unsupported formats fail before replacing output.
+ *   credits.json is converted to CREDITS.txt only when selected (or when no list is given).
  * @param options.groupBy how to name the script an asset lands in; defaults to its top folder
  * @param options.toWebp convert `.png`/`.jpg`/`.jpeg` assets to WebP before embedding
  *   (default false - see `tools/webp-convert.mjs`). The asset's *key* never changes (a game
@@ -81,6 +84,7 @@ export async function compileResources({
 	to,
 	mime = {},
 	groupBy,
+	assetFiles,
 	toWebp: convertToWebp = false,
 	webpLossless = true,
 	webpQuality = 90,
@@ -90,6 +94,22 @@ export async function compileResources({
 	const types = { ...DEFAULT_MIME, ...mime };
 	const group = groupBy ?? ((key) => (key.includes('/') ? key.slice(0, key.indexOf('/')) : 'assets'));
 
+	const files = [];
+	for await (const file of walk(from)) files.push(file);
+	const keyOf = (file) => relative(from, file).split(sep).join('/');
+	const selected =
+		assetFiles === undefined
+			? undefined
+			: new Set(assetFiles.map((key) => key.replaceAll('\\', '/').replace(/^\.\//, '')));
+	if (selected) {
+		const known = new Set(files.map(keyOf));
+		for (const key of selected) {
+			if (!known.has(key)) throw new Error(`unknown asset file ${key}`);
+			if (key !== 'credits.json' && !types[extname(key).toLowerCase()])
+				throw new Error(`unsupported asset file ${key}`);
+		}
+	}
+
 	await rm(to, { recursive: true, force: true });
 	await mkdir(to, { recursive: true });
 
@@ -106,7 +126,8 @@ export async function compileResources({
 	const creditsFile = join(from, 'credits.json');
 	let credits = null;
 
-	for await (const file of walk(from)) {
+	for (const file of files) {
+		if (selected && !selected.has(keyOf(file))) continue;
 		if (file === creditsFile) {
 			credits = creditsText(JSON.parse(await readFile(file, 'utf8')));
 			continue;
@@ -118,7 +139,7 @@ export async function compileResources({
 			continue;
 		}
 
-		const key = relative(from, file).split(sep).join('/');
+		const key = keyOf(file);
 		const data = await readFile(file);
 
 		let mimeType = type;

package/tools/emit-page.d.mts

@@ -9,6 +9,8 @@ export interface EmitPageOptions {
 	assets?: string;
 	/** maps an asset path to its script's name; defaults to one script per top-level folder */
 	groupBy?: (key: string) => string;
+	/** Exact paths relative to the asset folder to embed. Omit to include all; [] includes none. Unknown entries fail by name. */
+	assetFiles?: readonly string[];
 	/** write `.gz`/`.br` siblings for a server to negotiate; default true */
 	compress?: boolean;
 	/** also write `.xz`, where the system `xz` binary exists */

package/tools/emit-page.mjs

@@ -66,6 +66,7 @@ export async function emitPage({
 	dist,
 	assets,
 	groupBy,
+	assetFiles,
 	compress = true,
 	xz = false,
 	singleFile = false,
@@ -75,8 +76,17 @@ export async function emitPage({
 	csp = true,
 }) {
 	if (!dist) throw new Error('emitPage needs the dist folder of a vite build');
+	if (!assets && assetFiles?.length) throw new Error(`unknown asset file ${assetFiles[0]}: no assets folder`);
 	const compiled = assets
-		? await compileResources({ from: assets, to: join(dist, 'assets'), groupBy, toWebp, webpLossless, webpQuality })
+		? await compileResources({
+				from: assets,
+				to: join(dist, 'assets'),
+				groupBy,
+				assetFiles,
+				toWebp,
+				webpLossless,
+				webpQuality,
+			})
 		: { groups: [], rawBytes: 0, embeddedBytes: 0, webpConverted: 0 };
 
 	const html = await readFile(join(dist, 'index.html'), 'utf8');

package/tools/verify-scenarios.d.mts

@@ -0,0 +1,15 @@
+export interface ScenarioPlanEntry {
+	id: string;
+	enter: string;
+	/** Steps that play all sides and advance dialogue for one game-owned turn. */
+	turn: string[];
+	/** A step that throws when game-owned map, units, outcome or campaign checks fail. */
+	verify: string;
+	leave?: string;
+}
+export function validateScenarioPlan(plan: unknown): ScenarioPlanEntry[];
+export function verifyScenarios(options: { file: string; turns?: number; timeoutMs?: number; only?: string }): Promise<{
+	ok: boolean;
+	scenarios: { id: string; turns: number; ok: boolean }[];
+	failures: string[];
+}>;