A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
fix(tools): a pixel verifier says when it is judging a stale engine
yhh44c57895a9f1
diff --git a/tools/lib/engineBuild.mjs b/tools/lib/engineBuild.mjsnew file mode 100644index 000000000..b00c80528--- /dev/null+++ b/tools/lib/engineBuild.mjs@@ -0,0 +1,67 @@+// SPDX-License-Identifier: Apache-2.0+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team+/**+ * @file engineBuild.mjs — is the engine binary the pixel verifiers judge built+ * from the engine source that is checked out?+ *+ * A stale one does not announce itself. It draws, so every verdict downstream is+ * about an engine nobody has: a shadow fix that landed hours earlier read as a+ * platform-dependent renderer defect, because the scene written to prove the fix+ * was being run against the binary from before it. `desktop/public/wasm` is+ * gitignored, so its build stamp against the source mtimes is the whole answer.+ */+import { readFileSync, readdirSync, statSync, existsSync } from 'node:fs';+import path from 'node:path';++/** Compiled into the engine wasm. Tool-only trees (tools/*-wasm) are not. */+const ENGINE_SOURCE = ['src'];++function newestSource(root) {+ let newest = { at: 0, file: null };+ const walk = (dir) => {+ for (const entry of readdirSync(dir, { withFileTypes: true })) {+ const full = path.join(dir, entry.name);+ if (entry.isDirectory()) { walk(full); continue; }+ if (!/\.(c|cc|cpp|h|hpp|inl|esshader|wgsl)$/.test(entry.name)) continue;+ const at = statSync(full).mtimeMs;+ if (at > newest.at) newest = { at, file: path.relative(root, full).split(path.sep).join('/') };+ }+ };+ for (const dir of ENGINE_SOURCE) {+ const abs = path.join(root, dir);+ if (existsSync(abs)) walk(abs);+ }+ return newest;+}++/**+ * A sentence naming the engine source that outran the binary, or null when the+ * binary is current (or when there is none to judge — that failure speaks for+ * itself downstream).+ */+export function staleEngineBuild(root, wasmDir) {+ const manifest = path.join(wasmDir, 'wasm.manifest.json');+ if (!existsSync(manifest)) return null;+ let builtAt;+ try {+ builtAt = Date.parse(JSON.parse(readFileSync(manifest, 'utf8')).builtAt);+ } catch { return null; }+ if (!Number.isFinite(builtAt)) return null;++ const newest = newestSource(root);+ if (!newest.file || newest.at <= builtAt) return null;+ const hours = Math.round((newest.at - builtAt) / 36e5);+ const behind = hours >= 1 ? `${hours}h` : `${Math.round((newest.at - builtAt) / 6e4)}min`;+ return `the engine binary in ${path.relative(root, wasmDir).split(path.sep).join('/')} was built `+ + `${behind} before ${newest.file} was last changed — every pixel verdict below would be `+ + `about an engine this checkout does not have.\nBuild it: node build-tools/cli.js build -t web`;+}++/** Exit unless the binary is current. `--allow-stale-engine` says you meant it. */+export function requireCurrentEngine(root, wasmDir, argv = process.argv) {+ if (argv.includes('--allow-stale-engine')) return;+ const stale = staleEngineBuild(root, wasmDir);+ if (!stale) return;+ console.error(`\n✗ ${stale}\n`);+ process.exit(1);+}diff --git a/tools/verify-golden.mjs b/tools/verify-golden.mjsindex 7d2ff8fc5..c1570afd9 100644--- a/tools/verify-golden.mjs+++ b/tools/verify-golden.mjs@@ -23,6 +23,7 @@ import { atTier, projectDir, parityFor, interactFor, audioFor, suspendFor, safeAimport { frameDistance, frameCellMax, readPNG } from './frameCompare.mjs';import { retryOnDeadGpu, deadGpuVerdict } from './lib/deadGpu.mjs';import { runTool } from './lib/runTool.mjs';+import { requireCurrentEngine } from './lib/engineBuild.mjs';const argv = process.argv.slice(2);const flag = (n, d) => {@@ -45,6 +46,7 @@ const LAUNCHER = (target) => (target === 'wechat' ? 'launch-minigame.mjs' : 'lauconst COMPARABLE = OWNED;const DESKTOP = path.join(ROOT, 'desktop');+requireCurrentEngine(ROOT, path.join(DESKTOP, 'public', 'wasm'));if (SHOTS) mkdirSync(SHOTS, { recursive: true });const only = ONLY ? new Set(ONLY.split(',').map((s) => s.trim())) : null;diff --git a/tools/verify-render.mjs b/tools/verify-render.mjsindex 5d8b09b7e..ccd105bd8 100644--- a/tools/verify-render.mjs+++ b/tools/verify-render.mjs@@ -17,6 +17,7 @@ import { fileURLToPath } from 'node:url';import { TIERS, SCENES, scenesAtTier } from './renderScenes.mjs';import { retryOnDeadGpu, deadGpuVerdict } from './lib/deadGpu.mjs';import { runTool } from './lib/runTool.mjs';+import { requireCurrentEngine } from './lib/engineBuild.mjs';const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');const DESKTOP = path.join(ROOT, 'desktop');@@ -73,6 +74,7 @@ const scenes = selected.map((s) => ({}: s.env,}));+requireCurrentEngine(ROOT, path.join(DESKTOP, 'public', 'wasm'));console.log(`render ${only ? `${scenes.length} named scene(s)` : `${TIER}: ${scenes.length} scene(s)`} on ${BACKEND}`);if (!NO_BUILD) {