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
internal: the CI gates that had never been reached pass, and the tests they guard type-check
yhh9bd7384d8511
diff --git a/docs/astro/src/data/apiStability.generated.json b/docs/astro/src/data/apiStability.generated.jsonindex 06104b153..f264a9098 100644--- a/docs/astro/src/data/apiStability.generated.json+++ b/docs/astro/src/data/apiStability.generated.json@@ -3,10 +3,10 @@"counts": {"public": 115,"beta": 171,- "experimental": 2560,+ "experimental": 2642,"deprecated": 3},- "total": 2846,+ "total": 2928,"subsystems": [{"id": "mobile-controls",diff --git a/docs/astro/src/data/componentDocs.ts b/docs/astro/src/data/componentDocs.tsindex 9ac38ba72..b45c5e0f3 100644--- a/docs/astro/src/data/componentDocs.ts+++ b/docs/astro/src/data/componentDocs.ts@@ -81,6 +81,7 @@ export const COMPONENT_DOCS: Record<string, ComponentDoc> = {LightProbeVolume: { category: 'graphics', summary: 'A box of baked irradiance on a grid — what lights the things a lightmap cannot hold still, characters included.', doc: 'graphics/lighting', anchor: 'baked-light', anchorZh: '烘焙光照' },BakedLighting: { category: 'graphics', summary: 'How this scene is baked — atlas size, density, bounces — and a record of what the last bake read.', doc: 'graphics/lighting', anchor: 'baked-light', anchorZh: '烘焙光照' },DecalProjector: { category: 'graphics', summary: 'Prints this entity\'s material onto what its box covers — the surface is cut to the box and drawn again, so a decal is lit and shadowed as the surface under it.', doc: 'graphics/lighting', anchor: 'baked-light', anchorZh: '烘焙光照' },+ BlobShadow: { category: 'graphics', summary: 'A soft dark disc on the ground under an entity — no shadow map, no light, no extra pass — that fades and shrinks as the entity leaves the ground.', doc: 'graphics/lighting', anchor: 'blob-shadows-a-disc-instead-of-a-shadow-map', anchorZh: '假阴影用一个圆片代替阴影图' },StreamedWorld: { category: 'world', summary: 'Declares the scene a streamed world and how big the cook cuts its cells.', doc: 'world/streaming', anchor: 'declaring-a-streamed-world', anchorZh: '声明一个流送世界' },WorldPersistent: { category: 'world', summary: 'Keeps an entity\'s whole subtree out of the partition — it belongs to the persistent world.', doc: 'world/streaming', anchor: 'declaring-a-streamed-world', anchorZh: '声明一个流送世界' },WorldGen: { category: 'world', summary: 'A generated world: names the game\'s rules (biomes, recipes, layers), their version, the world and its seed; what the rules place is laid out round the streaming sources.', doc: 'world/generation', anchor: 'the-worldgen-component', anchorZh: 'worldgen-组件' },diff --git a/docs/astro/src/data/components.generated.json b/docs/astro/src/data/components.generated.jsonindex 48b477491..1789acd60 100644--- a/docs/astro/src/data/components.generated.json+++ b/docs/astro/src/data/components.generated.json@@ -325,6 +325,76 @@"color.a"]},+ {+ "name": "BlobShadow",+ "source": "ts",+ "fields": [+ {+ "key": "enabled",+ "type": "boolean",+ "default": "true"+ },+ {+ "key": "radius",+ "type": "number",+ "default": "50",+ "doc": "Radius of the disc on the ground, in world units.",+ "range": "≥ 0, step 1"+ },+ {+ "key": "opacity",+ "type": "number",+ "default": "0.5",+ "doc": "How dark the disc is at its centre.",+ "range": "0–1, step 0.01"+ },+ {+ "key": "softness",+ "type": "number",+ "default": "0.6",+ "doc": "How soft its edge is (0 hard, 1 fading from the centre).",+ "range": "0–1, step 0.01"+ },+ {+ "key": "groundY",+ "type": "number",+ "default": "0",+ "doc": "Height of the flat ground. A ground function set from code overrides it.",+ "range": "step 1"+ },+ {+ "key": "fadeHeight",+ "type": "number",+ "default": "200",+ "doc": "Height above the ground at which the shadow is gone (0 never fades it).",+ "range": "≥ 0, step 1"+ },+ {+ "key": "shrink",+ "type": "number",+ "default": "0.5",+ "doc": "How small the disc gets at that height (0 keeps its size).",+ "range": "0–1, step 0.01"+ },+ {+ "key": "lift",+ "type": "number",+ "default": "0.5",+ "doc": "How far above the ground the disc is drawn.",+ "range": "≥ 0, step 0.1",+ "advanced": true+ }+ ],+ "animatable": [+ "radius",+ "opacity",+ "softness",+ "groundY",+ "fadeHeight",+ "shrink",+ "lift"+ ]+ },{"name": "BoxCollider2D","source": "cpp",@@ -6045,6 +6115,16 @@"type": "number","default": "0"},+ {+ "key": "inputFilter",+ "type": "enum",+ "default": "None",+ "doc": "Which characters the field accepts. Digits keeps only 0-9, whether typed or pasted, for a count or a price.",+ "values": [+ "None",+ "Digits"+ ]+ },{"key": "multiline","type": "boolean",@@ -6110,6 +6190,7 @@"backgroundColor.a","padding","maxLength",+ "inputFilter","cursorPos","textAlign","renderMode"diff --git a/sdk/src/platform/nativeModuleRegistry.ts b/sdk/src/platform/nativeModuleRegistry.tsindex 0bd2616b4..0bab84328 100644--- a/sdk/src/platform/nativeModuleRegistry.ts+++ b/sdk/src/platform/nativeModuleRegistry.ts@@ -37,6 +37,7 @@ import * as CharacterShadersModule from '../character';import * as ScriptGraphModule from '../logic';import * as AiModule from '../ai';import * as ReplicationModule from '../net/replication';+import * as SessionModule from '../net/session';import * as GameplayModule from '../gameplay';/** Must equal NATIVE_MODULE_REGISTRY in tools/nativeScriptModules.mjs, which is@@ -66,6 +67,7 @@ export const NATIVE_MODULE_NAMESPACES: Readonly<Record<string, unknown>> = {'esengine/logic': ScriptGraphModule,'esengine/ai': AiModule,'esengine/replication': ReplicationModule,+ 'esengine/session': SessionModule,'esengine/gameplay': GameplayModule,};diff --git a/sdk/tests/render-origin.test.ts b/sdk/tests/render-origin.test.tsindex 09e576d43..3b107b83e 100644--- a/sdk/tests/render-origin.test.ts+++ b/sdk/tests/render-origin.test.ts@@ -7,7 +7,7 @@ import { followRenderOrigin, pushRenderOrigin, renderOrigin, resetRenderOrigin,const pov = (over: Partial<CameraPOV>): CameraPOV => ({entity: -1, isActive: true, x: 0, y: 0, z: 0, rotation: 0, projection: ProjectionType.Perspective, orthoSize: 10, fov: 60, near: 0.1, far: 100000,- viewport: { x: 0, y: 0, z: 1, w: 1 }, clearFlags: ClearFlags.ColorAndDepth, priority: 0, pixelPerfect: false, ...over,+ viewport: { x: 0, y: 0, z: 1, w: 1 }, clearFlags: ClearFlags.ColorAndDepth, priority: 0, pixelPerfect: false, cullingMask: 0xFFFFFFFF, renderTarget: 0, ...over,});const clip = (m: Float32Array, p: [number, number, number]): [number, number, number, number] =>diff --git a/sdk/tests/text-input-plugin-lifecycle.test.ts b/sdk/tests/text-input-plugin-lifecycle.test.tsindex abd4bf025..3550cde74 100644--- a/sdk/tests/text-input-plugin-lifecycle.test.ts+++ b/sdk/tests/text-input-plugin-lifecycle.test.ts@@ -2,6 +2,7 @@// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Teamimport { afterEach, expect, it, vi } from 'vitest';import type { TextEditorEvent } from '../src/platform/types';+import type { TextInputFilter } from '../src/ui/text/text-input';import { bootMockApp } from './helpers/mockApp';import { log } from '../src/util/logger';@@ -310,7 +311,7 @@ it.each([])('a digits field removes what it does not accept and keeps the caret in place: $typed', async ({ typed, caret, filter, expected, expectedCaret }) => {const app = build(new TextInputPlugin());const field = app.world.spawn();- app.world.insert(field, TextInput, { value: '', inputFilter: filter });+ app.world.insert(field, TextInput, { value: '', inputFilter: filter as TextInputFilter });app.getResource(FocusManager).focus(field);await app.tick(1 / 60);vi.spyOn(surfaces[0], 'read').mockReturnValue({ value: typed, selectionStart: caret, selectionEnd: caret, backward: false });diff --git a/sdk/tests/worldgen-planet.test.ts b/sdk/tests/worldgen-planet.test.tsindex a5d055d4b..6d1358c4c 100644--- a/sdk/tests/worldgen-planet.test.ts+++ b/sdk/tests/worldgen-planet.test.ts@@ -67,7 +67,7 @@ describe('a planet\'s face as a plane', () => {});it('reads noise in three dimensions: a field has no seam where two faces meet', () => {- const noiseOf = (face: PlanetFace) => new Environment({ seed: 5, ground: () => ({ y: 0, up: 1 }), ...face.environment() });+ const noiseOf = (face: PlanetFace) => new Environment({ seed: 5, ...face.environment() });const a = faces[0]!, b = faces[5]!;// The same point of the planet, found on two faces at their shared edge.const half = faceHalf(radius);diff --git a/tests/renderer/test_batch_builder.cpp b/tests/renderer/test_batch_builder.cppindex e93a6d73e..f717b78f2 100644--- a/tests/renderer/test_batch_builder.cpp+++ b/tests/renderer/test_batch_builder.cpp@@ -1768,12 +1768,12 @@ std::vector<f32> instanceMarks(Harness& h, const DrawCommand& cmd) {TEST_CASE("finalize: the same mesh drawn three times is one instanced draw") {Harness h;BatchDrawKey key = meshKey(5);- // Depths chosen so the sort REORDERS them: written 1,2,3 and drawn nearest- // first (opaque is front-to-back), so the run is z=30,20,10 — marks 2,3,1,- // with no two records adjacent in the pool. Relocation is why this merges.- pushMeshInstance(h, key, 1.0f, 10.0f);- pushMeshInstance(h, key, 2.0f, 30.0f);- pushMeshInstance(h, key, 3.0f, 20.0f);+ // Written 1,2,3, drawn nearest first (z=1000,10,1): marks 2,3,1, no two records adjacent+ // in the pool, which is why relocation is needed. A mesh's run keeps only the top of the+ // depth's exponent, so these sit in three different steps of it (below 2, to 512, above).+ pushMeshInstance(h, key, 1.0f, 1.0f);+ pushMeshInstance(h, key, 2.0f, 1000.0f);+ pushMeshInstance(h, key, 3.0f, 10.0f);h.list.finalize(h.pool);@@ -1800,17 +1800,18 @@ void pushMeshInstances(Harness& h, BatchDrawKey key, u32 count, f32 mark, f32 deTEST_CASE("finalize: draws that each place the mesh many times merge with every record carried") {Harness h;const BatchDrawKey key = meshKey(5);- // Three draws of 3, 2 and 4 instances; depths reorder them so no two runs are adjacent in the pool.- pushMeshInstances(h, key, 3, 10.0f, 10.0f);- pushMeshInstances(h, key, 2, 20.0f, 30.0f);- pushMeshInstances(h, key, 4, 30.0f, 20.0f);+ // Three draws of 3, 2 and 4 instances; depths reorder them so no two runs are adjacent in the pool+ // (in three different steps of the key's coarse depth, as above).+ pushMeshInstances(h, key, 3, 10.0f, 1.0f);+ pushMeshInstances(h, key, 2, 20.0f, 1000.0f);+ pushMeshInstances(h, key, 4, 30.0f, 10.0f);h.list.finalize(h.pool);REQUIRE(h.list.mergedDrawCallCount() == 1);const DrawCommand& cmd = h.list.command(0);CHECK(cmd.instance_count == 9);- // Nearest first: the draw at depth 30 (marks 20, 21), then 20 (30..33), then 10 (10..12), each whole.+ // Nearest first: the draw at depth 1000 (marks 20, 21), then 10 (30..33), then 1 (10..12), each whole.CHECK(instanceMarks(h, cmd) == std::vector<f32>{20.0f, 21.0f, 30.0f, 31.0f, 32.0f, 33.0f, 10.0f, 11.0f, 12.0f});}diff --git a/tools/check-reload-identity.mjs b/tools/check-reload-identity.mjsindex 31ec0dbe3..2f8ae2ded 100644--- a/tools/check-reload-identity.mjs+++ b/tools/check-reload-identity.mjs@@ -62,6 +62,7 @@ const DISPOSITIONS = {},defineSystemSet: { kind: 'no-id', why: 'a set is addressed by its _name; it mints no symbol' },defineInputMap: { kind: 'no-id', why: 'a plain action table — nothing addresses a World through it' },+ defineContract: { kind: 'no-id', why: 'a contract is addressed by the fingerprint of its schemas, not by a minted symbol — evaluating it twice yields the same fingerprint' },defineBehavior: { kind: 'delegates', via: 'defineComponent' },};diff --git a/tools/check-sdk-chunk-manifest.mjs b/tools/check-sdk-chunk-manifest.mjsindex 7c1a22be6..128b8d892 100644--- a/tools/check-sdk-chunk-manifest.mjs+++ b/tools/check-sdk-chunk-manifest.mjs@@ -39,7 +39,9 @@ const manifest = JSON.parse(readFileSync(MANIFEST, 'utf8'));* static one does.*/function specifiers(file) {- const src = readFileSync(file, 'utf8');+ // Prose is not an import: a doc comment that shows `import { x } from './y'` survives into the chunk,+ // and would send the walk after a file that was never asked for.+ const src = readFileSync(file, 'utf8').replace(/\/\*[\s\S]*?\*\//g, '');const found = new Set();for (const re of [/\b(?:import|export)\b[^;\n]*?\bfrom\s*['"]([^'"]+)['"]/g,diff --git a/tools/goldenProjects.mjs b/tools/goldenProjects.mjsindex 4454d7130..7f1d75af3 100644--- a/tools/goldenProjects.mjs+++ b/tools/goldenProjects.mjs@@ -771,6 +771,112 @@ export const SHIPPED = {{ notCertifiable: "A rendering feature, covered by its render-scene pixel gates and unit tests; no golden project places it, and one packaged frame cannot decide a result that depends on the device." },"Camera shots and nested sequences on the timeline.":{ notCertifiable: "An editor authoring surface, covered by the editor tests and authoring checks; a packaged game cannot observe the editor interface." },+ "A `Planet`: ground on a sphere.":+ { notCertifiable: "A planet is covered by sdk/tests/terrain-sphere.test.ts, planet-gravity.test.ts, terrain-planet-collision.test.ts and worldgen-planet.test.ts; no golden project registers a planet provider yet (check-corpus-authoring records it as owed), so no packaged frame can certify it." },+ "A far world is planned sparsely, and a failed asset load is tried again.":+ { notCertifiable: "Foliage and generated worlds are covered by sdk/tests/foliage-placements.test.ts, foliage-builder.test.ts, worldgen-plan.test.ts and worldgen-plants.test.ts; no golden project places a generated world or placed plants yet, so no packaged frame can certify them." },+ "A quality level sets how far plants keep their detail.":+ { notCertifiable: "A quality-profile row, covered by sdk/tests/quality.test.ts and quality-runtime.test.ts; no golden project places plants, so no packaged frame can show a level's detail distance." },+ "Placed plants cast shadows only as far as twice their detailed distance.":+ { notCertifiable: "A shadow-caster cut-off for placed plants, covered by the foliage and quality suites in sdk/tests; no golden project places plants, so no packaged frame can certify it." },+ "The editor lets go of a generated world while the game plays.":+ { notCertifiable: "An editor authoring surface, covered by the editor tests and authoring checks; a packaged game cannot observe the editor interface." },+ "Plants are instances of one mesh.":+ { notCertifiable: "Instanced plants are covered by sdk/tests/foliage-placements.test.ts and the test_batch_builder C++ suite; no golden project places plants, so no packaged frame can certify them." },+ "A project can keep folders out of its asset database.":+ { notCertifiable: "A pipeline and editor setting, covered by the pipeline and editor tests; it decides which files the asset database reads, which a packaged game cannot observe." },+ "Small plants need not cast a shadow.":+ { notCertifiable: "A shadow-caster cut-off for placed plants, covered by the foliage and quality suites in sdk/tests; no golden project places plants, so no packaged frame can certify it." },+ "A project plugin that needs trust says so.":+ { notCertifiable: "An editor authoring surface, covered by the editor tests and authoring checks; a packaged game cannot observe the editor interface." },+ "A game's generated ground shows in the editor.":+ { notCertifiable: "An editor authoring surface, covered by the editor tests and authoring checks; a packaged game cannot observe the editor interface." },+ "A lookup table is adopted as data.":+ { notCertifiable: "An import-pipeline change, covered by pipeline/tests/asset-meta-lut.test.ts and asset-meta-table.test.ts; no golden project carries a lookup table." },+ "An Outdoor Environment to create.":+ { notCertifiable: "An editor authoring surface, covered by the editor tests and authoring checks; a packaged game cannot observe the editor interface." },+ "An Online 3D starter.":+ { notCertifiable: "A project template, covered by pipeline/tests/project-scaffold.test.ts and desktop/tests/templates.test.ts and the starter-3d editor authoring check; a template is not a golden project." },+ "Start a project from the command line.":+ { notCertifiable: "A command-line tool, covered by pipeline/tests/project-scaffold.test.ts; it creates a project and is not part of one." },+ "Clouds drawn from a coverage picture.":+ { notCertifiable: "A rendering feature, covered by sdk/tests/cloud-shafts.test.ts and its render-scene pixel gates; no golden project places a cloud layer." },+ "A Display LUT.":+ { notCertifiable: "A post-process effect, covered by sdk/tests/display-lut.test.ts and the lut-grade render-scene pixel gate; no golden project places one." },+ "Light beams that follow the clouds.":+ { notCertifiable: "A rendering feature, covered by sdk/tests/cloud-shafts.test.ts and its render-scene pixel gates; no golden project places a cloud layer." },+ "Sparkle on the water.":+ { notCertifiable: "Water is covered by sdk/tests/water.test.ts, water-zone.test.ts and water-bodies.test.ts and the water-look editor authoring check; no golden project carries a WaterBody yet (check-corpus-authoring records it as owed), so no packaged frame can certify it." },+ "A generated world's plants.":+ { notCertifiable: "Foliage and generated worlds are covered by sdk/tests/foliage-placements.test.ts, foliage-builder.test.ts, worldgen-plan.test.ts and worldgen-plants.test.ts; no golden project places a generated world or placed plants yet, so no packaged frame can certify them." },+ "Each terrain layer says how it meets the others.":+ { notCertifiable: "Terrain is covered by sdk/tests/terrain-surface.test.ts, terrain-provider.test.ts, terrain-layers.test.ts and terrain-quadtree.test.ts and the terrain-look editor authoring check; no golden project carries a Terrain yet, so no packaged frame can certify it." },+ "Placed plants.":+ { notCertifiable: "Foliage and generated worlds are covered by sdk/tests/foliage-placements.test.ts, foliage-builder.test.ts, worldgen-plan.test.ts and worldgen-plants.test.ts; no golden project places a generated world or placed plants yet, so no packaged frame can certify them." },+ "Water zones.":+ { notCertifiable: "Water is covered by sdk/tests/water.test.ts, water-zone.test.ts and water-bodies.test.ts and the water-look editor authoring check; no golden project carries a WaterBody yet (check-corpus-authoring records it as owed), so no packaged frame can certify it." },+ "Wind and rain on the water.":+ { notCertifiable: "Water weather is covered by sdk/tests/water-weather.test.ts; no golden project carries a WaterBody yet (check-corpus-authoring records it as owed), so no packaged frame can certify it." },+ "Surf on the shore.":+ { notCertifiable: "Water is covered by sdk/tests/water.test.ts, water-zone.test.ts and water-bodies.test.ts and the water-look editor authoring check; no golden project carries a WaterBody yet (check-corpus-authoring records it as owed), so no packaged frame can certify it." },+ "Terrain without cracks, and without end.":+ { notCertifiable: "Terrain is covered by sdk/tests/terrain-surface.test.ts, terrain-provider.test.ts, terrain-layers.test.ts and terrain-quadtree.test.ts and the terrain-look editor authoring check; no golden project carries a Terrain yet, so no packaged frame can certify it." },+ "Terrain from a generator the game names, versioned.":+ { notCertifiable: "Terrain is covered by sdk/tests/terrain-surface.test.ts, terrain-provider.test.ts, terrain-layers.test.ts and terrain-quadtree.test.ts and the terrain-look editor authoring check; no golden project carries a Terrain yet, so no packaged frame can certify it." },+ "Terrain collision, the same ground that is drawn.":+ { notCertifiable: "Terrain is covered by sdk/tests/terrain-surface.test.ts, terrain-provider.test.ts, terrain-layers.test.ts and terrain-quadtree.test.ts and the terrain-look editor authoring check; no golden project carries a Terrain yet, so no packaged frame can certify it." },+ "Procedural chunks, with one owner and one budget.":+ { notCertifiable: "Procedural chunks are covered by sdk/tests/procedural-chunks.test.ts; no golden project streams generated chunks, so no packaged frame can certify them." },+ "Generated worlds.":+ { notCertifiable: "Foliage and generated worlds are covered by sdk/tests/foliage-placements.test.ts, foliage-builder.test.ts, worldgen-plan.test.ts and worldgen-plants.test.ts; no golden project places a generated world or placed plants yet, so no packaged frame can certify them." },+ "Which water a place is.":+ { notCertifiable: "Water is covered by sdk/tests/water.test.ts, water-zone.test.ts and water-bodies.test.ts and the water-look editor authoring check; no golden project carries a WaterBody yet (check-corpus-authoring records it as owed), so no packaged frame can certify it." },+ "An area without a heightmap is a window on its provider's ground.":+ { notCertifiable: "Terrain is covered by sdk/tests/terrain-surface.test.ts, terrain-provider.test.ts, terrain-layers.test.ts and terrain-quadtree.test.ts and the terrain-look editor authoring check; no golden project carries a Terrain yet, so no packaged frame can certify it." },+ "Rays against the terrain, anywhere.":+ { notCertifiable: "Terrain is covered by sdk/tests/terrain-surface.test.ts, terrain-provider.test.ts, terrain-layers.test.ts and terrain-quadtree.test.ts and the terrain-look editor authoring check; no golden project carries a Terrain yet, so no packaged frame can certify it." },+ "Far versions for generated decoration.":+ { notCertifiable: "Foliage and generated worlds are covered by sdk/tests/foliage-placements.test.ts, foliage-builder.test.ts, worldgen-plan.test.ts and worldgen-plants.test.ts; no golden project places a generated world or placed plants yet, so no packaged frame can certify them." },+ "Terrain modifiers, and zones that level their ground.":+ { notCertifiable: "Terrain is covered by sdk/tests/terrain-surface.test.ts, terrain-provider.test.ts, terrain-layers.test.ts and terrain-quadtree.test.ts and the terrain-look editor authoring check; no golden project carries a Terrain yet, so no packaged frame can certify it." },+ "Terrain layers: up to eight kinds of ground, each with its normal and mask maps.":+ { notCertifiable: "Terrain is covered by sdk/tests/terrain-surface.test.ts, terrain-provider.test.ts, terrain-layers.test.ts and terrain-quadtree.test.ts and the terrain-look editor authoring check; no golden project carries a Terrain yet, so no packaged frame can certify it." },+ "Foam is where waves burst, not along every shore.":+ { notCertifiable: "Water is covered by sdk/tests/water.test.ts, water-zone.test.ts and water-bodies.test.ts and the water-look editor authoring check; no golden project carries a WaterBody yet (check-corpus-authoring records it as owed), so no packaged frame can certify it." },+ "Surf comes in from open water as lines.":+ { notCertifiable: "Water is covered by sdk/tests/water.test.ts, water-zone.test.ts and water-bodies.test.ts and the water-look editor authoring check; no golden project carries a WaterBody yet (check-corpus-authoring records it as owed), so no packaged frame can certify it." },+ "A river gives way where it runs into the sea or a lake.":+ { notCertifiable: "Water is covered by sdk/tests/water.test.ts, water-zone.test.ts and water-bodies.test.ts and the water-look editor authoring check; no golden project carries a WaterBody yet (check-corpus-authoring records it as owed), so no packaged frame can certify it." },+ "Water meets the shore along a smooth line.":+ { notCertifiable: "Water is covered by sdk/tests/water.test.ts, water-zone.test.ts and water-bodies.test.ts and the water-look editor authoring check; no golden project carries a WaterBody yet (check-corpus-authoring records it as owed), so no packaged frame can certify it." },+ "The distance to the shore is a distance.":+ { notCertifiable: "Water is covered by sdk/tests/water.test.ts, water-zone.test.ts and water-bodies.test.ts and the water-look editor authoring check; no golden project carries a WaterBody yet (check-corpus-authoring records it as owed), so no packaged frame can certify it." },+ "Heightmaps say how they hold their heights.":+ { notCertifiable: "Terrain is covered by sdk/tests/terrain-surface.test.ts, terrain-provider.test.ts, terrain-layers.test.ts and terrain-quadtree.test.ts and the terrain-look editor authoring check; no golden project carries a Terrain yet, so no packaged frame can certify it." },+ "Rivers cut their beds.":+ { notCertifiable: "River beds are covered by sdk/tests/water-river-bed.test.ts; no golden project carries a WaterBody yet (check-corpus-authoring records it as owed), so no packaged frame can certify it." },+ "Whether a place can be walked to.":+ { notCertifiable: "Terrain reachability is covered by sdk/tests/terrain-reach.test.ts; no golden project carries a Terrain yet, so no packaged frame can certify it." },+ "World rules as a file, with an editor.":+ { notCertifiable: "World rules are covered by sdk/tests/worldgen-rules-asset.test.ts; the editor for them is covered by the editor tests, and no golden project carries a WorldGen yet." },+ "How far a place is from the water.":+ { notCertifiable: "Water is covered by sdk/tests/water.test.ts, water-zone.test.ts and water-bodies.test.ts and the water-look editor authoring check; no golden project carries a WaterBody yet (check-corpus-authoring records it as owed), so no packaged frame can certify it." },+ "A vertex hook can hand the fragment a colour.":+ { notCertifiable: "A material-hook rendering feature, covered by the prepass-hook render-scene pixel gate and the terrain tests in sdk/tests; no golden project places a Terrain." },+ "Bakes run over frames, with progress.":+ { notCertifiable: "Baking is covered by sdk/tests/bakes.test.ts; a bake runs while a project is authored or opened and a packaged game does not run one." },+ "Eroded and warped terrain.":+ { notCertifiable: "Terrain erosion is covered by sdk/tests/terrain-erosion.test.ts; no golden project carries a Terrain yet, so no packaged frame can certify it." },+ "Terrain layers without repeat, and with natural edges.":+ { notCertifiable: "Terrain is covered by sdk/tests/terrain-surface.test.ts, terrain-provider.test.ts, terrain-layers.test.ts and terrain-quadtree.test.ts and the terrain-look editor authoring check; no golden project carries a Terrain yet, so no packaged frame can certify it." },+ "A richer Terrain shader.":+ { notCertifiable: "Terrain is covered by sdk/tests/terrain-surface.test.ts, terrain-provider.test.ts, terrain-layers.test.ts and terrain-quadtree.test.ts and the terrain-look editor authoring check; no golden project carries a Terrain yet, so no packaged frame can certify it." },+ "Water mirrors the world.":+ { notCertifiable: "Water is covered by sdk/tests/water.test.ts, water-zone.test.ts and water-bodies.test.ts and the water-look editor authoring check; no golden project carries a WaterBody yet (check-corpus-authoring records it as owed), so no packaged frame can certify it." },+ "Soft water edges.":+ { notCertifiable: "Water is covered by sdk/tests/water.test.ts, water-zone.test.ts and water-bodies.test.ts and the water-look editor authoring check; no golden project carries a WaterBody yet (check-corpus-authoring records it as owed), so no packaged frame can certify it." },+ "Plants keep out of the water.":+ { notCertifiable: "Foliage and generated worlds are covered by sdk/tests/foliage-placements.test.ts, foliage-builder.test.ts, worldgen-plan.test.ts and worldgen-plants.test.ts; no golden project places a generated world or placed plants yet, so no packaged frame can certify them." },};/** Numeric compare of two `x.y.z` strings. */diff --git a/tools/lib/contractFacts.mjs b/tools/lib/contractFacts.mjsindex 057a1c90c..b0e4a71ab 100644--- a/tools/lib/contractFacts.mjs+++ b/tools/lib/contractFacts.mjs@@ -347,6 +347,8 @@ export const RE_EXPORTS = {export const NOT_CONTRACT = {'sdk/etc/perf.snapshot.json':'a measured baseline, not a derivation — accepted with `perf-guard --update`.',+ 'sdk/src/runtime/planWorkerBundle.generated.ts':+ 'the compiled text of src/worldgen/planWorker.ts, built by sdk/scripts/build-worker.mjs — one source file bundled, not a projection of a fact two places must agree on.','sdk/src/postprocess/agxLut.generated.ts':"a table baked once from Blender's AgX .cube by tools/gen-agx-lut.py — third-party data, nothing in the engine it must agree with.",};diff --git a/tools/nativeScriptModules.js b/tools/nativeScriptModules.jsindex 9f082e7c9..da25b4184 100644--- a/tools/nativeScriptModules.js+++ b/tools/nativeScriptModules.js@@ -79,6 +79,7 @@ export const MODULES = {'esengine/ai': { disposition: 'native-subpath' },'esengine/replication': { disposition: 'native-subpath' },'esengine/gameplay': { disposition: 'native-subpath' },+ 'esengine/session': { disposition: 'native-subpath' },'esengine/native': {disposition: 'forbidden-native-script',