@adobe/data-gpu 0.9.69

package/dist/graphics/camera/orbit/orbit-system-plugin.js

@@ -0,0 +1,71 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Database } from "@adobe/data/ecs";
+import { orbitData } from "./orbit-data-plugin.js";
+/**
+ * Systems that drive `camera` from the `orbit` resource each frame.
+ *
+ * - **_orbitCameraSystem**: updates camera position/target/near/far from the
+ *   orbit polar coords; auto-spins when `orbit.autoSpin` is true.
+ * - **_orbitAutoFitSystem**: when `orbit.fitGeometry` is non-zero, reads that
+ *   Geometry's `_bounds`, sizes the orbit to fit, and zeroes the field.
+ */
+export const orbitSystem = Database.Plugin.create({
+    extends: orbitData,
+    systems: {
+        _orbitCameraSystem: {
+            create: db => {
+                return () => {
+                    const { orbit, camera: cam } = db.store.resources;
+                    if (!cam)
+                        return;
+                    if (orbit.autoSpin) {
+                        const dt = db.store.resources.frameTime.dt;
+                        db.store.resources.orbit = { ...orbit, angle: orbit.angle + dt * orbit.autoSpinSpeed };
+                    }
+                    const angle = db.store.resources.orbit.angle;
+                    db.store.resources.camera = {
+                        ...cam,
+                        position: [
+                            orbit.center[0] + Math.sin(angle) * orbit.radius,
+                            orbit.center[1] + orbit.height,
+                            orbit.center[2] + Math.cos(angle) * orbit.radius,
+                        ],
+                        target: orbit.center,
+                        nearPlane: Math.max(orbit.radius * orbit.nearFactor, 0.1),
+                        farPlane: Math.max(orbit.radius * orbit.farFactor, 100),
+                    };
+                };
+            },
+            schedule: { during: ["update"] },
+        },
+        _orbitAutoFitSystem: {
+            create: db => () => {
+                const orbit = db.store.resources.orbit;
+                if (!orbit.fitGeometry)
+                    return;
+                // orbit.fitGeometry holds a Geometry entity id. `_bounds` lives
+                // on modelLoader's schema, which orbit doesn't extend — read as
+                // unknown and narrow manually.
+                const entity = db.store.read(orbit.fitGeometry);
+                const bounds = entity?._bounds;
+                if (!bounds)
+                    return;
+                const size = Math.max(bounds.max[0] - bounds.min[0], bounds.max[1] - bounds.min[1], bounds.max[2] - bounds.min[2]);
+                const center = orbit.fitCenter ?? [
+                    (bounds.min[0] + bounds.max[0]) / 2,
+                    (bounds.min[1] + bounds.max[1]) / 2,
+                    (bounds.min[2] + bounds.max[2]) / 2,
+                ];
+                db.store.resources.orbit = {
+                    ...orbit,
+                    center,
+                    radius: size * orbit.fitRadiusFactor + orbit.fitRadiusOffset,
+                    height: size * orbit.fitHeightFactor,
+                    fitGeometry: 0,
+                };
+            },
+            schedule: { during: ["preUpdate"] },
+        },
+    },
+});
+//# sourceMappingURL=orbit-system-plugin.js.map

package/dist/graphics/camera/orbit/orbit-system-plugin.js.map

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

package/dist/graphics/camera/orbit/orbit.d.ts

@@ -0,0 +1,32 @@
+import type { Vec3 } from "@adobe/data/math";
+/**
+ * Orbit camera state — a polar arrangement around a center point with an
+ * auto-spin and a one-shot auto-fit to a Geometry's bounds.
+ *
+ *   - `center` / `radius` / `height` / `angle` define the camera placement.
+ *   - `nearFactor` / `farFactor` scale the near and far planes so they
+ *     track the orbit radius (models authored in any unit render without
+ *     clipping).
+ *   - `autoSpin` / `autoSpinSpeed` rotate the camera each frame when the
+ *     user isn't dragging.
+ *   - `fitGeometry` is an entity id; when non-zero, the auto-fit system
+ *     reads that Geometry's bounds on the first available frame, sizes the
+ *     orbit, and zeros the field. `fitRadiusFactor` / `fitHeightFactor` /
+ *     `fitRadiusOffset` / `fitCenter` shape the fit.
+ */
+export interface Orbit {
+    center: Vec3;
+    radius: number;
+    height: number;
+    angle: number;
+    autoSpin: boolean;
+    autoSpinSpeed: number;
+    nearFactor: number;
+    farFactor: number;
+    fitGeometry: number;
+    fitRadiusFactor: number;
+    fitHeightFactor: number;
+    fitRadiusOffset: number;
+    fitCenter: Vec3 | null;
+}
+export * as Orbit from "./public.js";

