@aura3d/engine 2.0.3 → 3.0.0

package/dist/engine/agent-api/GameCameraRigs.js

@@ -0,0 +1,414 @@
+/**
+ * Game camera rigs (muse3jsparity-PRD F2).
+ *
+ * Game cameras three.js does not ship: shoulder cam, collision-aware orbit
+ * (wall slide via caller-supplied ray/sphere probes, never teleports/clips),
+ * procedural trauma shake with decay, hit punch-in, and a per-frame
+ * `cameraEvidence` aggregator. Pure scene-math: no renderer, no DOM, no
+ * `three` imports. The caller owns frame presentation; every rig returns
+ * plain position/target/fov snapshots plus evidence the route can publish.
+ *
+ * Follow-rig unification (PRD N2.2): `createFollowRig` below is the
+ * root-adjacent canonical follow camera. It implements the same
+ * offset-plus-exponential-damping algorithm as
+ * `ThirdPersonFollowControls` in `@aura3d/input`; that class remains the
+ * direct-camera-mutation adapter, while this module owns the algorithm
+ * contract (`FOLLOW_DAMPING_CONTRACT`). `asInputOptions()` converts one
+ * options object into the input adapter's shape so the two can never
+ * diverge. P1 pairs with N2 via this interface (reported, ledger untouched).
+ */
+function assertFinite(value, api, field) {
+    if (!Number.isFinite(value)) {
+        throw new RangeError(`${api} ${field} must be finite (received ${String(value)}).`);
+    }
+}
+function assertVec3(value, api, field) {
+    if (!Array.isArray(value) || value.length !== 3 || value.some((component) => !Number.isFinite(component))) {
+        throw new RangeError(`${api} ${field} must be a finite [x, y, z] tuple.`);
+    }
+}
+function dampFactor(rate, dt) {
+    return 1 - Math.exp(-Math.max(0, rate) * Math.max(0, dt));
+}
+function lerpTuple(a, b, alpha) {
+    return [
+        a[0] + (b[0] - a[0]) * alpha,
+        a[1] + (b[1] - a[1]) * alpha,
+        a[2] + (b[2] - a[2]) * alpha
+    ];
+}
+export function createShoulderCamera(options = {}) {
+    const api = "camera.shoulder";
+    const sideSign = options.side === "left" ? -1 : 1;
+    const sideOffset = options.sideOffset ?? 0.85;
+    const heightOffset = options.heightOffset ?? 1.55;
+    const distance = options.distance ?? 2.6;
+    const lookAhead = options.lookAhead ?? 2.2;
+    const smoothing = options.smoothing ?? 10;
+    const fov = options.fov ?? 55;
+    for (const [field, value] of [["sideOffset", sideOffset], ["heightOffset", heightOffset], ["distance", distance], ["lookAhead", lookAhead], ["smoothing", smoothing], ["fov", fov]]) {
+        assertFinite(value, api, field);
+    }
+    if (distance < 0)
+        throw new RangeError(`${api} distance must be >= 0.`);
+    if (smoothing < 0)
+        throw new RangeError(`${api} smoothing must be >= 0.`);
+    let eye = [sideSign * sideOffset, heightOffset, distance];
+    let look = [0, 1, -lookAhead];
+    let currentFov = fov;
+    const solve = (target) => {
+        assertVec3(target.position, api, "target.position");
+        const yaw = target.facing ?? 0;
+        assertFinite(yaw, api, "target.facing");
+        const forward = [Math.sin(yaw), 0, -Math.cos(yaw)];
+        const right = [Math.cos(yaw), 0, Math.sin(yaw)];
+        const [px, py, pz] = target.position;
+        return {
+            eye: [
+                px - forward[0] * distance + right[0] * sideSign * sideOffset,
+                py + heightOffset,
+                pz - forward[2] * distance + right[2] * sideSign * sideOffset
+            ],
+            look: [px + forward[0] * lookAhead, py + heightOffset * 0.55, pz + forward[2] * lookAhead]
+        };
+    };
+    const snap = () => ({
+        kind: "aura-game-shoulder-camera",
+        position: eye,
+        target: look,
+        fov: currentFov
+    });
+    return {
+        update(dt, target) {
+            assertFinite(dt, api, "dt");
+            const solved = solve(target);
+            const alpha = dampFactor(smoothing, dt);
+            eye = lerpTuple(eye, solved.eye, alpha);
+            look = lerpTuple(look, solved.look, alpha);
+            currentFov = fov;
+            return snap();
+        },
+        snapshot: snap,
+        reset(nextEye) {
+            assertVec3(nextEye, api, "eye");
+            eye = [...nextEye];
+        }
+    };
+}
+export function createCollisionAwareOrbit(options = {}) {
+    const api = "camera.collisionAwareOrbit";
+    const minDistance = options.minDistance ?? 0.6;
+    const maxDistance = options.maxDistance ?? 14;
+    const probeRadius = options.probeRadius ?? 0.3;
+    const smoothing = options.smoothing ?? 6;
+    const pullInRate = options.pullInRate ?? 30;
+    const fov = options.fov ?? 50;
+    for (const [field, value] of [["minDistance", minDistance], ["maxDistance", maxDistance], ["probeRadius", probeRadius], ["smoothing", smoothing], ["pullInRate", pullInRate], ["fov", fov]]) {
+        assertFinite(value, api, field);
+    }
+    if (minDistance < 0)
+        throw new RangeError(`${api} minDistance must be >= 0.`);
+    if (maxDistance < minDistance)
+        throw new RangeError(`${api} maxDistance must be >= minDistance.`);
+    if (probeRadius < 0)
+        throw new RangeError(`${api} probeRadius must be >= 0.`);
+    let target = options.target ? [...options.target] : [0, 1, 0];
+    assertVec3(target, api, "target");
+    let azimuth = options.azimuth ?? 0.6;
+    let polar = options.polar ?? 1.05;
+    let wanted = Math.min(maxDistance, Math.max(minDistance, options.distance ?? 5));
+    let current = wanted;
+    let clipped = false;
+    let clearance = wanted;
+    const offsetFor = (length) => {
+        const sinPolar = Math.sin(polar);
+        return [
+            length * sinPolar * Math.sin(azimuth),
+            length * Math.cos(polar),
+            length * sinPolar * Math.cos(azimuth)
+        ];
+    };
+    const solve = () => {
+        const offset = offsetFor(current);
+        return {
+            kind: "aura-game-collision-orbit",
+            position: [target[0] + offset[0], target[1] + offset[1], target[2] + offset[2]],
+            target,
+            fov,
+            clipped,
+            clearance
+        };
+    };
+    return {
+        rotate(deltaAzimuth, deltaPolar) {
+            assertFinite(deltaAzimuth, api, "deltaAzimuth");
+            assertFinite(deltaPolar, api, "deltaPolar");
+            azimuth += deltaAzimuth;
+            polar = Math.min(Math.PI - 0.02, Math.max(0.02, polar + deltaPolar));
+        },
+        dolly(factor) {
+            assertFinite(factor, api, "factor");
+            if (factor <= 0)
+                throw new RangeError(`${api} dolly factor must be > 0.`);
+            wanted = Math.min(maxDistance, Math.max(minDistance, wanted * factor));
+        },
+        setTarget(next) {
+            assertVec3(next, api, "target");
+            target = [...next];
+        },
+        update(dt, probe) {
+            assertFinite(dt, api, "dt");
+            const seconds = Math.max(0, dt);
+            let allowed = wanted;
+            if (probe) {
+                const offset = offsetFor(wanted);
+                const length = Math.hypot(offset[0], offset[1], offset[2]);
+                if (length > 1e-9) {
+                    const direction = [offset[0] / length, offset[1] / length, offset[2] / length];
+                    const hit = probe(target, direction, length);
+                    if (hit) {
+                        assertFinite(hit.distance, api, "probe hit distance");
+                        // Slide: pull in along the same ray to the wall minus the probe
+                        // radius. Never teleports: approach below is rate-limited.
+                        allowed = Math.min(wanted, Math.max(minDistance, hit.distance - probeRadius));
+                    }
+                }
+            }
+            clipped = allowed < wanted - 1e-6;
+            clearance = allowed;
+            // Fast pull-in so the lens never enters the wall; slow release so it
+            // slides back out instead of popping.
+            const rate = allowed < current ? pullInRate : smoothing;
+            current += (allowed - current) * dampFactor(rate, seconds);
+            return solve();
+        },
+        snapshot: solve
+    };
+}
+export function createTraumaShake(options = {}) {
+    const api = "camera.shake";
+    const decay = options.decay ?? 1.4;
+    const maxOffset = options.maxOffset ?? 0.22;
+    const maxRoll = options.maxRoll ?? 0.035;
+    const seed = options.seed ?? 1.7;
+    for (const [field, value] of [["decay", decay], ["maxOffset", maxOffset], ["maxRoll", maxRoll], ["seed", seed]]) {
+        assertFinite(value, api, field);
+    }
+    if (decay < 0)
+        throw new RangeError(`${api} decay must be >= 0.`);
+    if (maxOffset < 0)
+        throw new RangeError(`${api} maxOffset must be >= 0.`);
+    let trauma = 0;
+    let time = 0;
+    // Deterministic layered-sine noise: identical dt streams produce
+    // identical offsets, so shake decay is unit-testable without randomness.
+    const noise = (phase) => 0.55 * Math.sin(time * 39.7 + seed + phase) +
+        0.3 * Math.sin(time * 71.3 + seed * 1.7 + phase * 2.1) +
+        0.15 * Math.sin(time * 127.9 + seed * 2.3 + phase * 0.7);
+    const snap = () => {
+        const energy = trauma * trauma;
+        // `+ 0` normalizes -0 (negative noise × zero energy) to 0 so snapshots
+        // stay Object.is-clean for evidence comparisons.
+        return {
+            kind: "aura-game-trauma-shake",
+            offset: [
+                noise(0) * maxOffset * energy + 0,
+                noise(2.4) * maxOffset * 0.7 * energy + 0,
+                noise(4.8) * maxOffset * 0.4 * energy + 0
+            ],
+            roll: noise(7.1) * maxRoll * energy + 0,
+            trauma,
+            energy
+        };
+    };
+    return {
+        addTrauma(amount) {
+            assertFinite(amount, api, "amount");
+            if (amount < 0)
+                throw new RangeError(`${api} trauma amount must be >= 0.`);
+            trauma = Math.min(1, trauma + amount);
+        },
+        update(dt) {
+            assertFinite(dt, api, "dt");
+            time += Math.max(0, dt);
+            trauma = Math.max(0, trauma - decay * Math.max(0, dt));
+            return snap();
+        },
+        snapshot: snap
+    };
+}
+export function createPunchIn(options = {}) {
+    const api = "camera.punchIn";
+    const fovKick = options.fovKick ?? 7;
+    const distanceKick = options.distanceKick ?? 0.55;
+    const duration = options.duration ?? 0.32;
+    for (const [field, value] of [["fovKick", fovKick], ["distanceKick", distanceKick], ["duration", duration]]) {
+        assertFinite(value, api, field);
+    }
+    if (duration <= 0)
+        throw new RangeError(`${api} duration must be > 0.`);
+    let elapsed = duration;
+    let strength = 0;
+    const snap = () => {
+        const progress = Math.min(1, elapsed / duration);
+        const active = elapsed < duration;
+        // Fast attack, smooth release: full kick at progress 0, gone at 1.
+        const envelope = active ? Math.sin(Math.min(1, progress) * Math.PI) ** 0.75 : 0;
+        return {
+            kind: "aura-game-punch-in",
+            fovOffset: -fovKick * strength * envelope + 0,
+            distanceOffset: -distanceKick * strength * envelope + 0,
+            active,
+            progress
+        };
+    };
+    return {
+        punch(nextStrength = 1) {
+            assertFinite(nextStrength, api, "strength");
+            if (nextStrength < 0 || nextStrength > 1) {
+                throw new RangeError(`${api} strength must be in [0, 1].`);
+            }
+            strength = nextStrength;
+            elapsed = 0;
+        },
+        update(dt) {
+            assertFinite(dt, api, "dt");
+            elapsed = Math.min(duration, elapsed + Math.max(0, dt));
+            return snap();
+        },
+        snapshot: snap
+    };
+}
+// ---------------------------------------------------------------------------
+// Follow rig (N2.2 canonical follow; see module docblock)
+// ---------------------------------------------------------------------------
+/**
+ * The single follow-camera damping contract shared with
+ * `ThirdPersonFollowControls` (`@aura3d/input`): the eye eases toward
+ * `target.position + offset` with exponential damping
+ * `alpha = 1 - exp(-damping * dt)`, then looks at the target.
+ */
+export const FOLLOW_DAMPING_CONTRACT = "offset-plus-exponential-damping-v1";
+export function createFollowRig(options = {}) {
+    const api = "camera.followRig";
+    const offset = options.offset ? [...options.offset] : [0, 2, 6];
+    assertVec3(offset, api, "offset");
+    const damping = options.damping ?? 12;
+    const fov = options.fov ?? 50;
+    assertFinite(damping, api, "damping");
+    assertFinite(fov, api, "fov");
+    if (damping < 0)
+        throw new RangeError(`${api} damping must be >= 0.`);
+    let eye = [offset[0], offset[1], offset[2]];
+    let look = [0, 0, 0];
+    const snap = () => ({
+        kind: "aura-game-follow-rig",
+        position: eye,
+        target: look,
+        fov
+    });
+    return {
+        update(dt, target) {
+            assertFinite(dt, api, "dt");
+            assertVec3(target.position, api, "target.position");
+            const desired = [
+                target.position[0] + offset[0],
+                target.position[1] + offset[1],
+                target.position[2] + offset[2]
+            ];
+            const alpha = dampFactor(damping, dt);
+            eye = lerpTuple(eye, desired, alpha);
+            look = [...target.position];
+            return snap();
+        },
+        snapshot: snap,
+        asInputOptions() {
+            return { offset: { x: offset[0], y: offset[1], z: offset[2] }, damping };
+        }
+    };
+}
+export function createGameCameraRig(options = {}) {
+    const api = "camera.gameRig";
+    const base = options.base ?? "shoulder";
+    const shoulder = createShoulderCamera(options.shoulder);
+    const orbit = createCollisionAwareOrbit(options.orbit);
+    const follow = createFollowRig(options.follow);
+    const trauma = createTraumaShake(options.trauma);
+    const punchIn = createPunchIn(options.punch);
+    const fovOverride = options.fov;
+    if (fovOverride !== undefined)
+        assertFinite(fovOverride, api, "fov");
+    let last = {
+        snapshot: { kind: "aura-game-camera-rig", position: [0, 1.6, 4], target: [0, 1, 0], fov: fovOverride ?? 50 },
+        evidence: {
+            kind: "aura-game-camera-evidence",
+            position: [0, 1.6, 4],
+            target: [0, 1, 0],
+            fov: fovOverride ?? 50,
+            shakeEnergy: 0,
+            trauma: 0,
+            punchActive: false,
+            clipped: false,
+            clearance: Number.POSITIVE_INFINITY
+        }
+    };
+    return {
+        trauma,
+        punchIn,
+        update(dt, target, probe) {
+            assertFinite(dt, api, "dt");
+            const shake = trauma.update(dt);
+            const punch = punchIn.update(dt);
+            let baseSnap;
+            let clipped = false;
+            let clearance = Number.POSITIVE_INFINITY;
+            if (base === "collision-orbit") {
+                const solved = orbit.update(dt, probe);
+                baseSnap = solved;
+                clipped = solved.clipped;
+                clearance = solved.clearance;
+            }
+            else if (base === "follow") {
+                baseSnap = follow.update(dt, target);
+            }
+            else {
+                baseSnap = shoulder.update(dt, target);
+            }
+            const position = [
+                baseSnap.position[0] + shake.offset[0],
+                baseSnap.position[1] + shake.offset[1],
+                baseSnap.position[2] + shake.offset[2]
+            ];
+            const fov = (fovOverride ?? baseSnap.fov) + punch.fovOffset;
+            last = {
+                snapshot: { kind: "aura-game-camera-rig", position, target: baseSnap.target, fov },
+                evidence: {
+                    kind: "aura-game-camera-evidence",
+                    position,
+                    target: baseSnap.target,
+                    fov,
+                    shakeEnergy: shake.energy,
+                    trauma: shake.trauma,
+                    punchActive: punch.active,
+                    clipped,
+                    clearance
+                }
+            };
+            return last;
+        },
+        snapshot: () => last
+    };
+}
+/**
+ * Root-bridge namespace (wiring lives in `agent-api/index.ts`, owned by the
+ * bridge sibling — this object is the exact surface to spread onto `camera`).
+ */
+export const gameCameraRigs = {
+    shoulder: createShoulderCamera,
+    collisionAwareOrbit: createCollisionAwareOrbit,
+    shake: createTraumaShake,
+    punchIn: createPunchIn,
+    followRig: createFollowRig,
+    gameRig: createGameCameraRig
+};
+//# sourceMappingURL=GameCameraRigs.js.map

