@adobe/data-gpu 0.9.69

package/dist/graphics/scene/model/shape/shape-geometry-plugin.d.ts

@@ -0,0 +1,631 @@
+import { type Entity } from "@adobe/data/ecs";
+/**
+ * shapeGeometry — registers procedural unit-sphere and unit-cube geometries as
+ * `Geometry` + `_PbrPrimitive` entities (StandardVertex layout), exactly like
+ * the model loader does for glTF, so primitives and loaded models share one
+ * render path. The two geometry entity ids are published in `_shapeGeometry`
+ * for the physics render bridge to reference (sphere / cuboid bodies). Built
+ * once when the device is ready.
+ */
+export declare const shapeGeometry: {
+    readonly components: {} & {
+        readonly visible: {
+            readonly type: "boolean";
+            readonly const: true;
+            readonly default: true;
+        };
+        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 rotation: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly minItems: 4;
+            readonly maxItems: 4;
+            readonly default: readonly [0, 0, 0, 1];
+            readonly interpolators: {
+                readonly linear: (q1: any, q2: any, t: number) => any;
+            };
+        };
+        readonly scale: {
+            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 parent: {
+            readonly type: "integer";
+            readonly minimum: -2147483648;
+            readonly maximum: 2147483647;
+            readonly default: number;
+        };
+        readonly _worldMatrix: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly minItems: 16;
+            readonly maxItems: 16;
+            readonly default: readonly [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];
+        };
+        readonly _worldBounds: {
+            readonly type: "object";
+            readonly properties: {
+                readonly min: {
+                    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 max: {
+                    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 required: readonly ["min", "max"];
+            readonly additionalProperties: false;
+            readonly default: {
+                readonly min: readonly [0, 0, 0];
+                readonly max: readonly [0, 0, 0];
+            };
+        };
+    } & {
+        readonly modelUrl: {
+            readonly type: "string";
+        };
+        readonly geometry: {
+            readonly type: "integer";
+            readonly minimum: -2147483648;
+            readonly maximum: 2147483647;
+            readonly default: number;
+        };
+    } & {
+        readonly _vertexBuffer: {
+            readonly default: GPUBuffer | null;
+        };
+        readonly _skinVertexBuffer: {
+            readonly default: GPUBuffer | null;
+        };
+        readonly _indexBuffer: {
+            readonly default: GPUBuffer | null;
+        };
+        readonly _indexCount: {
+            readonly type: "integer";
+            readonly minimum: 0;
+            readonly maximum: 4294967295;
+            readonly default: number;
+        };
+        readonly _indexFormat: {
+            readonly default: GPUIndexFormat;
+        };
+        readonly _materialBindGroup: {
+            readonly default: GPUBindGroup | null;
+        };
+        readonly _geometry: {
+            readonly type: "integer";
+            readonly minimum: -2147483648;
+            readonly maximum: 2147483647;
+            readonly default: number;
+        };
+        readonly _material: {
+            readonly type: "integer";
+            readonly minimum: -2147483648;
+            readonly maximum: 2147483647;
+            readonly default: number;
+        };
+        readonly _nodeLocalMatrix: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly minItems: 16;
+            readonly maxItems: 16;
+            readonly default: readonly [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];
+        };
+        readonly _skeletonModelRef: {
+            readonly type: "integer";
+            readonly minimum: -2147483648;
+            readonly maximum: 2147483647;
+            readonly default: number;
+        };
+        readonly _skeletonJointMatrixBindGroup: {
+            readonly default: GPUBindGroup | null;
+        };
+    };
+    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 _shapeGeometry: {
+            readonly default: {
+                sphere: Entity;
+                cube: Entity;
+            } | null;
+            readonly transient: true;
+        };
+    };
+    readonly archetypes: {} & {
+        readonly Node: readonly ["position", "rotation", "scale", "parent", "visible"];
+    } & {} & {
+        readonly Geometry: readonly ["modelUrl"];
+        readonly Model: readonly ["geometry", "position", "rotation", "scale", "visible", "parent"];
+    } & {
+        readonly _VisibleMaterial: readonly ["ephemeral", "_materialBindGroup", "_geometry"];
+        readonly _PbrPrimitive: readonly ["ephemeral", "_vertexBuffer", "_skinVertexBuffer", "_indexBuffer", "_indexCount", "_indexFormat", "_material", "_geometry", "_nodeLocalMatrix"];
+    } & {};
+    readonly transactions: {} & {} & {
+        readonly insertGeometry: (t: import("@adobe/data/ecs").TransactionContext<import("@adobe/data/schema").FromSchemas<{
+            readonly modelUrl: {
+                readonly type: "string";
+            };
+            readonly geometry: {
+                readonly type: "integer";
+                readonly minimum: -2147483648;
+                readonly maximum: 2147483647;
+                readonly default: number;
+            };
+        } & {
+            readonly visible: {
+                readonly type: "boolean";
+                readonly const: true;
+                readonly default: true;
+            };
+            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 rotation: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                    readonly precision: 1;
+                    readonly default: number;
+                };
+                readonly minItems: 4;
+                readonly maxItems: 4;
+                readonly default: readonly [0, 0, 0, 1];
+                readonly interpolators: {
+                    readonly linear: (q1: any, q2: any, t: number) => any;
+                };
+            };
+            readonly scale: {
+                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 parent: {
+                readonly type: "integer";
+                readonly minimum: -2147483648;
+                readonly maximum: 2147483647;
+                readonly default: number;
+            };
+            readonly _worldMatrix: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                    readonly precision: 1;
+                    readonly default: number;
+                };
+                readonly minItems: 16;
+                readonly maxItems: 16;
+                readonly default: readonly [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];
+            };
+            readonly _worldBounds: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly min: {
+                        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 max: {
+                        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 required: readonly ["min", "max"];
+                readonly additionalProperties: false;
+                readonly default: {
+                    readonly min: readonly [0, 0, 0];
+                    readonly max: readonly [0, 0, 0];
+                };
+            };
+        } & {}>, import("@adobe/data/schema").FromSchemas<{}>, {
+            readonly Geometry: readonly ["modelUrl"];
+            readonly Model: readonly ["geometry", "position", "rotation", "scale", "visible", "parent"];
+        } & {
+            readonly Node: readonly ["position", "rotation", "scale", "parent", "visible"];
+        } & {}, {} & {} & {}>, args: {
+            modelUrl: string;
+        }) => number;
+        readonly insertModel: (t: import("@adobe/data/ecs").TransactionContext<import("@adobe/data/schema").FromSchemas<{
+            readonly modelUrl: {
+                readonly type: "string";
+            };
+            readonly geometry: {
+                readonly type: "integer";
+                readonly minimum: -2147483648;
+                readonly maximum: 2147483647;
+                readonly default: number;
+            };
+        } & {
+            readonly visible: {
+                readonly type: "boolean";
+                readonly const: true;
+                readonly default: true;
+            };
+            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 rotation: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                    readonly precision: 1;
+                    readonly default: number;
+                };
+                readonly minItems: 4;
+                readonly maxItems: 4;
+                readonly default: readonly [0, 0, 0, 1];
+                readonly interpolators: {
+                    readonly linear: (q1: any, q2: any, t: number) => any;
+                };
+            };
+            readonly scale: {
+                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 parent: {
+                readonly type: "integer";
+                readonly minimum: -2147483648;
+                readonly maximum: 2147483647;
+                readonly default: number;
+            };
+            readonly _worldMatrix: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                    readonly precision: 1;
+                    readonly default: number;
+                };
+                readonly minItems: 16;
+                readonly maxItems: 16;
+                readonly default: readonly [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];
+            };
+            readonly _worldBounds: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly min: {
+                        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 max: {
+                        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 required: readonly ["min", "max"];
+                readonly additionalProperties: false;
+                readonly default: {
+                    readonly min: readonly [0, 0, 0];
+                    readonly max: readonly [0, 0, 0];
+                };
+            };
+        } & {}>, import("@adobe/data/schema").FromSchemas<{}>, {
+            readonly Geometry: readonly ["modelUrl"];
+            readonly Model: readonly ["geometry", "position", "rotation", "scale", "visible", "parent"];
+        } & {
+            readonly Node: readonly ["position", "rotation", "scale", "parent", "visible"];
+        } & {}, {} & {} & {}>, args: {
+            geometry: number;
+            position?: readonly [number, number, number];
+            rotation?: import("@adobe/data/math").Quat;
+            scale?: readonly [number, number, number];
+            parent?: number;
+        }) => number;
+    } & {} & {} & {} & {
+        readonly insertShapePrimitive: (t: import("@adobe/data/ecs").TransactionContext<import("@adobe/data/schema").FromSchemas<{} & {
+            readonly visible: {
+                readonly type: "boolean";
+                readonly const: true;
+                readonly default: true;
+            };
+            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 rotation: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                    readonly precision: 1;
+                    readonly default: number;
+                };
+                readonly minItems: 4;
+                readonly maxItems: 4;
+                readonly default: readonly [0, 0, 0, 1];
+                readonly interpolators: {
+                    readonly linear: (q1: any, q2: any, t: number) => any;
+                };
+            };
+            readonly scale: {
+                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 parent: {
+                readonly type: "integer";
+                readonly minimum: -2147483648;
+                readonly maximum: 2147483647;
+                readonly default: number;
+            };
+            readonly _worldMatrix: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                    readonly precision: 1;
+                    readonly default: number;
+                };
+                readonly minItems: 16;
+                readonly maxItems: 16;
+                readonly default: readonly [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];
+            };
+            readonly _worldBounds: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly min: {
+                        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 max: {
+                        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 required: readonly ["min", "max"];
+                readonly additionalProperties: false;
+                readonly default: {
+                    readonly min: readonly [0, 0, 0];
+                    readonly max: readonly [0, 0, 0];
+                };
+            };
+        } & {
+            readonly modelUrl: {
+                readonly type: "string";
+            };
+            readonly geometry: {
+                readonly type: "integer";
+                readonly minimum: -2147483648;
+                readonly maximum: 2147483647;
+                readonly default: number;
+            };
+        } & {
+            readonly _vertexBuffer: {
+                readonly default: GPUBuffer | null;
+            };
+            readonly _skinVertexBuffer: {
+                readonly default: GPUBuffer | null;
+            };
+            readonly _indexBuffer: {
+                readonly default: GPUBuffer | null;
+            };
+            readonly _indexCount: {
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly maximum: 4294967295;
+                readonly default: number;
+            };
+            readonly _indexFormat: {
+                readonly default: GPUIndexFormat;
+            };
+            readonly _materialBindGroup: {
+                readonly default: GPUBindGroup | null;
+            };
+            readonly _geometry: {
+                readonly type: "integer";
+                readonly minimum: -2147483648;
+                readonly maximum: 2147483647;
+                readonly default: number;
+            };
+            readonly _material: {
+                readonly type: "integer";
+                readonly minimum: -2147483648;
+                readonly maximum: 2147483647;
+                readonly default: number;
+            };
+            readonly _nodeLocalMatrix: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                    readonly precision: 1;
+                    readonly default: number;
+                };
+                readonly minItems: 16;
+                readonly maxItems: 16;
+                readonly default: readonly [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];
+            };
+            readonly _skeletonModelRef: {
+                readonly type: "integer";
+                readonly minimum: -2147483648;
+                readonly maximum: 2147483647;
+                readonly default: number;
+            };
+            readonly _skeletonJointMatrixBindGroup: {
+                readonly default: GPUBindGroup | null;
+            };
+        }>, import("@adobe/data/schema").FromSchemas<{
+            readonly _shapeGeometry: {
+                readonly default: {
+                    sphere: Entity;
+                    cube: Entity;
+                } | null;
+                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;
+            };
+        }>, {} & {} & {
+            readonly Node: readonly ["position", "rotation", "scale", "parent", "visible"];
+        } & {} & {
+            readonly Geometry: readonly ["modelUrl"];
+            readonly Model: readonly ["geometry", "position", "rotation", "scale", "visible", "parent"];
+        } & {
+            readonly _VisibleMaterial: readonly ["ephemeral", "_materialBindGroup", "_geometry"];
+            readonly _PbrPrimitive: readonly ["ephemeral", "_vertexBuffer", "_skinVertexBuffer", "_indexBuffer", "_indexCount", "_indexFormat", "_material", "_geometry", "_nodeLocalMatrix"];
+        }, {} & {} & {} & {} & {} & {}>, args: {
+            vertexBuffer: GPUBuffer;
+            indexBuffer: GPUBuffer;
+            indexCount: number;
+        }) => Entity;
+    };
+    readonly systems: import("@adobe/data/ecs").SystemDeclarations<"transformCreateWorldMatrix" | "transformSystem" | "update" | "_frameTime" | "schedulerSystem" | "input" | "preUpdate" | "postUpdate" | "physics" | "preRender" | "render" | "postRender" | "shapeGeometryInit">;
+    readonly actions: {};
+    readonly services: {};
+    readonly computed: {};
+    readonly indexes: {} & {} & {} & {} & {} & {};
+};

