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
feat(aot): a compiled system moves the world the interpreter moves, exactly
yhh145f88a940be
diff --git a/.github/workflows/build.yml b/.github/workflows/build.ymlindex 5a83c77e2..14db0746e 100644--- a/.github/workflows/build.yml+++ b/.github/workflows/build.yml@@ -479,6 +479,14 @@ jobs:ELECTRON_DISABLE_SANDBOX: '1'run: xvfb-run -a node tools/verify-aot-parity.mjs+ # And the exact half: one fixture packaged both ways, stepped by a fixed dt+ # rather than by elapsed time, and the two displacements compared. This is+ # the check a twin reading the wrong offset cannot survive.+ - name: Check a cooked build's compiled systems against the interpreter+ env:+ ELECTRON_DISABLE_SANDBOX: '1'+ run: xvfb-run -a pnpm run verify:cooked+# Projects as they were RELEASED, opened by the editor of today. The golden# corpus is re-saved by whoever last touched it, so it can only say that this# version opens its own files; a person's project is not re-saved by anybody.diff --git a/.gitignore b/.gitignoreindex 1de2c9361..4e8ea2103 100644--- a/.gitignore+++ b/.gitignore@@ -61,6 +61,7 @@ compile_commands.json# Cooked-build render-verify artifacts (regenerated by verify:render:cooked)pipeline/.cooked-verify/+pipeline/.cooked-verify-interp/# Projects the AOT end-to-end gate writes and compiles.pipeline/.aot-e2e/pipeline/.aot-e2e-probe/diff --git a/pipeline/src/runtime/gameHost.ts b/pipeline/src/runtime/gameHost.tsindex 94607f6cb..b9574a1e9 100644--- a/pipeline/src/runtime/gameHost.ts+++ b/pipeline/src/runtime/gameHost.ts@@ -169,6 +169,16 @@ async function boot(): Promise<void> {// "the thing I was walking to is gone", which is a lie with a cost.return { scene: scenes?.getActive() ?? null, transitioning: scenes?.isTransitioning() ?? false, at };},+ /**+ * Advance the world by `frames` steps of exactly `dt`, wall clock ignored.+ *+ * What a driver measures between two probes is otherwise a function of+ * when the runner got scheduled — and two launches of ONE package disagree+ * by more than a compiled system reading the wrong field does.+ */+ async step(frames = 1, dt = 1 / 60): Promise<void> {+ await app.stepFrames(frames, dt);+ },/*** A way from one named entity to another, over the same navigation grid* the game's own enemies walk. A driver that steers straight at its goaldiff --git a/pipeline/tests/cooked-verify-fixture.test.ts b/pipeline/tests/cooked-verify-fixture.test.tsindex 67d1dbefc..876076879 100644--- a/pipeline/tests/cooked-verify-fixture.test.ts+++ b/pipeline/tests/cooked-verify-fixture.test.ts@@ -14,6 +14,9 @@ import { exportGame } from '../src/export/exportGame';const HERE = path.dirname(fileURLToPath(import.meta.url));const OUT = path.resolve(HERE, '..', '.cooked-verify');+/** The same build with the compiled systems left out, so the launcher can ask+ * whether compiling changed what the game computes. */+const OUT_INTERP = path.resolve(HERE, '..', '.cooked-verify-interp');const SRC = path.resolve(HERE, '..', '.cooked-src');const TEX = 'aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa';const SCN = 'bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb';@@ -130,5 +133,21 @@ describe.skipIf(!process.env.ESTELLA_COOK_FIXTURE)('cooked-verify fixture', () =contentAddressed: true,});expect(res.ok, res.errors.join('; ')).toBe(true);- }, 120_000);++ // The interpreted twin: one source tree, two packages, and the only+ // difference is whether CookedDrift runs as machine code.+ const interp = await exportGame({+ root: SRC,+ entryScene: 'scenes/main.esscene',+ gameHostEntry: path.resolve(HERE, '..', '..', 'pipeline', 'src', 'runtime', 'gameHost.ts'),+ scriptsEntry: 'src/main.ts',+ sdkDistDir: path.resolve(HERE, '..', '..', 'sdk', 'dist'),+ wasmDir: path.resolve(HERE, '..', '..', 'build', 'wasm', 'web'),+ outDir: OUT_INTERP,+ title: 'Cooked Verify (interpreted)',+ contentAddressed: true,+ aotMode: 'dev',+ });+ expect(interp.ok, interp.errors.join('; ')).toBe(true);+ }, 180_000);});diff --git a/tools/launchers/headless-cooked-verify.mjs b/tools/launchers/headless-cooked-verify.mjsindex f899f82a7..deef39dd0 100644--- a/tools/launchers/headless-cooked-verify.mjs+++ b/tools/launchers/headless-cooked-verify.mjs@@ -16,7 +16,10 @@ import path from 'node:path';import { fileURLToPath } from 'node:url';import { onRendererConsole } from '../lib/rendererConsole.mjs';-const COOKED = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..', 'pipeline', '.cooked-verify');+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..');+const COOKED = path.join(ROOT, 'pipeline', '.cooked-verify');+/** The same fixture packaged without its compiled systems. */+const INTERP = path.join(ROOT, 'pipeline', '.cooked-verify-interp');const W = 256, H = 256;app.commandLine.appendSwitch('enable-unsafe-swiftshader');@@ -44,10 +47,60 @@ function serve(dir) {return new Promise((resolve) => server.listen(0, '127.0.0.1', () => resolve(server)));}+/** Wait for the boot hook, or give up. Boot is async: wasm, then the scene. */+async function waitForHook(exec) {+ for (let i = 0; i < 150; i++) {+ if (await exec('!!window.__estellaCooked').catch(() => false)) return true;+ await sleep(100);+ }+ return false;+}++/**+ * How far the compiled entity travels over a FIXED number of FIXED steps.+ *+ * Not over half a second of wall clock: the loop is browser-scheduled, so two+ * runs of one package disagree by more than a wrong field offset does, and a+ * comparison built on it measures the runner.+ */+async function drift(exec, diag) {+ const before = await exec("window.__estellaCooked.probe(['Drifter']).at.Drifter");+ await exec('window.__estellaCooked.step(60, 1/60)');+ const after = await exec("window.__estellaCooked.probe(['Drifter']).at.Drifter");+ if (!before || !after) { diag.push(`no Drifter in the world (before=${!!before} after=${!!after})`); return null; }+ return { x: after.x - before.x, y: after.y - before.y };+}++/** The same measurement, on a package this run has not otherwise opened. */+async function driftOf(dir, diag) {+ let server;+ let win;+ try {+ server = await serve(dir);+ win = new BrowserWindow({ show: false, width: W, height: H, webPreferences: { offscreen: false } });+ await win.loadURL(`http://127.0.0.1:${server.address().port}/index.html?headless=1`);+ const exec = (code) => win.webContents.executeJavaScript(code, true);+ if (!await waitForHook(exec)) { diag.push(`${path.basename(dir)}: hook never appeared`); return null; }+ // The hook exists before the scene does; the entity this measures arrives+ // with the scene, so probing on the hook alone finds an empty world.+ await sleep(1000);+ return await drift(exec, diag);+ } catch (e) {+ diag.push(`${path.basename(dir)}: ${e?.message ?? e}`);+ return null;+ } finally {+ try { win?.destroy(); } catch { /* already gone */ }+ try { server?.close(); } catch { /* ignore */ }+ }+}+app.whenReady().then(async () => {let server;let failed = true;const diag = [];+ // The twin's own channel: the main window's console filter fills six slots+ // with WebGL noise, and the report then says nothing about why it returned null.+ const twinDiag = [];try {server = await serve(COOKED);const url = `http://127.0.0.1:${server.address().port}/index.html?headless=1`;@@ -59,9 +112,7 @@ app.whenReady().then(async () => {const exec = (code) => win.webContents.executeJavaScript(code, true);// Boot is async (wasm + scene load); poll for the capture hook, then let it render.- let ready = false;- for (let i = 0; i < 150 && !ready; i++) { ready = await exec('!!window.__estellaCooked').catch(() => false); if (!ready) await sleep(100); }- if (!ready) throw new Error('gameHost capture hook never appeared (boot failed?)');+ if (!await waitForHook(exec)) throw new Error('gameHost capture hook never appeared (boot failed?)');await sleep(1000);const cap = await exec(`(() => {@@ -75,12 +126,18 @@ app.whenReady().then(async () => {// only a compiled system touches is moving. Nothing draws it, so this claim// and the pixel ones stay independent.const compiledSystems = await exec('window.__estellaCooked.compiledSystems()');- const first = await exec("window.__estellaCooked.probe(['Drifter']).at.Drifter");- await sleep(500);- const second = await exec("window.__estellaCooked.probe(['Drifter']).at.Drifter");- // 100 units a second, so half a second is about 50. Twenty is clear of a- // stutter and nowhere near what a still entity would report.- const aotOk = compiledSystems >= 1 && !!first && !!second && second.x - first.x > 20;+ const moved = await drift(exec, diag);+ // What the interpreted twin computes over the SAME steps. Wall clock is out+ // of it, so this compares arithmetic and not the runner's scheduler: a twin+ // reading one field from the wrong offset lands somewhere else here.+ const twin = await driftOf(INTERP, twinDiag);+ // Relative, at the width the value is STORED in: position is f32, so the+ // same arithmetic rounds differently from the two runs' different starting+ // magnitudes. A wrong field is off by the whole displacement, not by an ulp.+ const same = (a, b) => Math.abs(a - b) <= 1e-5 * Math.max(1, Math.abs(a));+ const aotOk = compiledSystems >= 1 && moved !== null && twin !== null+ && same(moved.x, twin.x) && same(moved.y, twin.y)+ && Math.abs(moved.x) > 1;// Left quad = the KTX2 texture (green); right quad = the PATH-referenced// material chain (its shader paints u_tint red) — proving the cooked@@ -94,8 +151,8 @@ app.whenReady().then(async () => {console.log(`\n[verify:render:cooked] ${ok ? 'PASS' : 'FAIL'}`);console.log('DRIVE_RESULT ' + JSON.stringify({...cap, greenOk, redOk, cornerBlack,- aotOk, compiledSystems, drift: [first?.x ?? null, second?.x ?? null],- diag: diag.slice(0, 6),+ aotOk, compiledSystems, drift: { compiled: moved, interpreted: twin },+ diag: diag.slice(0, 6), twinDiag: twinDiag.slice(0, 4),}));failed = !ok;} catch (e) {diff --git a/tools/releaseGate.mjs b/tools/releaseGate.mjsindex a968e98a0..cc19db8f8 100644--- a/tools/releaseGate.mjs+++ b/tools/releaseGate.mjs@@ -89,6 +89,18 @@ export const CRITERIA = ['pipeline/tests/hotupdate-verify-fixture.test.ts',],},+ {+ id: 'compiled-systems-compute-what-the-interpreter-computes',+ says: 'a packaged compiled system moves the world exactly as the interpreted one does',+ // Over the same FIXED steps, not the same wall clock: two launches of one+ // package disagree by more than a wrong field offset does, so a comparison+ // built on elapsed time measures the runner and not the arithmetic.+ answeredBy: 'pnpm run verify:cooked',+ needs: [+ 'tools/launchers/headless-cooked-verify.mjs',+ 'pipeline/tests/cooked-verify-fixture.test.ts',+ ],+ },{id: 'compiled-game-packages-and-draws',says: 'a game whose systems were compiled packages, boots and draws the game it drew interpreted',