@aura3d/engine 4.0.8 → 4.1.1

package/dist/engine/agent-api/game-kits/racketAthleteRig.js

@@ -0,0 +1,178 @@
+import { directionToEulerXYZ, localDirToWorld, localToWorld, orientCylinderBetween, solveArmElbow } from "./racketGeometry.js";
+const TAU = Math.PI * 2;
+const clamp = (x, a, b) => Math.max(a, Math.min(b, x));
+const mix = (a, b, t) => a + (b - a) * t;
+const smooth = (t) => {
+    t = clamp(t, 0, 1);
+    return t * t * (3 - 2 * t);
+};
+/** Two-bone knee position: bends toward the athlete's forward (-z) over a 0.48 thigh. */
+export function solveKnee(hip, foot) {
+    const delta = [foot[0] - hip[0], foot[1] - hip[1], foot[2] - hip[2]];
+    const d = Math.max(0.001, Math.hypot(delta[0], delta[1], delta[2]));
+    const dir = delta.map((v) => v / d);
+    const forward = [0, 0, -1];
+    const dot = dir[2] * -1;
+    const bend = forward.map((v, i) => v - dir[i] * dot);
+    const length = Math.hypot(bend[0], bend[1], bend[2]) || 1;
+    const height = Math.sqrt(Math.max(0.001, 0.48 ** 2 - (Math.min(0.95, d) / 2) ** 2));
+    return [
+        hip[0] + delta[0] * 0.5 + (bend[0] / length) * height,
+        hip[1] + delta[1] * 0.5 + (bend[1] / length) * height,
+        hip[2] + delta[2] * 0.5 + (bend[2] / length) * height
+    ];
+}
+export function athleteLocomotion(player, options = {}) {
+    const unitsX = options.unitsX ?? 5.5;
+    const unitsY = options.unitsY ?? 8;
+    const move = clamp(player.moveBlend, 0, 1);
+    const phase = player.stride;
+    const face = player.side === "player" ? 1 : -1;
+    const speed = Math.hypot(player.vx * unitsX, player.vy * unitsY);
+    const dx = speed > 0.01 ? ((player.vx * unitsX) / speed) * face : 0;
+    const dz = speed > 0.01 ? ((player.vy * unitsY) / speed) * face : -1;
+    const split = player.splitStep > 0 ? Math.sin(clamp(1 - player.splitStep / 0.22, 0, 1) * Math.PI) : 0;
+    const hitAge = player.strokeContactAge || 0.17;
+    const wind = smooth(player.swingAge / hitAge);
+    const follow = player.strokeConnected ? smooth((player.swingAge - hitAge) / Math.max(0.08, 0.33 - hitAge)) : 0;
+    // A connected stroke settles back into the ready grip before its timer expires.
+    const settle = player.swing > 0 && player.strokeConnected
+        ? smooth(1 - player.swing / 0.065) * smooth((player.swingAge - hitAge) / 0.055)
+        : 0;
+    const plantedStroke = player.swing > 0 && move < 0.2 && player.stroke !== "serve";
+    const coil = plantedStroke ? Math.sin(wind * Math.PI) * (1 - follow) : 0;
+    const slideRemaining = player.slideRemaining;
+    const slide = slideRemaining > 0
+        ? player.slidePoseStatic
+            ? 1
+            : smooth((0.32 - slideRemaining) / 0.055) * smooth(slideRemaining / 0.065)
+        : 0;
+    const hipY = 0.887 - 0.025 * move + Math.cos(phase * 2) * 0.018 * move * (1 - slide) - 0.04 * split - 0.028 * coil - 0.22 * slide;
+    const legs = [-1, 1].map((side, i) => {
+        const t = (((phase / TAU + i * 0.5) % 1) + 1) % 1;
+        const stance = t < 0.58;
+        const swing = clamp((t - 0.58) / 0.42, 0, 1);
+        const along = stance ? mix(0.46, -0.46, t / 0.58) : mix(-0.46, 0.46, swing * swing * (3 - 2 * swing));
+        // Side shuffles stay low; a forward run has more knee drive.
+        const lift = stance ? 0 : Math.sin(swing * Math.PI) * mix(0.17, 0.23, Math.abs(dz)) * move;
+        const hip = [side * 0.15, hipY, 0];
+        // Lateral footwork is a shuffle: keep the feet on their own side instead of crossing.
+        const foot = [
+            side * (0.25 + 0.035 * split) + dx * along * move * 0.4,
+            0.09 + lift,
+            dz * along * move + 0.025 + side * 0.025 * (1 - move)
+        ];
+        if (plantedStroke) {
+            const turn = player.stroke === "backhand" ? -1 : 1;
+            foot[2] += side * turn * 0.075 * Math.sin(wind * Math.PI) * (1 - follow);
+        }
+        if (slide) {
+            const leading = side === (dx < 0 ? -1 : 1);
+            const reach = leading ? 0.63 : -0.38;
+            const target = [side * 0.24 + dx * reach, 0.075, dz * reach + 0.025];
+            for (let axis = 0; axis < 3; axis++)
+                foot[axis] = mix(foot[axis], target[axis], slide);
+        }
+        return { hip, knee: solveKnee(hip, foot), foot, planted: slide > 0 || stance || move < 0.04 };
+    });
+    return { move, face, dx, dz, split, wind, follow, settle, plantedStroke, coil, slide, hipY, legs };
+}
+const DEFAULT_LEFT_LEG = { hip: [-0.11, 0.88, 0], knee: [-0.12, 0.48, -0.05], foot: [-0.12, 0.05, 0] };
+const DEFAULT_RIGHT_LEG = { hip: [0.11, 0.88, 0], knee: [0.12, 0.48, 0.05], foot: [0.12, 0.05, 0] };
+/** Pose leg, arm and racket cylinders from root-local pose points. Torso, head and costume are the caller's. */
+export function applyAthleteLimbs(handles, pose, root) {
+    const rootPos = root.position;
+    const yaw = root.yaw;
+    const scale = root.scale;
+    const leftLeg = pose.legs?.[0] ?? DEFAULT_LEFT_LEG;
+    const rightLeg = pose.legs?.[1] ?? DEFAULT_RIGHT_LEG;
+    const lHipW = localToWorld(rootPos, yaw, scale, leftLeg.hip);
+    const lKneeW = localToWorld(rootPos, yaw, scale, leftLeg.knee);
+    const lFootW = localToWorld(rootPos, yaw, scale, leftLeg.foot);
+    orientCylinderBetween(handles.leftUpperLeg, lHipW, lKneeW, 0.135);
+    orientCylinderBetween(handles.leftLowerLeg, lKneeW, lFootW, 0.11);
+    handles.leftKnee.setPosition(lKneeW[0], lKneeW[1], lKneeW[2]).setScale([1, 1, 1]).setVisible(true);
+    handles.leftShoe
+        .setPosition(lFootW[0], Math.max(0.045, lFootW[1]), lFootW[2])
+        .setRotation(0, yaw, 0)
+        .setScale([scale[0], scale[1], scale[2]])
+        .setVisible(true);
+    const rHipW = localToWorld(rootPos, yaw, scale, rightLeg.hip);
+    const rKneeW = localToWorld(rootPos, yaw, scale, rightLeg.knee);
+    const rFootW = localToWorld(rootPos, yaw, scale, rightLeg.foot);
+    orientCylinderBetween(handles.rightUpperLeg, rHipW, rKneeW, 0.135);
+    orientCylinderBetween(handles.rightLowerLeg, rKneeW, rFootW, 0.11);
+    handles.rightKnee.setPosition(rKneeW[0], rKneeW[1], rKneeW[2]).setScale([1, 1, 1]).setVisible(true);
+    handles.rightShoe
+        .setPosition(rFootW[0], Math.max(0.045, rFootW[1]), rFootW[2])
+        .setRotation(0, yaw, 0)
+        .setScale([scale[0], scale[1], scale[2]])
+        .setVisible(true);
+    // Arms: two-bone IK elbows.
+    const lShoulderLocal = [-0.225, pose.shoulderY, 0];
+    const rShoulderLocal = [0.225, pose.shoulderY, 0];
+    const lHandLocal = pose.left ?? [-0.28, 1.05, -0.14];
+    const rHandLocal = pose.right ?? [0.3, 1.08, -0.16];
+    const lElbowLocal = solveArmElbow(lShoulderLocal, lHandLocal, -1);
+    const rElbowLocal = solveArmElbow(rShoulderLocal, rHandLocal, 1);
+    const lShoulderW = localToWorld(rootPos, yaw, scale, lShoulderLocal);
+    const lElbowW = localToWorld(rootPos, yaw, scale, lElbowLocal);
+    const lHandW = localToWorld(rootPos, yaw, scale, lHandLocal);
+    orientCylinderBetween(handles.leftUpperArm, lShoulderW, lElbowW, 0.105);
+    orientCylinderBetween(handles.leftLowerArm, lElbowW, lHandW, 0.09);
+    handles.leftHand.setPosition(lHandW[0], lHandW[1], lHandW[2]).setScale([1, 1, 1]).setVisible(true);
+    const rShoulderW = localToWorld(rootPos, yaw, scale, rShoulderLocal);
+    const rElbowW = localToWorld(rootPos, yaw, scale, rElbowLocal);
+    const rHandW = localToWorld(rootPos, yaw, scale, rHandLocal);
+    orientCylinderBetween(handles.rightUpperArm, rShoulderW, rElbowW, 0.105);
+    orientCylinderBetween(handles.rightLowerArm, rElbowW, rHandW, 0.09);
+    handles.rightHand.setPosition(rHandW[0], rHandW[1], rHandW[2]).setScale([1, 1, 1]).setVisible(true);
+    // Racket along racketDirection from the right hand.
+    const rDirLocal = pose.racketDirection ?? [0.4, 0.7, -0.4];
+    const rDirWorld = localDirToWorld(yaw, rDirLocal);
+    const rDirLen = Math.hypot(rDirWorld[0], rDirWorld[1], rDirWorld[2]) || 1;
+    const rx = rDirWorld[0] / rDirLen;
+    const ry = rDirWorld[1] / rDirLen;
+    const rz = rDirWorld[2] / rDirLen;
+    // Orthogonal side vector in the racket plane.
+    let sx = -rz;
+    let sy = 0;
+    let sz = rx;
+    const sLen = Math.hypot(sx, sy, sz) || 1;
+    sx /= sLen;
+    sy /= sLen;
+    sz /= sLen;
+    const gripStart = [rHandW[0] - rx * 0.04, rHandW[1] - ry * 0.04, rHandW[2] - rz * 0.04];
+    const gripEnd = [rHandW[0] + rx * 0.17, rHandW[1] + ry * 0.17, rHandW[2] + rz * 0.17];
+    const throatLeftEnd = [
+        rHandW[0] + rx * 0.31 - sx * 0.075,
+        rHandW[1] + ry * 0.31 - sy * 0.075,
+        rHandW[2] + rz * 0.31 - sz * 0.075
+    ];
+    const throatRightEnd = [
+        rHandW[0] + rx * 0.31 + sx * 0.075,
+        rHandW[1] + ry * 0.31 + sy * 0.075,
+        rHandW[2] + rz * 0.31 + sz * 0.075
+    ];
+    const hoopCenter = [rHandW[0] + rx * 0.49, rHandW[1] + ry * 0.49, rHandW[2] + rz * 0.49];
+    orientCylinderBetween(handles.racketHandle, gripStart, gripEnd, 0.032);
+    orientCylinderBetween(handles.racketThroatLeft, gripEnd, throatLeftEnd, 0.022);
+    orientCylinderBetween(handles.racketThroatRight, gripEnd, throatRightEnd, 0.022);
+    const racketRot = directionToEulerXYZ(rx, ry, rz);
+    handles.racketHoop
+        .setPosition(hoopCenter[0], hoopCenter[1], hoopCenter[2])
+        .setRotation(racketRot[0] + Math.PI * 0.5, racketRot[1], racketRot[2])
+        .setScale([0.92, 1.18, 0.92])
+        .setVisible(true);
+    handles.racketStrings
+        .setPosition(hoopCenter[0], hoopCenter[1], hoopCenter[2])
+        .setRotation(racketRot[0] + Math.PI * 0.5, racketRot[1], racketRot[2])
+        .setScale([0.9, 0.6, 1.14])
+        .setVisible(true);
+}
+export const racketAthleteRig = {
+    locomotion: athleteLocomotion,
+    solveKnee,
+    applyLimbs: applyAthleteLimbs
+};
+//# sourceMappingURL=racketAthleteRig.js.map