package/dist/graphics/camera/orbit/orbit.js

@@ -0,0 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export * as Orbit from "./public.js";
+//# sourceMappingURL=orbit.js.map

package/dist/graphics/camera/orbit/orbit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orbit.js","sourceRoot":"","sources":["../../../../src/graphics/camera/orbit/orbit.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAmCvD,OAAO,KAAK,KAAK,MAAM,aAAa,CAAC"}

package/dist/graphics/camera/orbit/public.d.ts

@@ -0,0 +1,5 @@
+export { plugin } from "./orbit-plugin.js";
+export { orbitData } from "./orbit-data-plugin.js";
+export { orbitSystem } from "./orbit-system-plugin.js";
+export { attachOrbitDrag } from "./attach-orbit-drag.js";
+export type { OrbitDragService } from "./attach-orbit-drag.js";

package/dist/graphics/camera/orbit/public.js

@@ -0,0 +1,6 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export { plugin } from "./orbit-plugin.js";
+export { orbitData } from "./orbit-data-plugin.js";
+export { orbitSystem } from "./orbit-system-plugin.js";
+export { attachOrbitDrag } from "./attach-orbit-drag.js";
+//# sourceMappingURL=public.js.map

package/dist/graphics/camera/orbit/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../../src/graphics/camera/orbit/public.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/graphics/camera/public.d.ts

@@ -0,0 +1,4 @@
+export * from "./schema.js";
+export * from "./to-view-projection.js";
+export * from "./screen-to-world-ray.js";
+export { plugin } from "./camera-plugin.js";

package/dist/graphics/camera/public.js

@@ -0,0 +1,6 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export * from "./schema.js";
+export * from "./to-view-projection.js";
+export * from "./screen-to-world-ray.js";
+export { plugin } from "./camera-plugin.js";
+//# sourceMappingURL=public.js.map

package/dist/graphics/camera/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../src/graphics/camera/public.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/graphics/camera/schema.d.ts

@@ -0,0 +1,65 @@
+export declare const schema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly aspect: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly fieldOfView: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly nearPlane: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly farPlane: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly position: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly minItems: 3;
+            readonly maxItems: 3;
+            readonly default: readonly [0, 0, 0];
+        };
+        readonly target: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly minItems: 3;
+            readonly maxItems: 3;
+            readonly default: readonly [0, 0, 0];
+        };
+        readonly up: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly minItems: 3;
+            readonly maxItems: 3;
+            readonly default: readonly [0, 0, 0];
+        };
+        readonly orthographic: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+    };
+    readonly required: readonly ["aspect", "fieldOfView", "nearPlane", "farPlane", "position", "target", "up", "orthographic"];
+    readonly additionalProperties: false;
+};

package/dist/graphics/camera/schema.js

@@ -0,0 +1,19 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { F32, Vec3 } from "@adobe/data/math";
+export const schema = {
+    type: "object",
+    properties: {
+        aspect: F32.schema,
+        fieldOfView: F32.schema,
+        nearPlane: F32.schema,
+        farPlane: F32.schema,
+        position: Vec3.schema,
+        target: Vec3.schema,
+        up: Vec3.schema,
+        // 0 = perspective, 1 = orthographic, fractional = hybrid blend
+        orthographic: F32.schema,
+    },
+    required: ["aspect", "fieldOfView", "nearPlane", "farPlane", "position", "target", "up", "orthographic"],
+    additionalProperties: false,
+};
+//# sourceMappingURL=schema.js.map