package/dist/graphics/scene/model/shape/shape-geometry-plugin.js

@@ -0,0 +1,61 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Database } from "@adobe/data/ecs";
+import { Mat4x4 } from "@adobe/data/math";
+import { pbrCore } from "../../../rendering/pbr-core-plugin.js";
+import { core } from "../../../../core/core-plugin.js";
+import { model } from "../model-plugin.js";
+import { unitSphere, unitCube } from "./shape-mesh.js";
+import { uploadShapeMesh } from "./upload-shape-mesh.js";
+/**
+ * shapeGeometry — registers procedural unit-sphere and unit-cube geometries as
+ * `Geometry` + `_PbrPrimitive` entities (StandardVertex layout), exactly like
+ * the model loader does for glTF, so primitives and loaded models share one
+ * render path. The two geometry entity ids are published in `_shapeGeometry`
+ * for the physics render bridge to reference (sphere / cuboid bodies). Built
+ * once when the device is ready.
+ */
+export const shapeGeometry = Database.Plugin.create({
+    extends: Database.Plugin.combine(pbrCore, model, core),
+    resources: {
+        _shapeGeometry: { default: null, transient: true },
+    },
+    transactions: {
+        insertShapePrimitive(t, args) {
+            const geometry = t.archetypes.Geometry.insert({ modelUrl: "" });
+            t.archetypes._PbrPrimitive.insert({
+                ephemeral: true,
+                _geometry: geometry,
+                _material: 0, // primitives carry material per-instance, not here
+                _vertexBuffer: args.vertexBuffer,
+                _skinVertexBuffer: null,
+                _indexBuffer: args.indexBuffer,
+                _indexCount: args.indexCount,
+                _indexFormat: "uint16",
+                _nodeLocalMatrix: Mat4x4.identity,
+            });
+            return geometry;
+        },
+    },
+    systems: {
+        shapeGeometryInit: {
+            schedule: { during: ["preUpdate"] },
+            create: db => {
+                let done = false;
+                return () => {
+                    if (done)
+                        return;
+                    const { device } = db.store.resources;
+                    if (!device)
+                        return;
+                    const s = uploadShapeMesh(device, unitSphere());
+                    const c = uploadShapeMesh(device, unitCube());
+                    const sphere = db.transactions.insertShapePrimitive({ vertexBuffer: s.vb, indexBuffer: s.ib, indexCount: s.count });
+                    const cube = db.transactions.insertShapePrimitive({ vertexBuffer: c.vb, indexBuffer: c.ib, indexCount: c.count });
+                    db.store.resources._shapeGeometry = { sphere, cube };
+                    done = true;
+                };
+            },
+        },
+    },
+});
+//# sourceMappingURL=shape-geometry-plugin.js.map