@adobe/data-gpu 0.9.69

package/dist/graphics/picking/picking-plugin.js

@@ -0,0 +1,88 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Database } from "@adobe/data/ecs";
+import { Aabb } from "@adobe/data/math";
+import { True } from "@adobe/data/schema";
+import { Camera } from "../camera/camera.js";
+import { screenToWorldRay } from "../camera/screen-to-world-ray.js";
+import { worldBounds } from "../scene/model/world-bounds-plugin.js";
+/**
+ * Picking — ray-against-PickableModel hit testing.
+ *
+ * `PickableModel` extends `Model` with a `pickable` flag. The archetype
+ * gives a clean opt-in: insert via `insertPickableModel` and the entity
+ * participates in picking; plain `Model` entities are invisible to the
+ * ray-caster.
+ *
+ * `pickRay(ray)` scans every visible PickableModel with a `_worldBounds`
+ * column. `pickFromScreen({ x, y })` takes pixel coords (e.g. from
+ * `offsetX` / `offsetY` on a pointer event), converts them to NDC
+ * (Normalized Device Coordinates, x/y ∈ [-1, 1], origin at center),
+ * then reconstructs the eye→cursor ray and delegates to `pickRay`.
+ *
+ * Exposed as **actions** (not transactions) because picks return a
+ * `PickHit | null` value — transactions are restricted to `Entity | void`.
+ *
+ * Future: replace the linear scan with a `broadphase` resource of type
+ * `Broadphase` exposing `queryRay(ray, cb)` and `queryAabb(box, cb)`.
+ */
+const pickingBase = Database.Plugin.create({
+    extends: Database.Plugin.combine(worldBounds, Camera.plugin),
+    components: {
+        pickable: True.schema,
+    },
+    archetypes: {
+        PickableModel: ["geometry", "position", "rotation", "scale", "visible", "parent", "pickable"],
+    },
+    transactions: {
+        insertPickableModel(t, args) {
+            return t.archetypes.PickableModel.insert({
+                geometry: args.geometry,
+                position: args.position ?? [0, 0, 0],
+                rotation: args.rotation ?? [0, 0, 0, 1],
+                scale: args.scale ?? [1, 1, 1],
+                visible: true,
+                parent: args.parent ?? 0,
+                pickable: true,
+            });
+        },
+    },
+});
+const pickRayImpl = (db, ray) => {
+    let best = null;
+    for (const arch of db.queryArchetypes([
+        "geometry", "visible", "pickable", "_worldBounds",
+    ])) {
+        const ids = arch.columns.id;
+        const vis = arch.columns.visible;
+        const bounds = arch.columns._worldBounds;
+        for (let i = 0; i < arch.rowCount; i++) {
+            if (!vis.get(i))
+                continue;
+            const alpha = Aabb.lineIntersection(bounds.get(i), ray);
+            if (alpha < 0)
+                continue;
+            if (best === null || alpha < best.distance) {
+                best = { entity: ids.get(i), distance: alpha };
+            }
+        }
+    }
+    return best;
+};
+export const picking = Database.Plugin.create({
+    extends: pickingBase,
+    actions: {
+        pickRay(db, ray) {
+            return pickRayImpl(db, ray);
+        },
+        pickFromScreen(db, args) {
+            const cam = db.resources.camera;
+            const canvas = db.resources.canvas;
+            if (!cam || !canvas)
+                return null;
+            // Convert pixel coords → NDC (x/y ∈ [-1, 1], origin at canvas center).
+            const ray = screenToWorldRay(cam, args.x, args.y, canvas.width, canvas.height);
+            return pickRayImpl(db, ray);
+        },
+    },
+});
+//# sourceMappingURL=picking-plugin.js.map

package/dist/graphics/picking/picking-plugin.js.map

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