package/dist/engine/agent-api/GameCameraRigs.js.map

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

package/dist/engine/agent-api/GameFeel.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Generalized game-feel kit (muse3jsparity-PRD F3).
+ *
+ * Generalizes the combat-proven pieces: `hitStop` durations come from the
+ * fighting kit (`game-kits/fighting.ts`: light 0.045s, heavy 0.07s,
+ * special 0.1s) and the pixel path reuses the `createGameEffects` kinds
+ * (`hit-spark`, `impact-flash`, `dash-trail`, `ground-dust`, ...), so every
+ * effect below resolves to real scene nodes through `nodes()` — never DOM,
+ * canvas, or CSS fakes (boundaries rule).
+ *
+ * This module is engine-pure and owns no renderer: the effects controller is
+ * injected through {@link GameFeelEffectsPort}, which `createGameEffects`
+ * (in `GameRuntime.ts`) satisfies structurally. A kit without a wired
+ * controller refuses pixel-backed triggers with an explicit receipt instead
+ * of faking success. All triggers are frame-budgeted and every trigger
+ * returns a receipt; `snapshot()` is the telemetry surface.
+ */
+import type { GameEffectInstance, GameEffectKind, GameEffectsSnapshot, GameVec3 } from "./GameRuntime.js";
+/** Combat-proven hit-stop defaults, generalized (fighting kit values). */
+export declare const GAME_FEEL_HIT_STOP_LIGHT_S = 0.045;
+export declare const GAME_FEEL_HIT_STOP_HEAVY_S = 0.07;
+export declare const GAME_FEEL_HIT_STOP_SPECIAL_S = 0.1;
+export declare const GAME_FEEL_HIT_STOP_DEFAULT_S = 0.06;
+export type GameFeelEffectKind = GameEffectKind;
+export interface GameFeelEffectsPort {
+    spawn(kind: GameFeelEffectKind, position: GameVec3, options?: {
+        color?: string;
+        intensity?: number;
+        duration?: number;
+        radius?: number;
+        ownerId?: string;
+    }): GameEffectInstance;
+    update(dt: number): GameEffectsSnapshot;
+    snapshot(): GameEffectsSnapshot;
+    nodes(): readonly unknown[];
+    clear(): void;
+}
+export interface GameFeelOptions {
+    readonly effects?: GameFeelEffectsPort;
+    /** Per-update wall-clock budget in milliseconds. Default 2. */
+    readonly budgetMs?: number;
+    readonly enabled?: boolean;
+}
+export interface GameFeelReceipt {
+    readonly accepted: boolean;
+    readonly reason?: string;
+    readonly effectId?: string;
+}
+export interface GameFeelBudgetTelemetry {
+    readonly lastMs: number;
+    readonly maxMs: number;
+    readonly budgetMs: number;
+    readonly overBudget: boolean;
+    readonly overBudgetCount: number;
+    readonly updates: number;
+}
+export interface GameFeelSnapshot {
+    readonly kind: "aura-game-feel";
+    readonly enabled: boolean;
+    readonly timeScale: number;
+    readonly frozen: boolean;
+    readonly slowMoActive: boolean;
+    readonly hitStopActive: boolean;
+    readonly flashActive: boolean;
+    readonly lineIntensity: number;
+    readonly dustSpawned: number;
+    readonly effectsActive: number;
+    readonly effectsSpawned: number;
+    readonly budget: GameFeelBudgetTelemetry;
+}
+export interface GameFeel {
+    readonly effectsWired: boolean;
+    setEnabled(enabled: boolean): void;
+    slowMo(scale: number, durationMs: number): GameFeelReceipt;
+    hitStop(durationMs: number): GameFeelReceipt;
+    damageFlash(color: string, position?: GameVec3): GameFeelReceipt;
+    speedLines(intensity: number, position?: GameVec3): GameFeelReceipt;
+    landingDust(position: GameVec3): GameFeelReceipt;
+    /** Scaled frame delta: `dtMs * timeScale`. Routes step gameplay with this. */
+    effectiveDt(dtMs: number): number;
+    update(dtMs: number): GameFeelSnapshot;
+    snapshot(): GameFeelSnapshot;
+    nodes(): readonly unknown[];
+    clear(): void;
+}
+export declare function createGameFeel(options?: GameFeelOptions): GameFeel;
+/**
+ * Root-bridge namespace (wiring lives in `agent-api/index.ts`, owned by the
+ * bridge sibling — this object is the exact surface to expose as `gameFeel`).
+ */
+export declare const gameFeelBuilders: {
+    readonly create: typeof createGameFeel;
+    readonly hitStopDefaults: {
+        readonly light: 0.045;
+        readonly heavy: 0.07;
+        readonly special: 0.1;
+        readonly default: 0.06;
+    };
+};
+//# sourceMappingURL=GameFeel.d.ts.map

package/dist/engine/agent-api/GameFeel.d.ts.map

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