@aura3d/engine 4.1.2 → 4.2.0

package/dist/game/motion/locomotion.d.ts

@@ -0,0 +1,55 @@
+export interface LocomotionGait {
+    readonly name: string;
+    /** Ground speed in m/s that the clip's root travels at playback rate 1. 0 for idle. */
+    readonly speed: number;
+    /** Seconds for one full stride cycle at playback rate 1. */
+    readonly cycle: number;
+}
+export interface LocomotionOptions {
+    readonly gaits: readonly LocomotionGait[];
+    /** Weight change per second when blending between gaits (default 6). */
+    readonly blendRate?: number;
+    readonly minRate?: number;
+    readonly maxRate?: number;
+}
+export interface LocomotionFrame {
+    readonly weights: Readonly<Record<string, number>>;
+    readonly rates: Readonly<Record<string, number>>;
+    /** Stride phase of the dominant gait, 0 to 1. */
+    readonly phase: number;
+    readonly dominant: string;
+    /** True when ground speed exceeds the fastest gait by more than the rate clamp can hide. */
+    readonly overspeed: boolean;
+}
+export interface Locomotion {
+    update(groundSpeed: number, dt: number): LocomotionFrame;
+    reset(): void;
+}
+/**
+ * Drives idle/walk/run/sprint clips from real ground speed so feet match the ground: clip weights
+ * follow speed brackets and playback rate = speed / clip speed (clamped), so planted feet do not slide.
+ */
+export declare function createLocomotion(options: LocomotionOptions): Locomotion;
+export interface LegPose {
+    /** Hip flexion, radians (positive swings the leg forward). */
+    readonly hip: number;
+    /** Knee flexion, radians (0 straight, positive bends). */
+    readonly knee: number;
+    readonly ankle: number;
+}
+export interface ProceduralGait {
+    readonly left: LegPose;
+    readonly right: LegPose;
+    /** Arm swing, radians, opposite to the same-side leg. */
+    readonly armLeft: number;
+    readonly armRight: number;
+    /** Vertical bob of the pelvis in metres. */
+    readonly bob: number;
+}
+/** Procedural leg-swing fallback for rigs with no usable walk/run clip. `phase` is a 0..1 stride phase. */
+export declare function proceduralLegSwing(phase: number, groundSpeed: number, options?: {
+    readonly maxHip?: number;
+    readonly maxKnee?: number;
+    readonly speedForMax?: number;
+}): ProceduralGait;
+//# sourceMappingURL=locomotion.d.ts.map

package/dist/game/motion/locomotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locomotion.d.ts","sourceRoot":"","sources":["../../../../../packages/game/src/motion/locomotion.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,wEAAwE;IACxE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4FAA4F;IAC5F,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,eAAe,CAAC;IACzD,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAoEvE;AAED,MAAM,WAAW,OAAO;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,2GAA2G;AAC3G,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,cAAc,CAuB3L"}

package/dist/game/motion/locomotion.js

