@aura3d/engine 4.2.0 → 4.3.0

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

@@ -0,0 +1,206 @@
+export type HandBounceVec3 = readonly [number, number, number];
+export interface HandBounceGait {
+    /** Seconds per bounce. */
+    readonly period: number;
+    /** Palm height above the floor at the meet (top of the bounce). */
+    readonly palmTop: number;
+    /** Palm height above the floor at the push (lowest the hand is asked to reach). */
+    readonly palmPush: number;
+}
+export interface HandBounceOptions {
+    /** Which hand bounces the ball. Mirrors the overlay's bone roles. Default "right". */
+    readonly hand?: "left" | "right";
+    /** Default 0.13 (a basketball). The ball centre is on the floor plus this radius at the bounce. */
+    readonly ballRadius?: number;
+    /** World Y of the floor. Palm heights are relative to it. Default 0. */
+    readonly floorY?: number;
+    /** How far below the shoulder the arm alone can reach. Palm targets are clamped to it. Default 0.55. */
+    readonly armReach?: number;
+    /** Palm centroid rides this far above the ball crown while in contact. Default 0.09. */
+    readonly ballGap?: number;
+    /** Standing profile; defaults are the Aura Hoops numbers (0.46 s, palm 1.02 to 0.62 m). */
+    readonly standing?: Partial<HandBounceGait>;
+    /** Running profile (lower apex, shorter period); defaults 0.30 s, palm 0.92 to 0.60 m. */
+    readonly running?: Partial<HandBounceGait>;
+    /** Horizontal speed (m/s) above which the running profile applies. Default 0.45. */
+    readonly runSpeed?: number;
+    /** Skeleton bone names; the overlay then names the bones that actually exist. */
+    readonly boneNames?: readonly string[];
+    /** Phase landmarks of one bounce (0 = palm meets ball at the top). */
+    readonly phases?: Partial<HandBouncePhases>;
+}
+export interface HandBouncePhases {
+    /** Palm and ball ride together down to here. Default 0.35. */
+    readonly rideEnd: number;
+    /** The palm turns around here while the ball keeps going down. Default 0.60. */
+    readonly palmTurn: number;
+    /** The ball meets the floor here. Default 0.66. */
+    readonly floorAt: number;
+    /** The palm is back on the ball and carries it again from here. Default 0.92. */
+    readonly catchFrom: number;
+}
+export interface HandBounceConfig {
+    readonly hand: "left" | "right";
+    readonly ballRadius: number;
+    readonly floorY: number;
+    readonly armReach: number;
+    readonly ballGap: number;
+    readonly standing: HandBounceGait;
+    readonly running: HandBounceGait;
+    readonly runSpeed: number;
+    readonly phases: HandBouncePhases;
+    /** Ball centre height at the floor contact. */
+    readonly floorBallY: number;
+}
+export interface HandBounceCycle {
+    /** Palm target height (world Y). */
+    readonly palmY: number;
+    /** Ball centre height following the cycle (before it is retargeted to the rendered palm). */
+    readonly ballY: number;
+    /** 0 to 1: how hard the body works into the push (crouch for a standing handler, waist bend for a runner). */
+    readonly effort: number;
+}
+export declare function resolveHandBounceConfig(options?: HandBounceOptions): HandBounceConfig;
+/** Palm height, ball height and body effort for phase `t` (0..1). `shoulderY` is the live world Y of the dribbling shoulder. */
+export declare function handBounceCycle(config: HandBounceConfig, t: number, shoulderY: number, moving?: boolean): HandBounceCycle;
+/**
+ * Ball centre height for phase `t`. `palmY` is the palm the ball rides while in contact (pass the RENDERED palm so the ball
+ * cannot leave a hand that could not follow its target); `releaseY` is the ball height when it leaves the palm and `catchY`
+ * the height of the palm that receives it. In the air the ball falls to the floor and rebounds, so the bounce point is always
+ * `config.floorBallY`.
+ */
+export declare function handBounceBallY(config: HandBounceConfig, t: number, palmY: number, releaseY: number, catchY: number): number;
+/**
+ * 1 while the palm is on the ball (riding down, and the catch at the top), 0 while the ball is free in the air. Anything that
+ * offsets the ball from the palm (stride lead, outward nudge) is scaled by `1 - weight`, so the ball is glued to the palm at the
+ * contact points however fast the handler runs.
+ */
+export declare function handBounceContactWeight(config: HandBounceConfig, phase: number): number;
+/** Horizontal ball position: on the palm at contact, drifting ahead with the handler's stride only while the ball is in the air. */
+export declare function handBounceBallXZ(config: HandBounceConfig, palm: HandBounceVec3, holder: {
+    readonly x: number;
+    readonly z: number;
+    readonly vx: number;
+    readonly vz: number;
+}, phase: number): {
+    x: number;
+    z: number;
+};
+/** Clamp a palm target into the arm's reach sphere around the shoulder (a target the arm cannot reach makes the hand miss the ball). */
+export declare function clampPalmReach(shoulder: HandBounceVec3, target: HandBounceVec3, reach: number): [number, number, number];
+/** Upper-body pitch angles (radians, forward positive) for a handler bouncing the ball: stationary handlers crouch into the push, runners bend at the waist. */
+export declare function handBounceOverlayAngles(effort: number, moving: boolean, leanScale?: number): {
+    spine: number;
+    chest: number;
+    head: number;
+};
+export interface HandBounceOverlayBone {
+    /** Pitch about the actor's local X (radians, positive bends forward over the ball). */
+    readonly pitch: number;
+}
+export interface HandBounceOverlay {
+    /** "overlay" for a runner (apply on top of the locomotion clip), "pose" for a stationary handler (replace the pose). */
+    readonly mode: "overlay" | "pose";
+    /** Upper-body bones only. Leg, hip and foot bones are never named, so the clip keeps owning the stride. */
+    readonly bones: Readonly<Record<string, HandBounceOverlayBone>>;
+    readonly effort: number;
+    /** Bone names for the dribbling arm (resolved against `boneNames` when given) for the game's arm solver. */
+    readonly arm: {
+        readonly upper: string;
+        readonly forearm: string;
+    };
+}
+export interface HandBounceInput {
+    /** Horizontal speed in m/s or an explicit flag. */
+    readonly moving?: boolean;
+    readonly speed?: number;
+    /** World Y of the dribbling shoulder (live from the rig). */
+    readonly shoulderY: number;
+    /** The palm as rendered this frame, if the rig is live; the ball rides it. Without it the cycle's palm height is used. */
+    readonly palm?: HandBounceVec3;
+    readonly holder: {
+        readonly x: number;
+        readonly z: number;
+        readonly vx: number;
+        readonly vz: number;
+    };
+    /** Dead ball (check, inbound): phase is held at the meet and the ball sits in the palm. */
+    readonly hold?: boolean;
+}
+export interface HandBounceFrame {
+    readonly phase: number;
+    readonly moving: boolean;
+    readonly contact: number;
+    readonly effort: number;
+    readonly palmY: number;
+    readonly ball: [number, number, number];
+    readonly floorContact: boolean;
+}
+export interface HandBounceState {
+    readonly phase: number;
+    readonly moving: boolean;
+    readonly contact: number;
+    readonly effort: number;
+    readonly palmY: number;
+    readonly ball: readonly [number, number, number];
+    readonly releaseY: number;
+    readonly floorContact: boolean;
+    readonly active: boolean;
+}
+export interface HandBounceRelease {
+    readonly position: [number, number, number];
+    /** Finite-difference velocity of the ball at the hand: hand it to the pass or shot so the ball leaves without a pop. */
+    readonly velocity: [number, number, number];
+}
+export interface HandBounce {
+    readonly config: HandBounceConfig;
+    /** Advance one fixed step (dt > 0, no wall clock) and place the ball. */
+    step(dt: number, input: HandBounceInput): HandBounceFrame;
+    state(): HandBounceState;
+    /** Palm-free recipe for the body: waist bend, shoulder drop, head. Call after step(). */
+    overlay(leanScale?: number): HandBounceOverlay;
+    /** Leave the hand: current position and velocity for a pass, shot or drop. Stops the cycle. */
+    release(): HandBounceRelease;
+    /** Take a loose ball: the cycle resumes at the catch so the palm receives the ball where it is. */
+    pickup(ball: HandBounceVec3): void;
+    reset(): void;
+}
+export declare function createHandBounce(options?: HandBounceOptions): HandBounce;
+export interface HandBounceSample {
+    readonly phase: number;
+    readonly palm: HandBounceVec3;
+    readonly ball: HandBounceVec3;
+    /** False when the ball is not in dribble state (loose, shot, pass): such samples are skipped. */
+    readonly dribbling?: boolean;
+}
+export interface HandBounceReport {
+    readonly samples: number;
+    /** Max palm-to-ball distance at the meet and the catch (m). */
+    readonly meetMax: number;
+    /** Max palm-to-ball distance at the floor contact (m); NaN when no sample touched the floor. */
+    readonly floorContactMax: number;
+    /** Highest palm height at the floor contact (m above the floor). */
+    readonly floorContactPalmHeightMax: number;
+    /** Lowest ball centre minus the ball radius over the floor: 0 when the ball bounces exactly on the floor. */
+    readonly floorError: number;
+    /** Max palm-to-ball distance over every dribble sample. */
+    readonly maxDistance: number;
+    readonly floorSamples: number;
+    readonly meetSamples: number;
+}
+export interface HandBounceLimits {
+    readonly meet: number;
+    readonly floorContact: number;
+    readonly floorError: number;
+    readonly maxDistance: number;
+}
+/** Limits the Aura Hoops dribble is held to. */
+export declare const DEFAULT_HAND_BOUNCE_LIMITS: HandBounceLimits;
+/** Probe: feed per-frame palm and ball world positions of a dribble; returns the distances the game must keep small. Call it from QA hooks and tools/game-checks. */
+export declare function measureHandBall(samples: readonly HandBounceSample[], options?: HandBounceOptions & {
+    readonly limits?: Partial<HandBounceLimits>;
+}): HandBounceReport & {
+    readonly ok: boolean;
+    readonly failures: readonly string[];
+};
+//# sourceMappingURL=handBounce.d.ts.map

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

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

