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 for v0.22.0
yhhff903d60b03c
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 4bc93d54f..638e4780c 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -14,6 +14,120 @@ published separately; it ships inside the editor.## [Unreleased]+## [0.22.0] - 2026-07-13++Light gets physical: an opt-in linear-light pipeline decodes sRGB in hardware,+runs the post-process chain on HDR float targets, and makes bright lights+actually bloom. Sprite animation becomes first-class authoring — slice a sheet+into a flipbook in the new Flipbook editor, drop it into the scene as a posed+animated sprite, and drive it from the FSM without a line of code. Audio grows+a real mixer (per-bus effect chains, sidechain ducking, a Mixer panel, MP3+cooks), and the physics editor catches up with its runtime: every joint draws+in the viewport, and anchors and slide axes edit by direct drag.++### Added++- **Linear-light rendering.** Set **Project Settings → Rendering → Color Space**+ to *Linear* and the whole frame computes in linear light: color textures+ upload as sRGB and decode in hardware (KTX2 compressed textures transcode to+ sRGB variants), tints and light colors linearize, post-process intermediates+ blend without shadow banding, and the final blit performs the one+ linear-to-sRGB encode. The setting persists in the project and boots every+ runtime the same way — the editor viewport, Play, web/desktop exports,+ playables, and WeChat. The default stays *Gamma*: existing projects render+ byte-identical until they opt in.+- **HDR post-processing.** Under linear color, the post-process chain upgrades+ its intermediate targets to 16-bit float wherever the device supports it+ (always on WebGPU; via `EXT_color_buffer_float` on WebGL2, with a graceful+ LDR fallback). Light accumulation past 1.0 survives into the effect chain:+ bloom's bright-pass sees real over-range energy, tonemap receives true HDR,+ and the bloom threshold now reaches 2 — set it above 1 and only over-range+ light blooms, the classic emissive-glow setup.+- **Flipbook editor.** Sprite-sheet animation gets its own asset type and a+ dedicated panel: a sheet canvas with a slicing grid (click or drag cells to+ append frames), a frame strip with per-frame durations and drag reordering,+ fps/loop controls, and a live looping preview. **Create Sprite Animation** on+ any texture guesses the grid from the image and produces a ready `.esanim`+ clip; sheet-cell frames re-slice consistently when the grid changes, and+ legacy per-texture clips stay valid.+- **Animated sprites in one step.** **Create Animated Sprite** on a `.esanim`+ (or dropping one into the viewport) spawns a complete entity — Transform,+ Sprite, SpriteAnimator — posed at frame 0, in one undoable step. Selected+ flipbooks loop live in the viewport without entering Play, and when the same+ clip is open in the Flipbook editor the preview follows your edits as you+ make them.+- **Code-free animation states.** FSM and behavior-tree actions now take an+ optional argument, and four `spriteAnim.*` built-ins mirror the `timeline.*`+ family: `spriteAnim.play` (the argument picks the clip), `.restart`, `.stop`,+ and a `spriteAnim.finished` condition with a formal replay contract.+ Idle/run/attack switching is now pure `.esfsm` data on the FSM canvas.+- **An audio mixer, end to end.** Buses gain a real DSP topology — declarative+ per-bus effect inserts (biquad filters, convolution reverb, compressor) and+ sidechain ducking (`duck music by voice`) that never fights the user's volume+ setting. The project mix persists in the manifest and boots identically in+ the editor, Play, and every export; the new **Audio Mixer** bottom-dock panel+ edits it live — one strip per bus with fader, mute, insert chain, duck rule,+ and custom bus management.+- **Audio import pipeline.** Selecting an audio asset shows a decoded waveform+ with play/pause and click-to-seek plus format details. A **Compress Audio**+ package option re-encodes `.wav` sources to MP3 at cook time (per-asset+ Import Settings override the global switch — seamless-loop clips can opt out+ of MP3's encoder-delay seam); already-compressed formats pass through.+- **Physics editing in the viewport.** The physics gizmo family fills out:+ one-way platforms draw their solid-side arrow, all six joint components draw+ anchor-to-anchor links with draggable anchor dots, motor joints show their+ target-velocity arrow, prismatic/wheel joints show the slide axis with a+ re-aim handle, and particle emitters preview their `angleSpread` aim wedge.+ Anchors and axes edit by direct drag in the owning body's frame; collider+ handles now measure from the offset shape center. The show flag is labeled+ **Physics**, and the physics showcase gains a spring piston (prismatic joint+ in action).+- **Smarter FSM/BT pickers.** Action and condition fields upgrade from bare+ text inputs to grouped suggestions: project names lead, built-ins group under+ their namespace with localized descriptions, and the keyboard drives the+ whole popover. Action nodes no longer suggest conditions (and vice versa).+- **Tilemap ellipse tool + saved stamps.** Ellipse (**O**) fills the inscribed+ ellipse of a dragged box in one undo step, with the classic pixel-circle+ shape correction. A saved-stamp strip bookmarks the current brush per+ project — auto-named chips with pattern previews, click to recall, identical+ patterns dedupe.++### Changed++- **`.esanim` and `.estimeline` part ways.** `.esanim` is now exclusively the+ flipbook format with its own editor; the Sequencer keeps `.estimeline`, and+ **New Animation** creates a `.estimeline` instead of disguising a multi-track+ timeline as a flipbook. Existing files of both types stay valid.+- The three audio extension lists (SDK registry, runtime loader, editor tiles)+ unify on one set: `mp3 / wav / ogg / aac / flac / m4a / webm`.++### Fixed++- **WebGPU bind groups could go stale.** The bind-group cache keyed entries by+ resource handles that emscripten reuses immediately after release, so+ create/destroy churn could make a draw read a *deleted* resource's bindings —+ post-process passes read other passes' parameters, which silently blanked the+ whole WGSL bloom chain. Deleting a buffer or texture now evicts every cached+ group that references it, and the four bloom scenes joined CI on both+ backends to keep it that way.+- **Editing a joint no longer corrupts its connected body.** The editor's+ reconciler copied entity-reference fields verbatim across two id domains, so+ the first edit of any joint silently re-pointed `connectedEntity` at an+ arbitrary entity. References now remap on both edit and respawn (undo of a+ delete restores joint wiring correctly).+- **Kawase blur is backend-identical.** Post-process chain targets switch to+ bilinear sampling: the blur's half-texel taps landed exactly on texel+ boundaries under nearest filtering, whose rounding is backend-dependent — GL+ and WebGPU visibly diverged. Bloom falloff now measures byte-identical across+ backends in both color spaces.+- **`.esanim` texture dependencies now enter the cook.** Clips' sheet textures+ were invisible to the build's dependency scan, and anim-clip/timeline+ component slots matched no editor asset type so their pickers offered+ nothing. Both fixed by the flipbook split.+- **Audio preview is audible again.** The editor's CSP never allowed+ `estella://` media, so every `<audio>` element — including the double-click+ preview — was silently blocked.+## [0.21.0] - 2026-07-13Estella speaks your language: the editor UI ships in English and 简体中文, and game@@ -493,7 +607,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.21.0...HEAD+[Unreleased]: https://github.com/esengine/estella/compare/v0.22.0...HEAD+[0.22.0]: https://github.com/esengine/estella/compare/v0.21.0...v0.22.0[0.21.0]: https://github.com/esengine/estella/compare/v0.20.0...v0.21.0[0.20.0]: https://github.com/esengine/estella/compare/v0.19.0...v0.20.0[0.19.0]: https://github.com/esengine/estella/compare/v0.18.0...v0.19.0