@aura3d/physics 1.5.1 → 2.0.0

package/dist/ArcadeCharacterController.d.ts

@@ -0,0 +1,53 @@
+import type { Collider } from "./Collider.js";
+import { KinematicBody } from "./KinematicBody.js";
+import type { PhysicsWorld } from "./PhysicsWorld.js";
+import type { RigidBody } from "./RigidBody.js";
+import { type Vec3 } from "./Shape.js";
+export interface ArcadeCharacterControllerDescriptor {
+    readonly position?: Vec3;
+    readonly radius?: number;
+    readonly halfHeight?: number;
+    readonly maxSpeed?: number;
+    readonly acceleration?: number;
+    readonly jumpSpeed?: number;
+    readonly gravity?: number;
+    readonly groundY?: number;
+}
+export interface ArcadeCharacterControllerState {
+    readonly grounded: boolean;
+    readonly groundNormal: Vec3;
+    readonly groundColliderId: number | null;
+    readonly desiredVelocity: Vec3;
+    readonly velocity: Vec3;
+    readonly speed: number;
+    readonly jumpedThisFrame: boolean;
+}
+/**
+ * Authored-unit deterministic movement with a kinematic trigger proxy.
+ *
+ * This is deliberately not a rigid-body character controller. Physical slope,
+ * step, contact, and depenetration ownership belongs to the selected optional
+ * Rapier adapter. The proxy exists so arcade routes can reuse trigger/raycast
+ * plumbing without importing or pretending to be physical simulation.
+ */
+export declare class ArcadeCharacterController {
+    #private;
+    readonly body: RigidBody;
+    readonly collider: Collider;
+    readonly radius: number;
+    readonly halfHeight: number;
+    readonly maxSpeed: number;
+    readonly acceleration: number;
+    readonly jumpSpeed: number;
+    readonly motion: KinematicBody;
+    constructor(world: PhysicsWorld, descriptor?: ArcadeCharacterControllerDescriptor);
+    setMoveInput(input: {
+        readonly x: number;
+        readonly z?: number;
+    }): void;
+    jump(): void;
+    teleport(position: Vec3): void;
+    step(dt: number): ArcadeCharacterControllerState;
+    snapshot(): ArcadeCharacterControllerState;
+}
+//# sourceMappingURL=ArcadeCharacterController.d.ts.map

package/dist/ArcadeCharacterController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArcadeCharacterController.d.ts","sourceRoot":"","sources":["../../../../packages/physics/src/ArcadeCharacterController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,aAAa,EAA8B,MAAM,oBAAoB,CAAC;AAC/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAS,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,IAAI,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,qBAAa,yBAAyB;;IACpC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;gBAGnB,KAAK,EAAE,YAAY,EAAE,UAAU,GAAE,mCAAwC;IA4BrF,YAAY,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAItE,IAAI,IAAI,IAAI;IAKZ,QAAQ,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI;IAQ9B,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,8BAA8B;IAShD,QAAQ,IAAI,8BAA8B;CAQ3C"}

package/dist/ArcadeCharacterController.js

