@codexo/exojs 0.12.0 → 0.14.0

package/CHANGELOG.md

@@ -4,13 +4,265 @@ All notable changes to ExoJS are documented in this file.
 
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.14.0] - 2026-06-26
+
+The architecture and hardening release. Two new packages —
+`@codexo/exojs-physics` (a native 2D physics world with a TGS-Soft solver) and
+`@codexo/exojs-audio-fx` (the audio effect suite, extracted from core) — join the
+lockstep set. Core gains a UI layer, scene-graph serialization with prefabs,
+immediate-mode rendering, an ordered System scheduler, and a multi-instance-safe
+foundation. The type system reaches its strictest configuration
+(`noUncheckedIndexedAccess` + `exactOptionalPropertyTypes` across all packages,
+zero `as any`, zero `ts-ignore`). Save-slot persistence moves to a new
+`KeyValueStore` surface with three swappable backends. This is a pre-1.0 release
+and includes intentional breaking changes; see **Changed** and **Removed**.
 
-Release notes are curated at release time, not per pull request. When a version
-is cut, this section is renamed to `## [x.y.z] - YYYY-MM-DD` and filled from the
-merged pull requests and commits since the previous tag (each with its commit /
-PR link); `pnpm release:notes` then renders that section into the published
-GitHub release with a `PREVIOUS_TAG...CURRENT_TAG` compare link.
+### Added
+
+- **`@codexo/exojs-physics` — native 2D physics.** Circles, boxes, capsules, and
+  convex polygons; static, kinematic, and dynamic bodies; SAP broadphase; manifold
+  narrow-phase; warm-started TGS-Soft solver (sub-stepped soft-constraint, 2×2
+  block normal LCP) stable to 20+ box stacks. Contact graph, collision events,
+  spatial queries, scene-graph binding, and a `/debug` draw subpath. Allocation
+  measured and halved per step (V8 heap-sampler verified); the dynamics surface
+  (`velocity`, `applyForce`/`Torque`/`Impulse`) is fully public (#131, #140, #141,
+  #142, #143, #155, #156, #177, #180, #181).
+- **`@codexo/exojs-audio-fx` — audio effect package.** Extracted from core: the
+  `*Effect` suite, `AudioAnalyser`, `BeatDetector`, worklets, and DSP helpers.
+  Core keeps the audio engine and effect base classes (#133).
+- **UI core.** `scene.ui` with a `Widget`/`Label`/`Panel`/`Button`/`ProgressBar`
+  set, row/column/stack layout and anchoring, a `FocusManager` with keyboard
+  navigation, and `app.focus` (#138).
+- **Scene-graph serialization.** `SerializationRegistry`, `NodeSerializer`, and
+  `Prefab` with `Scene.serialize`/`deserialize`; serializers for containers,
+  sprites, text, meshes, graphics, nine-slice/repeating sprites, animated sprites,
+  bitmap text, video, and UI widgets. Tilemap nodes serialize through an extension
+  binding. Pair with a `KeyValueStore` for save-slot persistence (#144, #145, #146,
+  #147, #148).
+- **`KeyValueStore` interface + three backends.** `WebStorageStore` wraps
+  `localStorage`/`sessionStorage` with JSON serialization. `IndexedDbKeyValueStore`
+  stores values via structured clone — `Blob`s and `ArrayBuffer`s round-trip
+  natively. `MemoryStore` is an in-process `Map` for tests and ephemeral state.
+  All three share one `async` interface; swapping backends is a one-line change
+  (#178).
+- **Binary asset containers.** `Loader.loadContainer(url)` fetches a single
+  archive, injects each entry directly into the cache, and triggers `onLoaded`
+  callbacks — one HTTP request in place of N individual asset fetches. A
+  `build-container` script bundles assets at build time (#179).
+- **Immediate-mode rendering.** `RenderingContext.drawGeometry` for one-off
+  geometry and `RenderBatch` + `drawBatch` for instanced draws collapsing to a
+  single draw call (#150, #151, #159).
+- **System scheduler.** `app.systems` and `scene.systems` run the core managers
+  as ordered systems with deterministic tick bands (#134).
+- **Design-space coordinates.** Automatic DPR handling, letterbox sizing, and
+  `canvas`-mount / `sizingMode` options on `Application` (#130).
+- **Typed tilemap object layers.** Object layers and queries converted from Tiled
+  object groups, plus an `ObjectKind` `as const` schema and a generic
+  `ObjectLayer<S>` with `byType`/`byKind`/`where` (#132, #157).
+- **GPU resource accounting in `RenderStats`.** `gpuMemoryBytes` tracks an
+  accumulated VRAM estimate; `textureUploadBytes` and `bufferUploadBytes` count
+  bytes transferred each frame (#173).
+- **Combined Tiled + physics examples** with an `ObjectLayer`→collider bridge
+  (#160), a rebuilt example catalog on a shared runtime helper kit, and a live
+  hero example with an expandable playground preview.
+
+### Changed
+
+- **Audio re-architecture.** `Sound`/`AudioStream`/`AudioGenerator` descriptors
+  with a voice capability matrix; the audio singleton is gone and `AudioFilter`
+  becomes `AudioEffect`. Playback defers until the autoplay gesture unlocks
+  audio (#133).
+- **Multi-instance foundation.** `Destroyable`/`DisposalScope` for deterministic
+  teardown; `Interaction`, `Audio`, `Random`, and the serializer registry are
+  app-owned rather than process singletons; `ObservableVector` sheds per-node
+  closures (#133, #134, #154).
+- **BREAKING — API hygiene.** Value-type footgun fixes (`Matrix.getInverse`,
+  `Color.toRgba`, honest `Rectangle` types), curated barrels, and namespaced
+  utilities (`MathUtils`, `MeshBuilder`, `Sweep`, `Collision`, …) (#135).
+- **BREAKING — `Random` engine.** Mersenne Twister replaced with xoshiro128\*\*
+  and SplitMix32 seeding; the `iteration` getter is removed (#137).
+- **BREAKING — physics body construction.** `new PhysicsBody({ colliders })` +
+  `world.add`/`world.attach` replace `createBody`/`createStaticCollider` (#156).
+- **BREAKING — physics solver config.** `velocityIterations`/`positionIterations`
+  replaced by `subStepCount` (default 4), `contactHertz` (default 30), and
+  `dampingRatio` (default 10) for the TGS-Soft solver (#181).
+- **BREAKING — rendering barrel.** Backend renderer internals move behind the
+  `@codexo/exojs/renderer-sdk` subpath; the root barrel is curated (#153).
+- **BREAKING — `Text` constructor.** The multi-argument overload is removed in
+  favour of `new Text(text, options?)` (#165).
+- **BREAKING — `System.update` signature.** All system `update` methods now
+  receive `(delta: Time)` (#164).
+- **BREAKING — `SerializationRegistry` is app-owned.** Access through
+  `app.serializers`; the process-singleton accessor is removed (#164).
+- **BREAKING — `noUncheckedIndexedAccess` + `exactOptionalPropertyTypes`
+  enabled.** Both flags are now `true` across all packages. Code that indexed
+  arrays without narrowing will need guards or non-null assertions (#171).
+- **Render-plan performance.** `DrawCommand`, `MaterialKey`, and `ScopeEntry`
+  objects are pooled; static 1,000-sprite scenes shed ~55 % of per-frame
+  allocation. `RenderPlanOptimizer` overlap grouping goes O(n²) → O(n) via a
+  `Map`-based index — 10,000-sprite / 8-texture scenes optimize in ~2.3 ms vs
+  ~14 ms (~6×), grouping bit-identical (#173, #175).
+- **Production bundle size.** A `terser` `pure_funcs` pass strips dev-assert
+  calls from production builds; `exo.esm.js` shrinks from 1.66 MB to 625 KB
+  (#172).
+- **Strict lint and type rules.** `noUnusedLocals`/`noUnusedParameters` enforced;
+  `@vitest/eslint-plugin` flags non-awaited promise assertions and focused tests;
+  explicit barrel re-exports replace wildcards throughout (#163, #166, #167, #168).
+- **Site islands migrated from Lit to React** (#149); a shared `Registry<K,V>`
+  primitive backs constructor-keyed dispatch (#136).
+
+### Removed
+
+- **BREAKING — scene stack.** `SceneStackMode`, `SceneParticipation`,
+  `pushScene`, and `popScene` are removed in favor of one active scene with
+  `setScene`, fade transitions, and `scene.paused` (#139).
+
+### Fixed
+
+- Physics contact pair keys no longer collide past 65,536 body IDs (#155).
+- New and mutated textures upload correctly after their first bind, and pointer
+  coordinates map to backing-store pixels when the canvas is scaled (#130).
+- Deserialization validates the data boundary on entry — malformed or absent
+  fields no longer reach node constructors. `NineSliceSprite.slices` absent no
+  longer throws; non-object children in a serialized scene are silently skipped
+  (#177).
+
+### Docs
+
+- Text API guide corrected: stale property names removed, property table
+  rewritten, mutation-sync behaviour documented (#183).
+- Storage and serialization guides written for the `KeyValueStore` surface (#183).
+- `SceneManager` API page documents the single-scene, no-stack model (#183).
+- Physics solver operating envelope characterised — mass-ratio ceiling (100:1) and
+  no-CCD disclaimer added to class docs, backed by `SG-MR3` and `SG-X5`
+  regression tests (#184).
+- ADR on shared geometry with separate collision detection (#158) and an
+  immediate-mode rendering guide (#159).
+
+## [0.13.0] - 2026-06-13
+
+The scalable-sprites and tilemap release. `TextureRegion`, `NineSliceSprite`,
+and `RepeatingSprite` bring nine-slice and tiled-repeat rendering to both
+backends. `@codexo/exojs-tilemap` is introduced as a generic, format-independent
+tilemap runtime foundation. `@codexo/exojs-tiled` is expanded from its v0.12
+stub into the parsed Tiled source adapter and runtime conversion layer.
+
+### Added
+
+- **Scalable sprites.** `NineSliceSprite` renders a texture subdivided into
+  nine regions (four corners, four edges, and a centre) with per-edge repeat
+  modes (`stretch`, `repeat`, `mirror-repeat`) and size fits (`clip`, `round`).
+  Dedicated WebGL2 and WebGPU instanced renderers batch by texture and blend
+  mode. Source slices and destination borders are independently configured
+  through `edgeFit` and `centerFit` (#110).
+
+- **`RepeatingSprite`** tiles a `Texture` or `TextureRegion` across a target
+  area with independent `modeX`/`modeY` (`stretch`, `repeat`, `mirror-repeat`)
+  and `fitX`/`fitY` (`clip`, `round`). A bare `Texture` uses the shader/sampler
+  path; a `TextureRegion` uses the geometry path. Dedicated WebGL2 and WebGPU
+  renderers batch by texture and blend mode; sampler and strategy changes
+  create additional batch boundaries (#111).
+
+- **`TextureRegion`.** An immutable structural type identifying a sub-rectangle
+  of a `Texture` without duplicating GPU resources. Used by nine-slice and
+  repeating sprites, tilemap tiles, and any consumer that operates on a
+  sub-area of an atlas (#109).
+
+- **Render-only pixel snapping.** `Drawable.pixelSnapMode` accepts `none`,
+  `position`, or `geometry`, snapping only the visual transform without
+  disturbing the logical model. The effective mode degrades automatically for
+  non-axis-aligned sprites (#116).
+
+- **TransformBuffer upload coalescing.** `RenderPlanPlayer` prepares all
+  transforms for a render scope before draw execution. The first renderer
+  flush uploads the stable transform range; subsequent flushes reuse it
+  through the hash guard, eliminating repeated uploads of growing ranges
+  within a scope (#118).
+
+- **Renderer performance benchmark harness.** Structural metric sweep for
+  `Sprite`, `NineSliceSprite`, `RepeatingSprite`, and `Tilemap` renderers
+  (WebGL2, recording fake GL context for deterministic GPU-free metrics).
+  Profiling mode gated behind `EXOJS_PERF_PROFILE` (#117).
+
+- **`@codexo/exojs-tilemap` — generic tilemap runtime.** `TileMap` manages
+  tilesets, layers, and mutation. `TileLayer` holds a sparse packed-tile array
+  with configurable chunk dimensions (default 32×32). `TileSet` indexes tile
+  definitions by local ID. Scene-graph nodes (`TileMapNode`, `TileLayerNode`)
+  provide per-pixel positioning with `Container` children, chunk-level culling,
+  and `TileMapBand` for actor interleaving. `TileMapView` maps layer selections
+  to bands declaratively. Chunk rendering uses instanced WebGL2 and WebGPU
+  renderers batched by compatible state and tileset texture. `ReadonlyTileChunk`
+  is the public immutable chunk view (#112, #114, #115).
+
+- **`@codexo/exojs-tiled` — Tiled map format adapter.** Loads finite orthogonal
+  TMJ/TSJ maps through `Loader.load(TileMap, 'map.tmj')` for a ready-to-use
+  runtime `TileMap` or `Loader.load(TiledMap, 'map.tmj')` for the structured,
+  dependency-resolved source model. `TiledMap` resolves external tileset
+  references, validates the source against the Tiled schema, and exposes
+  `toTileMap()` for synchronous runtime conversion. Supports multiple tilesets
+  (external and embedded), tile flip flags, custom properties, and sub-URL
+  resolution. Ships `tiledExtension` for one-line setup (#113).
+
+- **Extension descriptor dependencies.** The `Extension` interface accepts
+  `dependencies?: readonly Extension[]`. Each dependency references another
+  extension descriptor object. Dependencies are materialised before dependents;
+  the snapshot resolver deduplicates the same descriptor object, rejects
+  same-ID/different-object conflicts, and detects cycles. This ensures
+  `@codexo/exojs-tiled`'s tilemap foundation is loaded before Tiled bindings
+  are registered (#107).
+
+- **Typed declarative asset bindings.** `AssetBinding<Result, Options>` and
+  `AssetHandler<Result, Options>` carry typed result and option generics.
+  Handlers may provide `getIdentityKey(request)` to define deterministic
+  result-sensitive cache identity. The `Loader.load(type, path)` overloads
+  return the declared `Result` type without manual casting (#108).
+
+### Fixed
+
+- **Extension package CI path coverage.** A PR touching only extension-package
+  source no longer skips the unit, package-verify, and browser lanes (#120).
+
+- **Package ESLint hardening.** Extension package source files are linted
+  with typed `@typescript-eslint` rules through `projectService`, resolving
+  the prior exit-code-2 crash. Package lint is enforced in CI alongside root
+  lint. Genuine import-sorting and type-annotation lint defects in extension
+  tests are fixed.
+
+- **API documentation synchronisation.** `site/scripts/build-api.ts` now
+  processes `@codexo/exojs-tilemap` alongside the other official extension
+  packages. The `tilemap` subsystem appears in the API index and content
+  collection schema. A deterministic `docs:api:check` command verifies that
+  committed API docs match a fresh generation from source.
+
+### Known Limitations
+
+- **Infinite Tiled maps** are parsed but not converted to runtime `TileMap`
+  instances (internal chunk grid requires finite bounds).
+- **Object/image/group layers** parse correctly but do not produce rendered
+  scene nodes — only tile layers are converted.
+- **Tilemap atlas bleeding** may occur at tile edges with linear or mipmap
+  texture filtering when atlas tile regions lack sufficient padding or
+  extrusion, causing neighbouring texel bleeding.
+- **No runtime autotiling.** Tiled terrain/wang sets are not evaluated.
+- **Single-texture batching.** NineSlice, RepeatingSprite, and Tilemap
+  renderers support different textures, but they do not combine several
+  textures into a single multi-texture draw batch. Texture changes therefore
+  create batch boundaries. For RepeatingSprite, sampler and strategy changes
+  also create batch boundaries. For Tilemap, batches are grouped by compatible
+  state and tileset texture.
+
+### Package Graph
+
+After this release the published lockstep package set is:
+
+```
+@codexo/exojs         0.13.0
+@codexo/exojs-particles  0.13.0  (peer @codexo/exojs 0.13.x)
+@codexo/exojs-tilemap    0.13.0  (peer @codexo/exojs 0.13.x)
+@codexo/exojs-tiled      0.13.0  (peer @codexo/exojs 0.13.x, dep @codexo/exojs-tilemap 0.13.0)
+```
+
+`create-exo-app` is independently versioned and not in engine lockstep.
 
 ## [0.12.0] - 2026-06-09
 

package/README.md

@@ -1,42 +1,67 @@
 # ExoJS
 
-ExoJS is a TypeScript-first 2D runtime for games and interactive apps, built around explicit scenes, practical rendering features, and predictable runtime behavior.
+A TypeScript-first 2D engine for games and interactive apps. Explicit scene graph, WebGPU/WebGL2 rendering, native physics, spatial audio, and a strict type system — measured and verified, not just claimed.
 
 **[Guide](https://exoridus.github.io/ExoJS/en/guide/)** · **[API Reference](https://exoridus.github.io/ExoJS/en/api/)** · **[Playground](https://exoridus.github.io/ExoJS/en/playground/)**
 
-## Project status
+> **Pre-1.0.** The public API is under active design — minor versions may include breaking changes. Pin exact versions in downstream projects. `1.0.0` marks the first stable API contract.
 
-ExoJS is **pre-1.0**. The public API is still under active design — scene graph, rendering pipeline, and resource lifecycle boundaries may change between minor versions. Pin exact versions in downstream experiments. `1.0.0` will mark the first stable API contract.
+## Packages
+
+| Package                   | Description                                                        |
+| ------------------------- | ------------------------------------------------------------------ |
+| `@codexo/exojs`           | Core runtime — scene graph, rendering, audio, UI, serialization    |
+| `@codexo/exojs-physics`   | Native 2D physics — shapes, constraints, TGS-Soft solver           |
+| `@codexo/exojs-particles` | GPU-driven particles (WebGPU compute) with CPU fallback            |
+| `@codexo/exojs-tilemap`   | Format-independent tilemap runtime and object layers               |
+| `@codexo/exojs-tiled`     | Tiled JSON adapter and scene-graph conversion                      |
+| `@codexo/exojs-audio-fx`  | Audio effects — biquad filters, analyser, beat detection, worklets |
 
 ## Features
 
-- `Application`, `Scene`, and scene-manager lifecycle
-- Scene stacking (`overlay` / `modal` / `opaque`) with input routing and fade transitions
-- Typed `Loader` with manifest/bundle workflow (`defineAssetManifest`, `registerManifest`, `loadBundle`)
-- Drawables: `Sprite`, `AnimatedSprite`, `Graphics`, `ParticleSystem`, `Text`, `Video`
-- WebGPU-first rendering with automatic WebGL2 fallback
-- GPU-driven particles (WebGPU compute) with a CPU fallback for WebGL2
-- Rendering composition primitives (`RenderTexture`, `RenderPipeline`, filter chains, visual masks, cache-as-bitmap)
-- Linear and radial gradients for `Graphics` fills and strokes (`fillStyle` / `strokeStyle`)
-- View/camera helpers (`follow`, bounds clamp, shake, zoom)
-- Audio with sprites, spatial panning, and frequency/waveform analysis
-- Render stats (`submittedNodes`, `culledNodes`, `drawCalls`, `batches`, `renderPasses`, ...) and a benchmark harness
+**Rendering**
 
-## Roadmap
+- WebGPU-first with automatic WebGL2 fallback; force either backend with one option
+- Drawables: `Sprite`, `AnimatedSprite`, `NineSliceSprite`, `RepeatingSprite`, `Graphics`, `Text` (SDF), `BitmapText`, `Video`
+- Rendering composition: `RenderTexture`, `RenderPipeline`, filter chains, visual masks, cache-as-bitmap
+- Immediate-mode rendering: one-off `drawGeometry` and instanced `RenderBatch` collapsing to a single draw call
+- Linear and radial gradients, pixel snapping, view/camera helpers (`follow`, shake, zoom, bounds clamp)
+- Render stats with GPU memory accounting (`gpuMemoryBytes`, texture/buffer upload bytes)
 
-Directional work on the way to the `1.0.0` API freeze. Priorities and ordering may change — nothing here is a release commitment.
+**Scene & UI**
 
-- Save/load persistence helper
-- Screen-level post-processing stack (bloom, CRT, vignette, chromatic aberration)
-- Path following with Bézier and Catmull-Rom splines
-- Simple 2D lighting and shadows
-- Tilemap / tileset support (Tiled JSON)
-- Additional scene transitions (slide, crossfade) plus custom transition effects
-- UI widget layer (button, label, panel, slider) with keyboard and gamepad navigation
-- Localization primitive
-- Opt-in `Signal` registry for dev tooling, tree-shakeable in production
-- Live documentation, guides, and playground site
-- Final pre-1.0 API audit and stabilization pass
+- `Application`, `Scene`, `SceneManager` — one active scene with `setScene`, fade transitions, and `scene.paused`
+- `scene.ui` — screen-fixed widget layer with `Label`, `Panel`, `Button`, `ProgressBar`, `Stack`, anchoring, and a `FocusManager` with keyboard and gamepad navigation
+
+**Physics** (`@codexo/exojs-physics`)
+
+- Circles, boxes, capsules, and convex polygons; static, kinematic, and dynamic bodies
+- SAP broadphase, manifold narrow-phase, warm-started TGS-Soft solver (sub-stepped, stable to 20+ box stacks)
+- Contact graph, collision events, spatial queries; allocation-free per step (V8-sampler verified)
+- Scene-graph binding and a `/debug` draw subpath
+
+**Audio**
+
+- Voice capability matrix across `Sound`, `AudioStream`, and `AudioGenerator`
+- Spatial panning, audio sprites, frequency and waveform analysis
+- `@codexo/exojs-audio-fx`: `BiquadEffect`, `AudioAnalyser`, `BeatDetector`, worklets, and DSP helpers
+
+**Assets & Storage**
+
+- Typed `Loader` with manifest/bundle workflow (`defineAssetManifest`, `loadBundle`)
+- Binary asset containers (`loader.loadContainer`) for bundled distribution
+- Key-value persistence: `WebStorageStore` (localStorage/sessionStorage), `IndexedDbKeyValueStore` (structured-clone, binary-safe), `MemoryStore` (tests/ephemeral)
+
+**Serialization**
+
+- `Scene.serialize` / `deserialize` captures scene structure — nodes, drawables, UI, tilemap
+- `SerializationRegistry` and `Prefab` for templates; pairs with any `KeyValueStore` for save-slot persistence
+
+**Architecture**
+
+- `noUncheckedIndexedAccess` + `exactOptionalPropertyTypes` across the full codebase — zero `as any`, zero `ts-ignore`
+- Ordered `SystemRegistry` (`app.systems`, `scene.systems`) with deterministic tick bands
+- Deterministic disposal via `Destroyable` / `DisposalScope`; all managers are app-owned, not process singletons
 
 ## Getting Started
 
@@ -68,8 +93,15 @@ npm run dev
 npm install @codexo/exojs
 ```
 
-ExoJS publishes an ESM-first package shape. Use `import` syntax with modern bundlers/runtime tooling.
-CommonJS `require()` usage is not part of the supported contract for this pre-1.0 line.
+ExoJS is ESM-only. Use `import` syntax with a modern bundler or runtime.
+Optional packages install independently — add only what your project needs:
+
+```bash
+npm install @codexo/exojs-physics
+npm install @codexo/exojs-particles
+npm install @codexo/exojs-tilemap @codexo/exojs-tiled
+npm install @codexo/exojs-audio-fx
+```
 
 ## Quickstart
 
@@ -99,47 +131,41 @@ class HelloScene extends Scene {
   }
 }
 
-const canvas = document.querySelector('canvas');
-
-if (!canvas) {
-  throw new Error('Missing <canvas> element.');
-}
-
 const app = new Application({
-  canvas: {
-    element: canvas,
-    width: 800,
-    height: 600,
-  },
+  canvas: { element: document.querySelector('canvas')!, width: 800, height: 600 },
   clearColor: Color.cornflowerBlue,
 });
 
 await app.start(new HelloScene());
 ```
 
-## Next Steps
+See the [Guide](https://exoridus.github.io/ExoJS/en/guide/) for physics, audio, UI, and more, or browse the [live examples](https://exoridus.github.io/ExoJS/).
 
-- In-repo examples: [examples/README.md](examples/README.md)
+## Roadmap
 
-## WebGPU and WebGL2
+Directional work toward the `1.0.0` API freeze. Priorities may shift — nothing here is a release commitment.
 
-`Application` defaults to backend auto-selection:
+- Physics joints, sleeping, and CCD (ragdolls, vehicles, ropes, fast projectiles)
+- W3C blend mode suite — multiply, screen, overlay, and the full non-separable set
+- Additional scene transitions (slide, crossfade, custom)
+- Screen-level post-processing (bloom, CRT, vignette, chromatic aberration)
+- Path following with Bézier and Catmull-Rom splines
+- Tween sequencer and coroutine helpers
+- Aseprite and LDtk first-party adapters
+- CDN/IIFE bundle for script-tag usage
+- Localization primitive
+- Final pre-1.0 API audit and stabilization pass
 
-- prefers WebGPU when available
-- falls back to WebGL2 if WebGPU is unavailable or initialization fails
+## WebGPU and WebGL2
 
-You can force backend selection when needed:
+`Application` auto-selects the best available backend. Force one when needed:
 
 ```ts
 new Application({ backend: { type: 'webgpu' } });
 new Application({ backend: { type: 'webgl2' } });
-new Application({ backend: { type: 'auto' } });
+new Application({ backend: { type: 'auto' } }); // default
 ```
 
-## Examples
-
-The runnable live site (Astro + Lit + Monaco preview) lives in [`examples/`](examples/README.md) and is deployed as the repository's GitHub Pages site at <https://exoridus.github.io/ExoJS/>.
-
 ## Development
 
 ```bash
@@ -151,16 +177,9 @@ pnpm build
 pnpm verify:package
 ```
 
-Package-internal imports use Node `package.json#imports` subpath imports: `./X` for the
-same directory, `#dir/X` for any other path in the same package, and the public bare
-specifier (`@codexo/exojs`) across packages. See [CONTRIBUTING.md](./CONTRIBUTING.md)
-for the full import policy, per-package commands, and the shared `@codexo/exojs-config`
-tooling. Building the library requires TypeScript 6.
-
-### Workspace Commands
+Package-internal imports use Node `package.json#imports` subpath imports: `./X` for the same directory, `#dir/X` for any other path in the same package, and the public bare specifier (`@codexo/exojs`) across packages. See [CONTRIBUTING.md](./CONTRIBUTING.md) for the full import policy, per-package commands, and the shared `@codexo/exojs-config` tooling. Building the library requires TypeScript 6.
 
-This repository uses pnpm workspaces (`site/` is a workspace package).
-Use root-level commands as the source of truth:
+This repository uses pnpm workspaces (`site/` is a workspace package). Use root-level commands as the source of truth — avoid running `pnpm install` inside `site/` directly:
 
 ```bash
 pnpm bootstrap
@@ -168,8 +187,6 @@ pnpm site:build
 pnpm site:build:api
 ```
 
-Avoid running `pnpm install` inside `site/` directly to prevent lockfile drift.
-
 ## Links
 
 - Repository: <https://github.com/Exoridus/ExoJS>

package/dist/esm/animation/Tween.js

@@ -317,7 +317,7 @@ class Tween {
         for (const key of keys) {
             const start = this._startValues[key];
             const end = properties[key];
-            if (end === undefined)
+            if (start === undefined || end === undefined)
                 continue;
             this._target[key] = start + (end - start) * easedT;
         }

package/dist/esm/animation/Tween.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tween.js","sources":["../../../../src/animation/Tween.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"Tween.js","sources":["../../../../src/animation/Tween.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/animation/TweenManager.d.ts

@@ -1,3 +1,5 @@
+import type { System } from '#core/System';
+import type { Time } from '#core/Time';
 import { Tween } from './Tween';
 /**
  * Owns and advances a collection of {@link Tween} instances, driving them
@@ -10,7 +12,9 @@ import { Tween } from './Tween';
  * stopped tweens are evicted automatically.
  * @stable
  */
-export declare class TweenManager {
+export declare class TweenManager implements System {
+    /** App-systems tick band — tweens after audio. @internal */
+    readonly order = 400;
     private _tweens;
     private _destroyed;
     /**
@@ -40,11 +44,11 @@ export declare class TweenManager {
     /** Remove a tween from the manager. Called automatically on stop/complete. */
     remove(tween: Tween): this;
     /**
-     * Advance all active tweens by deltaSeconds. Called once per frame by
-     * Application.update(). Uses a snapshot of the list so that callbacks that
-     * add or remove tweens do not corrupt mid-iteration.
+     * Advance all active tweens by the frame `delta` (read as seconds). Ticked
+     * once per frame via {@link Application.systems}. Uses a snapshot of the list
+     * so that callbacks that add or remove tweens do not corrupt mid-iteration.
      */
-    update(deltaSeconds: number): void;
+    update(delta: Time): void;
     /**
      * Remove all tweens immediately. No callbacks (onComplete etc.) fire.
      * The tweens' states are left as-is; they are simply evicted from the list.

package/dist/esm/animation/TweenManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TweenManager.d.ts","sourceRoot":"","sources":["../../../src/animation/TweenManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,UAAU,CAAS;IAE3B;;;OAGG;IACI,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAQpD;;;;;;;;;;;;OAYG;IACI,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,KAAK;IAgBhD;;;OAGG;IACI,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAU9B,8EAA8E;IACvE,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAUjC;;;;OAIG;IACI,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAUzC;;;OAGG;IACI,KAAK,IAAI,IAAI;IAMpB,gFAAgF;IACzE,OAAO,IAAI,IAAI;CAIvB"}
+{"version":3,"file":"TweenManager.d.ts","sourceRoot":"","sources":["../../../src/animation/TweenManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,qBAAa,YAAa,YAAW,MAAM;IACzC,4DAA4D;IAC5D,SAAgB,KAAK,OAAO;IAC5B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,UAAU,CAAS;IAE3B;;;OAGG;IACI,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAQpD;;;;;;;;;;;;OAYG;IACI,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,KAAK;IAoBhD;;;OAGG;IACI,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAU9B,8EAA8E;IACvE,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAUjC;;;;OAIG;IACI,MAAM,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI;IAUhC;;;OAGG;IACI,KAAK,IAAI,IAAI;IAMpB,gFAAgF;IACzE,OAAO,IAAI,IAAI;CAIvB"}

package/dist/esm/animation/TweenManager.js

@@ -12,6 +12,8 @@ import { Tween } from './Tween.js';
  * @stable
  */
 class TweenManager {
+    /** App-systems tick band — tweens after audio. @internal */
+    order = 400;
     _tweens = [];
     _destroyed = false;
     /**
@@ -38,16 +40,20 @@ class TweenManager {
      * ```
      */
     sequence(tweens) {
-        if (tweens.length === 0) {
+        const [first] = tweens;
+        if (first === undefined) {
             throw new Error('[ExoJS] TweenManager.sequence() requires at least one tween.');
         }
         for (let i = 0; i < tweens.length - 1; i++) {
-            tweens[i].chain(tweens[i + 1]);
+            const current = tweens[i];
+            const next = tweens[i + 1];
+            if (current !== undefined && next !== undefined)
+                current.chain(next);
         }
         for (const tween of tweens) {
             this.add(tween);
         }
-        return tweens[0];
+        return first;
     }
     /**
      * Explicitly add a stand-alone Tween (created via `new Tween(target)`)
@@ -69,16 +75,16 @@ class TweenManager {
         return this;
     }
     /**
-     * Advance all active tweens by deltaSeconds. Called once per frame by
-     * Application.update(). Uses a snapshot of the list so that callbacks that
-     * add or remove tweens do not corrupt mid-iteration.
+     * Advance all active tweens by the frame `delta` (read as seconds). Ticked
+     * once per frame via {@link Application.systems}. Uses a snapshot of the list
+     * so that callbacks that add or remove tweens do not corrupt mid-iteration.
      */
-    update(deltaSeconds) {
+    update(delta) {
         if (this._destroyed)
             return;
         const snapshot = [...this._tweens];
         for (const tween of snapshot) {
-            tween.update(deltaSeconds);
+            tween.update(delta.seconds);
         }
     }
     /**

package/dist/esm/animation/TweenManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"TweenManager.js","sources":["../../../../src/animation/TweenManager.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;;;;;;;AAUG;MACU,YAAY,CAAA;IACf,OAAO,GAAY,EAAE;IACrB,UAAU,GAAG,KAAK;AAE1B;;;AAGG;AACI,IAAA,MAAM,CAAmB,MAAS,EAAA;AACvC,QAAA,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC;AAC/B,QAAA,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC;AAC1B,QAAA,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;AAExB,QAAA,OAAO,KAAK;IACd;AAEA;;;;;;;;;;;;AAYG;AACI,IAAA,QAAQ,CAAC,MAAwB,EAAA;AACtC,QAAA,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE;AACvB,YAAA,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC;QACjF;AAEA,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE;AAC1C,YAAA,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChC;AAEA,QAAA,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;AAC1B,YAAA,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;QACjB;AAEA,QAAA,OAAO,MAAM,CAAC,CAAC,CAAC;IAClB;AAEA;;;AAGG;AACI,IAAA,GAAG,CAAC,KAAY,EAAA;AACrB,QAAA,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC;QAE1B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;AACjC,YAAA,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;QAC1B;AAEA,QAAA,OAAO,IAAI;IACb;;AAGO,IAAA,MAAM,CAAC,KAAY,EAAA;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;AAEzC,QAAA,IAAI,KAAK,KAAK,EAAE,EAAE;YAChB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/B;AAEA,QAAA,OAAO,IAAI;IACb;AAEA;;;;AAIG;AACI,IAAA,MAAM,CAAC,YAAoB,EAAA;QAChC,IAAI,IAAI,CAAC,UAAU;YAAE;QAErB,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;AAElC,QAAA,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE;AAC5B,YAAA,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC;QAC5B;IACF;AAEA;;;AAGG;IACI,KAAK,GAAA;AACV,QAAA,IAAI,CAAC,OAAO,GAAG,EAAE;AAEjB,QAAA,OAAO,IAAI;IACb;;IAGO,OAAO,GAAA;QACZ,IAAI,CAAC,KAAK,EAAE;AACZ,QAAA,IAAI,CAAC,UAAU,GAAG,IAAI;IACxB;AACD;;;;"}
+{"version":3,"file":"TweenManager.js","sources":["../../../../src/animation/TweenManager.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAKA;;;;;;;;;;AAUG;MACU,YAAY,CAAA;;IAEP,KAAK,GAAG,GAAG;IACnB,OAAO,GAAY,EAAE;IACrB,UAAU,GAAG,KAAK;AAE1B;;;AAGG;AACI,IAAA,MAAM,CAAmB,MAAS,EAAA;AACvC,QAAA,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC;AAC/B,QAAA,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC;AAC1B,QAAA,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;AAExB,QAAA,OAAO,KAAK;IACd;AAEA;;;;;;;;;;;;AAYG;AACI,IAAA,QAAQ,CAAC,MAAwB,EAAA;AACtC,QAAA,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM;AAEtB,QAAA,IAAI,KAAK,KAAK,SAAS,EAAE;AACvB,YAAA,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC;QACjF;AAEA,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE;AAC1C,YAAA,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC;YACzB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC;AAC1B,YAAA,IAAI,OAAO,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS;AAAE,gBAAA,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;QACtE;AAEA,QAAA,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;AAC1B,YAAA,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;QACjB;AAEA,QAAA,OAAO,KAAK;IACd;AAEA;;;AAGG;AACI,IAAA,GAAG,CAAC,KAAY,EAAA;AACrB,QAAA,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC;QAE1B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;AACjC,YAAA,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;QAC1B;AAEA,QAAA,OAAO,IAAI;IACb;;AAGO,IAAA,MAAM,CAAC,KAAY,EAAA;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;AAEzC,QAAA,IAAI,KAAK,KAAK,EAAE,EAAE;YAChB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/B;AAEA,QAAA,OAAO,IAAI;IACb;AAEA;;;;AAIG;AACI,IAAA,MAAM,CAAC,KAAW,EAAA;QACvB,IAAI,IAAI,CAAC,UAAU;YAAE;QAErB,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;AAElC,QAAA,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE;AAC5B,YAAA,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;QAC7B;IACF;AAEA;;;AAGG;IACI,KAAK,GAAA;AACV,QAAA,IAAI,CAAC,OAAO,GAAG,EAAE;AAEjB,QAAA,OAAO,IAAI;IACb;;IAGO,OAAO,GAAA;QACZ,IAAI,CAAC,KAAK,EAAE;AACZ,QAAA,IAAI,CAAC,UAAU,GAAG,IAAI;IACxB;AACD;;;;"}

package/dist/esm/animation/index.d.ts

@@ -1,5 +1,7 @@
-export * from './Easing';
-export * from './Tween';
-export * from './TweenManager';
-export * from './types';
+export type { EasingFunction } from './Easing';
+export { Ease } from './Easing';
+export { Tween } from './Tween';
+export { TweenManager } from './TweenManager';
+export type { TweenLifecycleCallback, TweenUpdateCallback } from './types';
+export { TweenState } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/animation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/animation/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/animation/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}