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: prepare v0.97.0 release

yhh0bc1b6ddbebe
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6a8409f43..cb16bb8ae 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -14,6 +14,8 @@ published separately; it ships inside the editor.
## [Unreleased]
+## [0.97.0] - 2026-10-31
+
### Added
- **Rich text reads the tags other engines write.** `<size=24>…</size>`, a colour by name (`<color=red>`), and `<br/>` now work beside `<color=#RRGGBB>`, `<font size=…>`, `<b>` and `<i>`. `<u>`, `<s>`, `<outline …>` and `<on click=…>` are accepted so text written for another engine shows no raw tags: the words are kept, the underline, outline and click are not drawn. Unknown tags still show as text.
@@ -15027,7 +15029,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.96.0...HEAD
+[Unreleased]: https://github.com/esengine/estella/compare/v0.97.0...HEAD
+[0.97.0]: https://github.com/esengine/estella/compare/v0.96.0...v0.97.0
[0.96.0]: https://github.com/esengine/estella/compare/v0.95.0...v0.96.0
[0.95.0]: https://github.com/esengine/estella/compare/v0.94.0...v0.95.0
[0.94.0]: https://github.com/esengine/estella/compare/v0.93.0...v0.94.0
diff --git a/SECURITY.md b/SECURITY.md
index f57803f8e..4d4a0aa08 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.96.x | Yes |
-| < 0.96 | No |
+| 0.97.x | Yes |
+| < 0.97 | 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 6e0584037..32cbb42cf 160000
--- a/desktop
+++ b/desktop
@@ -1 +1 @@
-Subproject commit 6e0584037844fe01228972ccd3e8088afc17576a
+Subproject commit 32cbb42cf5c6b08b063a1587073886aae0acbe65
diff --git a/package.json b/package.json
index e0f907a91..b954f771a 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "estella",
- "version": "0.96.0",
+ "version": "0.97.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 68dfbc170..e788a3500 100644
--- a/tools/goldenProjects.mjs
+++ b/tools/goldenProjects.mjs
@@ -936,6 +936,128 @@ export const SHIPPED = {
{ notCertifiable: "A planet-world feature, covered by its unit tests and the render-scene gates; no golden project carries a planet, and one packaged frame cannot decide a result that depends on the device." },
"Height Fog by height above a planet.":
{ notCertifiable: "A planet-world feature, covered by its unit tests and the render-scene gates; no golden project carries a planet, and one packaged frame cannot decide a result that depends on the device." },
+ "Rich text reads the tags other engines write.":
+ { notCertifiable: "A UI behaviour, covered by its unit tests; no golden project uses it, and a packaged launch frame does not drive it." },
+ "Scroll areas can be pulled past an end and spring back.":
+ { notCertifiable: "A UI behaviour, covered by its unit tests; no golden project uses it, and a packaged launch frame does not drive it." },
+ "More easing curves.":
+ { notCertifiable: "A UI behaviour, covered by its unit tests; no golden project uses it, and a packaged launch frame does not drive it." },
+ "World content has a rectangle: `ContentRect`.":
+ { notCertifiable: "A rendering feature, covered by its unit tests and the render-scene pixel gates where it draws; no golden project places it, and one packaged frame cannot decide a result that depends on the device." },
+ "Edited Cocos documents move to RectAnchors.":
+ { notCertifiable: "Cocos Creator project conversion, covered by the converter's unit tests and the editor suite; no golden project is a converted Cocos project, so no packaged frame can decide it." },
+ "RectAnchors: world content that follows its parent.":
+ { notCertifiable: "Cocos Creator project conversion, covered by the converter's unit tests and the editor suite; no golden project is a converted Cocos project, so no packaged frame can decide it." },
+ "A converted Cocos project fits the screen as the game does.":
+ { notCertifiable: "Cocos Creator project conversion, covered by the converter's unit tests and the editor suite; no golden project is a converted Cocos project, so no packaged frame can decide it." },
+ "A Cocos node layer is its renderers layer.":
+ { notCertifiable: "Cocos Creator project conversion, covered by the converter's unit tests and the editor suite; no golden project is a converted Cocos project, so no packaged frame can decide it." },
+ "A converted Cocos project starts as the game does.":
+ { notCertifiable: "Cocos Creator project conversion, covered by the converter's unit tests and the editor suite; no golden project is a converted Cocos project, so no packaged frame can decide it." },
+ "Cocos layer components survive a replay.":
+ { notCertifiable: "Cocos Creator project conversion, covered by the converter's unit tests and the editor suite; no golden project is a converted Cocos project, so no packaged frame can decide it." },
+ "A material colour is the renderer tint.":
+ { notCertifiable: "A rendering feature, covered by its unit tests and the render-scene pixel gates where it draws; no golden project places it, and one packaged frame cannot decide a result that depends on the device." },
+ "Mesh renderers and materials in the Cocos layer.":
+ { notCertifiable: "Cocos Creator project conversion, covered by the converter's unit tests and the editor suite; no golden project is a converted Cocos project, so no packaged frame can decide it." },
+ "More of `cc`.":
+ { notCertifiable: "Cocos Creator project conversion, covered by the converter's unit tests and the editor suite; no golden project is a converted Cocos project, so no packaged frame can decide it." },
+ "The script bundle is not rebuilt for nothing.":
+ { notCertifiable: "Editor or tooling behaviour rather than a rendered game capability; its own suites check it." },
+ "Two Cocos classes with one name.":
+ { notCertifiable: "Cocos Creator project conversion, covered by the converter's unit tests and the editor suite; no golden project is a converted Cocos project, so no packaged frame can decide it." },
+ "Large projects open faster.":
+ { notCertifiable: "Editor or tooling behaviour rather than a rendered game capability; its own suites check it." },
+ "A model texture the project does not have is left off.":
+ { notCertifiable: "A rendering feature, covered by its unit tests and the render-scene pixel gates where it draws; no golden project places it, and one packaged frame cannot decide a result that depends on the device." },
+ "An unlit mesh variant with tangents links.":
+ { notCertifiable: "A rendering feature, covered by its unit tests and the render-scene pixel gates where it draws; no golden project places it, and one packaged frame cannot decide a result that depends on the device." },
+ "Cocos scripts load one by one.":
+ { notCertifiable: "Cocos Creator project conversion, covered by the converter's unit tests and the editor suite; no golden project is a converted Cocos project, so no packaged frame can decide it." },
+ "A converted Cocos project links its images.":
+ { notCertifiable: "Cocos Creator project conversion, covered by the converter's unit tests and the editor suite; no golden project is a converted Cocos project, so no packaged frame can decide it." },
+ "A Cocos conversion shows its progress.":
+ { notCertifiable: "Cocos Creator project conversion, covered by the converter's unit tests and the editor suite; no golden project is a converted Cocos project, so no packaged frame can decide it." },
+ "Bursts on a schedule.":
+ { notCertifiable: "A rendering feature, covered by its unit tests and the render-scene pixel gates where it draws; no golden project places it, and one packaged frame cannot decide a result that depends on the device." },
+ "A 3D collider can sit off its entity.":
+ { notCertifiable: "A rendering feature, covered by its unit tests and the render-scene pixel gates where it draws; no golden project places it, and one packaged frame cannot decide a result that depends on the device." },
+ "Text can underline, and a box can grow to its text.":
+ { notCertifiable: "A UI behaviour, covered by its unit tests; no golden project uses it, and a packaged launch frame does not drive it." },
+ "An emitter runs on its own clock.":
+ { notCertifiable: "A rendering feature, covered by its unit tests and the render-scene pixel gates where it draws; no golden project places it, and one packaged frame cannot decide a result that depends on the device." },
+ "An animator state can play at the speed of a parameter.":
+ { notCertifiable: "A runtime feature, covered by its unit tests; no golden project uses it, and one packaged launch frame cannot decide it." },
+ "Particles can carry an added velocity and be held to a speed limit.":
+ { notCertifiable: "A rendering feature, covered by its unit tests and the render-scene pixel gates where it draws; no golden project places it, and one packaged frame cannot decide a result that depends on the device." },
+ "An emitter can start late.":
+ { notCertifiable: "A rendering feature, covered by its unit tests and the render-scene pixel gates where it draws; no golden project places it, and one packaged frame cannot decide a result that depends on the device." },
+ "Particles can be stretched along their velocity.":
+ { notCertifiable: "A rendering feature, covered by its unit tests and the render-scene pixel gates where it draws; no golden project places it, and one packaged frame cannot decide a result that depends on the device." },
+ "Fade a whole group of world content with one value: `GroupOpacity`.":
+ { notCertifiable: "A rendering feature, covered by its unit tests and the render-scene pixel gates where it draws; no golden project places it, and one packaged frame cannot decide a result that depends on the device." },
+ "Open a Cocos Creator project from the editor.":
+ { notCertifiable: "Editor or tooling behaviour rather than a rendered game capability; its own suites check it." },
+ "Re-import a Cocos project without losing your edits.":
+ { notCertifiable: "Editor or tooling behaviour rather than a rendered game capability; its own suites check it." },
+ "A held pointer reports where it goes, and a hold can be given up.":
+ { notCertifiable: "A UI behaviour, covered by its unit tests; no golden project uses it, and a packaged launch frame does not drive it." },
+ "The engine's runtime tuning is a project setting.":
+ { notCertifiable: "Editor or tooling behaviour rather than a rendered game capability; its own suites check it." },
+ "Rows for the choices that could only be written into the project file.":
+ { notCertifiable: "Editor or tooling behaviour rather than a rendered game capability; its own suites check it." },
+ "Rain for a 2D scene.":
+ { notCertifiable: "A rendering feature, covered by its unit tests and the render-scene pixel gates where it draws; no golden project places it, and one packaged frame cannot decide a result that depends on the device." },
+ "Mist, wind in the grass, and roofs that fade over the player.":
+ { notCertifiable: "A rendering feature, covered by its unit tests and the render-scene pixel gates where it draws; no golden project places it, and one packaged frame cannot decide a result that depends on the device." },
+ "Footprints and ripples.":
+ { notCertifiable: "A rendering feature, covered by its unit tests and the render-scene pixel gates where it draws; no golden project places it, and one packaged frame cannot decide a result that depends on the device." },
+ "A 2D light can keep to a range of sprite layers.":
+ { notCertifiable: "A rendering feature, covered by its unit tests and the render-scene pixel gates where it draws; no golden project places it, and one packaged frame cannot decide a result that depends on the device." },
+ "More 2D lights cast shadows at once.":
+ { notCertifiable: "A rendering feature, covered by its unit tests and the render-scene pixel gates where it draws; no golden project places it, and one packaged frame cannot decide a result that depends on the device." },
+ "A soft 2D shadow's smoothness is a quality setting.":
+ { notCertifiable: "A rendering feature, covered by its unit tests and the render-scene pixel gates where it draws; no golden project places it, and one packaged frame cannot decide a result that depends on the device." },
+ "What the player can see, and what they have seen.":
+ { notCertifiable: "A runtime feature, covered by its unit tests; no golden project uses it, and one packaged launch frame cannot decide it." },
+ "A palette effect.":
+ { notCertifiable: "A rendering feature, covered by its unit tests and the render-scene pixel gates where it draws; no golden project places it, and one packaged frame cannot decide a result that depends on the device." },
+ "A 2D world streams on x and y.":
+ { notCertifiable: "A runtime feature, covered by its unit tests; no golden project uses it, and one packaged launch frame cannot decide it." },
+ "A generated 2D world.":
+ { notCertifiable: "A runtime feature, covered by its unit tests; no golden project uses it, and one packaged launch frame cannot decide it." },
+ "Grid placement, and what stands nearest.":
+ { notCertifiable: "A runtime feature, covered by its unit tests; no golden project uses it, and one packaged launch frame cannot decide it." },
+ "Save power when the battery is low or the device is hot.":
+ { notCertifiable: "A runtime feature, covered by its unit tests; no golden project uses it, and one packaged launch frame cannot decide it." },
+ "Bitmap fonts.":
+ { notCertifiable: "A UI behaviour, covered by its unit tests; no golden project uses it, and a packaged launch frame does not drive it." },
+ "Text can shrink to fit its box.":
+ { notCertifiable: "A UI behaviour, covered by its unit tests; no golden project uses it, and a packaged launch frame does not drive it." },
+ "A layer can be painted in hierarchy order.":
+ { notCertifiable: "A rendering feature, covered by its unit tests and the render-scene pixel gates where it draws; no golden project places it, and one packaged frame cannot decide a result that depends on the device." },
+ "A text field can stand in the world.":
+ { notCertifiable: "A UI behaviour, covered by its unit tests; no golden project uses it, and a packaged launch frame does not drive it." },
+ "UI pages that exist only while they are wanted: `UIPages`.":
+ { notCertifiable: "A UI behaviour, covered by its unit tests; no golden project uses it, and a packaged launch frame does not drive it." },
+ "Virtual prefab instances.":
+ { notCertifiable: "A runtime feature, covered by its unit tests; no golden project uses it, and one packaged launch frame cannot decide it." },
+ "The loading screens say how far they are.":
+ { notCertifiable: "A UI behaviour, covered by its unit tests; no golden project uses it, and a packaged launch frame does not drive it." },
+ "A material can read a mesh's second uv set.":
+ { notCertifiable: "A rendering feature, covered by its unit tests and the render-scene pixel gates where it draws; no golden project places it, and one packaged frame cannot decide a result that depends on the device." },
+ "Cocos scripts drive scenes as the game does.":
+ { notCertifiable: "Cocos Creator project conversion, covered by the converter's unit tests and the editor suite; no golden project is a converted Cocos project, so no packaged frame can decide it." },
+ "Cocos scripts load assets by path.":
+ { notCertifiable: "Cocos Creator project conversion, covered by the converter's unit tests and the editor suite; no golden project is a converted Cocos project, so no packaged frame can decide it." },
+ "A converted project's scripts are components the editor knows.":
+ { notCertifiable: "Cocos Creator project conversion, covered by the converter's unit tests and the editor suite; no golden project is a converted Cocos project, so no packaged frame can decide it." },
+ "A Cocos project's own effects are converted.":
+ { notCertifiable: "Cocos Creator project conversion, covered by the converter's unit tests and the editor suite; no golden project is a converted Cocos project, so no packaged frame can decide it." },
+ "Converted Cocos UI looks as it does in Cocos.":
+ { notCertifiable: "Cocos Creator project conversion, covered by the converter's unit tests and the editor suite; no golden project is a converted Cocos project, so no packaged frame can decide it." },
+ "A converted Cocos project is brought up to date when it is opened.":
+ { notCertifiable: "Cocos Creator project conversion, covered by the converter's unit tests and the editor suite; no golden project is a converted Cocos project, so no packaged frame can decide it." },
};
/** Numeric compare of two `x.y.z` strings. */