@triforge/physics-core 0.1.0

package/dist/collision/PlaneCollider.d.ts

@@ -0,0 +1,30 @@
+import { BaseCollider } from './BaseCollider.js';
+/**
+ * PlaneCollider — infinite flat plane collider.
+ * Blender: Collision object with a flat plane mesh.
+ *
+ * The plane is defined by a point on it and a normal vector.
+ * Default: ground plane at Y=0, normal pointing up.
+ */
+export declare class PlaneCollider extends BaseCollider {
+    readonly colliderType = "PlaneCollider";
+    parameters: {
+        /** Point on the plane (Y component used for horizontal planes). */
+        pointX: number;
+        pointY: number;
+        pointZ: number;
+        /** Normal direction (should be unit length). */
+        normalX: number;
+        normalY: number;
+        normalZ: number;
+        /** Friction coefficient [0, 1]. 0 = frictionless, 1 = full stop. */
+        friction: number;
+    };
+    constructor(opts?: {
+        point?: [number, number, number];
+        normal?: [number, number, number];
+        friction?: number;
+    });
+    resolve(px: number, py: number, pz: number): [number, number, number] | null;
+}
+//# sourceMappingURL=PlaneCollider.d.ts.map

package/dist/collision/PlaneCollider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaneCollider.d.ts","sourceRoot":"","sources":["../../src/collision/PlaneCollider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAC7C,QAAQ,CAAC,YAAY,mBAAkB;IAEvC,UAAU,EAAE;QACV,mEAAmE;QACnE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;QAC9C,gDAAgD;QAChD,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;QACjD,oEAAoE;QACpE,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAA;gBAEW,IAAI,GAAE;QAChB,KAAK,CAAC,EAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;QACjC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;QACjC,QAAQ,CAAC,EAAE,MAAM,CAAA;KACb;IAWN,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;CAgB7E"}

package/dist/collision/PlaneCollider.js

@@ -0,0 +1,38 @@
+import { BaseCollider } from './BaseCollider.js';
+/**
+ * PlaneCollider — infinite flat plane collider.
+ * Blender: Collision object with a flat plane mesh.
+ *
+ * The plane is defined by a point on it and a normal vector.
+ * Default: ground plane at Y=0, normal pointing up.
+ */
+export class PlaneCollider extends BaseCollider {
+    constructor(opts = {}) {
+        super();
+        this.colliderType = 'PlaneCollider';
+        const p = opts.point ?? [0, 0, 0];
+        const n = opts.normal ?? [0, 1, 0];
+        this.parameters = {
+            pointX: p[0], pointY: p[1], pointZ: p[2],
+            normalX: n[0], normalY: n[1], normalZ: n[2],
+            friction: opts.friction ?? 0.1,
+        };
+    }
+    resolve(px, py, pz) {
+        if (!this.enabled)
+            return null;
+        const { pointX, pointY, pointZ, normalX, normalY, normalZ } = this.parameters;
+        // Signed distance from plane
+        const dx = px - pointX, dy = py - pointY, dz = pz - pointZ;
+        const dist = dx * normalX + dy * normalY + dz * normalZ;
+        if (dist >= 0)
+            return null; // above plane — no collision
+        // Push back to plane surface
+        return [
+            px - normalX * dist,
+            py - normalY * dist,
+            pz - normalZ * dist,
+        ];
+    }
+}
+//# sourceMappingURL=PlaneCollider.js.map

package/dist/collision/PlaneCollider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaneCollider.js","sourceRoot":"","sources":["../../src/collision/PlaneCollider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD;;;;;;GAMG;AACH,MAAM,OAAO,aAAc,SAAQ,YAAY;IAY7C,YAAY,OAIR,EAAE;QACJ,KAAK,EAAE,CAAA;QAhBA,iBAAY,GAAG,eAAe,CAAA;QAiBrC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,IAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;QAClC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;QAClC,IAAI,CAAC,UAAU,GAAG;YAChB,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAG,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAG,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;YAC1C,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YAC3C,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,GAAG;SAC/B,CAAA;IACH,CAAC;IAED,OAAO,CAAC,EAAU,EAAE,EAAU,EAAE,EAAU;QACxC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAA;QAC9B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,UAAU,CAAA;QAC7E,6BAA6B;QAC7B,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,MAAM,CAAA;QAC1D,MAAM,IAAI,GAAG,EAAE,GAAG,OAAO,GAAG,EAAE,GAAG,OAAO,GAAG,EAAE,GAAG,OAAO,CAAA;QAEvD,IAAI,IAAI,IAAI,CAAC;YAAE,OAAO,IAAI,CAAA,CAAE,6BAA6B;QAEzD,6BAA6B;QAC7B,OAAO;YACL,EAAE,GAAG,OAAO,GAAG,IAAI;YACnB,EAAE,GAAG,OAAO,GAAG,IAAI;YACnB,EAAE,GAAG,OAAO,GAAG,IAAI;SACpB,CAAA;IACH,CAAC;CACF"}

