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
examples: modernize with Kenney CC0 art + framework cleanup
yhh2b3532fdfa8c
diff --git a/.gitignore b/.gitignoreindex a70b1a038..7bb913310 100644--- a/.gitignore+++ b/.gitignore@@ -102,3 +102,10 @@ docs/REARCH_*.md# Editor-local workspace cache (last scene, panel layout) — never commit**/.esengine/workspace.json++# Generated per-project engine artifacts (cache, play realm, staged SDK) — never commit.+# Tracked config such as .esengine/asset-export.json is kept.+**/.esengine/cache/+**/.esengine/play/+**/.esengine/sdk/+**/.esengine/editor/diff --git a/examples/ARCHITECTURE.md b/examples/ARCHITECTURE.mdnew file mode 100644index 000000000..63fe5fb69--- /dev/null+++ b/examples/ARCHITECTURE.md@@ -0,0 +1,88 @@+# Example architecture & conventions++Every example is a real Estella project, so it exercises the same loader, scene format+and build pipeline as a game a user would ship. Keep new examples consistent with the+layout below.++## Directory layout++```+<example>/+├── project.esproject # manifest — how the launcher discovers & labels it+├── tsconfig.json # standard TS config (paths → ./.esengine/sdk)+├── .gitignore # ignores node_modules, dist, .esengine/cache+├── thumbnail.png # launcher gallery thumbnail (optional)+├── assets/+│ ├── scenes/main.esscene # the default scene (entities + components)+│ ├── textures/*.png(+.meta) # bitmap assets; each PNG has a .png.meta sidecar+│ ├── prefabs/*.esprefab # reusable entity templates (optional)+│ ├── animations/*.esanim # sprite-animation clips (optional)+│ └── audio/*.wav # audio clips (optional)+└── src/+ ├── main.ts # entry point — registers systems / startup logic+ ├── components.ts # component definitions (defineComponent)+ └── systems/*.ts # one system (or a small group) per file+```++`.esengine/` is **generated** (script cache, play realm, staged SDK) and is gitignored.+The one exception is `.esengine/asset-export.json`, a small committed config that marks+folders for always-export (see space-shooter).++## The manifest (`project.esproject`)++```jsonc+{+ "formatVersion": "1",+ "name": "Space Shooter", // launcher title+ "description": "…one line…", // launcher card subtitle+ "tag": "Game", // launcher category (Basics/ECS/Physics/UI/…)+ "version": "0.1.0",+ "defaultScene": "assets/scenes/main.esscene",+ "designResolution": { "width": 600, "height": 1080 },+ "spineVersion": "none"+}+```++`name`, `description` and `tag` drive how the example appears in *New Project →+Templates*. Every example should set all three.++## How work is placed: scene vs prefab vs code++- **Static entities → the scene.** Cameras, backgrounds, the player, UI, and any fixed+ level geometry live in `main.esscene` as entities with components.+- **Runtime-spawned, repeated entities → prefabs.** Bullets, enemies, pickups that are+ instantiated many times are authored once as `.esprefab` and spawned via `Prefabs`+ (see `space-shooter`). Per-spawn differences use prefab overrides.+- **Behaviour → systems.** Logic goes in `src/systems/*.ts`, registered in `main.ts`+ via `addStartupSystem` / `addSystemToSchedule`. Constants and shared resources go in a+ `resources.ts` (see `space-shooter`) so magic numbers aren't scattered.++Startup entities that must exist before the first frame use an `addStartupSystem`;+per-frame logic uses `Schedule.Update`.++## Asset references++- **Scenes/prefabs reference assets by stable UUID** — e.g. a Sprite's+ `"texture": "@uuid:…"`, resolved from the sidecar `assets/textures/foo.png.meta`.+ To replace art without touching the scene, **overwrite the PNG bytes under the same+ filename** — the `.meta` UUID is unchanged, so every reference stays valid. (Adjust the+ Sprite `size` if the new art's aspect ratio differs.)+- **Code references assets by project-relative path** — e.g.+ `insert(Sprite, { texture: 'assets/textures/gem.png' })`. No UUID needed; the loader+ resolves the path.++## Art policy++- Examples that use bitmap art use **Kenney CC0** assets (see [ASSETS.md](./ASSETS.md)) —+ public-domain, one cohesive style, safe to ship and reuse commercially.+- Concept demos (ECS, events, tweens, collision) render **colored primitives** on+ purpose: a plain square makes the system's behaviour legible in a way decorated art+ would obscure. Don't add textures to these just for polish.+- UI examples use the engine's built-in UI theme.++## Verifying an example++`node build-tools/tasks/check-examples.js` symlinks the built SDK into each example and+runs `tsc --noEmit` across all of them — run it after changing example source or the SDK+types. Visual/gameplay correctness (rendering, camera framing, tilemap tiles) should be+confirmed by opening the example in the editor and pressing Play.diff --git a/examples/ASSETS.md b/examples/ASSETS.mdnew file mode 100644index 000000000..6d448fbc9--- /dev/null+++ b/examples/ASSETS.md@@ -0,0 +1,29 @@+# Example art credits++All bitmap art in these examples comes from **[Kenney](https://kenney.nl)** and is+released under **Creative Commons CC0 1.0 (public domain)**. CC0 requires no attribution+and permits commercial reuse, so these examples — art included — are free to use as the+starting point for a real game. This credit is a courtesy, not an obligation.++## Packs used++| Pack | License | Used by |+| --- | --- | --- |+| [Platformer Art Deluxe](https://kenney.nl/assets/platformer-art-deluxe) | CC0 | platformer, sprite-animation (walk/idle frames), hello-world (gem), physics-playground (crate) |+| [Space Shooter Remastered](https://kenney.nl/assets/space-shooter-remastered) | CC0 | space-shooter (ships, lasers, enemies, life icon, starfield), input-demo (cursor), sprite-rendering (star) |+| [Simple Space](https://kenney.nl/assets/simple-space) | CC0 | input-demo (player ship) |+| [Particle Pack](https://kenney.nl/assets/particle-pack) | CC0 | particle-demo, space-shooter (explosion) |+| [Physics Assets](https://kenney.nl/assets/physics-assets) | CC0 | physics-playground (ball) |+| [UI Pack](https://kenney.nl/assets/ui-pack) | CC0 | sprite-rendering (arrow) |+| [Pixel Platformer](https://kenney.nl/assets/pixel-platformer) | CC0 | tilemap-demo (tileset atlas) |++## Audio++`audio-demo` uses short synthesized drum one-shots (`assets/audio/*.wav`) generated for+this repo; they are dedicated to the public domain along with the rest of the examples.++## Replacing or adding art++The pixel/vector PNGs are dropped in under each example's `assets/textures/`. To swap+art for an existing sprite, overwrite the PNG under the same filename so the scene's+UUID reference stays valid (see [ARCHITECTURE.md](./ARCHITECTURE.md#asset-references)).diff --git a/examples/README.md b/examples/README.mdnew file mode 100644index 000000000..a2b84d352--- /dev/null+++ b/examples/README.md@@ -0,0 +1,50 @@+# Estella Examples++Each folder here is a **complete, self-contained Estella project** — the same format+the editor creates for a new game. The launcher discovers them automatically (any+folder with a `project.esproject` shows up in *New Project → Templates*), so these+double as the starter templates.++To try one: open the folder in the Estella editor, or copy it as the starting point+for your own game.++## Catalog++| Example | Tag | What it shows |+| --- | --- | --- |+| **hello-world** | Basics | The smallest project — one rotating, color-pulsing sprite. |+| **ecs-basics** | ECS | Spawn, move, bounce and expire entities: the core ECS loop. |+| **event-system** | ECS | Decoupled gameplay with typed events — collect, score, react. |+| **sprite-rendering** | Rendering | Draw sprites with rotation, tint and flipping. |+| **sprite-animation** | Animation | Frame animation via `.esanim` clips with an idle/walk switcher. |+| **tween-animation** | Animation | Ease positions, scales and colors over time. |+| **input-demo** | Input | Keyboard, mouse and pointer input with a motion trail. |+| **audio-demo** | Audio | One-shot SFX and a beat visualizer driven by playback. |+| **collision-layers** | Physics | Layer-based collision filtering between groups of bodies. |+| **physics-playground** | Physics | Drop balls and crates into a rigid-body sandbox. |+| **physics-spinner** | Physics | Revolute joints and continuous rotation. |+| **particle-demo** | Effects | A configurable particle emitter with additive blending. |+| **postprocess-effects** | Effects | Full-screen post-processing: bloom, vignette, color grading. |+| **tilemap-demo** | Tilemap | A tile level painted from a tileset atlas, drawn by the tilemap layer. |+| **ui-controls** | UI | Buttons, sliders, toggles and progress bars. |+| **ui-interaction** | UI | Dragging, focus and pointer interaction. |+| **ui-layout** | UI | Flexbox-style responsive UI layout. |+| **platformer** | Game | A tiny platformer — run, jump and collect coins. |+| **space-shooter** | Game | A vertical shmup with prefabs, a HUD and a difficulty ramp. |++## Art & assets++Examples that render bitmap art use **[Kenney](https://kenney.nl) CC0 (public-domain)+assets** — see [ASSETS.md](./ASSETS.md) for the exact packs. CC0 means no attribution+is required and you may reuse these examples (art included) in commercial games, which+keeps them consistent with Estella's Apache-2.0 license.++The concept demos (ECS, events, tweens, collision, spinner) intentionally render with+**colored primitives** rather than art — a plain colored square is the clearest way to+show *what the system is doing*, and it's the same convention most engine examples use.+The UI examples use the engine's built-in UI theme.++## Structure & conventions++See [ARCHITECTURE.md](./ARCHITECTURE.md) for the layout every example follows and the+conventions to keep them consistent.diff --git a/examples/audio-demo/project.esproject b/examples/audio-demo/project.esprojectindex 42112a7a6..5f01b557e 100644--- a/examples/audio-demo/project.esproject+++ b/examples/audio-demo/project.esproject@@ -1,6 +1,8 @@{"formatVersion": "1","name": "Audio Demo",+ "description": "Trigger one-shot SFX and drive a beat visualizer from playback.",+ "tag": "Audio","version": "0.1.0","defaultScene": "assets/scenes/main.esscene","designResolution": {diff --git a/examples/collision-layers/project.esproject b/examples/collision-layers/project.esprojectindex f303ddc39..6e6444db9 100644--- a/examples/collision-layers/project.esproject+++ b/examples/collision-layers/project.esproject@@ -1,6 +1,8 @@{"formatVersion": "1","name": "Collision Layers",+ "description": "Layer-based collision filtering between groups of bodies.",+ "tag": "Physics","version": "0.1.0","defaultScene": "assets/scenes/main.esscene","designResolution": {diff --git a/examples/ecs-basics/project.esproject b/examples/ecs-basics/project.esprojectindex 6c583f900..7f90cd8a3 100644--- a/examples/ecs-basics/project.esproject+++ b/examples/ecs-basics/project.esproject@@ -1,6 +1,8 @@{"formatVersion": "1","name": "ECS Basics",+ "description": "Spawn, move, bounce and expire entities to learn the core ECS loop.",+ "tag": "ECS","version": "0.1.0","defaultScene": "assets/scenes/main.esscene","designResolution": {diff --git a/examples/event-system/project.esproject b/examples/event-system/project.esprojectindex 581016c0f..807edc9cf 100644--- a/examples/event-system/project.esproject+++ b/examples/event-system/project.esproject@@ -1,6 +1,8 @@{"formatVersion": "1","name": "Event System",+ "description": "Decoupled gameplay with typed events: collect, score and react.",+ "tag": "ECS","version": "0.1.0","defaultScene": "assets/scenes/main.esscene","designResolution": {diff --git a/examples/hello-world/assets/textures/logo.png b/examples/hello-world/assets/textures/logo.pngindex 3855998d0..8beef0cfd 100644Binary files a/examples/hello-world/assets/textures/logo.png and b/examples/hello-world/assets/textures/logo.png differdiff --git a/examples/hello-world/project.esproject b/examples/hello-world/project.esprojectindex 740b64d99..5194e2868 100644--- a/examples/hello-world/project.esproject+++ b/examples/hello-world/project.esproject@@ -1,6 +1,8 @@{"formatVersion": "1","name": "Hello World",+ "description": "A rotating, color-pulsing sprite — the smallest possible Estella project.",+ "tag": "Basics","version": "0.1.0","defaultScene": "assets/scenes/main.esscene","designResolution": {diff --git a/examples/input-demo/assets/textures/cursor.png b/examples/input-demo/assets/textures/cursor.pngindex 6ebca04d2..9a5c5c2b8 100644Binary files a/examples/input-demo/assets/textures/cursor.png and b/examples/input-demo/assets/textures/cursor.png differdiff --git a/examples/input-demo/assets/textures/player.png b/examples/input-demo/assets/textures/player.pngindex 763889178..4f5e49370 100644Binary files a/examples/input-demo/assets/textures/player.png and b/examples/input-demo/assets/textures/player.png differdiff --git a/examples/input-demo/project.esproject b/examples/input-demo/project.esprojectindex 98418896e..1581b34b4 100644--- a/examples/input-demo/project.esproject+++ b/examples/input-demo/project.esproject@@ -1,6 +1,8 @@{"formatVersion": "1","name": "Input Demo",+ "description": "Keyboard, mouse and pointer input driving a ship with a motion trail.",+ "tag": "Input","version": "0.1.0","defaultScene": "assets/scenes/main.esscene","designResolution": {diff --git a/examples/particle-demo/assets/textures/particle.png b/examples/particle-demo/assets/textures/particle.pngindex a8962624f..8de3f69a7 100644Binary files a/examples/particle-demo/assets/textures/particle.png and b/examples/particle-demo/assets/textures/particle.png differdiff --git a/examples/particle-demo/project.esproject b/examples/particle-demo/project.esprojectindex c1d861c7d..86d5eb360 100644--- a/examples/particle-demo/project.esproject+++ b/examples/particle-demo/project.esproject@@ -1,6 +1,8 @@{"formatVersion": "1","name": "Particle Effects",+ "description": "A configurable particle emitter with additive blending.",+ "tag": "Effects","version": "0.1.0","defaultScene": "assets/scenes/main.esscene","designResolution": {diff --git a/examples/physics-playground/assets/textures/ball.png b/examples/physics-playground/assets/textures/ball.pngindex 6c55f15c5..e9f6db0e2 100644Binary files a/examples/physics-playground/assets/textures/ball.png and b/examples/physics-playground/assets/textures/ball.png differdiff --git a/examples/physics-playground/assets/textures/crate.png b/examples/physics-playground/assets/textures/crate.pngindex b742a0eaf..7471ed717 100644Binary files a/examples/physics-playground/assets/textures/crate.png and b/examples/physics-playground/assets/textures/crate.png differdiff --git a/examples/physics-playground/project.esproject b/examples/physics-playground/project.esprojectindex fa0e5221d..4f0644492 100644--- a/examples/physics-playground/project.esproject+++ b/examples/physics-playground/project.esproject@@ -1,6 +1,8 @@{"formatVersion": "1","name": "Physics Playground",+ "description": "Drop balls and crates into a rigid-body sandbox.",+ "tag": "Physics","version": "0.1.0","defaultScene": "assets/scenes/main.esscene","designResolution": {diff --git a/examples/physics-spinner/project.esproject b/examples/physics-spinner/project.esprojectindex 95f81b923..34ac34c12 100644--- a/examples/physics-spinner/project.esproject+++ b/examples/physics-spinner/project.esproject@@ -1,6 +1,8 @@{"formatVersion": "1","name": "Physics Spinner",+ "description": "Revolute joints and continuous rotation with the physics engine.",+ "tag": "Physics","version": "0.1.0","defaultScene": "assets/scenes/main.esscene","designResolution": {diff --git a/examples/platformer/assets/textures/coin.png b/examples/platformer/assets/textures/coin.pngindex 9cc6916d8..e63c689a0 100644Binary files a/examples/platformer/assets/textures/coin.png and b/examples/platformer/assets/textures/coin.png differdiff --git a/examples/platformer/assets/textures/ground.png b/examples/platformer/assets/textures/ground.pngindex a62b67fd5..035addae8 100644Binary files a/examples/platformer/assets/textures/ground.png and b/examples/platformer/assets/textures/ground.png differdiff --git a/examples/platformer/assets/textures/platform.png b/examples/platformer/assets/textures/platform.pngindex 83620ed53..035addae8 100644Binary files a/examples/platformer/assets/textures/platform.png and b/examples/platformer/assets/textures/platform.png differdiff --git a/examples/platformer/assets/textures/player.png b/examples/platformer/assets/textures/player.pngindex 85bf73b7f..e7613ad5d 100644Binary files a/examples/platformer/assets/textures/player.png and b/examples/platformer/assets/textures/player.png differdiff --git a/examples/platformer/assets/textures/sky.png b/examples/platformer/assets/textures/sky.pngindex d164855ac..1d2adce36 100644Binary files a/examples/platformer/assets/textures/sky.png and b/examples/platformer/assets/textures/sky.png differdiff --git a/examples/platformer/project.esproject b/examples/platformer/project.esprojectindex c31d3dcd8..0f2e135ec 100644--- a/examples/platformer/project.esproject+++ b/examples/platformer/project.esproject@@ -1,6 +1,8 @@{"formatVersion": "1","name": "Platformer",+ "description": "A tiny platformer — run, jump and collect coins.",+ "tag": "Game","version": "0.1.0","defaultScene": "assets/scenes/main.esscene","designResolution": {diff --git a/examples/postprocess-effects/project.esproject b/examples/postprocess-effects/project.esprojectindex 1202742fe..0572ec32e 100644--- a/examples/postprocess-effects/project.esproject+++ b/examples/postprocess-effects/project.esproject@@ -1,6 +1,8 @@{"formatVersion": "1","name": "Post-Processing",+ "description": "Full-screen post-processing: bloom, vignette and color grading.",+ "tag": "Effects","version": "0.1.0","defaultScene": "assets/scenes/main.esscene","designResolution": {diff --git a/examples/space-shooter/assets/prefabs/EnemyA.esprefab b/examples/space-shooter/assets/prefabs/EnemyA.esprefabindex caa7b3c44..eed448434 100644--- a/examples/space-shooter/assets/prefabs/EnemyA.esprefab+++ b/examples/space-shooter/assets/prefabs/EnemyA.esprefab@@ -17,7 +17,7 @@"type": "Sprite","data": {"texture": "@uuid:25e60610-c126-48bf-9b14-85c4699dc912",- "size": { "x": 48, "y": 48 }+ "size": { "x": 52, "y": 47 }}},{diff --git a/examples/space-shooter/assets/prefabs/EnemyB.esprefab b/examples/space-shooter/assets/prefabs/EnemyB.esprefabindex 31176b373..2b5348833 100644--- a/examples/space-shooter/assets/prefabs/EnemyB.esprefab+++ b/examples/space-shooter/assets/prefabs/EnemyB.esprefab@@ -17,7 +17,7 @@"type": "Sprite","data": {"texture": "@uuid:d429cf7d-d52c-42eb-823e-9b775b6249b6",- "size": { "x": 56, "y": 56 }+ "size": { "x": 58, "y": 47 }}},{diff --git a/examples/space-shooter/assets/prefabs/EnemyBullet.esprefab b/examples/space-shooter/assets/prefabs/EnemyBullet.esprefabindex 2ac2d27dd..62be9b922 100644--- a/examples/space-shooter/assets/prefabs/EnemyBullet.esprefab+++ b/examples/space-shooter/assets/prefabs/EnemyBullet.esprefab@@ -17,7 +17,7 @@"type": "Sprite","data": {"texture": "@uuid:97a221a6-85bd-49e7-9af5-2880960fecda",- "size": { "x": 8, "y": 20 }+ "size": { "x": 8, "y": 30 }}},{diff --git a/examples/space-shooter/assets/prefabs/Explosion.esprefab b/examples/space-shooter/assets/prefabs/Explosion.esprefabindex 7836650ef..675b5af6d 100644--- a/examples/space-shooter/assets/prefabs/Explosion.esprefab+++ b/examples/space-shooter/assets/prefabs/Explosion.esprefab@@ -17,7 +17,7 @@"type": "Sprite","data": {"texture": "@uuid:4e16b7e8-3ba1-455b-ab3c-1cfbf5a97e0c",- "size": { "x": 64, "y": 64 }+ "size": { "x": 76, "y": 76 }}},{diff --git a/examples/space-shooter/assets/prefabs/PlayerBullet.esprefab b/examples/space-shooter/assets/prefabs/PlayerBullet.esprefabindex f774b255c..77dd58df5 100644--- a/examples/space-shooter/assets/prefabs/PlayerBullet.esprefab+++ b/examples/space-shooter/assets/prefabs/PlayerBullet.esprefab@@ -17,7 +17,7 @@"type": "Sprite","data": {"texture": "@uuid:c643c566-1859-460a-8029-4568951787f8",- "size": { "x": 8, "y": 24 }+ "size": { "x": 8, "y": 40 }}},{diff --git a/examples/space-shooter/assets/prefabs/Star.esprefab b/examples/space-shooter/assets/prefabs/Star.esprefabindex 2a2ae664b..c0a67d178 100644--- a/examples/space-shooter/assets/prefabs/Star.esprefab+++ b/examples/space-shooter/assets/prefabs/Star.esprefab@@ -10,7 +10,7 @@"children": [],"components": [{ "type": "Transform", "data": { "position": { "x": 0, "y": 0, "z": -0.5 } } },- { "type": "Sprite", "data": { "texture": "@uuid:8f56c884-0439-47f1-86d9-05839abfa6e0", "size": { "x": 4, "y": 4 }, "color": { "r": 1, "g": 1, "b": 1, "a": 0.5 }, "layer": -1 } },+ { "type": "Sprite", "data": { "texture": "@uuid:8f56c884-0439-47f1-86d9-05839abfa6e0", "size": { "x": 9, "y": 9 }, "color": { "r": 1, "g": 1, "b": 1, "a": 0.7 }, "layer": -1 } },{ "type": "Star", "data": { "speed": 30, "layer": 0 } }],"visible": truediff --git a/examples/space-shooter/assets/scenes/main.esscene b/examples/space-shooter/assets/scenes/main.essceneindex 1eb3eb79a..25e032826 100644--- a/examples/space-shooter/assets/scenes/main.esscene+++ b/examples/space-shooter/assets/scenes/main.esscene@@ -81,8 +81,8 @@"data": {"texture": "@uuid:92f1ab5f-28f4-4b95-bb82-7182fdb33494","size": {- "x": 64,- "y": 64+ "x": 66,+ "y": 50}}},diff --git a/examples/space-shooter/assets/textures/background.png b/examples/space-shooter/assets/textures/background.pngindex f468f83ce..82ddab992 100644Binary files a/examples/space-shooter/assets/textures/background.png and b/examples/space-shooter/assets/textures/background.png differdiff --git a/examples/space-shooter/assets/textures/bullet-enemy.png b/examples/space-shooter/assets/textures/bullet-enemy.pngindex 993e082a3..5e467b65b 100644Binary files a/examples/space-shooter/assets/textures/bullet-enemy.png and b/examples/space-shooter/assets/textures/bullet-enemy.png differdiff --git a/examples/space-shooter/assets/textures/bullet-player.png b/examples/space-shooter/assets/textures/bullet-player.pngindex c931613b9..b76aaf7a0 100644Binary files a/examples/space-shooter/assets/textures/bullet-player.png and b/examples/space-shooter/assets/textures/bullet-player.png differdiff --git a/examples/space-shooter/assets/textures/enemy-a.png b/examples/space-shooter/assets/textures/enemy-a.pngindex 37c576426..fb0c0a2ca 100644Binary files a/examples/space-shooter/assets/textures/enemy-a.png and b/examples/space-shooter/assets/textures/enemy-a.png differdiff --git a/examples/space-shooter/assets/textures/enemy-b.png b/examples/space-shooter/assets/textures/enemy-b.pngindex 0c2b9b32f..74e2bca68 100644Binary files a/examples/space-shooter/assets/textures/enemy-b.png and b/examples/space-shooter/assets/textures/enemy-b.png differdiff --git a/examples/space-shooter/assets/textures/explosion.png b/examples/space-shooter/assets/textures/explosion.pngindex 960964004..f23303b95 100644Binary files a/examples/space-shooter/assets/textures/explosion.png and b/examples/space-shooter/assets/textures/explosion.png differdiff --git a/examples/space-shooter/assets/textures/heart.png b/examples/space-shooter/assets/textures/heart.pngindex 2066e09d7..6375095d9 100644Binary files a/examples/space-shooter/assets/textures/heart.png and b/examples/space-shooter/assets/textures/heart.png differdiff --git a/examples/space-shooter/assets/textures/player.png b/examples/space-shooter/assets/textures/player.pngindex 31118d46a..cecbbed97 100644Binary files a/examples/space-shooter/assets/textures/player.png and b/examples/space-shooter/assets/textures/player.png differdiff --git a/examples/space-shooter/assets/textures/star.png b/examples/space-shooter/assets/textures/star.pngindex d4f590653..67551ae78 100644Binary files a/examples/space-shooter/assets/textures/star.png and b/examples/space-shooter/assets/textures/star.png differdiff --git a/examples/space-shooter/project.esproject b/examples/space-shooter/project.esprojectindex f244aa526..3e033f24e 100644--- a/examples/space-shooter/project.esproject+++ b/examples/space-shooter/project.esproject@@ -1,6 +1,8 @@{"formatVersion": "1","name": "Space Shooter",+ "description": "A vertical shmup with prefabs, a HUD and a difficulty ramp.",+ "tag": "Game","version": "0.1.0","defaultScene": "assets/scenes/main.esscene","designResolution": {diff --git a/examples/sprite-animation/assets/scenes/main.esscene b/examples/sprite-animation/assets/scenes/main.essceneindex 9faacdbfc..63138af2e 100644--- a/examples/sprite-animation/assets/scenes/main.esscene+++ b/examples/sprite-animation/assets/scenes/main.esscene@@ -20,7 +20,7 @@"children": [],"components": [{ "type": "Transform", "data": { "position": { "x": -240, "y": 0, "z": 0 } } },- { "type": "Sprite", "data": { "size": { "x": 80, "y": 80 } } },+ { "type": "Sprite", "data": { "size": { "x": 72, "y": 98 } } },{ "type": "SpriteAnimator", "data": {"clip": "assets/animations/walk.esanim","speed": 0.8@@ -36,7 +36,7 @@"children": [],"components": [{ "type": "Transform", "data": { "position": { "x": -120, "y": 0, "z": 0 } } },- { "type": "Sprite", "data": { "size": { "x": 80, "y": 80 } } },+ { "type": "Sprite", "data": { "size": { "x": 72, "y": 98 } } },{ "type": "SpriteAnimator", "data": {"clip": "assets/animations/idle.esanim"}},@@ -51,7 +51,7 @@"children": [],"components": [{ "type": "Transform", "data": { "position": { "x": 0, "y": 0, "z": 0 } } },- { "type": "Sprite", "data": { "size": { "x": 80, "y": 80 } } },+ { "type": "Sprite", "data": { "size": { "x": 72, "y": 98 } } },{ "type": "SpriteAnimator", "data": {"clip": "assets/animations/walk.esanim","speed": 1.2@@ -67,7 +67,7 @@"children": [],"components": [{ "type": "Transform", "data": { "position": { "x": 120, "y": 0, "z": 0 } } },- { "type": "Sprite", "data": { "size": { "x": 80, "y": 80 } } },+ { "type": "Sprite", "data": { "size": { "x": 72, "y": 98 } } },{ "type": "SpriteAnimator", "data": {"clip": "assets/animations/idle.esanim","speed": 1.4@@ -83,7 +83,7 @@"children": [],"components": [{ "type": "Transform", "data": { "position": { "x": 240, "y": 0, "z": 0 } } },- { "type": "Sprite", "data": { "size": { "x": 80, "y": 80 } } },+ { "type": "Sprite", "data": { "size": { "x": 72, "y": 98 } } },{ "type": "SpriteAnimator", "data": {"clip": "assets/animations/walk.esanim","speed": 1.6diff --git a/examples/sprite-animation/assets/textures/idle_0.png b/examples/sprite-animation/assets/textures/idle_0.pngindex 8113fa6cf..e7613ad5d 100644Binary files a/examples/sprite-animation/assets/textures/idle_0.png and b/examples/sprite-animation/assets/textures/idle_0.png differdiff --git a/examples/sprite-animation/assets/textures/idle_1.png b/examples/sprite-animation/assets/textures/idle_1.pngindex 1305ad4eb..1dbe260de 100644Binary files a/examples/sprite-animation/assets/textures/idle_1.png and b/examples/sprite-animation/assets/textures/idle_1.png differdiff --git a/examples/sprite-animation/assets/textures/idle_2.png b/examples/sprite-animation/assets/textures/idle_2.pngindex 26dba57a2..e7613ad5d 100644Binary files a/examples/sprite-animation/assets/textures/idle_2.png and b/examples/sprite-animation/assets/textures/idle_2.png differdiff --git a/examples/sprite-animation/assets/textures/idle_3.png b/examples/sprite-animation/assets/textures/idle_3.pngindex 5c0469d74..1dbe260de 100644Binary files a/examples/sprite-animation/assets/textures/idle_3.png and b/examples/sprite-animation/assets/textures/idle_3.png differdiff --git a/examples/sprite-animation/assets/textures/walk_0.png b/examples/sprite-animation/assets/textures/walk_0.pngindex 6f4b1b23a..047061635 100644Binary files a/examples/sprite-animation/assets/textures/walk_0.png and b/examples/sprite-animation/assets/textures/walk_0.png differdiff --git a/examples/sprite-animation/assets/textures/walk_1.png b/examples/sprite-animation/assets/textures/walk_1.pngindex 1f327b78f..f14817819 100644Binary files a/examples/sprite-animation/assets/textures/walk_1.png and b/examples/sprite-animation/assets/textures/walk_1.png differdiff --git a/examples/sprite-animation/assets/textures/walk_2.png b/examples/sprite-animation/assets/textures/walk_2.pngindex 6f4b1b23a..0a80b03ea 100644Binary files a/examples/sprite-animation/assets/textures/walk_2.png and b/examples/sprite-animation/assets/textures/walk_2.png differdiff --git a/examples/sprite-animation/assets/textures/walk_3.png b/examples/sprite-animation/assets/textures/walk_3.pngindex 6e9c80576..d57448c60 100644Binary files a/examples/sprite-animation/assets/textures/walk_3.png and b/examples/sprite-animation/assets/textures/walk_3.png differdiff --git a/examples/sprite-animation/project.esproject b/examples/sprite-animation/project.esprojectindex 3020a17d6..1f5426bc3 100644--- a/examples/sprite-animation/project.esproject+++ b/examples/sprite-animation/project.esproject@@ -1,6 +1,8 @@{"formatVersion": "1","name": "Sprite Animation",+ "description": "Frame-based sprite animation driven by .esanim clips and a state switcher.",+ "tag": "Animation","version": "0.1.0","defaultScene": "assets/scenes/main.esscene","designResolution": {diff --git a/examples/sprite-rendering/assets/textures/arrow.png b/examples/sprite-rendering/assets/textures/arrow.pngindex 0c6bd28f6..72e66cc6d 100644Binary files a/examples/sprite-rendering/assets/textures/arrow.png and b/examples/sprite-rendering/assets/textures/arrow.png differdiff --git a/examples/sprite-rendering/assets/textures/star.png b/examples/sprite-rendering/assets/textures/star.pngindex 070cd68d3..4f048ef7c 100644Binary files a/examples/sprite-rendering/assets/textures/star.png and b/examples/sprite-rendering/assets/textures/star.png differdiff --git a/examples/sprite-rendering/project.esproject b/examples/sprite-rendering/project.esprojectindex 1d28abb67..6f4d4528f 100644--- a/examples/sprite-rendering/project.esproject+++ b/examples/sprite-rendering/project.esproject@@ -1,6 +1,8 @@{"formatVersion": "1","name": "Sprite Rendering",+ "description": "Draw sprites with rotation, tint and flipping.",+ "tag": "Rendering","version": "0.1.0","defaultScene": "assets/scenes/main.esscene","designResolution": {diff --git a/examples/tilemap-demo/.gitignore b/examples/tilemap-demo/.gitignorenew file mode 100644index 000000000..359472ac2--- /dev/null+++ b/examples/tilemap-demo/.gitignore@@ -0,0 +1,7 @@+node_modules/+dist/+.vscode/+.idea/+.DS_Store+Thumbs.db+.esengine/cache/diff --git a/examples/tilemap-demo/assets/scenes/main.esscene b/examples/tilemap-demo/assets/scenes/main.esscenenew file mode 100644index 000000000..46059e1f8--- /dev/null+++ b/examples/tilemap-demo/assets/scenes/main.esscene@@ -0,0 +1,40 @@+{+ "version": "1.0",+ "name": "Main",+ "entities": [+ {+ "id": 0,+ "name": "Camera",+ "parent": null,+ "children": [],+ "components": [+ { "type": "Transform", "data": { "position": { "x": 144, "y": -144, "z": 10 } } },+ { "type": "Camera", "data": { "projectionType": 1, "orthoSize": 160, "isActive": true, "priority": 0 } }+ ],+ "visible": true+ },+ {+ "id": 1,+ "name": "Tilemap",+ "parent": null,+ "children": [],+ "components": [+ { "type": "Transform", "data": { "position": { "x": 0, "y": 0, "z": 0 } } },+ {+ "type": "TilemapLayer",+ "data": {+ "cellSize": { "x": 18, "y": 18 },+ "tileset": "@uuid:11111111-2222-3333-4444-555555555555",+ "tilesetColumns": 20,+ "tilesetRows": 9,+ "renderLayer": 0,+ "opacity": 1,+ "visible": true,+ "chunks": "RVNUTQEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQACAAMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAIAAwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQACAAIAAgACAAIAAgACAAIAAgACAAIAAgACAAIAAwAWABYAFgAWABYAFgAWABYAFgAWABYAFgAWABYAFgAWABYAFgAWABYAFgAWABYAFgAWABYAFgAWABYAFgAWABYA"+ }+ }+ ],+ "visible": true+ }+ ]+}diff --git a/examples/tilemap-demo/assets/textures/tileset.png b/examples/tilemap-demo/assets/textures/tileset.pngnew file mode 100644index 000000000..901a78562Binary files /dev/null and b/examples/tilemap-demo/assets/textures/tileset.png differdiff --git a/examples/tilemap-demo/assets/textures/tileset.png.meta b/examples/tilemap-demo/assets/textures/tileset.png.metanew file mode 100644index 000000000..97ae1ebba--- /dev/null+++ b/examples/tilemap-demo/assets/textures/tileset.png.meta@@ -0,0 +1,17 @@+{+ "uuid": "11111111-2222-3333-4444-555555555555",+ "version": "2.0",+ "type": "texture",+ "importer": {+ "maxSize": 2048,+ "filterMode": "nearest",+ "wrapMode": "clamp",+ "premultiplyAlpha": false,+ "sliceBorder": {+ "left": 0,+ "right": 0,+ "top": 0,+ "bottom": 0+ }+ }+}diff --git a/examples/tilemap-demo/project.esproject b/examples/tilemap-demo/project.esprojectnew file mode 100644index 000000000..714ed7182--- /dev/null+++ b/examples/tilemap-demo/project.esproject@@ -0,0 +1,13 @@+{+ "formatVersion": "1",+ "name": "Tilemap Demo",+ "description": "A tile-based level painted from a Kenney tileset atlas and rendered by the tilemap layer.",+ "tag": "Tilemap",+ "version": "0.1.0",+ "defaultScene": "assets/scenes/main.esscene",+ "designResolution": {+ "width": 800,+ "height": 600+ },+ "spineVersion": "none"+}diff --git a/examples/tilemap-demo/src/main.ts b/examples/tilemap-demo/src/main.tsnew file mode 100644index 000000000..75fc8090d--- /dev/null+++ b/examples/tilemap-demo/src/main.ts@@ -0,0 +1,5 @@+// Tilemap Demo — the level is authored in the scene (assets/scenes/main.esscene)+// as a TilemapLayer that references the Kenney tileset atlas, and it is rendered by+// the engine's built-in tilemap plugin. Displaying it needs no gameplay systems, so+// this entry point is intentionally empty; add systems here to make the map interactive.+export {};diff --git a/examples/tilemap-demo/tsconfig.json b/examples/tilemap-demo/tsconfig.jsonnew file mode 100644index 000000000..0a8528b29--- /dev/null+++ b/examples/tilemap-demo/tsconfig.json@@ -0,0 +1,22 @@+{+ "compilerOptions": {+ "target": "ES2020",+ "module": "ESNext",+ "moduleResolution": "bundler",+ "strict": true,+ "esModuleInterop": true,+ "skipLibCheck": true,+ "forceConsistentCasingInFileNames": true,+ "declaration": false,+ "outDir": "./dist",+ "rootDir": ".",+ "baseUrl": ".",+ "paths": {+ "esengine": ["./.esengine/sdk/index.d.ts"],+ "esengine/wasm": ["./.esengine/sdk/wasm.d.ts"],+ "@esengine/editor": ["./.esengine/editor/index.d.ts"]+ }+ },+ "include": ["src/**/*"],+ "exclude": ["node_modules"]+}diff --git a/examples/tween-animation/project.esproject b/examples/tween-animation/project.esprojectindex 22b5d4af2..d47a786b0 100644--- a/examples/tween-animation/project.esproject+++ b/examples/tween-animation/project.esproject@@ -1,6 +1,8 @@{"formatVersion": "1","name": "Tween Animation",+ "description": "Ease positions, scales and colors over time with the tween system.",+ "tag": "Animation","version": "0.1.0","defaultScene": "assets/scenes/main.esscene","designResolution": {diff --git a/examples/ui-controls/project.esproject b/examples/ui-controls/project.esprojectindex 0bbe0a4ad..7bf8c1cb9 100644--- a/examples/ui-controls/project.esproject+++ b/examples/ui-controls/project.esproject@@ -1,6 +1,8 @@{"formatVersion": "1","name": "UI Controls",+ "description": "Buttons, sliders, toggles and other interactive widgets.",+ "tag": "UI","version": "0.1.0","defaultScene": "assets/scenes/main.esscene","designResolution": {diff --git a/examples/ui-interaction/project.esproject b/examples/ui-interaction/project.esprojectindex f1d6bca70..870ead37e 100644--- a/examples/ui-interaction/project.esproject+++ b/examples/ui-interaction/project.esproject@@ -1,6 +1,8 @@{"formatVersion": "1","name": "UI Interaction",+ "description": "Dragging, focus and pointer interaction in the UI system.",+ "tag": "UI","version": "0.1.0","defaultScene": "assets/scenes/main.esscene","designResolution": {diff --git a/examples/ui-layout/project.esproject b/examples/ui-layout/project.esprojectindex 39258e199..8c7a055bf 100644--- a/examples/ui-layout/project.esproject+++ b/examples/ui-layout/project.esproject@@ -1,6 +1,8 @@{"formatVersion": "1","name": "UI Layout",+ "description": "Flexbox-style responsive UI layout.",+ "tag": "UI","version": "0.1.0","defaultScene": "assets/scenes/main.esscene","designResolution": {