@@ -0,0 +1,107 @@
+/**
+ * Drives idle/walk/run/sprint clips from real ground speed so feet match the ground: clip weights
+ * follow speed brackets and playback rate = speed / clip speed (clamped), so planted feet do not slide.
+ */
+export function createLocomotion(options) {
+    const gaits = [...options.gaits].sort((a, b) => a.speed - b.speed);
+    if (gaits.length < 2)
+        throw new Error("LOCOMOTION_GAITS: at least an idle and one moving gait are required.");
+    const blendRate = options.blendRate ?? 6;
+    const minRate = options.minRate ?? 0.6;
+    const maxRate = options.maxRate ?? 1.6;
+    const smooth = {};
+    for (const g of gaits)
+        smooth[g.name] = g === gaits[0] ? 1 : 0;
+    let phase = 0;
+    let dominant = gaits[0].name;
+    const target = (speed) => {
+        const w = {};
+        for (const g of gaits)
+            w[g.name] = 0;
+        const last = gaits[gaits.length - 1];
+        if (speed >= last.speed) {
+            w[last.name] = 1;
+            return w;
+        }
+        for (let i = 0; i < gaits.length - 1; i += 1) {
+            const a = gaits[i];
+            const b = gaits[i + 1];
+            if (speed >= a.speed && speed <= b.speed) {
+                const t = b.speed === a.speed ? 1 : (speed - a.speed) / (b.speed - a.speed);
+                w[a.name] = 1 - t;
+                w[b.name] = t;
+                return w;
+            }
+        }
+        w[gaits[0].name] = 1;
+        return w;
+    };
+    return {
+        update(groundSpeed, dt) {
+            const speed = Math.max(0, Number.isFinite(groundSpeed) ? groundSpeed : 0);
+            const want = target(speed);
+            const step = Math.min(1, blendRate * Math.max(0, dt));
+            let total = 0;
+            for (const g of gaits) {
+                smooth[g.name] = smooth[g.name] + (want[g.name] - smooth[g.name]) * step;
+                total += smooth[g.name];
+            }
+            const weights = {};
+            for (const g of gaits)
+                weights[g.name] = total > 0 ? smooth[g.name] / total : 0;
+            const rates = {};
+            const last = gaits[gaits.length - 1];
+            for (const g of gaits) {
+                if (g.speed <= 0)
+                    rates[g.name] = 1;
+                else
+                    rates[g.name] = Math.max(minRate, Math.min(maxRate, speed / g.speed));
+            }
+            let best = gaits[0];
+            for (const g of gaits)
+                if (weights[g.name] > weights[best.name])
+                    best = g;
+            dominant = best.name;
+            if (best.speed > 0)
+                phase = (phase + (dt * rates[best.name]) / best.cycle) % 1;
+            return {
+                weights,
+                rates,
+                phase,
+                dominant,
+                overspeed: speed > last.speed * maxRate
+            };
+        },
+        reset() {
+            for (const g of gaits)
+                smooth[g.name] = g === gaits[0] ? 1 : 0;
+            phase = 0;
+        }
+    };
+}
+/** Procedural leg-swing fallback for rigs with no usable walk/run clip. `phase` is a 0..1 stride phase. */
+export function proceduralLegSwing(phase, groundSpeed, options = {}) {
+    const maxHip = options.maxHip ?? 0.7;
+    const maxKnee = options.maxKnee ?? 1.2;
+    const k = Math.max(0, Math.min(1, groundSpeed / (options.speedForMax ?? 6)));
+    const leg = (offset) => {
+        const a = (phase + offset) * Math.PI * 2;
+        const swing = Math.sin(a);
+        const lift = Math.max(0, Math.cos(a));
+        return {
+            hip: swing * maxHip * k,
+            knee: lift * maxKnee * k,
+            ankle: -swing * 0.25 * k
+        };
+    };
+    const left = leg(0);
+    const right = leg(0.5);
+    return {
+        left,
+        right,
+        armLeft: right.hip * 0.8,
+        armRight: left.hip * 0.8,
+        bob: Math.abs(Math.sin(phase * Math.PI * 2)) * 0.03 * k
+    };
+}
+//# sourceMappingURL=locomotion.js.map

package/dist/game/motion/locomotion.js.map

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

package/dist/game/motion/motionGate.d.ts

