@codexo/exojs-physics 0.14.0 → 0.15.0

package/dist/esm/joints/PrismaticJoint.js

@@ -0,0 +1,241 @@
+import { applyInverseTransform, applyInverseRotation, applyRotation, applyTransform } from '../math.js';
+import { Joint } from './Joint.js';
+
+/** Reused output sink — physics steps single-threaded, so a shared scratch is safe. */
+const scratch = { x: 0, y: 0 };
+/**
+ * Constrains a body to **slide along a single axis** relative to another: the
+ * perpendicular translation and the relative rotation are locked (a 2×2 block);
+ * only translation along the axis is free, optionally driven by a motor and/or
+ * bounded by a translation limit. Solved in the sub-step loop, warm-started.
+ */
+class PrismaticJoint extends Joint {
+    /** When `true`, the motor drives the axis translation toward {@link motorSpeed}. */
+    enableMotor;
+    /** Target translation speed along the axis (px/s). */
+    motorSpeed;
+    /** Maximum motor force. */
+    maxMotorForce;
+    /** When `true`, the axis translation is constrained to `[lowerTranslation, upperTranslation]`. */
+    enableLimit;
+    /** Lower translation limit along the axis. */
+    lowerTranslation;
+    /** Upper translation limit along the axis. */
+    upperTranslation;
+    _localAnchorAx;
+    _localAnchorAy;
+    _localAnchorBx;
+    _localAnchorBy;
+    _localAxisAx;
+    _localAxisAy;
+    _referenceAngle;
+    _axisX = 1;
+    _axisY = 0;
+    _perpX = 0;
+    _perpY = 1;
+    _a1 = 0;
+    _a2 = 0;
+    _s1 = 0;
+    _s2 = 0;
+    _k11 = 0;
+    _k12 = 0;
+    _k22 = 0;
+    _cPerp = 0;
+    _cAngle = 0;
+    _translation = 0;
+    _axialMass = 0;
+    _h = 0;
+    _invH = 0;
+    _perpImpulse = 0;
+    _angularImpulse = 0;
+    _motorImpulse = 0;
+    _lowerImpulse = 0;
+    _upperImpulse = 0;
+    constructor(options) {
+        super(options.bodyA, options.bodyB);
+        applyInverseTransform(options.bodyA.transform, options.anchor.x, options.anchor.y, scratch);
+        this._localAnchorAx = scratch.x;
+        this._localAnchorAy = scratch.y;
+        applyInverseTransform(options.bodyB.transform, options.anchor.x, options.anchor.y, scratch);
+        this._localAnchorBx = scratch.x;
+        this._localAnchorBy = scratch.y;
+        const axisLength = Math.hypot(options.axis.x, options.axis.y) || 1;
+        applyInverseRotation(options.bodyA.transform, options.axis.x / axisLength, options.axis.y / axisLength, scratch);
+        this._localAxisAx = scratch.x;
+        this._localAxisAy = scratch.y;
+        this._referenceAngle = options.bodyB.angle - options.bodyA.angle;
+        this.enableMotor = options.enableMotor ?? false;
+        this.motorSpeed = options.motorSpeed ?? 0;
+        this.maxMotorForce = options.maxMotorForce ?? 0;
+        this.enableLimit = options.enableLimit ?? false;
+        this.lowerTranslation = options.lowerTranslation ?? 0;
+        this.upperTranslation = options.upperTranslation ?? 0;
+    }
+    _prepare(h) {
+        const bodyA = this.bodyA;
+        const bodyB = this.bodyB;
+        this._active = this.enabled && !bodyA.isSleeping && !bodyB.isSleeping && (bodyA.invMass > 0 || bodyB.invMass > 0);
+        if (!this._active) {
+            return;
+        }
+        // World axis + perpendicular (axis is local to body A).
+        applyRotation(bodyA.transform, this._localAxisAx, this._localAxisAy, scratch);
+        const axisX = scratch.x;
+        const axisY = scratch.y;
+        const perpX = -axisY;
+        const perpY = axisX;
+        this._axisX = axisX;
+        this._axisY = axisY;
+        this._perpX = perpX;
+        this._perpY = perpY;
+        applyTransform(bodyA.transform, this._localAnchorAx, this._localAnchorAy, scratch);
+        const pAx = scratch.x;
+        const pAy = scratch.y;
+        applyTransform(bodyB.transform, this._localAnchorBx, this._localAnchorBy, scratch);
+        const pBx = scratch.x;
+        const pBy = scratch.y;
+        const rAx = pAx - bodyA.worldCenterOfMassX;
+        const rAy = pAy - bodyA.worldCenterOfMassY;
+        const rBx = pBx - bodyB.worldCenterOfMassX;
+        const rBy = pBy - bodyB.worldCenterOfMassY;
+        const dx = pBx - pAx;
+        const dy = pBy - pAy;
+        // Jacobian cross terms for the axis (motor/limit) and the perpendicular (lock).
+        this._a1 = (dx + rAx) * axisY - (dy + rAy) * axisX;
+        this._a2 = rBx * axisY - rBy * axisX;
+        this._s1 = (dx + rAx) * perpY - (dy + rAy) * perpX;
+        this._s2 = rBx * perpY - rBy * perpX;
+        const mA = bodyA.invMass;
+        const mB = bodyB.invMass;
+        const iA = bodyA.invInertia;
+        const iB = bodyB.invInertia;
+        const kAxial = mA + mB + iA * this._a1 * this._a1 + iB * this._a2 * this._a2;
+        this._axialMass = kAxial > 0 ? 1 / kAxial : 0;
+        // Perpendicular + angular 2×2 block.
+        this._k11 = mA + mB + iA * this._s1 * this._s1 + iB * this._s2 * this._s2;
+        this._k12 = iA * this._s1 + iB * this._s2;
+        this._k22 = iA + iB;
+        if (this._k22 === 0) {
+            this._k22 = 1; // both bodies rotation-locked — keep the block invertible
+        }
+        this._cPerp = dx * perpX + dy * perpY;
+        this._cAngle = bodyB.angle - bodyA.angle - this._referenceAngle;
+        this._translation = dx * axisX + dy * axisY;
+        this._h = h;
+        this._invH = 1 / h;
+        if (!this.enableMotor) {
+            this._motorImpulse = 0;
+        }
+        if (!this.enableLimit) {
+            this._lowerImpulse = 0;
+            this._upperImpulse = 0;
+        }
+    }
+    _warmStart() {
+        if (!this._active) {
+            return;
+        }
+        const axial = this._motorImpulse + this._lowerImpulse - this._upperImpulse;
+        this._applyBlock(this._perpImpulse, this._angularImpulse);
+        this._applyAxial(axial);
+    }
+    _solve(useBias) {
+        if (!this._active) {
+            return;
+        }
+        const bodyA = this.bodyA;
+        const bodyB = this.bodyB;
+        // Motor along the axis.
+        if (this.enableMotor) {
+            const cdot = this._axisVelocity() - this.motorSpeed;
+            const max = this.maxMotorForce * this._h;
+            const old = this._motorImpulse;
+            this._motorImpulse = Math.min(max, Math.max(-max, old - this._axialMass * cdot));
+            this._applyAxial(this._motorImpulse - old);
+        }
+        // Translation limits along the axis.
+        if (this.enableLimit) {
+            // Lower limit (translation ≥ lowerTranslation): positive impulse pushes along +axis.
+            const cLower = this._translation - this.lowerTranslation;
+            let biasLower = 0;
+            if (cLower > 0) {
+                biasLower = cLower * this._invH;
+            }
+            else if (useBias) {
+                biasLower = 0.2 * this._invH * cLower;
+            }
+            const oldLower = this._lowerImpulse;
+            this._lowerImpulse = Math.max(0, oldLower - this._axialMass * (this._axisVelocity() + biasLower));
+            this._applyAxial(this._lowerImpulse - oldLower);
+            // Upper limit (translation ≤ upperTranslation): impulse pushes along −axis.
+            const cUpper = this.upperTranslation - this._translation;
+            let biasUpper = 0;
+            if (cUpper > 0) {
+                biasUpper = cUpper * this._invH;
+            }
+            else if (useBias) {
+                biasUpper = 0.2 * this._invH * cUpper;
+            }
+            const oldUpper = this._upperImpulse;
+            this._upperImpulse = Math.max(0, oldUpper - this._axialMass * (-this._axisVelocity() + biasUpper));
+            this._applyAxial(-(this._upperImpulse - oldUpper));
+        }
+        // Perpendicular + angular lock (2×2 block).
+        const cdotPerp = this._perpVelocity();
+        const cdotAngle = bodyB.angularVelocity - bodyA.angularVelocity;
+        const rhs1 = -(cdotPerp + (useBias ? 0.2 * this._invH * this._cPerp : 0));
+        const rhs2 = -(cdotAngle + (useBias ? 0.2 * this._invH * this._cAngle : 0));
+        const det = this._k11 * this._k22 - this._k12 * this._k12;
+        const invDet = det !== 0 ? 1 / det : 0;
+        const dPerp = invDet * (this._k22 * rhs1 - this._k12 * rhs2);
+        const dAngle = invDet * (-this._k12 * rhs1 + this._k11 * rhs2);
+        this._perpImpulse += dPerp;
+        this._angularImpulse += dAngle;
+        this._applyBlock(dPerp, dAngle);
+    }
+    /** Relative velocity projected onto the axis (plus the rotation cross terms). */
+    _axisVelocity() {
+        const bodyA = this.bodyA;
+        const bodyB = this.bodyB;
+        return (this._axisX * (bodyB.linearVelocityX - bodyA.linearVelocityX) +
+            this._axisY * (bodyB.linearVelocityY - bodyA.linearVelocityY) +
+            this._a2 * bodyB.angularVelocity -
+            this._a1 * bodyA.angularVelocity);
+    }
+    /** Relative velocity projected onto the perpendicular (plus the rotation cross terms). */
+    _perpVelocity() {
+        const bodyA = this.bodyA;
+        const bodyB = this.bodyB;
+        return (this._perpX * (bodyB.linearVelocityX - bodyA.linearVelocityX) +
+            this._perpY * (bodyB.linearVelocityY - bodyA.linearVelocityY) +
+            this._s2 * bodyB.angularVelocity -
+            this._s1 * bodyA.angularVelocity);
+    }
+    _applyAxial(impulse) {
+        const bodyA = this.bodyA;
+        const bodyB = this.bodyB;
+        const px = impulse * this._axisX;
+        const py = impulse * this._axisY;
+        bodyA.linearVelocityX -= bodyA.invMass * px;
+        bodyA.linearVelocityY -= bodyA.invMass * py;
+        bodyA.angularVelocity -= bodyA.invInertia * impulse * this._a1;
+        bodyB.linearVelocityX += bodyB.invMass * px;
+        bodyB.linearVelocityY += bodyB.invMass * py;
+        bodyB.angularVelocity += bodyB.invInertia * impulse * this._a2;
+    }
+    _applyBlock(perpImpulse, angularImpulse) {
+        const bodyA = this.bodyA;
+        const bodyB = this.bodyB;
+        const px = perpImpulse * this._perpX;
+        const py = perpImpulse * this._perpY;
+        bodyA.linearVelocityX -= bodyA.invMass * px;
+        bodyA.linearVelocityY -= bodyA.invMass * py;
+        bodyA.angularVelocity -= bodyA.invInertia * (perpImpulse * this._s1 + angularImpulse);
+        bodyB.linearVelocityX += bodyB.invMass * px;
+        bodyB.linearVelocityY += bodyB.invMass * py;
+        bodyB.angularVelocity += bodyB.invInertia * (perpImpulse * this._s2 + angularImpulse);
+    }
+}
+
+export { PrismaticJoint };
+//# sourceMappingURL=PrismaticJoint.js.map