package/dist/engine/agent-api/game-kits/racketAthleteRig.js.map

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

package/dist/engine/agent-api/game-kits/racketGeometry.d.ts

@@ -0,0 +1,8 @@
+import type { AuraRuntimeNodeHandle } from "../index.js";
+export type RacketVec3 = readonly [number, number, number];
+export declare function directionToEulerXYZ(dx: number, dy: number, dz: number): [number, number, number];
+export declare function orientCylinderBetween(handle: AuraRuntimeNodeHandle | undefined, a: RacketVec3, b: RacketVec3, radiusX: number, radiusZ?: number): void;
+export declare function solveArmElbow(shoulder: RacketVec3, hand: RacketVec3, sideSign: number, upperLen?: number, lowerLen?: number): [number, number, number];
+export declare function localToWorld(rootPos: RacketVec3, yaw: number, scale: RacketVec3, local: RacketVec3): [number, number, number];
+export declare function localDirToWorld(yaw: number, dir: RacketVec3): [number, number, number];
+//# sourceMappingURL=racketGeometry.d.ts.map

package/dist/engine/agent-api/game-kits/racketGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"racketGeometry.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/game-kits/racketGeometry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEtD,MAAM,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAM3D,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAShG;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,qBAAqB,GAAG,SAAS,EACzC,CAAC,EAAE,UAAU,EACb,CAAC,EAAE,UAAU,EACb,OAAO,EAAE,MAAM,EACf,OAAO,SAAU,GAChB,IAAI,CAaN;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,UAAU,EACpB,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,SAAM,EACd,QAAQ,SAAQ,GACf,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CA0B1B;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,UAAU,GAChB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAW1B;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAItF"}

