avbd-babylon 0.1.0 → 0.2.0

package/dist/gpuDevice.d.ts

@@ -1,6 +1,10 @@
 export function createWebGPUDevice(options?: {
+  /** Run the cached 3D floor-contact qualification and select a working GPU path. */
+  validate3D?: boolean;
   powerPreference?: GPUPowerPreference;
   requiredLimits?: Record<string, number>;
   /** Desired maximum capacities, clamped to the adapter. Required limits take precedence. */
   preferredLimits?: Record<string, number>;
 }): Promise<{ adapter: GPUAdapter; device: GPUDevice }>;
+/** Prepare an existing renderer-owned device for 3D. Does not take device ownership. */
+export function prepareWebGPUDevice3D(device: GPUDevice): Promise<GPUDevice>;

package/dist/native.js

@@ -1 +1 @@
-export { AvbdScene2D, AvbdScene3D, createWebGPUDevice } from "./avbd.js";
+export { AvbdScene2D, AvbdScene3D, createWebGPUDevice, prepareWebGPUDevice3D } from "./avbd.js";

package/docs/BABYLON_API.md

@@ -16,6 +16,14 @@ last argument when their mesh belongs to the world’s scene. Both `AvbdShapeTyp
 and the supported Babylon `PhysicsShapeType` enum values work. Pass
 `autoAttach: false` when you manage stepping yourself.
 
+`AvbdPhysics.create()` checks 3D floor contacts once per device and automatically
+selects a working GPU path. This covers Android drivers that need compatible
+contact calculations or smaller hull workgroups. Desktop devices that pass
+retain their normal shaders and dispatches. The check adds no per-step readbacks.
+For native 3D solvers, use `createWebGPUDevice({validate3D:true})`, or await
+`prepareWebGPUDevice3D(device)` before using a renderer-owned device. Preparation
+is cached and preserves device ownership. 2D does not require the 3D check.
+
 ```js
 import { Vector3 } from "@babylonjs/core/Maths/math.vector.js";
 import { AvbdPhysics, AvbdPhysicsAggregate, AvbdShapeType } from "avbd-babylon";

package/docs/RELEASE.md

@@ -1,6 +1,6 @@
-# First release checks
+# Release checks
 
-AVBD 0.1 provides GPU rigid-body physics in 2D and 3D, the Babylon aggregate API,
+AVBD 0.2 provides GPU rigid-body physics in 2D and 3D, the Babylon aggregate API,
 portable scene builders and the browser demos. The package ships ESM, the `AVBD`
 browser global, declarations, documentation and license notices. It has no runtime
 dependencies; Babylon 9 is an optional peer for the integration API.
@@ -23,6 +23,38 @@ playable scenes, screenshots, controls and reports. A Chromium browser with
 WebGPU is required for GPU tests; unsupported hardware fails explicitly. GPU
 workloads run sequentially. Type and packaging checks do not need a GPU.
 
+Run `npm run test:mobile-contacts` for the 3D floor-contact portability checks,
+including eight/nine storage-buffer limits and both renderers in a mobile layout.
+The layout checks use the test computer's GPU. Test the hosted demo on actual
+phones as well; its **GPU contact check** sidebar can save a diagnostic report
+with floor-contact results, browser details and device limits. Failed devices
+test alternatives for contact data/calculations, work sharing and collision search.
+A fallback is used only after its known-overlap and falling-shape checks pass.
+GPUs that pass the normal path keep the batched execution and automatic scene
+selection. The diagnostic report compares the contact inputs, stabilization
+setting and calculated forces on the GPU.
+
+For an authorized connected Android phone, start the local demo, unlock the phone
+and open a canonical scene in its browser. Forward the browser debugging socket
+and reverse the demo port with ADB:
+
+```sh
+adb reverse tcp:8080 tcp:8080
+adb forward tcp:9223 localabstract:chrome_devtools_remote
+node scripts/check-connected-contacts.mjs
+```
+
+This checks physical-device floor contacts, 2D/3D package features and both 3D
+collision searches. It uses only the existing local demo tab and saves
+`test-results/connected-phone-contacts.json`. Mobile viewport tests and physical
+phone tests have separate reports.
+
+To compare PC performance with a saved package build, run
+`node scripts/check-contact-performance.mjs --baseline=/path/to/avbd.js`.
+It runs 10K and 100K native 3D bodies with five iterations, three alternating
+repeats and no rendering or sleeping. It checks identical dispatch sequences,
+matching selected physics states, GPU times and CPU submission times.
+
 Run `npm run benchmark:native` to refresh the three-repeat 2D/3D measurements
 for bulk movement/spin, property edits, grouped queries, selected reads and
 sleeping. The browser performance page uses the same package APIs as the demos.