package/dist/esm/joints/PrismaticJoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrismaticJoint.js","sources":["../../../../src/joints/PrismaticJoint.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/joints/RevoluteJoint.d.ts

@@ -0,0 +1,81 @@
+import type { PhysicsBody } from '../PhysicsBody';
+import type { VectorLike } from '../types';
+import { Joint } from './Joint';
+/** Construction options for a {@link RevoluteJoint}. */
+export interface RevoluteJointOptions {
+    /** First body (often a static anchor). */
+    bodyA: PhysicsBody;
+    /** Second body. */
+    bodyB: PhysicsBody;
+    /** Shared world-space pivot point at creation. The two bodies are pinned here and may rotate freely about it. */
+    anchor: VectorLike;
+    /** Soft-spring frequency in Hz; `0` (default) makes it a rigid pin. */
+    hertz?: number;
+    /** Soft-spring damping ratio (used when `hertz > 0`). Default `1`. */
+    dampingRatio?: number;
+    /** Enable the angular motor (drives `ωB − ωA` toward {@link motorSpeed}). Default `false`. */
+    enableMotor?: boolean;
+    /** Target relative angular velocity in rad/s when the motor is enabled. Default `0`. */
+    motorSpeed?: number;
+    /** Maximum motor torque — clamps the per-step motor impulse. Default `0`. */
+    maxMotorTorque?: number;
+    /** Enable the angle limit (keeps the relative angle in `[lowerAngle, upperAngle]`). Default `false`. */
+    enableLimit?: boolean;
+    /** Lower relative-angle limit in radians (relative to the angle at creation). Default `0`. */
+    lowerAngle?: number;
+    /** Upper relative-angle limit in radians. Default `0`. */
+    upperAngle?: number;
+}
+/**
+ * Pins a shared anchor point on two bodies (a hinge): the bodies may rotate
+ * freely about the pivot but the anchor points stay coincident. Solved as a
+ * 2-DOF point constraint (a 2×2 block) in the sub-step loop, warm-started.
+ */
+export declare class RevoluteJoint extends Joint {
+    /** Soft-spring frequency in Hz (`0` = rigid). */
+    hertz: number;
+    /** Soft-spring damping ratio. */
+    dampingRatio: number;
+    /** When `true`, the motor drives `ωB − ωA` toward {@link motorSpeed}. */
+    enableMotor: boolean;
+    /** Target relative angular velocity (rad/s) for the motor. */
+    motorSpeed: number;
+    /** Maximum motor torque. */
+    maxMotorTorque: number;
+    /** When `true`, the relative angle is constrained to `[lowerAngle, upperAngle]`. */
+    enableLimit: boolean;
+    /** Lower relative-angle limit (radians, relative to the creation angle). */
+    lowerAngle: number;
+    /** Upper relative-angle limit (radians). */
+    upperAngle: number;
+    private readonly _localAnchorAx;
+    private readonly _localAnchorAy;
+    private readonly _localAnchorBx;
+    private readonly _localAnchorBy;
+    private _rAx;
+    private _rAy;
+    private _rBx;
+    private _rBy;
+    private _cx;
+    private _cy;
+    private _invK11;
+    private _invK12;
+    private _invK22;
+    private _biasRate;
+    private _massScale;
+    private _impulseScale;
+    private _impulseX;
+    private _impulseY;
+    private readonly _referenceAngle;
+    private _axialMass;
+    private _h;
+    private _invH;
+    private _motorImpulse;
+    private _lowerImpulse;
+    private _upperImpulse;
+    constructor(options: RevoluteJointOptions);
+    _prepare(h: number): void;
+    _warmStart(): void;
+    _solve(useBias: boolean): void;
+    private _applyImpulse;
+}