package/dist/graphics/camera/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/graphics/camera/schema.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAG7C,MAAM,CAAC,MAAM,MAAM,GAAG;IAClB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACR,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,WAAW,EAAE,GAAG,CAAC,MAAM;QACvB,SAAS,EAAE,GAAG,CAAC,MAAM;QACrB,QAAQ,EAAE,GAAG,CAAC,MAAM;QACpB,QAAQ,EAAE,IAAI,CAAC,MAAM;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,EAAE,EAAE,IAAI,CAAC,MAAM;QACf,+DAA+D;QAC/D,YAAY,EAAE,GAAG,CAAC,MAAM;KAC3B;IACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,CAAC;IACxG,oBAAoB,EAAE,KAAK;CACJ,CAAC"}

package/dist/graphics/camera/screen-to-world-ray.d.ts

@@ -0,0 +1,10 @@
+import { Line3 } from "@adobe/data/math";
+import type { Camera } from "./camera.js";
+/**
+ * Builds a world-space ray from a canvas pixel coordinate.
+ * Pixel origin is top-left (matching `offsetX`/`offsetY` on pointer events).
+ * Internally converts to NDC (Normalized Device Coordinates: x/y ∈ [-1, 1],
+ * origin at canvas center, y-up) before unprojecting via the inverse
+ * view-projection matrix.
+ */
+export declare const screenToWorldRay: (cam: Camera, screenX: number, screenY: number, canvasWidth: number, canvasHeight: number, rayLength?: number) => Line3;

package/dist/graphics/camera/screen-to-world-ray.js

@@ -0,0 +1,31 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Mat4x4 } from "@adobe/data/math";
+import { toViewProjection } from "./to-view-projection.js";
+/**
+ * Builds a world-space ray from a canvas pixel coordinate.
+ * Pixel origin is top-left (matching `offsetX`/`offsetY` on pointer events).
+ * Internally converts to NDC (Normalized Device Coordinates: x/y ∈ [-1, 1],
+ * origin at canvas center, y-up) before unprojecting via the inverse
+ * view-projection matrix.
+ */
+export const screenToWorldRay = (cam, screenX, screenY, canvasWidth, canvasHeight, rayLength = 1000) => {
+    // NDC: x ∈ [-1, 1] left→right, y ∈ [-1, 1] bottom→top.
+    const ndcX = (screenX / canvasWidth) * 2 - 1;
+    const ndcY = 1 - (screenY / canvasHeight) * 2;
+    // WebGPU NDC z ∈ [0, 1]: near plane at 0, far plane at 1.
+    const nearPoint = [ndcX, ndcY, 0, 1];
+    const farPoint = [ndcX, ndcY, 1, 1];
+    const invVP = Mat4x4.inverse(toViewProjection(cam));
+    const nearW = Mat4x4.multiplyVec4(invVP, nearPoint);
+    const farW = Mat4x4.multiplyVec4(invVP, farPoint);
+    const near = [nearW[0] / nearW[3], nearW[1] / nearW[3], nearW[2] / nearW[3]];
+    const far = [farW[0] / farW[3], farW[1] / farW[3], farW[2] / farW[3]];
+    const dir = [near[0] - far[0], near[1] - far[1], near[2] - far[2]];
+    const len = Math.sqrt(dir[0] ** 2 + dir[1] ** 2 + dir[2] ** 2);
+    if (len < 0.0001)
+        return { a: near, b: far };
+    const norm = [dir[0] / len, dir[1] / len, dir[2] / len];
+    const end = [near[0] + norm[0] * rayLength, near[1] + norm[1] * rayLength, near[2] + norm[2] * rayLength];
+    return { a: near, b: end };
+};
+//# sourceMappingURL=screen-to-world-ray.js.map