@@ -0,0 +1,98 @@
+import { KinematicBody } from "./KinematicBody.js";
+import { Shape } from "./Shape.js";
+/**
+ * Authored-unit deterministic movement with a kinematic trigger proxy.
+ *
+ * This is deliberately not a rigid-body character controller. Physical slope,
+ * step, contact, and depenetration ownership belongs to the selected optional
+ * Rapier adapter. The proxy exists so arcade routes can reuse trigger/raycast
+ * plumbing without importing or pretending to be physical simulation.
+ */
+export class ArcadeCharacterController {
+    body;
+    collider;
+    radius;
+    halfHeight;
+    maxSpeed;
+    acceleration;
+    jumpSpeed;
+    motion;
+    #jumpQueued = false;
+    constructor(world, descriptor = {}) {
+        this.radius = positive(descriptor.radius ?? 0.24, "arcade character radius");
+        this.halfHeight = positive(descriptor.halfHeight ?? 0.38, "arcade character halfHeight");
+        this.maxSpeed = positive(descriptor.maxSpeed ?? 3.5, "arcade character maxSpeed");
+        this.acceleration = positive(descriptor.acceleration ?? 32, "arcade character acceleration");
+        this.jumpSpeed = positive(descriptor.jumpSpeed ?? 4.2, "arcade character jumpSpeed");
+        const position = descriptor.position ?? [0, this.halfHeight + this.radius, 0];
+        const groundY = descriptor.groundY ?? position[1] - this.halfHeight - this.radius;
+        this.motion = new KinematicBody({
+            id: "arcade-character",
+            position,
+            halfExtents: [this.radius, this.halfHeight + this.radius, this.radius],
+            maxSpeed: this.maxSpeed,
+            acceleration: this.acceleration,
+            airAcceleration: this.acceleration * 0.65,
+            jumpSpeed: this.jumpSpeed,
+            gravity: descriptor.gravity ?? 9.81,
+            groundY,
+            groundSnapDistance: 0.08,
+            lockDepth: false
+        });
+        this.body = world.createRigidBody({ type: "kinematic", position });
+        this.collider = world.createCollider(this.body, {
+            shape: Shape.capsule(this.radius, this.halfHeight),
+            sensor: true
+        });
+    }
+    setMoveInput(input) {
+        this.motion.setMoveInput({ x: finiteOrZero(input.x), z: finiteOrZero(input.z ?? 0) });
+    }
+    jump() {
+        this.#jumpQueued = true;
+        this.motion.jump();
+    }
+    teleport(position) {
+        this.motion.position = [...position];
+        this.motion.previousPosition = [...position];
+        this.motion.velocity = [0, 0, 0];
+        this.motion.grounded = false;
+        this.#syncProxy();
+    }
+    step(dt) {
+        const events = this.motion.step(dt);
+        this.#syncProxy();
+        const snapshot = this.motion.snapshot();
+        const jumpedThisFrame = this.#jumpQueued && events.some((event) => event.type === "jump");
+        this.#jumpQueued = false;
+        return stateFromSnapshot(snapshot, jumpedThisFrame);
+    }
+    snapshot() {
+        return stateFromSnapshot(this.motion.snapshot(), false);
+    }
+    #syncProxy() {
+        this.body.setPosition(this.motion.position);
+        this.body.setVelocity([0, 0, 0]);
+    }
+}
+function stateFromSnapshot(snapshot, jumpedThisFrame) {
+    const speed = Math.hypot(snapshot.velocity[0], snapshot.velocity[2]);
+    return {
+        grounded: snapshot.grounded,
+        groundNormal: [0, 1, 0],
+        groundColliderId: null,
+        desiredVelocity: [snapshot.moveInput[0] * speed, snapshot.velocity[1], snapshot.moveInput[2] * speed],
+        velocity: snapshot.velocity,
+        speed,
+        jumpedThisFrame
+    };
+}
+function positive(value, label) {
+    if (!Number.isFinite(value) || value <= 0)
+        throw new RangeError(`${label} must be finite and positive.`);
+    return value;
+}
+function finiteOrZero(value) {
+    return Number.isFinite(value) ? value : 0;
+}
+//# sourceMappingURL=ArcadeCharacterController.js.map

package/dist/ArcadeCharacterController.js.map

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

package/dist/ArcadeVehicleTelemetry.d.ts

