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.

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.json
index 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.ts
index 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.json
index 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.ts
index 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.ts
index 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.ts
index 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 Team
import { 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.ts
index 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.cpp
index 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 de
TEST_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.mjs
index 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.mjs
index 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.mjs
index 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.mjs
index 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.js
index 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',