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(game): the flagship, and the ledger that forbids routing around the engine
esengine422a49a2cd48
diff --git a/desktop/electron-builder.yml b/desktop/electron-builder.ymlindex 7aa253f16..41180dc1c 100644--- a/desktop/electron-builder.yml+++ b/desktop/electron-builder.yml@@ -87,6 +87,10 @@ extraResources:- "!**/node_modules/**"- "!**/dist/**"- "!**/dist-*/**"+ # The flagship is a full game, not a sample: its art and audio would ride+ # into every editor download. It lives in the repo for the certification+ # chain and is distributed as a project, not as bundled content.+ - "!celestial-heights/**"win:target: nsis# Assisted (non-oneClick) installer: electron-builder derives the oneClickdiff --git a/examples/README.md b/examples/README.mdindex 4ef3389dd..c011e99eb 100644--- a/examples/README.md+++ b/examples/README.md@@ -53,6 +53,7 @@ for your own game.| **platformer** | Game | A tiny platformer — run, jump and collect coins. || **video-puzzle** | Game | A tile-swap puzzle whose tiles are live regions of ONE playing video — texture-handle sharing + per-piece `uvOffset`/`uvScale`. || **space-shooter** | Game | A vertical shmup with prefabs, a HUD and a difficulty ramp. |+| **celestial-heights** | Game | The flagship action-RPG vertical slice — the project the release argues from. Not bundled with the editor (size); see `docs/REARCH_CELESTIAL_HEIGHTS.md`. |## Art & assetsdiff --git a/examples/celestial-heights/THIRD_PARTY_ASSETS.md b/examples/celestial-heights/THIRD_PARTY_ASSETS.mdnew file mode 100644index 000000000..b7d4e8c15--- /dev/null+++ b/examples/celestial-heights/THIRD_PARTY_ASSETS.md@@ -0,0 +1,25 @@+# Third-party assets++Celestial Heights ships publicly, in source and in packaged builds, on every+platform Estella targets. So every byte of art and audio in this project must+carry a licence that permits **public redistribution, commercial use, and+modification**, and must be recorded here before it is committed.++One row per asset or asset pack:++| Asset | Where it is used | Source | Licence | Attribution required |+|---|---|---|---|---|+| _(none yet — the project runs on placeholder primitives)_ | | | | |++## Rules++- **No unlicensed placeholder survives a phase.** Programmer art is fine while a+ phase is in flight; it is shaped to the final asset (same dimensions, same+ slicing, same Spine animation names) so the swap is mechanical.+- **Nothing from `third_party/spine-runtimes-4.3/`.** Those example skeletons+ (spineboy, celestial-circus, …) are licensed for evaluating the Spine runtimes+ only. They may not be redistributed with a game. Not one file.+- **Attribution-required assets** get their credit line into the game's own+ credits screen, not only into this table.+- **Keep the source.** Record where a pack came from, not just its name — a+ licence you cannot produce later is a licence you do not have.diff --git a/examples/celestial-heights/assets/scenes/main.esscene b/examples/celestial-heights/assets/scenes/main.esscenenew file mode 100644index 000000000..2726be4f5--- /dev/null+++ b/examples/celestial-heights/assets/scenes/main.esscene@@ -0,0 +1,55 @@+{+ "version": "1.0",+ "name": "Main",+ "folders": ["Environment", "Actors"],+ "entities": [+ {+ "id": 0,+ "name": "Camera",+ "parent": null,+ "children": [],+ "components": [+ { "type": "Transform", "data": { "position": { "x": 0, "y": 0, "z": 10 } } },+ { "type": "Camera", "data": { "projectionType": 1, "orthoSize": 540, "isActive": true, "priority": 0 } }+ ],+ "visible": true+ },+ {+ "id": 1,+ "name": "Ground",+ "parent": null,+ "children": [],+ "folder": "Environment",+ "components": [+ { "type": "Transform", "data": { "position": { "x": 0, "y": 0, "z": 0 } } },+ { "type": "Sprite", "data": { "size": { "x": 1920, "y": 1080 }, "color": { "r": 0.106, "g": 0.09, "b": 0.169, "a": 1 }, "layer": -20 } }+ ],+ "visible": true+ },+ {+ "id": 2,+ "name": "CobblestonePath",+ "parent": null,+ "children": [],+ "folder": "Environment",+ "components": [+ { "type": "Transform", "data": { "position": { "x": 0, "y": -120, "z": 0 } } },+ { "type": "Sprite", "data": { "size": { "x": 1400, "y": 260 }, "color": { "r": 0.192, "g": 0.169, "b": 0.263, "a": 1 }, "layer": -10 } }+ ],+ "visible": true+ },+ {+ "id": 3,+ "name": "Lyra_Player",+ "parent": null,+ "children": [],+ "folder": "Actors",+ "components": [+ { "type": "Transform", "data": { "position": { "x": 0, "y": -90, "z": 0 } } },+ { "type": "Sprite", "data": { "size": { "x": 84, "y": 150 }, "color": { "r": 0.855, "g": 0.788, "b": 0.976, "a": 1 }, "layer": 10 } },+ { "type": "Player", "data": {} }+ ],+ "visible": true+ }+ ]+}diff --git a/examples/celestial-heights/assets/scenes/main.esscene.meta b/examples/celestial-heights/assets/scenes/main.esscene.metanew file mode 100644index 000000000..317a20825--- /dev/null+++ b/examples/celestial-heights/assets/scenes/main.esscene.meta@@ -0,0 +1,8 @@+{+ "uuid": "e4af7ed5-c2a1-4471-bb5e-0cd4317b7ed9",+ "version": "2.0",+ "type": "scene",+ "importer": {+ "autoMigrate": true+ }+}diff --git a/examples/celestial-heights/engine-gaps.mjs b/examples/celestial-heights/engine-gaps.mjsnew file mode 100644index 000000000..2afd07e36--- /dev/null+++ b/examples/celestial-heights/engine-gaps.mjs@@ -0,0 +1,34 @@+// SPDX-License-Identifier: Apache-2.0+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team+/**+ * @file engine-gaps.mjs — every place this game had to work around the engine.+ *+ * The point of Celestial Heights is to be a real game built on Estella, so that+ * where Estella is painful, the pain shows up as a fix to Estella rather than a+ * clever file in a game. A rule that says only that decays: the workaround is+ * written under a deadline and nobody ever comes back.+ *+ * So the rule is a ledger instead. Working around the engine is ALLOWED, and+ * costs one entry here plus an `// ENGINE-GAP(<id>): …` marker at the site. What+ * it does not cost is silence — check-engine-gaps.mjs holds the two together in+ * both directions, so a workaround cannot be added without saying so, and an+ * entry cannot outlive the code it excuses.+ *+ * `fix` is the load-bearing field: it names what the ENGINE should do instead.+ * An entry that cannot name one is not a gap in the engine, it is a decision+ * about the game, and it does not belong here.+ *+ * The release gate reads this file with --empty. A non-empty ledger does not+ * ship: every entry is either fixed in the engine or argued away before 0.49.+ *+ * Entry shape:+ * id kebab-case, matches the marker at the site+ * hurts what the game was trying to do, and where it hurt+ * workaround what the game does instead, for now+ * fix what the engine should do so the workaround can be deleted+ * issue tracker link, when there is one+ * allows import specifiers this gap permits outside the `esengine` surface+ */++/** @type {Array<{id: string, hurts: string, workaround: string, fix: string, issue?: string, allows?: string[]}>} */+export const GAPS = [];diff --git a/examples/celestial-heights/project.esproject b/examples/celestial-heights/project.esprojectnew file mode 100644index 000000000..8981877b0--- /dev/null+++ b/examples/celestial-heights/project.esproject@@ -0,0 +1,13 @@+{+ "formatVersion": "1",+ "name": "Celestial Heights",+ "description": "An action-RPG vertical slice — the flagship project the release argues from.",+ "tag": "Game",+ "version": "0.1.0",+ "defaultScene": "assets/scenes/main.esscene",+ "designResolution": {+ "width": 1920,+ "height": 1080+ },+ "spineVersion": "none"+}diff --git a/examples/celestial-heights/src/components.ts b/examples/celestial-heights/src/components.tsnew file mode 100644index 000000000..05f3316fe--- /dev/null+++ b/examples/celestial-heights/src/components.ts@@ -0,0 +1,10 @@+import { defineComponent } from 'esengine';++// The project's declaration entry: user component/tag definitions only, no+// systems. The editor extracts schemas from here so the inspector knows their+// fields without running project code.++/** Lyra. `speed` is world units per second on the ground plane. */+export const Player = defineComponent('Player', {+ speed: 380,+});diff --git a/examples/celestial-heights/src/config.ts b/examples/celestial-heights/src/config.tsnew file mode 100644index 000000000..4f45a407d--- /dev/null+++ b/examples/celestial-heights/src/config.ts@@ -0,0 +1,10 @@+/** Half-extents of the walkable ground, in world units. */+export const WALK_HALF_W = 860;+export const WALK_HALF_H = 420;++/**+ * A 3/4 top-down view foreshortens depth, so a step "north" covers less ground+ * than a step "east". Vertical input is scaled by this to keep the two reading+ * as the same speed.+ */+export const DEPTH_FORESHORTEN = 0.6;diff --git a/examples/celestial-heights/src/main.ts b/examples/celestial-heights/src/main.tsnew file mode 100644index 000000000..7b4fddcfe--- /dev/null+++ b/examples/celestial-heights/src/main.ts@@ -0,0 +1,6 @@+import { addSystemToSchedule, Schedule } from 'esengine';++import './components';+import { playerMoveSystem } from './systems/player';++addSystemToSchedule(Schedule.Update, playerMoveSystem);diff --git a/examples/celestial-heights/src/systems/player.ts b/examples/celestial-heights/src/systems/player.tsnew file mode 100644index 000000000..8cccd6325--- /dev/null+++ b/examples/celestial-heights/src/systems/player.ts@@ -0,0 +1,27 @@+import { defineSystem, Query, Mut, Res, Time, Input, Transform } from 'esengine';+import { Player } from '../components';+import { WALK_HALF_W, WALK_HALF_H, DEPTH_FORESHORTEN } from '../config';++const clamp = (v: number, lo: number, hi: number) => (v < lo ? lo : v > hi ? hi : v);++export const playerMoveSystem = defineSystem(+ [Query(Mut(Transform), Player), Res(Input), Res(Time)],+ (query, input, time) => {+ for (const [, transform, player] of query) {+ let dx = 0;+ let dy = 0;+ if (input.isKeyDown('KeyW') || input.isKeyDown('ArrowUp')) dy += 1;+ if (input.isKeyDown('KeyS') || input.isKeyDown('ArrowDown')) dy -= 1;+ if (input.isKeyDown('KeyA') || input.isKeyDown('ArrowLeft')) dx -= 1;+ if (input.isKeyDown('KeyD') || input.isKeyDown('ArrowRight')) dx += 1;+ if (dx === 0 && dy === 0) continue;++ const len = Math.sqrt(dx * dx + dy * dy);+ const step = (player.speed * time.delta) / len;+ const p = transform.position;+ p.x = clamp(p.x + dx * step, -WALK_HALF_W, WALK_HALF_W);+ p.y = clamp(p.y + dy * step * DEPTH_FORESHORTEN, -WALK_HALF_H, WALK_HALF_H);+ }+ },+ { name: 'PlayerMoveSystem' },+);diff --git a/examples/celestial-heights/tsconfig.json b/examples/celestial-heights/tsconfig.jsonnew file mode 100644index 000000000..1f11ff310--- /dev/null+++ b/examples/celestial-heights/tsconfig.json@@ -0,0 +1,20 @@+{+ "compilerOptions": {+ "target": "ES2020",+ "module": "ESNext",+ "moduleResolution": "bundler",+ "strict": true,+ "esModuleInterop": true,+ "skipLibCheck": true,+ "forceConsistentCasingInFileNames": true,+ "declaration": false,+ "outDir": "./dist",+ "rootDir": ".",+ "paths": {+ "esengine": ["./.esengine/sdk/index.d.ts"],+ "esengine/wasm": ["./.esengine/sdk/wasm.d.ts"]+ }+ },+ "include": ["src/**/*"],+ "exclude": ["node_modules"]+}diff --git a/package.json b/package.jsonindex c44113b9a..5d25511c3 100644--- a/package.json+++ b/package.json@@ -17,7 +17,7 @@"emsdk:setup": "node build-tools/toolchain/setup-emsdk.js","asset-meta": "node tools/asset-meta.js","migrate-asset-refs": "node tools/migrate-asset-refs.js",- "verify": "pnpm --filter ./sdk exec tsc --noEmit && pnpm --filter @estella/editor exec tsc --noEmit && node tools/api-surface.mjs --check && node tools/check-cycles.mjs && node tools/check-layers.mjs && node tools/check-project-settings.mjs && node tools/check-workflows.mjs && node tools/check-tool-calls.mjs && node tools/check-inspector-door.mjs && node tools/check-dirty-source.mjs && node tools/check-path-sandbox.mjs && node tools/check-key-codes.mjs && node tools/check-comment-style.mjs && node tools/check-cpp-tests.mjs && node tools/check-release-metadata.mjs && node tools/check-golden.mjs && node tools/check-minigame-host.mjs && node tools/check-release-gate.mjs && node tools/component-reference.mjs --check",+ "verify": "pnpm --filter ./sdk exec tsc --noEmit && pnpm --filter @estella/editor exec tsc --noEmit && node tools/api-surface.mjs --check && node tools/check-cycles.mjs && node tools/check-layers.mjs && node tools/check-project-settings.mjs && node tools/check-workflows.mjs && node tools/check-tool-calls.mjs && node tools/check-inspector-door.mjs && node tools/check-dirty-source.mjs && node tools/check-path-sandbox.mjs && node tools/check-key-codes.mjs && node tools/check-comment-style.mjs && node tools/check-cpp-tests.mjs && node tools/check-release-metadata.mjs && node tools/check-golden.mjs && node tools/check-engine-gaps.mjs && node tools/check-minigame-host.mjs && node tools/check-release-gate.mjs && node tools/component-reference.mjs --check","perf": "node tools/perf-guard.mjs --check","scale": "node tools/perf-budget.mjs","stress-project": "node tools/stress-project.mjs",diff --git a/tools/check-engine-gaps.mjs b/tools/check-engine-gaps.mjsnew file mode 100644index 000000000..e33979133--- /dev/null+++ b/tools/check-engine-gaps.mjs@@ -0,0 +1,150 @@+// SPDX-License-Identifier: Apache-2.0+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team+/**+ * @file check-engine-gaps.mjs — the flagship game uses the engine as a user does.+ *+ * Celestial Heights only proves something about Estella if it was built the way+ * a user could build it. Two things quietly break that: reaching past the public+ * SDK surface, and solving in the game what the engine should have solved. Both+ * leave the release with a game that works and an engine that does not.+ *+ * So this gate asserts the game is an ordinary consumer — imports only what a+ * user can import — and that every departure is written down in the project's+ * ledger, in both directions: no undeclared marker, no unmarked entry. The+ * ledger's own contract (and why `fix` is required) is in engine-gaps.mjs.+ *+ * With --empty it additionally requires the ledger to be empty, which is the+ * release criterion: the game ships with nothing left that Estella should have+ * done itself.+ */+import { readFileSync, readdirSync, existsSync } from 'node:fs';+import path from 'node:path';+import { fileURLToPath, pathToFileURL } from 'node:url';++const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');+const PROJECT = path.join(ROOT, 'examples', 'celestial-heights');+const SRC = path.join(PROJECT, 'src');+const LEDGER = path.join(PROJECT, 'engine-gaps.mjs');++const problems = [];+const fail = (msg) => problems.push(msg);++const rel = (p) => path.relative(ROOT, p);++/** Every `.ts` under the project's src, so the walk cannot miss a subdirectory. */+function sources(dir) {+ if (!existsSync(dir)) return [];+ return readdirSync(dir, { withFileTypes: true }).flatMap((e) => {+ const full = path.join(dir, e.name);+ if (e.isDirectory()) return sources(full);+ return e.isFile() && e.name.endsWith('.ts') ? [full] : [];+ });+}++/**+ * The subpaths a user can actually import, from the SDK's own export map — a+ * second list here would be a list that drifts.+ */+function publicSpecifiers() {+ const pkg = JSON.parse(readFileSync(path.join(ROOT, 'sdk', 'package.json'), 'utf8'));+ return new Set(+ Object.keys(pkg.exports ?? { '.': {} })+ .map((k) => (k === '.' ? 'esengine' : `esengine/${k.replace(/^\.\//, '')}`)),+ );+}++const IMPORT_RE = /(?:from|import)\s*\(?\s*['"]([^'"]+)['"]/g;+const MARKER_RE = /\/\/\s*ENGINE-GAP\(([^)]*)\)\s*:(.*)/g;++if (!existsSync(LEDGER)) {+ console.error(`check-engine-gaps: no ledger at ${rel(LEDGER)} — the project must carry one, even empty.`);+ process.exit(1);+}++const { GAPS } = await import(pathToFileURL(LEDGER).href);+if (!Array.isArray(GAPS)) {+ console.error(`check-engine-gaps: ${rel(LEDGER)} does not export a GAPS array.`);+ process.exit(1);+}++// 1. The ledger holds up on its own terms.+const declared = new Map();+for (const g of GAPS) {+ const id = g?.id;+ if (typeof id !== 'string' || !/^[a-z0-9]+(-[a-z0-9]+)*$/.test(id)) {+ fail(`an entry has id ${JSON.stringify(id)} — expected kebab-case, and it must match the marker at the site`);+ continue;+ }+ if (declared.has(id)) fail(`"${id}" is listed twice`);+ declared.set(id, g);+ for (const field of ['hurts', 'workaround', 'fix']) {+ if (typeof g[field] !== 'string' || !g[field].trim()) {+ fail(`"${id}" has no ${field} — ${field === 'fix'+ ? 'an entry that cannot name what the engine should do instead is a game decision, not an engine gap'+ : `say ${field === 'hurts' ? 'what hurt' : 'what the game does instead'}`}`);+ }+ }+ if (g.allows !== undefined && !(Array.isArray(g.allows) && g.allows.every((a) => typeof a === 'string' && a))) {+ fail(`"${id}" has an allows that is not a list of import specifiers`);+ }+}++// 2. Every marker in the game names an entry, and 3. every entry is still used.+const marked = new Map();+const files = sources(SRC);+for (const file of files) {+ const text = readFileSync(file, 'utf8');+ for (const [, id, note] of text.matchAll(MARKER_RE)) {+ const where = `${rel(file)}`;+ if (!id.trim()) {+ fail(`${where}: an ENGINE-GAP marker names no id`);+ continue;+ }+ if (!note.trim()) fail(`${where}: ENGINE-GAP(${id}) says nothing — one sentence on what it is doing here`);+ if (!declared.has(id)) {+ fail(`${where}: ENGINE-GAP(${id}) is not in ${rel(LEDGER)} — a workaround is allowed, going undeclared is not`);+ }+ marked.set(id, (marked.get(id) ?? 0) + 1);+ }+}+for (const id of declared.keys()) {+ if (!marked.has(id)) {+ fail(`"${id}" is in the ledger but nothing in the game is marked with it — the workaround is gone, so drop the entry`);+ }+}++// 4. The game imports what a user can import, and nothing else.+const allowed = publicSpecifiers();+for (const g of GAPS) for (const a of g.allows ?? []) allowed.add(a);+for (const file of files) {+ const text = readFileSync(file, 'utf8');+ for (const [, spec] of text.matchAll(IMPORT_RE)) {+ if (spec.startsWith('.') || spec.startsWith('/')) continue;+ if (allowed.has(spec)) continue;+ const reachingIn = spec === 'esengine' || spec.startsWith('esengine/');+ fail(`${rel(file)}: imports "${spec}" — ${reachingIn+ ? 'not a subpath the SDK exports, so no user could import it'+ : 'outside the engine surface; if the game genuinely needs it, declare a gap and list it in that entry\'s allows'}`);+ }+}++if (problems.length) {+ console.error('check-engine-gaps: the flagship is not being built the way a user would.\n');+ for (const p of problems) console.error(` ${p}`);+ process.exit(1);+}++if (process.argv.includes('--empty') && GAPS.length > 0) {+ console.error(+ `check-engine-gaps: ${GAPS.length} engine gap(s) still open — the release does not ship a game that had to route around it.\n`,+ );+ for (const g of GAPS) console.error(` ${g.id}: ${g.hurts}\n fix: ${g.fix}`);+ process.exit(1);+}++const sites = [...marked.values()].reduce((a, b) => a + b, 0);+console.log(+ `check-engine-gaps: ${files.length} game source file(s) import only the public surface`+ + `; ${GAPS.length} declared gap(s) across ${sites} site(s) — ok`,+);+for (const g of GAPS) console.log(` ${g.id}: ${g.fix}`);diff --git a/tools/goldenProjects.mjs b/tools/goldenProjects.mjsindex af307cf3a..222f4e5ab 100644--- a/tools/goldenProjects.mjs+++ b/tools/goldenProjects.mjs@@ -58,6 +58,11 @@ export const CAPABILITIES = ['hot-update', 'rollback','networking','persistence', 'save-versioning',+ // What a game needs and no sample carried end to end. Each holds a gap below+ // until the phase covering it lands, so the gate prints how much of a game the+ // corpus still cannot certify. See docs/REARCH_CELESTIAL_HEIGHTS.md.+ 'navigation', 'behavior-tree', 'scene-transition',+ 'settings', 'controller', 'achievements', 'ui-inventory',];/**@@ -66,11 +71,20 @@ export const CAPABILITIES = [* coverage — the same bargain check-project-settings strikes.*/export const KNOWN_GAPS = {- localization: 'no example swaps locale at runtime; rich-text covers glyphs, not translation',- touch: 'no example drives synthetic touch; input-actions is keyboard + gamepad',- 'safe-area': 'safe-area insets are exercised by the UI mode viewport, not by a project',- 'pause-resume': 'lifecycle suspend/resume is covered by native hosts, not by a golden project',+ localization: 'no example swaps locale at runtime; rich-text covers glyphs, not translation — Celestial Heights P3',+ touch: 'no example drives synthetic touch; input-actions is keyboard + gamepad — Celestial Heights P5',+ 'safe-area': 'safe-area insets are exercised by the UI mode viewport, not by a project — Celestial Heights P5',+ 'pause-resume': 'lifecycle suspend/resume is covered by native hosts, not by a golden project — Celestial Heights P3',rollback: 'hot-update-demo swaps forward; nothing exercises a failed manifest rolling back',+ // Present in the engine and shown by non-golden samples, but never carried+ // through the chain by a project the release argues from.+ navigation: 'enemy-ai navigates, but it is outside the corpus — Celestial Heights P2',+ 'behavior-tree': 'enemy-ai drives an FSM; nothing golden runs a behaviour tree — Celestial Heights P2',+ 'scene-transition': 'scene-flow switches scenes outside the corpus; no golden project streams between areas — Celestial Heights P2',+ settings: 'no project persists graphics/audio/language/rebinds and reads them back — Celestial Heights P3',+ controller: 'input-actions binds a gamepad, but no golden run drives one — Celestial Heights P5',+ achievements: 'the achievements service has no project that unlocks one in play — Celestial Heights P4',+ 'ui-inventory': 'ui-list virtualizes rows; no project builds an inventory a player operates — Celestial Heights P3',// Measured: hello-world exports a 2.82MB single file, video-puzzle 3.22MB — so// the floor is the runtime, not the game, and no project reaches the 2MB cap.'startup-size': 'the playable runtime floor (~2.8MB) exceeds the 2MB default profile cap; see REARCH_EXPORT',diff --git a/tools/releaseGate.mjs b/tools/releaseGate.mjsindex e762c1266..76ca11a90 100644--- a/tools/releaseGate.mjs+++ b/tools/releaseGate.mjs@@ -1,9 +1,9 @@// SPDX-License-Identifier: Apache-2.0// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team/**- * @file releaseGate.mjs — what 0.48 has to be able to say, and what says it.+ * @file releaseGate.mjs — what 0.49 has to be able to say, and what says it.*- * "Do not open 0.49 until these hold" is only a rule if the list is somewhere a+ * "Do not open 0.50 until these hold" is only a rule if the list is somewhere a* machine reads. Written down anywhere else it decays the usual way: a criterion* loses the check that answered it and nobody notices, because nothing was ever* holding the two together.@@ -15,7 +15,7 @@* This says the criteria are OWNED. Whether they PASS is what running them says.*/-export const RELEASE = '0.48';+export const RELEASE = '0.49';/*** `answeredBy` is a shell command run from the repo root; `needs` are the files@@ -97,6 +97,20 @@ export const CRITERIA = [answeredBy: 'pnpm run verify',needs: ['tools/check-golden.mjs', 'tools/check-minigame-host.mjs'],},+ {+ id: 'no-engine-gaps-at-ship',+ says: 'the flagship game had to route around the engine nowhere that is still open',+ answeredBy: 'node tools/check-engine-gaps.mjs --empty',+ needs: ['tools/check-engine-gaps.mjs', 'examples/celestial-heights/engine-gaps.mjs'],+ },+ {+ id: 'site-shows-the-real-game',+ says: 'the README and landing hero are frames of the game that ships, not a mock-up',+ // A machine can compare two images; deciding that one of them is honest+ // marketing is not a thing to compute. Whether the frame is sound is the+ // flagship's parity run; whether it is the frame on the site is a person's.+ manual: 'release captain, over docs/assets + docs/landing: the hero comes from a build of examples/celestial-heights',+ },{id: 'diagnostics-from-a-release-build',says: 'a shipped build can export a diagnostic bundle',