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.

chore: release 0.66.0

esengine94d96eb636d7
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 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 than
dropped.
+- **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 nothing
outside 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 first
commit 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.0
diff --git a/SECURITY.md b/SECURITY.md
index 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 matching
the version being shipped, so it cannot quietly fall behind again.
diff --git a/desktop b/desktop
index 128f90880..488da0fe0 160000
--- a/desktop
+++ b/desktop
@@ -1 +1 @@
-Subproject commit 128f90880c44e8561c1afed7ed6b73142d349dcb
+Subproject commit 488da0fe02ee82a0ceafa7a57a8a7fe9beba0ae4
diff --git a/package.json b/package.json
index 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.mjs
index 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',
};