@absolutejs/rapier3d 0.17.0 → 0.18.0

package/README.md

@@ -596,3 +596,44 @@ regressions, 237 package tests, GPU-disabled browser checks, native one/two-work
 controls, no-std, 24 tree/rate comparisons, four generated/excavated requests,
 18 flat-tree cases and an independent build matching all shipped files.
 Evidence: `absolutejs/research/rotational-contact/`.
+
+### Numerical contact softness
+
+`world.integrationParameters.contactSoftness` and `staticContactSoftness` read
+or atomically replace `{ naturalFrequency, dampingRatio }`. The first controls
+dynamic contacts (native default 30 Hz / 10); the second controls contacts with
+a fixed body (native default 60 Hz / 10). Change them between steps. Reads
+return owned copies; values must be representable finite native coefficients,
+with positive frequency and nonnegative damping. Both values are validated
+before either changes. Snapshots preserve both settings. Bounded step profiles
+record each distinct settings pair once in a bounded `contactSettings` table;
+samples carry `native.contactSettingsIndex`. Reports deeply own that table,
+including after the world is freed. This avoids repeating configuration in
+every sample and keeps telemetry within existing event budgets.
+
+These are numerical regularization parameters, not measured material elasticity.
+Higher frequency can reduce transient penetration but may produce jitter or
+prevent sleeping. Qualify motion, contact, sleeping and cost across actual
+scenarios before changing a product's policy. Defaults are unchanged.
+
+### 0.18.0 contact correction and adoption limits
+
+The collision library rejects an exactly duplicated CSO point before it can
+form a degenerate tetrahedron and lose a valid terrain contact. Both friction
+builders select static/dynamic coefficients directly, avoiding dependence on
+an unused coefficient through floating-point cancellation.
+
+Native defaults remain unchanged. In the game's actual tree matrix, the
+collision correction fixes one missed-contact case but makes another case
+exceed the game's clearance limit at default softness (-21.007 mm). The game
+therefore qualifies an explicit 600 Hz / 10 static-contact policy alongside
+this engine: all 24 tree/rate cases and 18 cut-tree cases pass and sleep.
+This is a bounded product policy, not a universal stiffness recommendation.
+The default-policy failure is retained in the investigation records.
+
+Qualification: 242 package tests, 847 game tests, four generated/excavated
+terrain requests, GPU-disabled browser controls, native serial/two-worker
+checks, no-std, and independent builds matching all shipped files. Three
+ordinary CPU controls are within roughly 1% of 0.17.0 in this run. See
+`absolutejs/research/contact-softness-controls/` for measured fixture costs,
+source hashes, intermediate failures and scope limitations.

package/absolutejs/README.md

@@ -596,3 +596,44 @@ regressions, 237 package tests, GPU-disabled browser checks, native one/two-work
 controls, no-std, 24 tree/rate comparisons, four generated/excavated requests,
 18 flat-tree cases and an independent build matching all shipped files.
 Evidence: `absolutejs/research/rotational-contact/`.
+
+### Numerical contact softness
+
+`world.integrationParameters.contactSoftness` and `staticContactSoftness` read
+or atomically replace `{ naturalFrequency, dampingRatio }`. The first controls
+dynamic contacts (native default 30 Hz / 10); the second controls contacts with
+a fixed body (native default 60 Hz / 10). Change them between steps. Reads
+return owned copies; values must be representable finite native coefficients,
+with positive frequency and nonnegative damping. Both values are validated
+before either changes. Snapshots preserve both settings. Bounded step profiles
+record each distinct settings pair once in a bounded `contactSettings` table;
+samples carry `native.contactSettingsIndex`. Reports deeply own that table,
+including after the world is freed. This avoids repeating configuration in
+every sample and keeps telemetry within existing event budgets.
+
+These are numerical regularization parameters, not measured material elasticity.
+Higher frequency can reduce transient penetration but may produce jitter or
+prevent sleeping. Qualify motion, contact, sleeping and cost across actual
+scenarios before changing a product's policy. Defaults are unchanged.
+
+### 0.18.0 contact correction and adoption limits
+
+The collision library rejects an exactly duplicated CSO point before it can
+form a degenerate tetrahedron and lose a valid terrain contact. Both friction
+builders select static/dynamic coefficients directly, avoiding dependence on
+an unused coefficient through floating-point cancellation.
+
+Native defaults remain unchanged. In the game's actual tree matrix, the
+collision correction fixes one missed-contact case but makes another case
+exceed the game's clearance limit at default softness (-21.007 mm). The game
+therefore qualifies an explicit 600 Hz / 10 static-contact policy alongside
+this engine: all 24 tree/rate cases and 18 cut-tree cases pass and sleep.
+This is a bounded product policy, not a universal stiffness recommendation.
+The default-policy failure is retained in the investigation records.
+
+Qualification: 242 package tests, 847 game tests, four generated/excavated
+terrain requests, GPU-disabled browser controls, native serial/two-worker
+checks, no-std, and independent builds matching all shipped files. Three
+ordinary CPU controls are within roughly 1% of 0.17.0 in this run. See
+`absolutejs/research/contact-softness-controls/` for measured fixture costs,
+source hashes, intermediate failures and scope limitations.

