reze-engine 0.30.2 → 0.31.2

package/dist/locomotion.js

@@ -15,6 +15,13 @@ function wrapAngle(a) {
 }
 export class LocomotionController {
     constructor(model, clips, options) {
+        this.lastEntries = null;
+        this.turning = null;
+        this.runTurning = null;
+        /** An interrupted authored clip fading out OVER resumed locomotion, so breaking
+         *  out of a stop is instantly responsive without a pose pop. */
+        this.exitGhost = null;
+        this.stopping = null;
         this.inputX = 0;
         this.inputY = 0;
         this.inputSprint = false;
@@ -23,6 +30,10 @@ export class LocomotionController {
         this.inputForward = 0;
         this.inputSteer = 0;
         this.speedLevel = 0;
+        /** Peak-hold of speedLevel (decays ~1.5/s): reversal triggers read this, because
+         *  keyboard direction flips pass through a dead moment (W+S cancel, key gap) that
+         *  dips the instantaneous level right when the reversal input lands. */
+        this.recentSpeed = 0;
         this.yaw = 0;
         // Movement direction = the INPUT heading, not the body yaw. The body turns
         // cosmetically toward it; translating along the (sweeping) body yaw instead
@@ -40,8 +51,17 @@ export class LocomotionController {
         this.runSpeed = options?.runSpeed ?? 67;
         this.sprintSpeed = options?.sprintSpeed ?? 92;
         this.speedResponse = options?.speedResponse ?? 5;
+        this.autoApply = options?.autoApply ?? true;
         this.turnResponse = options?.turnResponse ?? 10;
         this.cosTurnThreshold = Math.cos(options?.turnInPlaceThreshold ?? Math.PI / 4);
+        this.turnClipMinAngle = options?.turnClipMinAngle ?? (100 * Math.PI) / 180;
+        this.turnTimeScale = options?.turnTimeScale ?? 1.4;
+        this.stopTimeScale = options?.stopTimeScale ?? 1.25;
+        this.turnEntries = [
+            { name: clips.idle, time: 0, weight: 0 },
+            { name: clips.idle, time: 0, weight: 1 },
+            { name: clips.idle, time: 0, weight: 0 },
+        ];
         this.steerRate = options?.steerRate ?? 2.5;
         this.backpedalScale = options?.backpedalScale ?? 0.5;
         this.yawOffset = options?.yawOffset ?? Math.PI;
@@ -49,6 +69,7 @@ export class LocomotionController {
             { name: clips.idle, time: 0, weight: 1 },
             { name: clips.run, time: 0, weight: 0 },
             { name: clips.sprint ?? clips.run, time: 0, weight: 0 },
+            { name: clips.idle, time: 0, weight: 0 }, // fading ghost of an interrupted clip
         ];
         const byAngle = (a, b) => a.angle - b.angle;
         this.strafeRun = clips.strafeRun ? [...clips.strafeRun].sort(byAngle) : null;
@@ -97,7 +118,19 @@ export class LocomotionController {
     }
     /** Stop driving the model's pose (the blend is cleared; the single-clip player resumes). */
     detach() {
-        this.model.clearBlendPose();
+        this.lastEntries = null;
+        if (this.autoApply)
+            this.model.clearBlendPose();
+    }
+    /** The most recent update()'s blend entries (null before the first update or
+     *  after detach). The array is reused between frames — read, don't hold. */
+    getBlendEntries() {
+        return this.lastEntries;
+    }
+    emit(entries) {
+        this.lastEntries = entries;
+        if (this.autoApply)
+            this.model.setBlendPose(entries);
     }
     clipDuration(name) {
         const frames = this.model.getClip(name)?.frameCount ?? 0;
@@ -111,6 +144,15 @@ export class LocomotionController {
         if (this.facingYaw !== null && this.strafeRun !== null && !this.tankMode) {
             return this.updateStrafe(dt);
         }
+        if (this.turning !== null) {
+            return this.updateTurnClip(dt);
+        }
+        if (this.runTurning !== null) {
+            return this.updateRunTurn(dt);
+        }
+        if (this.stopping !== null) {
+            return this.updateStop(dt);
+        }
         const hasSprint = this.clips.sprint !== undefined;
         let moving;
         let align = 1;
@@ -131,12 +173,99 @@ export class LocomotionController {
         else {
             const m = Math.hypot(this.inputX, this.inputY);
             moving = m > 0.05;
+            this.recentSpeed = Math.max(this.speedLevel, this.recentSpeed - dt * 1.5);
+            // Release at speed: play the authored stop instead of blending to idle.
+            const stops = this.clips.stop;
+            // Gate on the peak-hold speed: the release decay (throttle/analog) drains the
+            // instantaneous level below any threshold before `moving` goes false. The
+            // small floor on the actual level keeps standstill taps from faking a skid.
+            if (!moving && stops && stops.length > 0 && this.recentSpeed >= 0.7 && this.speedLevel >= 0.35) {
+                const gear = this.recentSpeed > 1.4 ? "sprint" : "run";
+                const foot = this.gaitPhase < 0.5 ? "L" : "R";
+                // Gear must match exactly: supplying stops for only one gear means the
+                // other gear keeps the default quick blend-to-idle.
+                let best = null;
+                let bestScore = -1;
+                for (const e of stops) {
+                    if (e.gear !== gear)
+                        continue;
+                    const score = e.foot === foot ? 1 : 0;
+                    if (score > bestScore) {
+                        best = e;
+                        bestScore = score;
+                    }
+                }
+                if (best) {
+                    const fromClip = gear === "sprint" && this.clips.sprint ? this.clips.sprint : this.clips.run;
+                    this.stopping = {
+                        entry: best,
+                        time: 0,
+                        startX: this.position.x,
+                        startZ: this.position.z,
+                        dirX: this.dirX,
+                        dirZ: this.dirZ,
+                        startLevel: Math.min(this.recentSpeed, 2),
+                        fromIdleW: Math.max(0, 1 - this.speedLevel),
+                        fromClip,
+                        fromTime: this.gaitPhase * this.clipDuration(fromClip),
+                    };
+                    return this.updateStop(dt);
+                }
+            }
             // Yaw eases toward the input heading only while there is one. Turns are strictly
             // in place: zero translation outside the threshold cone, ramping smoothly to full
             // speed as the body aligns — so direction reversals (L-R-L) cannot drift.
             if (moving) {
                 const desired = Math.atan2(this.inputX, this.inputY);
                 const err = wrapAngle(desired - this.yaw);
+                // Running reversal: while moving fast with a reversal-class error, play the
+                // authored plant-and-turn for the current gear and gait foot.
+                const runTurns = this.clips.runTurn;
+                if (runTurns && runTurns.length > 0 && this.recentSpeed >= 0.6 && Math.abs(err) >= (130 * Math.PI) / 180) {
+                    const gear = this.recentSpeed > 1.4 ? "sprint" : "run";
+                    const foot = this.gaitPhase < 0.5 ? "L" : "R";
+                    const side = err < 0 ? -1 : 1;
+                    let best = null;
+                    let bestScore = -1;
+                    for (const e of runTurns) {
+                        if (Math.sign(e.angle) !== side)
+                            continue;
+                        const score = (e.gear === gear ? 2 : 0) + (e.foot === foot ? 1 : 0);
+                        if (score > bestScore) {
+                            best = e;
+                            bestScore = score;
+                        }
+                    }
+                    if (best) {
+                        // Restore the pre-dip speed so she runs OUT of the turn at pace.
+                        this.speedLevel = Math.max(this.speedLevel, Math.min(this.recentSpeed, 2));
+                        this.runTurning = {
+                            entry: best,
+                            time: 0,
+                            startX: this.position.x,
+                            startZ: this.position.z,
+                            dirX: Math.sin(this.yaw),
+                            dirZ: Math.cos(this.yaw),
+                        };
+                        return this.updateRunTurn(dt);
+                    }
+                }
+                // Reversal-class turn from near-standstill: play the authored turn clip
+                // whose angle is nearest the error instead of the eased pivot.
+                const turnClips = this.clips.turnInPlace;
+                if (turnClips && turnClips.length > 0 && this.speedLevel < 0.3 && Math.abs(err) >= this.turnClipMinAngle) {
+                    let best = turnClips[0];
+                    let bestD = Math.abs(wrapAngle(err - best.angle));
+                    for (const e of turnClips) {
+                        const d = Math.abs(wrapAngle(err - e.angle));
+                        if (d < bestD) {
+                            best = e;
+                            bestD = d;
+                        }
+                    }
+                    this.turning = { entry: best, time: 0 };
+                    return this.updateTurnClip(dt);
+                }
                 this.yaw = wrapAngle(this.yaw + err * Math.min(1, this.turnResponse * dt));
                 align = Math.max(0, (Math.cos(err) - this.cosTurnThreshold) / (1 - this.cosTurnThreshold));
                 this.dirX = this.inputX / m;
@@ -186,7 +315,28 @@ export class LocomotionController {
         this.entries[1].weight = wRun;
         this.entries[2].time = this.gaitPhase * sprintDur;
         this.entries[2].weight = wSprint;
-        this.model.setBlendPose(this.entries);
+        const GHOST_FADE = 0.25;
+        if (this.exitGhost) {
+            const g = this.exitGhost;
+            g.elapsed += dt;
+            const wGhost = Math.max(0, 1 - g.elapsed / GHOST_FADE);
+            if (wGhost <= 0) {
+                this.exitGhost = null;
+                this.entries[3].weight = 0;
+            }
+            else {
+                this.entries[0].weight *= 1 - wGhost;
+                this.entries[1].weight *= 1 - wGhost;
+                this.entries[2].weight *= 1 - wGhost;
+                this.entries[3].name = g.clip;
+                this.entries[3].time = g.clipTime + g.elapsed; // the clip's real tail keeps playing
+                this.entries[3].weight = wGhost;
+            }
+        }
+        else {
+            this.entries[3].weight = 0;
+        }
+        this.emit(this.entries);
         const ry = this.yaw + this.yawOffset;
         const half = ry * 0.5;
         this.rotation.setXYZW(0, Math.sin(half), 0, Math.cos(half));
@@ -286,7 +436,7 @@ export class LocomotionController {
         e[4].name = sprintB.clip;
         e[4].time = this.gaitPhase * sprintDur;
         e[4].weight = wSprint * sprintT;
-        this.model.setBlendPose(e);
+        this.emit(e);
         const ry = this.yaw + this.yawOffset;
         const half = ry * 0.5;
         this.rotation.setXYZW(0, Math.sin(half), 0, Math.cos(half));
@@ -294,4 +444,183 @@ export class LocomotionController {
         this.pose.speedLevel = level;
         return this.pose;
     }
+    /** Authored turn-in-place frame: the clip rotates the body through its bones while
+     *  the root yaw stays frozen; at exitTime the measured angle transfers to the root
+     *  in the same instant the pose hands back to idle — the same orientation expressed
+     *  two ways, so the cut is seamless. No translation during the turn. */
+    updateTurnClip(dt) {
+        const t = this.turning;
+        t.time += dt * this.turnTimeScale;
+        // Speed level settles toward 0 while turning (we were near-standstill already).
+        const maxStep = this.speedResponse * dt;
+        this.speedLevel += Math.abs(-this.speedLevel) <= maxStep ? -this.speedLevel : -Math.sign(this.speedLevel) * maxStep;
+        const idleDur = this.clipDuration(this.clips.idle);
+        this.idleTime = (this.idleTime + dt) % idleDur;
+        if (t.time >= t.entry.exitTime) {
+            // Transfer the angle to the root and hand the pose to idle IN THE SAME frame —
+            // leaving the previous blend up would double the rotation for one frame.
+            this.yaw = wrapAngle(this.yaw + t.entry.angle);
+            this.turning = null;
+            const e = this.turnEntries;
+            e[0].weight = 0;
+            e[1].name = this.clips.idle;
+            e[1].time = this.idleTime;
+            e[1].weight = 1;
+            e[2].weight = 0;
+            this.emit(e);
+        }
+        else {
+            // Fade the turn clip over idle at the edges so entry doesn't pop.
+            const w = Math.min(1, t.time / 0.12);
+            const e = this.turnEntries;
+            e[0].name = t.entry.clip;
+            e[0].time = Math.min(t.time, t.entry.exitTime);
+            e[0].weight = w;
+            e[1].name = this.clips.idle;
+            e[1].time = this.idleTime;
+            e[1].weight = 1 - w;
+            e[2].weight = 0;
+            this.emit(e);
+        }
+        const ry = this.yaw + this.yawOffset;
+        const half = ry * 0.5;
+        this.rotation.setXYZW(0, Math.sin(half), 0, Math.cos(half));
+        this.pose.yaw = this.yaw;
+        this.pose.speedLevel = this.speedLevel;
+        return this.pose;
+    }
+    /** Authored-stop frame: root follows the clip's measured skid profile along the
+     *  release heading; input returning interrupts and resumes locomotion at a level
+     *  proportional to how much of the stop remains. */
+    updateStop(dt) {
+        const t = this.stopping;
+        const entry = t.entry;
+        // Interrupt: input came back — locomotion resumes instantly from a LOW level
+        // (a stop is committed; breaking out is a fresh walk-up, never a drift), while
+        // the stop pose fades out as a ghost instead of hard-cutting.
+        if (Math.hypot(this.inputX, this.inputY) > 0.05) {
+            this.speedLevel = Math.min(t.startLevel * (1 - Math.min(1, t.time / entry.exitTime)), 0.3);
+            this.recentSpeed = this.speedLevel;
+            this.exitGhost = { clip: entry.clip, clipTime: Math.min(t.time, entry.exitTime), elapsed: 0 };
+            this.stopping = null;
+            return this.update(dt);
+        }
+        t.time += dt * this.stopTimeScale;
+        const clipT = Math.min(t.time, entry.exitTime);
+        const fwd = LocomotionController.profileAt(entry.forward, clipT / entry.exitTime);
+        this.position.x = t.startX + t.dirX * fwd;
+        this.position.z = t.startZ + t.dirZ * fwd;
+        this.speedLevel = t.startLevel * Math.max(0, 1 - t.time / entry.exitTime);
+        const idleDur = this.clipDuration(this.clips.idle);
+        this.idleTime = (this.idleTime + dt) % idleDur;
+        const FADE_OUT = 0.35;
+        if (t.time >= entry.exitTime + FADE_OUT) {
+            this.stopping = null;
+            this.speedLevel = 0;
+            this.gaitPhase = 0;
+            const e = this.turnEntries;
+            e[0].weight = 0;
+            e[1].name = this.clips.idle;
+            e[1].time = this.idleTime;
+            e[1].weight = 1;
+            e[2].weight = 0;
+            this.emit(e);
+        }
+        else if (t.time >= entry.exitTime) {
+            // Settle tail: the root is already still, so keep playing the clip's own
+            // recovery (it exists past exitTime) while fading to idle — no hard cut.
+            const wOut = (t.time - entry.exitTime) / FADE_OUT;
+            const e = this.turnEntries;
+            e[0].name = entry.clip;
+            e[0].time = t.time; // real tail frames beyond exitTime
+            e[0].weight = 1 - wOut;
+            e[1].name = this.clips.idle;
+            e[1].time = this.idleTime;
+            e[1].weight = wOut;
+            e[2].weight = 0;
+            this.emit(e);
+        }
+        else {
+            const fromDur = this.clipDuration(t.fromClip);
+            t.fromTime = (t.fromTime + dt) % fromDur;
+            const w = Math.min(1, t.time / 0.25);
+            const e = this.turnEntries;
+            e[0].name = entry.clip;
+            e[0].time = clipT;
+            e[0].weight = w;
+            e[1].name = t.fromClip;
+            e[1].time = t.fromTime;
+            e[1].weight = (1 - w) * (1 - t.fromIdleW);
+            e[2].name = this.clips.idle;
+            e[2].time = this.idleTime;
+            e[2].weight = (1 - w) * t.fromIdleW;
+            this.emit(e);
+        }
+        const ry = this.yaw + this.yawOffset;
+        const half = ry * 0.5;
+        this.rotation.setXYZW(0, Math.sin(half), 0, Math.cos(half));
+        this.pose.yaw = this.yaw;
+        this.pose.speedLevel = this.speedLevel;
+        return this.pose;
+    }
+    /** Linear interpolation over a uniformly sampled profile at t in [0, 1]. */
+    static profileAt(samples, t) {
+        const n = samples.length - 1;
+        if (n <= 0)
+            return 0;
+        const x = Math.min(Math.max(t, 0), 1) * n;
+        const i = Math.min(n - 1, Math.floor(x));
+        return samples[i] + (samples[i + 1] - samples[i]) * (x - i);
+    }
+    /** Running-reversal frame: bones carry the turn while the root travels the clip's
+     *  AUTHORED forward profile along the trigger heading (overrun, plant, return) —
+     *  no fabricated motion, so the feet stay glued. At exitTime the yaw transfers
+     *  and the normal path runs her out along the new heading. */
+    updateRunTurn(dt) {
+        const t = this.runTurning;
+        t.time += dt;
+        const entry = t.entry;
+        const clipT = Math.min(t.time, entry.exitTime);
+        const fwd = LocomotionController.profileAt(entry.forward, clipT / entry.exitTime);
+        this.position.x = t.startX + t.dirX * fwd;
+        this.position.z = t.startZ + t.dirZ * fwd;
+        const idleDur = this.clipDuration(this.clips.idle);
+        this.idleTime = (this.idleTime + dt) % idleDur;
+        if (t.time >= entry.exitTime) {
+            this.yaw = wrapAngle(this.yaw + entry.angle);
+            this.runTurning = null;
+            // She exits mid-stride: keep the speed level, restart the gait cleanly, and
+            // point the travel direction along the new heading so the next frame runs out.
+            this.gaitPhase = 0;
+            this.dirX = Math.sin(this.yaw);
+            this.dirZ = Math.cos(this.yaw);
+            const e = this.turnEntries;
+            e[0].name = this.clips.run;
+            e[0].time = 0;
+            e[0].weight = Math.min(1, this.speedLevel);
+            e[1].name = this.clips.idle;
+            e[1].time = this.idleTime;
+            e[1].weight = 1 - Math.min(1, this.speedLevel);
+            e[2].weight = 0;
+            this.emit(e);
+        }
+        else {
+            const w = Math.min(1, t.time / 0.1);
+            const e = this.turnEntries;
+            e[0].name = entry.clip;
+            e[0].time = clipT;
+            e[0].weight = w;
+            e[1].name = this.clips.run;
+            e[1].time = this.gaitPhase * this.clipDuration(this.clips.run);
+            e[1].weight = 1 - w;
+            e[2].weight = 0;
+            this.emit(e);
+        }
+        const ry = this.yaw + this.yawOffset;
+        const half = ry * 0.5;
+        this.rotation.setXYZW(0, Math.sin(half), 0, Math.cos(half));
+        this.pose.yaw = this.yaw;
+        this.pose.speedLevel = this.speedLevel;
+        return this.pose;
+    }
 }

package/dist/model.d.ts

@@ -2,6 +2,13 @@ import { Mat4, Quat, Vec3 } from "./math";
 import { type AssetReader } from "./asset-reader";
 import { Rigidbody, Joint } from "./physics";
 import { AnimationClip, AnimationPlayOptions, AnimationProgress, BlendEntry } from "./animation";
+export interface ClipEventInfo {
+    clip: string;
+    /** The registered event time, seconds. */
+    time: number;
+    /** The clip's blend weight at the moment of firing. */
+    weight: number;
+}
 export interface Texture {
     path: string;
     name: string;
@@ -157,6 +164,10 @@ export declare class Model {
     private lastAppliedClip;
     private oneShot;
     private readonly oneShotEntries;
+    /** Time-triggered clip callbacks (footsteps, skill timing). Fired by every
+     *  playback path when a clip's cursor crosses the event time with weight. */
+    private readonly clipEvents;
+    private readonly entryEventPrev;
     private blendEntries;
     private crossfade;
     private readonly blendBoneCursors;
@@ -253,6 +264,18 @@ export declare class Model {
     cancelOneShot(fadeOut?: number): void;
     /** Name of the active one-shot, or null. */
     getOneShot(): string | null;
+    /** Fire `callback` whenever `clip`'s playback crosses `time` (seconds) with at
+     *  least `minWeight` influence (default 0.1) — on any path: blend entries,
+     *  one-shots, crossfades, or plain play. Loop wraps fire correctly; hard cursor
+     *  jumps may occasionally fire or skip (events are for sfx-grade timing, not
+     *  logic). Returns an unsubscribe function. */
+    addClipEvent(clip: string, time: number, callback: (e: ClipEventInfo) => void, options?: {
+        minWeight?: number;
+    }): () => void;
+    private fireClipEvents;
+    /** Per-entry cursor memory for event crossing detection; keyed on entry object
+     *  identity (controllers reuse their arrays, so this stays warm). */
+    private trackEntryEvents;
     /** Fade from the currently playing clip (or from the rest pose when nothing plays)
      *  into `name` over `seconds`. The target starts at frame 0 and becomes the current
      *  clip immediately — progress, looping and the camera clock report the target for

package/dist/model.d.ts.map

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

package/dist/model.js

@@ -106,6 +106,10 @@ export class Model {
         // envelopes — the background keeps advancing and is what the fade-out returns to.
         this.oneShot = null;
         this.oneShotEntries = [];
+        /** Time-triggered clip callbacks (footsteps, skill timing). Fired by every
+         *  playback path when a clip's cursor crosses the event time with weight. */
+        this.clipEvents = new Map();
+        this.entryEventPrev = new WeakMap();
         // Blended pose: declarative N-clip mix (setBlendPose) or a running crossfade.
         // Cursor caches are per clip so sampling several clips in one frame doesn't
         // thrash the single-clip caches above; WeakMap so removed clips can collect.
@@ -1079,6 +1083,52 @@ export class Model {
     getOneShot() {
         return this.oneShot?.name ?? null;
     }
+    /** Fire `callback` whenever `clip`'s playback crosses `time` (seconds) with at
+     *  least `minWeight` influence (default 0.1) — on any path: blend entries,
+     *  one-shots, crossfades, or plain play. Loop wraps fire correctly; hard cursor
+     *  jumps may occasionally fire or skip (events are for sfx-grade timing, not
+     *  logic). Returns an unsubscribe function. */
+    addClipEvent(clip, time, callback, options) {
+        let list = this.clipEvents.get(clip);
+        if (!list) {
+            list = [];
+            this.clipEvents.set(clip, list);
+        }
+        const def = { time, minWeight: options?.minWeight ?? 0.1, callback };
+        list.push(def);
+        return () => {
+            const i = list.indexOf(def);
+            if (i >= 0)
+                list.splice(i, 1);
+        };
+    }
+    fireClipEvents(name, prev, now, weight) {
+        const evs = this.clipEvents.get(name);
+        if (!evs || evs.length === 0)
+            return;
+        const wrapped = now < prev;
+        for (let i = 0; i < evs.length; i++) {
+            const ev = evs[i];
+            if (weight < ev.minWeight)
+                continue;
+            const hit = wrapped ? ev.time > prev || ev.time <= now : ev.time > prev && ev.time <= now;
+            if (hit)
+                ev.callback({ clip: name, time: ev.time, weight });
+        }
+    }
+    /** Per-entry cursor memory for event crossing detection; keyed on entry object
+     *  identity (controllers reuse their arrays, so this stays warm). */
+    trackEntryEvents(e) {
+        const prev = this.entryEventPrev.get(e);
+        if (prev === undefined) {
+            this.entryEventPrev.set(e, { name: e.name, time: e.time });
+            return;
+        }
+        if (prev.name === e.name && prev.time !== e.time)
+            this.fireClipEvents(e.name, prev.time, e.time, e.weight);
+        prev.name = e.name;
+        prev.time = e.time;
+    }
     /** Fade from the currently playing clip (or from the rest pose when nothing plays)
      *  into `name` over `seconds`. The target starts at frame 0 and becomes the current
      *  clip immediately — progress, looping and the camera clock report the target for
@@ -1335,6 +1385,8 @@ export class Model {
                 continue;
             const w = e.weight * norm;
             const frame = e.time * FPS;
+            if (this.clipEvents.size > 0)
+                this.trackEntryEvents(e);
             let cursors = this.blendBoneCursors.get(clip);
             if (!cursors) {
                 cursors = new Map();
@@ -1526,6 +1578,8 @@ export class Model {
         this.tweenTimeMs += deltaTime * 1000;
         // Update all active tweens (rotations, translations, morphs)
         const tweensChangedMorphs = this.updateTweens();
+        const evWatch = this.clipEvents.size > 0 ? this.animationState.getCurrentAnimation() : null;
+        const evPrevFrame = evWatch !== null ? this.animationState.getCurrentFrame() : 0;
         this.animationState.update(deltaTime);
         if (!this.clipApplySuspended) {
             if (this.oneShot !== null) {
@@ -1539,8 +1593,12 @@ export class Model {
             }
             else {
                 const clip = this.animationState.getCurrentClip();
-                if (clip !== null)
+                if (clip !== null) {
                     this.applyPoseFromClip(clip, this.animationState.getCurrentFrame());
+                    if (evWatch !== null && evWatch === this.animationState.getCurrentAnimation()) {
+                        this.fireClipEvents(evWatch, evPrevFrame / FPS, this.animationState.getCurrentFrame() / FPS, 1);
+                    }
+                }
             }
         }
         // Constant per-bone offsets compose after every pose source, before the

package/dist/state-machine.d.ts

@@ -0,0 +1,64 @@
+import type { Model } from "./model";
+import type { BlendEntry } from "./animation";
+export interface AnimStateDef {
+    /** Clip name previously loaded on the model. Mutually exclusive with `entries`. */
+    clip?: string;
+    /** Loop the clip (default true). Non-loop states hold their last frame. */
+    loop?: boolean;
+    /** Clip playback speed multiplier (default 1). */
+    speed?: number;
+    /** Delegate pose producer — return this frame's blend entries (e.g. a
+     *  LocomotionController with autoApply: false). Return null to contribute
+     *  nothing (the pose relaxes toward rest per setBlendPose semantics). */
+    entries?: (dt: number) => BlendEntry[] | null;
+    onEnter?: (from: string | null) => void;
+    onExit?: (to: string) => void;
+}
+export interface AnimTransitionDef {
+    /** Source state name, or "*" for any state (never fires into itself). */
+    from: string | "*";
+    to: string;
+    /** Condition, checked every update. Omitted = unconditional. */
+    when?: () => boolean;
+    /** Fire only once the state has been active this many seconds. On a clip
+     *  state with NO `when` and NO `exitTime`, the transition fires when the
+     *  (non-looping) clip approaches its end — the "skill finished, back to
+     *  locomotion" pattern. */
+    exitTime?: number;
+    /** Crossfade seconds (default: machine's defaultFade). */
+    fade?: number;
+}
+export interface StateMachineOptions {
+    initial: string;
+    /** Crossfade used when a transition does not specify one (default 0.25). */
+    defaultFade?: number;
+}
+export declare class AnimationStateMachine {
+    private readonly model;
+    private readonly states;
+    private readonly transitions;
+    private readonly defaultFade;
+    private current;
+    /** Outgoing state during a crossfade — keeps playing while it fades. */
+    private fading;
+    private readonly merged;
+    constructor(model: Model, states: Record<string, AnimStateDef>, transitions: AnimTransitionDef[], options: StateMachineOptions);
+    get state(): string;
+    /** Seconds the current state has been active. */
+    get stateTime(): number;
+    /** Force a transition now, regardless of the transition table. */
+    go(to: string, fade?: number): void;
+    update(dt: number): void;
+    private transitionReady;
+    private begin;
+    /** This frame's entries for a state: clip states own a one-entry pose;
+     *  delegate states produce their own. Returns null for "no pose". */
+    private produce;
+    private readonly inScratch;
+    private readonly outScratch;
+    /** Merge up to two entry lists scaled by their group weights into the stable
+     *  scratch array and hand it to the model. */
+    private apply;
+    private clipDuration;
+}
+//# sourceMappingURL=state-machine.d.ts.map

package/dist/state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../src/state-machine.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAK7C,MAAM,WAAW,YAAY;IAC3B,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,2EAA2E;IAC3E,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;6EAEyE;IACzE,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,UAAU,EAAE,GAAG,IAAI,CAAA;IAC7C,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IACvC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,IAAI,EAAE,MAAM,GAAG,GAAG,CAAA;IAClB,EAAE,EAAE,MAAM,CAAA;IACV,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,OAAO,CAAA;IACpB;;;+BAG2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAQD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAO;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IAEpC,OAAO,CAAC,OAAO,CAAa;IAC5B,wEAAwE;IACxE,OAAO,CAAC,MAAM,CAAyE;IAIvF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;gBAE9B,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,WAAW,EAAE,iBAAiB,EAAE,EAAE,OAAO,EAAE,mBAAmB;IAW9H,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,iDAAiD;IACjD,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,kEAAkE;IAClE,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAInC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAgCxB,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,KAAK;IAYb;yEACqE;IACrE,OAAO,CAAC,OAAO;IAaf,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmD;IAC7E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmD;IAE9E;kDAC8C;IAC9C,OAAO,CAAC,KAAK;IAyBb,OAAO,CAAC,YAAY;CAIrB"}