@series-inc/rundot-syncplay 5.23.0-beta.7 → 5.23.0

package/dist/physics3d-joints.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Impulse-level joint constraints for the deterministic rigid-body solver:
+ * ball (point-to-point), hinge (axis + limits + motor), weld, distance (rope),
+ * and grab (world-target point motor — the gravity-gun/carry primitive). Each
+ * joint is solved as accumulated impulses inside the solver's iteration loop
+ * via the `SolverJointSolve` interface; hinge angle and warm-start impulses live
+ * in the canonical joint cache.
+ *
+ * Angles (hinge `minAngle`/`maxAngle`/`motorSpeed`) are in radians / radians per
+ * tick — natural units for the radian-valued angular velocity the solver
+ * integrates.
+ */
+import { Point3D } from './physics3d-shared.js';
+import type { SolverJointCacheEntry, SolverJointSolve } from './physics3d-solver.js';
+export type DeterministicPhysicsJoint3D = {
+    readonly id: string;
+    readonly type: 'ball';
+    readonly a: string;
+    readonly b: string;
+    readonly anchorA: Point3D;
+    readonly anchorB: Point3D;
+    readonly breakImpulse?: number;
+    readonly disableCollision?: boolean;
+} | {
+    readonly id: string;
+    readonly type: 'hinge';
+    readonly a: string;
+    readonly b: string;
+    readonly anchorA: Point3D;
+    readonly anchorB: Point3D;
+    readonly axisA: Point3D;
+    readonly minAngle?: number;
+    readonly maxAngle?: number;
+    readonly motorSpeed?: number;
+    readonly maxMotorTorque?: number;
+    readonly breakImpulse?: number;
+    readonly disableCollision?: boolean;
+} | {
+    readonly id: string;
+    readonly type: 'weld';
+    readonly a: string;
+    readonly b: string;
+    readonly anchorA: Point3D;
+    readonly anchorB: Point3D;
+    readonly breakImpulse?: number;
+    readonly disableCollision?: boolean;
+} | {
+    readonly id: string;
+    readonly type: 'distance';
+    readonly a: string;
+    readonly b: string;
+    readonly anchorA: Point3D;
+    readonly anchorB: Point3D;
+    readonly minLength?: number;
+    readonly maxLength: number;
+    readonly breakImpulse?: number;
+    readonly disableCollision?: boolean;
+} | {
+    readonly id: string;
+    readonly type: 'prismatic';
+    readonly a: string;
+    readonly b: string;
+    readonly anchorA: Point3D;
+    readonly anchorB: Point3D;
+    readonly axisA: Point3D;
+    readonly minTranslation?: number;
+    readonly maxTranslation?: number;
+    readonly motorSpeed?: number;
+    readonly maxMotorForce?: number;
+    readonly breakImpulse?: number;
+    readonly disableCollision?: boolean;
+} | {
+    readonly id: string;
+    readonly type: 'spring';
+    readonly a: string;
+    readonly b: string;
+    readonly anchorA: Point3D;
+    readonly anchorB: Point3D;
+    readonly restLength: number;
+    readonly frequencyHz: number;
+    readonly dampingRatio: number;
+} | {
+    readonly id: string;
+    readonly type: 'grab';
+    readonly body: string;
+    readonly anchor: Point3D;
+    readonly targetX: number;
+    readonly targetY: number;
+    readonly targetZ: number;
+    readonly maxForce: number;
+    readonly damping?: number;
+};
+/** Build solver joint objects from joint definitions, seeded from the joint cache. */
+export declare function createSolverJoints(joints: readonly DeterministicPhysicsJoint3D[], indexById: Map<string, number>, jointCache: readonly SolverJointCacheEntry[]): SolverJointSolve[];