@flighthq/animation 0.1.0 → 0.2.0

package/dist/animationClip.d.ts

@@ -1,5 +1,7 @@
 import type { AnimationChannel, AnimationClip, AnimationTrack } from '@flighthq/types';
+export declare function cloneAnimationClip(clip: Readonly<AnimationClip>): AnimationClip;
 export declare function createAnimationChannel(track: AnimationTrack, targetRef: unknown): AnimationChannel;
 export declare function createAnimationClip(channels: AnimationChannel[], duration?: number): AnimationClip;
 export declare function getAnimationClipDuration(clip: Readonly<AnimationClip>): number;
+export declare function sampleAnimationClip(out: number[] | Float32Array, clip: Readonly<AnimationClip>, time: number, visit: (sampled: Readonly<number[] | Float32Array>, channel: Readonly<AnimationChannel>, index: number) => void): void;
 //# sourceMappingURL=animationClip.d.ts.map

package/dist/animationClip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"animationClip.d.ts","sourceRoot":"","sources":["../src/animationClip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGvF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,GAAG,gBAAgB,CAElG;AAGD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,CAElG;AAGD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,MAAM,CAE9E"}
+{"version":3,"file":"animationClip.d.ts","sourceRoot":"","sources":["../src/animationClip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAMvF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,aAAa,CAM/E;AAGD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,GAAG,gBAAgB,CAElG;AAGD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,CAElG;AAGD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,MAAM,CAE9E;AAOD,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EAAE,GAAG,YAAY,EAC5B,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,GAAG,YAAY,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAC9G,IAAI,CAON"}

package/dist/animationClip.js

@@ -1,3 +1,13 @@
+import { cloneAnimationTrack, sampleAnimationTrack } from './animationTrack';
+// Deep-copies a clip: each channel gets a freshly cloned track (buffers deep-copied) while its opaque
+// `targetRef` is carried by reference (the clip core never interprets it, so it cannot deep-copy it).
+export function cloneAnimationClip(clip) {
+    const channels = [];
+    for (const channel of clip.channels) {
+        channels.push(createAnimationChannel(cloneAnimationTrack(channel.track), channel.targetRef));
+    }
+    return { channels, duration: clip.duration };
+}
 // Pairs a track with an opaque target reference (interpreted only by the domain binding layer).
 export function createAnimationChannel(track, targetRef) {
     return { targetRef, track };
@@ -10,6 +20,19 @@ export function createAnimationClip(channels, duration) {
 export function getAnimationClipDuration(clip) {
     return clip.duration;
 }
+// Samples every channel of `clip` at `time`, reusing the caller-supplied `out` scratch buffer for each
+// channel and handing it to `visit` along with the channel and its index — so a domain layer (scene,
+// skeleton) can bind each sampled value to that channel's target through one shared loop instead of
+// re-implementing the per-channel walk. `out` must be at least as wide as the widest channel's
+// `components`; it is overwritten per channel, so `visit` must consume it before returning. Alloc-free.
+export function sampleAnimationClip(out, clip, time, visit) {
+    const channels = clip.channels;
+    for (let i = 0; i < channels.length; i++) {
+        const channel = channels[i];
+        sampleAnimationTrack(out, channel.track, time);
+        visit(out, channel, i);
+    }
+}
 function computeChannelsDuration(channels) {
     let max = 0;
     for (const channel of channels) {

package/dist/animationClip.js.map

@@ -1 +1 @@
-{"version":3,"file":"animationClip.js","sourceRoot":"","sources":["../src/animationClip.ts"],"names":[],"mappings":"AAEA,gGAAgG;AAChG,MAAM,UAAU,sBAAsB,CAAC,KAAqB,EAAE,SAAkB;IAC9E,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,mBAAmB,CAAC,QAA4B,EAAE,QAAiB;IACjF,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,IAAI,uBAAuB,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC/E,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,wBAAwB,CAAC,IAA6B;IACpE,OAAO,IAAI,CAAC,QAAQ,CAAC;AACvB,CAAC;AAED,SAAS,uBAAuB,CAAC,QAA+C;IAC9E,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QAClC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC;QAC1B,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,GAAG;YAAE,GAAG,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"animationClip.js","sourceRoot":"","sources":["../src/animationClip.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7E,sGAAsG;AACtG,sGAAsG;AACtG,MAAM,UAAU,kBAAkB,CAAC,IAA6B;IAC9D,MAAM,QAAQ,GAAuB,EAAE,CAAC;IACxC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACpC,QAAQ,CAAC,IAAI,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;AAC/C,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,sBAAsB,CAAC,KAAqB,EAAE,SAAkB;IAC9E,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,mBAAmB,CAAC,QAA4B,EAAE,QAAiB;IACjF,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,IAAI,uBAAuB,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC/E,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,wBAAwB,CAAC,IAA6B;IACpE,OAAO,IAAI,CAAC,QAAQ,CAAC;AACvB,CAAC;AAED,uGAAuG;AACvG,qGAAqG;AACrG,oGAAoG;AACpG,+FAA+F;AAC/F,wGAAwG;AACxG,MAAM,UAAU,mBAAmB,CACjC,GAA4B,EAC5B,IAA6B,EAC7B,IAAY,EACZ,KAA+G;IAE/G,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5B,oBAAoB,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC/C,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAAC,QAA+C;IAC9E,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QAClC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC;QAC1B,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,GAAG;YAAE,GAAG,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/animationPlayer.d.ts

@@ -1,10 +1,17 @@
-import type { AnimationClip, AnimationPlayer } from '@flighthq/types';
+import type { AnimationClip, AnimationLoopMode, AnimationPlayer } from '@flighthq/types';
 export declare function advanceAnimationPlayer(player: AnimationPlayer, dt: number): void;
+export declare function cloneAnimationPlayer(player: Readonly<AnimationPlayer>): AnimationPlayer;
 export declare function createAnimationPlayer(clip: AnimationClip, opts?: Readonly<{
     loop?: boolean;
+    loopMode?: AnimationLoopMode;
     playing?: boolean;
+    repeatCount?: number;
     speed?: number;
     time?: number;
 }>): AnimationPlayer;
+export declare function enableAnimationPlayerSignals(player: AnimationPlayer): void;
+export declare function getAnimationPlayerNormalizedTime(player: Readonly<AnimationPlayer>): number;
+export declare function playAnimationPlayer(player: AnimationPlayer): void;
 export declare function seekAnimationPlayer(player: AnimationPlayer, time: number): void;
+export declare function stopAnimationPlayer(player: AnimationPlayer): void;
 //# sourceMappingURL=animationPlayer.d.ts.map

package/dist/animationPlayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"animationPlayer.d.ts","sourceRoot":"","sources":["../src/animationPlayer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAMtE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAmBhF;AAGD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,aAAa,EACnB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACpF,eAAe,CAQjB;AAGD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAG/E"}
+{"version":3,"file":"animationPlayer.d.ts","sourceRoot":"","sources":["../src/animationPlayer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAUzF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAsEhF;AAKD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,eAAe,CAYvF;AAID,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,aAAa,EACnB,IAAI,CAAC,EAAE,QAAQ,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC,GACD,eAAe,CAYjB;AAID,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAG1E;AAID,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,MAAM,CAK1F;AAID,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAEjE;AAGD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAG/E;AAID,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAGjE"}

package/dist/animationPlayer.js

@@ -1,6 +1,11 @@
+import { createSignal, emitSignal } from '@flighthq/signals';
+import { AnimationLoopModePingPong, AnimationLoopModeRepeat } from '@flighthq/types';
 // Advances the playhead by `dt` seconds (scaled by `speed`; negative plays backward). When `loop`,
-// time wraps modulo the clip duration; otherwise it clamps to [0, duration] and clears `playing` when
-// it reaches an end. No-op while paused or when the clip has zero duration. The app calls this each
+// time wraps at the clip duration per `loopMode` — 'Repeat' jumps end→start, 'PingPong' reflects and
+// reverses `speed`; each wrap/bounce spends one unit of `repeatCount` (negative/undefined = infinite)
+// and playback stops when the budget is exhausted. When not looping, time clamps to [0, duration] and
+// clears `playing` at either end. Emits the opt-in onLooped/onFinished signals (null-guarded, so bare
+// players cost nothing). No-op while paused or when the clip has zero duration. The app calls this each
 // frame — nothing advances on its own.
 export function advanceAnimationPlayer(player, dt) {
     if (!player.playing)
@@ -11,34 +16,161 @@ export function advanceAnimationPlayer(player, dt) {
         return;
     }
     let time = player.time + dt * player.speed;
-    if (player.loop) {
-        time %= duration;
-        if (time < 0)
-            time += duration;
+    if (!player.loop) {
+        if (time >= duration) {
+            player.time = duration;
+            player.playing = false;
+            emitAnimationPlayerFinished(player);
+        }
+        else if (time < 0) {
+            player.time = 0;
+            player.playing = false;
+            emitAnimationPlayerFinished(player);
+        }
+        else {
+            player.time = time;
+        }
+        return;
     }
-    else if (time >= duration) {
-        time = duration;
-        player.playing = false;
+    let looped = false;
+    if (player.loopMode === AnimationLoopModePingPong) {
+        // Reflect at each boundary, flipping the travel direction (`speed` sign). A loop handles a `dt`
+        // large enough to cross a boundary more than once.
+        for (;;) {
+            if (time > duration) {
+                if (!consumeAnimationPlayerLoop(player)) {
+                    finishAnimationPlayerAt(player, duration);
+                    return;
+                }
+                time = 2 * duration - time;
+                player.speed = -player.speed;
+                looped = true;
+            }
+            else if (time < 0) {
+                if (!consumeAnimationPlayerLoop(player)) {
+                    finishAnimationPlayerAt(player, 0);
+                    return;
+                }
+                time = -time;
+                player.speed = -player.speed;
+                looped = true;
+            }
+            else {
+                break;
+            }
+        }
     }
-    else if (time < 0) {
-        time = 0;
-        player.playing = false;
+    else {
+        while (time >= duration) {
+            if (!consumeAnimationPlayerLoop(player)) {
+                finishAnimationPlayerAt(player, duration);
+                return;
+            }
+            time -= duration;
+            looped = true;
+        }
+        while (time < 0) {
+            if (!consumeAnimationPlayerLoop(player)) {
+                finishAnimationPlayerAt(player, 0);
+                return;
+            }
+            time += duration;
+            looped = true;
+        }
     }
     player.time = time;
+    if (looped)
+        emitAnimationPlayerLooped(player);
+}
+// Shallow-copies a player into a fresh, independent driver. The `clip` (and thus its buffers) is shared
+// by reference — players are lightweight drivers over a clip; clone the clip separately for independent
+// buffers. The clone starts signal-free (onFinished/onLooped null) so listeners are never shared.
+export function cloneAnimationPlayer(player) {
+    return {
+        clip: player.clip,
+        loop: player.loop,
+        loopMode: player.loopMode,
+        onFinished: null,
+        onLooped: null,
+        playing: player.playing,
+        repeatCount: player.repeatCount,
+        speed: player.speed,
+        time: player.time,
+    };
 }
-// Allocates a player over `clip`. Defaults: looping, playing, speed 1, time 0.
+// Allocates a player over `clip`. Defaults: looping, 'Repeat' loop mode, infinite repeats, playing,
+// speed 1, time 0, and signal-free (onFinished/onLooped null until enableAnimationPlayerSignals).
 export function createAnimationPlayer(clip, opts) {
     return {
         clip,
         loop: opts?.loop ?? true,
+        loopMode: opts?.loopMode ?? AnimationLoopModeRepeat,
+        onFinished: null,
+        onLooped: null,
         playing: opts?.playing ?? true,
+        repeatCount: opts?.repeatCount ?? -1,
         speed: opts?.speed ?? 1,
         time: opts?.time ?? 0,
     };
 }
+// Allocates and attaches the opt-in player signals (onFinished, onLooped) to a player created before
+// they were needed. Idempotent — calling twice does not create duplicate signals.
+export function enableAnimationPlayerSignals(player) {
+    if (player.onFinished == null)
+        player.onFinished = createSignal();
+    if (player.onLooped == null)
+        player.onLooped = createSignal();
+}
+// Returns the playhead as a fraction of the clip duration, clamped to [0, 1] (time / duration).
+// Returns 0 for a zero-duration clip.
+export function getAnimationPlayerNormalizedTime(player) {
+    const duration = player.clip.duration;
+    if (duration <= 0)
+        return 0;
+    const n = player.time / duration;
+    return n < 0 ? 0 : n > 1 ? 1 : n;
+}
+// Resumes advancement by setting `playing` true, leaving the playhead where it is. Symmetric with
+// stopAnimationPlayer; pair with seekAnimationPlayer to choose a start point first.
+export function playAnimationPlayer(player) {
+    player.playing = true;
+}
 // Sets the playhead to `time`, clamped to [0, clip.duration]. Does not change `playing`.
 export function seekAnimationPlayer(player, time) {
     const duration = player.clip.duration;
     player.time = time < 0 ? 0 : time > duration ? duration : time;
 }
+// Halts advancement and rewinds: clears `playing` and resets the playhead to 0. Symmetric with
+// playAnimationPlayer; use seekAnimationPlayer to stop the player in place instead.
+export function stopAnimationPlayer(player) {
+    player.playing = false;
+    player.time = 0;
+}
+// Spends one unit of the player's finite repeat budget, returning whether a wrap/bounce is still
+// permitted. A negative or undefined `repeatCount` means infinite (always permitted); 0 means the
+// budget is exhausted.
+function consumeAnimationPlayerLoop(player) {
+    const rc = player.repeatCount;
+    if (rc === undefined || rc < 0)
+        return true;
+    if (rc === 0)
+        return false;
+    player.repeatCount = rc - 1;
+    return true;
+}
+function emitAnimationPlayerFinished(player) {
+    if (player.onFinished != null)
+        emitSignal(player.onFinished);
+}
+function emitAnimationPlayerLooped(player) {
+    if (player.onLooped != null)
+        emitSignal(player.onLooped);
+}
+// Clamps the playhead to `time`, clears `playing`, and emits onFinished — the shared end-of-playback
+// path when a non-looping run or an exhausted repeat budget reaches a boundary.
+function finishAnimationPlayerAt(player, time) {
+    player.time = time;
+    player.playing = false;
+    emitAnimationPlayerFinished(player);
+}
 //# sourceMappingURL=animationPlayer.js.map

package/dist/animationPlayer.js.map

@@ -1 +1 @@
-{"version":3,"file":"animationPlayer.js","sourceRoot":"","sources":["../src/animationPlayer.ts"],"names":[],"mappings":"AAEA,mGAAmG;AACnG,sGAAsG;AACtG,oGAAoG;AACpG,uCAAuC;AACvC,MAAM,UAAU,sBAAsB,CAAC,MAAuB,EAAE,EAAU;IACxE,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO;IAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;IACtC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IACD,IAAI,IAAI,GAAG,MAAM,CAAC,IAAI,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3C,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,IAAI,IAAI,QAAQ,CAAC;QACjB,IAAI,IAAI,GAAG,CAAC;YAAE,IAAI,IAAI,QAAQ,CAAC;IACjC,CAAC;SAAM,IAAI,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,GAAG,QAAQ,CAAC;QAChB,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;IACzB,CAAC;SAAM,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACpB,IAAI,GAAG,CAAC,CAAC;QACT,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;IACzB,CAAC;IACD,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;AACrB,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,qBAAqB,CACnC,IAAmB,EACnB,IAAqF;IAErF,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI;QACxB,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,IAAI;QAC9B,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC;QACvB,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC;KACtB,CAAC;AACJ,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,mBAAmB,CAAC,MAAuB,EAAE,IAAY;IACvE,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;IACtC,MAAM,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;AACjE,CAAC"}
+{"version":3,"file":"animationPlayer.js","sourceRoot":"","sources":["../src/animationPlayer.ts"],"names":[],"mappings":"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"}

package/dist/animationTrack.d.ts

@@ -1,4 +1,5 @@
-import type { AnimationInterpolation, AnimationTrack } from '@flighthq/types';
+import type { AnimationInterpolation, AnimationTrack, AnimationTrackValidationDiagnostic } from '@flighthq/types';
+export declare function cloneAnimationTrack(track: Readonly<AnimationTrack>): AnimationTrack;
 export declare function createAnimationTrack(opts: {
     times: ArrayLike<number>;
     values: ArrayLike<number>;
@@ -8,4 +9,6 @@ export declare function createAnimationTrack(opts: {
     easing?: AnimationTrack['easing'];
 }): AnimationTrack;
 export declare function sampleAnimationTrack(out: number[] | Float32Array, track: Readonly<AnimationTrack>, t: number): void;
+export declare function trimAnimationTrack(track: Readonly<AnimationTrack>, startTime: number, endTime: number): AnimationTrack;
+export declare function validateAnimationTrack(track: Readonly<AnimationTrack>): AnimationTrackValidationDiagnostic[] | null;
 //# sourceMappingURL=animationTrack.d.ts.map

package/dist/animationTrack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"animationTrack.d.ts","sourceRoot":"","sources":["../src/animationTrack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAM9E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACzB,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,sBAAsB,CAAC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;CACnC,GAAG,cAAc,CASjB;AAOD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CA4CnH"}
+{"version":3,"file":"animationTrack.d.ts","sourceRoot":"","sources":["../src/animationTrack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,kCAAkC,EAAE,MAAM,iBAAiB,CAAC;AAMlH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,cAAc,CASnF;AAKD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACzB,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,sBAAsB,CAAC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;CACnC,GAAG,cAAc,CASjB;AAOD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAmDnH;AAOD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,EAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,cAAc,CAqBhB;AAKD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,kCAAkC,EAAE,GAAG,IAAI,CAsBnH"}

package/dist/animationTrack.js

@@ -1,4 +1,17 @@
 import { AnimationInterpolationLinear } from '@flighthq/types';
+// Deep-copies an AnimationTrack, allocating fresh `times` and `values` buffers (preserving Float32Array
+// vs number[] backing) so the clone shares no mutable state with the source. `easing` is a pure
+// function and is carried by reference; all scalar fields are copied.
+export function cloneAnimationTrack(track) {
+    return {
+        components: track.components,
+        easing: track.easing,
+        interpolation: track.interpolation,
+        quaternion: track.quaternion,
+        times: cloneNumberBuffer(track.times),
+        values: cloneNumberBuffer(track.values),
+    };
+}
 // Allocates an AnimationTrack. `times` must be ascending; `values` is the flat keyframe buffer
 // (`components` numbers per keyframe for step/linear, 3 * `components` for cubic). Defaults:
 // linear interpolation, 1 component, non-quaternion, no easing.
@@ -33,10 +46,18 @@ export function sampleAnimationTrack(out, track, t) {
         copyKeyframeValue(out, track, count - 1);
         return;
     }
-    // Locate the segment [i, i+1] containing t (times are ascending; t is strictly inside the range).
-    let i = 0;
-    while (i < count - 1 && times[i + 1] <= t)
-        i++;
+    // Binary search for the segment [i, i+1] containing t: the largest i with times[i] <= t. Times are
+    // ascending and t is strictly inside (times[0] < t < times[count-1]), so i lands in [0, count-2].
+    let lo = 0;
+    let hi = count - 1;
+    while (lo < hi) {
+        const mid = (lo + hi + 1) >> 1;
+        if (times[mid] <= t)
+            lo = mid;
+        else
+            hi = mid - 1;
+    }
+    const i = lo;
     const t0 = times[i];
     const dt = times[i + 1] - t0;
     let alpha = dt > 0 ? (t - t0) / dt : 0;
@@ -62,6 +83,76 @@ export function sampleAnimationTrack(out, track, t) {
         out[c] = a + (values[oj + c] - a) * alpha;
     }
 }
+// Extracts the keyframes of `track` whose time falls within [startTime, endTime] into a fresh subclip
+// track, rebasing times so the range start maps to 0 (a keyframe at startTime becomes t=0). Buffers are
+// deep-copied; endpoints are not synthesized — the trimmed track's first/last keyframes are simply the
+// in-range keyframes, and sampling clamps outside them as usual. Returns an empty track when no
+// keyframe falls in range.
+export function trimAnimationTrack(track, startTime, endTime) {
+    const { components, times } = track;
+    const count = times.length;
+    const stride = keyframeStride(track);
+    const outTimes = [];
+    const outValues = [];
+    for (let k = 0; k < count; k++) {
+        const time = times[k];
+        if (time < startTime || time > endTime)
+            continue;
+        outTimes.push(time - startTime);
+        const off = k * stride;
+        for (let c = 0; c < stride; c++)
+            outValues.push(track.values[off + c]);
+    }
+    return {
+        components,
+        easing: track.easing,
+        interpolation: track.interpolation,
+        quaternion: track.quaternion,
+        times: outTimes,
+        values: outValues,
+    };
+}
+// Structurally validates a track, returning null when it is well-formed or an array of diagnostics
+// otherwise. Checks that `times` is strictly ascending and that `values.length` equals
+// keyCount * componentsPerKeyframe (components for step/linear, 3 * components for cubic). Never throws.
+export function validateAnimationTrack(track) {
+    const diagnostics = [];
+    const { times, values } = track;
+    const count = times.length;
+    for (let k = 1; k < count; k++) {
+        if (times[k] <= times[k - 1]) {
+            diagnostics.push({
+                code: 'nonAscendingTimes',
+                index: k,
+                message: `times[${k}] (${times[k]}) is not greater than times[${k - 1}] (${times[k - 1]}); times must be strictly ascending.`,
+            });
+        }
+    }
+    const expected = count * keyframeStride(track);
+    if (values.length !== expected) {
+        diagnostics.push({
+            code: 'valuesLengthMismatch',
+            index: null,
+            message: `values.length (${values.length}) must equal keyCount * componentsPerKeyframe (${expected}).`,
+        });
+    }
+    return diagnostics.length > 0 ? diagnostics : null;
+}
+// Allocates a fresh number buffer with the same contents as `src`, preserving a Float32Array backing
+// when the source is one (so clones of typed-array tracks stay typed).
+function cloneNumberBuffer(src) {
+    if (src instanceof Float32Array)
+        return src.slice();
+    const out = new Array(src.length);
+    for (let i = 0; i < src.length; i++)
+        out[i] = src[i];
+    return out;
+}
+function copyKeyframeValue(out, track, k) {
+    const off = keyframeValueOffset(track, k);
+    for (let c = 0; c < track.components; c++)
+        out[c] = track.values[off + c];
+}
 // Byte width of one keyframe block in the flat value buffer (cubic stores in/out tangents alongside
 // the value, so 3x).
 function keyframeStride(track) {
@@ -73,10 +164,16 @@ function keyframeValueOffset(track, k) {
     const stride = keyframeStride(track);
     return track.interpolation === 'Cubic' ? k * stride + track.components : k * stride;
 }
-function copyKeyframeValue(out, track, k) {
-    const off = keyframeValueOffset(track, k);
-    for (let c = 0; c < track.components; c++)
-        out[c] = track.values[off + c];
+function normalizeFlatQuaternion(out) {
+    const x = out[0], y = out[1], z = out[2], w = out[3];
+    const len = Math.hypot(x, y, z, w);
+    if (len > 0) {
+        const inv = 1 / len;
+        out[0] = x * inv;
+        out[1] = y * inv;
+        out[2] = z * inv;
+        out[3] = w * inv;
+    }
 }
 // glTF cubic-spline (Hermite) interpolation of segment [i, i+1] at `alpha`, with `dt` the segment
 // duration (tangents are derivatives, scaled by dt). Quaternion tracks are interpolated component-wise
@@ -132,15 +229,4 @@ function slerpFlatQuaternion(out, values, oa, ob, alpha) {
     out[2] = scale0 * az + scale1 * bz;
     out[3] = scale0 * aw + scale1 * bw;
 }
-function normalizeFlatQuaternion(out) {
-    const x = out[0], y = out[1], z = out[2], w = out[3];
-    const len = Math.hypot(x, y, z, w);
-    if (len > 0) {
-        const inv = 1 / len;
-        out[0] = x * inv;
-        out[1] = y * inv;
-        out[2] = z * inv;
-        out[3] = w * inv;
-    }
-}
 //# sourceMappingURL=animationTrack.js.map

package/dist/animationTrack.js.map

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

package/package.json

@@ -1,6 +1,11 @@
 {
   "name": "@flighthq/animation",
-  "version": "0.1.0",
+  "version": "0.2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/animation"
+  },
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -27,7 +32,8 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/types": "0.1.0"
+    "@flighthq/signals": "0.2.0",
+    "@flighthq/types": "0.2.0"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/animationClip.test.ts

@@ -1,10 +1,30 @@
-import { createAnimationChannel, createAnimationClip, getAnimationClipDuration } from './animationClip';
+import {
+  cloneAnimationClip,
+  createAnimationChannel,
+  createAnimationClip,
+  getAnimationClipDuration,
+  sampleAnimationClip,
+} from './animationClip';
 import { createAnimationTrack } from './animationTrack';
 
 function track(times: number[]) {
   return createAnimationTrack({ times, values: times.map(() => 0) });
 }
 
+describe('cloneAnimationClip', () => {
+  it('deep-copies each channel track but shares targetRefs by reference', () => {
+    const target = {};
+    const clip = createAnimationClip([createAnimationChannel(track([0, 1]), target)]);
+    const clone = cloneAnimationClip(clip);
+    expect(clone).not.toBe(clip);
+    expect(clone.channels).not.toBe(clip.channels);
+    expect(clone.channels[0].track).not.toBe(clip.channels[0].track);
+    expect(clone.channels[0].track.times).not.toBe(clip.channels[0].track.times);
+    expect(clone.channels[0].targetRef).toBe(target);
+    expect(clone.duration).toBe(clip.duration);
+  });
+});
+
 describe('createAnimationChannel', () => {
   it('pairs a track with an opaque target ref', () => {
     const t = track([0, 1]);
@@ -36,3 +56,31 @@ describe('getAnimationClipDuration', () => {
     expect(getAnimationClipDuration(clip)).toBe(4);
   });
 });
+
+describe('sampleAnimationClip', () => {
+  it('samples every channel at the given time and visits each with its channel and index', () => {
+    const a = createAnimationTrack({ times: [0, 1], values: [0, 10] });
+    const b = createAnimationTrack({ times: [0, 1], values: [100, 200] });
+    const targetA = { id: 'a' };
+    const targetB = { id: 'b' };
+    const clip = createAnimationClip([createAnimationChannel(a, targetA), createAnimationChannel(b, targetB)]);
+    const out = [0];
+    const seen: Array<{ index: number; target: unknown; value: number }> = [];
+    sampleAnimationClip(out, clip, 0.5, (sampled, channel, index) => {
+      seen.push({ index, target: channel.targetRef, value: sampled[0] });
+    });
+    expect(seen).toEqual([
+      { index: 0, target: targetA, value: 5 },
+      { index: 1, target: targetB, value: 150 },
+    ]);
+  });
+
+  it('does not invoke the visitor for a channel-less clip', () => {
+    const clip = createAnimationClip([], 1);
+    let calls = 0;
+    sampleAnimationClip([0], clip, 0, () => {
+      calls++;
+    });
+    expect(calls).toBe(0);
+  });
+});

package/src/animationPlayer.test.ts

@@ -1,5 +1,16 @@
+import { connectSignal } from '@flighthq/signals';
+
 import { createAnimationClip } from './animationClip';
-import { advanceAnimationPlayer, createAnimationPlayer, seekAnimationPlayer } from './animationPlayer';
+import {
+  advanceAnimationPlayer,
+  cloneAnimationPlayer,
+  createAnimationPlayer,
+  enableAnimationPlayerSignals,
+  getAnimationPlayerNormalizedTime,
+  playAnimationPlayer,
+  seekAnimationPlayer,
+  stopAnimationPlayer,
+} from './animationPlayer';
 
 function player(duration: number, opts?: Parameters<typeof createAnimationPlayer>[1]) {
   return createAnimationPlayer(createAnimationClip([], duration), opts);
@@ -58,6 +69,73 @@ describe('advanceAnimationPlayer', () => {
     expect(p.time).toBeCloseTo(8.5);
     expect(p.playing).toBe(true);
   });
+
+  it('reflects and reverses speed at the end in ping-pong mode', () => {
+    const p = player(10, { loopMode: 'PingPong', speed: 1, time: 9 });
+    advanceAnimationPlayer(p, 2); // raw = 11 -> reflect to 20 - 11 = 9, speed flips to -1
+    expect(p.time).toBeCloseTo(9);
+    expect(p.speed).toBe(-1);
+    expect(p.playing).toBe(true);
+  });
+
+  it('reflects and reverses speed at the start in ping-pong mode', () => {
+    const p = player(10, { loopMode: 'PingPong', speed: -1, time: 1 });
+    advanceAnimationPlayer(p, 2); // raw = -1 -> reflect to 1, speed flips to +1
+    expect(p.time).toBeCloseTo(1);
+    expect(p.speed).toBe(1);
+    expect(p.playing).toBe(true);
+  });
+
+  it('stops at the end when a finite repeat budget is exhausted', () => {
+    const p = player(10, { loop: true, repeatCount: 0, time: 9 });
+    advanceAnimationPlayer(p, 2); // no wrap permitted -> clamp to duration and stop
+    expect(p.time).toBe(10);
+    expect(p.playing).toBe(false);
+  });
+
+  it('spends one repeat per wrap and stops once the budget runs out', () => {
+    const p = player(10, { loop: true, repeatCount: 1, time: 9 });
+    advanceAnimationPlayer(p, 2); // first wrap allowed
+    expect(p.time).toBeCloseTo(1);
+    expect(p.playing).toBe(true);
+    advanceAnimationPlayer(p, 10); // budget now exhausted -> stop
+    expect(p.playing).toBe(false);
+  });
+
+  it('emits onLooped when looping wraps (signals enabled)', () => {
+    const p = player(10, { loop: true, time: 9 });
+    enableAnimationPlayerSignals(p);
+    let looped = 0;
+    connectSignal(p.onLooped!, () => looped++);
+    advanceAnimationPlayer(p, 3);
+    expect(looped).toBe(1);
+  });
+
+  it('emits onFinished when a non-looping run reaches the end (signals enabled)', () => {
+    const p = player(10, { loop: false, time: 9 });
+    enableAnimationPlayerSignals(p);
+    let finished = 0;
+    connectSignal(p.onFinished!, () => finished++);
+    advanceAnimationPlayer(p, 5);
+    expect(finished).toBe(1);
+  });
+});
+
+describe('cloneAnimationPlayer', () => {
+  it('copies fields, shares the clip, and starts signal-free', () => {
+    const p = player(10, { loop: false, loopMode: 'PingPong', repeatCount: 3, speed: 2, time: 4 });
+    enableAnimationPlayerSignals(p);
+    const clone = cloneAnimationPlayer(p);
+    expect(clone).not.toBe(p);
+    expect(clone.clip).toBe(p.clip);
+    expect(clone.loop).toBe(false);
+    expect(clone.loopMode).toBe('PingPong');
+    expect(clone.repeatCount).toBe(3);
+    expect(clone.speed).toBe(2);
+    expect(clone.time).toBe(4);
+    expect(clone.onFinished).toBeNull();
+    expect(clone.onLooped).toBeNull();
+  });
 });
 
 describe('createAnimationPlayer', () => {
@@ -68,6 +146,56 @@ describe('createAnimationPlayer', () => {
     expect(p.speed).toBe(1);
     expect(p.time).toBe(0);
   });
+
+  it('defaults to Repeat loop mode, infinite repeats, and no signals', () => {
+    const p = player(5);
+    expect(p.loopMode).toBe('Repeat');
+    expect(p.repeatCount).toBe(-1);
+    expect(p.onFinished).toBeNull();
+    expect(p.onLooped).toBeNull();
+  });
+});
+
+describe('enableAnimationPlayerSignals', () => {
+  it('allocates the opt-in signals', () => {
+    const p = player(5);
+    enableAnimationPlayerSignals(p);
+    expect(p.onFinished).not.toBeNull();
+    expect(p.onLooped).not.toBeNull();
+  });
+
+  it('is idempotent (keeps the existing signal instances)', () => {
+    const p = player(5);
+    enableAnimationPlayerSignals(p);
+    const finished = p.onFinished;
+    const looped = p.onLooped;
+    enableAnimationPlayerSignals(p);
+    expect(p.onFinished).toBe(finished);
+    expect(p.onLooped).toBe(looped);
+  });
+});
+
+describe('getAnimationPlayerNormalizedTime', () => {
+  it('returns time / duration in [0, 1]', () => {
+    const p = player(10, { time: 2.5 });
+    expect(getAnimationPlayerNormalizedTime(p)).toBeCloseTo(0.25);
+    seekAnimationPlayer(p, 10);
+    expect(getAnimationPlayerNormalizedTime(p)).toBe(1);
+  });
+
+  it('returns 0 for a zero-duration clip', () => {
+    const p = player(0);
+    expect(getAnimationPlayerNormalizedTime(p)).toBe(0);
+  });
+});
+
+describe('playAnimationPlayer', () => {
+  it('sets playing true without moving the playhead', () => {
+    const p = player(10, { playing: false, time: 3 });
+    playAnimationPlayer(p);
+    expect(p.playing).toBe(true);
+    expect(p.time).toBe(3);
+  });
 });
 
 describe('seekAnimationPlayer', () => {
@@ -81,3 +209,12 @@ describe('seekAnimationPlayer', () => {
     expect(p.time).toBe(10);
   });
 });
+
+describe('stopAnimationPlayer', () => {
+  it('clears playing and rewinds to 0', () => {
+    const p = player(10, { time: 5 });
+    stopAnimationPlayer(p);
+    expect(p.playing).toBe(false);
+    expect(p.time).toBe(0);
+  });
+});

package/src/animationTrack.test.ts

@@ -1,6 +1,48 @@
 import { AnimationInterpolationCubic, AnimationInterpolationLinear, AnimationInterpolationStep } from '@flighthq/types';
 
-import { createAnimationTrack, sampleAnimationTrack } from './animationTrack';
+import {
+  cloneAnimationTrack,
+  createAnimationTrack,
+  sampleAnimationTrack,
+  trimAnimationTrack,
+  validateAnimationTrack,
+} from './animationTrack';
+
+describe('cloneAnimationTrack', () => {
+  it('deep-copies times and values so the clone shares no buffers', () => {
+    const track = createAnimationTrack({ components: 2, times: [0, 1], values: [0, 0, 2, 4] });
+    const clone = cloneAnimationTrack(track);
+    expect(clone.times).not.toBe(track.times);
+    expect(clone.values).not.toBe(track.values);
+    expect(Array.from(clone.times)).toEqual([0, 1]);
+    expect(Array.from(clone.values)).toEqual([0, 0, 2, 4]);
+    (clone.values as number[])[0] = 99;
+    expect((track.values as number[])[0]).toBe(0);
+  });
+
+  it('preserves a Float32Array backing', () => {
+    const track = createAnimationTrack({ times: new Float32Array([0, 1]), values: new Float32Array([0, 10]) });
+    const clone = cloneAnimationTrack(track);
+    expect(clone.times).toBeInstanceOf(Float32Array);
+    expect(clone.values).toBeInstanceOf(Float32Array);
+  });
+
+  it('carries scalar fields and the easing reference', () => {
+    const easing = (a: number) => a;
+    const track = createAnimationTrack({
+      components: 3,
+      easing,
+      interpolation: AnimationInterpolationStep,
+      quaternion: false,
+      times: [0],
+      values: [0, 0, 0],
+    });
+    const clone = cloneAnimationTrack(track);
+    expect(clone.components).toBe(3);
+    expect(clone.interpolation).toBe(AnimationInterpolationStep);
+    expect(clone.easing).toBe(easing);
+  });
+});
 
 describe('createAnimationTrack', () => {
   it('fills defaults (linear, 1 component, non-quaternion, no easing)', () => {
@@ -20,6 +62,17 @@ describe('sampleAnimationTrack', () => {
     expect(out[0]).toBeCloseTo(5);
   });
 
+  it('locates the correct segment on a multi-key track (binary search parity)', () => {
+    // A monotonically increasing ramp: value == time * 10 everywhere, so any sample must land on the
+    // right segment for the linear result to match. Exercises the binary search across many segments.
+    const track = createAnimationTrack({ times: [0, 1, 2, 3, 4, 5], values: [0, 10, 20, 30, 40, 50] });
+    const out = [0];
+    for (const t of [0.25, 0.99, 1, 1.5, 2.5, 3.75, 4.999]) {
+      sampleAnimationTrack(out, track, t);
+      expect(out[0]).toBeCloseTo(t * 10, 6);
+    }
+  });
+
   it('clamps before the first and after the last keyframe', () => {
     const track = createAnimationTrack({ times: [1, 2], values: [3, 9] });
     const out = [0];
@@ -112,3 +165,81 @@ describe('sampleAnimationTrack', () => {
     expect(out[0]).toBe(99);
   });
 });
+
+describe('trimAnimationTrack', () => {
+  it('keeps in-range keyframes and rebases times to start at 0', () => {
+    const track = createAnimationTrack({ times: [0, 1, 2, 3, 4], values: [0, 10, 20, 30, 40] });
+    const sub = trimAnimationTrack(track, 1, 3);
+    expect(Array.from(sub.times)).toEqual([0, 1, 2]);
+    expect(Array.from(sub.values)).toEqual([10, 20, 30]);
+  });
+
+  it('deep-copies value blocks for multi-component tracks', () => {
+    const track = createAnimationTrack({ components: 2, times: [0, 1, 2], values: [0, 0, 2, 4, 8, 16] });
+    const sub = trimAnimationTrack(track, 1, 2);
+    expect(Array.from(sub.times)).toEqual([0, 1]);
+    expect(Array.from(sub.values)).toEqual([2, 4, 8, 16]);
+    expect(sub.values).not.toBe(track.values);
+  });
+
+  it('copies the 3x cubic keyframe stride', () => {
+    const track = createAnimationTrack({
+      interpolation: AnimationInterpolationCubic,
+      times: [0, 1, 2],
+      values: [0, 0, 0, 1, 10, 1, 2, 20, 2],
+    });
+    const sub = trimAnimationTrack(track, 1, 2);
+    expect(Array.from(sub.times)).toEqual([0, 1]);
+    expect(Array.from(sub.values)).toEqual([1, 10, 1, 2, 20, 2]);
+  });
+
+  it('returns an empty track when no keyframe falls in range', () => {
+    const track = createAnimationTrack({ times: [0, 1, 2], values: [0, 10, 20] });
+    const sub = trimAnimationTrack(track, 5, 6);
+    expect(sub.times.length).toBe(0);
+    expect(sub.values.length).toBe(0);
+  });
+});
+
+describe('validateAnimationTrack', () => {
+  it('returns null for a well-formed track', () => {
+    const track = createAnimationTrack({ components: 3, times: [0, 1, 2], values: [0, 0, 0, 1, 1, 1, 2, 2, 2] });
+    expect(validateAnimationTrack(track)).toBeNull();
+  });
+
+  it('flags non-ascending times with the offending index', () => {
+    const track = createAnimationTrack({ times: [0, 2, 1], values: [0, 1, 2] });
+    const diagnostics = validateAnimationTrack(track);
+    expect(diagnostics).not.toBeNull();
+    expect(diagnostics![0].code).toBe('nonAscendingTimes');
+    expect(diagnostics![0].index).toBe(2);
+  });
+
+  it('flags a values-length mismatch', () => {
+    const track = createAnimationTrack({ components: 2, times: [0, 1], values: [0, 0, 2] });
+    const diagnostics = validateAnimationTrack(track);
+    expect(diagnostics).not.toBeNull();
+    expect(diagnostics!.some((d) => d.code === 'valuesLengthMismatch')).toBe(true);
+  });
+
+  it('accounts for the 3x cubic stride in the length check', () => {
+    const ok = createAnimationTrack({
+      interpolation: AnimationInterpolationCubic,
+      times: [0, 1],
+      values: [0, 0, 0, 0, 10, 0],
+    });
+    expect(validateAnimationTrack(ok)).toBeNull();
+    const bad = createAnimationTrack({
+      interpolation: AnimationInterpolationCubic,
+      times: [0, 1],
+      values: [0, 0, 0, 0],
+    });
+    expect(validateAnimationTrack(bad)).not.toBeNull();
+  });
+
+  it('does not throw on a duplicate time (reports it instead)', () => {
+    const track = createAnimationTrack({ times: [0, 0], values: [0, 1] });
+    const diagnostics = validateAnimationTrack(track);
+    expect(diagnostics![0].code).toBe('nonAscendingTimes');
+  });
+});