package/dist/engine/agent-api/game-kits/racketGeometry.js

@@ -0,0 +1,73 @@
+function clamp(v, min, max) {
+    return Math.max(min, Math.min(max, v));
+}
+export function directionToEulerXYZ(dx, dy, dz) {
+    const len = Math.hypot(dx, dy, dz) || 1;
+    const ux = dx / len;
+    const uy = dy / len;
+    const uz = dz / len;
+    const rx = Math.asin(clamp(uz, -1, 1));
+    const ry = 0;
+    const rz = Math.atan2(-ux, uy);
+    return [rx, ry, rz];
+}
+export function orientCylinderBetween(handle, a, b, radiusX, radiusZ = radiusX) {
+    if (!handle)
+        return;
+    const dx = b[0] - a[0];
+    const dy = b[1] - a[1];
+    const dz = b[2] - a[2];
+    const len = Math.max(0.001, Math.hypot(dx, dy, dz));
+    const mid = [(a[0] + b[0]) * 0.5, (a[1] + b[1]) * 0.5, (a[2] + b[2]) * 0.5];
+    const rot = directionToEulerXYZ(dx, dy, dz);
+    handle
+        .setPosition(mid[0], mid[1], mid[2])
+        .setRotation(rot[0], rot[1], rot[2])
+        .setScale([radiusX, len, radiusZ])
+        .setVisible(true);
+}
+export function solveArmElbow(shoulder, hand, sideSign, upperLen = 0.3, lowerLen = 0.285) {
+    const sx = hand[0] - shoulder[0];
+    const sy = hand[1] - shoulder[1];
+    const sz = hand[2] - shoulder[2];
+    const dist = Math.max(0.001, Math.hypot(sx, sy, sz));
+    const wx = sx / dist;
+    const wy = sy / dist;
+    const wz = sz / dist;
+    let bx = sideSign * 0.8;
+    let by = -0.45;
+    let bz = 0.9;
+    const dot = bx * wx + by * wy + bz * wz;
+    bx -= wx * dot;
+    by -= wy * dot;
+    bz -= wz * dot;
+    const bLen = Math.hypot(bx, by, bz) || 1;
+    bx /= bLen;
+    by /= bLen;
+    bz /= bLen;
+    const along = (upperLen * upperLen - lowerLen * lowerLen + dist * dist) / (2 * dist);
+    const bend = Math.sqrt(Math.max(0, upperLen * upperLen - along * along));
+    return [
+        shoulder[0] + wx * along + bx * bend,
+        shoulder[1] + wy * along + by * bend,
+        shoulder[2] + wz * along + bz * bend
+    ];
+}
+export function localToWorld(rootPos, yaw, scale, local) {
+    const sx = local[0] * scale[0];
+    const sy = local[1] * scale[1];
+    const sz = local[2] * scale[2];
+    const c = Math.cos(yaw);
+    const s = Math.sin(yaw);
+    return [
+        rootPos[0] + sx * c + sz * s,
+        rootPos[1] + sy,
+        rootPos[2] - sx * s + sz * c
+    ];
+}
+export function localDirToWorld(yaw, dir) {
+    const c = Math.cos(yaw);
+    const s = Math.sin(yaw);
+    return [dir[0] * c + dir[2] * s, dir[1], -dir[0] * s + dir[2] * c];
+}
+//# sourceMappingURL=racketGeometry.js.map