@@ -0,0 +1,41 @@
+export interface MotionGateOptions {
+    /** Display refresh rate to simulate. */
+    displayHz: number;
+    /** Seconds of play to simulate. Default 8. */
+    seconds?: number;
+    /** Seconds at the start excluded from the statistics (acceleration from rest). Default 0. */
+    warmupSeconds?: number;
+    /** Fixed step length. Default 1/60. */
+    stepSeconds?: number;
+    /** Frame time jitter in seconds (deterministic, +/-). Default 0. */
+    jitterSeconds?: number;
+    /** Advance the real simulation by one step. */
+    step: (stepSeconds: number, stepIndex: number) => void;
+    /** Called at the end of every step (push the presenter snapshot here). */
+    afterStep?: () => void;
+    /** The scalar entity values drawn this frame (for example x and z of the player), read after the frame's steps. */
+    drawn: (alpha: number) => readonly number[];
+    /** Optional: the animation clip drawn this frame. Counts changes between frames. */
+    clip?: () => string;
+    /** Largest allowed share of frames where a moving entity is drawn unchanged. Default 0.05. */
+    maxStillFraction?: number;
+    /** Largest allowed coefficient of variation of the per-frame displacement. Default 0.25. */
+    maxCv?: number;
+    /** Largest allowed clip changes per 10 seconds. Default 4. */
+    maxClipFlipsPer10s?: number;
+}
+export interface MotionGateReport {
+    readonly frames: number;
+    readonly stillFrames: number;
+    readonly stillFraction: number;
+    readonly cv: number;
+    readonly clipFlipsPer10s: number;
+    readonly passed: boolean;
+    readonly failures: readonly string[];
+}
+/**
+ * Drives the real fixed-step loop at a simulated display rate and reports whether the drawn entities advance
+ * smoothly: no frames where they stand still, no uneven jumps, no clip flapping. Pure, no DOM.
+ */
+export declare function runMotionGate(options: MotionGateOptions): MotionGateReport;
+//# sourceMappingURL=motionGate.d.ts.map

package/dist/game/motion/motionGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motionGate.d.ts","sourceRoot":"","sources":["../../../../../packages/game/src/motion/motionGate.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6FAA6F;IAC7F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,mHAAmH;IACnH,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,MAAM,EAAE,CAAC;IAC5C,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,MAAM,CAAC;IACpB,8FAA8F;IAC9F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4FAA4F;IAC5F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CA8D1E"}

package/dist/game/motion/motionGate.js

@@ -0,0 +1,71 @@
+import { createFixedStepLoop } from "../../engine/index.js";
+/**
+ * Drives the real fixed-step loop at a simulated display rate and reports whether the drawn entities advance
+ * smoothly: no frames where they stand still, no uneven jumps, no clip flapping. Pure, no DOM.
+ */
+export function runMotionGate(options) {
+    const seconds = options.seconds ?? 8;
+    const stepSeconds = options.stepSeconds ?? 1 / 60;
+    const frameMs = 1000 / options.displayHz;
+    const jitterMs = (options.jitterSeconds ?? 0) * 1000;
+    let seed = 1234567;
+    const rand = () => {
+        seed = (seed * 1664525 + 1013904223) >>> 0;
+        return seed / 0xffffffff - 0.5;
+    };
+    let clock = 0;
+    const loop = createFixedStepLoop({
+        stepSeconds,
+        step: (dt, index) => {
+            options.step(dt, index);
+            options.afterStep?.();
+        },
+        now: () => clock,
+        schedule: () => 0,
+        cancel: () => undefined
+    });
+    const frames = Math.round(seconds * options.displayHz);
+    const warmupFrames = Math.round((options.warmupSeconds ?? 0) * options.displayHz);
+    const previous = [];
+    const displacement = [];
+    let still = 0;
+    let flips = 0;
+    let lastClip;
+    let counted = 0;
+    for (let f = 0; f < frames; f += 1) {
+        clock += frameMs + (jitterMs ? rand() * 2 * jitterMs : 0);
+        loop.tick(clock);
+        const values = options.drawn(loop.alpha);
+        if (previous.length === values.length && f > 1 + warmupFrames) {
+            let moved = 0;
+            for (let i = 0; i < values.length; i += 1)
+                moved += Math.abs(values[i] - previous[i]);
+            displacement.push(moved);
+            if (moved < 1e-9)
+                still += 1;
+            counted += 1;
+        }
+        previous.length = 0;
+        previous.push(...values);
+        if (options.clip) {
+            const clip = options.clip();
+            if (lastClip !== undefined && clip !== lastClip)
+                flips += 1;
+            lastClip = clip;
+        }
+    }
+    const mean = displacement.reduce((s, v) => s + v, 0) / Math.max(1, displacement.length);
+    const variance = displacement.reduce((s, v) => s + (v - mean) ** 2, 0) / Math.max(1, displacement.length);
+    const cv = mean > 0 ? Math.sqrt(variance) / mean : 0;
+    const stillFraction = counted > 0 ? still / counted : 0;
+    const clipFlipsPer10s = flips * (10 / seconds);
+    const failures = [];
+    if (stillFraction > (options.maxStillFraction ?? 0.05))
+        failures.push(`still frames ${(stillFraction * 100).toFixed(1)}%`);
+    if (cv > (options.maxCv ?? 0.25))
+        failures.push(`displacement CV ${cv.toFixed(3)}`);
+    if (clipFlipsPer10s > (options.maxClipFlipsPer10s ?? 4))
+        failures.push(`clip flips ${clipFlipsPer10s.toFixed(0)} per 10 s`);
+    return { frames: counted, stillFrames: still, stillFraction, cv, clipFlipsPer10s, passed: failures.length === 0, failures };
+}
+//# sourceMappingURL=motionGate.js.map