@@ -53,6 +85,13 @@ Preview either cleanup with `node scripts/clean-results.mjs` or
 The package check installs the tarball in a temporary project and imports it
 without Babylon or a DOM. It verifies the production file list, both builds,
 optional-peer behavior, strict portable TypeScript usage and upstream notices.
+
+After publishing, run `npm run test:published -- 0.2.0` to verify the registry
+release. This installs the exact version in a fresh temporary project, verifies
+its registry integrity, imports ESM/native and browser-global exports, checks
+TypeScript usage, and runs the GPU package feature tests with Babylon installed
+explicitly for those integration checks. It uses the downloaded package rather
+than a local build and saves `test-results/published-package.json`.
 `avbd-babylon/native` provides portable imports without Babylon type dependencies.
 Packed files exclude the website,
 benchmark outputs, test fixtures, development tools and dependency directories.
@@ -67,7 +106,13 @@ premade results. Those saved results identify the RTX 4070 Laptop GPU. Live
 benchmarks measure the visitor's machine. The paper's desktop RTX 4090 figures
 are separate comparisons with different hardware and reconstructed workloads.
 
-## Publish 0.1.0
+The repository's `netlify.toml` runs `npm run build:all` and publishes the root,
+so the demo, benchmark pages, assets and reports stay available. `npm run build`
+builds the npm library only; use `npm run build:all` or `npm run build:web` before
+a manual website upload. Push the Netlify configuration and source changes,
+then redeploy. Clearing browser data cannot update an older deployed bundle.
+
+## Publish 0.2.0
 
 Push the sources, documentation and `test-results/` screenshots to the public
 [repository](https://github.com/joshbrew/babylon-avbd) before publishing npm.
@@ -96,7 +141,7 @@ aggregates, sleeping, hinge angle stops, ropes, ragdolls and fabric helpers.
 attachment for timing and cleanup. Attachment does not create rendering meshes.
 See the [feature table](../README.md#feature-coverage) for exact coverage.
 
-These remain useful follow-up work rather than supported 0.1 features:
+These remain useful follow-up work rather than supported 0.2 features:
 
 - **Concave mesh collisions:** custom hulls fill cavities. Terrain and hollow
   objects need suitable convex pieces.

package/package.json

@@ -1,66 +1,10 @@
 {
   "name": "avbd-babylon",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "GPU AVBD rigid-body physics with a Babylon.js aggregate API",
-  "keywords": [
-    "avbd",
-    "webgpu",
-    "physics",
-    "babylonjs"
-  ],
-  "homepage": "https://github.com/joshbrew/babylon-avbd#readme",
-  "bugs": {
-    "url": "https://github.com/joshbrew/babylon-avbd/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/joshbrew/babylon-avbd.git"
-  },
-  "license": "MIT",
-  "author": "josh brewster et al",
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./dist/avbd.d.ts",
-      "import": "./dist/avbd.js",
-      "default": "./dist/avbd.js"
-    },
-    "./native": {
-      "types": "./dist/native.d.ts",
-      "import": "./dist/native.js",
-      "default": "./dist/native.js"
-    },
-    "./global": {
-      "types": "./dist/avbd.global.d.ts",
-      "default": "./dist/avbd.global.js"
-    },
-    "./package.json": "./package.json"
-  },
   "main": "./dist/avbd.js",
   "types": "./dist/avbd.d.ts",
-  "directories": {
-    "doc": "docs",
-    "test": "tests"
-  },
-  "files": [
-    "dist/avbd.js",
-    "dist/avbd.global.js",
-    "dist/avbd.global.d.ts",
-    "dist/avbd.d.ts",
-    "dist/babylonAvbd.d.ts",
-    "dist/nativeScenes.d.ts",
-    "dist/native.js",
-    "dist/native.d.ts",
-    "dist/gpuDevice.d.ts",
-    "dist/NOTICE",
-    "LICENSE",
-    "README.md",
-    "docs/README.md",
-    "docs/BABYLON_API.md",
-    "docs/HPLOC.md",
-    "docs/RELEASE.md",
-    "tests/README.md"
-  ],
+  "type": "module",
   "scripts": {
     "start": "node scripts/build-library.mjs && node scripts/build.mjs --serve",
     "build": "node scripts/build-library.mjs",
@@ -88,18 +32,23 @@
     "clean:results": "node scripts/clean-results.mjs --apply",
     "clean:dist": "node scripts/clean-dist.mjs --apply",
     "test:package": "node scripts/check-package.mjs",
+    "test:published": "node scripts/check-published.mjs",
+    "test:mobile-contacts": "node scripts/build.mjs && node scripts/check-contact-portability.mjs && node scripts/check-contact-compatibility-features.mjs",
     "test:types": "tsc --noEmit --strict --skipLibCheck --module nodenext --target es2022 tests/package-api-types.ts",
     "benchmark:native": "node scripts/benchmark-package.mjs",
     "benchmark:sleeping": "node scripts/benchmark-package.mjs",
     "benchmark:native-edits": "node scripts/check-native-performance.mjs",
-    "benchmark:renderers": "node scripts/build.mjs && node scripts/benchmark-renderers.mjs"
+    "benchmark:renderers": "node scripts/build.mjs && node scripts/benchmark-renderers.mjs",
+    "test:connected-phone": "node scripts/check-connected-contacts.mjs"
   },
-  "devDependencies": {
-    "esbuild": "^0.28.2",
-    "prettier": "^3.9.9",
-    "tinybuild": "^1.0.6",
-    "@babylonjs/core": "^9.13.0",
-    "typescript": "^7.0.2"
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/joshbrew/babylon-avbd.git"
+  },
+  "homepage": "https://github.com/joshbrew/babylon-avbd#readme",
+  "bugs": {
+    "url": "https://github.com/joshbrew/babylon-avbd/issues"
   },
   "peerDependencies": {
     "@babylonjs/core": "^9.13.0"
@@ -109,7 +58,56 @@
       "optional": true
     }
   },