package/dist/game/motion/handBounce.js

@@ -0,0 +1,267 @@
+import { resolveBone } from "./boneAttach.js";
+const lerp = (a, b, t) => a + (b - a) * t;
+const smoothstep = (t) => (t <= 0 ? 0 : t >= 1 ? 1 : t * t * (3 - 2 * t));
+export function resolveHandBounceConfig(options = {}) {
+    const ballRadius = options.ballRadius ?? 0.13;
+    const floorY = options.floorY ?? 0;
+    return {
+        hand: options.hand ?? "right",
+        ballRadius,
+        floorY,
+        armReach: options.armReach ?? 0.55,
+        ballGap: options.ballGap ?? 0.09,
+        standing: { period: 0.46, palmTop: 1.02, palmPush: 0.62, ...options.standing },
+        running: { period: 0.3, palmTop: 0.92, palmPush: 0.6, ...options.running },
+        runSpeed: options.runSpeed ?? 0.45,
+        phases: { rideEnd: 0.35, palmTurn: 0.6, floorAt: 0.66, catchFrom: 0.92, ...options.phases },
+        floorBallY: floorY + ballRadius
+    };
+}
+/** Palm height, ball height and body effort for phase `t` (0..1). `shoulderY` is the live world Y of the dribbling shoulder. */
+export function handBounceCycle(config, t, shoulderY, moving = false) {
+    const gait = moving ? config.running : config.standing;
+    const { rideEnd, palmTurn, floorAt } = config.phases;
+    const top = Math.min(config.floorY + gait.palmTop, shoulderY - 0.3);
+    const push = Math.max(config.floorY + gait.palmPush, shoulderY - config.armReach);
+    const low = push - 0.04;
+    let palmY;
+    let effort;
+    if (t < rideEnd) {
+        const s = t / rideEnd;
+        effort = Math.pow(s, 1.6);
+        palmY = lerp(top, push, effort);
+    }
+    else if (t < palmTurn) {
+        const s = (t - rideEnd) / (palmTurn - rideEnd);
+        effort = 1;
+        palmY = lerp(push, low, 1 - (1 - s) * (1 - s));
+    }
+    else {
+        const s = (t - palmTurn) / (1 - palmTurn);
+        effort = t < floorAt ? 1 : 1 - smoothstep((t - floorAt) / (1 - floorAt));
+        palmY = lerp(low, top, smoothstep(s));
+    }
+    return { palmY, ballY: handBounceBallY(config, t, palmY, push - config.ballGap, top - config.ballGap), effort };
+}
+/**
+ * Ball centre height for phase `t`. `palmY` is the palm the ball rides while in contact (pass the RENDERED palm so the ball
+ * cannot leave a hand that could not follow its target); `releaseY` is the ball height when it leaves the palm and `catchY`
+ * the height of the palm that receives it. In the air the ball falls to the floor and rebounds, so the bounce point is always
+ * `config.floorBallY`.
+ */
+export function handBounceBallY(config, t, palmY, releaseY, catchY) {
+    const { rideEnd, floorAt, catchFrom } = config.phases;
+    if (t < rideEnd)
+        return palmY - config.ballGap;
+    if (t < floorAt) {
+        const s = (t - rideEnd) / (floorAt - rideEnd);
+        return lerp(releaseY, config.floorBallY, Math.pow(s, 1.2));
+    }
+    if (t >= catchFrom)
+        return palmY - config.ballGap;
+    const s = (t - floorAt) / (catchFrom - floorAt);
+    return lerp(config.floorBallY, catchY, 1 - Math.pow(1 - s, 1.7));
+}
+/**
+ * 1 while the palm is on the ball (riding down, and the catch at the top), 0 while the ball is free in the air. Anything that
+ * offsets the ball from the palm (stride lead, outward nudge) is scaled by `1 - weight`, so the ball is glued to the palm at the
+ * contact points however fast the handler runs.
+ */
+export function handBounceContactWeight(config, phase) {
+    const { rideEnd, floorAt, catchFrom } = config.phases;
+    const t = ((phase % 1) + 1) % 1;
+    if (t < rideEnd)
+        return 1;
+    if (t < floorAt)
+        return 1 - smoothstep((t - rideEnd) / 0.1);
+    if (t < catchFrom)
+        return smoothstep((t - floorAt - 0.1) / (catchFrom - floorAt - 0.1));
+    return 1;
+}
+/** Horizontal ball position: on the palm at contact, drifting ahead with the handler's stride only while the ball is in the air. */
+export function handBounceBallXZ(config, palm, holder, phase) {
+    const free = 1 - handBounceContactWeight(config, phase);
+    const ox = palm[0] - holder.x;
+    const oz = palm[2] - holder.z;
+    const olen = Math.hypot(ox, oz) || 1;
+    return {
+        x: palm[0] + (ox / olen) * 0.02 * free + holder.vx * 0.04 * free,
+        z: palm[2] + (oz / olen) * 0.02 * free + holder.vz * 0.04 * free
+    };
+}
+/** Clamp a palm target into the arm's reach sphere around the shoulder (a target the arm cannot reach makes the hand miss the ball). */
+export function clampPalmReach(shoulder, target, reach) {
+    const dx = target[0] - shoulder[0];
+    const dy = target[1] - shoulder[1];
+    const dz = target[2] - shoulder[2];
+    const d = Math.hypot(dx, dy, dz);
+    if (d <= reach || d < 1e-9)
+        return [target[0], target[1], target[2]];
+    const k = reach / d;
+    return [shoulder[0] + dx * k, shoulder[1] + dy * k, shoulder[2] + dz * k];
+}
+/** Upper-body pitch angles (radians, forward positive) for a handler bouncing the ball: stationary handlers crouch into the push, runners bend at the waist. */
+export function handBounceOverlayAngles(effort, moving, leanScale = 1) {
+    if (moving) {
+        const lean = (1.28 + 0.77 * effort) * leanScale;
+        return { spine: lean * 0.55, chest: lean * 0.45, head: -lean * 0.6 };
+    }
+    return { spine: (0.2 + 0.3 * effort) * leanScale, chest: (0.12 + 0.2 * effort) * leanScale, head: -0.22 };
+}
+const SIDE_PREFIX = { left: "left", right: "right" };
+export function createHandBounce(options = {}) {
+    const config = resolveHandBounceConfig(options);
+    const side = SIDE_PREFIX[config.hand];
+    const names = options.boneNames;
+    const pick = (role, fallback) => (names ? resolveBone(names, role) ?? fallback : fallback);
+    const spineName = pick("spine", "Spine");
+    const chestName = names ? names.find((n) => /chest/i.test(n) && !/upper/i.test(n)) ?? spineName : "Chest";
+    const headName = pick("head", "Head");
+    const armUpper = pick(`${side}UpperArm`, config.hand === "left" ? "LeftUpperArm" : "RightUpperArm");
+    const armFore = pick(`${side}Forearm`, config.hand === "left" ? "LeftForearm" : "RightForearm");
+    let phase = 0;
+    let moving = false;
+    let releaseY = config.floorBallY + 0.4;
+    let active = false;
+    let contact = 1;
+    let effort = 0;
+    let palmY = config.floorY + config.standing.palmTop;
+    let ball = [0, config.floorBallY, 0];
+    let prevBall;
+    let lastDt = 1 / 60;
+    let floorContact = false;
+    const frame = () => ({ phase, moving, contact, effort, palmY, ball: [ball[0], ball[1], ball[2]], floorContact });
+    return {
+        config,
+        step(dt, input) {
+            if (!(dt > 0))
+                throw new Error("createHandBounce.step: dt must be a positive fixed step");
+            moving = input.moving ?? (input.speed ?? 0) > config.runSpeed;
+            const gait = moving ? config.running : config.standing;
+            if (!active) {
+                active = true;
+                phase = 0;
+                prevBall = undefined;
+            }
+            phase = input.hold ? 0 : (phase + dt / gait.period) % 1;
+            const cyc = handBounceCycle(config, phase, input.shoulderY, moving);
+            effort = input.hold ? 0 : cyc.effort;
+            contact = handBounceContactWeight(config, phase);
+            prevBall = [ball[0], ball[1], ball[2]];
+            lastDt = dt;
+            if (input.palm) {
+                const palm = input.palm;
+                if (input.hold) {
+                    ball = [palm[0], palm[1], palm[2]];
+                }
+                else {
+                    const at = handBounceBallXZ(config, palm, input.holder, phase);
+                    if (phase < config.phases.rideEnd)
+                        releaseY = palm[1] - config.ballGap;
+                    ball = [at.x, handBounceBallY(config, phase, palm[1], releaseY, palm[1] - config.ballGap), at.z];
+                }
+                palmY = palm[1];
+            }
+            else {
+                palmY = cyc.palmY;
+                ball = [input.holder.x, cyc.ballY, input.holder.z];
+            }
+            floorContact = ball[1] <= config.floorBallY + 0.02;
+            return frame();
+        },
+        state() {
+            return { phase, moving, contact, effort, palmY, ball: [ball[0], ball[1], ball[2]], releaseY, floorContact, active };
+        },
+        overlay(leanScale = 1) {
+            const a = handBounceOverlayAngles(effort, moving, leanScale);
+            return {
+                mode: moving ? "overlay" : "pose",
+                effort,
+                bones: { [spineName]: { pitch: a.spine }, [chestName]: { pitch: a.chest }, [headName]: { pitch: a.head } },
+                arm: { upper: armUpper, forearm: armFore }
+            };
+        },
+        release() {
+            const dt = Math.max(lastDt, 1e-6);
+            const p = prevBall ?? ball;
+            active = false;
+            return {
+                position: [ball[0], ball[1], ball[2]],
+                velocity: [(ball[0] - p[0]) / dt, (ball[1] - p[1]) / dt, (ball[2] - p[2]) / dt]
+            };
+        },
+        pickup(at) {
+            active = true;
+            phase = config.phases.catchFrom;
+            releaseY = at[1];
+            ball = [at[0], at[1], at[2]];
+            prevBall = undefined;
+        },
+        reset() {
+            phase = 0;
+            active = false;
+            moving = false;
+            prevBall = undefined;
+            ball = [0, config.floorBallY, 0];
+        }
+    };
+}
+/** Limits the Aura Hoops dribble is held to. */
+export const DEFAULT_HAND_BOUNCE_LIMITS = { meet: 0.12, floorContact: 0.55, floorError: 0.02, maxDistance: 0.9 };
+/** Probe: feed per-frame palm and ball world positions of a dribble; returns the distances the game must keep small. Call it from QA hooks and tools/game-checks. */
+export function measureHandBall(samples, options = {}) {
+    const config = resolveHandBounceConfig(options);
+    const limits = { ...DEFAULT_HAND_BOUNCE_LIMITS, ...options.limits };
+    let meetMax = 0;
+    let floorMax = Number.NaN;
+    let floorPalm = Number.NaN;
+    let maxDistance = 0;
+    let lowest = Infinity;
+    let floorSamples = 0;
+    let meetSamples = 0;
+    let used = 0;
+    for (const s of samples) {
+        if (s.dribbling === false)
+            continue;
+        used += 1;
+        const d = Math.hypot(s.palm[0] - s.ball[0], s.palm[1] - s.ball[1], s.palm[2] - s.ball[2]);
+        maxDistance = Math.max(maxDistance, d);
+        lowest = Math.min(lowest, s.ball[1]);
+        const t = ((s.phase % 1) + 1) % 1;
+        if (t < 0.04 || t > config.phases.catchFrom + 0.01) {
+            meetMax = Math.max(meetMax, d);
+            meetSamples += 1;
+        }
+        if (s.ball[1] <= config.floorBallY + 0.02) {
+            floorMax = Number.isNaN(floorMax) ? d : Math.max(floorMax, d);
+            const h = s.palm[1] - config.floorY;
+            floorPalm = Number.isNaN(floorPalm) ? h : Math.max(floorPalm, h);
+            floorSamples += 1;
+        }
+    }
+    const floorError = used === 0 ? Number.NaN : Math.abs(lowest - config.floorBallY);
+    const failures = [];
+    if (used === 0)
+        failures.push("no dribble samples");
+    if (meetSamples > 0 && meetMax > limits.meet)
+        failures.push(`palm to ball at the meet ${meetMax.toFixed(3)} m > ${limits.meet} m`);
+    if (floorSamples > 0 && floorMax > limits.floorContact)
+        failures.push(`palm to ball at the floor contact ${floorMax.toFixed(3)} m > ${limits.floorContact} m`);
+    if (used > 0 && floorError > limits.floorError)
+        failures.push(`ball centre misses the floor by ${floorError.toFixed(3)} m > ${limits.floorError} m`);
+    if (maxDistance > limits.maxDistance)
+        failures.push(`ball strays ${maxDistance.toFixed(3)} m from the hand > ${limits.maxDistance} m`);
+    return {
+        samples: used,
+        meetMax,
+        floorContactMax: floorMax,
+        floorContactPalmHeightMax: floorPalm,
+        floorError,
+        maxDistance,
+        floorSamples,
+        meetSamples,
+        ok: failures.length === 0,
+        failures
+    };
+}
+//# sourceMappingURL=handBounce.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handBounce.js","sourceRoot":"","sources":["../../../../../packages/game/src/motion/handBounce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAsE3C,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAU,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;AAC1E,MAAM,UAAU,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAE1F,MAAM,UAAU,uBAAuB,CAAC,UAA6B,EAAE;IACrE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;IAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;IACnC,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO;QAC7B,UAAU;QACV,MAAM;QACN,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;QAClC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;QAChC,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE;QAC9E,OAAO,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE;QAC1E,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;QAClC,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE;QAC3F,UAAU,EAAE,MAAM,GAAG,UAAU;KAChC,CAAC;AACJ,CAAC;AAED,gIAAgI;AAChI,MAAM,UAAU,eAAe,CAAC,MAAwB,EAAE,CAAS,EAAE,SAAiB,EAAE,MAAM,GAAG,KAAK;IACpG,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACvD,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC;IACrD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,GAAG,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClF,MAAM,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;IACxB,IAAI,KAAa,CAAC;IAClB,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC,GAAG,OAAO,EAAE,CAAC;QAChB,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;QACtB,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC1B,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC;SAAM,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC;QAC/C,MAAM,GAAG,CAAC,CAAC;QACX,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC;QAC1C,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;QACzE,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;AAClH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAwB,EAAE,CAAS,EAAE,KAAa,EAAE,QAAgB,EAAE,MAAc;IAClH,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC;IACtD,IAAI,CAAC,GAAG,OAAO;QAAE,OAAO,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/C,IAAI,CAAC,GAAG,OAAO,EAAE,CAAC;QAChB,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,CAAC,IAAI,SAAS;QAAE,OAAO,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC;IAClD,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;AACnE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAwB,EAAE,KAAa;IAC7E,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC;IACtD,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC,GAAG,OAAO;QAAE,OAAO,CAAC,CAAC;IAC1B,IAAI,CAAC,GAAG,OAAO;QAAE,OAAO,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;IAC5D,IAAI,CAAC,GAAG,SAAS;QAAE,OAAO,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,SAAS,GAAG,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC;IACxF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,oIAAoI;AACpI,MAAM,UAAU,gBAAgB,CAC9B,MAAwB,EACxB,IAAoB,EACpB,MAA4F,EAC5F,KAAa;IAEb,MAAM,IAAI,GAAG,CAAC,GAAG,uBAAuB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACxD,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAC9B,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO;QACL,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC,EAAE,GAAG,IAAI,GAAG,IAAI;QAChE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC,EAAE,GAAG,IAAI,GAAG,IAAI;KACjE,CAAC;AACJ,CAAC;AAED,wIAAwI;AACxI,MAAM,UAAU,cAAc,CAAC,QAAwB,EAAE,MAAsB,EAAE,KAAa;IAC5F,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,GAAG,IAAI;QAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,MAAM,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,gKAAgK;AAChK,MAAM,UAAU,uBAAuB,CAAC,MAAc,EAAE,MAAe,EAAE,SAAS,GAAG,CAAC;IACpF,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,IAAI,GAAG,CAAC,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC,GAAG,SAAS,CAAC;QAChD,OAAO,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC;IACvE,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC,GAAG,SAAS,EAAE,KAAK,EAAE,CAAC,IAAI,GAAG,GAAG,GAAG,MAAM,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;AAC5G,CAAC;AAwED,MAAM,WAAW,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAW,CAAC;AAE9D,MAAM,UAAU,gBAAgB,CAAC,UAA6B,EAAE;IAC9D,MAAM,MAAM,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC;IAChC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,QAAgB,EAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACnH,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;IAC1G,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,IAAI,UAAU,EAAE,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IACpG,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,IAAI,SAAS,EAAE,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;IAEhG,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,QAAQ,GAAG,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC;IACvC,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;IACpD,IAAI,IAAI,GAA6B,CAAC,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAC/D,IAAI,QAA8C,CAAC;IACnD,IAAI,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC;IACpB,IAAI,YAAY,GAAG,KAAK,CAAC;IAEzB,MAAM,KAAK,GAAG,GAAoB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;IAElI,OAAO;QACL,MAAM;QACN,IAAI,CAAC,EAAE,EAAE,KAAK;YACZ,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;YAC1F,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;YAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;YACvD,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,GAAG,IAAI,CAAC;gBACd,KAAK,GAAG,CAAC,CAAC;gBACV,QAAQ,GAAG,SAAS,CAAC;YACvB,CAAC;YACD,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACxD,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACpE,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;YACrC,OAAO,GAAG,uBAAuB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACjD,QAAQ,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACvC,MAAM,GAAG,EAAE,CAAC;YACZ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBACf,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;gBACxB,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;oBACf,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrC,CAAC;qBAAM,CAAC;oBACN,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;oBAC/D,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO;wBAAE,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;oBACvE,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;gBACnG,CAAC;gBACD,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACN,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;gBAClB,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACrD,CAAC;YACD,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC;YACnD,OAAO,KAAK,EAAE,CAAC;QACjB,CAAC;QACD,KAAK;YACH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;QACtH,CAAC;QACD,OAAO,CAAC,SAAS,GAAG,CAAC;YACnB,MAAM,CAAC,GAAG,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;YAC7D,OAAO;gBACL,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;gBACjC,MAAM;gBACN,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE;gBAC1G,GAAG,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE;aAC3C,CAAC;QACJ,CAAC;QACD,OAAO;YACL,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAClC,MAAM,CAAC,GAAG,QAAQ,IAAI,IAAI,CAAC;YAC3B,MAAM,GAAG,KAAK,CAAC;YACf,OAAO;gBACL,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;gBACrC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;aAChF,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,EAAE;YACP,MAAM,GAAG,IAAI,CAAC;YACd,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;YAChC,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;YACjB,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7B,QAAQ,GAAG,SAAS,CAAC;QACvB,CAAC;QACD,KAAK;YACH,KAAK,GAAG,CAAC,CAAC;YACV,MAAM,GAAG,KAAK,CAAC;YACf,MAAM,GAAG,KAAK,CAAC;YACf,QAAQ,GAAG,SAAS,CAAC;YACrB,IAAI,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC;AAiCD,gDAAgD;AAChD,MAAM,CAAC,MAAM,0BAA0B,GAAqB,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC;AAEnI,qKAAqK;AACrK,MAAM,UAAU,eAAe,CAC7B,OAAoC,EACpC,UAA+E,EAAE;IAEjF,MAAM,MAAM,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,EAAE,GAAG,0BAA0B,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IACpE,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC;IAC1B,IAAI,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC;IAC3B,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,MAAM,GAAG,QAAQ,CAAC;IACtB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,SAAS,KAAK,KAAK;YAAE,SAAS;QACpC,IAAI,IAAI,CAAC,CAAC;QACV,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1F,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACvC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,EAAE,CAAC;YACnD,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC/B,WAAW,IAAI,CAAC,CAAC;QACnB,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,UAAU,GAAG,IAAI,EAAE,CAAC;YAC1C,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;YAC9D,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;YACpC,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;YACjE,YAAY,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAClF,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,IAAI,KAAK,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACpD,IAAI,WAAW,GAAG,CAAC,IAAI,OAAO,GAAG,MAAM,CAAC,IAAI;QAAE,QAAQ,CAAC,IAAI,CAAC,4BAA4B,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC;IACnI,IAAI,YAAY,GAAG,CAAC,IAAI,QAAQ,GAAG,MAAM,CAAC,YAAY;QAAE,QAAQ,CAAC,IAAI,CAAC,qCAAqC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC;IAC/J,IAAI,IAAI,GAAG,CAAC,IAAI,UAAU,GAAG,MAAM,CAAC,UAAU;QAAE,QAAQ,CAAC,IAAI,CAAC,mCAAmC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC;IACrJ,IAAI,WAAW,GAAG,MAAM,CAAC,WAAW;QAAE,QAAQ,CAAC,IAAI,CAAC,eAAe,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC;IACvI,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO;QACP,eAAe,EAAE,QAAQ;QACzB,yBAAyB,EAAE,SAAS;QACpC,UAAU;QACV,WAAW;QACX,YAAY;QACZ,WAAW;QACX,EAAE,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC;QACzB,QAAQ;KACT,CAAC;AACJ,CAAC"}

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

