avbd-babylon 0.4.1 → 0.4.2

package/docs/BABYLON_API.md

@@ -155,8 +155,10 @@ waking. Awake groups rebuild their connections from current contacts; sleeping
 groups retain the support connections omitted by collision detection. A group
 settles together after its eligible members stay quiet, so sleeping one course
 does not repeatedly disturb the courses above it. Contact waking checks closing
-speed at each contact point, including rotation. Updating a grab anchor wakes
-the held body; ordinary edits and changes to supports wake the world.
+speed at each contact point, including rotation. Adding or removing constraints
+and updating a grab anchor wake their endpoints and sleeping connected groups;
+unrelated groups stay asleep. Ordinary body edits and changes to supports wake
+the world. A connected group can stay awake while any member moves or loses support.
 Unsupported bodies
 under gravity stay awake. `wakeAll()`, `body.wakeUp()` and `readSleepStats()` are
 available. Suspended jointed objects are not guaranteed to sleep. Defaults and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "avbd-babylon",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "GPU AVBD rigid-body physics with a Babylon.js aggregate API",
   "main": "./dist/avbd.js",
   "types": "./dist/avbd.d.ts",

package/tests/README.md

@@ -38,7 +38,8 @@ Set `AVBD_TEST_BROWSER` to a Chromium executable if browser discovery fails.
 
 `node scripts/check-galton-startup.mjs` measures startup of the 40,000-marble
 playground and verifies default worker execution, an explicit main-thread choice,
-and automatic fallback when workers are unavailable. `test:playgrounds` also
+and automatic fallback when workers are unavailable. It also checks that page
+dependencies stay small before starting the worker. `test:playgrounds` also
 checks that at least 99.5% of marbles reach the bins, compares GPU counts with real
 body positions, and measures the shape of the distribution.
 
@@ -48,7 +49,9 @@ poses with direct drawing, Babylon, shared-input workers and CPU compatibility.
 and bounded catch-up under load. `check-lab-sleep.mjs` checks live sleeping
 toggles, large-scene defaults and bowling balls in all sixteen wall lanes.
 `check-sleep-stability.mjs --drag` follows the 28K brick ring for 900 steps and
-checks that repeated grab-anchor updates leave resting debris asleep.
+checks that creating a grab and repeatedly updating its anchor leave a distant,
+disconnected sleeper asleep with unchanged poses. GPU regressions also check
+grab release and stale gravity predictions beside an awake resting body.
 `check-jointed-settling.mjs` measures GPU collision and movement time while the
 34K jointed drop lands, comparing sleeping off, whole-world waking and automatic
 group sleeping. It checks contact capacity and solve-group conflicts on every
@@ -61,6 +64,9 @@ scene defaults and URL settings with CPU, WebGPU, Babylon and worker execution.
 The showcase exposes steps per second beside solving iterations. Both settings
 remain fixed while a benchmark measurement runs.
 
+`check-runtime-efficiency.mjs` also checks that workers finish explicit GPU
+cleanup before termination, with a bounded fallback for an unresponsive worker.
+
 `node scripts/check-demo-startup.mjs --all` initializes every scene in a paused
 worker and saves setup times separately from frame performance. Browser and driver
 caches can warm during the run. `node scripts/check-slingshot-input.mjs` uses real