Skip to content

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.

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.yml
index 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 oneClick
diff --git a/examples/README.md b/examples/README.md
index 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 & assets
diff --git a/examples/celestial-heights/THIRD_PARTY_ASSETS.md b/examples/celestial-heights/THIRD_PARTY_ASSETS.md
new file mode 100644
index 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.esscene
new file mode 100644
index 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.meta
new file mode 100644
index 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.mjs
new file mode 100644
index 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.esproject
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.json
new file mode 100644
index 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.json
index 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.mjs
new file mode 100644
index 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.mjs
index 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.mjs
index 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',