package/dist/graphics/camera/screen-to-world-ray.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-to-world-ray.js","sourceRoot":"","sources":["../../../src/graphics/camera/screen-to-world-ray.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,MAAM,EAAqB,MAAM,kBAAkB,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC5B,GAAW,EACX,OAAe,EACf,OAAe,EACf,WAAmB,EACnB,YAAoB,EACpB,SAAS,GAAG,IAAI,EACX,EAAE;IACP,uDAAuD;IACvD,MAAM,IAAI,GAAG,CAAC,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAE9C,0DAA0D;IAC1D,MAAM,SAAS,GAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAE1C,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;IAEpD,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAElD,MAAM,IAAI,GAAS,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,GAAG,GAAS,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5E,MAAM,GAAG,GAAS,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAE/D,IAAI,GAAG,GAAG,MAAM;QAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IAE7C,MAAM,IAAI,GAAS,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAS,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAEhH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;AAC/B,CAAC,CAAC"}

package/dist/graphics/camera/to-view-projection.d.ts

@@ -0,0 +1,3 @@
+import { Mat4x4 } from "@adobe/data/math";
+import type { Camera } from "./camera.js";
+export declare const toViewProjection: (cam: Camera) => Mat4x4;

package/dist/graphics/camera/to-view-projection.js

@@ -0,0 +1,23 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Mat4x4, Vec3 } from "@adobe/data/math";
+export const toViewProjection = (cam) => {
+    const lookAt = Mat4x4.lookAt(cam.position, cam.target, cam.up);
+    const f = 1.0 / Math.tan(cam.fieldOfView / 2);
+    const d = Vec3.distance(cam.position, cam.target);
+    // WebGPU clip-space convention: z_ndc ∈ [0, 1].
+    // Perspective wants m[2][2] = far/(near-far); orthographic wants d/(near-far)
+    // so that z_clip(z_view = -far) = (perspective: far / w_clip=far → 1)
+    //                                  (orthographic: d / w_clip=d → 1).
+    // Blend the two cases by the orthographic factor.
+    const m22 = ((1 - cam.orthographic) * cam.farPlane + cam.orthographic * d) / (cam.nearPlane - cam.farPlane);
+    const m23 = cam.nearPlane * m22;
+    // Fourth row blends: w' = (1 - orthographic) * (-z) + orthographic * d
+    const perspective = [
+        f / cam.aspect, 0, 0, 0,
+        0, f, 0, 0,
+        0, 0, m22, -(1 - cam.orthographic),
+        0, 0, m23, cam.orthographic * d,
+    ];
+    return Mat4x4.multiply(perspective, lookAt);
+};
+//# sourceMappingURL=to-view-projection.js.map

package/dist/graphics/camera/to-view-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-view-projection.js","sourceRoot":"","sources":["../../../src/graphics/camera/to-view-projection.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAGhD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAW,EAAU,EAAE;IACpD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAE/D,MAAM,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;IAC9C,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAElD,gDAAgD;IAChD,8EAA8E;IAC9E,sEAAsE;IACtE,qEAAqE;IACrE,kDAAkD;IAClD,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,YAAY,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC5G,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC;IAEhC,uEAAuE;IACvE,MAAM,WAAW,GAAW;QACxB,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACvB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACV,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC;QAClC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,YAAY,GAAG,CAAC;KAClC,CAAC;IAEF,OAAO,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAChD,CAAC,CAAC"}

package/dist/graphics/graphics-plugin.d.ts

