@dice-o-rolla/dice-physics-rapier 0.2.0 → 0.3.1

package/README.md

@@ -6,6 +6,10 @@ bodies, tray boundaries, convex colliders, and settled orientation snapshots.
 Most browser applications should use the preassembled entry point from
 `@dice-o-rolla/dice-engine/browser`.
 
+`clear()` restores a deterministic configured baseline: it invalidates dynamic handles, recreates
+the Rapier World and EventQueue, and reapplies the current gravity and tray. This lets repeated
+seeded engine simulations reuse one adapter without inheriting solver state from an earlier run.
+
 ```ts
 import { RapierPhysicsWorld } from '@dice-o-rolla/dice-physics-rapier';
 ```

package/dist/rapier-physics-world.js

@@ -3,6 +3,15 @@ import { RapierDieBody } from './rapier-die-body.js';
 import { initializeRapier } from './rapier-module.js';
 import { assertNonNegative, assertPositive, assertQuaternion, assertVector } from './validation.js';
 const DEFAULT_GRAVITY = { x: 0, y: -9.81, z: 0 };
+function snapshotVector(value) {
+    return Object.freeze({ ...value });
+}
+function snapshotTray(options) {
+    return Object.freeze({
+        ...options,
+        material: Object.freeze({ ...options.material }),
+    });
+}
 export class RapierPhysicsWorld {
     #rapier;
     #world;
@@ -10,13 +19,16 @@ export class RapierPhysicsWorld {
     #dice = new Map();
     #colliderDice = new Map();
     #dieColliders = new Map();
+    #gravity;
+    #tray;
     #trayBody;
     #collisionEventsEnabled = false;
     #destroyed = false;
     constructor(rapier, gravity) {
         assertVector(gravity, 'gravity');
         this.#rapier = rapier;
-        this.#world = new rapier.World(gravity);
+        this.#gravity = snapshotVector(gravity);
+        this.#world = new rapier.World(this.#gravity);
         this.#eventQueue = new rapier.EventQueue(true);
     }
     static async create(options = {}) {
@@ -68,6 +80,10 @@ export class RapierPhysicsWorld {
         assertPositive(options.wallThickness, 'tray.wallThickness');
         assertNonNegative(options.material.friction, 'tray.material.friction');
         assertNonNegative(options.material.restitution, 'tray.material.restitution');
+        this.#tray = snapshotTray(options);
+        this.#configureTray(this.#tray);
+    }
+    #configureTray(options) {
         this.#removeTray();
         const body = this.#world.createRigidBody(this.#rapier.RigidBodyDesc.fixed());
         const halfWidth = options.width / 2;
@@ -91,7 +107,8 @@ export class RapierPhysicsWorld {
     setGravity(gravity) {
         this.#assertAlive();
         assertVector(gravity, 'gravity');
-        this.#world.gravity = { x: gravity.x, y: gravity.y, z: gravity.z };
+        this.#gravity = snapshotVector(gravity);
+        this.#world.gravity = this.#gravity;
     }
     setCollisionEventsEnabled(enabled) {
         this.#assertAlive();
@@ -163,24 +180,32 @@ export class RapierPhysicsWorld {
     }
     clear() {
         this.#assertAlive();
-        for (const die of this.#dice.values()) {
-            this.#world.removeRigidBody(die.body);
-            die.invalidate();
-        }
-        this.#dice.clear();
-        this.#colliderDice.clear();
-        this.#dieColliders.clear();
-        this.#eventQueue.clear();
+        this.#invalidateDice();
+        this.#eventQueue.free();
+        this.#world.free();
+        this.#world = new this.#rapier.World(this.#gravity);
+        this.#eventQueue = new this.#rapier.EventQueue(true);
+        this.#trayBody = undefined;
+        if (this.#tray !== undefined)
+            this.#configureTray(this.#tray);
     }
     destroy() {
         if (this.#destroyed)
             return;
-        this.clear();
-        this.#removeTray();
+        this.#invalidateDice();
         this.#eventQueue.free();
         this.#world.free();
+        this.#trayBody = undefined;
+        this.#tray = undefined;
         this.#destroyed = true;
     }
+    #invalidateDice() {
+        for (const die of this.#dice.values())
+            die.invalidate();
+        this.#dice.clear();
+        this.#colliderDice.clear();
+        this.#dieColliders.clear();
+    }
     #removeTray() {
         if (this.#trayBody !== undefined) {
             this.#world.removeRigidBody(this.#trayBody);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dice-o-rolla/dice-physics-rapier",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Rapier 3D physics backend for physical dice simulation.",
   "keywords": [
     "dice",
@@ -40,8 +40,8 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@dice-o-rolla/dice-core": "0.2.0",
-    "@dice-o-rolla/dice-physics": "0.2.0",
+    "@dice-o-rolla/dice-core": "0.3.1",
+    "@dice-o-rolla/dice-physics": "0.3.1",
     "@dimforge/rapier3d-compat": "^0.20.0"
   },
   "engines": {