@absolutejs/rapier3d 0.14.1 → 0.15.0

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

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

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

@@ -40,6 +40,17 @@ export interface FreeRotationStats {
     /** Maximum accepted angular-velocity equation residual in radians/second. */
     maxResidualRadiansPerSecond: number;
 }
+/** Isolated fixed-assembly attempts under uniform gravity. Counts include
+ * solver substeps and CCD passes. Unsupported topology, loads, damping or
+ * invalid aggregate construction are excluded before any attempt and therefore
+ * are not rejection counts. Zero attempts does not establish conservation.
+ */
+export interface FreeAssemblyStats {
+    acceptedSteps: number;
+    nonphysicalInertiaRejections: number;
+    rotationLimitRejections: number;
+    invalidOrFailedSolves: number;
+}
 /**
  * The physics world.
  *
@@ -598,6 +609,11 @@ export declare class World {
      * This count does not expose internal substep durations or time of impact.
      */
     ccdSubsteps(): number | null;
+    /** Owned assembly observations from the last completed profiled step.
+     * Null before a profiled step, after restoration or a profiling toggle,
+     * and while profiling is disabled. Reading does not alter physics.
+     */
+    freeAssemblyStats(): FreeAssemblyStats | 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.

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_assembly_candidate(): Float64Array | undefined;
     free_rotation_candidate(): Float64Array | undefined;
     is_profiler_enabled(): boolean;
     constructor();
@@ -2405,6 +2406,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_assembly_candidate: (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;

package/package.json

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