package/dist/game/motion/motionGate.js.map

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

package/dist/game/motion/presenter.d.ts

@@ -0,0 +1,37 @@
+/** Anything with a 0..1 progress through the current simulation step, such as `createFixedStepLoop`. */
+export interface AlphaSource {
+    readonly alpha: number;
+}
+export interface FixedStepPresenterOptions<T> {
+    /** Capture what the renderer needs of the simulation right now. Must return a fresh value each call. */
+    snapshot: () => T;
+    /** Blend two snapshots; `t` is 0 at `a` and 1 at `b`. */
+    blend: (a: T, b: T, t: number) => T;
+}
+export interface FixedStepPresenter<T> {
+    /** Call at the end of every simulation step. */
+    afterStep(): void;
+    /** Call after a teleport, restart or scene change so the next frame does not smear between unrelated states. */
+    reset(): void;
+    /** The state to draw this frame: interpolated while `live`, the latest step otherwise (menus, manual QA runs). */
+    present(source: AlphaSource, live?: boolean): T;
+}
+/**
+ * Render interpolation in three calls: a 60 Hz simulation shown on a 120 or 144 Hz display advances on every
+ * frame instead of every other one. Replays and `stepFrames` are untouched because only the drawn pose is blended.
+ */
+export declare function createFixedStepPresenter<T>(options: FixedStepPresenterOptions<T>): FixedStepPresenter<T>;
+export interface RecordBlendOptions<T> {
+    /** Property names holding angles in radians: blended along the shortest arc. */
+    angleKeys?: readonly string[];
+    /** A step that moves the tracked position further than this is a teleport or wrap: show the new state. */
+    snapDistance?: number;
+    /** Position used for the snap test. */
+    position?: (value: T) => readonly number[];
+}
+/**
+ * A blend function for plain pose records: numbers interpolate, listed angle keys take the shortest arc, arrays
+ * and typed arrays interpolate per element, and everything else (clip names, flags) takes the latest value.
+ */
+export declare function createRecordBlend<T extends object>(options?: RecordBlendOptions<T>): (a: T, b: T, t: number) => T;
+//# sourceMappingURL=presenter.d.ts.map

package/dist/game/motion/presenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presenter.d.ts","sourceRoot":"","sources":["../../../../../packages/game/src/motion/presenter.ts"],"names":[],"mappings":"AAEA,wGAAwG;AACxG,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,wGAAwG;IACxG,QAAQ,EAAE,MAAM,CAAC,CAAC;IAClB,yDAAyD;IACzD,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,gDAAgD;IAChD,SAAS,IAAI,IAAI,CAAC;IAClB,gHAAgH;IAChH,KAAK,IAAI,IAAI,CAAC;IACd,kHAAkH;IAClH,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC;CACjD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,OAAO,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAkBxG;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,gFAAgF;IAChF,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,0GAA0G;IAC1G,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,SAAS,MAAM,EAAE,CAAC;CAC5C;AA4BD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,GAAE,kBAAkB,CAAC,CAAC,CAAM,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC,CAYrH"}

package/dist/game/motion/presenter.js

