@adobe/data-gpu 0.9.69

package/dist/physics/solvers/rapier-solver-plugin.js

@@ -0,0 +1,284 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import RAPIER from "@dimforge/rapier3d-compat";
+import { Database } from "@adobe/data/ecs";
+import { True } from "@adobe/data/schema";
+import { physicsClock } from "../physics-clock-plugin.js";
+import { physicsData } from "../physics-data-plugin.js";
+import { jointData } from "../joint/joint-plugin.js";
+import { BodyType } from "../body/body-type/body-type.js";
+/**
+ * A second rigid-body solver behind the same `physicsData` seam — the
+ * battle-tested Rapier engine (dimforge, Rust→WASM). It reads the identical
+ * authored components (`RigidBody` + `StaticCollider`) and writes back
+ * `position`/`rotation`/velocity for dynamic bodies, exactly like `joltSolver`,
+ * so the same scene runs unchanged on either solver.
+ *
+ * Rapier's WASM must be initialised before use; per the repo's no-top-level-await
+ * rule, the init promise lives in the system closure and is awaited lazily — the
+ * system no-ops until the world exists, then runs every frame.
+ */
+const GRAVITY = 18; // matches joltSolver so the two solvers are directly comparable
+const RIGID = ["bodyType", "colliderShape", "halfExtents", "material", "position", "rotation", "linearVelocity", "angularVelocity"];
+const STATIC = ["colliderShape", "halfExtents", "material", "position", "rotation"];
+// Dynamic bodies carry the derived prev-pose snapshot (added on first sync) used
+// for render interpolation; this query reads/writes it alongside the live pose.
+const SNAPSHOT = ["bodyType", "position", "rotation", "_prevPosition", "_prevRotation"];
+// Sync only over bodies not yet mirrored into Rapier: a private `_rapierBody`
+// tag is added once a body is created, and excluded here, so steady state
+// iterates zero rows (archetype-level) instead of re-scanning every body each
+// frame — the win for the "many static, few dynamic" target.
+const NEW_RIGID = { exclude: ["_rapierBody"] };
+const NEW_STATIC = { exclude: ["linearVelocity", "_rapierBody"] };
+// Kinematic bodies, by archetype shape (no per-row value test): they have
+// `bodyType` (so not a StaticCollider) and are mirrored (`_rapierBody`) but never
+// gained `_prevPosition` (only dynamics do) — so excluding it isolates kinematics.
+const KINEMATIC = ["bodyType", "position", "rotation", "_rapierBody"];
+const KINEMATIC_ONLY = { exclude: ["_prevPosition"] };
+const JOINT = ["jointType", "jointBodyA", "jointBodyB", "jointAnchorA", "jointAnchorB", "jointAxis", "jointMinLimit", "jointMaxLimit", "jointSwingLimit"];
+const NEW_JOINT = { exclude: ["_rapierJoint"] };
+export const rapierSolver = Database.Plugin.create({
+    extends: Database.Plugin.combine(physicsData, jointData, physicsClock),
+    components: {
+        _rapierBody: True.schema, // tag: this body has been mirrored into the Rapier world
+        _rapierJoint: True.schema, // tag: this joint has been mirrored into the Rapier world
+    },
+    systems: {
+        rapierStep: {
+            schedule: { during: ["physics"], after: ["advancePhysicsClock"] },
+            create: db => {
+                let world = null;
+                let initStarted = false;
+                const bodies = new Map(); // entity → Rapier body
+                const matPropsOf = (id) => {
+                    // Material entities carry density/restitution/friction (read once at body creation).
+                    const m = db.store.read(id);
+                    return { density: m?.density ?? 1, restitution: m?.restitution ?? 0.2, friction: m?.friction ?? 0.5 };
+                };
+                // hull/mesh colliders may be auto-generated from a model that's still
+                // loading — defer mirroring such a body until its collision data exists.
+                const colliderReady = (id, shape) => {
+                    if (shape !== "hull" && shape !== "mesh")
+                        return true;
+                    const r = db.store.read(id);
+                    return !!(r?.convexPoints || r?.colliderMesh);
+                };
+                const ensureBody = (id, motion, shape, hx, hy, hz, mat, px, py, pz, q, vx, vy, vz, wx, wy, wz) => {
+                    if (!world || bodies.has(id))
+                        return;
+                    const m = matPropsOf(mat);
+                    // dynamic = simulated; kinematic = position-driven (pushes dynamics,
+                    // isn't pushed back); fixed = immovable collider.
+                    const desc = motion === "dynamic" ? RAPIER.RigidBodyDesc.dynamic()
+                        : motion === "kinematic" ? RAPIER.RigidBodyDesc.kinematicPositionBased()
+                            : RAPIER.RigidBodyDesc.fixed();
+                    desc.setTranslation(px, py, pz).setRotation({ x: q[0], y: q[1], z: q[2], w: q[3] });
+                    if (motion === "dynamic") {
+                        desc.setLinvel(vx, vy, vz);
+                        desc.setAngvel({ x: wx, y: wy, z: wz });
+                    }
+                    const body = world.createRigidBody(desc);
+                    // capsule: Y-aligned, halfHeight = cylinder half (hy), radius = hx.
+                    // hull: convex hull of the authored point cloud (read once here).
+                    let col;
+                    if (shape === "sphere")
+                        col = RAPIER.ColliderDesc.ball(hx);
+                    else if (shape === "capsule")
+                        col = RAPIER.ColliderDesc.capsule(hy, hx);
+                    else if (shape === "hull") {
+                        const pts = db.store.read(id).convexPoints;
+                        col = pts ? RAPIER.ColliderDesc.convexHull(pts) : null;
+                        if (!col)
+                            col = RAPIER.ColliderDesc.ball(Math.max(hx, 0.1)); // degenerate cloud fallback
+                    }
+                    else if (shape === "mesh") {
+                        const cm = db.store.read(id).colliderMesh;
+                        col = cm ? RAPIER.ColliderDesc.trimesh(cm.positions, cm.indices) : RAPIER.ColliderDesc.cuboid(0.1, 0.1, 0.1);
+                    }
+                    else
+                        col = RAPIER.ColliderDesc.cuboid(hx, hy, hz);
+                    col.setRestitution(m.restitution).setFriction(m.friction).setDensity(m.density);
+                    // collisionGroup g (>0): membership bit g, collide with everything
+                    // except bit g — so same-group bodies (e.g. a ragdoll's bones) skip
+                    // each other but still hit the world (group 0).
+                    const g = db.store.read(id)?.collisionGroup ?? 0;
+                    if (g > 0) {
+                        const bit = 1 << (g & 15);
+                        col.setCollisionGroups(((bit << 16) | (0xffff & ~bit)) >>> 0);
+                    }
+                    world.createCollider(col, body);
+                    bodies.set(id, body);
+                };
+                return () => {
+                    if (!world) {
+                        if (!initStarted) {
+                            initStarted = true;
+                            RAPIER.init().then(() => { world = new RAPIER.World({ x: 0, y: -GRAVITY, z: 0 }); });
+                        }
+                        return; // WASM not ready yet
+                    }
+                    // sync: mirror only bodies not yet in Rapier (excluded by tag),
+                    // then tag them. Iterate tail→head since every row migrates out
+                    // on tagging. Reads use column accessors (robust to the migration;
+                    // this loop only touches genuinely-new bodies, so it's cold).
+                    for (const arch of db.store.queryArchetypes(RIGID, NEW_RIGID)) {
+                        const ids = arch.columns.id, bt = arch.columns.bodyType, cs = arch.columns.colliderShape, mat = arch.columns.material;
+                        const he = arch.columns.halfExtents, pos = arch.columns.position, ori = arch.columns.rotation, lv = arch.columns.linearVelocity, av = arch.columns.angularVelocity;
+                        for (let r = arch.rowCount - 1; r >= 0; r--) {
+                            const id = ids.get(r), bodyType = bt.get(r), shape = cs.get(r), h = he.get(r), p = pos.get(r), o = ori.get(r), v = lv.get(r), w = av.get(r);
+                            if (!colliderReady(id, shape))
+                                continue; // auto-collider not generated yet
+                            ensureBody(id, bodyType, shape, h[0], h[1], h[2], mat.get(r), p[0], p[1], p[2], o, v[0], v[1], v[2], w[0], w[1], w[2]);
+                            // Tag as mirrored. Dynamics also migrate onto the derived prev-pose
+                            // snapshot (the interpolator reads it); kinematic bodies are authored
+                            // each frame, so they render at the live pose with no snapshot — the
+                            // _prevPosition absence is exactly what the kinematic-drive query keys on.
+                            db.store.update(id, BodyType.isDynamic(bodyType) ? { _rapierBody: true, _prevPosition: p, _prevRotation: o } : { _rapierBody: true });
+                        }
+                    }
+                    for (const arch of db.store.queryArchetypes(STATIC, NEW_STATIC)) {
+                        const ids = arch.columns.id, cs = arch.columns.colliderShape, mat = arch.columns.material;
+                        const he = arch.columns.halfExtents, pos = arch.columns.position, ori = arch.columns.rotation;
+                        for (let r = arch.rowCount - 1; r >= 0; r--) {
+                            const id = ids.get(r), shape = cs.get(r), h = he.get(r), p = pos.get(r);
+                            if (!colliderReady(id, shape))
+                                continue; // auto-collider not generated yet
+                            ensureBody(id, "static", shape, h[0], h[1], h[2], mat.get(r), p[0], p[1], p[2], ori.get(r), 0, 0, 0, 0, 0, 0);
+                            db.store.update(id, { _rapierBody: true });
+                        }
+                    }
+                    // Mirror new joints once both their bodies exist (tag + exclude;
+                    // tail→head since tagging migrates the row). Anchors are body-local.
+                    for (const arch of db.store.queryArchetypes(JOINT, NEW_JOINT)) {
+                        const ids = arch.columns.id, jt = arch.columns.jointType;
+                        const ba = arch.columns.jointBodyA, bb = arch.columns.jointBodyB;
+                        const aa = arch.columns.jointAnchorA, ab = arch.columns.jointAnchorB, axc = arch.columns.jointAxis;
+                        const lo = arch.columns.jointMinLimit, hi = arch.columns.jointMaxLimit;
+                        for (let r = arch.rowCount - 1; r >= 0; r--) {
+                            const a = bodies.get(ba.get(r)), b = bodies.get(bb.get(r));
+                            if (!a || !b)
+                                continue; // a body isn't mirrored yet — retry next frame
+                            const type = jt.get(r), pa = aa.get(r), pb = ab.get(r), ax = axc.get(r), min = lo.get(r), max = hi.get(r);
+                            const A = { x: pa[0], y: pa[1], z: pa[2] }, B = { x: pb[0], y: pb[1], z: pb[2] };
+                            let jd;
+                            if (type === "fixed")
+                                jd = RAPIER.JointData.fixed(A, { x: 0, y: 0, z: 0, w: 1 }, B, { x: 0, y: 0, z: 0, w: 1 });
+                            else if (type === "hinge") {
+                                jd = RAPIER.JointData.revolute(A, B, { x: ax[0], y: ax[1], z: ax[2] });
+                                if (min < max) {
+                                    jd.limitsEnabled = true;
+                                    jd.limits = [min, max];
+                                }
+                            }
+                            // point — and cone: the rapier3d-compat binding has no cone/swing-twist
+                            // limit, so a `cone` joint is approximated as a free spherical (use joltSolver
+                            // for anatomical ragdoll limits; see physics/README.md).
+                            else
+                                jd = RAPIER.JointData.spherical(A, B);
+                            world.createImpulseJoint(jd, a, b, true);
+                            db.store.update(ids.get(r), { _rapierJoint: true });
+                        }
+                    }
+                    // Step on the fixed clock: 0..N steps of `fixedDt` this frame
+                    // (decoupled from the render rate). On a stepping frame, snapshot
+                    // the pose entering the final step into `_prevPosition`/`_prevRotation`
+                    // first, so the pre-render interpolator can blend prev→current.
+                    const clock = db.store.resources.physicsClock;
+                    const steps = clock.steps;
+                    if (steps === 0)
+                        return; // no sim time accrued — leave pose + snapshot intact
+                    // Drive kinematic bodies to their authored pose: Rapier moves a
+                    // position-based kinematic toward the target over the step, deriving
+                    // the velocity that pushes dynamics. (Author the pose however you like —
+                    // a system, animation, input — the solver just follows it.)
+                    const toFlip = []; // kinematic bodies whose bodyType became "dynamic" (ragdoll)
+                    for (const arch of db.store.queryArchetypes(KINEMATIC, KINEMATIC_ONLY)) {
+                        const ids = arch.columns.id, bt = arch.columns.bodyType;
+                        const pos = arch.columns.position.getTypedArray(), ori = arch.columns.rotation.getTypedArray();
+                        for (let r = 0; r < arch.rowCount; r++) {
+                            const body = bodies.get(ids.get(r));
+                            if (!body)
+                                continue;
+                            if (bt.get(r) === "dynamic") {
+                                toFlip.push(ids.get(r));
+                                continue;
+                            }
+                            const r3 = r * 3, r4 = r * 4;
+                            body.setNextKinematicTranslation({ x: pos[r3], y: pos[r3 + 1], z: pos[r3 + 2] });
+                            body.setNextKinematicRotation({ x: ori[r4], y: ori[r4 + 1], z: ori[r4 + 2], w: ori[r4 + 3] });
+                        }
+                    }
+                    // Flip kinematic→dynamic (after the loop, since migrating the row moves the
+                    // typed arrays): the engine body becomes dynamic and it gains the prev-pose
+                    // snapshot, so from now on it's simulated + written back like any dynamic body.
+                    for (const id of toFlip) {
+                        const body = bodies.get(id);
+                        if (!body)
+                            continue;
+                        body.setBodyType(RAPIER.RigidBodyType.Dynamic, true);
+                        const rec = db.store.read(id);
+                        db.store.update(id, {
+                            _prevPosition: [rec.position[0], rec.position[1], rec.position[2]],
+                            _prevRotation: [rec.rotation[0], rec.rotation[1], rec.rotation[2], rec.rotation[3]],
+                        });
+                    }
+                    for (const arch of db.store.queryArchetypes(SNAPSHOT)) {
+                        const bt = arch.columns.bodyType;
+                        const pos = arch.columns.position.getTypedArray(), ori = arch.columns.rotation.getTypedArray();
+                        const pp = arch.columns._prevPosition.getTypedArray(), pr = arch.columns._prevRotation.getTypedArray();
+                        for (let r = 0; r < arch.rowCount; r++) {
+                            if (!BodyType.isDynamic(bt.get(r)))
+                                continue;
+                            const r3 = r * 3, r4 = r * 4;
+                            pp[r3] = pos[r3];
+                            pp[r3 + 1] = pos[r3 + 1];
+                            pp[r3 + 2] = pos[r3 + 2];
+                            pr[r4] = ori[r4];
+                            pr[r4 + 1] = ori[r4 + 1];
+                            pr[r4 + 2] = ori[r4 + 2];
+                            pr[r4 + 3] = ori[r4 + 3];
+                        }
+                    }
+                    world.timestep = clock.fixedDt;
+                    for (let s = 0; s < steps; s++)
+                        world.step();
+                    // write the dynamic bodies' new pose + velocity back onto the canonical columns
+                    for (const arch of db.store.queryArchetypes(RIGID)) {
+                        const ids = arch.columns.id, bt = arch.columns.bodyType;
+                        const pos = arch.columns.position.getTypedArray(), ori = arch.columns.rotation.getTypedArray();
+                        const lv = arch.columns.linearVelocity.getTypedArray(), av = arch.columns.angularVelocity.getTypedArray();
+                        for (let r = 0; r < arch.rowCount; r++) {
+                            if (!BodyType.isDynamic(bt.get(r)))
+                                continue;
+                            const body = bodies.get(ids.get(r));
+                            if (!body)
+                                continue;
+                            // PERF residual: rapier3d-compat returns a fresh {x,y,z}/{x,y,z,w}
+                            // object from each of these getters → ~4 small allocations per
+                            // dynamic body per frame (GC pressure). It scales with the *dynamic*
+                            // count only (small for our target), and the compat binding offers
+                            // no out-param read, so it's left as-is. If dynamic counts ever get
+                            // large, drop to rapier's raw bindings (rawBodies / a flat buffer)
+                            // to read straight into our typed arrays with zero allocation.
+                            const t = body.translation(), rot = body.rotation(), v = body.linvel(), w = body.angvel();
+                            const r3 = r * 3, r4 = r * 4;
+                            pos[r3] = t.x;
+                            pos[r3 + 1] = t.y;
+                            pos[r3 + 2] = t.z;
+                            ori[r4] = rot.x;
+                            ori[r4 + 1] = rot.y;
+                            ori[r4 + 2] = rot.z;
+                            ori[r4 + 3] = rot.w;
+                            lv[r3] = v.x;
+                            lv[r3 + 1] = v.y;
+                            lv[r3 + 2] = v.z;
+                            av[r3] = w.x;
+                            av[r3 + 1] = w.y;
+                            av[r3 + 2] = w.z;
+                        }
+                    }
+                };
+            },
+        },
+    },
+});
+//# sourceMappingURL=rapier-solver-plugin.js.map