package/dist/engine/agent-api/game-kits/racketGeometry.js.map

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

package/dist/engine/agent-api/game-kits/racketScoring.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Rally-sport scoring as a pure state machine: points to a game (win by N), games to a match (win by N) and an optional
+ * tiebreak. The defaults are tennis as implemented by the Aura Slam port (4 points win by 2, first to 3 games leading by 2,
+ * a tiebreak to 7 win by 2 at 3-3), verified point by point against the original simulation. Sides are indices 0 and 1.
+ */
+export type RacketSide = 0 | 1;
+export interface RacketTiebreakRules {
+    /** Games each when the tiebreak starts (3 in the Aura Slam match format). */
+    readonly atGames: number;
+    readonly points: number;
+    readonly winBy: number;
+}
+export interface RacketScoringRules {
+    /** Points that win a game once the margin is met (default 4). */
+    readonly pointsToGame?: number;
+    /** Margin needed to win a game or a tiebreak (default 2). */
+    readonly winBy?: number;
+    /** Games that can win the match once the margin is met (default 3). */
+    readonly gamesToMatch?: number;
+    /** Margin needed to win the match on games (default 2). */
+    readonly matchWinBy?: number;
+    /** Tiebreak rules, or `false` for none (default: at 3-3, first to 7 win by 2). */
+    readonly tiebreak?: false | Partial<RacketTiebreakRules>;
+}
+export interface RacketScoreState {
+    readonly points: readonly [number, number];
+    readonly games: readonly [number, number];
+    readonly tiebreak: boolean;
+    /** Who serves the next point. */
+    readonly server: RacketSide;
+    readonly firstServer: RacketSide;
+    readonly tiebreakFirstServer: RacketSide;
+    readonly matchWon: boolean;
+    readonly winner: RacketSide | null;
+}
+export interface RacketPointResult {
+    readonly state: RacketScoreState;
+    readonly gameWon: boolean;
+    readonly matchWon: boolean;
+    readonly tiebreakStarted: boolean;
+}
+export interface RacketScoring {
+    readonly rules: Readonly<Required<Omit<RacketScoringRules, "tiebreak">> & {
+        tiebreak: false | RacketTiebreakRules;
+    }>;
+    init(firstServer?: RacketSide): RacketScoreState;
+    /** Award one point and resolve game, tiebreak and match. Returns a new state; the input is not modified. */
+    awardPoint(state: RacketScoreState, winner: RacketSide): RacketPointResult;
+    /** Tennis-style label for one side's points in a game: 0, 15, 30, 40, AD. */
+    label(own: number, opponent: number): string;
+}
+export declare function createRacketScoring(rules?: RacketScoringRules): RacketScoring;
+//# sourceMappingURL=racketScoring.d.ts.map

