@absolutejs/rapier3d 0.12.0 → 0.14.0

package/dist/types/pipeline/step_profile.d.ts

@@ -1,4 +1,4 @@
-import type { World, ContactConvergenceStats } from "./world";
+import type { World, ContactConvergenceStats, FreeRotationStats } from "./world";
 import type { EventQueue } from "./event_queue";
 import type { PhysicsHooks } from "./physics_hooks";
 export interface PhysicsStepSample {
@@ -22,6 +22,7 @@ export interface PhysicsStepSample {
             ccdMs: number;
         };
         convergence: ContactConvergenceStats;
+        freeRotation: FreeRotationStats;
     } | null;
 }
 export interface PhysicsStepProfile {

package/dist/types/pipeline/world.d.ts

@@ -26,6 +26,20 @@ export interface ContactConvergenceStats {
     /** Maximum terminal residual across eligible restitution phases. */
     maxRestitutionResidual: number;
 }
+/** Observations of isolated free-body rotation during a completed profiled step.
+ * Counts include solver substeps and CCD passes. Zero accepted steps means no
+ * admitted solve, not proof of conservation. Rejections use the existing solver
+ * path for the rest of that island solve; constrained bodies are not attempted.
+ */
+export interface FreeRotationStats {
+    acceptedSteps: number;
+    nonphysicalInertiaRejections: number;
+    rotationLimitRejections: number;
+    invalidOrFailedSolves: number;
+    maxNewtonIterations: number;
+    /** Maximum accepted angular-velocity equation residual in radians/second. */
+    maxResidualRadiansPerSecond: number;
+}
 /**
  * The physics world.
  *
@@ -584,6 +598,12 @@ export declare class World {
      * This count does not expose internal substep durations or time of impact.
      */
     ccdSubsteps(): number | null;
+    /** Owned isolated-body rotation observations from the last completed profiled
+     * step; null before that step, after toggling profiling, when disabled, or
+     * after restoration. Zero accepted steps does not establish conservation.
+     * Reading or modifying the result never changes simulation.
+     */
+    freeRotationStats(): FreeRotationStats | null;
     /** Owned observations from the last completed profiled step; null before
      * that step, after toggling profiling, when disabled, or after restoration.
      * Zero solves means no eligible adaptive path, not proof of convergence.

package/dist/types/rapier_wasm3d.d.ts

@@ -896,6 +896,7 @@ export class RawPhysicsPipeline {
     [Symbol.dispose](): void;
     ccd_substeps(): number | undefined;
     contact_convergence(): Float64Array | undefined;
+    free_rotation_candidate(): Float64Array | undefined;
     is_profiler_enabled(): boolean;
     constructor();
     set_profiler_enabled(enabled: boolean): void;
@@ -2404,6 +2405,7 @@ export interface InitOutput {
     readonly rawnarrowphase_new: () => number;
     readonly rawphysicspipeline_ccd_substeps: (a: number) => number;
     readonly rawphysicspipeline_contact_convergence: (a: number, b: number) => void;
+    readonly rawphysicspipeline_free_rotation_candidate: (a: number, b: number) => void;
     readonly rawphysicspipeline_is_profiler_enabled: (a: number) => number;
     readonly rawphysicspipeline_new: () => number;
     readonly rawphysicspipeline_set_profiler_enabled: (a: number, b: number) => void;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@absolutejs/rapier3d",
-  "version": "0.12.0",
-  "description": "Rapier 3D with corrected contact witnesses, rotation precision and solver diagnostics",
+  "version": "0.14.0",
+  "description": "Rapier 3D with matched free-body rotation, corrected contact witnesses and solver diagnostics",
   "type": "module",
   "license": "Apache-2.0",
   "repository": {