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
chore(gates): what the checks asked of this week's work - a disposition for esengine/image in a native script and its namespace there, Waterfall's width and its place in the corpus, the recipe worker's bundle as not a contract, shadeLight2D's inout against its return, and a test that named App as a type
yhhb60c145d851e
diff --git a/desktop b/desktopindex 82da21bf7..29cb1784f 160000--- a/desktop+++ b/desktop@@ -1 +1 @@-Subproject commit 82da21bf7413988f086f36ce9d6880ced31d392c+Subproject commit 29cb1784fd9d6848f610c58b4819f2ffff2efb3ediff --git a/sdk/src/platform/nativeModuleRegistry.ts b/sdk/src/platform/nativeModuleRegistry.tsindex 4dba41539..c8ea47b35 100644--- a/sdk/src/platform/nativeModuleRegistry.ts+++ b/sdk/src/platform/nativeModuleRegistry.ts@@ -33,6 +33,7 @@ import * as FxAgxModule from '../postprocess/fxAgx';import * as FoliageModule from '../foliage';import * as WorldGenModule from '../worldgen';import * as WaterModule from '../water';+import * as ImageModule from '../image';import * as SplineModule from '../spline';import * as VoxelModule from '../voxel';import * as Rig2DModule from '../rig2d';@@ -68,6 +69,7 @@ export const NATIVE_MODULE_NAMESPACES: Readonly<Record<string, unknown>> = {'esengine/foliage': FoliageModule,'esengine/worldgen': WorldGenModule,'esengine/water': WaterModule,+ 'esengine/image': ImageModule,'esengine/spline': SplineModule,'esengine/voxel': VoxelModule,'esengine/rig2d': Rig2DModule,diff --git a/sdk/tests/audio-source-fade.test.ts b/sdk/tests/audio-source-fade.test.tsindex e3dae05be..0e0c9831f 100644--- a/sdk/tests/audio-source-fade.test.ts+++ b/sdk/tests/audio-source-fade.test.ts@@ -64,7 +64,7 @@ async function appWith(source: Record<string, unknown>) {app.world.insert(e, AudioSource, { clip: 'theme.wav', bus: 'music', ...source });return { app, e };}-const frames = async (app: InstanceType<typeof App>, n: number, dt = 0.1): Promise<void> => { for (let i = 0; i < n; i++) await app.tick(dt); };+const frames = async (app: ReturnType<typeof App.new>, n: number, dt = 0.1): Promise<void> => { for (let i = 0; i < n; i++) await app.tick(dt); };describe('an AudioSource that fades', () => {it('comes up from nothing over fadeIn, and no further than its volume', async () => {diff --git a/tools/check-corpus-authoring.mjs b/tools/check-corpus-authoring.mjsindex 11e79e353..5ed1249b8 100644--- a/tools/check-corpus-authoring.mjs+++ b/tools/check-corpus-authoring.mjs@@ -125,6 +125,8 @@ const DISPOSITION = {Planet: ['owed', 'authored by a game today (star-neighbors, a round planet from its own generator); an example that registers a planet provider is owed'],MeshInstances: ['derived', 'the foliage and world generation systems write it, one entity a kind and part of a cell; its places are data a system computes, not something a scene authors'],ParticleCollider: ['owed', 'no example has a GPU emitter bouncing off a shape yet; the particle-gpu scenes are where the first one goes'],+ Waterfall: ['owed', 'no example has water falling off a lip yet; the terrain-and-water example, where a river meets a cliff, is where the first one goes'],+ WaterfallAnchor: ['owed', 'no example fixes a fall to a river yet; it goes with the first Waterfall in the terrain-and-water example'],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'],diff --git a/tools/check-gizmo-coverage.mjs b/tools/check-gizmo-coverage.mjsindex 3e6793cef..929c20d53 100644--- a/tools/check-gizmo-coverage.mjs+++ b/tools/check-gizmo-coverage.mjs@@ -168,6 +168,7 @@ const DISPOSITION = {'WaterZone.cellSize': ['no-place', 'the cell size of the finest ring of the surface\'s mesh, not a region of the entity'],'WaterZone.rippleSize': ['no-place', 'the side of a window of ripples that follows the camera, not a region of the entity'],'Floating.radius': ['no-place', 'how deep under the surface a point of the body is wholly wet, not a region of the entity'],+ 'Waterfall.width': ['renders', 'the sheet of water the component draws is this wide where it leaves the lip'],'WaterBody.waveHeight': ['no-place', 'the height of the tallest wave, not a region of the entity'],'WaterBody.bedDepth': ['renders', 'a river\'s bed is cut into the terrain, which draws it'],'SpringBone.radius': ['no-place', 'the thickness of the strand, kept clear of the colliders; a margin on each bone, not a region of the root'],diff --git a/tools/check-shader-blocks.mjs b/tools/check-shader-blocks.mjsindex d136d2f73..f29489b85 100644--- a/tools/check-shader-blocks.mjs+++ b/tools/check-shader-blocks.mjs@@ -101,6 +101,7 @@ const SIGNATURE_GAPS = {sampleNormal: 'WGSL takes the texture and its sampler apart; GLSL has one combined type',sampleNormalGrad: 'WGSL takes the texture and its sampler apart; GLSL has one combined type',shadeLight: 'WGSL returns the light, gloss and extra light it adds (a struct); GLSL accumulates them in three inout arguments',+ shadeLight2D: 'WGSL returns the light it adds; GLSL accumulates it in an inout argument, as shadeLight does',};/** A field name as the comparison sees it: the `u_` a shader adds is not part of it. */diff --git a/tools/lib/contractFacts.mjs b/tools/lib/contractFacts.mjsindex ba5b93f05..33124c325 100644--- a/tools/lib/contractFacts.mjs+++ b/tools/lib/contractFacts.mjs@@ -361,6 +361,8 @@ 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.',+ 'sdk/src/image/recipeWorkerBundle.generated.ts':+ 'the compiled text of src/image/recipeWorker.ts, built by sdk/scripts/build-worker.mjs — one source file bundled, as the planning worker is.','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':diff --git a/tools/nativeScriptModules.js b/tools/nativeScriptModules.jsindex 3b2ee59ef..298649463 100644--- a/tools/nativeScriptModules.js+++ b/tools/nativeScriptModules.js@@ -74,6 +74,7 @@ export const MODULES = {'esengine/foliage': { disposition: 'native-subpath' },'esengine/worldgen': { disposition: 'native-subpath' },'esengine/water': { disposition: 'native-subpath' },+ 'esengine/image': { disposition: 'native-subpath' },'esengine/spline': { disposition: 'native-subpath' },'esengine/voxel': { disposition: 'native-subpath' },'esengine/rig2d': { disposition: 'native-subpath' },diff --git a/tools/releaseNotes.mjs b/tools/releaseNotes.mjsindex 9a11b3f6a..0203ef51b 100644--- a/tools/releaseNotes.mjs+++ b/tools/releaseNotes.mjs@@ -4698,6 +4698,14 @@ export const NOTED = {{"note": "A picture made in the editor ships as a recipe."},"fix(render): the built-in ripple map is drawn again after a device loss, and no copy of it is kept - every game held 256 KB for a map only water reads; and the checks that went red since: a cost scene with no criterion, TilemapLayer.lit in its defaults, NativeChannel frozen before it earned it, a wav encoder that refused read-only channels, a worker test with five seconds for twenty realms":{"note": "A game no longer keeps a copy of the built-in ripple map."},+ "chore(gates): what the checks asked of this week's work - a disposition for esengine/image in a native script and its namespace there, Waterfall's width and its place in the corpus, the recipe worker's bundle as not a contract, shadeLight2D's inout against its return, and a test that named App as a type":+ {"internal": "tables the gates read, brought level; a natively packaged script can now import esengine/image, which no native game has run yet"},+ "feat(image): a picture's source goes where a texture goes, and its maps are recipes too - a texture field takes an .esimage, the image tools write a picture's normal and surface maps as recipes beside it and answer their refs, text is set by the drawer a game sets it with, and the viewport draws a recipe as a game does":+ {"note": "A picture made in the editor ships as a recipe."},+ "fix(checks): the quality page's water rows are the levels the engine has, and a template to mirror has its native channel header - Low draws 3 waves and High 8 since the wave set grew, and an iOS template without EstellaNativeChannel.h is incomplete":+ {"internal": "two checks brought level with what the engine does; nothing a creator sees changed"},+ "fix(checks): the motion sheet call has the time a slow runner takes - sixty stepped frames passed two minutes on the runner that takes the check twice as long, four times in fourteen builds":+ {"internal": "a longer wait in an editor check on a slow runner"},"fix(terrain): a detail the pages cannot hold no longer cracks the ground - a tree that wanted more nodes than the atlas has pages was drawn in part by coarser pages standing in, which do not meet their finer neighbours' edges, and the pages were fought over every frame; the ground is now drawn at the share of its detail's range that fits, and says so once":{"note": "A detail the pages cannot hold no longer cracks the ground."},"fix(foliage): a far plant grows across the ground, not taller - a mesh plant kept in a far version was grown the same every way to cover the ground of those left out, so a flower that stood for ten stood ten times as high and a far meadow was a field of poles; it now grows across the ground only, and Foliage.farGrowUp gives its height a share of the growth back":