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
docs(changelog): cut the notes for 0.65.0
esenginee52134f76a16
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 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 theengine's `Disabled` tag onto that entity, and the row is struck through — theeye 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 theentity.+### 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 thatlist 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 farenough 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 aname 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 firstcommit 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.0diff --git a/SECURITY.md b/SECURITY.mdindex 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 matchingthe version being shipped, so it cannot quietly fall behind again.diff --git a/desktop b/desktopindex 913059601..36735ae4c 160000--- a/desktop+++ b/desktop@@ -1 +1 @@-Subproject commit 9130596018cf0f03658b6806decb6dc8a3fde00f+Subproject commit 36735ae4cd3c924a4b7efa35337beda45b41c912diff --git a/package.json b/package.jsonindex 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.mjsindex 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',