@@ -0,0 +1,72 @@
+import { createRenderInterpolator, lerpAngle } from "./smoothing.js";
+/**
+ * Render interpolation in three calls: a 60 Hz simulation shown on a 120 or 144 Hz display advances on every
+ * frame instead of every other one. Replays and `stepFrames` are untouched because only the drawn pose is blended.
+ */
+export function createFixedStepPresenter(options) {
+    const interpolator = createRenderInterpolator(options.blend);
+    interpolator.reset(options.snapshot());
+    return {
+        afterStep() {
+            interpolator.push(options.snapshot());
+        },
+        reset() {
+            interpolator.reset(options.snapshot());
+        },
+        present(source, live = true) {
+            const latest = () => options.snapshot();
+            if (!live)
+                return latest();
+            const alpha = source.alpha;
+            if (alpha >= 1)
+                return latest();
+            return interpolator.sample(alpha) ?? latest();
+        }
+    };
+}
+function blendValue(a, b, t, key, angleKeys) {
+    if (typeof a === "number" && typeof b === "number") {
+        return angleKeys.has(key) ? lerpAngle(a, b, t) : a + (b - a) * t;
+    }
+    if (Array.isArray(a) && Array.isArray(b) && a.length === b.length) {
+        return a.map((x, i) => blendValue(x, b[i], t, key, angleKeys));
+    }
+    if (ArrayBuffer.isView(a) && ArrayBuffer.isView(b) && !(a instanceof DataView) && a.length === b.length) {
+        const aa = a;
+        const bb = b;
+        const out = new a.constructor((aa).length);
+        for (let i = 0; i < aa.length; i += 1)
+            out[i] = aa[i] + (bb[i] - aa[i]) * t;
+        return out;
+    }
+    if (a !== null && b !== null && typeof a === "object" && typeof b === "object") {
+        const out = {};
+        for (const k of Object.keys(b)) {
+            out[k] = k in a
+                ? blendValue(a[k], b[k], t, k, angleKeys)
+                : b[k];
+        }
+        return out;
+    }
+    return b;
+}
+/**
+ * A blend function for plain pose records: numbers interpolate, listed angle keys take the shortest arc, arrays
+ * and typed arrays interpolate per element, and everything else (clip names, flags) takes the latest value.
+ */
+export function createRecordBlend(options = {}) {
+    const angleKeys = new Set(options.angleKeys ?? []);
+    return (a, b, t) => {
+        if (options.snapDistance !== undefined && options.position) {
+            const pa = options.position(a);
+            const pb = options.position(b);
+            let d2 = 0;
+            for (let i = 0; i < Math.min(pa.length, pb.length); i += 1)
+                d2 += (pb[i] - pa[i]) ** 2;
+            if (d2 > options.snapDistance * options.snapDistance)
+                return b;
+        }
+        return blendValue(a, b, t, "", angleKeys);
+    };
+}
+//# sourceMappingURL=presenter.js.map

package/dist/game/motion/presenter.js.map

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

package/dist/game/motion/smoothing.d.ts

@@ -0,0 +1,34 @@
+export type Vec3Tuple = [number, number, number];
+export interface DampResult {
+    readonly value: number;
+    readonly velocity: number;
+}
+/** Critically damped follow (no overshoot, frame-rate independent). `smoothTime` is the time to reach about 95% of the way. */
+export declare function smoothDamp(current: number, target: number, velocity: number, smoothTime: number, dt: number, maxSpeed?: number): DampResult;
+export interface SmoothFollow3 {
+    readonly position: Vec3Tuple;
+    readonly velocity: Vec3Tuple;
+    step(target: readonly [number, number, number], dt: number): Vec3Tuple;
+    snap(target: readonly [number, number, number]): void;
+}
+export declare function createSmoothFollow3(start: readonly [number, number, number], options: {
+    readonly smoothTime: number;
+    readonly maxSpeed?: number;
+}): SmoothFollow3;
+export declare function lerpAngle(a: number, b: number, t: number): number;
+/** Render-time interpolation between the last two fixed simulation states. */
+export interface RenderInterpolator<T> {
+    push(state: T): void;
+    sample(alpha: number): T | undefined;
+    reset(state?: T): void;
+}
+export declare function createRenderInterpolator<T>(lerp: (a: T, b: T, t: number) => T): RenderInterpolator<T>;
+/** RMS of the second difference of a uniformly sampled series: near 0 for smooth motion, large for jitter. */
+export declare function secondDifferenceRms(samples: readonly number[]): number;
+export interface JitterReport {
+    readonly rms: number;
+    readonly max: number;
+    readonly passed: boolean;
+}
+export declare function jitterReport(samples: readonly number[], threshold: number): JitterReport;
+//# sourceMappingURL=smoothing.d.ts.map

