@codexo/exojs 0.7.11 → 0.7.13

package/CHANGELOG.md

@@ -4,6 +4,448 @@ 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).
 
+## [0.7.13] - 2026-05-07
+
+Major gamepad-input refactor. Replaces the `new Input(...)` +
+`inputManager.add(...)` pattern with a fluent listener API, splits the
+unified `GamepadChannel` enum into disjoint `GamepadButton` /
+`GamepadAxis` for type-safe button-vs-axis distinction, introduces
+always-4 stable gamepad slots with disconnect-aware listeners, and adds
+rumble, generic per-pad signals, slot-strategy configuration, aggregate
+signed stick channels, and Joy-Con-honest mappings.
+
+### Added — Listener API
+
+```ts
+// Per inputManager (manual unbind):
+app.input.onTrigger(GamepadButton.South, () => player.jump());
+app.input.onActive(GamepadAxis.LeftStickX, (v) => player.x += v * 5);
+app.input.onStart([Keyboard.Space, GamepadButton.South], () => fire());
+
+// Per gamepad (slot-aware, listener survives disconnect/reconnect):
+const pad = app.input.getGamepad(0);
+pad.onTrigger(GamepadButton.South, () => p1.jump());
+
+// Per scene (auto-disposed on scene unload):
+this.inputs.onTrigger(Keyboard.Escape, () => this.app.sceneManager.popScene());
+```
+
+Each method returns an `InputBinding` with `.unbind()` for manual
+lifecycle. Single channel or array of channels is accepted.
+
+### Added — Always-4 gamepad slots
+
+`InputManager.gamepads` is now a fixed
+`readonly [Gamepad, Gamepad, Gamepad, Gamepad]` tuple. Each `Gamepad`
+instance lives for the application's lifetime; check `pad.connected` for
+hardware presence. Listeners attached when a slot is empty automatically
+activate when a pad connects to that slot — no rebinding required.
+
+Convenience accessors on `app.input`:
+
+- `getGamepad(slot)` — readable single-slot accessor (equivalent to
+  `gamepads[slot]`).
+- `connectedGamepads: readonly Gamepad[]` — only the currently-attached
+  pads, in slot order.
+- `connectedGamepadCount: number`
+- `firstConnectedGamepad: Gamepad | null`
+- `hasGamepad: boolean`
+
+Per-pad: `pad.internalIndex` returns the browser's `Gamepad.index` for
+the attached hardware (or `null` when disconnected). Low-level escape
+hatch — prefer `pad.slot` for stable application-side identity.
+
+### Added — Slot strategy
+
+`new Application({ gamepadSlotStrategy: 'sticky' | 'compact' })` —
+default `'sticky'` (each pad keeps its slot through disconnects).
+`'compact'` shifts higher-numbered pads down to fill gaps after a
+disconnect (good for hot-seat couch coop where "the first N pads are
+the N players" is the desired semantic).
+
+In compact mode, the disconnect signal fires on the slot that *ended
+up* empty after the shift (not the slot the disconnected hardware
+originally occupied), keeping `pad.connected === false` consistent with
+the fired event. Slots that received a different physical pad through
+the shift dispatch a separate signal:
+
+- `pad.onPadReassigned: Signal<[fromSlot: 0 | 1 | 2 | 3]>`
+- `app.input.onAnyGamepadReassigned: Signal<[Gamepad, fromSlot]>`
+
+so player-binding code can re-resolve which `Gamepad` belongs to which
+player when slots renumber.
+
+### Added — Generic signals
+
+Per-pad:
+- `pad.onConnect: Signal<[]>`
+- `pad.onDisconnect: Signal<[]>`
+- `pad.onButtonDown: Signal<[GamepadButton, number]>`
+- `pad.onButtonUp: Signal<[GamepadButton, number]>`
+- `pad.onAxisChange: Signal<[GamepadAxis, number]>`
+
+Aggregate across all pads:
+- `inputManager.onAnyGamepadButtonDown: Signal<[Gamepad, GamepadButton, number]>`
+- `inputManager.onAnyGamepadButtonUp: Signal<[Gamepad, GamepadButton, number]>`
+- `inputManager.onAnyGamepadAxisChange: Signal<[Gamepad, GamepadAxis, number]>`
+
+### Added — Vibration
+
+```ts
+if (pad.canVibrate) {
+    await pad.vibrate({ duration: 200, weakMagnitude: 0.5, strongMagnitude: 1.0 });
+}
+pad.stopVibration();
+```
+
+Wraps the W3C `vibrationActuator.playEffect('dual-rumble')` API. Silent
+no-op on platforms without haptic support — use `pad.canVibrate` to
+detect availability for UI gating. Trigger-rumble (PS5 / Xbox Series
+adaptive triggers) is not exposed because browser support is currently
+Chrome-only and non-standard.
+
+### Added — Aggregate axis channels
+
+`GamepadAxis.LeftStickX`, `LeftStickY`, `RightStickX`, `RightStickY` —
+signed -1..1 values that consume the full bipolar range of the physical
+stick. Use these for stick-style movement input; the existing
+direction-split channels (`LeftStickLeft`, `LeftStickRight`, etc.)
+remain available for buttons-style 0..1 input.
+
+```ts
+// Stick-style — one binding per axis, signed value:
+this.inputs.onActive(GamepadAxis.LeftStickX, (x) => player.x += x * 5);
+
+// Buttons-style — separate bindings per direction, 0..1 each:
+this.inputs.onActive(GamepadAxis.LeftStickLeft,  (v) => player.x -= v * 5);
+this.inputs.onActive(GamepadAxis.LeftStickRight, (v) => player.x += v * 5);
+```
+
+### Added — `pad.hasChannel(channel)` capability check
+
+```ts
+if (pad.hasChannel(GamepadAxis.RightStickX)) {
+    pad.onActive(GamepadAxis.RightStickX, (v) => crosshair.x += v * 8);
+}
+```
+
+Returns `true` only when the pad's mapping declares the requested
+channel. Useful for graceful degradation on devices with limited
+hardware (e.g. single Joy-Con without a right stick).
+
+### Added — `Scene.inputs` proxy
+
+Bindings created via `this.inputs.onTrigger(...)` etc. are automatically
+disposed when the scene unloads. No manual cleanup tracking required.
+Internally tracks each binding and calls `.unbind()` in `Scene.destroy`.
+
+### Added — Steam Deck / Steam Virtual Gamepad / Valve fallback
+
+New `SteamDeckGamepadMapping` covers the raw HID layout reported by the
+Steam Deck (and likely future Valve hardware) when Steam Input is *not*
+intercepting the device. Indices follow the SDL_GameControllerDB Linux
+entry: face buttons at 3-6, D-pad at 16-19, paddles at 20-23, triggers
+as analog axes 8/9.
+
+Routing rules added to `builtInGamepadDefinitions`:
+
+| Browser ID | Mapping |
+|---|---|
+| `28de:1102`, `28de:1142` | `SteamControllerGamepadMapping` (existing, original Steam Controller raw) |
+| `28de:11ff` (Steam Virtual Gamepad — any controller via Steam Input) | `GenericDualAnalogGamepadMapping` (W3C standard Xbox emulation) |
+| `28de:1205` | `SteamDeckGamepadMapping` (raw Steam Deck) |
+| Vendor `28de` (anything else from Valve, e.g. future Steam Controller 2 raw) | `SteamDeckGamepadMapping` (best-effort fallback) |
+
+Enum: `GamepadMappingFamily.SteamDeck` added.
+
+### Added — Paddle2/3/4 buttons + Touchpad2X/Y axes
+
+The per-gamepad channel allocation is repartitioned into 32 button
+slots + 32 axis slots (was 21 / 22 with mid-block axis indices). 24
+named buttons (`South`-`Paddle4`) plus 8 reserved slots; 24 named axes
+(stick split + aggregate + dual-touchpad XY + 4 auxiliary bipolar) plus
+8 reserved slots. The reserved slots are accessible to custom mappings
+without colliding with future named additions.
+
+New named channels:
+
+- `GamepadButton.Paddle2`, `.Paddle3`, `.Paddle4` — extra paddles
+  / back buttons on Xbox Elite, PS5 Edge, Steam Deck (R4/L5/R5).
+- `GamepadAxis.Touchpad2X`, `.Touchpad2Y` — secondary touchpad on
+  dual-touchpad hardware (Steam Deck right pad).
+
+User code that previously read `GamepadButton.Paddle1` etc. is
+unaffected — channel **values** changed (offsets re-laid-out), but the
+namespace constants resolve to the new offsets transparently.
+
+### Added — JoyCon-honest mappings
+
+`JoyConLeftGamepadMapping` and `JoyConRightGamepadMapping` no longer
+inherit the full DualAnalog 16-axis layout. Each declares only channels
+that physically exist on the device (one stick mapped to LeftStick
+channels, four face buttons, SL/SR shoulders, Minus/Plus, Capture/Home,
+stick-click). Right-stick channels and other phantom hardware are
+intentionally absent — `pad.hasChannel(GamepadAxis.RightStickX)` returns
+`false` on a solo Joy-Con.
+
+### Changed — `app.inputManager` renamed to `app.input` (BREAKING)
+
+For consistency with `app.audio` and parity with the brevity of
+`app.tweens` / `app.loader` / `app.interaction`. All call sites that
+read or wrote `app.inputManager` need a one-token rename.
+
+```ts
+// Before:
+app.inputManager.onTrigger(GamepadButton.South, () => fire());
+app.inputManager.gamepads[0];
+
+// After:
+app.input.onTrigger(GamepadButton.South, () => fire());
+app.input.getGamepad(0);
+```
+
+### Fixed — Compact-mode disconnect ordering
+
+In `'compact'` slot strategy, `onDisconnect` previously fired on the
+slot the disconnected hardware originally occupied — *before* the
+compaction shift moved a different physical pad into that slot. User
+code observing the event would see `pad.connected === true` because
+the slot had been silently re-bound by the shift. Now compaction is
+applied first (silent), and `onDisconnect` fires on the slot that
+ended up empty (the trailing slot). Sticky behaviour is unchanged.
+
+### Changed — Channel naming (BREAKING)
+
+The unified `GamepadChannel` enum is split into two disjoint enums for
+nominal type safety:
+
+| Old | New (user-facing) | New (internal type) |
+|---|---|---|
+| `GamepadChannel.ButtonSouth` | `GamepadButton.South` | `GamepadButtonChannel.South` |
+| `GamepadChannel.ButtonEast` | `GamepadButton.East` | `GamepadButtonChannel.East` |
+| `GamepadChannel.LeftShoulder` | `GamepadButton.LeftShoulder` | `GamepadButtonChannel.LeftShoulder` |
+| `GamepadChannel.LeftStickLeft` | `GamepadAxis.LeftStickLeft` | `GamepadAxisChannel.LeftStickLeft` |
+| ... | ... | ... |
+
+User code references the namespace mirrors (`GamepadButton.X`,
+`GamepadAxis.Y`) — same `Pointer.X` / `Keyboard.Space` convention. Type
+checking now rejects passing a button channel where an axis is expected
+(and vice versa).
+
+### Changed — `GamepadControl` removed (BREAKING)
+
+`GamepadControl` is replaced by two concrete classes:
+
+- `GamepadButton` — wraps a button index + channel, with optional
+  `invert` and `threshold` options. `transformValue(v)` clamps to [0, 1].
+- `GamepadAxis` — wraps an axis index + channel, with optional `invert`,
+  `normalize`, `threshold`, and the new `bipolar` flag.
+  `transformValue(v)` clamps to [-1, +1] and applies the pipeline.
+
+Custom mappings construct these directly via `new GamepadButton(index, channel)`
+/ `new GamepadAxis(index, channel, options)` —
+`GamepadMapping.createControls()` is removed.
+
+### Changed — `Input` class replaced by `InputBinding` (BREAKING)
+
+`new Input(channel, { onTrigger: cb })` + `inputManager.add(input)` is
+gone. Use `inputManager.onTrigger(channel, cb)` / `pad.onTrigger(...)` /
+`scene.inputs.onTrigger(...)` instead. Returned `InputBinding` exposes
+the same `onStart`/`onActive`/`onStop`/`onTrigger` Signals plus a
+`.unbind()` method.
+
+### Changed — `inputManager.add/remove/clear/getGamepad/onGamepadUpdated` removed (BREAKING)
+
+The push-input-objects-into-the-manager API is fully replaced by the
+factory-method API. `getGamepad(index)` is replaced by direct
+`gamepads[slot]` indexing. `onGamepadUpdated` is replaced by
+`onAnyGamepadButtonDown` / `onAnyGamepadButtonUp` /
+`onAnyGamepadAxisChange` which carry semantic transition information
+instead of firing every frame.
+
+### Changed — `Gamepad` constructor signature (BREAKING)
+
+```ts
+// Before:
+new Gamepad(index, channels, mapping)
+new Gamepad(browserGamepad, channels, definition)
+
+// After (engine-internal — InputManager handles slot allocation):
+new Gamepad(slot, channels)
+// followed by pad._bind(browserGamepad, definition) on connect
+```
+
+User code does not construct `Gamepad` instances directly. Reads from
+`pad.info` / `pad.mapping` / `pad.connected` instead of the previous
+`pad.name` / `pad.label` / `pad.vendorId` / etc. inline accessors.
+
+### Migration guide
+
+```ts
+// Before:
+import { Input, GamepadChannel, Keyboard } from '@codexo/exojs';
+
+const jump = new Input(GamepadChannel.ButtonSouth, { onTrigger: () => player.jump() });
+app.input.add(jump);
+
+// After (any of three styles, depending on lifecycle):
+import { GamepadButton, Keyboard } from '@codexo/exojs';
+
+// Manual lifecycle
+const binding = app.input.onTrigger(GamepadButton.South, () => player.jump());
+binding.unbind();   // when done
+
+// Auto-disposed on scene unload
+this.inputs.onTrigger(GamepadButton.South, () => player.jump());
+
+// Pinned to a specific pad slot
+this.app.input.gamepads[0].onTrigger(GamepadButton.South, () => player.jump());
+```
+
+```ts
+// Stick movement — before:
+const moveLeft  = new Input(GamepadChannel.LeftStickLeft);
+const moveRight = new Input(GamepadChannel.LeftStickRight);
+app.input.add(moveLeft);
+app.input.add(moveRight);
+// per frame: const x = moveRight.value - moveLeft.value;
+
+// After (signed aggregate channel):
+this.inputs.onActive(GamepadAxis.LeftStickX, (x) => player.x += x * 5);
+```
+
+```ts
+// Custom mapping — before:
+import { GamepadMapping, GamepadChannel } from '@codexo/exojs';
+const buttons = GamepadMapping.createControls([
+    [0, GamepadChannel.ButtonSouth],
+    [1, GamepadChannel.ButtonEast],
+]);
+
+// After:
+import { GamepadButton, GamepadMapping, GamepadMappingFamily } from '@codexo/exojs';
+class MyMapping extends GamepadMapping {
+    public readonly family = GamepadMappingFamily.GenericDualAnalog;
+    public constructor() {
+        super(
+            [
+                new GamepadButton(0, GamepadButton.South),
+                new GamepadButton(1, GamepadButton.East),
+            ],
+            [],
+        );
+    }
+}
+```
+
+## [0.7.12] - 2026-05-07
+
+API audit cleanup pass — implements collision-response computation that was
+silently returning zero/null, exports previously-internal type aliases that
+callers couldn't otherwise type, and removes a handful of small API papercuts
+surfaced during the JSDoc-coverage pass that landed across `0.7.x`.
+
+### Fixed — Collision-response computation
+
+Four collision paths were returning a `CollisionResponse` whose `projectionN`
+and `projectionV` were zero vectors (or returning `null` outright), making
+the response unusable for separation/sliding logic.
+
+- **`getCollisionRectangleRectangle`** — now returns the minimum-translation
+  vector (MTV) along the axis with the smaller penetration, signed by the
+  centre-to-centre direction. Existing `overlap` and containment flags are
+  unchanged.
+- **`getCollisionCircleRectangle`** — rewritten to use the standard
+  closest-point-on-rect algorithm. Previously computed distance against an
+  out-of-rect anchor point, producing a wrong result whenever the circle
+  centre was inside the rectangle. Normal points from rect surface toward
+  circle; falls back to the smaller-exit axis when the circle centre is
+  inside the rect.
+- **`Ellipse.collidesWith`** — implements `Ellipse`-vs-`Rectangle` and
+  `Ellipse`-vs-`Circle` via the directional ellipse-boundary equation
+  `1 / sqrt((dx/rx)² + (dy/ry)²)`. Other targets (ellipse-vs-ellipse,
+  ellipse-vs-polygon, ellipse-vs-line) still return `null` —
+  `intersectsWith` remains the boolean fallback.
+- **`Line.collidesWith`** — kept returning `null` (lines have no
+  meaningful SAT response), but the JSDoc now states the contract
+  explicitly so callers don't expect a vector.
+
+`Rectangle.collidesWith` and `Circle.collidesWith` route ellipse targets to
+the new functions via the existing `swap` flag.
+
+### Fixed — Object-URL leak (re-emphasised; was 0.7.11 fix)
+
+The 0.7.11 fix for `MusicFactory` and `VideoFactory` URL revocation is
+unchanged in 0.7.12 — listing it here for completeness because the pre-1.0
+audit findings memory carries a forward reference to it.
+
+### Changed — Visibility / readonly tightening (potentially breaking)
+
+Pre-1.0 cleanups that narrow the public surface where callers could
+previously poke at internal state:
+
+- **`GamepadMapping.buttons` / `.axes`** typed `ReadonlyArray<GamepadControl>`
+  instead of `Array<GamepadControl>`. Internal `destroy()` retains the
+  `length = 0` clear via a local cast. **Breaking** for callers that were
+  pushing or splicing the arrays directly.
+- **`View.updateTransform()` / `.updateBounds()`** changed from `public` to
+  `protected`. They were never safe to call externally — invoking them
+  bypassed the dirty-flag clearing in `getTransform()` / `getBounds()` and
+  could cause redundant recalculation. **Breaking** if you relied on them.
+- **`IndexedDbDatabase.getObjectStore()`** changed from `public` to
+  `protected`. Only callers were the class's own `load`/`save`/`delete`
+  methods. **Breaking** if any subclass referenced it externally.
+- **`GamepadDefinitions.normalizeIds`** is no longer exported. It was an
+  in-file helper that leaked through the barrel. **Breaking** for any
+  caller importing it directly.
+- **`GamepadPromptLayouts.buildControlChannelMap()`** renamed to
+  `getControlChannelMap()` — the name now matches the behaviour (returns a
+  pre-built constant; never builds anything). **Breaking** rename.
+
+### Added — API surface
+
+Additive changes; not breaking:
+
+- `EqualizerFilter` now exposes runtime setters for `lowFrequency`,
+  `midFrequency`, and `highFrequency` (previously only construction-time).
+  Smooth ramp via `setTargetAtTime` to avoid clicks.
+- `Filter` (abstract base for post-process filters) now declares a
+  `destroy()` method with a no-op default. `BlurFilter` / `ColorFilter` /
+  `WebGl2ShaderFilter` / `WebGpuShaderFilter` mark their existing
+  implementations as `override`. Generic-filter consumers no longer need
+  a cast to release filters.
+- `getCollisionEllipseRectangle` and `getCollisionEllipseCircle` are
+  exported from the math barrel for direct use.
+
+### Changed — Internal cleanups
+
+Doc-only and signature-only refactors:
+
+- `Sprite._invalidateSubtreeTransform` / `._invalidateBoundsCascade` tagged
+  `@internal` (they are `public` only because of TS friend-class limits).
+- `_getDebugQuadtree` (InteractionManager) and `_walkBounds` (Quadtree)
+  tagged `@internal` to mark the friend-class link to the debug layer.
+- `PerformanceLayer` declares `viewMode` explicitly to match the other
+  debug layers.
+- `PointerStackLayer._buildLines` lost its two unused `_panelX` / `_panelY`
+  parameters. Internal-only; not user-visible.
+- `intersectionCirclePoly` got an inline comment explaining the
+  negated-frame coordinate transform.
+- `AudioAnalyserOptions` interface picked up per-field JSDoc with documented
+  defaults.
+- `SoundFactoryOptions.poolSize` JSDoc names the implicit `Sound` default (8).
+- `ChorusFilter` lost a redundant `as AudioParam` cast.
+- `Video.setupWithAudioContext` is now an arrow-bound field instead of a
+  context-bound method; cleaner internally, no API change.
+- `ShaderUniform.propName` uses `String.prototype.substring` instead of the
+  deprecated `substr`.
+- `Tween.repeat` JSDoc now ships an `@example` block clarifying that
+  `repeat(2)` runs the animation three times total.
+- `Line.collidesWith` documents the always-`null` behaviour as intentional.
+- `RenderTarget.addDestroyListener` / `.removeDestroyListener` got JSDoc
+  pointing out that `RenderTexture` (which extends `RenderTarget`) inherits
+  them; the audit finding that claimed otherwise was incorrect.
+
 ## [0.7.11] - 2026-05-07
 
 Performance pass — adds a multi-domain benchmark suite, an auto-profiler

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

@@ -1,6 +1,34 @@
 import { TweenState } from './types';
 import type { EasingFunction, TweenLifecycleCallback, TweenUpdateCallback } from './types';
 import type { TweenManager } from './TweenManager';
+/**
+ * Animates numeric properties of `target` from their current value to a
+ * configured end value over a duration in seconds. Supports easing, delay,
+ * repeat (with optional yoyo), chaining, and lifecycle callbacks
+ * ({@link Tween.onStart}, {@link Tween.onUpdate}, {@link Tween.onComplete},
+ * {@link Tween.onRepeat}).
+ *
+ * Tweens are typically created via {@link TweenManager.create}, which attaches
+ * them to the manager so they advance once per frame. Stand-alone usage is
+ * supported by calling {@link Tween.update} manually with a frame delta.
+ *
+ * Start values are captured lazily on the first update after {@link Tween.start},
+ * so target properties may be mutated between configuration and start without
+ * affecting the captured baseline.
+ *
+ * Only number-typed properties on `target` are interpolated; non-number
+ * properties listed in {@link Tween.to} emit a console warning and are skipped.
+ *
+ * @example
+ * ```ts
+ * app.tweens.create(sprite.position)
+ *     .to({ x: 200 }, 1.5)
+ *     .easing(Ease.cubicInOut)
+ *     .yoyo()
+ *     .repeat(-1)
+ *     .start();
+ * ```
+ */
 export declare class Tween<T extends object = object> {
     private readonly _target;
     private _state;
@@ -49,7 +77,18 @@ export declare class Tween<T extends object = object> {
     easing(fn: EasingFunction): this;
     /**
      * Number of additional repeat cycles. -1 = infinite. Default 0 (runs once).
-     * Note: repeat(2) means the animation runs 3 times total.
+     *
+     * The argument counts cycles **after** the first, not the total cycle
+     * count — `repeat(2)` runs the animation three times total (the initial
+     * pass plus two repeats).
+     *
+     * @example
+     * ```ts
+     * tween.repeat(0);   // runs once
+     * tween.repeat(1);   // runs twice
+     * tween.repeat(2);   // runs three times
+     * tween.repeat(-1);  // runs forever
+     * ```
      */
     repeat(count: number): this;
     /**
@@ -57,9 +96,29 @@ export declare class Tween<T extends object = object> {
      * combined with repeat(). Calling yoyo() without repeat() is a no-op.
      */
     yoyo(enabled?: boolean): this;
+    /**
+     * Register a callback fired once when the tween begins interpolating
+     * (after any configured delay has elapsed). Fires only on the first
+     * cycle — repeats do not re-trigger it.
+     */
     onStart(callback: TweenLifecycleCallback): this;
+    /**
+     * Register a callback fired on every active update. Receives the eased
+     * progress in 0..1 — already direction-flipped for yoyo cycles.
+     */
     onUpdate(callback: TweenUpdateCallback): this;
+    /**
+     * Register a callback fired when the tween finishes naturally (all repeat
+     * cycles exhausted). Does NOT fire when the tween is stopped via
+     * {@link Tween.stop}.
+     */
     onComplete(callback: TweenLifecycleCallback): this;
+    /**
+     * Register a callback fired at the boundary of each repeat cycle, after
+     * the cycle counter is decremented and before the next cycle begins. Not
+     * fired on the final cycle's completion (use {@link Tween.onComplete}
+     * for that).
+     */
     onRepeat(callback: TweenLifecycleCallback): this;
     /**
      * Start the tween. If a manager owns this tween it is already tracked;

package/dist/esm/animation/Tween.js

@@ -1,6 +1,34 @@
 import { Ease } from './Easing.js';
 import { TweenState } from './types.js';
 
+/**
+ * Animates numeric properties of `target` from their current value to a
+ * configured end value over a duration in seconds. Supports easing, delay,
+ * repeat (with optional yoyo), chaining, and lifecycle callbacks
+ * ({@link Tween.onStart}, {@link Tween.onUpdate}, {@link Tween.onComplete},
+ * {@link Tween.onRepeat}).
+ *
+ * Tweens are typically created via {@link TweenManager.create}, which attaches
+ * them to the manager so they advance once per frame. Stand-alone usage is
+ * supported by calling {@link Tween.update} manually with a frame delta.
+ *
+ * Start values are captured lazily on the first update after {@link Tween.start},
+ * so target properties may be mutated between configuration and start without
+ * affecting the captured baseline.
+ *
+ * Only number-typed properties on `target` are interpolated; non-number
+ * properties listed in {@link Tween.to} emit a console warning and are skipped.
+ *
+ * @example
+ * ```ts
+ * app.tweens.create(sprite.position)
+ *     .to({ x: 200 }, 1.5)
+ *     .easing(Ease.cubicInOut)
+ *     .yoyo()
+ *     .repeat(-1)
+ *     .start();
+ * ```
+ */
 class Tween {
     _target;
     _state = TweenState.Idle;
@@ -72,7 +100,18 @@ class Tween {
     }
     /**
      * Number of additional repeat cycles. -1 = infinite. Default 0 (runs once).
-     * Note: repeat(2) means the animation runs 3 times total.
+     *
+     * The argument counts cycles **after** the first, not the total cycle
+     * count — `repeat(2)` runs the animation three times total (the initial
+     * pass plus two repeats).
+     *
+     * @example
+     * ```ts
+     * tween.repeat(0);   // runs once
+     * tween.repeat(1);   // runs twice
+     * tween.repeat(2);   // runs three times
+     * tween.repeat(-1);  // runs forever
+     * ```
      */
     repeat(count) {
         this._repeatTotal = count;
@@ -86,18 +125,38 @@ class Tween {
         this._yoyo = enabled;
         return this;
     }
+    /**
+     * Register a callback fired once when the tween begins interpolating
+     * (after any configured delay has elapsed). Fires only on the first
+     * cycle — repeats do not re-trigger it.
+     */
     onStart(callback) {
         this._onStart = callback;
         return this;
     }
+    /**
+     * Register a callback fired on every active update. Receives the eased
+     * progress in 0..1 — already direction-flipped for yoyo cycles.
+     */
     onUpdate(callback) {
         this._onUpdate = callback;
         return this;
     }
+    /**
+     * Register a callback fired when the tween finishes naturally (all repeat
+     * cycles exhausted). Does NOT fire when the tween is stopped via
+     * {@link Tween.stop}.
+     */
     onComplete(callback) {
         this._onComplete = callback;
         return this;
     }
+    /**
+     * Register a callback fired at the boundary of each repeat cycle, after
+     * the cycle counter is decremented and before the next cycle begins. Not
+     * fired on the final cycle's completion (use {@link Tween.onComplete}
+     * for that).
+     */
     onRepeat(callback) {
         this._onRepeat = callback;
         return this;

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,4 +1,14 @@
 import { Tween } from './Tween';
+/**
+ * Owns and advances a collection of {@link Tween} instances, driving them
+ * once per frame from {@link Application.update}. Created tweens are tracked
+ * automatically; manually constructed tweens can be opted in via
+ * {@link TweenManager.add}.
+ *
+ * Update iteration uses a snapshot so callbacks may freely add or remove
+ * tweens during the same frame without corrupting the loop. Completed and
+ * stopped tweens are evicted automatically.
+ */
 export declare class TweenManager {
     private _tweens;
     private _destroyed;