package/dist/collision/SphereCollider.d.ts

@@ -0,0 +1,25 @@
+import { BaseCollider } from './BaseCollider.js';
+/**
+ * SphereCollider — sphere-shaped collider.
+ * Blender: Collision modifier on a sphere mesh object.
+ *
+ * Cloth particles are pushed to the sphere surface when inside.
+ */
+export declare class SphereCollider extends BaseCollider {
+    readonly colliderType = "SphereCollider";
+    parameters: {
+        centerX: number;
+        centerY: number;
+        centerZ: number;
+        radius: number;
+        /** Friction coefficient [0, 1]. */
+        friction: number;
+    };
+    constructor(opts?: {
+        center?: [number, number, number];
+        radius?: number;
+        friction?: number;
+    });
+    resolve(px: number, py: number, pz: number): [number, number, number] | null;
+}
+//# sourceMappingURL=SphereCollider.d.ts.map

package/dist/collision/SphereCollider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SphereCollider.d.ts","sourceRoot":"","sources":["../../src/collision/SphereCollider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,QAAQ,CAAC,YAAY,oBAAmB;IAExC,UAAU,EAAE;QACV,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;QACjD,MAAM,EAAE,MAAM,CAAA;QACd,mCAAmC;QACnC,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAA;gBAEW,IAAI,GAAE;QAChB,MAAM,CAAC,EAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;QAClC,MAAM,CAAC,EAAG,MAAM,CAAA;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;KACb;IAUN,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;CAgB7E"}

package/dist/collision/SphereCollider.js

@@ -0,0 +1,36 @@
+import { BaseCollider } from './BaseCollider.js';
+/**
+ * SphereCollider — sphere-shaped collider.
+ * Blender: Collision modifier on a sphere mesh object.
+ *
+ * Cloth particles are pushed to the sphere surface when inside.
+ */
+export class SphereCollider extends BaseCollider {
+    constructor(opts = {}) {
+        super();
+        this.colliderType = 'SphereCollider';
+        const c = opts.center ?? [0, 0, 0];
+        this.parameters = {
+            centerX: c[0], centerY: c[1], centerZ: c[2],
+            radius: opts.radius ?? 1,
+            friction: opts.friction ?? 0.1,
+        };
+    }
+    resolve(px, py, pz) {
+        if (!this.enabled)
+            return null;
+        const { centerX, centerY, centerZ, radius } = this.parameters;
+        const dx = px - centerX, dy = py - centerY, dz = pz - centerZ;
+        const d2 = dx * dx + dy * dy + dz * dz;
+        if (d2 >= radius * radius)
+            return null; // outside sphere
+        const d = Math.sqrt(d2) || 1e-6;
+        const inv = radius / d;
+        return [
+            centerX + dx * inv,
+            centerY + dy * inv,
+            centerZ + dz * inv,
+        ];
+    }
+}
+//# sourceMappingURL=SphereCollider.js.map