@@ -0,0 +1,121 @@
+import { Vec4 } from "@adobe/data/math";
+/**
+ * Graphics presentation — extends the `core` GPU runtime with everything
+ * about drawing to a canvas: the swap-chain context, color/depth formats,
+ * the depth texture, and the per-frame render pass.
+ *
+ * Render-pass lifecycle, sandwiched between core's phase anchors with hard
+ * ordering edges (`during` is only a soft hint, so we use after/before):
+ * `beginRenderPass` runs after `preRender` and before `render` (pass open
+ * before draws); draw systems run `during: ["render"]`; `endRenderPass` runs
+ * after `render` and before `postRender` (pass closed after draws, before
+ * core submits the encoder). Compute-only consumers (e.g. `physics`) depend
+ * on `core` directly and never touch any of this.
+ */
+export declare const graphics: {
+    readonly components: {};
+    readonly resources: {
+        readonly frameTime: {
+            readonly default: import("../core/frame-time/public.js");
+            readonly transient: true;
+        };
+    } & {
+        readonly schedulerState: {
+            readonly default: import("@adobe/data/ecs").SchedulerState;
+        };
+    } & {
+        readonly device: {
+            readonly default: GPUDevice | null;
+            readonly transient: true;
+        };
+        readonly commandEncoder: {
+            readonly default: GPUCommandEncoder | null;
+            readonly transient: true;
+        };
+    } & {
+        readonly renderPassEncoder: {
+            readonly default: GPURenderPassEncoder | null;
+            readonly transient: true;
+        };
+        readonly depthTexture: {
+            readonly default: GPUTexture | null;
+            readonly transient: true;
+        };
+        readonly clearColor: {
+            readonly default: Vec4;
+            readonly transient: true;
+        };
+        readonly canvas: {
+            readonly default: HTMLCanvasElement | null;
+            readonly transient: true;
+        };
+        readonly canvasContext: {
+            readonly default: GPUCanvasContext | null;
+            readonly transient: true;
+        };
+        readonly canvasFormat: {
+            readonly default: GPUTextureFormat;
+            readonly transient: true;
+        };
+        readonly depthFormat: {
+            readonly default: GPUTextureFormat;
+            readonly transient: true;
+        };
+    };
+    readonly archetypes: {};
+    readonly transactions: {} & {} & {
+        readonly setCanvas: (t: import("@adobe/data/ecs").TransactionContext<import("@adobe/data/schema").FromSchemas<{}>, import("@adobe/data/schema").FromSchemas<{
+            readonly renderPassEncoder: {
+                readonly default: GPURenderPassEncoder | null;
+                readonly transient: true;
+            };
+            readonly depthTexture: {
+                readonly default: GPUTexture | null;
+                readonly transient: true;
+            };
+            readonly clearColor: {
+                readonly default: Vec4;
+                readonly transient: true;
+            };
+            readonly canvas: {
+                readonly default: HTMLCanvasElement | null;
+                readonly transient: true;
+            };
+            readonly canvasContext: {
+                readonly default: GPUCanvasContext | null;
+                readonly transient: true;
+            };
+            readonly canvasFormat: {
+                readonly default: GPUTextureFormat;
+                readonly transient: true;
+            };
+            readonly depthFormat: {
+                readonly default: GPUTextureFormat;
+                readonly transient: true;
+            };
+        } & {
+            readonly frameTime: {
+                readonly default: import("../core/frame-time/public.js");
+                readonly transient: true;
+            };
+        } & {
+            readonly schedulerState: {
+                readonly default: import("@adobe/data/ecs").SchedulerState;
+            };
+        } & {
+            readonly device: {
+                readonly default: GPUDevice | null;
+                readonly transient: true;
+            };
+            readonly commandEncoder: {
+                readonly default: GPUCommandEncoder | null;
+                readonly transient: true;
+            };
+        }>, {}, {}>, canvas: HTMLCanvasElement | null) => void;
+    };
+    readonly systems: import("@adobe/data/ecs").SystemDeclarations<"update" | "_frameTime" | "schedulerSystem" | "input" | "preUpdate" | "postUpdate" | "physics" | "preRender" | "render" | "postRender" | "configureCanvas" | "beginRenderPass" | "endRenderPass">;
+    readonly actions: {};
+    readonly services: {};
+    readonly computed: {};
+    readonly indexes: {};
+};

package/dist/graphics/graphics-plugin.js