package/dist/game/motion/smoothing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoothing.d.ts","sourceRoot":"","sources":["../../../../../packages/game/src/motion/smoothing.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,+HAA+H;AAC/H,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,EACV,QAAQ,SAA2B,GAClC,UAAU,CAiBZ;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IACvE,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CACvD;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACxC,OAAO,EAAE;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACnE,aAAa,CAqBf;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAMjE;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACrB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACrC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;CACxB;AAED,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAkBrG;AAED,8GAA8G;AAC9G,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAQtE;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CAOxF"}

package/dist/game/motion/smoothing.js

@@ -0,0 +1,92 @@
+/** Critically damped follow (no overshoot, frame-rate independent). `smoothTime` is the time to reach about 95% of the way. */
+export function smoothDamp(current, target, velocity, smoothTime, dt, maxSpeed = Number.POSITIVE_INFINITY) {
+    if (!(dt > 0))
+        return { value: current, velocity };
+    const st = Math.max(1e-4, smoothTime);
+    const omega = 2 / st;
+    const x = omega * dt;
+    const exp = 1 / (1 + x + 0.48 * x * x + 0.235 * x * x * x);
+    const maxChange = maxSpeed * st;
+    const change = Math.max(-maxChange, Math.min(maxChange, current - target));
+    const clampedTarget = current - change;
+    const temp = (velocity + omega * change) * dt;
+    let nextVelocity = (velocity - omega * temp) * exp;
+    let value = clampedTarget + (change + temp) * exp;
+    if (target - current > 0 === value > target) {
+        value = target;
+        nextVelocity = (value - target) / dt;
+    }
+    return { value, velocity: nextVelocity };
+}
+export function createSmoothFollow3(start, options) {
+    const position = [start[0], start[1], start[2]];
+    const velocity = [0, 0, 0];
+    return {
+        position,
+        velocity,
+        step(target, dt) {
+            for (let i = 0; i < 3; i += 1) {
+                const r = smoothDamp(position[i], target[i], velocity[i], options.smoothTime, dt, options.maxSpeed);
+                position[i] = r.value;
+                velocity[i] = r.velocity;
+            }
+            return position;
+        },
+        snap(target) {
+            position[0] = target[0];
+            position[1] = target[1];
+            position[2] = target[2];
+            velocity[0] = velocity[1] = velocity[2] = 0;
+        }
+    };
+}
+export function lerpAngle(a, b, t) {
+    const twoPi = Math.PI * 2;
+    let d = (b - a) % twoPi;
+    if (d > Math.PI)
+        d -= twoPi;
+    else if (d < -Math.PI)
+        d += twoPi;
+    return a + d * t;
+}
+export function createRenderInterpolator(lerp) {
+    let prev;
+    let curr;
+    return {
+        push(state) {
+            prev = curr ?? state;
+            curr = state;
+        },
+        sample(alpha) {
+            if (curr === undefined)
+                return undefined;
+            if (prev === undefined)
+                return curr;
+            return lerp(prev, curr, Math.max(0, Math.min(1, alpha)));
+        },
+        reset(state) {
+            prev = state;
+            curr = state;
+        }
+    };
+}
+/** RMS of the second difference of a uniformly sampled series: near 0 for smooth motion, large for jitter. */
+export function secondDifferenceRms(samples) {
+    if (samples.length < 3)
+        return 0;
+    let sum = 0;
+    for (let i = 2; i < samples.length; i += 1) {
+        const d2 = samples[i] - 2 * samples[i - 1] + samples[i - 2];
+        sum += d2 * d2;
+    }
+    return Math.sqrt(sum / (samples.length - 2));
+}
+export function jitterReport(samples, threshold) {
+    let max = 0;
+    for (let i = 2; i < samples.length; i += 1) {
+        max = Math.max(max, Math.abs(samples[i] - 2 * samples[i - 1] + samples[i - 2]));
+    }
+    const rms = secondDifferenceRms(samples);
+    return { rms, max, passed: rms <= threshold };
+}
+//# sourceMappingURL=smoothing.js.map