package/dist/physics/solvers/rapier-solver-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rapier-solver-plugin.js","sourceRoot":"","sources":["../../../src/physics/solvers/rapier-solver-plugin.ts"],"names":[],"mappings":"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"}

package/dist/physics/solvers/solver-benchmark.d.ts

@@ -0,0 +1,45 @@
+import { Database } from "@adobe/data/ecs";
+/**
+ * Headless benchmark harness for a physics **solver plugin** (anything built on
+ * the `physicsData` seam — `rapierSolver`, `joltSolver`, …). It builds a fixed,
+ * deterministic scene (a floor + a grid of bodies dropped to pile up), then
+ * advances the simulation at a fixed timestep as fast as the CPU allows and
+ * reports the wall-clock cost per frame. No rendering, no rAF, no GPU — so the
+ * numbers reflect solver compute only and are directly comparable across plugins.
+ *
+ * Async because some solvers (Rapier) initialise WASM lazily; the warm-up phase
+ * yields to the event loop so that init + scene settling complete before timing.
+ */
+export interface SolverBenchmarkOptions {
+    /** Dynamic bodies dropped into the scene (≈ workload size). Default 256. */
+    bodies?: number;
+    /** Timed frames. Default 300. */
+    frames?: number;
+    /** Warm-up frames before timing (lets async init finish + the pile settle). Default 90. */
+    warmupFrames?: number;
+    /** Fixed timestep per frame (seconds). Default 1/60. */
+    dt?: number;
+    /** Fraction of `bodies` that are spheres (rest are boxes). Default 0.5. */
+    sphereFraction?: number;
+    /** Extra *static* collider boxes laid out as resting scenery. They barely
+     *  cost the engine (nothing moves) but they ARE mirrored once and then scanned
+     *  by a naive per-frame sync — so this isolates the gather/sync overhead, which
+     *  is the realistic "many static, few dynamic" target workload. Default 0. */
+    staticBodies?: number;
+}
+export interface SolverBenchmarkResult {
+    bodies: number;
+    frames: number;
+    /** Total wall-clock time of the timed frames (ms). */
+    totalMs: number;
+    /** Mean cost of one frame (ms) — the headline number. */
+    msPerFrame: number;
+    /** Simulation frames per real second (1000 / msPerFrame). */
+    simFps: number;
+    /** Slowest single frame (ms) — surfaces hitches. */
+    maxFrameMs: number;
+    avgY: number;
+    maxSpeed: number;
+    belowFloor: number;
+}
+export declare function runSolverBenchmark(solver: Database.Plugin, opts?: SolverBenchmarkOptions): Promise<SolverBenchmarkResult>;