@@ -0,0 +1,106 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Database } from "@adobe/data/ecs";
+import { core } from "../core/core-plugin.js";
+/**
+ * Graphics presentation — extends the `core` GPU runtime with everything
+ * about drawing to a canvas: the swap-chain context, color/depth formats,
+ * the depth texture, and the per-frame render pass.
+ *
+ * Render-pass lifecycle, sandwiched between core's phase anchors with hard
+ * ordering edges (`during` is only a soft hint, so we use after/before):
+ * `beginRenderPass` runs after `preRender` and before `render` (pass open
+ * before draws); draw systems run `during: ["render"]`; `endRenderPass` runs
+ * after `render` and before `postRender` (pass closed after draws, before
+ * core submits the encoder). Compute-only consumers (e.g. `physics`) depend
+ * on `core` directly and never touch any of this.
+ */
+export const graphics = Database.Plugin.create({
+    extends: core,
+    resources: {
+        renderPassEncoder: { default: null, transient: true },
+        depthTexture: { default: null, transient: true },
+        clearColor: { default: [0, 0, 0, 1], transient: true },
+        canvas: { default: null, transient: true },
+        canvasContext: { default: null, transient: true },
+        // Guarded for headless hosts (Node): this default is evaluated at module
+        // load, and `navigator` is browser-only. Rendering re-derives the real
+        // preferred format when a canvas is configured; the placeholder is unused.
+        canvasFormat: {
+            default: (typeof navigator !== "undefined" && navigator.gpu
+                ? navigator.gpu.getPreferredCanvasFormat()
+                : "bgra8unorm"),
+            transient: true,
+        },
+        depthFormat: { default: "depth24plus", transient: true },
+    },
+    transactions: {
+        setCanvas(t, canvas) {
+            t.resources.canvas = canvas;
+        },
+    },
+    systems: {
+        configureCanvas: {
+            create: db => () => {
+                const { device } = db.store.resources;
+                if (!device)
+                    return;
+                let { canvasContext } = db.store.resources;
+                const { canvas, canvasFormat } = db.store.resources;
+                if (canvas && !canvasContext) {
+                    canvasContext = db.store.resources.canvasContext = canvas.getContext("webgpu");
+                    if (!canvasContext) {
+                        throw new Error("No WebGPU context");
+                    }
+                    canvasContext.configure({
+                        device,
+                        format: canvasFormat,
+                        alphaMode: "premultiplied",
+                    });
+                }
+            },
+            schedule: { after: ["preUpdate"], before: ["update"] },
+        },
+        beginRenderPass: {
+            create: db => () => {
+                const { canvas, commandEncoder, clearColor, canvasContext, device, depthFormat } = db.store.resources;
+                let { depthTexture } = db.store.resources;
+                if (!commandEncoder || !canvasContext || !device || !canvas)
+                    return;
+                const canvasSize = [canvas.width, canvas.height];
+                if (!depthTexture || depthTexture.width !== canvasSize[0] || depthTexture.height !== canvasSize[1]) {
+                    depthTexture = db.store.resources.depthTexture = device.createTexture({
+                        size: canvasSize,
+                        format: depthFormat,
+                        usage: GPUTextureUsage.RENDER_ATTACHMENT,
+                    });
+                }
+                db.store.resources.renderPassEncoder = commandEncoder.beginRenderPass({
+                    colorAttachments: [{
+                            clearValue: clearColor,
+                            loadOp: "clear",
+                            storeOp: "store",
+                            view: canvasContext.getCurrentTexture().createView(),
+                        }],
+                    depthStencilAttachment: {
+                        view: depthTexture.createView(),
+                        depthClearValue: 1.0,
+                        depthLoadOp: "clear",
+                        depthStoreOp: "store",
+                    },
+                });
+            },
+            schedule: { after: ["preRender"], before: ["render"] },
+        },
+        endRenderPass: {
+            create: db => () => {
+                const { renderPassEncoder } = db.store.resources;
+                if (renderPassEncoder) {
+                    renderPassEncoder.end();
+                    db.store.resources.renderPassEncoder = null;
+                }
+            },
+            schedule: { after: ["render"], before: ["postRender"] },
+        },
+    },
+});
+//# sourceMappingURL=graphics-plugin.js.map

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

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

package/dist/graphics/picking/pick-hit.d.ts

@@ -0,0 +1,10 @@
+import type { Entity } from "@adobe/data/ecs";
+/**
+ * One ray-pick result — the Model the ray hit and the parametric distance
+ * along the ray segment (`alpha ∈ [0,1]` where 0 is the ray's near point
+ * `a` and 1 is the far point `b` from `screenToWorldRay`).
+ */
+export interface PickHit {
+    readonly entity: Entity;
+    readonly distance: number;
+}

package/dist/graphics/picking/pick-hit.js

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

package/dist/graphics/picking/pick-hit.js.map

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