@flighthq/animation 0.1.0

package/dist/animationClip.d.ts

@@ -0,0 +1,5 @@
+import type { AnimationChannel, AnimationClip, AnimationTrack } from '@flighthq/types';
+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;
+//# sourceMappingURL=animationClip.d.ts.map

package/dist/animationClip.d.ts.map

@@ -0,0 +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"}

package/dist/animationClip.js

@@ -0,0 +1,23 @@
+// Pairs a track with an opaque target reference (interpreted only by the domain binding layer).
+export function createAnimationChannel(track, targetRef) {
+    return { targetRef, track };
+}
+// Bundles channels into a clip. `duration` defaults to the latest keyframe time across all channels.
+export function createAnimationClip(channels, duration) {
+    return { channels, duration: duration ?? computeChannelsDuration(channels) };
+}
+// Returns the clip's total duration in seconds.
+export function getAnimationClipDuration(clip) {
+    return clip.duration;
+}
+function computeChannelsDuration(channels) {
+    let max = 0;
+    for (const channel of channels) {
+        const times = channel.track.times;
+        const last = times.length;
+        if (last > 0 && times[last - 1] > max)
+            max = times[last - 1];
+    }
+    return max;
+}
+//# sourceMappingURL=animationClip.js.map

package/dist/animationClip.js.map

@@ -0,0 +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"}

package/dist/animationPlayer.d.ts

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

package/dist/animationPlayer.d.ts.map

@@ -0,0 +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"}

package/dist/animationPlayer.js

@@ -0,0 +1,44 @@
+// 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
+// frame — nothing advances on its own.
+export function advanceAnimationPlayer(player, dt) {
+    if (!player.playing)
+        return;
+    const duration = player.clip.duration;
+    if (duration <= 0) {
+        player.time = 0;
+        return;
+    }
+    let time = player.time + dt * player.speed;
+    if (player.loop) {
+        time %= duration;
+        if (time < 0)
+            time += duration;
+    }
+    else if (time >= duration) {
+        time = duration;
+        player.playing = false;
+    }
+    else if (time < 0) {
+        time = 0;
+        player.playing = false;
+    }
+    player.time = time;
+}
+// Allocates a player over `clip`. Defaults: looping, playing, speed 1, time 0.
+export function createAnimationPlayer(clip, opts) {
+    return {
+        clip,
+        loop: opts?.loop ?? true,
+        playing: opts?.playing ?? true,
+        speed: opts?.speed ?? 1,
+        time: opts?.time ?? 0,
+    };
+}
+// 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;
+}
+//# sourceMappingURL=animationPlayer.js.map

package/dist/animationPlayer.js.map

@@ -0,0 +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"}

package/dist/animationTrack.d.ts

@@ -0,0 +1,11 @@
+import type { AnimationInterpolation, AnimationTrack } from '@flighthq/types';
+export declare function createAnimationTrack(opts: {
+    times: ArrayLike<number>;
+    values: ArrayLike<number>;
+    components?: number;
+    interpolation?: AnimationInterpolation;
+    quaternion?: boolean;
+    easing?: AnimationTrack['easing'];
+}): AnimationTrack;
+export declare function sampleAnimationTrack(out: number[] | Float32Array, track: Readonly<AnimationTrack>, t: number): void;
+//# sourceMappingURL=animationTrack.d.ts.map

package/dist/animationTrack.d.ts.map

@@ -0,0 +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"}

package/dist/animationTrack.js

