@absolutejs/rapier3d 0.14.1 → 0.16.0

package/README.md

@@ -421,3 +421,61 @@ zero-offset roots retain their existing arithmetic. This correction does not
 replace the articulation's angular integrator or eliminate remaining aggregate
 momentum/energy drift. Coordinate-covariance, movable-joint and snapshot replay
 regressions are recorded in `absolutejs/research/rigid-assembly`.
+
+## Isolated fixed-assembly integration and observations (0.15)
+
+The solver additionally admits isolated floating assemblies made only
+of fixed links, with gyroscopic forces enabled, no damping/armature/friction,
+no locks or fast rotation, and no external loads except uniform gravity shared
+by every link. Contacts, external joints, movable links, differing gravity
+scales and unsupported states retain their existing path. Aggregate inertia is
+assembled in authored local frames, then a matched angular update advances the
+assembly about its total center of mass. Linear gravity uses the existing
+semi-implicit kick-then-drift convention. This is not a contact or fracture model.
+
+`world.freeAssemblyStats()` reports owned attempt counts after a completed
+profiled step, with the same freshness rules as `freeRotationStats()`. The bounded
+profiler records a deep-owned `native.freeAssembly` object. Counters distinguish
+accepted steps, nonphysical-inertia rejections, rotation-limit rejections, and
+invalid/failed solves. Unsupported assemblies and invalid aggregate construction
+are excluded before an attempt; these exclusions do not increment rejection
+counts. Zero counts do not prove conservation. Counts include solver substeps
+and CCD passes. Qualification includes 198 package tests, 843 game tests, GPU-disabled browser
+checks, 80 byte-exact snapshot replays and matching independent distribution
+builds. The synthetic 16-assembly falling benchmark measured about 0.95 additional
+microseconds per assembly/substep (median paired batch ratio 1.12); this is not
+a hardware FPS result. Contact coupling, partial-subtree fracture and extreme
+thin-moment storage remain separate work. See
+`absolutejs/research/aggregate-free-transport/README.md` for evidence and limits.
+
+## Partial assembly splits and pending snapshots (0.16)
+
+Removing a link from a moving fixed assembly can leave multiple assemblies.
+Newly released roots inherit their body's world COM and angular velocity;
+the surviving original root retains its coordinates, damping, armature,
+friction and surviving couplings. Newly free root coordinates use their normal
+defaults. Explicit fixed-to-dynamic activation also preserves prescribed body
+velocity. Initial articulation construction semantics are unchanged.
+
+An ordinary free fragment now retains the matched free-rotation path when an
+unrelated articulation shares its solver batch. Multibody links are excluded
+from ordinary-body initialization, and existing external-constraint, damping,
+torque, lock and speed exclusions still apply. This corrects a batch-dependent
+motion error without applying free-body integration to constrained bodies.
+
+`takeSnapshot()` now writes the `ABSJS3DS` envelope, version 1, including ordered
+pending connectivity edits and dirty impulse-joint state. Saving immediately
+after a cut therefore retains changes not yet consumed by a simulation step.
+Native Rust callers can capture/restore the opaque `PendingIslandEvents`
+companion with the corresponding serialized world sets. Capture neither flushes
+edits nor reconstructs the world's connectivity. Snapshot payloads still depend
+on the native engine layout: retain `buildInfo` with diagnostic captures; the
+envelope is not a promise of cross-engine save compatibility. Prior compatible
+raw captures remain readable for investigation, but edits omitted by their
+original writer cannot be recovered. All new saves use the versioned format.
+
+Qualification and retained failed assumptions are in
+`absolutejs/research/assembly-split/`. Tests measure the remaining material after
+body removal; they do not invent a fracture-energy budget or model cutting
+forces, plastic deformation or coupled-contact accuracy. Those remain separate
+physical models and qualification work.

package/absolutejs/README.md

@@ -421,3 +421,61 @@ zero-offset roots retain their existing arithmetic. This correction does not
 replace the articulation's angular integrator or eliminate remaining aggregate
 momentum/energy drift. Coordinate-covariance, movable-joint and snapshot replay
 regressions are recorded in `absolutejs/research/rigid-assembly`.