package/dist/esm/joints/RevoluteJoint.js

@@ -0,0 +1,217 @@
+import { applyInverseTransform, applyTransform } from '../math.js';
+import { Joint } from './Joint.js';
+
+/** Reused output sink — physics steps single-threaded, so a shared scratch is safe. */
+const scratch = { x: 0, y: 0 };
+/**
+ * Pins a shared anchor point on two bodies (a hinge): the bodies may rotate
+ * freely about the pivot but the anchor points stay coincident. Solved as a
+ * 2-DOF point constraint (a 2×2 block) in the sub-step loop, warm-started.
+ */
+class RevoluteJoint extends Joint {
+    /** Soft-spring frequency in Hz (`0` = rigid). */
+    hertz;
+    /** Soft-spring damping ratio. */
+    dampingRatio;
+    /** When `true`, the motor drives `ωB − ωA` toward {@link motorSpeed}. */
+    enableMotor;
+    /** Target relative angular velocity (rad/s) for the motor. */
+    motorSpeed;
+    /** Maximum motor torque. */
+    maxMotorTorque;
+    /** When `true`, the relative angle is constrained to `[lowerAngle, upperAngle]`. */
+    enableLimit;
+    /** Lower relative-angle limit (radians, relative to the creation angle). */
+    lowerAngle;
+    /** Upper relative-angle limit (radians). */
+    upperAngle;
+    _localAnchorAx;
+    _localAnchorAy;
+    _localAnchorBx;
+    _localAnchorBy;
+    _rAx = 0;
+    _rAy = 0;
+    _rBx = 0;
+    _rBy = 0;
+    _cx = 0;
+    _cy = 0;
+    _invK11 = 0;
+    _invK12 = 0;
+    _invK22 = 0;
+    _biasRate = 0;
+    _massScale = 1;
+    _impulseScale = 0;
+    _impulseX = 0;
+    _impulseY = 0;
+    _referenceAngle;
+    _axialMass = 0;
+    _h = 0;
+    _invH = 0;
+    _motorImpulse = 0;
+    _lowerImpulse = 0;
+    _upperImpulse = 0;
+    constructor(options) {
+        super(options.bodyA, options.bodyB);
+        applyInverseTransform(options.bodyA.transform, options.anchor.x, options.anchor.y, scratch);
+        this._localAnchorAx = scratch.x;
+        this._localAnchorAy = scratch.y;
+        applyInverseTransform(options.bodyB.transform, options.anchor.x, options.anchor.y, scratch);
+        this._localAnchorBx = scratch.x;
+        this._localAnchorBy = scratch.y;
+        this.hertz = options.hertz ?? 0;
+        this.dampingRatio = options.dampingRatio ?? 1;
+        this.enableMotor = options.enableMotor ?? false;
+        this.motorSpeed = options.motorSpeed ?? 0;
+        this.maxMotorTorque = options.maxMotorTorque ?? 0;
+        this.enableLimit = options.enableLimit ?? false;
+        this.lowerAngle = options.lowerAngle ?? 0;
+        this.upperAngle = options.upperAngle ?? 0;
+        this._referenceAngle = options.bodyB.angle - options.bodyA.angle;
+    }
+    _prepare(h) {
+        const bodyA = this.bodyA;
+        const bodyB = this.bodyB;
+        this._active = this.enabled && !bodyA.isSleeping && !bodyB.isSleeping && (bodyA.invMass > 0 || bodyB.invMass > 0);
+        if (!this._active) {
+            return;
+        }
+        applyTransform(bodyA.transform, this._localAnchorAx, this._localAnchorAy, scratch);
+        const pAx = scratch.x;
+        const pAy = scratch.y;
+        applyTransform(bodyB.transform, this._localAnchorBx, this._localAnchorBy, scratch);
+        const pBx = scratch.x;
+        const pBy = scratch.y;
+        this._rAx = pAx - bodyA.worldCenterOfMassX;
+        this._rAy = pAy - bodyA.worldCenterOfMassY;
+        this._rBx = pBx - bodyB.worldCenterOfMassX;
+        this._rBy = pBy - bodyB.worldCenterOfMassY;
+        // Position error (the anchors should coincide).
+        this._cx = pBx - pAx;
+        this._cy = pBy - pAy;
+        const mA = bodyA.invMass;
+        const mB = bodyB.invMass;
+        const iA = bodyA.invInertia;
+        const iB = bodyB.invInertia;
+        // 2×2 effective-mass matrix K and its inverse.
+        const k11 = mA + mB + iA * this._rAy * this._rAy + iB * this._rBy * this._rBy;
+        const k12 = -iA * this._rAx * this._rAy - iB * this._rBx * this._rBy;
+        const k22 = mA + mB + iA * this._rAx * this._rAx + iB * this._rBx * this._rBx;
+        const det = k11 * k22 - k12 * k12;
+        const invDet = det !== 0 ? 1 / det : 0;
+        this._invK11 = invDet * k22;
+        this._invK12 = -invDet * k12;
+        this._invK22 = invDet * k11;
+        // Angular (motor/limit) effective mass + sub-step rate.
+        this._axialMass = iA + iB > 0 ? 1 / (iA + iB) : 0;
+        this._h = h;
+        this._invH = 1 / h;
+        if (!this.enableMotor) {
+            this._motorImpulse = 0;
+        }
+        if (!this.enableLimit) {
+            this._lowerImpulse = 0;
+            this._upperImpulse = 0;
+        }
+        if (this.hertz > 0) {
+            const omega = 2 * Math.PI * this.hertz;
+            const a1 = 2 * this.dampingRatio + h * omega;
+            const a2 = h * omega * a1;
+            const a3 = 1 / (1 + a2);
+            this._biasRate = omega / a1;
+            this._massScale = a2 * a3;
+            this._impulseScale = a3;
+        }
+        else {
+            this._biasRate = 0.2 / h;
+            this._massScale = 1;
+            this._impulseScale = 0;
+        }
+    }
+    _warmStart() {
+        if (!this._active) {
+            return;
+        }
+        // Angular warm-start: motor + limits (lower pushes +, upper pushes −).
+        const axial = this._motorImpulse + this._lowerImpulse - this._upperImpulse;
+        this.bodyA.angularVelocity -= this.bodyA.invInertia * axial;
+        this.bodyB.angularVelocity += this.bodyB.invInertia * axial;
+        this._applyImpulse(this._impulseX, this._impulseY);
+    }
+    _solve(useBias) {
+        if (!this._active) {
+            return;
+        }
+        const bodyA = this.bodyA;
+        const bodyB = this.bodyB;
+        const iA = bodyA.invInertia;
+        const iB = bodyB.invInertia;
+        // Angular motor: drive ωB − ωA toward motorSpeed, clamped to ±maxMotorTorque·h.
+        if (this.enableMotor) {
+            const cdot = bodyB.angularVelocity - bodyA.angularVelocity - this.motorSpeed;
+            const max = this.maxMotorTorque * this._h;
+            const old = this._motorImpulse;
+            this._motorImpulse = Math.min(max, Math.max(-max, old - this._axialMass * cdot));
+            const applied = this._motorImpulse - old;
+            bodyA.angularVelocity -= iA * applied;
+            bodyB.angularVelocity += iB * applied;
+        }
+        // Angle limits: one-sided constraints keeping the relative angle in [lower, upper].
+        if (this.enableLimit) {
+            const angle = bodyB.angle + bodyB._deltaAngle - (bodyA.angle + bodyA._deltaAngle) - this._referenceAngle;
+            // Lower limit (angle ≥ lowerAngle): a positive impulse increases the angle.
+            const cLower = angle - this.lowerAngle;
+            let biasLower = 0;
+            if (cLower > 0) {
+                biasLower = cLower * this._invH; // speculative: allow approach, engage at the surface
+            }
+            else if (useBias) {
+                biasLower = 0.2 * this._invH * cLower; // Baumgarte push-back when violated
+            }
+            const oldLower = this._lowerImpulse;
+            this._lowerImpulse = Math.max(0, oldLower - this._axialMass * (bodyB.angularVelocity - bodyA.angularVelocity + biasLower));
+            const appliedLower = this._lowerImpulse - oldLower;
+            bodyA.angularVelocity -= iA * appliedLower;
+            bodyB.angularVelocity += iB * appliedLower;
+            // Upper limit (angle ≤ upperAngle): a positive impulse decreases the angle.
+            const cUpper = this.upperAngle - angle;
+            let biasUpper = 0;
+            if (cUpper > 0) {
+                biasUpper = cUpper * this._invH;
+            }
+            else if (useBias) {
+                biasUpper = 0.2 * this._invH * cUpper;
+            }
+            const oldUpper = this._upperImpulse;
+            this._upperImpulse = Math.max(0, oldUpper - this._axialMass * (bodyA.angularVelocity - bodyB.angularVelocity + biasUpper));
+            const appliedUpper = this._upperImpulse - oldUpper;
+            bodyA.angularVelocity += iA * appliedUpper;
+            bodyB.angularVelocity -= iB * appliedUpper;
+        }
+        // Relative velocity of the anchors.
+        const cdotX = bodyB.linearVelocityX - bodyB.angularVelocity * this._rBy - (bodyA.linearVelocityX - bodyA.angularVelocity * this._rAy);
+        const cdotY = bodyB.linearVelocityY + bodyB.angularVelocity * this._rBx - (bodyA.linearVelocityY + bodyA.angularVelocity * this._rAx);
+        const rhsX = cdotX + (useBias ? this._biasRate * this._cx : 0);
+        const rhsY = cdotY + (useBias ? this._biasRate * this._cy : 0);
+        // Solve K·λ = −rhs, then apply the soft mass/impulse scaling.
+        const solvedX = this._invK11 * rhsX + this._invK12 * rhsY;
+        const solvedY = this._invK12 * rhsX + this._invK22 * rhsY;
+        const impulseX = -this._massScale * solvedX - this._impulseScale * this._impulseX;
+        const impulseY = -this._massScale * solvedY - this._impulseScale * this._impulseY;
+        this._impulseX += impulseX;
+        this._impulseY += impulseY;
+        this._applyImpulse(impulseX, impulseY);
+    }
+    _applyImpulse(jx, jy) {
+        const bodyA = this.bodyA;
+        const bodyB = this.bodyB;
+        bodyA.linearVelocityX -= bodyA.invMass * jx;
+        bodyA.linearVelocityY -= bodyA.invMass * jy;
+        bodyA.angularVelocity -= bodyA.invInertia * (this._rAx * jy - this._rAy * jx);
+        bodyB.linearVelocityX += bodyB.invMass * jx;
+        bodyB.linearVelocityY += bodyB.invMass * jy;
+        bodyB.angularVelocity += bodyB.invInertia * (this._rBx * jy - this._rBy * jx);
+    }
+}
+
+export { RevoluteJoint };
+//# sourceMappingURL=RevoluteJoint.js.map