package/dist/engine/agent-api/game-kits/racketScoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"racketScoring.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/game-kits/racketScoring.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC;AAE/B,MAAM,WAAW,mBAAmB;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,mBAAmB,EAAE,UAAU,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC,GAAG;QAAE,QAAQ,EAAE,KAAK,GAAG,mBAAmB,CAAA;KAAE,CAAC,CAAC;IACrH,IAAI,CAAC,WAAW,CAAC,EAAE,UAAU,GAAG,gBAAgB,CAAC;IACjD,4GAA4G;IAC5G,UAAU,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,UAAU,GAAG,iBAAiB,CAAC;IAC3E,6EAA6E;IAC7E,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9C;AAID,wBAAgB,mBAAmB,CAAC,KAAK,GAAE,kBAAuB,GAAG,aAAa,CA8DjF"}

package/dist/engine/agent-api/game-kits/racketScoring.js

@@ -0,0 +1,69 @@
+const other = (side) => (side === 0 ? 1 : 0);
+export function createRacketScoring(rules = {}) {
+    const pointsToGame = rules.pointsToGame ?? 4;
+    const winBy = rules.winBy ?? 2;
+    const gamesToMatch = rules.gamesToMatch ?? 3;
+    const matchWinBy = rules.matchWinBy ?? 2;
+    const tiebreak = rules.tiebreak === false ? false : { atGames: 3, points: 7, winBy: 2, ...rules.tiebreak };
+    const resolved = Object.freeze({ pointsToGame, winBy, gamesToMatch, matchWinBy, tiebreak });
+    return {
+        rules: resolved,
+        init(firstServer = 0) {
+            return { points: [0, 0], games: [0, 0], tiebreak: false, server: firstServer, firstServer, tiebreakFirstServer: firstServer, matchWon: false, winner: null };
+        },
+        awardPoint(state, winner) {
+            if (state.matchWon)
+                return { state, gameWon: false, matchWon: false, tiebreakStarted: false };
+            const points = [state.points[0], state.points[1]];
+            const games = [state.games[0], state.games[1]];
+            let { server, tiebreak: inTiebreak, tiebreakFirstServer } = state;
+            let matchWon = state.matchWon;
+            points[winner] += 1;
+            const a = points[winner];
+            const b = points[other(winner)];
+            let gameWon = false;
+            let tiebreakStarted = false;
+            if (inTiebreak && tiebreak) {
+                if (a >= tiebreak.points && a - b >= tiebreak.winBy) {
+                    games[winner] += 1;
+                    matchWon = true;
+                    gameWon = true;
+                }
+                else {
+                    const turn = Math.floor((a + b + 1) / 2) % 2;
+                    server = turn === 0 ? tiebreakFirstServer : other(tiebreakFirstServer);
+                }
+            }
+            else if (a >= pointsToGame && a - b >= winBy) {
+                gameWon = true;
+                games[winner] += 1;
+                points[0] = 0;
+                points[1] = 0;
+                const totalGames = games[0] + games[1];
+                server = totalGames % 2 === 0 ? state.firstServer : other(state.firstServer);
+                if ((games[0] >= gamesToMatch || games[1] >= gamesToMatch) && Math.abs(games[0] - games[1]) >= matchWinBy) {
+                    matchWon = true;
+                }
+                else if (tiebreak && games[0] === tiebreak.atGames && games[1] === tiebreak.atGames) {
+                    inTiebreak = true;
+                    tiebreakFirstServer = server;
+                    tiebreakStarted = true;
+                }
+            }
+            const next = {
+                points, games, tiebreak: inTiebreak, server, firstServer: state.firstServer, tiebreakFirstServer, matchWon,
+                winner: matchWon ? (games[0] > games[1] ? 0 : 1) : null,
+            };
+            return { state: next, gameWon, matchWon, tiebreakStarted };
+        },
+        label(own, opponent) {
+            if (own >= pointsToGame - 1 && opponent >= pointsToGame - 1) {
+                if (own === opponent)
+                    return "40";
+                return own > opponent ? "AD" : "40";
+            }
+            return ["0", "15", "30", "40"][Math.min(own, 3)] ?? "40";
+        },
+    };
+}
+//# sourceMappingURL=racketScoring.js.map