@@ -16,4 +16,6 @@ export { runMotionGate } from "./motionGate.js";
 export type { MotionGateOptions, MotionGateReport } from "./motionGate.js";
 export { clearCameraEye, createCameraClearance } from "./cameraClear.js";
 export type { CameraVec3, ClearEyeOptions, ClearEye, CameraClearanceOptions, CameraClearance } from "./cameraClear.js";
+export { createHandBounce, resolveHandBounceConfig, handBounceCycle, handBounceBallY, handBounceContactWeight, handBounceBallXZ, clampPalmReach, handBounceOverlayAngles, measureHandBall, DEFAULT_HAND_BOUNCE_LIMITS } from "./handBounce.js";
+export type { HandBounceVec3, HandBounceGait, HandBounceOptions, HandBouncePhases, HandBounceConfig, HandBounceCycle, HandBounceOverlayBone, HandBounceOverlay, HandBounceInput, HandBounceFrame, HandBounceState, HandBounceRelease, HandBounce, HandBounceSample, HandBounceReport, HandBounceLimits } from "./handBounce.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/game/src/motion/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,SAAS,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACtI,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/F,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5H,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACrG,YAAY,EACV,iBAAiB,EAAE,oBAAoB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,kBAAkB,EAAE,WAAW,EAC5G,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,qBAAqB,EAAE,oBAAoB,EACjF,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC7G,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/G,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClH,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAChH,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC1E,YAAY,EAAE,WAAW,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAClH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,QAAQ,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/game/src/motion/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,SAAS,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACtI,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/F,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5H,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACrG,YAAY,EACV,iBAAiB,EAAE,oBAAoB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,kBAAkB,EAAE,WAAW,EAC5G,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,qBAAqB,EAAE,oBAAoB,EACjF,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC7G,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/G,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClH,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAChH,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC1E,YAAY,EAAE,WAAW,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAClH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,QAAQ,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACpH,OAAO,EACL,gBAAgB,EAAE,uBAAuB,EAAE,eAAe,EAAE,eAAe,EAAE,uBAAuB,EAAE,gBAAgB,EACtH,cAAc,EAAE,uBAAuB,EAAE,eAAe,EAAE,0BAA0B,EACrF,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,qBAAqB,EAC7H,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,UAAU,EAAE,gBAAgB,EACrH,gBAAgB,EAAE,gBAAgB,EACnC,MAAM,cAAc,CAAC"}

