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.

docs(changelog): cut the notes for 0.65.0

esenginee52134f76a16
diff --git a/CHANGELOG.md b/CHANGELOG.md
index b114862c8..885809e11 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -14,8 +14,18 @@ published separately; it ships inside the editor.
## [Unreleased]
+## [0.65.0] - 2026-09-13
+
### Added
+- **A spatial source's reach is drawn.** `AudioSource.minDistance` and
+ `maxDistance` each declared a sphere and the viewport drew neither, so how far
+ a sound carries was two numbers in the Inspector with nothing on screen to
+ measure them against. Two spheres rather than one: full volume inside the
+ first, inaudible past the second, and the fall-off between them is all either
+ number means. A source that is not spatial gets none, the way a global
+ PostProcessVolume gets no box — it is heard the same everywhere.
+
- **The outliner switches an entity off.** Right-click → Disable writes the
engine's `Disabled` tag onto that entity, and the row is struck through — the
eye beside it means something else, and always did: hiding stops the drawing
@@ -132,6 +142,30 @@ published separately; it ships inside the editor.
authors the clip, the distances and `playOnAwake`, and the code only moves the
entity.
+### Changed
+
+- **A playable ships its game deflated.** The engine's glue and its wasm already
+ travelled compressed; the game's own bundle — the largest span in the page —
+ travelled as source, and against the 2MB cap the strictest network enforces
+ that is the difference between fitting and not. The corpus's biggest playable
+ had crossed it, at 2.10MB. The bundle packs like everything else now, and a 3KB
+ loader starts it through the same blob script the engine module already needs,
+ so a page that can boot a playable at all can boot this one — nothing new to
+ allow, no `eval`. That playable is 1.56MB.
+
+- **The audio demo authors its beat's clip on an `AudioSource`.** Which sound the
+ beat is now comes from the scene rather than a path in code, so the asset system
+ brings the clip in with the scene the way a game's own audio arrives. No example
+ or template scene used `AudioSource` at all — the engine's own audio component had
+ no coverage in the shipped corpus, which is the door #59's silence came in by.
+
+- **The hot-update demo now ships a real 分包.** Its two groups take the two modes
+ their flows need: `cdn` stays remote, because a hot update has to replace it after
+ the game shipped, and `pack` — the DLC tile strip the *下载资源包* button pulls on
+ demand — is a subpackage, which is what shipping optional content inside a
+ mini-game package means. Nothing in the corpus delivered a group lazily before, so
+ no project produced a subPackage root for anyone to check.
+
### Removed
- **`CacheAsBitmap` and the bitmap-cache helpers.** The component, `CacheBitmap`,
@@ -144,7 +178,6 @@ published separately; it ships inside the editor.
check-component-fields' declared gaps were this component's fields, and that
list is now empty.
-
### Fixed
- **A spatial source is heard where it IS.** Audio read `Transform.position` —
@@ -194,23 +227,6 @@ published separately; it ships inside the editor.
Nothing could have found this before a real root existed — the check never got far
enough to run.
-### Changed
-
-- **The audio demo authors its beat's clip on an `AudioSource`.** Which sound the
- beat is now comes from the scene rather than a path in code, so the asset system
- brings the clip in with the scene the way a game's own audio arrives. No example
- or template scene used `AudioSource` at all — the engine's own audio component had
- no coverage in the shipped corpus, which is the door #59's silence came in by.
-
-- **The hot-update demo now ships a real 分包.** Its two groups take the two modes
- their flows need: `cdn` stays remote, because a hot update has to replace it after
- the game shipped, and `pack` — the DLC tile strip the *下载资源包* button pulls on
- demand — is a subpackage, which is what shipping optional content inside a
- mini-game package means. Nothing in the corpus delivered a group lazily before, so
- no project produced a subPackage root for anyone to check.
-
-### Fixed
-
- **A folder that is no longer a 分包 stops being declared as one.** A group is a
name plus a delivery, and the name outlives the delivery: a folder marked
*always include* keeps its group after its mode goes back to local. The WeChat
@@ -11998,7 +12014,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.64.0...HEAD
+[Unreleased]: https://github.com/esengine/estella/compare/v0.65.0...HEAD
+[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
[0.62.0]: https://github.com/esengine/estella/compare/v0.61.0...v0.62.0
diff --git a/SECURITY.md b/SECURITY.md
index a29324582..c00961f59 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.64.x | Yes |
-| < 0.64 | No |
+| 0.65.x | Yes |
+| < 0.65 | 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 913059601..36735ae4c 160000
--- a/desktop
+++ b/desktop
@@ -1 +1 @@
-Subproject commit 9130596018cf0f03658b6806decb6dc8a3fde00f
+Subproject commit 36735ae4cd3c924a4b7efa35337beda45b41c912
diff --git a/package.json b/package.json
index 1e22e39fd..3586238d9 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "estella",
- "version": "0.64.0",
+ "version": "0.65.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 c4f5eea92..30bd2d614 100644
--- a/tools/goldenProjects.mjs
+++ b/tools/goldenProjects.mjs
@@ -89,6 +89,38 @@ 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.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' },
+ 'The UI controls demo authors its widgets instead of building them.': { certifies: 'ui-widgets' },
+ 'A 3D body is the shape its collider names.': { certifies: 'physics-3d' },
+ 'Every 3D collider shape and joint, authored in a scene.': { certifies: 'physics-3d' },
+ 'Every 2D collider shape and joint, authored in a scene.': { certifies: 'physics' },
+ 'A sorting group in the sprite demo.': { certifies: 'sprite-sorting' },
+ 'Six components a shipped scene now authors.': { certifies: 'sprite-mask' },
+ 'The starfield drifts by `Velocity`.': { certifies: 'velocity-motion' },
+ 'A spatial source\'s reach is drawn.':
+ { notCertifiable: 'a shape in the EDITOR viewport — a game draws no gizmos, so no package'
+ + ' can show it; check-gizmo-coverage holds that the extent is drawn at all and'
+ + ' gizmo-chrome measures the ink in a real editor' },
+ 'The outliner switches an entity off.':
+ { notCertifiable: 'an editor panel over the tag; what the tag DOES is the entry below,'
+ + ' and the entity-disable check drives this door end to end' },
+ 'A disabled entity is actually skipped.':
+ { notCertifiable: 'no certified project switches anything off — the one scene that does is'
+ + ' enemy-ai-3d, which is not one. Held by sdk/tests/disabled-entities.test.ts and the'
+ + ' entity-disable editor check, which watches a query answer without the subtree' },
+ 'A joint\'s anchors say whose body they are on.':
+ { notCertifiable: 'Inspector prose over fields a package already carries; what the anchors'
+ + ' place is certified as physics and physics-3d' },
+ 'A bitmap font is an asset the editor knows.':
+ { notCertifiable: 'an editor type, and the corpus\'s only bitmap font is the pixel-RPG'
+ + ' TEMPLATE\'s — a template is not a certified project. check-asset-vocabulary holds the'
+ + ' type against what an import writes' },
+ 'A build keeps the page a bitmap font names.':
+ { notCertifiable: 'as above: the font that proves it lives in a template, so no certified'
+ + ' package carries one. pipeline/tests/document-ref-cook-deps.test.ts holds the edge' },
+
// — 0.64.0 —
'A 2D light can take the shape of a texture': { certifies: 'lighting-2d' },
'A 2D light can be shaped, and its shadows can be less than total': { certifies: 'lighting-2d' },
@@ -262,7 +294,7 @@ export const CAPABILITIES = [
'model-import', 'model-animation', 'model-skinning',
'physics-3d', 'mesh-shadow', 'environment', 'level-of-detail', 'world-streaming',
'lighting-2d',
- 'sprite-sorting', 'sprite-mask',
+ 'sprite-sorting', 'sprite-mask', 'ui-widgets', 'velocity-motion',
'ssao', 'navigation-3d', 'root-motion', 'animation-events', 'shader-readiness',
'tilemap', 'tile-collision',
'touch', 'safe-area', 'pause-resume',
@@ -297,6 +329,13 @@ export const EVIDENCE = {
// (`"order": 0`) as well as one set in code.
'sprite-sorting': /\border"?:\s*\d|\bSortingGroup\b/,
'sprite-mask': /\bSpriteMask\b/,
+ // The composite controls, as opposed to the boxes they are laid out in: a
+ // scene that carries one has taken the editor's Create → UI path.
+ 'ui-widgets': /\b(UIToggle|UISlider|UIDropdown|UIDialog|UIScroll)\b/,
+ // Motion with no physics body behind it. `\b` keeps `linearVelocity` out —
+ // a body's own speed is physics, and this is the component that moves a
+ // transform without one.
+ 'velocity-motion': /\bVelocity\b/,
// Components OR the resource: audio-demo takes Res(Audio) and never inserts a
// component, and a pattern that only knew the components read it as unused.
audio: /\b(AudioSource|AudioListener|AudioAPI|audioPlugin)\b|Res\(Audio\)/,
@@ -407,7 +446,7 @@ export const GOLDEN = [
// Its hull bar is a sprite cut by another sprite, drawn at an order it states
// rather than at the one its position would give it — so the draw order and the
// mask are both something a packaged game here actually does.
- certifies: ['ecs', 'texture-atlas', 'sprite-sorting', 'sprite-mask'],
+ certifies: ['ecs', 'texture-atlas', 'sprite-sorting', 'sprite-mask', 'velocity-motion'],
targets: ['web', 'desktop', 'android'],
tier: 'pr',
interact: { keys: ['ArrowLeft'], frames: 40 },
@@ -512,7 +551,7 @@ export const GOLDEN = [
},
{
id: 'ui-controls',
- certifies: ['ui-layout', 'text'],
+ certifies: ['ui-layout', 'text', 'ui-widgets'],
targets: ['web', 'desktop'],
tier: 'pr',
// Opens the modal — a whole-panel change, so the response is unmistakable.
@@ -567,8 +606,8 @@ export const GOLDEN = [
{
id: 'video-puzzle',
// `startup-size` was a declared gap while the runtime floor (2.8MB) exceeded
- // the 2MB cap; it is 1.38MB empty now and this packages at 1.78MB — the
- // biggest playable in the corpus, not the smallest thing that would pass.
+ // the 2MB cap; this packages at 1.56MB — the biggest playable in the corpus,
+ // not the smallest thing that would pass.
certifies: ['single-file', 'startup-size'],
targets: ['playable', 'web'],
tier: 'nightly',