package/dist/physics/solvers/solver-benchmark.js

@@ -0,0 +1,115 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Database } from "@adobe/data/ecs";
+const yieldToEventLoop = () => new Promise(r => setTimeout(r, 0));
+export async function runSolverBenchmark(solver, opts = {}) {
+    const bodies = opts.bodies ?? 256;
+    const frames = opts.frames ?? 300;
+    const warmupFrames = opts.warmupFrames ?? 90;
+    const dt = opts.dt ?? 1 / 60;
+    const sphereFraction = opts.sphereFraction ?? 0.5;
+    const staticBodies = opts.staticBodies ?? 0;
+    // The solver plugin extends `physicsData`, so the RigidBody / StaticCollider
+    // archetypes and the `frameTime` resource exist on the created database. The
+    // benchmark drives the sim dynamically, so the store is used through a loose
+    // shape (runtime invariant: these members exist on any physicsData solver).
+    const db = Database.create(solver);
+    buildScene(db, bodies, sphereFraction, staticBodies);
+    // Drive one frame: set a fixed dt, then run every system except the rAF/clock
+    // ones (we supply dt ourselves so timing is deterministic and high-rate).
+    const order = db.system.order;
+    const names = order ? order.flat() : Object.keys(db.system.functions);
+    const runNames = names.filter(n => n !== "_frameTime" && n !== "schedulerSystem");
+    const tick = (f) => {
+        db.store.resources.frameTime = { now: f * dt * 1000, dt, elapsed: f * dt };
+        for (const n of runNames) {
+            const fn = db.system.functions[n];
+            if (fn)
+                fn();
+        }
+    };
+    // Warm-up: yield to the event loop so lazy WASM init (Rapier) completes and
+    // the pile settles into a steady-state contact count before we measure.
+    for (let f = 0; f < warmupFrames; f++) {
+        tick(f);
+        await yieldToEventLoop();
+    }
+    // Timed run: tight synchronous loop — pure solver compute.
+    let maxFrameMs = 0;
+    const t0 = performance.now();
+    for (let f = 0; f < frames; f++) {
+        const a = performance.now();
+        tick(warmupFrames + f);
+        const ms = performance.now() - a;
+        if (ms > maxFrameMs)
+            maxFrameMs = ms;
+    }
+    const totalMs = performance.now() - t0;
+    const { avgY, maxSpeed, belowFloor } = sampleState(db);
+    return {
+        bodies, frames,
+        totalMs, msPerFrame: totalMs / frames, simFps: 1000 / (totalMs / frames), maxFrameMs,
+        avgY, maxSpeed, belowFloor,
+    };
+}
+/** A thick static floor + `bodies` dynamic bodies in a compact cube grid that
+ *  drops a short distance and piles up — a steady-state contact workload. The
+ *  floor is deliberately thick (a finite box has a far side) and the drop is
+ *  short, so a correct solver never tunnels: end-state avgY/maxV then cleanly
+ *  separate a stable solver from an exploding one. Optional `staticBodies` adds
+ *  resting static scenery to exercise the sync/gather path at scale. */
+function buildScene(db, bodies, sphereFraction, staticBodies) {
+    db.store.archetypes.StaticCollider.insert({
+        colliderShape: "box", halfExtents: [12, 2, 12], material: 0,
+        position: [0, -2, 0], rotation: [0, 0, 0, 1], // top face at y = 0
+    });
+    // resting static scenery far from the action (negligible engine cost, but it
+    // is mirrored once and then scanned every frame by a naive per-frame sync)
+    if (staticBodies > 0) {
+        const side = Math.ceil(Math.cbrt(staticBodies));
+        let n = 0;
+        for (let x = 0; x < side && n < staticBodies; x++)
+            for (let y = 0; y < side && n < staticBodies; y++)
+                for (let z = 0; z < side && n < staticBodies; z++, n++)
+                    db.store.archetypes.StaticCollider.insert({
+                        colliderShape: "box", halfExtents: [0.4, 0.4, 0.4], material: 0,
+                        position: [100 + x, y, z], rotation: [0, 0, 0, 1],
+                    });
+    }
+    const side = Math.ceil(Math.cbrt(bodies));
+    const gap = 1.5, base = -((side - 1) / 2) * gap; // spaced so the initial drop is non-overlapping
+    let n = 0;
+    for (let y = 0; y < side && n < bodies; y++) {
+        for (let x = 0; x < side && n < bodies; x++) {
+            for (let z = 0; z < side && n < bodies; z++, n++) {
+                const sphere = ((n * 0x9e3779b1) >>> 0) / 4294967296 < sphereFraction;
+                db.store.archetypes.RigidBody.insert({
+                    bodyType: "dynamic",
+                    colliderShape: sphere ? "sphere" : "box",
+                    halfExtents: sphere ? [0.45, 0, 0] : [0.45, 0.45, 0.45],
+                    material: 0,
+                    position: [base + x * gap, 0.6 + y * gap, base + z * gap],
+                    rotation: [0, 0, 0, 1],
+                    linearVelocity: [0, 0, 0],
+                    angularVelocity: [0, 0, 0],
+                });
+            }
+        }
+    }
+}
+function sampleState(db) {
+    let count = 0, sumY = 0, maxSpeed = 0, belowFloor = 0;
+    for (const arch of db.store.queryArchetypes(["linearVelocity", "position"])) {
+        const pos = arch.columns.position.getTypedArray(), lv = arch.columns.linearVelocity.getTypedArray();
+        for (let r = 0; r < arch.rowCount; r++, count++) {
+            const r3 = r * 3, y = pos[r3 + 1];
+            sumY += y;
+            if (y < -0.5)
+                belowFloor++; // floor top is y = 0; a resting body sits above it
+            const sp = Math.hypot(lv[r3], lv[r3 + 1], lv[r3 + 2]);
+            if (sp > maxSpeed)
+                maxSpeed = sp;
+        }
+    }
+    return { avgY: count ? sumY / count : 0, maxSpeed, belowFloor };
+}
+//# sourceMappingURL=solver-benchmark.js.map