package/dist/engine/agent-api/game-kits/racketScoring.js.map

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

package/dist/engine/agent-api/game-kits/racketSports.d.ts

@@ -1,5 +1,12 @@
 import type { AuraRuntimeNodeHandle } from "../index.js";
-export type RacketVec3 = readonly [number, number, number];
+import { type RacketAthleteRigKit } from "./racketAthleteRig.js";
+import { directionToEulerXYZ, localDirToWorld, localToWorld, orientCylinderBetween, solveArmElbow, type RacketVec3 } from "./racketGeometry.js";
+import { createBallFlight, type BallFlightConfig, type BallFlightKit } from "./ballFlight.js";
+import { createRacketScoring, type RacketScoring, type RacketScoringRules } from "./racketScoring.js";
+export * from "./racketScoring.js";
+export { createBallFlight };
+export type { BallFlightBall, BallFlightBoard, BallFlightConfig, BallFlightEventType, BallFlightKit, BallFlightSample, BallFlightSurface } from "./ballFlight.js";
+export { directionToEulerXYZ, localDirToWorld, localToWorld, orientCylinderBetween, solveArmElbow, type RacketVec3 };
 export interface RacketBallState {
     x: number;
     y: number;
@@ -44,12 +51,16 @@ export interface RacketSportsGameKit {
     localToWorld(rootPos: RacketVec3, yaw: number, scale: RacketVec3, local: RacketVec3): [number, number, number];
     localDirToWorld(yaw: number, dir: RacketVec3): [number, number, number];
     stepBallPhysics(dt: number, ball: RacketBallState, surface?: RacketSurfacePhysicsOptions): RacketBallStepEvents;
+    /** Pure game/match/tiebreak scoring state machine; defaults to the Aura Slam tennis rules. */
+    scoring(rules?: RacketScoringRules): RacketScoring;
+    /** Procedural athlete rig: stride/split-step/slide locomotion solver and a limb applicator (see racketAthleteRig). */
+    readonly athleteRig: RacketAthleteRigKit;
+    /**
+     * Exact event-time ball flight (x lateral, y along the court, z up). Configure units, gravity, drag, net,
+     * surfaces and optional boards; returns pure sample/solve/advance functions. See docs/api/ball-flight.md.
+     */
+    ballFlight(config: BallFlightConfig): BallFlightKit;
 }
-export declare function directionToEulerXYZ(dx: number, dy: number, dz: number): [number, number, number];
-export declare function orientCylinderBetween(handle: AuraRuntimeNodeHandle | undefined, a: RacketVec3, b: RacketVec3, radiusX: number, radiusZ?: number): void;
-export declare function solveArmElbow(shoulder: RacketVec3, hand: RacketVec3, sideSign: number, upperLen?: number, lowerLen?: number): [number, number, number];
-export declare function localToWorld(rootPos: RacketVec3, yaw: number, scale: RacketVec3, local: RacketVec3): [number, number, number];
-export declare function localDirToWorld(yaw: number, dir: RacketVec3): [number, number, number];
 export declare function stepRacketBallPhysics(dt: number, ball: RacketBallState, surface?: RacketSurfacePhysicsOptions): RacketBallStepEvents;
 export declare function createRacketSportsGameKit(id?: string): RacketSportsGameKit;
 export declare const racketSports: {
@@ -60,5 +71,8 @@ export declare const racketSports: {
     readonly localToWorld: typeof localToWorld;
     readonly localDirToWorld: typeof localDirToWorld;
     readonly stepBallPhysics: typeof stepRacketBallPhysics;
+    readonly scoring: typeof createRacketScoring;
+    readonly athleteRig: RacketAthleteRigKit;
+    readonly ballFlight: typeof createBallFlight;
 };
 //# sourceMappingURL=racketSports.d.ts.map

package/dist/engine/agent-api/game-kits/racketSports.d.ts.map

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

package/dist/engine/agent-api/game-kits/racketSports.js

@@ -1,75 +1,10 @@
-function clamp(v, min, max) {
-    return Math.max(min, Math.min(max, v));
-}
-export function directionToEulerXYZ(dx, dy, dz) {
-    const len = Math.hypot(dx, dy, dz) || 1;
-    const ux = dx / len;
-    const uy = dy / len;
-    const uz = dz / len;
-    const rx = Math.asin(clamp(uz, -1, 1));
-    const ry = 0;
-    const rz = Math.atan2(-ux, uy);
-    return [rx, ry, rz];
-}
-export function orientCylinderBetween(handle, a, b, radiusX, radiusZ = radiusX) {
-    if (!handle)
-        return;
-    const dx = b[0] - a[0];
-    const dy = b[1] - a[1];
-    const dz = b[2] - a[2];
-    const len = Math.max(0.001, Math.hypot(dx, dy, dz));
-    const mid = [(a[0] + b[0]) * 0.5, (a[1] + b[1]) * 0.5, (a[2] + b[2]) * 0.5];
-    const rot = directionToEulerXYZ(dx, dy, dz);
-    handle
-        .setPosition(mid[0], mid[1], mid[2])
-        .setRotation(rot[0], rot[1], rot[2])
-        .setScale([radiusX, len, radiusZ])
-        .setVisible(true);
-}
-export function solveArmElbow(shoulder, hand, sideSign, upperLen = 0.3, lowerLen = 0.285) {
-    const sx = hand[0] - shoulder[0];
-    const sy = hand[1] - shoulder[1];
-    const sz = hand[2] - shoulder[2];
-    const dist = Math.max(0.001, Math.hypot(sx, sy, sz));
-    const wx = sx / dist;
-    const wy = sy / dist;
-    const wz = sz / dist;
-    let bx = sideSign * 0.8;
-    let by = -0.45;
-    let bz = 0.9;
-    const dot = bx * wx + by * wy + bz * wz;
-    bx -= wx * dot;
-    by -= wy * dot;
-    bz -= wz * dot;
-    const bLen = Math.hypot(bx, by, bz) || 1;
-    bx /= bLen;
-    by /= bLen;
-    bz /= bLen;
-    const along = (upperLen * upperLen - lowerLen * lowerLen + dist * dist) / (2 * dist);
-    const bend = Math.sqrt(Math.max(0, upperLen * upperLen - along * along));
-    return [
-        shoulder[0] + wx * along + bx * bend,
-        shoulder[1] + wy * along + by * bend,
-        shoulder[2] + wz * along + bz * bend
-    ];
-}
-export function localToWorld(rootPos, yaw, scale, local) {
-    const sx = local[0] * scale[0];
-    const sy = local[1] * scale[1];
-    const sz = local[2] * scale[2];
-    const c = Math.cos(yaw);
-    const s = Math.sin(yaw);
-    return [
-        rootPos[0] + sx * c + sz * s,
-        rootPos[1] + sy,
-        rootPos[2] - sx * s + sz * c
-    ];
-}
-export function localDirToWorld(yaw, dir) {
-    const c = Math.cos(yaw);
-    const s = Math.sin(yaw);
-    return [dir[0] * c + dir[2] * s, dir[1], -dir[0] * s + dir[2] * c];
-}
+import { racketAthleteRig } from "./racketAthleteRig.js";
+import { directionToEulerXYZ, localDirToWorld, localToWorld, orientCylinderBetween, solveArmElbow } from "./racketGeometry.js";
+import { createBallFlight } from "./ballFlight.js";
+import { createRacketScoring } from "./racketScoring.js";
+export * from "./racketScoring.js";
+export { createBallFlight };
+export { directionToEulerXYZ, localDirToWorld, localToWorld, orientCylinderBetween, solveArmElbow };
 export function stepRacketBallPhysics(dt, ball, surface = {}) {
     const gravity = surface.gravity ?? 9.81;
     const airDrag = surface.airDrag ?? 0.12;
@@ -131,7 +66,10 @@ export function createRacketSportsGameKit(id = "racket-sports") {
         solveArmElbow,
         localToWorld,
         localDirToWorld,
-        stepBallPhysics: stepRacketBallPhysics
+        stepBallPhysics: stepRacketBallPhysics,
+        scoring: createRacketScoring,
+        athleteRig: racketAthleteRig,
+        ballFlight: createBallFlight
     };
 }
 export const racketSports = {
@@ -141,6 +79,9 @@ export const racketSports = {
     solveArmElbow,
     localToWorld,
     localDirToWorld,
-    stepBallPhysics: stepRacketBallPhysics
+    stepBallPhysics: stepRacketBallPhysics,
+    scoring: createRacketScoring,
+    athleteRig: racketAthleteRig,
+    ballFlight: createBallFlight
 };
 //# sourceMappingURL=racketSports.js.map