package/dist/game/motion/index.js

@@ -7,4 +7,5 @@ export { checkDoubleFrame, detectSharedSkeleton, detectCoincidentModels, detectD
 export { createFixedStepPresenter, createRecordBlend } from "./presenter.js";
 export { runMotionGate } from "./motionGate.js";
 export { clearCameraEye, createCameraClearance } from "./cameraClear.js";
+export { createHandBounce, resolveHandBounceConfig, handBounceCycle, handBounceBallY, handBounceContactWeight, handBounceBallXZ, clampPalmReach, handBounceOverlayAngles, measureHandBall, DEFAULT_HAND_BOUNCE_LIMITS } from "./handBounce.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/game/src/motion/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,SAAS,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEtI,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAKrG,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAE7G,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElH,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/game/src/motion/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,SAAS,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEtI,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAKrG,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAE7G,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElH,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtE,OAAO,EACL,gBAAgB,EAAE,uBAAuB,EAAE,eAAe,EAAE,eAAe,EAAE,uBAAuB,EAAE,gBAAgB,EACtH,cAAc,EAAE,uBAAuB,EAAE,eAAe,EAAE,0BAA0B,EACrF,MAAM,cAAc,CAAC"}

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

@@ -13,6 +13,10 @@
  *  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.
+ *  6. Textures upgrade one material at a time after mount (`renderer.runtime.texturedMaterials`, status `pending` until the
+ *     upload lands). A material that gains its texture switches to a textured program variant, which compiles
+ *     asynchronously too, so the ground, the road or a facade can drop out for frames after the game believed it was
+ *     settled. Pending upgrades are waited for (bounded) and steps 3 and 4 run again.
  *
  * Call it again after a large jump (a teleport) before capturing a frame.
  */
