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
fix(gates): the world anchor system declares what it touches, the sky effect door and the 3D physics declarations have their dispositions, and the generated tables, baked scene and long shader literal follow
yhhbc84636bbd48
diff --git a/docs/astro/src/data/apiStability.generated.json b/docs/astro/src/data/apiStability.generated.jsonindex d939afdec..8a88a6168 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": 178,- "experimental": 3034,+ "experimental": 3050,"deprecated": 3},- "total": 3327,+ "total": 3343,"subsystems": [{"id": "mobile-controls",diff --git a/examples/physics-3d/assets/scenes/main.esscene b/examples/physics-3d/assets/scenes/main.essceneindex b67a63dd5..f514619e5 100644--- a/examples/physics-3d/assets/scenes/main.esscene+++ b/examples/physics-3d/assets/scenes/main.esscene@@ -1522,7 +1522,7 @@"bounces": 2,"samples": 64,"probeSamples": 128,- "bakedFrom": "a30f24a1215d6fad"+ "bakedFrom": "9b2b6ef3f99b185f"}}]diff --git a/pipeline/tests/spine-runtimes.test.ts b/pipeline/tests/spine-runtimes.test.tsindex 9892ed5db..a6436ffda 100644--- a/pipeline/tests/spine-runtimes.test.ts+++ b/pipeline/tests/spine-runtimes.test.ts@@ -33,7 +33,7 @@ beforeAll(() => {staged = mkdtempSync(path.join(tmpdir(), 'estella-spine-rt-'));for (const [v, file] of Object.entries(SKELETONS)) copyFileSync(file, path.join(staged, `hero${v}.skel`));});-afterAll(() => rmSync(staged, { recursive: true, force: true }));+afterAll(() => rmSync(staged, { recursive: true, force: true, maxRetries: 10, retryDelay: 50 }));const entries = (...versions: string[]) =>versions.map((v) => ({ path: `hero${v}.skel`, sourcePath: `assets/hero${v}.skel`, type: 'spine' }));diff --git a/sdk/src/physics3d/components.ts b/sdk/src/physics3d/components.tsnew file mode 100644index 000000000..8e76f4d15--- /dev/null+++ b/sdk/src/physics3d/components.ts@@ -0,0 +1,10 @@+// SPDX-License-Identifier: Apache-2.0+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team+/**+ * @file components.ts — 3D physics as a project DECLARES it: the world's settings and the arithmetic over+ * them. No solver.+ *+ * Not a build entry. It is the AUTHORITY on where the line falls — check-core-carries-options reads this+ * list to tell a declaration from a solver.+ */+export * from './worldConfig';diff --git a/sdk/src/ui/core/world-anchor.ts b/sdk/src/ui/core/world-anchor.tsindex 011956934..c9961d037 100644--- a/sdk/src/ui/core/world-anchor.ts+++ b/sdk/src/ui/core/world-anchor.ts@@ -208,7 +208,7 @@ export class UIWorldAnchorPlugin implements Plugin {app.addSystemToSchedule(Schedule.PostUpdate, defineSystem([GetWorld(), Res(ScreenLayout)],(world: World, screen: ScreenLayoutData) => stepWorldAnchors(world, screen),- { name: 'UIWorldAnchorSystem' },+ { name: 'UIWorldAnchorSystem', touches: { reads: ['Camera', 'Transform'], writes: ['UINode', 'UIWorldAnchor'] } },), { runBefore: [SystemLabel.UILayoutLate] });}}diff --git a/src/esengine/resource/ShaderParser.cpp b/src/esengine/resource/ShaderParser.cppindex f572512ff..72bf7b32a 100644--- a/src/esengine/resource/ShaderParser.cpp+++ b/src/esengine/resource/ShaderParser.cpp@@ -1995,7 +1995,8 @@ fn skyOcclusion(d : vec3f) -> f32 {return mix(1.0, clamp(v, 0.0, 1.0), step(0.5, pc.u_probeIrradiance[base + 9].z));}// See the GLSL twin: one exit, for the shape the two share.-fn indirectIrradiance(N : vec3f) -> vec3f {+)"+R"(fn indirectIrradiance(N : vec3f) -> vec3f {let base = clamp(i32(g_probeSlot), 0, 99) * 10;let mode = pc.u_probeIrradiance[base].w;var result : vec3f;diff --git a/tools/check-core-carries-options.mjs b/tools/check-core-carries-options.mjsindex cf5c56b87..b90b762b9 100644--- a/tools/check-core-carries-options.mjs+++ b/tools/check-core-carries-options.mjs@@ -36,7 +36,7 @@ const BASELINE = path.join(ROOT, 'tools', 'baselines', 'core-carries-options.jso* are DECLARATIONS. A missing entry means the whole subsystem is solver. */const SUBSYSTEMS = {physics: 'components.ts',- physics3d: null,+ physics3d: 'components.ts',spine: null,dragonbones: null,video: null,diff --git a/tools/check-corpus-authoring.mjs b/tools/check-corpus-authoring.mjsindex c845066f4..11e79e353 100644--- a/tools/check-corpus-authoring.mjs+++ b/tools/check-corpus-authoring.mjs@@ -128,6 +128,8 @@ const DISPOSITION = {GripProfile: ['owed', 'no example holds an object in its two hands yet; a character with a rifle is where the first one goes'],GripHolder: ['owed', 'no example holds an object in its two hands yet; a character with a rifle is where the first one goes'],GripPose: ['owed', 'no example holds a tool in a named pose yet; a character with something in its hand is where the first one goes'],+ GripSurface: ['owed', 'no example marks where a hand may take hold of a mesh yet; the character with a rifle that gets the first grip is where the first one goes'],+ UIWorldAnchor: ['owed', 'no example pins a HUD marker over a point in the 3D world yet; the first 3D example with an objective marker is where the first one goes'],VoxelTerrain: ['owed', 'no example digs in a volume yet; a small mine is where the first one goes'],RoadDecal: ['owed', 'no example lays a road over a terrain yet; wilds is where the first one goes'],PlantProxy: ['derived', 'the plant interaction makes it for a plant near a contact, and takes it away again; a scene never holds one'],diff --git a/tools/check-reload-identity.mjs b/tools/check-reload-identity.mjsindex 2f8ae2ded..d51fbba14 100644--- a/tools/check-reload-identity.mjs+++ b/tools/check-reload-identity.mjs@@ -64,6 +64,7 @@ const DISPOSITIONS = {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' },+ defineSkyEffect: { kind: 'no-id', why: 'an effect is addressed by its type name — defining a type again replaces the entry under that name, so a re-run lands on the same one' },};const problems = [];diff --git a/tools/check-render-scenes.mjs b/tools/check-render-scenes.mjsindex ab9f07e34..505ad103b 100644--- a/tools/check-render-scenes.mjs+++ b/tools/check-render-scenes.mjs@@ -44,7 +44,7 @@ for (const s of SCENES) {const asserts = s.env.ESTELLA_VERIFY_EXPECT || s.env.ESTELLA_VERIFY_COUNT|| s.env.ESTELLA_VERIFY_DEVICE_LOSS === 'roundtrip'|| s.env.ESTELLA_VERIFY_SEAM- || s.env.ESTELLA_VERIFY_GRID || s.env.ESTELLA_VERIFY_STUDIO || s.env.ESTELLA_VERIFY_SHADING || s.env.ESTELLA_VERIFY_SKIN_WEIGHTS || s.env.ESTELLA_VERIFY_PREVIEW+ || s.env.ESTELLA_VERIFY_GRID || s.env.ESTELLA_VERIFY_STUDIO || s.env.ESTELLA_VERIFY_SHADING || s.env.ESTELLA_VERIFY_LIGHTING_SPLIT || s.env.ESTELLA_VERIFY_SKIN_WEIGHTS || s.env.ESTELLA_VERIFY_PREVIEW|| s.env.ESTELLA_VERIFY_MESH_PREVIEW || s.env.ESTELLA_VERIFY_DEPTH_LAYERS|| s.env.ESTELLA_VERIFY_COUNTERS || s.env.ESTELLA_VERIFY_COUNTERS_MAX || s.env.ESTELLA_VERIFY_FRAME_DEBUG || s.env.ESTELLA_VERIFY_EDGE || s.env.ESTELLA_VERIFY_CUTOUT_EDGE || s.env.ESTELLA_VERIFY_MINIFIED || s.env.ESTELLA_VERIFY_TWINS|| s.env.ESTELLA_VERIFY_DRAW_CALLS || s.env.ESTELLA_VERIFY_NINE_SLICEdiff --git a/tools/lib/contractFacts.mjs b/tools/lib/contractFacts.mjsindex b0e4a71ab..bfed72539 100644--- a/tools/lib/contractFacts.mjs+++ b/tools/lib/contractFacts.mjs@@ -189,6 +189,18 @@ export const FACTS = [],digest: { name: 'engine-abi', path: 'sdk/src/ecs/aot/abiDigest.ts', probe: /trig=/ },},+ {+ id: 'registryEntityOps',+ what: 'The Registry entity operations, and the native host global each one is bound to.',+ surface: 'runtime-wasm-abi',+ authors: [+ { path: 'tools/eht/registry_ops.py', probe: /REGISTRY_OPS: Tuple/, kind: 'semantic' },+ ],+ projections: ['sdk/src/ecs/bridge/registryOps.generated.ts'],+ verification: [+ { path: 'sdk/tests/native-registry.test.ts', how: 'test', probe: /REGISTRY_OPS/ },+ ],+ },{id: 'tweenWireEnums',what: 'The tween easing/state/loop/target enums, which cross the boundary as bare numbers.',@@ -349,6 +361,14 @@ export const NOT_CONTRACT = {'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.',+ 'native/spine/SpineCRename21.hpp':+ 'the symbols a pinned vendored spine-c 2.1 release defines, read off its compiled objects by tools/spine-c-rename.mjs — a derivation of third-party code, nothing in the engine it must agree with.',+ 'native/spine/SpineCRename38.hpp':+ 'the symbols a pinned vendored spine-c 3.8 release defines, read off its compiled objects by tools/spine-c-rename.mjs — a derivation of third-party code, nothing in the engine it must agree with.',+ 'native/spine/SpineCRename41.hpp':+ 'the symbols a pinned vendored spine-c 4.1 release defines, read off its compiled objects by tools/spine-c-rename.mjs — a derivation of third-party code, nothing in the engine it must agree with.',+ 'native/spine/SpineCRename42.hpp':+ 'the symbols a pinned vendored spine-c 4.2 release defines, read off its compiled objects by tools/spine-c-rename.mjs — a derivation of third-party code, nothing in the engine it must agree with.','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/spine-c-rename.mjs b/tools/spine-c-rename.mjsindex 36b6665c6..fea6b3d1e 100644--- a/tools/spine-c-rename.mjs+++ b/tools/spine-c-rename.mjs@@ -112,7 +112,7 @@ function symbolsOf(version, { cc, nm }) {}return [...defined].sort();} finally {- rmSync(work, { recursive: true, force: true });+ rmSync(work, { recursive: true, force: true, maxRetries: 10, retryDelay: 50 });}}