+
+## Isolated fixed-assembly integration and observations (0.15)
+
+The solver additionally admits isolated floating assemblies made only
+of fixed links, with gyroscopic forces enabled, no damping/armature/friction,
+no locks or fast rotation, and no external loads except uniform gravity shared
+by every link. Contacts, external joints, movable links, differing gravity
+scales and unsupported states retain their existing path. Aggregate inertia is
+assembled in authored local frames, then a matched angular update advances the
+assembly about its total center of mass. Linear gravity uses the existing
+semi-implicit kick-then-drift convention. This is not a contact or fracture model.
+
+`world.freeAssemblyStats()` reports owned attempt counts after a completed
+profiled step, with the same freshness rules as `freeRotationStats()`. The bounded
+profiler records a deep-owned `native.freeAssembly` object. Counters distinguish
+accepted steps, nonphysical-inertia rejections, rotation-limit rejections, and
+invalid/failed solves. Unsupported assemblies and invalid aggregate construction
+are excluded before an attempt; these exclusions do not increment rejection
+counts. Zero counts do not prove conservation. Counts include solver substeps
+and CCD passes. Qualification includes 198 package tests, 843 game tests, GPU-disabled browser
+checks, 80 byte-exact snapshot replays and matching independent distribution
+builds. The synthetic 16-assembly falling benchmark measured about 0.95 additional
+microseconds per assembly/substep (median paired batch ratio 1.12); this is not
+a hardware FPS result. Contact coupling, partial-subtree fracture and extreme
+thin-moment storage remain separate work. See
+`absolutejs/research/aggregate-free-transport/README.md` for evidence and limits.
+
+## Partial assembly splits and pending snapshots (0.16)
+
+Removing a link from a moving fixed assembly can leave multiple assemblies.
+Newly released roots inherit their body's world COM and angular velocity;
+the surviving original root retains its coordinates, damping, armature,
+friction and surviving couplings. Newly free root coordinates use their normal
+defaults. Explicit fixed-to-dynamic activation also preserves prescribed body
+velocity. Initial articulation construction semantics are unchanged.
+
+An ordinary free fragment now retains the matched free-rotation path when an
+unrelated articulation shares its solver batch. Multibody links are excluded
+from ordinary-body initialization, and existing external-constraint, damping,
+torque, lock and speed exclusions still apply. This corrects a batch-dependent
+motion error without applying free-body integration to constrained bodies.
+
+`takeSnapshot()` now writes the `ABSJS3DS` envelope, version 1, including ordered
+pending connectivity edits and dirty impulse-joint state. Saving immediately
+after a cut therefore retains changes not yet consumed by a simulation step.
+Native Rust callers can capture/restore the opaque `PendingIslandEvents`
+companion with the corresponding serialized world sets. Capture neither flushes
+edits nor reconstructs the world's connectivity. Snapshot payloads still depend
+on the native engine layout: retain `buildInfo` with diagnostic captures; the
+envelope is not a promise of cross-engine save compatibility. Prior compatible
+raw captures remain readable for investigation, but edits omitted by their
+original writer cannot be recovered. All new saves use the versioned format.
+
+Qualification and retained failed assumptions are in
+`absolutejs/research/assembly-split/`. Tests measure the remaining material after
+body removal; they do not invent a fracture-energy budget or model cutting
+forces, plastic deformation or coupled-contact accuracy. Those remain separate
+physical models and qualification work.

package/dist/build-info.mjs

@@ -1 +1 @@
-var e=Object.freeze({schemaVersion:1,scope:"package",packageName:"@absolutejs/rapier3d",packageVersion:"0.14.1",qualifiedKernelRelease:"0.14.1",upstream:"b716d375efc0201003f0cd9ef7168eee0b62c177",engine:"0.36.0",collisionLibraryVersion:"0.31.1",collisionSource:"git+https://github.com/absolutejs/parry?rev=c566aabd77be8ac7a427c2b704860c47e34657b9#c566aabd77be8ac7a427c2b704860c47e34657b9",bindings:"0.21.0",bindgen:"0.2.129",wasmSha256:"4686ddcbc3804f6692e67a93a0a99eb54ea92babc4ad293a54010ef54b7c9ec5",wasmBytes:3307856,solverChanges:!0});export{e as buildInfo};
+var e=Object.freeze({schemaVersion:1,scope:"package",packageName:"@absolutejs/rapier3d",packageVersion:"0.16.0",qualifiedKernelRelease:"0.16.0",upstream:"b716d375efc0201003f0cd9ef7168eee0b62c177",engine:"0.36.0",collisionLibraryVersion:"0.31.1",collisionSource:"git+https://github.com/absolutejs/parry?rev=c566aabd77be8ac7a427c2b704860c47e34657b9#c566aabd77be8ac7a427c2b704860c47e34657b9",bindings:"0.21.0",bindgen:"0.2.129",wasmSha256:"fb44e31fd971a0577889408a95266ab1e61d9293a1f6657647ca51417b93c83d",wasmBytes:3324606,solverChanges:!0});export{e as buildInfo};

package/dist/provenance.json

@@ -2,15 +2,15 @@
   "schemaVersion": 1,
   "scope": "package",
   "packageName": "@absolutejs/rapier3d",
-  "packageVersion": "0.14.1",
-  "qualifiedKernelRelease": "0.14.1",
+  "packageVersion": "0.16.0",
+  "qualifiedKernelRelease": "0.16.0",
   "upstream": "b716d375efc0201003f0cd9ef7168eee0b62c177",
   "engine": "0.36.0",
   "collisionLibraryVersion": "0.31.1",
   "collisionSource": "git+https://github.com/absolutejs/parry?rev=c566aabd77be8ac7a427c2b704860c47e34657b9#c566aabd77be8ac7a427c2b704860c47e34657b9",
   "bindings": "0.21.0",
   "bindgen": "0.2.129",
-  "wasmSha256": "4686ddcbc3804f6692e67a93a0a99eb54ea92babc4ad293a54010ef54b7c9ec5",
-  "wasmBytes": 3307856,
+  "wasmSha256": "fb44e31fd971a0577889408a95266ab1e61d9293a1f6657647ca51417b93c83d",
+  "wasmBytes": 3324606,
   "solverChanges": true
 }