@@ -25,6 +29,11 @@ export interface WarmableApp {
             readonly environment?: {
                 readonly hdriStatus?: string;
             };
+            readonly runtime?: {
+                readonly texturedMaterials?: readonly {
+                    readonly status?: string;
+                }[];
+            };
         };
     };
 }
@@ -39,6 +48,10 @@ export interface WarmProgramsOptions {
     readonly waitForEnvironment?: boolean;
     /** Upper bound on that wait, in milliseconds. Default 20000. */
     readonly environmentTimeoutMs?: number;
+    /** Wait for materials whose texture upgrade is still `pending` (`renderer.runtime.texturedMaterials`) before settling. Default true. Needs `app.diagnostics`. */
+    readonly waitForTextures?: boolean;
+    /** Upper bound on that wait, in milliseconds. Default 20000. */
+    readonly textureTimeoutMs?: number;
 }
 export interface WarmProgramsResult {
     /** Precompile passes that ran (0 when the app has no `precompile`). */
@@ -52,6 +65,10 @@ export interface WarmProgramsResult {
     readonly environmentFrames: number;
     /** False only when an HDRI was still pending when the wait timed out. */
     readonly environmentReady: boolean;
+    /** Frames stepped while waiting for pending texture upgrades (0 when none was pending). */
+    readonly textureFrames: number;
+    /** False only when an upgrade was still pending when the wait timed out. */
+    readonly texturesReady: boolean;
     readonly durationMs: number;
 }
 export declare function warmPrograms(app: WarmableApp, options?: WarmProgramsOptions): Promise<WarmProgramsResult>;

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

@@ -1 +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"}
+{"version":3,"file":"warmPrograms.d.ts","sourceRoot":"","sources":["../../../../../packages/game/src/session/warmPrograms.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;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;QACd,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE;YAClB,QAAQ,CAAC,WAAW,CAAC,EAAE;gBAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC;YACxD,QAAQ,CAAC,OAAO,CAAC,EAAE;gBAAE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS;oBAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;iBAAE,EAAE,CAAA;aAAE,CAAC;SAC7F,CAAC;KACH,CAAC;CACH;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;IACvC,iKAAiK;IACjK,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,gEAAgE;IAChE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;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,2FAA2F;IAC3F,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,4EAA4E;IAC5E,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAID,wBAAsB,YAAY,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAyEnH"}

package/dist/game/session/warmPrograms.js

@@ -58,6 +58,23 @@ export async function warmPrograms(app, options = {}) {
         }
         await settleCounts();
     }
-    return { passes, frames, settleFrames, settled, environmentFrames, environmentReady, durationMs: now() - startedAt };
+    let textureFrames = 0;
+    const texturesPending = () => (app.diagnostics?.().renderer?.runtime?.texturedMaterials ?? []).some((row) => row.status === "pending");
+    let texturesReady = true;
+    if (options.waitForTextures !== false && typeof app.diagnostics === "function" && texturesPending()) {
+        const deadline = now() + Math.max(0, options.textureTimeoutMs ?? 20_000);
+        while (texturesPending() && now() < deadline) {
+            await new Promise((resolve) => setTimeout(resolve, 40));
+            app.step(0);
+            textureFrames += 1;
+        }
+        texturesReady = !texturesPending();
+        if (typeof app.precompile === "function") {
+            await app.precompile();
+            passes += 1;
+        }
+        await settleCounts();
+    }
+    return { passes, frames, settleFrames, settled, environmentFrames, environmentReady, textureFrames, texturesReady, durationMs: now() - startedAt };
 }
 //# sourceMappingURL=warmPrograms.js.map