package/dist/build-info.mjs

@@ -1 +1 @@
-var e=Object.freeze({schemaVersion:1,scope:"package",packageName:"@absolutejs/rapier3d",packageVersion:"0.17.0",qualifiedKernelRelease:"0.17.0",upstream:"b716d375efc0201003f0cd9ef7168eee0b62c177",engine:"0.36.0",collisionLibraryVersion:"0.31.1",collisionSource:"git+https://github.com/absolutejs/parry?rev=8c68a625c15930ca8b685f30861aedf5d59c3726#8c68a625c15930ca8b685f30861aedf5d59c3726",bindings:"0.21.0",bindgen:"0.2.129",wasmSha256:"0dad2a033f7d46e262a08a370429dc6e23ea95009f824c14a76302a15a8f73a8",wasmBytes:3362690,solverChanges:!0});export{e as buildInfo};
+var e=Object.freeze({schemaVersion:1,scope:"package",packageName:"@absolutejs/rapier3d",packageVersion:"0.18.0",qualifiedKernelRelease:"0.18.0",upstream:"b716d375efc0201003f0cd9ef7168eee0b62c177",engine:"0.36.0",collisionLibraryVersion:"0.31.1",collisionSource:"git+https://github.com/absolutejs/parry?rev=53ac0b0b02767300da09d092d97cef53a975c947#53ac0b0b02767300da09d092d97cef53a975c947",bindings:"0.21.0",bindgen:"0.2.129",wasmSha256:"67e366a5151fd865f6e6fb154a8cb27a7c4073c19e51e0e594633cf07f6e956e",wasmBytes:3363613,solverChanges:!0});export{e as buildInfo};

package/dist/provenance.json

@@ -2,15 +2,15 @@
   "schemaVersion": 1,
   "scope": "package",
   "packageName": "@absolutejs/rapier3d",
-  "packageVersion": "0.17.0",
-  "qualifiedKernelRelease": "0.17.0",
+  "packageVersion": "0.18.0",
+  "qualifiedKernelRelease": "0.18.0",
   "upstream": "b716d375efc0201003f0cd9ef7168eee0b62c177",
   "engine": "0.36.0",
   "collisionLibraryVersion": "0.31.1",
-  "collisionSource": "git+https://github.com/absolutejs/parry?rev=8c68a625c15930ca8b685f30861aedf5d59c3726#8c68a625c15930ca8b685f30861aedf5d59c3726",
+  "collisionSource": "git+https://github.com/absolutejs/parry?rev=53ac0b0b02767300da09d092d97cef53a975c947#53ac0b0b02767300da09d092d97cef53a975c947",
   "bindings": "0.21.0",
   "bindgen": "0.2.129",
-  "wasmSha256": "0dad2a033f7d46e262a08a370429dc6e23ea95009f824c14a76302a15a8f73a8",
-  "wasmBytes": 3362690,
+  "wasmSha256": "67e366a5151fd865f6e6fb154a8cb27a7c4073c19e51e0e594633cf07f6e956e",
+  "wasmBytes": 3363613,
   "solverChanges": true
 }