+  "keywords": [
+    "avbd",
+    "webgpu",
+    "physics",
+    "babylonjs"
+  ],
+  "devDependencies": {
+    "esbuild": "^0.28.2",
+    "prettier": "^3.9.9",
+    "tinybuild": "^1.0.6",
+    "@babylonjs/core": "^9.13.0",
+    "typescript": "^7.0.2"
+  },
   "module": "./dist/avbd.js",
+  "exports": {
+    ".": {
+      "types": "./dist/avbd.d.ts",
+      "import": "./dist/avbd.js",
+      "default": "./dist/avbd.js"
+    },
+    "./native": {
+      "types": "./dist/native.d.ts",
+      "import": "./dist/native.js",
+      "default": "./dist/native.js"
+    },
+    "./global": {
+      "types": "./dist/avbd.global.d.ts",
+      "default": "./dist/avbd.global.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/avbd.js",
+    "dist/avbd.global.js",
+    "dist/avbd.global.d.ts",
+    "dist/avbd.d.ts",
+    "dist/babylonAvbd.d.ts",
+    "dist/nativeScenes.d.ts",
+    "dist/native.js",
+    "dist/native.d.ts",
+    "dist/gpuDevice.d.ts",
+    "dist/NOTICE",
+    "LICENSE",
+    "README.md",
+    "docs/README.md",
+    "docs/BABYLON_API.md",
+    "docs/HPLOC.md",
+    "docs/RELEASE.md",
+    "tests/README.md"
+  ],
   "sideEffects": false,
   "unpkg": "./dist/avbd.global.js",
   "jsdelivr": "./dist/avbd.global.js"

package/tests/README.md

@@ -13,6 +13,8 @@ checks run on the host because they inspect files and JavaScript APIs.
 | `npm run test:castle`            | Mortar settling, local impacts, rotating debris and responsive layout                 |
 | `npm run test:cloth`             | Thirty-second limb/net checks, central cloth tearing and screenshots                  |
 | `npm run test:features`          | 2D/3D hinge stops, motor reversal/braking, sensors, live masks and casts              |
+| `npm run test:mobile-contacts`   | 3D floor contacts, device-verified fallback selection, 8/9 binding limits and mobile drawing |
+| `npm run test:connected-phone`   | Physical Android GPU: prepared native/Babylon APIs, floor contacts, 2D/3D features and grid/HPLOC++ collisions |
 | `npm run test:renderers`         | Every canonical scene and the slingshot in Babylon; shared-state renderer benchmark checks |
 | `npm run benchmark:renderers`    | Direct WebGPU versus Babylon: GPU drawing/copies, CPU submission and completion; three repeats |
 | `npm run test:fracture`          | Voronoi partition, breakable face bonds, wrecking-ball impact and persistent rubble   |