package/dist/collision/SphereCollider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SphereCollider.js","sourceRoot":"","sources":["../../src/collision/SphereCollider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD;;;;;GAKG;AACH,MAAM,OAAO,cAAe,SAAQ,YAAY;IAU9C,YAAY,OAIR,EAAE;QACJ,KAAK,EAAE,CAAA;QAdA,iBAAY,GAAG,gBAAgB,CAAA;QAetC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;QAClC,IAAI,CAAC,UAAU,GAAG;YAChB,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YAC3C,MAAM,EAAG,IAAI,CAAC,MAAM,IAAK,CAAC;YAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,GAAG;SAC/B,CAAA;IACH,CAAC;IAED,OAAO,CAAC,EAAU,EAAE,EAAU,EAAE,EAAU;QACxC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAA;QAC9B,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAA;QAC7D,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,OAAO,CAAA;QAC7D,MAAM,EAAE,GAAG,EAAE,GAAC,EAAE,GAAG,EAAE,GAAC,EAAE,GAAG,EAAE,GAAC,EAAE,CAAA;QAEhC,IAAI,EAAE,IAAI,MAAM,GAAG,MAAM;YAAE,OAAO,IAAI,CAAA,CAAE,iBAAiB;QAEzD,MAAM,CAAC,GAAK,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAA;QACjC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,CAAA;QACtB,OAAO;YACL,OAAO,GAAG,EAAE,GAAG,GAAG;YAClB,OAAO,GAAG,EAAE,GAAG,GAAG;YAClB,OAAO,GAAG,EAAE,GAAG,GAAG;SACnB,CAAA;IACH,CAAC;CACF"}

package/dist/forces/WindForce.d.ts

@@ -0,0 +1,39 @@
+/**
+ * WindForce — directional wind with turbulence.
+ * Blender: Force Field > Wind.
+ *
+ * Returns a per-step acceleration contribution for each cloth particle.
+ * The turbulence adds spatial noise so the cloth billows naturally.
+ */
+export declare class WindForce {
+    parameters: {
+        /** Wind direction X component. */
+        dirX: number;
+        /** Wind direction Y component. */
+        dirY: number;
+        /** Wind direction Z component. */
+        dirZ: number;
+        /** Wind strength (m/s²). Blender: Strength. */
+        strength: number;
+        /** Turbulence amplitude [0, 1]. Blender: Noise. */
+        turbulence: number;
+        /** Turbulence frequency — how fast the noise evolves over time. */
+        frequency: number;
+    };
+    private _time;
+    constructor(opts?: {
+        direction?: [number, number, number];
+        strength?: number;
+        turbulence?: number;
+        frequency?: number;
+    });
+    /**
+     * Get wind acceleration at position (px, py, pz) and current time.
+     * Returns [ax, ay, az].
+     */
+    getAcceleration(px: number, py: number, pz: number, time: number): [number, number, number];
+    /** Advance internal time by dt (called by ClothSimulator). */
+    advance(dt: number): void;
+    get time(): number;
+}
+//# sourceMappingURL=WindForce.d.ts.map

package/dist/forces/WindForce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WindForce.d.ts","sourceRoot":"","sources":["../../src/forces/WindForce.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,qBAAa,SAAS;IACpB,UAAU,EAAE;QACV,kCAAkC;QAClC,IAAI,EAAE,MAAM,CAAA;QACZ,kCAAkC;QAClC,IAAI,EAAE,MAAM,CAAA;QACZ,kCAAkC;QAClC,IAAI,EAAE,MAAM,CAAA;QACZ,+CAA+C;QAC/C,QAAQ,EAAE,MAAM,CAAA;QAChB,mDAAmD;QACnD,UAAU,EAAE,MAAM,CAAA;QAClB,mEAAmE;QACnE,SAAS,EAAE,MAAM,CAAA;KAClB,CAAA;IAED,OAAO,CAAC,KAAK,CAAI;gBAEL,IAAI,GAAE;QAChB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;QACpC,QAAQ,CAAC,EAAG,MAAM,CAAA;QAClB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,SAAS,CAAC,EAAE,MAAM,CAAA;KACd;IAUN;;;OAGG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAc3F,8DAA8D;IAC9D,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIzB,IAAI,IAAI,IAAI,MAAM,CAAsB;CACzC"}

package/dist/forces/WindForce.js