package/dist/game/motion/smoothing.js.map

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

package/dist/game/session/warmPrograms.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Settle every shader program the first frames need before the game shows its first frame.
+ *
+ * Programs compile asynchronously and a draw whose program is still compiling is skipped, so a game that renders
+ * straight after `await app.ready()` shows a partial scene (a missing road, missing buildings) for as long as the
+ * compile takes: seconds on a slow or busy GPU. `ready()` settles the mount; this settles the programs.
+ *
+ *  1. `precompile()` settles the programs predicted from the mounted scene.
+ *  2. A frame is stepped so the renderer kicks the exact feature records (shadows, fog, image-based lighting).
+ *  3. `precompile()` again settles any record that differed from the prediction.
+ *  4. Frames are stepped until the draw-call count is the same on `stableFrames` frames in a row, because which
+ *     variants an item needs depends on its state relative to the camera and only shows once it is drawn.
+ *  5. A requested environment HDRI that is still loading is waited for (bounded), and steps 3 and 4 run again:
+ *     when the HDRI lands, every material switches to its image-based-lighting program variant at once, which
+ *     recompiles the whole scene and drops frames after the game believed it was settled.
+ *
+ * Call it again after a large jump (a teleport) before capturing a frame.
+ */
+export interface WarmableApp {
+    precompile?(): Promise<unknown>;
+    step(dt?: number): unknown;
+    diagnostics?(): {
+        readonly drawCalls?: number;
+        readonly renderer?: {
+            readonly environment?: {
+                readonly hdriStatus?: string;
+            };
+        };
+    };
+}
+export interface WarmProgramsOptions {
+    /** Warm frames stepped between the two precompile passes. Default 1. */
+    readonly frames?: number;
+    /** Consecutive frames with the same draw-call count that count as settled. Default 3. Needs `app.diagnostics`. */
+    readonly stableFrames?: number;
+    /** Upper bound on the extra frames stepped while waiting for the draw-call count to settle. Default 12. */
+    readonly maxFrames?: number;
+    /** Wait for a requested environment HDRI (`renderer.environment.hdriStatus === "pending"`) before settling. Default true. Needs `app.diagnostics`. */
+    readonly waitForEnvironment?: boolean;
+    /** Upper bound on that wait, in milliseconds. Default 20000. */
+    readonly environmentTimeoutMs?: number;
+}
+export interface WarmProgramsResult {
+    /** Precompile passes that ran (0 when the app has no `precompile`). */
+    readonly passes: number;
+    readonly frames: number;
+    /** Extra frames stepped while the draw-call count settled. */
+    readonly settleFrames: number;
+    /** True when the draw-call count was stable on `stableFrames` frames in a row (always true without diagnostics). */
+    readonly settled: boolean;
+    /** Frames stepped while waiting for the environment HDRI (0 when none was pending). */
+    readonly environmentFrames: number;
+    /** False only when an HDRI was still pending when the wait timed out. */
+    readonly environmentReady: boolean;
+    readonly durationMs: number;
+}
+export declare function warmPrograms(app: WarmableApp, options?: WarmProgramsOptions): Promise<WarmProgramsResult>;
+//# sourceMappingURL=warmPrograms.d.ts.map

package/dist/game/session/warmPrograms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warmPrograms.d.ts","sourceRoot":"","sources":["../../../../../packages/game/src/session/warmPrograms.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,WAAW,CAAC,IAAI;QAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;YAAE,QAAQ,CAAC,WAAW,CAAC,EAAE;gBAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAA;KAAE,CAAC;CAClI;AAED,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,kHAAkH;IAClH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,2GAA2G;IAC3G,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,sJAAsJ;IACtJ,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,gEAAgE;IAChE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,oHAAoH;IACpH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,uFAAuF;IACvF,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,yEAAyE;IACzE,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAID,wBAAsB,YAAY,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAwDnH"}