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 0.66.0
esengine94d96eb636d7
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 4f4f748a4..d8c3a8a92 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -14,6 +14,8 @@ published separately; it ships inside the editor.## [Unreleased]+## [0.66.0] - 2026-09-14+### Added- **A model brings the shapes it can be blended towards.** A glTF morph target@@ -160,6 +162,39 @@ published separately; it ships inside the editor.a clip already typed is carried into the blend as its first stop rather thandropped.+- **A step of gameplay nobody has seen yet, and can take it back.** A small+ mutation can now be expressed as begin → mutate → commit or abandon, with+ nothing left behind when it is abandoned — and the three ways a step leaks fail+ differently, so each is closed where it happens. Structural change goes to a+ command queue the scope owns and flushes only on commit, so an abandoned step+ never allocates an identity; events sit in the write half of their bus until+ the next swap, where a watermark un-writes them; values are copied on first+ touch, and the first touch is where the HANDLE leaves rather than where the+ write lands, because script storage hands out the stored object itself.++ It arrives as a service, not as new vocabulary: `Res(Speculation)` hands a+ system its scope the way `Res(Time)` hands it the clock. A parameter kind+ would have changed `SystemParam` and `InferParam`, both frozen — the freeze bar+ refused it, and the refusal was right. 570 public promises kept.++- **A step can be asked whether it is a function of the world.** The engine+ already replays: a replication client rebuilds an owned entity from authority+ plus its unacknowledged inputs, and that only works if a predicted step depends+ on nothing but world state, actions and dt. A step that reads a clock or a+ random source breaks the promise and stays green until a client desyncs+ somewhere nobody is looking.++ `replay` asks the question rather than adding a second answer. It runs the step+ twice through the speculation scope and compares the three surfaces that scope+ already aligns — where every touched component was left, what the command queue+ holds, what was announced — then takes both runs back, so asking costs the+ world nothing. A step that wanders in values, in structure or in what it+ announces is reported unstable **with the surface named**.++ `predictionReplays` puts the same machine beside `PredictionOptions.apply`,+ whose doc comment has always carried that promise with nothing able to report+ it broken. A game can now hold its own rule from its own test.+### Changed- **A state says what it plays one way, from the file in.** A controller written@@ -212,6 +247,31 @@ published separately; it ships inside the editor.- **`isBlend1D` was never on the public surface** while its twin was, so nothingoutside the SDK could ask which of the two a motion is.+- **An unexpected error no longer takes the editor with it.** The handler that+ exists so the editor keeps running long enough to save your work put up a+ modal dialog to say so — and a modal dialog holds the main process until+ someone clicks it. Every menu, every panel and every save queued behind it+ while the window carried on drawing frames, so the editor looked alive and+ answered nothing. Only a dialog attached to a window is safe; without one it+ goes application-modal and blocks just the same, so a windowless process now+ takes the log entry alone.++ What raised those errors was the project watcher. `fs.watch` takes no exclude+ list, so watching the project root necessarily descends into `.esengine/play`,+ which is rebuilt from scratch on every Play — and a directory deleted mid-scan+ throws from inside the watcher's own callback, where no caller can catch it.+ The ignore rule that was meant to cover it filters events, and the descent+ happens before any event exists. Each top-level content directory is now+ watched in its own right, which puts the rule where the descent is.++- **`step` reports the frames that ran, not the number it was asked for.** The+ reply restated the request, so a realm that gave up part way through was+ indistinguishable from one that finished — and a driver reading the world+ afterwards blamed whatever it found. It now carries the realm's own count and+ frame clock. The bail-out behind it was 30 seconds under a comment calling it+ generous for 600 frames of gameplay; on a software rasteriser a 210-frame 3D+ step takes closer to four minutes.+## [0.65.0] - 2026-09-13### Added@@ -12212,7 +12272,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.65.0...HEAD+[Unreleased]: https://github.com/esengine/estella/compare/v0.66.0...HEAD+[0.66.0]: https://github.com/esengine/estella/compare/v0.65.0...v0.66.0[0.65.0]: https://github.com/esengine/estella/compare/v0.64.0...v0.65.0[0.64.0]: https://github.com/esengine/estella/compare/v0.63.0...v0.64.0[0.63.0]: https://github.com/esengine/estella/compare/v0.62.0...v0.63.0diff --git a/SECURITY.md b/SECURITY.mdindex c00961f59..7bb73308c 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.65.x | Yes |-| < 0.65 | No |+| 0.66.x | Yes |+| < 0.66 | 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 128f90880..488da0fe0 160000--- a/desktop+++ b/desktop@@ -1 +1 @@-Subproject commit 128f90880c44e8561c1afed7ed6b73142d349dcb+Subproject commit 488da0fe02ee82a0ceafa7a57a8a7fe9beba0ae4diff --git a/package.json b/package.jsonindex 3586238d9..6b6efaf42 100644--- a/package.json+++ b/package.json@@ -1,6 +1,6 @@{"name": "estella",- "version": "0.65.0",+ "version": "0.66.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 858ed9be2..72159a0c0 100644--- a/tools/goldenProjects.mjs+++ b/tools/goldenProjects.mjs@@ -89,6 +89,29 @@ export const CENSUS_FLOOR = '0.60.0';* that does not exist, and release notes are a different act. Theirs is ungated.*/export const SHIPPED = {+ // — 0.66.0 —+ 'A model brings the shapes it can be blended towards.': { certifies: 'morph-target' },+ 'A controller is a stack of machines, not one.': { certifies: 'animation-layers' },+ 'A layer writes the part of the rig it was given.': { certifies: 'animation-layers' },+ 'The third-person rig runs and swings at the same time.': { certifies: 'animation-layers' },+ 'A blend mixes its neighbours instead of picking one.': { certifies: 'animation-blend' },+ 'A blend over a plane.': { certifies: 'animation-blend-2d' },+ 'A clip means the same thing on a rig bound differently.': { certifies: 'animation-retarget' },+ 'One clip drives rigs that do not share its bone names.': { certifies: 'animation-retarget' },+ 'The posed skeleton can be made to reach something.': { certifies: 'animation-ik' },+ 'A blend is something an author can make.':+ { notCertifiable: 'the editor\'s motion picker — a game ships the blend, never the panel that'+ + ' made it, and what the panel produces is certified as animation-blend. The animator'+ + ' editor checks drive this door against a real editor' },+ 'A step of gameplay nobody has seen yet, and can take it back':+ { notCertifiable: 'a scope a GAME opens around its own mutation: nothing is left behind when'+ + ' it is abandoned, so a package that used it would look exactly like one that did not.'+ + ' Held by the speculation clauses, which check all three ways a step leaks' },+ 'A step can be asked whether it is a function of the world.':+ { notCertifiable: 'a question asked in a test, and both runs are taken back — a game that'+ + ' asks it plays the same as one that does not. multiplayer-arena\'s applyMove is'+ + ' module-local game code, so a game holds its own rule from its own test' },+// — 0.65.0 —'A spatial source you can hear in the audio demo.': { certifies: 'audio' },'A ScrollView scrolls where the editor drops it.': { certifies: 'ui-widgets' },@@ -297,7 +320,7 @@ export const CAPABILITIES = ['sprite-sorting', 'sprite-mask', 'ui-widgets', 'velocity-motion','ssao', 'navigation-3d', 'root-motion', 'animation-events', 'shader-readiness','animation-layers', 'animation-ik', 'morph-target',- 'animation-blend', 'animation-retarget',+ 'animation-blend', 'animation-blend-2d', 'animation-retarget','tilemap', 'tile-collision','touch', 'safe-area', 'pause-resume','texture-atlas',@@ -359,6 +382,7 @@ export const EVIDENCE = {// A motion that MIXES rather than picks. The kind, not the word "blend": a// state named "Blend" proves nothing, and the kind is what the runtime reads.'animation-blend': /"kind"\s*:\s*"blend[12]d"/,+ 'animation-blend-2d': /"kind"\s*:\s*"blend2d"/,// A controller that says which skeleton its clips came from. The reference,// not the file: an `.esavatar` nothing points at retargets nothing.'animation-retarget': /"avatar"\s*:\s*"[^"]+\.esavatar"/,@@ -430,6 +454,10 @@ export const KNOWN_GAPS = {+ 'the editor generates an avatar from a rig — but every rigged model in the corpus is '+ 'authored against its OWN clips, so nothing here plays a clip made for another skeleton: '+ 'certifying it needs a second rig whose bones are named differently',+ 'animation-blend-2d': 'blend2d places its stops on a plane and the editor authors them, but '+ + 'every animator in the corpus blends along ONE parameter: third-person-3d picks its gait by '+ + 'speed alone. Certifying it needs a rig whose motion answers to two at once — '+ + 'speed and direction, or aim pitch and yaw. `animation-blend` is the line, not the plane',subpackage: 'hot-update-demo delivers `pack` as a 分包 and its button loads it, but no tier builds that project for a mini-game host — the vendor download itself is verified by hand in devtools',};