@@ -0,0 +1,40 @@
+import { noise3 } from '../utils/noise.js';
+/**
+ * WindForce — directional wind with turbulence.
+ * Blender: Force Field > Wind.
+ *
+ * Returns a per-step acceleration contribution for each cloth particle.
+ * The turbulence adds spatial noise so the cloth billows naturally.
+ */
+export class WindForce {
+    constructor(opts = {}) {
+        this._time = 0;
+        const d = opts.direction ?? [1, 0, 0];
+        this.parameters = {
+            dirX: d[0], dirY: d[1], dirZ: d[2],
+            strength: opts.strength ?? 5,
+            turbulence: opts.turbulence ?? 0.3,
+            frequency: opts.frequency ?? 1.0,
+        };
+    }
+    /**
+     * Get wind acceleration at position (px, py, pz) and current time.
+     * Returns [ax, ay, az].
+     */
+    getAcceleration(px, py, pz, time) {
+        const { dirX, dirY, dirZ, strength, turbulence, frequency } = this.parameters;
+        // Normalize direction
+        const len = Math.sqrt(dirX * dirX + dirY * dirY + dirZ * dirZ) || 1;
+        const nx = dirX / len, ny = dirY / len, nz = dirZ / len;
+        // Simple value-noise turbulence: hash position + time
+        const t = turbulence * noise3(px * 0.3 + time * frequency, py * 0.3, pz * 0.3);
+        const s = strength * (1 + t);
+        return [nx * s, ny * s, nz * s];
+    }
+    /** Advance internal time by dt (called by ClothSimulator). */
+    advance(dt) {
+        this._time += dt;
+    }
+    get time() { return this._time; }
+}
+//# sourceMappingURL=WindForce.js.map

package/dist/forces/WindForce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WindForce.js","sourceRoot":"","sources":["../../src/forces/WindForce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE1C;;;;;;GAMG;AACH,MAAM,OAAO,SAAS;IAkBpB,YAAY,OAKR,EAAE;QAPE,UAAK,GAAG,CAAC,CAAA;QAQf,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;QACrC,IAAI,CAAC,UAAU,GAAG;YAChB,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAClC,QAAQ,EAAI,IAAI,CAAC,QAAQ,IAAM,CAAC;YAChC,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,GAAG;YAClC,SAAS,EAAG,IAAI,CAAC,SAAS,IAAK,GAAG;SACnC,CAAA;IACH,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,IAAY;QAC9D,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,UAAU,CAAA;QAE7E,sBAAsB;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,GAAC,IAAI,GAAG,IAAI,GAAC,IAAI,GAAG,IAAI,GAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7D,MAAM,EAAE,GAAI,IAAI,GAAC,GAAG,EAAE,EAAE,GAAG,IAAI,GAAC,GAAG,EAAE,EAAE,GAAG,IAAI,GAAC,GAAG,CAAA;QAElD,sDAAsD;QACtD,MAAM,CAAC,GAAK,UAAU,GAAG,MAAM,CAAC,EAAE,GAAC,GAAG,GAAG,IAAI,GAAC,SAAS,EAAE,EAAE,GAAC,GAAG,EAAE,EAAE,GAAC,GAAG,CAAC,CAAA;QACxE,MAAM,CAAC,GAAK,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QAE9B,OAAO,CAAC,EAAE,GAAC,CAAC,EAAE,EAAE,GAAC,CAAC,EAAE,EAAE,GAAC,CAAC,CAAC,CAAA;IAC3B,CAAC;IAED,8DAA8D;IAC9D,OAAO,CAAC,EAAU;QAChB,IAAI,CAAC,KAAK,IAAI,EAAE,CAAA;IAClB,CAAC;IAED,IAAI,IAAI,KAAa,OAAO,IAAI,CAAC,KAAK,CAAA,CAAC,CAAC;CACzC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { BaseCollider } from './collision/BaseCollider.js';
+export { PlaneCollider } from './collision/PlaneCollider.js';
+export { SphereCollider } from './collision/SphereCollider.js';
+export { CapsuleCollider } from './collision/CapsuleCollider.js';
+export { WindForce } from './forces/WindForce.js';
+export { ClothSimulator } from './cloth/ClothSimulator.js';
+export type { ClothSimulatorOptions } from './cloth/ClothSimulator.js';
+export { SoftBodySimulator } from './softbody/SoftBodySimulator.js';
+export type { SoftBodySimulatorOptions } from './softbody/SoftBodySimulator.js';
+export { RigidBodyWorld, RigidBody } from './rigidbody/RigidBodyWorld.js';
+export type { RigidBodyOptions, RigidBodyWorldOptions, RigidBodyShape } from './rigidbody/RigidBodyWorld.js';
+export { FixedConstraint, HingeConstraint, SliderConstraint, SpringConstraint, BallSocketConstraint, ConeTwistConstraint } from './rigidbody/RigidBodyConstraints.js';
+export type { AnyConstraint } from './rigidbody/RigidBodyConstraints.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,YAAY,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AACnE,YAAY,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAA;AAC/E,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AACzE,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAC5G,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAA;AACrK,YAAY,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAA"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export { BaseCollider } from './collision/BaseCollider.js';
+export { PlaneCollider } from './collision/PlaneCollider.js';
+export { SphereCollider } from './collision/SphereCollider.js';
+export { CapsuleCollider } from './collision/CapsuleCollider.js';
+export { WindForce } from './forces/WindForce.js';
+export { ClothSimulator } from './cloth/ClothSimulator.js';
+export { SoftBodySimulator } from './softbody/SoftBodySimulator.js';
+export { RigidBodyWorld, RigidBody } from './rigidbody/RigidBodyWorld.js';
+export { FixedConstraint, HingeConstraint, SliderConstraint, SpringConstraint, BallSocketConstraint, ConeTwistConstraint } from './rigidbody/RigidBodyConstraints.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAE1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AAEnE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AAEzE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAA"}