@@ -0,0 +1,146 @@
+import { AnimationInterpolationLinear } from '@flighthq/types';
+// 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.
+export function createAnimationTrack(opts) {
+    return {
+        components: opts.components ?? 1,
+        easing: opts.easing ?? null,
+        interpolation: opts.interpolation ?? AnimationInterpolationLinear,
+        quaternion: opts.quaternion ?? false,
+        times: opts.times,
+        values: opts.values,
+    };
+}
+// Samples `track` at time `t`, writing `track.components` numbers into `out`. `t` is clamped to the
+// track's time range (before the first keyframe yields the first value; after the last yields the
+// last). Step holds the previous keyframe; Linear interpolates component-wise (or slerps a quaternion
+// track); Cubic is a glTF-style Hermite spline over the per-keyframe in/out tangents. A non-null
+// `track.easing` reshapes the per-segment alpha first. Alloc-free; safe for hot loops.
+export function sampleAnimationTrack(out, track, t) {
+    const { components, times, values } = track;
+    const count = times.length;
+    if (count === 0) {
+        for (let c = 0; c < components; c++)
+            out[c] = 0;
+        return;
+    }
+    if (count === 1 || t <= times[0]) {
+        copyKeyframeValue(out, track, 0);
+        return;
+    }
+    if (t >= times[count - 1]) {
+        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++;
+    const t0 = times[i];
+    const dt = times[i + 1] - t0;
+    let alpha = dt > 0 ? (t - t0) / dt : 0;
+    if (track.easing !== null)
+        alpha = track.easing(alpha);
+    if (track.interpolation === 'Step') {
+        copyKeyframeValue(out, track, i);
+        return;
+    }
+    if (track.interpolation === 'Cubic') {
+        sampleCubicSegment(out, track, i, alpha, dt);
+        return;
+    }
+    // Linear.
+    const oi = keyframeValueOffset(track, i);
+    const oj = keyframeValueOffset(track, i + 1);
+    if (track.quaternion && components === 4) {
+        slerpFlatQuaternion(out, values, oi, oj, alpha);
+        return;
+    }
+    for (let c = 0; c < components; c++) {
+        const a = values[oi + c];
+        out[c] = a + (values[oj + c] - a) * alpha;
+    }
+}
+// Byte width of one keyframe block in the flat value buffer (cubic stores in/out tangents alongside
+// the value, so 3x).
+function keyframeStride(track) {
+    return track.interpolation === 'Cubic' ? track.components * 3 : track.components;
+}
+// Offset of keyframe `k`'s VALUE within the flat buffer (the middle slot for cubic, where the layout
+// is [inTangent, value, outTangent]).
+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];
+}
+// 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
+// then renormalized.
+function sampleCubicSegment(out, track, i, alpha, dt) {
+    const { components, values } = track;
+    const stride = components * 3;
+    const a2 = alpha * alpha;
+    const a3 = a2 * alpha;
+    const h00 = 2 * a3 - 3 * a2 + 1;
+    const h10 = a3 - 2 * a2 + alpha;
+    const h01 = -2 * a3 + 3 * a2;
+    const h11 = a3 - a2;
+    const base0 = i * stride;
+    const base1 = (i + 1) * stride;
+    for (let c = 0; c < components; c++) {
+        const p0 = values[base0 + components + c]; // value at i
+        const m0 = values[base0 + components * 2 + c]; // out-tangent at i
+        const p1 = values[base1 + components + c]; // value at i+1
+        const m1 = values[base1 + c]; // in-tangent at i+1
+        out[c] = h00 * p0 + h10 * dt * m0 + h01 * p1 + h11 * dt * m1;
+    }
+    if (track.quaternion && components === 4)
+        normalizeFlatQuaternion(out);
+}
+// Spherical-linear interpolation of two unit quaternions stored flat at `oa`/`ob` in `values`, written
+// to `out[0..3]`. Picks the shorter arc; falls back to normalized-lerp for nearly-parallel quaternions.
+function slerpFlatQuaternion(out, values, oa, ob, alpha) {
+    const ax = values[oa], ay = values[oa + 1], az = values[oa + 2], aw = values[oa + 3];
+    let bx = values[ob], by = values[ob + 1], bz = values[ob + 2], bw = values[ob + 3];
+    let cosom = ax * bx + ay * by + az * bz + aw * bw;
+    if (cosom < 0) {
+        cosom = -cosom;
+        bx = -bx;
+        by = -by;
+        bz = -bz;
+        bw = -bw;
+    }
+    let scale0;
+    let scale1;
+    if (1 - cosom > 1e-6) {
+        const omega = Math.acos(cosom);
+        const sinom = Math.sin(omega);
+        scale0 = Math.sin((1 - alpha) * omega) / sinom;
+        scale1 = Math.sin(alpha * omega) / sinom;
+    }
+    else {
+        scale0 = 1 - alpha;
+        scale1 = alpha;
+    }
+    out[0] = scale0 * ax + scale1 * bx;
+    out[1] = scale0 * ay + scale1 * by;
+    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

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './animationClip';
+export * from './animationPlayer';
+export * from './animationTrack';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from './animationClip';
+export * from './animationPlayer';
+export * from './animationTrack';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@flighthq/animation",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Target-free animation core: keyframe sampler (step/linear/cubic, quaternion slerp), clips, and an explicit playhead",
+  "sideEffects": false
+}

package/src/animationClip.test.ts

