@adobe/data-gpu 0.9.87 → 0.9.88

package/dist/physics/physics-data-plugin.js

@@ -36,6 +36,11 @@ import { STATIC_COLLIDER_COMPONENTS } from "./static-collider-components.js";
  * body the first time it mirrors it, so authors never supply derived state.
  *
  * Mass + inertia are derived per solver from shape + material (not stored here).
+ *
+ * Besides the authored model, this seam declares the pluggable spatial-query
+ * contract every solver fulfils: a `physicsQuery` resource (the active solver
+ * publishes its engine-backed implementation once its world is live) and a
+ * `pickRay` action that delegates to it — so ray/line picking is solver-agnostic.
  */
 export const physicsData = Database.Plugin.create({
     extends: Material.plugin, // brings the `material` reference component
@@ -61,6 +66,13 @@ export const physicsData = Database.Plugin.create({
         convexPoints: { default: null }, // colliderShape "hull": point cloud → convex hull
         colliderMesh: { default: null }, // colliderShape "mesh": static triangle soup
     },
+    resources: {
+        // The pluggable spatial-query seam: the active solver publishes its
+        // engine-backed implementation here once its world is live, so picking
+        // is solver-agnostic. Null before then (lazy WASM init) and when no
+        // solver is combined in. Runtime object → nonPersistent.
+        physicsQuery: { default: null, nonPersistent: true },
+    },
     archetypes: {
         RigidBody: [...RIGID_BODY_COMPONENTS],
         StaticCollider: [...STATIC_COLLIDER_COMPONENTS],
@@ -69,5 +81,19 @@ export const physicsData = Database.Plugin.create({
         // A static triangle-mesh collider (terrain / level geometry).
         MeshCollider: [...STATIC_COLLIDER_COMPONENTS, "colliderMesh"],
     },
+    actions: {
+        // Consumer surface for engine-backed picking. An action (not a
+        // transaction) because it returns a value; a pure delegate to whatever
+        // solver filled `physicsQuery` — `physicsData` itself holds no engine
+        // knowledge. Returns null until a solver's world is live.
+        pickRay(db, args) {
+            return db.resources.physicsQuery?.castRay(args.ray, { radius: args.radius }) ?? null;
+        },
+        // Visit every collider along the ray, nearest first (see PhysicsQuery.castRayEach).
+        // Returns void; no-op until a solver's world is live.
+        pickRayEach(db, args) {
+            db.resources.physicsQuery?.castRayEach(args.ray, args.visit, { radius: args.radius });
+        },
+    },
 });
 //# sourceMappingURL=physics-data-plugin.js.map

package/dist/physics/physics-data-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"physics-data-plugin.js","sourceRoot":"","sources":["../../src/physics/physics-data-plugin.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAExE,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAI,4CAA4C;IACxE,UAAU,EAAE;QACR,QAAQ,EAAS,QAAQ,CAAC,MAAM;QAChC,aAAa,EAAI,aAAa,CAAC,MAAM;QACrC,WAAW,EAAM,IAAI,CAAC,MAAM,EAAI,mCAAmC;QACnE,QAAQ,EAAS,IAAI,CAAC,MAAM;QAC5B,QAAQ,EAAS,IAAI,CAAC,MAAM,EAAE,wDAAwD;QACtF,cAAc,EAAG,IAAI,CAAC,MAAM;QAC5B,eAAe,EAAE,IAAI,CAAC,MAAM;QAC5B,aAAa,EAAI,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,kEAAkE;QAC5H,aAAa,EAAI,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE;QACxD,2EAA2E;QAC3E,yEAAyE;QACzE,wEAAwE;QACxE,2EAA2E;QAC3E,8EAA8E;QAC9E,cAAc,EAAG,GAAG,CAAC,MAAM;QAC3B,uEAAuE;QACvE,2EAA2E;QAC3E,sEAAsE;QACtE,YAAY,EAAK,EAAE,OAAO,EAAE,IAA2B,EAAE,EAAE,kDAAkD;QAC7G,YAAY,EAAK,EAAE,OAAO,EAAE,IAA2B,EAAE,EAAE,6CAA6C;KAC3G;IACD,UAAU,EAAE;QACR,SAAS,EAAE,CAAC,GAAG,qBAAqB,CAAC;QACrC,cAAc,EAAE,CAAC,GAAG,0BAA0B,CAAC;QAC/C,uEAAuE;QACvE,UAAU,EAAE,CAAC,GAAG,qBAAqB,EAAE,cAAc,CAAC;QACtD,8DAA8D;QAC9D,YAAY,EAAE,CAAC,GAAG,0BAA0B,EAAE,cAAc,CAAC;KAChE;CACJ,CAAC,CAAC"}
+{"version":3,"file":"physics-data-plugin.js","sourceRoot":"","sources":["../../src/physics/physics-data-plugin.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAc,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAExE,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAI7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAI,4CAA4C;IACxE,UAAU,EAAE;QACR,QAAQ,EAAS,QAAQ,CAAC,MAAM;QAChC,aAAa,EAAI,aAAa,CAAC,MAAM;QACrC,WAAW,EAAM,IAAI,CAAC,MAAM,EAAI,mCAAmC;QACnE,QAAQ,EAAS,IAAI,CAAC,MAAM;QAC5B,QAAQ,EAAS,IAAI,CAAC,MAAM,EAAE,wDAAwD;QACtF,cAAc,EAAG,IAAI,CAAC,MAAM;QAC5B,eAAe,EAAE,IAAI,CAAC,MAAM;QAC5B,aAAa,EAAI,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,kEAAkE;QAC5H,aAAa,EAAI,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE;QACxD,2EAA2E;QAC3E,yEAAyE;QACzE,wEAAwE;QACxE,2EAA2E;QAC3E,8EAA8E;QAC9E,cAAc,EAAG,GAAG,CAAC,MAAM;QAC3B,uEAAuE;QACvE,2EAA2E;QAC3E,sEAAsE;QACtE,YAAY,EAAK,EAAE,OAAO,EAAE,IAA2B,EAAE,EAAE,kDAAkD;QAC7G,YAAY,EAAK,EAAE,OAAO,EAAE,IAA2B,EAAE,EAAE,6CAA6C;KAC3G;IACD,SAAS,EAAE;QACP,oEAAoE;QACpE,uEAAuE;QACvE,oEAAoE;QACpE,yDAAyD;QACzD,YAAY,EAAE,EAAE,OAAO,EAAE,IAA2B,EAAE,aAAa,EAAE,IAAI,EAAE;KAC9E;IACD,UAAU,EAAE;QACR,SAAS,EAAE,CAAC,GAAG,qBAAqB,CAAC;QACrC,cAAc,EAAE,CAAC,GAAG,0BAA0B,CAAC;QAC/C,uEAAuE;QACvE,UAAU,EAAE,CAAC,GAAG,qBAAqB,EAAE,cAAc,CAAC;QACtD,8DAA8D;QAC9D,YAAY,EAAE,CAAC,GAAG,0BAA0B,EAAE,cAAc,CAAC;KAChE;IACD,OAAO,EAAE;QACL,+DAA+D;QAC/D,uEAAuE;QACvE,sEAAsE;QACtE,0DAA0D;QAC1D,OAAO,CAAC,EAAE,EAAE,IAAqC;YAC7C,OAAO,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,CAAC;QACzF,CAAC;QACD,oFAAoF;QACpF,sDAAsD;QACtD,WAAW,CAAC,EAAE,EAAE,IAAiF;YAC7F,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1F,CAAC;KACJ;CACJ,CAAC,CAAC"}

package/dist/physics/physics-hit.d.ts

@@ -0,0 +1,18 @@
+import type { Entity } from "@adobe/data/ecs";
+import type { Vec3 } from "@adobe/data/math";
+/**
+ * One physics ray-pick result — the body/collider the ray hit plus the
+ * geometry of the hit the engine's broadphase can give that an AABB scan
+ * cannot.
+ *
+ * `distance` uses the same parametric convention as the graphics `PickHit`
+ * (α ∈ [0,1] along the `Line3` segment, 0 = near point `a`, 1 = far point
+ * `b`), so `PhysicsHit` is a structural superset of `PickHit` and `distance`
+ * reads the same in both picking systems. The absolute hit location is `point`.
+ */
+export interface PhysicsHit {
+    readonly entity: Entity;
+    readonly distance: number;
+    readonly point: Vec3;
+    readonly normal: Vec3;
+}

package/dist/physics/physics-hit.js

@@ -0,0 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export {};
+//# sourceMappingURL=physics-hit.js.map

package/dist/physics/physics-hit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"physics-hit.js","sourceRoot":"","sources":["../../src/physics/physics-hit.ts"],"names":[],"mappings":"AAAA,uDAAuD"}

package/dist/physics/physics-query.d.ts

@@ -0,0 +1,43 @@
+import type { Line3 } from "@adobe/data/math";
+import type { PhysicsHit } from "./physics-hit.js";
+/**
+ * The solver-agnostic spatial-query capability — the pluggable seam for
+ * engine-backed picking. Whichever solver is active (`rapierSolver`,
+ * `joltSolver`, …) publishes an implementation of this interface into the
+ * `physicsQuery` resource once its world is live; consumers reach it through
+ * the `pickRay` action (or read the resource directly for advanced use).
+ *
+ * `castRay` returns the nearest collider along the `Line3` segment, or `null`
+ * for a miss. `castRayEach` visits *every* collider along the segment, nearest
+ * first. `radius` (omitted / 0 → an infinitely-thin ray; > 0 → a sphere of that
+ * radius swept along the segment) covers "pick along a line with or without
+ * radius" behind one call. Both reference solvers back these with their native
+ * ray / shape cast (Rapier `castRayAndGetNormal` / `castShape` /
+ * `intersectionsWithRay`; Jolt `NarrowPhaseQuery.CastRay` / `CastShape` with
+ * all-hit collectors).
+ */
+export interface PhysicsQuery {
+    castRay(ray: Line3, options?: {
+        radius?: number;
+    }): PhysicsHit | null;
+    /**
+     * Visit each collider crossed by the segment, **nearest first**, calling
+     * `visit` once per crossing. Return `false` from `visit` to stop early (any
+     * other return continues).
+     *
+     * Zero-allocation: `visit` receives a **single reused hit** that is valid
+     * only for the duration of that call — read what you need (or copy fields
+     * out); do not retain the object or its `point` / `normal` arrays past the
+     * callback. (`castRay` returns a fresh, retainable hit; use it when you need
+     * to keep one.)
+     *
+     * `radius > 0` sweeps a sphere: fully supported on solvers with a native
+     * swept-shape all-hits query (Jolt); where the engine binding lacks one
+     * (the Rapier compat binding), a radius query degrades to visiting only the
+     * nearest hit. A thin ray (`radius` omitted / 0) visits all crossings on
+     * every solver.
+     */
+    castRayEach(ray: Line3, visit: (hit: PhysicsHit) => boolean | void, options?: {
+        radius?: number;
+    }): void;
+}

package/dist/physics/physics-query.js

@@ -0,0 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export {};
+//# sourceMappingURL=physics-query.js.map

package/dist/physics/physics-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"physics-query.js","sourceRoot":"","sources":["../../src/physics/physics-query.ts"],"names":[],"mappings":"AAAA,uDAAuD"}

package/dist/physics/public.d.ts

@@ -1,4 +1,6 @@
 export * from "./physics-data-plugin.js";
+export * from "./physics-hit.js";
+export * from "./physics-query.js";
 export * from "./rigid-body-components.js";
 export * from "./static-collider-components.js";
 export * from "./collider-primitive-render-archetypes.js";

package/dist/physics/public.js

@@ -1,5 +1,7 @@
 // © 2026 Adobe. MIT License. See /LICENSE for details.
 export * from "./physics-data-plugin.js";
+export * from "./physics-hit.js";
+export * from "./physics-query.js";
 export * from "./rigid-body-components.js";
 export * from "./static-collider-components.js";
 export * from "./collider-primitive-render-archetypes.js";

package/dist/physics/public.js.map

@@ -1 +1 @@
-{"version":3,"file":"public.js","sourceRoot":"","sources":["../../src/physics/public.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,0CAA0C,CAAC;AACzD,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kCAAkC,CAAC;AACjD,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yCAAyC,CAAC;AACxD,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC;AACtD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../src/physics/public.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,0CAA0C,CAAC;AACzD,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kCAAkC,CAAC;AACjD,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yCAAyC,CAAC;AACxD,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC;AACtD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC"}