package/dist/rigidbody/RigidBodyConstraints.d.ts

@@ -0,0 +1,179 @@
+import { Vector3 } from 'three';
+import type { RigidBody } from './RigidBodyWorld.js';
+/**
+ * FixedConstraint — locks two bodies together at an anchor point.
+ * Blender: Rigid Body Constraint > Fixed.
+ *
+ * Corrects both position and relative velocity to keep bodies at their
+ * initial relative transform.
+ */
+export declare class FixedConstraint {
+    readonly type = "fixed";
+    parameters: {
+        stiffness: number;
+        damping: number;
+    };
+    readonly bodyA: RigidBody;
+    readonly bodyB: RigidBody;
+    private _restOffset;
+    enabled: boolean;
+    constructor(a: RigidBody, b: RigidBody, opts?: {
+        stiffness?: number;
+        damping?: number;
+    });
+    solve(): void;
+}
+/**
+ * HingeConstraint — allows rotation around one axis only.
+ * Blender: Rigid Body Constraint > Hinge.
+ *
+ * Constrains the bodies to a shared pivot; lateral position is locked,
+ * leaving only rotation about the hinge axis free.
+ */
+export declare class HingeConstraint {
+    readonly type = "hinge";
+    parameters: {
+        stiffness: number;
+        damping: number;
+        useLimits: boolean;
+        limitMin: number;
+        limitMax: number;
+    };
+    readonly bodyA: RigidBody;
+    readonly bodyB: RigidBody;
+    private _pivot;
+    enabled: boolean;
+    constructor(a: RigidBody, b: RigidBody, pivot: [number, number, number], opts?: {
+        stiffness?: number;
+        damping?: number;
+        useLimits?: boolean;
+        limitMin?: number;
+        limitMax?: number;
+    });
+    /** World-space pivot point. */
+    get pivot(): Vector3;
+    set pivot(v: Vector3);
+    solve(): void;
+}
+/**
+ * SliderConstraint — allows translation along one axis only.
+ * Blender: Rigid Body Constraint > Slider.
+ *
+ * Bodies can slide toward/away from each other along the axis,
+ * but are constrained laterally. Optional limits clamp the travel range.
+ */
+export declare class SliderConstraint {
+    readonly type = "slider";
+    parameters: {
+        stiffness: number;
+        damping: number;
+        useLimits: boolean;
+        limitMin: number;
+        limitMax: number;
+    };
+    readonly bodyA: RigidBody;
+    readonly bodyB: RigidBody;
+    private _axis;
+    enabled: boolean;
+    constructor(a: RigidBody, b: RigidBody, axis: [number, number, number], opts?: {
+        stiffness?: number;
+        damping?: number;
+        useLimits?: boolean;
+        limitMin?: number;
+        limitMax?: number;
+    });
+    /** Slider axis (world-space unit vector). */
+    get axis(): Vector3;
+    solve(): void;
+}
+/**
+ * SpringConstraint — elastic spring between two bodies.
+ * Blender: Rigid Body Constraint > Generic Spring.
+ */
+export declare class SpringConstraint {
+    readonly type = "spring";
+    parameters: {
+        restLength: number;
+        stiffness: number;
+        damping: number;
+    };
+    readonly bodyA: RigidBody;
+    readonly bodyB: RigidBody;
+    enabled: boolean;
+    constructor(a: RigidBody, b: RigidBody, opts?: {
+        restLength?: number;
+        stiffness?: number;
+        damping?: number;
+    });
+    solve(): void;
+}
+/**
+ * BallSocketConstraint — locks two bodies at a shared pivot while allowing
+ * free rotation in all directions.
+ * Blender: Rigid Body Constraint > Ball.
+ *
+ * Only translational DOF is removed; all rotational DOF remain free.
+ * Effectively a positional-only HingeConstraint with no angular restrictions.
+ */
+export declare class BallSocketConstraint {
+    readonly type = "ballsocket";
+    parameters: {
+        stiffness: number;
+        damping: number;
+    };
+    readonly bodyA: RigidBody;
+    readonly bodyB: RigidBody;
+    private _pivot;
+    /** Local-space anchor offset from body A centre to pivot (captured at construction). */
+    private _anchorA;
+    /** Local-space anchor offset from body B centre to pivot (captured at construction). */
+    private _anchorB;
+    enabled: boolean;
+    constructor(a: RigidBody, b: RigidBody, pivot: [number, number, number], opts?: {
+        stiffness?: number;
+        damping?: number;
+    });
+    /** World-space pivot point. */
+    get pivot(): Vector3;
+    solve(): void;
+}
+/**
+ * ConeTwistConstraint — ball-and-socket joint that also limits swing angle
+ * (a cone) and twist angle around the primary axis.
+ * Blender: Rigid Body Constraint > Cone Twist.
+ *
+ * Position constraint: same as BallSocketConstraint.
+ * Swing constraint: body B's primary axis must stay within `swingLimit` of
+ *   the constraint axis.
+ * Twist constraint: body B's rotation around the constraint axis is clamped
+ *   to ±`twistLimit`.
+ */
+export declare class ConeTwistConstraint {
+    readonly type = "conetwist";
+    parameters: {
+        stiffness: number;
+        damping: number;
+        swingLimit: number;
+        twistLimit: number;
+    };
+    readonly bodyA: RigidBody;
+    readonly bodyB: RigidBody;
+    private _pivot;
+    private _axis;
+    private _anchorA;
+    private _anchorB;
+    enabled: boolean;
+    constructor(a: RigidBody, b: RigidBody, pivot: [number, number, number], axis: [number, number, number], opts?: {
+        stiffness?: number;
+        damping?: number;
+        swingLimit?: number;
+        twistLimit?: number;
+    });
+    /** World-space pivot point. */
+    get pivot(): Vector3;
+    /** World-space constraint axis (unit vector). */
+    get axis(): Vector3;
+    solve(): void;
+}
+export type AnyConstraint = FixedConstraint | HingeConstraint | SliderConstraint | SpringConstraint | BallSocketConstraint | ConeTwistConstraint;
+//# sourceMappingURL=RigidBodyConstraints.d.ts.map

