@codexo/exojs 0.13.0 → 0.15.0

package/CHANGELOG.md

@@ -4,13 +4,272 @@ 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.15.0] - 2026-07-02
+
+The rendering-views and audio-effects release. Core's render surface is
+reworked around `View` (folding in `Camera`), a scoped `PassContext` that
+stops pass callbacks from leaking state across targets, and multi-view
+viewport parity between WebGL2 and WebGPU (split-screen, picture-in-picture,
+minimaps). `@codexo/exojs-audio-fx` gains ten new insert effects and a
+flagship-hardened `BeatDetector` (correct tempo tracking across 50–300 BPM,
+92–99% recall, 1–4 ms beat offsets). `@codexo/exojs-ldtk`, `-aseprite`, and
+`-tiled` reach format completeness (multi-world LDtk, Aseprite frame
+direction/repeat/slices, structured Tiled/LDtk property values). 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
+
+- **View API.** `View.from(options)` (`center`/`size`/`viewport`/`rotation`/
+  `zoom`) and a fluent `View.setViewport(x, y, w, h)` using SFML-style
+  normalized (0..1) viewport rectangles, enabling split-screen,
+  picture-in-picture, and minimap compositions (#217).
+- **Scoped pass context.** `DrawContext` and `PassContext` give a pass
+  callback a read-only `target`/`view` and route `clear`/`render`/`renderTo`/
+  `draw*` through the owning `RenderingContext`, so a callback can no longer
+  reset the active view or leak draws onto another target (#217).
+- **`@codexo/exojs-audio-fx` — ten new insert effects.** Native:
+  `DistortionEffect`, `PhaserEffect`, `FlangerEffect`, `TremoloEffect`
+  (auto-pan), `PingPongDelayEffect`, `LimiterEffect`, `AutoWahEffect`,
+  `RingModulatorEffect`, `ConvolutionEffect` (real impulse-response
+  convolution via `ConvolverNode`). Worklet: `BitCrusherEffect`. Each follows
+  the dry/wet-gain, bypass-until-ready, ramped-setter template (#219, #221).
+- **`WorkletEffect` dry/wet gain-staging primitive.** Dry/wet fan-out and a
+  `wet` getter/setter move into the `WorkletEffect` base class, plus
+  dry-latency compensation (a dry-path `DelayNode` time-aligned to each
+  worklet's algorithmic latency); `PitchShiftEffect`, `GranularEffect`, and
+  `VocoderEffect` migrate to emit pure wet through the shared base (#220).
+- **`PitchShiftEffect` SOLA algorithm** replacing the previous approach, with
+  acoustic-contract tests across the worklet effects (#218).
+- **`BeatDetector` flagship hardening.** Octave-error fix (mean-subtracted
+  ACF, log-Gaussian metric prior, subdivision-aware super-harmonic penalty,
+  and 3:2/2:3 hysteresis), adaptive onset detection, a bounded PLL phase
+  tracker, dual fast/stable tempo windows, and provisional/locked beat
+  states. Correct tempo across 50–300 BPM (previously locked to a
+  sub-harmonic above ~90 BPM), recall 92–99% (previously 11–42%), beat
+  offsets 1–4 ms. A seeded synthetic testbench and committed golden baseline
+  make the detector objectively measurable (#221).
+- **`AnimatedSprite.repeat`** — finite N-cycle playback (`-1` loops
+  indefinitely, `1` plays once, `N` plays exactly N cycles), replacing
+  `loop: boolean`. Aseprite `direction` (pingpong/reverse) frame expansion,
+  `slices` exposure, per-frame `frameDurations` (hold-frame timing), and
+  `frameOffsets` (trim/`spriteSourceSize` anchoring) (#222).
+- **LDtk format completeness.** External `.ldtkl` level resolution, IntGrid
+  value exposure, level `fieldInstances`, entity pivot correction, and
+  multi-world support (`worlds[]` flattened with an `ldtkWorldIid` tag,
+  single-world docs unaffected) (#222).
+- **Structured `TilePropertyValue` variants** (Point/EntityRef/Tile) for LDtk
+  fields and Tiled `object`/`class`-typed custom properties, previously
+  dropped or left untagged (#222).
+- **`WheelJoint` suspension-travel limit** (`enableLimit`/`lowerTranslation`/
+  `upperTranslation`), matching `PrismaticJoint`'s existing limit (#224).
+- **React `useSignal` hook** bridges an engine `Signal` into React via
+  `useSyncExternalStore`; `ExoCanvas`/`useExoApplication` gain an `onError`
+  counterpart to `onReady`, wired to `Application.onError` (#224).
+- **WebGPU CI lane** now runs against Mesa lavapipe (a real Vulkan software
+  rasterizer) as a required, blocking check, with real GPU-side pixel
+  readback and a WGSL compile-coverage test mirroring the existing GLSL one
+  (#222).
+
+### Changed
+
+- **BREAKING — `Camera` folded into `View`.** The `Camera` class is removed;
+  `RenderingContext.camera` becomes `RenderingContext.view` (the `view` alias
+  is gone). `screenView` is unchanged (#217).
+- **BREAKING — `CallbackRenderPass` callbacks receive a `PassContext`**
+  instead of the raw `RenderingContext`. The previous allocating `renderTo`
+  is renamed `capture()`; a new caller-owned `renderTo` (accepting `target`,
+  `view`, and `clear`) and coordinator-routed `context.clear(color)` are
+  added (#217).
+- **Graphics fill is now opt-in.** `drawRectangle`/`drawCircle`/etc. no
+  longer build a hidden opaque-black fill mesh by default — outline-only
+  shapes stop silently painting a fill (#217).
+- **Multi-view viewport parity.** WebGL2 partial top-left viewports
+  (split-screen/picture-in-picture/minimap) no longer land at the wrong edge
+  (GL's viewport origin is bottom-left); WebGPU's pass coordinator now
+  applies the active view's viewport to match. Any view used in a render
+  ticks its follow/shake automatically next frame — `trackView`/`untrackView`
+  are now only an escape hatch (#217).
+- **Raw `console.*` calls routed through the DEV-gated logger.**
+  `Tween`/`Application`/`SceneManager`/`HTMLText` warnings and errors go
+  through `logger`/`warnOnce` instead of `console.*`, so they no longer ship
+  in production builds (#216).
+- **`LimiterEffect.ratio`/`.knee`** are now configurable, matching sibling
+  `CompressorEffect` (defaults unchanged) (#224).
+- **German (`de/`) locale pages** render the real English content directly
+  instead of a "translation coming soon" stub (#224).
+
+### Removed
+
+- **BREAKING — `PhysicsWorldOptions.interpolation` and
+  `BindingOptions.drive: 'node-to-body'`** — both were documented as
+  "reserved, no effect yet" and referenced nowhere (#224).
+
+### Fixed
+
+- **WebGL2 text rendering.** `WebGl2TextRenderer` bypassed the backend's
+  texture-unit cache when binding its node-data texture; when text rendered
+  first in a frame the atlas bound to the wrong unit and every glyph went
+  transparent (#215).
+- **Gamepad input froze after connect.** `InputManager.updateGamepads` never
+  re-read `navigator.getGamepads()` for already-connected pads; button/axis
+  state is now polled fresh every frame (#215).
+- **WebGPU shader filters rendered a black screen** (`crt-scanlines`,
+  `chromatic-aberration`) when the canvas' preferred texture format differed
+  from the filter's offscreen `rgba8unorm` output — `WebGpuShaderFilter`
+  cached its pipeline against whichever format was bound at first use instead
+  of its own output texture's format (#226).
+- Audio-fx ducking logged a spurious `setTargetAtTime` out-of-range warning
+  every frame; its attack/release params are `[0,1]` smoothing coefficients,
+  not times (#215).
+- Several playground examples (svg-drawable, trail-feedback,
+  tiled-physics-actor) fixed: a 0×0 rasterized SVG texture, a render-target
+  feedback loop, and a broken relative import in the playground's import map
+  (#215).
+
+### Docs
+
+- Audio effects guide extended with all ten effects added in #218–#221;
+  README quickstart switched to the `load()` lifecycle hook (#223).
+- Guide coverage catch-up: the full 18-mode W3C blend suite, `Tooltip`/
+  `ScrollContainer` widgets, loader progress signals and `Logger`, live
+  `sizingMode`/`clearColor`, `cullArea`, `fixedUpdate`/`frameAlpha`, and the
+  IIFE/CDN bundle path (#225).
+
+## [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**.
+
+### 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
 

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,20 +93,25 @@ 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
 
 ```ts
-import { Application, Scene, Graphics, Color, type RenderingContext, type Time } from '@codexo/exojs';
+import { Application, Scene, Graphics, Color, Loader, type RenderingContext, type Time } from '@codexo/exojs';
 
 class HelloScene extends Scene {
   private readonly box = new Graphics();
 
-  public constructor() {
-    super();
-
+  public override init(loader: Loader): void {
     this.box.fillColor = Color.white;
     this.box.drawRectangle(-32, -32, 64, 64);
     this.box.setPosition(400, 300);
@@ -99,47 +129,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 +175,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.
+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
-
-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 +185,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.d.ts.map

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

package/dist/esm/animation/Tween.js

@@ -299,7 +299,6 @@ class Tween {
         for (const key of keys) {
             const val = this._target[key];
             if (typeof val !== 'number') {
-                console.warn(`Tween: property "${String(key)}" is not a number on target ` + `(got ${typeof val}). It will be skipped.`);
                 continue;
             }
             snap[String(key)] = val;
@@ -317,7 +316,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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"}