package/dist/esm/joints/RevoluteJoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RevoluteJoint.js","sources":["../../../../src/joints/RevoluteJoint.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/joints/WeldJoint.d.ts

@@ -0,0 +1,61 @@
+import type { PhysicsBody } from '../PhysicsBody';
+import type { VectorLike } from '../types';
+import { Joint } from './Joint';
+/** Construction options for a {@link WeldJoint}. */
+export interface WeldJointOptions {
+    /** First body. */
+    bodyA: PhysicsBody;
+    /** Second body. */
+    bodyB: PhysicsBody;
+    /** World-space anchor the linear constraint acts at. Default: the midpoint of the two bodies. */
+    anchor?: VectorLike;
+    /** Locked relative angle `angleB − angleA`. Default: the current relative angle at creation. */
+    referenceAngle?: number;
+    /** Soft frequency (Hz) for the position lock; `0` (default) is rigid. */
+    linearHertz?: number;
+    /** Soft frequency (Hz) for the angle lock; `0` (default) is rigid. */
+    angularHertz?: number;
+    /** Soft damping ratio (used when a hertz is `> 0`). Default `1`. */
+    dampingRatio?: number;
+}
+/**
+ * Rigidly fixes the relative position and orientation of two bodies (they move
+ * as one rigid body). A 2-DOF point constraint (like {@link RevoluteJoint}) plus
+ * a 1-DOF angular constraint, solved in the sub-step loop. Both locks default to
+ * rigid; set `linearHertz`/`angularHertz` for a springy weld.
+ */
+export declare class WeldJoint extends Joint {
+    /** Locked relative angle `angleB − angleA`. */
+    referenceAngle: number;
+    /** Soft frequency for the position lock (`0` = rigid). */
+    linearHertz: number;
+    /** Soft frequency for the angle lock (`0` = rigid). */
+    angularHertz: number;
+    /** Soft damping ratio. */
+    dampingRatio: number;
+    private readonly _localAnchorAx;
+    private readonly _localAnchorAy;
+    private readonly _localAnchorBx;
+    private readonly _localAnchorBy;
+    private _rAx;
+    private _rAy;
+    private _rBx;
+    private _rBy;
+    private _cx;
+    private _cy;
+    private _invK11;
+    private _invK12;
+    private _invK22;
+    private _angleError;
+    private _effMassAngle;
+    private readonly _linear;
+    private readonly _angular;
+    private _impulseX;
+    private _impulseY;
+    private _impulseAngle;
+    constructor(options: WeldJointOptions);
+    _prepare(h: number): void;
+    _warmStart(): void;
+    _solve(useBias: boolean): void;
+    private _applyLinearImpulse;
+}