package/dist/rigidbody/RigidBodyConstraints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RigidBodyConstraints.d.ts","sourceRoot":"","sources":["../../src/rigidbody/RigidBodyConstraints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAc,MAAM,OAAO,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAIpD;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,QAAQ,CAAC,IAAI,WAAU;IACvB,UAAU,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IAElD,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IAEzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,UAAO;gBAEF,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO;IAW3F,KAAK,IAAI,IAAI;CA6Cd;AAED;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,QAAQ,CAAC,IAAI,WAAU;IACvB,UAAU,EAAE;QACV,SAAS,EAAE,MAAM,CAAA;QACjB,OAAO,EAAI,MAAM,CAAA;QACjB,SAAS,EAAE,OAAO,CAAA;QAClB,QAAQ,EAAG,MAAM,CAAA;QACjB,QAAQ,EAAG,MAAM,CAAA;KAClB,CAAA;IAED,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IAEzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,UAAO;gBAGZ,CAAC,EAAE,SAAS,EACZ,CAAC,EAAE,SAAS,EACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,GAAE;QACJ,SAAS,CAAC,EAAG,MAAM,CAAA;QACnB,OAAO,CAAC,EAAK,MAAM,CAAA;QACnB,SAAS,CAAC,EAAG,OAAO,CAAA;QACpB,QAAQ,CAAC,EAAI,MAAM,CAAA;QACnB,QAAQ,CAAC,EAAI,MAAM,CAAA;KACf;IAcR,+BAA+B;IAC/B,IAAI,KAAK,IAAI,OAAO,CAAuB;IAC3C,IAAI,KAAK,CAAC,CAAC,EAAE,OAAO,EAAyB;IAE7C,KAAK,IAAI,IAAI;CA+Cd;AAED;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,IAAI,YAAW;IACxB,UAAU,EAAE;QACV,SAAS,EAAE,MAAM,CAAA;QACjB,OAAO,EAAI,MAAM,CAAA;QACjB,SAAS,EAAE,OAAO,CAAA;QAClB,QAAQ,EAAG,MAAM,CAAA;QACjB,QAAQ,EAAG,MAAM,CAAA;KAClB,CAAA;IAED,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IAEzB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,UAAO;gBAGZ,CAAC,EAAE,SAAS,EACZ,CAAC,EAAE,SAAS,EACZ,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC9B,IAAI,GAAE;QACJ,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,OAAO,CAAC,EAAI,MAAM,CAAA;QAClB,SAAS,CAAC,EAAE,OAAO,CAAA;QACnB,QAAQ,CAAC,EAAG,MAAM,CAAA;QAClB,QAAQ,CAAC,EAAG,MAAM,CAAA;KACd;IAcR,6CAA6C;IAC7C,IAAI,IAAI,IAAI,OAAO,CAAsB;IAEzC,KAAK,IAAI,IAAI;CAoEd;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,IAAI,YAAW;IACxB,UAAU,EAAE;QACV,UAAU,EAAE,MAAM,CAAA;QAClB,SAAS,EAAG,MAAM,CAAA;QAClB,OAAO,EAAK,MAAM,CAAA;KACnB,CAAA;IAED,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,OAAO,UAAO;gBAGZ,CAAC,EAAE,SAAS,EACZ,CAAC,EAAE,SAAS,EACZ,IAAI,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO;IAY1E,KAAK,IAAI,IAAI;CAqCd;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAoB;IAC/B,QAAQ,CAAC,IAAI,gBAAe;IAC5B,UAAU,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IAElD,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IAEzB,OAAO,CAAC,MAAM,CAAS;IACvB,wFAAwF;IACxF,OAAO,CAAC,QAAQ,CAAS;IACzB,wFAAwF;IACxF,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO,UAAO;gBAGZ,CAAC,EAAE,SAAS,EACZ,CAAC,EAAE,SAAS,EACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO;IAcrD,+BAA+B;IAC/B,IAAI,KAAK,IAAI,OAAO,CAAuB;IAE3C,KAAK,IAAI,IAAI;CAgDd;AAED;;;;;;;;;;GAUG;AACH,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,IAAI,eAAc;IAC3B,UAAU,EAAE;QACV,SAAS,EAAG,MAAM,CAAA;QAClB,OAAO,EAAK,MAAM,CAAA;QAClB,UAAU,EAAE,MAAM,CAAA;QAClB,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;IAED,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IAEzB,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO,UAAO;gBAGZ,CAAC,EAAE,SAAS,EACZ,CAAC,EAAE,SAAS,EACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,EAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,GAAE;QACJ,SAAS,CAAC,EAAG,MAAM,CAAA;QACnB,OAAO,CAAC,EAAK,MAAM,CAAA;QACnB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,UAAU,CAAC,EAAE,MAAM,CAAA;KACf;IAgBR,+BAA+B;IAC/B,IAAI,KAAK,IAAI,OAAO,CAAuB;IAE3C,iDAAiD;IACjD,IAAI,IAAI,IAAI,OAAO,CAAsB;IAEzC,KAAK,IAAI,IAAI;CAiHd;AAED,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,eAAe,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,oBAAoB,GAAG,mBAAmB,CAAA"}