package/dist/physics/solvers/solver-benchmark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solver-benchmark.js","sourceRoot":"","sources":["../../../src/physics/solvers/solver-benchmark.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@adobe/data-gpu",
+  "version": "0.9.69",
+  "description": "Adobe data WebGPU plugins and types for graphics and compute",
+  "type": "module",
+  "private": false,
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "sideEffects": false,
+  "dependencies": {
+    "@dimforge/rapier3d-compat": "^0.19.3",
+    "jolt-physics": "^1.0.0",
+    "@adobe/data": "0.9.69"
+  },
+  "devDependencies": {
+    "@webgpu/types": "^0.1.61",
+    "typescript": "^5.8.3",
+    "vitest": "^1.6.0"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "cp ../../LICENSE . && tsc -b",
+    "dev": "tsc -b -w",
+    "test": "vitest --run --passWithNoTests",
+    "publish-public": "pnpm build && pnpm publish --no-git-checks --access public"
+  }
+}

package/src/core/core-plugin.ts

@@ -0,0 +1,92 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import { Database, scheduler } from "@adobe/data/ecs";
+import { FrameTime } from "./frame-time/frame-time.js";
+
+async function getWebGPUDevice() {
+    // Guard for headless hosts (Node) where `navigator` doesn't exist: the
+    // simulation runs without a GPU device; only rendering needs one.
+    if (typeof navigator === "undefined" || !navigator.gpu) {
+        return null;
+    }
+    const adapter = await navigator.gpu.requestAdapter();
+    if (!adapter) {
+        return null;
+    }
+    return adapter.requestDevice();
+}
+
+/**
+ * GPU runtime + frame scheduler — the shared base for both `graphics`
+ * (presentation) and `physics` (compute). Owns the WebGPU device, the
+ * per-frame command encoder, and the ordered frame phases. Contains nothing
+ * about canvases or render passes — those live in `graphics`.
+ *
+ * Phase order: input → preUpdate → update → postUpdate → physics → preRender
+ * → render → postRender. The command encoder is created at `preUpdate` and
+ * submitted at `postRender`; consumers record render passes (graphics) or
+ * compute passes (physics) into it during the phases between.
+ *
+ * Composes `FrameTime` over the scheduler so every downstream system has the
+ * `frameTime` resource — per-frame `dt` / `elapsed` — without re-deriving it.
+ */
+export const core = Database.Plugin.create({
+    extends: Database.Plugin.combine(scheduler, FrameTime.plugin),
+    resources: {
+        device: { default: null as GPUDevice | null, transient: true },
+        commandEncoder: { default: null as GPUCommandEncoder | null, transient: true },
+    },
+    systems: {
+        input: {
+            create: _db => () => {},
+        },
+        preUpdate: {
+            create: db => () => {
+                const { device } = db.store.resources;
+                if (device) {
+                    db.store.resources.commandEncoder = device.createCommandEncoder();
+                }
+            },
+            schedule: { after: ["input"] },
+        },
+        update: {
+            create: _db => () => {},
+            schedule: { after: ["preUpdate"] },
+        },
+        postUpdate: {
+            create: _db => () => {},
+            schedule: { after: ["update"] },
+        },
+        physics: {
+            create: _db => () => {},
+            schedule: { after: ["postUpdate"] },
+        },
+        preRender: {
+            create: _db => () => {},
+            schedule: { after: ["physics"] },
+        },
+        render: {
+            create: db => {
+                getWebGPUDevice().then(device => {
+                    db.store.resources.device = device;
+                });
+                return () => {};
+            },
+            schedule: { after: ["preRender"] },
+        },
+        // Submits the frame's command encoder. Graphics ends its render pass
+        // `before: ["postRender"]` (so the pass is closed first); physics
+        // finishes its compute passes during the `physics` phase — both record
+        // into this encoder beforehand.
+        postRender: {
+            create: db => () => {
+                const { commandEncoder, device } = db.store.resources;
+                if (commandEncoder && device) {
+                    device.queue.submit([commandEncoder.finish()]);
+                    db.store.resources.commandEncoder = null;
+                }
+            },
+            schedule: { after: ["render"] },
+        },
+    },
+});