@@ -0,0 +1,38 @@
+import { createAnimationChannel, createAnimationClip, getAnimationClipDuration } from './animationClip';
+import { createAnimationTrack } from './animationTrack';
+
+function track(times: number[]) {
+  return createAnimationTrack({ times, values: times.map(() => 0) });
+}
+
+describe('createAnimationChannel', () => {
+  it('pairs a track with an opaque target ref', () => {
+    const t = track([0, 1]);
+    const target = {};
+    const channel = createAnimationChannel(t, target);
+    expect(channel.track).toBe(t);
+    expect(channel.targetRef).toBe(target);
+  });
+});
+
+describe('createAnimationClip', () => {
+  it('derives duration from the latest keyframe across channels', () => {
+    const clip = createAnimationClip([
+      createAnimationChannel(track([0, 1]), null),
+      createAnimationChannel(track([0, 2.5]), null),
+    ]);
+    expect(clip.duration).toBe(2.5);
+  });
+
+  it('honors an explicit duration override', () => {
+    const clip = createAnimationClip([createAnimationChannel(track([0, 1]), null)], 10);
+    expect(clip.duration).toBe(10);
+  });
+});
+
+describe('getAnimationClipDuration', () => {
+  it('returns the clip duration', () => {
+    const clip = createAnimationClip([], 4);
+    expect(getAnimationClipDuration(clip)).toBe(4);
+  });
+});

package/src/animationPlayer.test.ts

@@ -0,0 +1,83 @@
+import { createAnimationClip } from './animationClip';
+import { advanceAnimationPlayer, createAnimationPlayer, seekAnimationPlayer } from './animationPlayer';
+
+function player(duration: number, opts?: Parameters<typeof createAnimationPlayer>[1]) {
+  return createAnimationPlayer(createAnimationClip([], duration), opts);
+}
+
+describe('advanceAnimationPlayer', () => {
+  it('advances the playhead by dt * speed', () => {
+    const p = player(10, { loop: false, speed: 2 });
+    advanceAnimationPlayer(p, 1);
+    expect(p.time).toBe(2);
+  });
+
+  it('wraps modulo duration when looping', () => {
+    const p = player(10, { loop: true, time: 9 });
+    advanceAnimationPlayer(p, 3);
+    expect(p.time).toBeCloseTo(2);
+    expect(p.playing).toBe(true);
+  });
+
+  it('clamps and stops at the end when not looping', () => {
+    const p = player(10, { loop: false, time: 9 });
+    advanceAnimationPlayer(p, 5);
+    expect(p.time).toBe(10);
+    expect(p.playing).toBe(false);
+  });
+
+  it('is a no-op for a zero-duration clip', () => {
+    const p = player(0, { time: 0 });
+    advanceAnimationPlayer(p, 1);
+    expect(p.time).toBe(0);
+  });
+
+  it('is a no-op while paused', () => {
+    const p = player(10, { playing: false, time: 3 });
+    advanceAnimationPlayer(p, 5);
+    expect(p.time).toBe(3);
+  });
+
+  it('plays backward with negative speed', () => {
+    const p = player(10, { speed: -1, time: 5 });
+    advanceAnimationPlayer(p, 1);
+    expect(p.time).toBeCloseTo(4);
+  });
+
+  it('stops at time 0 when playing backward without looping', () => {
+    const p = player(10, { speed: -1, loop: false, time: 0.5 });
+    advanceAnimationPlayer(p, 2);
+    expect(p.time).toBe(0);
+    expect(p.playing).toBe(false);
+  });
+
+  it('wraps backward when looping with negative speed', () => {
+    // time=0.5, speed=-1, dt=2 -> raw=-1.5; -1.5 % 10 = -1.5; +10 = 8.5
+    const p = player(10, { speed: -1, loop: true, time: 0.5 });
+    advanceAnimationPlayer(p, 2);
+    expect(p.time).toBeCloseTo(8.5);
+    expect(p.playing).toBe(true);
+  });
+});
+
+describe('createAnimationPlayer', () => {
+  it('defaults to looping, playing, speed 1, time 0', () => {
+    const p = player(5);
+    expect(p.loop).toBe(true);
+    expect(p.playing).toBe(true);
+    expect(p.speed).toBe(1);
+    expect(p.time).toBe(0);
+  });
+});
+
+describe('seekAnimationPlayer', () => {
+  it('clamps the playhead to [0, duration]', () => {
+    const p = player(10);
+    seekAnimationPlayer(p, 4);
+    expect(p.time).toBe(4);
+    seekAnimationPlayer(p, -1);
+    expect(p.time).toBe(0);
+    seekAnimationPlayer(p, 99);
+    expect(p.time).toBe(10);
+  });
+});

package/src/animationTrack.test.ts