@@ -0,0 +1,162 @@
+export interface ArcadeVehicleTelemetryInput {
+    readonly elapsedSeconds: number;
+    readonly throttle?: number;
+    readonly brake?: number;
+    readonly steer?: number;
+    readonly handbrake?: boolean;
+    readonly nitro?: boolean;
+    readonly maxSpeedKph?: number;
+    readonly acceleration?: number;
+    readonly brakeForce?: number;
+    readonly gripFactor?: number;
+    readonly driftFactor?: number;
+}
+export interface ArcadeVehicleTelemetrySample {
+    readonly speedKph: number;
+    readonly rpm: number;
+    readonly nitro: number;
+    readonly steerAngle: number;
+    readonly driftSlip: number;
+    readonly grip: number;
+    readonly wheelSpin: number;
+    readonly suspensionCompression: readonly [number, number, number, number];
+}
+export type PacejkaTirePreset = "street" | "sport" | "racing" | "offroad";
+export type RacingAiDifficulty = "easy" | "medium" | "hard";
+export type DrivetrainDifferential = "open" | "limited-slip" | "locked" | "electronic";
+export interface PacejkaTireCoefficients {
+    readonly b: number;
+    readonly c: number;
+    readonly d: number;
+    readonly e: number;
+}
+export interface PacejkaTireForceInput {
+    readonly longitudinalVelocity: number;
+    readonly lateralVelocity?: number;
+    readonly angularVelocity: number;
+    readonly normalForce: number;
+    readonly steeringAngle?: number;
+    readonly camberAngle?: number;
+    readonly radius?: number;
+    readonly width?: number;
+    readonly maxLoad?: number;
+    readonly loadSensitivity?: number;
+    readonly rollingResistance?: number;
+    readonly longitudinal?: PacejkaTireCoefficients | PacejkaTirePreset;
+    readonly lateral?: PacejkaTireCoefficients | PacejkaTirePreset;
+}
+export interface PacejkaTireForceSample {
+    readonly longitudinalForce: number;
+    readonly lateralForce: number;
+    readonly combinedForce: number;
+    readonly slipRatio: number;
+    readonly slipAngle: number;
+    readonly aligningTorque: number;
+    readonly optimalSlipRatio: number;
+    readonly optimalSlipAngle: number;
+    readonly preset: {
+        readonly longitudinal: PacejkaTirePreset | "custom";
+        readonly lateral: PacejkaTirePreset | "custom";
+    };
+}
+export interface RacingAiDriverInput {
+    readonly difficulty?: RacingAiDifficulty;
+    readonly elapsedSeconds: number;
+    readonly progress: number;
+    readonly speedKph: number;
+    readonly targetSpeedKph?: number;
+    readonly trackCurvature?: number;
+    readonly opponentDistance?: number;
+    readonly opponentAhead?: boolean;
+    readonly playerGapSeconds?: number;
+}
+export interface RacingAiDriverSample {
+    readonly difficulty: RacingAiDifficulty;
+    readonly throttle: number;
+    readonly brake: number;
+    readonly steer: number;
+    readonly targetSpeedKph: number;
+    readonly lookaheadDistance: number;
+    readonly reactionTime: number;
+    readonly aggressiveness: number;
+    readonly overtaking: boolean;
+    readonly overtakeOffset: number;
+    readonly rubberbandBoost: number;
+}
+export interface VehicleDrivetrainInput {
+    readonly speedKph: number;
+    readonly throttle?: number;
+    readonly clutch?: number;
+    readonly gearRatios?: readonly number[];
+    readonly finalDriveRatio?: number;
+    readonly idleRpm?: number;
+    readonly maxRpm?: number;
+    readonly peakTorque?: number;
+    readonly peakTorqueRpm?: number;
+    readonly upshiftRpm?: number;
+    readonly downshiftRpm?: number;
+    readonly differential?: DrivetrainDifferential;
+    readonly frontRearSplit?: number;
+    readonly lockingFactor?: number;
+    readonly dragCoefficient?: number;
+    readonly frontalArea?: number;
+    readonly downforceCoefficient?: number;
+}
+export interface VehicleDrivetrainSample {
+    readonly gear: number;
+    readonly gearRatio: number;
+    readonly engineRpm: number;
+    readonly engineTorque: number;
+    readonly wheelTorque: number;
+    readonly frontTorque: number;
+    readonly rearTorque: number;
+    readonly dragForce: number;
+    readonly downforce: number;
+    readonly shiftState: "hold" | "upshift" | "downshift";
+    readonly differential: DrivetrainDifferential;
+}
+export interface VehicleEffectEmitterInput {
+    readonly speedKph: number;
+    readonly throttle?: number;
+    readonly steer?: number;
+    readonly handbrake?: boolean;
+    readonly nitroActive?: boolean;
+    readonly wheelOnGround?: readonly [boolean, boolean, boolean, boolean];
+}
+export interface VehicleEffectEmitterSample {
+    readonly tireSmokeRates: readonly [number, number, number, number];
+    readonly totalTireSmokeRate: number;
+    readonly nitroFlameRate: number;
+    readonly visibleEffectEmitters: number;
+    readonly smokeReason: "none" | "handbrake" | "launch-wheelspin" | "high-speed-steer";
+}
+export interface VehicleDamageInput {
+    readonly health?: number;
+    readonly impactSpeedKph?: number;
+    readonly collisionSeverity?: number;
+    readonly repair?: number;
+}
+export interface VehicleDamageSample {
+    readonly health: number;
+    readonly damage: number;
+    readonly impactDamage: number;
+    readonly visualDamageLevel: "none" | "scratched" | "dented" | "critical";
+    readonly disabled: boolean;
+}
+export declare function sampleArcadeVehicleTelemetry(input: ArcadeVehicleTelemetryInput): ArcadeVehicleTelemetrySample;
+export declare function sampleVehicleDamage(input: VehicleDamageInput): VehicleDamageSample;
+export declare function sampleVehicleEffectEmitters(input: VehicleEffectEmitterInput): VehicleEffectEmitterSample;
+export declare function sampleVehicleDrivetrain(input: VehicleDrivetrainInput): VehicleDrivetrainSample;
+export declare function sampleRacingAiDriver(input: RacingAiDriverInput): RacingAiDriverSample;
+/**
+ * Peak lateral cornering stiffness of a tyre preset, per newton of vertical load.
+ *
+ * This is the initial slope of the Magic Formula lateral curve, `d * c * b`, in units of
+ * force per radian of slip per newton of load. An integrator needs it to size a stable
+ * timestep: the tyre is the stiffest spring in a vehicle model, so it sets the step, and
+ * assuming a fixed 1/60 s regardless of tyre, mass and wheelbase is what let the vehicle
+ * integrator go unstable and produce yaw opposing its own steering input.
+ */
+export declare function tirePeakCorneringStiffness(tire: PacejkaTireCoefficients | PacejkaTirePreset): number;
+export declare function samplePacejkaTireForces(input: PacejkaTireForceInput): PacejkaTireForceSample;
+//# sourceMappingURL=ArcadeVehicleTelemetry.d.ts.map

package/dist/ArcadeVehicleTelemetry.d.ts.map

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