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.67.0
esengined0a41f0178d2
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 99ca44376..37c7d369b 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -14,6 +14,8 @@ published separately; it ships inside the editor.## [Unreleased]+## [0.67.0] - 2026-09-15+### Added- **A scene says how it is lit, and whether its light still describes it.** The@@ -79,55 +81,6 @@ published separately; it ships inside the editor.by hand can falsify it, where a solver built first would have nothing to saywhether it solved the right thing. Baking one is the next step.-### Fixed--- **The command line bakes the meshes a scene actually names.** An asset ref is- PROJECT-relative, and `bake-scene` resolved it against the scene's own folder —- so every object drawing a real `.esmesh` fell out of the bake with "draws no- mesh asset", and only scenes built from stock geometry came out lit. It now- resolves against the project root and reads `@uuid:` refs out of the `.meta`- index, which is what the editor's own collector does.--- **Both bake doors read a light the same way.** A spot's inner angle defaults to- 30 degrees, and the command line filled an unstated one in with 45. One reading- now serves both — the document's values over the component's own defaults —- along with one transform compose and one `.esprobes` writer. Three places where- the editor and CI could quietly disagree about the same scene.--- **A scene's ambient light reaches its bake.** `LightType.Ambient` is the third- value of the enum and `Spot` the fourth, and both bake collectors read the third- as a spot lamp — so the sky lit nothing it was not standing next to. An ambient- light occupies no slot and aims nowhere; it is now the bake's ambient term, the- way the renderer already folds it into its own. Outdoors this is most of the- indirect light there is: `physics-3d`'s probes go from black to carrying its- sky's blue.--- **A bake's products can be carried by a package.** `bake-scene` wrote the atlas- and nothing else — no `.meta`, so the cook had no identity to carry it by, and- the export said so in a warning nobody reads. The scene named an atlas the- package did not hold, and the room shipped unlit. The check now fails on a- product with no `.meta` and says which command mints one; the editor's own bake- already minted them.--- **A gather reads the lit side of a surface.** Light bounced off the BACK of a- wall as readily as off its front, because an atlas is per triangle and has no- side. A ray arriving at a face from behind now finds it unlit, which is what- keeps a probe standing behind a wall from being lit by what the wall hides.--- **A per-draw block reaches the draw that wrote it.** The pose of a skinned- draw, the shapes of a morphed one and (now) the indirect light of a probe-lit- one shared one buffer each, rewritten immediately before the draw that reads- it. That is correct where an upload takes effect at the call, and wrong on a- backend that QUEUES them: on WebGPU the writes land together when the pass is- submitted, so every draw in that pass read whatever the LAST of them wrote —- one pose on every character in the room, one set of shapes on every face.-- Every skin and morph gate in the suite drew a single object, so none of them- could see it. Each draw now takes a buffer of its own from a frame-scoped pool,- and a draw with nothing to say binds a zeroed block that is never written —- "none" as an object rather than an erasure someone has to remember to perform.- Two morphed draws in one frame, blended different amounts, is now a gate.-- **A room in the corpus is actually lit.** `physics-3d` — twenty-two boxes andtwo lamps — now ships with its lighting baked: an atlas beside the scene, and a`MeshLightmap` on every object saying where in it to read. It is the first@@ -287,6 +240,53 @@ published separately; it ships inside the editor.### Fixed+- **The command line bakes the meshes a scene actually names.** An asset ref is+ PROJECT-relative, and `bake-scene` resolved it against the scene's own folder —+ so every object drawing a real `.esmesh` fell out of the bake with "draws no+ mesh asset", and only scenes built from stock geometry came out lit. It now+ resolves against the project root and reads `@uuid:` refs out of the `.meta`+ index, which is what the editor's own collector does.++- **Both bake doors read a light the same way.** A spot's inner angle defaults to+ 30 degrees, and the command line filled an unstated one in with 45. One reading+ now serves both — the document's values over the component's own defaults —+ along with one transform compose and one `.esprobes` writer. Three places where+ the editor and CI could quietly disagree about the same scene.++- **A scene's ambient light reaches its bake.** `LightType.Ambient` is the third+ value of the enum and `Spot` the fourth, and both bake collectors read the third+ as a spot lamp — so the sky lit nothing it was not standing next to. An ambient+ light occupies no slot and aims nowhere; it is now the bake's ambient term, the+ way the renderer already folds it into its own. Outdoors this is most of the+ indirect light there is: `physics-3d`'s probes go from black to carrying its+ sky's blue.++- **A bake's products can be carried by a package.** `bake-scene` wrote the atlas+ and nothing else — no `.meta`, so the cook had no identity to carry it by, and+ the export said so in a warning nobody reads. The scene named an atlas the+ package did not hold, and the room shipped unlit. The check now fails on a+ product with no `.meta` and says which command mints one; the editor's own bake+ already minted them.++- **A gather reads the lit side of a surface.** Light bounced off the BACK of a+ wall as readily as off its front, because an atlas is per triangle and has no+ side. A ray arriving at a face from behind now finds it unlit, which is what+ keeps a probe standing behind a wall from being lit by what the wall hides.++- **A per-draw block reaches the draw that wrote it.** The pose of a skinned+ draw, the shapes of a morphed one and (now) the indirect light of a probe-lit+ one shared one buffer each, rewritten immediately before the draw that reads+ it. That is correct where an upload takes effect at the call, and wrong on a+ backend that QUEUES them: on WebGPU the writes land together when the pass is+ submitted, so every draw in that pass read whatever the LAST of them wrote —+ one pose on every character in the room, one set of shapes on every face.++ Every skin and morph gate in the suite drew a single object, so none of them+ could see it. Each draw now takes a buffer of its own from a frame-scoped pool,+ and a draw with nothing to say binds a zeroed block that is never written —+ "none" as an object rather than an erasure someone has to remember to perform.+ Two morphed draws in one frame, blended different amounts, is now a gate.+- **A hot reload no longer empties the running game of every resource**([#60](https://github.com/esengine/estella/issues/60)). Edit a script while thegame is playing and the editor re-imports the bundle and swaps the system@@ -12568,7 +12568,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.66.0...HEAD+[Unreleased]: https://github.com/esengine/estella/compare/v0.67.0...HEAD+[0.67.0]: https://github.com/esengine/estella/compare/v0.66.0...v0.67.0[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.0diff --git a/SECURITY.md b/SECURITY.mdindex 7bb73308c..c0ab24728 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.66.x | Yes |-| < 0.66 | No |+| 0.67.x | Yes |+| < 0.67 | 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 89b74039d..f8269406a 160000--- a/desktop+++ b/desktop@@ -1 +1 @@-Subproject commit 89b74039d21c455ea3e60dd1b4983380a1d6085e+Subproject commit f8269406a89222269b28193dbc6bc248bfb1da21diff --git a/package.json b/package.jsonindex 6b6efaf42..502dabe0b 100644--- a/package.json+++ b/package.json@@ -1,6 +1,6 @@{"name": "estella",- "version": "0.66.0",+ "version": "0.67.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 98ed5c52d..08813d069 100644--- a/tools/goldenProjects.mjs+++ b/tools/goldenProjects.mjs@@ -90,6 +90,31 @@ 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.67.0 —+ 'A mesh can be read through the light that was baked into it.': { certifies: 'lightmap' },+ 'The bake itself: lights become an atlas.': { certifies: 'lightmap' },+ 'A bounce carries the colour of what it came off.': { certifies: 'lightmap' },+ 'Stock geometry takes a bake, and the density suits this engine\'s units.':+ { certifies: 'lightmap' },+ 'A room in the corpus is actually lit.': { certifies: 'lightmap' },+ 'Light probes: what lights a thing a bake cannot hold still.': { certifies: 'light-probe' },+ 'A bake now solves the probes too, and refuses to light what moves.':+ { certifies: 'light-probe' },+ 'A model can be given somewhere to receive baked light.':+ { notCertifiable: 'the import setting that writes a second UV set into an .esmesh; the one'+ + ' scene that ships baked is built from stock geometry, whose UVs a bake derives per run,'+ + ' so no package carries an IMPORTED unwrap. unwrap.test.ts holds the layout, and'+ + ' check-import-settings holds that the setting has a reader' },+ 'Bake Lighting.':+ { notCertifiable: 'the editor command that triggers a bake — a package carries the atlas,'+ + ' never the menu item that wrote it, and that atlas is certified as lightmap. The'+ + ' end-to-end editor check bakes a real scene and reads the saved document back' },+ 'A scene says how it is lit, and whether its light still describes it.':+ { notCertifiable: 'a bake\'s INPUTS and whether they still match: the knobs change nothing a'+ + ' package draws, and staleness is a question only the editor asks. What ships is the'+ + ' light itself, certified as lightmap and light-probe, and the corpus-bake gate holds'+ + ' the committed atlas against a fresh bake so a stale one cannot pass as correct' },+// — 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' },@@ -169,9 +194,10 @@ export const SHIPPED = {// — 0.63.0 —'One number turns the sky, the irradiance and the reflection': { certifies: 'environment' },'A second UV set survives the import boundary':- { notCertifiable: 'a channel carried and deliberately unread — no lightmapper, no graph node,'- + ' no material change — so no game act can observe it; check-mesh-vocabulary holds the two'- + ' halves of the format and the .esmesh decode fixtures hold the bytes' },+ { notCertifiable: 'the channel a lightmap is read through. It has a reader now — the bake —'+ + ' but the one scene that ships baked is built from stock geometry, whose UVs a bake'+ + ' derives per run, so no package carries an IMPORTED unwrap; check-mesh-vocabulary holds'+ + ' the two halves of the format and the .esmesh decode fixtures hold the bytes' },'The camera a frame was drawn with is a value anyone can hold':{ notCertifiable: 'a publication the renderer makes for overlay authors; a game draws from the'+ ' resolve directly and never asks which camera a past frame used' },@@ -317,6 +343,7 @@ export const CAPABILITIES = ['spine', 'material', 'asset-lifecycle','model-import', 'model-animation', 'model-skinning','physics-3d', 'mesh-shadow', 'environment', 'level-of-detail', 'world-streaming',+ 'lightmap', 'light-probe','lighting-2d','sprite-sorting', 'sprite-mask', 'ui-widgets', 'velocity-motion','ssao', 'navigation-3d', 'root-motion', 'animation-events', 'shader-readiness',@@ -395,6 +422,13 @@ export const EVIDENCE = {// its world is cut and by carrying something that asks for places.'world-streaming': /\b(StreamedWorld|WorldStreamingSource)\b/,environment: /\.esenv\b/,+ // The component that names a patch, not the atlas file beside the scene: a+ // scene carrying one draws light a bake wrote, so a bake that stops writing+ // changes the picture the suite compares.+ lightmap: /\bMeshLightmap\b/,+ // The volume, which is where a MOVING thing takes its indirect light from —+ // the half of a bake no atlas can hold.+ 'light-probe': /\bLightProbeVolume\b/,// The post effect a scene turns on, not the pass that implements it.ssao: /"type":\s*"ssao"/,'navigation-3d': /\b(NavVolume|NavLink|NavAgent3D)\b/,@@ -554,7 +588,10 @@ export const GOLDEN = [},{id: 'physics-3d',- certifies: ['physics-3d'],+ // Also the only scene that ships its lighting baked: an atlas its surfaces+ // read and a volume its thirteen moving bodies take their indirect light+ // from. Both halves of a bake are in the picture the suite compares.+ certifies: ['physics-3d', 'lightmap', 'light-probe'],targets: ['web', 'desktop'],tier: 'nightly',// The character walks on the key it declares, and the debug overlay it draws