@@ -0,0 +1,114 @@
+import { AnimationInterpolationCubic, AnimationInterpolationLinear, AnimationInterpolationStep } from '@flighthq/types';
+
+import { createAnimationTrack, sampleAnimationTrack } from './animationTrack';
+
+describe('createAnimationTrack', () => {
+  it('fills defaults (linear, 1 component, non-quaternion, no easing)', () => {
+    const track = createAnimationTrack({ times: [0, 1], values: [0, 1] });
+    expect(track.interpolation).toBe(AnimationInterpolationLinear);
+    expect(track.components).toBe(1);
+    expect(track.quaternion).toBe(false);
+    expect(track.easing).toBeNull();
+  });
+});
+
+describe('sampleAnimationTrack', () => {
+  it('linearly interpolates a scalar mid-segment', () => {
+    const track = createAnimationTrack({ times: [0, 1], values: [0, 10] });
+    const out = [0];
+    sampleAnimationTrack(out, track, 0.5);
+    expect(out[0]).toBeCloseTo(5);
+  });
+
+  it('clamps before the first and after the last keyframe', () => {
+    const track = createAnimationTrack({ times: [1, 2], values: [3, 9] });
+    const out = [0];
+    sampleAnimationTrack(out, track, -5);
+    expect(out[0]).toBe(3);
+    sampleAnimationTrack(out, track, 99);
+    expect(out[0]).toBe(9);
+  });
+
+  it('holds the previous keyframe for step interpolation', () => {
+    const track = createAnimationTrack({ interpolation: AnimationInterpolationStep, times: [0, 1], values: [0, 10] });
+    const out = [0];
+    sampleAnimationTrack(out, track, 0.9);
+    expect(out[0]).toBe(0);
+  });
+
+  it('interpolates a Vector3 component-wise', () => {
+    const track = createAnimationTrack({ components: 3, times: [0, 1], values: [0, 0, 0, 2, 4, 6] });
+    const out = [0, 0, 0];
+    sampleAnimationTrack(out, track, 0.5);
+    expect(out).toEqual([1, 2, 3]);
+  });
+
+  it('slerps a quaternion track to the half-angle', () => {
+    // identity -> 90deg about +Z; midpoint is 45deg about +Z.
+    const s = Math.sin(Math.PI / 4);
+    const c = Math.cos(Math.PI / 4);
+    const track = createAnimationTrack({
+      components: 4,
+      quaternion: true,
+      times: [0, 1],
+      values: [0, 0, 0, 1, 0, 0, s, c],
+    });
+    const out = [0, 0, 0, 0];
+    sampleAnimationTrack(out, track, 0.5);
+    expect(out[2]).toBeCloseTo(Math.sin(Math.PI / 8), 5);
+    expect(out[3]).toBeCloseTo(Math.cos(Math.PI / 8), 5);
+    expect(Math.hypot(out[0], out[1], out[2], out[3])).toBeCloseTo(1, 5);
+  });
+
+  it('cubic-splines to the midpoint with zero tangents', () => {
+    // Per-keyframe layout [inTangent, value, outTangent]; zero tangents -> smoothstep, 0.5 -> midpoint.
+    const track = createAnimationTrack({
+      interpolation: AnimationInterpolationCubic,
+      times: [0, 1],
+      values: [0, 0, 0, 0, 10, 0],
+    });
+    const out = [0];
+    sampleAnimationTrack(out, track, 0.5);
+    expect(out[0]).toBeCloseTo(5);
+  });
+
+  it('applies a non-null easing to the segment alpha', () => {
+    const track = createAnimationTrack({ easing: () => 0, times: [0, 1], values: [0, 10] });
+    const out = [0];
+    sampleAnimationTrack(out, track, 0.75);
+    // easing forces alpha to 0 -> first keyframe value regardless of t.
+    expect(out[0]).toBe(0);
+  });
+
+  it('returns the first value when t is exactly on the first keyframe', () => {
+    const track = createAnimationTrack({ times: [2, 5], values: [7, 42] });
+    const out = [0];
+    sampleAnimationTrack(out, track, 2);
+    expect(out[0]).toBe(7);
+  });
+
+  it('returns the last value when t is exactly on the last keyframe', () => {
+    const track = createAnimationTrack({ times: [2, 5], values: [7, 42] });
+    const out = [0];
+    sampleAnimationTrack(out, track, 5);
+    expect(out[0]).toBe(42);
+  });
+
+  it('returns zeros for all components when the track is empty', () => {
+    const track = createAnimationTrack({ components: 3, times: [], values: [] });
+    const out = [9, 9, 9];
+    sampleAnimationTrack(out, track, 0);
+    expect(out).toEqual([0, 0, 0]);
+  });
+
+  it('returns the only keyframe value for a single-keyframe track', () => {
+    const track = createAnimationTrack({ times: [5], values: [99] });
+    const out = [0];
+    sampleAnimationTrack(out, track, 0);
+    expect(out[0]).toBe(99);
+    sampleAnimationTrack(out, track, 5);
+    expect(out[0]).toBe(99);
+    sampleAnimationTrack(out, track, 1000);
+    expect(out[0]).toBe(99);
+  });
+});