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: release v0.101.0
yhh3f11be3e0a5d
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex f6a7dfdda..a77ed6ea7 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -14,6 +14,8 @@ published separately; it ships inside the editor.## [Unreleased]+## [0.101.0] - 2026-11-10+### Added- **Holding an object in both hands.** A `GripProfile` on an object says where each palm sits on it, by anchor entities, and how its fingers are held; a `GripHolder` on a character takes hold of it, bends the supporting arm (and with the object placed by the game, the leading one) to the anchors and blends the fingers over the clip by `slerp(clip, grip, weight)`. It runs in one fixed order that cannot loop, eases every joint when what is held changes, puts the palm on the anchor for any arm length within reach, and gives the same bones for the same inputs. `captureFingerPose` keeps a hand's fingers as JSON.@@ -32,15 +34,22 @@ published separately; it ships inside the editor.- **2D bones can reach for things and follow each other.** `IK2D` on the last bone of a limb bends it to a target after the animation has played, exactly for two bones and iteratively for more, with a weight clips can key. `BoneConstraint2D` limits a joint's rotation, which a chain through it keeps to, or copies another entity's rotation or position, or looks at it. Both follow a character mirrored by a negative scale. `esengine/rig2d` also makes all of this from code.- **A tile layer can be dug, blown up and rebuilt while the game runs.** `createDestructibleTilemap` in `esengine/tilemap` gives a layer tiles with hardness that wear down over several blows, circular explosions with falloff that walls can shelter from, and placing and filling, with one list of what changed for drops and effects. The neighbouring autotiles re-resolve, `createNavGrid` or `syncNavGrid` keeps a navigation grid in step one cell at a time, and `toJSON` and `load` save only the cells that differ from the map it started as, refusing a damaged save whole. On a streamed world, `publishChunk` lays a player's changes over what the generator made, so a chunk let go and made again comes back as it was left.- **Solid tile ground can have colliders only where it is exposed.** `TilemapRuntime.setCollisionOutline` generates plain boxes for tiles with an open side, so solid ground costs no bodies and a tunnel below a surface leaves the surface's colliders alone. A destructible layer turns it on; `collisionOutline: false` keeps merged ground.+- **A native app plays every Spine version.** Android, iOS and desktop apps now read skeletons exported from Spine 2.1, 3.8, 4.1, 4.2 and 4.3, each with the runtime of its own version, as a browser build does, so a project can mix them. The official runtime templates carry all five. An Android package includes only the runtimes its skeletons need, at 0.2 to 1 MB each per ABI; iOS and desktop link all of them, about 1 MB more. Packaging with a template from an older release, which carries one version, lists every skeleton it cannot play. Before this, a project whose skeletons were not 4.2 needed an engine source checkout to build its own template.+- **Which Spine runtimes a package carries can be set per runtime.** Project Settings → Spine has a row per runtime with Auto, Include and Exclude, and each row says what the build will do. Auto carries a runtime when a packaged skeleton was exported from it. Include is for skeletons only code loads, such as a path built at run time or content fetched later. Exclude leaves a runtime out, and an export whose skeletons need it fails and names them. The same decision applies to web, playable, mini-game and Android packages, and each export result lists every runtime with why it was carried or left out. The old single Spine version setting, which never changed a package, is gone.+- **An agent can open any Settings page.** The editor's `open_settings` tool opens the Settings window on a section, or on the section holding a given row, so a screenshot can show it.### Changed+- **`run_editor_command` refuses an id that does not exist.** It used to answer "ok" for any id. A disabled command now answers `{ ran: false, reason: "disabled" }`.+- **A 2D character stands still on a walkable slope, and a steeper one is a wall.** It used to drift down any slope and could walk up one past `floorMaxAngle`. `stopOnSlope` and `blockSteepSlopes` turn each back off.- **Editing a tile no longer replaces the colliders around it.** A tile edit used to destroy and remake every collider in its chunk, which ended a body's contact with the floor it stood on and woke what was asleep there. Now only the colliders whose shape changed are replaced.- **A row of tiles being edited uploads a piece of itself.** One changed tile re-uploaded its whole row of chunks, over a megabyte when the row is full. A row that changes is now held in pieces of four chunks, so an edit uploads about an eighth of that, for up to seven more draws in that row until it has rested. A static map is drawn as before.### Fixed+- **Physics no longer stops on Android and the desktop host.** The native host had no way to ask whether an entity was still alive, so `PhysicsStepSystem` threw `n.valid is not a function` every frame and nothing moved (#114). The Registry's entity operations are now generated from one table for the web and native hosts, and a native host that lacks one fails at startup and names it.+- **The profiler no longer calls a long render stall vsync.** Time in the render submit that nothing measured was all filed as "present · vsync", with a hint that it was idle: an 820 ms frame spent growing text outlines read as waiting, and its banner blamed two domains of 0.1 ms. A wait now counts up to 50 ms, the slowest a display presents; the rest shows as "untimed work", marked as a hotspot. Text drawing has its own `render.text` row, and when timed work explains under half an over-budget frame the banner says so instead of naming a domain. A long task under a pinned frame is put down to the scope that timed it rather than to "GC / uninstrumented JS". `ScopeCost` gains `parent`: a scope measured inside another is listed under it.- **While editing, foliage and generated worlds follow the viewport.** A `WorldStreamingSource` in the scene used to hold foliage, generated worlds and voxels around itself in the edit view while terrain detail followed the viewport, and a 2D view counted as no viewpoint at all. Sculpting and painting a terrain also no longer copies the whole ground at each stroke: it keeps 32 by 32 tiles as they are first touched, so a diagonal stroke's undo holds what it reached and not the square around it.- **Zooming in on outlined text no longer freezes the editor.** Growing a bitmap glyph into its outline cost the fourth power of its size on screen, and a label did it again for every glyph at each step of the zoom: past 1500% a single frame took more than 15 seconds, and showing a hidden label at full zoom hung the editor. The outline now costs what the glyph's size does and looks the same, a frame stays under about 70 ms through the whole zoom, and `Auto` text at 128 screen pixels or more draws from a distance field wide enough to hold its outline. `Bitmap` is still honored where it is set, at the new cost.@@ -15297,7 +15306,8 @@ not kept before this file was introduced — see the Git history at`github.com/esengine/estella` for the full commit-level record since the firstcommit on 2026-01-25.-[Unreleased]: https://github.com/esengine/estella/compare/v0.100.0...HEAD+[Unreleased]: https://github.com/esengine/estella/compare/v0.101.0...HEAD+[0.101.0]: https://github.com/esengine/estella/compare/v0.100.0...v0.101.0[0.100.0]: https://github.com/esengine/estella/compare/v0.99.1...v0.100.0[0.99.1]: https://github.com/esengine/estella/compare/v0.99.0...v0.99.1[0.99.0]: https://github.com/esengine/estella/compare/v0.98.0...v0.99.0diff --git a/SECURITY.md b/SECURITY.mdindex ac73a50d6..0d2f6e7d6 100644--- a/SECURITY.md+++ b/SECURITY.md@@ -7,8 +7,8 @@ upgrading to the latest release is the supported path to a fix.| Version | Supported ||---------|-----------|-| 0.100.x | Yes |-| < 0.100 | No |+| 0.101.x | Yes |+| < 0.101 | No |`tools/check-release-metadata.mjs` fails the build if this table stops matchingthe version being shipped, so it cannot quietly fall behind again.diff --git a/desktop b/desktopindex f11327097..bd7d57340 160000--- a/desktop+++ b/desktop@@ -1 +1 @@-Subproject commit f11327097f50b5db1fe445e670662b8d446ec8ca+Subproject commit bd7d5734012401f223b0d8d67fbdcf589d119ef2diff --git a/package.json b/package.jsonindex dcec7bd54..dc26244c0 100644--- a/package.json+++ b/package.json@@ -1,6 +1,6 @@{"name": "estella",- "version": "0.100.0",+ "version": "0.101.0","private": true,"type": "module","description": "Estella - A fast 2D/3D game engine powered by WebAssembly and ECS",diff --git a/tools/goldenProjects.mjs b/tools/goldenProjects.mjsindex 47895023f..ffa15b6c3 100644--- a/tools/goldenProjects.mjs+++ b/tools/goldenProjects.mjs@@ -92,6 +92,44 @@ export const CENSUS_FLOOR = '0.60.0';* that does not exist, and release notes are a different act. Theirs is ungated.*/export const SHIPPED = {+ "A native app plays every Spine version.":+ { notCertifiable: "Every Spine release linked side by side is covered by sdk/tests/native-side-modules.test.ts (each version routed to its own runtime), tools/check-native-bindings.mjs and the post-build symbol check in tools/spine-c-rename.mjs; one APK with 3.8, 4.1 and 4.2 skeletons was played on a phone. No golden project ships skeletons of more than one version." },+ "Which Spine runtimes a package carries can be set per runtime.":+ { notCertifiable: "An export-time decision covered by pipeline/tests/spine-runtimes.test.ts against real vendored skeletons and pipeline/tests/native-template.test.ts; a golden frame shows a skeleton playing, not which runtimes the package left out." },+ "An agent can open any Settings page.":+ { notCertifiable: "An editor MCP tool, used by editor checks; a packaged game carries no editor." },+ "Holding an object in both hands.":+ { notCertifiable: "Covered by sdk/tests/grip-hold-wasm.test.ts and the grip-hold editor check on both backends; no golden project carries a GripHolder." },+ "A tiled terrain exports and imports its heightmap":+ { notCertifiable: "Covered by sdk/tests/terrain-tiled-sculpt.test.ts; an editor round trip of heightmap images that no packaged frame can show." },+ "Tiled terrain can be sculpted and painted":+ { notCertifiable: "Covered by sdk/tests/terrain-tiled-sculpt.test.ts and the terrain-open editor check; editing and saving happen in the editor, which a packaged game does not carry." },+ "A terrain can be kept as tiles":+ { notCertifiable: "Covered by sdk/tests/terrain-tiles.test.ts, pipeline/tests/terrain-tiles-split.test.ts and the terrain-open editor check (measured at 513, 2049 and 4097); no golden project carries a tiled terrain." },+ "A streamed world opens in the editor without its cells.":+ { notCertifiable: "An editor behaviour covered by desktop/tests/editor-cells.test.ts, editor-cells-world.test.ts and the world-edit-cells editor check; Play and export still see the whole world, so a packaged frame cannot tell." },+ "Hands that hold things.":+ { notCertifiable: "Covered by sdk/tests/grip-pose-wasm.test.ts and the grip-pose editor check on both backends; no golden project carries a GripPose." },+ "Clouds that keep time with the game.":+ { notCertifiable: "Covered by sdk/tests/sky-clock.test.ts and the sky-clouds editor check on both backends; a single golden frame cannot show clouds moving with the game clock." },+ "Ground that is a volume.":+ { notCertifiable: "Covered by sdk/tests/voxel-terrain-wasm.test.ts and the voxel-terrain editor check on both backends; no golden project carries a VoxelTerrain." },+ "What stands on the ground can blend into it.":+ { notCertifiable: "Covered by sdk/tests/road-decal.test.ts, sdk/tests/shader-twins.test.ts and the ground-blend editor check (blended seam, road and snow on both backends); no golden project carries ground-blend, a RoadDecal or snow." },+ "GPU particles can hit things":+ { notCertifiable: "Covered by sdk/tests/particle-collision-wasm.test.ts, particle-sdf-collision-wasm.test.ts, tests/particle/test_particle.cpp and the particle-gpu-collision editor check; the particles golden project uses no collision, sub-emitters or GPU trails." },+ "Plants can be touched, felled and harvested.":+ { notCertifiable: "Covered by sdk/tests/plant-interaction-wasm.test.ts and the plant-contact editor check; no golden project carries interactive plants." },+ "A side-on character comes ready to run and jump.":+ { notCertifiable: "Covered by sdk/tests/platformer-controller-2d-wasm.test.ts and the platformer-controller editor check; jumping and landing need input over time, which a golden frame does not drive." },+ "A 2D character can be rigged in the editor":+ { notCertifiable: "An editor tool covered by sdk/tests/rig2d.test.ts, desktop/tests/rig-view.test.ts and the rig-editor editor check; a packaged game carries the baked mesh and prefab, not the rig editor." },+ "2D bones can reach for things and follow each other.":+ { notCertifiable: "Covered by sdk/tests/rig2d-wasm.test.ts; no golden project carries IK2D or BoneConstraint2D." },+ "A tile layer can be dug, blown up and rebuilt":+ { notCertifiable: "Covered by sdk/tests/destructible-tilemap-wasm.test.ts; the tilemap golden project is static and changes nothing while it runs." },+ "Solid tile ground can have colliders only where it is exposed.":+ { notCertifiable: "Covered by sdk/tests/destructible-tilemap-wasm.test.ts; colliders are not drawn in a golden frame." },'Static geometry can be baked into material-preserving proxies.':{ notCertifiable: 'A pipeline bake covered by pipeline/tests/static-proxy.test.ts and tools/tests/static-proxy.e2e.mjs on both render backends; no golden project bakes a static proxy.' },'The cyber-rooftop example has an editable, anchored HUD.':diff --git a/tools/releaseNotes.mjs b/tools/releaseNotes.mjsindex 13fa4f29c..b7d7a2436 100644--- a/tools/releaseNotes.mjs+++ b/tools/releaseNotes.mjs@@ -28,6 +28,22 @@ export const NOTES_FLOOR = 'v0.65.0';* the reader recognises anyway.*/export const NOTED = {+ "feat(export): one decision for which Spine runtimes a package carries, with Include and Exclude per runtime":+ { note: "Which Spine runtimes a package carries can be set per runtime." },+ "feat(native): every Spine release in one native host, each skeleton read by its own":+ { note: "A native app plays every Spine version." },+ "feat(native): a template says which Spine runtime it links, and an export names the skeletons it cannot play":+ { note: "A native app plays every Spine version." },+ "fix(ecs): the native registry answers every entity op the web one does, from one generated table":+ { note: "Physics no longer stops on Android and the desktop host." },+ "feat(mcp): open_settings opens any settings page, and run_editor_command refuses an id that does not exist":+ { note: "An agent can open any Settings page." },+ "feat(settings): a row per Spine runtime — Auto, Include or Exclude — with what the build detected":+ { note: "Which Spine runtimes a package carries can be set per runtime." },+ "feat(settings): native packages carry every Spine release, so the Spine row only speaks up for an old template":+ { note: "Which Spine runtimes a package carries can be set per runtime." },+ "feat(settings): the Spine row says which version each native template links":+ { note: "Which Spine runtimes a package carries can be set per runtime." },'feat(cyber-rooftop): add Tripo equipment sockets and native character assets':{"internal":"the heroine and projector assets it added were removed again before release, since the cyber-rooftop scene never used them"},'fix(project): discard stale document reloads':